@tanstack/ai 0.59.0 → 0.61.0

package/dist/esm/types.d.ts

@@ -132,8 +132,21 @@ export interface ContentPartUrlSource extends AGUIUrlSource {
 /**
  * A provider-issued file handle (Files API). AG-UI `FileSource`: the handle
  * is opaque, do not fetch or parse it.
+ *
+ * The media is uploaded once via a `files` adapter (`openaiFiles()`,
+ * `anthropicFiles()`, `geminiFiles()`, `grokFiles()`, `falFiles()`) and
+ * referenced here by the returned handle instead of re-sending base64 or a
+ * public URL on each request. Only the provider that minted a handle can
+ * resolve it. Adapters that cannot consume file handles at all are rejected
+ * by the activity-layer preflight before mapping starts.
  */
-export interface ContentPartFileSource extends AGUIFileSource {
+export interface ContentPartFileSource<TProvider extends string = string> extends AGUIFileSource {
+    /**
+     * The adapter name of the provider that issued the handle (`'openai'`,
+     * `'gemini'`, ...), the same id TanStack reports as the usage provider.
+     * When present, an adapter rejects a handle another provider issued.
+     */
+    provider?: TProvider;
 }
 /**
  * Where a media part's bytes come from: inline data, a URL, or a provider
@@ -1905,7 +1918,7 @@ export interface VideoUrlResult {
     artifacts?: Array<PersistedArtifactRef>;
 }
 /**
- * Options for world generation (live, prompt-steerable sessions).
+ * Options for world generation (live session or finished job).
  *
  * @experimental World generation is an experimental feature and may change.
  */
@@ -1915,8 +1928,10 @@ export interface WorldGenerationOptions<TProviderOptions extends object = object
     /** Natural-language description of the world or scene */
     prompt: string;
     /**
-     * Provider mint options. Reactor resolution/seed/audio are browser
-     * `sendCommand` fields, not token-mint fields.
+     * Provider-specific options. Live adapters (Reactor) use mint fields here.
+     * Job adapters (World Labs) use image/video inputs, `wait`, and poll.
+     * Reactor resolution/seed/audio are browser `sendCommand` fields, not
+     * token-mint fields.
      */
     modelOptions?: TProviderOptions;
     /**
@@ -1932,28 +1947,72 @@ export interface WorldGenerationOptions<TProviderOptions extends object = object
      */
     abortSignal?: AbortSignal;
 }
+/**
+ * Assets from a finished world job. Live session adapters omit this.
+ * URLs are often signed CDN links. They can expire and may need a proxy
+ * to fetch from a browser.
+ *
+ * @experimental World generation is an experimental feature and may change.
+ */
+export interface WorldGenerationAssets {
+    /** Auto-generated scene description */
+    caption?: string;
+    /** Preview image URL */
+    thumbnailUrl?: string;
+    splats?: {
+        /** Quality-key map of splat URLs (`100k`, `500k`, `full_res`, …) */
+        spzUrls?: Record<string, string>;
+        metricScaleFactor?: number;
+        groundPlaneOffset?: number;
+    };
+    mesh?: {
+        colliderMeshUrl?: string;
+        hqMeshUrl?: string;
+        fullResMeshUrl?: string;
+    };
+    imagery?: {
+        panoUrl?: string;
+    };
+}
 /**
  * Result of world generation. JSON-serializable so a server route can return
- * it to a browser. The browser uses `token` + `model` to open the live
- * session (set the prompt, start streaming, steer mid-run).
+ * it to a browser.
+ *
+ * Live adapters (Reactor): `status: 'ready'` with `token` and token
+ * `expiresAt`. The browser uses `token` + `model` to open the session.
+ *
+ * Job adapters (World Labs): `status: 'ready'` with viewer `url` and
+ * `worldId`, or `status: 'waiting'` with `operationId` and no `url`.
+ * `expiresAt` on a job is operation expiry, not a session token.
  *
  * @experimental World generation is an experimental feature and may change.
  */
 export interface WorldGenerationResult {
     /** Unique identifier for this generation */
     id: string;
-    /** Model used for generation (provider connect slug) */
+    /** Model used for generation (provider connect slug or model id) */
     model: string;
-    /** Short-lived session token for the client connection */
-    token: string;
-    /** Token expiry as milliseconds since epoch */
-    expiresAt: number;
-    /** Prompt the client should send when it starts the session */
+    /** Short-lived session token for a live client connection */
+    token?: string;
+    /**
+     * Expiry as milliseconds since epoch. Live adapters: session token.
+     * Job adapters: operation expiry when the provider sends it.
+     */
+    expiresAt?: number;
+    /** Prompt used to generate the world, or the prompt the client should send */
     prompt: string;
-    /** Session status after the server half finishes */
+    /** Status after the server half finishes */
     status: 'ready' | 'waiting';
     /** Provider session id, when the adapter created one */
     sessionId?: string;
+    /** Viewer URL for a finished world job (not an asset download URL) */
+    url?: string;
+    /** Provider world id for a finished or in-progress job */
+    worldId?: string;
+    /** Provider operation id for a long-running world job */
+    operationId?: string;
+    /** Assets when a world job has finished and the provider returned them */
+    assets?: WorldGenerationAssets;
     /** Token usage / billing, when the adapter can report it */
     usage?: TokenUsage;
 }

package/dist/esm/utilities/ag-ui-wire.js

@@ -1,4 +1,5 @@
 import { tanstackMetadata } from "./merge-metadata.js";
+import { isProviderExecutedToolCall } from "./provider-executed.js";
 import { normalizeToolResult } from "./tool-result.js";
 import { wireSubagentInfo, wireSubagentRunId } from "./subagent-wire.js";
 import { coerceCreatedAt, modelMessageToUIMessage } from "../activities/chat/messages.js";
@@ -66,21 +67,41 @@ function uiMessagesToWire(messages, options) {
 			wire.push(toAnchor(uiMessage, "user", { content: parts.length > 0 ? collectUserContent(parts) : msg.content ?? "" }, parts, includeSnapshotStructuredOutput));
 			continue;
 		}
+		let current = {
+			thinking: [],
+			parts: []
+		};
+		const segments = [current];
 		for (const part of parts) if (part.type === "thinking") {
-			const reasoning = {
-				role: "reasoning",
-				id: uniqueWireId(deriveReasoningId(uiMessage.id, part), usedWireIds),
-				content: part.content
+			if (current.parts.some((p) => p.type === "tool-call" && isProviderExecutedToolCall(p))) {
+				current = {
+					thinking: [part],
+					parts: []
+				};
+				segments.push(current);
+			} else current.thinking.push(part);
+		} else current.parts.push(part);
+		segments.forEach((segment, index) => {
+			for (const part of segment.thinking) {
+				const reasoning = {
+					role: "reasoning",
+					id: uniqueWireId(deriveReasoningId(uiMessage.id, part), usedWireIds),
+					content: part.content
+				};
+				if (part.signature) reasoning.encryptedValue = part.signature;
+				wire.push(reasoning);
+			}
+			const text = collectText(segment.parts);
+			const toolCalls = collectToolCalls(segment.parts);
+			const anchorMessage = index === 0 ? uiMessage : {
+				...uiMessage,
+				id: uniqueWireId(`${uiMessage.id}-segment-${index}`, usedWireIds)
 			};
-			if (part.signature) reasoning.encryptedValue = part.signature;
-			wire.push(reasoning);
-		}
-		const text = collectText(parts);
-		const toolCalls = collectToolCalls(parts);
-		wire.push(toAnchor(uiMessage, "assistant", {
-			...text !== "" && { content: text },
-			...toolCalls && { toolCalls }
-		}, parts, includeSnapshotStructuredOutput));
+			wire.push(toAnchor(anchorMessage, "assistant", {
+				...text !== "" && { content: text },
+				...toolCalls && { toolCalls }
+			}, segment.parts, includeSnapshotStructuredOutput));
+		});
 		const explicitToolResults = new Set(parts.flatMap((part) => part.type === "tool-result" ? [part.toolCallId] : []));
 		for (const part of parts) if (part.type === "tool-result") {
 			const id = uniqueToolWireId(part.id ?? deriveToolMessageId(part.toolCallId), usedWireIds);

package/dist/esm/utilities/ag-ui-wire.js.map

@@ -1 +1 @@
-{"version":3,"file":"ag-ui-wire.js","names":[],"sources":["../../../src/utilities/ag-ui-wire.ts"],"sourcesContent":["import type {\n  AssistantMessage,\n  InputContent,\n  ReasoningMessage,\n  SystemMessage,\n  ToolCall,\n  ToolMessage,\n  UserMessage,\n} from '@ag-ui/core'\nimport type {\n  ContentPart,\n  MessagePart,\n  ModelMessage,\n  StructuredOutputPart,\n  SubagentPart,\n  TanStackMessageMetadata,\n  UIMessage,\n  UIResourcePart,\n} from '../types'\nimport type { MetadataRecord } from './merge-metadata'\nimport { tanstackMetadata } from './merge-metadata'\nimport { normalizeToolResult } from './tool-result'\nimport { wireSubagentInfo, wireSubagentRunId } from './subagent-wire'\nimport type { SubagentWireInfo } from './subagent-wire'\nimport {\n  coerceCreatedAt,\n  modelMessageToUIMessage,\n} from '../activities/chat/messages'\n\ntype WithMetadata<T> = T & { metadata?: MetadataRecord }\ntype WireSystemMessage = WithMetadata<SystemMessage>\ntype WireUserMessage = WithMetadata<UserMessage>\ntype WireAssistantMessage = WithMetadata<AssistantMessage>\ntype WireToolMessage = WithMetadata<\n  ToolMessage & {\n    name?: string\n  }\n>\ntype WireReasoningMessage = WithMetadata<ReasoningMessage>\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value)\n}\n\nfunction rebuiltToolMetadata(\n  metadata: unknown,\n  createdAt: unknown,\n  id: string | undefined,\n  content: string | null | Array<ContentPart>,\n  anchorOwnsUiResources = false,\n): MetadataRecord | undefined {\n  const source: MetadataRecord = isRecord(metadata) ? metadata : {}\n  const tanstack = isRecord(source.tanstack) ? { ...source.tanstack } : {}\n  if (anchorOwnsUiResources) delete tanstack.uiResources\n  const date = coerceCreatedAt(createdAt)\n  const toolResult: NonNullable<TanStackMessageMetadata['toolResult']> = {\n    ...(id !== undefined ? { id } : {}),\n    ...(date && { createdAt: date.toISOString() }),\n    ...(Array.isArray(content) && { content }),\n  }\n  const result = {\n    ...source,\n    tanstack: { ...tanstack, toolResult },\n  }\n  return Object.keys(result).length ? result : undefined\n}\n\nexport type WireMessage =\n  | WireSystemMessage\n  | WireUserMessage\n  | WireAssistantMessage\n  | WireToolMessage\n  | WireReasoningMessage\n\n/**\n * Serialize TanStack `UIMessage`s and `ModelMessage`s into the AG-UI\n * `RunAgentInput.messages` wire shape. Anchors are spec-only (`id`, `role`,\n * `name`, `content`, `toolCalls`, `metadata`). Tool results and thinking parts\n * on assistant messages are additionally emitted as fan-out\n * `{role:'tool',...}` and `{role:'reasoning',...}` entries for strict AG-UI\n * server consumers. Set `includeSnapshotStructuredOutput` to retain complete\n * structured-output metadata for UI snapshots.\n */\nexport function uiMessagesToWire(\n  messages: Array<UIMessage | ModelMessage>,\n  options?: { includeSnapshotStructuredOutput: boolean },\n): Array<WireMessage> {\n  const wire: Array<WireMessage> = []\n  const usedWireIds = new Set<string>(\n    messages.flatMap((message) =>\n      'id' in message && message.id && message.role !== 'tool'\n        ? [message.id]\n        : [],\n    ),\n  )\n  const includeSnapshotStructuredOutput =\n    options?.includeSnapshotStructuredOutput ?? false\n\n  const assistantIds = new Set<string>()\n  for (const msg of messages) {\n    if (msg.role === 'assistant' && msg.id !== undefined) {\n      assistantIds.add(msg.id)\n    }\n  }\n\n  for (const msg of messages) {\n    if (!('parts' in msg) && msg.role === 'tool' && msg.toolCallId) {\n      const id = uniqueToolWireId(\n        toolWireId(msg.id, msg.toolCallId, assistantIds),\n        usedWireIds,\n      )\n      const metadata = rebuiltToolMetadata(\n        msg.metadata,\n        msg.createdAt,\n        msg.id,\n        msg.content,\n      )\n      wire.push({\n        role: 'tool',\n        id,\n        ...(msg.name !== undefined && { name: msg.name }),\n        toolCallId: msg.toolCallId,\n        content:\n          typeof msg.content === 'string'\n            ? msg.content\n            : JSON.stringify(msg.content),\n        ...(msg.error !== undefined && { error: msg.error }),\n        ...(metadata !== undefined && { metadata }),\n      })\n      continue\n    }\n\n    const uiMessage: UIMessage =\n      'parts' in msg ? msg : modelMessageToUIMessage(msg, msg.id)\n    const parts: ReadonlyArray<MessagePart> = uiMessage.parts\n    usedWireIds.add(uiMessage.id)\n\n    if (msg.role === 'system') {\n      wire.push(\n        toAnchor(\n          uiMessage,\n          'system',\n          {\n            content:\n              parts.length > 0\n                ? collectText(parts)\n                : ((msg as { content?: string }).content ?? ''),\n          },\n          parts,\n          includeSnapshotStructuredOutput,\n        ),\n      )\n      continue\n    }\n\n    if (msg.role === 'user') {\n      wire.push(\n        toAnchor(\n          uiMessage,\n          'user',\n          {\n            content:\n              parts.length > 0\n                ? collectUserContent(parts)\n                : ((msg as { content?: string }).content ?? ''),\n          },\n          parts,\n          includeSnapshotStructuredOutput,\n        ),\n      )\n      continue\n    }\n\n    // assistant: emit reasoning fan-outs first, then anchor, then tool fan-outs\n    for (const part of parts) {\n      if (part.type === 'thinking') {\n        const reasoning: WireReasoningMessage = {\n          role: 'reasoning',\n          id: uniqueWireId(deriveReasoningId(uiMessage.id, part), usedWireIds),\n          content: part.content,\n        }\n        if (part.signature) {\n          reasoning.encryptedValue = part.signature\n        }\n        wire.push(reasoning)\n      }\n    }\n\n    const text = collectText(parts)\n    const toolCalls = collectToolCalls(parts)\n    wire.push(\n      toAnchor(\n        uiMessage,\n        'assistant',\n        {\n          ...(text !== '' && { content: text }),\n          ...(toolCalls && { toolCalls }),\n        },\n        parts,\n        includeSnapshotStructuredOutput,\n      ),\n    )\n\n    const explicitToolResults = new Set(\n      parts.flatMap((part) =>\n        part.type === 'tool-result' ? [part.toolCallId] : [],\n      ),\n    )\n    for (const part of parts) {\n      if (part.type === 'tool-result') {\n        const id = uniqueToolWireId(\n          part.id ?? deriveToolMessageId(part.toolCallId),\n          usedWireIds,\n        )\n        const metadata = rebuiltToolMetadata(\n          part.metadata,\n          part.createdAt,\n          part.id,\n          part.content,\n          true,\n        )\n        wire.push({\n          role: 'tool',\n          id,\n          toolCallId: part.toolCallId,\n          ...(part.name !== undefined && { name: part.name }),\n          content:\n            typeof part.content === 'string'\n              ? part.content\n              : JSON.stringify(part.content),\n          ...(part.error !== undefined && { error: part.error }),\n          ...(metadata !== undefined && { metadata }),\n        })\n      } else if (part.type === 'tool-call') {\n        const approved = part.approval?.approved\n        if (\n          explicitToolResults.has(part.id) ||\n          (part.output === undefined &&\n            (part.state !== 'approval-responded' || approved === undefined))\n        ) {\n          continue\n        }\n        const result =\n          part.output !== undefined\n            ? normalizeToolResult(part.output)\n            : JSON.stringify({\n                approved,\n                ...(approved && { pendingExecution: true }),\n                message: approved\n                  ? 'User approved this action'\n                  : 'User denied this action',\n              })\n        const content =\n          typeof result === 'string' ? result : JSON.stringify(result)\n        wire.push({\n          role: 'tool',\n          id: uniqueToolWireId(deriveToolMessageId(part.id), usedWireIds),\n          toolCallId: part.id,\n          content,\n          metadata: rebuiltToolMetadata(\n            undefined,\n            undefined,\n            undefined,\n            result,\n          ),\n        })\n      }\n    }\n\n    for (const part of parts) {\n      if (part.type === 'subagent') wire.push(...subagentToWire(part, options))\n    }\n  }\n\n  return wire\n}\n\nfunction toAnchor(\n  msg: UIMessage,\n  role: 'system',\n  extras: { content: string },\n  parts: ReadonlyArray<MessagePart>,\n  includeSnapshotStructuredOutput: boolean,\n): WireSystemMessage\nfunction toAnchor(\n  msg: UIMessage,\n  role: 'user',\n  extras: { content: string | Array<InputContent> },\n  parts: ReadonlyArray<MessagePart>,\n  includeSnapshotStructuredOutput: boolean,\n): WireUserMessage\nfunction toAnchor(\n  msg: UIMessage,\n  role: 'assistant',\n  extras: {\n    content?: string\n    toolCalls?: Array<ToolCall>\n  },\n  parts: ReadonlyArray<MessagePart>,\n  includeSnapshotStructuredOutput: boolean,\n): WireAssistantMessage\nfunction toAnchor(\n  msg: UIMessage,\n  role: UIMessage['role'],\n  extras: {\n    content?: string | Array<InputContent>\n    toolCalls?: Array<ToolCall>\n  },\n  parts: ReadonlyArray<MessagePart>,\n  includeSnapshotStructuredOutput: boolean,\n): WireSystemMessage | WireUserMessage | WireAssistantMessage {\n  const metadata = messageMetadata(msg, parts, includeSnapshotStructuredOutput)\n  const base = {\n    id: msg.id,\n    ...(msg.name !== undefined && { name: msg.name }),\n    ...(metadata !== undefined && { metadata }),\n  }\n  if (role === 'system') {\n    return { ...base, role, content: String(extras.content ?? '') }\n  }\n  if (role === 'user') {\n    return { ...base, role, content: extras.content ?? '' }\n  }\n  return {\n    ...base,\n    role,\n    ...(typeof extras.content === 'string' && { content: extras.content }),\n    ...(extras.toolCalls !== undefined && { toolCalls: extras.toolCalls }),\n  }\n}\n\nfunction messageMetadata(\n  msg: UIMessage,\n  parts: ReadonlyArray<MessagePart>,\n  includeSnapshotStructuredOutput: boolean,\n): MetadataRecord | undefined {\n  const base: MetadataRecord = { ...(msg.metadata ?? {}) }\n  const previousTanstack = tanstackMetadata(msg)\n  const tanstack: TanStackMessageMetadata = {}\n  if (previousTanstack?.model !== undefined)\n    tanstack.model = previousTanstack.model\n  if (previousTanstack?.runId !== undefined)\n    tanstack.runId = previousTanstack.runId\n  if (previousTanstack?.signature !== undefined)\n    tanstack.signature = previousTanstack.signature\n  const createdAt = coerceCreatedAt(msg.createdAt)\n  if (createdAt !== undefined) tanstack.createdAt = createdAt.toISOString()\n\n  const structuredOutput = serializedStructuredOutput(\n    parts,\n    includeSnapshotStructuredOutput,\n  )\n  if (structuredOutput) tanstack.structuredOutput = structuredOutput\n\n  const toolCallMetadata: Record<string, unknown> = {}\n  for (const part of parts) {\n    if (part.type === 'tool-call' && part.metadata !== undefined) {\n      toolCallMetadata[part.id] = part.metadata\n    }\n  }\n  if (Object.keys(toolCallMetadata).length > 0) {\n    tanstack.toolCallMetadata = toolCallMetadata\n  }\n\n  const uiResources = parts.filter(\n    (p): p is UIResourcePart => p.type === 'ui-resource',\n  )\n  if (uiResources.length > 0) tanstack.uiResources = uiResources\n\n  if (Object.keys(tanstack).length > 0) base.tanstack = tanstack\n  else delete base.tanstack\n  return Object.keys(base).length > 0 ? base : undefined\n}\n\nfunction serializedStructuredOutput(\n  parts: ReadonlyArray<MessagePart>,\n  includeSnapshotStructuredOutput: boolean,\n): TanStackMessageMetadata['structuredOutput'] | undefined {\n  for (const p of parts) {\n    if (\n      p.type === 'structured-output' &&\n      (includeSnapshotStructuredOutput || p.status !== 'complete')\n    ) {\n      return structuredOutputMetadata(p, includeSnapshotStructuredOutput)\n    }\n  }\n  return undefined\n}\n\nfunction structuredOutputMetadata(\n  part: StructuredOutputPart,\n  includeSnapshotStructuredOutput: boolean,\n): NonNullable<TanStackMessageMetadata['structuredOutput']> {\n  return {\n    status: part.status,\n    raw: part.raw,\n    ...(includeSnapshotStructuredOutput && part.partial !== undefined\n      ? { partial: part.partial }\n      : {}),\n    ...(includeSnapshotStructuredOutput && part.data !== undefined\n      ? { data: part.data }\n      : {}),\n    ...(includeSnapshotStructuredOutput && part.reasoning\n      ? { reasoning: part.reasoning }\n      : {}),\n    ...(part.errorMessage !== undefined && { errorMessage: part.errorMessage }),\n  }\n}\n\nfunction collectText(parts: ReadonlyArray<MessagePart>): string {\n  // The streamed JSON of a completed structured-output part is the source of\n  // truth for multi-turn coherence — emitting it back as assistant content\n  // lets the LLM see its own prior structured response. Streaming/errored\n  // parts are skipped: they'd ship malformed JSON fragments and confuse the\n  // model. `completeStructuredOutputPart` tries hard to populate `raw`\n  // (caller → existing buffer → `JSON.stringify(data)`), but the stringify\n  // fallback can leave it empty when `data` is unserializable (BigInt,\n  // circular). The `p.raw !== ''` guard below is what enforces \"no malformed\n  // round-trip\" in that case — without it we'd ship `''` and the model would\n  // see an empty assistant turn.\n  const out: Array<string> = []\n  for (const p of parts) {\n    if (p.type === 'text') {\n      out.push(p.content)\n    } else if (\n      p.type === 'structured-output' &&\n      p.status === 'complete' &&\n      p.raw !== ''\n    ) {\n      out.push(p.raw)\n    }\n  }\n  return out.join('')\n}\n\n/**\n * A child's messages, tagged with its AG-UI `subagentRunId`. The card data\n * rides in `metadata.tanstack.subagent`, so the other side can rebuild the\n * card and continue a suspended child.\n */\nfunction subagentToWire(\n  part: SubagentPart,\n  options?: { includeSnapshotStructuredOutput: boolean },\n): Array<WireMessage> {\n  const { subagent } = part\n  const info: SubagentWireInfo = {\n    name: subagent.name,\n    status: subagent.status,\n    ...(subagent.description !== undefined && {\n      description: subagent.description,\n    }),\n    ...(subagent.error !== undefined && { error: subagent.error }),\n    ...(subagent.interruptIds !== undefined && {\n      interruptIds: subagent.interruptIds,\n    }),\n    ...(subagent.parentSubagentRunId !== undefined && {\n      parentSubagentRunId: subagent.parentSubagentRunId,\n    }),\n    ...(subagent.parentToolCallId !== undefined && {\n      parentToolCallId: subagent.parentToolCallId,\n    }),\n    ...(subagent.metadata !== undefined && { metadata: subagent.metadata }),\n  }\n  const child = uiMessagesToWire(subagent.messages, options)\n  const own = child.some((message) => wireSubagentRunId(message) === undefined)\n  const messages: Array<WireMessage> = own\n    ? child\n    : [{ id: `subagent:${subagent.id}`, role: 'assistant' }, ...child]\n  return messages.map((message, index) => {\n    const nestedId = wireSubagentRunId(message)\n    if (nestedId !== undefined) {\n      const nested = wireSubagentInfo(message)\n      if (!nested || nested.parentSubagentRunId !== undefined) return message\n      return withSubagentInfo(message, nestedId, {\n        ...nested,\n        parentSubagentRunId: subagent.id,\n      })\n    }\n    return withSubagentInfo(\n      message,\n      subagent.id,\n      !own && index === 0 ? { ...info, placeholder: true } : info,\n    )\n  })\n}\n\nfunction withSubagentInfo(\n  message: WireMessage,\n  subagentRunId: string,\n  info: SubagentWireInfo,\n): WireMessage {\n  const metadata = isRecord(message.metadata) ? message.metadata : {}\n  const tanstack = isRecord(metadata.tanstack) ? metadata.tanstack : {}\n  return {\n    ...message,\n    subagentRunId,\n    metadata: { ...metadata, tanstack: { ...tanstack, subagent: info } },\n  }\n}\n\nfunction collectUserContent(\n  parts: ReadonlyArray<MessagePart>,\n): string | Array<InputContent> {\n  const hasMultimodal = parts.some(\n    (p) =>\n      p.type === 'image' ||\n      p.type === 'audio' ||\n      p.type === 'video' ||\n      p.type === 'document',\n  )\n  if (!hasMultimodal) {\n    return collectText(parts)\n  }\n  const out: Array<InputContent> = []\n  for (const p of parts) {\n    if (p.type === 'text') {\n      out.push({ type: 'text', text: p.content })\n    } else if (\n      p.type === 'image' ||\n      p.type === 'audio' ||\n      p.type === 'video' ||\n      p.type === 'document'\n    ) {\n      out.push(p)\n    }\n  }\n  return out\n}\n\nfunction thoughtSignatureFromMetadata(metadata: unknown): string | undefined {\n  if (\n    metadata == null ||\n    typeof metadata !== 'object' ||\n    Array.isArray(metadata)\n  ) {\n    return undefined\n  }\n  if (!('thoughtSignature' in metadata)) return undefined\n  const value = metadata.thoughtSignature\n  return typeof value === 'string' && value !== '' ? value : undefined\n}\n\nfunction collectToolCalls(\n  parts: ReadonlyArray<MessagePart>,\n): Array<ToolCall> | undefined {\n  const calls: Array<ToolCall> = []\n  for (const p of parts) {\n    if (p.type === 'tool-call') {\n      const encryptedValue = thoughtSignatureFromMetadata(p.metadata)\n      calls.push({\n        id: p.id,\n        type: 'function',\n        function: { name: p.name, arguments: p.arguments },\n        ...(encryptedValue !== undefined ? { encryptedValue } : {}),\n      })\n    }\n  }\n  return calls.length > 0 ? calls : undefined\n}\n\nfunction deriveReasoningId(messageId: string, part: MessagePart): string {\n  return `${messageId}-reasoning-${(part as { id?: string }).id ?? hashContent((part as { content: string }).content)}`\n}\n\nfunction deriveToolMessageId(toolCallId: string): string {\n  return `tool-${toolCallId}`\n}\n\nfunction uniqueToolWireId(id: string, used: Set<string>): string {\n  return uniqueWireId(id, used)\n}\n\nfunction uniqueWireId(id: string, used: Set<string>): string {\n  if (!used.has(id)) {\n    used.add(id)\n    return id\n  }\n  let suffix = 2\n  while (used.has(`${id}-${suffix}`)) suffix++\n  const unique = `${id}-${suffix}`\n  used.add(unique)\n  return unique\n}\n\nfunction toolWireId(\n  id: string | undefined,\n  toolCallId: string,\n  assistantIds: ReadonlySet<string>,\n): string {\n  const derived = deriveToolMessageId(toolCallId)\n  if (id === undefined || assistantIds.has(id)) return derived\n  return id\n}\n\nfunction hashContent(s: string): string {\n  // Cheap deterministic id suffix; collisions are tolerable since\n  // reasoning ids only matter for AG-UI server consumers, not for our\n  // own server's dedup logic (which keys on toolCallId, not reasoning id).\n  let h = 0\n  for (let i = 0; i < s.length; i++) h = (h * 31 + s.charCodeAt(i)) | 0\n  return Math.abs(h).toString(36)\n}\n"],"mappings":"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"}
+{"version":3,"file":"ag-ui-wire.js","names":[],"sources":["../../../src/utilities/ag-ui-wire.ts"],"sourcesContent":["import type {\n  AssistantMessage,\n  InputContent,\n  ReasoningMessage,\n  SystemMessage,\n  ToolCall,\n  ToolMessage,\n  UserMessage,\n} from '@ag-ui/core'\nimport type {\n  ContentPart,\n  MessagePart,\n  ModelMessage,\n  StructuredOutputPart,\n  SubagentPart,\n  TanStackMessageMetadata,\n  UIMessage,\n  UIResourcePart,\n} from '../types'\nimport type { MetadataRecord } from './merge-metadata'\nimport { tanstackMetadata } from './merge-metadata'\nimport { isProviderExecutedToolCall } from './provider-executed'\nimport { normalizeToolResult } from './tool-result'\nimport { wireSubagentInfo, wireSubagentRunId } from './subagent-wire'\nimport type { SubagentWireInfo } from './subagent-wire'\nimport {\n  coerceCreatedAt,\n  modelMessageToUIMessage,\n} from '../activities/chat/messages'\n\ntype WithMetadata<T> = T & { metadata?: MetadataRecord }\ntype WireSystemMessage = WithMetadata<SystemMessage>\ntype WireUserMessage = WithMetadata<UserMessage>\ntype WireAssistantMessage = WithMetadata<AssistantMessage>\ntype WireToolMessage = WithMetadata<\n  ToolMessage & {\n    name?: string\n  }\n>\ntype WireReasoningMessage = WithMetadata<ReasoningMessage>\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value)\n}\n\nfunction rebuiltToolMetadata(\n  metadata: unknown,\n  createdAt: unknown,\n  id: string | undefined,\n  content: string | null | Array<ContentPart>,\n  anchorOwnsUiResources = false,\n): MetadataRecord | undefined {\n  const source: MetadataRecord = isRecord(metadata) ? metadata : {}\n  const tanstack = isRecord(source.tanstack) ? { ...source.tanstack } : {}\n  if (anchorOwnsUiResources) delete tanstack.uiResources\n  const date = coerceCreatedAt(createdAt)\n  const toolResult: NonNullable<TanStackMessageMetadata['toolResult']> = {\n    ...(id !== undefined ? { id } : {}),\n    ...(date && { createdAt: date.toISOString() }),\n    ...(Array.isArray(content) && { content }),\n  }\n  const result = {\n    ...source,\n    tanstack: { ...tanstack, toolResult },\n  }\n  return Object.keys(result).length ? result : undefined\n}\n\nexport type WireMessage =\n  | WireSystemMessage\n  | WireUserMessage\n  | WireAssistantMessage\n  | WireToolMessage\n  | WireReasoningMessage\n\n/**\n * Serialize TanStack `UIMessage`s and `ModelMessage`s into the AG-UI\n * `RunAgentInput.messages` wire shape. Anchors are spec-only (`id`, `role`,\n * `name`, `content`, `toolCalls`, `metadata`). Tool results and thinking parts\n * on assistant messages are additionally emitted as fan-out\n * `{role:'tool',...}` and `{role:'reasoning',...}` entries for strict AG-UI\n * server consumers. Set `includeSnapshotStructuredOutput` to retain complete\n * structured-output metadata for UI snapshots.\n */\nexport function uiMessagesToWire(\n  messages: Array<UIMessage | ModelMessage>,\n  options?: { includeSnapshotStructuredOutput: boolean },\n): Array<WireMessage> {\n  const wire: Array<WireMessage> = []\n  const usedWireIds = new Set<string>(\n    messages.flatMap((message) =>\n      'id' in message && message.id && message.role !== 'tool'\n        ? [message.id]\n        : [],\n    ),\n  )\n  const includeSnapshotStructuredOutput =\n    options?.includeSnapshotStructuredOutput ?? false\n\n  const assistantIds = new Set<string>()\n  for (const msg of messages) {\n    if (msg.role === 'assistant' && msg.id !== undefined) {\n      assistantIds.add(msg.id)\n    }\n  }\n\n  for (const msg of messages) {\n    if (!('parts' in msg) && msg.role === 'tool' && msg.toolCallId) {\n      const id = uniqueToolWireId(\n        toolWireId(msg.id, msg.toolCallId, assistantIds),\n        usedWireIds,\n      )\n      const metadata = rebuiltToolMetadata(\n        msg.metadata,\n        msg.createdAt,\n        msg.id,\n        msg.content,\n      )\n      wire.push({\n        role: 'tool',\n        id,\n        ...(msg.name !== undefined && { name: msg.name }),\n        toolCallId: msg.toolCallId,\n        content:\n          typeof msg.content === 'string'\n            ? msg.content\n            : JSON.stringify(msg.content),\n        ...(msg.error !== undefined && { error: msg.error }),\n        ...(metadata !== undefined && { metadata }),\n      })\n      continue\n    }\n\n    const uiMessage: UIMessage =\n      'parts' in msg ? msg : modelMessageToUIMessage(msg, msg.id)\n    const parts: ReadonlyArray<MessagePart> = uiMessage.parts\n    usedWireIds.add(uiMessage.id)\n\n    if (msg.role === 'system') {\n      wire.push(\n        toAnchor(\n          uiMessage,\n          'system',\n          {\n            content:\n              parts.length > 0\n                ? collectText(parts)\n                : ((msg as { content?: string }).content ?? ''),\n          },\n          parts,\n          includeSnapshotStructuredOutput,\n        ),\n      )\n      continue\n    }\n\n    if (msg.role === 'user') {\n      wire.push(\n        toAnchor(\n          uiMessage,\n          'user',\n          {\n            content:\n              parts.length > 0\n                ? collectUserContent(parts)\n                : ((msg as { content?: string }).content ?? ''),\n          },\n          parts,\n          includeSnapshotStructuredOutput,\n        ),\n      )\n      continue\n    }\n\n    // assistant: reasoning fan-outs, then anchor, then tool fan-outs.\n    //\n    // Provider-executed tools (Anthropic web_search / web_fetch) run inside one\n    // provider response, and the provider signs every thinking block against\n    // the blocks before it. Emitting all reasoning first and a single anchor\n    // with the joined text and every tool call turns\n    // \"thinking, tool, thinking, text, tool\" into\n    // \"thinking, thinking, text, tool, tool\", and the provider rejects the next\n    // turn (\"thinking blocks in the latest assistant message cannot be\n    // modified\"). Split the message into ordered segments at each thinking\n    // part that follows a provider-executed tool call, the same rule\n    // buildAssistantMessages applies, so the wire keeps the signed order.\n    // Segments after the first get derived anchor ids; strict AG-UI consumers\n    // still see plain anchors.\n    type Segment = {\n      thinking: Array<Extract<MessagePart, { type: 'thinking' }>>\n      parts: Array<MessagePart>\n    }\n    let current: Segment = { thinking: [], parts: [] }\n    const segments: Array<Segment> = [current]\n    for (const part of parts) {\n      if (part.type === 'thinking') {\n        if (\n          current.parts.some(\n            (p) => p.type === 'tool-call' && isProviderExecutedToolCall(p),\n          )\n        ) {\n          current = { thinking: [part], parts: [] }\n          segments.push(current)\n        } else {\n          current.thinking.push(part)\n        }\n      } else {\n        current.parts.push(part)\n      }\n    }\n\n    segments.forEach((segment, index) => {\n      for (const part of segment.thinking) {\n        const reasoning: WireReasoningMessage = {\n          role: 'reasoning',\n          id: uniqueWireId(deriveReasoningId(uiMessage.id, part), usedWireIds),\n          content: part.content,\n        }\n        if (part.signature) {\n          reasoning.encryptedValue = part.signature\n        }\n        wire.push(reasoning)\n      }\n\n      const text = collectText(segment.parts)\n      const toolCalls = collectToolCalls(segment.parts)\n      const anchorMessage: UIMessage =\n        index === 0\n          ? uiMessage\n          : {\n              ...uiMessage,\n              id: uniqueWireId(`${uiMessage.id}-segment-${index}`, usedWireIds),\n            }\n      wire.push(\n        toAnchor(\n          anchorMessage,\n          'assistant',\n          {\n            ...(text !== '' && { content: text }),\n            ...(toolCalls && { toolCalls }),\n          },\n          segment.parts,\n          includeSnapshotStructuredOutput,\n        ),\n      )\n    })\n\n    const explicitToolResults = new Set(\n      parts.flatMap((part) =>\n        part.type === 'tool-result' ? [part.toolCallId] : [],\n      ),\n    )\n    for (const part of parts) {\n      if (part.type === 'tool-result') {\n        const id = uniqueToolWireId(\n          part.id ?? deriveToolMessageId(part.toolCallId),\n          usedWireIds,\n        )\n        const metadata = rebuiltToolMetadata(\n          part.metadata,\n          part.createdAt,\n          part.id,\n          part.content,\n          true,\n        )\n        wire.push({\n          role: 'tool',\n          id,\n          toolCallId: part.toolCallId,\n          ...(part.name !== undefined && { name: part.name }),\n          content:\n            typeof part.content === 'string'\n              ? part.content\n              : JSON.stringify(part.content),\n          ...(part.error !== undefined && { error: part.error }),\n          ...(metadata !== undefined && { metadata }),\n        })\n      } else if (part.type === 'tool-call') {\n        const approved = part.approval?.approved\n        if (\n          explicitToolResults.has(part.id) ||\n          (part.output === undefined &&\n            (part.state !== 'approval-responded' || approved === undefined))\n        ) {\n          continue\n        }\n        const result =\n          part.output !== undefined\n            ? normalizeToolResult(part.output)\n            : JSON.stringify({\n                approved,\n                ...(approved && { pendingExecution: true }),\n                message: approved\n                  ? 'User approved this action'\n                  : 'User denied this action',\n              })\n        const content =\n          typeof result === 'string' ? result : JSON.stringify(result)\n        wire.push({\n          role: 'tool',\n          id: uniqueToolWireId(deriveToolMessageId(part.id), usedWireIds),\n          toolCallId: part.id,\n          content,\n          metadata: rebuiltToolMetadata(\n            undefined,\n            undefined,\n            undefined,\n            result,\n          ),\n        })\n      }\n    }\n\n    for (const part of parts) {\n      if (part.type === 'subagent') wire.push(...subagentToWire(part, options))\n    }\n  }\n\n  return wire\n}\n\nfunction toAnchor(\n  msg: UIMessage,\n  role: 'system',\n  extras: { content: string },\n  parts: ReadonlyArray<MessagePart>,\n  includeSnapshotStructuredOutput: boolean,\n): WireSystemMessage\nfunction toAnchor(\n  msg: UIMessage,\n  role: 'user',\n  extras: { content: string | Array<InputContent> },\n  parts: ReadonlyArray<MessagePart>,\n  includeSnapshotStructuredOutput: boolean,\n): WireUserMessage\nfunction toAnchor(\n  msg: UIMessage,\n  role: 'assistant',\n  extras: {\n    content?: string\n    toolCalls?: Array<ToolCall>\n  },\n  parts: ReadonlyArray<MessagePart>,\n  includeSnapshotStructuredOutput: boolean,\n): WireAssistantMessage\nfunction toAnchor(\n  msg: UIMessage,\n  role: UIMessage['role'],\n  extras: {\n    content?: string | Array<InputContent>\n    toolCalls?: Array<ToolCall>\n  },\n  parts: ReadonlyArray<MessagePart>,\n  includeSnapshotStructuredOutput: boolean,\n): WireSystemMessage | WireUserMessage | WireAssistantMessage {\n  const metadata = messageMetadata(msg, parts, includeSnapshotStructuredOutput)\n  const base = {\n    id: msg.id,\n    ...(msg.name !== undefined && { name: msg.name }),\n    ...(metadata !== undefined && { metadata }),\n  }\n  if (role === 'system') {\n    return { ...base, role, content: String(extras.content ?? '') }\n  }\n  if (role === 'user') {\n    return { ...base, role, content: extras.content ?? '' }\n  }\n  return {\n    ...base,\n    role,\n    ...(typeof extras.content === 'string' && { content: extras.content }),\n    ...(extras.toolCalls !== undefined && { toolCalls: extras.toolCalls }),\n  }\n}\n\nfunction messageMetadata(\n  msg: UIMessage,\n  parts: ReadonlyArray<MessagePart>,\n  includeSnapshotStructuredOutput: boolean,\n): MetadataRecord | undefined {\n  const base: MetadataRecord = { ...(msg.metadata ?? {}) }\n  const previousTanstack = tanstackMetadata(msg)\n  const tanstack: TanStackMessageMetadata = {}\n  if (previousTanstack?.model !== undefined)\n    tanstack.model = previousTanstack.model\n  if (previousTanstack?.runId !== undefined)\n    tanstack.runId = previousTanstack.runId\n  if (previousTanstack?.signature !== undefined)\n    tanstack.signature = previousTanstack.signature\n  const createdAt = coerceCreatedAt(msg.createdAt)\n  if (createdAt !== undefined) tanstack.createdAt = createdAt.toISOString()\n\n  const structuredOutput = serializedStructuredOutput(\n    parts,\n    includeSnapshotStructuredOutput,\n  )\n  if (structuredOutput) tanstack.structuredOutput = structuredOutput\n\n  const toolCallMetadata: Record<string, unknown> = {}\n  for (const part of parts) {\n    if (part.type === 'tool-call' && part.metadata !== undefined) {\n      toolCallMetadata[part.id] = part.metadata\n    }\n  }\n  if (Object.keys(toolCallMetadata).length > 0) {\n    tanstack.toolCallMetadata = toolCallMetadata\n  }\n\n  const uiResources = parts.filter(\n    (p): p is UIResourcePart => p.type === 'ui-resource',\n  )\n  if (uiResources.length > 0) tanstack.uiResources = uiResources\n\n  if (Object.keys(tanstack).length > 0) base.tanstack = tanstack\n  else delete base.tanstack\n  return Object.keys(base).length > 0 ? base : undefined\n}\n\nfunction serializedStructuredOutput(\n  parts: ReadonlyArray<MessagePart>,\n  includeSnapshotStructuredOutput: boolean,\n): TanStackMessageMetadata['structuredOutput'] | undefined {\n  for (const p of parts) {\n    if (\n      p.type === 'structured-output' &&\n      (includeSnapshotStructuredOutput || p.status !== 'complete')\n    ) {\n      return structuredOutputMetadata(p, includeSnapshotStructuredOutput)\n    }\n  }\n  return undefined\n}\n\nfunction structuredOutputMetadata(\n  part: StructuredOutputPart,\n  includeSnapshotStructuredOutput: boolean,\n): NonNullable<TanStackMessageMetadata['structuredOutput']> {\n  return {\n    status: part.status,\n    raw: part.raw,\n    ...(includeSnapshotStructuredOutput && part.partial !== undefined\n      ? { partial: part.partial }\n      : {}),\n    ...(includeSnapshotStructuredOutput && part.data !== undefined\n      ? { data: part.data }\n      : {}),\n    ...(includeSnapshotStructuredOutput && part.reasoning\n      ? { reasoning: part.reasoning }\n      : {}),\n    ...(part.errorMessage !== undefined && { errorMessage: part.errorMessage }),\n  }\n}\n\nfunction collectText(parts: ReadonlyArray<MessagePart>): string {\n  // The streamed JSON of a completed structured-output part is the source of\n  // truth for multi-turn coherence — emitting it back as assistant content\n  // lets the LLM see its own prior structured response. Streaming/errored\n  // parts are skipped: they'd ship malformed JSON fragments and confuse the\n  // model. `completeStructuredOutputPart` tries hard to populate `raw`\n  // (caller → existing buffer → `JSON.stringify(data)`), but the stringify\n  // fallback can leave it empty when `data` is unserializable (BigInt,\n  // circular). The `p.raw !== ''` guard below is what enforces \"no malformed\n  // round-trip\" in that case — without it we'd ship `''` and the model would\n  // see an empty assistant turn.\n  const out: Array<string> = []\n  for (const p of parts) {\n    if (p.type === 'text') {\n      out.push(p.content)\n    } else if (\n      p.type === 'structured-output' &&\n      p.status === 'complete' &&\n      p.raw !== ''\n    ) {\n      out.push(p.raw)\n    }\n  }\n  return out.join('')\n}\n\n/**\n * A child's messages, tagged with its AG-UI `subagentRunId`. The card data\n * rides in `metadata.tanstack.subagent`, so the other side can rebuild the\n * card and continue a suspended child.\n */\nfunction subagentToWire(\n  part: SubagentPart,\n  options?: { includeSnapshotStructuredOutput: boolean },\n): Array<WireMessage> {\n  const { subagent } = part\n  const info: SubagentWireInfo = {\n    name: subagent.name,\n    status: subagent.status,\n    ...(subagent.description !== undefined && {\n      description: subagent.description,\n    }),\n    ...(subagent.error !== undefined && { error: subagent.error }),\n    ...(subagent.interruptIds !== undefined && {\n      interruptIds: subagent.interruptIds,\n    }),\n    ...(subagent.parentSubagentRunId !== undefined && {\n      parentSubagentRunId: subagent.parentSubagentRunId,\n    }),\n    ...(subagent.parentToolCallId !== undefined && {\n      parentToolCallId: subagent.parentToolCallId,\n    }),\n    ...(subagent.metadata !== undefined && { metadata: subagent.metadata }),\n  }\n  const child = uiMessagesToWire(subagent.messages, options)\n  const own = child.some((message) => wireSubagentRunId(message) === undefined)\n  const messages: Array<WireMessage> = own\n    ? child\n    : [{ id: `subagent:${subagent.id}`, role: 'assistant' }, ...child]\n  return messages.map((message, index) => {\n    const nestedId = wireSubagentRunId(message)\n    if (nestedId !== undefined) {\n      const nested = wireSubagentInfo(message)\n      if (!nested || nested.parentSubagentRunId !== undefined) return message\n      return withSubagentInfo(message, nestedId, {\n        ...nested,\n        parentSubagentRunId: subagent.id,\n      })\n    }\n    return withSubagentInfo(\n      message,\n      subagent.id,\n      !own && index === 0 ? { ...info, placeholder: true } : info,\n    )\n  })\n}\n\nfunction withSubagentInfo(\n  message: WireMessage,\n  subagentRunId: string,\n  info: SubagentWireInfo,\n): WireMessage {\n  const metadata = isRecord(message.metadata) ? message.metadata : {}\n  const tanstack = isRecord(metadata.tanstack) ? metadata.tanstack : {}\n  return {\n    ...message,\n    subagentRunId,\n    metadata: { ...metadata, tanstack: { ...tanstack, subagent: info } },\n  }\n}\n\nfunction collectUserContent(\n  parts: ReadonlyArray<MessagePart>,\n): string | Array<InputContent> {\n  const hasMultimodal = parts.some(\n    (p) =>\n      p.type === 'image' ||\n      p.type === 'audio' ||\n      p.type === 'video' ||\n      p.type === 'document',\n  )\n  if (!hasMultimodal) {\n    return collectText(parts)\n  }\n  const out: Array<InputContent> = []\n  for (const p of parts) {\n    if (p.type === 'text') {\n      out.push({ type: 'text', text: p.content })\n    } else if (\n      p.type === 'image' ||\n      p.type === 'audio' ||\n      p.type === 'video' ||\n      p.type === 'document'\n    ) {\n      out.push(p)\n    }\n  }\n  return out\n}\n\nfunction thoughtSignatureFromMetadata(metadata: unknown): string | undefined {\n  if (\n    metadata == null ||\n    typeof metadata !== 'object' ||\n    Array.isArray(metadata)\n  ) {\n    return undefined\n  }\n  if (!('thoughtSignature' in metadata)) return undefined\n  const value = metadata.thoughtSignature\n  return typeof value === 'string' && value !== '' ? value : undefined\n}\n\nfunction collectToolCalls(\n  parts: ReadonlyArray<MessagePart>,\n): Array<ToolCall> | undefined {\n  const calls: Array<ToolCall> = []\n  for (const p of parts) {\n    if (p.type === 'tool-call') {\n      const encryptedValue = thoughtSignatureFromMetadata(p.metadata)\n      calls.push({\n        id: p.id,\n        type: 'function',\n        function: { name: p.name, arguments: p.arguments },\n        ...(encryptedValue !== undefined ? { encryptedValue } : {}),\n      })\n    }\n  }\n  return calls.length > 0 ? calls : undefined\n}\n\nfunction deriveReasoningId(messageId: string, part: MessagePart): string {\n  return `${messageId}-reasoning-${(part as { id?: string }).id ?? hashContent((part as { content: string }).content)}`\n}\n\nfunction deriveToolMessageId(toolCallId: string): string {\n  return `tool-${toolCallId}`\n}\n\nfunction uniqueToolWireId(id: string, used: Set<string>): string {\n  return uniqueWireId(id, used)\n}\n\nfunction uniqueWireId(id: string, used: Set<string>): string {\n  if (!used.has(id)) {\n    used.add(id)\n    return id\n  }\n  let suffix = 2\n  while (used.has(`${id}-${suffix}`)) suffix++\n  const unique = `${id}-${suffix}`\n  used.add(unique)\n  return unique\n}\n\nfunction toolWireId(\n  id: string | undefined,\n  toolCallId: string,\n  assistantIds: ReadonlySet<string>,\n): string {\n  const derived = deriveToolMessageId(toolCallId)\n  if (id === undefined || assistantIds.has(id)) return derived\n  return id\n}\n\nfunction hashContent(s: string): string {\n  // Cheap deterministic id suffix; collisions are tolerable since\n  // reasoning ids only matter for AG-UI server consumers, not for our\n  // own server's dedup logic (which keys on toolCallId, not reasoning id).\n  let h = 0\n  for (let i = 0; i < s.length; i++) h = (h * 31 + s.charCodeAt(i)) | 0\n  return Math.abs(h).toString(36)\n}\n"],"mappings":"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"}

package/dist/esm/utilities/content-source.d.ts

@@ -0,0 +1,60 @@
+import { ContentPartFileSource, ContentPartSource } from '../types.js';
+/**
+ * Narrow a {@link ContentPartSource} to the provider-file-reference arm.
+ *
+ * Issuer adapters use this to route a file source to their native wire field;
+ * everyone else is protected by the core preflight (see
+ * {@link assertMessagesFileSourceSupport}) plus a defensive throw at their own
+ * mapping site.
+ */
+export declare function isFileSource(source: ContentPartSource): source is ContentPartFileSource;
+/**
+ * Resolve the handle `providerName` should send for a file source.
+ *
+ * A file source carries one opaque handle (`value`) and, optionally, the
+ * provider that issued it. An adapter always knows which provider it talks
+ * to, so a source that names no provider is taken as-is.
+ *
+ * @throws when the source names a different issuing provider. A handle only
+ * resolves at the provider that minted it.
+ */
+export declare function fileReferenceFor(source: ContentPartFileSource, providerName: string): string;
+/**
+ * Build the standard error a non-issuer adapter throws when it encounters a
+ * `{ type: 'file' }` source it can't consume — either because the provider has
+ * no file-reference input surface, or because the endpoint requires raw bytes
+ * (image edits, Veo) rather than a reference.
+ *
+ * @param detail Optional context appended to the message (e.g. a modality or
+ * endpoint name, or a pointer to the adapter that does support references).
+ * When provided it replaces the generic remediation tail, so a site-specific
+ * hint ("pass inline bytes") is never contradicted by generic advice.
+ */
+export declare function unsupportedFileSourceError(providerName: string, detail?: string): Error;
+/**
+ * The slice of an adapter the file-source preflight reads. Adapters that can
+ * consume `{ type: 'file' }` sources declare `supportsFileSources: true`;
+ * everything else — including adapters written before this arm existed —
+ * fails closed at the activity layer instead of falling through to a
+ * URL/data branch and silently mis-mapping the reference.
+ */
+export interface FileSourceCapable {
+    name: string;
+    supportsFileSources?: boolean;
+}
+/**
+ * Fail-closed preflight for media prompts and embedding inputs
+ * (`generateImage` / `generateVideo` / `embed`): throws when the input
+ * carries a `{ type: 'file' }` source and the adapter hasn't declared
+ * `supportsFileSources`. Runs in the activity dispatcher — the same layer
+ * that validates modality — so an adapter that predates the file arm can
+ * never receive one. Walks a single part, an array of parts, and nested
+ * arrays (fused embedding items).
+ */
+export declare function assertPromptFileSourceSupport(adapter: FileSourceCapable, prompt: unknown): void;
+/**
+ * Fail-closed preflight for chat messages: throws when any message content
+ * part carries a `{ type: 'file' }` source and the adapter hasn't declared
+ * `supportsFileSources`. See {@link assertPromptFileSourceSupport}.
+ */
+export declare function assertMessagesFileSourceSupport(adapter: FileSourceCapable, messages: ReadonlyArray<unknown>): void;

package/dist/esm/utilities/content-source.js

@@ -0,0 +1,85 @@
+//#region src/utilities/content-source.ts
+/**
+* Narrow a {@link ContentPartSource} to the provider-file-reference arm.
+*
+* Issuer adapters use this to route a file source to their native wire field;
+* everyone else is protected by the core preflight (see
+* {@link assertMessagesFileSourceSupport}) plus a defensive throw at their own
+* mapping site.
+*/
+function isFileSource(source) {
+	return source.type === "file";
+}
+/**
+* Resolve the handle `providerName` should send for a file source.
+*
+* A file source carries one opaque handle (`value`) and, optionally, the
+* provider that issued it. An adapter always knows which provider it talks
+* to, so a source that names no provider is taken as-is.
+*
+* @throws when the source names a different issuing provider. A handle only
+* resolves at the provider that minted it.
+*/
+function fileReferenceFor(source, providerName) {
+	if (source.provider !== void 0 && source.provider !== providerName) throw new Error(`${providerName}: file source was issued by ${source.provider}. A provider file handle only works with the provider that issued it. Upload the file with ${providerName}Files(), or pass a data or url source instead.`);
+	return source.value;
+}
+/**
+* Build the standard error a non-issuer adapter throws when it encounters a
+* `{ type: 'file' }` source it can't consume — either because the provider has
+* no file-reference input surface, or because the endpoint requires raw bytes
+* (image edits, Veo) rather than a reference.
+*
+* @param detail Optional context appended to the message (e.g. a modality or
+* endpoint name, or a pointer to the adapter that does support references).
+* When provided it replaces the generic remediation tail, so a site-specific
+* hint ("pass inline bytes") is never contradicted by generic advice.
+*/
+function unsupportedFileSourceError(providerName, detail) {
+	return /* @__PURE__ */ new Error(`${providerName} does not support provider file-handle sources ({ type: 'file' })` + (detail ? ` ${detail}.` : ". Pass a data or url source, or upload via the provider's files adapter where supported."));
+}
+/** True when a content-part-like value carries a `{ type: 'file' }` source. */
+function partHasFileSource(part) {
+	if (typeof part !== "object" || part === null) return false;
+	const source = part.source;
+	return typeof source === "object" && source !== null && source.type === "file";
+}
+/**
+* True when `value` is a content part with a file source, or an array
+* (possibly nested — fused embedding items) that contains one.
+*/
+function inputHasFileSource(value) {
+	if (Array.isArray(value)) return value.some(inputHasFileSource);
+	return partHasFileSource(value);
+}
+/**
+* Fail-closed preflight for media prompts and embedding inputs
+* (`generateImage` / `generateVideo` / `embed`): throws when the input
+* carries a `{ type: 'file' }` source and the adapter hasn't declared
+* `supportsFileSources`. Runs in the activity dispatcher — the same layer
+* that validates modality — so an adapter that predates the file arm can
+* never receive one. Walks a single part, an array of parts, and nested
+* arrays (fused embedding items).
+*/
+function assertPromptFileSourceSupport(adapter, prompt) {
+	if (adapter.supportsFileSources === true) return;
+	if (inputHasFileSource(prompt)) throw unsupportedFileSourceError(adapter.name);
+}
+/**
+* Fail-closed preflight for chat messages: throws when any message content
+* part carries a `{ type: 'file' }` source and the adapter hasn't declared
+* `supportsFileSources`. See {@link assertPromptFileSourceSupport}.
+*/
+function assertMessagesFileSourceSupport(adapter, messages) {
+	if (adapter.supportsFileSources === true) return;
+	for (const message of messages) {
+		if (typeof message !== "object" || message === null) continue;
+		const content = message.content;
+		if (!Array.isArray(content)) continue;
+		for (const part of content) if (partHasFileSource(part)) throw unsupportedFileSourceError(adapter.name);
+	}
+}
+//#endregion
+export { assertMessagesFileSourceSupport, assertPromptFileSourceSupport, fileReferenceFor, isFileSource, unsupportedFileSourceError };
+
+//# sourceMappingURL=content-source.js.map

package/dist/esm/utilities/content-source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-source.js","names":[],"sources":["../../../src/utilities/content-source.ts"],"sourcesContent":["import type { ContentPartFileSource, ContentPartSource } from '../types'\n\n/**\n * Narrow a {@link ContentPartSource} to the provider-file-reference arm.\n *\n * Issuer adapters use this to route a file source to their native wire field;\n * everyone else is protected by the core preflight (see\n * {@link assertMessagesFileSourceSupport}) plus a defensive throw at their own\n * mapping site.\n */\nexport function isFileSource(\n  source: ContentPartSource,\n): source is ContentPartFileSource {\n  return source.type === 'file'\n}\n\n/**\n * Resolve the handle `providerName` should send for a file source.\n *\n * A file source carries one opaque handle (`value`) and, optionally, the\n * provider that issued it. An adapter always knows which provider it talks\n * to, so a source that names no provider is taken as-is.\n *\n * @throws when the source names a different issuing provider. A handle only\n * resolves at the provider that minted it.\n */\nexport function fileReferenceFor(\n  source: ContentPartFileSource,\n  providerName: string,\n): string {\n  if (source.provider !== undefined && source.provider !== providerName) {\n    throw new Error(\n      `${providerName}: file source was issued by ${source.provider}. ` +\n        `A provider file handle only works with the provider that issued ` +\n        `it. Upload the file with ${providerName}Files(), or pass a data or ` +\n        `url source instead.`,\n    )\n  }\n  return source.value\n}\n\n/**\n * Build the standard error a non-issuer adapter throws when it encounters a\n * `{ type: 'file' }` source it can't consume — either because the provider has\n * no file-reference input surface, or because the endpoint requires raw bytes\n * (image edits, Veo) rather than a reference.\n *\n * @param detail Optional context appended to the message (e.g. a modality or\n * endpoint name, or a pointer to the adapter that does support references).\n * When provided it replaces the generic remediation tail, so a site-specific\n * hint (\"pass inline bytes\") is never contradicted by generic advice.\n */\nexport function unsupportedFileSourceError(\n  providerName: string,\n  detail?: string,\n): Error {\n  return new Error(\n    `${providerName} does not support provider file-handle sources ` +\n      `({ type: 'file' })` +\n      (detail\n        ? ` ${detail}.`\n        : `. Pass a data or url source, or upload via the provider's files ` +\n          `adapter where supported.`),\n  )\n}\n\n/**\n * The slice of an adapter the file-source preflight reads. Adapters that can\n * consume `{ type: 'file' }` sources declare `supportsFileSources: true`;\n * everything else — including adapters written before this arm existed —\n * fails closed at the activity layer instead of falling through to a\n * URL/data branch and silently mis-mapping the reference.\n */\nexport interface FileSourceCapable {\n  name: string\n  supportsFileSources?: boolean\n}\n\n/** True when a content-part-like value carries a `{ type: 'file' }` source. */\nfunction partHasFileSource(part: unknown): boolean {\n  if (typeof part !== 'object' || part === null) return false\n  const source = (part as { source?: unknown }).source\n  return (\n    typeof source === 'object' &&\n    source !== null &&\n    (source as { type?: unknown }).type === 'file'\n  )\n}\n\n/**\n * True when `value` is a content part with a file source, or an array\n * (possibly nested — fused embedding items) that contains one.\n */\nfunction inputHasFileSource(value: unknown): boolean {\n  if (Array.isArray(value)) return value.some(inputHasFileSource)\n  return partHasFileSource(value)\n}\n\n/**\n * Fail-closed preflight for media prompts and embedding inputs\n * (`generateImage` / `generateVideo` / `embed`): throws when the input\n * carries a `{ type: 'file' }` source and the adapter hasn't declared\n * `supportsFileSources`. Runs in the activity dispatcher — the same layer\n * that validates modality — so an adapter that predates the file arm can\n * never receive one. Walks a single part, an array of parts, and nested\n * arrays (fused embedding items).\n */\nexport function assertPromptFileSourceSupport(\n  adapter: FileSourceCapable,\n  prompt: unknown,\n): void {\n  if (adapter.supportsFileSources === true) return\n  if (inputHasFileSource(prompt)) {\n    throw unsupportedFileSourceError(adapter.name)\n  }\n}\n\n/**\n * Fail-closed preflight for chat messages: throws when any message content\n * part carries a `{ type: 'file' }` source and the adapter hasn't declared\n * `supportsFileSources`. See {@link assertPromptFileSourceSupport}.\n */\nexport function assertMessagesFileSourceSupport(\n  adapter: FileSourceCapable,\n  messages: ReadonlyArray<unknown>,\n): void {\n  if (adapter.supportsFileSources === true) return\n  for (const message of messages) {\n    if (typeof message !== 'object' || message === null) continue\n    const content = (message as { content?: unknown }).content\n    if (!Array.isArray(content)) continue\n    for (const part of content) {\n      if (partHasFileSource(part)) {\n        throw unsupportedFileSourceError(adapter.name)\n      }\n    }\n  }\n}\n"],"mappings":";;;;;;;;;AAUA,SAAgB,aACd,QACiC;CACjC,OAAO,OAAO,SAAS;AACzB;;;;;;;;;;;AAYA,SAAgB,iBACd,QACA,cACQ;CACR,IAAI,OAAO,aAAa,KAAA,KAAa,OAAO,aAAa,cACvD,MAAM,IAAI,MACR,GAAG,aAAa,8BAA8B,OAAO,SAAS,6FAEhC,aAAa,+CAE7C;CAEF,OAAO,OAAO;AAChB;;;;;;;;;;;;AAaA,SAAgB,2BACd,cACA,QACO;CACP,uBAAO,IAAI,MACT,GAAG,aAAa,sEAEb,SACG,IAAI,OAAO,KACX,2FAER;AACF;;AAeA,SAAS,kBAAkB,MAAwB;CACjD,IAAI,OAAO,SAAS,YAAY,SAAS,MAAM,OAAO;CACtD,MAAM,SAAU,KAA8B;CAC9C,OACE,OAAO,WAAW,YAClB,WAAW,QACV,OAA8B,SAAS;AAE5C;;;;;AAMA,SAAS,mBAAmB,OAAyB;CACnD,IAAI,MAAM,QAAQ,KAAK,GAAG,OAAO,MAAM,KAAK,kBAAkB;CAC9D,OAAO,kBAAkB,KAAK;AAChC;;;;;;;;;;AAWA,SAAgB,8BACd,SACA,QACM;CACN,IAAI,QAAQ,wBAAwB,MAAM;CAC1C,IAAI,mBAAmB,MAAM,GAC3B,MAAM,2BAA2B,QAAQ,IAAI;AAEjD;;;;;;AAOA,SAAgB,gCACd,SACA,UACM;CACN,IAAI,QAAQ,wBAAwB,MAAM;CAC1C,KAAK,MAAM,WAAW,UAAU;EAC9B,IAAI,OAAO,YAAY,YAAY,YAAY,MAAM;EACrD,MAAM,UAAW,QAAkC;EACnD,IAAI,CAAC,MAAM,QAAQ,OAAO,GAAG;EAC7B,KAAK,MAAM,QAAQ,SACjB,IAAI,kBAAkB,IAAI,GACxB,MAAM,2BAA2B,QAAQ,IAAI;CAGnD;AACF"}

package/dist/esm/utilities/provider-executed.d.ts

@@ -16,3 +16,10 @@ export declare function getProviderExecutedMetadata(toolCall: {
 export declare function isProviderExecutedToolCall(toolCall: {
     metadata?: unknown;
 } | null | undefined): boolean;
+/**
+ * True when `id` is a `${parentId}-segment-${n}` message. The wire and the
+ * run loop split one provider turn into segments at thinking that follows a
+ * provider-executed tool call, to keep signed thinking order. Readers fold a
+ * segment back into its parent so the UI still shows one message.
+ */
+export declare function isAssistantSegmentOf(id: string | undefined, parentId: string): boolean;

package/dist/esm/utilities/provider-executed.js

@@ -18,7 +18,16 @@ function getProviderExecutedMetadata(toolCall) {
 function isProviderExecutedToolCall(toolCall) {
 	return getProviderExecutedMetadata(toolCall) !== null;
 }
+/**
+* True when `id` is a `${parentId}-segment-${n}` message. The wire and the
+* run loop split one provider turn into segments at thinking that follows a
+* provider-executed tool call, to keep signed thinking order. Readers fold a
+* segment back into its parent so the UI still shows one message.
+*/
+function isAssistantSegmentOf(id, parentId) {
+	return id?.startsWith(`${parentId}-segment-`) === true;
+}
 //#endregion
-export { getProviderExecutedMetadata, isProviderExecutedToolCall };
+export { getProviderExecutedMetadata, isAssistantSegmentOf, isProviderExecutedToolCall };
 
 //# sourceMappingURL=provider-executed.js.map

package/dist/esm/utilities/provider-executed.js.map

@@ -1 +1 @@
-{"version":3,"file":"provider-executed.js","names":[],"sources":["../../../src/utilities/provider-executed.ts"],"sourcesContent":["import type { ProviderExecutedToolMetadata } from '../types'\n\n/**\n * Narrow a tool call's opaque `metadata` to the provider-executed convention.\n * Returns the typed metadata when the call is provider-executed, else `null`.\n *\n * @see ProviderExecutedToolMetadata\n */\nexport function getProviderExecutedMetadata(\n  toolCall: { metadata?: unknown } | null | undefined,\n): ProviderExecutedToolMetadata | null {\n  const metadata = toolCall?.metadata\n  if (\n    typeof metadata === 'object' &&\n    metadata !== null &&\n    (metadata as ProviderExecutedToolMetadata).providerExecuted === true\n  ) {\n    return metadata as ProviderExecutedToolMetadata\n  }\n  return null\n}\n\n/**\n * True when a tool call was executed by the provider (e.g. Anthropic\n * `web_search` / `web_fetch` server tools) rather than the agent loop. Such\n * calls must not be routed to client-side execution and are already \"complete\".\n */\nexport function isProviderExecutedToolCall(\n  toolCall: { metadata?: unknown } | null | undefined,\n): boolean {\n  return getProviderExecutedMetadata(toolCall) !== null\n}\n"],"mappings":";;;;;;;AAQA,SAAgB,4BACd,UACqC;CACrC,MAAM,WAAW,UAAU;CAC3B,IACE,OAAO,aAAa,YACpB,aAAa,QACZ,SAA0C,qBAAqB,MAEhE,OAAO;CAET,OAAO;AACT;;;;;;AAOA,SAAgB,2BACd,UACS;CACT,OAAO,4BAA4B,QAAQ,MAAM;AACnD"}
+{"version":3,"file":"provider-executed.js","names":[],"sources":["../../../src/utilities/provider-executed.ts"],"sourcesContent":["import type { ProviderExecutedToolMetadata } from '../types'\n\n/**\n * Narrow a tool call's opaque `metadata` to the provider-executed convention.\n * Returns the typed metadata when the call is provider-executed, else `null`.\n *\n * @see ProviderExecutedToolMetadata\n */\nexport function getProviderExecutedMetadata(\n  toolCall: { metadata?: unknown } | null | undefined,\n): ProviderExecutedToolMetadata | null {\n  const metadata = toolCall?.metadata\n  if (\n    typeof metadata === 'object' &&\n    metadata !== null &&\n    (metadata as ProviderExecutedToolMetadata).providerExecuted === true\n  ) {\n    return metadata as ProviderExecutedToolMetadata\n  }\n  return null\n}\n\n/**\n * True when a tool call was executed by the provider (e.g. Anthropic\n * `web_search` / `web_fetch` server tools) rather than the agent loop. Such\n * calls must not be routed to client-side execution and are already \"complete\".\n */\nexport function isProviderExecutedToolCall(\n  toolCall: { metadata?: unknown } | null | undefined,\n): boolean {\n  return getProviderExecutedMetadata(toolCall) !== null\n}\n\n/**\n * True when `id` is a `${parentId}-segment-${n}` message. The wire and the\n * run loop split one provider turn into segments at thinking that follows a\n * provider-executed tool call, to keep signed thinking order. Readers fold a\n * segment back into its parent so the UI still shows one message.\n */\nexport function isAssistantSegmentOf(\n  id: string | undefined,\n  parentId: string,\n): boolean {\n  return id?.startsWith(`${parentId}-segment-`) === true\n}\n"],"mappings":";;;;;;;AAQA,SAAgB,4BACd,UACqC;CACrC,MAAM,WAAW,UAAU;CAC3B,IACE,OAAO,aAAa,YACpB,aAAa,QACZ,SAA0C,qBAAqB,MAEhE,OAAO;CAET,OAAO;AACT;;;;;;AAOA,SAAgB,2BACd,UACS;CACT,OAAO,4BAA4B,QAAQ,MAAM;AACnD;;;;;;;AAQA,SAAgB,qBACd,IACA,UACS;CACT,OAAO,IAAI,WAAW,GAAG,SAAS,UAAU,MAAM;AACpD"}

package/dist/esm/utilities/tool-result.d.ts

@@ -1,8 +1,9 @@
 import { ContentPart } from '../types.js';
 /**
  * Structural check for a single `ContentPart`. A text part must carry a string
- * `content`; every other modality must carry a `source` with `type` of
- * `'url' | 'data'` and a string `value`.
+ * `content`. Every other part carries a source with a string `value`; a file
+ * source's `value` is a non-empty opaque handle, and its optional `provider`
+ * is a string.
  */
 export declare function isContentPart(value: unknown): value is ContentPart;
 /**
@@ -12,6 +13,15 @@ export declare function isContentPart(value: unknown): value is ContentPart;
  * footgun narrow.
  */
 export declare function isContentPartArray(value: unknown): value is Array<ContentPart>;
+/**
+ * Error text for a failed tool result: `output.error` when it is a string,
+ * else the output itself when it is a string, else a generic message.
+ * `StreamProcessor` and `chat()` history share it, so a reload shows the
+ * same text as the live stream.
+ */
+export declare function toolResultErrorText(output: unknown): string;
+/** Parse tool result content as JSON. Plain text stays a string. */
+export declare function parseToolOutput(content: string): unknown;
 /**
  * Normalize a tool's return value for transport:
  * - string            → unchanged

package/dist/esm/utilities/tool-result.js

@@ -8,8 +8,9 @@ var CONTENT_PART_TYPES = /* @__PURE__ */ new Set([
 ]);
 /**
 * Structural check for a single `ContentPart`. A text part must carry a string
-* `content`; every other modality must carry a `source` with `type` of
-* `'url' | 'data'` and a string `value`.
+* `content`. Every other part carries a source with a string `value`; a file
+* source's `value` is a non-empty opaque handle, and its optional `provider`
+* is a string.
 */
 function isContentPart(value) {
 	if (typeof value !== "object" || value === null) return false;
@@ -20,6 +21,7 @@ function isContentPart(value) {
 	if (typeof source !== "object" || source === null) return false;
 	const src = source;
 	if (typeof src.value !== "string") return false;
+	if (src.type === "file") return src.value.length > 0 && (src.provider === void 0 || typeof src.provider === "string");
 	if (src.type === "data") return typeof src.mimeType === "string";
 	return src.type === "url";
 }
@@ -33,6 +35,24 @@ function isContentPartArray(value) {
 	return Array.isArray(value) && value.length > 0 && value.every(isContentPart);
 }
 /**
+* Error text for a failed tool result: `output.error` when it is a string,
+* else the output itself when it is a string, else a generic message.
+* `StreamProcessor` and `chat()` history share it, so a reload shows the
+* same text as the live stream.
+*/
+function toolResultErrorText(output) {
+	if (output && typeof output === "object" && "error" in output && typeof output.error === "string") return output.error;
+	return typeof output === "string" ? output : "Tool execution failed";
+}
+/** Parse tool result content as JSON. Plain text stays a string. */
+function parseToolOutput(content) {
+	try {
+		return JSON.parse(content);
+	} catch {
+		return content;
+	}
+}
+/**
 * Normalize a tool's return value for transport:
 * - string            → unchanged
 * - ContentPart array → unchanged (multimodal, passed through to the adapter)
@@ -44,6 +64,6 @@ function normalizeToolResult(result) {
 	return JSON.stringify(result);
 }
 //#endregion
-export { isContentPart, isContentPartArray, normalizeToolResult };
+export { isContentPart, isContentPartArray, normalizeToolResult, parseToolOutput, toolResultErrorText };
 
 //# sourceMappingURL=tool-result.js.map