@tangle-network/agent-runtime 0.88.0 → 0.90.0

package/dist/loops.d.ts

@@ -2,26 +2,27 @@ import { ChatClient, RunRecord, HarnessType, AgentProfile, AnalystFinding, Analy
 export { AnalystFinding, DefaultVerdict, computeFindingId, makeFinding } from '@tangle-network/agent-eval';
 import { SandboxEvent, SandboxInstance, CreateSandboxOptions, PromptOptions, TaskOptions } from '@tangle-network/sandbox';
 export { AgentProfile, CreateSandboxOptions, SandboxEvent, SandboxInstance } from '@tangle-network/sandbox';
-import { d as ResultBlobStore, S as SpawnJournal, N as NodeId, j as SpawnEvent, E as ExecutorFactory, i as Scope, c as Agent, b as ExecutorRegistry, B as Budget, g as Settled, f as SupervisedResult, h as Spend, U as UsageEvent, k as Supervisor } from './types-Driepl87.js';
-export { A as AgentSpec, a as Executor, l as ExecutorContext, m as ExecutorResult, R as Runtime, n as SupervisorOpts, T as TreeView, W as WidenGate } from './types-Driepl87.js';
-import { ak as MakeWorkerAgent, A as AnalystRegistry, o as CoordinationTools, n as CoordinationEvent, ar as QuestionPolicy, a$ as ExecutorConfig } from './coordination-CuDLO8wj.js';
-export { b0 as BusEvent, b1 as BusRecord, b2 as BusStats, b3 as EventBus, b4 as ProviderSeam, b5 as PublishOptions, b6 as cliWorktreeExecutor, b7 as createEventBus, b8 as createExecutor, b9 as createExecutorRegistry } from './coordination-CuDLO8wj.js';
-import { R as RuntimeHooks, I as Iteration, S as SandboxClient, W as Driver, A as AgentRunSpec, b as OutputAdapter, V as Validator, E as ExecCtx, X as LoopWinner, Y as LoopLineageOptions, Z as LoopResult, L as LoopTokenUsage, a as RuntimeStreamEvent, _ as MountRecorder, i as AgentExecutionBackend, o as AgentTaskStatus, B as BackendErrorDetail } from './types-ESeMOj94.js';
-export { $ as LoopDecisionPayload, a0 as LoopEndedPayload, a1 as LoopIterationDispatchPayload, a2 as LoopIterationEndedPayload, a3 as LoopIterationStartedPayload, a4 as LoopPlanDescription, a5 as LoopPlanPayload, d as LoopSandboxPlacement, a6 as LoopStartedPayload, a7 as LoopTeardownFailedPayload, e as LoopTraceEmitter, c as LoopTraceEvent, a8 as MountManifestEntry, a9 as RunProvenance, aa as SelectionReceipt, ab as ValidationCtx } from './types-ESeMOj94.js';
+import { a as ResultBlobStore, f as SpawnJournal, N as NodeId, j as SpawnEvent, E as ExecutorFactory, A as Agent, B as Budget, S as Scope, h as Settled, b as SupervisedResult, i as Spend, U as UsageEvent, e as ExecutorRegistry, k as Supervisor } from './types-DAJQRIUD.js';
+export { d as AgentSpec, c as Executor, l as ExecutorContext, m as ExecutorResult, R as Runtime, n as SupervisorOpts, T as TreeView, W as WidenGate } from './types-DAJQRIUD.js';
+import { M as MakeWorkerAgent, A as AnalystRegistry, o as CoordinationTools, n as CoordinationEvent, as as QuestionPolicy, E as ExecutorConfig } from './coordination-DxHduZg7.js';
+export { bf as BusEvent, bg as BusRecord, bh as BusStats, bi as EventBus, bj as ProviderSeam, bk as PublishOptions, bl as cliWorktreeExecutor, bm as createEventBus, bn as createExecutor, bo as createExecutorRegistry } from './coordination-DxHduZg7.js';
+import { R as RuntimeHooks, I as Iteration, S as SandboxClient, D as Driver, A as AgentRunSpec, b as OutputAdapter, V as Validator, E as ExecCtx, X as LoopWinner, Y as LoopLineageOptions, Z as LoopResult, L as LoopTokenUsage, a as RuntimeStreamEvent, _ as MountRecorder, i as AgentExecutionBackend, o as AgentTaskStatus, B as BackendErrorDetail } from './types-Dnk189QA.js';
+export { $ as LoopDecisionPayload, a0 as LoopEndedPayload, a1 as LoopIterationDispatchPayload, a2 as LoopIterationEndedPayload, a3 as LoopIterationStartedPayload, a4 as LoopPlanDescription, a5 as LoopPlanPayload, d as LoopSandboxPlacement, a6 as LoopStartedPayload, a7 as LoopTeardownFailedPayload, e as LoopTraceEmitter, c as LoopTraceEvent, a8 as MountManifestEntry, a9 as RunProvenance, aa as SelectionReceipt, ab as ValidationCtx } from './types-Dnk189QA.js';
 import { RunProfileMatrixResult, Scenario, ProfileDispatchFn, JudgeConfig, RunProfileMatrixOptions, DispatchFn } from '@tangle-network/agent-eval/campaign';
 export { AgentEnvironmentProviderRef, AgentEnvironmentProviderRegistry, ProviderAsSandboxClientOptions, ProviderExecutorOptions, SandboxClientProviderOptions, createAgentEnvironmentProviderRegistry, providerAsExecutor, providerAsSandboxClient, resolveAgentEnvironmentProvider, sandboxClientAsProvider } from './environment-provider.js';
-import { C as CorpusRecord, c as Corpus, O as Outcome, S as ScopeAnalyzeInput, d as AssertTraceDerivedFindings, e as SteerContext, f as ScopeAnalyst, F as FanoutOptions, g as CombinatorShape, h as ScopeWidenGate, L as LoopUntilSpec, P as PanelSpec, i as PipelineStage, W as WinnerStrategy, j as FanoutWinnerSelector, V as VerifySpec, k as WidenSpec, l as CorpusFilter, R as RenderCorpusToInstructionsOptions, D as DefinePersonaInput, m as Persona, n as RunPersonifiedOptions, o as ShapeRegistry, p as LoopShape, E as EqualKArm, q as EqualKOnCostOptions, r as EqualKVerdict, T as TrajectoryReportOptions, s as TrajectoryReport } from './worktree-fanout-D6xR2CIA.js';
-export { A as AuthoredHarness, t as DefinePersona, u as EqualKOnCost, v as Fanout, w as FanoutSynthesis, x as FlatWidenGate, y as LoopUntil, z as LoopUntilState, B as Panel, G as PanelJudge, H as PanelVerdict, I as PatchDeliverableOptions, J as PersonaContext, K as PersonaExecutors, M as Pipeline, N as RenderCorpusToInstructions, Q as RunPersonified, U as ShapeBudget, X as ShapeContext, Y as TrajectoryNode, Z as TrajectoryReportFn, _ as Verify, $ as Widen, a0 as WidenDecision, a1 as WidenLineage, a2 as WorktreeCliExecutorOptions, a as WorktreeFanoutOptions, b as WorktreePatchArtifact, a3 as createWorktreeCliExecutor, a4 as patchDelivered, a5 as worktreeFanout } from './worktree-fanout-D6xR2CIA.js';
+import { C as CorpusRecord, c as Corpus, O as Outcome, S as ScopeAnalyzeInput, d as AssertTraceDerivedFindings, e as SteerContext, f as ScopeAnalyst, F as FanoutOptions, g as CombinatorShape, h as ScopeWidenGate, L as LoopUntilSpec, P as PanelSpec, i as PipelineStage, W as WinnerStrategy, j as FanoutWinnerSelector, V as VerifySpec, k as WidenSpec, l as CorpusFilter, R as RenderCorpusToInstructionsOptions, D as DefinePersonaInput, m as Persona, n as RunPersonifiedOptions, o as ShapeRegistry, p as LoopShape, E as EqualKArm, q as EqualKOnCostOptions, r as EqualKVerdict, T as TrajectoryReportOptions, s as TrajectoryReport } from './worktree-fanout-CfRXYmgV.js';
+export { A as AuthoredHarness, t as DefinePersona, u as EqualKOnCost, v as Fanout, w as FanoutSynthesis, x as FlatWidenGate, y as LoopUntil, z as LoopUntilState, B as Panel, G as PanelJudge, H as PanelVerdict, I as PatchDeliverableOptions, J as PersonaContext, K as PersonaExecutors, M as Pipeline, N as RenderCorpusToInstructions, Q as RunPersonified, U as ShapeBudget, X as ShapeContext, Y as TrajectoryNode, Z as TrajectoryReportFn, _ as Verify, $ as Widen, a0 as WidenDecision, a1 as WidenLineage, a2 as WorktreeCliExecutorOptions, a as WorktreeFanoutOptions, b as WorktreePatchArtifact, a3 as createWorktreeCliExecutor, a4 as patchDelivered, a5 as worktreeFanout } from './worktree-fanout-CfRXYmgV.js';
 import { b as AnalystRegistryLike } from './types-BC3bZpH0.js';
 import { AgentProfile as AgentProfile$1 } from '@tangle-network/agent-interface';
-import { R as RouterConfig, a as ToolLoopChat, b as ToolLoopCompactionOptions } from './router-client-r8y_VFVM.js';
-export { c as RouterChatResult, d as RouterChatToolsResult, e as RouterToolCall, f as RouterToolLoopResult, g as ToolLoopCompaction, T as ToolSpec, r as routerBrain, h as routerChatWithTools, i as routerChatWithUsage, j as routerToolLoop } from './router-client-r8y_VFVM.js';
-import { D as DeliverableSpec } from './worktree-harness-CX_McRLp.js';
-export { g as WorktreeCommandResult, h as gateOnDeliverable } from './worktree-harness-CX_McRLp.js';
+import { R as RouterConfig, T as ToolLoopChat, a as ToolLoopCompactionOptions } from './router-client-DJImUDlm.js';
+export { c as RouterChatResult, d as RouterChatToolsResult, e as RouterToolCall, f as RouterToolLoopResult, g as ToolLoopCompaction, b as ToolSpec, r as routerBrain, h as routerChatWithTools, i as routerChatWithUsage, j as routerToolLoop } from './router-client-DJImUDlm.js';
+import { D as DeliverableSpec } from './completion-gate-BDaBP8dd.js';
+export { g as WorktreeCommandResult, h as gateOnDeliverable } from './completion-gate-BDaBP8dd.js';
+import { S as SupervisorProfile } from './supervise-BpCdssu0.js';
+export { D as DriveHarness, a as SuperviseOptions, b as SupervisorAgentDeps, s as supervise, c as supervisorAgent, w as workerFromBackend } from './supervise-BpCdssu0.js';
 import { stuckLoopView, toolWasteView } from '@tangle-network/agent-eval/pipelines';
 export { AgentEnvironment, AgentEnvironmentCapabilities, AgentEnvironmentEvent, AgentEnvironmentProvider, AgentEnvironmentQuery, AgentEnvironmentStatus, AgentEnvironmentSummary, AgentProfileRef, AgentSession, AgentSessionRef, AgentSessionStatus, AgentTurnInput, AgentTurnResult, CheckpointRef, CheckpointRequest, CreateAgentEnvironmentInput, ExecRequest, ExecResult, ForkRequest, PlacementInfo, ResourceRequest, WorkspaceRequest } from '@tangle-network/agent-interface/environment-provider';
 import './substrate-DO2GHNg2.js';
-import './otel-export-BKmNwiCb.js';
 import './local-harness-sI0S_XNA.js';
 import 'node:child_process';
 
@@ -879,182 +880,6 @@ declare function inProcessSandboxClient(options: InProcessSandboxClientOptions):
  */
 declare function inlineSandboxClient(factory: ExecutorFactory<unknown>): SandboxClient;
 
-/**
- *
- * The loop-executor — a spawnable, budget-conserving, gated, STEERABLE multi-round loop
- * as a first-class atom, the sibling of the recursive driver-executor.
- *
- * A leaf worker runs one turn and settles. A driver child (driver-executor.ts) runs an
- * LLM brain that spawns children and reacts. A LOOP child is the third shape: a CODED loop
- * whose control flow is written, not left to a model's judgment. On `execute` it mounts a
- * NESTED `Scope` (via the same `nested-scope` seam the driver-executor uses) one `depth`
- * deeper over the SAME conserved pool + shared journal/blobs + open registry, then runs the
- * authored loop's `round(ctx)` up to `maxRounds` times. Each round may spawn children into
- * that nested scope (conserved budget, depth-bounded), and the runtime — not the authored
- * body — owns the three guarantees a "loop" must make:
- *
- *  - BOUNDED: at most `maxRounds` rounds; the run-wide conserved pool still fails a spawn
- *    closed at any depth, so a loop can never overspend the root ceiling.
- *  - GATED: the loop settles `valid` iff its deployable `check(out)` passes (the completion
- *    oracle, same discipline as `gateOnDeliverable`). A loop that exhausts `maxRounds`
- *    without the check ever passing settles `valid: false` — ran, did not deliver.
- *  - STEERABLE: the executor owns an `Inbox` and exposes `deliver`, so a supervisor's
- *    `steer_agent` (→ `Scope.send` → this `deliver`) lands between rounds. Queued messages
- *    fold into the next round's `ctx.steer`; a forceful `interrupt` aborts the in-flight
- *    round's linked signal so the loop re-plans immediately with the message folded in.
- *
- * Why this preserves every keystone invariant: identical to the driver-executor — the SCOPE
- * owns the sharing (nested scope over `args.pool`, one `SpawnJournal` tree per child), this
- * executor only runs the coded loop over what the scope mounts and rolls the sub-tree's
- * conserved spend up on settle. It builds NO new budget, journal, or selection logic.
- *
- * The authored loop body is `defineLoop(name, { maxRounds, round, check })`. `round` is
- * ordinary code — arbitrary composition inside a round (spawn one child, fan out many,
- * pipeline) — while the runtime owns iteration, the budget, the gate, and steer-folding.
- * So a loop is "codemode" (the author writes control flow) yet structurally bounded.
- *
- * @experimental
- */
-
-/** The runtime tag the registry maps a loop child to. */
-declare const loopRuntime: "loop";
-/** What one round of a loop receives. The scope is the NESTED scope — spawn conserved
- *  children here; budget/depth are enforced by the scope, not the body. */
-interface LoopRoundCtx {
-    /** The spawn task, verbatim. */
-    readonly task: unknown;
-    /** The nested, conserved scope. Spawn children with `scope.spawn`, react with `scope.next`. */
-    readonly scope: Scope<unknown>;
-    /** 1-based round index. */
-    readonly round: number;
-    /** The declared ceiling on rounds. */
-    readonly maxRounds: number;
-    /** Supervisor `steer_agent` messages that arrived since the last round, folded to text. */
-    readonly steer: readonly string[];
-    /** Conserved-pool readouts (post-reservation) for in-body budget-awareness. */
-    readonly budget: Scope<unknown>['budget'];
-    /** Abort signal: the spawn signal + nested-scope signal + a fresh per-round interrupt.
-     *  A forceful steer during the round aborts THIS signal so the body can break and re-plan. */
-    readonly signal: AbortSignal;
-}
-/** What a round returns. `out` is the running result; `done: true` stops the loop early
- *  (the author's own stop condition, distinct from the runtime's gate `check`). */
-interface LoopRoundResult {
-    readonly out: unknown;
-    readonly done?: boolean;
-}
-/** An authored coded loop: a name, a round ceiling, the round body, and an optional
- *  deployable gate `check`. `check` decides DELIVERED — the loop settles `valid` iff it
- *  passes — and is polled after each round to stop as soon as the loop has delivered. */
-interface LoopDef {
-    readonly name: string;
-    readonly maxRounds: number;
-    round(ctx: LoopRoundCtx): Promise<LoopRoundResult>;
-    /** The deployable completion oracle. `settled.valid ⟺ this resolves true`. A throwing
-     *  check is fail-closed (not delivered). Omit for a loop whose only stop is `done`. */
-    check?(out: unknown): boolean | Promise<boolean>;
-    /** What the loop was supposed to produce — surfaced in traces. */
-    readonly describe?: string;
-}
-/** One named agent in a MULTI-AGENT loop (the `agents` form of `defineLoop`). `run` does the
- *  agent's work for a round; `prior` is the previous agent's output, or `ctx.task` for the first.
- *  The last agent's return is the round's `out`. So a proposer→verifier loop is just two agents. */
-interface LoopAgent {
-    /** A short, human name for the agent this plays (proposer, verifier, engineer). */
-    readonly name: string;
-    run(ctx: LoopRoundCtx, prior: unknown): Promise<unknown>;
-}
-/**
- * Author a coded loop atom. The returned `LoopDef` is handed to `loopChild` to become a
- * spawnable `Agent`. The runtime owns `maxRounds`, the conserved budget, the gate, and
- * steer-folding; you supply ONE of two round shapes:
- *
- *  - `round` — freeform: write the whole round yourself (arbitrary code, may spawn children).
- *  - `agents` — declarative MULTI-AGENT: an ordered list of named agents piped each round
- *    (`task → agents[0] → agents[1] → … → out`). "How many agents" is self-evident from the
- *    list, so a two-agent research loop is `agents: [proposer, verifier]` — no bespoke function.
- *
- * Provide EXACTLY one of `round` / `agents`.
- */
-declare function defineLoop(name: string, spec: {
-    maxRounds: number;
-    round?: (ctx: LoopRoundCtx) => Promise<LoopRoundResult>;
-    agents?: readonly LoopAgent[];
-    check?: (out: unknown) => boolean | Promise<boolean>;
-    describe?: string;
-}): LoopDef;
-/**
- * Mark + carry an authored loop so the recursive registry resolves it to the
- * loop-executor. The returned agent is SPAWNED (never run directly): its `executorSpec` is
- * marked `role: 'loop'` and carries the `LoopDef` + the shared journal. `act` fails loud if
- * called directly — a loop child runs THROUGH its nested-scope executor, never as a root.
- */
-declare function loopChild<Out>(loop: LoopDef, journal: SpawnJournal): Agent<unknown, Out>;
-/**
- * Register the loop-executor so a child marked `role: 'loop'` resolves to it. Mirrors
- * `withDriverExecutor`: a loop-role spec → the loop-executor; everything else → the base
- * registry's resolution. Compose it WITH `withDriverExecutor` so loops and drivers coexist:
- * `withLoopExecutor(withDriverExecutor(base))`.
- */
-declare function withLoopExecutor(base: ExecutorRegistry): ExecutorRegistry;
-
-/**
- * authorLoop — the codemode layer over the loop atom: an LLM reads a goal + the defineLoop
- * contract and WRITES a coded loop as a module; the caller spawns it as a first-class atom
- * (`loopChild` → the loop-executor) and it settles gated on its own `check`, budget-conserved
- * and depth-bounded like any spawned child.
- *
- * This is to `defineLoop` what `authorStrategy` is to `defineStrategy`: the "supervisor writes
- * the loop" seam. The authored body composes real code (spawns children on the nested scope,
- * fans out, pipelines) while the runtime owns iteration, the conserved budget, the gate, and
- * steer-between-rounds — so an authored loop can be WRONG but cannot overspend the pool or
- * skip the completion check.
- *
- * Safety is structural, not a sandbox (mirrors `authorStrategy`): the same `assertStrategyContract`
- * lint bounds the module to the loops import and bans out-of-band compute (require/eval/fetch/
- * process/node builtins), and the authored module is written to `outDir` and dynamically imported
- * under a TS-capable loader (tsx) since models emit type annotations.
- */
-
-/** The compressed consumable a skill carries: everything an author needs to emit a loop atom. */
-declare const loopAuthorContract = "\nYou author a LOOP ATOM for an agent supervisor. A loop runs a bounded, multi-round journey\ntoward a deployable check; a supervisor spawns / observes / steers it exactly like a worker.\nYou write ONE round; the runtime owns the round ceiling, the conserved budget, the gate, and\nfolding a supervisor's steer into the next round. So write real control flow inside a round,\nbut never write the loop's stop condition as \"hope the model stops\" \u2014 that is the runtime's job.\n\nYou export ONE module of EXACTLY this shape (no other imports, no commentary outside the code):\n\nimport { defineLoop } from '@tangle-network/agent-runtime/loops'\nexport default defineLoop('your-loop-name', {\n  maxRounds: 3,\n  round: async ({ task, scope, round, maxRounds, steer, budget, signal }) => {\n    // arbitrary code for ONE round. Do real work by spawning children on the nested scope:\n    //   const w = scope.spawn(childAgent, subtask, { budget: perRound, label: `r${round}` })\n    //   if (!w.ok) throw new Error(w.reason)      // fail loud: budget-exhausted | depth-exceeded\n    //   const settled = await scope.next()        // conserved child work; settles gated\n    // 'steer' is the supervisor's messages since the last round (fold them into what you do next).\n    // 'signal' aborts if a forceful steer arrives mid-round \u2014 pass it to your awaited work.\n    return { out: /* the running result */ undefined, done: false }  // done:true stops early\n  },\n  check: (out) => /* the deployable completion oracle */ Boolean(out),\n})\n\nFor a MULTI-AGENT loop (a proposer then a verifier, a researcher then an engineer), do NOT\nhand-write the pipeline in 'round' \u2014 use 'agents' instead: an ordered list of named agents piped\neach round (task -> agents[0] -> agents[1] -> ... -> out). \"How many agents\" is then self-evident.\n\nimport { defineLoop } from '@tangle-network/agent-runtime/loops'\nexport default defineLoop('your-loop-name', {\n  maxRounds: 3,\n  agents: [\n    { name: 'proposer', run: async (ctx, prior) => { /* spawn a worker, produce a draft */ return draft } },\n    { name: 'verifier', run: async (ctx, prior) => { /* verify/refine the proposer's draft */ return checked } },\n  ],\n  check: (out) => Boolean(out),\n})\n\nProvide EXACTLY one of 'round' or 'agents'. The round context (for the 'round' form, and passed to\neach agent's run as its first arg):\n  task       the spawn task, verbatim.\n  scope      the NESTED conserved scope. scope.spawn(agent, task, { budget, label }) reserves\n             budget and fails closed; scope.next() awaits one child settlement. Budget NESTS \u2014\n             the pool reserves each spawn's full ceiling until it settles, so give children a\n             per-round budget smaller than the loop's own.\n  round      1-based round index. maxRounds is the declared ceiling.\n  steer      readonly string[] \u2014 supervisor steer_agent messages that arrived since last round.\n  budget     conserved-pool readouts (tokensLeft, usdLeft, deadlineMs) for in-body awareness.\n  signal     AbortSignal \u2014 the spawn signal + a fresh per-round interrupt; honor it in awaits.\n\nThe round result: { out: unknown; done?: boolean }. 'out' is the running result the gate reads;\n'done: true' is YOUR early stop (distinct from the runtime's gate 'check').\n\ncheck(out): boolean | Promise<boolean>. The DEPLOYABLE oracle \u2014 an executable test, a state\nverifier, a readiness score threshold \u2014 read off 'out', never the model judging itself. The loop\nsettles valid IFF check passes, and the runtime polls it after each round to stop the instant the\nloop has delivered. A loop that exhausts maxRounds without check passing settles valid:false.\n\nRules:\n- ALWAYS await every scope.spawn drain / async call \u2014 a floating rejection crashes the run.\n- Do real work by SPAWNING children; raw un-metered inference in the body is not budget-conserved.\n- Give 'check' a real oracle. A loop whose check is a self-judged score cannot be trusted.\n- The only import allowed is '@tangle-network/agent-runtime/loops'. No require/eval/fetch/process/\n  node builtins \u2014 the runtime meters and gates you; out-of-band compute breaks that.\n";
-interface AuthorLoopOptions {
-    /** The model-call seam (agent-eval `createChatClient`). */
-    chat: ChatClient;
-    model?: string;
-    /** A NAMED fallback author tried once when the primary call fails or returns no code block
-     *  (thinking models can time out at the edge on long authoring prompts, or return empty
-     *  content without `maxTokens`). Opt-in — absent means the primary's failure propagates. */
-    fallbackModel?: string;
-    /** The contract text shown to the author. Default `loopAuthorContract`. A skill/GEPA loop can
-     *  evolve this text and gate each variant on the same check as any loop. */
-    contract?: string;
-    /** What the loop must accomplish — the objective, in plain language (the author's orientation). */
-    goal: string;
-    /** Optional orienting context: the check's shape, the child agents available, prior findings —
-     *  never the check's internals (the author stays blind to the oracle, like `authorStrategy`). */
-    context?: string;
-    /** The round ceiling the loop must respect. */
-    maxRounds: number;
-    /** Where the authored module file is written (created if missing). */
-    outDir: string;
-    temperature?: number;
-    /** Completion cap — required by thinking-model authors that stream reasoning first. */
-    maxTokens?: number;
-    signal?: AbortSignal;
-}
-interface AuthoredLoop {
-    loop: LoopDef;
-    file: string;
-    code: string;
-}
-/**
- * Author + load a coded loop from a goal. Throws when the author emits no loadable module; with
- * `fallbackModel` set, the named fallback gets one attempt first. The returned `loop` is handed
- * to `loopChild(loop, journal)` and spawned as a first-class atom.
- */
-declare function authorLoop(opts: AuthorLoopOptions): Promise<AuthoredLoop>;
-
 /**
  *
  * `runLoop` — the topology-agnostic kernel built atop the sandbox SDK.
@@ -1317,11 +1142,24 @@ interface AgenticOptions {
      *  worker. Omitted ⇒ the worker's `model`. */
     analystModel?: string;
     /** Across-run learning: when set, the analyst's observe() pass appends trace-derived
-     *  facts here (the flywheel write side). Priming (the read side) is the caller's move —
-     *  query the corpus and fold facts into the task's systemPrompt before runAgentic. */
+     *  facts here (the flywheel write side). Read-back is opt-in via `corpusReadback`
+     *  because unconditional priming can pollute context on some domains. */
     corpus?: Corpus;
     /** Tags written onto learned facts (and used by the caller's priming query). */
     corpusTags?: string[];
+    /** In-context learning: when set, query `corpus` before each depth shot and inject
+     *  the top trace-derived facts as guidance for the active run. No corpus means no read-back. */
+    corpusReadback?: CorpusReadbackOptions;
+}
+interface CorpusReadbackOptions {
+    /** Minimum confidence for a fact to be injected. Default 0.7. */
+    minConfidence?: number;
+    /** Extra tags a fact must carry, in addition to `corpusTags`. */
+    tags?: ReadonlyArray<string>;
+    /** Max facts injected per shot. Default 3. */
+    maxFacts?: number;
+    /** Default false: only facts tagged `audience:agent` are injected into the worker. */
+    includeOperatorFacts?: boolean;
 }
 type Msg = Record<string, unknown>;
 interface ShotResult {
@@ -2608,6 +2446,14 @@ interface SandboxRun<Out> {
  * @experimental
  */
 type OpenSandboxRunPromptOptions = Omit<PromptOptions, 'signal' | 'sessionId'>;
+/** Context available after the box/session exists and before the first prompt is
+ * drained. Intended for benchmark-owned workspace setup such as cloning a repo
+ * into a fixed path. */
+interface OpenSandboxRunBeforeStartContext {
+    readonly box: SandboxInstance;
+    readonly sessionId: string;
+    readonly signal: AbortSignal;
+}
 /** @experimental */
 interface OpenSandboxRunOptions {
     /** Profile + sandbox env/overrides. `sandboxOverrides.backend.type` is the harness. */
@@ -2622,6 +2468,10 @@ interface OpenSandboxRunOptions {
     /** Per-prompt sandbox SDK options forwarded to both `start()` and `resume()`.
      *  The runtime still owns the session id and abort signal for each turn. */
     promptOptions?: OpenSandboxRunPromptOptions;
+    /** Optional pre-start workspace setup. Runs after `lineage.start()` creates the
+     * box/session and before the first prompt stream is consumed. A thrown error
+     * fails the turn before the agent spends tokens. */
+    beforeStart?: (ctx: OpenSandboxRunBeforeStartContext) => Promise<void> | void;
     /** Test seam for deterministic hook timestamps. Defaults to `Date.now`. */
     now?: () => number;
     /** Bounds box-creation bursts inside lineage fanout. Default from lineage. */
@@ -3568,6 +3418,10 @@ declare function serveCoordinationMcp(opts: {
     /** Hard cap on simultaneously-LIVE workers — `spawn_agent` fails closed once this many are in
      *  flight (a concurrency fence on top of the conserved-pool fence). Omit/`<= 0` = no cap. */
     maxLiveWorkers?: number;
+    /** Max wall-clock ms a single `await_event` may block before returning a re-pollable
+     *  `{ pending, live }` snapshot instead of erroring on the client's request timeout. Omit =
+     *  {@link DEFAULT_AWAIT_EVENT_TIMEOUT_MS}; `<= 0` = prior unbounded block (in-process only). */
+    awaitTimeoutMs?: number;
     port?: number;
     host?: string;
     /** Trace-analyst lenses the driver can run (`run_analyst`) or auto-fire on settle. */
@@ -3579,66 +3433,6 @@ declare function serveCoordinationMcp(opts: {
     questionPolicy?: QuestionPolicy;
 }): Promise<CoordinationMcpHandle>;
 
-/** The supervisor's profile — the subset of an `AgentProfile` that selects + shapes its brain.
- *  `harness` is the backend-as-data discriminant; `systemPrompt` is the standing instruction. */
-interface SupervisorProfile {
-    readonly name?: string;
-    /** null/undefined → router brain (in-process tool-loop); a coding-CLI harness → sandboxed brain. */
-    readonly harness?: string | null;
-    /** The router model when the brain is router-driven (falls back to the deps router config). */
-    readonly model?: string;
-    /** The standing instructions ("you delegate, you do not solve"). */
-    readonly systemPrompt?: string;
-}
-/** How to run a sandboxed harness as the DRIVER, with the coordination verbs mounted — the substrate
- *  seam the caller supplies (mirrors `makeWorkerAgent` for spawned children). It runs `profile` on
- *  `task` in its backend (sandbox / cli-bridge) with `coordinationMcpUrl` mounted as an MCP server,
- *  so the harness calls spawn_agent / await_event / stop as native tools over the live scope. */
-type DriveHarness = (args: {
-    readonly profile: SupervisorProfile;
-    readonly task: unknown;
-    readonly scope: Scope<unknown>;
-    readonly coordinationMcpUrl: string;
-}) => Promise<void>;
-interface SupervisorAgentDeps {
-    readonly blobs: ResultBlobStore;
-    /** Resolve a spawned worker `profile` to a leaf agent — the recursion seam (same for both arms). */
-    readonly makeWorkerAgent: MakeWorkerAgent;
-    /** Per-child budget reserved from the conserved pool on each spawn. */
-    readonly perWorker: Budget;
-    /** Hard cap on simultaneously-LIVE workers across both arms — `spawn_agent` fails closed once
-     *  this many are in flight (a concurrency fence on top of the conserved-pool fence; bounds live
-     *  boxes/sandboxes, not total work). Omit/`<= 0` = no cap. */
-    readonly maxLiveWorkers?: number;
-    /** Router substrate for a router-brained supervisor (`harness` null). The profile's model wins. */
-    readonly router?: RouterConfig;
-    /** Inject the brain directly (tests / advanced) instead of resolving `routerBrain` from the profile. */
-    readonly brain?: ToolLoopChat;
-    /** Required for a sandboxed-harness supervisor (`harness` set): runs the harness as the driver. */
-    readonly driveHarness?: DriveHarness;
-    /** WORK tools the supervisor may call DIRECTLY (router arm) — so it can do simple work ITSELF and
-     *  only delegate when it needs parallelism. Pair with `executeExtraTool`. */
-    readonly extraTools?: ReadonlyArray<{
-        readonly name: string;
-        readonly description?: string;
-        readonly parameters: Record<string, unknown>;
-    }>;
-    /** Runs an `extraTools` call; null/undefined falls through to the coordination dispatch. */
-    readonly executeExtraTool?: (name: string, args: Record<string, unknown>) => Promise<string | null | undefined>;
-    /** Analyst lenses available to the driver (both arms). Required for `analyzeOnSettle`. */
-    readonly analysts?: AnalystRegistry;
-    /** Analyst kinds run on each worker-settle → a `finding` the driver composes its next steer from
-     *  (the self-improving UP-leg). Unset/empty = status quo (no analyst feed). Requires `analysts`. */
-    readonly analyzeOnSettle?: ReadonlyArray<string>;
-    readonly maxTurns?: number;
-    /** Give the supervisor brain a chapter-lifecycle on its OWN context window (router arm only) — it
-     *  distills its coordination transcript to a compact progress note once it exceeds the threshold,
-     *  instead of re-billing the whole thing every turn. See `DriverAgentOptions.compaction`. */
-    readonly compaction?: ToolLoopCompactionOptions;
-}
-/** Build a supervisor `Agent` from its profile: the brain resolves from `profile.harness` (backend-as-data), the same resolution rule as every worker. */
-declare function supervisorAgent(profile: SupervisorProfile, deps: SupervisorAgentDeps): Agent<unknown, unknown>;
-
 /**
  *
  * `delegate` — the one generic delegation verb. You hand it an INTENT (what you want done) and it
@@ -3890,13 +3684,6 @@ interface InMemoryRunContextOptions {
      * leaf workers. Default `false`.
      */
     readonly withDriver?: boolean;
-    /**
-     * Wrap the executor registry with `withLoopExecutor` so a spawned child marked
-     * `role: 'loop'` resolves to the loop-executor (a coded, budget-conserving, gated,
-     * steerable multi-round loop over a nested `Scope` on the same pool). Composes with
-     * `withDriver` so loops and drivers coexist. Default `false`.
-     */
-    readonly withLoop?: boolean;
 }
 /**
  * The bundle of stores a supervised run needs, shaped to spread into `SupervisorOpts`.
@@ -3986,71 +3773,6 @@ declare function createScope<Out>(args: ScopeArgs): Scope<Out>;
  */
 declare function settledToIteration<Out>(settled: Settled<Out>): Iteration<unknown, Out>;
 
-/** Build the worker seam from a backend (WHERE workers run) + an optional completion oracle (the
- *  deliverable check that makes "settled ⟺ delivered" true — the guard against "ran but didn't
- *  deliver"). The ONE place a backend becomes a spawnable worker. */
-declare function workerFromBackend(backend: ExecutorConfig, deliverable?: DeliverableSpec<unknown>): MakeWorkerAgent;
-interface SuperviseOptions {
-    /** The conserved compute pool for the whole run. */
-    readonly budget: Budget;
-    /** WHERE workers run — derives the worker seam. Provide this OR an explicit `makeWorkerAgent`. */
-    readonly backend?: ExecutorConfig;
-    /** The completion oracle for backend-derived workers (settled ⟺ delivered). Strongly recommended:
-     *  without it the supervisor trusts a worker's self-report — exactly the "ran but didn't deliver"
-     *  failure mode of a static orchestrator. */
-    readonly deliverable?: DeliverableSpec<unknown>;
-    /** Override the worker seam directly (tests / advanced) instead of deriving it from `backend`. */
-    readonly makeWorkerAgent?: MakeWorkerAgent;
-    /** The supervisor's router substrate (`harness` null). The profile's model wins. */
-    readonly router?: RouterConfig;
-    /** Inject the supervisor brain directly (tests / advanced). */
-    readonly brain?: ToolLoopChat;
-    /** Run a sandboxed-harness supervisor (`harness` set). */
-    readonly driveHarness?: DriveHarness;
-    /** WORK tools the supervisor may call DIRECTLY — so a recursive atom can ACT (do simple work
-     *  itself) OR SPAWN (delegate when it needs parallelism), not be a pure manager. Pair with
-     *  `executeExtraTool`. Router arm only (`harness` null). */
-    readonly extraTools?: ReadonlyArray<{
-        readonly name: string;
-        readonly description?: string;
-        readonly parameters: Record<string, unknown>;
-    }>;
-    /** Runs an `extraTools` call; null/undefined falls through to the coordination dispatch. */
-    readonly executeExtraTool?: (name: string, args: Record<string, unknown>) => Promise<string | null | undefined>;
-    /** Per-child budget reserved on each spawn. Defaults to a quarter of the pool's tokens. */
-    readonly perWorker?: Budget;
-    /** Hard cap on simultaneously-LIVE workers — `spawn_agent` fails closed once this many are in
-     *  flight. The conserved pool bounds TOTAL work; this bounds SIMULTANEOUS work (live boxes/
-     *  sandboxes a real fleet runs at once). Omit/`<= 0` = no cap (the pool stays the only fence). */
-    readonly maxLiveWorkers?: number;
-    /** Analyst lenses available to the driver. Required for `analyzeOnSettle`. Unset → status quo
-     *  (the driver receives settled worker outputs, no analyst findings). */
-    readonly analysts?: AnalystRegistry;
-    /** Analyst kind ids run AUTOMATICALLY when a worker settles `done` — each re-enters as a `finding`
-     *  the driver pulls (`await_event`) and composes its next steer from. The self-improving UP-leg,
-     *  threaded to the driver at this level (propagate to sub-drivers via a recursive `makeWorkerAgent`).
-     *  Omit/empty = status quo (no analyst feed). Requires `analysts`. */
-    readonly analyzeOnSettle?: ReadonlyArray<string>;
-    /** Worker output store. Defaults to in-memory. */
-    readonly blobs?: ResultBlobStore;
-    readonly maxDepth?: number;
-    readonly maxTurns?: number;
-    /** Give the supervisor brain a chapter-lifecycle on its OWN context window (router arm only): once
-     *  its coordination transcript exceeds `thresholdTokens` it distills to a compact progress note and
-     *  continues, instead of re-billing the whole transcript every turn (the cost that makes the LLM-brain
-     *  front door lose to a dumb-Ralph respawn). The live `Scope` roster is the durable state across
-     *  chapters. Default off. `distill` defaults to a brain self-summary + the settled-worker roster. */
-    readonly compaction?: ToolLoopCompactionOptions;
-    readonly runId?: string;
-    readonly now?: () => number;
-    /** Restrict the run to this subset of models. When set, every configured model — the
-     *  supervisor router model, the profile's model, and the backend's model — must be a member,
-     *  or `supervise()` throws a `ConfigError` before any compute is spent. Unset = unrestricted. */
-    readonly allowedModels?: readonly string[];
-}
-/** One-call supervisor: build + run a supervisor from its profile with sensible defaults; the raw `supervisorAgent` + `createSupervisor().run` seams stay available for power use. */
-declare function supervise(profile: SupervisorProfile, task: unknown, opts: SuperviseOptions): Promise<SupervisedResult<unknown>>;
-
 /**
  *
  * The `Supervisor` impl (KEYSTONE, build step 5).
@@ -4272,4 +3994,4 @@ declare function runInWorkspace<T>(ws: Workspace, body: (cwd: string) => Promise
     commitOnInvalid?: boolean;
 }): Promise<WorkspaceRun<T>>;
 
-export { Agent, AgentRunSpec, type AgentTurnBackend, type AgentTurnUsage, type AgenticOptions, type AgenticRunResult, type AgenticSurface, type AgenticTask, type AgenticTool, AnalystRegistry, type AnytimeReport, type AnytimeStrategySummary, type AnytimeTaskCurve, type ApplyContinuation, type ArtifactHandle, AssertTraceDerivedFindings, type AuditIntentInput, type AuditIntentOptions, type AuthorLoopOptions, type AuthorStrategyOptions, type AuthoredLoop, type AuthoredProfile, type AuthoredStrategy, type BenchmarkCell, type BenchmarkConfig, type BenchmarkLift, type BenchmarkReport, type BenchmarkStrategySummary, type BenchmarkTaskRow, Budget, type BudgetPool, type BudgetReadout, type ChampionPick, type ChampionPolicy, type CheckpointCapableBox, type CollectedAgentTurn, CombinatorShape, type CompletionAnalyst, type CompletionEvidence, type CompletionPolicy, type CompletionVerdict, CoordinationEvent, type CoordinationMcpHandle, Corpus, CorpusFilter, CorpusRecord, type CreateScopeAnalystOptions, type CriuCapableClient, DefinePersonaInput, type DefinedLeaderboard, type DelegateOptions, type Deliverable, DeliverableSpec, type DriveHarness, Driver, type DriverAgentOptions, type DumbDriverOptions, type Environment, EqualKArm, EqualKOnCostOptions, EqualKVerdict, type EvolutionArchiveNode, type EvolutionAuthor, type EvolutionBandInfo, type EvolutionCandidate, type EvolutionGeneration, type EvolutionReport, ExecCtx, ExecutorConfig, ExecutorFactory, ExecutorRegistry, FanoutOptions, FanoutWinnerSelector, FileCorpus, type ForkCapableBox, type GitWorkspaceOptions, type HarvestCorpusOptions, type HarvestFailure, type HarvestReport, InMemoryCorpus, InMemoryResultBlobStore, type InMemoryRunContext, type InMemoryRunContextOptions, InMemorySpawnJournal, type InProcessOnPrompt, type InProcessPromptCtx, type InProcessSandboxClientOptions, type Inbox, type InboxMessage, type IntentAudit, type Interval, Iteration, type Leaderboard, type LeaderboardBenchScore, type LeaderboardBenchTask, type LeaderboardBenchmarkAdapter, type LeaderboardFlagSpec, type LeaderboardIterationInfo, type LeaderboardOptions, type LeaderboardRow, type LeaderboardRunContext, type LeaderboardScenario, type LeaderboardScore, type LeaderboardSpec, type LoopAgent, type LoopCampaignDispatchOptions, type LoopDef, type LoopDispatchOptions, LoopLineageOptions, type LoopOptionsForDispatch, LoopResult, type LoopRoundCtx, type LoopRoundResult, LoopShape, LoopTokenUsage, LoopUntilSpec, LoopWinner, MakeWorkerAgent, type McpEndpoint, type McpEnvironmentOptions, MountRecorder, type NaiveDriverOptions, type Observation, type ObserveInput, type ObserveOptions, type OpenSandboxRunOptions, type OpenSandboxRunPromptOptions, Outcome, OutputAdapter, type PairwiseOptions, type PairwiseVerdict, PanelSpec, Persona, PipelineStage, type ProfileRichness, type ProfileRichnessThresholds, type PromotionGateOptions, type PromotionVerdict, type RegistryAnalyzeProjection, RenderCorpusToInstructionsOptions, type ReservationTicket, type ResolveSandboxClientOptions, ResultBlobStore, RouterConfig, type RunAgenticOptions, RunPersonifiedOptions, type SandboxCapabilities, SandboxClient, type SandboxLineage, type SandboxLineageHandle, type SandboxRun, SandboxRunAbortError, type SandboxToolPartState, Scope, ScopeAnalyst, ScopeAnalyzeInput, ScopeWidenGate, type SessionCapableBox, type SessionTraceBox, Settled, ShapeRegistry, type Shell, type ShotPersona, type ShotSpec, Spend, SteerContext, type SteeringDecision, type Strategy, type StrategyCtx, type StrategyEvolutionConfig, type StrategyResult, type StreamAgentTurnOptions, type SuperviseOptions, type SuperviseSurfaceOptions, type SuperviseSurfaceResult, SupervisedResult, Supervisor, type SupervisorAgentDeps, type SupervisorProfile, type SurfaceScore, type SurfaceWorkerConfig, type SurfaceWorkerOut, ToolLoopChat, ToolLoopCompactionOptions, type TraceSource, type TrajectoryAnalysis, TrajectoryReport, TrajectoryReportOptions, type TurnResult, UsageEvent, type UsageSink, Validator, type VerifierEnvironmentOptions, VerifySpec, type WatchTraceOptions, type WaterfallCollector, type WaterfallReport, type WaterfallSpan, WidenSpec, WinnerStrategy, type Workspace, type WorkspaceCommit, type WorkspaceRun, acquireSandbox, adaptiveRefine, analyzeTrace, anytimeReport, asAuthoredProfile, assertModelAllowed, assertStrategyContract, assertTraceDerivedFindings, assessAuthoredProfile, auditIntent, authorLoop, authorStrategy, authoredWorker, breadthStrategy, buildSteerContext, builtinShapes, collectAgentTurn, completionAuthorizes, contentAddress, createBudgetPool, createInMemoryRunContext, createInbox, createMcpEnvironment, createPushTraceSource, createSandboxLineage, createSandboxToolPartState, createScope, createScopeAnalyst, createShapeRegistry, createSupervisor, createVerifierEnvironment, createWaterfallCollector, decodeToolPart, defaultAnalystInstruction, defaultAuditorInstruction, defaultDelegateBudget, defaultProfileRichnessThresholds, defaultSelectWinner, defaultToolDetectors, defineLeaderboard, defineLoop, definePersona, defineStrategy, delegate, depthStrategy, deterministicCompletion, discriminatingMeans, driverAgent, dumbDriver, equalKOnCost, extractLlmCallEvent, failuresAnalyst, fanout, finalizeBestDelivered, flatWidenGate, gitWorkspace, harvestCorpus, inProcessSandboxClient, inlineSandboxClient, jjWorkspace, leaderboard, localShell, loopAuthorContract, loopCampaignDispatch, loopChild, loopDispatch, loopRuntime, loopUntil, mapSandboxEvent, mapSandboxToolEvent, naiveDriver, observe, openSandboxRun, pairwiseSignificance, panel, pickChampion, pipeline, printBenchmarkReport, probeSandboxCapabilities, profileRichnessFinding, promotionGate, refine, registerShape, registryScopeAnalyst, renderAnytimeTable, renderCorpusToInstructions, renderLeaderboardHtml, renderLeaderboardMarkdown, renderLeaderboardSvg, renderPairwiseMarkdown, renderReport, reportLoopUsage, resolveSandboxClient, runAgentic, runBenchmark, runInWorkspace, runLoop, runPersonified, runStrategyEvolution, sample, sampleThenRefine, sandboxSessionTraceSource, selectChampion, selectValidWinner, sentinelCompletion, serveCoordinationMcp, settledToIteration, spendFromUsageEvents, stopSentinel, strategyAuthorContract, streamAgentTurn, sumSandboxUsage, supervise, superviseSurface, supervisorAgent, supervisorInstructions, trajectoryReport, verify, watchTrace, widen, withLoopExecutor, workerFromBackend };
+export { Agent, AgentRunSpec, type AgentTurnBackend, type AgentTurnUsage, type AgenticOptions, type AgenticRunResult, type AgenticSurface, type AgenticTask, type AgenticTool, AnalystRegistry, type AnytimeReport, type AnytimeStrategySummary, type AnytimeTaskCurve, type ApplyContinuation, type ArtifactHandle, AssertTraceDerivedFindings, type AuditIntentInput, type AuditIntentOptions, type AuthorStrategyOptions, type AuthoredProfile, type AuthoredStrategy, type BenchmarkCell, type BenchmarkConfig, type BenchmarkLift, type BenchmarkReport, type BenchmarkStrategySummary, type BenchmarkTaskRow, Budget, type BudgetPool, type BudgetReadout, type ChampionPick, type ChampionPolicy, type CheckpointCapableBox, type CollectedAgentTurn, CombinatorShape, type CompletionAnalyst, type CompletionEvidence, type CompletionPolicy, type CompletionVerdict, CoordinationEvent, type CoordinationMcpHandle, Corpus, CorpusFilter, type CorpusReadbackOptions, CorpusRecord, type CreateScopeAnalystOptions, type CriuCapableClient, DefinePersonaInput, type DefinedLeaderboard, type DelegateOptions, type Deliverable, DeliverableSpec, Driver, type DriverAgentOptions, type DumbDriverOptions, type Environment, EqualKArm, EqualKOnCostOptions, EqualKVerdict, type EvolutionArchiveNode, type EvolutionAuthor, type EvolutionBandInfo, type EvolutionCandidate, type EvolutionGeneration, type EvolutionReport, ExecCtx, ExecutorConfig, ExecutorFactory, ExecutorRegistry, FanoutOptions, FanoutWinnerSelector, FileCorpus, type ForkCapableBox, type GitWorkspaceOptions, type HarvestCorpusOptions, type HarvestFailure, type HarvestReport, InMemoryCorpus, InMemoryResultBlobStore, type InMemoryRunContext, type InMemoryRunContextOptions, InMemorySpawnJournal, type InProcessOnPrompt, type InProcessPromptCtx, type InProcessSandboxClientOptions, type Inbox, type InboxMessage, type IntentAudit, type Interval, Iteration, type Leaderboard, type LeaderboardBenchScore, type LeaderboardBenchTask, type LeaderboardBenchmarkAdapter, type LeaderboardFlagSpec, type LeaderboardIterationInfo, type LeaderboardOptions, type LeaderboardRow, type LeaderboardRunContext, type LeaderboardScenario, type LeaderboardScore, type LeaderboardSpec, type LoopCampaignDispatchOptions, type LoopDispatchOptions, LoopLineageOptions, type LoopOptionsForDispatch, LoopResult, LoopShape, LoopTokenUsage, LoopUntilSpec, LoopWinner, MakeWorkerAgent, type McpEndpoint, type McpEnvironmentOptions, MountRecorder, type NaiveDriverOptions, type Observation, type ObserveInput, type ObserveOptions, type OpenSandboxRunBeforeStartContext, type OpenSandboxRunOptions, type OpenSandboxRunPromptOptions, Outcome, OutputAdapter, type PairwiseOptions, type PairwiseVerdict, PanelSpec, Persona, PipelineStage, type ProfileRichness, type ProfileRichnessThresholds, type PromotionGateOptions, type PromotionVerdict, type RegistryAnalyzeProjection, RenderCorpusToInstructionsOptions, type ReservationTicket, type ResolveSandboxClientOptions, ResultBlobStore, RouterConfig, type RunAgenticOptions, RunPersonifiedOptions, type SandboxCapabilities, SandboxClient, type SandboxLineage, type SandboxLineageHandle, type SandboxRun, SandboxRunAbortError, type SandboxToolPartState, Scope, ScopeAnalyst, ScopeAnalyzeInput, ScopeWidenGate, type SessionCapableBox, type SessionTraceBox, Settled, ShapeRegistry, type Shell, type ShotPersona, type ShotSpec, Spend, SteerContext, type SteeringDecision, type Strategy, type StrategyCtx, type StrategyEvolutionConfig, type StrategyResult, type StreamAgentTurnOptions, type SuperviseSurfaceOptions, type SuperviseSurfaceResult, SupervisedResult, Supervisor, SupervisorProfile, type SurfaceScore, type SurfaceWorkerConfig, type SurfaceWorkerOut, ToolLoopChat, ToolLoopCompactionOptions, type TraceSource, type TrajectoryAnalysis, TrajectoryReport, TrajectoryReportOptions, type TurnResult, UsageEvent, type UsageSink, Validator, type VerifierEnvironmentOptions, VerifySpec, type WatchTraceOptions, type WaterfallCollector, type WaterfallReport, type WaterfallSpan, WidenSpec, WinnerStrategy, type Workspace, type WorkspaceCommit, type WorkspaceRun, acquireSandbox, adaptiveRefine, analyzeTrace, anytimeReport, asAuthoredProfile, assertModelAllowed, assertStrategyContract, assertTraceDerivedFindings, assessAuthoredProfile, auditIntent, authorStrategy, authoredWorker, breadthStrategy, buildSteerContext, builtinShapes, collectAgentTurn, completionAuthorizes, contentAddress, createBudgetPool, createInMemoryRunContext, createInbox, createMcpEnvironment, createPushTraceSource, createSandboxLineage, createSandboxToolPartState, createScope, createScopeAnalyst, createShapeRegistry, createSupervisor, createVerifierEnvironment, createWaterfallCollector, decodeToolPart, defaultAnalystInstruction, defaultAuditorInstruction, defaultDelegateBudget, defaultProfileRichnessThresholds, defaultSelectWinner, defaultToolDetectors, defineLeaderboard, definePersona, defineStrategy, delegate, depthStrategy, deterministicCompletion, discriminatingMeans, driverAgent, dumbDriver, equalKOnCost, extractLlmCallEvent, failuresAnalyst, fanout, finalizeBestDelivered, flatWidenGate, gitWorkspace, harvestCorpus, inProcessSandboxClient, inlineSandboxClient, jjWorkspace, leaderboard, localShell, loopCampaignDispatch, loopDispatch, loopUntil, mapSandboxEvent, mapSandboxToolEvent, naiveDriver, observe, openSandboxRun, pairwiseSignificance, panel, pickChampion, pipeline, printBenchmarkReport, probeSandboxCapabilities, profileRichnessFinding, promotionGate, refine, registerShape, registryScopeAnalyst, renderAnytimeTable, renderCorpusToInstructions, renderLeaderboardHtml, renderLeaderboardMarkdown, renderLeaderboardSvg, renderPairwiseMarkdown, renderReport, reportLoopUsage, resolveSandboxClient, runAgentic, runBenchmark, runInWorkspace, runLoop, runPersonified, runStrategyEvolution, sample, sampleThenRefine, sandboxSessionTraceSource, selectChampion, selectValidWinner, sentinelCompletion, serveCoordinationMcp, settledToIteration, spendFromUsageEvents, stopSentinel, strategyAuthorContract, streamAgentTurn, sumSandboxUsage, superviseSurface, supervisorInstructions, trajectoryReport, verify, watchTrace, widen };

package/dist/loops.js

@@ -8,7 +8,6 @@ import {
   assertStrategyContract,
   assertTraceDerivedFindings,
   auditIntent,
-  authorLoop,
   authorStrategy,
   breadthStrategy,
   buildSteerContext,
@@ -44,7 +43,6 @@ import {
   jjWorkspace,
   leaderboard,
   localShell,
-  loopAuthorContract,
   loopCampaignDispatch,
   loopDispatch,
   loopUntil,
@@ -91,7 +89,7 @@ import {
   watchTrace,
   widen,
   worktreeFanout
-} from "./chunk-22HPUH77.js";
+} from "./chunk-4IBAMGBE.js";
 import {
   InMemoryResultBlobStore,
   InMemorySpawnJournal,
@@ -115,13 +113,10 @@ import {
   defaultDelegateBudget,
   defaultProfileRichnessThresholds,
   defaultSelectWinner,
-  defineLoop,
   delegate,
   driverAgent,
   finalizeBestDelivered,
   gateOnDeliverable,
-  loopChild,
-  loopRuntime,
   probeSandboxCapabilities,
   profileRichnessFinding,
   routerBrain,
@@ -135,9 +130,9 @@ import {
   supervise,
   supervisorAgent,
   supervisorInstructions,
-  withLoopExecutor,
   workerFromBackend
-} from "./chunk-LRNRPJAV.js";
+} from "./chunk-QSNSMJSZ.js";
+import "./chunk-DPEUKJRO.js";
 import "./chunk-UD4BHQMI.js";
 import {
   createAgentEnvironmentProviderRegistry,
@@ -155,7 +150,6 @@ import {
 } from "./chunk-FVJ7M3DA.js";
 import "./chunk-7LO5GMAO.js";
 import "./chunk-YEJR7IXO.js";
-import "./chunk-DPEUKJRO.js";
 import "./chunk-DGUM43GV.js";
 export {
   FileCorpus,
@@ -173,7 +167,6 @@ export {
   assertTraceDerivedFindings,
   assessAuthoredProfile,
   auditIntent,
-  authorLoop,
   authorStrategy,
   authoredWorker,
   breadthStrategy,
@@ -210,7 +203,6 @@ export {
   defaultSelectWinner,
   defaultToolDetectors,
   defineLeaderboard,
-  defineLoop,
   definePersona,
   defineStrategy,
   delegate,
@@ -233,11 +225,8 @@ export {
   jjWorkspace,
   leaderboard,
   localShell,
-  loopAuthorContract,
   loopCampaignDispatch,
-  loopChild,
   loopDispatch,
-  loopRuntime,
   loopUntil,
   makeFinding,
   mapSandboxEvent,
@@ -301,7 +290,6 @@ export {
   verify,
   watchTrace,
   widen,
-  withLoopExecutor,
   workerFromBackend,
   worktreeFanout
 };

package/dist/mcp/bin.js

@@ -9,13 +9,13 @@ import {
   DelegationTaskQueue,
   FileDelegationStore,
   createMcpServer
-} from "../chunk-LRNRPJAV.js";
+} from "../chunk-QSNSMJSZ.js";
+import "../chunk-DPEUKJRO.js";
 import "../chunk-UD4BHQMI.js";
 import "../chunk-BZF3KQ6G.js";
 import "../chunk-FVJ7M3DA.js";
 import "../chunk-7LO5GMAO.js";
 import "../chunk-YEJR7IXO.js";
-import "../chunk-DPEUKJRO.js";
 import "../chunk-DGUM43GV.js";
 
 // src/mcp/delegate-supervisor-provisioning.ts

package/dist/mcp/index.d.ts

@@ -1,19 +1,18 @@
-import { S as SandboxClient, d as LoopSandboxPlacement } from '../types-ESeMOj94.js';
-import { F as FleetHandle, D as DelegationExecutor, a as DelegationTaskQueue, b as FeedbackStore, c as DelegateFeedbackResult, d as DelegateFeedbackArgs, U as UiAuditorDelegate, e as DelegateUiAuditArgs, f as DelegateUiAuditResult, g as DelegationHistoryResult, h as DelegationHistoryArgs, i as DelegationStatusResult, j as DelegationStatusArgs } from '../coordination-CuDLO8wj.js';
-export { A as AnalystRegistry, C as CappedDelegationTrace, k as CoderDelegate, l as CoderReview, m as CoderReviewer, n as CoordinationEvent, o as CoordinationTools, p as CoordinationToolsOptions, q as DELEGATE_DESCRIPTION, r as DELEGATE_INPUT_SCHEMA, s as DELEGATE_TOOL_NAME, t as DELEGATION_TRACE_MAX_BYTES, u as DELEGATION_TRACE_MAX_SPANS, v as DelegateArgs, w as DelegateCodeArgs, x as DelegateCodeConfig, y as DelegateCodeResult, z as DelegateHandlerOptions, B as DelegateResearchArgs, E as DelegateResearchConfig, G as DelegateResearchResult, H as DelegateResult, I as DelegateRunCtx, J as DelegateUiAuditConfig, K as DelegateUiAuditRoute, L as DelegationError, M as DelegationFeedbackSnapshot, N as DelegationHistoryEntry, O as DelegationPersistenceError, P as DelegationProfile, Q as DelegationProgress, R as DelegationRecord, S as DelegationResultPayload, T as DelegationResumeContext, V as DelegationResumeDriver, W as DelegationResumeTick, X as DelegationRunContext, Y as DelegationStateCorruptError, Z as DelegationStatus, _ as DelegationStore, $ as DelegationTaskQueueOptions, a0 as DelegationTraceCaps, a1 as DelegationTraceCollector, a2 as DelegationTraceSpan, a3 as DetachedSessionDelegateOptions, a4 as DetachedSessionRefParts, a5 as DetachedTurn, a6 as DetachedTurnResumeDriverOptions, a7 as DetachedWinnerSelection, a8 as DriveTurnCapableBox, a9 as DriveTurnTick, aa as FeedbackEvent, ab as FeedbackRating, ac as FeedbackRefersTo, ad as FileDelegationStore, ae as FileDelegationStoreOptions, af as FleetWorkspaceExecutorOptions, ag as InMemoryDelegationStore, ah as InMemoryFeedbackStore, ai as JsonRpcMessage, aj as JsonRpcResponse, ak as MakeWorkerAgent, al as McpServer, am as McpServerOptions, an as McpToolDescriptor, ao as McpTransport, ap as Question, aq as QuestionDecision, ar as QuestionPolicy, as as QuestionRecord, at as ResearchOutputShape, au as ResearchSource, av as RunDetachedTurnOptions, aw as SettleDetachedCoderTurnOptions, ax as SettledWorker, ay as SiblingSandboxExecutorOptions, az as SubmitInput, aA as SubmitOutput, aB as TraceContext, aC as UiAuditorDelegationOutput, aD as buildDelegationTraceSpans, aE as capDelegationTrace, aF as coderTaskFromArgs, aG as composeLoopTraceEmitters, aH as createCoordinationTools, aI as createDelegateHandler, aJ as createDelegationTraceCollector, aK as createDetachedTurnResumeDriver, aL as createFleetWorkspaceExecutor, aM as createInProcessTransport, aN as createMcpServer, aO as createPropagatingTraceEmitter, aP as createSiblingSandboxExecutor, aQ as detachedSessionDelegate, aR as detachedTurnEvents, aS as eventToSnapshot, aT as formatDetachedSessionRef, aU as hashIdempotencyInput, aV as parseDetachedSessionRef, aW as readTraceContextFromEnv, aX as runDetachedTurn, aY as settleDetachedCoderTurn, aZ as traceContextToEnv, a_ as validateDelegateArgs } from '../coordination-CuDLO8wj.js';
+import { S as SandboxClient, d as LoopSandboxPlacement } from '../types-Dnk189QA.js';
+import { F as FleetHandle, D as DelegationExecutor, a as DelegationTaskQueue, b as FeedbackStore, c as DelegateFeedbackResult, d as DelegateFeedbackArgs, U as UiAuditorDelegate, e as DelegateUiAuditArgs, f as DelegateUiAuditResult, g as DelegationHistoryResult, h as DelegationHistoryArgs, i as DelegationStatusResult, j as DelegationStatusArgs } from '../coordination-DxHduZg7.js';
+export { A as AnalystRegistry, C as CappedDelegationTrace, k as CoderDelegate, l as CoderReview, m as CoderReviewer, n as CoordinationEvent, o as CoordinationTools, p as CoordinationToolsOptions, q as DELEGATE_DESCRIPTION, r as DELEGATE_INPUT_SCHEMA, s as DELEGATE_TOOL_NAME, t as DELEGATION_TRACE_MAX_BYTES, u as DELEGATION_TRACE_MAX_SPANS, v as DelegateArgs, w as DelegateCodeArgs, x as DelegateCodeConfig, y as DelegateCodeResult, z as DelegateHandlerOptions, B as DelegateResearchArgs, G as DelegateResearchConfig, H as DelegateResearchResult, I as DelegateResult, J as DelegateRunCtx, K as DelegateUiAuditConfig, L as DelegateUiAuditRoute, N as DelegationError, O as DelegationFeedbackSnapshot, P as DelegationHistoryEntry, Q as DelegationPersistenceError, R as DelegationProfile, S as DelegationProgress, T as DelegationRecord, V as DelegationResultPayload, W as DelegationResumeContext, X as DelegationResumeDriver, Y as DelegationResumeTick, Z as DelegationRunContext, _ as DelegationStateCorruptError, $ as DelegationStatus, a0 as DelegationStore, a1 as DelegationTaskQueueOptions, a2 as DelegationTraceCaps, a3 as DelegationTraceCollector, a4 as DelegationTraceSpan, a5 as DetachedSessionDelegateOptions, a6 as DetachedSessionRefParts, a7 as DetachedTurn, a8 as DetachedTurnResumeDriverOptions, a9 as DetachedWinnerSelection, aa as DriveTurnCapableBox, ab as DriveTurnTick, ac as FeedbackEvent, ad as FeedbackRating, ae as FeedbackRefersTo, af as FileDelegationStore, ag as FileDelegationStoreOptions, ah as FleetWorkspaceExecutorOptions, ai as InMemoryDelegationStore, aj as InMemoryFeedbackStore, ak as JsonRpcMessage, al as JsonRpcResponse, M as MakeWorkerAgent, am as McpServer, an as McpServerOptions, ao as McpToolDescriptor, ap as McpTransport, aq as Question, ar as QuestionDecision, as as QuestionPolicy, at as QuestionRecord, au as ResearchOutputShape, av as ResearchSource, aw as RunDetachedTurnOptions, ax as SettleDetachedCoderTurnOptions, ay as SettledWorker, az as SiblingSandboxExecutorOptions, aA as SubmitInput, aB as SubmitOutput, aC as TraceContext, aD as UiAuditorDelegationOutput, aE as buildDelegationTraceSpans, aF as capDelegationTrace, aG as coderTaskFromArgs, aH as composeLoopTraceEmitters, aI as createCoordinationTools, aJ as createDelegateHandler, aK as createDelegationTraceCollector, aL as createDetachedTurnResumeDriver, aM as createFleetWorkspaceExecutor, aN as createInProcessTransport, aO as createMcpServer, aP as createPropagatingTraceEmitter, aQ as createSiblingSandboxExecutor, aR as detachedSessionDelegate, aS as detachedTurnEvents, aT as eventToSnapshot, aU as formatDetachedSessionRef, aV as hashIdempotencyInput, aW as parseDetachedSessionRef, aX as readTraceContextFromEnv, aY as runDetachedTurn, aZ as settleDetachedCoderTurn, a_ as traceContextToEnv, a$ as validateDelegateArgs } from '../coordination-DxHduZg7.js';
 import { L as LocalHarness, r as runLocalHarness } from '../local-harness-sI0S_XNA.js';
 export { a as LocalHarnessResult, R as RunLocalHarnessOptions } from '../local-harness-sI0S_XNA.js';
-import { G as GitRunner } from '../worktree-harness-CX_McRLp.js';
-export { C as CreateWorktreeOptions, b as DiffOptions, c as DiffResult, R as RemoveWorktreeOptions, d as WorktreeHandle, e as captureWorktreeDiff, f as createWorktree, r as removeWorktree } from '../worktree-harness-CX_McRLp.js';
+import { G as GitRunner } from '../completion-gate-BDaBP8dd.js';
+export { C as CreateWorktreeOptions, b as DiffOptions, c as DiffResult, R as RemoveWorktreeOptions, d as WorktreeHandle, e as captureWorktreeDiff, f as createWorktree, r as removeWorktree } from '../completion-gate-BDaBP8dd.js';
 export { C as CreateKbGateOptions, F as FactCandidate, a as FactJudge, b as FactJudgeVerdict, K as KbGateResult, c as createKbGate } from '../kb-gate-CwHO0vz6.js';
-export { m as mcpToolsForRuntimeMcp, a as mcpToolsForRuntimeMcpSubset } from '../openai-tools-BnrOmGjN.js';
+export { m as mcpToolsForRuntimeMcp, a as mcpToolsForRuntimeMcpSubset } from '../openai-tools-D0xmzo0y.js';
 import { AnalystFinding } from '@tangle-network/agent-eval';
 import { U as UiLens } from '../substrate-DO2GHNg2.js';
 import '@tangle-network/sandbox';
-import '../types-Driepl87.js';
+import '../types-DAJQRIUD.js';
 import '@tangle-network/agent-interface';
-import '../otel-export-BKmNwiCb.js';
-import '../router-client-r8y_VFVM.js';
+import '../router-client-DJImUDlm.js';
 import '../environment-provider.js';
 import '@tangle-network/agent-interface/environment-provider';
 import 'node:child_process';