@tanstack/ai 0.35.0 → 0.36.0

package/dist/esm/stream-to-response.js

@@ -1,121 +0,0 @@
-import { toRunErrorPayload } from "./activities/error-payload.js";
-async function streamToText(stream) {
-  let accumulatedContent = "";
-  for await (const chunk of stream) {
-    if (chunk.type === "TEXT_MESSAGE_CONTENT" && chunk.delta) {
-      accumulatedContent += chunk.delta;
-    }
-  }
-  return accumulatedContent;
-}
-function toServerSentEventsStream(stream, abortController) {
-  const encoder = new TextEncoder();
-  return new ReadableStream({
-    async start(controller) {
-      try {
-        for await (const chunk of stream) {
-          if (abortController?.signal.aborted) {
-            break;
-          }
-          controller.enqueue(
-            encoder.encode(`data: ${JSON.stringify(chunk)}
-
-`)
-          );
-        }
-        controller.close();
-      } catch (error) {
-        if (abortController?.signal.aborted) {
-          controller.close();
-          return;
-        }
-        controller.enqueue(
-          encoder.encode(
-            `data: ${JSON.stringify({
-              type: "RUN_ERROR",
-              timestamp: Date.now(),
-              error: toRunErrorPayload(error)
-            })}
-
-`
-          )
-        );
-        controller.close();
-      }
-    },
-    cancel() {
-      if (abortController) {
-        abortController.abort();
-      }
-    }
-  });
-}
-function toServerSentEventsResponse(stream, init) {
-  const { headers, abortController, ...responseInit } = init ?? {};
-  const mergedHeaders = new Headers({
-    "Content-Type": "text/event-stream",
-    "Cache-Control": "no-cache",
-    Connection: "keep-alive"
-  });
-  if (headers) {
-    const userHeaders = new Headers(headers);
-    userHeaders.forEach((value, key) => {
-      mergedHeaders.set(key, value);
-    });
-  }
-  return new Response(toServerSentEventsStream(stream, abortController), {
-    ...responseInit,
-    headers: mergedHeaders
-  });
-}
-function toHttpStream(stream, abortController) {
-  const encoder = new TextEncoder();
-  return new ReadableStream({
-    async start(controller) {
-      try {
-        for await (const chunk of stream) {
-          if (abortController?.signal.aborted) {
-            break;
-          }
-          controller.enqueue(encoder.encode(`${JSON.stringify(chunk)}
-`));
-        }
-        controller.close();
-      } catch (error) {
-        if (abortController?.signal.aborted) {
-          controller.close();
-          return;
-        }
-        controller.enqueue(
-          encoder.encode(
-            `${JSON.stringify({
-              type: "RUN_ERROR",
-              timestamp: Date.now(),
-              error: toRunErrorPayload(error)
-            })}
-`
-          )
-        );
-        controller.close();
-      }
-    },
-    cancel() {
-      if (abortController) {
-        abortController.abort();
-      }
-    }
-  });
-}
-function toHttpResponse(stream, init) {
-  return new Response(toHttpStream(stream, init?.abortController), {
-    ...init
-  });
-}
-export {
-  streamToText,
-  toHttpResponse,
-  toHttpStream,
-  toServerSentEventsResponse,
-  toServerSentEventsStream
-};
-//# sourceMappingURL=stream-to-response.js.map

package/dist/esm/stream-to-response.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"stream-to-response.js","sources":["../../src/stream-to-response.ts"],"sourcesContent":["import { toRunErrorPayload } from './activities/error-payload'\nimport type { StreamChunk } from './types'\n\n/**\n * Collect all text content from a StreamChunk async iterable and return as a string.\n *\n * This function consumes the entire stream, accumulating content from TEXT_MESSAGE_CONTENT events,\n * and returns the final concatenated text.\n *\n * @param stream - AsyncIterable of StreamChunks from chat()\n * @returns Promise<string> - The accumulated text content\n *\n * @example\n * ```typescript\n * const stream = chat({\n *   adapter: openaiText(),\n *   model: 'gpt-4o',\n *   messages: [{ role: 'user', content: 'Hello!' }]\n * });\n * const text = await streamToText(stream);\n * console.log(text); // \"Hello! How can I help you today?\"\n * ```\n */\nexport async function streamToText(\n  stream: AsyncIterable<StreamChunk>,\n): Promise<string> {\n  let accumulatedContent = ''\n\n  for await (const chunk of stream) {\n    if (chunk.type === 'TEXT_MESSAGE_CONTENT' && chunk.delta) {\n      accumulatedContent += chunk.delta\n    }\n  }\n\n  return accumulatedContent\n}\n\n/**\n * Convert a StreamChunk async iterable to a ReadableStream in Server-Sent Events format\n *\n * This creates a ReadableStream that emits chunks in SSE format:\n * - Each chunk is prefixed with \"data: \"\n * - Each chunk is followed by \"\\n\\n\"\n * - Stream ends when the underlying iterable is exhausted (RUN_FINISHED is the terminal event)\n *\n * @param stream - AsyncIterable of StreamChunks from chat()\n * @param abortController - Optional AbortController to abort when stream is cancelled\n * @returns ReadableStream in Server-Sent Events format\n */\nexport function toServerSentEventsStream(\n  stream: AsyncIterable<StreamChunk>,\n  abortController?: AbortController,\n): ReadableStream<Uint8Array> {\n  const encoder = new TextEncoder()\n\n  return new ReadableStream({\n    async start(controller) {\n      try {\n        for await (const chunk of stream) {\n          // Check if stream was cancelled/aborted\n          if (abortController?.signal.aborted) {\n            break\n          }\n\n          // Send each chunk as Server-Sent Events format\n          controller.enqueue(\n            encoder.encode(`data: ${JSON.stringify(chunk)}\\n\\n`),\n          )\n        }\n\n        controller.close()\n      } catch (error: unknown) {\n        // Don't send error if aborted\n        if (abortController?.signal.aborted) {\n          controller.close()\n          return\n        }\n\n        // Send error event (AG-UI RUN_ERROR)\n        controller.enqueue(\n          encoder.encode(\n            `data: ${JSON.stringify({\n              type: 'RUN_ERROR',\n              timestamp: Date.now(),\n              error: toRunErrorPayload(error),\n            })}\\n\\n`,\n          ),\n        )\n        controller.close()\n      }\n    },\n    cancel() {\n      // When the ReadableStream is cancelled (e.g., client disconnects),\n      // abort the underlying stream\n      if (abortController) {\n        abortController.abort()\n      }\n    },\n  })\n}\n\n/**\n * Convert a StreamChunk async iterable to a Response in Server-Sent Events format\n *\n * This creates a Response that emits chunks in SSE format:\n * - Each chunk is prefixed with \"data: \"\n * - Each chunk is followed by \"\\n\\n\"\n * - Stream ends when the underlying iterable is exhausted (RUN_FINISHED is the terminal event)\n *\n * @param stream - AsyncIterable of StreamChunks from chat()\n * @param init - Optional Response initialization options (including `abortController`)\n * @returns Response in Server-Sent Events format\n *\n * @example\n * ```typescript\n * const stream = chat({ adapter: openaiText(), model: \"gpt-4o\", messages: [...] });\n * return toServerSentEventsResponse(stream, { abortController });\n * ```\n */\nexport function toServerSentEventsResponse(\n  stream: AsyncIterable<StreamChunk>,\n  init?: ResponseInit & { abortController?: AbortController },\n): Response {\n  const { headers, abortController, ...responseInit } = init ?? {}\n\n  // Start with default SSE headers\n  const mergedHeaders = new Headers({\n    'Content-Type': 'text/event-stream',\n    'Cache-Control': 'no-cache',\n    Connection: 'keep-alive',\n  })\n\n  // Override with user headers if provided, handling all HeadersInit forms:\n  // Headers instance, string[][], or plain object\n  if (headers) {\n    const userHeaders = new Headers(headers)\n    userHeaders.forEach((value, key) => {\n      mergedHeaders.set(key, value)\n    })\n  }\n\n  return new Response(toServerSentEventsStream(stream, abortController), {\n    ...responseInit,\n    headers: mergedHeaders,\n  })\n}\n\n/**\n * Convert a StreamChunk async iterable to a ReadableStream in HTTP stream format (newline-delimited JSON)\n *\n * This creates a ReadableStream that emits chunks as newline-delimited JSON:\n * - Each chunk is JSON.stringify'd and followed by \"\\n\"\n * - No SSE formatting (no \"data: \" prefix)\n *\n * This format is compatible with `fetchHttpStream` connection adapter.\n *\n * @param stream - AsyncIterable of StreamChunks from chat()\n * @param abortController - Optional AbortController to abort when stream is cancelled\n * @returns ReadableStream in HTTP stream format (newline-delimited JSON)\n *\n * @example\n * ```typescript\n * const stream = chat({ adapter: openaiText(), model: \"gpt-4o\", messages: [...] });\n * const readableStream = toHttpStream(stream);\n * // Use with Response for HTTP streaming (not SSE)\n * return new Response(readableStream, {\n *   headers: { 'Content-Type': 'application/x-ndjson' }\n * });\n * ```\n */\nexport function toHttpStream(\n  stream: AsyncIterable<StreamChunk>,\n  abortController?: AbortController,\n): ReadableStream<Uint8Array> {\n  const encoder = new TextEncoder()\n\n  return new ReadableStream({\n    async start(controller) {\n      try {\n        for await (const chunk of stream) {\n          // Check if stream was cancelled/aborted\n          if (abortController?.signal.aborted) {\n            break\n          }\n\n          // Send each chunk as newline-delimited JSON\n          controller.enqueue(encoder.encode(`${JSON.stringify(chunk)}\\n`))\n        }\n\n        controller.close()\n      } catch (error: unknown) {\n        // Don't send error if aborted\n        if (abortController?.signal.aborted) {\n          controller.close()\n          return\n        }\n\n        // Send error event (AG-UI RUN_ERROR)\n        controller.enqueue(\n          encoder.encode(\n            `${JSON.stringify({\n              type: 'RUN_ERROR',\n              timestamp: Date.now(),\n              error: toRunErrorPayload(error),\n            })}\\n`,\n          ),\n        )\n        controller.close()\n      }\n    },\n    cancel() {\n      // When the ReadableStream is cancelled (e.g., client disconnects),\n      // abort the underlying stream\n      if (abortController) {\n        abortController.abort()\n      }\n    },\n  })\n}\n\n/**\n * Convert a StreamChunk async iterable to a Response in HTTP stream format (newline-delimited JSON)\n *\n * This creates a Response that emits chunks in HTTP stream format:\n * - Each chunk is JSON.stringify'd and followed by \"\\n\"\n * - No SSE formatting (no \"data: \" prefix)\n *\n * This format is compatible with `fetchHttpStream` connection adapter.\n *\n * @param stream - AsyncIterable of StreamChunks from chat()\n * @param init - Optional Response initialization options (including `abortController`)\n * @returns Response in HTTP stream format (newline-delimited JSON)\n *\n * @example\n * ```typescript\n * const stream = chat({ adapter: openaiText(), model: \"gpt-4o\", messages: [...] });\n * return toHttpResponse(stream, { abortController });\n * ```\n */\nexport function toHttpResponse(\n  stream: AsyncIterable<StreamChunk>,\n  init?: ResponseInit & { abortController?: AbortController },\n): Response {\n  return new Response(toHttpStream(stream, init?.abortController), {\n    ...init,\n  })\n}\n"],"names":[],"mappings":";AAuBA,eAAsB,aACpB,QACiB;AACjB,MAAI,qBAAqB;AAEzB,mBAAiB,SAAS,QAAQ;AAChC,QAAI,MAAM,SAAS,0BAA0B,MAAM,OAAO;AACxD,4BAAsB,MAAM;AAAA,IAC9B;AAAA,EACF;AAEA,SAAO;AACT;AAcO,SAAS,yBACd,QACA,iBAC4B;AAC5B,QAAM,UAAU,IAAI,YAAA;AAEpB,SAAO,IAAI,eAAe;AAAA,IACxB,MAAM,MAAM,YAAY;AACtB,UAAI;AACF,yBAAiB,SAAS,QAAQ;AAEhC,cAAI,iBAAiB,OAAO,SAAS;AACnC;AAAA,UACF;AAGA,qBAAW;AAAA,YACT,QAAQ,OAAO,SAAS,KAAK,UAAU,KAAK,CAAC;AAAA;AAAA,CAAM;AAAA,UAAA;AAAA,QAEvD;AAEA,mBAAW,MAAA;AAAA,MACb,SAAS,OAAgB;AAEvB,YAAI,iBAAiB,OAAO,SAAS;AACnC,qBAAW,MAAA;AACX;AAAA,QACF;AAGA,mBAAW;AAAA,UACT,QAAQ;AAAA,YACN,SAAS,KAAK,UAAU;AAAA,cACtB,MAAM;AAAA,cACN,WAAW,KAAK,IAAA;AAAA,cAChB,OAAO,kBAAkB,KAAK;AAAA,YAAA,CAC/B,CAAC;AAAA;AAAA;AAAA,UAAA;AAAA,QACJ;AAEF,mBAAW,MAAA;AAAA,MACb;AAAA,IACF;AAAA,IACA,SAAS;AAGP,UAAI,iBAAiB;AACnB,wBAAgB,MAAA;AAAA,MAClB;AAAA,IACF;AAAA,EAAA,CACD;AACH;AAoBO,SAAS,2BACd,QACA,MACU;AACV,QAAM,EAAE,SAAS,iBAAiB,GAAG,aAAA,IAAiB,QAAQ,CAAA;AAG9D,QAAM,gBAAgB,IAAI,QAAQ;AAAA,IAChC,gBAAgB;AAAA,IAChB,iBAAiB;AAAA,IACjB,YAAY;AAAA,EAAA,CACb;AAID,MAAI,SAAS;AACX,UAAM,cAAc,IAAI,QAAQ,OAAO;AACvC,gBAAY,QAAQ,CAAC,OAAO,QAAQ;AAClC,oBAAc,IAAI,KAAK,KAAK;AAAA,IAC9B,CAAC;AAAA,EACH;AAEA,SAAO,IAAI,SAAS,yBAAyB,QAAQ,eAAe,GAAG;AAAA,IACrE,GAAG;AAAA,IACH,SAAS;AAAA,EAAA,CACV;AACH;AAyBO,SAAS,aACd,QACA,iBAC4B;AAC5B,QAAM,UAAU,IAAI,YAAA;AAEpB,SAAO,IAAI,eAAe;AAAA,IACxB,MAAM,MAAM,YAAY;AACtB,UAAI;AACF,yBAAiB,SAAS,QAAQ;AAEhC,cAAI,iBAAiB,OAAO,SAAS;AACnC;AAAA,UACF;AAGA,qBAAW,QAAQ,QAAQ,OAAO,GAAG,KAAK,UAAU,KAAK,CAAC;AAAA,CAAI,CAAC;AAAA,QACjE;AAEA,mBAAW,MAAA;AAAA,MACb,SAAS,OAAgB;AAEvB,YAAI,iBAAiB,OAAO,SAAS;AACnC,qBAAW,MAAA;AACX;AAAA,QACF;AAGA,mBAAW;AAAA,UACT,QAAQ;AAAA,YACN,GAAG,KAAK,UAAU;AAAA,cAChB,MAAM;AAAA,cACN,WAAW,KAAK,IAAA;AAAA,cAChB,OAAO,kBAAkB,KAAK;AAAA,YAAA,CAC/B,CAAC;AAAA;AAAA,UAAA;AAAA,QACJ;AAEF,mBAAW,MAAA;AAAA,MACb;AAAA,IACF;AAAA,IACA,SAAS;AAGP,UAAI,iBAAiB;AACnB,wBAAgB,MAAA;AAAA,MAClB;AAAA,IACF;AAAA,EAAA,CACD;AACH;AAqBO,SAAS,eACd,QACA,MACU;AACV,SAAO,IAAI,SAAS,aAAa,QAAQ,MAAM,eAAe,GAAG;AAAA,IAC/D,GAAG;AAAA,EAAA,CACJ;AACH;"}

package/dist/esm/strip-to-spec-middleware.d.ts

@@ -1,18 +0,0 @@
-import { ChatMiddleware } from './activities/chat/middleware/types.js';
-import { StreamChunk } from './types.js';
-/**
- * Strip only the deprecated nested `error` object from RUN_ERROR events.
- * The flat `message`/`code` fields are the spec-compliant form.
- *
- * All other fields pass through unchanged. @ag-ui/core's BaseEventSchema
- * uses `.passthrough()`, so extra fields (model, content, usage,
- * finishReason, toolName, stepId, etc.) are allowed and won't break
- * spec validation or verifyEvents.
- */
-export declare function stripToSpec(chunk: StreamChunk): StreamChunk;
-/**
- * Middleware that ensures events are AG-UI spec compliant.
- * Currently only strips the deprecated nested `error` object from RUN_ERROR.
- * All other fields pass through unchanged (passthrough allowed by spec).
- */
-export declare function stripToSpecMiddleware(): ChatMiddleware;

package/dist/esm/strip-to-spec-middleware.js

@@ -1,20 +0,0 @@
-function stripToSpec(chunk) {
-  if (chunk.type === "RUN_ERROR" && "error" in chunk) {
-    const { error: _deprecated, ...rest } = chunk;
-    return rest;
-  }
-  return chunk;
-}
-function stripToSpecMiddleware() {
-  return {
-    name: "strip-to-spec",
-    onChunk(_ctx, chunk) {
-      return stripToSpec(chunk);
-    }
-  };
-}
-export {
-  stripToSpec,
-  stripToSpecMiddleware
-};
-//# sourceMappingURL=strip-to-spec-middleware.js.map

package/dist/esm/strip-to-spec-middleware.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"strip-to-spec-middleware.js","sources":["../../src/strip-to-spec-middleware.ts"],"sourcesContent":["import type { ChatMiddleware } from './activities/chat/middleware/types'\nimport type { StreamChunk } from './types'\n\n/**\n * Strip only the deprecated nested `error` object from RUN_ERROR events.\n * The flat `message`/`code` fields are the spec-compliant form.\n *\n * All other fields pass through unchanged. @ag-ui/core's BaseEventSchema\n * uses `.passthrough()`, so extra fields (model, content, usage,\n * finishReason, toolName, stepId, etc.) are allowed and won't break\n * spec validation or verifyEvents.\n */\nexport function stripToSpec(chunk: StreamChunk): StreamChunk {\n  // Only strip the deprecated nested error object from RUN_ERROR\n  if (chunk.type === 'RUN_ERROR' && 'error' in chunk) {\n    const { error: _deprecated, ...rest } = chunk as Record<string, unknown>\n    return rest as StreamChunk\n  }\n  return chunk\n}\n\n/**\n * Middleware that ensures events are AG-UI spec compliant.\n * Currently only strips the deprecated nested `error` object from RUN_ERROR.\n * All other fields pass through unchanged (passthrough allowed by spec).\n */\nexport function stripToSpecMiddleware(): ChatMiddleware {\n  return {\n    name: 'strip-to-spec',\n    onChunk(_ctx, chunk) {\n      return stripToSpec(chunk)\n    },\n  }\n}\n"],"names":[],"mappings":"AAYO,SAAS,YAAY,OAAiC;AAE3D,MAAI,MAAM,SAAS,eAAe,WAAW,OAAO;AAClD,UAAM,EAAE,OAAO,aAAa,GAAG,SAAS;AACxC,WAAO;AAAA,EACT;AACA,SAAO;AACT;AAOO,SAAS,wBAAwC;AACtD,SAAO;AAAA,IACL,MAAM;AAAA,IACN,QAAQ,MAAM,OAAO;AACnB,aAAO,YAAY,KAAK;AAAA,IAC1B;AAAA,EAAA;AAEJ;"}

package/dist/esm/system-prompts.d.ts

@@ -1,66 +0,0 @@
-/**
- * A single entry in `chat({ systemPrompts: [...] })`.
- *
- * Accepts a plain string (the common case) or a structured object that lets
- * providers attach typed metadata to the prompt — e.g. Anthropic
- * `cache_control` for prompt caching, future per-prompt safety overrides for
- * Gemini, etc.
- *
- * At the chat call site, `metadata` is narrowed by the adapter via
- * `~types['systemPromptMetadata']`. Providers that don't declare one inherit
- * the default `never`, which makes the field carry no meaningful value: TS
- * only accepts `undefined` there, and provider-foreign metadata that reaches
- * an adapter via JS / `as any` is silently dropped, never written to the
- * wire. For type-safe per-provider metadata, refer to the provider's
- * `<Provider>SystemPromptMetadata` interface (e.g. `AnthropicSystemPromptMetadata`).
- *
- * @example
- *   // The 90% case — plain strings work everywhere.
- *   systemPrompts: ['Be concise.', 'Cite sources.']
- *
- * @example
- *   // Provider-specific metadata via the object form. No `satisfies` cast
- *   // is needed — the adapter narrows the `metadata` field's type at the
- *   // call site so users get autocomplete and structural checking
- *   // automatically.
- *   import { anthropicText } from '@tanstack/ai-anthropic'
- *
- *   chat({
- *     adapter: anthropicText(),
- *     systemPrompts: [
- *       {
- *         content: 'Stable instructions — cache me.',
- *         metadata: { cache_control: { type: 'ephemeral' } },
- *       },
- *       'Volatile per-request instruction.',
- *     ],
- *   })
- */
-export type SystemPrompt<TMetadata = unknown> = string | {
-    content: string;
-    metadata?: TMetadata;
-};
-/**
- * Normalised shape adapters see after the chat layer turns string entries
- * into `{ content }` objects. Adapters call `normalizeSystemPrompts` once at
- * the top of their option-mapping pipeline so the rest of the code only has
- * to handle one shape.
- */
-export interface NormalizedSystemPrompt<TMetadata = unknown> {
-    content: string;
-    metadata?: TMetadata;
-}
-/**
- * Normalise the public `systemPrompts` shape (`Array<string | { content, metadata? }>`)
- * to a homogenous `Array<{ content, metadata? }>`. Adapters use this so they
- * don't have to type-narrow string vs object inline.
- *
- * Returns an empty array (never `undefined`) so callers can chain `.map` /
- * `.join` without an extra null check.
- *
- * Throws a `TypeError` (naming the offending index) if an object-form entry's
- * `content` isn't a string. Public API boundary — callers reaching this
- * function through `as any` / external JS would otherwise stream a literal
- * `"undefined"` into the model's system prompt with no signal.
- */
-export declare function normalizeSystemPrompts<TMetadata = unknown>(prompts: ReadonlyArray<SystemPrompt> | undefined): Array<NormalizedSystemPrompt<TMetadata>>;

package/dist/esm/system-prompts.js

@@ -1,23 +0,0 @@
-function normalizeSystemPrompts(prompts) {
-  if (!prompts || prompts.length === 0) return [];
-  return prompts.map((p, i) => {
-    if (typeof p === "string") return { content: p };
-    const candidate = p;
-    if (candidate === null || typeof candidate !== "object") {
-      throw new TypeError(
-        `systemPrompts[${i}]: expected a string or { content, metadata? }, got ${candidate === null ? "null" : typeof candidate}`
-      );
-    }
-    const { content } = candidate;
-    if (typeof content !== "string") {
-      throw new TypeError(
-        `systemPrompts[${i}]: content must be a string, got ${typeof content}`
-      );
-    }
-    return p;
-  });
-}
-export {
-  normalizeSystemPrompts
-};
-//# sourceMappingURL=system-prompts.js.map

package/dist/esm/system-prompts.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"system-prompts.js","sources":["../../src/system-prompts.ts"],"sourcesContent":["/**\n * A single entry in `chat({ systemPrompts: [...] })`.\n *\n * Accepts a plain string (the common case) or a structured object that lets\n * providers attach typed metadata to the prompt — e.g. Anthropic\n * `cache_control` for prompt caching, future per-prompt safety overrides for\n * Gemini, etc.\n *\n * At the chat call site, `metadata` is narrowed by the adapter via\n * `~types['systemPromptMetadata']`. Providers that don't declare one inherit\n * the default `never`, which makes the field carry no meaningful value: TS\n * only accepts `undefined` there, and provider-foreign metadata that reaches\n * an adapter via JS / `as any` is silently dropped, never written to the\n * wire. For type-safe per-provider metadata, refer to the provider's\n * `<Provider>SystemPromptMetadata` interface (e.g. `AnthropicSystemPromptMetadata`).\n *\n * @example\n *   // The 90% case — plain strings work everywhere.\n *   systemPrompts: ['Be concise.', 'Cite sources.']\n *\n * @example\n *   // Provider-specific metadata via the object form. No `satisfies` cast\n *   // is needed — the adapter narrows the `metadata` field's type at the\n *   // call site so users get autocomplete and structural checking\n *   // automatically.\n *   import { anthropicText } from '@tanstack/ai-anthropic'\n *\n *   chat({\n *     adapter: anthropicText(),\n *     systemPrompts: [\n *       {\n *         content: 'Stable instructions — cache me.',\n *         metadata: { cache_control: { type: 'ephemeral' } },\n *       },\n *       'Volatile per-request instruction.',\n *     ],\n *   })\n */\nexport type SystemPrompt<TMetadata = unknown> =\n  | string\n  | {\n      content: string\n      metadata?: TMetadata\n    }\n\n/**\n * Normalised shape adapters see after the chat layer turns string entries\n * into `{ content }` objects. Adapters call `normalizeSystemPrompts` once at\n * the top of their option-mapping pipeline so the rest of the code only has\n * to handle one shape.\n */\nexport interface NormalizedSystemPrompt<TMetadata = unknown> {\n  content: string\n  metadata?: TMetadata\n}\n\n/**\n * Normalise the public `systemPrompts` shape (`Array<string | { content, metadata? }>`)\n * to a homogenous `Array<{ content, metadata? }>`. Adapters use this so they\n * don't have to type-narrow string vs object inline.\n *\n * Returns an empty array (never `undefined`) so callers can chain `.map` /\n * `.join` without an extra null check.\n *\n * Throws a `TypeError` (naming the offending index) if an object-form entry's\n * `content` isn't a string. Public API boundary — callers reaching this\n * function through `as any` / external JS would otherwise stream a literal\n * `\"undefined\"` into the model's system prompt with no signal.\n */\nexport function normalizeSystemPrompts<TMetadata = unknown>(\n  // Accept the wide public shape (`SystemPrompt<unknown>`) regardless of the\n  // caller's `TMetadata`. Adapters know their own metadata shape; the\n  // generic narrows the *output* so adapter code can read `p.metadata.X`\n  // without an additional cast.\n  prompts: ReadonlyArray<SystemPrompt> | undefined,\n): Array<NormalizedSystemPrompt<TMetadata>> {\n  if (!prompts || prompts.length === 0) return []\n  return prompts.map((p, i) => {\n    if (typeof p === 'string') return { content: p }\n    // Defence in depth: TypeScript narrows `p` to the object arm here, but\n    // this function is a public API boundary that callers can reach via\n    // plain JS or `as any`. Re-validate at runtime so we never stream a\n    // literal `\"undefined\"` into the model.\n    const candidate = p as unknown\n    if (candidate === null || typeof candidate !== 'object') {\n      throw new TypeError(\n        `systemPrompts[${i}]: expected a string or { content, metadata? }, got ${candidate === null ? 'null' : typeof candidate}`,\n      )\n    }\n    const { content } = candidate as { content?: unknown }\n    if (typeof content !== 'string') {\n      throw new TypeError(\n        `systemPrompts[${i}]: content must be a string, got ${typeof content}`,\n      )\n    }\n    return p as NormalizedSystemPrompt<TMetadata>\n  })\n}\n"],"names":[],"mappings":"AAqEO,SAAS,uBAKd,SAC0C;AAC1C,MAAI,CAAC,WAAW,QAAQ,WAAW,UAAU,CAAA;AAC7C,SAAO,QAAQ,IAAI,CAAC,GAAG,MAAM;AAC3B,QAAI,OAAO,MAAM,SAAU,QAAO,EAAE,SAAS,EAAA;AAK7C,UAAM,YAAY;AAClB,QAAI,cAAc,QAAQ,OAAO,cAAc,UAAU;AACvD,YAAM,IAAI;AAAA,QACR,iBAAiB,CAAC,uDAAuD,cAAc,OAAO,SAAS,OAAO,SAAS;AAAA,MAAA;AAAA,IAE3H;AACA,UAAM,EAAE,YAAY;AACpB,QAAI,OAAO,YAAY,UAAU;AAC/B,YAAM,IAAI;AAAA,QACR,iBAAiB,CAAC,oCAAoC,OAAO,OAAO;AAAA,MAAA;AAAA,IAExE;AACA,WAAO;AAAA,EACT,CAAC;AACH;"}

package/dist/esm/tool-registry.d.ts

@@ -1,81 +0,0 @@
-import { AnyTool } from './types.js';
-/**
- * A registry that holds tools and allows dynamic tool management.
- *
- * The registry can be either mutable (allowing additions/removals during execution)
- * or frozen (static tool list, for backward compatibility with tools arrays).
- */
-export interface ToolRegistry<TTool extends AnyTool = AnyTool> {
-    /**
-     * Get all current tools in the registry.
-     * Called each agent loop iteration to get the latest tool list.
-     */
-    getTools: () => Array<TTool>;
-    /**
-     * Add a tool to the registry dynamically.
-     * For frozen registries, this is a no-op.
-     *
-     * @param tool - The tool to add
-     */
-    add: (tool: TTool) => void;
-    /**
-     * Remove a tool from the registry by name.
-     * For frozen registries, this always returns false.
-     *
-     * @param name - The name of the tool to remove
-     * @returns true if the tool was removed, false if not found or frozen
-     */
-    remove: (name: string) => boolean;
-    /**
-     * Check if a tool exists in the registry.
-     *
-     * @param name - The name of the tool to check
-     */
-    has: (name: string) => boolean;
-    /**
-     * Get a tool by name.
-     *
-     * @param name - The name of the tool to get
-     * @returns The tool if found, undefined otherwise
-     */
-    get: (name: string) => TTool | undefined;
-    /**
-     * Whether this registry is frozen (immutable).
-     * Frozen registries don't allow add/remove operations.
-     */
-    readonly isFrozen: boolean;
-}
-/**
- * Create a mutable tool registry for dynamic tool scenarios.
- *
- * Tools can be added and removed during chat execution, and the
- * changes will be reflected in subsequent agent loop iterations.
- *
- * @param initialTools - Optional initial set of tools
- * @returns A mutable ToolRegistry
- *
- * @example
- * ```typescript
- * const registry = createToolRegistry([toolA, toolB])
- *
- * const stream = chat({
- *   adapter,
- *   messages,
- *   toolRegistry: registry,
- * })
- *
- * // Later, during tool execution:
- * registry.add(newTool)  // Immediately available to LLM
- * ```
- */
-export declare function createToolRegistry<TTool extends AnyTool = AnyTool>(initialTools?: Array<TTool>): ToolRegistry<TTool>;
-/**
- * Create a frozen (immutable) tool registry from a tools array.
- *
- * This is used internally to wrap static `tools` arrays for backward compatibility.
- * Add and remove operations are no-ops on frozen registries.
- *
- * @param tools - The static array of tools
- * @returns A frozen ToolRegistry
- */
-export declare function createFrozenRegistry<TTool extends AnyTool = AnyTool>(tools?: Array<TTool>): ToolRegistry<TTool>;

package/dist/esm/tool-registry.js

@@ -1,49 +0,0 @@
-function createToolRegistry(initialTools = []) {
-  const tools = /* @__PURE__ */ new Map();
-  for (const tool of initialTools) {
-    tools.set(tool.name, tool);
-  }
-  return {
-    getTools: () => Array.from(tools.values()),
-    add: (tool) => {
-      tools.set(tool.name, tool);
-    },
-    remove: (name) => {
-      return tools.delete(name);
-    },
-    has: (name) => {
-      return tools.has(name);
-    },
-    get: (name) => {
-      return tools.get(name);
-    },
-    isFrozen: false
-  };
-}
-function createFrozenRegistry(tools = []) {
-  const toolMap = /* @__PURE__ */ new Map();
-  for (const tool of tools) {
-    toolMap.set(tool.name, tool);
-  }
-  const frozenTools = Object.freeze([...tools]);
-  return {
-    getTools: () => [...frozenTools],
-    add: (_tool) => {
-    },
-    remove: (_name) => {
-      return false;
-    },
-    has: (name) => {
-      return toolMap.has(name);
-    },
-    get: (name) => {
-      return toolMap.get(name);
-    },
-    isFrozen: true
-  };
-}
-export {
-  createFrozenRegistry,
-  createToolRegistry
-};
-//# sourceMappingURL=tool-registry.js.map

package/dist/esm/tool-registry.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"tool-registry.js","sources":["../../src/tool-registry.ts"],"sourcesContent":["import type { AnyTool } from './types'\n\n/**\n * A registry that holds tools and allows dynamic tool management.\n *\n * The registry can be either mutable (allowing additions/removals during execution)\n * or frozen (static tool list, for backward compatibility with tools arrays).\n */\nexport interface ToolRegistry<TTool extends AnyTool = AnyTool> {\n  /**\n   * Get all current tools in the registry.\n   * Called each agent loop iteration to get the latest tool list.\n   */\n  getTools: () => Array<TTool>\n\n  /**\n   * Add a tool to the registry dynamically.\n   * For frozen registries, this is a no-op.\n   *\n   * @param tool - The tool to add\n   */\n  add: (tool: TTool) => void\n\n  /**\n   * Remove a tool from the registry by name.\n   * For frozen registries, this always returns false.\n   *\n   * @param name - The name of the tool to remove\n   * @returns true if the tool was removed, false if not found or frozen\n   */\n  remove: (name: string) => boolean\n\n  /**\n   * Check if a tool exists in the registry.\n   *\n   * @param name - The name of the tool to check\n   */\n  has: (name: string) => boolean\n\n  /**\n   * Get a tool by name.\n   *\n   * @param name - The name of the tool to get\n   * @returns The tool if found, undefined otherwise\n   */\n  get: (name: string) => TTool | undefined\n\n  /**\n   * Whether this registry is frozen (immutable).\n   * Frozen registries don't allow add/remove operations.\n   */\n  readonly isFrozen: boolean\n}\n\n/**\n * Create a mutable tool registry for dynamic tool scenarios.\n *\n * Tools can be added and removed during chat execution, and the\n * changes will be reflected in subsequent agent loop iterations.\n *\n * @param initialTools - Optional initial set of tools\n * @returns A mutable ToolRegistry\n *\n * @example\n * ```typescript\n * const registry = createToolRegistry([toolA, toolB])\n *\n * const stream = chat({\n *   adapter,\n *   messages,\n *   toolRegistry: registry,\n * })\n *\n * // Later, during tool execution:\n * registry.add(newTool)  // Immediately available to LLM\n * ```\n */\nexport function createToolRegistry<TTool extends AnyTool = AnyTool>(\n  initialTools: Array<TTool> = [],\n): ToolRegistry<TTool> {\n  const tools = new Map<string, TTool>()\n\n  for (const tool of initialTools) {\n    tools.set(tool.name, tool)\n  }\n\n  return {\n    getTools: () => Array.from(tools.values()),\n\n    add: (tool: TTool) => {\n      tools.set(tool.name, tool)\n    },\n\n    remove: (name: string) => {\n      return tools.delete(name)\n    },\n\n    has: (name: string) => {\n      return tools.has(name)\n    },\n\n    get: (name: string) => {\n      return tools.get(name)\n    },\n\n    isFrozen: false,\n  }\n}\n\n/**\n * Create a frozen (immutable) tool registry from a tools array.\n *\n * This is used internally to wrap static `tools` arrays for backward compatibility.\n * Add and remove operations are no-ops on frozen registries.\n *\n * @param tools - The static array of tools\n * @returns A frozen ToolRegistry\n */\nexport function createFrozenRegistry<TTool extends AnyTool = AnyTool>(\n  tools: Array<TTool> = [],\n): ToolRegistry<TTool> {\n  const toolMap = new Map<string, TTool>()\n\n  for (const tool of tools) {\n    toolMap.set(tool.name, tool)\n  }\n\n  const frozenTools = Object.freeze([...tools])\n\n  return {\n    getTools: () => [...frozenTools],\n\n    add: (_tool: TTool) => {\n      // No-op for frozen registry\n    },\n\n    remove: (_name: string) => {\n      // No-op for frozen registry\n      return false\n    },\n\n    has: (name: string) => {\n      return toolMap.has(name)\n    },\n\n    get: (name: string) => {\n      return toolMap.get(name)\n    },\n\n    isFrozen: true,\n  }\n}\n"],"names":[],"mappings":"AA6EO,SAAS,mBACd,eAA6B,IACR;AACrB,QAAM,4BAAY,IAAA;AAElB,aAAW,QAAQ,cAAc;AAC/B,UAAM,IAAI,KAAK,MAAM,IAAI;AAAA,EAC3B;AAEA,SAAO;AAAA,IACL,UAAU,MAAM,MAAM,KAAK,MAAM,QAAQ;AAAA,IAEzC,KAAK,CAAC,SAAgB;AACpB,YAAM,IAAI,KAAK,MAAM,IAAI;AAAA,IAC3B;AAAA,IAEA,QAAQ,CAAC,SAAiB;AACxB,aAAO,MAAM,OAAO,IAAI;AAAA,IAC1B;AAAA,IAEA,KAAK,CAAC,SAAiB;AACrB,aAAO,MAAM,IAAI,IAAI;AAAA,IACvB;AAAA,IAEA,KAAK,CAAC,SAAiB;AACrB,aAAO,MAAM,IAAI,IAAI;AAAA,IACvB;AAAA,IAEA,UAAU;AAAA,EAAA;AAEd;AAWO,SAAS,qBACd,QAAsB,IACD;AACrB,QAAM,8BAAc,IAAA;AAEpB,aAAW,QAAQ,OAAO;AACxB,YAAQ,IAAI,KAAK,MAAM,IAAI;AAAA,EAC7B;AAEA,QAAM,cAAc,OAAO,OAAO,CAAC,GAAG,KAAK,CAAC;AAE5C,SAAO;AAAA,IACL,UAAU,MAAM,CAAC,GAAG,WAAW;AAAA,IAE/B,KAAK,CAAC,UAAiB;AAAA,IAEvB;AAAA,IAEA,QAAQ,CAAC,UAAkB;AAEzB,aAAO;AAAA,IACT;AAAA,IAEA,KAAK,CAAC,SAAiB;AACrB,aAAO,QAAQ,IAAI,IAAI;AAAA,IACzB;AAAA,IAEA,KAAK,CAAC,SAAiB;AACrB,aAAO,QAAQ,IAAI,IAAI;AAAA,IACzB;AAAA,IAEA,UAAU;AAAA,EAAA;AAEd;"}

package/dist/esm/tools/provider-tool.d.ts

@@ -1,30 +0,0 @@
-import { Tool } from '../types.js';
-/**
- * A provider-specific tool produced by an adapter-package factory
- * (e.g. `webSearchTool` from `@tanstack/ai-anthropic/tools`).
- *
- * The two `~`-prefixed fields are type-only phantom brands — they are never
- * assigned at runtime. They allow the core type system to match a factory's
- * output against the selected model's `supports.tools` list and surface a
- * compile-time error when the combination is unsupported.
- *
- * User-defined tools (via `toolDefinition()`) remain plain `Tool` and stay
- * assignable to any model.
- *
- * @template TProvider - Provider identifier (e.g. `'anthropic'`, `'openai'`).
- * @template TKind - Canonical tool-kind string matching the provider's
- *   `supports.tools` entries (e.g. `'web_search'`, `'code_execution'`).
- */
-export interface ProviderTool<TProvider extends string, TKind extends string> extends Tool {
-    readonly '~provider': TProvider;
-    readonly '~toolKind': TKind;
-}
-/**
- * Attach the `ProviderTool` phantom brand to a plain `Tool`-shaped object.
- *
- * The brand fields (`'~provider'`, `'~toolKind'`) exist only in the type
- * system and are never assigned at runtime, so this is a single audited
- * type-only assertion. Use it inside adapter `xxxTool()` factories instead
- * of `as unknown as` — the cast collapses to one named site.
- */
-export declare function brandProviderTool<T extends ProviderTool<string, string>>(tool: Omit<T, '~provider' | '~toolKind'>): T;

package/dist/esm/tools/provider-tool.js

@@ -1,7 +0,0 @@
-function brandProviderTool(tool) {
-  return tool;
-}
-export {
-  brandProviderTool
-};
-//# sourceMappingURL=provider-tool.js.map

package/dist/esm/tools/provider-tool.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"provider-tool.js","sources":["../../../src/tools/provider-tool.ts"],"sourcesContent":["import type { Tool } from '../types'\n\n/**\n * A provider-specific tool produced by an adapter-package factory\n * (e.g. `webSearchTool` from `@tanstack/ai-anthropic/tools`).\n *\n * The two `~`-prefixed fields are type-only phantom brands — they are never\n * assigned at runtime. They allow the core type system to match a factory's\n * output against the selected model's `supports.tools` list and surface a\n * compile-time error when the combination is unsupported.\n *\n * User-defined tools (via `toolDefinition()`) remain plain `Tool` and stay\n * assignable to any model.\n *\n * @template TProvider - Provider identifier (e.g. `'anthropic'`, `'openai'`).\n * @template TKind - Canonical tool-kind string matching the provider's\n *   `supports.tools` entries (e.g. `'web_search'`, `'code_execution'`).\n */\nexport interface ProviderTool<\n  TProvider extends string,\n  TKind extends string,\n> extends Tool {\n  readonly '~provider': TProvider\n  readonly '~toolKind': TKind\n}\n\n/**\n * Attach the `ProviderTool` phantom brand to a plain `Tool`-shaped object.\n *\n * The brand fields (`'~provider'`, `'~toolKind'`) exist only in the type\n * system and are never assigned at runtime, so this is a single audited\n * type-only assertion. Use it inside adapter `xxxTool()` factories instead\n * of `as unknown as` — the cast collapses to one named site.\n */\nexport function brandProviderTool<T extends ProviderTool<string, string>>(\n  tool: Omit<T, '~provider' | '~toolKind'>,\n): T {\n  return tool as T\n}\n"],"names":[],"mappings":"AAkCO,SAAS,kBACd,MACG;AACH,SAAO;AACT;"}