@tangle-network/agent-runtime 0.54.0 → 0.56.0

package/dist/{coder-CEkUFv8h.d.ts → coder-CdsknxGF.d.ts}

@@ -1,5 +1,6 @@
 import { AgentProfile } from '@tangle-network/sandbox';
 import { O as OutputAdapter, V as Validator, A as AgentRunSpec, D as Driver } from './types-C8rNlxfV.js';
+import { DefaultVerdict } from '@tangle-network/agent-eval';
 
 /**
  * @experimental
@@ -102,13 +103,64 @@ interface MultiHarnessCoderFanoutOptions {
     /** Optional per-harness model override. Indexed parallel to `harnesses`. */
     models?: (string | undefined)[];
 }
-/** @experimental */
+/**
+ * @deprecated Prefer the generic recursive combinator `worktreeCoderFanout(...)`
+ *   (`@tangle-network/agent-runtime/runtime`): a `fanout` of authored harness profiles on their
+ *   own worktree-CLI leaves, each `gateOnDeliverable(coderDeliverable(...))`, winner via
+ *   a valid-only `selectWinner` strategy (not `defaultSelectWinner`, whose non-valid fallback surfaces an ungated patch). This `runLoop`-driver form is retained as
+ *   the SANDBOX-session topology `createDefaultCoderDelegate` drives and is re-exported for
+ *   published consumers; it is not the canonical path for new code.
+ *
+ * @experimental
+ */
 declare function multiHarnessCoderFanout(options?: MultiHarnessCoderFanoutOptions): {
     agentRuns: AgentRunSpec<CoderTask>[];
     output: OutputAdapter<CoderOutput>;
     validator: Validator<CoderOutput>;
     driver: Driver<CoderTask, CoderOutput, 'pick-winner' | 'fail'>;
 };
+/** @experimental Inputs the mechanical coder gate decides on — a captured patch plus the
+ *  test/typecheck PASS signals derived for it. Shared by `createCoderValidator` (sandbox-event
+ *  shape) and the generic worktree-CLI deliverable (which derives `testsPassed`/`typecheckPassed`
+ *  by running the commands in the worktree). */
+interface CoderCheckInput {
+    /** The unified diff produced by the run. */
+    patch: string;
+    /** Did `testCmd` exit clean? */
+    testsPassed: boolean;
+    /** Did `typecheckCmd` exit clean? */
+    typecheckPassed: boolean;
+}
+/** @experimental The per-task constraints the mechanical gate enforces. */
+interface CoderCheckConstraints {
+    /** Default 400. Hard cap; gate fails when exceeded. */
+    maxDiffLines?: number;
+    /** Literal path prefixes the patch must not touch. */
+    forbiddenPaths?: string[];
+}
+/**
+ * @experimental
+ *
+ * The pure mechanical coder gate — the SINGLE source of the no-op / secret-path floor /
+ * diff-size / forbidden-path / test / typecheck checks. No I/O: it scores a patch + its
+ * already-derived pass signals. Both the `createCoderValidator` shim (sandbox `CoderOutput`)
+ * and the generic worktree-CLI `coderDeliverable` (which runs the commands itself) call this,
+ * so the gate logic never forks.
+ *
+ * Checks in order: (1) no-op rejection, (2) always-on secret-path floor (independent of
+ * `forbiddenPaths`), (3) forbidden-path, (4) diff-size cap, (5) tests, (6) typecheck.
+ * Aggregate score: `0.5*tests + 0.3*typecheck + 0.2*(1 - diffLines/maxDiff)`; `valid` is the
+ * conjunction of all six.
+ */
+declare function runCoderChecks(input: CoderCheckInput, constraints?: CoderCheckConstraints): DefaultVerdict;
+/**
+ * The sandbox `CoderOutput` validator. A thin shim over the shared {@link runCoderChecks} gate
+ * (the single source of the no-op / secret-floor / forbidden / diff-size / test / typecheck logic),
+ * adapting the sandbox-parsed `CoderOutput` into the gate inputs. On the generic recursive path the
+ * same gate is reached via `coderDeliverable(...)` over the worktree-CLI artifact.
+ *
+ * @experimental
+ */
 declare function createCoderValidator(task: CoderTask): Validator<CoderOutput>;
 
-export { type CoderOutput as C, type MultiHarnessCoderFanoutOptions as M, type CoderProfileOptions as a, type CoderTask as b, coderProfile as c, createCoderValidator as d, multiHarnessCoderFanout as m };
+export { type CoderOutput as C, type MultiHarnessCoderFanoutOptions as M, type CoderCheckConstraints as a, type CoderCheckInput as b, type CoderProfileOptions as c, type CoderTask as d, coderProfile as e, createCoderValidator as f, multiHarnessCoderFanout as m, runCoderChecks as r };

package/dist/{coordination-BMzskrUR.d.ts → coordination-CfMk-RpQ.d.ts}

@@ -2,7 +2,7 @@ import { DefaultVerdict } from '@tangle-network/agent-eval';
 import { AgentProfile, BackendType } from '@tangle-network/sandbox';
 import { R as RuntimeHooks } from './runtime-hooks-C7JwKb9E.js';
 import { d as LoopTokenUsage } from './types-C8rNlxfV.js';
-import { b as DelegateFeedbackArgs, c as DelegationFeedbackSnapshot, d as DelegationTaskQueue, e as CoderDelegate, R as ResearcherDelegate, U as UiAuditorDelegate, T as TraceContext } from './delegates-BPLIl8EC.js';
+import { b as DelegateFeedbackArgs, c as DelegationFeedbackSnapshot, d as DelegationTaskQueue, e as CoderDelegate, R as ResearcherDelegate, U as UiAuditorDelegate, T as TraceContext } from './delegates-htF7l_H6.js';
 
 /**
  * @experimental
@@ -436,6 +436,85 @@ interface WidenGate<Out> {
     readonly judgeExempt?: boolean;
 }
 
+/**
+ * @experimental
+ *
+ * Git worktree helpers for the in-process delegation executor. Each
+ * delegation runs in its own worktree so multiple parallel harness
+ * subprocesses (claude / codex / opencode in a 3-way fanout) don't clobber
+ * each other's edits on the shared workspace.
+ *
+ * Worktrees live under `<repoRoot>/.coder-variants/<runId>/`. After the
+ * harness exits + the diff is captured, the worktree is removed.
+ *
+ * All operations spawn `git` via `child_process.spawn` synchronously
+ * (via a `runGit` helper). Stays narrow on purpose: no working-tree
+ * staging, no commits, no rebases.
+ */
+/** @experimental */
+interface WorktreeHandle {
+    /** Absolute path to the worktree directory. */
+    path: string;
+    /** SHA the worktree was created at. */
+    baseSha: string;
+    /** Branch name created for this worktree (typically `delegate/<runId>`). */
+    branch: string;
+}
+/** @experimental */
+interface CreateWorktreeOptions {
+    /** Absolute path to the main git checkout. */
+    repoRoot: string;
+    /** Unique id for the worktree path + branch. Use the delegation run id. */
+    runId: string;
+    /** Parent directory the worktree lives under. Defaults to `.coder-variants`. */
+    variantsDir?: string;
+    /** Override the base ref (default `HEAD`). */
+    baseRef?: string;
+    /** Test seam — inject a custom git runner. */
+    runGit?: GitRunner;
+}
+/** @experimental */
+interface DiffOptions {
+    /** Worktree to diff. */
+    worktree: WorktreeHandle;
+    /** What to compare against. Default `worktree.baseSha`. */
+    baseRef?: string;
+    /** Test seam. */
+    runGit?: GitRunner;
+}
+/** @experimental */
+interface DiffResult {
+    patch: string;
+    stats: {
+        filesChanged: number;
+        insertions: number;
+        deletions: number;
+    };
+}
+/** @experimental */
+interface RemoveWorktreeOptions {
+    worktree: WorktreeHandle;
+    repoRoot: string;
+    /** Force removal even if dirty (default true; the loser of a fanout has uncommitted changes). */
+    force?: boolean;
+    /** Test seam. */
+    runGit?: GitRunner;
+}
+/** Pluggable git runner (sync) — replaceable in tests. */
+type GitRunner = (args: ReadonlyArray<string>, opts: {
+    cwd: string;
+}) => {
+    stdout: string;
+    stderr: string;
+    exitCode: number;
+};
+/** @experimental */
+declare function createWorktree(options: CreateWorktreeOptions): Promise<WorktreeHandle>;
+/** @experimental */
+declare function captureWorktreeDiff(options: DiffOptions): Promise<DiffResult>;
+/** @experimental */
+declare function removeWorktree(options: RemoveWorktreeOptions): Promise<void>;
+
 /**
  * @experimental
  *
@@ -701,4 +780,4 @@ interface CoordinationTools {
 /** Build the driver's MCP tools over a live scope. */
 declare function createCoordinationTools(opts: CoordinationToolsOptions): CoordinationTools;
 
-export { type AnalystRegistry as A, type Budget as B, type CoordinationEvent as C, type Supervisor as D, type ExecutorRegistry as E, type FeedbackStore as F, type ExecutorContext as G, type ExecutorResult as H, InMemoryFeedbackStore as I, type JsonRpcMessage as J, type Handle as K, type NodeSnapshot as L, type MakeWorkerAgent as M, type NodeId as N, type NodeStatus as O, type Restart as P, type Question as Q, type ResultBlobStore as R, type SettledWorker as S, type TreeView as T, type UsageEvent as U, type RootSignal as V, type Runtime as W, type SpawnOpts as X, type SupervisorOpts as Y, type WidenGate as Z, type CoordinationTools as a, type CoordinationToolsOptions as b, type FeedbackEvent as c, type JsonRpcResponse as d, type McpServer as e, type McpServerOptions as f, type McpToolDescriptor as g, type McpTransport as h, type QuestionDecision as i, type QuestionPolicy as j, type QuestionRecord as k, createCoordinationTools as l, createInProcessTransport as m, createMcpServer as n, eventToSnapshot as o, type SpawnJournal as p, type SpawnEvent as q, type Settled as r, type AgentSpec as s, type Agent as t, type RootHandle as u, type SupervisedResult as v, type Spend as w, type Scope as x, type ExecutorFactory as y, type Executor as z };
+export { type NodeSnapshot as $, type AnalystRegistry as A, type Budget as B, type CoordinationEvent as C, type DiffOptions as D, type ExecutorRegistry as E, type FeedbackStore as F, type GitRunner as G, type RootHandle as H, InMemoryFeedbackStore as I, type JsonRpcMessage as J, type SupervisedResult as K, type Spend as L, type MakeWorkerAgent as M, type NodeId as N, type Scope as O, type ExecutorFactory as P, type Question as Q, type RemoveWorktreeOptions as R, type SettledWorker as S, type TreeView as T, type Executor as U, type UsageEvent as V, type WorktreeHandle as W, type Supervisor as X, type ExecutorContext as Y, type ExecutorResult as Z, type Handle as _, type CoordinationTools as a, type NodeStatus as a0, type Restart as a1, type RootSignal as a2, type Runtime as a3, type SpawnOpts as a4, type SupervisorOpts as a5, type WidenGate as a6, type CoordinationToolsOptions as b, type CreateWorktreeOptions as c, type DiffResult as d, type FeedbackEvent as e, type JsonRpcResponse as f, type McpServer as g, type McpServerOptions as h, type McpToolDescriptor as i, type McpTransport as j, type QuestionDecision as k, type QuestionPolicy as l, type QuestionRecord as m, captureWorktreeDiff as n, createCoordinationTools as o, createInProcessTransport as p, createMcpServer as q, createWorktree as r, eventToSnapshot as s, removeWorktree as t, type ResultBlobStore as u, type SpawnJournal as v, type SpawnEvent as w, type Settled as x, type AgentSpec as y, type Agent as z };

package/dist/{delegates-BPLIl8EC.d.ts → delegates-htF7l_H6.d.ts}

@@ -1,4 +1,4 @@
-import { C as CoderOutput, b as CoderTask } from './coder-CEkUFv8h.js';
+import { C as CoderOutput, d as CoderTask } from './coder-CdsknxGF.js';
 import { g as LoopTraceEmitter, e as LoopTraceEvent, S as SandboxClient, A as AgentRunSpec } from './types-C8rNlxfV.js';
 import { SandboxEvent, SandboxInstance } from '@tangle-network/sandbox';
 import { AgentEvalError } from '@tangle-network/agent-eval';
@@ -1459,6 +1459,18 @@ interface CreateDefaultCoderDelegateOptions {
  * sandbox client + coder profile. When `args.variants > 1` it switches
  * to the multi-harness fanout topology.
  *
+ * This is the SANDBOX-SESSION coder path: workers run the in-box harness via the
+ * `SandboxClient`'s `streamPrompt`, and single-variant turns can dispatch DETACHED
+ * (driveTurn ticks) so a durable queue resumes them across an MCP restart — a substrate
+ * the recursive worktree-CLI leaf does not yet have a journal-replay equivalent for.
+ *
+ * @deprecated Prefer the generic recursive path for NEW local-repo coding work: author an
+ *   `AgentProfile` per harness and run `worktreeCoderFanout(...)` (the `fanout` of
+ *   `createWorktreeCliExecutor` leaves, each `gateOnDeliverable(coderDeliverable(...))`, winner
+ *   via a valid-only `selectWinner`) through `runPersonified`. This factory stays as the injection seam
+ *   `createMcpServer` consumes for SANDBOX-session delegation + detached resume; it will remain
+ *   until the worktree-CLI leaf grows the detached-tick resume equivalent.
+ *
  * @experimental
  */
 declare function createDefaultCoderDelegate(options: CreateDefaultCoderDelegateOptions): CoderDelegate;
@@ -1489,6 +1501,12 @@ interface SettleDetachedCoderTurnOptions {
  * then the optional reviewer. Throws when nothing survives — a resumed or
  * detached run must not return an unvalidated patch.
  *
+ * SCOPE NOTE (detached/resume): the detached `driveTurn`-tick + cross-restart resume path is
+ * bound to the `runLoop` + sandbox-session substrate. The recursive `Scope`/worktree-CLI leaf has
+ * journal→replay but no driveTurn-over-a-detached-sandbox-session equivalent yet, so resume is NOT
+ * advertised on the generic `worktreeCoderFanout` path. This helper (with `coderTaskFromArgs` and
+ * `createDriveTurnResumeDriver`) stays as the resume seam `bin.ts` wires for in-flight records.
+ *
  * @experimental
  */
 declare function settleDetachedCoderTurn(turn: DetachedTurn, options: SettleDetachedCoderTurnOptions): Promise<CoderOutput>;

package/dist/improvement.d.ts

@@ -1,5 +1,5 @@
 import { AnalystFinding } from '@tangle-network/agent-eval';
-import { L as LocalHarness, r as runLocalHarness } from './local-harness-KrdFTY5R.js';
+import { L as LocalHarness, r as runLocalHarness } from './local-harness-BE_h8szs.js';
 import { LabeledScenarioStore, WorktreeAdapter, ImprovementDriver } from '@tangle-network/agent-eval/campaign';
 import { S as SurfaceImprovementEdit } from './improvement-adapter-BC4HhuAR.js';
 import { I as ImprovementAdapter } from './types-p8dWBIXL.js';

package/dist/improvement.js

@@ -1,6 +1,6 @@
 import {
   runLocalHarness
-} from "./chunk-GLR25NG7.js";
+} from "./chunk-GLMFBUKT.js";
 import "./chunk-DGUM43GV.js";
 
 // src/improvement/agentic-generator.ts

package/dist/index.d.ts

@@ -3,16 +3,16 @@ export { AgentEvalError, AgentEvalErrorCode, ConfigError, ControlBudget, Control
 import { h as AgentBackendInput, i as AgentExecutionBackend, c as OpenAIChatTool, j as OpenAIChatToolChoice, k as AgentBackendContext, R as RuntimeStreamEvent, K as KnowledgeReadinessDecision, l as RunAgentTaskOptions, m as AgentTaskRunResult, n as RunAgentTaskStreamOptions, o as AgentRuntimeEvent, p as AgentTaskStatus, q as RuntimeSessionStore, r as RuntimeSession } from './types-C8rNlxfV.js';
 export { s as AgentAdapter, t as AgentKnowledgeProvider, u as AgentRuntimeEventSink, v as AgentTaskContext, w as AgentTaskSpec, B as BackendErrorDetail, x as RuntimeRunHandle, y as RuntimeRunPersistenceAdapter, z as RuntimeRunRow, C as startRuntimeRun } from './types-C8rNlxfV.js';
 import { Scenario, ProfileDispatchFn } from '@tangle-network/agent-eval/campaign';
-export { C as CoderLoopRunnerOptions, 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, h as auditLoopRunner, i as coderLoopRunner, j as isDelegatedLoopMode, p as parseLoopRunnerArgv, r as researchLoopRunner, k as reviewLoopRunner, l as runDelegatedLoop, m as runLoopRunnerCli, s as selfImproveLoopRunner } from './loop-runner-bin-BGpVVyXp.js';
+export { C as CoderLoopRunnerOptions, 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, h as auditLoopRunner, i as coderLoopRunner, j as isDelegatedLoopMode, p as parseLoopRunnerArgv, r as researchLoopRunner, k as reviewLoopRunner, l as runDelegatedLoop, m as runLoopRunnerCli, s as selfImproveLoopRunner } from './loop-runner-bin-C4YyFGdT.js';
 export { m as mcpToolsForRuntimeMcp, a as mcpToolsForRuntimeMcpSubset } from './openai-tools-CoeLQ7Uo.js';
-export { ax as EvalRunEvent, ay as EvalRunGeneration, az as EvalRunsExportConfig, aA as EvalRunsExportResult, aB as INTELLIGENCE_WIRE_VERSION, aC as LoopSpanNode, aD as OtelAttribute, aE as OtelExportConfig, aF as OtelExporter, aG as OtelSpan, aH as buildLoopOtelSpans, aI as buildLoopSpanNodes, aJ as createOtelExporter, aK as exportEvalRuns, aL as loopEventToOtelSpan } from './delegates-BPLIl8EC.js';
+export { ax as EvalRunEvent, ay as EvalRunGeneration, az as EvalRunsExportConfig, aA as EvalRunsExportResult, aB as INTELLIGENCE_WIRE_VERSION, aC as LoopSpanNode, aD as OtelAttribute, aE as OtelExportConfig, aF as OtelExporter, aG as OtelSpan, aH as buildLoopOtelSpans, aI as buildLoopSpanNodes, aJ as createOtelExporter, aK as exportEvalRuns, aL as loopEventToOtelSpan } from './delegates-htF7l_H6.js';
 import { R as RuntimeHooks } from './runtime-hooks-C7JwKb9E.js';
 export { b as RuntimeDecisionEvidenceRef, c as RuntimeDecisionKind, d as RuntimeDecisionPoint, e as RuntimeHookContext, f as RuntimeHookErrorContext, a as RuntimeHookEvent, g as RuntimeHookPhase, h as RuntimeHookTarget, i as composeRuntimeHooks, j as defineRuntimeHooks, n as notifyRuntimeDecisionPoint, k as notifyRuntimeHookEvent } from './runtime-hooks-C7JwKb9E.js';
 import '@tangle-network/sandbox';
 import '@tangle-network/agent-eval/contract';
 import './types-p8dWBIXL.js';
 import './kb-gate-CuzMYGYM.js';
-import './coder-CEkUFv8h.js';
+import './coder-CdsknxGF.js';
 import './substrate-CUgk7F7s.js';
 
 /**

package/dist/index.js

@@ -1,7 +1,7 @@
 import {
   mcpToolsForRuntimeMcp,
   mcpToolsForRuntimeMcpSubset
-} from "./chunk-KJH62YEK.js";
+} from "./chunk-A265AJ2Q.js";
 import {
   DEFAULT_ROUTER_BASE_URL,
   cleanModelId,
@@ -21,17 +21,17 @@ import {
   runDelegatedLoop,
   runLoopRunnerCli,
   selfImproveLoopRunner
-} from "./chunk-2BDXWZUC.js";
+} from "./chunk-5ZOYQWEB.js";
 import "./chunk-FNMGYYSS.js";
-import "./chunk-A73RADPB.js";
-import "./chunk-KADIJAD4.js";
+import "./chunk-GFDCNQRO.js";
 import "./chunk-P5OKDSLB.js";
 import {
   composeRuntimeHooks,
   defineRuntimeHooks,
   notifyRuntimeDecisionPoint,
   notifyRuntimeHookEvent
-} from "./chunk-JTH2FPCK.js";
+} from "./chunk-ZADWPBOE.js";
+import "./chunk-3BI6PSP3.js";
 import "./chunk-WIR4HOOJ.js";
 import {
   AgentEvalError,
@@ -44,6 +44,7 @@ import {
   SessionMismatchError,
   ValidationError
 } from "./chunk-VLF5RHEQ.js";
+import "./chunk-GLMFBUKT.js";
 import {
   INTELLIGENCE_WIRE_VERSION,
   buildLoopOtelSpans,