@copilotkit/runtime 1.56.4-canary.1777538870 → 1.56.5

package/src/lib/runtime/agent-integrations/langgraph/agent.ts

@@ -154,7 +154,14 @@ export class LangGraphAgent extends AGUILangGraphAgent {
 
   // @ts-ignore
   run(input: RunAgentInput): Observable<BaseEvent> {
-    return super.run(input).pipe(
+    const enrichedInput = {
+      ...input,
+      forwardedProps: {
+        ...input.forwardedProps,
+        streamSubgraphs: input.forwardedProps?.streamSubgraphs ?? true,
+      },
+    };
+    return super.run(enrichedInput).pipe(
       map((processedEvent) => {
         // Turn raw event into emit state snapshot from tool call event
         if (processedEvent.type === EventType.RAW) {

package/src/v2/runtime/__tests__/express-fetch-bridge.test.ts

@@ -23,7 +23,7 @@ function createApp(
     app.use(express.json());
   }
 
-  app.all("/{*splat}", (req, res) => nodeHandler(req, res));
+  app.all(/.*/, (req, res) => nodeHandler(req, res));
   return app;
 }
 

package/src/v2/runtime/endpoints/express.ts

@@ -147,15 +147,21 @@ export function createCopilotExpressHandler({
     router.post(normalizedBase, expressHandler);
     router.options(normalizedBase, expressHandler);
   } else if (normalizedBase === "/") {
-    router.all("{*splat}", expressHandler);
+    router.all(/.*/, expressHandler);
   } else {
-    router.all(`${normalizedBase}/{*splat}`, expressHandler);
-    router.all(normalizedBase, expressHandler);
+    router.all(
+      new RegExp(`^${escapeRegExp(normalizedBase)}(\\/.*)?$`),
+      expressHandler,
+    );
   }
 
   return router;
 }
 
+function escapeRegExp(s: string): string {
+  return s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+
 function normalizeBasePath(path: string): string {
   if (!path) {
     throw new Error("basePath must be provided for Express endpoint");

package/src/v2/runtime/handlers/intelligence/run.ts

@@ -80,15 +80,6 @@ export async function handleIntelligenceRun({
   }
   const userId = user.id;
 
-  // Surface the resolved user on the agent so MCP header resolvers (and any
-  // other per-run consumer) can read it via context. Snapshotted by the
-  // BuiltInAgent at run-start; runs that don't go through this Intelligence
-  // path leave `agent.user` undefined.
-  (agent as unknown as { user?: { id: string; name: string } }).user = {
-    id: user.id,
-    name: user.name,
-  };
-
   try {
     const { thread, created } = await runtime.intelligence.getOrCreateThread({
       threadId: input.threadId,

package/src/v2/runtime/handlers/shared/agent-utils.ts

@@ -13,7 +13,6 @@ import { logger } from "@copilotkit/shared";
 type MiddlewareCapableAgent = AbstractAgent & {
   use?: (middleware: unknown) => void;
   headers?: Record<string, string>;
-  user?: { id: string; name: string };
 };
 
 export interface RunAgentParameters {

package/src/v2/runtime/index.ts

@@ -19,11 +19,6 @@ export {
   type UpdateThreadRequest,
 } from "./intelligence-platform";
 
-// Re-export `@ai-sdk/mcp` stable types so consumers don't need to depend on
-// it directly to type their MCP wiring. `MCPClient` is the value users pass
-// into `mcpClients`; `MCPTransport` is the contract for custom transports.
-export type { MCPClient, MCPTransport } from "@ai-sdk/mcp";
-
 // Export framework-agnostic fetch handler
 export { createCopilotRuntimeHandler } from "./core/fetch-handler";
 export type {

package/src/v2/runtime/intelligence-platform/client.ts

@@ -1,12 +1,4 @@
 import { logger } from "@copilotkit/shared";
-import type { MCPClientConfigHTTP } from "../../../agent";
-
-// Header name carrying the per-call end-user identity that the CopilotKit
-// Intelligence `/mcp` endpoint requires. Encapsulated inside the helper so
-// users of `intelligence.toMCPServer()` never need to know the wire-level
-// header name — they configure `identifyUser` once on the runtime and the
-// helper does the rest.
-const INTELLIGENCE_USER_ID_HEADER = "x-cpki-user-id";
 
 /**
  * Error thrown when an Intelligence platform HTTP request returns a non-2xx
@@ -348,65 +340,6 @@ export class CopilotKitIntelligence {
     return this.#apiKey;
   }
 
-  /**
-   * Build an MCP-server config pre-wired for this Intelligence platform
-   * connection. Drop the result into a `BuiltInAgent`'s `mcpServers` to give
-   * the agent access to Intel's bash + thread tools with both auth axes
-   * correctly populated:
-   *
-   * - `Authorization: Bearer <apiKey>` is stamped on every outbound request
-   *   from this Intelligence client's project key.
-   * - `X-Cpki-User-Id` is read fresh per call from the agent's resolved user,
-   *   which is populated by the runtime's `identifyUser` callback. The
-   *   helper does not surface the header name to user code.
-   *
-   * @example
-   * ```ts
-   * const intelligence = new CopilotKitIntelligence({
-   *   apiUrl: "https://api.copilotkit.ai",
-   *   wsUrl:  "wss://api.copilotkit.ai",
-   *   apiKey: process.env.INTELLIGENCE_API_KEY!,
-   * });
-   *
-   * const runtime = new CopilotRuntime({
-   *   intelligence,
-   *   identifyUser: (request) => resolveUserFromSession(request),
-   *   agents: {
-   *     myAgent: new BuiltInAgent({
-   *       model: "openai/gpt-4o",
-   *       mcpServers: [intelligence.toMCPServer()],
-   *     }),
-   *   },
-   * });
-   * ```
-   *
-   * The resolver throws if no user is present — typically the runtime is
-   * misconfigured (no `identifyUser`) or `identifyUser` returned an invalid
-   * id. Silent fallthrough to an empty user-id would collapse every browser
-   * session for this project into one shared bash sandbox, which is the
-   * very isolation guarantee the per-call header exists to enforce.
-   */
-  toMCPServer(): MCPClientConfigHTTP {
-    const apiKey = this.#apiKey;
-    const url = `${this.#apiUrl}/mcp`;
-    return {
-      type: "http",
-      url,
-      headers: { Authorization: `Bearer ${apiKey}` },
-      getHeaders: ({ user }) => {
-        const userId = user?.id?.trim();
-        if (!userId) {
-          throw new Error(
-            "CopilotKitIntelligence.toMCPServer(): no user resolved for this run. " +
-              "Configure `identifyUser` on the CopilotRuntime so the agent " +
-              "knows which end-user each MCP call is on behalf of.",
-          );
-        }
-        return { [INTELLIGENCE_USER_ID_HEADER]: userId };
-      },
-    };
-  }
-
   async #request<T>(method: string, path: string, body?: unknown): Promise<T> {
     const url = `${this.#apiUrl}${path}`;
 

package/dist/agent/mcp-transport.cjs

@@ -1,94 +0,0 @@
-require("reflect-metadata");
-const require_runtime = require('../_virtual/_rolldown/runtime.cjs');
-let _modelcontextprotocol_sdk_client_streamableHttp_js = require("@modelcontextprotocol/sdk/client/streamableHttp.js");
-
-//#region src/agent/mcp-transport.ts
-/**
-* Thrown when an MCP {@link MCPClientConfigHTTP.getHeaders} resolver throws.
-* Wraps the underlying error so `RUN_ERROR` carries clear attribution instead
-* of a generic transport failure. The original error is preserved on the
-* standard ES2022 `Error.cause` chain.
-*/
-var MCPHeaderResolverError = class extends Error {
-	constructor(message, cause) {
-		super(message, { cause });
-		this.name = "MCPHeaderResolverError";
-	}
-};
-/**
-* MCP transport for CopilotKit's BuiltInAgent that adds per-call header
-* resolution on top of the standard Streamable HTTP transport.
-*
-* Implements `@ai-sdk/mcp`'s {@link MCPTransport} interface so it can be
-* passed straight to `createMCPClient({ transport })`. Internally delegates
-* to `@modelcontextprotocol/sdk`'s `StreamableHTTPClientTransport` with a
-* wrapped `fetch` that runs the static-header + per-call resolver pipeline
-* before each outbound request.
-*/
-var CopilotKitMCPTransport = class {
-	constructor(options) {
-		const transportOptions = {
-			...options.options,
-			fetch: buildWrappedFetch(options)
-		};
-		this.inner = new _modelcontextprotocol_sdk_client_streamableHttp_js.StreamableHTTPClientTransport(new URL(options.url), transportOptions);
-	}
-	get onclose() {
-		return this.inner.onclose;
-	}
-	set onclose(handler) {
-		this.inner.onclose = handler;
-	}
-	get onerror() {
-		return this.inner.onerror;
-	}
-	set onerror(handler) {
-		this.inner.onerror = handler;
-	}
-	get onmessage() {
-		return this.inner.onmessage;
-	}
-	set onmessage(handler) {
-		this.inner.onmessage = handler;
-	}
-	start() {
-		return this.inner.start();
-	}
-	send(message) {
-		return this.inner.send(message);
-	}
-	close() {
-		return this.inner.close();
-	}
-};
-function buildWrappedFetch(options) {
-	const { headers: staticHeaders, getHeaders, requestHeaders, input, url: mcpServerUrl, user, options: transportOptions } = options;
-	const baseFetch = transportOptions?.fetch ?? globalThis.fetch;
-	return async (fetchUrl, init) => {
-		const merged = new Headers(init?.headers);
-		if (staticHeaders) for (const [key, value] of Object.entries(staticHeaders)) merged.set(key, value);
-		if (getHeaders) {
-			let resolved;
-			try {
-				resolved = await getHeaders({
-					requestHeaders,
-					input,
-					mcpServerUrl,
-					user
-				});
-			} catch (err) {
-				throw new MCPHeaderResolverError(`MCP header resolver for ${mcpServerUrl} threw: ${err instanceof Error ? err.message : String(err)}`, err);
-			}
-			for (const [key, value] of Object.entries(resolved)) merged.set(key, value);
-		}
-		return baseFetch(fetchUrl, {
-			...init,
-			headers: merged
-		});
-	};
-}
-
-//#endregion
-exports.CopilotKitMCPTransport = CopilotKitMCPTransport;
-exports.MCPHeaderResolverError = MCPHeaderResolverError;
-//# sourceMappingURL=mcp-transport.cjs.map

package/dist/agent/mcp-transport.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"mcp-transport.cjs","names":["StreamableHTTPClientTransport"],"sources":["../../src/agent/mcp-transport.ts"],"sourcesContent":["import type { RunAgentInput } from \"@ag-ui/client\";\nimport type { JSONRPCMessage, MCPTransport } from \"@ai-sdk/mcp\";\nimport { StreamableHTTPClientTransport } from \"@modelcontextprotocol/sdk/client/streamableHttp.js\";\nimport type { StreamableHTTPClientTransportOptions } from \"@modelcontextprotocol/sdk/client/streamableHttp.js\";\nimport type { FetchLike } from \"@modelcontextprotocol/sdk/shared/transport.js\";\n\n/**\n * The end-user identity resolved by the runtime's `identifyUser` callback for\n * the current request. Surfaced on {@link MCPRequestContext} so MCP header\n * resolvers can read it without re-doing auth work.\n */\nexport interface MCPRuntimeUser {\n  id: string;\n  name: string;\n}\n\n/**\n * Context handed to {@link MCPClientConfigHTTP.getHeaders} on every outbound\n * MCP HTTP request. The resolver is invoked fresh per request — initialize,\n * tools/list, tools/call, and reconnects — so values it depends on are never\n * cached across calls.\n */\nexport interface MCPRequestContext {\n  /**\n   * Headers forwarded onto the agent for this run. Populated by the runtime's\n   * `extractForwardableHeaders` (`authorization` + every `x-*` header from the\n   * incoming HTTP request). Keys are lower-cased.\n   */\n  requestHeaders: Record<string, string>;\n  /** The {@link RunAgentInput} the agent is currently running. */\n  input: RunAgentInput;\n  /** URL of the MCP server this request is going to. */\n  mcpServerUrl: string;\n  /**\n   * The end-user identity for this run, resolved by the runtime's\n   * `identifyUser` callback (only populated when the agent is run via a\n   * `CopilotRuntime` configured with `identifyUser`). Snapshotted at\n   * run-start.\n   */\n  user?: MCPRuntimeUser;\n}\n\n/**\n * Thrown when an MCP {@link MCPClientConfigHTTP.getHeaders} resolver throws.\n * Wraps the underlying error so `RUN_ERROR` carries clear attribution instead\n * of a generic transport failure. The original error is preserved on the\n * standard ES2022 `Error.cause` chain.\n */\nexport class MCPHeaderResolverError extends Error {\n  constructor(message: string, cause: unknown) {\n    super(message, { cause });\n    this.name = \"MCPHeaderResolverError\";\n  }\n}\n\nexport interface CopilotKitMCPTransportOptions {\n  /** URL of the MCP server. */\n  url: string;\n  /** Static HTTP headers, merged into every outbound request. */\n  headers?: Record<string, string>;\n  /**\n   * Per-call header resolver. Invoked on **every** outbound HTTP request to\n   * this server (initialize, tools/list, tools/call, reconnects). Returned\n   * headers are merged on top of `headers`, so a resolver can override either.\n   */\n  getHeaders?: (\n    ctx: MCPRequestContext,\n  ) => Record<string, string> | Promise<Record<string, string>>;\n  /**\n   * Pre-existing escape hatch: low-level options for the underlying\n   * `StreamableHTTPClientTransport`. Forwarded as-is, except `fetch` is\n   * wrapped so static `headers` and `getHeaders` resolution still apply.\n   */\n  options?: StreamableHTTPClientTransportOptions;\n  /** Snapshot of the agent's per-run forwarded headers, captured at run-start. */\n  requestHeaders: Record<string, string>;\n  /** RunAgentInput for the current run, exposed to the resolver via context. */\n  input: RunAgentInput;\n  /** Per-run end-user identity from the runtime's `identifyUser`, if set. */\n  user?: MCPRuntimeUser;\n}\n\n/**\n * MCP transport for CopilotKit's BuiltInAgent that adds per-call header\n * resolution on top of the standard Streamable HTTP transport.\n *\n * Implements `@ai-sdk/mcp`'s {@link MCPTransport} interface so it can be\n * passed straight to `createMCPClient({ transport })`. Internally delegates\n * to `@modelcontextprotocol/sdk`'s `StreamableHTTPClientTransport` with a\n * wrapped `fetch` that runs the static-header + per-call resolver pipeline\n * before each outbound request.\n */\nexport class CopilotKitMCPTransport implements MCPTransport {\n  private readonly inner: StreamableHTTPClientTransport;\n\n  constructor(options: CopilotKitMCPTransportOptions) {\n    const transportOptions: StreamableHTTPClientTransportOptions = {\n      ...options.options,\n      fetch: buildWrappedFetch(options),\n    };\n    this.inner = new StreamableHTTPClientTransport(\n      new URL(options.url),\n      transportOptions,\n    );\n  }\n\n  get onclose(): (() => void) | undefined {\n    return this.inner.onclose;\n  }\n  set onclose(handler: (() => void) | undefined) {\n    this.inner.onclose = handler;\n  }\n\n  get onerror(): ((error: Error) => void) | undefined {\n    return this.inner.onerror;\n  }\n  set onerror(handler: ((error: Error) => void) | undefined) {\n    this.inner.onerror = handler;\n  }\n\n  get onmessage(): ((message: JSONRPCMessage) => void) | undefined {\n    return this.inner.onmessage as\n      | ((message: JSONRPCMessage) => void)\n      | undefined;\n  }\n  set onmessage(handler: ((message: JSONRPCMessage) => void) | undefined) {\n    this.inner.onmessage = handler as\n      | ((message: JSONRPCMessage) => void)\n      | undefined;\n  }\n\n  start(): Promise<void> {\n    return this.inner.start();\n  }\n\n  send(message: JSONRPCMessage): Promise<void> {\n    return this.inner.send(message as Parameters<typeof this.inner.send>[0]);\n  }\n\n  close(): Promise<void> {\n    return this.inner.close();\n  }\n}\n\nfunction buildWrappedFetch(options: CopilotKitMCPTransportOptions): FetchLike {\n  const {\n    headers: staticHeaders,\n    getHeaders,\n    requestHeaders,\n    input,\n    url: mcpServerUrl,\n    user,\n    options: transportOptions,\n  } = options;\n  const baseFetch: FetchLike = transportOptions?.fetch ?? globalThis.fetch;\n\n  return async (fetchUrl, init) => {\n    // SDK passes a Headers instance via init.headers — start fresh from it so\n    // we don't mutate the SDK's object, then layer headers on top via .set()\n    // (last write wins).\n    const merged = new Headers(init?.headers);\n    if (staticHeaders) {\n      for (const [key, value] of Object.entries(staticHeaders)) {\n        merged.set(key, value);\n      }\n    }\n    if (getHeaders) {\n      let resolved: Record<string, string>;\n      try {\n        resolved = await getHeaders({\n          requestHeaders,\n          input,\n          mcpServerUrl,\n          user,\n        });\n      } catch (err) {\n        throw new MCPHeaderResolverError(\n          `MCP header resolver for ${mcpServerUrl} threw: ${\n            err instanceof Error ? err.message : String(err)\n          }`,\n          err,\n        );\n      }\n      for (const [key, value] of Object.entries(resolved)) {\n        merged.set(key, value);\n      }\n    }\n    return baseFetch(fetchUrl, { ...init, headers: merged });\n  };\n}\n"],"mappings":";;;;;;;;;;;AAgDA,IAAa,yBAAb,cAA4C,MAAM;CAChD,YAAY,SAAiB,OAAgB;AAC3C,QAAM,SAAS,EAAE,OAAO,CAAC;AACzB,OAAK,OAAO;;;;;;;;;;;;;AAyChB,IAAa,yBAAb,MAA4D;CAG1D,YAAY,SAAwC;EAClD,MAAM,mBAAyD;GAC7D,GAAG,QAAQ;GACX,OAAO,kBAAkB,QAAQ;GAClC;AACD,OAAK,QAAQ,IAAIA,iFACf,IAAI,IAAI,QAAQ,IAAI,EACpB,iBACD;;CAGH,IAAI,UAAoC;AACtC,SAAO,KAAK,MAAM;;CAEpB,IAAI,QAAQ,SAAmC;AAC7C,OAAK,MAAM,UAAU;;CAGvB,IAAI,UAAgD;AAClD,SAAO,KAAK,MAAM;;CAEpB,IAAI,QAAQ,SAA+C;AACzD,OAAK,MAAM,UAAU;;CAGvB,IAAI,YAA6D;AAC/D,SAAO,KAAK,MAAM;;CAIpB,IAAI,UAAU,SAA0D;AACtE,OAAK,MAAM,YAAY;;CAKzB,QAAuB;AACrB,SAAO,KAAK,MAAM,OAAO;;CAG3B,KAAK,SAAwC;AAC3C,SAAO,KAAK,MAAM,KAAK,QAAiD;;CAG1E,QAAuB;AACrB,SAAO,KAAK,MAAM,OAAO;;;AAI7B,SAAS,kBAAkB,SAAmD;CAC5E,MAAM,EACJ,SAAS,eACT,YACA,gBACA,OACA,KAAK,cACL,MACA,SAAS,qBACP;CACJ,MAAM,YAAuB,kBAAkB,SAAS,WAAW;AAEnE,QAAO,OAAO,UAAU,SAAS;EAI/B,MAAM,SAAS,IAAI,QAAQ,MAAM,QAAQ;AACzC,MAAI,cACF,MAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,cAAc,CACtD,QAAO,IAAI,KAAK,MAAM;AAG1B,MAAI,YAAY;GACd,IAAI;AACJ,OAAI;AACF,eAAW,MAAM,WAAW;KAC1B;KACA;KACA;KACA;KACD,CAAC;YACK,KAAK;AACZ,UAAM,IAAI,uBACR,2BAA2B,aAAa,UACtC,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI,IAElD,IACD;;AAEH,QAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,SAAS,CACjD,QAAO,IAAI,KAAK,MAAM;;AAG1B,SAAO,UAAU,UAAU;GAAE,GAAG;GAAM,SAAS;GAAQ,CAAC"}

package/dist/agent/mcp-transport.d.cts

@@ -1,51 +0,0 @@
-
-import { RunAgentInput } from "@ag-ui/client";
-import { StreamableHTTPClientTransportOptions } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
-
-//#region src/agent/mcp-transport.d.ts
-/**
- * The end-user identity resolved by the runtime's `identifyUser` callback for
- * the current request. Surfaced on {@link MCPRequestContext} so MCP header
- * resolvers can read it without re-doing auth work.
- */
-interface MCPRuntimeUser {
-  id: string;
-  name: string;
-}
-/**
- * Context handed to {@link MCPClientConfigHTTP.getHeaders} on every outbound
- * MCP HTTP request. The resolver is invoked fresh per request — initialize,
- * tools/list, tools/call, and reconnects — so values it depends on are never
- * cached across calls.
- */
-interface MCPRequestContext {
-  /**
-   * Headers forwarded onto the agent for this run. Populated by the runtime's
-   * `extractForwardableHeaders` (`authorization` + every `x-*` header from the
-   * incoming HTTP request). Keys are lower-cased.
-   */
-  requestHeaders: Record<string, string>;
-  /** The {@link RunAgentInput} the agent is currently running. */
-  input: RunAgentInput;
-  /** URL of the MCP server this request is going to. */
-  mcpServerUrl: string;
-  /**
-   * The end-user identity for this run, resolved by the runtime's
-   * `identifyUser` callback (only populated when the agent is run via a
-   * `CopilotRuntime` configured with `identifyUser`). Snapshotted at
-   * run-start.
-   */
-  user?: MCPRuntimeUser;
-}
-/**
- * Thrown when an MCP {@link MCPClientConfigHTTP.getHeaders} resolver throws.
- * Wraps the underlying error so `RUN_ERROR` carries clear attribution instead
- * of a generic transport failure. The original error is preserved on the
- * standard ES2022 `Error.cause` chain.
- */
-declare class MCPHeaderResolverError extends Error {
-  constructor(message: string, cause: unknown);
-}
-//#endregion
-export { MCPHeaderResolverError, MCPRequestContext };
-//# sourceMappingURL=mcp-transport.d.cts.map

package/dist/agent/mcp-transport.d.cts.map

@@ -1 +0,0 @@
-{"version":3,"file":"mcp-transport.d.cts","names":[],"sources":["../../src/agent/mcp-transport.ts"],"mappings":";;;;;;AAWA;;;;UAAiB,cAAA;EACf,EAAA;EACA,IAAA;AAAA;;;;;;;UASe,iBAAA;EAQf;;;;;EAFA,cAAA,EAAgB,MAAA;EAWK;EATrB,KAAA,EAAO,aAAA;EAkB2B;EAhBlC,YAAA;EAgB+C;;;;;;EAT/C,IAAA,GAAO,cAAA;AAAA;;;;;;;cASI,sBAAA,SAA+B,KAAA;cAC9B,OAAA,UAAiB,KAAA;AAAA"}

package/dist/agent/mcp-transport.d.mts

@@ -1,52 +0,0 @@
-import "reflect-metadata";
-import { RunAgentInput } from "@ag-ui/client";
-import "@ai-sdk/mcp";
-import { StreamableHTTPClientTransportOptions } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
-
-//#region src/agent/mcp-transport.d.ts
-/**
- * The end-user identity resolved by the runtime's `identifyUser` callback for
- * the current request. Surfaced on {@link MCPRequestContext} so MCP header
- * resolvers can read it without re-doing auth work.
- */
-interface MCPRuntimeUser {
-  id: string;
-  name: string;
-}
-/**
- * Context handed to {@link MCPClientConfigHTTP.getHeaders} on every outbound
- * MCP HTTP request. The resolver is invoked fresh per request — initialize,
- * tools/list, tools/call, and reconnects — so values it depends on are never
- * cached across calls.
- */
-interface MCPRequestContext {
-  /**
-   * Headers forwarded onto the agent for this run. Populated by the runtime's
-   * `extractForwardableHeaders` (`authorization` + every `x-*` header from the
-   * incoming HTTP request). Keys are lower-cased.
-   */
-  requestHeaders: Record<string, string>;
-  /** The {@link RunAgentInput} the agent is currently running. */
-  input: RunAgentInput;
-  /** URL of the MCP server this request is going to. */
-  mcpServerUrl: string;
-  /**
-   * The end-user identity for this run, resolved by the runtime's
-   * `identifyUser` callback (only populated when the agent is run via a
-   * `CopilotRuntime` configured with `identifyUser`). Snapshotted at
-   * run-start.
-   */
-  user?: MCPRuntimeUser;
-}
-/**
- * Thrown when an MCP {@link MCPClientConfigHTTP.getHeaders} resolver throws.
- * Wraps the underlying error so `RUN_ERROR` carries clear attribution instead
- * of a generic transport failure. The original error is preserved on the
- * standard ES2022 `Error.cause` chain.
- */
-declare class MCPHeaderResolverError extends Error {
-  constructor(message: string, cause: unknown);
-}
-//#endregion
-export { MCPHeaderResolverError, MCPRequestContext };
-//# sourceMappingURL=mcp-transport.d.mts.map

package/dist/agent/mcp-transport.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"mcp-transport.d.mts","names":[],"sources":["../../src/agent/mcp-transport.ts"],"mappings":";;;;;;;;AAWA;;;UAAiB,cAAA;EACf,EAAA;EACA,IAAA;AAAA;;;;;;;UASe,iBAAA;EAMC;;;;;EAAhB,cAAA,EAAgB,MAAA;EAWK;EATrB,KAAA,EAAO,aAAA;EAkBI;EAhBX,YAAA;;;;;;;EAOA,IAAA,GAAO,cAAA;AAAA;;;;;;;cASI,sBAAA,SAA+B,KAAA;cAC9B,OAAA,UAAiB,KAAA;AAAA"}

package/dist/agent/mcp-transport.mjs

@@ -1,92 +0,0 @@
-import "reflect-metadata";
-import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
-
-//#region src/agent/mcp-transport.ts
-/**
-* Thrown when an MCP {@link MCPClientConfigHTTP.getHeaders} resolver throws.
-* Wraps the underlying error so `RUN_ERROR` carries clear attribution instead
-* of a generic transport failure. The original error is preserved on the
-* standard ES2022 `Error.cause` chain.
-*/
-var MCPHeaderResolverError = class extends Error {
-	constructor(message, cause) {
-		super(message, { cause });
-		this.name = "MCPHeaderResolverError";
-	}
-};
-/**
-* MCP transport for CopilotKit's BuiltInAgent that adds per-call header
-* resolution on top of the standard Streamable HTTP transport.
-*
-* Implements `@ai-sdk/mcp`'s {@link MCPTransport} interface so it can be
-* passed straight to `createMCPClient({ transport })`. Internally delegates
-* to `@modelcontextprotocol/sdk`'s `StreamableHTTPClientTransport` with a
-* wrapped `fetch` that runs the static-header + per-call resolver pipeline
-* before each outbound request.
-*/
-var CopilotKitMCPTransport = class {
-	constructor(options) {
-		const transportOptions = {
-			...options.options,
-			fetch: buildWrappedFetch(options)
-		};
-		this.inner = new StreamableHTTPClientTransport(new URL(options.url), transportOptions);
-	}
-	get onclose() {
-		return this.inner.onclose;
-	}
-	set onclose(handler) {
-		this.inner.onclose = handler;
-	}
-	get onerror() {
-		return this.inner.onerror;
-	}
-	set onerror(handler) {
-		this.inner.onerror = handler;
-	}
-	get onmessage() {
-		return this.inner.onmessage;
-	}
-	set onmessage(handler) {
-		this.inner.onmessage = handler;
-	}
-	start() {
-		return this.inner.start();
-	}
-	send(message) {
-		return this.inner.send(message);
-	}
-	close() {
-		return this.inner.close();
-	}
-};
-function buildWrappedFetch(options) {
-	const { headers: staticHeaders, getHeaders, requestHeaders, input, url: mcpServerUrl, user, options: transportOptions } = options;
-	const baseFetch = transportOptions?.fetch ?? globalThis.fetch;
-	return async (fetchUrl, init) => {
-		const merged = new Headers(init?.headers);
-		if (staticHeaders) for (const [key, value] of Object.entries(staticHeaders)) merged.set(key, value);
-		if (getHeaders) {
-			let resolved;
-			try {
-				resolved = await getHeaders({
-					requestHeaders,
-					input,
-					mcpServerUrl,
-					user
-				});
-			} catch (err) {
-				throw new MCPHeaderResolverError(`MCP header resolver for ${mcpServerUrl} threw: ${err instanceof Error ? err.message : String(err)}`, err);
-			}
-			for (const [key, value] of Object.entries(resolved)) merged.set(key, value);
-		}
-		return baseFetch(fetchUrl, {
-			...init,
-			headers: merged
-		});
-	};
-}
-
-//#endregion
-export { CopilotKitMCPTransport, MCPHeaderResolverError };
-//# sourceMappingURL=mcp-transport.mjs.map

package/dist/agent/mcp-transport.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"mcp-transport.mjs","names":[],"sources":["../../src/agent/mcp-transport.ts"],"sourcesContent":["import type { RunAgentInput } from \"@ag-ui/client\";\nimport type { JSONRPCMessage, MCPTransport } from \"@ai-sdk/mcp\";\nimport { StreamableHTTPClientTransport } from \"@modelcontextprotocol/sdk/client/streamableHttp.js\";\nimport type { StreamableHTTPClientTransportOptions } from \"@modelcontextprotocol/sdk/client/streamableHttp.js\";\nimport type { FetchLike } from \"@modelcontextprotocol/sdk/shared/transport.js\";\n\n/**\n * The end-user identity resolved by the runtime's `identifyUser` callback for\n * the current request. Surfaced on {@link MCPRequestContext} so MCP header\n * resolvers can read it without re-doing auth work.\n */\nexport interface MCPRuntimeUser {\n  id: string;\n  name: string;\n}\n\n/**\n * Context handed to {@link MCPClientConfigHTTP.getHeaders} on every outbound\n * MCP HTTP request. The resolver is invoked fresh per request — initialize,\n * tools/list, tools/call, and reconnects — so values it depends on are never\n * cached across calls.\n */\nexport interface MCPRequestContext {\n  /**\n   * Headers forwarded onto the agent for this run. Populated by the runtime's\n   * `extractForwardableHeaders` (`authorization` + every `x-*` header from the\n   * incoming HTTP request). Keys are lower-cased.\n   */\n  requestHeaders: Record<string, string>;\n  /** The {@link RunAgentInput} the agent is currently running. */\n  input: RunAgentInput;\n  /** URL of the MCP server this request is going to. */\n  mcpServerUrl: string;\n  /**\n   * The end-user identity for this run, resolved by the runtime's\n   * `identifyUser` callback (only populated when the agent is run via a\n   * `CopilotRuntime` configured with `identifyUser`). Snapshotted at\n   * run-start.\n   */\n  user?: MCPRuntimeUser;\n}\n\n/**\n * Thrown when an MCP {@link MCPClientConfigHTTP.getHeaders} resolver throws.\n * Wraps the underlying error so `RUN_ERROR` carries clear attribution instead\n * of a generic transport failure. The original error is preserved on the\n * standard ES2022 `Error.cause` chain.\n */\nexport class MCPHeaderResolverError extends Error {\n  constructor(message: string, cause: unknown) {\n    super(message, { cause });\n    this.name = \"MCPHeaderResolverError\";\n  }\n}\n\nexport interface CopilotKitMCPTransportOptions {\n  /** URL of the MCP server. */\n  url: string;\n  /** Static HTTP headers, merged into every outbound request. */\n  headers?: Record<string, string>;\n  /**\n   * Per-call header resolver. Invoked on **every** outbound HTTP request to\n   * this server (initialize, tools/list, tools/call, reconnects). Returned\n   * headers are merged on top of `headers`, so a resolver can override either.\n   */\n  getHeaders?: (\n    ctx: MCPRequestContext,\n  ) => Record<string, string> | Promise<Record<string, string>>;\n  /**\n   * Pre-existing escape hatch: low-level options for the underlying\n   * `StreamableHTTPClientTransport`. Forwarded as-is, except `fetch` is\n   * wrapped so static `headers` and `getHeaders` resolution still apply.\n   */\n  options?: StreamableHTTPClientTransportOptions;\n  /** Snapshot of the agent's per-run forwarded headers, captured at run-start. */\n  requestHeaders: Record<string, string>;\n  /** RunAgentInput for the current run, exposed to the resolver via context. */\n  input: RunAgentInput;\n  /** Per-run end-user identity from the runtime's `identifyUser`, if set. */\n  user?: MCPRuntimeUser;\n}\n\n/**\n * MCP transport for CopilotKit's BuiltInAgent that adds per-call header\n * resolution on top of the standard Streamable HTTP transport.\n *\n * Implements `@ai-sdk/mcp`'s {@link MCPTransport} interface so it can be\n * passed straight to `createMCPClient({ transport })`. Internally delegates\n * to `@modelcontextprotocol/sdk`'s `StreamableHTTPClientTransport` with a\n * wrapped `fetch` that runs the static-header + per-call resolver pipeline\n * before each outbound request.\n */\nexport class CopilotKitMCPTransport implements MCPTransport {\n  private readonly inner: StreamableHTTPClientTransport;\n\n  constructor(options: CopilotKitMCPTransportOptions) {\n    const transportOptions: StreamableHTTPClientTransportOptions = {\n      ...options.options,\n      fetch: buildWrappedFetch(options),\n    };\n    this.inner = new StreamableHTTPClientTransport(\n      new URL(options.url),\n      transportOptions,\n    );\n  }\n\n  get onclose(): (() => void) | undefined {\n    return this.inner.onclose;\n  }\n  set onclose(handler: (() => void) | undefined) {\n    this.inner.onclose = handler;\n  }\n\n  get onerror(): ((error: Error) => void) | undefined {\n    return this.inner.onerror;\n  }\n  set onerror(handler: ((error: Error) => void) | undefined) {\n    this.inner.onerror = handler;\n  }\n\n  get onmessage(): ((message: JSONRPCMessage) => void) | undefined {\n    return this.inner.onmessage as\n      | ((message: JSONRPCMessage) => void)\n      | undefined;\n  }\n  set onmessage(handler: ((message: JSONRPCMessage) => void) | undefined) {\n    this.inner.onmessage = handler as\n      | ((message: JSONRPCMessage) => void)\n      | undefined;\n  }\n\n  start(): Promise<void> {\n    return this.inner.start();\n  }\n\n  send(message: JSONRPCMessage): Promise<void> {\n    return this.inner.send(message as Parameters<typeof this.inner.send>[0]);\n  }\n\n  close(): Promise<void> {\n    return this.inner.close();\n  }\n}\n\nfunction buildWrappedFetch(options: CopilotKitMCPTransportOptions): FetchLike {\n  const {\n    headers: staticHeaders,\n    getHeaders,\n    requestHeaders,\n    input,\n    url: mcpServerUrl,\n    user,\n    options: transportOptions,\n  } = options;\n  const baseFetch: FetchLike = transportOptions?.fetch ?? globalThis.fetch;\n\n  return async (fetchUrl, init) => {\n    // SDK passes a Headers instance via init.headers — start fresh from it so\n    // we don't mutate the SDK's object, then layer headers on top via .set()\n    // (last write wins).\n    const merged = new Headers(init?.headers);\n    if (staticHeaders) {\n      for (const [key, value] of Object.entries(staticHeaders)) {\n        merged.set(key, value);\n      }\n    }\n    if (getHeaders) {\n      let resolved: Record<string, string>;\n      try {\n        resolved = await getHeaders({\n          requestHeaders,\n          input,\n          mcpServerUrl,\n          user,\n        });\n      } catch (err) {\n        throw new MCPHeaderResolverError(\n          `MCP header resolver for ${mcpServerUrl} threw: ${\n            err instanceof Error ? err.message : String(err)\n          }`,\n          err,\n        );\n      }\n      for (const [key, value] of Object.entries(resolved)) {\n        merged.set(key, value);\n      }\n    }\n    return baseFetch(fetchUrl, { ...init, headers: merged });\n  };\n}\n"],"mappings":";;;;;;;;;;AAgDA,IAAa,yBAAb,cAA4C,MAAM;CAChD,YAAY,SAAiB,OAAgB;AAC3C,QAAM,SAAS,EAAE,OAAO,CAAC;AACzB,OAAK,OAAO;;;;;;;;;;;;;AAyChB,IAAa,yBAAb,MAA4D;CAG1D,YAAY,SAAwC;EAClD,MAAM,mBAAyD;GAC7D,GAAG,QAAQ;GACX,OAAO,kBAAkB,QAAQ;GAClC;AACD,OAAK,QAAQ,IAAI,8BACf,IAAI,IAAI,QAAQ,IAAI,EACpB,iBACD;;CAGH,IAAI,UAAoC;AACtC,SAAO,KAAK,MAAM;;CAEpB,IAAI,QAAQ,SAAmC;AAC7C,OAAK,MAAM,UAAU;;CAGvB,IAAI,UAAgD;AAClD,SAAO,KAAK,MAAM;;CAEpB,IAAI,QAAQ,SAA+C;AACzD,OAAK,MAAM,UAAU;;CAGvB,IAAI,YAA6D;AAC/D,SAAO,KAAK,MAAM;;CAIpB,IAAI,UAAU,SAA0D;AACtE,OAAK,MAAM,YAAY;;CAKzB,QAAuB;AACrB,SAAO,KAAK,MAAM,OAAO;;CAG3B,KAAK,SAAwC;AAC3C,SAAO,KAAK,MAAM,KAAK,QAAiD;;CAG1E,QAAuB;AACrB,SAAO,KAAK,MAAM,OAAO;;;AAI7B,SAAS,kBAAkB,SAAmD;CAC5E,MAAM,EACJ,SAAS,eACT,YACA,gBACA,OACA,KAAK,cACL,MACA,SAAS,qBACP;CACJ,MAAM,YAAuB,kBAAkB,SAAS,WAAW;AAEnE,QAAO,OAAO,UAAU,SAAS;EAI/B,MAAM,SAAS,IAAI,QAAQ,MAAM,QAAQ;AACzC,MAAI,cACF,MAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,cAAc,CACtD,QAAO,IAAI,KAAK,MAAM;AAG1B,MAAI,YAAY;GACd,IAAI;AACJ,OAAI;AACF,eAAW,MAAM,WAAW;KAC1B;KACA;KACA;KACA;KACD,CAAC;YACK,KAAK;AACZ,UAAM,IAAI,uBACR,2BAA2B,aAAa,UACtC,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI,IAElD,IACD;;AAEH,QAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,SAAS,CACjD,QAAO,IAAI,KAAK,MAAM;;AAG1B,SAAO,UAAU,UAAU;GAAE,GAAG;GAAM,SAAS;GAAQ,CAAC"}

package/dist/v2/runtime/intelligence-platform/index.d.cts

@@ -1,2 +0,0 @@
-
-import { CopilotKitIntelligence, CopilotKitIntelligenceConfig, CreateThreadRequest, ListThreadsResponse, SubscribeToThreadsRequest, SubscribeToThreadsResponse, ThreadSummary, UpdateThreadRequest } from "./client.cjs";

package/dist/v2/runtime/intelligence-platform/index.d.mts

@@ -1,2 +0,0 @@
-import "reflect-metadata";
-import { CopilotKitIntelligence, CopilotKitIntelligenceConfig, CreateThreadRequest, ListThreadsResponse, SubscribeToThreadsRequest, SubscribeToThreadsResponse, ThreadSummary, UpdateThreadRequest } from "./client.mjs";