@tanstack/ai-grok 0.14.8 → 0.14.10

package/dist/esm/tools/index.js

@@ -1,113 +1,74 @@
-import { brandProviderTool } from "@tanstack/ai";
 import { convertFunctionToolToResponsesFormat } from "@tanstack/openai-base";
-import { convertFunctionToolToResponsesFormat as convertFunctionToolToResponsesFormat2 } from "@tanstack/openai-base";
+import { brandProviderTool } from "@tanstack/ai";
+//#region src/tools/index.ts
 function providerTool(kind, description, metadata) {
-  return brandProviderTool({
-    name: kind,
-    description,
-    metadata: {
-      __kind: `grok.${kind}`,
-      ...metadata
-    }
-  });
+	return brandProviderTool({
+		name: kind,
+		description,
+		metadata: {
+			__kind: `grok.${kind}`,
+			...metadata
+		}
+	});
 }
 function grokWebSearchTool(config = {}) {
-  if (config.filters?.allowed_domains !== void 0 && config.filters.excluded_domains !== void 0) {
-    throw new Error(
-      "allowed_domains and excluded_domains cannot both be provided."
-    );
-  }
-  if (config.filters?.allowed_domains !== void 0 && config.filters.allowed_domains.length > 5) {
-    throw new Error("allowed_domains supports at most 5 domains.");
-  }
-  if (config.filters?.excluded_domains !== void 0 && config.filters.excluded_domains.length > 5) {
-    throw new Error("excluded_domains supports at most 5 domains.");
-  }
-  return providerTool("web_search", "Search the web", {
-    type: "web_search",
-    ...config
-  });
+	if (config.filters?.allowed_domains !== void 0 && config.filters.excluded_domains !== void 0) throw new Error("allowed_domains and excluded_domains cannot both be provided.");
+	if (config.filters?.allowed_domains !== void 0 && config.filters.allowed_domains.length > 5) throw new Error("allowed_domains supports at most 5 domains.");
+	if (config.filters?.excluded_domains !== void 0 && config.filters.excluded_domains.length > 5) throw new Error("excluded_domains supports at most 5 domains.");
+	return providerTool("web_search", "Search the web", {
+		type: "web_search",
+		...config
+	});
 }
 function grokXSearchTool(config = {}) {
-  if (config.allowed_x_handles !== void 0 && config.excluded_x_handles !== void 0) {
-    throw new Error(
-      "allowed_x_handles and excluded_x_handles cannot both be provided."
-    );
-  }
-  if (config.allowed_x_handles !== void 0 && config.allowed_x_handles.length > 20) {
-    throw new Error("allowed_x_handles supports at most 20 handles.");
-  }
-  if (config.excluded_x_handles !== void 0 && config.excluded_x_handles.length > 20) {
-    throw new Error("excluded_x_handles supports at most 20 handles.");
-  }
-  return providerTool("x_search", "Search X posts", {
-    type: "x_search",
-    ...config
-  });
+	if (config.allowed_x_handles !== void 0 && config.excluded_x_handles !== void 0) throw new Error("allowed_x_handles and excluded_x_handles cannot both be provided.");
+	if (config.allowed_x_handles !== void 0 && config.allowed_x_handles.length > 20) throw new Error("allowed_x_handles supports at most 20 handles.");
+	if (config.excluded_x_handles !== void 0 && config.excluded_x_handles.length > 20) throw new Error("excluded_x_handles supports at most 20 handles.");
+	return providerTool("x_search", "Search X posts", {
+		type: "x_search",
+		...config
+	});
 }
 function grokFileSearchTool(config) {
-  if (config.vector_store_ids.length === 0) {
-    throw new Error("vector_store_ids must contain at least one collection id.");
-  }
-  if (config.max_num_results !== void 0) {
-    if (config.max_num_results < 1 || config.max_num_results > 50) {
-      throw new Error("max_num_results must be between 1 and 50.");
-    }
-  }
-  return providerTool("file_search", "Search xAI file collections", {
-    type: "file_search",
-    ...config
-  });
+	if (config.vector_store_ids.length === 0) throw new Error("vector_store_ids must contain at least one collection id.");
+	if (config.max_num_results !== void 0) {
+		if (config.max_num_results < 1 || config.max_num_results > 50) throw new Error("max_num_results must be between 1 and 50.");
+	}
+	return providerTool("file_search", "Search xAI file collections", {
+		type: "file_search",
+		...config
+	});
 }
 function grokMCPTool(config) {
-  if (!config.server_url) {
-    throw new Error("server_url must be provided.");
-  }
-  return providerTool("mcp", config.server_description || "Remote MCP server", {
-    type: "mcp",
-    ...config
-  });
+	if (!config.server_url) throw new Error("server_url must be provided.");
+	return providerTool("mcp", config.server_description || "Remote MCP server", {
+		type: "mcp",
+		...config
+	});
 }
 function getGrokProviderToolKind(tool) {
-  const kind = tool.metadata?.__kind;
-  switch (kind) {
-    case "grok.web_search":
-      return "web_search";
-    case "grok.x_search":
-      return "x_search";
-    case "grok.file_search":
-      return "file_search";
-    case "grok.mcp":
-      return "mcp";
-    default:
-      return void 0;
-  }
+	switch (tool.metadata?.__kind) {
+		case "grok.web_search": return "web_search";
+		case "grok.x_search": return "x_search";
+		case "grok.file_search": return "file_search";
+		case "grok.mcp": return "mcp";
+		default: return;
+	}
 }
 function convertGrokProviderToolToAdapterFormat(tool, kind) {
-  const metadata = tool.metadata;
-  if (metadata.type !== kind) {
-    throw new Error(
-      `convertGrokProviderToolToAdapterFormat: tool "${tool.name}" has mismatched Grok tool metadata.`
-    );
-  }
-  const { __kind: _kind, ...toolConfig } = metadata;
-  return toolConfig;
+	const metadata = tool.metadata;
+	if (metadata.type !== kind) throw new Error(`convertGrokProviderToolToAdapterFormat: tool "${tool.name}" has mismatched Grok tool metadata.`);
+	const { __kind: _kind, ...toolConfig } = metadata;
+	return toolConfig;
 }
 function convertToolsToProviderFormat(tools) {
-  return tools.map((tool) => {
-    const grokProviderToolKind = getGrokProviderToolKind(tool);
-    if (grokProviderToolKind) {
-      return convertGrokProviderToolToAdapterFormat(tool, grokProviderToolKind);
-    }
-    return convertFunctionToolToResponsesFormat(tool);
-  });
+	return tools.map((tool) => {
+		const grokProviderToolKind = getGrokProviderToolKind(tool);
+		if (grokProviderToolKind) return convertGrokProviderToolToAdapterFormat(tool, grokProviderToolKind);
+		return convertFunctionToolToResponsesFormat(tool);
+	});
 }
-export {
-  convertFunctionToolToResponsesFormat2 as convertFunctionToolToAdapterFormat,
-  convertToolsToProviderFormat,
-  grokFileSearchTool,
-  grokMCPTool,
-  grokWebSearchTool,
-  grokXSearchTool
-};
-//# sourceMappingURL=index.js.map
+//#endregion
+export { convertFunctionToolToResponsesFormat as convertFunctionToolToAdapterFormat, convertToolsToProviderFormat, grokFileSearchTool, grokMCPTool, grokWebSearchTool, grokXSearchTool };
+
+//# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../../../src/tools/index.ts"],"sourcesContent":["import { brandProviderTool } from '@tanstack/ai'\nimport { convertFunctionToolToResponsesFormat } from '@tanstack/openai-base'\nimport type { ProviderTool, Tool } from '@tanstack/ai'\nimport type { ResponsesFunctionTool } from '@tanstack/openai-base'\nimport type { GrokProviderToolKind } from '../model-meta'\n\nexport type FunctionTool = ResponsesFunctionTool\n\nexport { convertFunctionToolToResponsesFormat as convertFunctionToolToAdapterFormat }\n\nexport type GrokProviderTool<TKind extends GrokProviderToolKind> = ProviderTool<\n  'grok',\n  TKind\n>\n\ntype GrokToolKindMarker<TKind extends GrokProviderToolKind> = `grok.${TKind}`\n\nexport interface GrokWebSearchToolConfig {\n  type: 'web_search'\n  filters?: {\n    allowed_domains?: Array<string>\n    excluded_domains?: Array<string>\n  }\n  enable_image_understanding?: boolean\n  enable_image_search?: boolean\n}\n\nexport interface GrokXSearchToolConfig {\n  type: 'x_search'\n  allowed_x_handles?: Array<string>\n  excluded_x_handles?: Array<string>\n  from_date?: string\n  to_date?: string\n  enable_image_understanding?: boolean\n  enable_video_understanding?: boolean\n}\n\nexport interface GrokFileSearchToolConfig {\n  type: 'file_search'\n  vector_store_ids: Array<string>\n  max_num_results?: number\n}\n\nexport interface GrokMCPToolConfig {\n  type: 'mcp'\n  server_label: string\n  server_url: string\n  allowed_tools?: Array<string>\n  server_description?: string\n  authorization?: string\n  headers?: Record<string, string>\n}\n\nexport type GrokServerTool =\n  | GrokWebSearchToolConfig\n  | GrokXSearchToolConfig\n  | GrokFileSearchToolConfig\n  | GrokMCPToolConfig\n\ntype GrokProviderToolMetadata<TKind extends GrokProviderToolKind> = Extract<\n  GrokServerTool,\n  { type: TKind }\n> & {\n  __kind: GrokToolKindMarker<TKind>\n}\n\nexport type GrokResponsesTool = GrokServerTool | ResponsesFunctionTool\n\nfunction providerTool<TKind extends GrokProviderToolKind>(\n  kind: TKind,\n  description: string,\n  metadata: Extract<GrokServerTool, { type: TKind }>,\n): GrokProviderTool<TKind> {\n  return brandProviderTool<GrokProviderTool<TKind>>({\n    name: kind,\n    description,\n    metadata: {\n      __kind: `grok.${kind}`,\n      ...metadata,\n    },\n  })\n}\n\nexport function grokWebSearchTool(\n  config: Omit<GrokWebSearchToolConfig, 'type'> = {},\n): GrokProviderTool<'web_search'> {\n  if (\n    config.filters?.allowed_domains !== undefined &&\n    config.filters.excluded_domains !== undefined\n  ) {\n    throw new Error(\n      'allowed_domains and excluded_domains cannot both be provided.',\n    )\n  }\n  if (\n    config.filters?.allowed_domains !== undefined &&\n    config.filters.allowed_domains.length > 5\n  ) {\n    throw new Error('allowed_domains supports at most 5 domains.')\n  }\n  if (\n    config.filters?.excluded_domains !== undefined &&\n    config.filters.excluded_domains.length > 5\n  ) {\n    throw new Error('excluded_domains supports at most 5 domains.')\n  }\n  return providerTool('web_search', 'Search the web', {\n    type: 'web_search',\n    ...config,\n  })\n}\n\nexport function grokXSearchTool(\n  config: Omit<GrokXSearchToolConfig, 'type'> = {},\n): GrokProviderTool<'x_search'> {\n  if (\n    config.allowed_x_handles !== undefined &&\n    config.excluded_x_handles !== undefined\n  ) {\n    throw new Error(\n      'allowed_x_handles and excluded_x_handles cannot both be provided.',\n    )\n  }\n  if (\n    config.allowed_x_handles !== undefined &&\n    config.allowed_x_handles.length > 20\n  ) {\n    throw new Error('allowed_x_handles supports at most 20 handles.')\n  }\n  if (\n    config.excluded_x_handles !== undefined &&\n    config.excluded_x_handles.length > 20\n  ) {\n    throw new Error('excluded_x_handles supports at most 20 handles.')\n  }\n  return providerTool('x_search', 'Search X posts', {\n    type: 'x_search',\n    ...config,\n  })\n}\n\nexport function grokFileSearchTool(\n  config: Omit<GrokFileSearchToolConfig, 'type'>,\n): GrokProviderTool<'file_search'> {\n  if (config.vector_store_ids.length === 0) {\n    throw new Error('vector_store_ids must contain at least one collection id.')\n  }\n  if (config.max_num_results !== undefined) {\n    if (config.max_num_results < 1 || config.max_num_results > 50) {\n      throw new Error('max_num_results must be between 1 and 50.')\n    }\n  }\n  return providerTool('file_search', 'Search xAI file collections', {\n    type: 'file_search',\n    ...config,\n  })\n}\n\nexport function grokMCPTool(\n  config: Omit<GrokMCPToolConfig, 'type'>,\n): GrokProviderTool<'mcp'> {\n  if (!config.server_url) {\n    throw new Error('server_url must be provided.')\n  }\n  return providerTool('mcp', config.server_description || 'Remote MCP server', {\n    type: 'mcp',\n    ...config,\n  })\n}\n\nfunction getGrokProviderToolKind(tool: Tool): GrokProviderToolKind | undefined {\n  const kind = (tool.metadata as { __kind?: unknown } | undefined)?.__kind\n  switch (kind) {\n    case 'grok.web_search':\n      return 'web_search'\n    case 'grok.x_search':\n      return 'x_search'\n    case 'grok.file_search':\n      return 'file_search'\n    case 'grok.mcp':\n      return 'mcp'\n    default:\n      return undefined\n  }\n}\n\nfunction convertGrokProviderToolToAdapterFormat(\n  tool: Tool,\n  kind: GrokProviderToolKind,\n): GrokServerTool {\n  const metadata = tool.metadata as GrokProviderToolMetadata<typeof kind>\n  if (metadata.type !== kind) {\n    throw new Error(\n      `convertGrokProviderToolToAdapterFormat: tool \"${tool.name}\" has mismatched Grok tool metadata.`,\n    )\n  }\n  const { __kind: _kind, ...toolConfig } = metadata\n  void _kind\n  return toolConfig\n}\n\nexport function convertToolsToProviderFormat(\n  tools: Array<Tool>,\n): Array<GrokResponsesTool> {\n  return tools.map((tool) => {\n    const grokProviderToolKind = getGrokProviderToolKind(tool)\n    if (grokProviderToolKind) {\n      return convertGrokProviderToolToAdapterFormat(tool, grokProviderToolKind)\n    }\n    return convertFunctionToolToResponsesFormat(tool)\n  })\n}\n"],"names":[],"mappings":";;;AAoEA,SAAS,aACP,MACA,aACA,UACyB;AACzB,SAAO,kBAA2C;AAAA,IAChD,MAAM;AAAA,IACN;AAAA,IACA,UAAU;AAAA,MACR,QAAQ,QAAQ,IAAI;AAAA,MACpB,GAAG;AAAA,IAAA;AAAA,EACL,CACD;AACH;AAEO,SAAS,kBACd,SAAgD,IAChB;AAChC,MACE,OAAO,SAAS,oBAAoB,UACpC,OAAO,QAAQ,qBAAqB,QACpC;AACA,UAAM,IAAI;AAAA,MACR;AAAA,IAAA;AAAA,EAEJ;AACA,MACE,OAAO,SAAS,oBAAoB,UACpC,OAAO,QAAQ,gBAAgB,SAAS,GACxC;AACA,UAAM,IAAI,MAAM,6CAA6C;AAAA,EAC/D;AACA,MACE,OAAO,SAAS,qBAAqB,UACrC,OAAO,QAAQ,iBAAiB,SAAS,GACzC;AACA,UAAM,IAAI,MAAM,8CAA8C;AAAA,EAChE;AACA,SAAO,aAAa,cAAc,kBAAkB;AAAA,IAClD,MAAM;AAAA,IACN,GAAG;AAAA,EAAA,CACJ;AACH;AAEO,SAAS,gBACd,SAA8C,IAChB;AAC9B,MACE,OAAO,sBAAsB,UAC7B,OAAO,uBAAuB,QAC9B;AACA,UAAM,IAAI;AAAA,MACR;AAAA,IAAA;AAAA,EAEJ;AACA,MACE,OAAO,sBAAsB,UAC7B,OAAO,kBAAkB,SAAS,IAClC;AACA,UAAM,IAAI,MAAM,gDAAgD;AAAA,EAClE;AACA,MACE,OAAO,uBAAuB,UAC9B,OAAO,mBAAmB,SAAS,IACnC;AACA,UAAM,IAAI,MAAM,iDAAiD;AAAA,EACnE;AACA,SAAO,aAAa,YAAY,kBAAkB;AAAA,IAChD,MAAM;AAAA,IACN,GAAG;AAAA,EAAA,CACJ;AACH;AAEO,SAAS,mBACd,QACiC;AACjC,MAAI,OAAO,iBAAiB,WAAW,GAAG;AACxC,UAAM,IAAI,MAAM,2DAA2D;AAAA,EAC7E;AACA,MAAI,OAAO,oBAAoB,QAAW;AACxC,QAAI,OAAO,kBAAkB,KAAK,OAAO,kBAAkB,IAAI;AAC7D,YAAM,IAAI,MAAM,2CAA2C;AAAA,IAC7D;AAAA,EACF;AACA,SAAO,aAAa,eAAe,+BAA+B;AAAA,IAChE,MAAM;AAAA,IACN,GAAG;AAAA,EAAA,CACJ;AACH;AAEO,SAAS,YACd,QACyB;AACzB,MAAI,CAAC,OAAO,YAAY;AACtB,UAAM,IAAI,MAAM,8BAA8B;AAAA,EAChD;AACA,SAAO,aAAa,OAAO,OAAO,sBAAsB,qBAAqB;AAAA,IAC3E,MAAM;AAAA,IACN,GAAG;AAAA,EAAA,CACJ;AACH;AAEA,SAAS,wBAAwB,MAA8C;AAC7E,QAAM,OAAQ,KAAK,UAA+C;AAClE,UAAQ,MAAA;AAAA,IACN,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT;AACE,aAAO;AAAA,EAAA;AAEb;AAEA,SAAS,uCACP,MACA,MACgB;AAChB,QAAM,WAAW,KAAK;AACtB,MAAI,SAAS,SAAS,MAAM;AAC1B,UAAM,IAAI;AAAA,MACR,iDAAiD,KAAK,IAAI;AAAA,IAAA;AAAA,EAE9D;AACA,QAAM,EAAE,QAAQ,OAAO,GAAG,eAAe;AAEzC,SAAO;AACT;AAEO,SAAS,6BACd,OAC0B;AAC1B,SAAO,MAAM,IAAI,CAAC,SAAS;AACzB,UAAM,uBAAuB,wBAAwB,IAAI;AACzD,QAAI,sBAAsB;AACxB,aAAO,uCAAuC,MAAM,oBAAoB;AAAA,IAC1E;AACA,WAAO,qCAAqC,IAAI;AAAA,EAClD,CAAC;AACH;"}
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/tools/index.ts"],"sourcesContent":["import { brandProviderTool } from '@tanstack/ai'\nimport { convertFunctionToolToResponsesFormat } from '@tanstack/openai-base'\nimport type { ProviderTool, Tool } from '@tanstack/ai'\nimport type { ResponsesFunctionTool } from '@tanstack/openai-base'\nimport type { GrokProviderToolKind } from '../model-meta'\n\nexport type FunctionTool = ResponsesFunctionTool\n\nexport { convertFunctionToolToResponsesFormat as convertFunctionToolToAdapterFormat }\n\nexport type GrokProviderTool<TKind extends GrokProviderToolKind> = ProviderTool<\n  'grok',\n  TKind\n>\n\ntype GrokToolKindMarker<TKind extends GrokProviderToolKind> = `grok.${TKind}`\n\nexport interface GrokWebSearchToolConfig {\n  type: 'web_search'\n  filters?: {\n    allowed_domains?: Array<string>\n    excluded_domains?: Array<string>\n  }\n  enable_image_understanding?: boolean\n  enable_image_search?: boolean\n}\n\nexport interface GrokXSearchToolConfig {\n  type: 'x_search'\n  allowed_x_handles?: Array<string>\n  excluded_x_handles?: Array<string>\n  from_date?: string\n  to_date?: string\n  enable_image_understanding?: boolean\n  enable_video_understanding?: boolean\n}\n\nexport interface GrokFileSearchToolConfig {\n  type: 'file_search'\n  vector_store_ids: Array<string>\n  max_num_results?: number\n}\n\nexport interface GrokMCPToolConfig {\n  type: 'mcp'\n  server_label: string\n  server_url: string\n  allowed_tools?: Array<string>\n  server_description?: string\n  authorization?: string\n  headers?: Record<string, string>\n}\n\nexport type GrokServerTool =\n  | GrokWebSearchToolConfig\n  | GrokXSearchToolConfig\n  | GrokFileSearchToolConfig\n  | GrokMCPToolConfig\n\ntype GrokProviderToolMetadata<TKind extends GrokProviderToolKind> = Extract<\n  GrokServerTool,\n  { type: TKind }\n> & {\n  __kind: GrokToolKindMarker<TKind>\n}\n\nexport type GrokResponsesTool = GrokServerTool | ResponsesFunctionTool\n\nfunction providerTool<TKind extends GrokProviderToolKind>(\n  kind: TKind,\n  description: string,\n  metadata: Extract<GrokServerTool, { type: TKind }>,\n): GrokProviderTool<TKind> {\n  return brandProviderTool<GrokProviderTool<TKind>>({\n    name: kind,\n    description,\n    metadata: {\n      __kind: `grok.${kind}`,\n      ...metadata,\n    },\n  })\n}\n\nexport function grokWebSearchTool(\n  config: Omit<GrokWebSearchToolConfig, 'type'> = {},\n): GrokProviderTool<'web_search'> {\n  if (\n    config.filters?.allowed_domains !== undefined &&\n    config.filters.excluded_domains !== undefined\n  ) {\n    throw new Error(\n      'allowed_domains and excluded_domains cannot both be provided.',\n    )\n  }\n  if (\n    config.filters?.allowed_domains !== undefined &&\n    config.filters.allowed_domains.length > 5\n  ) {\n    throw new Error('allowed_domains supports at most 5 domains.')\n  }\n  if (\n    config.filters?.excluded_domains !== undefined &&\n    config.filters.excluded_domains.length > 5\n  ) {\n    throw new Error('excluded_domains supports at most 5 domains.')\n  }\n  return providerTool('web_search', 'Search the web', {\n    type: 'web_search',\n    ...config,\n  })\n}\n\nexport function grokXSearchTool(\n  config: Omit<GrokXSearchToolConfig, 'type'> = {},\n): GrokProviderTool<'x_search'> {\n  if (\n    config.allowed_x_handles !== undefined &&\n    config.excluded_x_handles !== undefined\n  ) {\n    throw new Error(\n      'allowed_x_handles and excluded_x_handles cannot both be provided.',\n    )\n  }\n  if (\n    config.allowed_x_handles !== undefined &&\n    config.allowed_x_handles.length > 20\n  ) {\n    throw new Error('allowed_x_handles supports at most 20 handles.')\n  }\n  if (\n    config.excluded_x_handles !== undefined &&\n    config.excluded_x_handles.length > 20\n  ) {\n    throw new Error('excluded_x_handles supports at most 20 handles.')\n  }\n  return providerTool('x_search', 'Search X posts', {\n    type: 'x_search',\n    ...config,\n  })\n}\n\nexport function grokFileSearchTool(\n  config: Omit<GrokFileSearchToolConfig, 'type'>,\n): GrokProviderTool<'file_search'> {\n  if (config.vector_store_ids.length === 0) {\n    throw new Error('vector_store_ids must contain at least one collection id.')\n  }\n  if (config.max_num_results !== undefined) {\n    if (config.max_num_results < 1 || config.max_num_results > 50) {\n      throw new Error('max_num_results must be between 1 and 50.')\n    }\n  }\n  return providerTool('file_search', 'Search xAI file collections', {\n    type: 'file_search',\n    ...config,\n  })\n}\n\nexport function grokMCPTool(\n  config: Omit<GrokMCPToolConfig, 'type'>,\n): GrokProviderTool<'mcp'> {\n  if (!config.server_url) {\n    throw new Error('server_url must be provided.')\n  }\n  return providerTool('mcp', config.server_description || 'Remote MCP server', {\n    type: 'mcp',\n    ...config,\n  })\n}\n\nfunction getGrokProviderToolKind(tool: Tool): GrokProviderToolKind | undefined {\n  const kind = (tool.metadata as { __kind?: unknown } | undefined)?.__kind\n  switch (kind) {\n    case 'grok.web_search':\n      return 'web_search'\n    case 'grok.x_search':\n      return 'x_search'\n    case 'grok.file_search':\n      return 'file_search'\n    case 'grok.mcp':\n      return 'mcp'\n    default:\n      return undefined\n  }\n}\n\nfunction convertGrokProviderToolToAdapterFormat(\n  tool: Tool,\n  kind: GrokProviderToolKind,\n): GrokServerTool {\n  const metadata = tool.metadata as GrokProviderToolMetadata<typeof kind>\n  if (metadata.type !== kind) {\n    throw new Error(\n      `convertGrokProviderToolToAdapterFormat: tool \"${tool.name}\" has mismatched Grok tool metadata.`,\n    )\n  }\n  const { __kind: _kind, ...toolConfig } = metadata\n  void _kind\n  return toolConfig\n}\n\nexport function convertToolsToProviderFormat(\n  tools: Array<Tool>,\n): Array<GrokResponsesTool> {\n  return tools.map((tool) => {\n    const grokProviderToolKind = getGrokProviderToolKind(tool)\n    if (grokProviderToolKind) {\n      return convertGrokProviderToolToAdapterFormat(tool, grokProviderToolKind)\n    }\n    return convertFunctionToolToResponsesFormat(tool)\n  })\n}\n"],"mappings":";;;AAoEA,SAAS,aACP,MACA,aACA,UACyB;CACzB,OAAO,kBAA2C;EAChD,MAAM;EACN;EACA,UAAU;GACR,QAAQ,QAAQ;GAChB,GAAG;EACL;CACF,CAAC;AACH;AAEA,SAAgB,kBACd,SAAgD,CAAC,GACjB;CAChC,IACE,OAAO,SAAS,oBAAoB,KAAA,KACpC,OAAO,QAAQ,qBAAqB,KAAA,GAEpC,MAAM,IAAI,MACR,+DACF;CAEF,IACE,OAAO,SAAS,oBAAoB,KAAA,KACpC,OAAO,QAAQ,gBAAgB,SAAS,GAExC,MAAM,IAAI,MAAM,6CAA6C;CAE/D,IACE,OAAO,SAAS,qBAAqB,KAAA,KACrC,OAAO,QAAQ,iBAAiB,SAAS,GAEzC,MAAM,IAAI,MAAM,8CAA8C;CAEhE,OAAO,aAAa,cAAc,kBAAkB;EAClD,MAAM;EACN,GAAG;CACL,CAAC;AACH;AAEA,SAAgB,gBACd,SAA8C,CAAC,GACjB;CAC9B,IACE,OAAO,sBAAsB,KAAA,KAC7B,OAAO,uBAAuB,KAAA,GAE9B,MAAM,IAAI,MACR,mEACF;CAEF,IACE,OAAO,sBAAsB,KAAA,KAC7B,OAAO,kBAAkB,SAAS,IAElC,MAAM,IAAI,MAAM,gDAAgD;CAElE,IACE,OAAO,uBAAuB,KAAA,KAC9B,OAAO,mBAAmB,SAAS,IAEnC,MAAM,IAAI,MAAM,iDAAiD;CAEnE,OAAO,aAAa,YAAY,kBAAkB;EAChD,MAAM;EACN,GAAG;CACL,CAAC;AACH;AAEA,SAAgB,mBACd,QACiC;CACjC,IAAI,OAAO,iBAAiB,WAAW,GACrC,MAAM,IAAI,MAAM,2DAA2D;CAE7E,IAAI,OAAO,oBAAoB,KAAA;MACzB,OAAO,kBAAkB,KAAK,OAAO,kBAAkB,IACzD,MAAM,IAAI,MAAM,2CAA2C;CAAA;CAG/D,OAAO,aAAa,eAAe,+BAA+B;EAChE,MAAM;EACN,GAAG;CACL,CAAC;AACH;AAEA,SAAgB,YACd,QACyB;CACzB,IAAI,CAAC,OAAO,YACV,MAAM,IAAI,MAAM,8BAA8B;CAEhD,OAAO,aAAa,OAAO,OAAO,sBAAsB,qBAAqB;EAC3E,MAAM;EACN,GAAG;CACL,CAAC;AACH;AAEA,SAAS,wBAAwB,MAA8C;CAE7E,QADc,KAAK,UAA+C,QAClE;EACE,KAAK,mBACH,OAAO;EACT,KAAK,iBACH,OAAO;EACT,KAAK,oBACH,OAAO;EACT,KAAK,YACH,OAAO;EACT,SACE;CACJ;AACF;AAEA,SAAS,uCACP,MACA,MACgB;CAChB,MAAM,WAAW,KAAK;CACtB,IAAI,SAAS,SAAS,MACpB,MAAM,IAAI,MACR,iDAAiD,KAAK,KAAK,qCAC7D;CAEF,MAAM,EAAE,QAAQ,OAAO,GAAG,eAAe;CAEzC,OAAO;AACT;AAEA,SAAgB,6BACd,OAC0B;CAC1B,OAAO,MAAM,KAAK,SAAS;EACzB,MAAM,uBAAuB,wBAAwB,IAAI;EACzD,IAAI,sBACF,OAAO,uCAAuC,MAAM,oBAAoB;EAE1E,OAAO,qCAAqC,IAAI;CAClD,CAAC;AACH"}

package/dist/esm/utils/audio.js

@@ -1,172 +1,126 @@
+//#region src/utils/audio.ts
+/**
+* Coerce the various audio input shapes accepted by `TranscriptionOptions.audio`
+* into a `File` suitable for `multipart/form-data` uploads.
+*
+* For base64 string inputs we require an explicit MIME type — either via a
+* `data:<mime>;base64,<payload>` URI prefix, or via the caller-provided
+* `audioFormat` parameter. Bare base64 without either is rejected, because
+* silently defaulting to `audio/mpeg` misreports non-mp3 audio to the server.
+*
+* The same rule applies to raw `ArrayBuffer` inputs: the caller must supply
+* an `audioFormat` so we know what MIME type and extension to use.
+*/
 function toAudioFile(audio, audioFormat) {
-  if (typeof File !== "undefined" && audio instanceof File) {
-    if (audioFormat) {
-      const mimeType = toMimeType(audioFormat);
-      return new File([audio], `audio.${extensionFor(mimeType)}`, {
-        type: mimeType
-      });
-    }
-    if (audio.type) {
-      return audio;
-    }
-    throw new Error(
-      'toAudioFile cannot infer type for File input with empty .type — pass an explicit audioFormat (e.g. "mp3", "wav", "audio/mpeg")'
-    );
-  }
-  if (typeof Blob !== "undefined" && audio instanceof Blob) {
-    const mimeType = audioFormat ? toMimeType(audioFormat) : audio.type || void 0;
-    if (!mimeType) {
-      throw new Error(
-        'toAudioFile cannot infer type for Blob input with empty .type — pass an explicit audioFormat (e.g. "mp3", "wav", "audio/mpeg")'
-      );
-    }
-    return new File([audio], `audio.${extensionFor(mimeType)}`, {
-      type: mimeType
-    });
-  }
-  if (audio instanceof ArrayBuffer) {
-    if (!audioFormat) {
-      throw new Error(
-        'toAudioFile cannot infer type for ArrayBuffer input — pass an explicit audioFormat (e.g. "mp3", "wav", "audio/mpeg")'
-      );
-    }
-    const mimeType = toMimeType(audioFormat);
-    return new File([audio], `audio.${extensionFor(mimeType)}`, {
-      type: mimeType
-    });
-  }
-  if (typeof audio === "string") {
-    if (audio.startsWith("data:")) {
-      const [header, base64Data] = audio.split(",");
-      const headerMatch = header?.match(/data:([^;]+)/);
-      const uriMimeType = headerMatch?.[1];
-      if (!uriMimeType) {
-        throw new Error(
-          "Malformed data: URI in toAudioFile: cannot parse MIME type — expected data:<mime>[;charset=…][;base64],<payload>"
-        );
-      }
-      if (base64Data === void 0 || base64Data.trim() === "") {
-        throw new Error(
-          "Malformed data: URI in toAudioFile: missing base64 payload after comma"
-        );
-      }
-      const mimeType2 = audioFormat ? toMimeType(audioFormat) : uriMimeType;
-      const buffer2 = base64ToArrayBuffer(base64Data);
-      return new File([buffer2], `audio.${extensionFor(mimeType2)}`, {
-        type: mimeType2
-      });
-    }
-    if (!audioFormat) {
-      throw new Error(
-        "toAudioFile requires a data: URI (e.g. data:audio/wav;base64,...) or an explicit audioFormat argument — bare base64 strings have no MIME type to infer"
-      );
-    }
-    const buffer = base64ToArrayBuffer(audio);
-    const mimeType = toMimeType(audioFormat);
-    return new File([buffer], `audio.${extensionFor(mimeType)}`, {
-      type: mimeType
-    });
-  }
-  throw new Error("Invalid audio input type");
+	if (typeof File !== "undefined" && audio instanceof File) {
+		if (audioFormat) {
+			const mimeType = toMimeType(audioFormat);
+			return new File([audio], `audio.${extensionFor(mimeType)}`, { type: mimeType });
+		}
+		if (audio.type) return audio;
+		throw new Error("toAudioFile cannot infer type for File input with empty .type — pass an explicit audioFormat (e.g. \"mp3\", \"wav\", \"audio/mpeg\")");
+	}
+	if (typeof Blob !== "undefined" && audio instanceof Blob) {
+		const mimeType = audioFormat ? toMimeType(audioFormat) : audio.type || void 0;
+		if (!mimeType) throw new Error("toAudioFile cannot infer type for Blob input with empty .type — pass an explicit audioFormat (e.g. \"mp3\", \"wav\", \"audio/mpeg\")");
+		return new File([audio], `audio.${extensionFor(mimeType)}`, { type: mimeType });
+	}
+	if (audio instanceof ArrayBuffer) {
+		if (!audioFormat) throw new Error("toAudioFile cannot infer type for ArrayBuffer input — pass an explicit audioFormat (e.g. \"mp3\", \"wav\", \"audio/mpeg\")");
+		const mimeType = toMimeType(audioFormat);
+		return new File([audio], `audio.${extensionFor(mimeType)}`, { type: mimeType });
+	}
+	if (typeof audio === "string") {
+		if (audio.startsWith("data:")) {
+			const [header, base64Data] = audio.split(",");
+			const uriMimeType = (header?.match(/data:([^;]+)/))?.[1];
+			if (!uriMimeType) throw new Error("Malformed data: URI in toAudioFile: cannot parse MIME type — expected data:<mime>[;charset=…][;base64],<payload>");
+			if (base64Data === void 0 || base64Data.trim() === "") throw new Error("Malformed data: URI in toAudioFile: missing base64 payload after comma");
+			const mimeType = audioFormat ? toMimeType(audioFormat) : uriMimeType;
+			const buffer = base64ToArrayBuffer(base64Data);
+			return new File([buffer], `audio.${extensionFor(mimeType)}`, { type: mimeType });
+		}
+		if (!audioFormat) throw new Error("toAudioFile requires a data: URI (e.g. data:audio/wav;base64,...) or an explicit audioFormat argument — bare base64 strings have no MIME type to infer");
+		const buffer = base64ToArrayBuffer(audio);
+		const mimeType = toMimeType(audioFormat);
+		return new File([buffer], `audio.${extensionFor(mimeType)}`, { type: mimeType });
+	}
+	throw new Error("Invalid audio input type");
 }
 function toMimeType(audioFormat) {
-  if (audioFormat.includes("/")) return audioFormat;
-  const ext = audioFormat.toLowerCase();
-  switch (ext) {
-    case "mp3":
-      return "audio/mpeg";
-    case "wav":
-      return "audio/wav";
-    case "ogg":
-      return "audio/ogg";
-    case "opus":
-      return "audio/opus";
-    case "flac":
-      return "audio/flac";
-    case "aac":
-      return "audio/aac";
-    case "mp4":
-      return "audio/mp4";
-    case "m4a":
-      return "audio/mp4";
-    case "webm":
-      return "audio/webm";
-    case "pcm":
-      return "audio/L16";
-    case "mulaw":
-      return "audio/basic";
-    case "alaw":
-      return "audio/x-alaw-basic";
-    default:
-      return `audio/${ext}`;
-  }
+	if (audioFormat.includes("/")) return audioFormat;
+	const ext = audioFormat.toLowerCase();
+	switch (ext) {
+		case "mp3": return "audio/mpeg";
+		case "wav": return "audio/wav";
+		case "ogg": return "audio/ogg";
+		case "opus": return "audio/opus";
+		case "flac": return "audio/flac";
+		case "aac": return "audio/aac";
+		case "mp4": return "audio/mp4";
+		case "m4a": return "audio/mp4";
+		case "webm": return "audio/webm";
+		case "pcm": return "audio/L16";
+		case "mulaw": return "audio/basic";
+		case "alaw": return "audio/x-alaw-basic";
+		default: return `audio/${ext}`;
+	}
 }
 function extensionFor(mimeType) {
-  switch (mimeType) {
-    case "audio/mpeg":
-      return "mp3";
-    case "audio/wav":
-    case "audio/x-wav":
-      return "wav";
-    case "audio/ogg":
-      return "ogg";
-    case "audio/opus":
-      return "opus";
-    case "audio/flac":
-      return "flac";
-    case "audio/aac":
-      return "aac";
-    case "audio/mp4":
-      return "m4a";
-    case "audio/webm":
-      return "webm";
-    case "audio/L16":
-      return "pcm";
-    case "audio/basic":
-      return "mulaw";
-    case "audio/x-alaw-basic":
-      return "alaw";
-    default: {
-      const slash = mimeType.indexOf("/");
-      if (slash === -1) return "bin";
-      return mimeType.slice(slash + 1) || "bin";
-    }
-  }
+	switch (mimeType) {
+		case "audio/mpeg": return "mp3";
+		case "audio/wav":
+		case "audio/x-wav": return "wav";
+		case "audio/ogg": return "ogg";
+		case "audio/opus": return "opus";
+		case "audio/flac": return "flac";
+		case "audio/aac": return "aac";
+		case "audio/mp4": return "m4a";
+		case "audio/webm": return "webm";
+		case "audio/L16": return "pcm";
+		case "audio/basic": return "mulaw";
+		case "audio/x-alaw-basic": return "alaw";
+		default: {
+			const slash = mimeType.indexOf("/");
+			if (slash === -1) return "bin";
+			return mimeType.slice(slash + 1) || "bin";
+		}
+	}
 }
+/**
+* Cross-runtime ArrayBuffer → base64 conversion.
+*
+* Uses Node's `Buffer` when available (fastest path on server) and falls
+* back to `btoa` + chunked `String.fromCharCode` everywhere else (browser,
+* Cloudflare Workers, Bun, Deno). Chunking is required because a very
+* large audio buffer spread into `String.fromCharCode(...bytes)` in one
+* call can hit `Maximum call stack size exceeded`.
+*/
 function arrayBufferToBase64(buffer) {
-  if (typeof Buffer !== "undefined") {
-    return Buffer.from(buffer).toString("base64");
-  }
-  const bytes = new Uint8Array(buffer);
-  const chunkSize = 32768;
-  let binary = "";
-  for (let i = 0; i < bytes.length; i += chunkSize) {
-    const end = Math.min(i + chunkSize, bytes.length);
-    binary += String.fromCharCode.apply(
-      null,
-      // eslint-disable-next-line no-restricted-syntax -- TS lib types String.fromCharCode.apply as Array<number> but runtime accepts any ArrayLike
-      bytes.subarray(i, end)
-    );
-  }
-  return btoa(binary);
+	if (typeof Buffer !== "undefined") return Buffer.from(buffer).toString("base64");
+	const bytes = new Uint8Array(buffer);
+	const chunkSize = 32768;
+	let binary = "";
+	for (let i = 0; i < bytes.length; i += chunkSize) {
+		const end = Math.min(i + chunkSize, bytes.length);
+		binary += String.fromCharCode.apply(null, bytes.subarray(i, end));
+	}
+	return btoa(binary);
 }
 function base64ToArrayBuffer(base64) {
-  let binary;
-  try {
-    binary = atob(base64);
-  } catch (err) {
-    const msg = err instanceof Error ? err.message : String(err);
-    throw new Error(`Invalid base64 input to toAudioFile: ${msg}`);
-  }
-  const buffer = new ArrayBuffer(binary.length);
-  const bytes = new Uint8Array(buffer);
-  for (let i = 0; i < binary.length; i++) {
-    bytes[i] = binary.charCodeAt(i);
-  }
-  return buffer;
+	let binary;
+	try {
+		binary = atob(base64);
+	} catch (err) {
+		const msg = err instanceof Error ? err.message : String(err);
+		throw new Error(`Invalid base64 input to toAudioFile: ${msg}`);
+	}
+	const buffer = new ArrayBuffer(binary.length);
+	const bytes = new Uint8Array(buffer);
+	for (let i = 0; i < binary.length; i++) bytes[i] = binary.charCodeAt(i);
+	return buffer;
 }
-export {
-  arrayBufferToBase64,
-  toAudioFile
-};
-//# sourceMappingURL=audio.js.map
+//#endregion
+export { arrayBufferToBase64, toAudioFile };
+
+//# sourceMappingURL=audio.js.map

package/dist/esm/utils/audio.js.map

@@ -1 +1 @@
-{"version":3,"file":"audio.js","sources":["../../../src/utils/audio.ts"],"sourcesContent":["/**\n * Coerce the various audio input shapes accepted by `TranscriptionOptions.audio`\n * into a `File` suitable for `multipart/form-data` uploads.\n *\n * For base64 string inputs we require an explicit MIME type — either via a\n * `data:<mime>;base64,<payload>` URI prefix, or via the caller-provided\n * `audioFormat` parameter. Bare base64 without either is rejected, because\n * silently defaulting to `audio/mpeg` misreports non-mp3 audio to the server.\n *\n * The same rule applies to raw `ArrayBuffer` inputs: the caller must supply\n * an `audioFormat` so we know what MIME type and extension to use.\n */\nexport function toAudioFile(\n  audio: string | File | Blob | ArrayBuffer,\n  audioFormat?: string,\n): File {\n  if (typeof File !== 'undefined' && audio instanceof File) {\n    // Prefer the caller-supplied `audioFormat` over a potentially empty or\n    // incorrect `File.type` — callers pass `audioFormat` precisely because\n    // they have more context than the browser does about the payload. If\n    // neither is set, fall through to the Blob-style error path below.\n    if (audioFormat) {\n      const mimeType = toMimeType(audioFormat)\n      return new File([audio], `audio.${extensionFor(mimeType)}`, {\n        type: mimeType,\n      })\n    }\n    if (audio.type) {\n      return audio\n    }\n    throw new Error(\n      'toAudioFile cannot infer type for File input with empty .type — pass an explicit audioFormat (e.g. \"mp3\", \"wav\", \"audio/mpeg\")',\n    )\n  }\n\n  if (typeof Blob !== 'undefined' && audio instanceof Blob) {\n    // Mirror the ArrayBuffer / bare-base64 paths: prefer the explicit\n    // audioFormat argument over the Blob's (often empty) .type. We refuse to\n    // fall back to `application/octet-stream` because that mislabels audio\n    // for the server.\n    const mimeType = audioFormat\n      ? toMimeType(audioFormat)\n      : audio.type || undefined\n    if (!mimeType) {\n      throw new Error(\n        'toAudioFile cannot infer type for Blob input with empty .type — pass an explicit audioFormat (e.g. \"mp3\", \"wav\", \"audio/mpeg\")',\n      )\n    }\n    return new File([audio], `audio.${extensionFor(mimeType)}`, {\n      type: mimeType,\n    })\n  }\n\n  if (audio instanceof ArrayBuffer) {\n    if (!audioFormat) {\n      throw new Error(\n        'toAudioFile cannot infer type for ArrayBuffer input — pass an explicit audioFormat (e.g. \"mp3\", \"wav\", \"audio/mpeg\")',\n      )\n    }\n    const mimeType = toMimeType(audioFormat)\n    return new File([audio], `audio.${extensionFor(mimeType)}`, {\n      type: mimeType,\n    })\n  }\n\n  if (typeof audio === 'string') {\n    if (audio.startsWith('data:')) {\n      const [header, base64Data] = audio.split(',')\n      // Fail loudly on malformed data: URIs instead of silently defaulting\n      // to `audio/mpeg` — the file's contract is that we never mislabel\n      // audio for the server.\n      const headerMatch = header?.match(/data:([^;]+)/)\n      const uriMimeType = headerMatch?.[1]\n      if (!uriMimeType) {\n        throw new Error(\n          'Malformed data: URI in toAudioFile: cannot parse MIME type — expected data:<mime>[;charset=…][;base64],<payload>',\n        )\n      }\n      if (base64Data === undefined || base64Data.trim() === '') {\n        throw new Error(\n          'Malformed data: URI in toAudioFile: missing base64 payload after comma',\n        )\n      }\n      // Caller-supplied `audioFormat` wins over the URI-embedded MIME: the\n      // caller has more context (the URI MIME may be wrong, or a generic\n      // `application/octet-stream`).\n      const mimeType = audioFormat ? toMimeType(audioFormat) : uriMimeType\n      const buffer = base64ToArrayBuffer(base64Data)\n      return new File([buffer], `audio.${extensionFor(mimeType)}`, {\n        type: mimeType,\n      })\n    }\n\n    if (!audioFormat) {\n      throw new Error(\n        'toAudioFile requires a data: URI (e.g. data:audio/wav;base64,...) or an explicit audioFormat argument — bare base64 strings have no MIME type to infer',\n      )\n    }\n\n    const buffer = base64ToArrayBuffer(audio)\n    const mimeType = toMimeType(audioFormat)\n    return new File([buffer], `audio.${extensionFor(mimeType)}`, {\n      type: mimeType,\n    })\n  }\n\n  throw new Error('Invalid audio input type')\n}\n\nfunction toMimeType(audioFormat: string): string {\n  // Accept either \"audio/…\" strings or bare extensions like \"mp3\".\n  if (audioFormat.includes('/')) return audioFormat\n  const ext = audioFormat.toLowerCase()\n  switch (ext) {\n    case 'mp3':\n      return 'audio/mpeg'\n    case 'wav':\n      return 'audio/wav'\n    case 'ogg':\n      return 'audio/ogg'\n    case 'opus':\n      return 'audio/opus'\n    case 'flac':\n      return 'audio/flac'\n    case 'aac':\n      return 'audio/aac'\n    case 'mp4':\n      return 'audio/mp4'\n    case 'm4a':\n      return 'audio/mp4'\n    case 'webm':\n      return 'audio/webm'\n    case 'pcm':\n      return 'audio/L16'\n    case 'mulaw':\n      return 'audio/basic'\n    case 'alaw':\n      return 'audio/x-alaw-basic'\n    default:\n      return `audio/${ext}`\n  }\n}\n\nfunction extensionFor(mimeType: string): string {\n  switch (mimeType) {\n    case 'audio/mpeg':\n      return 'mp3'\n    case 'audio/wav':\n    case 'audio/x-wav':\n      return 'wav'\n    case 'audio/ogg':\n      return 'ogg'\n    case 'audio/opus':\n      return 'opus'\n    case 'audio/flac':\n      return 'flac'\n    case 'audio/aac':\n      return 'aac'\n    case 'audio/mp4':\n      return 'm4a'\n    case 'audio/webm':\n      return 'webm'\n    case 'audio/L16':\n      return 'pcm'\n    case 'audio/basic':\n      return 'mulaw'\n    case 'audio/x-alaw-basic':\n      return 'alaw'\n    default: {\n      const slash = mimeType.indexOf('/')\n      if (slash === -1) return 'bin'\n      return mimeType.slice(slash + 1) || 'bin'\n    }\n  }\n}\n\n/**\n * Cross-runtime ArrayBuffer → base64 conversion.\n *\n * Uses Node's `Buffer` when available (fastest path on server) and falls\n * back to `btoa` + chunked `String.fromCharCode` everywhere else (browser,\n * Cloudflare Workers, Bun, Deno). Chunking is required because a very\n * large audio buffer spread into `String.fromCharCode(...bytes)` in one\n * call can hit `Maximum call stack size exceeded`.\n */\nexport function arrayBufferToBase64(buffer: ArrayBuffer): string {\n  if (typeof Buffer !== 'undefined') {\n    return Buffer.from(buffer).toString('base64')\n  }\n  const bytes = new Uint8Array(buffer)\n  const chunkSize = 0x8000\n  let binary = ''\n  for (let i = 0; i < bytes.length; i += chunkSize) {\n    const end = Math.min(i + chunkSize, bytes.length)\n    binary += String.fromCharCode.apply(\n      null,\n      // eslint-disable-next-line no-restricted-syntax -- TS lib types String.fromCharCode.apply as Array<number> but runtime accepts any ArrayLike\n      bytes.subarray(i, end) as unknown as Array<number>,\n    )\n  }\n  return btoa(binary)\n}\n\nfunction base64ToArrayBuffer(base64: string): ArrayBuffer {\n  let binary: string\n  try {\n    binary = atob(base64)\n  } catch (err) {\n    const msg = err instanceof Error ? err.message : String(err)\n    throw new Error(`Invalid base64 input to toAudioFile: ${msg}`)\n  }\n  const buffer = new ArrayBuffer(binary.length)\n  const bytes = new Uint8Array(buffer)\n  for (let i = 0; i < binary.length; i++) {\n    bytes[i] = binary.charCodeAt(i)\n  }\n  return buffer\n}\n"],"names":["mimeType","buffer"],"mappings":"AAYO,SAAS,YACd,OACA,aACM;AACN,MAAI,OAAO,SAAS,eAAe,iBAAiB,MAAM;AAKxD,QAAI,aAAa;AACf,YAAM,WAAW,WAAW,WAAW;AACvC,aAAO,IAAI,KAAK,CAAC,KAAK,GAAG,SAAS,aAAa,QAAQ,CAAC,IAAI;AAAA,QAC1D,MAAM;AAAA,MAAA,CACP;AAAA,IACH;AACA,QAAI,MAAM,MAAM;AACd,aAAO;AAAA,IACT;AACA,UAAM,IAAI;AAAA,MACR;AAAA,IAAA;AAAA,EAEJ;AAEA,MAAI,OAAO,SAAS,eAAe,iBAAiB,MAAM;AAKxD,UAAM,WAAW,cACb,WAAW,WAAW,IACtB,MAAM,QAAQ;AAClB,QAAI,CAAC,UAAU;AACb,YAAM,IAAI;AAAA,QACR;AAAA,MAAA;AAAA,IAEJ;AACA,WAAO,IAAI,KAAK,CAAC,KAAK,GAAG,SAAS,aAAa,QAAQ,CAAC,IAAI;AAAA,MAC1D,MAAM;AAAA,IAAA,CACP;AAAA,EACH;AAEA,MAAI,iBAAiB,aAAa;AAChC,QAAI,CAAC,aAAa;AAChB,YAAM,IAAI;AAAA,QACR;AAAA,MAAA;AAAA,IAEJ;AACA,UAAM,WAAW,WAAW,WAAW;AACvC,WAAO,IAAI,KAAK,CAAC,KAAK,GAAG,SAAS,aAAa,QAAQ,CAAC,IAAI;AAAA,MAC1D,MAAM;AAAA,IAAA,CACP;AAAA,EACH;AAEA,MAAI,OAAO,UAAU,UAAU;AAC7B,QAAI,MAAM,WAAW,OAAO,GAAG;AAC7B,YAAM,CAAC,QAAQ,UAAU,IAAI,MAAM,MAAM,GAAG;AAI5C,YAAM,cAAc,QAAQ,MAAM,cAAc;AAChD,YAAM,cAAc,cAAc,CAAC;AACnC,UAAI,CAAC,aAAa;AAChB,cAAM,IAAI;AAAA,UACR;AAAA,QAAA;AAAA,MAEJ;AACA,UAAI,eAAe,UAAa,WAAW,KAAA,MAAW,IAAI;AACxD,cAAM,IAAI;AAAA,UACR;AAAA,QAAA;AAAA,MAEJ;AAIA,YAAMA,YAAW,cAAc,WAAW,WAAW,IAAI;AACzD,YAAMC,UAAS,oBAAoB,UAAU;AAC7C,aAAO,IAAI,KAAK,CAACA,OAAM,GAAG,SAAS,aAAaD,SAAQ,CAAC,IAAI;AAAA,QAC3D,MAAMA;AAAAA,MAAA,CACP;AAAA,IACH;AAEA,QAAI,CAAC,aAAa;AAChB,YAAM,IAAI;AAAA,QACR;AAAA,MAAA;AAAA,IAEJ;AAEA,UAAM,SAAS,oBAAoB,KAAK;AACxC,UAAM,WAAW,WAAW,WAAW;AACvC,WAAO,IAAI,KAAK,CAAC,MAAM,GAAG,SAAS,aAAa,QAAQ,CAAC,IAAI;AAAA,MAC3D,MAAM;AAAA,IAAA,CACP;AAAA,EACH;AAEA,QAAM,IAAI,MAAM,0BAA0B;AAC5C;AAEA,SAAS,WAAW,aAA6B;AAE/C,MAAI,YAAY,SAAS,GAAG,EAAG,QAAO;AACtC,QAAM,MAAM,YAAY,YAAA;AACxB,UAAQ,KAAA;AAAA,IACN,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT;AACE,aAAO,SAAS,GAAG;AAAA,EAAA;AAEzB;AAEA,SAAS,aAAa,UAA0B;AAC9C,UAAQ,UAAA;AAAA,IACN,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AAAA,IACL,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,SAAS;AACP,YAAM,QAAQ,SAAS,QAAQ,GAAG;AAClC,UAAI,UAAU,GAAI,QAAO;AACzB,aAAO,SAAS,MAAM,QAAQ,CAAC,KAAK;AAAA,IACtC;AAAA,EAAA;AAEJ;AAWO,SAAS,oBAAoB,QAA6B;AAC/D,MAAI,OAAO,WAAW,aAAa;AACjC,WAAO,OAAO,KAAK,MAAM,EAAE,SAAS,QAAQ;AAAA,EAC9C;AACA,QAAM,QAAQ,IAAI,WAAW,MAAM;AACnC,QAAM,YAAY;AAClB,MAAI,SAAS;AACb,WAAS,IAAI,GAAG,IAAI,MAAM,QAAQ,KAAK,WAAW;AAChD,UAAM,MAAM,KAAK,IAAI,IAAI,WAAW,MAAM,MAAM;AAChD,cAAU,OAAO,aAAa;AAAA,MAC5B;AAAA;AAAA,MAEA,MAAM,SAAS,GAAG,GAAG;AAAA,IAAA;AAAA,EAEzB;AACA,SAAO,KAAK,MAAM;AACpB;AAEA,SAAS,oBAAoB,QAA6B;AACxD,MAAI;AACJ,MAAI;AACF,aAAS,KAAK,MAAM;AAAA,EACtB,SAAS,KAAK;AACZ,UAAM,MAAM,eAAe,QAAQ,IAAI,UAAU,OAAO,GAAG;AAC3D,UAAM,IAAI,MAAM,wCAAwC,GAAG,EAAE;AAAA,EAC/D;AACA,QAAM,SAAS,IAAI,YAAY,OAAO,MAAM;AAC5C,QAAM,QAAQ,IAAI,WAAW,MAAM;AACnC,WAAS,IAAI,GAAG,IAAI,OAAO,QAAQ,KAAK;AACtC,UAAM,CAAC,IAAI,OAAO,WAAW,CAAC;AAAA,EAChC;AACA,SAAO;AACT;"}
+{"version":3,"file":"audio.js","names":[],"sources":["../../../src/utils/audio.ts"],"sourcesContent":["/**\n * Coerce the various audio input shapes accepted by `TranscriptionOptions.audio`\n * into a `File` suitable for `multipart/form-data` uploads.\n *\n * For base64 string inputs we require an explicit MIME type — either via a\n * `data:<mime>;base64,<payload>` URI prefix, or via the caller-provided\n * `audioFormat` parameter. Bare base64 without either is rejected, because\n * silently defaulting to `audio/mpeg` misreports non-mp3 audio to the server.\n *\n * The same rule applies to raw `ArrayBuffer` inputs: the caller must supply\n * an `audioFormat` so we know what MIME type and extension to use.\n */\nexport function toAudioFile(\n  audio: string | File | Blob | ArrayBuffer,\n  audioFormat?: string,\n): File {\n  if (typeof File !== 'undefined' && audio instanceof File) {\n    // Prefer the caller-supplied `audioFormat` over a potentially empty or\n    // incorrect `File.type` — callers pass `audioFormat` precisely because\n    // they have more context than the browser does about the payload. If\n    // neither is set, fall through to the Blob-style error path below.\n    if (audioFormat) {\n      const mimeType = toMimeType(audioFormat)\n      return new File([audio], `audio.${extensionFor(mimeType)}`, {\n        type: mimeType,\n      })\n    }\n    if (audio.type) {\n      return audio\n    }\n    throw new Error(\n      'toAudioFile cannot infer type for File input with empty .type — pass an explicit audioFormat (e.g. \"mp3\", \"wav\", \"audio/mpeg\")',\n    )\n  }\n\n  if (typeof Blob !== 'undefined' && audio instanceof Blob) {\n    // Mirror the ArrayBuffer / bare-base64 paths: prefer the explicit\n    // audioFormat argument over the Blob's (often empty) .type. We refuse to\n    // fall back to `application/octet-stream` because that mislabels audio\n    // for the server.\n    const mimeType = audioFormat\n      ? toMimeType(audioFormat)\n      : audio.type || undefined\n    if (!mimeType) {\n      throw new Error(\n        'toAudioFile cannot infer type for Blob input with empty .type — pass an explicit audioFormat (e.g. \"mp3\", \"wav\", \"audio/mpeg\")',\n      )\n    }\n    return new File([audio], `audio.${extensionFor(mimeType)}`, {\n      type: mimeType,\n    })\n  }\n\n  if (audio instanceof ArrayBuffer) {\n    if (!audioFormat) {\n      throw new Error(\n        'toAudioFile cannot infer type for ArrayBuffer input — pass an explicit audioFormat (e.g. \"mp3\", \"wav\", \"audio/mpeg\")',\n      )\n    }\n    const mimeType = toMimeType(audioFormat)\n    return new File([audio], `audio.${extensionFor(mimeType)}`, {\n      type: mimeType,\n    })\n  }\n\n  if (typeof audio === 'string') {\n    if (audio.startsWith('data:')) {\n      const [header, base64Data] = audio.split(',')\n      // Fail loudly on malformed data: URIs instead of silently defaulting\n      // to `audio/mpeg` — the file's contract is that we never mislabel\n      // audio for the server.\n      const headerMatch = header?.match(/data:([^;]+)/)\n      const uriMimeType = headerMatch?.[1]\n      if (!uriMimeType) {\n        throw new Error(\n          'Malformed data: URI in toAudioFile: cannot parse MIME type — expected data:<mime>[;charset=…][;base64],<payload>',\n        )\n      }\n      if (base64Data === undefined || base64Data.trim() === '') {\n        throw new Error(\n          'Malformed data: URI in toAudioFile: missing base64 payload after comma',\n        )\n      }\n      // Caller-supplied `audioFormat` wins over the URI-embedded MIME: the\n      // caller has more context (the URI MIME may be wrong, or a generic\n      // `application/octet-stream`).\n      const mimeType = audioFormat ? toMimeType(audioFormat) : uriMimeType\n      const buffer = base64ToArrayBuffer(base64Data)\n      return new File([buffer], `audio.${extensionFor(mimeType)}`, {\n        type: mimeType,\n      })\n    }\n\n    if (!audioFormat) {\n      throw new Error(\n        'toAudioFile requires a data: URI (e.g. data:audio/wav;base64,...) or an explicit audioFormat argument — bare base64 strings have no MIME type to infer',\n      )\n    }\n\n    const buffer = base64ToArrayBuffer(audio)\n    const mimeType = toMimeType(audioFormat)\n    return new File([buffer], `audio.${extensionFor(mimeType)}`, {\n      type: mimeType,\n    })\n  }\n\n  throw new Error('Invalid audio input type')\n}\n\nfunction toMimeType(audioFormat: string): string {\n  // Accept either \"audio/…\" strings or bare extensions like \"mp3\".\n  if (audioFormat.includes('/')) return audioFormat\n  const ext = audioFormat.toLowerCase()\n  switch (ext) {\n    case 'mp3':\n      return 'audio/mpeg'\n    case 'wav':\n      return 'audio/wav'\n    case 'ogg':\n      return 'audio/ogg'\n    case 'opus':\n      return 'audio/opus'\n    case 'flac':\n      return 'audio/flac'\n    case 'aac':\n      return 'audio/aac'\n    case 'mp4':\n      return 'audio/mp4'\n    case 'm4a':\n      return 'audio/mp4'\n    case 'webm':\n      return 'audio/webm'\n    case 'pcm':\n      return 'audio/L16'\n    case 'mulaw':\n      return 'audio/basic'\n    case 'alaw':\n      return 'audio/x-alaw-basic'\n    default:\n      return `audio/${ext}`\n  }\n}\n\nfunction extensionFor(mimeType: string): string {\n  switch (mimeType) {\n    case 'audio/mpeg':\n      return 'mp3'\n    case 'audio/wav':\n    case 'audio/x-wav':\n      return 'wav'\n    case 'audio/ogg':\n      return 'ogg'\n    case 'audio/opus':\n      return 'opus'\n    case 'audio/flac':\n      return 'flac'\n    case 'audio/aac':\n      return 'aac'\n    case 'audio/mp4':\n      return 'm4a'\n    case 'audio/webm':\n      return 'webm'\n    case 'audio/L16':\n      return 'pcm'\n    case 'audio/basic':\n      return 'mulaw'\n    case 'audio/x-alaw-basic':\n      return 'alaw'\n    default: {\n      const slash = mimeType.indexOf('/')\n      if (slash === -1) return 'bin'\n      return mimeType.slice(slash + 1) || 'bin'\n    }\n  }\n}\n\n/**\n * Cross-runtime ArrayBuffer → base64 conversion.\n *\n * Uses Node's `Buffer` when available (fastest path on server) and falls\n * back to `btoa` + chunked `String.fromCharCode` everywhere else (browser,\n * Cloudflare Workers, Bun, Deno). Chunking is required because a very\n * large audio buffer spread into `String.fromCharCode(...bytes)` in one\n * call can hit `Maximum call stack size exceeded`.\n */\nexport function arrayBufferToBase64(buffer: ArrayBuffer): string {\n  if (typeof Buffer !== 'undefined') {\n    return Buffer.from(buffer).toString('base64')\n  }\n  const bytes = new Uint8Array(buffer)\n  const chunkSize = 0x8000\n  let binary = ''\n  for (let i = 0; i < bytes.length; i += chunkSize) {\n    const end = Math.min(i + chunkSize, bytes.length)\n    binary += String.fromCharCode.apply(\n      null,\n      // oxlint-disable-next-line eslint-js/no-restricted-syntax -- TS lib types String.fromCharCode.apply as Array<number> but runtime accepts any ArrayLike\n      bytes.subarray(i, end) as unknown as Array<number>,\n    )\n  }\n  return btoa(binary)\n}\n\nfunction base64ToArrayBuffer(base64: string): ArrayBuffer {\n  let binary: string\n  try {\n    binary = atob(base64)\n  } catch (err) {\n    const msg = err instanceof Error ? err.message : String(err)\n    throw new Error(`Invalid base64 input to toAudioFile: ${msg}`)\n  }\n  const buffer = new ArrayBuffer(binary.length)\n  const bytes = new Uint8Array(buffer)\n  for (let i = 0; i < binary.length; i++) {\n    bytes[i] = binary.charCodeAt(i)\n  }\n  return buffer\n}\n"],"mappings":"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"}

package/dist/esm/utils/client.js

@@ -1,21 +1,27 @@
 import { getApiKeyFromEnv } from "@tanstack/ai-utils";
+//#region src/utils/client.ts
+/**
+* Gets Grok API key from environment variables
+* @throws Error if XAI_API_KEY is not found
+*/
 function getGrokApiKeyFromEnv() {
-  try {
-    return getApiKeyFromEnv("XAI_API_KEY");
-  } catch {
-    throw new Error(
-      "XAI_API_KEY is required. Please set it in your environment variables or use the factory function with an explicit API key."
-    );
-  }
+	try {
+		return getApiKeyFromEnv("XAI_API_KEY");
+	} catch {
+		throw new Error("XAI_API_KEY is required. Please set it in your environment variables or use the factory function with an explicit API key.");
+	}
 }
+/**
+* Returns a Grok client config with the default xAI base URL applied
+* when not already set.
+*/
 function withGrokDefaults(config) {
-  return {
-    ...config,
-    baseURL: config.baseURL || "https://api.x.ai/v1"
-  };
+	return {
+		...config,
+		baseURL: config.baseURL || "https://api.x.ai/v1"
+	};
 }
-export {
-  getGrokApiKeyFromEnv,
-  withGrokDefaults
-};
-//# sourceMappingURL=client.js.map
+//#endregion
+export { getGrokApiKeyFromEnv, withGrokDefaults };
+
+//# sourceMappingURL=client.js.map

package/dist/esm/utils/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","sources":["../../../src/utils/client.ts"],"sourcesContent":["import { getApiKeyFromEnv } from '@tanstack/ai-utils'\nimport type { ClientOptions } from 'openai'\n\nexport interface GrokClientConfig extends Omit<ClientOptions, 'apiKey'> {\n  apiKey: string\n}\n\n/**\n * Gets Grok API key from environment variables\n * @throws Error if XAI_API_KEY is not found\n */\nexport function getGrokApiKeyFromEnv(): string {\n  try {\n    return getApiKeyFromEnv('XAI_API_KEY')\n  } catch {\n    throw new Error(\n      'XAI_API_KEY is required. Please set it in your environment variables or use the factory function with an explicit API key.',\n    )\n  }\n}\n\n/**\n * Returns a Grok client config with the default xAI base URL applied\n * when not already set.\n */\nexport function withGrokDefaults(config: GrokClientConfig): GrokClientConfig {\n  return {\n    ...config,\n    baseURL: config.baseURL || 'https://api.x.ai/v1',\n  }\n}\n"],"names":[],"mappings":";AAWO,SAAS,uBAA+B;AAC7C,MAAI;AACF,WAAO,iBAAiB,aAAa;AAAA,EACvC,QAAQ;AACN,UAAM,IAAI;AAAA,MACR;AAAA,IAAA;AAAA,EAEJ;AACF;AAMO,SAAS,iBAAiB,QAA4C;AAC3E,SAAO;AAAA,IACL,GAAG;AAAA,IACH,SAAS,OAAO,WAAW;AAAA,EAAA;AAE/B;"}
+{"version":3,"file":"client.js","names":[],"sources":["../../../src/utils/client.ts"],"sourcesContent":["import { getApiKeyFromEnv } from '@tanstack/ai-utils'\nimport type { ClientOptions } from 'openai'\n\nexport interface GrokClientConfig extends Omit<ClientOptions, 'apiKey'> {\n  apiKey: string\n}\n\n/**\n * Gets Grok API key from environment variables\n * @throws Error if XAI_API_KEY is not found\n */\nexport function getGrokApiKeyFromEnv(): string {\n  try {\n    return getApiKeyFromEnv('XAI_API_KEY')\n  } catch {\n    throw new Error(\n      'XAI_API_KEY is required. Please set it in your environment variables or use the factory function with an explicit API key.',\n    )\n  }\n}\n\n/**\n * Returns a Grok client config with the default xAI base URL applied\n * when not already set.\n */\nexport function withGrokDefaults(config: GrokClientConfig): GrokClientConfig {\n  return {\n    ...config,\n    baseURL: config.baseURL || 'https://api.x.ai/v1',\n  }\n}\n"],"mappings":";;;;;;AAWA,SAAgB,uBAA+B;CAC7C,IAAI;EACF,OAAO,iBAAiB,aAAa;CACvC,QAAQ;EACN,MAAM,IAAI,MACR,4HACF;CACF;AACF;;;;;AAMA,SAAgB,iBAAiB,QAA4C;CAC3E,OAAO;EACL,GAAG;EACH,SAAS,OAAO,WAAW;CAC7B;AACF"}

package/dist/esm/utils/index.js

@@ -0,0 +1,5 @@
+import { getGrokApiKeyFromEnv } from "./client.js";
+import "./schema-converter.js";
+import { arrayBufferToBase64, toAudioFile } from "./audio.js";
+import { generateId as generateId$1 } from "@tanstack/ai-utils";
+export { arrayBufferToBase64, generateId$1 as generateId, getGrokApiKeyFromEnv, toAudioFile };

package/dist/esm/utils/schema-converter.js

@@ -0,0 +1,2 @@
+import "@tanstack/openai-base";
+import "@tanstack/ai-utils";