@copilotkit/runtime 1.55.0-next.9 → 1.55.0

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

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

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

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

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

@@ -1,200 +1,52 @@
 import "reflect-metadata";
-import telemetry from "../telemetry/telemetry-client.mjs";
-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 { handleArchiveThread, handleDeleteThread, handleListThreads, handleSubscribeToThreads, handleUpdateThread } from "../handlers/intelligence/threads.mjs";
-import { createFetchRequestFromExpress, sendFetchResponse } from "./express-utils.mjs";
-import { getLicenseWarningHeader, logger } from "@copilotkit/shared";
+import { createCopilotRuntimeHandler } from "../core/fetch-handler.mjs";
+import { createExpressNodeHandler } from "./express-fetch-bridge.mjs";
 import express from "express";
 import cors from "cors";
 
 //#region src/v2/runtime/endpoints/express.ts
-function createCopilotEndpointExpress({ runtime, basePath }) {
-	const router = express.Router();
+function createCopilotExpressHandler({ runtime, basePath, mode = "multi-route", cors: corsOption = true, hooks }) {
 	const normalizedBase = normalizeBasePath(basePath);
-	Promise.resolve(runtime.agents).then((agents) => {
-		telemetry.capture("oss.runtime.instance_created", {
-			actionsAmount: 0,
-			endpointTypes: [],
-			endpointsAmount: 0,
-			agentsAmount: Object.keys(agents).length,
-			"cloud.api_key_provided": false
-		});
-	}).catch(() => {});
-	router.use(cors({
-		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 handleRunAgent({
-			runtime,
-			request,
-			agentId
-		});
-	}));
-	router.post(joinPath(normalizedBase, "/agent/:agentId/connect"), createRouteHandler(runtime, async ({ request, req }) => {
-		const agentId = req.params.agentId;
-		return 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 handleStopAgent({
-			runtime,
-			request,
-			agentId,
-			threadId
-		});
-	}));
-	router.get(joinPath(normalizedBase, "/info"), createRouteHandler(runtime, async ({ request }) => {
-		return handleGetRuntimeInfo({
-			runtime,
-			request
-		});
-	}));
-	router.post(joinPath(normalizedBase, "/transcribe"), createRouteHandler(runtime, async ({ request }) => {
-		return handleTranscribe({
-			runtime,
-			request
-		});
-	}));
-	router.get(joinPath(normalizedBase, "/threads"), createRouteHandler(runtime, async ({ request }) => {
-		return handleListThreads({
-			runtime,
-			request
-		});
-	}));
-	router.post(joinPath(normalizedBase, "/threads/subscribe"), createRouteHandler(runtime, async ({ request }) => {
-		return handleSubscribeToThreads({
-			runtime,
-			request
-		});
-	}));
-	router.patch(joinPath(normalizedBase, "/threads/:threadId"), createRouteHandler(runtime, async ({ request, req }) => {
-		const threadId = req.params.threadId;
-		return handleUpdateThread({
-			runtime,
-			request,
-			threadId
-		});
-	}));
-	router.post(joinPath(normalizedBase, "/threads/:threadId/archive"), createRouteHandler(runtime, async ({ request, req }) => {
-		const threadId = req.params.threadId;
-		return handleArchiveThread({
-			runtime,
-			request,
-			threadId
-		});
-	}));
-	router.delete(joinPath(normalizedBase, "/threads/:threadId"), createRouteHandler(runtime, async ({ request, req }) => {
-		const threadId = req.params.threadId;
-		return 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 = createFetchRequestFromExpress(req);
-		const warning = getLicenseWarningHeader(runtime.licenseChecker);
-		if (warning) res.setHeader(warning.key, warning.value);
+	const nodeHandler = createExpressNodeHandler(createCopilotRuntimeHandler({
+		runtime,
+		basePath: normalizedBase,
+		mode,
+		cors: false,
+		hooks
+	}));
+	const expressHandler = async (req, res, next) => {
 		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;
-		}
-		try {
-			const response = await factory({
-				request,
-				req
-			});
-			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 request handler");
-			next(error);
+			await nodeHandler(req, res);
+		} catch (err) {
+			next(err);
 		}
 	};
+	const router = express.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(`${normalizedBase}/*`, expressHandler);
+		router.all(normalizedBase, expressHandler);
+	}
+	return router;
 }
 function normalizeBasePath(path) {
 	if (!path) throw new Error("basePath must be provided for Express endpoint");
@@ -202,13 +54,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
-export { createCopilotEndpointExpress };
+export { createCopilotExpressHandler };
 //# sourceMappingURL=express.mjs.map

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

@@ -1 +1 @@
-{"version":3,"file":"express.mjs","names":[],"sources":["../../../../src/v2/runtime/endpoints/express.ts"],"sourcesContent":["import 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.mjs","names":[],"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,cAAc,yBARJ,4BAA4B;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,QAAQ,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,IAAI,KAAK,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/hono-single.cjs

@@ -1,133 +1,21 @@
 require("reflect-metadata");
 const require_runtime = require('../../../_virtual/_rolldown/runtime.cjs');
-const require_handle_run = require('../handlers/handle-run.cjs');
-const require_get_runtime_info = require('../handlers/get-runtime-info.cjs');
-const require_handle_transcribe = require('../handlers/handle-transcribe.cjs');
-const require_middleware = require('../middleware.cjs');
-const require_handle_connect = require('../handlers/handle-connect.cjs');
-const require_handle_stop = require('../handlers/handle-stop.cjs');
-const require_single_route_helpers = require('./single-route-helpers.cjs');
-let _copilotkit_shared = require("@copilotkit/shared");
+const require_fetch_handler = require('../core/fetch-handler.cjs');
+const require_hono = require('./hono.cjs');
 let hono = require("hono");
-let hono_cors = require("hono/cors");
 
 //#region src/v2/runtime/endpoints/hono-single.ts
-function createCopilotEndpointSingleRoute({ runtime, basePath, cors: corsConfig }) {
-	const app = new hono.Hono();
+/** @deprecated Use `createCopilotHonoHandler` with `mode: "single-route"` instead. */
+function createCopilotEndpointSingleRoute({ runtime, basePath, cors: corsConfig, hooks }) {
 	const routePath = normalizePath(basePath);
-	return app.basePath(routePath).use("*", (0, hono_cors.cors)({
-		origin: corsConfig?.origin ?? "*",
-		allowMethods: [
-			"GET",
-			"HEAD",
-			"PUT",
-			"POST",
-			"DELETE",
-			"PATCH",
-			"OPTIONS"
-		],
-		allowHeaders: ["*"],
-		credentials: corsConfig?.credentials ?? false
-	})).use("*", async (c, next) => {
-		const request = c.req.raw;
-		const path = c.req.path;
-		try {
-			const maybeModifiedRequest = await require_middleware.callBeforeRequestMiddleware({
-				runtime,
-				request,
-				path
-			});
-			if (maybeModifiedRequest) c.set("modifiedRequest", maybeModifiedRequest);
-		} catch (error) {
-			_copilotkit_shared.logger.error({
-				err: error,
-				url: request.url,
-				path
-			}, "Error running before request middleware");
-			if (error instanceof Response) return error;
-			throw error;
-		}
-		await next();
-	}).use("*", async (c, next) => {
-		await next();
-		const response = c.res.clone();
-		const path = c.req.path;
-		require_middleware.callAfterRequestMiddleware({
-			runtime,
-			response,
-			path
-		}).catch((error) => {
-			_copilotkit_shared.logger.error({
-				err: error,
-				url: c.req.url,
-				path
-			}, "Error running after request middleware");
-		});
-	}).post("/", async (c) => {
-		const request = c.get("modifiedRequest") || c.req.raw;
-		let methodCall;
-		try {
-			methodCall = await require_single_route_helpers.parseMethodCall(request);
-		} catch (error) {
-			if (error instanceof Response) {
-				_copilotkit_shared.logger.warn({ url: request.url }, "Invalid single-route payload");
-				return error;
-			}
-			_copilotkit_shared.logger.warn({
-				err: error,
-				url: request.url
-			}, "Invalid single-route payload");
-			return c.json({
-				error: "invalid_request",
-				message: error instanceof Error ? error.message : "Invalid request payload"
-			}, 400);
-		}
-		try {
-			switch (methodCall.method) {
-				case "agent/run": {
-					const agentId = require_single_route_helpers.expectString(methodCall.params, "agentId");
-					return await require_handle_run.handleRunAgent({
-						runtime,
-						request: require_single_route_helpers.createJsonRequest(request, methodCall.body),
-						agentId
-					});
-				}
-				case "agent/connect": {
-					const agentId = require_single_route_helpers.expectString(methodCall.params, "agentId");
-					return await require_handle_connect.handleConnectAgent({
-						runtime,
-						request: require_single_route_helpers.createJsonRequest(request, methodCall.body),
-						agentId
-					});
-				}
-				case "agent/stop": return await require_handle_stop.handleStopAgent({
-					runtime,
-					request,
-					agentId: require_single_route_helpers.expectString(methodCall.params, "agentId"),
-					threadId: require_single_route_helpers.expectString(methodCall.params, "threadId")
-				});
-				case "info": return await require_get_runtime_info.handleGetRuntimeInfo({
-					runtime,
-					request
-				});
-				case "transcribe": return await require_handle_transcribe.handleTranscribe({
-					runtime,
-					request: require_single_route_helpers.createJsonRequest(request, methodCall.body)
-				});
-				default: return methodCall.method;
-			}
-		} catch (error) {
-			if (error instanceof Response) return error;
-			_copilotkit_shared.logger.error({
-				err: error,
-				url: request.url,
-				method: methodCall.method
-			}, "Error running single-route handler");
-			throw error;
-		}
-	}).notFound((c) => {
-		return c.json({ error: "Not found" }, 404);
+	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");

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

@@ -1 +1 @@
-{"version":3,"file":"hono-single.cjs","names":["Hono","callBeforeRequestMiddleware","parseMethodCall","expectString","handleRunAgent","createJsonRequest","handleConnectAgent","handleStopAgent","handleGetRuntimeInfo","handleTranscribe"],"sources":["../../../../src/v2/runtime/endpoints/hono-single.ts"],"sourcesContent":["import { Hono } from \"hono\";\nimport { cors } from \"hono/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  createJsonRequest,\n  expectString,\n  MethodCall,\n  parseMethodCall,\n} from \"./single-route-helpers\";\n\nimport { CopilotEndpointCorsConfig } 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\ntype CopilotEndpointContext = {\n  Variables: {\n    modifiedRequest?: Request;\n  };\n};\n\nexport function createCopilotEndpointSingleRoute({\n  runtime,\n  basePath,\n  cors: corsConfig,\n}: CopilotSingleEndpointParams) {\n  const app = new Hono<CopilotEndpointContext>();\n  const routePath = normalizePath(basePath);\n\n  return app\n    .basePath(routePath)\n    .use(\n      \"*\",\n      cors({\n        origin: corsConfig?.origin ?? \"*\",\n        allowMethods: [\n          \"GET\",\n          \"HEAD\",\n          \"PUT\",\n          \"POST\",\n          \"DELETE\",\n          \"PATCH\",\n          \"OPTIONS\",\n        ],\n        allowHeaders: [\"*\"],\n        credentials: corsConfig?.credentials ?? false,\n      }),\n    )\n    .use(\"*\", async (c, next) => {\n      const request = c.req.raw;\n      const path = c.req.path;\n\n      try {\n        const maybeModifiedRequest = await callBeforeRequestMiddleware({\n          runtime,\n          request,\n          path,\n        });\n        if (maybeModifiedRequest) {\n          c.set(\"modifiedRequest\", 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          return error;\n        }\n        throw error;\n      }\n\n      await next();\n    })\n    .use(\"*\", async (c, next) => {\n      await next();\n\n      const response = c.res.clone();\n      const path = c.req.path;\n\n      callAfterRequestMiddleware({\n        runtime,\n        response,\n        path,\n      }).catch((error) => {\n        logger.error(\n          { err: error, url: c.req.url, path },\n          \"Error running after request middleware\",\n        );\n      });\n    })\n    .post(\"/\", async (c) => {\n      const request = c.get(\"modifiedRequest\") || c.req.raw;\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          return error;\n        }\n        logger.warn(\n          { err: error, url: request.url },\n          \"Invalid single-route payload\",\n        );\n        return c.json(\n          {\n            error: \"invalid_request\",\n            message:\n              error instanceof Error\n                ? error.message\n                : \"Invalid request payload\",\n          },\n          400,\n        );\n      }\n\n      try {\n        switch (methodCall.method) {\n          case \"agent/run\": {\n            const agentId = expectString(methodCall.params, \"agentId\");\n            const handlerRequest = createJsonRequest(request, methodCall.body);\n            return await handleRunAgent({\n              runtime,\n              request: handlerRequest,\n              agentId,\n            });\n          }\n          case \"agent/connect\": {\n            const agentId = expectString(methodCall.params, \"agentId\");\n            const handlerRequest = createJsonRequest(request, methodCall.body);\n            return await handleConnectAgent({\n              runtime,\n              request: handlerRequest,\n              agentId,\n            });\n          }\n          case \"agent/stop\": {\n            const agentId = expectString(methodCall.params, \"agentId\");\n            const threadId = expectString(methodCall.params, \"threadId\");\n            return await handleStopAgent({\n              runtime,\n              request,\n              agentId,\n              threadId,\n            });\n          }\n          case \"info\": {\n            return await handleGetRuntimeInfo({ runtime, request });\n          }\n          case \"transcribe\": {\n            const handlerRequest = createJsonRequest(request, methodCall.body);\n            return await handleTranscribe({ runtime, request: handlerRequest });\n          }\n          default: {\n            const exhaustiveCheck: never = methodCall.method;\n            return exhaustiveCheck;\n          }\n        }\n      } catch (error) {\n        if (error instanceof Response) {\n          return error;\n        }\n        logger.error(\n          { err: error, url: request.url, method: methodCall.method },\n          \"Error running single-route handler\",\n        );\n        throw error;\n      }\n    })\n    .notFound((c) => {\n      return c.json({ error: \"Not found\" }, 404);\n    });\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":"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"}
+{"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,6 +1,8 @@
 
-import { CopilotRuntimeLike } from "../runtime.cjs";
+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";
 
@@ -16,26 +18,27 @@ interface CopilotSingleEndpointParams {
    * To support HTTP-only cookies, provide cors config with credentials: true and explicit origin.
    */
   cors?: CopilotEndpointCorsConfig;
+  /**
+   * Lifecycle hooks for request processing.
+   */
+  hooks?: CopilotRuntimeHooks;
 }
-type CopilotEndpointContext = {
-  Variables: {
-    modifiedRequest?: Request;
-  };
-};
+/** @deprecated Use `createCopilotHonoHandler` with `mode: "single-route"` instead. */
 declare function createCopilotEndpointSingleRoute({
   runtime,
   basePath,
-  cors: corsConfig
-}: CopilotSingleEndpointParams): hono_hono_base0.HonoBase<CopilotEndpointContext, {
-  [x: string]: {
-    $post: {
+  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>;
+}, string, `${string}/*`>;
 //#endregion
 export { createCopilotEndpointSingleRoute };
 //# sourceMappingURL=hono-single.d.cts.map

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

@@ -1 +1 @@
-{"version":3,"file":"hono-single.d.cts","names":[],"sources":["../../../../src/v2/runtime/endpoints/hono-single.ts"],"mappings":";;;;;;;UAuBU,2BAAA;EACR,OAAA,EAAS,kBAAA;;;AAHwC;EAOjD,QAAA;;;;;EAKA,IAAA,GAAO,yBAAA;AAAA;AAAA,KAGJ,sBAAA;EACH,SAAA;IACE,eAAA,GAAkB,OAAA;EAAA;AAAA;AAAA,iBAIN,gCAAA,CAAA;EACd,OAAA;EACA,QAAA;EACA,IAAA,EAAM;AAAA,GACL,2BAAA,mBAA2B,QAAA,CAAA,sBAAA;EAAA;;;;;cAAA,uBAAA,CAAA,UAAA;IAAA;EAAA;AAAA"}
+{"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,6 +1,8 @@
 import "reflect-metadata";
-import { CopilotRuntimeLike } from "../runtime.mjs";
+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";
 
@@ -16,26 +18,27 @@ interface CopilotSingleEndpointParams {
    * To support HTTP-only cookies, provide cors config with credentials: true and explicit origin.
    */
   cors?: CopilotEndpointCorsConfig;
+  /**
+   * Lifecycle hooks for request processing.
+   */
+  hooks?: CopilotRuntimeHooks;
 }
-type CopilotEndpointContext = {
-  Variables: {
-    modifiedRequest?: Request;
-  };
-};
+/** @deprecated Use `createCopilotHonoHandler` with `mode: "single-route"` instead. */
 declare function createCopilotEndpointSingleRoute({
   runtime,
   basePath,
-  cors: corsConfig
-}: CopilotSingleEndpointParams): hono_hono_base0.HonoBase<CopilotEndpointContext, {
-  [x: string]: {
-    $post: {
+  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>;
+}, string, `${string}/*`>;
 //#endregion
 export { createCopilotEndpointSingleRoute };
 //# sourceMappingURL=hono-single.d.mts.map

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

@@ -1 +1 @@
-{"version":3,"file":"hono-single.d.mts","names":[],"sources":["../../../../src/v2/runtime/endpoints/hono-single.ts"],"mappings":";;;;;;;UAuBU,2BAAA;EACR,OAAA,EAAS,kBAAA;;;AAHwC;EAOjD,QAAA;;;;;EAKA,IAAA,GAAO,yBAAA;AAAA;AAAA,KAGJ,sBAAA;EACH,SAAA;IACE,eAAA,GAAkB,OAAA;EAAA;AAAA;AAAA,iBAIN,gCAAA,CAAA;EACd,OAAA;EACA,QAAA;EACA,IAAA,EAAM;AAAA,GACL,2BAAA,mBAA2B,QAAA,CAAA,sBAAA;EAAA;;;;;cAAA,uBAAA,CAAA,UAAA;IAAA;EAAA;AAAA"}
+{"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"}