@copilotkit/shared 1.5.12-next.4 → 1.5.12-next.6

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../package.json","../src/index.ts"],"sourcesContent":["{\n  \"name\": \"@copilotkit/shared\",\n  \"private\": false,\n  \"homepage\": \"https://github.com/CopilotKit/CopilotKit\",\n  \"repository\": {\n    \"type\": \"git\",\n    \"url\": \"https://github.com/CopilotKit/CopilotKit.git\"\n  },\n  \"publishConfig\": {\n    \"access\": \"public\"\n  },\n  \"version\": \"1.5.12-next.4\",\n  \"sideEffects\": false,\n  \"main\": \"./dist/index.js\",\n  \"module\": \"./dist/index.mjs\",\n  \"exports\": {\n    \".\": {\n      \"import\": \"./dist/index.mjs\",\n      \"require\": \"./dist/index.js\",\n      \"types\": \"./dist/index.d.ts\"\n    }\n  },\n  \"types\": \"./dist/index.d.ts\",\n  \"license\": \"MIT\",\n  \"scripts\": {\n    \"build\": \"tsup --clean\",\n    \"dev\": \"tsup --watch --no-splitting\",\n    \"test\": \"jest --passWithNoTests\",\n    \"check-types\": \"tsc --noEmit\",\n    \"clean\": \"rm -rf .turbo && rm -rf node_modules && rm -rf dist && rm -rf .next\",\n    \"link:global\": \"pnpm link --global\",\n    \"unlink:global\": \"pnpm unlink --global\"\n  },\n  \"devDependencies\": {\n    \"@types/jest\": \"^29.5.4\",\n    \"@types/uuid\": \"^10.0.0\",\n    \"eslint\": \"^8.56.0\",\n    \"eslint-config-custom\": \"workspace:*\",\n    \"jest\": \"^29.6.4\",\n    \"ts-jest\": \"^29.1.1\",\n    \"tsconfig\": \"workspace:*\",\n    \"tsup\": \"^6.7.0\",\n    \"typescript\": \"^5.2.3\"\n  },\n  \"dependencies\": {\n    \"@segment/analytics-node\": \"^2.1.2\",\n    \"chalk\": \"4.1.2\",\n    \"uuid\": \"^10.0.0\",\n    \"zod\": \"^3.23.3\",\n    \"zod-to-json-schema\": \"^3.23.5\"\n  },\n  \"keywords\": [\n    \"copilotkit\",\n    \"copilot\",\n    \"react\",\n    \"nextjs\",\n    \"nodejs\",\n    \"ai\",\n    \"assistant\",\n    \"javascript\",\n    \"automation\",\n    \"textarea\"\n  ]\n}\n","export * from \"./types\";\nexport * from \"./utils\";\nexport * from \"./constants\";\nexport * from \"./telemetry\";\n\nimport * as packageJson from \"../package.json\";\nexport const COPILOTKIT_VERSION = packageJson.version;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAWE,cAAW;;;ACLN,IAAM,qBAAiC;","names":[]}
+{"version":3,"sources":["../package.json","../src/index.ts"],"sourcesContent":["{\n  \"name\": \"@copilotkit/shared\",\n  \"private\": false,\n  \"homepage\": \"https://github.com/CopilotKit/CopilotKit\",\n  \"repository\": {\n    \"type\": \"git\",\n    \"url\": \"https://github.com/CopilotKit/CopilotKit.git\"\n  },\n  \"publishConfig\": {\n    \"access\": \"public\"\n  },\n  \"version\": \"1.5.12-next.6\",\n  \"sideEffects\": false,\n  \"main\": \"./dist/index.js\",\n  \"module\": \"./dist/index.mjs\",\n  \"exports\": {\n    \".\": {\n      \"import\": \"./dist/index.mjs\",\n      \"require\": \"./dist/index.js\",\n      \"types\": \"./dist/index.d.ts\"\n    }\n  },\n  \"types\": \"./dist/index.d.ts\",\n  \"license\": \"MIT\",\n  \"scripts\": {\n    \"build\": \"tsup --clean\",\n    \"dev\": \"tsup --watch --no-splitting\",\n    \"test\": \"jest --passWithNoTests\",\n    \"check-types\": \"tsc --noEmit\",\n    \"clean\": \"rm -rf .turbo && rm -rf node_modules && rm -rf dist && rm -rf .next\",\n    \"link:global\": \"pnpm link --global\",\n    \"unlink:global\": \"pnpm unlink --global\"\n  },\n  \"devDependencies\": {\n    \"@types/jest\": \"^29.5.4\",\n    \"@types/uuid\": \"^10.0.0\",\n    \"eslint\": \"^8.56.0\",\n    \"eslint-config-custom\": \"workspace:*\",\n    \"jest\": \"^29.6.4\",\n    \"ts-jest\": \"^29.1.1\",\n    \"tsconfig\": \"workspace:*\",\n    \"tsup\": \"^6.7.0\",\n    \"typescript\": \"^5.2.3\"\n  },\n  \"dependencies\": {\n    \"@segment/analytics-node\": \"^2.1.2\",\n    \"chalk\": \"4.1.2\",\n    \"graphql\": \"^16.8.1\",\n    \"uuid\": \"^10.0.0\",\n    \"zod\": \"^3.23.3\",\n    \"zod-to-json-schema\": \"^3.23.5\"\n  },\n  \"keywords\": [\n    \"copilotkit\",\n    \"copilot\",\n    \"react\",\n    \"nextjs\",\n    \"nodejs\",\n    \"ai\",\n    \"assistant\",\n    \"javascript\",\n    \"automation\",\n    \"textarea\"\n  ]\n}\n","export * from \"./types\";\nexport * from \"./utils\";\nexport * from \"./constants\";\nexport * from \"./telemetry\";\n\nimport * as packageJson from \"../package.json\";\nexport const COPILOTKIT_VERSION = packageJson.version;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAWE,cAAW;;;ACLN,IAAM,qBAAiC;","names":[]}

package/dist/utils/errors.d.ts

@@ -0,0 +1,155 @@
+import { GraphQLError } from 'graphql';
+
+declare const ERROR_NAMES: {
+    readonly COPILOT_ERROR: "CopilotError";
+    readonly COPILOT_API_DISCOVERY_ERROR: "CopilotApiDiscoveryError";
+    readonly COPILOT_REMOTE_ENDPOINT_DISCOVERY_ERROR: "CopilotKitRemoteEndpointDiscoveryError";
+    readonly COPILOT_KIT_AGENT_DISCOVERY_ERROR: "CopilotKitAgentDiscoveryError";
+    readonly COPILOT_KIT_LOW_LEVEL_ERROR: "CopilotKitLowLevelError";
+    readonly RESOLVED_COPILOT_KIT_ERROR: "ResolvedCopilotKitError";
+};
+declare enum CopilotKitErrorCode {
+    NETWORK_ERROR = "NETWORK_ERROR",
+    NOT_FOUND = "NOT_FOUND",
+    AGENT_NOT_FOUND = "AGENT_NOT_FOUND",
+    API_NOT_FOUND = "API_NOT_FOUND",
+    REMOTE_ENDPOINT_NOT_FOUND = "REMOTE_ENDPOINT_NOT_FOUND",
+    MISUSE = "MISUSE",
+    UNKNOWN = "UNKNOWN"
+}
+declare const ERROR_CONFIG: {
+    NETWORK_ERROR: {
+        statusCode: number;
+        troubleshootingUrl: string;
+    };
+    NOT_FOUND: {
+        statusCode: number;
+        troubleshootingUrl: string;
+    };
+    AGENT_NOT_FOUND: {
+        statusCode: number;
+        troubleshootingUrl: string;
+    };
+    API_NOT_FOUND: {
+        statusCode: number;
+        troubleshootingUrl: string;
+    };
+    REMOTE_ENDPOINT_NOT_FOUND: {
+        statusCode: number;
+        troubleshootingUrl: string;
+    };
+    MISUSE: {
+        statusCode: number;
+        troubleshootingUrl: null;
+    };
+    UNKNOWN: {
+        statusCode: number;
+    };
+};
+declare class CopilotKitError extends GraphQLError {
+    code: CopilotKitErrorCode;
+    statusCode: number;
+    constructor({ message, code, }: {
+        message?: string;
+        code: CopilotKitErrorCode;
+    });
+}
+/**
+ * Error thrown when we can identify wrong usage of our components.
+ * This helps us notify the developer before real errors can happen
+ *
+ * @extends CopilotKitError
+ */
+declare class CopilotKitMisuseError extends CopilotKitError {
+    constructor({ message, code, }: {
+        message: string;
+        code?: CopilotKitErrorCode;
+    });
+}
+/**
+ * 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
+ */
+declare class CopilotKitApiDiscoveryError extends CopilotKitError {
+    constructor(params?: {
+        message?: string;
+        code?: CopilotKitErrorCode.API_NOT_FOUND | CopilotKitErrorCode.REMOTE_ENDPOINT_NOT_FOUND;
+    });
+}
+/**
+ * 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
+ */
+declare class CopilotKitRemoteEndpointDiscoveryError extends CopilotKitApiDiscoveryError {
+    constructor(params?: {
+        message?: string;
+    });
+}
+/**
+ * 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
+ */
+declare class CopilotKitAgentDiscoveryError extends CopilotKitError {
+    constructor(params?: {
+        agentName?: string;
+    });
+}
+/**
+ * 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
+ */
+declare class CopilotKitLowLevelError extends CopilotKitError {
+    constructor({ error, url, message }: {
+        error: Error;
+        url: string;
+        message?: string;
+    });
+}
+/**
+ * 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
+ */
+declare class ResolvedCopilotKitError extends CopilotKitError {
+    constructor({ status, message, code, isRemoteEndpoint, }: {
+        status: number;
+        message?: string;
+        code?: CopilotKitErrorCode;
+        isRemoteEndpoint?: boolean;
+    });
+}
+
+export { CopilotKitAgentDiscoveryError, CopilotKitApiDiscoveryError, CopilotKitError, CopilotKitErrorCode, CopilotKitLowLevelError, CopilotKitMisuseError, CopilotKitRemoteEndpointDiscoveryError, ERROR_CONFIG, ERROR_NAMES, ResolvedCopilotKitError };

package/dist/utils/errors.js

@@ -0,0 +1,221 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/utils/errors.ts
+var errors_exports = {};
+__export(errors_exports, {
+  CopilotKitAgentDiscoveryError: () => CopilotKitAgentDiscoveryError,
+  CopilotKitApiDiscoveryError: () => CopilotKitApiDiscoveryError,
+  CopilotKitError: () => CopilotKitError,
+  CopilotKitErrorCode: () => CopilotKitErrorCode,
+  CopilotKitLowLevelError: () => CopilotKitLowLevelError,
+  CopilotKitMisuseError: () => CopilotKitMisuseError,
+  CopilotKitRemoteEndpointDiscoveryError: () => CopilotKitRemoteEndpointDiscoveryError,
+  ERROR_CONFIG: () => ERROR_CONFIG,
+  ERROR_NAMES: () => ERROR_NAMES,
+  ResolvedCopilotKitError: () => ResolvedCopilotKitError
+});
+module.exports = __toCommonJS(errors_exports);
+var import_graphql = require("graphql");
+var 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",
+  RESOLVED_COPILOT_KIT_ERROR: "ResolvedCopilotKitError"
+};
+var CopilotKitErrorCode = /* @__PURE__ */ ((CopilotKitErrorCode2) => {
+  CopilotKitErrorCode2["NETWORK_ERROR"] = "NETWORK_ERROR";
+  CopilotKitErrorCode2["NOT_FOUND"] = "NOT_FOUND";
+  CopilotKitErrorCode2["AGENT_NOT_FOUND"] = "AGENT_NOT_FOUND";
+  CopilotKitErrorCode2["API_NOT_FOUND"] = "API_NOT_FOUND";
+  CopilotKitErrorCode2["REMOTE_ENDPOINT_NOT_FOUND"] = "REMOTE_ENDPOINT_NOT_FOUND";
+  CopilotKitErrorCode2["MISUSE"] = "MISUSE";
+  CopilotKitErrorCode2["UNKNOWN"] = "UNKNOWN";
+  return CopilotKitErrorCode2;
+})(CopilotKitErrorCode || {});
+var BASE_URL = "https://docs.copilotkit.ai";
+var getSeeMoreMarkdown = (link) => `See more: [${link}](${link})`;
+var ERROR_CONFIG = {
+  ["NETWORK_ERROR" /* NETWORK_ERROR */]: {
+    statusCode: 503,
+    troubleshootingUrl: `${BASE_URL}/troubleshooting/common-issues#i-am-getting-a-network-errors--api-not-found`
+  },
+  ["NOT_FOUND" /* NOT_FOUND */]: {
+    statusCode: 404,
+    troubleshootingUrl: `${BASE_URL}/troubleshooting/common-issues#i-am-getting-a-network-errors--api-not-found`
+  },
+  ["AGENT_NOT_FOUND" /* AGENT_NOT_FOUND */]: {
+    statusCode: 500,
+    troubleshootingUrl: `${BASE_URL}/coagents/troubleshooting/common-issues#i-am-getting-agent-not-found-error`
+  },
+  ["API_NOT_FOUND" /* API_NOT_FOUND */]: {
+    statusCode: 404,
+    troubleshootingUrl: `${BASE_URL}/troubleshooting/common-issues#i-am-getting-a-network-errors--api-not-found`
+  },
+  ["REMOTE_ENDPOINT_NOT_FOUND" /* REMOTE_ENDPOINT_NOT_FOUND */]: {
+    statusCode: 404,
+    troubleshootingUrl: `${BASE_URL}/troubleshooting/common-issues#i-am-getting-copilotkits-remote-endpoint-not-found-error`
+  },
+  ["MISUSE" /* MISUSE */]: {
+    statusCode: 400,
+    troubleshootingUrl: null
+  },
+  ["UNKNOWN" /* UNKNOWN */]: {
+    statusCode: 500
+  }
+};
+var CopilotKitError = class extends import_graphql.GraphQLError {
+  constructor({
+    message = "Unknown error occurred",
+    code
+  }) {
+    const name = ERROR_NAMES.COPILOT_ERROR;
+    const { statusCode } = ERROR_CONFIG[code];
+    super(message, {
+      extensions: {
+        name,
+        statusCode
+      }
+    });
+    this.code = code;
+    this.name = name;
+    this.statusCode = statusCode;
+  }
+};
+var CopilotKitMisuseError = class extends CopilotKitError {
+  constructor({
+    message,
+    code = "MISUSE" /* MISUSE */
+  }) {
+    const docsLink = "troubleshootingUrl" in ERROR_CONFIG[code] ? getSeeMoreMarkdown(ERROR_CONFIG[code].troubleshootingUrl) : null;
+    const finalMessage = docsLink ? `${message}.
+
+${docsLink}` : message;
+    super({ message: finalMessage, code });
+    this.name = ERROR_NAMES.COPILOT_API_DISCOVERY_ERROR;
+  }
+};
+var CopilotKitApiDiscoveryError = class extends CopilotKitError {
+  constructor(params = {}) {
+    const message = params.message ?? "Failed to find CopilotKit API endpoint";
+    const code = params.code ?? "API_NOT_FOUND" /* API_NOT_FOUND */;
+    const errorMessage = `${message}.
+
+${getSeeMoreMarkdown(ERROR_CONFIG[code].troubleshootingUrl)}`;
+    super({ message: errorMessage, code });
+    this.name = ERROR_NAMES.COPILOT_API_DISCOVERY_ERROR;
+  }
+};
+var CopilotKitRemoteEndpointDiscoveryError = class extends CopilotKitApiDiscoveryError {
+  constructor(params) {
+    const message = (params == null ? void 0 : params.message) ?? "Failed to find or contact remote endpoint";
+    const code = "REMOTE_ENDPOINT_NOT_FOUND" /* REMOTE_ENDPOINT_NOT_FOUND */;
+    super({ message, code });
+    this.name = ERROR_NAMES.COPILOT_REMOTE_ENDPOINT_DISCOVERY_ERROR;
+  }
+};
+var CopilotKitAgentDiscoveryError = class extends CopilotKitError {
+  constructor(params) {
+    const code = "AGENT_NOT_FOUND" /* AGENT_NOT_FOUND */;
+    const baseMessage = "Failed to find agent";
+    const configMessage = "Please verify the agent name exists and is properly configured.";
+    const finalMessage = (params == null ? void 0 : params.agentName) ? `${baseMessage} '${params.agentName}'. ${configMessage}
+
+${getSeeMoreMarkdown(ERROR_CONFIG[code].troubleshootingUrl)}` : `${baseMessage}. ${configMessage}
+
+${getSeeMoreMarkdown(ERROR_CONFIG[code].troubleshootingUrl)}`;
+    super({ message: finalMessage || finalMessage, code });
+    this.name = ERROR_NAMES.COPILOT_KIT_AGENT_DISCOVERY_ERROR;
+  }
+};
+var CopilotKitLowLevelError = class extends CopilotKitError {
+  constructor({ error, url, message }) {
+    let code = "NETWORK_ERROR" /* NETWORK_ERROR */;
+    const getMessageByCode = (errorCode) => {
+      const troubleshootingLink = ERROR_CONFIG[code].troubleshootingUrl;
+      switch (errorCode) {
+        case "ECONNREFUSED":
+          return `Connection to ${url} was refused. Ensure the server is running and accessible.
+
+${getSeeMoreMarkdown(troubleshootingLink)}`;
+        case "ENOTFOUND":
+          return `The server on ${url} could not be found. Check the URL or your network configuration.
+
+${getSeeMoreMarkdown(ERROR_CONFIG["NOT_FOUND" /* NOT_FOUND */].troubleshootingUrl)}`;
+        case "ETIMEDOUT":
+          return `The connection to ${url} timed out. The server might be overloaded or taking too long to respond.
+
+${getSeeMoreMarkdown(troubleshootingLink)}`;
+        default:
+          return `Failed to fetch from url ${url}.
+
+Possible reasons:
+- -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)}`;
+      }
+    };
+    const errorMessage = message ?? getMessageByCode(error.code);
+    super({ message: errorMessage, code });
+    this.name = ERROR_NAMES.COPILOT_KIT_LOW_LEVEL_ERROR;
+  }
+};
+var ResolvedCopilotKitError = class extends CopilotKitError {
+  constructor({
+    status,
+    message,
+    code,
+    isRemoteEndpoint
+  }) {
+    let resolvedCode = code;
+    if (!resolvedCode) {
+      switch (status) {
+        case 400:
+          throw new CopilotKitApiDiscoveryError({ message });
+        case 404:
+          throw isRemoteEndpoint ? new CopilotKitRemoteEndpointDiscoveryError({ message }) : new CopilotKitApiDiscoveryError({ message });
+        default:
+          resolvedCode = "UNKNOWN" /* UNKNOWN */;
+          super({ message, code: resolvedCode });
+      }
+    } else {
+      super({ message, code: resolvedCode });
+    }
+    this.name = ERROR_NAMES.RESOLVED_COPILOT_KIT_ERROR;
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  CopilotKitAgentDiscoveryError,
+  CopilotKitApiDiscoveryError,
+  CopilotKitError,
+  CopilotKitErrorCode,
+  CopilotKitLowLevelError,
+  CopilotKitMisuseError,
+  CopilotKitRemoteEndpointDiscoveryError,
+  ERROR_CONFIG,
+  ERROR_NAMES,
+  ResolvedCopilotKitError
+});
+//# sourceMappingURL=errors.js.map

package/dist/utils/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils/errors.ts"],"sourcesContent":["import { GraphQLError } from \"graphql\";\n\nexport const ERROR_NAMES = {\n  COPILOT_ERROR: \"CopilotError\",\n  COPILOT_API_DISCOVERY_ERROR: \"CopilotApiDiscoveryError\",\n  COPILOT_REMOTE_ENDPOINT_DISCOVERY_ERROR: \"CopilotKitRemoteEndpointDiscoveryError\",\n  COPILOT_KIT_AGENT_DISCOVERY_ERROR: \"CopilotKitAgentDiscoveryError\",\n  COPILOT_KIT_LOW_LEVEL_ERROR: \"CopilotKitLowLevelError\",\n  RESOLVED_COPILOT_KIT_ERROR: \"ResolvedCopilotKitError\",\n} as const;\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  MISUSE = \"MISUSE\",\n  UNKNOWN = \"UNKNOWN\",\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  },\n  [CopilotKitErrorCode.NOT_FOUND]: {\n    statusCode: 404,\n    troubleshootingUrl: `${BASE_URL}/troubleshooting/common-issues#i-am-getting-a-network-errors--api-not-found`,\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  },\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  },\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  },\n  [CopilotKitErrorCode.MISUSE]: {\n    statusCode: 400,\n    troubleshootingUrl: null,\n  },\n  [CopilotKitErrorCode.UNKNOWN]: {\n    statusCode: 500,\n  },\n};\n\nexport class CopilotKitError extends GraphQLError {\n  code: CopilotKitErrorCode;\n  statusCode: number;\n\n  constructor({\n    message = \"Unknown error occurred\",\n    code,\n  }: {\n    message?: string;\n    code: CopilotKitErrorCode;\n  }) {\n    const name = ERROR_NAMES.COPILOT_ERROR;\n    const { statusCode } = ERROR_CONFIG[code];\n\n    super(message, {\n      extensions: {\n        name,\n        statusCode,\n      },\n    });\n    this.code = code;\n    this.name = name;\n    this.statusCode = statusCode;\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        ? 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\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?: CopilotKitErrorCode.API_NOT_FOUND | CopilotKitErrorCode.REMOTE_ENDPOINT_NOT_FOUND;\n    } = {},\n  ) {\n    const message = params.message ?? \"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 }) {\n    const message = params?.message ?? \"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?: { agentName?: string }) {\n    const code = CopilotKitErrorCode.AGENT_NOT_FOUND;\n    const baseMessage = \"Failed to find agent\";\n    const configMessage = \"Please verify the agent name exists and is properly configured.\";\n    const finalMessage = params?.agentName\n      ? `${baseMessage} '${params.agentName}'. ${configMessage}\\n\\n${getSeeMoreMarkdown(ERROR_CONFIG[code].troubleshootingUrl)}`\n      : `${baseMessage}. ${configMessage}\\n\\n${getSeeMoreMarkdown(ERROR_CONFIG[code].troubleshootingUrl)}`;\n    super({ message: finalMessage || finalMessage, 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({ error, url, message }: { error: Error; url: string; message?: string }) {\n    let code = CopilotKitErrorCode.NETWORK_ERROR;\n\n    const getMessageByCode = (errorCode?: string) => {\n      const troubleshootingLink = ERROR_CONFIG[code].troubleshootingUrl;\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 `Failed to fetch from url ${url}.\n\nPossible reasons:\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    };\n    // @ts-expect-error -- code may exist\n    const errorMessage = message ?? getMessageByCode(error.code as string);\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  }: {\n    status: number;\n    message?: string;\n    code?: CopilotKitErrorCode;\n    isRemoteEndpoint?: boolean;\n  }) {\n    let resolvedCode = code;\n    if (!resolvedCode) {\n      switch (status) {\n        case 400:\n          throw new CopilotKitApiDiscoveryError({ message });\n        case 404:\n          throw isRemoteEndpoint\n            ? new CopilotKitRemoteEndpointDiscoveryError({ message })\n            : new CopilotKitApiDiscoveryError({ message });\n        default:\n          resolvedCode = CopilotKitErrorCode.UNKNOWN;\n          super({ message, code: resolvedCode });\n      }\n    } else {\n      super({ message, code: resolvedCode });\n    }\n    this.name = ERROR_NAMES.RESOLVED_COPILOT_KIT_ERROR;\n  }\n}\n"],"mappings":"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","names":["CopilotKitErrorCode"]}

package/dist/utils/errors.mjs

@@ -0,0 +1,25 @@
+import {
+  CopilotKitAgentDiscoveryError,
+  CopilotKitApiDiscoveryError,
+  CopilotKitError,
+  CopilotKitErrorCode,
+  CopilotKitLowLevelError,
+  CopilotKitMisuseError,
+  CopilotKitRemoteEndpointDiscoveryError,
+  ERROR_CONFIG,
+  ERROR_NAMES,
+  ResolvedCopilotKitError
+} from "../chunk-J22F46VT.mjs";
+export {
+  CopilotKitAgentDiscoveryError,
+  CopilotKitApiDiscoveryError,
+  CopilotKitError,
+  CopilotKitErrorCode,
+  CopilotKitLowLevelError,
+  CopilotKitMisuseError,
+  CopilotKitRemoteEndpointDiscoveryError,
+  ERROR_CONFIG,
+  ERROR_NAMES,
+  ResolvedCopilotKitError
+};
+//# sourceMappingURL=errors.mjs.map

package/dist/utils/errors.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/utils/index.d.ts

@@ -1,4 +1,6 @@
+export { CopilotKitAgentDiscoveryError, CopilotKitApiDiscoveryError, CopilotKitError, CopilotKitErrorCode, CopilotKitLowLevelError, CopilotKitMisuseError, CopilotKitRemoteEndpointDiscoveryError, ERROR_CONFIG, ERROR_NAMES, ResolvedCopilotKitError } from './errors.js';
 export { JSONSchema, JSONSchemaArray, JSONSchemaBoolean, JSONSchemaNumber, JSONSchemaObject, JSONSchemaString, actionParametersToJsonSchema, convertJsonSchemaToZodSchema } from './json-schema.js';
 export { randomId } from './random-id.js';
+import 'graphql';
 import 'zod';
 import '../types/action.js';

package/dist/utils/index.js

@@ -20,12 +20,197 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/utils/index.ts
 var utils_exports = {};
 __export(utils_exports, {
+  CopilotKitAgentDiscoveryError: () => CopilotKitAgentDiscoveryError,
+  CopilotKitApiDiscoveryError: () => CopilotKitApiDiscoveryError,
+  CopilotKitError: () => CopilotKitError,
+  CopilotKitErrorCode: () => CopilotKitErrorCode,
+  CopilotKitLowLevelError: () => CopilotKitLowLevelError,
+  CopilotKitMisuseError: () => CopilotKitMisuseError,
+  CopilotKitRemoteEndpointDiscoveryError: () => CopilotKitRemoteEndpointDiscoveryError,
+  ERROR_CONFIG: () => ERROR_CONFIG,
+  ERROR_NAMES: () => ERROR_NAMES,
+  ResolvedCopilotKitError: () => ResolvedCopilotKitError,
   actionParametersToJsonSchema: () => actionParametersToJsonSchema,
   convertJsonSchemaToZodSchema: () => convertJsonSchemaToZodSchema,
   randomId: () => randomId
 });
 module.exports = __toCommonJS(utils_exports);
 
+// src/utils/errors.ts
+var import_graphql = require("graphql");
+var 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",
+  RESOLVED_COPILOT_KIT_ERROR: "ResolvedCopilotKitError"
+};
+var CopilotKitErrorCode = /* @__PURE__ */ ((CopilotKitErrorCode2) => {
+  CopilotKitErrorCode2["NETWORK_ERROR"] = "NETWORK_ERROR";
+  CopilotKitErrorCode2["NOT_FOUND"] = "NOT_FOUND";
+  CopilotKitErrorCode2["AGENT_NOT_FOUND"] = "AGENT_NOT_FOUND";
+  CopilotKitErrorCode2["API_NOT_FOUND"] = "API_NOT_FOUND";
+  CopilotKitErrorCode2["REMOTE_ENDPOINT_NOT_FOUND"] = "REMOTE_ENDPOINT_NOT_FOUND";
+  CopilotKitErrorCode2["MISUSE"] = "MISUSE";
+  CopilotKitErrorCode2["UNKNOWN"] = "UNKNOWN";
+  return CopilotKitErrorCode2;
+})(CopilotKitErrorCode || {});
+var BASE_URL = "https://docs.copilotkit.ai";
+var getSeeMoreMarkdown = (link) => `See more: [${link}](${link})`;
+var ERROR_CONFIG = {
+  ["NETWORK_ERROR" /* NETWORK_ERROR */]: {
+    statusCode: 503,
+    troubleshootingUrl: `${BASE_URL}/troubleshooting/common-issues#i-am-getting-a-network-errors--api-not-found`
+  },
+  ["NOT_FOUND" /* NOT_FOUND */]: {
+    statusCode: 404,
+    troubleshootingUrl: `${BASE_URL}/troubleshooting/common-issues#i-am-getting-a-network-errors--api-not-found`
+  },
+  ["AGENT_NOT_FOUND" /* AGENT_NOT_FOUND */]: {
+    statusCode: 500,
+    troubleshootingUrl: `${BASE_URL}/coagents/troubleshooting/common-issues#i-am-getting-agent-not-found-error`
+  },
+  ["API_NOT_FOUND" /* API_NOT_FOUND */]: {
+    statusCode: 404,
+    troubleshootingUrl: `${BASE_URL}/troubleshooting/common-issues#i-am-getting-a-network-errors--api-not-found`
+  },
+  ["REMOTE_ENDPOINT_NOT_FOUND" /* REMOTE_ENDPOINT_NOT_FOUND */]: {
+    statusCode: 404,
+    troubleshootingUrl: `${BASE_URL}/troubleshooting/common-issues#i-am-getting-copilotkits-remote-endpoint-not-found-error`
+  },
+  ["MISUSE" /* MISUSE */]: {
+    statusCode: 400,
+    troubleshootingUrl: null
+  },
+  ["UNKNOWN" /* UNKNOWN */]: {
+    statusCode: 500
+  }
+};
+var CopilotKitError = class extends import_graphql.GraphQLError {
+  constructor({
+    message = "Unknown error occurred",
+    code
+  }) {
+    const name = ERROR_NAMES.COPILOT_ERROR;
+    const { statusCode } = ERROR_CONFIG[code];
+    super(message, {
+      extensions: {
+        name,
+        statusCode
+      }
+    });
+    this.code = code;
+    this.name = name;
+    this.statusCode = statusCode;
+  }
+};
+var CopilotKitMisuseError = class extends CopilotKitError {
+  constructor({
+    message,
+    code = "MISUSE" /* MISUSE */
+  }) {
+    const docsLink = "troubleshootingUrl" in ERROR_CONFIG[code] ? getSeeMoreMarkdown(ERROR_CONFIG[code].troubleshootingUrl) : null;
+    const finalMessage = docsLink ? `${message}.
+
+${docsLink}` : message;
+    super({ message: finalMessage, code });
+    this.name = ERROR_NAMES.COPILOT_API_DISCOVERY_ERROR;
+  }
+};
+var CopilotKitApiDiscoveryError = class extends CopilotKitError {
+  constructor(params = {}) {
+    const message = params.message ?? "Failed to find CopilotKit API endpoint";
+    const code = params.code ?? "API_NOT_FOUND" /* API_NOT_FOUND */;
+    const errorMessage = `${message}.
+
+${getSeeMoreMarkdown(ERROR_CONFIG[code].troubleshootingUrl)}`;
+    super({ message: errorMessage, code });
+    this.name = ERROR_NAMES.COPILOT_API_DISCOVERY_ERROR;
+  }
+};
+var CopilotKitRemoteEndpointDiscoveryError = class extends CopilotKitApiDiscoveryError {
+  constructor(params) {
+    const message = (params == null ? void 0 : params.message) ?? "Failed to find or contact remote endpoint";
+    const code = "REMOTE_ENDPOINT_NOT_FOUND" /* REMOTE_ENDPOINT_NOT_FOUND */;
+    super({ message, code });
+    this.name = ERROR_NAMES.COPILOT_REMOTE_ENDPOINT_DISCOVERY_ERROR;
+  }
+};
+var CopilotKitAgentDiscoveryError = class extends CopilotKitError {
+  constructor(params) {
+    const code = "AGENT_NOT_FOUND" /* AGENT_NOT_FOUND */;
+    const baseMessage = "Failed to find agent";
+    const configMessage = "Please verify the agent name exists and is properly configured.";
+    const finalMessage = (params == null ? void 0 : params.agentName) ? `${baseMessage} '${params.agentName}'. ${configMessage}
+
+${getSeeMoreMarkdown(ERROR_CONFIG[code].troubleshootingUrl)}` : `${baseMessage}. ${configMessage}
+
+${getSeeMoreMarkdown(ERROR_CONFIG[code].troubleshootingUrl)}`;
+    super({ message: finalMessage || finalMessage, code });
+    this.name = ERROR_NAMES.COPILOT_KIT_AGENT_DISCOVERY_ERROR;
+  }
+};
+var CopilotKitLowLevelError = class extends CopilotKitError {
+  constructor({ error, url, message }) {
+    let code = "NETWORK_ERROR" /* NETWORK_ERROR */;
+    const getMessageByCode = (errorCode) => {
+      const troubleshootingLink = ERROR_CONFIG[code].troubleshootingUrl;
+      switch (errorCode) {
+        case "ECONNREFUSED":
+          return `Connection to ${url} was refused. Ensure the server is running and accessible.
+
+${getSeeMoreMarkdown(troubleshootingLink)}`;
+        case "ENOTFOUND":
+          return `The server on ${url} could not be found. Check the URL or your network configuration.
+
+${getSeeMoreMarkdown(ERROR_CONFIG["NOT_FOUND" /* NOT_FOUND */].troubleshootingUrl)}`;
+        case "ETIMEDOUT":
+          return `The connection to ${url} timed out. The server might be overloaded or taking too long to respond.
+
+${getSeeMoreMarkdown(troubleshootingLink)}`;
+        default:
+          return `Failed to fetch from url ${url}.
+
+Possible reasons:
+- -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)}`;
+      }
+    };
+    const errorMessage = message ?? getMessageByCode(error.code);
+    super({ message: errorMessage, code });
+    this.name = ERROR_NAMES.COPILOT_KIT_LOW_LEVEL_ERROR;
+  }
+};
+var ResolvedCopilotKitError = class extends CopilotKitError {
+  constructor({
+    status,
+    message,
+    code,
+    isRemoteEndpoint
+  }) {
+    let resolvedCode = code;
+    if (!resolvedCode) {
+      switch (status) {
+        case 400:
+          throw new CopilotKitApiDiscoveryError({ message });
+        case 404:
+          throw isRemoteEndpoint ? new CopilotKitRemoteEndpointDiscoveryError({ message }) : new CopilotKitApiDiscoveryError({ message });
+        default:
+          resolvedCode = "UNKNOWN" /* UNKNOWN */;
+          super({ message, code: resolvedCode });
+      }
+    } else {
+      super({ message, code: resolvedCode });
+    }
+    this.name = ERROR_NAMES.RESOLVED_COPILOT_KIT_ERROR;
+  }
+};
+
 // src/utils/json-schema.ts
 var import_zod = require("zod");
 function actionParametersToJsonSchema(actionParameters) {
@@ -140,6 +325,16 @@ function randomId() {
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  CopilotKitAgentDiscoveryError,
+  CopilotKitApiDiscoveryError,
+  CopilotKitError,
+  CopilotKitErrorCode,
+  CopilotKitLowLevelError,
+  CopilotKitMisuseError,
+  CopilotKitRemoteEndpointDiscoveryError,
+  ERROR_CONFIG,
+  ERROR_NAMES,
+  ResolvedCopilotKitError,
   actionParametersToJsonSchema,
   convertJsonSchemaToZodSchema,
   randomId