@tanstack/ai-client 0.13.0 → 0.14.0

package/dist/esm/connection-adapters.js

@@ -1,4 +1,6 @@
-import { uiMessagesToWire, EventType } from "@tanstack/ai";
+import { EventType, uiMessagesToWire } from "@tanstack/ai/client";
+import { getResponseStreamReader, createResponseStreamTextDecoder } from "./response-stream.js";
+import { parseSseDataLine } from "./sse-utils.js";
 class StreamTruncatedError extends Error {
   constructor() {
     super(
@@ -33,7 +35,7 @@ function mergeHeaders(customHeaders) {
 }
 async function* readStreamLines(reader, abortSignal) {
   try {
-    const decoder = new TextDecoder();
+    const decoder = createResponseStreamTextDecoder();
     let buffer = "";
     while (!abortSignal?.aborted) {
       const { done, value } = await reader.read();
@@ -60,10 +62,7 @@ async function* responseToSSEChunks(response, abortSignal) {
       `HTTP error! status: ${response.status} ${response.statusText}`
     );
   }
-  const reader = response.body?.getReader();
-  if (!reader) {
-    throw new Error("Response body is not readable");
-  }
+  const reader = getResponseStreamReader(response);
   let lastThreadId;
   let lastRunId;
   let lastModel;
@@ -71,7 +70,7 @@ async function* responseToSSEChunks(response, abortSignal) {
     if (line.startsWith(":") || line.startsWith("event:") || line.startsWith("id:") || line.startsWith("retry:")) {
       continue;
     }
-    const data = line.startsWith("data: ") ? line.slice(6) : line;
+    const data = parseSseDataLine(line);
     if (data === "[DONE]") {
       const synthetic = {
         type: EventType.RUN_FINISHED,
@@ -219,6 +218,28 @@ function normalizeConnectionAdapter(connection) {
     }
   };
 }
+function buildRunAgentInputBody(messages, data, runContext, options) {
+  const wireMessages = uiMessagesToWire(messages);
+  const forwardedProps = {
+    ...options.body,
+    ...runContext?.forwardedProps ?? {},
+    ...data
+  };
+  return {
+    threadId: runContext?.threadId ?? generateRunId("thread"),
+    runId: runContext?.runId ?? generateRunId("run"),
+    ...runContext?.parentRunId !== void 0 && {
+      parentRunId: runContext.parentRunId
+    },
+    state: {},
+    messages: wireMessages,
+    tools: runContext?.clientTools ?? [],
+    context: [],
+    forwardedProps,
+    // Backward-compat mirror of `forwardedProps` under the legacy field name.
+    data: { ...forwardedProps }
+  };
+}
 function fetchServerSentEvents(url, options = {}) {
   return {
     async *connect(messages, data, abortSignal, runContext) {
@@ -228,34 +249,12 @@ function fetchServerSentEvents(url, options = {}) {
         "Content-Type": "application/json",
         ...mergeHeaders(resolvedOptions.headers)
       };
-      const wireMessages = uiMessagesToWire(messages);
-      const forwardedProps = {
-        ...resolvedOptions.body,
-        ...runContext?.forwardedProps ?? {},
-        ...data
-      };
-      const requestBody = {
-        threadId: runContext?.threadId ?? generateRunId("thread"),
-        runId: runContext?.runId ?? generateRunId("run"),
-        ...runContext?.parentRunId !== void 0 && {
-          parentRunId: runContext.parentRunId
-        },
-        state: {},
-        messages: wireMessages,
-        tools: runContext?.clientTools ?? [],
-        context: [],
-        forwardedProps,
-        // Backward-compat mirror of `forwardedProps` under the legacy
-        // field name `data`. Server endpoints that have not migrated
-        // off the pre-AG-UI shape (`{ messages, data }`) keep working.
-        // AG-UI strict consumers strip this via `RunAgentInputSchema`
-        // (see `chatParamsFromRequestBody`). Will be removed when the
-        // legacy `body` client option is dropped.
-        // Shallow-cloned so that downstream mutation of `data` (e.g.
-        // by a logging interceptor or fetch wrapper) cannot corrupt
-        // `forwardedProps` and vice versa.
-        data: { ...forwardedProps }
-      };
+      const requestBody = buildRunAgentInputBody(
+        messages,
+        data,
+        runContext,
+        resolvedOptions
+      );
       const fetchClient = resolvedOptions.fetchClient ?? fetch;
       const signal = abortSignal || resolvedOptions.signal;
       const response = await fetchClient(resolvedUrl, {
@@ -278,34 +277,12 @@ function fetchHttpStream(url, options = {}) {
         "Content-Type": "application/json",
         ...mergeHeaders(resolvedOptions.headers)
       };
-      const wireMessages = uiMessagesToWire(messages);
-      const forwardedProps = {
-        ...resolvedOptions.body,
-        ...runContext?.forwardedProps ?? {},
-        ...data
-      };
-      const requestBody = {
-        threadId: runContext?.threadId ?? generateRunId("thread"),
-        runId: runContext?.runId ?? generateRunId("run"),
-        ...runContext?.parentRunId !== void 0 && {
-          parentRunId: runContext.parentRunId
-        },
-        state: {},
-        messages: wireMessages,
-        tools: runContext?.clientTools ?? [],
-        context: [],
-        forwardedProps,
-        // Backward-compat mirror of `forwardedProps` under the legacy
-        // field name `data`. Server endpoints that have not migrated
-        // off the pre-AG-UI shape (`{ messages, data }`) keep working.
-        // AG-UI strict consumers strip this via `RunAgentInputSchema`
-        // (see `chatParamsFromRequestBody`). Will be removed when the
-        // legacy `body` client option is dropped.
-        // Shallow-cloned so that downstream mutation of `data` (e.g.
-        // by a logging interceptor or fetch wrapper) cannot corrupt
-        // `forwardedProps` and vice versa.
-        data: { ...forwardedProps }
-      };
+      const requestBody = buildRunAgentInputBody(
+        messages,
+        data,
+        runContext,
+        resolvedOptions
+      );
       const fetchClient = resolvedOptions.fetchClient ?? fetch;
       const signal = abortSignal || resolvedOptions.signal;
       const response = await fetchClient(resolvedUrl, {
@@ -320,16 +297,231 @@ function fetchHttpStream(url, options = {}) {
           `HTTP error! status: ${response.status} ${response.statusText}`
         );
       }
-      const reader = response.body?.getReader();
-      if (!reader) {
-        throw new Error("Response body is not readable");
-      }
+      const reader = getResponseStreamReader(response);
       for await (const line of readStreamLines(reader, abortSignal)) {
         yield JSON.parse(line);
       }
     }
   };
 }
+function createDefaultXMLHttpRequest() {
+  if (typeof globalThis.XMLHttpRequest !== "function") {
+    throw new Error("XMLHttpRequest is not available in this runtime");
+  }
+  return new globalThis.XMLHttpRequest();
+}
+function cleanupXhr(xhr, abortSignal, onAbort) {
+  xhr.onprogress = null;
+  xhr.onload = null;
+  xhr.onerror = null;
+  xhr.onabort = null;
+  xhr.onloadend = null;
+  if (abortSignal && onAbort) {
+    abortSignal.removeEventListener("abort", onAbort);
+  }
+}
+function readXhrLines(xhr, abortSignal) {
+  let offset = 0;
+  let buffer = "";
+  const lines = [];
+  const waiters = [];
+  let done = false;
+  let aborted = false;
+  let error;
+  let onAbort;
+  const wake = () => {
+    const waiter = waiters.shift();
+    waiter?.();
+  };
+  const enqueueDelta = () => {
+    if (xhr.status !== 0 && (xhr.status < 200 || xhr.status >= 300)) {
+      error = new Error(`XHR error! status: ${xhr.status} ${xhr.statusText}`);
+      done = true;
+      return;
+    }
+    const responseText = xhr.responseText;
+    if (responseText.length <= offset) {
+      return;
+    }
+    buffer += responseText.slice(offset);
+    offset = responseText.length;
+    const splitLines = buffer.split("\n");
+    buffer = splitLines.pop() ?? "";
+    for (const line of splitLines) {
+      const normalized = line.endsWith("\r") ? line.slice(0, -1) : line;
+      if (normalized.trim()) {
+        lines.push(normalized);
+      }
+    }
+  };
+  const finish = () => {
+    enqueueDelta();
+    if (xhr.status < 200 || xhr.status >= 300) {
+      error = new Error(`XHR error! status: ${xhr.status} ${xhr.statusText}`);
+    } else if (buffer.trim() && !aborted) {
+      error = new StreamTruncatedError();
+    }
+    done = true;
+    wake();
+  };
+  xhr.onprogress = () => {
+    enqueueDelta();
+    wake();
+  };
+  xhr.onload = finish;
+  xhr.onerror = () => {
+    error = new Error("XHR request failed");
+    done = true;
+    wake();
+  };
+  xhr.onabort = () => {
+    aborted = true;
+    done = true;
+    wake();
+  };
+  xhr.onloadend = () => {
+    if (!done) {
+      finish();
+    }
+  };
+  if (abortSignal) {
+    onAbort = () => {
+      aborted = true;
+      xhr.abort();
+    };
+    if (abortSignal.aborted) {
+      onAbort();
+    } else {
+      abortSignal.addEventListener("abort", onAbort, { once: true });
+    }
+  }
+  return (async function* () {
+    try {
+      while (true) {
+        const line = lines.shift();
+        if (line !== void 0) {
+          yield line;
+          continue;
+        }
+        if (error) {
+          throw error;
+        }
+        if (done || abortSignal?.aborted) {
+          return;
+        }
+        await new Promise((resolve) => {
+          waiters.push(resolve);
+        });
+      }
+    } finally {
+      cleanupXhr(xhr, abortSignal, onAbort);
+    }
+  })();
+}
+function createConfiguredXhrRequest(url, options, messages, data, runContext) {
+  const xhr = options.xhrFactory?.() ?? createDefaultXMLHttpRequest();
+  xhr.open("POST", url);
+  if (options.withCredentials !== void 0) {
+    xhr.withCredentials = options.withCredentials;
+  }
+  const requestHeaders = {
+    "Content-Type": "application/json",
+    ...mergeHeaders(options.headers)
+  };
+  for (const [name, value] of Object.entries(requestHeaders)) {
+    xhr.setRequestHeader(name, value);
+  }
+  const requestBody = buildRunAgentInputBody(
+    messages,
+    data,
+    runContext,
+    options
+  );
+  return { xhr, body: JSON.stringify(requestBody) };
+}
+async function resolveXhrConnectionOptions(options) {
+  return typeof options === "function" ? await options() : options;
+}
+function xhrServerSentEvents(url, options = {}) {
+  return {
+    async *connect(messages, data, abortSignal, runContext) {
+      const resolvedUrl = typeof url === "function" ? url() : url;
+      const resolvedOptions = await resolveXhrConnectionOptions(options);
+      const signal = abortSignal || resolvedOptions.signal;
+      const request = createConfiguredXhrRequest(
+        resolvedUrl,
+        resolvedOptions,
+        messages,
+        data,
+        runContext
+      );
+      const lines = readXhrLines(request.xhr, signal);
+      if (signal?.aborted) {
+        await lines.next();
+        return;
+      }
+      request.xhr.send(request.body);
+      let lastThreadId;
+      let lastRunId;
+      let lastModel;
+      for await (const line of lines) {
+        if (line.startsWith(":") || line.startsWith("event:") || line.startsWith("id:") || line.startsWith("retry:")) {
+          continue;
+        }
+        const chunkData = parseSseDataLine(line);
+        if (chunkData === "[DONE]") {
+          const synthetic = {
+            type: EventType.RUN_FINISHED,
+            threadId: lastThreadId ?? runContext?.threadId ?? "",
+            runId: lastRunId ?? runContext?.runId ?? "",
+            model: lastModel ?? "",
+            timestamp: Date.now(),
+            finishReason: "stop"
+          };
+          request.xhr.abort();
+          yield synthetic;
+          return;
+        }
+        const chunk = JSON.parse(chunkData);
+        if ("threadId" in chunk && typeof chunk.threadId === "string") {
+          lastThreadId = chunk.threadId;
+        }
+        if ("runId" in chunk && typeof chunk.runId === "string") {
+          lastRunId = chunk.runId;
+        }
+        if ("model" in chunk && typeof chunk.model === "string") {
+          lastModel = chunk.model;
+        }
+        yield chunk;
+      }
+    }
+  };
+}
+function xhrHttpStream(url, options = {}) {
+  return {
+    async *connect(messages, data, abortSignal, runContext) {
+      const resolvedUrl = typeof url === "function" ? url() : url;
+      const resolvedOptions = await resolveXhrConnectionOptions(options);
+      const signal = abortSignal || resolvedOptions.signal;
+      const request = createConfiguredXhrRequest(
+        resolvedUrl,
+        resolvedOptions,
+        messages,
+        data,
+        runContext
+      );
+      const lines = readXhrLines(request.xhr, signal);
+      if (signal?.aborted) {
+        await lines.next();
+        return;
+      }
+      request.xhr.send(request.body);
+      for await (const line of lines) {
+        yield JSON.parse(line);
+      }
+    }
+  };
+}
 function stream(streamFactory) {
   return {
     async *connect(messages, data, abortSignal) {
@@ -404,6 +596,8 @@ export {
   fetcherToConnectionAdapter,
   normalizeConnectionAdapter,
   rpcStream,
-  stream
+  stream,
+  xhrHttpStream,
+  xhrServerSentEvents
 };
 //# sourceMappingURL=connection-adapters.js.map

package/dist/esm/connection-adapters.js.map

@@ -1 +1 @@
-{"version":3,"file":"connection-adapters.js","sources":["../../src/connection-adapters.ts"],"sourcesContent":["import { EventType, uiMessagesToWire } from '@tanstack/ai'\nimport type {\n  ModelMessage,\n  RunErrorEvent,\n  RunFinishedEvent,\n  StreamChunk,\n  UIMessage,\n} from '@tanstack/ai'\nimport type { ChatFetcher } from './types'\n\n/**\n * Thrown when an SSE/HTTP stream ends with a non-empty unterminated buffer.\n * Indicates the connection was cut mid-line (server crash, dropped TCP, proxy\n * timeout) so the partial content cannot be safely parsed.\n */\nexport class StreamTruncatedError extends Error {\n  constructor() {\n    super(\n      'Stream ended with unterminated trailing data — connection was likely cut short.',\n    )\n    this.name = 'StreamTruncatedError'\n  }\n}\n\nfunction generateRunId(prefix: string): string {\n  return `${prefix}-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`\n}\n\n/**\n * Asserts an id is present when synthesizing a terminal event. The chat\n * client always supplies `runContext.threadId` / `runContext.runId`, so an\n * absent id at this layer indicates the adapter was wired up by a caller\n * that bypassed that contract — surface it rather than fabricating one.\n */\nfunction requireSyntheticId(\n  value: string | undefined,\n  field: 'threadId' | 'runId',\n): string {\n  if (!value) {\n    throw new Error(\n      `Cannot synthesize terminal event: ${field} not supplied via runContext and not observed in the upstream stream.`,\n    )\n  }\n  return value\n}\n\n/**\n * Merge custom headers into request headers\n */\nfunction mergeHeaders(\n  customHeaders?: Record<string, string> | Headers,\n): Record<string, string> {\n  if (!customHeaders) {\n    return {}\n  }\n  if (customHeaders instanceof Headers) {\n    const result: Record<string, string> = {}\n    customHeaders.forEach((value, key) => {\n      result[key] = value\n    })\n    return result\n  }\n  return customHeaders\n}\n\n/**\n * Read lines from a stream (newline-delimited)\n */\nasync function* readStreamLines(\n  reader: ReadableStreamDefaultReader<Uint8Array>,\n  abortSignal?: AbortSignal,\n): AsyncGenerator<string> {\n  try {\n    const decoder = new TextDecoder()\n    let buffer = ''\n\n    while (!abortSignal?.aborted) {\n      const { done, value } = await reader.read()\n      if (done) break\n\n      buffer += decoder.decode(value, { stream: true })\n      const lines = buffer.split('\\n')\n\n      // Keep the last incomplete line in the buffer\n      buffer = lines.pop() || ''\n\n      for (const line of lines) {\n        if (line.trim()) {\n          yield line\n        }\n      }\n    }\n\n    // A non-empty trailing buffer means the connection was cut mid-line.\n    // Surface this as an error so the chat client transitions to 'error'\n    // state instead of silently presenting a partial stream as success.\n    // Skip when the consumer aborted — a user-initiated stop() interrupting\n    // mid-line is expected, not a truncation bug.\n    if (buffer.trim() && !abortSignal?.aborted) {\n      throw new StreamTruncatedError()\n    }\n  } finally {\n    reader.releaseLock()\n  }\n}\n\n/**\n * Yield StreamChunks parsed from an SSE Response body.\n *\n * Accepts either `data: {...}` lines or bare JSON lines. Skips comments\n * starting with `:` (proxies and CDNs inject these as keepalives) and the\n * `event:` / `id:` / `retry:` SSE control fields. A `[DONE]` sentinel is\n * treated as a terminal event: a synthesized RUN_FINISHED is yielded using\n * the most recent upstream `threadId` / `runId`, ensuring the consumer sees\n * a clean terminal event with real correlation ids.\n *\n * A JSON parse failure throws — the consumer surfaces it as an error.\n */\nasync function* responseToSSEChunks(\n  response: Response,\n  abortSignal?: AbortSignal,\n): AsyncGenerator<StreamChunk> {\n  if (!response.ok) {\n    throw new Error(\n      `HTTP error! status: ${response.status} ${response.statusText}`,\n    )\n  }\n  const reader = response.body?.getReader()\n  if (!reader) {\n    throw new Error('Response body is not readable')\n  }\n  let lastThreadId: string | undefined\n  let lastRunId: string | undefined\n  let lastModel: string | undefined\n  for await (const line of readStreamLines(reader, abortSignal)) {\n    if (\n      line.startsWith(':') ||\n      line.startsWith('event:') ||\n      line.startsWith('id:') ||\n      line.startsWith('retry:')\n    ) {\n      continue\n    }\n    const data = line.startsWith('data: ') ? line.slice(6) : line\n    if (data === '[DONE]') {\n      const synthetic: RunFinishedEvent = {\n        type: EventType.RUN_FINISHED,\n        threadId: lastThreadId ?? '',\n        runId: lastRunId ?? '',\n        model: lastModel ?? '',\n        timestamp: Date.now(),\n        finishReason: 'stop',\n      }\n      yield synthetic\n      return\n    }\n    const chunk = JSON.parse(data) as StreamChunk\n    if ('threadId' in chunk && typeof chunk.threadId === 'string') {\n      lastThreadId = chunk.threadId\n    }\n    if ('runId' in chunk && typeof chunk.runId === 'string') {\n      lastRunId = chunk.runId\n    }\n    if ('model' in chunk && typeof chunk.model === 'string') {\n      lastModel = chunk.model\n    }\n    yield chunk\n  }\n}\n\n/**\n * Per-send context provided by the chat client to the connection adapter.\n * The adapter combines this with serialized messages to build a full\n * AG-UI `RunAgentInput` payload.\n */\nexport interface RunAgentInputContext {\n  threadId: string\n  runId: string\n  parentRunId?: string\n  /** Client-declared tools to advertise in the request payload. */\n  clientTools?: Array<{\n    name: string\n    description: string\n    parameters: unknown\n  }>\n  /** Arbitrary user-controlled passthrough data. */\n  forwardedProps?: Record<string, unknown>\n}\n\nexport interface ConnectConnectionAdapter {\n  /**\n   * Connect and return an async iterable of StreamChunks.\n   */\n  connect: (\n    messages: Array<UIMessage> | Array<ModelMessage>,\n    data?: Record<string, any>,\n    abortSignal?: AbortSignal,\n    runContext?: RunAgentInputContext,\n  ) => AsyncIterable<StreamChunk>\n}\n\nexport interface SubscribeConnectionAdapter {\n  /**\n   * Subscribe to stream chunks.\n   */\n  subscribe: (abortSignal?: AbortSignal) => AsyncIterable<StreamChunk>\n  /**\n   * Send a request; chunks arrive through subscribe().\n   */\n  send: (\n    messages: Array<UIMessage> | Array<ModelMessage>,\n    data?: Record<string, any>,\n    abortSignal?: AbortSignal,\n    runContext?: RunAgentInputContext,\n  ) => Promise<void>\n}\n\n/**\n * Connection adapter union.\n * Provide either `connect`, or `subscribe` + `send`.\n */\nexport type ConnectionAdapter =\n  | ConnectConnectionAdapter\n  | SubscribeConnectionAdapter\n\n/**\n * Normalize a ConnectionAdapter to subscribe/send operations.\n *\n * If a connection provides native subscribe/send, that mode is used.\n * Otherwise, connect() is wrapped using an async queue.\n */\nexport function normalizeConnectionAdapter(\n  connection: ConnectionAdapter | undefined,\n): SubscribeConnectionAdapter {\n  if (!connection) {\n    throw new Error('Connection adapter is required')\n  }\n\n  const hasConnect = 'connect' in connection\n  const hasSubscribe = 'subscribe' in connection\n  const hasSend = 'send' in connection\n\n  if (hasConnect && (hasSubscribe || hasSend)) {\n    throw new Error(\n      'Connection adapter must provide either connect or both subscribe and send, not both modes',\n    )\n  }\n\n  if (hasSubscribe && hasSend) {\n    return {\n      subscribe: connection.subscribe.bind(connection),\n      send: connection.send.bind(connection),\n    }\n  }\n\n  if (!hasConnect) {\n    throw new Error(\n      'Connection adapter must provide either connect or both subscribe and send',\n    )\n  }\n\n  // Legacy connect() wrapper\n  let activeBuffer: Array<StreamChunk> = []\n  let activeWaiters: Array<(chunk: StreamChunk | null) => void> = []\n\n  function push(chunk: StreamChunk): void {\n    const waiter = activeWaiters.shift()\n    if (waiter) {\n      waiter(chunk)\n    } else {\n      activeBuffer.push(chunk)\n    }\n  }\n\n  return {\n    subscribe(abortSignal?: AbortSignal): AsyncIterable<StreamChunk> {\n      // Transfer ownership to the latest subscriber so only one active\n      // subscribe() call receives chunks from the shared connect-wrapper queue.\n      const myBuffer: Array<StreamChunk> = activeBuffer.splice(0)\n      const myWaiters: Array<(chunk: StreamChunk | null) => void> = []\n      activeBuffer = myBuffer\n      activeWaiters = myWaiters\n\n      return (async function* () {\n        while (!abortSignal?.aborted) {\n          let chunk: StreamChunk | null\n          const buffered = myBuffer.shift()\n          if (buffered !== undefined) {\n            chunk = buffered\n          } else {\n            chunk = await new Promise<StreamChunk | null>((resolve) => {\n              const onAbort = () => resolve(null)\n              myWaiters.push((c) => {\n                abortSignal?.removeEventListener('abort', onAbort)\n                resolve(c)\n              })\n              abortSignal?.addEventListener('abort', onAbort, { once: true })\n            })\n          }\n          if (chunk !== null) yield chunk\n        }\n      })()\n    },\n    async send(messages, data, abortSignal, runContext) {\n      let hasTerminalEvent = false\n      let upstreamThreadId: string | undefined\n      let upstreamRunId: string | undefined\n      try {\n        const stream = connection.connect(\n          messages,\n          data,\n          abortSignal,\n          runContext,\n        )\n        for await (const chunk of stream) {\n          if ('threadId' in chunk && typeof chunk.threadId === 'string') {\n            upstreamThreadId = chunk.threadId\n          }\n          if ('runId' in chunk && typeof chunk.runId === 'string') {\n            upstreamRunId = chunk.runId\n          }\n          if (chunk.type === 'RUN_FINISHED' || chunk.type === 'RUN_ERROR') {\n            hasTerminalEvent = true\n          }\n          push(chunk)\n        }\n\n        // If the connect stream ended cleanly without a terminal event,\n        // synthesize RUN_FINISHED so request-scoped consumers can complete.\n        // Reuse the caller's threadId/runId so client-side activeRunIds tracking matches.\n        if (!abortSignal?.aborted && !hasTerminalEvent) {\n          const synthetic: RunFinishedEvent = {\n            type: EventType.RUN_FINISHED,\n            threadId: requireSyntheticId(\n              upstreamThreadId ?? runContext?.threadId,\n              'threadId',\n            ),\n            runId: requireSyntheticId(\n              upstreamRunId ?? runContext?.runId,\n              'runId',\n            ),\n            model: 'connect-wrapper',\n            timestamp: Date.now(),\n            finishReason: 'stop',\n          }\n          push(synthetic)\n        }\n      } catch (err) {\n        if (!abortSignal?.aborted && !hasTerminalEvent) {\n          const message =\n            err instanceof Error ? err.message : 'Unknown error in connect()'\n          const synthetic: RunErrorEvent = {\n            type: EventType.RUN_ERROR,\n            threadId: requireSyntheticId(\n              upstreamThreadId ?? runContext?.threadId,\n              'threadId',\n            ),\n            runId: requireSyntheticId(\n              upstreamRunId ?? runContext?.runId,\n              'runId',\n            ),\n            timestamp: Date.now(),\n            message,\n          }\n          push(synthetic)\n        }\n        throw err\n      }\n    },\n  }\n}\n\n/**\n * Options for fetch-based connection adapters\n */\nexport interface FetchConnectionOptions {\n  headers?: Record<string, string> | Headers\n  credentials?: RequestCredentials\n  signal?: AbortSignal\n  body?: Record<string, any>\n  fetchClient?: typeof globalThis.fetch\n}\n\n/**\n * Create a Server-Sent Events connection adapter\n *\n * @param url - The API endpoint URL (or a function that returns the URL)\n * @param options - Fetch options (headers, credentials, body, etc.) or a function that returns options (can be async)\n * @returns A connection adapter for SSE streams\n *\n * @example\n * ```typescript\n * // Static URL\n * const connection = fetchServerSentEvents('/api/chat');\n *\n * // Dynamic URL\n * const connection = fetchServerSentEvents(() => `/api/chat?user=${userId}`);\n *\n * // With options\n * const connection = fetchServerSentEvents('/api/chat', {\n *   headers: { 'Authorization': 'Bearer token' }\n * });\n *\n * // With dynamic options\n * const connection = fetchServerSentEvents('/api/chat', () => ({\n *   headers: { 'Authorization': `Bearer ${getToken()}` }\n * }));\n *\n * // With additional body data\n * const connection = fetchServerSentEvents('/api/chat', async () => ({\n *   body: {\n *     provider: 'openai',\n *     model: 'gpt-4o',\n *   }\n * }));\n * ```\n */\nexport function fetchServerSentEvents(\n  url: string | (() => string),\n  options:\n    | FetchConnectionOptions\n    | (() => FetchConnectionOptions | Promise<FetchConnectionOptions>) = {},\n): ConnectConnectionAdapter {\n  return {\n    async *connect(messages, data, abortSignal, runContext) {\n      // Resolve URL and options if they are functions\n      const resolvedUrl = typeof url === 'function' ? url() : url\n      const resolvedOptions =\n        typeof options === 'function' ? await options() : options\n\n      const requestHeaders: Record<string, string> = {\n        'Content-Type': 'application/json',\n        ...mergeHeaders(resolvedOptions.headers),\n      }\n\n      // Build AG-UI RunAgentInput payload.\n      //\n      // Precedence (later spreads win): static adapter `body` is the base,\n      // overridden by `runContext.forwardedProps` (constructor body /\n      // forwardedProps options), overridden by per-message `data` passed\n      // to `connection.send`. Runtime values win over static config —\n      // this matches the documented \"forwardedProps wins\" semantic.\n      const wireMessages = uiMessagesToWire(messages as Array<UIMessage>)\n      const forwardedProps = {\n        ...resolvedOptions.body,\n        ...(runContext?.forwardedProps ?? {}),\n        ...data,\n      }\n      const requestBody = {\n        threadId: runContext?.threadId ?? generateRunId('thread'),\n        runId: runContext?.runId ?? generateRunId('run'),\n        ...(runContext?.parentRunId !== undefined && {\n          parentRunId: runContext.parentRunId,\n        }),\n        state: {},\n        messages: wireMessages,\n        tools: runContext?.clientTools ?? [],\n        context: [],\n        forwardedProps,\n        // Backward-compat mirror of `forwardedProps` under the legacy\n        // field name `data`. Server endpoints that have not migrated\n        // off the pre-AG-UI shape (`{ messages, data }`) keep working.\n        // AG-UI strict consumers strip this via `RunAgentInputSchema`\n        // (see `chatParamsFromRequestBody`). Will be removed when the\n        // legacy `body` client option is dropped.\n        // Shallow-cloned so that downstream mutation of `data` (e.g.\n        // by a logging interceptor or fetch wrapper) cannot corrupt\n        // `forwardedProps` and vice versa.\n        data: { ...forwardedProps },\n      }\n\n      const fetchClient = resolvedOptions.fetchClient ?? fetch\n      // `RequestInit.signal` is typed `AbortSignal | null` (no `undefined`\n      // under `exactOptionalPropertyTypes`), so spread it conditionally\n      // rather than passing `undefined` explicitly.\n      const signal = abortSignal || resolvedOptions.signal\n      const response = await fetchClient(resolvedUrl, {\n        method: 'POST',\n        headers: requestHeaders,\n        body: JSON.stringify(requestBody),\n        credentials: resolvedOptions.credentials || 'same-origin',\n        ...(signal ? { signal } : {}),\n      })\n\n      yield* responseToSSEChunks(response, abortSignal)\n    },\n  }\n}\n\n/**\n * Create an HTTP streaming connection adapter (for raw streaming without SSE format)\n *\n * @param url - The API endpoint URL (or a function that returns the URL)\n * @param options - Fetch options (headers, credentials, body, etc.) or a function that returns options (can be async)\n * @returns A connection adapter for HTTP streams\n *\n * @example\n * ```typescript\n * // Static URL\n * const connection = fetchHttpStream('/api/chat');\n *\n * // Dynamic URL\n * const connection = fetchHttpStream(() => `/api/chat?user=${userId}`);\n *\n * // With options\n * const connection = fetchHttpStream('/api/chat', {\n *   headers: { 'Authorization': 'Bearer token' }\n * });\n *\n * // With dynamic options\n * const connection = fetchHttpStream('/api/chat', () => ({\n *   headers: { 'Authorization': `Bearer ${getToken()}` }\n * }));\n *\n * // With additional body data\n * const connection = fetchHttpStream('/api/chat', async () => ({\n *   body: {\n *     provider: 'openai',\n *     model: 'gpt-4o',\n *   }\n * }));\n * ```\n */\nexport function fetchHttpStream(\n  url: string | (() => string),\n  options:\n    | FetchConnectionOptions\n    | (() => FetchConnectionOptions | Promise<FetchConnectionOptions>) = {},\n): ConnectConnectionAdapter {\n  return {\n    async *connect(messages, data, abortSignal, runContext) {\n      // Resolve URL and options if they are functions\n      const resolvedUrl = typeof url === 'function' ? url() : url\n      const resolvedOptions =\n        typeof options === 'function' ? await options() : options\n\n      const requestHeaders: Record<string, string> = {\n        'Content-Type': 'application/json',\n        ...mergeHeaders(resolvedOptions.headers),\n      }\n\n      // Build AG-UI RunAgentInput payload.\n      //\n      // Precedence (later spreads win): static adapter `body` is the base,\n      // overridden by `runContext.forwardedProps` (constructor body /\n      // forwardedProps options), overridden by per-message `data` passed\n      // to `connection.send`. Runtime values win over static config —\n      // this matches the documented \"forwardedProps wins\" semantic.\n      const wireMessages = uiMessagesToWire(messages as Array<UIMessage>)\n      const forwardedProps = {\n        ...resolvedOptions.body,\n        ...(runContext?.forwardedProps ?? {}),\n        ...data,\n      }\n      const requestBody = {\n        threadId: runContext?.threadId ?? generateRunId('thread'),\n        runId: runContext?.runId ?? generateRunId('run'),\n        ...(runContext?.parentRunId !== undefined && {\n          parentRunId: runContext.parentRunId,\n        }),\n        state: {},\n        messages: wireMessages,\n        tools: runContext?.clientTools ?? [],\n        context: [],\n        forwardedProps,\n        // Backward-compat mirror of `forwardedProps` under the legacy\n        // field name `data`. Server endpoints that have not migrated\n        // off the pre-AG-UI shape (`{ messages, data }`) keep working.\n        // AG-UI strict consumers strip this via `RunAgentInputSchema`\n        // (see `chatParamsFromRequestBody`). Will be removed when the\n        // legacy `body` client option is dropped.\n        // Shallow-cloned so that downstream mutation of `data` (e.g.\n        // by a logging interceptor or fetch wrapper) cannot corrupt\n        // `forwardedProps` and vice versa.\n        data: { ...forwardedProps },\n      }\n\n      const fetchClient = resolvedOptions.fetchClient ?? fetch\n      // `RequestInit.signal` is typed `AbortSignal | null` (no `undefined`\n      // under `exactOptionalPropertyTypes`), so spread it conditionally\n      // rather than passing `undefined` explicitly.\n      const signal = abortSignal || resolvedOptions.signal\n      const response = await fetchClient(resolvedUrl, {\n        method: 'POST',\n        headers: requestHeaders,\n        body: JSON.stringify(requestBody),\n        credentials: resolvedOptions.credentials || 'same-origin',\n        ...(signal ? { signal } : {}),\n      })\n\n      if (!response.ok) {\n        throw new Error(\n          `HTTP error! status: ${response.status} ${response.statusText}`,\n        )\n      }\n\n      // Parse raw HTTP stream (newline-delimited JSON)\n      const reader = response.body?.getReader()\n      if (!reader) {\n        throw new Error('Response body is not readable')\n      }\n\n      for await (const line of readStreamLines(reader, abortSignal)) {\n        yield JSON.parse(line) as StreamChunk\n      }\n    },\n  }\n}\n\n/**\n * Create a direct stream connection adapter (for server functions or direct streams)\n *\n * @param streamFactory - A function that returns an async iterable of StreamChunks\n * @returns A connection adapter for direct streams\n *\n * @example\n * ```typescript\n * // With TanStack Start server function\n * const connection = stream(() => serverFunction({ messages }));\n *\n * const client = new ChatClient({ connection });\n * ```\n */\nexport function stream(\n  streamFactory: (\n    messages: Array<UIMessage> | Array<ModelMessage>,\n    data?: Record<string, any>,\n    abortSignal?: AbortSignal,\n  ) => AsyncIterable<StreamChunk>,\n): ConnectConnectionAdapter {\n  return {\n    async *connect(messages, data, abortSignal) {\n      // Pass messages as-is (UIMessages with parts preserved)\n      // Server-side chat() handles conversion to ModelMessages\n      yield* streamFactory(messages, data, abortSignal)\n    },\n  }\n}\n\n/**\n * Wrap a `ChatFetcher` as a `ConnectConnectionAdapter` so the chat client can\n * consume it through the same `subscribe`/`send` plumbing used for SSE /\n * HTTP-stream / RPC connections. May return either a `Response` (parsed as\n * SSE) or an `AsyncIterable<StreamChunk>` (yielded directly).\n *\n * @internal\n */\nexport function fetcherToConnectionAdapter(\n  fetcher: ChatFetcher,\n): ConnectConnectionAdapter {\n  return {\n    async *connect(messages, data, abortSignal, runContext) {\n      if (!abortSignal) {\n        throw new Error(\n          'fetcherToConnectionAdapter requires an AbortSignal — the chat client always supplies one.',\n        )\n      }\n      if (!runContext) {\n        throw new Error(\n          'fetcherToConnectionAdapter requires a RunAgentInputContext — the chat client always supplies one.',\n        )\n      }\n      const uiMessages = messages as Array<UIMessage>\n      const result = await fetcher(\n        {\n          messages: uiMessages,\n          data,\n          threadId: runContext.threadId,\n          runId: runContext.runId,\n        },\n        { signal: abortSignal },\n      )\n      if (result instanceof Response) {\n        yield* responseToSSEChunks(result, abortSignal)\n      } else {\n        yield* abortableIterable(result, abortSignal)\n      }\n    },\n  }\n}\n\n/**\n * Wrap an AsyncIterable so iteration aborts when `signal` fires. Without\n * this, a fetcher that returns a generator ignoring its signal would leave\n * the for-await loop hanging until the iterable naturally ends.\n */\nasync function* abortableIterable<T>(\n  iterable: AsyncIterable<T>,\n  signal: AbortSignal,\n): AsyncGenerator<T> {\n  if (signal.aborted) return\n  const iterator = iterable[Symbol.asyncIterator]()\n  const abortPromise = new Promise<{ done: true; value: undefined }>(\n    (resolve) => {\n      signal.addEventListener(\n        'abort',\n        () => resolve({ done: true, value: undefined }),\n        { once: true },\n      )\n    },\n  )\n  try {\n    // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition\n    while (true) {\n      const result = await Promise.race([iterator.next(), abortPromise])\n      if (result.done) return\n      yield result.value\n    }\n  } finally {\n    await iterator.return?.()\n  }\n}\n\n/**\n * Create an RPC stream connection adapter (for RPC-based streaming like Cap'n Web RPC)\n *\n * @param rpcCall - A function that accepts messages and returns an async iterable of StreamChunks\n * @returns A connection adapter for RPC streams\n *\n * @example\n * ```typescript\n * // With Cap'n Web RPC\n * const connection = rpcStream((messages, data) =>\n *   api.streamMurfResponse(messages, data)\n * );\n *\n * const client = new ChatClient({ connection });\n * ```\n */\nexport function rpcStream(\n  rpcCall: (\n    messages: Array<UIMessage> | Array<ModelMessage>,\n    data?: Record<string, any>,\n    abortSignal?: AbortSignal,\n  ) => AsyncIterable<StreamChunk>,\n): ConnectConnectionAdapter {\n  return {\n    async *connect(messages, data, abortSignal) {\n      // Pass messages as-is (UIMessages with parts preserved)\n      // Server-side chat() handles conversion to ModelMessages\n      yield* rpcCall(messages, data, abortSignal)\n    },\n  }\n}\n"],"names":["stream"],"mappings":";AAeO,MAAM,6BAA6B,MAAM;AAAA,EAC9C,cAAc;AACZ;AAAA,MACE;AAAA,IAAA;AAEF,SAAK,OAAO;AAAA,EACd;AACF;AAEA,SAAS,cAAc,QAAwB;AAC7C,SAAO,GAAG,MAAM,IAAI,KAAK,IAAA,CAAK,IAAI,KAAK,OAAA,EAAS,SAAS,EAAE,EAAE,MAAM,GAAG,CAAC,CAAC;AAC1E;AAQA,SAAS,mBACP,OACA,OACQ;AACR,MAAI,CAAC,OAAO;AACV,UAAM,IAAI;AAAA,MACR,qCAAqC,KAAK;AAAA,IAAA;AAAA,EAE9C;AACA,SAAO;AACT;AAKA,SAAS,aACP,eACwB;AACxB,MAAI,CAAC,eAAe;AAClB,WAAO,CAAA;AAAA,EACT;AACA,MAAI,yBAAyB,SAAS;AACpC,UAAM,SAAiC,CAAA;AACvC,kBAAc,QAAQ,CAAC,OAAO,QAAQ;AACpC,aAAO,GAAG,IAAI;AAAA,IAChB,CAAC;AACD,WAAO;AAAA,EACT;AACA,SAAO;AACT;AAKA,gBAAgB,gBACd,QACA,aACwB;AACxB,MAAI;AACF,UAAM,UAAU,IAAI,YAAA;AACpB,QAAI,SAAS;AAEb,WAAO,CAAC,aAAa,SAAS;AAC5B,YAAM,EAAE,MAAM,MAAA,IAAU,MAAM,OAAO,KAAA;AACrC,UAAI,KAAM;AAEV,gBAAU,QAAQ,OAAO,OAAO,EAAE,QAAQ,MAAM;AAChD,YAAM,QAAQ,OAAO,MAAM,IAAI;AAG/B,eAAS,MAAM,SAAS;AAExB,iBAAW,QAAQ,OAAO;AACxB,YAAI,KAAK,QAAQ;AACf,gBAAM;AAAA,QACR;AAAA,MACF;AAAA,IACF;AAOA,QAAI,OAAO,KAAA,KAAU,CAAC,aAAa,SAAS;AAC1C,YAAM,IAAI,qBAAA;AAAA,IACZ;AAAA,EACF,UAAA;AACE,WAAO,YAAA;AAAA,EACT;AACF;AAcA,gBAAgB,oBACd,UACA,aAC6B;AAC7B,MAAI,CAAC,SAAS,IAAI;AAChB,UAAM,IAAI;AAAA,MACR,uBAAuB,SAAS,MAAM,IAAI,SAAS,UAAU;AAAA,IAAA;AAAA,EAEjE;AACA,QAAM,SAAS,SAAS,MAAM,UAAA;AAC9B,MAAI,CAAC,QAAQ;AACX,UAAM,IAAI,MAAM,+BAA+B;AAAA,EACjD;AACA,MAAI;AACJ,MAAI;AACJ,MAAI;AACJ,mBAAiB,QAAQ,gBAAgB,QAAQ,WAAW,GAAG;AAC7D,QACE,KAAK,WAAW,GAAG,KACnB,KAAK,WAAW,QAAQ,KACxB,KAAK,WAAW,KAAK,KACrB,KAAK,WAAW,QAAQ,GACxB;AACA;AAAA,IACF;AACA,UAAM,OAAO,KAAK,WAAW,QAAQ,IAAI,KAAK,MAAM,CAAC,IAAI;AACzD,QAAI,SAAS,UAAU;AACrB,YAAM,YAA8B;AAAA,QAClC,MAAM,UAAU;AAAA,QAChB,UAAU,gBAAgB;AAAA,QAC1B,OAAO,aAAa;AAAA,QACpB,OAAO,aAAa;AAAA,QACpB,WAAW,KAAK,IAAA;AAAA,QAChB,cAAc;AAAA,MAAA;AAEhB,YAAM;AACN;AAAA,IACF;AACA,UAAM,QAAQ,KAAK,MAAM,IAAI;AAC7B,QAAI,cAAc,SAAS,OAAO,MAAM,aAAa,UAAU;AAC7D,qBAAe,MAAM;AAAA,IACvB;AACA,QAAI,WAAW,SAAS,OAAO,MAAM,UAAU,UAAU;AACvD,kBAAY,MAAM;AAAA,IACpB;AACA,QAAI,WAAW,SAAS,OAAO,MAAM,UAAU,UAAU;AACvD,kBAAY,MAAM;AAAA,IACpB;AACA,UAAM;AAAA,EACR;AACF;AA+DO,SAAS,2BACd,YAC4B;AAC5B,MAAI,CAAC,YAAY;AACf,UAAM,IAAI,MAAM,gCAAgC;AAAA,EAClD;AAEA,QAAM,aAAa,aAAa;AAChC,QAAM,eAAe,eAAe;AACpC,QAAM,UAAU,UAAU;AAE1B,MAAI,eAAe,gBAAgB,UAAU;AAC3C,UAAM,IAAI;AAAA,MACR;AAAA,IAAA;AAAA,EAEJ;AAEA,MAAI,gBAAgB,SAAS;AAC3B,WAAO;AAAA,MACL,WAAW,WAAW,UAAU,KAAK,UAAU;AAAA,MAC/C,MAAM,WAAW,KAAK,KAAK,UAAU;AAAA,IAAA;AAAA,EAEzC;AAEA,MAAI,CAAC,YAAY;AACf,UAAM,IAAI;AAAA,MACR;AAAA,IAAA;AAAA,EAEJ;AAGA,MAAI,eAAmC,CAAA;AACvC,MAAI,gBAA4D,CAAA;AAEhE,WAAS,KAAK,OAA0B;AACtC,UAAM,SAAS,cAAc,MAAA;AAC7B,QAAI,QAAQ;AACV,aAAO,KAAK;AAAA,IACd,OAAO;AACL,mBAAa,KAAK,KAAK;AAAA,IACzB;AAAA,EACF;AAEA,SAAO;AAAA,IACL,UAAU,aAAuD;AAG/D,YAAM,WAA+B,aAAa,OAAO,CAAC;AAC1D,YAAM,YAAwD,CAAA;AAC9D,qBAAe;AACf,sBAAgB;AAEhB,cAAQ,mBAAmB;AACzB,eAAO,CAAC,aAAa,SAAS;AAC5B,cAAI;AACJ,gBAAM,WAAW,SAAS,MAAA;AAC1B,cAAI,aAAa,QAAW;AAC1B,oBAAQ;AAAA,UACV,OAAO;AACL,oBAAQ,MAAM,IAAI,QAA4B,CAAC,YAAY;AACzD,oBAAM,UAAU,MAAM,QAAQ,IAAI;AAClC,wBAAU,KAAK,CAAC,MAAM;AACpB,6BAAa,oBAAoB,SAAS,OAAO;AACjD,wBAAQ,CAAC;AAAA,cACX,CAAC;AACD,2BAAa,iBAAiB,SAAS,SAAS,EAAE,MAAM,MAAM;AAAA,YAChE,CAAC;AAAA,UACH;AACA,cAAI,UAAU,KAAM,OAAM;AAAA,QAC5B;AAAA,MACF,GAAA;AAAA,IACF;AAAA,IACA,MAAM,KAAK,UAAU,MAAM,aAAa,YAAY;AAClD,UAAI,mBAAmB;AACvB,UAAI;AACJ,UAAI;AACJ,UAAI;AACF,cAAMA,UAAS,WAAW;AAAA,UACxB;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,QAAA;AAEF,yBAAiB,SAASA,SAAQ;AAChC,cAAI,cAAc,SAAS,OAAO,MAAM,aAAa,UAAU;AAC7D,+BAAmB,MAAM;AAAA,UAC3B;AACA,cAAI,WAAW,SAAS,OAAO,MAAM,UAAU,UAAU;AACvD,4BAAgB,MAAM;AAAA,UACxB;AACA,cAAI,MAAM,SAAS,kBAAkB,MAAM,SAAS,aAAa;AAC/D,+BAAmB;AAAA,UACrB;AACA,eAAK,KAAK;AAAA,QACZ;AAKA,YAAI,CAAC,aAAa,WAAW,CAAC,kBAAkB;AAC9C,gBAAM,YAA8B;AAAA,YAClC,MAAM,UAAU;AAAA,YAChB,UAAU;AAAA,cACR,oBAAoB,YAAY;AAAA,cAChC;AAAA,YAAA;AAAA,YAEF,OAAO;AAAA,cACL,iBAAiB,YAAY;AAAA,cAC7B;AAAA,YAAA;AAAA,YAEF,OAAO;AAAA,YACP,WAAW,KAAK,IAAA;AAAA,YAChB,cAAc;AAAA,UAAA;AAEhB,eAAK,SAAS;AAAA,QAChB;AAAA,MACF,SAAS,KAAK;AACZ,YAAI,CAAC,aAAa,WAAW,CAAC,kBAAkB;AAC9C,gBAAM,UACJ,eAAe,QAAQ,IAAI,UAAU;AACvC,gBAAM,YAA2B;AAAA,YAC/B,MAAM,UAAU;AAAA,YAChB,UAAU;AAAA,cACR,oBAAoB,YAAY;AAAA,cAChC;AAAA,YAAA;AAAA,YAEF,OAAO;AAAA,cACL,iBAAiB,YAAY;AAAA,cAC7B;AAAA,YAAA;AAAA,YAEF,WAAW,KAAK,IAAA;AAAA,YAChB;AAAA,UAAA;AAEF,eAAK,SAAS;AAAA,QAChB;AACA,cAAM;AAAA,MACR;AAAA,IACF;AAAA,EAAA;AAEJ;AA+CO,SAAS,sBACd,KACA,UAEuE,IAC7C;AAC1B,SAAO;AAAA,IACL,OAAO,QAAQ,UAAU,MAAM,aAAa,YAAY;AAEtD,YAAM,cAAc,OAAO,QAAQ,aAAa,QAAQ;AACxD,YAAM,kBACJ,OAAO,YAAY,aAAa,MAAM,YAAY;AAEpD,YAAM,iBAAyC;AAAA,QAC7C,gBAAgB;AAAA,QAChB,GAAG,aAAa,gBAAgB,OAAO;AAAA,MAAA;AAUzC,YAAM,eAAe,iBAAiB,QAA4B;AAClE,YAAM,iBAAiB;AAAA,QACrB,GAAG,gBAAgB;AAAA,QACnB,GAAI,YAAY,kBAAkB,CAAA;AAAA,QAClC,GAAG;AAAA,MAAA;AAEL,YAAM,cAAc;AAAA,QAClB,UAAU,YAAY,YAAY,cAAc,QAAQ;AAAA,QACxD,OAAO,YAAY,SAAS,cAAc,KAAK;AAAA,QAC/C,GAAI,YAAY,gBAAgB,UAAa;AAAA,UAC3C,aAAa,WAAW;AAAA,QAAA;AAAA,QAE1B,OAAO,CAAA;AAAA,QACP,UAAU;AAAA,QACV,OAAO,YAAY,eAAe,CAAA;AAAA,QAClC,SAAS,CAAA;AAAA,QACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,QAUA,MAAM,EAAE,GAAG,eAAA;AAAA,MAAe;AAG5B,YAAM,cAAc,gBAAgB,eAAe;AAInD,YAAM,SAAS,eAAe,gBAAgB;AAC9C,YAAM,WAAW,MAAM,YAAY,aAAa;AAAA,QAC9C,QAAQ;AAAA,QACR,SAAS;AAAA,QACT,MAAM,KAAK,UAAU,WAAW;AAAA,QAChC,aAAa,gBAAgB,eAAe;AAAA,QAC5C,GAAI,SAAS,EAAE,WAAW,CAAA;AAAA,MAAC,CAC5B;AAED,aAAO,oBAAoB,UAAU,WAAW;AAAA,IAClD;AAAA,EAAA;AAEJ;AAoCO,SAAS,gBACd,KACA,UAEuE,IAC7C;AAC1B,SAAO;AAAA,IACL,OAAO,QAAQ,UAAU,MAAM,aAAa,YAAY;AAEtD,YAAM,cAAc,OAAO,QAAQ,aAAa,QAAQ;AACxD,YAAM,kBACJ,OAAO,YAAY,aAAa,MAAM,YAAY;AAEpD,YAAM,iBAAyC;AAAA,QAC7C,gBAAgB;AAAA,QAChB,GAAG,aAAa,gBAAgB,OAAO;AAAA,MAAA;AAUzC,YAAM,eAAe,iBAAiB,QAA4B;AAClE,YAAM,iBAAiB;AAAA,QACrB,GAAG,gBAAgB;AAAA,QACnB,GAAI,YAAY,kBAAkB,CAAA;AAAA,QAClC,GAAG;AAAA,MAAA;AAEL,YAAM,cAAc;AAAA,QAClB,UAAU,YAAY,YAAY,cAAc,QAAQ;AAAA,QACxD,OAAO,YAAY,SAAS,cAAc,KAAK;AAAA,QAC/C,GAAI,YAAY,gBAAgB,UAAa;AAAA,UAC3C,aAAa,WAAW;AAAA,QAAA;AAAA,QAE1B,OAAO,CAAA;AAAA,QACP,UAAU;AAAA,QACV,OAAO,YAAY,eAAe,CAAA;AAAA,QAClC,SAAS,CAAA;AAAA,QACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,QAUA,MAAM,EAAE,GAAG,eAAA;AAAA,MAAe;AAG5B,YAAM,cAAc,gBAAgB,eAAe;AAInD,YAAM,SAAS,eAAe,gBAAgB;AAC9C,YAAM,WAAW,MAAM,YAAY,aAAa;AAAA,QAC9C,QAAQ;AAAA,QACR,SAAS;AAAA,QACT,MAAM,KAAK,UAAU,WAAW;AAAA,QAChC,aAAa,gBAAgB,eAAe;AAAA,QAC5C,GAAI,SAAS,EAAE,WAAW,CAAA;AAAA,MAAC,CAC5B;AAED,UAAI,CAAC,SAAS,IAAI;AAChB,cAAM,IAAI;AAAA,UACR,uBAAuB,SAAS,MAAM,IAAI,SAAS,UAAU;AAAA,QAAA;AAAA,MAEjE;AAGA,YAAM,SAAS,SAAS,MAAM,UAAA;AAC9B,UAAI,CAAC,QAAQ;AACX,cAAM,IAAI,MAAM,+BAA+B;AAAA,MACjD;AAEA,uBAAiB,QAAQ,gBAAgB,QAAQ,WAAW,GAAG;AAC7D,cAAM,KAAK,MAAM,IAAI;AAAA,MACvB;AAAA,IACF;AAAA,EAAA;AAEJ;AAgBO,SAAS,OACd,eAK0B;AAC1B,SAAO;AAAA,IACL,OAAO,QAAQ,UAAU,MAAM,aAAa;AAG1C,aAAO,cAAc,UAAU,MAAM,WAAW;AAAA,IAClD;AAAA,EAAA;AAEJ;AAUO,SAAS,2BACd,SAC0B;AAC1B,SAAO;AAAA,IACL,OAAO,QAAQ,UAAU,MAAM,aAAa,YAAY;AACtD,UAAI,CAAC,aAAa;AAChB,cAAM,IAAI;AAAA,UACR;AAAA,QAAA;AAAA,MAEJ;AACA,UAAI,CAAC,YAAY;AACf,cAAM,IAAI;AAAA,UACR;AAAA,QAAA;AAAA,MAEJ;AACA,YAAM,aAAa;AACnB,YAAM,SAAS,MAAM;AAAA,QACnB;AAAA,UACE,UAAU;AAAA,UACV;AAAA,UACA,UAAU,WAAW;AAAA,UACrB,OAAO,WAAW;AAAA,QAAA;AAAA,QAEpB,EAAE,QAAQ,YAAA;AAAA,MAAY;AAExB,UAAI,kBAAkB,UAAU;AAC9B,eAAO,oBAAoB,QAAQ,WAAW;AAAA,MAChD,OAAO;AACL,eAAO,kBAAkB,QAAQ,WAAW;AAAA,MAC9C;AAAA,IACF;AAAA,EAAA;AAEJ;AAOA,gBAAgB,kBACd,UACA,QACmB;AACnB,MAAI,OAAO,QAAS;AACpB,QAAM,WAAW,SAAS,OAAO,aAAa,EAAA;AAC9C,QAAM,eAAe,IAAI;AAAA,IACvB,CAAC,YAAY;AACX,aAAO;AAAA,QACL;AAAA,QACA,MAAM,QAAQ,EAAE,MAAM,MAAM,OAAO,QAAW;AAAA,QAC9C,EAAE,MAAM,KAAA;AAAA,MAAK;AAAA,IAEjB;AAAA,EAAA;AAEF,MAAI;AAEF,WAAO,MAAM;AACX,YAAM,SAAS,MAAM,QAAQ,KAAK,CAAC,SAAS,KAAA,GAAQ,YAAY,CAAC;AACjE,UAAI,OAAO,KAAM;AACjB,YAAM,OAAO;AAAA,IACf;AAAA,EACF,UAAA;AACE,UAAM,SAAS,SAAA;AAAA,EACjB;AACF;AAkBO,SAAS,UACd,SAK0B;AAC1B,SAAO;AAAA,IACL,OAAO,QAAQ,UAAU,MAAM,aAAa;AAG1C,aAAO,QAAQ,UAAU,MAAM,WAAW;AAAA,IAC5C;AAAA,EAAA;AAEJ;"}
+{"version":3,"file":"connection-adapters.js","sources":["../../src/connection-adapters.ts"],"sourcesContent":["import { EventType, uiMessagesToWire } from '@tanstack/ai/client'\nimport {\n  createResponseStreamTextDecoder,\n  getResponseStreamReader,\n} from './response-stream'\nimport { parseSseDataLine } from './sse-utils'\nimport type {\n  ModelMessage,\n  RunErrorEvent,\n  RunFinishedEvent,\n  StreamChunk,\n  UIMessage,\n} from '@tanstack/ai/client'\nimport type { ChatFetcher } from './types'\n\n/**\n * Thrown when an SSE/HTTP stream ends with a non-empty unterminated buffer.\n * Indicates the connection was cut mid-line (server crash, dropped TCP, proxy\n * timeout) so the partial content cannot be safely parsed.\n */\nexport class StreamTruncatedError extends Error {\n  constructor() {\n    super(\n      'Stream ended with unterminated trailing data — connection was likely cut short.',\n    )\n    this.name = 'StreamTruncatedError'\n  }\n}\n\nfunction generateRunId(prefix: string): string {\n  return `${prefix}-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`\n}\n\n/**\n * Asserts an id is present when synthesizing a terminal event. The chat\n * client always supplies `runContext.threadId` / `runContext.runId`, so an\n * absent id at this layer indicates the adapter was wired up by a caller\n * that bypassed that contract — surface it rather than fabricating one.\n */\nfunction requireSyntheticId(\n  value: string | undefined,\n  field: 'threadId' | 'runId',\n): string {\n  if (!value) {\n    throw new Error(\n      `Cannot synthesize terminal event: ${field} not supplied via runContext and not observed in the upstream stream.`,\n    )\n  }\n  return value\n}\n\n/**\n * Merge custom headers into request headers\n */\nfunction mergeHeaders(\n  customHeaders?: Record<string, string> | Headers,\n): Record<string, string> {\n  if (!customHeaders) {\n    return {}\n  }\n  if (customHeaders instanceof Headers) {\n    const result: Record<string, string> = {}\n    customHeaders.forEach((value, key) => {\n      result[key] = value\n    })\n    return result\n  }\n  return customHeaders\n}\n\n/**\n * Read lines from a stream (newline-delimited)\n */\nasync function* readStreamLines(\n  reader: ReadableStreamDefaultReader<Uint8Array>,\n  abortSignal?: AbortSignal,\n): AsyncGenerator<string> {\n  try {\n    const decoder = createResponseStreamTextDecoder()\n    let buffer = ''\n\n    while (!abortSignal?.aborted) {\n      const { done, value } = await reader.read()\n      if (done) break\n\n      buffer += decoder.decode(value, { stream: true })\n      const lines = buffer.split('\\n')\n\n      // Keep the last incomplete line in the buffer\n      buffer = lines.pop() || ''\n\n      for (const line of lines) {\n        if (line.trim()) {\n          yield line\n        }\n      }\n    }\n\n    // A non-empty trailing buffer means the connection was cut mid-line.\n    // Surface this as an error so the chat client transitions to 'error'\n    // state instead of silently presenting a partial stream as success.\n    // Skip when the consumer aborted — a user-initiated stop() interrupting\n    // mid-line is expected, not a truncation bug.\n    if (buffer.trim() && !abortSignal?.aborted) {\n      throw new StreamTruncatedError()\n    }\n  } finally {\n    reader.releaseLock()\n  }\n}\n\n/**\n * Yield StreamChunks parsed from an SSE Response body.\n *\n * Accepts either `data: {...}` lines or bare JSON lines. Skips comments\n * starting with `:` (proxies and CDNs inject these as keepalives) and the\n * `event:` / `id:` / `retry:` SSE control fields. A `[DONE]` sentinel is\n * treated as a terminal event: a synthesized RUN_FINISHED is yielded using\n * the most recent upstream `threadId` / `runId`, ensuring the consumer sees\n * a clean terminal event with real correlation ids.\n *\n * A JSON parse failure throws — the consumer surfaces it as an error.\n */\nasync function* responseToSSEChunks(\n  response: Response,\n  abortSignal?: AbortSignal,\n): AsyncGenerator<StreamChunk> {\n  if (!response.ok) {\n    throw new Error(\n      `HTTP error! status: ${response.status} ${response.statusText}`,\n    )\n  }\n  const reader = getResponseStreamReader(response)\n  let lastThreadId: string | undefined\n  let lastRunId: string | undefined\n  let lastModel: string | undefined\n  for await (const line of readStreamLines(reader, abortSignal)) {\n    if (\n      line.startsWith(':') ||\n      line.startsWith('event:') ||\n      line.startsWith('id:') ||\n      line.startsWith('retry:')\n    ) {\n      continue\n    }\n    const data = parseSseDataLine(line)\n    if (data === '[DONE]') {\n      const synthetic: RunFinishedEvent = {\n        type: EventType.RUN_FINISHED,\n        threadId: lastThreadId ?? '',\n        runId: lastRunId ?? '',\n        model: lastModel ?? '',\n        timestamp: Date.now(),\n        finishReason: 'stop',\n      }\n      yield synthetic\n      return\n    }\n    const chunk = JSON.parse(data) as StreamChunk\n    if ('threadId' in chunk && typeof chunk.threadId === 'string') {\n      lastThreadId = chunk.threadId\n    }\n    if ('runId' in chunk && typeof chunk.runId === 'string') {\n      lastRunId = chunk.runId\n    }\n    if ('model' in chunk && typeof chunk.model === 'string') {\n      lastModel = chunk.model\n    }\n    yield chunk\n  }\n}\n\n/**\n * Per-send context provided by the chat client to the connection adapter.\n * The adapter combines this with serialized messages to build a full\n * AG-UI `RunAgentInput` payload.\n */\nexport interface RunAgentInputContext {\n  threadId: string\n  runId: string\n  parentRunId?: string\n  /** Client-declared tools to advertise in the request payload. */\n  clientTools?: Array<{\n    name: string\n    description: string\n    parameters: unknown\n  }>\n  /** Arbitrary user-controlled passthrough data. */\n  forwardedProps?: Record<string, unknown>\n}\n\nexport interface ConnectConnectionAdapter {\n  /**\n   * Connect and return an async iterable of StreamChunks.\n   */\n  connect: (\n    messages: Array<UIMessage> | Array<ModelMessage>,\n    data?: Record<string, any>,\n    abortSignal?: AbortSignal,\n    runContext?: RunAgentInputContext,\n  ) => AsyncIterable<StreamChunk>\n}\n\nexport interface SubscribeConnectionAdapter {\n  /**\n   * Subscribe to stream chunks.\n   */\n  subscribe: (abortSignal?: AbortSignal) => AsyncIterable<StreamChunk>\n  /**\n   * Send a request; chunks arrive through subscribe().\n   */\n  send: (\n    messages: Array<UIMessage> | Array<ModelMessage>,\n    data?: Record<string, any>,\n    abortSignal?: AbortSignal,\n    runContext?: RunAgentInputContext,\n  ) => Promise<void>\n}\n\n/**\n * Connection adapter union.\n * Provide either `connect`, or `subscribe` + `send`.\n */\nexport type ConnectionAdapter =\n  | ConnectConnectionAdapter\n  | SubscribeConnectionAdapter\n\n/**\n * Normalize a ConnectionAdapter to subscribe/send operations.\n *\n * If a connection provides native subscribe/send, that mode is used.\n * Otherwise, connect() is wrapped using an async queue.\n */\nexport function normalizeConnectionAdapter(\n  connection: ConnectionAdapter | undefined,\n): SubscribeConnectionAdapter {\n  if (!connection) {\n    throw new Error('Connection adapter is required')\n  }\n\n  const hasConnect = 'connect' in connection\n  const hasSubscribe = 'subscribe' in connection\n  const hasSend = 'send' in connection\n\n  if (hasConnect && (hasSubscribe || hasSend)) {\n    throw new Error(\n      'Connection adapter must provide either connect or both subscribe and send, not both modes',\n    )\n  }\n\n  if (hasSubscribe && hasSend) {\n    return {\n      subscribe: connection.subscribe.bind(connection),\n      send: connection.send.bind(connection),\n    }\n  }\n\n  if (!hasConnect) {\n    throw new Error(\n      'Connection adapter must provide either connect or both subscribe and send',\n    )\n  }\n\n  // Legacy connect() wrapper\n  let activeBuffer: Array<StreamChunk> = []\n  let activeWaiters: Array<(chunk: StreamChunk | null) => void> = []\n\n  function push(chunk: StreamChunk): void {\n    const waiter = activeWaiters.shift()\n    if (waiter) {\n      waiter(chunk)\n    } else {\n      activeBuffer.push(chunk)\n    }\n  }\n\n  return {\n    subscribe(abortSignal?: AbortSignal): AsyncIterable<StreamChunk> {\n      // Transfer ownership to the latest subscriber so only one active\n      // subscribe() call receives chunks from the shared connect-wrapper queue.\n      const myBuffer: Array<StreamChunk> = activeBuffer.splice(0)\n      const myWaiters: Array<(chunk: StreamChunk | null) => void> = []\n      activeBuffer = myBuffer\n      activeWaiters = myWaiters\n\n      return (async function* () {\n        while (!abortSignal?.aborted) {\n          let chunk: StreamChunk | null\n          const buffered = myBuffer.shift()\n          if (buffered !== undefined) {\n            chunk = buffered\n          } else {\n            chunk = await new Promise<StreamChunk | null>((resolve) => {\n              const onAbort = () => resolve(null)\n              myWaiters.push((c) => {\n                abortSignal?.removeEventListener('abort', onAbort)\n                resolve(c)\n              })\n              abortSignal?.addEventListener('abort', onAbort, { once: true })\n            })\n          }\n          if (chunk !== null) yield chunk\n        }\n      })()\n    },\n    async send(messages, data, abortSignal, runContext) {\n      let hasTerminalEvent = false\n      let upstreamThreadId: string | undefined\n      let upstreamRunId: string | undefined\n      try {\n        const stream = connection.connect(\n          messages,\n          data,\n          abortSignal,\n          runContext,\n        )\n        for await (const chunk of stream) {\n          if ('threadId' in chunk && typeof chunk.threadId === 'string') {\n            upstreamThreadId = chunk.threadId\n          }\n          if ('runId' in chunk && typeof chunk.runId === 'string') {\n            upstreamRunId = chunk.runId\n          }\n          if (chunk.type === 'RUN_FINISHED' || chunk.type === 'RUN_ERROR') {\n            hasTerminalEvent = true\n          }\n          push(chunk)\n        }\n\n        // If the connect stream ended cleanly without a terminal event,\n        // synthesize RUN_FINISHED so request-scoped consumers can complete.\n        // Reuse the caller's threadId/runId so client-side activeRunIds tracking matches.\n        if (!abortSignal?.aborted && !hasTerminalEvent) {\n          const synthetic: RunFinishedEvent = {\n            type: EventType.RUN_FINISHED,\n            threadId: requireSyntheticId(\n              upstreamThreadId ?? runContext?.threadId,\n              'threadId',\n            ),\n            runId: requireSyntheticId(\n              upstreamRunId ?? runContext?.runId,\n              'runId',\n            ),\n            model: 'connect-wrapper',\n            timestamp: Date.now(),\n            finishReason: 'stop',\n          }\n          push(synthetic)\n        }\n      } catch (err) {\n        if (!abortSignal?.aborted && !hasTerminalEvent) {\n          const message =\n            err instanceof Error ? err.message : 'Unknown error in connect()'\n          const synthetic: RunErrorEvent = {\n            type: EventType.RUN_ERROR,\n            threadId: requireSyntheticId(\n              upstreamThreadId ?? runContext?.threadId,\n              'threadId',\n            ),\n            runId: requireSyntheticId(\n              upstreamRunId ?? runContext?.runId,\n              'runId',\n            ),\n            timestamp: Date.now(),\n            message,\n          }\n          push(synthetic)\n        }\n        throw err\n      }\n    },\n  }\n}\n\n/**\n * Options for fetch-based connection adapters\n */\nexport interface FetchConnectionOptions {\n  headers?: Record<string, string> | Headers\n  credentials?: RequestCredentials\n  signal?: AbortSignal\n  body?: Record<string, any>\n  fetchClient?: typeof globalThis.fetch\n}\n\n/**\n * Options for XHR-based connection adapters.\n */\nexport interface XhrConnectionOptions {\n  headers?: Record<string, string> | Headers\n  withCredentials?: boolean\n  signal?: AbortSignal\n  body?: Record<string, any>\n  xhrFactory?: () => XMLHttpRequest\n}\n\ntype ResolvedConnectionOptions = Pick<\n  FetchConnectionOptions,\n  'body' | 'headers'\n>\n\nfunction buildRunAgentInputBody(\n  messages: Array<UIMessage> | Array<ModelMessage>,\n  data: Record<string, any> | undefined,\n  runContext: RunAgentInputContext | undefined,\n  options: ResolvedConnectionOptions,\n): Record<string, unknown> {\n  // Precedence (later spreads win): static adapter `body` is the base,\n  // overridden by `runContext.forwardedProps`, overridden by per-message `data`.\n  const wireMessages = uiMessagesToWire(messages as Array<UIMessage>)\n  const forwardedProps = {\n    ...options.body,\n    ...(runContext?.forwardedProps ?? {}),\n    ...data,\n  }\n\n  return {\n    threadId: runContext?.threadId ?? generateRunId('thread'),\n    runId: runContext?.runId ?? generateRunId('run'),\n    ...(runContext?.parentRunId !== undefined && {\n      parentRunId: runContext.parentRunId,\n    }),\n    state: {},\n    messages: wireMessages,\n    tools: runContext?.clientTools ?? [],\n    context: [],\n    forwardedProps,\n    // Backward-compat mirror of `forwardedProps` under the legacy field name.\n    data: { ...forwardedProps },\n  }\n}\n\n/**\n * Create a Server-Sent Events connection adapter\n *\n * @param url - The API endpoint URL (or a function that returns the URL)\n * @param options - Fetch options (headers, credentials, body, etc.) or a function that returns options (can be async)\n * @returns A connection adapter for SSE streams\n *\n * @example\n * ```typescript\n * // Static URL\n * const connection = fetchServerSentEvents('/api/chat');\n *\n * // Dynamic URL\n * const connection = fetchServerSentEvents(() => `/api/chat?user=${userId}`);\n *\n * // With options\n * const connection = fetchServerSentEvents('/api/chat', {\n *   headers: { 'Authorization': 'Bearer token' }\n * });\n *\n * // With dynamic options\n * const connection = fetchServerSentEvents('/api/chat', () => ({\n *   headers: { 'Authorization': `Bearer ${getToken()}` }\n * }));\n *\n * // With additional body data\n * const connection = fetchServerSentEvents('/api/chat', async () => ({\n *   body: {\n *     provider: 'openai',\n *     model: 'gpt-4o',\n *   }\n * }));\n * ```\n */\nexport function fetchServerSentEvents(\n  url: string | (() => string),\n  options:\n    | FetchConnectionOptions\n    | (() => FetchConnectionOptions | Promise<FetchConnectionOptions>) = {},\n): ConnectConnectionAdapter {\n  return {\n    async *connect(messages, data, abortSignal, runContext) {\n      // Resolve URL and options if they are functions\n      const resolvedUrl = typeof url === 'function' ? url() : url\n      const resolvedOptions =\n        typeof options === 'function' ? await options() : options\n\n      const requestHeaders: Record<string, string> = {\n        'Content-Type': 'application/json',\n        ...mergeHeaders(resolvedOptions.headers),\n      }\n\n      // Build AG-UI RunAgentInput payload.\n      //\n      // Precedence (later spreads win): static adapter `body` is the base,\n      // overridden by `runContext.forwardedProps` (constructor body /\n      // forwardedProps options), overridden by per-message `data` passed\n      // to `connection.send`. Runtime values win over static config —\n      // this matches the documented \"forwardedProps wins\" semantic.\n      const requestBody = buildRunAgentInputBody(\n        messages,\n        data,\n        runContext,\n        resolvedOptions,\n      )\n\n      const fetchClient = resolvedOptions.fetchClient ?? fetch\n      // `RequestInit.signal` is typed `AbortSignal | null` (no `undefined`\n      // under `exactOptionalPropertyTypes`), so spread it conditionally\n      // rather than passing `undefined` explicitly.\n      const signal = abortSignal || resolvedOptions.signal\n      const response = await fetchClient(resolvedUrl, {\n        method: 'POST',\n        headers: requestHeaders,\n        body: JSON.stringify(requestBody),\n        credentials: resolvedOptions.credentials || 'same-origin',\n        ...(signal ? { signal } : {}),\n      })\n\n      yield* responseToSSEChunks(response, abortSignal)\n    },\n  }\n}\n\n/**\n * Create an HTTP streaming connection adapter (for raw streaming without SSE format)\n *\n * @param url - The API endpoint URL (or a function that returns the URL)\n * @param options - Fetch options (headers, credentials, body, etc.) or a function that returns options (can be async)\n * @returns A connection adapter for HTTP streams\n *\n * @example\n * ```typescript\n * // Static URL\n * const connection = fetchHttpStream('/api/chat');\n *\n * // Dynamic URL\n * const connection = fetchHttpStream(() => `/api/chat?user=${userId}`);\n *\n * // With options\n * const connection = fetchHttpStream('/api/chat', {\n *   headers: { 'Authorization': 'Bearer token' }\n * });\n *\n * // With dynamic options\n * const connection = fetchHttpStream('/api/chat', () => ({\n *   headers: { 'Authorization': `Bearer ${getToken()}` }\n * }));\n *\n * // With additional body data\n * const connection = fetchHttpStream('/api/chat', async () => ({\n *   body: {\n *     provider: 'openai',\n *     model: 'gpt-4o',\n *   }\n * }));\n * ```\n */\nexport function fetchHttpStream(\n  url: string | (() => string),\n  options:\n    | FetchConnectionOptions\n    | (() => FetchConnectionOptions | Promise<FetchConnectionOptions>) = {},\n): ConnectConnectionAdapter {\n  return {\n    async *connect(messages, data, abortSignal, runContext) {\n      // Resolve URL and options if they are functions\n      const resolvedUrl = typeof url === 'function' ? url() : url\n      const resolvedOptions =\n        typeof options === 'function' ? await options() : options\n\n      const requestHeaders: Record<string, string> = {\n        'Content-Type': 'application/json',\n        ...mergeHeaders(resolvedOptions.headers),\n      }\n\n      // Build AG-UI RunAgentInput payload.\n      //\n      // Precedence (later spreads win): static adapter `body` is the base,\n      // overridden by `runContext.forwardedProps` (constructor body /\n      // forwardedProps options), overridden by per-message `data` passed\n      // to `connection.send`. Runtime values win over static config —\n      // this matches the documented \"forwardedProps wins\" semantic.\n      const requestBody = buildRunAgentInputBody(\n        messages,\n        data,\n        runContext,\n        resolvedOptions,\n      )\n\n      const fetchClient = resolvedOptions.fetchClient ?? fetch\n      // `RequestInit.signal` is typed `AbortSignal | null` (no `undefined`\n      // under `exactOptionalPropertyTypes`), so spread it conditionally\n      // rather than passing `undefined` explicitly.\n      const signal = abortSignal || resolvedOptions.signal\n      const response = await fetchClient(resolvedUrl, {\n        method: 'POST',\n        headers: requestHeaders,\n        body: JSON.stringify(requestBody),\n        credentials: resolvedOptions.credentials || 'same-origin',\n        ...(signal ? { signal } : {}),\n      })\n\n      if (!response.ok) {\n        throw new Error(\n          `HTTP error! status: ${response.status} ${response.statusText}`,\n        )\n      }\n\n      // Parse raw HTTP stream (newline-delimited JSON)\n      const reader = getResponseStreamReader(response)\n\n      for await (const line of readStreamLines(reader, abortSignal)) {\n        yield JSON.parse(line) as StreamChunk\n      }\n    },\n  }\n}\n\ntype XhrConnectionOptionsResolver =\n  | XhrConnectionOptions\n  | (() => XhrConnectionOptions | Promise<XhrConnectionOptions>)\n\nfunction createDefaultXMLHttpRequest(): XMLHttpRequest {\n  if (typeof globalThis.XMLHttpRequest !== 'function') {\n    throw new Error('XMLHttpRequest is not available in this runtime')\n  }\n\n  return new globalThis.XMLHttpRequest()\n}\n\nfunction cleanupXhr(\n  xhr: XMLHttpRequest,\n  abortSignal: AbortSignal | undefined,\n  onAbort: (() => void) | undefined,\n): void {\n  xhr.onprogress = null\n  xhr.onload = null\n  xhr.onerror = null\n  xhr.onabort = null\n  xhr.onloadend = null\n\n  if (abortSignal && onAbort) {\n    abortSignal.removeEventListener('abort', onAbort)\n  }\n}\n\nfunction readXhrLines(\n  xhr: XMLHttpRequest,\n  abortSignal?: AbortSignal,\n): AsyncGenerator<string> {\n  let offset = 0\n  let buffer = ''\n  const lines: Array<string> = []\n  const waiters: Array<() => void> = []\n  let done = false\n  let aborted = false\n  let error: unknown\n  let onAbort: (() => void) | undefined\n\n  const wake = () => {\n    const waiter = waiters.shift()\n    waiter?.()\n  }\n\n  const enqueueDelta = () => {\n    if (xhr.status !== 0 && (xhr.status < 200 || xhr.status >= 300)) {\n      error = new Error(`XHR error! status: ${xhr.status} ${xhr.statusText}`)\n      done = true\n      return\n    }\n\n    const responseText = xhr.responseText\n    if (responseText.length <= offset) {\n      return\n    }\n\n    buffer += responseText.slice(offset)\n    offset = responseText.length\n    const splitLines = buffer.split('\\n')\n    buffer = splitLines.pop() ?? ''\n\n    for (const line of splitLines) {\n      const normalized = line.endsWith('\\r') ? line.slice(0, -1) : line\n      if (normalized.trim()) {\n        lines.push(normalized)\n      }\n    }\n  }\n\n  const finish = () => {\n    enqueueDelta()\n    if (xhr.status < 200 || xhr.status >= 300) {\n      error = new Error(`XHR error! status: ${xhr.status} ${xhr.statusText}`)\n    } else if (buffer.trim() && !aborted) {\n      error = new StreamTruncatedError()\n    }\n    done = true\n    wake()\n  }\n\n  xhr.onprogress = () => {\n    enqueueDelta()\n    wake()\n  }\n  xhr.onload = finish\n  xhr.onerror = () => {\n    error = new Error('XHR request failed')\n    done = true\n    wake()\n  }\n  xhr.onabort = () => {\n    aborted = true\n    done = true\n    wake()\n  }\n  xhr.onloadend = () => {\n    if (!done) {\n      finish()\n    }\n  }\n\n  if (abortSignal) {\n    onAbort = () => {\n      aborted = true\n      xhr.abort()\n    }\n    if (abortSignal.aborted) {\n      onAbort()\n    } else {\n      abortSignal.addEventListener('abort', onAbort, { once: true })\n    }\n  }\n\n  return (async function* () {\n    try {\n      // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition\n      while (true) {\n        const line = lines.shift()\n        if (line !== undefined) {\n          yield line\n          continue\n        }\n\n        if (error) {\n          throw error\n        }\n\n        // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition\n        if (done || abortSignal?.aborted) {\n          return\n        }\n\n        await new Promise<void>((resolve) => {\n          waiters.push(resolve)\n        })\n      }\n    } finally {\n      cleanupXhr(xhr, abortSignal, onAbort)\n    }\n  })()\n}\n\ninterface ConfiguredXhrRequest {\n  xhr: XMLHttpRequest\n  body: string\n}\n\nfunction createConfiguredXhrRequest(\n  url: string,\n  options: XhrConnectionOptions,\n  messages: Array<UIMessage> | Array<ModelMessage>,\n  data: Record<string, any> | undefined,\n  runContext: RunAgentInputContext | undefined,\n): ConfiguredXhrRequest {\n  const xhr = options.xhrFactory?.() ?? createDefaultXMLHttpRequest()\n  xhr.open('POST', url)\n  if (options.withCredentials !== undefined) {\n    xhr.withCredentials = options.withCredentials\n  }\n\n  const requestHeaders: Record<string, string> = {\n    'Content-Type': 'application/json',\n    ...mergeHeaders(options.headers),\n  }\n\n  for (const [name, value] of Object.entries(requestHeaders)) {\n    xhr.setRequestHeader(name, value)\n  }\n\n  const requestBody = buildRunAgentInputBody(\n    messages,\n    data,\n    runContext,\n    options,\n  )\n\n  return { xhr, body: JSON.stringify(requestBody) }\n}\n\nasync function resolveXhrConnectionOptions(\n  options: XhrConnectionOptionsResolver,\n): Promise<XhrConnectionOptions> {\n  return typeof options === 'function' ? await options() : options\n}\n\n/**\n * Create an XMLHttpRequest-backed Server-Sent Events connection adapter.\n */\nexport function xhrServerSentEvents(\n  url: string | (() => string),\n  options: XhrConnectionOptionsResolver = {},\n): ConnectConnectionAdapter {\n  return {\n    async *connect(messages, data, abortSignal, runContext) {\n      const resolvedUrl = typeof url === 'function' ? url() : url\n      const resolvedOptions = await resolveXhrConnectionOptions(options)\n      const signal = abortSignal || resolvedOptions.signal\n      const request = createConfiguredXhrRequest(\n        resolvedUrl,\n        resolvedOptions,\n        messages,\n        data,\n        runContext,\n      )\n      const lines = readXhrLines(request.xhr, signal)\n      if (signal?.aborted) {\n        await lines.next()\n        return\n      }\n      request.xhr.send(request.body)\n      let lastThreadId: string | undefined\n      let lastRunId: string | undefined\n      let lastModel: string | undefined\n\n      for await (const line of lines) {\n        if (\n          line.startsWith(':') ||\n          line.startsWith('event:') ||\n          line.startsWith('id:') ||\n          line.startsWith('retry:')\n        ) {\n          continue\n        }\n\n        const chunkData = parseSseDataLine(line)\n        if (chunkData === '[DONE]') {\n          const synthetic: RunFinishedEvent = {\n            type: EventType.RUN_FINISHED,\n            threadId: lastThreadId ?? runContext?.threadId ?? '',\n            runId: lastRunId ?? runContext?.runId ?? '',\n            model: lastModel ?? '',\n            timestamp: Date.now(),\n            finishReason: 'stop',\n          }\n          request.xhr.abort()\n          yield synthetic\n          return\n        }\n\n        const chunk = JSON.parse(chunkData) as StreamChunk\n        if ('threadId' in chunk && typeof chunk.threadId === 'string') {\n          lastThreadId = chunk.threadId\n        }\n        if ('runId' in chunk && typeof chunk.runId === 'string') {\n          lastRunId = chunk.runId\n        }\n        if ('model' in chunk && typeof chunk.model === 'string') {\n          lastModel = chunk.model\n        }\n        yield chunk\n      }\n    },\n  }\n}\n\n/**\n * Create an XMLHttpRequest-backed newline-delimited JSON stream adapter.\n */\nexport function xhrHttpStream(\n  url: string | (() => string),\n  options: XhrConnectionOptionsResolver = {},\n): ConnectConnectionAdapter {\n  return {\n    async *connect(messages, data, abortSignal, runContext) {\n      const resolvedUrl = typeof url === 'function' ? url() : url\n      const resolvedOptions = await resolveXhrConnectionOptions(options)\n      const signal = abortSignal || resolvedOptions.signal\n      const request = createConfiguredXhrRequest(\n        resolvedUrl,\n        resolvedOptions,\n        messages,\n        data,\n        runContext,\n      )\n      const lines = readXhrLines(request.xhr, signal)\n      if (signal?.aborted) {\n        await lines.next()\n        return\n      }\n      request.xhr.send(request.body)\n\n      for await (const line of lines) {\n        yield JSON.parse(line) as StreamChunk\n      }\n    },\n  }\n}\n\n/**\n * Create a direct stream connection adapter (for server functions or direct streams)\n *\n * @param streamFactory - A function that returns an async iterable of StreamChunks\n * @returns A connection adapter for direct streams\n *\n * @example\n * ```typescript\n * // With TanStack Start server function\n * const connection = stream(() => serverFunction({ messages }));\n *\n * const client = new ChatClient({ connection });\n * ```\n */\nexport function stream(\n  streamFactory: (\n    messages: Array<UIMessage> | Array<ModelMessage>,\n    data?: Record<string, any>,\n    abortSignal?: AbortSignal,\n  ) => AsyncIterable<StreamChunk>,\n): ConnectConnectionAdapter {\n  return {\n    async *connect(messages, data, abortSignal) {\n      // Pass messages as-is (UIMessages with parts preserved)\n      // Server-side chat() handles conversion to ModelMessages\n      yield* streamFactory(messages, data, abortSignal)\n    },\n  }\n}\n\n/**\n * Wrap a `ChatFetcher` as a `ConnectConnectionAdapter` so the chat client can\n * consume it through the same `subscribe`/`send` plumbing used for SSE /\n * HTTP-stream / RPC connections. May return either a `Response` (parsed as\n * SSE) or an `AsyncIterable<StreamChunk>` (yielded directly).\n *\n * @internal\n */\nexport function fetcherToConnectionAdapter(\n  fetcher: ChatFetcher,\n): ConnectConnectionAdapter {\n  return {\n    async *connect(messages, data, abortSignal, runContext) {\n      if (!abortSignal) {\n        throw new Error(\n          'fetcherToConnectionAdapter requires an AbortSignal — the chat client always supplies one.',\n        )\n      }\n      if (!runContext) {\n        throw new Error(\n          'fetcherToConnectionAdapter requires a RunAgentInputContext — the chat client always supplies one.',\n        )\n      }\n      const uiMessages = messages as Array<UIMessage>\n      const result = await fetcher(\n        {\n          messages: uiMessages,\n          data,\n          threadId: runContext.threadId,\n          runId: runContext.runId,\n        },\n        { signal: abortSignal },\n      )\n      if (result instanceof Response) {\n        yield* responseToSSEChunks(result, abortSignal)\n      } else {\n        yield* abortableIterable(result, abortSignal)\n      }\n    },\n  }\n}\n\n/**\n * Wrap an AsyncIterable so iteration aborts when `signal` fires. Without\n * this, a fetcher that returns a generator ignoring its signal would leave\n * the for-await loop hanging until the iterable naturally ends.\n */\nasync function* abortableIterable<T>(\n  iterable: AsyncIterable<T>,\n  signal: AbortSignal,\n): AsyncGenerator<T> {\n  if (signal.aborted) return\n  const iterator = iterable[Symbol.asyncIterator]()\n  const abortPromise = new Promise<{ done: true; value: undefined }>(\n    (resolve) => {\n      signal.addEventListener(\n        'abort',\n        () => resolve({ done: true, value: undefined }),\n        { once: true },\n      )\n    },\n  )\n  try {\n    // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition\n    while (true) {\n      const result = await Promise.race([iterator.next(), abortPromise])\n      if (result.done) return\n      yield result.value\n    }\n  } finally {\n    await iterator.return?.()\n  }\n}\n\n/**\n * Create an RPC stream connection adapter (for RPC-based streaming like Cap'n Web RPC)\n *\n * @param rpcCall - A function that accepts messages and returns an async iterable of StreamChunks\n * @returns A connection adapter for RPC streams\n *\n * @example\n * ```typescript\n * // With Cap'n Web RPC\n * const connection = rpcStream((messages, data) =>\n *   api.streamMurfResponse(messages, data)\n * );\n *\n * const client = new ChatClient({ connection });\n * ```\n */\nexport function rpcStream(\n  rpcCall: (\n    messages: Array<UIMessage> | Array<ModelMessage>,\n    data?: Record<string, any>,\n    abortSignal?: AbortSignal,\n  ) => AsyncIterable<StreamChunk>,\n): ConnectConnectionAdapter {\n  return {\n    async *connect(messages, data, abortSignal) {\n      // Pass messages as-is (UIMessages with parts preserved)\n      // Server-side chat() handles conversion to ModelMessages\n      yield* rpcCall(messages, data, abortSignal)\n    },\n  }\n}\n"],"names":["stream"],"mappings":"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"}

package/dist/esm/devtools-noop.d.ts

@@ -1,6 +1,6 @@
 import { ChatClientEventEmitter, ChatClientEventContext, ChatClientRunEventContext } from './events.js';
 import { AIDevtoolsToolFixture, ChatDevtoolsBridge, ChatDevtoolsBridgeOptions, GenerationDevtoolsBridge, GenerationDevtoolsBridgeOptions, VideoDevtoolsBridge, VideoDevtoolsBridgeOptions } from './devtools.js';
-import { StreamChunk } from '@tanstack/ai';
+import { StreamChunk } from '@tanstack/ai/client';
 export type ChatDevtoolsBridgeFactory = (options: ChatDevtoolsBridgeOptions) => ChatDevtoolsBridge;
 export type GenerationDevtoolsBridgeFactory = <TOutput>(options: GenerationDevtoolsBridgeOptions<TOutput>) => GenerationDevtoolsBridge<TOutput>;
 export type VideoDevtoolsBridgeFactory = <TOutput>(options: VideoDevtoolsBridgeOptions<TOutput>) => VideoDevtoolsBridge<TOutput>;

package/dist/esm/devtools-noop.js.map

@@ -1 +1 @@
-{"version":3,"file":"devtools-noop.js","sources":["../../src/devtools-noop.ts"],"sourcesContent":["// No-op devtools bridge implementations + factories. The chat / generation /\n// video clients import the real bridge classes as types only and accept a\n// factory in options; when no factory is supplied they fall back to the\n// no-op factories here, which never touch `aiEventClient` or any of the\n// heavy preview/fixture machinery in `./devtools`. This keeps `./devtools`\n// outside the main-entry import graph — consumers opt into functional\n// devtools via `@tanstack/ai-client/devtools` (see `package.json#exports`).\nimport { ChatClientEventEmitter } from './events'\nimport type {\n  AIDevtoolsToolFixture,\n  ChatDevtoolsBridge,\n  ChatDevtoolsBridgeOptions,\n  GenerationDevtoolsBridge,\n  GenerationDevtoolsBridgeOptions,\n  VideoDevtoolsBridge,\n  VideoDevtoolsBridgeOptions,\n} from './devtools'\nimport type { StreamChunk } from '@tanstack/ai'\nimport type {\n  ChatClientEventContext,\n  ChatClientRunEventContext,\n} from './events'\n\nexport type ChatDevtoolsBridgeFactory = (\n  options: ChatDevtoolsBridgeOptions,\n) => ChatDevtoolsBridge\n\nexport type GenerationDevtoolsBridgeFactory = <TOutput>(\n  options: GenerationDevtoolsBridgeOptions<TOutput>,\n) => GenerationDevtoolsBridge<TOutput>\n\nexport type VideoDevtoolsBridgeFactory = <TOutput>(\n  options: VideoDevtoolsBridgeOptions<TOutput>,\n) => VideoDevtoolsBridge<TOutput>\n\n// ===========================================================================\n// No-op event emitter — extends the abstract base so it satisfies the type\n// without dragging in any of the event-bus runtime cost.\n// ===========================================================================\n\nclass NoOpChatClientEventEmitter extends ChatClientEventEmitter {\n  protected emitEvent(): void {\n    // intentionally empty\n  }\n}\n\n// ===========================================================================\n// No-op bridges. Methods exist to satisfy the structural shape of the real\n// classes; every emit/record call short-circuits.\n// ===========================================================================\n\nexport class NoOpChatDevtoolsBridge {\n  readonly events: ChatClientEventEmitter\n\n  constructor(options: ChatDevtoolsBridgeOptions) {\n    this.events = new NoOpChatClientEventEmitter(options.clientId)\n  }\n\n  // base bridge surface\n  emitRegistered(): void {}\n  emitUpdated(): void {}\n  emitSnapshot(): void {}\n  emitToolsRegistered(): void {}\n  emitRunLifecycle(\n    _eventType: unknown,\n    _runId: string,\n    _status: unknown,\n    _options?: { error?: string },\n  ): void {}\n  deactivate(): void {}\n  supersede(): void {}\n  dispose(): void {}\n\n  // chat-specific surface\n  setCurrentStreamId(_streamId: string | null): void {}\n  getCurrentStreamId(): string | null {\n    return null\n  }\n  getLastStreamId(): string | null {\n    return null\n  }\n  resolveStreamId(): string {\n    return ''\n  }\n  observeChunk(_chunk: StreamChunk): void {}\n  beginRun(_runId: string, _threadId: string): void {}\n  getCurrentRunEventContext(): ChatClientRunEventContext | undefined {\n    return undefined\n  }\n  getCurrentOrLastRunEventContext(): ChatClientRunEventContext | undefined {\n    return undefined\n  }\n  findToolCallContext(toolCallId: string): ChatClientEventContext {\n    return { toolCallId }\n  }\n  async applyFixture(_fixture: AIDevtoolsToolFixture): Promise<void> {\n    // intentionally empty\n  }\n}\n\nexport class NoOpGenerationDevtoolsBridge<TOutput> {\n  constructor(_options: GenerationDevtoolsBridgeOptions<TOutput>) {}\n\n  // base bridge surface\n  emitRegistered(): void {}\n  emitUpdated(): void {}\n  emitSnapshot(): void {}\n  emitToolsRegistered(): void {}\n  emitRunLifecycle(): void {}\n  deactivate(): void {}\n  supersede(): void {}\n  dispose(): void {}\n\n  // generation-specific surface\n  beginRun(_input: unknown): string {\n    // Real factories supply a stable id; the no-op still returns a\n    // unique value because the generation client passes this run id to\n    // the adapter's RunAgentInputContext.\n    return `noop-run-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`\n  }\n  ensureRunStarted(_runId: string): void {}\n  finishRun(\n    _runId: string,\n    _eventType: 'run:completed' | 'run:errored' | 'run:cancelled',\n    _status: 'completed' | 'errored' | 'cancelled',\n    _error?: string,\n  ): void {}\n  getActiveRunId(): string | null {\n    return null\n  }\n  resetRuns(): void {}\n  recordResultChange(): void {}\n  recordLoadingChange(): void {}\n  recordErrorChange(_error: Error | undefined): void {}\n  recordStatusChange(): void {}\n  recordProgressChange(): void {}\n  emitState(): void {}\n}\n\nexport class NoOpVideoDevtoolsBridge<\n  TOutput,\n> extends NoOpGenerationDevtoolsBridge<TOutput> {\n  constructor(options: VideoDevtoolsBridgeOptions<TOutput>) {\n    super(options)\n  }\n\n  recordJobIdChange(): void {}\n  recordVideoStatusChange(): void {}\n}\n\n// Compile-time parity checks. If a public method is added to the real\n// bridge class without a matching stub on the no-op, the corresponding\n// `Exclude<...>` will resolve to a non-`never` union and the `as never`\n// assignment below will fail to typecheck — surfacing the drift at build\n// time instead of as a runtime TypeError later.\ntype _ChatBridgeMissing = Exclude<\n  keyof ChatDevtoolsBridge,\n  keyof NoOpChatDevtoolsBridge\n>\ntype _GenerationBridgeMissing = Exclude<\n  keyof GenerationDevtoolsBridge<unknown>,\n  keyof NoOpGenerationDevtoolsBridge<unknown>\n>\ntype _VideoBridgeMissing = Exclude<\n  keyof VideoDevtoolsBridge<unknown>,\n  keyof NoOpVideoDevtoolsBridge<unknown>\n>\nconst _chatBridgeParity: _ChatBridgeMissing = undefined as never\nconst _generationBridgeParity: _GenerationBridgeMissing = undefined as never\nconst _videoBridgeParity: _VideoBridgeMissing = undefined as never\nvoid _chatBridgeParity\nvoid _generationBridgeParity\nvoid _videoBridgeParity\n\n// ===========================================================================\n// Factories — these are what the clients call when no real factory was\n// supplied in options.\n// ===========================================================================\n\n// Casts use `unknown` because the no-op classes don't `extend` the real bridge\n// (that would pull the real implementation into the main-entry import graph).\n// Structural parity is enforced by the `_*BridgeMissing` checks above.\n\nexport const createNoOpChatDevtoolsBridge: ChatDevtoolsBridgeFactory = (\n  options,\n) =>\n  // eslint-disable-next-line no-restricted-syntax -- see comment above\n  new NoOpChatDevtoolsBridge(options) as unknown as ChatDevtoolsBridge\n\nexport const createNoOpGenerationDevtoolsBridge: GenerationDevtoolsBridgeFactory =\n  <TOutput>(options: GenerationDevtoolsBridgeOptions<TOutput>) =>\n    // eslint-disable-next-line no-restricted-syntax -- see comment above\n    new NoOpGenerationDevtoolsBridge<TOutput>(\n      options,\n    ) as unknown as GenerationDevtoolsBridge<TOutput>\n\nexport const createNoOpVideoDevtoolsBridge: VideoDevtoolsBridgeFactory = <\n  TOutput,\n>(\n  options: VideoDevtoolsBridgeOptions<TOutput>,\n) =>\n  // eslint-disable-next-line no-restricted-syntax -- see comment above\n  new NoOpVideoDevtoolsBridge<TOutput>(\n    options,\n  ) as unknown as VideoDevtoolsBridge<TOutput>\n"],"names":[],"mappings":";AAwCA,MAAM,mCAAmC,uBAAuB;AAAA,EACpD,YAAkB;AAAA,EAE5B;AACF;AAOO,MAAM,uBAAuB;AAAA,EACzB;AAAA,EAET,YAAY,SAAoC;AAC9C,SAAK,SAAS,IAAI,2BAA2B,QAAQ,QAAQ;AAAA,EAC/D;AAAA;AAAA,EAGA,iBAAuB;AAAA,EAAC;AAAA,EACxB,cAAoB;AAAA,EAAC;AAAA,EACrB,eAAqB;AAAA,EAAC;AAAA,EACtB,sBAA4B;AAAA,EAAC;AAAA,EAC7B,iBACE,YACA,QACA,SACA,UACM;AAAA,EAAC;AAAA,EACT,aAAmB;AAAA,EAAC;AAAA,EACpB,YAAkB;AAAA,EAAC;AAAA,EACnB,UAAgB;AAAA,EAAC;AAAA;AAAA,EAGjB,mBAAmB,WAAgC;AAAA,EAAC;AAAA,EACpD,qBAAoC;AAClC,WAAO;AAAA,EACT;AAAA,EACA,kBAAiC;AAC/B,WAAO;AAAA,EACT;AAAA,EACA,kBAA0B;AACxB,WAAO;AAAA,EACT;AAAA,EACA,aAAa,QAA2B;AAAA,EAAC;AAAA,EACzC,SAAS,QAAgB,WAAyB;AAAA,EAAC;AAAA,EACnD,4BAAmE;AACjE,WAAO;AAAA,EACT;AAAA,EACA,kCAAyE;AACvE,WAAO;AAAA,EACT;AAAA,EACA,oBAAoB,YAA4C;AAC9D,WAAO,EAAE,WAAA;AAAA,EACX;AAAA,EACA,MAAM,aAAa,UAAgD;AAAA,EAEnE;AACF;AAEO,MAAM,6BAAsC;AAAA,EACjD,YAAY,UAAoD;AAAA,EAAC;AAAA;AAAA,EAGjE,iBAAuB;AAAA,EAAC;AAAA,EACxB,cAAoB;AAAA,EAAC;AAAA,EACrB,eAAqB;AAAA,EAAC;AAAA,EACtB,sBAA4B;AAAA,EAAC;AAAA,EAC7B,mBAAyB;AAAA,EAAC;AAAA,EAC1B,aAAmB;AAAA,EAAC;AAAA,EACpB,YAAkB;AAAA,EAAC;AAAA,EACnB,UAAgB;AAAA,EAAC;AAAA;AAAA,EAGjB,SAAS,QAAyB;AAIhC,WAAO,YAAY,KAAK,IAAA,CAAK,IAAI,KAAK,OAAA,EAAS,SAAS,EAAE,EAAE,MAAM,GAAG,CAAC,CAAC;AAAA,EACzE;AAAA,EACA,iBAAiB,QAAsB;AAAA,EAAC;AAAA,EACxC,UACE,QACA,YACA,SACA,QACM;AAAA,EAAC;AAAA,EACT,iBAAgC;AAC9B,WAAO;AAAA,EACT;AAAA,EACA,YAAkB;AAAA,EAAC;AAAA,EACnB,qBAA2B;AAAA,EAAC;AAAA,EAC5B,sBAA4B;AAAA,EAAC;AAAA,EAC7B,kBAAkB,QAAiC;AAAA,EAAC;AAAA,EACpD,qBAA2B;AAAA,EAAC;AAAA,EAC5B,uBAA6B;AAAA,EAAC;AAAA,EAC9B,YAAkB;AAAA,EAAC;AACrB;AAEO,MAAM,gCAEH,6BAAsC;AAAA,EAC9C,YAAY,SAA8C;AACxD,UAAM,OAAO;AAAA,EACf;AAAA,EAEA,oBAA0B;AAAA,EAAC;AAAA,EAC3B,0BAAgC;AAAA,EAAC;AACnC;AAmCO,MAAM,+BAA0D,CACrE;AAAA;AAAA,EAGA,IAAI,uBAAuB,OAAO;AAAA;AAE7B,MAAM,qCACX,CAAU;AAAA;AAAA,EAER,IAAI;AAAA,IACF;AAAA,EAAA;AAAA;AAGC,MAAM,gCAA4D,CAGvE;AAAA;AAAA,EAGA,IAAI;AAAA,IACF;AAAA,EAAA;AAAA;"}
+{"version":3,"file":"devtools-noop.js","sources":["../../src/devtools-noop.ts"],"sourcesContent":["// No-op devtools bridge implementations + factories. The chat / generation /\n// video clients import the real bridge classes as types only and accept a\n// factory in options; when no factory is supplied they fall back to the\n// no-op factories here, which never touch `aiEventClient` or any of the\n// heavy preview/fixture machinery in `./devtools`. This keeps `./devtools`\n// outside the main-entry import graph — consumers opt into functional\n// devtools via `@tanstack/ai-client/devtools` (see `package.json#exports`).\nimport { ChatClientEventEmitter } from './events'\nimport type {\n  AIDevtoolsToolFixture,\n  ChatDevtoolsBridge,\n  ChatDevtoolsBridgeOptions,\n  GenerationDevtoolsBridge,\n  GenerationDevtoolsBridgeOptions,\n  VideoDevtoolsBridge,\n  VideoDevtoolsBridgeOptions,\n} from './devtools'\nimport type { StreamChunk } from '@tanstack/ai/client'\nimport type {\n  ChatClientEventContext,\n  ChatClientRunEventContext,\n} from './events'\n\nexport type ChatDevtoolsBridgeFactory = (\n  options: ChatDevtoolsBridgeOptions,\n) => ChatDevtoolsBridge\n\nexport type GenerationDevtoolsBridgeFactory = <TOutput>(\n  options: GenerationDevtoolsBridgeOptions<TOutput>,\n) => GenerationDevtoolsBridge<TOutput>\n\nexport type VideoDevtoolsBridgeFactory = <TOutput>(\n  options: VideoDevtoolsBridgeOptions<TOutput>,\n) => VideoDevtoolsBridge<TOutput>\n\n// ===========================================================================\n// No-op event emitter — extends the abstract base so it satisfies the type\n// without dragging in any of the event-bus runtime cost.\n// ===========================================================================\n\nclass NoOpChatClientEventEmitter extends ChatClientEventEmitter {\n  protected emitEvent(): void {\n    // intentionally empty\n  }\n}\n\n// ===========================================================================\n// No-op bridges. Methods exist to satisfy the structural shape of the real\n// classes; every emit/record call short-circuits.\n// ===========================================================================\n\nexport class NoOpChatDevtoolsBridge {\n  readonly events: ChatClientEventEmitter\n\n  constructor(options: ChatDevtoolsBridgeOptions) {\n    this.events = new NoOpChatClientEventEmitter(options.clientId)\n  }\n\n  // base bridge surface\n  emitRegistered(): void {}\n  emitUpdated(): void {}\n  emitSnapshot(): void {}\n  emitToolsRegistered(): void {}\n  emitRunLifecycle(\n    _eventType: unknown,\n    _runId: string,\n    _status: unknown,\n    _options?: { error?: string },\n  ): void {}\n  deactivate(): void {}\n  supersede(): void {}\n  dispose(): void {}\n\n  // chat-specific surface\n  setCurrentStreamId(_streamId: string | null): void {}\n  getCurrentStreamId(): string | null {\n    return null\n  }\n  getLastStreamId(): string | null {\n    return null\n  }\n  resolveStreamId(): string {\n    return ''\n  }\n  observeChunk(_chunk: StreamChunk): void {}\n  beginRun(_runId: string, _threadId: string): void {}\n  getCurrentRunEventContext(): ChatClientRunEventContext | undefined {\n    return undefined\n  }\n  getCurrentOrLastRunEventContext(): ChatClientRunEventContext | undefined {\n    return undefined\n  }\n  findToolCallContext(toolCallId: string): ChatClientEventContext {\n    return { toolCallId }\n  }\n  async applyFixture(_fixture: AIDevtoolsToolFixture): Promise<void> {\n    // intentionally empty\n  }\n}\n\nexport class NoOpGenerationDevtoolsBridge<TOutput> {\n  constructor(_options: GenerationDevtoolsBridgeOptions<TOutput>) {}\n\n  // base bridge surface\n  emitRegistered(): void {}\n  emitUpdated(): void {}\n  emitSnapshot(): void {}\n  emitToolsRegistered(): void {}\n  emitRunLifecycle(): void {}\n  deactivate(): void {}\n  supersede(): void {}\n  dispose(): void {}\n\n  // generation-specific surface\n  beginRun(_input: unknown): string {\n    // Real factories supply a stable id; the no-op still returns a\n    // unique value because the generation client passes this run id to\n    // the adapter's RunAgentInputContext.\n    return `noop-run-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`\n  }\n  ensureRunStarted(_runId: string): void {}\n  finishRun(\n    _runId: string,\n    _eventType: 'run:completed' | 'run:errored' | 'run:cancelled',\n    _status: 'completed' | 'errored' | 'cancelled',\n    _error?: string,\n  ): void {}\n  getActiveRunId(): string | null {\n    return null\n  }\n  resetRuns(): void {}\n  recordResultChange(): void {}\n  recordLoadingChange(): void {}\n  recordErrorChange(_error: Error | undefined): void {}\n  recordStatusChange(): void {}\n  recordProgressChange(): void {}\n  emitState(): void {}\n}\n\nexport class NoOpVideoDevtoolsBridge<\n  TOutput,\n> extends NoOpGenerationDevtoolsBridge<TOutput> {\n  constructor(options: VideoDevtoolsBridgeOptions<TOutput>) {\n    super(options)\n  }\n\n  recordJobIdChange(): void {}\n  recordVideoStatusChange(): void {}\n}\n\n// Compile-time parity checks. If a public method is added to the real\n// bridge class without a matching stub on the no-op, the corresponding\n// `Exclude<...>` will resolve to a non-`never` union and the `as never`\n// assignment below will fail to typecheck — surfacing the drift at build\n// time instead of as a runtime TypeError later.\ntype _ChatBridgeMissing = Exclude<\n  keyof ChatDevtoolsBridge,\n  keyof NoOpChatDevtoolsBridge\n>\ntype _GenerationBridgeMissing = Exclude<\n  keyof GenerationDevtoolsBridge<unknown>,\n  keyof NoOpGenerationDevtoolsBridge<unknown>\n>\ntype _VideoBridgeMissing = Exclude<\n  keyof VideoDevtoolsBridge<unknown>,\n  keyof NoOpVideoDevtoolsBridge<unknown>\n>\nconst _chatBridgeParity: _ChatBridgeMissing = undefined as never\nconst _generationBridgeParity: _GenerationBridgeMissing = undefined as never\nconst _videoBridgeParity: _VideoBridgeMissing = undefined as never\nvoid _chatBridgeParity\nvoid _generationBridgeParity\nvoid _videoBridgeParity\n\n// ===========================================================================\n// Factories — these are what the clients call when no real factory was\n// supplied in options.\n// ===========================================================================\n\n// Casts use `unknown` because the no-op classes don't `extend` the real bridge\n// (that would pull the real implementation into the main-entry import graph).\n// Structural parity is enforced by the `_*BridgeMissing` checks above.\n\nexport const createNoOpChatDevtoolsBridge: ChatDevtoolsBridgeFactory = (\n  options,\n) =>\n  // eslint-disable-next-line no-restricted-syntax -- see comment above\n  new NoOpChatDevtoolsBridge(options) as unknown as ChatDevtoolsBridge\n\nexport const createNoOpGenerationDevtoolsBridge: GenerationDevtoolsBridgeFactory =\n  <TOutput>(options: GenerationDevtoolsBridgeOptions<TOutput>) =>\n    // eslint-disable-next-line no-restricted-syntax -- see comment above\n    new NoOpGenerationDevtoolsBridge<TOutput>(\n      options,\n    ) as unknown as GenerationDevtoolsBridge<TOutput>\n\nexport const createNoOpVideoDevtoolsBridge: VideoDevtoolsBridgeFactory = <\n  TOutput,\n>(\n  options: VideoDevtoolsBridgeOptions<TOutput>,\n) =>\n  // eslint-disable-next-line no-restricted-syntax -- see comment above\n  new NoOpVideoDevtoolsBridge<TOutput>(\n    options,\n  ) as unknown as VideoDevtoolsBridge<TOutput>\n"],"names":[],"mappings":";AAwCA,MAAM,mCAAmC,uBAAuB;AAAA,EACpD,YAAkB;AAAA,EAE5B;AACF;AAOO,MAAM,uBAAuB;AAAA,EACzB;AAAA,EAET,YAAY,SAAoC;AAC9C,SAAK,SAAS,IAAI,2BAA2B,QAAQ,QAAQ;AAAA,EAC/D;AAAA;AAAA,EAGA,iBAAuB;AAAA,EAAC;AAAA,EACxB,cAAoB;AAAA,EAAC;AAAA,EACrB,eAAqB;AAAA,EAAC;AAAA,EACtB,sBAA4B;AAAA,EAAC;AAAA,EAC7B,iBACE,YACA,QACA,SACA,UACM;AAAA,EAAC;AAAA,EACT,aAAmB;AAAA,EAAC;AAAA,EACpB,YAAkB;AAAA,EAAC;AAAA,EACnB,UAAgB;AAAA,EAAC;AAAA;AAAA,EAGjB,mBAAmB,WAAgC;AAAA,EAAC;AAAA,EACpD,qBAAoC;AAClC,WAAO;AAAA,EACT;AAAA,EACA,kBAAiC;AAC/B,WAAO;AAAA,EACT;AAAA,EACA,kBAA0B;AACxB,WAAO;AAAA,EACT;AAAA,EACA,aAAa,QAA2B;AAAA,EAAC;AAAA,EACzC,SAAS,QAAgB,WAAyB;AAAA,EAAC;AAAA,EACnD,4BAAmE;AACjE,WAAO;AAAA,EACT;AAAA,EACA,kCAAyE;AACvE,WAAO;AAAA,EACT;AAAA,EACA,oBAAoB,YAA4C;AAC9D,WAAO,EAAE,WAAA;AAAA,EACX;AAAA,EACA,MAAM,aAAa,UAAgD;AAAA,EAEnE;AACF;AAEO,MAAM,6BAAsC;AAAA,EACjD,YAAY,UAAoD;AAAA,EAAC;AAAA;AAAA,EAGjE,iBAAuB;AAAA,EAAC;AAAA,EACxB,cAAoB;AAAA,EAAC;AAAA,EACrB,eAAqB;AAAA,EAAC;AAAA,EACtB,sBAA4B;AAAA,EAAC;AAAA,EAC7B,mBAAyB;AAAA,EAAC;AAAA,EAC1B,aAAmB;AAAA,EAAC;AAAA,EACpB,YAAkB;AAAA,EAAC;AAAA,EACnB,UAAgB;AAAA,EAAC;AAAA;AAAA,EAGjB,SAAS,QAAyB;AAIhC,WAAO,YAAY,KAAK,IAAA,CAAK,IAAI,KAAK,OAAA,EAAS,SAAS,EAAE,EAAE,MAAM,GAAG,CAAC,CAAC;AAAA,EACzE;AAAA,EACA,iBAAiB,QAAsB;AAAA,EAAC;AAAA,EACxC,UACE,QACA,YACA,SACA,QACM;AAAA,EAAC;AAAA,EACT,iBAAgC;AAC9B,WAAO;AAAA,EACT;AAAA,EACA,YAAkB;AAAA,EAAC;AAAA,EACnB,qBAA2B;AAAA,EAAC;AAAA,EAC5B,sBAA4B;AAAA,EAAC;AAAA,EAC7B,kBAAkB,QAAiC;AAAA,EAAC;AAAA,EACpD,qBAA2B;AAAA,EAAC;AAAA,EAC5B,uBAA6B;AAAA,EAAC;AAAA,EAC9B,YAAkB;AAAA,EAAC;AACrB;AAEO,MAAM,gCAEH,6BAAsC;AAAA,EAC9C,YAAY,SAA8C;AACxD,UAAM,OAAO;AAAA,EACf;AAAA,EAEA,oBAA0B;AAAA,EAAC;AAAA,EAC3B,0BAAgC;AAAA,EAAC;AACnC;AAmCO,MAAM,+BAA0D,CACrE;AAAA;AAAA,EAGA,IAAI,uBAAuB,OAAO;AAAA;AAE7B,MAAM,qCACX,CAAU;AAAA;AAAA,EAER,IAAI;AAAA,IACF;AAAA,EAAA;AAAA;AAGC,MAAM,gCAA4D,CAGvE;AAAA;AAAA,EAGA,IAAI;AAAA,IACF;AAAA,EAAA;AAAA;"}

package/dist/esm/devtools.d.ts

@@ -1,4 +1,4 @@
-import { AnyClientTool, StreamChunk } from '@tanstack/ai';
+import { AnyClientTool, StreamChunk } from '@tanstack/ai/client';
 import { ChatClientEventContext, ChatClientEventEmitter, ChatClientRunEventContext } from './events.js';
 import { ChatClientState, ConnectionStatus, UIMessage } from './types.js';
 export interface AIDevtoolsDisplayOptions {

package/dist/esm/devtools.js

@@ -1,5 +1,5 @@
 import { emitAIDevtoolsEvent, aiEventClient, createAIDevtoolsEventEnvelope } from "@tanstack/ai-event-client";
-import { convertSchemaToJsonSchema } from "@tanstack/ai";
+import { convertSchemaToJsonSchema } from "@tanstack/ai/client";
 import { DefaultChatClientEventEmitter } from "./events.js";
 function createAIDevtoolsGenerationPreview(input) {
   if (input.outputKind === "image") {