@copilotkit/shared 1.51.5-next.0 → 1.51.5-next.2

package/dist/utils/errors.mjs

@@ -1,65 +1,418 @@
-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 "../chunk-7KOT4KP4.mjs";
-import "../chunk-N5EP5OD5.mjs";
-import "../chunk-NAFEBKSO.mjs";
-import "../chunk-MSUB6DGR.mjs";
-import "../chunk-2OJ5OJ2D.mjs";
-import "../chunk-UYARLQNA.mjs";
-import "../chunk-IAFBVORQ.mjs";
-import "../chunk-FCCOSO5L.mjs";
-import "../chunk-V7BSERGI.mjs";
-import "../chunk-M2RJI5BZ.mjs";
-import "../chunk-3DK3UMRW.mjs";
-import "../chunk-GS5BLXSZ.mjs";
-import "../chunk-WAZHII6M.mjs";
-import "../chunk-XTHC46M2.mjs";
-import "../chunk-ZIC6V6S5.mjs";
-import "../chunk-P7STFMPO.mjs";
-import "../chunk-DE5XAMMI.mjs";
-import "../chunk-ZI7ZVRL3.mjs";
-import "../chunk-ZUE2VR7D.mjs";
-export {
-  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
+import { COPILOTKIT_VERSION } from "../index.mjs";
+import { GraphQLError } from "graphql";
+
+//#region src/utils/errors.ts
+let Severity = /* @__PURE__ */ function(Severity) {
+	Severity["CRITICAL"] = "critical";
+	Severity["WARNING"] = "warning";
+	Severity["INFO"] = "info";
+	return Severity;
+}({});
+let ErrorVisibility = /* @__PURE__ */ function(ErrorVisibility) {
+	ErrorVisibility["BANNER"] = "banner";
+	ErrorVisibility["TOAST"] = "toast";
+	ErrorVisibility["SILENT"] = "silent";
+	ErrorVisibility["DEV_ONLY"] = "dev_only";
+	return ErrorVisibility;
+}({});
+const ERROR_NAMES = {
+	COPILOT_ERROR: "CopilotError",
+	COPILOT_API_DISCOVERY_ERROR: "CopilotApiDiscoveryError",
+	COPILOT_REMOTE_ENDPOINT_DISCOVERY_ERROR: "CopilotKitRemoteEndpointDiscoveryError",
+	COPILOT_KIT_AGENT_DISCOVERY_ERROR: "CopilotKitAgentDiscoveryError",
+	COPILOT_KIT_LOW_LEVEL_ERROR: "CopilotKitLowLevelError",
+	COPILOT_KIT_VERSION_MISMATCH_ERROR: "CopilotKitVersionMismatchError",
+	RESOLVED_COPILOT_KIT_ERROR: "ResolvedCopilotKitError",
+	CONFIGURATION_ERROR: "ConfigurationError",
+	MISSING_PUBLIC_API_KEY_ERROR: "MissingPublicApiKeyError",
+	UPGRADE_REQUIRED_ERROR: "UpgradeRequiredError"
 };
+const BANNER_ERROR_NAMES = [
+	ERROR_NAMES.CONFIGURATION_ERROR,
+	ERROR_NAMES.MISSING_PUBLIC_API_KEY_ERROR,
+	ERROR_NAMES.UPGRADE_REQUIRED_ERROR,
+	ERROR_NAMES.COPILOT_API_DISCOVERY_ERROR,
+	ERROR_NAMES.COPILOT_REMOTE_ENDPOINT_DISCOVERY_ERROR,
+	ERROR_NAMES.COPILOT_KIT_AGENT_DISCOVERY_ERROR
+];
+const COPILOT_CLOUD_ERROR_NAMES = BANNER_ERROR_NAMES;
+let CopilotKitErrorCode = /* @__PURE__ */ function(CopilotKitErrorCode) {
+	CopilotKitErrorCode["NETWORK_ERROR"] = "NETWORK_ERROR";
+	CopilotKitErrorCode["NOT_FOUND"] = "NOT_FOUND";
+	CopilotKitErrorCode["AGENT_NOT_FOUND"] = "AGENT_NOT_FOUND";
+	CopilotKitErrorCode["API_NOT_FOUND"] = "API_NOT_FOUND";
+	CopilotKitErrorCode["REMOTE_ENDPOINT_NOT_FOUND"] = "REMOTE_ENDPOINT_NOT_FOUND";
+	CopilotKitErrorCode["AUTHENTICATION_ERROR"] = "AUTHENTICATION_ERROR";
+	CopilotKitErrorCode["MISUSE"] = "MISUSE";
+	CopilotKitErrorCode["UNKNOWN"] = "UNKNOWN";
+	CopilotKitErrorCode["VERSION_MISMATCH"] = "VERSION_MISMATCH";
+	CopilotKitErrorCode["CONFIGURATION_ERROR"] = "CONFIGURATION_ERROR";
+	CopilotKitErrorCode["MISSING_PUBLIC_API_KEY_ERROR"] = "MISSING_PUBLIC_API_KEY_ERROR";
+	CopilotKitErrorCode["UPGRADE_REQUIRED_ERROR"] = "UPGRADE_REQUIRED_ERROR";
+	return CopilotKitErrorCode;
+}({});
+const BASE_URL = "https://docs.copilotkit.ai";
+const getSeeMoreMarkdown = (link) => `See more: [${link}](${link})`;
+const ERROR_CONFIG = {
+	[CopilotKitErrorCode.NETWORK_ERROR]: {
+		statusCode: 503,
+		troubleshootingUrl: `${BASE_URL}/troubleshooting/common-issues#i-am-getting-a-network-errors--api-not-found`,
+		visibility: ErrorVisibility.BANNER,
+		severity: Severity.CRITICAL
+	},
+	[CopilotKitErrorCode.NOT_FOUND]: {
+		statusCode: 404,
+		troubleshootingUrl: `${BASE_URL}/troubleshooting/common-issues#i-am-getting-a-network-errors--api-not-found`,
+		visibility: ErrorVisibility.BANNER,
+		severity: Severity.CRITICAL
+	},
+	[CopilotKitErrorCode.AGENT_NOT_FOUND]: {
+		statusCode: 500,
+		troubleshootingUrl: `${BASE_URL}/coagents/troubleshooting/common-issues#i-am-getting-agent-not-found-error`,
+		visibility: ErrorVisibility.BANNER,
+		severity: Severity.CRITICAL
+	},
+	[CopilotKitErrorCode.API_NOT_FOUND]: {
+		statusCode: 404,
+		troubleshootingUrl: `${BASE_URL}/troubleshooting/common-issues#i-am-getting-a-network-errors--api-not-found`,
+		visibility: ErrorVisibility.BANNER,
+		severity: Severity.CRITICAL
+	},
+	[CopilotKitErrorCode.REMOTE_ENDPOINT_NOT_FOUND]: {
+		statusCode: 404,
+		troubleshootingUrl: `${BASE_URL}/troubleshooting/common-issues#i-am-getting-copilotkits-remote-endpoint-not-found-error`,
+		visibility: ErrorVisibility.BANNER,
+		severity: Severity.CRITICAL
+	},
+	[CopilotKitErrorCode.AUTHENTICATION_ERROR]: {
+		statusCode: 401,
+		troubleshootingUrl: `${BASE_URL}/troubleshooting/common-issues#authentication-errors`,
+		visibility: ErrorVisibility.BANNER,
+		severity: Severity.CRITICAL
+	},
+	[CopilotKitErrorCode.MISUSE]: {
+		statusCode: 400,
+		troubleshootingUrl: null,
+		visibility: ErrorVisibility.DEV_ONLY,
+		severity: Severity.WARNING
+	},
+	[CopilotKitErrorCode.UNKNOWN]: {
+		statusCode: 500,
+		visibility: ErrorVisibility.TOAST,
+		severity: Severity.CRITICAL
+	},
+	[CopilotKitErrorCode.CONFIGURATION_ERROR]: {
+		statusCode: 400,
+		troubleshootingUrl: null,
+		severity: Severity.WARNING,
+		visibility: ErrorVisibility.BANNER
+	},
+	[CopilotKitErrorCode.MISSING_PUBLIC_API_KEY_ERROR]: {
+		statusCode: 400,
+		troubleshootingUrl: null,
+		severity: Severity.CRITICAL,
+		visibility: ErrorVisibility.BANNER
+	},
+	[CopilotKitErrorCode.UPGRADE_REQUIRED_ERROR]: {
+		statusCode: 402,
+		troubleshootingUrl: null,
+		severity: Severity.WARNING,
+		visibility: ErrorVisibility.BANNER
+	},
+	[CopilotKitErrorCode.VERSION_MISMATCH]: {
+		statusCode: 400,
+		troubleshootingUrl: null,
+		visibility: ErrorVisibility.DEV_ONLY,
+		severity: Severity.INFO
+	}
+};
+var CopilotKitError = class extends GraphQLError {
+	constructor({ message = "Unknown error occurred", code, severity, visibility }) {
+		const name = ERROR_NAMES.COPILOT_ERROR;
+		const config = ERROR_CONFIG[code];
+		const { statusCode } = config;
+		const resolvedVisibility = visibility ?? config.visibility ?? ErrorVisibility.TOAST;
+		const resolvedSeverity = severity ?? ("severity" in config ? config.severity : void 0);
+		super(message, { extensions: {
+			name,
+			statusCode,
+			code,
+			visibility: resolvedVisibility,
+			severity: resolvedSeverity,
+			troubleshootingUrl: "troubleshootingUrl" in config ? config.troubleshootingUrl : null,
+			originalError: {
+				message,
+				stack: (/* @__PURE__ */ new Error()).stack
+			}
+		} });
+		this.code = code;
+		this.name = name;
+		this.statusCode = statusCode;
+		this.severity = resolvedSeverity;
+		this.visibility = resolvedVisibility;
+	}
+};
+/**
+* Error thrown when we can identify wrong usage of our components.
+* This helps us notify the developer before real errors can happen
+*
+* @extends CopilotKitError
+*/
+var CopilotKitMisuseError = class extends CopilotKitError {
+	constructor({ message, code = CopilotKitErrorCode.MISUSE }) {
+		const docsLink = "troubleshootingUrl" in ERROR_CONFIG[code] && ERROR_CONFIG[code].troubleshootingUrl ? getSeeMoreMarkdown(ERROR_CONFIG[code].troubleshootingUrl) : null;
+		const finalMessage = docsLink ? `${message}.\n\n${docsLink}` : message;
+		super({
+			message: finalMessage,
+			code
+		});
+		this.name = ERROR_NAMES.COPILOT_API_DISCOVERY_ERROR;
+	}
+};
+const getVersionMismatchErrorMessage = ({ reactCoreVersion, runtimeVersion, runtimeClientGqlVersion }) => `Version mismatch detected: @copilotkit/runtime@${runtimeVersion ?? ""} is not compatible with @copilotkit/react-core@${reactCoreVersion} and @copilotkit/runtime-client-gql@${runtimeClientGqlVersion}. Please ensure all installed copilotkit packages are on the same version.`;
+/**
+* Error thrown when CPK versions does not match
+*
+* @extends CopilotKitError
+*/
+var CopilotKitVersionMismatchError = class extends CopilotKitError {
+	constructor({ reactCoreVersion, runtimeVersion, runtimeClientGqlVersion }) {
+		const code = CopilotKitErrorCode.VERSION_MISMATCH;
+		super({
+			message: getVersionMismatchErrorMessage({
+				reactCoreVersion,
+				runtimeVersion,
+				runtimeClientGqlVersion
+			}),
+			code
+		});
+		this.name = ERROR_NAMES.COPILOT_KIT_VERSION_MISMATCH_ERROR;
+	}
+};
+/**
+* Error thrown when the CopilotKit API endpoint cannot be discovered or accessed.
+* This typically occurs when:
+* - The API endpoint URL is invalid or misconfigured
+* - The API service is not running at the expected location
+* - There are network/firewall issues preventing access
+*
+* @extends CopilotKitError
+*/
+var CopilotKitApiDiscoveryError = class extends CopilotKitError {
+	constructor(params = {}) {
+		const url = params.url ?? "";
+		let operationSuffix = "";
+		if (url?.includes("/info")) operationSuffix = `when fetching CopilotKit info`;
+		else if (url.includes("/actions/execute")) operationSuffix = `when attempting to execute actions.`;
+		else if (url.includes("/agents/state")) operationSuffix = `when attempting to get agent state.`;
+		else if (url.includes("/agents/execute")) operationSuffix = `when attempting to execute agent(s).`;
+		const message = params.message ?? (params.url ? `Failed to find CopilotKit API endpoint at url ${params.url} ${operationSuffix}` : `Failed to find CopilotKit API endpoint.`);
+		const code = params.code ?? CopilotKitErrorCode.API_NOT_FOUND;
+		const errorMessage = `${message}.\n\n${getSeeMoreMarkdown(ERROR_CONFIG[code].troubleshootingUrl)}`;
+		super({
+			message: errorMessage,
+			code
+		});
+		this.name = ERROR_NAMES.COPILOT_API_DISCOVERY_ERROR;
+	}
+};
+/**
+* This error is used for endpoints specified in runtime's remote endpoints. If they cannot be contacted
+* This typically occurs when:
+* - The API endpoint URL is invalid or misconfigured
+* - The API service is not running at the expected location
+*
+* @extends CopilotKitApiDiscoveryError
+*/
+var CopilotKitRemoteEndpointDiscoveryError = class extends CopilotKitApiDiscoveryError {
+	constructor(params) {
+		const message = params?.message ?? (params?.url ? `Failed to find or contact remote endpoint at url ${params.url}` : "Failed to find or contact remote endpoint");
+		const code = CopilotKitErrorCode.REMOTE_ENDPOINT_NOT_FOUND;
+		super({
+			message,
+			code
+		});
+		this.name = ERROR_NAMES.COPILOT_REMOTE_ENDPOINT_DISCOVERY_ERROR;
+	}
+};
+/**
+* Error thrown when a LangGraph agent cannot be found or accessed.
+* This typically occurs when:
+* - The specified agent name does not exist in the deployment
+* - The agent configuration is invalid or missing
+* - The agent service is not properly deployed or initialized
+*
+* @extends CopilotKitError
+*/
+var CopilotKitAgentDiscoveryError = class extends CopilotKitError {
+	constructor(params) {
+		const { agentName, availableAgents } = params;
+		const code = CopilotKitErrorCode.AGENT_NOT_FOUND;
+		const seeMore = getSeeMoreMarkdown(ERROR_CONFIG[code].troubleshootingUrl);
+		let message;
+		if (availableAgents.length) {
+			const agentList = availableAgents.map((agent) => agent.name).join(", ");
+			if (agentName) message = `Agent '${agentName}' was not found. Available agents are: ${agentList}. Please verify the agent name in your configuration and ensure it matches one of the available agents.\n\n${seeMore}`;
+			else message = `The requested agent was not found. Available agents are: ${agentList}. Please verify the agent name in your configuration and ensure it matches one of the available agents.\n\n${seeMore}`;
+		} else message = `${agentName ? `Agent '${agentName}'` : "The requested agent"} was not found. Please set up at least one agent before proceeding. ${seeMore}`;
+		super({
+			message,
+			code
+		});
+		this.name = ERROR_NAMES.COPILOT_KIT_AGENT_DISCOVERY_ERROR;
+	}
+};
+/**
+* Handles low-level networking errors that occur before a request reaches the server.
+* These errors arise from issues in the underlying communication infrastructure rather than
+* application-level logic or server responses. Typically used to handle "fetch failed" errors
+* where no HTTP status code is available.
+*
+* Common scenarios include:
+* - Connection failures (ECONNREFUSED) when server is down/unreachable
+* - DNS resolution failures (ENOTFOUND) when domain can't be resolved
+* - Timeouts (ETIMEDOUT) when request takes too long
+* - Protocol/transport layer errors like SSL/TLS issues
+*/
+var CopilotKitLowLevelError = class extends CopilotKitError {
+	constructor({ error, url, message }) {
+		let code = CopilotKitErrorCode.NETWORK_ERROR;
+		const errorCode = error.code;
+		const errorMessage = message ?? resolveLowLevelErrorMessage({
+			errorCode,
+			url
+		});
+		super({
+			message: errorMessage,
+			code
+		});
+		this.name = ERROR_NAMES.COPILOT_KIT_LOW_LEVEL_ERROR;
+	}
+};
+/**
+* Generic catch-all error handler for HTTP responses from the CopilotKit API where a status code is available.
+* Used when we receive an HTTP error status and wish to handle broad range of them
+*
+* This differs from CopilotKitLowLevelError in that:
+* - ResolvedCopilotKitError: Server was reached and returned an HTTP status
+* - CopilotKitLowLevelError: Error occurred before reaching server (e.g. network failure)
+*
+* @param status - The HTTP status code received from the API response
+* @param message - Optional error message to include
+* @param code - Optional specific CopilotKitErrorCode to override default behavior
+*
+* Default behavior:
+* - 400 Bad Request: Maps to CopilotKitApiDiscoveryError
+* - All other status codes: Maps to UNKNOWN error code if no specific code provided
+*/
+var ResolvedCopilotKitError = class extends CopilotKitError {
+	constructor({ status, message, code, isRemoteEndpoint, url }) {
+		let resolvedCode = code;
+		if (!resolvedCode) switch (status) {
+			case 400: throw new CopilotKitApiDiscoveryError({
+				message,
+				url
+			});
+			case 404: throw isRemoteEndpoint ? new CopilotKitRemoteEndpointDiscoveryError({
+				message,
+				url
+			}) : new CopilotKitApiDiscoveryError({
+				message,
+				url
+			});
+			default:
+				resolvedCode = CopilotKitErrorCode.UNKNOWN;
+				break;
+		}
+		super({
+			message,
+			code: resolvedCode
+		});
+		this.name = ERROR_NAMES.RESOLVED_COPILOT_KIT_ERROR;
+	}
+};
+var ConfigurationError = class extends CopilotKitError {
+	constructor(message) {
+		super({
+			message,
+			code: CopilotKitErrorCode.CONFIGURATION_ERROR
+		});
+		this.name = ERROR_NAMES.CONFIGURATION_ERROR;
+		this.severity = Severity.WARNING;
+	}
+};
+var MissingPublicApiKeyError = class extends ConfigurationError {
+	constructor(message) {
+		super(message);
+		this.name = ERROR_NAMES.MISSING_PUBLIC_API_KEY_ERROR;
+		this.severity = Severity.CRITICAL;
+	}
+};
+var UpgradeRequiredError = class extends ConfigurationError {
+	constructor(message) {
+		super(message);
+		this.name = ERROR_NAMES.UPGRADE_REQUIRED_ERROR;
+		this.severity = Severity.WARNING;
+	}
+};
+/**
+* Checks if an error is already a structured CopilotKit error.
+* This utility centralizes the logic for detecting structured errors across the codebase.
+*
+* @param error - The error to check
+* @returns true if the error is already structured, false otherwise
+*/
+function isStructuredCopilotKitError(error) {
+	return error instanceof CopilotKitError || error instanceof CopilotKitLowLevelError || error?.name && error.name.includes("CopilotKit") || error?.extensions?.code !== void 0;
+}
+/**
+* Returns the error as-is if it's already structured, otherwise converts it using the provided converter function.
+* This utility centralizes the pattern of preserving structured errors while converting unstructured ones.
+*
+* @param error - The error to process
+* @param converter - Function to convert unstructured errors to structured ones
+* @returns The structured error
+*/
+function ensureStructuredError(error, converter) {
+	return isStructuredCopilotKitError(error) ? error : converter(error);
+}
+async function getPossibleVersionMismatch({ runtimeVersion, runtimeClientGqlVersion }) {
+	if (!runtimeVersion || runtimeVersion === "" || !runtimeClientGqlVersion) return;
+	if (COPILOTKIT_VERSION !== runtimeVersion || COPILOTKIT_VERSION !== runtimeClientGqlVersion || runtimeVersion !== runtimeClientGqlVersion) return {
+		runtimeVersion,
+		runtimeClientGqlVersion,
+		reactCoreVersion: COPILOTKIT_VERSION,
+		message: getVersionMismatchErrorMessage({
+			runtimeVersion,
+			runtimeClientGqlVersion,
+			reactCoreVersion: COPILOTKIT_VERSION
+		})
+	};
+}
+const resolveLowLevelErrorMessage = ({ errorCode, url }) => {
+	const troubleshootingLink = ERROR_CONFIG[CopilotKitErrorCode.NETWORK_ERROR].troubleshootingUrl;
+	const genericMessage = (description = `Failed to fetch from url ${url}.`) => `${description}.
+
+Possible reasons:
+- -The server may have an error preventing it from returning a response (Check the server logs for more info).
+- -The server might be down or unreachable
+- -There might be a network issue (e.g., DNS failure, connection timeout) 
+- -The URL might be incorrect
+- -The server is not running on the specified port
+
+${getSeeMoreMarkdown(troubleshootingLink)}`;
+	if (url.includes("/info")) return genericMessage(`Failed to fetch CopilotKit agents/action information from url ${url}.`);
+	if (url.includes("/actions/execute")) return genericMessage(`Fetch call to ${url} to execute actions failed.`);
+	if (url.includes("/agents/state")) return genericMessage(`Fetch call to ${url} to get agent state failed.`);
+	if (url.includes("/agents/execute")) return genericMessage(`Fetch call to ${url} to execute agent(s) failed.`);
+	switch (errorCode) {
+		case "ECONNREFUSED": return `Connection to ${url} was refused. Ensure the server is running and accessible.\n\n${getSeeMoreMarkdown(troubleshootingLink)}`;
+		case "ENOTFOUND": return `The server on ${url} could not be found. Check the URL or your network configuration.\n\n${getSeeMoreMarkdown(ERROR_CONFIG[CopilotKitErrorCode.NOT_FOUND].troubleshootingUrl)}`;
+		case "ETIMEDOUT": return `The connection to ${url} timed out. The server might be overloaded or taking too long to respond.\n\n${getSeeMoreMarkdown(troubleshootingLink)}`;
+		default: return;
+	}
+};
+
+//#endregion
+export { 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 };
 //# sourceMappingURL=errors.mjs.map

package/dist/utils/errors.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}
+{"version":3,"file":"errors.mjs","names":[],"sources":["../../src/utils/errors.ts"],"sourcesContent":["import { GraphQLError } from \"graphql\";\nimport { COPILOTKIT_VERSION } from \"../index\";\n\nexport enum Severity {\n  CRITICAL = \"critical\", // Critical errors that block core functionality\n  WARNING = \"warning\", // Configuration/setup issues that need attention\n  INFO = \"info\", // General errors and network issues\n}\n\nexport enum ErrorVisibility {\n  BANNER = \"banner\", // Critical errors shown as fixed banners\n  TOAST = \"toast\", // Regular errors shown as dismissible toasts\n  SILENT = \"silent\", // Errors logged but not shown to user\n  DEV_ONLY = \"dev_only\", // Errors only shown in development mode\n}\n\nexport const ERROR_NAMES = {\n  COPILOT_ERROR: \"CopilotError\",\n  COPILOT_API_DISCOVERY_ERROR: \"CopilotApiDiscoveryError\",\n  COPILOT_REMOTE_ENDPOINT_DISCOVERY_ERROR:\n    \"CopilotKitRemoteEndpointDiscoveryError\",\n  COPILOT_KIT_AGENT_DISCOVERY_ERROR: \"CopilotKitAgentDiscoveryError\",\n  COPILOT_KIT_LOW_LEVEL_ERROR: \"CopilotKitLowLevelError\",\n  COPILOT_KIT_VERSION_MISMATCH_ERROR: \"CopilotKitVersionMismatchError\",\n  RESOLVED_COPILOT_KIT_ERROR: \"ResolvedCopilotKitError\",\n  CONFIGURATION_ERROR: \"ConfigurationError\",\n  MISSING_PUBLIC_API_KEY_ERROR: \"MissingPublicApiKeyError\",\n  UPGRADE_REQUIRED_ERROR: \"UpgradeRequiredError\",\n} as const;\n\n// Banner errors - critical configuration/discovery issues\nexport const BANNER_ERROR_NAMES = [\n  ERROR_NAMES.CONFIGURATION_ERROR,\n  ERROR_NAMES.MISSING_PUBLIC_API_KEY_ERROR,\n  ERROR_NAMES.UPGRADE_REQUIRED_ERROR,\n  ERROR_NAMES.COPILOT_API_DISCOVERY_ERROR,\n  ERROR_NAMES.COPILOT_REMOTE_ENDPOINT_DISCOVERY_ERROR,\n  ERROR_NAMES.COPILOT_KIT_AGENT_DISCOVERY_ERROR,\n];\n\n// Legacy cloud error names for backward compatibility\nexport const COPILOT_CLOUD_ERROR_NAMES = BANNER_ERROR_NAMES;\n\nexport enum CopilotKitErrorCode {\n  NETWORK_ERROR = \"NETWORK_ERROR\",\n  NOT_FOUND = \"NOT_FOUND\",\n  AGENT_NOT_FOUND = \"AGENT_NOT_FOUND\",\n  API_NOT_FOUND = \"API_NOT_FOUND\",\n  REMOTE_ENDPOINT_NOT_FOUND = \"REMOTE_ENDPOINT_NOT_FOUND\",\n  AUTHENTICATION_ERROR = \"AUTHENTICATION_ERROR\",\n  MISUSE = \"MISUSE\",\n  UNKNOWN = \"UNKNOWN\",\n  VERSION_MISMATCH = \"VERSION_MISMATCH\",\n  CONFIGURATION_ERROR = \"CONFIGURATION_ERROR\",\n  MISSING_PUBLIC_API_KEY_ERROR = \"MISSING_PUBLIC_API_KEY_ERROR\",\n  UPGRADE_REQUIRED_ERROR = \"UPGRADE_REQUIRED_ERROR\",\n}\n\nconst BASE_URL = \"https://docs.copilotkit.ai\";\n\nconst getSeeMoreMarkdown = (link: string) => `See more: [${link}](${link})`;\n\nexport const ERROR_CONFIG = {\n  [CopilotKitErrorCode.NETWORK_ERROR]: {\n    statusCode: 503,\n    troubleshootingUrl: `${BASE_URL}/troubleshooting/common-issues#i-am-getting-a-network-errors--api-not-found`,\n    visibility: ErrorVisibility.BANNER,\n    severity: Severity.CRITICAL,\n  },\n  [CopilotKitErrorCode.NOT_FOUND]: {\n    statusCode: 404,\n    troubleshootingUrl: `${BASE_URL}/troubleshooting/common-issues#i-am-getting-a-network-errors--api-not-found`,\n    visibility: ErrorVisibility.BANNER,\n    severity: Severity.CRITICAL,\n  },\n  [CopilotKitErrorCode.AGENT_NOT_FOUND]: {\n    statusCode: 500,\n    troubleshootingUrl: `${BASE_URL}/coagents/troubleshooting/common-issues#i-am-getting-agent-not-found-error`,\n    visibility: ErrorVisibility.BANNER,\n    severity: Severity.CRITICAL,\n  },\n  [CopilotKitErrorCode.API_NOT_FOUND]: {\n    statusCode: 404,\n    troubleshootingUrl: `${BASE_URL}/troubleshooting/common-issues#i-am-getting-a-network-errors--api-not-found`,\n    visibility: ErrorVisibility.BANNER,\n    severity: Severity.CRITICAL,\n  },\n  [CopilotKitErrorCode.REMOTE_ENDPOINT_NOT_FOUND]: {\n    statusCode: 404,\n    troubleshootingUrl: `${BASE_URL}/troubleshooting/common-issues#i-am-getting-copilotkits-remote-endpoint-not-found-error`,\n    visibility: ErrorVisibility.BANNER,\n    severity: Severity.CRITICAL,\n  },\n  [CopilotKitErrorCode.AUTHENTICATION_ERROR]: {\n    statusCode: 401,\n    troubleshootingUrl: `${BASE_URL}/troubleshooting/common-issues#authentication-errors`,\n    visibility: ErrorVisibility.BANNER,\n    severity: Severity.CRITICAL,\n  },\n  [CopilotKitErrorCode.MISUSE]: {\n    statusCode: 400,\n    troubleshootingUrl: null,\n    visibility: ErrorVisibility.DEV_ONLY,\n    severity: Severity.WARNING,\n  },\n  [CopilotKitErrorCode.UNKNOWN]: {\n    statusCode: 500,\n    visibility: ErrorVisibility.TOAST,\n    severity: Severity.CRITICAL,\n  },\n  [CopilotKitErrorCode.CONFIGURATION_ERROR]: {\n    statusCode: 400,\n    troubleshootingUrl: null,\n    severity: Severity.WARNING,\n    visibility: ErrorVisibility.BANNER,\n  },\n  [CopilotKitErrorCode.MISSING_PUBLIC_API_KEY_ERROR]: {\n    statusCode: 400,\n    troubleshootingUrl: null,\n    severity: Severity.CRITICAL,\n    visibility: ErrorVisibility.BANNER,\n  },\n  [CopilotKitErrorCode.UPGRADE_REQUIRED_ERROR]: {\n    statusCode: 402,\n    troubleshootingUrl: null,\n    severity: Severity.WARNING,\n    visibility: ErrorVisibility.BANNER,\n  },\n  [CopilotKitErrorCode.VERSION_MISMATCH]: {\n    statusCode: 400,\n    troubleshootingUrl: null,\n    visibility: ErrorVisibility.DEV_ONLY,\n    severity: Severity.INFO,\n  },\n};\n\nexport class CopilotKitError extends GraphQLError {\n  code: CopilotKitErrorCode;\n  statusCode: number;\n  severity?: Severity;\n  visibility: ErrorVisibility;\n\n  constructor({\n    message = \"Unknown error occurred\",\n    code,\n    severity,\n    visibility,\n  }: {\n    message?: string;\n    code: CopilotKitErrorCode;\n    severity?: Severity;\n    visibility?: ErrorVisibility;\n  }) {\n    const name = ERROR_NAMES.COPILOT_ERROR;\n    const config = ERROR_CONFIG[code];\n    const { statusCode } = config;\n    const resolvedVisibility =\n      visibility ?? config.visibility ?? ErrorVisibility.TOAST;\n    const resolvedSeverity =\n      severity ?? (\"severity\" in config ? config.severity : undefined);\n\n    super(message, {\n      extensions: {\n        name,\n        statusCode,\n        code,\n        visibility: resolvedVisibility,\n        severity: resolvedSeverity,\n        troubleshootingUrl:\n          \"troubleshootingUrl\" in config ? config.troubleshootingUrl : null,\n        originalError: {\n          message,\n          stack: new Error().stack,\n        },\n      },\n    });\n\n    this.code = code;\n    this.name = name;\n    this.statusCode = statusCode;\n    this.severity = resolvedSeverity;\n    this.visibility = resolvedVisibility;\n  }\n}\n\n/**\n * Error thrown when we can identify wrong usage of our components.\n * This helps us notify the developer before real errors can happen\n *\n * @extends CopilotKitError\n */\nexport class CopilotKitMisuseError extends CopilotKitError {\n  constructor({\n    message,\n    code = CopilotKitErrorCode.MISUSE,\n  }: {\n    message: string;\n    code?: CopilotKitErrorCode;\n  }) {\n    const docsLink =\n      \"troubleshootingUrl\" in ERROR_CONFIG[code] &&\n      ERROR_CONFIG[code].troubleshootingUrl\n        ? getSeeMoreMarkdown(ERROR_CONFIG[code].troubleshootingUrl as string)\n        : null;\n    const finalMessage = docsLink ? `${message}.\\n\\n${docsLink}` : message;\n    super({ message: finalMessage, code });\n    this.name = ERROR_NAMES.COPILOT_API_DISCOVERY_ERROR;\n  }\n}\n\nconst getVersionMismatchErrorMessage = ({\n  reactCoreVersion,\n  runtimeVersion,\n  runtimeClientGqlVersion,\n}: VersionMismatchResponse) =>\n  `Version mismatch detected: @copilotkit/runtime@${runtimeVersion ?? \"\"} is not compatible with @copilotkit/react-core@${reactCoreVersion} and @copilotkit/runtime-client-gql@${runtimeClientGqlVersion}. Please ensure all installed copilotkit packages are on the same version.`;\n/**\n * Error thrown when CPK versions does not match\n *\n * @extends CopilotKitError\n */\nexport class CopilotKitVersionMismatchError extends CopilotKitError {\n  constructor({\n    reactCoreVersion,\n    runtimeVersion,\n    runtimeClientGqlVersion,\n  }: VersionMismatchResponse) {\n    const code = CopilotKitErrorCode.VERSION_MISMATCH;\n    super({\n      message: getVersionMismatchErrorMessage({\n        reactCoreVersion,\n        runtimeVersion,\n        runtimeClientGqlVersion,\n      }),\n      code,\n    });\n    this.name = ERROR_NAMES.COPILOT_KIT_VERSION_MISMATCH_ERROR;\n  }\n}\n\n/**\n * Error thrown when the CopilotKit API endpoint cannot be discovered or accessed.\n * This typically occurs when:\n * - The API endpoint URL is invalid or misconfigured\n * - The API service is not running at the expected location\n * - There are network/firewall issues preventing access\n *\n * @extends CopilotKitError\n */\nexport class CopilotKitApiDiscoveryError extends CopilotKitError {\n  constructor(\n    params: {\n      message?: string;\n      code?:\n        | CopilotKitErrorCode.API_NOT_FOUND\n        | CopilotKitErrorCode.REMOTE_ENDPOINT_NOT_FOUND;\n      url?: string;\n    } = {},\n  ) {\n    const url = params.url ?? \"\";\n    let operationSuffix = \"\";\n    if (url?.includes(\"/info\"))\n      operationSuffix = `when fetching CopilotKit info`;\n    else if (url.includes(\"/actions/execute\"))\n      operationSuffix = `when attempting to execute actions.`;\n    else if (url.includes(\"/agents/state\"))\n      operationSuffix = `when attempting to get agent state.`;\n    else if (url.includes(\"/agents/execute\"))\n      operationSuffix = `when attempting to execute agent(s).`;\n    const message =\n      params.message ??\n      (params.url\n        ? `Failed to find CopilotKit API endpoint at url ${params.url} ${operationSuffix}`\n        : `Failed to find CopilotKit API endpoint.`);\n    const code = params.code ?? CopilotKitErrorCode.API_NOT_FOUND;\n    const errorMessage = `${message}.\\n\\n${getSeeMoreMarkdown(ERROR_CONFIG[code].troubleshootingUrl)}`;\n    super({ message: errorMessage, code });\n    this.name = ERROR_NAMES.COPILOT_API_DISCOVERY_ERROR;\n  }\n}\n\n/**\n * This error is used for endpoints specified in runtime's remote endpoints. If they cannot be contacted\n * This typically occurs when:\n * - The API endpoint URL is invalid or misconfigured\n * - The API service is not running at the expected location\n *\n * @extends CopilotKitApiDiscoveryError\n */\nexport class CopilotKitRemoteEndpointDiscoveryError extends CopilotKitApiDiscoveryError {\n  constructor(params?: { message?: string; url?: string }) {\n    const message =\n      params?.message ??\n      (params?.url\n        ? `Failed to find or contact remote endpoint at url ${params.url}`\n        : \"Failed to find or contact remote endpoint\");\n    const code = CopilotKitErrorCode.REMOTE_ENDPOINT_NOT_FOUND;\n    super({ message, code });\n    this.name = ERROR_NAMES.COPILOT_REMOTE_ENDPOINT_DISCOVERY_ERROR;\n  }\n}\n\n/**\n * Error thrown when a LangGraph agent cannot be found or accessed.\n * This typically occurs when:\n * - The specified agent name does not exist in the deployment\n * - The agent configuration is invalid or missing\n * - The agent service is not properly deployed or initialized\n *\n * @extends CopilotKitError\n */\nexport class CopilotKitAgentDiscoveryError extends CopilotKitError {\n  constructor(params: {\n    agentName?: string;\n    availableAgents: { name: string; id: string }[];\n  }) {\n    const { agentName, availableAgents } = params;\n    const code = CopilotKitErrorCode.AGENT_NOT_FOUND;\n\n    const seeMore = getSeeMoreMarkdown(ERROR_CONFIG[code].troubleshootingUrl);\n    let message;\n\n    if (availableAgents.length) {\n      const agentList = availableAgents.map((agent) => agent.name).join(\", \");\n\n      if (agentName) {\n        message = `Agent '${agentName}' was not found. Available agents are: ${agentList}. Please verify the agent name in your configuration and ensure it matches one of the available agents.\\n\\n${seeMore}`;\n      } else {\n        message = `The requested agent was not found. Available agents are: ${agentList}. Please verify the agent name in your configuration and ensure it matches one of the available agents.\\n\\n${seeMore}`;\n      }\n    } else {\n      message = `${agentName ? `Agent '${agentName}'` : \"The requested agent\"} was not found. Please set up at least one agent before proceeding. ${seeMore}`;\n    }\n\n    super({ message, code });\n    this.name = ERROR_NAMES.COPILOT_KIT_AGENT_DISCOVERY_ERROR;\n  }\n}\n\n/**\n * Handles low-level networking errors that occur before a request reaches the server.\n * These errors arise from issues in the underlying communication infrastructure rather than\n * application-level logic or server responses. Typically used to handle \"fetch failed\" errors\n * where no HTTP status code is available.\n *\n * Common scenarios include:\n * - Connection failures (ECONNREFUSED) when server is down/unreachable\n * - DNS resolution failures (ENOTFOUND) when domain can't be resolved\n * - Timeouts (ETIMEDOUT) when request takes too long\n * - Protocol/transport layer errors like SSL/TLS issues\n */\nexport class CopilotKitLowLevelError extends CopilotKitError {\n  constructor({\n    error,\n    url,\n    message,\n  }: {\n    error: Error;\n    url: string;\n    message?: string;\n  }) {\n    let code = CopilotKitErrorCode.NETWORK_ERROR;\n\n    // @ts-expect-error -- code may exist\n    const errorCode = error.code as string;\n    const errorMessage =\n      message ?? resolveLowLevelErrorMessage({ errorCode, url });\n\n    super({ message: errorMessage, code });\n\n    this.name = ERROR_NAMES.COPILOT_KIT_LOW_LEVEL_ERROR;\n  }\n}\n\n/**\n * Generic catch-all error handler for HTTP responses from the CopilotKit API where a status code is available.\n * Used when we receive an HTTP error status and wish to handle broad range of them\n *\n * This differs from CopilotKitLowLevelError in that:\n * - ResolvedCopilotKitError: Server was reached and returned an HTTP status\n * - CopilotKitLowLevelError: Error occurred before reaching server (e.g. network failure)\n *\n * @param status - The HTTP status code received from the API response\n * @param message - Optional error message to include\n * @param code - Optional specific CopilotKitErrorCode to override default behavior\n *\n * Default behavior:\n * - 400 Bad Request: Maps to CopilotKitApiDiscoveryError\n * - All other status codes: Maps to UNKNOWN error code if no specific code provided\n */\nexport class ResolvedCopilotKitError extends CopilotKitError {\n  constructor({\n    status,\n    message,\n    code,\n    isRemoteEndpoint,\n    url,\n  }: {\n    status: number;\n    message?: string;\n    code?: CopilotKitErrorCode;\n    isRemoteEndpoint?: boolean;\n    url?: string;\n  }) {\n    let resolvedCode = code;\n    if (!resolvedCode) {\n      switch (status) {\n        case 400:\n          throw new CopilotKitApiDiscoveryError({ message, url });\n        case 404:\n          throw isRemoteEndpoint\n            ? new CopilotKitRemoteEndpointDiscoveryError({ message, url })\n            : new CopilotKitApiDiscoveryError({ message, url });\n        default:\n          resolvedCode = CopilotKitErrorCode.UNKNOWN;\n          break;\n      }\n    }\n\n    super({ message, code: resolvedCode });\n    this.name = ERROR_NAMES.RESOLVED_COPILOT_KIT_ERROR;\n  }\n}\n\nexport class ConfigurationError extends CopilotKitError {\n  constructor(message: string) {\n    super({ message, code: CopilotKitErrorCode.CONFIGURATION_ERROR });\n    this.name = ERROR_NAMES.CONFIGURATION_ERROR;\n    this.severity = Severity.WARNING;\n  }\n}\n\nexport class MissingPublicApiKeyError extends ConfigurationError {\n  constructor(message: string) {\n    super(message);\n    this.name = ERROR_NAMES.MISSING_PUBLIC_API_KEY_ERROR;\n    this.severity = Severity.CRITICAL;\n  }\n}\n\nexport class UpgradeRequiredError extends ConfigurationError {\n  constructor(message: string) {\n    super(message);\n    this.name = ERROR_NAMES.UPGRADE_REQUIRED_ERROR;\n    this.severity = Severity.WARNING;\n  }\n}\n\n/**\n * Checks if an error is already a structured CopilotKit error.\n * This utility centralizes the logic for detecting structured errors across the codebase.\n *\n * @param error - The error to check\n * @returns true if the error is already structured, false otherwise\n */\nexport function isStructuredCopilotKitError(error: any): boolean {\n  return (\n    error instanceof CopilotKitError ||\n    error instanceof CopilotKitLowLevelError ||\n    (error?.name && error.name.includes(\"CopilotKit\")) ||\n    error?.extensions?.code !== undefined // Check if it has our structured error properties\n  );\n}\n\n/**\n * Returns the error as-is if it's already structured, otherwise converts it using the provided converter function.\n * This utility centralizes the pattern of preserving structured errors while converting unstructured ones.\n *\n * @param error - The error to process\n * @param converter - Function to convert unstructured errors to structured ones\n * @returns The structured error\n */\nexport function ensureStructuredError<T extends CopilotKitError>(\n  error: any,\n  converter: (error: any) => T,\n): T | any {\n  return isStructuredCopilotKitError(error) ? error : converter(error);\n}\n\ninterface VersionMismatchResponse {\n  runtimeVersion?: string;\n  runtimeClientGqlVersion: string;\n  reactCoreVersion: string;\n}\n\nexport async function getPossibleVersionMismatch({\n  runtimeVersion,\n  runtimeClientGqlVersion,\n}: {\n  runtimeVersion?: string;\n  runtimeClientGqlVersion: string;\n}) {\n  if (!runtimeVersion || runtimeVersion === \"\" || !runtimeClientGqlVersion)\n    return;\n  if (\n    COPILOTKIT_VERSION !== runtimeVersion ||\n    COPILOTKIT_VERSION !== runtimeClientGqlVersion ||\n    runtimeVersion !== runtimeClientGqlVersion\n  ) {\n    return {\n      runtimeVersion,\n      runtimeClientGqlVersion,\n      reactCoreVersion: COPILOTKIT_VERSION,\n      message: getVersionMismatchErrorMessage({\n        runtimeVersion,\n        runtimeClientGqlVersion,\n        reactCoreVersion: COPILOTKIT_VERSION,\n      }),\n    };\n  }\n\n  return;\n}\n\nconst resolveLowLevelErrorMessage = ({\n  errorCode,\n  url,\n}: {\n  errorCode?: string;\n  url: string;\n}) => {\n  const troubleshootingLink =\n    ERROR_CONFIG[CopilotKitErrorCode.NETWORK_ERROR].troubleshootingUrl;\n  const genericMessage = (\n    description = `Failed to fetch from url ${url}.`,\n  ) => `${description}.\n\nPossible reasons:\n- -The server may have an error preventing it from returning a response (Check the server logs for more info).\n- -The server might be down or unreachable\n- -There might be a network issue (e.g., DNS failure, connection timeout) \n- -The URL might be incorrect\n- -The server is not running on the specified port\n\n${getSeeMoreMarkdown(troubleshootingLink)}`;\n\n  if (url.includes(\"/info\"))\n    return genericMessage(\n      `Failed to fetch CopilotKit agents/action information from url ${url}.`,\n    );\n  if (url.includes(\"/actions/execute\"))\n    return genericMessage(`Fetch call to ${url} to execute actions failed.`);\n  if (url.includes(\"/agents/state\"))\n    return genericMessage(`Fetch call to ${url} to get agent state failed.`);\n  if (url.includes(\"/agents/execute\"))\n    return genericMessage(`Fetch call to ${url} to execute agent(s) failed.`);\n\n  switch (errorCode) {\n    case \"ECONNREFUSED\":\n      return `Connection to ${url} was refused. Ensure the server is running and accessible.\\n\\n${getSeeMoreMarkdown(troubleshootingLink)}`;\n    case \"ENOTFOUND\":\n      return `The server on ${url} could not be found. Check the URL or your network configuration.\\n\\n${getSeeMoreMarkdown(ERROR_CONFIG[CopilotKitErrorCode.NOT_FOUND].troubleshootingUrl)}`;\n    case \"ETIMEDOUT\":\n      return `The connection to ${url} timed out. The server might be overloaded or taking too long to respond.\\n\\n${getSeeMoreMarkdown(troubleshootingLink)}`;\n    default:\n      return;\n  }\n};\n"],"mappings":"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"}

package/dist/utils/index.cjs

@@ -0,0 +1,50 @@
+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_random_id = require('./random-id.cjs');
+const require_requests = require('./requests.cjs');
+
+//#region src/utils/index.ts
+/**
+* Safely parses a JSON string into an object
+* @param json The JSON string to parse
+* @param fallback Optional fallback value to return if parsing fails. If not provided or set to "unset", returns null
+* @returns The parsed JSON object, or the fallback value (or null) if parsing fails
+*/
+function parseJson(json, fallback = "unset") {
+	try {
+		return JSON.parse(json);
+	} catch (e) {
+		return fallback === "unset" ? null : fallback;
+	}
+}
+/**
+* Maps an array of items to a new array, skipping items that throw errors during mapping
+* @param items The array to map
+* @param callback The mapping function to apply to each item
+* @returns A new array containing only the successfully mapped items
+*/
+function tryMap(items, callback) {
+	return items.reduce((acc, item, index, array) => {
+		try {
+			acc.push(callback(item, index, array));
+		} catch (error) {
+			console.error(error);
+		}
+		return acc;
+	}, []);
+}
+/**
+* Checks if the current environment is macOS
+* @returns {boolean} True if running on macOS, false otherwise
+*/
+function isMacOS() {
+	return /Mac|iMac|Macintosh/i.test(navigator.userAgent);
+}
+
+//#endregion
+exports.isMacOS = isMacOS;
+exports.parseJson = parseJson;
+exports.tryMap = tryMap;
+//# sourceMappingURL=index.cjs.map

package/dist/utils/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":[],"sources":["../../src/utils/index.ts"],"sourcesContent":["export * from \"./conditions\";\nexport * from \"./console-styling\";\nexport * from \"./errors\";\nexport * from \"./json-schema\";\nexport * from \"./types\";\nexport * from \"./random-id\";\nexport * from \"./requests\";\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 * 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"],"mappings":";;;;;;;;;;;;;;AAcA,SAAgB,UAAU,MAAc,WAAgB,SAAS;AAC/D,KAAI;AACF,SAAO,KAAK,MAAM,KAAK;UAChB,GAAG;AACV,SAAO,aAAa,UAAU,OAAO;;;;;;;;;AAUzC,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"}

package/dist/utils/{index.d.ts → index.d.cts}

@@ -1,14 +1,12 @@
-export { BaseCondition, ComparisonCondition, ComparisonRule, Condition, ExistenceCondition, ExistenceRule, LogicalCondition, LogicalRule, Rule, executeConditions } from './conditions.js';
-export { ConsoleColors, ConsoleStyles, logCopilotKitPlatformMessage, logStyled, publicApiKeyRequired, styledConsole } from './console-styling.js';
-export { 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.js';
-export { JSONSchema, JSONSchemaArray, JSONSchemaBoolean, JSONSchemaNumber, JSONSchemaObject, JSONSchemaString, actionParametersToJsonSchema, convertJsonSchemaToZodSchema, getZodParameters, jsonSchemaToActionParameters } from './json-schema.js';
-export { AgentDescription, MaybePromise, NonEmptyRecord, RuntimeInfo } from './types.js';
-export { dataToUUID, isValidUUID, randomId, randomUUID } from './random-id.js';
-export { readBody } from './requests.js';
-import 'graphql';
-import 'zod';
-import '../types/action.js';
+import { BaseCondition, ComparisonCondition, ComparisonRule, Condition, ExistenceCondition, ExistenceRule, LogicalCondition, LogicalRule, Rule, executeConditions } from "./conditions.cjs";
+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 { AgentDescription, MaybePromise, NonEmptyRecord, RuntimeInfo } from "./types.cjs";
+import { dataToUUID, isValidUUID, randomId, randomUUID } from "./random-id.cjs";
+import { readBody } from "./requests.cjs";
 
+//#region src/utils/index.d.ts
 /**
  * Safely parses a JSON string into an object
  * @param json The JSON string to parse
@@ -28,5 +26,6 @@ declare function tryMap<TItem, TMapped>(items: TItem[], callback: (item: TItem,
  * @returns {boolean} True if running on macOS, false otherwise
  */
 declare function isMacOS(): boolean;
-
+//#endregion
 export { isMacOS, parseJson, tryMap };
+//# sourceMappingURL=index.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","names":[],"sources":["../../src/utils/index.ts"],"mappings":";;;;;;;;;;;AAcA;;;;iBAAgB,SAAA,CAAU,IAAA,UAAc,QAAA;AAcxC;;;;;;AAAA,iBAAgB,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"}