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

package/dist/lib/integrations/node-http/index.mjs

@@ -1,6 +1,6 @@
 import {
   copilotRuntimeNodeHttpEndpoint
-} from "../../../chunk-MFDRA3BJ.mjs";
+} from "../../../chunk-ON4AESON.mjs";
 import "../../../chunk-TPTCSIAR.mjs";
 import "../../../chunk-U3V2BCGI.mjs";
 import "../../../chunk-HNUNXFTW.mjs";

package/package.json

@@ -9,7 +9,7 @@
   "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",
@@ -58,7 +58,7 @@
     "rxjs": "^7.8.1",
     "type-graphql": "2.0.0-rc.1",
     "zod": "^3.23.3",
-    "@copilotkit/shared": "1.5.12-next.5"
+    "@copilotkit/shared": "1.5.12-next.6"
   },
   "keywords": [
     "copilotkit",

package/src/lib/runtime/copilot-runtime.ts

@@ -12,7 +12,19 @@
  * ```
  */
 
-import { Action, actionParametersToJsonSchema, Parameter, randomId } from "@copilotkit/shared";
+import {
+  Action,
+  actionParametersToJsonSchema,
+  Parameter,
+  ResolvedCopilotKitError,
+  CopilotKitApiDiscoveryError,
+  randomId,
+  CopilotKitError,
+  CopilotKitLowLevelError,
+  CopilotKitAgentDiscoveryError,
+  CopilotKitMisuseError,
+} from "@copilotkit/shared";
+import { Client as LangGraphClient } from "@langchain/langgraph-sdk";
 import {
   CopilotServiceAdapter,
   EmptyAdapter,
@@ -190,10 +202,11 @@ export class CopilotRuntime<const T extends Parameter[] | [] = []> {
         return await this.processAgentRequest(request);
       }
       if (serviceAdapter instanceof EmptyAdapter) {
-        // TODO: use CPK error here
-        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);
@@ -260,30 +273,36 @@ please use an LLM adapter instead.`);
         ),
       };
     } catch (error) {
+      if (error instanceof CopilotKitError) {
+        throw error;
+      }
       console.error("Error getting response:", error);
       eventSource.sendErrorMessageToChat();
       throw error;
     }
   }
 
-  async discoverAgentsFromEndpoints(graphqlContext: GraphQLContext): Promise<Agent[]> {
+  async discoverAgentsFromEndpoints(
+    graphqlContext: GraphQLContext,
+  ): Promise<(Agent & { endpoint: EndpointDefinition })[]> {
     const headers = createHeaders(null, graphqlContext);
     const agents = this.remoteEndpointDefinitions.reduce(
       async (acc: Promise<Agent[]>, endpoint) => {
         const agents = await acc;
         if (endpoint.type === EndpointType.LangGraphPlatform) {
-          const response = await fetch(
-            `${(endpoint as LangGraphPlatformEndpoint).deploymentUrl}/assistants/search`,
-            {
-              method: "POST",
-              headers,
-            },
-          );
-
-          const data: Array<{ assistant_id: string; graph_id: string }> = await response.json();
+          const client = new LangGraphClient({
+            apiUrl: endpoint.deploymentUrl,
+            apiKey: endpoint.langsmithApiKey,
+          });
+
+          const data: Array<{ assistant_id: string; graph_id: string }> =
+            await client.assistants.search();
+
           const endpointAgents = (data ?? []).map((entry) => ({
             name: entry.graph_id,
             id: entry.assistant_id,
+            description: "",
+            endpoint,
           }));
           return [...agents, ...endpointAgents];
         }
@@ -295,18 +314,33 @@ please use an LLM adapter instead.`);
           }>;
         }
 
-        const response = await fetch(`${(endpoint as CopilotKitEndpoint).url}/info`, {
-          method: "POST",
-          headers,
-          body: JSON.stringify({ properties: graphqlContext.properties }),
-        });
-        const data: InfoResponse = await response.json();
-        const endpointAgents = (data?.agents ?? []).map((agent) => ({
-          name: agent.name,
-          description: agent.description,
-          id: randomId(), // Required by Agent type
-        }));
-        return [...agents, ...endpointAgents];
+        const fetchUrl = `${(endpoint as CopilotKitEndpoint).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 ResolvedCopilotKitError({ status: response.status, isRemoteEndpoint: true });
+          }
+
+          const data: InfoResponse = await response.json();
+          const endpointAgents = (data?.agents ?? []).map((agent) => ({
+            name: agent.name,
+            description: agent.description ?? "",
+            id: randomId(), // Required by Agent type
+          }));
+          return [...agents, ...endpointAgents];
+        } catch (error) {
+          if (error instanceof CopilotKitError) {
+            throw error;
+          }
+          throw new CopilotKitLowLevelError({ error: error as Error, url: fetchUrl });
+        }
       },
       Promise.resolve([]),
     );
@@ -328,7 +362,7 @@ please use an LLM adapter instead.`);
     ) as LangGraphAgentAction;
 
     if (!agent) {
-      throw new Error(`Agent ${agentName} not found`);
+      throw new CopilotKitAgentDiscoveryError({ agentName });
     }
 
     const serverSideActionsInput: ActionInput[] = serverSideActions

package/src/lib/runtime/remote-action-constructors.ts

@@ -16,6 +16,7 @@ import { RemoteLangGraphEventSource } from "../../agents/langgraph/event-source"
 import { Action } from "@copilotkit/shared";
 import { LangGraphEvent } from "../../agents/langgraph/events";
 import { execute } from "./remote-lg-action";
+import { CopilotKitError, CopilotKitLowLevelError } from "@copilotkit/shared";
 
 export function constructLGCRemoteAction({
   endpoint,
@@ -126,8 +127,9 @@ export function constructRemoteActions({
         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({
@@ -151,11 +153,10 @@ export function constructRemoteActions({
         logger.debug({ actionName: action.name, result }, "Executed remote action");
         return result;
       } catch (error) {
-        logger.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 });
       }
     },
   }));
@@ -191,35 +192,43 @@ export function constructRemoteActions({
             }
           }
 
-          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),
-              })),
-            }),
-          });
+          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) {
+              logger.error(
+                { url, status: response.status, body: await response.text() },
+                "Failed to execute remote agent",
+              );
+              throw new Error("Failed to execute remote agent");
+            }
 
-          if (!response.ok) {
-            logger.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();
         },
       }))
     : [];

package/src/lib/runtime/remote-actions.ts

@@ -11,6 +11,11 @@ import {
   constructRemoteActions,
   createHeaders,
 } from "./remote-action-constructors";
+import {
+  CopilotKitLowLevelError,
+  ResolvedCopilotKitError,
+  CopilotKitError,
+} from "@copilotkit/shared";
 
 export type EndpointDefinition = CopilotKitEndpoint | LangGraphPlatformEndpoint;
 
@@ -83,8 +88,9 @@ async function fetchRemoteInfo({
   logger.debug({ 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({ properties: graphqlContext.properties, frontendUrl }),
@@ -95,18 +101,17 @@ async function fetchRemoteInfo({
         { url, 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();
     logger.debug({ json }, "Fetched actions from url");
     return json;
   } catch (error) {
-    logger.error(
-      { error: error.message ? error.message : error + "" },
-      "Failed to fetch actions from url",
-    );
-    return { actions: [], agents: [] };
+    if (error instanceof CopilotKitError) {
+      throw error;
+    }
+    throw new CopilotKitLowLevelError({ error, url: fetchUrl });
   }
 }