@copilotkit/shared 1.51.4 → 1.51.5-next.1

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

@@ -1,128 +1,139 @@
-import { GraphQLError } from 'graphql';
+import { GraphQLError } from "graphql";
 
+//#region src/utils/errors.d.ts
 declare enum Severity {
-    CRITICAL = "critical",// Critical errors that block core functionality
-    WARNING = "warning",// Configuration/setup issues that need attention
-    INFO = "info"
+  CRITICAL = "critical",
+  // Critical errors that block core functionality
+  WARNING = "warning",
+  // Configuration/setup issues that need attention
+  INFO = "info"
 }
 declare enum ErrorVisibility {
-    BANNER = "banner",// Critical errors shown as fixed banners
-    TOAST = "toast",// Regular errors shown as dismissible toasts
-    SILENT = "silent",// Errors logged but not shown to user
-    DEV_ONLY = "dev_only"
+  BANNER = "banner",
+  // Critical errors shown as fixed banners
+  TOAST = "toast",
+  // Regular errors shown as dismissible toasts
+  SILENT = "silent",
+  // Errors logged but not shown to user
+  DEV_ONLY = "dev_only"
 }
 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 COPILOT_KIT_VERSION_MISMATCH_ERROR: "CopilotKitVersionMismatchError";
-    readonly RESOLVED_COPILOT_KIT_ERROR: "ResolvedCopilotKitError";
-    readonly CONFIGURATION_ERROR: "ConfigurationError";
-    readonly MISSING_PUBLIC_API_KEY_ERROR: "MissingPublicApiKeyError";
-    readonly UPGRADE_REQUIRED_ERROR: "UpgradeRequiredError";
+  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 COPILOT_KIT_VERSION_MISMATCH_ERROR: "CopilotKitVersionMismatchError";
+  readonly RESOLVED_COPILOT_KIT_ERROR: "ResolvedCopilotKitError";
+  readonly CONFIGURATION_ERROR: "ConfigurationError";
+  readonly MISSING_PUBLIC_API_KEY_ERROR: "MissingPublicApiKeyError";
+  readonly UPGRADE_REQUIRED_ERROR: "UpgradeRequiredError";
 };
 declare const BANNER_ERROR_NAMES: ("CopilotApiDiscoveryError" | "CopilotKitRemoteEndpointDiscoveryError" | "CopilotKitAgentDiscoveryError" | "ConfigurationError" | "MissingPublicApiKeyError" | "UpgradeRequiredError")[];
 declare const COPILOT_CLOUD_ERROR_NAMES: ("CopilotApiDiscoveryError" | "CopilotKitRemoteEndpointDiscoveryError" | "CopilotKitAgentDiscoveryError" | "ConfigurationError" | "MissingPublicApiKeyError" | "UpgradeRequiredError")[];
 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",
-    AUTHENTICATION_ERROR = "AUTHENTICATION_ERROR",
-    MISUSE = "MISUSE",
-    UNKNOWN = "UNKNOWN",
-    VERSION_MISMATCH = "VERSION_MISMATCH",
-    CONFIGURATION_ERROR = "CONFIGURATION_ERROR",
-    MISSING_PUBLIC_API_KEY_ERROR = "MISSING_PUBLIC_API_KEY_ERROR",
-    UPGRADE_REQUIRED_ERROR = "UPGRADE_REQUIRED_ERROR"
+  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",
+  AUTHENTICATION_ERROR = "AUTHENTICATION_ERROR",
+  MISUSE = "MISUSE",
+  UNKNOWN = "UNKNOWN",
+  VERSION_MISMATCH = "VERSION_MISMATCH",
+  CONFIGURATION_ERROR = "CONFIGURATION_ERROR",
+  MISSING_PUBLIC_API_KEY_ERROR = "MISSING_PUBLIC_API_KEY_ERROR",
+  UPGRADE_REQUIRED_ERROR = "UPGRADE_REQUIRED_ERROR"
 }
 declare const ERROR_CONFIG: {
-    NETWORK_ERROR: {
-        statusCode: number;
-        troubleshootingUrl: string;
-        visibility: ErrorVisibility;
-        severity: Severity;
-    };
-    NOT_FOUND: {
-        statusCode: number;
-        troubleshootingUrl: string;
-        visibility: ErrorVisibility;
-        severity: Severity;
-    };
-    AGENT_NOT_FOUND: {
-        statusCode: number;
-        troubleshootingUrl: string;
-        visibility: ErrorVisibility;
-        severity: Severity;
-    };
-    API_NOT_FOUND: {
-        statusCode: number;
-        troubleshootingUrl: string;
-        visibility: ErrorVisibility;
-        severity: Severity;
-    };
-    REMOTE_ENDPOINT_NOT_FOUND: {
-        statusCode: number;
-        troubleshootingUrl: string;
-        visibility: ErrorVisibility;
-        severity: Severity;
-    };
-    AUTHENTICATION_ERROR: {
-        statusCode: number;
-        troubleshootingUrl: string;
-        visibility: ErrorVisibility;
-        severity: Severity;
-    };
-    MISUSE: {
-        statusCode: number;
-        troubleshootingUrl: null;
-        visibility: ErrorVisibility;
-        severity: Severity;
-    };
-    UNKNOWN: {
-        statusCode: number;
-        visibility: ErrorVisibility;
-        severity: Severity;
-    };
-    CONFIGURATION_ERROR: {
-        statusCode: number;
-        troubleshootingUrl: null;
-        severity: Severity;
-        visibility: ErrorVisibility;
-    };
-    MISSING_PUBLIC_API_KEY_ERROR: {
-        statusCode: number;
-        troubleshootingUrl: null;
-        severity: Severity;
-        visibility: ErrorVisibility;
-    };
-    UPGRADE_REQUIRED_ERROR: {
-        statusCode: number;
-        troubleshootingUrl: null;
-        severity: Severity;
-        visibility: ErrorVisibility;
-    };
-    VERSION_MISMATCH: {
-        statusCode: number;
-        troubleshootingUrl: null;
-        visibility: ErrorVisibility;
-        severity: Severity;
-    };
+  NETWORK_ERROR: {
+    statusCode: number;
+    troubleshootingUrl: string;
+    visibility: ErrorVisibility;
+    severity: Severity;
+  };
+  NOT_FOUND: {
+    statusCode: number;
+    troubleshootingUrl: string;
+    visibility: ErrorVisibility;
+    severity: Severity;
+  };
+  AGENT_NOT_FOUND: {
+    statusCode: number;
+    troubleshootingUrl: string;
+    visibility: ErrorVisibility;
+    severity: Severity;
+  };
+  API_NOT_FOUND: {
+    statusCode: number;
+    troubleshootingUrl: string;
+    visibility: ErrorVisibility;
+    severity: Severity;
+  };
+  REMOTE_ENDPOINT_NOT_FOUND: {
+    statusCode: number;
+    troubleshootingUrl: string;
+    visibility: ErrorVisibility;
+    severity: Severity;
+  };
+  AUTHENTICATION_ERROR: {
+    statusCode: number;
+    troubleshootingUrl: string;
+    visibility: ErrorVisibility;
+    severity: Severity;
+  };
+  MISUSE: {
+    statusCode: number;
+    troubleshootingUrl: null;
+    visibility: ErrorVisibility;
+    severity: Severity;
+  };
+  UNKNOWN: {
+    statusCode: number;
+    visibility: ErrorVisibility;
+    severity: Severity;
+  };
+  CONFIGURATION_ERROR: {
+    statusCode: number;
+    troubleshootingUrl: null;
+    severity: Severity;
+    visibility: ErrorVisibility;
+  };
+  MISSING_PUBLIC_API_KEY_ERROR: {
+    statusCode: number;
+    troubleshootingUrl: null;
+    severity: Severity;
+    visibility: ErrorVisibility;
+  };
+  UPGRADE_REQUIRED_ERROR: {
+    statusCode: number;
+    troubleshootingUrl: null;
+    severity: Severity;
+    visibility: ErrorVisibility;
+  };
+  VERSION_MISMATCH: {
+    statusCode: number;
+    troubleshootingUrl: null;
+    visibility: ErrorVisibility;
+    severity: Severity;
+  };
 };
 declare class CopilotKitError extends GraphQLError {
+  code: CopilotKitErrorCode;
+  statusCode: number;
+  severity?: Severity;
+  visibility: ErrorVisibility;
+  constructor({
+    message,
+    code,
+    severity,
+    visibility
+  }: {
+    message?: string;
     code: CopilotKitErrorCode;
-    statusCode: number;
     severity?: Severity;
-    visibility: ErrorVisibility;
-    constructor({ message, code, severity, visibility, }: {
-        message?: string;
-        code: CopilotKitErrorCode;
-        severity?: Severity;
-        visibility?: ErrorVisibility;
-    });
+    visibility?: ErrorVisibility;
+  });
 }
 /**
  * Error thrown when we can identify wrong usage of our components.
@@ -131,10 +142,13 @@ declare class CopilotKitError extends GraphQLError {
  * @extends CopilotKitError
  */
 declare class CopilotKitMisuseError extends CopilotKitError {
-    constructor({ message, code, }: {
-        message: string;
-        code?: CopilotKitErrorCode;
-    });
+  constructor({
+    message,
+    code
+  }: {
+    message: string;
+    code?: CopilotKitErrorCode;
+  });
 }
 /**
  * Error thrown when CPK versions does not match
@@ -142,7 +156,11 @@ declare class CopilotKitMisuseError extends CopilotKitError {
  * @extends CopilotKitError
  */
 declare class CopilotKitVersionMismatchError extends CopilotKitError {
-    constructor({ reactCoreVersion, runtimeVersion, runtimeClientGqlVersion, }: VersionMismatchResponse);
+  constructor({
+    reactCoreVersion,
+    runtimeVersion,
+    runtimeClientGqlVersion
+  }: VersionMismatchResponse);
 }
 /**
  * Error thrown when the CopilotKit API endpoint cannot be discovered or accessed.
@@ -154,11 +172,11 @@ declare class CopilotKitVersionMismatchError extends CopilotKitError {
  * @extends CopilotKitError
  */
 declare class CopilotKitApiDiscoveryError extends CopilotKitError {
-    constructor(params?: {
-        message?: string;
-        code?: CopilotKitErrorCode.API_NOT_FOUND | CopilotKitErrorCode.REMOTE_ENDPOINT_NOT_FOUND;
-        url?: string;
-    });
+  constructor(params?: {
+    message?: string;
+    code?: CopilotKitErrorCode.API_NOT_FOUND | CopilotKitErrorCode.REMOTE_ENDPOINT_NOT_FOUND;
+    url?: string;
+  });
 }
 /**
  * This error is used for endpoints specified in runtime's remote endpoints. If they cannot be contacted
@@ -169,10 +187,10 @@ declare class CopilotKitApiDiscoveryError extends CopilotKitError {
  * @extends CopilotKitApiDiscoveryError
  */
 declare class CopilotKitRemoteEndpointDiscoveryError extends CopilotKitApiDiscoveryError {
-    constructor(params?: {
-        message?: string;
-        url?: string;
-    });
+  constructor(params?: {
+    message?: string;
+    url?: string;
+  });
 }
 /**
  * Error thrown when a LangGraph agent cannot be found or accessed.
@@ -184,13 +202,13 @@ declare class CopilotKitRemoteEndpointDiscoveryError extends CopilotKitApiDiscov
  * @extends CopilotKitError
  */
 declare class CopilotKitAgentDiscoveryError extends CopilotKitError {
-    constructor(params: {
-        agentName?: string;
-        availableAgents: {
-            name: string;
-            id: string;
-        }[];
-    });
+  constructor(params: {
+    agentName?: string;
+    availableAgents: {
+      name: string;
+      id: string;
+    }[];
+  });
 }
 /**
  * Handles low-level networking errors that occur before a request reaches the server.
@@ -205,11 +223,15 @@ declare class CopilotKitAgentDiscoveryError extends CopilotKitError {
  * - Protocol/transport layer errors like SSL/TLS issues
  */
 declare class CopilotKitLowLevelError extends CopilotKitError {
-    constructor({ error, url, message, }: {
-        error: Error;
-        url: string;
-        message?: string;
-    });
+  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.
@@ -228,22 +250,28 @@ declare class CopilotKitLowLevelError extends CopilotKitError {
  * - All other status codes: Maps to UNKNOWN error code if no specific code provided
  */
 declare class ResolvedCopilotKitError extends CopilotKitError {
-    constructor({ status, message, code, isRemoteEndpoint, url, }: {
-        status: number;
-        message?: string;
-        code?: CopilotKitErrorCode;
-        isRemoteEndpoint?: boolean;
-        url?: string;
-    });
+  constructor({
+    status,
+    message,
+    code,
+    isRemoteEndpoint,
+    url
+  }: {
+    status: number;
+    message?: string;
+    code?: CopilotKitErrorCode;
+    isRemoteEndpoint?: boolean;
+    url?: string;
+  });
 }
 declare class ConfigurationError extends CopilotKitError {
-    constructor(message: string);
+  constructor(message: string);
 }
 declare class MissingPublicApiKeyError extends ConfigurationError {
-    constructor(message: string);
+  constructor(message: string);
 }
 declare class UpgradeRequiredError extends ConfigurationError {
-    constructor(message: string);
+  constructor(message: string);
 }
 /**
  * Checks if an error is already a structured CopilotKit error.
@@ -263,18 +291,22 @@ declare function isStructuredCopilotKitError(error: any): boolean;
  */
 declare function ensureStructuredError<T extends CopilotKitError>(error: any, converter: (error: any) => T): T | any;
 interface VersionMismatchResponse {
-    runtimeVersion?: string;
-    runtimeClientGqlVersion: string;
-    reactCoreVersion: string;
+  runtimeVersion?: string;
+  runtimeClientGqlVersion: string;
+  reactCoreVersion: string;
 }
-declare function getPossibleVersionMismatch({ runtimeVersion, runtimeClientGqlVersion, }: {
-    runtimeVersion?: string;
-    runtimeClientGqlVersion: string;
+declare function getPossibleVersionMismatch({
+  runtimeVersion,
+  runtimeClientGqlVersion
+}: {
+  runtimeVersion?: string;
+  runtimeClientGqlVersion: string;
 }): Promise<{
-    runtimeVersion: string;
-    runtimeClientGqlVersion: string;
-    reactCoreVersion: string;
-    message: string;
+  runtimeVersion: string;
+  runtimeClientGqlVersion: string;
+  reactCoreVersion: string;
+  message: string;
 } | undefined>;
-
+//#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.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.cts","names":[],"sources":["../../src/utils/errors.ts"],"mappings":";;;aAGY,QAAA;EACV,QAAA;EAAA;EACA,OAAA;EAAA;EACA,IAAA;AAAA;AAAA,aAGU,eAAA;EACV,MAAA;EAAA;EACA,KAAA;EAAA;EACA,MAAA;EAAA;EACA,QAAA;AAAA;AAAA,cAGW,WAAA;EAAA;;;;;;;;;;;cAeA,kBAAA;AAAA,cAUA,yBAAA;AAAA,aAED,mBAAA;EACV,aAAA;EACA,SAAA;EACA,eAAA;EACA,aAAA;EACA,yBAAA;EACA,oBAAA;EACA,MAAA;EACA,OAAA;EACA,gBAAA;EACA,mBAAA;EACA,4BAAA;EACA,sBAAA;AAAA;AAAA,cAOW,YAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cA0EA,eAAA,SAAwB,YAAA;EACnC,IAAA,EAAM,mBAAA;EACN,UAAA;EACA,QAAA,GAAW,QAAA;EACX,UAAA,EAAY,eAAA;;IAGV,OAAA;IACA,IAAA;IACA,QAAA;IACA;EAAA;IAEA,OAAA;IACA,IAAA,EAAM,mBAAA;IACN,QAAA,GAAW,QAAA;IACX,UAAA,GAAa,eAAA;EAAA;AAAA;;;;;;;cAwCJ,qBAAA,SAA8B,eAAA;;IAEvC,OAAA;IACA;EAAA;IAEA,OAAA;IACA,IAAA,GAAO,mBAAA;EAAA;AAAA;;;;;;cAwBE,8BAAA,SAAuC,eAAA;;IAEhD,gBAAA;IACA,cAAA;IACA;EAAA,GACC,uBAAA;AAAA;;;;;;;;;;cAuBQ,2BAAA,SAAoC,eAAA;cAE7C,MAAA;IACE,OAAA;IACA,IAAA,GACI,mBAAA,CAAoB,aAAA,GACpB,mBAAA,CAAoB,yBAAA;IACxB,GAAA;EAAA;AAAA;;;;;;;;;cAiCO,sCAAA,SAA+C,2BAAA;cAC9C,MAAA;IAAW,OAAA;IAAkB,GAAA;EAAA;AAAA;;;;;;AA1J3C;;;;cA+Ka,6BAAA,SAAsC,eAAA;cACrC,MAAA;IACV,SAAA;IACA,eAAA;MAAmB,IAAA;MAAc,EAAA;IAAA;EAAA;AAAA;;;;;;;;;;;;;cAqCxB,uBAAA,SAAgC,eAAA;;IAEzC,KAAA;IACA,GAAA;IACA;EAAA;IAEA,KAAA,EAAO,KAAA;IACP,GAAA;IACA,OAAA;EAAA;AAAA;;;;;;;;;;;AAxKJ;;;;;;cAuMa,uBAAA,SAAgC,eAAA;;IAEzC,MAAA;IACA,OAAA;IACA,IAAA;IACA,gBAAA;IACA;EAAA;IAEA,MAAA;IACA,OAAA;IACA,IAAA,GAAO,mBAAA;IACP,gBAAA;IACA,GAAA;EAAA;AAAA;AAAA,cAsBS,kBAAA,SAA2B,eAAA;cAC1B,OAAA;AAAA;AAAA,cAOD,wBAAA,SAAiC,kBAAA;cAChC,OAAA;AAAA;AAAA,cAOD,oBAAA,SAA6B,kBAAA;cAC5B,OAAA;AAAA;;;;;;;;iBAcE,2BAAA,CAA4B,KAAA;;;;;;;;;iBAiB5B,qBAAA,WAAgC,eAAA,CAAA,CAC9C,KAAA,OACA,SAAA,GAAY,KAAA,UAAe,CAAA,GAC1B,CAAA;AAAA,UAIO,uBAAA;EACR,cAAA;EACA,uBAAA;EACA,gBAAA;AAAA;AAAA,iBAGoB,0BAAA,CAAA;EACpB,cAAA;EACA;AAAA;EAEA,cAAA;EACA,uBAAA;AAAA,IACD,OAAA"}