@copilotkit/runtime 2.0.0-next.1 → 2.0.0-rc.1

package/LICENSE

@@ -0,0 +1,21 @@
+The MIT License
+
+Copyright (c) Atai Barkai
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

package/README.md

@@ -37,7 +37,6 @@
 
 <img src="https://github.com/user-attachments/assets/3b810240-e9f8-43ae-acec-31a58095e223" alt="headless-ui" style="border-radius: 12px; border: 2px solid #d6d4fa;">
 
-
 ## 🏆 Featured Examples
 
 <p align="center">
@@ -52,10 +51,79 @@
   </a>
 </p>
 
+## Trusted Inspector metadata
+
+An Intelligence-backed v2 runtime can proxy trusted project and license context
+to the Inspector. The runtime advertises this support with
+`inspectorMetadata: true` in its runtime-info response.
+
+| Runtime mode | Request                                                     |
+| ------------ | ----------------------------------------------------------- |
+| Multi-route  | `GET {basePath}/inspector-metadata`                         |
+| Single-route | `POST {basePath}` with `{ "method": "inspector/metadata" }` |
+
+A valid response is a sanitized `InspectorMetadataV1` JSON object with
+`Cache-Control: no-store, private`. Missing data, an unsupported schema, a
+non-Intelligence runtime, or a provider failure returns `204` with the same
+cache policy. This optional request never changes the main runtime connection
+state. The upstream Intelligence request has a five-second deadline; a timeout
+uses the same private `204` path.
+
+Runtime keeps `schemaVersion: 1` and returns the object normalized by Shared.
+Older producers may omit `usage.expiringSoonCount`, and `0` stays a known zero.
+If this optional leaf is malformed, Shared removes only the leaf and keeps valid
+base usage and sibling modules. Runtime does not calculate or cache expiry, and
+older consumers ignore the additive leaf.
+
+The Intelligence request uses the API key configured on the server-side
+`CopilotKitIntelligence` client. The proxy does not forward browser headers or
+cookies to Intelligence, and it does not expose provider error bodies to the
+browser. Browser headers and configured fetch credentials still apply between
+`@copilotkit/core` and your Copilot Runtime, so you can protect the runtime route
+with your normal app auth.
+
+Deploy the Intelligence producer before releasing a runtime that advertises the
+capability. New runtimes treat a `404` from an older Intelligence App API as
+compatible absence and return `204` to the client.
+
 ## Documentation
 
 To get started with CopilotKit, please check out the [documentation](https://docs.copilotkit.ai).
 
+## Intelligence identity and Memory
+
+An Intelligence Runtime supports web only, Channels only, or both. Web routes
+need `identifyUser(request)`. Each Channel has its own `identifyUser` policy in
+`createChannel`. A Channels-only Runtime omits the web callback and exposes no
+functional web routes.
+
+```ts
+const runtime = new CopilotRuntime({
+  agents,
+  intelligence,
+  identifyUser: authenticateApplicationUser,
+  channels: [supportChannel],
+  memory: {
+    access: async ({ request, user, consumer }) => {
+      const role = await roleFor(request, user);
+      if (role === "blocked") return null;
+      return consumer === "client"
+        ? { user: "read", project: "none" }
+        : { user: "read-write", project: "read" };
+    },
+  },
+});
+```
+
+The callback runs once per web request. Its user owns ordinary web Threads and
+is reused for agent and browser Memory policy. Adding `memory` exposes the
+browser Memory routes and agent tools under the same policy. A denial returns
+403; a policy error fails the request. Omitting `memory` hides the browser
+routes and does not attach Memory tools.
+
+`exposeMemoryRoutes` and
+`CopilotKitIntelligence({ enableEnterpriseLearning: true })` remain for one
+compatibility window. New code should use `memory.access`.
 
 ## Analytics & Privacy
 
@@ -74,3 +142,69 @@ Or use the `DO_NOT_TRACK` standard:
 ```bash
 export DO_NOT_TRACK=1
 ```
+
+## Stopping Intelligence runs
+
+Await Stop before sending another message on the same thread. With
+`IntelligenceAgentRunner`, `stopped: true` means the gateway acknowledged the
+run's terminal events and the runtime completed local cleanup. The gateway
+releases only the lock owned by that run.
+
+Stop requests agent cancellation and excludes late agent events from thread
+history. Agents that support `detachActiveRun()` also detach their local
+subscription. Older agents remain supported. An adapter must honor cancellation
+to stop external work; Stop cannot undo tool calls that already took effect.
+
+The HTTP request and response formats are unchanged. Empty-body Stop requests
+still stop the current run. Direct runner callers can pass the existing optional
+`runId` to stop only that run. A missing, mismatched, or already-requested Stop
+returns `false`. Failed terminal delivery rejects Stop; the HTTP handler returns
+its existing error response instead of reporting success. The wait is bounded by
+the existing 60-second durability window.
+
+No Intelligence upgrade is required. The runtime uses the existing terminal
+events and supports both single-event and batched gateway acknowledgments.
+
+## BuiltInAgent skill delivery from multiple containers
+
+```typescript
+import { BuiltInAgent } from "@copilotkit/runtime";
+
+const agent = new BuiltInAgent({
+  model: "openai/gpt-4o",
+  learnedSkills: {
+    containers: [
+      { id: "support", revision: "revision-123" },
+      { id: "company-wide" },
+    ],
+  },
+});
+```
+
+Set `CPK_INTELLIGENCE_API_KEY` or supply an Intelligence client in `learnedSkills.client`.
+The existing `containerId` and top-level `revision` interface remains supported.
+The SDK rejects a combination of the old fields and `containers`.
+The new interface ignores legacy container and revision environment variables.
+Each container keeps its own revision and cache. A cold failure or confirmed denial blocks the whole invocation.
+Skill names include the container prefix, such as `support/refund-policy`, when you use `containers`.
+See [Skill delivery](https://docs.copilotkit.ai/intelligence/learned-skills) for all adapters, environment defaults, and factory-mode wiring.
+
+Explicit `containers` accepts 1–50 unique container IDs and sends one batch request for all sources that need a refresh. This also applies to a list with one entry.
+The server must support `POST /api/v1/learning/skills/batch` before you use this configuration. The SDK does not fall back to separate requests.
+Legacy `containerId` configuration keeps its existing single-container request. Both interfaces use the same authentication configuration.
+
+## Intelligence runner reconnects
+
+`IntelligenceAgentRunner` retains unacknowledged events and retries them with the
+same IDs after reconnect. An unexpected normal WebSocket close (`1000`) also
+reconnects while the run remains active. Intentional cleanup does not reconnect.
+
+Recovery also depends on the Intelligence gateway's reconnect grace period.
+The current gateway defaults to 15 seconds and stores pending disconnects in
+Redis so another gateway replica can finish cleanup. The gateway controls this
+period; the runner does not negotiate it. A gateway with no reconnect grace can
+record `RUNNER_CONNECTION_DROPPED` before the runner reconnects.
+
+This recovers a lost WebSocket while the agent runtime remains alive. It does
+not restart an agent after its runtime process exits. The existing 60-second
+event acknowledgment deadline still applies.

package/dist/_virtual/_rolldown/runtime.cjs

@@ -0,0 +1,29 @@
+//#region \0rolldown/runtime.js
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") {
+		for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+			key = keys[i];
+			if (!__hasOwnProp.call(to, key) && key !== except) {
+				__defProp(to, key, {
+					get: ((k) => from[k]).bind(null, key),
+					enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+				});
+			}
+		}
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+
+//#endregion
+
+exports.__toESM = __toESM;

package/dist/_virtual/_rolldown/runtime.mjs

@@ -0,0 +1,18 @@
+//#region \0rolldown/runtime.js
+var __defProp = Object.defineProperty;
+var __exportAll = (all, no_symbols) => {
+	let target = {};
+	for (var name in all) {
+		__defProp(target, name, {
+			get: all[name],
+			enumerable: true
+		});
+	}
+	if (!no_symbols) {
+		__defProp(target, Symbol.toStringTag, { value: "Module" });
+	}
+	return target;
+};
+
+//#endregion
+export { __exportAll };

package/dist/agent/converters/aisdk.cjs

@@ -0,0 +1,355 @@
+const require_runtime = require('../../_virtual/_rolldown/runtime.cjs');
+const require_state_delta = require('../state-delta.cjs');
+const require_usage = require('./usage.cjs');
+let _copilotkit_shared = require("@copilotkit/shared");
+let _ag_ui_client = require("@ag-ui/client");
+
+//#region src/agent/converters/aisdk.ts
+/**
+* Reads aggregate usage from an AI SDK finish part without inventing values
+* when a provider omits a token count.
+*/
+function getAISDKRunFinishedDetails(part, identity = {}) {
+	const details = {};
+	if (typeof part.finishReason === "string") details.metadata = { finishReason: part.finishReason };
+	if (part.totalUsage === null || typeof part.totalUsage !== "object" || Array.isArray(part.totalUsage)) return details;
+	const totalUsage = part.totalUsage;
+	const counts = {};
+	for (const key of require_usage.tokenCountKeys) {
+		const value = require_usage.getTokenCount(totalUsage[key]);
+		if (value !== void 0) counts[key] = value;
+	}
+	require_usage.aggregateRunUsage(details, [{
+		...identity,
+		...counts
+	}]);
+	return details;
+}
+function formatToolError(error) {
+	if (error instanceof Error) return error.message;
+	if (error && typeof error === "object" && "message" in error && typeof error.message === "string") return error.message;
+	if (typeof error === "string") return error;
+	if (error === void 0 || error === null) return "Unknown tool error";
+	try {
+		const serialized = JSON.stringify(error);
+		return serialized === void 0 ? String(error) : serialized;
+	} catch {
+		return String(error);
+	}
+}
+/**
+* Returns the AG-UI message id for an AI SDK `text-start` / `reasoning-start`
+* part.
+*
+* Several providers number stream parts per response instead of giving them
+* a unique id: @ai-sdk/anthropic and @ai-sdk/google use a block counter
+* ("0", "1", ...) and @ai-sdk/openai-compatible always uses "txt-0" /
+* "reasoning-0". Those ids repeat on every step and every run, so reusing
+* them would append later replies to an earlier message. Only ids that look
+* unique are kept.
+*/
+function resolveStreamPartMessageId(providedId) {
+	if (typeof providedId !== "string" || providedId === "" || /^(\d+|(txt|reasoning|msg)-0)$/.test(providedId)) return (0, _copilotkit_shared.randomUUID)();
+	return providedId;
+}
+/**
+* Converts an AI SDK `fullStream` into AG-UI `BaseEvent` objects.
+*
+* This is a pure converter — it does NOT emit lifecycle events
+* (RUN_STARTED / RUN_FINISHED / RUN_ERROR). The caller (Agent class)
+* is responsible for those.
+*
+* Terminal stream events (finish, error, abort) cause the generator to
+* return so the caller can handle lifecycle appropriately.
+*
+* `pendingInterrupts`, when provided, is filled with one AG-UI Interrupt per
+* AI SDK `tool-approval-request` part (a tool declared `needsApproval: true`).
+* The caller turns a non-empty array into a RUN_FINISHED `outcome:interrupt`.
+*/
+async function* convertAISDKStream(fullStream, abortSignal, pendingInterrupts, initialState, runFinishedDetails) {
+	let messageId = (0, _copilotkit_shared.randomUUID)();
+	let reasoningMessageId = (0, _copilotkit_shared.randomUUID)();
+	let isInReasoning = false;
+	const normalizeStateEvent = require_state_delta.createStateEventNormalizer(initialState);
+	const toolCallStates = /* @__PURE__ */ new Map();
+	const ensureToolCallState = (toolCallId) => {
+		let state = toolCallStates.get(toolCallId);
+		if (!state) {
+			state = {
+				started: false,
+				hasArgsDelta: false,
+				ended: false
+			};
+			toolCallStates.set(toolCallId, state);
+		}
+		return state;
+	};
+	/**
+	* Auto-close an open reasoning lifecycle.
+	* Some AI SDK providers (notably @ai-sdk/anthropic) never emit "reasoning-end",
+	* which leaves downstream state machines stuck. This helper emits the
+	* missing REASONING_MESSAGE_END + REASONING_END events so the stream
+	* can transition to text, tool-call, or finish phases.
+	*/
+	function* closeReasoningIfOpen() {
+		if (!isInReasoning) return;
+		isInReasoning = false;
+		yield {
+			type: _ag_ui_client.EventType.REASONING_MESSAGE_END,
+			messageId: reasoningMessageId
+		};
+		yield {
+			type: _ag_ui_client.EventType.REASONING_END,
+			messageId: reasoningMessageId
+		};
+	}
+	try {
+		const warnedUnknownPartTypes = /* @__PURE__ */ new Set();
+		for await (const part of fullStream) {
+			const p = part;
+			if (p.type !== "reasoning-delta") yield* closeReasoningIfOpen();
+			switch (p.type) {
+				case "abort": return;
+				case "reasoning-start":
+					reasoningMessageId = resolveStreamPartMessageId("id" in p ? p.id : void 0);
+					yield {
+						type: _ag_ui_client.EventType.REASONING_START,
+						messageId: reasoningMessageId
+					};
+					yield {
+						type: _ag_ui_client.EventType.REASONING_MESSAGE_START,
+						messageId: reasoningMessageId,
+						role: "reasoning"
+					};
+					isInReasoning = true;
+					break;
+				case "reasoning-delta": {
+					const delta = p.text ?? "";
+					if (!delta) break;
+					yield {
+						type: _ag_ui_client.EventType.REASONING_MESSAGE_CONTENT,
+						messageId: reasoningMessageId,
+						delta
+					};
+					break;
+				}
+				case "reasoning-end": break;
+				case "tool-input-start": {
+					const toolCallId = p.id;
+					const state = ensureToolCallState(toolCallId);
+					state.toolName = p.toolName;
+					if (!state.started) {
+						state.started = true;
+						yield {
+							type: _ag_ui_client.EventType.TOOL_CALL_START,
+							parentMessageId: messageId,
+							toolCallId,
+							toolCallName: p.toolName
+						};
+					}
+					break;
+				}
+				case "tool-input-delta": {
+					const toolCallId = p.id;
+					const state = ensureToolCallState(toolCallId);
+					state.hasArgsDelta = true;
+					yield {
+						type: _ag_ui_client.EventType.TOOL_CALL_ARGS,
+						toolCallId,
+						delta: p.delta
+					};
+					break;
+				}
+				case "tool-input-end": break;
+				case "text-start":
+					messageId = resolveStreamPartMessageId("id" in p ? p.id : void 0);
+					break;
+				case "text-delta": {
+					const textDelta = "text" in p ? p.text : "";
+					yield {
+						type: _ag_ui_client.EventType.TEXT_MESSAGE_CHUNK,
+						role: "assistant",
+						messageId,
+						delta: textDelta
+					};
+					break;
+				}
+				case "tool-call": {
+					const toolCallId = p.toolCallId;
+					const state = ensureToolCallState(toolCallId);
+					state.toolName = p.toolName ?? state.toolName;
+					if (!state.started) {
+						state.started = true;
+						yield {
+							type: _ag_ui_client.EventType.TOOL_CALL_START,
+							parentMessageId: messageId,
+							toolCallId,
+							toolCallName: p.toolName
+						};
+					}
+					if (!state.hasArgsDelta && "input" in p && p.input !== void 0) {
+						let serializedInput = "";
+						if (typeof p.input === "string") serializedInput = p.input;
+						else try {
+							serializedInput = JSON.stringify(p.input);
+						} catch {
+							serializedInput = String(p.input);
+						}
+						if (serializedInput.length > 0) {
+							yield {
+								type: _ag_ui_client.EventType.TOOL_CALL_ARGS,
+								toolCallId,
+								delta: serializedInput
+							};
+							state.hasArgsDelta = true;
+						}
+					}
+					if (!state.ended) {
+						state.ended = true;
+						yield {
+							type: _ag_ui_client.EventType.TOOL_CALL_END,
+							toolCallId
+						};
+					}
+					break;
+				}
+				case "tool-approval-request": {
+					const nested = p.toolCall ?? {};
+					const toolCallId = p.toolCallId ?? nested.toolCallId;
+					if (!toolCallId) throw new Error("AI SDK tool-approval-request is missing toolCallId");
+					const state = ensureToolCallState(toolCallId);
+					const toolName = state.toolName ?? nested.toolName;
+					if (!state.started) {
+						state.started = true;
+						yield {
+							type: _ag_ui_client.EventType.TOOL_CALL_START,
+							parentMessageId: messageId,
+							toolCallId,
+							toolCallName: toolName ?? ""
+						};
+					}
+					if (!state.hasArgsDelta && nested.input !== void 0) {
+						let serialized = "";
+						try {
+							serialized = typeof nested.input === "string" ? nested.input : JSON.stringify(nested.input);
+						} catch {
+							serialized = String(nested.input);
+						}
+						if (serialized.length > 0) {
+							yield {
+								type: _ag_ui_client.EventType.TOOL_CALL_ARGS,
+								toolCallId,
+								delta: serialized
+							};
+							state.hasArgsDelta = true;
+						}
+					}
+					if (!state.ended) {
+						state.ended = true;
+						yield {
+							type: _ag_ui_client.EventType.TOOL_CALL_END,
+							toolCallId
+						};
+					}
+					pendingInterrupts?.push({
+						id: toolCallId,
+						toolCallId,
+						reason: "tool_approval",
+						message: toolName ? `Approve "${toolName}"?` : void 0,
+						...toolName ? { metadata: { toolName } } : {}
+					});
+					break;
+				}
+				case "tool-error": {
+					const toolCallId = p.toolCallId;
+					if (!toolCallId) throw new Error("AI SDK tool-error is missing toolCallId");
+					if (pendingInterrupts?.some((interrupt) => interrupt.toolCallId === toolCallId)) {
+						toolCallStates.delete(toolCallId);
+						break;
+					}
+					toolCallStates.delete(toolCallId);
+					yield {
+						type: _ag_ui_client.EventType.TOOL_CALL_RESULT,
+						role: "tool",
+						messageId: (0, _copilotkit_shared.randomUUID)(),
+						toolCallId,
+						content: `Error: ${formatToolError(p.error)}`
+					};
+					break;
+				}
+				case "tool-result": {
+					const toolResult = "output" in p ? p.output : "result" in p ? p.result : null;
+					const toolName = "toolName" in p ? p.toolName : "";
+					toolCallStates.delete(p.toolCallId);
+					if (toolName === "AGUISendStateSnapshot" && toolResult && typeof toolResult === "object") {
+						const snapshot = toolResult.snapshot;
+						if (snapshot !== void 0) {
+							const stateSnapshotEvent = {
+								type: _ag_ui_client.EventType.STATE_SNAPSHOT,
+								snapshot
+							};
+							for (const event of normalizeStateEvent(stateSnapshotEvent)) yield event;
+						}
+					} else if (toolName === "AGUISendStateDelta" && toolResult && typeof toolResult === "object") {
+						const delta = toolResult.delta;
+						if (delta !== void 0) {
+							const stateDeltaEvent = {
+								type: _ag_ui_client.EventType.STATE_DELTA,
+								delta
+							};
+							for (const event of normalizeStateEvent(stateDeltaEvent)) yield event;
+						}
+					}
+					let serializedResult;
+					try {
+						serializedResult = JSON.stringify(toolResult);
+					} catch {
+						serializedResult = `[Unserializable tool result from ${toolName || "unknown tool"}]`;
+					}
+					yield {
+						type: _ag_ui_client.EventType.TOOL_CALL_RESULT,
+						role: "tool",
+						messageId: (0, _copilotkit_shared.randomUUID)(),
+						toolCallId: p.toolCallId,
+						content: serializedResult
+					};
+					break;
+				}
+				case "finish":
+					if (runFinishedDetails) Object.assign(runFinishedDetails, getAISDKRunFinishedDetails(p));
+					return;
+				case "error": {
+					if (abortSignal.aborted) return;
+					const err = p.error ?? p.message ?? p.cause;
+					if (err instanceof Error) throw err;
+					throw new Error(typeof err === "string" ? err : `AI SDK stream error: ${JSON.stringify(p)}`);
+				}
+				case "start":
+				case "start-step":
+				case "finish-step":
+				case "text-end":
+				case "source":
+				case "file":
+				case "tool-output-denied":
+				case "raw": break;
+				default: {
+					const unknownType = String(p.type);
+					if (!warnedUnknownPartTypes.has(unknownType)) {
+						warnedUnknownPartTypes.add(unknownType);
+						console.warn(`[convertAISDKStream] Ignoring unhandled AI SDK stream part: ${unknownType}`);
+					}
+					break;
+				}
+			}
+		}
+	} finally {
+		yield* closeReasoningIfOpen();
+	}
+}
+
+//#endregion
+exports.convertAISDKStream = convertAISDKStream;
+exports.formatToolError = formatToolError;
+exports.getAISDKRunFinishedDetails = getAISDKRunFinishedDetails;
+exports.resolveStreamPartMessageId = resolveStreamPartMessageId;
+//# sourceMappingURL=aisdk.cjs.map

package/dist/agent/converters/aisdk.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"aisdk.cjs","names":["tokenCountKeys","getTokenCount","createStateEventNormalizer","EventType"],"sources":["../../../src/agent/converters/aisdk.ts"],"sourcesContent":["import type {\n  BaseEvent,\n  Interrupt,\n  ReasoningEndEvent,\n  ReasoningMessageContentEvent,\n  ReasoningMessageEndEvent,\n  ReasoningMessageStartEvent,\n  ReasoningStartEvent,\n  TextMessageChunkEvent,\n  ToolCallArgsEvent,\n  ToolCallEndEvent,\n  ToolCallStartEvent,\n  ToolCallResultEvent,\n  StateSnapshotEvent,\n  StateDeltaEvent,\n} from \"@ag-ui/client\";\nimport { EventType } from \"@ag-ui/client\";\nimport { randomUUID } from \"@copilotkit/shared\";\nimport { createStateEventNormalizer } from \"../state-delta\";\nimport { aggregateRunUsage, getTokenCount, tokenCountKeys } from \"./usage\";\nimport type { AgentRunFinishedDetails, AgentRunUsage } from \"./usage\";\n\n/**\n * Reads aggregate usage from an AI SDK finish part without inventing values\n * when a provider omits a token count.\n */\nexport function getAISDKRunFinishedDetails(\n  part: Record<string, unknown>,\n  identity: { provider?: string; model?: string } = {},\n): AgentRunFinishedDetails {\n  const details: AgentRunFinishedDetails = {};\n\n  if (typeof part.finishReason === \"string\") {\n    details.metadata = { finishReason: part.finishReason };\n  }\n\n  if (\n    part.totalUsage === null ||\n    typeof part.totalUsage !== \"object\" ||\n    Array.isArray(part.totalUsage)\n  ) {\n    return details;\n  }\n\n  const totalUsage = part.totalUsage as Record<string, unknown>;\n  const counts: AgentRunUsage = {};\n\n  for (const key of tokenCountKeys) {\n    const value = getTokenCount(totalUsage[key]);\n    if (value !== undefined) {\n      counts[key] = value;\n    }\n  }\n\n  aggregateRunUsage(details, [{ ...identity, ...counts }]);\n\n  return details;\n}\n\nexport function formatToolError(error: unknown): string {\n  if (error instanceof Error) return error.message;\n  if (\n    error &&\n    typeof error === \"object\" &&\n    \"message\" in error &&\n    typeof error.message === \"string\"\n  ) {\n    return error.message;\n  }\n  if (typeof error === \"string\") return error;\n  if (error === undefined || error === null) return \"Unknown tool error\";\n\n  try {\n    const serialized = JSON.stringify(error);\n    return serialized === undefined ? String(error) : serialized;\n  } catch {\n    return String(error);\n  }\n}\n\n/**\n * Returns the AG-UI message id for an AI SDK `text-start` / `reasoning-start`\n * part.\n *\n * Several providers number stream parts per response instead of giving them\n * a unique id: @ai-sdk/anthropic and @ai-sdk/google use a block counter\n * (\"0\", \"1\", ...) and @ai-sdk/openai-compatible always uses \"txt-0\" /\n * \"reasoning-0\". Those ids repeat on every step and every run, so reusing\n * them would append later replies to an earlier message. Only ids that look\n * unique are kept.\n */\nexport function resolveStreamPartMessageId(providedId: unknown): string {\n  if (\n    typeof providedId !== \"string\" ||\n    providedId === \"\" ||\n    /^(\\d+|(txt|reasoning|msg)-0)$/.test(providedId)\n  ) {\n    return randomUUID();\n  }\n  return providedId;\n}\n\n/**\n * Converts an AI SDK `fullStream` into AG-UI `BaseEvent` objects.\n *\n * This is a pure converter — it does NOT emit lifecycle events\n * (RUN_STARTED / RUN_FINISHED / RUN_ERROR). The caller (Agent class)\n * is responsible for those.\n *\n * Terminal stream events (finish, error, abort) cause the generator to\n * return so the caller can handle lifecycle appropriately.\n *\n * `pendingInterrupts`, when provided, is filled with one AG-UI Interrupt per\n * AI SDK `tool-approval-request` part (a tool declared `needsApproval: true`).\n * The caller turns a non-empty array into a RUN_FINISHED `outcome:interrupt`.\n */\nexport async function* convertAISDKStream(\n  fullStream: AsyncIterable<unknown>,\n  abortSignal: AbortSignal,\n  pendingInterrupts?: Interrupt[],\n  initialState?: unknown,\n  runFinishedDetails?: AgentRunFinishedDetails,\n): AsyncGenerator<BaseEvent> {\n  let messageId = randomUUID();\n  let reasoningMessageId = randomUUID();\n  let isInReasoning = false;\n  const normalizeStateEvent = createStateEventNormalizer(initialState);\n\n  const toolCallStates = new Map<\n    string,\n    {\n      started: boolean;\n      hasArgsDelta: boolean;\n      ended: boolean;\n      toolName?: string;\n    }\n  >();\n\n  const ensureToolCallState = (toolCallId: string) => {\n    let state = toolCallStates.get(toolCallId);\n    if (!state) {\n      state = { started: false, hasArgsDelta: false, ended: false };\n      toolCallStates.set(toolCallId, state);\n    }\n    return state;\n  };\n\n  /**\n   * Auto-close an open reasoning lifecycle.\n   * Some AI SDK providers (notably @ai-sdk/anthropic) never emit \"reasoning-end\",\n   * which leaves downstream state machines stuck. This helper emits the\n   * missing REASONING_MESSAGE_END + REASONING_END events so the stream\n   * can transition to text, tool-call, or finish phases.\n   */\n  function* closeReasoningIfOpen(): Generator<BaseEvent> {\n    if (!isInReasoning) return;\n    isInReasoning = false;\n    const reasoningMsgEnd: ReasoningMessageEndEvent = {\n      type: EventType.REASONING_MESSAGE_END,\n      messageId: reasoningMessageId,\n    };\n    yield reasoningMsgEnd;\n    const reasoningEnd: ReasoningEndEvent = {\n      type: EventType.REASONING_END,\n      messageId: reasoningMessageId,\n    };\n    yield reasoningEnd;\n  }\n\n  try {\n    const warnedUnknownPartTypes = new Set<string>();\n    for await (const part of fullStream) {\n      const p = part as Record<string, unknown>;\n\n      // Close any open reasoning lifecycle on every event except\n      // reasoning-delta, which arrives mid-block and must not interrupt it.\n      if (p.type !== \"reasoning-delta\") {\n        yield* closeReasoningIfOpen();\n      }\n\n      switch (p.type) {\n        case \"abort\": {\n          // Terminal — let the caller handle lifecycle\n          return;\n        }\n\n        case \"reasoning-start\": {\n          reasoningMessageId = resolveStreamPartMessageId(\n            \"id\" in p ? p.id : undefined,\n          );\n          const reasoningStartEvent: ReasoningStartEvent = {\n            type: EventType.REASONING_START,\n            messageId: reasoningMessageId,\n          };\n          yield reasoningStartEvent;\n          const reasoningMessageStart: ReasoningMessageStartEvent = {\n            type: EventType.REASONING_MESSAGE_START,\n            messageId: reasoningMessageId,\n            role: \"reasoning\",\n          };\n          yield reasoningMessageStart;\n          isInReasoning = true;\n          break;\n        }\n\n        case \"reasoning-delta\": {\n          const delta = (p.text as string) ?? \"\";\n          if (!delta) break; // skip — @ag-ui/core schema requires delta to be non-empty\n          const reasoningDeltaEvent: ReasoningMessageContentEvent = {\n            type: EventType.REASONING_MESSAGE_CONTENT,\n            messageId: reasoningMessageId,\n            delta,\n          };\n          yield reasoningDeltaEvent;\n          break;\n        }\n\n        case \"reasoning-end\": {\n          // closeReasoningIfOpen() already called before the switch — no-op here\n          // if the SDK never emits this event (e.g. @ai-sdk/anthropic).\n          break;\n        }\n\n        case \"tool-input-start\": {\n          const toolCallId = p.id as string;\n          const state = ensureToolCallState(toolCallId);\n          state.toolName = p.toolName as string;\n          if (!state.started) {\n            state.started = true;\n            const startEvent: ToolCallStartEvent = {\n              type: EventType.TOOL_CALL_START,\n              parentMessageId: messageId,\n              toolCallId,\n              toolCallName: p.toolName as string,\n            };\n            yield startEvent;\n          }\n          break;\n        }\n\n        case \"tool-input-delta\": {\n          const toolCallId = p.id as string;\n          const state = ensureToolCallState(toolCallId);\n          state.hasArgsDelta = true;\n          const argsEvent: ToolCallArgsEvent = {\n            type: EventType.TOOL_CALL_ARGS,\n            toolCallId,\n            delta: p.delta as string,\n          };\n          yield argsEvent;\n          break;\n        }\n\n        case \"tool-input-end\": {\n          // No direct event – the subsequent \"tool-call\" part marks completion.\n          break;\n        }\n\n        case \"text-start\": {\n          messageId = resolveStreamPartMessageId(\"id\" in p ? p.id : undefined);\n          break;\n        }\n\n        case \"text-delta\": {\n          // AI SDK text-delta events use 'text' (not 'delta')\n          const textDelta = \"text\" in p ? (p.text as string) : \"\";\n          const textEvent: TextMessageChunkEvent = {\n            type: EventType.TEXT_MESSAGE_CHUNK,\n            role: \"assistant\",\n            messageId,\n            delta: textDelta,\n          };\n          yield textEvent;\n          break;\n        }\n\n        case \"tool-call\": {\n          const toolCallId = p.toolCallId as string;\n          const state = ensureToolCallState(toolCallId);\n          state.toolName = (p.toolName as string) ?? state.toolName;\n\n          if (!state.started) {\n            state.started = true;\n            const startEvent: ToolCallStartEvent = {\n              type: EventType.TOOL_CALL_START,\n              parentMessageId: messageId,\n              toolCallId,\n              toolCallName: p.toolName as string,\n            };\n            yield startEvent;\n          }\n\n          if (!state.hasArgsDelta && \"input\" in p && p.input !== undefined) {\n            let serializedInput = \"\";\n            if (typeof p.input === \"string\") {\n              serializedInput = p.input;\n            } else {\n              try {\n                serializedInput = JSON.stringify(p.input);\n              } catch {\n                serializedInput = String(p.input);\n              }\n            }\n\n            if (serializedInput.length > 0) {\n              const argsEvent: ToolCallArgsEvent = {\n                type: EventType.TOOL_CALL_ARGS,\n                toolCallId,\n                delta: serializedInput,\n              };\n              yield argsEvent;\n              state.hasArgsDelta = true;\n            }\n          }\n\n          if (!state.ended) {\n            state.ended = true;\n            const endEvent: ToolCallEndEvent = {\n              type: EventType.TOOL_CALL_END,\n              toolCallId,\n            };\n            yield endEvent;\n          }\n          break;\n        }\n\n        case \"tool-approval-request\": {\n          // AI SDK native human-in-the-loop: a tool declared `needsApproval`\n          // was called. The preceding \"tool-call\" part already streamed the\n          // tool name + args; this part carries the toolCallId to pause on.\n          // (Some shapes nest the call under `toolCall` — read both.)\n          const nested = (p.toolCall ?? {}) as {\n            toolCallId?: string;\n            toolName?: string;\n            input?: unknown;\n          };\n          const toolCallId =\n            (p.toolCallId as string | undefined) ?? nested.toolCallId;\n          if (!toolCallId) {\n            throw new Error(\n              \"AI SDK tool-approval-request is missing toolCallId\",\n            );\n          }\n          const state = ensureToolCallState(toolCallId);\n          const toolName = state.toolName ?? nested.toolName;\n\n          // Defensive: emit the tool-call lifecycle if the \"tool-call\" part\n          // didn't precede this one, so the assistant tool-call is in history\n          // for the resume run (which keys the injected result by toolCallId).\n          if (!state.started) {\n            state.started = true;\n            const startEvent: ToolCallStartEvent = {\n              type: EventType.TOOL_CALL_START,\n              parentMessageId: messageId,\n              toolCallId,\n              toolCallName: toolName ?? \"\",\n            };\n            yield startEvent;\n          }\n          if (!state.hasArgsDelta && nested.input !== undefined) {\n            let serialized = \"\";\n            try {\n              serialized =\n                typeof nested.input === \"string\"\n                  ? nested.input\n                  : JSON.stringify(nested.input);\n            } catch {\n              serialized = String(nested.input);\n            }\n            if (serialized.length > 0) {\n              const argsEvent: ToolCallArgsEvent = {\n                type: EventType.TOOL_CALL_ARGS,\n                toolCallId,\n                delta: serialized,\n              };\n              yield argsEvent;\n              state.hasArgsDelta = true;\n            }\n          }\n          if (!state.ended) {\n            state.ended = true;\n            const endEvent: ToolCallEndEvent = {\n              type: EventType.TOOL_CALL_END,\n              toolCallId,\n            };\n            yield endEvent;\n          }\n\n          pendingInterrupts?.push({\n            id: toolCallId,\n            toolCallId,\n            reason: \"tool_approval\",\n            message: toolName ? `Approve \"${toolName}\"?` : undefined,\n            ...(toolName ? { metadata: { toolName } } : {}),\n          });\n          break;\n        }\n\n        case \"tool-error\": {\n          const toolCallId = p.toolCallId as string | undefined;\n          if (!toolCallId) {\n            throw new Error(\"AI SDK tool-error is missing toolCallId\");\n          }\n\n          // Interrupt tools do not execute on the server. Their result is\n          // supplied by the human on the resume run, so suppress this part.\n          if (\n            pendingInterrupts?.some(\n              (interrupt) => interrupt.toolCallId === toolCallId,\n            )\n          ) {\n            toolCallStates.delete(toolCallId);\n            break;\n          }\n\n          toolCallStates.delete(toolCallId);\n          const resultEvent: ToolCallResultEvent = {\n            type: EventType.TOOL_CALL_RESULT,\n            role: \"tool\",\n            messageId: randomUUID(),\n            toolCallId,\n            // A tool exception is a tool result from the model's perspective.\n            // Keeping the Error prefix consistent with the core tool runner\n            // lets both the client and the next model step see the failure.\n            content: `Error: ${formatToolError(p.error)}`,\n          };\n          yield resultEvent;\n          break;\n        }\n\n        case \"tool-result\": {\n          // AI SDK tool-result uses \"output\"; older versions used \"result\" — check both\n          const toolResult =\n            \"output\" in p ? p.output : \"result\" in p ? p.result : null;\n          const toolName = \"toolName\" in p ? (p.toolName as string) : \"\";\n          toolCallStates.delete(p.toolCallId as string);\n\n          // Check if this is a state update tool\n          if (\n            toolName === \"AGUISendStateSnapshot\" &&\n            toolResult &&\n            typeof toolResult === \"object\"\n          ) {\n            const snapshot = (toolResult as Record<string, unknown>).snapshot;\n            if (snapshot !== undefined) {\n              const stateSnapshotEvent: StateSnapshotEvent = {\n                type: EventType.STATE_SNAPSHOT,\n                snapshot,\n              };\n              for (const event of normalizeStateEvent(stateSnapshotEvent)) {\n                yield event;\n              }\n            }\n          } else if (\n            toolName === \"AGUISendStateDelta\" &&\n            toolResult &&\n            typeof toolResult === \"object\"\n          ) {\n            const delta = (toolResult as { delta?: StateDeltaEvent[\"delta\"] })\n              .delta;\n            if (delta !== undefined) {\n              const stateDeltaEvent: StateDeltaEvent = {\n                type: EventType.STATE_DELTA,\n                delta,\n              };\n              for (const event of normalizeStateEvent(stateDeltaEvent)) {\n                yield event;\n              }\n            }\n          }\n\n          // Always emit the tool result event for the LLM\n          let serializedResult: string;\n          try {\n            serializedResult = JSON.stringify(toolResult);\n          } catch {\n            serializedResult = `[Unserializable tool result from ${toolName || \"unknown tool\"}]`;\n          }\n          const resultEvent: ToolCallResultEvent = {\n            type: EventType.TOOL_CALL_RESULT,\n            role: \"tool\",\n            messageId: randomUUID(),\n            toolCallId: p.toolCallId as string,\n            content: serializedResult,\n          };\n          yield resultEvent;\n          break;\n        }\n\n        case \"finish\": {\n          if (runFinishedDetails) {\n            Object.assign(runFinishedDetails, getAISDKRunFinishedDetails(p));\n          }\n          // Terminal — let the caller handle lifecycle\n          return;\n        }\n\n        case \"error\": {\n          if (abortSignal.aborted) {\n            return;\n          }\n          // Re-throw so the caller can emit RUN_ERROR\n          const err = p.error ?? p.message ?? p.cause;\n          if (err instanceof Error) throw err;\n          throw new Error(\n            typeof err === \"string\"\n              ? err\n              : `AI SDK stream error: ${JSON.stringify(p)}`,\n          );\n        }\n\n        // These AI SDK fullStream parts carry metadata that has no AG-UI event\n        // equivalent. They are known and intentionally ignored; listing them\n        // keeps the default's warning for genuinely new parts.\n        case \"start\":\n        case \"start-step\":\n        case \"finish-step\":\n        case \"text-end\":\n        case \"source\":\n        case \"file\":\n        case \"tool-output-denied\":\n        case \"raw\":\n          break;\n\n        default: {\n          // Parts come from the caller's own `ai` install, which can be newer\n          // than ours. Warn once per type and keep the run alive.\n          const unknownType = String(p.type);\n          if (!warnedUnknownPartTypes.has(unknownType)) {\n            warnedUnknownPartTypes.add(unknownType);\n            console.warn(\n              `[convertAISDKStream] Ignoring unhandled AI SDK stream part: ${unknownType}`,\n            );\n          }\n          break;\n        }\n      }\n    }\n  } finally {\n    // Always close reasoning on exit (normal or exceptional)\n    yield* closeReasoningIfOpen();\n  }\n}\n"],"mappings":"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"}

package/dist/agent/converters/aisdk.d.cts

@@ -0,0 +1,22 @@
+import { AgentRunFinishedDetails } from "./usage.cjs";
+import { BaseEvent, Interrupt } from "@ag-ui/client";
+
+//#region src/agent/converters/aisdk.d.ts
+/**
+ * Converts an AI SDK `fullStream` into AG-UI `BaseEvent` objects.
+ *
+ * This is a pure converter — it does NOT emit lifecycle events
+ * (RUN_STARTED / RUN_FINISHED / RUN_ERROR). The caller (Agent class)
+ * is responsible for those.
+ *
+ * Terminal stream events (finish, error, abort) cause the generator to
+ * return so the caller can handle lifecycle appropriately.
+ *
+ * `pendingInterrupts`, when provided, is filled with one AG-UI Interrupt per
+ * AI SDK `tool-approval-request` part (a tool declared `needsApproval: true`).
+ * The caller turns a non-empty array into a RUN_FINISHED `outcome:interrupt`.
+ */
+declare function convertAISDKStream(fullStream: AsyncIterable<unknown>, abortSignal: AbortSignal, pendingInterrupts?: Interrupt[], initialState?: unknown, runFinishedDetails?: AgentRunFinishedDetails): AsyncGenerator<BaseEvent>;
+//#endregion
+export { convertAISDKStream };
+//# sourceMappingURL=aisdk.d.cts.map

package/dist/agent/converters/aisdk.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aisdk.d.cts","names":[],"sources":["../../../src/agent/converters/aisdk.ts"],"mappings":";;;;;;;;;;;;;;;;;;iBAoHuB,kBAAA,CACrB,UAAA,EAAY,aAAA,WACZ,WAAA,EAAa,WAAA,EACb,iBAAA,GAAoB,SAAA,IACpB,YAAA,YACA,kBAAA,GAAqB,uBAAA,GACpB,cAAA,CAAe,SAAA"}