@copilotkit/shared 0.0.0-main-20260126221712 → 0.0.0-main-20260402184302

package/CHANGELOG.md

@@ -1,10 +1,158 @@
 # @copilotkit/shared
 
-## 0.0.0-main-20260126221712
+## 0.0.0-main-20260402184302
+
+### Minor Changes
+
+- 1ceb963: refactor: consolidate V1/V2 packages into flat @copilotkit/\* structure
+
+## 1.55.0-next.8
+
+## 1.55.0-next.7
+
+### Minor Changes
+
+- 1ceb963: refactor: consolidate V1/V2 packages into flat @copilotkit/\* structure
+
+## 1.54.1-next.6
+
+## 1.54.1-next.5
+
+## 1.54.1-next.4
+
+## 1.54.1-next.3
+
+## 1.54.1-next.2
+
+## 1.54.1-next.1
+
+## 1.54.1-next.0
+
+## 1.54.0
+
+## 1.54.0-next.9
+
+## 1.54.0-next.8
+
+## 1.54.0-next.7
+
+## 1.54.0-next.6
+
+## 1.54.0-next.5
+
+## 1.54.0-next.4
+
+## 1.54.0-next.3
+
+## 1.53.1-next.2
+
+## 1.53.1-next.1
+
+## 1.53.1-next.0
+
+## 1.53.0
+
+### Patch Changes
+
+- 1510f64: feat: enable mcp and a2ui middleware directly from copilotkit runtime
+- bf1fc6f: fix: `convertJsonSchemaToZodSchema` drops enum constraints
+
+## 1.53.0-next.6
+
+## 1.53.0-next.5
+
+## 1.52.2-next.4
+
+## 1.52.2-next.3
+
+### Patch Changes
+
+- 1510f64: feat: enable mcp and a2ui middleware directly from copilotkit runtime
+
+## 1.52.2-next.2
+
+## 1.52.2-next.1
+
+### Patch Changes
+
+- bf1fc6f: fix: `convertJsonSchemaToZodSchema` drops enum constraints
+
+## 1.52.2-next.0
+
+## 1.52.1
+
+## 1.52.1-next.1
+
+## 1.52.1-next.0
+
+## 1.52.0
+
+### Patch Changes
+
+- ef0f539: Add reasoning support and default components for reasoning messages
+
+## 1.52.0-next.8
+
+## 1.52.0-next.7
+
+## 1.52.0-next.6
+
+## 1.52.0-next.5
+
+## 1.51.5-next.4
+
+## 1.51.5-next.3
+
+## 1.51.5-next.2
+
+## 1.51.5-next.1
+
+## 1.51.5-next.0
+
+### Patch Changes
+
+- ef0f539: Add reasoning support and default components for reasoning messages
+
+## 1.51.4
+
+## 1.51.4-next.8
+
+## 1.51.4-next.7
+
+## 1.51.4-next.6
+
+## 1.51.4-next.5
+
+## 1.51.4-next.4
+
+## 1.51.4-next.3
+
+## 1.51.4-next.2
+
+## 1.51.4-next.1
+
+## 1.51.4-next.0
+
+## 1.51.3
 
 ### Patch Changes
 
 - d655e75: fix: update ag-ui dependencies
+- d36fc1e: Add UMD export
+
+## 1.51.3-next.8
+
+### Patch Changes
+
+- d36fc1e: Add UMD export
+
+## 1.51.3-next.7
+
+## 1.51.3-next.6
+
+## 1.51.3-next.5
+
+## 1.51.3-next.4
 
 ## 1.51.3-next.3
 
@@ -283,12 +431,14 @@
   agentic runtimes we acquired tech-debt that, with this PR, is being alleviated.
 
   As such, the following features have been updated to be completely functional with Headless UI.
+
   - Generative UI
   - Suggestions
   - Agentic Generative UI
   - Interrupts
 
   In addition, a variety of QOL changes have been made.
+
   - New AG-UI based message types
   - Inline code rendering is fixed
 
@@ -300,15 +450,19 @@
 - 6d1de58: - fix: address issues that would cause headless UI breaking changes in the next release
 
   Signed-off-by: Tyler Slaton <tyler@copilotkit.ai>
+
   - fix: more fixes addressing breaking changes in new Headless UI
 
   Signed-off-by: Tyler Slaton <tyler@copilotkit.ai>
+
   - chore: address linting issues
 
   Signed-off-by: Tyler Slaton <tyler@copilotkit.ai>
+
   - chore: fixing branding and docs
 
   Signed-off-by: Tyler Slaton <tyler@copilotkit.ai>
+
   - chore: more docs fixing
 
   Signed-off-by: Tyler Slaton <tyler@copilotkit.ai>
@@ -326,15 +480,19 @@
 - 6d1de58: - fix: address issues that would cause headless UI breaking changes in the next release
 
   Signed-off-by: Tyler Slaton <tyler@copilotkit.ai>
+
   - fix: more fixes addressing breaking changes in new Headless UI
 
   Signed-off-by: Tyler Slaton <tyler@copilotkit.ai>
+
   - chore: address linting issues
 
   Signed-off-by: Tyler Slaton <tyler@copilotkit.ai>
+
   - chore: fixing branding and docs
 
   Signed-off-by: Tyler Slaton <tyler@copilotkit.ai>
+
   - chore: more docs fixing
 
   Signed-off-by: Tyler Slaton <tyler@copilotkit.ai>
@@ -371,12 +529,14 @@
   agentic runtimes we acquired tech-debt that, with this PR, is being alleviated.
 
   As such, the following features have been updated to be completely functional with Headless UI.
+
   - Generative UI
   - Suggestions
   - Agentic Generative UI
   - Interrupts
 
   In addition, a variety of QOL changes have been made.
+
   - New AG-UI based message types
   - Inline code rendering is fixed
 
@@ -407,6 +567,7 @@
 ### Patch Changes
 
 - fac89c2: - refactor: rename onTrace to onError throughout codebase
+
   - Rename CopilotTraceEvent to CopilotErrorEvent and CopilotTraceHandler to CopilotErrorHandler
 
 - 9169ad7: - feat: add onTrace handler for runtime and UI error/event tracking
@@ -1039,6 +1200,7 @@
 - e16d95e: New prerelease
 - 1721cbd: Add convertActionsToDynamicStructuredTools to sdk-js
 - CopilotKit Core:
+
   - Improved error messages and overall logs
   - `useCopilotAction.renderAndAwait` renamed to `.renderAndAwaitForResponse` (backwards compatible, will be deprecated in the future)
   - Improved scrolling behavior. It is now possible to scroll up during LLM response generation
@@ -1046,6 +1208,7 @@
   - Updated interfaces for better developer ergonomics
 
   CoAgents:
+
   - Renamed `remoteActions` to `remoteEndpoints` (backwards compatible, will be deprecated in the future)
   - Support for LangGraph Platform in Remote Endpoints
   - LangGraph JS Support for CoAgents (locally via `langgraph dev`, `langgraph up` or deployed to LangGraph Platform)
@@ -1053,6 +1216,7 @@
   - Enhanced state management and message handling
 
   CopilotKid Back-end SDK:
+
   - Released a whole-new `@copilotkit/sdk-js` for building agents with LangGraph JS Support
 
 - 8d0144f: bump
@@ -1393,6 +1557,7 @@ CopilotKid Back-end SDK:
 ### Major Changes
 
 - b6a4b6eb: V1.0 Release Candidate
+
   - A robust new protocol between the frontend and the Copilot Runtime
   - Support for Copilot Cloud
   - Generative UI

package/README.md

@@ -48,9 +48,9 @@
 const { visibleMessages, appendMessage, setMessages, ... } = useCopilotChat();
 
 // Pre-built components with deep customization options (CSS + pass custom sub-components)
-<CopilotPopup 
-  instructions={"You are assisting the user as best as you can. Answer in the best way possible given the data you have."} 
-  labels={{ title: "Popup Assistant", initial: "Need any help?" }} 
+<CopilotPopup
+  instructions={"You are assisting the user as best as you can. Answer in the best way possible given the data you have."}
+  labels={{ title: "Popup Assistant", initial: "Need any help?" }}
 />
 ```
 
@@ -71,9 +71,9 @@ useCopilotAction({
 
 ```ts
 // Share state between app and agent
-const { agentState } = useCoAgent({ 
-  name: "basic_agent", 
-  initialState: { input: "NYC" } 
+const { agentState } = useCoAgent({
+  name: "basic_agent",
+  initialState: { input: "NYC" }
 });
 
 // agentic generative UI
@@ -114,14 +114,20 @@ useCopilotAction({
 ```ts
 // intermediate agent state streaming (supports both LangGraph.js + LangGraph python)
 const modifiedConfig = copilotKitCustomizeConfig(config, {
-  emitIntermediateState: [{ 
-    stateKey: "outline", 
-    tool: "set_outline", 
-    toolArgument: "outline" 
-  }],
+  emitIntermediateState: [
+    {
+      stateKey: "outline",
+      tool: "set_outline",
+      toolArgument: "outline",
+    },
+  ],
 });
-const response = await ChatOpenAI({ model: "gpt-4o" }).invoke(messages, modifiedConfig);
+const response = await ChatOpenAI({ model: "gpt-4o" }).invoke(
+  messages,
+  modifiedConfig,
+);
 ```
+
 ## 🏆 Featured Examples
 
 <p align="center">

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/constants/index.cjs

@@ -0,0 +1,18 @@
+
+//#region src/constants/index.ts
+const COPILOT_CLOUD_API_URL = "https://api.cloud.copilotkit.ai";
+const COPILOT_CLOUD_VERSION = "v1";
+const COPILOT_CLOUD_CHAT_URL = `${COPILOT_CLOUD_API_URL}/copilotkit/${COPILOT_CLOUD_VERSION}`;
+const COPILOT_CLOUD_PUBLIC_API_KEY_HEADER = "X-CopilotCloud-Public-Api-Key";
+const DEFAULT_AGENT_ID = "default";
+/** Phoenix channel event name used for all AG-UI events. */
+const AG_UI_CHANNEL_EVENT = "ag-ui";
+
+//#endregion
+exports.AG_UI_CHANNEL_EVENT = AG_UI_CHANNEL_EVENT;
+exports.COPILOT_CLOUD_API_URL = COPILOT_CLOUD_API_URL;
+exports.COPILOT_CLOUD_CHAT_URL = COPILOT_CLOUD_CHAT_URL;
+exports.COPILOT_CLOUD_PUBLIC_API_KEY_HEADER = COPILOT_CLOUD_PUBLIC_API_KEY_HEADER;
+exports.COPILOT_CLOUD_VERSION = COPILOT_CLOUD_VERSION;
+exports.DEFAULT_AGENT_ID = DEFAULT_AGENT_ID;
+//# sourceMappingURL=index.cjs.map

package/dist/constants/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":[],"sources":["../../src/constants/index.ts"],"sourcesContent":["export const COPILOT_CLOUD_API_URL = \"https://api.cloud.copilotkit.ai\";\nexport const COPILOT_CLOUD_VERSION = \"v1\";\nexport const COPILOT_CLOUD_CHAT_URL = `${COPILOT_CLOUD_API_URL}/copilotkit/${COPILOT_CLOUD_VERSION}`;\nexport const COPILOT_CLOUD_PUBLIC_API_KEY_HEADER =\n  \"X-CopilotCloud-Public-Api-Key\";\n\nexport const DEFAULT_AGENT_ID = \"default\";\n\n/** Phoenix channel event name used for all AG-UI events. */\nexport const AG_UI_CHANNEL_EVENT = \"ag-ui\";\n"],"mappings":";;AAAA,MAAa,wBAAwB;AACrC,MAAa,wBAAwB;AACrC,MAAa,yBAAyB,GAAG,sBAAsB,cAAc;AAC7E,MAAa,sCACX;AAEF,MAAa,mBAAmB;;AAGhC,MAAa,sBAAsB"}

package/dist/constants/index.d.cts

@@ -0,0 +1,11 @@
+//#region src/constants/index.d.ts
+declare const COPILOT_CLOUD_API_URL = "https://api.cloud.copilotkit.ai";
+declare const COPILOT_CLOUD_VERSION = "v1";
+declare const COPILOT_CLOUD_CHAT_URL = "https://api.cloud.copilotkit.ai/copilotkit/v1";
+declare const COPILOT_CLOUD_PUBLIC_API_KEY_HEADER = "X-CopilotCloud-Public-Api-Key";
+declare const DEFAULT_AGENT_ID = "default";
+/** Phoenix channel event name used for all AG-UI events. */
+declare const AG_UI_CHANNEL_EVENT = "ag-ui";
+//#endregion
+export { AG_UI_CHANNEL_EVENT, COPILOT_CLOUD_API_URL, COPILOT_CLOUD_CHAT_URL, COPILOT_CLOUD_PUBLIC_API_KEY_HEADER, COPILOT_CLOUD_VERSION, DEFAULT_AGENT_ID };
+//# sourceMappingURL=index.d.cts.map

package/dist/constants/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","names":[],"sources":["../../src/constants/index.ts"],"mappings":";cAAa,qBAAA;AAAA,cACA,qBAAA;AAAA,cACA,sBAAA;AAAA,cACA,mCAAA;AAAA,cAGA,gBAAA;;cAGA,mBAAA"}

package/dist/constants/index.d.mts

@@ -0,0 +1,11 @@
+//#region src/constants/index.d.ts
+declare const COPILOT_CLOUD_API_URL = "https://api.cloud.copilotkit.ai";
+declare const COPILOT_CLOUD_VERSION = "v1";
+declare const COPILOT_CLOUD_CHAT_URL = "https://api.cloud.copilotkit.ai/copilotkit/v1";
+declare const COPILOT_CLOUD_PUBLIC_API_KEY_HEADER = "X-CopilotCloud-Public-Api-Key";
+declare const DEFAULT_AGENT_ID = "default";
+/** Phoenix channel event name used for all AG-UI events. */
+declare const AG_UI_CHANNEL_EVENT = "ag-ui";
+//#endregion
+export { AG_UI_CHANNEL_EVENT, COPILOT_CLOUD_API_URL, COPILOT_CLOUD_CHAT_URL, COPILOT_CLOUD_PUBLIC_API_KEY_HEADER, COPILOT_CLOUD_VERSION, DEFAULT_AGENT_ID };
+//# sourceMappingURL=index.d.mts.map

package/dist/constants/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/constants/index.ts"],"mappings":";cAAa,qBAAA;AAAA,cACA,qBAAA;AAAA,cACA,sBAAA;AAAA,cACA,mCAAA;AAAA,cAGA,gBAAA;;cAGA,mBAAA"}

package/dist/constants/index.mjs

@@ -1,13 +1,12 @@
-import {
-  COPILOT_CLOUD_API_URL,
-  COPILOT_CLOUD_CHAT_URL,
-  COPILOT_CLOUD_PUBLIC_API_KEY_HEADER,
-  COPILOT_CLOUD_VERSION
-} from "../chunk-GYZIHHE6.mjs";
-export {
-  COPILOT_CLOUD_API_URL,
-  COPILOT_CLOUD_CHAT_URL,
-  COPILOT_CLOUD_PUBLIC_API_KEY_HEADER,
-  COPILOT_CLOUD_VERSION
-};
+//#region src/constants/index.ts
+const COPILOT_CLOUD_API_URL = "https://api.cloud.copilotkit.ai";
+const COPILOT_CLOUD_VERSION = "v1";
+const COPILOT_CLOUD_CHAT_URL = `${COPILOT_CLOUD_API_URL}/copilotkit/${COPILOT_CLOUD_VERSION}`;
+const COPILOT_CLOUD_PUBLIC_API_KEY_HEADER = "X-CopilotCloud-Public-Api-Key";
+const DEFAULT_AGENT_ID = "default";
+/** Phoenix channel event name used for all AG-UI events. */
+const AG_UI_CHANNEL_EVENT = "ag-ui";
+
+//#endregion
+export { AG_UI_CHANNEL_EVENT, COPILOT_CLOUD_API_URL, COPILOT_CLOUD_CHAT_URL, COPILOT_CLOUD_PUBLIC_API_KEY_HEADER, COPILOT_CLOUD_VERSION, DEFAULT_AGENT_ID };
 //# sourceMappingURL=index.mjs.map

package/dist/constants/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}
+{"version":3,"file":"index.mjs","names":[],"sources":["../../src/constants/index.ts"],"sourcesContent":["export const COPILOT_CLOUD_API_URL = \"https://api.cloud.copilotkit.ai\";\nexport const COPILOT_CLOUD_VERSION = \"v1\";\nexport const COPILOT_CLOUD_CHAT_URL = `${COPILOT_CLOUD_API_URL}/copilotkit/${COPILOT_CLOUD_VERSION}`;\nexport const COPILOT_CLOUD_PUBLIC_API_KEY_HEADER =\n  \"X-CopilotCloud-Public-Api-Key\";\n\nexport const DEFAULT_AGENT_ID = \"default\";\n\n/** Phoenix channel event name used for all AG-UI events. */\nexport const AG_UI_CHANNEL_EVENT = \"ag-ui\";\n"],"mappings":";AAAA,MAAa,wBAAwB;AACrC,MAAa,wBAAwB;AACrC,MAAa,yBAAyB,GAAG,sBAAsB,cAAc;AAC7E,MAAa,sCACX;AAEF,MAAa,mBAAmB;;AAGhC,MAAa,sBAAsB"}

package/dist/finalize-events.cjs

@@ -0,0 +1,106 @@
+const require_runtime = require('./_virtual/_rolldown/runtime.cjs');
+const require_random_id = require('./utils/random-id.cjs');
+let _ag_ui_client = require("@ag-ui/client");
+
+//#region src/finalize-events.ts
+const defaultStopMessage = "Run stopped by user";
+const defaultAbruptEndMessage = "Run ended without emitting a terminal event";
+function finalizeRunEvents(events, options = {}) {
+	const { stopRequested = false, interruptionMessage } = options;
+	const resolvedStopMessage = interruptionMessage ?? defaultStopMessage;
+	const resolvedAbruptMessage = interruptionMessage && interruptionMessage !== defaultStopMessage ? interruptionMessage : defaultAbruptEndMessage;
+	const appended = [];
+	const openMessageIds = /* @__PURE__ */ new Set();
+	const openToolCalls = /* @__PURE__ */ new Map();
+	for (const event of events) switch (event.type) {
+		case _ag_ui_client.EventType.TEXT_MESSAGE_START: {
+			const messageId = event.messageId;
+			if (typeof messageId === "string") openMessageIds.add(messageId);
+			break;
+		}
+		case _ag_ui_client.EventType.TEXT_MESSAGE_END: {
+			const messageId = event.messageId;
+			if (typeof messageId === "string") openMessageIds.delete(messageId);
+			break;
+		}
+		case _ag_ui_client.EventType.TOOL_CALL_START: {
+			const toolCallId = event.toolCallId;
+			if (typeof toolCallId === "string") openToolCalls.set(toolCallId, {
+				hasEnd: false,
+				hasResult: false
+			});
+			break;
+		}
+		case _ag_ui_client.EventType.TOOL_CALL_END: {
+			const toolCallId = event.toolCallId;
+			const info = toolCallId ? openToolCalls.get(toolCallId) : void 0;
+			if (info) info.hasEnd = true;
+			break;
+		}
+		case _ag_ui_client.EventType.TOOL_CALL_RESULT: {
+			const toolCallId = event.toolCallId;
+			const info = toolCallId ? openToolCalls.get(toolCallId) : void 0;
+			if (info) info.hasResult = true;
+			break;
+		}
+		default: break;
+	}
+	const hasRunFinished = events.some((event) => event.type === _ag_ui_client.EventType.RUN_FINISHED);
+	const hasRunError = events.some((event) => event.type === _ag_ui_client.EventType.RUN_ERROR);
+	const terminalEventMissing = !(hasRunFinished || hasRunError);
+	for (const messageId of openMessageIds) {
+		const endEvent = {
+			type: _ag_ui_client.EventType.TEXT_MESSAGE_END,
+			messageId
+		};
+		events.push(endEvent);
+		appended.push(endEvent);
+	}
+	for (const [toolCallId, info] of openToolCalls) {
+		if (!info.hasEnd) {
+			const endEvent = {
+				type: _ag_ui_client.EventType.TOOL_CALL_END,
+				toolCallId
+			};
+			events.push(endEvent);
+			appended.push(endEvent);
+		}
+		if (terminalEventMissing && !info.hasResult) {
+			const resultEvent = {
+				type: _ag_ui_client.EventType.TOOL_CALL_RESULT,
+				toolCallId,
+				messageId: `${toolCallId ?? require_random_id.randomUUID()}-result`,
+				role: "tool",
+				content: JSON.stringify(stopRequested ? {
+					status: "stopped",
+					reason: "stop_requested",
+					message: resolvedStopMessage
+				} : {
+					status: "error",
+					reason: "missing_terminal_event",
+					message: resolvedAbruptMessage
+				})
+			};
+			events.push(resultEvent);
+			appended.push(resultEvent);
+		}
+	}
+	if (terminalEventMissing) if (stopRequested) {
+		const finishedEvent = { type: _ag_ui_client.EventType.RUN_FINISHED };
+		events.push(finishedEvent);
+		appended.push(finishedEvent);
+	} else {
+		const errorEvent = {
+			type: _ag_ui_client.EventType.RUN_ERROR,
+			message: resolvedAbruptMessage,
+			code: "INCOMPLETE_STREAM"
+		};
+		events.push(errorEvent);
+		appended.push(errorEvent);
+	}
+	return appended;
+}
+
+//#endregion
+exports.finalizeRunEvents = finalizeRunEvents;
+//# sourceMappingURL=finalize-events.cjs.map

package/dist/finalize-events.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"finalize-events.cjs","names":["EventType","randomUUID"],"sources":["../src/finalize-events.ts"],"sourcesContent":["import { BaseEvent, EventType, RunErrorEvent } from \"@ag-ui/client\";\nimport { randomUUID } from \"./utils\";\n\ninterface FinalizeRunOptions {\n  stopRequested?: boolean;\n  interruptionMessage?: string;\n}\n\nconst defaultStopMessage = \"Run stopped by user\";\nconst defaultAbruptEndMessage = \"Run ended without emitting a terminal event\";\n\nexport function finalizeRunEvents(\n  events: BaseEvent[],\n  options: FinalizeRunOptions = {},\n): BaseEvent[] {\n  const { stopRequested = false, interruptionMessage } = options;\n\n  const resolvedStopMessage = interruptionMessage ?? defaultStopMessage;\n  const resolvedAbruptMessage =\n    interruptionMessage && interruptionMessage !== defaultStopMessage\n      ? interruptionMessage\n      : defaultAbruptEndMessage;\n\n  const appended: BaseEvent[] = [];\n\n  const openMessageIds = new Set<string>();\n  const openToolCalls = new Map<\n    string,\n    {\n      hasEnd: boolean;\n      hasResult: boolean;\n    }\n  >();\n\n  for (const event of events) {\n    switch (event.type) {\n      case EventType.TEXT_MESSAGE_START: {\n        const messageId = (event as { messageId?: string }).messageId;\n        if (typeof messageId === \"string\") {\n          openMessageIds.add(messageId);\n        }\n        break;\n      }\n      case EventType.TEXT_MESSAGE_END: {\n        const messageId = (event as { messageId?: string }).messageId;\n        if (typeof messageId === \"string\") {\n          openMessageIds.delete(messageId);\n        }\n        break;\n      }\n      case EventType.TOOL_CALL_START: {\n        const toolCallId = (event as { toolCallId?: string }).toolCallId;\n        if (typeof toolCallId === \"string\") {\n          openToolCalls.set(toolCallId, {\n            hasEnd: false,\n            hasResult: false,\n          });\n        }\n        break;\n      }\n      case EventType.TOOL_CALL_END: {\n        const toolCallId = (event as { toolCallId?: string }).toolCallId;\n        const info = toolCallId ? openToolCalls.get(toolCallId) : undefined;\n        if (info) {\n          info.hasEnd = true;\n        }\n        break;\n      }\n      case EventType.TOOL_CALL_RESULT: {\n        const toolCallId = (event as { toolCallId?: string }).toolCallId;\n        const info = toolCallId ? openToolCalls.get(toolCallId) : undefined;\n        if (info) {\n          info.hasResult = true;\n        }\n        break;\n      }\n      default:\n        break;\n    }\n  }\n\n  const hasRunFinished = events.some(\n    (event) => event.type === EventType.RUN_FINISHED,\n  );\n  const hasRunError = events.some(\n    (event) => event.type === EventType.RUN_ERROR,\n  );\n  const hasTerminalEvent = hasRunFinished || hasRunError;\n  const terminalEventMissing = !hasTerminalEvent;\n\n  for (const messageId of openMessageIds) {\n    const endEvent = {\n      type: EventType.TEXT_MESSAGE_END,\n      messageId,\n    } as BaseEvent;\n    events.push(endEvent);\n    appended.push(endEvent);\n  }\n\n  for (const [toolCallId, info] of openToolCalls) {\n    if (!info.hasEnd) {\n      const endEvent = {\n        type: EventType.TOOL_CALL_END,\n        toolCallId,\n      } as BaseEvent;\n      events.push(endEvent);\n      appended.push(endEvent);\n    }\n\n    if (terminalEventMissing && !info.hasResult) {\n      const resultEvent = {\n        type: EventType.TOOL_CALL_RESULT,\n        toolCallId,\n        messageId: `${toolCallId ?? randomUUID()}-result`,\n        role: \"tool\",\n        content: JSON.stringify(\n          stopRequested\n            ? {\n                status: \"stopped\",\n                reason: \"stop_requested\",\n                message: resolvedStopMessage,\n              }\n            : {\n                status: \"error\",\n                reason: \"missing_terminal_event\",\n                message: resolvedAbruptMessage,\n              },\n        ),\n      } as BaseEvent;\n      events.push(resultEvent);\n      appended.push(resultEvent);\n    }\n  }\n\n  if (terminalEventMissing) {\n    if (stopRequested) {\n      const finishedEvent = {\n        type: EventType.RUN_FINISHED,\n      } as BaseEvent;\n      events.push(finishedEvent);\n      appended.push(finishedEvent);\n    } else {\n      const errorEvent: RunErrorEvent = {\n        type: EventType.RUN_ERROR,\n        message: resolvedAbruptMessage,\n        code: \"INCOMPLETE_STREAM\",\n      };\n      events.push(errorEvent);\n      appended.push(errorEvent);\n    }\n  }\n\n  return appended;\n}\n"],"mappings":";;;;;AAQA,MAAM,qBAAqB;AAC3B,MAAM,0BAA0B;AAEhC,SAAgB,kBACd,QACA,UAA8B,EAAE,EACnB;CACb,MAAM,EAAE,gBAAgB,OAAO,wBAAwB;CAEvD,MAAM,sBAAsB,uBAAuB;CACnD,MAAM,wBACJ,uBAAuB,wBAAwB,qBAC3C,sBACA;CAEN,MAAM,WAAwB,EAAE;CAEhC,MAAM,iCAAiB,IAAI,KAAa;CACxC,MAAM,gCAAgB,IAAI,KAMvB;AAEH,MAAK,MAAM,SAAS,OAClB,SAAQ,MAAM,MAAd;EACE,KAAKA,wBAAU,oBAAoB;GACjC,MAAM,YAAa,MAAiC;AACpD,OAAI,OAAO,cAAc,SACvB,gBAAe,IAAI,UAAU;AAE/B;;EAEF,KAAKA,wBAAU,kBAAkB;GAC/B,MAAM,YAAa,MAAiC;AACpD,OAAI,OAAO,cAAc,SACvB,gBAAe,OAAO,UAAU;AAElC;;EAEF,KAAKA,wBAAU,iBAAiB;GAC9B,MAAM,aAAc,MAAkC;AACtD,OAAI,OAAO,eAAe,SACxB,eAAc,IAAI,YAAY;IAC5B,QAAQ;IACR,WAAW;IACZ,CAAC;AAEJ;;EAEF,KAAKA,wBAAU,eAAe;GAC5B,MAAM,aAAc,MAAkC;GACtD,MAAM,OAAO,aAAa,cAAc,IAAI,WAAW,GAAG;AAC1D,OAAI,KACF,MAAK,SAAS;AAEhB;;EAEF,KAAKA,wBAAU,kBAAkB;GAC/B,MAAM,aAAc,MAAkC;GACtD,MAAM,OAAO,aAAa,cAAc,IAAI,WAAW,GAAG;AAC1D,OAAI,KACF,MAAK,YAAY;AAEnB;;EAEF,QACE;;CAIN,MAAM,iBAAiB,OAAO,MAC3B,UAAU,MAAM,SAASA,wBAAU,aACrC;CACD,MAAM,cAAc,OAAO,MACxB,UAAU,MAAM,SAASA,wBAAU,UACrC;CAED,MAAM,uBAAuB,EADJ,kBAAkB;AAG3C,MAAK,MAAM,aAAa,gBAAgB;EACtC,MAAM,WAAW;GACf,MAAMA,wBAAU;GAChB;GACD;AACD,SAAO,KAAK,SAAS;AACrB,WAAS,KAAK,SAAS;;AAGzB,MAAK,MAAM,CAAC,YAAY,SAAS,eAAe;AAC9C,MAAI,CAAC,KAAK,QAAQ;GAChB,MAAM,WAAW;IACf,MAAMA,wBAAU;IAChB;IACD;AACD,UAAO,KAAK,SAAS;AACrB,YAAS,KAAK,SAAS;;AAGzB,MAAI,wBAAwB,CAAC,KAAK,WAAW;GAC3C,MAAM,cAAc;IAClB,MAAMA,wBAAU;IAChB;IACA,WAAW,GAAG,cAAcC,8BAAY,CAAC;IACzC,MAAM;IACN,SAAS,KAAK,UACZ,gBACI;KACE,QAAQ;KACR,QAAQ;KACR,SAAS;KACV,GACD;KACE,QAAQ;KACR,QAAQ;KACR,SAAS;KACV,CACN;IACF;AACD,UAAO,KAAK,YAAY;AACxB,YAAS,KAAK,YAAY;;;AAI9B,KAAI,qBACF,KAAI,eAAe;EACjB,MAAM,gBAAgB,EACpB,MAAMD,wBAAU,cACjB;AACD,SAAO,KAAK,cAAc;AAC1B,WAAS,KAAK,cAAc;QACvB;EACL,MAAM,aAA4B;GAChC,MAAMA,wBAAU;GAChB,SAAS;GACT,MAAM;GACP;AACD,SAAO,KAAK,WAAW;AACvB,WAAS,KAAK,WAAW;;AAI7B,QAAO"}

package/dist/finalize-events.d.cts

@@ -0,0 +1,11 @@
+import { BaseEvent } from "@ag-ui/client";
+
+//#region src/finalize-events.d.ts
+interface FinalizeRunOptions {
+  stopRequested?: boolean;
+  interruptionMessage?: string;
+}
+declare function finalizeRunEvents(events: BaseEvent[], options?: FinalizeRunOptions): BaseEvent[];
+//#endregion
+export { finalizeRunEvents };
+//# sourceMappingURL=finalize-events.d.cts.map

package/dist/finalize-events.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"finalize-events.d.cts","names":[],"sources":["../src/finalize-events.ts"],"mappings":";;;UAGU,kBAAA;EACR,aAAA;EACA,mBAAA;AAAA;AAAA,iBAMc,iBAAA,CACd,MAAA,EAAQ,SAAA,IACR,OAAA,GAAS,kBAAA,GACR,SAAA"}

package/dist/finalize-events.d.mts

@@ -0,0 +1,11 @@
+import { BaseEvent } from "@ag-ui/client";
+
+//#region src/finalize-events.d.ts
+interface FinalizeRunOptions {
+  stopRequested?: boolean;
+  interruptionMessage?: string;
+}
+declare function finalizeRunEvents(events: BaseEvent[], options?: FinalizeRunOptions): BaseEvent[];
+//#endregion
+export { finalizeRunEvents };
+//# sourceMappingURL=finalize-events.d.mts.map

package/dist/finalize-events.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"finalize-events.d.mts","names":[],"sources":["../src/finalize-events.ts"],"mappings":";;;UAGU,kBAAA;EACR,aAAA;EACA,mBAAA;AAAA;AAAA,iBAMc,iBAAA,CACd,MAAA,EAAQ,SAAA,IACR,OAAA,GAAS,kBAAA,GACR,SAAA"}