@copilotkit/runtime 1.9.1 → 1.9.2-next.0

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # @copilotkit/runtime
 
+## 1.9.2-next.0
+
+### Patch Changes
+
+- 10345a5: - feat: structured error visibility system for streaming errors
+- Updated dependencies [10345a5]
+  - @copilotkit/shared@1.9.2-next.0
+
 ## 1.9.1
 
 ### Patch Changes

package/dist/{chunk-RVLXQ2V5.mjs → chunk-44FYLJJJ.mjs}

@@ -2,7 +2,7 @@ import {
   getCommonConfig,
   getRuntimeInstanceTelemetryInfo,
   telemetry_client_default
-} from "./chunk-GOPTDPPB.mjs";
+} from "./chunk-YMIOUUPV.mjs";
 import {
   __name
 } from "./chunk-FHD4JECV.mjs";
@@ -77,4 +77,4 @@ export {
   config,
   copilotRuntimeNextJSPagesRouterEndpoint
 };
-//# sourceMappingURL=chunk-RVLXQ2V5.mjs.map
+//# sourceMappingURL=chunk-44FYLJJJ.mjs.map

package/dist/{chunk-2CND6WGV.mjs → chunk-ESXPDYNT.mjs}

@@ -2,7 +2,7 @@ import {
   copilotRuntimeNodeHttpEndpoint,
   getRuntimeInstanceTelemetryInfo,
   telemetry_client_default
-} from "./chunk-GOPTDPPB.mjs";
+} from "./chunk-YMIOUUPV.mjs";
 import {
   __name
 } from "./chunk-FHD4JECV.mjs";
@@ -22,4 +22,4 @@ __name(copilotRuntimeNestEndpoint, "copilotRuntimeNestEndpoint");
 export {
   copilotRuntimeNestEndpoint
 };
-//# sourceMappingURL=chunk-2CND6WGV.mjs.map
+//# sourceMappingURL=chunk-ESXPDYNT.mjs.map

package/dist/{chunk-BHNTR222.mjs → chunk-O6KXX5R5.mjs}

@@ -1,6 +1,6 @@
 import {
   LangGraphEventTypes
-} from "./chunk-GOPTDPPB.mjs";
+} from "./chunk-YMIOUUPV.mjs";
 import {
   __name
 } from "./chunk-FHD4JECV.mjs";
@@ -138,4 +138,4 @@ export {
   CustomEventNames,
   LangGraphAgent
 };
-//# sourceMappingURL=chunk-BHNTR222.mjs.map
+//# sourceMappingURL=chunk-O6KXX5R5.mjs.map

package/dist/{chunk-GOPTDPPB.mjs → chunk-YMIOUUPV.mjs}

@@ -40,7 +40,7 @@ var require_package = __commonJS({
       publishConfig: {
         access: "public"
       },
-      version: "1.9.1",
+      version: "1.9.2-next.0",
       sideEffects: false,
       main: "./dist/index.js",
       module: "./dist/index.mjs",
@@ -1485,14 +1485,14 @@ GenerateCopilotResponseInput = _ts_decorate15([
 import { Repeater } from "graphql-yoga";
 
 // src/service-adapters/events.ts
-import { randomId as randomId3 } from "@copilotkit/shared";
+import { randomId as randomId3, CopilotKitError as CopilotKitError6, CopilotKitErrorCode as CopilotKitErrorCode4, CopilotKitLowLevelError as CopilotKitLowLevelError5 } from "@copilotkit/shared";
 import { of, concat, scan as scan2, concatMap, ReplaySubject as ReplaySubject2, firstValueFrom, from as from2, catchError as catchError2, EMPTY } from "rxjs";
 
 // src/lib/telemetry-client.ts
 import { TelemetryClient } from "@copilotkit/shared";
 
 // src/lib/runtime/remote-actions.ts
-import { CopilotKitErrorCode } from "@copilotkit/shared";
+import { CopilotKitErrorCode as CopilotKitErrorCode2 } from "@copilotkit/shared";
 
 // src/lib/runtime/remote-action-constructors.ts
 import { createHash as createHash2 } from "crypto";
@@ -1532,7 +1532,7 @@ var CustomEventNames;
 })(CustomEventNames || (CustomEventNames = {}));
 
 // src/agents/langgraph/event-source.ts
-import { randomId } from "@copilotkit/shared";
+import { randomId, CopilotKitError } from "@copilotkit/shared";
 var RemoteLangGraphEventSource = class {
   eventStream$ = new ReplaySubject();
   shouldEmitToolCall(shouldEmitToolCalls, toolCallName) {
@@ -1733,6 +1733,9 @@ var RemoteLangGraphEventSource = class {
       return events;
     }), catchError((error) => {
       console.error(error);
+      if (error instanceof CopilotKitError || (error == null ? void 0 : error.name) && error.name.includes("CopilotKit")) {
+        throw error;
+      }
       const events = [];
       if ((lastEventWithState == null ? void 0 : lastEventWithState.lastMessageId) && !lastEventWithState.isToolCall) {
         events.push({
@@ -1773,32 +1776,119 @@ import { isValidUUID, randomUUID } from "@copilotkit/shared";
 import { parse as parsePartialJson } from "partial-json";
 import { parseJson, CopilotKitMisuseError } from "@copilotkit/shared";
 import { RemoveMessage } from "@langchain/core/messages";
+
+// src/lib/runtime/retry-utils.ts
+var RETRY_CONFIG = {
+  maxRetries: 3,
+  baseDelayMs: 1e3,
+  maxDelayMs: 5e3,
+  // HTTP status codes that should be retried
+  retryableStatusCodes: [
+    502,
+    503,
+    504,
+    408,
+    429
+  ],
+  // Network error patterns that should be retried
+  retryableErrorMessages: [
+    "fetch failed",
+    "network error",
+    "connection timeout",
+    "ECONNREFUSED",
+    "ETIMEDOUT",
+    "ENOTFOUND",
+    "ECONNRESET"
+  ]
+};
+function isRetryableError(error, response) {
+  var _a, _b;
+  if (response && RETRY_CONFIG.retryableStatusCodes.includes(response.status)) {
+    return true;
+  }
+  const errorCode = ((_a = error == null ? void 0 : error.cause) == null ? void 0 : _a.code) || (error == null ? void 0 : error.code);
+  if (errorCode && RETRY_CONFIG.retryableErrorMessages.includes(errorCode)) {
+    return true;
+  }
+  const errorMessage = ((_b = error == null ? void 0 : error.message) == null ? void 0 : _b.toLowerCase()) || "";
+  return RETRY_CONFIG.retryableErrorMessages.some((msg) => errorMessage.includes(msg));
+}
+__name(isRetryableError, "isRetryableError");
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+__name(sleep, "sleep");
+function calculateDelay(attempt) {
+  const delay = RETRY_CONFIG.baseDelayMs * Math.pow(2, attempt);
+  return Math.min(delay, RETRY_CONFIG.maxDelayMs);
+}
+__name(calculateDelay, "calculateDelay");
+async function fetchWithRetry(url, options, logger2) {
+  let lastError;
+  for (let attempt = 0; attempt <= RETRY_CONFIG.maxRetries; attempt++) {
+    try {
+      const response = await fetch(url, options);
+      if (isRetryableError(null, response) && attempt < RETRY_CONFIG.maxRetries) {
+        const delay = calculateDelay(attempt);
+        logger2 == null ? void 0 : logger2.warn(`Request to ${url} failed with status ${response.status}. Retrying attempt ${attempt + 1}/${RETRY_CONFIG.maxRetries + 1} in ${delay}ms.`);
+        await sleep(delay);
+        continue;
+      }
+      return response;
+    } catch (error) {
+      lastError = error;
+      if (isRetryableError(error) && attempt < RETRY_CONFIG.maxRetries) {
+        const delay = calculateDelay(attempt);
+        logger2 == null ? void 0 : logger2.warn(`Request to ${url} failed with network error. Retrying attempt ${attempt + 1}/${RETRY_CONFIG.maxRetries + 1} in ${delay}ms. Error: ${(error == null ? void 0 : error.message) || String(error)}`);
+        await sleep(delay);
+        continue;
+      }
+      break;
+    }
+  }
+  throw lastError;
+}
+__name(fetchWithRetry, "fetchWithRetry");
+
+// src/lib/runtime/remote-lg-action.ts
 var activeInterruptEvent = false;
 async function execute(args) {
   return new ReadableStream({
     async start(controller) {
-      try {
-        await streamEvents(controller, args);
-        controller.close();
-      } catch (err) {
-        const cause = err == null ? void 0 : err.cause;
-        const errorCode = (cause == null ? void 0 : cause.code) || (err == null ? void 0 : err.code);
-        if (errorCode === "ECONNREFUSED") {
-          throw new CopilotKitMisuseError({
-            message: `
-              The LangGraph client could not connect to the graph. Please further check previous logs, which includes further details.
-              
-              See more: https://docs.copilotkit.ai/troubleshooting/common-issues`
-          });
-        } else {
-          throw new CopilotKitMisuseError({
-            message: `
-              The LangGraph client threw unhandled error ${err}.
-              
-              See more: https://docs.copilotkit.ai/troubleshooting/common-issues`
-          });
+      let lastError;
+      for (let attempt = 0; attempt <= RETRY_CONFIG.maxRetries; attempt++) {
+        try {
+          await streamEvents(controller, args);
+          controller.close();
+          return;
+        } catch (err) {
+          lastError = err;
+          if (isRetryableError(err) && attempt < RETRY_CONFIG.maxRetries) {
+            const delay = calculateDelay(attempt);
+            console.warn(`LangGraph connection attempt ${attempt + 1}/${RETRY_CONFIG.maxRetries + 1} failed. Retrying in ${delay}ms. Error: ${(err == null ? void 0 : err.message) || String(err)}`);
+            await sleep(delay);
+            continue;
+          }
+          break;
         }
       }
+      const cause = lastError == null ? void 0 : lastError.cause;
+      const errorCode = (cause == null ? void 0 : cause.code) || (lastError == null ? void 0 : lastError.code);
+      if (errorCode === "ECONNREFUSED") {
+        throw new CopilotKitMisuseError({
+          message: `
+            The LangGraph client could not connect to the graph after ${RETRY_CONFIG.maxRetries + 1} attempts. Please further check previous logs, which includes further details.
+            
+            See more: https://docs.copilotkit.ai/troubleshooting/common-issues`
+        });
+      } else {
+        throw new CopilotKitMisuseError({
+          message: `
+            The LangGraph client threw unhandled error ${lastError}.
+            
+            See more: https://docs.copilotkit.ai/troubleshooting/common-issues`
+        });
+      }
     }
   });
 }
@@ -2398,9 +2488,10 @@ function filterObjectBySchemaKeys(obj, schemaKeys) {
 __name(filterObjectBySchemaKeys, "filterObjectBySchemaKeys");
 
 // src/lib/runtime/remote-action-constructors.ts
-import { CopilotKitError, CopilotKitLowLevelError } from "@copilotkit/shared";
+import { CopilotKitError as CopilotKitError3, CopilotKitLowLevelError as CopilotKitLowLevelError2 } from "@copilotkit/shared";
 
 // src/lib/streaming.ts
+import { CopilotKitLowLevelError, CopilotKitError as CopilotKitError2, CopilotKitErrorCode } from "@copilotkit/shared";
 async function writeJsonLineResponseToEventStream(response, eventStream$) {
   const reader = response.getReader();
   const decoder = new TextDecoder();
@@ -2439,12 +2530,40 @@ async function writeJsonLineResponseToEventStream(response, eventStream$) {
     }
   } catch (error) {
     console.error("Error in stream", error);
-    eventStream$.error(error);
+    const structuredError = convertStreamingErrorToStructured(error);
+    eventStream$.error(structuredError);
     return;
   }
   eventStream$.complete();
 }
 __name(writeJsonLineResponseToEventStream, "writeJsonLineResponseToEventStream");
+function convertStreamingErrorToStructured(error) {
+  var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j;
+  if (((_a = error == null ? void 0 : error.message) == null ? void 0 : _a.includes("terminated")) || ((_b = error == null ? void 0 : error.cause) == null ? void 0 : _b.code) === "UND_ERR_SOCKET" || ((_c = error == null ? void 0 : error.message) == null ? void 0 : _c.includes("other side closed")) || (error == null ? void 0 : error.code) === "UND_ERR_SOCKET") {
+    return new CopilotKitError2({
+      message: "Connection to agent was unexpectedly terminated. This is likely due to the agent service being down or experiencing issues. Please check your agent logs and try again.",
+      code: CopilotKitErrorCode.NETWORK_ERROR
+    });
+  }
+  if (((_d = error == null ? void 0 : error.message) == null ? void 0 : _d.includes("fetch failed")) || ((_e = error == null ? void 0 : error.message) == null ? void 0 : _e.includes("ECONNREFUSED")) || ((_f = error == null ? void 0 : error.message) == null ? void 0 : _f.includes("ENOTFOUND")) || ((_g = error == null ? void 0 : error.message) == null ? void 0 : _g.includes("ETIMEDOUT"))) {
+    return new CopilotKitLowLevelError({
+      error: error instanceof Error ? error : new Error(String(error)),
+      url: "streaming connection",
+      message: "Network error occurred during streaming. Please check your connection and try again."
+    });
+  }
+  if (((_h = error == null ? void 0 : error.message) == null ? void 0 : _h.includes("aborted")) || ((_i = error == null ? void 0 : error.message) == null ? void 0 : _i.includes("canceled")) || ((_j = error == null ? void 0 : error.message) == null ? void 0 : _j.includes("signal is aborted"))) {
+    return new CopilotKitError2({
+      message: "Request was cancelled",
+      code: CopilotKitErrorCode.UNKNOWN
+    });
+  }
+  return new CopilotKitError2({
+    message: `Streaming error: ${(error == null ? void 0 : error.message) || String(error)}`,
+    code: CopilotKitErrorCode.UNKNOWN
+  });
+}
+__name(convertStreamingErrorToStructured, "convertStreamingErrorToStructured");
 
 // src/lib/runtime/remote-action-constructors.ts
 import { CopilotKitApiDiscoveryError, ResolvedCopilotKitError } from "@copilotkit/shared";
@@ -2541,7 +2660,7 @@ function constructRemoteActions({ json, url, onBeforeRequest, graphqlContext, lo
       });
       const fetchUrl = `${url}/actions/execute`;
       try {
-        const response = await fetch(fetchUrl, {
+        const response = await fetchWithRetry(fetchUrl, {
           method: "POST",
           headers,
           body: JSON.stringify({
@@ -2549,7 +2668,7 @@ function constructRemoteActions({ json, url, onBeforeRequest, graphqlContext, lo
             arguments: args,
             properties: graphqlContext.properties
           })
-        });
+        }, logger2);
         if (!response.ok) {
           logger2.error({
             url,
@@ -2575,10 +2694,10 @@ function constructRemoteActions({ json, url, onBeforeRequest, graphqlContext, lo
         }, "Executed remote action");
         return result;
       } catch (error) {
-        if (error instanceof CopilotKitError) {
+        if (error instanceof CopilotKitError3) {
           throw error;
         }
-        throw new CopilotKitLowLevelError({
+        throw new CopilotKitLowLevelError2({
           error,
           url: fetchUrl
         });
@@ -2612,7 +2731,7 @@ function constructRemoteActions({ json, url, onBeforeRequest, graphqlContext, lo
       }
       const fetchUrl = `${url}/agents/execute`;
       try {
-        const response = await fetch(fetchUrl, {
+        const response = await fetchWithRetry(fetchUrl, {
           method: "POST",
           headers,
           body: JSON.stringify({
@@ -2633,7 +2752,7 @@ function constructRemoteActions({ json, url, onBeforeRequest, graphqlContext, lo
             })),
             metaEvents
           })
-        });
+        }, logger2);
         if (!response.ok) {
           logger2.error({
             url,
@@ -2663,10 +2782,10 @@ function constructRemoteActions({ json, url, onBeforeRequest, graphqlContext, lo
           throw new Error("Unsupported agent type");
         }
       } catch (error) {
-        if (error instanceof CopilotKitError) {
+        if (error instanceof CopilotKitError3) {
           throw error;
         }
-        throw new CopilotKitLowLevelError({
+        throw new CopilotKitLowLevelError2({
           error,
           url: fetchUrl
         });
@@ -2696,7 +2815,7 @@ function createHeaders(onBeforeRequest, graphqlContext) {
 __name(createHeaders, "createHeaders");
 
 // src/lib/runtime/remote-actions.ts
-import { CopilotKitLowLevelError as CopilotKitLowLevelError2, ResolvedCopilotKitError as ResolvedCopilotKitError2, CopilotKitError as CopilotKitError2 } from "@copilotkit/shared";
+import { CopilotKitLowLevelError as CopilotKitLowLevelError3, ResolvedCopilotKitError as ResolvedCopilotKitError2, CopilotKitError as CopilotKitError4 } from "@copilotkit/shared";
 
 // src/lib/runtime/agui-action.ts
 import { parseJson as parseJson3 } from "@copilotkit/shared";
@@ -2843,10 +2962,10 @@ async function fetchRemoteInfo({ url, onBeforeRequest, graphqlContext, logger: l
     }, "Fetched actions from url");
     return json;
   } catch (error) {
-    if (error instanceof CopilotKitError2) {
+    if (error instanceof CopilotKitError4) {
       throw error;
     }
-    throw new CopilotKitLowLevelError2({
+    throw new CopilotKitLowLevelError3({
       error,
       url: fetchUrl
     });
@@ -2904,9 +3023,9 @@ async function setupRemoteActions({ remoteEndpointDefinitions, graphqlContext, m
   }));
   for (const [key, agent] of Object.entries(agents)) {
     if (agent.agentId !== void 0 && agent.agentId !== key) {
-      throw new CopilotKitError2({
+      throw new CopilotKitError4({
         message: `Agent ${key} has agentId ${agent.agentId} which does not match the key ${key}`,
-        code: CopilotKitErrorCode.UNKNOWN
+        code: CopilotKitErrorCode2.UNKNOWN
       });
     } else if (agent.agentId === void 0) {
       agent.agentId = key;
@@ -2927,7 +3046,7 @@ __name(setupRemoteActions, "setupRemoteActions");
 import { createHash as createHash3 } from "crypto";
 
 // src/lib/runtime/copilot-runtime.ts
-import { actionParametersToJsonSchema, ResolvedCopilotKitError as ResolvedCopilotKitError3, CopilotKitApiDiscoveryError as CopilotKitApiDiscoveryError2, randomId as randomId2, CopilotKitError as CopilotKitError3, CopilotKitLowLevelError as CopilotKitLowLevelError3, CopilotKitAgentDiscoveryError, CopilotKitMisuseError as CopilotKitMisuseError2 } from "@copilotkit/shared";
+import { actionParametersToJsonSchema, ResolvedCopilotKitError as ResolvedCopilotKitError3, CopilotKitApiDiscoveryError as CopilotKitApiDiscoveryError2, randomId as randomId2, CopilotKitError as CopilotKitError5, CopilotKitAgentDiscoveryError, CopilotKitMisuseError as CopilotKitMisuseError2, CopilotKitErrorCode as CopilotKitErrorCode3, CopilotKitLowLevelError as CopilotKitLowLevelError4 } from "@copilotkit/shared";
 
 // src/service-adapters/conversion.ts
 import { plainToInstance } from "class-transformer";
@@ -3366,12 +3485,12 @@ please use an LLM adapter instead.`
           console.error("Error logging LLM error:", logError);
         }
       }
-      if (error instanceof CopilotKitError3) {
+      if (error instanceof CopilotKitError5) {
         throw error;
       }
       console.error("Error getting response:", error);
-      eventSource.sendErrorMessageToChat();
-      throw error;
+      const structuredError = this.convertStreamingErrorToStructured(error);
+      throw structuredError;
     }
   }
   async discoverAgentsFromEndpoints(graphqlContext) {
@@ -3419,7 +3538,7 @@ please use an LLM adapter instead.`
       const cpkEndpoint = endpoint;
       const fetchUrl = `${endpoint.url}/info`;
       try {
-        const response = await fetch(fetchUrl, {
+        const response = await fetchWithRetry(fetchUrl, {
           method: "POST",
           headers: createHeaders(cpkEndpoint.onBeforeRequest, graphqlContext),
           body: JSON.stringify({
@@ -3450,10 +3569,10 @@ please use an LLM adapter instead.`
           ...endpointAgents
         ];
       } catch (error) {
-        if (error instanceof CopilotKitError3) {
+        if (error instanceof CopilotKitError5) {
           throw error;
         }
-        throw new CopilotKitLowLevelError3({
+        throw new CopilotKitLowLevelError4({
           error,
           url: fetchUrl
         });
@@ -3508,7 +3627,7 @@ please use an LLM adapter instead.`
       const cpkEndpoint = agentWithEndpoint.endpoint;
       const fetchUrl = `${cpkEndpoint.url}/agents/state`;
       try {
-        const response = await fetch(fetchUrl, {
+        const response = await fetchWithRetry(fetchUrl, {
           method: "POST",
           headers: createHeaders(cpkEndpoint.onBeforeRequest, graphqlContext),
           body: JSON.stringify({
@@ -3536,10 +3655,10 @@ please use an LLM adapter instead.`
           messages: JSON.stringify(data.messages)
         };
       } catch (error) {
-        if (error instanceof CopilotKitError3) {
+        if (error instanceof CopilotKitError5) {
           throw error;
         }
-        throw new CopilotKitLowLevelError3({
+        throw new CopilotKitLowLevelError4({
           error,
           url: fetchUrl
         });
@@ -3671,7 +3790,8 @@ please use an LLM adapter instead.`
                 console.error("Error logging agent error:", logError);
               }
             }
-            eventStream$.error(err);
+            const structuredError = this.convertStreamingErrorToStructured(err);
+            eventStream$.error(structuredError);
             eventStream$.complete();
           },
           complete: () => eventStream$.complete()
@@ -3833,6 +3953,32 @@ please use an LLM adapter instead.`
       return "langchain";
     return void 0;
   }
+  convertStreamingErrorToStructured(error) {
+    var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j;
+    if (((_a = error == null ? void 0 : error.message) == null ? void 0 : _a.includes("terminated")) || ((_b = error == null ? void 0 : error.cause) == null ? void 0 : _b.code) === "UND_ERR_SOCKET" || ((_c = error == null ? void 0 : error.message) == null ? void 0 : _c.includes("other side closed")) || (error == null ? void 0 : error.code) === "UND_ERR_SOCKET") {
+      return new CopilotKitError5({
+        message: "Connection to agent was unexpectedly terminated. This may be due to the agent service being restarted or network issues. Please try again.",
+        code: CopilotKitErrorCode3.NETWORK_ERROR
+      });
+    }
+    if (((_d = error == null ? void 0 : error.message) == null ? void 0 : _d.includes("fetch failed")) || ((_e = error == null ? void 0 : error.message) == null ? void 0 : _e.includes("ECONNREFUSED")) || ((_f = error == null ? void 0 : error.message) == null ? void 0 : _f.includes("ENOTFOUND")) || ((_g = error == null ? void 0 : error.message) == null ? void 0 : _g.includes("ETIMEDOUT"))) {
+      return new CopilotKitLowLevelError4({
+        error: error instanceof Error ? error : new Error(String(error)),
+        url: "agent streaming connection",
+        message: "Network error occurred during agent streaming. Please check your connection and try again."
+      });
+    }
+    if (((_h = error == null ? void 0 : error.message) == null ? void 0 : _h.includes("aborted")) || ((_i = error == null ? void 0 : error.message) == null ? void 0 : _i.includes("canceled")) || ((_j = error == null ? void 0 : error.message) == null ? void 0 : _j.includes("signal is aborted"))) {
+      return new CopilotKitError5({
+        message: "Agent request was cancelled",
+        code: CopilotKitErrorCode3.UNKNOWN
+      });
+    }
+    return new CopilotKitError5({
+      message: `Agent streaming error: ${(error == null ? void 0 : error.message) || String(error)}`,
+      code: CopilotKitErrorCode3.UNKNOWN
+    });
+  }
 };
 __name(CopilotRuntime, "CopilotRuntime");
 function flattenToolCallsNoDuplicates(toolsByPriority) {
@@ -4063,7 +4209,8 @@ var RuntimeEventSource = class {
   processRuntimeEvents({ serverSideActions, guardrailsResult$, actionInputsWithoutAgents, threadId }) {
     this.callback(this.eventStream$).catch((error) => {
       console.error("Error in event source callback", error);
-      this.sendErrorMessageToChat();
+      const structuredError = convertStreamingErrorToStructured2(error);
+      this.eventStream$.error(structuredError);
       this.eventStream$.complete();
     });
     return this.eventStream$.pipe(
@@ -4102,7 +4249,15 @@ var RuntimeEventSource = class {
           telemetry_client_default.capture("oss.runtime.server_action_executed", {});
           return concat(of(eventWithState.event), toolCallEventStream$).pipe(catchError2((error) => {
             console.error("Error in tool call stream", error);
-            this.sendErrorMessageToChat();
+            const structuredError = convertStreamingErrorToStructured2(error);
+            toolCallEventStream$.sendActionExecutionResult({
+              actionExecutionId: eventWithState.actionExecutionId,
+              actionName: eventWithState.action.name,
+              error: {
+                code: structuredError.code,
+                message: structuredError.message
+              }
+            });
             return EMPTY;
           }));
         } else {
@@ -4175,12 +4330,13 @@ async function executeAction(eventStream$, guardrailsResult$, action, actionArgu
       next: (event) => eventStream$.next(event),
       error: (err) => {
         console.error("Error in stream", err);
+        const structuredError = convertStreamingErrorToStructured2(err);
         eventStream$.sendActionExecutionResult({
           actionExecutionId,
           actionName: action.name,
           error: {
-            code: "STREAM_ERROR",
-            message: err.message
+            code: structuredError.code,
+            message: structuredError.message
           }
         });
         eventStream$.complete();
@@ -4213,6 +4369,40 @@ async function executeAction(eventStream$, guardrailsResult$, action, actionArgu
   }
 }
 __name(executeAction, "executeAction");
+function convertStreamingErrorToStructured2(error) {
+  var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j;
+  if (((_a = error == null ? void 0 : error.message) == null ? void 0 : _a.includes("terminated")) || ((_b = error == null ? void 0 : error.cause) == null ? void 0 : _b.code) === "UND_ERR_SOCKET" || ((_c = error == null ? void 0 : error.message) == null ? void 0 : _c.includes("other side closed")) || (error == null ? void 0 : error.code) === "UND_ERR_SOCKET") {
+    return new CopilotKitError6({
+      message: "Connection to agent was unexpectedly terminated. This may be due to the agent service being restarted or network issues. Please try again.",
+      code: CopilotKitErrorCode4.NETWORK_ERROR
+    });
+  }
+  if (((_d = error == null ? void 0 : error.message) == null ? void 0 : _d.includes("fetch failed")) || ((_e = error == null ? void 0 : error.message) == null ? void 0 : _e.includes("ECONNREFUSED")) || ((_f = error == null ? void 0 : error.message) == null ? void 0 : _f.includes("ENOTFOUND")) || ((_g = error == null ? void 0 : error.message) == null ? void 0 : _g.includes("ETIMEDOUT"))) {
+    return new CopilotKitLowLevelError5({
+      error: error instanceof Error ? error : new Error(String(error)),
+      url: "event streaming connection",
+      message: "Network error occurred during event streaming. Please check your connection and try again."
+    });
+  }
+  if (((_h = error == null ? void 0 : error.message) == null ? void 0 : _h.includes("aborted")) || ((_i = error == null ? void 0 : error.message) == null ? void 0 : _i.includes("canceled")) || ((_j = error == null ? void 0 : error.message) == null ? void 0 : _j.includes("signal is aborted"))) {
+    return new CopilotKitError6({
+      message: "Request was cancelled",
+      code: CopilotKitErrorCode4.UNKNOWN
+    });
+  }
+  const errorMessage = (error == null ? void 0 : error.message) || String(error);
+  if (errorMessage.includes("401") || errorMessage.toLowerCase().includes("api key") || errorMessage.toLowerCase().includes("unauthorized") || errorMessage.toLowerCase().includes("authentication") || errorMessage.toLowerCase().includes("incorrect api key")) {
+    return new CopilotKitError6({
+      message: `Event streaming error: ${errorMessage}`,
+      code: CopilotKitErrorCode4.MISSING_PUBLIC_API_KEY_ERROR
+    });
+  }
+  return new CopilotKitError6({
+    message: `Event streaming error: ${errorMessage}`,
+    code: CopilotKitErrorCode4.UNKNOWN
+  });
+}
+__name(convertStreamingErrorToStructured2, "convertStreamingErrorToStructured");
 
 // src/graphql/resolvers/copilot.resolver.ts
 import { GraphQLJSONObject } from "graphql-scalars";
@@ -4274,6 +4464,7 @@ AgentsResponse = _ts_decorate16([
 ], AgentsResponse);
 
 // src/graphql/resolvers/copilot.resolver.ts
+import { CopilotKitError as CopilotKitError7 } from "@copilotkit/shared";
 function _ts_decorate17(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function")
@@ -4765,6 +4956,12 @@ var CopilotResolver = class {
             logger2.error({
               err
             }, "Error in event stream");
+            if (err instanceof CopilotKitError7 || err instanceof Error && err.name && err.name.includes("CopilotKit")) {
+              eventStreamSubscription == null ? void 0 : eventStreamSubscription.unsubscribe();
+              rejectOutputMessagesPromise(err);
+              stopStreamingMessages(err);
+              return;
+            }
             responseStatus$.next(new UnknownErrorResponse({
               description: `An unknown error has occurred in the event stream`
             }));
@@ -4942,6 +5139,7 @@ LoadAgentStateInput = _ts_decorate19([
 ], LoadAgentStateInput);
 
 // src/graphql/resolvers/state.resolver.ts
+import { CopilotKitAgentDiscoveryError as CopilotKitAgentDiscoveryError2 } from "@copilotkit/shared";
 function _ts_decorate20(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function")
@@ -4969,12 +5167,13 @@ var StateResolver = class {
     const agents = await ctx._copilotkit.runtime.discoverAgentsFromEndpoints(ctx);
     const agent = agents.find((agent2) => agent2.name === data.agentName);
     if (!agent) {
-      return {
-        threadId: data.threadId || "",
-        threadExists: false,
-        state: JSON.stringify({}),
-        messages: JSON.stringify([])
-      };
+      throw new CopilotKitAgentDiscoveryError2({
+        agentName: data.agentName,
+        availableAgents: agents.map((a) => ({
+          name: a.name,
+          id: a.name
+        }))
+      });
     }
     const state = await ctx._copilotkit.runtime.loadAgentState(ctx, data.threadId, data.agentName);
     return state;
@@ -5121,4 +5320,4 @@ export {
   getCommonConfig,
   copilotRuntimeNodeHttpEndpoint
 };
-//# sourceMappingURL=chunk-GOPTDPPB.mjs.map
+//# sourceMappingURL=chunk-YMIOUUPV.mjs.map