@tanstack/ai 0.42.0 → 0.43.0

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

@@ -1,107 +1,93 @@
+//#region src/utilities/ag-ui-wire.ts
+/**
+* Serialize TanStack `UIMessage`s into the AG-UI `RunAgentInput.messages`
+* wire shape. Each anchor (system/user/assistant) carries the canonical
+* `parts` array verbatim plus AG-UI mirror fields (`content`, `toolCalls`)
+* so AG-UI Zod parsing succeeds. Tool results and thinking parts on
+* assistant messages are additionally emitted as fan-out
+* `{role:'tool',...}` and `{role:'reasoning',...}` entries for strict
+* AG-UI server consumers.
+*/
 function uiMessagesToWire(messages) {
-  const wire = [];
-  for (const msg of messages) {
-    const parts = (
-      // eslint-disable-next-line @typescript-eslint/no-unnecessary-type-assertion -- runtime input may be ModelMessage-shaped (no `parts`); cast forces the optional-chain fallback below to remain in scope
-      msg.parts ?? []
-    );
-    if (msg.role === "system") {
-      wire.push({
-        ...msg,
-        content: parts.length > 0 ? collectText(parts) : msg.content ?? ""
-      });
-      continue;
-    }
-    if (msg.role === "user") {
-      wire.push({
-        ...msg,
-        content: parts.length > 0 ? collectUserContent(parts) : msg.content ?? ""
-      });
-      continue;
-    }
-    for (const part of parts) {
-      if (part.type === "thinking") {
-        wire.push({
-          role: "reasoning",
-          id: deriveReasoningId(msg.id, part),
-          content: part.content
-        });
-      }
-    }
-    const text = collectText(parts);
-    const toolCalls = collectToolCalls(parts);
-    wire.push({
-      ...msg,
-      ...text !== "" && { content: text },
-      ...toolCalls && { toolCalls }
-    });
-    for (const part of parts) {
-      if (part.type === "tool-result") {
-        wire.push({
-          role: "tool",
-          id: deriveToolMessageId(part.toolCallId),
-          toolCallId: part.toolCallId,
-          content: typeof part.content === "string" ? part.content : JSON.stringify(part.content),
-          ...part.error !== void 0 && { error: part.error }
-        });
-      }
-    }
-  }
-  return wire;
+	const wire = [];
+	for (const msg of messages) {
+		const parts = msg.parts ?? [];
+		if (msg.role === "system") {
+			wire.push({
+				...msg,
+				content: parts.length > 0 ? collectText(parts) : msg.content ?? ""
+			});
+			continue;
+		}
+		if (msg.role === "user") {
+			wire.push({
+				...msg,
+				content: parts.length > 0 ? collectUserContent(parts) : msg.content ?? ""
+			});
+			continue;
+		}
+		for (const part of parts) if (part.type === "thinking") wire.push({
+			role: "reasoning",
+			id: deriveReasoningId(msg.id, part),
+			content: part.content
+		});
+		const text = collectText(parts);
+		const toolCalls = collectToolCalls(parts);
+		wire.push({
+			...msg,
+			...text !== "" && { content: text },
+			...toolCalls && { toolCalls }
+		});
+		for (const part of parts) if (part.type === "tool-result") wire.push({
+			role: "tool",
+			id: deriveToolMessageId(part.toolCallId),
+			toolCallId: part.toolCallId,
+			content: typeof part.content === "string" ? part.content : JSON.stringify(part.content),
+			...part.error !== void 0 && { error: part.error }
+		});
+	}
+	return wire;
 }
 function collectText(parts) {
-  const out = [];
-  for (const p of parts) {
-    if (p.type === "text") {
-      out.push(p.content);
-    } else if (p.type === "structured-output" && p.status === "complete" && p.raw !== "") {
-      out.push(p.raw);
-    }
-  }
-  return out.join("");
+	const out = [];
+	for (const p of parts) if (p.type === "text") out.push(p.content);
+	else if (p.type === "structured-output" && p.status === "complete" && p.raw !== "") out.push(p.raw);
+	return out.join("");
 }
 function collectUserContent(parts) {
-  const hasMultimodal = parts.some(
-    (p) => p.type === "image" || p.type === "audio" || p.type === "video" || p.type === "document"
-  );
-  if (!hasMultimodal) {
-    return collectText(parts);
-  }
-  const out = [];
-  for (const p of parts) {
-    if (p.type === "text") {
-      out.push({ type: "text", text: p.content });
-    } else if (p.type === "image" || p.type === "audio" || p.type === "video" || p.type === "document") {
-      out.push(p);
-    }
-  }
-  return out;
+	if (!parts.some((p) => p.type === "image" || p.type === "audio" || p.type === "video" || p.type === "document")) return collectText(parts);
+	const out = [];
+	for (const p of parts) if (p.type === "text") out.push({
+		type: "text",
+		text: p.content
+	});
+	else if (p.type === "image" || p.type === "audio" || p.type === "video" || p.type === "document") out.push(p);
+	return out;
 }
 function collectToolCalls(parts) {
-  const calls = [];
-  for (const p of parts) {
-    if (p.type === "tool-call") {
-      calls.push({
-        id: p.id,
-        type: "function",
-        function: { name: p.name, arguments: p.arguments }
-      });
-    }
-  }
-  return calls.length > 0 ? calls : void 0;
+	const calls = [];
+	for (const p of parts) if (p.type === "tool-call") calls.push({
+		id: p.id,
+		type: "function",
+		function: {
+			name: p.name,
+			arguments: p.arguments
+		}
+	});
+	return calls.length > 0 ? calls : void 0;
 }
 function deriveReasoningId(messageId, part) {
-  return `${messageId}-reasoning-${part.id ?? hashContent(part.content)}`;
+	return `${messageId}-reasoning-${part.id ?? hashContent(part.content)}`;
 }
 function deriveToolMessageId(toolCallId) {
-  return `tool-${toolCallId}`;
+	return `tool-${toolCallId}`;
 }
 function hashContent(s) {
-  let h = 0;
-  for (let i = 0; i < s.length; i++) h = h * 31 + s.charCodeAt(i) | 0;
-  return Math.abs(h).toString(36);
+	let h = 0;
+	for (let i = 0; i < s.length; i++) h = h * 31 + s.charCodeAt(i) | 0;
+	return Math.abs(h).toString(36);
 }
-export {
-  uiMessagesToWire
-};
-//# sourceMappingURL=ag-ui-wire.js.map
+//#endregion
+export { uiMessagesToWire };
+
+//# sourceMappingURL=ag-ui-wire.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"ag-ui-wire.js","sources":["../../../src/utilities/ag-ui-wire.ts"],"sourcesContent":["import type { ContentPart, MessagePart, UIMessage } from '../types'\n\ntype AGUITextInputContent = { type: 'text'; text: string }\ntype AGUIInputContent =\n  | AGUITextInputContent\n  | (ContentPart & { type: 'image' | 'audio' | 'video' | 'document' })\n\ntype AGUIToolCallMirror = {\n  id: string\n  type: 'function'\n  function: { name: string; arguments: string }\n}\n\ntype AGUIToolMessage = {\n  role: 'tool'\n  id: string\n  toolCallId: string\n  content: string\n  error?: string\n}\n\ntype AGUIReasoningMessage = {\n  role: 'reasoning'\n  id: string\n  content: string\n}\n\ntype WireAnchorMessage = UIMessage & {\n  content?: string | Array<AGUIInputContent>\n  toolCalls?: Array<AGUIToolCallMirror>\n}\n\nexport type WireMessage =\n  | WireAnchorMessage\n  | AGUIToolMessage\n  | AGUIReasoningMessage\n\n/**\n * Serialize TanStack `UIMessage`s into the AG-UI `RunAgentInput.messages`\n * wire shape. Each anchor (system/user/assistant) carries the canonical\n * `parts` array verbatim plus AG-UI mirror fields (`content`, `toolCalls`)\n * so AG-UI Zod parsing succeeds. Tool results and thinking parts on\n * assistant messages are additionally emitted as fan-out\n * `{role:'tool',...}` and `{role:'reasoning',...}` entries for strict\n * AG-UI server consumers.\n */\nexport function uiMessagesToWire(\n  messages: Array<UIMessage>,\n): Array<WireMessage> {\n  const wire: Array<WireMessage> = []\n\n  for (const msg of messages) {\n    // Defensive: if parts is missing (ModelMessage-shaped input), pass through as-is.\n    // UIMessage always has parts; ModelMessage uses content directly.\n    const parts: ReadonlyArray<MessagePart> =\n      // eslint-disable-next-line @typescript-eslint/no-unnecessary-type-assertion -- runtime input may be ModelMessage-shaped (no `parts`); cast forces the optional-chain fallback below to remain in scope\n      (msg.parts as ReadonlyArray<MessagePart> | undefined) ?? []\n\n    if (msg.role === 'system') {\n      wire.push({\n        ...msg,\n        content:\n          parts.length > 0\n            ? collectText(parts)\n            : ((msg as { content?: string }).content ?? ''),\n      })\n      continue\n    }\n\n    if (msg.role === 'user') {\n      wire.push({\n        ...msg,\n        content:\n          parts.length > 0\n            ? collectUserContent(parts)\n            : ((msg as { content?: string }).content ?? ''),\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        wire.push({\n          role: 'reasoning',\n          id: deriveReasoningId(msg.id, part),\n          content: part.content,\n        })\n      }\n    }\n\n    const text = collectText(parts)\n    const toolCalls = collectToolCalls(parts)\n    wire.push({\n      ...msg,\n      ...(text !== '' && { content: text }),\n      ...(toolCalls && { toolCalls }),\n    })\n\n    for (const part of parts) {\n      if (part.type === 'tool-result') {\n        wire.push({\n          role: 'tool',\n          id: deriveToolMessageId(part.toolCallId),\n          toolCallId: part.toolCallId,\n          content:\n            typeof part.content === 'string'\n              ? part.content\n              : JSON.stringify(part.content),\n          ...(part.error !== undefined && { error: part.error }),\n        })\n      }\n    }\n  }\n\n  return wire\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\nfunction collectUserContent(\n  parts: ReadonlyArray<MessagePart>,\n): string | Array<AGUIInputContent> {\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<AGUIInputContent> = []\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 collectToolCalls(\n  parts: ReadonlyArray<MessagePart>,\n): Array<AGUIToolCallMirror> | undefined {\n  const calls: Array<AGUIToolCallMirror> = []\n  for (const p of parts) {\n    if (p.type === 'tool-call') {\n      calls.push({\n        id: p.id,\n        type: 'function',\n        function: { name: p.name, arguments: p.arguments },\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 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"],"names":[],"mappings":"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"}
+{"version":3,"file":"ag-ui-wire.js","names":[],"sources":["../../../src/utilities/ag-ui-wire.ts"],"sourcesContent":["import type { ContentPart, MessagePart, UIMessage } from '../types'\n\ntype AGUITextInputContent = { type: 'text'; text: string }\ntype AGUIInputContent =\n  | AGUITextInputContent\n  | (ContentPart & { type: 'image' | 'audio' | 'video' | 'document' })\n\ntype AGUIToolCallMirror = {\n  id: string\n  type: 'function'\n  function: { name: string; arguments: string }\n}\n\ntype AGUIToolMessage = {\n  role: 'tool'\n  id: string\n  toolCallId: string\n  content: string\n  error?: string\n}\n\ntype AGUIReasoningMessage = {\n  role: 'reasoning'\n  id: string\n  content: string\n}\n\ntype WireAnchorMessage = UIMessage & {\n  content?: string | Array<AGUIInputContent>\n  toolCalls?: Array<AGUIToolCallMirror>\n}\n\nexport type WireMessage =\n  | WireAnchorMessage\n  | AGUIToolMessage\n  | AGUIReasoningMessage\n\n/**\n * Serialize TanStack `UIMessage`s into the AG-UI `RunAgentInput.messages`\n * wire shape. Each anchor (system/user/assistant) carries the canonical\n * `parts` array verbatim plus AG-UI mirror fields (`content`, `toolCalls`)\n * so AG-UI Zod parsing succeeds. Tool results and thinking parts on\n * assistant messages are additionally emitted as fan-out\n * `{role:'tool',...}` and `{role:'reasoning',...}` entries for strict\n * AG-UI server consumers.\n */\nexport function uiMessagesToWire(\n  messages: Array<UIMessage>,\n): Array<WireMessage> {\n  const wire: Array<WireMessage> = []\n\n  for (const msg of messages) {\n    // Defensive: if parts is missing (ModelMessage-shaped input), pass through as-is.\n    // UIMessage always has parts; ModelMessage uses content directly.\n    const parts: ReadonlyArray<MessagePart> =\n      // eslint-disable-next-line @typescript-eslint/no-unnecessary-type-assertion -- runtime input may be ModelMessage-shaped (no `parts`); cast forces the optional-chain fallback below to remain in scope\n      (msg.parts as ReadonlyArray<MessagePart> | undefined) ?? []\n\n    if (msg.role === 'system') {\n      wire.push({\n        ...msg,\n        content:\n          parts.length > 0\n            ? collectText(parts)\n            : ((msg as { content?: string }).content ?? ''),\n      })\n      continue\n    }\n\n    if (msg.role === 'user') {\n      wire.push({\n        ...msg,\n        content:\n          parts.length > 0\n            ? collectUserContent(parts)\n            : ((msg as { content?: string }).content ?? ''),\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        wire.push({\n          role: 'reasoning',\n          id: deriveReasoningId(msg.id, part),\n          content: part.content,\n        })\n      }\n    }\n\n    const text = collectText(parts)\n    const toolCalls = collectToolCalls(parts)\n    wire.push({\n      ...msg,\n      ...(text !== '' && { content: text }),\n      ...(toolCalls && { toolCalls }),\n    })\n\n    for (const part of parts) {\n      if (part.type === 'tool-result') {\n        wire.push({\n          role: 'tool',\n          id: deriveToolMessageId(part.toolCallId),\n          toolCallId: part.toolCallId,\n          content:\n            typeof part.content === 'string'\n              ? part.content\n              : JSON.stringify(part.content),\n          ...(part.error !== undefined && { error: part.error }),\n        })\n      }\n    }\n  }\n\n  return wire\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\nfunction collectUserContent(\n  parts: ReadonlyArray<MessagePart>,\n): string | Array<AGUIInputContent> {\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<AGUIInputContent> = []\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 collectToolCalls(\n  parts: ReadonlyArray<MessagePart>,\n): Array<AGUIToolCallMirror> | undefined {\n  const calls: Array<AGUIToolCallMirror> = []\n  for (const p of parts) {\n    if (p.type === 'tool-call') {\n      calls.push({\n        id: p.id,\n        type: 'function',\n        function: { name: p.name, arguments: p.arguments },\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 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":";;;;;;;;;;AA8CA,SAAgB,iBACd,UACoB;CACpB,MAAM,OAA2B,CAAC;CAElC,KAAK,MAAM,OAAO,UAAU;EAG1B,MAAM,QAEH,IAAI,SAAoD,CAAC;EAE5D,IAAI,IAAI,SAAS,UAAU;GACzB,KAAK,KAAK;IACR,GAAG;IACH,SACE,MAAM,SAAS,IACX,YAAY,KAAK,IACf,IAA6B,WAAW;GAClD,CAAC;GACD;EACF;EAEA,IAAI,IAAI,SAAS,QAAQ;GACvB,KAAK,KAAK;IACR,GAAG;IACH,SACE,MAAM,SAAS,IACX,mBAAmB,KAAK,IACtB,IAA6B,WAAW;GAClD,CAAC;GACD;EACF;EAGA,KAAK,MAAM,QAAQ,OACjB,IAAI,KAAK,SAAS,YAChB,KAAK,KAAK;GACR,MAAM;GACN,IAAI,kBAAkB,IAAI,IAAI,IAAI;GAClC,SAAS,KAAK;EAChB,CAAC;EAIL,MAAM,OAAO,YAAY,KAAK;EAC9B,MAAM,YAAY,iBAAiB,KAAK;EACxC,KAAK,KAAK;GACR,GAAG;GACH,GAAI,SAAS,MAAM,EAAE,SAAS,KAAK;GACnC,GAAI,aAAa,EAAE,UAAU;EAC/B,CAAC;EAED,KAAK,MAAM,QAAQ,OACjB,IAAI,KAAK,SAAS,eAChB,KAAK,KAAK;GACR,MAAM;GACN,IAAI,oBAAoB,KAAK,UAAU;GACvC,YAAY,KAAK;GACjB,SACE,OAAO,KAAK,YAAY,WACpB,KAAK,UACL,KAAK,UAAU,KAAK,OAAO;GACjC,GAAI,KAAK,UAAU,KAAA,KAAa,EAAE,OAAO,KAAK,MAAM;EACtD,CAAC;CAGP;CAEA,OAAO;AACT;AAEA,SAAS,YAAY,OAA2C;CAW9D,MAAM,MAAqB,CAAC;CAC5B,KAAK,MAAM,KAAK,OACd,IAAI,EAAE,SAAS,QACb,IAAI,KAAK,EAAE,OAAO;MACb,IACL,EAAE,SAAS,uBACX,EAAE,WAAW,cACb,EAAE,QAAQ,IAEV,IAAI,KAAK,EAAE,GAAG;CAGlB,OAAO,IAAI,KAAK,EAAE;AACpB;AAEA,SAAS,mBACP,OACkC;CAQlC,IAAI,CAPkB,MAAM,MACzB,MACC,EAAE,SAAS,WACX,EAAE,SAAS,WACX,EAAE,SAAS,WACX,EAAE,SAAS,UAEV,GACH,OAAO,YAAY,KAAK;CAE1B,MAAM,MAA+B,CAAC;CACtC,KAAK,MAAM,KAAK,OACd,IAAI,EAAE,SAAS,QACb,IAAI,KAAK;EAAE,MAAM;EAAQ,MAAM,EAAE;CAAQ,CAAC;MACrC,IACL,EAAE,SAAS,WACX,EAAE,SAAS,WACX,EAAE,SAAS,WACX,EAAE,SAAS,YAEX,IAAI,KAAK,CAAC;CAGd,OAAO;AACT;AAEA,SAAS,iBACP,OACuC;CACvC,MAAM,QAAmC,CAAC;CAC1C,KAAK,MAAM,KAAK,OACd,IAAI,EAAE,SAAS,aACb,MAAM,KAAK;EACT,IAAI,EAAE;EACN,MAAM;EACN,UAAU;GAAE,MAAM,EAAE;GAAM,WAAW,EAAE;EAAU;CACnD,CAAC;CAGL,OAAO,MAAM,SAAS,IAAI,QAAQ,KAAA;AACpC;AAEA,SAAS,kBAAkB,WAAmB,MAA2B;CACvE,OAAO,GAAG,UAAU,aAAc,KAAyB,MAAM,YAAa,KAA6B,OAAO;AACpH;AAEA,SAAS,oBAAoB,YAA4B;CACvD,OAAO,QAAQ;AACjB;AAEA,SAAS,YAAY,GAAmB;CAItC,IAAI,IAAI;CACR,KAAK,IAAI,IAAI,GAAG,IAAI,EAAE,QAAQ,KAAK,IAAK,IAAI,KAAK,EAAE,WAAW,CAAC,IAAK;CACpE,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,SAAS,EAAE;AAChC"}

package/dist/esm/utilities/chat-params.d.ts

@@ -1,5 +1,5 @@
 import { Context as AGUIContext } from '@ag-ui/core';
-import { JSONSchema, ModelMessage, SchemaInput, Tool, UIMessage } from '../types.js';
+import { AnyTool, JSONSchema, ModelMessage, RunAgentResumeItem, UIMessage } from '../types.js';
 /**
  * Parse and validate an HTTP request body as an AG-UI `RunAgentInput`.
  *
@@ -8,8 +8,11 @@ import { JSONSchema, ModelMessage, SchemaInput, Tool, UIMessage } from '../types
  * `convertMessagesToModelMessages` handles AG-UI fan-out dedup and
  * reasoning/activity/developer-role normalization internally.
  *
+ * Validated structurally against the AG-UI `RunAgentInput` contract without a
+ * schema library, so this package pulls in no validation runtime of its own.
+ *
  * @throws An error with a migration-pointing message when the body does
- *   not conform to AG-UI 0.0.52 `RunAgentInputSchema`. Surface this as a
+ *   not conform to AG-UI `RunAgentInput`. Surface this as a
  *   400 Bad Request to the client.
  */
 export declare function chatParamsFromRequestBody(body: unknown): Promise<{
@@ -24,6 +27,7 @@ export declare function chatParamsFromRequestBody(body: unknown): Promise<{
     }>;
     forwardedProps: Record<string, unknown>;
     state: unknown;
+    resume?: Array<RunAgentResumeItem>;
     /**
      * @deprecated Use `aguiContext` instead. This alias will be removed in a
      * future release.
@@ -57,6 +61,17 @@ export declare function chatParamsFromRequestBody(body: unknown): Promise<{
  * @throws {Response} 400 on malformed JSON or invalid AG-UI shape.
  */
 export declare function chatParamsFromRequest(req: Request): Promise<Awaited<ReturnType<typeof chatParamsFromRequestBody>>>;
+/**
+ * Client-declared tool stub (no execute). `name` is `string`, so arrays that
+ * include these stubs intentionally widen `TypedStreamChunk` tool-name
+ * discrimination — pass server tools alone when you need a closed name union.
+ */
+export type ClientToolDeclaration = {
+    name: string;
+    description: string;
+    inputSchema: JSONSchema;
+};
+export type MergedAgentTools<TServerTools extends ReadonlyArray<AnyTool>> = ReadonlyArray<TServerTools[number] | ClientToolDeclaration>;
 /**
  * Merge a server-side tool array with the AG-UI client-declared tools
  * received in the request body.
@@ -72,14 +87,21 @@ export declare function chatParamsFromRequest(req: Request): Promise<Awaited<Ret
  *   them — server emits a tool-call request, client executes via its
  *   registered handler, client posts back the result.
  *
+ * Typing:
+ * - Empty `clientTools` preserves the server tuple (closed name union).
+ * - Non-empty `clientTools` returns a widened array that honestly includes
+ *   client stubs, so `TypedStreamChunk` does not claim a closed server-only
+ *   name union.
+ *
  * @param serverTools - The server's tool array (e.g. from
  *   `[myToolDef.server(...)]`). Pass directly to `chat({ tools })`.
  * @param clientTools - The `tools` array received from
  *   `chatParamsFromRequest(...)` / `chatParamsFromRequestBody(...)`.
  * @returns A merged array suitable for `chat({ tools })`.
  */
-export declare function mergeAgentTools<TContext = unknown>(serverTools: ReadonlyArray<Tool<SchemaInput, SchemaInput, string, TContext>>, clientTools: ReadonlyArray<{
+export declare function mergeAgentTools<const TServerTools extends ReadonlyArray<AnyTool>>(serverTools: TServerTools, clientTools: readonly []): TServerTools;
+export declare function mergeAgentTools<const TServerTools extends ReadonlyArray<AnyTool>>(serverTools: TServerTools, clientTools: ReadonlyArray<{
     name: string;
     description: string;
     parameters: JSONSchema;
-}>): Array<Tool<SchemaInput, SchemaInput, string, TContext>>;
+}>): MergedAgentTools<TServerTools>;

package/dist/esm/utilities/chat-params.js

@@ -1,100 +1,226 @@
-import { RunAgentInputSchema, AGUIError } from "@ag-ui/core";
-const KNOWN_PART_TYPES = /* @__PURE__ */ new Set([
-  "text",
-  "image",
-  "audio",
-  "video",
-  "document",
-  "tool-call",
-  "tool-result",
-  "thinking"
+import { AGUIError } from "@ag-ui/core";
+//#region src/utilities/chat-params.ts
+var KNOWN_PART_TYPES = /* @__PURE__ */ new Set([
+	"text",
+	"image",
+	"audio",
+	"video",
+	"document",
+	"tool-call",
+	"tool-result",
+	"thinking"
 ]);
 function isValidParts(value) {
-  if (!Array.isArray(value)) return false;
-  for (const p of value) {
-    if (!p || typeof p !== "object") return false;
-    const type = p.type;
-    if (typeof type !== "string" || !KNOWN_PART_TYPES.has(type)) return false;
-  }
-  return true;
+	if (!Array.isArray(value)) return false;
+	for (const p of value) {
+		if (!p || typeof p !== "object") return false;
+		const type = p.type;
+		if (typeof type !== "string" || !KNOWN_PART_TYPES.has(type)) return false;
+	}
+	return true;
 }
-function chatParamsFromRequestBody(body) {
-  const parseResult = RunAgentInputSchema.safeParse(body);
-  if (!parseResult.success) {
-    return Promise.reject(
-      new AGUIError(
-        `Request body is not a valid AG-UI RunAgentInput. If you're upgrading from a previous @tanstack/ai-client release, see docs/migration/ag-ui-compliance.md. Validation errors: ${parseResult.error.message}`
-      )
-    );
-  }
-  const parsed = parseResult.data;
-  const aguiContext = parsed.context;
-  const rawMessages = body.messages ?? [];
-  const messages = parsed.messages.map((m, i) => {
-    const raw = rawMessages[i];
-    if (raw && typeof raw === "object" && "parts" in raw && isValidParts(raw.parts)) {
-      return { ...m, parts: raw.parts };
-    }
-    return m;
-  });
-  return Promise.resolve({
-    messages,
-    threadId: parsed.threadId,
-    runId: parsed.runId,
-    parentRunId: parsed.parentRunId,
-    tools: parsed.tools,
-    forwardedProps: parsed.forwardedProps ?? {},
-    state: parsed.state,
-    context: aguiContext,
-    aguiContext
-  });
+/**
+* Keyed by `AGUIRole` so a role added upstream fails to compile here until it
+* is handled, rather than silently falling through as an unknown role.
+*/
+var AGUI_ROLES = {
+	developer: true,
+	system: true,
+	assistant: true,
+	user: true,
+	tool: true,
+	activity: true,
+	reasoning: true
+};
+function isAGUIRole(value) {
+	return typeof value === "string" && value in AGUI_ROLES;
+}
+function isRecord(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+/**
+* Reject the request body, pointing at the migration guide. Mirrors the
+* message the previous `RunAgentInputSchema.safeParse` failure produced.
+*/
+function invalidBody(reason) {
+	throw new AGUIError(`Request body is not a valid AG-UI RunAgentInput. If you're upgrading from a previous @tanstack/ai-client release, see docs/migration/ag-ui-compliance.md. Validation errors: ${reason}`);
+}
+function requireString(value, at) {
+	if (typeof value !== "string") invalidBody(`${at} must be a string`);
+	return value;
+}
+function requireArray(value, at) {
+	if (!Array.isArray(value)) invalidBody(`${at} must be an array`);
+	return value;
+}
+/**
+* Assert one AG-UI `Message`, discriminating on `role` exactly as the upstream
+* `MessageSchema` discriminated union does. The record view is retained on the
+* asserted type so callers can still inspect non-AG-UI extras like `parts`.
+*/
+function assertAGUIMessage(value, at) {
+	requireString(value.id, `${at}.id`);
+	const role = value.role;
+	if (!isAGUIRole(role)) invalidBody(`${at}.role must be one of ${Object.keys(AGUI_ROLES).join(" | ")}`);
+	switch (role) {
+		case "assistant":
+			if (value.content !== void 0) requireString(value.content, `${at}.content`);
+			if (value.toolCalls !== void 0) requireArray(value.toolCalls, `${at}.toolCalls`);
+			break;
+		case "user":
+			if (typeof value.content !== "string" && !Array.isArray(value.content)) invalidBody(`${at}.content must be a string or an array of content parts`);
+			break;
+		case "tool":
+			requireString(value.content, `${at}.content`);
+			requireString(value.toolCallId, `${at}.toolCallId`);
+			break;
+		case "activity":
+			requireString(value.activityType, `${at}.activityType`);
+			if (!isRecord(value.content)) invalidBody(`${at}.content must be an object`);
+			break;
+		case "developer":
+		case "system":
+		case "reasoning":
+			requireString(value.content, `${at}.content`);
+			break;
+	}
 }
+function validateMessage(value, index) {
+	const at = `messages[${index}]`;
+	if (!isRecord(value)) invalidBody(`${at} must be an object`);
+	assertAGUIMessage(value, at);
+	if ("parts" in value && !isValidParts(value.parts)) {
+		const withoutParts = { ...value };
+		Reflect.deleteProperty(withoutParts, "parts");
+		return withoutParts;
+	}
+	return value;
+}
+function validateTool(value, index) {
+	const at = `tools[${index}]`;
+	if (!isRecord(value)) invalidBody(`${at} must be an object`);
+	return {
+		name: requireString(value.name, `${at}.name`),
+		description: requireString(value.description, `${at}.description`),
+		parameters: value.parameters
+	};
+}
+function validateContext(value, index) {
+	const at = `context[${index}]`;
+	if (!isRecord(value)) invalidBody(`${at} must be an object`);
+	return {
+		description: requireString(value.description, `${at}.description`),
+		value: requireString(value.value, `${at}.value`)
+	};
+}
+function validateResumeEntry(value, index) {
+	const at = `resume[${index}]`;
+	if (!isRecord(value)) invalidBody(`${at} must be an object`);
+	const status = value.status;
+	if (status !== "resolved" && status !== "cancelled") invalidBody(`${at}.status must be "resolved" or "cancelled"`);
+	const entry = {
+		interruptId: requireString(value.interruptId, `${at}.interruptId`),
+		status
+	};
+	if (value.payload !== void 0) entry.payload = value.payload;
+	return entry;
+}
+/**
+* Parse and validate an HTTP request body as an AG-UI `RunAgentInput`.
+*
+* Returns a spread-friendly object whose `messages` field is suitable for
+* passing directly to `chat({ messages })`. The existing
+* `convertMessagesToModelMessages` handles AG-UI fan-out dedup and
+* reasoning/activity/developer-role normalization internally.
+*
+* Validated structurally against the AG-UI `RunAgentInput` contract without a
+* schema library, so this package pulls in no validation runtime of its own.
+*
+* @throws An error with a migration-pointing message when the body does
+*   not conform to AG-UI `RunAgentInput`. Surface this as a
+*   400 Bad Request to the client.
+*/
+async function chatParamsFromRequestBody(body) {
+	if (!isRecord(body)) invalidBody("body must be a JSON object");
+	const threadId = requireString(body.threadId, "threadId");
+	const runId = requireString(body.runId, "runId");
+	const parentRunId = body.parentRunId === void 0 ? void 0 : requireString(body.parentRunId, "parentRunId");
+	const messages = requireArray(body.messages, "messages").map(validateMessage);
+	const tools = requireArray(body.tools, "tools").map(validateTool);
+	const aguiContext = requireArray(body.context, "context").map(validateContext);
+	const resume = body.resume === void 0 ? void 0 : requireArray(body.resume, "resume").map(validateResumeEntry);
+	if (body.forwardedProps !== void 0 && !isRecord(body.forwardedProps)) invalidBody("forwardedProps must be an object");
+	return {
+		messages,
+		threadId,
+		runId,
+		parentRunId,
+		tools,
+		forwardedProps: body.forwardedProps ?? {},
+		state: body.state,
+		resume,
+		context: aguiContext,
+		aguiContext
+	};
+}
+/**
+* Read an HTTP `Request`, parse its JSON body, and validate it as an
+* AG-UI `RunAgentInput` — collapsing the standard `req.json()` +
+* `chatParamsFromRequestBody(...)` pair into a single call.
+*
+* On a malformed body or invalid AG-UI shape, this **throws a
+* `Response`** with status 400 and a migration-pointing message in the
+* body. Frameworks that natively handle thrown `Response` objects
+* (TanStack Start, SolidStart, Remix, React Router 7) will return the
+* 400 to the client automatically, so the handler reduces to:
+*
+* ```ts
+* export async function POST(req: Request) {
+*   const params = await chatParamsFromRequest(req)
+*   // ...use params
+* }
+* ```
+*
+* In frameworks that do not auto-handle thrown `Response` objects
+* (Next.js Route Handlers, SvelteKit, Hono, raw Node), wrap the call
+* with try/catch and return the caught Response yourself, or use
+* `chatParamsFromRequestBody` directly with your own JSON-parsing.
+*
+* @throws {Response} 400 on malformed JSON or invalid AG-UI shape.
+*/
 async function chatParamsFromRequest(req) {
-  let body;
-  try {
-    body = await req.json();
-  } catch (cause) {
-    const res = new Response(
-      "Invalid AG-UI request body. See docs/migration/ag-ui-compliance.md.",
-      { status: 400 }
-    );
-    res.cause = cause;
-    throw res;
-  }
-  try {
-    return await chatParamsFromRequestBody(body);
-  } catch (cause) {
-    const res = new Response(
-      "Invalid AG-UI request body. See docs/migration/ag-ui-compliance.md.",
-      { status: 400 }
-    );
-    res.cause = cause;
-    throw res;
-  }
+	let body;
+	try {
+		body = await req.json();
+	} catch (cause) {
+		const res = new Response("Invalid AG-UI request body. See docs/migration/ag-ui-compliance.md.", { status: 400 });
+		res.cause = cause;
+		throw res;
+	}
+	try {
+		return await chatParamsFromRequestBody(body);
+	} catch (cause) {
+		const res = new Response("Invalid AG-UI request body. See docs/migration/ag-ui-compliance.md.", { status: 400 });
+		res.cause = cause;
+		throw res;
+	}
 }
 function mergeAgentTools(serverTools, clientTools) {
-  const seen = new Set(serverTools.map((t) => t.name));
-  const merged = [
-    ...serverTools
-  ];
-  for (const ct of clientTools) {
-    if (seen.has(ct.name)) {
-      continue;
-    }
-    seen.add(ct.name);
-    merged.push({
-      name: ct.name,
-      description: ct.description,
-      inputSchema: ct.parameters
-      // No `execute` — runtime treats this as a client-side tool and
-      // emits ClientToolRequest events.
-    });
-  }
-  return merged;
+	if (clientTools.length === 0) return serverTools;
+	const seen = new Set(serverTools.map((t) => t.name));
+	const merged = [...serverTools];
+	for (const ct of clientTools) {
+		if (seen.has(ct.name)) continue;
+		seen.add(ct.name);
+		merged.push({
+			name: ct.name,
+			description: ct.description,
+			inputSchema: ct.parameters
+		});
+	}
+	return merged;
 }
-export {
-  chatParamsFromRequest,
-  chatParamsFromRequestBody,
-  mergeAgentTools
-};
-//# sourceMappingURL=chat-params.js.map
+//#endregion
+export { chatParamsFromRequest, chatParamsFromRequestBody, mergeAgentTools };
+
+//# sourceMappingURL=chat-params.js.map