@tanstack/ai-grok 0.14.9 → 0.14.10

package/dist/esm/adapters/text.js

@@ -1,44 +1,88 @@
+import { getGrokApiKeyFromEnv, withGrokDefaults } from "../utils/client.js";
+import { convertToolsToProviderFormat } from "../tools/index.js";
 import OpenAI from "openai";
 import { OpenAIBaseResponsesTextAdapter } from "@tanstack/openai-base";
-import { withGrokDefaults, getGrokApiKeyFromEnv } from "../utils/client.js";
-import { convertToolsToProviderFormat } from "../tools/index.js";
-class GrokTextAdapter extends OpenAIBaseResponsesTextAdapter {
-  kind = "text";
-  name = "grok";
-  constructor(config, model) {
-    super(model, "grok", new OpenAI(withGrokDefaults(config)));
-  }
-  mapOptionsToRequest(options) {
-    const { tools: _baseTools, ...request } = super.mapOptionsToRequest({
-      ...options,
-      tools: void 0
-    });
-    if (this.model === "grok-build-0.1" && request.reasoning !== void 0) {
-      throw new Error(
-        "grok-build-0.1 does not support reasoning modelOptions; omit reasoning for this model."
-      );
-    }
-    const tools = options.tools ? convertToolsToProviderFormat(options.tools) : void 0;
-    return {
-      ...request,
-      // xAI recommends encrypted reasoning for reasoning-capable Responses
-      // requests; callers can still override either field in modelOptions.
-      store: request.store ?? false,
-      include: request.include ?? ["reasoning.encrypted_content"],
-      ...tools && tools.length > 0 && { tools }
-    };
-  }
-}
+//#region src/adapters/text.ts
+/**
+* Grok Text (Chat) Adapter
+*
+* Tree-shakeable adapter for Grok chat/text completion functionality.
+* Uses xAI's OpenAI-compatible Responses API.
+*
+* Delegates implementation to {@link OpenAIBaseResponsesTextAdapter}
+* from `@tanstack/openai-base` and threads Grok-specific tool-capability
+* typing through the 5th generic of the base class.
+*/
+var GrokTextAdapter = class extends OpenAIBaseResponsesTextAdapter {
+	kind = "text";
+	name = "grok";
+	constructor(config, model) {
+		super(model, "grok", new OpenAI(withGrokDefaults(config)));
+	}
+	mapOptionsToRequest(options) {
+		const { tools: _baseTools, ...request } = super.mapOptionsToRequest({
+			...options,
+			tools: void 0
+		});
+		if (this.model === "grok-build-0.1" && request.reasoning !== void 0) throw new Error("grok-build-0.1 does not support reasoning modelOptions; omit reasoning for this model.");
+		const tools = options.tools ? convertToolsToProviderFormat(options.tools) : void 0;
+		return {
+			...request,
+			store: request.store ?? false,
+			include: request.include ?? ["reasoning.encrypted_content"],
+			...tools && tools.length > 0 && { tools }
+		};
+	}
+};
+/**
+* Creates a Grok text adapter with explicit API key.
+* Type resolution happens here at the call site.
+*
+* @param model - The model name (e.g., 'grok-build-0.1')
+* @param apiKey - Your xAI API key
+* @param config - Optional additional configuration
+* @returns Configured Grok text adapter instance with resolved types
+*
+* @example
+* ```typescript
+* const adapter = createGrokText('grok-build-0.1', "xai-...");
+* // adapter has type-safe providerOptions for grok-build-0.1
+* ```
+*/
 function createGrokText(model, apiKey, config) {
-  return new GrokTextAdapter({ apiKey, ...config }, model);
+	return new GrokTextAdapter({
+		apiKey,
+		...config
+	}, model);
 }
+/**
+* Creates a Grok text adapter with automatic API key detection from environment variables.
+* Type resolution happens here at the call site.
+*
+* Looks for `XAI_API_KEY` in:
+* - `process.env` (Node.js)
+* - `window.env` (Browser with injected env)
+*
+* @param model - The model name (e.g., 'grok-build-0.1')
+* @param config - Optional configuration (excluding apiKey which is auto-detected)
+* @returns Configured Grok text adapter instance with resolved types
+* @throws Error if XAI_API_KEY is not found in environment
+*
+* @example
+* ```typescript
+* // Automatically uses XAI_API_KEY from environment
+* const adapter = grokText('grok-build-0.1');
+*
+* const stream = chat({
+*   adapter,
+*   messages: [{ role: "user", content: "Hello!" }]
+* });
+* ```
+*/
 function grokText(model, config) {
-  const apiKey = getGrokApiKeyFromEnv();
-  return createGrokText(model, apiKey, config);
+	return createGrokText(model, getGrokApiKeyFromEnv(), config);
 }
-export {
-  GrokTextAdapter,
-  createGrokText,
-  grokText
-};
-//# sourceMappingURL=text.js.map
+//#endregion
+export { GrokTextAdapter, createGrokText, grokText };
+
+//# sourceMappingURL=text.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"text.js","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"],"names":[],"mappings":";;;;AA2CO,MAAM,wBAWH,+BAMR;AAAA,EACkB,OAAO;AAAA,EACP,OAAO;AAAA,EAEzB,YAAY,QAAwB,OAAe;AACjD,UAAM,OAAO,QAAQ,IAAI,OAAO,iBAAiB,MAAM,CAAC,CAAC;AAAA,EAC3D;AAAA,EAEmB,oBACjB,SACsC;AACtC,UAAM,EAAE,OAAO,YAAY,GAAG,QAAA,IAAY,MAAM,oBAAoB;AAAA,MAClE,GAAG;AAAA,MACH,OAAO;AAAA,IAAA,CACR;AAGD,QAAI,KAAK,UAAU,oBAAoB,QAAQ,cAAc,QAAW;AACtE,YAAM,IAAI;AAAA,QACR;AAAA,MAAA;AAAA,IAEJ;AAEA,UAAM,QAAQ,QAAQ,QAClB,6BAA6B,QAAQ,KAAK,IAC1C;AAEJ,WAAO;AAAA,MACL,GAAG;AAAA;AAAA;AAAA,MAGH,OAAO,QAAQ,SAAS;AAAA,MACxB,SAAS,QAAQ,WAAW,CAAC,6BAA6B;AAAA,MAC1D,GAAI,SACF,MAAM,SAAS,KAAK,EAAE,MAAA;AAAA,IAA8C;AAAA,EAE1E;AACF;AAiBO,SAAS,eAGd,OACA,QACA,QACyB;AACzB,SAAO,IAAI,gBAAgB,EAAE,QAAQ,GAAG,OAAA,GAAU,KAAK;AACzD;AA0BO,SAAS,SACd,OACA,QACyB;AACzB,QAAM,SAAS,qBAAA;AACf,SAAO,eAAe,OAAO,QAAQ,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  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"}

package/dist/esm/adapters/transcription.js

@@ -1,122 +1,141 @@
-import { BaseTranscriptionAdapter } from "@tanstack/ai/adapters";
-import { generateId } from "@tanstack/ai-utils";
 import { getGrokApiKeyFromEnv } from "../utils/client.js";
-import "@tanstack/openai-base";
 import { toAudioFile } from "../utils/audio.js";
-const DEFAULT_GROK_BASE_URL = "https://api.x.ai/v1";
-class GrokTranscriptionAdapter extends BaseTranscriptionAdapter {
-  name = "grok";
-  apiKey;
-  baseURL;
-  defaultHeaders;
-  constructor(config, model) {
-    super(model, config);
-    this.apiKey = config.apiKey;
-    this.baseURL = (config.baseURL ?? DEFAULT_GROK_BASE_URL).replace(/\/+$/, "");
-    this.defaultHeaders = config.defaultHeaders ?? {};
-  }
-  async transcribe(options) {
-    const { logger } = options;
-    const { model, audio, language, modelOptions } = options;
-    logger.request(
-      `activity=generateTranscription provider=grok model=${model}`,
-      { provider: "grok", model }
-    );
-    const file = toAudioFile(audio, modelOptions?.audio_format);
-    const form = buildTranscriptionFormData({ file, language, modelOptions });
-    try {
-      const response = await fetch(`${this.baseURL}/stt`, {
-        method: "POST",
-        headers: {
-          // `defaultHeaders` first so Authorization always wins.
-          ...this.defaultHeaders,
-          Authorization: `Bearer ${this.apiKey}`
-        },
-        body: form
-      });
-      if (!response.ok) {
-        const errorText = await response.text();
-        throw new Error(
-          `Grok transcription request failed: ${response.status} ${errorText}`
-        );
-      }
-      const data = await response.json();
-      const words = data.words?.map(
-        (w) => {
-          const tw = {
-            word: w.text,
-            start: w.start,
-            end: w.end
-          };
-          if (w.confidence !== void 0) tw.confidence = w.confidence;
-          if (w.speaker !== void 0) tw.speaker = w.speaker;
-          return tw;
-        }
-      );
-      const resolvedLanguage = data.language ?? language;
-      const usage = data.duration !== void 0 && data.duration > 0 ? {
-        promptTokens: 0,
-        completionTokens: 0,
-        totalTokens: 0,
-        durationSeconds: data.duration
-      } : void 0;
-      return {
-        id: generateId(this.name),
-        model,
-        text: data.text,
-        ...resolvedLanguage !== void 0 && { language: resolvedLanguage },
-        duration: data.duration,
-        ...words !== void 0 && { words },
-        ...usage !== void 0 && { usage }
-      };
-    } catch (error) {
-      logger.errors("grok.transcribe fatal", {
-        error,
-        source: "grok.transcribe"
-      });
-      throw error;
-    }
-  }
-}
+import { generateId } from "../utils/index.js";
+import { BaseTranscriptionAdapter } from "@tanstack/ai/adapters";
+//#region src/adapters/transcription.ts
+var DEFAULT_GROK_BASE_URL = "https://api.x.ai/v1";
+/**
+* Grok Speech-to-Text Adapter.
+*
+* Talks to `POST {baseURL}/stt` per
+* https://docs.x.ai/developers/rest-api-reference/inference/voice
+*/
+var GrokTranscriptionAdapter = class extends BaseTranscriptionAdapter {
+	name = "grok";
+	apiKey;
+	baseURL;
+	defaultHeaders;
+	constructor(config, model) {
+		super(model, config);
+		this.apiKey = config.apiKey;
+		this.baseURL = (config.baseURL ?? DEFAULT_GROK_BASE_URL).replace(/\/+$/, "");
+		this.defaultHeaders = config.defaultHeaders ?? {};
+	}
+	async transcribe(options) {
+		const { logger } = options;
+		const { model, audio, language, modelOptions } = options;
+		logger.request(`activity=generateTranscription provider=grok model=${model}`, {
+			provider: "grok",
+			model
+		});
+		const form = buildTranscriptionFormData({
+			file: toAudioFile(audio, modelOptions?.audio_format),
+			language,
+			modelOptions
+		});
+		try {
+			const response = await fetch(`${this.baseURL}/stt`, {
+				method: "POST",
+				headers: {
+					...this.defaultHeaders,
+					Authorization: `Bearer ${this.apiKey}`
+				},
+				body: form
+			});
+			if (!response.ok) {
+				const errorText = await response.text();
+				throw new Error(`Grok transcription request failed: ${response.status} ${errorText}`);
+			}
+			const data = await response.json();
+			const words = data.words?.map((w) => {
+				const tw = {
+					word: w.text,
+					start: w.start,
+					end: w.end
+				};
+				if (w.confidence !== void 0) tw.confidence = w.confidence;
+				if (w.speaker !== void 0) tw.speaker = w.speaker;
+				return tw;
+			});
+			const resolvedLanguage = data.language ?? language;
+			const usage = data.duration !== void 0 && data.duration > 0 ? {
+				promptTokens: 0,
+				completionTokens: 0,
+				totalTokens: 0,
+				durationSeconds: data.duration
+			} : void 0;
+			return {
+				id: generateId(this.name),
+				model,
+				text: data.text,
+				...resolvedLanguage !== void 0 && { language: resolvedLanguage },
+				duration: data.duration,
+				...words !== void 0 && { words },
+				...usage !== void 0 && { usage }
+			};
+		} catch (error) {
+			logger.errors("grok.transcribe fatal", {
+				error,
+				source: "grok.transcribe"
+			});
+			throw error;
+		}
+	}
+};
+/**
+* Build the multipart/form-data body for `POST /v1/stt`, coercing SDK-level
+* model options into xAI's wire format (booleans as `'true'`/`'false'`
+* strings, numeric fields stringified, etc.).
+*
+* Wire-field mapping:
+*   - `modelOptions.inverse_text_normalization` → `format` (xAI's chosen
+*     wire-field name for the ITN boolean; the SDK surfaces it under the
+*     clearer `inverse_text_normalization` key).
+*   - `modelOptions.audio_format`, `sample_rate`, `multichannel`, `channels`,
+*     `diarize` map to same-named form fields.
+*/
 function buildTranscriptionFormData(options) {
-  const { file, language, modelOptions } = options;
-  const form = new FormData();
-  form.set("file", file);
-  if (language) form.set("language", language);
-  if (modelOptions?.audio_format !== void 0) {
-    form.set("audio_format", modelOptions.audio_format);
-  }
-  if (modelOptions?.sample_rate !== void 0) {
-    form.set("sample_rate", String(modelOptions.sample_rate));
-  }
-  if (modelOptions?.inverse_text_normalization !== void 0) {
-    form.set(
-      "format",
-      modelOptions.inverse_text_normalization ? "true" : "false"
-    );
-  }
-  if (modelOptions?.multichannel !== void 0) {
-    form.set("multichannel", modelOptions.multichannel ? "true" : "false");
-  }
-  if (modelOptions?.channels !== void 0) {
-    form.set("channels", String(modelOptions.channels));
-  }
-  if (modelOptions?.diarize !== void 0) {
-    form.set("diarize", modelOptions.diarize ? "true" : "false");
-  }
-  return form;
+	const { file, language, modelOptions } = options;
+	const form = new FormData();
+	form.set("file", file);
+	if (language) form.set("language", language);
+	if (modelOptions?.audio_format !== void 0) form.set("audio_format", modelOptions.audio_format);
+	if (modelOptions?.sample_rate !== void 0) form.set("sample_rate", String(modelOptions.sample_rate));
+	if (modelOptions?.inverse_text_normalization !== void 0) form.set("format", modelOptions.inverse_text_normalization ? "true" : "false");
+	if (modelOptions?.multichannel !== void 0) form.set("multichannel", modelOptions.multichannel ? "true" : "false");
+	if (modelOptions?.channels !== void 0) form.set("channels", String(modelOptions.channels));
+	if (modelOptions?.diarize !== void 0) form.set("diarize", modelOptions.diarize ? "true" : "false");
+	return form;
 }
+/**
+* Creates a Grok transcription adapter with an explicit API key.
+*
+* @example
+* ```typescript
+* const adapter = createGrokTranscription('grok-stt', 'xai-...')
+* const result = await generateTranscription({
+*   adapter,
+*   audio: audioFile,
+*   language: 'en',
+* })
+* ```
+*/
 function createGrokTranscription(model, apiKey, config) {
-  return new GrokTranscriptionAdapter({ apiKey, ...config }, model);
+	return new GrokTranscriptionAdapter({
+		apiKey,
+		...config
+	}, model);
 }
+/**
+* Creates a Grok transcription adapter, reading the API key from
+* `XAI_API_KEY` in the environment.
+*
+* @throws Error if `XAI_API_KEY` is not set.
+*/
 function grokTranscription(model, config) {
-  const apiKey = getGrokApiKeyFromEnv();
-  return createGrokTranscription(model, apiKey, config);
+	return createGrokTranscription(model, getGrokApiKeyFromEnv(), config);
 }
-export {
-  GrokTranscriptionAdapter,
-  buildTranscriptionFormData,
-  createGrokTranscription,
-  grokTranscription
-};
-//# sourceMappingURL=transcription.js.map
+//#endregion
+export { GrokTranscriptionAdapter, buildTranscriptionFormData, createGrokTranscription, grokTranscription };
+
+//# sourceMappingURL=transcription.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"transcription.js","sources":["../../../src/adapters/transcription.ts"],"sourcesContent":["import { BaseTranscriptionAdapter } from '@tanstack/ai/adapters'\nimport { generateId, getGrokApiKeyFromEnv, toAudioFile } from '../utils'\nimport type {\n  TokenUsage,\n  TranscriptionOptions,\n  TranscriptionResult,\n  TranscriptionWord,\n} from '@tanstack/ai'\nimport type { GrokTranscriptionModel } from '../model-meta'\nimport type { GrokTranscriptionProviderOptions } from '../audio/transcription-provider-options'\n\n/**\n * Grok-specific extension of `TranscriptionWord` that surfaces the extra\n * fields xAI returns when diarization / confidence are enabled. The base\n * cross-provider `TranscriptionWord` contract doesn't include these, so\n * callers who know they're using Grok can narrow with:\n *\n * ```ts\n * const words = result.words as Array<GrokTranscriptionWord> | undefined\n * ```\n */\nexport interface GrokTranscriptionWord extends TranscriptionWord {\n  /** Model confidence for the word, when xAI returns one. */\n  confidence?: number\n  /** Speaker index, populated when `modelOptions.diarize === true`. */\n  speaker?: number\n}\n\nconst DEFAULT_GROK_BASE_URL = 'https://api.x.ai/v1'\n\n/**\n * Configuration for the Grok transcription adapter.\n *\n * Uses direct `fetch` rather than the OpenAI SDK because xAI's `/v1/stt`\n * endpoint is not OpenAI-compatible.\n */\nexport interface GrokTranscriptionConfig {\n  apiKey: string\n  baseURL?: string\n  /** Additional headers to merge into every request (e.g., test IDs). */\n  defaultHeaders?: Record<string, string>\n}\n\n/**\n * xAI STT response shape from `POST /v1/stt`.\n * Grok returns word-level timestamps only; no segment array.\n */\ninterface GrokSTTWord {\n  text: string\n  start: number\n  end: number\n  confidence?: number\n  speaker?: number\n}\n\ninterface GrokSTTResponse {\n  text: string\n  language?: string\n  duration?: number\n  words?: Array<GrokSTTWord>\n  channels?: Array<unknown>\n}\n\n/**\n * Grok Speech-to-Text Adapter.\n *\n * Talks to `POST {baseURL}/stt` per\n * https://docs.x.ai/developers/rest-api-reference/inference/voice\n */\nexport class GrokTranscriptionAdapter<\n  TModel extends GrokTranscriptionModel,\n> extends BaseTranscriptionAdapter<TModel, GrokTranscriptionProviderOptions> {\n  readonly name = 'grok' as const\n\n  private readonly apiKey: string\n  private readonly baseURL: string\n  private readonly defaultHeaders: Record<string, string>\n\n  constructor(config: GrokTranscriptionConfig, model: TModel) {\n    super(model, config)\n    this.apiKey = config.apiKey\n    this.baseURL = (config.baseURL ?? DEFAULT_GROK_BASE_URL).replace(/\\/+$/, '')\n    this.defaultHeaders = config.defaultHeaders ?? {}\n  }\n\n  async transcribe(\n    options: TranscriptionOptions<GrokTranscriptionProviderOptions>,\n  ): Promise<TranscriptionResult> {\n    const { logger } = options\n    const { model, audio, language, modelOptions } = options\n\n    logger.request(\n      `activity=generateTranscription provider=grok model=${model}`,\n      { provider: 'grok', model },\n    )\n\n    const file = toAudioFile(audio, modelOptions?.audio_format)\n    const form = buildTranscriptionFormData({ file, language, modelOptions })\n\n    try {\n      const response = await fetch(`${this.baseURL}/stt`, {\n        method: 'POST',\n        headers: {\n          // `defaultHeaders` first so Authorization always wins.\n          ...this.defaultHeaders,\n          Authorization: `Bearer ${this.apiKey}`,\n        },\n        body: form,\n      })\n\n      if (!response.ok) {\n        const errorText = await response.text()\n        throw new Error(\n          `Grok transcription request failed: ${response.status} ${errorText}`,\n        )\n      }\n\n      const data = (await response.json()) as GrokSTTResponse\n\n      const words: Array<TranscriptionWord> | undefined = data.words?.map(\n        (w) => {\n          // Construct a GrokTranscriptionWord so that `confidence` and\n          // `speaker` (when xAI returns them under `diarize` / confidence\n          // mode) are preserved on the result. The returned array is typed\n          // as `Array<TranscriptionWord>` per the cross-provider contract;\n          // callers who want the extras narrow via `as Array<GrokTranscriptionWord>`.\n          const tw: GrokTranscriptionWord = {\n            word: w.text,\n            start: w.start,\n            end: w.end,\n          }\n          if (w.confidence !== undefined) tw.confidence = w.confidence\n          if (w.speaker !== undefined) tw.speaker = w.speaker\n          return tw\n        },\n      )\n\n      const resolvedLanguage = data.language ?? language\n      // xAI's /v1/stt response carries no token counts — STT is duration-billed —\n      // so surface the audio duration as `durationSeconds`, mirroring the\n      // whisper-1 path in the OpenAI transcription adapter.\n      const usage: TokenUsage | undefined =\n        data.duration !== undefined && data.duration > 0\n          ? {\n              promptTokens: 0,\n              completionTokens: 0,\n              totalTokens: 0,\n              durationSeconds: data.duration,\n            }\n          : undefined\n      return {\n        id: generateId(this.name),\n        model,\n        text: data.text,\n        ...(resolvedLanguage !== undefined && { language: resolvedLanguage }),\n        duration: data.duration,\n        ...(words !== undefined && { words }),\n        ...(usage !== undefined && { usage }),\n      }\n    } catch (error) {\n      logger.errors('grok.transcribe fatal', {\n        error,\n        source: 'grok.transcribe',\n      })\n      throw error\n    }\n  }\n}\n\n/**\n * Build the multipart/form-data body for `POST /v1/stt`, coercing SDK-level\n * model options into xAI's wire format (booleans as `'true'`/`'false'`\n * strings, numeric fields stringified, etc.).\n *\n * Wire-field mapping:\n *   - `modelOptions.inverse_text_normalization` → `format` (xAI's chosen\n *     wire-field name for the ITN boolean; the SDK surfaces it under the\n *     clearer `inverse_text_normalization` key).\n *   - `modelOptions.audio_format`, `sample_rate`, `multichannel`, `channels`,\n *     `diarize` map to same-named form fields.\n */\nexport function buildTranscriptionFormData(options: {\n  file: File\n  language: string | undefined\n  modelOptions: GrokTranscriptionProviderOptions | undefined\n}): FormData {\n  const { file, language, modelOptions } = options\n  const form = new FormData()\n  form.set('file', file)\n  if (language) form.set('language', language)\n  if (modelOptions?.audio_format !== undefined) {\n    form.set('audio_format', modelOptions.audio_format)\n  }\n  if (modelOptions?.sample_rate !== undefined) {\n    form.set('sample_rate', String(modelOptions.sample_rate))\n  }\n  if (modelOptions?.inverse_text_normalization !== undefined) {\n    form.set(\n      'format',\n      modelOptions.inverse_text_normalization ? 'true' : 'false',\n    )\n  }\n  if (modelOptions?.multichannel !== undefined) {\n    form.set('multichannel', modelOptions.multichannel ? 'true' : 'false')\n  }\n  if (modelOptions?.channels !== undefined) {\n    form.set('channels', String(modelOptions.channels))\n  }\n  if (modelOptions?.diarize !== undefined) {\n    form.set('diarize', modelOptions.diarize ? 'true' : 'false')\n  }\n  return form\n}\n\n/**\n * Creates a Grok transcription adapter with an explicit API key.\n *\n * @example\n * ```typescript\n * const adapter = createGrokTranscription('grok-stt', 'xai-...')\n * const result = await generateTranscription({\n *   adapter,\n *   audio: audioFile,\n *   language: 'en',\n * })\n * ```\n */\nexport function createGrokTranscription<TModel extends GrokTranscriptionModel>(\n  model: TModel,\n  apiKey: string,\n  config?: Omit<GrokTranscriptionConfig, 'apiKey'>,\n): GrokTranscriptionAdapter<TModel> {\n  return new GrokTranscriptionAdapter({ apiKey, ...config }, model)\n}\n\n/**\n * Creates a Grok transcription adapter, reading the API key from\n * `XAI_API_KEY` in the environment.\n *\n * @throws Error if `XAI_API_KEY` is not set.\n */\nexport function grokTranscription<TModel extends GrokTranscriptionModel>(\n  model: TModel,\n  config?: Omit<GrokTranscriptionConfig, 'apiKey'>,\n): GrokTranscriptionAdapter<TModel> {\n  const apiKey = getGrokApiKeyFromEnv()\n  return createGrokTranscription(model, apiKey, config)\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"transcription.js","names":[],"sources":["../../../src/adapters/transcription.ts"],"sourcesContent":["import { BaseTranscriptionAdapter } from '@tanstack/ai/adapters'\nimport { generateId, getGrokApiKeyFromEnv, toAudioFile } from '../utils'\nimport type {\n  TokenUsage,\n  TranscriptionOptions,\n  TranscriptionResult,\n  TranscriptionWord,\n} from '@tanstack/ai'\nimport type { GrokTranscriptionModel } from '../model-meta'\nimport type { GrokTranscriptionProviderOptions } from '../audio/transcription-provider-options'\n\n/**\n * Grok-specific extension of `TranscriptionWord` that surfaces the extra\n * fields xAI returns when diarization / confidence are enabled. The base\n * cross-provider `TranscriptionWord` contract doesn't include these, so\n * callers who know they're using Grok can narrow with:\n *\n * ```ts\n * const words = result.words as Array<GrokTranscriptionWord> | undefined\n * ```\n */\nexport interface GrokTranscriptionWord extends TranscriptionWord {\n  /** Model confidence for the word, when xAI returns one. */\n  confidence?: number\n  /** Speaker index, populated when `modelOptions.diarize === true`. */\n  speaker?: number\n}\n\nconst DEFAULT_GROK_BASE_URL = 'https://api.x.ai/v1'\n\n/**\n * Configuration for the Grok transcription adapter.\n *\n * Uses direct `fetch` rather than the OpenAI SDK because xAI's `/v1/stt`\n * endpoint is not OpenAI-compatible.\n */\nexport interface GrokTranscriptionConfig {\n  apiKey: string\n  baseURL?: string\n  /** Additional headers to merge into every request (e.g., test IDs). */\n  defaultHeaders?: Record<string, string>\n}\n\n/**\n * xAI STT response shape from `POST /v1/stt`.\n * Grok returns word-level timestamps only; no segment array.\n */\ninterface GrokSTTWord {\n  text: string\n  start: number\n  end: number\n  confidence?: number\n  speaker?: number\n}\n\ninterface GrokSTTResponse {\n  text: string\n  language?: string\n  duration?: number\n  words?: Array<GrokSTTWord>\n  channels?: Array<unknown>\n}\n\n/**\n * Grok Speech-to-Text Adapter.\n *\n * Talks to `POST {baseURL}/stt` per\n * https://docs.x.ai/developers/rest-api-reference/inference/voice\n */\nexport class GrokTranscriptionAdapter<\n  TModel extends GrokTranscriptionModel,\n> extends BaseTranscriptionAdapter<TModel, GrokTranscriptionProviderOptions> {\n  readonly name = 'grok' as const\n\n  private readonly apiKey: string\n  private readonly baseURL: string\n  private readonly defaultHeaders: Record<string, string>\n\n  constructor(config: GrokTranscriptionConfig, model: TModel) {\n    super(model, config)\n    this.apiKey = config.apiKey\n    this.baseURL = (config.baseURL ?? DEFAULT_GROK_BASE_URL).replace(/\\/+$/, '')\n    this.defaultHeaders = config.defaultHeaders ?? {}\n  }\n\n  async transcribe(\n    options: TranscriptionOptions<GrokTranscriptionProviderOptions>,\n  ): Promise<TranscriptionResult> {\n    const { logger } = options\n    const { model, audio, language, modelOptions } = options\n\n    logger.request(\n      `activity=generateTranscription provider=grok model=${model}`,\n      { provider: 'grok', model },\n    )\n\n    const file = toAudioFile(audio, modelOptions?.audio_format)\n    const form = buildTranscriptionFormData({ file, language, modelOptions })\n\n    try {\n      const response = await fetch(`${this.baseURL}/stt`, {\n        method: 'POST',\n        headers: {\n          // `defaultHeaders` first so Authorization always wins.\n          ...this.defaultHeaders,\n          Authorization: `Bearer ${this.apiKey}`,\n        },\n        body: form,\n      })\n\n      if (!response.ok) {\n        const errorText = await response.text()\n        throw new Error(\n          `Grok transcription request failed: ${response.status} ${errorText}`,\n        )\n      }\n\n      const data = (await response.json()) as GrokSTTResponse\n\n      const words: Array<TranscriptionWord> | undefined = data.words?.map(\n        (w) => {\n          // Construct a GrokTranscriptionWord so that `confidence` and\n          // `speaker` (when xAI returns them under `diarize` / confidence\n          // mode) are preserved on the result. The returned array is typed\n          // as `Array<TranscriptionWord>` per the cross-provider contract;\n          // callers who want the extras narrow via `as Array<GrokTranscriptionWord>`.\n          const tw: GrokTranscriptionWord = {\n            word: w.text,\n            start: w.start,\n            end: w.end,\n          }\n          if (w.confidence !== undefined) tw.confidence = w.confidence\n          if (w.speaker !== undefined) tw.speaker = w.speaker\n          return tw\n        },\n      )\n\n      const resolvedLanguage = data.language ?? language\n      // xAI's /v1/stt response carries no token counts — STT is duration-billed —\n      // so surface the audio duration as `durationSeconds`, mirroring the\n      // whisper-1 path in the OpenAI transcription adapter.\n      const usage: TokenUsage | undefined =\n        data.duration !== undefined && data.duration > 0\n          ? {\n              promptTokens: 0,\n              completionTokens: 0,\n              totalTokens: 0,\n              durationSeconds: data.duration,\n            }\n          : undefined\n      return {\n        id: generateId(this.name),\n        model,\n        text: data.text,\n        ...(resolvedLanguage !== undefined && { language: resolvedLanguage }),\n        duration: data.duration,\n        ...(words !== undefined && { words }),\n        ...(usage !== undefined && { usage }),\n      }\n    } catch (error) {\n      logger.errors('grok.transcribe fatal', {\n        error,\n        source: 'grok.transcribe',\n      })\n      throw error\n    }\n  }\n}\n\n/**\n * Build the multipart/form-data body for `POST /v1/stt`, coercing SDK-level\n * model options into xAI's wire format (booleans as `'true'`/`'false'`\n * strings, numeric fields stringified, etc.).\n *\n * Wire-field mapping:\n *   - `modelOptions.inverse_text_normalization` → `format` (xAI's chosen\n *     wire-field name for the ITN boolean; the SDK surfaces it under the\n *     clearer `inverse_text_normalization` key).\n *   - `modelOptions.audio_format`, `sample_rate`, `multichannel`, `channels`,\n *     `diarize` map to same-named form fields.\n */\nexport function buildTranscriptionFormData(options: {\n  file: File\n  language: string | undefined\n  modelOptions: GrokTranscriptionProviderOptions | undefined\n}): FormData {\n  const { file, language, modelOptions } = options\n  const form = new FormData()\n  form.set('file', file)\n  if (language) form.set('language', language)\n  if (modelOptions?.audio_format !== undefined) {\n    form.set('audio_format', modelOptions.audio_format)\n  }\n  if (modelOptions?.sample_rate !== undefined) {\n    form.set('sample_rate', String(modelOptions.sample_rate))\n  }\n  if (modelOptions?.inverse_text_normalization !== undefined) {\n    form.set(\n      'format',\n      modelOptions.inverse_text_normalization ? 'true' : 'false',\n    )\n  }\n  if (modelOptions?.multichannel !== undefined) {\n    form.set('multichannel', modelOptions.multichannel ? 'true' : 'false')\n  }\n  if (modelOptions?.channels !== undefined) {\n    form.set('channels', String(modelOptions.channels))\n  }\n  if (modelOptions?.diarize !== undefined) {\n    form.set('diarize', modelOptions.diarize ? 'true' : 'false')\n  }\n  return form\n}\n\n/**\n * Creates a Grok transcription adapter with an explicit API key.\n *\n * @example\n * ```typescript\n * const adapter = createGrokTranscription('grok-stt', 'xai-...')\n * const result = await generateTranscription({\n *   adapter,\n *   audio: audioFile,\n *   language: 'en',\n * })\n * ```\n */\nexport function createGrokTranscription<TModel extends GrokTranscriptionModel>(\n  model: TModel,\n  apiKey: string,\n  config?: Omit<GrokTranscriptionConfig, 'apiKey'>,\n): GrokTranscriptionAdapter<TModel> {\n  return new GrokTranscriptionAdapter({ apiKey, ...config }, model)\n}\n\n/**\n * Creates a Grok transcription adapter, reading the API key from\n * `XAI_API_KEY` in the environment.\n *\n * @throws Error if `XAI_API_KEY` is not set.\n */\nexport function grokTranscription<TModel extends GrokTranscriptionModel>(\n  model: TModel,\n  config?: Omit<GrokTranscriptionConfig, 'apiKey'>,\n): GrokTranscriptionAdapter<TModel> {\n  const apiKey = getGrokApiKeyFromEnv()\n  return createGrokTranscription(model, apiKey, config)\n}\n"],"mappings":"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"}