diff --git a/providers/cerebras/cerebras.go b/providers/cerebras/cerebras.go
index aacb012090d7eeb4f3a4781449ac3f6cd3653d75..52cf7e64a454aedac1cdd838fbb0bced70fdadb5 100644
--- a/providers/cerebras/cerebras.go
+++ b/providers/cerebras/cerebras.go
@@ -1,3 +1,4 @@
+// Package cerebras provides a Fantasy provider for the Cerebras Inference API.
 package cerebras
 
 import (
@@ -6,12 +7,16 @@ import (
 )
 
 const (
+	// Name is the provider identifier for Cerebras.
 	Name = "cerebras"
+	// BaseURL is the default Cerebras API base URL.
 	BaseURL = "https://api.cerebras.ai/v1"
 )
 
+// Option configures the Cerebras provider via OpenAI-compatible options.
 type Option = openaicompat.Option
 
+// New creates a new Cerebras provider using OpenAI-compatible transport/options.
 func New(opts ...Option) (fantasy.Provider, error) {
 	options := []Option{
 		openaicompat.WithName(Name),
diff --git a/providers/groq/groq.go b/providers/groq/groq.go
index a2c0bd4b8f5d088ce9efbfb74d37cfe1ba670161..883c1f9341c0c7e05cf5bdd6edab82ae69c998c5 100644
--- a/providers/groq/groq.go
+++ b/providers/groq/groq.go
@@ -1,3 +1,4 @@
+// Package groq provides a Fantasy provider for the Groq API.
 package groq
 
 import (
@@ -6,12 +7,16 @@ import (
 )
 
 const (
+	// Name is the provider identifier for Groq.
 	Name = "groq"
+	// BaseURL is the default Groq API base URL.
 	BaseURL = "https://api.groq.com/openai/v1"
 )
 
+// Option configures the Groq provider via OpenAI-compatible options.
 type Option = openaicompat.Option
 
+// New creates a new Groq provider using OpenAI-compatible transport/options.
 func New(opts ...Option) (fantasy.Provider, error) {
 	options := []Option{
 		openaicompat.WithName(Name),
diff --git a/providers/huggingface/huggingface.go b/providers/huggingface/huggingface.go
index 61c968f009f85782fc663d40893f5bdc7a40b78e..4a3e399ac7f3a5f58ece85208c70d3568349999b 100644
--- a/providers/huggingface/huggingface.go
+++ b/providers/huggingface/huggingface.go
@@ -1,3 +1,4 @@
+// Package huggingface provides a Fantasy provider for the Hugging Face Inference API.
 package huggingface
 
 import (
@@ -6,12 +7,16 @@ import (
 )
 
 const (
+	// Name is the provider identifier for Hugging Face.
 	Name = "huggingface"
+	// BaseURL is the default Hugging Face Inference API base URL.
 	BaseURL = "https://router.huggingface.co/v1"
 )
 
+// Option configures the Hugging Face provider via OpenAI-compatible options.
 type Option = openaicompat.Option
 
+// New creates a new Hugging Face provider using OpenAI-compatible transport/options.
 func New(opts ...Option) (fantasy.Provider, error) {
 	options := []Option{
 		openaicompat.WithName(Name),
diff --git a/providers/xai/xai.go b/providers/xai/xai.go
index 9e62ea9ded64dba4a036b066c9171cfc317bbfda..07a04246cf7650c116cca38cf012bd755a8e24b5 100644
--- a/providers/xai/xai.go
+++ b/providers/xai/xai.go
@@ -1,3 +1,4 @@
+// Package xai provides a Fantasy provider for the xAI API.
 package xai
 
 import (
@@ -6,12 +7,16 @@ import (
 )
 
 const (
+	// Name is the provider identifier for xAI.
 	Name = "xai"
+	// BaseURL is the default xAI API base URL.
 	BaseURL = "https://api.x.ai/v1"
 )
 
+// Option configures the xAI provider via OpenAI-compatible options.
 type Option = openaicompat.Option
 
+// New creates a new xAI provider using OpenAI-compatible transport/options.
 func New(opts ...Option) (fantasy.Provider, error) {
 	options := []Option{
 		openaicompat.WithName(Name),
diff --git a/providers/zai/zai.go b/providers/zai/zai.go
index 490340fdbb6ad661799f35b3f105b004f4069e57..70c21d3f05cd80be53a36019e8f50cc9f58a2b22 100644
--- a/providers/zai/zai.go
+++ b/providers/zai/zai.go
@@ -1,3 +1,4 @@
+// Package zai provides a Fantasy provider for the Z.ai Coding PaaS API.
 package zai
 
 import (
@@ -6,12 +7,16 @@ import (
 )
 
 const (
+	// Name is the provider identifier for Z.ai.
 	Name = "zai"
+	// BaseURL is the default Z.ai Coding PaaS API base URL.
 	BaseURL = "https://api.z.ai/api/coding/paas/v4"
 )
 
+// Option configures the Z.ai provider via OpenAI-compatible options.
 type Option = openaicompat.Option
 
+// New creates a new Z.ai provider using OpenAI-compatible transport/options.
 func New(opts ...Option) (fantasy.Provider, error) {
 	options := []Option{
 		openaicompat.WithName(Name),