@tangle-network/agent-runtime 0.79.1 → 0.79.3

package/dist/{chunk-SONQUREI.js → chunk-PVPFDTO3.js}

@@ -8,7 +8,7 @@ import {
   DELEGATION_STATUS_DESCRIPTION,
   DELEGATION_STATUS_INPUT_SCHEMA,
   DELEGATION_STATUS_TOOL_NAME
-} from "./chunk-TSDKBFZP.js";
+} from "./chunk-KRULXIWS.js";
 
 // src/mcp/openai-tools.ts
 function buildTool(name, description, parameters) {
@@ -45,4 +45,4 @@ export {
   mcpToolsForRuntimeMcp,
   mcpToolsForRuntimeMcpSubset
 };
-//# sourceMappingURL=chunk-SONQUREI.js.map
+//# sourceMappingURL=chunk-PVPFDTO3.js.map

package/dist/{coordination-BoEPhGas.d.ts → coordination-DCmljYDf.d.ts}

@@ -5,8 +5,8 @@ import { e as LoopTraceEmitter, c as LoopTraceEvent, S as SandboxClient, A as Ag
 import { SandboxEvent, SandboxInstance, BackendType } from '@tangle-network/sandbox';
 import { AgentEvalError } from '@tangle-network/agent-eval';
 import { O as OtelExporter } from './otel-export-BKmNwiCb.js';
-import { T as ToolSpec, R as RouterConfig } from './router-client-CMAWGv1h.js';
-import { d as DeliverableSpec } from './worktree-CpptK3oF.js';
+import { T as ToolSpec, R as RouterConfig } from './router-client-Ak2IGuXq.js';
+import { G as GitRunner, a as WorktreeCheckRunner, D as DeliverableSpec } from './worktree-harness-Bmho9SH0.js';
 import { L as LocalHarness } from './local-harness-DU7yV6mG.js';
 import { ProviderExecutorOptions, AgentEnvironmentProviderRegistry } from './environment-provider.js';
 import { AgentEnvironmentProvider } from '@tangle-network/agent-interface/environment-provider';
@@ -1608,11 +1608,35 @@ interface CliSeam {
  */
 interface CliWorktreeSeam {
     repoRoot: string;
-    harness: LocalHarness;
+    /** Local CLI harness transport. Omit when `bridge` is set. */
+    harness?: LocalHarness;
     taskPrompt: string;
     runId?: string;
     baseRef?: string;
     harnessTimeoutMs?: number;
+    testCmd?: string;
+    typecheckCmd?: string;
+    checkTimeoutMs?: number;
+    checkOutputCap?: number;
+    budgetExempt?: boolean;
+    /** Live cli-bridge transport inside the worktree. When set, the worktree leaf accepts
+     *  `deliver()` messages and resumes the same bridge session in this worktree cwd. */
+    bridge?: CliWorktreeBridgeSeam;
+    /** Test seam — forwarded to worktree helpers. */
+    runGit?: GitRunner;
+    /** Test seam — forwarded to verification checks. */
+    runCommand?: WorktreeCheckRunner;
+}
+interface CliWorktreeBridgeSeam {
+    bridgeUrl: string;
+    bridgeBearer: string;
+    /** Bridge model/harness id. Defaults to the profile's model hint when omitted. */
+    model?: string;
+    agentProfile?: Record<string, unknown>;
+    timeoutMs?: number;
+    /** Stable cli-bridge session id. Defaults to `bridge-worktree-${runId}`. */
+    sessionId?: string;
+    maxTurns?: number;
 }
 /**
  * cli-bridge seam. A local OpenAI-compatible bridge that fronts harness CLIs
@@ -1632,6 +1656,8 @@ interface BridgeSeam {
     bridgeUrl: string;
     bridgeBearer: string;
     model: string;
+    /** Optional working directory forwarded to cli-bridge and persisted with the session. */
+    cwd?: string;
     agentProfile?: Record<string, unknown>;
     timeoutMs?: number;
     /** Stable, caller-owned cli-bridge session id for harness-side resume. Defaults

package/dist/index.d.ts

@@ -9,7 +9,7 @@ import { Scenario as Scenario$1, SurfaceProposer, JudgeConfig, MutableSurface, D
 import { AgentProfile as AgentProfile$1 } from '@tangle-network/agent-interface';
 import { S as SurfaceImprovementEdit } from './improvement-adapter-CioiEE2z.js';
 import { I as ImprovementAdapter } from './types-BC3bZpH0.js';
-export { D as DELEGATED_LOOP_MODES, a as DelegatedLoopMode, b as DelegatedLoopRegistry, c as DelegatedLoopResult, d as DelegatedLoopRunner, L as LoopRunnerCliArgs, e as LoopRunnerCliResult, R as ResearchLoopResult, f as ResearchLoopRunnerOptions, g as RunDelegatedLoopOptions, V as VetoedFact, W as WorktreeLoopRunnerOptions, h as auditLoopRunner, i as isDelegatedLoopMode, p as parseLoopRunnerArgv, r as researchLoopRunner, j as runDelegatedLoop, k as runLoopRunnerCli, s as selfImproveLoopRunner, w as worktreeLoopRunner } from './loop-runner-bin-DCr5OMe5.js';
+export { D as DELEGATED_LOOP_MODES, a as DelegatedLoopMode, b as DelegatedLoopRegistry, c as DelegatedLoopResult, d as DelegatedLoopRunner, L as LoopRunnerCliArgs, e as LoopRunnerCliResult, R as ResearchLoopResult, f as ResearchLoopRunnerOptions, g as RunDelegatedLoopOptions, V as VetoedFact, W as WorktreeLoopRunnerOptions, h as auditLoopRunner, i as isDelegatedLoopMode, p as parseLoopRunnerArgv, r as researchLoopRunner, j as runDelegatedLoop, k as runLoopRunnerCli, s as selfImproveLoopRunner, w as worktreeLoopRunner } from './loop-runner-bin-C4X0FZ2Z.js';
 export { m as mcpToolsForRuntimeMcp, a as mcpToolsForRuntimeMcpSubset } from './openai-tools-B-3v06BE.js';
 export { E as EvalRunEvent, a as EvalRunGeneration, b as EvalRunsExportConfig, c as EvalRunsExportResult, I as INTELLIGENCE_WIRE_VERSION, L as LoopSpanNode, d as OtelAttribute, e as OtelExportConfig, O as OtelExporter, f as OtelSpan, g as buildLoopOtelSpans, h as buildLoopSpanNodes, i as createOtelExporter, j as exportEvalRuns, l as loopEventToOtelSpan } from './otel-export-BKmNwiCb.js';
 import '@tangle-network/sandbox';
@@ -17,8 +17,8 @@ import './local-harness-DU7yV6mG.js';
 import 'node:child_process';
 import './kb-gate-CuzMYGYM.js';
 import './types-C1sozrte.js';
-import './worktree-fanout-CtQrRDME.js';
-import './worktree-CpptK3oF.js';
+import './worktree-fanout-CXGzHET4.js';
+import './worktree-harness-Bmho9SH0.js';
 
 /**
  * @stable

package/dist/index.js

@@ -1,7 +1,7 @@
 import {
   mcpToolsForRuntimeMcp,
   mcpToolsForRuntimeMcpSubset
-} from "./chunk-SONQUREI.js";
+} from "./chunk-PVPFDTO3.js";
 import {
   DEFAULT_ROUTER_BASE_URL,
   cleanModelId,
@@ -20,16 +20,16 @@ import {
   runLoopRunnerCli,
   selfImproveLoopRunner,
   worktreeLoopRunner
-} from "./chunk-2DS6T46I.js";
+} from "./chunk-63MHOCIE.js";
 import "./chunk-FNMGYYSS.js";
-import "./chunk-75V2XXYJ.js";
+import "./chunk-AG335EXG.js";
 import {
   assertModelAllowed,
   composeRuntimeHooks,
   defineRuntimeHooks,
   notifyRuntimeDecisionPoint,
   notifyRuntimeHookEvent
-} from "./chunk-TSDKBFZP.js";
+} from "./chunk-KRULXIWS.js";
 import {
   INTELLIGENCE_WIRE_VERSION,
   buildLoopOtelSpans,

package/dist/intelligence.d.ts

@@ -1,6 +1,6 @@
 import { c as LoopTraceEvent } from './types-BF-MEsQB.js';
 import { AgentProfileMcpServer } from '@tangle-network/agent-interface';
-import { T as ToolSpec } from './router-client-CMAWGv1h.js';
+import { T as ToolSpec } from './router-client-Ak2IGuXq.js';
 import '@tangle-network/agent-eval';
 import '@tangle-network/sandbox';
 

package/dist/{loop-runner-bin-DCr5OMe5.d.ts → loop-runner-bin-C4X0FZ2Z.d.ts}

@@ -3,7 +3,7 @@ import { SelfImproveOptions, SelfImproveResult } from '@tangle-network/agent-eva
 import { R as RunAnalystLoopOpts, a as RunAnalystLoopResult } from './types-BC3bZpH0.js';
 import { F as FactCandidate, C as CreateKbGateOptions } from './kb-gate-CuzMYGYM.js';
 import { B as Budget } from './types-C1sozrte.js';
-import { A as AuthoredHarness, W as WinnerStrategy, a as WorktreeFanoutOptions, b as WorktreePatchArtifact } from './worktree-fanout-CtQrRDME.js';
+import { A as AuthoredHarness, W as WinnerStrategy, a as WorktreeFanoutOptions, b as WorktreePatchArtifact } from './worktree-fanout-CXGzHET4.js';
 
 /**
  * @experimental

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

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-export { L as LoopRunnerCliArgs, e as LoopRunnerCliResult, p as parseLoopRunnerArgv, k as runLoopRunnerCli } from './loop-runner-bin-DCr5OMe5.js';
+export { L as LoopRunnerCliArgs, e as LoopRunnerCliResult, p as parseLoopRunnerArgv, k as runLoopRunnerCli } from './loop-runner-bin-C4X0FZ2Z.js';
 import '@tangle-network/agent-eval/campaign';
 import '@tangle-network/agent-eval/contract';
 import './types-BC3bZpH0.js';
@@ -9,7 +9,7 @@ import './types-C1sozrte.js';
 import '@tangle-network/agent-interface';
 import '@tangle-network/sandbox';
 import './types-BF-MEsQB.js';
-import './worktree-fanout-CtQrRDME.js';
-import './worktree-CpptK3oF.js';
+import './worktree-fanout-CXGzHET4.js';
+import './worktree-harness-Bmho9SH0.js';
 import './local-harness-DU7yV6mG.js';
 import 'node:child_process';

package/dist/loop-runner-bin.js

@@ -2,10 +2,10 @@
 import {
   parseLoopRunnerArgv,
   runLoopRunnerCli
-} from "./chunk-2DS6T46I.js";
+} from "./chunk-63MHOCIE.js";
 import "./chunk-FNMGYYSS.js";
-import "./chunk-75V2XXYJ.js";
-import "./chunk-TSDKBFZP.js";
+import "./chunk-AG335EXG.js";
+import "./chunk-KRULXIWS.js";
 import "./chunk-VMNEQHJR.js";
 import "./chunk-Z3RRRPRB.js";
 import "./chunk-IODKUOBA.js";

package/dist/loops.d.ts

@@ -4,20 +4,20 @@ import { SandboxEvent, SandboxInstance, CreateSandboxOptions } from '@tangle-net
 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, c as Agent, B as Budget, i as Scope, g as Settled, f as SupervisedResult, h as Spend, U as UsageEvent, b as ExecutorRegistry, k as Supervisor } from './types-C1sozrte.js';
 export { A as AgentSpec, a as Executor, l as ExecutorContext, m as ExecutorResult, n as SupervisorOpts, T as TreeView, W as WidenGate } from './types-C1sozrte.js';
-import { ak as MakeWorkerAgent, o as CoordinationTools, A as AnalystRegistry, n as CoordinationEvent, ar as QuestionPolicy, a$ as ExecutorConfig } from './coordination-BoEPhGas.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-BoEPhGas.js';
+import { ak as MakeWorkerAgent, A as AnalystRegistry, o as CoordinationTools, n as CoordinationEvent, ar as QuestionPolicy, a$ as ExecutorConfig } from './coordination-DCmljYDf.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-DCmljYDf.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 } from './types-BF-MEsQB.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-BF-MEsQB.js';
 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-CtQrRDME.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, a3 as WorktreeCommandResult, a as WorktreeFanoutOptions, b as WorktreePatchArtifact, a4 as createWorktreeCliExecutor, a5 as patchDelivered, a6 as worktreeFanout } from './worktree-fanout-CtQrRDME.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-CXGzHET4.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-CXGzHET4.js';
 import { Scenario, ProfileDispatchFn } from '@tangle-network/agent-eval/campaign';
 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 } from './router-client-CMAWGv1h.js';
-export { b as RouterChatResult, c as RouterChatToolsResult, d as RouterToolCall, e as RouterToolLoopResult, T as ToolSpec, r as routerBrain, f as routerChatWithTools, g as routerChatWithUsage, h as routerToolLoop } from './router-client-CMAWGv1h.js';
-import { d as DeliverableSpec } from './worktree-CpptK3oF.js';
-export { g as gateOnDeliverable } from './worktree-CpptK3oF.js';
+import { R as RouterConfig, a as ToolLoopChat, b as ToolLoopCompactionOptions } from './router-client-Ak2IGuXq.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-Ak2IGuXq.js';
+import { D as DeliverableSpec } from './worktree-harness-Bmho9SH0.js';
+export { g as WorktreeCommandResult, h as gateOnDeliverable } from './worktree-harness-Bmho9SH0.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-rNj6TDc3.js';
@@ -2556,6 +2556,13 @@ interface DriverAgentOptions {
     /** 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. */
     readonly maxLiveWorkers?: number;
+    /** The analyst lenses available to the driver. Required for `analyzeOnSettle` (and `run_analyst`).
+     *  Unset → no analyst feed (status quo: the driver gets settled outputs, no findings). */
+    readonly analysts?: AnalystRegistry;
+    /** Analyst kind ids run AUTOMATICALLY when a worker settles `done` — each result re-enters as a
+     *  `finding` the driver pulls and composes its next steer from. The UP-leg of the self-improving
+     *  loop. Omit/empty = no auto-analysis (status quo). Requires `analysts`. */
+    readonly analyzeOnSettle?: ReadonlyArray<string>;
     /** The driver's stance — a string, or built from the task (the worker-driver prompt /
      *  the generator). INJECTED so the prompt is a pluggable, optimizable role. */
     readonly systemPrompt: string | ((task: unknown) => string);
@@ -2579,6 +2586,15 @@ interface DriverAgentOptions {
     /** Injected clock for the in-loop absolute-deadline guard — keeps the deadline check
      *  deterministic in tests. Defaults to `Date.now`. */
     readonly now?: () => number;
+    /** Give the driver brain a chapter-lifecycle on its OWN context window. The LLM-brain front doors
+     *  lose to a dumb-Ralph respawn because the brain re-bills its whole coordination transcript every
+     *  turn — the same context overflow a single steered agent suffers, one level up. With this set,
+     *  once the brain's running conversation exceeds `thresholdTokens` it distills the accumulated
+     *  history to a compact progress note and continues fresh: the supervisor analog of respawning
+     *  against external tracking state, except the live `Scope` roster IS the durable state. Default
+     *  off (no behavior change). `distill` defaults to a self-summary authored by the brain combined
+     *  with the factual settled-worker roster; override to supply your own. */
+    readonly compaction?: ToolLoopCompactionOptions;
 }
 /**
  * Build the intelligent recursive driver. Its `act` is the LLM tool-loop; spawn it as a
@@ -2705,7 +2721,16 @@ interface SupervisorAgentDeps {
     }>;
     /** 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;
 }
 declare function supervisorAgent(profile: SupervisorProfile, deps: SupervisorAgentDeps): Agent<unknown, unknown>;
 
@@ -3078,10 +3103,24 @@ interface SuperviseOptions {
      *  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
@@ -3246,4 +3285,4 @@ declare function runInWorkspace<T>(ws: Workspace, body: (cwd: string) => Promise
     commitOnInvalid?: boolean;
 }): Promise<WorkspaceRun<T>>;
 
-export { Agent, AgentRunSpec, type AgenticOptions, type AgenticRunResult, type AgenticSurface, type AgenticTask, type AgenticTool, 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, CombinatorShape, type CompletionAnalyst, type CompletionEvidence, type CompletionPolicy, type CompletionVerdict, CoordinationEvent, type CoordinationMcpHandle, Corpus, CorpusFilter, CorpusRecord, type CreateScopeAnalystOptions, type CriuCapableClient, DefinePersonaInput, 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, 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, Iteration, type LoopDispatchOptions, LoopLineageOptions, type LoopOptionsForDispatch, LoopResult, LoopShape, LoopTokenUsage, LoopUntilSpec, LoopWinner, type McpEndpoint, type McpEnvironmentOptions, MountRecorder, type NaiveDriverOptions, type Observation, type ObserveInput, type ObserveOptions, type OpenSandboxRunOptions, Outcome, OutputAdapter, PanelSpec, Persona, PipelineStage, type ProfileRichness, type ProfileRichnessThresholds, type PromotionGateOptions, type PromotionVerdict, type RegistryAnalyzeProjection, RenderCorpusToInstructionsOptions, type ReservationTicket, ResultBlobStore, RouterConfig, type RunAgenticOptions, RunPersonifiedOptions, type SandboxCapabilities, SandboxClient, type SandboxLineage, type SandboxLineageHandle, type SandboxRun, SandboxRunAbortError, 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 SuperviseOptions, SupervisedResult, Supervisor, type SupervisorAgentDeps, type SupervisorProfile, type SurfaceScore, ToolLoopChat, 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, completionAuthorizes, contentAddress, createBudgetPool, createInMemoryRunContext, createInbox, createMcpEnvironment, createPushTraceSource, createSandboxLineage, createScope, createScopeAnalyst, createShapeRegistry, createSupervisor, createVerifierEnvironment, createWaterfallCollector, decodeToolPart, defaultAnalystInstruction, defaultAuditorInstruction, defaultDelegateBudget, defaultProfileRichnessThresholds, defaultSelectWinner, defaultToolDetectors, definePersona, defineStrategy, delegate, depthStrategy, deterministicCompletion, discriminatingMeans, driverAgent, dumbDriver, equalKOnCost, extractLlmCallEvent, fanout, finalizeBestDelivered, flatWidenGate, gitWorkspace, harvestCorpus, inProcessSandboxClient, inlineSandboxClient, jjWorkspace, localShell, loopDispatch, loopUntil, mapSandboxEvent, naiveDriver, observe, openSandboxRun, panel, pickChampion, pipeline, printBenchmarkReport, probeSandboxCapabilities, profileRichnessFinding, promotionGate, refine, registerShape, registryScopeAnalyst, renderAnytimeTable, renderCorpusToInstructions, renderReport, reportLoopUsage, runAgentic, runBenchmark, runInWorkspace, runLoop, runPersonified, runStrategyEvolution, sample, sampleThenRefine, sandboxSessionTraceSource, selectChampion, selectValidWinner, sentinelCompletion, serveCoordinationMcp, settledToIteration, spendFromUsageEvents, stopSentinel, strategyAuthorContract, supervise, supervisorAgent, supervisorInstructions, trajectoryReport, verify, watchTrace, widen, workerFromBackend };
+export { Agent, AgentRunSpec, 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, CombinatorShape, type CompletionAnalyst, type CompletionEvidence, type CompletionPolicy, type CompletionVerdict, CoordinationEvent, type CoordinationMcpHandle, Corpus, CorpusFilter, CorpusRecord, type CreateScopeAnalystOptions, type CriuCapableClient, DefinePersonaInput, 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, 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, Iteration, 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 OpenSandboxRunOptions, Outcome, OutputAdapter, PanelSpec, Persona, PipelineStage, type ProfileRichness, type ProfileRichnessThresholds, type PromotionGateOptions, type PromotionVerdict, type RegistryAnalyzeProjection, RenderCorpusToInstructionsOptions, type ReservationTicket, ResultBlobStore, RouterConfig, type RunAgenticOptions, RunPersonifiedOptions, type SandboxCapabilities, SandboxClient, type SandboxLineage, type SandboxLineageHandle, type SandboxRun, SandboxRunAbortError, 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 SuperviseOptions, SupervisedResult, Supervisor, type SupervisorAgentDeps, type SupervisorProfile, type SurfaceScore, 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, completionAuthorizes, contentAddress, createBudgetPool, createInMemoryRunContext, createInbox, createMcpEnvironment, createPushTraceSource, createSandboxLineage, createScope, createScopeAnalyst, createShapeRegistry, createSupervisor, createVerifierEnvironment, createWaterfallCollector, decodeToolPart, defaultAnalystInstruction, defaultAuditorInstruction, defaultDelegateBudget, defaultProfileRichnessThresholds, defaultSelectWinner, defaultToolDetectors, definePersona, defineStrategy, delegate, depthStrategy, deterministicCompletion, discriminatingMeans, driverAgent, dumbDriver, equalKOnCost, extractLlmCallEvent, fanout, finalizeBestDelivered, flatWidenGate, gitWorkspace, harvestCorpus, inProcessSandboxClient, inlineSandboxClient, jjWorkspace, localShell, loopDispatch, loopUntil, mapSandboxEvent, naiveDriver, observe, openSandboxRun, panel, pickChampion, pipeline, printBenchmarkReport, probeSandboxCapabilities, profileRichnessFinding, promotionGate, refine, registerShape, registryScopeAnalyst, renderAnytimeTable, renderCorpusToInstructions, renderReport, reportLoopUsage, runAgentic, runBenchmark, runInWorkspace, runLoop, runPersonified, runStrategyEvolution, sample, sampleThenRefine, sandboxSessionTraceSource, selectChampion, selectValidWinner, sentinelCompletion, serveCoordinationMcp, settledToIteration, spendFromUsageEvents, stopSentinel, strategyAuthorContract, supervise, supervisorAgent, supervisorInstructions, trajectoryReport, verify, watchTrace, widen, workerFromBackend };

package/dist/loops.js

@@ -76,7 +76,7 @@ import {
   watchTrace,
   widen,
   worktreeFanout
-} from "./chunk-75V2XXYJ.js";
+} from "./chunk-AG335EXG.js";
 import {
   InMemoryResultBlobStore,
   InMemorySpawnJournal,
@@ -118,7 +118,7 @@ import {
   supervisorAgent,
   supervisorInstructions,
   workerFromBackend
-} from "./chunk-TSDKBFZP.js";
+} from "./chunk-KRULXIWS.js";
 import "./chunk-VMNEQHJR.js";
 import {
   createAgentEnvironmentProviderRegistry,

package/dist/mcp/bin.js

@@ -9,7 +9,7 @@ import {
   DelegationTaskQueue,
   FileDelegationStore,
   createMcpServer
-} from "../chunk-TSDKBFZP.js";
+} from "../chunk-KRULXIWS.js";
 import "../chunk-VMNEQHJR.js";
 import "../chunk-Z3RRRPRB.js";
 import "../chunk-T2HVQVB4.js";

package/dist/mcp/index.d.ts

@@ -1,10 +1,10 @@
 import { S as SandboxClient, d as LoopSandboxPlacement } from '../types-BF-MEsQB.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-BoEPhGas.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-BoEPhGas.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-DCmljYDf.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-DCmljYDf.js';
 import { L as LocalHarness, r as runLocalHarness } from '../local-harness-DU7yV6mG.js';
 export { a as LocalHarnessResult, R as RunLocalHarnessOptions } from '../local-harness-DU7yV6mG.js';
-import { G as GitRunner } from '../worktree-CpptK3oF.js';
-export { C as CreateWorktreeOptions, D as DiffOptions, a as DiffResult, R as RemoveWorktreeOptions, W as WorktreeHandle, c as captureWorktreeDiff, b as createWorktree, r as removeWorktree } from '../worktree-CpptK3oF.js';
+import { G as GitRunner } from '../worktree-harness-Bmho9SH0.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-Bmho9SH0.js';
 export { C as CreateKbGateOptions, F as FactCandidate, a as FactJudge, b as FactJudgeVerdict, K as KbGateResult, c as createKbGate } from '../kb-gate-CuzMYGYM.js';
 export { m as mcpToolsForRuntimeMcp, a as mcpToolsForRuntimeMcpSubset } from '../openai-tools-B-3v06BE.js';
 import { AnalystFinding } from '@tangle-network/agent-eval';
@@ -13,7 +13,7 @@ import '@tangle-network/sandbox';
 import '../types-C1sozrte.js';
 import '@tangle-network/agent-interface';
 import '../otel-export-BKmNwiCb.js';
-import '../router-client-CMAWGv1h.js';
+import '../router-client-Ak2IGuXq.js';
 import '../environment-provider.js';
 import '@tangle-network/agent-interface/environment-provider';
 import 'node:child_process';

package/dist/mcp/index.js

@@ -6,7 +6,7 @@ import {
 import {
   mcpToolsForRuntimeMcp,
   mcpToolsForRuntimeMcpSubset
-} from "../chunk-SONQUREI.js";
+} from "../chunk-PVPFDTO3.js";
 import {
   createKbGate
 } from "../chunk-FNMGYYSS.js";
@@ -14,7 +14,7 @@ import {
   assertTraceDerivedFindings,
   runCoderChecks,
   selectValidWinner
-} from "../chunk-75V2XXYJ.js";
+} from "../chunk-AG335EXG.js";
 import {
   DELEGATE_DESCRIPTION,
   DELEGATE_FEEDBACK_DESCRIPTION,
@@ -64,7 +64,7 @@ import {
   validateDelegateUiAuditArgs,
   validateDelegationHistoryArgs,
   validateDelegationStatusArgs
-} from "../chunk-TSDKBFZP.js";
+} from "../chunk-KRULXIWS.js";
 import "../chunk-VMNEQHJR.js";
 import {
   deleteBoxSafe,

package/dist/{router-client-CMAWGv1h.d.ts → router-client-Ak2IGuXq.d.ts}

@@ -23,6 +23,38 @@ type ToolLoopChat = (messages: ReadonlyArray<Msg>, tools: ReadonlyArray<ToolSpec
      *  into a conserved pool (the supervisor brain). `runBrainLoop` itself ignores it. */
     costUsd?: number;
 }>;
+/** Self-compaction — bound the loop's OWN context window the way a fresh-respawn (dumb-Ralph) loop
+ *  does, but in place. A stateless chat API re-sends the WHOLE running conversation every turn, so an
+ *  agent that accumulates dozens of turns of tool results re-bills its entire transcript on every
+ *  inference — the context-overflow-one-level-up that the conserved budget pool cannot fix. With
+ *  compaction set, once the conversation exceeds `thresholdTokens` the accumulated middle (every prior
+ *  assistant turn + tool result) is distilled into ONE compact progress note and the conversation is
+ *  reset to `[...head, digest]`: the preserved head (system + the original task) survives, the stale
+ *  turn-by-turn history does not. The model keeps deciding; it stops re-billing the whole transcript.
+ *  Fires at a CLEAN turn boundary (after a turn's tool results are folded in, before the next
+ *  inference) so it never orphans an assistant `tool_calls` from its `tool` replies. */
+interface ToolLoopCompaction {
+    /** Compact once the estimated token count of the conversation exceeds this. */
+    readonly thresholdTokens: number;
+    /** Distill the conversation into a compact progress note that REPLACES the middle. Receives the
+     *  full conversation (so it can summarize everything done so far); returns the digest string. */
+    readonly distill: (messages: ReadonlyArray<Msg>) => Promise<string> | string;
+    /** Leading messages preserved verbatim (system + the original task). Default 2. */
+    readonly preserveHead?: number;
+    /** Token estimator over the conversation. Default ≈ chars/4 (incl. tool-call arguments). */
+    readonly estimateTokens?: (messages: ReadonlyArray<Msg>) => number;
+    /** Notified each time a compaction fires — for observability/metering. */
+    readonly onCompact?: (info: {
+        turn: number;
+        beforeTokens: number;
+        afterTokens: number;
+    }) => void;
+}
+/** Public supervisor-facing compaction config: same knobs as the primitive, but `distill` is optional
+ *  because the supervisor has a default digest that combines a brain note with live worker state. */
+type ToolLoopCompactionOptions = Omit<ToolLoopCompaction, 'distill'> & {
+    readonly distill?: ToolLoopCompaction['distill'];
+};
 
 /**
  * The one router chat client: direct OpenAI-compatible completions through the
@@ -161,4 +193,4 @@ declare function routerBrain(cfg: RouterConfig, opts?: {
     temperature?: number;
 }): ToolLoopChat;
 
-export { type RouterConfig as R, type ToolSpec as T, type ToolLoopChat as a, type RouterChatResult as b, type RouterChatToolsResult as c, type RouterToolCall as d, type RouterToolLoopResult as e, routerChatWithTools as f, routerChatWithUsage as g, routerToolLoop as h, routerBrain as r };
+export { type RouterConfig as R, type ToolSpec as T, type ToolLoopChat as a, type ToolLoopCompactionOptions as b, type RouterChatResult as c, type RouterChatToolsResult as d, type RouterToolCall as e, type RouterToolLoopResult as f, type ToolLoopCompaction as g, routerChatWithTools as h, routerChatWithUsage as i, routerToolLoop as j, routerBrain as r };

package/dist/{worktree-fanout-CtQrRDME.d.ts → worktree-fanout-CXGzHET4.d.ts}

@@ -3,7 +3,7 @@ import { AnalystFinding, DefaultVerdict } from '@tangle-network/agent-eval';
 import { A as AgentSpec, b as ExecutorRegistry, B as Budget, c as Agent, S as SpawnJournal, d as ResultBlobStore, e as RootHandle, f as SupervisedResult, N as NodeId, g as Settled, h as Spend, i as Scope, a as Executor } from './types-C1sozrte.js';
 import { R as RuntimeHooks, I as Iteration } from './types-BF-MEsQB.js';
 import { BackendType } from '@tangle-network/sandbox';
-import { G as GitRunner, d as DeliverableSpec } from './worktree-CpptK3oF.js';
+import { W as WorktreeHarnessResult, G as GitRunner, a as WorktreeCheckRunner, D as DeliverableSpec } from './worktree-harness-Bmho9SH0.js';
 import { L as LocalHarness, r as runLocalHarness } from './local-harness-DU7yV6mG.js';
 
 /**
@@ -785,77 +785,6 @@ interface CoderCheckConstraints {
     forbiddenPaths?: string[];
 }
 
-/**
- * @experimental
- *
- * The ONE worktree-harness execution core. The physical act — run a supervisor-authored
- * `AgentProfile` on a local coding-harness CLI (claude / codex / opencode) against a fresh git
- * worktree off `repoRoot`, capture the diff, derive the test/typecheck PASS signals, then clean
- * up — lives here ONCE. Two executors adapt it to two ports without re-implementing it:
- *   - `createWorktreeCliExecutor` — the `Scope`/`Supervisor` leaf `Executor`.
- *   - `createInProcessExecutor`   — the `runLoop` `SandboxClient` / coder-delegate path.
- *
- * §1.5 by construction: the authored `profile.prompt.systemPrompt` + `profile.model.default`
- * reach the harness through `harnessInvocation` HERE, so neither port can drop them — the exact
- * bug that existed while the in-process path called `runLocalHarness` with only the task prompt.
- *
- * Lifecycle: `createWorktree` → `harnessInvocation` + `runLocalHarness` → `captureWorktreeDiff`
- * (BEFORE checks, so the patch is the harness's output, not polluted by files a test run writes)
- * → the configured test/typecheck commands in the live worktree → return the result + a `cleanup`
- * the caller invokes at its own teardown point. A throw cleans up before propagating, so a failed
- * run never leaks a worktree.
- */
-
-/** 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 a deliverable gate / coder output reads. */
-    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;
-}
-/** The canonical result of one worktree-harness run, projected by each port to its own shape. */
-interface WorktreeHarnessResult {
-    /** 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. */
-    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 (present only when commands were given). */
-    checks?: {
-        tests?: WorktreeCommandResult;
-        typecheck?: WorktreeCommandResult;
-    };
-}
-/** The single shell-command-in-worktree runner seam (replaces the per-executor copies). */
-type WorktreeCheckRunner = (opts: {
-    command: string;
-    cwd: string;
-    timeoutMs: number;
-    signal?: AbortSignal;
-}) => Promise<{
-    exitCode: number | null;
-    output: string;
-}>;
-
 /**
  * @experimental
  *
@@ -907,6 +836,8 @@ interface WorktreeCliExecutorOptions {
     typecheckCmd?: string;
     /** Wall-clock cap per verification command (ms). Default = `harnessTimeoutMs` or 5 min. */
     checkTimeoutMs?: number;
+    /** Cap on each check's captured output. Default 16k. */
+    checkOutputCap?: 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`. */
@@ -1038,4 +969,4 @@ interface WorktreeFanoutOptions extends PatchDeliverableOptions {
  */
 declare function worktreeFanout<Task>(options: WorktreeFanoutOptions): CombinatorShape<Task, WorktreePatchArtifact>;
 
-export { type Widen as $, type AuthoredHarness as A, type Panel as B, type CorpusRecord as C, type DefinePersonaInput as D, type EqualKArm as E, type FanoutOptions as F, type PanelJudge as G, type PanelVerdict as H, type PatchDeliverableOptions as I, type PersonaContext as J, type PersonaExecutors as K, type LoopUntilSpec as L, type Pipeline as M, type RenderCorpusToInstructions as N, type Outcome as O, type PanelSpec as P, type RunPersonified as Q, type RenderCorpusToInstructionsOptions as R, type ScopeAnalyzeInput as S, type TrajectoryReportOptions as T, type ShapeBudget as U, type VerifySpec as V, type WinnerStrategy as W, type ShapeContext as X, type TrajectoryNode as Y, type TrajectoryReportFn as Z, type Verify as _, type WorktreeFanoutOptions as a, type WidenDecision as a0, type WidenLineage as a1, type WorktreeCliExecutorOptions as a2, type WorktreeCommandResult as a3, createWorktreeCliExecutor as a4, patchDelivered as a5, worktreeFanout as a6, type WorktreePatchArtifact as b, type Corpus as c, type AssertTraceDerivedFindings as d, type SteerContext as e, type ScopeAnalyst as f, type CombinatorShape as g, type ScopeWidenGate as h, type PipelineStage as i, type FanoutWinnerSelector as j, type WidenSpec as k, type CorpusFilter as l, type Persona as m, type RunPersonifiedOptions as n, type ShapeRegistry as o, type LoopShape as p, type EqualKOnCostOptions as q, type EqualKVerdict as r, type TrajectoryReport as s, type DefinePersona as t, type EqualKOnCost as u, type Fanout as v, type FanoutSynthesis as w, type FlatWidenGate as x, type LoopUntil as y, type LoopUntilState as z };
+export { type Widen as $, type AuthoredHarness as A, type Panel as B, type CorpusRecord as C, type DefinePersonaInput as D, type EqualKArm as E, type FanoutOptions as F, type PanelJudge as G, type PanelVerdict as H, type PatchDeliverableOptions as I, type PersonaContext as J, type PersonaExecutors as K, type LoopUntilSpec as L, type Pipeline as M, type RenderCorpusToInstructions as N, type Outcome as O, type PanelSpec as P, type RunPersonified as Q, type RenderCorpusToInstructionsOptions as R, type ScopeAnalyzeInput as S, type TrajectoryReportOptions as T, type ShapeBudget as U, type VerifySpec as V, type WinnerStrategy as W, type ShapeContext as X, type TrajectoryNode as Y, type TrajectoryReportFn as Z, type Verify as _, type WorktreeFanoutOptions as a, type WidenDecision as a0, type WidenLineage as a1, type WorktreeCliExecutorOptions as a2, createWorktreeCliExecutor as a3, patchDelivered as a4, worktreeFanout as a5, type WorktreePatchArtifact as b, type Corpus as c, type AssertTraceDerivedFindings as d, type SteerContext as e, type ScopeAnalyst as f, type CombinatorShape as g, type ScopeWidenGate as h, type PipelineStage as i, type FanoutWinnerSelector as j, type WidenSpec as k, type CorpusFilter as l, type Persona as m, type RunPersonifiedOptions as n, type ShapeRegistry as o, type LoopShape as p, type EqualKOnCostOptions as q, type EqualKVerdict as r, type TrajectoryReport as s, type DefinePersona as t, type EqualKOnCost as u, type Fanout as v, type FanoutSynthesis as w, type FlatWidenGate as x, type LoopUntil as y, type LoopUntilState as z };