@copilotkit/runtime 1.83.0 → 2.0.0-rc.0

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

@@ -1,44 +0,0 @@
-import "reflect-metadata";
-import { createCopilotExpressHandler } from "./express.mjs";
-
-//#region src/v2/runtime/endpoints/express-single.ts
-/**
-* 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
-	});
-}
-
-//#endregion
-export { createCopilotEndpointSingleRouteExpress };
-//# sourceMappingURL=express-single.mjs.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"express-single.mjs","names":[],"sources":["../../../../src/v2/runtime/endpoints/express-single.ts"],"sourcesContent":["import { createCopilotExpressHandler } from \"./express\";\nimport type { CopilotExpressRouter } 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): CopilotExpressRouter {\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,SACwD;AACxD,QAAO,4BAA4B;EACjC;EACA;EACA,MAAM;EACN,MAAM;EACN;EACD,CAAC"}

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

@@ -1,69 +0,0 @@
-require("reflect-metadata");
-const require_runtime = require('../../../_virtual/_rolldown/runtime.cjs');
-const require_fetch_handler = require('../core/fetch-handler.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");
-cors = require_runtime.__toESM(cors);
-
-//#region src/v2/runtime/endpoints/express.ts
-function createCopilotExpressHandler({ runtime, basePath, mode = "multi-route", cors: corsOption = true, hooks, activateChannels, __channelEngine }) {
-	const normalizedBase = normalizeBasePath(basePath);
-	const handler = require_fetch_handler.createCopilotRuntimeHandler({
-		runtime,
-		basePath: normalizedBase,
-		mode,
-		cors: false,
-		hooks,
-		activateChannels,
-		__channelEngine
-	});
-	const nodeHandler = require_node_fetch_handler.createCopilotNodeHandler(handler);
-	const expressHandler = async (req, res, next) => {
-		try {
-			await nodeHandler(req, res);
-		} catch (err) {
-			next(err);
-		}
-	};
-	const router = require_load_express.loadExpress().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(new RegExp(`^${escapeRegExp(normalizedBase)}(\\/.*)?$`), expressHandler);
-	const exposedRouter = router;
-	exposedRouter.channels = handler.channels;
-	require_auto_start_channels.autoStartChannels(exposedRouter.channels);
-	return exposedRouter;
-}
-function escapeRegExp(s) {
-	return s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-}
-function normalizeBasePath(path) {
-	if (!path) throw new Error("basePath must be provided for Express endpoint");
-	if (!path.startsWith("/")) return `/${path}`;
-	if (path.length > 1 && path.endsWith("/")) return path.slice(0, -1);
-	return path;
-}
-
-//#endregion
-exports.createCopilotExpressHandler = createCopilotExpressHandler;
-//# sourceMappingURL=express.cjs.map

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

@@ -1 +0,0 @@
-{"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.d.cts

@@ -1,85 +0,0 @@
-
-import { CopilotRuntimeLike } from "../core/runtime.cjs";
-import { ActivateChannelEngine, ChannelsControl } from "../core/channel-manager.cjs";
-import { CopilotRuntimeHooks } from "../core/hooks.cjs";
-import { CorsOptions } from "cors";
-
-//#region src/v2/runtime/endpoints/express.d.ts
-/**
- * The middleware `createCopilotExpressHandler` returns: an Express router that
- * may also carry an optional {@link ChannelsControl} surface. The router object
- * itself is request-scoped middleware, but an Express app can only run inside a
- * long-running `http.Server` — so this wrapper is a lifecycle-owning host like
- * `createCopilotNodeListener`: it STARTS activation of the runtime's declared
- * managed Channels at creation, and `.channels` is here to observe (`ready()`)
- * or tear down (`stop()`) that activation.
- *
- * Deliberately NOT typed as Express's own `Router`. Pinning that type binds our
- * public surface to a single Express major: `@types/express@4` declares
- * `Request.param()` and `@types/express@5` does not, so a v4-typed router is not
- * assignable to a v5 `app.use()` and an Express 5 app cannot compile against us
- * at all (#7276). The call signature below is what `use()` accepts in both
- * majors, and the methods beside it are the router surface both majors share.
- *
- * The runtime value is still a real `express.Router()`; only the declared type
- * is widened.
- */
-type CopilotExpressRouter = ((req: any, res: any, next: (err?: unknown) => void) => void) & {
-  channels?: ChannelsControl;
-  use(...handlers: any[]): CopilotExpressRouter;
-  get(...handlers: any[]): CopilotExpressRouter;
-  post(...handlers: any[]): CopilotExpressRouter;
-  put(...handlers: any[]): CopilotExpressRouter;
-  patch(...handlers: any[]): CopilotExpressRouter;
-  delete(...handlers: any[]): CopilotExpressRouter;
-  options(...handlers: any[]): CopilotExpressRouter;
-  all(...handlers: any[]): CopilotExpressRouter;
-  route(path: any): any;
-  param(...handlers: any[]): CopilotExpressRouter;
-};
-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;
-  /**
-   * Whether the underlying handler builds the control surface for the runtime's
-   * declared managed Channels — and, because Express is a long-running host,
-   * starts their activation at creation. Defaults to `true`. Set `false` to
-   * build no surface and open no socket (tests, short-lived scripts). See
-   * `CopilotRuntimeHandlerOptions.activateChannels`.
-   */
-  activateChannels?: boolean;
-  /**
-   * @internal Test seam: inject a fake Channel activation engine. Forwarded
-   * to `createCopilotRuntimeHandler`. Not part of the public API.
-   */
-  __channelEngine?: ActivateChannelEngine;
-}
-declare function createCopilotExpressHandler({
-  runtime,
-  basePath,
-  mode,
-  cors: corsOption,
-  hooks,
-  activateChannels,
-  __channelEngine
-}: CopilotExpressEndpointParams): CopilotExpressRouter;
-//#endregion
-export { CopilotExpressEndpointParams, CopilotExpressRouter, createCopilotExpressHandler };
-//# sourceMappingURL=express.d.cts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"express.d.cts","names":[],"sources":["../../../../src/v2/runtime/endpoints/express.ts"],"mappings":";;;;;;;;;AAqCA;;;;;;;;;;;;;;;;;KAAY,oBAAA,KACV,GAAA,OACA,GAAA,OACA,IAAA,GAAO,GAAA;EAEP,QAAA,GAAW,eAAA;EAMX,GAAA,IAAO,QAAA,UAAkB,oBAAA;EACzB,GAAA,IAAO,QAAA,UAAkB,oBAAA;EACzB,IAAA,IAAQ,QAAA,UAAkB,oBAAA;EAC1B,GAAA,IAAO,QAAA,UAAkB,oBAAA;EACzB,KAAA,IAAS,QAAA,UAAkB,oBAAA;EAC3B,MAAA,IAAU,QAAA,UAAkB,oBAAA;EAC5B,OAAA,IAAW,QAAA,UAAkB,oBAAA;EAC7B,GAAA,IAAO,QAAA,UAAkB,oBAAA;EAazB,KAAA,CAAM,IAAA;EACN,KAAA,IAAS,QAAA,UAAkB,oBAAA;AAAA;AAAA,UAGZ,4BAAA;EACf,OAAA,EAAS,kBAAA;EACT,QAAA;EAtBA;;;;;EA6BA,IAAA;EA3BA;;;;;;EAmCA,IAAA,aAAiB,WAAA;EArBX;;;EA0BN,KAAA,GAAQ,mBAAA;EAzBuC;;AAGjD;;;;;EA+BE,gBAAA;EAMkB;;;;EAAlB,eAAA,GAAkB,qBAAA;AAAA;AAAA,iBAsDJ,2BAAA,CAAA;EACd,OAAA;EACA,QAAA;EACA,IAAA;EACA,IAAA,EAAM,UAAA;EACN,KAAA;EACA,gBAAA;EACA;AAAA,GACC,4BAAA,GAA+B,oBAAA"}

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

@@ -1,85 +0,0 @@
-
-import { CopilotRuntimeLike } from "../core/runtime.mjs";
-import { ActivateChannelEngine, ChannelsControl } from "../core/channel-manager.mjs";
-import { CopilotRuntimeHooks } from "../core/hooks.mjs";
-import { CorsOptions } from "cors";
-
-//#region src/v2/runtime/endpoints/express.d.ts
-/**
- * The middleware `createCopilotExpressHandler` returns: an Express router that
- * may also carry an optional {@link ChannelsControl} surface. The router object
- * itself is request-scoped middleware, but an Express app can only run inside a
- * long-running `http.Server` — so this wrapper is a lifecycle-owning host like
- * `createCopilotNodeListener`: it STARTS activation of the runtime's declared
- * managed Channels at creation, and `.channels` is here to observe (`ready()`)
- * or tear down (`stop()`) that activation.
- *
- * Deliberately NOT typed as Express's own `Router`. Pinning that type binds our
- * public surface to a single Express major: `@types/express@4` declares
- * `Request.param()` and `@types/express@5` does not, so a v4-typed router is not
- * assignable to a v5 `app.use()` and an Express 5 app cannot compile against us
- * at all (#7276). The call signature below is what `use()` accepts in both
- * majors, and the methods beside it are the router surface both majors share.
- *
- * The runtime value is still a real `express.Router()`; only the declared type
- * is widened.
- */
-type CopilotExpressRouter = ((req: any, res: any, next: (err?: unknown) => void) => void) & {
-  channels?: ChannelsControl;
-  use(...handlers: any[]): CopilotExpressRouter;
-  get(...handlers: any[]): CopilotExpressRouter;
-  post(...handlers: any[]): CopilotExpressRouter;
-  put(...handlers: any[]): CopilotExpressRouter;
-  patch(...handlers: any[]): CopilotExpressRouter;
-  delete(...handlers: any[]): CopilotExpressRouter;
-  options(...handlers: any[]): CopilotExpressRouter;
-  all(...handlers: any[]): CopilotExpressRouter;
-  route(path: any): any;
-  param(...handlers: any[]): CopilotExpressRouter;
-};
-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;
-  /**
-   * Whether the underlying handler builds the control surface for the runtime's
-   * declared managed Channels — and, because Express is a long-running host,
-   * starts their activation at creation. Defaults to `true`. Set `false` to
-   * build no surface and open no socket (tests, short-lived scripts). See
-   * `CopilotRuntimeHandlerOptions.activateChannels`.
-   */
-  activateChannels?: boolean;
-  /**
-   * @internal Test seam: inject a fake Channel activation engine. Forwarded
-   * to `createCopilotRuntimeHandler`. Not part of the public API.
-   */
-  __channelEngine?: ActivateChannelEngine;
-}
-declare function createCopilotExpressHandler({
-  runtime,
-  basePath,
-  mode,
-  cors: corsOption,
-  hooks,
-  activateChannels,
-  __channelEngine
-}: CopilotExpressEndpointParams): CopilotExpressRouter;
-//#endregion
-export { CopilotExpressEndpointParams, CopilotExpressRouter, createCopilotExpressHandler };
-//# sourceMappingURL=express.d.mts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"express.d.mts","names":[],"sources":["../../../../src/v2/runtime/endpoints/express.ts"],"mappings":";;;;;;;;;AAqCA;;;;;;;;;;;;;;;;;KAAY,oBAAA,KACV,GAAA,OACA,GAAA,OACA,IAAA,GAAO,GAAA;EAEP,QAAA,GAAW,eAAA;EAMX,GAAA,IAAO,QAAA,UAAkB,oBAAA;EACzB,GAAA,IAAO,QAAA,UAAkB,oBAAA;EACzB,IAAA,IAAQ,QAAA,UAAkB,oBAAA;EAC1B,GAAA,IAAO,QAAA,UAAkB,oBAAA;EACzB,KAAA,IAAS,QAAA,UAAkB,oBAAA;EAC3B,MAAA,IAAU,QAAA,UAAkB,oBAAA;EAC5B,OAAA,IAAW,QAAA,UAAkB,oBAAA;EAC7B,GAAA,IAAO,QAAA,UAAkB,oBAAA;EAazB,KAAA,CAAM,IAAA;EACN,KAAA,IAAS,QAAA,UAAkB,oBAAA;AAAA;AAAA,UAGZ,4BAAA;EACf,OAAA,EAAS,kBAAA;EACT,QAAA;EAtBA;;;;;EA6BA,IAAA;EA3BA;;;;;;EAmCA,IAAA,aAAiB,WAAA;EArBX;;;EA0BN,KAAA,GAAQ,mBAAA;EAzBuC;;AAGjD;;;;;EA+BE,gBAAA;EAMkB;;;;EAAlB,eAAA,GAAkB,qBAAA;AAAA;AAAA,iBAsDJ,2BAAA,CAAA;EACd,OAAA;EACA,QAAA;EACA,IAAA;EACA,IAAA,EAAM,UAAA;EACN,KAAA;EACA,gBAAA;EACA;AAAA,GACC,4BAAA,GAA+B,oBAAA"}

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

@@ -1,67 +0,0 @@
-import "reflect-metadata";
-import { createCopilotRuntimeHandler } from "../core/fetch-handler.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";
-
-//#region src/v2/runtime/endpoints/express.ts
-function createCopilotExpressHandler({ runtime, basePath, mode = "multi-route", cors: corsOption = true, hooks, activateChannels, __channelEngine }) {
-	const normalizedBase = normalizeBasePath(basePath);
-	const handler = createCopilotRuntimeHandler({
-		runtime,
-		basePath: normalizedBase,
-		mode,
-		cors: false,
-		hooks,
-		activateChannels,
-		__channelEngine
-	});
-	const nodeHandler = createCopilotNodeHandler(handler);
-	const expressHandler = async (req, res, next) => {
-		try {
-			await nodeHandler(req, res);
-		} catch (err) {
-			next(err);
-		}
-	};
-	const router = loadExpress().Router();
-	if (corsOption) {
-		const corsConfig = corsOption === true ? {
-			origin: "*",
-			methods: [
-				"GET",
-				"HEAD",
-				"PUT",
-				"POST",
-				"DELETE",
-				"PATCH",
-				"OPTIONS"
-			],
-			allowedHeaders: ["*"]
-		} : corsOption;
-		router.use(cors(corsConfig));
-	}
-	if (mode === "single-route") {
-		router.post(normalizedBase, expressHandler);
-		router.options(normalizedBase, expressHandler);
-	} else if (normalizedBase === "/") router.all(/.*/, expressHandler);
-	else router.all(new RegExp(`^${escapeRegExp(normalizedBase)}(\\/.*)?$`), expressHandler);
-	const exposedRouter = router;
-	exposedRouter.channels = handler.channels;
-	autoStartChannels(exposedRouter.channels);
-	return exposedRouter;
-}
-function escapeRegExp(s) {
-	return s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-}
-function normalizeBasePath(path) {
-	if (!path) throw new Error("basePath must be provided for Express endpoint");
-	if (!path.startsWith("/")) return `/${path}`;
-	if (path.length > 1 && path.endsWith("/")) return path.slice(0, -1);
-	return path;
-}
-
-//#endregion
-export { createCopilotExpressHandler };
-//# sourceMappingURL=express.mjs.map

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

@@ -1 +0,0 @@
-{"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/hono-single.cjs

@@ -1,29 +0,0 @@
-require("reflect-metadata");
-const require_runtime = require('../../../_virtual/_rolldown/runtime.cjs');
-const require_fetch_handler = require('../core/fetch-handler.cjs');
-const require_hono = require('./hono.cjs');
-let hono = require("hono");
-
-//#region src/v2/runtime/endpoints/hono-single.ts
-/** @deprecated Use `createCopilotHonoHandler` with `mode: "single-route"` instead. */
-function createCopilotEndpointSingleRoute({ runtime, basePath, cors: corsConfig, hooks }) {
-	const routePath = normalizePath(basePath);
-	const handler = require_fetch_handler.createCopilotRuntimeHandler({
-		runtime,
-		basePath: routePath,
-		mode: "single-route",
-		cors: corsConfig ? require_hono.toFetchCorsConfig(corsConfig) : true,
-		hooks
-	});
-	return new hono.Hono().basePath(routePath).all("*", async (c) => handler(c.req.raw));
-}
-function normalizePath(path) {
-	if (!path) throw new Error("basePath must be provided for single-route endpoint");
-	if (!path.startsWith("/")) return `/${path}`;
-	if (path.length > 1 && path.endsWith("/")) return path.slice(0, -1);
-	return path;
-}
-
-//#endregion
-exports.createCopilotEndpointSingleRoute = createCopilotEndpointSingleRoute;
-//# sourceMappingURL=hono-single.cjs.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"hono-single.cjs","names":["createCopilotRuntimeHandler","toFetchCorsConfig","Hono"],"sources":["../../../../src/v2/runtime/endpoints/hono-single.ts"],"sourcesContent":["import { Hono } from \"hono\";\nimport type { CopilotRuntimeLike } from \"../core/runtime\";\nimport { createCopilotRuntimeHandler } from \"../core/fetch-handler\";\nimport type { CopilotRuntimeHooks } from \"../core/hooks\";\nimport { CopilotEndpointCorsConfig, toFetchCorsConfig } from \"./hono\";\n\ninterface CopilotSingleEndpointParams {\n  runtime: CopilotRuntimeLike;\n  /**\n   * Absolute path at which to mount the single-route endpoint (e.g. \"/api/copilotkit\").\n   */\n  basePath: string;\n  /**\n   * Optional CORS configuration. When not provided, defaults to allowing all origins without credentials.\n   * To support HTTP-only cookies, provide cors config with credentials: true and explicit origin.\n   */\n  cors?: CopilotEndpointCorsConfig;\n  /**\n   * Lifecycle hooks for request processing.\n   */\n  hooks?: CopilotRuntimeHooks;\n}\n\n/** @deprecated Use `createCopilotHonoHandler` with `mode: \"single-route\"` instead. */\nexport function createCopilotEndpointSingleRoute({\n  runtime,\n  basePath,\n  cors: corsConfig,\n  hooks,\n}: CopilotSingleEndpointParams) {\n  const routePath = normalizePath(basePath);\n\n  const handler = createCopilotRuntimeHandler({\n    runtime,\n    basePath: routePath,\n    mode: \"single-route\",\n    cors: corsConfig ? toFetchCorsConfig(corsConfig) : true,\n    hooks,\n  });\n\n  const app = new Hono();\n\n  return app.basePath(routePath).all(\"*\", async (c) => handler(c.req.raw));\n}\n\nfunction normalizePath(path: string): string {\n  if (!path) {\n    throw new Error(\"basePath must be provided for single-route 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":";;;;;;;;AAwBA,SAAgB,iCAAiC,EAC/C,SACA,UACA,MAAM,YACN,SAC8B;CAC9B,MAAM,YAAY,cAAc,SAAS;CAEzC,MAAM,UAAUA,kDAA4B;EAC1C;EACA,UAAU;EACV,MAAM;EACN,MAAM,aAAaC,+BAAkB,WAAW,GAAG;EACnD;EACD,CAAC;AAIF,QAFY,IAAIC,WAAM,CAEX,SAAS,UAAU,CAAC,IAAI,KAAK,OAAO,MAAM,QAAQ,EAAE,IAAI,IAAI,CAAC;;AAG1E,SAAS,cAAc,MAAsB;AAC3C,KAAI,CAAC,KACH,OAAM,IAAI,MAAM,sDAAsD;AAGxE,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/hono-single.d.cts

@@ -1,44 +0,0 @@
-
-import { CopilotRuntimeLike } from "../core/runtime.cjs";
-import { CopilotRuntimeHooks } from "../core/hooks.cjs";
-import { CopilotEndpointCorsConfig } from "./hono.cjs";
-import * as hono_types0 from "hono/types";
-import * as hono_utils_http_status0 from "hono/utils/http-status";
-import * as hono_hono_base0 from "hono/hono-base";
-
-//#region src/v2/runtime/endpoints/hono-single.d.ts
-interface CopilotSingleEndpointParams {
-  runtime: CopilotRuntimeLike;
-  /**
-   * Absolute path at which to mount the single-route endpoint (e.g. "/api/copilotkit").
-   */
-  basePath: string;
-  /**
-   * Optional CORS configuration. When not provided, defaults to allowing all origins without credentials.
-   * To support HTTP-only cookies, provide cors config with credentials: true and explicit origin.
-   */
-  cors?: CopilotEndpointCorsConfig;
-  /**
-   * Lifecycle hooks for request processing.
-   */
-  hooks?: CopilotRuntimeHooks;
-}
-/** @deprecated Use `createCopilotHonoHandler` with `mode: "single-route"` instead. */
-declare function createCopilotEndpointSingleRoute({
-  runtime,
-  basePath,
-  cors: corsConfig,
-  hooks
-}: CopilotSingleEndpointParams): hono_hono_base0.HonoBase<hono_types0.BlankEnv, {
-  [x: `${string}/*`]: {
-    $all: {
-      input: {};
-      output: {};
-      outputFormat: string;
-      status: hono_utils_http_status0.StatusCode;
-    };
-  };
-}, string, `${string}/*`>;
-//#endregion
-export { createCopilotEndpointSingleRoute };
-//# sourceMappingURL=hono-single.d.cts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"hono-single.d.cts","names":[],"sources":["../../../../src/v2/runtime/endpoints/hono-single.ts"],"mappings":";;;;;;;;;UAMU,2BAAA;EACR,OAAA,EAAS,kBAAA;;;;EAIT,QAAA;EALmC;;;;EAUnC,IAAA,GAAO,yBAAA;EAIoB;;;EAA3B,KAAA,GAAQ,mBAAA;AAAA;;iBAIM,gCAAA,CAAA;EACd,OAAA;EACA,QAAA;EACA,IAAA,EAAM,UAAA;EACN;AAAA,GACC,2BAAA,mBAA2B,QAAA,CAAA,WAAA,CAAA,QAAA;EAAA;;;;;cAAA,uBAAA,CAAA,UAAA;IAAA;EAAA;AAAA"}

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

@@ -1,44 +0,0 @@
-
-import { CopilotRuntimeLike } from "../core/runtime.mjs";
-import { CopilotRuntimeHooks } from "../core/hooks.mjs";
-import { CopilotEndpointCorsConfig } from "./hono.mjs";
-import * as hono_types0 from "hono/types";
-import * as hono_utils_http_status0 from "hono/utils/http-status";
-import * as hono_hono_base0 from "hono/hono-base";
-
-//#region src/v2/runtime/endpoints/hono-single.d.ts
-interface CopilotSingleEndpointParams {
-  runtime: CopilotRuntimeLike;
-  /**
-   * Absolute path at which to mount the single-route endpoint (e.g. "/api/copilotkit").
-   */
-  basePath: string;
-  /**
-   * Optional CORS configuration. When not provided, defaults to allowing all origins without credentials.
-   * To support HTTP-only cookies, provide cors config with credentials: true and explicit origin.
-   */
-  cors?: CopilotEndpointCorsConfig;
-  /**
-   * Lifecycle hooks for request processing.
-   */
-  hooks?: CopilotRuntimeHooks;
-}
-/** @deprecated Use `createCopilotHonoHandler` with `mode: "single-route"` instead. */
-declare function createCopilotEndpointSingleRoute({
-  runtime,
-  basePath,
-  cors: corsConfig,
-  hooks
-}: CopilotSingleEndpointParams): hono_hono_base0.HonoBase<hono_types0.BlankEnv, {
-  [x: `${string}/*`]: {
-    $all: {
-      input: {};
-      output: {};
-      outputFormat: string;
-      status: hono_utils_http_status0.StatusCode;
-    };
-  };
-}, string, `${string}/*`>;
-//#endregion
-export { createCopilotEndpointSingleRoute };
-//# sourceMappingURL=hono-single.d.mts.map

package/dist/v2/runtime/endpoints/hono-single.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"hono-single.d.mts","names":[],"sources":["../../../../src/v2/runtime/endpoints/hono-single.ts"],"mappings":";;;;;;;;;UAMU,2BAAA;EACR,OAAA,EAAS,kBAAA;;;;EAIT,QAAA;EALmC;;;;EAUnC,IAAA,GAAO,yBAAA;EAIoB;;;EAA3B,KAAA,GAAQ,mBAAA;AAAA;;iBAIM,gCAAA,CAAA;EACd,OAAA;EACA,QAAA;EACA,IAAA,EAAM,UAAA;EACN;AAAA,GACC,2BAAA,mBAA2B,QAAA,CAAA,WAAA,CAAA,QAAA;EAAA;;;;;cAAA,uBAAA,CAAA,UAAA;IAAA;EAAA;AAAA"}

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

@@ -1,28 +0,0 @@
-import "reflect-metadata";
-import { createCopilotRuntimeHandler } from "../core/fetch-handler.mjs";
-import { toFetchCorsConfig } from "./hono.mjs";
-import { Hono } from "hono";
-
-//#region src/v2/runtime/endpoints/hono-single.ts
-/** @deprecated Use `createCopilotHonoHandler` with `mode: "single-route"` instead. */
-function createCopilotEndpointSingleRoute({ runtime, basePath, cors: corsConfig, hooks }) {
-	const routePath = normalizePath(basePath);
-	const handler = createCopilotRuntimeHandler({
-		runtime,
-		basePath: routePath,
-		mode: "single-route",
-		cors: corsConfig ? toFetchCorsConfig(corsConfig) : true,
-		hooks
-	});
-	return new Hono().basePath(routePath).all("*", async (c) => handler(c.req.raw));
-}
-function normalizePath(path) {
-	if (!path) throw new Error("basePath must be provided for single-route endpoint");
-	if (!path.startsWith("/")) return `/${path}`;
-	if (path.length > 1 && path.endsWith("/")) return path.slice(0, -1);
-	return path;
-}
-
-//#endregion
-export { createCopilotEndpointSingleRoute };
-//# sourceMappingURL=hono-single.mjs.map

package/dist/v2/runtime/endpoints/hono-single.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"hono-single.mjs","names":[],"sources":["../../../../src/v2/runtime/endpoints/hono-single.ts"],"sourcesContent":["import { Hono } from \"hono\";\nimport type { CopilotRuntimeLike } from \"../core/runtime\";\nimport { createCopilotRuntimeHandler } from \"../core/fetch-handler\";\nimport type { CopilotRuntimeHooks } from \"../core/hooks\";\nimport { CopilotEndpointCorsConfig, toFetchCorsConfig } from \"./hono\";\n\ninterface CopilotSingleEndpointParams {\n  runtime: CopilotRuntimeLike;\n  /**\n   * Absolute path at which to mount the single-route endpoint (e.g. \"/api/copilotkit\").\n   */\n  basePath: string;\n  /**\n   * Optional CORS configuration. When not provided, defaults to allowing all origins without credentials.\n   * To support HTTP-only cookies, provide cors config with credentials: true and explicit origin.\n   */\n  cors?: CopilotEndpointCorsConfig;\n  /**\n   * Lifecycle hooks for request processing.\n   */\n  hooks?: CopilotRuntimeHooks;\n}\n\n/** @deprecated Use `createCopilotHonoHandler` with `mode: \"single-route\"` instead. */\nexport function createCopilotEndpointSingleRoute({\n  runtime,\n  basePath,\n  cors: corsConfig,\n  hooks,\n}: CopilotSingleEndpointParams) {\n  const routePath = normalizePath(basePath);\n\n  const handler = createCopilotRuntimeHandler({\n    runtime,\n    basePath: routePath,\n    mode: \"single-route\",\n    cors: corsConfig ? toFetchCorsConfig(corsConfig) : true,\n    hooks,\n  });\n\n  const app = new Hono();\n\n  return app.basePath(routePath).all(\"*\", async (c) => handler(c.req.raw));\n}\n\nfunction normalizePath(path: string): string {\n  if (!path) {\n    throw new Error(\"basePath must be provided for single-route 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":";;;;;;;AAwBA,SAAgB,iCAAiC,EAC/C,SACA,UACA,MAAM,YACN,SAC8B;CAC9B,MAAM,YAAY,cAAc,SAAS;CAEzC,MAAM,UAAU,4BAA4B;EAC1C;EACA,UAAU;EACV,MAAM;EACN,MAAM,aAAa,kBAAkB,WAAW,GAAG;EACnD;EACD,CAAC;AAIF,QAFY,IAAI,MAAM,CAEX,SAAS,UAAU,CAAC,IAAI,KAAK,OAAO,MAAM,QAAQ,EAAE,IAAI,IAAI,CAAC;;AAG1E,SAAS,cAAc,MAAsB;AAC3C,KAAI,CAAC,KACH,OAAM,IAAI,MAAM,sDAAsD;AAGxE,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/hono.cjs

@@ -1,38 +0,0 @@
-require("reflect-metadata");
-const require_runtime = require('../../../_virtual/_rolldown/runtime.cjs');
-const require_fetch_handler = require('../core/fetch-handler.cjs');
-let hono = require("hono");
-
-//#region src/v2/runtime/endpoints/hono.ts
-/** @deprecated Use `createCopilotHonoHandler` instead. */
-const createCopilotEndpoint = createCopilotHonoHandler;
-function createCopilotHonoHandler({ runtime, basePath, mode = "multi-route", cors: corsConfig, hooks, activateChannels, __channelEngine }) {
-	const handler = require_fetch_handler.createCopilotRuntimeHandler({
-		runtime,
-		basePath,
-		mode,
-		cors: corsConfig ? toFetchCorsConfig(corsConfig) : true,
-		hooks,
-		activateChannels,
-		__channelEngine
-	});
-	const scopedApp = new hono.Hono().basePath(basePath).all("*", async (c) => handler(c.req.raw));
-	scopedApp.channels = handler.channels;
-	return scopedApp;
-}
-/**
-* Convert Hono-specific CORS config to the fetch handler's CopilotCorsConfig.
-*/
-function toFetchCorsConfig(config) {
-	const origin = config.origin;
-	return {
-		origin: typeof origin === "function" ? (reqOrigin) => origin(reqOrigin, void 0) ?? null : origin,
-		credentials: config.credentials
-	};
-}
-
-//#endregion
-exports.createCopilotEndpoint = createCopilotEndpoint;
-exports.createCopilotHonoHandler = createCopilotHonoHandler;
-exports.toFetchCorsConfig = toFetchCorsConfig;
-//# sourceMappingURL=hono.cjs.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"hono.cjs","names":["createCopilotRuntimeHandler","Hono"],"sources":["../../../../src/v2/runtime/endpoints/hono.ts"],"sourcesContent":["import { Hono } from \"hono\";\nimport type { CopilotRuntimeLike } from \"../core/runtime\";\nimport { createCopilotRuntimeHandler } from \"../core/fetch-handler\";\nimport type { CopilotCorsConfig } from \"../core/fetch-cors\";\nimport type { CopilotRuntimeHooks } from \"../core/hooks\";\nimport type {\n  ActivateChannelEngine,\n  ChannelsControl,\n} from \"../core/channel-manager\";\n\n/**\n * A Hono app that may also carry an optional {@link ChannelsControl} surface.\n *\n * Unlike the Node and Express wrappers — which own a process and therefore START\n * managed-Channel activation at creation (OSS-641) — this wrapper stays LAZY:\n * activation is triggered by the first `app.channels.ready()` and never before.\n * A Hono app is multi-runtime and is our edge/serverless surface in practice:\n * every Next.js App Router route handler in `examples/showcases/*` builds one at\n * module scope, and those isolates freeze and recycle per request. Auto-starting\n * there would mint a competing listener for the same Channel on every cold\n * start, which is exactly what the lazy design exists to prevent (see the\n * `createCopilotRuntimeHandler` TSDoc).\n *\n * So on a LONG-RUNNING Hono host (`@hono/node-server`, Bun, Deno) calling\n * `await app.channels.ready()` once at startup is REQUIRED to connect declared\n * Channels; on an edge/serverless host do NOT call it.\n */\nexport type CopilotHonoApp = Hono & { channels?: ChannelsControl };\n\n/**\n * CORS configuration for CopilotKit endpoints.\n * When using credentials (e.g., HTTP-only cookies), you must specify an explicit origin.\n */\nexport interface CopilotEndpointCorsConfig {\n  /**\n   * Allowed origin(s) for CORS. Can be:\n   * - A string: exact origin (e.g., \"https://myapp.com\")\n   * - An array: list of allowed origins\n   * - A function: dynamic origin resolution\n   *\n   * Note: When credentials is true, origin cannot be \"*\"\n   */\n  origin:\n    | string\n    | string[]\n    | ((origin: string, c: any) => string | undefined | null);\n  /**\n   * Whether to allow credentials (cookies, HTTP authentication).\n   * When true, origin must be explicitly specified (not \"*\").\n   */\n  credentials?: boolean;\n}\n\ninterface CopilotEndpointParams {\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   * Optional CORS configuration. When not provided, defaults to allowing all origins without credentials.\n   * To support HTTP-only cookies, provide cors config with credentials: true and explicit origin.\n   */\n  cors?: CopilotEndpointCorsConfig;\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. Defaults to `true`. Building it opens no\n   * connection — activation is deferred to the first `channels.ready()`. 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/** @deprecated Use `createCopilotHonoHandler` instead. */\nexport const createCopilotEndpoint = createCopilotHonoHandler;\n\nexport function createCopilotHonoHandler({\n  runtime,\n  basePath,\n  mode = \"multi-route\",\n  cors: corsConfig,\n  hooks,\n  activateChannels,\n  __channelEngine,\n}: CopilotEndpointParams): CopilotHonoApp {\n  const handler = createCopilotRuntimeHandler({\n    runtime,\n    basePath,\n    mode,\n    cors: corsConfig ? toFetchCorsConfig(corsConfig) : true,\n    hooks,\n    activateChannels,\n    __channelEngine,\n  });\n\n  const app = new Hono();\n\n  const scopedApp: CopilotHonoApp = app\n    .basePath(basePath)\n    .all(\"*\", async (c) => handler(c.req.raw));\n  scopedApp.channels = handler.channels;\n  return scopedApp;\n}\n\n/**\n * Convert Hono-specific CORS config to the fetch handler's CopilotCorsConfig.\n */\nexport function toFetchCorsConfig(\n  config: CopilotEndpointCorsConfig,\n): CopilotCorsConfig {\n  const origin = config.origin;\n  return {\n    origin:\n      typeof origin === \"function\"\n        ? (reqOrigin: string) => origin(reqOrigin, undefined) ?? null\n        : origin,\n    credentials: config.credentials,\n  };\n}\n"],"mappings":";;;;;;;AAyFA,MAAa,wBAAwB;AAErC,SAAgB,yBAAyB,EACvC,SACA,UACA,OAAO,eACP,MAAM,YACN,OACA,kBACA,mBACwC;CACxC,MAAM,UAAUA,kDAA4B;EAC1C;EACA;EACA;EACA,MAAM,aAAa,kBAAkB,WAAW,GAAG;EACnD;EACA;EACA;EACD,CAAC;CAIF,MAAM,YAFM,IAAIC,WAAM,CAGnB,SAAS,SAAS,CAClB,IAAI,KAAK,OAAO,MAAM,QAAQ,EAAE,IAAI,IAAI,CAAC;AAC5C,WAAU,WAAW,QAAQ;AAC7B,QAAO;;;;;AAMT,SAAgB,kBACd,QACmB;CACnB,MAAM,SAAS,OAAO;AACtB,QAAO;EACL,QACE,OAAO,WAAW,cACb,cAAsB,OAAO,WAAW,OAAU,IAAI,OACvD;EACN,aAAa,OAAO;EACrB"}