@tangle-network/agent-runtime 0.181.0 → 0.183.0

package/dist/graph-Ca4JV-Q6.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"graph-Ca4JV-Q6.js","names":[],"sources":["../src/runtime/supervise/graph.ts"],"sourcesContent":["/**\n *\n * `runGraph` — agent graphs: profiles as nodes, registry-backed prompt directives as edges.\n *\n * A topology is PLAIN DATA an agent can author in a few lines: nodes are canonical\n * `AgentProfile`s (the ONLY way a node is described — no role-builder functions), edges are typed\n * values carrying versioned {@link PromptHandle} directives, `deliverable` (termination) and\n * `budget` (one conserved pool) are mandatory. Driver↔worker is the two-node cyclic instance;\n * \"agent 3 analyzes 1 and 2 and reports to 1\" is ONE edge, not a framework.\n *\n * NOT A SECOND SCHEDULER. `runGraph` is an interpretation layer over what already runs:\n * `supervise()` is the execution core — the same `supervisorAgent`/`driverAgent` machinery,\n * backend-derived worker path (authorized, classified, recursive), conserved-pool budget, and\n * deliverable-gated settlement every\n * supervised run uses. (`runAgentRounds` is deliberately NOT the substrate here.) What the graph\n * layer ADDS is exactly what a bespoke driver loop never\n * had:\n *\n *  1. **Node pinning** — a spawn names a node (`profile.name` = node id) and the node's canonical\n *     profile is what runs; a driver cannot smuggle capabilities into a worker it did not define.\n *  2. **Observable edges** — every delegates/analyzes traversal lands in an EDGE LEDGER\n *     (`delivered | stripped | empty | unpropagated`, with byte counts), in memory on\n *     the result AND as `edge` events in the run journal. The motivating incident: a filter\n *     silently replaced 1,700-char steering with 241 chars of boilerplate for three rounds and\n *     NO artifact said so — an unobservable edge cannot be trusted and its directive cannot be\n *     optimized.\n *  3. **Directives as data** — edge text lives in the prompt registry (`<surface>/v<n>`), so every\n *     edge is a versioned optimization target, never prose hardcoded in a builder function.\n *  4. **Per-edge traversal caps** — the cyclic-graph backstop. A delegates edge whose cap is\n *     exhausted REFUSES further traversals (fail loud), so a cycle cannot spin the pool dry.\n *  5. **Continuity as data** — a delegates edge may declare `continuity: 'resume'`, so each spawn\n *     after the node's first re-attaches to its latest SETTLED session (the spawn context hands\n *     the executor seam `resume: { ofWorker, sequence }`; the kernel keeps identity, ordering,\n *     ledger truth, and the one conserved pool). Every ledger row states how its hop continued:\n *     `'fresh' | 'resume'` for spawns, `'steer'` for mid-run deliveries — fresh respawns, session\n *     resumes, and live steers are all plain data, each a ledgered fact.\n *\n * ORACLES ARE ENVIRONMENT, NEVER WORKERS. Graders/verifiers must not be spawnable in the graph —\n * a delegates edge to them leaks the rubric. An `analyzes` edge names its analyst in one of two\n * forms: a LENS id from the environment's registry (a pure function over trace evidence), or the\n * id of a graph NODE — a tool-equipped analyst AGENT spawned on each matching settle with the\n * node's pinned profile, whose settle output IS the findings. Either way the oracle doctrine\n * holds: an analyst node can never be a delegates target (refused loudly), so no driver can hand\n * it work, and an id living in both the registry and the nodes is refused as ambiguous.\n *\n * @experimental\n */\n\nimport {\n  type AgentProfile,\n  agentProfileSchema,\n  canonicalCandidateDigest,\n} from '@tangle-network/agent-interface'\nimport { InMemoryResultBlobStore, InMemorySpawnJournal } from '../../durable/spawn-journal'\nimport { ValidationError } from '../../errors'\nimport type {\n  AnalystRegistry,\n  AnalyzeOnSettleRoute,\n  ContinuityMode,\n  CoordinationEvent,\n  MakeWorkerAgent,\n} from '../../mcp/tools/coordination'\nimport { composeRuntimeHooks, type RuntimeHooks } from '../../runtime-hooks'\nimport { harnessRunsAgent } from '../harness-role'\nimport type { ToolLoopChat } from '../tool-loop'\nimport type { DeliverableSpec } from './completion-gate'\nimport {\n  formatPromptHandle,\n  kernelPromptRegistry,\n  type PromptHandle,\n  type PromptRegistry,\n} from './prompt-registry'\nimport { type SuperviseOptions, supervise, superviseWithTestBrain } from './supervise'\nimport type { Budget, NodeId, ResultBlobStore, SpawnJournal, SupervisedResult } from './types'\n\n// ── The algebra ────────────────────────────────────────────────────────────────\n\n/** A graph node: an id and a canonical `AgentProfile`. The profile is the ONLY way a node is\n *  described — its `prompt.systemPrompt` is the standing role (the 0.117 canonical resolution;\n *  never a legacy top-level-only reduction), its tools/mcp/resources are its capabilities. */\nexport interface GraphNode {\n  readonly id: NodeId\n  readonly profile: AgentProfile\n}\n\nexport type GraphEdge =\n  /** Work flows down. The delegation directive is DATA → versionable, sweepable, optimizable.\n   *  Each spawn of `to` by `from` — and each mid-run steer from `from` to a live `to` worker —\n   *  is one traversal. */\n  | {\n      readonly kind: 'delegates'\n      readonly from: NodeId\n      readonly to: NodeId\n      readonly directive: PromptHandle\n      /** Cyclic-graph backstop: traversals beyond this REFUSE (fail loud). Default\n       *  {@link defaultEdgeTraversalCap}. */\n      readonly maxTraversals?: number\n      /** Default continuity for this edge's SPAWN traversals. `'resume'` makes every spawn after\n       *  the node's first re-attach to its most recent SETTLED worker: a NEW live worker whose\n       *  spawn context carries `resume: { ofWorker, sequence }` for the executor seam, spending\n       *  from the same conserved pool — the node's first spawn is effectively `'fresh'`, and a\n       *  spawn while a prior worker is still live refuses loudly (steer is the live channel).\n       *  The driver's per-call `spawn_agent` `continuity` argument overrides either way. Omit =\n       *  `'fresh'` (today's behavior, byte-identical). Caps count resumes exactly like fresh\n       *  spawns. */\n      readonly continuity?: ContinuityMode\n    }\n  /** Findings flow anywhere: an analyst over N nodes' settled traces, delivered to ONE node.\n   *  With a LENS analyst the directive wraps the findings for the recipient; with a NODE analyst\n   *  the directive is the analyst agent's task and the findings are its settle output. */\n  | {\n      readonly kind: 'analyzes'\n      /** The analyst REFERENCE, in one of two forms: a lens id resolved against\n       *  `RunGraphOptions.analysts` (environment), or the id of a graph NODE with no delegates\n       *  edge pointing at it — then each matching settle spawns that node's pinned profile as a\n       *  tool-equipped analyst WORKER (same spawn machinery, conserved budget, trace join) whose\n       *  task is this edge's directive plus the settled worker's trace evidence and whose settle\n       *  output is the findings. An id that is both a node and a registry lens is refused. */\n      readonly analyst: string\n      readonly over: ReadonlyArray<NodeId>\n      readonly to: NodeId\n      readonly directive: PromptHandle\n      /** Observability cap: traversals beyond this are LEDGERED as exhausted (`unpropagated`).\n       *  Only delegates caps refuse traversal — they are what close the spawn cycle. */\n      readonly maxTraversals?: number\n    }\n\nexport interface AgentGraph {\n  readonly nodes: ReadonlyArray<GraphNode>\n  readonly edges: ReadonlyArray<GraphEdge>\n  /** Termination is mandatory, not optional: the independent completion oracle. */\n  readonly deliverable: DeliverableSpec<unknown>\n  /** One conserved pool across the whole graph — cycles without conservation never terminate. */\n  readonly budget: Budget\n}\n\n// ── The edge ledger ────────────────────────────────────────────────────────────\n\nexport type EdgeDeliveryOutcome = 'delivered' | 'stripped' | 'empty' | 'unpropagated'\n\n/** How one ledgered hop CONTINUED: a spawn traversal stamps its effective spawn mode\n *  (`'fresh'` | `'resume'`), and every mid-run delivery into an already-live recipient — a\n *  driver steer leg and every analyzes delivery (routed steer or driver-destined finding) —\n *  stamps `'steer'`. Zero ambiguity: every row carries exactly one of the three. */\nexport type TraversalContinuity = ContinuityMode | 'steer'\n\n/** One recorded edge traversal — the in-memory row; the journal twin is the `edge` SpawnEvent. */\nexport interface EdgeTraversal {\n  /** Stable edge id: `delegates:<from>-><to>` or `analyzes:<analyst>:<over…>-><to>`. */\n  readonly edge: string\n  readonly kind: 'delegates' | 'analyzes'\n  readonly from: string\n  readonly to: string\n  /** The resolved directive reference (`<surface>/v<n>`). */\n  readonly directive: string\n  /** 1-based per-edge ordinal. */\n  readonly traversal: number\n  readonly outcome: EdgeDeliveryOutcome\n  /** How this hop continued — see {@link TraversalContinuity}. */\n  readonly continuity: TraversalContinuity\n  /** Bytes of directive + payload that actually crossed the edge. */\n  readonly bytes: number\n  readonly reason?: string\n  /** The concrete worker node id, once known. */\n  readonly workerId?: string\n}\n\n/** Default per-edge traversal cap — the cyclic-graph backstop when an edge names none. */\nexport const defaultEdgeTraversalCap = 32\n\n/** A delegates edge exhausted its traversal cap and the run produced no winner: the cap, not the\n *  task, ended it. Carries the full evidence so failing loud loses nothing. */\nexport class GraphEdgeCapError extends Error {\n  readonly exhaustedEdges: ReadonlyArray<string>\n  readonly ledger: ReadonlyArray<EdgeTraversal>\n  readonly result: SupervisedResult<unknown>\n  constructor(\n    exhaustedEdges: ReadonlyArray<string>,\n    ledger: ReadonlyArray<EdgeTraversal>,\n    result: SupervisedResult<unknown>,\n  ) {\n    super(\n      `runGraph: edge traversal cap exhausted on ${exhaustedEdges.join(', ')} and the run ` +\n        'delivered no winner — the cap (the cyclic-graph backstop), not the task, ended this run. ' +\n        'Raise maxTraversals on the edge or fix the cycle; the full edge ledger and the ' +\n        'supervised result ride on this error.',\n    )\n    this.name = 'GraphEdgeCapError'\n    this.exhaustedEdges = exhaustedEdges\n    this.ledger = ledger\n    this.result = result\n  }\n}\n\n// ── Options / result ───────────────────────────────────────────────────────────\n\n/**\n * Every `SuperviseOptions` key, partitioned by what `runGraph` does with it.\n *\n * `runGraph` starts one `supervise()` run, so every option that run honors is a graph option too\n * unless the graph itself owns the value. This used to be an opt-in list written by hand, and the\n * hand lost: 25 of 49 keys never reached `supervise()` from a graph, including `childSettleGraceMs`\n * (a root-driver failure tore down children that had ALREADY computed the deliverable) and\n * `driverRetry` (agent-runtime#963). Each absence was discovered by losing a run.\n *\n * The four lists below must cover `keyof SuperviseOptions` exactly. `everySuperviseOptionIsClassified`\n * below fails to COMPILE, naming the offender, when a key belongs to none of them — so the next\n * option added to `supervise()` cannot go missing here silently. It has to be classified, and\n * classifying it as forwarded is one word.\n */\n\n/** The graph derives these from the `AgentGraph` itself; a caller value would be overwritten. */\nconst GRAPH_OWNED_SUPERVISE_OPTIONS = [\n  'rootDriverFromBackend',\n  'resolveSpawnProfile',\n  'budget',\n  'deliverable',\n  'makeWorkerAgent',\n  'onCoordinationEvent',\n  'analyzeOnSettle',\n  'continuityByProfile',\n] as const\n\n/** Caller-facing on `RunGraphOptions`, but the graph wraps or defaults the value before it goes in:\n *  `hooks` composes with the graph's own spawn-binding hook, `authorizeMessage` is wrapped so a\n *  narrowed instruction ledgers `stripped`, `authorizeSpawn` runs AFTER the graph has pinned the\n *  node (so a product sees the canonical profile, never the driver's stub), `makeLeafAgent` is the\n *  caller's leaf override slotted under the graph's pinning, `analysts` rides only with analyze\n *  routes, and `journal`/`blobs`/`runId` get graph defaults. */\nconst GRAPH_TRANSFORMED_SUPERVISE_OPTIONS = [\n  'hooks',\n  'authorizeMessage',\n  'authorizeSpawn',\n  'makeLeafAgent',\n  'analysts',\n  'journal',\n  'blobs',\n  'runId',\n] as const\n\n/** Not reachable from a graph, with the reason. `registry` is a NAME COLLISION, not a policy:\n *  `RunGraphOptions.registry` is the directive `PromptRegistry` and `SuperviseOptions.registry` is\n *  the `SuperviseRegistry` name→value table. Two different types under one name; the graph's wins.\n *  Giving the supervise one a graph channel means renaming a public option, so it is recorded here\n *  rather than silently dropped. */\nconst GRAPH_REFUSED_SUPERVISE_OPTIONS = ['registry'] as const\n\n/**\n * Forwarded to the root `supervise()` VERBATIM. Everything not owned, transformed, or refused\n * above belongs here — the default is \"a graph honors it\", not \"someone remembered to add it\".\n */\nconst GRAPH_FORWARDED_SUPERVISE_OPTIONS = [\n  'backend',\n  'rootHandle',\n  'signal',\n  'execution',\n  'resolveDeliverable',\n  'coordination',\n  'peerMail',\n  'driverBackend',\n  'profileSecurity',\n  'authorizeSpawn',\n  'isDriverProfile',\n  'router',\n  'driveHarness',\n  'driverRetry',\n  'onDriverAttempt',\n  'childSettleGraceMs',\n  'resolveDriveHarness',\n  'driveHarnessMaterialization',\n  'resolveSupervisorTools',\n  'extraTools',\n  'executeExtraTool',\n  'perWorker',\n  'maxLiveWorkers',\n  'watchWorkers',\n  'stallAfterMs',\n  'runDir',\n  'probes',\n  'stopRule',\n  'onProgressStop',\n  'maxDepth',\n  'maxTurns',\n  'compaction',\n  'now',\n  'allowedModels',\n  'finalizer',\n  'otel',\n] as const\n\ntype ClassifiedSuperviseOption =\n  | (typeof GRAPH_OWNED_SUPERVISE_OPTIONS)[number]\n  | (typeof GRAPH_TRANSFORMED_SUPERVISE_OPTIONS)[number]\n  | (typeof GRAPH_REFUSED_SUPERVISE_OPTIONS)[number]\n  | (typeof GRAPH_FORWARDED_SUPERVISE_OPTIONS)[number]\n\n/** A `SuperviseOptions` key in none of the four lists makes this assignment fail, and the compiler\n *  error names the key. Classify it — `GRAPH_FORWARDED_SUPERVISE_OPTIONS` is usually the answer. */\ntype UnclassifiedSuperviseOption = Exclude<keyof SuperviseOptions, ClassifiedSuperviseOption>\nconst everySuperviseOptionIsClassified: UnclassifiedSuperviseOption extends never\n  ? true\n  : UnclassifiedSuperviseOption = true\nvoid everySuperviseOptionIsClassified\n\n/** `backend` and `driverBackend` keep graph-specific documentation below.\n *\n * Do not inherit and redeclare them through an indexed access type.\n * TypeScript 7 correctly treats `SuperviseOptions['backend']` as including `undefined`, which makes\n * that redeclaration wider than the exact optional property inherited from `SuperviseOptions`.\n */\ntype GraphInheritedSuperviseOption = Exclude<\n  (typeof GRAPH_FORWARDED_SUPERVISE_OPTIONS)[number],\n  'backend' | 'driverBackend'\n>\n\n/** Copy every forwarded option the caller actually set. Absent stays absent: `supervise()` and the\n *  graph must not disagree about what \"unset\" means. */\nfunction forwardedSuperviseOptions(\n  opts: RunGraphOptions,\n): Pick<SuperviseOptions, (typeof GRAPH_FORWARDED_SUPERVISE_OPTIONS)[number]> {\n  const forwarded: Record<string, unknown> = {}\n  for (const key of GRAPH_FORWARDED_SUPERVISE_OPTIONS) {\n    const value = (opts as Record<string, unknown>)[key]\n    if (value !== undefined) forwarded[key] = value\n  }\n  return forwarded as Pick<SuperviseOptions, (typeof GRAPH_FORWARDED_SUPERVISE_OPTIONS)[number]>\n}\n\n/**\n * Options for one `runGraph` run.\n *\n * Extends every forwarded `SuperviseOptions` key, so a graph honors what a `supervise()` run\n * honors WITHOUT anyone restating it here. Only the graph-specific members and the ones whose\n * graph semantics differ are declared below; everything else inherits its type AND its\n * documentation from `SuperviseOptions`, which is the one owner of both.\n */\nexport interface RunGraphOptions extends Pick<SuperviseOptions, GraphInheritedSuperviseOption> {\n  /** WHERE worker nodes run — the executor backend. Provide this OR `makeLeafAgent`. Forwarded to\n   *  `supervise()`, which derives every authorized LEAF from it; a node declared `role: 'driver'`\n   *  becomes a nested supervisor instead, whose own leaves are derived the same way. */\n  readonly backend?: Exclude<SuperviseOptions['backend'], undefined>\n  /** WHERE the ROOT node's harness brain runs — forwarded to `supervise()` verbatim (see\n   *  `SuperviseOptions.driverBackend`). Needed when the root node's profile declares an external\n   *  harness (`codex`, `claude-code`, `opencode`): that root is driven by the harness, not by the\n   *  router brain, and automatic execution supports a local `bridge`. Unlike `supervise()`, this\n   *  does NOT default to `backend`: a graph's `backend` places WORKER nodes, so the root driver\n   *  is selected only by this field. Omit = no harness driver, which is correct for a root whose\n   *  `profile.harness` is omitted or `cli-base` (that root runs on the router brain). */\n  readonly driverBackend?: Exclude<SuperviseOptions['driverBackend'], undefined>\n  /** Leaf-execution override (offline tests / advanced). `runGraph` still owns node pinning,\n   *  directive delivery, and the edge ledger AROUND this seam — only the leaf `act` is yours.\n   *  Slots INSIDE the kernel's authorized path (`SuperviseOptions.makeLeafAgent`), so a node\n   *  declared `role: 'driver'` still becomes a nested supervisor even under an offline leaf. */\n  readonly makeLeafAgent?: MakeWorkerAgent\n  /** The ROOT driver's inference seam — a caller-owned `ToolLoopChat` that makes every root\n   *  model call. Use it when the root's decisions must be caller-owned orchestration (a\n   *  deterministic conversation driver, a persona loop with its own LLM calls) rather than a\n   *  router-derived model call. The graph machinery around the seam is unchanged: node pinning,\n   *  directive delivery, the edge ledger, and the journal twin all run the same shipped path,\n   *  and the root profile keeps prompt control (`prompt-control-execution` materialization —\n   *  `systemPrompt`/`instructions` still apply). What moves to the caller with the brain:\n   *  model selection and provider-identity validation (`expectedModel` cannot be enforced on a\n   *  call the runtime did not place) and per-turn usage reporting (a brain that reports no\n   *  usage meters nothing into the pool). Omit = the router brain derived from the root\n   *  profile — the unchanged default. Mutually exclusive with `driverBackend`, and refused\n   *  when the root profile declares an external harness (that root is driven BY the harness). */\n  readonly brain?: ToolLoopChat\n  /** Caller-side runtime hooks (telemetry, policy, product extensions). Composed AFTER the\n   *  graph's own spawn-binding hook on the SAME event stream — the graph never swallows the\n   *  seam supervise() exposes. */\n  readonly hooks?: RuntimeHooks\n  /** The analyst lens registry `analyzes` edges resolve against. ENVIRONMENT — needed only for\n   *  lens analysts; an analyzes edge naming a graph NODE as its analyst needs no registry. */\n  readonly analysts?: AnalystRegistry\n  /** Directive registry. Default: the seeded kernel registry (`kernelPromptRegistry()`).\n   *\n   *  NOT `SuperviseOptions.registry`, which is the `SuperviseRegistry` name→value table for\n   *  code-valued options. The two share a name and nothing else, and this one wins here — see\n   *  `GRAPH_REFUSED_SUPERVISE_OPTIONS`. */\n  readonly registry?: PromptRegistry\n  /** The run journal the edge ledger and every spawn/settle ride. Default: in-memory. */\n  readonly journal?: SpawnJournal\n  readonly blobs?: ResultBlobStore\n  readonly runId?: string\n  /** Product authority over every steer/answer instruction (the filter seam). `runGraph` observes\n   *  what it CHANGES: a narrowed instruction ledgers its steer traversal as `stripped`. */\n  readonly authorizeMessage?: SuperviseOptions['authorizeMessage']\n}\n\nexport interface GraphResult<Out = unknown> {\n  readonly result: SupervisedResult<Out>\n  /** Every edge traversal, in occurrence order — the observable-edge contract. */\n  readonly ledger: ReadonlyArray<EdgeTraversal>\n  /** Edge ids whose traversal cap was hit — analyzes exhaustion included (observable here, never\n   *  a refusal). A DELEGATES cap paired with a `no-winner` result THROWS\n   *  ({@link GraphEdgeCapError}) instead of returning: only delegates caps refuse spawns, so only\n   *  they can have ended the run. A LIFECYCLE no-winner (`aborted` / `budget-exhausted`) returns\n   *  normally even with an exhausted delegates cap — the abort or the pool, not the cap, ended\n   *  that run, and the exhaustion stays observable here. */\n  readonly exhaustedEdges: ReadonlyArray<string>\n  readonly runId: string\n}\n\n/** `RunGraphOptions` with the brain REQUIRED — the shape the `/testing` entry's\n *  `runGraphWithTestBrain` keeps accepting now that `brain` is a production option. */\nexport interface RunGraphTestOptions extends RunGraphOptions {\n  readonly brain: ToolLoopChat\n}\n\n// ── Validation ─────────────────────────────────────────────────────────────────\n\ninterface ValidatedGraph {\n  readonly root: GraphNode\n  readonly workers: ReadonlyMap<NodeId, GraphNode>\n  readonly delegatesByWorker: ReadonlyMap<NodeId, Extract<GraphEdge, { kind: 'delegates' }>>\n  readonly analyzes: ReadonlyArray<Extract<GraphEdge, { kind: 'analyzes' }>>\n  /** Nodes referenced as an analyzes edge's ANALYST (the analyst-agent form): reachable through\n   *  their analyzes edge (spawned on settle), never through a delegates edge. */\n  readonly analystNodes: ReadonlyMap<NodeId, GraphNode>\n}\n\nfunction edgeId(edge: GraphEdge): string {\n  return edge.kind === 'delegates'\n    ? `delegates:${edge.from}->${edge.to}`\n    : `analyzes:${edge.analyst}:${edge.over.join('+')}->${edge.to}`\n}\n\n/** Validate the graph and resolve every directive BEFORE any compute is spent — an invalid\n *  topology or an unknown directive is a configuration fault, never a mid-run surprise. */\nfunction validateGraph(\n  graph: AgentGraph,\n  registry: PromptRegistry,\n  analysts: AnalystRegistry | undefined,\n): ValidatedGraph {\n  if (!Array.isArray(graph.nodes) || graph.nodes.length === 0) {\n    throw new ValidationError('runGraph: graph.nodes must be a non-empty array')\n  }\n  if (!Array.isArray(graph.edges) || graph.edges.length === 0) {\n    throw new ValidationError('runGraph: graph.edges must be a non-empty array')\n  }\n  if (typeof graph.deliverable?.check !== 'function') {\n    throw new ValidationError('runGraph: graph.deliverable is mandatory (termination oracle)')\n  }\n  if (typeof graph.budget !== 'object' || graph.budget === null) {\n    throw new ValidationError('runGraph: graph.budget is mandatory (the conserved pool)')\n  }\n  const byId = new Map<NodeId, GraphNode>()\n  for (const node of graph.nodes) {\n    if (typeof node.id !== 'string' || node.id.length === 0) {\n      throw new ValidationError('runGraph: every node needs a non-empty string id')\n    }\n    if (byId.has(node.id)) throw new ValidationError(`runGraph: duplicate node id '${node.id}'`)\n    const parsed = agentProfileSchema.safeParse(node.profile)\n    if (!parsed.success) {\n      throw new ValidationError(\n        `runGraph: node '${node.id}' has an invalid AgentProfile: ${parsed.error.message}`,\n      )\n    }\n    // The profile NAME is the node identity everywhere downstream: node pinning resolves a\n    // spawn's `profile.name` against node ids, and the coordination layer matches analyst\n    // routes (`over`/`to`) against the settled worker's PROFILE NAME. A divergent name would\n    // make every analyzes edge touching this node silently never match — refuse it up front.\n    if (node.profile.name !== node.id) {\n      throw new ValidationError(\n        `runGraph: node '${node.id}' has profile.name ${JSON.stringify(node.profile.name)} — ` +\n          'profile.name IS the node identity (node pinning and analyst routing match on it) and ' +\n          'must equal the node id',\n      )\n    }\n    byId.set(node.id, node)\n  }\n  const requireNode = (id: NodeId, where: string): GraphNode => {\n    const node = byId.get(id)\n    if (!node) throw new ValidationError(`runGraph: ${where} references unknown node '${id}'`)\n    return node\n  }\n  const delegates = graph.edges.filter(\n    (edge): edge is Extract<GraphEdge, { kind: 'delegates' }> => edge.kind === 'delegates',\n  )\n  const analyzes = graph.edges.filter(\n    (edge): edge is Extract<GraphEdge, { kind: 'analyzes' }> => edge.kind === 'analyzes',\n  )\n  if (delegates.length === 0) {\n    throw new ValidationError('runGraph: at least one delegates edge is required (who spawns whom)')\n  }\n  for (const edge of graph.edges) registry.resolve(edge.directive)\n  for (const edge of delegates) {\n    requireNode(edge.from, edgeId(edge))\n    requireNode(edge.to, edgeId(edge))\n    if (edge.from === edge.to) {\n      throw new ValidationError(\n        `runGraph: ${edgeId(edge)} delegates to itself — the driver↔worker cycle is the ` +\n          'settle-return loop, not a self-edge',\n      )\n    }\n    // The type admits only 'fresh' | 'resume', but a graph is plain data that often arrives\n    // through JSON — refuse a nonsense mode here, never let it reach the spawn tool as a string.\n    if (\n      edge.continuity !== undefined &&\n      edge.continuity !== 'fresh' &&\n      edge.continuity !== 'resume'\n    ) {\n      throw new ValidationError(\n        `runGraph: ${edgeId(edge)} has invalid continuity ${JSON.stringify(edge.continuity)} — ` +\n          \"a delegates edge's continuity is 'fresh' or 'resume'\",\n      )\n    }\n  }\n  // Root: the one node that delegates and is never delegated TO. P0 executes the star/2-node\n  // cyclic family (one driver, N workers); nested driver graphs are the recorded P3 absorption.\n  const delegatedTo = new Set(delegates.map((edge) => edge.to))\n  const roots = [...new Set(delegates.map((edge) => edge.from))].filter(\n    (id) => !delegatedTo.has(id),\n  )\n  if (roots.length !== 1) {\n    throw new ValidationError(\n      `runGraph: expected exactly ONE root (a node that delegates and is never delegated to), ` +\n        `found ${roots.length === 0 ? 'none — delegates edges form a cycle with no entry' : roots.join(', ')}. ` +\n        'P0 executes driver↔worker(s); nested driver graphs are P3.',\n    )\n  }\n  const root = requireNode(roots[0] as string, 'root resolution')\n  for (const edge of delegates) {\n    if (edge.from !== root.id) {\n      throw new ValidationError(\n        `runGraph: ${edgeId(edge)} delegates from a non-root node — P0 executes one driver over ` +\n          'its workers (the 2-node cyclic case, star-generalized); deeper delegation is P3',\n      )\n    }\n  }\n  const analystIds = new Set<string>()\n  const analystNodes = new Map<NodeId, GraphNode>()\n  for (const edge of analyzes) {\n    // Continuity is a delegates-edge axis ONLY: analysts (lens or node) are spawned by the\n    // analyst-on-settle machinery, each run a fresh session over settled evidence — an analyzes\n    // edge carrying continuity would silently mean nothing, so it is refused as data.\n    if ((edge as { continuity?: unknown }).continuity !== undefined) {\n      throw new ValidationError(\n        `runGraph: ${edgeId(edge)} carries continuity — analysts are spawned by the analyst ` +\n          'machinery (every analyst run is a fresh session over settled evidence), so ' +\n          'continuity is a delegates-edge axis only',\n      )\n    }\n    // The runner's traversal ledger resolves a finding/steer back to its edge BY ANALYST ID\n    // alone, so a second edge sharing an analyst would silently absorb the first edge's\n    // traversals (last-registered wins). Multi-edge-per-analyst is not yet supported; refuse it\n    // rather than mis-ledger it.\n    if (analystIds.has(edge.analyst)) {\n      throw new ValidationError(\n        `runGraph: two analyzes edges share analyst '${edge.analyst}' — one analyzes edge per ` +\n          'analyst lens (traversals are ledgered by analyst id; a second edge would silently ' +\n          \"absorb the first's). Register the lens under a second id for a second edge.\",\n      )\n    }\n    analystIds.add(edge.analyst)\n    // The analyst REFERENCE has two forms — a registry lens id or a graph node id — and the id\n    // itself is what distinguishes them, so an id living in both is refused as ambiguous rather\n    // than silently resolved by precedence.\n    const analystNode = byId.get(edge.analyst)\n    const inRegistry = analysts?.kinds.some((kind) => kind.id === edge.analyst) === true\n    if (analystNode !== undefined && inRegistry) {\n      throw new ValidationError(\n        `runGraph: ${edgeId(edge)} analyst '${edge.analyst}' is BOTH a graph node and a lens in ` +\n          'the analysts registry — the id alone distinguishes the two analyst forms, so this is ' +\n          'ambiguous; rename the node or register the lens under another id',\n      )\n    }\n    if (analystNode !== undefined) {\n      // The analyst-AGENT form. Oracle doctrine holds structurally: the analyst node can never\n      // receive work — not from the root (a delegates edge to it is refused) and not by being\n      // the root (the root delegates by definition).\n      if (analystNode.id === root.id) {\n        throw new ValidationError(\n          `runGraph: ${edgeId(edge)} names the ROOT as its analyst — the root is the driver; ` +\n            'give the analyst its own node with no delegates edge pointing at it',\n        )\n      }\n      if (delegatedTo.has(analystNode.id)) {\n        throw new ValidationError(\n          `runGraph: ${edgeId(edge)} names node '${edge.analyst}' as its analyst, but that node ` +\n            'is a delegates target — oracle doctrine: an analyst is never delegated to. An ' +\n            'analyst NODE is legal only with NO delegates edge pointing at it; give the analyst ' +\n            'its own delegates-free node or pass a lens id from RunGraphOptions.analysts.',\n        )\n      }\n      analystNodes.set(analystNode.id, analystNode)\n    } else if (!analysts) {\n      throw new ValidationError(\n        `runGraph: ${edgeId(edge)} analyst '${edge.analyst}' is not a graph node, and no ` +\n          'RunGraphOptions.analysts registry was provided to resolve it as a lens',\n      )\n    } else if (!inRegistry) {\n      throw new ValidationError(\n        `runGraph: ${edgeId(edge)} analyst '${edge.analyst}' is neither a graph node nor in the ` +\n          `analysts registry (known lenses: ${analysts.kinds.map((kind) => kind.id).join(', ') || 'none'})`,\n      )\n    }\n    if (edge.over.length === 0) {\n      throw new ValidationError(`runGraph: ${edgeId(edge)} must analyze at least one node`)\n    }\n    for (const over of edge.over) {\n      requireNode(over, edgeId(edge))\n      // Analysts observe SETTLED WORKERS, matched by profile name — the root drives and never\n      // settles as a worker, so an edge over the root would silently never fire; refuse it.\n      if (over === root.id) {\n        throw new ValidationError(\n          `runGraph: ${edgeId(edge)} analyzes the ROOT — analysts observe settled workers, and ` +\n            'the root never settles as one, so this edge would silently never fire; list ' +\n            'delegates-target nodes only',\n        )\n      }\n    }\n    requireNode(edge.to, edgeId(edge))\n  }\n  // Second pass, once every analyst NODE is known: an analyst run's settlement is a FINDING,\n  // never a worker settle, so an analyzes edge OVER an analyst node would silently never fire —\n  // refuse it rather than let it rot unobserved.\n  for (const edge of analyzes) {\n    for (const over of edge.over) {\n      if (analystNodes.has(over)) {\n        throw new ValidationError(\n          `runGraph: ${edgeId(edge)} analyzes '${over}', which is an analyst node — an analyst ` +\n            'run settles as a finding, never as a worker, so this edge would silently never ' +\n            'fire; analyst nodes are not analyzable',\n        )\n      }\n    }\n  }\n  const workers = new Map<NodeId, GraphNode>()\n  const delegatesByWorker = new Map<NodeId, Extract<GraphEdge, { kind: 'delegates' }>>()\n  for (const edge of delegates) {\n    if (delegatesByWorker.has(edge.to)) {\n      throw new ValidationError(\n        `runGraph: node '${edge.to}' is the target of two delegates edges — one delegation ` +\n          'directive per worker node (version the directive instead of forking the edge)',\n      )\n    }\n    delegatesByWorker.set(edge.to, edge)\n    workers.set(edge.to, requireNode(edge.to, edgeId(edge)))\n  }\n  // Every non-root node must be reachable by SOME edge, or it can never run. A worker node is\n  // reached by its delegates edge; an analyst node by its analyzes edge (spawned on settle).\n  for (const node of graph.nodes) {\n    if (node.id !== root.id && !workers.has(node.id) && !analystNodes.has(node.id)) {\n      throw new ValidationError(\n        `runGraph: node '${node.id}' has no delegates edge to it — an unreachable node never runs`,\n      )\n    }\n  }\n  return { root, workers, delegatesByWorker, analyzes, analystNodes }\n}\n\n// ── The runner ─────────────────────────────────────────────────────────────────\n\nconst byteLength = (text: string): number => Buffer.byteLength(text, 'utf8')\n\nfunction stringifyPayload(payload: unknown): string {\n  if (typeof payload === 'string') return payload\n  try {\n    return JSON.stringify(payload) ?? String(payload)\n  } catch {\n    return String(payload)\n  }\n}\n\n/**\n * Execute an {@link AgentGraph}. The root node becomes the supervisor (`supervise()` — the\n * execution core), each worker node is spawnable BY NODE ID (`spawn_agent` with\n * `profile: { name: '<node id>' }`; the node's canonical profile is pinned by the graph), each\n * delegates directive is appended to the worker profile's `prompt.instructions` per traversal,\n * and each analyzes edge becomes an analyst-on-settle route with a real DESTINATION. Every\n * traversal is ledgered and journaled.\n */\nexport function runGraph(graph: AgentGraph, opts: RunGraphOptions): Promise<GraphResult> {\n  const { brain, ...runtimeOptions } = opts\n  return superviseAgentGraph(graph, runtimeOptions, brain)\n}\n\n/** Alias for graph tests written before `RunGraphOptions.brain` was production. The production\n *  entry accepts the same shape; this wrapper only keeps the `/testing` import path working. */\nexport function runGraphWithTestBrain(\n  graph: AgentGraph,\n  opts: RunGraphTestOptions,\n): Promise<GraphResult> {\n  const { brain, ...runtimeOptions } = opts\n  return superviseAgentGraph(graph, runtimeOptions, brain)\n}\n\n/**\n * The graph supervise run, as its own entry: the engine's `run-graph` preset node executes exactly\n * this, so the preset and `runGraph` are the same code path by construction (agent-runtime#982).\n */\n/**\n * Every refusal a graph earns before any compute, in one place: the authoring contract. `runGraph`\n * calls it FIRST so a malformed graph throws synchronously, exactly as it did before the engine\n * preset (agent-runtime#982) moved execution behind a promise.\n */\nexport function assertRunGraphAuthoring(\n  graph: AgentGraph,\n  opts: RunGraphOptions,\n  brain?: ToolLoopChat,\n): ReturnType<typeof validateGraph> {\n  const registry = opts.registry ?? kernelPromptRegistry()\n  const validated = validateGraph(graph, registry, opts.analysts)\n  const { root } = validated\n  // A caller brain and a harness driver are two answers to WHO makes the root's calls: refuse the\n  // contradiction before any compute, and refuse a harness-driven root outright — the harness IS\n  // that root's brain, so a supplied one would be silently ignored downstream.\n  if (brain && opts.driverBackend) {\n    throw new ValidationError(\n      'runGraph: brain and driverBackend are mutually exclusive — a caller brain makes the root model calls, a driverBackend places a harness that makes its own',\n    )\n  }\n  if (brain && harnessRunsAgent(root.profile.harness)) {\n    throw new ValidationError(\n      `runGraph: root node '${root.id}' declares harness '${root.profile.harness}', so the harness drives it — a caller brain applies only to a router-brained root (profile.harness omitted or 'cli-base')`,\n    )\n  }\n  if (!opts.backend && !opts.makeLeafAgent) {\n    throw new ValidationError(\n      'runGraph: provide opts.backend (where nodes run) or opts.makeLeafAgent',\n    )\n  }\n  return validated\n}\n\nexport function superviseAgentGraph(\n  graph: AgentGraph,\n  opts: RunGraphOptions,\n  brain?: ToolLoopChat,\n): Promise<GraphResult> {\n  const registry = opts.registry ?? kernelPromptRegistry()\n  const { root, workers, delegatesByWorker, analyzes, analystNodes } = assertRunGraphAuthoring(\n    graph,\n    opts,\n    brain,\n  )\n  const journal = opts.journal ?? new InMemorySpawnJournal()\n  const blobs = opts.blobs ?? new InMemoryResultBlobStore()\n  const runId =\n    opts.runId ??\n    `graph-${canonicalCandidateDigest(graph.nodes.map((n) => n.id)).slice('sha256:'.length, 'sha256:'.length + 12)}`\n  const now = opts.now ?? Date.now\n\n  // ── Ledger state ──\n  const ledger: EdgeTraversal[] = []\n  const journaled = new Set<EdgeTraversal>()\n  const traversalCounts = new Map<string, number>()\n  const exhausted = new Set<string>()\n  // The subset of `exhausted` that REFUSED work. Only a delegates cap closes the spawn cycle, so\n  // only it can be the reason a run ended winnerless — an analyzes cap refuses nothing.\n  const exhaustedDelegates = new Set<string>()\n  const journalWrites: Promise<void>[] = []\n  let ledgerSeq = 0\n  const appendJournal = (entry: EdgeTraversal, nodeIdForEvent: string): Promise<void> => {\n    if (journaled.has(entry)) return Promise.resolve()\n    journaled.add(entry)\n    const write = journal.appendEvent(runId, {\n      kind: 'edge',\n      id: nodeIdForEvent,\n      edge: { kind: entry.kind, from: entry.from, to: entry.to, directive: entry.directive },\n      traversal: entry.traversal,\n      outcome: entry.outcome,\n      continuity: entry.continuity,\n      bytes: entry.bytes,\n      ...(entry.reason !== undefined ? { reason: entry.reason } : {}),\n      seq: ledgerSeq++,\n      at: new Date(now()).toISOString(),\n    })\n    journalWrites.push(write)\n    return write\n  }\n  const record = (entry: Omit<EdgeTraversal, 'traversal'>, journalNow: boolean): EdgeTraversal => {\n    const count = (traversalCounts.get(entry.edge) ?? 0) + 1\n    traversalCounts.set(entry.edge, count)\n    const row: EdgeTraversal = { ...entry, traversal: count }\n    ledger.push(row)\n    if (journalNow) void appendJournal(row, row.workerId ?? `graph:${row.to}`)\n    return row\n  }\n\n  // ── Node pinning + delegates spawn traversals (the authorizeSpawn wrapper) ──\n  // Pinning lives in `authorizeSpawn`, which the kernel runs BEFORE it decides whether a child is\n  // a leaf or a nested supervisor. That is what lets a node declared `role: 'driver'` become a real\n  // supervisor carrying its canonical profile: the kernel's `isDriver` reads the PINNED profile,\n  // not the driver-authored `{ name }` stub. (It used to live in `makeWorkerAgent`, a leaf-only\n  // seam, which made every node a leaf no matter what its profile declared — #965.)\n  const nodeByWorkerId = new Map<string, NodeId>()\n  const pendingByAssignment = new Map<string, EdgeTraversal>()\n  type SpawnAuthorizationInput = Parameters<NonNullable<SuperviseOptions['authorizeSpawn']>>[0]\n  const pinNode = (input: SpawnAuthorizationInput): AgentProfile => {\n    const requested =\n      typeof (input.profile as { name?: unknown } | undefined)?.name === 'string'\n        ? (input.profile as { name: string }).name\n        : undefined\n    // An analyst-AGENT run: the coordination settle hook — never the driver; the marker is\n    // authored by the runtime, not accepted from model arguments — spawns the analyst NODE.\n    // Pin the node's canonical profile; the analysis directive travels as the TASK (composed by\n    // the coordination layer with the settled worker's trace evidence), so nothing is appended\n    // to the profile's instructions here. Its traversal is ledgered on the finding/steer it\n    // produces, exactly like a registry analyst's.\n    if (input.analyst !== undefined) {\n      const analystNode = analystNodes.get(input.analyst)\n      if (!analystNode || requested !== analystNode.id) {\n        throw new ValidationError(\n          `runGraph: analyst run for ${JSON.stringify(input.analyst)} does not name an ` +\n            `analyst node of this graph (analyst nodes: ${[...analystNodes.keys()].join(', ') || 'none'})`,\n        )\n      }\n      return analystNode.profile\n    }\n    const node = requested !== undefined ? workers.get(requested) : undefined\n    if (!node) {\n      throw new ValidationError(\n        `runGraph: spawn_agent named profile ${JSON.stringify(requested)} which is not a worker ` +\n          `node of this graph (nodes: ${[...workers.keys()].join(', ')}). Spawn by node id: ` +\n          'profile.name selects the node; the node profile itself is pinned by the graph.',\n      )\n    }\n    const edge = delegatesByWorker.get(node.id) as Extract<GraphEdge, { kind: 'delegates' }>\n    const id = edgeId(edge)\n    const cap = edge.maxTraversals ?? defaultEdgeTraversalCap\n    const used = traversalCounts.get(id) ?? 0\n    // The EFFECTIVE spawn mode the coordination layer resolved (per-call override, else this\n    // edge's declared default, else fresh) — stamped on the row so the ledger states how each\n    // hop continued, never how it was merely configured to.\n    const spawnContinuity = input.continuity ?? 'fresh'\n    if (used >= cap) {\n      exhausted.add(id)\n      exhaustedDelegates.add(id)\n      record(\n        {\n          edge: id,\n          kind: 'delegates',\n          from: edge.from,\n          to: edge.to,\n          directive: formatPromptHandle(edge.directive),\n          outcome: 'unpropagated',\n          continuity: spawnContinuity,\n          bytes: 0,\n          reason: `traversal-cap-exhausted (max ${cap})`,\n        },\n        true,\n      )\n      throw new ValidationError(\n        `runGraph: delegates edge ${id} exhausted its traversal cap (${cap}) — the ` +\n          'cyclic-graph backstop refused this spawn',\n      )\n    }\n    const directiveText = registry.resolve(edge.directive).text\n    const taskText = stringifyPayload(input.task)\n    const bytes = byteLength(directiveText) + byteLength(taskText)\n    const row = record(\n      {\n        edge: id,\n        kind: 'delegates',\n        from: edge.from,\n        to: edge.to,\n        directive: formatPromptHandle(edge.directive),\n        outcome: bytes === 0 ? 'empty' : 'delivered',\n        continuity: spawnContinuity,\n        bytes,\n        ...(bytes === 0 ? { reason: 'no directive text and no task payload' } : {}),\n      },\n      false,\n    )\n    pendingByAssignment.set(input.assignmentId, row)\n    // The delegation directive is a STANDING instruction of this traversal: appended to the\n    // node's canonical prompt instructions, so the worker runs under node profile + edge\n    // directive, and the driver-authored profile contributes ONLY the node selection.\n    return directiveText.length === 0\n      ? node.profile\n      : {\n          ...node.profile,\n          prompt: {\n            ...(node.profile.prompt ?? {}),\n            instructions: [\n              ...((node.profile.prompt?.instructions as readonly string[] | undefined) ?? []),\n              directiveText,\n            ],\n          },\n        }\n  }\n  // The pre-journal gate (a bridge backend's route/admission check) must judge the profile that\n  // will run, not the `{ name }` stub — otherwise every graph spawn over a bridge is refused\n  // `model-route` before the graph ever pins it. This resolver is PURE: it answers \"which node\"\n  // without ledgering, because the gate may refuse and nothing may be journaled for a refusal.\n  const resolveSpawnProfile = (authored: AgentProfile): AgentProfile => {\n    const requested = typeof authored.name === 'string' ? authored.name : undefined\n    const node =\n      (requested !== undefined ? workers.get(requested) : undefined) ??\n      (requested !== undefined ? analystNodes.get(requested) : undefined)\n    // Unknown names fall through to authorizeSpawn, which refuses them with the full message and\n    // a ledger row; the gate just sees the stub and lets that later refusal speak.\n    return node?.profile ?? authored\n  }\n  // Graph authority first, then the caller's: a product authorizing spawns sees the CANONICAL\n  // node profile (what will actually run), never the driver's `{ name }` stub.\n  const graphAuthorizeSpawn: NonNullable<SuperviseOptions['authorizeSpawn']> = (input) => {\n    const pinned = pinNode(input)\n    if (!opts.authorizeSpawn) return { profile: pinned }\n    return opts.authorizeSpawn({ ...input, profile: pinned })\n  }\n\n  // ── Analyzes edges → analyst-on-settle routes with destinations ──\n  // A LENS edge's directive wraps the findings for the recipient (so a driver-destined lens\n  // route carries no directive — it becomes the driver brief below). A NODE edge's directive is\n  // the analyst AGENT's task, so it always rides the route, wherever the findings go.\n  const routes: Array<string | AnalyzeOnSettleRoute> = analyzes.map((edge) => {\n    const analystNode = analystNodes.get(edge.analyst)\n    if (analystNode) {\n      return {\n        kind: edge.analyst,\n        over: edge.over,\n        agent: analystNode.profile,\n        directive: registry.resolve(edge.directive).text,\n        ...(edge.to === root.id ? {} : { to: edge.to }),\n      }\n    }\n    return edge.to === root.id\n      ? { kind: edge.analyst, over: edge.over }\n      : {\n          kind: edge.analyst,\n          over: edge.over,\n          to: edge.to,\n          directive: registry.resolve(edge.directive).text,\n        }\n  })\n  // Driver-destined analyzes findings are standing knowledge for the ROOT: the findings arrive\n  // as bus events. For a lens edge the directive tells the driver what to do with them; for a\n  // node edge the directive already went to the analyst agent as its task.\n  const driverAnalyzesBriefs = analyzes\n    .filter((edge) => edge.to === root.id)\n    .map((edge) =>\n      analystNodes.has(edge.analyst)\n        ? `Findings from analyst '${edge.analyst}' (a tool-equipped analyst agent node, over: ` +\n          `${edge.over.join(', ')}) will arrive as finding events.`\n        : `Findings from analyst '${edge.analyst}' (over: ${edge.over.join(', ')}) will arrive as ` +\n          `finding events.\\n${registry.resolve(edge.directive).text}`,\n    )\n\n  // ── Edge continuity defaults, threaded to the spawn tool by node id (= profile name) ──\n  const continuityByProfile: Record<string, ContinuityMode> = {}\n  for (const [nodeId, edge] of delegatesByWorker) {\n    if (edge.continuity !== undefined) continuityByProfile[nodeId] = edge.continuity\n  }\n\n  // ── The driver graph brief: which nodes it may spawn, by exact name ──\n  const workerLines = [...workers.values()].map((node) => {\n    const edge = delegatesByWorker.get(node.id) as Extract<GraphEdge, { kind: 'delegates' }>\n    const cap = edge.maxTraversals ?? defaultEdgeTraversalCap\n    const description =\n      typeof node.profile.description === 'string' && node.profile.description.length > 0\n        ? ` — ${node.profile.description}`\n        : ''\n    const continuityNote =\n      edge.continuity === 'resume'\n        ? \"; continuity: resume — each spawn after the first re-attaches to this node's latest \" +\n          'settled session (spawn again to continue it; steer while it is live)'\n        : ''\n    return `- '${node.id}'${description} (delegation cap: ${cap} traversals${continuityNote})`\n  })\n  const graphBrief = [\n    'AGENT GRAPH: you are the driver node of a fixed topology. You may spawn ONLY these worker',\n    \"nodes, by EXACT name (spawn_agent with profile: { name: '<node id>' }; the node's full\",\n    'profile is pinned by the graph — any other profile fields you author are ignored):',\n    ...workerLines,\n    ...(driverAnalyzesBriefs.length > 0 ? ['', ...driverAnalyzesBriefs] : []),\n  ].join('\\n')\n  const rootProfile: AgentProfile = {\n    ...root.profile,\n    prompt: {\n      ...(root.profile.prompt ?? {}),\n      instructions: [\n        ...((root.profile.prompt?.instructions as readonly string[] | undefined) ?? []),\n        graphBrief,\n      ],\n    },\n  }\n\n  // ── Steer + finding observation (delegates steers, analyzes traversals) ──\n  // The filter seam: when the caller's authorizeMessage NARROWS an instruction, the delivered\n  // bytes differ from the composed bytes — that steer traversal is `stripped` (the VB incident:\n  // authored steering silently replaced by boilerplate, byte-indistinguishable downstream).\n  const strippedByDigest = new Map<string, { composedBytes: number }>()\n  // Always present: the kernel refuses steer/answer whenever spawn authorization is on (the\n  // graph's pinning IS spawn authorization), so a graph with no caller filter passes instructions\n  // through unchanged rather than losing its steer channel. Only a caller filter can strip.\n  const authorizeMessage: NonNullable<SuperviseOptions['authorizeMessage']> = (input) => {\n    if (!opts.authorizeMessage) return { instruction: input.instruction }\n    const decision = opts.authorizeMessage(input)\n    if (decision.instruction !== input.instruction) {\n      strippedByDigest.set(canonicalCandidateDigest(decision.instruction), {\n        composedBytes: byteLength(input.instruction),\n      })\n    }\n    return decision\n  }\n\n  const routedAnalyzesByAnalyst = new Map<string, Extract<GraphEdge, { kind: 'analyzes' }>>()\n  const driverAnalyzesByAnalyst = new Map<string, Extract<GraphEdge, { kind: 'analyzes' }>>()\n  for (const edge of analyzes) {\n    ;(edge.to === root.id ? driverAnalyzesByAnalyst : routedAnalyzesByAnalyst).set(\n      edge.analyst,\n      edge,\n    )\n  }\n  const analyzesCapReached = (edge: Extract<GraphEdge, { kind: 'analyzes' }>): boolean => {\n    const cap = edge.maxTraversals ?? defaultEdgeTraversalCap\n    const used = traversalCounts.get(edgeId(edge)) ?? 0\n    if (used < cap) return false\n    exhausted.add(edgeId(edge))\n    return true\n  }\n  const ledgerAnalyzes = (\n    edge: Extract<GraphEdge, { kind: 'analyzes' }>,\n    outcome: EdgeDeliveryOutcome,\n    bytes: number,\n    reason: string | undefined,\n    workerId: string | undefined,\n  ): void => {\n    const capped = analyzesCapReached(edge)\n    record(\n      {\n        edge: edgeId(edge),\n        kind: 'analyzes',\n        from: edge.over.join('+'),\n        to: edge.to,\n        directive: formatPromptHandle(edge.directive),\n        outcome: capped ? 'unpropagated' : outcome,\n        // Every analyzes traversal is a mid-run delivery into an already-live recipient (a\n        // routed steer leg, or the finding reaching the live driver) — never a spawn.\n        continuity: 'steer',\n        bytes,\n        ...(capped\n          ? {\n              reason: `traversal-cap-exhausted (max ${edge.maxTraversals ?? defaultEdgeTraversalCap})`,\n            }\n          : reason !== undefined\n            ? { reason }\n            : {}),\n        ...(workerId !== undefined ? { workerId } : {}),\n      },\n      true,\n    )\n  }\n\n  const onCoordinationEvent = async (\n    _context: unknown,\n    _eventId: unknown,\n    recordEnvelope: { readonly event: CoordinationEvent },\n  ): Promise<void> => {\n    const event = recordEnvelope.event\n    if (event.type === 'finding') {\n      // A routed edge's traversal is ledgered on its STEER (the delivery); the finding event is\n      // its audit copy. A driver-destined edge's traversal IS the finding reaching the bus.\n      const edge = driverAnalyzesByAnalyst.get(event.finding.analyst)\n      if (!edge) return\n      const sourceNode = nodeByWorkerId.get(event.finding.fromWorker)\n      if (sourceNode === undefined || !edge.over.includes(sourceNode)) return\n      // Absent findings (the analyst returned `undefined` — the producer omits the key so the\n      // event stays digestable) contribute ZERO bytes, never the text \"undefined\".\n      const findingsText =\n        event.finding.findings === undefined ? '' : stringifyPayload(event.finding.findings)\n      const directiveBytes = byteLength(registry.resolve(edge.directive).text)\n      const empty = findingsText.length === 0\n      ledgerAnalyzes(\n        edge,\n        empty ? 'empty' : 'delivered',\n        directiveBytes + byteLength(findingsText),\n        empty ? 'analyst returned no findings' : undefined,\n        event.finding.fromWorker,\n      )\n      return\n    }\n    if (event.type === 'steer') {\n      const down = event.down\n      if (event.analyst !== undefined) {\n        const edge = routedAnalyzesByAnalyst.get(event.analyst)\n        if (!edge) return\n        ledgerAnalyzes(\n          edge,\n          down.delivered ? 'delivered' : 'unpropagated',\n          byteLength(down.instruction),\n          down.delivered ? undefined : down.outcome,\n          down.toWorker,\n        )\n        return\n      }\n      // A driver-authored steer to a live worker node is a delegates traversal too — the\n      // mid-run leg of the same edge (the leg the motivating incident lost).\n      const nodeId = nodeByWorkerId.get(down.toWorker)\n      if (nodeId === undefined) return\n      const edge = delegatesByWorker.get(nodeId)\n      if (!edge) return\n      const stripped = strippedByDigest.get(down.instructionDigest)\n      record(\n        {\n          edge: edgeId(edge),\n          kind: 'delegates',\n          from: edge.from,\n          to: edge.to,\n          directive: formatPromptHandle(edge.directive),\n          outcome: !down.delivered ? 'unpropagated' : stripped ? 'stripped' : 'delivered',\n          // The mid-run leg of the edge: a delivery into the LIVE worker, never a spawn.\n          continuity: 'steer',\n          bytes: byteLength(down.instruction),\n          ...(!down.delivered\n            ? { reason: down.outcome }\n            : stripped\n              ? { reason: `authorization narrowed ${stripped.composedBytes} composed bytes` }\n              : {}),\n          workerId: down.toWorker,\n        },\n        true,\n      )\n    }\n  }\n\n  // ── Spawn-hook: bind ledger rows to concrete worker ids, then journal them ──\n  const graphHooks = {\n    onEvent: (event: {\n      target?: string\n      phase?: string\n      payload?: unknown\n    }): void | Promise<void> => {\n      if (event.target !== 'agent.spawn' || event.phase !== 'after') return\n      const payload = event.payload as { childId?: unknown; assignmentId?: unknown } | undefined\n      if (typeof payload?.childId !== 'string' || typeof payload.assignmentId !== 'string') return\n      const pending = pendingByAssignment.get(payload.assignmentId)\n      if (!pending) return\n      pendingByAssignment.delete(payload.assignmentId)\n      const bound: EdgeTraversal = { ...pending, workerId: payload.childId }\n      ledger[ledger.indexOf(pending)] = bound\n      nodeByWorkerId.set(payload.childId, bound.to)\n      return appendJournal(bound, payload.childId)\n    },\n  }\n  const hooks = composeRuntimeHooks(graphHooks, opts.hooks)\n\n  // Every configuration fault above throws SYNCHRONOUSLY (matching `supervise()`'s own\n  // contract); only the run itself is asynchronous.\n  const start = async (): Promise<GraphResult> => {\n    const superviseOptions = {\n      // Every forwarded option the caller set, including the ones nobody thought to list here.\n      // `backend` rides along: the kernel derives every authorized LEAF from it, under the graph's\n      // pinning. The root driver stays an explicit `driverBackend` choice: `rootDriverFromBackend:\n      // false` stops supervise() defaulting one from the other, so where workers run never selects\n      // where the root runs (the axis split every graph caller relies on).\n      ...forwardedSuperviseOptions(opts),\n      rootDriverFromBackend: false,\n      // Graph-owned values come after the spread: the graph, not the caller, decides these.\n      budget: graph.budget,\n      deliverable: graph.deliverable,\n      authorizeSpawn: graphAuthorizeSpawn,\n      resolveSpawnProfile,\n      ...(opts.makeLeafAgent ? { makeLeafAgent: opts.makeLeafAgent } : {}),\n      journal,\n      blobs,\n      runId,\n      hooks,\n      onCoordinationEvent,\n      // Lens routes resolve against the registry; agent routes carry their own analyst profile,\n      // so a graph whose only analysts are nodes needs no registry at all.\n      ...(routes.length > 0\n        ? { analyzeOnSettle: routes, ...(opts.analysts ? { analysts: opts.analysts } : {}) }\n        : {}),\n      ...(Object.keys(continuityByProfile).length > 0 ? { continuityByProfile } : {}),\n      authorizeMessage,\n    } satisfies SuperviseOptions\n    const result =\n      brain === undefined\n        ? await supervise(rootProfile, graphTask(graph, root), superviseOptions)\n        : await superviseWithTestBrain(rootProfile, graphTask(graph, root), {\n            ...superviseOptions,\n            brain,\n          })\n\n    // A spawn row is PROVISIONAL until the `agent.spawn` hook (fired synchronously once a worker\n    // exists) binds it to a live worker id. A row still unbound here means the factory ran but no\n    // NEW worker went live: the spawn was refused after the factory (identity conflict, runtime\n    // floor) or a keyed re-spawn deduplicated to an already-completed result (prepare() runs the\n    // factory, no hook fires). Both state the same truth every unpropagated row states — the\n    // directive never reached a live worker — so rewrite rather than mint a new outcome. Then\n    // settle every journal write, so the ledger's journal twin is complete when this returns.\n    for (const pending of pendingByAssignment.values()) {\n      const refused: EdgeTraversal = {\n        ...pending,\n        outcome: 'unpropagated',\n        bytes: 0,\n        reason: `no-live-worker-bound (spawn refused after the factory, or a keyed re-spawn deduplicated to a completed result; ${pending.bytes} composed bytes never crossed)`,\n      }\n      ledger[ledger.indexOf(pending)] = refused\n      await appendJournal(refused, `graph:${refused.to}`)\n    }\n    pendingByAssignment.clear()\n    await Promise.all(journalWrites)\n\n    const exhaustedEdges = Object.freeze([...exhausted])\n    const frozenLedger = Object.freeze(ledger.map((row) => Object.freeze({ ...row })))\n    // A LIFECYCLE ending (caller abort, exhausted budget) is its own complete explanation: the\n    // cap did not end that run even when it was exhausted along the way, and blaming it would\n    // misattribute the ending (and turn a caller-initiated abort into a throw). The exhaustion\n    // stays observable in `exhaustedEdges` either way.\n    const lifecycleEnded =\n      result.kind === 'no-winner' &&\n      (result.reason === 'aborted' || result.reason === 'budget-exhausted')\n    if (result.kind !== 'winner' && !lifecycleEnded && exhaustedDelegates.size > 0) {\n      // Fail LOUD: the backstop, not the task, ended this run. The evidence rides on the error.\n      // Only DELEGATES caps refuse spawns, so only they can be the cause named here.\n      throw new GraphEdgeCapError(Object.freeze([...exhaustedDelegates]), frozenLedger, result)\n    }\n    return { result, ledger: frozenLedger, exhaustedEdges, runId }\n  }\n\n  return start()\n}\n\n/** The root task: the graph's own framing. The deliverable (mandatory) is the termination; the\n *  task names what the topology exists to produce. */\nfunction graphTask(graph: AgentGraph, root: GraphNode): string {\n  const describe = graph.deliverable.describe\n  return (\n    describe ?? `Deliver the graph's deliverable by driving your worker nodes (root: '${root.id}').`\n  )\n}\n"],"mappings":"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"}

package/dist/sandbox-events-B2cWfjwu.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"sandbox-events-B2cWfjwu.js","names":[],"sources":["../src/runtime/timestamps.ts","../src/runtime/sandbox-transport-events.ts","../src/runtime/sandbox-events.ts"],"sourcesContent":["import { RuntimeEventEnvelopeSchema } from '@tangle-network/agent-interface'\n\nconst validTimestamp = '2026-01-01T00:00:00.000Z'\n\n/** Validate a timestamp with the public runtime envelope contract. */\nexport function assertRuntimeTimestamp(value: unknown, label: string): asserts value is string {\n  try {\n    RuntimeEventEnvelopeSchema.parse({\n      runId: 'runtime',\n      eventId: 'event',\n      sequence: 0,\n      occurredAt: value,\n      receivedAt: validTimestamp,\n      event: { type: 'status', status: 'processing' },\n    })\n  } catch (error) {\n    throw new Error(`${label} must be a valid ISO timestamp`, { cause: error })\n  }\n}\n\n/** Return whether a value satisfies the public runtime timestamp contract. */\nexport function isRuntimeTimestamp(value: unknown): value is string {\n  try {\n    assertRuntimeTimestamp(value, 'occurredAt')\n    return true\n  } catch {\n    return false\n  }\n}\n","import { CanonicalStreamEventSchema, type StreamEvent } from '@tangle-network/agent-interface'\nimport { assertRuntimeTimestamp } from './timestamps'\n\n/**\n * Transport type whose payload is the harness's OWN event, passed through verbatim.\n *\n * A `raw` payload names a harness-native type from a vocabulary the canonical schema does not\n * define (codex emits `thread.started` / `turn.started` / `turn.completed`). The transport type is\n * therefore the only canonical statement such an event makes, and its payload must never be read\n * as a canonical type: the mismatch guard below exists to catch a producer that MISLABELS a\n * canonical event, which a harness-native payload cannot do. A payload that does satisfy the\n * canonical `raw` shape (`backend` + `event`) still parses; anything else is not a canonical\n * event, and the caller reads it off the transport event instead.\n */\nconst harnessNativePayloadType = 'raw'\n\n/** Parse canonical payload fields without treating transport identity as event data. */\nexport function parseCanonicalTransportEvent(\n  type: unknown,\n  data: Record<string, unknown>,\n  normalized: unknown,\n  source: string,\n): StreamEvent | undefined {\n  if (!isRecord(data)) {\n    throw new Error(`${source} emitted a canonical event without an object payload`)\n  }\n  const outerType = String(type ?? '')\n  const harnessNative = outerType === harnessNativePayloadType\n  if (normalized !== undefined) {\n    if (\n      !harnessNative &&\n      typeof normalized === 'object' &&\n      normalized !== null &&\n      'type' in normalized &&\n      typeof normalized.type === 'string' &&\n      normalized.type !== outerType\n    ) {\n      throw new Error(\n        `${source} canonical event type \"${normalized.type}\" does not match transport type \"${outerType}\"`,\n      )\n    }\n    const candidate = CanonicalStreamEventSchema.safeParse(normalized)\n    if (!candidate.success) {\n      if (harnessNative) return undefined\n      throw new Error(`${source} emitted an invalid normalized canonical event`, {\n        cause: candidate.error,\n      })\n    }\n    return candidate.data\n  }\n  const {\n    type: embeddedType,\n    eventId: _eventId,\n    cursor: _cursor,\n    sequence: _sequence,\n    occurredAt: _occurredAt,\n    normalized: _normalized,\n    ...payload\n  } = data\n  if (!harnessNative && embeddedType !== undefined && embeddedType !== outerType) {\n    throw new Error(\n      `${source} canonical event type \"${String(embeddedType)}\" does not match transport type \"${outerType}\"`,\n    )\n  }\n  const candidate = CanonicalStreamEventSchema.safeParse({ ...payload, type: outerType })\n  return candidate.success ? candidate.data : undefined\n}\n\n/** Identity fields carried by either the transport envelope or its data payload. */\nexport interface TransportEventIdentity {\n  readonly eventId?: string\n  readonly cursor?: string\n  readonly sequence?: number\n  readonly occurredAt?: string\n}\n\n/** Extract shared event identity without privileging one provider wire shape. */\nexport function extractTransportEventIdentity(event: unknown): TransportEventIdentity {\n  const record = isRecord(event) ? event : {}\n  const data = isRecord(record.data) ? record.data : {}\n  const providerEvent = isRecord(record.providerEvent) ? record.providerEvent : {}\n  const providerData = isRecord(providerEvent.data) ? providerEvent.data : {}\n  const eventId = canonicalEventId(record, data, providerEvent, providerData)\n  const cursor = stableString(\n    record.cursor ?? data.cursor ?? providerEvent.cursor ?? providerData.cursor,\n  )\n  const sequence = optionalSequence(\n    record.sequence ?? data.sequence ?? providerEvent.sequence ?? providerData.sequence,\n  )\n  const occurredAt = optionalTimestamp(\n    record.occurredAt ?? data.occurredAt ?? providerEvent.occurredAt ?? providerData.occurredAt,\n  )\n  return {\n    ...(eventId === undefined ? {} : { eventId }),\n    ...(cursor === undefined ? {} : { cursor }),\n    ...(sequence === undefined ? {} : { sequence }),\n    ...(occurredAt === undefined ? {} : { occurredAt }),\n  }\n}\n\nfunction canonicalEventId(\n  record: Record<string, unknown>,\n  data: Record<string, unknown>,\n  providerEvent: Record<string, unknown>,\n  providerData: Record<string, unknown>,\n): string | undefined {\n  const candidates = [\n    ['data.eventId', data.eventId],\n    ['providerEvent.eventId', providerEvent.eventId],\n    ['providerData.eventId', providerData.eventId],\n    ['record.eventId', record.eventId],\n  ] as const\n  const present = candidates.filter(([, value]) => value !== undefined)\n  // `record.id` may be the provider's replay cursor, so use it only without a canonical field.\n  if (present.length === 0) return stableString(record.id ?? providerEvent.id)\n\n  const normalized = present.map(([source, value]) => {\n    const eventId = stableString(value)\n    if (eventId === undefined) throw new Error(`transport event ${source} must be a stable string`)\n    return { source, eventId }\n  })\n  const first = normalized[0]!\n  if (normalized.some((candidate) => candidate.eventId !== first.eventId)) {\n    throw new Error('transport event canonical identities disagree')\n  }\n  return first.eventId\n}\n\nfunction stableString(value: unknown): string | undefined {\n  return typeof value === 'string' && value.length > 0 && value.trim() === value ? value : undefined\n}\n\nfunction finiteNonNegativeInteger(value: unknown): number | undefined {\n  return typeof value === 'number' && Number.isSafeInteger(value) && value >= 0 ? value : undefined\n}\n\nfunction optionalSequence(value: unknown): number | undefined {\n  if (value === undefined) return undefined\n  if (finiteNonNegativeInteger(value) === undefined) {\n    throw new Error('transport event sequence must be a non-negative safe integer')\n  }\n  return value as number\n}\n\nfunction optionalTimestamp(value: unknown): string | undefined {\n  if (value === undefined) return undefined\n  assertRuntimeTimestamp(value, 'occurredAt')\n  return value\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value)\n}\n","/**\n * Sandbox-event → runtime-event mapping.\n *\n * The sandbox SDK emits a polymorphic `SandboxEvent = { type, data, id? }`\n * whose `type` vocabulary is backend-determined (opencode, etc.) rather than\n * enumerated by the SDK. Two consumers project it:\n *   - the loop kernel's cost ledger (`extractLlmCallEvent`) — sums usage off\n *     every cost-bearing event, regardless of stream shape;\n *   - the `AgentRuntime.act` streaming contract (`mapSandboxEvent`) — projects\n *     incremental events to the `RuntimeStreamEvent` chat-UX vocabulary.\n *\n * Both live here so the empirically-observed `type` vocabulary has one home.\n */\n\nimport type { StreamEvent } from '@tangle-network/agent-interface'\nimport type { SandboxEvent } from '@tangle-network/sandbox'\nimport type { RuntimeStreamEvent } from '../types'\nimport { parseCanonicalTransportEvent } from './sandbox-transport-events'\nimport type { ExecutorProgressEvent } from './supervise/types'\n\nconst CANONICAL_STREAM_EVENT_TYPES: ReadonlySet<string> = new Set([\n  'child-task',\n  'message.part.updated',\n  'tool-heartbeat',\n  'tool-slow',\n  'model-processing',\n  'status',\n  'warning',\n  'raw',\n  'session.updated',\n  'interaction',\n  'interaction.cancel',\n  'plan.submitted',\n])\n\n/** Decode one known Agent Interface event from a Sandbox event. */\nexport function canonicalStreamEventFromSandboxEvent(event: SandboxEvent): StreamEvent | undefined {\n  if (!event || typeof event !== 'object') return undefined\n  const type = String(event.type ?? '')\n  const data =\n    event.data && typeof event.data === 'object'\n      ? (event.data as Record<string, unknown>)\n      : ({} as Record<string, unknown>)\n  const normalized = data.normalized\n  if (normalized === undefined && !CANONICAL_STREAM_EVENT_TYPES.has(type)) return undefined\n  return parseCanonicalTransportEvent(type, data, normalized, 'sandbox')\n}\n\n/**\n * Forward a sandbox event to an optional observer without letting observer\n * behavior affect the run. The observer receives a defensive copy, synchronous\n * throws are swallowed, and returned promises are deliberately not awaited.\n */\nexport function notifySandboxEventObserver<Meta>(\n  event: SandboxEvent,\n  observer: ((event: SandboxEvent, meta: Meta) => void | PromiseLike<void>) | undefined,\n  meta: Meta,\n): void {\n  if (!observer) return\n  try {\n    const result = observer(cloneEventForObserver(event), meta)\n    if (result && typeof result.then === 'function') {\n      void result.then(undefined, () => {})\n    }\n  } catch {\n    // Live observation is optional and must never interrupt the event stream.\n  }\n}\n\nfunction cloneEventForObserver(event: SandboxEvent): SandboxEvent {\n  try {\n    return structuredClone(event)\n  } catch {\n    return copyPlainSpine(event, new WeakMap()) as SandboxEvent\n  }\n}\n\nfunction copyPlainSpine(value: unknown, seen: WeakMap<object, unknown>): unknown {\n  if (value === null || typeof value !== 'object') return value\n  const existing = seen.get(value)\n  if (existing !== undefined) return existing\n  if (Array.isArray(value)) {\n    const copy: unknown[] = []\n    seen.set(value, copy)\n    for (const item of value) copy.push(copyPlainSpine(item, seen))\n    return copy\n  }\n  const proto = Object.getPrototypeOf(value)\n  if (proto !== Object.prototype && proto !== null) return {}\n  const copy: Record<string, unknown> = {}\n  seen.set(value, copy)\n  for (const [key, child] of Object.entries(value)) {\n    copy[key] = copyPlainSpine(child, seen)\n  }\n  return copy\n}\n\n/** The provider/model the platform reports it actually bound to a turn, when it reports one.\n *  `source` is the platform's own account of where that choice came from — `environment` means\n *  the platform chose, not the request. */\nexport interface SandboxServedBackend {\n  readonly provider?: string\n  readonly model?: string\n  readonly source?: string\n}\n\n/**\n * Read the served execution identity off one Sandbox event.\n *\n * The platform reports `effectiveBackend` on `execution.started` and again on the terminal\n * event (`@tangle-network/sandbox`, `EffectiveBackend`). Absence returns `undefined`\n * and must stay unknown — a request is not a receipt, so nothing here may be inferred from\n * what was asked for.\n */\nexport function sandboxEventServedBackend(event: SandboxEvent): SandboxServedBackend | undefined {\n  if (!event || typeof event !== 'object') return undefined\n  const data = plainRecord(event.data)\n  const served = plainRecord(data?.effectiveBackend)\n  if (!served) return undefined\n  const provider = firstString(served.provider)\n  const model = firstString(served.model)\n  const source = firstString(served.source)\n  if (provider === undefined && model === undefined) return undefined\n  return {\n    ...(provider !== undefined ? { provider } : {}),\n    ...(model !== undefined ? { model } : {}),\n    ...(source !== undefined ? { source } : {}),\n  }\n}\n\n/**\n * Fail the execution when the platform reports serving a model other than the exact one asked for.\n *\n * Measured motive (agent-runtime#892, live infrastructure 2026-08-17): 6 of 6 boxes whose profile\n * declared `zai-coding-plan/glm-5.2` reported\n * `{\"provider\":\"openai-compat\",\"model\":\"deepseek/deepseek-v4-flash\",\"source\":\"environment\"}`,\n * while the materialization receipt recorded the declared model as `status: \"known\"`. Sending\n * `backend.model` makes that substitution unlikely; only reading the report back makes it\n * detectable. A run that cannot say which model produced its evidence must not settle as one\n * that can.\n *\n * Silent when the platform reports no served model: unobserved stays unobserved.\n */\nexport function assertSandboxServedModel(\n  event: SandboxEvent,\n  expected: { readonly provider?: string; readonly model?: string } | undefined,\n): void {\n  const wanted = expected?.model?.trim()\n  if (!wanted) return\n  const served = sandboxEventServedBackend(event)\n  if (served?.model === undefined) return\n  if (sameModelId(served.model, wanted, [served.provider, expected?.provider])) return\n  const attribution = [\n    served.provider !== undefined ? `provider ${JSON.stringify(served.provider)}` : undefined,\n    served.source !== undefined ? `source ${JSON.stringify(served.source)}` : undefined,\n  ].filter((part): part is string => part !== undefined)\n  const detail = attribution.length > 0 ? ` (${attribution.join(', ')})` : ''\n  throw new Error(\n    `sandbox served model ${JSON.stringify(served.model)}${detail} instead of the exact profile model ${JSON.stringify(wanted)}`,\n  )\n}\n\n/**\n * Do two model ids name the same model, allowing for routing prefixes?\n *\n * Either side may spell the model bare (`glm-5.2`), provider-qualified\n * (`zai-coding-plan/glm-5.2`), or route-qualified, and the platform reports the provider in its\n * own field rather than always in the id. So the comparison drops any known provider prefix and\n * then accepts a `/`-boundary suffix match: a longer route to the SAME leaf model is a routing\n * difference, not a substitution.\n *\n * What it deliberately does NOT absorb is a different leaf: `glm-5.2` against `glm-5.3` stays a\n * mismatch, which is the substitution measured directly against the provider API (a request for\n * `glm-5.2` was served `glm-5.3`). A version suffix is the whole difference between two\n * instruments, so nothing here may treat it as noise.\n */\nfunction sameModelId(\n  served: string,\n  wanted: string,\n  providers: readonly (string | undefined)[],\n): boolean {\n  const a = stripProviderPrefix(served, providers)\n  const b = stripProviderPrefix(wanted, providers)\n  return a === b || a.endsWith(`/${b}`) || b.endsWith(`/${a}`)\n}\n\nfunction stripProviderPrefix(id: string, providers: readonly (string | undefined)[]): string {\n  let out = id.trim().toLowerCase()\n  for (const provider of providers) {\n    const prefix = provider?.trim().toLowerCase()\n    if (prefix && out.startsWith(`${prefix}/`)) out = out.slice(prefix.length + 1)\n  }\n  return out\n}\n\nfunction firstString(...values: unknown[]): string | undefined {\n  return values.find((value): value is string => typeof value === 'string' && value.length > 0)\n}\n\n/**\n * The sandbox event types that END a turn.\n *\n * One list, because two consumers ask this question about the same wire event and must agree: the\n * usage credit below, and the terminal-text lift in `stream-agent-turn.ts`. Written separately they\n * drifted by exactly one member — `message.completed` credited tokens and dollars while its final\n * text was never lifted, so a backend whose terminal frame carries that type produced a run that\n * was billed and recorded no answer.\n */\nexport const sandboxTerminalEventTypes = ['message.completed', 'result', 'final', 'done'] as const\n\nexport type SandboxTerminalEventType = (typeof sandboxTerminalEventTypes)[number]\n\nconst terminalTypes: ReadonlySet<string> = new Set<string>(sandboxTerminalEventTypes)\n\n/** True for an event type that ends a sandbox turn. */\nexport function isSandboxTerminalEvent(type: string): type is SandboxTerminalEventType {\n  return terminalTypes.has(type)\n}\n\n/**\n * Which member of a terminal event's `data` carries its usage receipt.\n *\n * The one place the terminal types legitimately differ, stated rather than implied by two lists:\n * sandbox 0.4.0's `done` reports under `tokenUsage` with the cost at the top level, every other\n * terminal type reports under `usage`.\n */\nexport function sandboxTerminalUsageField(type: SandboxTerminalEventType): 'usage' | 'tokenUsage' {\n  return type === 'done' ? 'tokenUsage' : 'usage'\n}\n\n/**\n * Extract a `RuntimeStreamEvent`-shaped `llm_call` from a sandbox event when\n * the event carries usage/cost data. Returns `undefined` for non-cost events\n * so the kernel can iterate the full stream without branching.\n *\n * Pure by contract: it never throws on a failed run. The terminal truth\n * boundary is the public Sandbox outcome tracker, applied after the complete\n * stream. Post-hoc readers — {@link sumSandboxUsage}, the\n * analyst trace store, the chat projection — must stay able to read a failed\n * turn's events, which is when reading them matters most.\n *\n * Canonical cost-carrying types observed in the wild:\n *   - `llm_call` — `data: { model, tokensIn, tokensOut, costUsd, ... }`\n *   - `message.completed` / `result` — `data: { usage: { inputTokens,\n *      outputTokens, totalCostUsd? } }`\n *   - `cost.usage` / `usage` — same shape under a dedicated type\n *\n * Numeric coercion is strict: `Number.isFinite` gates every accumulator write\n * so a sentinel `NaN` from a misbehaving backend cannot poison the ledger.\n */\nexport function extractLlmCallEvent(\n  event: SandboxEvent,\n  agentRunName: string,\n): (RuntimeStreamEvent & { type: 'llm_call' }) | undefined {\n  if (!event || typeof event !== 'object') return undefined\n  const type = String(event.type ?? '')\n  const data =\n    event.data && typeof event.data === 'object'\n      ? (event.data as Record<string, unknown>)\n      : ({} as Record<string, unknown>)\n\n  if (type === 'llm_call' || type === 'cost.usage' || type === 'usage') {\n    return buildLlmCall(data, agentRunName)\n  }\n  if (isSandboxTerminalEvent(type) && sandboxTerminalUsageField(type) === 'usage') {\n    const usage = data.usage as Record<string, unknown> | undefined\n    if (!usage || typeof usage !== 'object') return undefined\n    return buildLlmCall({ ...usage, model: data.model ?? usage.model }, agentRunName)\n  }\n  // sandbox 0.4.0 terminal event: `data = { tokenUsage: { inputTokens, outputTokens,\n  // reasoningTokens, cacheReadInputTokens }, totalCostUsd }`. Usage lives under\n  // `tokenUsage` (not `usage`) and the cost is top-level — neither matched the\n  // branches above, so an in-process loopDispatch run reported {0,0} and the\n  // backend-integrity guard misread a real run as a stub. Reasoning tokens are\n  // billed output (reasoning models), so they fold into the output count. The prompt-cache\n  // counters are read off the SAME `tokenUsage` record rather than re-derived, because only\n  // that record states what the provider billed.\n  if (type === 'done') {\n    const usage = data.tokenUsage as Record<string, unknown> | undefined\n    if (!usage || typeof usage !== 'object') return undefined\n    const out = pickFiniteNumber(usage, ['outputTokens', 'completion_tokens', 'tokensOut'])\n    const reasoning = pickFiniteNumber(usage, ['reasoningTokens'])\n    const mergedOut =\n      out !== undefined || reasoning !== undefined ? (out ?? 0) + (reasoning ?? 0) : undefined\n    const cache = readPromptCacheUsage(usage)\n    return buildLlmCall(\n      {\n        inputTokens: usage.inputTokens,\n        outputTokens: mergedOut,\n        totalCostUsd: data.totalCostUsd,\n        model: data.model ?? usage.model,\n        ...(cache !== undefined ? { promptCache: cache } : {}),\n      },\n      agentRunName,\n    )\n  }\n  return undefined\n}\n\n/**\n * Sum the token usage + USD cost of a sandbox turn's events — the one honest way to meter an\n * `openSandboxRun` cell. Folds `extractLlmCallEvent` over the stream (which reads usage off EVERY backend\n * event shape), so a `runProfileMatrix` dispatch can report it to `ctx.cost`:\n *\n *     receipt: (turn) => {\n *       const u = sumSandboxUsage(turn.events)\n *       return { model, inputTokens: u.input, outputTokens: u.output,\n *         ...(u.tokensKnown === false ? { usageUnknown: true } : {}),\n *         ...(u.usdKnown !== false && u.costUsd > 0 ? { actualCostUsd: u.costUsd } : {}),\n *         ...(u.usdKnown === false ? { costUnknown: true } : {}),\n *         ...(u.estimatedCostUsd !== undefined ? { estimatedCostUsd: u.estimatedCostUsd } : {}) }\n *     }\n *\n * Without this a cell reads `{tokens:0, cost:0}` and the backend-integrity guard correctly aborts the\n * matrix as a stub. `agentRunName` is the fallback model label for cost-only events (default `'agent'`).\n */\nexport function sumSandboxUsage(\n  events: readonly SandboxEvent[],\n  agentRunName = 'agent',\n): {\n  input: number\n  output: number\n  costUsd: number\n  tokensKnown?: false\n  usdKnown?: false\n  estimatedCostUsd?: number\n} {\n  let input = 0\n  let output = 0\n  let costUsd = 0\n  let estimatedCostUsd = 0\n  let sawEstimate = false\n  let sawCall = false\n  let tokensKnown = true\n  let usdKnown = true\n  for (const ev of events) {\n    const call = extractLlmCallEvent(ev, agentRunName)\n    if (!call) continue\n    sawCall = true\n    input += call.tokensIn ?? 0\n    output += call.tokensOut ?? 0\n    costUsd += call.costUsd ?? 0\n    if (call.tokensKnown === false) tokensKnown = false\n    if (call.usdKnown === false) usdKnown = false\n    if (call.estimatedCostUsd !== undefined) {\n      estimatedCostUsd += call.estimatedCostUsd\n      sawEstimate = true\n    }\n  }\n  return {\n    input,\n    output,\n    costUsd,\n    ...(sawCall && tokensKnown ? {} : { tokensKnown: false as const }),\n    ...(sawCall && usdKnown ? {} : { usdKnown: false as const }),\n    ...(sawEstimate ? { estimatedCostUsd } : {}),\n  }\n}\n\nfunction buildLlmCall(\n  data: Record<string, unknown>,\n  agentRunName: string,\n): (RuntimeStreamEvent & { type: 'llm_call' }) | undefined {\n  const tokensIn = pickFiniteNumber(data, ['tokensIn', 'inputTokens', 'prompt_tokens'])\n  const outputTokens = pickFiniteNumber(data, ['tokensOut', 'outputTokens', 'completion_tokens'])\n  const reasoningTokens = pickFiniteNumber(data, ['reasoningTokens'])\n  const tokensOut =\n    outputTokens !== undefined || reasoningTokens !== undefined\n      ? (outputTokens ?? 0) + (reasoningTokens ?? 0)\n      : undefined\n  const reportedCostUsd = pickFiniteNumber(data, ['costUsd', 'totalCostUsd', 'cost_usd', 'cost'])\n  const explicitTokensKnown = data.tokensKnown ?? data.tokens_known\n  const explicitCostKnown = data.costKnown ?? data.cost_known ?? data.usdKnown ?? data.usd_known\n  const costProvenance = data.costProvenance ?? data.cost_provenance\n  const explicitEstimate = pickFiniteNumber(data, ['estimatedCostUsd', 'estimated_cost_usd'])\n  const catalogEstimate =\n    costProvenance === 'catalog-estimate' ? (explicitEstimate ?? reportedCostUsd) : explicitEstimate\n  const costUsd = costProvenance === 'catalog-estimate' ? undefined : reportedCostUsd\n  const promptCache = readPromptCacheUsage(data)\n  const tokensKnown =\n    explicitTokensKnown !== false && tokensIn !== undefined && tokensOut !== undefined\n  // Sandbox's canonical terminal `totalCostUsd` is already the provider-reported receipt. The\n  // current SDK carries no provenance tag, so absence means the canonical receipt rather than\n  // \"unknown\". Explicit estimates and explicit false-known markers remain unknown.\n  const usdKnown =\n    explicitCostKnown !== false &&\n    costUsd !== undefined &&\n    (costProvenance === undefined ||\n      costProvenance === 'provider-receipt' ||\n      costProvenance === 'billing-receipt')\n  if (\n    tokensIn === undefined &&\n    tokensOut === undefined &&\n    costUsd === undefined &&\n    catalogEstimate === undefined &&\n    promptCache === undefined &&\n    explicitTokensKnown !== false &&\n    explicitCostKnown !== false\n  ) {\n    return undefined\n  }\n  const model = typeof data.model === 'string' && data.model.length > 0 ? data.model : agentRunName\n  const event: RuntimeStreamEvent & { type: 'llm_call' } = {\n    type: 'llm_call',\n    model,\n  }\n  if (tokensIn !== undefined) event.tokensIn = tokensIn\n  if (tokensOut !== undefined) event.tokensOut = tokensOut\n  if (!tokensKnown) event.tokensKnown = false\n  if (costUsd !== undefined) event.costUsd = costUsd\n  if (!usdKnown) event.usdKnown = false\n  if (catalogEstimate !== undefined) event.estimatedCostUsd = catalogEstimate\n  if (promptCache !== undefined) event.promptCache = promptCache\n  return event\n}\n\n/**\n * Every wire spelling of a prompt-cache READ counter, in precedence order: the canonical name\n * first, then the spellings observed on the paths that reach this extractor — the sandbox terminal\n * `tokenUsage` record, the cli-bridge OpenAI-compatible usage object (which normalizes every\n * backend to Anthropic's `cache_read_input_tokens`), Anthropic verbatim, OpenAI's\n * `prompt_tokens_details.cached_tokens`, and DeepSeek's `prompt_cache_hit_tokens`.\n */\nconst PROMPT_CACHE_READ_KEYS = [\n  'readTokens',\n  'read_tokens',\n  'cacheReadInputTokens',\n  'cache_read_input_tokens',\n  'cacheRead',\n  'cache_read',\n  'cachedInputTokens',\n  'cachedTokens',\n  'cached_tokens',\n  'prompt_cache_hit_tokens',\n]\n\n/**\n * Every wire spelling of a prompt-cache WRITE counter. OpenAI reports no write counter at all, so\n * an OpenAI-shaped usage record matches nothing here and the write stays absent — which is the\n * point: absent is not zero.\n */\nconst PROMPT_CACHE_WRITE_KEYS = [\n  'writeTokens',\n  'write_tokens',\n  'cacheWriteInputTokens',\n  'cache_write_input_tokens',\n  'cacheCreationInputTokens',\n  'cache_creation_input_tokens',\n  'cacheWrite',\n  'cache_write',\n]\n\nconst PROMPT_CACHE_MISS_KEYS = ['missTokens', 'miss_tokens', 'prompt_cache_miss_tokens']\n\nconst PROMPT_CACHE_SAVINGS_KEYS = ['readSavingsUsd', 'read_savings_usd']\n\n/**\n * Read the provider's own prompt-cache accounting off one usage-bearing event payload, in the\n * `PromptCacheUsage` vocabulary the router, driver, and chat-client paths already speak.\n *\n * Two sources, one record. A payload that already carries a `promptCache` / `prompt_cache` object\n * is forwarded VERBATIM — those fields are the provider's own report, and an unrecognized one must\n * stay visible rather than be bucketed away. On top of that, flat provider counters are translated\n * to the canonical names, filling only the names the verbatim object did not already define.\n *\n * A counter the payload does not carry is left out. Defaulting it to zero would assert the provider\n * measured no cache, which is a different fact from a provider that reported nothing — and it is\n * the fact the budget reads to decide whether its charge is a measurement or a bound.\n */\nfunction readPromptCacheUsage(\n  data: Record<string, unknown>,\n): Record<string, number | string> | undefined {\n  const declared = finiteMetadata(data.promptCache ?? data.prompt_cache)\n  const nested = plainRecord(data.promptCache) ?? plainRecord(data.prompt_cache)\n  const details = plainRecord(data.prompt_tokens_details)\n  const sources = [nested, data, details].filter(\n    (s): s is Record<string, unknown> => s !== undefined,\n  )\n\n  const canonical: Record<string, number | string> = {}\n  const readTokens = pickTokenCount(sources, PROMPT_CACHE_READ_KEYS)\n  const writeTokens = pickTokenCount(sources, PROMPT_CACHE_WRITE_KEYS)\n  const missTokens = pickTokenCount(sources, PROMPT_CACHE_MISS_KEYS)\n  const readSavingsUsd = pickNonNegativeNumber(sources, PROMPT_CACHE_SAVINGS_KEYS)\n  const status =\n    nested !== undefined && typeof nested.status === 'string' ? nested.status : undefined\n  if (readTokens !== undefined) canonical.readTokens = readTokens\n  if (writeTokens !== undefined) canonical.writeTokens = writeTokens\n  if (missTokens !== undefined) canonical.missTokens = missTokens\n  if (readSavingsUsd !== undefined) canonical.readSavingsUsd = readSavingsUsd\n  if (status !== undefined) canonical.status = status\n\n  const merged = { ...canonical, ...declared }\n  return Object.keys(merged).length > 0 ? merged : undefined\n}\n\nfunction plainRecord(value: unknown): Record<string, unknown> | undefined {\n  return value && typeof value === 'object' && !Array.isArray(value)\n    ? (value as Record<string, unknown>)\n    : undefined\n}\n\nfunction pickTokenCount(\n  sources: readonly Record<string, unknown>[],\n  keys: readonly string[],\n): number | undefined {\n  for (const key of keys) {\n    for (const source of sources) {\n      const value = source[key]\n      if (typeof value === 'number' && Number.isSafeInteger(value) && value >= 0) return value\n    }\n  }\n  return undefined\n}\n\nfunction pickNonNegativeNumber(\n  sources: readonly Record<string, unknown>[],\n  keys: readonly string[],\n): number | undefined {\n  for (const key of keys) {\n    for (const source of sources) {\n      const value = source[key]\n      if (typeof value === 'number' && Number.isFinite(value) && value >= 0) return value\n    }\n  }\n  return undefined\n}\n\nfunction finiteMetadata(value: unknown): Record<string, number | string> | undefined {\n  if (!value || typeof value !== 'object' || Array.isArray(value)) return undefined\n  const result: Record<string, number | string> = {}\n  for (const [key, entry] of Object.entries(value)) {\n    if ((typeof entry === 'number' && Number.isFinite(entry)) || typeof entry === 'string') {\n      result[key] = entry\n    }\n  }\n  return Object.keys(result).length > 0 ? result : undefined\n}\n\nfunction pickFiniteNumber(data: Record<string, unknown>, keys: string[]): number | undefined {\n  for (const key of keys) {\n    const value = data[key]\n    if (typeof value === 'number' && Number.isFinite(value)) return value\n  }\n  return undefined\n}\n\n/**\n * Cross-event state for {@link mapSandboxToolEvent}. Sandbox backends emit a\n * tool invocation as MANY `message.part.updated` frames on the same call id\n * (pending → running → completed), so faithful projection needs per-call\n * status memory: one `tool_call` on first sighting, at most one `tool_result`\n * on the terminal transition, nothing on intermediate re-frames. Create one\n * state per turn via {@link createSandboxToolPartState}.\n *\n * @experimental\n */\nexport interface SandboxToolPartState {\n  /** Last seen status per tool call id. A terminal status is sticky — later\n   *  frames on a settled call project to nothing. */\n  statusByCall: Map<string, string>\n  /** Sequence for synthesized call ids when an event carries none. */\n  seq: number\n}\n\n/**\n * Fresh per-turn {@link SandboxToolPartState} for {@link mapSandboxToolEvent} — an\n * empty call-status map so each turn projects tool frames independently.\n *\n * @experimental\n */\nexport function createSandboxToolPartState(): SandboxToolPartState {\n  return { statusByCall: new Map(), seq: 0 }\n}\n\n/** Statuses that settle one tool call as a failure. A failed tool call stays a tool result:\n *  the run's terminal state comes from the public Sandbox outcome tracker, never from here. */\nconst TERMINAL_FAILURE = /^(error|errored|failed|failure|cancelled|canceled|timeout|timed_out)$/i\n\n/**\n * Project one `SandboxEvent` onto the `tool_call` / `tool_result` variants of\n * `RuntimeStreamEvent` — the tool-part projection `mapSandboxEvent`\n * deliberately does NOT perform. Opt-in and additive: `mapSandboxEvent`'s\n * default vocabulary (text/reasoning deltas + `llm_call`) is unchanged;\n * consumers that need the tool surface (chat UIs rendering tool activity)\n * compose this projector alongside it — `streamAgentTurn` does exactly that\n * under its `preserveToolParts` option.\n *\n * Handled shapes (observed on the opencode / claude-code sandbox backends):\n *   - `message.part.updated` with `part.type === 'tool'` — stateful: a\n *     `tool_call` on the call id's first frame (args from `state.input` or\n *     `state.metadata.input`), a `tool_result` when the status transitions to\n *     `completed` (result from `state.output` / `metadata.output`) or to a\n *     terminal failure (result is `{ error, status, output? }` — the error\n *     surfaced in-band, never dropped).\n *   - bare `tool*` event types (`tool.call`, `tool_result`, …) — stateless:\n *     `*result*` types project to `tool_result`, the rest to `tool_call`.\n *\n * Returns `[]` for every non-tool event.\n *\n * @experimental\n */\nexport function mapSandboxToolEvent(\n  event: SandboxEvent,\n  state: SandboxToolPartState,\n): (RuntimeStreamEvent & { type: 'tool_call' | 'tool_result' })[] {\n  if (!event || typeof event !== 'object') return []\n  const type = String(event.type ?? '')\n  const data =\n    event.data && typeof event.data === 'object'\n      ? (event.data as Record<string, unknown>)\n      : ({} as Record<string, unknown>)\n\n  if (type === 'message.part.updated') {\n    const part =\n      data.part && typeof data.part === 'object' ? (data.part as Record<string, unknown>) : {}\n    if (String(part.type ?? '') !== 'tool') return []\n    return projectToolPart(part, state, typeof event.id === 'string' ? event.id : undefined)\n  }\n\n  if (type.includes('tool')) {\n    const callId =\n      pickString(data, ['toolCallId', 'tool_use_id', 'id']) ??\n      (typeof event.id === 'string' ? event.id : undefined) ??\n      `sandbox-tool-${++state.seq}`\n    const toolName = pickString(data, ['name', 'toolName', 'tool']) ?? 'sandbox_tool'\n    if (type.includes('result')) {\n      return [\n        {\n          type: 'tool_result',\n          toolName,\n          toolCallId: callId,\n          result: data.output ?? data.result ?? data.content ?? data,\n        },\n      ]\n    }\n    return [\n      { type: 'tool_call', toolName, toolCallId: callId, args: data.input ?? data.args ?? {} },\n    ]\n  }\n\n  return []\n}\n\nfunction projectToolPart(\n  part: Record<string, unknown>,\n  state: SandboxToolPartState,\n  eventId: string | undefined,\n): (RuntimeStreamEvent & { type: 'tool_call' | 'tool_result' })[] {\n  const callId =\n    pickString(part, ['callID', 'callId', 'toolCallId', 'id']) ??\n    eventId ??\n    `sandbox-tool-${++state.seq}`\n  const toolName = pickString(part, ['tool', 'toolName', 'name']) ?? 'sandbox_tool'\n  const toolState =\n    part.state && typeof part.state === 'object' ? (part.state as Record<string, unknown>) : {}\n  const metadata =\n    toolState.metadata && typeof toolState.metadata === 'object'\n      ? (toolState.metadata as Record<string, unknown>)\n      : {}\n  const status = pickString(toolState, ['status']) ?? 'updated'\n\n  const previous = state.statusByCall.get(callId)\n  const settled =\n    previous === 'completed' || (previous !== undefined && TERMINAL_FAILURE.test(previous))\n  if (settled) return []\n\n  const out: (RuntimeStreamEvent & { type: 'tool_call' | 'tool_result' })[] = []\n  if (previous === undefined) {\n    out.push({\n      type: 'tool_call',\n      toolName,\n      toolCallId: callId,\n      args: toolState.input ?? metadata.input ?? {},\n    })\n  }\n  state.statusByCall.set(callId, status)\n\n  if (status === 'completed') {\n    out.push({\n      type: 'tool_result',\n      toolName,\n      toolCallId: callId,\n      result: toolState.output ?? metadata.output ?? '',\n    })\n  } else if (TERMINAL_FAILURE.test(status)) {\n    const message =\n      pickString(toolState, ['error', 'message']) ??\n      pickString(metadata, ['error', 'message']) ??\n      `sandbox tool ended with status ${status}`\n    const output = toolState.output ?? metadata.output\n    out.push({\n      type: 'tool_result',\n      toolName,\n      toolCallId: callId,\n      result: { error: message, status, ...(output !== undefined ? { output } : {}) },\n    })\n  }\n  return out\n}\n\nfunction pickString(data: Record<string, unknown>, keys: string[]): string | undefined {\n  for (const key of keys) {\n    const value = data[key]\n    if (typeof value === 'string' && value.length > 0) return value\n  }\n  return undefined\n}\n\n/**\n * Project one `SandboxEvent` onto the `RuntimeStreamEvent` chat-UX vocabulary,\n * for runtimes that bridge a sandbox `streamPrompt` into the\n * `AgentRuntime.act` streaming contract. Returns `undefined` for events that\n * have no faithful projection — the raw stream is preserved separately for the\n * `OutputAdapter`, so an unmapped event never loses data.\n *\n * Mapped (the task-optional incremental variants — no synthesized task\n * lifecycle, no guessed tool-part shapes):\n *   - `message.part.updated` text part → `text_delta`\n *   - `message.part.updated` reasoning/thinking part → `reasoning_delta`\n *   - cost-bearing events → `llm_call` (shared with the ledger extractor)\n *\n * Tool parts are deliberately NOT mapped here (unchanged default) — compose\n * {@link mapSandboxToolEvent} alongside when a consumer needs them.\n *\n * The opencode backend emits incremental text as\n * `{ type: 'message.part.updated', data: { part: { type, text }, delta } }`;\n * `delta` is the increment, `part.text` the running accumulation.\n */\nexport function mapSandboxEvent(\n  event: SandboxEvent,\n  opts: { agentRunName?: string } = {},\n): RuntimeStreamEvent | undefined {\n  if (!event || typeof event !== 'object') return undefined\n  const type = String(event.type ?? '')\n  const data =\n    event.data && typeof event.data === 'object'\n      ? (event.data as Record<string, unknown>)\n      : ({} as Record<string, unknown>)\n\n  if (type === 'message.part.updated') {\n    const part =\n      data.part && typeof data.part === 'object' ? (data.part as Record<string, unknown>) : {}\n    const partType = String(part.type ?? '')\n    const delta = typeof data.delta === 'string' ? data.delta : undefined\n    const text = delta ?? (typeof part.text === 'string' ? part.text : undefined)\n    if (text === undefined) return undefined\n    if (partType === 'text') return { type: 'text_delta', text }\n    if (partType === 'reasoning' || partType === 'thinking')\n      return { type: 'reasoning_delta', text }\n    return undefined\n  }\n\n  return extractLlmCallEvent(event, opts.agentRunName ?? 'agent')\n}\n\n/**\n * Project one `SandboxEvent` onto Runtime's executor progress vocabulary: incremental text and\n * reasoning, tool calls and results, and an interaction request. It composes the existing\n * projections ({@link mapSandboxEvent}, {@link mapSandboxToolEvent}, and the canonical Agent\n * Interface decode) so every sandbox-shaped executor publishes live output through one reader.\n * Usage-bearing events project to nothing here — accounting stays on the `tokens`/`cost`\n * channels.\n *\n * Pass one {@link SandboxToolPartState} per turn so a multi-frame tool call yields one call and\n * at most one result.\n *\n * @experimental\n */\nexport function sandboxProgressEvents(\n  event: SandboxEvent,\n  state: SandboxToolPartState,\n): ExecutorProgressEvent[] {\n  const canonical = canonicalStreamEventFromSandboxEvent(event)\n  if (canonical?.type === 'interaction') {\n    return [{ kind: 'interaction', request: canonical.request }]\n  }\n  if (canonical?.type === 'child-task') {\n    return [{ kind: 'child_task', event: canonical }]\n  }\n  const tools = mapSandboxToolEvent(event, state).map((projected) =>\n    projected.type === 'tool_call'\n      ? ({\n          kind: 'tool_call',\n          toolName: projected.toolName,\n          ...(projected.toolCallId === undefined ? {} : { toolCallId: projected.toolCallId }),\n          ...(projected.args === undefined ? {} : { args: projected.args }),\n        } as const)\n      : ({\n          kind: 'tool_result',\n          toolName: projected.toolName,\n          ...(projected.toolCallId === undefined ? {} : { toolCallId: projected.toolCallId }),\n          ...(projected.result === undefined ? {} : { result: projected.result }),\n        } as const),\n  )\n  if (tools.length > 0) return tools\n  const mapped = mapSandboxEvent(event)\n  if (mapped?.type === 'text_delta') return [{ kind: 'text_delta', text: mapped.text }]\n  if (mapped?.type === 'reasoning_delta') return [{ kind: 'reasoning_delta', text: mapped.text }]\n  return []\n}\n\nexport {\n  extractTransportEventIdentity,\n  parseCanonicalTransportEvent,\n  type TransportEventIdentity,\n} from './sandbox-transport-events'\n"],"mappings":"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"}

package/dist/stream-agent-turn-D-GzjvCl.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"stream-agent-turn-D-GzjvCl.js","names":["taskInput"],"sources":["../src/sessions.ts","../src/backends.ts","../src/runtime/stream-agent-turn.ts"],"sourcesContent":["/**\n *\n * Session helpers + an in-memory `RuntimeSessionStore` implementation suitable\n * for tests, scratch processes, and per-request scratch storage in serverless\n * runtimes. Durable stores (D1, postgres, Durable Objects) implement the same\n * interface from `./types`.\n *\n * @stable\n */\n\nimport { SessionMismatchError } from './errors'\nimport type {\n  AgentBackendContext,\n  AgentBackendInput,\n  AgentExecutionBackend,\n  RuntimeSession,\n  RuntimeSessionStore,\n  RuntimeStreamEvent,\n} from './types'\n\n/** @internal */\nexport function newRuntimeSession(\n  backend: string,\n  requestedId?: string,\n  metadata?: Record<string, unknown>,\n): RuntimeSession {\n  const now = nowIso()\n  return {\n    id: requestedId || crypto.randomUUID(),\n    backend,\n    status: 'active',\n    createdAt: now,\n    updatedAt: now,\n    metadata,\n  }\n}\n\n/** @internal */\nexport function touchSession(session: RuntimeSession): RuntimeSession {\n  return { ...session, updatedAt: nowIso() }\n}\n\n/** @internal */\nexport function nowIso(): string {\n  return new Date().toISOString()\n}\n\ninterface StartOrResumeRuntimeSessionOptions<TInput extends AgentBackendInput> {\n  backend: AgentExecutionBackend<TInput>\n  input: TInput | (() => TInput)\n  /** Smaller input used only when the backend can continue its native session. */\n  continuationInput?: TInput | (() => TInput)\n  context: Omit<AgentBackendContext, 'session'>\n  store?: RuntimeSessionStore\n  sessionId?: string\n  resume?: boolean\n  validateSession?: (session: RuntimeSession) => void\n}\n\ninterface RuntimeSessionCall<TInput extends AgentBackendInput> {\n  session: RuntimeSession\n  input: TInput\n  resumed: boolean\n}\n\n/** Start or resume one backend session and persist its current identity. @internal */\nexport async function startOrResumeRuntimeSession<TInput extends AgentBackendInput>(\n  options: StartOrResumeRuntimeSessionOptions<TInput>,\n): Promise<RuntimeSessionCall<TInput>> {\n  const existing =\n    options.resume && options.sessionId ? await options.store?.get(options.sessionId) : undefined\n  if (!existing) {\n    const input = resolveSessionInput(options.input)\n    const session = options.backend.start\n      ? await options.backend.start(input, {\n          ...options.context,\n          requestedSessionId: options.sessionId,\n        })\n      : newRuntimeSession(options.backend.kind, options.sessionId)\n    assertSessionBackend(session, options.backend.kind)\n    options.validateSession?.(session)\n    await options.store?.put(session)\n    return { session, input, resumed: false }\n  }\n\n  assertSessionBackend(existing, options.backend.kind)\n  const continued = options.backend.resume !== undefined\n  const input = resolveSessionInput(\n    continued ? (options.continuationInput ?? options.input) : options.input,\n  )\n  const session = options.backend.resume\n    ? await options.backend.resume(existing, input, options.context)\n    : touchSession({ ...existing, status: 'active' })\n  assertSessionBackend(session, options.backend.kind)\n  options.validateSession?.(session)\n  await options.store?.put(session)\n  return { session, input, resumed: true }\n}\n\nfunction resolveSessionInput<TInput extends AgentBackendInput>(\n  input: TInput | (() => TInput),\n): TInput {\n  return typeof input === 'function' ? input() : input\n}\n\nfunction assertSessionBackend(session: RuntimeSession, backend: string): void {\n  if (session.backend !== backend) throw new SessionMismatchError(session.backend, backend)\n}\n\n/** In-memory `RuntimeSessionStore` for single-process use and tests. @stable */\nexport class InMemoryRuntimeSessionStore implements RuntimeSessionStore {\n  private readonly sessions = new Map<string, RuntimeSession>()\n  private readonly events = new Map<string, RuntimeStreamEvent[]>()\n\n  get(sessionId: string): RuntimeSession | undefined {\n    return this.sessions.get(sessionId)\n  }\n\n  put(session: RuntimeSession): void {\n    this.sessions.set(session.id, session)\n  }\n\n  appendEvent(sessionId: string, event: RuntimeStreamEvent): void {\n    const existing = this.events.get(sessionId) ?? []\n    existing.push(event)\n    this.events.set(sessionId, existing)\n  }\n\n  listEvents(sessionId: string): RuntimeStreamEvent[] {\n    return [...(this.events.get(sessionId) ?? [])]\n  }\n}\n","/**\n * Provider-neutral backend adapters for `runAgentTaskStream`.\n *\n * Model inference is deliberately absent. Paid model work enters the Runtime executor with an\n * exact `AgentProfile`; these adapters only normalize a caller-owned iterable or sandbox stream.\n *\n * @stable\n */\n\nimport { providerMessageText } from './runtime/turn-input'\nimport { newRuntimeSession, nowIso, touchSession } from './sessions'\nimport type {\n  AgentBackendContext,\n  AgentBackendInput,\n  AgentExecutionBackend,\n  RuntimeSession,\n  RuntimeStreamEvent,\n} from './types'\n\n/** Wrap any custom async-iterable stream into a typed `AgentExecutionBackend`. @stable */\nexport function createIterableBackend<TInput extends AgentBackendInput>(options: {\n  kind: string\n  start?: AgentExecutionBackend<TInput>['start']\n  resume?: AgentExecutionBackend<TInput>['resume']\n  stream: AgentExecutionBackend<TInput>['stream']\n  stop?: AgentExecutionBackend<TInput>['stop']\n}): AgentExecutionBackend<TInput> {\n  return options\n}\n\n/** Build an `AgentExecutionBackend` backed by a sandbox/sidecar `streamPrompt` call. @stable */\nexport function createSandboxPromptBackend<\n  TBox,\n  TInput extends AgentBackendInput = AgentBackendInput,\n>(options: {\n  kind?: string\n  getBox(input: TInput, context: Omit<AgentBackendContext, 'session'>): Promise<TBox> | TBox\n  streamPrompt(box: TBox, message: string, context: AgentBackendContext): AsyncIterable<unknown>\n  mapEvent?: (event: unknown, context: AgentBackendContext) => RuntimeStreamEvent | undefined\n  getSessionId?: (box: TBox, input: TInput) => string | undefined\n}): AgentExecutionBackend<TInput> {\n  const kind = options.kind ?? 'sandbox'\n  return {\n    kind,\n    async start(input, context) {\n      const box = await options.getBox(input, context)\n      return newRuntimeSession(\n        kind,\n        options.getSessionId?.(box, input) ?? context.requestedSessionId,\n        { resumable: true },\n      )\n    },\n    resume(session) {\n      return touchSession({ ...session, status: 'active' })\n    },\n    async *stream(input, context) {\n      const box = await options.getBox(input, context)\n      const message =\n        input.message ??\n        input.messages?.at(-1)?.content ??\n        providerMessageText(input.providerOptions) ??\n        context.task.intent\n      for await (const event of options.streamPrompt(box, message, context)) {\n        const mapped = options.mapEvent?.(event, context) ?? mapCommonBackendEvent(event, context)\n        if (mapped) yield mapped\n      }\n    },\n  }\n}\n\n/** @internal */\nexport function normalizeBackendStreamEvent(\n  event: RuntimeStreamEvent,\n  task: AgentBackendContext['task'],\n  session: RuntimeSession,\n): RuntimeStreamEvent {\n  if (\n    'task' in event &&\n    event.task &&\n    'session' in event &&\n    event.session &&\n    'timestamp' in event &&\n    event.timestamp\n  ) {\n    return event\n  }\n  return {\n    ...event,\n    task: 'task' in event && event.task ? event.task : task,\n    session: 'session' in event && event.session ? event.session : session,\n    timestamp: 'timestamp' in event && event.timestamp ? event.timestamp : nowIso(),\n  } as RuntimeStreamEvent\n}\n\nfunction mapCommonBackendEvent(\n  event: unknown,\n  context: AgentBackendContext,\n): RuntimeStreamEvent | undefined {\n  if (!event || typeof event !== 'object') return undefined\n  const record = event as Record<string, unknown>\n  const type = String(record.type ?? '')\n  const data =\n    record.data && typeof record.data === 'object'\n      ? (record.data as Record<string, unknown>)\n      : record\n  if (type === 'message.part.updated' || type === 'text_delta' || type === 'delta') {\n    const part = data.part as Record<string, unknown> | undefined\n    const partText =\n      part !== undefined &&\n      typeof part === 'object' &&\n      (part.type === 'text' || part.type === undefined)\n        ? stringValue(part.text)\n        : undefined\n    const text =\n      stringValue(data.text) ?? stringValue(data.delta) ?? stringValue(record.text) ?? partText\n    return text\n      ? {\n          type: 'text_delta',\n          task: context.task,\n          session: context.session,\n          text,\n          timestamp: nowIso(),\n        }\n      : undefined\n  }\n  if (type === 'reasoning_delta') {\n    const text = stringValue(data.text) ?? stringValue(record.text)\n    return text\n      ? {\n          type: 'reasoning_delta',\n          task: context.task,\n          session: context.session,\n          text,\n          timestamp: nowIso(),\n        }\n      : undefined\n  }\n  if (type === 'tool_call') {\n    return {\n      type: 'tool_call',\n      task: context.task,\n      session: context.session,\n      toolName: stringValue(data.name) ?? stringValue(record.toolName) ?? 'tool',\n      toolCallId: stringValue(data.id) ?? stringValue(record.toolCallId),\n      args: data.args ?? data.input ?? record.args,\n      timestamp: nowIso(),\n    }\n  }\n  if (type === 'tool_result') {\n    return {\n      type: 'tool_result',\n      task: context.task,\n      session: context.session,\n      toolName: stringValue(data.name) ?? stringValue(record.toolName) ?? 'tool',\n      toolCallId: stringValue(data.id) ?? stringValue(record.toolCallId),\n      result: data.result ?? data.output ?? record.result,\n      timestamp: nowIso(),\n    }\n  }\n  if (type === 'artifact') {\n    const artifactId =\n      stringValue(data.artifactId) ?? stringValue(data.id) ?? stringValue(record.artifactId)\n    if (!artifactId) return undefined\n    return {\n      type: 'artifact',\n      task: context.task,\n      session: context.session,\n      artifactId,\n      name: stringValue(data.name) ?? stringValue(record.name),\n      mimeType: stringValue(data.mimeType) ?? stringValue(record.mimeType),\n      uri: stringValue(data.uri) ?? stringValue(record.uri),\n      content: stringValue(data.content) ?? stringValue(data.body) ?? stringValue(record.content),\n      metadata:\n        data.metadata && typeof data.metadata === 'object'\n          ? (data.metadata as Record<string, unknown>)\n          : undefined,\n      timestamp: nowIso(),\n    }\n  }\n  if (type === 'proposal_created' || type === 'proposal' || type === 'filing') {\n    const proposalId =\n      stringValue(data.proposalId) ?? stringValue(data.id) ?? stringValue(record.proposalId)\n    if (!proposalId) return undefined\n    const status = stringValue(data.status) ?? stringValue(record.status)\n    return {\n      type: 'proposal_created',\n      task: context.task,\n      session: context.session,\n      proposalId,\n      title: stringValue(data.title) ?? stringValue(record.title) ?? proposalId,\n      status:\n        status === 'pending' || status === 'approved' || status === 'rejected' ? status : undefined,\n      content: stringValue(data.content) ?? stringValue(data.body) ?? stringValue(record.content),\n      timestamp: nowIso(),\n    }\n  }\n  if (type === 'result' || type === 'final') {\n    const text = stringValue(data.finalText) ?? stringValue(data.text) ?? stringValue(record.text)\n    return text\n      ? {\n          type: 'text_delta',\n          task: context.task,\n          session: context.session,\n          text,\n          timestamp: nowIso(),\n        }\n      : undefined\n  }\n  return undefined\n}\n\nfunction stringValue(value: unknown): string | undefined {\n  return typeof value === 'string' && value.length > 0 ? value : undefined\n}\n","/**\n * `streamAgentTurn` — the ONE run-a-turn event-stream contract over every\n * execution substrate: a sandbox box (`SandboxInstance.streamPrompt`), a\n * one-shot Runtime-owned `Executor` (cli-bridge / router / sandbox, via\n * `ExecutorFactory`), and an in-process `AgentExecutionBackend`.\n *\n * One function, one vocabulary: every backend kind yields the existing\n * `RuntimeStreamEvent` union incrementally and ALWAYS terminates with a\n * `final` event whose `text` is the turn's final text and whose\n * `metadata.tokenUsage` / `metadata.costUsd` / `metadata.model` carry the\n * turn's metered usage. `collectAgentTurn` drains a stream into that terminal\n * summary plus the full event list.\n *\n * This is a UNIFICATION seam, not a new stream parser — each kind is a thin\n * adapter over code that already exists and is already hardened:\n *   - `box`      — `mapSandboxEvent` + `extractLlmCallEvent` (sandbox-events.ts)\n *                  project the sandbox event stream; its requested profile is\n *                  explicitly recorded as unverified because the box already exists.\n *   - `executor` — Runtime materializes the exact `AgentProfile`, records its\n *                  identity receipts, drives the executor once, and tears it\n *                  down after capturing the terminal artifact.\n *   - `chat`     — the backend's own `stream()` surface, normalized by\n *                  `normalizeBackendStreamEvent`; its requested profile is likewise\n *                  unverified because an arbitrary backend cannot attest its setup.\n *\n * Distinct from `openSandboxRun` (box-only, session resume over one persistent\n * artifact, raw `SandboxEvent` deliverables) and from `runAgentTaskStream`\n * (full task lifecycle: knowledge preflight, session store, resume). This is\n * the minimal turn primitive underneath both worlds: prompt in, one normalized\n * event stream out, terminal result+usage guaranteed on every non-thrown path.\n *\n * Stream envelope: `backend_start` → incremental events → (`backend_error` on\n * failure) → `final`. A caller-initiated abort terminates with\n * `final.status: 'aborted'`; an expired `timeoutMs` deadline with\n * `final.status: 'failed'` — so cancellation stays distinguishable from a\n * blown deadline.\n *\n * Mid-stream lifecycle work needs NO extra API: the generator is pull-based,\n * so the producer is suspended between yields and resumes only when the caller\n * pulls again. A consumer can therefore run arbitrary async work between\n * events — sync state on each `tool_result`, decide a no-op retry after\n * draining, run a pre-`done` flush when it receives `final` and BEFORE it\n * forwards its own terminal event downstream. The interleaving is guaranteed\n * (and locked by test): nothing is produced past the event the caller is\n * holding.\n *\n * @stable\n */\n\nimport { scoreKnowledgeReadiness } from '@tangle-network/agent-eval'\nimport {\n  type AgentProfile,\n  canonicalCandidateDigest,\n  renderInputPartsAsText,\n} from '@tangle-network/agent-interface'\nimport type { AgentTurnInput } from '@tangle-network/agent-interface/environment-provider'\nimport type { PromptOptions, SandboxEvent, SandboxInstance } from '@tangle-network/sandbox'\nimport { type AgentRunOutcome, createAgentRunOutcomeTracker } from '@tangle-network/sandbox/runtime'\nimport { normalizeBackendStreamEvent } from '../backends'\nimport { BackendTransportError, ValidationError } from '../errors'\nimport { newRuntimeSession, nowIso } from '../sessions'\nimport type {\n  AgentBackendInput,\n  AgentExecutionBackend,\n  AgentTaskSpec,\n  AgentTaskStatus,\n  BackendErrorDetail,\n  RuntimeSession,\n  RuntimeStreamEvent,\n} from '../types'\nimport { awaitAbortable } from './retained-run-binding'\nimport {\n  canonicalStreamEventFromSandboxEvent,\n  createSandboxToolPartState,\n  isSandboxTerminalEvent,\n  mapSandboxEvent,\n  mapSandboxToolEvent,\n} from './sandbox-events'\nimport { projectSandboxOutcome, readSandboxOutcome } from './sandbox-outcome'\nimport { executableAgentProfileSnapshot } from './supervise/executable-spec'\nimport {\n  authoredProfileDigest,\n  knownExecutionBindingReceipt,\n  knownMaterializationReceipt,\n  runtimeOwnedExecutorExecutionBinding,\n  runtimeOwnedExecutorMaterialization,\n  runtimeOwnedPendingExecutorMaterialization,\n  unknownExecutionBindingReceipt,\n  unknownMaterializationReceipt,\n} from './supervise/materialization'\nimport {\n  concreteModelId,\n  profileBridgeWireModel,\n  profileProviderModel,\n} from './supervise/model-policy'\nimport type {\n  ExecutionBindingReceipt,\n  Executor,\n  ExecutorFactory,\n  ExecutorProgressEvent,\n  ExecutorResult,\n  NodeExecutionIdentity,\n  ProfileMaterializationReceipt,\n  UsageEvent,\n} from './supervise/types'\nimport {\n  promptFromAgentTurnInput,\n  promptOptionsFromAgentTurnInput,\n  providerMessageText,\n} from './turn-input'\n\n/**\n * The execution substrate one turn runs on — a closed discriminated union over\n * the three stream surfaces the runtime already owns.\n *\n * @stable\n */\nexport type AgentTurnBackend = {\n  /** A Runtime-owned executor factory materialized from this exact canonical profile. */\n  kind: 'executor'\n  factory: ExecutorFactory<unknown>\n  /** Exact canonical identity materialized by the executor. */\n  profile: AgentProfile\n  /** Model label stamped on cost-only `llm_call` events. Default `'agent'`. */\n  agentRunName?: string\n}\n\n/** Lower-level observation adapters. They normalize an already-created execution surface but do\n * not bind an AgentProfile to it, so they are deliberately absent from the public kernel export. */\ntype ObservedAgentTurnBackend =\n  | {\n      /** A live sandbox box: the turn is one `box.streamPrompt(prompt)` call. */\n      kind: 'box'\n      box: SandboxInstance\n      /**\n       * Per-turn `PromptOptions` forwarded verbatim to `streamPrompt`\n       * (`sessionId`, `turnId`, `model`, `backend` profile, `timeoutMs`, …).\n       * The turn's derived abort signal (caller `signal` + `timeoutMs`\n       * deadline) is always installed as `signal` — pass cancellation through\n       * `StreamAgentTurnOptions`, not here.\n       */\n      options?: Omit<PromptOptions, 'signal'>\n      /** Model label stamped on cost-only `llm_call` events. Default `'agent'`. */\n      agentRunName?: string\n    }\n  | {\n      /**\n       * A caller-supplied in-process `AgentExecutionBackend`: the turn is one\n       * `backend.stream()` call.\n       */\n      kind: 'chat'\n      backend: AgentExecutionBackend\n    }\n\nexport type { AgentTurnInput } from '@tangle-network/agent-interface/environment-provider'\n\n/** @stable */\nexport interface StreamAgentTurnOptions {\n  /** Caller-initiated cancellation. Terminates the stream with `final.status: 'aborted'`. */\n  signal?: AbortSignal\n  /**\n   * Wall-clock deadline for the whole turn in ms. An expired deadline aborts\n   * the backend and terminates the stream with `final.status: 'failed'`\n   * (a blown deadline is a turn failure, not a caller cancellation).\n   */\n  timeoutMs?: number\n  /** Stable logical paid-call id, forwarded as the provider idempotency key and retained in evidence. */\n  callId?: string\n  /** Caller trace tag retained in evidence and forwarded when the transport supports it. */\n  correlationId?: string\n  /**\n   * Opt-in tool-part projection for box and executor backends: sandbox tool\n   * parts additionally surface in-stream as\n   * `tool_call` / `tool_result` events (`mapSandboxToolEvent`), so a consumer\n   * rendering tool activity needs no bespoke sandbox-event parser. Default\n   * off — the stream vocabulary existing consumers see is unchanged. No-op\n   * for the `chat` kind (its backend emits `RuntimeStreamEvent`s directly,\n   * tool events included when the backend produces them).\n   */\n  preserveToolParts?: boolean\n  /**\n   * Raw-event tap for box-kind backends: called (and awaited) with every\n   * unmapped `SandboxEvent` BEFORE it is projected, so a consumer can read\n   * parts the chat-UX projection drops (part ids, step markers, custom\n   * backend events) without forking the mapper. Purely observational — it\n   * cannot alter the mapped stream. Never called for the `chat` kind, which\n   * has no sandbox events.\n   */\n  onRawEvent?: (event: SandboxEvent) => void | Promise<void>\n}\n\nfunction turnIntent(input: AgentTurnInput): string {\n  if (input.prompt !== undefined) return input.prompt\n  if (input.parts !== undefined) return renderInputPartsAsText(input.parts)\n  return providerMessageText(input.providerOptions) ?? 'structured agent turn'\n}\n\nfunction turnBackendInput(task: AgentTaskSpec, input: AgentTurnInput): AgentBackendInput {\n  return {\n    task,\n    ...(input.prompt === undefined ? {} : { message: input.prompt }),\n    ...(input.parts === undefined ? {} : { parts: structuredClone(input.parts) }),\n    ...(input.interactions === undefined ? {} : { interactions: input.interactions }),\n    ...(input.providerOptions === undefined\n      ? {}\n      : { providerOptions: structuredClone(input.providerOptions) }),\n  }\n}\n\nfunction executorEvidence(\n  executor: Executor<unknown>,\n  profile: AgentProfile,\n  attemptId: string,\n): {\n  materialization: ProfileMaterializationReceipt\n  executionBinding: ExecutionBindingReceipt\n} {\n  const profileDigest = authoredProfileDigest(profile)\n  const declaration = runtimeOwnedExecutorMaterialization(executor)\n  if (!profileDigest || !declaration) {\n    const materialization = unknownMaterializationReceipt({\n      ...(profileDigest ? { authoredProfileDigest: profileDigest } : {}),\n      runtime: executor.runtime,\n      reason: declaration ? 'invalid-executor-report' : 'executor-did-not-report',\n    })\n    return {\n      materialization,\n      executionBinding: unknownExecutionBindingReceipt(\n        materialization,\n        attemptId,\n        declaration ? 'invalid-executor-report' : 'executor-did-not-report',\n      ),\n    }\n  }\n  try {\n    const materialization = knownMaterializationReceipt({\n      authoredProfileDigest: profileDigest,\n      runtime: executor.runtime,\n      declaration,\n    })\n    const binding = runtimeOwnedExecutorExecutionBinding(executor)\n    if (!binding || binding.attemptId !== attemptId) throw new Error('executor attempt id mismatch')\n    return {\n      materialization,\n      executionBinding: knownExecutionBindingReceipt(materialization, binding),\n    }\n  } catch {\n    const materialization = unknownMaterializationReceipt({\n      authoredProfileDigest: profileDigest,\n      runtime: executor.runtime,\n      reason: 'invalid-executor-report',\n    })\n    return {\n      materialization,\n      executionBinding: unknownExecutionBindingReceipt(\n        materialization,\n        attemptId,\n        'invalid-executor-report',\n      ),\n    }\n  }\n}\n\n/** Exact turns require the model-bearing profile to be the sole behavioral authority. Runtime\n * checks the trusted declaration before execution so a seam fallback cannot hide behind the same\n * profile digest. */\nfunction assertExactExecutorDeclaration(executor: Executor<unknown>, profile: AgentProfile): void {\n  const profileModel = profileProviderModel(profile)\n  if (!profileModel) {\n    throw new ValidationError(\n      'streamAgentTurn: exact AgentProfile.model.default must name the concrete model',\n    )\n  }\n  const declaration =\n    runtimeOwnedExecutorMaterialization(executor) ??\n    runtimeOwnedPendingExecutorMaterialization(executor)?.declaration\n  if (!declaration) return\n  if (declaration.model.status !== 'known') {\n    throw new ValidationError(\n      'streamAgentTurn: exact executor did not materialize a known model identity',\n    )\n  }\n  if (declaration.backend === 'router' || declaration.backend === 'router-tools') {\n    const plan = declaration.plan as {\n      configuredModel?: unknown\n      configuredReasoningEffort?: unknown\n      reasoningEffort?: unknown\n    }\n    if (declaration.model.id !== profileModel) {\n      throw new ValidationError(\n        'streamAgentTurn: Router executor model differs from AgentProfile.model.default',\n      )\n    }\n    if (\n      plan.configuredModel !== null &&\n      plan.configuredModel !== undefined &&\n      concreteModelId(String(plan.configuredModel)) !== profileModel\n    ) {\n      throw new ValidationError(\n        'streamAgentTurn: configured Router model conflicts with AgentProfile.model.default',\n      )\n    }\n    const expectedEffort = profile.model?.reasoningEffort ?? null\n    if (\n      plan.configuredReasoningEffort !== null &&\n      plan.configuredReasoningEffort !== undefined &&\n      plan.configuredReasoningEffort !== expectedEffort\n    ) {\n      throw new ValidationError(\n        'streamAgentTurn: configured Router reasoning conflicts with AgentProfile.model.reasoningEffort',\n      )\n    }\n    if ((plan.reasoningEffort ?? null) !== expectedEffort) {\n      throw new ValidationError(\n        'streamAgentTurn: Router reasoning effort must come from AgentProfile.model.reasoningEffort',\n      )\n    }\n  }\n  if (declaration.backend === 'bridge' || declaration.backend === 'bridge-worktree') {\n    const expectedWireModel = profileBridgeWireModel(profile)\n    if (!expectedWireModel || declaration.model.id !== expectedWireModel) {\n      throw new ValidationError(\n        'streamAgentTurn: bridge executor model differs from the AgentProfile harness/provider/model wire id',\n      )\n    }\n    const plan = declaration.plan as { configuredModel?: unknown }\n    if (\n      plan.configuredModel !== null &&\n      plan.configuredModel !== undefined &&\n      concreteModelId(String(plan.configuredModel)) !== expectedWireModel\n    ) {\n      throw new ValidationError(\n        'streamAgentTurn: configured bridge model conflicts with the AgentProfile harness/provider/model wire id',\n      )\n    }\n  }\n}\n\nfunction turnProvenance(\n  startedAt: number,\n  timeoutMs: number | undefined,\n  profileDigest: string | undefined,\n  taskDigest: string,\n  materialization: ProfileMaterializationReceipt | undefined,\n  executionBinding: ExecutionBindingReceipt | undefined,\n  correlation: Readonly<Record<string, string>>,\n): Record<string, unknown> {\n  const endedAt = Date.now()\n  return {\n    ...(profileDigest\n      ? {\n          identity: {\n            profileDigest,\n            taskDigest,\n            ...(Object.keys(correlation).length > 0 ? { correlation } : {}),\n          },\n        }\n      : { taskDigest }),\n    ...(materialization ? { materialization } : {}),\n    ...(executionBinding ? { executionBindings: [executionBinding] } : {}),\n    budget: { timeoutMs: timeoutMs ?? null },\n    timing: {\n      startedAt: new Date(startedAt).toISOString(),\n      endedAt: new Date(endedAt).toISOString(),\n      durationMs: endedAt - startedAt,\n    },\n  }\n}\n\n/**\n * Metered usage of one turn, summed over every cost-bearing event the backend\n * emitted. `input`/`output` are token counts and are accompanied by\n * `tokensKnown: false` when the backend did not report them. `costUsd`/`model`\n * are present only when the backend actually reported them.\n *\n * @stable\n */\nexport interface AgentTurnUsage {\n  input: number\n  output: number\n  /** Present when a real turn ran but the provider did not report token usage. */\n  tokensKnown?: false\n  costUsd?: number\n  /** Present when Runtime could not prove the full dollar amount. */\n  usdKnown?: false\n  /** Separately-labelled local/catalog estimate; never billed spend. */\n  estimatedCostUsd?: number\n  /** Provider-reported prompt-cache fields; absent fields remain unknown. */\n  promptCache?: Readonly<Record<string, number | string>>\n  /** Provider-reported reasoning-token subset of output, when available. */\n  reasoningTokens?: number\n  model?: string\n}\n\n/**\n * A drained turn: the terminal summary plus every event the stream yielded.\n * `status`/`error` mirror the terminal `final` event so a failed or aborted\n * turn stays inspectable without re-scanning `events`.\n *\n * @stable\n */\nexport interface CollectedAgentTurn {\n  finalText: string\n  /** Exact terminal artifact output from a Runtime-owned executor. */\n  output?: unknown\n  usage: AgentTurnUsage\n  /** Exact underlying transport calls when the Runtime-owned executor reports them. */\n  transportAttempts?: number\n  toolCalls: Array<{ id?: string; name: string; arguments: string }>\n  events: RuntimeStreamEvent[]\n  status: AgentTaskStatus\n  error?: BackendErrorDetail\n  /** Public Sandbox outcome, when the turn ran through a Sandbox stream or executor. */\n  sandboxOutcome?: AgentRunOutcome\n}\n\n/** Mutable per-turn accumulator threaded through the backend adapters. */\ninterface TurnAccumulator {\n  /** Concatenated incremental text (`text_delta` events). */\n  deltaText: string\n  /** Final text read off a terminal `result`/`done`/`final` event, when the\n   *  backend emitted one. Preferred over `deltaText` for box streams, whose\n   *  `message.part.updated` fallback carries running accumulations. */\n  terminalText?: string\n  input: number\n  output: number\n  costUsd: number\n  estimatedCostUsd: number\n  sawEstimatedCost: boolean\n  promptCache: Record<string, number | string>\n  reasoningTokens?: number\n  tokensKnown: boolean\n  usdKnown: boolean\n  sawLlmCall: boolean\n  sawTokenUsage: boolean\n  sawCostUsage: boolean\n  model?: string\n  stopReason?: string\n  transportAttempts?: number\n  result?: ExecutorResult<unknown>\n  sandboxOutcome?: AgentRunOutcome\n}\n\n/**\n * Run ONE agent turn on any backend kind and stream its events. Yields the\n * `RuntimeStreamEvent` vocabulary incrementally and always ends with a `final`\n * event carrying the turn's text and usage (`metadata.tokenUsage`,\n * `metadata.costUsd?`, `metadata.model?`) — on success, failure, abort, and\n * timeout alike. The generator never throws; failures surface in-band as\n * `backend_error` + `final` with a typed `error` detail.\n *\n * @stable\n */\nexport async function* streamAgentTurn(\n  backend: AgentTurnBackend,\n  input: AgentTurnInput,\n  opts: StreamAgentTurnOptions = {},\n): AsyncGenerator<RuntimeStreamEvent> {\n  assertTurnTimeout(opts.timeoutMs)\n  if ((backend as { kind?: unknown }).kind !== 'executor') {\n    throw new ValidationError(\n      \"streamAgentTurn: exact execution accepts only kind 'executor'; use Runtime-owned creation\",\n    )\n  }\n  yield* streamAgentTurnInternal(backend, input, opts)\n}\n\n/** @internal Normalize a pre-created box/chat stream without asserting an AgentProfile identity. */\nexport async function* streamObservedAgentTurn(\n  backend: ObservedAgentTurnBackend,\n  input: AgentTurnInput,\n  opts: StreamAgentTurnOptions = {},\n): AsyncGenerator<RuntimeStreamEvent> {\n  assertTurnTimeout(opts.timeoutMs)\n  yield* streamAgentTurnInternal(backend, input, opts)\n}\n\nfunction assertTurnTimeout(timeoutMs: number | undefined): void {\n  if (timeoutMs === undefined) return\n  if (!Number.isSafeInteger(timeoutMs) || timeoutMs < 1 || timeoutMs > 2_147_483_647) {\n    throw new ValidationError('streamAgentTurn: timeoutMs must be an integer from 1 to 2147483647')\n  }\n}\n\nfunction assertTurnIdentity(value: string | undefined, field: string): void {\n  if (value !== undefined && (typeof value !== 'string' || value.trim().length === 0)) {\n    throw new ValidationError(`streamAgentTurn: ${field} must be a non-empty string`)\n  }\n}\n\nasync function* streamAgentTurnInternal(\n  backend: AgentTurnBackend | ObservedAgentTurnBackend,\n  input: AgentTurnInput,\n  opts: StreamAgentTurnOptions,\n): AsyncGenerator<RuntimeStreamEvent> {\n  const label = backend.kind === 'chat' ? backend.backend.kind : backend.kind\n  const profile =\n    backend.kind === 'executor'\n      ? executableAgentProfileSnapshot(backend.profile, 'streamAgentTurn')\n      : undefined\n  const profileDigest = profile ? authoredProfileDigest(profile) : undefined\n  assertTurnIdentity(opts.callId, 'callId')\n  assertTurnIdentity(opts.correlationId, 'correlationId')\n  const correlation = {\n    ...(opts.callId ? { callId: opts.callId } : {}),\n    ...(opts.correlationId ? { correlationId: opts.correlationId } : {}),\n  }\n  const taskInput = input\n  const taskDigest = canonicalCandidateDigest(taskInput)\n  const task: AgentTaskSpec = {\n    id: `turn-${crypto.randomUUID()}`,\n    intent: turnIntent(input),\n    ...(profileDigest\n      ? {\n          metadata: {\n            identity: {\n              profileDigest,\n              taskDigest,\n              ...(Object.keys(correlation).length > 0 ? { correlation } : {}),\n            } satisfies NodeExecutionIdentity,\n          },\n        }\n      : {}),\n  }\n  const acc: TurnAccumulator = {\n    deltaText: '',\n    input: 0,\n    output: 0,\n    costUsd: 0,\n    estimatedCostUsd: 0,\n    sawEstimatedCost: false,\n    promptCache: {},\n    tokensKnown: false,\n    usdKnown: false,\n    sawLlmCall: false,\n    sawTokenUsage: false,\n    sawCostUsage: false,\n  }\n  const deadline = deriveTurnSignal(opts.signal, opts.timeoutMs ?? 0)\n  const startedAt = Date.now()\n\n  let session: RuntimeSession | undefined\n  let executor: Executor<unknown> | undefined\n  let materialization: ProfileMaterializationReceipt | undefined\n  let executionBinding: ExecutionBindingReceipt | undefined\n  try {\n    const nodeId = task.id\n    const attemptId = `${nodeId}:attempt:${crypto.randomUUID()}`\n    if (backend.kind === 'executor') {\n      executor = backend.factory(\n        { profile: profile!, harness: null },\n        {\n          signal: deadline.signal,\n          seams: {},\n          node: {\n            rootId: nodeId,\n            parentId: nodeId,\n            nodeId,\n            attemptId,\n            identity: {\n              profileDigest: profileDigest!,\n              taskDigest,\n              ...(Object.keys(correlation).length > 0 ? { correlation } : {}),\n            },\n          },\n        },\n      )\n      assertExactExecutorDeclaration(executor, profile!)\n      const pending = runtimeOwnedPendingExecutorMaterialization(executor)\n      if (pending !== undefined) {\n        if (pending.runtime !== executor.runtime || pending.binding.attemptId !== attemptId) {\n          throw new ValidationError(\n            'streamAgentTurn: pending executor did not bind the kernel-minted attempt',\n          )\n        }\n        if (authoredProfileDigest(pending.declaration.effectiveProfile) !== profileDigest) {\n          throw new ValidationError(\n            'streamAgentTurn: pending executor changed the authored AgentProfile before execution',\n          )\n        }\n        materialization = unknownMaterializationReceipt({\n          authoredProfileDigest: profileDigest!,\n          runtime: executor.runtime,\n          reason: 'executor-receipt-pending',\n        })\n        executionBinding = unknownExecutionBindingReceipt(\n          materialization,\n          attemptId,\n          'executor-receipt-pending',\n        )\n      } else {\n        ;({ materialization, executionBinding } = executorEvidence(executor, profile!, attemptId))\n        assertExactExecutorEvidence(materialization, executionBinding)\n      }\n    } else {\n      materialization = unknownMaterializationReceipt({\n        runtime: backend.kind === 'box' ? 'sandbox' : label,\n        reason: 'executor-did-not-report',\n      })\n      executionBinding = unknownExecutionBindingReceipt(\n        materialization,\n        attemptId,\n        'executor-did-not-report',\n      )\n    }\n    const startedSession = await awaitAbortable(\n      Promise.resolve().then(() => startTurnSession(backend, task, input, deadline.signal, label)),\n      deadline.signal,\n    )\n    session = startedSession\n    yield {\n      type: 'backend_start',\n      task,\n      session: startedSession,\n      backend: executor?.runtime ?? label,\n      metadata: {\n        ...(profileDigest\n          ? {\n              identity: {\n                profileDigest,\n                taskDigest,\n                ...(Object.keys(correlation).length > 0 ? { correlation } : {}),\n              },\n            }\n          : { taskDigest }),\n        ...(materialization ? { materialization } : {}),\n        ...(executionBinding ? { executionBindings: [executionBinding] } : {}),\n        budget: { timeoutMs: opts.timeoutMs ?? null },\n        timing: { startedAt: new Date(startedAt).toISOString() },\n      },\n      timestamp: nowIso(),\n    }\n\n    const inner =\n      backend.kind === 'chat'\n        ? driveChatTurn(backend.backend, task, startedSession, input, deadline.signal, acc)\n        : backend.kind === 'executor'\n          ? driveExecutorTurn(\n              executor!,\n              task,\n              startedSession,\n              input,\n              deadline.signal,\n              acc,\n              materializedModel(materialization, profile!),\n            )\n          : driveBoxTurn(\n              backend.box,\n              input,\n              deadline.signal,\n              backend.agentRunName ?? 'agent',\n              acc,\n              {\n                ...(backend.options ? { options: backend.options } : {}),\n                preserveToolParts: opts.preserveToolParts === true,\n                ...(opts.onRawEvent ? { onRawEvent: opts.onRawEvent } : {}),\n              },\n            )\n    // One dedupe for every backend kind: a repeated provider `sourceEventId` is the same child\n    // update, so the turn publishes it once whether it arrives live, on reconnect, or on replay.\n    const seenChildTaskUpdates = new Set<string>()\n    for await (const event of abortableValues(inner, deadline.signal)) {\n      if (childTaskAlreadySeen(event, seenChildTaskUpdates)) {\n        throwIfAborted(deadline.signal)\n        continue\n      }\n      yield event\n      throwIfAborted(deadline.signal)\n    }\n    // Some providers close their iterator instead of throwing after an abort\n    // or deadline. Never turn that silent close into a successful completion.\n    throwIfAborted(deadline.signal)\n\n    if (backend.kind === 'executor') {\n      ;({ materialization, executionBinding } = executorEvidence(executor!, profile!, attemptId))\n      assertExactExecutorEvidence(materialization, executionBinding)\n    }\n\n    const terminalOutcome = acc.sandboxOutcome\n      ? projectSandboxOutcome(acc.sandboxOutcome)\n      : { status: 'completed' as const, reason: 'turn completed' }\n    yield buildFinalEvent(\n      task,\n      session,\n      acc,\n      terminalOutcome,\n      turnProvenance(\n        startedAt,\n        opts.timeoutMs,\n        profileDigest,\n        taskDigest,\n        materialization,\n        executionBinding,\n        correlation,\n      ),\n    )\n  } catch (err) {\n    // The turn is over, so a pending receipt cannot still resolve. `backend_start` already\n    // carried the pending value, where it was true; the final event must name the terminal\n    // outcome instead of a wait that has ended.\n    if (\n      materialization?.status === 'unknown' &&\n      materialization.reason === 'executor-receipt-pending' &&\n      executionBinding?.status === 'unknown'\n    ) {\n      const terminal = unknownMaterializationReceipt({\n        ...(materialization.authoredProfileDigest === undefined\n          ? {}\n          : { authoredProfileDigest: materialization.authoredProfileDigest }),\n        runtime: materialization.runtime,\n        reason: 'executor-failed-before-receipt',\n      })\n      executionBinding = unknownExecutionBindingReceipt(\n        terminal,\n        executionBinding.attemptId,\n        'executor-failed-before-receipt',\n      )\n      materialization = terminal\n    }\n    const callerAborted = opts.signal?.aborted === true\n    const sandboxProjection = acc.sandboxOutcome\n      ? projectSandboxOutcome(acc.sandboxOutcome)\n      : undefined\n    const status: AgentTaskStatus = callerAborted\n      ? 'aborted'\n      : (sandboxProjection?.status ?? 'failed')\n    const message = sandboxProjection?.reason ?? (err instanceof Error ? err.message : String(err))\n    const error: BackendErrorDetail =\n      sandboxProjection?.error ??\n      (err instanceof BackendTransportError\n        ? { kind: 'transport', message, status: err.status, body: err.body }\n        : { kind: 'backend', message })\n    yield {\n      type: 'backend_error',\n      task,\n      ...(session ? { session } : {}),\n      backend: label,\n      message,\n      recoverable: !callerAborted,\n      error,\n      timestamp: nowIso(),\n    }\n    yield buildFinalEvent(\n      task,\n      session,\n      acc,\n      { status, reason: message, error },\n      turnProvenance(\n        startedAt,\n        opts.timeoutMs,\n        profileDigest,\n        taskDigest,\n        materialization,\n        executionBinding,\n        correlation,\n      ),\n    )\n  } finally {\n    if (executor) {\n      await awaitAbortable(\n        Promise.resolve().then(() => executor!.teardown('brutalKill')),\n        deadline.signal,\n      ).catch(() => undefined)\n    }\n    deadline.dispose()\n  }\n}\n\nfunction assertExactExecutorEvidence(\n  materialization: ProfileMaterializationReceipt,\n  executionBinding: ExecutionBindingReceipt,\n): void {\n  if (materialization.status !== 'known' || executionBinding.status !== 'known') {\n    throw new ValidationError(\n      'streamAgentTurn: exact profile execution requires terminally validated Runtime materialization and execution binding evidence',\n    )\n  }\n  if (materialization.effectiveProfileDigest !== materialization.authoredProfileDigest) {\n    throw new ValidationError(\n      'streamAgentTurn: executor changed the authored AgentProfile; exact turn execution refuses profile overlays',\n    )\n  }\n}\n\n/**\n * Drain a `streamAgentTurn` stream (or any `RuntimeStreamEvent` stream that\n * honors its terminal contract) into the turn summary plus the full event\n * list. Fail-loud: throws when the stream ends without a terminal `final`\n * event — a stream that violates the contract must not read as an empty turn.\n *\n * @stable\n */\nexport async function collectAgentTurn(\n  stream: AsyncIterable<RuntimeStreamEvent>,\n): Promise<CollectedAgentTurn> {\n  const events: RuntimeStreamEvent[] = []\n  for await (const event of stream) events.push(event)\n  const final = events.at(-1)\n  if (final?.type !== 'final') {\n    throw new Error(\n      `collectAgentTurn: stream ended without a terminal 'final' event (last: ${final ? final.type : 'none'})`,\n    )\n  }\n  const metadata = final.metadata ?? {}\n  const resultMetadata =\n    metadata.result && typeof metadata.result === 'object'\n      ? (metadata.result as Record<string, unknown>)\n      : undefined\n  const sandboxOutcome =\n    metadata.sandboxOutcome && typeof metadata.sandboxOutcome === 'object'\n      ? (metadata.sandboxOutcome as AgentRunOutcome)\n      : undefined\n  const tokenUsage =\n    metadata.tokenUsage && typeof metadata.tokenUsage === 'object'\n      ? (metadata.tokenUsage as Record<string, unknown>)\n      : {}\n  const usage: AgentTurnUsage = {\n    input: finiteNumber(tokenUsage.input) ?? 0,\n    output: finiteNumber(tokenUsage.output) ?? 0,\n    ...(metadata.tokensKnown === false ? { tokensKnown: false as const } : {}),\n  }\n  const costUsd = finiteNumber(metadata.costUsd)\n  if (costUsd !== undefined) usage.costUsd = costUsd\n  if (metadata.usdKnown === false) usage.usdKnown = false\n  const estimatedCostUsd = finiteNumber(metadata.estimatedCostUsd)\n  if (estimatedCostUsd !== undefined) usage.estimatedCostUsd = estimatedCostUsd\n  if (metadata.promptCache && typeof metadata.promptCache === 'object') {\n    usage.promptCache = metadata.promptCache as Record<string, number | string>\n  }\n  const reasoningTokens = finiteNumber(metadata.reasoningTokens)\n  if (reasoningTokens !== undefined) usage.reasoningTokens = reasoningTokens\n  if (typeof metadata.model === 'string' && metadata.model.length > 0) {\n    usage.model = metadata.model\n  }\n  const transportAttempts = finiteNumber(metadata.transportAttempts)\n  const toolCalls = events\n    .filter((event) => event.type === 'tool_call')\n    .map((event) => ({\n      ...(event.toolCallId ? { id: event.toolCallId } : {}),\n      name: event.toolName,\n      arguments: typeof event.args === 'string' ? event.args : JSON.stringify(event.args ?? {}),\n    }))\n  return {\n    finalText: final.text ?? '',\n    ...(resultMetadata && 'output' in resultMetadata ? { output: resultMetadata.output } : {}),\n    usage,\n    ...(transportAttempts !== undefined ? { transportAttempts } : {}),\n    toolCalls,\n    events,\n    status: final.status,\n    ...(final.error ? { error: final.error } : {}),\n    ...(sandboxOutcome ? { sandboxOutcome } : {}),\n  }\n}\n\n/** Start the backend's session when it owns one (`chat` kind); mint a local\n *  correlation session otherwise. Box/executor turns carry no server session\n *  here — resume lives in `openSandboxRun`/`SandboxLineage`, not this primitive. */\nasync function startTurnSession(\n  backend: AgentTurnBackend | ObservedAgentTurnBackend,\n  task: AgentTaskSpec,\n  input: AgentTurnInput,\n  signal: AbortSignal,\n  label: string,\n): Promise<RuntimeSession> {\n  if (backend.kind === 'chat' && backend.backend.start) {\n    return backend.backend.start(turnBackendInput(task, input), {\n      task,\n      knowledge: emptyReadiness(task),\n      signal,\n    })\n  }\n  return newRuntimeSession(label)\n}\n\n/** Box-drive configuration derived from the backend kind + turn options. */\ninterface BoxTurnConfig {\n  /** Caller `PromptOptions` forwarded to `streamPrompt`; the turn's derived\n   *  signal is installed over any caller value. */\n  options?: Omit<PromptOptions, 'signal'>\n  /** Project tool parts to `tool_call`/`tool_result` (see `mapSandboxToolEvent`). */\n  preserveToolParts: boolean\n  /** Awaited raw-event tap, before projection. */\n  onRawEvent?: (event: SandboxEvent) => void | Promise<void>\n}\n\n/**\n * One turn over a box: `box.streamPrompt` projected through the existing\n * `mapSandboxEvent` (text/reasoning deltas +\n * cost-bearing `llm_call`s), plus the opt-in `mapSandboxToolEvent` tool-part\n * projection. Usage accumulates off the mapped `llm_call` events — the same\n * fold `sumSandboxUsage` applies. Final text prefers the terminal\n * `result`/`done`/`final` payload over concatenated deltas, because the\n * sandbox `message.part.updated` fallback may carry running accumulations.\n */\nasync function* driveBoxTurn(\n  box: SandboxInstance,\n  input: AgentTurnInput,\n  signal: AbortSignal,\n  agentRunName: string,\n  acc: TurnAccumulator,\n  cfg: BoxTurnConfig,\n): AsyncGenerator<RuntimeStreamEvent> {\n  const callOptions: PromptOptions = { ...(cfg.options ?? {}), signal }\n  const stream = box.streamPrompt(promptFromAgentTurnInput(input), {\n    ...callOptions,\n    ...promptOptionsFromAgentTurnInput(input),\n    signal,\n  })\n  const toolParts = cfg.preserveToolParts ? createSandboxToolPartState() : undefined\n  const outcomeTracker = createAgentRunOutcomeTracker()\n  for await (const event of abortableValues(stream, signal)) {\n    outcomeTracker.observe(event)\n    if (cfg.onRawEvent) {\n      await awaitAbortable(\n        Promise.resolve().then(() => cfg.onRawEvent!(event)),\n        signal,\n      )\n    }\n    const terminalText = terminalTextFromSandboxEvent(event)\n    if (terminalText !== undefined) acc.terminalText = terminalText\n    const canonical = canonicalStreamEventFromSandboxEvent(event)\n    if (canonical) {\n      yield canonical\n      continue\n    }\n\n    if (toolParts) {\n      for (const toolEvent of mapSandboxToolEvent(event, toolParts)) {\n        yield toolEvent\n      }\n    }\n    const mapped = mapSandboxEvent(event, { agentRunName })\n    if (mapped) {\n      // `mapSandboxEvent` stamps `agentRunName` as the model label when the\n      // event carried none — a run label, not a reported model. Exclude it from\n      // the terminal usage so `usage.model` is never a fabricated value.\n      foldEvent(mapped, acc, agentRunName)\n      yield mapped\n    }\n\n    // Unknown provider events stay available through onRawEvent. Do not copy\n    // arbitrary provider payloads into the public stream.\n  }\n  acc.sandboxOutcome = outcomeTracker.finish()\n  const projection = projectSandboxOutcome(acc.sandboxOutcome)\n  if (projection.status === 'failed') {\n    throw new Error(projection.reason)\n  }\n}\n\n/** One turn over an in-process backend: its own `stream()` surface, projected\n *  through the same `normalizeBackendStreamEvent` the task lifecycle applies. */\nasync function* driveChatTurn(\n  backend: AgentExecutionBackend,\n  task: AgentTaskSpec,\n  session: RuntimeSession,\n  input: AgentTurnInput,\n  signal: AbortSignal,\n  acc: TurnAccumulator,\n): AsyncGenerator<RuntimeStreamEvent> {\n  const backendInput = turnBackendInput(task, input)\n  const context = { task, knowledge: emptyReadiness(task), session, signal }\n  for await (const raw of abortableValues(backend.stream(backendInput, context), signal)) {\n    const event = normalizeBackendStreamEvent(raw, task, session)\n    foldEvent(event, acc)\n    yield event\n  }\n}\n\nasync function* driveExecutorTurn(\n  executor: Executor<unknown>,\n  task: AgentTaskSpec,\n  session: RuntimeSession,\n  input: AgentTurnInput,\n  signal: AbortSignal,\n  acc: TurnAccumulator,\n  declaredModel: string | undefined,\n): AsyncGenerator<RuntimeStreamEvent> {\n  const taskValue = executorTaskValue(input)\n  const run = executor.execute(taskValue, signal)\n  let result: ExecutorResult<unknown>\n  if (isAsyncIterable(run)) {\n    for await (const usage of abortableValues(run, signal)) {\n      if (usage.kind === 'progress') {\n        const projected = executorProgressStreamEvent(usage.progress, task, session)\n        foldEvent(projected, acc)\n        yield projected\n        throwIfAborted(signal)\n        continue\n      }\n      foldUsageEvent(usage, acc)\n      throwIfAborted(signal)\n    }\n    result = executor.resultArtifact()\n  } else {\n    result = await awaitAbortable(run, signal)\n  }\n  acc.result = result\n  acc.sandboxOutcome = readSandboxOutcome(result.out)\n  acc.terminalText = executorResultText(result.out)\n  acc.input = result.spent.tokens.input\n  acc.output = result.spent.tokens.output\n  acc.costUsd = result.spent.usd\n  const estimatedCostUsd = executorResultEstimatedCost(result.out)\n  if (estimatedCostUsd !== undefined) {\n    acc.estimatedCostUsd = estimatedCostUsd\n    acc.sawEstimatedCost = true\n  }\n  Object.assign(acc.promptCache, executorResultPromptCache(result.out))\n  acc.reasoningTokens = executorResultReasoningTokens(result.out)\n  acc.tokensKnown = result.spent.tokensKnown !== false\n  acc.usdKnown = result.spent.usdKnown !== false\n  acc.sawLlmCall = true\n\n  // Usage model identity is observational: the executor must report what answered. The profile's\n  // declared model remains available in materialization evidence, but it is not fabricated into\n  // `usage.model` when the provider/transport omitted an actual response model.\n  const model = executorResultModel(result.out)\n  if (model) acc.model = model\n  acc.stopReason = executorResultStopReason(result.out)\n  acc.transportAttempts = executorResultTransportAttempts(result.out)\n  const latencyMs = result.spent.ms\n  yield {\n    type: 'llm_call',\n    task,\n    session,\n    model: model ?? declaredModel ?? executor.runtime,\n    ...(acc.tokensKnown ? { tokensIn: acc.input, tokensOut: acc.output } : {}),\n    ...(acc.usdKnown ? { costUsd: acc.costUsd } : {}),\n    ...(acc.tokensKnown ? {} : { tokensKnown: false }),\n    ...(acc.usdKnown ? {} : { usdKnown: false }),\n    ...(acc.sawEstimatedCost ? { estimatedCostUsd: acc.estimatedCostUsd } : {}),\n    ...(Object.keys(acc.promptCache).length > 0 ? { promptCache: acc.promptCache } : {}),\n    latencyMs,\n    timestamp: nowIso(),\n  }\n  for (const call of executorResultToolCalls(result.out)) {\n    yield {\n      type: 'tool_call',\n      task,\n      session,\n      toolName: call.name,\n      ...(call.id ? { toolCallId: call.id } : {}),\n      args: call.arguments,\n      timestamp: nowIso(),\n    }\n  }\n  yield {\n    type: 'artifact',\n    task,\n    session,\n    artifactId: result.outRef,\n    name: 'agent-turn-result',\n    metadata: {\n      spend: result.spent,\n      ...(result.verdict ? { verdict: result.verdict } : {}),\n    },\n    timestamp: nowIso(),\n  }\n  if (acc.sandboxOutcome && projectSandboxOutcome(acc.sandboxOutcome).status === 'failed') {\n    throw new Error(projectSandboxOutcome(acc.sandboxOutcome).reason)\n  }\n}\n\nfunction executorTaskValue(input: AgentTurnInput): unknown {\n  const messages = input.providerOptions?.messages\n  if (Array.isArray(messages)) {\n    return { messages: structuredClone(messages) }\n  }\n  return {\n    ...(input.prompt === undefined ? {} : { prompt: input.prompt }),\n    ...(input.parts === undefined ? {} : { parts: structuredClone(input.parts) }),\n    ...(input.interactions === undefined ? {} : { interactions: input.interactions }),\n  }\n}\n\nfunction isAsyncIterable(value: unknown): value is AsyncIterable<UsageEvent> {\n  return typeof value === 'object' && value !== null && Symbol.asyncIterator in value\n}\n\n/**\n * Pull one provider iterator under Runtime's deadline.\n *\n * Providers still receive the signal for native cancellation, but correctness\n * does not depend on them observing it. A losing iterator is asked to close;\n * its late rejection is observed and cannot delay the terminal Runtime event.\n */\nasync function* abortableValues<T>(\n  source: AsyncIterable<T>,\n  signal: AbortSignal,\n): AsyncGenerator<T> {\n  const iterator = source[Symbol.asyncIterator]()\n  let completed = false\n  try {\n    for (;;) {\n      const next = await awaitAbortable(\n        Promise.resolve().then(() => iterator.next()),\n        signal,\n      )\n      if (next.done) {\n        completed = true\n        return\n      }\n      yield next.value\n    }\n  } finally {\n    if (!completed) {\n      try {\n        void Promise.resolve(iterator.return?.()).catch(() => undefined)\n      } catch {\n        // The Runtime deadline already owns the observable terminal result.\n      }\n    }\n  }\n}\n\nfunction executorResultText(value: unknown): string {\n  if (typeof value === 'string') return value\n  if (!value || typeof value !== 'object') return ''\n  const content = (value as Record<string, unknown>).content\n  return typeof content === 'string' ? content : ''\n}\n\nfunction executorResultModel(value: unknown): string | undefined {\n  if (!value || typeof value !== 'object') return undefined\n  const model = (value as Record<string, unknown>).model\n  return typeof model === 'string' && model.length > 0 ? model : undefined\n}\n\nfunction executorResultStopReason(value: unknown): string | undefined {\n  if (!value || typeof value !== 'object') return undefined\n  const reason = (value as Record<string, unknown>).finishReason\n  return typeof reason === 'string' && reason.length > 0 ? reason : undefined\n}\n\nfunction executorResultTransportAttempts(value: unknown): number | undefined {\n  if (!value || typeof value !== 'object') return undefined\n  const attempts = (value as Record<string, unknown>).transportAttempts\n  return typeof attempts === 'number' && Number.isSafeInteger(attempts) && attempts > 0\n    ? attempts\n    : undefined\n}\n\nfunction executorResultEstimatedCost(value: unknown): number | undefined {\n  if (!value || typeof value !== 'object') return undefined\n  return finiteNumber((value as Record<string, unknown>).estimatedCostUsd)\n}\n\nfunction executorResultPromptCache(value: unknown): Record<string, number | string> {\n  if (!value || typeof value !== 'object') return {}\n  const raw = (value as Record<string, unknown>).promptCache\n  if (!raw || typeof raw !== 'object' || Array.isArray(raw)) return {}\n  const cache: Record<string, number | string> = {}\n  for (const [key, entry] of Object.entries(raw)) {\n    if ((typeof entry === 'number' && Number.isFinite(entry)) || typeof entry === 'string') {\n      cache[key] = entry\n    }\n  }\n  return cache\n}\n\nfunction executorResultReasoningTokens(value: unknown): number | undefined {\n  if (!value || typeof value !== 'object') return undefined\n  const count = (value as Record<string, unknown>).reasoningTokens\n  return Number.isSafeInteger(count) && (count as number) >= 0 ? (count as number) : undefined\n}\n\n/**\n * Read the terminal tool calls an executor artifact published. Every Runtime-owned executor\n * reports `ExecutorToolCall[]`, so an artifact carrying any other shape is a defect in that\n * executor rather than a turn without tool calls: refuse it instead of dropping the calls.\n */\nfunction executorResultToolCalls(\n  value: unknown,\n): Array<{ id?: string; name: string; arguments: string }> {\n  if (!value || typeof value !== 'object') return []\n  const raw = (value as Record<string, unknown>).toolCalls\n  if (raw === undefined) return []\n  if (!Array.isArray(raw)) {\n    throw new ValidationError(\n      `streamAgentTurn: executor artifact toolCalls must be an ExecutorToolCall array, received ${typeof raw}`,\n    )\n  }\n  return raw.map((entry) => {\n    const call = entry && typeof entry === 'object' ? (entry as Record<string, unknown>) : undefined\n    if (!call || typeof call.name !== 'string' || call.name.length === 0) {\n      throw new ValidationError(\n        'streamAgentTurn: executor artifact toolCalls entries require a non-empty name',\n      )\n    }\n    return {\n      ...(typeof call.id === 'string' ? { id: call.id } : {}),\n      name: call.name,\n      arguments:\n        typeof call.arguments === 'string' ? call.arguments : JSON.stringify(call.arguments ?? {}),\n    }\n  })\n}\n\n/** Project one executor progress event onto the public turn vocabulary. */\nfunction executorProgressStreamEvent(\n  progress: ExecutorProgressEvent,\n  task: AgentTaskSpec,\n  session: RuntimeSession,\n): RuntimeStreamEvent {\n  const timestamp = nowIso()\n  if (progress.kind === 'text_delta') {\n    return { type: 'text_delta', task, session, text: progress.text, timestamp }\n  }\n  if (progress.kind === 'reasoning_delta') {\n    return { type: 'reasoning_delta', task, session, text: progress.text, timestamp }\n  }\n  if (progress.kind === 'tool_call') {\n    return {\n      type: 'tool_call',\n      task,\n      session,\n      toolName: progress.toolName,\n      ...(progress.toolCallId === undefined ? {} : { toolCallId: progress.toolCallId }),\n      ...(progress.args === undefined ? {} : { args: progress.args }),\n      timestamp,\n    }\n  }\n  if (progress.kind === 'tool_result') {\n    return {\n      type: 'tool_result',\n      task,\n      session,\n      toolName: progress.toolName,\n      ...(progress.toolCallId === undefined ? {} : { toolCallId: progress.toolCallId }),\n      ...(progress.result === undefined ? {} : { result: progress.result }),\n      timestamp,\n    }\n  }\n  if (progress.kind === 'child_task') {\n    return { ...progress.event, task, session, timestamp }\n  }\n  return { type: 'interaction', request: progress.request, task, session, timestamp }\n}\n\n/**\n * Drop a child-task update this turn already published. The provider's `sourceEventId` names one\n * exact update, so a reconnect or replay that repeats it must not add a second child.\n */\nfunction childTaskAlreadySeen(event: RuntimeStreamEvent, seen: Set<string>): boolean {\n  if (event.type !== 'child-task') return false\n  if (seen.has(event.sourceEventId)) return true\n  seen.add(event.sourceEventId)\n  return false\n}\n\n/** Fold one normalized executor usage event into the turn accumulator. */\nfunction foldUsageEvent(event: UsageEvent, acc: TurnAccumulator): void {\n  if (event.kind === 'tokens') {\n    const known = event.tokensKnown !== false\n    acc.tokensKnown = acc.sawTokenUsage ? acc.tokensKnown && known : known\n    acc.sawTokenUsage = true\n    acc.input += event.input\n    acc.output += event.output\n  } else if (event.kind === 'cost') {\n    const known = event.usdKnown\n    acc.usdKnown = acc.sawCostUsage ? acc.usdKnown && known : known\n    acc.sawCostUsage = true\n    acc.costUsd += event.usd\n    if (event.usdKnown === false && event.usdEstimated !== undefined) {\n      acc.estimatedCostUsd += event.usdEstimated\n      acc.sawEstimatedCost = true\n    }\n  }\n  if (event.kind === 'tokens' || event.kind === 'cost') acc.sawLlmCall = true\n}\n\n/** Fold one normalized event into the turn accumulator (text + usage).\n *  `fallbackModelLabel` — a mapper-stamped run label to exclude from\n *  `usage.model` (it is not a backend-reported model). */\nfunction foldEvent(\n  event: RuntimeStreamEvent,\n  acc: TurnAccumulator,\n  fallbackModelLabel?: string,\n): void {\n  if (event.type === 'text_delta') {\n    acc.deltaText += event.text\n    return\n  }\n  if (event.type === 'llm_call') {\n    const tokensReported =\n      event.tokensKnown !== false && event.tokensIn !== undefined && event.tokensOut !== undefined\n    const usdReported = event.usdKnown !== false && event.costUsd !== undefined\n    if (!acc.sawLlmCall) {\n      acc.tokensKnown = tokensReported\n      acc.usdKnown = usdReported\n      acc.sawLlmCall = true\n    } else {\n      acc.tokensKnown &&= tokensReported\n      acc.usdKnown &&= usdReported\n    }\n    acc.input += event.tokensIn ?? 0\n    acc.output += event.tokensOut ?? 0\n    acc.costUsd += event.costUsd ?? 0\n    if (event.estimatedCostUsd !== undefined) {\n      acc.estimatedCostUsd += event.estimatedCostUsd\n      acc.sawEstimatedCost = true\n    }\n    if (event.promptCache) Object.assign(acc.promptCache, event.promptCache)\n    if (event.model && event.model !== fallbackModelLabel) acc.model = event.model\n  }\n}\n\n/** Read the final text off a terminal sandbox event, when present. */\nfunction terminalTextFromSandboxEvent(event: SandboxEvent): string | undefined {\n  if (!event || typeof event !== 'object') return undefined\n  const type = String(event.type ?? '')\n  if (!isSandboxTerminalEvent(type)) return undefined\n  const data =\n    event.data && typeof event.data === 'object'\n      ? (event.data as Record<string, unknown>)\n      : ({} as Record<string, unknown>)\n  for (const key of ['finalText', 'text', 'response', 'content']) {\n    const value = data[key]\n    if (typeof value === 'string') return value\n  }\n  return undefined\n}\n\nfunction buildFinalEvent(\n  task: AgentTaskSpec,\n  session: RuntimeSession | undefined,\n  acc: TurnAccumulator,\n  outcome: { status: AgentTaskStatus; reason: string; error?: BackendErrorDetail },\n  provenance: Record<string, unknown>,\n): RuntimeStreamEvent {\n  const finalText = acc.terminalText ?? acc.deltaText\n  return {\n    type: 'final',\n    task,\n    ...(session ? { session } : {}),\n    status: outcome.status,\n    reason: outcome.status === 'completed' ? (acc.stopReason ?? outcome.reason) : outcome.reason,\n    ...(finalText ? { text: finalText } : {}),\n    metadata: {\n      tokenUsage: { input: acc.input, output: acc.output },\n      ...(acc.tokensKnown ? {} : { tokensKnown: false }),\n      ...(acc.usdKnown ? { costUsd: acc.costUsd } : { usdKnown: false }),\n      ...(acc.sawEstimatedCost ? { estimatedCostUsd: acc.estimatedCostUsd } : {}),\n      ...(Object.keys(acc.promptCache).length > 0 ? { promptCache: acc.promptCache } : {}),\n      ...(acc.reasoningTokens !== undefined ? { reasoningTokens: acc.reasoningTokens } : {}),\n      ...(acc.model ? { model: acc.model } : {}),\n      ...(acc.stopReason ? { stopReason: acc.stopReason } : {}),\n      ...(acc.transportAttempts !== undefined ? { transportAttempts: acc.transportAttempts } : {}),\n      ...(acc.sandboxOutcome\n        ? {\n            sandboxOutcome: acc.sandboxOutcome,\n            verdict: projectSandboxOutcome(acc.sandboxOutcome).verdict,\n          }\n        : {}),\n      ...(acc.result\n        ? {\n            result: {\n              outRef: acc.result.outRef,\n              output: acc.result.out,\n              ...(acc.sandboxOutcome\n                ? { verdict: projectSandboxOutcome(acc.sandboxOutcome).verdict }\n                : acc.result.verdict\n                  ? { verdict: acc.result.verdict }\n                  : {}),\n              spent: acc.result.spent,\n            },\n          }\n        : acc.sandboxOutcome\n          ? { result: { verdict: projectSandboxOutcome(acc.sandboxOutcome).verdict } }\n          : {}),\n      ...provenance,\n    },\n    ...(outcome.error ? { error: outcome.error } : {}),\n    timestamp: nowIso(),\n  }\n}\n\nfunction materializedModel(\n  receipt: ProfileMaterializationReceipt | undefined,\n  profile: AgentProfile,\n): string | undefined {\n  if (receipt?.status === 'known' && receipt.model.status === 'known') return receipt.model.id\n  const fallback = profile.model?.default\n  return typeof fallback === 'string' && fallback.length > 0 ? fallback : undefined\n}\n\n/** Minimal ready-by-construction readiness report for a requirement-free turn. */\nfunction emptyReadiness(task: AgentTaskSpec) {\n  return scoreKnowledgeReadiness({ taskId: task.id, requirements: [] })\n}\n\nfunction finiteNumber(value: unknown): number | undefined {\n  return typeof value === 'number' && Number.isFinite(value) ? value : undefined\n}\n\nfunction throwIfAborted(signal: AbortSignal): void {\n  if (!signal.aborted) return\n  throw signal.reason instanceof Error ? signal.reason : new Error(String(signal.reason))\n}\n\n/**\n * Derive the turn's effective abort signal: fires when EITHER the caller's\n * signal aborts OR the `timeoutMs` deadline elapses. `dispose()` clears the\n * timer so a finished turn never leaks a pending timeout. `timeoutMs <= 0`\n * disables the deadline. Node-portable (no `AbortSignal.any`, which needs\n * >=20.3 — the package floor is >=20).\n */\nfunction deriveTurnSignal(\n  callerSignal: AbortSignal | undefined,\n  timeoutMs: number,\n): { signal: AbortSignal; dispose: () => void } {\n  const controller = new AbortController()\n  const timer =\n    timeoutMs > 0\n      ? setTimeout(\n          () => controller.abort(new Error(`agent turn timed out after ${timeoutMs}ms`)),\n          timeoutMs,\n        )\n      : undefined\n  if (timer && typeof (timer as { unref?: () => void }).unref === 'function') {\n    ;(timer as { unref: () => void }).unref()\n  }\n  const onCallerAbort = () =>\n    controller.abort(callerSignal?.reason ?? new Error('agent turn aborted'))\n  if (callerSignal) {\n    if (callerSignal.aborted) onCallerAbort()\n    else callerSignal.addEventListener('abort', onCallerAbort, { once: true })\n  }\n  return {\n    signal: controller.signal,\n    dispose: () => {\n      if (timer) clearTimeout(timer)\n      callerSignal?.removeEventListener('abort', onCallerAbort)\n    },\n  }\n}\n"],"mappings":"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"}