@tangle-network/agent-runtime 0.79.2 → 0.79.3

package/dist/{worktree-CpptK3oF.d.ts → worktree-harness-Bmho9SH0.d.ts}

@@ -1,4 +1,5 @@
 import { a as Executor } from './types-C1sozrte.js';
+import { L as LocalHarness } from './local-harness-DU7yV6mG.js';
 
 /**
  * @experimental
@@ -122,4 +123,75 @@ declare function captureWorktreeDiff(options: DiffOptions): Promise<DiffResult>;
 /** @experimental */
 declare function removeWorktree(options: RemoveWorktreeOptions): Promise<void>;
 
-export { type CreateWorktreeOptions as C, type DiffOptions as D, type GitRunner as G, type RemoveWorktreeOptions as R, type WorktreeHandle as W, type DiffResult as a, createWorktree as b, captureWorktreeDiff as c, type DeliverableSpec as d, gateOnDeliverable as g, removeWorktree as r };
+/**
+ * @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 | 'bridge';
+        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;
+}>;
+
+export { type CreateWorktreeOptions as C, type DeliverableSpec as D, type GitRunner as G, type RemoveWorktreeOptions as R, type WorktreeHarnessResult as W, type WorktreeCheckRunner as a, type DiffOptions as b, type DiffResult as c, type WorktreeHandle as d, captureWorktreeDiff as e, createWorktree as f, type WorktreeCommandResult as g, gateOnDeliverable as h, removeWorktree as r };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tangle-network/agent-runtime",
-  "version": "0.79.2",
+  "version": "0.79.3",
   "description": "Shared task-lifecycle skeleton for agents: a recursive loop kernel for chat turns, one-shot tasks, and multi-attempt loops, with trace capture and eval-gated self-improvement. Domain behavior lives in adapters; scoring and ship-gates in @tangle-network/agent-eval.",
   "homepage": "https://github.com/tangle-network/agent-runtime#readme",
   "repository": {