@tanstack/ai-grok 0.12.4 → 0.14.0

package/dist/esm/model-meta.d.ts

@@ -1,215 +1,5 @@
-declare const GROK_4_1_FAST_REASONING: {
-    readonly name: "grok-4-1-fast-reasoning";
-    readonly context_window: 2000000;
-    readonly supports: {
-        readonly input: ["text", "image"];
-        readonly output: ["text"];
-        readonly capabilities: ["reasoning", "structured_outputs", "tool_calling"];
-        readonly tools: readonly [];
-    };
-    readonly pricing: {
-        readonly input: {
-            readonly normal: 0.2;
-            readonly cached: 0.05;
-        };
-        readonly output: {
-            readonly normal: 0.5;
-        };
-    };
-};
-declare const GROK_4_1_FAST_NON_REASONING: {
-    readonly name: "grok-4-1-fast-non-reasoning";
-    readonly context_window: 2000000;
-    readonly supports: {
-        readonly input: ["text", "image"];
-        readonly output: ["text"];
-        readonly capabilities: ["structured_outputs", "tool_calling"];
-        readonly tools: readonly [];
-    };
-    readonly pricing: {
-        readonly input: {
-            readonly normal: 0.2;
-            readonly cached: 0.05;
-        };
-        readonly output: {
-            readonly normal: 0.5;
-        };
-    };
-};
-declare const GROK_CODE_FAST_1: {
-    readonly name: "grok-code-fast-1";
-    readonly context_window: 256000;
-    readonly supports: {
-        readonly input: ["text"];
-        readonly output: ["text"];
-        readonly capabilities: ["reasoning", "structured_outputs", "tool_calling"];
-        readonly tools: readonly [];
-    };
-    readonly pricing: {
-        readonly input: {
-            readonly normal: 0.2;
-            readonly cached: 0.02;
-        };
-        readonly output: {
-            readonly normal: 1.5;
-        };
-    };
-};
-declare const GROK_4_FAST_REASONING: {
-    readonly name: "grok-4-fast-reasoning";
-    readonly context_window: 2000000;
-    readonly supports: {
-        readonly input: ["text", "image"];
-        readonly output: ["text"];
-        readonly capabilities: ["reasoning", "structured_outputs", "tool_calling"];
-        readonly tools: readonly [];
-    };
-    readonly pricing: {
-        readonly input: {
-            readonly normal: 0.2;
-            readonly cached: 0.05;
-        };
-        readonly output: {
-            readonly normal: 0.5;
-        };
-    };
-};
-declare const GROK_4_FAST_NON_REASONING: {
-    readonly name: "grok-4-fast-non-reasoning";
-    readonly context_window: 2000000;
-    readonly supports: {
-        readonly input: ["text", "image"];
-        readonly output: ["text"];
-        readonly capabilities: ["structured_outputs", "tool_calling"];
-        readonly tools: readonly [];
-    };
-    readonly pricing: {
-        readonly input: {
-            readonly normal: 0.2;
-            readonly cached: 0.05;
-        };
-        readonly output: {
-            readonly normal: 0.5;
-        };
-    };
-};
-declare const GROK_4: {
-    readonly name: "grok-4";
-    readonly context_window: 256000;
-    readonly supports: {
-        readonly input: ["text", "image"];
-        readonly output: ["text"];
-        readonly capabilities: ["reasoning", "structured_outputs", "tool_calling"];
-        readonly tools: readonly [];
-    };
-    readonly pricing: {
-        readonly input: {
-            readonly normal: 3;
-            readonly cached: 0.75;
-        };
-        readonly output: {
-            readonly normal: 15;
-        };
-    };
-};
-declare const GROK_3_MINI: {
-    readonly name: "grok-3-mini";
-    readonly context_window: 131072;
-    readonly supports: {
-        readonly input: ["text"];
-        readonly output: ["text"];
-        readonly capabilities: ["reasoning", "structured_outputs", "tool_calling"];
-        readonly tools: readonly [];
-    };
-    readonly pricing: {
-        readonly input: {
-            readonly normal: 0.3;
-            readonly cached: 0.075;
-        };
-        readonly output: {
-            readonly normal: 0.5;
-        };
-    };
-};
-declare const GROK_3: {
-    readonly name: "grok-3";
-    readonly context_window: 131072;
-    readonly supports: {
-        readonly input: ["text"];
-        readonly output: ["text"];
-        readonly capabilities: ["structured_outputs", "tool_calling"];
-        readonly tools: readonly [];
-    };
-    readonly pricing: {
-        readonly input: {
-            readonly normal: 3;
-            readonly cached: 0.75;
-        };
-        readonly output: {
-            readonly normal: 15;
-        };
-    };
-};
-declare const GROK_2_VISION: {
-    readonly name: "grok-2-vision-1212";
-    readonly context_window: 32768;
-    readonly supports: {
-        readonly input: ["text", "image"];
-        readonly output: ["text"];
-        readonly capabilities: ["structured_outputs", "tool_calling"];
-        readonly tools: readonly [];
-    };
-    readonly pricing: {
-        readonly input: {
-            readonly normal: 2;
-        };
-        readonly output: {
-            readonly normal: 10;
-        };
-    };
-};
-/**
- * Grok Chat Models
- * Based on xAI's available models as of 2025
- */
-declare const GROK_4_20: {
-    readonly name: "grok-4.20";
-    readonly context_window: 2000000;
-    readonly supports: {
-        readonly input: ["text", "image", "document"];
-        readonly output: ["text"];
-        readonly capabilities: ["reasoning", "structured_outputs", "tool_calling"];
-        readonly tools: readonly [];
-    };
-    readonly pricing: {
-        readonly input: {
-            readonly normal: 2;
-            readonly cached: 0.2;
-        };
-        readonly output: {
-            readonly normal: 6;
-        };
-    };
-};
-declare const GROK_4_20_MULTI_AGENT: {
-    readonly name: "grok-4.20-multi-agent";
-    readonly context_window: 2000000;
-    readonly supports: {
-        readonly input: ["text", "image", "document"];
-        readonly output: ["text"];
-        readonly capabilities: ["reasoning", "structured_outputs", "tool_calling"];
-        readonly tools: readonly [];
-    };
-    readonly pricing: {
-        readonly input: {
-            readonly normal: 2;
-            readonly cached: 0.2;
-        };
-        readonly output: {
-            readonly normal: 6;
-        };
-    };
-};
+import { GrokBuildProviderOptions, GrokTextProviderOptions } from './text/text-provider-options.js';
+export type GrokProviderToolKind = 'web_search' | 'x_search' | 'file_search' | 'mcp';
 declare const GROK_4_3: {
     readonly name: "grok-4.3";
     readonly context_window: 1000000;
@@ -217,7 +7,7 @@ declare const GROK_4_3: {
         readonly input: ["text", "image"];
         readonly output: ["text"];
         readonly capabilities: ["reasoning", "structured_outputs", "tool_calling"];
-        readonly tools: readonly [];
+        readonly tools: readonly ["web_search", "x_search", "file_search", "mcp"];
     };
     readonly pricing: {
         readonly input: {
@@ -236,7 +26,7 @@ declare const GROK_BUILD_0_1: {
         readonly input: ["text", "image"];
         readonly output: ["text"];
         readonly capabilities: ["reasoning", "structured_outputs", "tool_calling"];
-        readonly tools: readonly [];
+        readonly tools: readonly ["web_search", "x_search", "file_search", "mcp"];
     };
     readonly pricing: {
         readonly input: {
@@ -248,29 +38,26 @@ declare const GROK_BUILD_0_1: {
         };
     };
 };
-export declare const GROK_CHAT_MODELS: readonly ["grok-4-1-fast-reasoning", "grok-4-1-fast-non-reasoning", "grok-code-fast-1", "grok-4-fast-reasoning", "grok-4-fast-non-reasoning", "grok-4", "grok-3", "grok-3-mini", "grok-2-vision-1212", "grok-4.20", "grok-4.20-multi-agent", "grok-4.3", "grok-build-0.1"];
 /**
- * Grok models that support combining `tools` + `response_format: json_schema`
- * in a single streaming Chat Completions request (per issue #605). xAI
- * docs gate this to the Grok 4 family — Grok 2 / 3 reject the
- * combination. Grok 2 image generation is not a chat model, omitted.
- *
- * Note: Grok streams tool-call arguments atomically (not token-streamed)
- * per the issue's source matrix; partial-JSON tool-arg parsing should be
- * skipped for Grok specifically. That's a separate adapter concern from
- * this set — the set only gates whether the engine takes the native
- * combined path vs the legacy finalization path.
+ * Grok chat models supported by the Responses adapter.
  */
-export declare const GROK_COMBINED_TOOLS_AND_SCHEMA_MODELS: Set<string>;
+export declare const GROK_CHAT_MODELS: readonly ["grok-build-0.1", "grok-4.3"];
 /**
  * Grok Image Generation Models
  */
 export declare const GROK_IMAGE_MODELS: readonly ["grok-2-image-1212", "grok-imagine-image", "grok-imagine-image-quality"];
+/**
+ * Grok Video Generation Models (xAI Imagine API)
+ *
+ * @experimental Video generation is an experimental feature and may change.
+ */
+export declare const GROK_VIDEO_MODELS: readonly ["grok-imagine-video", "grok-imagine-video-1.5"];
 export declare const GROK_TTS_MODELS: readonly ["grok-tts"];
 export declare const GROK_TRANSCRIPTION_MODELS: readonly ["grok-stt"];
 export declare const GROK_REALTIME_MODELS: readonly ["grok-voice-fast-1.0", "grok-voice-think-fast-1.0"];
 export type GrokChatModel = (typeof GROK_CHAT_MODELS)[number];
 export type GrokImageModel = (typeof GROK_IMAGE_MODELS)[number];
+export type GrokVideoModel = (typeof GROK_VIDEO_MODELS)[number];
 export type GrokTTSModel = (typeof GROK_TTS_MODELS)[number];
 export type GrokTranscriptionModel = (typeof GROK_TRANSCRIPTION_MODELS)[number];
 export type GrokRealtimeModel = (typeof GROK_REALTIME_MODELS)[number];
@@ -279,66 +66,26 @@ export type GrokRealtimeModel = (typeof GROK_REALTIME_MODELS)[number];
  * Used for type inference when constructing multimodal messages.
  */
 export type GrokModelInputModalitiesByName = {
-    [GROK_4_1_FAST_REASONING.name]: typeof GROK_4_1_FAST_REASONING.supports.input;
-    [GROK_4_1_FAST_NON_REASONING.name]: typeof GROK_4_1_FAST_NON_REASONING.supports.input;
-    [GROK_CODE_FAST_1.name]: typeof GROK_CODE_FAST_1.supports.input;
-    [GROK_4_FAST_REASONING.name]: typeof GROK_4_FAST_REASONING.supports.input;
-    [GROK_4_FAST_NON_REASONING.name]: typeof GROK_4_FAST_NON_REASONING.supports.input;
-    [GROK_4.name]: typeof GROK_4.supports.input;
-    [GROK_3.name]: typeof GROK_3.supports.input;
-    [GROK_3_MINI.name]: typeof GROK_3_MINI.supports.input;
-    [GROK_2_VISION.name]: typeof GROK_2_VISION.supports.input;
-    [GROK_4_20.name]: typeof GROK_4_20.supports.input;
-    [GROK_4_20_MULTI_AGENT.name]: typeof GROK_4_20_MULTI_AGENT.supports.input;
     [GROK_4_3.name]: typeof GROK_4_3.supports.input;
     [GROK_BUILD_0_1.name]: typeof GROK_BUILD_0_1.supports.input;
 };
-/**
- * Type-only map from Grok chat model name to its provider options type.
- * Since Grok uses OpenAI-compatible API, we reuse OpenAI provider options.
- */
-export type GrokChatModelProviderOptionsByName = {
-    [K in (typeof GROK_CHAT_MODELS)[number]]: GrokProviderOptions;
-};
 /**
  * Type-only map from Grok chat model name to its supported provider tools.
- * Grok exposes no provider-specific tool factories, so every model gets an
- * empty tuple. This ensures that passing an Anthropic/OpenAI ProviderTool to
- * a Grok adapter produces a compile-time type error.
+ * Keeps Grok provider-tool factories type-checked against the models that
+ * advertise xAI Responses server-side tools.
  */
 export type GrokChatModelToolCapabilitiesByName = {
-    [GROK_4_1_FAST_REASONING.name]: typeof GROK_4_1_FAST_REASONING.supports.tools;
-    [GROK_4_1_FAST_NON_REASONING.name]: typeof GROK_4_1_FAST_NON_REASONING.supports.tools;
-    [GROK_CODE_FAST_1.name]: typeof GROK_CODE_FAST_1.supports.tools;
-    [GROK_4_FAST_REASONING.name]: typeof GROK_4_FAST_REASONING.supports.tools;
-    [GROK_4_FAST_NON_REASONING.name]: typeof GROK_4_FAST_NON_REASONING.supports.tools;
-    [GROK_4.name]: typeof GROK_4.supports.tools;
-    [GROK_3.name]: typeof GROK_3.supports.tools;
-    [GROK_3_MINI.name]: typeof GROK_3_MINI.supports.tools;
-    [GROK_2_VISION.name]: typeof GROK_2_VISION.supports.tools;
-    [GROK_4_20.name]: typeof GROK_4_20.supports.tools;
-    [GROK_4_20_MULTI_AGENT.name]: typeof GROK_4_20_MULTI_AGENT.supports.tools;
+    [GROK_4_3.name]: typeof GROK_4_3.supports.tools;
+    [GROK_BUILD_0_1.name]: typeof GROK_BUILD_0_1.supports.tools;
 };
+export type GrokProviderOptions = GrokTextProviderOptions;
 /**
- * Grok-specific provider options
- * Based on OpenAI-compatible API options
+ * Type-only map from Grok chat model name to its provider options type.
  */
-export interface GrokProviderOptions {
-    /** Temperature for response generation (0-2) */
-    temperature?: number;
-    /** Maximum tokens in the response */
-    max_tokens?: number;
-    /** Top-p sampling parameter */
-    top_p?: number;
-    /** Frequency penalty (-2.0 to 2.0) */
-    frequency_penalty?: number;
-    /** Presence penalty (-2.0 to 2.0) */
-    presence_penalty?: number;
-    /** Stop sequences */
-    stop?: string | Array<string>;
-    /** A unique identifier representing your end-user */
-    user?: string;
-}
+export type GrokChatModelProviderOptionsByName = {
+    [GROK_4_3.name]: GrokProviderOptions;
+    [GROK_BUILD_0_1.name]: GrokBuildProviderOptions;
+};
 /**
  * Resolve provider options for a specific model.
  * If the model has explicit options in the map, use those; otherwise use base options.

package/dist/esm/model-meta.js

@@ -1,30 +1,3 @@
-const GROK_4_1_FAST_REASONING = {
-  name: "grok-4-1-fast-reasoning"
-};
-const GROK_4_1_FAST_NON_REASONING = {
-  name: "grok-4-1-fast-non-reasoning"
-};
-const GROK_CODE_FAST_1 = {
-  name: "grok-code-fast-1"
-};
-const GROK_4_FAST_REASONING = {
-  name: "grok-4-fast-reasoning"
-};
-const GROK_4_FAST_NON_REASONING = {
-  name: "grok-4-fast-non-reasoning"
-};
-const GROK_4 = {
-  name: "grok-4"
-};
-const GROK_3_MINI = {
-  name: "grok-3-mini"
-};
-const GROK_3 = {
-  name: "grok-3"
-};
-const GROK_2_VISION = {
-  name: "grok-2-vision-1212"
-};
 const GROK_2_IMAGE = {
   name: "grok-2-image-1212"
 };
@@ -34,11 +7,11 @@ const GROK_IMAGINE_IMAGE = {
 const GROK_IMAGINE_IMAGE_QUALITY = {
   name: "grok-imagine-image-quality"
 };
-const GROK_4_20 = {
-  name: "grok-4.20"
+const GROK_IMAGINE_VIDEO = {
+  name: "grok-imagine-video"
 };
-const GROK_4_20_MULTI_AGENT = {
-  name: "grok-4.20-multi-agent"
+const GROK_IMAGINE_VIDEO_1_5 = {
+  name: "grok-imagine-video-1.5"
 };
 const GROK_4_3 = {
   name: "grok-4.3"
@@ -46,37 +19,16 @@ const GROK_4_3 = {
 const GROK_BUILD_0_1 = {
   name: "grok-build-0.1"
 };
-const GROK_CHAT_MODELS = [
-  GROK_4_1_FAST_REASONING.name,
-  GROK_4_1_FAST_NON_REASONING.name,
-  GROK_CODE_FAST_1.name,
-  GROK_4_FAST_REASONING.name,
-  GROK_4_FAST_NON_REASONING.name,
-  GROK_4.name,
-  GROK_3.name,
-  GROK_3_MINI.name,
-  GROK_2_VISION.name,
-  GROK_4_20.name,
-  GROK_4_20_MULTI_AGENT.name,
-  GROK_4_3.name,
-  GROK_BUILD_0_1.name
-];
-const GROK_COMBINED_TOOLS_AND_SCHEMA_MODELS = /* @__PURE__ */ new Set([
-  GROK_4_1_FAST_REASONING.name,
-  GROK_4_1_FAST_NON_REASONING.name,
-  GROK_CODE_FAST_1.name,
-  GROK_4_FAST_REASONING.name,
-  GROK_4_FAST_NON_REASONING.name,
-  GROK_4.name,
-  GROK_4_20.name,
-  GROK_4_20_MULTI_AGENT.name,
-  GROK_4_3.name
-]);
+const GROK_CHAT_MODELS = [GROK_BUILD_0_1.name, GROK_4_3.name];
 const GROK_IMAGE_MODELS = [
   GROK_2_IMAGE.name,
   GROK_IMAGINE_IMAGE.name,
   GROK_IMAGINE_IMAGE_QUALITY.name
 ];
+const GROK_VIDEO_MODELS = [
+  GROK_IMAGINE_VIDEO.name,
+  GROK_IMAGINE_VIDEO_1_5.name
+];
 const GROK_TTS = {
   name: "grok-tts"
 };
@@ -97,10 +49,10 @@ const GROK_REALTIME_MODELS = [
 ];
 export {
   GROK_CHAT_MODELS,
-  GROK_COMBINED_TOOLS_AND_SCHEMA_MODELS,
   GROK_IMAGE_MODELS,
   GROK_REALTIME_MODELS,
   GROK_TRANSCRIPTION_MODELS,
-  GROK_TTS_MODELS
+  GROK_TTS_MODELS,
+  GROK_VIDEO_MODELS
 };
 //# sourceMappingURL=model-meta.js.map

package/dist/esm/model-meta.js.map

@@ -1 +1 @@
-{"version":3,"file":"model-meta.js","sources":["../../src/model-meta.ts"],"sourcesContent":["/**\n * Model metadata interface for documentation and type inference\n */\ninterface ModelMeta {\n  name: string\n  supports: {\n    input: Array<'text' | 'image' | 'audio' | 'video' | 'document'>\n    output: Array<'text' | 'image' | 'audio' | 'video'>\n    capabilities?: Array<'reasoning' | 'tool_calling' | 'structured_outputs'>\n    tools?: ReadonlyArray<never>\n  }\n  max_input_tokens?: number\n  max_output_tokens?: number\n  context_window?: number\n  knowledge_cutoff?: string\n  pricing?: {\n    input: {\n      normal: number\n      cached?: number\n    }\n    output: {\n      normal: number\n    }\n  }\n}\n\nconst GROK_4_1_FAST_REASONING = {\n  name: 'grok-4-1-fast-reasoning',\n  context_window: 2_000_000,\n  supports: {\n    input: ['text', 'image'],\n    output: ['text'],\n    capabilities: ['reasoning', 'structured_outputs', 'tool_calling'],\n    tools: [] as const,\n  },\n  pricing: {\n    input: {\n      normal: 0.2,\n      cached: 0.05,\n    },\n    output: {\n      normal: 0.5,\n    },\n  },\n} as const satisfies ModelMeta\n\nconst GROK_4_1_FAST_NON_REASONING = {\n  name: 'grok-4-1-fast-non-reasoning',\n  context_window: 2_000_000,\n  supports: {\n    input: ['text', 'image'],\n    output: ['text'],\n    capabilities: ['structured_outputs', 'tool_calling'],\n    tools: [] as const,\n  },\n  pricing: {\n    input: {\n      normal: 0.2,\n      cached: 0.05,\n    },\n    output: {\n      normal: 0.5,\n    },\n  },\n} as const satisfies ModelMeta\n\nconst GROK_CODE_FAST_1 = {\n  name: 'grok-code-fast-1',\n  context_window: 256_000,\n  supports: {\n    input: ['text'],\n    output: ['text'],\n    capabilities: ['reasoning', 'structured_outputs', 'tool_calling'],\n    tools: [] as const,\n  },\n  pricing: {\n    input: {\n      normal: 0.2,\n      cached: 0.02,\n    },\n    output: {\n      normal: 1.5,\n    },\n  },\n} as const satisfies ModelMeta\n\nconst GROK_4_FAST_REASONING = {\n  name: 'grok-4-fast-reasoning',\n  context_window: 2_000_000,\n  supports: {\n    input: ['text', 'image'],\n    output: ['text'],\n    capabilities: ['reasoning', 'structured_outputs', 'tool_calling'],\n    tools: [] as const,\n  },\n  pricing: {\n    input: {\n      normal: 0.2,\n      cached: 0.05,\n    },\n    output: {\n      normal: 0.5,\n    },\n  },\n} as const satisfies ModelMeta\n\nconst GROK_4_FAST_NON_REASONING = {\n  name: 'grok-4-fast-non-reasoning',\n  context_window: 2_000_000,\n  supports: {\n    input: ['text', 'image'],\n    output: ['text'],\n    capabilities: ['structured_outputs', 'tool_calling'],\n    tools: [] as const,\n  },\n  pricing: {\n    input: {\n      normal: 0.2,\n      cached: 0.05,\n    },\n    output: {\n      normal: 0.5,\n    },\n  },\n} as const satisfies ModelMeta\n\nconst GROK_4 = {\n  name: 'grok-4',\n  context_window: 256_000,\n  supports: {\n    input: ['text', 'image'],\n    output: ['text'],\n    capabilities: ['reasoning', 'structured_outputs', 'tool_calling'],\n    tools: [] as const,\n  },\n  pricing: {\n    input: {\n      normal: 3,\n      cached: 0.75,\n    },\n    output: {\n      normal: 15,\n    },\n  },\n} as const satisfies ModelMeta\n\nconst GROK_3_MINI = {\n  name: 'grok-3-mini',\n  context_window: 131_072,\n  supports: {\n    input: ['text'],\n    output: ['text'],\n    capabilities: ['reasoning', 'structured_outputs', 'tool_calling'],\n    tools: [] as const,\n  },\n  pricing: {\n    input: {\n      normal: 0.3,\n      cached: 0.075,\n    },\n    output: {\n      normal: 0.5,\n    },\n  },\n} as const satisfies ModelMeta\n\nconst GROK_3 = {\n  name: 'grok-3',\n  context_window: 131_072,\n  supports: {\n    input: ['text'],\n    output: ['text'],\n    capabilities: ['structured_outputs', 'tool_calling'],\n    tools: [] as const,\n  },\n  pricing: {\n    input: {\n      normal: 3,\n      cached: 0.75,\n    },\n    output: {\n      normal: 15,\n    },\n  },\n} as const satisfies ModelMeta\n\nconst GROK_2_VISION = {\n  name: 'grok-2-vision-1212',\n  context_window: 32_768,\n  supports: {\n    input: ['text', 'image'],\n    output: ['text'],\n    capabilities: ['structured_outputs', 'tool_calling'],\n    tools: [] as const,\n  },\n  pricing: {\n    input: {\n      normal: 2,\n    },\n    output: {\n      normal: 10,\n    },\n  },\n} as const satisfies ModelMeta\n\nconst GROK_2_IMAGE = {\n  name: 'grok-2-image-1212',\n  supports: {\n    input: ['text'],\n    output: ['image'],\n  },\n  pricing: {\n    input: {\n      normal: 0.07,\n    },\n    output: {\n      normal: 0.07,\n    },\n  },\n} as const satisfies ModelMeta\n\n// Imagine API image models. Pricing is per generated image (output only).\nconst GROK_IMAGINE_IMAGE = {\n  name: 'grok-imagine-image',\n  supports: {\n    input: ['text', 'image'],\n    output: ['image'],\n  },\n  pricing: {\n    input: {\n      normal: 0,\n    },\n    output: {\n      normal: 0.02,\n    },\n  },\n} as const satisfies ModelMeta\n\nconst GROK_IMAGINE_IMAGE_QUALITY = {\n  name: 'grok-imagine-image-quality',\n  supports: {\n    input: ['text', 'image'],\n    output: ['image'],\n  },\n  pricing: {\n    input: {\n      normal: 0,\n    },\n    output: {\n      normal: 0.05,\n    },\n  },\n} as const satisfies ModelMeta\n\n/**\n * Grok Chat Models\n * Based on xAI's available models as of 2025\n */\nconst GROK_4_20 = {\n  name: 'grok-4.20',\n  context_window: 2_000_000,\n  supports: {\n    input: ['text', 'image', 'document'],\n    output: ['text'],\n    capabilities: ['reasoning', 'structured_outputs', 'tool_calling'],\n    tools: [] as const,\n  },\n  pricing: {\n    input: {\n      normal: 2,\n      cached: 0.2,\n    },\n    output: {\n      normal: 6,\n    },\n  },\n} as const satisfies ModelMeta\n\nconst GROK_4_20_MULTI_AGENT = {\n  name: 'grok-4.20-multi-agent',\n  context_window: 2_000_000,\n  supports: {\n    input: ['text', 'image', 'document'],\n    output: ['text'],\n    capabilities: ['reasoning', 'structured_outputs', 'tool_calling'],\n    tools: [] as const,\n  },\n  pricing: {\n    input: {\n      normal: 2,\n      cached: 0.2,\n    },\n    output: {\n      normal: 6,\n    },\n  },\n} as const satisfies ModelMeta\n\nconst GROK_4_3 = {\n  name: 'grok-4.3',\n  context_window: 1_000_000,\n  supports: {\n    input: ['text', 'image'],\n    output: ['text'],\n    capabilities: ['reasoning', 'structured_outputs', 'tool_calling'],\n    tools: [],\n  },\n  pricing: {\n    input: {\n      normal: 1.25,\n      cached: 0.2,\n    },\n    output: {\n      normal: 2.5,\n    },\n  },\n} as const satisfies ModelMeta\n\nconst GROK_BUILD_0_1 = {\n  name: 'grok-build-0.1',\n  context_window: 256_000,\n  supports: {\n    input: ['text', 'image'],\n    output: ['text'],\n    capabilities: ['reasoning', 'structured_outputs', 'tool_calling'],\n    tools: [],\n  },\n  pricing: {\n    input: {\n      normal: 1,\n      cached: 0.2,\n    },\n    output: {\n      normal: 2,\n    },\n  },\n} as const satisfies ModelMeta\n\nexport const GROK_CHAT_MODELS = [\n  GROK_4_1_FAST_REASONING.name,\n  GROK_4_1_FAST_NON_REASONING.name,\n  GROK_CODE_FAST_1.name,\n  GROK_4_FAST_REASONING.name,\n  GROK_4_FAST_NON_REASONING.name,\n  GROK_4.name,\n  GROK_3.name,\n  GROK_3_MINI.name,\n  GROK_2_VISION.name,\n\n  GROK_4_20.name,\n  GROK_4_20_MULTI_AGENT.name,\n\n  GROK_4_3.name,\n\n  GROK_BUILD_0_1.name,\n] as const\n\n/**\n * Grok models that support combining `tools` + `response_format: json_schema`\n * in a single streaming Chat Completions request (per issue #605). xAI\n * docs gate this to the Grok 4 family — Grok 2 / 3 reject the\n * combination. Grok 2 image generation is not a chat model, omitted.\n *\n * Note: Grok streams tool-call arguments atomically (not token-streamed)\n * per the issue's source matrix; partial-JSON tool-arg parsing should be\n * skipped for Grok specifically. That's a separate adapter concern from\n * this set — the set only gates whether the engine takes the native\n * combined path vs the legacy finalization path.\n */\nexport const GROK_COMBINED_TOOLS_AND_SCHEMA_MODELS = new Set<string>([\n  GROK_4_1_FAST_REASONING.name,\n  GROK_4_1_FAST_NON_REASONING.name,\n  GROK_CODE_FAST_1.name,\n  GROK_4_FAST_REASONING.name,\n  GROK_4_FAST_NON_REASONING.name,\n  GROK_4.name,\n  GROK_4_20.name,\n  GROK_4_20_MULTI_AGENT.name,\n  GROK_4_3.name,\n])\n\n/**\n * Grok Image Generation Models\n */\nexport const GROK_IMAGE_MODELS = [\n  GROK_2_IMAGE.name,\n  GROK_IMAGINE_IMAGE.name,\n  GROK_IMAGINE_IMAGE_QUALITY.name,\n] as const\n\n// xAI's `/v1/tts` endpoint is endpoint-addressed and does not take a `model`\n// parameter. This synthetic identifier satisfies the SDK's `TTSOptions.model`\n// contract and provides a stable value for logging and fixture matching.\nconst GROK_TTS = {\n  name: 'grok-tts',\n  supports: {\n    input: ['text'],\n    output: ['audio'],\n  },\n} as const satisfies ModelMeta\n\n// xAI's `/v1/stt` endpoint is endpoint-addressed and does not take a `model`\n// parameter. This synthetic identifier satisfies the SDK's\n// `TranscriptionOptions.model` contract.\nconst GROK_STT = {\n  name: 'grok-stt',\n  supports: {\n    input: ['audio'],\n    output: ['text'],\n  },\n} as const satisfies ModelMeta\n\nconst GROK_VOICE_FAST_1 = {\n  name: 'grok-voice-fast-1.0',\n  supports: {\n    input: ['audio', 'text'],\n    output: ['audio', 'text'],\n    capabilities: ['tool_calling'],\n    tools: [] as const,\n  },\n} as const satisfies ModelMeta\n\nconst GROK_VOICE_THINK_FAST_1 = {\n  name: 'grok-voice-think-fast-1.0',\n  supports: {\n    input: ['audio', 'text'],\n    output: ['audio', 'text'],\n    capabilities: ['reasoning', 'tool_calling'],\n    tools: [] as const,\n  },\n} as const satisfies ModelMeta\n\nexport const GROK_TTS_MODELS = [GROK_TTS.name] as const\n\nexport const GROK_TRANSCRIPTION_MODELS = [GROK_STT.name] as const\n\nexport const GROK_REALTIME_MODELS = [\n  GROK_VOICE_FAST_1.name,\n  GROK_VOICE_THINK_FAST_1.name,\n] as const\n\nexport type GrokChatModel = (typeof GROK_CHAT_MODELS)[number]\nexport type GrokImageModel = (typeof GROK_IMAGE_MODELS)[number]\nexport type GrokTTSModel = (typeof GROK_TTS_MODELS)[number]\nexport type GrokTranscriptionModel = (typeof GROK_TRANSCRIPTION_MODELS)[number]\nexport type GrokRealtimeModel = (typeof GROK_REALTIME_MODELS)[number]\n\n/**\n * Type-only map from Grok chat model name to its supported input modalities.\n * Used for type inference when constructing multimodal messages.\n */\nexport type GrokModelInputModalitiesByName = {\n  [GROK_4_1_FAST_REASONING.name]: typeof GROK_4_1_FAST_REASONING.supports.input\n  [GROK_4_1_FAST_NON_REASONING.name]: typeof GROK_4_1_FAST_NON_REASONING.supports.input\n  [GROK_CODE_FAST_1.name]: typeof GROK_CODE_FAST_1.supports.input\n  [GROK_4_FAST_REASONING.name]: typeof GROK_4_FAST_REASONING.supports.input\n  [GROK_4_FAST_NON_REASONING.name]: typeof GROK_4_FAST_NON_REASONING.supports.input\n  [GROK_4.name]: typeof GROK_4.supports.input\n  [GROK_3.name]: typeof GROK_3.supports.input\n  [GROK_3_MINI.name]: typeof GROK_3_MINI.supports.input\n  [GROK_2_VISION.name]: typeof GROK_2_VISION.supports.input\n  [GROK_4_20.name]: typeof GROK_4_20.supports.input\n  [GROK_4_20_MULTI_AGENT.name]: typeof GROK_4_20_MULTI_AGENT.supports.input\n  [GROK_4_3.name]: typeof GROK_4_3.supports.input\n  [GROK_BUILD_0_1.name]: typeof GROK_BUILD_0_1.supports.input\n}\n\n/**\n * Type-only map from Grok chat model name to its provider options type.\n * Since Grok uses OpenAI-compatible API, we reuse OpenAI provider options.\n */\nexport type GrokChatModelProviderOptionsByName = {\n  [K in (typeof GROK_CHAT_MODELS)[number]]: GrokProviderOptions\n}\n\n/**\n * Type-only map from Grok chat model name to its supported provider tools.\n * Grok exposes no provider-specific tool factories, so every model gets an\n * empty tuple. This ensures that passing an Anthropic/OpenAI ProviderTool to\n * a Grok adapter produces a compile-time type error.\n */\nexport type GrokChatModelToolCapabilitiesByName = {\n  [GROK_4_1_FAST_REASONING.name]: typeof GROK_4_1_FAST_REASONING.supports.tools\n  [GROK_4_1_FAST_NON_REASONING.name]: typeof GROK_4_1_FAST_NON_REASONING.supports.tools\n  [GROK_CODE_FAST_1.name]: typeof GROK_CODE_FAST_1.supports.tools\n  [GROK_4_FAST_REASONING.name]: typeof GROK_4_FAST_REASONING.supports.tools\n  [GROK_4_FAST_NON_REASONING.name]: typeof GROK_4_FAST_NON_REASONING.supports.tools\n  [GROK_4.name]: typeof GROK_4.supports.tools\n  [GROK_3.name]: typeof GROK_3.supports.tools\n  [GROK_3_MINI.name]: typeof GROK_3_MINI.supports.tools\n  [GROK_2_VISION.name]: typeof GROK_2_VISION.supports.tools\n  [GROK_4_20.name]: typeof GROK_4_20.supports.tools\n  [GROK_4_20_MULTI_AGENT.name]: typeof GROK_4_20_MULTI_AGENT.supports.tools\n}\n\n/**\n * Grok-specific provider options\n * Based on OpenAI-compatible API options\n */\nexport interface GrokProviderOptions {\n  /** Temperature for response generation (0-2) */\n  temperature?: number\n  /** Maximum tokens in the response */\n  max_tokens?: number\n  /** Top-p sampling parameter */\n  top_p?: number\n  /** Frequency penalty (-2.0 to 2.0) */\n  frequency_penalty?: number\n  /** Presence penalty (-2.0 to 2.0) */\n  presence_penalty?: number\n  /** Stop sequences */\n  stop?: string | Array<string>\n  /** A unique identifier representing your end-user */\n  user?: string\n}\n\n// ===========================\n// Type Resolution Helpers\n// ===========================\n\n/**\n * Resolve provider options for a specific model.\n * If the model has explicit options in the map, use those; otherwise use base options.\n */\nexport type ResolveProviderOptions<TModel extends string> =\n  TModel extends keyof GrokChatModelProviderOptionsByName\n    ? GrokChatModelProviderOptionsByName[TModel]\n    : GrokProviderOptions\n\n/**\n * Resolve input modalities for a specific model.\n * If the model has explicit modalities in the map, use those; otherwise use text only.\n */\nexport type ResolveInputModalities<TModel extends string> =\n  TModel extends keyof GrokModelInputModalitiesByName\n    ? GrokModelInputModalitiesByName[TModel]\n    : readonly ['text']\n"],"names":[],"mappings":"AA0BA,MAAM,0BAA0B;AAAA,EAC9B,MAAM;AAiBR;AAEA,MAAM,8BAA8B;AAAA,EAClC,MAAM;AAiBR;AAEA,MAAM,mBAAmB;AAAA,EACvB,MAAM;AAiBR;AAEA,MAAM,wBAAwB;AAAA,EAC5B,MAAM;AAiBR;AAEA,MAAM,4BAA4B;AAAA,EAChC,MAAM;AAiBR;AAEA,MAAM,SAAS;AAAA,EACb,MAAM;AAiBR;AAEA,MAAM,cAAc;AAAA,EAClB,MAAM;AAiBR;AAEA,MAAM,SAAS;AAAA,EACb,MAAM;AAiBR;AAEA,MAAM,gBAAgB;AAAA,EACpB,MAAM;AAgBR;AAEA,MAAM,eAAe;AAAA,EACnB,MAAM;AAaR;AAGA,MAAM,qBAAqB;AAAA,EACzB,MAAM;AAaR;AAEA,MAAM,6BAA6B;AAAA,EACjC,MAAM;AAaR;AAMA,MAAM,YAAY;AAAA,EAChB,MAAM;AAiBR;AAEA,MAAM,wBAAwB;AAAA,EAC5B,MAAM;AAiBR;AAEA,MAAM,WAAW;AAAA,EACf,MAAM;AAiBR;AAEA,MAAM,iBAAiB;AAAA,EACrB,MAAM;AAiBR;AAEO,MAAM,mBAAmB;AAAA,EAC9B,wBAAwB;AAAA,EACxB,4BAA4B;AAAA,EAC5B,iBAAiB;AAAA,EACjB,sBAAsB;AAAA,EACtB,0BAA0B;AAAA,EAC1B,OAAO;AAAA,EACP,OAAO;AAAA,EACP,YAAY;AAAA,EACZ,cAAc;AAAA,EAEd,UAAU;AAAA,EACV,sBAAsB;AAAA,EAEtB,SAAS;AAAA,EAET,eAAe;AACjB;AAcO,MAAM,4DAA4C,IAAY;AAAA,EACnE,wBAAwB;AAAA,EACxB,4BAA4B;AAAA,EAC5B,iBAAiB;AAAA,EACjB,sBAAsB;AAAA,EACtB,0BAA0B;AAAA,EAC1B,OAAO;AAAA,EACP,UAAU;AAAA,EACV,sBAAsB;AAAA,EACtB,SAAS;AACX,CAAC;AAKM,MAAM,oBAAoB;AAAA,EAC/B,aAAa;AAAA,EACb,mBAAmB;AAAA,EACnB,2BAA2B;AAC7B;AAKA,MAAM,WAAW;AAAA,EACf,MAAM;AAKR;AAKA,MAAM,WAAW;AAAA,EACf,MAAM;AAKR;AAEA,MAAM,oBAAoB;AAAA,EACxB,MAAM;AAOR;AAEA,MAAM,0BAA0B;AAAA,EAC9B,MAAM;AAOR;AAEO,MAAM,kBAAkB,CAAC,SAAS,IAAI;AAEtC,MAAM,4BAA4B,CAAC,SAAS,IAAI;AAEhD,MAAM,uBAAuB;AAAA,EAClC,kBAAkB;AAAA,EAClB,wBAAwB;AAC1B;"}
+{"version":3,"file":"model-meta.js","sources":["../../src/model-meta.ts"],"sourcesContent":["/**\n * Model metadata interface for documentation and type inference\n */\nimport type {\n  GrokBuildProviderOptions,\n  GrokTextProviderOptions,\n} from './text/text-provider-options'\n\ninterface ModelMeta {\n  name: string\n  supports: {\n    input: Array<'text' | 'image' | 'audio' | 'video' | 'document'>\n    output: Array<'text' | 'image' | 'audio' | 'video'>\n    capabilities?: Array<'reasoning' | 'tool_calling' | 'structured_outputs'>\n    tools?: ReadonlyArray<GrokProviderToolKind>\n  }\n  max_input_tokens?: number\n  max_output_tokens?: number\n  context_window?: number\n  knowledge_cutoff?: string\n  pricing?: {\n    input: {\n      normal: number\n      cached?: number\n    }\n    output: {\n      normal: number\n    }\n  }\n}\n\nexport type GrokProviderToolKind =\n  | 'web_search'\n  | 'x_search'\n  | 'file_search'\n  | 'mcp'\n\nconst GROK_RESPONSES_TOOLS = [\n  'web_search',\n  'x_search',\n  'file_search',\n  'mcp',\n] as const satisfies ReadonlyArray<GrokProviderToolKind>\n\nconst GROK_2_IMAGE = {\n  name: 'grok-2-image-1212',\n  supports: {\n    input: ['text'],\n    output: ['image'],\n  },\n  pricing: {\n    input: {\n      normal: 0.07,\n    },\n    output: {\n      normal: 0.07,\n    },\n  },\n} as const satisfies ModelMeta\n\n// Imagine API image models. Pricing is per generated image (output only).\nconst GROK_IMAGINE_IMAGE = {\n  name: 'grok-imagine-image',\n  supports: {\n    input: ['text', 'image'],\n    output: ['image'],\n  },\n  pricing: {\n    input: {\n      normal: 0,\n    },\n    output: {\n      normal: 0.02,\n    },\n  },\n} as const satisfies ModelMeta\n\nconst GROK_IMAGINE_IMAGE_QUALITY = {\n  name: 'grok-imagine-image-quality',\n  supports: {\n    input: ['text', 'image'],\n    output: ['image'],\n  },\n  pricing: {\n    input: {\n      normal: 0,\n    },\n    output: {\n      normal: 0.05,\n    },\n  },\n} as const satisfies ModelMeta\n\n// Imagine API video models. Pricing is per second of generated video\n// (output only); generated videos carry an audio track.\n//\n// grok-imagine-video (v1.0) supports both text-to-video (a starting image is\n// optional) and image-to-video. grok-imagine-video-1.5 is image-to-video\n// only: a starting-frame image is required (the text prompt describes the\n// desired motion) — its text-to-video is rejected by the API.\nconst GROK_IMAGINE_VIDEO = {\n  name: 'grok-imagine-video',\n  supports: {\n    input: ['text', 'image'],\n    output: ['video', 'audio'],\n  },\n  pricing: {\n    input: {\n      normal: 0,\n    },\n    output: {\n      // per second of video\n      normal: 0.05,\n    },\n  },\n} as const satisfies ModelMeta\n\nconst GROK_IMAGINE_VIDEO_1_5 = {\n  name: 'grok-imagine-video-1.5',\n  supports: {\n    input: ['text', 'image'],\n    output: ['video', 'audio'],\n  },\n  pricing: {\n    input: {\n      normal: 0,\n    },\n    output: {\n      // per second of video\n      normal: 0.08,\n    },\n  },\n} as const satisfies ModelMeta\n\nconst GROK_4_3 = {\n  name: 'grok-4.3',\n  context_window: 1_000_000,\n  supports: {\n    input: ['text', 'image'],\n    output: ['text'],\n    capabilities: ['reasoning', 'structured_outputs', 'tool_calling'],\n    tools: GROK_RESPONSES_TOOLS,\n  },\n  pricing: {\n    input: {\n      normal: 1.25,\n      cached: 0.2,\n    },\n    output: {\n      normal: 2.5,\n    },\n  },\n} as const satisfies ModelMeta\n\nconst GROK_BUILD_0_1 = {\n  name: 'grok-build-0.1',\n  context_window: 256_000,\n  supports: {\n    input: ['text', 'image'],\n    output: ['text'],\n    capabilities: ['reasoning', 'structured_outputs', 'tool_calling'],\n    tools: GROK_RESPONSES_TOOLS,\n  },\n  pricing: {\n    input: {\n      normal: 1,\n      cached: 0.2,\n    },\n    output: {\n      normal: 2,\n    },\n  },\n} as const satisfies ModelMeta\n\n/**\n * Grok chat models supported by the Responses adapter.\n */\nexport const GROK_CHAT_MODELS = [GROK_BUILD_0_1.name, GROK_4_3.name] as const\n\n/**\n * Grok Image Generation Models\n */\nexport const GROK_IMAGE_MODELS = [\n  GROK_2_IMAGE.name,\n  GROK_IMAGINE_IMAGE.name,\n  GROK_IMAGINE_IMAGE_QUALITY.name,\n] as const\n\n/**\n * Grok Video Generation Models (xAI Imagine API)\n *\n * @experimental Video generation is an experimental feature and may change.\n */\nexport const GROK_VIDEO_MODELS = [\n  GROK_IMAGINE_VIDEO.name,\n  GROK_IMAGINE_VIDEO_1_5.name,\n] as const\n\n// xAI's `/v1/tts` endpoint is endpoint-addressed and does not take a `model`\n// parameter. This synthetic identifier satisfies the SDK's `TTSOptions.model`\n// contract and provides a stable value for logging and fixture matching.\nconst GROK_TTS = {\n  name: 'grok-tts',\n  supports: {\n    input: ['text'],\n    output: ['audio'],\n  },\n} as const satisfies ModelMeta\n\n// xAI's `/v1/stt` endpoint is endpoint-addressed and does not take a `model`\n// parameter. This synthetic identifier satisfies the SDK's\n// `TranscriptionOptions.model` contract.\nconst GROK_STT = {\n  name: 'grok-stt',\n  supports: {\n    input: ['audio'],\n    output: ['text'],\n  },\n} as const satisfies ModelMeta\n\nconst GROK_VOICE_FAST_1 = {\n  name: 'grok-voice-fast-1.0',\n  supports: {\n    input: ['audio', 'text'],\n    output: ['audio', 'text'],\n    capabilities: ['tool_calling'],\n    tools: [] as const,\n  },\n} as const satisfies ModelMeta\n\nconst GROK_VOICE_THINK_FAST_1 = {\n  name: 'grok-voice-think-fast-1.0',\n  supports: {\n    input: ['audio', 'text'],\n    output: ['audio', 'text'],\n    capabilities: ['reasoning', 'tool_calling'],\n    tools: [] as const,\n  },\n} as const satisfies ModelMeta\n\nexport const GROK_TTS_MODELS = [GROK_TTS.name] as const\n\nexport const GROK_TRANSCRIPTION_MODELS = [GROK_STT.name] as const\n\nexport const GROK_REALTIME_MODELS = [\n  GROK_VOICE_FAST_1.name,\n  GROK_VOICE_THINK_FAST_1.name,\n] as const\n\nexport type GrokChatModel = (typeof GROK_CHAT_MODELS)[number]\nexport type GrokImageModel = (typeof GROK_IMAGE_MODELS)[number]\nexport type GrokVideoModel = (typeof GROK_VIDEO_MODELS)[number]\nexport type GrokTTSModel = (typeof GROK_TTS_MODELS)[number]\nexport type GrokTranscriptionModel = (typeof GROK_TRANSCRIPTION_MODELS)[number]\nexport type GrokRealtimeModel = (typeof GROK_REALTIME_MODELS)[number]\n\n/**\n * Type-only map from Grok chat model name to its supported input modalities.\n * Used for type inference when constructing multimodal messages.\n */\nexport type GrokModelInputModalitiesByName = {\n  [GROK_4_3.name]: typeof GROK_4_3.supports.input\n  [GROK_BUILD_0_1.name]: typeof GROK_BUILD_0_1.supports.input\n}\n\n/**\n * Type-only map from Grok chat model name to its supported provider tools.\n * Keeps Grok provider-tool factories type-checked against the models that\n * advertise xAI Responses server-side tools.\n */\nexport type GrokChatModelToolCapabilitiesByName = {\n  [GROK_4_3.name]: typeof GROK_4_3.supports.tools\n  [GROK_BUILD_0_1.name]: typeof GROK_BUILD_0_1.supports.tools\n}\n\nexport type GrokProviderOptions = GrokTextProviderOptions\n\n/**\n * Type-only map from Grok chat model name to its provider options type.\n */\nexport type GrokChatModelProviderOptionsByName = {\n  [GROK_4_3.name]: GrokProviderOptions\n  [GROK_BUILD_0_1.name]: GrokBuildProviderOptions\n}\n\n// ===========================\n// Type Resolution Helpers\n// ===========================\n\n/**\n * Resolve provider options for a specific model.\n * If the model has explicit options in the map, use those; otherwise use base options.\n */\nexport type ResolveProviderOptions<TModel extends string> =\n  TModel extends keyof GrokChatModelProviderOptionsByName\n    ? GrokChatModelProviderOptionsByName[TModel]\n    : GrokProviderOptions\n\n/**\n * Resolve input modalities for a specific model.\n * If the model has explicit modalities in the map, use those; otherwise use text only.\n */\nexport type ResolveInputModalities<TModel extends string> =\n  TModel extends keyof GrokModelInputModalitiesByName\n    ? GrokModelInputModalitiesByName[TModel]\n    : readonly ['text']\n"],"names":[],"mappings":"AA4CA,MAAM,eAAe;AAAA,EACnB,MAAM;AAaR;AAGA,MAAM,qBAAqB;AAAA,EACzB,MAAM;AAaR;AAEA,MAAM,6BAA6B;AAAA,EACjC,MAAM;AAaR;AASA,MAAM,qBAAqB;AAAA,EACzB,MAAM;AAcR;AAEA,MAAM,yBAAyB;AAAA,EAC7B,MAAM;AAcR;AAEA,MAAM,WAAW;AAAA,EACf,MAAM;AAiBR;AAEA,MAAM,iBAAiB;AAAA,EACrB,MAAM;AAiBR;AAKO,MAAM,mBAAmB,CAAC,eAAe,MAAM,SAAS,IAAI;AAK5D,MAAM,oBAAoB;AAAA,EAC/B,aAAa;AAAA,EACb,mBAAmB;AAAA,EACnB,2BAA2B;AAC7B;AAOO,MAAM,oBAAoB;AAAA,EAC/B,mBAAmB;AAAA,EACnB,uBAAuB;AACzB;AAKA,MAAM,WAAW;AAAA,EACf,MAAM;AAKR;AAKA,MAAM,WAAW;AAAA,EACf,MAAM;AAKR;AAEA,MAAM,oBAAoB;AAAA,EACxB,MAAM;AAOR;AAEA,MAAM,0BAA0B;AAAA,EAC9B,MAAM;AAOR;AAEO,MAAM,kBAAkB,CAAC,SAAS,IAAI;AAEtC,MAAM,4BAA4B,CAAC,SAAS,IAAI;AAEhD,MAAM,uBAAuB;AAAA,EAClC,kBAAkB;AAAA,EAClB,wBAAwB;AAC1B;"}

package/dist/esm/text/text-provider-options.d.ts

@@ -1,9 +1,8 @@
-/**
- * Grok Text Provider Options
- *
- * Grok uses an OpenAI-compatible Chat Completions API.
- * However, not all OpenAI features may be supported by Grok.
- */
+import { ResponseCreateParams } from 'openai/resources/responses/responses';
+export type GrokReasoningEffort = 'none' | 'low' | 'medium' | 'high';
+export type GrokReasoning = Omit<NonNullable<ResponseCreateParams['reasoning']>, 'effort'> & {
+    effort?: GrokReasoningEffort;
+};
 /**
  * Base provider options for Grok text/chat models
  */
@@ -16,9 +15,9 @@ export interface GrokBaseOptions {
 }
 /**
  * Grok-specific provider options for text/chat
- * Based on OpenAI-compatible API options
+ * Based on xAI Responses API options
  */
-export interface GrokTextProviderOptions extends GrokBaseOptions {
+export interface GrokTextProviderOptions extends GrokBaseOptions, Record<string, unknown> {
     /**
      * Temperature for response generation (0-2)
      * Higher values make output more random, lower values more focused
@@ -32,20 +31,23 @@ export interface GrokTextProviderOptions extends GrokBaseOptions {
     /**
      * Maximum tokens in the response
      */
-    max_tokens?: number;
+    max_output_tokens?: number;
     /**
-     * Frequency penalty (-2.0 to 2.0)
+     * Whether xAI should store the response. Defaults to `false` in the adapter.
      */
-    frequency_penalty?: number;
+    store?: boolean;
     /**
-     * Presence penalty (-2.0 to 2.0)
+     * Additional response fields to include. Defaults to encrypted reasoning.
      */
-    presence_penalty?: number;
+    include?: ResponseCreateParams['include'];
     /**
-     * Stop sequences
+     * xAI/OpenAI-compatible reasoning controls for reasoning-capable models.
      */
-    stop?: string | Array<string>;
+    reasoning?: GrokReasoning;
 }
+export type GrokBuildProviderOptions = Omit<GrokTextProviderOptions, 'reasoning'> & {
+    reasoning?: never;
+};
 /**
  * External provider options (what users pass in)
  */

package/dist/esm/tools/index.d.ts

@@ -1 +1,45 @@
-export { type ChatCompletionFunctionTool as FunctionTool, convertFunctionToolToChatCompletionsFormat as convertFunctionToolToAdapterFormat, convertToolsToChatCompletionsFormat as convertToolsToProviderFormat, } from '@tanstack/openai-base';
+import { convertFunctionToolToResponsesFormat, ResponsesFunctionTool } from '@tanstack/openai-base';
+import { ProviderTool, Tool } from '@tanstack/ai';
+import { GrokProviderToolKind } from '../model-meta.js';
+export type FunctionTool = ResponsesFunctionTool;
+export { convertFunctionToolToResponsesFormat as convertFunctionToolToAdapterFormat };
+export type GrokProviderTool<TKind extends GrokProviderToolKind> = ProviderTool<'grok', TKind>;
+export interface GrokWebSearchToolConfig {
+    type: 'web_search';
+    filters?: {
+        allowed_domains?: Array<string>;
+        excluded_domains?: Array<string>;
+    };
+    enable_image_understanding?: boolean;
+    enable_image_search?: boolean;
+}
+export interface GrokXSearchToolConfig {
+    type: 'x_search';
+    allowed_x_handles?: Array<string>;
+    excluded_x_handles?: Array<string>;
+    from_date?: string;
+    to_date?: string;
+    enable_image_understanding?: boolean;
+    enable_video_understanding?: boolean;
+}
+export interface GrokFileSearchToolConfig {
+    type: 'file_search';
+    vector_store_ids: Array<string>;
+    max_num_results?: number;
+}
+export interface GrokMCPToolConfig {
+    type: 'mcp';
+    server_label: string;
+    server_url: string;
+    allowed_tools?: Array<string>;
+    server_description?: string;
+    authorization?: string;
+    headers?: Record<string, string>;
+}
+export type GrokServerTool = GrokWebSearchToolConfig | GrokXSearchToolConfig | GrokFileSearchToolConfig | GrokMCPToolConfig;
+export type GrokResponsesTool = GrokServerTool | ResponsesFunctionTool;
+export declare function grokWebSearchTool(config?: Omit<GrokWebSearchToolConfig, 'type'>): GrokProviderTool<'web_search'>;
+export declare function grokXSearchTool(config?: Omit<GrokXSearchToolConfig, 'type'>): GrokProviderTool<'x_search'>;
+export declare function grokFileSearchTool(config: Omit<GrokFileSearchToolConfig, 'type'>): GrokProviderTool<'file_search'>;
+export declare function grokMCPTool(config: Omit<GrokMCPToolConfig, 'type'>): GrokProviderTool<'mcp'>;
+export declare function convertToolsToProviderFormat(tools: Array<Tool>): Array<GrokResponsesTool>;