@copilotkit/runtime 1.72.1-canary.sp-longthread-perf → 1.73.1

package/dist/v2/runtime/handlers/shared/sse-response.cjs

@@ -1,11 +1,13 @@
 require("reflect-metadata");
 const require_runtime = require('../../../../_virtual/_rolldown/runtime.cjs');
 const require_logger = require('../../../../lib/logger.cjs');
+const require_sse_keep_alive = require('./sse-keep-alive.cjs');
 const require_telemetry_client = require('../../telemetry/telemetry-client.cjs');
 let _ag_ui_encoder = require("@ag-ui/encoder");
 
 //#region src/v2/runtime/handlers/shared/sse-response.ts
-function createSseEventResponse({ request, observableFactory, debugEventBus, agentId, debug, logger, telemetry: telemetry$1 = require_telemetry_client.default, executionSeed, captureTelemetry = true, runtimeErrorReporter, startTime }) {
+function createSseEventResponse({ request, observableFactory, debugEventBus, agentId, debug, logger, telemetry: telemetry$1 = require_telemetry_client.default, executionSeed, captureTelemetry = true, runtimeErrorReporter, startTime, keepAliveIntervalSeconds }) {
+	const keepAliveSeconds = require_sse_keep_alive.resolveSseKeepAliveIntervalSeconds(keepAliveIntervalSeconds);
 	const stream = new TransformStream();
 	const writer = stream.writable.getWriter();
 	const encoder = new _ag_ui_encoder.EventEncoder();
@@ -124,7 +126,8 @@ function createSseEventResponse({ request, observableFactory, debugEventBus, age
 	request.signal.addEventListener("abort", () => {
 		subscription?.unsubscribe();
 	});
-	return new Response(stream.readable, {
+	const body = keepAliveSeconds > 0 ? require_sse_keep_alive.keepAliveSse(stream.readable, keepAliveSeconds * 1e3) : stream.readable;
+	return new Response(body, {
 		status: 200,
 		headers: {
 			"Content-Type": "text/event-stream",

package/dist/v2/runtime/handlers/shared/sse-response.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"sse-response.cjs","names":["defaultTelemetry","EventEncoder","createLogger"],"sources":["../../../../../src/v2/runtime/handlers/shared/sse-response.ts"],"sourcesContent":["import type { BaseEvent } from \"@ag-ui/client\";\nimport { EventEncoder } from \"@ag-ui/encoder\";\nimport type { Observable, Subscription } from \"rxjs\";\nimport type { ResolvedDebugConfig } from \"@copilotkit/shared\";\nimport { createLogger } from \"../../../../v1-deprecated/lib/logger\";\nimport type { CopilotRuntimeLogger } from \"../../../../v1-deprecated/lib/logger\";\nimport { telemetry as defaultTelemetry } from \"../../telemetry\";\nimport type { TelemetryCapture } from \"../../telemetry/telemetry-client\";\nimport type { AgentExecutionResponseInfo } from \"../../telemetry/events\";\nimport type { DebugEventBus } from \"../../core/debug-event-bus\";\nimport type {\n  RuntimeErrorPhase,\n  RuntimeErrorReporter,\n} from \"../../core/runtime-error-reporter\";\n\ninterface CreateSseEventResponseParams {\n  request: Request;\n  observableFactory: () =>\n    | Promise<Observable<BaseEvent>>\n    | Observable<BaseEvent>;\n  debugEventBus?: DebugEventBus;\n  agentId?: string;\n  debug?: ResolvedDebugConfig;\n  /** Pre-created logger instance to avoid creating a new pino logger per request. */\n  logger?: CopilotRuntimeLogger;\n  /** Runtime-bound telemetry capture. Falls back for external direct callers. */\n  telemetry?: TelemetryCapture;\n  /**\n   * Execution facts known before the stream opens, merged under anything the\n   * upstream reports as it runs. Carries `llmHostClass`, which is knowable\n   * from the agent's configuration and never appears on a streamed event.\n   */\n  executionSeed?: AgentExecutionResponseInfo;\n  /**\n   * Whether to emit `oss.runtime.agent_execution_stream_*` telemetry for this\n   * stream. Defaults to `true`. The stateless `/suggest` path sets this to\n   * `false`: a suggestion is a side-effect-free structured completion, not a\n   * tracked run, and under `available: \"always\"` it fires often enough to flood\n   * run telemetry.\n   */\n  captureTelemetry?: boolean;\n  runtimeErrorReporter?: RuntimeErrorReporter;\n  startTime?: number;\n}\n\nexport function createSseEventResponse({\n  request,\n  observableFactory,\n  debugEventBus,\n  agentId,\n  debug,\n  logger,\n  telemetry = defaultTelemetry,\n  executionSeed,\n  captureTelemetry = true,\n  runtimeErrorReporter,\n  startTime,\n}: CreateSseEventResponseParams): Response {\n  const stream = new TransformStream();\n  const writer = stream.writable.getWriter();\n  const encoder = new EventEncoder();\n  let streamClosed = false;\n  let debugThreadId = \"\";\n  let debugRunId = \"\";\n\n  const debugLogger = debug?.enabled\n    ? (logger ??\n      createLogger({ level: \"debug\", component: \"copilotkit-debug\" }))\n    : undefined;\n\n  const closeStream = async () => {\n    if (!streamClosed) {\n      try {\n        await writer.close();\n        streamClosed = true;\n      } catch {\n        // Stream already closed.\n      }\n    }\n  };\n\n  const logError = (error: unknown) => {\n    console.error(\"Error running agent:\", error);\n    console.error(\n      \"Error stack:\",\n      error instanceof Error ? error.stack : \"No stack trace\",\n    );\n    console.error(\"Error details:\", {\n      name: error instanceof Error ? error.name : \"Unknown\",\n      message: error instanceof Error ? error.message : String(error),\n      cause: error instanceof Error ? error.cause : undefined,\n    });\n  };\n\n  let subscription: Subscription | undefined;\n  let agentErrorReported = false;\n\n  const reportAgentError = (error: unknown, phase: RuntimeErrorPhase) => {\n    if (agentErrorReported) return;\n    agentErrorReported = true;\n    runtimeErrorReporter?.report({\n      request,\n      error,\n      operation: \"agent.run\",\n      agentId,\n      threadId: debugThreadId || undefined,\n      runId: debugRunId || undefined,\n      phase,\n      startTime,\n    });\n  };\n\n  (async () => {\n    const observable = await observableFactory();\n\n    if (captureTelemetry) {\n      telemetry.capture(\"oss.runtime.agent_execution_stream_started\", {});\n    }\n\n    if (debug?.lifecycle) {\n      debugLogger!.debug(\"SSE stream opened\");\n    }\n\n    let eventCount = 0;\n    let loggedEventCount = 0;\n\n    // Provider/model/LangGraph facts, scraped off raw upstream events as\n    // they pass and reported once the stream finishes. This moved here from\n    // the v1 TelemetryAgentRunner, which wrapped the runner purely to\n    // collect it and emitted its own duplicate copy of every stream event\n    // to carry it. v2 callers had no equivalent and reported `{}`.\n    // Seeded rather than empty: `llmHostClass` comes from the agent's config,\n    // not from the wire, so nothing streamed will ever fill it in. Scraped\n    // fields still win, since `collectExecutionInfo` writes over this.\n    const executionInfo: AgentExecutionResponseInfo = { ...executionSeed };\n\n    subscription = observable.subscribe({\n      next: async (event) => {\n        collectExecutionInfo(event, executionInfo);\n\n        // Extract threadId/runId from RUN_STARTED\n        if (event.type === \"RUN_STARTED\") {\n          const e = event as { threadId?: string; runId?: string };\n          debugThreadId = e.threadId ?? \"\";\n          debugRunId = e.runId ?? \"\";\n        }\n\n        if (event.type === \"RUN_ERROR\") {\n          const e = event as {\n            message?: unknown;\n            threadId?: string;\n            runId?: string;\n          };\n          debugThreadId = e.threadId ?? debugThreadId;\n          debugRunId = e.runId ?? debugRunId;\n          reportAgentError(\n            new Error(\n              typeof e.message === \"string\"\n                ? e.message\n                : \"Runner reported a run error\",\n            ),\n            \"sse.subscription\",\n          );\n        }\n\n        // Broadcast to debug listeners BEFORE the stream-closed gate below.\n        // Intentional: debug subscribers (e.g. the VS Code Inspector panel)\n        // should still receive trailing events after the SSE client for\n        // this request closed its connection — they're independent\n        // consumers observing the underlying runtime, not the request's\n        // response stream.\n        //\n        // Wrapped in try/catch so a buggy debug subscriber can't propagate\n        // an exception into this observer — if the throw reached the\n        // `next` callback it would get routed to `error` by RxJS, closing\n        // the SSE stream for an unrelated reason. Log via `logError` and\n        // move on.\n        if (debugEventBus) {\n          try {\n            debugEventBus.broadcast(event, {\n              agentId: agentId ?? \"\",\n              threadId: debugThreadId,\n              runId: debugRunId,\n            });\n          } catch (broadcastError) {\n            logError(broadcastError);\n          }\n        }\n\n        if (!request.signal.aborted && !streamClosed) {\n          try {\n            eventCount++;\n            if (debug?.events) {\n              loggedEventCount++;\n              if (debug.verbose) {\n                debugLogger!.debug({ event }, \"Event emitted\");\n              } else {\n                debugLogger!.debug(\n                  { type: event.type, ...summarizeEvent(event) },\n                  \"Event emitted\",\n                );\n              }\n            }\n            await writer.write(encoder.encodeBinary(event));\n          } catch (error) {\n            if (error instanceof Error && error.name === \"AbortError\") {\n              streamClosed = true;\n            } else {\n              // Non-abort write failures (backpressure disconnects,\n              // transform-stream exceptions, …) were previously swallowed\n              // silently — `streamClosed` stayed `false` and the next\n              // event re-attempted a broken writer. Log and mark the\n              // stream closed so we stop trying.\n              logError(error);\n              streamClosed = true;\n            }\n          }\n        }\n      },\n      error: async (error) => {\n        reportAgentError(error, \"sse.subscription\");\n        if (captureTelemetry) {\n          telemetry.capture(\"oss.runtime.agent_execution_stream_errored\", {\n            ...executionInfo,\n            error: error instanceof Error ? error.message : String(error),\n          });\n        }\n        if (debug?.lifecycle) {\n          debugLogger!.debug(\n            { error: error instanceof Error ? error.message : String(error) },\n            \"SSE stream errored\",\n          );\n        }\n        logError(error);\n        await closeStream();\n      },\n      complete: async () => {\n        if (captureTelemetry) {\n          telemetry.capture(\n            \"oss.runtime.agent_execution_stream_ended\",\n            executionInfo,\n          );\n        }\n        if (debug?.lifecycle) {\n          debugLogger!.debug(\n            { eventCount, loggedEventCount },\n            \"SSE stream completed\",\n          );\n        }\n        await closeStream();\n      },\n    });\n\n    // If the client disconnected before the subscription was created,\n    // unsubscribe immediately to avoid leaking the observable.\n    if (request.signal.aborted) {\n      subscription.unsubscribe();\n    }\n  })().catch(async (error) => {\n    reportAgentError(error, \"sse.factory\");\n    logError(error);\n    await closeStream();\n  });\n\n  request.signal.addEventListener(\"abort\", () => {\n    subscription?.unsubscribe();\n  });\n\n  return new Response(stream.readable, {\n    status: 200,\n    headers: {\n      \"Content-Type\": \"text/event-stream\",\n      \"Cache-Control\": \"no-cache\",\n      Connection: \"keep-alive\",\n    },\n  });\n}\n\nfunction summarizeEvent(event: BaseEvent): Record<string, unknown> {\n  const e = event as any;\n  const summary: Record<string, unknown> = {};\n\n  if (e.messageId) summary.messageId = e.messageId;\n  if (e.toolCallId) summary.toolCallId = e.toolCallId;\n  if (e.toolCallName) summary.toolCallName = e.toolCallName;\n  if (e.role) summary.role = e.role;\n  if (e.delta != null && typeof e.delta === \"string\")\n    summary.deltaLength = e.delta.length;\n  if (e.snapshot && typeof e.snapshot === \"object\")\n    summary.snapshotKeys = Object.keys(e.snapshot);\n  if (e.delta && Array.isArray(e.delta))\n    summary.operationCount = e.delta.length;\n  if (e.threadId) summary.threadId = e.threadId;\n  if (e.runId) summary.runId = e.runId;\n  if (e.message) summary.message = e.message;\n  if (e.code) summary.code = e.code;\n  if (e.stepName) summary.stepName = e.stepName;\n\n  return summary;\n}\n\n/**\n * Accumulate provider, model, and LangGraph facts from one upstream event.\n *\n * Mutates rather than returns so the caller keeps one record across the whole\n * stream: these arrive on different events and the last one wins. Only fields\n * the upstream actually sent are set, so an agent that reports none leaves the\n * record empty and the stream events carry `{}` as before.\n *\n * `rawEvent` is the untransformed upstream payload, present on AG-UI events\n * that wrap one. Its shape is the provider's, not ours, hence the narrowing.\n */\nfunction collectExecutionInfo(\n  event: BaseEvent,\n  into: AgentExecutionResponseInfo,\n): void {\n  const rawEvent = (\n    event as {\n      rawEvent?: {\n        metadata?: Record<string, unknown>;\n        data?: Record<string, unknown>;\n      };\n    }\n  ).rawEvent;\n  if (!rawEvent) return;\n\n  const model = (rawEvent.data as { output?: { model?: string } } | undefined)\n    ?.output?.model;\n  if (model) {\n    into.model = model;\n    // Carried forward from the v1 implementation, which set both from the\n    // same field. The upstream sends no separate provider name.\n    into.provider = model;\n  }\n\n  const metadata = rawEvent.metadata as\n    | { langgraph_host?: string; langgraph_version?: string }\n    | undefined;\n  if (metadata?.langgraph_host) into.langGraphHost = metadata.langgraph_host;\n  if (metadata?.langgraph_version) {\n    into.langGraphVersion = metadata.langgraph_version;\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"sse-response.cjs","names":["defaultTelemetry","resolveSseKeepAliveIntervalSeconds","EventEncoder","createLogger","keepAliveSse"],"sources":["../../../../../src/v2/runtime/handlers/shared/sse-response.ts"],"sourcesContent":["import type { BaseEvent } from \"@ag-ui/client\";\nimport { EventEncoder } from \"@ag-ui/encoder\";\nimport type { Observable, Subscription } from \"rxjs\";\nimport {\n  keepAliveSse,\n  resolveSseKeepAliveIntervalSeconds,\n} from \"./sse-keep-alive\";\nimport type { ResolvedDebugConfig } from \"@copilotkit/shared\";\nimport { createLogger } from \"../../../../v1-deprecated/lib/logger\";\nimport type { CopilotRuntimeLogger } from \"../../../../v1-deprecated/lib/logger\";\nimport { telemetry as defaultTelemetry } from \"../../telemetry\";\nimport type { TelemetryCapture } from \"../../telemetry/telemetry-client\";\nimport type { AgentExecutionResponseInfo } from \"../../telemetry/events\";\nimport type { DebugEventBus } from \"../../core/debug-event-bus\";\nimport type {\n  RuntimeErrorPhase,\n  RuntimeErrorReporter,\n} from \"../../core/runtime-error-reporter\";\n\ninterface CreateSseEventResponseParams {\n  request: Request;\n  observableFactory: () =>\n    | Promise<Observable<BaseEvent>>\n    | Observable<BaseEvent>;\n  debugEventBus?: DebugEventBus;\n  agentId?: string;\n  debug?: ResolvedDebugConfig;\n  /** Pre-created logger instance to avoid creating a new pino logger per request. */\n  logger?: CopilotRuntimeLogger;\n  /** Runtime-bound telemetry capture. Falls back for external direct callers. */\n  telemetry?: TelemetryCapture;\n  /**\n   * Execution facts known before the stream opens, merged under anything the\n   * upstream reports as it runs. Carries `llmHostClass`, which is knowable\n   * from the agent's configuration and never appears on a streamed event.\n   */\n  executionSeed?: AgentExecutionResponseInfo;\n  /**\n   * Whether to emit `oss.runtime.agent_execution_stream_*` telemetry for this\n   * stream. Defaults to `true`. The stateless `/suggest` path sets this to\n   * `false`: a suggestion is a side-effect-free structured completion, not a\n   * tracked run, and under `available: \"always\"` it fires often enough to flood\n   * run telemetry.\n   */\n  captureTelemetry?: boolean;\n  runtimeErrorReporter?: RuntimeErrorReporter;\n  startTime?: number;\n  /**\n   * Seconds of silence before a `: keep-alive` SSE comment is written.\n   * `0` disables the keep-alive. Resolved by\n   * {@link resolveSseKeepAliveIntervalSeconds}, which supplies the default\n   * and enforces the timer bound for every caller.\n   */\n  keepAliveIntervalSeconds?: number;\n}\n\nexport function createSseEventResponse({\n  request,\n  observableFactory,\n  debugEventBus,\n  agentId,\n  debug,\n  logger,\n  telemetry = defaultTelemetry,\n  executionSeed,\n  captureTelemetry = true,\n  runtimeErrorReporter,\n  startTime,\n  keepAliveIntervalSeconds,\n}: CreateSseEventResponseParams): Response {\n  const keepAliveSeconds = resolveSseKeepAliveIntervalSeconds(\n    keepAliveIntervalSeconds,\n  );\n  const stream = new TransformStream();\n  const writer = stream.writable.getWriter();\n  const encoder = new EventEncoder();\n  let streamClosed = false;\n  let debugThreadId = \"\";\n  let debugRunId = \"\";\n\n  const debugLogger = debug?.enabled\n    ? (logger ??\n      createLogger({ level: \"debug\", component: \"copilotkit-debug\" }))\n    : undefined;\n\n  const closeStream = async () => {\n    if (!streamClosed) {\n      try {\n        await writer.close();\n        streamClosed = true;\n      } catch {\n        // Stream already closed.\n      }\n    }\n  };\n\n  const logError = (error: unknown) => {\n    console.error(\"Error running agent:\", error);\n    console.error(\n      \"Error stack:\",\n      error instanceof Error ? error.stack : \"No stack trace\",\n    );\n    console.error(\"Error details:\", {\n      name: error instanceof Error ? error.name : \"Unknown\",\n      message: error instanceof Error ? error.message : String(error),\n      cause: error instanceof Error ? error.cause : undefined,\n    });\n  };\n\n  let subscription: Subscription | undefined;\n  let agentErrorReported = false;\n\n  const reportAgentError = (error: unknown, phase: RuntimeErrorPhase) => {\n    if (agentErrorReported) return;\n    agentErrorReported = true;\n    runtimeErrorReporter?.report({\n      request,\n      error,\n      operation: \"agent.run\",\n      agentId,\n      threadId: debugThreadId || undefined,\n      runId: debugRunId || undefined,\n      phase,\n      startTime,\n    });\n  };\n\n  (async () => {\n    const observable = await observableFactory();\n\n    if (captureTelemetry) {\n      telemetry.capture(\"oss.runtime.agent_execution_stream_started\", {});\n    }\n\n    if (debug?.lifecycle) {\n      debugLogger!.debug(\"SSE stream opened\");\n    }\n\n    let eventCount = 0;\n    let loggedEventCount = 0;\n\n    // Provider/model/LangGraph facts, scraped off raw upstream events as\n    // they pass and reported once the stream finishes. This moved here from\n    // the v1 TelemetryAgentRunner, which wrapped the runner purely to\n    // collect it and emitted its own duplicate copy of every stream event\n    // to carry it. v2 callers had no equivalent and reported `{}`.\n    // Seeded rather than empty: `llmHostClass` comes from the agent's config,\n    // not from the wire, so nothing streamed will ever fill it in. Scraped\n    // fields still win, since `collectExecutionInfo` writes over this.\n    const executionInfo: AgentExecutionResponseInfo = { ...executionSeed };\n\n    subscription = observable.subscribe({\n      next: async (event) => {\n        collectExecutionInfo(event, executionInfo);\n\n        // Extract threadId/runId from RUN_STARTED\n        if (event.type === \"RUN_STARTED\") {\n          const e = event as { threadId?: string; runId?: string };\n          debugThreadId = e.threadId ?? \"\";\n          debugRunId = e.runId ?? \"\";\n        }\n\n        if (event.type === \"RUN_ERROR\") {\n          const e = event as {\n            message?: unknown;\n            threadId?: string;\n            runId?: string;\n          };\n          debugThreadId = e.threadId ?? debugThreadId;\n          debugRunId = e.runId ?? debugRunId;\n          reportAgentError(\n            new Error(\n              typeof e.message === \"string\"\n                ? e.message\n                : \"Runner reported a run error\",\n            ),\n            \"sse.subscription\",\n          );\n        }\n\n        // Broadcast to debug listeners BEFORE the stream-closed gate below.\n        // Intentional: debug subscribers (e.g. the VS Code Inspector panel)\n        // should still receive trailing events after the SSE client for\n        // this request closed its connection — they're independent\n        // consumers observing the underlying runtime, not the request's\n        // response stream.\n        //\n        // Wrapped in try/catch so a buggy debug subscriber can't propagate\n        // an exception into this observer — if the throw reached the\n        // `next` callback it would get routed to `error` by RxJS, closing\n        // the SSE stream for an unrelated reason. Log via `logError` and\n        // move on.\n        if (debugEventBus) {\n          try {\n            debugEventBus.broadcast(event, {\n              agentId: agentId ?? \"\",\n              threadId: debugThreadId,\n              runId: debugRunId,\n            });\n          } catch (broadcastError) {\n            logError(broadcastError);\n          }\n        }\n\n        if (!request.signal.aborted && !streamClosed) {\n          try {\n            eventCount++;\n            if (debug?.events) {\n              loggedEventCount++;\n              if (debug.verbose) {\n                debugLogger!.debug({ event }, \"Event emitted\");\n              } else {\n                debugLogger!.debug(\n                  { type: event.type, ...summarizeEvent(event) },\n                  \"Event emitted\",\n                );\n              }\n            }\n            await writer.write(encoder.encodeBinary(event));\n          } catch (error) {\n            if (error instanceof Error && error.name === \"AbortError\") {\n              streamClosed = true;\n            } else {\n              // Non-abort write failures (backpressure disconnects,\n              // transform-stream exceptions, …) were previously swallowed\n              // silently — `streamClosed` stayed `false` and the next\n              // event re-attempted a broken writer. Log and mark the\n              // stream closed so we stop trying.\n              logError(error);\n              streamClosed = true;\n            }\n          }\n        }\n      },\n      error: async (error) => {\n        reportAgentError(error, \"sse.subscription\");\n        if (captureTelemetry) {\n          telemetry.capture(\"oss.runtime.agent_execution_stream_errored\", {\n            ...executionInfo,\n            error: error instanceof Error ? error.message : String(error),\n          });\n        }\n        if (debug?.lifecycle) {\n          debugLogger!.debug(\n            { error: error instanceof Error ? error.message : String(error) },\n            \"SSE stream errored\",\n          );\n        }\n        logError(error);\n        await closeStream();\n      },\n      complete: async () => {\n        if (captureTelemetry) {\n          telemetry.capture(\n            \"oss.runtime.agent_execution_stream_ended\",\n            executionInfo,\n          );\n        }\n        if (debug?.lifecycle) {\n          debugLogger!.debug(\n            { eventCount, loggedEventCount },\n            \"SSE stream completed\",\n          );\n        }\n        await closeStream();\n      },\n    });\n\n    // If the client disconnected before the subscription was created,\n    // unsubscribe immediately to avoid leaking the observable.\n    if (request.signal.aborted) {\n      subscription.unsubscribe();\n    }\n  })().catch(async (error) => {\n    reportAgentError(error, \"sse.factory\");\n    logError(error);\n    await closeStream();\n  });\n\n  request.signal.addEventListener(\"abort\", () => {\n    subscription?.unsubscribe();\n  });\n\n  const body =\n    keepAliveSeconds > 0\n      ? keepAliveSse(stream.readable, keepAliveSeconds * 1_000)\n      : stream.readable;\n\n  return new Response(body, {\n    status: 200,\n    headers: {\n      \"Content-Type\": \"text/event-stream\",\n      \"Cache-Control\": \"no-cache\",\n      Connection: \"keep-alive\",\n    },\n  });\n}\n\nfunction summarizeEvent(event: BaseEvent): Record<string, unknown> {\n  const e = event as any;\n  const summary: Record<string, unknown> = {};\n\n  if (e.messageId) summary.messageId = e.messageId;\n  if (e.toolCallId) summary.toolCallId = e.toolCallId;\n  if (e.toolCallName) summary.toolCallName = e.toolCallName;\n  if (e.role) summary.role = e.role;\n  if (e.delta != null && typeof e.delta === \"string\")\n    summary.deltaLength = e.delta.length;\n  if (e.snapshot && typeof e.snapshot === \"object\")\n    summary.snapshotKeys = Object.keys(e.snapshot);\n  if (e.delta && Array.isArray(e.delta))\n    summary.operationCount = e.delta.length;\n  if (e.threadId) summary.threadId = e.threadId;\n  if (e.runId) summary.runId = e.runId;\n  if (e.message) summary.message = e.message;\n  if (e.code) summary.code = e.code;\n  if (e.stepName) summary.stepName = e.stepName;\n\n  return summary;\n}\n\n/**\n * Accumulate provider, model, and LangGraph facts from one upstream event.\n *\n * Mutates rather than returns so the caller keeps one record across the whole\n * stream: these arrive on different events and the last one wins. Only fields\n * the upstream actually sent are set, so an agent that reports none leaves the\n * record empty and the stream events carry `{}` as before.\n *\n * `rawEvent` is the untransformed upstream payload, present on AG-UI events\n * that wrap one. Its shape is the provider's, not ours, hence the narrowing.\n */\nfunction collectExecutionInfo(\n  event: BaseEvent,\n  into: AgentExecutionResponseInfo,\n): void {\n  const rawEvent = (\n    event as {\n      rawEvent?: {\n        metadata?: Record<string, unknown>;\n        data?: Record<string, unknown>;\n      };\n    }\n  ).rawEvent;\n  if (!rawEvent) return;\n\n  const model = (rawEvent.data as { output?: { model?: string } } | undefined)\n    ?.output?.model;\n  if (model) {\n    into.model = model;\n    // Carried forward from the v1 implementation, which set both from the\n    // same field. The upstream sends no separate provider name.\n    into.provider = model;\n  }\n\n  const metadata = rawEvent.metadata as\n    | { langgraph_host?: string; langgraph_version?: string }\n    | undefined;\n  if (metadata?.langgraph_host) into.langGraphHost = metadata.langgraph_host;\n  if (metadata?.langgraph_version) {\n    into.langGraphVersion = metadata.langgraph_version;\n  }\n}\n"],"mappings":"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"}

package/dist/v2/runtime/handlers/shared/sse-response.mjs

@@ -1,10 +1,12 @@
 import "reflect-metadata";
 import { createLogger } from "../../../../lib/logger.mjs";
+import { keepAliveSse, resolveSseKeepAliveIntervalSeconds } from "./sse-keep-alive.mjs";
 import telemetry from "../../telemetry/telemetry-client.mjs";
 import { EventEncoder } from "@ag-ui/encoder";
 
 //#region src/v2/runtime/handlers/shared/sse-response.ts
-function createSseEventResponse({ request, observableFactory, debugEventBus, agentId, debug, logger, telemetry: telemetry$1 = telemetry, executionSeed, captureTelemetry = true, runtimeErrorReporter, startTime }) {
+function createSseEventResponse({ request, observableFactory, debugEventBus, agentId, debug, logger, telemetry: telemetry$1 = telemetry, executionSeed, captureTelemetry = true, runtimeErrorReporter, startTime, keepAliveIntervalSeconds }) {
+	const keepAliveSeconds = resolveSseKeepAliveIntervalSeconds(keepAliveIntervalSeconds);
 	const stream = new TransformStream();
 	const writer = stream.writable.getWriter();
 	const encoder = new EventEncoder();
@@ -123,7 +125,8 @@ function createSseEventResponse({ request, observableFactory, debugEventBus, age
 	request.signal.addEventListener("abort", () => {
 		subscription?.unsubscribe();
 	});
-	return new Response(stream.readable, {
+	const body = keepAliveSeconds > 0 ? keepAliveSse(stream.readable, keepAliveSeconds * 1e3) : stream.readable;
+	return new Response(body, {
 		status: 200,
 		headers: {
 			"Content-Type": "text/event-stream",

package/dist/v2/runtime/handlers/shared/sse-response.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"sse-response.mjs","names":["defaultTelemetry"],"sources":["../../../../../src/v2/runtime/handlers/shared/sse-response.ts"],"sourcesContent":["import type { BaseEvent } from \"@ag-ui/client\";\nimport { EventEncoder } from \"@ag-ui/encoder\";\nimport type { Observable, Subscription } from \"rxjs\";\nimport type { ResolvedDebugConfig } from \"@copilotkit/shared\";\nimport { createLogger } from \"../../../../v1-deprecated/lib/logger\";\nimport type { CopilotRuntimeLogger } from \"../../../../v1-deprecated/lib/logger\";\nimport { telemetry as defaultTelemetry } from \"../../telemetry\";\nimport type { TelemetryCapture } from \"../../telemetry/telemetry-client\";\nimport type { AgentExecutionResponseInfo } from \"../../telemetry/events\";\nimport type { DebugEventBus } from \"../../core/debug-event-bus\";\nimport type {\n  RuntimeErrorPhase,\n  RuntimeErrorReporter,\n} from \"../../core/runtime-error-reporter\";\n\ninterface CreateSseEventResponseParams {\n  request: Request;\n  observableFactory: () =>\n    | Promise<Observable<BaseEvent>>\n    | Observable<BaseEvent>;\n  debugEventBus?: DebugEventBus;\n  agentId?: string;\n  debug?: ResolvedDebugConfig;\n  /** Pre-created logger instance to avoid creating a new pino logger per request. */\n  logger?: CopilotRuntimeLogger;\n  /** Runtime-bound telemetry capture. Falls back for external direct callers. */\n  telemetry?: TelemetryCapture;\n  /**\n   * Execution facts known before the stream opens, merged under anything the\n   * upstream reports as it runs. Carries `llmHostClass`, which is knowable\n   * from the agent's configuration and never appears on a streamed event.\n   */\n  executionSeed?: AgentExecutionResponseInfo;\n  /**\n   * Whether to emit `oss.runtime.agent_execution_stream_*` telemetry for this\n   * stream. Defaults to `true`. The stateless `/suggest` path sets this to\n   * `false`: a suggestion is a side-effect-free structured completion, not a\n   * tracked run, and under `available: \"always\"` it fires often enough to flood\n   * run telemetry.\n   */\n  captureTelemetry?: boolean;\n  runtimeErrorReporter?: RuntimeErrorReporter;\n  startTime?: number;\n}\n\nexport function createSseEventResponse({\n  request,\n  observableFactory,\n  debugEventBus,\n  agentId,\n  debug,\n  logger,\n  telemetry = defaultTelemetry,\n  executionSeed,\n  captureTelemetry = true,\n  runtimeErrorReporter,\n  startTime,\n}: CreateSseEventResponseParams): Response {\n  const stream = new TransformStream();\n  const writer = stream.writable.getWriter();\n  const encoder = new EventEncoder();\n  let streamClosed = false;\n  let debugThreadId = \"\";\n  let debugRunId = \"\";\n\n  const debugLogger = debug?.enabled\n    ? (logger ??\n      createLogger({ level: \"debug\", component: \"copilotkit-debug\" }))\n    : undefined;\n\n  const closeStream = async () => {\n    if (!streamClosed) {\n      try {\n        await writer.close();\n        streamClosed = true;\n      } catch {\n        // Stream already closed.\n      }\n    }\n  };\n\n  const logError = (error: unknown) => {\n    console.error(\"Error running agent:\", error);\n    console.error(\n      \"Error stack:\",\n      error instanceof Error ? error.stack : \"No stack trace\",\n    );\n    console.error(\"Error details:\", {\n      name: error instanceof Error ? error.name : \"Unknown\",\n      message: error instanceof Error ? error.message : String(error),\n      cause: error instanceof Error ? error.cause : undefined,\n    });\n  };\n\n  let subscription: Subscription | undefined;\n  let agentErrorReported = false;\n\n  const reportAgentError = (error: unknown, phase: RuntimeErrorPhase) => {\n    if (agentErrorReported) return;\n    agentErrorReported = true;\n    runtimeErrorReporter?.report({\n      request,\n      error,\n      operation: \"agent.run\",\n      agentId,\n      threadId: debugThreadId || undefined,\n      runId: debugRunId || undefined,\n      phase,\n      startTime,\n    });\n  };\n\n  (async () => {\n    const observable = await observableFactory();\n\n    if (captureTelemetry) {\n      telemetry.capture(\"oss.runtime.agent_execution_stream_started\", {});\n    }\n\n    if (debug?.lifecycle) {\n      debugLogger!.debug(\"SSE stream opened\");\n    }\n\n    let eventCount = 0;\n    let loggedEventCount = 0;\n\n    // Provider/model/LangGraph facts, scraped off raw upstream events as\n    // they pass and reported once the stream finishes. This moved here from\n    // the v1 TelemetryAgentRunner, which wrapped the runner purely to\n    // collect it and emitted its own duplicate copy of every stream event\n    // to carry it. v2 callers had no equivalent and reported `{}`.\n    // Seeded rather than empty: `llmHostClass` comes from the agent's config,\n    // not from the wire, so nothing streamed will ever fill it in. Scraped\n    // fields still win, since `collectExecutionInfo` writes over this.\n    const executionInfo: AgentExecutionResponseInfo = { ...executionSeed };\n\n    subscription = observable.subscribe({\n      next: async (event) => {\n        collectExecutionInfo(event, executionInfo);\n\n        // Extract threadId/runId from RUN_STARTED\n        if (event.type === \"RUN_STARTED\") {\n          const e = event as { threadId?: string; runId?: string };\n          debugThreadId = e.threadId ?? \"\";\n          debugRunId = e.runId ?? \"\";\n        }\n\n        if (event.type === \"RUN_ERROR\") {\n          const e = event as {\n            message?: unknown;\n            threadId?: string;\n            runId?: string;\n          };\n          debugThreadId = e.threadId ?? debugThreadId;\n          debugRunId = e.runId ?? debugRunId;\n          reportAgentError(\n            new Error(\n              typeof e.message === \"string\"\n                ? e.message\n                : \"Runner reported a run error\",\n            ),\n            \"sse.subscription\",\n          );\n        }\n\n        // Broadcast to debug listeners BEFORE the stream-closed gate below.\n        // Intentional: debug subscribers (e.g. the VS Code Inspector panel)\n        // should still receive trailing events after the SSE client for\n        // this request closed its connection — they're independent\n        // consumers observing the underlying runtime, not the request's\n        // response stream.\n        //\n        // Wrapped in try/catch so a buggy debug subscriber can't propagate\n        // an exception into this observer — if the throw reached the\n        // `next` callback it would get routed to `error` by RxJS, closing\n        // the SSE stream for an unrelated reason. Log via `logError` and\n        // move on.\n        if (debugEventBus) {\n          try {\n            debugEventBus.broadcast(event, {\n              agentId: agentId ?? \"\",\n              threadId: debugThreadId,\n              runId: debugRunId,\n            });\n          } catch (broadcastError) {\n            logError(broadcastError);\n          }\n        }\n\n        if (!request.signal.aborted && !streamClosed) {\n          try {\n            eventCount++;\n            if (debug?.events) {\n              loggedEventCount++;\n              if (debug.verbose) {\n                debugLogger!.debug({ event }, \"Event emitted\");\n              } else {\n                debugLogger!.debug(\n                  { type: event.type, ...summarizeEvent(event) },\n                  \"Event emitted\",\n                );\n              }\n            }\n            await writer.write(encoder.encodeBinary(event));\n          } catch (error) {\n            if (error instanceof Error && error.name === \"AbortError\") {\n              streamClosed = true;\n            } else {\n              // Non-abort write failures (backpressure disconnects,\n              // transform-stream exceptions, …) were previously swallowed\n              // silently — `streamClosed` stayed `false` and the next\n              // event re-attempted a broken writer. Log and mark the\n              // stream closed so we stop trying.\n              logError(error);\n              streamClosed = true;\n            }\n          }\n        }\n      },\n      error: async (error) => {\n        reportAgentError(error, \"sse.subscription\");\n        if (captureTelemetry) {\n          telemetry.capture(\"oss.runtime.agent_execution_stream_errored\", {\n            ...executionInfo,\n            error: error instanceof Error ? error.message : String(error),\n          });\n        }\n        if (debug?.lifecycle) {\n          debugLogger!.debug(\n            { error: error instanceof Error ? error.message : String(error) },\n            \"SSE stream errored\",\n          );\n        }\n        logError(error);\n        await closeStream();\n      },\n      complete: async () => {\n        if (captureTelemetry) {\n          telemetry.capture(\n            \"oss.runtime.agent_execution_stream_ended\",\n            executionInfo,\n          );\n        }\n        if (debug?.lifecycle) {\n          debugLogger!.debug(\n            { eventCount, loggedEventCount },\n            \"SSE stream completed\",\n          );\n        }\n        await closeStream();\n      },\n    });\n\n    // If the client disconnected before the subscription was created,\n    // unsubscribe immediately to avoid leaking the observable.\n    if (request.signal.aborted) {\n      subscription.unsubscribe();\n    }\n  })().catch(async (error) => {\n    reportAgentError(error, \"sse.factory\");\n    logError(error);\n    await closeStream();\n  });\n\n  request.signal.addEventListener(\"abort\", () => {\n    subscription?.unsubscribe();\n  });\n\n  return new Response(stream.readable, {\n    status: 200,\n    headers: {\n      \"Content-Type\": \"text/event-stream\",\n      \"Cache-Control\": \"no-cache\",\n      Connection: \"keep-alive\",\n    },\n  });\n}\n\nfunction summarizeEvent(event: BaseEvent): Record<string, unknown> {\n  const e = event as any;\n  const summary: Record<string, unknown> = {};\n\n  if (e.messageId) summary.messageId = e.messageId;\n  if (e.toolCallId) summary.toolCallId = e.toolCallId;\n  if (e.toolCallName) summary.toolCallName = e.toolCallName;\n  if (e.role) summary.role = e.role;\n  if (e.delta != null && typeof e.delta === \"string\")\n    summary.deltaLength = e.delta.length;\n  if (e.snapshot && typeof e.snapshot === \"object\")\n    summary.snapshotKeys = Object.keys(e.snapshot);\n  if (e.delta && Array.isArray(e.delta))\n    summary.operationCount = e.delta.length;\n  if (e.threadId) summary.threadId = e.threadId;\n  if (e.runId) summary.runId = e.runId;\n  if (e.message) summary.message = e.message;\n  if (e.code) summary.code = e.code;\n  if (e.stepName) summary.stepName = e.stepName;\n\n  return summary;\n}\n\n/**\n * Accumulate provider, model, and LangGraph facts from one upstream event.\n *\n * Mutates rather than returns so the caller keeps one record across the whole\n * stream: these arrive on different events and the last one wins. Only fields\n * the upstream actually sent are set, so an agent that reports none leaves the\n * record empty and the stream events carry `{}` as before.\n *\n * `rawEvent` is the untransformed upstream payload, present on AG-UI events\n * that wrap one. Its shape is the provider's, not ours, hence the narrowing.\n */\nfunction collectExecutionInfo(\n  event: BaseEvent,\n  into: AgentExecutionResponseInfo,\n): void {\n  const rawEvent = (\n    event as {\n      rawEvent?: {\n        metadata?: Record<string, unknown>;\n        data?: Record<string, unknown>;\n      };\n    }\n  ).rawEvent;\n  if (!rawEvent) return;\n\n  const model = (rawEvent.data as { output?: { model?: string } } | undefined)\n    ?.output?.model;\n  if (model) {\n    into.model = model;\n    // Carried forward from the v1 implementation, which set both from the\n    // same field. The upstream sends no separate provider name.\n    into.provider = model;\n  }\n\n  const metadata = rawEvent.metadata as\n    | { langgraph_host?: string; langgraph_version?: string }\n    | undefined;\n  if (metadata?.langgraph_host) into.langGraphHost = metadata.langgraph_host;\n  if (metadata?.langgraph_version) {\n    into.langGraphVersion = metadata.langgraph_version;\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"sse-response.mjs","names":["defaultTelemetry"],"sources":["../../../../../src/v2/runtime/handlers/shared/sse-response.ts"],"sourcesContent":["import type { BaseEvent } from \"@ag-ui/client\";\nimport { EventEncoder } from \"@ag-ui/encoder\";\nimport type { Observable, Subscription } from \"rxjs\";\nimport {\n  keepAliveSse,\n  resolveSseKeepAliveIntervalSeconds,\n} from \"./sse-keep-alive\";\nimport type { ResolvedDebugConfig } from \"@copilotkit/shared\";\nimport { createLogger } from \"../../../../v1-deprecated/lib/logger\";\nimport type { CopilotRuntimeLogger } from \"../../../../v1-deprecated/lib/logger\";\nimport { telemetry as defaultTelemetry } from \"../../telemetry\";\nimport type { TelemetryCapture } from \"../../telemetry/telemetry-client\";\nimport type { AgentExecutionResponseInfo } from \"../../telemetry/events\";\nimport type { DebugEventBus } from \"../../core/debug-event-bus\";\nimport type {\n  RuntimeErrorPhase,\n  RuntimeErrorReporter,\n} from \"../../core/runtime-error-reporter\";\n\ninterface CreateSseEventResponseParams {\n  request: Request;\n  observableFactory: () =>\n    | Promise<Observable<BaseEvent>>\n    | Observable<BaseEvent>;\n  debugEventBus?: DebugEventBus;\n  agentId?: string;\n  debug?: ResolvedDebugConfig;\n  /** Pre-created logger instance to avoid creating a new pino logger per request. */\n  logger?: CopilotRuntimeLogger;\n  /** Runtime-bound telemetry capture. Falls back for external direct callers. */\n  telemetry?: TelemetryCapture;\n  /**\n   * Execution facts known before the stream opens, merged under anything the\n   * upstream reports as it runs. Carries `llmHostClass`, which is knowable\n   * from the agent's configuration and never appears on a streamed event.\n   */\n  executionSeed?: AgentExecutionResponseInfo;\n  /**\n   * Whether to emit `oss.runtime.agent_execution_stream_*` telemetry for this\n   * stream. Defaults to `true`. The stateless `/suggest` path sets this to\n   * `false`: a suggestion is a side-effect-free structured completion, not a\n   * tracked run, and under `available: \"always\"` it fires often enough to flood\n   * run telemetry.\n   */\n  captureTelemetry?: boolean;\n  runtimeErrorReporter?: RuntimeErrorReporter;\n  startTime?: number;\n  /**\n   * Seconds of silence before a `: keep-alive` SSE comment is written.\n   * `0` disables the keep-alive. Resolved by\n   * {@link resolveSseKeepAliveIntervalSeconds}, which supplies the default\n   * and enforces the timer bound for every caller.\n   */\n  keepAliveIntervalSeconds?: number;\n}\n\nexport function createSseEventResponse({\n  request,\n  observableFactory,\n  debugEventBus,\n  agentId,\n  debug,\n  logger,\n  telemetry = defaultTelemetry,\n  executionSeed,\n  captureTelemetry = true,\n  runtimeErrorReporter,\n  startTime,\n  keepAliveIntervalSeconds,\n}: CreateSseEventResponseParams): Response {\n  const keepAliveSeconds = resolveSseKeepAliveIntervalSeconds(\n    keepAliveIntervalSeconds,\n  );\n  const stream = new TransformStream();\n  const writer = stream.writable.getWriter();\n  const encoder = new EventEncoder();\n  let streamClosed = false;\n  let debugThreadId = \"\";\n  let debugRunId = \"\";\n\n  const debugLogger = debug?.enabled\n    ? (logger ??\n      createLogger({ level: \"debug\", component: \"copilotkit-debug\" }))\n    : undefined;\n\n  const closeStream = async () => {\n    if (!streamClosed) {\n      try {\n        await writer.close();\n        streamClosed = true;\n      } catch {\n        // Stream already closed.\n      }\n    }\n  };\n\n  const logError = (error: unknown) => {\n    console.error(\"Error running agent:\", error);\n    console.error(\n      \"Error stack:\",\n      error instanceof Error ? error.stack : \"No stack trace\",\n    );\n    console.error(\"Error details:\", {\n      name: error instanceof Error ? error.name : \"Unknown\",\n      message: error instanceof Error ? error.message : String(error),\n      cause: error instanceof Error ? error.cause : undefined,\n    });\n  };\n\n  let subscription: Subscription | undefined;\n  let agentErrorReported = false;\n\n  const reportAgentError = (error: unknown, phase: RuntimeErrorPhase) => {\n    if (agentErrorReported) return;\n    agentErrorReported = true;\n    runtimeErrorReporter?.report({\n      request,\n      error,\n      operation: \"agent.run\",\n      agentId,\n      threadId: debugThreadId || undefined,\n      runId: debugRunId || undefined,\n      phase,\n      startTime,\n    });\n  };\n\n  (async () => {\n    const observable = await observableFactory();\n\n    if (captureTelemetry) {\n      telemetry.capture(\"oss.runtime.agent_execution_stream_started\", {});\n    }\n\n    if (debug?.lifecycle) {\n      debugLogger!.debug(\"SSE stream opened\");\n    }\n\n    let eventCount = 0;\n    let loggedEventCount = 0;\n\n    // Provider/model/LangGraph facts, scraped off raw upstream events as\n    // they pass and reported once the stream finishes. This moved here from\n    // the v1 TelemetryAgentRunner, which wrapped the runner purely to\n    // collect it and emitted its own duplicate copy of every stream event\n    // to carry it. v2 callers had no equivalent and reported `{}`.\n    // Seeded rather than empty: `llmHostClass` comes from the agent's config,\n    // not from the wire, so nothing streamed will ever fill it in. Scraped\n    // fields still win, since `collectExecutionInfo` writes over this.\n    const executionInfo: AgentExecutionResponseInfo = { ...executionSeed };\n\n    subscription = observable.subscribe({\n      next: async (event) => {\n        collectExecutionInfo(event, executionInfo);\n\n        // Extract threadId/runId from RUN_STARTED\n        if (event.type === \"RUN_STARTED\") {\n          const e = event as { threadId?: string; runId?: string };\n          debugThreadId = e.threadId ?? \"\";\n          debugRunId = e.runId ?? \"\";\n        }\n\n        if (event.type === \"RUN_ERROR\") {\n          const e = event as {\n            message?: unknown;\n            threadId?: string;\n            runId?: string;\n          };\n          debugThreadId = e.threadId ?? debugThreadId;\n          debugRunId = e.runId ?? debugRunId;\n          reportAgentError(\n            new Error(\n              typeof e.message === \"string\"\n                ? e.message\n                : \"Runner reported a run error\",\n            ),\n            \"sse.subscription\",\n          );\n        }\n\n        // Broadcast to debug listeners BEFORE the stream-closed gate below.\n        // Intentional: debug subscribers (e.g. the VS Code Inspector panel)\n        // should still receive trailing events after the SSE client for\n        // this request closed its connection — they're independent\n        // consumers observing the underlying runtime, not the request's\n        // response stream.\n        //\n        // Wrapped in try/catch so a buggy debug subscriber can't propagate\n        // an exception into this observer — if the throw reached the\n        // `next` callback it would get routed to `error` by RxJS, closing\n        // the SSE stream for an unrelated reason. Log via `logError` and\n        // move on.\n        if (debugEventBus) {\n          try {\n            debugEventBus.broadcast(event, {\n              agentId: agentId ?? \"\",\n              threadId: debugThreadId,\n              runId: debugRunId,\n            });\n          } catch (broadcastError) {\n            logError(broadcastError);\n          }\n        }\n\n        if (!request.signal.aborted && !streamClosed) {\n          try {\n            eventCount++;\n            if (debug?.events) {\n              loggedEventCount++;\n              if (debug.verbose) {\n                debugLogger!.debug({ event }, \"Event emitted\");\n              } else {\n                debugLogger!.debug(\n                  { type: event.type, ...summarizeEvent(event) },\n                  \"Event emitted\",\n                );\n              }\n            }\n            await writer.write(encoder.encodeBinary(event));\n          } catch (error) {\n            if (error instanceof Error && error.name === \"AbortError\") {\n              streamClosed = true;\n            } else {\n              // Non-abort write failures (backpressure disconnects,\n              // transform-stream exceptions, …) were previously swallowed\n              // silently — `streamClosed` stayed `false` and the next\n              // event re-attempted a broken writer. Log and mark the\n              // stream closed so we stop trying.\n              logError(error);\n              streamClosed = true;\n            }\n          }\n        }\n      },\n      error: async (error) => {\n        reportAgentError(error, \"sse.subscription\");\n        if (captureTelemetry) {\n          telemetry.capture(\"oss.runtime.agent_execution_stream_errored\", {\n            ...executionInfo,\n            error: error instanceof Error ? error.message : String(error),\n          });\n        }\n        if (debug?.lifecycle) {\n          debugLogger!.debug(\n            { error: error instanceof Error ? error.message : String(error) },\n            \"SSE stream errored\",\n          );\n        }\n        logError(error);\n        await closeStream();\n      },\n      complete: async () => {\n        if (captureTelemetry) {\n          telemetry.capture(\n            \"oss.runtime.agent_execution_stream_ended\",\n            executionInfo,\n          );\n        }\n        if (debug?.lifecycle) {\n          debugLogger!.debug(\n            { eventCount, loggedEventCount },\n            \"SSE stream completed\",\n          );\n        }\n        await closeStream();\n      },\n    });\n\n    // If the client disconnected before the subscription was created,\n    // unsubscribe immediately to avoid leaking the observable.\n    if (request.signal.aborted) {\n      subscription.unsubscribe();\n    }\n  })().catch(async (error) => {\n    reportAgentError(error, \"sse.factory\");\n    logError(error);\n    await closeStream();\n  });\n\n  request.signal.addEventListener(\"abort\", () => {\n    subscription?.unsubscribe();\n  });\n\n  const body =\n    keepAliveSeconds > 0\n      ? keepAliveSse(stream.readable, keepAliveSeconds * 1_000)\n      : stream.readable;\n\n  return new Response(body, {\n    status: 200,\n    headers: {\n      \"Content-Type\": \"text/event-stream\",\n      \"Cache-Control\": \"no-cache\",\n      Connection: \"keep-alive\",\n    },\n  });\n}\n\nfunction summarizeEvent(event: BaseEvent): Record<string, unknown> {\n  const e = event as any;\n  const summary: Record<string, unknown> = {};\n\n  if (e.messageId) summary.messageId = e.messageId;\n  if (e.toolCallId) summary.toolCallId = e.toolCallId;\n  if (e.toolCallName) summary.toolCallName = e.toolCallName;\n  if (e.role) summary.role = e.role;\n  if (e.delta != null && typeof e.delta === \"string\")\n    summary.deltaLength = e.delta.length;\n  if (e.snapshot && typeof e.snapshot === \"object\")\n    summary.snapshotKeys = Object.keys(e.snapshot);\n  if (e.delta && Array.isArray(e.delta))\n    summary.operationCount = e.delta.length;\n  if (e.threadId) summary.threadId = e.threadId;\n  if (e.runId) summary.runId = e.runId;\n  if (e.message) summary.message = e.message;\n  if (e.code) summary.code = e.code;\n  if (e.stepName) summary.stepName = e.stepName;\n\n  return summary;\n}\n\n/**\n * Accumulate provider, model, and LangGraph facts from one upstream event.\n *\n * Mutates rather than returns so the caller keeps one record across the whole\n * stream: these arrive on different events and the last one wins. Only fields\n * the upstream actually sent are set, so an agent that reports none leaves the\n * record empty and the stream events carry `{}` as before.\n *\n * `rawEvent` is the untransformed upstream payload, present on AG-UI events\n * that wrap one. Its shape is the provider's, not ours, hence the narrowing.\n */\nfunction collectExecutionInfo(\n  event: BaseEvent,\n  into: AgentExecutionResponseInfo,\n): void {\n  const rawEvent = (\n    event as {\n      rawEvent?: {\n        metadata?: Record<string, unknown>;\n        data?: Record<string, unknown>;\n      };\n    }\n  ).rawEvent;\n  if (!rawEvent) return;\n\n  const model = (rawEvent.data as { output?: { model?: string } } | undefined)\n    ?.output?.model;\n  if (model) {\n    into.model = model;\n    // Carried forward from the v1 implementation, which set both from the\n    // same field. The upstream sends no separate provider name.\n    into.provider = model;\n  }\n\n  const metadata = rawEvent.metadata as\n    | { langgraph_host?: string; langgraph_version?: string }\n    | undefined;\n  if (metadata?.langgraph_host) into.langGraphHost = metadata.langgraph_host;\n  if (metadata?.langgraph_version) {\n    into.langGraphVersion = metadata.langgraph_version;\n  }\n}\n"],"mappings":"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"}

package/dist/v2/runtime/handlers/sse/connect.cjs

@@ -9,6 +9,7 @@ function handleSseConnect({ runtime, request, agentId, threadId, agent }) {
 		debugEventBus: runtime.debugEventBus,
 		agentId,
 		telemetry: runtime.telemetry,
+		keepAliveIntervalSeconds: runtime.sseKeepAliveIntervalSeconds,
 		observableFactory: () => runtime.runner.connect({
 			threadId,
 			agentId,

package/dist/v2/runtime/handlers/sse/connect.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"connect.cjs","names":["createSseEventResponse","mergeForwardableHeaders","resolveForwardHeadersPolicy"],"sources":["../../../../../src/v2/runtime/handlers/sse/connect.ts"],"sourcesContent":["import type { AbstractAgent } from \"@ag-ui/client\";\nimport type { CopilotRuntimeLike } from \"../../core/runtime\";\nimport { createSseEventResponse } from \"../shared/sse-response\";\nimport {\n  mergeForwardableHeaders,\n  resolveForwardHeadersPolicy,\n} from \"../header-utils\";\n\n/**\n * `headers` lives on the HTTP-backed agent configs (e.g. `HttpAgent`), not on\n * the base `AbstractAgent`. Mirror the runtime's own optional-headers shape so\n * we can read server-configured headers off the per-request clone without a\n * cast. See `agent-utils.ts`.\n */\ntype AgentWithHeaders = AbstractAgent & {\n  headers?: Record<string, string>;\n};\n\ninterface HandleSseConnectParams {\n  runtime: CopilotRuntimeLike;\n  request: Request;\n  agentId: string;\n  threadId: string;\n  /**\n   * The per-request agent clone, carrying any server-configured `agent.headers`\n   * (e.g. service-to-service auth). Used only to compute the merged header set\n   * threaded into `runner.connect` below — see the note there for why that\n   * merge is forward-looking plumbing rather than active outbound auth today.\n   */\n  agent?: AgentWithHeaders;\n}\n\nexport function handleSseConnect({\n  runtime,\n  request,\n  agentId,\n  threadId,\n  agent,\n}: HandleSseConnectParams): Response {\n  return createSseEventResponse({\n    request,\n    debugEventBus: runtime.debugEventBus,\n    // Forward the real agentId so debug envelopes reflect the agent the\n    // route resolved to — not the literal string \"connect\".\n    agentId,\n    telemetry: runtime.telemetry,\n    observableFactory: () =>\n      runtime.runner.connect({\n        threadId,\n        agentId,\n        // Forward-looking plumbing: we compute the merged header set (server\n        // `agent.headers` win on collision, case-insensitively; non-colliding\n        // inbound headers still forward — see `mergeForwardableHeaders`, #5712)\n        // and thread it into `runner.connect`. NO shipped runner consumes the\n        // `headers` field of `AgentRunnerConnectRequest` today — every runner\n        // (in-memory, intelligence, telemetry, sqlite) reads only `threadId`.\n        // The real outbound header forwarding is the /run path, where\n        // `cloneAgentForRequest` mutates `agent.headers` directly\n        // (agent-utils.ts). This wiring exists so a future outbound-connecting\n        // runner can pick the merged headers up without a route change; the\n        // collision precedence noted here is purely about that merge, not about\n        // middleware/mutation parity with /run.\n        headers: mergeForwardableHeaders(\n          agent?.headers,\n          request,\n          // Optional on `CopilotRuntimeLike` (non-breaking minor release);\n          // coalesce a policy-less external implementor to the default resolved\n          // policy (default-on denylist) instead of dereffing undefined.\n          runtime.forwardHeadersPolicy ??\n            resolveForwardHeadersPolicy(undefined),\n        ),\n      }),\n  });\n}\n"],"mappings":";;;;;AAgCA,SAAgB,iBAAiB,EAC/B,SACA,SACA,SACA,UACA,SACmC;AACnC,QAAOA,4CAAuB;EAC5B;EACA,eAAe,QAAQ;EAGvB;EACA,WAAW,QAAQ;EACnB,yBACE,QAAQ,OAAO,QAAQ;GACrB;GACA;GAaA,SAASC,6CACP,OAAO,SACP,SAIA,QAAQ,wBACNC,iDAA4B,OAAU,CACzC;GACF,CAAC;EACL,CAAC"}
+{"version":3,"file":"connect.cjs","names":["createSseEventResponse","mergeForwardableHeaders","resolveForwardHeadersPolicy"],"sources":["../../../../../src/v2/runtime/handlers/sse/connect.ts"],"sourcesContent":["import type { AbstractAgent } from \"@ag-ui/client\";\nimport type { CopilotRuntimeLike } from \"../../core/runtime\";\nimport { createSseEventResponse } from \"../shared/sse-response\";\nimport {\n  mergeForwardableHeaders,\n  resolveForwardHeadersPolicy,\n} from \"../header-utils\";\n\n/**\n * `headers` lives on the HTTP-backed agent configs (e.g. `HttpAgent`), not on\n * the base `AbstractAgent`. Mirror the runtime's own optional-headers shape so\n * we can read server-configured headers off the per-request clone without a\n * cast. See `agent-utils.ts`.\n */\ntype AgentWithHeaders = AbstractAgent & {\n  headers?: Record<string, string>;\n};\n\ninterface HandleSseConnectParams {\n  runtime: CopilotRuntimeLike;\n  request: Request;\n  agentId: string;\n  threadId: string;\n  /**\n   * The per-request agent clone, carrying any server-configured `agent.headers`\n   * (e.g. service-to-service auth). Used only to compute the merged header set\n   * threaded into `runner.connect` below — see the note there for why that\n   * merge is forward-looking plumbing rather than active outbound auth today.\n   */\n  agent?: AgentWithHeaders;\n}\n\nexport function handleSseConnect({\n  runtime,\n  request,\n  agentId,\n  threadId,\n  agent,\n}: HandleSseConnectParams): Response {\n  return createSseEventResponse({\n    request,\n    debugEventBus: runtime.debugEventBus,\n    // Forward the real agentId so debug envelopes reflect the agent the\n    // route resolved to — not the literal string \"connect\".\n    agentId,\n    telemetry: runtime.telemetry,\n    keepAliveIntervalSeconds: runtime.sseKeepAliveIntervalSeconds,\n    observableFactory: () =>\n      runtime.runner.connect({\n        threadId,\n        agentId,\n        // Forward-looking plumbing: we compute the merged header set (server\n        // `agent.headers` win on collision, case-insensitively; non-colliding\n        // inbound headers still forward — see `mergeForwardableHeaders`, #5712)\n        // and thread it into `runner.connect`. NO shipped runner consumes the\n        // `headers` field of `AgentRunnerConnectRequest` today — every runner\n        // (in-memory, intelligence, telemetry, sqlite) reads only `threadId`.\n        // The real outbound header forwarding is the /run path, where\n        // `cloneAgentForRequest` mutates `agent.headers` directly\n        // (agent-utils.ts). This wiring exists so a future outbound-connecting\n        // runner can pick the merged headers up without a route change; the\n        // collision precedence noted here is purely about that merge, not about\n        // middleware/mutation parity with /run.\n        headers: mergeForwardableHeaders(\n          agent?.headers,\n          request,\n          // Optional on `CopilotRuntimeLike` (non-breaking minor release);\n          // coalesce a policy-less external implementor to the default resolved\n          // policy (default-on denylist) instead of dereffing undefined.\n          runtime.forwardHeadersPolicy ??\n            resolveForwardHeadersPolicy(undefined),\n        ),\n      }),\n  });\n}\n"],"mappings":";;;;;AAgCA,SAAgB,iBAAiB,EAC/B,SACA,SACA,SACA,UACA,SACmC;AACnC,QAAOA,4CAAuB;EAC5B;EACA,eAAe,QAAQ;EAGvB;EACA,WAAW,QAAQ;EACnB,0BAA0B,QAAQ;EAClC,yBACE,QAAQ,OAAO,QAAQ;GACrB;GACA;GAaA,SAASC,6CACP,OAAO,SACP,SAIA,QAAQ,wBACNC,iDAA4B,OAAU,CACzC;GACF,CAAC;EACL,CAAC"}

package/dist/v2/runtime/handlers/sse/connect.mjs

@@ -9,6 +9,7 @@ function handleSseConnect({ runtime, request, agentId, threadId, agent }) {
 		debugEventBus: runtime.debugEventBus,
 		agentId,
 		telemetry: runtime.telemetry,
+		keepAliveIntervalSeconds: runtime.sseKeepAliveIntervalSeconds,
 		observableFactory: () => runtime.runner.connect({
 			threadId,
 			agentId,

package/dist/v2/runtime/handlers/sse/connect.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"connect.mjs","names":[],"sources":["../../../../../src/v2/runtime/handlers/sse/connect.ts"],"sourcesContent":["import type { AbstractAgent } from \"@ag-ui/client\";\nimport type { CopilotRuntimeLike } from \"../../core/runtime\";\nimport { createSseEventResponse } from \"../shared/sse-response\";\nimport {\n  mergeForwardableHeaders,\n  resolveForwardHeadersPolicy,\n} from \"../header-utils\";\n\n/**\n * `headers` lives on the HTTP-backed agent configs (e.g. `HttpAgent`), not on\n * the base `AbstractAgent`. Mirror the runtime's own optional-headers shape so\n * we can read server-configured headers off the per-request clone without a\n * cast. See `agent-utils.ts`.\n */\ntype AgentWithHeaders = AbstractAgent & {\n  headers?: Record<string, string>;\n};\n\ninterface HandleSseConnectParams {\n  runtime: CopilotRuntimeLike;\n  request: Request;\n  agentId: string;\n  threadId: string;\n  /**\n   * The per-request agent clone, carrying any server-configured `agent.headers`\n   * (e.g. service-to-service auth). Used only to compute the merged header set\n   * threaded into `runner.connect` below — see the note there for why that\n   * merge is forward-looking plumbing rather than active outbound auth today.\n   */\n  agent?: AgentWithHeaders;\n}\n\nexport function handleSseConnect({\n  runtime,\n  request,\n  agentId,\n  threadId,\n  agent,\n}: HandleSseConnectParams): Response {\n  return createSseEventResponse({\n    request,\n    debugEventBus: runtime.debugEventBus,\n    // Forward the real agentId so debug envelopes reflect the agent the\n    // route resolved to — not the literal string \"connect\".\n    agentId,\n    telemetry: runtime.telemetry,\n    observableFactory: () =>\n      runtime.runner.connect({\n        threadId,\n        agentId,\n        // Forward-looking plumbing: we compute the merged header set (server\n        // `agent.headers` win on collision, case-insensitively; non-colliding\n        // inbound headers still forward — see `mergeForwardableHeaders`, #5712)\n        // and thread it into `runner.connect`. NO shipped runner consumes the\n        // `headers` field of `AgentRunnerConnectRequest` today — every runner\n        // (in-memory, intelligence, telemetry, sqlite) reads only `threadId`.\n        // The real outbound header forwarding is the /run path, where\n        // `cloneAgentForRequest` mutates `agent.headers` directly\n        // (agent-utils.ts). This wiring exists so a future outbound-connecting\n        // runner can pick the merged headers up without a route change; the\n        // collision precedence noted here is purely about that merge, not about\n        // middleware/mutation parity with /run.\n        headers: mergeForwardableHeaders(\n          agent?.headers,\n          request,\n          // Optional on `CopilotRuntimeLike` (non-breaking minor release);\n          // coalesce a policy-less external implementor to the default resolved\n          // policy (default-on denylist) instead of dereffing undefined.\n          runtime.forwardHeadersPolicy ??\n            resolveForwardHeadersPolicy(undefined),\n        ),\n      }),\n  });\n}\n"],"mappings":";;;;;AAgCA,SAAgB,iBAAiB,EAC/B,SACA,SACA,SACA,UACA,SACmC;AACnC,QAAO,uBAAuB;EAC5B;EACA,eAAe,QAAQ;EAGvB;EACA,WAAW,QAAQ;EACnB,yBACE,QAAQ,OAAO,QAAQ;GACrB;GACA;GAaA,SAAS,wBACP,OAAO,SACP,SAIA,QAAQ,wBACN,4BAA4B,OAAU,CACzC;GACF,CAAC;EACL,CAAC"}
+{"version":3,"file":"connect.mjs","names":[],"sources":["../../../../../src/v2/runtime/handlers/sse/connect.ts"],"sourcesContent":["import type { AbstractAgent } from \"@ag-ui/client\";\nimport type { CopilotRuntimeLike } from \"../../core/runtime\";\nimport { createSseEventResponse } from \"../shared/sse-response\";\nimport {\n  mergeForwardableHeaders,\n  resolveForwardHeadersPolicy,\n} from \"../header-utils\";\n\n/**\n * `headers` lives on the HTTP-backed agent configs (e.g. `HttpAgent`), not on\n * the base `AbstractAgent`. Mirror the runtime's own optional-headers shape so\n * we can read server-configured headers off the per-request clone without a\n * cast. See `agent-utils.ts`.\n */\ntype AgentWithHeaders = AbstractAgent & {\n  headers?: Record<string, string>;\n};\n\ninterface HandleSseConnectParams {\n  runtime: CopilotRuntimeLike;\n  request: Request;\n  agentId: string;\n  threadId: string;\n  /**\n   * The per-request agent clone, carrying any server-configured `agent.headers`\n   * (e.g. service-to-service auth). Used only to compute the merged header set\n   * threaded into `runner.connect` below — see the note there for why that\n   * merge is forward-looking plumbing rather than active outbound auth today.\n   */\n  agent?: AgentWithHeaders;\n}\n\nexport function handleSseConnect({\n  runtime,\n  request,\n  agentId,\n  threadId,\n  agent,\n}: HandleSseConnectParams): Response {\n  return createSseEventResponse({\n    request,\n    debugEventBus: runtime.debugEventBus,\n    // Forward the real agentId so debug envelopes reflect the agent the\n    // route resolved to — not the literal string \"connect\".\n    agentId,\n    telemetry: runtime.telemetry,\n    keepAliveIntervalSeconds: runtime.sseKeepAliveIntervalSeconds,\n    observableFactory: () =>\n      runtime.runner.connect({\n        threadId,\n        agentId,\n        // Forward-looking plumbing: we compute the merged header set (server\n        // `agent.headers` win on collision, case-insensitively; non-colliding\n        // inbound headers still forward — see `mergeForwardableHeaders`, #5712)\n        // and thread it into `runner.connect`. NO shipped runner consumes the\n        // `headers` field of `AgentRunnerConnectRequest` today — every runner\n        // (in-memory, intelligence, telemetry, sqlite) reads only `threadId`.\n        // The real outbound header forwarding is the /run path, where\n        // `cloneAgentForRequest` mutates `agent.headers` directly\n        // (agent-utils.ts). This wiring exists so a future outbound-connecting\n        // runner can pick the merged headers up without a route change; the\n        // collision precedence noted here is purely about that merge, not about\n        // middleware/mutation parity with /run.\n        headers: mergeForwardableHeaders(\n          agent?.headers,\n          request,\n          // Optional on `CopilotRuntimeLike` (non-breaking minor release);\n          // coalesce a policy-less external implementor to the default resolved\n          // policy (default-on denylist) instead of dereffing undefined.\n          runtime.forwardHeadersPolicy ??\n            resolveForwardHeadersPolicy(undefined),\n        ),\n      }),\n  });\n}\n"],"mappings":";;;;;AAgCA,SAAgB,iBAAiB,EAC/B,SACA,SACA,SACA,UACA,SACmC;AACnC,QAAO,uBAAuB;EAC5B;EACA,eAAe,QAAQ;EAGvB;EACA,WAAW,QAAQ;EACnB,0BAA0B,QAAQ;EAClC,yBACE,QAAQ,OAAO,QAAQ;GACrB;GACA;GAaA,SAAS,wBACP,OAAO,SACP,SAIA,QAAQ,wBACN,4BAA4B,OAAU,CACzC;GACF,CAAC;EACL,CAAC"}

package/dist/v2/runtime/handlers/sse/run.cjs

@@ -13,6 +13,7 @@ function handleSseRun({ runtime, request, agent, input, agentId, debug, logger,
 		runtimeErrorReporter: require_runtime_error_reporter.getRuntimeErrorReporter(runtime),
 		startTime,
 		telemetry: runtime.telemetry,
+		keepAliveIntervalSeconds: runtime.sseKeepAliveIntervalSeconds,
 		executionSeed: { llmHostClass: agent.modelHostClass ?? "unknown" },
 		observableFactory: () => runtime.runner.run({
 			threadId: input.threadId,

package/dist/v2/runtime/handlers/sse/run.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"run.cjs","names":["createSseEventResponse","getRuntimeErrorReporter"],"sources":["../../../../../src/v2/runtime/handlers/sse/run.ts"],"sourcesContent":["import type { AbstractAgent, RunAgentInput } from \"@ag-ui/client\";\nimport type { ResolvedDebugConfig, ModelHostClass } from \"@copilotkit/shared\";\nimport type { CopilotRuntimeLogger } from \"../../../../v1-deprecated/lib/logger\";\nimport type { CopilotRuntimeLike } from \"../../core/runtime\";\nimport { getRuntimeErrorReporter } from \"../../core/runtime-error-reporter\";\nimport { createSseEventResponse } from \"../shared/sse-response\";\n\ninterface HandleSseRunParams {\n  runtime: CopilotRuntimeLike;\n  request: Request;\n  agent: AbstractAgent;\n  input: RunAgentInput;\n  agentId: string;\n  debug?: ResolvedDebugConfig;\n  /** Pre-created logger instance to avoid creating a new pino logger per request. */\n  logger?: CopilotRuntimeLogger;\n  startTime?: number;\n}\n\nexport function handleSseRun({\n  runtime,\n  request,\n  agent,\n  input,\n  agentId,\n  debug,\n  logger,\n  startTime,\n}: HandleSseRunParams): Response {\n  return createSseEventResponse({\n    request,\n    debugEventBus: runtime.debugEventBus,\n    agentId,\n    debug,\n    logger,\n    runtimeErrorReporter: getRuntimeErrorReporter(runtime),\n    startTime,\n    telemetry: runtime.telemetry,\n    // Read structurally rather than via `instanceof BuiltInAgent`, which would\n    // pull the agent module into this handler. Any agent can opt in by\n    // exposing the same property.\n    executionSeed: {\n      llmHostClass:\n        (agent as { modelHostClass?: ModelHostClass }).modelHostClass ??\n        \"unknown\",\n    },\n    observableFactory: () =>\n      runtime.runner.run({\n        threadId: input.threadId,\n        agent,\n        input,\n      }),\n  });\n}\n"],"mappings":";;;;;AAmBA,SAAgB,aAAa,EAC3B,SACA,SACA,OACA,OACA,SACA,OACA,QACA,aAC+B;AAC/B,QAAOA,4CAAuB;EAC5B;EACA,eAAe,QAAQ;EACvB;EACA;EACA;EACA,sBAAsBC,uDAAwB,QAAQ;EACtD;EACA,WAAW,QAAQ;EAInB,eAAe,EACb,cACG,MAA8C,kBAC/C,WACH;EACD,yBACE,QAAQ,OAAO,IAAI;GACjB,UAAU,MAAM;GAChB;GACA;GACD,CAAC;EACL,CAAC"}
+{"version":3,"file":"run.cjs","names":["createSseEventResponse","getRuntimeErrorReporter"],"sources":["../../../../../src/v2/runtime/handlers/sse/run.ts"],"sourcesContent":["import type { AbstractAgent, RunAgentInput } from \"@ag-ui/client\";\nimport type { ResolvedDebugConfig, ModelHostClass } from \"@copilotkit/shared\";\nimport type { CopilotRuntimeLogger } from \"../../../../v1-deprecated/lib/logger\";\nimport type { CopilotRuntimeLike } from \"../../core/runtime\";\nimport { getRuntimeErrorReporter } from \"../../core/runtime-error-reporter\";\nimport { createSseEventResponse } from \"../shared/sse-response\";\n\ninterface HandleSseRunParams {\n  runtime: CopilotRuntimeLike;\n  request: Request;\n  agent: AbstractAgent;\n  input: RunAgentInput;\n  agentId: string;\n  debug?: ResolvedDebugConfig;\n  /** Pre-created logger instance to avoid creating a new pino logger per request. */\n  logger?: CopilotRuntimeLogger;\n  startTime?: number;\n}\n\nexport function handleSseRun({\n  runtime,\n  request,\n  agent,\n  input,\n  agentId,\n  debug,\n  logger,\n  startTime,\n}: HandleSseRunParams): Response {\n  return createSseEventResponse({\n    request,\n    debugEventBus: runtime.debugEventBus,\n    agentId,\n    debug,\n    logger,\n    runtimeErrorReporter: getRuntimeErrorReporter(runtime),\n    startTime,\n    telemetry: runtime.telemetry,\n    keepAliveIntervalSeconds: runtime.sseKeepAliveIntervalSeconds,\n    // Read structurally rather than via `instanceof BuiltInAgent`, which would\n    // pull the agent module into this handler. Any agent can opt in by\n    // exposing the same property.\n    executionSeed: {\n      llmHostClass:\n        (agent as { modelHostClass?: ModelHostClass }).modelHostClass ??\n        \"unknown\",\n    },\n    observableFactory: () =>\n      runtime.runner.run({\n        threadId: input.threadId,\n        agent,\n        input,\n      }),\n  });\n}\n"],"mappings":";;;;;AAmBA,SAAgB,aAAa,EAC3B,SACA,SACA,OACA,OACA,SACA,OACA,QACA,aAC+B;AAC/B,QAAOA,4CAAuB;EAC5B;EACA,eAAe,QAAQ;EACvB;EACA;EACA;EACA,sBAAsBC,uDAAwB,QAAQ;EACtD;EACA,WAAW,QAAQ;EACnB,0BAA0B,QAAQ;EAIlC,eAAe,EACb,cACG,MAA8C,kBAC/C,WACH;EACD,yBACE,QAAQ,OAAO,IAAI;GACjB,UAAU,MAAM;GAChB;GACA;GACD,CAAC;EACL,CAAC"}

package/dist/v2/runtime/handlers/sse/run.mjs

@@ -13,6 +13,7 @@ function handleSseRun({ runtime, request, agent, input, agentId, debug, logger,
 		runtimeErrorReporter: getRuntimeErrorReporter(runtime),
 		startTime,
 		telemetry: runtime.telemetry,
+		keepAliveIntervalSeconds: runtime.sseKeepAliveIntervalSeconds,
 		executionSeed: { llmHostClass: agent.modelHostClass ?? "unknown" },
 		observableFactory: () => runtime.runner.run({
 			threadId: input.threadId,

package/dist/v2/runtime/handlers/sse/run.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"run.mjs","names":[],"sources":["../../../../../src/v2/runtime/handlers/sse/run.ts"],"sourcesContent":["import type { AbstractAgent, RunAgentInput } from \"@ag-ui/client\";\nimport type { ResolvedDebugConfig, ModelHostClass } from \"@copilotkit/shared\";\nimport type { CopilotRuntimeLogger } from \"../../../../v1-deprecated/lib/logger\";\nimport type { CopilotRuntimeLike } from \"../../core/runtime\";\nimport { getRuntimeErrorReporter } from \"../../core/runtime-error-reporter\";\nimport { createSseEventResponse } from \"../shared/sse-response\";\n\ninterface HandleSseRunParams {\n  runtime: CopilotRuntimeLike;\n  request: Request;\n  agent: AbstractAgent;\n  input: RunAgentInput;\n  agentId: string;\n  debug?: ResolvedDebugConfig;\n  /** Pre-created logger instance to avoid creating a new pino logger per request. */\n  logger?: CopilotRuntimeLogger;\n  startTime?: number;\n}\n\nexport function handleSseRun({\n  runtime,\n  request,\n  agent,\n  input,\n  agentId,\n  debug,\n  logger,\n  startTime,\n}: HandleSseRunParams): Response {\n  return createSseEventResponse({\n    request,\n    debugEventBus: runtime.debugEventBus,\n    agentId,\n    debug,\n    logger,\n    runtimeErrorReporter: getRuntimeErrorReporter(runtime),\n    startTime,\n    telemetry: runtime.telemetry,\n    // Read structurally rather than via `instanceof BuiltInAgent`, which would\n    // pull the agent module into this handler. Any agent can opt in by\n    // exposing the same property.\n    executionSeed: {\n      llmHostClass:\n        (agent as { modelHostClass?: ModelHostClass }).modelHostClass ??\n        \"unknown\",\n    },\n    observableFactory: () =>\n      runtime.runner.run({\n        threadId: input.threadId,\n        agent,\n        input,\n      }),\n  });\n}\n"],"mappings":";;;;;AAmBA,SAAgB,aAAa,EAC3B,SACA,SACA,OACA,OACA,SACA,OACA,QACA,aAC+B;AAC/B,QAAO,uBAAuB;EAC5B;EACA,eAAe,QAAQ;EACvB;EACA;EACA;EACA,sBAAsB,wBAAwB,QAAQ;EACtD;EACA,WAAW,QAAQ;EAInB,eAAe,EACb,cACG,MAA8C,kBAC/C,WACH;EACD,yBACE,QAAQ,OAAO,IAAI;GACjB,UAAU,MAAM;GAChB;GACA;GACD,CAAC;EACL,CAAC"}
+{"version":3,"file":"run.mjs","names":[],"sources":["../../../../../src/v2/runtime/handlers/sse/run.ts"],"sourcesContent":["import type { AbstractAgent, RunAgentInput } from \"@ag-ui/client\";\nimport type { ResolvedDebugConfig, ModelHostClass } from \"@copilotkit/shared\";\nimport type { CopilotRuntimeLogger } from \"../../../../v1-deprecated/lib/logger\";\nimport type { CopilotRuntimeLike } from \"../../core/runtime\";\nimport { getRuntimeErrorReporter } from \"../../core/runtime-error-reporter\";\nimport { createSseEventResponse } from \"../shared/sse-response\";\n\ninterface HandleSseRunParams {\n  runtime: CopilotRuntimeLike;\n  request: Request;\n  agent: AbstractAgent;\n  input: RunAgentInput;\n  agentId: string;\n  debug?: ResolvedDebugConfig;\n  /** Pre-created logger instance to avoid creating a new pino logger per request. */\n  logger?: CopilotRuntimeLogger;\n  startTime?: number;\n}\n\nexport function handleSseRun({\n  runtime,\n  request,\n  agent,\n  input,\n  agentId,\n  debug,\n  logger,\n  startTime,\n}: HandleSseRunParams): Response {\n  return createSseEventResponse({\n    request,\n    debugEventBus: runtime.debugEventBus,\n    agentId,\n    debug,\n    logger,\n    runtimeErrorReporter: getRuntimeErrorReporter(runtime),\n    startTime,\n    telemetry: runtime.telemetry,\n    keepAliveIntervalSeconds: runtime.sseKeepAliveIntervalSeconds,\n    // Read structurally rather than via `instanceof BuiltInAgent`, which would\n    // pull the agent module into this handler. Any agent can opt in by\n    // exposing the same property.\n    executionSeed: {\n      llmHostClass:\n        (agent as { modelHostClass?: ModelHostClass }).modelHostClass ??\n        \"unknown\",\n    },\n    observableFactory: () =>\n      runtime.runner.run({\n        threadId: input.threadId,\n        agent,\n        input,\n      }),\n  });\n}\n"],"mappings":";;;;;AAmBA,SAAgB,aAAa,EAC3B,SACA,SACA,OACA,OACA,SACA,OACA,QACA,aAC+B;AAC/B,QAAO,uBAAuB;EAC5B;EACA,eAAe,QAAQ;EACvB;EACA;EACA;EACA,sBAAsB,wBAAwB,QAAQ;EACtD;EACA,WAAW,QAAQ;EACnB,0BAA0B,QAAQ;EAIlC,eAAe,EACb,cACG,MAA8C,kBAC/C,WACH;EACD,yBACE,QAAQ,OAAO,IAAI;GACjB,UAAU,MAAM;GAChB;GACA;GACD,CAAC;EACL,CAAC"}

package/dist/v2/runtime/index.d.cts

@@ -1,22 +1,22 @@
 
 import { TranscribeFileOptions, TranscriptionService } from "./transcription-service/transcription-service.cjs";
 import { AgentRunner, AgentRunnerConnectRequest, AgentRunnerIsRunningRequest, AgentRunnerRunRequest, AgentRunnerStopRequest, LocalThreadEndpointRecord, LocalThreadEndpointRunner, supportsLocalThreadEndpoints } from "./runner/agent-runner.cjs";
-import { CopilotRuntimeLearningConfig, CopilotRuntimeLearningContext, CopilotRuntimeUser, GetLearningContainerId, LearningContainerSelectorInput } from "./core/learning.cjs";
 import { GetLearnedSkillsSnapshotRequest, LearnedSkillsError, LearnedSkillsErrorCode, LearnedSkillsSnapshotResult } from "./intelligence-platform/learned-skills.cjs";
-import { CopilotKitIntelligence, CopilotKitIntelligenceConfig, CreateThreadRequest, ListThreadsResponse, SubscribeToThreadsRequest, SubscribeToThreadsResponse, ThreadSummary, UpdateThreadRequest } from "./intelligence-platform/client.cjs";
 import "./intelligence-platform/index.cjs";
 import { AgentFactoryContext, AgentsConfig, AgentsFactory, CopilotIntelligenceRuntime, CopilotIntelligenceRuntimeLike, CopilotIntelligenceRuntimeOptions, CopilotRuntime, CopilotRuntimeConstructor, CopilotRuntimeLike, CopilotRuntimeMemoryConfig, CopilotRuntimeOptions, CopilotSseRuntime, CopilotSseRuntimeLike, CopilotSseRuntimeOptions, IdentifyUserCallback, McpAppsConfig, McpAppsServerConfig, MemoryAccess, MemoryConsumer, MemoryGrant, OpenGenerativeUIConfig, OpenGenerativeUIOptions, RuntimeWithDeclaredChannels, VERSION, isA2UIEnabled, isIntelligenceRuntime, resolveAgents } from "./core/runtime.cjs";
-import { CopilotCorsConfig } from "./core/fetch-cors.cjs";
-import { CopilotRuntimeHooks, ErrorHookContext, HandlerHookContext, HookContext, ResponseHookContext, RouteInfo } from "./core/hooks.cjs";
+import { CopilotRuntimeLearningConfig, CopilotRuntimeLearningContext, CopilotRuntimeUser, GetLearningContainerId, LearningContainerSelectorInput } from "./core/learning.cjs";
+import { CopilotKitIntelligence, CopilotKitIntelligenceConfig, CreateThreadRequest, ListThreadsResponse, SubscribeToThreadsRequest, SubscribeToThreadsResponse, ThreadSummary, UpdateThreadRequest } from "./intelligence-platform/client.cjs";
+import { InMemoryAgentRunner, InMemoryAgentRunnerOptions, InMemoryLimits, InMemoryThread, ɵBoundedThreadStore, ɵGLOBAL_STORE, ɵINMEMORY_DEFAULTS, ɵestimateBytes, ɵnormalizeLimits } from "./runner/in-memory.cjs";
+import { IntelligenceAgentRunner, IntelligenceAgentRunnerOptions, RunnerStartupBoundary } from "./runner/intelligence.cjs";
+import { FinalizeRunOptions, RunEventFinalizer, createRunEventFinalizer, finalizeRunEvents } from "./runner/index.cjs";
 import { ChannelStatus, ChannelsControl } from "./core/channel-manager.cjs";
-import { CopilotEndpointCorsConfig, CopilotHonoApp, createCopilotEndpoint, createCopilotHonoHandler, toFetchCorsConfig } from "./endpoints/hono.cjs";
-import { createCopilotEndpointSingleRoute } from "./endpoints/hono-single.cjs";
+import { CopilotRuntimeHooks, ErrorHookContext, HandlerHookContext, HookContext, ResponseHookContext, RouteInfo } from "./core/hooks.cjs";
 import { CopilotExpressEndpointParams, CopilotExpressRouter, createCopilotExpressHandler } from "./endpoints/express.cjs";
 import { createCopilotEndpointSingleRouteExpress } from "./endpoints/express-single.cjs";
+import { CopilotCorsConfig } from "./core/fetch-cors.cjs";
+import { CopilotEndpointCorsConfig, CopilotHonoApp, createCopilotEndpoint, createCopilotHonoHandler, toFetchCorsConfig } from "./endpoints/hono.cjs";
+import { createCopilotEndpointSingleRoute } from "./endpoints/hono-single.cjs";
 import "./endpoints/index.cjs";
-import { InMemoryAgentRunner, InMemoryAgentRunnerOptions, InMemoryLimits, InMemoryThread, ɵBoundedThreadStore, ɵGLOBAL_STORE, ɵINMEMORY_DEFAULTS, ɵestimateBytes, ɵnormalizeLimits } from "./runner/in-memory.cjs";
-import { IntelligenceAgentRunner, IntelligenceAgentRunnerOptions, RunnerStartupBoundary } from "./runner/intelligence.cjs";
-import { finalizeRunEvents } from "./runner/index.cjs";
 import { CopilotRuntimeFetchHandler, CopilotRuntimeFetchHandlerWithChannels, CopilotRuntimeHandlerOptions, createCopilotRuntimeHandler } from "./core/fetch-handler.cjs";
 import { MCPClient, MCPTransport } from "@ai-sdk/mcp";
 

package/dist/v2/runtime/index.d.mts

@@ -1,22 +1,22 @@
 
 import { TranscribeFileOptions, TranscriptionService } from "./transcription-service/transcription-service.mjs";
 import { AgentRunner, AgentRunnerConnectRequest, AgentRunnerIsRunningRequest, AgentRunnerRunRequest, AgentRunnerStopRequest, LocalThreadEndpointRecord, LocalThreadEndpointRunner, supportsLocalThreadEndpoints } from "./runner/agent-runner.mjs";
-import { CopilotRuntimeLearningConfig, CopilotRuntimeLearningContext, CopilotRuntimeUser, GetLearningContainerId, LearningContainerSelectorInput } from "./core/learning.mjs";
 import { GetLearnedSkillsSnapshotRequest, LearnedSkillsError, LearnedSkillsErrorCode, LearnedSkillsSnapshotResult } from "./intelligence-platform/learned-skills.mjs";
-import { CopilotKitIntelligence, CopilotKitIntelligenceConfig, CreateThreadRequest, ListThreadsResponse, SubscribeToThreadsRequest, SubscribeToThreadsResponse, ThreadSummary, UpdateThreadRequest } from "./intelligence-platform/client.mjs";
 import "./intelligence-platform/index.mjs";
 import { AgentFactoryContext, AgentsConfig, AgentsFactory, CopilotIntelligenceRuntime, CopilotIntelligenceRuntimeLike, CopilotIntelligenceRuntimeOptions, CopilotRuntime, CopilotRuntimeConstructor, CopilotRuntimeLike, CopilotRuntimeMemoryConfig, CopilotRuntimeOptions, CopilotSseRuntime, CopilotSseRuntimeLike, CopilotSseRuntimeOptions, IdentifyUserCallback, McpAppsConfig, McpAppsServerConfig, MemoryAccess, MemoryConsumer, MemoryGrant, OpenGenerativeUIConfig, OpenGenerativeUIOptions, RuntimeWithDeclaredChannels, VERSION, isA2UIEnabled, isIntelligenceRuntime, resolveAgents } from "./core/runtime.mjs";
-import { CopilotCorsConfig } from "./core/fetch-cors.mjs";
-import { CopilotRuntimeHooks, ErrorHookContext, HandlerHookContext, HookContext, ResponseHookContext, RouteInfo } from "./core/hooks.mjs";
+import { CopilotRuntimeLearningConfig, CopilotRuntimeLearningContext, CopilotRuntimeUser, GetLearningContainerId, LearningContainerSelectorInput } from "./core/learning.mjs";
+import { CopilotKitIntelligence, CopilotKitIntelligenceConfig, CreateThreadRequest, ListThreadsResponse, SubscribeToThreadsRequest, SubscribeToThreadsResponse, ThreadSummary, UpdateThreadRequest } from "./intelligence-platform/client.mjs";
+import { InMemoryAgentRunner, InMemoryAgentRunnerOptions, InMemoryLimits, InMemoryThread, ɵBoundedThreadStore, ɵGLOBAL_STORE, ɵINMEMORY_DEFAULTS, ɵestimateBytes, ɵnormalizeLimits } from "./runner/in-memory.mjs";
+import { IntelligenceAgentRunner, IntelligenceAgentRunnerOptions, RunnerStartupBoundary } from "./runner/intelligence.mjs";
+import { FinalizeRunOptions, RunEventFinalizer, createRunEventFinalizer, finalizeRunEvents } from "./runner/index.mjs";
 import { ChannelStatus, ChannelsControl } from "./core/channel-manager.mjs";
-import { CopilotEndpointCorsConfig, CopilotHonoApp, createCopilotEndpoint, createCopilotHonoHandler, toFetchCorsConfig } from "./endpoints/hono.mjs";
-import { createCopilotEndpointSingleRoute } from "./endpoints/hono-single.mjs";
+import { CopilotRuntimeHooks, ErrorHookContext, HandlerHookContext, HookContext, ResponseHookContext, RouteInfo } from "./core/hooks.mjs";
 import { CopilotExpressEndpointParams, CopilotExpressRouter, createCopilotExpressHandler } from "./endpoints/express.mjs";
 import { createCopilotEndpointSingleRouteExpress } from "./endpoints/express-single.mjs";
+import { CopilotCorsConfig } from "./core/fetch-cors.mjs";
+import { CopilotEndpointCorsConfig, CopilotHonoApp, createCopilotEndpoint, createCopilotHonoHandler, toFetchCorsConfig } from "./endpoints/hono.mjs";
+import { createCopilotEndpointSingleRoute } from "./endpoints/hono-single.mjs";
 import "./endpoints/index.mjs";
-import { InMemoryAgentRunner, InMemoryAgentRunnerOptions, InMemoryLimits, InMemoryThread, ɵBoundedThreadStore, ɵGLOBAL_STORE, ɵINMEMORY_DEFAULTS, ɵestimateBytes, ɵnormalizeLimits } from "./runner/in-memory.mjs";
-import { IntelligenceAgentRunner, IntelligenceAgentRunnerOptions, RunnerStartupBoundary } from "./runner/intelligence.mjs";
-import { finalizeRunEvents } from "./runner/index.mjs";
 import { CopilotRuntimeFetchHandler, CopilotRuntimeFetchHandlerWithChannels, CopilotRuntimeHandlerOptions, createCopilotRuntimeHandler } from "./core/fetch-handler.mjs";
 import { MCPClient, MCPTransport } from "@ai-sdk/mcp";
 

package/dist/v2/runtime/intelligence-platform/client.cjs

@@ -2,8 +2,8 @@ require("reflect-metadata");
 const require_runtime = require('../../../_virtual/_rolldown/runtime.cjs');
 const require_learned_skills = require('./learned-skills.cjs');
 let _copilotkit_shared = require("@copilotkit/shared");
-let crypto = require("crypto");
 let zod = require("zod");
+let crypto = require("crypto");
 
 //#region src/v2/runtime/intelligence-platform/client.ts
 /** Let a confirmed HTTP denial survive an error body that never completes. */

package/dist/v2/runtime/intelligence-platform/client.d.cts

@@ -1,6 +1,6 @@
 
-import { GetLearningContainerId } from "../core/learning.cjs";
 import { GetLearnedSkillsSnapshotRequest, LearnedSkillsSnapshotResult } from "./learned-skills.cjs";
+import { GetLearningContainerId } from "../core/learning.cjs";
 import { InspectorLearningRequestV1, InspectorLearningSnapshotV1, InspectorMetadataV1, RuntimeEntitlementResponse } from "@copilotkit/shared";
 
 //#region src/v2/runtime/intelligence-platform/client.d.ts

package/dist/v2/runtime/intelligence-platform/client.d.mts

@@ -1,6 +1,6 @@
 
-import { GetLearningContainerId } from "../core/learning.mjs";
 import { GetLearnedSkillsSnapshotRequest, LearnedSkillsSnapshotResult } from "./learned-skills.mjs";
+import { GetLearningContainerId } from "../core/learning.mjs";
 import { InspectorLearningRequestV1, InspectorLearningSnapshotV1, InspectorMetadataV1, RuntimeEntitlementResponse } from "@copilotkit/shared";
 
 //#region src/v2/runtime/intelligence-platform/client.d.ts

package/dist/v2/runtime/intelligence-platform/client.mjs

@@ -1,8 +1,8 @@
 import "reflect-metadata";
 import { LearnedSkillsError, learnedSkillsResponseError } from "./learned-skills.mjs";
 import { logger, parseInspectorLearningSnapshotV1, parseInspectorMetadataV1 } from "@copilotkit/shared";
-import { randomUUID as randomUUID$1 } from "crypto";
 import { z } from "zod";
+import { randomUUID as randomUUID$1 } from "crypto";
 
 //#region src/v2/runtime/intelligence-platform/client.ts
 /** Let a confirmed HTTP denial survive an error body that never completes. */

package/dist/v2/runtime/intelligence-platform/skill-registry/archive.cjs

@@ -0,0 +1,132 @@
+require("reflect-metadata");
+const require_runtime = require('../../../../_virtual/_rolldown/runtime.cjs');
+const require_errors = require('./errors.cjs');
+let yauzl = require("yauzl");
+
+//#region src/v2/runtime/intelligence-platform/skill-registry/archive.ts
+/** Internal corruption bounds, including manifest and directory entries. */
+const MAX_ARCHIVE_ENTRIES = 1e3;
+const MAX_SNAPSHOT_BYTES = 32 * 1024 * 1024;
+function safeRelativePath(path) {
+	return path.length > 0 && !/[\\\x00-\x1f\x7f]/.test(path) && !/^[a-z]:/i.test(path) && path.split("/").every((part) => part !== "" && part !== "." && part !== "..");
+}
+/** Decode only the listed ZIP namespace. No filesystem is involved. */
+function readArchive(bytes, signal) {
+	return new Promise((resolve, reject) => {
+		let archive;
+		let stream;
+		let settled = false;
+		const finish = (error) => {
+			if (settled) return;
+			settled = true;
+			signal?.removeEventListener("abort", abort);
+			stream?.destroy();
+			archive?.close();
+			if (error !== void 0) reject(error);
+			else resolve(files);
+		};
+		const abort = () => finish(signal?.reason ?? require_errors.invalidSnapshot());
+		const files = /* @__PURE__ */ new Map();
+		const names = /* @__PURE__ */ new Set();
+		let decodedBytes = 0;
+		signal?.addEventListener("abort", abort, { once: true });
+		if (signal?.aborted) {
+			abort();
+			return;
+		}
+		(0, yauzl.fromBuffer)(bytes, {
+			lazyEntries: true,
+			decodeStrings: false,
+			validateEntrySizes: true,
+			autoClose: false
+		}, (error, zip) => {
+			if (error) {
+				finish(require_errors.invalidSnapshot(error));
+				return;
+			}
+			archive = zip;
+			if (settled) {
+				zip.close();
+				return;
+			}
+			zip.on("error", (cause) => finish(require_errors.invalidSnapshot(cause)));
+			zip.on("end", () => finish());
+			if (zip.entryCount > MAX_ARCHIVE_ENTRIES) {
+				finish(require_errors.invalidSnapshot());
+				return;
+			}
+			zip.on("entry", (entry) => {
+				try {
+					const rawName = entry.fileName;
+					if (!Buffer.isBuffer(rawName)) throw require_errors.invalidSnapshot();
+					const name = new TextDecoder("utf-8", {
+						fatal: true,
+						ignoreBOM: true
+					}).decode(rawName);
+					const directory = name.endsWith("/");
+					if (!safeRelativePath(directory ? name.slice(0, -1) : name) || names.has(name)) throw require_errors.invalidSnapshot();
+					names.add(name);
+					const fileType = entry.externalFileAttributes >>> 16 & 61440;
+					if (fileType !== 0 && fileType !== (directory ? 16384 : 32768)) throw require_errors.invalidSnapshot();
+					if (entry.isEncrypted() || ![0, 8].includes(entry.compressionMethod)) throw require_errors.invalidSnapshot();
+					if (!Number.isSafeInteger(entry.uncompressedSize) || entry.uncompressedSize < 0) throw require_errors.invalidSnapshot();
+					decodedBytes += entry.uncompressedSize;
+					if (decodedBytes > MAX_SNAPSHOT_BYTES || directory && entry.uncompressedSize !== 0) throw require_errors.invalidSnapshot();
+					const local = entry.relativeOffsetOfLocalHeader;
+					if (local < 0 || local + 30 > bytes.length || bytes.readUInt32LE(local) !== 67324752) throw require_errors.invalidSnapshot();
+					if (bytes.readUInt16LE(local + 6) !== entry.generalPurposeBitFlag || bytes.readUInt16LE(local + 8) !== entry.compressionMethod) throw require_errors.invalidSnapshot();
+					const localNameLength = bytes.readUInt16LE(local + 26);
+					const localExtraLength = bytes.readUInt16LE(local + 28);
+					if (local + 30 + localNameLength + localExtraLength + entry.compressedSize > bytes.length || !bytes.subarray(local + 30, local + 30 + localNameLength).equals(rawName)) throw require_errors.invalidSnapshot();
+					if (!(entry.generalPurposeBitFlag & 8) && (bytes.readUInt32LE(local + 18) !== entry.compressedSize || bytes.readUInt32LE(local + 22) !== entry.uncompressedSize)) throw require_errors.invalidSnapshot();
+					if (directory) {
+						zip.readEntry();
+						return;
+					}
+					zip.openReadStream(entry, (readError, readStream) => {
+						if (readError) {
+							finish(require_errors.invalidSnapshot(readError));
+							return;
+						}
+						stream = readStream;
+						if (settled) {
+							readStream.destroy();
+							return;
+						}
+						const chunks = [];
+						let size = 0;
+						readStream.on("error", (cause) => finish(require_errors.invalidSnapshot(cause)));
+						readStream.on("data", (chunk) => {
+							size += chunk.length;
+							if (size > entry.uncompressedSize || size > MAX_SNAPSHOT_BYTES) {
+								finish(require_errors.invalidSnapshot());
+								return;
+							}
+							chunks.push(chunk);
+						});
+						readStream.on("end", () => {
+							if (settled) return;
+							if (size !== entry.uncompressedSize) {
+								finish(require_errors.invalidSnapshot());
+								return;
+							}
+							files.set(name, Buffer.concat(chunks, size));
+							stream = void 0;
+							zip.readEntry();
+						});
+					});
+				} catch (cause) {
+					finish(require_errors.invalidSnapshot(cause));
+				}
+			});
+			zip.readEntry();
+		});
+	});
+}
+
+//#endregion
+exports.MAX_ARCHIVE_ENTRIES = MAX_ARCHIVE_ENTRIES;
+exports.MAX_SNAPSHOT_BYTES = MAX_SNAPSHOT_BYTES;
+exports.readArchive = readArchive;
+exports.safeRelativePath = safeRelativePath;
+//# sourceMappingURL=archive.cjs.map

package/dist/v2/runtime/intelligence-platform/skill-registry/archive.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"archive.cjs","names":["invalidSnapshot"],"sources":["../../../../../src/v2/runtime/intelligence-platform/skill-registry/archive.ts"],"sourcesContent":["import { fromBuffer } from \"yauzl\";\nimport type { Entry, ZipFile } from \"yauzl\";\nimport type { Readable } from \"node:stream\";\nimport { invalidSnapshot } from \"./errors\";\n\n/** Internal corruption bounds, including manifest and directory entries. */\nexport const MAX_ARCHIVE_ENTRIES = 1_000;\nexport const MAX_SNAPSHOT_BYTES = 32 * 1024 * 1024;\n\nexport function safeRelativePath(path: string): boolean {\n  return (\n    path.length > 0 &&\n    // Reject control bytes in archive paths, including NUL and DEL.\n    // eslint-disable-next-line no-control-regex\n    !/[\\\\\\x00-\\x1f\\x7f]/.test(path) &&\n    !/^[a-z]:/i.test(path) &&\n    path\n      .split(\"/\")\n      .every((part) => part !== \"\" && part !== \".\" && part !== \"..\")\n  );\n}\n\n/** Decode only the listed ZIP namespace. No filesystem is involved. */\nexport function readArchive(\n  bytes: Buffer,\n  signal?: AbortSignal,\n): Promise<Map<string, Buffer>> {\n  return new Promise((resolve, reject) => {\n    let archive: ZipFile | undefined;\n    let stream: Readable | undefined;\n    let settled = false;\n    const finish = (error?: unknown) => {\n      if (settled) return;\n      settled = true;\n      signal?.removeEventListener(\"abort\", abort);\n      stream?.destroy();\n      archive?.close();\n      if (error !== undefined) reject(error);\n      else resolve(files);\n    };\n    const abort = () => finish(signal?.reason ?? invalidSnapshot());\n    const files = new Map<string, Buffer>();\n    const names = new Set<string>();\n    let decodedBytes = 0;\n    signal?.addEventListener(\"abort\", abort, { once: true });\n    if (signal?.aborted) {\n      abort();\n      return;\n    }\n    fromBuffer(\n      bytes,\n      {\n        lazyEntries: true,\n        decodeStrings: false,\n        validateEntrySizes: true,\n        autoClose: false,\n      },\n      (error, zip) => {\n        if (error) {\n          finish(invalidSnapshot(error));\n          return;\n        }\n        archive = zip;\n        if (settled) {\n          zip.close();\n          return;\n        }\n        zip.on(\"error\", (cause: unknown) => finish(invalidSnapshot(cause)));\n        zip.on(\"end\", () => finish());\n        if (zip.entryCount > MAX_ARCHIVE_ENTRIES) {\n          finish(invalidSnapshot());\n          return;\n        }\n        zip.on(\"entry\", (entry: Entry) => {\n          try {\n            // decodeStrings:false preserves raw UTF-8 names instead of normalizing\n            // backslashes or consulting alternate Unicode-path extra fields.\n            const rawName: unknown = entry.fileName;\n            if (!Buffer.isBuffer(rawName)) throw invalidSnapshot();\n            const name = new TextDecoder(\"utf-8\", {\n              fatal: true,\n              ignoreBOM: true,\n            }).decode(rawName);\n            const directory = name.endsWith(\"/\");\n            if (\n              !safeRelativePath(directory ? name.slice(0, -1) : name) ||\n              names.has(name)\n            )\n              throw invalidSnapshot();\n            names.add(name);\n            const fileType = (entry.externalFileAttributes >>> 16) & 0o170000;\n            if (\n              fileType !== 0 &&\n              fileType !== (directory ? 0o040000 : 0o100000)\n            )\n              throw invalidSnapshot();\n            if (\n              entry.isEncrypted() ||\n              ![0, 8].includes(entry.compressionMethod)\n            )\n              throw invalidSnapshot();\n            if (\n              !Number.isSafeInteger(entry.uncompressedSize) ||\n              entry.uncompressedSize < 0\n            )\n              throw invalidSnapshot();\n            decodedBytes += entry.uncompressedSize;\n            if (\n              decodedBytes > MAX_SNAPSHOT_BYTES ||\n              (directory && entry.uncompressedSize !== 0)\n            )\n              throw invalidSnapshot();\n            // Require the central directory and the local entry to name the same\n            // bytes. ZIP data descriptors may leave local sizes unset.\n            const local = entry.relativeOffsetOfLocalHeader;\n            if (\n              local < 0 ||\n              local + 30 > bytes.length ||\n              bytes.readUInt32LE(local) !== 0x04034b50\n            )\n              throw invalidSnapshot();\n            if (\n              bytes.readUInt16LE(local + 6) !== entry.generalPurposeBitFlag ||\n              bytes.readUInt16LE(local + 8) !== entry.compressionMethod\n            )\n              throw invalidSnapshot();\n            const localNameLength = bytes.readUInt16LE(local + 26);\n            const localExtraLength = bytes.readUInt16LE(local + 28);\n            const dataStart = local + 30 + localNameLength + localExtraLength;\n            if (\n              dataStart + entry.compressedSize > bytes.length ||\n              !bytes\n                .subarray(local + 30, local + 30 + localNameLength)\n                .equals(rawName)\n            )\n              throw invalidSnapshot();\n            if (\n              !(entry.generalPurposeBitFlag & 8) &&\n              (bytes.readUInt32LE(local + 18) !== entry.compressedSize ||\n                bytes.readUInt32LE(local + 22) !== entry.uncompressedSize)\n            )\n              throw invalidSnapshot();\n            if (directory) {\n              zip.readEntry();\n              return;\n            }\n            zip.openReadStream(entry, (readError, readStream) => {\n              if (readError) {\n                finish(invalidSnapshot(readError));\n                return;\n              }\n              stream = readStream;\n              if (settled) {\n                readStream.destroy();\n                return;\n              }\n              const chunks: Buffer[] = [];\n              let size = 0;\n              readStream.on(\"error\", (cause: unknown) =>\n                finish(invalidSnapshot(cause)),\n              );\n              readStream.on(\"data\", (chunk: Buffer) => {\n                size += chunk.length;\n                if (\n                  size > entry.uncompressedSize ||\n                  size > MAX_SNAPSHOT_BYTES\n                ) {\n                  finish(invalidSnapshot());\n                  return;\n                }\n                chunks.push(chunk);\n              });\n              readStream.on(\"end\", () => {\n                if (settled) return;\n                if (size !== entry.uncompressedSize) {\n                  finish(invalidSnapshot());\n                  return;\n                }\n                files.set(name, Buffer.concat(chunks, size));\n                stream = undefined;\n                zip.readEntry();\n              });\n            });\n          } catch (cause) {\n            finish(invalidSnapshot(cause));\n          }\n        });\n        zip.readEntry();\n      },\n    );\n  });\n}\n"],"mappings":"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"}