@copilotkit/runtime 2.0.0-next.1 → 2.0.0-rc.1

package/dist/runtime/handlers/handle-stop.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"handle-stop.cjs","names":["isHandlerResponse","isIntelligenceRuntime","resolveLocalThreadOwner","resolveIntelligenceUser","getPlatformErrorStatus","resolveAgents","EventType"],"sources":["../../../src/runtime/handlers/handle-stop.ts"],"sourcesContent":["import type { CopilotRuntimeLike } from \"../core/runtime\";\nimport { isIntelligenceRuntime, resolveAgents } from \"../core/runtime\";\nimport { EventType } from \"@ag-ui/client\";\nimport { resolveIntelligenceUser } from \"./shared/resolve-intelligence-user\";\nimport { isHandlerResponse } from \"./shared/json-response\";\nimport { getPlatformErrorStatus } from \"./shared/intelligence-utils\";\nimport { resolveLocalThreadOwner } from \"./shared/thread-access\";\n\ninterface StopAgentParameters {\n  request: Request;\n  runtime: CopilotRuntimeLike;\n  agentId: string;\n  threadId: string;\n}\n\n/** Read `{ runId? }` from a stop request body; a 400 Response when the body is not a valid scope. */\nasync function parseStopScope(\n  request: Request,\n): Promise<{ runId?: string } | Response> {\n  try {\n    const raw = await request.text();\n    const body: unknown = raw.trim() ? JSON.parse(raw) : {};\n    if (typeof body !== \"object\" || body === null || Array.isArray(body)) {\n      return Response.json({ error: \"Invalid stop request\" }, { status: 400 });\n    }\n    // Only `runId` is allowed. A misspelt key must not fall through to a\n    // thread-wide stop, because a stop cannot be undone.\n    if (Object.keys(body).some((key) => key !== \"runId\")) {\n      return Response.json({ error: \"Invalid stop request\" }, { status: 400 });\n    }\n    if (!(\"runId\" in body)) return {};\n    if (typeof body.runId !== \"string\" || !body.runId.trim()) {\n      return Response.json({ error: \"Invalid runId\" }, { status: 400 });\n    }\n    return { runId: body.runId };\n  } catch {\n    return Response.json({ error: \"Invalid stop request\" }, { status: 400 });\n  }\n}\n\n/** Stop an active run after applying the runtime's application identity policy. */\nexport async function handleStopAgent({\n  runtime,\n  request,\n  agentId,\n  threadId,\n}: StopAgentParameters): Promise<Response> {\n  try {\n    // Parse the optional run scope for every runtime kind, from a clone so an\n    // identity callback can still read the original body. No body or `{}`\n    // keeps the thread-wide stop existing clients rely on.\n    const scope = await parseStopScope(request.clone());\n    if (isHandlerResponse(scope)) return scope;\n    const { runId } = scope;\n    let stopThreadId = threadId;\n    let ownerId: string | undefined;\n    if (!isIntelligenceRuntime(runtime)) {\n      // A run on another identity's thread reports \"no active run\".\n      const owner = await resolveLocalThreadOwner({\n        runtime,\n        request,\n        operation: \"stop\",\n      });\n      if (isHandlerResponse(owner)) return owner;\n      ownerId = owner;\n    } else {\n      const user = await resolveIntelligenceUser({ runtime, request });\n      if (isHandlerResponse(user)) return user;\n      try {\n        const thread = await runtime.intelligence.getThread({\n          threadId,\n          userId: user.id,\n        });\n        if (!thread || typeof thread.id !== \"string\" || !thread.id.trim()) {\n          return Response.json(\n            { error: \"Invalid thread response\" },\n            { status: 502 },\n          );\n        }\n        if (thread.agentId !== undefined && thread.agentId !== agentId) {\n          return Response.json(\n            { error: \"Thread access denied\" },\n            { status: 403 },\n          );\n        }\n        stopThreadId = thread.id;\n      } catch (error) {\n        const status = getPlatformErrorStatus(error);\n        return Response.json(\n          { error: \"Thread access denied\" },\n          { status: status && status >= 400 && status < 500 ? status : 502 },\n        );\n      }\n    }\n    const agents = await resolveAgents(runtime.agents, request);\n\n    if (!agents[agentId]) {\n      return new Response(\n        JSON.stringify({\n          error: \"Agent not found\",\n          message: `Agent '${agentId}' does not exist`,\n        }),\n        {\n          status: 404,\n          headers: { \"Content-Type\": \"application/json\" },\n        },\n      );\n    }\n\n    const stopped = await runtime.runner.stop({\n      threadId: stopThreadId,\n      ...(runId === undefined ? {} : { runId }),\n      ...(ownerId === undefined ? {} : { ownerId }),\n    });\n\n    if (!stopped) {\n      return new Response(\n        JSON.stringify({\n          stopped: false,\n          message:\n            runId === undefined\n              ? `No active run for thread '${threadId}'.`\n              : `Run '${runId}' is not the active run for thread '${threadId}'.`,\n        }),\n        {\n          status: 200,\n          headers: { \"Content-Type\": \"application/json\" },\n        },\n      );\n    }\n\n    return new Response(\n      JSON.stringify({\n        stopped: true,\n        interrupt: {\n          type: EventType.RUN_ERROR,\n          message: \"Run stopped by user\",\n          code: \"STOPPED\",\n        },\n      }),\n      {\n        status: 200,\n        headers: { \"Content-Type\": \"application/json\" },\n      },\n    );\n  } catch (error) {\n    console.error(\"Error stopping agent run:\", error);\n\n    return new Response(\n      JSON.stringify({\n        error: \"Failed to stop agent\",\n        message: error instanceof Error ? error.message : \"Unknown error\",\n      }),\n      {\n        status: 500,\n        headers: { \"Content-Type\": \"application/json\" },\n      },\n    );\n  }\n}\n"],"mappings":"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"}

package/dist/runtime/handlers/handle-stop.mjs

@@ -0,0 +1,101 @@
+import { isHandlerResponse } from "./shared/json-response.mjs";
+import { getPlatformErrorStatus } from "./shared/intelligence-utils.mjs";
+import { resolveIntelligenceUser } from "./shared/resolve-intelligence-user.mjs";
+import { resolveLocalThreadOwner } from "./shared/thread-access.mjs";
+import { isIntelligenceRuntime, resolveAgents } from "../core/runtime.mjs";
+import { EventType } from "@ag-ui/client";
+
+//#region src/runtime/handlers/handle-stop.ts
+/** Read `{ runId? }` from a stop request body; a 400 Response when the body is not a valid scope. */
+async function parseStopScope(request) {
+	try {
+		const raw = await request.text();
+		const body = raw.trim() ? JSON.parse(raw) : {};
+		if (typeof body !== "object" || body === null || Array.isArray(body)) return Response.json({ error: "Invalid stop request" }, { status: 400 });
+		if (Object.keys(body).some((key) => key !== "runId")) return Response.json({ error: "Invalid stop request" }, { status: 400 });
+		if (!("runId" in body)) return {};
+		if (typeof body.runId !== "string" || !body.runId.trim()) return Response.json({ error: "Invalid runId" }, { status: 400 });
+		return { runId: body.runId };
+	} catch {
+		return Response.json({ error: "Invalid stop request" }, { status: 400 });
+	}
+}
+/** Stop an active run after applying the runtime's application identity policy. */
+async function handleStopAgent({ runtime, request, agentId, threadId }) {
+	try {
+		const scope = await parseStopScope(request.clone());
+		if (isHandlerResponse(scope)) return scope;
+		const { runId } = scope;
+		let stopThreadId = threadId;
+		let ownerId;
+		if (!isIntelligenceRuntime(runtime)) {
+			const owner = await resolveLocalThreadOwner({
+				runtime,
+				request,
+				operation: "stop"
+			});
+			if (isHandlerResponse(owner)) return owner;
+			ownerId = owner;
+		} else {
+			const user = await resolveIntelligenceUser({
+				runtime,
+				request
+			});
+			if (isHandlerResponse(user)) return user;
+			try {
+				const thread = await runtime.intelligence.getThread({
+					threadId,
+					userId: user.id
+				});
+				if (!thread || typeof thread.id !== "string" || !thread.id.trim()) return Response.json({ error: "Invalid thread response" }, { status: 502 });
+				if (thread.agentId !== void 0 && thread.agentId !== agentId) return Response.json({ error: "Thread access denied" }, { status: 403 });
+				stopThreadId = thread.id;
+			} catch (error) {
+				const status = getPlatformErrorStatus(error);
+				return Response.json({ error: "Thread access denied" }, { status: status && status >= 400 && status < 500 ? status : 502 });
+			}
+		}
+		if (!(await resolveAgents(runtime.agents, request))[agentId]) return new Response(JSON.stringify({
+			error: "Agent not found",
+			message: `Agent '${agentId}' does not exist`
+		}), {
+			status: 404,
+			headers: { "Content-Type": "application/json" }
+		});
+		if (!await runtime.runner.stop({
+			threadId: stopThreadId,
+			...runId === void 0 ? {} : { runId },
+			...ownerId === void 0 ? {} : { ownerId }
+		})) return new Response(JSON.stringify({
+			stopped: false,
+			message: runId === void 0 ? `No active run for thread '${threadId}'.` : `Run '${runId}' is not the active run for thread '${threadId}'.`
+		}), {
+			status: 200,
+			headers: { "Content-Type": "application/json" }
+		});
+		return new Response(JSON.stringify({
+			stopped: true,
+			interrupt: {
+				type: EventType.RUN_ERROR,
+				message: "Run stopped by user",
+				code: "STOPPED"
+			}
+		}), {
+			status: 200,
+			headers: { "Content-Type": "application/json" }
+		});
+	} catch (error) {
+		console.error("Error stopping agent run:", error);
+		return new Response(JSON.stringify({
+			error: "Failed to stop agent",
+			message: error instanceof Error ? error.message : "Unknown error"
+		}), {
+			status: 500,
+			headers: { "Content-Type": "application/json" }
+		});
+	}
+}
+
+//#endregion
+export { handleStopAgent };
+//# sourceMappingURL=handle-stop.mjs.map

package/dist/runtime/handlers/handle-stop.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"handle-stop.mjs","names":[],"sources":["../../../src/runtime/handlers/handle-stop.ts"],"sourcesContent":["import type { CopilotRuntimeLike } from \"../core/runtime\";\nimport { isIntelligenceRuntime, resolveAgents } from \"../core/runtime\";\nimport { EventType } from \"@ag-ui/client\";\nimport { resolveIntelligenceUser } from \"./shared/resolve-intelligence-user\";\nimport { isHandlerResponse } from \"./shared/json-response\";\nimport { getPlatformErrorStatus } from \"./shared/intelligence-utils\";\nimport { resolveLocalThreadOwner } from \"./shared/thread-access\";\n\ninterface StopAgentParameters {\n  request: Request;\n  runtime: CopilotRuntimeLike;\n  agentId: string;\n  threadId: string;\n}\n\n/** Read `{ runId? }` from a stop request body; a 400 Response when the body is not a valid scope. */\nasync function parseStopScope(\n  request: Request,\n): Promise<{ runId?: string } | Response> {\n  try {\n    const raw = await request.text();\n    const body: unknown = raw.trim() ? JSON.parse(raw) : {};\n    if (typeof body !== \"object\" || body === null || Array.isArray(body)) {\n      return Response.json({ error: \"Invalid stop request\" }, { status: 400 });\n    }\n    // Only `runId` is allowed. A misspelt key must not fall through to a\n    // thread-wide stop, because a stop cannot be undone.\n    if (Object.keys(body).some((key) => key !== \"runId\")) {\n      return Response.json({ error: \"Invalid stop request\" }, { status: 400 });\n    }\n    if (!(\"runId\" in body)) return {};\n    if (typeof body.runId !== \"string\" || !body.runId.trim()) {\n      return Response.json({ error: \"Invalid runId\" }, { status: 400 });\n    }\n    return { runId: body.runId };\n  } catch {\n    return Response.json({ error: \"Invalid stop request\" }, { status: 400 });\n  }\n}\n\n/** Stop an active run after applying the runtime's application identity policy. */\nexport async function handleStopAgent({\n  runtime,\n  request,\n  agentId,\n  threadId,\n}: StopAgentParameters): Promise<Response> {\n  try {\n    // Parse the optional run scope for every runtime kind, from a clone so an\n    // identity callback can still read the original body. No body or `{}`\n    // keeps the thread-wide stop existing clients rely on.\n    const scope = await parseStopScope(request.clone());\n    if (isHandlerResponse(scope)) return scope;\n    const { runId } = scope;\n    let stopThreadId = threadId;\n    let ownerId: string | undefined;\n    if (!isIntelligenceRuntime(runtime)) {\n      // A run on another identity's thread reports \"no active run\".\n      const owner = await resolveLocalThreadOwner({\n        runtime,\n        request,\n        operation: \"stop\",\n      });\n      if (isHandlerResponse(owner)) return owner;\n      ownerId = owner;\n    } else {\n      const user = await resolveIntelligenceUser({ runtime, request });\n      if (isHandlerResponse(user)) return user;\n      try {\n        const thread = await runtime.intelligence.getThread({\n          threadId,\n          userId: user.id,\n        });\n        if (!thread || typeof thread.id !== \"string\" || !thread.id.trim()) {\n          return Response.json(\n            { error: \"Invalid thread response\" },\n            { status: 502 },\n          );\n        }\n        if (thread.agentId !== undefined && thread.agentId !== agentId) {\n          return Response.json(\n            { error: \"Thread access denied\" },\n            { status: 403 },\n          );\n        }\n        stopThreadId = thread.id;\n      } catch (error) {\n        const status = getPlatformErrorStatus(error);\n        return Response.json(\n          { error: \"Thread access denied\" },\n          { status: status && status >= 400 && status < 500 ? status : 502 },\n        );\n      }\n    }\n    const agents = await resolveAgents(runtime.agents, request);\n\n    if (!agents[agentId]) {\n      return new Response(\n        JSON.stringify({\n          error: \"Agent not found\",\n          message: `Agent '${agentId}' does not exist`,\n        }),\n        {\n          status: 404,\n          headers: { \"Content-Type\": \"application/json\" },\n        },\n      );\n    }\n\n    const stopped = await runtime.runner.stop({\n      threadId: stopThreadId,\n      ...(runId === undefined ? {} : { runId }),\n      ...(ownerId === undefined ? {} : { ownerId }),\n    });\n\n    if (!stopped) {\n      return new Response(\n        JSON.stringify({\n          stopped: false,\n          message:\n            runId === undefined\n              ? `No active run for thread '${threadId}'.`\n              : `Run '${runId}' is not the active run for thread '${threadId}'.`,\n        }),\n        {\n          status: 200,\n          headers: { \"Content-Type\": \"application/json\" },\n        },\n      );\n    }\n\n    return new Response(\n      JSON.stringify({\n        stopped: true,\n        interrupt: {\n          type: EventType.RUN_ERROR,\n          message: \"Run stopped by user\",\n          code: \"STOPPED\",\n        },\n      }),\n      {\n        status: 200,\n        headers: { \"Content-Type\": \"application/json\" },\n      },\n    );\n  } catch (error) {\n    console.error(\"Error stopping agent run:\", error);\n\n    return new Response(\n      JSON.stringify({\n        error: \"Failed to stop agent\",\n        message: error instanceof Error ? error.message : \"Unknown error\",\n      }),\n      {\n        status: 500,\n        headers: { \"Content-Type\": \"application/json\" },\n      },\n    );\n  }\n}\n"],"mappings":"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"}

package/dist/runtime/handlers/handle-suggest.cjs

@@ -0,0 +1,83 @@
+const require_runtime = require('../../_virtual/_rolldown/runtime.cjs');
+const require_header_utils = require('./header-utils.cjs');
+const require_agent_utils = require('./shared/agent-utils.cjs');
+const require_sse_response = require('./shared/sse-response.cjs');
+let _copilotkit_shared = require("@copilotkit/shared");
+let rxjs = require("rxjs");
+
+//#region src/runtime/handlers/handle-suggest.ts
+/**
+* Stateless suggestion run.
+*
+* Executes the provider agent **directly** and streams its AG-UI events back as
+* SSE — the same wire format as `/agent/:id/run`, so the client consumes it with
+* the stock `HttpAgent` transport and chips fill in as the provider emits them.
+* It deliberately does not go through `runtime.runner`: the runner's
+* `run()` writes to a module-level store keyed by threadId (backing the SSE
+* runtime's local thread endpoints), which would leak the throwaway suggestion
+* thread. This handler runs the agent's event pipeline **without** that
+* persistence — no thread, lock, gateway, name-gen, or run telemetry — so
+* dynamic suggestions are side-effect-free in every runtime mode.
+*
+* The only per-request configuration it applies is forwarding the request's
+* allowlisted headers (`authorization` + `x-*`) onto the agent clone. It does
+* **not** attach any request middleware — no A2UI, no MCPApps, no
+* OpenGenerativeUI, no Intelligence enterprise-learning tools. The **client**
+* (the core suggestion engine) forces `toolChoice: copilotkitSuggest` in the
+* request body; this handler does not set tool choice itself and relies on it
+* being present in the incoming `input`. Given that forced tool choice, any
+* middleware-injected tools are dead weight, and MCPApps setup can incur a
+* `listTools` network round-trip per suggestion under `available: "always"` — a
+* side effect this path must never pay.
+*
+* When the client aborts the HTTP request (via its `AbortController`), the
+* server-side run is cancelled best-effort so an aborted suggestion does not
+* keep running a provider call to completion.
+*
+* @param params - The runtime, request, and resolved agent id.
+* @returns A `text/event-stream` `Response` of the provider agent's AG-UI events
+*   on success, or the resolution `Response` (e.g. 404/400) when agent/body
+*   resolution fails before streaming begins.
+*/
+async function handleSuggestAgent({ runtime, request, agentId }) {
+	const agent = await require_agent_utils.cloneAgentForRequest(runtime, agentId, request);
+	if (agent instanceof Response) return agent;
+	agent.agentId = agentId;
+	const input = await require_agent_utils.parseRunRequest(request);
+	if (input instanceof Response) return input;
+	const headerCarryingAgent = agent;
+	headerCarryingAgent.headers = require_header_utils.mergeForwardableHeaders(headerCarryingAgent.headers, request, runtime.forwardHeadersPolicy ?? require_header_utils.resolveForwardHeadersPolicy(void 0));
+	agent.setMessages(input.messages);
+	agent.setState(input.state);
+	agent.threadId = input.threadId;
+	return require_sse_response.createSseEventResponse({
+		request,
+		agentId,
+		captureTelemetry: false,
+		keepAliveIntervalSeconds: runtime.sseKeepAliveIntervalSeconds,
+		observableFactory: () => new rxjs.Observable((subscriber) => {
+			const finalizer = (0, _copilotkit_shared.createRunEventFinalizer)();
+			let settled = false;
+			agent.runAgent(input, { onEvent: ({ event }) => {
+				finalizer.observe(event);
+				subscriber.next(event);
+			} }).then(() => {
+				for (const event of finalizer.finalize({ stopRequested: false })) subscriber.next(event);
+				settled = true;
+				subscriber.complete();
+			}).catch((error) => {
+				settled = true;
+				subscriber.error(error);
+			});
+			return () => {
+				if (!settled && typeof agent.abortRun === "function") try {
+					agent.abortRun();
+				} catch {}
+			};
+		})
+	});
+}
+
+//#endregion
+exports.handleSuggestAgent = handleSuggestAgent;
+//# sourceMappingURL=handle-suggest.cjs.map

package/dist/runtime/handlers/handle-suggest.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"handle-suggest.cjs","names":["cloneAgentForRequest","parseRunRequest","mergeForwardableHeaders","resolveForwardHeadersPolicy","createSseEventResponse","Observable"],"sources":["../../../src/runtime/handlers/handle-suggest.ts"],"sourcesContent":["import type { AbstractAgent, BaseEvent } from \"@ag-ui/client\";\nimport { createRunEventFinalizer } from \"@copilotkit/shared\";\nimport { Observable } from \"rxjs\";\nimport type { CopilotRuntimeLike } from \"../core/runtime\";\nimport {\n  mergeForwardableHeaders,\n  resolveForwardHeadersPolicy,\n} from \"./header-utils\";\nimport { cloneAgentForRequest, parseRunRequest } from \"./shared/agent-utils\";\nimport { createSseEventResponse } from \"./shared/sse-response\";\n\n/**\n * Parameters for {@link handleSuggestAgent}.\n */\ninterface SuggestAgentParameters {\n  /** The runtime whose registry the agent is resolved from. */\n  runtime: CopilotRuntimeLike;\n  /** The incoming `POST /agent/:agentId/suggest` request. */\n  request: Request;\n  /** The route-resolved agent id to run. */\n  agentId: string;\n}\n\n/**\n * Stateless suggestion run.\n *\n * Executes the provider agent **directly** and streams its AG-UI events back as\n * SSE — the same wire format as `/agent/:id/run`, so the client consumes it with\n * the stock `HttpAgent` transport and chips fill in as the provider emits them.\n * It deliberately does not go through `runtime.runner`: the runner's\n * `run()` writes to a module-level store keyed by threadId (backing the SSE\n * runtime's local thread endpoints), which would leak the throwaway suggestion\n * thread. This handler runs the agent's event pipeline **without** that\n * persistence — no thread, lock, gateway, name-gen, or run telemetry — so\n * dynamic suggestions are side-effect-free in every runtime mode.\n *\n * The only per-request configuration it applies is forwarding the request's\n * allowlisted headers (`authorization` + `x-*`) onto the agent clone. It does\n * **not** attach any request middleware — no A2UI, no MCPApps, no\n * OpenGenerativeUI, no Intelligence enterprise-learning tools. The **client**\n * (the core suggestion engine) forces `toolChoice: copilotkitSuggest` in the\n * request body; this handler does not set tool choice itself and relies on it\n * being present in the incoming `input`. Given that forced tool choice, any\n * middleware-injected tools are dead weight, and MCPApps setup can incur a\n * `listTools` network round-trip per suggestion under `available: \"always\"` — a\n * side effect this path must never pay.\n *\n * When the client aborts the HTTP request (via its `AbortController`), the\n * server-side run is cancelled best-effort so an aborted suggestion does not\n * keep running a provider call to completion.\n *\n * @param params - The runtime, request, and resolved agent id.\n * @returns A `text/event-stream` `Response` of the provider agent's AG-UI events\n *   on success, or the resolution `Response` (e.g. 404/400) when agent/body\n *   resolution fails before streaming begins.\n */\nexport async function handleSuggestAgent({\n  runtime,\n  request,\n  agentId,\n}: SuggestAgentParameters): Promise<Response> {\n  const agent = await cloneAgentForRequest(runtime, agentId, request);\n  if (agent instanceof Response) {\n    return agent;\n  }\n\n  // Carry the registry key onto the clone so any framework relying on it during\n  // the run sees the correct agentId.\n  agent.agentId = agentId;\n\n  const input = await parseRunRequest(request);\n  if (input instanceof Response) {\n    return input;\n  }\n\n  // Forward eligible inbound headers onto the clone under the runtime's resolved\n  // forwarding policy (same helper the run handler uses: `authorization` /\n  // custom `x-*`, infra/proxy/platform headers denylisted, server-set headers\n  // winning on collision — #5712). Unlike a full agent run, the suggest path\n  // intentionally attaches no middleware (see the handler docblock): the forced\n  // `copilotkitSuggest` tool choice makes any middleware-injected tools dead\n  // weight, and MCPApps setup can trigger a `listTools` network round-trip we\n  // must never incur per suggestion.\n  //\n  // `AbstractAgent` doesn't declare `headers` on its base type (concrete\n  // framework agents add it), so narrow to the header-carrying shape rather\n  // than casting to `any`.\n  const headerCarryingAgent = agent as AbstractAgent & {\n    headers?: Record<string, string>;\n  };\n  headerCarryingAgent.headers = mergeForwardableHeaders(\n    headerCarryingAgent.headers,\n    request,\n    runtime.forwardHeadersPolicy ?? resolveForwardHeadersPolicy(undefined),\n  );\n\n  agent.setMessages(input.messages);\n  agent.setState(input.state);\n  agent.threadId = input.threadId;\n\n  // Stream the provider agent's events over SSE without persistence. This is\n  // the runner's event pipeline (`agent.runAgent({ onEvent })` + terminal-event\n  // finalization) minus the `GLOBAL_STORE` writes that would leak a thread.\n  // `captureTelemetry: false` keeps suggestions out of run telemetry; omitting\n  // `debugEventBus` keeps them out of the inspector's run trace.\n  return createSseEventResponse({\n    request,\n    agentId,\n    captureTelemetry: false,\n    keepAliveIntervalSeconds: runtime.sseKeepAliveIntervalSeconds,\n    observableFactory: () =>\n      new Observable<BaseEvent>((subscriber) => {\n        // Tracks open message/tool lifecycles so the missing terminal events\n        // (an unclosed message/tool call, or a `RUN_FINISHED`) can be appended\n        // — the same closure the runner applies — so the client sees a\n        // well-formed AG-UI sequence. Nothing is persisted here, so only the\n        // open ids are kept, never the streamed events themselves.\n        const finalizer = createRunEventFinalizer();\n        let settled = false;\n\n        void agent\n          .runAgent(input, {\n            onEvent: ({ event }) => {\n              finalizer.observe(event);\n              subscriber.next(event);\n            },\n          })\n          .then(() => {\n            for (const event of finalizer.finalize({ stopRequested: false })) {\n              subscriber.next(event);\n            }\n            settled = true;\n            subscriber.complete();\n          })\n          .catch((error: unknown) => {\n            settled = true;\n            subscriber.error(error);\n          });\n\n        // Teardown fires when the response stream is torn down (client abort /\n        // disconnect). Cancel the still-running provider call best-effort.\n        return () => {\n          if (!settled && typeof agent.abortRun === \"function\") {\n            try {\n              agent.abortRun();\n            } catch {\n              // best-effort — nothing actionable if aborting the run fails.\n            }\n          }\n        };\n      }),\n  });\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAwDA,eAAsB,mBAAmB,EACvC,SACA,SACA,WAC4C;CAC5C,MAAM,QAAQ,MAAMA,yCAAqB,SAAS,SAAS,QAAQ;AACnE,KAAI,iBAAiB,SACnB,QAAO;AAKT,OAAM,UAAU;CAEhB,MAAM,QAAQ,MAAMC,oCAAgB,QAAQ;AAC5C,KAAI,iBAAiB,SACnB,QAAO;CAeT,MAAM,sBAAsB;AAG5B,qBAAoB,UAAUC,6CAC5B,oBAAoB,SACpB,SACA,QAAQ,wBAAwBC,iDAA4B,OAAU,CACvE;AAED,OAAM,YAAY,MAAM,SAAS;AACjC,OAAM,SAAS,MAAM,MAAM;AAC3B,OAAM,WAAW,MAAM;AAOvB,QAAOC,4CAAuB;EAC5B;EACA;EACA,kBAAkB;EAClB,0BAA0B,QAAQ;EAClC,yBACE,IAAIC,iBAAuB,eAAe;GAMxC,MAAM,6DAAqC;GAC3C,IAAI,UAAU;AAEd,GAAK,MACF,SAAS,OAAO,EACf,UAAU,EAAE,YAAY;AACtB,cAAU,QAAQ,MAAM;AACxB,eAAW,KAAK,MAAM;MAEzB,CAAC,CACD,WAAW;AACV,SAAK,MAAM,SAAS,UAAU,SAAS,EAAE,eAAe,OAAO,CAAC,CAC9D,YAAW,KAAK,MAAM;AAExB,cAAU;AACV,eAAW,UAAU;KACrB,CACD,OAAO,UAAmB;AACzB,cAAU;AACV,eAAW,MAAM,MAAM;KACvB;AAIJ,gBAAa;AACX,QAAI,CAAC,WAAW,OAAO,MAAM,aAAa,WACxC,KAAI;AACF,WAAM,UAAU;YACV;;IAKZ;EACL,CAAC"}

package/dist/runtime/handlers/handle-suggest.mjs

@@ -0,0 +1,82 @@
+import { mergeForwardableHeaders, resolveForwardHeadersPolicy } from "./header-utils.mjs";
+import { cloneAgentForRequest, parseRunRequest } from "./shared/agent-utils.mjs";
+import { createSseEventResponse } from "./shared/sse-response.mjs";
+import { createRunEventFinalizer } from "@copilotkit/shared";
+import { Observable } from "rxjs";
+
+//#region src/runtime/handlers/handle-suggest.ts
+/**
+* Stateless suggestion run.
+*
+* Executes the provider agent **directly** and streams its AG-UI events back as
+* SSE — the same wire format as `/agent/:id/run`, so the client consumes it with
+* the stock `HttpAgent` transport and chips fill in as the provider emits them.
+* It deliberately does not go through `runtime.runner`: the runner's
+* `run()` writes to a module-level store keyed by threadId (backing the SSE
+* runtime's local thread endpoints), which would leak the throwaway suggestion
+* thread. This handler runs the agent's event pipeline **without** that
+* persistence — no thread, lock, gateway, name-gen, or run telemetry — so
+* dynamic suggestions are side-effect-free in every runtime mode.
+*
+* The only per-request configuration it applies is forwarding the request's
+* allowlisted headers (`authorization` + `x-*`) onto the agent clone. It does
+* **not** attach any request middleware — no A2UI, no MCPApps, no
+* OpenGenerativeUI, no Intelligence enterprise-learning tools. The **client**
+* (the core suggestion engine) forces `toolChoice: copilotkitSuggest` in the
+* request body; this handler does not set tool choice itself and relies on it
+* being present in the incoming `input`. Given that forced tool choice, any
+* middleware-injected tools are dead weight, and MCPApps setup can incur a
+* `listTools` network round-trip per suggestion under `available: "always"` — a
+* side effect this path must never pay.
+*
+* When the client aborts the HTTP request (via its `AbortController`), the
+* server-side run is cancelled best-effort so an aborted suggestion does not
+* keep running a provider call to completion.
+*
+* @param params - The runtime, request, and resolved agent id.
+* @returns A `text/event-stream` `Response` of the provider agent's AG-UI events
+*   on success, or the resolution `Response` (e.g. 404/400) when agent/body
+*   resolution fails before streaming begins.
+*/
+async function handleSuggestAgent({ runtime, request, agentId }) {
+	const agent = await cloneAgentForRequest(runtime, agentId, request);
+	if (agent instanceof Response) return agent;
+	agent.agentId = agentId;
+	const input = await parseRunRequest(request);
+	if (input instanceof Response) return input;
+	const headerCarryingAgent = agent;
+	headerCarryingAgent.headers = mergeForwardableHeaders(headerCarryingAgent.headers, request, runtime.forwardHeadersPolicy ?? resolveForwardHeadersPolicy(void 0));
+	agent.setMessages(input.messages);
+	agent.setState(input.state);
+	agent.threadId = input.threadId;
+	return createSseEventResponse({
+		request,
+		agentId,
+		captureTelemetry: false,
+		keepAliveIntervalSeconds: runtime.sseKeepAliveIntervalSeconds,
+		observableFactory: () => new Observable((subscriber) => {
+			const finalizer = createRunEventFinalizer();
+			let settled = false;
+			agent.runAgent(input, { onEvent: ({ event }) => {
+				finalizer.observe(event);
+				subscriber.next(event);
+			} }).then(() => {
+				for (const event of finalizer.finalize({ stopRequested: false })) subscriber.next(event);
+				settled = true;
+				subscriber.complete();
+			}).catch((error) => {
+				settled = true;
+				subscriber.error(error);
+			});
+			return () => {
+				if (!settled && typeof agent.abortRun === "function") try {
+					agent.abortRun();
+				} catch {}
+			};
+		})
+	});
+}
+
+//#endregion
+export { handleSuggestAgent };
+//# sourceMappingURL=handle-suggest.mjs.map

package/dist/runtime/handlers/handle-suggest.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"handle-suggest.mjs","names":[],"sources":["../../../src/runtime/handlers/handle-suggest.ts"],"sourcesContent":["import type { AbstractAgent, BaseEvent } from \"@ag-ui/client\";\nimport { createRunEventFinalizer } from \"@copilotkit/shared\";\nimport { Observable } from \"rxjs\";\nimport type { CopilotRuntimeLike } from \"../core/runtime\";\nimport {\n  mergeForwardableHeaders,\n  resolveForwardHeadersPolicy,\n} from \"./header-utils\";\nimport { cloneAgentForRequest, parseRunRequest } from \"./shared/agent-utils\";\nimport { createSseEventResponse } from \"./shared/sse-response\";\n\n/**\n * Parameters for {@link handleSuggestAgent}.\n */\ninterface SuggestAgentParameters {\n  /** The runtime whose registry the agent is resolved from. */\n  runtime: CopilotRuntimeLike;\n  /** The incoming `POST /agent/:agentId/suggest` request. */\n  request: Request;\n  /** The route-resolved agent id to run. */\n  agentId: string;\n}\n\n/**\n * Stateless suggestion run.\n *\n * Executes the provider agent **directly** and streams its AG-UI events back as\n * SSE — the same wire format as `/agent/:id/run`, so the client consumes it with\n * the stock `HttpAgent` transport and chips fill in as the provider emits them.\n * It deliberately does not go through `runtime.runner`: the runner's\n * `run()` writes to a module-level store keyed by threadId (backing the SSE\n * runtime's local thread endpoints), which would leak the throwaway suggestion\n * thread. This handler runs the agent's event pipeline **without** that\n * persistence — no thread, lock, gateway, name-gen, or run telemetry — so\n * dynamic suggestions are side-effect-free in every runtime mode.\n *\n * The only per-request configuration it applies is forwarding the request's\n * allowlisted headers (`authorization` + `x-*`) onto the agent clone. It does\n * **not** attach any request middleware — no A2UI, no MCPApps, no\n * OpenGenerativeUI, no Intelligence enterprise-learning tools. The **client**\n * (the core suggestion engine) forces `toolChoice: copilotkitSuggest` in the\n * request body; this handler does not set tool choice itself and relies on it\n * being present in the incoming `input`. Given that forced tool choice, any\n * middleware-injected tools are dead weight, and MCPApps setup can incur a\n * `listTools` network round-trip per suggestion under `available: \"always\"` — a\n * side effect this path must never pay.\n *\n * When the client aborts the HTTP request (via its `AbortController`), the\n * server-side run is cancelled best-effort so an aborted suggestion does not\n * keep running a provider call to completion.\n *\n * @param params - The runtime, request, and resolved agent id.\n * @returns A `text/event-stream` `Response` of the provider agent's AG-UI events\n *   on success, or the resolution `Response` (e.g. 404/400) when agent/body\n *   resolution fails before streaming begins.\n */\nexport async function handleSuggestAgent({\n  runtime,\n  request,\n  agentId,\n}: SuggestAgentParameters): Promise<Response> {\n  const agent = await cloneAgentForRequest(runtime, agentId, request);\n  if (agent instanceof Response) {\n    return agent;\n  }\n\n  // Carry the registry key onto the clone so any framework relying on it during\n  // the run sees the correct agentId.\n  agent.agentId = agentId;\n\n  const input = await parseRunRequest(request);\n  if (input instanceof Response) {\n    return input;\n  }\n\n  // Forward eligible inbound headers onto the clone under the runtime's resolved\n  // forwarding policy (same helper the run handler uses: `authorization` /\n  // custom `x-*`, infra/proxy/platform headers denylisted, server-set headers\n  // winning on collision — #5712). Unlike a full agent run, the suggest path\n  // intentionally attaches no middleware (see the handler docblock): the forced\n  // `copilotkitSuggest` tool choice makes any middleware-injected tools dead\n  // weight, and MCPApps setup can trigger a `listTools` network round-trip we\n  // must never incur per suggestion.\n  //\n  // `AbstractAgent` doesn't declare `headers` on its base type (concrete\n  // framework agents add it), so narrow to the header-carrying shape rather\n  // than casting to `any`.\n  const headerCarryingAgent = agent as AbstractAgent & {\n    headers?: Record<string, string>;\n  };\n  headerCarryingAgent.headers = mergeForwardableHeaders(\n    headerCarryingAgent.headers,\n    request,\n    runtime.forwardHeadersPolicy ?? resolveForwardHeadersPolicy(undefined),\n  );\n\n  agent.setMessages(input.messages);\n  agent.setState(input.state);\n  agent.threadId = input.threadId;\n\n  // Stream the provider agent's events over SSE without persistence. This is\n  // the runner's event pipeline (`agent.runAgent({ onEvent })` + terminal-event\n  // finalization) minus the `GLOBAL_STORE` writes that would leak a thread.\n  // `captureTelemetry: false` keeps suggestions out of run telemetry; omitting\n  // `debugEventBus` keeps them out of the inspector's run trace.\n  return createSseEventResponse({\n    request,\n    agentId,\n    captureTelemetry: false,\n    keepAliveIntervalSeconds: runtime.sseKeepAliveIntervalSeconds,\n    observableFactory: () =>\n      new Observable<BaseEvent>((subscriber) => {\n        // Tracks open message/tool lifecycles so the missing terminal events\n        // (an unclosed message/tool call, or a `RUN_FINISHED`) can be appended\n        // — the same closure the runner applies — so the client sees a\n        // well-formed AG-UI sequence. Nothing is persisted here, so only the\n        // open ids are kept, never the streamed events themselves.\n        const finalizer = createRunEventFinalizer();\n        let settled = false;\n\n        void agent\n          .runAgent(input, {\n            onEvent: ({ event }) => {\n              finalizer.observe(event);\n              subscriber.next(event);\n            },\n          })\n          .then(() => {\n            for (const event of finalizer.finalize({ stopRequested: false })) {\n              subscriber.next(event);\n            }\n            settled = true;\n            subscriber.complete();\n          })\n          .catch((error: unknown) => {\n            settled = true;\n            subscriber.error(error);\n          });\n\n        // Teardown fires when the response stream is torn down (client abort /\n        // disconnect). Cancel the still-running provider call best-effort.\n        return () => {\n          if (!settled && typeof agent.abortRun === \"function\") {\n            try {\n              agent.abortRun();\n            } catch {\n              // best-effort — nothing actionable if aborting the run fails.\n            }\n          }\n        };\n      }),\n  });\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAwDA,eAAsB,mBAAmB,EACvC,SACA,SACA,WAC4C;CAC5C,MAAM,QAAQ,MAAM,qBAAqB,SAAS,SAAS,QAAQ;AACnE,KAAI,iBAAiB,SACnB,QAAO;AAKT,OAAM,UAAU;CAEhB,MAAM,QAAQ,MAAM,gBAAgB,QAAQ;AAC5C,KAAI,iBAAiB,SACnB,QAAO;CAeT,MAAM,sBAAsB;AAG5B,qBAAoB,UAAU,wBAC5B,oBAAoB,SACpB,SACA,QAAQ,wBAAwB,4BAA4B,OAAU,CACvE;AAED,OAAM,YAAY,MAAM,SAAS;AACjC,OAAM,SAAS,MAAM,MAAM;AAC3B,OAAM,WAAW,MAAM;AAOvB,QAAO,uBAAuB;EAC5B;EACA;EACA,kBAAkB;EAClB,0BAA0B,QAAQ;EAClC,yBACE,IAAI,YAAuB,eAAe;GAMxC,MAAM,YAAY,yBAAyB;GAC3C,IAAI,UAAU;AAEd,GAAK,MACF,SAAS,OAAO,EACf,UAAU,EAAE,YAAY;AACtB,cAAU,QAAQ,MAAM;AACxB,eAAW,KAAK,MAAM;MAEzB,CAAC,CACD,WAAW;AACV,SAAK,MAAM,SAAS,UAAU,SAAS,EAAE,eAAe,OAAO,CAAC,CAC9D,YAAW,KAAK,MAAM;AAExB,cAAU;AACV,eAAW,UAAU;KACrB,CACD,OAAO,UAAmB;AACzB,cAAU;AACV,eAAW,MAAM,MAAM;KACvB;AAIJ,gBAAa;AACX,QAAI,CAAC,WAAW,OAAO,MAAM,aAAa,WACxC,KAAI;AACF,WAAM,UAAU;YACV;;IAKZ;EACL,CAAC"}

package/dist/runtime/handlers/handle-trajectory-connect.cjs

@@ -0,0 +1,40 @@
+const require_trajectories = require('../intelligence-platform/trajectories.cjs');
+const require_resolve_intelligence_user = require('./shared/resolve-intelligence-user.cjs');
+const require_runtime = require('../core/runtime.cjs');
+
+//#region src/runtime/handlers/handle-trajectory-connect.ts
+function trajectoryErrorResponse(code, message, status) {
+	return Response.json({
+		code,
+		message
+	}, {
+		status,
+		headers: { "Cache-Control": "no-store" }
+	});
+}
+async function handleTrajectoryConnect({ runtime, request, trajectoryId }) {
+	if (!require_trajectories.isValidTrajectoryId(trajectoryId)) return trajectoryErrorResponse("INVALID_REQUEST", "A valid trajectoryId is required", 400);
+	if (!require_runtime.isIntelligenceRuntime(runtime)) return trajectoryErrorResponse("INTELLIGENCE_RUNTIME_REQUIRED", "Trajectory capture requires an Intelligence runtime", 503);
+	if (!runtime.identifyUser) return trajectoryErrorResponse("IDENTITY_REQUIRED", "Trajectory capture requires an identified user", 401);
+	const user = await require_resolve_intelligence_user.resolveIntelligenceUser({
+		runtime,
+		request
+	});
+	if (user instanceof Response) return trajectoryErrorResponse("IDENTITY_REQUIRED", "Trajectory capture requires an identified user", 401);
+	try {
+		const grant = await runtime.intelligence.ɵconnectTrajectory({
+			trajectoryId,
+			user,
+			signal: request.signal
+		});
+		return Response.json(grant, { headers: { "Cache-Control": "no-store" } });
+	} catch (error) {
+		if (error instanceof require_trajectories.TrajectoryConnectionError) return trajectoryErrorResponse(error.code, error.message, error.status);
+		return trajectoryErrorResponse("CONNECTION_FAILED", "Could not connect to Intelligence", 502);
+	}
+}
+
+//#endregion
+exports.handleTrajectoryConnect = handleTrajectoryConnect;
+exports.trajectoryErrorResponse = trajectoryErrorResponse;
+//# sourceMappingURL=handle-trajectory-connect.cjs.map

package/dist/runtime/handlers/handle-trajectory-connect.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"handle-trajectory-connect.cjs","names":["isValidTrajectoryId","isIntelligenceRuntime","resolveIntelligenceUser","TrajectoryConnectionError"],"sources":["../../../src/runtime/handlers/handle-trajectory-connect.ts"],"sourcesContent":["import type { CopilotRuntimeLike } from \"../core/runtime\";\nimport { isIntelligenceRuntime } from \"../core/runtime\";\nimport {\n  isValidTrajectoryId,\n  TrajectoryConnectionError,\n} from \"../intelligence-platform/trajectories\";\nimport { resolveIntelligenceUser } from \"./shared/resolve-intelligence-user\";\n\nexport function trajectoryErrorResponse(\n  code: string,\n  message: string,\n  status: number,\n): Response {\n  return Response.json(\n    { code, message },\n    { status, headers: { \"Cache-Control\": \"no-store\" } },\n  );\n}\n\nexport async function handleTrajectoryConnect({\n  runtime,\n  request,\n  trajectoryId,\n}: {\n  runtime: CopilotRuntimeLike;\n  request: Request;\n  trajectoryId: string;\n}): Promise<Response> {\n  if (!isValidTrajectoryId(trajectoryId)) {\n    return trajectoryErrorResponse(\n      \"INVALID_REQUEST\",\n      \"A valid trajectoryId is required\",\n      400,\n    );\n  }\n  if (!isIntelligenceRuntime(runtime)) {\n    return trajectoryErrorResponse(\n      \"INTELLIGENCE_RUNTIME_REQUIRED\",\n      \"Trajectory capture requires an Intelligence runtime\",\n      503,\n    );\n  }\n  if (!runtime.identifyUser) {\n    return trajectoryErrorResponse(\n      \"IDENTITY_REQUIRED\",\n      \"Trajectory capture requires an identified user\",\n      401,\n    );\n  }\n  const user = await resolveIntelligenceUser({ runtime, request });\n  if (user instanceof Response) {\n    return trajectoryErrorResponse(\n      \"IDENTITY_REQUIRED\",\n      \"Trajectory capture requires an identified user\",\n      401,\n    );\n  }\n\n  try {\n    const grant = await runtime.intelligence.ɵconnectTrajectory({\n      trajectoryId,\n      user,\n      signal: request.signal,\n    });\n    return Response.json(grant, {\n      headers: { \"Cache-Control\": \"no-store\" },\n    });\n  } catch (error) {\n    if (error instanceof TrajectoryConnectionError) {\n      return trajectoryErrorResponse(error.code, error.message, error.status);\n    }\n    return trajectoryErrorResponse(\n      \"CONNECTION_FAILED\",\n      \"Could not connect to Intelligence\",\n      502,\n    );\n  }\n}\n"],"mappings":";;;;;AAQA,SAAgB,wBACd,MACA,SACA,QACU;AACV,QAAO,SAAS,KACd;EAAE;EAAM;EAAS,EACjB;EAAE;EAAQ,SAAS,EAAE,iBAAiB,YAAY;EAAE,CACrD;;AAGH,eAAsB,wBAAwB,EAC5C,SACA,SACA,gBAKoB;AACpB,KAAI,CAACA,yCAAoB,aAAa,CACpC,QAAO,wBACL,mBACA,oCACA,IACD;AAEH,KAAI,CAACC,sCAAsB,QAAQ,CACjC,QAAO,wBACL,iCACA,uDACA,IACD;AAEH,KAAI,CAAC,QAAQ,aACX,QAAO,wBACL,qBACA,kDACA,IACD;CAEH,MAAM,OAAO,MAAMC,0DAAwB;EAAE;EAAS;EAAS,CAAC;AAChE,KAAI,gBAAgB,SAClB,QAAO,wBACL,qBACA,kDACA,IACD;AAGH,KAAI;EACF,MAAM,QAAQ,MAAM,QAAQ,aAAa,mBAAmB;GAC1D;GACA;GACA,QAAQ,QAAQ;GACjB,CAAC;AACF,SAAO,SAAS,KAAK,OAAO,EAC1B,SAAS,EAAE,iBAAiB,YAAY,EACzC,CAAC;UACK,OAAO;AACd,MAAI,iBAAiBC,+CACnB,QAAO,wBAAwB,MAAM,MAAM,MAAM,SAAS,MAAM,OAAO;AAEzE,SAAO,wBACL,qBACA,qCACA,IACD"}

package/dist/runtime/handlers/handle-trajectory-connect.mjs

@@ -0,0 +1,39 @@
+import { TrajectoryConnectionError, isValidTrajectoryId } from "../intelligence-platform/trajectories.mjs";
+import { resolveIntelligenceUser } from "./shared/resolve-intelligence-user.mjs";
+import { isIntelligenceRuntime } from "../core/runtime.mjs";
+
+//#region src/runtime/handlers/handle-trajectory-connect.ts
+function trajectoryErrorResponse(code, message, status) {
+	return Response.json({
+		code,
+		message
+	}, {
+		status,
+		headers: { "Cache-Control": "no-store" }
+	});
+}
+async function handleTrajectoryConnect({ runtime, request, trajectoryId }) {
+	if (!isValidTrajectoryId(trajectoryId)) return trajectoryErrorResponse("INVALID_REQUEST", "A valid trajectoryId is required", 400);
+	if (!isIntelligenceRuntime(runtime)) return trajectoryErrorResponse("INTELLIGENCE_RUNTIME_REQUIRED", "Trajectory capture requires an Intelligence runtime", 503);
+	if (!runtime.identifyUser) return trajectoryErrorResponse("IDENTITY_REQUIRED", "Trajectory capture requires an identified user", 401);
+	const user = await resolveIntelligenceUser({
+		runtime,
+		request
+	});
+	if (user instanceof Response) return trajectoryErrorResponse("IDENTITY_REQUIRED", "Trajectory capture requires an identified user", 401);
+	try {
+		const grant = await runtime.intelligence.ɵconnectTrajectory({
+			trajectoryId,
+			user,
+			signal: request.signal
+		});
+		return Response.json(grant, { headers: { "Cache-Control": "no-store" } });
+	} catch (error) {
+		if (error instanceof TrajectoryConnectionError) return trajectoryErrorResponse(error.code, error.message, error.status);
+		return trajectoryErrorResponse("CONNECTION_FAILED", "Could not connect to Intelligence", 502);
+	}
+}
+
+//#endregion
+export { handleTrajectoryConnect, trajectoryErrorResponse };
+//# sourceMappingURL=handle-trajectory-connect.mjs.map

package/dist/runtime/handlers/handle-trajectory-connect.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"handle-trajectory-connect.mjs","names":[],"sources":["../../../src/runtime/handlers/handle-trajectory-connect.ts"],"sourcesContent":["import type { CopilotRuntimeLike } from \"../core/runtime\";\nimport { isIntelligenceRuntime } from \"../core/runtime\";\nimport {\n  isValidTrajectoryId,\n  TrajectoryConnectionError,\n} from \"../intelligence-platform/trajectories\";\nimport { resolveIntelligenceUser } from \"./shared/resolve-intelligence-user\";\n\nexport function trajectoryErrorResponse(\n  code: string,\n  message: string,\n  status: number,\n): Response {\n  return Response.json(\n    { code, message },\n    { status, headers: { \"Cache-Control\": \"no-store\" } },\n  );\n}\n\nexport async function handleTrajectoryConnect({\n  runtime,\n  request,\n  trajectoryId,\n}: {\n  runtime: CopilotRuntimeLike;\n  request: Request;\n  trajectoryId: string;\n}): Promise<Response> {\n  if (!isValidTrajectoryId(trajectoryId)) {\n    return trajectoryErrorResponse(\n      \"INVALID_REQUEST\",\n      \"A valid trajectoryId is required\",\n      400,\n    );\n  }\n  if (!isIntelligenceRuntime(runtime)) {\n    return trajectoryErrorResponse(\n      \"INTELLIGENCE_RUNTIME_REQUIRED\",\n      \"Trajectory capture requires an Intelligence runtime\",\n      503,\n    );\n  }\n  if (!runtime.identifyUser) {\n    return trajectoryErrorResponse(\n      \"IDENTITY_REQUIRED\",\n      \"Trajectory capture requires an identified user\",\n      401,\n    );\n  }\n  const user = await resolveIntelligenceUser({ runtime, request });\n  if (user instanceof Response) {\n    return trajectoryErrorResponse(\n      \"IDENTITY_REQUIRED\",\n      \"Trajectory capture requires an identified user\",\n      401,\n    );\n  }\n\n  try {\n    const grant = await runtime.intelligence.ɵconnectTrajectory({\n      trajectoryId,\n      user,\n      signal: request.signal,\n    });\n    return Response.json(grant, {\n      headers: { \"Cache-Control\": \"no-store\" },\n    });\n  } catch (error) {\n    if (error instanceof TrajectoryConnectionError) {\n      return trajectoryErrorResponse(error.code, error.message, error.status);\n    }\n    return trajectoryErrorResponse(\n      \"CONNECTION_FAILED\",\n      \"Could not connect to Intelligence\",\n      502,\n    );\n  }\n}\n"],"mappings":";;;;;AAQA,SAAgB,wBACd,MACA,SACA,QACU;AACV,QAAO,SAAS,KACd;EAAE;EAAM;EAAS,EACjB;EAAE;EAAQ,SAAS,EAAE,iBAAiB,YAAY;EAAE,CACrD;;AAGH,eAAsB,wBAAwB,EAC5C,SACA,SACA,gBAKoB;AACpB,KAAI,CAAC,oBAAoB,aAAa,CACpC,QAAO,wBACL,mBACA,oCACA,IACD;AAEH,KAAI,CAAC,sBAAsB,QAAQ,CACjC,QAAO,wBACL,iCACA,uDACA,IACD;AAEH,KAAI,CAAC,QAAQ,aACX,QAAO,wBACL,qBACA,kDACA,IACD;CAEH,MAAM,OAAO,MAAM,wBAAwB;EAAE;EAAS;EAAS,CAAC;AAChE,KAAI,gBAAgB,SAClB,QAAO,wBACL,qBACA,kDACA,IACD;AAGH,KAAI;EACF,MAAM,QAAQ,MAAM,QAAQ,aAAa,mBAAmB;GAC1D;GACA;GACA,QAAQ,QAAQ;GACjB,CAAC;AACF,SAAO,SAAS,KAAK,OAAO,EAC1B,SAAS,EAAE,iBAAiB,YAAY,EACzC,CAAC;UACK,OAAO;AACd,MAAI,iBAAiB,0BACnB,QAAO,wBAAwB,MAAM,MAAM,MAAM,SAAS,MAAM,OAAO;AAEzE,SAAO,wBACL,qBACA,qCACA,IACD"}

package/dist/runtime/handlers/handle-transcribe.cjs

@@ -0,0 +1,112 @@
+const require_runtime = require('../../_virtual/_rolldown/runtime.cjs');
+let _copilotkit_shared = require("@copilotkit/shared");
+
+//#region src/runtime/handlers/handle-transcribe.ts
+/**
+* HTTP status codes for transcription error codes
+*/
+const ERROR_STATUS_CODES = {
+	[_copilotkit_shared.TranscriptionErrorCode.SERVICE_NOT_CONFIGURED]: 503,
+	[_copilotkit_shared.TranscriptionErrorCode.INVALID_AUDIO_FORMAT]: 400,
+	[_copilotkit_shared.TranscriptionErrorCode.AUDIO_TOO_LONG]: 400,
+	[_copilotkit_shared.TranscriptionErrorCode.AUDIO_TOO_SHORT]: 400,
+	[_copilotkit_shared.TranscriptionErrorCode.RATE_LIMITED]: 429,
+	[_copilotkit_shared.TranscriptionErrorCode.AUTH_FAILED]: 401,
+	[_copilotkit_shared.TranscriptionErrorCode.PROVIDER_ERROR]: 500,
+	[_copilotkit_shared.TranscriptionErrorCode.NETWORK_ERROR]: 502,
+	[_copilotkit_shared.TranscriptionErrorCode.INVALID_REQUEST]: 400
+};
+const VALID_AUDIO_TYPES = [
+	"audio/mpeg",
+	"audio/mp3",
+	"audio/mp4",
+	"audio/wav",
+	"audio/webm",
+	"audio/ogg",
+	"audio/flac",
+	"audio/aac"
+];
+function isValidAudioType(type) {
+	const baseType = type.split(";")[0]?.trim() ?? "";
+	return VALID_AUDIO_TYPES.includes(baseType) || baseType === "" || baseType === "application/octet-stream";
+}
+function createErrorResponse(errorResponse) {
+	const status = ERROR_STATUS_CODES[errorResponse.error] ?? 500;
+	return new Response(JSON.stringify(errorResponse), {
+		status,
+		headers: { "Content-Type": "application/json" }
+	});
+}
+function base64ToFile(base64, mimeType, filename) {
+	const base64Data = base64.includes(",") ? base64.split(",")[1] ?? base64 : base64;
+	const binaryString = atob(base64Data);
+	const bytes = new Uint8Array(binaryString.length);
+	for (let i = 0; i < binaryString.length; i++) bytes[i] = binaryString.charCodeAt(i);
+	return new File([bytes], filename, { type: mimeType });
+}
+async function extractAudioFromFormData(request) {
+	let audioFile = (await request.formData()).get("audio");
+	if (!audioFile || !(audioFile instanceof File)) return { error: createErrorResponse(_copilotkit_shared.TranscriptionErrors.invalidRequest("No audio file found in form data. Please include an 'audio' field.")) };
+	if (!isValidAudioType(audioFile.type)) return { error: createErrorResponse(_copilotkit_shared.TranscriptionErrors.invalidAudioFormat(audioFile.type, VALID_AUDIO_TYPES)) };
+	if (!audioFile.type || audioFile.type === "application/octet-stream") audioFile = new File([audioFile], audioFile.name || "recording.webm", { type: "audio/webm" });
+	return { file: audioFile };
+}
+async function extractAudioFromJson(request) {
+	let body;
+	try {
+		body = await request.json();
+	} catch {
+		return { error: createErrorResponse(_copilotkit_shared.TranscriptionErrors.invalidRequest("Request body must be valid JSON")) };
+	}
+	if (!body.audio || typeof body.audio !== "string") return { error: createErrorResponse(_copilotkit_shared.TranscriptionErrors.invalidRequest("Request must include 'audio' field with base64-encoded audio data")) };
+	if (!body.mimeType || typeof body.mimeType !== "string") return { error: createErrorResponse(_copilotkit_shared.TranscriptionErrors.invalidRequest("Request must include 'mimeType' field (e.g., 'audio/webm')")) };
+	if (!isValidAudioType(body.mimeType)) return { error: createErrorResponse(_copilotkit_shared.TranscriptionErrors.invalidAudioFormat(body.mimeType, VALID_AUDIO_TYPES)) };
+	try {
+		const filename = body.filename || "recording.webm";
+		return { file: base64ToFile(body.audio, body.mimeType, filename) };
+	} catch {
+		return { error: createErrorResponse(_copilotkit_shared.TranscriptionErrors.invalidRequest("Failed to decode base64 audio data")) };
+	}
+}
+/**
+* Categorize provider errors into appropriate transcription error responses.
+*/
+function categorizeProviderError(error) {
+	const message = error instanceof Error ? error.message : "Unknown error occurred";
+	const errorStr = String(error).toLowerCase();
+	if (errorStr.includes("rate") || errorStr.includes("429") || errorStr.includes("too many")) return _copilotkit_shared.TranscriptionErrors.rateLimited();
+	if (errorStr.includes("auth") || errorStr.includes("401") || errorStr.includes("api key") || errorStr.includes("unauthorized")) return _copilotkit_shared.TranscriptionErrors.authFailed();
+	if (errorStr.includes("too long") || errorStr.includes("duration") || errorStr.includes("length")) return _copilotkit_shared.TranscriptionErrors.audioTooLong();
+	return _copilotkit_shared.TranscriptionErrors.providerError(message);
+}
+async function handleTranscribe({ runtime, request }) {
+	try {
+		if (!runtime.transcriptionService) return createErrorResponse(_copilotkit_shared.TranscriptionErrors.serviceNotConfigured());
+		const contentType = request.headers.get("content-type") || "";
+		let extractResult;
+		if (contentType.includes("multipart/form-data")) extractResult = await extractAudioFromFormData(request);
+		else if (contentType.includes("application/json")) extractResult = await extractAudioFromJson(request);
+		else return createErrorResponse(_copilotkit_shared.TranscriptionErrors.invalidRequest("Request must be multipart/form-data or application/json with base64 audio"));
+		if ("error" in extractResult) return extractResult.error;
+		const audioFile = extractResult.file;
+		const transcription = await runtime.transcriptionService.transcribeFile({
+			audioFile,
+			mimeType: audioFile.type,
+			size: audioFile.size
+		});
+		return new Response(JSON.stringify({
+			text: transcription,
+			size: audioFile.size,
+			type: audioFile.type
+		}), {
+			status: 200,
+			headers: { "Content-Type": "application/json" }
+		});
+	} catch (error) {
+		return createErrorResponse(categorizeProviderError(error));
+	}
+}
+
+//#endregion
+exports.handleTranscribe = handleTranscribe;
+//# sourceMappingURL=handle-transcribe.cjs.map

package/dist/runtime/handlers/handle-transcribe.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"handle-transcribe.cjs","names":["TranscriptionErrorCode","TranscriptionErrors"],"sources":["../../../src/runtime/handlers/handle-transcribe.ts"],"sourcesContent":["import type { CopilotRuntimeLike } from \"../core/runtime\";\nimport {\n  TranscriptionErrorCode,\n  TranscriptionErrors,\n} from \"@copilotkit/shared\";\nimport type { TranscriptionErrorResponse } from \"@copilotkit/shared\";\n\n/**\n * HTTP status codes for transcription error codes\n */\nconst ERROR_STATUS_CODES: Record<TranscriptionErrorCode, number> = {\n  [TranscriptionErrorCode.SERVICE_NOT_CONFIGURED]: 503,\n  [TranscriptionErrorCode.INVALID_AUDIO_FORMAT]: 400,\n  [TranscriptionErrorCode.AUDIO_TOO_LONG]: 400,\n  [TranscriptionErrorCode.AUDIO_TOO_SHORT]: 400,\n  [TranscriptionErrorCode.RATE_LIMITED]: 429,\n  [TranscriptionErrorCode.AUTH_FAILED]: 401,\n  [TranscriptionErrorCode.PROVIDER_ERROR]: 500,\n  [TranscriptionErrorCode.NETWORK_ERROR]: 502,\n  [TranscriptionErrorCode.INVALID_REQUEST]: 400,\n};\n\ninterface HandleTranscribeParameters {\n  runtime: CopilotRuntimeLike;\n  request: Request;\n}\n\ninterface Base64AudioInput {\n  audio: string; // base64-encoded audio data\n  mimeType: string;\n  filename?: string;\n}\n\nconst VALID_AUDIO_TYPES = [\n  \"audio/mpeg\",\n  \"audio/mp3\",\n  \"audio/mp4\",\n  \"audio/wav\",\n  \"audio/webm\",\n  \"audio/ogg\",\n  \"audio/flac\",\n  \"audio/aac\",\n];\n\nfunction isValidAudioType(type: string): boolean {\n  // Extract base MIME type (before semicolon) to handle types like \"audio/webm; codecs=opus\"\n  const baseType = type.split(\";\")[0]?.trim() ?? \"\";\n  return (\n    VALID_AUDIO_TYPES.includes(baseType) ||\n    baseType === \"\" ||\n    baseType === \"application/octet-stream\"\n  );\n}\n\nfunction createErrorResponse(\n  errorResponse: TranscriptionErrorResponse,\n): Response {\n  const status = ERROR_STATUS_CODES[errorResponse.error] ?? 500;\n  return new Response(JSON.stringify(errorResponse), {\n    status,\n    headers: { \"Content-Type\": \"application/json\" },\n  });\n}\n\nfunction base64ToFile(\n  base64: string,\n  mimeType: string,\n  filename: string,\n): File {\n  // Remove data URL prefix if present (e.g., \"data:audio/webm;base64,\")\n  const base64Data = base64.includes(\",\")\n    ? (base64.split(\",\")[1] ?? base64)\n    : base64;\n\n  // Decode base64 to binary\n  const binaryString = atob(base64Data);\n  const bytes = new Uint8Array(binaryString.length);\n  for (let i = 0; i < binaryString.length; i++) {\n    bytes[i] = binaryString.charCodeAt(i);\n  }\n\n  // Create File object\n  return new File([bytes], filename, { type: mimeType });\n}\n\nasync function extractAudioFromFormData(\n  request: Request,\n): Promise<{ file: File } | { error: Response }> {\n  const formData = await request.formData();\n  let audioFile = formData.get(\"audio\") as File | null;\n\n  if (!audioFile || !(audioFile instanceof File)) {\n    const err = TranscriptionErrors.invalidRequest(\n      \"No audio file found in form data. Please include an 'audio' field.\",\n    );\n    return { error: createErrorResponse(err) };\n  }\n\n  if (!isValidAudioType(audioFile.type)) {\n    const err = TranscriptionErrors.invalidAudioFormat(\n      audioFile.type,\n      VALID_AUDIO_TYPES,\n    );\n    return { error: createErrorResponse(err) };\n  }\n\n  // Browser MediaRecorder Blobs often arrive at the server with their\n  // `type` field empty (and `application/octet-stream` is also accepted by\n  // isValidAudioType for compatibility). OpenAI Whisper rejects files\n  // without a recognizable MIME / extension with a 502 \"Invalid file\n  // format\" — even though the bytes themselves are valid WebM Opus.\n  // Stamp `audio/webm` (the standard MediaRecorder default in Chromium /\n  // Firefox / Safari) so Whisper can pick the right decoder.\n  if (!audioFile.type || audioFile.type === \"application/octet-stream\") {\n    audioFile = new File([audioFile], audioFile.name || \"recording.webm\", {\n      type: \"audio/webm\",\n    });\n  }\n\n  return { file: audioFile };\n}\n\nasync function extractAudioFromJson(\n  request: Request,\n): Promise<{ file: File } | { error: Response }> {\n  let body: Base64AudioInput;\n\n  try {\n    body = await request.json();\n  } catch {\n    const err = TranscriptionErrors.invalidRequest(\n      \"Request body must be valid JSON\",\n    );\n    return { error: createErrorResponse(err) };\n  }\n\n  if (!body.audio || typeof body.audio !== \"string\") {\n    const err = TranscriptionErrors.invalidRequest(\n      \"Request must include 'audio' field with base64-encoded audio data\",\n    );\n    return { error: createErrorResponse(err) };\n  }\n\n  if (!body.mimeType || typeof body.mimeType !== \"string\") {\n    const err = TranscriptionErrors.invalidRequest(\n      \"Request must include 'mimeType' field (e.g., 'audio/webm')\",\n    );\n    return { error: createErrorResponse(err) };\n  }\n\n  if (!isValidAudioType(body.mimeType)) {\n    const err = TranscriptionErrors.invalidAudioFormat(\n      body.mimeType,\n      VALID_AUDIO_TYPES,\n    );\n    return { error: createErrorResponse(err) };\n  }\n\n  try {\n    const filename = body.filename || \"recording.webm\";\n    const file = base64ToFile(body.audio, body.mimeType, filename);\n    return { file };\n  } catch {\n    const err = TranscriptionErrors.invalidRequest(\n      \"Failed to decode base64 audio data\",\n    );\n    return { error: createErrorResponse(err) };\n  }\n}\n\n/**\n * Categorize provider errors into appropriate transcription error responses.\n */\nfunction categorizeProviderError(error: unknown): TranscriptionErrorResponse {\n  const message =\n    error instanceof Error ? error.message : \"Unknown error occurred\";\n  const errorStr = String(error).toLowerCase();\n\n  // Check for rate limiting\n  if (\n    errorStr.includes(\"rate\") ||\n    errorStr.includes(\"429\") ||\n    errorStr.includes(\"too many\")\n  ) {\n    return TranscriptionErrors.rateLimited();\n  }\n\n  // Check for auth errors\n  if (\n    errorStr.includes(\"auth\") ||\n    errorStr.includes(\"401\") ||\n    errorStr.includes(\"api key\") ||\n    errorStr.includes(\"unauthorized\")\n  ) {\n    return TranscriptionErrors.authFailed();\n  }\n\n  // Check for audio too long\n  if (\n    errorStr.includes(\"too long\") ||\n    errorStr.includes(\"duration\") ||\n    errorStr.includes(\"length\")\n  ) {\n    return TranscriptionErrors.audioTooLong();\n  }\n\n  // Default to provider error\n  return TranscriptionErrors.providerError(message);\n}\n\nexport async function handleTranscribe({\n  runtime,\n  request,\n}: HandleTranscribeParameters) {\n  try {\n    // Check if transcription service is configured\n    if (!runtime.transcriptionService) {\n      const err = TranscriptionErrors.serviceNotConfigured();\n      return createErrorResponse(err);\n    }\n\n    // Determine input type based on content-type header\n    const contentType = request.headers.get(\"content-type\") || \"\";\n\n    let extractResult: { file: File } | { error: Response };\n\n    if (contentType.includes(\"multipart/form-data\")) {\n      // Handle multipart/form-data (REST mode)\n      extractResult = await extractAudioFromFormData(request);\n    } else if (contentType.includes(\"application/json\")) {\n      // Handle JSON with base64 audio (single-endpoint mode)\n      extractResult = await extractAudioFromJson(request);\n    } else {\n      const err = TranscriptionErrors.invalidRequest(\n        \"Request must be multipart/form-data or application/json with base64 audio\",\n      );\n      return createErrorResponse(err);\n    }\n\n    // Check for extraction errors\n    if (\"error\" in extractResult) {\n      return extractResult.error;\n    }\n\n    const audioFile = extractResult.file;\n\n    // Transcribe the audio file\n    const transcription = await runtime.transcriptionService.transcribeFile({\n      audioFile,\n      mimeType: audioFile.type,\n      size: audioFile.size,\n    });\n\n    return new Response(\n      JSON.stringify({\n        text: transcription,\n        size: audioFile.size,\n        type: audioFile.type,\n      }),\n      {\n        status: 200,\n        headers: { \"Content-Type\": \"application/json\" },\n      },\n    );\n  } catch (error) {\n    // Categorize the error for better client-side handling\n    return createErrorResponse(categorizeProviderError(error));\n  }\n}\n"],"mappings":"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"}