@tangle-network/agent-runtime 0.46.0 → 0.48.0

package/dist/loop-runner-bin.d.ts

@@ -1,13 +1,13 @@
 #!/usr/bin/env node
-export { L as LoopRunnerCliArgs, f as LoopRunnerCliResult, p as parseLoopRunnerArgv, o as runLoopRunnerCli } from './loop-runner-bin-D-K6bRp3.js';
+export { L as LoopRunnerCliArgs, f as LoopRunnerCliResult, p as parseLoopRunnerArgv, o as runLoopRunnerCli } from './loop-runner-bin-DEm4roYF.js';
 import '@tangle-network/agent-eval/campaign';
 import '@tangle-network/agent-eval/contract';
 import './types-p8dWBIXL.js';
 import '@tangle-network/agent-eval';
-import './kb-gate-2Gwpz_27.js';
-import './coder-DCWFQpmJ.js';
+import './kb-gate-51BlLlVM.js';
+import './coder-CVZNGbyg.js';
 import '@tangle-network/sandbox';
-import './types-DnYoHvvZ.js';
+import './types-nBMuollC.js';
 import './runtime-hooks-C7JwKb9E.js';
 import './substrate-CUgk7F7s.js';
-import './driver-C-mtBo7h.js';
+import './driver-DYU2sgHr.js';

package/dist/loop-runner-bin.js

@@ -2,12 +2,12 @@
 import {
   parseLoopRunnerArgv,
   runLoopRunnerCli
-} from "./chunk-GN75RGM6.js";
+} from "./chunk-656G2XCL.js";
 import "./chunk-FNMGYYSS.js";
-import "./chunk-I42NHLKX.js";
+import "./chunk-LX66I3SC.js";
 import "./chunk-KADIJAD4.js";
 import "./chunk-HNUXAZIJ.js";
-import "./chunk-65FQLI4V.js";
+import "./chunk-IW2LMLK6.js";
 import "./chunk-GSUO5QS6.js";
 import "./chunk-DGUM43GV.js";
 export {

package/dist/loops.d.ts

@@ -1,9 +1,9 @@
 export { AgentProfile, CreateSandboxOptions, SandboxEvent, SandboxInstance } from '@tangle-network/sandbox';
-export { AssertTraceDerivedFindings, BridgeSeam, BudgetPool, BudgetReadout, CheckpointCapableBox, CliSeam, CombinatorShape, Corpus, CorpusFilter, CorpusRecord, CreateScopeAnalystOptions, CriuCapableClient, DefinePersona, DefinePersonaInput, Deliverable, EqualKArm, EqualKOnCost, EqualKOnCostOptions, EqualKVerdict, ExecutorConfig, Fanout, FanoutOptions, FanoutSynthesis, FileCorpus, FileResultBlobStore, FileSpawnJournal, FlatWidenGate, ForkCapableBox, InMemoryCorpus, InMemoryResultBlobStore, InMemorySpawnJournal, LoopDispatchOptions, LoopOptionsForDispatch, LoopShape, LoopUntil, LoopUntilSpec, LoopUntilState, OpenSandboxRunOptions, Outcome, Panel, PanelJudge, PanelSpec, PanelVerdict, Persona, PersonaContext, PersonaExecutors, Pipeline, PipelineStage, RenderCorpusToInstructions, RenderCorpusToInstructionsOptions, ReservationTicket, RouterSeam, RunPersonified, RunPersonifiedOptions, SandboxCapabilities, SandboxLineage, SandboxLineageHandle, SandboxRun, SandboxSeam, ScopeAnalyst, ScopeAnalyzeInput, ScopeWidenGate, SessionCapableBox, ShapeBudget, ShapeContext, ShapeRegistry, SteerContext, TrajectoryNode, TrajectoryReport, TrajectoryReportFn, TrajectoryReportOptions, TurnResult, UsageSink, Verify, VerifySpec, Widen, WidenDecision, WidenLineage, WidenSpec, acquireSandbox, assertTraceDerivedFindings, buildSteerContext, builtinShapes, contentAddress, createBudgetPool, createExecutor, createExecutorRegistry, createRootHandle, createSandboxLineage, createScope, createScopeAnalyst, createShapeRegistry, createSupervisor, definePersona, equalKOnCost, extractLlmCallEvent, fanout, flatWidenGate, inlineSandboxClient, loopDispatch, loopUntil, mapSandboxEvent, materializeTreeView, openSandboxRun, panel, pipeline, probeSandboxCapabilities, registerShape, renderCorpusToInstructions, replaySpawnTree, reportLoopUsage, runPersonified, settledToIteration, spendFromUsageEvents, trajectoryReport, verify, widen } from './runtime.js';
-export { A as AnalyzeInput, a as CompletionAnalyst, b as CompletionEvidence, c as CompletionPolicy, d as CompletionVerdict, C as CreateDriverOptions, D as DriverDecision, P as PlannerContext, e as TopologyMove, T as TopologyPlanner, f as completionAuthorizes, g as createDriver, h as deterministicCompletion, r as renderAnalyses, s as sentinelCompletion, i as stopSentinel } from './driver-C-mtBo7h.js';
-export { R as RunLoopOptions, c as createSandboxForSpec, d as defaultSelectWinner, r as runLoop } from './run-loop-CU2Y00Si.js';
-export { A as Agent, d as AgentSpec, B as Budget, j as Executor, k as ExecutorContext, E as ExecutorFactory, e as ExecutorRegistry, l as ExecutorResult, H as Handle, N as NodeId, m as NodeSnapshot, n as NodeStatus, o as Restart, R as ResultBlobStore, f as RootHandle, p as RootSignal, q as Runtime, S as Scope, c as Settled, b as SpawnEvent, a as SpawnJournal, r as SpawnOpts, h as Spend, g as SupervisedResult, i as Supervisor, s as SupervisorOpts, T as TreeView, U as UsageEvent, W as WidenGate } from './types-BfoeiQRZ.js';
-export { A as AgentRunSpec, D as Driver, E as ExecCtx, I as Iteration, C as LoopDecisionPayload, F as LoopEndedPayload, G as LoopIterationDispatchPayload, H as LoopIterationEndedPayload, J as LoopIterationStartedPayload, a as LoopLineageOptions, M as LoopPlanDescription, N as LoopPlanPayload, b as LoopResult, f as LoopSandboxPlacement, P as LoopStartedPayload, Q as LoopTeardownFailedPayload, c as LoopTokenUsage, e as LoopTraceEmitter, T as LoopTraceEvent, L as LoopWinner, O as OutputAdapter, S as SandboxClient, U as ValidationCtx, V as Validator } from './types-DnYoHvvZ.js';
+export { AgenticOptions, AgenticRunResult, AgenticSurface, AgenticTask, AgenticTool, ArtifactHandle, AssertTraceDerivedFindings, AuditIntentInput, AuditIntentOptions, AuthorStrategyOptions, AuthoredStrategy, BenchmarkCell, BenchmarkConfig, BenchmarkLift, BenchmarkReport, BenchmarkStrategySummary, BenchmarkTaskRow, BridgeSeam, BudgetPool, BudgetReadout, ChampionPick, ChampionPolicy, CheckpointCapableBox, CliSeam, CombinatorShape, Corpus, CorpusFilter, CorpusRecord, CreateScopeAnalystOptions, CriuCapableClient, DefinePersona, DefinePersonaInput, Deliverable, Environment, EqualKArm, EqualKOnCost, EqualKOnCostOptions, EqualKVerdict, EvolutionArchiveNode, EvolutionAuthor, EvolutionCandidate, EvolutionGeneration, EvolutionReport, ExecutorConfig, Fanout, FanoutOptions, FanoutSynthesis, FileCorpus, FileResultBlobStore, FileSpawnJournal, FlatWidenGate, ForkCapableBox, GitWorkspaceOptions, HarvestCorpusOptions, HarvestFailure, HarvestReport, InMemoryCorpus, InMemoryResultBlobStore, InMemorySpawnJournal, IntentAudit, LoopDispatchOptions, LoopOptionsForDispatch, LoopShape, LoopUntil, LoopUntilSpec, LoopUntilState, McpEndpoint, McpEnvironmentOptions, Observation, ObserveInput, ObserveOptions, OpenSandboxRunOptions, Outcome, Panel, PanelJudge, PanelSpec, PanelVerdict, Persona, PersonaContext, PersonaExecutors, Pipeline, PipelineStage, PromotionGateOptions, PromotionVerdict, RenderCorpusToInstructions, RenderCorpusToInstructionsOptions, ReservationTicket, RouterSeam, RouterToolsSeam, RunAgenticOptions, RunPersonified, RunPersonifiedOptions, SandboxCapabilities, SandboxLineage, SandboxLineageHandle, SandboxRun, SandboxSeam, ScopeAnalyst, ScopeAnalyzeInput, ScopeWidenGate, SessionCapableBox, ShapeBudget, ShapeContext, ShapeRegistry, Shell, ShotPersona, ShotSpec, SteerContext, Strategy, StrategyCtx, StrategyEvolutionConfig, StrategyResult, SurfaceScore, ToolSpec, TrajectoryNode, TrajectoryReport, TrajectoryReportFn, TrajectoryReportOptions, TurnResult, UsageSink, VerifierEnvironmentOptions, Verify, VerifySpec, Widen, WidenDecision, WidenLineage, WidenSpec, Workspace, WorkspaceCommit, acquireSandbox, adaptiveRefine, assertStrategyContract, assertTraceDerivedFindings, auditIntent, authorStrategy, breadthDriver, buildSteerContext, builtinShapes, contentAddress, createBudgetPool, createExecutor, createExecutorRegistry, createMcpEnvironment, createRootHandle, createSandboxLineage, createScope, createScopeAnalyst, createShapeRegistry, createSupervisor, createVerifierEnvironment, defaultAnalystInstruction, defaultAuditorInstruction, definePersona, defineStrategy, depthDriver, equalKOnCost, extractLlmCallEvent, fanout, flatWidenGate, gitWorkspace, harvestCorpus, inlineSandboxClient, jjWorkspace, localShell, loopDispatch, loopUntil, mapSandboxEvent, materializeTreeView, observe, openSandboxRun, panel, pipeline, printBenchmarkReport, probeSandboxCapabilities, promotionGate, refine, registerShape, renderCorpusToInstructions, renderReport, replaySpawnTree, reportLoopUsage, runAgentic, runBenchmark, runPersonified, runStrategyEvolution, sample, sampleThenRefine, selectChampion, settledToIteration, spendFromUsageEvents, strategyAuthorContract, trajectoryReport, verify, widen } from './runtime.js';
+export { A as AnalyzeInput, a as CompletionAnalyst, b as CompletionEvidence, c as CompletionPolicy, d as CompletionVerdict, C as CreateDriverOptions, D as DriverDecision, P as PlannerContext, e as TopologyMove, T as TopologyPlanner, f as completionAuthorizes, g as createDriver, h as deterministicCompletion, r as renderAnalyses, s as sentinelCompletion, i as stopSentinel } from './driver-DYU2sgHr.js';
+export { R as RunLoopOptions, c as createSandboxForSpec, d as defaultSelectWinner, r as runLoop } from './run-loop-DvD4aGiE.js';
+export { A as Agent, d as AgentSpec, B as Budget, j as Executor, k as ExecutorContext, h as ExecutorFactory, E as ExecutorRegistry, l as ExecutorResult, H as Handle, N as NodeId, m as NodeSnapshot, n as NodeStatus, o as Restart, R as ResultBlobStore, e as RootHandle, p as RootSignal, q as Runtime, S as Scope, c as Settled, b as SpawnEvent, a as SpawnJournal, r as SpawnOpts, g as Spend, f as SupervisedResult, i as Supervisor, s as SupervisorOpts, T as TreeView, U as UsageEvent, W as WidenGate } from './types-BpDfCPUp.js';
+export { A as AgentRunSpec, D as Driver, E as ExecCtx, I as Iteration, C as LoopDecisionPayload, F as LoopEndedPayload, G as LoopIterationDispatchPayload, H as LoopIterationEndedPayload, J as LoopIterationStartedPayload, a as LoopLineageOptions, M as LoopPlanDescription, N as LoopPlanPayload, b as LoopResult, f as LoopSandboxPlacement, P as LoopStartedPayload, Q as LoopTeardownFailedPayload, c as LoopTokenUsage, e as LoopTraceEmitter, T as LoopTraceEvent, L as LoopWinner, O as OutputAdapter, S as SandboxClient, U as ValidationCtx, V as Validator } from './types-nBMuollC.js';
 export { DefaultVerdict } from '@tangle-network/agent-eval';
 import '@tangle-network/agent-eval/campaign';
 import './runtime-hooks-C7JwKb9E.js';

package/dist/loops.js

@@ -6,7 +6,12 @@ import {
   InMemoryResultBlobStore,
   InMemorySpawnJournal,
   acquireSandbox,
+  adaptiveRefine,
+  assertStrategyContract,
   assertTraceDerivedFindings,
+  auditIntent,
+  authorStrategy,
+  breadthDriver,
   buildSteerContext,
   builtinShapes,
   completionAuthorizes,
@@ -15,6 +20,7 @@ import {
   createDriver,
   createExecutor,
   createExecutorRegistry,
+  createMcpEnvironment,
   createRootHandle,
   createSandboxForSpec,
   createSandboxLineage,
@@ -22,35 +28,56 @@ import {
   createScopeAnalyst,
   createShapeRegistry,
   createSupervisor,
+  createVerifierEnvironment,
+  defaultAnalystInstruction,
+  defaultAuditorInstruction,
   defaultSelectWinner,
   definePersona,
+  defineStrategy,
+  depthDriver,
   deterministicCompletion,
   equalKOnCost,
   fanout,
   flatWidenGate,
+  gitWorkspace,
+  harvestCorpus,
   inlineSandboxClient,
+  jjWorkspace,
+  localShell,
   loopDispatch,
   loopUntil,
   materializeTreeView,
+  observe,
   openSandboxRun,
   panel,
   pipeline,
+  printBenchmarkReport,
   probeSandboxCapabilities,
+  promotionGate,
+  refine,
   registerShape,
   renderAnalyses,
   renderCorpusToInstructions,
+  renderReport,
   replaySpawnTree,
   reportLoopUsage,
+  runAgentic,
+  runBenchmark,
   runLoop,
   runPersonified,
+  runStrategyEvolution,
+  sample,
+  sampleThenRefine,
+  selectChampion,
   sentinelCompletion,
   settledToIteration,
   spendFromUsageEvents,
   stopSentinel,
+  strategyAuthorContract,
   trajectoryReport,
   verify,
   widen
-} from "./chunk-65FQLI4V.js";
+} from "./chunk-IW2LMLK6.js";
 import {
   extractLlmCallEvent,
   mapSandboxEvent
@@ -64,7 +91,12 @@ export {
   InMemoryResultBlobStore,
   InMemorySpawnJournal,
   acquireSandbox,
+  adaptiveRefine,
+  assertStrategyContract,
   assertTraceDerivedFindings,
+  auditIntent,
+  authorStrategy,
+  breadthDriver,
   buildSteerContext,
   builtinShapes,
   completionAuthorizes,
@@ -73,6 +105,7 @@ export {
   createDriver,
   createExecutor,
   createExecutorRegistry,
+  createMcpEnvironment,
   createRootHandle,
   createSandboxForSpec,
   createSandboxLineage,
@@ -80,33 +113,54 @@ export {
   createScopeAnalyst,
   createShapeRegistry,
   createSupervisor,
+  createVerifierEnvironment,
+  defaultAnalystInstruction,
+  defaultAuditorInstruction,
   defaultSelectWinner,
   definePersona,
+  defineStrategy,
+  depthDriver,
   deterministicCompletion,
   equalKOnCost,
   extractLlmCallEvent,
   fanout,
   flatWidenGate,
+  gitWorkspace,
+  harvestCorpus,
   inlineSandboxClient,
+  jjWorkspace,
+  localShell,
   loopDispatch,
   loopUntil,
   mapSandboxEvent,
   materializeTreeView,
+  observe,
   openSandboxRun,
   panel,
   pipeline,
+  printBenchmarkReport,
   probeSandboxCapabilities,
+  promotionGate,
+  refine,
   registerShape,
   renderAnalyses,
   renderCorpusToInstructions,
+  renderReport,
   replaySpawnTree,
   reportLoopUsage,
+  runAgentic,
+  runBenchmark,
   runLoop,
   runPersonified,
+  runStrategyEvolution,
+  sample,
+  sampleThenRefine,
+  selectChampion,
   sentinelCompletion,
   settledToIteration,
   spendFromUsageEvents,
   stopSentinel,
+  strategyAuthorContract,
   trajectoryReport,
   verify,
   widen

package/dist/mcp/bin.js

@@ -4,17 +4,17 @@ import {
   createPropagatingTraceEmitter,
   detectExecutor,
   readTraceContextFromEnv
-} from "../chunk-KPN7OQ64.js";
+} from "../chunk-TJS7S3HJ.js";
 import "../chunk-WIR4HOOJ.js";
 import "../chunk-JNPK46YH.js";
 import {
   createDefaultCoderDelegate
-} from "../chunk-I42NHLKX.js";
+} from "../chunk-LX66I3SC.js";
 import "../chunk-KADIJAD4.js";
 import "../chunk-GLR25NG7.js";
 import {
   runLoop
-} from "../chunk-65FQLI4V.js";
+} from "../chunk-IW2LMLK6.js";
 import "../chunk-GSUO5QS6.js";
 import "../chunk-DGUM43GV.js";
 

package/dist/mcp/index.d.ts

@@ -1,17 +1,17 @@
-import { S as SandboxClient, f as LoopSandboxPlacement, e as LoopTraceEmitter } from '../types-DnYoHvvZ.js';
-import { c as FleetHandle, d as DelegationExecutor, e as DelegateFeedbackArgs, f as DelegationFeedbackSnapshot, g as DelegationProfile, D as DelegateCodeArgs, h as DelegateResearchArgs, i as DelegateUiAuditArgs, j as DelegationStatus, k as DelegationProgress, l as DelegationResultPayload, m as DelegationError, n as DelegationStatusResult, o as DelegationHistoryArgs, p as DelegationHistoryEntry, q as CoderDelegate, R as ResearcherDelegate, U as UiAuditorDelegate, r as DelegateCodeResult, s as DelegateFeedbackResult, t as ResearchSource, u as DelegateResearchResult, v as DelegateUiAuditResult, w as DelegationHistoryResult, x as DelegationStatusArgs } from '../kb-gate-2Gwpz_27.js';
-export { y as CoderReview, C as CoderReviewer, a as CoderWinnerSelection, z as CreateDefaultCoderDelegateOptions, b as CreateKbGateOptions, A as DelegateCodeConfig, B as DelegateResearchConfig, E as DelegateRunCtx, G as DelegateUiAuditConfig, H as DelegateUiAuditRoute, F as FactCandidate, I as FactJudge, J as FactJudgeVerdict, K as FeedbackRating, L as FeedbackRefersTo, M as FleetWorkspaceExecutorOptions, N as KbGateResult, O as ResearchOutputShape, S as SiblingSandboxExecutorOptions, P as UiAuditorDelegationOutput, Q as createDefaultCoderDelegate, T as createFleetWorkspaceExecutor, V as createKbGate, W as createSiblingSandboxExecutor } from '../kb-gate-2Gwpz_27.js';
+import { S as SandboxClient, f as LoopSandboxPlacement, e as LoopTraceEmitter } from '../types-nBMuollC.js';
+import { c as FleetHandle, d as DelegationExecutor, e as DelegateFeedbackArgs, f as DelegationFeedbackSnapshot, g as DelegationProfile, D as DelegateCodeArgs, h as DelegateResearchArgs, i as DelegateUiAuditArgs, j as DelegationStatus, k as DelegationProgress, l as DelegationResultPayload, m as DelegationError, n as DelegationStatusResult, o as DelegationHistoryArgs, p as DelegationHistoryEntry, q as CoderDelegate, R as ResearcherDelegate, U as UiAuditorDelegate, r as DelegateCodeResult, s as DelegateFeedbackResult, t as ResearchSource, u as DelegateResearchResult, v as DelegateUiAuditResult, w as DelegationHistoryResult, x as DelegationStatusArgs } from '../kb-gate-51BlLlVM.js';
+export { y as CoderReview, C as CoderReviewer, a as CoderWinnerSelection, z as CreateDefaultCoderDelegateOptions, b as CreateKbGateOptions, A as DelegateCodeConfig, B as DelegateResearchConfig, E as DelegateRunCtx, G as DelegateUiAuditConfig, H as DelegateUiAuditRoute, F as FactCandidate, I as FactJudge, J as FactJudgeVerdict, K as FeedbackRating, L as FeedbackRefersTo, M as FleetWorkspaceExecutorOptions, N as KbGateResult, O as ResearchOutputShape, S as SiblingSandboxExecutorOptions, P as UiAuditorDelegationOutput, Q as createDefaultCoderDelegate, T as createFleetWorkspaceExecutor, V as createKbGate, W as createSiblingSandboxExecutor } from '../kb-gate-51BlLlVM.js';
 export { B as BuildDelegationMcpServerOptions, C as ComposeProductionAgentProfileOptions, D as DELEGATION_MCP_SERVER_KEY, b as buildDelegationMcpServer, c as composeProductionAgentProfile } from '../delegation-profile-1GbW5yA3.js';
 import { L as LocalHarness, r as runLocalHarness } from '../local-harness-KrdFTY5R.js';
 export { a as LocalHarnessResult, R as RunLocalHarnessOptions } from '../local-harness-KrdFTY5R.js';
-import { O as OtelExporter } from '../otel-export-nurzFwuJ.js';
-export { m as mcpToolsForRuntimeMcp, a as mcpToolsForRuntimeMcpSubset } from '../otel-export-nurzFwuJ.js';
+import { O as OtelExporter } from '../otel-export-EzfsVUhh.js';
+export { m as mcpToolsForRuntimeMcp, a as mcpToolsForRuntimeMcpSubset } from '../otel-export-EzfsVUhh.js';
 import { AnalystFinding } from '@tangle-network/agent-eval';
-import { S as Scope, R as ResultBlobStore, A as Agent, B as Budget } from '../types-BfoeiQRZ.js';
+import { S as Scope, R as ResultBlobStore, A as Agent, B as Budget } from '../types-BpDfCPUp.js';
 import { a as UiLens } from '../substrate-CUgk7F7s.js';
 import '@tangle-network/sandbox';
 import '../runtime-hooks-C7JwKb9E.js';
-import '../coder-DCWFQpmJ.js';
+import '../coder-CVZNGbyg.js';
 import 'node:child_process';
 
 /**
@@ -452,10 +452,9 @@ interface McpServerOptions {
     /** Override the default in-memory task queue. */
     queue?: DelegationTaskQueue;
     /**
-     * Extra tools to serve alongside the delegation tools — e.g. the operator toolbox
-     * (`createCoordinationTools(...).tools`), which exposes the driver's spawn/observe/steer verbs over
-     * MCP so a sandbox agent can BE the driver. Registered after the built-ins; a duplicate name
-     * throws (fail loud — no silent shadowing of a delegation tool).
+     * Extra tools to serve alongside the delegation tools, for example
+     * `createCoordinationTools(...).tools`. Registered after the built-ins; a
+     * duplicate name throws so delegation tools cannot be shadowed silently.
      */
     extraTools?: McpToolDescriptor[];
     /** Server display name surfaced via `initialize`. Default `'agent-runtime-mcp'`. */
@@ -570,9 +569,11 @@ interface CheckRunnerOptions {
 /** Run ONE lens over a trace → findings. Generic over any kind: prompt = the lens + the agent-eval
  *  finding schema; the model's JSON array is parsed (`parseRawFinding`), lifted, and firewalled. */
 declare function runCheck(kind: Check, trace: unknown, opts: CheckRunnerOptions, producedAt: string): Promise<AnalystFinding[]>;
-/** Build a `run_analyst` runner over a kind directory — the seam the operator toolbox is wired with.
- *  Returns the findings, or a typed error for an unknown kind. `producedAt` is passed in (the runtime
- *  forbids `Date.now` in replay-safe paths; the caller stamps it). */
+/**
+ * Build a `run_analyst` runner over a kind directory.
+ * Returns findings, or a typed error for an unknown kind. `producedAt` is
+ * passed in because replay-safe paths must not read `Date.now`.
+ */
 declare function makeCheckRunner(kinds: Record<string, Check>, opts: CheckRunnerOptions): (kindId: string, trace: unknown, producedAt: string) => Promise<AnalystFinding[] | {
     error: string;
 }>;
@@ -580,84 +581,84 @@ declare function makeCheckRunner(kinds: Record<string, Check>, opts: CheckRunner
 /**
  * @experimental
  *
- * COORDINATION TOOLS — the verbs a parent agent uses to coordinate the child agents it spawns,
- * exposed as MCP tools backed by a live keystone `Scope`. This is `Scope`-as-MCP.
- *
- * NOT a transport. The cross-org message bus (`docs/agent-bus-protocol.md`) and the SDK's
- * `dispatchPrompt`/`SessionMessage` are the *transports* the `steer` verb rides; THIS file is the
- * verb set (the API). One verb, several bindings: in-process `Scope.send` is a direct call; across
- * sandboxes it rides SDK session-messaging; across orgs it rides the agent-bus protocol.
- *
- *   spawn_worker  → scope.spawn   (budget-bounded, fail-closed — equal-k holds even for an LLM driver)
- *   await_next    → scope.next    (THE wake event: block until the next spawned child settles)
- *   observe_worker→ scope.view + the result blob (a child's status, spend, and settled output)
- *   steer_worker  → scope.send    (deliver a next-instruction / interrupt to a RUNNING child)
- *   list_analysts → the check menu (the trace lenses the agent can apply — see checks.ts)
- *   run_analyst   → apply a CHECK  (run a kind over a child's trace → trace-derived findings)
- *   stop          → declare the run complete (the terminal move)
- *
- * The check verbs are present only when the check seam (`analystKinds` + `runAnalyst`) is wired —
- * an agent that does not review traces (a pure dispatcher) omits them. A trace check is a SEPARATE
- * lens (selector ≠ judge: it reads the trace, never the score); authoring a NEW check at runtime is
- * the next addition.
- *
- * A worker the driver spawns may itself carry the driver profile — `spawn_worker` does not care what
- * the profile is, so drivers-of-drivers fall out for free (each sub-driver gets its own sub-scope,
- * bounded by `maxDepth` + the conserved pool).
+ * MCP binding for a live `Scope`. A sandbox driver gets the same small verbs
+ * the in-process driver has: spawn, observe, await, steer, ask/answer, analyze,
+ * and stop. Settled outputs remain Scope artifacts; product code can project
+ * them into any UI/report envelope it needs.
  */
 
-/** A worker the driver has drained via `await_next` — the operator's running ledger of settled
- *  workers + their DEPLOYABLE verdict (the driver IS the selector, so it legitimately reads the
- *  verdict; the analyst, which reads only the trace, is the separate selector≠judge lens). The
- *  driver picks its deliverable from this ledger at `stop`. */
+/** A worker the driver has drained via `await_next`. */
 interface SettledWorker {
     readonly id: string;
     readonly status: 'done' | 'down';
-    /** Deployable score in [0,1] from the worker's verdict (done only). */
     readonly score?: number;
-    /** Whether the deployable verdict passed (done only). */
     readonly valid?: boolean;
-    /** Result-blob pointer for the worker's output/trace (done only). */
     readonly outRef?: string;
-    /** Failure reason (down only). */
     readonly reason?: string;
 }
-/** How a `spawn_worker` profile becomes a spawnable leaf `Agent`. The caller wires this (e.g. the
- *  surface registry turns a profile into a shot executor) so the toolbox stays domain-blind. */
+type QuestionLevel = 'worker' | 'driver' | 'loop';
+type QuestionUrgency = 'continue-without' | 'blocks-step' | 'blocks-run';
+interface QuestionOption {
+    readonly label: string;
+    readonly tradeoff: string;
+}
+interface Question {
+    readonly id: string;
+    readonly from: string;
+    readonly level: QuestionLevel;
+    readonly question: string;
+    readonly reason: string;
+    readonly urgency: QuestionUrgency;
+    readonly options?: ReadonlyArray<QuestionOption>;
+}
+type QuestionDecision = {
+    readonly kind: 'answer';
+    readonly answer: string;
+    readonly by: string;
+} | {
+    readonly kind: 'defer';
+    readonly reason: string;
+} | {
+    readonly kind: 'escalate';
+    readonly to: 'parent' | 'user' | string;
+    readonly reason: string;
+};
+interface QuestionRecord extends Question {
+    readonly status: 'open' | 'answered' | 'deferred' | 'escalated';
+    readonly decision?: QuestionDecision;
+    readonly openedAt: number;
+}
+type QuestionPolicy = 'auto' | 'mustDecide' | 'bubble' | 'failClosed';
+interface AnalystRegistry {
+    readonly kinds: ReadonlyArray<{
+        id: string;
+        description: string;
+        area: string;
+    }>;
+    readonly run: (kindId: string, trace: unknown) => Promise<unknown>;
+}
+type CoordinationEvent = {
+    readonly type: 'question';
+    readonly question: QuestionRecord;
+};
 type MakeWorkerAgent = (profile: unknown) => Agent<unknown, unknown>;
 interface CoordinationToolsOptions {
-    /** The DRIVER's live scope — spawn/observe/steer all act on this. */
     readonly scope: Scope<unknown>;
-    /** Result blobs, so `observe_worker` can rehydrate a settled worker's output. */
     readonly blobs: ResultBlobStore;
-    /** Turn a spawn_worker `profile` into a leaf agent (registry-resolved on spawn). */
     readonly makeWorkerAgent: MakeWorkerAgent;
-    /** Per-worker conserved budget the driver reserves on each spawn. */
     readonly perWorker: Budget;
-    /** The analyst lens menu (for `list_analysts`) — id + one-line + area. Injected so the toolbox
-     *  stays domain-blind; wire it from `analyst-kinds.ts`'s directory. Omit to disable analyst tools. */
-    readonly analystKinds?: ReadonlyArray<{
-        id: string;
-        description: string;
-        area: string;
-    }>;
-    /** Run a lens over a worker's trace → findings (or a typed error). Wire it from
-     *  `makeCheckRunner(...)`. `run_analyst` fetches the worker's settled output and passes it here. */
-    readonly runAnalyst?: (kindId: string, trace: unknown) => Promise<unknown>;
+    readonly analysts?: AnalystRegistry;
+    readonly onEvent?: (event: CoordinationEvent) => void | Promise<void>;
+    readonly questionPolicy?: QuestionPolicy;
 }
 interface CoordinationTools {
-    /** MCP tools — register on an `McpServer`, or call the handlers directly in-process. */
     readonly tools: McpToolDescriptor[];
-    /** True once the driver called `stop` — the operator loop reads this to terminate. */
     isStopped(): boolean;
-    /** The reason passed to `stop`, if any. */
     stopReason(): string | undefined;
-    /** The workers drained so far via `await_next` (the driver's selection ledger). */
     settled(): ReadonlyArray<SettledWorker>;
+    questions(): ReadonlyArray<QuestionRecord>;
 }
-/** Build the operator toolbox over a live scope. The tools are the driver's verbs; their handlers
- *  are thin wrappers over the keystone (spawn/view/send), so the budget/journal/abort discipline of
- *  the Supervisor applies to a sandbox driver exactly as to the in-process one. */
+/** Build the driver's MCP tools over a live scope. */
 declare function createCoordinationTools(opts: CoordinationToolsOptions): CoordinationTools;
 
 /**
@@ -1147,4 +1148,4 @@ declare function createPropagatingTraceEmitter(ctx: TraceContext): {
  */
 declare function traceContextToEnv(ctx: TraceContext): Record<string, string>;
 
-export { type Check, type CheckRunnerOptions, CoderDelegate, type CoordinationTools, type CoordinationToolsOptions, type CreateWorktreeOptions, DELEGATE_CODE_DESCRIPTION, DELEGATE_CODE_INPUT_SCHEMA, DELEGATE_CODE_TOOL_NAME, DELEGATE_FEEDBACK_DESCRIPTION, DELEGATE_FEEDBACK_INPUT_SCHEMA, DELEGATE_FEEDBACK_TOOL_NAME, DELEGATE_RESEARCH_DESCRIPTION, DELEGATE_RESEARCH_INPUT_SCHEMA, DELEGATE_RESEARCH_TOOL_NAME, DELEGATE_UI_AUDIT_DESCRIPTION, DELEGATE_UI_AUDIT_INPUT_SCHEMA, DELEGATE_UI_AUDIT_TOOL_NAME, DELEGATION_HISTORY_DESCRIPTION, DELEGATION_HISTORY_INPUT_SCHEMA, DELEGATION_HISTORY_TOOL_NAME, DELEGATION_STATUS_DESCRIPTION, DELEGATION_STATUS_INPUT_SCHEMA, DELEGATION_STATUS_TOOL_NAME, DelegateCodeArgs, DelegateCodeResult, DelegateFeedbackArgs, DelegateFeedbackResult, DelegateResearchArgs, DelegateResearchResult, DelegateUiAuditArgs, DelegateUiAuditResult, DelegationError, DelegationExecutor, DelegationFeedbackSnapshot, DelegationHistoryArgs, DelegationHistoryEntry, DelegationHistoryResult, DelegationProfile, DelegationProgress, type DelegationRecord, DelegationResultPayload, DelegationStatus, DelegationStatusArgs, DelegationStatusResult, DelegationTaskQueue, type DelegationTaskQueueOptions, type DetectExecutorArgs, type DiffOptions, type DiffResult, type FeedbackEvent, type FeedbackStore, FleetHandle, type GitRunner, InMemoryFeedbackStore, type InProcessExecutorDescribePlacement, type InProcessExecutorOptions, type JsonRpcMessage, type JsonRpcResponse, LocalHarness, type MakeWorkerAgent, type McpServer, type McpServerOptions, type McpToolDescriptor, type McpTransport, type RemoveWorktreeOptions, ResearchSource, ResearcherDelegate, type SettledWorker, type SubmitInput, type SubmitOutput, type TraceContext, UiAuditorDelegate, type WorktreeHandle, captureWorktreeDiff, createCoordinationTools, createDelegateCodeHandler, createDelegateFeedbackHandler, createDelegateResearchHandler, createDelegateUiAuditHandler, createDelegationHistoryHandler, createDelegationStatusHandler, createInProcessExecutor, createInProcessTransport, createMcpServer, createPropagatingTraceEmitter, createWorktree, defaultChecks, detectExecutor, eventToSnapshot, hashIdempotencyInput, liftFindings, makeCheckRunner, readTraceContextFromEnv, removeWorktree, renderTrace, runCheck, runLocalHarness, traceContextToEnv, validateDelegateCodeArgs, validateDelegateFeedbackArgs, validateDelegateResearchArgs, validateDelegateUiAuditArgs, validateDelegationHistoryArgs, validateDelegationStatusArgs };
+export { type AnalystRegistry, type Check, type CheckRunnerOptions, CoderDelegate, type CoordinationEvent, type CoordinationTools, type CoordinationToolsOptions, type CreateWorktreeOptions, DELEGATE_CODE_DESCRIPTION, DELEGATE_CODE_INPUT_SCHEMA, DELEGATE_CODE_TOOL_NAME, DELEGATE_FEEDBACK_DESCRIPTION, DELEGATE_FEEDBACK_INPUT_SCHEMA, DELEGATE_FEEDBACK_TOOL_NAME, DELEGATE_RESEARCH_DESCRIPTION, DELEGATE_RESEARCH_INPUT_SCHEMA, DELEGATE_RESEARCH_TOOL_NAME, DELEGATE_UI_AUDIT_DESCRIPTION, DELEGATE_UI_AUDIT_INPUT_SCHEMA, DELEGATE_UI_AUDIT_TOOL_NAME, DELEGATION_HISTORY_DESCRIPTION, DELEGATION_HISTORY_INPUT_SCHEMA, DELEGATION_HISTORY_TOOL_NAME, DELEGATION_STATUS_DESCRIPTION, DELEGATION_STATUS_INPUT_SCHEMA, DELEGATION_STATUS_TOOL_NAME, DelegateCodeArgs, DelegateCodeResult, DelegateFeedbackArgs, DelegateFeedbackResult, DelegateResearchArgs, DelegateResearchResult, DelegateUiAuditArgs, DelegateUiAuditResult, DelegationError, DelegationExecutor, DelegationFeedbackSnapshot, DelegationHistoryArgs, DelegationHistoryEntry, DelegationHistoryResult, DelegationProfile, DelegationProgress, type DelegationRecord, DelegationResultPayload, DelegationStatus, DelegationStatusArgs, DelegationStatusResult, DelegationTaskQueue, type DelegationTaskQueueOptions, type DetectExecutorArgs, type DiffOptions, type DiffResult, type FeedbackEvent, type FeedbackStore, FleetHandle, type GitRunner, InMemoryFeedbackStore, type InProcessExecutorDescribePlacement, type InProcessExecutorOptions, type JsonRpcMessage, type JsonRpcResponse, LocalHarness, type MakeWorkerAgent, type McpServer, type McpServerOptions, type McpToolDescriptor, type McpTransport, type Question, type QuestionDecision, type QuestionPolicy, type QuestionRecord, type RemoveWorktreeOptions, ResearchSource, ResearcherDelegate, type SettledWorker, type SubmitInput, type SubmitOutput, type TraceContext, UiAuditorDelegate, type WorktreeHandle, captureWorktreeDiff, createCoordinationTools, createDelegateCodeHandler, createDelegateFeedbackHandler, createDelegateResearchHandler, createDelegateUiAuditHandler, createDelegationHistoryHandler, createDelegationStatusHandler, createInProcessExecutor, createInProcessTransport, createMcpServer, createPropagatingTraceEmitter, createWorktree, defaultChecks, detectExecutor, eventToSnapshot, hashIdempotencyInput, liftFindings, makeCheckRunner, readTraceContextFromEnv, removeWorktree, renderTrace, runCheck, runLocalHarness, traceContextToEnv, validateDelegateCodeArgs, validateDelegateFeedbackArgs, validateDelegateResearchArgs, validateDelegateUiAuditArgs, validateDelegationHistoryArgs, validateDelegationStatusArgs };