@tanstack/ai-grok 0.16.2 → 0.17.1

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/adapters/video.d.ts

@@ -47,7 +47,6 @@ export declare class GrokVideoAdapter<TModel extends GrokVideoModel> extends Bas
     readonly name: "grok";
     private readonly clientConfig;
     constructor(config: GrokVideoConfig, model: TModel);
-    private get fetch();
     private request;
     /**
      * Reads the error message out of an Imagine API error body

package/dist/esm/adapters/video.js

@@ -76,11 +76,8 @@ var GrokVideoAdapter = class extends BaseVideoAdapter {
 		super({}, model);
 		this.clientConfig = withGrokDefaults(config);
 	}
-	get fetch() {
-		return this.clientConfig.fetch ?? fetch;
-	}
 	async request(path, init) {
-		return await this.fetch(`${this.clientConfig.baseURL}${path}`, {
+		return await (this.clientConfig.fetch ?? globalThis.fetch.bind(globalThis))(`${this.clientConfig.baseURL}${path}`, {
 			...init,
 			headers: {
 				"Content-Type": "application/json",

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

@@ -1 +1 @@
-{"version":3,"file":"video.js","names":[],"sources":["../../../src/adapters/video.ts"],"sourcesContent":["import { resolveMediaPrompt } from '@tanstack/ai'\nimport { BaseVideoAdapter, snapToDurationOption } from '@tanstack/ai/adapters'\nimport { toRunErrorPayload } from '@tanstack/ai/adapter-internals'\nimport { getGrokApiKeyFromEnv, withGrokDefaults } from '../utils/client'\nimport {\n  GROK_VIDEO_MAX_REFERENCE_AUDIOS,\n  GROK_VIDEO_MAX_REFERENCE_IMAGES,\n  getGrokVideoDurationOptions,\n  isGrokVideoReferenceModel,\n  isGrokVideoSourceModel,\n  parseGrokVideoSize,\n  validateVideoSize,\n} from '../video/video-provider-options'\nimport type { DurationOptions } from '@tanstack/ai/adapters'\nimport type {\n  ImagePart,\n  MediaInputMetadata,\n  TokenUsage,\n  VideoGenerationOptions,\n  VideoJobResult,\n  VideoPart,\n  VideoStatusResult,\n  VideoUrlResult,\n} from '@tanstack/ai'\nimport type { GrokVideoModel } from '../model-meta'\nimport type {\n  GrokVideoModelDurationByName,\n  GrokVideoModelInputModalitiesByName,\n  GrokVideoModelProviderOptionsByName,\n  GrokVideoModelSizeByName,\n  GrokVideoRuntimeOptions,\n} from '../video/video-provider-options'\nimport type { GrokClientConfig } from '../utils/client'\n\n/**\n * Configuration for Grok video adapter.\n *\n * @experimental Video generation is an experimental feature and may change.\n */\nexport interface GrokVideoConfig extends GrokClientConfig {}\n\n/**\n * xAI bills video generation in \"USD ticks\": 10^10 ticks per US dollar\n * (e.g. one grok-imagine-video-1.5 second costs $0.08 = 800_000_000 ticks).\n */\nconst USD_TICKS_PER_DOLLAR = 10_000_000_000\n\n/** Response of the POST /v1/videos/{generations,edits,extensions} endpoints. */\ninterface GrokVideoCreateResponse {\n  request_id?: string\n}\n\n/** Response of GET /v1/videos/{request_id}. */\ninterface GrokVideoStatusResponse {\n  status?: string\n  progress?: number\n  model?: string\n  video?: {\n    url?: string\n    duration?: number\n  }\n  usage?: {\n    cost_in_usd_ticks?: number\n  }\n  error?: string\n}\n\n/**\n * Convert a TanStack image / video part to the URL string accepted by xAI's\n * Imagine video endpoints: public URLs pass through (fetched by xAI's\n * servers), data sources become base64 data URIs.\n */\nfunction mediaPartToUrl(\n  part: ImagePart<MediaInputMetadata> | VideoPart<MediaInputMetadata>,\n): string {\n  if (part.source.type === 'url') return part.source.value\n  return `data:${part.source.mimeType};base64,${part.source.value}`\n}\n\nfunction buildGrokVideoUsage(\n  response: GrokVideoStatusResponse,\n): TokenUsage | undefined {\n  const seconds = response.video?.duration\n  const ticks = response.usage?.cost_in_usd_ticks\n  if (seconds === undefined && ticks === undefined) return undefined\n  return {\n    promptTokens: 0,\n    completionTokens: 0,\n    totalTokens: 0,\n    ...(seconds !== undefined && {\n      billed: { quantity: seconds, unit: 'seconds' },\n      unitsBilled: seconds,\n    }),\n    ...(ticks !== undefined && { cost: ticks / USD_TICKS_PER_DOLLAR }),\n  }\n}\n\n/**\n * Grok Video Generation Adapter (xAI Imagine API)\n *\n * Tree-shakeable adapter for the grok-imagine video models using the\n * async jobs/polling architecture: create a generation request, poll it,\n * then read the completed video URL.\n *\n * Both models support text-to-video and image-to-video;\n * `grok-imagine-video-1.5` is xAI's documented default and adds native\n * 1080p generation plus reference-to-video inputs. Source-video edit\n * and extend are `grok-imagine-video` only.\n *\n * The Imagine video endpoints are not part of the OpenAI SDK surface (and\n * xAI rejects the SDK's multipart paths), so requests are plain JSON calls\n * issued with the configured `fetch` (or the global one).\n *\n * @experimental Video generation is an experimental feature and may change.\n *\n * Features:\n * - Async job-based video generation (1–15 second clips with audio)\n * - Aspect-ratio sizing via the \"aspectRatio_resolution\" size template\n *   (e.g. '16:9_720p'), consistent with the grok-imagine image models\n * - Image-to-video via an `image` prompt part (starting frame URL or data URI)\n * - Reference-to-video via image prompt parts with\n *   `metadata.role: 'reference'` or `'character'` (→ `reference_images`)\n *   and preset voices via `modelOptions.reference_audios`\n *   (grok-imagine-video-1.5 only)\n * - Video editing / extension on `grok-imagine-video` via a source\n *   `video` prompt part and `modelOptions.mode: 'edit' | 'extend'`\n *   (`/v1/videos/edits` / `/v1/videos/extensions`; in extend mode\n *   `duration` is the added tail)\n * - Usage reporting: billed seconds (`usage.billed`) and exact cost\n */\nexport class GrokVideoAdapter<\n  TModel extends GrokVideoModel,\n> extends BaseVideoAdapter<\n  TModel,\n  GrokVideoModelProviderOptionsByName[TModel],\n  GrokVideoModelProviderOptionsByName,\n  GrokVideoModelSizeByName,\n  GrokVideoModelInputModalitiesByName,\n  GrokVideoModelDurationByName\n> {\n  readonly name = 'grok' as const\n\n  private readonly clientConfig: GrokVideoConfig\n\n  constructor(config: GrokVideoConfig, model: TModel) {\n    super({}, model)\n    this.clientConfig = withGrokDefaults(config)\n  }\n\n  private get fetch(): (\n    input: string,\n    init?: RequestInit,\n  ) => Promise<Response> {\n    return this.clientConfig.fetch ?? fetch\n  }\n\n  private async request(\n    path: string,\n    init?: Omit<RequestInit, 'headers'>,\n  ): Promise<Response> {\n    return await this.fetch(`${this.clientConfig.baseURL}${path}`, {\n      ...init,\n      headers: {\n        'Content-Type': 'application/json',\n        Authorization: `Bearer ${this.clientConfig.apiKey}`,\n      },\n    })\n  }\n\n  /**\n   * Reads the error message out of an Imagine API error body\n   * (`{\"code\": \"...\", \"error\": \"...\"}`), falling back to the raw text.\n   */\n  private async errorMessage(response: Response): Promise<string> {\n    const body = await response.text()\n    try {\n      const parsed: unknown = JSON.parse(body)\n      if (\n        typeof parsed === 'object' &&\n        parsed !== null &&\n        'error' in parsed &&\n        typeof parsed.error === 'string'\n      ) {\n        return parsed.error\n      }\n    } catch {\n      // not JSON — fall through to the raw body\n    }\n    return body\n  }\n\n  async createVideoJob(\n    options: VideoGenerationOptions<\n      GrokVideoModelProviderOptionsByName[TModel],\n      GrokVideoModelSizeByName[TModel],\n      GrokVideoModelDurationByName[TModel]\n    >,\n  ): Promise<VideoJobResult> {\n    const { model, size, modelOptions, logger } = options\n\n    // `mode` is a routing hint for this adapter, not an API field — strip it\n    // before the remaining options are spread onto the request body. The\n    // per-model map narrows what callers can pass, but modelOptions often\n    // arrives as deserialized JSON, so the adapter handles the widest option\n    // surface (the 1.5 shape) uniformly and gates by model at runtime.\n    const { mode, ...wireOptions } = (modelOptions ??\n      {}) as GrokVideoRuntimeOptions\n\n    // `mode` is typed 'edit' | 'extend' but reaches us untrusted from JSON\n    // callers. An unrecognised value must not fall through to the\n    // generations endpoint with a source-video body — that would silently\n    // run (and bill) a generation the caller never asked for.\n    if (mode !== undefined && mode !== 'edit' && mode !== 'extend') {\n      throw new Error(\n        `${this.name}: unknown modelOptions.mode '${String(mode)}'. ` +\n          `Expected 'edit' or 'extend'.`,\n      )\n    }\n\n    // The interleaved prompt decomposes into verbatim text plus typed media\n    // buckets. Reference audio is voice-id based (not an audio file), so\n    // audio prompt parts have no request field to land in.\n    const resolved = resolveMediaPrompt(options.prompt)\n    if (resolved.audios.length > 0) {\n      throw new Error(\n        `${this.name}.createVideoJob does not support audio prompt parts (model: ${model}). ` +\n          `To reference a preset voice, pass modelOptions.reference_audios ` +\n          `(e.g. [{ voice_id: 'eve' }]).`,\n      )\n    }\n\n    // A video prompt part is the source clip for edit / extension mode.\n    // Those endpoints are grok-imagine-video only — 1.5 has no video input.\n    if (\n      !isGrokVideoSourceModel(model) &&\n      (mode !== undefined || resolved.videos.length > 0)\n    ) {\n      throw new Error(\n        `${this.name}: ${model} does not support video editing or extension. ` +\n          `Use 'grok-imagine-video' for /v1/videos/edits and /v1/videos/extensions.`,\n      )\n    }\n\n    // The mode must be chosen explicitly because the two endpoints have\n    // different semantics (edit rewrites the clip, extend appends\n    // `duration` seconds).\n    if (resolved.videos.length > 1) {\n      throw new Error(\n        `${this.name}: ${model} accepts at most one source video; received ${resolved.videos.length}.`,\n      )\n    }\n    const [sourceVideo] = resolved.videos\n    if (sourceVideo && mode === undefined) {\n      throw new Error(\n        `${this.name}: a video prompt part needs modelOptions.mode set to ` +\n          `'edit' (rewrite the clip) or 'extend' (append to it).`,\n      )\n    }\n    if (!sourceVideo && mode !== undefined) {\n      throw new Error(\n        `${this.name}: modelOptions.mode '${mode}' requires a video prompt ` +\n          `part carrying the source clip.`,\n      )\n    }\n\n    if (mode !== undefined && sourceVideo) {\n      return await this.createSourceVideoJob({\n        model,\n        mode,\n        sourceVideo,\n        resolved,\n        wireOptions,\n        size,\n        genericDuration: options.duration,\n        logger,\n      })\n    }\n\n    validateVideoSize(model, size)\n\n    // Pull the specially-handled keys out of the wire options: `duration`\n    // is folded into the snapped value below, and the reference fields are\n    // re-added explicitly so a JSON-serialized `null` or empty array reads\n    // as \"unset\" instead of leaking onto the wire.\n    const {\n      duration: rawOptionDuration,\n      reference_images: explicitReferenceImages,\n      reference_audios: referenceAudios,\n      ...generationOptions\n    } = wireOptions\n\n    // Coerce the requested duration into the model's valid range (1–15s,\n    // integer) instead of rejecting it — `snapDuration` clamps and rounds.\n    // modelOptions wins over the generic `duration`, mirroring the size\n    // precedence below.\n    const rawDuration = rawOptionDuration ?? options.duration\n    const duration =\n      rawDuration != null ? this.snapDuration(rawDuration) : undefined\n\n    // Image parts split by role: un-roled / 'start_frame' images become the\n    // starting frame (image-to-video); 'reference' / 'character' images\n    // become reference_images (reference-to-video). The Imagine API has no\n    // mask / control / end-frame inputs. Unknown role strings (possible via\n    // JSON callers) throw rather than silently dropping the part.\n    const startFrames: Array<ImagePart<MediaInputMetadata>> = []\n    const referenceImages: Array<{ url: string }> = []\n    for (const part of resolved.images) {\n      const role = part.metadata?.role\n      switch (role) {\n        case 'mask':\n        case 'control':\n        case 'end_frame':\n          throw new Error(\n            `${this.name}: the Imagine video API has no '${role}' image ` +\n              `input on model ${model}. Use an un-roled / 'start_frame' ` +\n              `image as the starting frame, or 'reference' images.`,\n          )\n        case 'reference':\n        case 'character':\n          referenceImages.push({ url: mediaPartToUrl(part) })\n          break\n        case 'start_frame':\n        case undefined:\n          startFrames.push(part)\n          break\n        default:\n          throw new Error(\n            `${this.name}: unknown image metadata.role '${String(role)}'. ` +\n              `Expected 'start_frame', 'reference', or 'character'.`,\n          )\n      }\n    }\n    if (startFrames.length > 1) {\n      throw new Error(\n        `${this.name}: ${model} accepts at most one starting-frame image; received ${startFrames.length}. ` +\n          `Use metadata.role: 'reference' for reference-to-video inputs.`,\n      )\n    }\n    // Explicit modelOptions.reference_images replaces the part-derived list\n    // (an explicit empty array means \"none\").\n    const finalReferenceImages =\n      explicitReferenceImages ??\n      (referenceImages.length > 0 ? referenceImages : undefined)\n    const referenceImageCount = finalReferenceImages?.length ?? 0\n    const referenceAudioCount = referenceAudios?.length ?? 0\n    const hasReference = referenceImageCount > 0 || referenceAudioCount > 0\n\n    // Reference inputs are a grok-imagine-video-1.5 feature. The per-model\n    // options map already hides the fields from other models at compile\n    // time; this runtime gate covers prompt-part roles and untyped callers.\n    if (!isGrokVideoReferenceModel(model) && hasReference) {\n      throw new Error(\n        `${this.name}: ${model} does not support reference-to-video inputs. ` +\n          `Use 'grok-imagine-video-1.5' for reference_images / reference_audios.`,\n      )\n    }\n    if (referenceAudioCount > GROK_VIDEO_MAX_REFERENCE_AUDIOS) {\n      throw new Error(\n        `${this.name}: ${model} accepts at most ${GROK_VIDEO_MAX_REFERENCE_AUDIOS} reference voices; received ${referenceAudioCount}.`,\n      )\n    }\n    if (referenceImageCount > GROK_VIDEO_MAX_REFERENCE_IMAGES) {\n      throw new Error(\n        `${this.name}: ${model} accepts at most ${GROK_VIDEO_MAX_REFERENCE_IMAGES} reference images; received ${referenceImageCount}.`,\n      )\n    }\n\n    // Image-to-video: the single image prompt part becomes the starting frame\n    // and the prompt text describes the desired motion. URL sources are\n    // fetched by xAI's servers; data sources are sent as base64 data URIs.\n    const [startFrame] = startFrames\n\n    // xAI rejects `image` + `reference_images` / `reference_audios` as a\n    // 400: only one of image-to-video or reference-to-video can be active.\n    if (startFrame && hasReference) {\n      throw new Error(\n        `${this.name}: image-to-video and reference-to-video cannot be combined. ` +\n          `Use a starting-frame image, or reference images / voices, not both.`,\n      )\n    }\n\n    // The generic `size` option carries an \"aspectRatio_resolution\" template\n    // (e.g. '16:9_720p') and maps to the Imagine API's `aspect_ratio` /\n    // `resolution` parameters; explicit modelOptions win over the template\n    // (including `reference_images`, which replaces the part-derived list).\n    const parsedSize = size !== undefined ? parseGrokVideoSize(size) : undefined\n    const resolvedResolution =\n      generationOptions.resolution ?? parsedSize?.resolution\n    if (hasReference && resolvedResolution === '1080p') {\n      throw new Error(\n        `${this.name}: reference-to-video is capped at 720p on ${model}.`,\n      )\n    }\n    const request = {\n      model,\n      prompt: resolved.text,\n      ...(startFrame && { image: { url: mediaPartToUrl(startFrame) } }),\n      ...(referenceImageCount > 0 && {\n        reference_images: finalReferenceImages,\n      }),\n      ...(referenceAudioCount > 0 && {\n        reference_audios: referenceAudios,\n      }),\n      ...(parsedSize && {\n        aspect_ratio: parsedSize.aspectRatio,\n        ...(parsedSize.resolution !== undefined && {\n          resolution: parsedSize.resolution,\n        }),\n      }),\n      // The remaining options spread after the size template so explicit\n      // aspect_ratio / resolution win over it; duration and the reference\n      // fields were destructured out above and re-added normalized.\n      ...generationOptions,\n      ...(duration !== undefined && { duration }),\n    }\n\n    return await this.postVideoJob('/videos/generations', request, {\n      model,\n      logger,\n      logLine: `activity=video.create provider=${this.name} model=${model} mode=generate size=${size ?? 'default'} duration=${duration ?? 'default'}`,\n    })\n  }\n\n  /**\n   * Build and post an edit / extension request. Both endpoints take only\n   * `model`, `prompt`, and the source `video` (plus `duration` — the length\n   * of the added tail — for extensions): output geometry is inherited from\n   * the source clip, capped at 720p, and edit outputs also inherit the\n   * source length. Rather than sending fields the API documents as ignored,\n   * the inapplicable options are rejected with actionable errors.\n   */\n  private async createSourceVideoJob(args: {\n    model: string\n    mode: 'edit' | 'extend'\n    sourceVideo: VideoPart<MediaInputMetadata>\n    resolved: ReturnType<typeof resolveMediaPrompt>\n    wireOptions: Omit<GrokVideoRuntimeOptions, 'mode'>\n    size: string | undefined\n    genericDuration: number | undefined\n    logger: VideoGenerationOptions<GrokVideoRuntimeOptions>['logger']\n  }): Promise<VideoJobResult> {\n    const { model, mode, sourceVideo, resolved, wireOptions, logger } = args\n    const endpoint = mode === 'edit' ? '/videos/edits' : '/videos/extensions'\n\n    if (resolved.images.length > 0) {\n      throw new Error(\n        `${this.name}: '${mode}' mode takes only the source video — image ` +\n          `prompt parts are not supported by ${endpoint}.`,\n      )\n    }\n\n    // Pull every generation-only key out of the wire options so nothing can\n    // leak into the edit/extend body via the spread below. JSON-serialized\n    // `null` values (a common \"unset\" encoding) are treated as absent;\n    // actual values are rejected with actionable errors.\n    const {\n      aspect_ratio: aspectRatio,\n      resolution,\n      duration: modeDuration,\n      reference_images: referenceImagesOption,\n      reference_audios: referenceAudiosOption,\n      ...passthrough\n    } = wireOptions\n    if (\n      (referenceImagesOption?.length ?? 0) > 0 ||\n      (referenceAudiosOption?.length ?? 0) > 0\n    ) {\n      throw new Error(\n        `${this.name}: reference inputs are only supported by video ` +\n          `generation, not '${mode}' mode.`,\n      )\n    }\n    if (args.size !== undefined || aspectRatio != null || resolution != null) {\n      throw new Error(\n        `${this.name}: '${mode}' mode does not accept size / aspect_ratio / ` +\n          `resolution — the output inherits the source clip's geometry ` +\n          `(capped at 720p).`,\n      )\n    }\n    const rawDuration = modeDuration ?? args.genericDuration\n    if (mode === 'edit' && rawDuration != null) {\n      throw new Error(\n        `${this.name}: 'edit' mode does not accept a duration — the output ` +\n          `inherits the source clip's length. Use mode 'extend' to append ` +\n          `seconds to the clip.`,\n      )\n    }\n    // Extend: the snapped duration is the added-tail length (1–15s).\n    const duration =\n      rawDuration != null ? this.snapDuration(rawDuration) : undefined\n\n    const request = {\n      model,\n      prompt: resolved.text,\n      video: { url: mediaPartToUrl(sourceVideo) },\n      ...passthrough,\n      ...(duration !== undefined && { duration }),\n    }\n\n    return await this.postVideoJob(endpoint, request, {\n      model,\n      logger,\n      logLine: `activity=video.create provider=${this.name} model=${model} mode=${mode} duration=${duration ?? 'default'}`,\n    })\n  }\n\n  /**\n   * POST a create-job request body to one of the Imagine video endpoints\n   * (`/videos/generations`, `/videos/edits`, `/videos/extensions`) and read\n   * the `request_id` out of the shared response shape.\n   */\n  private async postVideoJob(\n    endpoint: string,\n    request: Record<string, unknown>,\n    context: {\n      model: string\n      logger: VideoGenerationOptions<GrokVideoRuntimeOptions>['logger']\n      logLine: string\n    },\n  ): Promise<VideoJobResult> {\n    const { model, logger, logLine } = context\n    try {\n      logger.request(logLine, { provider: this.name, model })\n\n      const response = await this.request(endpoint, {\n        method: 'POST',\n        body: JSON.stringify(request),\n      })\n      if (!response.ok) {\n        throw new Error(\n          `grok: ${endpoint} request failed (${response.status} ${response.statusText}): ${await this.errorMessage(response)}`,\n        )\n      }\n\n      const result = (await response.json()) as GrokVideoCreateResponse\n      if (!result.request_id) {\n        throw new Error(`grok: ${endpoint} response contained no request_id`)\n      }\n      return { jobId: result.request_id, model }\n    } catch (error: unknown) {\n      logger.errors(`${this.name}.createVideoJob fatal`, {\n        error: toRunErrorPayload(error, `${this.name}.createVideoJob failed`),\n        source: `${this.name}.createVideoJob`,\n      })\n      throw error\n    }\n  }\n\n  private async retrieveJob(jobId: string): Promise<GrokVideoStatusResponse> {\n    const response = await this.request(`/videos/${jobId}`)\n    if (!response.ok) {\n      const error = new Error(\n        `grok: video status request failed (${response.status} ${response.statusText}): ${await this.errorMessage(response)}`,\n      )\n      ;(error as { status?: number }).status = response.status\n      throw error\n    }\n    return (await response.json()) as GrokVideoStatusResponse\n  }\n\n  async getVideoStatus(jobId: string): Promise<VideoStatusResult> {\n    let response: GrokVideoStatusResponse\n    try {\n      response = await this.retrieveJob(jobId)\n    } catch (error) {\n      if ((error as { status?: number }).status === 404) {\n        return { jobId, status: 'failed', error: 'Job not found' }\n      }\n      throw error\n    }\n\n    return {\n      jobId,\n      status: this.mapStatus(response.status),\n      ...(response.progress !== undefined && { progress: response.progress }),\n      ...(response.error !== undefined && { error: response.error }),\n    }\n  }\n\n  async getVideoUrl(jobId: string): Promise<VideoUrlResult> {\n    let response: GrokVideoStatusResponse\n    try {\n      response = await this.retrieveJob(jobId)\n    } catch (error) {\n      if ((error as { status?: number }).status === 404) {\n        throw new Error(`Video job not found: ${jobId}`)\n      }\n      throw error\n    }\n\n    const status = this.mapStatus(response.status)\n    if (status === 'failed') {\n      throw new Error(\n        `Video generation failed${response.error ? `: ${response.error}` : ''}. Job ID: ${jobId}`,\n      )\n    }\n    const url = response.video?.url\n    if (!url) {\n      throw new Error(\n        `Video is not ready for download. Check status first. Job ID: ${jobId}`,\n      )\n    }\n\n    const usage = buildGrokVideoUsage(response)\n    return {\n      jobId,\n      url,\n      ...(usage && { usage }),\n    }\n  }\n\n  /**\n   * Maps Imagine API job statuses onto the generic video status set. The\n   * API reports 'pending' while queued/generating (with a numeric\n   * `progress`), then a terminal 'done' / 'failed' / 'expired'.\n   */\n  protected mapStatus(\n    apiStatus: string | undefined,\n  ): 'pending' | 'processing' | 'completed' | 'failed' {\n    switch (apiStatus) {\n      case 'pending':\n      case 'queued':\n        return 'pending'\n      case 'done':\n      case 'completed':\n      case 'succeeded':\n        return 'completed'\n      case 'failed':\n      case 'expired':\n      case 'error':\n      case 'cancelled':\n        return 'failed'\n      case undefined:\n      default:\n        return 'processing'\n    }\n  }\n\n  /**\n   * Both grok-imagine video models accept a continuous 1–15 integer-second\n   * range. Consumers can use this to render UI without provider knowledge.\n   */\n  override availableDurations(): DurationOptions<\n    GrokVideoModelDurationByName[TModel]\n  > {\n    return getGrokVideoDurationOptions(this.model)\n  }\n\n  /**\n   * Coerce a raw seconds value to the closest valid duration (clamped to\n   * [1, 15] and rounded to whole seconds).\n   */\n  override snapDuration(\n    seconds: number,\n  ): GrokVideoModelDurationByName[TModel] | undefined {\n    return snapToDurationOption(seconds, this.availableDurations())\n  }\n}\n\n/**\n * Creates a Grok video adapter with an explicit API key.\n * Type resolution happens here at the call site.\n *\n * @experimental Video generation is an experimental feature and may change.\n *\n * @param model - The model name (e.g., 'grok-imagine-video-1.5')\n * @param apiKey - Your xAI API key\n * @param config - Optional additional configuration\n * @returns Configured Grok video adapter instance with resolved types\n *\n * @example\n * ```typescript\n * const adapter = createGrokVideo('grok-imagine-video-1.5', 'xai-...');\n *\n * const { jobId } = await generateVideo({\n *   adapter,\n *   prompt: 'A beautiful sunset over the ocean',\n *   size: '16:9_720p',\n *   duration: 5\n * });\n * ```\n */\nexport function createGrokVideo<TModel extends GrokVideoModel>(\n  model: TModel,\n  apiKey: string,\n  config?: Omit<GrokVideoConfig, 'apiKey'>,\n): GrokVideoAdapter<TModel> {\n  return new GrokVideoAdapter({ apiKey, ...config }, model)\n}\n\n/**\n * Creates a Grok video 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 * @experimental Video generation is an experimental feature and may change.\n *\n * @param model - The model name (e.g., 'grok-imagine-video-1.5')\n * @param config - Optional configuration (excluding apiKey which is auto-detected)\n * @returns Configured Grok video 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 = grokVideo('grok-imagine-video-1.5');\n *\n * // Image-to-video: an optional image prompt part is the starting frame.\n * const { jobId } = await generateVideo({\n *   adapter,\n *   prompt: [\n *     { type: 'text', content: 'Make the cat start playing the piano' },\n *     { type: 'image', source: { type: 'url', value: 'https://example.com/cat.png' } },\n *   ],\n * });\n *\n * // Poll for status\n * const status = await getVideoJobStatus({ adapter, jobId });\n * ```\n */\nexport function grokVideo<TModel extends GrokVideoModel>(\n  model: TModel,\n  config?: Omit<GrokVideoConfig, 'apiKey'>,\n): GrokVideoAdapter<TModel> {\n  const apiKey = getGrokApiKeyFromEnv()\n  return createGrokVideo(model, apiKey, config)\n}\n"],"mappings":"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"}
+{"version":3,"file":"video.js","names":[],"sources":["../../../src/adapters/video.ts"],"sourcesContent":["import { resolveMediaPrompt } from '@tanstack/ai'\nimport { BaseVideoAdapter, snapToDurationOption } from '@tanstack/ai/adapters'\nimport { toRunErrorPayload } from '@tanstack/ai/adapter-internals'\nimport { getGrokApiKeyFromEnv, withGrokDefaults } from '../utils/client'\nimport {\n  GROK_VIDEO_MAX_REFERENCE_AUDIOS,\n  GROK_VIDEO_MAX_REFERENCE_IMAGES,\n  getGrokVideoDurationOptions,\n  isGrokVideoReferenceModel,\n  isGrokVideoSourceModel,\n  parseGrokVideoSize,\n  validateVideoSize,\n} from '../video/video-provider-options'\nimport type { DurationOptions } from '@tanstack/ai/adapters'\nimport type {\n  ImagePart,\n  MediaInputMetadata,\n  TokenUsage,\n  VideoGenerationOptions,\n  VideoJobResult,\n  VideoPart,\n  VideoStatusResult,\n  VideoUrlResult,\n} from '@tanstack/ai'\nimport type { GrokVideoModel } from '../model-meta'\nimport type {\n  GrokVideoModelDurationByName,\n  GrokVideoModelInputModalitiesByName,\n  GrokVideoModelProviderOptionsByName,\n  GrokVideoModelSizeByName,\n  GrokVideoRuntimeOptions,\n} from '../video/video-provider-options'\nimport type { GrokClientConfig } from '../utils/client'\n\n/**\n * Configuration for Grok video adapter.\n *\n * @experimental Video generation is an experimental feature and may change.\n */\nexport interface GrokVideoConfig extends GrokClientConfig {}\n\n/**\n * xAI bills video generation in \"USD ticks\": 10^10 ticks per US dollar\n * (e.g. one grok-imagine-video-1.5 second costs $0.08 = 800_000_000 ticks).\n */\nconst USD_TICKS_PER_DOLLAR = 10_000_000_000\n\n/** Response of the POST /v1/videos/{generations,edits,extensions} endpoints. */\ninterface GrokVideoCreateResponse {\n  request_id?: string\n}\n\n/** Response of GET /v1/videos/{request_id}. */\ninterface GrokVideoStatusResponse {\n  status?: string\n  progress?: number\n  model?: string\n  video?: {\n    url?: string\n    duration?: number\n  }\n  usage?: {\n    cost_in_usd_ticks?: number\n  }\n  error?: string\n}\n\n/**\n * Convert a TanStack image / video part to the URL string accepted by xAI's\n * Imagine video endpoints: public URLs pass through (fetched by xAI's\n * servers), data sources become base64 data URIs.\n */\nfunction mediaPartToUrl(\n  part: ImagePart<MediaInputMetadata> | VideoPart<MediaInputMetadata>,\n): string {\n  if (part.source.type === 'url') return part.source.value\n  return `data:${part.source.mimeType};base64,${part.source.value}`\n}\n\nfunction buildGrokVideoUsage(\n  response: GrokVideoStatusResponse,\n): TokenUsage | undefined {\n  const seconds = response.video?.duration\n  const ticks = response.usage?.cost_in_usd_ticks\n  if (seconds === undefined && ticks === undefined) return undefined\n  return {\n    promptTokens: 0,\n    completionTokens: 0,\n    totalTokens: 0,\n    ...(seconds !== undefined && {\n      billed: { quantity: seconds, unit: 'seconds' },\n      unitsBilled: seconds,\n    }),\n    ...(ticks !== undefined && { cost: ticks / USD_TICKS_PER_DOLLAR }),\n  }\n}\n\n/**\n * Grok Video Generation Adapter (xAI Imagine API)\n *\n * Tree-shakeable adapter for the grok-imagine video models using the\n * async jobs/polling architecture: create a generation request, poll it,\n * then read the completed video URL.\n *\n * Both models support text-to-video and image-to-video;\n * `grok-imagine-video-1.5` is xAI's documented default and adds native\n * 1080p generation plus reference-to-video inputs. Source-video edit\n * and extend are `grok-imagine-video` only.\n *\n * The Imagine video endpoints are not part of the OpenAI SDK surface (and\n * xAI rejects the SDK's multipart paths), so requests are plain JSON calls\n * issued with the configured `fetch` (or the global one).\n *\n * @experimental Video generation is an experimental feature and may change.\n *\n * Features:\n * - Async job-based video generation (1–15 second clips with audio)\n * - Aspect-ratio sizing via the \"aspectRatio_resolution\" size template\n *   (e.g. '16:9_720p'), consistent with the grok-imagine image models\n * - Image-to-video via an `image` prompt part (starting frame URL or data URI)\n * - Reference-to-video via image prompt parts with\n *   `metadata.role: 'reference'` or `'character'` (→ `reference_images`)\n *   and preset voices via `modelOptions.reference_audios`\n *   (grok-imagine-video-1.5 only)\n * - Video editing / extension on `grok-imagine-video` via a source\n *   `video` prompt part and `modelOptions.mode: 'edit' | 'extend'`\n *   (`/v1/videos/edits` / `/v1/videos/extensions`; in extend mode\n *   `duration` is the added tail)\n * - Usage reporting: billed seconds (`usage.billed`) and exact cost\n */\nexport class GrokVideoAdapter<\n  TModel extends GrokVideoModel,\n> extends BaseVideoAdapter<\n  TModel,\n  GrokVideoModelProviderOptionsByName[TModel],\n  GrokVideoModelProviderOptionsByName,\n  GrokVideoModelSizeByName,\n  GrokVideoModelInputModalitiesByName,\n  GrokVideoModelDurationByName\n> {\n  readonly name = 'grok' as const\n\n  private readonly clientConfig: GrokVideoConfig\n\n  constructor(config: GrokVideoConfig, model: TModel) {\n    super({}, model)\n    this.clientConfig = withGrokDefaults(config)\n  }\n\n  private async request(\n    path: string,\n    init?: Omit<RequestInit, 'headers'>,\n  ): Promise<Response> {\n    // workerd's fetch must be invoked with this === globalThis\n    const fetchFn = this.clientConfig.fetch ?? globalThis.fetch.bind(globalThis)\n    return await fetchFn(`${this.clientConfig.baseURL}${path}`, {\n      ...init,\n      headers: {\n        'Content-Type': 'application/json',\n        Authorization: `Bearer ${this.clientConfig.apiKey}`,\n      },\n    })\n  }\n\n  /**\n   * Reads the error message out of an Imagine API error body\n   * (`{\"code\": \"...\", \"error\": \"...\"}`), falling back to the raw text.\n   */\n  private async errorMessage(response: Response): Promise<string> {\n    const body = await response.text()\n    try {\n      const parsed: unknown = JSON.parse(body)\n      if (\n        typeof parsed === 'object' &&\n        parsed !== null &&\n        'error' in parsed &&\n        typeof parsed.error === 'string'\n      ) {\n        return parsed.error\n      }\n    } catch {\n      // not JSON — fall through to the raw body\n    }\n    return body\n  }\n\n  async createVideoJob(\n    options: VideoGenerationOptions<\n      GrokVideoModelProviderOptionsByName[TModel],\n      GrokVideoModelSizeByName[TModel],\n      GrokVideoModelDurationByName[TModel]\n    >,\n  ): Promise<VideoJobResult> {\n    const { model, size, modelOptions, logger } = options\n\n    // `mode` is a routing hint for this adapter, not an API field — strip it\n    // before the remaining options are spread onto the request body. The\n    // per-model map narrows what callers can pass, but modelOptions often\n    // arrives as deserialized JSON, so the adapter handles the widest option\n    // surface (the 1.5 shape) uniformly and gates by model at runtime.\n    const { mode, ...wireOptions } = (modelOptions ??\n      {}) as GrokVideoRuntimeOptions\n\n    // `mode` is typed 'edit' | 'extend' but reaches us untrusted from JSON\n    // callers. An unrecognised value must not fall through to the\n    // generations endpoint with a source-video body — that would silently\n    // run (and bill) a generation the caller never asked for.\n    if (mode !== undefined && mode !== 'edit' && mode !== 'extend') {\n      throw new Error(\n        `${this.name}: unknown modelOptions.mode '${String(mode)}'. ` +\n          `Expected 'edit' or 'extend'.`,\n      )\n    }\n\n    // The interleaved prompt decomposes into verbatim text plus typed media\n    // buckets. Reference audio is voice-id based (not an audio file), so\n    // audio prompt parts have no request field to land in.\n    const resolved = resolveMediaPrompt(options.prompt)\n    if (resolved.audios.length > 0) {\n      throw new Error(\n        `${this.name}.createVideoJob does not support audio prompt parts (model: ${model}). ` +\n          `To reference a preset voice, pass modelOptions.reference_audios ` +\n          `(e.g. [{ voice_id: 'eve' }]).`,\n      )\n    }\n\n    // A video prompt part is the source clip for edit / extension mode.\n    // Those endpoints are grok-imagine-video only — 1.5 has no video input.\n    if (\n      !isGrokVideoSourceModel(model) &&\n      (mode !== undefined || resolved.videos.length > 0)\n    ) {\n      throw new Error(\n        `${this.name}: ${model} does not support video editing or extension. ` +\n          `Use 'grok-imagine-video' for /v1/videos/edits and /v1/videos/extensions.`,\n      )\n    }\n\n    // The mode must be chosen explicitly because the two endpoints have\n    // different semantics (edit rewrites the clip, extend appends\n    // `duration` seconds).\n    if (resolved.videos.length > 1) {\n      throw new Error(\n        `${this.name}: ${model} accepts at most one source video; received ${resolved.videos.length}.`,\n      )\n    }\n    const [sourceVideo] = resolved.videos\n    if (sourceVideo && mode === undefined) {\n      throw new Error(\n        `${this.name}: a video prompt part needs modelOptions.mode set to ` +\n          `'edit' (rewrite the clip) or 'extend' (append to it).`,\n      )\n    }\n    if (!sourceVideo && mode !== undefined) {\n      throw new Error(\n        `${this.name}: modelOptions.mode '${mode}' requires a video prompt ` +\n          `part carrying the source clip.`,\n      )\n    }\n\n    if (mode !== undefined && sourceVideo) {\n      return await this.createSourceVideoJob({\n        model,\n        mode,\n        sourceVideo,\n        resolved,\n        wireOptions,\n        size,\n        genericDuration: options.duration,\n        logger,\n      })\n    }\n\n    validateVideoSize(model, size)\n\n    // Pull the specially-handled keys out of the wire options: `duration`\n    // is folded into the snapped value below, and the reference fields are\n    // re-added explicitly so a JSON-serialized `null` or empty array reads\n    // as \"unset\" instead of leaking onto the wire.\n    const {\n      duration: rawOptionDuration,\n      reference_images: explicitReferenceImages,\n      reference_audios: referenceAudios,\n      ...generationOptions\n    } = wireOptions\n\n    // Coerce the requested duration into the model's valid range (1–15s,\n    // integer) instead of rejecting it — `snapDuration` clamps and rounds.\n    // modelOptions wins over the generic `duration`, mirroring the size\n    // precedence below.\n    const rawDuration = rawOptionDuration ?? options.duration\n    const duration =\n      rawDuration != null ? this.snapDuration(rawDuration) : undefined\n\n    // Image parts split by role: un-roled / 'start_frame' images become the\n    // starting frame (image-to-video); 'reference' / 'character' images\n    // become reference_images (reference-to-video). The Imagine API has no\n    // mask / control / end-frame inputs. Unknown role strings (possible via\n    // JSON callers) throw rather than silently dropping the part.\n    const startFrames: Array<ImagePart<MediaInputMetadata>> = []\n    const referenceImages: Array<{ url: string }> = []\n    for (const part of resolved.images) {\n      const role = part.metadata?.role\n      switch (role) {\n        case 'mask':\n        case 'control':\n        case 'end_frame':\n          throw new Error(\n            `${this.name}: the Imagine video API has no '${role}' image ` +\n              `input on model ${model}. Use an un-roled / 'start_frame' ` +\n              `image as the starting frame, or 'reference' images.`,\n          )\n        case 'reference':\n        case 'character':\n          referenceImages.push({ url: mediaPartToUrl(part) })\n          break\n        case 'start_frame':\n        case undefined:\n          startFrames.push(part)\n          break\n        default:\n          throw new Error(\n            `${this.name}: unknown image metadata.role '${String(role)}'. ` +\n              `Expected 'start_frame', 'reference', or 'character'.`,\n          )\n      }\n    }\n    if (startFrames.length > 1) {\n      throw new Error(\n        `${this.name}: ${model} accepts at most one starting-frame image; received ${startFrames.length}. ` +\n          `Use metadata.role: 'reference' for reference-to-video inputs.`,\n      )\n    }\n    // Explicit modelOptions.reference_images replaces the part-derived list\n    // (an explicit empty array means \"none\").\n    const finalReferenceImages =\n      explicitReferenceImages ??\n      (referenceImages.length > 0 ? referenceImages : undefined)\n    const referenceImageCount = finalReferenceImages?.length ?? 0\n    const referenceAudioCount = referenceAudios?.length ?? 0\n    const hasReference = referenceImageCount > 0 || referenceAudioCount > 0\n\n    // Reference inputs are a grok-imagine-video-1.5 feature. The per-model\n    // options map already hides the fields from other models at compile\n    // time; this runtime gate covers prompt-part roles and untyped callers.\n    if (!isGrokVideoReferenceModel(model) && hasReference) {\n      throw new Error(\n        `${this.name}: ${model} does not support reference-to-video inputs. ` +\n          `Use 'grok-imagine-video-1.5' for reference_images / reference_audios.`,\n      )\n    }\n    if (referenceAudioCount > GROK_VIDEO_MAX_REFERENCE_AUDIOS) {\n      throw new Error(\n        `${this.name}: ${model} accepts at most ${GROK_VIDEO_MAX_REFERENCE_AUDIOS} reference voices; received ${referenceAudioCount}.`,\n      )\n    }\n    if (referenceImageCount > GROK_VIDEO_MAX_REFERENCE_IMAGES) {\n      throw new Error(\n        `${this.name}: ${model} accepts at most ${GROK_VIDEO_MAX_REFERENCE_IMAGES} reference images; received ${referenceImageCount}.`,\n      )\n    }\n\n    // Image-to-video: the single image prompt part becomes the starting frame\n    // and the prompt text describes the desired motion. URL sources are\n    // fetched by xAI's servers; data sources are sent as base64 data URIs.\n    const [startFrame] = startFrames\n\n    // xAI rejects `image` + `reference_images` / `reference_audios` as a\n    // 400: only one of image-to-video or reference-to-video can be active.\n    if (startFrame && hasReference) {\n      throw new Error(\n        `${this.name}: image-to-video and reference-to-video cannot be combined. ` +\n          `Use a starting-frame image, or reference images / voices, not both.`,\n      )\n    }\n\n    // The generic `size` option carries an \"aspectRatio_resolution\" template\n    // (e.g. '16:9_720p') and maps to the Imagine API's `aspect_ratio` /\n    // `resolution` parameters; explicit modelOptions win over the template\n    // (including `reference_images`, which replaces the part-derived list).\n    const parsedSize = size !== undefined ? parseGrokVideoSize(size) : undefined\n    const resolvedResolution =\n      generationOptions.resolution ?? parsedSize?.resolution\n    if (hasReference && resolvedResolution === '1080p') {\n      throw new Error(\n        `${this.name}: reference-to-video is capped at 720p on ${model}.`,\n      )\n    }\n    const request = {\n      model,\n      prompt: resolved.text,\n      ...(startFrame && { image: { url: mediaPartToUrl(startFrame) } }),\n      ...(referenceImageCount > 0 && {\n        reference_images: finalReferenceImages,\n      }),\n      ...(referenceAudioCount > 0 && {\n        reference_audios: referenceAudios,\n      }),\n      ...(parsedSize && {\n        aspect_ratio: parsedSize.aspectRatio,\n        ...(parsedSize.resolution !== undefined && {\n          resolution: parsedSize.resolution,\n        }),\n      }),\n      // The remaining options spread after the size template so explicit\n      // aspect_ratio / resolution win over it; duration and the reference\n      // fields were destructured out above and re-added normalized.\n      ...generationOptions,\n      ...(duration !== undefined && { duration }),\n    }\n\n    return await this.postVideoJob('/videos/generations', request, {\n      model,\n      logger,\n      logLine: `activity=video.create provider=${this.name} model=${model} mode=generate size=${size ?? 'default'} duration=${duration ?? 'default'}`,\n    })\n  }\n\n  /**\n   * Build and post an edit / extension request. Both endpoints take only\n   * `model`, `prompt`, and the source `video` (plus `duration` — the length\n   * of the added tail — for extensions): output geometry is inherited from\n   * the source clip, capped at 720p, and edit outputs also inherit the\n   * source length. Rather than sending fields the API documents as ignored,\n   * the inapplicable options are rejected with actionable errors.\n   */\n  private async createSourceVideoJob(args: {\n    model: string\n    mode: 'edit' | 'extend'\n    sourceVideo: VideoPart<MediaInputMetadata>\n    resolved: ReturnType<typeof resolveMediaPrompt>\n    wireOptions: Omit<GrokVideoRuntimeOptions, 'mode'>\n    size: string | undefined\n    genericDuration: number | undefined\n    logger: VideoGenerationOptions<GrokVideoRuntimeOptions>['logger']\n  }): Promise<VideoJobResult> {\n    const { model, mode, sourceVideo, resolved, wireOptions, logger } = args\n    const endpoint = mode === 'edit' ? '/videos/edits' : '/videos/extensions'\n\n    if (resolved.images.length > 0) {\n      throw new Error(\n        `${this.name}: '${mode}' mode takes only the source video — image ` +\n          `prompt parts are not supported by ${endpoint}.`,\n      )\n    }\n\n    // Pull every generation-only key out of the wire options so nothing can\n    // leak into the edit/extend body via the spread below. JSON-serialized\n    // `null` values (a common \"unset\" encoding) are treated as absent;\n    // actual values are rejected with actionable errors.\n    const {\n      aspect_ratio: aspectRatio,\n      resolution,\n      duration: modeDuration,\n      reference_images: referenceImagesOption,\n      reference_audios: referenceAudiosOption,\n      ...passthrough\n    } = wireOptions\n    if (\n      (referenceImagesOption?.length ?? 0) > 0 ||\n      (referenceAudiosOption?.length ?? 0) > 0\n    ) {\n      throw new Error(\n        `${this.name}: reference inputs are only supported by video ` +\n          `generation, not '${mode}' mode.`,\n      )\n    }\n    if (args.size !== undefined || aspectRatio != null || resolution != null) {\n      throw new Error(\n        `${this.name}: '${mode}' mode does not accept size / aspect_ratio / ` +\n          `resolution — the output inherits the source clip's geometry ` +\n          `(capped at 720p).`,\n      )\n    }\n    const rawDuration = modeDuration ?? args.genericDuration\n    if (mode === 'edit' && rawDuration != null) {\n      throw new Error(\n        `${this.name}: 'edit' mode does not accept a duration — the output ` +\n          `inherits the source clip's length. Use mode 'extend' to append ` +\n          `seconds to the clip.`,\n      )\n    }\n    // Extend: the snapped duration is the added-tail length (1–15s).\n    const duration =\n      rawDuration != null ? this.snapDuration(rawDuration) : undefined\n\n    const request = {\n      model,\n      prompt: resolved.text,\n      video: { url: mediaPartToUrl(sourceVideo) },\n      ...passthrough,\n      ...(duration !== undefined && { duration }),\n    }\n\n    return await this.postVideoJob(endpoint, request, {\n      model,\n      logger,\n      logLine: `activity=video.create provider=${this.name} model=${model} mode=${mode} duration=${duration ?? 'default'}`,\n    })\n  }\n\n  /**\n   * POST a create-job request body to one of the Imagine video endpoints\n   * (`/videos/generations`, `/videos/edits`, `/videos/extensions`) and read\n   * the `request_id` out of the shared response shape.\n   */\n  private async postVideoJob(\n    endpoint: string,\n    request: Record<string, unknown>,\n    context: {\n      model: string\n      logger: VideoGenerationOptions<GrokVideoRuntimeOptions>['logger']\n      logLine: string\n    },\n  ): Promise<VideoJobResult> {\n    const { model, logger, logLine } = context\n    try {\n      logger.request(logLine, { provider: this.name, model })\n\n      const response = await this.request(endpoint, {\n        method: 'POST',\n        body: JSON.stringify(request),\n      })\n      if (!response.ok) {\n        throw new Error(\n          `grok: ${endpoint} request failed (${response.status} ${response.statusText}): ${await this.errorMessage(response)}`,\n        )\n      }\n\n      const result = (await response.json()) as GrokVideoCreateResponse\n      if (!result.request_id) {\n        throw new Error(`grok: ${endpoint} response contained no request_id`)\n      }\n      return { jobId: result.request_id, model }\n    } catch (error: unknown) {\n      logger.errors(`${this.name}.createVideoJob fatal`, {\n        error: toRunErrorPayload(error, `${this.name}.createVideoJob failed`),\n        source: `${this.name}.createVideoJob`,\n      })\n      throw error\n    }\n  }\n\n  private async retrieveJob(jobId: string): Promise<GrokVideoStatusResponse> {\n    const response = await this.request(`/videos/${jobId}`)\n    if (!response.ok) {\n      const error = new Error(\n        `grok: video status request failed (${response.status} ${response.statusText}): ${await this.errorMessage(response)}`,\n      )\n      ;(error as { status?: number }).status = response.status\n      throw error\n    }\n    return (await response.json()) as GrokVideoStatusResponse\n  }\n\n  async getVideoStatus(jobId: string): Promise<VideoStatusResult> {\n    let response: GrokVideoStatusResponse\n    try {\n      response = await this.retrieveJob(jobId)\n    } catch (error) {\n      if ((error as { status?: number }).status === 404) {\n        return { jobId, status: 'failed', error: 'Job not found' }\n      }\n      throw error\n    }\n\n    return {\n      jobId,\n      status: this.mapStatus(response.status),\n      ...(response.progress !== undefined && { progress: response.progress }),\n      ...(response.error !== undefined && { error: response.error }),\n    }\n  }\n\n  async getVideoUrl(jobId: string): Promise<VideoUrlResult> {\n    let response: GrokVideoStatusResponse\n    try {\n      response = await this.retrieveJob(jobId)\n    } catch (error) {\n      if ((error as { status?: number }).status === 404) {\n        throw new Error(`Video job not found: ${jobId}`)\n      }\n      throw error\n    }\n\n    const status = this.mapStatus(response.status)\n    if (status === 'failed') {\n      throw new Error(\n        `Video generation failed${response.error ? `: ${response.error}` : ''}. Job ID: ${jobId}`,\n      )\n    }\n    const url = response.video?.url\n    if (!url) {\n      throw new Error(\n        `Video is not ready for download. Check status first. Job ID: ${jobId}`,\n      )\n    }\n\n    const usage = buildGrokVideoUsage(response)\n    return {\n      jobId,\n      url,\n      ...(usage && { usage }),\n    }\n  }\n\n  /**\n   * Maps Imagine API job statuses onto the generic video status set. The\n   * API reports 'pending' while queued/generating (with a numeric\n   * `progress`), then a terminal 'done' / 'failed' / 'expired'.\n   */\n  protected mapStatus(\n    apiStatus: string | undefined,\n  ): 'pending' | 'processing' | 'completed' | 'failed' {\n    switch (apiStatus) {\n      case 'pending':\n      case 'queued':\n        return 'pending'\n      case 'done':\n      case 'completed':\n      case 'succeeded':\n        return 'completed'\n      case 'failed':\n      case 'expired':\n      case 'error':\n      case 'cancelled':\n        return 'failed'\n      case undefined:\n      default:\n        return 'processing'\n    }\n  }\n\n  /**\n   * Both grok-imagine video models accept a continuous 1–15 integer-second\n   * range. Consumers can use this to render UI without provider knowledge.\n   */\n  override availableDurations(): DurationOptions<\n    GrokVideoModelDurationByName[TModel]\n  > {\n    return getGrokVideoDurationOptions(this.model)\n  }\n\n  /**\n   * Coerce a raw seconds value to the closest valid duration (clamped to\n   * [1, 15] and rounded to whole seconds).\n   */\n  override snapDuration(\n    seconds: number,\n  ): GrokVideoModelDurationByName[TModel] | undefined {\n    return snapToDurationOption(seconds, this.availableDurations())\n  }\n}\n\n/**\n * Creates a Grok video adapter with an explicit API key.\n * Type resolution happens here at the call site.\n *\n * @experimental Video generation is an experimental feature and may change.\n *\n * @param model - The model name (e.g., 'grok-imagine-video-1.5')\n * @param apiKey - Your xAI API key\n * @param config - Optional additional configuration\n * @returns Configured Grok video adapter instance with resolved types\n *\n * @example\n * ```typescript\n * const adapter = createGrokVideo('grok-imagine-video-1.5', 'xai-...');\n *\n * const { jobId } = await generateVideo({\n *   adapter,\n *   prompt: 'A beautiful sunset over the ocean',\n *   size: '16:9_720p',\n *   duration: 5\n * });\n * ```\n */\nexport function createGrokVideo<TModel extends GrokVideoModel>(\n  model: TModel,\n  apiKey: string,\n  config?: Omit<GrokVideoConfig, 'apiKey'>,\n): GrokVideoAdapter<TModel> {\n  return new GrokVideoAdapter({ apiKey, ...config }, model)\n}\n\n/**\n * Creates a Grok video 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 * @experimental Video generation is an experimental feature and may change.\n *\n * @param model - The model name (e.g., 'grok-imagine-video-1.5')\n * @param config - Optional configuration (excluding apiKey which is auto-detected)\n * @returns Configured Grok video 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 = grokVideo('grok-imagine-video-1.5');\n *\n * // Image-to-video: an optional image prompt part is the starting frame.\n * const { jobId } = await generateVideo({\n *   adapter,\n *   prompt: [\n *     { type: 'text', content: 'Make the cat start playing the piano' },\n *     { type: 'image', source: { type: 'url', value: 'https://example.com/cat.png' } },\n *   ],\n * });\n *\n * // Poll for status\n * const status = await getVideoJobStatus({ adapter, jobId });\n * ```\n */\nexport function grokVideo<TModel extends GrokVideoModel>(\n  model: TModel,\n  config?: Omit<GrokVideoConfig, 'apiKey'>,\n): GrokVideoAdapter<TModel> {\n  const apiKey = getGrokApiKeyFromEnv()\n  return createGrokVideo(model, apiKey, config)\n}\n"],"mappings":"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"}

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.1",
   "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.3"
   },
   "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.48.0"
   },
   "peerDependencies": {
+    "google-auth-library": "^10.5.0",
     "zod": "^4.0.0",
-    "@tanstack/ai": "^0.47.1"
+    "@tanstack/ai": "^0.48.0"
+  },
+  "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/adapters/video.ts

@@ -147,18 +147,13 @@ export class GrokVideoAdapter<
     this.clientConfig = withGrokDefaults(config)
   }
 
-  private get fetch(): (
-    input: string,
-    init?: RequestInit,
-  ) => Promise<Response> {
-    return this.clientConfig.fetch ?? fetch
-  }
-
   private async request(
     path: string,
     init?: Omit<RequestInit, 'headers'>,
   ): Promise<Response> {
-    return await this.fetch(`${this.clientConfig.baseURL}${path}`, {
+    // workerd's fetch must be invoked with this === globalThis
+    const fetchFn = this.clientConfig.fetch ?? globalThis.fetch.bind(globalThis)
+    return await fetchFn(`${this.clientConfig.baseURL}${path}`, {
       ...init,
       headers: {
         'Content-Type': 'application/json',

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',
+  )
+}