@copilotkit/runtime 1.55.0-next.8 → 1.55.0

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

@@ -1,15 +1,48 @@
 import "reflect-metadata";
-import { CopilotRuntimeLike } from "../runtime.mjs";
+import { CopilotRuntimeLike } from "../core/runtime.mjs";
+import { CopilotRuntimeHooks } from "../core/hooks.mjs";
 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.mts.map

@@ -1 +1 @@
-{"version":3,"file":"express-single.d.mts","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.mts","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"}

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

@@ -1,185 +1,42 @@
 import "reflect-metadata";
-import { handleRunAgent } from "../handlers/handle-run.mjs";
-import { handleGetRuntimeInfo } from "../handlers/get-runtime-info.mjs";
-import { handleTranscribe } from "../handlers/handle-transcribe.mjs";
-import { callAfterRequestMiddleware, callBeforeRequestMiddleware } from "../middleware.mjs";
-import { handleConnectAgent } from "../handlers/handle-connect.mjs";
-import { handleStopAgent } from "../handlers/handle-stop.mjs";
-import { createJsonRequest, expectString, parseMethodCall } from "./single-route-helpers.mjs";
-import { createFetchRequestFromExpress, sendFetchResponse } from "./express-utils.mjs";
-import { logger } from "@copilotkit/shared";
-import express from "express";
-import cors from "cors";
+import { createCopilotExpressHandler } from "./express.mjs";
 
 //#region src/v2/runtime/endpoints/express-single.ts
-function createCopilotEndpointSingleRouteExpress({ runtime, basePath }) {
-	const router = express.Router();
-	const routePath = normalizeSingleRoutePath(basePath);
-	router.use(cors({
-		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 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 = createFetchRequestFromExpress(req);
-		try {
-			const maybeModifiedRequest = await callBeforeRequestMiddleware({
-				runtime,
-				request,
-				path
-			});
-			if (maybeModifiedRequest) request = maybeModifiedRequest;
-		} catch (error) {
-			logger.error({
-				err: error,
-				url: request.url,
-				path
-			}, "Error running before request middleware");
-			if (error instanceof Response) {
-				try {
-					await sendFetchResponse(res, error);
-				} catch (streamError) {
-					next(streamError);
-				}
-				return;
-			}
-			next(error);
-			return;
-		}
-		let methodCall;
-		try {
-			methodCall = await parseMethodCall(request);
-		} catch (error) {
-			if (error instanceof Response) {
-				logger.warn({ url: request.url }, "Invalid single-route payload");
-				try {
-					await sendFetchResponse(res, error);
-				} catch (streamError) {
-					next(streamError);
-				}
-				return;
-			}
-			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 = expectString(methodCall.params, "agentId");
-					response = await handleRunAgent({
-						runtime,
-						request: createJsonRequest(request, methodCall.body),
-						agentId
-					});
-					break;
-				}
-				case "agent/connect": {
-					const agentId = expectString(methodCall.params, "agentId");
-					response = await handleConnectAgent({
-						runtime,
-						request: createJsonRequest(request, methodCall.body),
-						agentId
-					});
-					break;
-				}
-				case "agent/stop": {
-					const agentId = expectString(methodCall.params, "agentId");
-					const threadId = expectString(methodCall.params, "threadId");
-					response = await handleStopAgent({
-						runtime,
-						request,
-						agentId,
-						threadId
-					});
-					break;
-				}
-				case "info":
-					response = await handleGetRuntimeInfo({
-						runtime,
-						request
-					});
-					break;
-				case "transcribe":
-					response = await handleTranscribe({
-						runtime,
-						request: createJsonRequest(request, methodCall.body)
-					});
-					break;
-				default: return methodCall.method;
-			}
-			const responseForMiddleware = response.clone();
-			await sendFetchResponse(res, response);
-			callAfterRequestMiddleware({
-				runtime,
-				response: responseForMiddleware,
-				path
-			}).catch((error) => {
-				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 sendFetchResponse(res, error);
-				} catch (streamError) {
-					next(streamError);
-					return;
-				}
-				callAfterRequestMiddleware({
-					runtime,
-					response: errorResponseForMiddleware,
-					path
-				}).catch((mwError) => {
-					logger.error({
-						err: mwError,
-						url: req.originalUrl ?? req.url,
-						path
-					}, "Error running after request middleware");
-				});
-				return;
-			}
-			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.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"express-single.mjs","names":[],"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.mjs","names":[],"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,QAAO,4BAA4B;EACjC;EACA;EACA,MAAM;EACN,MAAM;EACN;EACD,CAAC"}

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

@@ -1,203 +1,55 @@
 require("reflect-metadata");
 const require_runtime = require('../../../_virtual/_rolldown/runtime.cjs');
-const require_telemetry_client = require('../telemetry/telemetry-client.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_threads = require('../handlers/intelligence/threads.cjs');
-const require_express_utils = require('./express-utils.cjs');
-let _copilotkit_shared = require("@copilotkit/shared");
+const require_fetch_handler = require('../core/fetch-handler.cjs');
+const require_express_fetch_bridge = require('./express-fetch-bridge.cjs');
 let express = require("express");
 express = require_runtime.__toESM(express);
 let cors = require("cors");
 cors = require_runtime.__toESM(cors);
 
 //#region src/v2/runtime/endpoints/express.ts
-function createCopilotEndpointExpress({ runtime, basePath }) {
-	const router = express.default.Router();
+function createCopilotExpressHandler({ runtime, basePath, mode = "multi-route", cors: corsOption = true, hooks }) {
 	const normalizedBase = normalizeBasePath(basePath);
-	Promise.resolve(runtime.agents).then((agents) => {
-		require_telemetry_client.default.capture("oss.runtime.instance_created", {
-			actionsAmount: 0,
-			endpointTypes: [],
-			endpointsAmount: 0,
-			agentsAmount: Object.keys(agents).length,
-			"cloud.api_key_provided": false
-		});
-	}).catch(() => {});
-	router.use((0, cors.default)({
-		origin: "*",
-		methods: [
-			"GET",
-			"HEAD",
-			"PUT",
-			"POST",
-			"DELETE",
-			"PATCH",
-			"OPTIONS"
-		],
-		allowedHeaders: ["*"]
-	}));
-	router.post(joinPath(normalizedBase, "/agent/:agentId/run"), createRouteHandler(runtime, async ({ request, req }) => {
-		const agentId = req.params.agentId;
-		return require_handle_run.handleRunAgent({
-			runtime,
-			request,
-			agentId
-		});
-	}));
-	router.post(joinPath(normalizedBase, "/agent/:agentId/connect"), createRouteHandler(runtime, async ({ request, req }) => {
-		const agentId = req.params.agentId;
-		return require_handle_connect.handleConnectAgent({
-			runtime,
-			request,
-			agentId
-		});
-	}));
-	router.post(joinPath(normalizedBase, "/agent/:agentId/stop/:threadId"), createRouteHandler(runtime, async ({ request, req }) => {
-		const agentId = req.params.agentId;
-		const threadId = req.params.threadId;
-		return require_handle_stop.handleStopAgent({
-			runtime,
-			request,
-			agentId,
-			threadId
-		});
-	}));
-	router.get(joinPath(normalizedBase, "/info"), createRouteHandler(runtime, async ({ request }) => {
-		return require_get_runtime_info.handleGetRuntimeInfo({
-			runtime,
-			request
-		});
-	}));
-	router.post(joinPath(normalizedBase, "/transcribe"), createRouteHandler(runtime, async ({ request }) => {
-		return require_handle_transcribe.handleTranscribe({
-			runtime,
-			request
-		});
-	}));
-	router.get(joinPath(normalizedBase, "/threads"), createRouteHandler(runtime, async ({ request }) => {
-		return require_threads.handleListThreads({
-			runtime,
-			request
-		});
-	}));
-	router.post(joinPath(normalizedBase, "/threads/subscribe"), createRouteHandler(runtime, async ({ request }) => {
-		return require_threads.handleSubscribeToThreads({
-			runtime,
-			request
-		});
-	}));
-	router.patch(joinPath(normalizedBase, "/threads/:threadId"), createRouteHandler(runtime, async ({ request, req }) => {
-		const threadId = req.params.threadId;
-		return require_threads.handleUpdateThread({
-			runtime,
-			request,
-			threadId
-		});
-	}));
-	router.post(joinPath(normalizedBase, "/threads/:threadId/archive"), createRouteHandler(runtime, async ({ request, req }) => {
-		const threadId = req.params.threadId;
-		return require_threads.handleArchiveThread({
-			runtime,
-			request,
-			threadId
-		});
-	}));
-	router.delete(joinPath(normalizedBase, "/threads/:threadId"), createRouteHandler(runtime, async ({ request, req }) => {
-		const threadId = req.params.threadId;
-		return require_threads.handleDeleteThread({
-			runtime,
-			request,
-			threadId
-		});
-	}));
-	router.use(joinPath(normalizedBase, "*"), (req, res) => {
-		res.status(404).json({ error: "Not found" });
-	});
-	return router;
-}
-function createRouteHandler(runtime, factory) {
-	return async (req, res, next) => {
-		const path = req.originalUrl ?? req.path;
-		let request = require_express_utils.createFetchRequestFromExpress(req);
-		const warning = (0, _copilotkit_shared.getLicenseWarningHeader)(runtime.licenseChecker);
-		if (warning) res.setHeader(warning.key, warning.value);
+	const nodeHandler = require_express_fetch_bridge.createExpressNodeHandler(require_fetch_handler.createCopilotRuntimeHandler({
+		runtime,
+		basePath: normalizedBase,
+		mode,
+		cors: false,
+		hooks
+	}));
+	const expressHandler = async (req, res, next) => {
 		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;
-		}
-		try {
-			const response = await factory({
-				request,
-				req
-			});
-			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 request handler");
-			next(error);
+			await nodeHandler(req, res);
+		} catch (err) {
+			next(err);
 		}
 	};
+	const router = express.default.Router();
+	if (corsOption) {
+		const corsConfig = corsOption === true ? {
+			origin: "*",
+			methods: [
+				"GET",
+				"HEAD",
+				"PUT",
+				"POST",
+				"DELETE",
+				"PATCH",
+				"OPTIONS"
+			],
+			allowedHeaders: ["*"]
+		} : corsOption;
+		router.use((0, cors.default)(corsConfig));
+	}
+	if (mode === "single-route") {
+		router.post(normalizedBase, expressHandler);
+		router.options(normalizedBase, expressHandler);
+	} else if (normalizedBase === "/") router.all("*", expressHandler);
+	else {
+		router.all(`${normalizedBase}/*`, expressHandler);
+		router.all(normalizedBase, expressHandler);
+	}
+	return router;
 }
 function normalizeBasePath(path) {
 	if (!path) throw new Error("basePath must be provided for Express endpoint");
@@ -205,13 +57,7 @@ function normalizeBasePath(path) {
 	if (path.length > 1 && path.endsWith("/")) return path.slice(0, -1);
 	return path;
 }
-function joinPath(basePath, suffix) {
-	if (basePath === "/") return suffix.startsWith("/") ? suffix : `/${suffix}`;
-	if (!suffix) return basePath;
-	if (suffix === "*") return `${basePath}/*`;
-	return `${basePath}${suffix.startsWith("/") ? suffix : `/${suffix}`}`;
-}
 
 //#endregion
-exports.createCopilotEndpointExpress = createCopilotEndpointExpress;
+exports.createCopilotExpressHandler = createCopilotExpressHandler;
 //# sourceMappingURL=express.cjs.map

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

@@ -1 +1 @@
-{"version":3,"file":"express.cjs","names":["handleRunAgent","handleConnectAgent","handleStopAgent","handleGetRuntimeInfo","handleTranscribe","handleListThreads","handleSubscribeToThreads","handleUpdateThread","handleArchiveThread","handleDeleteThread","createFetchRequestFromExpress","callBeforeRequestMiddleware","sendFetchResponse"],"sources":["../../../../src/v2/runtime/endpoints/express.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 { telemetry } from \"../telemetry\";\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 {\n  handleListThreads,\n  handleSubscribeToThreads,\n  handleUpdateThread,\n  handleArchiveThread,\n  handleDeleteThread,\n} from \"../handlers/handle-threads\";\nimport { logger, getLicenseWarningHeader } from \"@copilotkit/shared\";\nimport {\n  callBeforeRequestMiddleware,\n  callAfterRequestMiddleware,\n} from \"../middleware\";\nimport {\n  createFetchRequestFromExpress,\n  sendFetchResponse,\n} from \"./express-utils\";\n\ninterface CopilotExpressEndpointParams {\n  runtime: CopilotRuntimeLike;\n  basePath: string;\n}\n\nexport function createCopilotEndpointExpress({\n  runtime,\n  basePath,\n}: CopilotExpressEndpointParams): Router {\n  const router = express.Router();\n  const normalizedBase = normalizeBasePath(basePath);\n\n  // Fire instance_created telemetry - resolve agents if needed\n  Promise.resolve(runtime.agents)\n    .then((agents) => {\n      telemetry.capture(\"oss.runtime.instance_created\", {\n        actionsAmount: 0,\n        endpointTypes: [],\n        endpointsAmount: 0,\n        agentsAmount: Object.keys(agents).length,\n        \"cloud.api_key_provided\": false,\n      });\n    })\n    .catch(() => {\n      // Silently fail - telemetry should not break the application\n    });\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(\n    joinPath(normalizedBase, \"/agent/:agentId/run\"),\n    createRouteHandler(runtime, async ({ request, req }) => {\n      const agentId = req.params.agentId as string;\n      return handleRunAgent({ runtime, request, agentId });\n    }),\n  );\n\n  router.post(\n    joinPath(normalizedBase, \"/agent/:agentId/connect\"),\n    createRouteHandler(runtime, async ({ request, req }) => {\n      const agentId = req.params.agentId as string;\n      return handleConnectAgent({ runtime, request, agentId });\n    }),\n  );\n\n  router.post(\n    joinPath(normalizedBase, \"/agent/:agentId/stop/:threadId\"),\n    createRouteHandler(runtime, async ({ request, req }) => {\n      const agentId = req.params.agentId as string;\n      const threadId = req.params.threadId as string;\n      return handleStopAgent({ runtime, request, agentId, threadId });\n    }),\n  );\n\n  router.get(\n    joinPath(normalizedBase, \"/info\"),\n    createRouteHandler(runtime, async ({ request }) => {\n      return handleGetRuntimeInfo({ runtime, request });\n    }),\n  );\n\n  router.post(\n    joinPath(normalizedBase, \"/transcribe\"),\n    createRouteHandler(runtime, async ({ request }) => {\n      return handleTranscribe({ runtime, request });\n    }),\n  );\n\n  router.get(\n    joinPath(normalizedBase, \"/threads\"),\n    createRouteHandler(runtime, async ({ request }) => {\n      return handleListThreads({ runtime, request });\n    }),\n  );\n\n  router.post(\n    joinPath(normalizedBase, \"/threads/subscribe\"),\n    createRouteHandler(runtime, async ({ request }) => {\n      return handleSubscribeToThreads({ runtime, request });\n    }),\n  );\n\n  router.patch(\n    joinPath(normalizedBase, \"/threads/:threadId\"),\n    createRouteHandler(runtime, async ({ request, req }) => {\n      const threadId = req.params.threadId as string;\n      return handleUpdateThread({ runtime, request, threadId });\n    }),\n  );\n\n  router.post(\n    joinPath(normalizedBase, \"/threads/:threadId/archive\"),\n    createRouteHandler(runtime, async ({ request, req }) => {\n      const threadId = req.params.threadId as string;\n      return handleArchiveThread({ runtime, request, threadId });\n    }),\n  );\n\n  router.delete(\n    joinPath(normalizedBase, \"/threads/:threadId\"),\n    createRouteHandler(runtime, async ({ request, req }) => {\n      const threadId = req.params.threadId as string;\n      return handleDeleteThread({ runtime, request, threadId });\n    }),\n  );\n\n  router.use(joinPath(normalizedBase, \"*\"), (req, res) => {\n    res.status(404).json({ error: \"Not found\" });\n  });\n\n  return router;\n}\n\ntype RouteHandlerContext = {\n  request: Request;\n  req: ExpressRequest;\n};\n\ntype RouteHandlerFactory = (ctx: RouteHandlerContext) => Promise<Response>;\n\nfunction createRouteHandler(\n  runtime: CopilotRuntimeLike,\n  factory: RouteHandlerFactory,\n) {\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    const warning = getLicenseWarningHeader(runtime.licenseChecker);\n    if (warning) res.setHeader(warning.key, warning.value);\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    try {\n      const response = await factory({ request, req });\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 request handler\",\n      );\n      next(error);\n    }\n  };\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\nfunction joinPath(basePath: string, suffix: string): string {\n  if (basePath === \"/\") {\n    return suffix.startsWith(\"/\") ? suffix : `/${suffix}`;\n  }\n\n  if (!suffix) {\n    return basePath;\n  }\n\n  if (suffix === \"*\") {\n    return `${basePath}/*`;\n  }\n\n  return `${basePath}${suffix.startsWith(\"/\") ? suffix : `/${suffix}`}`;\n}\n"],"mappings":"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"}
+{"version":3,"file":"express.cjs","names":["createExpressNodeHandler","createCopilotRuntimeHandler"],"sources":["../../../../src/v2/runtime/endpoints/express.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\";\nimport type { CorsOptions } from \"cors\";\nimport type { CopilotRuntimeLike } from \"../core/runtime\";\nimport { createCopilotRuntimeHandler } from \"../core/fetch-handler\";\nimport { createExpressNodeHandler } from \"./express-fetch-bridge\";\nimport type { CopilotRuntimeHooks } from \"../core/hooks\";\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/**\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}: CopilotExpressEndpointParams): Router {\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  });\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 = express.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(`${normalizedBase}/*`, expressHandler);\n    router.all(normalizedBase, expressHandler);\n  }\n\n  return router;\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":";;;;;;;;;;AA0FA,SAAgB,4BAA4B,EAC1C,SACA,UACA,OAAO,eACP,MAAM,aAAa,MACnB,SACuC;CACvC,MAAM,iBAAiB,kBAAkB,SAAS;CAUlD,MAAM,cAAcA,sDARJC,kDAA4B;EAC1C;EACA,UAAU;EACV;EACA,MAAM;EACN;EACD,CAAC,CAEmD;CAErD,MAAM,iBAAiB,OACrB,KACA,KACA,SACG;AACH,MAAI;AACF,SAAM,YAAY,KAAK,IAAI;WACpB,KAAK;AACZ,QAAK,IAAI;;;CAIb,MAAM,SAAS,gBAAQ,QAAQ;AAG/B,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,KAAK,eAAe;MAC1B;AACL,SAAO,IAAI,GAAG,eAAe,KAAK,eAAe;AACjD,SAAO,IAAI,gBAAgB,eAAe;;AAG5C,QAAO;;AAGT,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.d.cts

@@ -1,16 +1,38 @@
 
-import { CopilotRuntimeLike } from "../runtime.cjs";
+import { CopilotRuntimeLike } from "../core/runtime.cjs";
+import { CopilotRuntimeHooks } from "../core/hooks.cjs";
 import { Router } from "express";
+import { CorsOptions } from "cors";
 
 //#region src/v2/runtime/endpoints/express.d.ts
 interface CopilotExpressEndpointParams {
   runtime: CopilotRuntimeLike;
   basePath: string;
+  /**
+   * Endpoint mode.
+   * - `"multi-route"` (default): separate routes for each operation
+   * - `"single-route"`: single POST endpoint with JSON envelope dispatch
+   */
+  mode?: "multi-route" | "single-route";
+  /**
+   * CORS configuration for the Express router.
+   * - `true` (default): permissive CORS (`origin: "*"`, all methods, all headers).
+   * - `false`: no CORS middleware is applied — handle it yourself.
+   * - object: passed directly to the Express `cors()` middleware.
+   */
+  cors?: boolean | CorsOptions;
+  /**
+   * Lifecycle hooks for request processing.
+   */
+  hooks?: CopilotRuntimeHooks;
 }
-declare function createCopilotEndpointExpress({
+declare function createCopilotExpressHandler({
   runtime,
-  basePath
+  basePath,
+  mode,
+  cors: corsOption,
+  hooks
 }: CopilotExpressEndpointParams): Router;
 //#endregion
-export { createCopilotEndpointExpress };
+export { CopilotExpressEndpointParams, createCopilotExpressHandler };
 //# sourceMappingURL=express.d.cts.map

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

@@ -1 +1 @@
-{"version":3,"file":"express.d.cts","names":[],"sources":["../../../../src/v2/runtime/endpoints/express.ts"],"mappings":";;;;;UAiCU,4BAAA;EACR,OAAA,EAAS,kBAAA;EACT,QAAA;AAAA;AAAA,iBAGc,4BAAA,CAAA;EACd,OAAA;EACA;AAAA,GACC,4BAAA,GAA+B,MAAA"}
+{"version":3,"file":"express.d.cts","names":[],"sources":["../../../../src/v2/runtime/endpoints/express.ts"],"mappings":";;;;;;;UAciB,4BAAA;EACf,OAAA,EAAS,kBAAA;EACT,QAAA;EAF2C;;;;;EAS3C,IAAA;EAa2B;;;;;;EAL3B,IAAA,aAAiB,WAAA;EAKjB;;;EAAA,KAAA,GAAQ,mBAAA;AAAA;AAAA,iBAsDM,2BAAA,CAAA;EACd,OAAA;EACA,QAAA;EACA,IAAA;EACA,IAAA,EAAM,UAAA;EACN;AAAA,GACC,4BAAA,GAA+B,MAAA"}