@copilotkit/runtime 1.56.5-canary.1777972218 → 1.57.0

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";

package/src/agent/mcp-transport.ts

@@ -1,190 +0,0 @@
-import type { RunAgentInput } from "@ag-ui/client";
-import type { JSONRPCMessage, MCPTransport } from "@ai-sdk/mcp";
-import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
-import type { StreamableHTTPClientTransportOptions } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
-import type { FetchLike } from "@modelcontextprotocol/sdk/shared/transport.js";
-
-/**
- * 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.
- */
-export 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.
- */
-export 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.
- */
-export class MCPHeaderResolverError extends Error {
-  constructor(message: string, cause: unknown) {
-    super(message, { cause });
-    this.name = "MCPHeaderResolverError";
-  }
-}
-
-export interface CopilotKitMCPTransportOptions {
-  /** URL of the MCP server. */
-  url: string;
-  /** Static HTTP headers, merged into every outbound request. */
-  headers?: Record<string, string>;
-  /**
-   * Per-call header resolver. Invoked on **every** outbound HTTP request to
-   * this server (initialize, tools/list, tools/call, reconnects). Returned
-   * headers are merged on top of `headers`, so a resolver can override either.
-   */
-  getHeaders?: (
-    ctx: MCPRequestContext,
-  ) => Record<string, string> | Promise<Record<string, string>>;
-  /**
-   * Pre-existing escape hatch: low-level options for the underlying
-   * `StreamableHTTPClientTransport`. Forwarded as-is, except `fetch` is
-   * wrapped so static `headers` and `getHeaders` resolution still apply.
-   */
-  options?: StreamableHTTPClientTransportOptions;
-  /** Snapshot of the agent's per-run forwarded headers, captured at run-start. */
-  requestHeaders: Record<string, string>;
-  /** RunAgentInput for the current run, exposed to the resolver via context. */
-  input: RunAgentInput;
-  /** Per-run end-user identity from the runtime's `identifyUser`, if set. */
-  user?: MCPRuntimeUser;
-}
-
-/**
- * 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.
- */
-export class CopilotKitMCPTransport implements MCPTransport {
-  private readonly inner: StreamableHTTPClientTransport;
-
-  constructor(options: CopilotKitMCPTransportOptions) {
-    const transportOptions: StreamableHTTPClientTransportOptions = {
-      ...options.options,
-      fetch: buildWrappedFetch(options),
-    };
-    this.inner = new StreamableHTTPClientTransport(
-      new URL(options.url),
-      transportOptions,
-    );
-  }
-
-  get onclose(): (() => void) | undefined {
-    return this.inner.onclose;
-  }
-  set onclose(handler: (() => void) | undefined) {
-    this.inner.onclose = handler;
-  }
-
-  get onerror(): ((error: Error) => void) | undefined {
-    return this.inner.onerror;
-  }
-  set onerror(handler: ((error: Error) => void) | undefined) {
-    this.inner.onerror = handler;
-  }
-
-  get onmessage(): ((message: JSONRPCMessage) => void) | undefined {
-    return this.inner.onmessage as
-      | ((message: JSONRPCMessage) => void)
-      | undefined;
-  }
-  set onmessage(handler: ((message: JSONRPCMessage) => void) | undefined) {
-    this.inner.onmessage = handler as
-      | ((message: JSONRPCMessage) => void)
-      | undefined;
-  }
-
-  start(): Promise<void> {
-    return this.inner.start();
-  }
-
-  send(message: JSONRPCMessage): Promise<void> {
-    return this.inner.send(message as Parameters<typeof this.inner.send>[0]);
-  }
-
-  close(): Promise<void> {
-    return this.inner.close();
-  }
-}
-
-function buildWrappedFetch(options: CopilotKitMCPTransportOptions): FetchLike {
-  const {
-    headers: staticHeaders,
-    getHeaders,
-    requestHeaders,
-    input,
-    url: mcpServerUrl,
-    user,
-    options: transportOptions,
-  } = options;
-  const baseFetch: FetchLike = transportOptions?.fetch ?? globalThis.fetch;
-
-  return async (fetchUrl, init) => {
-    // SDK passes a Headers instance via init.headers — start fresh from it so
-    // we don't mutate the SDK's object, then layer headers on top via .set()
-    // (last write wins).
-    const merged = new Headers(init?.headers);
-    if (staticHeaders) {
-      for (const [key, value] of Object.entries(staticHeaders)) {
-        merged.set(key, value);
-      }
-    }
-    if (getHeaders) {
-      let resolved: Record<string, string>;
-      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 });
-  };
-}

package/src/v2/runtime/intelligence-platform/__tests__/intelligence-mcp-helper.test.ts

@@ -1,190 +0,0 @@
-import { describe, it, expect, vi, beforeEach, afterEach } from "vitest";
-import { CopilotKitIntelligence } from "../client";
-import { BasicAgent } from "../../../../agent";
-import { EventType } from "@ag-ui/client";
-import { LLMock, MCPMock } from "@copilotkit/aimock";
-import { streamText } from "ai";
-import {
-  mockStreamTextResponse,
-  textDelta,
-  finish,
-  collectEvents,
-} from "../../../../agent/__tests__/test-helpers";
-
-vi.mock("ai", () => ({
-  streamText: vi.fn(),
-  tool: vi.fn((config) => config),
-  stepCountIs: vi.fn((count: number) => ({ type: "stepCount", count })),
-}));
-
-vi.mock("@ai-sdk/openai", () => ({
-  createOpenAI: vi.fn(() => (modelId: string) => ({
-    modelId,
-    provider: "openai",
-  })),
-}));
-
-async function startMcpMock(): Promise<{ url: string; server: LLMock }> {
-  const mock = new MCPMock();
-  mock.addTool({
-    name: "bash",
-    description: "Run a bash command",
-    inputSchema: {
-      type: "object",
-      properties: { command: { type: "string" } },
-    },
-  });
-  mock.onToolCall("bash", () => "ok");
-  const server = new LLMock({ port: 0 });
-  server.mount("/mcp", mock);
-  await server.start();
-  return { url: server.url, server };
-}
-
-/**
- * aimock redacts `Authorization` to `[REDACTED]` in its journal. Spy on
- * `globalThis.fetch` to read unredacted headers off each outbound request to
- * `mcpUrl`. The spy delegates to the real fetch so the round-trip completes.
- */
-function spyOnFetch(mcpUrl: string): {
-  records: Array<Record<string, string>>;
-  restore: () => void;
-} {
-  const records: Array<Record<string, string>> = [];
-  const realFetch = globalThis.fetch;
-  const spy = vi
-    .spyOn(globalThis, "fetch")
-    .mockImplementation(async (input, init) => {
-      const url =
-        typeof input === "string"
-          ? input
-          : input instanceof URL
-            ? input.toString()
-            : input.url;
-      if (url.startsWith(mcpUrl)) {
-        const seen: Record<string, string> = {};
-        new Headers(init?.headers ?? {}).forEach((value, key) => {
-          seen[key.toLowerCase()] = value;
-        });
-        records.push(seen);
-      }
-      return realFetch(input, init);
-    });
-  return { records, restore: () => spy.mockRestore() };
-}
-
-describe("CopilotKitIntelligence.toMCPServer()", () => {
-  const baseInput = {
-    threadId: "thread1",
-    runId: "run1",
-    messages: [],
-    tools: [],
-    context: [],
-    state: {},
-  };
-
-  let llm: LLMock | undefined;
-  const originalEnv = process.env;
-
-  beforeEach(() => {
-    vi.clearAllMocks();
-    process.env = { ...originalEnv };
-    process.env.OPENAI_API_KEY = "test-key";
-  });
-
-  afterEach(async () => {
-    process.env = originalEnv;
-    if (llm) {
-      await llm.stop().catch(() => {});
-      llm = undefined;
-    }
-  });
-
-  it("emits Authorization (Bearer apiKey) and X-Cpki-User-Id (resolved user) on every MCP request", async () => {
-    const { url, server } = await startMcpMock();
-    llm = server;
-
-    const intelligence = new CopilotKitIntelligence({
-      apiUrl: url,
-      wsUrl: "wss://unused.example.com/socket",
-      apiKey: "cpk-proj_short_long",
-    });
-
-    const recorder = spyOnFetch(url);
-    try {
-      const agent = new BasicAgent({
-        model: "openai/gpt-4o",
-        mcpServers: [intelligence.toMCPServer()],
-      });
-      // The runtime would normally populate this via `identifyUser` after
-      // resolveIntelligenceUser. Simulate the same outcome here.
-      agent.user = { id: "jordan-beamson", name: "Jordan Beamson" };
-
-      vi.mocked(streamText).mockReturnValue(
-        mockStreamTextResponse([textDelta("hi"), finish()]) as any,
-      );
-
-      await collectEvents(agent["run"](baseInput));
-
-      expect(recorder.records.length).toBeGreaterThan(0);
-      for (const headers of recorder.records) {
-        expect(headers["authorization"]).toBe("Bearer cpk-proj_short_long");
-        expect(headers["x-cpki-user-id"]).toBe("jordan-beamson");
-      }
-    } finally {
-      recorder.restore();
-    }
-  });
-
-  it("returned config has requiresUser=true so user-less sub-runs skip the server", () => {
-    const intelligence = new CopilotKitIntelligence({
-      apiUrl: "https://api.example.com",
-      wsUrl: "wss://ws.example.com",
-      apiKey: "k",
-    });
-
-    expect(intelligence.toMCPServer().requiresUser).toBe(true);
-  });
-
-  it("agent run with intelligence.toMCPServer() and no user completes without error (the thread-naming sub-run shape)", async () => {
-    const { url, server } = await startMcpMock();
-    llm = server;
-
-    const intelligence = new CopilotKitIntelligence({
-      apiUrl: url,
-      wsUrl: "wss://unused.example.com/socket",
-      apiKey: "cpk-proj_short_long",
-    });
-
-    const recorder = spyOnFetch(url);
-    try {
-      const agent = new BasicAgent({
-        model: "openai/gpt-4o",
-        mcpServers: [intelligence.toMCPServer()],
-      });
-      // No agent.user — mirrors the cloned naming sub-run.
-
-      vi.mocked(streamText).mockReturnValue(
-        mockStreamTextResponse([finish()]) as any,
-      );
-
-      const events = await collectEvents(agent["run"](baseInput));
-
-      expect(
-        events.find((e: any) => e.type === EventType.RUN_ERROR),
-      ).toBeUndefined();
-      expect(recorder.records.length).toBe(0);
-    } finally {
-      recorder.restore();
-    }
-  });
-
-  it("URL is composed from apiUrl + /mcp (trailing slash on apiUrl is normalized)", () => {
-    const intelligence = new CopilotKitIntelligence({
-      apiUrl: "https://api.example.com/",
-      wsUrl: "wss://ws.example.com",
-      apiKey: "k",
-    });
-    expect(intelligence.toMCPServer().url).toBe("https://api.example.com/mcp");
-  });
-});