@copilotkit/runtime 1.55.0-next.8 → 1.55.0

package/dist/v2/runtime/core/fetch-handler.mjs

@@ -0,0 +1,231 @@
+import "reflect-metadata";
+import { runOnBeforeHandler, runOnError, runOnRequest, runOnResponse } from "./hooks.mjs";
+import { addCorsHeaders, handleCors } from "./fetch-cors.mjs";
+import { matchRoute } from "./fetch-router.mjs";
+import { callAfterRequestMiddleware, callBeforeRequestMiddleware } from "./middleware.mjs";
+import { handleRunAgent } from "../handlers/handle-run.mjs";
+import { handleConnectAgent } from "../handlers/handle-connect.mjs";
+import { handleStopAgent } from "../handlers/handle-stop.mjs";
+import { handleGetRuntimeInfo } from "../handlers/get-runtime-info.mjs";
+import { handleTranscribe } from "../handlers/handle-transcribe.mjs";
+import { createJsonRequest, expectString, parseMethodCall } from "../endpoints/single-route-helpers.mjs";
+import { logger } from "@copilotkit/shared";
+
+//#region src/v2/runtime/core/fetch-handler.ts
+function createCopilotRuntimeHandler(options) {
+	const { runtime, basePath, mode = "multi-route", cors, hooks } = options;
+	const corsConfig = resolveCorsConfig(cors);
+	return async (request) => {
+		const path = new URL(request.url, "http://localhost").pathname;
+		const requestOrigin = request.headers.get("origin");
+		const baseCtx = {
+			request,
+			path,
+			runtime
+		};
+		let route;
+		try {
+			if (corsConfig) {
+				const preflight = handleCors(request, corsConfig);
+				if (preflight) return preflight;
+			}
+			request = await runOnRequest(hooks, {
+				...baseCtx,
+				request
+			});
+			try {
+				const maybeModified = await callBeforeRequestMiddleware({
+					runtime,
+					request,
+					path
+				});
+				if (maybeModified) request = maybeModified;
+			} catch (mwError) {
+				logger.error({
+					err: mwError,
+					url: request.url,
+					path
+				}, "Error running before request middleware");
+				if (mwError instanceof Response) return maybeAddCors(mwError, corsConfig, requestOrigin);
+				throw mwError;
+			}
+			let response;
+			if (mode === "single-route") {
+				const resolved = await resolveSingleRoute(request, basePath, path);
+				route = resolved.route;
+				const { methodCall } = resolved;
+				request = await runOnBeforeHandler(hooks, {
+					request,
+					path,
+					runtime,
+					route
+				});
+				if (route.method === "agent/run" || route.method === "agent/connect" || route.method === "transcribe") request = createJsonRequest(request, methodCall.body);
+				response = await dispatchRoute(runtime, request, route);
+			} else {
+				const matched = matchRoute(path, basePath);
+				if (!matched) throw jsonResponse({ error: "Not found" }, 404);
+				const methodError = validateHttpMethod(request.method, matched);
+				if (methodError) {
+					route = matched;
+					throw methodError;
+				}
+				route = matched;
+				request = await runOnBeforeHandler(hooks, {
+					request,
+					path,
+					runtime,
+					route
+				});
+				response = await dispatchRoute(runtime, request, route);
+			}
+			response = await runOnResponse(hooks, {
+				request,
+				response,
+				path,
+				runtime,
+				route
+			});
+			response = maybeAddCors(response, corsConfig, requestOrigin);
+			callAfterRequestMiddleware({
+				runtime,
+				response: response.clone(),
+				path
+			}).catch((error) => {
+				logger.error({
+					err: error,
+					url: request.url,
+					path
+				}, "Error running after request middleware");
+			});
+			return response;
+		} catch (error) {
+			if (error instanceof Response) return maybeAddCors(await runOnResponse(hooks, {
+				request,
+				response: error,
+				path,
+				runtime,
+				route: route ?? { method: "info" }
+			}), corsConfig, requestOrigin);
+			try {
+				const errorResponse = await runOnError(hooks, {
+					request,
+					error,
+					path,
+					runtime,
+					route
+				});
+				if (errorResponse) return maybeAddCors(errorResponse, corsConfig, requestOrigin);
+			} catch (hookError) {
+				logger.error({
+					err: hookError,
+					originalErr: error,
+					url: request.url,
+					path
+				}, "onError hook threw");
+			}
+			logger.error({
+				err: error,
+				url: request.url,
+				path
+			}, "Unhandled error in CopilotKit runtime handler");
+			return maybeAddCors(jsonResponse({ error: "internal_error" }, 500), corsConfig, requestOrigin);
+		}
+	};
+}
+function dispatchRoute(runtime, request, route) {
+	switch (route.method) {
+		case "agent/run": return handleRunAgent({
+			runtime,
+			request,
+			agentId: route.agentId
+		});
+		case "agent/connect": return handleConnectAgent({
+			runtime,
+			request,
+			agentId: route.agentId
+		});
+		case "agent/stop": return handleStopAgent({
+			runtime,
+			request,
+			agentId: route.agentId,
+			threadId: route.threadId
+		});
+		case "info": return handleGetRuntimeInfo({
+			runtime,
+			request
+		});
+		case "transcribe": return handleTranscribe({
+			runtime,
+			request
+		});
+	}
+}
+async function resolveSingleRoute(request, basePath, pathname) {
+	if (basePath) {
+		const normalizedBase = basePath.length > 1 && basePath.endsWith("/") ? basePath.slice(0, -1) : basePath;
+		if (!pathname.startsWith(normalizedBase)) throw jsonResponse({ error: "Not found" }, 404);
+	}
+	if (request.method !== "POST") throw jsonResponse({ error: "Method not allowed" }, 405, { Allow: "POST" });
+	const methodCall = await parseMethodCall(request);
+	let route;
+	switch (methodCall.method) {
+		case "agent/run":
+			route = {
+				method: "agent/run",
+				agentId: expectString(methodCall.params, "agentId")
+			};
+			break;
+		case "agent/connect":
+			route = {
+				method: "agent/connect",
+				agentId: expectString(methodCall.params, "agentId")
+			};
+			break;
+		case "agent/stop":
+			route = {
+				method: "agent/stop",
+				agentId: expectString(methodCall.params, "agentId"),
+				threadId: expectString(methodCall.params, "threadId")
+			};
+			break;
+		case "info":
+			route = { method: "info" };
+			break;
+		case "transcribe":
+			route = { method: "transcribe" };
+			break;
+	}
+	return {
+		route,
+		methodCall
+	};
+}
+function validateHttpMethod(httpMethod, route) {
+	const method = httpMethod.toUpperCase();
+	if (route.method === "info" && method === "GET") return null;
+	if (route.method !== "info" && method === "POST") return null;
+	return jsonResponse({ error: "Method not allowed" }, 405, { Allow: route.method === "info" ? "GET" : "POST" });
+}
+function resolveCorsConfig(cors) {
+	if (!cors) return null;
+	if (cors === true) return {};
+	return cors;
+}
+function maybeAddCors(response, config, requestOrigin) {
+	if (!config) return response;
+	return addCorsHeaders(response, config, requestOrigin);
+}
+function jsonResponse(body, status, extraHeaders) {
+	return new Response(JSON.stringify(body), {
+		status,
+		headers: {
+			"Content-Type": "application/json",
+			...extraHeaders
+		}
+	});
+}
+
+//#endregion
+export { createCopilotRuntimeHandler };
+//# sourceMappingURL=fetch-handler.mjs.map

package/dist/v2/runtime/core/fetch-handler.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-handler.mjs","names":[],"sources":["../../../../src/v2/runtime/core/fetch-handler.ts"],"sourcesContent":["/**\n * Framework-agnostic CopilotKit runtime handler.\n *\n * Returns a pure `(Request) => Promise<Response>` function that can be used\n * directly with Bun, Deno, Cloudflare Workers, Next.js App Router, or any\n * Fetch-native runtime — no framework dependency required.\n *\n * @example\n * ```typescript\n * import { CopilotRuntime, createCopilotRuntimeHandler } from \"@copilotkit/runtime/v2\";\n *\n * const handler = createCopilotRuntimeHandler({\n *   runtime: new CopilotRuntime({ agents: { ... } }),\n *   basePath: \"/api/copilotkit\",\n *   cors: true,\n * });\n *\n * // Bun\n * Bun.serve({ fetch: handler });\n *\n * // Deno\n * Deno.serve(handler);\n *\n * // Cloudflare Workers\n * export default { fetch: handler };\n * ```\n */\n\nimport type { CopilotRuntimeLike } from \"./runtime\";\nimport type { CopilotRuntimeHooks, RouteInfo, HookContext } from \"./hooks\";\nimport {\n  runOnRequest,\n  runOnBeforeHandler,\n  runOnResponse,\n  runOnError,\n} from \"./hooks\";\nimport type { CopilotCorsConfig } from \"./fetch-cors\";\nimport { handleCors, addCorsHeaders } from \"./fetch-cors\";\nimport { matchRoute } from \"./fetch-router\";\nimport {\n  callBeforeRequestMiddleware,\n  callAfterRequestMiddleware,\n} from \"./middleware\";\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  parseMethodCall,\n  createJsonRequest,\n  expectString,\n  type MethodCall,\n} from \"../endpoints/single-route-helpers\";\nimport { logger } from \"@copilotkit/shared\";\n\n/* ------------------------------------------------------------------------------------------------\n * Public types\n * --------------------------------------------------------------------------------------------- */\n\nexport interface CopilotRuntimeHandlerOptions {\n  runtime: CopilotRuntimeLike;\n\n  /**\n   * Optional base path for routing.\n   *\n   * When provided: strict prefix stripping. The handler strips this prefix from the\n   * URL pathname and matches the remainder against known routes.\n   *\n   * When omitted: suffix matching. The handler matches known route patterns as\n   * suffixes of the URL pathname.\n   */\n  basePath?: string;\n\n  /**\n   * Endpoint mode:\n   * - \"multi-route\" (default): Routes like POST /agent/:agentId/run, GET /info, etc.\n   * - \"single-route\": Single POST endpoint with JSON envelope { method, params, body }\n   */\n  mode?: \"multi-route\" | \"single-route\";\n\n  /**\n   * Optional CORS configuration.\n   * When not provided, no CORS headers are added (let the framework handle it).\n   * Set to true for permissive defaults, or provide an object.\n   */\n  cors?: boolean | CopilotCorsConfig;\n\n  /**\n   * Lifecycle hooks for request processing.\n   */\n  hooks?: CopilotRuntimeHooks;\n}\n\nexport type CopilotRuntimeFetchHandler = (\n  request: Request,\n) => Promise<Response>;\n\n/* ------------------------------------------------------------------------------------------------\n * Handler factory\n * --------------------------------------------------------------------------------------------- */\n\nexport function createCopilotRuntimeHandler(\n  options: CopilotRuntimeHandlerOptions,\n): CopilotRuntimeFetchHandler {\n  const { runtime, basePath, mode = \"multi-route\", cors, hooks } = options;\n\n  const corsConfig = resolveCorsConfig(cors);\n\n  return async (request: Request): Promise<Response> => {\n    const url = new URL(request.url, \"http://localhost\");\n    const path = url.pathname;\n    const requestOrigin = request.headers.get(\"origin\");\n\n    // Base hook context (route not yet known)\n    const baseCtx: HookContext = { request, path, runtime };\n\n    let route: RouteInfo | undefined;\n\n    try {\n      // 1. CORS preflight\n      if (corsConfig) {\n        const preflight = handleCors(request, corsConfig);\n        if (preflight) return preflight;\n      }\n\n      // 2. onRequest hook\n      request = await runOnRequest(hooks, { ...baseCtx, request });\n\n      // 3. Legacy beforeRequestMiddleware\n      try {\n        const maybeModified = await callBeforeRequestMiddleware({\n          runtime,\n          request,\n          path,\n        });\n        if (maybeModified) {\n          request = maybeModified;\n        }\n      } catch (mwError: unknown) {\n        logger.error(\n          { err: mwError, url: request.url, path },\n          \"Error running before request middleware\",\n        );\n        if (mwError instanceof Response) {\n          return maybeAddCors(mwError, corsConfig, requestOrigin);\n        }\n        throw mwError;\n      }\n\n      // 4. Route matching\n      let response: Response;\n\n      if (mode === \"single-route\") {\n        const resolved = await resolveSingleRoute(request, basePath, path);\n        route = resolved.route;\n        const { methodCall } = resolved;\n        // 5. onBeforeHandler hook\n        request = await runOnBeforeHandler(hooks, {\n          request,\n          path,\n          runtime,\n          route,\n        });\n        // 6. Wrap body for methods that need it, then dispatch\n        if (\n          route.method === \"agent/run\" ||\n          route.method === \"agent/connect\" ||\n          route.method === \"transcribe\"\n        ) {\n          request = createJsonRequest(request, methodCall.body);\n        }\n        response = await dispatchRoute(runtime, request, route);\n      } else {\n        // Multi-route: match URL pattern\n        const matched = matchRoute(path, basePath);\n        if (!matched) {\n          throw jsonResponse({ error: \"Not found\" }, 404);\n        }\n\n        // Validate HTTP method\n        const methodError = validateHttpMethod(request.method, matched);\n        if (methodError) {\n          route = matched;\n          throw methodError;\n        }\n\n        route = matched;\n\n        // 5. onBeforeHandler hook\n        request = await runOnBeforeHandler(hooks, {\n          request,\n          path,\n          runtime,\n          route,\n        });\n\n        // 6. Handler dispatch\n        response = await dispatchRoute(runtime, request, route);\n      }\n\n      // 7. onResponse hook\n      response = await runOnResponse(hooks, {\n        request,\n        response,\n        path,\n        runtime,\n        route,\n      });\n\n      // 8. CORS headers on response\n      response = maybeAddCors(response, corsConfig, requestOrigin);\n\n      // 9. Legacy afterRequestMiddleware (non-blocking)\n      // Clone the response so middleware can read the body without consuming\n      // the original stream that will be sent to the client.\n      callAfterRequestMiddleware({\n        runtime,\n        response: response.clone(),\n        path,\n      }).catch((error: unknown) => {\n        logger.error(\n          { err: error, url: request.url, path },\n          \"Error running after request middleware\",\n        );\n      });\n\n      return response;\n    } catch (error) {\n      // Short-circuit with thrown Response\n      if (error instanceof Response) {\n        const finalResponse = await runOnResponse(hooks, {\n          request,\n          response: error,\n          path,\n          runtime,\n          route: route ?? { method: \"info\" },\n        });\n        return maybeAddCors(finalResponse, corsConfig, requestOrigin);\n      }\n\n      // Run onError hook — wrapped so a throwing hook doesn't escape\n      try {\n        const errorResponse = await runOnError(hooks, {\n          request,\n          error,\n          path,\n          runtime,\n          route,\n        });\n\n        if (errorResponse) {\n          return maybeAddCors(errorResponse, corsConfig, requestOrigin);\n        }\n      } catch (hookError: unknown) {\n        logger.error(\n          { err: hookError, originalErr: error, url: request.url, path },\n          \"onError hook threw\",\n        );\n      }\n\n      logger.error(\n        { err: error, url: request.url, path },\n        \"Unhandled error in CopilotKit runtime handler\",\n      );\n\n      return maybeAddCors(\n        jsonResponse({ error: \"internal_error\" }, 500),\n        corsConfig,\n        requestOrigin,\n      );\n    }\n  };\n}\n\n/* ------------------------------------------------------------------------------------------------\n * Route dispatch\n * --------------------------------------------------------------------------------------------- */\n\nfunction dispatchRoute(\n  runtime: CopilotRuntimeLike,\n  request: Request,\n  route: RouteInfo,\n): Promise<Response> {\n  switch (route.method) {\n    case \"agent/run\":\n      return handleRunAgent({\n        runtime,\n        request,\n        agentId: route.agentId,\n      });\n    case \"agent/connect\":\n      return handleConnectAgent({\n        runtime,\n        request,\n        agentId: route.agentId,\n      });\n    case \"agent/stop\":\n      return handleStopAgent({\n        runtime,\n        request,\n        agentId: route.agentId,\n        threadId: route.threadId,\n      });\n    case \"info\":\n      return handleGetRuntimeInfo({ runtime, request });\n    case \"transcribe\":\n      return handleTranscribe({ runtime, request });\n  }\n}\n\ninterface SingleRouteResolution {\n  route: RouteInfo;\n  methodCall: MethodCall;\n}\n\nasync function resolveSingleRoute(\n  request: Request,\n  basePath: string | undefined,\n  pathname: string,\n): Promise<SingleRouteResolution> {\n  if (basePath) {\n    const normalizedBase =\n      basePath.length > 1 && basePath.endsWith(\"/\")\n        ? basePath.slice(0, -1)\n        : basePath;\n    if (!pathname.startsWith(normalizedBase)) {\n      throw jsonResponse({ error: \"Not found\" }, 404);\n    }\n  }\n\n  if (request.method !== \"POST\") {\n    throw jsonResponse({ error: \"Method not allowed\" }, 405, { Allow: \"POST\" });\n  }\n\n  const methodCall = await parseMethodCall(request);\n\n  let route: RouteInfo;\n  switch (methodCall.method) {\n    case \"agent/run\":\n      route = {\n        method: \"agent/run\",\n        agentId: expectString(methodCall.params, \"agentId\"),\n      };\n      break;\n    case \"agent/connect\":\n      route = {\n        method: \"agent/connect\",\n        agentId: expectString(methodCall.params, \"agentId\"),\n      };\n      break;\n    case \"agent/stop\":\n      route = {\n        method: \"agent/stop\",\n        agentId: expectString(methodCall.params, \"agentId\"),\n        threadId: expectString(methodCall.params, \"threadId\"),\n      };\n      break;\n    case \"info\":\n      route = { method: \"info\" };\n      break;\n    case \"transcribe\":\n      route = { method: \"transcribe\" };\n      break;\n  }\n\n  return { route, methodCall };\n}\n\n/* ------------------------------------------------------------------------------------------------\n * HTTP method validation\n * --------------------------------------------------------------------------------------------- */\n\nfunction validateHttpMethod(\n  httpMethod: string,\n  route: RouteInfo,\n): Response | null {\n  const method = httpMethod.toUpperCase();\n  if (route.method === \"info\" && method === \"GET\") return null;\n  if (route.method !== \"info\" && method === \"POST\") return null;\n  const allowed = route.method === \"info\" ? \"GET\" : \"POST\";\n  return jsonResponse({ error: \"Method not allowed\" }, 405, { Allow: allowed });\n}\n\n/* ------------------------------------------------------------------------------------------------\n * Helpers\n * --------------------------------------------------------------------------------------------- */\n\nfunction resolveCorsConfig(\n  cors: boolean | CopilotCorsConfig | undefined,\n): CopilotCorsConfig | null {\n  if (!cors) return null;\n  if (cors === true) return {};\n  return cors;\n}\n\nfunction maybeAddCors(\n  response: Response,\n  config: CopilotCorsConfig | null,\n  requestOrigin: string | null,\n): Response {\n  if (!config) return response;\n  return addCorsHeaders(response, config, requestOrigin);\n}\n\nfunction jsonResponse(\n  body: unknown,\n  status: number,\n  extraHeaders?: Record<string, string>,\n): Response {\n  return new Response(JSON.stringify(body), {\n    status,\n    headers: { \"Content-Type\": \"application/json\", ...extraHeaders },\n  });\n}\n"],"mappings":";;;;;;;;;;;;;;AAsGA,SAAgB,4BACd,SAC4B;CAC5B,MAAM,EAAE,SAAS,UAAU,OAAO,eAAe,MAAM,UAAU;CAEjE,MAAM,aAAa,kBAAkB,KAAK;AAE1C,QAAO,OAAO,YAAwC;EAEpD,MAAM,OADM,IAAI,IAAI,QAAQ,KAAK,mBAAmB,CACnC;EACjB,MAAM,gBAAgB,QAAQ,QAAQ,IAAI,SAAS;EAGnD,MAAM,UAAuB;GAAE;GAAS;GAAM;GAAS;EAEvD,IAAI;AAEJ,MAAI;AAEF,OAAI,YAAY;IACd,MAAM,YAAY,WAAW,SAAS,WAAW;AACjD,QAAI,UAAW,QAAO;;AAIxB,aAAU,MAAM,aAAa,OAAO;IAAE,GAAG;IAAS;IAAS,CAAC;AAG5D,OAAI;IACF,MAAM,gBAAgB,MAAM,4BAA4B;KACtD;KACA;KACA;KACD,CAAC;AACF,QAAI,cACF,WAAU;YAEL,SAAkB;AACzB,WAAO,MACL;KAAE,KAAK;KAAS,KAAK,QAAQ;KAAK;KAAM,EACxC,0CACD;AACD,QAAI,mBAAmB,SACrB,QAAO,aAAa,SAAS,YAAY,cAAc;AAEzD,UAAM;;GAIR,IAAI;AAEJ,OAAI,SAAS,gBAAgB;IAC3B,MAAM,WAAW,MAAM,mBAAmB,SAAS,UAAU,KAAK;AAClE,YAAQ,SAAS;IACjB,MAAM,EAAE,eAAe;AAEvB,cAAU,MAAM,mBAAmB,OAAO;KACxC;KACA;KACA;KACA;KACD,CAAC;AAEF,QACE,MAAM,WAAW,eACjB,MAAM,WAAW,mBACjB,MAAM,WAAW,aAEjB,WAAU,kBAAkB,SAAS,WAAW,KAAK;AAEvD,eAAW,MAAM,cAAc,SAAS,SAAS,MAAM;UAClD;IAEL,MAAM,UAAU,WAAW,MAAM,SAAS;AAC1C,QAAI,CAAC,QACH,OAAM,aAAa,EAAE,OAAO,aAAa,EAAE,IAAI;IAIjD,MAAM,cAAc,mBAAmB,QAAQ,QAAQ,QAAQ;AAC/D,QAAI,aAAa;AACf,aAAQ;AACR,WAAM;;AAGR,YAAQ;AAGR,cAAU,MAAM,mBAAmB,OAAO;KACxC;KACA;KACA;KACA;KACD,CAAC;AAGF,eAAW,MAAM,cAAc,SAAS,SAAS,MAAM;;AAIzD,cAAW,MAAM,cAAc,OAAO;IACpC;IACA;IACA;IACA;IACA;IACD,CAAC;AAGF,cAAW,aAAa,UAAU,YAAY,cAAc;AAK5D,8BAA2B;IACzB;IACA,UAAU,SAAS,OAAO;IAC1B;IACD,CAAC,CAAC,OAAO,UAAmB;AAC3B,WAAO,MACL;KAAE,KAAK;KAAO,KAAK,QAAQ;KAAK;KAAM,EACtC,yCACD;KACD;AAEF,UAAO;WACA,OAAO;AAEd,OAAI,iBAAiB,SAQnB,QAAO,aAPe,MAAM,cAAc,OAAO;IAC/C;IACA,UAAU;IACV;IACA;IACA,OAAO,SAAS,EAAE,QAAQ,QAAQ;IACnC,CAAC,EACiC,YAAY,cAAc;AAI/D,OAAI;IACF,MAAM,gBAAgB,MAAM,WAAW,OAAO;KAC5C;KACA;KACA;KACA;KACA;KACD,CAAC;AAEF,QAAI,cACF,QAAO,aAAa,eAAe,YAAY,cAAc;YAExD,WAAoB;AAC3B,WAAO,MACL;KAAE,KAAK;KAAW,aAAa;KAAO,KAAK,QAAQ;KAAK;KAAM,EAC9D,qBACD;;AAGH,UAAO,MACL;IAAE,KAAK;IAAO,KAAK,QAAQ;IAAK;IAAM,EACtC,gDACD;AAED,UAAO,aACL,aAAa,EAAE,OAAO,kBAAkB,EAAE,IAAI,EAC9C,YACA,cACD;;;;AASP,SAAS,cACP,SACA,SACA,OACmB;AACnB,SAAQ,MAAM,QAAd;EACE,KAAK,YACH,QAAO,eAAe;GACpB;GACA;GACA,SAAS,MAAM;GAChB,CAAC;EACJ,KAAK,gBACH,QAAO,mBAAmB;GACxB;GACA;GACA,SAAS,MAAM;GAChB,CAAC;EACJ,KAAK,aACH,QAAO,gBAAgB;GACrB;GACA;GACA,SAAS,MAAM;GACf,UAAU,MAAM;GACjB,CAAC;EACJ,KAAK,OACH,QAAO,qBAAqB;GAAE;GAAS;GAAS,CAAC;EACnD,KAAK,aACH,QAAO,iBAAiB;GAAE;GAAS;GAAS,CAAC;;;AASnD,eAAe,mBACb,SACA,UACA,UACgC;AAChC,KAAI,UAAU;EACZ,MAAM,iBACJ,SAAS,SAAS,KAAK,SAAS,SAAS,IAAI,GACzC,SAAS,MAAM,GAAG,GAAG,GACrB;AACN,MAAI,CAAC,SAAS,WAAW,eAAe,CACtC,OAAM,aAAa,EAAE,OAAO,aAAa,EAAE,IAAI;;AAInD,KAAI,QAAQ,WAAW,OACrB,OAAM,aAAa,EAAE,OAAO,sBAAsB,EAAE,KAAK,EAAE,OAAO,QAAQ,CAAC;CAG7E,MAAM,aAAa,MAAM,gBAAgB,QAAQ;CAEjD,IAAI;AACJ,SAAQ,WAAW,QAAnB;EACE,KAAK;AACH,WAAQ;IACN,QAAQ;IACR,SAAS,aAAa,WAAW,QAAQ,UAAU;IACpD;AACD;EACF,KAAK;AACH,WAAQ;IACN,QAAQ;IACR,SAAS,aAAa,WAAW,QAAQ,UAAU;IACpD;AACD;EACF,KAAK;AACH,WAAQ;IACN,QAAQ;IACR,SAAS,aAAa,WAAW,QAAQ,UAAU;IACnD,UAAU,aAAa,WAAW,QAAQ,WAAW;IACtD;AACD;EACF,KAAK;AACH,WAAQ,EAAE,QAAQ,QAAQ;AAC1B;EACF,KAAK;AACH,WAAQ,EAAE,QAAQ,cAAc;AAChC;;AAGJ,QAAO;EAAE;EAAO;EAAY;;AAO9B,SAAS,mBACP,YACA,OACiB;CACjB,MAAM,SAAS,WAAW,aAAa;AACvC,KAAI,MAAM,WAAW,UAAU,WAAW,MAAO,QAAO;AACxD,KAAI,MAAM,WAAW,UAAU,WAAW,OAAQ,QAAO;AAEzD,QAAO,aAAa,EAAE,OAAO,sBAAsB,EAAE,KAAK,EAAE,OAD5C,MAAM,WAAW,SAAS,QAAQ,QAC0B,CAAC;;AAO/E,SAAS,kBACP,MAC0B;AAC1B,KAAI,CAAC,KAAM,QAAO;AAClB,KAAI,SAAS,KAAM,QAAO,EAAE;AAC5B,QAAO;;AAGT,SAAS,aACP,UACA,QACA,eACU;AACV,KAAI,CAAC,OAAQ,QAAO;AACpB,QAAO,eAAe,UAAU,QAAQ,cAAc;;AAGxD,SAAS,aACP,MACA,QACA,cACU;AACV,QAAO,IAAI,SAAS,KAAK,UAAU,KAAK,EAAE;EACxC;EACA,SAAS;GAAE,gBAAgB;GAAoB,GAAG;GAAc;EACjE,CAAC"}

package/dist/v2/runtime/core/fetch-router.cjs

@@ -0,0 +1,68 @@
+require("reflect-metadata");
+
+//#region src/v2/runtime/core/fetch-router.ts
+/**
+* Match a request URL against known CopilotKit route patterns.
+*
+* @param pathname - The URL pathname to match
+* @param basePath - Optional base path prefix to strip first
+* @returns RouteInfo if matched, null otherwise
+*/
+function matchRoute(pathname, basePath) {
+	let remainder;
+	if (basePath) {
+		const normalizedBase = basePath.length > 1 && basePath.endsWith("/") ? basePath.slice(0, -1) : basePath;
+		if (normalizedBase === "/") remainder = pathname;
+		else {
+			if (!pathname.startsWith(normalizedBase)) return null;
+			const afterBase = pathname.slice(normalizedBase.length);
+			if (afterBase.length > 0 && !afterBase.startsWith("/")) return null;
+			remainder = afterBase || "/";
+		}
+	} else remainder = pathname;
+	return matchSegments(remainder);
+}
+function safeDecodeURIComponent(value) {
+	try {
+		return decodeURIComponent(value);
+	} catch {
+		return null;
+	}
+}
+function matchSegments(path) {
+	const segments = path.split("/").filter(Boolean);
+	const len = segments.length;
+	if (len >= 1 && segments[len - 1] === "info") return { method: "info" };
+	if (len >= 1 && segments[len - 1] === "transcribe") return { method: "transcribe" };
+	if (len >= 3 && segments[len - 3] === "agent" && segments[len - 1] === "run") {
+		const agentId = safeDecodeURIComponent(segments[len - 2]);
+		if (!agentId) return null;
+		return {
+			method: "agent/run",
+			agentId
+		};
+	}
+	if (len >= 3 && segments[len - 3] === "agent" && segments[len - 1] === "connect") {
+		const agentId = safeDecodeURIComponent(segments[len - 2]);
+		if (!agentId) return null;
+		return {
+			method: "agent/connect",
+			agentId
+		};
+	}
+	if (len >= 4 && segments[len - 4] === "agent" && segments[len - 2] === "stop") {
+		const agentId = safeDecodeURIComponent(segments[len - 3]);
+		const threadId = safeDecodeURIComponent(segments[len - 1]);
+		if (!agentId || !threadId) return null;
+		return {
+			method: "agent/stop",
+			agentId,
+			threadId
+		};
+	}
+	return null;
+}
+
+//#endregion
+exports.matchRoute = matchRoute;
+//# sourceMappingURL=fetch-router.cjs.map

package/dist/v2/runtime/core/fetch-router.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-router.cjs","names":[],"sources":["../../../../src/v2/runtime/core/fetch-router.ts"],"sourcesContent":["/**\n * Lightweight URL router for framework-agnostic CopilotKit runtime handler.\n *\n * Two strategies:\n * - With `basePath`: strict prefix strip → match remainder\n * - Without `basePath`: suffix matching on known patterns\n *\n * Single-route mode: delegates to `parseMethodCall` for JSON envelope dispatch.\n */\n\nimport type { RouteInfo } from \"./hooks\";\n\n/**\n * Match a request URL against known CopilotKit route patterns.\n *\n * @param pathname - The URL pathname to match\n * @param basePath - Optional base path prefix to strip first\n * @returns RouteInfo if matched, null otherwise\n */\nexport function matchRoute(\n  pathname: string,\n  basePath?: string,\n): RouteInfo | null {\n  let remainder: string;\n\n  if (basePath) {\n    // Normalize: ensure basePath doesn't end with /\n    const normalizedBase =\n      basePath.length > 1 && basePath.endsWith(\"/\")\n        ? basePath.slice(0, -1)\n        : basePath;\n\n    // Special case: basePath === \"/\" matches everything\n    if (normalizedBase === \"/\") {\n      remainder = pathname;\n    } else {\n      if (!pathname.startsWith(normalizedBase)) return null;\n\n      // The character after basePath must be \"/\" or end of string\n      const afterBase = pathname.slice(normalizedBase.length);\n      if (afterBase.length > 0 && !afterBase.startsWith(\"/\")) return null;\n\n      remainder = afterBase || \"/\";\n    }\n  } else {\n    // Suffix matching: find known patterns at the end of the pathname\n    remainder = pathname;\n  }\n\n  return matchSegments(remainder);\n}\n\nfunction safeDecodeURIComponent(value: string): string | null {\n  try {\n    return decodeURIComponent(value);\n  } catch {\n    return null;\n  }\n}\n\nfunction matchSegments(path: string): RouteInfo | null {\n  const segments = path.split(\"/\").filter(Boolean);\n  const len = segments.length;\n\n  // Try suffix matching — scan from the end for known patterns\n\n  // /info (1 segment)\n  if (len >= 1 && segments[len - 1] === \"info\") {\n    return { method: \"info\" };\n  }\n\n  // /transcribe (1 segment)\n  if (len >= 1 && segments[len - 1] === \"transcribe\") {\n    return { method: \"transcribe\" };\n  }\n\n  // /agent/:agentId/run (3 segments)\n  if (\n    len >= 3 &&\n    segments[len - 3] === \"agent\" &&\n    segments[len - 1] === \"run\"\n  ) {\n    const agentId = safeDecodeURIComponent(segments[len - 2]!);\n    if (!agentId) return null;\n    return { method: \"agent/run\", agentId };\n  }\n\n  // /agent/:agentId/connect (3 segments)\n  if (\n    len >= 3 &&\n    segments[len - 3] === \"agent\" &&\n    segments[len - 1] === \"connect\"\n  ) {\n    const agentId = safeDecodeURIComponent(segments[len - 2]!);\n    if (!agentId) return null;\n    return { method: \"agent/connect\", agentId };\n  }\n\n  // /agent/:agentId/stop/:threadId (4 segments)\n  if (\n    len >= 4 &&\n    segments[len - 4] === \"agent\" &&\n    segments[len - 2] === \"stop\"\n  ) {\n    const agentId = safeDecodeURIComponent(segments[len - 3]!);\n    const threadId = safeDecodeURIComponent(segments[len - 1]!);\n    if (!agentId || !threadId) return null;\n    return { method: \"agent/stop\", agentId, threadId };\n  }\n\n  return null;\n}\n"],"mappings":";;;;;;;;;;AAmBA,SAAgB,WACd,UACA,UACkB;CAClB,IAAI;AAEJ,KAAI,UAAU;EAEZ,MAAM,iBACJ,SAAS,SAAS,KAAK,SAAS,SAAS,IAAI,GACzC,SAAS,MAAM,GAAG,GAAG,GACrB;AAGN,MAAI,mBAAmB,IACrB,aAAY;OACP;AACL,OAAI,CAAC,SAAS,WAAW,eAAe,CAAE,QAAO;GAGjD,MAAM,YAAY,SAAS,MAAM,eAAe,OAAO;AACvD,OAAI,UAAU,SAAS,KAAK,CAAC,UAAU,WAAW,IAAI,CAAE,QAAO;AAE/D,eAAY,aAAa;;OAI3B,aAAY;AAGd,QAAO,cAAc,UAAU;;AAGjC,SAAS,uBAAuB,OAA8B;AAC5D,KAAI;AACF,SAAO,mBAAmB,MAAM;SAC1B;AACN,SAAO;;;AAIX,SAAS,cAAc,MAAgC;CACrD,MAAM,WAAW,KAAK,MAAM,IAAI,CAAC,OAAO,QAAQ;CAChD,MAAM,MAAM,SAAS;AAKrB,KAAI,OAAO,KAAK,SAAS,MAAM,OAAO,OACpC,QAAO,EAAE,QAAQ,QAAQ;AAI3B,KAAI,OAAO,KAAK,SAAS,MAAM,OAAO,aACpC,QAAO,EAAE,QAAQ,cAAc;AAIjC,KACE,OAAO,KACP,SAAS,MAAM,OAAO,WACtB,SAAS,MAAM,OAAO,OACtB;EACA,MAAM,UAAU,uBAAuB,SAAS,MAAM,GAAI;AAC1D,MAAI,CAAC,QAAS,QAAO;AACrB,SAAO;GAAE,QAAQ;GAAa;GAAS;;AAIzC,KACE,OAAO,KACP,SAAS,MAAM,OAAO,WACtB,SAAS,MAAM,OAAO,WACtB;EACA,MAAM,UAAU,uBAAuB,SAAS,MAAM,GAAI;AAC1D,MAAI,CAAC,QAAS,QAAO;AACrB,SAAO;GAAE,QAAQ;GAAiB;GAAS;;AAI7C,KACE,OAAO,KACP,SAAS,MAAM,OAAO,WACtB,SAAS,MAAM,OAAO,QACtB;EACA,MAAM,UAAU,uBAAuB,SAAS,MAAM,GAAI;EAC1D,MAAM,WAAW,uBAAuB,SAAS,MAAM,GAAI;AAC3D,MAAI,CAAC,WAAW,CAAC,SAAU,QAAO;AAClC,SAAO;GAAE,QAAQ;GAAc;GAAS;GAAU;;AAGpD,QAAO"}

package/dist/v2/runtime/core/fetch-router.mjs

@@ -0,0 +1,67 @@
+import "reflect-metadata";
+//#region src/v2/runtime/core/fetch-router.ts
+/**
+* Match a request URL against known CopilotKit route patterns.
+*
+* @param pathname - The URL pathname to match
+* @param basePath - Optional base path prefix to strip first
+* @returns RouteInfo if matched, null otherwise
+*/
+function matchRoute(pathname, basePath) {
+	let remainder;
+	if (basePath) {
+		const normalizedBase = basePath.length > 1 && basePath.endsWith("/") ? basePath.slice(0, -1) : basePath;
+		if (normalizedBase === "/") remainder = pathname;
+		else {
+			if (!pathname.startsWith(normalizedBase)) return null;
+			const afterBase = pathname.slice(normalizedBase.length);
+			if (afterBase.length > 0 && !afterBase.startsWith("/")) return null;
+			remainder = afterBase || "/";
+		}
+	} else remainder = pathname;
+	return matchSegments(remainder);
+}
+function safeDecodeURIComponent(value) {
+	try {
+		return decodeURIComponent(value);
+	} catch {
+		return null;
+	}
+}
+function matchSegments(path) {
+	const segments = path.split("/").filter(Boolean);
+	const len = segments.length;
+	if (len >= 1 && segments[len - 1] === "info") return { method: "info" };
+	if (len >= 1 && segments[len - 1] === "transcribe") return { method: "transcribe" };
+	if (len >= 3 && segments[len - 3] === "agent" && segments[len - 1] === "run") {
+		const agentId = safeDecodeURIComponent(segments[len - 2]);
+		if (!agentId) return null;
+		return {
+			method: "agent/run",
+			agentId
+		};
+	}
+	if (len >= 3 && segments[len - 3] === "agent" && segments[len - 1] === "connect") {
+		const agentId = safeDecodeURIComponent(segments[len - 2]);
+		if (!agentId) return null;
+		return {
+			method: "agent/connect",
+			agentId
+		};
+	}
+	if (len >= 4 && segments[len - 4] === "agent" && segments[len - 2] === "stop") {
+		const agentId = safeDecodeURIComponent(segments[len - 3]);
+		const threadId = safeDecodeURIComponent(segments[len - 1]);
+		if (!agentId || !threadId) return null;
+		return {
+			method: "agent/stop",
+			agentId,
+			threadId
+		};
+	}
+	return null;
+}
+
+//#endregion
+export { matchRoute };
+//# sourceMappingURL=fetch-router.mjs.map

package/dist/v2/runtime/core/fetch-router.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-router.mjs","names":[],"sources":["../../../../src/v2/runtime/core/fetch-router.ts"],"sourcesContent":["/**\n * Lightweight URL router for framework-agnostic CopilotKit runtime handler.\n *\n * Two strategies:\n * - With `basePath`: strict prefix strip → match remainder\n * - Without `basePath`: suffix matching on known patterns\n *\n * Single-route mode: delegates to `parseMethodCall` for JSON envelope dispatch.\n */\n\nimport type { RouteInfo } from \"./hooks\";\n\n/**\n * Match a request URL against known CopilotKit route patterns.\n *\n * @param pathname - The URL pathname to match\n * @param basePath - Optional base path prefix to strip first\n * @returns RouteInfo if matched, null otherwise\n */\nexport function matchRoute(\n  pathname: string,\n  basePath?: string,\n): RouteInfo | null {\n  let remainder: string;\n\n  if (basePath) {\n    // Normalize: ensure basePath doesn't end with /\n    const normalizedBase =\n      basePath.length > 1 && basePath.endsWith(\"/\")\n        ? basePath.slice(0, -1)\n        : basePath;\n\n    // Special case: basePath === \"/\" matches everything\n    if (normalizedBase === \"/\") {\n      remainder = pathname;\n    } else {\n      if (!pathname.startsWith(normalizedBase)) return null;\n\n      // The character after basePath must be \"/\" or end of string\n      const afterBase = pathname.slice(normalizedBase.length);\n      if (afterBase.length > 0 && !afterBase.startsWith(\"/\")) return null;\n\n      remainder = afterBase || \"/\";\n    }\n  } else {\n    // Suffix matching: find known patterns at the end of the pathname\n    remainder = pathname;\n  }\n\n  return matchSegments(remainder);\n}\n\nfunction safeDecodeURIComponent(value: string): string | null {\n  try {\n    return decodeURIComponent(value);\n  } catch {\n    return null;\n  }\n}\n\nfunction matchSegments(path: string): RouteInfo | null {\n  const segments = path.split(\"/\").filter(Boolean);\n  const len = segments.length;\n\n  // Try suffix matching — scan from the end for known patterns\n\n  // /info (1 segment)\n  if (len >= 1 && segments[len - 1] === \"info\") {\n    return { method: \"info\" };\n  }\n\n  // /transcribe (1 segment)\n  if (len >= 1 && segments[len - 1] === \"transcribe\") {\n    return { method: \"transcribe\" };\n  }\n\n  // /agent/:agentId/run (3 segments)\n  if (\n    len >= 3 &&\n    segments[len - 3] === \"agent\" &&\n    segments[len - 1] === \"run\"\n  ) {\n    const agentId = safeDecodeURIComponent(segments[len - 2]!);\n    if (!agentId) return null;\n    return { method: \"agent/run\", agentId };\n  }\n\n  // /agent/:agentId/connect (3 segments)\n  if (\n    len >= 3 &&\n    segments[len - 3] === \"agent\" &&\n    segments[len - 1] === \"connect\"\n  ) {\n    const agentId = safeDecodeURIComponent(segments[len - 2]!);\n    if (!agentId) return null;\n    return { method: \"agent/connect\", agentId };\n  }\n\n  // /agent/:agentId/stop/:threadId (4 segments)\n  if (\n    len >= 4 &&\n    segments[len - 4] === \"agent\" &&\n    segments[len - 2] === \"stop\"\n  ) {\n    const agentId = safeDecodeURIComponent(segments[len - 3]!);\n    const threadId = safeDecodeURIComponent(segments[len - 1]!);\n    if (!agentId || !threadId) return null;\n    return { method: \"agent/stop\", agentId, threadId };\n  }\n\n  return null;\n}\n"],"mappings":";;;;;;;;;AAmBA,SAAgB,WACd,UACA,UACkB;CAClB,IAAI;AAEJ,KAAI,UAAU;EAEZ,MAAM,iBACJ,SAAS,SAAS,KAAK,SAAS,SAAS,IAAI,GACzC,SAAS,MAAM,GAAG,GAAG,GACrB;AAGN,MAAI,mBAAmB,IACrB,aAAY;OACP;AACL,OAAI,CAAC,SAAS,WAAW,eAAe,CAAE,QAAO;GAGjD,MAAM,YAAY,SAAS,MAAM,eAAe,OAAO;AACvD,OAAI,UAAU,SAAS,KAAK,CAAC,UAAU,WAAW,IAAI,CAAE,QAAO;AAE/D,eAAY,aAAa;;OAI3B,aAAY;AAGd,QAAO,cAAc,UAAU;;AAGjC,SAAS,uBAAuB,OAA8B;AAC5D,KAAI;AACF,SAAO,mBAAmB,MAAM;SAC1B;AACN,SAAO;;;AAIX,SAAS,cAAc,MAAgC;CACrD,MAAM,WAAW,KAAK,MAAM,IAAI,CAAC,OAAO,QAAQ;CAChD,MAAM,MAAM,SAAS;AAKrB,KAAI,OAAO,KAAK,SAAS,MAAM,OAAO,OACpC,QAAO,EAAE,QAAQ,QAAQ;AAI3B,KAAI,OAAO,KAAK,SAAS,MAAM,OAAO,aACpC,QAAO,EAAE,QAAQ,cAAc;AAIjC,KACE,OAAO,KACP,SAAS,MAAM,OAAO,WACtB,SAAS,MAAM,OAAO,OACtB;EACA,MAAM,UAAU,uBAAuB,SAAS,MAAM,GAAI;AAC1D,MAAI,CAAC,QAAS,QAAO;AACrB,SAAO;GAAE,QAAQ;GAAa;GAAS;;AAIzC,KACE,OAAO,KACP,SAAS,MAAM,OAAO,WACtB,SAAS,MAAM,OAAO,WACtB;EACA,MAAM,UAAU,uBAAuB,SAAS,MAAM,GAAI;AAC1D,MAAI,CAAC,QAAS,QAAO;AACrB,SAAO;GAAE,QAAQ;GAAiB;GAAS;;AAI7C,KACE,OAAO,KACP,SAAS,MAAM,OAAO,WACtB,SAAS,MAAM,OAAO,QACtB;EACA,MAAM,UAAU,uBAAuB,SAAS,MAAM,GAAI;EAC1D,MAAM,WAAW,uBAAuB,SAAS,MAAM,GAAI;AAC3D,MAAI,CAAC,WAAW,CAAC,SAAU,QAAO;AAClC,SAAO;GAAE,QAAQ;GAAc;GAAS;GAAU;;AAGpD,QAAO"}

package/dist/v2/runtime/core/hooks.cjs

@@ -0,0 +1,29 @@
+require("reflect-metadata");
+
+//#region src/v2/runtime/core/hooks.ts
+async function runOnRequest(hooks, ctx) {
+	if (!hooks?.onRequest) return ctx.request;
+	const result = await hooks.onRequest(ctx);
+	return result instanceof Request ? result : ctx.request;
+}
+async function runOnBeforeHandler(hooks, ctx) {
+	if (!hooks?.onBeforeHandler) return ctx.request;
+	const result = await hooks.onBeforeHandler(ctx);
+	return result instanceof Request ? result : ctx.request;
+}
+async function runOnResponse(hooks, ctx) {
+	if (!hooks?.onResponse) return ctx.response;
+	const result = await hooks.onResponse(ctx);
+	return result instanceof Response ? result : ctx.response;
+}
+async function runOnError(hooks, ctx) {
+	if (!hooks?.onError) return;
+	return hooks.onError(ctx);
+}
+
+//#endregion
+exports.runOnBeforeHandler = runOnBeforeHandler;
+exports.runOnError = runOnError;
+exports.runOnRequest = runOnRequest;
+exports.runOnResponse = runOnResponse;
+//# sourceMappingURL=hooks.cjs.map

package/dist/v2/runtime/core/hooks.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.cjs","names":[],"sources":["../../../../src/v2/runtime/core/hooks.ts"],"sourcesContent":["/**\n * Lifecycle hooks for CopilotKit runtime request processing.\n *\n * Hooks let you intercept requests at various stages of the pipeline:\n * - `onRequest`: Before routing — auth, correlation IDs, header injection\n * - `onBeforeHandler`: After routing — route-specific authorization\n * - `onResponse`: After handler — add headers, log, set cookies\n * - `onError`: On error — custom error responses\n *\n * @example\n * ```typescript\n * const handler = createCopilotRuntimeHandler({\n *   runtime,\n *   hooks: {\n *     onRequest: async ({ request }) => {\n *       const token = request.headers.get(\"authorization\");\n *       if (!token) throw new Response(\"Unauthorized\", { status: 401 });\n *     },\n *     onResponse: async ({ response }) => {\n *       const headers = new Headers(response.headers);\n *       headers.set(\"x-copilot-version\", \"2.0\");\n *       return new Response(response.body, { ...response, headers });\n *     },\n *   },\n * });\n * ```\n */\n\nimport type { MaybePromise } from \"@copilotkit/shared\";\nimport type { CopilotRuntimeLike } from \"./runtime\";\n\n/* ------------------------------------------------------------------------------------------------\n * Route info\n * --------------------------------------------------------------------------------------------- */\n\nexport type RouteInfo =\n  | { method: \"agent/run\"; agentId: string }\n  | { method: \"agent/connect\"; agentId: string }\n  | { method: \"agent/stop\"; agentId: string; threadId: string }\n  | { method: \"info\" }\n  | { method: \"transcribe\" };\n\n/* ------------------------------------------------------------------------------------------------\n * Hook contexts\n * --------------------------------------------------------------------------------------------- */\n\nexport interface HookContext {\n  /** The incoming Fetch Request (possibly modified by prior hooks). */\n  request: Request;\n  /** The resolved URL pathname. */\n  path: string;\n  /** The CopilotRuntimeLike instance. */\n  runtime: CopilotRuntimeLike;\n}\n\nexport interface HandlerHookContext extends HookContext {\n  /** The resolved route information. */\n  route: RouteInfo;\n}\n\nexport interface ResponseHookContext extends HookContext {\n  /** The Response produced by the handler. */\n  response: Response;\n  /** The resolved route information. */\n  route: RouteInfo;\n}\n\nexport interface ErrorHookContext extends HookContext {\n  /** The error that occurred. */\n  error: unknown;\n  /** The route info, if routing had already succeeded. */\n  route?: RouteInfo;\n}\n\n/* ------------------------------------------------------------------------------------------------\n * Hooks interface\n * --------------------------------------------------------------------------------------------- */\n\nexport interface CopilotRuntimeHooks {\n  /**\n   * Called at the start of every request, before routing.\n   * Use to validate auth, attach headers, initialize correlation IDs, etc.\n   *\n   * Return a modified Request to replace the original, or void to continue.\n   * Throw a Response to short-circuit with an early response.\n   */\n  onRequest?: (ctx: HookContext) => MaybePromise<Request | void>;\n\n  /**\n   * Called after routing is resolved but before the handler executes.\n   * Receives the resolved route info (method, agentId, threadId).\n   *\n   * Use to do route-specific authorization, attach headers for agent calls, etc.\n   * Return a modified Request or void.\n   * Throw a Response to short-circuit.\n   */\n  onBeforeHandler?: (ctx: HandlerHookContext) => MaybePromise<Request | void>;\n\n  /**\n   * Called after the handler produces a Response, before it's sent to the client.\n   * Use to set cookies, add debugging headers, log, etc.\n   *\n   * Return a modified Response to replace the original, or void.\n   */\n  onResponse?: (ctx: ResponseHookContext) => MaybePromise<Response | void>;\n\n  /**\n   * Called when an error occurs during request processing.\n   * Return a Response to override the default error response, or void to use the default.\n   */\n  onError?: (ctx: ErrorHookContext) => MaybePromise<Response | void>;\n}\n\n/* ------------------------------------------------------------------------------------------------\n * Internal hook runners\n * --------------------------------------------------------------------------------------------- */\n\nexport async function runOnRequest(\n  hooks: CopilotRuntimeHooks | undefined,\n  ctx: HookContext,\n): Promise<Request> {\n  if (!hooks?.onRequest) return ctx.request;\n  const result = await hooks.onRequest(ctx);\n  return result instanceof Request ? result : ctx.request;\n}\n\nexport async function runOnBeforeHandler(\n  hooks: CopilotRuntimeHooks | undefined,\n  ctx: HandlerHookContext,\n): Promise<Request> {\n  if (!hooks?.onBeforeHandler) return ctx.request;\n  const result = await hooks.onBeforeHandler(ctx);\n  return result instanceof Request ? result : ctx.request;\n}\n\nexport async function runOnResponse(\n  hooks: CopilotRuntimeHooks | undefined,\n  ctx: ResponseHookContext,\n): Promise<Response> {\n  if (!hooks?.onResponse) return ctx.response;\n  const result = await hooks.onResponse(ctx);\n  return result instanceof Response ? result : ctx.response;\n}\n\nexport async function runOnError(\n  hooks: CopilotRuntimeHooks | undefined,\n  ctx: ErrorHookContext,\n): Promise<Response | void> {\n  if (!hooks?.onError) return;\n  return hooks.onError(ctx);\n}\n"],"mappings":";;;AAqHA,eAAsB,aACpB,OACA,KACkB;AAClB,KAAI,CAAC,OAAO,UAAW,QAAO,IAAI;CAClC,MAAM,SAAS,MAAM,MAAM,UAAU,IAAI;AACzC,QAAO,kBAAkB,UAAU,SAAS,IAAI;;AAGlD,eAAsB,mBACpB,OACA,KACkB;AAClB,KAAI,CAAC,OAAO,gBAAiB,QAAO,IAAI;CACxC,MAAM,SAAS,MAAM,MAAM,gBAAgB,IAAI;AAC/C,QAAO,kBAAkB,UAAU,SAAS,IAAI;;AAGlD,eAAsB,cACpB,OACA,KACmB;AACnB,KAAI,CAAC,OAAO,WAAY,QAAO,IAAI;CACnC,MAAM,SAAS,MAAM,MAAM,WAAW,IAAI;AAC1C,QAAO,kBAAkB,WAAW,SAAS,IAAI;;AAGnD,eAAsB,WACpB,OACA,KAC0B;AAC1B,KAAI,CAAC,OAAO,QAAS;AACrB,QAAO,MAAM,QAAQ,IAAI"}

package/dist/v2/runtime/core/hooks.d.cts

@@ -0,0 +1,78 @@
+
+import { CopilotRuntimeLike } from "./runtime.cjs";
+import { MaybePromise } from "@copilotkit/shared";
+
+//#region src/v2/runtime/core/hooks.d.ts
+type RouteInfo = {
+  method: "agent/run";
+  agentId: string;
+} | {
+  method: "agent/connect";
+  agentId: string;
+} | {
+  method: "agent/stop";
+  agentId: string;
+  threadId: string;
+} | {
+  method: "info";
+} | {
+  method: "transcribe";
+};
+interface HookContext {
+  /** The incoming Fetch Request (possibly modified by prior hooks). */
+  request: Request;
+  /** The resolved URL pathname. */
+  path: string;
+  /** The CopilotRuntimeLike instance. */
+  runtime: CopilotRuntimeLike;
+}
+interface HandlerHookContext extends HookContext {
+  /** The resolved route information. */
+  route: RouteInfo;
+}
+interface ResponseHookContext extends HookContext {
+  /** The Response produced by the handler. */
+  response: Response;
+  /** The resolved route information. */
+  route: RouteInfo;
+}
+interface ErrorHookContext extends HookContext {
+  /** The error that occurred. */
+  error: unknown;
+  /** The route info, if routing had already succeeded. */
+  route?: RouteInfo;
+}
+interface CopilotRuntimeHooks {
+  /**
+   * Called at the start of every request, before routing.
+   * Use to validate auth, attach headers, initialize correlation IDs, etc.
+   *
+   * Return a modified Request to replace the original, or void to continue.
+   * Throw a Response to short-circuit with an early response.
+   */
+  onRequest?: (ctx: HookContext) => MaybePromise<Request | void>;
+  /**
+   * Called after routing is resolved but before the handler executes.
+   * Receives the resolved route info (method, agentId, threadId).
+   *
+   * Use to do route-specific authorization, attach headers for agent calls, etc.
+   * Return a modified Request or void.
+   * Throw a Response to short-circuit.
+   */
+  onBeforeHandler?: (ctx: HandlerHookContext) => MaybePromise<Request | void>;
+  /**
+   * Called after the handler produces a Response, before it's sent to the client.
+   * Use to set cookies, add debugging headers, log, etc.
+   *
+   * Return a modified Response to replace the original, or void.
+   */
+  onResponse?: (ctx: ResponseHookContext) => MaybePromise<Response | void>;
+  /**
+   * Called when an error occurs during request processing.
+   * Return a Response to override the default error response, or void to use the default.
+   */
+  onError?: (ctx: ErrorHookContext) => MaybePromise<Response | void>;
+}
+//#endregion
+export { CopilotRuntimeHooks, ErrorHookContext, HandlerHookContext, HookContext, ResponseHookContext, RouteInfo };
+//# sourceMappingURL=hooks.d.cts.map

package/dist/v2/runtime/core/hooks.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.cts","names":[],"sources":["../../../../src/v2/runtime/core/hooks.ts"],"mappings":";;;;;KAmCY,SAAA;EACN,MAAA;EAAqB,OAAA;AAAA;EACrB,MAAA;EAAyB,OAAA;AAAA;EACzB,MAAA;EAAsB,OAAA;EAAiB,QAAA;AAAA;EACvC,MAAA;AAAA;EACA,MAAA;AAAA;AAAA,UAMW,WAAA;EAcuC;EAZtD,OAAA,EAAS,OAAA;EAYkC;EAV3C,IAAA;EAYU;EAVV,OAAA,EAAS,kBAAA;AAAA;AAAA,UAGM,kBAAA,SAA2B,WAAA;EAS1B;EAPhB,KAAA,EAAO,SAAA;AAAA;AAAA,UAGQ,mBAAA,SAA4B,WAAA;EAOQ;EALnD,QAAA,EAAU,QAAA;EAOV;EALA,KAAA,EAAO,SAAA;AAAA;AAAA,UAGQ,gBAAA,SAAyB,WAAA;EAIvB;EAFjB,KAAA;EASkC;EAPlC,KAAA,GAAQ,SAAA;AAAA;AAAA,UAOO,mBAAA;EAQmB;;;;;;;EAAlC,SAAA,IAAa,GAAA,EAAK,WAAA,KAAgB,YAAA,CAAa,OAAA;EAwBG;;;;;;;;EAdlD,eAAA,IAAmB,GAAA,EAAK,kBAAA,KAAuB,YAAA,CAAa,OAAA;EAA5D;;;;;;EAQA,UAAA,IAAc,GAAA,EAAK,mBAAA,KAAwB,YAAA,CAAa,QAAA;EAA1C;;;;EAMd,OAAA,IAAW,GAAA,EAAK,gBAAA,KAAqB,YAAA,CAAa,QAAA;AAAA"}

package/dist/v2/runtime/core/hooks.d.mts

@@ -0,0 +1,78 @@
+import "reflect-metadata";
+import { CopilotRuntimeLike } from "./runtime.mjs";
+import { MaybePromise } from "@copilotkit/shared";
+
+//#region src/v2/runtime/core/hooks.d.ts
+type RouteInfo = {
+  method: "agent/run";
+  agentId: string;
+} | {
+  method: "agent/connect";
+  agentId: string;
+} | {
+  method: "agent/stop";
+  agentId: string;
+  threadId: string;
+} | {
+  method: "info";
+} | {
+  method: "transcribe";
+};
+interface HookContext {
+  /** The incoming Fetch Request (possibly modified by prior hooks). */
+  request: Request;
+  /** The resolved URL pathname. */
+  path: string;
+  /** The CopilotRuntimeLike instance. */
+  runtime: CopilotRuntimeLike;
+}
+interface HandlerHookContext extends HookContext {
+  /** The resolved route information. */
+  route: RouteInfo;
+}
+interface ResponseHookContext extends HookContext {
+  /** The Response produced by the handler. */
+  response: Response;
+  /** The resolved route information. */
+  route: RouteInfo;
+}
+interface ErrorHookContext extends HookContext {
+  /** The error that occurred. */
+  error: unknown;
+  /** The route info, if routing had already succeeded. */
+  route?: RouteInfo;
+}
+interface CopilotRuntimeHooks {
+  /**
+   * Called at the start of every request, before routing.
+   * Use to validate auth, attach headers, initialize correlation IDs, etc.
+   *
+   * Return a modified Request to replace the original, or void to continue.
+   * Throw a Response to short-circuit with an early response.
+   */
+  onRequest?: (ctx: HookContext) => MaybePromise<Request | void>;
+  /**
+   * Called after routing is resolved but before the handler executes.
+   * Receives the resolved route info (method, agentId, threadId).
+   *
+   * Use to do route-specific authorization, attach headers for agent calls, etc.
+   * Return a modified Request or void.
+   * Throw a Response to short-circuit.
+   */
+  onBeforeHandler?: (ctx: HandlerHookContext) => MaybePromise<Request | void>;
+  /**
+   * Called after the handler produces a Response, before it's sent to the client.
+   * Use to set cookies, add debugging headers, log, etc.
+   *
+   * Return a modified Response to replace the original, or void.
+   */
+  onResponse?: (ctx: ResponseHookContext) => MaybePromise<Response | void>;
+  /**
+   * Called when an error occurs during request processing.
+   * Return a Response to override the default error response, or void to use the default.
+   */
+  onError?: (ctx: ErrorHookContext) => MaybePromise<Response | void>;
+}
+//#endregion
+export { CopilotRuntimeHooks, ErrorHookContext, HandlerHookContext, HookContext, ResponseHookContext, RouteInfo };
+//# sourceMappingURL=hooks.d.mts.map

package/dist/v2/runtime/core/hooks.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.mts","names":[],"sources":["../../../../src/v2/runtime/core/hooks.ts"],"mappings":";;;;;KAmCY,SAAA;EACN,MAAA;EAAqB,OAAA;AAAA;EACrB,MAAA;EAAyB,OAAA;AAAA;EACzB,MAAA;EAAsB,OAAA;EAAiB,QAAA;AAAA;EACvC,MAAA;AAAA;EACA,MAAA;AAAA;AAAA,UAMW,WAAA;EAcuC;EAZtD,OAAA,EAAS,OAAA;EAYkC;EAV3C,IAAA;EAYU;EAVV,OAAA,EAAS,kBAAA;AAAA;AAAA,UAGM,kBAAA,SAA2B,WAAA;EAS1B;EAPhB,KAAA,EAAO,SAAA;AAAA;AAAA,UAGQ,mBAAA,SAA4B,WAAA;EAOQ;EALnD,QAAA,EAAU,QAAA;EAOV;EALA,KAAA,EAAO,SAAA;AAAA;AAAA,UAGQ,gBAAA,SAAyB,WAAA;EAIvB;EAFjB,KAAA;EASkC;EAPlC,KAAA,GAAQ,SAAA;AAAA;AAAA,UAOO,mBAAA;EAQmB;;;;;;;EAAlC,SAAA,IAAa,GAAA,EAAK,WAAA,KAAgB,YAAA,CAAa,OAAA;EAwBG;;;;;;;;EAdlD,eAAA,IAAmB,GAAA,EAAK,kBAAA,KAAuB,YAAA,CAAa,OAAA;EAA5D;;;;;;EAQA,UAAA,IAAc,GAAA,EAAK,mBAAA,KAAwB,YAAA,CAAa,QAAA;EAA1C;;;;EAMd,OAAA,IAAW,GAAA,EAAK,gBAAA,KAAqB,YAAA,CAAa,QAAA;AAAA"}

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

@@ -0,0 +1,25 @@
+import "reflect-metadata";
+//#region src/v2/runtime/core/hooks.ts
+async function runOnRequest(hooks, ctx) {
+	if (!hooks?.onRequest) return ctx.request;
+	const result = await hooks.onRequest(ctx);
+	return result instanceof Request ? result : ctx.request;
+}
+async function runOnBeforeHandler(hooks, ctx) {
+	if (!hooks?.onBeforeHandler) return ctx.request;
+	const result = await hooks.onBeforeHandler(ctx);
+	return result instanceof Request ? result : ctx.request;
+}
+async function runOnResponse(hooks, ctx) {
+	if (!hooks?.onResponse) return ctx.response;
+	const result = await hooks.onResponse(ctx);
+	return result instanceof Response ? result : ctx.response;
+}
+async function runOnError(hooks, ctx) {
+	if (!hooks?.onError) return;
+	return hooks.onError(ctx);
+}
+
+//#endregion
+export { runOnBeforeHandler, runOnError, runOnRequest, runOnResponse };
+//# sourceMappingURL=hooks.mjs.map