veryfront 0.1.263 → 0.1.264

package/esm/src/provider/runtime-loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime-loader.d.ts","sourceRoot":"","sources":["../../../src/src/provider/runtime-loader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAejE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AAGtE,OAAO,EACL,+BAA+B,EAC/B,8BAA8B,EAC/B,MAAM,uCAAuC,CAAC;AAE/C,OAAO,EACL,aAAa,EACb,uBAAuB,EACvB,kBAAkB,EAClB,sBAAsB,EACtB,oBAAoB,GACrB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAE,+BAA+B,EAAE,8BAA8B,EAAE,CAAC;AAE3E,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;CACjC;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;CACjC;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;CACjC;AAiaD;;;;;;GAMG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,qBAAqB,GAAG,OAAO,CAAC;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,YAAY,CAAC;CACxB,CAAC;AAilEF,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,mBAAmB,EAC3B,OAAO,EAAE,MAAM,GACd,YAAY,CAsEd;AA4jBD,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,mBAAmB,EAC3B,OAAO,EAAE,MAAM,GACd,YAAY,CAsEd;AAED,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,sBAAsB,EAC9B,OAAO,EAAE,MAAM,GACd,YAAY,CAyEd;AAED,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,mBAAmB,EAC3B,OAAO,EAAE,MAAM,GACd,YAAY,CAkEd;AAED,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,mBAAmB,EAC3B,OAAO,EAAE,MAAM,GACd,gBAAgB,CAuClB;AAED,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,mBAAmB,EAC3B,OAAO,EAAE,MAAM,GACd,gBAAgB,CA6ClB"}
+{"version":3,"file":"runtime-loader.d.ts","sourceRoot":"","sources":["../../../src/src/provider/runtime-loader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAoCjE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AAGtE,OAAO,EACL,+BAA+B,EAC/B,8BAA8B,EAC/B,MAAM,uCAAuC,CAAC;AAE/C,OAAO,EACL,aAAa,EACb,uBAAuB,EACvB,kBAAkB,EAClB,sBAAsB,EACtB,oBAAoB,GACrB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAE,+BAA+B,EAAE,8BAA8B,EAAE,CAAC;AAE3E,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;CACjC;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;CACjC;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;CACjC;AAqWD;;;;;;GAMG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,qBAAqB,GAAG,OAAO,CAAC;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,YAAY,CAAC;CACxB,CAAC;AAm5DF,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,mBAAmB,EAC3B,OAAO,EAAE,MAAM,GACd,YAAY,CAsEd;AA0gBD,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,mBAAmB,EAC3B,OAAO,EAAE,MAAM,GACd,YAAY,CAsEd;AAED,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,sBAAsB,EAC9B,OAAO,EAAE,MAAM,GACd,YAAY,CAyEd;AAED,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,mBAAmB,EAC3B,OAAO,EAAE,MAAM,GACd,YAAY,CAkEd;AAED,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,mBAAmB,EAC3B,OAAO,EAAE,MAAM,GACd,gBAAgB,CAuClB;AAED,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,mBAAmB,EAC3B,OAAO,EAAE,MAAM,GACd,gBAAgB,CA6ClB"}

package/esm/src/provider/runtime-loader.js

@@ -1,59 +1,14 @@
 import { getAnthropicMessagesUrl, getGoogleEmbeddingUrl, getGoogleGenerateContentUrl, getGoogleStreamGenerateContentUrl, getOpenAIChatCompletionsUrl, getOpenAIEmbeddingUrl, getOpenAIResponsesUrl, } from "./runtime-loader/provider-endpoints.js";
+import { extractGoogleEmbedding, extractGoogleUsageTokens, extractOpenAIEmbeddings, extractOpenAIUsageTokens, } from "./runtime-loader/provider-embedding-responses.js";
+import { normalizeAnthropicFinishReason, normalizeGoogleFinishReason, normalizeOpenAIFinishReason, normalizeOpenAIResponsesFinishReason, } from "./runtime-loader/provider-finish-reasons.js";
 import { createAnthropicRequestInit, createGoogleRequestInit, createOpenAIRequestInit, } from "./runtime-loader/provider-request-init.js";
+import { parseSseChunk } from "./runtime-loader/provider-sse.js";
+import { extractAnthropicUsage, extractGoogleUsage, extractOpenAIResponsesUsage, extractOpenAIUsage, mergeUsage, } from "./runtime-loader/provider-usage.js";
 import { requestJson, requestStream } from "./runtime-loader/provider-http.js";
 import { readRecord } from "./runtime-loader/provider-records.js";
 import { TOOL_INPUT_PENDING_THRESHOLD_MS, withToolInputStatusTransitions, } from "./runtime-loader/tool-input-status.js";
 export { ProviderError, ProviderOverloadedError, ProviderQuotaError, ProviderRateLimitError, ProviderRequestError, } from "./runtime-loader/provider-http.js";
 export { TOOL_INPUT_PENDING_THRESHOLD_MS, withToolInputStatusTransitions };
-function isNumberArray(value) {
-    return Array.isArray(value) && value.every((entry) => typeof entry === "number");
-}
-function extractOpenAIEmbeddings(payload) {
-    const record = readRecord(payload);
-    const data = record?.data;
-    if (!Array.isArray(data)) {
-        throw new Error("Invalid OpenAI embedding response: data array missing");
-    }
-    const embeddings = [];
-    for (const item of data) {
-        const itemRecord = readRecord(item);
-        const embedding = itemRecord?.embedding;
-        if (!isNumberArray(embedding)) {
-            throw new Error("Invalid OpenAI embedding response: embedding vector missing");
-        }
-        embeddings.push(embedding);
-    }
-    return embeddings;
-}
-function extractOpenAIUsageTokens(payload) {
-    const record = readRecord(payload);
-    const usage = readRecord(record?.usage);
-    const totalTokens = usage?.total_tokens;
-    return typeof totalTokens === "number" ? totalTokens : undefined;
-}
-function extractGoogleEmbedding(payload) {
-    const record = readRecord(payload);
-    const embeddings = record?.embeddings;
-    if (Array.isArray(embeddings) && embeddings.length > 0) {
-        const firstEmbedding = readRecord(embeddings[0]);
-        const values = firstEmbedding?.values;
-        if (isNumberArray(values)) {
-            return values;
-        }
-    }
-    const embedding = readRecord(record?.embedding);
-    const values = embedding?.values;
-    if (isNumberArray(values)) {
-        return values;
-    }
-    throw new Error("Invalid Google embedding response: embedding vector missing");
-}
-function extractGoogleUsageTokens(payload) {
-    const record = readRecord(payload);
-    const usageMetadata = readRecord(record?.usageMetadata);
-    const promptTokenCount = usageMetadata?.promptTokenCount;
-    return typeof promptTokenCount === "number" ? promptTokenCount : undefined;
-}
 function createWarningCollector() {
     const list = [];
     return {
@@ -162,63 +117,6 @@ function readProviderOptions(providerOptions, ...providerNames) {
     }
     return merged;
 }
-function normalizeAnthropicFinishReason(raw) {
-    if (typeof raw !== "string") {
-        return null;
-    }
-    switch (raw) {
-        case "tool_use":
-            return { unified: "tool-calls", raw };
-        case "end_turn":
-        case "stop_sequence":
-            return { unified: "stop", raw };
-        case "max_tokens":
-            return { unified: "length", raw };
-        default:
-            return raw;
-    }
-}
-function extractAnthropicUsage(payload) {
-    const record = readRecord(payload);
-    const usage = readRecord(record?.usage);
-    if (!usage) {
-        return undefined;
-    }
-    const inputTokens = usage.input_tokens;
-    const outputTokens = usage.output_tokens;
-    const cacheCreationInputTokens = usage.cache_creation_input_tokens;
-    const cacheReadInputTokens = usage.cache_read_input_tokens;
-    return {
-        inputTokens: typeof inputTokens === "number" ? inputTokens : undefined,
-        outputTokens: typeof outputTokens === "number" ? outputTokens : undefined,
-        totalTokens: typeof inputTokens === "number" || typeof outputTokens === "number"
-            ? (typeof inputTokens === "number" ? inputTokens : 0) +
-                (typeof outputTokens === "number" ? outputTokens : 0)
-            : undefined,
-        ...(typeof cacheCreationInputTokens === "number" ? { cacheCreationInputTokens } : {}),
-        ...(typeof cacheReadInputTokens === "number" ? { cacheReadInputTokens } : {}),
-    };
-}
-function mergeUsage(current, next) {
-    if (!current) {
-        return next;
-    }
-    if (!next) {
-        return current;
-    }
-    const inputTokens = next.inputTokens ?? current.inputTokens;
-    const outputTokens = next.outputTokens ?? current.outputTokens;
-    const cacheCreationInputTokens = next.cacheCreationInputTokens ??
-        current.cacheCreationInputTokens;
-    const cacheReadInputTokens = next.cacheReadInputTokens ?? current.cacheReadInputTokens;
-    return {
-        inputTokens,
-        outputTokens,
-        totalTokens: (inputTokens ?? 0) + (outputTokens ?? 0),
-        ...(cacheCreationInputTokens !== undefined ? { cacheCreationInputTokens } : {}),
-        ...(cacheReadInputTokens !== undefined ? { cacheReadInputTokens } : {}),
-    };
-}
 function normalizeAnthropicToolChoice(toolChoice) {
     if (typeof toolChoice === "string") {
         return { type: toolChoice };
@@ -730,29 +628,6 @@ function buildAnthropicGenerateResult(payload) {
         usage: extractAnthropicUsage(payload),
     };
 }
-function parseSseChunk(chunk) {
-    const blocks = chunk.split(/\r?\n\r?\n/);
-    const remainder = blocks.pop() ?? "";
-    const events = blocks.flatMap((block) => {
-        const dataLines = block.split(/\r?\n/)
-            .filter((line) => line.startsWith("data:"))
-            .map((line) => line.slice(5).trimStart());
-        if (!dataLines.length) {
-            return [];
-        }
-        const payload = dataLines.join("\n").trim();
-        if (payload === "[DONE]") {
-            return ["[DONE]"];
-        }
-        try {
-            return [JSON.parse(payload)];
-        }
-        catch {
-            return [];
-        }
-    });
-    return { events, remainder };
-}
 async function* streamAnthropicCompatibleParts(stream) {
     const decoder = new TextDecoder();
     let buffer = "";
@@ -951,36 +826,6 @@ async function* streamAnthropicCompatibleParts(stream) {
         ...(usage ? { usage } : {}),
     };
 }
-function normalizeOpenAIFinishReason(raw) {
-    if (typeof raw !== "string") {
-        return null;
-    }
-    if (raw === "tool_calls") {
-        return { unified: "tool-calls", raw };
-    }
-    if (raw === "content_filter") {
-        return { unified: "content-filter", raw };
-    }
-    return raw;
-}
-function extractOpenAIUsage(payload) {
-    const record = readRecord(payload);
-    const usage = readRecord(record?.usage);
-    if (!usage) {
-        return undefined;
-    }
-    const inputTokens = usage.prompt_tokens;
-    const outputTokens = usage.completion_tokens;
-    const totalTokens = usage.total_tokens;
-    const promptTokensDetails = readRecord(usage.prompt_tokens_details);
-    const cachedTokens = promptTokensDetails?.cached_tokens;
-    return {
-        inputTokens: typeof inputTokens === "number" ? inputTokens : undefined,
-        outputTokens: typeof outputTokens === "number" ? outputTokens : undefined,
-        totalTokens: typeof totalTokens === "number" ? totalTokens : undefined,
-        ...(typeof cachedTokens === "number" ? { cacheReadInputTokens: cachedTokens } : {}),
-    };
-}
 function extractOpenAIContentText(content) {
     if (typeof content === "string") {
         return content;
@@ -1173,41 +1018,6 @@ function buildOpenAIChatRequest(modelId, providerName, options, stream, warnings
     Object.assign(body, providerOpts);
     return body;
 }
-function normalizeGoogleFinishReason(raw) {
-    if (typeof raw !== "string") {
-        return null;
-    }
-    switch (raw) {
-        case "STOP":
-            return { unified: "stop", raw };
-        case "MAX_TOKENS":
-            return { unified: "length", raw };
-        case "SAFETY":
-        case "RECITATION":
-            return { unified: "content-filter", raw };
-        default:
-            return raw.toLowerCase();
-    }
-}
-function extractGoogleUsage(payload) {
-    const record = readRecord(payload);
-    const usage = readRecord(record?.usageMetadata);
-    if (!usage) {
-        return undefined;
-    }
-    const inputTokens = usage.promptTokenCount;
-    const outputTokens = usage.candidatesTokenCount;
-    const totalTokens = usage.totalTokenCount;
-    const cachedContentTokenCount = usage.cachedContentTokenCount;
-    return {
-        inputTokens: typeof inputTokens === "number" ? inputTokens : undefined,
-        outputTokens: typeof outputTokens === "number" ? outputTokens : undefined,
-        totalTokens: typeof totalTokens === "number" ? totalTokens : undefined,
-        ...(typeof cachedContentTokenCount === "number"
-            ? { cacheReadInputTokens: cachedContentTokenCount }
-            : {}),
-    };
-}
 function toGoogleContents(prompt) {
     const systemParts = [];
     const contents = [];
@@ -2047,52 +1857,6 @@ function buildOpenAIResponsesRequest(modelId, providerName, options, stream, war
     Object.assign(body, readProviderOptions(options.providerOptions, "openai", providerName));
     return body;
 }
-/**
- * The Responses API uses `input_tokens` / `output_tokens` field names
- * instead of Chat Completions' `prompt_tokens` / `completion_tokens`.
- * It also nests cached input tokens under `input_tokens_details` and
- * exposes reasoning tokens via `output_tokens_details.reasoning_tokens`.
- */
-function extractOpenAIResponsesUsage(payload) {
-    const record = readRecord(payload);
-    // Streaming usage lives on response.completed inside `response.usage`;
-    // non-streaming has it at the top level.
-    const responseRecord = readRecord(record?.response);
-    const usage = readRecord(responseRecord?.usage) ?? readRecord(record?.usage);
-    if (!usage)
-        return undefined;
-    const inputTokens = typeof usage.input_tokens === "number" ? usage.input_tokens : undefined;
-    const outputTokens = typeof usage.output_tokens === "number" ? usage.output_tokens : undefined;
-    const totalTokens = typeof usage.total_tokens === "number"
-        ? usage.total_tokens
-        : (inputTokens !== undefined || outputTokens !== undefined
-            ? (inputTokens ?? 0) + (outputTokens ?? 0)
-            : undefined);
-    const inputDetails = readRecord(usage.input_tokens_details);
-    const cachedTokens = inputDetails?.cached_tokens;
-    return {
-        inputTokens,
-        outputTokens,
-        totalTokens,
-        ...(typeof cachedTokens === "number" ? { cacheReadInputTokens: cachedTokens } : {}),
-    };
-}
-function normalizeOpenAIResponsesFinishReason(raw) {
-    if (typeof raw !== "string")
-        return null;
-    switch (raw) {
-        case "completed":
-            return { unified: "stop", raw };
-        case "incomplete":
-            return { unified: "length", raw };
-        case "failed":
-            return { unified: "error", raw };
-        case "in_progress":
-            return null;
-        default:
-            return raw;
-    }
-}
 function buildOpenAIResponsesGenerateResult(payload) {
     const record = readRecord(payload);
     const output = Array.isArray(record?.output) ? record.output : [];

package/esm/src/utils/version-constant.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.1.263";
+export declare const VERSION = "0.1.264";
 //# sourceMappingURL=version-constant.d.ts.map

package/esm/src/utils/version-constant.js

@@ -1,3 +1,3 @@
 // Keep in sync with deno.json version.
 // scripts/release.ts updates this constant during releases.
-export const VERSION = "0.1.263";
+export const VERSION = "0.1.264";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "veryfront",
-  "version": "0.1.263",
+  "version": "0.1.264",
   "description": "The simplest way to build AI-powered apps",
   "keywords": [
     "react",

package/src/deno.js

@@ -1,6 +1,6 @@
 export default {
   "name": "veryfront",
-  "version": "0.1.263",
+  "version": "0.1.264",
   "license": "Apache-2.0",
   "nodeModulesDir": "auto",
   "workspace": [

package/src/src/agent/index.ts

@@ -398,6 +398,11 @@ export {
   normalizeChatUiMessageChunk,
   normalizeChatUiMessageStream,
 } from "../chat/chat-ui-message-helpers.js";
+export {
+  type HostedStreamPartForUiChunkMapping,
+  type HostedUiChunkMappingOptions,
+  mapHostedStreamPartToChatUiChunks,
+} from "../chat/hosted-ui-chunk-mapping.js";
 export {
   expandAllowedRemoteToolNames,
   getProviderNativeToolNames,

package/src/src/chat/hosted-ui-chunk-mapping.ts

@@ -0,0 +1,303 @@
+import type { ChatMessageMetadata, ChatUiMessageChunk } from "./protocol.js";
+
+export type HostedUiChunkMappingOptions = {
+  messageId?: string | null;
+  reasoningMessageId?: string | null;
+  sendReasoning?: boolean;
+  sendSources?: boolean;
+  onError?: (error: unknown) => string;
+};
+
+export type HostedStreamSourcePart =
+  | {
+    type: "source";
+    id: string;
+    sourceType: "url";
+    url: string;
+    title?: string;
+  }
+  | {
+    type: "source";
+    id: string;
+    sourceType: "document";
+    mediaType: string;
+    title?: string;
+    filename?: string;
+  };
+
+export type HostedStreamPartForUiChunkMapping =
+  | {
+    type: "start";
+  }
+  | {
+    type: "start-step";
+  }
+  | {
+    type: "finish-step";
+  }
+  | {
+    type: "finish";
+    finishReason?: string;
+  }
+  | {
+    type: "abort";
+  }
+  | {
+    type: "reasoning-start";
+    id: string;
+  }
+  | {
+    type: "reasoning-delta";
+    id: string;
+    text: string;
+  }
+  | {
+    type: "reasoning-end";
+    id: string;
+  }
+  | {
+    type: "text-start";
+    id: string;
+  }
+  | {
+    type: "text-delta";
+    id: string;
+    text: string;
+  }
+  | {
+    type: "text-end";
+    id: string;
+  }
+  | HostedStreamSourcePart
+  | {
+    type: "file";
+    file: {
+      mediaType: string;
+      base64: string;
+    };
+  }
+  | {
+    type: "tool-input-start";
+    id: string;
+    toolName: string;
+  }
+  | {
+    type: "tool-input-delta";
+    id: string;
+    delta: string;
+  }
+  | {
+    type: "tool-call";
+    toolCallId: string;
+    toolName: string;
+    input: unknown;
+    invalid: true;
+    error: unknown;
+  }
+  | {
+    type: "tool-call";
+    toolCallId: string;
+    toolName: string;
+    input: unknown;
+    invalid?: false;
+  }
+  | {
+    type: "tool-approval-request";
+    approvalId: string;
+    toolCall: {
+      toolCallId: string;
+    };
+  }
+  | {
+    type: "tool-result";
+    toolCallId: string;
+    toolName: string;
+    input: unknown;
+    output: unknown;
+  }
+  | {
+    type: "tool-error";
+    toolCallId: string;
+    toolName: string;
+    input: unknown;
+    error: unknown;
+  }
+  | {
+    type: "tool-output-denied";
+    toolCallId: string;
+  }
+  | {
+    type: "error";
+    error: unknown;
+  }
+  | {
+    type: "tool-input-end";
+  }
+  | {
+    type: "raw";
+  };
+
+function defaultOnError(error: unknown): string {
+  return error instanceof Error ? error.message : String(error);
+}
+
+function mapHostedStreamSourceToUiChunks(
+  part: HostedStreamSourcePart,
+  sendSources: boolean,
+): ChatUiMessageChunk<ChatMessageMetadata>[] {
+  if (!sendSources) {
+    return [];
+  }
+
+  if (part.sourceType === "url") {
+    return [{
+      type: "source-url",
+      sourceId: part.id,
+      url: part.url,
+      ...(part.title ? { title: part.title } : {}),
+    }];
+  }
+
+  return [
+    {
+      type: "source-document",
+      sourceId: part.id,
+      mediaType: part.mediaType,
+      title: part.title ?? part.filename ?? part.id,
+      ...(part.filename ? { filename: part.filename } : {}),
+    },
+  ];
+}
+
+function mapToolCallPartToUiChunks(
+  part: Extract<HostedStreamPartForUiChunkMapping, { type: "tool-call" }>,
+  onError: (error: unknown) => string,
+): ChatUiMessageChunk<ChatMessageMetadata>[] {
+  if (part.invalid) {
+    return [{
+      type: "tool-input-error",
+      toolCallId: part.toolCallId,
+      toolName: part.toolName,
+      input: part.input,
+      errorText: onError(part.error),
+    }];
+  }
+
+  return [{
+    type: "tool-input-available",
+    toolCallId: part.toolCallId,
+    toolName: part.toolName,
+    input: part.input,
+  }];
+}
+
+function mapToolErrorPartToUiChunks(
+  part: Extract<HostedStreamPartForUiChunkMapping, { type: "tool-error" }>,
+  onError: (error: unknown) => string,
+): ChatUiMessageChunk<ChatMessageMetadata>[] {
+  return [
+    {
+      type: "tool-input-start",
+      toolCallId: part.toolCallId,
+      toolName: part.toolName,
+    },
+    {
+      type: "tool-input-error",
+      toolCallId: part.toolCallId,
+      toolName: part.toolName,
+      input: part.input,
+      errorText: onError(part.error),
+    },
+  ];
+}
+
+export function mapHostedStreamPartToChatUiChunks(
+  part: HostedStreamPartForUiChunkMapping,
+  options: HostedUiChunkMappingOptions = {},
+): ChatUiMessageChunk<ChatMessageMetadata>[] {
+  const onError = options.onError ?? defaultOnError;
+  const sendReasoning = options.sendReasoning ?? true;
+  const sendSources = options.sendSources ?? true;
+
+  switch (part.type) {
+    case "start":
+      return [{ type: "start", ...(options.messageId ? { messageId: options.messageId } : {}) }];
+
+    case "start-step":
+      return [{ type: "start-step" }];
+
+    case "finish-step":
+      return [{ type: "finish-step" }];
+
+    case "finish":
+      return [{
+        type: "finish",
+        ...(part.finishReason ? { finishReason: part.finishReason } : {}),
+      }];
+
+    case "abort":
+      return [{ type: "abort" }];
+
+    case "reasoning-start":
+      return [{ type: "reasoning-start", id: options.reasoningMessageId ?? part.id }];
+
+    case "reasoning-delta":
+      return sendReasoning
+        ? [{ type: "reasoning-delta", id: options.reasoningMessageId ?? part.id, delta: part.text }]
+        : [];
+
+    case "reasoning-end":
+      return [{ type: "reasoning-end", id: options.reasoningMessageId ?? part.id }];
+
+    case "text-start":
+      return [{ type: "text-start", id: options.messageId ?? part.id }];
+
+    case "text-delta":
+      return [{ type: "text-delta", id: options.messageId ?? part.id, delta: part.text }];
+
+    case "text-end":
+      return [{ type: "text-end", id: options.messageId ?? part.id }];
+
+    case "source":
+      return mapHostedStreamSourceToUiChunks(part, sendSources);
+
+    case "file":
+      return [{
+        type: "file",
+        mediaType: part.file.mediaType,
+        url: `data:${part.file.mediaType};base64,${part.file.base64}`,
+      }];
+
+    case "tool-input-start":
+      return [{ type: "tool-input-start", toolCallId: part.id, toolName: part.toolName }];
+
+    case "tool-input-delta":
+      return [{ type: "tool-input-delta", toolCallId: part.id, inputTextDelta: part.delta }];
+
+    case "tool-call":
+      return mapToolCallPartToUiChunks(part, onError);
+
+    case "tool-approval-request":
+      return [{
+        type: "tool-approval-request",
+        approvalId: part.approvalId,
+        toolCallId: part.toolCall.toolCallId,
+      }];
+
+    case "tool-result":
+      return [{ type: "tool-output-available", toolCallId: part.toolCallId, output: part.output }];
+
+    case "tool-error":
+      return mapToolErrorPartToUiChunks(part, onError);
+
+    case "tool-output-denied":
+      return [{ type: "tool-output-denied", toolCallId: part.toolCallId }];
+
+    case "error":
+      return [{ type: "error", errorText: onError(part.error) }];
+
+    case "tool-input-end":
+    case "raw":
+      return [];
+  }
+}

package/src/src/chat/index.ts

@@ -236,6 +236,11 @@ export {
   normalizeChatUiMessageChunk,
   normalizeChatUiMessageStream,
 } from "./chat-ui-message-helpers.js";
+export {
+  type HostedStreamPartForUiChunkMapping,
+  type HostedUiChunkMappingOptions,
+  mapHostedStreamPartToChatUiChunks,
+} from "./hosted-ui-chunk-mapping.js";
 
 export {
   useCompletion,