@copilotkit/runtime 1.5.12-next.5 → 1.5.12-next.6

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # @copilotkit/runtime
 
+## 1.5.12-next.6
+
+### Patch Changes
+
+- 6136a57: - fix(errors): add custom error classes to better describe library errors
+  - fix(errors): use new errors in error handling
+  - chore: add documentation and links to respective errors
+- Updated dependencies [6136a57]
+  - @copilotkit/shared@1.5.12-next.6
+
 ## 1.5.12-next.5
 
 ### Patch Changes

package/dist/{chunk-QDMAQO2C.mjs → chunk-BKIGYRXE.mjs}

@@ -2,7 +2,7 @@ import {
   getCommonConfig,
   getRuntimeInstanceTelemetryInfo,
   telemetry_client_default
-} from "./chunk-MFDRA3BJ.mjs";
+} from "./chunk-ON4AESON.mjs";
 import {
   __name
 } from "./chunk-44O2JGUY.mjs";
@@ -77,4 +77,4 @@ export {
   config,
   copilotRuntimeNextJSPagesRouterEndpoint
 };
-//# sourceMappingURL=chunk-QDMAQO2C.mjs.map
+//# sourceMappingURL=chunk-BKIGYRXE.mjs.map

package/dist/{chunk-MFDRA3BJ.mjs → chunk-ON4AESON.mjs}

@@ -38,7 +38,7 @@ var require_package = __commonJS({
       publishConfig: {
         access: "public"
       },
-      version: "1.5.12-next.5",
+      version: "1.5.12-next.6",
       sideEffects: false,
       main: "./dist/index.js",
       module: "./dist/index.mjs",
@@ -1796,6 +1796,7 @@ function copilotkitMessagesToLangChain(messages) {
 __name(copilotkitMessagesToLangChain, "copilotkitMessagesToLangChain");
 
 // src/lib/runtime/remote-action-constructors.ts
+import { CopilotKitError, CopilotKitLowLevelError } from "@copilotkit/shared";
 function constructLGCRemoteAction({ endpoint, graphqlContext, logger: logger2, messages, agentStates }) {
   const agents = endpoint.agents.map((agent) => ({
     name: agent.name,
@@ -1876,8 +1877,9 @@ function constructRemoteActions({ json, url, onBeforeRequest, graphqlContext, lo
         type: "self-hosted",
         agentsAmount: totalAgents
       });
+      const fetchUrl = `${url}/actions/execute`;
       try {
-        const response = await fetch(`${url}/actions/execute`, {
+        const response = await fetch(fetchUrl, {
           method: "POST",
           headers,
           body: JSON.stringify({
@@ -1902,10 +1904,13 @@ function constructRemoteActions({ json, url, onBeforeRequest, graphqlContext, lo
         }, "Executed remote action");
         return result;
       } catch (error) {
-        logger2.error({
-          error: error.message ? error.message : error + ""
-        }, "Failed to execute remote action");
-        return "Failed to execute remote action";
+        if (error instanceof CopilotKitError) {
+          throw error;
+        }
+        throw new CopilotKitLowLevelError({
+          error,
+          url: fetchUrl
+        });
       }
     }
   }));
@@ -1933,37 +1938,48 @@ function constructRemoteActions({ json, url, onBeforeRequest, graphqlContext, lo
           state = JSON.parse(jsonState);
         }
       }
-      const response = await fetch(`${url}/agents/execute`, {
-        method: "POST",
-        headers,
-        body: JSON.stringify({
-          name,
-          threadId,
-          nodeName,
-          messages: [
-            ...messages,
-            ...additionalMessages
-          ],
-          state,
-          properties: graphqlContext.properties,
-          actions: actionInputsWithoutAgents.map((action) => ({
-            name: action.name,
-            description: action.description,
-            parameters: JSON.parse(action.jsonSchema)
-          }))
-        })
-      });
-      if (!response.ok) {
-        logger2.error({
-          url,
-          status: response.status,
-          body: await response.text()
-        }, "Failed to execute remote agent");
-        throw new Error("Failed to execute remote agent");
+      const fetchUrl = `${url}/agents/execute`;
+      try {
+        const response = await fetch(fetchUrl, {
+          method: "POST",
+          headers,
+          body: JSON.stringify({
+            name,
+            threadId,
+            nodeName,
+            messages: [
+              ...messages,
+              ...additionalMessages
+            ],
+            state,
+            properties: graphqlContext.properties,
+            actions: actionInputsWithoutAgents.map((action) => ({
+              name: action.name,
+              description: action.description,
+              parameters: JSON.parse(action.jsonSchema)
+            }))
+          })
+        });
+        if (!response.ok) {
+          logger2.error({
+            url,
+            status: response.status,
+            body: await response.text()
+          }, "Failed to execute remote agent");
+          throw new Error("Failed to execute remote agent");
+        }
+        const eventSource = new RemoteLangGraphEventSource();
+        streamResponse(response.body, eventSource.eventStream$);
+        return eventSource.processLangGraphEvents();
+      } catch (error) {
+        if (error instanceof CopilotKitError) {
+          throw error;
+        }
+        throw new CopilotKitLowLevelError({
+          error,
+          url: fetchUrl
+        });
       }
-      const eventSource = new RemoteLangGraphEventSource();
-      streamResponse(response.body, eventSource.eventStream$);
-      return eventSource.processLangGraphEvents();
     }
   })) : [];
   return [
@@ -2033,6 +2049,7 @@ function createHeaders(onBeforeRequest, graphqlContext) {
 __name(createHeaders, "createHeaders");
 
 // src/lib/runtime/remote-actions.ts
+import { CopilotKitLowLevelError as CopilotKitLowLevelError2, ResolvedCopilotKitError, CopilotKitError as CopilotKitError2 } from "@copilotkit/shared";
 var EndpointType;
 (function(EndpointType2) {
   EndpointType2["CopilotKit"] = "copilotKit";
@@ -2050,8 +2067,9 @@ async function fetchRemoteInfo({ url, onBeforeRequest, graphqlContext, logger: l
     url
   }, "Fetching actions from url");
   const headers = createHeaders(onBeforeRequest, graphqlContext);
+  const fetchUrl = `${url}/info`;
   try {
-    const response = await fetch(`${url}/info`, {
+    const response = await fetch(fetchUrl, {
       method: "POST",
       headers,
       body: JSON.stringify({
@@ -2065,10 +2083,10 @@ async function fetchRemoteInfo({ url, onBeforeRequest, graphqlContext, logger: l
         status: response.status,
         body: await response.text()
       }, "Failed to fetch actions from url");
-      return {
-        actions: [],
-        agents: []
-      };
+      throw new ResolvedCopilotKitError({
+        status: response.status,
+        isRemoteEndpoint: true
+      });
     }
     const json = await response.json();
     logger2.debug({
@@ -2076,13 +2094,13 @@ async function fetchRemoteInfo({ url, onBeforeRequest, graphqlContext, logger: l
     }, "Fetched actions from url");
     return json;
   } catch (error) {
-    logger2.error({
-      error: error.message ? error.message : error + ""
-    }, "Failed to fetch actions from url");
-    return {
-      actions: [],
-      agents: []
-    };
+    if (error instanceof CopilotKitError2) {
+      throw error;
+    }
+    throw new CopilotKitLowLevelError2({
+      error,
+      url: fetchUrl
+    });
   }
 }
 __name(fetchRemoteInfo, "fetchRemoteInfo");
@@ -2143,7 +2161,8 @@ __name(setupRemoteActions, "setupRemoteActions");
 import { createHash as createHash3 } from "crypto";
 
 // src/lib/runtime/copilot-runtime.ts
-import { actionParametersToJsonSchema, randomId as randomId2 } from "@copilotkit/shared";
+import { actionParametersToJsonSchema, ResolvedCopilotKitError as ResolvedCopilotKitError2, CopilotKitApiDiscoveryError, randomId as randomId2, CopilotKitError as CopilotKitError3, CopilotKitLowLevelError as CopilotKitLowLevelError3, CopilotKitAgentDiscoveryError, CopilotKitMisuseError } from "@copilotkit/shared";
+import { Client as LangGraphClient } from "@langchain/langgraph-sdk";
 
 // src/service-adapters/conversion.ts
 import { plainToInstance } from "class-transformer";
@@ -2221,9 +2240,11 @@ var CopilotRuntime = class {
         return await this.processAgentRequest(request);
       }
       if (serviceAdapter instanceof EmptyAdapter) {
-        throw new Error(`Invalid adapter configuration: EmptyAdapter is only meant to be used with agent lock mode. 
+        throw new CopilotKitMisuseError({
+          message: `Invalid adapter configuration: EmptyAdapter is only meant to be used with agent lock mode. 
 For non-agent components like useCopilotChatSuggestions, CopilotTextarea, or CopilotTask, 
-please use an LLM adapter instead.`);
+please use an LLM adapter instead.`
+        });
       }
       const messages = rawMessages.filter((message) => !message.agentStateMessage);
       const inputMessages = convertGqlInputToMessages(messages);
@@ -2278,6 +2299,9 @@ please use an LLM adapter instead.`);
         ))
       };
     } catch (error) {
+      if (error instanceof CopilotKitError3) {
+        throw error;
+      }
       console.error("Error getting response:", error);
       eventSource.sendErrorMessageToChat();
       throw error;
@@ -2288,37 +2312,59 @@ please use an LLM adapter instead.`);
     const agents = this.remoteEndpointDefinitions.reduce(async (acc, endpoint) => {
       const agents2 = await acc;
       if (endpoint.type === EndpointType.LangGraphPlatform) {
-        const response2 = await fetch(`${endpoint.deploymentUrl}/assistants/search`, {
-          method: "POST",
-          headers
+        const client = new LangGraphClient({
+          apiUrl: endpoint.deploymentUrl,
+          apiKey: endpoint.langsmithApiKey
         });
-        const data2 = await response2.json();
-        const endpointAgents2 = (data2 ?? []).map((entry) => ({
+        const data = await client.assistants.search();
+        const endpointAgents = (data ?? []).map((entry) => ({
           name: entry.graph_id,
-          id: entry.assistant_id
+          id: entry.assistant_id,
+          description: "",
+          endpoint
         }));
         return [
           ...agents2,
-          ...endpointAgents2
+          ...endpointAgents
         ];
       }
-      const response = await fetch(`${endpoint.url}/info`, {
-        method: "POST",
-        headers,
-        body: JSON.stringify({
-          properties: graphqlContext.properties
-        })
-      });
-      const data = await response.json();
-      const endpointAgents = ((data == null ? void 0 : data.agents) ?? []).map((agent) => ({
-        name: agent.name,
-        description: agent.description,
-        id: randomId2()
-      }));
-      return [
-        ...agents2,
-        ...endpointAgents
-      ];
+      const fetchUrl = `${endpoint.url}/info`;
+      try {
+        const response = await fetch(fetchUrl, {
+          method: "POST",
+          headers,
+          body: JSON.stringify({
+            properties: graphqlContext.properties
+          })
+        });
+        if (!response.ok) {
+          if (response.status === 404) {
+            throw new CopilotKitApiDiscoveryError();
+          }
+          throw new ResolvedCopilotKitError2({
+            status: response.status,
+            isRemoteEndpoint: true
+          });
+        }
+        const data = await response.json();
+        const endpointAgents = ((data == null ? void 0 : data.agents) ?? []).map((agent) => ({
+          name: agent.name,
+          description: agent.description ?? "",
+          id: randomId2()
+        }));
+        return [
+          ...agents2,
+          ...endpointAgents
+        ];
+      } catch (error) {
+        if (error instanceof CopilotKitError3) {
+          throw error;
+        }
+        throw new CopilotKitLowLevelError3({
+          error,
+          url: fetchUrl
+        });
+      }
     }, Promise.resolve([]));
     return agents;
   }
@@ -2330,7 +2376,9 @@ please use an LLM adapter instead.`);
     const messages = convertGqlInputToMessages(rawMessages);
     const agent = serverSideActions.find((action) => action.name === agentName && isLangGraphAgentAction(action));
     if (!agent) {
-      throw new Error(`Agent ${agentName} not found`);
+      throw new CopilotKitAgentDiscoveryError({
+        agentName
+      });
     }
     const serverSideActionsInput = serverSideActions.filter((action) => !isLangGraphAgentAction(action)).map((action) => ({
       name: action.name,
@@ -3440,4 +3488,4 @@ export {
   getCommonConfig,
   copilotRuntimeNodeHttpEndpoint
 };
-//# sourceMappingURL=chunk-MFDRA3BJ.mjs.map
+//# sourceMappingURL=chunk-ON4AESON.mjs.map