@copilotkit/runtime 1.80.0 → 1.82.0

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

@@ -1,7 +1,7 @@
 require("reflect-metadata");
 const require_runtime = require('../../../_virtual/_rolldown/runtime.cjs');
 const require_fetch_handler = require('../core/fetch-handler.cjs');
-const require_express_fetch_bridge = require('./express-fetch-bridge.cjs');
+const require_node_fetch_handler = require('./node-fetch-handler.cjs');
 const require_load_express = require('./load-express.cjs');
 const require_auto_start_channels = require('./auto-start-channels.cjs');
 let cors = require("cors");
@@ -19,7 +19,7 @@ function createCopilotExpressHandler({ runtime, basePath, mode = "multi-route",
 		activateChannels,
 		__channelEngine
 	});
-	const nodeHandler = require_express_fetch_bridge.createExpressNodeHandler(handler);
+	const nodeHandler = require_node_fetch_handler.createCopilotNodeHandler(handler);
 	const expressHandler = async (req, res, next) => {
 		try {
 			await nodeHandler(req, res);

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

@@ -1 +1 @@
-{"version":3,"file":"express.cjs","names":["createCopilotRuntimeHandler","createExpressNodeHandler","loadExpress"],"sources":["../../../../src/v2/runtime/endpoints/express.ts"],"sourcesContent":["import type {\n  Request as ExpressRequest,\n  Response as ExpressResponse,\n  NextFunction,\n} from \"express\";\nimport cors from \"cors\";\nimport type { CorsOptions } from \"cors\";\nimport type { CopilotRuntimeLike } from \"../core/runtime\";\nimport { createCopilotRuntimeHandler } from \"../core/fetch-handler\";\nimport type {\n  ActivateChannelEngine,\n  ChannelsControl,\n} from \"../core/channel-manager\";\nimport { createExpressNodeHandler } from \"./express-fetch-bridge\";\nimport { loadExpress } from \"./load-express\";\nimport { autoStartChannels } from \"./auto-start-channels\";\nimport type { CopilotRuntimeHooks } from \"../core/hooks\";\n\n/**\n * The middleware `createCopilotExpressHandler` returns: an Express router that\n * may also carry an optional {@link ChannelsControl} surface. The router object\n * itself is request-scoped middleware, but an Express app can only run inside a\n * long-running `http.Server` — so this wrapper is a lifecycle-owning host like\n * `createCopilotNodeListener`: it STARTS activation of the runtime's declared\n * managed Channels at creation, and `.channels` is here to observe (`ready()`)\n * or tear down (`stop()`) that activation.\n *\n * Deliberately NOT typed as Express's own `Router`. Pinning that type binds our\n * public surface to a single Express major: `@types/express@4` declares\n * `Request.param()` and `@types/express@5` does not, so a v4-typed router is not\n * assignable to a v5 `app.use()` and an Express 5 app cannot compile against us\n * at all (#7276). The call signature below is what `use()` accepts in both\n * majors, and the methods beside it are the router surface both majors share.\n *\n * The runtime value is still a real `express.Router()`; only the declared type\n * is widened.\n */\nexport type CopilotExpressRouter = ((\n  req: any,\n  res: any,\n  next: (err?: unknown) => void,\n) => void) & {\n  channels?: ChannelsControl;\n\n  // The common router-configuration surface, declared structurally so that\n  // consumers who add their own middleware or routes to the returned value keep\n  // compiling. These are NOT taken from either Express major's `Router`, because\n  // that is exactly what makes the type un-mountable across majors.\n  use(...handlers: any[]): CopilotExpressRouter;\n  get(...handlers: any[]): CopilotExpressRouter;\n  post(...handlers: any[]): CopilotExpressRouter;\n  put(...handlers: any[]): CopilotExpressRouter;\n  patch(...handlers: any[]): CopilotExpressRouter;\n  delete(...handlers: any[]): CopilotExpressRouter;\n  options(...handlers: any[]): CopilotExpressRouter;\n  all(...handlers: any[]): CopilotExpressRouter;\n\n  // `route()` and `param()` are the remaining Router-configuration methods\n  // consumers reach for, and dropping them would break\n  // `router.route(\"/x\").get(...)` and `router.param(...)` callers for no gain: a\n  // re-pin to either Express major is caught by\n  // `scripts/validate-dts-imports.ts`, which fails on any published declaration\n  // that names `express` at all.\n  //\n  // `stack` is deliberately absent. It is Express's own internal middleware\n  // array, not a configuration surface, and it is what\n  // `express-major-compat.test-d.ts` asserts against to keep this type from\n  // quietly becoming a `Router` again.\n  route(path: any): any;\n  param(...handlers: any[]): CopilotExpressRouter;\n};\n\nexport interface CopilotExpressEndpointParams {\n  runtime: CopilotRuntimeLike;\n  basePath: string;\n\n  /**\n   * Endpoint mode.\n   * - `\"multi-route\"` (default): separate routes for each operation\n   * - `\"single-route\"`: single POST endpoint with JSON envelope dispatch\n   */\n  mode?: \"multi-route\" | \"single-route\";\n\n  /**\n   * CORS configuration for the Express router.\n   * - `true` (default): permissive CORS (`origin: \"*\"`, all methods, all headers).\n   * - `false`: no CORS middleware is applied — handle it yourself.\n   * - object: passed directly to the Express `cors()` middleware.\n   */\n  cors?: boolean | CorsOptions;\n\n  /**\n   * Lifecycle hooks for request processing.\n   */\n  hooks?: CopilotRuntimeHooks;\n\n  /**\n   * Whether the underlying handler builds the control surface for the runtime's\n   * declared managed Channels — and, because Express is a long-running host,\n   * starts their activation at creation. Defaults to `true`. Set `false` to\n   * build no surface and open no socket (tests, short-lived scripts). See\n   * `CopilotRuntimeHandlerOptions.activateChannels`.\n   */\n  activateChannels?: boolean;\n\n  /**\n   * @internal Test seam: inject a fake Channel activation engine. Forwarded\n   * to `createCopilotRuntimeHandler`. Not part of the public API.\n   */\n  __channelEngine?: ActivateChannelEngine;\n}\n\n/**\n * Creates an Express router that serves the CopilotKit runtime.\n *\n * In **multi-route** mode (default) the router exposes:\n * - `GET  {basePath}/info` — runtime info\n * - `POST {basePath}/agent/:agentId/run` — start an agent run\n * - `POST {basePath}/agent/:agentId/connect` — connect to an agent run\n * - `POST {basePath}/agent/:agentId/stop/:threadId` — stop an agent run\n * - `POST {basePath}/transcribe` — transcribe audio\n *\n * In **single-route** mode a single `POST {basePath}` endpoint accepts a JSON\n * envelope `{ method, params, body }` and dispatches to the appropriate handler.\n *\n * @example\n * ```typescript\n * import express from \"express\";\n * import { CopilotRuntime } from \"@copilotkit/runtime/v2\";\n * import { createCopilotExpressHandler } 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(createCopilotExpressHandler({\n *   runtime,\n *   basePath: \"/api/copilotkit\",\n *   cors: true,\n * }));\n * app.listen(4000);\n * ```\n *\n * @example Single-route mode with lifecycle hooks\n * ```typescript\n * app.use(createCopilotExpressHandler({\n *   runtime,\n *   basePath: \"/api/copilotkit\",\n *   mode: \"single-route\",\n *   hooks: {\n *     onRequest: ({ request }) => {\n *       if (!request.headers.get(\"authorization\")) {\n *         throw new Response(\"Unauthorized\", { status: 401 });\n *       }\n *     },\n *   },\n * }));\n * ```\n */\n/** @deprecated Use `createCopilotExpressHandler` instead. */\nexport { createCopilotExpressHandler as createCopilotEndpointExpress };\n\nexport function createCopilotExpressHandler({\n  runtime,\n  basePath,\n  mode = \"multi-route\",\n  cors: corsOption = true,\n  hooks,\n  activateChannels,\n  __channelEngine,\n}: CopilotExpressEndpointParams): CopilotExpressRouter {\n  const normalizedBase = normalizeBasePath(basePath);\n\n  const handler = createCopilotRuntimeHandler({\n    runtime,\n    basePath: normalizedBase,\n    mode,\n    cors: false, // CORS is handled at the Express middleware layer\n    hooks,\n    activateChannels,\n    __channelEngine,\n  });\n\n  const nodeHandler = createExpressNodeHandler(handler);\n\n  const expressHandler = async (\n    req: ExpressRequest,\n    res: ExpressResponse,\n    next: NextFunction,\n  ) => {\n    try {\n      await nodeHandler(req, res);\n    } catch (err) {\n      next(err);\n    }\n  };\n\n  const router = loadExpress().Router();\n\n  // CORS middleware\n  if (corsOption) {\n    const corsConfig: CorsOptions =\n      corsOption === true\n        ? {\n            origin: \"*\",\n            methods: [\n              \"GET\",\n              \"HEAD\",\n              \"PUT\",\n              \"POST\",\n              \"DELETE\",\n              \"PATCH\",\n              \"OPTIONS\",\n            ],\n            allowedHeaders: [\"*\"],\n          }\n        : corsOption;\n    router.use(cors(corsConfig));\n  }\n\n  // Route mounting\n  if (mode === \"single-route\") {\n    router.post(normalizedBase, expressHandler);\n    router.options(normalizedBase, expressHandler);\n  } else if (normalizedBase === \"/\") {\n    router.all(/.*/, expressHandler);\n  } else {\n    router.all(\n      new RegExp(`^${escapeRegExp(normalizedBase)}(\\\\/.*)?$`),\n      expressHandler,\n    );\n  }\n\n  const exposedRouter: CopilotExpressRouter = router;\n  exposedRouter.channels = handler.channels;\n  autoStartChannels(exposedRouter.channels);\n  return exposedRouter;\n}\n\nfunction escapeRegExp(s: string): string {\n  return s.replace(/[.*+?^${}()|[\\]\\\\]/g, \"\\\\$&\");\n}\n\nfunction normalizeBasePath(path: string): string {\n  if (!path) {\n    throw new Error(\"basePath must be provided for Express endpoint\");\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":";;;;;;;;;;AAmKA,SAAgB,4BAA4B,EAC1C,SACA,UACA,OAAO,eACP,MAAM,aAAa,MACnB,OACA,kBACA,mBACqD;CACrD,MAAM,iBAAiB,kBAAkB,SAAS;CAElD,MAAM,UAAUA,kDAA4B;EAC1C;EACA,UAAU;EACV;EACA,MAAM;EACN;EACA;EACA;EACD,CAAC;CAEF,MAAM,cAAcC,sDAAyB,QAAQ;CAErD,MAAM,iBAAiB,OACrB,KACA,KACA,SACG;AACH,MAAI;AACF,SAAM,YAAY,KAAK,IAAI;WACpB,KAAK;AACZ,QAAK,IAAI;;;CAIb,MAAM,SAASC,kCAAa,CAAC,QAAQ;AAGrC,KAAI,YAAY;EACd,MAAM,aACJ,eAAe,OACX;GACE,QAAQ;GACR,SAAS;IACP;IACA;IACA;IACA;IACA;IACA;IACA;IACD;GACD,gBAAgB,CAAC,IAAI;GACtB,GACD;AACN,SAAO,sBAAS,WAAW,CAAC;;AAI9B,KAAI,SAAS,gBAAgB;AAC3B,SAAO,KAAK,gBAAgB,eAAe;AAC3C,SAAO,QAAQ,gBAAgB,eAAe;YACrC,mBAAmB,IAC5B,QAAO,IAAI,MAAM,eAAe;KAEhC,QAAO,IACL,IAAI,OAAO,IAAI,aAAa,eAAe,CAAC,WAAW,EACvD,eACD;CAGH,MAAM,gBAAsC;AAC5C,eAAc,WAAW,QAAQ;AACjC,+CAAkB,cAAc,SAAS;AACzC,QAAO;;AAGT,SAAS,aAAa,GAAmB;AACvC,QAAO,EAAE,QAAQ,uBAAuB,OAAO;;AAGjD,SAAS,kBAAkB,MAAsB;AAC/C,KAAI,CAAC,KACH,OAAM,IAAI,MAAM,iDAAiD;AAGnE,KAAI,CAAC,KAAK,WAAW,IAAI,CACvB,QAAO,IAAI;AAGb,KAAI,KAAK,SAAS,KAAK,KAAK,SAAS,IAAI,CACvC,QAAO,KAAK,MAAM,GAAG,GAAG;AAG1B,QAAO"}
+{"version":3,"file":"express.cjs","names":["createCopilotRuntimeHandler","createCopilotNodeHandler","loadExpress"],"sources":["../../../../src/v2/runtime/endpoints/express.ts"],"sourcesContent":["import type {\n  Request as ExpressRequest,\n  Response as ExpressResponse,\n  NextFunction,\n} from \"express\";\nimport cors from \"cors\";\nimport type { CorsOptions } from \"cors\";\nimport type { CopilotRuntimeLike } from \"../core/runtime\";\nimport { createCopilotRuntimeHandler } from \"../core/fetch-handler\";\nimport type {\n  ActivateChannelEngine,\n  ChannelsControl,\n} from \"../core/channel-manager\";\nimport { createCopilotNodeHandler } from \"./node-fetch-handler\";\nimport { loadExpress } from \"./load-express\";\nimport { autoStartChannels } from \"./auto-start-channels\";\nimport type { CopilotRuntimeHooks } from \"../core/hooks\";\n\n/**\n * The middleware `createCopilotExpressHandler` returns: an Express router that\n * may also carry an optional {@link ChannelsControl} surface. The router object\n * itself is request-scoped middleware, but an Express app can only run inside a\n * long-running `http.Server` — so this wrapper is a lifecycle-owning host like\n * `createCopilotNodeListener`: it STARTS activation of the runtime's declared\n * managed Channels at creation, and `.channels` is here to observe (`ready()`)\n * or tear down (`stop()`) that activation.\n *\n * Deliberately NOT typed as Express's own `Router`. Pinning that type binds our\n * public surface to a single Express major: `@types/express@4` declares\n * `Request.param()` and `@types/express@5` does not, so a v4-typed router is not\n * assignable to a v5 `app.use()` and an Express 5 app cannot compile against us\n * at all (#7276). The call signature below is what `use()` accepts in both\n * majors, and the methods beside it are the router surface both majors share.\n *\n * The runtime value is still a real `express.Router()`; only the declared type\n * is widened.\n */\nexport type CopilotExpressRouter = ((\n  req: any,\n  res: any,\n  next: (err?: unknown) => void,\n) => void) & {\n  channels?: ChannelsControl;\n\n  // The common router-configuration surface, declared structurally so that\n  // consumers who add their own middleware or routes to the returned value keep\n  // compiling. These are NOT taken from either Express major's `Router`, because\n  // that is exactly what makes the type un-mountable across majors.\n  use(...handlers: any[]): CopilotExpressRouter;\n  get(...handlers: any[]): CopilotExpressRouter;\n  post(...handlers: any[]): CopilotExpressRouter;\n  put(...handlers: any[]): CopilotExpressRouter;\n  patch(...handlers: any[]): CopilotExpressRouter;\n  delete(...handlers: any[]): CopilotExpressRouter;\n  options(...handlers: any[]): CopilotExpressRouter;\n  all(...handlers: any[]): CopilotExpressRouter;\n\n  // `route()` and `param()` are the remaining Router-configuration methods\n  // consumers reach for, and dropping them would break\n  // `router.route(\"/x\").get(...)` and `router.param(...)` callers for no gain: a\n  // re-pin to either Express major is caught by\n  // `scripts/validate-dts-imports.ts`, which fails on any published declaration\n  // that names `express` at all.\n  //\n  // `stack` is deliberately absent. It is Express's own internal middleware\n  // array, not a configuration surface, and it is what\n  // `express-major-compat.test-d.ts` asserts against to keep this type from\n  // quietly becoming a `Router` again.\n  route(path: any): any;\n  param(...handlers: any[]): CopilotExpressRouter;\n};\n\nexport interface CopilotExpressEndpointParams {\n  runtime: CopilotRuntimeLike;\n  basePath: string;\n\n  /**\n   * Endpoint mode.\n   * - `\"multi-route\"` (default): separate routes for each operation\n   * - `\"single-route\"`: single POST endpoint with JSON envelope dispatch\n   */\n  mode?: \"multi-route\" | \"single-route\";\n\n  /**\n   * CORS configuration for the Express router.\n   * - `true` (default): permissive CORS (`origin: \"*\"`, all methods, all headers).\n   * - `false`: no CORS middleware is applied — handle it yourself.\n   * - object: passed directly to the Express `cors()` middleware.\n   */\n  cors?: boolean | CorsOptions;\n\n  /**\n   * Lifecycle hooks for request processing.\n   */\n  hooks?: CopilotRuntimeHooks;\n\n  /**\n   * Whether the underlying handler builds the control surface for the runtime's\n   * declared managed Channels — and, because Express is a long-running host,\n   * starts their activation at creation. Defaults to `true`. Set `false` to\n   * build no surface and open no socket (tests, short-lived scripts). See\n   * `CopilotRuntimeHandlerOptions.activateChannels`.\n   */\n  activateChannels?: boolean;\n\n  /**\n   * @internal Test seam: inject a fake Channel activation engine. Forwarded\n   * to `createCopilotRuntimeHandler`. Not part of the public API.\n   */\n  __channelEngine?: ActivateChannelEngine;\n}\n\n/**\n * Creates an Express router that serves the CopilotKit runtime.\n *\n * In **multi-route** mode (default) the router exposes:\n * - `GET  {basePath}/info` — runtime info\n * - `POST {basePath}/agent/:agentId/run` — start an agent run\n * - `POST {basePath}/agent/:agentId/connect` — connect to an agent run\n * - `POST {basePath}/agent/:agentId/stop/:threadId` — stop an agent run\n * - `POST {basePath}/transcribe` — transcribe audio\n *\n * In **single-route** mode a single `POST {basePath}` endpoint accepts a JSON\n * envelope `{ method, params, body }` and dispatches to the appropriate handler.\n *\n * @example\n * ```typescript\n * import express from \"express\";\n * import { CopilotRuntime } from \"@copilotkit/runtime/v2\";\n * import { createCopilotExpressHandler } 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(createCopilotExpressHandler({\n *   runtime,\n *   basePath: \"/api/copilotkit\",\n *   cors: true,\n * }));\n * app.listen(4000);\n * ```\n *\n * @example Single-route mode with lifecycle hooks\n * ```typescript\n * app.use(createCopilotExpressHandler({\n *   runtime,\n *   basePath: \"/api/copilotkit\",\n *   mode: \"single-route\",\n *   hooks: {\n *     onRequest: ({ request }) => {\n *       if (!request.headers.get(\"authorization\")) {\n *         throw new Response(\"Unauthorized\", { status: 401 });\n *       }\n *     },\n *   },\n * }));\n * ```\n */\n/** @deprecated Use `createCopilotExpressHandler` instead. */\nexport { createCopilotExpressHandler as createCopilotEndpointExpress };\n\nexport function createCopilotExpressHandler({\n  runtime,\n  basePath,\n  mode = \"multi-route\",\n  cors: corsOption = true,\n  hooks,\n  activateChannels,\n  __channelEngine,\n}: CopilotExpressEndpointParams): CopilotExpressRouter {\n  const normalizedBase = normalizeBasePath(basePath);\n\n  const handler = createCopilotRuntimeHandler({\n    runtime,\n    basePath: normalizedBase,\n    mode,\n    cors: false, // CORS is handled at the Express middleware layer\n    hooks,\n    activateChannels,\n    __channelEngine,\n  });\n\n  const nodeHandler = createCopilotNodeHandler(handler);\n\n  const expressHandler = async (\n    req: ExpressRequest,\n    res: ExpressResponse,\n    next: NextFunction,\n  ) => {\n    try {\n      await nodeHandler(req, res);\n    } catch (err) {\n      next(err);\n    }\n  };\n\n  const router = loadExpress().Router();\n\n  // CORS middleware\n  if (corsOption) {\n    const corsConfig: CorsOptions =\n      corsOption === true\n        ? {\n            origin: \"*\",\n            methods: [\n              \"GET\",\n              \"HEAD\",\n              \"PUT\",\n              \"POST\",\n              \"DELETE\",\n              \"PATCH\",\n              \"OPTIONS\",\n            ],\n            allowedHeaders: [\"*\"],\n          }\n        : corsOption;\n    router.use(cors(corsConfig));\n  }\n\n  // Route mounting\n  if (mode === \"single-route\") {\n    router.post(normalizedBase, expressHandler);\n    router.options(normalizedBase, expressHandler);\n  } else if (normalizedBase === \"/\") {\n    router.all(/.*/, expressHandler);\n  } else {\n    router.all(\n      new RegExp(`^${escapeRegExp(normalizedBase)}(\\\\/.*)?$`),\n      expressHandler,\n    );\n  }\n\n  const exposedRouter: CopilotExpressRouter = router;\n  exposedRouter.channels = handler.channels;\n  autoStartChannels(exposedRouter.channels);\n  return exposedRouter;\n}\n\nfunction escapeRegExp(s: string): string {\n  return s.replace(/[.*+?^${}()|[\\]\\\\]/g, \"\\\\$&\");\n}\n\nfunction normalizeBasePath(path: string): string {\n  if (!path) {\n    throw new Error(\"basePath must be provided for Express endpoint\");\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":";;;;;;;;;;AAmKA,SAAgB,4BAA4B,EAC1C,SACA,UACA,OAAO,eACP,MAAM,aAAa,MACnB,OACA,kBACA,mBACqD;CACrD,MAAM,iBAAiB,kBAAkB,SAAS;CAElD,MAAM,UAAUA,kDAA4B;EAC1C;EACA,UAAU;EACV;EACA,MAAM;EACN;EACA;EACA;EACD,CAAC;CAEF,MAAM,cAAcC,oDAAyB,QAAQ;CAErD,MAAM,iBAAiB,OACrB,KACA,KACA,SACG;AACH,MAAI;AACF,SAAM,YAAY,KAAK,IAAI;WACpB,KAAK;AACZ,QAAK,IAAI;;;CAIb,MAAM,SAASC,kCAAa,CAAC,QAAQ;AAGrC,KAAI,YAAY;EACd,MAAM,aACJ,eAAe,OACX;GACE,QAAQ;GACR,SAAS;IACP;IACA;IACA;IACA;IACA;IACA;IACA;IACD;GACD,gBAAgB,CAAC,IAAI;GACtB,GACD;AACN,SAAO,sBAAS,WAAW,CAAC;;AAI9B,KAAI,SAAS,gBAAgB;AAC3B,SAAO,KAAK,gBAAgB,eAAe;AAC3C,SAAO,QAAQ,gBAAgB,eAAe;YACrC,mBAAmB,IAC5B,QAAO,IAAI,MAAM,eAAe;KAEhC,QAAO,IACL,IAAI,OAAO,IAAI,aAAa,eAAe,CAAC,WAAW,EACvD,eACD;CAGH,MAAM,gBAAsC;AAC5C,eAAc,WAAW,QAAQ;AACjC,+CAAkB,cAAc,SAAS;AACzC,QAAO;;AAGT,SAAS,aAAa,GAAmB;AACvC,QAAO,EAAE,QAAQ,uBAAuB,OAAO;;AAGjD,SAAS,kBAAkB,MAAsB;AAC/C,KAAI,CAAC,KACH,OAAM,IAAI,MAAM,iDAAiD;AAGnE,KAAI,CAAC,KAAK,WAAW,IAAI,CACvB,QAAO,IAAI;AAGb,KAAI,KAAK,SAAS,KAAK,KAAK,SAAS,IAAI,CACvC,QAAO,KAAK,MAAM,GAAG,GAAG;AAG1B,QAAO"}

package/dist/v2/runtime/endpoints/express.mjs

@@ -1,6 +1,6 @@
 import "reflect-metadata";
 import { createCopilotRuntimeHandler } from "../core/fetch-handler.mjs";
-import { createExpressNodeHandler } from "./express-fetch-bridge.mjs";
+import { createCopilotNodeHandler } from "./node-fetch-handler.mjs";
 import { loadExpress } from "./load-express.mjs";
 import { autoStartChannels } from "./auto-start-channels.mjs";
 import cors from "cors";
@@ -17,7 +17,7 @@ function createCopilotExpressHandler({ runtime, basePath, mode = "multi-route",
 		activateChannels,
 		__channelEngine
 	});
-	const nodeHandler = createExpressNodeHandler(handler);
+	const nodeHandler = createCopilotNodeHandler(handler);
 	const expressHandler = async (req, res, next) => {
 		try {
 			await nodeHandler(req, res);

package/dist/v2/runtime/endpoints/express.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"express.mjs","names":[],"sources":["../../../../src/v2/runtime/endpoints/express.ts"],"sourcesContent":["import type {\n  Request as ExpressRequest,\n  Response as ExpressResponse,\n  NextFunction,\n} from \"express\";\nimport cors from \"cors\";\nimport type { CorsOptions } from \"cors\";\nimport type { CopilotRuntimeLike } from \"../core/runtime\";\nimport { createCopilotRuntimeHandler } from \"../core/fetch-handler\";\nimport type {\n  ActivateChannelEngine,\n  ChannelsControl,\n} from \"../core/channel-manager\";\nimport { createExpressNodeHandler } from \"./express-fetch-bridge\";\nimport { loadExpress } from \"./load-express\";\nimport { autoStartChannels } from \"./auto-start-channels\";\nimport type { CopilotRuntimeHooks } from \"../core/hooks\";\n\n/**\n * The middleware `createCopilotExpressHandler` returns: an Express router that\n * may also carry an optional {@link ChannelsControl} surface. The router object\n * itself is request-scoped middleware, but an Express app can only run inside a\n * long-running `http.Server` — so this wrapper is a lifecycle-owning host like\n * `createCopilotNodeListener`: it STARTS activation of the runtime's declared\n * managed Channels at creation, and `.channels` is here to observe (`ready()`)\n * or tear down (`stop()`) that activation.\n *\n * Deliberately NOT typed as Express's own `Router`. Pinning that type binds our\n * public surface to a single Express major: `@types/express@4` declares\n * `Request.param()` and `@types/express@5` does not, so a v4-typed router is not\n * assignable to a v5 `app.use()` and an Express 5 app cannot compile against us\n * at all (#7276). The call signature below is what `use()` accepts in both\n * majors, and the methods beside it are the router surface both majors share.\n *\n * The runtime value is still a real `express.Router()`; only the declared type\n * is widened.\n */\nexport type CopilotExpressRouter = ((\n  req: any,\n  res: any,\n  next: (err?: unknown) => void,\n) => void) & {\n  channels?: ChannelsControl;\n\n  // The common router-configuration surface, declared structurally so that\n  // consumers who add their own middleware or routes to the returned value keep\n  // compiling. These are NOT taken from either Express major's `Router`, because\n  // that is exactly what makes the type un-mountable across majors.\n  use(...handlers: any[]): CopilotExpressRouter;\n  get(...handlers: any[]): CopilotExpressRouter;\n  post(...handlers: any[]): CopilotExpressRouter;\n  put(...handlers: any[]): CopilotExpressRouter;\n  patch(...handlers: any[]): CopilotExpressRouter;\n  delete(...handlers: any[]): CopilotExpressRouter;\n  options(...handlers: any[]): CopilotExpressRouter;\n  all(...handlers: any[]): CopilotExpressRouter;\n\n  // `route()` and `param()` are the remaining Router-configuration methods\n  // consumers reach for, and dropping them would break\n  // `router.route(\"/x\").get(...)` and `router.param(...)` callers for no gain: a\n  // re-pin to either Express major is caught by\n  // `scripts/validate-dts-imports.ts`, which fails on any published declaration\n  // that names `express` at all.\n  //\n  // `stack` is deliberately absent. It is Express's own internal middleware\n  // array, not a configuration surface, and it is what\n  // `express-major-compat.test-d.ts` asserts against to keep this type from\n  // quietly becoming a `Router` again.\n  route(path: any): any;\n  param(...handlers: any[]): CopilotExpressRouter;\n};\n\nexport interface CopilotExpressEndpointParams {\n  runtime: CopilotRuntimeLike;\n  basePath: string;\n\n  /**\n   * Endpoint mode.\n   * - `\"multi-route\"` (default): separate routes for each operation\n   * - `\"single-route\"`: single POST endpoint with JSON envelope dispatch\n   */\n  mode?: \"multi-route\" | \"single-route\";\n\n  /**\n   * CORS configuration for the Express router.\n   * - `true` (default): permissive CORS (`origin: \"*\"`, all methods, all headers).\n   * - `false`: no CORS middleware is applied — handle it yourself.\n   * - object: passed directly to the Express `cors()` middleware.\n   */\n  cors?: boolean | CorsOptions;\n\n  /**\n   * Lifecycle hooks for request processing.\n   */\n  hooks?: CopilotRuntimeHooks;\n\n  /**\n   * Whether the underlying handler builds the control surface for the runtime's\n   * declared managed Channels — and, because Express is a long-running host,\n   * starts their activation at creation. Defaults to `true`. Set `false` to\n   * build no surface and open no socket (tests, short-lived scripts). See\n   * `CopilotRuntimeHandlerOptions.activateChannels`.\n   */\n  activateChannels?: boolean;\n\n  /**\n   * @internal Test seam: inject a fake Channel activation engine. Forwarded\n   * to `createCopilotRuntimeHandler`. Not part of the public API.\n   */\n  __channelEngine?: ActivateChannelEngine;\n}\n\n/**\n * Creates an Express router that serves the CopilotKit runtime.\n *\n * In **multi-route** mode (default) the router exposes:\n * - `GET  {basePath}/info` — runtime info\n * - `POST {basePath}/agent/:agentId/run` — start an agent run\n * - `POST {basePath}/agent/:agentId/connect` — connect to an agent run\n * - `POST {basePath}/agent/:agentId/stop/:threadId` — stop an agent run\n * - `POST {basePath}/transcribe` — transcribe audio\n *\n * In **single-route** mode a single `POST {basePath}` endpoint accepts a JSON\n * envelope `{ method, params, body }` and dispatches to the appropriate handler.\n *\n * @example\n * ```typescript\n * import express from \"express\";\n * import { CopilotRuntime } from \"@copilotkit/runtime/v2\";\n * import { createCopilotExpressHandler } 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(createCopilotExpressHandler({\n *   runtime,\n *   basePath: \"/api/copilotkit\",\n *   cors: true,\n * }));\n * app.listen(4000);\n * ```\n *\n * @example Single-route mode with lifecycle hooks\n * ```typescript\n * app.use(createCopilotExpressHandler({\n *   runtime,\n *   basePath: \"/api/copilotkit\",\n *   mode: \"single-route\",\n *   hooks: {\n *     onRequest: ({ request }) => {\n *       if (!request.headers.get(\"authorization\")) {\n *         throw new Response(\"Unauthorized\", { status: 401 });\n *       }\n *     },\n *   },\n * }));\n * ```\n */\n/** @deprecated Use `createCopilotExpressHandler` instead. */\nexport { createCopilotExpressHandler as createCopilotEndpointExpress };\n\nexport function createCopilotExpressHandler({\n  runtime,\n  basePath,\n  mode = \"multi-route\",\n  cors: corsOption = true,\n  hooks,\n  activateChannels,\n  __channelEngine,\n}: CopilotExpressEndpointParams): CopilotExpressRouter {\n  const normalizedBase = normalizeBasePath(basePath);\n\n  const handler = createCopilotRuntimeHandler({\n    runtime,\n    basePath: normalizedBase,\n    mode,\n    cors: false, // CORS is handled at the Express middleware layer\n    hooks,\n    activateChannels,\n    __channelEngine,\n  });\n\n  const nodeHandler = createExpressNodeHandler(handler);\n\n  const expressHandler = async (\n    req: ExpressRequest,\n    res: ExpressResponse,\n    next: NextFunction,\n  ) => {\n    try {\n      await nodeHandler(req, res);\n    } catch (err) {\n      next(err);\n    }\n  };\n\n  const router = loadExpress().Router();\n\n  // CORS middleware\n  if (corsOption) {\n    const corsConfig: CorsOptions =\n      corsOption === true\n        ? {\n            origin: \"*\",\n            methods: [\n              \"GET\",\n              \"HEAD\",\n              \"PUT\",\n              \"POST\",\n              \"DELETE\",\n              \"PATCH\",\n              \"OPTIONS\",\n            ],\n            allowedHeaders: [\"*\"],\n          }\n        : corsOption;\n    router.use(cors(corsConfig));\n  }\n\n  // Route mounting\n  if (mode === \"single-route\") {\n    router.post(normalizedBase, expressHandler);\n    router.options(normalizedBase, expressHandler);\n  } else if (normalizedBase === \"/\") {\n    router.all(/.*/, expressHandler);\n  } else {\n    router.all(\n      new RegExp(`^${escapeRegExp(normalizedBase)}(\\\\/.*)?$`),\n      expressHandler,\n    );\n  }\n\n  const exposedRouter: CopilotExpressRouter = router;\n  exposedRouter.channels = handler.channels;\n  autoStartChannels(exposedRouter.channels);\n  return exposedRouter;\n}\n\nfunction escapeRegExp(s: string): string {\n  return s.replace(/[.*+?^${}()|[\\]\\\\]/g, \"\\\\$&\");\n}\n\nfunction normalizeBasePath(path: string): string {\n  if (!path) {\n    throw new Error(\"basePath must be provided for Express endpoint\");\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":";;;;;;;;AAmKA,SAAgB,4BAA4B,EAC1C,SACA,UACA,OAAO,eACP,MAAM,aAAa,MACnB,OACA,kBACA,mBACqD;CACrD,MAAM,iBAAiB,kBAAkB,SAAS;CAElD,MAAM,UAAU,4BAA4B;EAC1C;EACA,UAAU;EACV;EACA,MAAM;EACN;EACA;EACA;EACD,CAAC;CAEF,MAAM,cAAc,yBAAyB,QAAQ;CAErD,MAAM,iBAAiB,OACrB,KACA,KACA,SACG;AACH,MAAI;AACF,SAAM,YAAY,KAAK,IAAI;WACpB,KAAK;AACZ,QAAK,IAAI;;;CAIb,MAAM,SAAS,aAAa,CAAC,QAAQ;AAGrC,KAAI,YAAY;EACd,MAAM,aACJ,eAAe,OACX;GACE,QAAQ;GACR,SAAS;IACP;IACA;IACA;IACA;IACA;IACA;IACA;IACD;GACD,gBAAgB,CAAC,IAAI;GACtB,GACD;AACN,SAAO,IAAI,KAAK,WAAW,CAAC;;AAI9B,KAAI,SAAS,gBAAgB;AAC3B,SAAO,KAAK,gBAAgB,eAAe;AAC3C,SAAO,QAAQ,gBAAgB,eAAe;YACrC,mBAAmB,IAC5B,QAAO,IAAI,MAAM,eAAe;KAEhC,QAAO,IACL,IAAI,OAAO,IAAI,aAAa,eAAe,CAAC,WAAW,EACvD,eACD;CAGH,MAAM,gBAAsC;AAC5C,eAAc,WAAW,QAAQ;AACjC,mBAAkB,cAAc,SAAS;AACzC,QAAO;;AAGT,SAAS,aAAa,GAAmB;AACvC,QAAO,EAAE,QAAQ,uBAAuB,OAAO;;AAGjD,SAAS,kBAAkB,MAAsB;AAC/C,KAAI,CAAC,KACH,OAAM,IAAI,MAAM,iDAAiD;AAGnE,KAAI,CAAC,KAAK,WAAW,IAAI,CACvB,QAAO,IAAI;AAGb,KAAI,KAAK,SAAS,KAAK,KAAK,SAAS,IAAI,CACvC,QAAO,KAAK,MAAM,GAAG,GAAG;AAG1B,QAAO"}
+{"version":3,"file":"express.mjs","names":[],"sources":["../../../../src/v2/runtime/endpoints/express.ts"],"sourcesContent":["import type {\n  Request as ExpressRequest,\n  Response as ExpressResponse,\n  NextFunction,\n} from \"express\";\nimport cors from \"cors\";\nimport type { CorsOptions } from \"cors\";\nimport type { CopilotRuntimeLike } from \"../core/runtime\";\nimport { createCopilotRuntimeHandler } from \"../core/fetch-handler\";\nimport type {\n  ActivateChannelEngine,\n  ChannelsControl,\n} from \"../core/channel-manager\";\nimport { createCopilotNodeHandler } from \"./node-fetch-handler\";\nimport { loadExpress } from \"./load-express\";\nimport { autoStartChannels } from \"./auto-start-channels\";\nimport type { CopilotRuntimeHooks } from \"../core/hooks\";\n\n/**\n * The middleware `createCopilotExpressHandler` returns: an Express router that\n * may also carry an optional {@link ChannelsControl} surface. The router object\n * itself is request-scoped middleware, but an Express app can only run inside a\n * long-running `http.Server` — so this wrapper is a lifecycle-owning host like\n * `createCopilotNodeListener`: it STARTS activation of the runtime's declared\n * managed Channels at creation, and `.channels` is here to observe (`ready()`)\n * or tear down (`stop()`) that activation.\n *\n * Deliberately NOT typed as Express's own `Router`. Pinning that type binds our\n * public surface to a single Express major: `@types/express@4` declares\n * `Request.param()` and `@types/express@5` does not, so a v4-typed router is not\n * assignable to a v5 `app.use()` and an Express 5 app cannot compile against us\n * at all (#7276). The call signature below is what `use()` accepts in both\n * majors, and the methods beside it are the router surface both majors share.\n *\n * The runtime value is still a real `express.Router()`; only the declared type\n * is widened.\n */\nexport type CopilotExpressRouter = ((\n  req: any,\n  res: any,\n  next: (err?: unknown) => void,\n) => void) & {\n  channels?: ChannelsControl;\n\n  // The common router-configuration surface, declared structurally so that\n  // consumers who add their own middleware or routes to the returned value keep\n  // compiling. These are NOT taken from either Express major's `Router`, because\n  // that is exactly what makes the type un-mountable across majors.\n  use(...handlers: any[]): CopilotExpressRouter;\n  get(...handlers: any[]): CopilotExpressRouter;\n  post(...handlers: any[]): CopilotExpressRouter;\n  put(...handlers: any[]): CopilotExpressRouter;\n  patch(...handlers: any[]): CopilotExpressRouter;\n  delete(...handlers: any[]): CopilotExpressRouter;\n  options(...handlers: any[]): CopilotExpressRouter;\n  all(...handlers: any[]): CopilotExpressRouter;\n\n  // `route()` and `param()` are the remaining Router-configuration methods\n  // consumers reach for, and dropping them would break\n  // `router.route(\"/x\").get(...)` and `router.param(...)` callers for no gain: a\n  // re-pin to either Express major is caught by\n  // `scripts/validate-dts-imports.ts`, which fails on any published declaration\n  // that names `express` at all.\n  //\n  // `stack` is deliberately absent. It is Express's own internal middleware\n  // array, not a configuration surface, and it is what\n  // `express-major-compat.test-d.ts` asserts against to keep this type from\n  // quietly becoming a `Router` again.\n  route(path: any): any;\n  param(...handlers: any[]): CopilotExpressRouter;\n};\n\nexport interface CopilotExpressEndpointParams {\n  runtime: CopilotRuntimeLike;\n  basePath: string;\n\n  /**\n   * Endpoint mode.\n   * - `\"multi-route\"` (default): separate routes for each operation\n   * - `\"single-route\"`: single POST endpoint with JSON envelope dispatch\n   */\n  mode?: \"multi-route\" | \"single-route\";\n\n  /**\n   * CORS configuration for the Express router.\n   * - `true` (default): permissive CORS (`origin: \"*\"`, all methods, all headers).\n   * - `false`: no CORS middleware is applied — handle it yourself.\n   * - object: passed directly to the Express `cors()` middleware.\n   */\n  cors?: boolean | CorsOptions;\n\n  /**\n   * Lifecycle hooks for request processing.\n   */\n  hooks?: CopilotRuntimeHooks;\n\n  /**\n   * Whether the underlying handler builds the control surface for the runtime's\n   * declared managed Channels — and, because Express is a long-running host,\n   * starts their activation at creation. Defaults to `true`. Set `false` to\n   * build no surface and open no socket (tests, short-lived scripts). See\n   * `CopilotRuntimeHandlerOptions.activateChannels`.\n   */\n  activateChannels?: boolean;\n\n  /**\n   * @internal Test seam: inject a fake Channel activation engine. Forwarded\n   * to `createCopilotRuntimeHandler`. Not part of the public API.\n   */\n  __channelEngine?: ActivateChannelEngine;\n}\n\n/**\n * Creates an Express router that serves the CopilotKit runtime.\n *\n * In **multi-route** mode (default) the router exposes:\n * - `GET  {basePath}/info` — runtime info\n * - `POST {basePath}/agent/:agentId/run` — start an agent run\n * - `POST {basePath}/agent/:agentId/connect` — connect to an agent run\n * - `POST {basePath}/agent/:agentId/stop/:threadId` — stop an agent run\n * - `POST {basePath}/transcribe` — transcribe audio\n *\n * In **single-route** mode a single `POST {basePath}` endpoint accepts a JSON\n * envelope `{ method, params, body }` and dispatches to the appropriate handler.\n *\n * @example\n * ```typescript\n * import express from \"express\";\n * import { CopilotRuntime } from \"@copilotkit/runtime/v2\";\n * import { createCopilotExpressHandler } 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(createCopilotExpressHandler({\n *   runtime,\n *   basePath: \"/api/copilotkit\",\n *   cors: true,\n * }));\n * app.listen(4000);\n * ```\n *\n * @example Single-route mode with lifecycle hooks\n * ```typescript\n * app.use(createCopilotExpressHandler({\n *   runtime,\n *   basePath: \"/api/copilotkit\",\n *   mode: \"single-route\",\n *   hooks: {\n *     onRequest: ({ request }) => {\n *       if (!request.headers.get(\"authorization\")) {\n *         throw new Response(\"Unauthorized\", { status: 401 });\n *       }\n *     },\n *   },\n * }));\n * ```\n */\n/** @deprecated Use `createCopilotExpressHandler` instead. */\nexport { createCopilotExpressHandler as createCopilotEndpointExpress };\n\nexport function createCopilotExpressHandler({\n  runtime,\n  basePath,\n  mode = \"multi-route\",\n  cors: corsOption = true,\n  hooks,\n  activateChannels,\n  __channelEngine,\n}: CopilotExpressEndpointParams): CopilotExpressRouter {\n  const normalizedBase = normalizeBasePath(basePath);\n\n  const handler = createCopilotRuntimeHandler({\n    runtime,\n    basePath: normalizedBase,\n    mode,\n    cors: false, // CORS is handled at the Express middleware layer\n    hooks,\n    activateChannels,\n    __channelEngine,\n  });\n\n  const nodeHandler = createCopilotNodeHandler(handler);\n\n  const expressHandler = async (\n    req: ExpressRequest,\n    res: ExpressResponse,\n    next: NextFunction,\n  ) => {\n    try {\n      await nodeHandler(req, res);\n    } catch (err) {\n      next(err);\n    }\n  };\n\n  const router = loadExpress().Router();\n\n  // CORS middleware\n  if (corsOption) {\n    const corsConfig: CorsOptions =\n      corsOption === true\n        ? {\n            origin: \"*\",\n            methods: [\n              \"GET\",\n              \"HEAD\",\n              \"PUT\",\n              \"POST\",\n              \"DELETE\",\n              \"PATCH\",\n              \"OPTIONS\",\n            ],\n            allowedHeaders: [\"*\"],\n          }\n        : corsOption;\n    router.use(cors(corsConfig));\n  }\n\n  // Route mounting\n  if (mode === \"single-route\") {\n    router.post(normalizedBase, expressHandler);\n    router.options(normalizedBase, expressHandler);\n  } else if (normalizedBase === \"/\") {\n    router.all(/.*/, expressHandler);\n  } else {\n    router.all(\n      new RegExp(`^${escapeRegExp(normalizedBase)}(\\\\/.*)?$`),\n      expressHandler,\n    );\n  }\n\n  const exposedRouter: CopilotExpressRouter = router;\n  exposedRouter.channels = handler.channels;\n  autoStartChannels(exposedRouter.channels);\n  return exposedRouter;\n}\n\nfunction escapeRegExp(s: string): string {\n  return s.replace(/[.*+?^${}()|[\\]\\\\]/g, \"\\\\$&\");\n}\n\nfunction normalizeBasePath(path: string): string {\n  if (!path) {\n    throw new Error(\"basePath must be provided for Express endpoint\");\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":";;;;;;;;AAmKA,SAAgB,4BAA4B,EAC1C,SACA,UACA,OAAO,eACP,MAAM,aAAa,MACnB,OACA,kBACA,mBACqD;CACrD,MAAM,iBAAiB,kBAAkB,SAAS;CAElD,MAAM,UAAU,4BAA4B;EAC1C;EACA,UAAU;EACV;EACA,MAAM;EACN;EACA;EACA;EACD,CAAC;CAEF,MAAM,cAAc,yBAAyB,QAAQ;CAErD,MAAM,iBAAiB,OACrB,KACA,KACA,SACG;AACH,MAAI;AACF,SAAM,YAAY,KAAK,IAAI;WACpB,KAAK;AACZ,QAAK,IAAI;;;CAIb,MAAM,SAAS,aAAa,CAAC,QAAQ;AAGrC,KAAI,YAAY;EACd,MAAM,aACJ,eAAe,OACX;GACE,QAAQ;GACR,SAAS;IACP;IACA;IACA;IACA;IACA;IACA;IACA;IACD;GACD,gBAAgB,CAAC,IAAI;GACtB,GACD;AACN,SAAO,IAAI,KAAK,WAAW,CAAC;;AAI9B,KAAI,SAAS,gBAAgB;AAC3B,SAAO,KAAK,gBAAgB,eAAe;AAC3C,SAAO,QAAQ,gBAAgB,eAAe;YACrC,mBAAmB,IAC5B,QAAO,IAAI,MAAM,eAAe;KAEhC,QAAO,IACL,IAAI,OAAO,IAAI,aAAa,eAAe,CAAC,WAAW,EACvD,eACD;CAGH,MAAM,gBAAsC;AAC5C,eAAc,WAAW,QAAQ;AACjC,mBAAkB,cAAc,SAAS;AACzC,QAAO;;AAGT,SAAS,aAAa,GAAmB;AACvC,QAAO,EAAE,QAAQ,uBAAuB,OAAO;;AAGjD,SAAS,kBAAkB,MAAsB;AAC/C,KAAI,CAAC,KACH,OAAM,IAAI,MAAM,iDAAiD;AAGnE,KAAI,CAAC,KAAK,WAAW,IAAI,CACvB,QAAO,IAAI;AAGb,KAAI,KAAK,SAAS,KAAK,KAAK,SAAS,IAAI,CACvC,QAAO,KAAK,MAAM,GAAG,GAAG;AAG1B,QAAO"}

package/dist/v2/runtime/endpoints/node-fetch-handler.cjs

@@ -4,10 +4,16 @@ let _copilotkit_shared = require("@copilotkit/shared");
 let _remix_run_node_fetch_server = require("@remix-run/node-fetch-server");
 
 //#region src/v2/runtime/endpoints/node-fetch-handler.ts
+const METHODS_WITHOUT_BODY = new Set([
+	"GET",
+	"HEAD",
+	"OPTIONS"
+]);
 function createCopilotNodeHandler(handler) {
 	return async (req, res) => {
 		try {
-			await (0, _remix_run_node_fetch_server.sendResponse)(res, await handler((0, _remix_run_node_fetch_server.createRequest)(req, res)));
+			const method = (req.method ?? "GET").toUpperCase();
+			await (0, _remix_run_node_fetch_server.sendResponse)(res, await handler(!METHODS_WITHOUT_BODY.has(method) && hasPreParsedBody(req) ? buildPreParsedRequest(req, res) : (0, _remix_run_node_fetch_server.createRequest)(req, res)));
 		} catch (err) {
 			_copilotkit_shared.logger.error({ err }, "Error in Node fetch handler");
 			if (!res.headersSent) {
@@ -19,6 +25,50 @@ function createCopilotNodeHandler(handler) {
 }
 /** @deprecated Use `createCopilotNodeHandler` instead. */
 const createNodeFetchHandler = createCopilotNodeHandler;
+/**
+* Build a Fetch Request from a Node IncomingMessage whose body stream has
+* already been consumed by a body parser.
+*
+* The URL, headers and abort wiring match `createRequest` (the streaming path),
+* so a request routes the same way whether or not a parser ran first. In
+* particular the URL comes from `req.url`, which is what a mounting router
+* matched against; `originalUrl` still carries the mount prefix and would miss
+* the handler's `basePath`.
+*/
+function buildPreParsedRequest(req, res) {
+	const method = (req.method ?? "GET").toUpperCase();
+	const headers = (0, _remix_run_node_fetch_server.createHeaders)(req);
+	const protocol = "encrypted" in req.socket && req.socket.encrypted ? "https:" : "http:";
+	const host = headers.get("host") ?? "localhost";
+	const url = new URL(req.url ?? "/", `${protocol}//${host}`);
+	const controller = new AbortController();
+	res.on("close", () => {
+		if (!res.writableFinished) controller.abort();
+	});
+	const init = {
+		method,
+		headers,
+		signal: controller.signal
+	};
+	const { body, contentType } = synthesizeBody(req.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;
+	return Boolean(req.readableEnded);
+}
+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.createCopilotNodeHandler = createCopilotNodeHandler;

package/dist/v2/runtime/endpoints/node-fetch-handler.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"node-fetch-handler.cjs","names":[],"sources":["../../../../src/v2/runtime/endpoints/node-fetch-handler.ts"],"sourcesContent":["/**\n * Generic Node ↔ Fetch bridge for CopilotKit runtime.\n *\n * Wraps a `CopilotRuntimeFetchHandler` as a Node HTTP handler using\n * `@remix-run/node-fetch-server` for reliable streaming and conversion.\n *\n * @example\n * ```typescript\n * import { createServer } from \"node:http\";\n * import { createCopilotRuntimeHandler } from \"@copilotkit/runtime/v2\";\n * import { createCopilotNodeHandler } from \"@copilotkit/runtime/v2/node\";\n *\n * const handler = createCopilotRuntimeHandler({ runtime, basePath: \"/api/copilotkit\", cors: true });\n * const nodeHandler = createCopilotNodeHandler(handler);\n * createServer(nodeHandler).listen(3000);\n * ```\n */\n\nimport type { IncomingMessage, ServerResponse } from \"node:http\";\nimport { createRequest, sendResponse } from \"@remix-run/node-fetch-server\";\nimport type { CopilotRuntimeFetchHandler } from \"../core/fetch-handler\";\nimport { logger } from \"@copilotkit/shared\";\n\nexport type NodeFetchHandler = (\n  req: IncomingMessage,\n  res: ServerResponse,\n) => Promise<void>;\n\nexport function createCopilotNodeHandler(\n  handler: CopilotRuntimeFetchHandler,\n): NodeFetchHandler {\n  return async (req: IncomingMessage, res: ServerResponse) => {\n    try {\n      const fetchReq = createRequest(req, res);\n      const fetchRes = await handler(fetchReq);\n      await sendResponse(res, fetchRes);\n    } catch (err: unknown) {\n      logger.error({ err }, \"Error in Node fetch handler\");\n      if (!res.headersSent) {\n        res.statusCode = 500;\n        res.end(\"Internal Server Error\");\n      }\n    }\n  };\n}\n\n/** @deprecated Use `createCopilotNodeHandler` instead. */\nexport const createNodeFetchHandler = createCopilotNodeHandler;\n"],"mappings":";;;;;;AA4BA,SAAgB,yBACd,SACkB;AAClB,QAAO,OAAO,KAAsB,QAAwB;AAC1D,MAAI;AAGF,wDAAmB,KADF,MAAM,wDADQ,KAAK,IAAI,CACA,CACP;WAC1B,KAAc;AACrB,6BAAO,MAAM,EAAE,KAAK,EAAE,8BAA8B;AACpD,OAAI,CAAC,IAAI,aAAa;AACpB,QAAI,aAAa;AACjB,QAAI,IAAI,wBAAwB;;;;;;AAOxC,MAAa,yBAAyB"}
+{"version":3,"file":"node-fetch-handler.cjs","names":[],"sources":["../../../../src/v2/runtime/endpoints/node-fetch-handler.ts"],"sourcesContent":["/**\n * Generic Node ↔ Fetch bridge for CopilotKit runtime.\n *\n * Wraps a `CopilotRuntimeFetchHandler` as a Node HTTP handler using\n * `@remix-run/node-fetch-server` for reliable streaming and conversion.\n *\n * When body-parsing middleware (Express `express.json()`, NestJS's default\n * parser, …) runs first, the Node request stream is already consumed and\n * `req.body` holds the parsed content. Reading the exhausted stream would hang,\n * so that case re-serialises `req.body` into the Fetch `Request` instead.\n *\n * @example\n * ```typescript\n * import { createServer } from \"node:http\";\n * import { createCopilotRuntimeHandler } from \"@copilotkit/runtime/v2\";\n * import { createCopilotNodeHandler } from \"@copilotkit/runtime/v2/node\";\n *\n * const handler = createCopilotRuntimeHandler({ runtime, basePath: \"/api/copilotkit\", cors: true });\n * const nodeHandler = createCopilotNodeHandler(handler);\n * createServer(nodeHandler).listen(3000);\n * ```\n */\n\nimport type { IncomingMessage, ServerResponse } from \"node:http\";\nimport {\n  createHeaders,\n  createRequest,\n  sendResponse,\n} from \"@remix-run/node-fetch-server\";\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 NodeFetchHandler = (\n  req: IncomingMessage,\n  res: ServerResponse,\n) => Promise<void>;\n\nexport function createCopilotNodeHandler(\n  handler: CopilotRuntimeFetchHandler,\n): NodeFetchHandler {\n  return async (req: IncomingMessage, res: ServerResponse) => {\n    try {\n      const method = (req.method ?? \"GET\").toUpperCase();\n      const fetchReq =\n        !METHODS_WITHOUT_BODY.has(method) && hasPreParsedBody(req)\n          ? buildPreParsedRequest(req, res)\n          : createRequest(req, res);\n      const fetchRes = await handler(fetchReq);\n      await sendResponse(res, fetchRes);\n    } catch (err: unknown) {\n      logger.error({ err }, \"Error in Node fetch handler\");\n      if (!res.headersSent) {\n        res.statusCode = 500;\n        res.end(\"Internal Server Error\");\n      }\n    }\n  };\n}\n\n/** @deprecated Use `createCopilotNodeHandler` instead. */\nexport const createNodeFetchHandler = createCopilotNodeHandler;\n\n/**\n * Build a Fetch Request from a Node IncomingMessage whose body stream has\n * already been consumed by a body parser.\n *\n * The URL, headers and abort wiring match `createRequest` (the streaming path),\n * so a request routes the same way whether or not a parser ran first. In\n * particular the URL comes from `req.url`, which is what a mounting router\n * matched against; `originalUrl` still carries the mount prefix and would miss\n * the handler's `basePath`.\n */\nfunction buildPreParsedRequest(\n  req: IncomingMessage & { body?: unknown },\n  res: ServerResponse,\n): Request {\n  const method = (req.method ?? \"GET\").toUpperCase();\n  const headers = createHeaders(req);\n  const protocol =\n    \"encrypted\" in req.socket && req.socket.encrypted ? \"https:\" : \"http:\";\n  const host = headers.get(\"host\") ?? \"localhost\";\n  const url = new URL(req.url ?? \"/\", `${protocol}//${host}`);\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 = {\n    method,\n    headers,\n    signal: controller.signal,\n  };\n\n  const { body, contentType } = synthesizeBody(req.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  // Only `readableEnded` means \"a parser drained this stream to its end\".\n  // `req.complete` and the private `_readableState.ended` are set by the HTTP\n  // parser once the socket has all the bytes, whether or not anything read them.\n  //\n  // That distinction matters because `req.body` being set does not prove a parser\n  // ran: body-parser 1.x (Express 4) assigns `req.body = req.body || {}` before\n  // its own content-type checks, so a request it declines to parse — multipart\n  // upload, text/plain — reaches us with `req.body === {}` and a full, unread\n  // stream. Treating that as pre-parsed rebuilt the request from `{}` and\n  // dropped the real payload.\n  return Boolean(req.readableEnded);\n}\n\nfunction synthesizeBody(body: unknown): {\n  body?: BodyInit;\n  contentType?: string;\n} {\n  if (Buffer.isBuffer(body) || body instanceof Uint8Array) {\n    // Buffer/Uint8Array<ArrayBufferLike> are valid fetch bodies at runtime,\n    // but the DOM lib's BodyInit only admits ArrayBuffer-backed views.\n    return { body: body as BodyInit };\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":";;;;;;AAgCA,MAAM,uBAAuB,IAAI,IAAI;CAAC;CAAO;CAAQ;CAAU,CAAC;AAOhE,SAAgB,yBACd,SACkB;AAClB,QAAO,OAAO,KAAsB,QAAwB;AAC1D,MAAI;GACF,MAAM,UAAU,IAAI,UAAU,OAAO,aAAa;AAMlD,wDAAmB,KADF,MAAM,QAHrB,CAAC,qBAAqB,IAAI,OAAO,IAAI,iBAAiB,IAAI,GACtD,sBAAsB,KAAK,IAAI,mDACjB,KAAK,IAAI,CACW,CACP;WAC1B,KAAc;AACrB,6BAAO,MAAM,EAAE,KAAK,EAAE,8BAA8B;AACpD,OAAI,CAAC,IAAI,aAAa;AACpB,QAAI,aAAa;AACjB,QAAI,IAAI,wBAAwB;;;;;;AAOxC,MAAa,yBAAyB;;;;;;;;;;;AAYtC,SAAS,sBACP,KACA,KACS;CACT,MAAM,UAAU,IAAI,UAAU,OAAO,aAAa;CAClD,MAAM,0DAAwB,IAAI;CAClC,MAAM,WACJ,eAAe,IAAI,UAAU,IAAI,OAAO,YAAY,WAAW;CACjE,MAAM,OAAO,QAAQ,IAAI,OAAO,IAAI;CACpC,MAAM,MAAM,IAAI,IAAI,IAAI,OAAO,KAAK,GAAG,SAAS,IAAI,OAAO;CAG3D,MAAM,aAAa,IAAI,iBAAiB;AACxC,KAAI,GAAG,eAAe;AACpB,MAAI,CAAC,IAAI,iBAAkB,YAAW,OAAO;GAC7C;CAEF,MAAM,OAAoB;EACxB;EACA;EACA,QAAQ,WAAW;EACpB;CAED,MAAM,EAAE,MAAM,gBAAgB,eAAe,IAAI,KAAK;AACtD,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;AAYxD,QAAO,QAAQ,IAAI,cAAc;;AAGnC,SAAS,eAAe,MAGtB;AACA,KAAI,OAAO,SAAS,KAAK,IAAI,gBAAgB,WAG3C,QAAO,EAAQ,MAAkB;AAEnC,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/node-fetch-handler.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"node-fetch-handler.d.cts","names":[],"sources":["../../../../src/v2/runtime/endpoints/node-fetch-handler.ts"],"mappings":";;;;;KAuBY,gBAAA,IACV,GAAA,EAAK,eAAA,EACL,GAAA,EAAK,cAAA,KACF,OAAA;AAAA,iBAEW,wBAAA,CACd,OAAA,EAAS,0BAAA,GACR,gBAAA;;cAiBU,sBAAA,SAAsB,wBAAA"}
+{"version":3,"file":"node-fetch-handler.d.cts","names":[],"sources":["../../../../src/v2/runtime/endpoints/node-fetch-handler.ts"],"mappings":";;;;;KAkCY,gBAAA,IACV,GAAA,EAAK,eAAA,EACL,GAAA,EAAK,cAAA,KACF,OAAA;AAAA,iBAEW,wBAAA,CACd,OAAA,EAAS,0BAAA,GACR,gBAAA;;cAqBU,sBAAA,SAAsB,wBAAA"}

package/dist/v2/runtime/endpoints/node-fetch-handler.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"node-fetch-handler.d.mts","names":[],"sources":["../../../../src/v2/runtime/endpoints/node-fetch-handler.ts"],"mappings":";;;;;KAuBY,gBAAA,IACV,GAAA,EAAK,eAAA,EACL,GAAA,EAAK,cAAA,KACF,OAAA;AAAA,iBAEW,wBAAA,CACd,OAAA,EAAS,0BAAA,GACR,gBAAA;;cAiBU,sBAAA,SAAsB,wBAAA"}
+{"version":3,"file":"node-fetch-handler.d.mts","names":[],"sources":["../../../../src/v2/runtime/endpoints/node-fetch-handler.ts"],"mappings":";;;;;KAkCY,gBAAA,IACV,GAAA,EAAK,eAAA,EACL,GAAA,EAAK,cAAA,KACF,OAAA;AAAA,iBAEW,wBAAA,CACd,OAAA,EAAS,0BAAA,GACR,gBAAA;;cAqBU,sBAAA,SAAsB,wBAAA"}

package/dist/v2/runtime/endpoints/node-fetch-handler.mjs

@@ -1,12 +1,18 @@
 import "reflect-metadata";
 import { logger } from "@copilotkit/shared";
-import { createRequest, sendResponse } from "@remix-run/node-fetch-server";
+import { createHeaders, createRequest, sendResponse } from "@remix-run/node-fetch-server";
 
 //#region src/v2/runtime/endpoints/node-fetch-handler.ts
+const METHODS_WITHOUT_BODY = new Set([
+	"GET",
+	"HEAD",
+	"OPTIONS"
+]);
 function createCopilotNodeHandler(handler) {
 	return async (req, res) => {
 		try {
-			await sendResponse(res, await handler(createRequest(req, res)));
+			const method = (req.method ?? "GET").toUpperCase();
+			await sendResponse(res, await handler(!METHODS_WITHOUT_BODY.has(method) && hasPreParsedBody(req) ? buildPreParsedRequest(req, res) : createRequest(req, res)));
 		} catch (err) {
 			logger.error({ err }, "Error in Node fetch handler");
 			if (!res.headersSent) {
@@ -18,6 +24,50 @@ function createCopilotNodeHandler(handler) {
 }
 /** @deprecated Use `createCopilotNodeHandler` instead. */
 const createNodeFetchHandler = createCopilotNodeHandler;
+/**
+* Build a Fetch Request from a Node IncomingMessage whose body stream has
+* already been consumed by a body parser.
+*
+* The URL, headers and abort wiring match `createRequest` (the streaming path),
+* so a request routes the same way whether or not a parser ran first. In
+* particular the URL comes from `req.url`, which is what a mounting router
+* matched against; `originalUrl` still carries the mount prefix and would miss
+* the handler's `basePath`.
+*/
+function buildPreParsedRequest(req, res) {
+	const method = (req.method ?? "GET").toUpperCase();
+	const headers = createHeaders(req);
+	const protocol = "encrypted" in req.socket && req.socket.encrypted ? "https:" : "http:";
+	const host = headers.get("host") ?? "localhost";
+	const url = new URL(req.url ?? "/", `${protocol}//${host}`);
+	const controller = new AbortController();
+	res.on("close", () => {
+		if (!res.writableFinished) controller.abort();
+	});
+	const init = {
+		method,
+		headers,
+		signal: controller.signal
+	};
+	const { body, contentType } = synthesizeBody(req.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;
+	return Boolean(req.readableEnded);
+}
+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 { createCopilotNodeHandler, createNodeFetchHandler };

package/dist/v2/runtime/endpoints/node-fetch-handler.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"node-fetch-handler.mjs","names":[],"sources":["../../../../src/v2/runtime/endpoints/node-fetch-handler.ts"],"sourcesContent":["/**\n * Generic Node ↔ Fetch bridge for CopilotKit runtime.\n *\n * Wraps a `CopilotRuntimeFetchHandler` as a Node HTTP handler using\n * `@remix-run/node-fetch-server` for reliable streaming and conversion.\n *\n * @example\n * ```typescript\n * import { createServer } from \"node:http\";\n * import { createCopilotRuntimeHandler } from \"@copilotkit/runtime/v2\";\n * import { createCopilotNodeHandler } from \"@copilotkit/runtime/v2/node\";\n *\n * const handler = createCopilotRuntimeHandler({ runtime, basePath: \"/api/copilotkit\", cors: true });\n * const nodeHandler = createCopilotNodeHandler(handler);\n * createServer(nodeHandler).listen(3000);\n * ```\n */\n\nimport type { IncomingMessage, ServerResponse } from \"node:http\";\nimport { createRequest, sendResponse } from \"@remix-run/node-fetch-server\";\nimport type { CopilotRuntimeFetchHandler } from \"../core/fetch-handler\";\nimport { logger } from \"@copilotkit/shared\";\n\nexport type NodeFetchHandler = (\n  req: IncomingMessage,\n  res: ServerResponse,\n) => Promise<void>;\n\nexport function createCopilotNodeHandler(\n  handler: CopilotRuntimeFetchHandler,\n): NodeFetchHandler {\n  return async (req: IncomingMessage, res: ServerResponse) => {\n    try {\n      const fetchReq = createRequest(req, res);\n      const fetchRes = await handler(fetchReq);\n      await sendResponse(res, fetchRes);\n    } catch (err: unknown) {\n      logger.error({ err }, \"Error in Node fetch handler\");\n      if (!res.headersSent) {\n        res.statusCode = 500;\n        res.end(\"Internal Server Error\");\n      }\n    }\n  };\n}\n\n/** @deprecated Use `createCopilotNodeHandler` instead. */\nexport const createNodeFetchHandler = createCopilotNodeHandler;\n"],"mappings":";;;;;AA4BA,SAAgB,yBACd,SACkB;AAClB,QAAO,OAAO,KAAsB,QAAwB;AAC1D,MAAI;AAGF,SAAM,aAAa,KADF,MAAM,QADN,cAAc,KAAK,IAAI,CACA,CACP;WAC1B,KAAc;AACrB,UAAO,MAAM,EAAE,KAAK,EAAE,8BAA8B;AACpD,OAAI,CAAC,IAAI,aAAa;AACpB,QAAI,aAAa;AACjB,QAAI,IAAI,wBAAwB;;;;;;AAOxC,MAAa,yBAAyB"}
+{"version":3,"file":"node-fetch-handler.mjs","names":[],"sources":["../../../../src/v2/runtime/endpoints/node-fetch-handler.ts"],"sourcesContent":["/**\n * Generic Node ↔ Fetch bridge for CopilotKit runtime.\n *\n * Wraps a `CopilotRuntimeFetchHandler` as a Node HTTP handler using\n * `@remix-run/node-fetch-server` for reliable streaming and conversion.\n *\n * When body-parsing middleware (Express `express.json()`, NestJS's default\n * parser, …) runs first, the Node request stream is already consumed and\n * `req.body` holds the parsed content. Reading the exhausted stream would hang,\n * so that case re-serialises `req.body` into the Fetch `Request` instead.\n *\n * @example\n * ```typescript\n * import { createServer } from \"node:http\";\n * import { createCopilotRuntimeHandler } from \"@copilotkit/runtime/v2\";\n * import { createCopilotNodeHandler } from \"@copilotkit/runtime/v2/node\";\n *\n * const handler = createCopilotRuntimeHandler({ runtime, basePath: \"/api/copilotkit\", cors: true });\n * const nodeHandler = createCopilotNodeHandler(handler);\n * createServer(nodeHandler).listen(3000);\n * ```\n */\n\nimport type { IncomingMessage, ServerResponse } from \"node:http\";\nimport {\n  createHeaders,\n  createRequest,\n  sendResponse,\n} from \"@remix-run/node-fetch-server\";\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 NodeFetchHandler = (\n  req: IncomingMessage,\n  res: ServerResponse,\n) => Promise<void>;\n\nexport function createCopilotNodeHandler(\n  handler: CopilotRuntimeFetchHandler,\n): NodeFetchHandler {\n  return async (req: IncomingMessage, res: ServerResponse) => {\n    try {\n      const method = (req.method ?? \"GET\").toUpperCase();\n      const fetchReq =\n        !METHODS_WITHOUT_BODY.has(method) && hasPreParsedBody(req)\n          ? buildPreParsedRequest(req, res)\n          : createRequest(req, res);\n      const fetchRes = await handler(fetchReq);\n      await sendResponse(res, fetchRes);\n    } catch (err: unknown) {\n      logger.error({ err }, \"Error in Node fetch handler\");\n      if (!res.headersSent) {\n        res.statusCode = 500;\n        res.end(\"Internal Server Error\");\n      }\n    }\n  };\n}\n\n/** @deprecated Use `createCopilotNodeHandler` instead. */\nexport const createNodeFetchHandler = createCopilotNodeHandler;\n\n/**\n * Build a Fetch Request from a Node IncomingMessage whose body stream has\n * already been consumed by a body parser.\n *\n * The URL, headers and abort wiring match `createRequest` (the streaming path),\n * so a request routes the same way whether or not a parser ran first. In\n * particular the URL comes from `req.url`, which is what a mounting router\n * matched against; `originalUrl` still carries the mount prefix and would miss\n * the handler's `basePath`.\n */\nfunction buildPreParsedRequest(\n  req: IncomingMessage & { body?: unknown },\n  res: ServerResponse,\n): Request {\n  const method = (req.method ?? \"GET\").toUpperCase();\n  const headers = createHeaders(req);\n  const protocol =\n    \"encrypted\" in req.socket && req.socket.encrypted ? \"https:\" : \"http:\";\n  const host = headers.get(\"host\") ?? \"localhost\";\n  const url = new URL(req.url ?? \"/\", `${protocol}//${host}`);\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 = {\n    method,\n    headers,\n    signal: controller.signal,\n  };\n\n  const { body, contentType } = synthesizeBody(req.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  // Only `readableEnded` means \"a parser drained this stream to its end\".\n  // `req.complete` and the private `_readableState.ended` are set by the HTTP\n  // parser once the socket has all the bytes, whether or not anything read them.\n  //\n  // That distinction matters because `req.body` being set does not prove a parser\n  // ran: body-parser 1.x (Express 4) assigns `req.body = req.body || {}` before\n  // its own content-type checks, so a request it declines to parse — multipart\n  // upload, text/plain — reaches us with `req.body === {}` and a full, unread\n  // stream. Treating that as pre-parsed rebuilt the request from `{}` and\n  // dropped the real payload.\n  return Boolean(req.readableEnded);\n}\n\nfunction synthesizeBody(body: unknown): {\n  body?: BodyInit;\n  contentType?: string;\n} {\n  if (Buffer.isBuffer(body) || body instanceof Uint8Array) {\n    // Buffer/Uint8Array<ArrayBufferLike> are valid fetch bodies at runtime,\n    // but the DOM lib's BodyInit only admits ArrayBuffer-backed views.\n    return { body: body as BodyInit };\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":";;;;;AAgCA,MAAM,uBAAuB,IAAI,IAAI;CAAC;CAAO;CAAQ;CAAU,CAAC;AAOhE,SAAgB,yBACd,SACkB;AAClB,QAAO,OAAO,KAAsB,QAAwB;AAC1D,MAAI;GACF,MAAM,UAAU,IAAI,UAAU,OAAO,aAAa;AAMlD,SAAM,aAAa,KADF,MAAM,QAHrB,CAAC,qBAAqB,IAAI,OAAO,IAAI,iBAAiB,IAAI,GACtD,sBAAsB,KAAK,IAAI,GAC/B,cAAc,KAAK,IAAI,CACW,CACP;WAC1B,KAAc;AACrB,UAAO,MAAM,EAAE,KAAK,EAAE,8BAA8B;AACpD,OAAI,CAAC,IAAI,aAAa;AACpB,QAAI,aAAa;AACjB,QAAI,IAAI,wBAAwB;;;;;;AAOxC,MAAa,yBAAyB;;;;;;;;;;;AAYtC,SAAS,sBACP,KACA,KACS;CACT,MAAM,UAAU,IAAI,UAAU,OAAO,aAAa;CAClD,MAAM,UAAU,cAAc,IAAI;CAClC,MAAM,WACJ,eAAe,IAAI,UAAU,IAAI,OAAO,YAAY,WAAW;CACjE,MAAM,OAAO,QAAQ,IAAI,OAAO,IAAI;CACpC,MAAM,MAAM,IAAI,IAAI,IAAI,OAAO,KAAK,GAAG,SAAS,IAAI,OAAO;CAG3D,MAAM,aAAa,IAAI,iBAAiB;AACxC,KAAI,GAAG,eAAe;AACpB,MAAI,CAAC,IAAI,iBAAkB,YAAW,OAAO;GAC7C;CAEF,MAAM,OAAoB;EACxB;EACA;EACA,QAAQ,WAAW;EACpB;CAED,MAAM,EAAE,MAAM,gBAAgB,eAAe,IAAI,KAAK;AACtD,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;AAYxD,QAAO,QAAQ,IAAI,cAAc;;AAGnC,SAAS,eAAe,MAGtB;AACA,KAAI,OAAO,SAAS,KAAK,IAAI,gBAAgB,WAG3C,QAAO,EAAQ,MAAkB;AAEnC,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"}