@copilotkit/runtime 1.9.2-next.8 → 1.9.2-next.9

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

@@ -1,22 +1,22 @@
+import {
+  ActionExecutionMessage,
+  AgentStateMessage,
+  ImageMessage,
+  ResultMessage,
+  TextMessage
+} from "./chunk-SHBDMA63.mjs";
 import {
   EmptyAdapter,
   RemoteChain,
   streamLangChainResponse
-} from "./chunk-IIXJVVTV.mjs";
+} from "./chunk-4JBKY7XT.mjs";
 import {
   GuardrailsValidationFailureResponse,
   MessageStreamInterruptedResponse,
   ResponseStatusUnion,
   SuccessResponseStatus,
   UnknownErrorResponse
-} from "./chunk-5BIEM2UU.mjs";
-import {
-  ActionExecutionMessage,
-  AgentStateMessage,
-  ImageMessage,
-  ResultMessage,
-  TextMessage
-} from "./chunk-SHBDMA63.mjs";
+} from "./chunk-XWBDEXDA.mjs";
 import {
   BaseMessageInput
 } from "./chunk-2OZAGFV3.mjs";
@@ -40,7 +40,7 @@ var require_package = __commonJS({
       publishConfig: {
         access: "public"
       },
-      version: "1.9.2-next.8",
+      version: "1.9.2-next.9",
       sideEffects: false,
       main: "./dist/index.js",
       module: "./dist/index.mjs",
@@ -1485,20 +1485,166 @@ GenerateCopilotResponseInput = _ts_decorate15([
 import { Repeater } from "graphql-yoga";
 
 // src/service-adapters/events.ts
-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";
+import { CopilotKitError as CopilotKitError6, CopilotKitErrorCode as CopilotKitErrorCode4, CopilotKitLowLevelError as CopilotKitLowLevelError7, ensureStructuredError as ensureStructuredError3, randomId as randomId2, Severity } from "@copilotkit/shared";
+import { plainToInstance as plainToInstance2 } from "class-transformer";
+import { catchError as catchError2, concat, concatMap, EMPTY, firstValueFrom, from as from2, of, ReplaySubject as ReplaySubject2, scan as scan2 } from "rxjs";
 
 // src/lib/runtime/remote-actions.ts
-import { CopilotKitErrorCode as CopilotKitErrorCode2 } from "@copilotkit/shared";
+import { CopilotKitErrorCode as CopilotKitErrorCode3 } from "@copilotkit/shared";
 
 // src/lib/runtime/remote-action-constructors.ts
+import { createHash as createHash3 } from "crypto";
+
+// src/lib/telemetry-client.ts
+import { TelemetryClient } from "@copilotkit/shared";
 import { createHash as createHash2 } from "crypto";
 
-// src/agents/langgraph/event-source.ts
-import { catchError, mergeMap, ReplaySubject, scan } from "rxjs";
+// src/lib/runtime/copilot-runtime.ts
+import { actionParametersToJsonSchema, ResolvedCopilotKitError, CopilotKitApiDiscoveryError, randomId, CopilotKitError as CopilotKitError3, CopilotKitAgentDiscoveryError, CopilotKitMisuseError as CopilotKitMisuseError2, CopilotKitErrorCode as CopilotKitErrorCode2, CopilotKitLowLevelError as CopilotKitLowLevelError3, ensureStructuredError as ensureStructuredError2 } from "@copilotkit/shared";
+
+// src/service-adapters/conversion.ts
+import { plainToInstance } from "class-transformer";
+import { tryMap } from "@copilotkit/shared";
+function convertGqlInputToMessages(inputMessages) {
+  const messages = tryMap(inputMessages, (message) => {
+    if (message.textMessage) {
+      return plainToInstance(TextMessage, {
+        id: message.id,
+        createdAt: message.createdAt,
+        role: message.textMessage.role,
+        content: message.textMessage.content,
+        parentMessageId: message.textMessage.parentMessageId
+      });
+    } else if (message.imageMessage) {
+      return plainToInstance(ImageMessage, {
+        id: message.id,
+        createdAt: message.createdAt,
+        role: message.imageMessage.role,
+        bytes: message.imageMessage.bytes,
+        format: message.imageMessage.format,
+        parentMessageId: message.imageMessage.parentMessageId
+      });
+    } else if (message.actionExecutionMessage) {
+      return plainToInstance(ActionExecutionMessage, {
+        id: message.id,
+        createdAt: message.createdAt,
+        name: message.actionExecutionMessage.name,
+        arguments: JSON.parse(message.actionExecutionMessage.arguments),
+        parentMessageId: message.actionExecutionMessage.parentMessageId
+      });
+    } else if (message.resultMessage) {
+      return plainToInstance(ResultMessage, {
+        id: message.id,
+        createdAt: message.createdAt,
+        actionExecutionId: message.resultMessage.actionExecutionId,
+        actionName: message.resultMessage.actionName,
+        result: message.resultMessage.result
+      });
+    } else if (message.agentStateMessage) {
+      return plainToInstance(AgentStateMessage, {
+        id: message.id,
+        threadId: message.agentStateMessage.threadId,
+        createdAt: message.createdAt,
+        agentName: message.agentStateMessage.agentName,
+        nodeName: message.agentStateMessage.nodeName,
+        runId: message.agentStateMessage.runId,
+        active: message.agentStateMessage.active,
+        role: message.agentStateMessage.role,
+        state: JSON.parse(message.agentStateMessage.state),
+        running: message.agentStateMessage.running
+      });
+    } else {
+      return null;
+    }
+  });
+  return messages.filter((m) => m);
+}
+__name(convertGqlInputToMessages, "convertGqlInputToMessages");
+
+// src/lib/runtime/copilot-runtime.ts
+import { from } from "rxjs";
+
+// 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/copilot-runtime.ts
+import { Client as LangGraphClient2 } from "@langchain/langgraph-sdk";
+
+// src/lib/runtime/remote-lg-action.ts
+import { Client as LangGraphClient } from "@langchain/langgraph-sdk";
+import { createHash } from "crypto";
+import { isValidUUID, randomUUID } from "@copilotkit/shared";
+import { parse as parsePartialJson } from "partial-json";
 
 // src/agents/langgraph/events.ts
 var LangGraphEventTypes;
@@ -1517,6 +1663,7 @@ var LangGraphEventTypes;
   LangGraphEventTypes2["OnCustomEvent"] = "on_custom_event";
   LangGraphEventTypes2["OnInterrupt"] = "on_interrupt";
   LangGraphEventTypes2["OnCopilotKitInterrupt"] = "on_copilotkit_interrupt";
+  LangGraphEventTypes2["OnCopilotKitError"] = "on_copilotkit_error";
 })(LangGraphEventTypes || (LangGraphEventTypes = {}));
 var MetaEventNames;
 (function(MetaEventNames2) {
@@ -1531,326 +1678,274 @@ var CustomEventNames;
   CustomEventNames2["CopilotKitExit"] = "copilotkit_exit";
 })(CustomEventNames || (CustomEventNames = {}));
 
-// src/agents/langgraph/event-source.ts
-import { randomId, CopilotKitError } from "@copilotkit/shared";
-var RemoteLangGraphEventSource = class {
-  eventStream$ = new ReplaySubject();
-  shouldEmitToolCall(shouldEmitToolCalls, toolCallName) {
-    if (typeof shouldEmitToolCalls === "boolean") {
-      return shouldEmitToolCalls;
-    }
-    if (Array.isArray(shouldEmitToolCalls)) {
-      return shouldEmitToolCalls.includes(toolCallName);
+// src/lib/runtime/remote-lg-action.ts
+import { parseJson, CopilotKitMisuseError, CopilotKitLowLevelError as CopilotKitLowLevelError2, CopilotKitError as CopilotKitError2 } from "@copilotkit/shared";
+import { RemoveMessage } from "@langchain/core/messages";
+
+// src/lib/streaming.ts
+import { CopilotKitLowLevelError, CopilotKitError, CopilotKitErrorCode, ensureStructuredError } from "@copilotkit/shared";
+
+// src/lib/error-messages.ts
+var errorConfig = {
+  errorPatterns: {
+    ECONNREFUSED: {
+      message: "Connection refused - the agent service is not running or not accessible at the specified address. Please check that your agent is started and listening on the correct port.",
+      category: "network",
+      severity: "error",
+      actionable: true
+    },
+    ENOTFOUND: {
+      message: "Host not found - the agent service URL appears to be incorrect or the service is not accessible. Please verify the agent endpoint URL.",
+      category: "network",
+      severity: "error",
+      actionable: true
+    },
+    ETIMEDOUT: {
+      message: "Connection timeout - the agent service is taking too long to respond. This could indicate network issues or an overloaded agent service.",
+      category: "network",
+      severity: "warning",
+      actionable: true
+    },
+    terminated: {
+      message: "Agent {context} was unexpectedly terminated. This often indicates an error in the agent service (e.g., authentication failures, missing environment variables, or agent crashes). Check the agent logs for the root cause.",
+      category: "connection",
+      severity: "error",
+      actionable: true
+    },
+    UND_ERR_SOCKET: {
+      message: "Socket connection was closed unexpectedly. This typically indicates the agent service encountered an error and shut down the connection. Check the agent logs for the underlying cause.",
+      category: "connection",
+      severity: "error",
+      actionable: true
+    },
+    other_side_closed: {
+      message: "The agent service closed the connection unexpectedly. This usually indicates an error in the agent service. Check the agent logs for more details.",
+      category: "connection",
+      severity: "error",
+      actionable: true
+    },
+    fetch_failed: {
+      message: "Failed to connect to the agent service. Please verify the agent is running and the endpoint URL is correct.",
+      category: "network",
+      severity: "error",
+      actionable: true
+    },
+    // Authentication patterns
+    "401": {
+      message: "Authentication failed. Please check your API keys and ensure they are correctly configured.",
+      category: "authentication",
+      severity: "error",
+      actionable: true
+    },
+    "api key": {
+      message: "API key error detected. Please verify your API key is correct and has the necessary permissions.",
+      category: "authentication",
+      severity: "error",
+      actionable: true
+    },
+    unauthorized: {
+      message: "Unauthorized access. Please check your authentication credentials.",
+      category: "authentication",
+      severity: "error",
+      actionable: true
+    },
+    // Python-specific error patterns
+    AuthenticationError: {
+      message: "OpenAI authentication failed. Please check your OPENAI_API_KEY environment variable or API key configuration.",
+      category: "authentication",
+      severity: "error",
+      actionable: true
+    },
+    "Incorrect API key provided": {
+      message: "OpenAI API key is invalid. Please verify your OPENAI_API_KEY is correct and active.",
+      category: "authentication",
+      severity: "error",
+      actionable: true
+    },
+    RateLimitError: {
+      message: "OpenAI rate limit exceeded. Please wait a moment and try again, or check your OpenAI usage limits.",
+      category: "network",
+      severity: "warning",
+      actionable: true
+    },
+    InvalidRequestError: {
+      message: "Invalid request to OpenAI API. Please check your request parameters and model configuration.",
+      category: "validation",
+      severity: "error",
+      actionable: true
+    },
+    PermissionDeniedError: {
+      message: "Permission denied for OpenAI API. Please check your API key permissions and billing status.",
+      category: "authentication",
+      severity: "error",
+      actionable: true
+    },
+    NotFoundError: {
+      message: "OpenAI resource not found. Please check your model name and availability.",
+      category: "validation",
+      severity: "error",
+      actionable: true
     }
-    return shouldEmitToolCalls === toolCallName;
+  },
+  fallbacks: {
+    network: "A network error occurred while connecting to the agent service. Please check your connection and ensure the agent service is running.",
+    connection: "The connection to the agent service was lost unexpectedly. This may indicate an issue with the agent service.",
+    authentication: "Authentication failed. Please check your API keys and credentials.",
+    validation: "Invalid input or configuration. Please check your parameters and try again.",
+    unknown: "An unexpected error occurred. Please check the logs for more details.",
+    default: "An unexpected error occurred. Please check the logs for more details."
+  },
+  contextTemplates: {
+    connection: "connection",
+    event_streaming_connection: "event streaming connection",
+    agent_streaming_connection: "agent streaming connection",
+    langgraph_agent_connection: "LangGraph agent connection"
   }
-  getCurrentContent(event) {
-    var _a, _b, _c, _d, _e;
-    const content = ((_c = (_b = (_a = event.data) == null ? void 0 : _a.chunk) == null ? void 0 : _b.kwargs) == null ? void 0 : _c.content) ?? ((_e = (_d = event.data) == null ? void 0 : _d.chunk) == null ? void 0 : _e.content);
-    if (!content) {
-      const toolCallChunks = this.getCurrentToolCallChunks(event) ?? [];
-      for (const chunk of toolCallChunks) {
-        if (chunk.args) {
-          return chunk.args;
-        }
-      }
+};
+function getFallbackMessage(category) {
+  return errorConfig.fallbacks[category] || errorConfig.fallbacks.default;
+}
+__name(getFallbackMessage, "getFallbackMessage");
+
+// src/lib/streaming.ts
+async function writeJsonLineResponseToEventStream(response, eventStream$) {
+  const reader = response.getReader();
+  const decoder = new TextDecoder();
+  let buffer = [];
+  function flushBuffer() {
+    const currentBuffer = buffer.join("");
+    if (currentBuffer.trim().length === 0) {
+      return;
     }
-    if (typeof content === "string") {
-      return content;
-    } else if (Array.isArray(content) && content.length > 0) {
-      return content[0].text;
+    const parts = currentBuffer.split("\n");
+    if (parts.length === 0) {
+      return;
     }
-    return null;
+    const lastPartIsComplete = currentBuffer.endsWith("\n");
+    buffer = [];
+    if (!lastPartIsComplete) {
+      buffer.push(parts.pop());
+    }
+    parts.map((part) => part.trim()).filter((part) => part != "").forEach((part) => {
+      eventStream$.next(JSON.parse(part));
+    });
   }
-  getCurrentMessageId(event) {
-    var _a, _b, _c, _d, _e;
-    return ((_c = (_b = (_a = event.data) == null ? void 0 : _a.chunk) == null ? void 0 : _b.kwargs) == null ? void 0 : _c.id) ?? ((_e = (_d = event.data) == null ? void 0 : _d.chunk) == null ? void 0 : _e.id);
+  __name(flushBuffer, "flushBuffer");
+  try {
+    while (true) {
+      const { done, value } = await reader.read();
+      if (!done) {
+        buffer.push(decoder.decode(value, {
+          stream: true
+        }));
+      }
+      flushBuffer();
+      if (done) {
+        break;
+      }
+    }
+  } catch (error) {
+    const structuredError = ensureStructuredError(error, convertStreamingErrorToStructured);
+    eventStream$.error(structuredError);
+    return;
   }
-  getCurrentToolCallChunks(event) {
-    var _a, _b, _c, _d, _e;
-    return ((_c = (_b = (_a = event.data) == null ? void 0 : _a.chunk) == null ? void 0 : _b.kwargs) == null ? void 0 : _c.tool_call_chunks) ?? ((_e = (_d = event.data) == null ? void 0 : _d.chunk) == null ? void 0 : _e.tool_call_chunks);
+  eventStream$.complete();
+}
+__name(writeJsonLineResponseToEventStream, "writeJsonLineResponseToEventStream");
+function convertStreamingErrorToStructured(error) {
+  var _a, _b, _c, _d, _e, _f, _g;
+  let helpfulMessage = generateHelpfulErrorMessage(error);
+  if (((_a = error == null ? void 0 : error.message) == null ? void 0 : _a.includes("fetch failed")) || ((_b = error == null ? void 0 : error.message) == null ? void 0 : _b.includes("ECONNREFUSED")) || ((_c = error == null ? void 0 : error.message) == null ? void 0 : _c.includes("ENOTFOUND")) || ((_d = error == null ? void 0 : error.message) == null ? void 0 : _d.includes("ETIMEDOUT")) || ((_e = error == null ? void 0 : error.message) == null ? void 0 : _e.includes("terminated")) || ((_f = error == null ? void 0 : error.cause) == null ? void 0 : _f.code) === "UND_ERR_SOCKET" || ((_g = error == null ? void 0 : error.message) == null ? void 0 : _g.includes("other side closed")) || (error == null ? void 0 : error.code) === "UND_ERR_SOCKET") {
+    return new CopilotKitLowLevelError({
+      error: error instanceof Error ? error : new Error(String(error)),
+      url: "streaming connection",
+      message: helpfulMessage
+    });
   }
-  getResponseMetadata(event) {
-    var _a, _b, _c, _d, _e;
-    return ((_c = (_b = (_a = event.data) == null ? void 0 : _a.chunk) == null ? void 0 : _b.kwargs) == null ? void 0 : _c.response_metadata) ?? ((_e = (_d = event.data) == null ? void 0 : _d.chunk) == null ? void 0 : _e.response_metadata);
+  return new CopilotKitError({
+    message: helpfulMessage,
+    code: CopilotKitErrorCode.UNKNOWN
+  });
+}
+__name(convertStreamingErrorToStructured, "convertStreamingErrorToStructured");
+function generateHelpfulErrorMessage(error, context = "connection") {
+  var _a, _b, _c, _d;
+  const baseMessage = (error == null ? void 0 : error.message) || String(error);
+  const originalErrorType = (error == null ? void 0 : error.originalErrorType) || ((_a = error == null ? void 0 : error.extensions) == null ? void 0 : _a.originalErrorType);
+  const statusCode = (error == null ? void 0 : error.statusCode) || ((_b = error == null ? void 0 : error.extensions) == null ? void 0 : _b.statusCode);
+  const responseData = (error == null ? void 0 : error.responseData) || ((_c = error == null ? void 0 : error.extensions) == null ? void 0 : _c.responseData);
+  if (originalErrorType) {
+    const typeConfig = errorConfig.errorPatterns[originalErrorType];
+    if (typeConfig) {
+      return typeConfig.message.replace("{context}", context);
+    }
   }
-  processLangGraphEvents() {
-    let lastEventWithState = null;
-    return this.eventStream$.pipe(scan((acc, event) => {
-      if (event.event === LangGraphEventTypes.OnChatModelStream) {
-        const prevMessageId = acc.lastMessageId;
-        acc.currentContent = this.getCurrentContent(event);
-        acc.lastMessageId = this.getCurrentMessageId(event) ?? acc.lastMessageId;
-        const toolCallChunks = this.getCurrentToolCallChunks(event) ?? [];
-        const responseMetadata = this.getResponseMetadata(event);
-        const toolCallCheck = toolCallChunks && toolCallChunks.length > 0;
-        let isToolCallEnd = (responseMetadata == null ? void 0 : responseMetadata.finish_reason) === "tool_calls";
-        acc.isToolCallStart = toolCallChunks.some((chunk) => chunk.name && chunk.id);
-        acc.isMessageStart = prevMessageId !== acc.lastMessageId && !acc.isToolCallStart;
-        let previousRoundHadToolCall = acc.isToolCall;
-        acc.isToolCall = toolCallCheck;
-        if (previousRoundHadToolCall && !toolCallCheck) {
-          isToolCallEnd = true;
-        }
-        acc.isToolCallEnd = isToolCallEnd;
-        acc.isMessageEnd = (responseMetadata == null ? void 0 : responseMetadata.finish_reason) === "stop";
-        ({ name: acc.lastToolCallName, id: acc.lastToolCallId } = toolCallChunks.find((chunk) => chunk.name && chunk.id) ?? {
-          name: acc.lastToolCallName,
-          id: acc.lastToolCallId
-        });
-      }
-      acc.event = event;
-      lastEventWithState = acc;
-      return acc;
-    }, {
-      event: null,
-      isMessageStart: false,
-      isMessageEnd: false,
-      isToolCallStart: false,
-      isToolCallEnd: false,
-      isToolCall: false,
-      lastMessageId: null,
-      lastToolCallId: null,
-      lastToolCallName: null,
-      currentContent: null,
-      processedToolCallIds: /* @__PURE__ */ new Set()
-    }), mergeMap((acc) => {
-      const events = [];
-      let shouldEmitMessages = true;
-      let shouldEmitToolCalls = true;
-      if (acc.event.event == LangGraphEventTypes.OnChatModelStream) {
-        if ("copilotkit:emit-tool-calls" in (acc.event.metadata || {})) {
-          shouldEmitToolCalls = acc.event.metadata["copilotkit:emit-tool-calls"];
-        }
-        if ("copilotkit:emit-messages" in (acc.event.metadata || {})) {
-          shouldEmitMessages = acc.event.metadata["copilotkit:emit-messages"];
-        }
-      }
-      if (acc.event.event === LangGraphEventTypes.OnInterrupt) {
-        events.push({
-          type: RuntimeEventTypes.MetaEvent,
-          name: RuntimeMetaEventName.LangGraphInterruptEvent,
-          value: acc.event.value
-        });
-      }
-      if (acc.event.event === LangGraphEventTypes.OnCopilotKitInterrupt) {
-        events.push({
-          type: RuntimeEventTypes.MetaEvent,
-          name: RuntimeMetaEventName.CopilotKitLangGraphInterruptEvent,
-          data: acc.event.data
-        });
-      }
-      const responseMetadata = this.getResponseMetadata(acc.event);
-      if (acc.isToolCallEnd && this.shouldEmitToolCall(shouldEmitToolCalls, acc.lastToolCallName) && acc.lastToolCallId && !acc.processedToolCallIds.has(acc.lastToolCallId)) {
-        acc.processedToolCallIds.add(acc.lastToolCallId);
-        events.push({
-          type: RuntimeEventTypes.ActionExecutionEnd,
-          actionExecutionId: acc.lastToolCallId
-        });
-      } else if ((responseMetadata == null ? void 0 : responseMetadata.finish_reason) === "stop" && shouldEmitMessages) {
-        events.push({
-          type: RuntimeEventTypes.TextMessageEnd,
-          messageId: acc.lastMessageId
-        });
-      }
-      switch (acc.event.event) {
-        case LangGraphEventTypes.OnCustomEvent:
-          if (acc.event.name === CustomEventNames.CopilotKitManuallyEmitMessage) {
-            events.push({
-              type: RuntimeEventTypes.TextMessageStart,
-              messageId: acc.event.data.message_id
-            });
-            events.push({
-              type: RuntimeEventTypes.TextMessageContent,
-              messageId: acc.event.data.message_id,
-              content: acc.event.data.message
-            });
-            events.push({
-              type: RuntimeEventTypes.TextMessageEnd,
-              messageId: acc.event.data.message_id
-            });
-          } else if (acc.event.name === CustomEventNames.CopilotKitManuallyEmitToolCall) {
-            events.push({
-              type: RuntimeEventTypes.ActionExecutionStart,
-              actionExecutionId: acc.event.data.id,
-              actionName: acc.event.data.name,
-              parentMessageId: acc.event.data.id
-            });
-            events.push({
-              type: RuntimeEventTypes.ActionExecutionArgs,
-              actionExecutionId: acc.event.data.id,
-              args: JSON.stringify(acc.event.data.args)
-            });
-            events.push({
-              type: RuntimeEventTypes.ActionExecutionEnd,
-              actionExecutionId: acc.event.data.id
-            });
-          }
-          break;
-        case LangGraphEventTypes.OnCopilotKitStateSync:
-          events.push({
-            type: RuntimeEventTypes.AgentStateMessage,
-            threadId: acc.event.thread_id,
-            role: acc.event.role,
-            agentName: acc.event.agent_name,
-            nodeName: acc.event.node_name,
-            runId: acc.event.run_id,
-            active: acc.event.active,
-            state: JSON.stringify(acc.event.state),
-            running: acc.event.running
-          });
-          break;
-        case LangGraphEventTypes.OnChatModelStream:
-          if (acc.isToolCallStart && this.shouldEmitToolCall(shouldEmitToolCalls, acc.lastToolCallName)) {
-            events.push({
-              type: RuntimeEventTypes.ActionExecutionStart,
-              actionExecutionId: acc.lastToolCallId,
-              actionName: acc.lastToolCallName,
-              parentMessageId: acc.lastMessageId
-            });
-          } else if (acc.isMessageStart && shouldEmitMessages) {
-            acc.processedToolCallIds.clear();
-            events.push({
-              type: RuntimeEventTypes.TextMessageStart,
-              messageId: acc.lastMessageId
-            });
-          }
-          if (acc.isToolCall && acc.currentContent && this.shouldEmitToolCall(shouldEmitToolCalls, acc.lastToolCallName)) {
-            events.push({
-              type: RuntimeEventTypes.ActionExecutionArgs,
-              actionExecutionId: acc.lastToolCallId,
-              args: acc.currentContent
-            });
-          } else if (!acc.isToolCall && acc.currentContent && shouldEmitMessages) {
-            events.push({
-              type: RuntimeEventTypes.TextMessageContent,
-              messageId: acc.lastMessageId,
-              content: acc.currentContent
-            });
-          }
-          break;
-      }
-      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({
-          type: RuntimeEventTypes.TextMessageEnd,
-          messageId: lastEventWithState.lastMessageId
-        });
-      }
-      if (lastEventWithState == null ? void 0 : lastEventWithState.lastToolCallId) {
-        events.push({
-          type: RuntimeEventTypes.ActionExecutionEnd,
-          actionExecutionId: lastEventWithState.lastToolCallId
-        });
-      }
-      const messageId = randomId();
-      events.push({
-        type: RuntimeEventTypes.TextMessageStart,
-        messageId
-      });
-      events.push({
-        type: RuntimeEventTypes.TextMessageContent,
-        messageId,
-        content: "\u274C An error occurred. Please try again."
-      });
-      events.push({
-        type: RuntimeEventTypes.TextMessageEnd,
-        messageId
-      });
-      return events;
-    }));
+  for (const [pattern, config] of Object.entries(errorConfig.errorPatterns)) {
+    const shouldMatch = (baseMessage == null ? void 0 : baseMessage.includes(pattern)) || ((_d = error == null ? void 0 : error.cause) == null ? void 0 : _d.code) === pattern || (error == null ? void 0 : error.code) === pattern || statusCode === parseInt(pattern) || pattern === "other_side_closed" && (baseMessage == null ? void 0 : baseMessage.includes("other side closed")) || pattern === "fetch_failed" && (baseMessage == null ? void 0 : baseMessage.includes("fetch failed")) || responseData && JSON.stringify(responseData).includes(pattern);
+    if (shouldMatch) {
+      return config.message.replace("{context}", context);
+    }
   }
-};
-__name(RemoteLangGraphEventSource, "RemoteLangGraphEventSource");
-
-// src/lib/runtime/remote-lg-action.ts
-import { Client as LangGraphClient } from "@langchain/langgraph-sdk";
-import { createHash } from "crypto";
-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;
+  if (isNetworkError(error)) {
+    return getFallbackMessage("network");
   }
-  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;
+  if (isConnectionError(error)) {
+    return getFallbackMessage("connection");
   }
-  const errorMessage = ((_b = error == null ? void 0 : error.message) == null ? void 0 : _b.toLowerCase()) || "";
-  return RETRY_CONFIG.retryableErrorMessages.some((msg) => errorMessage.includes(msg));
+  if (isAuthenticationError(error)) {
+    return getFallbackMessage("authentication");
+  }
+  return getFallbackMessage("default");
 }
-__name(isRetryableError, "isRetryableError");
-function sleep(ms) {
-  return new Promise((resolve) => setTimeout(resolve, ms));
+__name(generateHelpfulErrorMessage, "generateHelpfulErrorMessage");
+function isNetworkError(error) {
+  const networkPatterns = [
+    "ECONNREFUSED",
+    "ENOTFOUND",
+    "ETIMEDOUT",
+    "fetch_failed"
+  ];
+  return networkPatterns.some((pattern) => {
+    var _a, _b;
+    return ((_a = error == null ? void 0 : error.message) == null ? void 0 : _a.includes(pattern)) || ((_b = error == null ? void 0 : error.cause) == null ? void 0 : _b.code) === pattern || (error == null ? void 0 : error.code) === pattern;
+  });
 }
-__name(sleep, "sleep");
-function calculateDelay(attempt) {
-  const delay = RETRY_CONFIG.baseDelayMs * Math.pow(2, attempt);
-  return Math.min(delay, RETRY_CONFIG.maxDelayMs);
+__name(isNetworkError, "isNetworkError");
+function isConnectionError(error) {
+  const connectionPatterns = [
+    "terminated",
+    "UND_ERR_SOCKET",
+    "other side closed"
+  ];
+  return connectionPatterns.some((pattern) => {
+    var _a, _b;
+    return ((_a = error == null ? void 0 : error.message) == null ? void 0 : _a.includes(pattern)) || ((_b = error == null ? void 0 : error.cause) == null ? void 0 : _b.code) === pattern || (error == null ? void 0 : error.code) === pattern;
+  });
 }
-__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(isConnectionError, "isConnectionError");
+function isAuthenticationError(error) {
+  var _a, _b;
+  const authPatterns = [
+    "401",
+    "api key",
+    "unauthorized",
+    "authentication",
+    "AuthenticationError",
+    "PermissionDeniedError"
+  ];
+  const baseMessage = (error == null ? void 0 : error.message) || String(error);
+  const originalErrorType = (error == null ? void 0 : error.originalErrorType) || ((_a = error == null ? void 0 : error.extensions) == null ? void 0 : _a.originalErrorType);
+  const statusCode = (error == null ? void 0 : error.statusCode) || ((_b = error == null ? void 0 : error.extensions) == null ? void 0 : _b.statusCode);
+  return authPatterns.some((pattern) => (baseMessage == null ? void 0 : baseMessage.toLowerCase().includes(pattern.toLowerCase())) || originalErrorType === pattern || statusCode === 401 || (error == null ? void 0 : error.status) === 401 || (error == null ? void 0 : error.statusCode) === 401);
 }
-__name(fetchWithRetry, "fetchWithRetry");
+__name(isAuthenticationError, "isAuthenticationError");
 
 // src/lib/runtime/remote-lg-action.ts
+function isUserConfigurationError(error) {
+  var _a, _b;
+  return (error instanceof CopilotKitError2 || error instanceof CopilotKitLowLevelError2) && (error.code === "NETWORK_ERROR" || error.code === "AUTHENTICATION_ERROR" || error.statusCode === 401 || error.statusCode === 403 || ((_a = error.message) == null ? void 0 : _a.toLowerCase().includes("authentication")) || ((_b = error.message) == null ? void 0 : _b.toLowerCase().includes("api key")));
+}
+__name(isUserConfigurationError, "isUserConfigurationError");
 async function execute(args) {
   return new ReadableStream({
     async start(controller) {
@@ -1881,6 +1976,9 @@ async function execute(args) {
             See more: https://docs.copilotkit.ai/troubleshooting/common-issues`
         });
       } else {
+        if (lastError instanceof CopilotKitError2 || lastError instanceof CopilotKitLowLevelError2 || lastError instanceof Error && lastError.name && lastError.name.includes("CopilotKit")) {
+          throw lastError;
+        }
         throw new CopilotKitMisuseError({
           message: `
             The LangGraph client threw unhandled error ${lastError}.
@@ -2050,7 +2148,30 @@ async function streamEvents(controller, args) {
       ].includes(streamResponseChunk.event))
         continue;
       if (streamResponseChunk.event === "error") {
-        throw new Error(`Error event thrown: ${streamResponseChunk.data.message}`);
+        const errorData = streamResponseChunk.data;
+        if (errorData && typeof errorData === "object" && "error_details" in errorData) {
+          const errorDetails = errorData.error_details;
+          const preservedError = new CopilotKitLowLevelError2({
+            error: new Error(errorDetails.message),
+            url: "langgraph platform agent",
+            message: `${errorDetails.type}: ${errorDetails.message}`
+          });
+          if (errorDetails.status_code) {
+            preservedError.statusCode = errorDetails.status_code;
+          }
+          if (errorDetails.response_data) {
+            preservedError.responseData = errorDetails.response_data;
+          }
+          preservedError.agentName = errorDetails.agent_name;
+          preservedError.originalErrorType = errorDetails.type;
+          throw preservedError;
+        }
+        const helpfulMessage = generateHelpfulErrorMessage(new Error(errorData.message), "LangGraph Platform agent");
+        throw new CopilotKitLowLevelError2({
+          error: new Error(errorData.message),
+          url: "langgraph platform agent",
+          message: helpfulMessage
+        });
       }
       const chunk = streamResponseChunk;
       const interruptEvents = chunk.data.__interrupt__;
@@ -2160,11 +2281,21 @@ async function streamEvents(controller, args) {
     }));
     return Promise.resolve();
   } catch (e) {
-    logger2.error(e);
+    if (isUserConfigurationError(e)) {
+      logger2.debug({
+        error: e.message,
+        code: e.code
+      }, "User configuration error");
+    } else {
+      logger2.error(e);
+    }
     telemetry_client_default.capture("oss.runtime.agent_execution_stream_errored", {
       ...streamInfo,
       error: e.message
     });
+    if (e instanceof CopilotKitError2 || e instanceof CopilotKitLowLevelError2 || e instanceof Error && e.name && e.name.includes("CopilotKit")) {
+      throw e;
+    }
     return Promise.resolve();
   }
 }
@@ -2496,857 +2627,704 @@ function emitInterrupt(interruptValue, emit) {
 }
 __name(emitInterrupt, "emitInterrupt");
 
-// src/lib/runtime/remote-action-constructors.ts
-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();
-  let buffer = [];
-  function flushBuffer() {
-    const currentBuffer = buffer.join("");
-    if (currentBuffer.trim().length === 0) {
-      return;
-    }
-    const parts = currentBuffer.split("\n");
-    if (parts.length === 0) {
-      return;
-    }
-    const lastPartIsComplete = currentBuffer.endsWith("\n");
-    buffer = [];
-    if (!lastPartIsComplete) {
-      buffer.push(parts.pop());
-    }
-    parts.map((part) => part.trim()).filter((part) => part != "").forEach((part) => {
-      eventStream$.next(JSON.parse(part));
-    });
+// src/lib/runtime/mcp-tools-utils.ts
+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 properties = toolParameters == null ? void 0 : toolParameters.properties;
+  const requiredParams = new Set((toolParameters == null ? void 0 : toolParameters.required) || []);
+  if (!properties) {
+    return parameters;
   }
-  __name(flushBuffer, "flushBuffer");
-  try {
-    while (true) {
-      const { done, value } = await reader.read();
-      if (!done) {
-        buffer.push(decoder.decode(value, {
-          stream: true
-        }));
-      }
-      flushBuffer();
-      if (done) {
-        break;
-      }
+  for (const paramName in properties) {
+    if (Object.prototype.hasOwnProperty.call(properties, paramName)) {
+      const paramDef = properties[paramName];
+      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,
+        required: requiredParams.has(paramName)
+      });
     }
-  } catch (error) {
-    console.error("Error in stream", error);
-    const structuredError = convertStreamingErrorToStructured(error);
-    eventStream$.error(structuredError);
-    return;
   }
-  eventStream$.complete();
+  return parameters;
 }
-__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
+__name(extractParametersFromSchema, "extractParametersFromSchema");
+function convertMCPToolsToActions(mcpTools, mcpEndpoint) {
+  const actions = [];
+  for (const [toolName, tool] of Object.entries(mcpTools)) {
+    const parameters = extractParametersFromSchema(tool);
+    const handler = /* @__PURE__ */ __name(async (params) => {
+      try {
+        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);
+        throw new Error(`Execution failed for MCP tool '${toolName}': ${error instanceof Error ? error.message : String(error)}`);
+      }
+    }, "handler");
+    actions.push({
+      name: toolName,
+      description: tool.description || `MCP tool: ${toolName} (from ${mcpEndpoint})`,
+      parameters,
+      handler,
+      // Add metadata for easier identification/debugging
+      _isMCPTool: true,
+      _mcpEndpoint: mcpEndpoint
     });
   }
-  return new CopilotKitError2({
-    message: `Streaming error: ${(error == null ? void 0 : error.message) || String(error)}`,
-    code: CopilotKitErrorCode.UNKNOWN
-  });
+  return actions;
 }
-__name(convertStreamingErrorToStructured, "convertStreamingErrorToStructured");
-
-// src/lib/runtime/remote-action-constructors.ts
-import { CopilotKitApiDiscoveryError, ResolvedCopilotKitError } from "@copilotkit/shared";
-import { parseJson as parseJson2, tryMap } from "@copilotkit/shared";
-function constructLGCRemoteAction({ endpoint, graphqlContext, logger: logger2, messages, agentStates }) {
-  const agents = endpoint.agents.map((agent) => ({
-    name: agent.name,
-    description: agent.description,
-    parameters: [],
-    handler: async (_args) => {
-    },
-    remoteAgentHandler: async ({ name, actionInputsWithoutAgents, threadId, nodeName, additionalMessages = [], metaEvents }) => {
-      logger2.debug({
-        actionName: agent.name
-      }, "Executing LangGraph Platform agent");
-      telemetry_client_default.capture("oss.runtime.remote_action_executed", {
-        agentExecution: true,
-        type: "langgraph-platform",
-        agentsAmount: endpoint.agents.length,
-        hashedLgcKey: endpoint.langsmithApiKey ? createHash2("sha256").update(endpoint.langsmithApiKey).digest("hex") : null
-      });
-      let state = {};
-      let config = {};
-      if (agentStates) {
-        const jsonState = agentStates.find((state2) => state2.agentName === name);
-        if (jsonState) {
-          state = parseJson2(jsonState.state, {});
-          config = parseJson2(jsonState.config, {});
+__name(convertMCPToolsToActions, "convertMCPToolsToActions");
+function generateMcpToolInstructions(toolsMap) {
+  if (!toolsMap || Object.keys(toolsMap).length === 0) {
+    return "";
+  }
+  const toolEntries = Object.entries(toolsMap);
+  const toolsDoc = toolEntries.map(([name, tool]) => {
+    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 propDetails = propSchema;
+            const requiredMark = requiredParams.includes(paramName) ? "*" : "";
+            const typeInfo = propDetails.type || "any";
+            const description = propDetails.description ? ` - ${propDetails.description}` : "";
+            return `    - ${paramName}${requiredMark} (${typeInfo})${description}`;
+          });
+          if (paramsList.length > 0) {
+            paramsDoc = paramsList.join("\n");
+          }
         }
       }
-      try {
-        const response = await execute({
-          logger: logger2.child({
-            component: "remote-actions.remote-lg-action.streamEvents"
-          }),
-          deploymentUrl: endpoint.deploymentUrl,
-          langsmithApiKey: endpoint.langsmithApiKey,
-          agent,
-          threadId,
-          nodeName,
-          messages: [
-            ...messages,
-            ...additionalMessages
-          ],
-          state,
-          config,
-          properties: graphqlContext.properties,
-          actions: tryMap(actionInputsWithoutAgents, (action) => ({
-            name: action.name,
-            description: action.description,
-            parameters: JSON.parse(action.jsonSchema)
-          })),
-          metaEvents
-        });
-        const eventSource = new RemoteLangGraphEventSource();
-        writeJsonLineResponseToEventStream(response, eventSource.eventStream$);
-        return eventSource.processLangGraphEvents();
-      } catch (error) {
-        logger2.error({
-          url: endpoint.deploymentUrl,
-          status: 500,
-          body: error.message
-        }, "Failed to execute LangGraph Platform agent");
-        throw new Error("Failed to execute LangGraph Platform agent");
-      }
+    } catch (e) {
+      console.error(`Error parsing schema for tool ${name}:`, e);
     }
-  }));
-  return [
-    ...agents
-  ];
+    return `- ${name}: ${tool.description || ""}
+${paramsDoc}`;
+  }).join("\n\n");
+  return `You have access to the following external tools provided by Model Context Protocol (MCP) servers:
+
+${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`;
 }
-__name(constructLGCRemoteAction, "constructLGCRemoteAction");
-var RemoteAgentType;
-(function(RemoteAgentType2) {
-  RemoteAgentType2["LangGraph"] = "langgraph";
-  RemoteAgentType2["CrewAI"] = "crewai";
-})(RemoteAgentType || (RemoteAgentType = {}));
-function constructRemoteActions({ json, url, onBeforeRequest, graphqlContext, logger: logger2, messages, agentStates }) {
-  const totalAgents = Array.isArray(json["agents"]) ? json["agents"].length : 0;
-  const actions = json["actions"].map((action) => ({
-    name: action.name,
-    description: action.description,
-    parameters: action.parameters,
-    handler: async (args) => {
-      logger2.debug({
-        actionName: action.name,
-        args
-      }, "Executing remote action");
-      const headers = createHeaders(onBeforeRequest, graphqlContext);
-      telemetry_client_default.capture("oss.runtime.remote_action_executed", {
-        agentExecution: false,
-        type: "self-hosted",
-        agentsAmount: totalAgents
-      });
-      const fetchUrl = `${url}/actions/execute`;
-      try {
-        const response = await fetchWithRetry(fetchUrl, {
-          method: "POST",
-          headers,
-          body: JSON.stringify({
-            name: action.name,
-            arguments: args,
-            properties: graphqlContext.properties
-          })
-        }, logger2);
-        if (!response.ok) {
-          logger2.error({
-            url,
-            status: response.status,
-            body: await response.text()
-          }, "Failed to execute remote action");
-          if (response.status === 404) {
-            throw new CopilotKitApiDiscoveryError({
-              url: fetchUrl
-            });
-          }
-          throw new ResolvedCopilotKitError({
-            status: response.status,
-            url: fetchUrl,
-            isRemoteEndpoint: true
-          });
-        }
-        const requestResult = await response.json();
-        const result = requestResult["result"];
-        logger2.debug({
-          actionName: action.name,
-          result
-        }, "Executed remote action");
-        return result;
-      } catch (error) {
-        if (error instanceof CopilotKitError3) {
-          throw error;
-        }
-        throw new CopilotKitLowLevelError2({
-          error,
-          url: fetchUrl
-        });
-      }
+__name(generateMcpToolInstructions, "generateMcpToolInstructions");
+
+// src/lib/runtime/copilot-runtime.ts
+var CopilotRuntime = class {
+  actions;
+  agents;
+  remoteEndpointDefinitions;
+  langserve = [];
+  onBeforeRequest;
+  onAfterRequest;
+  delegateAgentProcessingToServiceAdapter;
+  observability;
+  availableAgents;
+  onTrace;
+  hasWarnedAboutTracing = false;
+  // +++ MCP Properties +++
+  mcpServersConfig;
+  mcpActionCache = /* @__PURE__ */ new Map();
+  // --- MCP Properties ---
+  // +++ MCP Client Factory +++
+  createMCPClientImpl;
+  // --- MCP Client Factory ---
+  constructor(params) {
+    var _a, _b, _c, _d;
+    if ((params == null ? void 0 : params.actions) && (params == null ? void 0 : params.remoteEndpoints) && (params == null ? void 0 : params.remoteEndpoints.some((e) => e.type === EndpointType.LangGraphPlatform))) {
+      console.warn("Actions set in runtime instance will not be available for the agent");
+      console.warn(`LangGraph Platform remote endpoints are deprecated in favor of the "agents" property`);
     }
-  }));
-  const agents = totalAgents ? json["agents"].map((agent) => ({
-    name: agent.name,
-    description: agent.description,
-    parameters: [],
-    handler: async (_args) => {
-    },
-    remoteAgentHandler: async ({ name, actionInputsWithoutAgents, threadId, nodeName, additionalMessages = [], metaEvents }) => {
-      logger2.debug({
-        actionName: agent.name
-      }, "Executing remote agent");
-      const headers = createHeaders(onBeforeRequest, graphqlContext);
-      telemetry_client_default.capture("oss.runtime.remote_action_executed", {
-        agentExecution: true,
-        type: "self-hosted",
-        agentsAmount: json["agents"].length
+    this.actions = (params == null ? void 0 : params.actions) || [];
+    this.availableAgents = [];
+    for (const chain of (params == null ? void 0 : params.langserve) || []) {
+      const remoteChain = new RemoteChain(chain);
+      this.langserve.push(remoteChain.toAction());
+    }
+    this.remoteEndpointDefinitions = (params == null ? void 0 : params.remoteEndpoints) ?? (params == null ? void 0 : params.remoteActions) ?? [];
+    this.onBeforeRequest = (_a = params == null ? void 0 : params.middleware) == null ? void 0 : _a.onBeforeRequest;
+    this.onAfterRequest = (_b = params == null ? void 0 : params.middleware) == null ? void 0 : _b.onAfterRequest;
+    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.mcpServersConfig = params == null ? void 0 : params.mcpServers;
+    this.createMCPClientImpl = params == null ? void 0 : params.createMCPClient;
+    if (this.mcpServersConfig && this.mcpServersConfig.length > 0 && !this.createMCPClientImpl) {
+      throw new CopilotKitMisuseError2({
+        message: "MCP Integration Error: `mcpServers` were provided, but the `createMCPClient` function was not passed to the CopilotRuntime constructor. Please provide an implementation for `createMCPClient`."
       });
-      let state = {};
-      let config = {};
-      if (agentStates) {
-        const jsonState = agentStates.find((state2) => state2.agentName === name);
-        if (jsonState) {
-          state = parseJson2(jsonState.state, {});
-          config = parseJson2(jsonState.config, {});
-        }
-      }
-      const fetchUrl = `${url}/agents/execute`;
-      try {
-        const response = await fetchWithRetry(fetchUrl, {
-          method: "POST",
-          headers,
-          body: JSON.stringify({
-            name,
-            threadId,
-            nodeName,
-            messages: [
-              ...messages,
-              ...additionalMessages
-            ],
-            state,
-            config,
-            properties: graphqlContext.properties,
-            actions: tryMap(actionInputsWithoutAgents, (action) => ({
-              name: action.name,
-              description: action.description,
-              parameters: JSON.parse(action.jsonSchema)
-            })),
-            metaEvents
-          })
-        }, logger2);
-        if (!response.ok) {
-          logger2.error({
-            url,
-            status: response.status,
-            body: await response.text()
-          }, "Failed to execute remote agent");
-          if (response.status === 404) {
-            throw new CopilotKitApiDiscoveryError({
-              url: fetchUrl
-            });
+    }
+    if ((params == null ? void 0 : params.actions) && (((_c = params == null ? void 0 : params.remoteEndpoints) == null ? void 0 : _c.some((e) => e.type === EndpointType.LangGraphPlatform)) || ((_d = this.mcpServersConfig) == null ? void 0 : _d.length))) {
+      console.warn("Local 'actions' defined in CopilotRuntime might not be available to remote agents (LangGraph, MCP). Consider defining actions closer to the agent implementation if needed.");
+    }
+  }
+  // +++ MCP Instruction Injection Method +++
+  injectMCPToolInstructions(messages, currentActions) {
+    const mcpActionsForRequest = currentActions.filter((action) => action._isMCPTool);
+    if (!mcpActionsForRequest || mcpActionsForRequest.length === 0) {
+      return messages;
+    }
+    const uniqueMcpTools = /* @__PURE__ */ new Map();
+    mcpActionsForRequest.forEach((action) => {
+      uniqueMcpTools.set(action.name, action);
+    });
+    const toolsMap = {};
+    Array.from(uniqueMcpTools.values()).forEach((action) => {
+      toolsMap[action.name] = {
+        description: action.description || "",
+        schema: action.parameters ? {
+          parameters: {
+            properties: action.parameters.reduce((acc, p) => ({
+              ...acc,
+              [p.name]: {
+                type: p.type,
+                description: p.description
+              }
+            }), {}),
+            required: action.parameters.filter((p) => p.required).map((p) => p.name)
           }
-          throw new ResolvedCopilotKitError({
-            status: response.status,
-            url: fetchUrl,
-            isRemoteEndpoint: true
-          });
-        }
-        if (agent.type === "langgraph") {
-          const eventSource = new RemoteLangGraphEventSource();
-          writeJsonLineResponseToEventStream(response.body, eventSource.eventStream$);
-          return eventSource.processLangGraphEvents();
-        } else if (agent.type === "crewai") {
-          const eventStream$ = new RuntimeEventSubject();
-          writeJsonLineResponseToEventStream(response.body, eventStream$);
-          return eventStream$;
-        } else {
-          throw new Error("Unsupported agent type");
-        }
-      } catch (error) {
-        if (error instanceof CopilotKitError3) {
-          throw error;
-        }
-        throw new CopilotKitLowLevelError2({
-          error,
-          url: fetchUrl
-        });
-      }
+        } : {},
+        execute: async () => ({})
+      };
+    });
+    const mcpToolInstructions = generateMcpToolInstructions(toolsMap);
+    if (!mcpToolInstructions) {
+      return messages;
     }
-  })) : [];
-  return [
-    ...actions,
-    ...agents
-  ];
-}
-__name(constructRemoteActions, "constructRemoteActions");
-function createHeaders(onBeforeRequest, graphqlContext) {
-  const headers = {
-    "Content-Type": "application/json"
-  };
-  if (onBeforeRequest) {
-    const { headers: additionalHeaders } = onBeforeRequest({
-      ctx: graphqlContext
+    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 systemMessageIndex = messages.findIndex((msg) => {
+      var _a;
+      return ((_a = msg.textMessage) == null ? void 0 : _a.role) === "system";
     });
-    if (additionalHeaders) {
-      Object.assign(headers, additionalHeaders);
+    const newMessages = [
+      ...messages
+    ];
+    if (systemMessageIndex !== -1) {
+      const existingMsg = newMessages[systemMessageIndex];
+      if (existingMsg.textMessage) {
+        existingMsg.textMessage.content = (existingMsg.textMessage.content ? existingMsg.textMessage.content + "\n\n" : "") + instructions;
+      }
+    } else {
+      newMessages.unshift({
+        id: randomId(),
+        createdAt: /* @__PURE__ */ new Date(),
+        textMessage: {
+          role: MessageRole.system,
+          content: instructions
+        },
+        actionExecutionMessage: void 0,
+        resultMessage: void 0,
+        agentStateMessage: void 0
+      });
     }
+    return newMessages;
   }
-  return headers;
-}
-__name(createHeaders, "createHeaders");
-
-// src/lib/runtime/remote-actions.ts
-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";
-function constructAGUIRemoteAction({ logger: logger2, messages, agentStates, agent, metaEvents }) {
-  const action = {
-    name: agent.agentId,
-    description: agent.description,
-    parameters: [],
-    handler: async (_args) => {
-    },
-    remoteAgentHandler: async ({ actionInputsWithoutAgents, threadId }) => {
-      var _a;
-      logger2.debug({
-        actionName: agent.agentId
-      }, "Executing remote agent");
-      const agentWireMessages = convertMessagesToAGUIMessage(messages);
-      agent.messages = agentWireMessages;
-      agent.threadId = threadId;
-      telemetry_client_default.capture("oss.runtime.remote_action_executed", {
-        agentExecution: true,
-        type: "self-hosted",
-        agentsAmount: 1
-      });
-      let state = {};
-      if (agentStates) {
-        const jsonState = agentStates.find((state2) => state2.agentName === agent.agentId);
-        if (jsonState) {
-          state = parseJson3(jsonState.state, {});
-        }
+  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
+      },
+      technical: {
+        environment: process.env.NODE_ENV
       }
-      agent.state = state;
-      const tools = actionInputsWithoutAgents.map((input) => {
-        return {
-          name: input.name,
-          description: input.description,
-          parameters: JSON.parse(input.jsonSchema)
+    }, void 0, publicApiKey);
+    try {
+      if (Object.keys(this.agents).length && (agentSession == null ? void 0 : agentSession.agentName) && !this.delegateAgentProcessingToServiceAdapter) {
+        this.agents = {
+          [agentSession.agentName]: this.agents[agentSession.agentName]
         };
-      });
-      const forwardedProps = metaEvents.length ? {
-        command: {
-          resume: (_a = metaEvents[0]) == null ? void 0 : _a.response
+      }
+      if (agentSession && !this.delegateAgentProcessingToServiceAdapter) {
+        return await this.processAgentRequest(request);
+      }
+      if (serviceAdapter instanceof EmptyAdapter) {
+        throw new CopilotKitMisuseError2({
+          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.`
+        });
+      }
+      const serverSideActions = await this.getServerSideActions(request);
+      const filteredRawMessages = rawMessages.filter((message) => !message.agentStateMessage);
+      const messagesWithInjectedInstructions = this.injectMCPToolInstructions(filteredRawMessages, serverSideActions);
+      const inputMessages = convertGqlInputToMessages(messagesWithInjectedInstructions);
+      if (((_a = this.observability) == null ? void 0 : _a.enabled) && publicApiKey) {
+        try {
+          const requestData = {
+            threadId,
+            runId,
+            model: forwardedParameters == null ? void 0 : forwardedParameters.model,
+            messages: inputMessages,
+            actions: clientSideActionsInput,
+            forwardedParameters,
+            timestamp: requestStartTime,
+            provider: this.detectProvider(serviceAdapter)
+          };
+          await this.observability.hooks.handleRequest(requestData);
+        } catch (error) {
+          console.error("Error logging LLM request:", error);
         }
-      } : void 0;
-      return agent.legacy_to_be_removed_runAgentBridged({
-        tools,
-        forwardedProps
+      }
+      const serverSideActionsInput = serverSideActions.map((action) => ({
+        name: action.name,
+        description: action.description,
+        jsonSchema: JSON.stringify(actionParametersToJsonSchema(action.parameters))
+      }));
+      const actionInputs = flattenToolCallsNoDuplicates([
+        ...serverSideActionsInput,
+        ...clientSideActionsInput.filter(
+          // Filter remote actions from CopilotKit core loop
+          (action) => action.available !== ActionInputAvailability.remote
+        )
+      ]);
+      await ((_b = this.onBeforeRequest) == null ? void 0 : _b.call(this, {
+        threadId,
+        runId,
+        inputMessages,
+        properties: graphqlContext.properties,
+        url
+      }));
+      const result = await serviceAdapter.process({
+        messages: inputMessages,
+        actions: actionInputs,
+        threadId,
+        runId,
+        eventSource,
+        forwardedParameters,
+        extensions,
+        agentSession,
+        agentStates
       });
-    }
-  };
-  return [
-    action
-  ];
-}
-__name(constructAGUIRemoteAction, "constructAGUIRemoteAction");
-function convertMessagesToAGUIMessage(messages) {
-  const result = [];
-  for (const message of messages) {
-    if (message.isTextMessage()) {
-      result.push({
-        id: message.id,
-        role: message.role,
-        content: message.content
+      const nonEmptyThreadId = threadId ?? result.threadId;
+      outputMessagesPromise.then((outputMessages) => {
+        var _a2;
+        (_a2 = this.onAfterRequest) == null ? void 0 : _a2.call(this, {
+          threadId: nonEmptyThreadId,
+          runId: result.runId,
+          inputMessages,
+          outputMessages,
+          properties: graphqlContext.properties,
+          url
+        });
+      }).catch((_error) => {
       });
-    } else if (message.isActionExecutionMessage()) {
-      const toolCall = {
-        id: message.id,
-        type: "function",
-        function: {
-          name: message.name,
-          arguments: JSON.stringify(message.arguments)
-        }
-      };
-      if (message.parentMessageId && result.some((m) => m.id === message.parentMessageId)) {
-        const parentMessage = result.find((m) => m.id === message.parentMessageId);
-        if (parentMessage.toolCalls === void 0) {
-          parentMessage.toolCalls = [];
+      if (((_c = this.observability) == null ? void 0 : _c.enabled) && publicApiKey) {
+        try {
+          outputMessagesPromise.then((outputMessages) => {
+            const responseData = {
+              threadId: result.threadId,
+              runId: result.runId,
+              model: forwardedParameters == null ? void 0 : forwardedParameters.model,
+              // Use collected chunks for progressive mode or outputMessages for regular mode
+              output: this.observability.progressive ? streamedChunks : outputMessages,
+              latency: Date.now() - requestStartTime,
+              timestamp: Date.now(),
+              provider: this.detectProvider(serviceAdapter),
+              // Indicate this is the final response
+              isFinalResponse: true
+            };
+            try {
+              this.observability.hooks.handleResponse(responseData);
+            } catch (logError) {
+              console.error("Error logging LLM response:", logError);
+            }
+          }).catch((error) => {
+            console.error("Failed to get output messages for logging:", error);
+          });
+        } catch (error) {
+          console.error("Error setting up logging for LLM response:", error);
         }
-        parentMessage.toolCalls.push(toolCall);
-      } else {
-        result.push({
-          id: message.parentMessageId ?? message.id,
-          role: "assistant",
-          toolCalls: [
-            toolCall
-          ]
-        });
       }
-    } else if (message.isResultMessage()) {
-      result.push({
-        id: message.id,
-        role: "tool",
-        content: message.result,
-        toolCallId: message.actionExecutionId
-      });
-    }
-  }
-  return result;
-}
-__name(convertMessagesToAGUIMessage, "convertMessagesToAGUIMessage");
-
-// src/lib/runtime/remote-actions.ts
-var EndpointType;
-(function(EndpointType2) {
-  EndpointType2["CopilotKit"] = "copilotKit";
-  EndpointType2["LangGraphPlatform"] = "langgraph-platform";
-})(EndpointType || (EndpointType = {}));
-function isRemoteAgentAction(action) {
-  if (!action) {
-    return false;
-  }
-  return typeof action.remoteAgentHandler === "function";
-}
-__name(isRemoteAgentAction, "isRemoteAgentAction");
-async function fetchRemoteInfo({ url, onBeforeRequest, graphqlContext, logger: logger2, frontendUrl }) {
-  logger2.debug({
-    url
-  }, "Fetching actions from url");
-  const headers = createHeaders(onBeforeRequest, graphqlContext);
-  const fetchUrl = `${url}/info`;
-  try {
-    const response = await fetch(fetchUrl, {
-      method: "POST",
-      headers,
-      body: JSON.stringify({
-        properties: graphqlContext.properties,
-        frontendUrl
-      })
-    });
-    if (!response.ok) {
-      logger2.error({
-        url,
-        status: response.status,
-        body: await response.text()
-      }, "Failed to fetch actions from url");
-      throw new ResolvedCopilotKitError2({
-        status: response.status,
-        url: fetchUrl,
-        isRemoteEndpoint: true
-      });
-    }
-    const json = await response.json();
-    logger2.debug({
-      json
-    }, "Fetched actions from url");
-    return json;
-  } catch (error) {
-    if (error instanceof CopilotKitError4) {
-      throw error;
+      if (((_d = this.observability) == null ? void 0 : _d.enabled) && this.observability.progressive && publicApiKey) {
+        const originalStream = eventSource.stream.bind(eventSource);
+        eventSource.stream = async (callback) => {
+          await originalStream(async (eventStream$) => {
+            eventStream$.subscribe({
+              next: (event) => {
+                if (event.type === RuntimeEventTypes.TextMessageContent) {
+                  streamedChunks.push(event.content);
+                  try {
+                    const progressiveData = {
+                      threadId: threadId || "",
+                      runId,
+                      model: forwardedParameters == null ? void 0 : forwardedParameters.model,
+                      output: event.content,
+                      latency: Date.now() - requestStartTime,
+                      timestamp: Date.now(),
+                      provider: this.detectProvider(serviceAdapter),
+                      isProgressiveChunk: true
+                    };
+                    Promise.resolve().then(() => {
+                      this.observability.hooks.handleResponse(progressiveData);
+                    }).catch((error) => {
+                      console.error("Error in progressive logging:", error);
+                    });
+                  } catch (error) {
+                    console.error("Error preparing progressive log data:", error);
+                  }
+                }
+              }
+            });
+            await callback(eventStream$);
+          });
+        };
+      }
+      return {
+        threadId: nonEmptyThreadId,
+        runId: result.runId,
+        eventSource,
+        serverSideActions,
+        actionInputsWithoutAgents: actionInputs.filter((action) => (
+          // TODO-AGENTS: do not exclude ALL server side actions
+          !serverSideActions.find((serverSideAction) => serverSideAction.name == action.name)
+        )),
+        extensions: result.extensions
+      };
+    } catch (error) {
+      if (((_e = this.observability) == null ? void 0 : _e.enabled) && publicApiKey) {
+        try {
+          const errorData = {
+            threadId,
+            runId,
+            model: forwardedParameters == null ? void 0 : forwardedParameters.model,
+            error: error instanceof Error ? error : String(error),
+            timestamp: Date.now(),
+            latency: Date.now() - requestStartTime,
+            provider: this.detectProvider(serviceAdapter)
+          };
+          await this.observability.hooks.handleError(errorData);
+        } catch (logError) {
+          console.error("Error logging LLM error:", logError);
+        }
+      }
+      let structuredError;
+      if (error instanceof CopilotKitError3) {
+        structuredError = error;
+      } else {
+        structuredError = ensureStructuredError2(error, (err) => this.convertStreamingErrorToStructured(err));
+      }
+      await this.trace("error", {
+        threadId,
+        runId,
+        source: "runtime",
+        request: {
+          operation: "processRuntimeRequest",
+          method: "POST",
+          url,
+          startTime: requestStartTime
+        },
+        response: {
+          endTime: Date.now(),
+          latency: Date.now() - requestStartTime
+        },
+        agent: agentSession ? {
+          name: agentSession.agentName
+        } : void 0,
+        technical: {
+          environment: process.env.NODE_ENV,
+          stackTrace: error instanceof Error ? error.stack : void 0
+        }
+      }, structuredError, publicApiKey);
+      throw structuredError;
     }
-    throw new CopilotKitLowLevelError3({
-      error,
-      url: fetchUrl
-    });
   }
-}
-__name(fetchRemoteInfo, "fetchRemoteInfo");
-async function setupRemoteActions({ remoteEndpointDefinitions, graphqlContext, messages, agentStates, frontendUrl, agents, metaEvents }) {
-  const logger2 = graphqlContext.logger.child({
-    component: "remote-actions.fetchRemoteActions"
-  });
-  logger2.debug({
-    remoteEndpointDefinitions
-  }, "Fetching from remote endpoints");
-  const filtered = remoteEndpointDefinitions.filter((value, index, self) => {
-    if (value.type === "langgraph-platform") {
-      return value;
-    }
-    return index === self.findIndex((t) => t.url === value.url);
-  });
-  const result = await Promise.all(filtered.map(async (endpoint) => {
-    if (endpoint.type === "langgraph-platform") {
-      return constructLGCRemoteAction({
-        endpoint,
-        messages,
-        graphqlContext,
-        logger: logger2.child({
-          component: "remote-actions.constructLGCRemoteAction",
-          endpoint
-        }),
-        agentStates
-      });
-    }
-    const json = await fetchRemoteInfo({
-      url: endpoint.url,
-      onBeforeRequest: endpoint.onBeforeRequest,
-      graphqlContext,
-      logger: logger2.child({
-        component: "remote-actions.fetchActionsFromUrl",
-        endpoint
-      }),
-      frontendUrl
-    });
-    return constructRemoteActions({
-      json,
-      messages,
-      url: endpoint.url,
-      onBeforeRequest: endpoint.onBeforeRequest,
-      graphqlContext,
-      logger: logger2.child({
-        component: "remote-actions.constructActions",
-        endpoint
-      }),
-      agentStates
-    });
-  }));
-  for (const [key, agent] of Object.entries(agents)) {
-    if (agent.agentId !== void 0 && agent.agentId !== key) {
-      throw new CopilotKitError4({
-        message: `Agent ${key} has agentId ${agent.agentId} which does not match the key ${key}`,
-        code: CopilotKitErrorCode2.UNKNOWN
-      });
-    } else if (agent.agentId === void 0) {
-      agent.agentId = key;
-    }
-    result.push(constructAGUIRemoteAction({
-      logger: logger2,
-      messages,
-      agentStates,
-      agent,
-      metaEvents
+  async getAllAgents(graphqlContext) {
+    const [agentsWithEndpoints, aguiAgents] = await Promise.all([
+      this.discoverAgentsFromEndpoints(graphqlContext),
+      this.discoverAgentsFromAgui()
+    ]);
+    this.availableAgents = [
+      ...agentsWithEndpoints,
+      ...aguiAgents
+    ].map((a) => ({
+      name: a.name,
+      id: a.id
     }));
+    return [
+      ...agentsWithEndpoints,
+      ...aguiAgents
+    ];
   }
-  return result.flat();
-}
-__name(setupRemoteActions, "setupRemoteActions");
-
-// src/lib/telemetry-client.ts
-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 CopilotKitError5, CopilotKitAgentDiscoveryError, CopilotKitMisuseError as CopilotKitMisuseError2, CopilotKitErrorCode as CopilotKitErrorCode3, CopilotKitLowLevelError as CopilotKitLowLevelError4 } from "@copilotkit/shared";
-
-// src/service-adapters/conversion.ts
-import { plainToInstance } from "class-transformer";
-import { tryMap as tryMap2 } from "@copilotkit/shared";
-function convertGqlInputToMessages(inputMessages) {
-  const messages = tryMap2(inputMessages, (message) => {
-    if (message.textMessage) {
-      return plainToInstance(TextMessage, {
-        id: message.id,
-        createdAt: message.createdAt,
-        role: message.textMessage.role,
-        content: message.textMessage.content,
-        parentMessageId: message.textMessage.parentMessageId
-      });
-    } else if (message.imageMessage) {
-      return plainToInstance(ImageMessage, {
-        id: message.id,
-        createdAt: message.createdAt,
-        role: message.imageMessage.role,
-        bytes: message.imageMessage.bytes,
-        format: message.imageMessage.format,
-        parentMessageId: message.imageMessage.parentMessageId
-      });
-    } else if (message.actionExecutionMessage) {
-      return plainToInstance(ActionExecutionMessage, {
-        id: message.id,
-        createdAt: message.createdAt,
-        name: message.actionExecutionMessage.name,
-        arguments: JSON.parse(message.actionExecutionMessage.arguments),
-        parentMessageId: message.actionExecutionMessage.parentMessageId
-      });
-    } else if (message.resultMessage) {
-      return plainToInstance(ResultMessage, {
-        id: message.id,
-        createdAt: message.createdAt,
-        actionExecutionId: message.resultMessage.actionExecutionId,
-        actionName: message.resultMessage.actionName,
-        result: message.resultMessage.result
-      });
-    } else if (message.agentStateMessage) {
-      return plainToInstance(AgentStateMessage, {
-        id: message.id,
-        threadId: message.agentStateMessage.threadId,
-        createdAt: message.createdAt,
-        agentName: message.agentStateMessage.agentName,
-        nodeName: message.agentStateMessage.nodeName,
-        runId: message.agentStateMessage.runId,
-        active: message.agentStateMessage.active,
-        role: message.agentStateMessage.role,
-        state: JSON.parse(message.agentStateMessage.state),
-        running: message.agentStateMessage.running
-      });
-    } else {
-      return null;
-    }
-  });
-  return messages.filter((m) => m);
-}
-__name(convertGqlInputToMessages, "convertGqlInputToMessages");
-
-// src/lib/runtime/copilot-runtime.ts
-import { from } from "rxjs";
-import { Client as LangGraphClient2 } from "@langchain/langgraph-sdk";
-
-// src/lib/runtime/mcp-tools-utils.ts
-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 properties = toolParameters == null ? void 0 : toolParameters.properties;
-  const requiredParams = new Set((toolParameters == null ? void 0 : toolParameters.required) || []);
-  if (!properties) {
-    return parameters;
-  }
-  for (const paramName in properties) {
-    if (Object.prototype.hasOwnProperty.call(properties, paramName)) {
-      const paramDef = properties[paramName];
-      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,
-        required: requiredParams.has(paramName)
-      });
-    }
-  }
-  return parameters;
-}
-__name(extractParametersFromSchema, "extractParametersFromSchema");
-function convertMCPToolsToActions(mcpTools, mcpEndpoint) {
-  const actions = [];
-  for (const [toolName, tool] of Object.entries(mcpTools)) {
-    const parameters = extractParametersFromSchema(tool);
-    const handler = /* @__PURE__ */ __name(async (params) => {
+  async discoverAgentsFromEndpoints(graphqlContext) {
+    const agents = this.remoteEndpointDefinitions.reduce(async (acc, endpoint) => {
+      const agents2 = await acc;
+      if (endpoint.type === EndpointType.LangGraphPlatform) {
+        const propertyHeaders = graphqlContext.properties.authorization ? {
+          authorization: `Bearer ${graphqlContext.properties.authorization}`
+        } : null;
+        const client = new LangGraphClient2({
+          apiUrl: endpoint.deploymentUrl,
+          apiKey: endpoint.langsmithApiKey,
+          defaultHeaders: {
+            ...propertyHeaders
+          }
+        });
+        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 remote endpoint at url ${endpoint.deploymentUrl}.
+              Make sure the API is running and that it's indeed a LangGraph platform url.
+              
+              See more: https://docs.copilotkit.ai/troubleshooting/common-issues`
+          });
+        }
+        const endpointAgents = data.map((entry) => ({
+          name: entry.graph_id,
+          id: entry.assistant_id,
+          description: "",
+          endpoint
+        }));
+        return [
+          ...agents2,
+          ...endpointAgents
+        ];
+      }
+      const cpkEndpoint = endpoint;
+      const fetchUrl = `${endpoint.url}/info`;
       try {
-        const result = await tool.execute({
-          params
+        const response = await fetchWithRetry(fetchUrl, {
+          method: "POST",
+          headers: createHeaders(cpkEndpoint.onBeforeRequest, graphqlContext),
+          body: JSON.stringify({
+            properties: graphqlContext.properties
+          })
         });
-        return typeof result === "string" ? result : JSON.stringify(result);
+        if (!response.ok) {
+          if (response.status === 404) {
+            throw new CopilotKitApiDiscoveryError({
+              url: fetchUrl
+            });
+          }
+          throw new ResolvedCopilotKitError({
+            status: response.status,
+            url: fetchUrl,
+            isRemoteEndpoint: true
+          });
+        }
+        const data = await response.json();
+        const endpointAgents = ((data == null ? void 0 : data.agents) ?? []).map((agent) => ({
+          name: agent.name,
+          description: agent.description ?? "" ?? "",
+          id: randomId(),
+          endpoint
+        }));
+        return [
+          ...agents2,
+          ...endpointAgents
+        ];
       } catch (error) {
-        console.error(`Error executing MCP tool '${toolName}' from endpoint ${mcpEndpoint}:`, error);
-        throw new Error(`Execution failed for MCP tool '${toolName}': ${error instanceof Error ? error.message : String(error)}`);
+        if (error instanceof CopilotKitError3) {
+          throw error;
+        }
+        throw new CopilotKitLowLevelError3({
+          error,
+          url: fetchUrl
+        });
       }
-    }, "handler");
-    actions.push({
-      name: toolName,
-      description: tool.description || `MCP tool: ${toolName} (from ${mcpEndpoint})`,
-      parameters,
-      handler,
-      // Add metadata for easier identification/debugging
-      _isMCPTool: true,
-      _mcpEndpoint: mcpEndpoint
-    });
-  }
-  return actions;
-}
-__name(convertMCPToolsToActions, "convertMCPToolsToActions");
-function generateMcpToolInstructions(toolsMap) {
-  if (!toolsMap || Object.keys(toolsMap).length === 0) {
-    return "";
+    }, Promise.resolve([]));
+    return agents;
   }
-  const toolEntries = Object.entries(toolsMap);
-  const toolsDoc = toolEntries.map(([name, tool]) => {
-    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 propDetails = propSchema;
-            const requiredMark = requiredParams.includes(paramName) ? "*" : "";
-            const typeInfo = propDetails.type || "any";
-            const description = propDetails.description ? ` - ${propDetails.description}` : "";
-            return `    - ${paramName}${requiredMark} (${typeInfo})${description}`;
+  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
           });
-          if (paramsList.length > 0) {
-            paramsDoc = paramsList.join("\n");
-          }
         }
+      } 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`
+        });
       }
-    } catch (e) {
-      console.error(`Error parsing schema for tool ${name}:`, e);
-    }
-    return `- ${name}: ${tool.description || ""}
-${paramsDoc}`;
-  }).join("\n\n");
-  return `You have access to the following external tools provided by Model Context Protocol (MCP) servers:
-
-${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`;
-}
-__name(generateMcpToolInstructions, "generateMcpToolInstructions");
-
-// src/lib/runtime/copilot-runtime.ts
-var CopilotRuntime = class {
-  actions;
-  agents;
-  remoteEndpointDefinitions;
-  langserve = [];
-  onBeforeRequest;
-  onAfterRequest;
-  delegateAgentProcessingToServiceAdapter;
-  observability;
-  availableAgents;
-  onTrace;
-  hasWarnedAboutTracing = false;
-  // +++ MCP Properties +++
-  mcpServersConfig;
-  mcpActionCache = /* @__PURE__ */ new Map();
-  // --- MCP Properties ---
-  // +++ MCP Client Factory +++
-  createMCPClientImpl;
-  // --- MCP Client Factory ---
-  constructor(params) {
-    var _a, _b, _c, _d;
-    if ((params == null ? void 0 : params.actions) && (params == null ? void 0 : params.remoteEndpoints) && (params == null ? void 0 : params.remoteEndpoints.some((e) => e.type === EndpointType.LangGraphPlatform))) {
-      console.warn("Actions set in runtime instance will not be available for the agent");
-      console.warn(`LangGraph Platform remote endpoints are deprecated in favor of the "agents" property`);
-    }
-    this.actions = (params == null ? void 0 : params.actions) || [];
-    this.availableAgents = [];
-    for (const chain of (params == null ? void 0 : params.langserve) || []) {
-      const remoteChain = new RemoteChain(chain);
-      this.langserve.push(remoteChain.toAction());
-    }
-    this.remoteEndpointDefinitions = (params == null ? void 0 : params.remoteEndpoints) ?? (params == null ? void 0 : params.remoteActions) ?? [];
-    this.onBeforeRequest = (_a = params == null ? void 0 : params.middleware) == null ? void 0 : _a.onBeforeRequest;
-    this.onAfterRequest = (_b = params == null ? void 0 : params.middleware) == null ? void 0 : _b.onAfterRequest;
-    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.mcpServersConfig = params == null ? void 0 : params.mcpServers;
-    this.createMCPClientImpl = params == null ? void 0 : params.createMCPClient;
-    if (this.mcpServersConfig && this.mcpServersConfig.length > 0 && !this.createMCPClientImpl) {
-      throw new CopilotKitMisuseError2({
-        message: "MCP Integration Error: `mcpServers` were provided, but the `createMCPClient` function was not passed to the CopilotRuntime constructor. Please provide an implementation for `createMCPClient`."
-      });
-    }
-    if ((params == null ? void 0 : params.actions) && (((_c = params == null ? void 0 : params.remoteEndpoints) == null ? void 0 : _c.some((e) => e.type === EndpointType.LangGraphPlatform)) || ((_d = this.mcpServersConfig) == null ? void 0 : _d.length))) {
-      console.warn("Local 'actions' defined in CopilotRuntime might not be available to remote agents (LangGraph, MCP). Consider defining actions closer to the agent implementation if needed.");
-    }
+      const endpointAgents = data.map((entry) => ({
+        name: entry.graph_id,
+        id: entry.assistant_id,
+        description: ""
+      }));
+      return [
+        ...agents2,
+        ...endpointAgents
+      ];
+    }, Promise.resolve([]));
+    return agents;
   }
-  // +++ MCP Instruction Injection Method +++
-  injectMCPToolInstructions(messages, currentActions) {
-    const mcpActionsForRequest = currentActions.filter((action) => action._isMCPTool);
-    if (!mcpActionsForRequest || mcpActionsForRequest.length === 0) {
-      return messages;
+  async loadAgentState(graphqlContext, threadId, agentName) {
+    const agents = await this.getAllAgents(graphqlContext);
+    const agent = agents.find((agent2) => agent2.name === agentName);
+    if (!agent) {
+      throw new Error("Agent not found");
     }
-    const uniqueMcpTools = /* @__PURE__ */ new Map();
-    mcpActionsForRequest.forEach((action) => {
-      uniqueMcpTools.set(action.name, action);
-    });
-    const toolsMap = {};
-    Array.from(uniqueMcpTools.values()).forEach((action) => {
-      toolsMap[action.name] = {
-        description: action.description || "",
-        schema: action.parameters ? {
-          parameters: {
-            properties: action.parameters.reduce((acc, p) => ({
-              ...acc,
-              [p.name]: {
-                type: p.type,
-                description: p.description
-              }
-            }), {}),
-            required: action.parameters.filter((p) => p.required).map((p) => p.name)
+    if ("endpoint" in agent && (agent.endpoint.type === EndpointType.CopilotKit || !("type" in agent.endpoint))) {
+      const cpkEndpoint = agent.endpoint;
+      const fetchUrl = `${cpkEndpoint.url}/agents/state`;
+      try {
+        const response = await fetchWithRetry(fetchUrl, {
+          method: "POST",
+          headers: createHeaders(cpkEndpoint.onBeforeRequest, graphqlContext),
+          body: JSON.stringify({
+            properties: graphqlContext.properties,
+            threadId,
+            name: agentName
+          })
+        });
+        if (!response.ok) {
+          if (response.status === 404) {
+            throw new CopilotKitApiDiscoveryError({
+              url: fetchUrl
+            });
           }
-        } : {},
-        execute: async () => ({})
-      };
-    });
-    const mcpToolInstructions = generateMcpToolInstructions(toolsMap);
-    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 systemMessageIndex = messages.findIndex((msg) => {
-      var _a;
-      return ((_a = msg.textMessage) == null ? void 0 : _a.role) === "system";
-    });
-    const newMessages = [
-      ...messages
-    ];
-    if (systemMessageIndex !== -1) {
-      const existingMsg = newMessages[systemMessageIndex];
-      if (existingMsg.textMessage) {
-        existingMsg.textMessage.content = (existingMsg.textMessage.content ? existingMsg.textMessage.content + "\n\n" : "") + instructions;
+          let errorMessage = `HTTP ${response.status} error`;
+          try {
+            const errorBody = await response.text();
+            const parsedError = JSON.parse(errorBody);
+            if (parsedError.error && typeof parsedError.error === "string") {
+              errorMessage = parsedError.error;
+            }
+          } catch {
+          }
+          throw new ResolvedCopilotKitError({
+            status: response.status,
+            url: fetchUrl,
+            isRemoteEndpoint: true,
+            message: errorMessage
+          });
+        }
+        const data = await response.json();
+        return {
+          ...data,
+          state: JSON.stringify(data.state),
+          messages: JSON.stringify(data.messages)
+        };
+      } catch (error) {
+        if (error instanceof CopilotKitError3) {
+          throw error;
+        }
+        throw new CopilotKitLowLevelError3({
+          error,
+          url: fetchUrl
+        });
       }
+    }
+    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 {
-      newMessages.unshift({
-        id: randomId2(),
-        createdAt: /* @__PURE__ */ new Date(),
-        textMessage: {
-          role: MessageRole.system,
-          content: instructions
-        },
-        actionExecutionMessage: void 0,
-        resultMessage: void 0,
-        agentStateMessage: void 0
+      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;
+    } 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
       });
     }
-    return newMessages;
+    if (Object.keys(state).length === 0) {
+      return {
+        threadId: threadId || "",
+        threadExists: false,
+        state: JSON.stringify({}),
+        messages: JSON.stringify([])
+      };
+    } else {
+      const { messages, ...stateWithoutMessages } = state;
+      const copilotkitMessages = langchainMessagesToCopilotKit(messages);
+      return {
+        threadId: threadId || "",
+        threadExists: true,
+        state: JSON.stringify(stateWithoutMessages),
+        messages: JSON.stringify(copilotkitMessages)
+      };
+    }
+    throw new Error(`Agent: ${agent.name} could not be resolved`);
   }
-  async processRuntimeRequest(request) {
+  async processAgentRequest(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 { messages: rawMessages, outputMessagesPromise, graphqlContext, agentSession, threadId: threadIdFromRequest, metaEvents, publicApiKey, forwardedParameters } = request;
+    const { agentName, nodeName } = agentSession;
     const requestStartTime = Date.now();
     const streamedChunks = [];
-    await this.trace("request", {
+    const threadId = threadIdFromRequest ?? agentSession.threadId;
+    await this.trace("agent_state", {
       threadId,
-      runId,
-      source: "runtime",
+      source: "agent",
       request: {
-        operation: "processRuntimeRequest",
+        operation: "processAgentRequest",
         method: "POST",
-        url,
         startTime: requestStartTime
       },
-      agent: agentSession ? {
-        name: agentSession.agentName
-      } : void 0,
+      agent: {
+        name: agentName,
+        nodeName
+      },
       messages: {
         input: rawMessages,
         messageCount: rawMessages.length
@@ -3355,114 +3333,63 @@ var CopilotRuntime = class {
         environment: process.env.NODE_ENV
       }
     }, void 0, publicApiKey);
-    try {
-      if (Object.keys(this.agents).length && (agentSession == null ? void 0 : agentSession.agentName) && !this.delegateAgentProcessingToServiceAdapter) {
-        this.agents = {
-          [agentSession.agentName]: this.agents[agentSession.agentName]
+    const serverSideActions = await this.getServerSideActions(request);
+    const messages = convertGqlInputToMessages(rawMessages);
+    const currentAgent = serverSideActions.find((action) => action.name === agentName && isRemoteAgentAction(action));
+    if (!currentAgent) {
+      throw new CopilotKitAgentDiscoveryError({
+        agentName,
+        availableAgents: this.availableAgents
+      });
+    }
+    const availableActionsForCurrentAgent = serverSideActions.filter((action) => (
+      // Case 1: Keep all regular (non-agent) actions
+      !isRemoteAgentAction(action) || // Case 2: For agent actions, keep all except self (prevent infinite loops)
+      isRemoteAgentAction(action) && action.name !== agentName
+    )).map((action) => ({
+      name: action.name,
+      description: action.description,
+      jsonSchema: JSON.stringify(actionParametersToJsonSchema(action.parameters))
+    }));
+    const allAvailableActions = flattenToolCallsNoDuplicates([
+      ...availableActionsForCurrentAgent,
+      ...request.actions
+    ]);
+    if (((_a = this.observability) == null ? void 0 : _a.enabled) && publicApiKey) {
+      try {
+        const requestData = {
+          threadId,
+          runId: void 0,
+          model: forwardedParameters == null ? void 0 : forwardedParameters.model,
+          messages,
+          actions: allAvailableActions,
+          forwardedParameters,
+          timestamp: requestStartTime,
+          provider: "agent",
+          agentName,
+          nodeName
         };
-      }
-      if (agentSession && !this.delegateAgentProcessingToServiceAdapter) {
-        return await this.processAgentRequest(request);
-      }
-      if (serviceAdapter instanceof EmptyAdapter) {
-        throw new CopilotKitMisuseError2({
-          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.`
-        });
-      }
-      const serverSideActions = await this.getServerSideActions(request);
-      const filteredRawMessages = rawMessages.filter((message) => !message.agentStateMessage);
-      const messagesWithInjectedInstructions = this.injectMCPToolInstructions(filteredRawMessages, serverSideActions);
-      const inputMessages = convertGqlInputToMessages(messagesWithInjectedInstructions);
-      if (((_a = this.observability) == null ? void 0 : _a.enabled) && publicApiKey) {
-        try {
-          const requestData = {
-            threadId,
-            runId,
-            model: forwardedParameters == null ? void 0 : forwardedParameters.model,
-            messages: inputMessages,
-            actions: clientSideActionsInput,
-            forwardedParameters,
-            timestamp: requestStartTime,
-            provider: this.detectProvider(serviceAdapter)
-          };
-          await this.observability.hooks.handleRequest(requestData);
-        } catch (error) {
-          console.error("Error logging LLM request:", error);
-        }
-      }
-      const serverSideActionsInput = serverSideActions.map((action) => ({
-        name: action.name,
-        description: action.description,
-        jsonSchema: JSON.stringify(actionParametersToJsonSchema(action.parameters))
-      }));
-      const actionInputs = flattenToolCallsNoDuplicates([
-        ...serverSideActionsInput,
-        ...clientSideActionsInput.filter(
-          // Filter remote actions from CopilotKit core loop
-          (action) => action.available !== ActionInputAvailability.remote
-        )
-      ]);
-      await ((_b = this.onBeforeRequest) == null ? void 0 : _b.call(this, {
-        threadId,
-        runId,
-        inputMessages,
-        properties: graphqlContext.properties,
-        url
-      }));
-      const result = await serviceAdapter.process({
-        messages: inputMessages,
-        actions: actionInputs,
+        await this.observability.hooks.handleRequest(requestData);
+      } catch (error) {
+        console.error("Error logging agent request:", error);
+      }
+    }
+    await ((_b = this.onBeforeRequest) == null ? void 0 : _b.call(this, {
+      threadId,
+      runId: void 0,
+      inputMessages: messages,
+      properties: graphqlContext.properties
+    }));
+    try {
+      const eventSource = new RuntimeEventSource();
+      const stream = await currentAgent.remoteAgentHandler({
+        name: agentName,
         threadId,
-        runId,
-        eventSource,
-        forwardedParameters,
-        extensions,
-        agentSession,
-        agentStates
-      });
-      const nonEmptyThreadId = threadId ?? result.threadId;
-      outputMessagesPromise.then((outputMessages) => {
-        var _a2;
-        (_a2 = this.onAfterRequest) == null ? void 0 : _a2.call(this, {
-          threadId: nonEmptyThreadId,
-          runId: result.runId,
-          inputMessages,
-          outputMessages,
-          properties: graphqlContext.properties,
-          url
-        });
-      }).catch((_error) => {
+        nodeName,
+        metaEvents,
+        actionInputsWithoutAgents: allAvailableActions
       });
-      if (((_c = this.observability) == null ? void 0 : _c.enabled) && publicApiKey) {
-        try {
-          outputMessagesPromise.then((outputMessages) => {
-            const responseData = {
-              threadId: result.threadId,
-              runId: result.runId,
-              model: forwardedParameters == null ? void 0 : forwardedParameters.model,
-              // Use collected chunks for progressive mode or outputMessages for regular mode
-              output: this.observability.progressive ? streamedChunks : outputMessages,
-              latency: Date.now() - requestStartTime,
-              timestamp: Date.now(),
-              provider: this.detectProvider(serviceAdapter),
-              // Indicate this is the final response
-              isFinalResponse: true
-            };
-            try {
-              this.observability.hooks.handleResponse(responseData);
-            } catch (logError) {
-              console.error("Error logging LLM response:", logError);
-            }
-          }).catch((error) => {
-            console.error("Failed to get output messages for logging:", error);
-          });
-        } catch (error) {
-          console.error("Error setting up logging for LLM response:", error);
-        }
-      }
-      if (((_d = this.observability) == null ? void 0 : _d.enabled) && this.observability.progressive && publicApiKey) {
+      if (((_c = this.observability) == null ? void 0 : _c.enabled) && this.observability.progressive && publicApiKey) {
         const originalStream = eventSource.stream.bind(eventSource);
         eventSource.stream = async (callback) => {
           await originalStream(async (eventStream$) => {
@@ -3473,21 +3400,23 @@ please use an LLM adapter instead.`
                   try {
                     const progressiveData = {
                       threadId: threadId || "",
-                      runId,
+                      runId: void 0,
                       model: forwardedParameters == null ? void 0 : forwardedParameters.model,
                       output: event.content,
                       latency: Date.now() - requestStartTime,
                       timestamp: Date.now(),
-                      provider: this.detectProvider(serviceAdapter),
-                      isProgressiveChunk: true
+                      provider: "agent",
+                      isProgressiveChunk: true,
+                      agentName,
+                      nodeName
                     };
                     Promise.resolve().then(() => {
                       this.observability.hooks.handleResponse(progressiveData);
                     }).catch((error) => {
-                      console.error("Error in progressive logging:", error);
+                      console.error("Error in progressive agent logging:", error);
                     });
                   } catch (error) {
-                    console.error("Error preparing progressive log data:", error);
+                    console.error("Error preparing progressive agent log data:", error);
                   }
                 }
               }
@@ -3496,828 +3425,1135 @@ please use an LLM adapter instead.`
           });
         };
       }
+      eventSource.stream(async (eventStream$) => {
+        from(stream).subscribe({
+          next: (event) => eventStream$.next(event),
+          error: async (err) => {
+            var _a2;
+            if (((_a2 = this.observability) == null ? void 0 : _a2.enabled) && publicApiKey) {
+              try {
+                const errorData = {
+                  threadId,
+                  runId: void 0,
+                  model: forwardedParameters == null ? void 0 : forwardedParameters.model,
+                  error: err instanceof Error ? err : String(err),
+                  timestamp: Date.now(),
+                  latency: Date.now() - requestStartTime,
+                  provider: "agent",
+                  agentName,
+                  nodeName
+                };
+                this.observability.hooks.handleError(errorData);
+              } catch (logError) {
+                console.error("Error logging agent error:", logError);
+              }
+            }
+            const structuredError = ensureStructuredError2(err, (error) => this.convertStreamingErrorToStructured(error));
+            await this.trace("error", {
+              threadId,
+              source: "agent",
+              request: {
+                operation: "processAgentRequest",
+                method: "POST",
+                startTime: requestStartTime
+              },
+              response: {
+                endTime: Date.now(),
+                latency: Date.now() - requestStartTime
+              },
+              agent: {
+                name: agentName,
+                nodeName
+              },
+              technical: {
+                environment: process.env.NODE_ENV,
+                stackTrace: err instanceof Error ? err.stack : void 0
+              }
+            }, structuredError, publicApiKey);
+            eventStream$.error(structuredError);
+            eventStream$.complete();
+          },
+          complete: () => eventStream$.complete()
+        });
+      });
+      if (((_d = this.observability) == null ? void 0 : _d.enabled) && publicApiKey) {
+        outputMessagesPromise.then((outputMessages) => {
+          const responseData = {
+            threadId,
+            runId: void 0,
+            model: forwardedParameters == null ? void 0 : forwardedParameters.model,
+            // Use collected chunks for progressive mode or outputMessages for regular mode
+            output: this.observability.progressive ? streamedChunks : outputMessages,
+            latency: Date.now() - requestStartTime,
+            timestamp: Date.now(),
+            provider: "agent",
+            isFinalResponse: true,
+            agentName,
+            nodeName
+          };
+          try {
+            this.observability.hooks.handleResponse(responseData);
+          } catch (logError) {
+            console.error("Error logging agent response:", logError);
+          }
+        }).catch((error) => {
+          console.error("Failed to get output messages for agent logging:", error);
+        });
+      }
+      outputMessagesPromise.then((outputMessages) => {
+        var _a2;
+        (_a2 = this.onAfterRequest) == null ? void 0 : _a2.call(this, {
+          threadId,
+          runId: void 0,
+          inputMessages: messages,
+          outputMessages,
+          properties: graphqlContext.properties
+        });
+      }).catch((_error) => {
+      });
       return {
-        threadId: nonEmptyThreadId,
-        runId: result.runId,
+        threadId,
+        runId: void 0,
         eventSource,
         serverSideActions,
-        actionInputsWithoutAgents: actionInputs.filter((action) => (
-          // TODO-AGENTS: do not exclude ALL server side actions
-          !serverSideActions.find((serverSideAction) => serverSideAction.name == action.name)
-        )),
-        extensions: result.extensions
+        actionInputsWithoutAgents: allAvailableActions
       };
     } catch (error) {
       if (((_e = this.observability) == null ? void 0 : _e.enabled) && publicApiKey) {
         try {
           const errorData = {
             threadId,
-            runId,
+            runId: void 0,
             model: forwardedParameters == null ? void 0 : forwardedParameters.model,
             error: error instanceof Error ? error : String(error),
             timestamp: Date.now(),
             latency: Date.now() - requestStartTime,
-            provider: this.detectProvider(serviceAdapter)
+            provider: "agent",
+            agentName,
+            nodeName
           };
           await this.observability.hooks.handleError(errorData);
         } catch (logError) {
-          console.error("Error logging LLM error:", logError);
+          console.error("Error logging agent error:", logError);
         }
       }
-      let structuredError;
-      if (error instanceof CopilotKitError5) {
-        structuredError = error;
-      } else {
-        console.error("Error getting response:", error);
-        structuredError = this.convertStreamingErrorToStructured(error);
-      }
+      const structuredError = ensureStructuredError2(error, (err) => this.convertStreamingErrorToStructured(err));
       await this.trace("error", {
         threadId,
-        runId,
-        source: "runtime",
+        source: "agent",
         request: {
-          operation: "processRuntimeRequest",
+          operation: "processAgentRequest",
           method: "POST",
-          url,
           startTime: requestStartTime
         },
         response: {
           endTime: Date.now(),
           latency: Date.now() - requestStartTime
         },
-        agent: agentSession ? {
-          name: agentSession.agentName
-        } : void 0,
+        agent: {
+          name: agentName,
+          nodeName
+        },
         technical: {
           environment: process.env.NODE_ENV,
           stackTrace: error instanceof Error ? error.stack : void 0
         }
-      }, structuredError, publicApiKey);
-      throw structuredError;
+      }, structuredError, publicApiKey);
+      console.error("Error getting response:", error);
+      throw structuredError;
+    }
+  }
+  async getServerSideActions(request) {
+    var _a, _b;
+    const { graphqlContext, messages: rawMessages, agentStates, url } = request;
+    const inputMessages = convertGqlInputToMessages(rawMessages);
+    const langserveFunctions = [];
+    for (const chainPromise of this.langserve) {
+      try {
+        const chain = await chainPromise;
+        langserveFunctions.push(chain);
+      } catch (error) {
+        console.error("Error loading langserve chain:", error);
+      }
+    }
+    const remoteEndpointDefinitions = this.remoteEndpointDefinitions.map((endpoint) => ({
+      ...endpoint,
+      type: resolveEndpointType(endpoint)
+    }));
+    const remoteActions = await setupRemoteActions({
+      remoteEndpointDefinitions,
+      graphqlContext,
+      messages: inputMessages,
+      agentStates,
+      frontendUrl: url,
+      agents: this.agents,
+      metaEvents: request.metaEvents
+    });
+    const configuredActions = typeof this.actions === "function" ? this.actions({
+      properties: graphqlContext.properties,
+      url
+    }) : this.actions;
+    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 effectiveEndpointsMap = /* @__PURE__ */ new Map();
+      [
+        ...baseEndpoints
+      ].forEach((ep) => {
+        if (ep && ep.endpoint) {
+          effectiveEndpointsMap.set(ep.endpoint, ep);
+        }
+      });
+      [
+        ...requestEndpoints
+      ].forEach((ep) => {
+        if (ep && ep.endpoint) {
+          effectiveEndpointsMap.set(ep.endpoint, ep);
+        }
+      });
+      const effectiveEndpoints = Array.from(effectiveEndpointsMap.values());
+      for (const config of effectiveEndpoints) {
+        const endpointUrl = config.endpoint;
+        let actionsForEndpoint = this.mcpActionCache.get(endpointUrl);
+        if (!actionsForEndpoint) {
+          let client = null;
+          try {
+            client = await this.createMCPClientImpl(config);
+            const tools = await client.tools();
+            actionsForEndpoint = convertMCPToolsToActions(tools, endpointUrl);
+            this.mcpActionCache.set(endpointUrl, actionsForEndpoint);
+          } catch (error) {
+            console.error(`MCP: Failed to fetch tools from endpoint ${endpointUrl}. Skipping. Error:`, error);
+            actionsForEndpoint = [];
+            this.mcpActionCache.set(endpointUrl, actionsForEndpoint);
+          }
+        }
+        requestSpecificMCPActions.push(...actionsForEndpoint || []);
+      }
     }
-  }
-  async getAllAgents(graphqlContext) {
-    const [agentsWithEndpoints, aguiAgents] = await Promise.all([
-      this.discoverAgentsFromEndpoints(graphqlContext),
-      this.discoverAgentsFromAgui()
-    ]);
-    this.availableAgents = [
-      ...agentsWithEndpoints,
-      ...aguiAgents
-    ].map((a) => ({
-      name: a.name,
-      id: a.id
-    }));
     return [
-      ...agentsWithEndpoints,
-      ...aguiAgents
+      ...configuredActions,
+      ...langserveFunctions,
+      ...remoteActions,
+      ...requestSpecificMCPActions
     ];
   }
-  async discoverAgentsFromEndpoints(graphqlContext) {
-    const agents = this.remoteEndpointDefinitions.reduce(async (acc, endpoint) => {
-      const agents2 = await acc;
-      if (endpoint.type === EndpointType.LangGraphPlatform) {
-        const propertyHeaders = graphqlContext.properties.authorization ? {
-          authorization: `Bearer ${graphqlContext.properties.authorization}`
-        } : null;
-        const client = new LangGraphClient2({
-          apiUrl: endpoint.deploymentUrl,
-          apiKey: endpoint.langsmithApiKey,
-          defaultHeaders: {
-            ...propertyHeaders
-          }
-        });
-        let data = [];
-        try {
-          data = await client.assistants.search();
-          if (data && "detail" in data && data.detail.toLowerCase() === "not found") {
-            throw new CopilotKitAgentDiscoveryError({
-              availableAgents: this.availableAgents
-            });
+  // Add helper method to detect provider
+  detectProvider(serviceAdapter) {
+    const adapterName = serviceAdapter.constructor.name;
+    if (adapterName.includes("OpenAI"))
+      return "openai";
+    if (adapterName.includes("Anthropic"))
+      return "anthropic";
+    if (adapterName.includes("Google"))
+      return "google";
+    if (adapterName.includes("Groq"))
+      return "groq";
+    if (adapterName.includes("LangChain"))
+      return "langchain";
+    return void 0;
+  }
+  convertStreamingErrorToStructured(error) {
+    var _a, _b, _c, _d, _e, _f, _g;
+    let helpfulMessage = generateHelpfulErrorMessage(error, "agent streaming connection");
+    if (((_a = error == null ? void 0 : error.message) == null ? void 0 : _a.includes("fetch failed")) || ((_b = error == null ? void 0 : error.message) == null ? void 0 : _b.includes("ECONNREFUSED")) || ((_c = error == null ? void 0 : error.message) == null ? void 0 : _c.includes("ENOTFOUND")) || ((_d = error == null ? void 0 : error.message) == null ? void 0 : _d.includes("ETIMEDOUT")) || ((_e = error == null ? void 0 : error.message) == null ? void 0 : _e.includes("terminated")) || ((_f = error == null ? void 0 : error.cause) == null ? void 0 : _f.code) === "UND_ERR_SOCKET" || ((_g = error == null ? void 0 : error.message) == null ? void 0 : _g.includes("other side closed")) || (error == null ? void 0 : error.code) === "UND_ERR_SOCKET") {
+      return new CopilotKitLowLevelError3({
+        error: error instanceof Error ? error : new Error(String(error)),
+        url: "agent streaming connection",
+        message: helpfulMessage
+      });
+    }
+    return new CopilotKitError3({
+      message: helpfulMessage,
+      code: CopilotKitErrorCode2.UNKNOWN
+    });
+  }
+  async trace(type, context, error, publicApiKey) {
+    if (!this.onTrace)
+      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;
+      }
+      return;
+    }
+    try {
+      const traceEvent = {
+        type,
+        timestamp: Date.now(),
+        context,
+        ...error && {
+          error
+        }
+      };
+      await this.onTrace(traceEvent);
+    } catch (traceError) {
+      console.error("Error in onTrace handler:", traceError);
+    }
+  }
+  /**
+  * Public method to trace GraphQL validation errors
+  * This allows the GraphQL resolver to send validation errors through the trace system
+  */
+  async traceGraphQLError(error, context) {
+    if (!this.onTrace)
+      return;
+    try {
+      await this.onTrace({
+        type: "error",
+        timestamp: Date.now(),
+        context: {
+          source: "runtime",
+          request: {
+            operation: context.operation,
+            startTime: Date.now()
+          },
+          technical: {
+            environment: process.env.NODE_ENV
+          },
+          metadata: {
+            errorType: "GraphQLValidationError",
+            cloudConfigPresent: context.cloudConfigPresent,
+            guardrailsEnabled: context.guardrailsEnabled
           }
-        } catch (e) {
-          throw new CopilotKitMisuseError2({
-            message: `
-              Failed to find or contact remote endpoint at url ${endpoint.deploymentUrl}.
-              Make sure the API is running and that it's indeed a LangGraph platform url.
-              
-              See more: https://docs.copilotkit.ai/troubleshooting/common-issues`
-          });
+        },
+        error
+      });
+    } catch (traceError) {
+      console.error("Error in onTrace handler:", traceError);
+    }
+  }
+};
+__name(CopilotRuntime, "CopilotRuntime");
+function flattenToolCallsNoDuplicates(toolsByPriority) {
+  let allTools = [];
+  const allToolNames = [];
+  for (const tool of toolsByPriority) {
+    if (!allToolNames.includes(tool.name)) {
+      allTools.push(tool);
+      allToolNames.push(tool.name);
+    }
+  }
+  return allTools;
+}
+__name(flattenToolCallsNoDuplicates, "flattenToolCallsNoDuplicates");
+function copilotKitEndpoint(config) {
+  return {
+    ...config,
+    type: EndpointType.CopilotKit
+  };
+}
+__name(copilotKitEndpoint, "copilotKitEndpoint");
+function langGraphPlatformEndpoint(config) {
+  return {
+    ...config,
+    type: EndpointType.LangGraphPlatform
+  };
+}
+__name(langGraphPlatformEndpoint, "langGraphPlatformEndpoint");
+function resolveEndpointType(endpoint) {
+  if (!endpoint.type) {
+    if ("deploymentUrl" in endpoint && "agents" in endpoint) {
+      return EndpointType.LangGraphPlatform;
+    } else {
+      return EndpointType.CopilotKit;
+    }
+  }
+  return endpoint.type;
+}
+__name(resolveEndpointType, "resolveEndpointType");
+
+// src/lib/telemetry-client.ts
+var packageJson = require_package();
+var telemetryClient = new TelemetryClient({
+  packageName: packageJson.name,
+  packageVersion: packageJson.version
+});
+function getRuntimeInstanceTelemetryInfo(options) {
+  var _a, _b;
+  const runtime = options.runtime;
+  const endpointsInfo = runtime.remoteEndpointDefinitions.reduce((acc, endpoint) => {
+    let info = {
+      ...acc
+    };
+    const endpointType = resolveEndpointType(endpoint);
+    if (!info.endpointTypes.includes(endpointType)) {
+      info = {
+        ...info,
+        endpointTypes: [
+          ...info.endpointTypes,
+          endpointType
+        ]
+      };
+    }
+    if (endpointType === EndpointType.LangGraphPlatform) {
+      const ep = endpoint;
+      info = {
+        ...info,
+        agentsAmount: ep.agents.length,
+        hashedKey: ep.langsmithApiKey ? createHash2("sha256").update(ep.langsmithApiKey).digest("hex") : null
+      };
+    }
+    return info;
+  }, {
+    endpointTypes: [],
+    agentsAmount: null,
+    hashedKey: null
+  });
+  const publicApiKey = (_a = options.cloud) == null ? void 0 : _a.publicApiKey;
+  const apiKeyProvided = !!publicApiKey && publicApiKey.trim().length > 0;
+  return {
+    actionsAmount: runtime.actions.length,
+    endpointsAmount: runtime.remoteEndpointDefinitions.length,
+    endpointTypes: endpointsInfo.endpointTypes,
+    agentsAmount: endpointsInfo.agentsAmount,
+    hashedLgcKey: endpointsInfo.hashedKey,
+    "cloud.api_key_provided": apiKeyProvided,
+    ...apiKeyProvided ? {
+      "cloud.public_api_key": publicApiKey
+    } : {},
+    ...((_b = options.cloud) == null ? void 0 : _b.baseUrl) ? {
+      "cloud.base_url": options.cloud.baseUrl
+    } : {}
+  };
+}
+__name(getRuntimeInstanceTelemetryInfo, "getRuntimeInstanceTelemetryInfo");
+var telemetry_client_default = telemetryClient;
+
+// src/agents/langgraph/event-source.ts
+import { CopilotKitLowLevelError as CopilotKitLowLevelError4, isStructuredCopilotKitError } from "@copilotkit/shared";
+import { catchError, mergeMap, ReplaySubject, scan } from "rxjs";
+var RemoteLangGraphEventSource = class {
+  eventStream$ = new ReplaySubject();
+  shouldEmitToolCall(shouldEmitToolCalls, toolCallName) {
+    if (typeof shouldEmitToolCalls === "boolean") {
+      return shouldEmitToolCalls;
+    }
+    if (Array.isArray(shouldEmitToolCalls)) {
+      return shouldEmitToolCalls.includes(toolCallName);
+    }
+    return shouldEmitToolCalls === toolCallName;
+  }
+  getCurrentContent(event) {
+    var _a, _b, _c, _d, _e;
+    const content = ((_c = (_b = (_a = event.data) == null ? void 0 : _a.chunk) == null ? void 0 : _b.kwargs) == null ? void 0 : _c.content) ?? ((_e = (_d = event.data) == null ? void 0 : _d.chunk) == null ? void 0 : _e.content);
+    if (!content) {
+      const toolCallChunks = this.getCurrentToolCallChunks(event) ?? [];
+      for (const chunk of toolCallChunks) {
+        if (chunk.args) {
+          return chunk.args;
         }
-        const endpointAgents = data.map((entry) => ({
-          name: entry.graph_id,
-          id: entry.assistant_id,
-          description: "",
-          endpoint
-        }));
-        return [
-          ...agents2,
-          ...endpointAgents
-        ];
       }
-      const cpkEndpoint = endpoint;
-      const fetchUrl = `${endpoint.url}/info`;
-      try {
-        const response = await fetchWithRetry(fetchUrl, {
-          method: "POST",
-          headers: createHeaders(cpkEndpoint.onBeforeRequest, graphqlContext),
-          body: JSON.stringify({
-            properties: graphqlContext.properties
-          })
+    }
+    if (typeof content === "string") {
+      return content;
+    } else if (Array.isArray(content) && content.length > 0) {
+      return content[0].text;
+    }
+    return null;
+  }
+  getCurrentMessageId(event) {
+    var _a, _b, _c, _d, _e;
+    return ((_c = (_b = (_a = event.data) == null ? void 0 : _a.chunk) == null ? void 0 : _b.kwargs) == null ? void 0 : _c.id) ?? ((_e = (_d = event.data) == null ? void 0 : _d.chunk) == null ? void 0 : _e.id);
+  }
+  getCurrentToolCallChunks(event) {
+    var _a, _b, _c, _d, _e;
+    return ((_c = (_b = (_a = event.data) == null ? void 0 : _a.chunk) == null ? void 0 : _b.kwargs) == null ? void 0 : _c.tool_call_chunks) ?? ((_e = (_d = event.data) == null ? void 0 : _d.chunk) == null ? void 0 : _e.tool_call_chunks);
+  }
+  getResponseMetadata(event) {
+    var _a, _b, _c, _d, _e;
+    return ((_c = (_b = (_a = event.data) == null ? void 0 : _a.chunk) == null ? void 0 : _b.kwargs) == null ? void 0 : _c.response_metadata) ?? ((_e = (_d = event.data) == null ? void 0 : _d.chunk) == null ? void 0 : _e.response_metadata);
+  }
+  processLangGraphEvents() {
+    let lastEventWithState = null;
+    return this.eventStream$.pipe(scan((acc, event) => {
+      if (event.event === LangGraphEventTypes.OnChatModelStream) {
+        const prevMessageId = acc.lastMessageId;
+        acc.currentContent = this.getCurrentContent(event);
+        acc.lastMessageId = this.getCurrentMessageId(event) ?? acc.lastMessageId;
+        const toolCallChunks = this.getCurrentToolCallChunks(event) ?? [];
+        const responseMetadata = this.getResponseMetadata(event);
+        const toolCallCheck = toolCallChunks && toolCallChunks.length > 0;
+        let isToolCallEnd = (responseMetadata == null ? void 0 : responseMetadata.finish_reason) === "tool_calls";
+        acc.isToolCallStart = toolCallChunks.some((chunk) => chunk.name && chunk.id);
+        acc.isMessageStart = prevMessageId !== acc.lastMessageId && !acc.isToolCallStart;
+        let previousRoundHadToolCall = acc.isToolCall;
+        acc.isToolCall = toolCallCheck;
+        if (previousRoundHadToolCall && !toolCallCheck) {
+          isToolCallEnd = true;
+        }
+        acc.isToolCallEnd = isToolCallEnd;
+        acc.isMessageEnd = (responseMetadata == null ? void 0 : responseMetadata.finish_reason) === "stop";
+        ({ name: acc.lastToolCallName, id: acc.lastToolCallId } = toolCallChunks.find((chunk) => chunk.name && chunk.id) ?? {
+          name: acc.lastToolCallName,
+          id: acc.lastToolCallId
         });
-        if (!response.ok) {
-          if (response.status === 404) {
-            throw new CopilotKitApiDiscoveryError2({
-              url: fetchUrl
-            });
-          }
-          throw new ResolvedCopilotKitError3({
-            status: response.status,
-            url: fetchUrl,
-            isRemoteEndpoint: true
-          });
+      }
+      acc.event = event;
+      lastEventWithState = acc;
+      return acc;
+    }, {
+      event: null,
+      isMessageStart: false,
+      isMessageEnd: false,
+      isToolCallStart: false,
+      isToolCallEnd: false,
+      isToolCall: false,
+      lastMessageId: null,
+      lastToolCallId: null,
+      lastToolCallName: null,
+      currentContent: null,
+      processedToolCallIds: /* @__PURE__ */ new Set()
+    }), mergeMap((acc) => {
+      const events = [];
+      let shouldEmitMessages = true;
+      let shouldEmitToolCalls = true;
+      if (acc.event.event == LangGraphEventTypes.OnChatModelStream) {
+        if ("copilotkit:emit-tool-calls" in (acc.event.metadata || {})) {
+          shouldEmitToolCalls = acc.event.metadata["copilotkit:emit-tool-calls"];
         }
-        const data = await response.json();
-        const endpointAgents = ((data == null ? void 0 : data.agents) ?? []).map((agent) => ({
-          name: agent.name,
-          description: agent.description ?? "" ?? "",
-          id: randomId2(),
-          endpoint
-        }));
-        return [
-          ...agents2,
-          ...endpointAgents
-        ];
-      } catch (error) {
-        if (error instanceof CopilotKitError5) {
-          throw error;
+        if ("copilotkit:emit-messages" in (acc.event.metadata || {})) {
+          shouldEmitMessages = acc.event.metadata["copilotkit:emit-messages"];
         }
-        throw new CopilotKitLowLevelError4({
-          error,
-          url: fetchUrl
+      }
+      if (acc.event.event === LangGraphEventTypes.OnInterrupt) {
+        events.push({
+          type: RuntimeEventTypes.MetaEvent,
+          name: RuntimeMetaEventName.LangGraphInterruptEvent,
+          value: acc.event.value
         });
       }
-    }, 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`
+      if (acc.event.event === LangGraphEventTypes.OnCopilotKitInterrupt) {
+        events.push({
+          type: RuntimeEventTypes.MetaEvent,
+          name: RuntimeMetaEventName.CopilotKitLangGraphInterruptEvent,
+          data: acc.event.data
         });
       }
-      const endpointAgents = data.map((entry) => ({
-        name: entry.graph_id,
-        id: entry.assistant_id,
-        description: ""
-      }));
-      return [
-        ...agents2,
-        ...endpointAgents
-      ];
-    }, Promise.resolve([]));
-    return agents;
-  }
-  async loadAgentState(graphqlContext, threadId, agentName) {
-    const agents = await this.getAllAgents(graphqlContext);
-    const agent = agents.find((agent2) => agent2.name === agentName);
-    if (!agent) {
-      throw new Error("Agent not found");
-    }
-    if ("endpoint" in agent && (agent.endpoint.type === EndpointType.CopilotKit || !("type" in agent.endpoint))) {
-      const cpkEndpoint = agent.endpoint;
-      const fetchUrl = `${cpkEndpoint.url}/agents/state`;
-      try {
-        const response = await fetchWithRetry(fetchUrl, {
-          method: "POST",
-          headers: createHeaders(cpkEndpoint.onBeforeRequest, graphqlContext),
-          body: JSON.stringify({
-            properties: graphqlContext.properties,
-            threadId,
-            name: agentName
-          })
+      if (acc.event.event === LangGraphEventTypes.OnCopilotKitError) {
+        const errorData = acc.event.data.error;
+        const preservedError = new CopilotKitLowLevelError4({
+          error: new Error(errorData.message),
+          url: "langgraph agent",
+          message: `${errorData.type}: ${errorData.message}`
         });
-        if (!response.ok) {
-          if (response.status === 404) {
-            throw new CopilotKitApiDiscoveryError2({
-              url: fetchUrl
+        if (errorData.status_code) {
+          preservedError.statusCode = errorData.status_code;
+        }
+        if (errorData.response_data) {
+          preservedError.responseData = errorData.response_data;
+        }
+        preservedError.agentName = errorData.agent_name;
+        preservedError.originalErrorType = errorData.type;
+        throw preservedError;
+      }
+      const responseMetadata = this.getResponseMetadata(acc.event);
+      if (acc.isToolCallEnd && this.shouldEmitToolCall(shouldEmitToolCalls, acc.lastToolCallName) && acc.lastToolCallId && !acc.processedToolCallIds.has(acc.lastToolCallId)) {
+        acc.processedToolCallIds.add(acc.lastToolCallId);
+        events.push({
+          type: RuntimeEventTypes.ActionExecutionEnd,
+          actionExecutionId: acc.lastToolCallId
+        });
+      } else if ((responseMetadata == null ? void 0 : responseMetadata.finish_reason) === "stop" && shouldEmitMessages) {
+        events.push({
+          type: RuntimeEventTypes.TextMessageEnd,
+          messageId: acc.lastMessageId
+        });
+      }
+      switch (acc.event.event) {
+        case LangGraphEventTypes.OnCustomEvent:
+          if (acc.event.name === CustomEventNames.CopilotKitManuallyEmitMessage) {
+            events.push({
+              type: RuntimeEventTypes.TextMessageStart,
+              messageId: acc.event.data.message_id
+            });
+            events.push({
+              type: RuntimeEventTypes.TextMessageContent,
+              messageId: acc.event.data.message_id,
+              content: acc.event.data.message
+            });
+            events.push({
+              type: RuntimeEventTypes.TextMessageEnd,
+              messageId: acc.event.data.message_id
+            });
+          } else if (acc.event.name === CustomEventNames.CopilotKitManuallyEmitToolCall) {
+            events.push({
+              type: RuntimeEventTypes.ActionExecutionStart,
+              actionExecutionId: acc.event.data.id,
+              actionName: acc.event.data.name,
+              parentMessageId: acc.event.data.id
+            });
+            events.push({
+              type: RuntimeEventTypes.ActionExecutionArgs,
+              actionExecutionId: acc.event.data.id,
+              args: JSON.stringify(acc.event.data.args)
+            });
+            events.push({
+              type: RuntimeEventTypes.ActionExecutionEnd,
+              actionExecutionId: acc.event.data.id
+            });
+          }
+          break;
+        case LangGraphEventTypes.OnCopilotKitStateSync:
+          events.push({
+            type: RuntimeEventTypes.AgentStateMessage,
+            threadId: acc.event.thread_id,
+            role: acc.event.role,
+            agentName: acc.event.agent_name,
+            nodeName: acc.event.node_name,
+            runId: acc.event.run_id,
+            active: acc.event.active,
+            state: JSON.stringify(acc.event.state),
+            running: acc.event.running
+          });
+          break;
+        case LangGraphEventTypes.OnChatModelStream:
+          if (acc.isToolCallStart && this.shouldEmitToolCall(shouldEmitToolCalls, acc.lastToolCallName)) {
+            events.push({
+              type: RuntimeEventTypes.ActionExecutionStart,
+              actionExecutionId: acc.lastToolCallId,
+              actionName: acc.lastToolCallName,
+              parentMessageId: acc.lastMessageId
+            });
+          } else if (acc.isMessageStart && shouldEmitMessages) {
+            acc.processedToolCallIds.clear();
+            events.push({
+              type: RuntimeEventTypes.TextMessageStart,
+              messageId: acc.lastMessageId
             });
           }
-          throw new ResolvedCopilotKitError3({
-            status: response.status,
-            url: fetchUrl,
-            isRemoteEndpoint: true
-          });
-        }
-        const data = await response.json();
-        return {
-          ...data,
-          state: JSON.stringify(data.state),
-          messages: JSON.stringify(data.messages)
-        };
-      } catch (error) {
-        if (error instanceof CopilotKitError5) {
-          throw error;
-        }
-        throw new CopilotKitLowLevelError4({
-          error,
-          url: fetchUrl
-        });
-      }
-    }
-    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`);
+          if (acc.isToolCall && acc.currentContent && this.shouldEmitToolCall(shouldEmitToolCalls, acc.lastToolCallName)) {
+            events.push({
+              type: RuntimeEventTypes.ActionExecutionArgs,
+              actionExecutionId: acc.lastToolCallId,
+              args: acc.currentContent
+            });
+          } else if (!acc.isToolCall && acc.currentContent && shouldEmitMessages) {
+            events.push({
+              type: RuntimeEventTypes.TextMessageContent,
+              messageId: acc.lastMessageId,
+              content: acc.currentContent
+            });
+          }
+          break;
       }
-      client = aguiAgent.client;
-    }
-    let state = {};
-    try {
-      state = (await client.threads.getState(threadId)).values;
-    } catch (error) {
-    }
-    if (Object.keys(state).length === 0) {
-      return {
-        threadId: threadId || "",
-        threadExists: false,
-        state: JSON.stringify({}),
-        messages: JSON.stringify([])
-      };
-    } else {
-      const { messages, ...stateWithoutMessages } = state;
-      const copilotkitMessages = langchainMessagesToCopilotKit(messages);
-      return {
-        threadId: threadId || "",
-        threadExists: true,
-        state: JSON.stringify(stateWithoutMessages),
-        messages: JSON.stringify(copilotkitMessages)
-      };
-    }
-    throw new Error(`Agent: ${agent.name} could not be resolved`);
-  }
-  async processAgentRequest(request) {
-    var _a, _b, _c, _d, _e;
-    const { messages: rawMessages, outputMessagesPromise, graphqlContext, agentSession, threadId: threadIdFromRequest, metaEvents, publicApiKey, forwardedParameters } = request;
-    const { agentName, nodeName } = agentSession;
-    const requestStartTime = Date.now();
-    const streamedChunks = [];
-    const threadId = threadIdFromRequest ?? agentSession.threadId;
-    await this.trace("agent_state", {
-      threadId,
-      source: "agent",
-      request: {
-        operation: "processAgentRequest",
-        method: "POST",
-        startTime: requestStartTime
-      },
-      agent: {
-        name: agentName,
-        nodeName
-      },
-      messages: {
-        input: rawMessages,
-        messageCount: rawMessages.length
-      },
-      technical: {
-        environment: process.env.NODE_ENV
+      return events;
+    }), catchError((error) => {
+      if (isStructuredCopilotKitError(error)) {
+        throw error;
       }
-    }, void 0, publicApiKey);
-    const serverSideActions = await this.getServerSideActions(request);
-    const messages = convertGqlInputToMessages(rawMessages);
-    const currentAgent = serverSideActions.find((action) => action.name === agentName && isRemoteAgentAction(action));
-    if (!currentAgent) {
-      throw new CopilotKitAgentDiscoveryError({
-        agentName,
-        availableAgents: this.availableAgents
+      let helpfulMessage = generateHelpfulErrorMessage(error, "LangGraph agent connection");
+      throw new CopilotKitLowLevelError4({
+        error: error instanceof Error ? error : new Error(String(error)),
+        url: "langgraph event stream",
+        message: helpfulMessage
       });
-    }
-    const availableActionsForCurrentAgent = serverSideActions.filter((action) => (
-      // Case 1: Keep all regular (non-agent) actions
-      !isRemoteAgentAction(action) || // Case 2: For agent actions, keep all except self (prevent infinite loops)
-      isRemoteAgentAction(action) && action.name !== agentName
-    )).map((action) => ({
-      name: action.name,
-      description: action.description,
-      jsonSchema: JSON.stringify(actionParametersToJsonSchema(action.parameters))
-    }));
-    const allAvailableActions = flattenToolCallsNoDuplicates([
-      ...availableActionsForCurrentAgent,
-      ...request.actions
-    ]);
-    if (((_a = this.observability) == null ? void 0 : _a.enabled) && publicApiKey) {
-      try {
-        const requestData = {
-          threadId,
-          runId: void 0,
-          model: forwardedParameters == null ? void 0 : forwardedParameters.model,
-          messages,
-          actions: allAvailableActions,
-          forwardedParameters,
-          timestamp: requestStartTime,
-          provider: "agent",
-          agentName,
-          nodeName
-        };
-        await this.observability.hooks.handleRequest(requestData);
-      } catch (error) {
-        console.error("Error logging agent request:", error);
-      }
-    }
-    await ((_b = this.onBeforeRequest) == null ? void 0 : _b.call(this, {
-      threadId,
-      runId: void 0,
-      inputMessages: messages,
-      properties: graphqlContext.properties
     }));
-    try {
-      const eventSource = new RuntimeEventSource();
-      const stream = await currentAgent.remoteAgentHandler({
-        name: agentName,
-        threadId,
-        nodeName,
-        metaEvents,
-        actionInputsWithoutAgents: allAvailableActions
-      });
-      if (((_c = this.observability) == null ? void 0 : _c.enabled) && this.observability.progressive && publicApiKey) {
-        const originalStream = eventSource.stream.bind(eventSource);
-        eventSource.stream = async (callback) => {
-          await originalStream(async (eventStream$) => {
-            eventStream$.subscribe({
-              next: (event) => {
-                if (event.type === RuntimeEventTypes.TextMessageContent) {
-                  streamedChunks.push(event.content);
-                  try {
-                    const progressiveData = {
-                      threadId: threadId || "",
-                      runId: void 0,
-                      model: forwardedParameters == null ? void 0 : forwardedParameters.model,
-                      output: event.content,
-                      latency: Date.now() - requestStartTime,
-                      timestamp: Date.now(),
-                      provider: "agent",
-                      isProgressiveChunk: true,
-                      agentName,
-                      nodeName
-                    };
-                    Promise.resolve().then(() => {
-                      this.observability.hooks.handleResponse(progressiveData);
-                    }).catch((error) => {
-                      console.error("Error in progressive agent logging:", error);
-                    });
-                  } catch (error) {
-                    console.error("Error preparing progressive agent log data:", error);
-                  }
-                }
-              }
-            });
-            await callback(eventStream$);
-          });
-        };
-      }
-      eventSource.stream(async (eventStream$) => {
-        from(stream).subscribe({
-          next: (event) => eventStream$.next(event),
-          error: async (err) => {
-            var _a2;
-            console.error("Error in stream", err);
-            if (((_a2 = this.observability) == null ? void 0 : _a2.enabled) && publicApiKey) {
-              try {
-                const errorData = {
-                  threadId,
-                  runId: void 0,
-                  model: forwardedParameters == null ? void 0 : forwardedParameters.model,
-                  error: err instanceof Error ? err : String(err),
-                  timestamp: Date.now(),
-                  latency: Date.now() - requestStartTime,
-                  provider: "agent",
-                  agentName,
-                  nodeName
-                };
-                this.observability.hooks.handleError(errorData);
-              } catch (logError) {
-                console.error("Error logging agent error:", logError);
-              }
-            }
-            const structuredError = this.convertStreamingErrorToStructured(err);
-            await this.trace("error", {
-              threadId,
-              source: "agent",
-              request: {
-                operation: "processAgentRequest",
-                method: "POST",
-                startTime: requestStartTime
-              },
-              response: {
-                endTime: Date.now(),
-                latency: Date.now() - requestStartTime
-              },
-              agent: {
-                name: agentName,
-                nodeName
-              },
-              technical: {
-                environment: process.env.NODE_ENV,
-                stackTrace: err instanceof Error ? err.stack : void 0
-              }
-            }, structuredError, publicApiKey);
-            eventStream$.error(structuredError);
-            eventStream$.complete();
-          },
-          complete: () => eventStream$.complete()
-        });
+  }
+};
+__name(RemoteLangGraphEventSource, "RemoteLangGraphEventSource");
+
+// src/lib/runtime/remote-action-constructors.ts
+import { CopilotKitError as CopilotKitError4, CopilotKitLowLevelError as CopilotKitLowLevelError5 } from "@copilotkit/shared";
+import { CopilotKitApiDiscoveryError as CopilotKitApiDiscoveryError2, ResolvedCopilotKitError as ResolvedCopilotKitError2 } from "@copilotkit/shared";
+import { parseJson as parseJson2, tryMap as tryMap2 } from "@copilotkit/shared";
+function constructLGCRemoteAction({ endpoint, graphqlContext, logger: logger2, messages, agentStates }) {
+  const agents = endpoint.agents.map((agent) => ({
+    name: agent.name,
+    description: agent.description,
+    parameters: [],
+    handler: async (_args) => {
+    },
+    remoteAgentHandler: async ({ name, actionInputsWithoutAgents, threadId, nodeName, additionalMessages = [], metaEvents }) => {
+      logger2.debug({
+        actionName: agent.name
+      }, "Executing LangGraph Platform agent");
+      telemetry_client_default.capture("oss.runtime.remote_action_executed", {
+        agentExecution: true,
+        type: "langgraph-platform",
+        agentsAmount: endpoint.agents.length,
+        hashedLgcKey: endpoint.langsmithApiKey ? createHash3("sha256").update(endpoint.langsmithApiKey).digest("hex") : null
       });
-      if (((_d = this.observability) == null ? void 0 : _d.enabled) && publicApiKey) {
-        outputMessagesPromise.then((outputMessages) => {
-          const responseData = {
-            threadId,
-            runId: void 0,
-            model: forwardedParameters == null ? void 0 : forwardedParameters.model,
-            // Use collected chunks for progressive mode or outputMessages for regular mode
-            output: this.observability.progressive ? streamedChunks : outputMessages,
-            latency: Date.now() - requestStartTime,
-            timestamp: Date.now(),
-            provider: "agent",
-            isFinalResponse: true,
-            agentName,
-            nodeName
-          };
-          try {
-            this.observability.hooks.handleResponse(responseData);
-          } catch (logError) {
-            console.error("Error logging agent response:", logError);
-          }
-        }).catch((error) => {
-          console.error("Failed to get output messages for agent logging:", error);
-        });
+      let state = {};
+      let config = {};
+      if (agentStates) {
+        const jsonState = agentStates.find((state2) => state2.agentName === name);
+        if (jsonState) {
+          state = parseJson2(jsonState.state, {});
+          config = parseJson2(jsonState.config, {});
+        }
       }
-      outputMessagesPromise.then((outputMessages) => {
-        var _a2;
-        (_a2 = this.onAfterRequest) == null ? void 0 : _a2.call(this, {
+      try {
+        const response = await execute({
+          logger: logger2.child({
+            component: "remote-actions.remote-lg-action.streamEvents"
+          }),
+          deploymentUrl: endpoint.deploymentUrl,
+          langsmithApiKey: endpoint.langsmithApiKey,
+          agent,
           threadId,
-          runId: void 0,
-          inputMessages: messages,
-          outputMessages,
-          properties: graphqlContext.properties
+          nodeName,
+          messages: [
+            ...messages,
+            ...additionalMessages
+          ],
+          state,
+          config,
+          properties: graphqlContext.properties,
+          actions: tryMap2(actionInputsWithoutAgents, (action) => ({
+            name: action.name,
+            description: action.description,
+            parameters: JSON.parse(action.jsonSchema)
+          })),
+          metaEvents
         });
-      }).catch((_error) => {
+        const eventSource = new RemoteLangGraphEventSource();
+        writeJsonLineResponseToEventStream(response, eventSource.eventStream$);
+        return eventSource.processLangGraphEvents();
+      } catch (error) {
+        if (error instanceof CopilotKitError4 || error instanceof CopilotKitLowLevelError5) {
+          if (isUserConfigurationError(error)) {
+            logger2.debug({
+              url: endpoint.deploymentUrl,
+              error: error.message,
+              code: error.code
+            }, "User configuration error in LangGraph Platform agent");
+          } else {
+            logger2.error({
+              url: endpoint.deploymentUrl,
+              error: error.message,
+              type: error.constructor.name
+            }, "LangGraph Platform agent error");
+          }
+          throw error;
+        }
+        logger2.error({
+          url: endpoint.deploymentUrl,
+          status: 500,
+          body: error.message
+        }, "Failed to execute LangGraph Platform agent");
+        throw new CopilotKitLowLevelError5({
+          error: error instanceof Error ? error : new Error(String(error)),
+          url: endpoint.deploymentUrl,
+          message: "Failed to execute LangGraph Platform agent"
+        });
+      }
+    }
+  }));
+  return [
+    ...agents
+  ];
+}
+__name(constructLGCRemoteAction, "constructLGCRemoteAction");
+var RemoteAgentType;
+(function(RemoteAgentType2) {
+  RemoteAgentType2["LangGraph"] = "langgraph";
+  RemoteAgentType2["CrewAI"] = "crewai";
+})(RemoteAgentType || (RemoteAgentType = {}));
+function constructRemoteActions({ json, url, onBeforeRequest, graphqlContext, logger: logger2, messages, agentStates }) {
+  const totalAgents = Array.isArray(json["agents"]) ? json["agents"].length : 0;
+  const actions = json["actions"].map((action) => ({
+    name: action.name,
+    description: action.description,
+    parameters: action.parameters,
+    handler: async (args) => {
+      logger2.debug({
+        actionName: action.name,
+        args
+      }, "Executing remote action");
+      const headers = createHeaders(onBeforeRequest, graphqlContext);
+      telemetry_client_default.capture("oss.runtime.remote_action_executed", {
+        agentExecution: false,
+        type: "self-hosted",
+        agentsAmount: totalAgents
       });
-      return {
-        threadId,
-        runId: void 0,
-        eventSource,
-        serverSideActions,
-        actionInputsWithoutAgents: allAvailableActions
-      };
-    } catch (error) {
-      if (((_e = this.observability) == null ? void 0 : _e.enabled) && publicApiKey) {
-        try {
-          const errorData = {
-            threadId,
-            runId: void 0,
-            model: forwardedParameters == null ? void 0 : forwardedParameters.model,
-            error: error instanceof Error ? error : String(error),
-            timestamp: Date.now(),
-            latency: Date.now() - requestStartTime,
-            provider: "agent",
-            agentName,
-            nodeName
-          };
-          await this.observability.hooks.handleError(errorData);
-        } catch (logError) {
-          console.error("Error logging agent error:", logError);
+      const fetchUrl = `${url}/actions/execute`;
+      try {
+        const response = await fetchWithRetry(fetchUrl, {
+          method: "POST",
+          headers,
+          body: JSON.stringify({
+            name: action.name,
+            arguments: args,
+            properties: graphqlContext.properties
+          })
+        }, logger2);
+        if (!response.ok) {
+          logger2.error({
+            url,
+            status: response.status,
+            body: await response.text()
+          }, "Failed to execute remote action");
+          if (response.status === 404) {
+            throw new CopilotKitApiDiscoveryError2({
+              url: fetchUrl
+            });
+          }
+          throw new ResolvedCopilotKitError2({
+            status: response.status,
+            url: fetchUrl,
+            isRemoteEndpoint: true
+          });
+        }
+        const requestResult = await response.json();
+        const result = requestResult["result"];
+        logger2.debug({
+          actionName: action.name,
+          result
+        }, "Executed remote action");
+        return result;
+      } catch (error) {
+        if (error instanceof CopilotKitError4 || error instanceof CopilotKitLowLevelError5) {
+          throw error;
         }
+        throw new CopilotKitLowLevelError5({
+          error,
+          url: fetchUrl
+        });
       }
-      let structuredError;
-      if (error instanceof CopilotKitError5) {
-        structuredError = error;
-      } else {
-        structuredError = this.convertStreamingErrorToStructured(error);
+    }
+  }));
+  const agents = totalAgents ? json["agents"].map((agent) => ({
+    name: agent.name,
+    description: agent.description,
+    parameters: [],
+    handler: async (_args) => {
+    },
+    remoteAgentHandler: async ({ name, actionInputsWithoutAgents, threadId, nodeName, additionalMessages = [], metaEvents }) => {
+      logger2.debug({
+        actionName: agent.name
+      }, "Executing remote agent");
+      const headers = createHeaders(onBeforeRequest, graphqlContext);
+      telemetry_client_default.capture("oss.runtime.remote_action_executed", {
+        agentExecution: true,
+        type: "self-hosted",
+        agentsAmount: json["agents"].length
+      });
+      let state = {};
+      let config = {};
+      if (agentStates) {
+        const jsonState = agentStates.find((state2) => state2.agentName === name);
+        if (jsonState) {
+          state = parseJson2(jsonState.state, {});
+          config = parseJson2(jsonState.config, {});
+        }
       }
-      await this.trace("error", {
-        threadId,
-        source: "agent",
-        request: {
-          operation: "processAgentRequest",
+      const fetchUrl = `${url}/agents/execute`;
+      try {
+        const response = await fetchWithRetry(fetchUrl, {
           method: "POST",
-          startTime: requestStartTime
-        },
-        response: {
-          endTime: Date.now(),
-          latency: Date.now() - requestStartTime
-        },
-        agent: {
-          name: agentName,
-          nodeName
-        },
-        technical: {
-          environment: process.env.NODE_ENV,
-          stackTrace: error instanceof Error ? error.stack : void 0
+          headers,
+          body: JSON.stringify({
+            name,
+            threadId,
+            nodeName,
+            messages: [
+              ...messages,
+              ...additionalMessages
+            ],
+            state,
+            config,
+            properties: graphqlContext.properties,
+            actions: tryMap2(actionInputsWithoutAgents, (action) => ({
+              name: action.name,
+              description: action.description,
+              parameters: JSON.parse(action.jsonSchema)
+            })),
+            metaEvents
+          })
+        }, logger2);
+        if (!response.ok) {
+          logger2.error({
+            url,
+            status: response.status,
+            body: await response.text()
+          }, "Failed to execute remote agent");
+          if (response.status === 404) {
+            throw new CopilotKitApiDiscoveryError2({
+              url: fetchUrl
+            });
+          }
+          throw new ResolvedCopilotKitError2({
+            status: response.status,
+            url: fetchUrl,
+            isRemoteEndpoint: true
+          });
+        }
+        if (agent.type === "langgraph") {
+          const eventSource = new RemoteLangGraphEventSource();
+          writeJsonLineResponseToEventStream(response.body, eventSource.eventStream$);
+          return eventSource.processLangGraphEvents();
+        } else if (agent.type === "crewai") {
+          const eventStream$ = new RuntimeEventSubject();
+          writeJsonLineResponseToEventStream(response.body, eventStream$);
+          return eventStream$;
+        } else {
+          throw new Error("Unsupported agent type");
         }
-      }, structuredError, publicApiKey);
-      console.error("Error getting response:", error);
-      throw structuredError;
-    }
-  }
-  async getServerSideActions(request) {
-    var _a, _b;
-    const { graphqlContext, messages: rawMessages, agentStates, url } = request;
-    const inputMessages = convertGqlInputToMessages(rawMessages);
-    const langserveFunctions = [];
-    for (const chainPromise of this.langserve) {
-      try {
-        const chain = await chainPromise;
-        langserveFunctions.push(chain);
       } catch (error) {
-        console.error("Error loading langserve chain:", error);
+        if (error instanceof CopilotKitError4 || error instanceof CopilotKitLowLevelError5) {
+          throw error;
+        }
+        throw new CopilotKitLowLevelError5({
+          error,
+          url: fetchUrl
+        });
       }
     }
-    const remoteEndpointDefinitions = this.remoteEndpointDefinitions.map((endpoint) => ({
-      ...endpoint,
-      type: resolveEndpointType(endpoint)
-    }));
-    const remoteActions = await setupRemoteActions({
-      remoteEndpointDefinitions,
-      graphqlContext,
-      messages: inputMessages,
-      agentStates,
-      frontendUrl: url,
-      agents: this.agents,
-      metaEvents: request.metaEvents
+  })) : [];
+  return [
+    ...actions,
+    ...agents
+  ];
+}
+__name(constructRemoteActions, "constructRemoteActions");
+function createHeaders(onBeforeRequest, graphqlContext) {
+  const headers = {
+    "Content-Type": "application/json"
+  };
+  if (onBeforeRequest) {
+    const { headers: additionalHeaders } = onBeforeRequest({
+      ctx: graphqlContext
     });
-    const configuredActions = typeof this.actions === "function" ? this.actions({
-      properties: graphqlContext.properties,
-      url
-    }) : this.actions;
-    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 effectiveEndpointsMap = /* @__PURE__ */ new Map();
-      [
-        ...baseEndpoints
-      ].forEach((ep) => {
-        if (ep && ep.endpoint) {
-          effectiveEndpointsMap.set(ep.endpoint, ep);
-        }
-      });
-      [
-        ...requestEndpoints
-      ].forEach((ep) => {
-        if (ep && ep.endpoint) {
-          effectiveEndpointsMap.set(ep.endpoint, ep);
-        }
+    if (additionalHeaders) {
+      Object.assign(headers, additionalHeaders);
+    }
+  }
+  return headers;
+}
+__name(createHeaders, "createHeaders");
+
+// src/lib/runtime/remote-actions.ts
+import { CopilotKitLowLevelError as CopilotKitLowLevelError6, ResolvedCopilotKitError as ResolvedCopilotKitError3, CopilotKitError as CopilotKitError5 } from "@copilotkit/shared";
+
+// src/lib/runtime/agui-action.ts
+import { parseJson as parseJson3 } from "@copilotkit/shared";
+function constructAGUIRemoteAction({ logger: logger2, messages, agentStates, agent, metaEvents }) {
+  const action = {
+    name: agent.agentId,
+    description: agent.description,
+    parameters: [],
+    handler: async (_args) => {
+    },
+    remoteAgentHandler: async ({ actionInputsWithoutAgents, threadId }) => {
+      var _a;
+      logger2.debug({
+        actionName: agent.agentId
+      }, "Executing remote agent");
+      const agentWireMessages = convertMessagesToAGUIMessage(messages);
+      agent.messages = agentWireMessages;
+      agent.threadId = threadId;
+      telemetry_client_default.capture("oss.runtime.remote_action_executed", {
+        agentExecution: true,
+        type: "self-hosted",
+        agentsAmount: 1
       });
-      const effectiveEndpoints = Array.from(effectiveEndpointsMap.values());
-      for (const config of effectiveEndpoints) {
-        const endpointUrl = config.endpoint;
-        let actionsForEndpoint = this.mcpActionCache.get(endpointUrl);
-        if (!actionsForEndpoint) {
-          let client = null;
-          try {
-            client = await this.createMCPClientImpl(config);
-            const tools = await client.tools();
-            actionsForEndpoint = convertMCPToolsToActions(tools, endpointUrl);
-            this.mcpActionCache.set(endpointUrl, actionsForEndpoint);
-          } catch (error) {
-            console.error(`MCP: Failed to fetch tools from endpoint ${endpointUrl}. Skipping. Error:`, error);
-            actionsForEndpoint = [];
-            this.mcpActionCache.set(endpointUrl, actionsForEndpoint);
-          }
+      let state = {};
+      if (agentStates) {
+        const jsonState = agentStates.find((state2) => state2.agentName === agent.agentId);
+        if (jsonState) {
+          state = parseJson3(jsonState.state, {});
         }
-        requestSpecificMCPActions.push(...actionsForEndpoint || []);
       }
-    }
-    return [
-      ...configuredActions,
-      ...langserveFunctions,
-      ...remoteActions,
-      ...requestSpecificMCPActions
-    ];
-  }
-  // Add helper method to detect provider
-  detectProvider(serviceAdapter) {
-    const adapterName = serviceAdapter.constructor.name;
-    if (adapterName.includes("OpenAI"))
-      return "openai";
-    if (adapterName.includes("Anthropic"))
-      return "anthropic";
-    if (adapterName.includes("Google"))
-      return "google";
-    if (adapterName.includes("Groq"))
-      return "groq";
-    if (adapterName.includes("LangChain"))
-      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
+      agent.state = state;
+      const tools = actionInputsWithoutAgents.map((input) => {
+        return {
+          name: input.name,
+          description: input.description,
+          parameters: JSON.parse(input.jsonSchema)
+        };
       });
-    }
-    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."
+      const forwardedProps = metaEvents.length ? {
+        command: {
+          resume: (_a = metaEvents[0]) == null ? void 0 : _a.response
+        }
+      } : void 0;
+      return agent.legacy_to_be_removed_runAgentBridged({
+        tools,
+        forwardedProps
       });
     }
-    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 [
+    action
+  ];
+}
+__name(constructAGUIRemoteAction, "constructAGUIRemoteAction");
+function convertMessagesToAGUIMessage(messages) {
+  const result = [];
+  for (const message of messages) {
+    if (message.isTextMessage()) {
+      result.push({
+        id: message.id,
+        role: message.role,
+        content: message.content
       });
-    }
-    return new CopilotKitError5({
-      message: `Agent streaming error: ${(error == null ? void 0 : error.message) || String(error)}`,
-      code: CopilotKitErrorCode3.UNKNOWN
-    });
-  }
-  async trace(type, context, error, publicApiKey) {
-    if (!this.onTrace)
-      return;
-    if (!publicApiKey) {
-      if (!this.hasWarnedAboutTracing) {
-        console.warn("CopilotKit: onTrace handler provided but requires publicApiKey for tracing to work. This is a CopilotKit Cloud feature. See: https://docs.copilotkit.ai/cloud");
-        this.hasWarnedAboutTracing = true;
-      }
-      return;
-    }
-    try {
-      const traceEvent = {
-        type,
-        timestamp: Date.now(),
-        context,
-        ...error && {
-          error
+    } else if (message.isActionExecutionMessage()) {
+      const toolCall = {
+        id: message.id,
+        type: "function",
+        function: {
+          name: message.name,
+          arguments: JSON.stringify(message.arguments)
         }
       };
-      await this.onTrace(traceEvent);
-    } catch (traceError) {
-      console.error("Error in onTrace handler:", traceError);
-    }
-  }
-  /**
-  * Public method to trace GraphQL validation errors
-  * This allows the GraphQL resolver to send validation errors through the trace system
-  */
-  async traceGraphQLError(error, context) {
-    if (!this.onTrace)
-      return;
-    try {
-      await this.onTrace({
-        type: "error",
-        timestamp: Date.now(),
-        context: {
-          source: "runtime",
-          request: {
-            operation: context.operation,
-            startTime: Date.now()
-          },
-          technical: {
-            environment: process.env.NODE_ENV
-          },
-          metadata: {
-            errorType: "GraphQLValidationError",
-            cloudConfigPresent: context.cloudConfigPresent,
-            guardrailsEnabled: context.guardrailsEnabled
-          }
-        },
-        error
+      if (message.parentMessageId && result.some((m) => m.id === message.parentMessageId)) {
+        const parentMessage = result.find((m) => m.id === message.parentMessageId);
+        if (parentMessage.toolCalls === void 0) {
+          parentMessage.toolCalls = [];
+        }
+        parentMessage.toolCalls.push(toolCall);
+      } else {
+        result.push({
+          id: message.parentMessageId ?? message.id,
+          role: "assistant",
+          toolCalls: [
+            toolCall
+          ]
+        });
+      }
+    } else if (message.isResultMessage()) {
+      result.push({
+        id: message.id,
+        role: "tool",
+        content: message.result,
+        toolCallId: message.actionExecutionId
       });
-    } catch (traceError) {
-      console.error("Error in onTrace handler:", traceError);
-    }
-  }
-};
-__name(CopilotRuntime, "CopilotRuntime");
-function flattenToolCallsNoDuplicates(toolsByPriority) {
-  let allTools = [];
-  const allToolNames = [];
-  for (const tool of toolsByPriority) {
-    if (!allToolNames.includes(tool.name)) {
-      allTools.push(tool);
-      allToolNames.push(tool.name);
     }
   }
-  return allTools;
-}
-__name(flattenToolCallsNoDuplicates, "flattenToolCallsNoDuplicates");
-function copilotKitEndpoint(config) {
-  return {
-    ...config,
-    type: EndpointType.CopilotKit
-  };
+  return result;
 }
-__name(copilotKitEndpoint, "copilotKitEndpoint");
-function langGraphPlatformEndpoint(config) {
-  return {
-    ...config,
-    type: EndpointType.LangGraphPlatform
-  };
+__name(convertMessagesToAGUIMessage, "convertMessagesToAGUIMessage");
+
+// src/lib/runtime/remote-actions.ts
+var EndpointType;
+(function(EndpointType2) {
+  EndpointType2["CopilotKit"] = "copilotKit";
+  EndpointType2["LangGraphPlatform"] = "langgraph-platform";
+})(EndpointType || (EndpointType = {}));
+function isRemoteAgentAction(action) {
+  if (!action) {
+    return false;
+  }
+  return typeof action.remoteAgentHandler === "function";
 }
-__name(langGraphPlatformEndpoint, "langGraphPlatformEndpoint");
-function resolveEndpointType(endpoint) {
-  if (!endpoint.type) {
-    if ("deploymentUrl" in endpoint && "agents" in endpoint) {
-      return EndpointType.LangGraphPlatform;
-    } else {
-      return EndpointType.CopilotKit;
+__name(isRemoteAgentAction, "isRemoteAgentAction");
+async function fetchRemoteInfo({ url, onBeforeRequest, graphqlContext, logger: logger2, frontendUrl }) {
+  logger2.debug({
+    url
+  }, "Fetching actions from url");
+  const headers = createHeaders(onBeforeRequest, graphqlContext);
+  const fetchUrl = `${url}/info`;
+  try {
+    const response = await fetch(fetchUrl, {
+      method: "POST",
+      headers,
+      body: JSON.stringify({
+        properties: graphqlContext.properties,
+        frontendUrl
+      })
+    });
+    if (!response.ok) {
+      logger2.error({
+        url,
+        status: response.status,
+        body: await response.text()
+      }, "Failed to fetch actions from url");
+      throw new ResolvedCopilotKitError3({
+        status: response.status,
+        url: fetchUrl,
+        isRemoteEndpoint: true
+      });
+    }
+    const json = await response.json();
+    logger2.debug({
+      json
+    }, "Fetched actions from url");
+    return json;
+  } catch (error) {
+    if (error instanceof CopilotKitError5) {
+      throw error;
     }
+    throw new CopilotKitLowLevelError6({
+      error,
+      url: fetchUrl
+    });
   }
-  return endpoint.type;
 }
-__name(resolveEndpointType, "resolveEndpointType");
-
-// src/lib/telemetry-client.ts
-var packageJson = require_package();
-var telemetryClient = new TelemetryClient({
-  packageName: packageJson.name,
-  packageVersion: packageJson.version
-});
-function getRuntimeInstanceTelemetryInfo(options) {
-  var _a, _b;
-  const runtime = options.runtime;
-  const endpointsInfo = runtime.remoteEndpointDefinitions.reduce((acc, endpoint) => {
-    let info = {
-      ...acc
-    };
-    const endpointType = resolveEndpointType(endpoint);
-    if (!info.endpointTypes.includes(endpointType)) {
-      info = {
-        ...info,
-        endpointTypes: [
-          ...info.endpointTypes,
-          endpointType
-        ]
-      };
-    }
-    if (endpointType === EndpointType.LangGraphPlatform) {
-      const ep = endpoint;
-      info = {
-        ...info,
-        agentsAmount: ep.agents.length,
-        hashedKey: ep.langsmithApiKey ? createHash3("sha256").update(ep.langsmithApiKey).digest("hex") : null
-      };
+__name(fetchRemoteInfo, "fetchRemoteInfo");
+async function setupRemoteActions({ remoteEndpointDefinitions, graphqlContext, messages, agentStates, frontendUrl, agents, metaEvents }) {
+  const logger2 = graphqlContext.logger.child({
+    component: "remote-actions.fetchRemoteActions"
+  });
+  logger2.debug({
+    remoteEndpointDefinitions
+  }, "Fetching from remote endpoints");
+  const filtered = remoteEndpointDefinitions.filter((value, index, self) => {
+    if (value.type === "langgraph-platform") {
+      return value;
     }
-    return info;
-  }, {
-    endpointTypes: [],
-    agentsAmount: null,
-    hashedKey: null
+    return index === self.findIndex((t) => t.url === value.url);
   });
-  const publicApiKey = (_a = options.cloud) == null ? void 0 : _a.publicApiKey;
-  const apiKeyProvided = !!publicApiKey && publicApiKey.trim().length > 0;
-  return {
-    actionsAmount: runtime.actions.length,
-    endpointsAmount: runtime.remoteEndpointDefinitions.length,
-    endpointTypes: endpointsInfo.endpointTypes,
-    agentsAmount: endpointsInfo.agentsAmount,
-    hashedLgcKey: endpointsInfo.hashedKey,
-    "cloud.api_key_provided": apiKeyProvided,
-    ...apiKeyProvided ? {
-      "cloud.public_api_key": publicApiKey
-    } : {},
-    ...((_b = options.cloud) == null ? void 0 : _b.baseUrl) ? {
-      "cloud.base_url": options.cloud.baseUrl
-    } : {}
-  };
+  const result = await Promise.all(filtered.map(async (endpoint) => {
+    if (endpoint.type === "langgraph-platform") {
+      return constructLGCRemoteAction({
+        endpoint,
+        messages,
+        graphqlContext,
+        logger: logger2.child({
+          component: "remote-actions.constructLGCRemoteAction",
+          endpoint
+        }),
+        agentStates
+      });
+    }
+    const json = await fetchRemoteInfo({
+      url: endpoint.url,
+      onBeforeRequest: endpoint.onBeforeRequest,
+      graphqlContext,
+      logger: logger2.child({
+        component: "remote-actions.fetchActionsFromUrl",
+        endpoint
+      }),
+      frontendUrl
+    });
+    return constructRemoteActions({
+      json,
+      messages,
+      url: endpoint.url,
+      onBeforeRequest: endpoint.onBeforeRequest,
+      graphqlContext,
+      logger: logger2.child({
+        component: "remote-actions.constructActions",
+        endpoint
+      }),
+      agentStates
+    });
+  }));
+  for (const [key, agent] of Object.entries(agents)) {
+    if (agent.agentId !== void 0 && agent.agentId !== key) {
+      throw new CopilotKitError5({
+        message: `Agent ${key} has agentId ${agent.agentId} which does not match the key ${key}`,
+        code: CopilotKitErrorCode3.UNKNOWN
+      });
+    } else if (agent.agentId === void 0) {
+      agent.agentId = key;
+    }
+    result.push(constructAGUIRemoteAction({
+      logger: logger2,
+      messages,
+      agentStates,
+      agent,
+      metaEvents
+    }));
+  }
+  return result.flat();
 }
-__name(getRuntimeInstanceTelemetryInfo, "getRuntimeInstanceTelemetryInfo");
-var telemetry_client_default = telemetryClient;
+__name(setupRemoteActions, "setupRemoteActions");
 
 // src/service-adapters/events.ts
-import { plainToInstance as plainToInstance2 } from "class-transformer";
 var RuntimeEventTypes;
 (function(RuntimeEventTypes2) {
   RuntimeEventTypes2["TextMessageStart"] = "TextMessageStart";
@@ -4440,16 +4676,15 @@ var RuntimeEventSource = class {
     const errorMessage = `\u274C ${message}`;
     if (!this.callback) {
       this.stream(async (eventStream$) => {
-        eventStream$.sendTextMessage(randomId3(), errorMessage);
+        eventStream$.sendTextMessage(randomId2(), errorMessage);
       });
     } else {
-      this.eventStream$.sendTextMessage(randomId3(), errorMessage);
+      this.eventStream$.sendTextMessage(randomId2(), errorMessage);
     }
   }
   processRuntimeEvents({ serverSideActions, guardrailsResult$, actionInputsWithoutAgents, threadId }) {
     this.callback(this.eventStream$).catch((error) => {
-      console.error("Error in event source callback", error);
-      const structuredError = convertStreamingErrorToStructured2(error);
+      const structuredError = ensureStructuredError3(error, convertStreamingErrorToStructured2);
       this.eventStream$.error(structuredError);
       this.eventStream$.complete();
     });
@@ -4484,12 +4719,10 @@ var RuntimeEventSource = class {
         if (eventWithState.event.type === "ActionExecutionEnd" && eventWithState.callActionServerSide) {
           const toolCallEventStream$ = new RuntimeEventSubject();
           executeAction(toolCallEventStream$, guardrailsResult$ ? guardrailsResult$ : null, eventWithState.action, eventWithState.args, eventWithState.actionExecutionParentMessageId, eventWithState.actionExecutionId, actionInputsWithoutAgents, threadId).catch((error) => {
-            console.error(error);
           });
           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);
-            const structuredError = convertStreamingErrorToStructured2(error);
+            const structuredError = ensureStructuredError3(error, convertStreamingErrorToStructured2);
             toolCallEventStream$.sendActionExecutionResult({
               actionExecutionId: eventWithState.actionExecutionId,
               actionName: eventWithState.action.name,
@@ -4569,8 +4802,7 @@ async function executeAction(eventStream$, guardrailsResult$, action, actionArgu
     from2(stream).subscribe({
       next: (event) => eventStream$.next(event),
       error: (err) => {
-        console.error("Error in stream", err);
-        const structuredError = convertStreamingErrorToStructured2(err);
+        const structuredError = ensureStructuredError3(err, convertStreamingErrorToStructured2);
         eventStream$.sendActionExecutionResult({
           actionExecutionId,
           actionName: action.name,
@@ -4610,36 +4842,19 @@ 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({
+  var _a, _b, _c, _d, _e, _f, _g;
+  let helpfulMessage = generateHelpfulErrorMessage(error, "event streaming connection");
+  if (((_a = error == null ? void 0 : error.message) == null ? void 0 : _a.includes("fetch failed")) || ((_b = error == null ? void 0 : error.message) == null ? void 0 : _b.includes("ECONNREFUSED")) || ((_c = error == null ? void 0 : error.message) == null ? void 0 : _c.includes("ENOTFOUND")) || ((_d = error == null ? void 0 : error.message) == null ? void 0 : _d.includes("ETIMEDOUT")) || ((_e = error == null ? void 0 : error.message) == null ? void 0 : _e.includes("terminated")) || ((_f = error == null ? void 0 : error.cause) == null ? void 0 : _f.code) === "UND_ERR_SOCKET" || ((_g = error == null ? void 0 : error.message) == null ? void 0 : _g.includes("other side closed")) || (error == null ? void 0 : error.code) === "UND_ERR_SOCKET") {
+    return new CopilotKitLowLevelError7({
       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
+      message: helpfulMessage
     });
   }
   return new CopilotKitError6({
-    message: `Event streaming error: ${errorMessage}`,
-    code: CopilotKitErrorCode4.UNKNOWN
+    message: helpfulMessage,
+    code: CopilotKitErrorCode4.UNKNOWN,
+    severity: Severity.CRITICAL
   });
 }
 __name(convertStreamingErrorToStructured2, "convertStreamingErrorToStructured");
@@ -4648,7 +4863,7 @@ __name(convertStreamingErrorToStructured2, "convertStreamingErrorToStructured");
 import { GraphQLJSONObject } from "graphql-scalars";
 import { plainToInstance as plainToInstance3 } from "class-transformer";
 import { GraphQLError } from "graphql";
-import { randomId as randomId4 } from "@copilotkit/shared";
+import { randomId as randomId3 } from "@copilotkit/shared";
 
 // src/graphql/types/agents-response.type.ts
 import { Field as Field16, ObjectType as ObjectType5 } from "type-graphql";
@@ -4704,7 +4919,7 @@ AgentsResponse = _ts_decorate16([
 ], AgentsResponse);
 
 // src/graphql/resolvers/copilot.resolver.ts
-import { CopilotKitError as CopilotKitError7 } from "@copilotkit/shared";
+import { CopilotKitError as CopilotKitError7, CopilotKitLowLevelError as CopilotKitLowLevelError8, isStructuredCopilotKitError as isStructuredCopilotKitError2 } 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")
@@ -4774,7 +4989,7 @@ var CopilotResolver = class {
     };
   }
   async generateCopilotResponse(ctx, data, properties) {
-    var _a, _b, _c, _d, _e;
+    var _a, _b, _c, _d, _e, _f, _g;
     telemetry_client_default.capture("oss.runtime.copilot_request_created", {
       "cloud.guardrails.enabled": ((_a = data.cloud) == null ? void 0 : _a.guardrails) !== void 0,
       requestType: data.metadata.requestType,
@@ -4853,26 +5068,41 @@ var CopilotResolver = class {
       ctx.properties["copilotCloudPublicApiKey"] = copilotCloudPublicApiKey;
     }
     logger2.debug("Processing");
-    const { eventSource, threadId = randomId4(), runId, serverSideActions, actionInputsWithoutAgents, extensions } = await copilotRuntime.processRuntimeRequest({
-      serviceAdapter,
-      messages: data.messages,
-      actions: data.frontend.actions.filter((action) => action.available !== ActionInputAvailability.disabled),
-      threadId: data.threadId,
-      runId: data.runId,
-      publicApiKey: copilotCloudPublicApiKey,
-      outputMessagesPromise,
-      graphqlContext: ctx,
-      forwardedParameters: data.forwardedParameters,
-      agentSession: data.agentSession,
-      agentStates: data.agentStates,
-      url: data.frontend.url,
-      extensions: data.extensions,
-      metaEvents: data.metaEvents
-    });
+    let runtimeResponse;
+    try {
+      runtimeResponse = await copilotRuntime.processRuntimeRequest({
+        serviceAdapter,
+        messages: data.messages,
+        actions: data.frontend.actions.filter((action) => action.available !== ActionInputAvailability.disabled),
+        threadId: data.threadId,
+        runId: data.runId,
+        publicApiKey: copilotCloudPublicApiKey,
+        outputMessagesPromise,
+        graphqlContext: ctx,
+        forwardedParameters: data.forwardedParameters,
+        agentSession: data.agentSession,
+        agentStates: data.agentStates,
+        url: data.frontend.url,
+        extensions: data.extensions,
+        metaEvents: data.metaEvents
+      });
+    } catch (error) {
+      if (isStructuredCopilotKitError2(error) || ((_e = error == null ? void 0 : error.extensions) == null ? void 0 : _e.visibility)) {
+        throw new GraphQLError(error.message || "Agent error occurred", {
+          extensions: {
+            ...error.extensions,
+            code: error.code || ((_f = error.extensions) == null ? void 0 : _f.code) || "AGENT_ERROR",
+            originalError: error
+          }
+        });
+      }
+      throw error;
+    }
+    const { eventSource, threadId = randomId3(), runId, serverSideActions, actionInputsWithoutAgents, extensions } = runtimeResponse;
     logger2.debug("Event source created, creating response");
     const eventStream = eventSource.processRuntimeEvents({
       serverSideActions,
-      guardrailsResult$: ((_e = data.cloud) == null ? void 0 : _e.guardrails) ? guardrailsResult$ : null,
+      guardrailsResult$: ((_g = data.cloud) == null ? void 0 : _g.guardrails) ? guardrailsResult$ : null,
       actionInputsWithoutAgents: actionInputsWithoutAgents.filter(
         // TODO-AGENTS: do not exclude ALL server side actions
         (action) => !serverSideActions.find((serverSideAction) => serverSideAction.name == action.name)
@@ -4953,12 +5183,16 @@ var CopilotResolver = class {
             }
           },
           error: (err) => {
-            logger2.error({
-              err
-            }, "Error in meta events stream");
-            responseStatus$.next(new UnknownErrorResponse({
-              description: `An unknown error has occurred in the event stream`
-            }));
+            var _a2, _b2;
+            if (((_a2 = err == null ? void 0 : err.name) == null ? void 0 : _a2.includes("CopilotKit")) || ((_b2 = err == null ? void 0 : err.extensions) == null ? void 0 : _b2.visibility)) {
+              responseStatus$.next(new UnknownErrorResponse({
+                description: err.message || "Agent error occurred"
+              }));
+            } else {
+              responseStatus$.next(new UnknownErrorResponse({
+                description: `An unknown error has occurred in the event stream`
+              }));
+            }
             eventStreamSubscription == null ? void 0 : eventStreamSubscription.unsubscribe();
             stop();
           },
@@ -4996,7 +5230,7 @@ var CopilotResolver = class {
                 });
                 outputMessages = [
                   plainToInstance3(TextMessage, {
-                    id: randomId4(),
+                    id: randomId3(),
                     createdAt: /* @__PURE__ */ new Date(),
                     content: result.reason,
                     role: MessageRole.assistant
@@ -5174,7 +5408,7 @@ var CopilotResolver = class {
                   event
                 }, "Agent message event received");
                 pushMessage({
-                  id: randomId4(),
+                  id: randomId3(),
                   status: new SuccessMessageStatus(),
                   threadId: event.threadId,
                   agentName: event.agentName,
@@ -5187,7 +5421,7 @@ var CopilotResolver = class {
                   createdAt: /* @__PURE__ */ new Date()
                 });
                 outputMessages.push(plainToInstance3(AgentStateMessage, {
-                  id: randomId4(),
+                  id: randomId3(),
                   threadId: event.threadId,
                   agentName: event.agentName,
                   nodeName: event.nodeName,
@@ -5202,13 +5436,23 @@ var CopilotResolver = class {
             }
           },
           error: (err) => {
-            logger2.error({
-              err
-            }, "Error in event stream");
-            if (err instanceof CopilotKitError7 || err instanceof Error && err.name && err.name.includes("CopilotKit")) {
+            var _a3, _b2, _c2, _d2, _e2, _f2;
+            if (err instanceof CopilotKitError7 || err instanceof CopilotKitLowLevelError8 || err instanceof Error && err.name && err.name.includes("CopilotKit") || ((_a3 = err == null ? void 0 : err.extensions) == null ? void 0 : _a3.visibility)) {
+              responseStatus$.next(new UnknownErrorResponse({
+                description: err.message || "Agent error occurred",
+                // Include original error information for frontend to extract
+                originalError: {
+                  code: err.code || ((_b2 = err.extensions) == null ? void 0 : _b2.code),
+                  statusCode: err.statusCode || ((_c2 = err.extensions) == null ? void 0 : _c2.statusCode),
+                  severity: err.severity || ((_d2 = err.extensions) == null ? void 0 : _d2.severity),
+                  visibility: err.visibility || ((_e2 = err.extensions) == null ? void 0 : _e2.visibility),
+                  originalErrorType: err.originalErrorType || ((_f2 = err.extensions) == null ? void 0 : _f2.originalErrorType),
+                  extensions: err.extensions
+                }
+              }));
               eventStreamSubscription == null ? void 0 : eventStreamSubscription.unsubscribe();
               rejectOutputMessagesPromise(err);
-              stopStreamingMessages(err);
+              stopStreamingMessages();
               return;
             }
             responseStatus$.next(new UnknownErrorResponse({
@@ -5446,6 +5690,7 @@ StateResolver = _ts_decorate20([
 
 // src/lib/integrations/shared.ts
 var packageJson2 = __toESM(require_package());
+import { CopilotKitError as CopilotKitError8, CopilotKitErrorCode as CopilotKitErrorCode5 } from "@copilotkit/shared";
 var logger = createLogger();
 var addCustomHeaderPlugin = {
   onResponse({ response }) {
@@ -5510,6 +5755,13 @@ function getCommonConfig(options) {
       serviceAdapter: options.serviceAdapter.constructor.name
     }
   });
+  const userErrorCodes = [
+    CopilotKitErrorCode5.AGENT_NOT_FOUND,
+    CopilotKitErrorCode5.API_NOT_FOUND,
+    CopilotKitErrorCode5.REMOTE_ENDPOINT_NOT_FOUND,
+    CopilotKitErrorCode5.CONFIGURATION_ERROR,
+    CopilotKitErrorCode5.MISSING_PUBLIC_API_KEY_ERROR
+  ];
   return {
     logging: createLogger({
       component: "Yoga GraphQL",
@@ -5520,7 +5772,25 @@ function getCommonConfig(options) {
       useDeferStream(),
       addCustomHeaderPlugin
     ],
-    context: (ctx) => createContext(ctx, options, contextLogger, options.properties)
+    context: (ctx) => createContext(ctx, options, contextLogger, options.properties),
+    // Suppress logging for user configuration errors
+    maskedErrors: {
+      maskError: (error, message, isDev) => {
+        const originalError = error.originalError || error;
+        const extensions = error.extensions;
+        const errorCode = extensions == null ? void 0 : extensions.code;
+        if (errorCode && userErrorCodes.includes(errorCode)) {
+          console.debug("User configuration error:", error.message);
+          return error;
+        }
+        if (originalError instanceof CopilotKitError8 && userErrorCodes.includes(originalError.code)) {
+          console.debug("User configuration error:", error.message);
+          return error;
+        }
+        console.error("Application error:", error);
+        return error;
+      }
+    }
   };
 }
 __name(getCommonConfig, "getCommonConfig");
@@ -5569,4 +5839,4 @@ export {
   getCommonConfig,
   copilotRuntimeNodeHttpEndpoint
 };
-//# sourceMappingURL=chunk-WIXS6EG7.mjs.map
+//# sourceMappingURL=chunk-Z5GYTKMD.mjs.map