@tanstack/ai 0.61.0 → 0.63.0

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 { 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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"}
+{"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  ToolResultOutcome,\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  outcome?: ToolResultOutcome,\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: {\n      ...tanstack,\n      ...(outcome !== undefined && { toolResultOutcome: outcome }),\n      toolResult,\n    },\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          part.outcome,\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            false,\n            part.approval?.approved === false ? 'denied' : undefined,\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?.run?.id !== undefined)\n    tanstack.run = { id: previousTanstack.run.id }\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/tool-result.d.ts

@@ -1,4 +1,5 @@
-import { ContentPart } from '../types.js';
+import { ContentPart, ToolResultOutcome } from '../types.js';
+export declare function isToolResultOutcome(value: unknown): value is ToolResultOutcome;
 /**
  * Structural check for a single `ContentPart`. A text part must carry a string
  * `content`. Every other part carries a source with a string `value`; a file

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

@@ -6,6 +6,9 @@ var CONTENT_PART_TYPES = /* @__PURE__ */ new Set([
 	"video",
 	"document"
 ]);
+function isToolResultOutcome(value) {
+	return value === "cancelled" || value === "denied";
+}
 /**
 * Structural check for a single `ContentPart`. A text part must carry a string
 * `content`. Every other part carries a source with a string `value`; a file
@@ -64,6 +67,6 @@ function normalizeToolResult(result) {
 	return JSON.stringify(result);
 }
 //#endregion
-export { isContentPart, isContentPartArray, normalizeToolResult, parseToolOutput, toolResultErrorText };
+export { isContentPart, isContentPartArray, isToolResultOutcome, normalizeToolResult, parseToolOutput, toolResultErrorText };
 
 //# sourceMappingURL=tool-result.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"tool-result.js","names":[],"sources":["../../../src/utilities/tool-result.ts"],"sourcesContent":["import type { ContentPart } from '../types'\n\nconst CONTENT_PART_TYPES = new Set([\n  'text',\n  'image',\n  'audio',\n  'video',\n  'document',\n])\n\n/**\n * Structural check for a single `ContentPart`. A text part must carry a string\n * `content`. Every other part carries a source with a string `value`; a file\n * source's `value` is a non-empty opaque handle, and its optional `provider`\n * is a string.\n */\nexport function isContentPart(value: unknown): value is ContentPart {\n  if (typeof value !== 'object' || value === null) return false\n  const part = value as Record<string, unknown>\n  if (typeof part.type !== 'string' || !CONTENT_PART_TYPES.has(part.type)) {\n    return false\n  }\n  if (part.type === 'text') {\n    return typeof part.content === 'string'\n  }\n  const source = part.source\n  if (typeof source !== 'object' || source === null) return false\n  const src = source as Record<string, unknown>\n  if (typeof src.value !== 'string') return false\n  // `file` sources carry an opaque handle in `value`; `provider`, when set,\n  // names the issuer.\n  if (src.type === 'file') {\n    return (\n      src.value.length > 0 &&\n      (src.provider === undefined || typeof src.provider === 'string')\n    )\n  }\n  // `data` sources require a mimeType (matches ContentPartDataSource); `url`\n  // sources don't. Requiring it here keeps the runtime guard consistent with\n  // the type and avoids emitting `data:undefined;base64,...` downstream.\n  if (src.type === 'data') return typeof src.mimeType === 'string'\n  return src.type === 'url'\n}\n\n/**\n * True iff `value` is a NON-EMPTY array whose every element is a valid\n * `ContentPart`. Empty arrays and mixed arrays return false so they continue\n * to be treated as ordinary (stringified) data — this keeps the auto-detection\n * footgun narrow.\n */\nexport function isContentPartArray(\n  value: unknown,\n): value is Array<ContentPart> {\n  return Array.isArray(value) && value.length > 0 && value.every(isContentPart)\n}\n\n/**\n * Error text for a failed tool result: `output.error` when it is a string,\n * else the output itself when it is a string, else a generic message.\n * `StreamProcessor` and `chat()` history share it, so a reload shows the\n * same text as the live stream.\n */\nexport function toolResultErrorText(output: unknown): string {\n  if (\n    output &&\n    typeof output === 'object' &&\n    'error' in output &&\n    typeof output.error === 'string'\n  ) {\n    return output.error\n  }\n  return typeof output === 'string' ? output : 'Tool execution failed'\n}\n\n/** Parse tool result content as JSON. Plain text stays a string. */\nexport function parseToolOutput(content: string): unknown {\n  try {\n    return JSON.parse(content)\n  } catch {\n    return content\n  }\n}\n\n/**\n * Normalize a tool's return value for transport:\n * - string            → unchanged\n * - ContentPart array → unchanged (multimodal, passed through to the adapter)\n * - anything else     → `JSON.stringify`\n */\nexport function normalizeToolResult(\n  result: unknown,\n): string | Array<ContentPart> {\n  if (typeof result === 'string') return result\n  if (isContentPartArray(result)) return result\n  return JSON.stringify(result)\n}\n"],"mappings":";AAEA,IAAM,qCAAqB,IAAI,IAAI;CACjC;CACA;CACA;CACA;CACA;AACF,CAAC;;;;;;;AAQD,SAAgB,cAAc,OAAsC;CAClE,IAAI,OAAO,UAAU,YAAY,UAAU,MAAM,OAAO;CACxD,MAAM,OAAO;CACb,IAAI,OAAO,KAAK,SAAS,YAAY,CAAC,mBAAmB,IAAI,KAAK,IAAI,GACpE,OAAO;CAET,IAAI,KAAK,SAAS,QAChB,OAAO,OAAO,KAAK,YAAY;CAEjC,MAAM,SAAS,KAAK;CACpB,IAAI,OAAO,WAAW,YAAY,WAAW,MAAM,OAAO;CAC1D,MAAM,MAAM;CACZ,IAAI,OAAO,IAAI,UAAU,UAAU,OAAO;CAG1C,IAAI,IAAI,SAAS,QACf,OACE,IAAI,MAAM,SAAS,MAClB,IAAI,aAAa,KAAA,KAAa,OAAO,IAAI,aAAa;CAM3D,IAAI,IAAI,SAAS,QAAQ,OAAO,OAAO,IAAI,aAAa;CACxD,OAAO,IAAI,SAAS;AACtB;;;;;;;AAQA,SAAgB,mBACd,OAC6B;CAC7B,OAAO,MAAM,QAAQ,KAAK,KAAK,MAAM,SAAS,KAAK,MAAM,MAAM,aAAa;AAC9E;;;;;;;AAQA,SAAgB,oBAAoB,QAAyB;CAC3D,IACE,UACA,OAAO,WAAW,YAClB,WAAW,UACX,OAAO,OAAO,UAAU,UAExB,OAAO,OAAO;CAEhB,OAAO,OAAO,WAAW,WAAW,SAAS;AAC/C;;AAGA,SAAgB,gBAAgB,SAA0B;CACxD,IAAI;EACF,OAAO,KAAK,MAAM,OAAO;CAC3B,QAAQ;EACN,OAAO;CACT;AACF;;;;;;;AAQA,SAAgB,oBACd,QAC6B;CAC7B,IAAI,OAAO,WAAW,UAAU,OAAO;CACvC,IAAI,mBAAmB,MAAM,GAAG,OAAO;CACvC,OAAO,KAAK,UAAU,MAAM;AAC9B"}
+{"version":3,"file":"tool-result.js","names":[],"sources":["../../../src/utilities/tool-result.ts"],"sourcesContent":["import type { ContentPart, ToolResultOutcome } from '../types'\n\nconst CONTENT_PART_TYPES = new Set([\n  'text',\n  'image',\n  'audio',\n  'video',\n  'document',\n])\n\nexport function isToolResultOutcome(\n  value: unknown,\n): value is ToolResultOutcome {\n  return value === 'cancelled' || value === 'denied'\n}\n\n/**\n * Structural check for a single `ContentPart`. A text part must carry a string\n * `content`. Every other part carries a source with a string `value`; a file\n * source's `value` is a non-empty opaque handle, and its optional `provider`\n * is a string.\n */\nexport function isContentPart(value: unknown): value is ContentPart {\n  if (typeof value !== 'object' || value === null) return false\n  const part = value as Record<string, unknown>\n  if (typeof part.type !== 'string' || !CONTENT_PART_TYPES.has(part.type)) {\n    return false\n  }\n  if (part.type === 'text') {\n    return typeof part.content === 'string'\n  }\n  const source = part.source\n  if (typeof source !== 'object' || source === null) return false\n  const src = source as Record<string, unknown>\n  if (typeof src.value !== 'string') return false\n  // `file` sources carry an opaque handle in `value`; `provider`, when set,\n  // names the issuer.\n  if (src.type === 'file') {\n    return (\n      src.value.length > 0 &&\n      (src.provider === undefined || typeof src.provider === 'string')\n    )\n  }\n  // `data` sources require a mimeType (matches ContentPartDataSource); `url`\n  // sources don't. Requiring it here keeps the runtime guard consistent with\n  // the type and avoids emitting `data:undefined;base64,...` downstream.\n  if (src.type === 'data') return typeof src.mimeType === 'string'\n  return src.type === 'url'\n}\n\n/**\n * True iff `value` is a NON-EMPTY array whose every element is a valid\n * `ContentPart`. Empty arrays and mixed arrays return false so they continue\n * to be treated as ordinary (stringified) data — this keeps the auto-detection\n * footgun narrow.\n */\nexport function isContentPartArray(\n  value: unknown,\n): value is Array<ContentPart> {\n  return Array.isArray(value) && value.length > 0 && value.every(isContentPart)\n}\n\n/**\n * Error text for a failed tool result: `output.error` when it is a string,\n * else the output itself when it is a string, else a generic message.\n * `StreamProcessor` and `chat()` history share it, so a reload shows the\n * same text as the live stream.\n */\nexport function toolResultErrorText(output: unknown): string {\n  if (\n    output &&\n    typeof output === 'object' &&\n    'error' in output &&\n    typeof output.error === 'string'\n  ) {\n    return output.error\n  }\n  return typeof output === 'string' ? output : 'Tool execution failed'\n}\n\n/** Parse tool result content as JSON. Plain text stays a string. */\nexport function parseToolOutput(content: string): unknown {\n  try {\n    return JSON.parse(content)\n  } catch {\n    return content\n  }\n}\n\n/**\n * Normalize a tool's return value for transport:\n * - string            → unchanged\n * - ContentPart array → unchanged (multimodal, passed through to the adapter)\n * - anything else     → `JSON.stringify`\n */\nexport function normalizeToolResult(\n  result: unknown,\n): string | Array<ContentPart> {\n  if (typeof result === 'string') return result\n  if (isContentPartArray(result)) return result\n  return JSON.stringify(result)\n}\n"],"mappings":";AAEA,IAAM,qCAAqB,IAAI,IAAI;CACjC;CACA;CACA;CACA;CACA;AACF,CAAC;AAED,SAAgB,oBACd,OAC4B;CAC5B,OAAO,UAAU,eAAe,UAAU;AAC5C;;;;;;;AAQA,SAAgB,cAAc,OAAsC;CAClE,IAAI,OAAO,UAAU,YAAY,UAAU,MAAM,OAAO;CACxD,MAAM,OAAO;CACb,IAAI,OAAO,KAAK,SAAS,YAAY,CAAC,mBAAmB,IAAI,KAAK,IAAI,GACpE,OAAO;CAET,IAAI,KAAK,SAAS,QAChB,OAAO,OAAO,KAAK,YAAY;CAEjC,MAAM,SAAS,KAAK;CACpB,IAAI,OAAO,WAAW,YAAY,WAAW,MAAM,OAAO;CAC1D,MAAM,MAAM;CACZ,IAAI,OAAO,IAAI,UAAU,UAAU,OAAO;CAG1C,IAAI,IAAI,SAAS,QACf,OACE,IAAI,MAAM,SAAS,MAClB,IAAI,aAAa,KAAA,KAAa,OAAO,IAAI,aAAa;CAM3D,IAAI,IAAI,SAAS,QAAQ,OAAO,OAAO,IAAI,aAAa;CACxD,OAAO,IAAI,SAAS;AACtB;;;;;;;AAQA,SAAgB,mBACd,OAC6B;CAC7B,OAAO,MAAM,QAAQ,KAAK,KAAK,MAAM,SAAS,KAAK,MAAM,MAAM,aAAa;AAC9E;;;;;;;AAQA,SAAgB,oBAAoB,QAAyB;CAC3D,IACE,UACA,OAAO,WAAW,YAClB,WAAW,UACX,OAAO,OAAO,UAAU,UAExB,OAAO,OAAO;CAEhB,OAAO,OAAO,WAAW,WAAW,SAAS;AAC/C;;AAGA,SAAgB,gBAAgB,SAA0B;CACxD,IAAI;EACF,OAAO,KAAK,MAAM,OAAO;CAC3B,QAAQ;EACN,OAAO;CACT;AACF;;;;;;;AAQA,SAAgB,oBACd,QAC6B;CAC7B,IAAI,OAAO,WAAW,UAAU,OAAO;CACvC,IAAI,mBAAmB,MAAM,GAAG,OAAO;CACvC,OAAO,KAAK,UAAU,MAAM;AAC9B"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/ai",
-  "version": "0.61.0",
+  "version": "0.63.0",
   "description": "Type-safe TypeScript AI SDK for streaming chat, tool calling, agents, structured outputs, and multimodal generation.",
   "author": "Tanner Linsley",
   "license": "MIT",
@@ -110,9 +110,9 @@
     "clean": "premove ./build ./dist",
     "lint:fix": "oxlint src --type-aware --fix",
     "test:build": "publint --strict",
-    "test:coverage": "vitest run --coverage",
-    "test:coverage:watch": "vitest --coverage --watch",
     "test:oxlint": "oxlint src --type-aware",
+    "test:coverage": "vitest run --coverage --coverage.include='src/**' --coverage.reporter=text-summary --coverage.reporter=json-summary",
+    "test:coverage:watch": "vitest --coverage --watch",
     "test:lib": "vitest",
     "test:lib:dev": "pnpm test:lib --watch",
     "test:types": "tsc"

package/skills/ai-core/chat-experience/SKILL.md

@@ -399,6 +399,9 @@ Pass `mcp` to let `chat()` own discovery **and** lifecycle for one or more MCP
 clients. Useful when you want minimal boilerplate and don't need to reuse the
 clients across calls.
 
+`createMCPClient` tries spec `2026-07-28` first.
+If the server does not support that spec, the client uses the 2025 initialize handshake.
+
 ```typescript
 // Prop shape:
 // chat({
@@ -457,6 +460,123 @@ export async function POST(request: Request) {
 }
 ```
 
+**Host an MCP server.** Import `createMCPServer` from `@tanstack/ai-mcp/server`.
+Call `server.fetch(request)` in your HTTP route.
+
+```typescript
+import { toolDefinition } from '@tanstack/ai'
+import { createMCPServer } from '@tanstack/ai-mcp/server'
+import { z } from 'zod'
+
+const getWeather = toolDefinition({
+  name: 'get_weather',
+  description: 'Current weather for a city',
+  inputSchema: z.object({ city: z.string() }),
+}).server(async ({ city }) => {
+  return { city, temperature: 18, conditions: 'clear' }
+})
+
+const server = createMCPServer({
+  name: 'weather',
+  version: '1.0.0',
+  tools: [getWeather],
+})
+
+export function handleMcp(request: Request) {
+  return server.fetch(request)
+}
+
+// Mount handleMcp on GET, POST, and DELETE.
+// GET is the spec 2025 stream.
+// DELETE closes a spec 2025 session.
+```
+
+`serveMCPStdio` from `@tanstack/ai-mcp/server/stdio` serves that server on stdin and stdout.
+Write logs with `console.error`.
+stdout carries only protocol messages.
+
+```typescript
+import { toolDefinition } from '@tanstack/ai'
+import { createMCPServer } from '@tanstack/ai-mcp/server'
+import { serveMCPStdio } from '@tanstack/ai-mcp/server/stdio'
+import { z } from 'zod'
+
+const getWeather = toolDefinition({
+  name: 'get_weather',
+  description: 'Current weather for a city',
+  inputSchema: z.object({ city: z.string() }),
+}).server(async ({ city }) => {
+  return { city, temperature: 18, conditions: 'clear' }
+})
+
+const server = createMCPServer({
+  name: 'weather',
+  version: '1.0.0',
+  tools: [getWeather],
+})
+
+serveMCPStdio(server)
+```
+
+**MCP input interrupt.** When `chat()` receives an MCP input request, the run outcome is an interrupt.
+The stream ends with `RUN_FINISHED`.
+The outcome type is `interrupt`.
+Read each interrupt whose `reason` is `mcp_input`.
+The payload key is `tanstack:interruptPayload`.
+
+`form` means the server asks the user for input.
+`sampling` means the server asks for a model result.
+
+```typescript
+import { chat, INTERRUPT_PAYLOAD_METADATA_KEY } from '@tanstack/ai'
+import { openaiText } from '@tanstack/ai-openai'
+import { createMCPClient } from '@tanstack/ai-mcp'
+
+const client = await createMCPClient({
+  transport: { type: 'http', url: 'https://mcp.example.com/mcp' },
+})
+
+try {
+  const stream = chat({
+    adapter: openaiText('gpt-5.6'),
+    messages: [{ role: 'user', content: 'Weather in Paris?' }],
+    tools: await client.tools(),
+  })
+
+  for await (const chunk of stream) {
+    if (chunk.type !== 'RUN_FINISHED') continue
+    if (chunk.outcome?.type !== 'interrupt') continue
+
+    for (const item of chunk.outcome.interrupts) {
+      if (item.reason !== 'mcp_input') continue
+      const payload = item.metadata?.[INTERRUPT_PAYLOAD_METADATA_KEY]
+      if (typeof payload !== 'object' || payload === null) continue
+      if (!('kind' in payload)) continue
+      // payload.kind is 'form' or 'sampling'
+    }
+  }
+} finally {
+  await client.close()
+}
+```
+
+To continue, answer the interrupt:
+
+1. In `useChat`, the item `kind` is `generic`.
+2. For a `form`, call `resolveInterrupt` with an object that matches `request.requestedSchema`. A `createMCPServer` server asks for `{ value: string }`.
+3. For `sampling`, call `resolveInterrupt` with the reply text.
+4. Call `cancel()` to decline.
+5. The route passes `parentRunId` and `resume` to `chat()`. The tool runs again with the answer.
+
+```tsx ignore
+// `interrupt` is one item from `useChat().interrupts`.
+if (interrupt.reason === 'mcp_input' && interrupt.kind === 'generic') {
+  interrupt.resolveInterrupt({ value: 'Paris' })
+}
+```
+
+This works on spec `2026-07-28`. On spec 2025, the server asks the client in the middle of the tool call. `chat()` cannot pause that call, so the tool call fails.
+
 ### 7. Queueing Messages Sent While Streaming
 
 By default, a `sendMessage` call that arrives while a stream is in flight is

package/skills/ai-core/tool-calling/SKILL.md

@@ -513,6 +513,9 @@ The post-discovery payload always returns the full description and schema regard
 `@tanstack/ai-mcp` lets a server-side `chat()` call discover and invoke tools
 hosted on any MCP server (Streamable HTTP, SSE, or stdio).
 
+`createMCPClient` tries spec `2026-07-28` first.
+If the server does not support that spec, the client uses the 2025 initialize handshake.
+
 **MCP tools and UI resources:** When an MCP tool result carries a `ui://`
 resource URI (via `_meta.ui.resourceUri`), TanStack AI surfaces it as a
 `UIResourcePart` on the assistant `UIMessage` in the client message list.
@@ -723,6 +726,106 @@ export async function POST(request: Request) {
 }
 ```
 
+### Host your own MCP server
+
+Import `createMCPServer` from `@tanstack/ai-mcp/server`.
+Pass tools from `toolDefinition().server()`.
+Call `server.fetch(request)` in your HTTP route.
+
+```typescript
+import { toolDefinition } from '@tanstack/ai'
+import { createMCPServer } from '@tanstack/ai-mcp/server'
+import { z } from 'zod'
+
+const getWeather = toolDefinition({
+  name: 'get_weather',
+  description: 'Current weather for a city',
+  inputSchema: z.object({ city: z.string() }),
+}).server(async ({ city }) => {
+  return { city, temperature: 18, conditions: 'clear' }
+})
+
+const server = createMCPServer({
+  name: 'weather',
+  version: '1.0.0',
+  tools: [getWeather],
+})
+
+export function POST(request: Request) {
+  return server.fetch(request)
+}
+```
+
+`stdioTransport` from `@tanstack/ai-mcp/stdio` connects your client to a command.
+`serveMCPStdio` from `@tanstack/ai-mcp/server/stdio` serves your server on stdin and stdout.
+Write logs with `console.error`.
+stdout carries only protocol messages.
+
+```typescript
+import { toolDefinition } from '@tanstack/ai'
+import { createMCPServer } from '@tanstack/ai-mcp/server'
+import { serveMCPStdio } from '@tanstack/ai-mcp/server/stdio'
+import { z } from 'zod'
+
+const getWeather = toolDefinition({
+  name: 'get_weather',
+  description: 'Current weather for a city',
+  inputSchema: z.object({ city: z.string() }),
+}).server(async ({ city }) => {
+  return { city, temperature: 18, conditions: 'clear' }
+})
+
+const server = createMCPServer({
+  name: 'weather',
+  version: '1.0.0',
+  tools: [getWeather],
+})
+
+serveMCPStdio(server)
+```
+
+The `@tanstack/ai-mcp` skill shows `ctx.context.requestInput` and `ctx.context.sample`.
+
+### Read an MCP input interrupt
+
+When `chat()` receives an MCP input request, the run outcome is an interrupt.
+The stream ends with `RUN_FINISHED`.
+The outcome type is `interrupt`.
+Read each interrupt whose `reason` is `mcp_input`.
+The payload key is `tanstack:interruptPayload`.
+
+`form` means the server asks the user for input.
+`sampling` means the server asks for a model result.
+
+```typescript
+import { chat, INTERRUPT_PAYLOAD_METADATA_KEY } from '@tanstack/ai'
+import { openaiText } from '@tanstack/ai-openai'
+import { createMCPClient } from '@tanstack/ai-mcp'
+
+const client = await createMCPClient({
+  transport: { type: 'http', url: 'https://mcp.example.com/mcp' },
+})
+
+const stream = chat({
+  adapter: openaiText('gpt-5.5'),
+  messages: [{ role: 'user', content: 'Weather in Paris?' }],
+  tools: await client.tools(),
+})
+
+for await (const chunk of stream) {
+  if (chunk.type !== 'RUN_FINISHED') continue
+  if (chunk.outcome?.type !== 'interrupt') continue
+
+  for (const item of chunk.outcome.interrupts) {
+    if (item.reason !== 'mcp_input') continue
+    const payload = item.metadata?.[INTERRUPT_PAYLOAD_METADATA_KEY]
+    if (typeof payload !== 'object' || payload === null) continue
+    if (!('kind' in payload)) continue
+    // payload.kind is 'form' or 'sampling'
+  }
+}
+```
+
 ## Provider Skills
 
 > **Not to be confused with `@tanstack/ai-code-mode-snippets`**, whose snippets are TypeScript functions your application generates and runs in its own Code Mode sandbox (a local JS isolate). Provider Skills are hosted, provider-managed bundles that the model loads on demand and runs inside the provider's server-side sandbox.

package/src/activities/chat/agents/define-agent.ts

@@ -2,6 +2,7 @@ import type { SubagentInfo as AGUISubagentInfo } from '@ag-ui/core'
 import type { InterruptDefinition } from '../../../interrupt-definition'
 import type {
   AnyTool,
+  InferSchemaType,
   ModelMessage,
   RunAgentResumeItem,
   SchemaInput,
@@ -12,8 +13,16 @@ import type { AnyClientTool } from '../tools/tool-definition'
 
 /**
  * Context the library passes into {@link defineAgent} `run`.
+ * `TInput` is the agent's `inputSchema`.
  */
-export interface SubagentRunContext {
+export interface SubagentRunContext<
+  TInput extends SchemaInput | undefined = any,
+> {
+  /**
+   * The input the parent model wrote for this child, checked against
+   * `inputSchema`. `undefined` when the agent has no `inputSchema`.
+   */
+  input: TInput extends SchemaInput ? InferSchemaType<TInput> : undefined
   messages: Array<UIMessage | ModelMessage>
   abortSignal?: AbortSignal
   threadId: string
@@ -53,13 +62,20 @@ export interface DefinedAgent<
   TSchema extends SchemaInput | undefined = SchemaInput | undefined,
   TInterrupts extends ReadonlyArray<InterruptDefinition<any, any, any, any>> =
     ReadonlyArray<InterruptDefinition<any, any, any, any>>,
+  TInput extends SchemaInput | undefined = any,
 > extends AGUISubagentInfo {
   name: TName
   /** Required here: the router and the synthetic tool both read it. */
   description: string
   run: (
-    ctx: SubagentRunContext,
+    ctx: SubagentRunContext<TInput>,
   ) => AsyncIterable<StreamChunk> | Promise<AsyncIterable<StreamChunk>>
+  /**
+   * The input the parent model writes when it calls this agent's tool, such
+   * as a short brief. `run` reads it as `ctx.input`. Tool mode only: a
+   * `subagents.router` cannot start an agent that has `inputSchema`.
+   */
+  inputSchema?: TInput
   tools?: TTools
   interrupts?: TInterrupts
   outputSchema?: TSchema
@@ -104,7 +120,8 @@ export function defineAgent<
   const TInterrupts extends ReadonlyArray<
     InterruptDefinition<any, any, any, any>
   > = readonly [],
->(agent: DefinedAgent<TName, TTools, TSchema, TInterrupts>) {
+  TInput extends SchemaInput | undefined = undefined,
+>(agent: DefinedAgent<TName, TTools, TSchema, TInterrupts, TInput>) {
   if (agent.name.trim() === '') {
     throw new Error('defineAgent requires a non-empty name')
   }

package/src/activities/chat/agents/spawn.ts

@@ -93,6 +93,8 @@ export function createSubagentSink(): SubagentSink {
 /** One child to start, or a suspended child to continue. */
 export interface SpawnEntry {
   name: string
+  /** The checked tool input for an agent with `inputSchema`. */
+  input?: unknown
   resume?: {
     subagentRunId: string
     /** The child's own messages from the interrupted run. */
@@ -248,6 +250,7 @@ function openAgentStream(
   return spawnAgentStream(
     agent,
     {
+      input: entry.input,
       messages: resumed?.messages ?? ctx.messages,
       ...(ctx.abortSignal ? { abortSignal: ctx.abortSignal } : {}),
       threadId: childThreadId(bag.sandbox, ctx.threadId, entry.name),
@@ -721,8 +724,10 @@ export function createSyntheticSubagentTools(
   return bag.agents.map((agent) => ({
     name: agent.name,
     description: agent.description,
+    ...(agent.inputSchema !== undefined && { inputSchema: agent.inputSchema }),
     [SUBAGENT_TOOL]: true,
-    execute: async (_input: unknown, context?: unknown) => {
+    // The tool loop checks `input` against `inputSchema` before this runs.
+    execute: async (input: unknown, context?: unknown) => {
       const toolContext = context as
         | {
             toolCallId?: string
@@ -736,17 +741,20 @@ export function createSyntheticSubagentTools(
           child.parentToolCallId !== undefined &&
           child.parentToolCallId === toolCallId,
       )
-      const entry: SpawnEntry = suspended
-        ? {
-            name: agent.name,
-            resume: {
-              subagentRunId: suspended.subagentRunId,
-              messages: suspended.messages,
-              entries: suspended.resume,
-              text: suspended.text,
-            },
-          }
-        : { name: agent.name }
+      // An agent without `inputSchema` still gets `{}` from the model. Its
+      // `ctx.input` stays undefined.
+      const entry: SpawnEntry = {
+        name: agent.name,
+        ...(agent.inputSchema !== undefined && { input }),
+        ...(suspended && {
+          resume: {
+            subagentRunId: suspended.subagentRunId,
+            messages: suspended.messages,
+            entries: suspended.resume,
+            text: suspended.text,
+          },
+        }),
+      }
       const sink = createSubagentSink()
       const link = linkAbort(parent.abortSignal)
       let subagentRunId = suspended?.subagentRunId ?? ''