@copilotkit/shared 0.0.0-main-20260220223427 → 0.0.0-main-20260403195251

package/CHANGELOG.md

@@ -1,11 +1,110 @@
 # @copilotkit/shared
 
-## 0.0.0-main-20260220223427
+## 0.0.0-main-20260403195251
+
+### Minor Changes
+
+- 1ceb963: refactor: consolidate V1/V2 packages into flat @copilotkit/\* structure
+
+### Patch Changes
+
+- 52a9322: Fixing license warnings, barrel export and typing
+
+## 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
@@ -336,12 +435,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
 
@@ -353,15 +454,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>
@@ -379,15 +484,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>
@@ -424,12 +533,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
 
@@ -460,6 +571,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
@@ -1092,6 +1204,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
@@ -1099,6 +1212,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)
@@ -1106,6 +1220,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
@@ -1446,6 +1561,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/dist/constants/index.cjs

@@ -4,10 +4,15 @@ 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

@@ -1 +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"],"mappings":";;AAAA,MAAa,wBAAwB;AACrC,MAAa,wBAAwB;AACrC,MAAa,yBAAyB,GAAG,sBAAsB,cAAc;AAC7E,MAAa,sCACX"}
+{"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

@@ -3,6 +3,9 @@ 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 { COPILOT_CLOUD_API_URL, COPILOT_CLOUD_CHAT_URL, COPILOT_CLOUD_PUBLIC_API_KEY_HEADER, COPILOT_CLOUD_VERSION };
+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

@@ -1 +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"}
+{"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

@@ -3,6 +3,9 @@ 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 { COPILOT_CLOUD_API_URL, COPILOT_CLOUD_CHAT_URL, COPILOT_CLOUD_PUBLIC_API_KEY_HEADER, COPILOT_CLOUD_VERSION };
+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

@@ -1 +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"}
+{"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.d.ts

@@ -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.ts.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.mjs

@@ -3,7 +3,10 @@ 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 { COPILOT_CLOUD_API_URL, COPILOT_CLOUD_CHAT_URL, COPILOT_CLOUD_PUBLIC_API_KEY_HEADER, COPILOT_CLOUD_VERSION };
+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,"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"],"mappings":";AAAA,MAAa,wBAAwB;AACrC,MAAa,wBAAwB;AACrC,MAAa,yBAAyB,GAAG,sBAAsB,cAAc;AAC7E,MAAa,sCACX"}
+{"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"}

package/dist/finalize-events.d.ts

@@ -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.ts.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.mjs

@@ -0,0 +1,105 @@
+import { randomUUID } from "./utils/random-id.mjs";
+import { EventType } from "@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 EventType.TEXT_MESSAGE_START: {
+			const messageId = event.messageId;
+			if (typeof messageId === "string") openMessageIds.add(messageId);
+			break;
+		}
+		case EventType.TEXT_MESSAGE_END: {
+			const messageId = event.messageId;
+			if (typeof messageId === "string") openMessageIds.delete(messageId);
+			break;
+		}
+		case EventType.TOOL_CALL_START: {
+			const toolCallId = event.toolCallId;
+			if (typeof toolCallId === "string") openToolCalls.set(toolCallId, {
+				hasEnd: false,
+				hasResult: false
+			});
+			break;
+		}
+		case EventType.TOOL_CALL_END: {
+			const toolCallId = event.toolCallId;
+			const info = toolCallId ? openToolCalls.get(toolCallId) : void 0;
+			if (info) info.hasEnd = true;
+			break;
+		}
+		case 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 === EventType.RUN_FINISHED);
+	const hasRunError = events.some((event) => event.type === EventType.RUN_ERROR);
+	const terminalEventMissing = !(hasRunFinished || hasRunError);
+	for (const messageId of openMessageIds) {
+		const endEvent = {
+			type: EventType.TEXT_MESSAGE_END,
+			messageId
+		};
+		events.push(endEvent);
+		appended.push(endEvent);
+	}
+	for (const [toolCallId, info] of openToolCalls) {
+		if (!info.hasEnd) {
+			const endEvent = {
+				type: EventType.TOOL_CALL_END,
+				toolCallId
+			};
+			events.push(endEvent);
+			appended.push(endEvent);
+		}
+		if (terminalEventMissing && !info.hasResult) {
+			const resultEvent = {
+				type: EventType.TOOL_CALL_RESULT,
+				toolCallId,
+				messageId: `${toolCallId ?? 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: EventType.RUN_FINISHED };
+		events.push(finishedEvent);
+		appended.push(finishedEvent);
+	} else {
+		const errorEvent = {
+			type: EventType.RUN_ERROR,
+			message: resolvedAbruptMessage,
+			code: "INCOMPLETE_STREAM"
+		};
+		events.push(errorEvent);
+		appended.push(errorEvent);
+	}
+	return appended;
+}
+
+//#endregion
+export { finalizeRunEvents };
+//# sourceMappingURL=finalize-events.mjs.map

package/dist/finalize-events.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"finalize-events.mjs","names":[],"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,KAAK,UAAU,oBAAoB;GACjC,MAAM,YAAa,MAAiC;AACpD,OAAI,OAAO,cAAc,SACvB,gBAAe,IAAI,UAAU;AAE/B;;EAEF,KAAK,UAAU,kBAAkB;GAC/B,MAAM,YAAa,MAAiC;AACpD,OAAI,OAAO,cAAc,SACvB,gBAAe,OAAO,UAAU;AAElC;;EAEF,KAAK,UAAU,iBAAiB;GAC9B,MAAM,aAAc,MAAkC;AACtD,OAAI,OAAO,eAAe,SACxB,eAAc,IAAI,YAAY;IAC5B,QAAQ;IACR,WAAW;IACZ,CAAC;AAEJ;;EAEF,KAAK,UAAU,eAAe;GAC5B,MAAM,aAAc,MAAkC;GACtD,MAAM,OAAO,aAAa,cAAc,IAAI,WAAW,GAAG;AAC1D,OAAI,KACF,MAAK,SAAS;AAEhB;;EAEF,KAAK,UAAU,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,SAAS,UAAU,aACrC;CACD,MAAM,cAAc,OAAO,MACxB,UAAU,MAAM,SAAS,UAAU,UACrC;CAED,MAAM,uBAAuB,EADJ,kBAAkB;AAG3C,MAAK,MAAM,aAAa,gBAAgB;EACtC,MAAM,WAAW;GACf,MAAM,UAAU;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,MAAM,UAAU;IAChB;IACD;AACD,UAAO,KAAK,SAAS;AACrB,YAAS,KAAK,SAAS;;AAGzB,MAAI,wBAAwB,CAAC,KAAK,WAAW;GAC3C,MAAM,cAAc;IAClB,MAAM,UAAU;IAChB;IACA,WAAW,GAAG,cAAc,YAAY,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,MAAM,UAAU,cACjB;AACD,SAAO,KAAK,cAAc;AAC1B,WAAS,KAAK,cAAc;QACvB;EACL,MAAM,aAA4B;GAChC,MAAM,UAAU;GAChB,SAAS;GACT,MAAM;GACP;AACD,SAAO,KAAK,WAAW;AACvB,WAAS,KAAK,WAAW;;AAI7B,QAAO"}