@copilotkit/shared 1.54.1-next.6 → 1.55.0-next.7

package/dist/index.umd.js

@@ -1,8 +1,8 @@
 (function(global, factory) {
-  typeof exports === 'object' && typeof module !== 'undefined' ?  factory(exports, require('graphql'), require('zod'), require('uuid'), require('@segment/analytics-node'), require('chalk')) :
-  typeof define === 'function' && define.amd ? define(['exports', 'graphql', 'zod', 'uuid', '@segment/analytics-node', 'chalk'], factory) :
-  (global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory((global.CopilotKitShared = {}), global.GraphQL,global.Zod,global.UUID,global.SegmentAnalyticsNode,global.chalk));
-})(this, function(exports, graphql, zod, uuid, _segment_analytics_node, chalk) {
+  typeof exports === 'object' && typeof module !== 'undefined' ?  factory(exports, require('graphql'), require('zod'), require('uuid'), require('partial-json'), require('@segment/analytics-node'), require('chalk'), require('@ag-ui/client')) :
+  typeof define === 'function' && define.amd ? define(['exports', 'graphql', 'zod', 'uuid', 'partial-json', '@segment/analytics-node', 'chalk', '@ag-ui/client'], factory) :
+  (global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory((global.CopilotKitShared = {}), global.GraphQL,global.Zod,global.UUID,global.PartialJSON,global.SegmentAnalyticsNode,global.chalk,global.AgUIClient));
+})(this, function(exports, graphql, zod, uuid, partial_json, _segment_analytics_node, chalk, _ag_ui_client) {
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 //#region \0rolldown/runtime.js
 	var __create = Object.create;
@@ -31,6 +31,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 	}) : target, mod));
 
 //#endregion
+partial_json = __toESM(partial_json);
 
 //#region src/utils/conditions.ts
 	function executeConditions({ conditions, value }) {
@@ -715,6 +716,11 @@ ${getSeeMoreMarkdown(troubleshootingLink)}`;
 		return convertJsonSchemaToZodSchema(actionParametersToJsonSchema(parameters), true);
 	}
 
+//#endregion
+//#region src/utils/types.ts
+	const RUNTIME_MODE_SSE = "sse";
+	const RUNTIME_MODE_INTELLIGENCE = "intelligence";
+
 //#endregion
 //#region src/utils/random-id.ts
 	function randomId() {
@@ -817,6 +823,32 @@ ${getSeeMoreMarkdown(troubleshootingLink)}`;
 		}
 	}
 	/**
+	* Parses a partial/incomplete JSON string, returning as much valid data as possible.
+	* Falls back to an empty object if parsing fails entirely.
+	*/
+	function partialJSONParse(json) {
+		try {
+			const parsed = partial_json.parse(json);
+			if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) return parsed;
+			return {};
+		} catch (error) {
+			return {};
+		}
+	}
+	/**
+	* Returns an exponential backoff function suitable for Phoenix.js
+	* `reconnectAfterMs` and `rejoinAfterMs` options.
+	*
+	* @param baseMs  - Initial delay for the first retry attempt.
+	* @param maxMs   - Upper bound — delays are capped at this value.
+	*
+	* Phoenix calls the returned function with a 1-based `tries` count.
+	* The delay doubles on each attempt: baseMs, 2×baseMs, 4×baseMs, …, maxMs.
+	*/
+	function phoenixExponentialBackoff(baseMs, maxMs) {
+		return (tries) => Math.min(baseMs * 2 ** (tries - 1), maxMs);
+	}
+	/**
 	* Maps an array of items to a new array, skipping items that throw errors during mapping
 	* @param items The array to map
 	* @param callback The mapping function to apply to each item
@@ -839,6 +871,22 @@ ${getSeeMoreMarkdown(troubleshootingLink)}`;
 	function isMacOS() {
 		return /Mac|iMac|Macintosh/i.test(navigator.userAgent);
 	}
+	/**
+	* Safely parses a JSON string into a tool arguments object.
+	* Returns the parsed object only if it's a plain object (not an array, null, etc.).
+	* Falls back to an empty object for any non-object JSON value or parse failure.
+	*/
+	function safeParseToolArgs(raw) {
+		try {
+			const parsed = JSON.parse(raw);
+			if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) return parsed;
+			console.warn(`[CopilotKit] Tool arguments parsed to non-object (${typeof parsed}), falling back to empty object`);
+			return {};
+		} catch (_unused) {
+			console.warn("[CopilotKit] Failed to parse tool arguments, falling back to empty object");
+			return {};
+		}
+	}
 
 //#endregion
 //#region src/constants/index.ts
@@ -846,6 +894,9 @@ ${getSeeMoreMarkdown(troubleshootingLink)}`;
 	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
 //#region src/telemetry/utils.ts
@@ -860,7 +911,7 @@ ${getSeeMoreMarkdown(troubleshootingLink)}`;
 
 //#endregion
 //#region package.json
-	var version = "1.54.1-next.6";
+	var version = "1.55.0-next.7";
 
 //#endregion
 //#region src/telemetry/scarf-client.ts
@@ -965,11 +1016,222 @@ ${getSeeMoreMarkdown(troubleshootingLink)}`;
 		}
 	};
 
+//#endregion
+//#region src/standard-schema.ts
+/**
+	* Check whether a schema implements the Standard JSON Schema V1 protocol.
+	*/
+	function hasStandardJsonSchema(schema) {
+		const props = schema["~standard"];
+		return props != null && typeof props === "object" && "jsonSchema" in props && props.jsonSchema != null && typeof props.jsonSchema === "object" && "input" in props.jsonSchema && typeof props.jsonSchema.input === "function";
+	}
+	/**
+	* Convert any StandardSchemaV1-compatible schema to a JSON Schema object.
+	*
+	* Strategy:
+	* 1. If the schema implements Standard JSON Schema V1 (`~standard.jsonSchema`),
+	*    call `schema['~standard'].jsonSchema.input({ target: 'draft-07' })`.
+	* 2. If the schema is a Zod v3 schema (`~standard.vendor === 'zod'`), use the
+	*    injected `zodToJsonSchema()` function.
+	* 3. Otherwise throw a descriptive error.
+	*/
+	function schemaToJsonSchema(schema, options) {
+		if (hasStandardJsonSchema(schema)) return schema["~standard"].jsonSchema.input({ target: "draft-07" });
+		const vendor = schema["~standard"].vendor;
+		if (vendor === "zod" && (options === null || options === void 0 ? void 0 : options.zodToJsonSchema)) return options.zodToJsonSchema(schema, { $refStrategy: "none" });
+		throw new Error(`Cannot convert schema to JSON Schema. The schema (vendor: "${vendor}") does not implement Standard JSON Schema V1 and no zodToJsonSchema fallback is available. Use a library that supports Standard JSON Schema (e.g., Zod 3.24+, Valibot v1+, ArkType v2+) or pass a zodToJsonSchema function in options.`);
+	}
+
+//#endregion
+//#region src/logger.ts
+	const logger = console;
+
+//#endregion
+//#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 !== null && interruptionMessage !== void 0 ? 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 !== null && toolCallId !== void 0 ? 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: _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
+//#region src/transcription-errors.ts
+/**
+	* Error codes for transcription HTTP responses.
+	* Uses snake_case to align with existing CopilotKitCoreErrorCode pattern.
+	* These codes are returned by the runtime and parsed by the client.
+	*/
+	let TranscriptionErrorCode = /* @__PURE__ */ function(TranscriptionErrorCode) {
+		/** Transcription service not configured in runtime */
+		TranscriptionErrorCode["SERVICE_NOT_CONFIGURED"] = "service_not_configured";
+		/** Audio format not supported */
+		TranscriptionErrorCode["INVALID_AUDIO_FORMAT"] = "invalid_audio_format";
+		/** Audio file is too long */
+		TranscriptionErrorCode["AUDIO_TOO_LONG"] = "audio_too_long";
+		/** Audio file is empty or too short */
+		TranscriptionErrorCode["AUDIO_TOO_SHORT"] = "audio_too_short";
+		/** Rate limited by transcription provider */
+		TranscriptionErrorCode["RATE_LIMITED"] = "rate_limited";
+		/** Authentication failed with transcription provider */
+		TranscriptionErrorCode["AUTH_FAILED"] = "auth_failed";
+		/** Transcription provider returned an error */
+		TranscriptionErrorCode["PROVIDER_ERROR"] = "provider_error";
+		/** Network error during transcription */
+		TranscriptionErrorCode["NETWORK_ERROR"] = "network_error";
+		/** Invalid request format */
+		TranscriptionErrorCode["INVALID_REQUEST"] = "invalid_request";
+		return TranscriptionErrorCode;
+	}({});
+	/**
+	* Helper functions to create transcription error responses.
+	* Used by the runtime to return consistent error responses.
+	*/
+	const TranscriptionErrors = {
+		serviceNotConfigured: () => ({
+			error: TranscriptionErrorCode.SERVICE_NOT_CONFIGURED,
+			message: "Transcription service is not configured",
+			retryable: false
+		}),
+		invalidAudioFormat: (format, supported) => ({
+			error: TranscriptionErrorCode.INVALID_AUDIO_FORMAT,
+			message: `Unsupported audio format: ${format}. Supported: ${supported.join(", ")}`,
+			retryable: false
+		}),
+		invalidRequest: (details) => ({
+			error: TranscriptionErrorCode.INVALID_REQUEST,
+			message: details,
+			retryable: false
+		}),
+		rateLimited: () => ({
+			error: TranscriptionErrorCode.RATE_LIMITED,
+			message: "Rate limited. Please try again later.",
+			retryable: true
+		}),
+		authFailed: () => ({
+			error: TranscriptionErrorCode.AUTH_FAILED,
+			message: "Authentication failed with transcription provider",
+			retryable: false
+		}),
+		providerError: (message) => ({
+			error: TranscriptionErrorCode.PROVIDER_ERROR,
+			message,
+			retryable: true
+		}),
+		networkError: (message = "Network error during transcription") => ({
+			error: TranscriptionErrorCode.NETWORK_ERROR,
+			message,
+			retryable: true
+		}),
+		audioTooLong: () => ({
+			error: TranscriptionErrorCode.AUDIO_TOO_LONG,
+			message: "Audio file is too long",
+			retryable: false
+		}),
+		audioTooShort: () => ({
+			error: TranscriptionErrorCode.AUDIO_TOO_SHORT,
+			message: "Audio is too short to transcribe",
+			retryable: false
+		})
+	};
+
 //#endregion
 //#region src/index.ts
 	const COPILOTKIT_VERSION = version;
 
 //#endregion
+exports.AG_UI_CHANNEL_EVENT = AG_UI_CHANNEL_EVENT;
 exports.BANNER_ERROR_NAMES = BANNER_ERROR_NAMES;
 exports.COPILOTKIT_VERSION = COPILOTKIT_VERSION;
 exports.COPILOT_CLOUD_API_URL = COPILOT_CLOUD_API_URL;
@@ -988,19 +1250,25 @@ exports.CopilotKitLowLevelError = CopilotKitLowLevelError;
 exports.CopilotKitMisuseError = CopilotKitMisuseError;
 exports.CopilotKitRemoteEndpointDiscoveryError = CopilotKitRemoteEndpointDiscoveryError;
 exports.CopilotKitVersionMismatchError = CopilotKitVersionMismatchError;
+exports.DEFAULT_AGENT_ID = DEFAULT_AGENT_ID;
 exports.ERROR_CONFIG = ERROR_CONFIG;
 exports.ERROR_NAMES = ERROR_NAMES;
 exports.ErrorVisibility = ErrorVisibility;
 exports.MissingPublicApiKeyError = MissingPublicApiKeyError;
+exports.RUNTIME_MODE_INTELLIGENCE = RUNTIME_MODE_INTELLIGENCE;
+exports.RUNTIME_MODE_SSE = RUNTIME_MODE_SSE;
 exports.ResolvedCopilotKitError = ResolvedCopilotKitError;
 exports.Severity = Severity;
 exports.TelemetryClient = TelemetryClient;
+exports.TranscriptionErrorCode = TranscriptionErrorCode;
+exports.TranscriptionErrors = TranscriptionErrors;
 exports.UpgradeRequiredError = UpgradeRequiredError;
 exports.actionParametersToJsonSchema = actionParametersToJsonSchema;
 exports.convertJsonSchemaToZodSchema = convertJsonSchemaToZodSchema;
 exports.dataToUUID = dataToUUID;
 exports.ensureStructuredError = ensureStructuredError;
 exports.executeConditions = executeConditions;
+exports.finalizeRunEvents = finalizeRunEvents;
 exports.getPossibleVersionMismatch = getPossibleVersionMismatch;
 exports.getZodParameters = getZodParameters;
 exports.isMacOS = isMacOS;
@@ -1010,12 +1278,25 @@ exports.isValidUUID = isValidUUID;
 exports.jsonSchemaToActionParameters = jsonSchemaToActionParameters;
 exports.logCopilotKitPlatformMessage = logCopilotKitPlatformMessage;
 exports.logStyled = logStyled;
+exports.logger = logger;
 exports.parseJson = parseJson;
+exports.partialJSONParse = partialJSONParse;
+exports.phoenixExponentialBackoff = phoenixExponentialBackoff;
 exports.publicApiKeyRequired = publicApiKeyRequired;
 exports.randomId = randomId;
 exports.randomUUID = randomUUID;
 exports.readBody = readBody;
+exports.safeParseToolArgs = safeParseToolArgs;
+exports.schemaToJsonSchema = schemaToJsonSchema;
 exports.styledConsole = styledConsole;
 exports.tryMap = tryMap;
+var _copilotkit_license_verifier = require("@copilotkit/license-verifier");
+Object.keys(_copilotkit_license_verifier).forEach(function (k) {
+  if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
+    enumerable: true,
+    get: function () { return _copilotkit_license_verifier[k]; }
+  });
+});
+
 });
 //# sourceMappingURL=index.umd.js.map