@tanstack/ai-grok 0.16.2 → 0.17.0

package/dist/esm/adapters/text.d.ts

@@ -1,5 +1,5 @@
 import { OpenAIBaseResponsesTextAdapter } from '@tanstack/openai-base';
-import { GROK_CHAT_MODELS, GrokChatModelToolCapabilitiesByName, ResolveInputModalities, ResolveProviderOptions } from '../model-meta.js';
+import { GROK_CHAT_MODELS, GrokChatModelToolCapabilitiesByName, GrokTextAdapterModel, ResolveInputModalities, ResolveProviderOptions } from '../model-meta.js';
 import { Modality, TextOptions } from '@tanstack/ai';
 import { GrokMessageMetadataByModality } from '../message-types.js';
 import { GrokClientConfig } from '../utils/client.js';
@@ -27,7 +27,7 @@ export type { ExternalTextProviderOptions as GrokTextProviderOptions } from '../
  * from `@tanstack/openai-base` and threads Grok-specific tool-capability
  * typing through the 5th generic of the base class.
  */
-export declare class GrokTextAdapter<TModel extends (typeof GROK_CHAT_MODELS)[number], TProviderOptions extends Record<string, any> = ResolveProviderOptions<TModel>, TInputModalities extends ReadonlyArray<Modality> = ResolveInputModalities<TModel>, TToolCapabilities extends ReadonlyArray<string> = ResolveToolCapabilities<TModel>> extends OpenAIBaseResponsesTextAdapter<TModel, TProviderOptions, TInputModalities, GrokMessageMetadataByModality, TToolCapabilities> {
+export declare class GrokTextAdapter<TModel extends GrokTextAdapterModel, TProviderOptions extends Record<string, any> = ResolveProviderOptions<TModel>, TInputModalities extends ReadonlyArray<Modality> = ResolveInputModalities<TModel>, TToolCapabilities extends ReadonlyArray<string> = ResolveToolCapabilities<TModel>> extends OpenAIBaseResponsesTextAdapter<TModel, TProviderOptions, TInputModalities, GrokMessageMetadataByModality, TToolCapabilities> {
     readonly kind: "text";
     readonly name: "grok";
     constructor(config: GrokTextConfig, model: TModel);

package/dist/esm/adapters/text.js.map

@@ -1 +1 @@
-{"version":3,"file":"text.js","names":[],"sources":["../../../src/adapters/text.ts"],"sourcesContent":["import OpenAI from 'openai'\nimport { OpenAIBaseResponsesTextAdapter } from '@tanstack/openai-base'\nimport { getGrokApiKeyFromEnv, withGrokDefaults } from '../utils/client'\nimport { convertToolsToProviderFormat } from '../tools'\nimport type {\n  GROK_CHAT_MODELS,\n  GrokChatModelToolCapabilitiesByName,\n  ResolveInputModalities,\n  ResolveProviderOptions,\n} from '../model-meta'\nimport type { Modality, TextOptions } from '@tanstack/ai'\nimport type { GrokMessageMetadataByModality } from '../message-types'\nimport type { GrokClientConfig } from '../utils/client'\nimport type { ResponseCreateParams } from 'openai/resources/responses/responses'\n\n/**\n * Resolve tool capabilities for a specific Grok model.\n */\ntype ResolveToolCapabilities<TModel extends string> =\n  TModel extends keyof GrokChatModelToolCapabilitiesByName\n    ? NonNullable<GrokChatModelToolCapabilitiesByName[TModel]>\n    : readonly []\n\n/**\n * Configuration for Grok text adapter\n */\nexport interface GrokTextConfig extends GrokClientConfig {}\n\n/**\n * Alias for TextProviderOptions for external use\n */\nexport type { ExternalTextProviderOptions as GrokTextProviderOptions } from '../text/text-provider-options'\n\n/**\n * Grok Text (Chat) Adapter\n *\n * Tree-shakeable adapter for Grok chat/text completion functionality.\n * Uses xAI's OpenAI-compatible Responses API.\n *\n * Delegates implementation to {@link OpenAIBaseResponsesTextAdapter}\n * from `@tanstack/openai-base` and threads Grok-specific tool-capability\n * typing through the 5th generic of the base class.\n */\nexport class GrokTextAdapter<\n  TModel extends (typeof GROK_CHAT_MODELS)[number],\n  // Use `Record<string, any>` (not `unknown`) to match the OpenAI text\n  // adapter: the resolved Grok provider options are a type-alias intersection\n  // with no explicit index signature, which is assignable to\n  // `Record<string, any>` but not `Record<string, unknown>`. See issue #821.\n  TProviderOptions extends Record<string, any> = ResolveProviderOptions<TModel>,\n  TInputModalities extends ReadonlyArray<Modality> =\n    ResolveInputModalities<TModel>,\n  TToolCapabilities extends ReadonlyArray<string> =\n    ResolveToolCapabilities<TModel>,\n> extends OpenAIBaseResponsesTextAdapter<\n  TModel,\n  TProviderOptions,\n  TInputModalities,\n  GrokMessageMetadataByModality,\n  TToolCapabilities\n> {\n  override readonly kind = 'text' as const\n  override readonly name = 'grok' as const\n\n  constructor(config: GrokTextConfig, model: TModel) {\n    super(model, 'grok', new OpenAI(withGrokDefaults(config)))\n  }\n\n  protected override mapOptionsToRequest(\n    options: TextOptions<TProviderOptions>,\n  ): Omit<ResponseCreateParams, 'stream'> {\n    const { tools: _baseTools, ...request } = super.mapOptionsToRequest({\n      ...options,\n      tools: undefined,\n    })\n    void _baseTools\n\n    if (this.model === 'grok-build-0.1' && request.reasoning !== undefined) {\n      throw new Error(\n        'grok-build-0.1 does not support reasoning modelOptions; omit reasoning for this model.',\n      )\n    }\n\n    const tools = options.tools\n      ? convertToolsToProviderFormat(options.tools)\n      : undefined\n\n    return {\n      ...request,\n      // xAI recommends encrypted reasoning for reasoning-capable Responses\n      // requests; callers can still override either field in modelOptions.\n      store: request.store ?? false,\n      include: request.include ?? ['reasoning.encrypted_content'],\n      ...(tools &&\n        tools.length > 0 && { tools: tools as ResponseCreateParams['tools'] }),\n    }\n  }\n}\n\n/**\n * Creates a Grok text adapter with explicit API key.\n * Type resolution happens here at the call site.\n *\n * @param model - The model name (e.g., 'grok-build-0.1')\n * @param apiKey - Your xAI API key\n * @param config - Optional additional configuration\n * @returns Configured Grok text adapter instance with resolved types\n *\n * @example\n * ```typescript\n * const adapter = createGrokText('grok-build-0.1', \"xai-...\");\n * // adapter has type-safe providerOptions for grok-build-0.1\n * ```\n */\nexport function createGrokText<\n  TModel extends (typeof GROK_CHAT_MODELS)[number],\n>(\n  model: TModel,\n  apiKey: string,\n  config?: Omit<GrokTextConfig, 'apiKey'>,\n): GrokTextAdapter<TModel> {\n  return new GrokTextAdapter({ apiKey, ...config }, model)\n}\n\n/**\n * Creates a Grok text adapter with automatic API key detection from environment variables.\n * Type resolution happens here at the call site.\n *\n * Looks for `XAI_API_KEY` in:\n * - `process.env` (Node.js)\n * - `window.env` (Browser with injected env)\n *\n * @param model - The model name (e.g., 'grok-build-0.1')\n * @param config - Optional configuration (excluding apiKey which is auto-detected)\n * @returns Configured Grok text adapter instance with resolved types\n * @throws Error if XAI_API_KEY is not found in environment\n *\n * @example\n * ```typescript\n * // Automatically uses XAI_API_KEY from environment\n * const adapter = grokText('grok-build-0.1');\n *\n * const stream = chat({\n *   adapter,\n *   messages: [{ role: \"user\", content: \"Hello!\" }]\n * });\n * ```\n */\nexport function grokText<TModel extends (typeof GROK_CHAT_MODELS)[number]>(\n  model: TModel,\n  config?: Omit<GrokTextConfig, 'apiKey'>,\n): GrokTextAdapter<TModel> {\n  const apiKey = getGrokApiKeyFromEnv()\n  return createGrokText(model, apiKey, config)\n}\n"],"mappings":";;;;;;;;;;;;;;;AA2CA,IAAa,kBAAb,cAWU,+BAMR;CACA,OAAyB;CACzB,OAAyB;CAEzB,YAAY,QAAwB,OAAe;EACjD,MAAM,OAAO,QAAQ,IAAI,OAAO,iBAAiB,MAAM,CAAC,CAAC;CAC3D;CAEA,oBACE,SACsC;EACtC,MAAM,EAAE,OAAO,YAAY,GAAG,YAAY,MAAM,oBAAoB;GAClE,GAAG;GACH,OAAO,KAAA;EACT,CAAC;EAGD,IAAI,KAAK,UAAU,oBAAoB,QAAQ,cAAc,KAAA,GAC3D,MAAM,IAAI,MACR,wFACF;EAGF,MAAM,QAAQ,QAAQ,QAClB,6BAA6B,QAAQ,KAAK,IAC1C,KAAA;EAEJ,OAAO;GACL,GAAG;GAGH,OAAO,QAAQ,SAAS;GACxB,SAAS,QAAQ,WAAW,CAAC,6BAA6B;GAC1D,GAAI,SACF,MAAM,SAAS,KAAK,EAAS,MAAuC;EACxE;CACF;AACF;;;;;;;;;;;;;;;;AAiBA,SAAgB,eAGd,OACA,QACA,QACyB;CACzB,OAAO,IAAI,gBAAgB;EAAE;EAAQ,GAAG;CAAO,GAAG,KAAK;AACzD;;;;;;;;;;;;;;;;;;;;;;;;;AA0BA,SAAgB,SACd,OACA,QACyB;CAEzB,OAAO,eAAe,OADP,qBACc,GAAQ,MAAM;AAC7C"}
+{"version":3,"file":"text.js","names":[],"sources":["../../../src/adapters/text.ts"],"sourcesContent":["import OpenAI from 'openai'\nimport { OpenAIBaseResponsesTextAdapter } from '@tanstack/openai-base'\nimport { getGrokApiKeyFromEnv, withGrokDefaults } from '../utils/client'\nimport { convertToolsToProviderFormat } from '../tools'\nimport type {\n  GROK_CHAT_MODELS,\n  GrokChatModelToolCapabilitiesByName,\n  GrokTextAdapterModel,\n  ResolveInputModalities,\n  ResolveProviderOptions,\n} from '../model-meta'\nimport type { Modality, TextOptions } from '@tanstack/ai'\nimport type { GrokMessageMetadataByModality } from '../message-types'\nimport type { GrokClientConfig } from '../utils/client'\nimport type { ResponseCreateParams } from 'openai/resources/responses/responses'\n\n/**\n * Resolve tool capabilities for a specific Grok model.\n */\ntype ResolveToolCapabilities<TModel extends string> =\n  TModel extends keyof GrokChatModelToolCapabilitiesByName\n    ? NonNullable<GrokChatModelToolCapabilitiesByName[TModel]>\n    : readonly []\n\n/**\n * Configuration for Grok text adapter\n */\nexport interface GrokTextConfig extends GrokClientConfig {}\n\n/**\n * Alias for TextProviderOptions for external use\n */\nexport type { ExternalTextProviderOptions as GrokTextProviderOptions } from '../text/text-provider-options'\n\n/**\n * Grok Text (Chat) Adapter\n *\n * Tree-shakeable adapter for Grok chat/text completion functionality.\n * Uses xAI's OpenAI-compatible Responses API.\n *\n * Delegates implementation to {@link OpenAIBaseResponsesTextAdapter}\n * from `@tanstack/openai-base` and threads Grok-specific tool-capability\n * typing through the 5th generic of the base class.\n */\nexport class GrokTextAdapter<\n  TModel extends GrokTextAdapterModel,\n  // Use `Record<string, any>` (not `unknown`) to match the OpenAI text\n  // adapter: the resolved Grok provider options are a type-alias intersection\n  // with no explicit index signature, which is assignable to\n  // `Record<string, any>` but not `Record<string, unknown>`. See issue #821.\n  TProviderOptions extends Record<string, any> = ResolveProviderOptions<TModel>,\n  TInputModalities extends ReadonlyArray<Modality> =\n    ResolveInputModalities<TModel>,\n  TToolCapabilities extends ReadonlyArray<string> =\n    ResolveToolCapabilities<TModel>,\n> extends OpenAIBaseResponsesTextAdapter<\n  TModel,\n  TProviderOptions,\n  TInputModalities,\n  GrokMessageMetadataByModality,\n  TToolCapabilities\n> {\n  override readonly kind = 'text' as const\n  override readonly name = 'grok' as const\n\n  constructor(config: GrokTextConfig, model: TModel) {\n    super(model, 'grok', new OpenAI(withGrokDefaults(config)))\n  }\n\n  protected override mapOptionsToRequest(\n    options: TextOptions<TProviderOptions>,\n  ): Omit<ResponseCreateParams, 'stream'> {\n    const { tools: _baseTools, ...request } = super.mapOptionsToRequest({\n      ...options,\n      tools: undefined,\n    })\n    void _baseTools\n\n    if (this.model === 'grok-build-0.1' && request.reasoning !== undefined) {\n      throw new Error(\n        'grok-build-0.1 does not support reasoning modelOptions; omit reasoning for this model.',\n      )\n    }\n\n    const tools = options.tools\n      ? convertToolsToProviderFormat(options.tools)\n      : undefined\n\n    return {\n      ...request,\n      // xAI recommends encrypted reasoning for reasoning-capable Responses\n      // requests; callers can still override either field in modelOptions.\n      store: request.store ?? false,\n      include: request.include ?? ['reasoning.encrypted_content'],\n      ...(tools &&\n        tools.length > 0 && { tools: tools as ResponseCreateParams['tools'] }),\n    }\n  }\n}\n\n/**\n * Creates a Grok text adapter with explicit API key.\n * Type resolution happens here at the call site.\n *\n * @param model - The model name (e.g., 'grok-build-0.1')\n * @param apiKey - Your xAI API key\n * @param config - Optional additional configuration\n * @returns Configured Grok text adapter instance with resolved types\n *\n * @example\n * ```typescript\n * const adapter = createGrokText('grok-build-0.1', \"xai-...\");\n * // adapter has type-safe providerOptions for grok-build-0.1\n * ```\n */\nexport function createGrokText<\n  TModel extends (typeof GROK_CHAT_MODELS)[number],\n>(\n  model: TModel,\n  apiKey: string,\n  config?: Omit<GrokTextConfig, 'apiKey'>,\n): GrokTextAdapter<TModel> {\n  return new GrokTextAdapter({ apiKey, ...config }, model)\n}\n\n/**\n * Creates a Grok text adapter with automatic API key detection from environment variables.\n * Type resolution happens here at the call site.\n *\n * Looks for `XAI_API_KEY` in:\n * - `process.env` (Node.js)\n * - `window.env` (Browser with injected env)\n *\n * @param model - The model name (e.g., 'grok-build-0.1')\n * @param config - Optional configuration (excluding apiKey which is auto-detected)\n * @returns Configured Grok text adapter instance with resolved types\n * @throws Error if XAI_API_KEY is not found in environment\n *\n * @example\n * ```typescript\n * // Automatically uses XAI_API_KEY from environment\n * const adapter = grokText('grok-build-0.1');\n *\n * const stream = chat({\n *   adapter,\n *   messages: [{ role: \"user\", content: \"Hello!\" }]\n * });\n * ```\n */\nexport function grokText<TModel extends (typeof GROK_CHAT_MODELS)[number]>(\n  model: TModel,\n  config?: Omit<GrokTextConfig, 'apiKey'>,\n): GrokTextAdapter<TModel> {\n  const apiKey = getGrokApiKeyFromEnv()\n  return createGrokText(model, apiKey, config)\n}\n"],"mappings":";;;;;;;;;;;;;;;AA4CA,IAAa,kBAAb,cAWU,+BAMR;CACA,OAAyB;CACzB,OAAyB;CAEzB,YAAY,QAAwB,OAAe;EACjD,MAAM,OAAO,QAAQ,IAAI,OAAO,iBAAiB,MAAM,CAAC,CAAC;CAC3D;CAEA,oBACE,SACsC;EACtC,MAAM,EAAE,OAAO,YAAY,GAAG,YAAY,MAAM,oBAAoB;GAClE,GAAG;GACH,OAAO,KAAA;EACT,CAAC;EAGD,IAAI,KAAK,UAAU,oBAAoB,QAAQ,cAAc,KAAA,GAC3D,MAAM,IAAI,MACR,wFACF;EAGF,MAAM,QAAQ,QAAQ,QAClB,6BAA6B,QAAQ,KAAK,IAC1C,KAAA;EAEJ,OAAO;GACL,GAAG;GAGH,OAAO,QAAQ,SAAS;GACxB,SAAS,QAAQ,WAAW,CAAC,6BAA6B;GAC1D,GAAI,SACF,MAAM,SAAS,KAAK,EAAS,MAAuC;EACxE;CACF;AACF;;;;;;;;;;;;;;;;AAiBA,SAAgB,eAGd,OACA,QACA,QACyB;CACzB,OAAO,IAAI,gBAAgB;EAAE;EAAQ,GAAG;CAAO,GAAG,KAAK;AACzD;;;;;;;;;;;;;;;;;;;;;;;;;AA0BA,SAAgB,SACd,OACA,QACyB;CAEzB,OAAO,eAAe,OADP,qBACc,GAAQ,MAAM;AAC7C"}

package/dist/esm/index.d.ts

@@ -9,8 +9,8 @@ export { GrokSpeechAdapter, createGrokSpeech, grokSpeech, type GrokSpeechConfig,
 export type { GrokTTSProviderOptions, GrokTTSVoice, GrokTTSCodec, } from './audio/tts-provider-options.js';
 export { GrokTranscriptionAdapter, createGrokTranscription, grokTranscription, type GrokTranscriptionConfig, } from './adapters/transcription.js';
 export type { GrokTranscriptionProviderOptions, GrokSTTAudioFormat, } from './audio/transcription-provider-options.js';
-export type { GrokChatModelProviderOptionsByName, GrokChatModelToolCapabilitiesByName, GrokModelInputModalitiesByName, ResolveProviderOptions, ResolveInputModalities, GrokChatModel, GrokImageModel, GrokVideoModel, GrokTTSModel, GrokTranscriptionModel, GrokRealtimeModel, } from './model-meta.js';
-export { GROK_CHAT_MODELS, GROK_IMAGE_MODELS, GROK_VIDEO_MODELS, GROK_TTS_MODELS, GROK_TRANSCRIPTION_MODELS, GROK_REALTIME_MODELS, GROK_DEFAULT_REALTIME_MODEL, } from './model-meta.js';
+export type { GrokChatModelProviderOptionsByName, GrokChatModelToolCapabilitiesByName, GrokModelInputModalitiesByName, ResolveProviderOptions, ResolveInputModalities, GrokChatModel, GrokVertexChatModel, GrokImageModel, GrokVideoModel, GrokTTSModel, GrokTranscriptionModel, GrokRealtimeModel, } from './model-meta.js';
+export { GROK_CHAT_MODELS, GROK_VERTEX_CHAT_MODELS, GROK_IMAGE_MODELS, GROK_VIDEO_MODELS, GROK_TTS_MODELS, GROK_TRANSCRIPTION_MODELS, GROK_REALTIME_MODELS, GROK_DEFAULT_REALTIME_MODEL, } from './model-meta.js';
 export type { GrokTextMetadata, GrokImageMetadata, GrokAudioMetadata, GrokVideoMetadata, GrokDocumentMetadata, GrokMessageMetadataByModality, } from './message-types.js';
 export { grokRealtimeToken, grokRealtime } from './realtime/index.js';
 export type { GrokRealtimeVoice, GrokRealtimeTokenOptions, GrokRealtimeOptions, GrokTurnDetection, GrokSemanticVADConfig, GrokServerVADConfig, } from './realtime/index.js';

package/dist/esm/index.js

@@ -5,8 +5,8 @@ import { GROK_VIDEO_DURATIONS, getGrokVideoDurationOptions } from "./video/video
 import { GrokVideoAdapter, createGrokVideo, grokVideo } from "./adapters/video.js";
 import { GrokSpeechAdapter, createGrokSpeech, grokSpeech } from "./adapters/tts.js";
 import { GrokTranscriptionAdapter, createGrokTranscription, grokTranscription } from "./adapters/transcription.js";
-import { GROK_CHAT_MODELS, GROK_DEFAULT_REALTIME_MODEL, GROK_IMAGE_MODELS, GROK_REALTIME_MODELS, GROK_TRANSCRIPTION_MODELS, GROK_TTS_MODELS, GROK_VIDEO_MODELS } from "./model-meta.js";
+import { GROK_CHAT_MODELS, GROK_DEFAULT_REALTIME_MODEL, GROK_IMAGE_MODELS, GROK_REALTIME_MODELS, GROK_TRANSCRIPTION_MODELS, GROK_TTS_MODELS, GROK_VERTEX_CHAT_MODELS, GROK_VIDEO_MODELS } from "./model-meta.js";
 import { grokRealtimeToken } from "./realtime/token.js";
 import { grokRealtime } from "./realtime/adapter.js";
 import "./realtime/index.js";
-export { GROK_CHAT_MODELS, GROK_DEFAULT_REALTIME_MODEL, GROK_IMAGE_MODELS, GROK_REALTIME_MODELS, GROK_TRANSCRIPTION_MODELS, GROK_TTS_MODELS, GROK_VIDEO_DURATIONS, GROK_VIDEO_MODELS, GrokImageAdapter, GrokSpeechAdapter, GrokTextAdapter, GrokTranscriptionAdapter, GrokVideoAdapter, createGrokImage, createGrokSpeech, createGrokSummarize, createGrokText, createGrokTranscription, createGrokVideo, getGrokVideoDurationOptions, grokImage, grokRealtime, grokRealtimeToken, grokSpeech, grokSummarize, grokText, grokTranscription, grokVideo };
+export { GROK_CHAT_MODELS, GROK_DEFAULT_REALTIME_MODEL, GROK_IMAGE_MODELS, GROK_REALTIME_MODELS, GROK_TRANSCRIPTION_MODELS, GROK_TTS_MODELS, GROK_VERTEX_CHAT_MODELS, GROK_VIDEO_DURATIONS, GROK_VIDEO_MODELS, GrokImageAdapter, GrokSpeechAdapter, GrokTextAdapter, GrokTranscriptionAdapter, GrokVideoAdapter, createGrokImage, createGrokSpeech, createGrokSummarize, createGrokText, createGrokTranscription, createGrokVideo, getGrokVideoDurationOptions, grokImage, grokRealtime, grokRealtimeToken, grokSpeech, grokSummarize, grokText, grokTranscription, grokVideo };

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

@@ -76,10 +76,55 @@ declare const GROK_BUILD_0_1: {
         };
     };
 };
+declare const GROK_4_20_REASONING: {
+    readonly name: "grok-4.20-reasoning";
+    readonly context_window: 1000000;
+    readonly supports: {
+        readonly input: ["text", "image"];
+        readonly output: ["text"];
+        readonly capabilities: ["reasoning", "structured_outputs", "tool_calling"];
+        readonly tools: readonly [];
+    };
+};
+declare const GROK_4_20_NON_REASONING: {
+    readonly name: "grok-4.20-non-reasoning";
+    readonly context_window: 1000000;
+    readonly supports: {
+        readonly input: ["text", "image"];
+        readonly output: ["text"];
+        readonly capabilities: ["structured_outputs", "tool_calling"];
+        readonly tools: readonly [];
+    };
+};
+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 [];
+    };
+};
+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 [];
+    };
+};
 /**
- * Grok chat models supported by the Responses adapter.
+ * Grok chat models supported by the xAI Responses adapter.
  */
 export declare const GROK_CHAT_MODELS: readonly ["grok-4.5", "grok-4.6", "grok-build-0.1", "grok-4.3"];
+/**
+ * Grok chat models on Vertex AI / Gemini Enterprise Agent Platform.
+ * This list is the Google partner catalog, not the xAI API catalog.
+ */
+export declare const GROK_VERTEX_CHAT_MODELS: readonly ["grok-4.3", "grok-4.20-reasoning", "grok-4.20-non-reasoning", "grok-4.1-fast-reasoning", "grok-4.1-fast-non-reasoning"];
 /**
  * Grok Image Generation Models
  */
@@ -100,6 +145,8 @@ export declare const GROK_REALTIME_MODELS: readonly ["grok-voice-think-fast-2.0"
  */
 export declare const GROK_DEFAULT_REALTIME_MODEL: GrokRealtimeModel;
 export type GrokChatModel = (typeof GROK_CHAT_MODELS)[number];
+export type GrokVertexChatModel = (typeof GROK_VERTEX_CHAT_MODELS)[number];
+export type GrokTextAdapterModel = GrokChatModel | GrokVertexChatModel;
 export type GrokImageModel = (typeof GROK_IMAGE_MODELS)[number];
 export type GrokVideoModel = (typeof GROK_VIDEO_MODELS)[number];
 export type GrokTTSModel = (typeof GROK_TTS_MODELS)[number];
@@ -114,6 +161,10 @@ export type GrokModelInputModalitiesByName = {
     [GROK_BUILD_0_1.name]: typeof GROK_BUILD_0_1.supports.input;
     [GROK_4_5.name]: typeof GROK_4_5.supports.input;
     [GROK_4_6.name]: typeof GROK_4_6.supports.input;
+    [GROK_4_20_REASONING.name]: typeof GROK_4_20_REASONING.supports.input;
+    [GROK_4_20_NON_REASONING.name]: typeof GROK_4_20_NON_REASONING.supports.input;
+    [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;
 };
 /**
  * Type-only map from Grok chat model name to its supported provider tools.
@@ -123,6 +174,10 @@ export type GrokModelInputModalitiesByName = {
 export type GrokChatModelToolCapabilitiesByName = {
     [GROK_4_3.name]: typeof GROK_4_3.supports.tools;
     [GROK_BUILD_0_1.name]: typeof GROK_BUILD_0_1.supports.tools;
+    [GROK_4_20_REASONING.name]: typeof GROK_4_20_REASONING.supports.tools;
+    [GROK_4_20_NON_REASONING.name]: typeof GROK_4_20_NON_REASONING.supports.tools;
+    [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;
 };
 export type GrokProviderOptions = GrokTextProviderOptions;
 /**
@@ -131,6 +186,10 @@ export type GrokProviderOptions = GrokTextProviderOptions;
 export type GrokChatModelProviderOptionsByName = {
     [GROK_4_3.name]: GrokProviderOptions;
     [GROK_BUILD_0_1.name]: GrokBuildProviderOptions;
+    [GROK_4_20_REASONING.name]: GrokProviderOptions;
+    [GROK_4_20_NON_REASONING.name]: GrokProviderOptions;
+    [GROK_4_1_FAST_REASONING.name]: GrokProviderOptions;
+    [GROK_4_1_FAST_NON_REASONING.name]: GrokProviderOptions;
 };
 /**
  * Resolve provider options for a specific model.

package/dist/esm/model-meta.js

@@ -167,8 +167,56 @@ var GROK_BUILD_0_1 = {
 		output: { normal: 2 }
 	}
 };
+var GROK_4_20_REASONING = {
+	name: "grok-4.20-reasoning",
+	context_window: 1e6,
+	supports: {
+		input: ["text", "image"],
+		output: ["text"],
+		capabilities: [
+			"reasoning",
+			"structured_outputs",
+			"tool_calling"
+		],
+		tools: []
+	}
+};
+var GROK_4_20_NON_REASONING = {
+	name: "grok-4.20-non-reasoning",
+	context_window: 1e6,
+	supports: {
+		input: ["text", "image"],
+		output: ["text"],
+		capabilities: ["structured_outputs", "tool_calling"],
+		tools: []
+	}
+};
+var GROK_4_1_FAST_REASONING = {
+	name: "grok-4.1-fast-reasoning",
+	context_window: 2e6,
+	supports: {
+		input: ["text", "image"],
+		output: ["text"],
+		capabilities: [
+			"reasoning",
+			"structured_outputs",
+			"tool_calling"
+		],
+		tools: []
+	}
+};
+var GROK_4_1_FAST_NON_REASONING = {
+	name: "grok-4.1-fast-non-reasoning",
+	context_window: 2e6,
+	supports: {
+		input: ["text", "image"],
+		output: ["text"],
+		capabilities: ["structured_outputs", "tool_calling"],
+		tools: []
+	}
+};
 /**
-* Grok chat models supported by the Responses adapter.
+* Grok chat models supported by the xAI Responses adapter.
 */
 var GROK_CHAT_MODELS = [
 	GROK_4_5.name,
@@ -177,6 +225,17 @@ var GROK_CHAT_MODELS = [
 	GROK_4_3.name
 ];
 /**
+* Grok chat models on Vertex AI / Gemini Enterprise Agent Platform.
+* This list is the Google partner catalog, not the xAI API catalog.
+*/
+var GROK_VERTEX_CHAT_MODELS = [
+	GROK_4_3.name,
+	GROK_4_20_REASONING.name,
+	GROK_4_20_NON_REASONING.name,
+	GROK_4_1_FAST_REASONING.name,
+	GROK_4_1_FAST_NON_REASONING.name
+];
+/**
 * Grok Image Generation Models
 */
 var GROK_IMAGE_MODELS = [
@@ -257,6 +316,6 @@ var GROK_REALTIME_MODELS = [
 */
 var GROK_DEFAULT_REALTIME_MODEL = "grok-voice-think-fast-2.0";
 //#endregion
-export { GROK_CHAT_MODELS, GROK_DEFAULT_REALTIME_MODEL, GROK_IMAGE_MODELS, GROK_REALTIME_MODELS, GROK_TRANSCRIPTION_MODELS, GROK_TTS_MODELS, GROK_VIDEO_MODELS };
+export { GROK_CHAT_MODELS, GROK_DEFAULT_REALTIME_MODEL, GROK_IMAGE_MODELS, GROK_REALTIME_MODELS, GROK_TRANSCRIPTION_MODELS, GROK_TTS_MODELS, GROK_VERTEX_CHAT_MODELS, GROK_VIDEO_MODELS };
 
 //# sourceMappingURL=model-meta.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"model-meta.js","names":[],"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\nconst GROK_4_5 = {\n  name: 'grok-4.5',\n  context_window: 500_000,\n  supports: {\n    input: ['text', 'image', 'document'],\n    output: ['text'],\n    capabilities: ['reasoning', 'structured_outputs', 'tool_calling'],\n    tools: [],\n  },\n  pricing: {\n    input: {\n      normal: 2,\n      cached: 0.3,\n    },\n    output: {\n      normal: 6,\n    },\n  },\n} as const satisfies ModelMeta\n\nconst GROK_4_6 = {\n  name: 'grok-4.6',\n  context_window: 500_000,\n  supports: {\n    input: ['text', 'image', 'document'],\n    output: ['text'],\n    capabilities: ['reasoning', 'structured_outputs', 'tool_calling'],\n    tools: [],\n  },\n  pricing: {\n    input: {\n      normal: 2,\n      cached: 0.5,\n    },\n    output: {\n      normal: 6,\n    },\n  },\n} as const satisfies ModelMeta\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// xAI's recommended Imagine image model. Supports the 2.0-only `quality`\n// provider option ('low' | 'medium', default 'medium').\nconst GROK_IMAGINE_IMAGE_2_0 = {\n  name: 'grok-imagine-image-2.0',\n  supports: {\n    input: ['text', 'image'],\n    output: ['image'],\n  },\n  pricing: {\n    input: {\n      normal: 0,\n    },\n    output: {\n      normal: 0.04,\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// Both models support text-to-video and image-to-video (a starting-frame\n// image is optional). grok-imagine-video-1.5 is the documented default: it\n// adds native 1080p for text-to-video / image-to-video plus\n// reference-to-video (`reference_images` / `reference_audios`; reference\n// output is capped at 720p). Source-video edit (`/v1/videos/edits`) and\n// extend (`/v1/videos/extensions`) are grok-imagine-video only — xAI's\n// 1.5 model page lists text+image input, not video.\nconst GROK_IMAGINE_VIDEO = {\n  name: 'grok-imagine-video',\n  supports: {\n    input: ['text', 'image', 'video'],\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 = [\n  GROK_4_5.name,\n  GROK_4_6.name,\n  GROK_BUILD_0_1.name,\n  GROK_4_3.name,\n] 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_2_0.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\n/** @deprecated xAI has deprecated grok-voice-think-fast-1.0 — use grok-voice-think-fast-2.0. */\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\n// xAI's current recommended speech-to-speech model.\nconst GROK_VOICE_THINK_FAST_2 = {\n  name: 'grok-voice-think-fast-2.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\n// Rolling alias used by xAI's realtime docs examples; always points at the\n// latest speech-to-speech model.\nconst GROK_VOICE_LATEST = {\n  name: 'grok-voice-latest',\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_THINK_FAST_2.name,\n  GROK_VOICE_LATEST.name,\n  GROK_VOICE_FAST_1.name,\n  GROK_VOICE_THINK_FAST_1.name,\n] as const\n\n/**\n * Default speech-to-speech model used by the realtime token issuer and the\n * realtime client adapter when no model is specified. Single source of truth\n * so a future default bump cannot leave the two sides disagreeing.\n */\nexport const GROK_DEFAULT_REALTIME_MODEL: GrokRealtimeModel =\n  'grok-voice-think-fast-2.0'\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  [GROK_4_5.name]: typeof GROK_4_5.supports.input\n  [GROK_4_6.name]: typeof GROK_4_6.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"],"mappings":"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"}
+{"version":3,"file":"model-meta.js","names":[],"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\nconst GROK_4_5 = {\n  name: 'grok-4.5',\n  context_window: 500_000,\n  supports: {\n    input: ['text', 'image', 'document'],\n    output: ['text'],\n    capabilities: ['reasoning', 'structured_outputs', 'tool_calling'],\n    tools: [],\n  },\n  pricing: {\n    input: {\n      normal: 2,\n      cached: 0.3,\n    },\n    output: {\n      normal: 6,\n    },\n  },\n} as const satisfies ModelMeta\n\nconst GROK_4_6 = {\n  name: 'grok-4.6',\n  context_window: 500_000,\n  supports: {\n    input: ['text', 'image', 'document'],\n    output: ['text'],\n    capabilities: ['reasoning', 'structured_outputs', 'tool_calling'],\n    tools: [],\n  },\n  pricing: {\n    input: {\n      normal: 2,\n      cached: 0.5,\n    },\n    output: {\n      normal: 6,\n    },\n  },\n} as const satisfies ModelMeta\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// xAI's recommended Imagine image model. Supports the 2.0-only `quality`\n// provider option ('low' | 'medium', default 'medium').\nconst GROK_IMAGINE_IMAGE_2_0 = {\n  name: 'grok-imagine-image-2.0',\n  supports: {\n    input: ['text', 'image'],\n    output: ['image'],\n  },\n  pricing: {\n    input: {\n      normal: 0,\n    },\n    output: {\n      normal: 0.04,\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// Both models support text-to-video and image-to-video (a starting-frame\n// image is optional). grok-imagine-video-1.5 is the documented default: it\n// adds native 1080p for text-to-video / image-to-video plus\n// reference-to-video (`reference_images` / `reference_audios`; reference\n// output is capped at 720p). Source-video edit (`/v1/videos/edits`) and\n// extend (`/v1/videos/extensions`) are grok-imagine-video only — xAI's\n// 1.5 model page lists text+image input, not video.\nconst GROK_IMAGINE_VIDEO = {\n  name: 'grok-imagine-video',\n  supports: {\n    input: ['text', 'image', 'video'],\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// Vertex Model Garden IDs. These are not the xAI API catalog.\n// Source: https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/partner-models/grok\nconst GROK_4_20_REASONING = {\n  name: 'grok-4.20-reasoning',\n  context_window: 1_000_000,\n  supports: {\n    input: ['text', 'image'],\n    output: ['text'],\n    capabilities: ['reasoning', 'structured_outputs', 'tool_calling'],\n    tools: [] as const,\n  },\n} as const satisfies ModelMeta\n\nconst GROK_4_20_NON_REASONING = {\n  name: 'grok-4.20-non-reasoning',\n  context_window: 1_000_000,\n  supports: {\n    input: ['text', 'image'],\n    output: ['text'],\n    capabilities: ['structured_outputs', 'tool_calling'],\n    tools: [] as const,\n  },\n} as const satisfies ModelMeta\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} 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} as const satisfies ModelMeta\n\n/**\n * Grok chat models supported by the xAI Responses adapter.\n */\nexport const GROK_CHAT_MODELS = [\n  GROK_4_5.name,\n  GROK_4_6.name,\n  GROK_BUILD_0_1.name,\n  GROK_4_3.name,\n] as const\n\n/**\n * Grok chat models on Vertex AI / Gemini Enterprise Agent Platform.\n * This list is the Google partner catalog, not the xAI API catalog.\n */\nexport const GROK_VERTEX_CHAT_MODELS = [\n  GROK_4_3.name,\n  GROK_4_20_REASONING.name,\n  GROK_4_20_NON_REASONING.name,\n  GROK_4_1_FAST_REASONING.name,\n  GROK_4_1_FAST_NON_REASONING.name,\n] 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_2_0.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\n/** @deprecated xAI has deprecated grok-voice-think-fast-1.0 — use grok-voice-think-fast-2.0. */\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\n// xAI's current recommended speech-to-speech model.\nconst GROK_VOICE_THINK_FAST_2 = {\n  name: 'grok-voice-think-fast-2.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\n// Rolling alias used by xAI's realtime docs examples; always points at the\n// latest speech-to-speech model.\nconst GROK_VOICE_LATEST = {\n  name: 'grok-voice-latest',\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_THINK_FAST_2.name,\n  GROK_VOICE_LATEST.name,\n  GROK_VOICE_FAST_1.name,\n  GROK_VOICE_THINK_FAST_1.name,\n] as const\n\n/**\n * Default speech-to-speech model used by the realtime token issuer and the\n * realtime client adapter when no model is specified. Single source of truth\n * so a future default bump cannot leave the two sides disagreeing.\n */\nexport const GROK_DEFAULT_REALTIME_MODEL: GrokRealtimeModel =\n  'grok-voice-think-fast-2.0'\n\nexport type GrokChatModel = (typeof GROK_CHAT_MODELS)[number]\nexport type GrokVertexChatModel = (typeof GROK_VERTEX_CHAT_MODELS)[number]\nexport type GrokTextAdapterModel = GrokChatModel | GrokVertexChatModel\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  [GROK_4_5.name]: typeof GROK_4_5.supports.input\n  [GROK_4_6.name]: typeof GROK_4_6.supports.input\n  [GROK_4_20_REASONING.name]: typeof GROK_4_20_REASONING.supports.input\n  [GROK_4_20_NON_REASONING.name]: typeof GROK_4_20_NON_REASONING.supports.input\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}\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  [GROK_4_20_REASONING.name]: typeof GROK_4_20_REASONING.supports.tools\n  [GROK_4_20_NON_REASONING.name]: typeof GROK_4_20_NON_REASONING.supports.tools\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}\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  [GROK_4_20_REASONING.name]: GrokProviderOptions\n  [GROK_4_20_NON_REASONING.name]: GrokProviderOptions\n  [GROK_4_1_FAST_REASONING.name]: GrokProviderOptions\n  [GROK_4_1_FAST_NON_REASONING.name]: GrokProviderOptions\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"],"mappings":"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"}

package/dist/esm/vertex/auth.d.ts

@@ -0,0 +1,27 @@
+export declare class GrokVertexAuthError extends Error {
+    constructor(message: string, options?: ErrorOptions);
+}
+export type VertexAuthClient = {
+    getRequestHeaders: (url?: string | URL) => Promise<Headers>;
+};
+/**
+ * Public Vertex config for Grok. `project` and `location` match the Gemini
+ * Vertex factories so one auth object works for both.
+ *
+ * Default location is `global`. Grok on Vertex uses the OpenAI-compatible
+ * Responses endpoint under `/endpoints/openapi`.
+ */
+export type GrokVertexConfig = {
+    project?: string;
+    location?: string;
+    /** Override the OpenAI-compatible Vertex base URL. Used by e2e. */
+    baseURL?: string;
+    getAccessToken?: () => Promise<string>;
+    authClient?: VertexAuthClient;
+    defaultHeaders?: Record<string, string>;
+};
+export declare function toVertexGrokModelId(model: string): string;
+export declare function resolveGrokVertexProject(config: GrokVertexConfig): string | undefined;
+export declare function resolveGrokVertexLocation(config: GrokVertexConfig): string;
+export declare function resolveGrokVertexBaseURL(config: GrokVertexConfig): string;
+export declare function resolveGrokVertexAccessToken(config: GrokVertexConfig): Promise<string>;

package/dist/esm/vertex/auth.js

@@ -0,0 +1,61 @@
+//#region src/vertex/auth.ts
+var GrokVertexAuthError = class extends Error {
+	constructor(message, options) {
+		super(message, options);
+		this.name = "GrokVertexAuthError";
+	}
+};
+function isMissingGoogleAuthLibrary(error) {
+	if (!(error instanceof Error) || !("code" in error)) return false;
+	const code = error.code;
+	if (code !== "ERR_MODULE_NOT_FOUND" && code !== "MODULE_NOT_FOUND") return false;
+	return error.message.includes("google-auth-library");
+}
+function nonEmpty(value) {
+	if (value === void 0 || value.length === 0) return;
+	return value;
+}
+function readEnv(name) {
+	if (typeof process === "undefined" || process.env === void 0) return;
+	return nonEmpty(process.env[name]);
+}
+function toVertexGrokModelId(model) {
+	if (model.startsWith("xai/")) return model;
+	return `xai/${model}`;
+}
+function resolveGrokVertexProject(config) {
+	return nonEmpty(config.project) ?? readEnv("GOOGLE_CLOUD_PROJECT") ?? readEnv("GOOGLE_VERTEX_PROJECT");
+}
+function resolveGrokVertexLocation(config) {
+	return nonEmpty(config.location) ?? readEnv("GOOGLE_CLOUD_LOCATION") ?? readEnv("GOOGLE_VERTEX_LOCATION") ?? "global";
+}
+function resolveGrokVertexBaseURL(config) {
+	if (config.baseURL !== void 0 && config.baseURL.length > 0) return config.baseURL.replace(/\/+$/, "");
+	const project = resolveGrokVertexProject(config);
+	if (project === void 0) throw new GrokVertexAuthError("Grok Vertex needs a project, or a baseURL. Pass project on the factory, or set GOOGLE_CLOUD_PROJECT or GOOGLE_VERTEX_PROJECT.");
+	const location = resolveGrokVertexLocation(config);
+	if (location === "global") return `https://aiplatform.googleapis.com/v1/projects/${project}/locations/global/endpoints/openapi`;
+	return `https://${location}-aiplatform.googleapis.com/v1/projects/${project}/locations/${location}/endpoints/openapi`;
+}
+async function resolveGrokVertexAccessToken(config) {
+	if (config.getAccessToken !== void 0) return config.getAccessToken();
+	if (config.authClient !== void 0) {
+		const authorization = (await config.authClient.getRequestHeaders()).get("Authorization");
+		if (authorization === null || !authorization.startsWith("Bearer ")) throw new GrokVertexAuthError("Grok Vertex authClient.getRequestHeaders() must return an Authorization Bearer token.");
+		return authorization.slice(7);
+	}
+	try {
+		const { GoogleAuth } = await import("google-auth-library");
+		const token = await (await new GoogleAuth({ scopes: ["https://www.googleapis.com/auth/cloud-platform"] }).getClient()).getAccessToken();
+		if (token.token === null || token.token === void 0) throw new GrokVertexAuthError("Grok Vertex could not load a Google access token from Application Default Credentials.");
+		return token.token;
+	} catch (error) {
+		if (error instanceof GrokVertexAuthError) throw error;
+		if (isMissingGoogleAuthLibrary(error)) throw new GrokVertexAuthError("Grok Vertex needs google-auth-library, or pass authClient or getAccessToken. Install google-auth-library next to @tanstack/ai-grok.");
+		throw new GrokVertexAuthError("Grok Vertex could not load a Google access token from Application Default Credentials.", { cause: error });
+	}
+}
+//#endregion
+export { GrokVertexAuthError, resolveGrokVertexAccessToken, resolveGrokVertexBaseURL, resolveGrokVertexLocation, resolveGrokVertexProject, toVertexGrokModelId };
+
+//# sourceMappingURL=auth.js.map

package/dist/esm/vertex/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","names":[],"sources":["../../../src/vertex/auth.ts"],"sourcesContent":["export class GrokVertexAuthError extends Error {\n  constructor(message: string, options?: ErrorOptions) {\n    super(message, options)\n    this.name = 'GrokVertexAuthError'\n  }\n}\n\nfunction isMissingGoogleAuthLibrary(error: unknown): boolean {\n  if (!(error instanceof Error) || !('code' in error)) {\n    return false\n  }\n  const code = error.code\n  if (code !== 'ERR_MODULE_NOT_FOUND' && code !== 'MODULE_NOT_FOUND') {\n    return false\n  }\n  return error.message.includes('google-auth-library')\n}\n\nexport type VertexAuthClient = {\n  getRequestHeaders: (url?: string | URL) => Promise<Headers>\n}\n\n/**\n * Public Vertex config for Grok. `project` and `location` match the Gemini\n * Vertex factories so one auth object works for both.\n *\n * Default location is `global`. Grok on Vertex uses the OpenAI-compatible\n * Responses endpoint under `/endpoints/openapi`.\n */\nexport type GrokVertexConfig = {\n  project?: string\n  location?: string\n  /** Override the OpenAI-compatible Vertex base URL. Used by e2e. */\n  baseURL?: string\n  getAccessToken?: () => Promise<string>\n  authClient?: VertexAuthClient\n  defaultHeaders?: Record<string, string>\n}\n\nfunction nonEmpty(value: string | undefined): string | undefined {\n  if (value === undefined || value.length === 0) {\n    return undefined\n  }\n  return value\n}\n\nfunction readEnv(name: string): string | undefined {\n  if (typeof process === 'undefined' || process.env === undefined) {\n    return undefined\n  }\n  return nonEmpty(process.env[name])\n}\n\nexport function toVertexGrokModelId(model: string): string {\n  if (model.startsWith('xai/')) {\n    return model\n  }\n  return `xai/${model}`\n}\n\nexport function resolveGrokVertexProject(\n  config: GrokVertexConfig,\n): string | undefined {\n  return (\n    nonEmpty(config.project) ??\n    readEnv('GOOGLE_CLOUD_PROJECT') ??\n    readEnv('GOOGLE_VERTEX_PROJECT')\n  )\n}\n\nexport function resolveGrokVertexLocation(config: GrokVertexConfig): string {\n  return (\n    nonEmpty(config.location) ??\n    readEnv('GOOGLE_CLOUD_LOCATION') ??\n    readEnv('GOOGLE_VERTEX_LOCATION') ??\n    'global'\n  )\n}\n\nexport function resolveGrokVertexBaseURL(config: GrokVertexConfig): string {\n  if (config.baseURL !== undefined && config.baseURL.length > 0) {\n    return config.baseURL.replace(/\\/+$/, '')\n  }\n\n  const project = resolveGrokVertexProject(config)\n  if (project === undefined) {\n    throw new GrokVertexAuthError(\n      'Grok Vertex needs a project, or a baseURL. Pass project on the factory, or set GOOGLE_CLOUD_PROJECT or GOOGLE_VERTEX_PROJECT.',\n    )\n  }\n\n  const location = resolveGrokVertexLocation(config)\n  if (location === 'global') {\n    return `https://aiplatform.googleapis.com/v1/projects/${project}/locations/global/endpoints/openapi`\n  }\n  return `https://${location}-aiplatform.googleapis.com/v1/projects/${project}/locations/${location}/endpoints/openapi`\n}\n\nexport async function resolveGrokVertexAccessToken(\n  config: GrokVertexConfig,\n): Promise<string> {\n  if (config.getAccessToken !== undefined) {\n    return config.getAccessToken()\n  }\n\n  if (config.authClient !== undefined) {\n    const headers = await config.authClient.getRequestHeaders()\n    const authorization = headers.get('Authorization')\n    if (authorization === null || !authorization.startsWith('Bearer ')) {\n      throw new GrokVertexAuthError(\n        'Grok Vertex authClient.getRequestHeaders() must return an Authorization Bearer token.',\n      )\n    }\n    return authorization.slice('Bearer '.length)\n  }\n\n  try {\n    const { GoogleAuth } = await import('google-auth-library')\n    const auth = new GoogleAuth({\n      scopes: ['https://www.googleapis.com/auth/cloud-platform'],\n    })\n    const client = await auth.getClient()\n    const token = await client.getAccessToken()\n    if (token.token === null || token.token === undefined) {\n      throw new GrokVertexAuthError(\n        'Grok Vertex could not load a Google access token from Application Default Credentials.',\n      )\n    }\n    return token.token\n  } catch (error) {\n    if (error instanceof GrokVertexAuthError) {\n      throw error\n    }\n    if (isMissingGoogleAuthLibrary(error)) {\n      throw new GrokVertexAuthError(\n        'Grok Vertex needs google-auth-library, or pass authClient or getAccessToken. Install google-auth-library next to @tanstack/ai-grok.',\n      )\n    }\n    throw new GrokVertexAuthError(\n      'Grok Vertex could not load a Google access token from Application Default Credentials.',\n      { cause: error },\n    )\n  }\n}\n"],"mappings":";AAAA,IAAa,sBAAb,cAAyC,MAAM;CAC7C,YAAY,SAAiB,SAAwB;EACnD,MAAM,SAAS,OAAO;EACtB,KAAK,OAAO;CACd;AACF;AAEA,SAAS,2BAA2B,OAAyB;CAC3D,IAAI,EAAE,iBAAiB,UAAU,EAAE,UAAU,QAC3C,OAAO;CAET,MAAM,OAAO,MAAM;CACnB,IAAI,SAAS,0BAA0B,SAAS,oBAC9C,OAAO;CAET,OAAO,MAAM,QAAQ,SAAS,qBAAqB;AACrD;AAuBA,SAAS,SAAS,OAA+C;CAC/D,IAAI,UAAU,KAAA,KAAa,MAAM,WAAW,GAC1C;CAEF,OAAO;AACT;AAEA,SAAS,QAAQ,MAAkC;CACjD,IAAI,OAAO,YAAY,eAAe,QAAQ,QAAQ,KAAA,GACpD;CAEF,OAAO,SAAS,QAAQ,IAAI,KAAK;AACnC;AAEA,SAAgB,oBAAoB,OAAuB;CACzD,IAAI,MAAM,WAAW,MAAM,GACzB,OAAO;CAET,OAAO,OAAO;AAChB;AAEA,SAAgB,yBACd,QACoB;CACpB,OACE,SAAS,OAAO,OAAO,KACvB,QAAQ,sBAAsB,KAC9B,QAAQ,uBAAuB;AAEnC;AAEA,SAAgB,0BAA0B,QAAkC;CAC1E,OACE,SAAS,OAAO,QAAQ,KACxB,QAAQ,uBAAuB,KAC/B,QAAQ,wBAAwB,KAChC;AAEJ;AAEA,SAAgB,yBAAyB,QAAkC;CACzE,IAAI,OAAO,YAAY,KAAA,KAAa,OAAO,QAAQ,SAAS,GAC1D,OAAO,OAAO,QAAQ,QAAQ,QAAQ,EAAE;CAG1C,MAAM,UAAU,yBAAyB,MAAM;CAC/C,IAAI,YAAY,KAAA,GACd,MAAM,IAAI,oBACR,+HACF;CAGF,MAAM,WAAW,0BAA0B,MAAM;CACjD,IAAI,aAAa,UACf,OAAO,iDAAiD,QAAQ;CAElE,OAAO,WAAW,SAAS,yCAAyC,QAAQ,aAAa,SAAS;AACpG;AAEA,eAAsB,6BACpB,QACiB;CACjB,IAAI,OAAO,mBAAmB,KAAA,GAC5B,OAAO,OAAO,eAAe;CAG/B,IAAI,OAAO,eAAe,KAAA,GAAW;EAEnC,MAAM,iBAAgB,MADA,OAAO,WAAW,kBAAkB,EAAA,CAC5B,IAAI,eAAe;EACjD,IAAI,kBAAkB,QAAQ,CAAC,cAAc,WAAW,SAAS,GAC/D,MAAM,IAAI,oBACR,uFACF;EAEF,OAAO,cAAc,MAAM,CAAgB;CAC7C;CAEA,IAAI;EACF,MAAM,EAAE,eAAe,MAAM,OAAO;EAKpC,MAAM,QAAQ,OAAM,MADC,IAHJ,WAAW,EAC1B,QAAQ,CAAC,gDAAgD,EAC3D,CACqB,CAAA,CAAK,UAAU,EAAA,CACT,eAAe;EAC1C,IAAI,MAAM,UAAU,QAAQ,MAAM,UAAU,KAAA,GAC1C,MAAM,IAAI,oBACR,wFACF;EAEF,OAAO,MAAM;CACf,SAAS,OAAO;EACd,IAAI,iBAAiB,qBACnB,MAAM;EAER,IAAI,2BAA2B,KAAK,GAClC,MAAM,IAAI,oBACR,qIACF;EAEF,MAAM,IAAI,oBACR,0FACA,EAAE,OAAO,MAAM,CACjB;CACF;AACF"}

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

@@ -0,0 +1,17 @@
+import { ChatStreamSummarizeAdapter, InferTextProviderOptions } from '@tanstack/ai/adapters';
+import { GrokTextAdapter } from '../adapters/text.js';
+import { GrokVertexChatModel, ResolveInputModalities, ResolveProviderOptions } from '../model-meta.js';
+import { GrokVertexConfig } from './auth.js';
+export { GrokVertexAuthError, resolveGrokVertexAccessToken, resolveGrokVertexBaseURL, resolveGrokVertexLocation, resolveGrokVertexProject, toVertexGrokModelId, type GrokVertexConfig, type VertexAuthClient, } from './auth.js';
+export { GROK_VERTEX_CHAT_MODELS, type GrokVertexChatModel, } from '../model-meta.js';
+/**
+ * Creates a Grok chat adapter that talks to xAI Grok on Vertex AI.
+ *
+ * Install `google-auth-library` next to `@tanstack/ai-grok` for Application
+ * Default Credentials. Or pass `authClient` or `getAccessToken`.
+ */
+export declare function grokVertexText<TModel extends GrokVertexChatModel>(model: TModel, config?: GrokVertexConfig): GrokTextAdapter<TModel, ResolveProviderOptions<TModel>, ResolveInputModalities<TModel>, readonly []>;
+/**
+ * Creates a Grok summarize adapter that talks to xAI Grok on Vertex AI.
+ */
+export declare function grokVertexSummarize<TModel extends GrokVertexChatModel>(model: TModel, config?: GrokVertexConfig): ChatStreamSummarizeAdapter<TModel, InferTextProviderOptions<GrokTextAdapter<TModel>>>;

package/dist/esm/vertex/index.js

@@ -0,0 +1,58 @@
+import { GrokTextAdapter } from "../adapters/text.js";
+import { GROK_VERTEX_CHAT_MODELS } from "../model-meta.js";
+import { GrokVertexAuthError, resolveGrokVertexAccessToken, resolveGrokVertexBaseURL, resolveGrokVertexLocation, resolveGrokVertexProject, toVertexGrokModelId } from "./auth.js";
+import { ChatStreamSummarizeAdapter } from "@tanstack/ai/adapters";
+//#region src/vertex/index.ts
+var VERTEX_UNSUPPORTED_GROK_SERVER_TOOLS = /* @__PURE__ */ new Set([
+	"web_search",
+	"x_search",
+	"file_search",
+	"mcp"
+]);
+var GrokVertexTextAdapter = class extends GrokTextAdapter {
+	mapOptionsToRequest(options) {
+		const request = super.mapOptionsToRequest(options);
+		const tools = request.tools;
+		if (tools !== void 0) for (const tool of tools) {
+			if (tool === null || typeof tool !== "object" || !("type" in tool)) continue;
+			if (VERTEX_UNSUPPORTED_GROK_SERVER_TOOLS.has(String(tool.type))) throw new Error("Grok Vertex does not support xAI server tools (web_search, x_search, file_search, mcp). Use a function tool.");
+		}
+		return {
+			...request,
+			model: toVertexGrokModelId(this.model)
+		};
+	}
+};
+/**
+* Creates a Grok chat adapter that talks to xAI Grok on Vertex AI.
+*
+* Install `google-auth-library` next to `@tanstack/ai-grok` for Application
+* Default Credentials. Or pass `authClient` or `getAccessToken`.
+*/
+function grokVertexText(model, config = {}) {
+	return new GrokVertexTextAdapter({
+		apiKey: "vertex",
+		baseURL: resolveGrokVertexBaseURL(config),
+		defaultHeaders: config.defaultHeaders,
+		fetch: async (input, init) => {
+			const token = await resolveGrokVertexAccessToken(config);
+			const headers = new Headers(init?.headers);
+			headers.set("Authorization", `Bearer ${token}`);
+			if (config.defaultHeaders) for (const [key, value] of Object.entries(config.defaultHeaders)) headers.set(key, value);
+			return fetch(input, {
+				...init,
+				headers
+			});
+		}
+	}, model);
+}
+/**
+* Creates a Grok summarize adapter that talks to xAI Grok on Vertex AI.
+*/
+function grokVertexSummarize(model, config = {}) {
+	return new ChatStreamSummarizeAdapter(grokVertexText(model, config), model, "grok");
+}
+//#endregion
+export { GROK_VERTEX_CHAT_MODELS, GrokVertexAuthError, grokVertexSummarize, grokVertexText, resolveGrokVertexAccessToken, resolveGrokVertexBaseURL, resolveGrokVertexLocation, resolveGrokVertexProject, toVertexGrokModelId };
+
+//# sourceMappingURL=index.js.map

package/dist/esm/vertex/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/vertex/index.ts"],"sourcesContent":["import { ChatStreamSummarizeAdapter } from '@tanstack/ai/adapters'\nimport { GrokTextAdapter } from '../adapters/text'\nimport {\n  resolveGrokVertexAccessToken,\n  resolveGrokVertexBaseURL,\n  toVertexGrokModelId,\n} from './auth'\nimport type { TextOptions } from '@tanstack/ai'\nimport type { InferTextProviderOptions } from '@tanstack/ai/adapters'\nimport type { ResponseCreateParams } from 'openai/resources/responses/responses'\nimport type {\n  GrokVertexChatModel,\n  ResolveInputModalities,\n  ResolveProviderOptions,\n} from '../model-meta'\nimport type { GrokVertexConfig } from './auth'\n\nexport {\n  GrokVertexAuthError,\n  resolveGrokVertexAccessToken,\n  resolveGrokVertexBaseURL,\n  resolveGrokVertexLocation,\n  resolveGrokVertexProject,\n  toVertexGrokModelId,\n  type GrokVertexConfig,\n  type VertexAuthClient,\n} from './auth'\nexport {\n  GROK_VERTEX_CHAT_MODELS,\n  type GrokVertexChatModel,\n} from '../model-meta'\n\nconst VERTEX_UNSUPPORTED_GROK_SERVER_TOOLS = new Set([\n  'web_search',\n  'x_search',\n  'file_search',\n  'mcp',\n])\n\nclass GrokVertexTextAdapter<\n  TModel extends GrokVertexChatModel,\n> extends GrokTextAdapter<\n  TModel,\n  ResolveProviderOptions<TModel>,\n  ResolveInputModalities<TModel>,\n  readonly []\n> {\n  protected override mapOptionsToRequest(\n    options: TextOptions<ResolveProviderOptions<TModel>>,\n  ): Omit<ResponseCreateParams, 'stream'> {\n    const request = super.mapOptionsToRequest(options)\n    const tools = request.tools\n    if (tools !== undefined) {\n      for (const tool of tools) {\n        if (tool === null || typeof tool !== 'object' || !('type' in tool)) {\n          continue\n        }\n        if (VERTEX_UNSUPPORTED_GROK_SERVER_TOOLS.has(String(tool.type))) {\n          throw new Error(\n            'Grok Vertex does not support xAI server tools (web_search, x_search, file_search, mcp). Use a function tool.',\n          )\n        }\n      }\n    }\n    return {\n      ...request,\n      model: toVertexGrokModelId(this.model),\n    }\n  }\n}\n\n/**\n * Creates a Grok chat adapter that talks to xAI Grok on Vertex AI.\n *\n * Install `google-auth-library` next to `@tanstack/ai-grok` for Application\n * Default Credentials. Or pass `authClient` or `getAccessToken`.\n */\nexport function grokVertexText<TModel extends GrokVertexChatModel>(\n  model: TModel,\n  config: GrokVertexConfig = {},\n): GrokTextAdapter<\n  TModel,\n  ResolveProviderOptions<TModel>,\n  ResolveInputModalities<TModel>,\n  readonly []\n> {\n  const baseURL = resolveGrokVertexBaseURL(config)\n\n  return new GrokVertexTextAdapter(\n    {\n      apiKey: 'vertex',\n      baseURL,\n      defaultHeaders: config.defaultHeaders,\n      fetch: async (input, init) => {\n        const token = await resolveGrokVertexAccessToken(config)\n        const headers = new Headers(init?.headers)\n        headers.set('Authorization', `Bearer ${token}`)\n        if (config.defaultHeaders) {\n          for (const [key, value] of Object.entries(config.defaultHeaders)) {\n            headers.set(key, value)\n          }\n        }\n        return fetch(input, { ...init, headers })\n      },\n    },\n    model,\n  )\n}\n\n/**\n * Creates a Grok summarize adapter that talks to xAI Grok on Vertex AI.\n */\nexport function grokVertexSummarize<TModel extends GrokVertexChatModel>(\n  model: TModel,\n  config: GrokVertexConfig = {},\n): ChatStreamSummarizeAdapter<\n  TModel,\n  InferTextProviderOptions<GrokTextAdapter<TModel>>\n> {\n  return new ChatStreamSummarizeAdapter(\n    grokVertexText(model, config),\n    model,\n    'grok',\n  )\n}\n"],"mappings":";;;;;AAgCA,IAAM,uDAAuC,IAAI,IAAI;CACnD;CACA;CACA;CACA;AACF,CAAC;AAED,IAAM,wBAAN,cAEU,gBAKR;CACA,oBACE,SACsC;EACtC,MAAM,UAAU,MAAM,oBAAoB,OAAO;EACjD,MAAM,QAAQ,QAAQ;EACtB,IAAI,UAAU,KAAA,GACZ,KAAK,MAAM,QAAQ,OAAO;GACxB,IAAI,SAAS,QAAQ,OAAO,SAAS,YAAY,EAAE,UAAU,OAC3D;GAEF,IAAI,qCAAqC,IAAI,OAAO,KAAK,IAAI,CAAC,GAC5D,MAAM,IAAI,MACR,8GACF;EAEJ;EAEF,OAAO;GACL,GAAG;GACH,OAAO,oBAAoB,KAAK,KAAK;EACvC;CACF;AACF;;;;;;;AAQA,SAAgB,eACd,OACA,SAA2B,CAAC,GAM5B;CAGA,OAAO,IAAI,sBACT;EACE,QAAQ;EACR,SALY,yBAAyB,MAKrC;EACA,gBAAgB,OAAO;EACvB,OAAO,OAAO,OAAO,SAAS;GAC5B,MAAM,QAAQ,MAAM,6BAA6B,MAAM;GACvD,MAAM,UAAU,IAAI,QAAQ,MAAM,OAAO;GACzC,QAAQ,IAAI,iBAAiB,UAAU,OAAO;GAC9C,IAAI,OAAO,gBACT,KAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,OAAO,cAAc,GAC7D,QAAQ,IAAI,KAAK,KAAK;GAG1B,OAAO,MAAM,OAAO;IAAE,GAAG;IAAM;GAAQ,CAAC;EAC1C;CACF,GACA,KACF;AACF;;;;AAKA,SAAgB,oBACd,OACA,SAA2B,CAAC,GAI5B;CACA,OAAO,IAAI,2BACT,eAAe,OAAO,MAAM,GAC5B,OACA,MACF;AACF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/ai-grok",
-  "version": "0.16.2",
+  "version": "0.17.0",
   "description": "xAI Grok adapter for TanStack AI chat, image generation, realtime, and structured outputs.",
   "author": "Tanner Linsley",
   "license": "MIT",
@@ -28,6 +28,10 @@
     "./tools": {
       "types": "./dist/esm/tools/index.d.ts",
       "import": "./dist/esm/tools/index.js"
+    },
+    "./vertex": {
+      "types": "./dist/esm/vertex/index.d.ts",
+      "import": "./dist/esm/vertex/index.js"
     }
   },
   "files": [
@@ -51,16 +55,23 @@
   "dependencies": {
     "openai": "^6.41.0",
     "@tanstack/ai-utils": "^0.4.0",
-    "@tanstack/openai-base": "^0.10.0"
+    "@tanstack/openai-base": "^0.10.2"
   },
   "devDependencies": {
     "@vitest/coverage-v8": "4.1.10",
+    "google-auth-library": "^10.5.0",
     "vite": "^8.2.1",
-    "@tanstack/ai": "0.47.1"
+    "@tanstack/ai": "0.47.3"
   },
   "peerDependencies": {
+    "google-auth-library": "^10.5.0",
     "zod": "^4.0.0",
-    "@tanstack/ai": "^0.47.1"
+    "@tanstack/ai": "^0.47.3"
+  },
+  "peerDependenciesMeta": {
+    "google-auth-library": {
+      "optional": true
+    }
   },
   "scripts": {
     "build": "vite build",

package/src/adapters/text.ts

@@ -5,6 +5,7 @@ import { convertToolsToProviderFormat } from '../tools'
 import type {
   GROK_CHAT_MODELS,
   GrokChatModelToolCapabilitiesByName,
+  GrokTextAdapterModel,
   ResolveInputModalities,
   ResolveProviderOptions,
 } from '../model-meta'
@@ -42,7 +43,7 @@ export type { ExternalTextProviderOptions as GrokTextProviderOptions } from '../
  * typing through the 5th generic of the base class.
  */
 export class GrokTextAdapter<
-  TModel extends (typeof GROK_CHAT_MODELS)[number],
+  TModel extends GrokTextAdapterModel,
   // Use `Record<string, any>` (not `unknown`) to match the OpenAI text
   // adapter: the resolved Grok provider options are a type-alias intersection
   // with no explicit index signature, which is assignable to

package/src/index.ts

@@ -94,6 +94,7 @@ export type {
   ResolveProviderOptions,
   ResolveInputModalities,
   GrokChatModel,
+  GrokVertexChatModel,
   GrokImageModel,
   GrokVideoModel,
   GrokTTSModel,
@@ -102,6 +103,7 @@ export type {
 } from './model-meta'
 export {
   GROK_CHAT_MODELS,
+  GROK_VERTEX_CHAT_MODELS,
   GROK_IMAGE_MODELS,
   GROK_VIDEO_MODELS,
   GROK_TTS_MODELS,

package/src/model-meta.ts

@@ -233,8 +233,54 @@ const GROK_BUILD_0_1 = {
   },
 } as const satisfies ModelMeta
 
+// Vertex Model Garden IDs. These are not the xAI API catalog.
+// Source: https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/partner-models/grok
+const GROK_4_20_REASONING = {
+  name: 'grok-4.20-reasoning',
+  context_window: 1_000_000,
+  supports: {
+    input: ['text', 'image'],
+    output: ['text'],
+    capabilities: ['reasoning', 'structured_outputs', 'tool_calling'],
+    tools: [] as const,
+  },
+} as const satisfies ModelMeta
+
+const GROK_4_20_NON_REASONING = {
+  name: 'grok-4.20-non-reasoning',
+  context_window: 1_000_000,
+  supports: {
+    input: ['text', 'image'],
+    output: ['text'],
+    capabilities: ['structured_outputs', 'tool_calling'],
+    tools: [] as const,
+  },
+} as const satisfies ModelMeta
+
+const GROK_4_1_FAST_REASONING = {
+  name: 'grok-4.1-fast-reasoning',
+  context_window: 2_000_000,
+  supports: {
+    input: ['text', 'image'],
+    output: ['text'],
+    capabilities: ['reasoning', 'structured_outputs', 'tool_calling'],
+    tools: [] as const,
+  },
+} as const satisfies ModelMeta
+
+const GROK_4_1_FAST_NON_REASONING = {
+  name: 'grok-4.1-fast-non-reasoning',
+  context_window: 2_000_000,
+  supports: {
+    input: ['text', 'image'],
+    output: ['text'],
+    capabilities: ['structured_outputs', 'tool_calling'],
+    tools: [] as const,
+  },
+} as const satisfies ModelMeta
+
 /**
- * Grok chat models supported by the Responses adapter.
+ * Grok chat models supported by the xAI Responses adapter.
  */
 export const GROK_CHAT_MODELS = [
   GROK_4_5.name,
@@ -243,6 +289,18 @@ export const GROK_CHAT_MODELS = [
   GROK_4_3.name,
 ] as const
 
+/**
+ * Grok chat models on Vertex AI / Gemini Enterprise Agent Platform.
+ * This list is the Google partner catalog, not the xAI API catalog.
+ */
+export const GROK_VERTEX_CHAT_MODELS = [
+  GROK_4_3.name,
+  GROK_4_20_REASONING.name,
+  GROK_4_20_NON_REASONING.name,
+  GROK_4_1_FAST_REASONING.name,
+  GROK_4_1_FAST_NON_REASONING.name,
+] as const
+
 /**
  * Grok Image Generation Models
  */
@@ -349,6 +407,8 @@ export const GROK_DEFAULT_REALTIME_MODEL: GrokRealtimeModel =
   'grok-voice-think-fast-2.0'
 
 export type GrokChatModel = (typeof GROK_CHAT_MODELS)[number]
+export type GrokVertexChatModel = (typeof GROK_VERTEX_CHAT_MODELS)[number]
+export type GrokTextAdapterModel = GrokChatModel | GrokVertexChatModel
 export type GrokImageModel = (typeof GROK_IMAGE_MODELS)[number]
 export type GrokVideoModel = (typeof GROK_VIDEO_MODELS)[number]
 export type GrokTTSModel = (typeof GROK_TTS_MODELS)[number]
@@ -364,6 +424,10 @@ export type GrokModelInputModalitiesByName = {
   [GROK_BUILD_0_1.name]: typeof GROK_BUILD_0_1.supports.input
   [GROK_4_5.name]: typeof GROK_4_5.supports.input
   [GROK_4_6.name]: typeof GROK_4_6.supports.input
+  [GROK_4_20_REASONING.name]: typeof GROK_4_20_REASONING.supports.input
+  [GROK_4_20_NON_REASONING.name]: typeof GROK_4_20_NON_REASONING.supports.input
+  [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
 }
 
 /**
@@ -374,6 +438,10 @@ export type GrokModelInputModalitiesByName = {
 export type GrokChatModelToolCapabilitiesByName = {
   [GROK_4_3.name]: typeof GROK_4_3.supports.tools
   [GROK_BUILD_0_1.name]: typeof GROK_BUILD_0_1.supports.tools
+  [GROK_4_20_REASONING.name]: typeof GROK_4_20_REASONING.supports.tools
+  [GROK_4_20_NON_REASONING.name]: typeof GROK_4_20_NON_REASONING.supports.tools
+  [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
 }
 
 export type GrokProviderOptions = GrokTextProviderOptions
@@ -384,6 +452,10 @@ export type GrokProviderOptions = GrokTextProviderOptions
 export type GrokChatModelProviderOptionsByName = {
   [GROK_4_3.name]: GrokProviderOptions
   [GROK_BUILD_0_1.name]: GrokBuildProviderOptions
+  [GROK_4_20_REASONING.name]: GrokProviderOptions
+  [GROK_4_20_NON_REASONING.name]: GrokProviderOptions
+  [GROK_4_1_FAST_REASONING.name]: GrokProviderOptions
+  [GROK_4_1_FAST_NON_REASONING.name]: GrokProviderOptions
 }
 
 // ===========================

package/src/vertex/auth.ts

@@ -0,0 +1,144 @@
+export class GrokVertexAuthError extends Error {
+  constructor(message: string, options?: ErrorOptions) {
+    super(message, options)
+    this.name = 'GrokVertexAuthError'
+  }
+}
+
+function isMissingGoogleAuthLibrary(error: unknown): boolean {
+  if (!(error instanceof Error) || !('code' in error)) {
+    return false
+  }
+  const code = error.code
+  if (code !== 'ERR_MODULE_NOT_FOUND' && code !== 'MODULE_NOT_FOUND') {
+    return false
+  }
+  return error.message.includes('google-auth-library')
+}
+
+export type VertexAuthClient = {
+  getRequestHeaders: (url?: string | URL) => Promise<Headers>
+}
+
+/**
+ * Public Vertex config for Grok. `project` and `location` match the Gemini
+ * Vertex factories so one auth object works for both.
+ *
+ * Default location is `global`. Grok on Vertex uses the OpenAI-compatible
+ * Responses endpoint under `/endpoints/openapi`.
+ */
+export type GrokVertexConfig = {
+  project?: string
+  location?: string
+  /** Override the OpenAI-compatible Vertex base URL. Used by e2e. */
+  baseURL?: string
+  getAccessToken?: () => Promise<string>
+  authClient?: VertexAuthClient
+  defaultHeaders?: Record<string, string>
+}
+
+function nonEmpty(value: string | undefined): string | undefined {
+  if (value === undefined || value.length === 0) {
+    return undefined
+  }
+  return value
+}
+
+function readEnv(name: string): string | undefined {
+  if (typeof process === 'undefined' || process.env === undefined) {
+    return undefined
+  }
+  return nonEmpty(process.env[name])
+}
+
+export function toVertexGrokModelId(model: string): string {
+  if (model.startsWith('xai/')) {
+    return model
+  }
+  return `xai/${model}`
+}
+
+export function resolveGrokVertexProject(
+  config: GrokVertexConfig,
+): string | undefined {
+  return (
+    nonEmpty(config.project) ??
+    readEnv('GOOGLE_CLOUD_PROJECT') ??
+    readEnv('GOOGLE_VERTEX_PROJECT')
+  )
+}
+
+export function resolveGrokVertexLocation(config: GrokVertexConfig): string {
+  return (
+    nonEmpty(config.location) ??
+    readEnv('GOOGLE_CLOUD_LOCATION') ??
+    readEnv('GOOGLE_VERTEX_LOCATION') ??
+    'global'
+  )
+}
+
+export function resolveGrokVertexBaseURL(config: GrokVertexConfig): string {
+  if (config.baseURL !== undefined && config.baseURL.length > 0) {
+    return config.baseURL.replace(/\/+$/, '')
+  }
+
+  const project = resolveGrokVertexProject(config)
+  if (project === undefined) {
+    throw new GrokVertexAuthError(
+      'Grok Vertex needs a project, or a baseURL. Pass project on the factory, or set GOOGLE_CLOUD_PROJECT or GOOGLE_VERTEX_PROJECT.',
+    )
+  }
+
+  const location = resolveGrokVertexLocation(config)
+  if (location === 'global') {
+    return `https://aiplatform.googleapis.com/v1/projects/${project}/locations/global/endpoints/openapi`
+  }
+  return `https://${location}-aiplatform.googleapis.com/v1/projects/${project}/locations/${location}/endpoints/openapi`
+}
+
+export async function resolveGrokVertexAccessToken(
+  config: GrokVertexConfig,
+): Promise<string> {
+  if (config.getAccessToken !== undefined) {
+    return config.getAccessToken()
+  }
+
+  if (config.authClient !== undefined) {
+    const headers = await config.authClient.getRequestHeaders()
+    const authorization = headers.get('Authorization')
+    if (authorization === null || !authorization.startsWith('Bearer ')) {
+      throw new GrokVertexAuthError(
+        'Grok Vertex authClient.getRequestHeaders() must return an Authorization Bearer token.',
+      )
+    }
+    return authorization.slice('Bearer '.length)
+  }
+
+  try {
+    const { GoogleAuth } = await import('google-auth-library')
+    const auth = new GoogleAuth({
+      scopes: ['https://www.googleapis.com/auth/cloud-platform'],
+    })
+    const client = await auth.getClient()
+    const token = await client.getAccessToken()
+    if (token.token === null || token.token === undefined) {
+      throw new GrokVertexAuthError(
+        'Grok Vertex could not load a Google access token from Application Default Credentials.',
+      )
+    }
+    return token.token
+  } catch (error) {
+    if (error instanceof GrokVertexAuthError) {
+      throw error
+    }
+    if (isMissingGoogleAuthLibrary(error)) {
+      throw new GrokVertexAuthError(
+        'Grok Vertex needs google-auth-library, or pass authClient or getAccessToken. Install google-auth-library next to @tanstack/ai-grok.',
+      )
+    }
+    throw new GrokVertexAuthError(
+      'Grok Vertex could not load a Google access token from Application Default Credentials.',
+      { cause: error },
+    )
+  }
+}

package/src/vertex/index.ts

@@ -0,0 +1,125 @@
+import { ChatStreamSummarizeAdapter } from '@tanstack/ai/adapters'
+import { GrokTextAdapter } from '../adapters/text'
+import {
+  resolveGrokVertexAccessToken,
+  resolveGrokVertexBaseURL,
+  toVertexGrokModelId,
+} from './auth'
+import type { TextOptions } from '@tanstack/ai'
+import type { InferTextProviderOptions } from '@tanstack/ai/adapters'
+import type { ResponseCreateParams } from 'openai/resources/responses/responses'
+import type {
+  GrokVertexChatModel,
+  ResolveInputModalities,
+  ResolveProviderOptions,
+} from '../model-meta'
+import type { GrokVertexConfig } from './auth'
+
+export {
+  GrokVertexAuthError,
+  resolveGrokVertexAccessToken,
+  resolveGrokVertexBaseURL,
+  resolveGrokVertexLocation,
+  resolveGrokVertexProject,
+  toVertexGrokModelId,
+  type GrokVertexConfig,
+  type VertexAuthClient,
+} from './auth'
+export {
+  GROK_VERTEX_CHAT_MODELS,
+  type GrokVertexChatModel,
+} from '../model-meta'
+
+const VERTEX_UNSUPPORTED_GROK_SERVER_TOOLS = new Set([
+  'web_search',
+  'x_search',
+  'file_search',
+  'mcp',
+])
+
+class GrokVertexTextAdapter<
+  TModel extends GrokVertexChatModel,
+> extends GrokTextAdapter<
+  TModel,
+  ResolveProviderOptions<TModel>,
+  ResolveInputModalities<TModel>,
+  readonly []
+> {
+  protected override mapOptionsToRequest(
+    options: TextOptions<ResolveProviderOptions<TModel>>,
+  ): Omit<ResponseCreateParams, 'stream'> {
+    const request = super.mapOptionsToRequest(options)
+    const tools = request.tools
+    if (tools !== undefined) {
+      for (const tool of tools) {
+        if (tool === null || typeof tool !== 'object' || !('type' in tool)) {
+          continue
+        }
+        if (VERTEX_UNSUPPORTED_GROK_SERVER_TOOLS.has(String(tool.type))) {
+          throw new Error(
+            'Grok Vertex does not support xAI server tools (web_search, x_search, file_search, mcp). Use a function tool.',
+          )
+        }
+      }
+    }
+    return {
+      ...request,
+      model: toVertexGrokModelId(this.model),
+    }
+  }
+}
+
+/**
+ * Creates a Grok chat adapter that talks to xAI Grok on Vertex AI.
+ *
+ * Install `google-auth-library` next to `@tanstack/ai-grok` for Application
+ * Default Credentials. Or pass `authClient` or `getAccessToken`.
+ */
+export function grokVertexText<TModel extends GrokVertexChatModel>(
+  model: TModel,
+  config: GrokVertexConfig = {},
+): GrokTextAdapter<
+  TModel,
+  ResolveProviderOptions<TModel>,
+  ResolveInputModalities<TModel>,
+  readonly []
+> {
+  const baseURL = resolveGrokVertexBaseURL(config)
+
+  return new GrokVertexTextAdapter(
+    {
+      apiKey: 'vertex',
+      baseURL,
+      defaultHeaders: config.defaultHeaders,
+      fetch: async (input, init) => {
+        const token = await resolveGrokVertexAccessToken(config)
+        const headers = new Headers(init?.headers)
+        headers.set('Authorization', `Bearer ${token}`)
+        if (config.defaultHeaders) {
+          for (const [key, value] of Object.entries(config.defaultHeaders)) {
+            headers.set(key, value)
+          }
+        }
+        return fetch(input, { ...init, headers })
+      },
+    },
+    model,
+  )
+}
+
+/**
+ * Creates a Grok summarize adapter that talks to xAI Grok on Vertex AI.
+ */
+export function grokVertexSummarize<TModel extends GrokVertexChatModel>(
+  model: TModel,
+  config: GrokVertexConfig = {},
+): ChatStreamSummarizeAdapter<
+  TModel,
+  InferTextProviderOptions<GrokTextAdapter<TModel>>
+> {
+  return new ChatStreamSummarizeAdapter(
+    grokVertexText(model, config),
+    model,
+    'grok',
+  )
+}