@cloudflare/tanstack-ai 0.1.2 → 0.1.4

package/dist/{chunk-IMURYJRF.cjs → chunk-U5NL4EM4.cjs}

@@ -54,7 +54,9 @@ function createGatewayFetch(provider, config, headers = {}) {
       query
     };
     if (provider === "workers-ai") {
-      request.endpoint = query.model;
+      if (!request.endpoint.startsWith("run/")) {
+        request.endpoint = `run/${query.model}`;
+      }
       delete query.model;
       delete query.instructions;
     }
@@ -85,27 +87,10 @@ function normalizeMessagesForBinding(messages) {
     if (normalized.content === null || normalized.content === void 0) {
       normalized.content = "";
     }
-    if (normalized.tool_call_id && typeof normalized.tool_call_id === "string") {
-      normalized.tool_call_id = sanitizeToolCallId(normalized.tool_call_id);
-    }
-    if (Array.isArray(normalized.tool_calls)) {
-      normalized.tool_calls = normalized.tool_calls.map(
-        (tc) => {
-          if (tc.id && typeof tc.id === "string") {
-            return { ...tc, id: sanitizeToolCallId(tc.id) };
-          }
-          return tc;
-        }
-      );
-    }
     return normalized;
   });
 }
-function sanitizeToolCallId(id) {
-  const alphanumeric = id.replace(/[^a-zA-Z0-9]/g, "");
-  return alphanumeric.slice(0, 9).padEnd(9, "0");
-}
-function createWorkersAiBindingFetch(binding) {
+function createWorkersAiBindingFetch(binding, options) {
   return async (_input, init) => {
     if (!_optionalChain([init, 'optionalAccess', _3 => _3.body])) {
       return new Response("No body", { status: 400 });
@@ -129,7 +114,11 @@ function createWorkersAiBindingFetch(binding) {
     if (typeof body.max_tokens === "number") inputs.max_tokens = body.max_tokens;
     if (body.response_format) inputs.response_format = body.response_format;
     if (stream) inputs.stream = true;
-    const result = await binding.run(model, inputs);
+    const result = await binding.run(
+      model,
+      inputs,
+      _optionalChain([options, 'optionalAccess', _4 => _4.extraHeaders]) ? { extraHeaders: options.extraHeaders } : void 0
+    );
     if (stream && result instanceof ReadableStream) {
       const transformed = transformWorkersAiStream(
         result,
@@ -153,11 +142,11 @@ function createWorkersAiBindingFetch(binding) {
       finishReason = "tool_calls";
       message.tool_calls = responseObj.tool_calls.map(
         (tc) => ({
-          id: sanitizeToolCallId(tc.id || crypto.randomUUID()),
+          id: tc.id || crypto.randomUUID(),
           type: "function",
           function: {
-            name: _optionalChain([tc, 'access', _4 => _4.function, 'optionalAccess', _5 => _5.name]) || tc.name || "",
-            arguments: typeof (_nullishCoalesce(_optionalChain([tc, 'access', _6 => _6.function, 'optionalAccess', _7 => _7.arguments]), () => ( tc.arguments))) === "string" ? _nullishCoalesce(_optionalChain([tc, 'access', _8 => _8.function, 'optionalAccess', _9 => _9.arguments]), () => ( tc.arguments)) : JSON.stringify(_nullishCoalesce(_nullishCoalesce(_optionalChain([tc, 'access', _10 => _10.function, 'optionalAccess', _11 => _11.arguments]), () => ( tc.arguments)), () => ( {})))
+            name: _optionalChain([tc, 'access', _5 => _5.function, 'optionalAccess', _6 => _6.name]) || tc.name || "",
+            arguments: typeof (_nullishCoalesce(_optionalChain([tc, 'access', _7 => _7.function, 'optionalAccess', _8 => _8.arguments]), () => ( tc.arguments))) === "string" ? _nullishCoalesce(_optionalChain([tc, 'access', _9 => _9.function, 'optionalAccess', _10 => _10.arguments]), () => ( tc.arguments)) : JSON.stringify(_nullishCoalesce(_nullishCoalesce(_optionalChain([tc, 'access', _11 => _11.function, 'optionalAccess', _12 => _12.arguments]), () => ( tc.arguments)), () => ( {})))
           }
         })
       );
@@ -182,7 +171,7 @@ function transformWorkersAiStream(source, model) {
   let buffer = "";
   let hasToolCalls = false;
   let isOpenAiFormat = false;
-  const emittedToolCallStart = /* @__PURE__ */ new Set();
+  const toolCallState = /* @__PURE__ */ new Map();
   return source.pipeThrough(
     new TransformStream({
       transform(chunk, controller) {
@@ -198,16 +187,24 @@ function transformWorkersAiStream(source, model) {
             const parsed = JSON.parse(data);
             if (parsed.choices !== void 0) {
               isOpenAiFormat = true;
-              const choice = _optionalChain([parsed, 'access', _12 => _12.choices, 'optionalAccess', _13 => _13[0]]);
-              if (_optionalChain([choice, 'optionalAccess', _14 => _14.delta, 'optionalAccess', _15 => _15.tool_calls])) {
+              const choice = _optionalChain([parsed, 'access', _13 => _13.choices, 'optionalAccess', _14 => _14[0]]);
+              if (_optionalChain([choice, 'optionalAccess', _15 => _15.delta, 'optionalAccess', _16 => _16.tool_calls])) {
                 hasToolCalls = true;
                 for (const tc of choice.delta.tool_calls) {
-                  if (tc.id && typeof tc.id === "string") {
-                    tc.id = sanitizeToolCallId(tc.id);
+                  const tcIndex = _nullishCoalesce(tc.index, () => ( 0));
+                  if (!toolCallState.has(tcIndex)) {
+                    const id = tc.id || `call${streamId}${tcIndex}`;
+                    toolCallState.set(tcIndex, {
+                      id,
+                      name: _optionalChain([tc, 'access', _17 => _17.function, 'optionalAccess', _18 => _18.name]) || ""
+                    });
+                    tc.id = id;
+                  } else {
+                    delete tc.id;
                   }
                 }
               }
-              if (_optionalChain([choice, 'optionalAccess', _16 => _16.finish_reason]) === "tool_calls") {
+              if (_optionalChain([choice, 'optionalAccess', _19 => _19.finish_reason]) === "tool_calls") {
                 hasToolCalls = true;
               }
               controller.enqueue(
@@ -240,18 +237,18 @@ function transformWorkersAiStream(source, model) {
             if (Array.isArray(parsed.tool_calls) && parsed.tool_calls.length > 0) {
               for (const tc of parsed.tool_calls) {
                 const tcIndex = _nullishCoalesce(tc.index, () => ( 0));
-                const tcName = _nullishCoalesce(_nullishCoalesce(_optionalChain([tc, 'access', _17 => _17.function, 'optionalAccess', _18 => _18.name]), () => ( tc.name)), () => ( null));
-                const tcArgs = _nullishCoalesce(_nullishCoalesce(_optionalChain([tc, 'access', _19 => _19.function, 'optionalAccess', _20 => _20.arguments]), () => ( tc.arguments)), () => ( null));
+                const tcName = _nullishCoalesce(_nullishCoalesce(_optionalChain([tc, 'access', _20 => _20.function, 'optionalAccess', _21 => _21.name]), () => ( tc.name)), () => ( null));
+                const tcArgs = _nullishCoalesce(_nullishCoalesce(_optionalChain([tc, 'access', _22 => _22.function, 'optionalAccess', _23 => _23.arguments]), () => ( tc.arguments)), () => ( null));
                 const tcId = _nullishCoalesce(tc.id, () => ( null));
                 if (!tcId && !tcName && (!tcArgs || tcArgs === "")) continue;
                 hasToolCalls = true;
                 const toolCallDelta = {
                   index: tcIndex
                 };
-                if (!emittedToolCallStart.has(tcIndex)) {
-                  emittedToolCallStart.add(tcIndex);
-                  const rawId = tcId || `call${streamId}${tcIndex}`;
-                  toolCallDelta.id = sanitizeToolCallId(rawId);
+                if (!toolCallState.has(tcIndex)) {
+                  const id = tcId || `call${streamId}${tcIndex}`;
+                  toolCallState.set(tcIndex, { id, name: tcName || "" });
+                  toolCallDelta.id = id;
                   toolCallDelta.type = "function";
                   toolCallDelta.function = {
                     name: tcName || "",
@@ -324,4 +321,4 @@ function transformWorkersAiStream(source, model) {
 
 
 exports.isDirectBindingConfig = isDirectBindingConfig; exports.isDirectCredentialsConfig = isDirectCredentialsConfig; exports.validateWorkersAiConfig = validateWorkersAiConfig; exports.createGatewayFetch = createGatewayFetch; exports.createWorkersAiBindingFetch = createWorkersAiBindingFetch;
-//# sourceMappingURL=chunk-IMURYJRF.cjs.map
+//# sourceMappingURL=chunk-U5NL4EM4.cjs.map

package/dist/chunk-U5NL4EM4.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/home/runner/work/ai/ai/packages/tanstack-ai/dist/chunk-U5NL4EM4.cjs","../src/utils/create-fetcher.ts"],"names":[],"mappings":"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","file":"/home/runner/work/ai/ai/packages/tanstack-ai/dist/chunk-U5NL4EM4.cjs","sourcesContent":[null,"// ---------------------------------------------------------------------------\n// AI Gateway types (for third-party providers + Workers AI through gateway)\n// ---------------------------------------------------------------------------\n\nexport interface CloudflareAiGateway {\n\trun(request: unknown): Promise<Response>;\n}\n\nexport interface AiGatewayBindingConfig {\n\t/**\n\t * The AI Gateway binding\n\t * @example\n\t * env.AI.gateway('my-gateway-id')\n\t */\n\tbinding: CloudflareAiGateway;\n\t/**\n\t * The Provider API Key if you want to manually pass it, ignore if using Unified Billing or BYOK.\n\t */\n\tapiKey?: string;\n}\n\nexport type AiGatewayCredentialsConfig = {\n\t/**\n\t * The Cloudflare account ID\n\t */\n\taccountId: string;\n\t/**\n\t * The AI Gateway ID\n\t */\n\tgatewayId: string;\n} & (\n\t| {\n\t\t\t/** Cloudflare API Key for AI Gateway */\n\t\t\tcfApiKey: string;\n\t\t\tapiKey?: string;\n\t  }\n\t| {\n\t\t\t/** Provider API Key */\n\t\t\tapiKey: string;\n\t\t\t/** Cloudflare API Key for AI Gateway */\n\t\t\tcfApiKey?: string;\n\t  }\n);\n\nexport interface AiGatewayConfig {\n\tskipCache?: boolean;\n\tcacheTtl?: number;\n\tcustomCacheKey?: string;\n\tmetadata?: Record<string, unknown>;\n}\n\nexport type AiGatewayAdapterConfig = (AiGatewayBindingConfig | AiGatewayCredentialsConfig) &\n\tAiGatewayConfig;\n\n// ---------------------------------------------------------------------------\n// Plain Workers AI types (direct binding or REST, no gateway)\n// ---------------------------------------------------------------------------\n\n/**\n * The Workers AI binding interface (env.AI).\n * Accepts a model name and inputs, returns results directly.\n * Includes `gateway()` which is present on `env.AI` but not on `env.AI.gateway(id)`,\n * enabling structural discrimination from `CloudflareAiGateway`.\n */\nexport interface WorkersAiBinding {\n\trun(\n\t\tmodel: string,\n\t\tinputs: Record<string, unknown>,\n\t\toptions?: Record<string, unknown>,\n\t): Promise<unknown>;\n\tgateway(gatewayId: string): CloudflareAiGateway;\n}\n\nexport interface WorkersAiDirectBindingConfig {\n\t/**\n\t * The Workers AI binding (env.AI).\n\t * @example\n\t * { binding: env.AI }\n\t */\n\tbinding: WorkersAiBinding;\n}\n\nexport interface WorkersAiDirectCredentialsConfig {\n\t/**\n\t * The Cloudflare account ID\n\t */\n\taccountId: string;\n\t/**\n\t * The Cloudflare API key for Workers AI\n\t */\n\tapiKey: string;\n}\n\n/**\n * Config for Workers AI adapters. Supports four modes:\n * - Plain binding: `{ binding: env.AI }`\n * - Plain REST: `{ accountId, apiKey }`\n * - AI Gateway binding: `{ binding: env.AI.gateway(id) }`\n * - AI Gateway REST: `{ accountId, gatewayId, ... }`\n *\n * The third union member intersects `AiGatewayAdapterConfig` with `{ apiKey?: string }`.\n * For the gateway binding variant, `AiGatewayBindingConfig` already includes `apiKey?`,\n * so the intersection is redundant there. For the gateway credentials variant, this\n * `apiKey` represents the Workers AI token (used in the `Authorization` header to the\n * upstream provider), distinct from `cfApiKey` (used in the `cf-aig-authorization`\n * header for authenticated gateways).\n */\nexport type WorkersAiAdapterConfig = (\n\t| WorkersAiDirectBindingConfig\n\t| WorkersAiDirectCredentialsConfig\n\t| (AiGatewayAdapterConfig & { apiKey?: string })\n) & {\n\t/**\n\t * Session affinity key for prefix-cache optimization.\n\t * Routes requests with the same key to the same backend replica.\n\t */\n\tsessionAffinity?: string;\n};\n\n// ---------------------------------------------------------------------------\n// Config detection helpers\n// ---------------------------------------------------------------------------\n\n/** Returns true if this is a plain Workers AI binding config (`{ binding: env.AI }`) */\nexport function isDirectBindingConfig(\n\tconfig: WorkersAiAdapterConfig,\n): config is WorkersAiDirectBindingConfig {\n\t// env.AI has a .gateway() method; env.AI.gateway(id) does not.\n\t// This distinguishes direct bindings from AI Gateway bindings.\n\treturn (\n\t\t\"binding\" in config &&\n\t\ttypeof (config.binding as unknown as Record<string, unknown>).gateway === \"function\"\n\t);\n}\n\n/** Returns true if this is a plain Workers AI REST config (accountId + apiKey, no gatewayId) */\nexport function isDirectCredentialsConfig(\n\tconfig: WorkersAiAdapterConfig,\n): config is WorkersAiDirectCredentialsConfig {\n\treturn \"accountId\" in config && \"apiKey\" in config && !(\"gatewayId\" in config);\n}\n\n/** Returns true if this is an AI Gateway config (has gateway binding or `gatewayId`) */\nexport function isGatewayConfig(config: WorkersAiAdapterConfig): config is AiGatewayAdapterConfig {\n\tif (\"gatewayId\" in config) return true;\n\t// Has `binding` but NOT a direct Workers AI binding (no .gateway method)\n\treturn \"binding\" in config && !isDirectBindingConfig(config);\n}\n\n// ---------------------------------------------------------------------------\n// Config validation\n// ---------------------------------------------------------------------------\n\n/**\n * Validates that a WorkersAiAdapterConfig contains a valid configuration.\n * Throws an error if neither a binding, credentials (accountId + apiKey),\n * nor a gateway configuration is provided.\n */\nexport function validateWorkersAiConfig(config: WorkersAiAdapterConfig): void {\n\tif (\n\t\t!isDirectBindingConfig(config) &&\n\t\t!isDirectCredentialsConfig(config) &&\n\t\t!isGatewayConfig(config)\n\t) {\n\t\tthrow new Error(\n\t\t\t\"Invalid Workers AI configuration: you must provide either a binding (e.g. { binding: env.AI }), \" +\n\t\t\t\t\"credentials ({ accountId, apiKey }), or a gateway configuration ({ binding: env.AI.gateway(id) } \" +\n\t\t\t\t\"or { accountId, gatewayId }).\",\n\t\t);\n\t}\n}\n\n// ---------------------------------------------------------------------------\n// createGatewayFetch -- for routing through AI Gateway\n// ---------------------------------------------------------------------------\n\nexport function createGatewayFetch(\n\tprovider: string,\n\tconfig: AiGatewayAdapterConfig,\n\theaders: Record<string, string> = {},\n): typeof fetch {\n\treturn (input, init) => {\n\t\tlet query: Record<string, unknown> = {};\n\n\t\tconst url =\n\t\t\ttypeof input === \"string\" ? input : input instanceof URL ? input.href : input.url;\n\t\tconst urlObj = new URL(url);\n\n\t\t// Extract endpoint path (remove /v1/ prefix if present)\n\t\tconst endpoint = urlObj.pathname.replace(/^\\/v1\\//, \"\").replace(/^\\//, \"\") + urlObj.search;\n\n\t\tif (init?.body) {\n\t\t\ttry {\n\t\t\t\tquery = JSON.parse(init.body as string);\n\t\t\t} catch {\n\t\t\t\tquery = { _raw: init.body };\n\t\t\t}\n\t\t}\n\n\t\tconst cacheHeaders: Record<string, string> = {};\n\n\t\tif (\"skipCache\" in config && config.skipCache) {\n\t\t\tcacheHeaders[\"cf-aig-skip-cache\"] = \"true\";\n\t\t}\n\n\t\tif (typeof config.cacheTtl === \"number\") {\n\t\t\tcacheHeaders[\"cf-aig-cache-ttl\"] = String(config.cacheTtl);\n\t\t}\n\n\t\tif (typeof config.customCacheKey === \"string\") {\n\t\t\tcacheHeaders[\"cf-aig-cache-key\"] = config.customCacheKey;\n\t\t}\n\n\t\tif (typeof config.metadata === \"object\") {\n\t\t\tcacheHeaders[\"cf-aig-metadata\"] = JSON.stringify(config.metadata);\n\t\t}\n\n\t\tconst request: {\n\t\t\tprovider: string;\n\t\t\tendpoint: string;\n\t\t\theaders: Record<string, string>;\n\t\t\tquery: Record<string, unknown>;\n\t\t} = {\n\t\t\tprovider,\n\t\t\tendpoint,\n\t\t\theaders: {\n\t\t\t\t...(init?.headers as Record<string, string> | undefined),\n\t\t\t\t...headers,\n\t\t\t\t...cacheHeaders,\n\t\t\t\t\"Content-Type\": \"application/json\",\n\t\t\t},\n\t\t\tquery,\n\t\t};\n\n\t\tif (provider === \"workers-ai\") {\n\t\t\tif (!request.endpoint.startsWith(\"run/\")) {\n\t\t\t\trequest.endpoint = `run/${query.model}`;\n\t\t\t}\n\t\t\tdelete query.model;\n\t\t\tdelete query.instructions;\n\t\t}\n\n\t\tif (config.apiKey) {\n\t\t\trequest.headers[\"authorization\"] = `Bearer ${config.apiKey}`;\n\t\t}\n\n\t\tif (\"binding\" in config) {\n\t\t\treturn config.binding.run(request);\n\t\t}\n\n\t\treturn fetch(\n\t\t\t`https://gateway.ai.cloudflare.com/v1/${config.accountId}/${config.gatewayId}`,\n\t\t\t{\n\t\t\t\t...init,\n\t\t\t\theaders: {\n\t\t\t\t\t\"Content-Type\": \"application/json\",\n\t\t\t\t\t...headers,\n\t\t\t\t\t...cacheHeaders,\n\t\t\t\t\t...(config.cfApiKey\n\t\t\t\t\t\t? { \"cf-aig-authorization\": `Bearer ${config.cfApiKey}` }\n\t\t\t\t\t\t: {}),\n\t\t\t\t},\n\t\t\t\tbody: JSON.stringify(request),\n\t\t\t},\n\t\t);\n\t};\n}\n\n// ---------------------------------------------------------------------------\n// createWorkersAiBindingFetch -- shim that makes env.AI look like an OpenAI endpoint\n// ---------------------------------------------------------------------------\n\n/**\n * Normalize messages before passing to Workers AI binding.\n *\n * The binding has strict schema validation that may differ from the OpenAI API:\n * - `content` must not be null\n *\n * Content arrays (with image_url parts) are passed through as-is since the\n * Workers AI binding accepts them at runtime for vision-capable models.\n */\nfunction normalizeMessagesForBinding(\n\tmessages: Record<string, unknown>[],\n): Record<string, unknown>[] {\n\treturn messages.map((msg) => {\n\t\tconst normalized = { ...msg };\n\n\t\t// content: null → content: \"\"\n\t\tif (normalized.content === null || normalized.content === undefined) {\n\t\t\tnormalized.content = \"\";\n\t\t}\n\n\t\treturn normalized;\n\t});\n}\n\n/**\n * Creates a fetch function that intercepts OpenAI SDK requests and translates them\n * to Workers AI binding calls (env.AI.run). This allows the WorkersAiTextAdapter\n * to use the OpenAI SDK against a plain Workers AI binding.\n *\n * NOTE: The `input` URL parameter is intentionally ignored. The model name and all\n * request parameters are extracted from the JSON body, matching Workers AI's\n * `binding.run(model, inputs)` calling convention.\n */\nexport function createWorkersAiBindingFetch(\n\tbinding: WorkersAiBinding,\n\toptions?: { extraHeaders?: Record<string, string> },\n): typeof fetch {\n\treturn async (_input, init) => {\n\t\tif (!init?.body) {\n\t\t\treturn new Response(\"No body\", { status: 400 });\n\t\t}\n\n\t\tlet body: Record<string, unknown>;\n\t\ttry {\n\t\t\tbody = JSON.parse(init.body as string);\n\t\t} catch {\n\t\t\treturn new Response(\"Invalid JSON body\", { status: 400 });\n\t\t}\n\n\t\tconst model = body.model as string;\n\t\tconst stream = body.stream as boolean | undefined;\n\n\t\t// Build Workers AI inputs from OpenAI format\n\t\tconst inputs: Record<string, unknown> = {};\n\t\tif (body.messages) {\n\t\t\tinputs.messages = normalizeMessagesForBinding(\n\t\t\t\tbody.messages as Record<string, unknown>[],\n\t\t\t);\n\t\t}\n\t\tif (body.tools) inputs.tools = body.tools;\n\t\tif (typeof body.temperature === \"number\") inputs.temperature = body.temperature;\n\t\tif (typeof body.max_tokens === \"number\") inputs.max_tokens = body.max_tokens;\n\t\tif (body.response_format) inputs.response_format = body.response_format;\n\t\tif (stream) inputs.stream = true;\n\n\t\tconst result = await binding.run(\n\t\t\tmodel,\n\t\t\tinputs,\n\t\t\toptions?.extraHeaders ? { extraHeaders: options.extraHeaders } : undefined,\n\t\t);\n\n\t\tif (stream && result instanceof ReadableStream) {\n\t\t\t// Workers AI returns an SSE stream with `data: {\"response\":\"chunk\"}` format.\n\t\t\t// Transform it to OpenAI-compatible SSE format.\n\t\t\tconst transformed = transformWorkersAiStream(\n\t\t\t\tresult as ReadableStream<Uint8Array>,\n\t\t\t\tmodel,\n\t\t\t);\n\t\t\treturn new Response(transformed, {\n\t\t\t\theaders: {\n\t\t\t\t\t\"Content-Type\": \"text/event-stream\",\n\t\t\t\t\t\"Cache-Control\": \"no-cache\",\n\t\t\t\t},\n\t\t\t});\n\t\t}\n\n\t\t// Graceful degradation: some models return a complete (non-streaming)\n\t\t// response even when `stream: true` is requested. Fall through to the\n\t\t// non-streaming wrapper which produces a valid OpenAI Chat Completion\n\t\t// response that the SDK can consume.\n\n\t\t// Non-streaming: Workers AI returns { response: \"text\", tool_calls?: [...] }\n\t\t// Wrap into OpenAI Chat Completion format.\n\t\tconst responseObj =\n\t\t\ttypeof result === \"object\" && result !== null\n\t\t\t\t? (result as Record<string, unknown>)\n\t\t\t\t: { response: String(result) };\n\n\t\tconst responseText = typeof responseObj.response === \"string\" ? responseObj.response : \"\";\n\n\t\tconst message: Record<string, unknown> = {\n\t\t\trole: \"assistant\",\n\t\t\tcontent: responseText,\n\t\t};\n\t\tlet finishReason = \"stop\";\n\n\t\t// Handle tool calls if present in Workers AI response\n\t\tif (Array.isArray(responseObj.tool_calls) && responseObj.tool_calls.length > 0) {\n\t\t\tfinishReason = \"tool_calls\";\n\t\t\tmessage.tool_calls = responseObj.tool_calls.map(\n\t\t\t\t(tc: {\n\t\t\t\t\tid?: string;\n\t\t\t\t\tname?: string;\n\t\t\t\t\targuments: unknown;\n\t\t\t\t\tfunction?: { name: string; arguments?: unknown };\n\t\t\t\t}) => ({\n\t\t\t\t\tid: tc.id || crypto.randomUUID(),\n\t\t\t\t\ttype: \"function\",\n\t\t\t\t\tfunction: {\n\t\t\t\t\t\tname: tc.function?.name || tc.name || \"\",\n\t\t\t\t\t\targuments:\n\t\t\t\t\t\t\ttypeof (tc.function?.arguments ?? tc.arguments) === \"string\"\n\t\t\t\t\t\t\t\t? ((tc.function?.arguments ?? tc.arguments) as string)\n\t\t\t\t\t\t\t\t: JSON.stringify(tc.function?.arguments ?? tc.arguments ?? {}),\n\t\t\t\t\t},\n\t\t\t\t}),\n\t\t\t);\n\t\t}\n\n\t\tconst openAiResponse = {\n\t\t\tid: `workers-ai-${crypto.randomUUID()}`,\n\t\t\tobject: \"chat.completion\",\n\t\t\tcreated: Math.floor(Date.now() / 1000),\n\t\t\tmodel,\n\t\t\tchoices: [{ index: 0, message, finish_reason: finishReason }],\n\t\t};\n\n\t\treturn new Response(JSON.stringify(openAiResponse), {\n\t\t\theaders: { \"Content-Type\": \"application/json\" },\n\t\t});\n\t};\n}\n\n// ---------------------------------------------------------------------------\n// Stream transformer: Workers AI SSE -> OpenAI-compatible SSE\n// Uses TransformStream for proper backpressure.\n// ---------------------------------------------------------------------------\n\n/**\n * Transforms a Workers AI SSE stream (data: {\"response\":\"chunk\"}) into\n * an OpenAI-compatible SSE stream (data: {\"choices\":[{\"delta\":{\"content\":\"chunk\"}}]}).\n *\n * Workers AI binding streams tool calls in an OpenAI-like nested format:\n *   { tool_calls: [{ id, type, index, function: { name, arguments } }] }\n * Arguments are streamed incrementally across multiple SSE chunks, so the\n * transformer must forward them as incremental deltas rather than a single blob.\n */\nfunction transformWorkersAiStream(\n\tsource: ReadableStream<Uint8Array>,\n\tmodel: string,\n): ReadableStream<Uint8Array> {\n\tconst decoder = new TextDecoder();\n\tconst encoder = new TextEncoder();\n\t// Generate a stable ID and timestamp for the entire stream, matching OpenAI's\n\t// convention where all chunks in a single response share the same id/created.\n\tconst streamId = `workers-ai-${crypto.randomUUID()}`;\n\tconst created = Math.floor(Date.now() / 1000);\n\tlet buffer = \"\";\n\tlet hasToolCalls = false;\n\t// When true, the source stream is already in OpenAI format (some models\n\t// like Qwen3, Kimi K2.5 stream OpenAI-compatible SSE through the binding).\n\t// In that case, flush() should only emit [DONE] and skip the finish chunk.\n\tlet isOpenAiFormat = false;\n\t// Track tool call state per index: store the generated/assigned ID so that\n\t// subsequent argument deltas use the same ID (matching the working streaming.ts pattern).\n\tconst toolCallState = new Map<number, { id: string; name: string }>();\n\n\treturn source.pipeThrough(\n\t\tnew TransformStream<Uint8Array, Uint8Array>({\n\t\t\ttransform(chunk, controller) {\n\t\t\t\tbuffer += decoder.decode(chunk, { stream: true });\n\t\t\t\tconst lines = buffer.split(\"\\n\");\n\t\t\t\tbuffer = lines.pop() || \"\";\n\n\t\t\t\tfor (const line of lines) {\n\t\t\t\t\tconst trimmed = line.trim();\n\t\t\t\t\tif (!trimmed || !trimmed.startsWith(\"data: \")) continue;\n\t\t\t\t\tconst data = trimmed.slice(6);\n\n\t\t\t\t\t// Swallow source [DONE]; we emit our own in flush()\n\t\t\t\t\tif (data === \"[DONE]\") continue;\n\n\t\t\t\t\ttry {\n\t\t\t\t\t\tconst parsed = JSON.parse(data);\n\n\t\t\t\t\t\t// Some models (Qwen3, Kimi K2.5) return OpenAI-compatible format\n\t\t\t\t\t\t// directly through the binding, with `choices[].delta.content` and\n\t\t\t\t\t\t// optional `reasoning_content`. Detect this and pass through as-is.\n\t\t\t\t\t\tif (parsed.choices !== undefined) {\n\t\t\t\t\t\t\t// Already OpenAI format — pass through but ensure each tool call\n\t\t\t\t\t\t\t// index gets a unique, stable ID across all chunks.\n\t\t\t\t\t\t\tisOpenAiFormat = true;\n\t\t\t\t\t\t\tconst choice = parsed.choices?.[0];\n\t\t\t\t\t\t\tif (choice?.delta?.tool_calls) {\n\t\t\t\t\t\t\t\thasToolCalls = true;\n\t\t\t\t\t\t\t\tfor (const tc of choice.delta.tool_calls) {\n\t\t\t\t\t\t\t\t\tconst tcIndex = tc.index ?? 0;\n\t\t\t\t\t\t\t\t\tif (!toolCallState.has(tcIndex)) {\n\t\t\t\t\t\t\t\t\t\t// First chunk for this index — generate/store unique ID\n\t\t\t\t\t\t\t\t\t\tconst id = tc.id || `call${streamId}${tcIndex}`;\n\t\t\t\t\t\t\t\t\t\ttoolCallState.set(tcIndex, {\n\t\t\t\t\t\t\t\t\t\t\tid,\n\t\t\t\t\t\t\t\t\t\t\tname: tc.function?.name || \"\",\n\t\t\t\t\t\t\t\t\t\t});\n\t\t\t\t\t\t\t\t\t\ttc.id = id;\n\t\t\t\t\t\t\t\t\t} else {\n\t\t\t\t\t\t\t\t\t\t// Subsequent chunk — reuse stored ID, remove id from delta\n\t\t\t\t\t\t\t\t\t\t// (OpenAI format only sends id in first chunk)\n\t\t\t\t\t\t\t\t\t\tdelete tc.id;\n\t\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\tif (choice?.finish_reason === \"tool_calls\") {\n\t\t\t\t\t\t\t\thasToolCalls = true;\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\tcontroller.enqueue(\n\t\t\t\t\t\t\t\tencoder.encode(`data: ${JSON.stringify(parsed)}\\n\\n`),\n\t\t\t\t\t\t\t);\n\t\t\t\t\t\t\tcontinue;\n\t\t\t\t\t\t}\n\n\t\t\t\t\t\t// --- Workers AI native format handling below ---\n\n\t\t\t\t\t\t// Text content\n\t\t\t\t\t\tif (parsed.response != null && parsed.response !== \"\") {\n\t\t\t\t\t\t\tconst openAiChunk = {\n\t\t\t\t\t\t\t\tid: streamId,\n\t\t\t\t\t\t\t\tobject: \"chat.completion.chunk\",\n\t\t\t\t\t\t\t\tcreated,\n\t\t\t\t\t\t\t\tmodel,\n\t\t\t\t\t\t\t\tchoices: [\n\t\t\t\t\t\t\t\t\t{\n\t\t\t\t\t\t\t\t\t\tindex: 0,\n\t\t\t\t\t\t\t\t\t\tdelta: { content: parsed.response },\n\t\t\t\t\t\t\t\t\t\tfinish_reason: null,\n\t\t\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\t\t],\n\t\t\t\t\t\t\t};\n\t\t\t\t\t\t\tcontroller.enqueue(\n\t\t\t\t\t\t\t\tencoder.encode(`data: ${JSON.stringify(openAiChunk)}\\n\\n`),\n\t\t\t\t\t\t\t);\n\t\t\t\t\t\t}\n\n\t\t\t\t\t\t// Tool calls — Workers AI binding streams these incrementally:\n\t\t\t\t\t\t//   Chunk A: { id, type, index, function: { name } }          — start\n\t\t\t\t\t\t//   Chunk B: { index, function: { arguments: \"partial...\" } }  — args delta\n\t\t\t\t\t\t//   Chunk C: { index, function: { arguments: \"rest...\" } }     — args delta\n\t\t\t\t\t\t//   Chunk D: { id: null, type: null, index, function: { name: null, arguments: \"\" } } — finalize (skip)\n\t\t\t\t\t\tif (Array.isArray(parsed.tool_calls) && parsed.tool_calls.length > 0) {\n\t\t\t\t\t\t\tfor (const tc of parsed.tool_calls) {\n\t\t\t\t\t\t\t\tconst tcIndex = tc.index ?? 0;\n\n\t\t\t\t\t\t\t\t// Resolve name and arguments from either nested or flat format\n\t\t\t\t\t\t\t\tconst tcName = tc.function?.name ?? tc.name ?? null;\n\t\t\t\t\t\t\t\tconst tcArgs = tc.function?.arguments ?? tc.arguments ?? null;\n\t\t\t\t\t\t\t\tconst tcId = tc.id ?? null;\n\n\t\t\t\t\t\t\t\t// Skip finalization chunks where everything is null/empty\n\t\t\t\t\t\t\t\tif (!tcId && !tcName && (!tcArgs || tcArgs === \"\")) continue;\n\n\t\t\t\t\t\t\t\thasToolCalls = true;\n\n\t\t\t\t\t\t\t\t// Build the OpenAI-compatible tool_calls delta\n\t\t\t\t\t\t\t\tconst toolCallDelta: Record<string, unknown> = {\n\t\t\t\t\t\t\t\t\tindex: tcIndex,\n\t\t\t\t\t\t\t\t};\n\n\t\t\t\t\t\t\t\tif (!toolCallState.has(tcIndex)) {\n\t\t\t\t\t\t\t\t\t// First chunk for this tool call index — emit id, type, name.\n\t\t\t\t\t\t\t\t\tconst id = tcId || `call${streamId}${tcIndex}`;\n\t\t\t\t\t\t\t\t\ttoolCallState.set(tcIndex, { id, name: tcName || \"\" });\n\t\t\t\t\t\t\t\t\ttoolCallDelta.id = id;\n\t\t\t\t\t\t\t\t\ttoolCallDelta.type = \"function\";\n\t\t\t\t\t\t\t\t\ttoolCallDelta.function = {\n\t\t\t\t\t\t\t\t\t\tname: tcName || \"\",\n\t\t\t\t\t\t\t\t\t\t// Include arguments if they arrive in the same chunk\n\t\t\t\t\t\t\t\t\t\targuments:\n\t\t\t\t\t\t\t\t\t\t\ttcArgs != null\n\t\t\t\t\t\t\t\t\t\t\t\t? typeof tcArgs === \"string\"\n\t\t\t\t\t\t\t\t\t\t\t\t\t? tcArgs\n\t\t\t\t\t\t\t\t\t\t\t\t\t: JSON.stringify(tcArgs)\n\t\t\t\t\t\t\t\t\t\t\t\t: \"\",\n\t\t\t\t\t\t\t\t\t};\n\t\t\t\t\t\t\t\t} else {\n\t\t\t\t\t\t\t\t\t// Subsequent chunks — only include arguments delta\n\t\t\t\t\t\t\t\t\tif (tcArgs != null && tcArgs !== \"\") {\n\t\t\t\t\t\t\t\t\t\ttoolCallDelta.function = {\n\t\t\t\t\t\t\t\t\t\t\targuments:\n\t\t\t\t\t\t\t\t\t\t\t\ttypeof tcArgs === \"string\"\n\t\t\t\t\t\t\t\t\t\t\t\t\t? tcArgs\n\t\t\t\t\t\t\t\t\t\t\t\t\t: JSON.stringify(tcArgs),\n\t\t\t\t\t\t\t\t\t\t};\n\t\t\t\t\t\t\t\t\t} else {\n\t\t\t\t\t\t\t\t\t\tcontinue; // Nothing useful to forward\n\t\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t\t}\n\n\t\t\t\t\t\t\t\tconst toolChunk = {\n\t\t\t\t\t\t\t\t\tid: streamId,\n\t\t\t\t\t\t\t\t\tobject: \"chat.completion.chunk\",\n\t\t\t\t\t\t\t\t\tcreated,\n\t\t\t\t\t\t\t\t\tmodel,\n\t\t\t\t\t\t\t\t\tchoices: [\n\t\t\t\t\t\t\t\t\t\t{\n\t\t\t\t\t\t\t\t\t\t\tindex: 0,\n\t\t\t\t\t\t\t\t\t\t\tdelta: { tool_calls: [toolCallDelta] },\n\t\t\t\t\t\t\t\t\t\t\tfinish_reason: null,\n\t\t\t\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\t\t\t],\n\t\t\t\t\t\t\t\t};\n\t\t\t\t\t\t\t\tcontroller.enqueue(\n\t\t\t\t\t\t\t\t\tencoder.encode(`data: ${JSON.stringify(toolChunk)}\\n\\n`),\n\t\t\t\t\t\t\t\t);\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t}\n\t\t\t\t\t} catch (e) {\n\t\t\t\t\t\t// Log malformed SSE events for debugging; don't break the stream.\n\t\t\t\t\t\tconsole.warn(\"[tanstack-ai] failed to parse SSE event:\", data, e);\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t},\n\t\t\tflush(controller) {\n\t\t\t\tif (!isOpenAiFormat) {\n\t\t\t\t\t// Workers AI native format: emit a finish chunk with stop/tool_calls\n\t\t\t\t\tconst finalChunk = {\n\t\t\t\t\t\tid: streamId,\n\t\t\t\t\t\tobject: \"chat.completion.chunk\",\n\t\t\t\t\t\tcreated,\n\t\t\t\t\t\tmodel,\n\t\t\t\t\t\tchoices: [\n\t\t\t\t\t\t\t{\n\t\t\t\t\t\t\t\tindex: 0,\n\t\t\t\t\t\t\t\tdelta: {},\n\t\t\t\t\t\t\t\tfinish_reason: hasToolCalls ? \"tool_calls\" : \"stop\",\n\t\t\t\t\t\t\t},\n\t\t\t\t\t\t],\n\t\t\t\t\t};\n\t\t\t\t\tcontroller.enqueue(encoder.encode(`data: ${JSON.stringify(finalChunk)}\\n\\n`));\n\t\t\t\t}\n\t\t\t\t// OpenAI format already includes its own finish_reason in the stream.\n\t\t\t\t// Either way, emit a [DONE] sentinel.\n\t\t\t\tcontroller.enqueue(encoder.encode(\"data: [DONE]\\n\\n\"));\n\t\t\t},\n\t\t}),\n\t);\n}\n"]}

package/dist/{chunk-AYTKQRE4.cjs → chunk-XFQ3QESX.cjs}

@@ -10,7 +10,7 @@ var _chunk7HSUHP63cjs = require('./chunk-7HSUHP63.cjs');
 
 
 
-var _chunkIMURYJRFcjs = require('./chunk-IMURYJRF.cjs');
+var _chunkU5NL4EM4cjs = require('./chunk-U5NL4EM4.cjs');
 
 
 var _chunk4DE2IREAcjs = require('./chunk-4DE2IREA.cjs');
@@ -22,7 +22,7 @@ var WorkersAiTranscriptionAdapter = class extends _adapters.BaseTranscriptionAda
     super({}, model);
     _chunk4DE2IREAcjs.__publicField.call(void 0, this, "name", "workers-ai-transcription");
     _chunk4DE2IREAcjs.__publicField.call(void 0, this, "adapterConfig");
-    _chunkIMURYJRFcjs.validateWorkersAiConfig.call(void 0, config);
+    _chunkU5NL4EM4cjs.validateWorkersAiConfig.call(void 0, config);
     this.adapterConfig = config;
   }
   async transcribe(options) {
@@ -32,10 +32,10 @@ var WorkersAiTranscriptionAdapter = class extends _adapters.BaseTranscriptionAda
     if (language) extra.language = language;
     if (prompt) extra.initial_prompt = prompt;
     const audioPayload = this.buildAudioPayload(audioBytes, audio);
-    if (_chunkIMURYJRFcjs.isDirectBindingConfig.call(void 0, this.adapterConfig)) {
+    if (_chunkU5NL4EM4cjs.isDirectBindingConfig.call(void 0, this.adapterConfig)) {
       return this.transcribeViaBinding(audioPayload, extra);
     }
-    if (_chunkIMURYJRFcjs.isDirectCredentialsConfig.call(void 0, this.adapterConfig)) {
+    if (_chunkU5NL4EM4cjs.isDirectCredentialsConfig.call(void 0, this.adapterConfig)) {
       if (this.model === "@cf/deepgram/nova-3") {
         return this.transcribeViaRestBinary(audioBytes, audio, extra);
       }
@@ -106,7 +106,7 @@ var WorkersAiTranscriptionAdapter = class extends _adapters.BaseTranscriptionAda
   }
   async transcribeViaGateway(audioPayload, options) {
     const gatewayConfig = this.adapterConfig;
-    const gatewayFetch = _chunkIMURYJRFcjs.createGatewayFetch.call(void 0, "workers-ai", gatewayConfig);
+    const gatewayFetch = _chunkU5NL4EM4cjs.createGatewayFetch.call(void 0, "workers-ai", gatewayConfig);
     const response = await gatewayFetch("https://api.cloudflare.com/v1/audio/transcriptions", {
       method: "POST",
       body: JSON.stringify({
@@ -215,4 +215,4 @@ function detectAudioContentType(audio) {
 
 
 exports.WorkersAiTranscriptionAdapter = WorkersAiTranscriptionAdapter; exports.createWorkersAiTranscription = createWorkersAiTranscription;
-//# sourceMappingURL=chunk-AYTKQRE4.cjs.map
+//# sourceMappingURL=chunk-XFQ3QESX.cjs.map

package/dist/{chunk-AYTKQRE4.cjs.map → chunk-XFQ3QESX.cjs.map}

@@ -1 +1 @@
-{"version":3,"sources":["/home/runner/work/ai/ai/packages/tanstack-ai/dist/chunk-AYTKQRE4.cjs","../src/adapters/workers-ai-transcription.ts"],"names":[],"mappings":"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","file":"/home/runner/work/ai/ai/packages/tanstack-ai/dist/chunk-AYTKQRE4.cjs","sourcesContent":[null,"import { BaseTranscriptionAdapter } from \"@tanstack/ai/adapters\";\nimport type { TranscriptionOptions, TranscriptionResult } from \"@tanstack/ai\";\nimport {\n\ttype WorkersAiAdapterConfig,\n\ttype WorkersAiDirectBindingConfig,\n\ttype WorkersAiDirectCredentialsConfig,\n\ttype AiGatewayAdapterConfig,\n\tcreateGatewayFetch,\n\tisDirectBindingConfig,\n\tisDirectCredentialsConfig,\n\tvalidateWorkersAiConfig,\n} from \"../utils/create-fetcher\";\nimport { workersAiRestFetch, workersAiRestFetchBinary } from \"../utils/workers-ai-rest\";\nimport { uint8ArrayToBase64 } from \"../utils/binary\";\n\n// ---------------------------------------------------------------------------\n// Model types\n// ---------------------------------------------------------------------------\n\n/**\n * Workers AI models that support speech-to-text transcription.\n *\n * Note: the typed `AiModels` interface in `@cloudflare/workers-types` may lag\n * behind what's deployed. We use a string union here that matches the known\n * models including Deepgram partner models.\n *\n * **Nova-3 note:** `@cf/deepgram/nova-3` uses a different input format than the\n * Whisper models. Via binding it accepts `{ audio: { body: base64, contentType } }`.\n * Via REST it requires multipart form data (not JSON). The adapter handles both.\n */\nexport type WorkersAiTranscriptionModel =\n\t| \"@cf/openai/whisper\"\n\t| \"@cf/openai/whisper-tiny-en\"\n\t| \"@cf/openai/whisper-large-v3-turbo\"\n\t| \"@cf/deepgram/nova-3\"\n\t| (string & {});\n\n// ---------------------------------------------------------------------------\n// WorkersAiTranscriptionAdapter\n// ---------------------------------------------------------------------------\n\nexport class WorkersAiTranscriptionAdapter extends BaseTranscriptionAdapter<WorkersAiTranscriptionModel> {\n\treadonly name = \"workers-ai-transcription\" as const;\n\tprivate adapterConfig: WorkersAiAdapterConfig;\n\n\tconstructor(config: WorkersAiAdapterConfig, model: WorkersAiTranscriptionModel) {\n\t\tsuper({}, model);\n\t\tvalidateWorkersAiConfig(config);\n\t\tthis.adapterConfig = config;\n\t}\n\n\tasync transcribe(options: TranscriptionOptions): Promise<TranscriptionResult> {\n\t\tconst { audio, language, prompt, modelOptions } = options;\n\n\t\t// Normalize audio to raw bytes\n\t\tconst audioBytes = await normalizeAudioToBytes(audio);\n\n\t\tconst extra: Record<string, unknown> = { ...modelOptions };\n\t\tif (language) extra.language = language;\n\t\tif (prompt) extra.initial_prompt = prompt;\n\n\t\t// Build the model-specific audio payload:\n\t\t// - Deepgram Nova-3 (binding): { audio: { body: base64, contentType: \"audio/...\" } }\n\t\t// - Deepgram Nova-3 (REST): multipart FormData (handled separately)\n\t\t// - Whisper Large v3 Turbo (REST/gateway): { audio: base64string }\n\t\t// - Other Whisper models (binding): { audio: number[] }\n\t\tconst audioPayload = this.buildAudioPayload(audioBytes, audio);\n\n\t\tif (isDirectBindingConfig(this.adapterConfig)) {\n\t\t\treturn this.transcribeViaBinding(audioPayload, extra);\n\t\t}\n\n\t\tif (isDirectCredentialsConfig(this.adapterConfig)) {\n\t\t\t// Nova-3 REST requires raw binary audio, not JSON\n\t\t\tif (this.model === \"@cf/deepgram/nova-3\") {\n\t\t\t\treturn this.transcribeViaRestBinary(audioBytes, audio, extra);\n\t\t\t}\n\t\t\treturn this.transcribeViaRest(audioPayload, extra);\n\t\t}\n\n\t\treturn this.transcribeViaGateway(audioPayload, extra);\n\t}\n\n\t/**\n\t * Build the audio field for the request payload, handling model-specific formats.\n\t *\n\t * - `@cf/deepgram/nova-3` requires `{ body: base64, contentType: \"audio/...\" }`\n\t * - `@cf/openai/whisper-large-v3-turbo` REST/gateway accepts a base64 string\n\t * - Other Whisper models accept `number[]` (binding) or base64 (REST)\n\t */\n\tprivate buildAudioPayload(\n\t\taudioBytes: number[],\n\t\toriginalAudio: string | File | Blob | ArrayBuffer,\n\t): Record<string, unknown> {\n\t\tif (this.model === \"@cf/deepgram/nova-3\") {\n\t\t\tconst b64 = uint8ArrayToBase64(new Uint8Array(audioBytes));\n\t\t\tconst contentType = detectAudioContentType(originalAudio);\n\t\t\treturn { audio: { body: b64, contentType } };\n\t\t}\n\n\t\tif (this.model === \"@cf/openai/whisper-large-v3-turbo\") {\n\t\t\treturn { audio: uint8ArrayToBase64(new Uint8Array(audioBytes)) };\n\t\t}\n\n\t\treturn { audio: audioBytes };\n\t}\n\n\tprivate async transcribeViaBinding(\n\t\taudioPayload: Record<string, unknown>,\n\t\toptions: Record<string, unknown>,\n\t): Promise<TranscriptionResult> {\n\t\tconst ai = (this.adapterConfig as WorkersAiDirectBindingConfig).binding;\n\t\tconst result = (await ai.run(this.model, {\n\t\t\t...audioPayload,\n\t\t\t...options,\n\t\t})) as Record<string, unknown>;\n\t\treturn this.normalizeResult(result);\n\t}\n\n\tprivate async transcribeViaRest(\n\t\taudioPayload: Record<string, unknown>,\n\t\toptions: Record<string, unknown>,\n\t): Promise<TranscriptionResult> {\n\t\tconst config = this.adapterConfig as WorkersAiDirectCredentialsConfig;\n\n\t\tconst response = await workersAiRestFetch(\n\t\t\tconfig,\n\t\t\tthis.model,\n\t\t\t{ ...audioPayload, ...options },\n\t\t\t{\n\t\t\t\tlabel: \"Workers AI transcription\",\n\t\t\t\tsignal: (options as { signal?: AbortSignal }).signal,\n\t\t\t},\n\t\t);\n\n\t\tconst data = (await response.json()) as {\n\t\t\tresult?: Record<string, unknown>;\n\t\t} & Record<string, unknown>;\n\n\t\t// Cloudflare REST API wraps responses in { success, result: {...} }.\n\t\t// Use `data.result` when present, fall back to `data` for direct responses.\n\t\treturn this.normalizeResult(data.result ?? data);\n\t}\n\n\t/**\n\t * Transcribe via REST using raw binary audio.\n\t * Required for models like Deepgram Nova-3 that expect raw audio bytes\n\t * with a Content-Type header (e.g. \"audio/wav\") instead of JSON.\n\t */\n\tprivate async transcribeViaRestBinary(\n\t\taudioBytes: number[],\n\t\toriginalAudio: string | File | Blob | ArrayBuffer,\n\t\toptions: Record<string, unknown>,\n\t): Promise<TranscriptionResult> {\n\t\tconst config = this.adapterConfig as WorkersAiDirectCredentialsConfig;\n\t\tconst contentType = detectAudioContentType(originalAudio);\n\n\t\tconst response = await workersAiRestFetchBinary(\n\t\t\tconfig,\n\t\t\tthis.model,\n\t\t\tnew Uint8Array(audioBytes),\n\t\t\tcontentType,\n\t\t\t{\n\t\t\t\tlabel: \"Workers AI transcription\",\n\t\t\t\tsignal: (options as { signal?: AbortSignal }).signal,\n\t\t\t},\n\t\t);\n\n\t\tconst data = (await response.json()) as {\n\t\t\tresult?: Record<string, unknown>;\n\t\t} & Record<string, unknown>;\n\n\t\treturn this.normalizeResult(data.result ?? data);\n\t}\n\n\tprivate async transcribeViaGateway(\n\t\taudioPayload: Record<string, unknown>,\n\t\toptions: Record<string, unknown>,\n\t): Promise<TranscriptionResult> {\n\t\tconst gatewayConfig = this.adapterConfig as AiGatewayAdapterConfig;\n\t\tconst gatewayFetch = createGatewayFetch(\"workers-ai\", gatewayConfig);\n\n\t\t// The URL here is a placeholder — createGatewayFetch for \"workers-ai\" extracts\n\t\t// the model from the body, sets it as the endpoint, and routes through the gateway.\n\t\t// The actual URL path is not used.\n\t\tconst response = await gatewayFetch(\"https://api.cloudflare.com/v1/audio/transcriptions\", {\n\t\t\tmethod: \"POST\",\n\t\t\tbody: JSON.stringify({\n\t\t\t\tmodel: this.model,\n\t\t\t\t...audioPayload,\n\t\t\t\t...options,\n\t\t\t}),\n\t\t});\n\n\t\tif (!response.ok) {\n\t\t\tconst errorText = await response.text();\n\t\t\tthrow new Error(\n\t\t\t\t`Workers AI transcription gateway request failed (${response.status}): ${errorText}`,\n\t\t\t);\n\t\t}\n\n\t\tconst data = (await response.json()) as Record<string, unknown>;\n\t\treturn this.normalizeResult(data);\n\t}\n\n\t/**\n\t * Normalize Workers AI transcription results into the standard\n\t * TanStack AI TranscriptionResult shape.\n\t *\n\t * Handles three response formats:\n\t * - Whisper: `{ text, words?, vtt? }`\n\t * - Whisper v3-turbo: `{ text, segments?, transcription_info? }`\n\t * - Deepgram Nova-3: `{ results: { channels: [{ alternatives: [{ transcript, words }] }] } }`\n\t */\n\tprivate normalizeResult(raw: Record<string, unknown>): TranscriptionResult {\n\t\t// Deepgram Nova-3 format: { results: { channels: [{ alternatives: [{ transcript, words }] }] } }\n\t\tconst results = raw.results as Record<string, unknown> | undefined;\n\t\tif (results?.channels) {\n\t\t\tconst channels = results.channels as Array<{\n\t\t\t\talternatives?: Array<{\n\t\t\t\t\ttranscript?: string;\n\t\t\t\t\tconfidence?: number;\n\t\t\t\t\twords?: Array<{ word: string; start: number; end: number; confidence: number }>;\n\t\t\t\t}>;\n\t\t\t}>;\n\t\t\tconst alt = channels?.[0]?.alternatives?.[0];\n\t\t\tconst text = alt?.transcript ?? \"\";\n\t\t\tconst result: TranscriptionResult = {\n\t\t\t\tid: this.generateId(),\n\t\t\t\tmodel: this.model,\n\t\t\t\ttext,\n\t\t\t};\n\t\t\tif (alt?.words && Array.isArray(alt.words)) {\n\t\t\t\tresult.words = alt.words.map((w) => ({\n\t\t\t\t\tword: w.word ?? \"\",\n\t\t\t\t\tstart: w.start ?? 0,\n\t\t\t\t\tend: w.end ?? 0,\n\t\t\t\t}));\n\t\t\t}\n\t\t\treturn result;\n\t\t}\n\n\t\t// Whisper format: { text, words?, vtt? }\n\t\t// Whisper v3-turbo format: { text, segments?, transcription_info? }\n\t\tconst result: TranscriptionResult = {\n\t\t\tid: this.generateId(),\n\t\t\tmodel: this.model,\n\t\t\ttext: (raw.text as string) ?? \"\",\n\t\t};\n\n\t\t// Language from transcription_info (whisper-large-v3-turbo)\n\t\tconst transcriptionInfo = raw.transcription_info as Record<string, unknown> | undefined;\n\t\tif (transcriptionInfo?.language) {\n\t\t\tresult.language = transcriptionInfo.language as string;\n\t\t}\n\n\t\t// Duration\n\t\tif (transcriptionInfo?.duration != null) {\n\t\t\tresult.duration = transcriptionInfo.duration as number;\n\t\t}\n\n\t\t// Segments (whisper-large-v3-turbo returns these)\n\t\tif (raw.segments && Array.isArray(raw.segments)) {\n\t\t\tresult.segments = raw.segments.map((seg: Record<string, unknown>, idx: number) => ({\n\t\t\t\tid: idx,\n\t\t\t\ttext: (seg.text as string) ?? \"\",\n\t\t\t\tstart: (seg.start as number) ?? 0,\n\t\t\t\tend: (seg.end as number) ?? 0,\n\t\t\t}));\n\t\t}\n\n\t\t// Words — basic whisper returns top-level words[], v3-turbo nests them in segments\n\t\tif (raw.words && Array.isArray(raw.words)) {\n\t\t\tresult.words = raw.words.map((w: Record<string, unknown>) => ({\n\t\t\t\tword: (w.word as string) ?? \"\",\n\t\t\t\tstart: (w.start as number) ?? 0,\n\t\t\t\tend: (w.end as number) ?? 0,\n\t\t\t}));\n\t\t}\n\n\t\treturn result;\n\t}\n}\n\n// ---------------------------------------------------------------------------\n// Factory function\n// ---------------------------------------------------------------------------\n\n/**\n * Creates a Workers AI transcription adapter for speech-to-text.\n *\n * Works with TanStack AI's `generateTranscription()` activity function:\n * ```ts\n * import { generateTranscription } from \"@tanstack/ai\";\n * import { createWorkersAiTranscription } from \"@cloudflare/tanstack-ai\";\n *\n * const adapter = createWorkersAiTranscription(\n *   \"@cf/openai/whisper-large-v3-turbo\",\n *   { binding: env.AI },\n * );\n *\n * const result = await generateTranscription({ adapter, audio: audioData });\n * // result.text — the transcribed text\n * ```\n *\n * Note: Factory takes `(model, config)` for ergonomics — the class constructor\n * uses `(config, model)` to match TanStack AI's upstream convention.\n */\nexport function createWorkersAiTranscription(\n\tmodel: WorkersAiTranscriptionModel,\n\tconfig: WorkersAiAdapterConfig,\n) {\n\treturn new WorkersAiTranscriptionAdapter(config, model);\n}\n\n// ---------------------------------------------------------------------------\n// Utilities\n// ---------------------------------------------------------------------------\n\n/**\n * Normalize various audio input formats into a number[] (raw bytes).\n *\n * Note: `File extends Blob`, so `File` instances are handled by the\n * `instanceof Blob` branch. `Blob.arrayBuffer()` always reads the full\n * contents regardless of any prior reads — there's no cursor to worry about.\n */\nasync function normalizeAudioToBytes(audio: string | File | Blob | ArrayBuffer): Promise<number[]> {\n\tif (audio instanceof ArrayBuffer) {\n\t\treturn Array.from(new Uint8Array(audio));\n\t}\n\n\tif (audio instanceof Blob) {\n\t\t// This also handles `File` (which extends Blob)\n\t\tconst buffer = await audio.arrayBuffer();\n\t\treturn Array.from(new Uint8Array(buffer));\n\t}\n\n\tif (typeof audio === \"string\") {\n\t\t// Assume base64 string — decode to bytes\n\t\tconst binary = atob(audio);\n\t\tconst bytes = new Uint8Array(binary.length);\n\t\tfor (let i = 0; i < binary.length; i++) {\n\t\t\tbytes[i] = binary.charCodeAt(i);\n\t\t}\n\t\treturn Array.from(bytes);\n\t}\n\n\tthrow new Error(\"Unsupported audio format. Expected string, File, Blob, or ArrayBuffer.\");\n}\n\n/**\n * Detect the MIME type of the audio input for models that require it\n * (e.g., Deepgram Nova-3).\n *\n * - `File` / `Blob`: use the `.type` property (e.g., \"audio/wav\")\n * - `ArrayBuffer` / `string`: defaults to \"audio/wav\"\n */\nfunction detectAudioContentType(audio: string | File | Blob | ArrayBuffer): string {\n\t// File and Blob carry their own MIME type\n\tif (audio instanceof Blob && audio.type) {\n\t\treturn audio.type;\n\t}\n\n\t// For raw bytes, default to audio/wav — this is the most common\n\t// format for transcription inputs and what the E2E tests use.\n\treturn \"audio/wav\";\n}\n"]}
+{"version":3,"sources":["/home/runner/work/ai/ai/packages/tanstack-ai/dist/chunk-XFQ3QESX.cjs","../src/adapters/workers-ai-transcription.ts"],"names":[],"mappings":"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","file":"/home/runner/work/ai/ai/packages/tanstack-ai/dist/chunk-XFQ3QESX.cjs","sourcesContent":[null,"import { BaseTranscriptionAdapter } from \"@tanstack/ai/adapters\";\nimport type { TranscriptionOptions, TranscriptionResult } from \"@tanstack/ai\";\nimport {\n\ttype WorkersAiAdapterConfig,\n\ttype WorkersAiDirectBindingConfig,\n\ttype WorkersAiDirectCredentialsConfig,\n\ttype AiGatewayAdapterConfig,\n\tcreateGatewayFetch,\n\tisDirectBindingConfig,\n\tisDirectCredentialsConfig,\n\tvalidateWorkersAiConfig,\n} from \"../utils/create-fetcher\";\nimport { workersAiRestFetch, workersAiRestFetchBinary } from \"../utils/workers-ai-rest\";\nimport { uint8ArrayToBase64 } from \"../utils/binary\";\n\n// ---------------------------------------------------------------------------\n// Model types\n// ---------------------------------------------------------------------------\n\n/**\n * Workers AI models that support speech-to-text transcription.\n *\n * Note: the typed `AiModels` interface in `@cloudflare/workers-types` may lag\n * behind what's deployed. We use a string union here that matches the known\n * models including Deepgram partner models.\n *\n * **Nova-3 note:** `@cf/deepgram/nova-3` uses a different input format than the\n * Whisper models. Via binding it accepts `{ audio: { body: base64, contentType } }`.\n * Via REST it requires multipart form data (not JSON). The adapter handles both.\n */\nexport type WorkersAiTranscriptionModel =\n\t| \"@cf/openai/whisper\"\n\t| \"@cf/openai/whisper-tiny-en\"\n\t| \"@cf/openai/whisper-large-v3-turbo\"\n\t| \"@cf/deepgram/nova-3\"\n\t| (string & {});\n\n// ---------------------------------------------------------------------------\n// WorkersAiTranscriptionAdapter\n// ---------------------------------------------------------------------------\n\nexport class WorkersAiTranscriptionAdapter extends BaseTranscriptionAdapter<WorkersAiTranscriptionModel> {\n\treadonly name = \"workers-ai-transcription\" as const;\n\tprivate adapterConfig: WorkersAiAdapterConfig;\n\n\tconstructor(config: WorkersAiAdapterConfig, model: WorkersAiTranscriptionModel) {\n\t\tsuper({}, model);\n\t\tvalidateWorkersAiConfig(config);\n\t\tthis.adapterConfig = config;\n\t}\n\n\tasync transcribe(options: TranscriptionOptions): Promise<TranscriptionResult> {\n\t\tconst { audio, language, prompt, modelOptions } = options;\n\n\t\t// Normalize audio to raw bytes\n\t\tconst audioBytes = await normalizeAudioToBytes(audio);\n\n\t\tconst extra: Record<string, unknown> = { ...modelOptions };\n\t\tif (language) extra.language = language;\n\t\tif (prompt) extra.initial_prompt = prompt;\n\n\t\t// Build the model-specific audio payload:\n\t\t// - Deepgram Nova-3 (binding): { audio: { body: base64, contentType: \"audio/...\" } }\n\t\t// - Deepgram Nova-3 (REST): multipart FormData (handled separately)\n\t\t// - Whisper Large v3 Turbo (REST/gateway): { audio: base64string }\n\t\t// - Other Whisper models (binding): { audio: number[] }\n\t\tconst audioPayload = this.buildAudioPayload(audioBytes, audio);\n\n\t\tif (isDirectBindingConfig(this.adapterConfig)) {\n\t\t\treturn this.transcribeViaBinding(audioPayload, extra);\n\t\t}\n\n\t\tif (isDirectCredentialsConfig(this.adapterConfig)) {\n\t\t\t// Nova-3 REST requires raw binary audio, not JSON\n\t\t\tif (this.model === \"@cf/deepgram/nova-3\") {\n\t\t\t\treturn this.transcribeViaRestBinary(audioBytes, audio, extra);\n\t\t\t}\n\t\t\treturn this.transcribeViaRest(audioPayload, extra);\n\t\t}\n\n\t\treturn this.transcribeViaGateway(audioPayload, extra);\n\t}\n\n\t/**\n\t * Build the audio field for the request payload, handling model-specific formats.\n\t *\n\t * - `@cf/deepgram/nova-3` requires `{ body: base64, contentType: \"audio/...\" }`\n\t * - `@cf/openai/whisper-large-v3-turbo` REST/gateway accepts a base64 string\n\t * - Other Whisper models accept `number[]` (binding) or base64 (REST)\n\t */\n\tprivate buildAudioPayload(\n\t\taudioBytes: number[],\n\t\toriginalAudio: string | File | Blob | ArrayBuffer,\n\t): Record<string, unknown> {\n\t\tif (this.model === \"@cf/deepgram/nova-3\") {\n\t\t\tconst b64 = uint8ArrayToBase64(new Uint8Array(audioBytes));\n\t\t\tconst contentType = detectAudioContentType(originalAudio);\n\t\t\treturn { audio: { body: b64, contentType } };\n\t\t}\n\n\t\tif (this.model === \"@cf/openai/whisper-large-v3-turbo\") {\n\t\t\treturn { audio: uint8ArrayToBase64(new Uint8Array(audioBytes)) };\n\t\t}\n\n\t\treturn { audio: audioBytes };\n\t}\n\n\tprivate async transcribeViaBinding(\n\t\taudioPayload: Record<string, unknown>,\n\t\toptions: Record<string, unknown>,\n\t): Promise<TranscriptionResult> {\n\t\tconst ai = (this.adapterConfig as WorkersAiDirectBindingConfig).binding;\n\t\tconst result = (await ai.run(this.model, {\n\t\t\t...audioPayload,\n\t\t\t...options,\n\t\t})) as Record<string, unknown>;\n\t\treturn this.normalizeResult(result);\n\t}\n\n\tprivate async transcribeViaRest(\n\t\taudioPayload: Record<string, unknown>,\n\t\toptions: Record<string, unknown>,\n\t): Promise<TranscriptionResult> {\n\t\tconst config = this.adapterConfig as WorkersAiDirectCredentialsConfig;\n\n\t\tconst response = await workersAiRestFetch(\n\t\t\tconfig,\n\t\t\tthis.model,\n\t\t\t{ ...audioPayload, ...options },\n\t\t\t{\n\t\t\t\tlabel: \"Workers AI transcription\",\n\t\t\t\tsignal: (options as { signal?: AbortSignal }).signal,\n\t\t\t},\n\t\t);\n\n\t\tconst data = (await response.json()) as {\n\t\t\tresult?: Record<string, unknown>;\n\t\t} & Record<string, unknown>;\n\n\t\t// Cloudflare REST API wraps responses in { success, result: {...} }.\n\t\t// Use `data.result` when present, fall back to `data` for direct responses.\n\t\treturn this.normalizeResult(data.result ?? data);\n\t}\n\n\t/**\n\t * Transcribe via REST using raw binary audio.\n\t * Required for models like Deepgram Nova-3 that expect raw audio bytes\n\t * with a Content-Type header (e.g. \"audio/wav\") instead of JSON.\n\t */\n\tprivate async transcribeViaRestBinary(\n\t\taudioBytes: number[],\n\t\toriginalAudio: string | File | Blob | ArrayBuffer,\n\t\toptions: Record<string, unknown>,\n\t): Promise<TranscriptionResult> {\n\t\tconst config = this.adapterConfig as WorkersAiDirectCredentialsConfig;\n\t\tconst contentType = detectAudioContentType(originalAudio);\n\n\t\tconst response = await workersAiRestFetchBinary(\n\t\t\tconfig,\n\t\t\tthis.model,\n\t\t\tnew Uint8Array(audioBytes),\n\t\t\tcontentType,\n\t\t\t{\n\t\t\t\tlabel: \"Workers AI transcription\",\n\t\t\t\tsignal: (options as { signal?: AbortSignal }).signal,\n\t\t\t},\n\t\t);\n\n\t\tconst data = (await response.json()) as {\n\t\t\tresult?: Record<string, unknown>;\n\t\t} & Record<string, unknown>;\n\n\t\treturn this.normalizeResult(data.result ?? data);\n\t}\n\n\tprivate async transcribeViaGateway(\n\t\taudioPayload: Record<string, unknown>,\n\t\toptions: Record<string, unknown>,\n\t): Promise<TranscriptionResult> {\n\t\tconst gatewayConfig = this.adapterConfig as AiGatewayAdapterConfig;\n\t\tconst gatewayFetch = createGatewayFetch(\"workers-ai\", gatewayConfig);\n\n\t\t// The URL here is a placeholder — createGatewayFetch for \"workers-ai\" extracts\n\t\t// the model from the body, sets it as the endpoint, and routes through the gateway.\n\t\t// The actual URL path is not used.\n\t\tconst response = await gatewayFetch(\"https://api.cloudflare.com/v1/audio/transcriptions\", {\n\t\t\tmethod: \"POST\",\n\t\t\tbody: JSON.stringify({\n\t\t\t\tmodel: this.model,\n\t\t\t\t...audioPayload,\n\t\t\t\t...options,\n\t\t\t}),\n\t\t});\n\n\t\tif (!response.ok) {\n\t\t\tconst errorText = await response.text();\n\t\t\tthrow new Error(\n\t\t\t\t`Workers AI transcription gateway request failed (${response.status}): ${errorText}`,\n\t\t\t);\n\t\t}\n\n\t\tconst data = (await response.json()) as Record<string, unknown>;\n\t\treturn this.normalizeResult(data);\n\t}\n\n\t/**\n\t * Normalize Workers AI transcription results into the standard\n\t * TanStack AI TranscriptionResult shape.\n\t *\n\t * Handles three response formats:\n\t * - Whisper: `{ text, words?, vtt? }`\n\t * - Whisper v3-turbo: `{ text, segments?, transcription_info? }`\n\t * - Deepgram Nova-3: `{ results: { channels: [{ alternatives: [{ transcript, words }] }] } }`\n\t */\n\tprivate normalizeResult(raw: Record<string, unknown>): TranscriptionResult {\n\t\t// Deepgram Nova-3 format: { results: { channels: [{ alternatives: [{ transcript, words }] }] } }\n\t\tconst results = raw.results as Record<string, unknown> | undefined;\n\t\tif (results?.channels) {\n\t\t\tconst channels = results.channels as Array<{\n\t\t\t\talternatives?: Array<{\n\t\t\t\t\ttranscript?: string;\n\t\t\t\t\tconfidence?: number;\n\t\t\t\t\twords?: Array<{ word: string; start: number; end: number; confidence: number }>;\n\t\t\t\t}>;\n\t\t\t}>;\n\t\t\tconst alt = channels?.[0]?.alternatives?.[0];\n\t\t\tconst text = alt?.transcript ?? \"\";\n\t\t\tconst result: TranscriptionResult = {\n\t\t\t\tid: this.generateId(),\n\t\t\t\tmodel: this.model,\n\t\t\t\ttext,\n\t\t\t};\n\t\t\tif (alt?.words && Array.isArray(alt.words)) {\n\t\t\t\tresult.words = alt.words.map((w) => ({\n\t\t\t\t\tword: w.word ?? \"\",\n\t\t\t\t\tstart: w.start ?? 0,\n\t\t\t\t\tend: w.end ?? 0,\n\t\t\t\t}));\n\t\t\t}\n\t\t\treturn result;\n\t\t}\n\n\t\t// Whisper format: { text, words?, vtt? }\n\t\t// Whisper v3-turbo format: { text, segments?, transcription_info? }\n\t\tconst result: TranscriptionResult = {\n\t\t\tid: this.generateId(),\n\t\t\tmodel: this.model,\n\t\t\ttext: (raw.text as string) ?? \"\",\n\t\t};\n\n\t\t// Language from transcription_info (whisper-large-v3-turbo)\n\t\tconst transcriptionInfo = raw.transcription_info as Record<string, unknown> | undefined;\n\t\tif (transcriptionInfo?.language) {\n\t\t\tresult.language = transcriptionInfo.language as string;\n\t\t}\n\n\t\t// Duration\n\t\tif (transcriptionInfo?.duration != null) {\n\t\t\tresult.duration = transcriptionInfo.duration as number;\n\t\t}\n\n\t\t// Segments (whisper-large-v3-turbo returns these)\n\t\tif (raw.segments && Array.isArray(raw.segments)) {\n\t\t\tresult.segments = raw.segments.map((seg: Record<string, unknown>, idx: number) => ({\n\t\t\t\tid: idx,\n\t\t\t\ttext: (seg.text as string) ?? \"\",\n\t\t\t\tstart: (seg.start as number) ?? 0,\n\t\t\t\tend: (seg.end as number) ?? 0,\n\t\t\t}));\n\t\t}\n\n\t\t// Words — basic whisper returns top-level words[], v3-turbo nests them in segments\n\t\tif (raw.words && Array.isArray(raw.words)) {\n\t\t\tresult.words = raw.words.map((w: Record<string, unknown>) => ({\n\t\t\t\tword: (w.word as string) ?? \"\",\n\t\t\t\tstart: (w.start as number) ?? 0,\n\t\t\t\tend: (w.end as number) ?? 0,\n\t\t\t}));\n\t\t}\n\n\t\treturn result;\n\t}\n}\n\n// ---------------------------------------------------------------------------\n// Factory function\n// ---------------------------------------------------------------------------\n\n/**\n * Creates a Workers AI transcription adapter for speech-to-text.\n *\n * Works with TanStack AI's `generateTranscription()` activity function:\n * ```ts\n * import { generateTranscription } from \"@tanstack/ai\";\n * import { createWorkersAiTranscription } from \"@cloudflare/tanstack-ai\";\n *\n * const adapter = createWorkersAiTranscription(\n *   \"@cf/openai/whisper-large-v3-turbo\",\n *   { binding: env.AI },\n * );\n *\n * const result = await generateTranscription({ adapter, audio: audioData });\n * // result.text — the transcribed text\n * ```\n *\n * Note: Factory takes `(model, config)` for ergonomics — the class constructor\n * uses `(config, model)` to match TanStack AI's upstream convention.\n */\nexport function createWorkersAiTranscription(\n\tmodel: WorkersAiTranscriptionModel,\n\tconfig: WorkersAiAdapterConfig,\n) {\n\treturn new WorkersAiTranscriptionAdapter(config, model);\n}\n\n// ---------------------------------------------------------------------------\n// Utilities\n// ---------------------------------------------------------------------------\n\n/**\n * Normalize various audio input formats into a number[] (raw bytes).\n *\n * Note: `File extends Blob`, so `File` instances are handled by the\n * `instanceof Blob` branch. `Blob.arrayBuffer()` always reads the full\n * contents regardless of any prior reads — there's no cursor to worry about.\n */\nasync function normalizeAudioToBytes(audio: string | File | Blob | ArrayBuffer): Promise<number[]> {\n\tif (audio instanceof ArrayBuffer) {\n\t\treturn Array.from(new Uint8Array(audio));\n\t}\n\n\tif (audio instanceof Blob) {\n\t\t// This also handles `File` (which extends Blob)\n\t\tconst buffer = await audio.arrayBuffer();\n\t\treturn Array.from(new Uint8Array(buffer));\n\t}\n\n\tif (typeof audio === \"string\") {\n\t\t// Assume base64 string — decode to bytes\n\t\tconst binary = atob(audio);\n\t\tconst bytes = new Uint8Array(binary.length);\n\t\tfor (let i = 0; i < binary.length; i++) {\n\t\t\tbytes[i] = binary.charCodeAt(i);\n\t\t}\n\t\treturn Array.from(bytes);\n\t}\n\n\tthrow new Error(\"Unsupported audio format. Expected string, File, Blob, or ArrayBuffer.\");\n}\n\n/**\n * Detect the MIME type of the audio input for models that require it\n * (e.g., Deepgram Nova-3).\n *\n * - `File` / `Blob`: use the `.type` property (e.g., \"audio/wav\")\n * - `ArrayBuffer` / `string`: defaults to \"audio/wav\"\n */\nfunction detectAudioContentType(audio: string | File | Blob | ArrayBuffer): string {\n\t// File and Blob carry their own MIME type\n\tif (audio instanceof Blob && audio.type) {\n\t\treturn audio.type;\n\t}\n\n\t// For raw bytes, default to audio/wav — this is the most common\n\t// format for transcription inputs and what the E2E tests use.\n\treturn \"audio/wav\";\n}\n"]}

package/dist/{chunk-DZZVI4W5.js → chunk-ZJMMBD6H.js}

@@ -10,7 +10,7 @@ import {
   isDirectBindingConfig,
   isDirectCredentialsConfig,
   validateWorkersAiConfig
-} from "./chunk-O7MBRPCW.js";
+} from "./chunk-S5QBHI6O.js";
 import {
   __publicField
 } from "./chunk-V6TY7KAL.js";
@@ -95,4 +95,4 @@ export {
   WorkersAiImageAdapter,
   createWorkersAiImage
 };
-//# sourceMappingURL=chunk-DZZVI4W5.js.map
+//# sourceMappingURL=chunk-ZJMMBD6H.js.map

package/dist/index.cjs

@@ -1,17 +1,17 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});
 
-var _chunkAYTKQRE4cjs = require('./chunk-AYTKQRE4.cjs');
+var _chunkXFQ3QESXcjs = require('./chunk-XFQ3QESX.cjs');
 
 
-var _chunkARLHMZ5Bcjs = require('./chunk-ARLHMZ5B.cjs');
+var _chunkKDVHOUEPcjs = require('./chunk-KDVHOUEP.cjs');
 
 
-var _chunkLG2I3ANTcjs = require('./chunk-LG2I3ANT.cjs');
+var _chunk32U73O6Ecjs = require('./chunk-32U73O6E.cjs');
 
 
 
 
-var _chunk7KZQWFUEcjs = require('./chunk-7KZQWFUE.cjs');
+var _chunkMMTLH53Hcjs = require('./chunk-MMTLH53H.cjs');
 
 
 
@@ -28,7 +28,7 @@ var _chunkV4LKHWJAcjs = require('./chunk-V4LKHWJA.cjs');
 
 
 
-var _chunkUWBO33IGcjs = require('./chunk-UWBO33IG.cjs');
+var _chunkKW27GIQLcjs = require('./chunk-KW27GIQL.cjs');
 
 
 
@@ -41,21 +41,21 @@ var _chunkUWBO33IGcjs = require('./chunk-UWBO33IG.cjs');
 
 
 
-var _chunkICHJ2G63cjs = require('./chunk-ICHJ2G63.cjs');
+var _chunkTG4UQPGBcjs = require('./chunk-TG4UQPGB.cjs');
 
 
 
 
-var _chunk7SKFZ4SUcjs = require('./chunk-7SKFZ4SU.cjs');
+var _chunkU2PMR3PTcjs = require('./chunk-U2PMR3PT.cjs');
 
 
-var _chunkZHTFBZXJcjs = require('./chunk-ZHTFBZXJ.cjs');
+var _chunk3PJHW45Xcjs = require('./chunk-3PJHW45X.cjs');
 require('./chunk-3VQDXJLW.cjs');
 
 
-var _chunkIDPLTBQXcjs = require('./chunk-IDPLTBQX.cjs');
+var _chunkH24HFVUJcjs = require('./chunk-H24HFVUJ.cjs');
 require('./chunk-7HSUHP63.cjs');
-require('./chunk-IMURYJRF.cjs');
+require('./chunk-U5NL4EM4.cjs');
 require('./chunk-4DE2IREA.cjs');
 
 
@@ -93,5 +93,5 @@ require('./chunk-4DE2IREA.cjs');
 
 
 
-exports.ANTHROPIC_MODELS = _chunk7KZQWFUEcjs.ANTHROPIC_MODELS; exports.GROK_CHAT_MODELS = _chunkUWBO33IGcjs.GROK_CHAT_MODELS; exports.GROK_IMAGE_MODELS = _chunkUWBO33IGcjs.GROK_IMAGE_MODELS; exports.GeminiImageModels = _chunkV4LKHWJAcjs.GeminiImageModels; exports.GeminiSummarizeModels = _chunkV4LKHWJAcjs.GeminiSummarizeModels; exports.GeminiTTSModels = _chunkV4LKHWJAcjs.GeminiTTSModels; exports.GeminiTextModels = _chunkV4LKHWJAcjs.GeminiTextModels; exports.OPENAI_CHAT_MODELS = _chunkICHJ2G63cjs.OPENAI_CHAT_MODELS; exports.OPENAI_IMAGE_MODELS = _chunkICHJ2G63cjs.OPENAI_IMAGE_MODELS; exports.OPENAI_TRANSCRIPTION_MODELS = _chunkICHJ2G63cjs.OPENAI_TRANSCRIPTION_MODELS; exports.OPENAI_TTS_MODELS = _chunkICHJ2G63cjs.OPENAI_TTS_MODELS; exports.OPENAI_VIDEO_MODELS = _chunkICHJ2G63cjs.OPENAI_VIDEO_MODELS; exports.createAnthropicChat = _chunk7KZQWFUEcjs.createAnthropicChat; exports.createAnthropicSummarize = _chunk7KZQWFUEcjs.createAnthropicSummarize; exports.createGeminiChat = _chunkV4LKHWJAcjs.createGeminiChat; exports.createGeminiImage = _chunkV4LKHWJAcjs.createGeminiImage; exports.createGeminiSummarize = _chunkV4LKHWJAcjs.createGeminiSummarize; exports.createGeminiTts = _chunkV4LKHWJAcjs.createGeminiTts; exports.createGrokChat = _chunkUWBO33IGcjs.createGrokChat; exports.createGrokImage = _chunkUWBO33IGcjs.createGrokImage; exports.createGrokSummarize = _chunkUWBO33IGcjs.createGrokSummarize; exports.createOpenAiChat = _chunkICHJ2G63cjs.createOpenAiChat; exports.createOpenAiImage = _chunkICHJ2G63cjs.createOpenAiImage; exports.createOpenAiSummarize = _chunkICHJ2G63cjs.createOpenAiSummarize; exports.createOpenAiTranscription = _chunkICHJ2G63cjs.createOpenAiTranscription; exports.createOpenAiTts = _chunkICHJ2G63cjs.createOpenAiTts; exports.createOpenAiVideo = _chunkICHJ2G63cjs.createOpenAiVideo; exports.createOpenRouterChat = _chunk7SKFZ4SUcjs.createOpenRouterChat; exports.createOpenRouterImage = _chunk7SKFZ4SUcjs.createOpenRouterImage; exports.createOpenRouterSummarize = _chunk7SKFZ4SUcjs.createOpenRouterSummarize; exports.createWorkersAiChat = _chunkLG2I3ANTcjs.createWorkersAiChat; exports.createWorkersAiImage = _chunkZHTFBZXJcjs.createWorkersAiImage; exports.createWorkersAiSummarize = _chunkIDPLTBQXcjs.createWorkersAiSummarize; exports.createWorkersAiTranscription = _chunkAYTKQRE4cjs.createWorkersAiTranscription; exports.createWorkersAiTts = _chunkARLHMZ5Bcjs.createWorkersAiTts;
+exports.ANTHROPIC_MODELS = _chunkMMTLH53Hcjs.ANTHROPIC_MODELS; exports.GROK_CHAT_MODELS = _chunkKW27GIQLcjs.GROK_CHAT_MODELS; exports.GROK_IMAGE_MODELS = _chunkKW27GIQLcjs.GROK_IMAGE_MODELS; exports.GeminiImageModels = _chunkV4LKHWJAcjs.GeminiImageModels; exports.GeminiSummarizeModels = _chunkV4LKHWJAcjs.GeminiSummarizeModels; exports.GeminiTTSModels = _chunkV4LKHWJAcjs.GeminiTTSModels; exports.GeminiTextModels = _chunkV4LKHWJAcjs.GeminiTextModels; exports.OPENAI_CHAT_MODELS = _chunkTG4UQPGBcjs.OPENAI_CHAT_MODELS; exports.OPENAI_IMAGE_MODELS = _chunkTG4UQPGBcjs.OPENAI_IMAGE_MODELS; exports.OPENAI_TRANSCRIPTION_MODELS = _chunkTG4UQPGBcjs.OPENAI_TRANSCRIPTION_MODELS; exports.OPENAI_TTS_MODELS = _chunkTG4UQPGBcjs.OPENAI_TTS_MODELS; exports.OPENAI_VIDEO_MODELS = _chunkTG4UQPGBcjs.OPENAI_VIDEO_MODELS; exports.createAnthropicChat = _chunkMMTLH53Hcjs.createAnthropicChat; exports.createAnthropicSummarize = _chunkMMTLH53Hcjs.createAnthropicSummarize; exports.createGeminiChat = _chunkV4LKHWJAcjs.createGeminiChat; exports.createGeminiImage = _chunkV4LKHWJAcjs.createGeminiImage; exports.createGeminiSummarize = _chunkV4LKHWJAcjs.createGeminiSummarize; exports.createGeminiTts = _chunkV4LKHWJAcjs.createGeminiTts; exports.createGrokChat = _chunkKW27GIQLcjs.createGrokChat; exports.createGrokImage = _chunkKW27GIQLcjs.createGrokImage; exports.createGrokSummarize = _chunkKW27GIQLcjs.createGrokSummarize; exports.createOpenAiChat = _chunkTG4UQPGBcjs.createOpenAiChat; exports.createOpenAiImage = _chunkTG4UQPGBcjs.createOpenAiImage; exports.createOpenAiSummarize = _chunkTG4UQPGBcjs.createOpenAiSummarize; exports.createOpenAiTranscription = _chunkTG4UQPGBcjs.createOpenAiTranscription; exports.createOpenAiTts = _chunkTG4UQPGBcjs.createOpenAiTts; exports.createOpenAiVideo = _chunkTG4UQPGBcjs.createOpenAiVideo; exports.createOpenRouterChat = _chunkU2PMR3PTcjs.createOpenRouterChat; exports.createOpenRouterImage = _chunkU2PMR3PTcjs.createOpenRouterImage; exports.createOpenRouterSummarize = _chunkU2PMR3PTcjs.createOpenRouterSummarize; exports.createWorkersAiChat = _chunk32U73O6Ecjs.createWorkersAiChat; exports.createWorkersAiImage = _chunk3PJHW45Xcjs.createWorkersAiImage; exports.createWorkersAiSummarize = _chunkH24HFVUJcjs.createWorkersAiSummarize; exports.createWorkersAiTranscription = _chunkXFQ3QESXcjs.createWorkersAiTranscription; exports.createWorkersAiTts = _chunkKDVHOUEPcjs.createWorkersAiTts;
 //# sourceMappingURL=index.cjs.map

package/dist/index.js

@@ -1,17 +1,17 @@
 import {
   createWorkersAiTranscription
-} from "./chunk-T5KPTTLK.js";
+} from "./chunk-DG46OSFY.js";
 import {
   createWorkersAiTts
-} from "./chunk-2QN5XFI2.js";
+} from "./chunk-QMRONSLN.js";
 import {
   createWorkersAiChat
-} from "./chunk-3KUHT3K6.js";
+} from "./chunk-NSWLVANP.js";
 import {
   ANTHROPIC_MODELS,
   createAnthropicChat,
   createAnthropicSummarize
-} from "./chunk-DSBHOQQ4.js";
+} from "./chunk-MOAWHNNP.js";
 import {
   GeminiImageModels,
   GeminiSummarizeModels,
@@ -28,7 +28,7 @@ import {
   createGrokChat,
   createGrokImage,
   createGrokSummarize
-} from "./chunk-Y7W7NDVS.js";
+} from "./chunk-OGAH3FYW.js";
 import {
   OPENAI_CHAT_MODELS,
   OPENAI_IMAGE_MODELS,
@@ -41,21 +41,21 @@ import {
   createOpenAiTranscription,
   createOpenAiTts,
   createOpenAiVideo
-} from "./chunk-5A2F2QCL.js";
+} from "./chunk-RWLCEKT6.js";
 import {
   createOpenRouterChat,
   createOpenRouterImage,
   createOpenRouterSummarize
-} from "./chunk-JK5ZFOZZ.js";
+} from "./chunk-I2MCLFJ5.js";
 import {
   createWorkersAiImage
-} from "./chunk-DZZVI4W5.js";
+} from "./chunk-ZJMMBD6H.js";
 import "./chunk-XU7YEPML.js";
 import {
   createWorkersAiSummarize
-} from "./chunk-OKU3GB5P.js";
+} from "./chunk-IPEZXCDR.js";
 import "./chunk-2VII5BK2.js";
-import "./chunk-O7MBRPCW.js";
+import "./chunk-S5QBHI6O.js";
 import "./chunk-V6TY7KAL.js";
 export {
   ANTHROPIC_MODELS,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cloudflare/tanstack-ai",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "Use TanStack AI with Cloudflare Workers AI and AI Gateway",
   "keywords": [
     "ai",
@@ -88,32 +88,33 @@
     "access": "public"
   },
   "dependencies": {
-    "openai": "^6.21.0"
+    "openai": "^6.22.0"
   },
   "devDependencies": {
-    "@cloudflare/workers-types": "^4.20260212.0",
-    "@microsoft/api-extractor": "^7.56.3",
-    "@tanstack/ai": "^0.5.0",
-    "dotenv": "^17.2.4"
+    "@cloudflare/workers-types": "^4.20260227.0",
+    "@microsoft/api-extractor": "^7.57.1",
+    "@tanstack/ai": "^0.5.1",
+    "dotenv": "^17.3.1"
   },
   "peerDependencies": {
     "@tanstack/ai": "^0.5.0"
   },
   "optionalDependencies": {
-    "@anthropic-ai/sdk": "^0.74.0",
-    "@google/genai": "^1.41.0",
+    "@anthropic-ai/sdk": "^0.78.0",
+    "@google/genai": "^1.42.0",
     "@openrouter/sdk": "^0.8.0",
     "@tanstack/ai-anthropic": "^0.5.0",
     "@tanstack/ai-gemini": "^0.5.0",
     "@tanstack/ai-grok": "^0.5.0",
     "@tanstack/ai-openai": "^0.5.0",
-    "@tanstack/ai-openrouter": "^0.5.0"
+    "@tanstack/ai-openrouter": "^0.5.1"
   },
   "scripts": {
     "build": "rm -rf dist && tsup --config tsup.config.ts",
     "format": "biome format --write",
     "type-check": "tsc --noEmit",
-    "test": "vitest",
+    "test": "vitest --run",
+    "test:watch": "vitest",
     "test:ci": "vitest --watch=false",
     "test:e2e": "vitest --config vitest.e2e.config.ts --watch=false",
     "test:e2e:rest": "vitest --config vitest.e2e.config.ts --watch=false test/e2e/workers-ai-rest.e2e.test.ts",