@tangle-network/agent-runtime 0.55.0 → 0.56.1

package/dist/runtime.d.ts

@@ -1,7 +1,7 @@
 import { AgentProfile, BackendType, CreateSandboxOptions, SandboxInstance, SandboxEvent } from '@tangle-network/sandbox';
 export { AgentProfile, CreateSandboxOptions, SandboxEvent, SandboxInstance } from '@tangle-network/sandbox';
-import { R as ResultBlobStore, p as SpawnJournal, N as NodeId, q as SpawnEvent, T as TreeView, r as Settled, s as AgentSpec, E as ExecutorRegistry, B as Budget, t as Agent, u as RootHandle, v as SupervisedResult, w as Spend, x as Scope, y as ExecutorFactory, z as Executor, U as UsageEvent, M as MakeWorkerAgent, D as Supervisor } from './coordination-BMzskrUR.js';
-export { G as ExecutorContext, H as ExecutorResult, K as Handle, L as NodeSnapshot, O as NodeStatus, P as Restart, V as RootSignal, W as Runtime, X as SpawnOpts, Y as SupervisorOpts, Z as WidenGate } from './coordination-BMzskrUR.js';
+import { u as ResultBlobStore, v as SpawnJournal, N as NodeId, w as SpawnEvent, T as TreeView, x as Settled, y as AgentSpec, E as ExecutorRegistry, B as Budget, z as Agent, H as RootHandle, K as SupervisedResult, L as Spend, O as Scope, P as ExecutorFactory, U as Executor, V as UsageEvent, G as GitRunner, M as MakeWorkerAgent, X as Supervisor } from './coordination-DWNGqygr.js';
+export { Y as ExecutorContext, Z as ExecutorResult, _ as Handle, $ as NodeSnapshot, a0 as NodeStatus, a1 as Restart, a2 as RootSignal, a3 as Runtime, a4 as SpawnOpts, a5 as SupervisorOpts, a6 as WidenGate } from './coordination-DWNGqygr.js';
 import { R as RuntimeHooks } from './runtime-hooks-C7JwKb9E.js';
 import { ChatClient, AnalystFinding, DefaultVerdict, AgentProfile as AgentProfile$1, AnalystRunInputs } from '@tangle-network/agent-eval';
 export { DefaultVerdict } from '@tangle-network/agent-eval';
@@ -13,9 +13,11 @@ export { c as createSandboxForSpec, d as defaultSelectWinner, r as runLoop } fro
 import { b as AnalystRegistryLike } from './types-p8dWBIXL.js';
 import { R as RouterConfig, T as ToolSpec } from './router-client-30Y_pca8.js';
 export { a as RouterChatResult, b as RouterChatToolsResult, c as RouterToolCall, d as RouterToolLoopResult, r as routerChatWithTools, e as routerChatWithUsage, f as routerToolLoop } from './router-client-30Y_pca8.js';
-import './delegates-BPLIl8EC.js';
-import './coder-CEkUFv8h.js';
+import { a as CoderCheckConstraints } from './coder-COuOK8h8.js';
+import { L as LocalHarness, r as runLocalHarness } from './local-harness-BE_h8szs.js';
+import './delegates-D9o5_VFj.js';
 import './substrate-CUgk7F7s.js';
+import 'node:child_process';
 
 /**
  * @experimental
@@ -705,6 +707,13 @@ interface FanoutOptions<Item, D> {
     itemTask(item: Item, index: number, ctx: ShapeContext<D>): unknown;
     /** Per-item child label (defaults to `item:<index>` in the impl). */
     label?(item: Item, index: number): string;
+    /**
+     * Optional per-item `AgentSpec` override. When set, each item's child is spawned against the
+     * returned spec instead of `persona.root` — the seam a heterogeneous fanout uses to give each
+     * item a DISTINCT executor (e.g. N authored harness profiles, each on its own worktree-CLI
+     * leaf). Absent ⇒ every item runs against the persona's root spec (the homogeneous default).
+     */
+    itemSpec?(item: Item, index: number, ctx: ShapeContext<D>): AgentSpec;
     /**
      * Optional synthesis over the gathered child results: when present, the combinator spawns ONE
      * synthesis child whose task is built from the drained settlements, and its `done` output is
@@ -712,7 +721,21 @@ interface FanoutOptions<Item, D> {
      * The synthesis child is a SEPARATE keystone agent (not a re-rank behind the driver).
      */
     synthesize?: FanoutSynthesis<D>;
+    /**
+     * Winner-selection strategy among the gathered `done` children when there is no `synthesize`.
+     * Receives the SAME `Iteration[]` the default selector reads (each child's output is its
+     * `Outcome<D>`), so a strategy is a thin re-sort (smallest-diff, highest-readiness, first-valid
+     * …) over the candidates — NEVER a re-rank behind a judge. Default = `defaultSelectWinner`
+     * semantics (best-valid-score, ties→earliest). Mutually exclusive with `synthesize` (a
+     * synthesis child IS the selection); supplying both is a config error.
+     */
+    selectWinner?: FanoutWinnerSelector<D>;
 }
+/** A winner-selection strategy: argmax/sort over the gathered child iterations (each output is the
+ *  child's `Outcome<D>`), returning the chosen iteration or `undefined` when none qualifies. */
+type FanoutWinnerSelector<D> = (iterations: Iteration<unknown, Outcome<D>>[]) => {
+    readonly output?: Outcome<D> | undefined;
+} | undefined;
 /** How a fanout's synthesis child is built + read. `synthesisTask` projects the drained child
  *  settlements into the synthesis child's task; `collect` reads its settled output into the
  *  deliverable `Outcome<D>`. */
@@ -2954,6 +2977,236 @@ declare function spendFromUsageEvents(events: UsageEvent[]): Spend;
  */
 declare function createBudgetPool(root: Budget, now?: () => number): BudgetPool;
 
+/**
+ * @experimental
+ *
+ * The worktree-CLI leaf executor — a supervisor-authored `AgentProfile` driving a local
+ * coding-harness CLI (claude / codex / opencode) on its OWN git worktree, surfaced as the
+ * open `Executor<Out>` port (`./types`). It is a LEAF executor, not a `DelegationExecutor`:
+ * it plugs straight into the `Scope`/`Supervisor` recursion and `gateOnDeliverable`, so it
+ * IS the canonical recursive path (no `runLoop`/virtual-SandboxInstance shim in between).
+ *
+ * The §1.5 payload reaches the harness: `harnessInvocation` (mcp/local-harness) maps the
+ * authored `profile.prompt.systemPrompt` into the prompt channel and `profile.model.default`
+ * into the harness's `-m` selector — the prompt-only `buildArgs(taskPrompt)` path dropped
+ * both. The subprocess runs through `runLocalHarness` (the stdin-CLOSED spawn shape — the
+ * #308 fix that keeps a non-TTY `opencode run` from blocking on input forever).
+ *
+ * Lifecycle per spawn (fresh executor — one box/abort/teardown each):
+ *   1. `createWorktree` — `git worktree add` off `repoRoot` at `baseRef`.
+ *   2. `runLocalHarness` — spawn the harness, fed the profile-aware invocation.
+ *   3. `captureWorktreeDiff` — `git diff` the worktree → the patch artifact.
+ *   4. `removeWorktree` — on `teardown` (always; the loser of a fanout is dirty).
+ *
+ * Reuse, not duplication: `createWorktree` / `captureWorktreeDiff` / `removeWorktree` come
+ * straight from `mcp/worktree`; `runLocalHarness` + `LocalHarness` from `mcp/local-harness`.
+ * Nothing here reimplements a worktree, a spawn, or a diff.
+ *
+ * Token accounting: a harness CLI does not surface usage, so this executor is
+ * `budgetExempt: true` — its spend is NOT metered against the conserved pool and its
+ * iterations are EXCLUDED from the equal-k arms by construction (mirrors `cliExecutor`).
+ */
+
+/** Outcome of one verification command run in the worktree (test or typecheck). */
+interface WorktreeCommandResult {
+    /** The shell command line that was run. */
+    command: string;
+    /** Did the command exit 0? The PASS signal the coder deliverable gates on. */
+    passed: boolean;
+    /** OS exit code, or `null` when killed before exit. */
+    exitCode: number | null;
+    /** Combined stdout+stderr (capped) — surfaced in traces for diagnosis. */
+    output: string;
+}
+/** Terminal artifact of one worktree-CLI run: the captured diff + the harness's run record. */
+interface WorktreePatchArtifact {
+    /** The branch the worktree was cut on (`delegate/<runId>`). */
+    branch: string;
+    /** `git diff` of the worktree against its base — the unified patch the harness produced. */
+    patch: string;
+    /** Shortstat-derived change counts. */
+    stats: {
+        filesChanged: number;
+        insertions: number;
+        deletions: number;
+    };
+    /** The harness subprocess outcome (exit code, captured streams, timing). */
+    harness: {
+        name: LocalHarness;
+        exitCode: number | null;
+        timedOut: boolean;
+        killedBySignal: NodeJS.Signals | null;
+        durationMs: number;
+        stdout: string;
+        stderr: string;
+    };
+    /**
+     * Verification signals DERIVED in the live worktree, after the harness ran and before
+     * teardown — the PASS signals the old sandbox `CoderOutput` carried, re-derived here by
+     * running the configured commands. Present only when `testCmd`/`typecheckCmd` were supplied.
+     * The coder deliverable (`coderDeliverable`) reads these to gate the patch.
+     */
+    checks?: {
+        tests?: WorktreeCommandResult;
+        typecheck?: WorktreeCommandResult;
+    };
+}
+/** @experimental */
+interface WorktreeCliExecutorOptions {
+    /** Absolute path to the git checkout the worktree is cut from. */
+    repoRoot: string;
+    /** The SUPERVISOR-AUTHORED profile (the §1.5 payload: systemPrompt + model). */
+    profile: AgentProfile;
+    /** Which local harness CLI drives this leaf (`claude` | `codex` | `opencode`). */
+    harness: LocalHarness;
+    /** The per-task instruction handed to the harness (composed under the system prompt). */
+    taskPrompt: string;
+    /** Unique id for the worktree path + branch. Defaults to a fresh UUID. */
+    runId?: string;
+    /** Override the base ref the worktree is cut from (default `HEAD`). */
+    baseRef?: string;
+    /** Wall-clock cap per harness subprocess (ms). Default 5 min (the `runLocalHarness` default). */
+    harnessTimeoutMs?: number;
+    /**
+     * Shell command run in the live worktree to derive the tests-PASS signal (e.g. `pnpm test`).
+     * Its exit code becomes `artifact.checks.tests.passed`. Omit to skip (no signal derived).
+     */
+    testCmd?: string;
+    /** Shell command run in the live worktree to derive the typecheck-PASS signal (e.g. `pnpm typecheck`). */
+    typecheckCmd?: string;
+    /** Wall-clock cap per verification command (ms). Default = `harnessTimeoutMs` or 5 min. */
+    checkTimeoutMs?: number;
+    /** Test seam — inject a git runner so unit tests drive the worktree helpers without git. */
+    runGit?: GitRunner;
+    /** Test seam — inject the harness runner so unit tests script a `LocalHarnessResult`. */
+    runHarness?: typeof runLocalHarness;
+    /**
+     * Test seam — inject the verification-command runner so unit tests script test/typecheck
+     * outcomes without spawning a real shell. Defaults to a `/bin/sh -c` spawn in the worktree.
+     */
+    runCommand?: (opts: {
+        command: string;
+        cwd: string;
+        timeoutMs: number;
+        signal?: AbortSignal;
+    }) => Promise<{
+        exitCode: number | null;
+        output: string;
+    }>;
+}
+/**
+ * Build a worktree-CLI leaf `Executor`. Per-spawn (a fresh worktree + abort + teardown each),
+ * so a fanout of N profiles = N parallel worktrees that never clobber each other.
+ *
+ * Fail-loud: an empty `repoRoot`/`harness`/`taskPrompt` throws at construction (no silent
+ * default for a required boundary). `resultArtifact()` before `execute()` resolves throws.
+ *
+ * @experimental
+ */
+declare function createWorktreeCliExecutor(options: WorktreeCliExecutorOptions): Executor<WorktreePatchArtifact>;
+
+/**
+ * @experimental
+ *
+ * `coderDeliverable` — the mechanical coder gate, re-homed as a generic `DeliverableSpec` over
+ * the worktree-CLI artifact. It is the ONE place the coder-domain checks reach the generic
+ * `gateOnDeliverable` path: a `fanout(createWorktreeCliExecutor)` of authored harness profiles,
+ * each `gateOnDeliverable(coderDeliverable(...))`, winner via `defaultSelectWinner`.
+ *
+ * The checks themselves are NOT re-implemented here — `runCoderChecks` (`../../profiles/coder`)
+ * is the single source of the no-op / always-on secret-path floor / forbidden-path / diff-size /
+ * test / typecheck logic, shared with `createCoderValidator`. This factory only adapts the
+ * `WorktreePatchArtifact` shape (its `checks` carry the test/typecheck PASS signals the executor
+ * derived in the live worktree) into the check inputs and returns the boolean the gate consumes.
+ *
+ * Test/typecheck enforcement is OPT-IN per `require`: when a command was not run in the worktree
+ * (the executor's `testCmd`/`typecheckCmd` were omitted) the corresponding signal is treated as
+ * passed UNLESS `require` lists it — so a gate that demands a tests-pass on an artifact that never
+ * ran tests fails closed (the honest outcome) rather than passing on a missing signal.
+ */
+
+/** @experimental */
+interface CoderDeliverableOptions extends CoderCheckConstraints {
+    /**
+     * Which verification signals the gate REQUIRES to be present-and-passing. A required signal
+     * that the artifact never derived (the command was not configured on the executor) fails the
+     * gate closed. Unlisted signals default to passed-when-absent (the executor simply didn't run
+     * that command). Default `[]` — gate on no-op / secret / forbidden / diff-size only.
+     */
+    require?: ReadonlyArray<'tests' | 'typecheck'>;
+}
+/**
+ * Build the coder `DeliverableSpec<WorktreePatchArtifact>`: `check(artifact)` runs the shared
+ * mechanical gate (`runCoderChecks`) over the captured patch + the worktree-derived pass signals
+ * and returns whether the patch is DELIVERED (the `valid` conjunction).
+ *
+ * @experimental
+ */
+declare function coderDeliverable(options?: CoderDeliverableOptions): DeliverableSpec<WorktreePatchArtifact>;
+
+/**
+ * @experimental
+ *
+ * `worktreeCoderFanout` — the GENERIC coding combinator: a `fanout` of N supervisor-authored
+ * harness profiles, each on its OWN worktree-CLI leaf, each `gateOnDeliverable(coderDeliverable)`,
+ * winner via `defaultSelectWinner` (or a thin re-sort strategy). It is the canonical replacement
+ * for the role-coupled multi-harness coder driver: no `runLoop` driver, no `multiHarnessCoderFanout`
+ * harness-list config — the harness list is the fanout's item list, the §1.5 profile is authored
+ * per item, and the mechanical gate is the re-homed `coderDeliverable`.
+ *
+ * The shape is content-free at the `fanout` layer; this builder only assembles the coder-domain
+ * pieces (the worktree-CLI executor + the coder deliverable + the diff/readiness selectors) into
+ * the generic combinator's `itemSpec`/`selectWinner` seams. Nothing here re-implements selection,
+ * gating, or fanout — it composes the existing primitives.
+ */
+
+/** @experimental One authored harness profile in a coder fanout: the §1.5 profile + which local
+ *  harness CLI drives it. The supervisor authors `profile` per sub-task; `harness` chooses the leaf. */
+interface AuthoredCoderHarness {
+    /** A short label for the worktree branch + trace node. */
+    name: string;
+    /** The supervisor-authored `AgentProfile` (systemPrompt + model reach the harness via §1.5). */
+    profile: AgentProfile;
+    /** Which local harness CLI drives this leaf. */
+    harness: 'claude' | 'codex' | 'opencode';
+    /** Per-harness model/runId/baseRef overrides flow through the profile + these. */
+    runId?: string;
+    baseRef?: string;
+}
+/** @experimental Winner-selection among the gated coder candidates. `highest-score` is the
+ *  `defaultSelectWinner` default; the rest are thin re-sorts over the same iterations. */
+type CoderWinnerStrategy = 'highest-score' | 'smallest-diff' | 'first-valid';
+/** @experimental */
+interface WorktreeCoderFanoutOptions extends CoderDeliverableOptions {
+    /** Absolute path to the git checkout each worktree is cut from. */
+    repoRoot: string;
+    /** The per-task instruction handed to every harness (composed under each profile's systemPrompt). */
+    taskPrompt: string;
+    /** The authored harness profiles — one fanout item (and one worktree-CLI leaf) each. */
+    harnesses: ReadonlyArray<AuthoredCoderHarness>;
+    /** Shell command run in each worktree to derive the tests-PASS signal. */
+    testCmd?: string;
+    /** Shell command run in each worktree to derive the typecheck-PASS signal. */
+    typecheckCmd?: string;
+    /** Wall-clock cap per harness subprocess (ms). */
+    harnessTimeoutMs?: number;
+    /** Winner-selection strategy. Default `highest-score`. */
+    winnerStrategy?: CoderWinnerStrategy;
+    /** Test seams forwarded to every worktree-CLI leaf (inject git/harness/command runners so the
+     *  whole fanout runs offline). Production callers leave these unset. */
+    runGit?: WorktreeCliExecutorOptions['runGit'];
+    runHarness?: WorktreeCliExecutorOptions['runHarness'];
+    runCommand?: WorktreeCliExecutorOptions['runCommand'];
+}
+/**
+ * Build the coder fanout combinator. Run it with `runPersonified({ persona, shape, task, budget })`
+ * — equal-k holds by construction (the conserved budget pool bounds the N leaves), and selection is
+ * the single-sourced `defaultSelectWinner` (or a thin re-sort), never a judge.
+ *
+ * @experimental
+ */
+declare function worktreeCoderFanout<Task>(options: WorktreeCoderFanoutOptions): CombinatorShape<Task, WorktreePatchArtifact>;
+
 /**
  * @experimental
  *
@@ -3215,6 +3468,21 @@ interface CliSeam {
     /** Working directory for the subprocess. */
     cwd?: string;
 }
+/**
+ * cli-worktree seam. A supervisor-authored `AgentProfile` driving a local coding-harness CLI
+ * (claude / codex / opencode) on its own git worktree — the leaf `createWorktreeCliExecutor`
+ * named as data. `harness` + `repoRoot` + `taskPrompt` are required; the authored
+ * `profile.prompt.systemPrompt` + `profile.model.default` reach the harness via the §1.5
+ * `harnessInvocation` mapper. Everything else mirrors `WorktreeCliExecutorOptions`.
+ */
+interface CliWorktreeSeam {
+    repoRoot: string;
+    harness: LocalHarness;
+    taskPrompt: string;
+    runId?: string;
+    baseRef?: string;
+    harnessTimeoutMs?: number;
+}
 /**
  * cli-bridge seam. A local OpenAI-compatible bridge that fronts harness CLIs
  * (claude-code / opencode / kimi / pi) behind one HTTP surface; `model` doubles
@@ -3251,6 +3519,12 @@ interface RouterToolsSeam {
      *  or wall-clock deadline at the call site. */
     maxTurns?: number;
 }
+/**
+ * The leaf `createWorktreeCliExecutor` as a backend-as-data factory: a supervisor-authored
+ * `AgentProfile` driving claude / codex / opencode on its own worktree. `budgetExempt` like
+ * the other CLI leaves; the authored systemPrompt + model reach the harness via §1.5.
+ */
+declare const cliWorktreeExecutor: ExecutorFactory<unknown>;
 /**
  * The single built-in executor entrypoint. The backend is DATA — the cost dial a
  * profile, an experiment config, or a replay journal can name — not an import
@@ -3267,6 +3541,8 @@ type ExecutorConfig = ({
 } & BridgeSeam) | ({
     backend: 'cli';
 } & CliSeam) | ({
+    backend: 'cli-worktree';
+} & CliWorktreeSeam) | ({
     backend: 'sandbox';
     harness?: BackendType;
 } & SandboxSeam);
@@ -3521,4 +3797,4 @@ declare function runInWorkspace<T>(ws: Workspace, body: (cwd: string) => Promise
     commitOnInvalid?: boolean;
 }): Promise<WorkspaceRun<T>>;
 
-export { Agent, AgentRunSpec, AgentSpec, type AgenticOptions, type AgenticRunResult, type AgenticSurface, type AgenticTask, type AgenticTool, type AnytimeReport, type AnytimeStrategySummary, type AnytimeTaskCurve, type ArtifactHandle, type AssertTraceDerivedFindings, type AuditIntentInput, type AuditIntentOptions, type AuthorStrategyOptions, type AuthoredProfile, type AuthoredStrategy, type BenchmarkCell, type BenchmarkConfig, type BenchmarkLift, type BenchmarkReport, type BenchmarkStrategySummary, type BenchmarkTaskRow, type BridgeSeam, Budget, type BudgetPool, type BudgetReadout, type ChampionPick, type ChampionPolicy, type CheckpointCapableBox, type CliSeam, type CombinatorShape, type CompletionAnalyst, type CompletionEvidence, type CompletionPolicy, type CompletionVerdict, type CoordinationDriverOptions, type CoordinationMcpHandle, type Corpus, type CorpusFilter, type CorpusRecord, type CreateScopeAnalystOptions, type CriuCapableClient, type DefinePersona, type DefinePersonaInput, type Deliverable, type DeliverableSpec, type DriverChat, type DriverMessage, type DriverToolCall, type DriverTurn, type Environment, type EqualKArm, type EqualKOnCost, type EqualKOnCostOptions, type EqualKVerdict, type EvolutionArchiveNode, type EvolutionAuthor, type EvolutionBandInfo, type EvolutionCandidate, type EvolutionGeneration, type EvolutionReport, ExecCtx, Executor, type ExecutorConfig, ExecutorFactory, ExecutorRegistry, type Fanout, type FanoutOptions, type FanoutSynthesis, FileCorpus, FileResultBlobStore, FileSpawnJournal, type FlatWidenGate, type ForkCapableBox, type GitWorkspaceOptions, type HarvestCorpusOptions, type HarvestFailure, type HarvestReport, InMemoryCorpus, InMemoryResultBlobStore, InMemorySpawnJournal, type IntentAudit, Iteration, type LoopDispatchOptions, type LoopOptionsForDispatch, LoopResult, type LoopShape, LoopTokenUsage, type LoopUntil, type LoopUntilSpec, type LoopUntilState, type McpEndpoint, type McpEnvironmentOptions, type NestedScopeSeam, NodeId, type Observation, type ObserveInput, type ObserveOptions, type OpenSandboxRunOptions, type Outcome, type Panel, type PanelJudge, type PanelSpec, type PanelVerdict, type Persona, type PersonaContext, type PersonaExecutors, type Pipeline, type PipelineStage, type PromotionGateOptions, type PromotionVerdict, type RegistryAnalyzeProjection, type RenderCorpusToInstructions, type RenderCorpusToInstructionsOptions, type ReservationTicket, ResultBlobStore, RootHandle, RouterConfig, type RouterSeam, type RouterToolsSeam, type RunAgenticOptions, RunLoopOptions, type RunPersonified, type RunPersonifiedOptions, type SandboxCapabilities, SandboxClient, type SandboxLineage, type SandboxLineageHandle, type SandboxRun, type SandboxSeam, Scope, type ScopeAnalyst, type ScopeAnalyzeInput, type ScopeWidenGate, type SessionCapableBox, Settled, type ShapeBudget, type ShapeContext, type ShapeRegistry, type Shell, type ShotPersona, type ShotSpec, SpawnEvent, SpawnJournal, Spend, type SteerContext, type Strategy, type StrategyCtx, type StrategyEvolutionConfig, type StrategyResult, SupervisedResult, Supervisor, type SurfaceScore, ToolSpec, type TrajectoryNode, type TrajectoryReport, type TrajectoryReportFn, type TrajectoryReportOptions, TreeView, type TurnResult, UsageEvent, type UsageSink, type VerifierEnvironmentOptions, type Verify, type VerifySpec, type WaterfallCollector, type WaterfallReport, type WaterfallSpan, type Widen, type WidenDecision, type WidenLineage, type WidenSpec, type Workspace, type WorkspaceCommit, type WorkspaceRun, acquireSandbox, adaptiveRefine, anytimeReport, asAuthoredProfile, assertStrategyContract, assertTraceDerivedFindings, auditIntent, authorStrategy, authoredWorker, breadthDriver, buildSteerContext, builtinShapes, completionAuthorizes, contentAddress, coordinationDriverAgent, createBudgetPool, createExecutor, createExecutorRegistry, createMcpEnvironment, createRootHandle, createSandboxLineage, createScope, createScopeAnalyst, createShapeRegistry, createSupervisor, createVerifierEnvironment, createWaterfallCollector, defaultAnalystInstruction, defaultAuditorInstruction, definePersona, defineStrategy, depthDriver, deterministicCompletion, discriminatingMeans, driverChild, driverExecutorFactory, driverRuntime, equalKOnCost, extractLlmCallEvent, fanout, flatWidenGate, gateOnDeliverable, gitWorkspace, harvestCorpus, inlineSandboxClient, isDriverSpec, jjWorkspace, localShell, loopDispatch, loopUntil, mapSandboxEvent, materializeTreeView, nestedScopeSeamKey, observe, openSandboxRun, panel, pickChampion, pipeline, printBenchmarkReport, probeSandboxCapabilities, promotionGate, refine, registerShape, registryScopeAnalyst, renderAnytimeTable, renderCorpusToInstructions, renderReport, replaySpawnTree, reportLoopUsage, runAgentic, runBenchmark, runInWorkspace, runPersonified, runStrategyEvolution, sample, sampleThenRefine, selectChampion, sentinelCompletion, serveCoordinationMcp, settledToIteration, spendFromUsageEvents, stopSentinel, strategyAuthorContract, supervisorSkill, trajectoryReport, verify, widen, withDriverExecutor };
+export { Agent, AgentRunSpec, AgentSpec, type AgenticOptions, type AgenticRunResult, type AgenticSurface, type AgenticTask, type AgenticTool, type AnytimeReport, type AnytimeStrategySummary, type AnytimeTaskCurve, type ArtifactHandle, type AssertTraceDerivedFindings, type AuditIntentInput, type AuditIntentOptions, type AuthorStrategyOptions, type AuthoredCoderHarness, type AuthoredProfile, type AuthoredStrategy, type BenchmarkCell, type BenchmarkConfig, type BenchmarkLift, type BenchmarkReport, type BenchmarkStrategySummary, type BenchmarkTaskRow, type BridgeSeam, Budget, type BudgetPool, type BudgetReadout, type ChampionPick, type ChampionPolicy, type CheckpointCapableBox, type CliSeam, type CliWorktreeSeam, type CoderDeliverableOptions, type CoderWinnerStrategy, type CombinatorShape, type CompletionAnalyst, type CompletionEvidence, type CompletionPolicy, type CompletionVerdict, type CoordinationDriverOptions, type CoordinationMcpHandle, type Corpus, type CorpusFilter, type CorpusRecord, type CreateScopeAnalystOptions, type CriuCapableClient, type DefinePersona, type DefinePersonaInput, type Deliverable, type DeliverableSpec, type DriverChat, type DriverMessage, type DriverToolCall, type DriverTurn, type Environment, type EqualKArm, type EqualKOnCost, type EqualKOnCostOptions, type EqualKVerdict, type EvolutionArchiveNode, type EvolutionAuthor, type EvolutionBandInfo, type EvolutionCandidate, type EvolutionGeneration, type EvolutionReport, ExecCtx, Executor, type ExecutorConfig, ExecutorFactory, ExecutorRegistry, type Fanout, type FanoutOptions, type FanoutSynthesis, type FanoutWinnerSelector, FileCorpus, FileResultBlobStore, FileSpawnJournal, type FlatWidenGate, type ForkCapableBox, type GitWorkspaceOptions, type HarvestCorpusOptions, type HarvestFailure, type HarvestReport, InMemoryCorpus, InMemoryResultBlobStore, InMemorySpawnJournal, type IntentAudit, Iteration, type LoopDispatchOptions, type LoopOptionsForDispatch, LoopResult, type LoopShape, LoopTokenUsage, type LoopUntil, type LoopUntilSpec, type LoopUntilState, type McpEndpoint, type McpEnvironmentOptions, type NestedScopeSeam, NodeId, type Observation, type ObserveInput, type ObserveOptions, type OpenSandboxRunOptions, type Outcome, type Panel, type PanelJudge, type PanelSpec, type PanelVerdict, type Persona, type PersonaContext, type PersonaExecutors, type Pipeline, type PipelineStage, type PromotionGateOptions, type PromotionVerdict, type RegistryAnalyzeProjection, type RenderCorpusToInstructions, type RenderCorpusToInstructionsOptions, type ReservationTicket, ResultBlobStore, RootHandle, RouterConfig, type RouterSeam, type RouterToolsSeam, type RunAgenticOptions, RunLoopOptions, type RunPersonified, type RunPersonifiedOptions, type SandboxCapabilities, SandboxClient, type SandboxLineage, type SandboxLineageHandle, type SandboxRun, type SandboxSeam, Scope, type ScopeAnalyst, type ScopeAnalyzeInput, type ScopeWidenGate, type SessionCapableBox, Settled, type ShapeBudget, type ShapeContext, type ShapeRegistry, type Shell, type ShotPersona, type ShotSpec, SpawnEvent, SpawnJournal, Spend, type SteerContext, type Strategy, type StrategyCtx, type StrategyEvolutionConfig, type StrategyResult, SupervisedResult, Supervisor, type SurfaceScore, ToolSpec, type TrajectoryNode, type TrajectoryReport, type TrajectoryReportFn, type TrajectoryReportOptions, TreeView, type TurnResult, UsageEvent, type UsageSink, type VerifierEnvironmentOptions, type Verify, type VerifySpec, type WaterfallCollector, type WaterfallReport, type WaterfallSpan, type Widen, type WidenDecision, type WidenLineage, type WidenSpec, type Workspace, type WorkspaceCommit, type WorkspaceRun, type WorktreeCliExecutorOptions, type WorktreeCoderFanoutOptions, type WorktreeCommandResult, type WorktreePatchArtifact, acquireSandbox, adaptiveRefine, anytimeReport, asAuthoredProfile, assertStrategyContract, assertTraceDerivedFindings, auditIntent, authorStrategy, authoredWorker, breadthDriver, buildSteerContext, builtinShapes, cliWorktreeExecutor, coderDeliverable, completionAuthorizes, contentAddress, coordinationDriverAgent, createBudgetPool, createExecutor, createExecutorRegistry, createMcpEnvironment, createRootHandle, createSandboxLineage, createScope, createScopeAnalyst, createShapeRegistry, createSupervisor, createVerifierEnvironment, createWaterfallCollector, createWorktreeCliExecutor, defaultAnalystInstruction, defaultAuditorInstruction, definePersona, defineStrategy, depthDriver, deterministicCompletion, discriminatingMeans, driverChild, driverExecutorFactory, driverRuntime, equalKOnCost, extractLlmCallEvent, fanout, flatWidenGate, gateOnDeliverable, gitWorkspace, harvestCorpus, inlineSandboxClient, isDriverSpec, jjWorkspace, localShell, loopDispatch, loopUntil, mapSandboxEvent, materializeTreeView, nestedScopeSeamKey, observe, openSandboxRun, panel, pickChampion, pipeline, printBenchmarkReport, probeSandboxCapabilities, promotionGate, refine, registerShape, registryScopeAnalyst, renderAnytimeTable, renderCorpusToInstructions, renderReport, replaySpawnTree, reportLoopUsage, runAgentic, runBenchmark, runInWorkspace, runPersonified, runStrategyEvolution, sample, sampleThenRefine, selectChampion, sentinelCompletion, serveCoordinationMcp, settledToIteration, spendFromUsageEvents, stopSentinel, strategyAuthorContract, supervisorSkill, trajectoryReport, verify, widen, withDriverExecutor, worktreeCoderFanout };

package/dist/runtime.js

@@ -17,6 +17,8 @@ import {
   breadthDriver,
   buildSteerContext,
   builtinShapes,
+  cliWorktreeExecutor,
+  coderDeliverable,
   completionAuthorizes,
   contentAddress,
   coordinationDriverAgent,
@@ -33,6 +35,7 @@ import {
   createSupervisor,
   createVerifierEnvironment,
   createWaterfallCollector,
+  createWorktreeCliExecutor,
   defaultAnalystInstruction,
   defaultAuditorInstruction,
   defaultSelectWinner,
@@ -96,13 +99,16 @@ import {
   trajectoryReport,
   verify,
   widen,
-  withDriverExecutor
-} from "./chunk-JTH2FPCK.js";
+  withDriverExecutor,
+  worktreeCoderFanout
+} from "./chunk-4H2FML7G.js";
+import "./chunk-7QYOXFCD.js";
 import "./chunk-WIR4HOOJ.js";
 import {
   extractLlmCallEvent,
   mapSandboxEvent
 } from "./chunk-VLF5RHEQ.js";
+import "./chunk-GLMFBUKT.js";
 import "./chunk-G3RGMA7C.js";
 import "./chunk-DGUM43GV.js";
 export {
@@ -124,6 +130,8 @@ export {
   breadthDriver,
   buildSteerContext,
   builtinShapes,
+  cliWorktreeExecutor,
+  coderDeliverable,
   completionAuthorizes,
   contentAddress,
   coordinationDriverAgent,
@@ -140,6 +148,7 @@ export {
   createSupervisor,
   createVerifierEnvironment,
   createWaterfallCollector,
+  createWorktreeCliExecutor,
   defaultAnalystInstruction,
   defaultAuditorInstruction,
   defaultSelectWinner,
@@ -205,6 +214,7 @@ export {
   trajectoryReport,
   verify,
   widen,
-  withDriverExecutor
+  withDriverExecutor,
+  worktreeCoderFanout
 };
 //# sourceMappingURL=runtime.js.map

package/dist/workflow.js

@@ -2,12 +2,14 @@ import {
   createSandboxForSpec,
   describeSandboxPlacement,
   runLoop
-} from "./chunk-JTH2FPCK.js";
+} from "./chunk-4H2FML7G.js";
+import "./chunk-7QYOXFCD.js";
 import "./chunk-WIR4HOOJ.js";
 import {
   ValidationError,
   extractLlmCallEvent
 } from "./chunk-VLF5RHEQ.js";
+import "./chunk-GLMFBUKT.js";
 import "./chunk-G3RGMA7C.js";
 import "./chunk-DGUM43GV.js";