@copilotkitnext/shared 1.53.1-next.1 → 1.54.0-next.3

package/dist/index.cjs

@@ -4,6 +4,7 @@ const require_logger = require('./logger.cjs');
 const require_constants = require('./constants.cjs');
 const require_finalize_events = require('./finalize-events.cjs');
 const require_transcription_errors = require('./transcription-errors.cjs');
+const require_standard_schema = require('./standard-schema.cjs');
 
 exports.AG_UI_CHANNEL_EVENT = require_constants.AG_UI_CHANNEL_EVENT;
 exports.DEFAULT_AGENT_ID = require_constants.DEFAULT_AGENT_ID;
@@ -13,4 +14,6 @@ exports.finalizeRunEvents = require_finalize_events.finalizeRunEvents;
 exports.logger = require_logger.logger;
 exports.partialJSONParse = require_utils.partialJSONParse;
 exports.phoenixExponentialBackoff = require_utils.phoenixExponentialBackoff;
-exports.randomUUID = require_utils.randomUUID;
+exports.randomUUID = require_utils.randomUUID;
+exports.safeParseToolArgs = require_utils.safeParseToolArgs;
+exports.schemaToJsonSchema = require_standard_schema.schemaToJsonSchema;

package/dist/index.d.cts

@@ -1,7 +1,8 @@
 import { AgentDescription, MaybePromise, NonEmptyRecord, RuntimeInfo } from "./types.cjs";
-import { partialJSONParse, phoenixExponentialBackoff, randomUUID } from "./utils.cjs";
+import { partialJSONParse, phoenixExponentialBackoff, randomUUID, safeParseToolArgs } from "./utils.cjs";
 import { logger } from "./logger.cjs";
 import { AG_UI_CHANNEL_EVENT, DEFAULT_AGENT_ID } from "./constants.cjs";
 import { finalizeRunEvents } from "./finalize-events.cjs";
 import { TranscriptionErrorCode, TranscriptionErrorResponse, TranscriptionErrors } from "./transcription-errors.cjs";
-export { AG_UI_CHANNEL_EVENT, type AgentDescription, DEFAULT_AGENT_ID, type MaybePromise, type NonEmptyRecord, type RuntimeInfo, TranscriptionErrorCode, type TranscriptionErrorResponse, TranscriptionErrors, finalizeRunEvents, logger, partialJSONParse, phoenixExponentialBackoff, randomUUID };
+import { InferSchemaOutput, SchemaToJsonSchemaOptions, StandardJSONSchemaV1, StandardSchemaV1, schemaToJsonSchema } from "./standard-schema.cjs";
+export { AG_UI_CHANNEL_EVENT, type AgentDescription, DEFAULT_AGENT_ID, type InferSchemaOutput, type MaybePromise, type NonEmptyRecord, type RuntimeInfo, type SchemaToJsonSchemaOptions, type StandardJSONSchemaV1, type StandardSchemaV1, TranscriptionErrorCode, type TranscriptionErrorResponse, TranscriptionErrors, finalizeRunEvents, logger, partialJSONParse, phoenixExponentialBackoff, randomUUID, safeParseToolArgs, schemaToJsonSchema };

package/dist/index.d.mts

@@ -1,7 +1,8 @@
 import { AgentDescription, MaybePromise, NonEmptyRecord, RuntimeInfo } from "./types.mjs";
-import { partialJSONParse, phoenixExponentialBackoff, randomUUID } from "./utils.mjs";
+import { partialJSONParse, phoenixExponentialBackoff, randomUUID, safeParseToolArgs } from "./utils.mjs";
 import { logger } from "./logger.mjs";
 import { AG_UI_CHANNEL_EVENT, DEFAULT_AGENT_ID } from "./constants.mjs";
 import { finalizeRunEvents } from "./finalize-events.mjs";
 import { TranscriptionErrorCode, TranscriptionErrorResponse, TranscriptionErrors } from "./transcription-errors.mjs";
-export { AG_UI_CHANNEL_EVENT, type AgentDescription, DEFAULT_AGENT_ID, type MaybePromise, type NonEmptyRecord, type RuntimeInfo, TranscriptionErrorCode, type TranscriptionErrorResponse, TranscriptionErrors, finalizeRunEvents, logger, partialJSONParse, phoenixExponentialBackoff, randomUUID };
+import { InferSchemaOutput, SchemaToJsonSchemaOptions, StandardJSONSchemaV1, StandardSchemaV1, schemaToJsonSchema } from "./standard-schema.mjs";
+export { AG_UI_CHANNEL_EVENT, type AgentDescription, DEFAULT_AGENT_ID, type InferSchemaOutput, type MaybePromise, type NonEmptyRecord, type RuntimeInfo, type SchemaToJsonSchemaOptions, type StandardJSONSchemaV1, type StandardSchemaV1, TranscriptionErrorCode, type TranscriptionErrorResponse, TranscriptionErrors, finalizeRunEvents, logger, partialJSONParse, phoenixExponentialBackoff, randomUUID, safeParseToolArgs, schemaToJsonSchema };

package/dist/index.mjs

@@ -1,7 +1,8 @@
-import { partialJSONParse, phoenixExponentialBackoff, randomUUID } from "./utils.mjs";
+import { partialJSONParse, phoenixExponentialBackoff, randomUUID, safeParseToolArgs } from "./utils.mjs";
 import { logger } from "./logger.mjs";
 import { AG_UI_CHANNEL_EVENT, DEFAULT_AGENT_ID } from "./constants.mjs";
 import { finalizeRunEvents } from "./finalize-events.mjs";
 import { TranscriptionErrorCode, TranscriptionErrors } from "./transcription-errors.mjs";
+import { schemaToJsonSchema } from "./standard-schema.mjs";
 
-export { AG_UI_CHANNEL_EVENT, DEFAULT_AGENT_ID, TranscriptionErrorCode, TranscriptionErrors, finalizeRunEvents, logger, partialJSONParse, phoenixExponentialBackoff, randomUUID };
+export { AG_UI_CHANNEL_EVENT, DEFAULT_AGENT_ID, TranscriptionErrorCode, TranscriptionErrors, finalizeRunEvents, logger, partialJSONParse, phoenixExponentialBackoff, randomUUID, safeParseToolArgs, schemaToJsonSchema };

package/dist/index.umd.js

@@ -39,12 +39,33 @@ partial_json = __toESM(partial_json);
 	}
 	function partialJSONParse(json) {
 		try {
-			return partial_json.parse(json);
+			const parsed = partial_json.parse(json);
+			if (typeof parsed === "object" && parsed !== null && !Array.isArray(parsed)) return parsed;
+			console.warn(`[CopilotKit] Tool arguments parsed to non-object (${typeof parsed}), falling back to empty object`);
+			return {};
 		} catch (error) {
 			return {};
 		}
 	}
 	/**
+	* Safely parses a JSON string into a plain object for tool arguments.
+	* Handles two failure modes:
+	*  1. Malformed JSON (SyntaxError from JSON.parse)
+	*  2. Valid JSON that isn't a plain object (e.g. "", [], null, 42, true)
+	* Falls back to an empty object for safety in both cases.
+	*/
+	function safeParseToolArgs(raw) {
+		try {
+			const parsed = JSON.parse(raw);
+			if (typeof parsed === "object" && parsed !== null && !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 {};
+		}
+	}
+	/**
 	* Returns an exponential backoff function suitable for Phoenix.js
 	* `reconnectAfterMs` and `rejoinAfterMs` options.
 	*
@@ -248,6 +269,32 @@ partial_json = __toESM(partial_json);
 		})
 	};
 
+//#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
 exports.AG_UI_CHANNEL_EVENT = AG_UI_CHANNEL_EVENT;
 exports.DEFAULT_AGENT_ID = DEFAULT_AGENT_ID;
@@ -258,5 +305,7 @@ exports.logger = logger;
 exports.partialJSONParse = partialJSONParse;
 exports.phoenixExponentialBackoff = phoenixExponentialBackoff;
 exports.randomUUID = randomUUID;
+exports.safeParseToolArgs = safeParseToolArgs;
+exports.schemaToJsonSchema = schemaToJsonSchema;
 });
 //# sourceMappingURL=index.umd.js.map

package/dist/index.umd.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.umd.js","names":["PartialJSON","EventType"],"sources":["../src/utils.ts","../src/logger.ts","../src/constants.ts","../src/finalize-events.ts","../src/transcription-errors.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\n/**\n * Returns an exponential backoff function suitable for Phoenix.js\n * `reconnectAfterMs` and `rejoinAfterMs` options.\n *\n * @param baseMs  - Initial delay for the first retry attempt.\n * @param maxMs   - Upper bound — delays are capped at this value.\n *\n * Phoenix calls the returned function with a 1-based `tries` count.\n * The delay doubles on each attempt: baseMs, 2×baseMs, 4×baseMs, …, maxMs.\n */\nexport function phoenixExponentialBackoff(\n  baseMs: number,\n  maxMs: number,\n): (tries: number) => number {\n  return (tries: number) => Math.min(baseMs * 2 ** (tries - 1), maxMs);\n}\n","export const logger = console;\n","export 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","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","/**\n * Error codes for transcription HTTP responses.\n * Uses snake_case to align with existing CopilotKitCoreErrorCode pattern.\n * These codes are returned by the runtime and parsed by the client.\n */\nexport enum TranscriptionErrorCode {\n  /** Transcription service not configured in runtime */\n  SERVICE_NOT_CONFIGURED = \"service_not_configured\",\n  /** Audio format not supported */\n  INVALID_AUDIO_FORMAT = \"invalid_audio_format\",\n  /** Audio file is too long */\n  AUDIO_TOO_LONG = \"audio_too_long\",\n  /** Audio file is empty or too short */\n  AUDIO_TOO_SHORT = \"audio_too_short\",\n  /** Rate limited by transcription provider */\n  RATE_LIMITED = \"rate_limited\",\n  /** Authentication failed with transcription provider */\n  AUTH_FAILED = \"auth_failed\",\n  /** Transcription provider returned an error */\n  PROVIDER_ERROR = \"provider_error\",\n  /** Network error during transcription */\n  NETWORK_ERROR = \"network_error\",\n  /** Invalid request format */\n  INVALID_REQUEST = \"invalid_request\",\n}\n\n/**\n * Error response format returned by the transcription endpoint.\n */\nexport interface TranscriptionErrorResponse {\n  error: TranscriptionErrorCode;\n  message: string;\n  retryable?: boolean;\n}\n\n/**\n * Helper functions to create transcription error responses.\n * Used by the runtime to return consistent error responses.\n */\nexport const TranscriptionErrors = {\n  serviceNotConfigured: (): TranscriptionErrorResponse => ({\n    error: TranscriptionErrorCode.SERVICE_NOT_CONFIGURED,\n    message: \"Transcription service is not configured\",\n    retryable: false,\n  }),\n\n  invalidAudioFormat: (\n    format: string,\n    supported: string[],\n  ): TranscriptionErrorResponse => ({\n    error: TranscriptionErrorCode.INVALID_AUDIO_FORMAT,\n    message: `Unsupported audio format: ${format}. Supported: ${supported.join(\", \")}`,\n    retryable: false,\n  }),\n\n  invalidRequest: (details: string): TranscriptionErrorResponse => ({\n    error: TranscriptionErrorCode.INVALID_REQUEST,\n    message: details,\n    retryable: false,\n  }),\n\n  rateLimited: (): TranscriptionErrorResponse => ({\n    error: TranscriptionErrorCode.RATE_LIMITED,\n    message: \"Rate limited. Please try again later.\",\n    retryable: true,\n  }),\n\n  authFailed: (): TranscriptionErrorResponse => ({\n    error: TranscriptionErrorCode.AUTH_FAILED,\n    message: \"Authentication failed with transcription provider\",\n    retryable: false,\n  }),\n\n  providerError: (message: string): TranscriptionErrorResponse => ({\n    error: TranscriptionErrorCode.PROVIDER_ERROR,\n    message,\n    retryable: true,\n  }),\n\n  networkError: (\n    message: string = \"Network error during transcription\",\n  ): TranscriptionErrorResponse => ({\n    error: TranscriptionErrorCode.NETWORK_ERROR,\n    message,\n    retryable: true,\n  }),\n\n  audioTooLong: (): TranscriptionErrorResponse => ({\n    error: TranscriptionErrorCode.AUDIO_TOO_LONG,\n    message: \"Audio file is too long\",\n    retryable: false,\n  }),\n\n  audioTooShort: (): TranscriptionErrorResponse => ({\n    error: TranscriptionErrorCode.AUDIO_TOO_SHORT,\n    message: \"Audio is too short to transcribe\",\n    retryable: false,\n  }),\n};\n"],"mappings":"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"}
+{"version":3,"file":"index.umd.js","names":["PartialJSON","EventType"],"sources":["../src/utils.ts","../src/logger.ts","../src/constants.ts","../src/finalize-events.ts","../src/transcription-errors.ts","../src/standard-schema.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): unknown {\n  try {\n    const parsed = PartialJSON.parse(json);\n    if (\n      typeof parsed === \"object\" &&\n      parsed !== null &&\n      !Array.isArray(parsed)\n    ) {\n      return parsed as Record<string, unknown>;\n    }\n    console.warn(\n      `[CopilotKit] Tool arguments parsed to non-object (${typeof parsed}), falling back to empty object`,\n    );\n    return {};\n  } catch (error) {\n    return {};\n  }\n}\n\n/**\n * Safely parses a JSON string into a plain object for tool arguments.\n * Handles two failure modes:\n *  1. Malformed JSON (SyntaxError from JSON.parse)\n *  2. Valid JSON that isn't a plain object (e.g. \"\", [], null, 42, true)\n * Falls back to an empty object for safety in both cases.\n */\nexport function safeParseToolArgs(raw: string): Record<string, unknown> {\n  try {\n    const parsed = JSON.parse(raw);\n    if (\n      typeof parsed === \"object\" &&\n      parsed !== null &&\n      !Array.isArray(parsed)\n    ) {\n      return parsed as Record<string, unknown>;\n    }\n    console.warn(\n      `[CopilotKit] Tool arguments parsed to non-object (${typeof parsed}), falling back to empty object`,\n    );\n    return {};\n  } catch {\n    console.warn(\n      \"[CopilotKit] Failed to parse tool arguments, falling back to empty object\",\n    );\n    return {};\n  }\n}\n\n/**\n * Returns an exponential backoff function suitable for Phoenix.js\n * `reconnectAfterMs` and `rejoinAfterMs` options.\n *\n * @param baseMs  - Initial delay for the first retry attempt.\n * @param maxMs   - Upper bound — delays are capped at this value.\n *\n * Phoenix calls the returned function with a 1-based `tries` count.\n * The delay doubles on each attempt: baseMs, 2×baseMs, 4×baseMs, …, maxMs.\n */\nexport function phoenixExponentialBackoff(\n  baseMs: number,\n  maxMs: number,\n): (tries: number) => number {\n  return (tries: number) => Math.min(baseMs * 2 ** (tries - 1), maxMs);\n}\n","export const logger = console;\n","export 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","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","/**\n * Error codes for transcription HTTP responses.\n * Uses snake_case to align with existing CopilotKitCoreErrorCode pattern.\n * These codes are returned by the runtime and parsed by the client.\n */\nexport enum TranscriptionErrorCode {\n  /** Transcription service not configured in runtime */\n  SERVICE_NOT_CONFIGURED = \"service_not_configured\",\n  /** Audio format not supported */\n  INVALID_AUDIO_FORMAT = \"invalid_audio_format\",\n  /** Audio file is too long */\n  AUDIO_TOO_LONG = \"audio_too_long\",\n  /** Audio file is empty or too short */\n  AUDIO_TOO_SHORT = \"audio_too_short\",\n  /** Rate limited by transcription provider */\n  RATE_LIMITED = \"rate_limited\",\n  /** Authentication failed with transcription provider */\n  AUTH_FAILED = \"auth_failed\",\n  /** Transcription provider returned an error */\n  PROVIDER_ERROR = \"provider_error\",\n  /** Network error during transcription */\n  NETWORK_ERROR = \"network_error\",\n  /** Invalid request format */\n  INVALID_REQUEST = \"invalid_request\",\n}\n\n/**\n * Error response format returned by the transcription endpoint.\n */\nexport interface TranscriptionErrorResponse {\n  error: TranscriptionErrorCode;\n  message: string;\n  retryable?: boolean;\n}\n\n/**\n * Helper functions to create transcription error responses.\n * Used by the runtime to return consistent error responses.\n */\nexport const TranscriptionErrors = {\n  serviceNotConfigured: (): TranscriptionErrorResponse => ({\n    error: TranscriptionErrorCode.SERVICE_NOT_CONFIGURED,\n    message: \"Transcription service is not configured\",\n    retryable: false,\n  }),\n\n  invalidAudioFormat: (\n    format: string,\n    supported: string[],\n  ): TranscriptionErrorResponse => ({\n    error: TranscriptionErrorCode.INVALID_AUDIO_FORMAT,\n    message: `Unsupported audio format: ${format}. Supported: ${supported.join(\", \")}`,\n    retryable: false,\n  }),\n\n  invalidRequest: (details: string): TranscriptionErrorResponse => ({\n    error: TranscriptionErrorCode.INVALID_REQUEST,\n    message: details,\n    retryable: false,\n  }),\n\n  rateLimited: (): TranscriptionErrorResponse => ({\n    error: TranscriptionErrorCode.RATE_LIMITED,\n    message: \"Rate limited. Please try again later.\",\n    retryable: true,\n  }),\n\n  authFailed: (): TranscriptionErrorResponse => ({\n    error: TranscriptionErrorCode.AUTH_FAILED,\n    message: \"Authentication failed with transcription provider\",\n    retryable: false,\n  }),\n\n  providerError: (message: string): TranscriptionErrorResponse => ({\n    error: TranscriptionErrorCode.PROVIDER_ERROR,\n    message,\n    retryable: true,\n  }),\n\n  networkError: (\n    message: string = \"Network error during transcription\",\n  ): TranscriptionErrorResponse => ({\n    error: TranscriptionErrorCode.NETWORK_ERROR,\n    message,\n    retryable: true,\n  }),\n\n  audioTooLong: (): TranscriptionErrorResponse => ({\n    error: TranscriptionErrorCode.AUDIO_TOO_LONG,\n    message: \"Audio file is too long\",\n    retryable: false,\n  }),\n\n  audioTooShort: (): TranscriptionErrorResponse => ({\n    error: TranscriptionErrorCode.AUDIO_TOO_SHORT,\n    message: \"Audio is too short to transcribe\",\n    retryable: false,\n  }),\n};\n","import type {\n  StandardSchemaV1,\n  StandardJSONSchemaV1,\n} from \"@standard-schema/spec\";\n\nexport type { StandardSchemaV1, StandardJSONSchemaV1 };\n\n/**\n * Extract the Output type from a StandardSchemaV1 schema.\n * Replaces `z.infer<S>` for generic schema inference.\n */\nexport type InferSchemaOutput<S> =\n  S extends StandardSchemaV1<any, infer O> ? O : never;\n\nexport interface SchemaToJsonSchemaOptions {\n  /**\n   * Injected `zodToJsonSchema` function so that `shared` does not depend on\n   * `zod-to-json-schema`. Required when the schema is a Zod v3 schema that\n   * does not implement Standard JSON Schema V1.\n   */\n  zodToJsonSchema?: (\n    schema: unknown,\n    options?: { $refStrategy?: string },\n  ) => Record<string, unknown>;\n}\n\n/**\n * Check whether a schema implements the Standard JSON Schema V1 protocol.\n */\nfunction hasStandardJsonSchema(\n  schema: StandardSchemaV1,\n): schema is StandardSchemaV1 & StandardJSONSchemaV1 {\n  const props = schema[\"~standard\"];\n  return (\n    props != null &&\n    typeof props === \"object\" &&\n    \"jsonSchema\" in props &&\n    props.jsonSchema != null &&\n    typeof props.jsonSchema === \"object\" &&\n    \"input\" in props.jsonSchema &&\n    typeof props.jsonSchema.input === \"function\"\n  );\n}\n\n/**\n * Convert any StandardSchemaV1-compatible schema to a JSON Schema object.\n *\n * Strategy:\n * 1. If the schema implements Standard JSON Schema V1 (`~standard.jsonSchema`),\n *    call `schema['~standard'].jsonSchema.input({ target: 'draft-07' })`.\n * 2. If the schema is a Zod v3 schema (`~standard.vendor === 'zod'`), use the\n *    injected `zodToJsonSchema()` function.\n * 3. Otherwise throw a descriptive error.\n */\nexport function schemaToJsonSchema(\n  schema: StandardSchemaV1,\n  options?: SchemaToJsonSchemaOptions,\n): Record<string, unknown> {\n  // 1. Standard JSON Schema V1\n  if (hasStandardJsonSchema(schema)) {\n    return schema[\"~standard\"].jsonSchema.input({ target: \"draft-07\" });\n  }\n\n  // 2. Zod v3 fallback\n  const vendor = schema[\"~standard\"].vendor;\n  if (vendor === \"zod\" && options?.zodToJsonSchema) {\n    return options.zodToJsonSchema(schema, { $refStrategy: \"none\" });\n  }\n\n  throw new Error(\n    `Cannot convert schema to JSON Schema. The schema (vendor: \"${vendor}\") does not implement Standard JSON Schema V1 ` +\n      `and no zodToJsonSchema fallback is available. ` +\n      `Use a library that supports Standard JSON Schema (e.g., Zod 3.24+, Valibot v1+, ArkType v2+) ` +\n      `or pass a zodToJsonSchema function in options.`,\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAGA,SAAgB,aAAa;AAC3B,uBAAe;;CAGjB,SAAgB,iBAAiB,MAAuB;AACtD,MAAI;GACF,MAAM,SAASA,aAAY,MAAM,KAAK;AACtC,OACE,OAAO,WAAW,YAClB,WAAW,QACX,CAAC,MAAM,QAAQ,OAAO,CAEtB,QAAO;AAET,WAAQ,KACN,qDAAqD,OAAO,OAAO,iCACpE;AACD,UAAO,EAAE;WACF,OAAO;AACd,UAAO,EAAE;;;;;;;;;;CAWb,SAAgB,kBAAkB,KAAsC;AACtE,MAAI;GACF,MAAM,SAAS,KAAK,MAAM,IAAI;AAC9B,OACE,OAAO,WAAW,YAClB,WAAW,QACX,CAAC,MAAM,QAAQ,OAAO,CAEtB,QAAO;AAET,WAAQ,KACN,qDAAqD,OAAO,OAAO,iCACpE;AACD,UAAO,EAAE;oBACH;AACN,WAAQ,KACN,4EACD;AACD,UAAO,EAAE;;;;;;;;;;;;;CAcb,SAAgB,0BACd,QACA,OAC2B;AAC3B,UAAQ,UAAkB,KAAK,IAAI,SAAS,MAAM,QAAQ,IAAI,MAAM;;;;;CCrEtE,MAAa,SAAS;;;;CCAtB,MAAa,mBAAmB;;CAGhC,MAAa,sBAAsB;;;;CCKnC,MAAM,qBAAqB;CAC3B,MAAM,0BAA0B;CAEhC,SAAgB,kBACd,QACA,UAA8B,EAAE,EACnB;EACb,MAAM,EAAE,gBAAgB,OAAO,wBAAwB;EAEvD,MAAM,sBAAsB,uFAAuB;EACnD,MAAM,wBACJ,uBAAuB,wBAAwB,qBAC3C,sBACA;EAEN,MAAM,WAAwB,EAAE;EAEhC,MAAM,iCAAiB,IAAI,KAAa;EACxC,MAAM,gCAAgB,IAAI,KAMvB;AAEH,OAAK,MAAM,SAAS,OAClB,SAAQ,MAAM,MAAd;GACE,KAAKC,wBAAU,oBAAoB;IACjC,MAAM,YAAa,MAAiC;AACpD,QAAI,OAAO,cAAc,SACvB,gBAAe,IAAI,UAAU;AAE/B;;GAEF,KAAKA,wBAAU,kBAAkB;IAC/B,MAAM,YAAa,MAAiC;AACpD,QAAI,OAAO,cAAc,SACvB,gBAAe,OAAO,UAAU;AAElC;;GAEF,KAAKA,wBAAU,iBAAiB;IAC9B,MAAM,aAAc,MAAkC;AACtD,QAAI,OAAO,eAAe,SACxB,eAAc,IAAI,YAAY;KAC5B,QAAQ;KACR,WAAW;KACZ,CAAC;AAEJ;;GAEF,KAAKA,wBAAU,eAAe;IAC5B,MAAM,aAAc,MAAkC;IACtD,MAAM,OAAO,aAAa,cAAc,IAAI,WAAW,GAAG;AAC1D,QAAI,KACF,MAAK,SAAS;AAEhB;;GAEF,KAAKA,wBAAU,kBAAkB;IAC/B,MAAM,aAAc,MAAkC;IACtD,MAAM,OAAO,aAAa,cAAc,IAAI,WAAW,GAAG;AAC1D,QAAI,KACF,MAAK,YAAY;AAEnB;;GAEF,QACE;;EAIN,MAAM,iBAAiB,OAAO,MAC3B,UAAU,MAAM,SAASA,wBAAU,aACrC;EACD,MAAM,cAAc,OAAO,MACxB,UAAU,MAAM,SAASA,wBAAU,UACrC;EAED,MAAM,uBAAuB,EADJ,kBAAkB;AAG3C,OAAK,MAAM,aAAa,gBAAgB;GACtC,MAAM,WAAW;IACf,MAAMA,wBAAU;IAChB;IACD;AACD,UAAO,KAAK,SAAS;AACrB,YAAS,KAAK,SAAS;;AAGzB,OAAK,MAAM,CAAC,YAAY,SAAS,eAAe;AAC9C,OAAI,CAAC,KAAK,QAAQ;IAChB,MAAM,WAAW;KACf,MAAMA,wBAAU;KAChB;KACD;AACD,WAAO,KAAK,SAAS;AACrB,aAAS,KAAK,SAAS;;AAGzB,OAAI,wBAAwB,CAAC,KAAK,WAAW;IAC3C,MAAM,cAAc;KAClB,MAAMA,wBAAU;KAChB;KACA,WAAW,GAAG,4DAAc,YAAY,CAAC;KACzC,MAAM;KACN,SAAS,KAAK,UACZ,gBACI;MACE,QAAQ;MACR,QAAQ;MACR,SAAS;MACV,GACD;MACE,QAAQ;MACR,QAAQ;MACR,SAAS;MACV,CACN;KACF;AACD,WAAO,KAAK,YAAY;AACxB,aAAS,KAAK,YAAY;;;AAI9B,MAAI,qBACF,KAAI,eAAe;GACjB,MAAM,gBAAgB,EACpB,MAAMA,wBAAU,cACjB;AACD,UAAO,KAAK,cAAc;AAC1B,YAAS,KAAK,cAAc;SACvB;GACL,MAAM,aAA4B;IAChC,MAAMA,wBAAU;IAChB,SAAS;IACT,MAAM;IACP;AACD,UAAO,KAAK,WAAW;AACvB,YAAS,KAAK,WAAW;;AAI7B,SAAO;;;;;;;;;;CCnJT,IAAY,0EAAL;;AAEL;;AAEA;;AAEA;;AAEA;;AAEA;;AAEA;;AAEA;;AAEA;;AAEA;;;;;;;CAgBF,MAAa,sBAAsB;EACjC,6BAAyD;GACvD,OAAO,uBAAuB;GAC9B,SAAS;GACT,WAAW;GACZ;EAED,qBACE,QACA,eACgC;GAChC,OAAO,uBAAuB;GAC9B,SAAS,6BAA6B,OAAO,eAAe,UAAU,KAAK,KAAK;GAChF,WAAW;GACZ;EAED,iBAAiB,aAAiD;GAChE,OAAO,uBAAuB;GAC9B,SAAS;GACT,WAAW;GACZ;EAED,oBAAgD;GAC9C,OAAO,uBAAuB;GAC9B,SAAS;GACT,WAAW;GACZ;EAED,mBAA+C;GAC7C,OAAO,uBAAuB;GAC9B,SAAS;GACT,WAAW;GACZ;EAED,gBAAgB,aAAiD;GAC/D,OAAO,uBAAuB;GAC9B;GACA,WAAW;GACZ;EAED,eACE,UAAkB,0CACc;GAChC,OAAO,uBAAuB;GAC9B;GACA,WAAW;GACZ;EAED,qBAAiD;GAC/C,OAAO,uBAAuB;GAC9B,SAAS;GACT,WAAW;GACZ;EAED,sBAAkD;GAChD,OAAO,uBAAuB;GAC9B,SAAS;GACT,WAAW;GACZ;EACF;;;;;;;CCrED,SAAS,sBACP,QACmD;EACnD,MAAM,QAAQ,OAAO;AACrB,SACE,SAAS,QACT,OAAO,UAAU,YACjB,gBAAgB,SAChB,MAAM,cAAc,QACpB,OAAO,MAAM,eAAe,YAC5B,WAAW,MAAM,cACjB,OAAO,MAAM,WAAW,UAAU;;;;;;;;;;;;CActC,SAAgB,mBACd,QACA,SACyB;AAEzB,MAAI,sBAAsB,OAAO,CAC/B,QAAO,OAAO,aAAa,WAAW,MAAM,EAAE,QAAQ,YAAY,CAAC;EAIrE,MAAM,SAAS,OAAO,aAAa;AACnC,MAAI,WAAW,4DAAS,QAAS,iBAC/B,QAAO,QAAQ,gBAAgB,QAAQ,EAAE,cAAc,QAAQ,CAAC;AAGlE,QAAM,IAAI,MACR,8DAA8D,OAAO,yOAItE"}

package/dist/standard-schema.cjs

@@ -0,0 +1,29 @@
+
+//#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?.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
+exports.schemaToJsonSchema = schemaToJsonSchema;
+//# sourceMappingURL=standard-schema.cjs.map

package/dist/standard-schema.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"standard-schema.cjs","names":[],"sources":["../src/standard-schema.ts"],"sourcesContent":["import type {\n  StandardSchemaV1,\n  StandardJSONSchemaV1,\n} from \"@standard-schema/spec\";\n\nexport type { StandardSchemaV1, StandardJSONSchemaV1 };\n\n/**\n * Extract the Output type from a StandardSchemaV1 schema.\n * Replaces `z.infer<S>` for generic schema inference.\n */\nexport type InferSchemaOutput<S> =\n  S extends StandardSchemaV1<any, infer O> ? O : never;\n\nexport interface SchemaToJsonSchemaOptions {\n  /**\n   * Injected `zodToJsonSchema` function so that `shared` does not depend on\n   * `zod-to-json-schema`. Required when the schema is a Zod v3 schema that\n   * does not implement Standard JSON Schema V1.\n   */\n  zodToJsonSchema?: (\n    schema: unknown,\n    options?: { $refStrategy?: string },\n  ) => Record<string, unknown>;\n}\n\n/**\n * Check whether a schema implements the Standard JSON Schema V1 protocol.\n */\nfunction hasStandardJsonSchema(\n  schema: StandardSchemaV1,\n): schema is StandardSchemaV1 & StandardJSONSchemaV1 {\n  const props = schema[\"~standard\"];\n  return (\n    props != null &&\n    typeof props === \"object\" &&\n    \"jsonSchema\" in props &&\n    props.jsonSchema != null &&\n    typeof props.jsonSchema === \"object\" &&\n    \"input\" in props.jsonSchema &&\n    typeof props.jsonSchema.input === \"function\"\n  );\n}\n\n/**\n * Convert any StandardSchemaV1-compatible schema to a JSON Schema object.\n *\n * Strategy:\n * 1. If the schema implements Standard JSON Schema V1 (`~standard.jsonSchema`),\n *    call `schema['~standard'].jsonSchema.input({ target: 'draft-07' })`.\n * 2. If the schema is a Zod v3 schema (`~standard.vendor === 'zod'`), use the\n *    injected `zodToJsonSchema()` function.\n * 3. Otherwise throw a descriptive error.\n */\nexport function schemaToJsonSchema(\n  schema: StandardSchemaV1,\n  options?: SchemaToJsonSchemaOptions,\n): Record<string, unknown> {\n  // 1. Standard JSON Schema V1\n  if (hasStandardJsonSchema(schema)) {\n    return schema[\"~standard\"].jsonSchema.input({ target: \"draft-07\" });\n  }\n\n  // 2. Zod v3 fallback\n  const vendor = schema[\"~standard\"].vendor;\n  if (vendor === \"zod\" && options?.zodToJsonSchema) {\n    return options.zodToJsonSchema(schema, { $refStrategy: \"none\" });\n  }\n\n  throw new Error(\n    `Cannot convert schema to JSON Schema. The schema (vendor: \"${vendor}\") does not implement Standard JSON Schema V1 ` +\n      `and no zodToJsonSchema fallback is available. ` +\n      `Use a library that supports Standard JSON Schema (e.g., Zod 3.24+, Valibot v1+, ArkType v2+) ` +\n      `or pass a zodToJsonSchema function in options.`,\n  );\n}\n"],"mappings":";;;;;AA6BA,SAAS,sBACP,QACmD;CACnD,MAAM,QAAQ,OAAO;AACrB,QACE,SAAS,QACT,OAAO,UAAU,YACjB,gBAAgB,SAChB,MAAM,cAAc,QACpB,OAAO,MAAM,eAAe,YAC5B,WAAW,MAAM,cACjB,OAAO,MAAM,WAAW,UAAU;;;;;;;;;;;;AActC,SAAgB,mBACd,QACA,SACyB;AAEzB,KAAI,sBAAsB,OAAO,CAC/B,QAAO,OAAO,aAAa,WAAW,MAAM,EAAE,QAAQ,YAAY,CAAC;CAIrE,MAAM,SAAS,OAAO,aAAa;AACnC,KAAI,WAAW,SAAS,SAAS,gBAC/B,QAAO,QAAQ,gBAAgB,QAAQ,EAAE,cAAc,QAAQ,CAAC;AAGlE,OAAM,IAAI,MACR,8DAA8D,OAAO,yOAItE"}

package/dist/standard-schema.d.cts

@@ -0,0 +1,32 @@
+import { StandardJSONSchemaV1, StandardSchemaV1 } from "@standard-schema/spec";
+
+//#region src/standard-schema.d.ts
+/**
+ * Extract the Output type from a StandardSchemaV1 schema.
+ * Replaces `z.infer<S>` for generic schema inference.
+ */
+type InferSchemaOutput<S> = S extends StandardSchemaV1<any, infer O> ? O : never;
+interface SchemaToJsonSchemaOptions {
+  /**
+   * Injected `zodToJsonSchema` function so that `shared` does not depend on
+   * `zod-to-json-schema`. Required when the schema is a Zod v3 schema that
+   * does not implement Standard JSON Schema V1.
+   */
+  zodToJsonSchema?: (schema: unknown, options?: {
+    $refStrategy?: string;
+  }) => Record<string, unknown>;
+}
+/**
+ * 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.
+ */
+declare function schemaToJsonSchema(schema: StandardSchemaV1, options?: SchemaToJsonSchemaOptions): Record<string, unknown>;
+//#endregion
+export { InferSchemaOutput, SchemaToJsonSchemaOptions, type StandardJSONSchemaV1, type StandardSchemaV1, schemaToJsonSchema };
+//# sourceMappingURL=standard-schema.d.cts.map

package/dist/standard-schema.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"standard-schema.d.cts","names":[],"sources":["../src/standard-schema.ts"],"mappings":";;;;AAWA;;;KAAY,iBAAA,MACV,CAAA,SAAU,gBAAA,iBAAiC,CAAA;AAAA,UAE5B,yBAAA;EAFf;;;;;EAQA,eAAA,IACE,MAAA,WACA,OAAA;IAAY,YAAA;EAAA,MACT,MAAA;AAAA;;;;;;;;;AA+BP;;iBAAgB,kBAAA,CACd,MAAA,EAAQ,gBAAA,EACR,OAAA,GAAU,yBAAA,GACT,MAAA"}

package/dist/standard-schema.d.mts

@@ -0,0 +1,32 @@
+import { StandardJSONSchemaV1, StandardSchemaV1 } from "@standard-schema/spec";
+
+//#region src/standard-schema.d.ts
+/**
+ * Extract the Output type from a StandardSchemaV1 schema.
+ * Replaces `z.infer<S>` for generic schema inference.
+ */
+type InferSchemaOutput<S> = S extends StandardSchemaV1<any, infer O> ? O : never;
+interface SchemaToJsonSchemaOptions {
+  /**
+   * Injected `zodToJsonSchema` function so that `shared` does not depend on
+   * `zod-to-json-schema`. Required when the schema is a Zod v3 schema that
+   * does not implement Standard JSON Schema V1.
+   */
+  zodToJsonSchema?: (schema: unknown, options?: {
+    $refStrategy?: string;
+  }) => Record<string, unknown>;
+}
+/**
+ * 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.
+ */
+declare function schemaToJsonSchema(schema: StandardSchemaV1, options?: SchemaToJsonSchemaOptions): Record<string, unknown>;
+//#endregion
+export { InferSchemaOutput, SchemaToJsonSchemaOptions, type StandardJSONSchemaV1, type StandardSchemaV1, schemaToJsonSchema };
+//# sourceMappingURL=standard-schema.d.mts.map

package/dist/standard-schema.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"standard-schema.d.mts","names":[],"sources":["../src/standard-schema.ts"],"mappings":";;;;AAWA;;;KAAY,iBAAA,MACV,CAAA,SAAU,gBAAA,iBAAiC,CAAA;AAAA,UAE5B,yBAAA;EAFf;;;;;EAQA,eAAA,IACE,MAAA,WACA,OAAA;IAAY,YAAA;EAAA,MACT,MAAA;AAAA;;;;;;;;;AA+BP;;iBAAgB,kBAAA,CACd,MAAA,EAAQ,gBAAA,EACR,OAAA,GAAU,yBAAA,GACT,MAAA"}

package/dist/standard-schema.mjs

@@ -0,0 +1,28 @@
+//#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?.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
+export { schemaToJsonSchema };
+//# sourceMappingURL=standard-schema.mjs.map

package/dist/standard-schema.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"standard-schema.mjs","names":[],"sources":["../src/standard-schema.ts"],"sourcesContent":["import type {\n  StandardSchemaV1,\n  StandardJSONSchemaV1,\n} from \"@standard-schema/spec\";\n\nexport type { StandardSchemaV1, StandardJSONSchemaV1 };\n\n/**\n * Extract the Output type from a StandardSchemaV1 schema.\n * Replaces `z.infer<S>` for generic schema inference.\n */\nexport type InferSchemaOutput<S> =\n  S extends StandardSchemaV1<any, infer O> ? O : never;\n\nexport interface SchemaToJsonSchemaOptions {\n  /**\n   * Injected `zodToJsonSchema` function so that `shared` does not depend on\n   * `zod-to-json-schema`. Required when the schema is a Zod v3 schema that\n   * does not implement Standard JSON Schema V1.\n   */\n  zodToJsonSchema?: (\n    schema: unknown,\n    options?: { $refStrategy?: string },\n  ) => Record<string, unknown>;\n}\n\n/**\n * Check whether a schema implements the Standard JSON Schema V1 protocol.\n */\nfunction hasStandardJsonSchema(\n  schema: StandardSchemaV1,\n): schema is StandardSchemaV1 & StandardJSONSchemaV1 {\n  const props = schema[\"~standard\"];\n  return (\n    props != null &&\n    typeof props === \"object\" &&\n    \"jsonSchema\" in props &&\n    props.jsonSchema != null &&\n    typeof props.jsonSchema === \"object\" &&\n    \"input\" in props.jsonSchema &&\n    typeof props.jsonSchema.input === \"function\"\n  );\n}\n\n/**\n * Convert any StandardSchemaV1-compatible schema to a JSON Schema object.\n *\n * Strategy:\n * 1. If the schema implements Standard JSON Schema V1 (`~standard.jsonSchema`),\n *    call `schema['~standard'].jsonSchema.input({ target: 'draft-07' })`.\n * 2. If the schema is a Zod v3 schema (`~standard.vendor === 'zod'`), use the\n *    injected `zodToJsonSchema()` function.\n * 3. Otherwise throw a descriptive error.\n */\nexport function schemaToJsonSchema(\n  schema: StandardSchemaV1,\n  options?: SchemaToJsonSchemaOptions,\n): Record<string, unknown> {\n  // 1. Standard JSON Schema V1\n  if (hasStandardJsonSchema(schema)) {\n    return schema[\"~standard\"].jsonSchema.input({ target: \"draft-07\" });\n  }\n\n  // 2. Zod v3 fallback\n  const vendor = schema[\"~standard\"].vendor;\n  if (vendor === \"zod\" && options?.zodToJsonSchema) {\n    return options.zodToJsonSchema(schema, { $refStrategy: \"none\" });\n  }\n\n  throw new Error(\n    `Cannot convert schema to JSON Schema. The schema (vendor: \"${vendor}\") does not implement Standard JSON Schema V1 ` +\n      `and no zodToJsonSchema fallback is available. ` +\n      `Use a library that supports Standard JSON Schema (e.g., Zod 3.24+, Valibot v1+, ArkType v2+) ` +\n      `or pass a zodToJsonSchema function in options.`,\n  );\n}\n"],"mappings":";;;;AA6BA,SAAS,sBACP,QACmD;CACnD,MAAM,QAAQ,OAAO;AACrB,QACE,SAAS,QACT,OAAO,UAAU,YACjB,gBAAgB,SAChB,MAAM,cAAc,QACpB,OAAO,MAAM,eAAe,YAC5B,WAAW,MAAM,cACjB,OAAO,MAAM,WAAW,UAAU;;;;;;;;;;;;AActC,SAAgB,mBACd,QACA,SACyB;AAEzB,KAAI,sBAAsB,OAAO,CAC/B,QAAO,OAAO,aAAa,WAAW,MAAM,EAAE,QAAQ,YAAY,CAAC;CAIrE,MAAM,SAAS,OAAO,aAAa;AACnC,KAAI,WAAW,SAAS,SAAS,gBAC/B,QAAO,QAAQ,gBAAgB,QAAQ,EAAE,cAAc,QAAQ,CAAC;AAGlE,OAAM,IAAI,MACR,8DAA8D,OAAO,yOAItE"}

package/dist/types.d.cts

@@ -16,6 +16,7 @@ interface RuntimeInfo {
   version: string;
   agents: Record<string, AgentDescription>;
   audioFileTranscriptionEnabled: boolean;
+  a2uiEnabled?: boolean;
 }
 //#endregion
 export { AgentDescription, MaybePromise, NonEmptyRecord, RuntimeInfo };

package/dist/types.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.cts","names":[],"sources":["../src/types.ts"],"mappings":";KAAY,YAAA,MAAkB,CAAA,GAAI,WAAA,CAAY,CAAA;AAA9C;;;AAAA,KAKY,cAAA,MACV,CAAA,SAAU,MAAA,0BACA,CAAA,yBAEJ,CAAA;;;;UAMS,gBAAA;EACf,IAAA;EACA,SAAA;EACA,WAAA;AAAA;AAAA,UAGe,WAAA;EACf,OAAA;EACA,MAAA,EAAQ,MAAA,SAAe,gBAAA;EACvB,6BAAA;AAAA"}
+{"version":3,"file":"types.d.cts","names":[],"sources":["../src/types.ts"],"mappings":";KAAY,YAAA,MAAkB,CAAA,GAAI,WAAA,CAAY,CAAA;AAA9C;;;AAAA,KAKY,cAAA,MACV,CAAA,SAAU,MAAA,0BACA,CAAA,yBAEJ,CAAA;;;;UAMS,gBAAA;EACf,IAAA;EACA,SAAA;EACA,WAAA;AAAA;AAAA,UAGe,WAAA;EACf,OAAA;EACA,MAAA,EAAQ,MAAA,SAAe,gBAAA;EACvB,6BAAA;EACA,WAAA;AAAA"}

package/dist/types.d.mts

@@ -16,6 +16,7 @@ interface RuntimeInfo {
   version: string;
   agents: Record<string, AgentDescription>;
   audioFileTranscriptionEnabled: boolean;
+  a2uiEnabled?: boolean;
 }
 //#endregion
 export { AgentDescription, MaybePromise, NonEmptyRecord, RuntimeInfo };

package/dist/types.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.mts","names":[],"sources":["../src/types.ts"],"mappings":";KAAY,YAAA,MAAkB,CAAA,GAAI,WAAA,CAAY,CAAA;AAA9C;;;AAAA,KAKY,cAAA,MACV,CAAA,SAAU,MAAA,0BACA,CAAA,yBAEJ,CAAA;;;;UAMS,gBAAA;EACf,IAAA;EACA,SAAA;EACA,WAAA;AAAA;AAAA,UAGe,WAAA;EACf,OAAA;EACA,MAAA,EAAQ,MAAA,SAAe,gBAAA;EACvB,6BAAA;AAAA"}
+{"version":3,"file":"types.d.mts","names":[],"sources":["../src/types.ts"],"mappings":";KAAY,YAAA,MAAkB,CAAA,GAAI,WAAA,CAAY,CAAA;AAA9C;;;AAAA,KAKY,cAAA,MACV,CAAA,SAAU,MAAA,0BACA,CAAA,yBAEJ,CAAA;;;;UAMS,gBAAA;EACf,IAAA;EACA,SAAA;EACA,WAAA;AAAA;AAAA,UAGe,WAAA;EACf,OAAA;EACA,MAAA,EAAQ,MAAA,SAAe,gBAAA;EACvB,6BAAA;EACA,WAAA;AAAA"}

package/dist/utils.cjs

@@ -9,12 +9,33 @@ function randomUUID() {
 }
 function partialJSONParse(json) {
 	try {
-		return partial_json.parse(json);
+		const parsed = partial_json.parse(json);
+		if (typeof parsed === "object" && parsed !== null && !Array.isArray(parsed)) return parsed;
+		console.warn(`[CopilotKit] Tool arguments parsed to non-object (${typeof parsed}), falling back to empty object`);
+		return {};
 	} catch (error) {
 		return {};
 	}
 }
 /**
+* Safely parses a JSON string into a plain object for tool arguments.
+* Handles two failure modes:
+*  1. Malformed JSON (SyntaxError from JSON.parse)
+*  2. Valid JSON that isn't a plain object (e.g. "", [], null, 42, true)
+* Falls back to an empty object for safety in both cases.
+*/
+function safeParseToolArgs(raw) {
+	try {
+		const parsed = JSON.parse(raw);
+		if (typeof parsed === "object" && parsed !== null && !Array.isArray(parsed)) return parsed;
+		console.warn(`[CopilotKit] Tool arguments parsed to non-object (${typeof parsed}), falling back to empty object`);
+		return {};
+	} catch {
+		console.warn("[CopilotKit] Failed to parse tool arguments, falling back to empty object");
+		return {};
+	}
+}
+/**
 * Returns an exponential backoff function suitable for Phoenix.js
 * `reconnectAfterMs` and `rejoinAfterMs` options.
 *
@@ -32,4 +53,5 @@ function phoenixExponentialBackoff(baseMs, maxMs) {
 exports.partialJSONParse = partialJSONParse;
 exports.phoenixExponentialBackoff = phoenixExponentialBackoff;
 exports.randomUUID = randomUUID;
+exports.safeParseToolArgs = safeParseToolArgs;
 //# sourceMappingURL=utils.cjs.map

package/dist/utils.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"utils.cjs","names":["PartialJSON"],"sources":["../src/utils.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\n/**\n * Returns an exponential backoff function suitable for Phoenix.js\n * `reconnectAfterMs` and `rejoinAfterMs` options.\n *\n * @param baseMs  - Initial delay for the first retry attempt.\n * @param maxMs   - Upper bound — delays are capped at this value.\n *\n * Phoenix calls the returned function with a 1-based `tries` count.\n * The delay doubles on each attempt: baseMs, 2×baseMs, 4×baseMs, …, maxMs.\n */\nexport function phoenixExponentialBackoff(\n  baseMs: number,\n  maxMs: number,\n): (tries: number) => number {\n  return (tries: number) => Math.min(baseMs * 2 ** (tries - 1), maxMs);\n}\n"],"mappings":";;;;;;AAGA,SAAgB,aAAa;AAC3B,sBAAe;;AAGjB,SAAgB,iBAAiB,MAAc;AAC7C,KAAI;AACF,SAAOA,aAAY,MAAM,KAAK;UACvB,OAAO;AACd,SAAO,EAAE;;;;;;;;;;;;;AAcb,SAAgB,0BACd,QACA,OAC2B;AAC3B,SAAQ,UAAkB,KAAK,IAAI,SAAS,MAAM,QAAQ,IAAI,MAAM"}
+{"version":3,"file":"utils.cjs","names":["PartialJSON"],"sources":["../src/utils.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): unknown {\n  try {\n    const parsed = PartialJSON.parse(json);\n    if (\n      typeof parsed === \"object\" &&\n      parsed !== null &&\n      !Array.isArray(parsed)\n    ) {\n      return parsed as Record<string, unknown>;\n    }\n    console.warn(\n      `[CopilotKit] Tool arguments parsed to non-object (${typeof parsed}), falling back to empty object`,\n    );\n    return {};\n  } catch (error) {\n    return {};\n  }\n}\n\n/**\n * Safely parses a JSON string into a plain object for tool arguments.\n * Handles two failure modes:\n *  1. Malformed JSON (SyntaxError from JSON.parse)\n *  2. Valid JSON that isn't a plain object (e.g. \"\", [], null, 42, true)\n * Falls back to an empty object for safety in both cases.\n */\nexport function safeParseToolArgs(raw: string): Record<string, unknown> {\n  try {\n    const parsed = JSON.parse(raw);\n    if (\n      typeof parsed === \"object\" &&\n      parsed !== null &&\n      !Array.isArray(parsed)\n    ) {\n      return parsed as Record<string, unknown>;\n    }\n    console.warn(\n      `[CopilotKit] Tool arguments parsed to non-object (${typeof parsed}), falling back to empty object`,\n    );\n    return {};\n  } catch {\n    console.warn(\n      \"[CopilotKit] Failed to parse tool arguments, falling back to empty object\",\n    );\n    return {};\n  }\n}\n\n/**\n * Returns an exponential backoff function suitable for Phoenix.js\n * `reconnectAfterMs` and `rejoinAfterMs` options.\n *\n * @param baseMs  - Initial delay for the first retry attempt.\n * @param maxMs   - Upper bound — delays are capped at this value.\n *\n * Phoenix calls the returned function with a 1-based `tries` count.\n * The delay doubles on each attempt: baseMs, 2×baseMs, 4×baseMs, …, maxMs.\n */\nexport function phoenixExponentialBackoff(\n  baseMs: number,\n  maxMs: number,\n): (tries: number) => number {\n  return (tries: number) => Math.min(baseMs * 2 ** (tries - 1), maxMs);\n}\n"],"mappings":";;;;;;AAGA,SAAgB,aAAa;AAC3B,sBAAe;;AAGjB,SAAgB,iBAAiB,MAAuB;AACtD,KAAI;EACF,MAAM,SAASA,aAAY,MAAM,KAAK;AACtC,MACE,OAAO,WAAW,YAClB,WAAW,QACX,CAAC,MAAM,QAAQ,OAAO,CAEtB,QAAO;AAET,UAAQ,KACN,qDAAqD,OAAO,OAAO,iCACpE;AACD,SAAO,EAAE;UACF,OAAO;AACd,SAAO,EAAE;;;;;;;;;;AAWb,SAAgB,kBAAkB,KAAsC;AACtE,KAAI;EACF,MAAM,SAAS,KAAK,MAAM,IAAI;AAC9B,MACE,OAAO,WAAW,YAClB,WAAW,QACX,CAAC,MAAM,QAAQ,OAAO,CAEtB,QAAO;AAET,UAAQ,KACN,qDAAqD,OAAO,OAAO,iCACpE;AACD,SAAO,EAAE;SACH;AACN,UAAQ,KACN,4EACD;AACD,SAAO,EAAE;;;;;;;;;;;;;AAcb,SAAgB,0BACd,QACA,OAC2B;AAC3B,SAAQ,UAAkB,KAAK,IAAI,SAAS,MAAM,QAAQ,IAAI,MAAM"}

package/dist/utils.d.cts

@@ -1,6 +1,14 @@
 //#region src/utils.d.ts
 declare function randomUUID(): string;
-declare function partialJSONParse(json: string): any;
+declare function partialJSONParse(json: string): unknown;
+/**
+ * Safely parses a JSON string into a plain object for tool arguments.
+ * Handles two failure modes:
+ *  1. Malformed JSON (SyntaxError from JSON.parse)
+ *  2. Valid JSON that isn't a plain object (e.g. "", [], null, 42, true)
+ * Falls back to an empty object for safety in both cases.
+ */
+declare function safeParseToolArgs(raw: string): Record<string, unknown>;
 /**
  * Returns an exponential backoff function suitable for Phoenix.js
  * `reconnectAfterMs` and `rejoinAfterMs` options.
@@ -13,5 +21,5 @@ declare function partialJSONParse(json: string): any;
  */
 declare function phoenixExponentialBackoff(baseMs: number, maxMs: number): (tries: number) => number;
 //#endregion
-export { partialJSONParse, phoenixExponentialBackoff, randomUUID };
+export { partialJSONParse, phoenixExponentialBackoff, randomUUID, safeParseToolArgs };
 //# sourceMappingURL=utils.d.cts.map

package/dist/utils.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.cts","names":[],"sources":["../src/utils.ts"],"mappings":";iBAGgB,UAAA,CAAA;AAAA,iBAIA,gBAAA,CAAiB,IAAA;;;;;AAAjC;;;;;AAkBA;iBAAgB,yBAAA,CACd,MAAA,UACA,KAAA,YACE,KAAA"}
+{"version":3,"file":"utils.d.cts","names":[],"sources":["../src/utils.ts"],"mappings":";iBAGgB,UAAA,CAAA;AAAA,iBAIA,gBAAA,CAAiB,IAAA;;;;;AAAjC;;;iBA0BgB,iBAAA,CAAkB,GAAA,WAAc,MAAA;;AAAhD;;;;;AAgCA;;;;iBAAgB,yBAAA,CACd,MAAA,UACA,KAAA,YACE,KAAA"}

package/dist/utils.d.mts

@@ -1,6 +1,14 @@
 //#region src/utils.d.ts
 declare function randomUUID(): string;
-declare function partialJSONParse(json: string): any;
+declare function partialJSONParse(json: string): unknown;
+/**
+ * Safely parses a JSON string into a plain object for tool arguments.
+ * Handles two failure modes:
+ *  1. Malformed JSON (SyntaxError from JSON.parse)
+ *  2. Valid JSON that isn't a plain object (e.g. "", [], null, 42, true)
+ * Falls back to an empty object for safety in both cases.
+ */
+declare function safeParseToolArgs(raw: string): Record<string, unknown>;
 /**
  * Returns an exponential backoff function suitable for Phoenix.js
  * `reconnectAfterMs` and `rejoinAfterMs` options.
@@ -13,5 +21,5 @@ declare function partialJSONParse(json: string): any;
  */
 declare function phoenixExponentialBackoff(baseMs: number, maxMs: number): (tries: number) => number;
 //#endregion
-export { partialJSONParse, phoenixExponentialBackoff, randomUUID };
+export { partialJSONParse, phoenixExponentialBackoff, randomUUID, safeParseToolArgs };
 //# sourceMappingURL=utils.d.mts.map

package/dist/utils.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.mts","names":[],"sources":["../src/utils.ts"],"mappings":";iBAGgB,UAAA,CAAA;AAAA,iBAIA,gBAAA,CAAiB,IAAA;;;;;AAAjC;;;;;AAkBA;iBAAgB,yBAAA,CACd,MAAA,UACA,KAAA,YACE,KAAA"}
+{"version":3,"file":"utils.d.mts","names":[],"sources":["../src/utils.ts"],"mappings":";iBAGgB,UAAA,CAAA;AAAA,iBAIA,gBAAA,CAAiB,IAAA;;;;;AAAjC;;;iBA0BgB,iBAAA,CAAkB,GAAA,WAAc,MAAA;;AAAhD;;;;;AAgCA;;;;iBAAgB,yBAAA,CACd,MAAA,UACA,KAAA,YACE,KAAA"}

package/dist/utils.mjs

@@ -7,12 +7,33 @@ function randomUUID() {
 }
 function partialJSONParse(json) {
 	try {
-		return PartialJSON.parse(json);
+		const parsed = PartialJSON.parse(json);
+		if (typeof parsed === "object" && parsed !== null && !Array.isArray(parsed)) return parsed;
+		console.warn(`[CopilotKit] Tool arguments parsed to non-object (${typeof parsed}), falling back to empty object`);
+		return {};
 	} catch (error) {
 		return {};
 	}
 }
 /**
+* Safely parses a JSON string into a plain object for tool arguments.
+* Handles two failure modes:
+*  1. Malformed JSON (SyntaxError from JSON.parse)
+*  2. Valid JSON that isn't a plain object (e.g. "", [], null, 42, true)
+* Falls back to an empty object for safety in both cases.
+*/
+function safeParseToolArgs(raw) {
+	try {
+		const parsed = JSON.parse(raw);
+		if (typeof parsed === "object" && parsed !== null && !Array.isArray(parsed)) return parsed;
+		console.warn(`[CopilotKit] Tool arguments parsed to non-object (${typeof parsed}), falling back to empty object`);
+		return {};
+	} catch {
+		console.warn("[CopilotKit] Failed to parse tool arguments, falling back to empty object");
+		return {};
+	}
+}
+/**
 * Returns an exponential backoff function suitable for Phoenix.js
 * `reconnectAfterMs` and `rejoinAfterMs` options.
 *
@@ -27,5 +48,5 @@ function phoenixExponentialBackoff(baseMs, maxMs) {
 }
 
 //#endregion
-export { partialJSONParse, phoenixExponentialBackoff, randomUUID };
+export { partialJSONParse, phoenixExponentialBackoff, randomUUID, safeParseToolArgs };
 //# sourceMappingURL=utils.mjs.map

package/dist/utils.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"utils.mjs","names":["uuidv4"],"sources":["../src/utils.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\n/**\n * Returns an exponential backoff function suitable for Phoenix.js\n * `reconnectAfterMs` and `rejoinAfterMs` options.\n *\n * @param baseMs  - Initial delay for the first retry attempt.\n * @param maxMs   - Upper bound — delays are capped at this value.\n *\n * Phoenix calls the returned function with a 1-based `tries` count.\n * The delay doubles on each attempt: baseMs, 2×baseMs, 4×baseMs, …, maxMs.\n */\nexport function phoenixExponentialBackoff(\n  baseMs: number,\n  maxMs: number,\n): (tries: number) => number {\n  return (tries: number) => Math.min(baseMs * 2 ** (tries - 1), maxMs);\n}\n"],"mappings":";;;;AAGA,SAAgB,aAAa;AAC3B,QAAOA,IAAQ;;AAGjB,SAAgB,iBAAiB,MAAc;AAC7C,KAAI;AACF,SAAO,YAAY,MAAM,KAAK;UACvB,OAAO;AACd,SAAO,EAAE;;;;;;;;;;;;;AAcb,SAAgB,0BACd,QACA,OAC2B;AAC3B,SAAQ,UAAkB,KAAK,IAAI,SAAS,MAAM,QAAQ,IAAI,MAAM"}
+{"version":3,"file":"utils.mjs","names":["uuidv4"],"sources":["../src/utils.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): unknown {\n  try {\n    const parsed = PartialJSON.parse(json);\n    if (\n      typeof parsed === \"object\" &&\n      parsed !== null &&\n      !Array.isArray(parsed)\n    ) {\n      return parsed as Record<string, unknown>;\n    }\n    console.warn(\n      `[CopilotKit] Tool arguments parsed to non-object (${typeof parsed}), falling back to empty object`,\n    );\n    return {};\n  } catch (error) {\n    return {};\n  }\n}\n\n/**\n * Safely parses a JSON string into a plain object for tool arguments.\n * Handles two failure modes:\n *  1. Malformed JSON (SyntaxError from JSON.parse)\n *  2. Valid JSON that isn't a plain object (e.g. \"\", [], null, 42, true)\n * Falls back to an empty object for safety in both cases.\n */\nexport function safeParseToolArgs(raw: string): Record<string, unknown> {\n  try {\n    const parsed = JSON.parse(raw);\n    if (\n      typeof parsed === \"object\" &&\n      parsed !== null &&\n      !Array.isArray(parsed)\n    ) {\n      return parsed as Record<string, unknown>;\n    }\n    console.warn(\n      `[CopilotKit] Tool arguments parsed to non-object (${typeof parsed}), falling back to empty object`,\n    );\n    return {};\n  } catch {\n    console.warn(\n      \"[CopilotKit] Failed to parse tool arguments, falling back to empty object\",\n    );\n    return {};\n  }\n}\n\n/**\n * Returns an exponential backoff function suitable for Phoenix.js\n * `reconnectAfterMs` and `rejoinAfterMs` options.\n *\n * @param baseMs  - Initial delay for the first retry attempt.\n * @param maxMs   - Upper bound — delays are capped at this value.\n *\n * Phoenix calls the returned function with a 1-based `tries` count.\n * The delay doubles on each attempt: baseMs, 2×baseMs, 4×baseMs, …, maxMs.\n */\nexport function phoenixExponentialBackoff(\n  baseMs: number,\n  maxMs: number,\n): (tries: number) => number {\n  return (tries: number) => Math.min(baseMs * 2 ** (tries - 1), maxMs);\n}\n"],"mappings":";;;;AAGA,SAAgB,aAAa;AAC3B,QAAOA,IAAQ;;AAGjB,SAAgB,iBAAiB,MAAuB;AACtD,KAAI;EACF,MAAM,SAAS,YAAY,MAAM,KAAK;AACtC,MACE,OAAO,WAAW,YAClB,WAAW,QACX,CAAC,MAAM,QAAQ,OAAO,CAEtB,QAAO;AAET,UAAQ,KACN,qDAAqD,OAAO,OAAO,iCACpE;AACD,SAAO,EAAE;UACF,OAAO;AACd,SAAO,EAAE;;;;;;;;;;AAWb,SAAgB,kBAAkB,KAAsC;AACtE,KAAI;EACF,MAAM,SAAS,KAAK,MAAM,IAAI;AAC9B,MACE,OAAO,WAAW,YAClB,WAAW,QACX,CAAC,MAAM,QAAQ,OAAO,CAEtB,QAAO;AAET,UAAQ,KACN,qDAAqD,OAAO,OAAO,iCACpE;AACD,SAAO,EAAE;SACH;AACN,UAAQ,KACN,4EACD;AACD,SAAO,EAAE;;;;;;;;;;;;;AAcb,SAAgB,0BACd,QACA,OAC2B;AAC3B,SAAQ,UAAkB,KAAK,IAAI,SAAS,MAAM,QAAQ,IAAI,MAAM"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@copilotkitnext/shared",
-  "version": "1.53.1-next.1",
+  "version": "1.54.0-next.3",
   "description": "Shared utilities and types for CopilotKit2",
   "main": "./dist/index.cjs",
   "types": "./dist/index.d.cts",
@@ -19,16 +19,23 @@
   },
   "devDependencies": {
     "@types/node": "^22.15.3",
+    "@valibot/to-json-schema": "^1.5.0",
+    "arktype": "^2.1.29",
     "eslint": "^9.30.0",
     "tsdown": "^0.20.3",
     "typescript": "5.8.2",
-    "@copilotkitnext/eslint-config": "1.53.1-next.1",
-    "@copilotkitnext/typescript-config": "1.53.1-next.1"
+    "valibot": "^1.2.0",
+    "vitest": "^4.0.18",
+    "zod": "^3.25.75",
+    "zod-to-json-schema": "^3.24.6",
+    "@copilotkitnext/eslint-config": "1.54.0-next.3",
+    "@copilotkitnext/typescript-config": "1.54.0-next.3"
   },
   "dependencies": {
     "@ag-ui/client": "0.0.47",
-    "uuid": "^11.1.0",
-    "partial-json": "^0.1.7"
+    "@standard-schema/spec": "^1.1.0",
+    "partial-json": "^0.1.7",
+    "uuid": "^11.1.0"
   },
   "engines": {
     "node": ">=18"
@@ -39,6 +46,8 @@
     "dev": "tsdown --watch",
     "lint": "eslint .",
     "check-types": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
     "publint": "publint .",
     "attw": "attw --pack . --profile node16"
   }

package/vitest.config.mjs

@@ -0,0 +1,11 @@
+import { defineConfig } from "vitest/config";
+
+export default defineConfig({
+  test: {
+    environment: "node",
+    globals: true,
+    include: ["src/**/__tests__/**/*.{test,spec}.ts"],
+    reporters: [["default", { summary: false }]],
+    silent: true,
+  },
+});