@copilotkitnext/shared 0.0.0-max-changeset-20260109174803

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/dist/index.d.mts

@@ -0,0 +1,35 @@
+import { BaseEvent } from '@ag-ui/client';
+
+type MaybePromise<T> = T | PromiseLike<T>;
+/**
+ * More specific utility for records with at least one key
+ */
+type NonEmptyRecord<T> = T extends Record<string, unknown> ? keyof T extends never ? never : T : never;
+/**
+ * Type representing an agent's basic information
+ */
+interface AgentDescription {
+    name: string;
+    className: string;
+    description: string;
+}
+interface RuntimeInfo {
+    version: string;
+    agents: Record<string, AgentDescription>;
+    audioFileTranscriptionEnabled: boolean;
+}
+
+declare function randomUUID(): string;
+declare function partialJSONParse(json: string): any;
+
+declare const logger: Console;
+
+declare const DEFAULT_AGENT_ID = "default";
+
+interface FinalizeRunOptions {
+    stopRequested?: boolean;
+    interruptionMessage?: string;
+}
+declare function finalizeRunEvents(events: BaseEvent[], options?: FinalizeRunOptions): BaseEvent[];
+
+export { type AgentDescription, DEFAULT_AGENT_ID, type MaybePromise, type NonEmptyRecord, type RuntimeInfo, finalizeRunEvents, logger, partialJSONParse, randomUUID };

package/dist/index.d.ts

@@ -0,0 +1,35 @@
+import { BaseEvent } from '@ag-ui/client';
+
+type MaybePromise<T> = T | PromiseLike<T>;
+/**
+ * More specific utility for records with at least one key
+ */
+type NonEmptyRecord<T> = T extends Record<string, unknown> ? keyof T extends never ? never : T : never;
+/**
+ * Type representing an agent's basic information
+ */
+interface AgentDescription {
+    name: string;
+    className: string;
+    description: string;
+}
+interface RuntimeInfo {
+    version: string;
+    agents: Record<string, AgentDescription>;
+    audioFileTranscriptionEnabled: boolean;
+}
+
+declare function randomUUID(): string;
+declare function partialJSONParse(json: string): any;
+
+declare const logger: Console;
+
+declare const DEFAULT_AGENT_ID = "default";
+
+interface FinalizeRunOptions {
+    stopRequested?: boolean;
+    interruptionMessage?: string;
+}
+declare function finalizeRunEvents(events: BaseEvent[], options?: FinalizeRunOptions): BaseEvent[];
+
+export { type AgentDescription, DEFAULT_AGENT_ID, type MaybePromise, type NonEmptyRecord, type RuntimeInfo, finalizeRunEvents, logger, partialJSONParse, randomUUID };

package/dist/index.js

@@ -0,0 +1,188 @@
+"use strict";
+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 __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  DEFAULT_AGENT_ID: () => DEFAULT_AGENT_ID,
+  finalizeRunEvents: () => finalizeRunEvents,
+  logger: () => logger,
+  partialJSONParse: () => partialJSONParse,
+  randomUUID: () => randomUUID
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/utils.ts
+var import_uuid = require("uuid");
+var PartialJSON = __toESM(require("partial-json"));
+function randomUUID() {
+  return (0, import_uuid.v4)();
+}
+function partialJSONParse(json) {
+  try {
+    return PartialJSON.parse(json);
+  } catch (error) {
+    return {};
+  }
+}
+
+// src/logger.ts
+var logger = console;
+
+// src/constants.ts
+var DEFAULT_AGENT_ID = "default";
+
+// src/finalize-events.ts
+var import_client = require("@ag-ui/client");
+var defaultStopMessage = "Run stopped by user";
+var 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 import_client.EventType.TEXT_MESSAGE_START: {
+        const messageId = event.messageId;
+        if (typeof messageId === "string") {
+          openMessageIds.add(messageId);
+        }
+        break;
+      }
+      case import_client.EventType.TEXT_MESSAGE_END: {
+        const messageId = event.messageId;
+        if (typeof messageId === "string") {
+          openMessageIds.delete(messageId);
+        }
+        break;
+      }
+      case import_client.EventType.TOOL_CALL_START: {
+        const toolCallId = event.toolCallId;
+        if (typeof toolCallId === "string") {
+          openToolCalls.set(toolCallId, {
+            hasEnd: false,
+            hasResult: false
+          });
+        }
+        break;
+      }
+      case import_client.EventType.TOOL_CALL_END: {
+        const toolCallId = event.toolCallId;
+        const info = toolCallId ? openToolCalls.get(toolCallId) : void 0;
+        if (info) {
+          info.hasEnd = true;
+        }
+        break;
+      }
+      case import_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 === import_client.EventType.RUN_FINISHED);
+  const hasRunError = events.some((event) => event.type === import_client.EventType.RUN_ERROR);
+  const hasTerminalEvent = hasRunFinished || hasRunError;
+  const terminalEventMissing = !hasTerminalEvent;
+  for (const messageId of openMessageIds) {
+    const endEvent = {
+      type: import_client.EventType.TEXT_MESSAGE_END,
+      messageId
+    };
+    events.push(endEvent);
+    appended.push(endEvent);
+  }
+  for (const [toolCallId, info] of openToolCalls) {
+    if (!info.hasEnd) {
+      const endEvent = {
+        type: import_client.EventType.TOOL_CALL_END,
+        toolCallId
+      };
+      events.push(endEvent);
+      appended.push(endEvent);
+    }
+    if (terminalEventMissing && !info.hasResult) {
+      const resultEvent = {
+        type: import_client.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: import_client.EventType.RUN_FINISHED
+      };
+      events.push(finishedEvent);
+      appended.push(finishedEvent);
+    } else {
+      const errorEvent = {
+        type: import_client.EventType.RUN_ERROR,
+        message: resolvedAbruptMessage,
+        code: "INCOMPLETE_STREAM"
+      };
+      events.push(errorEvent);
+      appended.push(errorEvent);
+    }
+  }
+  return appended;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  DEFAULT_AGENT_ID,
+  finalizeRunEvents,
+  logger,
+  partialJSONParse,
+  randomUUID
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/utils.ts","../src/logger.ts","../src/constants.ts","../src/finalize-events.ts"],"sourcesContent":["export {\n  type MaybePromise,\n  type NonEmptyRecord,\n  type AgentDescription,\n  type RuntimeInfo,\n} from \"./types\";\n\nexport * from \"./utils\";\n\nexport { logger } from \"./logger\";\nexport { DEFAULT_AGENT_ID } from \"./constants\";\nexport { finalizeRunEvents } from \"./finalize-events\";\n","import { v4 as uuidv4 } from \"uuid\";\nimport * as PartialJSON from \"partial-json\";\n\nexport function randomUUID() {\n  return uuidv4();\n}\n\nexport function partialJSONParse(json: string) {\n  try {\n    return PartialJSON.parse(json);\n  } catch (error) {\n    return {};\n  }\n}\n","export const logger = console;\n","export const DEFAULT_AGENT_ID = \"default\";\n","import {\n  BaseEvent,\n  EventType,\n  RunErrorEvent,\n} 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((event) => event.type === EventType.RUN_FINISHED);\n  const hasRunError = events.some((event) => event.type === EventType.RUN_ERROR);\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":"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","names":["uuidv4"]}

package/dist/index.mjs

@@ -0,0 +1,149 @@
+// src/utils.ts
+import { v4 as uuidv4 } from "uuid";
+import * as PartialJSON from "partial-json";
+function randomUUID() {
+  return uuidv4();
+}
+function partialJSONParse(json) {
+  try {
+    return PartialJSON.parse(json);
+  } catch (error) {
+    return {};
+  }
+}
+
+// src/logger.ts
+var logger = console;
+
+// src/constants.ts
+var DEFAULT_AGENT_ID = "default";
+
+// src/finalize-events.ts
+import {
+  EventType
+} from "@ag-ui/client";
+var defaultStopMessage = "Run stopped by user";
+var 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 hasTerminalEvent = hasRunFinished || hasRunError;
+  const terminalEventMissing = !hasTerminalEvent;
+  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;
+}
+export {
+  DEFAULT_AGENT_ID,
+  finalizeRunEvents,
+  logger,
+  partialJSONParse,
+  randomUUID
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/utils.ts","../src/logger.ts","../src/constants.ts","../src/finalize-events.ts"],"sourcesContent":["import { v4 as uuidv4 } from \"uuid\";\nimport * as PartialJSON from \"partial-json\";\n\nexport function randomUUID() {\n  return uuidv4();\n}\n\nexport function partialJSONParse(json: string) {\n  try {\n    return PartialJSON.parse(json);\n  } catch (error) {\n    return {};\n  }\n}\n","export const logger = console;\n","export const DEFAULT_AGENT_ID = \"default\";\n","import {\n  BaseEvent,\n  EventType,\n  RunErrorEvent,\n} 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((event) => event.type === EventType.RUN_FINISHED);\n  const hasRunError = events.some((event) => event.type === EventType.RUN_ERROR);\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":"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","names":[]}

package/eslint.config.mjs

@@ -0,0 +1,3 @@
+import { config as baseConfig } from "@copilotkitnext/eslint-config/base";
+
+export default [...baseConfig];

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@copilotkitnext/shared",
+  "version": "0.0.0-max-changeset-20260109174803",
+  "description": "Shared utilities and types for CopilotKit2",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "@types/node": "^22.15.3",
+    "eslint": "^9.30.0",
+    "tsup": "^8.5.0",
+    "typescript": "5.8.2",
+    "@copilotkitnext/eslint-config": "0.0.0-max-changeset-20260109174803",
+    "@copilotkitnext/typescript-config": "0.0.0-max-changeset-20260109174803"
+  },
+  "dependencies": {
+    "uuid": "^11.1.0",
+    "partial-json": "^0.1.7"
+  },
+  "peerDependencies": {
+    "@ag-ui/client": "0.0.42"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "lint": "eslint . --max-warnings 0",
+    "check-types": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  }
+}