@copilotkit/runtime 1.9.2-next.9 → 1.9.3-next.0

package/dist/{chunk-Z5GYTKMD.mjs → chunk-EK5RTZVJ.mjs}

@@ -5,11 +5,14 @@ import {
   ResultMessage,
   TextMessage
 } from "./chunk-SHBDMA63.mjs";
+import {
+  BaseMessageInput
+} from "./chunk-2OZAGFV3.mjs";
 import {
   EmptyAdapter,
   RemoteChain,
   streamLangChainResponse
-} from "./chunk-4JBKY7XT.mjs";
+} from "./chunk-QLLV2QVK.mjs";
 import {
   GuardrailsValidationFailureResponse,
   MessageStreamInterruptedResponse,
@@ -17,9 +20,6 @@ import {
   SuccessResponseStatus,
   UnknownErrorResponse
 } from "./chunk-XWBDEXDA.mjs";
-import {
-  BaseMessageInput
-} from "./chunk-2OZAGFV3.mjs";
 import {
   __commonJS,
   __name,
@@ -40,7 +40,7 @@ var require_package = __commonJS({
       publishConfig: {
         access: "public"
       },
-      version: "1.9.2-next.9",
+      version: "1.9.3-next.0",
       sideEffects: false,
       main: "./dist/index.js",
       module: "./dist/index.mjs",
@@ -78,11 +78,11 @@ var require_package = __commonJS({
         "zod-to-json-schema": "^3.23.5"
       },
       dependencies: {
-        "@ag-ui/client": "0.0.28",
-        "@ag-ui/core": "0.0.28",
-        "@ag-ui/encoder": "0.0.28",
-        "@ag-ui/langgraph": "0.0.4",
-        "@ag-ui/proto": "0.0.28",
+        "@ag-ui/client": "0.0.35",
+        "@ag-ui/core": "0.0.35",
+        "@ag-ui/encoder": "0.0.35",
+        "@ag-ui/langgraph": "0.0.7",
+        "@ag-ui/proto": "0.0.35",
         "@anthropic-ai/sdk": "^0.27.3",
         "@copilotkit/shared": "workspace:*",
         "@graphql-yoga/plugin-defer-stream": "^3.3.1",
@@ -110,10 +110,10 @@ var require_package = __commonJS({
         zod: "^3.23.3"
       },
       peerDependencies: {
-        "@ag-ui/client": ">=0.0.28",
-        "@ag-ui/core": ">=0.0.28",
-        "@ag-ui/encoder": ">=0.0.28",
-        "@ag-ui/proto": ">=0.0.28"
+        "@ag-ui/client": ">=0.0.34",
+        "@ag-ui/core": ">=0.0.34",
+        "@ag-ui/encoder": ">=0.0.34",
+        "@ag-ui/proto": ">=0.0.34"
       },
       keywords: [
         "copilotkit",
@@ -2632,7 +2632,7 @@ function extractParametersFromSchema(toolOrSchema) {
   var _a;
   const parameters = [];
   const schema = "schema" in (toolOrSchema || {}) ? toolOrSchema.schema : toolOrSchema;
-  const toolParameters = (schema == null ? void 0 : schema.parameters) || ((_a = schema == null ? void 0 : schema.parameters) == null ? void 0 : _a.jsonSchema);
+  const toolParameters = ((_a = schema == null ? void 0 : schema.parameters) == null ? void 0 : _a.jsonSchema) || (schema == null ? void 0 : schema.parameters);
   const properties = toolParameters == null ? void 0 : toolParameters.properties;
   const requiredParams = new Set((toolParameters == null ? void 0 : toolParameters.required) || []);
   if (!properties) {
@@ -2641,12 +2641,29 @@ function extractParametersFromSchema(toolOrSchema) {
   for (const paramName in properties) {
     if (Object.prototype.hasOwnProperty.call(properties, paramName)) {
       const paramDef = properties[paramName];
+      let type = paramDef.type || "string";
+      let description = paramDef.description || "";
+      if (type === "array" && paramDef.items) {
+        const itemType = paramDef.items.type || "object";
+        if (itemType === "object" && paramDef.items.properties) {
+          const itemProperties = Object.keys(paramDef.items.properties).join(", ");
+          description = description + (description ? " " : "") + `Array of objects with properties: ${itemProperties}`;
+        } else {
+          type = `array<${itemType}>`;
+        }
+      }
+      if (paramDef.enum && Array.isArray(paramDef.enum)) {
+        const enumValues = paramDef.enum.join(" | ");
+        description = description + (description ? " " : "") + `Allowed values: ${enumValues}`;
+      }
+      if (type === "object" && paramDef.properties) {
+        const objectProperties = Object.keys(paramDef.properties).join(", ");
+        description = description + (description ? " " : "") + `Object with properties: ${objectProperties}`;
+      }
       parameters.push({
         name: paramName,
-        // Infer type, default to string. MCP schemas might have more complex types.
-        // This might need refinement based on common MCP schema practices.
-        type: paramDef.type || "string",
-        description: paramDef.description,
+        type,
+        description,
         required: requiredParams.has(paramName)
       });
     }
@@ -2660,9 +2677,7 @@ function convertMCPToolsToActions(mcpTools, mcpEndpoint) {
     const parameters = extractParametersFromSchema(tool);
     const handler = /* @__PURE__ */ __name(async (params) => {
       try {
-        const result = await tool.execute({
-          params
-        });
+        const result = await tool.execute(params);
         return typeof result === "string" ? result : JSON.stringify(result);
       } catch (error) {
         console.error(`Error executing MCP tool '${toolName}' from endpoint ${mcpEndpoint}:`, error);
@@ -2688,17 +2703,38 @@ function generateMcpToolInstructions(toolsMap) {
   }
   const toolEntries = Object.entries(toolsMap);
   const toolsDoc = toolEntries.map(([name, tool]) => {
+    var _a;
     let paramsDoc = "    No parameters required";
     try {
       if (tool.schema && typeof tool.schema === "object") {
         const schema = tool.schema;
-        if (schema.properties) {
-          const requiredParams = schema.required || [];
-          const paramsList = Object.entries(schema.properties).map(([paramName, propSchema]) => {
+        const toolParameters = ((_a = schema.parameters) == null ? void 0 : _a.jsonSchema) || schema.parameters;
+        const properties = (toolParameters == null ? void 0 : toolParameters.properties) || schema.properties;
+        const requiredParams = (toolParameters == null ? void 0 : toolParameters.required) || schema.required || [];
+        if (properties) {
+          const paramsList = Object.entries(properties).map(([paramName, propSchema]) => {
             const propDetails = propSchema;
             const requiredMark = requiredParams.includes(paramName) ? "*" : "";
-            const typeInfo = propDetails.type || "any";
-            const description = propDetails.description ? ` - ${propDetails.description}` : "";
+            let typeInfo = propDetails.type || "any";
+            let description = propDetails.description ? ` - ${propDetails.description}` : "";
+            if (typeInfo === "array" && propDetails.items) {
+              const itemType = propDetails.items.type || "object";
+              if (itemType === "object" && propDetails.items.properties) {
+                const itemProps = Object.keys(propDetails.items.properties).join(", ");
+                typeInfo = `array<object>`;
+                description = description + (description ? " " : " - ") + `Array of objects with properties: ${itemProps}`;
+              } else {
+                typeInfo = `array<${itemType}>`;
+              }
+            }
+            if (propDetails.enum && Array.isArray(propDetails.enum)) {
+              const enumValues = propDetails.enum.join(" | ");
+              description = description + (description ? " " : " - ") + `Allowed values: ${enumValues}`;
+            }
+            if (typeInfo === "object" && propDetails.properties) {
+              const objectProps = Object.keys(propDetails.properties).join(", ");
+              description = description + (description ? " " : " - ") + `Object with properties: ${objectProps}`;
+            }
             return `    - ${paramName}${requiredMark} (${typeInfo})${description}`;
           });
           if (paramsList.length > 0) {
@@ -2719,8 +2755,11 @@ ${toolsDoc}
 When using these tools:
 1. Only provide valid parameters according to their type requirements
 2. Required parameters are marked with *
-3. Format API calls correctly with the expected parameter structure
-4. Always check tool responses to determine your next action`;
+3. For array parameters, provide data in the correct array format
+4. For object parameters, include all required nested properties
+5. For enum parameters, use only the allowed values listed
+6. Format API calls correctly with the expected parameter structure
+7. Always check tool responses to determine your next action`;
 }
 __name(generateMcpToolInstructions, "generateMcpToolInstructions");
 
@@ -2735,8 +2774,8 @@ var CopilotRuntime = class {
   delegateAgentProcessingToServiceAdapter;
   observability;
   availableAgents;
-  onTrace;
-  hasWarnedAboutTracing = false;
+  onError;
+  hasWarnedAboutError = false;
   // +++ MCP Properties +++
   mcpServersConfig;
   mcpActionCache = /* @__PURE__ */ new Map();
@@ -2762,7 +2801,7 @@ var CopilotRuntime = class {
     this.delegateAgentProcessingToServiceAdapter = (params == null ? void 0 : params.delegateAgentProcessingToServiceAdapter) || false;
     this.observability = params == null ? void 0 : params.observability_c;
     this.agents = (params == null ? void 0 : params.agents) ?? {};
-    this.onTrace = params == null ? void 0 : params.onTrace;
+    this.onError = params == null ? void 0 : params.onError;
     this.mcpServersConfig = params == null ? void 0 : params.mcpServers;
     this.createMCPClientImpl = params == null ? void 0 : params.createMCPClient;
     if (this.mcpServersConfig && this.mcpServersConfig.length > 0 && !this.createMCPClientImpl) {
@@ -2807,7 +2846,7 @@ var CopilotRuntime = class {
     if (!mcpToolInstructions) {
       return messages;
     }
-    const instructions = "You have access to the following tools provided by external Model Context Protocol (MCP) servers:\n" + mcpToolInstructions + "\nUse them when appropriate to fulfill the user's request.";
+    const instructions = mcpToolInstructions + "\nUse them when appropriate to fulfill the user's request.";
     const systemMessageIndex = messages.findIndex((msg) => {
       var _a;
       return ((_a = msg.textMessage) == null ? void 0 : _a.role) === "system";
@@ -2838,30 +2877,30 @@ var CopilotRuntime = class {
   async processRuntimeRequest(request) {
     var _a, _b, _c, _d, _e;
     const { serviceAdapter, messages: rawMessages, actions: clientSideActionsInput, threadId, runId, outputMessagesPromise, graphqlContext, forwardedParameters, url, extensions, agentSession, agentStates, publicApiKey } = request;
-    const eventSource = new RuntimeEventSource();
-    const requestStartTime = Date.now();
-    const streamedChunks = [];
-    await this.trace("request", {
-      threadId,
-      runId,
-      source: "runtime",
-      request: {
-        operation: "processRuntimeRequest",
-        method: "POST",
-        url,
-        startTime: requestStartTime
-      },
-      agent: agentSession ? {
-        name: agentSession.agentName
-      } : void 0,
-      messages: {
-        input: rawMessages,
-        messageCount: rawMessages.length
+    const eventSource = new RuntimeEventSource({
+      errorHandler: async (error, context) => {
+        await this.error("error", context, error, publicApiKey);
       },
-      technical: {
-        environment: process.env.NODE_ENV
+      errorContext: {
+        threadId,
+        runId,
+        source: "runtime",
+        request: {
+          operation: "processRuntimeRequest",
+          method: "POST",
+          url,
+          startTime: Date.now()
+        },
+        agent: agentSession ? {
+          name: agentSession.agentName
+        } : void 0,
+        technical: {
+          environment: process.env.NODE_ENV
+        }
       }
-    }, void 0, publicApiKey);
+    });
+    const requestStartTime = Date.now();
+    const streamedChunks = [];
     try {
       if (Object.keys(this.agents).length && (agentSession == null ? void 0 : agentSession.agentName) && !this.delegateAgentProcessingToServiceAdapter) {
         this.agents = {
@@ -3037,7 +3076,7 @@ please use an LLM adapter instead.`
       } else {
         structuredError = ensureStructuredError2(error, (err) => this.convertStreamingErrorToStructured(err));
       }
-      await this.trace("error", {
+      await this.error("error", {
         threadId,
         runId,
         source: "runtime",
@@ -3063,10 +3102,8 @@ please use an LLM adapter instead.`
     }
   }
   async getAllAgents(graphqlContext) {
-    const [agentsWithEndpoints, aguiAgents] = await Promise.all([
-      this.discoverAgentsFromEndpoints(graphqlContext),
-      this.discoverAgentsFromAgui()
-    ]);
+    const agentsWithEndpoints = await this.discoverAgentsFromEndpoints(graphqlContext);
+    const aguiAgents = this.discoverAgentsFromAgui();
     this.availableAgents = [
       ...agentsWithEndpoints,
       ...aguiAgents
@@ -3166,40 +3203,15 @@ please use an LLM adapter instead.`
     }, Promise.resolve([]));
     return agents;
   }
-  async discoverAgentsFromAgui() {
-    const agents = Object.values(this.agents ?? []).reduce(async (acc, agent) => {
-      const agents2 = await acc;
-      const client = agent.client;
-      let data = [];
-      try {
-        data = await client.assistants.search();
-        if (data && "detail" in data && data.detail.toLowerCase() === "not found") {
-          throw new CopilotKitAgentDiscoveryError({
-            availableAgents: this.availableAgents
-          });
-        }
-      } catch (e) {
-        throw new CopilotKitMisuseError2({
-          message: `
-              Failed to find or contact agent ${agent.graphId}.
-              Make sure the LangGraph API is running and the agent is defined in langgraph.json
-              
-              See more: https://docs.copilotkit.ai/troubleshooting/common-issues`
-        });
-      }
-      const endpointAgents = data.map((entry) => ({
-        name: entry.graph_id,
-        id: entry.assistant_id,
-        description: ""
-      }));
-      return [
-        ...agents2,
-        ...endpointAgents
-      ];
-    }, Promise.resolve([]));
-    return agents;
+  discoverAgentsFromAgui() {
+    return Object.entries(this.agents ?? []).map(([key, agent]) => ({
+      name: agent.agentName ?? key,
+      id: agent.agentId ?? key,
+      description: agent.description ?? ""
+    }));
   }
   async loadAgentState(graphqlContext, threadId, agentName) {
+    var _a;
     const agents = await this.getAllAgents(graphqlContext);
     const agent = agents.find((agent2) => agent2.name === agentName);
     if (!agent) {
@@ -3259,33 +3271,38 @@ please use an LLM adapter instead.`
     const propertyHeaders = graphqlContext.properties.authorization ? {
       authorization: `Bearer ${graphqlContext.properties.authorization}`
     } : null;
-    let client;
-    if ("endpoint" in agent && agent.endpoint.type === EndpointType.LangGraphPlatform) {
-      client = new LangGraphClient2({
-        apiUrl: agent.endpoint.deploymentUrl,
-        apiKey: agent.endpoint.langsmithApiKey,
-        defaultHeaders: {
-          ...propertyHeaders
-        }
-      });
-    } else {
-      const aguiAgent = graphqlContext._copilotkit.runtime.agents[agent.name];
-      if (!aguiAgent) {
-        throw new Error(`Agent: ${agent.name} could not be resolved`);
-      }
-      client = aguiAgent.client;
-    }
     let state = {};
     try {
-      state = (await client.threads.getState(threadId)).values;
+      let client;
+      if ("endpoint" in agent && agent.endpoint.type === EndpointType.LangGraphPlatform) {
+        client = new LangGraphClient2({
+          apiUrl: agent.endpoint.deploymentUrl,
+          apiKey: agent.endpoint.langsmithApiKey,
+          defaultHeaders: {
+            ...propertyHeaders
+          }
+        });
+      } else {
+        const aguiAgent = graphqlContext._copilotkit.runtime.agents[agent.name];
+        if (!aguiAgent) {
+          throw new Error(`Agent: ${agent.name} could not be resolved`);
+        }
+        client = aguiAgent.client ?? null;
+      }
+      state = client ? (await client.threads.getState(threadId)).values : {};
     } catch (error) {
       const errorMessage = error instanceof Error ? error.message : String(error);
-      console.debug(`Agent '${agentName}' configuration issue: ${errorMessage}`);
-      throw new ResolvedCopilotKitError({
-        status: 400,
-        message: `Agent '${agentName}' failed to execute: ${errorMessage}`,
-        code: CopilotKitErrorCode2.CONFIGURATION_ERROR
-      });
+      const errorStatus = ((_a = error == null ? void 0 : error.response) == null ? void 0 : _a.status) || (error == null ? void 0 : error.status);
+      if (errorStatus === 404) {
+        state = {};
+      } else {
+        console.debug(`Agent '${agentName}' configuration issue: ${errorMessage}`);
+        throw new ResolvedCopilotKitError({
+          status: 400,
+          message: `Agent '${agentName}' failed to execute: ${errorMessage}`,
+          code: CopilotKitErrorCode2.CONFIGURATION_ERROR
+        });
+      }
     }
     if (Object.keys(state).length === 0) {
       return {
@@ -3313,7 +3330,7 @@ please use an LLM adapter instead.`
     const requestStartTime = Date.now();
     const streamedChunks = [];
     const threadId = threadIdFromRequest ?? agentSession.threadId;
-    await this.trace("agent_state", {
+    await this.error("agent_state", {
       threadId,
       source: "agent",
       request: {
@@ -3381,7 +3398,27 @@ please use an LLM adapter instead.`
       properties: graphqlContext.properties
     }));
     try {
-      const eventSource = new RuntimeEventSource();
+      const eventSource = new RuntimeEventSource({
+        errorHandler: async (error, context) => {
+          await this.error("error", context, error, publicApiKey);
+        },
+        errorContext: {
+          threadId,
+          source: "agent",
+          request: {
+            operation: "processAgentRequest",
+            method: "POST",
+            startTime: requestStartTime
+          },
+          agent: {
+            name: agentName,
+            nodeName
+          },
+          technical: {
+            environment: process.env.NODE_ENV
+          }
+        }
+      });
       const stream = await currentAgent.remoteAgentHandler({
         name: agentName,
         threadId,
@@ -3449,7 +3486,7 @@ please use an LLM adapter instead.`
               }
             }
             const structuredError = ensureStructuredError2(err, (error) => this.convertStreamingErrorToStructured(error));
-            await this.trace("error", {
+            await this.error("error", {
               threadId,
               source: "agent",
               request: {
@@ -3538,7 +3575,7 @@ please use an LLM adapter instead.`
         }
       }
       const structuredError = ensureStructuredError2(error, (err) => this.convertStreamingErrorToStructured(err));
-      await this.trace("error", {
+      await this.error("error", {
         threadId,
         source: "agent",
         request: {
@@ -3564,7 +3601,7 @@ please use an LLM adapter instead.`
     }
   }
   async getServerSideActions(request) {
-    var _a, _b;
+    var _a, _b, _c;
     const { graphqlContext, messages: rawMessages, agentStates, url } = request;
     const inputMessages = convertGqlInputToMessages(rawMessages);
     const langserveFunctions = [];
@@ -3587,7 +3624,8 @@ please use an LLM adapter instead.`
       agentStates,
       frontendUrl: url,
       agents: this.agents,
-      metaEvents: request.metaEvents
+      metaEvents: request.metaEvents,
+      nodeName: (_a = request.agentSession) == null ? void 0 : _a.nodeName
     });
     const configuredActions = typeof this.actions === "function" ? this.actions({
       properties: graphqlContext.properties,
@@ -3596,7 +3634,7 @@ please use an LLM adapter instead.`
     const requestSpecificMCPActions = [];
     if (this.createMCPClientImpl) {
       const baseEndpoints = this.mcpServersConfig || [];
-      const requestEndpoints = ((_a = graphqlContext.properties) == null ? void 0 : _a.mcpServers) || ((_b = graphqlContext.properties) == null ? void 0 : _b.mcpEndpoints) || [];
+      const requestEndpoints = ((_b = graphqlContext.properties) == null ? void 0 : _b.mcpServers) || ((_c = graphqlContext.properties) == null ? void 0 : _c.mcpEndpoints) || [];
       const effectiveEndpointsMap = /* @__PURE__ */ new Map();
       [
         ...baseEndpoints
@@ -3669,18 +3707,18 @@ please use an LLM adapter instead.`
       code: CopilotKitErrorCode2.UNKNOWN
     });
   }
-  async trace(type, context, error, publicApiKey) {
-    if (!this.onTrace)
+  async error(type, context, error, publicApiKey) {
+    if (!this.onError)
       return;
     if (!publicApiKey) {
-      if (!this.hasWarnedAboutTracing) {
-        console.warn("CopilotKit: onTrace handler provided but requires publicApiKey to be defined for tracing to work.");
-        this.hasWarnedAboutTracing = true;
+      if (!this.hasWarnedAboutError) {
+        console.warn("CopilotKit: onError handler provided but requires publicApiKey to be defined for error handling to work.");
+        this.hasWarnedAboutError = true;
       }
       return;
     }
     try {
-      const traceEvent = {
+      const errorEvent = {
         type,
         timestamp: Date.now(),
         context,
@@ -3688,20 +3726,20 @@ please use an LLM adapter instead.`
           error
         }
       };
-      await this.onTrace(traceEvent);
-    } catch (traceError) {
-      console.error("Error in onTrace handler:", traceError);
+      await this.onError(errorEvent);
+    } catch (errorHandlerError) {
+      console.error("Error in onError handler:", errorHandlerError);
     }
   }
   /**
-  * Public method to trace GraphQL validation errors
-  * This allows the GraphQL resolver to send validation errors through the trace system
+  * Public method to handle GraphQL validation errors
+  * This allows the GraphQL resolver to send validation errors through the error system
   */
-  async traceGraphQLError(error, context) {
-    if (!this.onTrace)
+  async errorGraphQLError(error, context) {
+    if (!this.onError)
       return;
     try {
-      await this.onTrace({
+      await this.onError({
         type: "error",
         timestamp: Date.now(),
         context: {
@@ -3721,8 +3759,8 @@ please use an LLM adapter instead.`
         },
         error
       });
-    } catch (traceError) {
-      console.error("Error in onTrace handler:", traceError);
+    } catch (errorHandlerError) {
+      console.error("Error in onError handler:", errorHandlerError);
     }
   }
 };
@@ -4330,7 +4368,7 @@ import { CopilotKitLowLevelError as CopilotKitLowLevelError6, ResolvedCopilotKit
 
 // src/lib/runtime/agui-action.ts
 import { parseJson as parseJson3 } from "@copilotkit/shared";
-function constructAGUIRemoteAction({ logger: logger2, messages, agentStates, agent, metaEvents }) {
+function constructAGUIRemoteAction({ logger: logger2, messages, agentStates, agent, metaEvents, threadMetadata, nodeName }) {
   const action = {
     name: agent.agentId,
     description: agent.description,
@@ -4365,11 +4403,19 @@ function constructAGUIRemoteAction({ logger: logger2, messages, agentStates, age
           parameters: JSON.parse(input.jsonSchema)
         };
       });
-      const forwardedProps = metaEvents.length ? {
-        command: {
-          resume: (_a = metaEvents[0]) == null ? void 0 : _a.response
-        }
-      } : void 0;
+      const forwardedProps = {
+        ...(metaEvents == null ? void 0 : metaEvents.length) ? {
+          command: {
+            resume: (_a = metaEvents[0]) == null ? void 0 : _a.response
+          }
+        } : {},
+        ...threadMetadata ? {
+          threadMetadata
+        } : {},
+        ...nodeName ? {
+          nodeName
+        } : {}
+      };
       return agent.legacy_to_be_removed_runAgentBridged({
         tools,
         forwardedProps
@@ -4483,13 +4529,15 @@ async function fetchRemoteInfo({ url, onBeforeRequest, graphqlContext, logger: l
   }
 }
 __name(fetchRemoteInfo, "fetchRemoteInfo");
-async function setupRemoteActions({ remoteEndpointDefinitions, graphqlContext, messages, agentStates, frontendUrl, agents, metaEvents }) {
+async function setupRemoteActions({ remoteEndpointDefinitions, graphqlContext, messages, agentStates, frontendUrl, agents, metaEvents, nodeName }) {
+  var _a;
   const logger2 = graphqlContext.logger.child({
     component: "remote-actions.fetchRemoteActions"
   });
   logger2.debug({
     remoteEndpointDefinitions
   }, "Fetching from remote endpoints");
+  const threadMetadata = ((_a = graphqlContext.properties) == null ? void 0 : _a.threadMetadata) || {};
   const filtered = remoteEndpointDefinitions.filter((value, index, self) => {
     if (value.type === "langgraph-platform") {
       return value;
@@ -4546,7 +4594,9 @@ async function setupRemoteActions({ remoteEndpointDefinitions, graphqlContext, m
       messages,
       agentStates,
       agent,
-      metaEvents
+      metaEvents,
+      threadMetadata,
+      nodeName
     }));
   }
   return result.flat();
@@ -4669,6 +4719,12 @@ __name(RuntimeEventSubject, "RuntimeEventSubject");
 var RuntimeEventSource = class {
   eventStream$ = new RuntimeEventSubject();
   callback;
+  errorHandler;
+  errorContext;
+  constructor(params) {
+    this.errorHandler = params == null ? void 0 : params.errorHandler;
+    this.errorContext = params == null ? void 0 : params.errorContext;
+  }
   async stream(callback) {
     this.callback = callback;
   }
@@ -4683,8 +4739,15 @@ var RuntimeEventSource = class {
     }
   }
   processRuntimeEvents({ serverSideActions, guardrailsResult$, actionInputsWithoutAgents, threadId }) {
-    this.callback(this.eventStream$).catch((error) => {
+    this.callback(this.eventStream$).catch(async (error) => {
       const structuredError = ensureStructuredError3(error, convertStreamingErrorToStructured2);
+      if (this.errorHandler && this.errorContext) {
+        try {
+          await this.errorHandler(structuredError, this.errorContext);
+        } catch (errorHandlerError) {
+          console.error("Error in streaming error handler:", errorHandlerError);
+        }
+      }
       this.eventStream$.error(structuredError);
       this.eventStream$.complete();
     });
@@ -4723,6 +4786,19 @@ var RuntimeEventSource = class {
           telemetry_client_default.capture("oss.runtime.server_action_executed", {});
           return concat(of(eventWithState.event), toolCallEventStream$).pipe(catchError2((error) => {
             const structuredError = ensureStructuredError3(error, convertStreamingErrorToStructured2);
+            if (this.errorHandler && this.errorContext) {
+              from2(this.errorHandler(structuredError, {
+                ...this.errorContext,
+                action: {
+                  name: eventWithState.action.name,
+                  executionId: eventWithState.actionExecutionId
+                }
+              })).subscribe({
+                error: (errorHandlerError) => {
+                  console.error("Error in action execution error handler:", errorHandlerError);
+                }
+              });
+            }
             toolCallEventStream$.sendActionExecutionResult({
               actionExecutionId: eventWithState.actionExecutionId,
               actionName: eventWithState.action.name,
@@ -5031,7 +5107,7 @@ var CopilotResolver = class {
       logger2.debug("Cloud configuration provided, checking for public API key in headers");
       if (!copilotCloudPublicApiKey) {
         logger2.error("Public API key not found in headers");
-        await copilotRuntime.traceGraphQLError({
+        await copilotRuntime.errorGraphQLError({
           message: "X-CopilotCloud-Public-API-Key header is required",
           code: "MISSING_PUBLIC_API_KEY",
           type: "GraphQLError"
@@ -5839,4 +5915,4 @@ export {
   getCommonConfig,
   copilotRuntimeNodeHttpEndpoint
 };
-//# sourceMappingURL=chunk-Z5GYTKMD.mjs.map
+//# sourceMappingURL=chunk-EK5RTZVJ.mjs.map