@copilotkit/runtime 1.55.0-next.9 → 1.55.1-next.0

package/dist/v2/runtime/{runtime.mjs → core/runtime.mjs}

@@ -1,24 +1,25 @@
 import "reflect-metadata";
-import { __toESM } from "../../_virtual/_rolldown/runtime.mjs";
-import { require_package } from "../../package.mjs";
-import { InMemoryAgentRunner } from "./runner/in-memory.mjs";
-import { IntelligenceAgentRunner } from "./runner/intelligence.mjs";
-import { RUNTIME_MODE_INTELLIGENCE, RUNTIME_MODE_SSE, createLicenseChecker } from "@copilotkit/shared";
+import { __toESM } from "../../../_virtual/_rolldown/runtime.mjs";
+import { require_package } from "../../../package.mjs";
+import { InMemoryAgentRunner } from "../runner/in-memory.mjs";
+import { IntelligenceAgentRunner } from "../runner/intelligence.mjs";
+import { RUNTIME_MODE_INTELLIGENCE, RUNTIME_MODE_SSE } from "@copilotkit/shared";
+import { createLicenseChecker } from "@copilotkit/license-verifier";
 
-//#region src/v2/runtime/runtime.ts
+//#region src/v2/runtime/core/runtime.ts
 var import_package = /* @__PURE__ */ __toESM(require_package());
 const VERSION = import_package.default.version;
 var BaseCopilotRuntime = class {
 	constructor(options, runner) {
-		const { agents, transcriptionService, beforeRequestMiddleware, afterRequestMiddleware, a2ui, mcpApps } = options;
+		const { agents, transcriptionService, beforeRequestMiddleware, afterRequestMiddleware, a2ui, mcpApps, openGenerativeUI } = options;
 		this.agents = agents;
 		this.transcriptionService = transcriptionService;
 		this.beforeRequestMiddleware = beforeRequestMiddleware;
 		this.afterRequestMiddleware = afterRequestMiddleware;
-		this.a2ui = a2ui;
+		this.a2ui = a2ui || void 0;
 		this.mcpApps = mcpApps;
+		this.openGenerativeUI = openGenerativeUI;
 		this.runner = runner;
-		this.licenseChecker = createLicenseChecker(options.licenseToken);
 	}
 };
 var CopilotSseRuntime = class extends BaseCopilotRuntime {
@@ -28,16 +29,28 @@ var CopilotSseRuntime = class extends BaseCopilotRuntime {
 		this.mode = RUNTIME_MODE_SSE;
 	}
 };
-var CopilotIntelligenceRuntime = class extends BaseCopilotRuntime {
+var CopilotIntelligenceRuntime = class CopilotIntelligenceRuntime extends BaseCopilotRuntime {
+	static {
+		this.MAX_LOCK_TTL_SECONDS = 3600;
+	}
+	static {
+		this.MAX_HEARTBEAT_INTERVAL_SECONDS = 3e3;
+	}
 	constructor(options) {
 		super(options, new IntelligenceAgentRunner({
 			url: options.intelligence.ɵgetRunnerWsUrl(),
-			authToken: options.intelligence.ɵgetRunnerAuthToken()
+			authToken: options.intelligence.ɵgetRunnerAuthToken(),
+			maxReconnectMs: options.maxReconnectMs,
+			maxRejoinMs: options.maxRejoinMs
 		}));
 		this.mode = RUNTIME_MODE_INTELLIGENCE;
 		this.intelligence = options.intelligence;
 		this.identifyUser = options.identifyUser;
 		this.generateThreadNames = options.generateThreadNames ?? true;
+		this.licenseChecker = createLicenseChecker(options.licenseToken);
+		this.lockTtlSeconds = Math.min(options.lockTtlSeconds ?? 20, CopilotIntelligenceRuntime.MAX_LOCK_TTL_SECONDS);
+		this.lockKeyPrefix = options.lockKeyPrefix;
+		this.lockHeartbeatIntervalSeconds = Math.min(options.lockHeartbeatIntervalSeconds ?? 15, CopilotIntelligenceRuntime.MAX_HEARTBEAT_INTERVAL_SECONDS);
 	}
 };
 function hasIntelligenceOptions(options) {
@@ -75,6 +88,9 @@ var CopilotRuntime = class {
 	get mcpApps() {
 		return this.delegate.mcpApps;
 	}
+	get openGenerativeUI() {
+		return this.delegate.openGenerativeUI;
+	}
 	get intelligence() {
 		return this.delegate.intelligence;
 	}
@@ -84,6 +100,15 @@ var CopilotRuntime = class {
 	get identifyUser() {
 		return isIntelligenceRuntime(this.delegate) ? this.delegate.identifyUser : void 0;
 	}
+	get lockTtlSeconds() {
+		return isIntelligenceRuntime(this.delegate) ? this.delegate.lockTtlSeconds : void 0;
+	}
+	get lockKeyPrefix() {
+		return isIntelligenceRuntime(this.delegate) ? this.delegate.lockKeyPrefix : void 0;
+	}
+	get lockHeartbeatIntervalSeconds() {
+		return isIntelligenceRuntime(this.delegate) ? this.delegate.lockHeartbeatIntervalSeconds : void 0;
+	}
 	get mode() {
 		return this.delegate.mode;
 	}

package/dist/v2/runtime/core/runtime.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.mjs","names":["pkg"],"sources":["../../../../src/v2/runtime/core/runtime.ts"],"sourcesContent":["import {\n  MaybePromise,\n  NonEmptyRecord,\n  RuntimeMode,\n  RUNTIME_MODE_SSE,\n  RUNTIME_MODE_INTELLIGENCE,\n} from \"@copilotkit/shared\";\nimport {\n  createLicenseChecker,\n  type LicenseChecker,\n} from \"@copilotkit/license-verifier\";\nimport { AbstractAgent } from \"@ag-ui/client\";\nimport type { MCPClientConfig } from \"@ag-ui/mcp-apps-middleware\";\nimport { A2UIMiddlewareConfig } from \"@ag-ui/a2ui-middleware\";\nimport pkg from \"../../../../package.json\";\nimport type {\n  BeforeRequestMiddleware,\n  AfterRequestMiddleware,\n} from \"./middleware\";\nimport { TranscriptionService } from \"../transcription-service/transcription-service\";\nimport { AgentRunner } from \"../runner/agent-runner\";\nimport { InMemoryAgentRunner } from \"../runner/in-memory\";\nimport { IntelligenceAgentRunner } from \"../runner/intelligence\";\nimport { CopilotKitIntelligence } from \"../intelligence-platform\";\n\nexport const VERSION = pkg.version;\n\ninterface BaseCopilotRuntimeMiddlewareOptions {\n  /** If set, middleware only applies to these named agents. Applies to all agents if omitted. */\n  agents?: string[];\n}\n\nexport type McpAppsServerConfig = MCPClientConfig & {\n  /** Agent to bind this server to. If omitted, the server is available to all agents. */\n  agentId?: string;\n};\n\nexport interface McpAppsConfig {\n  /** List of MCP server configurations. */\n  servers: McpAppsServerConfig[];\n}\n\nexport interface OpenGenerativeUIOptions extends BaseCopilotRuntimeMiddlewareOptions {}\n\nexport type OpenGenerativeUIConfig = boolean | OpenGenerativeUIOptions;\n\ninterface CopilotRuntimeMiddlewares {\n  /**\n   * Auto-apply A2UIMiddleware to agents at run time.\n   * Pass an object to enable and customise behaviour, or omit to disable.\n   */\n  a2ui?: BaseCopilotRuntimeMiddlewareOptions & A2UIMiddlewareConfig;\n  /** Auto-apply MCPAppsMiddleware to agents at run time. */\n  mcpApps?: McpAppsConfig;\n  /** Auto-apply OpenGenerativeUIMiddleware to agents at run time. */\n  openGenerativeUI?: OpenGenerativeUIConfig;\n}\n\ninterface BaseCopilotRuntimeOptions extends CopilotRuntimeMiddlewares {\n  /** Map of available agents (loaded lazily is fine). */\n  agents: MaybePromise<NonEmptyRecord<Record<string, AbstractAgent>>>;\n  /** Optional transcription service for audio processing. */\n  transcriptionService?: TranscriptionService;\n  /** Optional *before* middleware – callback function or webhook URL. */\n  beforeRequestMiddleware?: BeforeRequestMiddleware;\n  /** Optional *after* middleware – callback function or webhook URL. */\n  afterRequestMiddleware?: AfterRequestMiddleware;\n  /** Signed license token for server-side feature verification. Falls back to COPILOTKIT_LICENSE_TOKEN env var. */\n  licenseToken?: string;\n}\n\nexport interface CopilotRuntimeUser {\n  id: string;\n}\n\nexport type IdentifyUserCallback = (\n  request: Request,\n) => MaybePromise<CopilotRuntimeUser>;\n\nexport interface CopilotSseRuntimeOptions extends BaseCopilotRuntimeOptions {\n  /** The runner to use for running agents in SSE mode. */\n  runner?: AgentRunner;\n  intelligence?: undefined;\n  generateThreadNames?: undefined;\n}\n\nexport interface CopilotIntelligenceRuntimeOptions extends BaseCopilotRuntimeOptions {\n  /** Configures Intelligence mode for durable threads and realtime events. */\n  intelligence: CopilotKitIntelligence;\n  /** Resolves the authenticated user for intelligence requests. */\n  identifyUser: IdentifyUserCallback;\n  /** Auto-generate short names for newly created threads. */\n  generateThreadNames?: boolean;\n  /** Max delay (ms) for WebSocket reconnect backoff. @default 10_000 */\n  maxReconnectMs?: number;\n  /** Max delay (ms) for channel rejoin backoff. @default 30_000 */\n  maxRejoinMs?: number;\n  /** Lock TTL in seconds. Clamped to a maximum of 3600 (1 hour). @default 20 */\n  lockTtlSeconds?: number;\n  /** Custom Redis key prefix for the thread lock. */\n  lockKeyPrefix?: string;\n  /** Interval in seconds at which the runtime renews the thread lock. Clamped to a maximum of 3000 (50 minutes). @default 15 */\n  lockHeartbeatIntervalSeconds?: number;\n}\n\nexport type CopilotRuntimeOptions =\n  | CopilotSseRuntimeOptions\n  | CopilotIntelligenceRuntimeOptions;\n\nexport interface CopilotRuntimeLike {\n  agents: CopilotRuntimeOptions[\"agents\"];\n  transcriptionService: CopilotRuntimeOptions[\"transcriptionService\"];\n  beforeRequestMiddleware: CopilotRuntimeOptions[\"beforeRequestMiddleware\"];\n  afterRequestMiddleware: CopilotRuntimeOptions[\"afterRequestMiddleware\"];\n  runner: AgentRunner;\n  a2ui: CopilotRuntimeOptions[\"a2ui\"];\n  mcpApps: CopilotRuntimeOptions[\"mcpApps\"];\n  openGenerativeUI: CopilotRuntimeOptions[\"openGenerativeUI\"];\n  intelligence?: CopilotKitIntelligence;\n  identifyUser?: IdentifyUserCallback;\n  mode: RuntimeMode;\n  licenseChecker?: LicenseChecker;\n}\n\nexport interface CopilotSseRuntimeLike extends CopilotRuntimeLike {\n  intelligence?: undefined;\n  mode: RUNTIME_MODE_SSE;\n}\n\nexport interface CopilotIntelligenceRuntimeLike extends CopilotRuntimeLike {\n  intelligence: CopilotKitIntelligence;\n  identifyUser: IdentifyUserCallback;\n  generateThreadNames: boolean;\n  lockTtlSeconds: number;\n  lockKeyPrefix?: string;\n  lockHeartbeatIntervalSeconds: number;\n  mode: RUNTIME_MODE_INTELLIGENCE;\n}\n\nabstract class BaseCopilotRuntime implements CopilotRuntimeLike {\n  public agents: CopilotRuntimeOptions[\"agents\"];\n  public transcriptionService: CopilotRuntimeOptions[\"transcriptionService\"];\n  public beforeRequestMiddleware: CopilotRuntimeOptions[\"beforeRequestMiddleware\"];\n  public afterRequestMiddleware: CopilotRuntimeOptions[\"afterRequestMiddleware\"];\n  public runner: AgentRunner;\n  public a2ui: CopilotRuntimeOptions[\"a2ui\"];\n  public mcpApps: CopilotRuntimeOptions[\"mcpApps\"];\n  public openGenerativeUI: CopilotRuntimeOptions[\"openGenerativeUI\"];\n  public licenseChecker?: LicenseChecker;\n\n  abstract readonly intelligence?: CopilotKitIntelligence;\n  abstract readonly mode: RuntimeMode;\n\n  constructor(options: BaseCopilotRuntimeOptions, runner: AgentRunner) {\n    const {\n      agents,\n      transcriptionService,\n      beforeRequestMiddleware,\n      afterRequestMiddleware,\n      a2ui,\n      mcpApps,\n      openGenerativeUI,\n    } = options;\n\n    this.agents = agents;\n    this.transcriptionService = transcriptionService;\n    this.beforeRequestMiddleware = beforeRequestMiddleware;\n    this.afterRequestMiddleware = afterRequestMiddleware;\n    this.a2ui = a2ui || undefined;\n    this.mcpApps = mcpApps;\n    this.openGenerativeUI = openGenerativeUI;\n    this.runner = runner;\n  }\n}\n\nexport class CopilotSseRuntime\n  extends BaseCopilotRuntime\n  implements CopilotSseRuntimeLike\n{\n  readonly intelligence = undefined;\n  readonly mode = RUNTIME_MODE_SSE;\n\n  constructor(options: CopilotSseRuntimeOptions) {\n    super(options, options.runner ?? new InMemoryAgentRunner());\n  }\n}\n\nexport class CopilotIntelligenceRuntime\n  extends BaseCopilotRuntime\n  implements CopilotIntelligenceRuntimeLike\n{\n  readonly intelligence: CopilotKitIntelligence;\n  readonly identifyUser: IdentifyUserCallback;\n  readonly generateThreadNames: boolean;\n  readonly lockTtlSeconds: number;\n  readonly lockKeyPrefix?: string;\n  readonly lockHeartbeatIntervalSeconds: number;\n  readonly mode = RUNTIME_MODE_INTELLIGENCE;\n\n  /** Maximum allowed lock TTL in seconds (1 hour). */\n  static readonly MAX_LOCK_TTL_SECONDS = 3_600;\n  /** Maximum allowed heartbeat interval in seconds (50 minutes). */\n  static readonly MAX_HEARTBEAT_INTERVAL_SECONDS = 3_000;\n\n  constructor(options: CopilotIntelligenceRuntimeOptions) {\n    super(\n      options,\n      new IntelligenceAgentRunner({\n        url: options.intelligence.ɵgetRunnerWsUrl(),\n        authToken: options.intelligence.ɵgetRunnerAuthToken(),\n        maxReconnectMs: options.maxReconnectMs,\n        maxRejoinMs: options.maxRejoinMs,\n      }),\n    );\n    this.intelligence = options.intelligence;\n    this.identifyUser = options.identifyUser;\n    this.generateThreadNames = options.generateThreadNames ?? true;\n    this.licenseChecker = createLicenseChecker(options.licenseToken);\n    this.lockTtlSeconds = Math.min(\n      options.lockTtlSeconds ?? 20,\n      CopilotIntelligenceRuntime.MAX_LOCK_TTL_SECONDS,\n    );\n    this.lockKeyPrefix = options.lockKeyPrefix;\n    this.lockHeartbeatIntervalSeconds = Math.min(\n      options.lockHeartbeatIntervalSeconds ?? 15,\n      CopilotIntelligenceRuntime.MAX_HEARTBEAT_INTERVAL_SECONDS,\n    );\n  }\n}\n\nfunction hasIntelligenceOptions(\n  options: CopilotRuntimeOptions,\n): options is CopilotIntelligenceRuntimeOptions {\n  return \"intelligence\" in options && !!options.intelligence;\n}\n\nexport function isIntelligenceRuntime(\n  runtime: CopilotRuntimeLike,\n): runtime is CopilotIntelligenceRuntimeLike {\n  return runtime.mode === RUNTIME_MODE_INTELLIGENCE && !!runtime.intelligence;\n}\n\n/**\n * Compatibility shim that preserves the legacy `CopilotRuntime` entrypoint.\n * New code should prefer `CopilotSseRuntime` or `CopilotIntelligenceRuntime`.\n */\nexport class CopilotRuntime implements CopilotRuntimeLike {\n  private delegate: CopilotRuntimeLike;\n\n  constructor(options: CopilotRuntimeOptions) {\n    this.delegate = hasIntelligenceOptions(options)\n      ? new CopilotIntelligenceRuntime(options)\n      : new CopilotSseRuntime(options);\n  }\n\n  get agents(): CopilotRuntimeOptions[\"agents\"] {\n    return this.delegate.agents;\n  }\n\n  get transcriptionService(): CopilotRuntimeOptions[\"transcriptionService\"] {\n    return this.delegate.transcriptionService;\n  }\n\n  get beforeRequestMiddleware(): CopilotRuntimeOptions[\"beforeRequestMiddleware\"] {\n    return this.delegate.beforeRequestMiddleware;\n  }\n\n  get afterRequestMiddleware(): CopilotRuntimeOptions[\"afterRequestMiddleware\"] {\n    return this.delegate.afterRequestMiddleware;\n  }\n\n  get runner(): AgentRunner {\n    return this.delegate.runner;\n  }\n\n  get a2ui(): CopilotRuntimeOptions[\"a2ui\"] {\n    return this.delegate.a2ui;\n  }\n\n  get mcpApps(): CopilotRuntimeOptions[\"mcpApps\"] {\n    return this.delegate.mcpApps;\n  }\n\n  get openGenerativeUI(): CopilotRuntimeOptions[\"openGenerativeUI\"] {\n    return this.delegate.openGenerativeUI;\n  }\n\n  get intelligence(): CopilotKitIntelligence | undefined {\n    return this.delegate.intelligence;\n  }\n\n  get generateThreadNames(): boolean | undefined {\n    return isIntelligenceRuntime(this.delegate)\n      ? this.delegate.generateThreadNames\n      : undefined;\n  }\n\n  get identifyUser(): IdentifyUserCallback | undefined {\n    return isIntelligenceRuntime(this.delegate)\n      ? this.delegate.identifyUser\n      : undefined;\n  }\n\n  get lockTtlSeconds(): number | undefined {\n    return isIntelligenceRuntime(this.delegate)\n      ? this.delegate.lockTtlSeconds\n      : undefined;\n  }\n\n  get lockKeyPrefix(): string | undefined {\n    return isIntelligenceRuntime(this.delegate)\n      ? this.delegate.lockKeyPrefix\n      : undefined;\n  }\n\n  get lockHeartbeatIntervalSeconds(): number | undefined {\n    return isIntelligenceRuntime(this.delegate)\n      ? this.delegate.lockHeartbeatIntervalSeconds\n      : undefined;\n  }\n\n  get mode(): RuntimeMode {\n    return this.delegate.mode;\n  }\n\n  get licenseChecker() {\n    return this.delegate.licenseChecker;\n  }\n}\n"],"mappings":";;;;;;;;;;AAyBA,MAAa,UAAUA,uBAAI;AAkH3B,IAAe,qBAAf,MAAgE;CAc9D,YAAY,SAAoC,QAAqB;EACnE,MAAM,EACJ,QACA,sBACA,yBACA,wBACA,MACA,SACA,qBACE;AAEJ,OAAK,SAAS;AACd,OAAK,uBAAuB;AAC5B,OAAK,0BAA0B;AAC/B,OAAK,yBAAyB;AAC9B,OAAK,OAAO,QAAQ;AACpB,OAAK,UAAU;AACf,OAAK,mBAAmB;AACxB,OAAK,SAAS;;;AAIlB,IAAa,oBAAb,cACU,mBAEV;CAIE,YAAY,SAAmC;AAC7C,QAAM,SAAS,QAAQ,UAAU,IAAI,qBAAqB,CAAC;sBAJrC;cACR;;;AAOlB,IAAa,6BAAb,MAAa,mCACH,mBAEV;;8BAUyC;;;wCAEU;;CAEjD,YAAY,SAA4C;AACtD,QACE,SACA,IAAI,wBAAwB;GAC1B,KAAK,QAAQ,aAAa,iBAAiB;GAC3C,WAAW,QAAQ,aAAa,qBAAqB;GACrD,gBAAgB,QAAQ;GACxB,aAAa,QAAQ;GACtB,CAAC,CACH;cAhBa;AAiBd,OAAK,eAAe,QAAQ;AAC5B,OAAK,eAAe,QAAQ;AAC5B,OAAK,sBAAsB,QAAQ,uBAAuB;AAC1D,OAAK,iBAAiB,qBAAqB,QAAQ,aAAa;AAChE,OAAK,iBAAiB,KAAK,IACzB,QAAQ,kBAAkB,IAC1B,2BAA2B,qBAC5B;AACD,OAAK,gBAAgB,QAAQ;AAC7B,OAAK,+BAA+B,KAAK,IACvC,QAAQ,gCAAgC,IACxC,2BAA2B,+BAC5B;;;AAIL,SAAS,uBACP,SAC8C;AAC9C,QAAO,kBAAkB,WAAW,CAAC,CAAC,QAAQ;;AAGhD,SAAgB,sBACd,SAC2C;AAC3C,QAAO,QAAQ,SAAS,6BAA6B,CAAC,CAAC,QAAQ;;;;;;AAOjE,IAAa,iBAAb,MAA0D;CAGxD,YAAY,SAAgC;AAC1C,OAAK,WAAW,uBAAuB,QAAQ,GAC3C,IAAI,2BAA2B,QAAQ,GACvC,IAAI,kBAAkB,QAAQ;;CAGpC,IAAI,SAA0C;AAC5C,SAAO,KAAK,SAAS;;CAGvB,IAAI,uBAAsE;AACxE,SAAO,KAAK,SAAS;;CAGvB,IAAI,0BAA4E;AAC9E,SAAO,KAAK,SAAS;;CAGvB,IAAI,yBAA0E;AAC5E,SAAO,KAAK,SAAS;;CAGvB,IAAI,SAAsB;AACxB,SAAO,KAAK,SAAS;;CAGvB,IAAI,OAAsC;AACxC,SAAO,KAAK,SAAS;;CAGvB,IAAI,UAA4C;AAC9C,SAAO,KAAK,SAAS;;CAGvB,IAAI,mBAA8D;AAChE,SAAO,KAAK,SAAS;;CAGvB,IAAI,eAAmD;AACrD,SAAO,KAAK,SAAS;;CAGvB,IAAI,sBAA2C;AAC7C,SAAO,sBAAsB,KAAK,SAAS,GACvC,KAAK,SAAS,sBACd;;CAGN,IAAI,eAAiD;AACnD,SAAO,sBAAsB,KAAK,SAAS,GACvC,KAAK,SAAS,eACd;;CAGN,IAAI,iBAAqC;AACvC,SAAO,sBAAsB,KAAK,SAAS,GACvC,KAAK,SAAS,iBACd;;CAGN,IAAI,gBAAoC;AACtC,SAAO,sBAAsB,KAAK,SAAS,GACvC,KAAK,SAAS,gBACd;;CAGN,IAAI,+BAAmD;AACrD,SAAO,sBAAsB,KAAK,SAAS,GACvC,KAAK,SAAS,+BACd;;CAGN,IAAI,OAAoB;AACtB,SAAO,KAAK,SAAS;;CAGvB,IAAI,iBAAiB;AACnB,SAAO,KAAK,SAAS"}

package/dist/v2/runtime/endpoints/express-fetch-bridge.cjs

@@ -0,0 +1,83 @@
+require("reflect-metadata");
+const require_runtime = require('../../../_virtual/_rolldown/runtime.cjs');
+const require_node_fetch_handler = require('./node-fetch-handler.cjs');
+let _copilotkit_shared = require("@copilotkit/shared");
+let _remix_run_node_fetch_server = require("@remix-run/node-fetch-server");
+
+//#region src/v2/runtime/endpoints/express-fetch-bridge.ts
+const METHODS_WITHOUT_BODY = new Set([
+	"GET",
+	"HEAD",
+	"OPTIONS"
+]);
+/**
+* Creates a Node HTTP handler from a fetch handler, with Express body-parser
+* compatibility. Use this instead of `createNodeFetchHandler` in Express adapters.
+*
+* When the body stream hasn't been consumed, delegates to the generic
+* `createCopilotNodeHandler`. Only intercepts when Express middleware has
+* pre-parsed the body.
+*/
+function createExpressNodeHandler(handler) {
+	const nodeHandler = require_node_fetch_handler.createCopilotNodeHandler(handler);
+	return async (req, res) => {
+		const method = (req.method ?? "GET").toUpperCase();
+		if (METHODS_WITHOUT_BODY.has(method) || !hasPreParsedBody(req)) return nodeHandler(req, res);
+		try {
+			await (0, _remix_run_node_fetch_server.sendResponse)(res, await handler(buildPreParsedRequest(req, res)));
+		} catch (err) {
+			_copilotkit_shared.logger.error({ err }, "Error in Express fetch bridge (pre-parsed path)");
+			if (!res.headersSent) {
+				res.statusCode = 500;
+				res.end("Internal Server Error");
+			}
+		}
+	};
+}
+/**
+* Build a Fetch Request from a Node IncomingMessage whose body stream has
+* already been consumed by an Express body parser.
+*/
+function buildPreParsedRequest(req, res) {
+	const expressReq = req;
+	const method = (req.method ?? "GET").toUpperCase();
+	const url = `${req.protocol || "http"}://${req.headers.host ?? "localhost"}${req.originalUrl ?? req.url ?? ""}`;
+	const headers = new Headers();
+	for (const [key, value] of Object.entries(req.headers)) {
+		if (value === void 0) continue;
+		if (Array.isArray(value)) for (const v of value) headers.append(key, v);
+		else headers.set(key, value);
+	}
+	const controller = new AbortController();
+	res.on("close", () => {
+		if (!res.writableFinished) controller.abort();
+	});
+	const init = {
+		method,
+		headers,
+		signal: controller.signal
+	};
+	const { body, contentType } = synthesizeBody(expressReq.body);
+	if (contentType) headers.set("content-type", contentType);
+	headers.delete("content-length");
+	if (body !== void 0) init.body = body;
+	return new Request(url, init);
+}
+function hasPreParsedBody(req) {
+	if (req.body === void 0 || req.body === null) return false;
+	const state = req._readableState;
+	return Boolean(req.readableEnded || req.complete || state?.ended || state?.endEmitted);
+}
+function synthesizeBody(body) {
+	if (Buffer.isBuffer(body) || body instanceof Uint8Array) return { body };
+	if (typeof body === "string") return { body };
+	if (typeof body === "object" && body !== null) return {
+		body: JSON.stringify(body),
+		contentType: "application/json"
+	};
+	return {};
+}
+
+//#endregion
+exports.createExpressNodeHandler = createExpressNodeHandler;
+//# sourceMappingURL=express-fetch-bridge.cjs.map

package/dist/v2/runtime/endpoints/express-fetch-bridge.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"express-fetch-bridge.cjs","names":["createCopilotNodeHandler"],"sources":["../../../../src/v2/runtime/endpoints/express-fetch-bridge.ts"],"sourcesContent":["/**\n * Express-aware Node ↔ Fetch bridge.\n *\n * When Express body-parsing middleware (e.g. `express.json()`) runs before the\n * CopilotKit router, the Node request stream is already consumed and `req.body`\n * holds the parsed content. The generic `createCopilotNodeHandler` (which uses\n * `@remix-run/node-fetch-server`) would hang because it tries to read from the\n * exhausted stream.\n *\n * This module detects the pre-parsed case and re-serialises `req.body` into the\n * Fetch `Request`, falling back to the generic `createCopilotNodeHandler` when the\n * stream is still available.\n */\n\nimport type { IncomingMessage, ServerResponse } from \"node:http\";\nimport { sendResponse } from \"@remix-run/node-fetch-server\";\nimport { createCopilotNodeHandler } from \"./node-fetch-handler\";\nimport type { CopilotRuntimeFetchHandler } from \"../core/fetch-handler\";\nimport { logger } from \"@copilotkit/shared\";\n\nconst METHODS_WITHOUT_BODY = new Set([\"GET\", \"HEAD\", \"OPTIONS\"]);\n\nexport type ExpressNodeHandler = (\n  req: IncomingMessage,\n  res: ServerResponse,\n) => Promise<void>;\n\n/**\n * Creates a Node HTTP handler from a fetch handler, with Express body-parser\n * compatibility. Use this instead of `createNodeFetchHandler` in Express adapters.\n *\n * When the body stream hasn't been consumed, delegates to the generic\n * `createCopilotNodeHandler`. Only intercepts when Express middleware has\n * pre-parsed the body.\n */\nexport function createExpressNodeHandler(\n  handler: CopilotRuntimeFetchHandler,\n): ExpressNodeHandler {\n  const nodeHandler = createCopilotNodeHandler(handler);\n\n  return async (req: IncomingMessage, res: ServerResponse) => {\n    const method = (req.method ?? \"GET\").toUpperCase();\n\n    // Fast path: if no body parser consumed the stream, use the generic handler.\n    if (METHODS_WITHOUT_BODY.has(method) || !hasPreParsedBody(req)) {\n      return nodeHandler(req, res);\n    }\n\n    // Slow path: body was consumed by Express middleware — rebuild the Request.\n    try {\n      const fetchReq = buildPreParsedRequest(req, res);\n      const fetchRes = await handler(fetchReq);\n      await sendResponse(res, fetchRes);\n    } catch (err: unknown) {\n      logger.error({ err }, \"Error in Express fetch bridge (pre-parsed path)\");\n      if (!res.headersSent) {\n        res.statusCode = 500;\n        res.end(\"Internal Server Error\");\n      }\n    }\n  };\n}\n\n/**\n * Build a Fetch Request from a Node IncomingMessage whose body stream has\n * already been consumed by an Express body parser.\n */\nfunction buildPreParsedRequest(\n  req: IncomingMessage,\n  res: ServerResponse,\n): Request {\n  const expressReq = req as IncomingMessage & { body?: unknown };\n  const method = (req.method ?? \"GET\").toUpperCase();\n\n  const protocol = (req as any).protocol || \"http\";\n  const host = req.headers.host ?? \"localhost\";\n  const url = `${protocol}://${host}${(req as any).originalUrl ?? req.url ?? \"\"}`;\n\n  const headers = new Headers();\n  for (const [key, value] of Object.entries(req.headers)) {\n    if (value === undefined) continue;\n    if (Array.isArray(value)) {\n      for (const v of value) headers.append(key, v);\n    } else {\n      headers.set(key, value);\n    }\n  }\n\n  // Wire an AbortSignal so client disconnects propagate to the fetch handler\n  const controller = new AbortController();\n  res.on(\"close\", () => {\n    if (!res.writableFinished) controller.abort();\n  });\n\n  const init: RequestInit & { duplex?: \"half\" } = {\n    method,\n    headers,\n    signal: controller.signal,\n  };\n\n  const { body, contentType } = synthesizeBody(expressReq.body);\n  if (contentType) {\n    headers.set(\"content-type\", contentType);\n  }\n  headers.delete(\"content-length\");\n  if (body !== undefined) {\n    init.body = body;\n  }\n\n  return new Request(url, init);\n}\n\nfunction hasPreParsedBody(req: IncomingMessage & { body?: unknown }): boolean {\n  if (req.body === undefined || req.body === null) return false;\n\n  // Check if the stream has already been consumed.\n  const state = (req as any)._readableState;\n  return Boolean(\n    req.readableEnded || req.complete || state?.ended || state?.endEmitted,\n  );\n}\n\nfunction synthesizeBody(body: unknown): {\n  body?: BodyInit;\n  contentType?: string;\n} {\n  if (Buffer.isBuffer(body) || body instanceof Uint8Array) {\n    return { body };\n  }\n  if (typeof body === \"string\") {\n    return { body };\n  }\n  if (typeof body === \"object\" && body !== null) {\n    return { body: JSON.stringify(body), contentType: \"application/json\" };\n  }\n  return {};\n}\n"],"mappings":";;;;;;;AAoBA,MAAM,uBAAuB,IAAI,IAAI;CAAC;CAAO;CAAQ;CAAU,CAAC;;;;;;;;;AAehE,SAAgB,yBACd,SACoB;CACpB,MAAM,cAAcA,oDAAyB,QAAQ;AAErD,QAAO,OAAO,KAAsB,QAAwB;EAC1D,MAAM,UAAU,IAAI,UAAU,OAAO,aAAa;AAGlD,MAAI,qBAAqB,IAAI,OAAO,IAAI,CAAC,iBAAiB,IAAI,CAC5D,QAAO,YAAY,KAAK,IAAI;AAI9B,MAAI;AAGF,wDAAmB,KADF,MAAM,QADN,sBAAsB,KAAK,IAAI,CACR,CACP;WAC1B,KAAc;AACrB,6BAAO,MAAM,EAAE,KAAK,EAAE,kDAAkD;AACxE,OAAI,CAAC,IAAI,aAAa;AACpB,QAAI,aAAa;AACjB,QAAI,IAAI,wBAAwB;;;;;;;;;AAUxC,SAAS,sBACP,KACA,KACS;CACT,MAAM,aAAa;CACnB,MAAM,UAAU,IAAI,UAAU,OAAO,aAAa;CAIlD,MAAM,MAAM,GAFM,IAAY,YAAY,OAElB,KADX,IAAI,QAAQ,QAAQ,cACI,IAAY,eAAe,IAAI,OAAO;CAE3E,MAAM,UAAU,IAAI,SAAS;AAC7B,MAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,IAAI,QAAQ,EAAE;AACtD,MAAI,UAAU,OAAW;AACzB,MAAI,MAAM,QAAQ,MAAM,CACtB,MAAK,MAAM,KAAK,MAAO,SAAQ,OAAO,KAAK,EAAE;MAE7C,SAAQ,IAAI,KAAK,MAAM;;CAK3B,MAAM,aAAa,IAAI,iBAAiB;AACxC,KAAI,GAAG,eAAe;AACpB,MAAI,CAAC,IAAI,iBAAkB,YAAW,OAAO;GAC7C;CAEF,MAAM,OAA0C;EAC9C;EACA;EACA,QAAQ,WAAW;EACpB;CAED,MAAM,EAAE,MAAM,gBAAgB,eAAe,WAAW,KAAK;AAC7D,KAAI,YACF,SAAQ,IAAI,gBAAgB,YAAY;AAE1C,SAAQ,OAAO,iBAAiB;AAChC,KAAI,SAAS,OACX,MAAK,OAAO;AAGd,QAAO,IAAI,QAAQ,KAAK,KAAK;;AAG/B,SAAS,iBAAiB,KAAoD;AAC5E,KAAI,IAAI,SAAS,UAAa,IAAI,SAAS,KAAM,QAAO;CAGxD,MAAM,QAAS,IAAY;AAC3B,QAAO,QACL,IAAI,iBAAiB,IAAI,YAAY,OAAO,SAAS,OAAO,WAC7D;;AAGH,SAAS,eAAe,MAGtB;AACA,KAAI,OAAO,SAAS,KAAK,IAAI,gBAAgB,WAC3C,QAAO,EAAE,MAAM;AAEjB,KAAI,OAAO,SAAS,SAClB,QAAO,EAAE,MAAM;AAEjB,KAAI,OAAO,SAAS,YAAY,SAAS,KACvC,QAAO;EAAE,MAAM,KAAK,UAAU,KAAK;EAAE,aAAa;EAAoB;AAExE,QAAO,EAAE"}

package/dist/v2/runtime/endpoints/express-fetch-bridge.mjs

@@ -0,0 +1,82 @@
+import "reflect-metadata";
+import { createCopilotNodeHandler } from "./node-fetch-handler.mjs";
+import { logger } from "@copilotkit/shared";
+import { sendResponse } from "@remix-run/node-fetch-server";
+
+//#region src/v2/runtime/endpoints/express-fetch-bridge.ts
+const METHODS_WITHOUT_BODY = new Set([
+	"GET",
+	"HEAD",
+	"OPTIONS"
+]);
+/**
+* Creates a Node HTTP handler from a fetch handler, with Express body-parser
+* compatibility. Use this instead of `createNodeFetchHandler` in Express adapters.
+*
+* When the body stream hasn't been consumed, delegates to the generic
+* `createCopilotNodeHandler`. Only intercepts when Express middleware has
+* pre-parsed the body.
+*/
+function createExpressNodeHandler(handler) {
+	const nodeHandler = createCopilotNodeHandler(handler);
+	return async (req, res) => {
+		const method = (req.method ?? "GET").toUpperCase();
+		if (METHODS_WITHOUT_BODY.has(method) || !hasPreParsedBody(req)) return nodeHandler(req, res);
+		try {
+			await sendResponse(res, await handler(buildPreParsedRequest(req, res)));
+		} catch (err) {
+			logger.error({ err }, "Error in Express fetch bridge (pre-parsed path)");
+			if (!res.headersSent) {
+				res.statusCode = 500;
+				res.end("Internal Server Error");
+			}
+		}
+	};
+}
+/**
+* Build a Fetch Request from a Node IncomingMessage whose body stream has
+* already been consumed by an Express body parser.
+*/
+function buildPreParsedRequest(req, res) {
+	const expressReq = req;
+	const method = (req.method ?? "GET").toUpperCase();
+	const url = `${req.protocol || "http"}://${req.headers.host ?? "localhost"}${req.originalUrl ?? req.url ?? ""}`;
+	const headers = new Headers();
+	for (const [key, value] of Object.entries(req.headers)) {
+		if (value === void 0) continue;
+		if (Array.isArray(value)) for (const v of value) headers.append(key, v);
+		else headers.set(key, value);
+	}
+	const controller = new AbortController();
+	res.on("close", () => {
+		if (!res.writableFinished) controller.abort();
+	});
+	const init = {
+		method,
+		headers,
+		signal: controller.signal
+	};
+	const { body, contentType } = synthesizeBody(expressReq.body);
+	if (contentType) headers.set("content-type", contentType);
+	headers.delete("content-length");
+	if (body !== void 0) init.body = body;
+	return new Request(url, init);
+}
+function hasPreParsedBody(req) {
+	if (req.body === void 0 || req.body === null) return false;
+	const state = req._readableState;
+	return Boolean(req.readableEnded || req.complete || state?.ended || state?.endEmitted);
+}
+function synthesizeBody(body) {
+	if (Buffer.isBuffer(body) || body instanceof Uint8Array) return { body };
+	if (typeof body === "string") return { body };
+	if (typeof body === "object" && body !== null) return {
+		body: JSON.stringify(body),
+		contentType: "application/json"
+	};
+	return {};
+}
+
+//#endregion
+export { createExpressNodeHandler };
+//# sourceMappingURL=express-fetch-bridge.mjs.map

package/dist/v2/runtime/endpoints/express-fetch-bridge.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"express-fetch-bridge.mjs","names":[],"sources":["../../../../src/v2/runtime/endpoints/express-fetch-bridge.ts"],"sourcesContent":["/**\n * Express-aware Node ↔ Fetch bridge.\n *\n * When Express body-parsing middleware (e.g. `express.json()`) runs before the\n * CopilotKit router, the Node request stream is already consumed and `req.body`\n * holds the parsed content. The generic `createCopilotNodeHandler` (which uses\n * `@remix-run/node-fetch-server`) would hang because it tries to read from the\n * exhausted stream.\n *\n * This module detects the pre-parsed case and re-serialises `req.body` into the\n * Fetch `Request`, falling back to the generic `createCopilotNodeHandler` when the\n * stream is still available.\n */\n\nimport type { IncomingMessage, ServerResponse } from \"node:http\";\nimport { sendResponse } from \"@remix-run/node-fetch-server\";\nimport { createCopilotNodeHandler } from \"./node-fetch-handler\";\nimport type { CopilotRuntimeFetchHandler } from \"../core/fetch-handler\";\nimport { logger } from \"@copilotkit/shared\";\n\nconst METHODS_WITHOUT_BODY = new Set([\"GET\", \"HEAD\", \"OPTIONS\"]);\n\nexport type ExpressNodeHandler = (\n  req: IncomingMessage,\n  res: ServerResponse,\n) => Promise<void>;\n\n/**\n * Creates a Node HTTP handler from a fetch handler, with Express body-parser\n * compatibility. Use this instead of `createNodeFetchHandler` in Express adapters.\n *\n * When the body stream hasn't been consumed, delegates to the generic\n * `createCopilotNodeHandler`. Only intercepts when Express middleware has\n * pre-parsed the body.\n */\nexport function createExpressNodeHandler(\n  handler: CopilotRuntimeFetchHandler,\n): ExpressNodeHandler {\n  const nodeHandler = createCopilotNodeHandler(handler);\n\n  return async (req: IncomingMessage, res: ServerResponse) => {\n    const method = (req.method ?? \"GET\").toUpperCase();\n\n    // Fast path: if no body parser consumed the stream, use the generic handler.\n    if (METHODS_WITHOUT_BODY.has(method) || !hasPreParsedBody(req)) {\n      return nodeHandler(req, res);\n    }\n\n    // Slow path: body was consumed by Express middleware — rebuild the Request.\n    try {\n      const fetchReq = buildPreParsedRequest(req, res);\n      const fetchRes = await handler(fetchReq);\n      await sendResponse(res, fetchRes);\n    } catch (err: unknown) {\n      logger.error({ err }, \"Error in Express fetch bridge (pre-parsed path)\");\n      if (!res.headersSent) {\n        res.statusCode = 500;\n        res.end(\"Internal Server Error\");\n      }\n    }\n  };\n}\n\n/**\n * Build a Fetch Request from a Node IncomingMessage whose body stream has\n * already been consumed by an Express body parser.\n */\nfunction buildPreParsedRequest(\n  req: IncomingMessage,\n  res: ServerResponse,\n): Request {\n  const expressReq = req as IncomingMessage & { body?: unknown };\n  const method = (req.method ?? \"GET\").toUpperCase();\n\n  const protocol = (req as any).protocol || \"http\";\n  const host = req.headers.host ?? \"localhost\";\n  const url = `${protocol}://${host}${(req as any).originalUrl ?? req.url ?? \"\"}`;\n\n  const headers = new Headers();\n  for (const [key, value] of Object.entries(req.headers)) {\n    if (value === undefined) continue;\n    if (Array.isArray(value)) {\n      for (const v of value) headers.append(key, v);\n    } else {\n      headers.set(key, value);\n    }\n  }\n\n  // Wire an AbortSignal so client disconnects propagate to the fetch handler\n  const controller = new AbortController();\n  res.on(\"close\", () => {\n    if (!res.writableFinished) controller.abort();\n  });\n\n  const init: RequestInit & { duplex?: \"half\" } = {\n    method,\n    headers,\n    signal: controller.signal,\n  };\n\n  const { body, contentType } = synthesizeBody(expressReq.body);\n  if (contentType) {\n    headers.set(\"content-type\", contentType);\n  }\n  headers.delete(\"content-length\");\n  if (body !== undefined) {\n    init.body = body;\n  }\n\n  return new Request(url, init);\n}\n\nfunction hasPreParsedBody(req: IncomingMessage & { body?: unknown }): boolean {\n  if (req.body === undefined || req.body === null) return false;\n\n  // Check if the stream has already been consumed.\n  const state = (req as any)._readableState;\n  return Boolean(\n    req.readableEnded || req.complete || state?.ended || state?.endEmitted,\n  );\n}\n\nfunction synthesizeBody(body: unknown): {\n  body?: BodyInit;\n  contentType?: string;\n} {\n  if (Buffer.isBuffer(body) || body instanceof Uint8Array) {\n    return { body };\n  }\n  if (typeof body === \"string\") {\n    return { body };\n  }\n  if (typeof body === \"object\" && body !== null) {\n    return { body: JSON.stringify(body), contentType: \"application/json\" };\n  }\n  return {};\n}\n"],"mappings":";;;;;;AAoBA,MAAM,uBAAuB,IAAI,IAAI;CAAC;CAAO;CAAQ;CAAU,CAAC;;;;;;;;;AAehE,SAAgB,yBACd,SACoB;CACpB,MAAM,cAAc,yBAAyB,QAAQ;AAErD,QAAO,OAAO,KAAsB,QAAwB;EAC1D,MAAM,UAAU,IAAI,UAAU,OAAO,aAAa;AAGlD,MAAI,qBAAqB,IAAI,OAAO,IAAI,CAAC,iBAAiB,IAAI,CAC5D,QAAO,YAAY,KAAK,IAAI;AAI9B,MAAI;AAGF,SAAM,aAAa,KADF,MAAM,QADN,sBAAsB,KAAK,IAAI,CACR,CACP;WAC1B,KAAc;AACrB,UAAO,MAAM,EAAE,KAAK,EAAE,kDAAkD;AACxE,OAAI,CAAC,IAAI,aAAa;AACpB,QAAI,aAAa;AACjB,QAAI,IAAI,wBAAwB;;;;;;;;;AAUxC,SAAS,sBACP,KACA,KACS;CACT,MAAM,aAAa;CACnB,MAAM,UAAU,IAAI,UAAU,OAAO,aAAa;CAIlD,MAAM,MAAM,GAFM,IAAY,YAAY,OAElB,KADX,IAAI,QAAQ,QAAQ,cACI,IAAY,eAAe,IAAI,OAAO;CAE3E,MAAM,UAAU,IAAI,SAAS;AAC7B,MAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,IAAI,QAAQ,EAAE;AACtD,MAAI,UAAU,OAAW;AACzB,MAAI,MAAM,QAAQ,MAAM,CACtB,MAAK,MAAM,KAAK,MAAO,SAAQ,OAAO,KAAK,EAAE;MAE7C,SAAQ,IAAI,KAAK,MAAM;;CAK3B,MAAM,aAAa,IAAI,iBAAiB;AACxC,KAAI,GAAG,eAAe;AACpB,MAAI,CAAC,IAAI,iBAAkB,YAAW,OAAO;GAC7C;CAEF,MAAM,OAA0C;EAC9C;EACA;EACA,QAAQ,WAAW;EACpB;CAED,MAAM,EAAE,MAAM,gBAAgB,eAAe,WAAW,KAAK;AAC7D,KAAI,YACF,SAAQ,IAAI,gBAAgB,YAAY;AAE1C,SAAQ,OAAO,iBAAiB;AAChC,KAAI,SAAS,OACX,MAAK,OAAO;AAGd,QAAO,IAAI,QAAQ,KAAK,KAAK;;AAG/B,SAAS,iBAAiB,KAAoD;AAC5E,KAAI,IAAI,SAAS,UAAa,IAAI,SAAS,KAAM,QAAO;CAGxD,MAAM,QAAS,IAAY;AAC3B,QAAO,QACL,IAAI,iBAAiB,IAAI,YAAY,OAAO,SAAS,OAAO,WAC7D;;AAGH,SAAS,eAAe,MAGtB;AACA,KAAI,OAAO,SAAS,KAAK,IAAI,gBAAgB,WAC3C,QAAO,EAAE,MAAM;AAEjB,KAAI,OAAO,SAAS,SAClB,QAAO,EAAE,MAAM;AAEjB,KAAI,OAAO,SAAS,YAAY,SAAS,KACvC,QAAO;EAAE,MAAM,KAAK,UAAU,KAAK;EAAE,aAAa;EAAoB;AAExE,QAAO,EAAE"}

package/dist/v2/runtime/endpoints/express-single.cjs

@@ -1,188 +1,42 @@
 require("reflect-metadata");
-const require_runtime = require('../../../_virtual/_rolldown/runtime.cjs');
-const require_handle_run = require('../handlers/handle-run.cjs');
-const require_get_runtime_info = require('../handlers/get-runtime-info.cjs');
-const require_handle_transcribe = require('../handlers/handle-transcribe.cjs');
-const require_middleware = require('../middleware.cjs');
-const require_handle_connect = require('../handlers/handle-connect.cjs');
-const require_handle_stop = require('../handlers/handle-stop.cjs');
-const require_single_route_helpers = require('./single-route-helpers.cjs');
-const require_express_utils = require('./express-utils.cjs');
-let _copilotkit_shared = require("@copilotkit/shared");
-let express = require("express");
-express = require_runtime.__toESM(express);
-let cors = require("cors");
-cors = require_runtime.__toESM(cors);
+const require_express = require('./express.cjs');
 
 //#region src/v2/runtime/endpoints/express-single.ts
-function createCopilotEndpointSingleRouteExpress({ runtime, basePath }) {
-	const router = express.default.Router();
-	const routePath = normalizeSingleRoutePath(basePath);
-	router.use((0, cors.default)({
-		origin: "*",
-		methods: [
-			"GET",
-			"HEAD",
-			"PUT",
-			"POST",
-			"DELETE",
-			"PATCH",
-			"OPTIONS"
-		],
-		allowedHeaders: ["*"]
-	}));
-	router.post(routePath, createSingleRouteHandler(runtime));
-	router.use((req, res) => {
-		res.status(404).json({ error: "Not found" });
+/**
+* Creates an Express router that serves the CopilotKit runtime as a single
+* POST endpoint. Clients send a JSON envelope with `{ method, params, body }`
+* to dispatch to the appropriate handler.
+*
+* This is a convenience wrapper around {@link createCopilotExpressHandler}
+* with `mode: "single-route"` and `cors: true`.
+*
+* @example
+* ```typescript
+* import express from "express";
+* import { CopilotRuntime } from "@copilotkit/runtime/v2";
+* import { createCopilotEndpointSingleRouteExpress } from "@copilotkit/runtime/v2/express";
+*
+* const runtime = new CopilotRuntime({
+*   agents: { default: new BuiltInAgent({ model: "openai/gpt-4o-mini" }) },
+* });
+*
+* const app = express();
+* app.use(createCopilotEndpointSingleRouteExpress({
+*   runtime,
+*   basePath: "/api/copilotkit",
+* }));
+* app.listen(4000);
+* ```
+*/
+/** @deprecated Use `createCopilotExpressHandler` with `mode: "single-route"` instead. */
+function createCopilotEndpointSingleRouteExpress({ runtime, basePath, hooks }) {
+	return require_express.createCopilotExpressHandler({
+		runtime,
+		basePath,
+		mode: "single-route",
+		cors: true,
+		hooks
 	});
-	return router;
-}
-function createSingleRouteHandler(runtime) {
-	return async (req, res, next) => {
-		const path = req.originalUrl ?? req.path;
-		let request = require_express_utils.createFetchRequestFromExpress(req);
-		try {
-			const maybeModifiedRequest = await require_middleware.callBeforeRequestMiddleware({
-				runtime,
-				request,
-				path
-			});
-			if (maybeModifiedRequest) request = maybeModifiedRequest;
-		} catch (error) {
-			_copilotkit_shared.logger.error({
-				err: error,
-				url: request.url,
-				path
-			}, "Error running before request middleware");
-			if (error instanceof Response) {
-				try {
-					await require_express_utils.sendFetchResponse(res, error);
-				} catch (streamError) {
-					next(streamError);
-				}
-				return;
-			}
-			next(error);
-			return;
-		}
-		let methodCall;
-		try {
-			methodCall = await require_single_route_helpers.parseMethodCall(request);
-		} catch (error) {
-			if (error instanceof Response) {
-				_copilotkit_shared.logger.warn({ url: request.url }, "Invalid single-route payload");
-				try {
-					await require_express_utils.sendFetchResponse(res, error);
-				} catch (streamError) {
-					next(streamError);
-				}
-				return;
-			}
-			_copilotkit_shared.logger.warn({
-				err: error,
-				url: request.url
-			}, "Invalid single-route payload");
-			res.status(400).json({
-				error: "invalid_request",
-				message: error instanceof Error ? error.message : "Invalid request payload"
-			});
-			return;
-		}
-		try {
-			let response;
-			switch (methodCall.method) {
-				case "agent/run": {
-					const agentId = require_single_route_helpers.expectString(methodCall.params, "agentId");
-					response = await require_handle_run.handleRunAgent({
-						runtime,
-						request: require_single_route_helpers.createJsonRequest(request, methodCall.body),
-						agentId
-					});
-					break;
-				}
-				case "agent/connect": {
-					const agentId = require_single_route_helpers.expectString(methodCall.params, "agentId");
-					response = await require_handle_connect.handleConnectAgent({
-						runtime,
-						request: require_single_route_helpers.createJsonRequest(request, methodCall.body),
-						agentId
-					});
-					break;
-				}
-				case "agent/stop": {
-					const agentId = require_single_route_helpers.expectString(methodCall.params, "agentId");
-					const threadId = require_single_route_helpers.expectString(methodCall.params, "threadId");
-					response = await require_handle_stop.handleStopAgent({
-						runtime,
-						request,
-						agentId,
-						threadId
-					});
-					break;
-				}
-				case "info":
-					response = await require_get_runtime_info.handleGetRuntimeInfo({
-						runtime,
-						request
-					});
-					break;
-				case "transcribe":
-					response = await require_handle_transcribe.handleTranscribe({
-						runtime,
-						request: require_single_route_helpers.createJsonRequest(request, methodCall.body)
-					});
-					break;
-				default: return methodCall.method;
-			}
-			const responseForMiddleware = response.clone();
-			await require_express_utils.sendFetchResponse(res, response);
-			require_middleware.callAfterRequestMiddleware({
-				runtime,
-				response: responseForMiddleware,
-				path
-			}).catch((error) => {
-				_copilotkit_shared.logger.error({
-					err: error,
-					url: req.originalUrl ?? req.url,
-					path
-				}, "Error running after request middleware");
-			});
-		} catch (error) {
-			if (error instanceof Response) {
-				const errorResponseForMiddleware = error.clone();
-				try {
-					await require_express_utils.sendFetchResponse(res, error);
-				} catch (streamError) {
-					next(streamError);
-					return;
-				}
-				require_middleware.callAfterRequestMiddleware({
-					runtime,
-					response: errorResponseForMiddleware,
-					path
-				}).catch((mwError) => {
-					_copilotkit_shared.logger.error({
-						err: mwError,
-						url: req.originalUrl ?? req.url,
-						path
-					}, "Error running after request middleware");
-				});
-				return;
-			}
-			_copilotkit_shared.logger.error({
-				err: error,
-				url: request.url,
-				path
-			}, "Error running single-route handler");
-			next(error);
-		}
-	};
-}
-function normalizeSingleRoutePath(path) {
-	if (!path) throw new Error("basePath must be provided for Express single-route endpoint");
-	if (!path.startsWith("/")) return `/${path}`;
-	if (path.length > 1 && path.endsWith("/")) return path.slice(0, -1);
-	return path;
 }
 
 //#endregion

package/dist/v2/runtime/endpoints/express-single.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"express-single.cjs","names":["createFetchRequestFromExpress","callBeforeRequestMiddleware","sendFetchResponse","parseMethodCall","expectString","handleRunAgent","createJsonRequest","handleConnectAgent","handleStopAgent","handleGetRuntimeInfo","handleTranscribe"],"sources":["../../../../src/v2/runtime/endpoints/express-single.ts"],"sourcesContent":["import express from \"express\";\nimport type {\n  Request as ExpressRequest,\n  Response as ExpressResponse,\n  NextFunction,\n  Router,\n} from \"express\";\nimport cors from \"cors\";\n\nimport { CopilotRuntimeLike } from \"../runtime\";\nimport { handleRunAgent } from \"../handlers/handle-run\";\nimport { handleConnectAgent } from \"../handlers/handle-connect\";\nimport { handleStopAgent } from \"../handlers/handle-stop\";\nimport { handleGetRuntimeInfo } from \"../handlers/get-runtime-info\";\nimport { handleTranscribe } from \"../handlers/handle-transcribe\";\nimport { logger } from \"@copilotkit/shared\";\nimport {\n  callBeforeRequestMiddleware,\n  callAfterRequestMiddleware,\n} from \"../middleware\";\nimport {\n  createFetchRequestFromExpress,\n  sendFetchResponse,\n} from \"./express-utils\";\nimport {\n  createJsonRequest,\n  expectString,\n  MethodCall,\n  parseMethodCall,\n} from \"./single-route-helpers\";\n\ninterface CopilotSingleRouteExpressParams {\n  runtime: CopilotRuntimeLike;\n  basePath: string;\n}\n\nexport function createCopilotEndpointSingleRouteExpress({\n  runtime,\n  basePath,\n}: CopilotSingleRouteExpressParams): Router {\n  const router = express.Router();\n  const routePath = normalizeSingleRoutePath(basePath);\n\n  router.use(\n    cors({\n      origin: \"*\",\n      methods: [\"GET\", \"HEAD\", \"PUT\", \"POST\", \"DELETE\", \"PATCH\", \"OPTIONS\"],\n      allowedHeaders: [\"*\"],\n    }),\n  );\n\n  router.post(routePath, createSingleRouteHandler(runtime));\n\n  router.use((req, res) => {\n    res.status(404).json({ error: \"Not found\" });\n  });\n\n  return router;\n}\n\nfunction createSingleRouteHandler(runtime: CopilotRuntimeLike) {\n  return async (\n    req: ExpressRequest,\n    res: ExpressResponse,\n    next: NextFunction,\n  ) => {\n    const path = req.originalUrl ?? req.path;\n    let request = createFetchRequestFromExpress(req);\n\n    try {\n      const maybeModifiedRequest = await callBeforeRequestMiddleware({\n        runtime,\n        request,\n        path,\n      });\n      if (maybeModifiedRequest) {\n        request = maybeModifiedRequest;\n      }\n    } catch (error) {\n      logger.error(\n        { err: error, url: request.url, path },\n        \"Error running before request middleware\",\n      );\n      if (error instanceof Response) {\n        try {\n          await sendFetchResponse(res, error);\n        } catch (streamError) {\n          next(streamError);\n        }\n        return;\n      }\n      next(error);\n      return;\n    }\n\n    let methodCall: MethodCall;\n    try {\n      methodCall = await parseMethodCall(request);\n    } catch (error) {\n      if (error instanceof Response) {\n        logger.warn({ url: request.url }, \"Invalid single-route payload\");\n        try {\n          await sendFetchResponse(res, error);\n        } catch (streamError) {\n          next(streamError);\n        }\n        return;\n      }\n      logger.warn(\n        { err: error, url: request.url },\n        \"Invalid single-route payload\",\n      );\n      res.status(400).json({\n        error: \"invalid_request\",\n        message:\n          error instanceof Error ? error.message : \"Invalid request payload\",\n      });\n      return;\n    }\n\n    try {\n      let response: Response;\n      switch (methodCall.method) {\n        case \"agent/run\": {\n          const agentId = expectString(methodCall.params, \"agentId\");\n          const handlerRequest = createJsonRequest(request, methodCall.body);\n          response = await handleRunAgent({\n            runtime,\n            request: handlerRequest,\n            agentId,\n          });\n          break;\n        }\n        case \"agent/connect\": {\n          const agentId = expectString(methodCall.params, \"agentId\");\n          const handlerRequest = createJsonRequest(request, methodCall.body);\n          response = await handleConnectAgent({\n            runtime,\n            request: handlerRequest,\n            agentId,\n          });\n          break;\n        }\n        case \"agent/stop\": {\n          const agentId = expectString(methodCall.params, \"agentId\");\n          const threadId = expectString(methodCall.params, \"threadId\");\n          response = await handleStopAgent({\n            runtime,\n            request,\n            agentId,\n            threadId,\n          });\n          break;\n        }\n        case \"info\": {\n          response = await handleGetRuntimeInfo({ runtime, request });\n          break;\n        }\n        case \"transcribe\": {\n          const handlerRequest = createJsonRequest(request, methodCall.body);\n          response = await handleTranscribe({\n            runtime,\n            request: handlerRequest,\n          });\n          break;\n        }\n        default: {\n          const exhaustive: never = methodCall.method;\n          return exhaustive;\n        }\n      }\n\n      const responseForMiddleware = response.clone();\n      await sendFetchResponse(res, response);\n      callAfterRequestMiddleware({\n        runtime,\n        response: responseForMiddleware,\n        path,\n      }).catch((error) => {\n        logger.error(\n          { err: error, url: req.originalUrl ?? req.url, path },\n          \"Error running after request middleware\",\n        );\n      });\n    } catch (error) {\n      if (error instanceof Response) {\n        const errorResponseForMiddleware = error.clone();\n        try {\n          await sendFetchResponse(res, error);\n        } catch (streamError) {\n          next(streamError);\n          return;\n        }\n        callAfterRequestMiddleware({\n          runtime,\n          response: errorResponseForMiddleware,\n          path,\n        }).catch((mwError) => {\n          logger.error(\n            { err: mwError, url: req.originalUrl ?? req.url, path },\n            \"Error running after request middleware\",\n          );\n        });\n        return;\n      }\n      logger.error(\n        { err: error, url: request.url, path },\n        \"Error running single-route handler\",\n      );\n      next(error);\n    }\n  };\n}\n\nfunction normalizeSingleRoutePath(path: string): string {\n  if (!path) {\n    throw new Error(\n      \"basePath must be provided for Express single-route endpoint\",\n    );\n  }\n\n  if (!path.startsWith(\"/\")) {\n    return `/${path}`;\n  }\n\n  if (path.length > 1 && path.endsWith(\"/\")) {\n    return path.slice(0, -1);\n  }\n\n  return path;\n}\n"],"mappings":"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"}
+{"version":3,"file":"express-single.cjs","names":["createCopilotExpressHandler"],"sources":["../../../../src/v2/runtime/endpoints/express-single.ts"],"sourcesContent":["import type { Router } from \"express\";\nimport { createCopilotExpressHandler } from \"./express\";\nimport type { CopilotRuntimeLike } from \"../core/runtime\";\nimport type { CopilotRuntimeHooks } from \"../core/hooks\";\n\ninterface CopilotSingleRouteExpressParams {\n  runtime: CopilotRuntimeLike;\n  basePath: string;\n  /**\n   * Lifecycle hooks for request processing.\n   */\n  hooks?: CopilotRuntimeHooks;\n}\n\n/**\n * Creates an Express router that serves the CopilotKit runtime as a single\n * POST endpoint. Clients send a JSON envelope with `{ method, params, body }`\n * to dispatch to the appropriate handler.\n *\n * This is a convenience wrapper around {@link createCopilotExpressHandler}\n * with `mode: \"single-route\"` and `cors: true`.\n *\n * @example\n * ```typescript\n * import express from \"express\";\n * import { CopilotRuntime } from \"@copilotkit/runtime/v2\";\n * import { createCopilotEndpointSingleRouteExpress } from \"@copilotkit/runtime/v2/express\";\n *\n * const runtime = new CopilotRuntime({\n *   agents: { default: new BuiltInAgent({ model: \"openai/gpt-4o-mini\" }) },\n * });\n *\n * const app = express();\n * app.use(createCopilotEndpointSingleRouteExpress({\n *   runtime,\n *   basePath: \"/api/copilotkit\",\n * }));\n * app.listen(4000);\n * ```\n */\n/** @deprecated Use `createCopilotExpressHandler` with `mode: \"single-route\"` instead. */\nexport function createCopilotEndpointSingleRouteExpress({\n  runtime,\n  basePath,\n  hooks,\n}: CopilotSingleRouteExpressParams): Router {\n  return createCopilotExpressHandler({\n    runtime,\n    basePath,\n    mode: \"single-route\",\n    cors: true,\n    hooks,\n  });\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAyCA,SAAgB,wCAAwC,EACtD,SACA,UACA,SAC0C;AAC1C,QAAOA,4CAA4B;EACjC;EACA;EACA,MAAM;EACN,MAAM;EACN;EACD,CAAC"}

package/dist/v2/runtime/endpoints/express-single.d.cts

@@ -1,15 +1,48 @@
 
-import { CopilotRuntimeLike } from "../runtime.cjs";
+import { CopilotRuntimeLike } from "../core/runtime.cjs";
+import { CopilotRuntimeHooks } from "../core/hooks.cjs";
 import { Router } from "express";
 
 //#region src/v2/runtime/endpoints/express-single.d.ts
 interface CopilotSingleRouteExpressParams {
   runtime: CopilotRuntimeLike;
   basePath: string;
+  /**
+   * Lifecycle hooks for request processing.
+   */
+  hooks?: CopilotRuntimeHooks;
 }
+/**
+ * Creates an Express router that serves the CopilotKit runtime as a single
+ * POST endpoint. Clients send a JSON envelope with `{ method, params, body }`
+ * to dispatch to the appropriate handler.
+ *
+ * This is a convenience wrapper around {@link createCopilotExpressHandler}
+ * with `mode: "single-route"` and `cors: true`.
+ *
+ * @example
+ * ```typescript
+ * import express from "express";
+ * import { CopilotRuntime } from "@copilotkit/runtime/v2";
+ * import { createCopilotEndpointSingleRouteExpress } from "@copilotkit/runtime/v2/express";
+ *
+ * const runtime = new CopilotRuntime({
+ *   agents: { default: new BuiltInAgent({ model: "openai/gpt-4o-mini" }) },
+ * });
+ *
+ * const app = express();
+ * app.use(createCopilotEndpointSingleRouteExpress({
+ *   runtime,
+ *   basePath: "/api/copilotkit",
+ * }));
+ * app.listen(4000);
+ * ```
+ */
+/** @deprecated Use `createCopilotExpressHandler` with `mode: "single-route"` instead. */
 declare function createCopilotEndpointSingleRouteExpress({
   runtime,
-  basePath
+  basePath,
+  hooks
 }: CopilotSingleRouteExpressParams): Router;
 //#endregion
 export { createCopilotEndpointSingleRouteExpress };

package/dist/v2/runtime/endpoints/express-single.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"express-single.d.cts","names":[],"sources":["../../../../src/v2/runtime/endpoints/express-single.ts"],"mappings":";;;;;UA+BU,+BAAA;EACR,OAAA,EAAS,kBAAA;EACT,QAAA;AAAA;AAAA,iBAGc,uCAAA,CAAA;EACd,OAAA;EACA;AAAA,GACC,+BAAA,GAAkC,MAAA"}
+{"version":3,"file":"express-single.d.cts","names":[],"sources":["../../../../src/v2/runtime/endpoints/express-single.ts"],"mappings":";;;;;;UAKU,+BAAA;EACR,OAAA,EAAS,kBAAA;EACT,QAAA;EAFuC;;;EAMvC,KAAA,GAAQ,mBAAA;AAAA;;;;;;AA8BV;;;;;;;;;;;;;;;;;;;;;;iBAAgB,uCAAA,CAAA;EACd,OAAA;EACA,QAAA;EACA;AAAA,GACC,+BAAA,GAAkC,MAAA"}