@tangle-network/agent-runtime 0.69.0 → 0.70.1

package/dist/{coordination-Curpzeyc.d.ts → coordination-C7WxwHXq.d.ts}

@@ -1,4 +1,4 @@
-import { c as DelegateFeedbackArgs, d as DelegationFeedbackSnapshot, e as DelegationTaskQueue, f as CoderDelegate, R as ResearcherDelegate, U as UiAuditorDelegate, T as TraceContext, A as Agent, S as Scope, g as ResultBlobStore, B as Budget } from './delegates-CLFNAKyi.js';
+import { c as DelegateFeedbackArgs, d as DelegationFeedbackSnapshot, e as DelegationTaskQueue, f as CoderDelegate, R as ResearcherDelegate, U as UiAuditorDelegate, T as TraceContext, A as Agent, S as Scope, g as ResultBlobStore, B as Budget } from './delegates-DqAgo32T.js';
 
 /**
  * @experimental
@@ -358,6 +358,13 @@ interface CoordinationToolsOptions {
      *  the driver can still run lenses on demand via `run_analyst`). Requires `analysts`. */
     readonly analyzeOnSettle?: ReadonlyArray<string>;
 }
+/**
+ * The supervisor-side toolbox returned by {@link createCoordinationTools}: the MCP tool
+ * descriptors a driver `AgentProfile` calls to spawn, steer, observe, and settle workers
+ * over a live `Scope`, plus the typed accessors (`settled`/`questions`/`history`/`stats`/
+ * `raiseFinding`) for the bidirectional coordination bus. This is the live, backend-of-your-
+ * choice, steerable counterpart to the one-shot own-sandbox delegation MCP.
+ */
 interface CoordinationTools {
     readonly tools: McpToolDescriptor[];
     isStopped(): boolean;

package/dist/{delegates-CLFNAKyi.d.ts → delegates-DqAgo32T.d.ts}

@@ -1,10 +1,99 @@
+import { ChildProcess } from 'node:child_process';
 import { DefaultVerdict, AgentEvalError } from '@tangle-network/agent-eval';
 import { AgentProfile } from '@tangle-network/agent-interface';
 import { BackendType, SandboxEvent, SandboxInstance } from '@tangle-network/sandbox';
-import { R as RuntimeHooks } from './runtime-hooks-C7JwKb9E.js';
-import { f as LoopTokenUsage, g as LoopTraceEmitter, d as LoopTraceEvent, S as SandboxClient, A as AgentRunSpec } from './types-Crxftafi.js';
-import { C as CoderTask } from './coder-2leJPOvC.js';
-import { a as UiLens, U as UiFinding } from './substrate-CUgk7F7s.js';
+import { d as LoopTokenUsage, b as RuntimeHooks, e as LoopTraceEmitter, L as LoopTraceEvent, S as SandboxClient, A as AgentRunSpec } from './types-BYa2ZOAx.js';
+import { a as UiLens, U as UiFinding, C as CoderTask } from './substrate-BoRXgvka.js';
+
+/**
+ * @experimental
+ *
+ * Subprocess wrappers for the local coding-harness CLIs installed in the
+ * sandbox image (claude-code, codex, opencode). Used by the in-process
+ * delegation executor (`createInProcessExecutor`) so a `delegate_code` call
+ * spawns a real harness on a real git worktree instead of provisioning a
+ * sibling sandbox.
+ *
+ * All harness invocations:
+ *   - run with `cwd` set to the worktree
+ *   - inherit env from the parent (the MCP server inside the sandbox has
+ *     the harness's auth already)
+ *   - capture stdout/stderr
+ *   - support cancellation via AbortSignal
+ *   - enforce a wall-clock timeout
+ */
+
+/** Local coding harness available inside the sandbox. */
+type LocalHarness = 'claude' | 'codex' | 'opencode';
+/** @experimental */
+interface RunLocalHarnessOptions {
+    harness: LocalHarness;
+    /** Working directory for the subprocess (typically a worktree path). */
+    cwd: string;
+    /** Prompt forwarded as the harness CLI's task argument. */
+    taskPrompt: string;
+    /**
+     * Pre-built command + args (e.g. from `harnessInvocation` so the full authored
+     * `AgentProfile` — systemPrompt + model — reaches the harness). When set it OVERRIDES the
+     * default prompt-only `buildArgs(taskPrompt)` path; `command` defaults to the harness's
+     * default binary when only `args` is supplied. When absent the legacy prompt-only shape
+     * is used unchanged.
+     */
+    invocation?: {
+        command?: string;
+        args: ReadonlyArray<string>;
+    };
+    /** Wall-clock kill deadline (ms). Default 5 min. Subprocess SIGTERMed on expiry. */
+    timeoutMs?: number;
+    /** Caller cancellation. SIGTERM is sent on abort. */
+    signal?: AbortSignal;
+    /** Override env (defaults to inheriting from the parent). */
+    env?: NodeJS.ProcessEnv;
+    /**
+     * Test seam — inject a custom spawner so unit tests can mock the
+     * subprocess without touching the OS. Defaults to node's `child_process.spawn`.
+     */
+    spawn?: (command: string, args: ReadonlyArray<string>, opts: {
+        cwd: string;
+        env: NodeJS.ProcessEnv;
+        stdio: 'pipe';
+    }) => ChildProcess;
+}
+/** @experimental */
+interface LocalHarnessResult {
+    /** OS exit code. `null` when killed before exit. */
+    exitCode: number | null;
+    /** Concatenated stdout. */
+    stdout: string;
+    /** Concatenated stderr. */
+    stderr: string;
+    /** Set when the process exited via signal (timeout / abort). */
+    killedBySignal: NodeJS.Signals | null;
+    /** Wall-clock duration ms (spawn → exit). */
+    durationMs: number;
+    /** Set when timeoutMs elapsed before exit. */
+    timedOut: boolean;
+}
+/**
+ * Spawn a local coding harness CLI as a subprocess + collect its output.
+ *
+ * NOT responsible for parsing the harness's output or extracting a diff —
+ * the in-process executor's `streamPrompt` orchestrates `git diff` against
+ * the worktree after this resolves. This function is intentionally narrow:
+ * spawn, wait, capture, return.
+ *
+ * Fails loud — throws when:
+ *   - `cwd` doesn't exist (subprocess emits ENOENT; surfaced as Error)
+ *   - the harness binary is not on PATH (ENOENT)
+ *
+ * Does NOT throw when:
+ *   - the subprocess exits non-zero (`result.exitCode` carries the code)
+ *   - the subprocess is aborted / timed out (`result.killedBySignal` /
+ *     `result.timedOut` carries the reason)
+ *
+ * @experimental
+ */
+declare function runLocalHarness(options: RunLocalHarnessOptions): Promise<LocalHarnessResult>;
 
 /**
  * @experimental
@@ -76,7 +165,7 @@ interface Executor<Out> {
      */
     execute(task: unknown, signal: AbortSignal): Promise<ExecutorResult<Out>> | AsyncIterable<UsageEvent>;
     /**
-     * Optional inbox: receive an out-of-band message from the driver mid-run (the `send`/`steer_worker`
+     * Optional inbox: receive an out-of-band message from the driver mid-run (the `send`/`steer_agent`
      * verb). A streaming executor drains pending messages between turns and folds them into the next
      * step (a steer / interrupt / resume). A one-shot executor that can't be steered mid-flight omits
      * this; `Scope.send` then returns `false` for it. Never throws — a malformed message is the
@@ -1661,7 +1750,7 @@ declare function removeWorktree(options: RemoveWorktreeOptions): Promise<void>;
  *     session id is deterministic and supplied at submit time, so a process
  *     crash between ticks loses nothing — the turn keeps running in the box.
  *
- *   - {@link createDriveTurnResumeDriver} — the resume side. A
+ *   - {@link createDetachedTurnResumeDriver} — the resume side. A
  *     `DelegationResumeDriver` that re-attaches restored in-flight records to
  *     their detached runs: parse the record's ref, resolve the box, advance the
  *     turn one `driveTurn` pass per `tick()`, and map the SDK's three states
@@ -1803,7 +1892,7 @@ interface RunDetachedTurnOptions {
  */
 declare function runDetachedTurn(options: RunDetachedTurnOptions): Promise<DetachedTurn>;
 /** @experimental */
-interface DriveTurnResumeDriverOptions {
+interface DetachedTurnResumeDriverOptions {
     /**
      * Resolve the live box owning a detached session. The bin wires this to the
      * sandbox client's `get(sandboxId)`; throw when the box no longer exists —
@@ -1850,7 +1939,7 @@ interface DriveTurnResumeDriverOptions {
  *
  * @experimental
  */
-declare function createDriveTurnResumeDriver(options: DriveTurnResumeDriverOptions): DelegationResumeDriver;
+declare function createDetachedTurnResumeDriver(options: DetachedTurnResumeDriverOptions): DelegationResumeDriver;
 
 /**
  * @experimental
@@ -1951,6 +2040,12 @@ declare function createFleetWorkspaceExecutor(options: FleetWorkspaceExecutorOpt
  * Delegate factories — the layer between MCP tool handlers and the
  * underlying `runLoop` runners.
  *
+ * Delegation vs COORDINATION (`../runtime/supervise/coordination-mcp.ts`): delegation runs a coding
+ * task INSIDE the agent's OWN sandbox environment — a sibling box on its own `SandboxClient`, fresh
+ * branch on its repo — as a durable, fire-and-poll job that survives an MCP restart. It is NOT
+ * backend-pluggable. To instead SPAWN + live-drive workers in a CHOSEN backend (sandbox OR cli-bridge,
+ * via `createExecutor({ backend })`) with observe/steer/resume + recursion, use the coordination MCP.
+ *
  * The MCP server is profile-agnostic: it owns the task queue + feedback
  * store + transport. Each `*Delegate` is the closure that the queue
  * invokes when a task runs. Consumers can override either delegate to
@@ -2138,10 +2233,10 @@ interface SettleDetachedCoderTurnOptions {
  * 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 `worktreeFanout` path. This helper (with `coderTaskFromArgs` and
- * `createDriveTurnResumeDriver`) stays as the resume seam `bin.ts` wires for in-flight records.
+ * `createDetachedTurnResumeDriver`) stays as the resume seam `bin.ts` wires for in-flight records.
  *
  * @experimental
  */
 declare function settleDetachedCoderTurn(turn: DetachedTurn, options: SettleDetachedCoderTurnOptions): Promise<CoderOutput>;
 
-export { type DelegationRecord as $, type Agent as A, type Budget as B, type CoderReviewer as C, type DelegateCodeArgs as D, type ExecutorRegistry as E, type FleetHandle as F, type GitRunner as G, type CappedDelegationTrace as H, type CoderReview as I, type CreateWorktreeOptions as J, DELEGATION_TRACE_MAX_BYTES as K, DELEGATION_TRACE_MAX_SPANS as L, type DelegateCodeConfig as M, type NodeId as N, type DelegateResearchConfig as O, type DelegateRunCtx as P, type DelegateUiAuditConfig as Q, type ResearcherDelegate as R, type Scope as S, type TraceContext as T, type UiAuditorDelegate as U, type DelegateUiAuditRoute as V, type DelegationError as W, type DelegationHistoryEntry as X, DelegationPersistenceError as Y, type DelegationProfile as Z, type DelegationProgress as _, type DetachedWinnerSelection as a, type OtelExportConfig as a$, type DelegationResultPayload as a0, type DelegationResumeContext as a1, type DelegationResumeDriver as a2, type DelegationResumeTick as a3, type DelegationRunContext as a4, DelegationStateCorruptError as a5, type DelegationStatus as a6, type DelegationStore as a7, type DelegationTaskQueueOptions as a8, type DelegationTraceCaps as a9, capDelegationTrace as aA, captureWorktreeDiff as aB, coderTaskFromArgs as aC, composeLoopTraceEmitters as aD, createDelegationTraceCollector as aE, createDriveTurnResumeDriver as aF, createFleetWorkspaceExecutor as aG, createPropagatingTraceEmitter as aH, createSiblingSandboxExecutor as aI, createWorktree as aJ, detachedSessionDelegate as aK, detachedTurnEvents as aL, formatDetachedSessionRef as aM, hashIdempotencyInput as aN, parseDetachedSessionRef as aO, readTraceContextFromEnv as aP, removeWorktree as aQ, runDetachedTurn as aR, settleDetachedCoderTurn as aS, traceContextToEnv as aT, type EvalRunEvent as aU, type EvalRunGeneration as aV, type EvalRunsExportConfig as aW, type EvalRunsExportResult as aX, INTELLIGENCE_WIRE_VERSION as aY, type LoopSpanNode as aZ, type OtelAttribute as a_, type DelegationTraceCollector as aa, type DelegationTraceSpan as ab, type DetachedSessionDelegateOptions as ac, type DetachedSessionRefParts as ad, type DetachedTurn as ae, type DiffOptions as af, type DiffResult as ag, type DriveTurnCapableBox as ah, type DriveTurnResumeDriverOptions as ai, type DriveTurnTick as aj, type FeedbackRating as ak, type FeedbackRefersTo as al, FileDelegationStore as am, type FileDelegationStoreOptions as an, type FleetWorkspaceExecutorOptions as ao, InMemoryDelegationStore as ap, type RemoveWorktreeOptions as aq, type ResearchOutputShape as ar, type RunDetachedTurnOptions as as, type SettleDetachedCoderTurnOptions as at, type SiblingSandboxExecutorOptions as au, type SubmitInput as av, type SubmitOutput as aw, type UiAuditorDelegationOutput as ax, type WorktreeHandle as ay, buildDelegationTraceSpans as az, type CoderOutput as b, type OtelExporter as b0, type OtelSpan as b1, buildLoopOtelSpans as b2, buildLoopSpanNodes as b3, createOtelExporter as b4, exportEvalRuns as b5, loopEventToOtelSpan as b6, type SpawnEvent as b7, type TreeView as b8, type ExecutorFactory as b9, type UsageEvent as ba, type Supervisor as bb, type ExecutorContext as bc, type ExecutorResult as bd, type Handle as be, type NodeSnapshot as bf, type NodeStatus as bg, type Restart as bh, type RootSignal as bi, type Runtime as bj, type SpawnOpts as bk, type SupervisorOpts as bl, type WidenGate as bm, type DelegateFeedbackArgs as c, type DelegationFeedbackSnapshot as d, DelegationTaskQueue as e, type CoderDelegate as f, type ResultBlobStore as g, type AgentSpec as h, type SpawnJournal as i, type RootHandle as j, type SupervisedResult as k, type Settled as l, type Spend as m, type Executor as n, type DelegationExecutor as o, type DelegateCodeResult as p, type DelegateFeedbackResult as q, type ResearchSource as r, type DelegateResearchArgs as s, type DelegateResearchResult as t, type DelegateUiAuditArgs as u, type DelegateUiAuditResult as v, type DelegationHistoryResult as w, type DelegationHistoryArgs as x, type DelegationStatusResult as y, type DelegationStatusArgs as z };
+export { type DelegationProfile as $, type Agent as A, type Budget as B, type CoderReviewer as C, type DelegateCodeArgs as D, type ExecutorRegistry as E, type FleetHandle as F, type GitRunner as G, type DelegationStatusArgs as H, type CappedDelegationTrace as I, type CoderReview as J, type CreateWorktreeOptions as K, type LocalHarness as L, DELEGATION_TRACE_MAX_BYTES as M, type NodeId as N, DELEGATION_TRACE_MAX_SPANS as O, type DelegateCodeConfig as P, type DelegateResearchConfig as Q, type ResearcherDelegate as R, type Scope as S, type TraceContext as T, type UiAuditorDelegate as U, type DelegateRunCtx as V, type DelegateUiAuditConfig as W, type DelegateUiAuditRoute as X, type DelegationError as Y, type DelegationHistoryEntry as Z, DelegationPersistenceError as _, type DetachedWinnerSelection as a, type EvalRunsExportResult as a$, type DelegationProgress as a0, type DelegationRecord as a1, type DelegationResultPayload as a2, type DelegationResumeContext as a3, type DelegationResumeDriver as a4, type DelegationResumeTick as a5, type DelegationRunContext as a6, DelegationStateCorruptError as a7, type DelegationStatus as a8, type DelegationStore as a9, type SubmitOutput as aA, type UiAuditorDelegationOutput as aB, type WorktreeHandle as aC, buildDelegationTraceSpans as aD, capDelegationTrace as aE, captureWorktreeDiff as aF, coderTaskFromArgs as aG, composeLoopTraceEmitters as aH, createDelegationTraceCollector as aI, createDetachedTurnResumeDriver as aJ, createFleetWorkspaceExecutor as aK, createPropagatingTraceEmitter as aL, createSiblingSandboxExecutor as aM, createWorktree as aN, detachedSessionDelegate as aO, detachedTurnEvents as aP, formatDetachedSessionRef as aQ, hashIdempotencyInput as aR, parseDetachedSessionRef as aS, readTraceContextFromEnv as aT, removeWorktree as aU, runDetachedTurn as aV, settleDetachedCoderTurn as aW, traceContextToEnv as aX, type EvalRunEvent as aY, type EvalRunGeneration as aZ, type EvalRunsExportConfig as a_, type DelegationTaskQueueOptions as aa, type DelegationTraceCaps as ab, type DelegationTraceCollector as ac, type DelegationTraceSpan as ad, type DetachedSessionDelegateOptions as ae, type DetachedSessionRefParts as af, type DetachedTurn as ag, type DetachedTurnResumeDriverOptions as ah, type DiffOptions as ai, type DiffResult as aj, type DriveTurnCapableBox as ak, type DriveTurnTick as al, type FeedbackRating as am, type FeedbackRefersTo as an, FileDelegationStore as ao, type FileDelegationStoreOptions as ap, type FleetWorkspaceExecutorOptions as aq, InMemoryDelegationStore as ar, type LocalHarnessResult as as, type RemoveWorktreeOptions as at, type ResearchOutputShape as au, type RunDetachedTurnOptions as av, type RunLocalHarnessOptions as aw, type SettleDetachedCoderTurnOptions as ax, type SiblingSandboxExecutorOptions as ay, type SubmitInput as az, type CoderOutput as b, INTELLIGENCE_WIRE_VERSION as b0, type LoopSpanNode as b1, type OtelAttribute as b2, type OtelExportConfig as b3, type OtelExporter as b4, type OtelSpan as b5, buildLoopOtelSpans as b6, buildLoopSpanNodes as b7, createOtelExporter as b8, exportEvalRuns as b9, loopEventToOtelSpan as ba, type SpawnEvent as bb, type ExecutorFactory as bc, type UsageEvent as bd, type Supervisor as be, type ExecutorContext as bf, type ExecutorResult as bg, type SupervisorOpts as bh, type TreeView as bi, type WidenGate as bj, type DelegateFeedbackArgs as c, type DelegationFeedbackSnapshot as d, DelegationTaskQueue as e, type CoderDelegate as f, type ResultBlobStore as g, type AgentSpec as h, type SpawnJournal as i, type RootHandle as j, type SupervisedResult as k, type Settled as l, type Spend as m, type Executor as n, type DelegationExecutor as o, type DelegateCodeResult as p, type DelegateFeedbackResult as q, runLocalHarness as r, type ResearchSource as s, type DelegateResearchArgs as t, type DelegateResearchResult as u, type DelegateUiAuditArgs as v, type DelegateUiAuditResult as w, type DelegationHistoryResult as x, type DelegationHistoryArgs as y, type DelegationStatusResult as z };

package/dist/{improvement-adapter-BC4HhuAR.d.ts → improvement-adapter-CioiEE2z.d.ts}

@@ -1,5 +1,5 @@
 import { FindingSubject, AnalystFinding } from '@tangle-network/agent-eval';
-import { I as ImprovementAdapter } from './types-p8dWBIXL.js';
+import { I as ImprovementAdapter } from './types-BC3bZpH0.js';
 
 /**
  * `AgentSurfaces` — declarative map of the mutable file/directory paths