@copilotkit/runtime 1.79.2-canary.1792172552 → 1.81.0

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 {\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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"}
+{"version":3,"file":"sse-response.mjs","names":["defaultTelemetry"],"sources":["../../../../../src/v2/runtime/handlers/shared/sse-response.ts"],"sourcesContent":["import { EventType } from \"@ag-ui/client\";\nimport 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 { THREAD_ALREADY_RUNNING_ERROR_CODE } from \"@copilotkit/shared\";\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\n/**\n * Whether a runner rejected the run because the thread is busy. Matches the\n * `code` of {@link ThreadAlreadyRunningError}, and the plain message that\n * custom runners copied from the built-in ones still throw.\n */\nfunction isThreadAlreadyRunning(error: unknown): boolean {\n  return (\n    error instanceof Error &&\n    ((error as { code?: unknown }).code === THREAD_ALREADY_RUNNING_ERROR_CODE ||\n      error.message === \"Thread already running\")\n  );\n}\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  // Set once the current run's RUN_FINISHED or RUN_ERROR has been queued for\n  // the client. AG-UI allows nothing after either until the next RUN_STARTED,\n  // so a later failure must not add a RUN_ERROR.\n  let terminalEventWritten = 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  // Report a failure to the client as a terminal RUN_ERROR. Without it the\n  // client sees an empty stream that ends normally, so its run \"succeeds\"\n  // with no reply and no error (e.g. \"Thread already running\" on a busy\n  // thread). Only a busy thread is named, with a code clients can branch on;\n  // anything else may carry internal detail, so the client gets a generic\n  // message and the full error stays in the server log.\n  const writeRunError = async (error: unknown) => {\n    if (terminalEventWritten || streamClosed || request.signal.aborted) {\n      return;\n    }\n    terminalEventWritten = true;\n    const event = isThreadAlreadyRunning(error)\n      ? {\n          type: EventType.RUN_ERROR,\n          message: \"Thread already running\",\n          code: THREAD_ALREADY_RUNNING_ERROR_CODE,\n        }\n      : { type: EventType.RUN_ERROR, message: \"Agent run failed\" };\n    // The inspector sees every streamed event, so it needs this one too or\n    // the run it saw start never ends there. A run that never started has\n    // no ids to file it under, so it is not sent.\n    if (debugEventBus && debugRunId) {\n      try {\n        debugEventBus.broadcast(event as BaseEvent, {\n          agentId: agentId ?? \"\",\n          threadId: debugThreadId,\n          runId: debugRunId,\n        });\n      } catch (broadcastError) {\n        logError(broadcastError);\n      }\n    }\n    try {\n      await writer.write(encoder.encodeBinary(event as BaseEvent));\n    } catch {\n      // The client is already gone; closeStream() handles the rest.\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            // /connect replays finished runs before the live one, so a new\n            // RUN_STARTED reopens the stream for a RUN_ERROR.\n            if (event.type === EventType.RUN_STARTED) {\n              terminalEventWritten = false;\n            } else if (\n              event.type === EventType.RUN_FINISHED ||\n              event.type === EventType.RUN_ERROR\n            ) {\n              terminalEventWritten = true;\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 writeRunError(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 writeRunError(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/index.d.cts

@@ -1,13 +1,14 @@
 
+import { experimental_d_exports } from "./intelligence-platform/experimental.cjs";
 import { TranscribeFileOptions, TranscriptionService } from "./transcription-service/transcription-service.cjs";
-import { AgentRunner, AgentRunnerConnectRequest, AgentRunnerIsRunningRequest, AgentRunnerRunRequest, AgentRunnerStopRequest, LocalThreadEndpointRecord, LocalThreadEndpointRunner, supportsLocalThreadEndpoints } from "./runner/agent-runner.cjs";
-import { IntelligenceAgentRunner, IntelligenceAgentRunnerOptions, RunnerEventDeliveryStats, RunnerStartupBoundary } from "./runner/intelligence.cjs";
+import { AgentRunner, AgentRunnerConnectRequest, AgentRunnerIsRunningRequest, AgentRunnerRunRequest, AgentRunnerStopRequest, LocalThreadEndpointRecord, LocalThreadEndpointRunner, ThreadAlreadyRunningError, supportsLocalThreadEndpoints } from "./runner/agent-runner.cjs";
 import { GetLearnedSkillsSnapshotRequest, GetLearnedSkillsSnapshotsRequest, LearnedSkillsBatchResult, LearnedSkillsError, LearnedSkillsErrorCode, LearnedSkillsSnapshotResult } from "./intelligence-platform/learned-skills.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 { CopilotRuntimeLearningConfig, CopilotRuntimeLearningContext, CopilotRuntimeUser, GetLearningContainerId, GetTrajectoryLearningContainerIds, LearningContainerSelectorInput, TrajectoryLearningContainerSelectorInput } from "./core/learning.cjs";
-import { CopilotKitIntelligence, CopilotKitIntelligenceConfig, CreateThreadRequest, ListThreadsResponse, SubscribeToThreadsRequest, SubscribeToThreadsResponse, ThreadSummary, UpdateThreadRequest } from "./intelligence-platform/client.cjs";
+import { CopilotKitIntelligence, CopilotKitIntelligenceConfig, CreateThreadRequest, ListThreadsResponse, PlatformRequestError, 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 { CopilotRuntimeHooks, ErrorHookContext, HandlerHookContext, HookContext, ResponseHookContext, RouteInfo } from "./core/hooks.cjs";
@@ -17,6 +18,9 @@ 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 { GenerativeUIMiddleware } from "./generative-ui/generative-ui-middleware.cjs";
+import { GenerativeUISurfaceWriter, createSurfaceWriter } from "./generative-ui/surface-writer.cjs";
+import "./generative-ui/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.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","names":[],"sources":["../../../src/v2/runtime/index.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;KA2DY,wBAAA,IAA4B,MAAA;EACtC,OAAA,EAAS,OAAA;AAAA,MACL,OAAA,CAAQ,QAAA"}
+{"version":3,"file":"index.d.cts","names":[],"sources":["../../../src/v2/runtime/index.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;KAgEY,wBAAA,IAA4B,MAAA;EACtC,OAAA,EAAS,OAAA;AAAA,MACL,OAAA,CAAQ,QAAA"}

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

@@ -1,13 +1,14 @@
 
+import { experimental_d_exports } from "./intelligence-platform/experimental.mjs";
 import { TranscribeFileOptions, TranscriptionService } from "./transcription-service/transcription-service.mjs";
-import { AgentRunner, AgentRunnerConnectRequest, AgentRunnerIsRunningRequest, AgentRunnerRunRequest, AgentRunnerStopRequest, LocalThreadEndpointRecord, LocalThreadEndpointRunner, supportsLocalThreadEndpoints } from "./runner/agent-runner.mjs";
-import { IntelligenceAgentRunner, IntelligenceAgentRunnerOptions, RunnerEventDeliveryStats, RunnerStartupBoundary } from "./runner/intelligence.mjs";
+import { AgentRunner, AgentRunnerConnectRequest, AgentRunnerIsRunningRequest, AgentRunnerRunRequest, AgentRunnerStopRequest, LocalThreadEndpointRecord, LocalThreadEndpointRunner, ThreadAlreadyRunningError, supportsLocalThreadEndpoints } from "./runner/agent-runner.mjs";
 import { GetLearnedSkillsSnapshotRequest, GetLearnedSkillsSnapshotsRequest, LearnedSkillsBatchResult, LearnedSkillsError, LearnedSkillsErrorCode, LearnedSkillsSnapshotResult } from "./intelligence-platform/learned-skills.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 { CopilotRuntimeLearningConfig, CopilotRuntimeLearningContext, CopilotRuntimeUser, GetLearningContainerId, GetTrajectoryLearningContainerIds, LearningContainerSelectorInput, TrajectoryLearningContainerSelectorInput } from "./core/learning.mjs";
-import { CopilotKitIntelligence, CopilotKitIntelligenceConfig, CreateThreadRequest, ListThreadsResponse, SubscribeToThreadsRequest, SubscribeToThreadsResponse, ThreadSummary, UpdateThreadRequest } from "./intelligence-platform/client.mjs";
+import { CopilotKitIntelligence, CopilotKitIntelligenceConfig, CreateThreadRequest, ListThreadsResponse, PlatformRequestError, 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 { CopilotRuntimeHooks, ErrorHookContext, HandlerHookContext, HookContext, ResponseHookContext, RouteInfo } from "./core/hooks.mjs";
@@ -17,6 +18,9 @@ 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 { GenerativeUIMiddleware } from "./generative-ui/generative-ui-middleware.mjs";
+import { GenerativeUISurfaceWriter, createSurfaceWriter } from "./generative-ui/surface-writer.mjs";
+import "./generative-ui/index.mjs";
 import { CopilotRuntimeFetchHandler, CopilotRuntimeFetchHandlerWithChannels, CopilotRuntimeHandlerOptions, createCopilotRuntimeHandler } from "./core/fetch-handler.mjs";
 import { MCPClient, MCPTransport } from "@ai-sdk/mcp";
 

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../../../src/v2/runtime/index.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;KA2DY,wBAAA,IAA4B,MAAA;EACtC,OAAA,EAAS,OAAA;AAAA,MACL,OAAA,CAAQ,QAAA"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../../src/v2/runtime/index.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;KAgEY,wBAAA,IAA4B,MAAA;EACtC,OAAA,EAAS,OAAA;AAAA,MACL,OAAA,CAAQ,QAAA"}

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

@@ -2,6 +2,7 @@ require("reflect-metadata");
 const require_runtime = require('../../../_virtual/_rolldown/runtime.cjs');
 const require_learning = require('../core/learning.cjs');
 const require_learned_skills = require('./learned-skills.cjs');
+const require_learning_management = require('./learning-management.cjs');
 const require_trajectories = require('./trajectories.cjs');
 let _copilotkit_shared = require("@copilotkit/shared");
 let zod = require("zod");
@@ -144,10 +145,11 @@ const CONFLICT = new Set([409]);
 * ```
 */
 var PlatformRequestError = class extends Error {
-	constructor(message, status, retryable) {
+	constructor(message, status, retryable, code) {
 		super(message);
 		this.status = status;
 		this.retryable = retryable;
+		this.code = code;
 		this.name = "PlatformRequestError";
 	}
 };
@@ -240,6 +242,16 @@ var CopilotKitIntelligence = class {
 	#threadUpdatedListeners = /* @__PURE__ */ new Set();
 	#threadDeletedListeners = /* @__PURE__ */ new Set();
 	constructor(config) {
+		this.experimental = { learning: {
+			listLearningContainers: this.#listLearningContainers.bind(this),
+			getLearningContainer: this.#getLearningContainer.bind(this),
+			listLearningRuns: this.#listLearningRuns.bind(this),
+			startLearningRun: this.#startLearningRun.bind(this),
+			listLearningCandidates: this.#listLearningCandidates.bind(this),
+			getLearningCandidate: this.#getLearningCandidate.bind(this),
+			getLearningInsightEvidence: this.#getLearningInsightEvidence.bind(this),
+			reviewLearningCandidate: this.#reviewLearningCandidate.bind(this)
+		} };
 		if (config.getLearningContainerId !== void 0 && typeof config.getLearningContainerId !== "function") throw new Error("CopilotKitIntelligence `getLearningContainerId` must be a callback");
 		assertConfiguredApiKey(config.apiKey);
 		if (config.getTrajectoryLearningContainerIds !== void 0 && typeof config.getTrajectoryLearningContainerIds !== "function") throw new Error("CopilotKitIntelligence `getTrajectoryLearningContainerIds` must be a callback");
@@ -554,6 +566,77 @@ var CopilotKitIntelligence = class {
 			if (timeoutId !== void 0) clearTimeout(timeoutId);
 		}
 	}
+	/** Lists a bounded page of Learning spaces owned by this server's project key. */
+	async #listLearningContainers(options = {}) {
+		const query = options.cursor === void 0 ? "" : `?cursor=${encodeURIComponent(zod.z.string().min(1).max(128).parse(options.cursor))}`;
+		return this.#learningRequest("GET", `/api/v1/learning/containers${query}`, require_learning_management.learningContainerPageSchema, options.signal);
+	}
+	/** Reads one Learning space; this does not assign or move any conversations. */
+	async #getLearningContainer(options) {
+		return (await this.#learningRequest("GET", require_learning_management.learningContainerPath(options.containerId), zod.z.object({ container: require_learning_management.learningContainerSchema }), options.signal)).container;
+	}
+	/** Reads the latest 100 Learning runs; queue admission is not completion. */
+	async #listLearningRuns(options) {
+		return (await this.#learningRequest("GET", `${require_learning_management.learningContainerPath(options.containerId)}/runs`, zod.z.object({ runs: zod.z.array(require_learning_management.learningRunSchema).max(100) }), options.signal)).runs;
+	}
+	/** Starts or recovers a manual run for all eligible evidence in this space. Never retries automatically. */
+	async #startLearningRun(options) {
+		return (await this.#learningRequest("POST", `${require_learning_management.learningContainerPath(options.containerId)}/runs`, zod.z.object({ run: require_learning_management.learningRunSchema }), options.signal)).run;
+	}
+	/** Reads the latest 500 proposed Skill changes, including completed reviews. */
+	async #listLearningCandidates(options) {
+		return (await this.#learningRequest("GET", `${require_learning_management.learningContainerPath(options.containerId)}/candidates`, zod.z.object({ candidates: zod.z.array(require_learning_management.learningCandidateSchema).max(500) }), options.signal)).candidates;
+	}
+	/** Reads proposed files and supporting Insights for an explicit review decision. */
+	async #getLearningCandidate(options) {
+		return (await this.#learningRequest("GET", `${require_learning_management.learningContainerPath(options.containerId)}/candidates/${require_learning_management.learningObjectId(options.candidateId)}`, zod.z.object({ candidate: require_learning_management.learningCandidateDetailSchema }), options.signal)).candidate;
+	}
+	/** Reads scoped source evidence, including unavailable-source reasons. */
+	async #getLearningInsightEvidence(options) {
+		return (await this.#learningRequest("GET", `${require_learning_management.learningContainerPath(options.containerId)}/insights/${require_learning_management.learningObjectId(options.insightId)}/evidence`, zod.z.object({ evidence: zod.z.array(require_learning_management.learningInsightEvidenceSchema) }), options.signal)).evidence;
+	}
+	/** Publishes or rejects a proposal. The application must authorize its reviewer before calling. */
+	async #reviewLearningCandidate(options) {
+		const action = zod.z.enum(["approve", "reject"]).parse(options.action);
+		return (await this.#learningRequest("POST", `${require_learning_management.learningContainerPath(options.containerId)}/candidates/${require_learning_management.learningObjectId(options.candidateId)}/${action}`, zod.z.object({ review: require_learning_management.learningCandidateReviewSchema }), options.signal)).review;
+	}
+	/** Uses server credentials, bounded JSON, and a deadline without retrying mutations. */
+	async #learningRequest(method, path, schema, signal) {
+		signal?.throwIfAborted();
+		const controller = new AbortController();
+		const abort = () => controller.abort(signal?.reason);
+		signal?.addEventListener("abort", abort, { once: true });
+		const timeout = setTimeout(() => controller.abort(/* @__PURE__ */ new Error("Learning request timed out")), 3e4);
+		try {
+			const response = await fetch(`${this.#apiUrl}${path}`, {
+				method,
+				headers: {
+					Authorization: `Bearer ${this.#apiKey}`,
+					"Content-Type": "application/json"
+				},
+				...method === "POST" ? { body: "{}" } : {},
+				signal: controller.signal
+			});
+			if (!response.ok) {
+				const body = await require_learning_management.readLearningJson(response, 64 * 1024, controller.signal).catch(() => void 0);
+				controller.signal.throwIfAborted();
+				const error = zod.z.object({ error: zod.z.object({
+					code: zod.z.string().regex(/^[A-Z][A-Z0-9_]{0,99}$/),
+					retryable: zod.z.boolean()
+				}) }).safeParse(body);
+				throw new PlatformRequestError(`Learning request failed (${response.status}).`, response.status, error.success ? error.data.error.retryable : response.status === 429 || response.status >= 500, error.success ? error.data.error.code : void 0);
+			}
+			try {
+				return schema.parse(await require_learning_management.readLearningJson(response, void 0, controller.signal));
+			} catch {
+				if (controller.signal.aborted) throw controller.signal.reason;
+				throw new PlatformRequestError("Invalid Learning response.", 502, true);
+			}
+		} finally {
+			clearTimeout(timeout);
+			signal?.removeEventListener("abort", abort);
+		}
+	}
 	/** Fetches one credential-scoped, bounded Learning projection for Inspector. */
 	async getInspectorLearning(request) {
 		const url = new URL(`${this.#apiUrl}/api/inspector/learning`);
@@ -990,6 +1073,22 @@ var CopilotKitIntelligence = class {
 		const qs = new URLSearchParams({ userId: params.userId }).toString();
 		return this.#request("GET", `/api/threads/${encodeURIComponent(params.threadId)}/messages?${qs}`, void 0, params.channelDeliveryId ? { "X-Cpki-Channel-Delivery-Id": params.channelDeliveryId } : void 0);
 	}
+	/**
+	* @internal Fetch only the ids of a thread's persisted messages.
+	*
+	* Sends `fields=id` so the platform can omit message content. Platform
+	* versions that do not know the parameter ignore it and return the full
+	* transcript; ids are read from `messages[].id` either way.
+	*
+	* @throws {@link PlatformRequestError} on non-2xx responses.
+	*/
+	async ɵgetThreadMessageIds(params) {
+		const qs = new URLSearchParams({
+			userId: params.userId,
+			fields: "id"
+		}).toString();
+		return (await this.#request("GET", `/api/threads/${encodeURIComponent(params.threadId)}/messages?${qs}`, void 0, params.channelDeliveryId ? { "X-Cpki-Channel-Delivery-Id": params.channelDeliveryId } : void 0)).messages.map((message) => message.id);
+	}
 	/** @internal Fetches one authorized managed Channel asset for history hydration. */
 	async ɵgetManagedChannelAsset(assetId) {
 		const path = `/api/channels/files/${encodeURIComponent(assetId)}`;