@copilotkit/shared 1.66.4 → 1.67.1

package/dist/package.cjs

@@ -1,6 +1,6 @@
 
 //#region package.json
-var version = "1.66.4";
+var version = "1.67.1";
 
 //#endregion
 Object.defineProperty(exports, 'version', {

package/dist/package.mjs

@@ -1,5 +1,5 @@
 //#region package.json
-var version = "1.66.4";
+var version = "1.67.1";
 
 //#endregion
 export { version };

package/dist/utils/index.cjs

@@ -4,6 +4,7 @@ const require_conditions = require('./conditions.cjs');
 const require_console_styling = require('./console-styling.cjs');
 const require_errors = require('./errors.cjs');
 const require_json_schema = require('./json-schema.cjs');
+const require_inspector_metadata = require('./inspector-metadata.cjs');
 const require_types = require('./types.cjs');
 const require_random_id = require('./random-id.cjs');
 const require_requests = require('./requests.cjs');
@@ -20,7 +21,7 @@ partial_json = require_runtime.__toESM(partial_json);
 function parseJson(json, fallback = "unset") {
 	try {
 		return JSON.parse(json);
-	} catch (e) {
+	} catch {
 		return fallback === "unset" ? null : fallback;
 	}
 }
@@ -33,7 +34,7 @@ function partialJSONParse(json) {
 		const parsed = partial_json.parse(json);
 		if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) return parsed;
 		return {};
-	} catch (error) {
+	} catch {
 		return {};
 	}
 }

package/dist/utils/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":["PartialJSON"],"sources":["../../src/utils/index.ts"],"sourcesContent":["export * from \"./clipboard\";\nexport * from \"./conditions\";\nexport * from \"./console-styling\";\nexport * from \"./errors\";\nexport * from \"./json-schema\";\nexport * from \"./types\";\nexport * from \"./random-id\";\nexport * from \"./requests\";\n\nimport * as PartialJSON from \"partial-json\";\n\n/**\n * Safely parses a JSON string into an object\n * @param json The JSON string to parse\n * @param fallback Optional fallback value to return if parsing fails. If not provided or set to \"unset\", returns null\n * @returns The parsed JSON object, or the fallback value (or null) if parsing fails\n */\nexport function parseJson(json: string, fallback: any = \"unset\") {\n  try {\n    return JSON.parse(json);\n  } catch (e) {\n    return fallback === \"unset\" ? null : fallback;\n  }\n}\n\n/**\n * Parses a partial/incomplete JSON string, returning as much valid data as possible.\n * Falls back to an empty object if parsing fails entirely.\n */\nexport function partialJSONParse(json: string) {\n  try {\n    const parsed = PartialJSON.parse(json);\n    if (parsed && typeof parsed === \"object\" && !Array.isArray(parsed)) {\n      return parsed;\n    }\n    return {};\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\n/**\n * Maps an array of items to a new array, skipping items that throw errors during mapping\n * @param items The array to map\n * @param callback The mapping function to apply to each item\n * @returns A new array containing only the successfully mapped items\n */\nexport function tryMap<TItem, TMapped>(\n  items: TItem[],\n  callback: (item: TItem, index: number, array: TItem[]) => TMapped,\n): TMapped[] {\n  return items.reduce<TMapped[]>((acc, item, index, array) => {\n    try {\n      acc.push(callback(item, index, array));\n    } catch (error) {\n      console.error(error);\n    }\n    return acc;\n  }, []);\n}\n\n/**\n * Checks if the current environment is macOS\n * @returns {boolean} True if running on macOS, false otherwise\n */\nexport function isMacOS(): boolean {\n  return /Mac|iMac|Macintosh/i.test(navigator.userAgent);\n}\n\n/**\n * Safely parses a JSON string into a tool arguments object.\n * Returns the parsed object only if it's a plain object (not an array, null, etc.).\n * Falls back to an empty object for any non-object JSON value or parse failure.\n */\nexport function safeParseToolArgs(raw: string): Record<string, unknown> {\n  try {\n    const parsed = JSON.parse(raw);\n    if (parsed && typeof parsed === \"object\" && !Array.isArray(parsed)) {\n      return parsed;\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"],"mappings":";;;;;;;;;;;;;;;;;;;AAiBA,SAAgB,UAAU,MAAc,WAAgB,SAAS;AAC/D,KAAI;AACF,SAAO,KAAK,MAAM,KAAK;UAChB,GAAG;AACV,SAAO,aAAa,UAAU,OAAO;;;;;;;AAQzC,SAAgB,iBAAiB,MAAc;AAC7C,KAAI;EACF,MAAM,SAASA,aAAY,MAAM,KAAK;AACtC,MAAI,UAAU,OAAO,WAAW,YAAY,CAAC,MAAM,QAAQ,OAAO,CAChE,QAAO;AAET,SAAO,EAAE;UACF,OAAO;AACd,SAAO,EAAE;;;;;;;;;;;;;AAcb,SAAgB,0BACd,QACA,OAC2B;AAC3B,SAAQ,UAAkB,KAAK,IAAI,SAAS,MAAM,QAAQ,IAAI,MAAM;;;;;;;;AAStE,SAAgB,OACd,OACA,UACW;AACX,QAAO,MAAM,QAAmB,KAAK,MAAM,OAAO,UAAU;AAC1D,MAAI;AACF,OAAI,KAAK,SAAS,MAAM,OAAO,MAAM,CAAC;WAC/B,OAAO;AACd,WAAQ,MAAM,MAAM;;AAEtB,SAAO;IACN,EAAE,CAAC;;;;;;AAOR,SAAgB,UAAmB;AACjC,QAAO,sBAAsB,KAAK,UAAU,UAAU;;;;;;;AAQxD,SAAgB,kBAAkB,KAAsC;AACtE,KAAI;EACF,MAAM,SAAS,KAAK,MAAM,IAAI;AAC9B,MAAI,UAAU,OAAO,WAAW,YAAY,CAAC,MAAM,QAAQ,OAAO,CAChE,QAAO;AAET,UAAQ,KACN,qDAAqD,OAAO,OAAO,iCACpE;AACD,SAAO,EAAE;SACH;AACN,UAAQ,KACN,4EACD;AACD,SAAO,EAAE"}
+{"version":3,"file":"index.cjs","names":["PartialJSON"],"sources":["../../src/utils/index.ts"],"sourcesContent":["export * from \"./clipboard\";\nexport * from \"./conditions\";\nexport * from \"./console-styling\";\nexport * from \"./errors\";\nexport * from \"./json-schema\";\nexport * from \"./inspector-metadata\";\nexport * from \"./types\";\nexport * from \"./random-id\";\nexport * from \"./requests\";\n\nimport * as PartialJSON from \"partial-json\";\n\n/**\n * Safely parses a JSON string into an object\n * @param json The JSON string to parse\n * @param fallback Optional fallback value to return if parsing fails. If not provided or set to \"unset\", returns null\n * @returns The parsed JSON object, or the fallback value (or null) if parsing fails\n */\nexport function parseJson(json: string, fallback: any = \"unset\") {\n  try {\n    return JSON.parse(json);\n  } catch {\n    return fallback === \"unset\" ? null : fallback;\n  }\n}\n\n/**\n * Parses a partial/incomplete JSON string, returning as much valid data as possible.\n * Falls back to an empty object if parsing fails entirely.\n */\nexport function partialJSONParse(json: string) {\n  try {\n    const parsed = PartialJSON.parse(json);\n    if (parsed && typeof parsed === \"object\" && !Array.isArray(parsed)) {\n      return parsed;\n    }\n    return {};\n  } catch {\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\n/**\n * Maps an array of items to a new array, skipping items that throw errors during mapping\n * @param items The array to map\n * @param callback The mapping function to apply to each item\n * @returns A new array containing only the successfully mapped items\n */\nexport function tryMap<TItem, TMapped>(\n  items: TItem[],\n  callback: (item: TItem, index: number, array: TItem[]) => TMapped,\n): TMapped[] {\n  return items.reduce<TMapped[]>((acc, item, index, array) => {\n    try {\n      acc.push(callback(item, index, array));\n    } catch (error) {\n      console.error(error);\n    }\n    return acc;\n  }, []);\n}\n\n/**\n * Checks if the current environment is macOS\n * @returns {boolean} True if running on macOS, false otherwise\n */\nexport function isMacOS(): boolean {\n  return /Mac|iMac|Macintosh/i.test(navigator.userAgent);\n}\n\n/**\n * Safely parses a JSON string into a tool arguments object.\n * Returns the parsed object only if it's a plain object (not an array, null, etc.).\n * Falls back to an empty object for any non-object JSON value or parse failure.\n */\nexport function safeParseToolArgs(raw: string): Record<string, unknown> {\n  try {\n    const parsed = JSON.parse(raw);\n    if (parsed && typeof parsed === \"object\" && !Array.isArray(parsed)) {\n      return parsed;\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"],"mappings":";;;;;;;;;;;;;;;;;;;;AAkBA,SAAgB,UAAU,MAAc,WAAgB,SAAS;AAC/D,KAAI;AACF,SAAO,KAAK,MAAM,KAAK;SACjB;AACN,SAAO,aAAa,UAAU,OAAO;;;;;;;AAQzC,SAAgB,iBAAiB,MAAc;AAC7C,KAAI;EACF,MAAM,SAASA,aAAY,MAAM,KAAK;AACtC,MAAI,UAAU,OAAO,WAAW,YAAY,CAAC,MAAM,QAAQ,OAAO,CAChE,QAAO;AAET,SAAO,EAAE;SACH;AACN,SAAO,EAAE;;;;;;;;;;;;;AAcb,SAAgB,0BACd,QACA,OAC2B;AAC3B,SAAQ,UAAkB,KAAK,IAAI,SAAS,MAAM,QAAQ,IAAI,MAAM;;;;;;;;AAStE,SAAgB,OACd,OACA,UACW;AACX,QAAO,MAAM,QAAmB,KAAK,MAAM,OAAO,UAAU;AAC1D,MAAI;AACF,OAAI,KAAK,SAAS,MAAM,OAAO,MAAM,CAAC;WAC/B,OAAO;AACd,WAAQ,MAAM,MAAM;;AAEtB,SAAO;IACN,EAAE,CAAC;;;;;;AAOR,SAAgB,UAAmB;AACjC,QAAO,sBAAsB,KAAK,UAAU,UAAU;;;;;;;AAQxD,SAAgB,kBAAkB,KAAsC;AACtE,KAAI;EACF,MAAM,SAAS,KAAK,MAAM,IAAI;AAC9B,MAAI,UAAU,OAAO,WAAW,YAAY,CAAC,MAAM,QAAQ,OAAO,CAChE,QAAO;AAET,UAAQ,KACN,qDAAqD,OAAO,OAAO,iCACpE;AACD,SAAO,EAAE;SACH;AACN,UAAQ,KACN,4EACD;AACD,SAAO,EAAE"}

package/dist/utils/index.d.cts

@@ -3,6 +3,7 @@ import { BaseCondition, ComparisonCondition, ComparisonRule, Condition, Existenc
 import { ConsoleColors, ConsoleStyles, logCopilotKitPlatformMessage, logStyled, publicApiKeyRequired, styledConsole } from "./console-styling.cjs";
 import { BANNER_ERROR_NAMES, COPILOT_CLOUD_ERROR_NAMES, ConfigurationError, CopilotKitAgentDiscoveryError, CopilotKitApiDiscoveryError, CopilotKitError, CopilotKitErrorCode, CopilotKitLowLevelError, CopilotKitMisuseError, CopilotKitRemoteEndpointDiscoveryError, CopilotKitVersionMismatchError, ERROR_CONFIG, ERROR_NAMES, ErrorVisibility, MissingPublicApiKeyError, ResolvedCopilotKitError, Severity, UpgradeRequiredError, ensureStructuredError, getPossibleVersionMismatch, isStructuredCopilotKitError } from "./errors.cjs";
 import { JSONSchema, JSONSchemaArray, JSONSchemaBoolean, JSONSchemaNumber, JSONSchemaObject, JSONSchemaString, actionParametersToJsonSchema, convertJsonSchemaToZodSchema, getZodParameters, jsonSchemaToActionParameters } from "./json-schema.cjs";
+import { InspectorMetadataV1, parseInspectorMetadataV1 } from "./inspector-metadata.cjs";
 import { A2UIRuntimeInfo, AgentDescription, IntelligenceRuntimeInfo, MaybePromise, NonEmptyRecord, RUNTIME_MODE_INTELLIGENCE, RUNTIME_MODE_SSE, RuntimeInfo, RuntimeLicenseStatus, RuntimeMode, ThreadEndpointRuntimeInfo } from "./types.cjs";
 import { dataToUUID, isValidUUID, randomId, randomUUID } from "./random-id.cjs";
 import { readBody } from "./requests.cjs";

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","names":[],"sources":["../../src/utils/index.ts"],"mappings":";;;;;;;;;;;;AAiBA;;;;iBAAgB,SAAA,CAAU,IAAA,UAAc,QAAA;AAYxC;;;;AAAA,iBAAgB,gBAAA,CAAiB,IAAA;AAsBjC;;;;;;;;;AAaA;AAbA,iBAAgB,yBAAA,CACd,MAAA,UACA,KAAA,YACE,KAAA;;;;;;;iBAUY,MAAA,gBAAA,CACd,KAAA,EAAO,KAAA,IACP,QAAA,GAAW,IAAA,EAAM,KAAA,EAAO,KAAA,UAAe,KAAA,EAAO,KAAA,OAAY,OAAA,GACzD,OAAA;;;;;iBAea,OAAA,CAAA;;;;;;iBASA,iBAAA,CAAkB,GAAA,WAAc,MAAA"}
+{"version":3,"file":"index.d.cts","names":[],"sources":["../../src/utils/index.ts"],"mappings":";;;;;;;;;;;;;AAkBA;;;;iBAAgB,SAAA,CAAU,IAAA,UAAc,QAAA;AAYxC;;;;AAAA,iBAAgB,gBAAA,CAAiB,IAAA;AAsBjC;;;;;;;;;AAaA;AAbA,iBAAgB,yBAAA,CACd,MAAA,UACA,KAAA,YACE,KAAA;;;;;;;iBAUY,MAAA,gBAAA,CACd,KAAA,EAAO,KAAA,IACP,QAAA,GAAW,IAAA,EAAM,KAAA,EAAO,KAAA,UAAe,KAAA,EAAO,KAAA,OAAY,OAAA,GACzD,OAAA;;;;;iBAea,OAAA,CAAA;;;;;;iBASA,iBAAA,CAAkB,GAAA,WAAc,MAAA"}

package/dist/utils/index.d.mts

@@ -3,6 +3,7 @@ import { BaseCondition, ComparisonCondition, ComparisonRule, Condition, Existenc
 import { ConsoleColors, ConsoleStyles, logCopilotKitPlatformMessage, logStyled, publicApiKeyRequired, styledConsole } from "./console-styling.mjs";
 import { BANNER_ERROR_NAMES, COPILOT_CLOUD_ERROR_NAMES, ConfigurationError, CopilotKitAgentDiscoveryError, CopilotKitApiDiscoveryError, CopilotKitError, CopilotKitErrorCode, CopilotKitLowLevelError, CopilotKitMisuseError, CopilotKitRemoteEndpointDiscoveryError, CopilotKitVersionMismatchError, ERROR_CONFIG, ERROR_NAMES, ErrorVisibility, MissingPublicApiKeyError, ResolvedCopilotKitError, Severity, UpgradeRequiredError, ensureStructuredError, getPossibleVersionMismatch, isStructuredCopilotKitError } from "./errors.mjs";
 import { JSONSchema, JSONSchemaArray, JSONSchemaBoolean, JSONSchemaNumber, JSONSchemaObject, JSONSchemaString, actionParametersToJsonSchema, convertJsonSchemaToZodSchema, getZodParameters, jsonSchemaToActionParameters } from "./json-schema.mjs";
+import { InspectorMetadataV1, parseInspectorMetadataV1 } from "./inspector-metadata.mjs";
 import { A2UIRuntimeInfo, AgentDescription, IntelligenceRuntimeInfo, MaybePromise, NonEmptyRecord, RUNTIME_MODE_INTELLIGENCE, RUNTIME_MODE_SSE, RuntimeInfo, RuntimeLicenseStatus, RuntimeMode, ThreadEndpointRuntimeInfo } from "./types.mjs";
 import { dataToUUID, isValidUUID, randomId, randomUUID } from "./random-id.mjs";
 import { readBody } from "./requests.mjs";

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/utils/index.ts"],"mappings":";;;;;;;;;;;;AAiBA;;;;iBAAgB,SAAA,CAAU,IAAA,UAAc,QAAA;AAYxC;;;;AAAA,iBAAgB,gBAAA,CAAiB,IAAA;AAsBjC;;;;;;;;;AAaA;AAbA,iBAAgB,yBAAA,CACd,MAAA,UACA,KAAA,YACE,KAAA;;;;;;;iBAUY,MAAA,gBAAA,CACd,KAAA,EAAO,KAAA,IACP,QAAA,GAAW,IAAA,EAAM,KAAA,EAAO,KAAA,UAAe,KAAA,EAAO,KAAA,OAAY,OAAA,GACzD,OAAA;;;;;iBAea,OAAA,CAAA;;;;;;iBASA,iBAAA,CAAkB,GAAA,WAAc,MAAA"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/utils/index.ts"],"mappings":";;;;;;;;;;;;;AAkBA;;;;iBAAgB,SAAA,CAAU,IAAA,UAAc,QAAA;AAYxC;;;;AAAA,iBAAgB,gBAAA,CAAiB,IAAA;AAsBjC;;;;;;;;;AAaA;AAbA,iBAAgB,yBAAA,CACd,MAAA,UACA,KAAA,YACE,KAAA;;;;;;;iBAUY,MAAA,gBAAA,CACd,KAAA,EAAO,KAAA,IACP,QAAA,GAAW,IAAA,EAAM,KAAA,EAAO,KAAA,UAAe,KAAA,EAAO,KAAA,OAAY,OAAA,GACzD,OAAA;;;;;iBAea,OAAA,CAAA;;;;;;iBASA,iBAAA,CAAkB,GAAA,WAAc,MAAA"}

package/dist/utils/index.mjs

@@ -3,6 +3,7 @@ import { executeConditions } from "./conditions.mjs";
 import { ConsoleColors, ConsoleStyles, logCopilotKitPlatformMessage, logStyled, publicApiKeyRequired, styledConsole } from "./console-styling.mjs";
 import { BANNER_ERROR_NAMES, COPILOT_CLOUD_ERROR_NAMES, ConfigurationError, CopilotKitAgentDiscoveryError, CopilotKitApiDiscoveryError, CopilotKitError, CopilotKitErrorCode, CopilotKitLowLevelError, CopilotKitMisuseError, CopilotKitRemoteEndpointDiscoveryError, CopilotKitVersionMismatchError, ERROR_CONFIG, ERROR_NAMES, ErrorVisibility, MissingPublicApiKeyError, ResolvedCopilotKitError, Severity, UpgradeRequiredError, ensureStructuredError, getPossibleVersionMismatch, isStructuredCopilotKitError } from "./errors.mjs";
 import { actionParametersToJsonSchema, convertJsonSchemaToZodSchema, getZodParameters, jsonSchemaToActionParameters } from "./json-schema.mjs";
+import { parseInspectorMetadataV1 } from "./inspector-metadata.mjs";
 import { RUNTIME_MODE_INTELLIGENCE, RUNTIME_MODE_SSE } from "./types.mjs";
 import { dataToUUID, isValidUUID, randomId, randomUUID } from "./random-id.mjs";
 import { readBody } from "./requests.mjs";
@@ -18,7 +19,7 @@ import * as PartialJSON from "partial-json";
 function parseJson(json, fallback = "unset") {
 	try {
 		return JSON.parse(json);
-	} catch (e) {
+	} catch {
 		return fallback === "unset" ? null : fallback;
 	}
 }
@@ -31,7 +32,7 @@ function partialJSONParse(json) {
 		const parsed = PartialJSON.parse(json);
 		if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) return parsed;
 		return {};
-	} catch (error) {
+	} catch {
 		return {};
 	}
 }

package/dist/utils/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../../src/utils/index.ts"],"sourcesContent":["export * from \"./clipboard\";\nexport * from \"./conditions\";\nexport * from \"./console-styling\";\nexport * from \"./errors\";\nexport * from \"./json-schema\";\nexport * from \"./types\";\nexport * from \"./random-id\";\nexport * from \"./requests\";\n\nimport * as PartialJSON from \"partial-json\";\n\n/**\n * Safely parses a JSON string into an object\n * @param json The JSON string to parse\n * @param fallback Optional fallback value to return if parsing fails. If not provided or set to \"unset\", returns null\n * @returns The parsed JSON object, or the fallback value (or null) if parsing fails\n */\nexport function parseJson(json: string, fallback: any = \"unset\") {\n  try {\n    return JSON.parse(json);\n  } catch (e) {\n    return fallback === \"unset\" ? null : fallback;\n  }\n}\n\n/**\n * Parses a partial/incomplete JSON string, returning as much valid data as possible.\n * Falls back to an empty object if parsing fails entirely.\n */\nexport function partialJSONParse(json: string) {\n  try {\n    const parsed = PartialJSON.parse(json);\n    if (parsed && typeof parsed === \"object\" && !Array.isArray(parsed)) {\n      return parsed;\n    }\n    return {};\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\n/**\n * Maps an array of items to a new array, skipping items that throw errors during mapping\n * @param items The array to map\n * @param callback The mapping function to apply to each item\n * @returns A new array containing only the successfully mapped items\n */\nexport function tryMap<TItem, TMapped>(\n  items: TItem[],\n  callback: (item: TItem, index: number, array: TItem[]) => TMapped,\n): TMapped[] {\n  return items.reduce<TMapped[]>((acc, item, index, array) => {\n    try {\n      acc.push(callback(item, index, array));\n    } catch (error) {\n      console.error(error);\n    }\n    return acc;\n  }, []);\n}\n\n/**\n * Checks if the current environment is macOS\n * @returns {boolean} True if running on macOS, false otherwise\n */\nexport function isMacOS(): boolean {\n  return /Mac|iMac|Macintosh/i.test(navigator.userAgent);\n}\n\n/**\n * Safely parses a JSON string into a tool arguments object.\n * Returns the parsed object only if it's a plain object (not an array, null, etc.).\n * Falls back to an empty object for any non-object JSON value or parse failure.\n */\nexport function safeParseToolArgs(raw: string): Record<string, unknown> {\n  try {\n    const parsed = JSON.parse(raw);\n    if (parsed && typeof parsed === \"object\" && !Array.isArray(parsed)) {\n      return parsed;\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"],"mappings":";;;;;;;;;;;;;;;;;AAiBA,SAAgB,UAAU,MAAc,WAAgB,SAAS;AAC/D,KAAI;AACF,SAAO,KAAK,MAAM,KAAK;UAChB,GAAG;AACV,SAAO,aAAa,UAAU,OAAO;;;;;;;AAQzC,SAAgB,iBAAiB,MAAc;AAC7C,KAAI;EACF,MAAM,SAAS,YAAY,MAAM,KAAK;AACtC,MAAI,UAAU,OAAO,WAAW,YAAY,CAAC,MAAM,QAAQ,OAAO,CAChE,QAAO;AAET,SAAO,EAAE;UACF,OAAO;AACd,SAAO,EAAE;;;;;;;;;;;;;AAcb,SAAgB,0BACd,QACA,OAC2B;AAC3B,SAAQ,UAAkB,KAAK,IAAI,SAAS,MAAM,QAAQ,IAAI,MAAM;;;;;;;;AAStE,SAAgB,OACd,OACA,UACW;AACX,QAAO,MAAM,QAAmB,KAAK,MAAM,OAAO,UAAU;AAC1D,MAAI;AACF,OAAI,KAAK,SAAS,MAAM,OAAO,MAAM,CAAC;WAC/B,OAAO;AACd,WAAQ,MAAM,MAAM;;AAEtB,SAAO;IACN,EAAE,CAAC;;;;;;AAOR,SAAgB,UAAmB;AACjC,QAAO,sBAAsB,KAAK,UAAU,UAAU;;;;;;;AAQxD,SAAgB,kBAAkB,KAAsC;AACtE,KAAI;EACF,MAAM,SAAS,KAAK,MAAM,IAAI;AAC9B,MAAI,UAAU,OAAO,WAAW,YAAY,CAAC,MAAM,QAAQ,OAAO,CAChE,QAAO;AAET,UAAQ,KACN,qDAAqD,OAAO,OAAO,iCACpE;AACD,SAAO,EAAE;SACH;AACN,UAAQ,KACN,4EACD;AACD,SAAO,EAAE"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../../src/utils/index.ts"],"sourcesContent":["export * from \"./clipboard\";\nexport * from \"./conditions\";\nexport * from \"./console-styling\";\nexport * from \"./errors\";\nexport * from \"./json-schema\";\nexport * from \"./inspector-metadata\";\nexport * from \"./types\";\nexport * from \"./random-id\";\nexport * from \"./requests\";\n\nimport * as PartialJSON from \"partial-json\";\n\n/**\n * Safely parses a JSON string into an object\n * @param json The JSON string to parse\n * @param fallback Optional fallback value to return if parsing fails. If not provided or set to \"unset\", returns null\n * @returns The parsed JSON object, or the fallback value (or null) if parsing fails\n */\nexport function parseJson(json: string, fallback: any = \"unset\") {\n  try {\n    return JSON.parse(json);\n  } catch {\n    return fallback === \"unset\" ? null : fallback;\n  }\n}\n\n/**\n * Parses a partial/incomplete JSON string, returning as much valid data as possible.\n * Falls back to an empty object if parsing fails entirely.\n */\nexport function partialJSONParse(json: string) {\n  try {\n    const parsed = PartialJSON.parse(json);\n    if (parsed && typeof parsed === \"object\" && !Array.isArray(parsed)) {\n      return parsed;\n    }\n    return {};\n  } catch {\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\n/**\n * Maps an array of items to a new array, skipping items that throw errors during mapping\n * @param items The array to map\n * @param callback The mapping function to apply to each item\n * @returns A new array containing only the successfully mapped items\n */\nexport function tryMap<TItem, TMapped>(\n  items: TItem[],\n  callback: (item: TItem, index: number, array: TItem[]) => TMapped,\n): TMapped[] {\n  return items.reduce<TMapped[]>((acc, item, index, array) => {\n    try {\n      acc.push(callback(item, index, array));\n    } catch (error) {\n      console.error(error);\n    }\n    return acc;\n  }, []);\n}\n\n/**\n * Checks if the current environment is macOS\n * @returns {boolean} True if running on macOS, false otherwise\n */\nexport function isMacOS(): boolean {\n  return /Mac|iMac|Macintosh/i.test(navigator.userAgent);\n}\n\n/**\n * Safely parses a JSON string into a tool arguments object.\n * Returns the parsed object only if it's a plain object (not an array, null, etc.).\n * Falls back to an empty object for any non-object JSON value or parse failure.\n */\nexport function safeParseToolArgs(raw: string): Record<string, unknown> {\n  try {\n    const parsed = JSON.parse(raw);\n    if (parsed && typeof parsed === \"object\" && !Array.isArray(parsed)) {\n      return parsed;\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"],"mappings":";;;;;;;;;;;;;;;;;;AAkBA,SAAgB,UAAU,MAAc,WAAgB,SAAS;AAC/D,KAAI;AACF,SAAO,KAAK,MAAM,KAAK;SACjB;AACN,SAAO,aAAa,UAAU,OAAO;;;;;;;AAQzC,SAAgB,iBAAiB,MAAc;AAC7C,KAAI;EACF,MAAM,SAAS,YAAY,MAAM,KAAK;AACtC,MAAI,UAAU,OAAO,WAAW,YAAY,CAAC,MAAM,QAAQ,OAAO,CAChE,QAAO;AAET,SAAO,EAAE;SACH;AACN,SAAO,EAAE;;;;;;;;;;;;;AAcb,SAAgB,0BACd,QACA,OAC2B;AAC3B,SAAQ,UAAkB,KAAK,IAAI,SAAS,MAAM,QAAQ,IAAI,MAAM;;;;;;;;AAStE,SAAgB,OACd,OACA,UACW;AACX,QAAO,MAAM,QAAmB,KAAK,MAAM,OAAO,UAAU;AAC1D,MAAI;AACF,OAAI,KAAK,SAAS,MAAM,OAAO,MAAM,CAAC;WAC/B,OAAO;AACd,WAAQ,MAAM,MAAM;;AAEtB,SAAO;IACN,EAAE,CAAC;;;;;;AAOR,SAAgB,UAAmB;AACjC,QAAO,sBAAsB,KAAK,UAAU,UAAU;;;;;;;AAQxD,SAAgB,kBAAkB,KAAsC;AACtE,KAAI;EACF,MAAM,SAAS,KAAK,MAAM,IAAI;AAC9B,MAAI,UAAU,OAAO,WAAW,YAAY,CAAC,MAAM,QAAQ,OAAO,CAChE,QAAO;AAET,UAAQ,KACN,qDAAqD,OAAO,OAAO,iCACpE;AACD,SAAO,EAAE;SACH;AACN,UAAQ,KACN,4EACD;AACD,SAAO,EAAE"}

package/dist/utils/inspector-metadata.cjs

@@ -0,0 +1,147 @@
+
+//#region src/utils/inspector-metadata.ts
+function isRecord(value) {
+	if (typeof value !== "object" || value === null || Array.isArray(value)) return false;
+	try {
+		const prototype = Object.getPrototypeOf(value);
+		return prototype === Object.prototype || prototype === null;
+	} catch {
+		return false;
+	}
+}
+function readOwnDataProperty(value, key) {
+	try {
+		const descriptor = Object.getOwnPropertyDescriptor(value, key);
+		return descriptor !== void 0 && "value" in descriptor ? descriptor.value : void 0;
+	} catch {
+		return;
+	}
+}
+function parseNonBlankString(value) {
+	if (typeof value !== "string") return;
+	const parsed = value.trim();
+	return parsed.length > 0 ? parsed : void 0;
+}
+function parseIdentity(value) {
+	if (!isRecord(value)) return;
+	const organizationName = parseNonBlankString(value.organizationName);
+	const projectName = parseNonBlankString(value.projectName);
+	if (organizationName === void 0 || projectName === void 0) return;
+	return {
+		organizationName,
+		projectName
+	};
+}
+function parsePlan(value) {
+	if (!isRecord(value)) return;
+	const code = parseNonBlankString(value.code);
+	const label = parseNonBlankString(value.label);
+	if (code === void 0 || label === void 0) return;
+	return {
+		code,
+		label
+	};
+}
+function parseLicense(value) {
+	if (!isRecord(value)) return;
+	switch (value.state) {
+		case "valid":
+		case "none":
+		case "expired":
+		case "unknown": return { state: value.state };
+		default: return;
+	}
+}
+function parseActionKind(value) {
+	switch (value) {
+		case "manage_plan":
+		case "renew":
+		case "enable_intelligence": return value;
+		default: return;
+	}
+}
+function parseSafeActionUrl(value) {
+	const url = parseNonBlankString(value);
+	if (url === void 0 || url.includes("?") || url.includes("#")) return;
+	const authorityStart = url.indexOf("://");
+	if (authorityStart < 1) return;
+	const authorityAndPath = url.slice(authorityStart + 3);
+	const pathStart = authorityAndPath.indexOf("/");
+	if ((pathStart === -1 ? authorityAndPath : authorityAndPath.slice(0, pathStart)).includes("@")) return;
+	let parsed;
+	try {
+		parsed = new URL(url);
+	} catch {
+		return;
+	}
+	if (parsed.hostname.length === 0 || parsed.username || parsed.password) return;
+	if (parsed.protocol === "https:") return url;
+	const isLoopbackHost = parsed.hostname === "localhost" || parsed.hostname === "127.0.0.1" || parsed.hostname === "[::1]";
+	if (parsed.protocol === "http:" && isLoopbackHost) return url;
+}
+function parseAction(value) {
+	if (!isRecord(value)) return;
+	const kind = parseActionKind(value.kind);
+	const url = parseSafeActionUrl(value.url);
+	if (kind === void 0 || url === void 0) return;
+	return {
+		kind,
+		url
+	};
+}
+function isFiniteNonnegativeInteger(value) {
+	return typeof value === "number" && Number.isSafeInteger(value) && value >= 0;
+}
+function parseUsageLimit(value) {
+	if (!isRecord(value)) return;
+	if (value.kind === "finite") {
+		if (typeof value.value !== "number" || !Number.isSafeInteger(value.value) || value.value < 1) return;
+		return {
+			kind: "finite",
+			value: value.value
+		};
+	}
+	if (value.kind === "unlimited") return { kind: "unlimited" };
+	if (value.kind === "unknown") return { kind: "unknown" };
+}
+function parseUsage(value) {
+	if (!isRecord(value)) return;
+	const limit = parseUsageLimit(value.limit);
+	const used = value.used;
+	if (!isFiniteNonnegativeInteger(used) || limit === void 0) return;
+	const rawExpiringSoonCount = readOwnDataProperty(value, "expiringSoonCount");
+	const expiringSoonCount = isFiniteNonnegativeInteger(rawExpiringSoonCount) ? rawExpiringSoonCount : void 0;
+	return {
+		used,
+		limit,
+		...expiringSoonCount === void 0 ? {} : { expiringSoonCount }
+	};
+}
+/**
+* Parses untrusted inspector metadata without letting one invalid optional
+* module hide the other valid modules.
+*
+* @param value - The decoded runtime response body.
+* @returns Normalized version 1 metadata, or `undefined` for an unsupported
+* top-level payload.
+*/
+function parseInspectorMetadataV1(value) {
+	if (!isRecord(value) || value.schemaVersion !== 1) return;
+	const identity = parseIdentity(value.identity);
+	const plan = parsePlan(value.plan);
+	const license = parseLicense(value.license);
+	const action = parseAction(value.action);
+	const usage = parseUsage(value.usage);
+	return {
+		schemaVersion: 1,
+		...identity === void 0 ? {} : { identity },
+		...plan === void 0 ? {} : { plan },
+		...license === void 0 ? {} : { license },
+		...action === void 0 ? {} : { action },
+		...usage === void 0 ? {} : { usage }
+	};
+}
+
+//#endregion
+exports.parseInspectorMetadataV1 = parseInspectorMetadataV1;
+//# sourceMappingURL=inspector-metadata.cjs.map

package/dist/utils/inspector-metadata.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspector-metadata.cjs","names":[],"sources":["../../src/utils/inspector-metadata.ts"],"sourcesContent":["/**\n * Inspector metadata supplied by a trusted CopilotKit runtime.\n *\n * Each optional module is independent so clients can render partial metadata\n * from runtimes that do not expose every module.\n */\nexport interface InspectorMetadataV1 {\n  readonly schemaVersion: 1;\n  readonly identity?: {\n    readonly organizationName: string;\n    readonly projectName: string;\n  };\n  readonly plan?: {\n    readonly code: string;\n    readonly label: string;\n  };\n  readonly license?: {\n    readonly state: \"valid\" | \"none\" | \"expired\" | \"unknown\";\n  };\n  readonly action?:\n    | { readonly kind: \"manage_plan\"; readonly url: string }\n    | { readonly kind: \"renew\"; readonly url: string }\n    | { readonly kind: \"enable_intelligence\"; readonly url: string };\n  readonly usage?: {\n    readonly used: number;\n    readonly limit:\n      | { readonly kind: \"finite\"; readonly value: number }\n      | { readonly kind: \"unlimited\" }\n      | { readonly kind: \"unknown\" };\n    readonly expiringSoonCount?: number;\n  };\n}\n\ntype UnknownRecord = Record<string, unknown>;\ntype InspectorIdentity = NonNullable<InspectorMetadataV1[\"identity\"]>;\ntype InspectorPlan = NonNullable<InspectorMetadataV1[\"plan\"]>;\ntype InspectorLicense = NonNullable<InspectorMetadataV1[\"license\"]>;\ntype InspectorAction = NonNullable<InspectorMetadataV1[\"action\"]>;\ntype InspectorUsage = NonNullable<InspectorMetadataV1[\"usage\"]>;\ntype InspectorUsageLimit = InspectorUsage[\"limit\"];\n\nfunction isRecord(value: unknown): value is UnknownRecord {\n  if (typeof value !== \"object\" || value === null || Array.isArray(value)) {\n    return false;\n  }\n\n  try {\n    const prototype = Object.getPrototypeOf(value);\n    return prototype === Object.prototype || prototype === null;\n  } catch {\n    return false;\n  }\n}\n\nfunction readOwnDataProperty(value: UnknownRecord, key: string): unknown {\n  try {\n    const descriptor = Object.getOwnPropertyDescriptor(value, key);\n    return descriptor !== undefined && \"value\" in descriptor\n      ? descriptor.value\n      : undefined;\n  } catch {\n    return undefined;\n  }\n}\n\nfunction parseNonBlankString(value: unknown): string | undefined {\n  if (typeof value !== \"string\") {\n    return undefined;\n  }\n\n  const parsed = value.trim();\n  return parsed.length > 0 ? parsed : undefined;\n}\n\nfunction parseIdentity(value: unknown): InspectorIdentity | undefined {\n  if (!isRecord(value)) {\n    return undefined;\n  }\n\n  const organizationName = parseNonBlankString(value.organizationName);\n  const projectName = parseNonBlankString(value.projectName);\n  if (organizationName === undefined || projectName === undefined) {\n    return undefined;\n  }\n\n  return { organizationName, projectName };\n}\n\nfunction parsePlan(value: unknown): InspectorPlan | undefined {\n  if (!isRecord(value)) {\n    return undefined;\n  }\n\n  const code = parseNonBlankString(value.code);\n  const label = parseNonBlankString(value.label);\n  if (code === undefined || label === undefined) {\n    return undefined;\n  }\n\n  return { code, label };\n}\n\nfunction parseLicense(value: unknown): InspectorLicense | undefined {\n  if (!isRecord(value)) {\n    return undefined;\n  }\n\n  switch (value.state) {\n    case \"valid\":\n    case \"none\":\n    case \"expired\":\n    case \"unknown\":\n      return { state: value.state };\n    default:\n      return undefined;\n  }\n}\n\nfunction parseActionKind(value: unknown): InspectorAction[\"kind\"] | undefined {\n  switch (value) {\n    case \"manage_plan\":\n    case \"renew\":\n    case \"enable_intelligence\":\n      return value;\n    default:\n      return undefined;\n  }\n}\n\nfunction parseSafeActionUrl(value: unknown): string | undefined {\n  const url = parseNonBlankString(value);\n  if (url === undefined || url.includes(\"?\") || url.includes(\"#\")) {\n    return undefined;\n  }\n\n  const authorityStart = url.indexOf(\"://\");\n  if (authorityStart < 1) {\n    return undefined;\n  }\n\n  const authorityAndPath = url.slice(authorityStart + 3);\n  const pathStart = authorityAndPath.indexOf(\"/\");\n  const authority =\n    pathStart === -1 ? authorityAndPath : authorityAndPath.slice(0, pathStart);\n  if (authority.includes(\"@\")) {\n    return undefined;\n  }\n\n  let parsed: URL;\n  try {\n    parsed = new URL(url);\n  } catch {\n    return undefined;\n  }\n\n  if (parsed.hostname.length === 0 || parsed.username || parsed.password) {\n    return undefined;\n  }\n\n  if (parsed.protocol === \"https:\") {\n    return url;\n  }\n\n  const isLoopbackHost =\n    parsed.hostname === \"localhost\" ||\n    parsed.hostname === \"127.0.0.1\" ||\n    parsed.hostname === \"[::1]\";\n  if (parsed.protocol === \"http:\" && isLoopbackHost) {\n    return url;\n  }\n\n  return undefined;\n}\n\nfunction parseAction(value: unknown): InspectorAction | undefined {\n  if (!isRecord(value)) {\n    return undefined;\n  }\n\n  const kind = parseActionKind(value.kind);\n  const url = parseSafeActionUrl(value.url);\n  if (kind === undefined || url === undefined) {\n    return undefined;\n  }\n\n  return { kind, url };\n}\n\nfunction isFiniteNonnegativeInteger(value: unknown): value is number {\n  return typeof value === \"number\" && Number.isSafeInteger(value) && value >= 0;\n}\n\nfunction parseUsageLimit(value: unknown): InspectorUsageLimit | undefined {\n  if (!isRecord(value)) {\n    return undefined;\n  }\n\n  if (value.kind === \"finite\") {\n    if (\n      typeof value.value !== \"number\" ||\n      !Number.isSafeInteger(value.value) ||\n      value.value < 1\n    ) {\n      return undefined;\n    }\n\n    return { kind: \"finite\", value: value.value };\n  }\n\n  if (value.kind === \"unlimited\") {\n    return { kind: \"unlimited\" };\n  }\n\n  if (value.kind === \"unknown\") {\n    return { kind: \"unknown\" };\n  }\n\n  return undefined;\n}\n\nfunction parseUsage(value: unknown): InspectorUsage | undefined {\n  if (!isRecord(value)) {\n    return undefined;\n  }\n\n  const limit = parseUsageLimit(value.limit);\n  const used = value.used;\n  if (!isFiniteNonnegativeInteger(used) || limit === undefined) {\n    return undefined;\n  }\n\n  const rawExpiringSoonCount = readOwnDataProperty(value, \"expiringSoonCount\");\n  const expiringSoonCount = isFiniteNonnegativeInteger(rawExpiringSoonCount)\n    ? rawExpiringSoonCount\n    : undefined;\n\n  return {\n    used,\n    limit,\n    ...(expiringSoonCount === undefined ? {} : { expiringSoonCount }),\n  };\n}\n\n/**\n * Parses untrusted inspector metadata without letting one invalid optional\n * module hide the other valid modules.\n *\n * @param value - The decoded runtime response body.\n * @returns Normalized version 1 metadata, or `undefined` for an unsupported\n * top-level payload.\n */\nexport function parseInspectorMetadataV1(\n  value: unknown,\n): InspectorMetadataV1 | undefined {\n  if (!isRecord(value) || value.schemaVersion !== 1) {\n    return undefined;\n  }\n\n  const identity = parseIdentity(value.identity);\n  const plan = parsePlan(value.plan);\n  const license = parseLicense(value.license);\n  const action = parseAction(value.action);\n  const usage = parseUsage(value.usage);\n\n  return {\n    schemaVersion: 1,\n    ...(identity === undefined ? {} : { identity }),\n    ...(plan === undefined ? {} : { plan }),\n    ...(license === undefined ? {} : { license }),\n    ...(action === undefined ? {} : { action }),\n    ...(usage === undefined ? {} : { usage }),\n  };\n}\n"],"mappings":"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"}

package/dist/utils/inspector-metadata.d.cts

@@ -0,0 +1,55 @@
+//#region src/utils/inspector-metadata.d.ts
+/**
+ * Inspector metadata supplied by a trusted CopilotKit runtime.
+ *
+ * Each optional module is independent so clients can render partial metadata
+ * from runtimes that do not expose every module.
+ */
+interface InspectorMetadataV1 {
+  readonly schemaVersion: 1;
+  readonly identity?: {
+    readonly organizationName: string;
+    readonly projectName: string;
+  };
+  readonly plan?: {
+    readonly code: string;
+    readonly label: string;
+  };
+  readonly license?: {
+    readonly state: "valid" | "none" | "expired" | "unknown";
+  };
+  readonly action?: {
+    readonly kind: "manage_plan";
+    readonly url: string;
+  } | {
+    readonly kind: "renew";
+    readonly url: string;
+  } | {
+    readonly kind: "enable_intelligence";
+    readonly url: string;
+  };
+  readonly usage?: {
+    readonly used: number;
+    readonly limit: {
+      readonly kind: "finite";
+      readonly value: number;
+    } | {
+      readonly kind: "unlimited";
+    } | {
+      readonly kind: "unknown";
+    };
+    readonly expiringSoonCount?: number;
+  };
+}
+/**
+ * Parses untrusted inspector metadata without letting one invalid optional
+ * module hide the other valid modules.
+ *
+ * @param value - The decoded runtime response body.
+ * @returns Normalized version 1 metadata, or `undefined` for an unsupported
+ * top-level payload.
+ */
+declare function parseInspectorMetadataV1(value: unknown): InspectorMetadataV1 | undefined;
+//#endregion
+export { InspectorMetadataV1, parseInspectorMetadataV1 };
+//# sourceMappingURL=inspector-metadata.d.cts.map

package/dist/utils/inspector-metadata.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspector-metadata.d.cts","names":[],"sources":["../../src/utils/inspector-metadata.ts"],"mappings":";;AAMA;;;;;UAAiB,mBAAA;EAAA,SACN,aAAA;EAAA,SACA,QAAA;IAAA,SACE,gBAAA;IAAA,SACA,WAAA;EAAA;EAAA,SAEF,IAAA;IAAA,SACE,IAAA;IAAA,SACA,KAAA;EAAA;EAAA,SAEF,OAAA;IAAA,SACE,KAAA;EAAA;EAAA,SAEF,MAAA;IAAA,SACM,IAAA;IAAA,SAA8B,GAAA;EAAA;IAAA,SAC9B,IAAA;IAAA,SAAwB,GAAA;EAAA;IAAA,SACxB,IAAA;IAAA,SAAsC,GAAA;EAAA;EAAA,SAC5C,KAAA;IAAA,SACE,IAAA;IAAA,SACA,KAAA;MAAA,SACM,IAAA;MAAA,SAAyB,KAAA;IAAA;MAAA,SACzB,IAAA;IAAA;MAAA,SACA,IAAA;IAAA;IAAA,SACN,iBAAA;EAAA;AAAA;;;;;;;;;iBA8NG,wBAAA,CACd,KAAA,YACC,mBAAA"}

package/dist/utils/inspector-metadata.d.mts

@@ -0,0 +1,55 @@
+//#region src/utils/inspector-metadata.d.ts
+/**
+ * Inspector metadata supplied by a trusted CopilotKit runtime.
+ *
+ * Each optional module is independent so clients can render partial metadata
+ * from runtimes that do not expose every module.
+ */
+interface InspectorMetadataV1 {
+  readonly schemaVersion: 1;
+  readonly identity?: {
+    readonly organizationName: string;
+    readonly projectName: string;
+  };
+  readonly plan?: {
+    readonly code: string;
+    readonly label: string;
+  };
+  readonly license?: {
+    readonly state: "valid" | "none" | "expired" | "unknown";
+  };
+  readonly action?: {
+    readonly kind: "manage_plan";
+    readonly url: string;
+  } | {
+    readonly kind: "renew";
+    readonly url: string;
+  } | {
+    readonly kind: "enable_intelligence";
+    readonly url: string;
+  };
+  readonly usage?: {
+    readonly used: number;
+    readonly limit: {
+      readonly kind: "finite";
+      readonly value: number;
+    } | {
+      readonly kind: "unlimited";
+    } | {
+      readonly kind: "unknown";
+    };
+    readonly expiringSoonCount?: number;
+  };
+}
+/**
+ * Parses untrusted inspector metadata without letting one invalid optional
+ * module hide the other valid modules.
+ *
+ * @param value - The decoded runtime response body.
+ * @returns Normalized version 1 metadata, or `undefined` for an unsupported
+ * top-level payload.
+ */
+declare function parseInspectorMetadataV1(value: unknown): InspectorMetadataV1 | undefined;
+//#endregion
+export { InspectorMetadataV1, parseInspectorMetadataV1 };
+//# sourceMappingURL=inspector-metadata.d.mts.map

package/dist/utils/inspector-metadata.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspector-metadata.d.mts","names":[],"sources":["../../src/utils/inspector-metadata.ts"],"mappings":";;AAMA;;;;;UAAiB,mBAAA;EAAA,SACN,aAAA;EAAA,SACA,QAAA;IAAA,SACE,gBAAA;IAAA,SACA,WAAA;EAAA;EAAA,SAEF,IAAA;IAAA,SACE,IAAA;IAAA,SACA,KAAA;EAAA;EAAA,SAEF,OAAA;IAAA,SACE,KAAA;EAAA;EAAA,SAEF,MAAA;IAAA,SACM,IAAA;IAAA,SAA8B,GAAA;EAAA;IAAA,SAC9B,IAAA;IAAA,SAAwB,GAAA;EAAA;IAAA,SACxB,IAAA;IAAA,SAAsC,GAAA;EAAA;EAAA,SAC5C,KAAA;IAAA,SACE,IAAA;IAAA,SACA,KAAA;MAAA,SACM,IAAA;MAAA,SAAyB,KAAA;IAAA;MAAA,SACzB,IAAA;IAAA;MAAA,SACA,IAAA;IAAA;IAAA,SACN,iBAAA;EAAA;AAAA;;;;;;;;;iBA8NG,wBAAA,CACd,KAAA,YACC,mBAAA"}

package/dist/utils/inspector-metadata.mjs

@@ -0,0 +1,146 @@
+//#region src/utils/inspector-metadata.ts
+function isRecord(value) {
+	if (typeof value !== "object" || value === null || Array.isArray(value)) return false;
+	try {
+		const prototype = Object.getPrototypeOf(value);
+		return prototype === Object.prototype || prototype === null;
+	} catch {
+		return false;
+	}
+}
+function readOwnDataProperty(value, key) {
+	try {
+		const descriptor = Object.getOwnPropertyDescriptor(value, key);
+		return descriptor !== void 0 && "value" in descriptor ? descriptor.value : void 0;
+	} catch {
+		return;
+	}
+}
+function parseNonBlankString(value) {
+	if (typeof value !== "string") return;
+	const parsed = value.trim();
+	return parsed.length > 0 ? parsed : void 0;
+}
+function parseIdentity(value) {
+	if (!isRecord(value)) return;
+	const organizationName = parseNonBlankString(value.organizationName);
+	const projectName = parseNonBlankString(value.projectName);
+	if (organizationName === void 0 || projectName === void 0) return;
+	return {
+		organizationName,
+		projectName
+	};
+}
+function parsePlan(value) {
+	if (!isRecord(value)) return;
+	const code = parseNonBlankString(value.code);
+	const label = parseNonBlankString(value.label);
+	if (code === void 0 || label === void 0) return;
+	return {
+		code,
+		label
+	};
+}
+function parseLicense(value) {
+	if (!isRecord(value)) return;
+	switch (value.state) {
+		case "valid":
+		case "none":
+		case "expired":
+		case "unknown": return { state: value.state };
+		default: return;
+	}
+}
+function parseActionKind(value) {
+	switch (value) {
+		case "manage_plan":
+		case "renew":
+		case "enable_intelligence": return value;
+		default: return;
+	}
+}
+function parseSafeActionUrl(value) {
+	const url = parseNonBlankString(value);
+	if (url === void 0 || url.includes("?") || url.includes("#")) return;
+	const authorityStart = url.indexOf("://");
+	if (authorityStart < 1) return;
+	const authorityAndPath = url.slice(authorityStart + 3);
+	const pathStart = authorityAndPath.indexOf("/");
+	if ((pathStart === -1 ? authorityAndPath : authorityAndPath.slice(0, pathStart)).includes("@")) return;
+	let parsed;
+	try {
+		parsed = new URL(url);
+	} catch {
+		return;
+	}
+	if (parsed.hostname.length === 0 || parsed.username || parsed.password) return;
+	if (parsed.protocol === "https:") return url;
+	const isLoopbackHost = parsed.hostname === "localhost" || parsed.hostname === "127.0.0.1" || parsed.hostname === "[::1]";
+	if (parsed.protocol === "http:" && isLoopbackHost) return url;
+}
+function parseAction(value) {
+	if (!isRecord(value)) return;
+	const kind = parseActionKind(value.kind);
+	const url = parseSafeActionUrl(value.url);
+	if (kind === void 0 || url === void 0) return;
+	return {
+		kind,
+		url
+	};
+}
+function isFiniteNonnegativeInteger(value) {
+	return typeof value === "number" && Number.isSafeInteger(value) && value >= 0;
+}
+function parseUsageLimit(value) {
+	if (!isRecord(value)) return;
+	if (value.kind === "finite") {
+		if (typeof value.value !== "number" || !Number.isSafeInteger(value.value) || value.value < 1) return;
+		return {
+			kind: "finite",
+			value: value.value
+		};
+	}
+	if (value.kind === "unlimited") return { kind: "unlimited" };
+	if (value.kind === "unknown") return { kind: "unknown" };
+}
+function parseUsage(value) {
+	if (!isRecord(value)) return;
+	const limit = parseUsageLimit(value.limit);
+	const used = value.used;
+	if (!isFiniteNonnegativeInteger(used) || limit === void 0) return;
+	const rawExpiringSoonCount = readOwnDataProperty(value, "expiringSoonCount");
+	const expiringSoonCount = isFiniteNonnegativeInteger(rawExpiringSoonCount) ? rawExpiringSoonCount : void 0;
+	return {
+		used,
+		limit,
+		...expiringSoonCount === void 0 ? {} : { expiringSoonCount }
+	};
+}
+/**
+* Parses untrusted inspector metadata without letting one invalid optional
+* module hide the other valid modules.
+*
+* @param value - The decoded runtime response body.
+* @returns Normalized version 1 metadata, or `undefined` for an unsupported
+* top-level payload.
+*/
+function parseInspectorMetadataV1(value) {
+	if (!isRecord(value) || value.schemaVersion !== 1) return;
+	const identity = parseIdentity(value.identity);
+	const plan = parsePlan(value.plan);
+	const license = parseLicense(value.license);
+	const action = parseAction(value.action);
+	const usage = parseUsage(value.usage);
+	return {
+		schemaVersion: 1,
+		...identity === void 0 ? {} : { identity },
+		...plan === void 0 ? {} : { plan },
+		...license === void 0 ? {} : { license },
+		...action === void 0 ? {} : { action },
+		...usage === void 0 ? {} : { usage }
+	};
+}
+
+//#endregion
+export { parseInspectorMetadataV1 };
+//# sourceMappingURL=inspector-metadata.mjs.map

package/dist/utils/inspector-metadata.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspector-metadata.mjs","names":[],"sources":["../../src/utils/inspector-metadata.ts"],"sourcesContent":["/**\n * Inspector metadata supplied by a trusted CopilotKit runtime.\n *\n * Each optional module is independent so clients can render partial metadata\n * from runtimes that do not expose every module.\n */\nexport interface InspectorMetadataV1 {\n  readonly schemaVersion: 1;\n  readonly identity?: {\n    readonly organizationName: string;\n    readonly projectName: string;\n  };\n  readonly plan?: {\n    readonly code: string;\n    readonly label: string;\n  };\n  readonly license?: {\n    readonly state: \"valid\" | \"none\" | \"expired\" | \"unknown\";\n  };\n  readonly action?:\n    | { readonly kind: \"manage_plan\"; readonly url: string }\n    | { readonly kind: \"renew\"; readonly url: string }\n    | { readonly kind: \"enable_intelligence\"; readonly url: string };\n  readonly usage?: {\n    readonly used: number;\n    readonly limit:\n      | { readonly kind: \"finite\"; readonly value: number }\n      | { readonly kind: \"unlimited\" }\n      | { readonly kind: \"unknown\" };\n    readonly expiringSoonCount?: number;\n  };\n}\n\ntype UnknownRecord = Record<string, unknown>;\ntype InspectorIdentity = NonNullable<InspectorMetadataV1[\"identity\"]>;\ntype InspectorPlan = NonNullable<InspectorMetadataV1[\"plan\"]>;\ntype InspectorLicense = NonNullable<InspectorMetadataV1[\"license\"]>;\ntype InspectorAction = NonNullable<InspectorMetadataV1[\"action\"]>;\ntype InspectorUsage = NonNullable<InspectorMetadataV1[\"usage\"]>;\ntype InspectorUsageLimit = InspectorUsage[\"limit\"];\n\nfunction isRecord(value: unknown): value is UnknownRecord {\n  if (typeof value !== \"object\" || value === null || Array.isArray(value)) {\n    return false;\n  }\n\n  try {\n    const prototype = Object.getPrototypeOf(value);\n    return prototype === Object.prototype || prototype === null;\n  } catch {\n    return false;\n  }\n}\n\nfunction readOwnDataProperty(value: UnknownRecord, key: string): unknown {\n  try {\n    const descriptor = Object.getOwnPropertyDescriptor(value, key);\n    return descriptor !== undefined && \"value\" in descriptor\n      ? descriptor.value\n      : undefined;\n  } catch {\n    return undefined;\n  }\n}\n\nfunction parseNonBlankString(value: unknown): string | undefined {\n  if (typeof value !== \"string\") {\n    return undefined;\n  }\n\n  const parsed = value.trim();\n  return parsed.length > 0 ? parsed : undefined;\n}\n\nfunction parseIdentity(value: unknown): InspectorIdentity | undefined {\n  if (!isRecord(value)) {\n    return undefined;\n  }\n\n  const organizationName = parseNonBlankString(value.organizationName);\n  const projectName = parseNonBlankString(value.projectName);\n  if (organizationName === undefined || projectName === undefined) {\n    return undefined;\n  }\n\n  return { organizationName, projectName };\n}\n\nfunction parsePlan(value: unknown): InspectorPlan | undefined {\n  if (!isRecord(value)) {\n    return undefined;\n  }\n\n  const code = parseNonBlankString(value.code);\n  const label = parseNonBlankString(value.label);\n  if (code === undefined || label === undefined) {\n    return undefined;\n  }\n\n  return { code, label };\n}\n\nfunction parseLicense(value: unknown): InspectorLicense | undefined {\n  if (!isRecord(value)) {\n    return undefined;\n  }\n\n  switch (value.state) {\n    case \"valid\":\n    case \"none\":\n    case \"expired\":\n    case \"unknown\":\n      return { state: value.state };\n    default:\n      return undefined;\n  }\n}\n\nfunction parseActionKind(value: unknown): InspectorAction[\"kind\"] | undefined {\n  switch (value) {\n    case \"manage_plan\":\n    case \"renew\":\n    case \"enable_intelligence\":\n      return value;\n    default:\n      return undefined;\n  }\n}\n\nfunction parseSafeActionUrl(value: unknown): string | undefined {\n  const url = parseNonBlankString(value);\n  if (url === undefined || url.includes(\"?\") || url.includes(\"#\")) {\n    return undefined;\n  }\n\n  const authorityStart = url.indexOf(\"://\");\n  if (authorityStart < 1) {\n    return undefined;\n  }\n\n  const authorityAndPath = url.slice(authorityStart + 3);\n  const pathStart = authorityAndPath.indexOf(\"/\");\n  const authority =\n    pathStart === -1 ? authorityAndPath : authorityAndPath.slice(0, pathStart);\n  if (authority.includes(\"@\")) {\n    return undefined;\n  }\n\n  let parsed: URL;\n  try {\n    parsed = new URL(url);\n  } catch {\n    return undefined;\n  }\n\n  if (parsed.hostname.length === 0 || parsed.username || parsed.password) {\n    return undefined;\n  }\n\n  if (parsed.protocol === \"https:\") {\n    return url;\n  }\n\n  const isLoopbackHost =\n    parsed.hostname === \"localhost\" ||\n    parsed.hostname === \"127.0.0.1\" ||\n    parsed.hostname === \"[::1]\";\n  if (parsed.protocol === \"http:\" && isLoopbackHost) {\n    return url;\n  }\n\n  return undefined;\n}\n\nfunction parseAction(value: unknown): InspectorAction | undefined {\n  if (!isRecord(value)) {\n    return undefined;\n  }\n\n  const kind = parseActionKind(value.kind);\n  const url = parseSafeActionUrl(value.url);\n  if (kind === undefined || url === undefined) {\n    return undefined;\n  }\n\n  return { kind, url };\n}\n\nfunction isFiniteNonnegativeInteger(value: unknown): value is number {\n  return typeof value === \"number\" && Number.isSafeInteger(value) && value >= 0;\n}\n\nfunction parseUsageLimit(value: unknown): InspectorUsageLimit | undefined {\n  if (!isRecord(value)) {\n    return undefined;\n  }\n\n  if (value.kind === \"finite\") {\n    if (\n      typeof value.value !== \"number\" ||\n      !Number.isSafeInteger(value.value) ||\n      value.value < 1\n    ) {\n      return undefined;\n    }\n\n    return { kind: \"finite\", value: value.value };\n  }\n\n  if (value.kind === \"unlimited\") {\n    return { kind: \"unlimited\" };\n  }\n\n  if (value.kind === \"unknown\") {\n    return { kind: \"unknown\" };\n  }\n\n  return undefined;\n}\n\nfunction parseUsage(value: unknown): InspectorUsage | undefined {\n  if (!isRecord(value)) {\n    return undefined;\n  }\n\n  const limit = parseUsageLimit(value.limit);\n  const used = value.used;\n  if (!isFiniteNonnegativeInteger(used) || limit === undefined) {\n    return undefined;\n  }\n\n  const rawExpiringSoonCount = readOwnDataProperty(value, \"expiringSoonCount\");\n  const expiringSoonCount = isFiniteNonnegativeInteger(rawExpiringSoonCount)\n    ? rawExpiringSoonCount\n    : undefined;\n\n  return {\n    used,\n    limit,\n    ...(expiringSoonCount === undefined ? {} : { expiringSoonCount }),\n  };\n}\n\n/**\n * Parses untrusted inspector metadata without letting one invalid optional\n * module hide the other valid modules.\n *\n * @param value - The decoded runtime response body.\n * @returns Normalized version 1 metadata, or `undefined` for an unsupported\n * top-level payload.\n */\nexport function parseInspectorMetadataV1(\n  value: unknown,\n): InspectorMetadataV1 | undefined {\n  if (!isRecord(value) || value.schemaVersion !== 1) {\n    return undefined;\n  }\n\n  const identity = parseIdentity(value.identity);\n  const plan = parsePlan(value.plan);\n  const license = parseLicense(value.license);\n  const action = parseAction(value.action);\n  const usage = parseUsage(value.usage);\n\n  return {\n    schemaVersion: 1,\n    ...(identity === undefined ? {} : { identity }),\n    ...(plan === undefined ? {} : { plan }),\n    ...(license === undefined ? {} : { license }),\n    ...(action === undefined ? {} : { action }),\n    ...(usage === undefined ? {} : { usage }),\n  };\n}\n"],"mappings":"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"}

package/dist/utils/types.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"types.cjs","names":[],"sources":["../../src/utils/types.ts"],"sourcesContent":["import type { AgentCapabilities } from \"@ag-ui/core\";\n\nexport type MaybePromise<T> = T | PromiseLike<T>;\n\n/**\n * More specific utility for records with at least one key\n */\nexport type NonEmptyRecord<T> =\n  T extends Record<string, unknown>\n    ? keyof T extends never\n      ? never\n      : T\n    : never;\n\n/**\n * Type representing an agent's basic information\n */\nexport interface AgentDescription {\n  name: string;\n  className: string;\n  description: string;\n  capabilities?: AgentCapabilities;\n}\n\nexport type RuntimeMode = \"sse\" | \"intelligence\";\n\nexport const RUNTIME_MODE_SSE = \"sse\" as const;\nexport const RUNTIME_MODE_INTELLIGENCE = \"intelligence\" as const;\n\nexport interface IntelligenceRuntimeInfo {\n  wsUrl: string;\n}\n\nexport interface ThreadEndpointRuntimeInfo {\n  list: boolean;\n  inspect: boolean;\n  mutations: boolean;\n  realtimeMetadata: boolean;\n}\n\nexport type RuntimeLicenseStatus =\n  | \"valid\"\n  | \"none\"\n  | \"expired\"\n  | \"expiring\"\n  | \"invalid\"\n  | \"unknown\";\n\nexport interface A2UIRuntimeInfo {\n  enabled: boolean;\n  /**\n   * Agent ids the runtime applies A2UI to. When omitted, A2UI applies to\n   * every agent served by the runtime.\n   */\n  agents?: string[];\n}\n\nexport interface RuntimeInfo {\n  version: string;\n  agents: Record<string, AgentDescription>;\n  audioFileTranscriptionEnabled: boolean;\n  mode: RuntimeMode;\n  intelligence?: IntelligenceRuntimeInfo;\n  threadEndpoints?: ThreadEndpointRuntimeInfo;\n  /**\n   * When true, the runtime exposes POST /agent/:agentId/suggest for stateless\n   * suggestion generation. Absent on older runtimes; clients fall back to a\n   * client-side agent run.\n   */\n  suggestions?: boolean;\n  /**\n   * @deprecated Use `a2ui` instead, which preserves per-agent scoping.\n   * Kept for backward compatibility with older clients.\n   */\n  a2uiEnabled?: boolean;\n  a2ui?: A2UIRuntimeInfo;\n  openGenerativeUIEnabled?: boolean;\n  licenseStatus?: RuntimeLicenseStatus;\n  telemetryDisabled?: boolean;\n}\n"],"mappings":";;AA0BA,MAAa,mBAAmB;AAChC,MAAa,4BAA4B"}
+{"version":3,"file":"types.cjs","names":[],"sources":["../../src/utils/types.ts"],"sourcesContent":["import type { AgentCapabilities } from \"@ag-ui/core\";\n\nexport type MaybePromise<T> = T | PromiseLike<T>;\n\n/**\n * More specific utility for records with at least one key\n */\nexport type NonEmptyRecord<T> =\n  T extends Record<string, unknown>\n    ? keyof T extends never\n      ? never\n      : T\n    : never;\n\n/**\n * Type representing an agent's basic information\n */\nexport interface AgentDescription {\n  name: string;\n  className: string;\n  description: string;\n  capabilities?: AgentCapabilities;\n}\n\nexport type RuntimeMode = \"sse\" | \"intelligence\";\n\nexport const RUNTIME_MODE_SSE = \"sse\" as const;\nexport const RUNTIME_MODE_INTELLIGENCE = \"intelligence\" as const;\n\nexport interface IntelligenceRuntimeInfo {\n  wsUrl: string;\n}\n\nexport interface ThreadEndpointRuntimeInfo {\n  list: boolean;\n  inspect: boolean;\n  mutations: boolean;\n  realtimeMetadata: boolean;\n}\n\nexport type RuntimeLicenseStatus =\n  | \"valid\"\n  | \"none\"\n  | \"expired\"\n  | \"expiring\"\n  | \"invalid\"\n  | \"unknown\";\n\nexport interface A2UIRuntimeInfo {\n  enabled: boolean;\n  /**\n   * Agent ids the runtime applies A2UI to. When omitted, A2UI applies to\n   * every agent served by the runtime.\n   */\n  agents?: string[];\n}\n\nexport interface RuntimeInfo {\n  version: string;\n  agents: Record<string, AgentDescription>;\n  audioFileTranscriptionEnabled: boolean;\n  mode: RuntimeMode;\n  intelligence?: IntelligenceRuntimeInfo;\n  threadEndpoints?: ThreadEndpointRuntimeInfo;\n  /** Whether this runtime exposes trusted inspector metadata. */\n  inspectorMetadata?: boolean;\n  /**\n   * When true, the runtime exposes POST /agent/:agentId/suggest for stateless\n   * suggestion generation. Absent on older runtimes; clients fall back to a\n   * client-side agent run.\n   */\n  suggestions?: boolean;\n  /**\n   * @deprecated Use `a2ui` instead, which preserves per-agent scoping.\n   * Kept for backward compatibility with older clients.\n   */\n  a2uiEnabled?: boolean;\n  a2ui?: A2UIRuntimeInfo;\n  openGenerativeUIEnabled?: boolean;\n  licenseStatus?: RuntimeLicenseStatus;\n  telemetryDisabled?: boolean;\n}\n"],"mappings":";;AA0BA,MAAa,mBAAmB;AAChC,MAAa,4BAA4B"}

package/dist/utils/types.d.cts

@@ -43,6 +43,8 @@ interface RuntimeInfo {
   mode: RuntimeMode;
   intelligence?: IntelligenceRuntimeInfo;
   threadEndpoints?: ThreadEndpointRuntimeInfo;
+  /** Whether this runtime exposes trusted inspector metadata. */
+  inspectorMetadata?: boolean;
   /**
    * When true, the runtime exposes POST /agent/:agentId/suggest for stateless
    * suggestion generation. Absent on older runtimes; clients fall back to a