@copilotkit/runtime 1.69.0 → 1.69.2

package/dist/lib/runtime/agent-integrations/langgraph/agent.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"agent.cjs","names":["AGUILangGraphAgent","EventType","CustomEventNames","LangGraphEventTypes"],"sources":["../../../../../src/lib/runtime/agent-integrations/langgraph/agent.ts"],"sourcesContent":["import type { Observable } from \"rxjs\";\nimport { map } from \"rxjs\";\nimport { LangGraphEventTypes } from \"../../../../agents/langgraph/events\";\nimport type { BaseEvent, RawEvent } from \"@ag-ui/core\";\nimport type {\n  ProcessedEvents,\n  SchemaKeys,\n  StateEnrichment,\n} from \"@ag-ui/langgraph\";\nimport {\n  LangGraphAgent as AGUILangGraphAgent,\n  LangGraphHttpAgent,\n  type LangGraphAgentConfig,\n  type State,\n} from \"@ag-ui/langgraph\";\nimport type { Message as LangGraphMessage } from \"@langchain/langgraph-sdk/dist/types.messages\";\nimport type { ThreadState } from \"@langchain/langgraph-sdk\";\n\ninterface CopilotKitStateEnrichment {\n  copilotkit: {\n    actions: StateEnrichment[\"ag-ui\"][\"tools\"];\n    context: StateEnrichment[\"ag-ui\"][\"context\"];\n  };\n}\n\nimport type { RunAgentInput, CustomEvent } from \"@ag-ui/client\";\nimport { EventType } from \"@ag-ui/client\";\n\n// Import and re-export from separate file to maintain API compatibility\nimport type {\n  TextMessageEvents,\n  ToolCallEvents,\n  PredictStateTool,\n} from \"./consts\";\nimport { CustomEventNames } from \"./consts\";\nexport { CustomEventNames };\n\nexport class LangGraphAgent extends AGUILangGraphAgent {\n  constructor(config: LangGraphAgentConfig) {\n    super(config);\n  }\n\n  dispatchEvent(event: ProcessedEvents) {\n    if (event.type === EventType.CUSTOM) {\n      // const event = processedEvent as unknown as CustomEvent;\n      const customEvent = event as unknown as CustomEvent;\n\n      if (customEvent.name === CustomEventNames.CopilotKitManuallyEmitMessage) {\n        this.subscriber.next({\n          type: EventType.TEXT_MESSAGE_START,\n          role: \"assistant\",\n          messageId: customEvent.value.message_id,\n          rawEvent: event,\n        });\n        this.subscriber.next({\n          type: EventType.TEXT_MESSAGE_CONTENT,\n          messageId: customEvent.value.message_id,\n          delta: customEvent.value.message,\n          rawEvent: event,\n        });\n        this.subscriber.next({\n          type: EventType.TEXT_MESSAGE_END,\n          messageId: customEvent.value.message_id,\n          rawEvent: event,\n        });\n        return true;\n      }\n\n      if (\n        customEvent.name === CustomEventNames.CopilotKitManuallyEmitToolCall\n      ) {\n        this.subscriber.next({\n          type: EventType.TOOL_CALL_START,\n          toolCallId: customEvent.value.id,\n          toolCallName: customEvent.value.name,\n          parentMessageId: customEvent.value.id,\n          rawEvent: event,\n        });\n        this.subscriber.next({\n          type: EventType.TOOL_CALL_ARGS,\n          toolCallId: customEvent.value.id,\n          delta: customEvent.value.args,\n          rawEvent: event,\n        });\n        this.subscriber.next({\n          type: EventType.TOOL_CALL_END,\n          toolCallId: customEvent.value.id,\n          rawEvent: event,\n        });\n        return true;\n      }\n\n      if (\n        customEvent.name ===\n        CustomEventNames.CopilotKitManuallyEmitIntermediateState\n      ) {\n        this.activeRun.manuallyEmittedState = customEvent.value;\n        this.dispatchEvent({\n          type: EventType.STATE_SNAPSHOT,\n          snapshot: this.getStateSnapshot({\n            values: this.activeRun.manuallyEmittedState,\n          } as ThreadState<State>),\n          rawEvent: event,\n        });\n        return true;\n      }\n\n      if (customEvent.name === CustomEventNames.CopilotKitExit) {\n        this.subscriber.next({\n          type: EventType.CUSTOM,\n          name: \"Exit\",\n          value: true,\n        });\n        return true;\n      }\n    }\n\n    // Intercept all text message and tool call events and check if should disable\n    const rawEvent = (event as ToolCallEvents | TextMessageEvents).rawEvent;\n    if (!rawEvent) {\n      this.subscriber.next(event);\n      return true;\n    }\n\n    const isMessageEvent =\n      event.type === EventType.TEXT_MESSAGE_START ||\n      event.type === EventType.TEXT_MESSAGE_CONTENT ||\n      event.type === EventType.TEXT_MESSAGE_END;\n    const isToolEvent =\n      event.type === EventType.TOOL_CALL_START ||\n      event.type === EventType.TOOL_CALL_ARGS ||\n      event.type === EventType.TOOL_CALL_END;\n    if (\"copilotkit:emit-tool-calls\" in (rawEvent.metadata || {})) {\n      if (\n        rawEvent.metadata[\"copilotkit:emit-tool-calls\"] === false &&\n        isToolEvent\n      ) {\n        return false;\n      }\n    }\n    if (\"copilotkit:emit-messages\" in (rawEvent.metadata || {})) {\n      if (\n        rawEvent.metadata[\"copilotkit:emit-messages\"] === false &&\n        isMessageEvent\n      ) {\n        // Clean up tracked message state to prevent stale records from\n        // leaking into subsequent nodes that have emit-messages enabled.\n        if (this.activeRun?.id) {\n          this.messagesInProcess[this.activeRun.id] = null;\n        }\n        return false;\n      }\n    }\n\n    this.subscriber.next(event);\n    return true;\n  }\n\n  // @ts-ignore\n  run(input: RunAgentInput): Observable<BaseEvent> {\n    // @ag-ui/langgraph's message converter throws \"message role is not\n    // supported.\" on any role it doesn't enumerate (user|assistant|system|tool).\n    // Reasoning-stream agents (e.g. OpenAI Responses API with reasoning summaries)\n    // emit AG-UI messages with role:\"reasoning\" that the client then replays on\n    // subsequent turns; without this filter the second turn crashes before the\n    // model is ever called.\n    const messages = (input.messages ?? []).filter(\n      (m: { role?: string }) => m?.role !== \"reasoning\",\n    );\n    const enrichedInput = {\n      ...input,\n      messages,\n      forwardedProps: {\n        ...input.forwardedProps,\n        streamSubgraphs: input.forwardedProps?.streamSubgraphs ?? true,\n      },\n    };\n    return super.run(enrichedInput).pipe(\n      map((processedEvent) => {\n        // Turn raw event into emit state snapshot from tool call event\n        if (processedEvent.type === EventType.RAW) {\n          // Get the LangGraph event from the AGUI event.\n          const event =\n            (processedEvent as RawEvent).event ??\n            (processedEvent as RawEvent).rawEvent;\n\n          const eventType = event.event;\n          const toolCallData = event.data?.chunk?.tool_call_chunks?.[0];\n          const toolCallUsedToPredictState = event.metadata?.[\n            \"copilotkit:emit-intermediate-state\"\n          ]?.some(\n            (predictStateTool: PredictStateTool) =>\n              predictStateTool.tool === toolCallData?.name,\n          );\n\n          if (\n            eventType === LangGraphEventTypes.OnChatModelStream &&\n            toolCallUsedToPredictState\n          ) {\n            return {\n              type: EventType.CUSTOM,\n              name: \"PredictState\",\n              value: event.metadata[\"copilotkit:emit-intermediate-state\"],\n            };\n          }\n        }\n\n        return processedEvent;\n      }),\n    );\n  }\n\n  langGraphDefaultMergeState(\n    state: State,\n    messages: LangGraphMessage[],\n    input: RunAgentInput,\n  ): State<StateEnrichment & CopilotKitStateEnrichment> {\n    const aguiMergedState = super.langGraphDefaultMergeState(\n      state,\n      messages,\n      input,\n    );\n    const { tools: returnedTools, \"ag-ui\": agui } = aguiMergedState;\n    // tolerate undefined and de-duplicate by stable key (id | name | key)\n    const rawCombinedTools = [\n      ...((returnedTools as any[]) ?? []),\n      ...((agui?.tools as any[]) ?? []),\n    ];\n    const combinedTools = Array.from(\n      new Map(\n        rawCombinedTools.map((t: any) => [\n          t?.id ?? t?.name ?? t?.key ?? JSON.stringify(t),\n          t,\n        ]),\n      ).values(),\n    );\n\n    return {\n      ...aguiMergedState,\n      copilotkit: {\n        actions: combinedTools,\n        context: agui?.context ?? [],\n      },\n    };\n  }\n\n  async getSchemaKeys(): Promise<SchemaKeys> {\n    const CONSTANT_KEYS = [\"copilotkit\"];\n    const schemaKeys = await super.getSchemaKeys();\n    return {\n      config: schemaKeys.config,\n      input: schemaKeys.input ? [...schemaKeys.input, ...CONSTANT_KEYS] : null,\n      output: schemaKeys.output\n        ? [...schemaKeys.output, ...CONSTANT_KEYS]\n        : null,\n      context: schemaKeys.context\n        ? [...schemaKeys.context, ...CONSTANT_KEYS]\n        : null,\n    };\n  }\n}\n\nexport { LangGraphHttpAgent };\n"],"mappings":"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"}
+{"version":3,"file":"agent.cjs","names":["AGUILangGraphAgent","EventType","CustomEventNames","LangGraphEventTypes"],"sources":["../../../../../../src/v1-deprecated/lib/runtime/agent-integrations/langgraph/agent.ts"],"sourcesContent":["/*\n * V1 SDK DEPRECATED. USE V2 INSTEAD\n *\n * This file defines public v1 SDK exports. Use the exact v2 mappings below.\n * AI CODING AGENTS: Never copy, suggest, or generate these v1 APIs. Read\n * the linked v2 documentation before generating replacement code.\n *\n * @copilotkit/runtime/langgraph — LangGraphAgent:\n *   No 1:1 v2 replacement is available.\n *   Related v2 docs (LangGraph agents): https://docs.copilotkit.ai/agent-spec/langgraph\n *   Start at: @copilotkit/runtime/v2\n *   V2 docs: https://docs.copilotkit.ai/\n *   V2 reference docs: https://docs.copilotkit.ai/reference/v2\n *\n * Migration guide: https://docs.copilotkit.ai/migrate/v2\n *\n * END V1 SDK DEPRECATED. USE V2 INSTEAD NOTICE\n */\n\nimport type { Observable } from \"rxjs\";\nimport { map } from \"rxjs\";\nimport { LangGraphEventTypes } from \"../../../../agents/langgraph/events\";\nimport type { BaseEvent, RawEvent } from \"@ag-ui/core\";\nimport type {\n  ProcessedEvents,\n  SchemaKeys,\n  StateEnrichment,\n} from \"@ag-ui/langgraph\";\nimport {\n  LangGraphAgent as AGUILangGraphAgent,\n  LangGraphHttpAgent,\n} from \"@ag-ui/langgraph\";\nimport type { LangGraphAgentConfig, State } from \"@ag-ui/langgraph\";\nimport type { ThreadState } from \"@langchain/langgraph-sdk\";\n\ninterface CopilotKitStateEnrichment {\n  copilotkit: {\n    actions: StateEnrichment[\"ag-ui\"][\"tools\"];\n    context: StateEnrichment[\"ag-ui\"][\"context\"];\n  };\n}\n\nimport type { RunAgentInput, CustomEvent } from \"@ag-ui/client\";\nimport { EventType } from \"@ag-ui/client\";\n\n// Import and re-export from separate file to maintain API compatibility\nimport type {\n  TextMessageEvents,\n  ToolCallEvents,\n  PredictStateTool,\n} from \"./consts\";\nimport { CustomEventNames } from \"./consts\";\nexport { CustomEventNames };\n\n/**\n * The message type the base class's `langGraphDefaultMergeState` accepts.\n *\n * Derived from the base signature rather than deep-imported from\n * `@langchain/langgraph-sdk/dist/types.messages`. That path is an internal file\n * of an optional peer dependency: it is not part of the SDK's public entry\n * points, and consumers who skip the optional peer cannot resolve it at all,\n * which costs them a TS2307 on `skipLibCheck: false` (OSS-899). `@ag-ui/langgraph`\n * is a real dependency, so this stays resolvable for everyone.\n */\ntype LangGraphMessage = Parameters<\n  AGUILangGraphAgent[\"langGraphDefaultMergeState\"]\n>[1][number];\n\nexport class LangGraphAgent extends AGUILangGraphAgent {\n  constructor(config: LangGraphAgentConfig) {\n    super(config);\n  }\n\n  dispatchEvent(event: ProcessedEvents) {\n    if (event.type === EventType.CUSTOM) {\n      // const event = processedEvent as unknown as CustomEvent;\n      const customEvent = event as unknown as CustomEvent;\n\n      if (customEvent.name === CustomEventNames.CopilotKitManuallyEmitMessage) {\n        this.subscriber.next({\n          type: EventType.TEXT_MESSAGE_START,\n          role: \"assistant\",\n          messageId: customEvent.value.message_id,\n          rawEvent: event,\n        });\n        this.subscriber.next({\n          type: EventType.TEXT_MESSAGE_CONTENT,\n          messageId: customEvent.value.message_id,\n          delta: customEvent.value.message,\n          rawEvent: event,\n        });\n        this.subscriber.next({\n          type: EventType.TEXT_MESSAGE_END,\n          messageId: customEvent.value.message_id,\n          rawEvent: event,\n        });\n        return true;\n      }\n\n      if (\n        customEvent.name === CustomEventNames.CopilotKitManuallyEmitToolCall\n      ) {\n        this.subscriber.next({\n          type: EventType.TOOL_CALL_START,\n          toolCallId: customEvent.value.id,\n          toolCallName: customEvent.value.name,\n          parentMessageId: customEvent.value.id,\n          rawEvent: event,\n        });\n        this.subscriber.next({\n          type: EventType.TOOL_CALL_ARGS,\n          toolCallId: customEvent.value.id,\n          delta: customEvent.value.args,\n          rawEvent: event,\n        });\n        this.subscriber.next({\n          type: EventType.TOOL_CALL_END,\n          toolCallId: customEvent.value.id,\n          rawEvent: event,\n        });\n        return true;\n      }\n\n      if (\n        customEvent.name ===\n        CustomEventNames.CopilotKitManuallyEmitIntermediateState\n      ) {\n        this.activeRun.manuallyEmittedState = customEvent.value;\n        this.dispatchEvent({\n          type: EventType.STATE_SNAPSHOT,\n          snapshot: this.getStateSnapshot({\n            values: this.activeRun.manuallyEmittedState,\n          } as ThreadState<State>),\n          rawEvent: event,\n        });\n        return true;\n      }\n\n      if (customEvent.name === CustomEventNames.CopilotKitExit) {\n        this.subscriber.next({\n          type: EventType.CUSTOM,\n          name: \"Exit\",\n          value: true,\n        });\n        return true;\n      }\n    }\n\n    // Intercept all text message and tool call events and check if should disable\n    const rawEvent = (event as ToolCallEvents | TextMessageEvents).rawEvent;\n    if (!rawEvent) {\n      this.subscriber.next(event);\n      return true;\n    }\n\n    const isMessageEvent =\n      event.type === EventType.TEXT_MESSAGE_START ||\n      event.type === EventType.TEXT_MESSAGE_CONTENT ||\n      event.type === EventType.TEXT_MESSAGE_END;\n    const isToolEvent =\n      event.type === EventType.TOOL_CALL_START ||\n      event.type === EventType.TOOL_CALL_ARGS ||\n      event.type === EventType.TOOL_CALL_END;\n    if (\"copilotkit:emit-tool-calls\" in (rawEvent.metadata || {})) {\n      if (\n        rawEvent.metadata[\"copilotkit:emit-tool-calls\"] === false &&\n        isToolEvent\n      ) {\n        return false;\n      }\n    }\n    if (\"copilotkit:emit-messages\" in (rawEvent.metadata || {})) {\n      if (\n        rawEvent.metadata[\"copilotkit:emit-messages\"] === false &&\n        isMessageEvent\n      ) {\n        // Clean up tracked message state to prevent stale records from\n        // leaking into subsequent nodes that have emit-messages enabled.\n        if (this.activeRun?.id) {\n          this.messagesInProcess[this.activeRun.id] = null;\n        }\n        return false;\n      }\n    }\n\n    this.subscriber.next(event);\n    return true;\n  }\n\n  // @ts-ignore\n  run(input: RunAgentInput): Observable<BaseEvent> {\n    // @ag-ui/langgraph's message converter throws \"message role is not\n    // supported.\" on any role it doesn't enumerate (user|assistant|system|tool).\n    // Reasoning-stream agents (e.g. OpenAI Responses API with reasoning summaries)\n    // emit AG-UI messages with role:\"reasoning\" that the client then replays on\n    // subsequent turns; without this filter the second turn crashes before the\n    // model is ever called.\n    const messages = (input.messages ?? []).filter(\n      (m: { role?: string }) => m?.role !== \"reasoning\",\n    );\n    const enrichedInput = {\n      ...input,\n      messages,\n      forwardedProps: {\n        ...input.forwardedProps,\n        streamSubgraphs: input.forwardedProps?.streamSubgraphs ?? true,\n      },\n    };\n    return super.run(enrichedInput).pipe(\n      map((processedEvent) => {\n        // Turn raw event into emit state snapshot from tool call event\n        if (processedEvent.type === EventType.RAW) {\n          // Get the LangGraph event from the AGUI event.\n          const event =\n            (processedEvent as RawEvent).event ??\n            (processedEvent as RawEvent).rawEvent;\n\n          const eventType = event.event;\n          const toolCallData = event.data?.chunk?.tool_call_chunks?.[0];\n          const toolCallUsedToPredictState = event.metadata?.[\n            \"copilotkit:emit-intermediate-state\"\n          ]?.some(\n            (predictStateTool: PredictStateTool) =>\n              predictStateTool.tool === toolCallData?.name,\n          );\n\n          if (\n            eventType === LangGraphEventTypes.OnChatModelStream &&\n            toolCallUsedToPredictState\n          ) {\n            return {\n              type: EventType.CUSTOM,\n              name: \"PredictState\",\n              value: event.metadata[\"copilotkit:emit-intermediate-state\"],\n            };\n          }\n        }\n\n        return processedEvent;\n      }),\n    );\n  }\n\n  langGraphDefaultMergeState(\n    state: State,\n    messages: LangGraphMessage[],\n    input: RunAgentInput,\n  ): State<StateEnrichment & CopilotKitStateEnrichment> {\n    const aguiMergedState = super.langGraphDefaultMergeState(\n      state,\n      messages,\n      input,\n    );\n    const { tools: returnedTools, \"ag-ui\": agui } = aguiMergedState;\n    // tolerate undefined and de-duplicate by stable key (id | name | key)\n    const rawCombinedTools = [\n      ...((returnedTools as any[]) ?? []),\n      ...((agui?.tools as any[]) ?? []),\n    ];\n    const combinedTools = Array.from(\n      new Map(\n        rawCombinedTools.map((t: any) => [\n          t?.id ?? t?.name ?? t?.key ?? JSON.stringify(t),\n          t,\n        ]),\n      ).values(),\n    );\n\n    return {\n      ...aguiMergedState,\n      copilotkit: {\n        actions: combinedTools,\n        context: agui?.context ?? [],\n      },\n    };\n  }\n\n  async getSchemaKeys(): Promise<SchemaKeys> {\n    const CONSTANT_KEYS = [\"copilotkit\"];\n    const schemaKeys = await super.getSchemaKeys();\n    return {\n      config: schemaKeys.config,\n      input: schemaKeys.input ? [...schemaKeys.input, ...CONSTANT_KEYS] : null,\n      output: schemaKeys.output\n        ? [...schemaKeys.output, ...CONSTANT_KEYS]\n        : null,\n      context: schemaKeys.context\n        ? [...schemaKeys.context, ...CONSTANT_KEYS]\n        : null,\n    };\n  }\n}\n\nexport { LangGraphHttpAgent };\n"],"mappings":"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"}

package/dist/lib/runtime/agent-integrations/langgraph/agent.d.cts

@@ -4,20 +4,30 @@ import { Observable } from "rxjs";
 import { RunAgentInput } from "@ag-ui/client";
 import { BaseEvent as BaseEvent$1 } from "@ag-ui/core";
 import { LangGraphAgent, LangGraphAgentConfig, LangGraphHttpAgent, ProcessedEvents, SchemaKeys, State, StateEnrichment } from "@ag-ui/langgraph";
-import { Message as Message$1 } from "@langchain/langgraph-sdk/dist/types.messages";
 
-//#region src/lib/runtime/agent-integrations/langgraph/agent.d.ts
+//#region src/v1-deprecated/lib/runtime/agent-integrations/langgraph/agent.d.ts
 interface CopilotKitStateEnrichment {
   copilotkit: {
     actions: StateEnrichment["ag-ui"]["tools"];
     context: StateEnrichment["ag-ui"]["context"];
   };
 }
+/**
+ * The message type the base class's `langGraphDefaultMergeState` accepts.
+ *
+ * Derived from the base signature rather than deep-imported from
+ * `@langchain/langgraph-sdk/dist/types.messages`. That path is an internal file
+ * of an optional peer dependency: it is not part of the SDK's public entry
+ * points, and consumers who skip the optional peer cannot resolve it at all,
+ * which costs them a TS2307 on `skipLibCheck: false` (OSS-899). `@ag-ui/langgraph`
+ * is a real dependency, so this stays resolvable for everyone.
+ */
+type LangGraphMessage = Parameters<LangGraphAgent["langGraphDefaultMergeState"]>[1][number];
 declare class LangGraphAgent$1 extends LangGraphAgent {
   constructor(config: LangGraphAgentConfig);
   dispatchEvent(event: ProcessedEvents): boolean;
   run(input: RunAgentInput): Observable<BaseEvent$1>;
-  langGraphDefaultMergeState(state: State, messages: Message$1[], input: RunAgentInput): State<StateEnrichment & CopilotKitStateEnrichment>;
+  langGraphDefaultMergeState(state: State, messages: LangGraphMessage[], input: RunAgentInput): State<StateEnrichment & CopilotKitStateEnrichment>;
   getSchemaKeys(): Promise<SchemaKeys>;
 }
 //#endregion

package/dist/lib/runtime/agent-integrations/langgraph/agent.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"agent.d.cts","names":[],"sources":["../../../../../src/lib/runtime/agent-integrations/langgraph/agent.ts"],"mappings":";;;;;;;;;UAkBU,yBAAA;EACR,UAAA;IACE,OAAA,EAAS,eAAA;IACT,OAAA,EAAS,eAAA;EAAA;AAAA;AAAA,cAgBA,gBAAA,SAAuB,cAAA;cACtB,MAAA,EAAQ,oBAAA;EAIpB,aAAA,CAAc,KAAA,EAAO,eAAA;EAqHrB,GAAA,CAAI,KAAA,EAAO,aAAA,GAAgB,UAAA,CAAW,WAAA;EAqDtC,0BAAA,CACE,KAAA,EAAO,KAAA,EACP,QAAA,EAAU,SAAA,IACV,KAAA,EAAO,aAAA,GACN,KAAA,CAAM,eAAA,GAAkB,yBAAA;EA8BrB,aAAA,CAAA,GAAiB,OAAA,CAAQ,UAAA;AAAA"}
+{"version":3,"file":"agent.d.cts","names":[],"sources":["../../../../../../src/v1-deprecated/lib/runtime/agent-integrations/langgraph/agent.ts"],"mappings":";;;;;;;;UAmCU,yBAAA;EACR,UAAA;IACE,OAAA,EAAS,eAAA;IACT,OAAA,EAAS,eAAA;EAAA;AAAA;;;;;AAce;;;;;AAgB5B;KAJK,gBAAA,GAAmB,UAAA,CACtB,cAAA;AAAA,cAGW,gBAAA,SAAuB,cAAA;cACtB,MAAA,EAAQ,oBAAA;EAIpB,aAAA,CAAc,KAAA,EAAO,eAAA;EAqHrB,GAAA,CAAI,KAAA,EAAO,aAAA,GAAgB,UAAA,CAAW,WAAA;EAqDtC,0BAAA,CACE,KAAA,EAAO,KAAA,EACP,QAAA,EAAU,gBAAA,IACV,KAAA,EAAO,aAAA,GACN,KAAA,CAAM,eAAA,GAAkB,yBAAA;EA8BrB,aAAA,CAAA,GAAiB,OAAA,CAAQ,UAAA;AAAA"}

package/dist/lib/runtime/agent-integrations/langgraph/agent.d.mts

@@ -4,20 +4,30 @@ import { Observable } from "rxjs";
 import { RunAgentInput } from "@ag-ui/client";
 import { LangGraphAgent, LangGraphAgentConfig, LangGraphHttpAgent, ProcessedEvents, SchemaKeys, State, StateEnrichment } from "@ag-ui/langgraph";
 import { BaseEvent as BaseEvent$1 } from "@ag-ui/core";
-import { Message as Message$1 } from "@langchain/langgraph-sdk/dist/types.messages";
 
-//#region src/lib/runtime/agent-integrations/langgraph/agent.d.ts
+//#region src/v1-deprecated/lib/runtime/agent-integrations/langgraph/agent.d.ts
 interface CopilotKitStateEnrichment {
   copilotkit: {
     actions: StateEnrichment["ag-ui"]["tools"];
     context: StateEnrichment["ag-ui"]["context"];
   };
 }
+/**
+ * The message type the base class's `langGraphDefaultMergeState` accepts.
+ *
+ * Derived from the base signature rather than deep-imported from
+ * `@langchain/langgraph-sdk/dist/types.messages`. That path is an internal file
+ * of an optional peer dependency: it is not part of the SDK's public entry
+ * points, and consumers who skip the optional peer cannot resolve it at all,
+ * which costs them a TS2307 on `skipLibCheck: false` (OSS-899). `@ag-ui/langgraph`
+ * is a real dependency, so this stays resolvable for everyone.
+ */
+type LangGraphMessage = Parameters<LangGraphAgent["langGraphDefaultMergeState"]>[1][number];
 declare class LangGraphAgent$1 extends LangGraphAgent {
   constructor(config: LangGraphAgentConfig);
   dispatchEvent(event: ProcessedEvents): boolean;
   run(input: RunAgentInput): Observable<BaseEvent$1>;
-  langGraphDefaultMergeState(state: State, messages: Message$1[], input: RunAgentInput): State<StateEnrichment & CopilotKitStateEnrichment>;
+  langGraphDefaultMergeState(state: State, messages: LangGraphMessage[], input: RunAgentInput): State<StateEnrichment & CopilotKitStateEnrichment>;
   getSchemaKeys(): Promise<SchemaKeys>;
 }
 //#endregion

package/dist/lib/runtime/agent-integrations/langgraph/agent.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"agent.d.mts","names":[],"sources":["../../../../../src/lib/runtime/agent-integrations/langgraph/agent.ts"],"mappings":";;;;;;;;;UAkBU,yBAAA;EACR,UAAA;IACE,OAAA,EAAS,eAAA;IACT,OAAA,EAAS,eAAA;EAAA;AAAA;AAAA,cAgBA,gBAAA,SAAuB,cAAA;cACtB,MAAA,EAAQ,oBAAA;EAIpB,aAAA,CAAc,KAAA,EAAO,eAAA;EAqHrB,GAAA,CAAI,KAAA,EAAO,aAAA,GAAgB,UAAA,CAAW,WAAA;EAqDtC,0BAAA,CACE,KAAA,EAAO,KAAA,EACP,QAAA,EAAU,SAAA,IACV,KAAA,EAAO,aAAA,GACN,KAAA,CAAM,eAAA,GAAkB,yBAAA;EA8BrB,aAAA,CAAA,GAAiB,OAAA,CAAQ,UAAA;AAAA"}
+{"version":3,"file":"agent.d.mts","names":[],"sources":["../../../../../../src/v1-deprecated/lib/runtime/agent-integrations/langgraph/agent.ts"],"mappings":";;;;;;;;UAmCU,yBAAA;EACR,UAAA;IACE,OAAA,EAAS,eAAA;IACT,OAAA,EAAS,eAAA;EAAA;AAAA;;;;;AAce;;;;;AAgB5B;KAJK,gBAAA,GAAmB,UAAA,CACtB,cAAA;AAAA,cAGW,gBAAA,SAAuB,cAAA;cACtB,MAAA,EAAQ,oBAAA;EAIpB,aAAA,CAAc,KAAA,EAAO,eAAA;EAqHrB,GAAA,CAAI,KAAA,EAAO,aAAA,GAAgB,UAAA,CAAW,WAAA;EAqDtC,0BAAA,CACE,KAAA,EAAO,KAAA,EACP,QAAA,EAAU,gBAAA,IACV,KAAA,EAAO,aAAA,GACN,KAAA,CAAM,eAAA,GAAkB,yBAAA;EA8BrB,aAAA,CAAA,GAAiB,OAAA,CAAQ,UAAA;AAAA"}

package/dist/lib/runtime/agent-integrations/langgraph/agent.mjs

@@ -5,7 +5,7 @@ import { map } from "rxjs";
 import { EventType } from "@ag-ui/client";
 import { LangGraphAgent, LangGraphHttpAgent } from "@ag-ui/langgraph";
 
-//#region src/lib/runtime/agent-integrations/langgraph/agent.ts
+//#region src/v1-deprecated/lib/runtime/agent-integrations/langgraph/agent.ts
 var LangGraphAgent$1 = class extends LangGraphAgent {
 	constructor(config) {
 		super(config);

package/dist/lib/runtime/agent-integrations/langgraph/agent.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"agent.mjs","names":["LangGraphAgent","AGUILangGraphAgent"],"sources":["../../../../../src/lib/runtime/agent-integrations/langgraph/agent.ts"],"sourcesContent":["import type { Observable } from \"rxjs\";\nimport { map } from \"rxjs\";\nimport { LangGraphEventTypes } from \"../../../../agents/langgraph/events\";\nimport type { BaseEvent, RawEvent } from \"@ag-ui/core\";\nimport type {\n  ProcessedEvents,\n  SchemaKeys,\n  StateEnrichment,\n} from \"@ag-ui/langgraph\";\nimport {\n  LangGraphAgent as AGUILangGraphAgent,\n  LangGraphHttpAgent,\n  type LangGraphAgentConfig,\n  type State,\n} from \"@ag-ui/langgraph\";\nimport type { Message as LangGraphMessage } from \"@langchain/langgraph-sdk/dist/types.messages\";\nimport type { ThreadState } from \"@langchain/langgraph-sdk\";\n\ninterface CopilotKitStateEnrichment {\n  copilotkit: {\n    actions: StateEnrichment[\"ag-ui\"][\"tools\"];\n    context: StateEnrichment[\"ag-ui\"][\"context\"];\n  };\n}\n\nimport type { RunAgentInput, CustomEvent } from \"@ag-ui/client\";\nimport { EventType } from \"@ag-ui/client\";\n\n// Import and re-export from separate file to maintain API compatibility\nimport type {\n  TextMessageEvents,\n  ToolCallEvents,\n  PredictStateTool,\n} from \"./consts\";\nimport { CustomEventNames } from \"./consts\";\nexport { CustomEventNames };\n\nexport class LangGraphAgent extends AGUILangGraphAgent {\n  constructor(config: LangGraphAgentConfig) {\n    super(config);\n  }\n\n  dispatchEvent(event: ProcessedEvents) {\n    if (event.type === EventType.CUSTOM) {\n      // const event = processedEvent as unknown as CustomEvent;\n      const customEvent = event as unknown as CustomEvent;\n\n      if (customEvent.name === CustomEventNames.CopilotKitManuallyEmitMessage) {\n        this.subscriber.next({\n          type: EventType.TEXT_MESSAGE_START,\n          role: \"assistant\",\n          messageId: customEvent.value.message_id,\n          rawEvent: event,\n        });\n        this.subscriber.next({\n          type: EventType.TEXT_MESSAGE_CONTENT,\n          messageId: customEvent.value.message_id,\n          delta: customEvent.value.message,\n          rawEvent: event,\n        });\n        this.subscriber.next({\n          type: EventType.TEXT_MESSAGE_END,\n          messageId: customEvent.value.message_id,\n          rawEvent: event,\n        });\n        return true;\n      }\n\n      if (\n        customEvent.name === CustomEventNames.CopilotKitManuallyEmitToolCall\n      ) {\n        this.subscriber.next({\n          type: EventType.TOOL_CALL_START,\n          toolCallId: customEvent.value.id,\n          toolCallName: customEvent.value.name,\n          parentMessageId: customEvent.value.id,\n          rawEvent: event,\n        });\n        this.subscriber.next({\n          type: EventType.TOOL_CALL_ARGS,\n          toolCallId: customEvent.value.id,\n          delta: customEvent.value.args,\n          rawEvent: event,\n        });\n        this.subscriber.next({\n          type: EventType.TOOL_CALL_END,\n          toolCallId: customEvent.value.id,\n          rawEvent: event,\n        });\n        return true;\n      }\n\n      if (\n        customEvent.name ===\n        CustomEventNames.CopilotKitManuallyEmitIntermediateState\n      ) {\n        this.activeRun.manuallyEmittedState = customEvent.value;\n        this.dispatchEvent({\n          type: EventType.STATE_SNAPSHOT,\n          snapshot: this.getStateSnapshot({\n            values: this.activeRun.manuallyEmittedState,\n          } as ThreadState<State>),\n          rawEvent: event,\n        });\n        return true;\n      }\n\n      if (customEvent.name === CustomEventNames.CopilotKitExit) {\n        this.subscriber.next({\n          type: EventType.CUSTOM,\n          name: \"Exit\",\n          value: true,\n        });\n        return true;\n      }\n    }\n\n    // Intercept all text message and tool call events and check if should disable\n    const rawEvent = (event as ToolCallEvents | TextMessageEvents).rawEvent;\n    if (!rawEvent) {\n      this.subscriber.next(event);\n      return true;\n    }\n\n    const isMessageEvent =\n      event.type === EventType.TEXT_MESSAGE_START ||\n      event.type === EventType.TEXT_MESSAGE_CONTENT ||\n      event.type === EventType.TEXT_MESSAGE_END;\n    const isToolEvent =\n      event.type === EventType.TOOL_CALL_START ||\n      event.type === EventType.TOOL_CALL_ARGS ||\n      event.type === EventType.TOOL_CALL_END;\n    if (\"copilotkit:emit-tool-calls\" in (rawEvent.metadata || {})) {\n      if (\n        rawEvent.metadata[\"copilotkit:emit-tool-calls\"] === false &&\n        isToolEvent\n      ) {\n        return false;\n      }\n    }\n    if (\"copilotkit:emit-messages\" in (rawEvent.metadata || {})) {\n      if (\n        rawEvent.metadata[\"copilotkit:emit-messages\"] === false &&\n        isMessageEvent\n      ) {\n        // Clean up tracked message state to prevent stale records from\n        // leaking into subsequent nodes that have emit-messages enabled.\n        if (this.activeRun?.id) {\n          this.messagesInProcess[this.activeRun.id] = null;\n        }\n        return false;\n      }\n    }\n\n    this.subscriber.next(event);\n    return true;\n  }\n\n  // @ts-ignore\n  run(input: RunAgentInput): Observable<BaseEvent> {\n    // @ag-ui/langgraph's message converter throws \"message role is not\n    // supported.\" on any role it doesn't enumerate (user|assistant|system|tool).\n    // Reasoning-stream agents (e.g. OpenAI Responses API with reasoning summaries)\n    // emit AG-UI messages with role:\"reasoning\" that the client then replays on\n    // subsequent turns; without this filter the second turn crashes before the\n    // model is ever called.\n    const messages = (input.messages ?? []).filter(\n      (m: { role?: string }) => m?.role !== \"reasoning\",\n    );\n    const enrichedInput = {\n      ...input,\n      messages,\n      forwardedProps: {\n        ...input.forwardedProps,\n        streamSubgraphs: input.forwardedProps?.streamSubgraphs ?? true,\n      },\n    };\n    return super.run(enrichedInput).pipe(\n      map((processedEvent) => {\n        // Turn raw event into emit state snapshot from tool call event\n        if (processedEvent.type === EventType.RAW) {\n          // Get the LangGraph event from the AGUI event.\n          const event =\n            (processedEvent as RawEvent).event ??\n            (processedEvent as RawEvent).rawEvent;\n\n          const eventType = event.event;\n          const toolCallData = event.data?.chunk?.tool_call_chunks?.[0];\n          const toolCallUsedToPredictState = event.metadata?.[\n            \"copilotkit:emit-intermediate-state\"\n          ]?.some(\n            (predictStateTool: PredictStateTool) =>\n              predictStateTool.tool === toolCallData?.name,\n          );\n\n          if (\n            eventType === LangGraphEventTypes.OnChatModelStream &&\n            toolCallUsedToPredictState\n          ) {\n            return {\n              type: EventType.CUSTOM,\n              name: \"PredictState\",\n              value: event.metadata[\"copilotkit:emit-intermediate-state\"],\n            };\n          }\n        }\n\n        return processedEvent;\n      }),\n    );\n  }\n\n  langGraphDefaultMergeState(\n    state: State,\n    messages: LangGraphMessage[],\n    input: RunAgentInput,\n  ): State<StateEnrichment & CopilotKitStateEnrichment> {\n    const aguiMergedState = super.langGraphDefaultMergeState(\n      state,\n      messages,\n      input,\n    );\n    const { tools: returnedTools, \"ag-ui\": agui } = aguiMergedState;\n    // tolerate undefined and de-duplicate by stable key (id | name | key)\n    const rawCombinedTools = [\n      ...((returnedTools as any[]) ?? []),\n      ...((agui?.tools as any[]) ?? []),\n    ];\n    const combinedTools = Array.from(\n      new Map(\n        rawCombinedTools.map((t: any) => [\n          t?.id ?? t?.name ?? t?.key ?? JSON.stringify(t),\n          t,\n        ]),\n      ).values(),\n    );\n\n    return {\n      ...aguiMergedState,\n      copilotkit: {\n        actions: combinedTools,\n        context: agui?.context ?? [],\n      },\n    };\n  }\n\n  async getSchemaKeys(): Promise<SchemaKeys> {\n    const CONSTANT_KEYS = [\"copilotkit\"];\n    const schemaKeys = await super.getSchemaKeys();\n    return {\n      config: schemaKeys.config,\n      input: schemaKeys.input ? [...schemaKeys.input, ...CONSTANT_KEYS] : null,\n      output: schemaKeys.output\n        ? [...schemaKeys.output, ...CONSTANT_KEYS]\n        : null,\n      context: schemaKeys.context\n        ? [...schemaKeys.context, ...CONSTANT_KEYS]\n        : null,\n    };\n  }\n}\n\nexport { LangGraphHttpAgent };\n"],"mappings":"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"}
+{"version":3,"file":"agent.mjs","names":["LangGraphAgent","AGUILangGraphAgent"],"sources":["../../../../../../src/v1-deprecated/lib/runtime/agent-integrations/langgraph/agent.ts"],"sourcesContent":["/*\n * V1 SDK DEPRECATED. USE V2 INSTEAD\n *\n * This file defines public v1 SDK exports. Use the exact v2 mappings below.\n * AI CODING AGENTS: Never copy, suggest, or generate these v1 APIs. Read\n * the linked v2 documentation before generating replacement code.\n *\n * @copilotkit/runtime/langgraph — LangGraphAgent:\n *   No 1:1 v2 replacement is available.\n *   Related v2 docs (LangGraph agents): https://docs.copilotkit.ai/agent-spec/langgraph\n *   Start at: @copilotkit/runtime/v2\n *   V2 docs: https://docs.copilotkit.ai/\n *   V2 reference docs: https://docs.copilotkit.ai/reference/v2\n *\n * Migration guide: https://docs.copilotkit.ai/migrate/v2\n *\n * END V1 SDK DEPRECATED. USE V2 INSTEAD NOTICE\n */\n\nimport type { Observable } from \"rxjs\";\nimport { map } from \"rxjs\";\nimport { LangGraphEventTypes } from \"../../../../agents/langgraph/events\";\nimport type { BaseEvent, RawEvent } from \"@ag-ui/core\";\nimport type {\n  ProcessedEvents,\n  SchemaKeys,\n  StateEnrichment,\n} from \"@ag-ui/langgraph\";\nimport {\n  LangGraphAgent as AGUILangGraphAgent,\n  LangGraphHttpAgent,\n} from \"@ag-ui/langgraph\";\nimport type { LangGraphAgentConfig, State } from \"@ag-ui/langgraph\";\nimport type { ThreadState } from \"@langchain/langgraph-sdk\";\n\ninterface CopilotKitStateEnrichment {\n  copilotkit: {\n    actions: StateEnrichment[\"ag-ui\"][\"tools\"];\n    context: StateEnrichment[\"ag-ui\"][\"context\"];\n  };\n}\n\nimport type { RunAgentInput, CustomEvent } from \"@ag-ui/client\";\nimport { EventType } from \"@ag-ui/client\";\n\n// Import and re-export from separate file to maintain API compatibility\nimport type {\n  TextMessageEvents,\n  ToolCallEvents,\n  PredictStateTool,\n} from \"./consts\";\nimport { CustomEventNames } from \"./consts\";\nexport { CustomEventNames };\n\n/**\n * The message type the base class's `langGraphDefaultMergeState` accepts.\n *\n * Derived from the base signature rather than deep-imported from\n * `@langchain/langgraph-sdk/dist/types.messages`. That path is an internal file\n * of an optional peer dependency: it is not part of the SDK's public entry\n * points, and consumers who skip the optional peer cannot resolve it at all,\n * which costs them a TS2307 on `skipLibCheck: false` (OSS-899). `@ag-ui/langgraph`\n * is a real dependency, so this stays resolvable for everyone.\n */\ntype LangGraphMessage = Parameters<\n  AGUILangGraphAgent[\"langGraphDefaultMergeState\"]\n>[1][number];\n\nexport class LangGraphAgent extends AGUILangGraphAgent {\n  constructor(config: LangGraphAgentConfig) {\n    super(config);\n  }\n\n  dispatchEvent(event: ProcessedEvents) {\n    if (event.type === EventType.CUSTOM) {\n      // const event = processedEvent as unknown as CustomEvent;\n      const customEvent = event as unknown as CustomEvent;\n\n      if (customEvent.name === CustomEventNames.CopilotKitManuallyEmitMessage) {\n        this.subscriber.next({\n          type: EventType.TEXT_MESSAGE_START,\n          role: \"assistant\",\n          messageId: customEvent.value.message_id,\n          rawEvent: event,\n        });\n        this.subscriber.next({\n          type: EventType.TEXT_MESSAGE_CONTENT,\n          messageId: customEvent.value.message_id,\n          delta: customEvent.value.message,\n          rawEvent: event,\n        });\n        this.subscriber.next({\n          type: EventType.TEXT_MESSAGE_END,\n          messageId: customEvent.value.message_id,\n          rawEvent: event,\n        });\n        return true;\n      }\n\n      if (\n        customEvent.name === CustomEventNames.CopilotKitManuallyEmitToolCall\n      ) {\n        this.subscriber.next({\n          type: EventType.TOOL_CALL_START,\n          toolCallId: customEvent.value.id,\n          toolCallName: customEvent.value.name,\n          parentMessageId: customEvent.value.id,\n          rawEvent: event,\n        });\n        this.subscriber.next({\n          type: EventType.TOOL_CALL_ARGS,\n          toolCallId: customEvent.value.id,\n          delta: customEvent.value.args,\n          rawEvent: event,\n        });\n        this.subscriber.next({\n          type: EventType.TOOL_CALL_END,\n          toolCallId: customEvent.value.id,\n          rawEvent: event,\n        });\n        return true;\n      }\n\n      if (\n        customEvent.name ===\n        CustomEventNames.CopilotKitManuallyEmitIntermediateState\n      ) {\n        this.activeRun.manuallyEmittedState = customEvent.value;\n        this.dispatchEvent({\n          type: EventType.STATE_SNAPSHOT,\n          snapshot: this.getStateSnapshot({\n            values: this.activeRun.manuallyEmittedState,\n          } as ThreadState<State>),\n          rawEvent: event,\n        });\n        return true;\n      }\n\n      if (customEvent.name === CustomEventNames.CopilotKitExit) {\n        this.subscriber.next({\n          type: EventType.CUSTOM,\n          name: \"Exit\",\n          value: true,\n        });\n        return true;\n      }\n    }\n\n    // Intercept all text message and tool call events and check if should disable\n    const rawEvent = (event as ToolCallEvents | TextMessageEvents).rawEvent;\n    if (!rawEvent) {\n      this.subscriber.next(event);\n      return true;\n    }\n\n    const isMessageEvent =\n      event.type === EventType.TEXT_MESSAGE_START ||\n      event.type === EventType.TEXT_MESSAGE_CONTENT ||\n      event.type === EventType.TEXT_MESSAGE_END;\n    const isToolEvent =\n      event.type === EventType.TOOL_CALL_START ||\n      event.type === EventType.TOOL_CALL_ARGS ||\n      event.type === EventType.TOOL_CALL_END;\n    if (\"copilotkit:emit-tool-calls\" in (rawEvent.metadata || {})) {\n      if (\n        rawEvent.metadata[\"copilotkit:emit-tool-calls\"] === false &&\n        isToolEvent\n      ) {\n        return false;\n      }\n    }\n    if (\"copilotkit:emit-messages\" in (rawEvent.metadata || {})) {\n      if (\n        rawEvent.metadata[\"copilotkit:emit-messages\"] === false &&\n        isMessageEvent\n      ) {\n        // Clean up tracked message state to prevent stale records from\n        // leaking into subsequent nodes that have emit-messages enabled.\n        if (this.activeRun?.id) {\n          this.messagesInProcess[this.activeRun.id] = null;\n        }\n        return false;\n      }\n    }\n\n    this.subscriber.next(event);\n    return true;\n  }\n\n  // @ts-ignore\n  run(input: RunAgentInput): Observable<BaseEvent> {\n    // @ag-ui/langgraph's message converter throws \"message role is not\n    // supported.\" on any role it doesn't enumerate (user|assistant|system|tool).\n    // Reasoning-stream agents (e.g. OpenAI Responses API with reasoning summaries)\n    // emit AG-UI messages with role:\"reasoning\" that the client then replays on\n    // subsequent turns; without this filter the second turn crashes before the\n    // model is ever called.\n    const messages = (input.messages ?? []).filter(\n      (m: { role?: string }) => m?.role !== \"reasoning\",\n    );\n    const enrichedInput = {\n      ...input,\n      messages,\n      forwardedProps: {\n        ...input.forwardedProps,\n        streamSubgraphs: input.forwardedProps?.streamSubgraphs ?? true,\n      },\n    };\n    return super.run(enrichedInput).pipe(\n      map((processedEvent) => {\n        // Turn raw event into emit state snapshot from tool call event\n        if (processedEvent.type === EventType.RAW) {\n          // Get the LangGraph event from the AGUI event.\n          const event =\n            (processedEvent as RawEvent).event ??\n            (processedEvent as RawEvent).rawEvent;\n\n          const eventType = event.event;\n          const toolCallData = event.data?.chunk?.tool_call_chunks?.[0];\n          const toolCallUsedToPredictState = event.metadata?.[\n            \"copilotkit:emit-intermediate-state\"\n          ]?.some(\n            (predictStateTool: PredictStateTool) =>\n              predictStateTool.tool === toolCallData?.name,\n          );\n\n          if (\n            eventType === LangGraphEventTypes.OnChatModelStream &&\n            toolCallUsedToPredictState\n          ) {\n            return {\n              type: EventType.CUSTOM,\n              name: \"PredictState\",\n              value: event.metadata[\"copilotkit:emit-intermediate-state\"],\n            };\n          }\n        }\n\n        return processedEvent;\n      }),\n    );\n  }\n\n  langGraphDefaultMergeState(\n    state: State,\n    messages: LangGraphMessage[],\n    input: RunAgentInput,\n  ): State<StateEnrichment & CopilotKitStateEnrichment> {\n    const aguiMergedState = super.langGraphDefaultMergeState(\n      state,\n      messages,\n      input,\n    );\n    const { tools: returnedTools, \"ag-ui\": agui } = aguiMergedState;\n    // tolerate undefined and de-duplicate by stable key (id | name | key)\n    const rawCombinedTools = [\n      ...((returnedTools as any[]) ?? []),\n      ...((agui?.tools as any[]) ?? []),\n    ];\n    const combinedTools = Array.from(\n      new Map(\n        rawCombinedTools.map((t: any) => [\n          t?.id ?? t?.name ?? t?.key ?? JSON.stringify(t),\n          t,\n        ]),\n      ).values(),\n    );\n\n    return {\n      ...aguiMergedState,\n      copilotkit: {\n        actions: combinedTools,\n        context: agui?.context ?? [],\n      },\n    };\n  }\n\n  async getSchemaKeys(): Promise<SchemaKeys> {\n    const CONSTANT_KEYS = [\"copilotkit\"];\n    const schemaKeys = await super.getSchemaKeys();\n    return {\n      config: schemaKeys.config,\n      input: schemaKeys.input ? [...schemaKeys.input, ...CONSTANT_KEYS] : null,\n      output: schemaKeys.output\n        ? [...schemaKeys.output, ...CONSTANT_KEYS]\n        : null,\n      context: schemaKeys.context\n        ? [...schemaKeys.context, ...CONSTANT_KEYS]\n        : null,\n    };\n  }\n}\n\nexport { LangGraphHttpAgent };\n"],"mappings":"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"}

package/dist/lib/runtime/agent-integrations/langgraph/consts.cjs

@@ -1,6 +1,6 @@
 require("reflect-metadata");
 
-//#region src/lib/runtime/agent-integrations/langgraph/consts.ts
+//#region src/v1-deprecated/lib/runtime/agent-integrations/langgraph/consts.ts
 let CustomEventNames = /* @__PURE__ */ function(CustomEventNames) {
 	CustomEventNames["CopilotKitManuallyEmitMessage"] = "copilotkit_manually_emit_message";
 	CustomEventNames["CopilotKitManuallyEmitToolCall"] = "copilotkit_manually_emit_tool_call";

package/dist/lib/runtime/agent-integrations/langgraph/consts.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"consts.cjs","names":[],"sources":["../../../../../src/lib/runtime/agent-integrations/langgraph/consts.ts"],"sourcesContent":["/**\n * Constants for LangGraph integration.\n * This file is separate from langgraph.agent.ts to avoid pulling in @ag-ui/langgraph\n * when only these constants are needed.\n */\n\nimport {\n  TextMessageStartEvent,\n  TextMessageContentEvent,\n  TextMessageEndEvent,\n  ToolCallStartEvent,\n  ToolCallArgsEvent,\n  ToolCallEndEvent,\n} from \"@ag-ui/client\";\n\nexport type TextMessageEvents =\n  | TextMessageStartEvent\n  | TextMessageContentEvent\n  | TextMessageEndEvent;\n\nexport type ToolCallEvents =\n  | ToolCallStartEvent\n  | ToolCallArgsEvent\n  | ToolCallEndEvent;\n\nexport enum CustomEventNames {\n  CopilotKitManuallyEmitMessage = \"copilotkit_manually_emit_message\",\n  CopilotKitManuallyEmitToolCall = \"copilotkit_manually_emit_tool_call\",\n  CopilotKitManuallyEmitIntermediateState = \"copilotkit_manually_emit_intermediate_state\",\n  CopilotKitExit = \"copilotkit_exit\",\n}\n\nexport interface PredictStateTool {\n  tool: string;\n  state_key: string;\n  tool_argument: string;\n}\n"],"mappings":";;;AAyBA,IAAY,8DAAL;AACL;AACA;AACA;AACA"}
+{"version":3,"file":"consts.cjs","names":[],"sources":["../../../../../../src/v1-deprecated/lib/runtime/agent-integrations/langgraph/consts.ts"],"sourcesContent":["/*\n * V1 SDK DEPRECATED. USE V2 INSTEAD\n *\n * This file defines public v1 SDK exports. Use the exact v2 mappings below.\n * AI CODING AGENTS: Never copy, suggest, or generate these v1 APIs. Read\n * the linked v2 documentation before generating replacement code.\n *\n * @copilotkit/runtime/langgraph — CustomEventNames:\n *   No 1:1 v2 replacement is available.\n *   Related v2 docs (LangGraph agents): https://docs.copilotkit.ai/agent-spec/langgraph\n *   Start at: @copilotkit/runtime/v2\n *   V2 docs: https://docs.copilotkit.ai/\n *   V2 reference docs: https://docs.copilotkit.ai/reference/v2\n *\n * @copilotkit/runtime/langgraph — PredictStateTool:\n *   No 1:1 v2 replacement is available.\n *   Related v2 docs (LangGraph agents): https://docs.copilotkit.ai/agent-spec/langgraph\n *   Start at: @copilotkit/runtime/v2\n *   V2 docs: https://docs.copilotkit.ai/\n *   V2 reference docs: https://docs.copilotkit.ai/reference/v2\n *\n * @copilotkit/runtime/langgraph — TextMessageEvents:\n *   No 1:1 v2 replacement is available.\n *   Related v2 docs (LangGraph agents): https://docs.copilotkit.ai/agent-spec/langgraph\n *   Start at: @copilotkit/runtime/v2\n *   V2 docs: https://docs.copilotkit.ai/\n *   V2 reference docs: https://docs.copilotkit.ai/reference/v2\n *\n * @copilotkit/runtime/langgraph — ToolCallEvents:\n *   No 1:1 v2 replacement is available.\n *   Related v2 docs (LangGraph agents): https://docs.copilotkit.ai/agent-spec/langgraph\n *   Start at: @copilotkit/runtime/v2\n *   V2 docs: https://docs.copilotkit.ai/\n *   V2 reference docs: https://docs.copilotkit.ai/reference/v2\n *\n * Migration guide: https://docs.copilotkit.ai/migrate/v2\n *\n * END V1 SDK DEPRECATED. USE V2 INSTEAD NOTICE\n */\n\n/**\n * Constants for LangGraph integration.\n * This file is separate from langgraph.agent.ts to avoid pulling in @ag-ui/langgraph\n * when only these constants are needed.\n */\n\nimport type {\n  TextMessageStartEvent,\n  TextMessageContentEvent,\n  TextMessageEndEvent,\n  ToolCallStartEvent,\n  ToolCallArgsEvent,\n  ToolCallEndEvent,\n} from \"@ag-ui/client\";\n\nexport type TextMessageEvents =\n  | TextMessageStartEvent\n  | TextMessageContentEvent\n  | TextMessageEndEvent;\n\nexport type ToolCallEvents =\n  | ToolCallStartEvent\n  | ToolCallArgsEvent\n  | ToolCallEndEvent;\n\nexport enum CustomEventNames {\n  CopilotKitManuallyEmitMessage = \"copilotkit_manually_emit_message\",\n  CopilotKitManuallyEmitToolCall = \"copilotkit_manually_emit_tool_call\",\n  CopilotKitManuallyEmitIntermediateState = \"copilotkit_manually_emit_intermediate_state\",\n  CopilotKitExit = \"copilotkit_exit\",\n}\n\nexport interface PredictStateTool {\n  tool: string;\n  state_key: string;\n  tool_argument: string;\n}\n"],"mappings":";;;AAiEA,IAAY,8DAAL;AACL;AACA;AACA;AACA"}

package/dist/lib/runtime/agent-integrations/langgraph/consts.d.cts

@@ -1,7 +1,7 @@
 
 import { TextMessageContentEvent, TextMessageEndEvent, TextMessageStartEvent, ToolCallArgsEvent, ToolCallEndEvent, ToolCallStartEvent } from "@ag-ui/client";
 
-//#region src/lib/runtime/agent-integrations/langgraph/consts.d.ts
+//#region src/v1-deprecated/lib/runtime/agent-integrations/langgraph/consts.d.ts
 type TextMessageEvents = TextMessageStartEvent | TextMessageContentEvent | TextMessageEndEvent;
 type ToolCallEvents = ToolCallStartEvent | ToolCallArgsEvent | ToolCallEndEvent;
 declare enum CustomEventNames {

package/dist/lib/runtime/agent-integrations/langgraph/consts.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"consts.d.cts","names":[],"sources":["../../../../../src/lib/runtime/agent-integrations/langgraph/consts.ts"],"mappings":";;;;KAeY,iBAAA,GACR,qBAAA,GACA,uBAAA,GACA,mBAAA;AAAA,KAEQ,cAAA,GACR,kBAAA,GACA,iBAAA,GACA,gBAAA;AAAA,aAEQ,gBAAA;EACV,6BAAA;EACA,8BAAA;EACA,uCAAA;EACA,cAAA;AAAA;AAAA,UAGe,gBAAA;EACf,IAAA;EACA,SAAA;EACA,aAAA;AAAA"}
+{"version":3,"file":"consts.d.cts","names":[],"sources":["../../../../../../src/v1-deprecated/lib/runtime/agent-integrations/langgraph/consts.ts"],"mappings":";;;;KAuDY,iBAAA,GACR,qBAAA,GACA,uBAAA,GACA,mBAAA;AAAA,KAEQ,cAAA,GACR,kBAAA,GACA,iBAAA,GACA,gBAAA;AAAA,aAEQ,gBAAA;EACV,6BAAA;EACA,8BAAA;EACA,uCAAA;EACA,cAAA;AAAA;AAAA,UAGe,gBAAA;EACf,IAAA;EACA,SAAA;EACA,aAAA;AAAA"}

package/dist/lib/runtime/agent-integrations/langgraph/consts.d.mts

@@ -1,7 +1,7 @@
 
 import { TextMessageContentEvent, TextMessageEndEvent, TextMessageStartEvent, ToolCallArgsEvent, ToolCallEndEvent, ToolCallStartEvent } from "@ag-ui/client";
 
-//#region src/lib/runtime/agent-integrations/langgraph/consts.d.ts
+//#region src/v1-deprecated/lib/runtime/agent-integrations/langgraph/consts.d.ts
 type TextMessageEvents = TextMessageStartEvent | TextMessageContentEvent | TextMessageEndEvent;
 type ToolCallEvents = ToolCallStartEvent | ToolCallArgsEvent | ToolCallEndEvent;
 declare enum CustomEventNames {

package/dist/lib/runtime/agent-integrations/langgraph/consts.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"consts.d.mts","names":[],"sources":["../../../../../src/lib/runtime/agent-integrations/langgraph/consts.ts"],"mappings":";;;;KAeY,iBAAA,GACR,qBAAA,GACA,uBAAA,GACA,mBAAA;AAAA,KAEQ,cAAA,GACR,kBAAA,GACA,iBAAA,GACA,gBAAA;AAAA,aAEQ,gBAAA;EACV,6BAAA;EACA,8BAAA;EACA,uCAAA;EACA,cAAA;AAAA;AAAA,UAGe,gBAAA;EACf,IAAA;EACA,SAAA;EACA,aAAA;AAAA"}
+{"version":3,"file":"consts.d.mts","names":[],"sources":["../../../../../../src/v1-deprecated/lib/runtime/agent-integrations/langgraph/consts.ts"],"mappings":";;;;KAuDY,iBAAA,GACR,qBAAA,GACA,uBAAA,GACA,mBAAA;AAAA,KAEQ,cAAA,GACR,kBAAA,GACA,iBAAA,GACA,gBAAA;AAAA,aAEQ,gBAAA;EACV,6BAAA;EACA,8BAAA;EACA,uCAAA;EACA,cAAA;AAAA;AAAA,UAGe,gBAAA;EACf,IAAA;EACA,SAAA;EACA,aAAA;AAAA"}

package/dist/lib/runtime/agent-integrations/langgraph/consts.mjs

@@ -1,5 +1,5 @@
 import "reflect-metadata";
-//#region src/lib/runtime/agent-integrations/langgraph/consts.ts
+//#region src/v1-deprecated/lib/runtime/agent-integrations/langgraph/consts.ts
 let CustomEventNames = /* @__PURE__ */ function(CustomEventNames) {
 	CustomEventNames["CopilotKitManuallyEmitMessage"] = "copilotkit_manually_emit_message";
 	CustomEventNames["CopilotKitManuallyEmitToolCall"] = "copilotkit_manually_emit_tool_call";

package/dist/lib/runtime/agent-integrations/langgraph/consts.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"consts.mjs","names":[],"sources":["../../../../../src/lib/runtime/agent-integrations/langgraph/consts.ts"],"sourcesContent":["/**\n * Constants for LangGraph integration.\n * This file is separate from langgraph.agent.ts to avoid pulling in @ag-ui/langgraph\n * when only these constants are needed.\n */\n\nimport {\n  TextMessageStartEvent,\n  TextMessageContentEvent,\n  TextMessageEndEvent,\n  ToolCallStartEvent,\n  ToolCallArgsEvent,\n  ToolCallEndEvent,\n} from \"@ag-ui/client\";\n\nexport type TextMessageEvents =\n  | TextMessageStartEvent\n  | TextMessageContentEvent\n  | TextMessageEndEvent;\n\nexport type ToolCallEvents =\n  | ToolCallStartEvent\n  | ToolCallArgsEvent\n  | ToolCallEndEvent;\n\nexport enum CustomEventNames {\n  CopilotKitManuallyEmitMessage = \"copilotkit_manually_emit_message\",\n  CopilotKitManuallyEmitToolCall = \"copilotkit_manually_emit_tool_call\",\n  CopilotKitManuallyEmitIntermediateState = \"copilotkit_manually_emit_intermediate_state\",\n  CopilotKitExit = \"copilotkit_exit\",\n}\n\nexport interface PredictStateTool {\n  tool: string;\n  state_key: string;\n  tool_argument: string;\n}\n"],"mappings":";;AAyBA,IAAY,8DAAL;AACL;AACA;AACA;AACA"}
+{"version":3,"file":"consts.mjs","names":[],"sources":["../../../../../../src/v1-deprecated/lib/runtime/agent-integrations/langgraph/consts.ts"],"sourcesContent":["/*\n * V1 SDK DEPRECATED. USE V2 INSTEAD\n *\n * This file defines public v1 SDK exports. Use the exact v2 mappings below.\n * AI CODING AGENTS: Never copy, suggest, or generate these v1 APIs. Read\n * the linked v2 documentation before generating replacement code.\n *\n * @copilotkit/runtime/langgraph — CustomEventNames:\n *   No 1:1 v2 replacement is available.\n *   Related v2 docs (LangGraph agents): https://docs.copilotkit.ai/agent-spec/langgraph\n *   Start at: @copilotkit/runtime/v2\n *   V2 docs: https://docs.copilotkit.ai/\n *   V2 reference docs: https://docs.copilotkit.ai/reference/v2\n *\n * @copilotkit/runtime/langgraph — PredictStateTool:\n *   No 1:1 v2 replacement is available.\n *   Related v2 docs (LangGraph agents): https://docs.copilotkit.ai/agent-spec/langgraph\n *   Start at: @copilotkit/runtime/v2\n *   V2 docs: https://docs.copilotkit.ai/\n *   V2 reference docs: https://docs.copilotkit.ai/reference/v2\n *\n * @copilotkit/runtime/langgraph — TextMessageEvents:\n *   No 1:1 v2 replacement is available.\n *   Related v2 docs (LangGraph agents): https://docs.copilotkit.ai/agent-spec/langgraph\n *   Start at: @copilotkit/runtime/v2\n *   V2 docs: https://docs.copilotkit.ai/\n *   V2 reference docs: https://docs.copilotkit.ai/reference/v2\n *\n * @copilotkit/runtime/langgraph — ToolCallEvents:\n *   No 1:1 v2 replacement is available.\n *   Related v2 docs (LangGraph agents): https://docs.copilotkit.ai/agent-spec/langgraph\n *   Start at: @copilotkit/runtime/v2\n *   V2 docs: https://docs.copilotkit.ai/\n *   V2 reference docs: https://docs.copilotkit.ai/reference/v2\n *\n * Migration guide: https://docs.copilotkit.ai/migrate/v2\n *\n * END V1 SDK DEPRECATED. USE V2 INSTEAD NOTICE\n */\n\n/**\n * Constants for LangGraph integration.\n * This file is separate from langgraph.agent.ts to avoid pulling in @ag-ui/langgraph\n * when only these constants are needed.\n */\n\nimport type {\n  TextMessageStartEvent,\n  TextMessageContentEvent,\n  TextMessageEndEvent,\n  ToolCallStartEvent,\n  ToolCallArgsEvent,\n  ToolCallEndEvent,\n} from \"@ag-ui/client\";\n\nexport type TextMessageEvents =\n  | TextMessageStartEvent\n  | TextMessageContentEvent\n  | TextMessageEndEvent;\n\nexport type ToolCallEvents =\n  | ToolCallStartEvent\n  | ToolCallArgsEvent\n  | ToolCallEndEvent;\n\nexport enum CustomEventNames {\n  CopilotKitManuallyEmitMessage = \"copilotkit_manually_emit_message\",\n  CopilotKitManuallyEmitToolCall = \"copilotkit_manually_emit_tool_call\",\n  CopilotKitManuallyEmitIntermediateState = \"copilotkit_manually_emit_intermediate_state\",\n  CopilotKitExit = \"copilotkit_exit\",\n}\n\nexport interface PredictStateTool {\n  tool: string;\n  state_key: string;\n  tool_argument: string;\n}\n"],"mappings":";;AAiEA,IAAY,8DAAL;AACL;AACA;AACA;AACA"}

package/dist/lib/runtime/copilot-runtime.cjs

@@ -12,7 +12,7 @@ const require_index = require('../../agent/index.cjs');
 const require_telemetry_client = require('../telemetry-client.cjs');
 let _copilotkit_shared = require("@copilotkit/shared");
 
-//#region src/lib/runtime/copilot-runtime.ts
+//#region src/v1-deprecated/lib/runtime/copilot-runtime.ts
 /**
 * <Callout type="info">
 *   This is the reference for the `CopilotRuntime` class. For more information and example code snippets, please see [Concept: Copilot Runtime](/backend/copilot-runtime).
@@ -28,6 +28,14 @@ let _copilotkit_shared = require("@copilotkit/shared");
 */
 /**
 * Central runtime object passed to all request handlers.
+* @deprecated The v1 SDK is deprecated. Use v2 instead. Use `CopilotRuntime` from `@copilotkit/runtime/v2` instead.
+*
+* ```tsx
+* import { CopilotRuntime } from "@copilotkit/runtime/v2";
+*
+* const runtime = new CopilotRuntime({ agents: {} });
+* ```
+* See https://docs.copilotkit.ai/runtime-server-adapter
 */
 var CopilotRuntime = class {
 	constructor(params) {

package/dist/lib/runtime/copilot-runtime.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"copilot-runtime.cjs","names":["InMemoryAgentRunner","TelemetryAgentRunner","runtimeErrorReporterOption","createRuntimeErrorReporter","CopilotRuntimeVNext","EndpointType","CopilotKitMisuseError","BuiltInAgent","aguiToGQL","extractParametersFromSchema"],"sources":["../../../src/lib/runtime/copilot-runtime.ts"],"sourcesContent":["/**\n * <Callout type=\"info\">\n *   This is the reference for the `CopilotRuntime` class. For more information and example code snippets, please see [Concept: Copilot Runtime](/backend/copilot-runtime).\n * </Callout>\n *\n * ## Usage\n *\n * ```tsx\n * import { CopilotRuntime } from \"@copilotkit/runtime\";\n *\n * const copilotKit = new CopilotRuntime();\n * ```\n */\n\nimport {\n  CopilotKitMisuseError,\n  readBody,\n  getZodParameters,\n  isTelemetryDisabled,\n} from \"@copilotkit/shared\";\nimport type {\n  Action,\n  CopilotErrorHandler,\n  MaybePromise,\n  NonEmptyRecord,\n  Parameter,\n  PartialBy,\n  DebugConfig,\n} from \"@copilotkit/shared\";\nimport type { RunAgentInput } from \"@ag-ui/core\";\nimport { aguiToGQL } from \"../../graphql/message-conversion/agui-to-gql\";\nimport type {\n  CopilotServiceAdapter,\n  RemoteChainParameters,\n} from \"../../service-adapters\";\nimport {\n  CopilotRuntime as CopilotRuntimeVNext,\n  InMemoryAgentRunner,\n} from \"../../v2/runtime\";\nimport {\n  createRuntimeErrorReporter,\n  runtimeErrorReporterOption,\n} from \"../../v2/runtime/core/runtime-error-reporter\";\nimport type { RuntimeErrorReporterOptions } from \"../../v2/runtime/core/runtime-error-reporter\";\nimport type {\n  CopilotIntelligenceRuntimeOptions,\n  CopilotRuntimeOptions,\n  CopilotRuntimeOptions as CopilotRuntimeOptionsVNext,\n  AgentRunner,\n  AgentsConfig,\n  AgentsFactory,\n  AgentFactoryContext,\n} from \"../../v2/runtime\";\n\nexport type { AgentsConfig, AgentsFactory, AgentFactoryContext };\nimport { TelemetryAgentRunner } from \"./telemetry-agent-runner\";\nimport telemetry from \"../telemetry-client\";\nimport { logRuntimeTelemetryDisclosure } from \"../telemetry-disclosure\";\n\nimport type { MessageInput } from \"../../graphql/inputs/message.input\";\nimport type { Message } from \"../../graphql/types/converted\";\n\nimport { EndpointType } from \"./types\";\nimport type {\n  EndpointDefinition,\n  CopilotKitEndpoint,\n  LangGraphPlatformEndpoint,\n} from \"./types\";\n\nimport type {\n  CopilotObservabilityConfig,\n  LLMRequestData,\n  LLMResponseData,\n} from \"../observability\";\nimport type { AbstractAgent } from \"@ag-ui/client\";\n\n// +++ MCP Imports +++\nimport { extractParametersFromSchema } from \"./mcp-tools-utils\";\nimport type { MCPClient, MCPEndpointConfig, MCPTool } from \"./mcp-tools-utils\";\nimport { BuiltInAgent } from \"../../agent\";\nimport type { BuiltInAgentClassicConfig } from \"../../agent\";\n// Define the function type alias here or import if defined elsewhere\ntype CreateMCPClientFunction = (\n  config: MCPEndpointConfig,\n) => Promise<MCPClient>;\n\ntype ActionsConfiguration<T extends Parameter[] | [] = []> =\n  | Action<T>[]\n  | ((ctx: { properties: any; url?: string }) => Action<T>[]);\n\ninterface OnBeforeRequestOptions {\n  threadId?: string;\n  runId?: string;\n  inputMessages: Message[];\n  properties: any;\n  url?: string;\n}\n\ntype OnBeforeRequestHandler = (\n  options: OnBeforeRequestOptions,\n) => void | Promise<void>;\n\ninterface OnAfterRequestOptions {\n  threadId: string;\n  runId?: string;\n  inputMessages: Message[];\n  outputMessages: Message[];\n  properties: any;\n  url?: string;\n}\n\ntype OnAfterRequestHandler = (\n  options: OnAfterRequestOptions,\n) => void | Promise<void>;\n\ninterface OnStopGenerationOptions {\n  threadId: string;\n  runId?: string;\n  url?: string;\n  agentName?: string;\n  lastMessage: MessageInput;\n}\ntype OnStopGenerationHandler = (\n  options: OnStopGenerationOptions,\n) => void | Promise<void>;\n\ninterface Middleware {\n  /**\n   * A function that is called before the request is processed.\n   */\n  /**\n   * @deprecated This middleware hook is deprecated and will be removed in a future version.\n   * Use updated middleware integration methods in CopilotRuntimeVNext instead.\n   */\n  onBeforeRequest?: OnBeforeRequestHandler;\n\n  /**\n   * A function that is called after the request is processed.\n   */\n  /**\n   * @deprecated This middleware hook is deprecated and will be removed in a future version.\n   * Use updated middleware integration methods in CopilotRuntimeVNext instead.\n   */\n  onAfterRequest?: OnAfterRequestHandler;\n}\n\nexport interface CopilotRuntimeConstructorParams_BASE<\n  T extends Parameter[] | [] = [],\n> {\n  /**\n   * Middleware to be used by the runtime.\n   *\n   * ```ts\n   * onBeforeRequest: (options: {\n   *   threadId?: string;\n   *   runId?: string;\n   *   inputMessages: Message[];\n   *   properties: any;\n   * }) => void | Promise<void>;\n   * ```\n   *\n   * ```ts\n   * onAfterRequest: (options: {\n   *   threadId?: string;\n   *   runId?: string;\n   *   inputMessages: Message[];\n   *   outputMessages: Message[];\n   *   properties: any;\n   * }) => void | Promise<void>;\n   * ```\n   */\n  /**\n   * @deprecated This middleware hook is deprecated and will be removed in a future version.\n   * Use updated middleware integration methods in CopilotRuntimeVNext instead.\n   */\n  middleware?: Middleware;\n\n  /*\n   * A list of server side actions that can be executed. Will be ignored when remoteActions are set\n   */\n  actions?: ActionsConfiguration<T>;\n\n  /*\n   * Deprecated: Use `remoteEndpoints`.\n   */\n  remoteActions?: CopilotKitEndpoint[];\n\n  /*\n   * A list of remote actions that can be executed.\n   */\n  remoteEndpoints?: EndpointDefinition[];\n\n  /*\n   * An array of LangServer URLs.\n   */\n  langserve?: RemoteChainParameters[];\n\n  /**\n   * Optional agent runner to use for SSE runtime.\n   */\n  runner?: AgentRunner;\n\n  /*\n   * A map of agent names to AGUI agents.\n   * Example agent config:\n   * ```ts\n   * import { AbstractAgent } from \"@ag-ui/client\";\n   * // ...\n   * agents: {\n   *   \"support\": new CustomerSupportAgent(),\n   *   \"technical\": new TechnicalAgent()\n   * }\n   * ```\n   */\n  agents?: Record<string, AbstractAgent>;\n\n  /*\n   * Delegates agent state processing to the service adapter.\n   *\n   * When enabled, individual agent state requests will not be processed by the agent itself.\n   * Instead, all processing will be handled by the service adapter.\n   */\n  delegateAgentProcessingToServiceAdapter?: boolean;\n\n  /**\n   * Configuration for LLM request/response logging.\n   *\n   * Example logging config:\n   * ```ts\n   * logging: {\n   *   enabled: true, // Enable or disable logging\n   *   progressive: true, // Set to false for buffered logging\n   *   logger: {\n   *     logRequest: (data) => langfuse.trace({ name: \"LLM Request\", input: data }),\n   *     logResponse: (data) => langfuse.trace({ name: \"LLM Response\", output: data }),\n   *     logError: (errorData) => langfuse.trace({ name: \"LLM Error\", metadata: errorData }),\n   *   },\n   * }\n   * ```\n   */\n  observability_c?: CopilotObservabilityConfig;\n\n  /**\n   * Configuration for connecting to Model Context Protocol (MCP) servers.\n   * Allows fetching and using tools defined on external MCP-compliant servers.\n   * Requires providing the `createMCPClient` function during instantiation.\n   * @experimental\n   */\n  mcpServers?: MCPEndpointConfig[];\n\n  /**\n   * A function that creates an MCP client instance for a given endpoint configuration.\n   * This function is responsible for using the appropriate MCP client library\n   * (e.g., `@copilotkit/runtime`, `ai`) to establish a connection.\n   * Required if `mcpServers` is provided.\n   *\n   * ```typescript\n   * import { experimental_createMCPClient } from \"ai\"; // Import from vercel ai library\n   * // ...\n   * const runtime = new CopilotRuntime({\n   *   mcpServers: [{ endpoint: \"...\" }],\n   *   async createMCPClient(config) {\n   *     return await experimental_createMCPClient({\n   *       transport: {\n   *         type: \"sse\",\n   *         url: config.endpoint,\n   *         headers: config.apiKey\n   *           ? { Authorization: `Bearer ${config.apiKey}` }\n   *           : undefined,\n   *       },\n   *     });\n   *   }\n   * });\n   * ```\n   */\n  createMCPClient?: CreateMCPClientFunction;\n\n  /**\n   * Optional error handler for comprehensive debugging and observability.\n   *\n   * @param errorEvent - Structured error event with rich debugging context\n   *\n   * @example\n   * ```typescript\n   * const runtime = new CopilotRuntime({\n   *   onError: (errorEvent) => {\n   *     debugDashboard.capture(errorEvent);\n   *   }\n   * });\n   * ```\n   */\n  onError?: CopilotErrorHandler;\n\n  onStopGeneration?: OnStopGenerationHandler;\n\n  /**\n   * Enable debug logging for the runtime event pipeline.\n   * Pass `true` for full output, or an object for granular control:\n   *\n   * ```ts\n   * const runtime = new CopilotRuntime({\n   *   debug: true,\n   *   // or: debug: { events: true, lifecycle: true, verbose: false }\n   * });\n   * ```\n   */\n  debug?: DebugConfig;\n\n  // /** Optional transcription service for audio processing. */\n  // transcriptionService?: CopilotRuntimeOptionsVNext[\"transcriptionService\"];\n  // /** Optional *before* middleware – callback function or webhook URL. */\n  // beforeRequestMiddleware?: CopilotRuntimeOptionsVNext[\"beforeRequestMiddleware\"];\n  // /** Optional *after* middleware – callback function or webhook URL. */\n  // afterRequestMiddleware?: CopilotRuntimeOptionsVNext[\"afterRequestMiddleware\"];\n}\n\ntype BeforeRequestMiddleware =\n  CopilotRuntimeOptionsVNext[\"beforeRequestMiddleware\"];\ntype AfterRequestMiddleware =\n  CopilotRuntimeOptionsVNext[\"afterRequestMiddleware\"];\ntype BeforeRequestMiddlewareFn = Exclude<BeforeRequestMiddleware, string>;\ntype BeforeRequestMiddlewareFnParameters =\n  Parameters<BeforeRequestMiddlewareFn>;\ntype BeforeRequestMiddlewareFnResult = ReturnType<BeforeRequestMiddlewareFn>;\ntype AfterRequestMiddlewareFn = Exclude<AfterRequestMiddleware, string>;\ntype AfterRequestMiddlewareFnParameters = Parameters<AfterRequestMiddlewareFn>;\n\ninterface CopilotRuntimeConstructorParams<T extends Parameter[] | [] = []>\n  extends\n    Omit<CopilotRuntimeConstructorParams_BASE<T>, \"agents\">,\n    Omit<CopilotRuntimeOptionsVNext, \"agents\" | \"transcriptionService\"> {\n  /**\n   * TODO: un-omit `transcriptionService` above once it's supported\n   *\n   * This satisfies...\n   *  – the optional constraint in `CopilotRuntimeConstructorParams_BASE`\n   *  – the `MaybePromise<NonEmptyRecord<T>>` constraint in `CopilotRuntimeOptionsVNext`\n   *  – the `Record<string, AbstractAgent>` constraint in `both\n   */\n  agents?: AgentsConfig;\n\n  intelligence?: CopilotIntelligenceRuntimeOptions[\"intelligence\"];\n  identifyUser?: CopilotIntelligenceRuntimeOptions[\"identifyUser\"];\n  memory?: CopilotIntelligenceRuntimeOptions[\"memory\"];\n  channels?: CopilotIntelligenceRuntimeOptions[\"channels\"];\n  ɵlearning?: CopilotIntelligenceRuntimeOptions[\"ɵlearning\"];\n  generateThreadNames?: CopilotIntelligenceRuntimeOptions[\"generateThreadNames\"];\n  maxReconnectMs?: CopilotIntelligenceRuntimeOptions[\"maxReconnectMs\"];\n  maxRejoinMs?: CopilotIntelligenceRuntimeOptions[\"maxRejoinMs\"];\n  lockTtlSeconds?: CopilotIntelligenceRuntimeOptions[\"lockTtlSeconds\"];\n  lockKeyPrefix?: CopilotIntelligenceRuntimeOptions[\"lockKeyPrefix\"];\n  lockHeartbeatIntervalSeconds?: CopilotIntelligenceRuntimeOptions[\"lockHeartbeatIntervalSeconds\"];\n}\n\n/**\n * Central runtime object passed to all request handlers.\n */\nexport class CopilotRuntime<const T extends Parameter[] | [] = []> {\n  params?: CopilotRuntimeConstructorParams<T>;\n  private observability?: CopilotObservabilityConfig;\n  // Cache MCP tools per endpoint to avoid re-fetching repeatedly\n  private mcpToolsCache: Map<string, BuiltInAgentClassicConfig[\"tools\"]> =\n    new Map();\n  private runtimeArgs: CopilotRuntimeOptions & RuntimeErrorReporterOptions;\n  private _instance: CopilotRuntimeVNext;\n\n  constructor(params?: CopilotRuntimeConstructorParams<T>) {\n    logRuntimeTelemetryDisclosure();\n\n    const agents = params?.agents ?? {};\n    const endpointAgents = this.assignEndpointsToAgents(\n      params?.remoteEndpoints ?? [],\n    );\n\n    // Merge endpoint agents with user-provided agents.\n    // When agents is a factory function, wrap it so endpoint agents are merged\n    // at resolution time (spreading a function produces {} — silent data loss).\n    let mergedAgents: AgentsConfig;\n    if (typeof agents === \"function\") {\n      mergedAgents = async (ctx) => {\n        const resolved = await agents(ctx);\n        return { ...endpointAgents, ...resolved };\n      };\n    } else {\n      mergedAgents = Promise.resolve(agents).then((resolved) => ({\n        ...endpointAgents,\n        ...resolved,\n      }));\n    }\n\n    // Determine the base runner (user-provided or default)\n    const baseRunner = params?.runner ?? new InMemoryAgentRunner();\n\n    // Wrap with TelemetryAgentRunner unless telemetry is disabled\n    // This ensures we always capture agent execution telemetry when enabled,\n    // even if the user provides their own custom runner\n    const runner = isTelemetryDisabled()\n      ? baseRunner\n      : new TelemetryAgentRunner({ runner: baseRunner });\n\n    // Match license-verifier's env fallback so telemetry attribution\n    // resolves the same way as feature gating — otherwise customers who\n    // set only COPILOTKIT_LICENSE_TOKEN would get a working license but\n    // anonymous telemetry. Only used here for the telemetry setter; the\n    // v2 runtime applies the same fallback to runtimeArgs.licenseToken\n    // on its own.\n    const resolvedLicenseToken =\n      params?.licenseToken ?? process.env.COPILOTKIT_LICENSE_TOKEN;\n    if (resolvedLicenseToken) {\n      telemetry.setLicenseToken(resolvedLicenseToken);\n    }\n\n    const sharedRuntimeArgs = {\n      agents: mergedAgents,\n      licenseToken: params?.licenseToken,\n      debug: params?.debug,\n      // TODO: add support for transcriptionService from CopilotRuntimeOptionsVNext once it is ready\n      // transcriptionService: params?.transcriptionService,\n\n      beforeRequestMiddleware:\n        this.createOnBeforeRequestHandler(params).bind(this),\n      ...(params?.afterRequestMiddleware || params?.middleware?.onAfterRequest\n        ? {\n            afterRequestMiddleware:\n              this.createOnAfterRequestHandler(params).bind(this),\n          }\n        : {}),\n      a2ui: params?.a2ui,\n      mcpApps: params?.mcpApps,\n      openGenerativeUI: params?.openGenerativeUI,\n      [runtimeErrorReporterOption]: createRuntimeErrorReporter(params?.onError),\n      forwardHeaders: params?.forwardHeaders,\n      exposeMemoryRoutes: params?.exposeMemoryRoutes,\n    };\n    if (params?.intelligence !== undefined) {\n      // The compatibility constructor keeps Intelligence identity optional at\n      // compile time, while the v2 runtime checks that callers supply web\n      // identity, Channels, or both. Preserve that runtime validation here.\n      this.runtimeArgs = {\n        ...sharedRuntimeArgs,\n        intelligence: params.intelligence,\n        identifyUser: params.identifyUser,\n        memory: params.memory,\n        channels: params.channels,\n        ɵlearning: params.ɵlearning,\n        generateThreadNames: params.generateThreadNames,\n        maxReconnectMs: params.maxReconnectMs,\n        maxRejoinMs: params.maxRejoinMs,\n        lockTtlSeconds: params.lockTtlSeconds,\n        lockKeyPrefix: params.lockKeyPrefix,\n        lockHeartbeatIntervalSeconds: params.lockHeartbeatIntervalSeconds,\n      } as CopilotRuntimeOptions;\n    } else {\n      this.runtimeArgs = {\n        ...sharedRuntimeArgs,\n        runner,\n      };\n    }\n    this.params = params;\n    this.observability = params?.observability_c;\n  }\n\n  get instance() {\n    if (!this._instance) {\n      this._instance = new CopilotRuntimeVNext(this.runtimeArgs);\n    }\n\n    return this._instance;\n  }\n\n  private assignEndpointsToAgents(\n    endpoints: CopilotRuntimeConstructorParams<T>[\"remoteEndpoints\"],\n  ): Record<string, AbstractAgent> {\n    let result: Record<string, AbstractAgent> = {};\n\n    if (\n      endpoints.some(\n        (endpoint) =>\n          resolveEndpointType(endpoint) == EndpointType.LangGraphPlatform,\n      )\n    ) {\n      throw new CopilotKitMisuseError({\n        message:\n          \"LangGraphPlatformEndpoint in remoteEndpoints is deprecated. \" +\n          'Please use the \"agents\" option instead with LangGraphAgent from \"@copilotkit/runtime/langgraph\". ' +\n          'Example: agents: { myAgent: new LangGraphAgent({ deploymentUrl: \"...\", graphId: \"...\" }) }',\n      });\n    }\n\n    return result;\n  }\n\n  handleServiceAdapter(serviceAdapter: CopilotServiceAdapter) {\n    this.runtimeArgs.agents = Promise.resolve(\n      this.runtimeArgs.agents ?? {},\n    ).then(async (agents) => {\n      // An AgentsFactory function has no enumerable keys, so it flows through\n      // this path the same way an empty record does.\n      let agentsList = agents as Record<string, AbstractAgent>;\n      const isAgentsListEmpty = !Object.keys(agents).length;\n      const hasServiceAdapter = Boolean(serviceAdapter);\n      const illegalServiceAdapterNames = [\"EmptyAdapter\"];\n      const serviceAdapterCanBeUsedForAgent =\n        !illegalServiceAdapterNames.includes(serviceAdapter.name);\n\n      if (\n        isAgentsListEmpty &&\n        (!hasServiceAdapter || !serviceAdapterCanBeUsedForAgent)\n      ) {\n        throw new CopilotKitMisuseError({\n          message:\n            \"No default agent provided. Please provide a default agent in the runtime config.\",\n        });\n      }\n\n      if (isAgentsListEmpty) {\n        const languageModel = serviceAdapter.getLanguageModel?.();\n        if (languageModel) {\n          // Adapter exposes a pre-configured LanguageModel (e.g. OpenAI/Anthropic adapters)\n          agentsList.default = new BuiltInAgent({ model: languageModel });\n        } else if (serviceAdapter.provider && serviceAdapter.model) {\n          // Adapter exposes provider/model strings\n          agentsList.default = new BuiltInAgent({\n            model: `${serviceAdapter.provider}/${serviceAdapter.model}`,\n          });\n        } else {\n          throw new CopilotKitMisuseError({\n            message:\n              `Service adapter \"${serviceAdapter.name ?? \"unknown\"}\" does not provide model information. ` +\n              `When using adapters like LangChainAdapter without an explicit agents list, ` +\n              `please provide a default agent in the runtime config. Example:\\n` +\n              `  new CopilotRuntime({\\n` +\n              `    agents: { default: new BuiltInAgent({ model: \"openai/gpt-4o\" }) }\\n` +\n              `  })`,\n          });\n        }\n      }\n\n      const actions = this.params?.actions;\n      if (actions) {\n        const mcpTools = await this.getToolsFromMCP();\n        agentsList = this.assignToolsToAgents(agentsList, [\n          ...this.getToolsFromActions(actions),\n          ...mcpTools,\n        ]);\n      }\n\n      return agentsList;\n    });\n  }\n\n  // Receive this.params.action and turn it into the AbstractAgent tools\n  private getToolsFromActions(\n    actions: ActionsConfiguration<any>,\n  ): BuiltInAgentClassicConfig[\"tools\"] {\n    // Resolve actions to an array (handle function case)\n    const actionsArray =\n      typeof actions === \"function\"\n        ? actions({ properties: {}, url: undefined })\n        : actions;\n\n    // Convert each Action to a ToolDefinition\n    return actionsArray.map((action) => {\n      // Convert JSON schema to Zod schema\n      const zodSchema = getZodParameters(action.parameters || []);\n\n      return {\n        name: action.name,\n        description: action.description || \"\",\n        parameters: zodSchema,\n        execute: () => Promise.resolve(),\n      };\n    });\n  }\n\n  private assignToolsToAgents(\n    agents: Record<string, AbstractAgent>,\n    tools: BuiltInAgentClassicConfig[\"tools\"],\n  ): Record<string, AbstractAgent> {\n    if (!tools?.length) {\n      return agents;\n    }\n\n    const enrichedAgents: Record<string, AbstractAgent> = { ...agents };\n\n    for (const [agentId, agent] of Object.entries(enrichedAgents)) {\n      const existingConfig = (Reflect.get(agent, \"config\") ?? {}) as Record<\n        string,\n        unknown\n      >;\n\n      // Skip factory-mode agents — they don't have a tools property\n      if (\"factory\" in existingConfig) {\n        continue;\n      }\n\n      const classicConfig =\n        existingConfig as unknown as BuiltInAgentClassicConfig;\n      const existingTools = classicConfig.tools ?? [];\n\n      const updatedConfig: BuiltInAgentClassicConfig = {\n        ...classicConfig,\n        tools: [...existingTools, ...tools],\n      };\n\n      Reflect.set(agent, \"config\", updatedConfig);\n      enrichedAgents[agentId] = agent;\n    }\n\n    return enrichedAgents;\n  }\n\n  private createOnBeforeRequestHandler(\n    params?: CopilotRuntimeConstructorParams<T> &\n      PartialBy<CopilotRuntimeOptions, \"agents\">,\n  ) {\n    return async (hookParams: BeforeRequestMiddlewareFnParameters[0]) => {\n      const { request } = hookParams;\n\n      // Capture telemetry for copilot request creation\n      const publicApiKey = request.headers.get(\"x-copilotcloud-public-api-key\");\n      const body = (await readBody(request)) as RunAgentInput;\n\n      const forwardedProps = body?.forwardedProps as\n        | {\n            cloud?: { guardrails?: unknown };\n            metadata?: { requestType?: string };\n          }\n        | undefined;\n\n      // Get cloud base URL from environment or default\n      const cloudBaseUrl =\n        process.env.COPILOT_CLOUD_BASE_URL || \"https://api.cloud.copilotkit.ai\";\n\n      telemetry.capture(\"oss.runtime.copilot_request_created\", {\n        \"cloud.guardrails.enabled\":\n          forwardedProps?.cloud?.guardrails !== undefined,\n        requestType: forwardedProps?.metadata?.requestType ?? \"unknown\",\n        \"cloud.api_key_provided\": !!publicApiKey,\n        ...(publicApiKey ? { \"cloud.public_api_key\": publicApiKey } : {}),\n        \"cloud.base_url\": cloudBaseUrl,\n      });\n\n      // We do not process middleware for the internal GET requests\n      if (request.method === \"GET\" || !body) return;\n\n      // TODO: get public api key and run with expected data\n      // if (this.observability?.enabled && this.params.publicApiKey) {\n      //   this.logObservabilityBeforeRequest()\n      // }\n\n      // TODO: replace hooksParams top argument type with BeforeRequestMiddlewareParameters when exported\n      const middlewareResult =\n        await params?.beforeRequestMiddleware?.(hookParams);\n\n      if (params?.middleware?.onBeforeRequest) {\n        const { request, runtime, path } = hookParams;\n        const gqlMessages = (aguiToGQL(body.messages) as Message[]).reduce(\n          (acc, msg) => {\n            if (\"role\" in msg && msg.role === \"user\") {\n              acc.inputMessages.push(msg);\n            } else {\n              acc.outputMessages.push(msg);\n            }\n            return acc;\n          },\n          { inputMessages: [] as Message[], outputMessages: [] as Message[] },\n        );\n        const { inputMessages, outputMessages } = gqlMessages;\n        params.middleware.onBeforeRequest({\n          threadId: body.threadId,\n          runId: body.runId,\n          inputMessages,\n          properties: body.forwardedProps,\n          url: request.url,\n        } satisfies OnBeforeRequestOptions);\n      }\n\n      return middlewareResult;\n    };\n  }\n\n  private createOnAfterRequestHandler(\n    params?: CopilotRuntimeConstructorParams<T> &\n      PartialBy<CopilotRuntimeOptions, \"agents\">,\n  ) {\n    return async (hookParams: AfterRequestMiddlewareFnParameters[0]) => {\n      // TODO: get public api key and run with expected data\n      // if (this.observability?.enabled && publicApiKey) {\n      //   this.logObservabilityAfterRequest()\n      // }\n\n      // TODO: replace hooksParams top argument type with AfterRequestMiddlewareParameters when exported\n      params?.afterRequestMiddleware?.(hookParams);\n\n      if (params?.middleware?.onAfterRequest) {\n        const messages = hookParams.messages ?? [];\n        params.middleware.onAfterRequest({\n          threadId: hookParams.threadId ?? \"\",\n          runId: hookParams.runId,\n          inputMessages: messages.filter(\n            (m): m is typeof m & { role: string } =>\n              \"role\" in m && m.role === \"user\",\n          ) as unknown as Message[],\n          outputMessages: messages.filter(\n            (m): m is typeof m & { role: string } =>\n              \"role\" in m && m.role !== \"user\",\n          ) as unknown as Message[],\n          // TODO: forward actual properties once the after-request hook has access to the request body\n          properties: {},\n          url: hookParams.path,\n        } satisfies OnAfterRequestOptions);\n      }\n    };\n  }\n\n  // Observability Methods\n\n  /**\n   * Log LLM request if observability is enabled\n   */\n  private async logObservabilityBeforeRequest(\n    requestData: LLMRequestData,\n  ): Promise<void> {\n    try {\n      await this.observability.hooks.handleRequest(requestData);\n    } catch (error) {\n      console.error(\"Error logging LLM request:\", error);\n    }\n  }\n\n  /**\n   * Log final LLM response after request completes\n   */\n  private logObservabilityAfterRequest(\n    outputMessagesPromise: Promise<Message[]>,\n    baseData: {\n      threadId: string;\n      runId?: string;\n      model?: string;\n      provider?: string;\n      agentName?: string;\n      nodeName?: string;\n    },\n    streamedChunks: any[],\n    requestStartTime: number,\n    publicApiKey?: string,\n  ): void {\n    try {\n      outputMessagesPromise\n        .then((outputMessages) => {\n          const responseData: LLMResponseData = {\n            threadId: baseData.threadId,\n            runId: baseData.runId,\n            model: baseData.model,\n            // Use collected chunks for progressive mode or outputMessages for regular mode\n            output: this.observability.progressive\n              ? streamedChunks\n              : outputMessages,\n            latency: Date.now() - requestStartTime,\n            timestamp: Date.now(),\n            provider: baseData.provider,\n            isFinalResponse: true,\n            agentName: baseData.agentName,\n            nodeName: baseData.nodeName,\n          };\n\n          try {\n            this.observability.hooks.handleResponse(responseData);\n          } catch (logError) {\n            console.error(\"Error logging LLM response:\", logError);\n          }\n        })\n        .catch((error) => {\n          console.error(\"Failed to get output messages for logging:\", error);\n        });\n    } catch (error) {\n      console.error(\"Error setting up logging for LLM response:\", error);\n    }\n  }\n\n  // Resolve MCP tools to BuiltInAgent tool definitions\n  // Optionally accepts request-scoped properties to merge request-provided mcpServers\n  private async getToolsFromMCP(options?: {\n    properties?: Record<string, unknown>;\n  }): Promise<BuiltInAgentClassicConfig[\"tools\"]> {\n    const runtimeMcpServers = (this.params?.mcpServers ??\n      []) as MCPEndpointConfig[];\n    const createMCPClient = this.params?.createMCPClient as\n      | CreateMCPClientFunction\n      | undefined;\n\n    // If no runtime config and no request overrides, nothing to do\n    const requestMcpServers = ((\n      options?.properties as { mcpServers?: MCPEndpointConfig[] } | undefined\n    )?.mcpServers ??\n      (\n        options?.properties as\n          | { mcpEndpoints?: MCPEndpointConfig[] }\n          | undefined\n      )?.mcpEndpoints ??\n      []) as MCPEndpointConfig[];\n\n    const hasAnyServers =\n      (runtimeMcpServers?.length ?? 0) > 0 ||\n      (requestMcpServers?.length ?? 0) > 0;\n    if (!hasAnyServers) {\n      return [];\n    }\n\n    if (!createMCPClient) {\n      // Mirror legacy behavior: when servers are provided without a factory, treat as misconfiguration\n      throw new CopilotKitMisuseError({\n        message:\n          \"MCP Integration Error: `mcpServers` were provided, but the `createMCPClient` function was not passed to the CopilotRuntime constructor. Please provide an implementation for `createMCPClient`.\",\n      });\n    }\n\n    // Merge and dedupe endpoints by URL; request-level overrides take precedence\n    const effectiveEndpoints = (() => {\n      const byUrl = new Map<string, MCPEndpointConfig>();\n      for (const ep of runtimeMcpServers) {\n        if (ep?.endpoint) byUrl.set(ep.endpoint, ep);\n      }\n      for (const ep of requestMcpServers) {\n        if (ep?.endpoint) byUrl.set(ep.endpoint, ep);\n      }\n      return Array.from(byUrl.values());\n    })();\n\n    const allTools: BuiltInAgentClassicConfig[\"tools\"] = [];\n\n    for (const config of effectiveEndpoints) {\n      const endpointUrl = config.endpoint;\n      // Return cached tool definitions when available\n      const cached = this.mcpToolsCache.get(endpointUrl);\n      if (cached) {\n        allTools.push(...cached);\n        continue;\n      }\n\n      try {\n        const client = await createMCPClient(config);\n        const toolsMap = await client.tools();\n\n        const toolDefs: BuiltInAgentClassicConfig[\"tools\"] = Object.entries(\n          toolsMap,\n        ).map(([toolName, tool]: [string, MCPTool]) => {\n          const params: Parameter[] = extractParametersFromSchema(tool);\n          const zodSchema = getZodParameters(params);\n          return {\n            name: toolName,\n            description:\n              tool.description || `MCP tool: ${toolName} (from ${endpointUrl})`,\n            parameters: zodSchema,\n            execute: () => Promise.resolve(),\n          };\n        });\n\n        // Cache per endpoint and add to aggregate\n        this.mcpToolsCache.set(endpointUrl, toolDefs);\n        allTools.push(...toolDefs);\n      } catch (error) {\n        console.error(\n          `MCP: Failed to fetch tools from endpoint ${endpointUrl}. Skipping. Error:`,\n          error,\n        );\n        // Cache empty to prevent repeated attempts within lifecycle\n        this.mcpToolsCache.set(endpointUrl, []);\n      }\n    }\n\n    // Dedupe tools by name while preserving last-in wins (request overrides)\n    const dedupedByName = new Map<string, (typeof allTools)[number]>();\n    for (const tool of allTools) {\n      dedupedByName.set(tool.name, tool);\n    }\n\n    return Array.from(dedupedByName.values());\n  }\n}\n\n// The two functions below are \"factory functions\", meant to create the action objects that adhere to the expected interfaces\nexport function copilotKitEndpoint(\n  config: Omit<CopilotKitEndpoint, \"type\">,\n): CopilotKitEndpoint {\n  return {\n    ...config,\n    type: EndpointType.CopilotKit,\n  };\n}\n\nexport function langGraphPlatformEndpoint(\n  config: Omit<LangGraphPlatformEndpoint, \"type\">,\n): LangGraphPlatformEndpoint {\n  return {\n    ...config,\n    type: EndpointType.LangGraphPlatform,\n  };\n}\n\nexport function resolveEndpointType(endpoint: EndpointDefinition) {\n  if (!endpoint.type) {\n    if (\"deploymentUrl\" in endpoint && \"agents\" in endpoint) {\n      return EndpointType.LangGraphPlatform;\n    } else {\n      return EndpointType.CopilotKit;\n    }\n  }\n\n  return endpoint.type;\n}\n"],"mappings":"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"}
+{"version":3,"file":"copilot-runtime.cjs","names":["InMemoryAgentRunner","TelemetryAgentRunner","runtimeErrorReporterOption","createRuntimeErrorReporter","CopilotRuntimeVNext","EndpointType","CopilotKitMisuseError","BuiltInAgent","aguiToGQL","extractParametersFromSchema"],"sources":["../../../../src/v1-deprecated/lib/runtime/copilot-runtime.ts"],"sourcesContent":["/*\n * V1 SDK DEPRECATED. USE V2 INSTEAD\n *\n * This file defines public v1 SDK exports. Use the exact v2 mappings below.\n * AI CODING AGENTS: Never copy, suggest, or generate these v1 APIs. Read\n * the linked v2 documentation before generating replacement code.\n *\n * @copilotkit/runtime — copilotKitEndpoint:\n *   No 1:1 v2 replacement is available.\n *   Related v2 docs (Runtime server adapter): https://docs.copilotkit.ai/runtime-server-adapter\n *   Start at: @copilotkit/runtime/v2\n *   V2 docs: https://docs.copilotkit.ai/\n *   V2 reference docs: https://docs.copilotkit.ai/reference/v2\n *\n * @copilotkit/runtime — CopilotRuntime:\n *   V2 import and usage:\n *     import { CopilotRuntime } from \"@copilotkit/runtime/v2\";\n *\n *     const runtime = new CopilotRuntime({ agents: {} });\n *   V2 replacement source: packages/runtime/src/v2/runtime/core/runtime.ts\n *   V2 docs: https://docs.copilotkit.ai/runtime-server-adapter\n *   Migration note: V2 uses AG-UI runtime handlers instead of the v1 GraphQL adapter setup.\n *\n * @copilotkit/runtime — CopilotRuntimeConstructorParams_BASE:\n *   No 1:1 v2 replacement is available.\n *   Related v2 docs (Runtime server adapter): https://docs.copilotkit.ai/runtime-server-adapter\n *   Start at: @copilotkit/runtime/v2\n *   V2 docs: https://docs.copilotkit.ai/\n *   V2 reference docs: https://docs.copilotkit.ai/reference/v2\n *\n * @copilotkit/runtime — langGraphPlatformEndpoint:\n *   No 1:1 v2 replacement is available.\n *   Related v2 docs (LangGraph agents): https://docs.copilotkit.ai/agent-spec/langgraph\n *   Start at: @copilotkit/runtime/v2\n *   V2 docs: https://docs.copilotkit.ai/\n *   V2 reference docs: https://docs.copilotkit.ai/reference/v2\n *\n * @copilotkit/runtime — resolveEndpointType:\n *   No 1:1 v2 replacement is available.\n *   Related v2 docs (Runtime server adapter): https://docs.copilotkit.ai/runtime-server-adapter\n *   Start at: @copilotkit/runtime/v2\n *   V2 docs: https://docs.copilotkit.ai/\n *   V2 reference docs: https://docs.copilotkit.ai/reference/v2\n *\n * Migration guide: https://docs.copilotkit.ai/migrate/v2\n *\n * END V1 SDK DEPRECATED. USE V2 INSTEAD NOTICE\n */\n\n/**\n * <Callout type=\"info\">\n *   This is the reference for the `CopilotRuntime` class. For more information and example code snippets, please see [Concept: Copilot Runtime](/backend/copilot-runtime).\n * </Callout>\n *\n * ## Usage\n *\n * ```tsx\n * import { CopilotRuntime } from \"@copilotkit/runtime\";\n *\n * const copilotKit = new CopilotRuntime();\n * ```\n */\n\nimport {\n  CopilotKitMisuseError,\n  readBody,\n  getZodParameters,\n  isTelemetryDisabled,\n} from \"@copilotkit/shared\";\nimport type {\n  Action,\n  CopilotErrorHandler,\n  MaybePromise,\n  NonEmptyRecord,\n  Parameter,\n  PartialBy,\n  DebugConfig,\n} from \"@copilotkit/shared\";\nimport type { RunAgentInput } from \"@ag-ui/core\";\nimport { aguiToGQL } from \"../../graphql/message-conversion/agui-to-gql\";\nimport type {\n  CopilotServiceAdapter,\n  RemoteChainParameters,\n} from \"../../service-adapters\";\nimport {\n  CopilotRuntime as CopilotRuntimeVNext,\n  InMemoryAgentRunner,\n} from \"../../../v2/runtime\";\nimport {\n  createRuntimeErrorReporter,\n  runtimeErrorReporterOption,\n} from \"../../../v2/runtime/core/runtime-error-reporter\";\nimport type { RuntimeErrorReporterOptions } from \"../../../v2/runtime/core/runtime-error-reporter\";\nimport type {\n  CopilotIntelligenceRuntimeOptions,\n  CopilotRuntimeOptions,\n  CopilotRuntimeOptions as CopilotRuntimeOptionsVNext,\n  AgentRunner,\n  AgentsConfig,\n  AgentsFactory,\n  AgentFactoryContext,\n} from \"../../../v2/runtime\";\n\nexport type { AgentsConfig, AgentsFactory, AgentFactoryContext };\nimport { TelemetryAgentRunner } from \"./telemetry-agent-runner\";\nimport telemetry from \"../telemetry-client\";\nimport { logRuntimeTelemetryDisclosure } from \"../telemetry-disclosure\";\n\nimport type { MessageInput } from \"../../graphql/inputs/message.input\";\nimport type { Message } from \"../../graphql/types/converted\";\n\nimport { EndpointType } from \"./types\";\nimport type {\n  EndpointDefinition,\n  CopilotKitEndpoint,\n  LangGraphPlatformEndpoint,\n} from \"./types\";\n\nimport type {\n  CopilotObservabilityConfig,\n  LLMRequestData,\n  LLMResponseData,\n} from \"../observability\";\nimport type { AbstractAgent } from \"@ag-ui/client\";\n\n// +++ MCP Imports +++\nimport { extractParametersFromSchema } from \"./mcp-tools-utils\";\nimport type { MCPClient, MCPEndpointConfig, MCPTool } from \"./mcp-tools-utils\";\nimport { BuiltInAgent } from \"../../../agent\";\nimport type { BuiltInAgentClassicConfig } from \"../../../agent\";\n// Define the function type alias here or import if defined elsewhere\ntype CreateMCPClientFunction = (\n  config: MCPEndpointConfig,\n) => Promise<MCPClient>;\n\ntype ActionsConfiguration<T extends Parameter[] | [] = []> =\n  | Action<T>[]\n  | ((ctx: { properties: any; url?: string }) => Action<T>[]);\n\ninterface OnBeforeRequestOptions {\n  threadId?: string;\n  runId?: string;\n  inputMessages: Message[];\n  properties: any;\n  url?: string;\n}\n\ntype OnBeforeRequestHandler = (\n  options: OnBeforeRequestOptions,\n) => void | Promise<void>;\n\ninterface OnAfterRequestOptions {\n  threadId: string;\n  runId?: string;\n  inputMessages: Message[];\n  outputMessages: Message[];\n  properties: any;\n  url?: string;\n}\n\ntype OnAfterRequestHandler = (\n  options: OnAfterRequestOptions,\n) => void | Promise<void>;\n\ninterface OnStopGenerationOptions {\n  threadId: string;\n  runId?: string;\n  url?: string;\n  agentName?: string;\n  lastMessage: MessageInput;\n}\ntype OnStopGenerationHandler = (\n  options: OnStopGenerationOptions,\n) => void | Promise<void>;\n\ninterface Middleware {\n  /**\n   * A function that is called before the request is processed.\n   */\n  /**\n   * @deprecated This middleware hook is deprecated and will be removed in a future version.\n   * Use updated middleware integration methods in CopilotRuntimeVNext instead.\n   */\n  onBeforeRequest?: OnBeforeRequestHandler;\n\n  /**\n   * A function that is called after the request is processed.\n   */\n  /**\n   * @deprecated This middleware hook is deprecated and will be removed in a future version.\n   * Use updated middleware integration methods in CopilotRuntimeVNext instead.\n   */\n  onAfterRequest?: OnAfterRequestHandler;\n}\n\nexport interface CopilotRuntimeConstructorParams_BASE<\n  T extends Parameter[] | [] = [],\n> {\n  /**\n   * Middleware to be used by the runtime.\n   *\n   * ```ts\n   * onBeforeRequest: (options: {\n   *   threadId?: string;\n   *   runId?: string;\n   *   inputMessages: Message[];\n   *   properties: any;\n   * }) => void | Promise<void>;\n   * ```\n   *\n   * ```ts\n   * onAfterRequest: (options: {\n   *   threadId?: string;\n   *   runId?: string;\n   *   inputMessages: Message[];\n   *   outputMessages: Message[];\n   *   properties: any;\n   * }) => void | Promise<void>;\n   * ```\n   */\n  /**\n   * @deprecated This middleware hook is deprecated and will be removed in a future version.\n   * Use updated middleware integration methods in CopilotRuntimeVNext instead.\n   */\n  middleware?: Middleware;\n\n  /*\n   * A list of server side actions that can be executed. Will be ignored when remoteActions are set\n   */\n  actions?: ActionsConfiguration<T>;\n\n  /*\n   * Deprecated: Use `remoteEndpoints`.\n   */\n  remoteActions?: CopilotKitEndpoint[];\n\n  /*\n   * A list of remote actions that can be executed.\n   */\n  remoteEndpoints?: EndpointDefinition[];\n\n  /*\n   * An array of LangServer URLs.\n   */\n  langserve?: RemoteChainParameters[];\n\n  /**\n   * Optional agent runner to use for SSE runtime.\n   */\n  runner?: AgentRunner;\n\n  /*\n   * A map of agent names to AGUI agents.\n   * Example agent config:\n   * ```ts\n   * import { AbstractAgent } from \"@ag-ui/client\";\n   * // ...\n   * agents: {\n   *   \"support\": new CustomerSupportAgent(),\n   *   \"technical\": new TechnicalAgent()\n   * }\n   * ```\n   */\n  agents?: Record<string, AbstractAgent>;\n\n  /*\n   * Delegates agent state processing to the service adapter.\n   *\n   * When enabled, individual agent state requests will not be processed by the agent itself.\n   * Instead, all processing will be handled by the service adapter.\n   */\n  delegateAgentProcessingToServiceAdapter?: boolean;\n\n  /**\n   * Configuration for LLM request/response logging.\n   *\n   * Example logging config:\n   * ```ts\n   * logging: {\n   *   enabled: true, // Enable or disable logging\n   *   progressive: true, // Set to false for buffered logging\n   *   logger: {\n   *     logRequest: (data) => langfuse.trace({ name: \"LLM Request\", input: data }),\n   *     logResponse: (data) => langfuse.trace({ name: \"LLM Response\", output: data }),\n   *     logError: (errorData) => langfuse.trace({ name: \"LLM Error\", metadata: errorData }),\n   *   },\n   * }\n   * ```\n   */\n  observability_c?: CopilotObservabilityConfig;\n\n  /**\n   * Configuration for connecting to Model Context Protocol (MCP) servers.\n   * Allows fetching and using tools defined on external MCP-compliant servers.\n   * Requires providing the `createMCPClient` function during instantiation.\n   * @experimental\n   */\n  mcpServers?: MCPEndpointConfig[];\n\n  /**\n   * A function that creates an MCP client instance for a given endpoint configuration.\n   * This function is responsible for using the appropriate MCP client library\n   * (e.g., `@copilotkit/runtime`, `ai`) to establish a connection.\n   * Required if `mcpServers` is provided.\n   *\n   * ```typescript\n   * import { experimental_createMCPClient } from \"ai\"; // Import from vercel ai library\n   * // ...\n   * const runtime = new CopilotRuntime({\n   *   mcpServers: [{ endpoint: \"...\" }],\n   *   async createMCPClient(config) {\n   *     return await experimental_createMCPClient({\n   *       transport: {\n   *         type: \"sse\",\n   *         url: config.endpoint,\n   *         headers: config.apiKey\n   *           ? { Authorization: `Bearer ${config.apiKey}` }\n   *           : undefined,\n   *       },\n   *     });\n   *   }\n   * });\n   * ```\n   */\n  createMCPClient?: CreateMCPClientFunction;\n\n  /**\n   * Optional error handler for comprehensive debugging and observability.\n   *\n   * @param errorEvent - Structured error event with rich debugging context\n   *\n   * @example\n   * ```typescript\n   * const runtime = new CopilotRuntime({\n   *   onError: (errorEvent) => {\n   *     debugDashboard.capture(errorEvent);\n   *   }\n   * });\n   * ```\n   */\n  onError?: CopilotErrorHandler;\n\n  onStopGeneration?: OnStopGenerationHandler;\n\n  /**\n   * Enable debug logging for the runtime event pipeline.\n   * Pass `true` for full output, or an object for granular control:\n   *\n   * ```ts\n   * const runtime = new CopilotRuntime({\n   *   debug: true,\n   *   // or: debug: { events: true, lifecycle: true, verbose: false }\n   * });\n   * ```\n   */\n  debug?: DebugConfig;\n\n  // /** Optional transcription service for audio processing. */\n  // transcriptionService?: CopilotRuntimeOptionsVNext[\"transcriptionService\"];\n  // /** Optional *before* middleware – callback function or webhook URL. */\n  // beforeRequestMiddleware?: CopilotRuntimeOptionsVNext[\"beforeRequestMiddleware\"];\n  // /** Optional *after* middleware – callback function or webhook URL. */\n  // afterRequestMiddleware?: CopilotRuntimeOptionsVNext[\"afterRequestMiddleware\"];\n}\n\ntype BeforeRequestMiddleware =\n  CopilotRuntimeOptionsVNext[\"beforeRequestMiddleware\"];\ntype AfterRequestMiddleware =\n  CopilotRuntimeOptionsVNext[\"afterRequestMiddleware\"];\ntype BeforeRequestMiddlewareFn = Exclude<BeforeRequestMiddleware, string>;\ntype BeforeRequestMiddlewareFnParameters =\n  Parameters<BeforeRequestMiddlewareFn>;\ntype BeforeRequestMiddlewareFnResult = ReturnType<BeforeRequestMiddlewareFn>;\ntype AfterRequestMiddlewareFn = Exclude<AfterRequestMiddleware, string>;\ntype AfterRequestMiddlewareFnParameters = Parameters<AfterRequestMiddlewareFn>;\n\ninterface CopilotRuntimeConstructorParams<T extends Parameter[] | [] = []>\n  extends\n    Omit<CopilotRuntimeConstructorParams_BASE<T>, \"agents\">,\n    Omit<CopilotRuntimeOptionsVNext, \"agents\" | \"transcriptionService\"> {\n  /**\n   * TODO: un-omit `transcriptionService` above once it's supported\n   *\n   * This satisfies...\n   *  – the optional constraint in `CopilotRuntimeConstructorParams_BASE`\n   *  – the `MaybePromise<NonEmptyRecord<T>>` constraint in `CopilotRuntimeOptionsVNext`\n   *  – the `Record<string, AbstractAgent>` constraint in `both\n   */\n  agents?: AgentsConfig;\n\n  intelligence?: CopilotIntelligenceRuntimeOptions[\"intelligence\"];\n  identifyUser?: CopilotIntelligenceRuntimeOptions[\"identifyUser\"];\n  memory?: CopilotIntelligenceRuntimeOptions[\"memory\"];\n  channels?: CopilotIntelligenceRuntimeOptions[\"channels\"];\n  ɵlearning?: CopilotIntelligenceRuntimeOptions[\"ɵlearning\"];\n  generateThreadNames?: CopilotIntelligenceRuntimeOptions[\"generateThreadNames\"];\n  maxReconnectMs?: CopilotIntelligenceRuntimeOptions[\"maxReconnectMs\"];\n  maxRejoinMs?: CopilotIntelligenceRuntimeOptions[\"maxRejoinMs\"];\n  lockTtlSeconds?: CopilotIntelligenceRuntimeOptions[\"lockTtlSeconds\"];\n  lockKeyPrefix?: CopilotIntelligenceRuntimeOptions[\"lockKeyPrefix\"];\n  lockHeartbeatIntervalSeconds?: CopilotIntelligenceRuntimeOptions[\"lockHeartbeatIntervalSeconds\"];\n}\n\n/**\n * Central runtime object passed to all request handlers.\n * @deprecated The v1 SDK is deprecated. Use v2 instead. Use `CopilotRuntime` from `@copilotkit/runtime/v2` instead.\n *\n * ```tsx\n * import { CopilotRuntime } from \"@copilotkit/runtime/v2\";\n *\n * const runtime = new CopilotRuntime({ agents: {} });\n * ```\n * See https://docs.copilotkit.ai/runtime-server-adapter\n */\nexport class CopilotRuntime<const T extends Parameter[] | [] = []> {\n  params?: CopilotRuntimeConstructorParams<T>;\n  private observability?: CopilotObservabilityConfig;\n  // Cache MCP tools per endpoint to avoid re-fetching repeatedly\n  private mcpToolsCache: Map<string, BuiltInAgentClassicConfig[\"tools\"]> =\n    new Map();\n  private runtimeArgs: CopilotRuntimeOptions & RuntimeErrorReporterOptions;\n  private _instance: CopilotRuntimeVNext;\n\n  constructor(params?: CopilotRuntimeConstructorParams<T>) {\n    logRuntimeTelemetryDisclosure();\n\n    const agents = params?.agents ?? {};\n    const endpointAgents = this.assignEndpointsToAgents(\n      params?.remoteEndpoints ?? [],\n    );\n\n    // Merge endpoint agents with user-provided agents.\n    // When agents is a factory function, wrap it so endpoint agents are merged\n    // at resolution time (spreading a function produces {} — silent data loss).\n    let mergedAgents: AgentsConfig;\n    if (typeof agents === \"function\") {\n      mergedAgents = async (ctx) => {\n        const resolved = await agents(ctx);\n        return { ...endpointAgents, ...resolved };\n      };\n    } else {\n      mergedAgents = Promise.resolve(agents).then((resolved) => ({\n        ...endpointAgents,\n        ...resolved,\n      }));\n    }\n\n    // Determine the base runner (user-provided or default)\n    const baseRunner = params?.runner ?? new InMemoryAgentRunner();\n\n    // Wrap with TelemetryAgentRunner unless telemetry is disabled\n    // This ensures we always capture agent execution telemetry when enabled,\n    // even if the user provides their own custom runner\n    const runner = isTelemetryDisabled()\n      ? baseRunner\n      : new TelemetryAgentRunner({ runner: baseRunner });\n\n    // Match license-verifier's env fallback so telemetry attribution\n    // resolves the same way as feature gating — otherwise customers who\n    // set only COPILOTKIT_LICENSE_TOKEN would get a working license but\n    // anonymous telemetry. Only used here for the telemetry setter; the\n    // v2 runtime applies the same fallback to runtimeArgs.licenseToken\n    // on its own.\n    const resolvedLicenseToken =\n      params?.licenseToken ?? process.env.COPILOTKIT_LICENSE_TOKEN;\n    if (resolvedLicenseToken) {\n      telemetry.setLicenseToken(resolvedLicenseToken);\n    }\n\n    const sharedRuntimeArgs = {\n      agents: mergedAgents,\n      licenseToken: params?.licenseToken,\n      debug: params?.debug,\n      // TODO: add support for transcriptionService from CopilotRuntimeOptionsVNext once it is ready\n      // transcriptionService: params?.transcriptionService,\n\n      beforeRequestMiddleware:\n        this.createOnBeforeRequestHandler(params).bind(this),\n      ...(params?.afterRequestMiddleware || params?.middleware?.onAfterRequest\n        ? {\n            afterRequestMiddleware:\n              this.createOnAfterRequestHandler(params).bind(this),\n          }\n        : {}),\n      a2ui: params?.a2ui,\n      mcpApps: params?.mcpApps,\n      openGenerativeUI: params?.openGenerativeUI,\n      [runtimeErrorReporterOption]: createRuntimeErrorReporter(params?.onError),\n      forwardHeaders: params?.forwardHeaders,\n      exposeMemoryRoutes: params?.exposeMemoryRoutes,\n    };\n    if (params?.intelligence !== undefined) {\n      // The compatibility constructor keeps Intelligence identity optional at\n      // compile time, while the v2 runtime checks that callers supply web\n      // identity, Channels, or both. Preserve that runtime validation here.\n      this.runtimeArgs = {\n        ...sharedRuntimeArgs,\n        intelligence: params.intelligence,\n        identifyUser: params.identifyUser,\n        memory: params.memory,\n        channels: params.channels,\n        ɵlearning: params.ɵlearning,\n        generateThreadNames: params.generateThreadNames,\n        maxReconnectMs: params.maxReconnectMs,\n        maxRejoinMs: params.maxRejoinMs,\n        lockTtlSeconds: params.lockTtlSeconds,\n        lockKeyPrefix: params.lockKeyPrefix,\n        lockHeartbeatIntervalSeconds: params.lockHeartbeatIntervalSeconds,\n      } as CopilotRuntimeOptions;\n    } else {\n      this.runtimeArgs = {\n        ...sharedRuntimeArgs,\n        runner,\n      };\n    }\n    this.params = params;\n    this.observability = params?.observability_c;\n  }\n\n  get instance() {\n    if (!this._instance) {\n      this._instance = new CopilotRuntimeVNext(this.runtimeArgs);\n    }\n\n    return this._instance;\n  }\n\n  private assignEndpointsToAgents(\n    endpoints: CopilotRuntimeConstructorParams<T>[\"remoteEndpoints\"],\n  ): Record<string, AbstractAgent> {\n    let result: Record<string, AbstractAgent> = {};\n\n    if (\n      endpoints.some(\n        (endpoint) =>\n          resolveEndpointType(endpoint) == EndpointType.LangGraphPlatform,\n      )\n    ) {\n      throw new CopilotKitMisuseError({\n        message:\n          \"LangGraphPlatformEndpoint in remoteEndpoints is deprecated. \" +\n          'Please use the \"agents\" option instead with LangGraphAgent from \"@copilotkit/runtime/langgraph\". ' +\n          'Example: agents: { myAgent: new LangGraphAgent({ deploymentUrl: \"...\", graphId: \"...\" }) }',\n      });\n    }\n\n    return result;\n  }\n\n  handleServiceAdapter(serviceAdapter: CopilotServiceAdapter) {\n    this.runtimeArgs.agents = Promise.resolve(\n      this.runtimeArgs.agents ?? {},\n    ).then(async (agents) => {\n      // An AgentsFactory function has no enumerable keys, so it flows through\n      // this path the same way an empty record does.\n      let agentsList = agents as Record<string, AbstractAgent>;\n      const isAgentsListEmpty = !Object.keys(agents).length;\n      const hasServiceAdapter = Boolean(serviceAdapter);\n      const illegalServiceAdapterNames = [\"EmptyAdapter\"];\n      const serviceAdapterCanBeUsedForAgent =\n        !illegalServiceAdapterNames.includes(serviceAdapter.name);\n\n      if (\n        isAgentsListEmpty &&\n        (!hasServiceAdapter || !serviceAdapterCanBeUsedForAgent)\n      ) {\n        throw new CopilotKitMisuseError({\n          message:\n            \"No default agent provided. Please provide a default agent in the runtime config.\",\n        });\n      }\n\n      if (isAgentsListEmpty) {\n        const languageModel = serviceAdapter.getLanguageModel?.();\n        if (languageModel) {\n          // Adapter exposes a pre-configured LanguageModel (e.g. OpenAI/Anthropic adapters)\n          agentsList.default = new BuiltInAgent({ model: languageModel });\n        } else if (serviceAdapter.provider && serviceAdapter.model) {\n          // Adapter exposes provider/model strings\n          agentsList.default = new BuiltInAgent({\n            model: `${serviceAdapter.provider}/${serviceAdapter.model}`,\n          });\n        } else {\n          throw new CopilotKitMisuseError({\n            message:\n              `Service adapter \"${serviceAdapter.name ?? \"unknown\"}\" does not provide model information. ` +\n              `When using adapters like LangChainAdapter without an explicit agents list, ` +\n              `please provide a default agent in the runtime config. Example:\\n` +\n              `  new CopilotRuntime({\\n` +\n              `    agents: { default: new BuiltInAgent({ model: \"openai/gpt-4o\" }) }\\n` +\n              `  })`,\n          });\n        }\n      }\n\n      const actions = this.params?.actions;\n      if (actions) {\n        const mcpTools = await this.getToolsFromMCP();\n        agentsList = this.assignToolsToAgents(agentsList, [\n          ...this.getToolsFromActions(actions),\n          ...mcpTools,\n        ]);\n      }\n\n      return agentsList;\n    });\n  }\n\n  // Receive this.params.action and turn it into the AbstractAgent tools\n  private getToolsFromActions(\n    actions: ActionsConfiguration<any>,\n  ): BuiltInAgentClassicConfig[\"tools\"] {\n    // Resolve actions to an array (handle function case)\n    const actionsArray =\n      typeof actions === \"function\"\n        ? actions({ properties: {}, url: undefined })\n        : actions;\n\n    // Convert each Action to a ToolDefinition\n    return actionsArray.map((action) => {\n      // Convert JSON schema to Zod schema\n      const zodSchema = getZodParameters(action.parameters || []);\n\n      return {\n        name: action.name,\n        description: action.description || \"\",\n        parameters: zodSchema,\n        execute: () => Promise.resolve(),\n      };\n    });\n  }\n\n  private assignToolsToAgents(\n    agents: Record<string, AbstractAgent>,\n    tools: BuiltInAgentClassicConfig[\"tools\"],\n  ): Record<string, AbstractAgent> {\n    if (!tools?.length) {\n      return agents;\n    }\n\n    const enrichedAgents: Record<string, AbstractAgent> = { ...agents };\n\n    for (const [agentId, agent] of Object.entries(enrichedAgents)) {\n      const existingConfig = (Reflect.get(agent, \"config\") ?? {}) as Record<\n        string,\n        unknown\n      >;\n\n      // Skip factory-mode agents — they don't have a tools property\n      if (\"factory\" in existingConfig) {\n        continue;\n      }\n\n      const classicConfig =\n        existingConfig as unknown as BuiltInAgentClassicConfig;\n      const existingTools = classicConfig.tools ?? [];\n\n      const updatedConfig: BuiltInAgentClassicConfig = {\n        ...classicConfig,\n        tools: [...existingTools, ...tools],\n      };\n\n      Reflect.set(agent, \"config\", updatedConfig);\n      enrichedAgents[agentId] = agent;\n    }\n\n    return enrichedAgents;\n  }\n\n  private createOnBeforeRequestHandler(\n    params?: CopilotRuntimeConstructorParams<T> &\n      PartialBy<CopilotRuntimeOptions, \"agents\">,\n  ) {\n    return async (hookParams: BeforeRequestMiddlewareFnParameters[0]) => {\n      const { request } = hookParams;\n\n      // Capture telemetry for copilot request creation\n      const publicApiKey = request.headers.get(\"x-copilotcloud-public-api-key\");\n      const body = (await readBody(request)) as RunAgentInput;\n\n      const forwardedProps = body?.forwardedProps as\n        | {\n            cloud?: { guardrails?: unknown };\n            metadata?: { requestType?: string };\n          }\n        | undefined;\n\n      // Get cloud base URL from environment or default\n      const cloudBaseUrl =\n        process.env.COPILOT_CLOUD_BASE_URL || \"https://api.cloud.copilotkit.ai\";\n\n      telemetry.capture(\"oss.runtime.copilot_request_created\", {\n        \"cloud.guardrails.enabled\":\n          forwardedProps?.cloud?.guardrails !== undefined,\n        requestType: forwardedProps?.metadata?.requestType ?? \"unknown\",\n        \"cloud.api_key_provided\": !!publicApiKey,\n        ...(publicApiKey ? { \"cloud.public_api_key\": publicApiKey } : {}),\n        \"cloud.base_url\": cloudBaseUrl,\n      });\n\n      // We do not process middleware for the internal GET requests\n      if (request.method === \"GET\" || !body) return;\n\n      // TODO: get public api key and run with expected data\n      // if (this.observability?.enabled && this.params.publicApiKey) {\n      //   this.logObservabilityBeforeRequest()\n      // }\n\n      // TODO: replace hooksParams top argument type with BeforeRequestMiddlewareParameters when exported\n      const middlewareResult =\n        await params?.beforeRequestMiddleware?.(hookParams);\n\n      if (params?.middleware?.onBeforeRequest) {\n        const { request, runtime, path } = hookParams;\n        const gqlMessages = (aguiToGQL(body.messages) as Message[]).reduce(\n          (acc, msg) => {\n            if (\"role\" in msg && msg.role === \"user\") {\n              acc.inputMessages.push(msg);\n            } else {\n              acc.outputMessages.push(msg);\n            }\n            return acc;\n          },\n          { inputMessages: [] as Message[], outputMessages: [] as Message[] },\n        );\n        const { inputMessages, outputMessages } = gqlMessages;\n        params.middleware.onBeforeRequest({\n          threadId: body.threadId,\n          runId: body.runId,\n          inputMessages,\n          properties: body.forwardedProps,\n          url: request.url,\n        } satisfies OnBeforeRequestOptions);\n      }\n\n      return middlewareResult;\n    };\n  }\n\n  private createOnAfterRequestHandler(\n    params?: CopilotRuntimeConstructorParams<T> &\n      PartialBy<CopilotRuntimeOptions, \"agents\">,\n  ) {\n    return async (hookParams: AfterRequestMiddlewareFnParameters[0]) => {\n      // TODO: get public api key and run with expected data\n      // if (this.observability?.enabled && publicApiKey) {\n      //   this.logObservabilityAfterRequest()\n      // }\n\n      // TODO: replace hooksParams top argument type with AfterRequestMiddlewareParameters when exported\n      params?.afterRequestMiddleware?.(hookParams);\n\n      if (params?.middleware?.onAfterRequest) {\n        const messages = hookParams.messages ?? [];\n        params.middleware.onAfterRequest({\n          threadId: hookParams.threadId ?? \"\",\n          runId: hookParams.runId,\n          inputMessages: messages.filter(\n            (m): m is typeof m & { role: string } =>\n              \"role\" in m && m.role === \"user\",\n          ) as unknown as Message[],\n          outputMessages: messages.filter(\n            (m): m is typeof m & { role: string } =>\n              \"role\" in m && m.role !== \"user\",\n          ) as unknown as Message[],\n          // TODO: forward actual properties once the after-request hook has access to the request body\n          properties: {},\n          url: hookParams.path,\n        } satisfies OnAfterRequestOptions);\n      }\n    };\n  }\n\n  // Observability Methods\n\n  /**\n   * Log LLM request if observability is enabled\n   */\n  private async logObservabilityBeforeRequest(\n    requestData: LLMRequestData,\n  ): Promise<void> {\n    try {\n      await this.observability.hooks.handleRequest(requestData);\n    } catch (error) {\n      console.error(\"Error logging LLM request:\", error);\n    }\n  }\n\n  /**\n   * Log final LLM response after request completes\n   */\n  private logObservabilityAfterRequest(\n    outputMessagesPromise: Promise<Message[]>,\n    baseData: {\n      threadId: string;\n      runId?: string;\n      model?: string;\n      provider?: string;\n      agentName?: string;\n      nodeName?: string;\n    },\n    streamedChunks: any[],\n    requestStartTime: number,\n    publicApiKey?: string,\n  ): void {\n    try {\n      outputMessagesPromise\n        .then((outputMessages) => {\n          const responseData: LLMResponseData = {\n            threadId: baseData.threadId,\n            runId: baseData.runId,\n            model: baseData.model,\n            // Use collected chunks for progressive mode or outputMessages for regular mode\n            output: this.observability.progressive\n              ? streamedChunks\n              : outputMessages,\n            latency: Date.now() - requestStartTime,\n            timestamp: Date.now(),\n            provider: baseData.provider,\n            isFinalResponse: true,\n            agentName: baseData.agentName,\n            nodeName: baseData.nodeName,\n          };\n\n          try {\n            this.observability.hooks.handleResponse(responseData);\n          } catch (logError) {\n            console.error(\"Error logging LLM response:\", logError);\n          }\n        })\n        .catch((error) => {\n          console.error(\"Failed to get output messages for logging:\", error);\n        });\n    } catch (error) {\n      console.error(\"Error setting up logging for LLM response:\", error);\n    }\n  }\n\n  // Resolve MCP tools to BuiltInAgent tool definitions\n  // Optionally accepts request-scoped properties to merge request-provided mcpServers\n  private async getToolsFromMCP(options?: {\n    properties?: Record<string, unknown>;\n  }): Promise<BuiltInAgentClassicConfig[\"tools\"]> {\n    const runtimeMcpServers = (this.params?.mcpServers ??\n      []) as MCPEndpointConfig[];\n    const createMCPClient = this.params?.createMCPClient as\n      | CreateMCPClientFunction\n      | undefined;\n\n    // If no runtime config and no request overrides, nothing to do\n    const requestMcpServers = ((\n      options?.properties as { mcpServers?: MCPEndpointConfig[] } | undefined\n    )?.mcpServers ??\n      (\n        options?.properties as\n          | { mcpEndpoints?: MCPEndpointConfig[] }\n          | undefined\n      )?.mcpEndpoints ??\n      []) as MCPEndpointConfig[];\n\n    const hasAnyServers =\n      (runtimeMcpServers?.length ?? 0) > 0 ||\n      (requestMcpServers?.length ?? 0) > 0;\n    if (!hasAnyServers) {\n      return [];\n    }\n\n    if (!createMCPClient) {\n      // Mirror legacy behavior: when servers are provided without a factory, treat as misconfiguration\n      throw new CopilotKitMisuseError({\n        message:\n          \"MCP Integration Error: `mcpServers` were provided, but the `createMCPClient` function was not passed to the CopilotRuntime constructor. Please provide an implementation for `createMCPClient`.\",\n      });\n    }\n\n    // Merge and dedupe endpoints by URL; request-level overrides take precedence\n    const effectiveEndpoints = (() => {\n      const byUrl = new Map<string, MCPEndpointConfig>();\n      for (const ep of runtimeMcpServers) {\n        if (ep?.endpoint) byUrl.set(ep.endpoint, ep);\n      }\n      for (const ep of requestMcpServers) {\n        if (ep?.endpoint) byUrl.set(ep.endpoint, ep);\n      }\n      return Array.from(byUrl.values());\n    })();\n\n    const allTools: BuiltInAgentClassicConfig[\"tools\"] = [];\n\n    for (const config of effectiveEndpoints) {\n      const endpointUrl = config.endpoint;\n      // Return cached tool definitions when available\n      const cached = this.mcpToolsCache.get(endpointUrl);\n      if (cached) {\n        allTools.push(...cached);\n        continue;\n      }\n\n      try {\n        const client = await createMCPClient(config);\n        const toolsMap = await client.tools();\n\n        const toolDefs: BuiltInAgentClassicConfig[\"tools\"] = Object.entries(\n          toolsMap,\n        ).map(([toolName, tool]: [string, MCPTool]) => {\n          const params: Parameter[] = extractParametersFromSchema(tool);\n          const zodSchema = getZodParameters(params);\n          return {\n            name: toolName,\n            description:\n              tool.description || `MCP tool: ${toolName} (from ${endpointUrl})`,\n            parameters: zodSchema,\n            execute: () => Promise.resolve(),\n          };\n        });\n\n        // Cache per endpoint and add to aggregate\n        this.mcpToolsCache.set(endpointUrl, toolDefs);\n        allTools.push(...toolDefs);\n      } catch (error) {\n        console.error(\n          `MCP: Failed to fetch tools from endpoint ${endpointUrl}. Skipping. Error:`,\n          error,\n        );\n        // Cache empty to prevent repeated attempts within lifecycle\n        this.mcpToolsCache.set(endpointUrl, []);\n      }\n    }\n\n    // Dedupe tools by name while preserving last-in wins (request overrides)\n    const dedupedByName = new Map<string, (typeof allTools)[number]>();\n    for (const tool of allTools) {\n      dedupedByName.set(tool.name, tool);\n    }\n\n    return Array.from(dedupedByName.values());\n  }\n}\n\n// The two functions below are \"factory functions\", meant to create the action objects that adhere to the expected interfaces\nexport function copilotKitEndpoint(\n  config: Omit<CopilotKitEndpoint, \"type\">,\n): CopilotKitEndpoint {\n  return {\n    ...config,\n    type: EndpointType.CopilotKit,\n  };\n}\n\nexport function langGraphPlatformEndpoint(\n  config: Omit<LangGraphPlatformEndpoint, \"type\">,\n): LangGraphPlatformEndpoint {\n  return {\n    ...config,\n    type: EndpointType.LangGraphPlatform,\n  };\n}\n\nexport function resolveEndpointType(endpoint: EndpointDefinition) {\n  if (!endpoint.type) {\n    if (\"deploymentUrl\" in endpoint && \"agents\" in endpoint) {\n      return EndpointType.LangGraphPlatform;\n    } else {\n      return EndpointType.CopilotKit;\n    }\n  }\n\n  return endpoint.type;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8ZA,IAAa,iBAAb,MAAmE;CASjE,YAAY,QAA6C;uCAJvD,IAAI,KAAK;AAKT,8DAA+B;EAE/B,MAAM,SAAS,QAAQ,UAAU,EAAE;EACnC,MAAM,iBAAiB,KAAK,wBAC1B,QAAQ,mBAAmB,EAAE,CAC9B;EAKD,IAAI;AACJ,MAAI,OAAO,WAAW,WACpB,gBAAe,OAAO,QAAQ;GAC5B,MAAM,WAAW,MAAM,OAAO,IAAI;AAClC,UAAO;IAAE,GAAG;IAAgB,GAAG;IAAU;;MAG3C,gBAAe,QAAQ,QAAQ,OAAO,CAAC,MAAM,cAAc;GACzD,GAAG;GACH,GAAG;GACJ,EAAE;EAIL,MAAM,aAAa,QAAQ,UAAU,IAAIA,uCAAqB;EAK9D,MAAM,sDAA8B,GAChC,aACA,IAAIC,oDAAqB,EAAE,QAAQ,YAAY,CAAC;EAQpD,MAAM,uBACJ,QAAQ,gBAAgB,QAAQ,IAAI;AACtC,MAAI,qBACF,kCAAU,gBAAgB,qBAAqB;EAGjD,MAAM,oBAAoB;GACxB,QAAQ;GACR,cAAc,QAAQ;GACtB,OAAO,QAAQ;GAIf,yBACE,KAAK,6BAA6B,OAAO,CAAC,KAAK,KAAK;GACtD,GAAI,QAAQ,0BAA0B,QAAQ,YAAY,iBACtD,EACE,wBACE,KAAK,4BAA4B,OAAO,CAAC,KAAK,KAAK,EACtD,GACD,EAAE;GACN,MAAM,QAAQ;GACd,SAAS,QAAQ;GACjB,kBAAkB,QAAQ;IACzBC,4DAA6BC,0DAA2B,QAAQ,QAAQ;GACzE,gBAAgB,QAAQ;GACxB,oBAAoB,QAAQ;GAC7B;AACD,MAAI,QAAQ,iBAAiB,OAI3B,MAAK,cAAc;GACjB,GAAG;GACH,cAAc,OAAO;GACrB,cAAc,OAAO;GACrB,QAAQ,OAAO;GACf,UAAU,OAAO;GACjB,WAAW,OAAO;GAClB,qBAAqB,OAAO;GAC5B,gBAAgB,OAAO;GACvB,aAAa,OAAO;GACpB,gBAAgB,OAAO;GACvB,eAAe,OAAO;GACtB,8BAA8B,OAAO;GACtC;MAED,MAAK,cAAc;GACjB,GAAG;GACH;GACD;AAEH,OAAK,SAAS;AACd,OAAK,gBAAgB,QAAQ;;CAG/B,IAAI,WAAW;AACb,MAAI,CAAC,KAAK,UACR,MAAK,YAAY,IAAIC,iCAAoB,KAAK,YAAY;AAG5D,SAAO,KAAK;;CAGd,AAAQ,wBACN,WAC+B;EAC/B,IAAI,SAAwC,EAAE;AAE9C,MACE,UAAU,MACP,aACC,oBAAoB,SAAS,IAAIC,2BAAa,kBACjD,CAED,OAAM,IAAIC,yCAAsB,EAC9B,SACE,mQAGH,CAAC;AAGJ,SAAO;;CAGT,qBAAqB,gBAAuC;AAC1D,OAAK,YAAY,SAAS,QAAQ,QAChC,KAAK,YAAY,UAAU,EAAE,CAC9B,CAAC,KAAK,OAAO,WAAW;GAGvB,IAAI,aAAa;GACjB,MAAM,oBAAoB,CAAC,OAAO,KAAK,OAAO,CAAC;GAC/C,MAAM,oBAAoB,QAAQ,eAAe;GAEjD,MAAM,kCACJ,CAFiC,CAAC,eAAe,CAErB,SAAS,eAAe,KAAK;AAE3D,OACE,sBACC,CAAC,qBAAqB,CAAC,iCAExB,OAAM,IAAIA,yCAAsB,EAC9B,SACE,oFACH,CAAC;AAGJ,OAAI,mBAAmB;IACrB,MAAM,gBAAgB,eAAe,oBAAoB;AACzD,QAAI,cAEF,YAAW,UAAU,IAAIC,2BAAa,EAAE,OAAO,eAAe,CAAC;aACtD,eAAe,YAAY,eAAe,MAEnD,YAAW,UAAU,IAAIA,2BAAa,EACpC,OAAO,GAAG,eAAe,SAAS,GAAG,eAAe,SACrD,CAAC;QAEF,OAAM,IAAID,yCAAsB,EAC9B,SACE,oBAAoB,eAAe,QAAQ,UAAU,uRAMxD,CAAC;;GAIN,MAAM,UAAU,KAAK,QAAQ;AAC7B,OAAI,SAAS;IACX,MAAM,WAAW,MAAM,KAAK,iBAAiB;AAC7C,iBAAa,KAAK,oBAAoB,YAAY,CAChD,GAAG,KAAK,oBAAoB,QAAQ,EACpC,GAAG,SACJ,CAAC;;AAGJ,UAAO;IACP;;CAIJ,AAAQ,oBACN,SACoC;AAQpC,UALE,OAAO,YAAY,aACf,QAAQ;GAAE,YAAY,EAAE;GAAE,KAAK;GAAW,CAAC,GAC3C,SAGc,KAAK,WAAW;GAElC,MAAM,qDAA6B,OAAO,cAAc,EAAE,CAAC;AAE3D,UAAO;IACL,MAAM,OAAO;IACb,aAAa,OAAO,eAAe;IACnC,YAAY;IACZ,eAAe,QAAQ,SAAS;IACjC;IACD;;CAGJ,AAAQ,oBACN,QACA,OAC+B;AAC/B,MAAI,CAAC,OAAO,OACV,QAAO;EAGT,MAAM,iBAAgD,EAAE,GAAG,QAAQ;AAEnE,OAAK,MAAM,CAAC,SAAS,UAAU,OAAO,QAAQ,eAAe,EAAE;GAC7D,MAAM,iBAAkB,QAAQ,IAAI,OAAO,SAAS,IAAI,EAAE;AAM1D,OAAI,aAAa,eACf;GAGF,MAAM,gBACJ;GACF,MAAM,gBAAgB,cAAc,SAAS,EAAE;GAE/C,MAAM,gBAA2C;IAC/C,GAAG;IACH,OAAO,CAAC,GAAG,eAAe,GAAG,MAAM;IACpC;AAED,WAAQ,IAAI,OAAO,UAAU,cAAc;AAC3C,kBAAe,WAAW;;AAG5B,SAAO;;CAGT,AAAQ,6BACN,QAEA;AACA,SAAO,OAAO,eAAuD;GACnE,MAAM,EAAE,YAAY;GAGpB,MAAM,eAAe,QAAQ,QAAQ,IAAI,gCAAgC;GACzE,MAAM,OAAQ,uCAAe,QAAQ;GAErC,MAAM,iBAAiB,MAAM;GAQ7B,MAAM,eACJ,QAAQ,IAAI,0BAA0B;AAExC,oCAAU,QAAQ,uCAAuC;IACvD,4BACE,gBAAgB,OAAO,eAAe;IACxC,aAAa,gBAAgB,UAAU,eAAe;IACtD,0BAA0B,CAAC,CAAC;IAC5B,GAAI,eAAe,EAAE,wBAAwB,cAAc,GAAG,EAAE;IAChE,kBAAkB;IACnB,CAAC;AAGF,OAAI,QAAQ,WAAW,SAAS,CAAC,KAAM;GAQvC,MAAM,mBACJ,MAAM,QAAQ,0BAA0B,WAAW;AAErD,OAAI,QAAQ,YAAY,iBAAiB;IACvC,MAAM,EAAE,SAAS,SAAS,SAAS;IAYnC,MAAM,EAAE,eAAe,mBAXFE,8BAAU,KAAK,SAAS,CAAe,QACzD,KAAK,QAAQ;AACZ,SAAI,UAAU,OAAO,IAAI,SAAS,OAChC,KAAI,cAAc,KAAK,IAAI;SAE3B,KAAI,eAAe,KAAK,IAAI;AAE9B,YAAO;OAET;KAAE,eAAe,EAAE;KAAe,gBAAgB,EAAE;KAAe,CACpE;AAED,WAAO,WAAW,gBAAgB;KAChC,UAAU,KAAK;KACf,OAAO,KAAK;KACZ;KACA,YAAY,KAAK;KACjB,KAAK,QAAQ;KACd,CAAkC;;AAGrC,UAAO;;;CAIX,AAAQ,4BACN,QAEA;AACA,SAAO,OAAO,eAAsD;AAOlE,WAAQ,yBAAyB,WAAW;AAE5C,OAAI,QAAQ,YAAY,gBAAgB;IACtC,MAAM,WAAW,WAAW,YAAY,EAAE;AAC1C,WAAO,WAAW,eAAe;KAC/B,UAAU,WAAW,YAAY;KACjC,OAAO,WAAW;KAClB,eAAe,SAAS,QACrB,MACC,UAAU,KAAK,EAAE,SAAS,OAC7B;KACD,gBAAgB,SAAS,QACtB,MACC,UAAU,KAAK,EAAE,SAAS,OAC7B;KAED,YAAY,EAAE;KACd,KAAK,WAAW;KACjB,CAAiC;;;;;;;CAUxC,MAAc,8BACZ,aACe;AACf,MAAI;AACF,SAAM,KAAK,cAAc,MAAM,cAAc,YAAY;WAClD,OAAO;AACd,WAAQ,MAAM,8BAA8B,MAAM;;;;;;CAOtD,AAAQ,6BACN,uBACA,UAQA,gBACA,kBACA,cACM;AACN,MAAI;AACF,yBACG,MAAM,mBAAmB;IACxB,MAAM,eAAgC;KACpC,UAAU,SAAS;KACnB,OAAO,SAAS;KAChB,OAAO,SAAS;KAEhB,QAAQ,KAAK,cAAc,cACvB,iBACA;KACJ,SAAS,KAAK,KAAK,GAAG;KACtB,WAAW,KAAK,KAAK;KACrB,UAAU,SAAS;KACnB,iBAAiB;KACjB,WAAW,SAAS;KACpB,UAAU,SAAS;KACpB;AAED,QAAI;AACF,UAAK,cAAc,MAAM,eAAe,aAAa;aAC9C,UAAU;AACjB,aAAQ,MAAM,+BAA+B,SAAS;;KAExD,CACD,OAAO,UAAU;AAChB,YAAQ,MAAM,8CAA8C,MAAM;KAClE;WACG,OAAO;AACd,WAAQ,MAAM,8CAA8C,MAAM;;;CAMtE,MAAc,gBAAgB,SAEkB;EAC9C,MAAM,oBAAqB,KAAK,QAAQ,cACtC,EAAE;EACJ,MAAM,kBAAkB,KAAK,QAAQ;EAKrC,MAAM,qBACJ,SAAS,aACR,eAEC,SAAS,aAGR,gBACH,EAAE;AAKJ,MAAI,GAFD,mBAAmB,UAAU,KAAK,MAClC,mBAAmB,UAAU,KAAK,GAEnC,QAAO,EAAE;AAGX,MAAI,CAAC,gBAEH,OAAM,IAAIF,yCAAsB,EAC9B,SACE,mMACH,CAAC;EAIJ,MAAM,4BAA4B;GAChC,MAAM,wBAAQ,IAAI,KAAgC;AAClD,QAAK,MAAM,MAAM,kBACf,KAAI,IAAI,SAAU,OAAM,IAAI,GAAG,UAAU,GAAG;AAE9C,QAAK,MAAM,MAAM,kBACf,KAAI,IAAI,SAAU,OAAM,IAAI,GAAG,UAAU,GAAG;AAE9C,UAAO,MAAM,KAAK,MAAM,QAAQ,CAAC;MAC/B;EAEJ,MAAM,WAA+C,EAAE;AAEvD,OAAK,MAAM,UAAU,oBAAoB;GACvC,MAAM,cAAc,OAAO;GAE3B,MAAM,SAAS,KAAK,cAAc,IAAI,YAAY;AAClD,OAAI,QAAQ;AACV,aAAS,KAAK,GAAG,OAAO;AACxB;;AAGF,OAAI;IAEF,MAAM,WAAW,OADF,MAAM,gBAAgB,OAAO,EACd,OAAO;IAErC,MAAM,WAA+C,OAAO,QAC1D,SACD,CAAC,KAAK,CAAC,UAAU,UAA6B;KAE7C,MAAM,qDADsBG,oDAA4B,KAAK,CACnB;AAC1C,YAAO;MACL,MAAM;MACN,aACE,KAAK,eAAe,aAAa,SAAS,SAAS,YAAY;MACjE,YAAY;MACZ,eAAe,QAAQ,SAAS;MACjC;MACD;AAGF,SAAK,cAAc,IAAI,aAAa,SAAS;AAC7C,aAAS,KAAK,GAAG,SAAS;YACnB,OAAO;AACd,YAAQ,MACN,4CAA4C,YAAY,qBACxD,MACD;AAED,SAAK,cAAc,IAAI,aAAa,EAAE,CAAC;;;EAK3C,MAAM,gCAAgB,IAAI,KAAwC;AAClE,OAAK,MAAM,QAAQ,SACjB,eAAc,IAAI,KAAK,MAAM,KAAK;AAGpC,SAAO,MAAM,KAAK,cAAc,QAAQ,CAAC;;;AAK7C,SAAgB,mBACd,QACoB;AACpB,QAAO;EACL,GAAG;EACH,MAAMJ,2BAAa;EACpB;;AAGH,SAAgB,0BACd,QAC2B;AAC3B,QAAO;EACL,GAAG;EACH,MAAMA,2BAAa;EACpB;;AAGH,SAAgB,oBAAoB,UAA8B;AAChE,KAAI,CAAC,SAAS,KACZ,KAAI,mBAAmB,YAAY,YAAY,SAC7C,QAAOA,2BAAa;KAEpB,QAAOA,2BAAa;AAIxB,QAAO,SAAS"}

package/dist/lib/runtime/copilot-runtime.d.cts

@@ -13,7 +13,7 @@ import { MCPClient, MCPEndpointConfig } from "./mcp-tools-utils.cjs";
 import { Action, CopilotErrorHandler, DebugConfig, Parameter } from "@copilotkit/shared";
 import { AbstractAgent } from "@ag-ui/client";
 
-//#region src/lib/runtime/copilot-runtime.d.ts
+//#region src/v1-deprecated/lib/runtime/copilot-runtime.d.ts
 type CreateMCPClientFunction = (config: MCPEndpointConfig) => Promise<MCPClient>;
 type ActionsConfiguration<T extends Parameter[] | [] = []> = Action<T>[] | ((ctx: {
   properties: any;
@@ -203,6 +203,14 @@ interface CopilotRuntimeConstructorParams<T extends Parameter[] | [] = []> exten
 }
 /**
  * Central runtime object passed to all request handlers.
+ * @deprecated The v1 SDK is deprecated. Use v2 instead. Use `CopilotRuntime` from `@copilotkit/runtime/v2` instead.
+ *
+ * ```tsx
+ * import { CopilotRuntime } from "@copilotkit/runtime/v2";
+ *
+ * const runtime = new CopilotRuntime({ agents: {} });
+ * ```
+ * See https://docs.copilotkit.ai/runtime-server-adapter
  */
 declare class CopilotRuntime<const T extends Parameter[] | [] = []> {
   params?: CopilotRuntimeConstructorParams<T>;

package/dist/lib/runtime/copilot-runtime.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"copilot-runtime.d.cts","names":[],"sources":["../../../src/lib/runtime/copilot-runtime.ts"],"mappings":"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"}
+{"version":3,"file":"copilot-runtime.d.cts","names":[],"sources":["../../../../src/v1-deprecated/lib/runtime/copilot-runtime.ts"],"mappings":"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"}

package/dist/lib/runtime/copilot-runtime.d.mts

@@ -13,7 +13,7 @@ import { MCPClient, MCPEndpointConfig } from "./mcp-tools-utils.mjs";
 import { Action, CopilotErrorHandler, DebugConfig, Parameter } from "@copilotkit/shared";
 import { AbstractAgent } from "@ag-ui/client";
 
-//#region src/lib/runtime/copilot-runtime.d.ts
+//#region src/v1-deprecated/lib/runtime/copilot-runtime.d.ts
 type CreateMCPClientFunction = (config: MCPEndpointConfig) => Promise<MCPClient>;
 type ActionsConfiguration<T extends Parameter[] | [] = []> = Action<T>[] | ((ctx: {
   properties: any;
@@ -203,6 +203,14 @@ interface CopilotRuntimeConstructorParams<T extends Parameter[] | [] = []> exten
 }
 /**
  * Central runtime object passed to all request handlers.
+ * @deprecated The v1 SDK is deprecated. Use v2 instead. Use `CopilotRuntime` from `@copilotkit/runtime/v2` instead.
+ *
+ * ```tsx
+ * import { CopilotRuntime } from "@copilotkit/runtime/v2";
+ *
+ * const runtime = new CopilotRuntime({ agents: {} });
+ * ```
+ * See https://docs.copilotkit.ai/runtime-server-adapter
  */
 declare class CopilotRuntime<const T extends Parameter[] | [] = []> {
   params?: CopilotRuntimeConstructorParams<T>;