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

package/dist/index.js

@@ -44,7 +44,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",
@@ -82,11 +82,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",
@@ -114,10 +114,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",
@@ -431,7 +431,6 @@ var OpenAIAdapter = class {
     const { threadId: threadIdFromRequest, model = this.model, messages, actions, eventSource, forwardedParameters } = request;
     const tools = actions.map(convertActionInputToOpenAITool);
     const threadId = threadIdFromRequest ?? (0, import_shared3.randomUUID)();
-    console.log("messages", messages);
     const validToolUseIds = /* @__PURE__ */ new Set();
     for (const message of messages) {
       if (message.isActionExecutionMessage()) {
@@ -461,29 +460,6 @@ var OpenAIAdapter = class {
         }
       };
     }
-    console.log("INPUT", {
-      model,
-      stream: true,
-      messages: openaiMessages,
-      ...tools.length > 0 && {
-        tools
-      },
-      ...(forwardedParameters == null ? void 0 : forwardedParameters.maxTokens) && {
-        max_tokens: forwardedParameters.maxTokens
-      },
-      ...(forwardedParameters == null ? void 0 : forwardedParameters.stop) && {
-        stop: forwardedParameters.stop
-      },
-      ...toolChoice && {
-        tool_choice: toolChoice
-      },
-      ...this.disableParallelToolCalls && {
-        parallel_tool_calls: false
-      },
-      ...(forwardedParameters == null ? void 0 : forwardedParameters.temperature) && {
-        temperature: forwardedParameters.temperature
-      }
-    });
     try {
       const stream = this.openai.beta.chat.completions.stream({
         model,
@@ -865,6 +841,7 @@ var GoogleGenerativeAIAdapter = class extends LangChainAdapter {
           return message.content && String(message.content).trim().length > 0 || message.tool_calls && message.tool_calls.length > 0;
         });
         const model = new import_google_gauth.ChatGoogle({
+          apiKey: (options == null ? void 0 : options.apiKey) ?? process.env.GOOGLE_API_KEY,
           modelName: (options == null ? void 0 : options.model) ?? "gemini-1.5-pro",
           apiVersion: "v1beta"
         }).bindTools(tools);
@@ -3182,7 +3159,7 @@ function convertMessageToAnthropicMessage(message) {
       content: [
         {
           type: "tool_result",
-          content: message.result,
+          content: message.result || "Action completed successfully",
           tool_use_id: message.actionExecutionId
         }
       ]
@@ -3206,6 +3183,22 @@ var AnthropicAdapter = class {
       this.model = params.model;
     }
   }
+  shouldGenerateFallbackResponse(messages) {
+    var _a, _b, _c;
+    if (messages.length === 0)
+      return false;
+    const lastMessage = messages[messages.length - 1];
+    const endsWithToolResult = lastMessage.role === "user" && Array.isArray(lastMessage.content) && lastMessage.content.some((content) => content.type === "tool_result");
+    if (messages.length >= 3 && endsWithToolResult) {
+      const lastThree = messages.slice(-3);
+      const hasRecentToolPattern = ((_a = lastThree[0]) == null ? void 0 : _a.role) === "user" && // Initial user message
+      ((_b = lastThree[1]) == null ? void 0 : _b.role) === "assistant" && // Assistant tool use
+      Array.isArray(lastThree[1].content) && lastThree[1].content.some((content) => content.type === "tool_use") && ((_c = lastThree[2]) == null ? void 0 : _c.role) === "user" && // Tool result
+      Array.isArray(lastThree[2].content) && lastThree[2].content.some((content) => content.type === "tool_result");
+      return hasRecentToolPattern;
+    }
+    return endsWithToolResult;
+  }
   async process(request) {
     const { threadId, model = this.model, messages: rawMessages, actions, eventSource, forwardedParameters } = request;
     const tools = actions.map(convertActionInputToAnthropicTool);
@@ -3220,18 +3213,22 @@ var AnthropicAdapter = class {
         validToolUseIds.add(message.id);
       }
     }
+    const processedToolResultIds = /* @__PURE__ */ new Set();
     const anthropicMessages = messages.map((message) => {
       if (message.isResultMessage()) {
         if (!validToolUseIds.has(message.actionExecutionId)) {
           return null;
         }
-        validToolUseIds.delete(message.actionExecutionId);
+        if (processedToolResultIds.has(message.actionExecutionId)) {
+          return null;
+        }
+        processedToolResultIds.add(message.actionExecutionId);
         return {
           role: "user",
           content: [
             {
               type: "tool_result",
-              content: message.result,
+              content: message.result || "Action completed successfully",
               tool_use_id: message.actionExecutionId
             }
           ]
@@ -3277,11 +3274,13 @@ var AnthropicAdapter = class {
         let currentMessageId = (0, import_shared10.randomId)();
         let currentToolCallId = (0, import_shared10.randomId)();
         let filterThinkingTextBuffer = new FilterThinkingTextBuffer();
+        let hasReceivedContent = false;
         try {
           for await (const chunk of stream) {
             if (chunk.type === "message_start") {
               currentMessageId = chunk.message.id;
             } else if (chunk.type === "content_block_start") {
+              hasReceivedContent = true;
               if (chunk.content_block.type === "text") {
                 didOutputText = false;
                 filterThinkingTextBuffer.reset();
@@ -3333,6 +3332,27 @@ var AnthropicAdapter = class {
         } catch (error) {
           throw convertServiceAdapterError(error, "Anthropic");
         }
+        if (!hasReceivedContent && this.shouldGenerateFallbackResponse(limitedMessages)) {
+          let fallbackContent = "Task completed successfully.";
+          const lastMessage = limitedMessages[limitedMessages.length - 1];
+          if ((lastMessage == null ? void 0 : lastMessage.role) === "user" && Array.isArray(lastMessage.content)) {
+            const toolResult = lastMessage.content.find((c) => c.type === "tool_result");
+            if ((toolResult == null ? void 0 : toolResult.content) && toolResult.content !== "Action completed successfully") {
+              fallbackContent = toolResult.content;
+            }
+          }
+          currentMessageId = (0, import_shared10.randomId)();
+          eventStream$.sendTextMessageStart({
+            messageId: currentMessageId
+          });
+          eventStream$.sendTextMessageContent({
+            messageId: currentMessageId,
+            content: fallbackContent
+          });
+          eventStream$.sendTextMessageEnd({
+            messageId: currentMessageId
+          });
+        }
         eventStream$.complete();
       });
     } catch (error) {
@@ -4583,7 +4603,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) {
@@ -4592,12 +4612,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)
       });
     }
@@ -4611,9 +4648,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);
@@ -4639,17 +4674,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) {
@@ -4670,8 +4726,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");
 
@@ -4686,8 +4745,8 @@ var CopilotRuntime = class {
   delegateAgentProcessingToServiceAdapter;
   observability;
   availableAgents;
-  onTrace;
-  hasWarnedAboutTracing = false;
+  onError;
+  hasWarnedAboutError = false;
   // +++ MCP Properties +++
   mcpServersConfig;
   mcpActionCache = /* @__PURE__ */ new Map();
@@ -4713,7 +4772,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) {
@@ -4758,7 +4817,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";
@@ -4789,30 +4848,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
+    const eventSource = new RuntimeEventSource({
+      errorHandler: async (error, context) => {
+        await this.error("error", context, error, publicApiKey);
       },
-      agent: agentSession ? {
-        name: agentSession.agentName
-      } : void 0,
-      messages: {
-        input: rawMessages,
-        messageCount: rawMessages.length
-      },
-      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 = {
@@ -4988,7 +5047,7 @@ please use an LLM adapter instead.`
       } else {
         structuredError = (0, import_shared18.ensureStructuredError)(error, (err) => this.convertStreamingErrorToStructured(err));
       }
-      await this.trace("error", {
+      await this.error("error", {
         threadId,
         runId,
         source: "runtime",
@@ -5014,10 +5073,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
@@ -5117,40 +5174,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 import_shared18.CopilotKitAgentDiscoveryError({
-            availableAgents: this.availableAgents
-          });
-        }
-      } catch (e) {
-        throw new import_shared18.CopilotKitMisuseError({
-          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) {
@@ -5210,33 +5242,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 import_langgraph_sdk2.Client({
-        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 import_langgraph_sdk2.Client({
+          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 import_shared18.ResolvedCopilotKitError({
-        status: 400,
-        message: `Agent '${agentName}' failed to execute: ${errorMessage}`,
-        code: import_shared18.CopilotKitErrorCode.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 import_shared18.ResolvedCopilotKitError({
+          status: 400,
+          message: `Agent '${agentName}' failed to execute: ${errorMessage}`,
+          code: import_shared18.CopilotKitErrorCode.CONFIGURATION_ERROR
+        });
+      }
     }
     if (Object.keys(state).length === 0) {
       return {
@@ -5264,7 +5301,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: {
@@ -5332,7 +5369,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,
@@ -5400,7 +5457,7 @@ please use an LLM adapter instead.`
               }
             }
             const structuredError = (0, import_shared18.ensureStructuredError)(err, (error) => this.convertStreamingErrorToStructured(error));
-            await this.trace("error", {
+            await this.error("error", {
               threadId,
               source: "agent",
               request: {
@@ -5489,7 +5546,7 @@ please use an LLM adapter instead.`
         }
       }
       const structuredError = (0, import_shared18.ensureStructuredError)(error, (err) => this.convertStreamingErrorToStructured(err));
-      await this.trace("error", {
+      await this.error("error", {
         threadId,
         source: "agent",
         request: {
@@ -5515,7 +5572,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 = [];
@@ -5538,7 +5595,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,
@@ -5547,7 +5605,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
@@ -5620,18 +5678,18 @@ please use an LLM adapter instead.`
       code: import_shared18.CopilotKitErrorCode.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,
@@ -5639,20 +5697,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: {
@@ -5672,8 +5730,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);
     }
   }
 };
@@ -6281,7 +6339,7 @@ var import_shared26 = require("@copilotkit/shared");
 
 // src/lib/runtime/agui-action.ts
 var import_shared24 = require("@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,
@@ -6316,11 +6374,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
@@ -6434,13 +6500,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;
@@ -6497,7 +6565,9 @@ async function setupRemoteActions({ remoteEndpointDefinitions, graphqlContext, m
       messages,
       agentStates,
       agent,
-      metaEvents
+      metaEvents,
+      threadMetadata,
+      nodeName
     }));
   }
   return result.flat();
@@ -6620,6 +6690,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;
   }
@@ -6634,8 +6710,15 @@ var RuntimeEventSource = class {
     }
   }
   processRuntimeEvents({ serverSideActions, guardrailsResult$, actionInputsWithoutAgents, threadId }) {
-    this.callback(this.eventStream$).catch((error) => {
+    this.callback(this.eventStream$).catch(async (error) => {
       const structuredError = (0, import_shared27.ensureStructuredError)(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();
     });
@@ -6674,6 +6757,19 @@ var RuntimeEventSource = class {
           telemetry_client_default.capture("oss.runtime.server_action_executed", {});
           return (0, import_rxjs3.concat)((0, import_rxjs3.of)(eventWithState.event), toolCallEventStream$).pipe((0, import_rxjs3.catchError)((error) => {
             const structuredError = (0, import_shared27.ensureStructuredError)(error, convertStreamingErrorToStructured2);
+            if (this.errorHandler && this.errorContext) {
+              (0, import_rxjs3.from)(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,
@@ -7018,7 +7114,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"