@tangle-network/agent-runtime 0.72.0 → 0.73.0

package/dist/{chunk-55WKGOGU.js → chunk-NCH4XUZ7.js}

@@ -1,14 +1,16 @@
 import {
   buildLoopSpanNodes
 } from "./chunk-VMNEQHJR.js";
+import {
+  extractLlmCallEvent
+} from "./chunk-T2HVQVB4.js";
 import {
   AgentEvalError,
   ConfigError,
   NotFoundError,
   RuntimeRunStateError,
-  ValidationError,
-  extractLlmCallEvent
-} from "./chunk-VLF5RHEQ.js";
+  ValidationError
+} from "./chunk-NBV35BR6.js";
 import {
   UI_LENSES
 } from "./chunk-WIR4HOOJ.js";
@@ -162,6 +164,9 @@ function throwAbort() {
 function throwIfAborted(signal) {
   if (signal?.aborted) throw abortError();
 }
+function isAbortError(err) {
+  return err instanceof Error && err.name === "AbortError";
+}
 function sleep(ms, signal) {
   return new Promise((resolve) => {
     if (signal?.aborted) {
@@ -564,6 +569,8 @@ function createSandboxLineage(client, capabilities, options = {}) {
     throw new ValidationError("createSandboxLineage: client.create is required");
   }
   const streaming = options.streaming ?? "sse";
+  const recordMount = options.recordMount ?? (() => {
+  });
   const forkConcurrency = Math.max(
     1,
     Math.floor(options.maxConcurrency ?? DEFAULT_FORK_CONCURRENCY)
@@ -573,7 +580,7 @@ function createSandboxLineage(client, capabilities, options = {}) {
     if (signal.aborted) throwAbort();
     const opts = buildBackendOptions(spec.profile, spec.sandboxOverrides);
     const box = await acquireSandbox(client, opts, { signal });
-    await spec.prepareBox?.(box, { signal });
+    await spec.prepareBox?.(box, { signal, recordMount });
     owned.push(box);
     return box;
   };
@@ -602,7 +609,7 @@ function createSandboxLineage(client, capabilities, options = {}) {
         if (checkpointId !== void 0) {
           const box2 = await forkFromCheckpoint(parent.box, checkpointId, signal);
           owned.push(box2);
-          await spec.prepareBox?.(box2, { signal });
+          await spec.prepareBox?.(box2, { signal, recordMount });
           const sessionId2 = mintSessionId();
           return {
             handle: { box: box2, sessionId: sessionId2 },
@@ -691,13 +698,17 @@ async function runLoop(options) {
   const loopStart = now();
   const driverName = options.driver.name ?? "driver";
   const iterations = [];
+  const mounts = [];
+  const recordMount = (entry) => {
+    mounts.push(entry);
+  };
   let round = 0;
   const ownedBoxes = [];
   const collectBox = options.onWorkerBox ? (box) => {
     ownedBoxes.push(box);
     options.onWorkerBox?.(box);
   } : void 0;
-  const lineageState = await setUpLineage(options, maxConcurrency);
+  const lineageState = await setUpLineage(options, maxConcurrency, recordMount);
   emitRunLoopHook(options, {
     target: "agent.run",
     phase: "before",
@@ -808,7 +819,8 @@ async function runLoop(options) {
         parentIndex,
         collectBox,
         lineagePlan,
-        lineageState
+        lineageState,
+        recordMount
       });
       if (controller.signal.aborted) throwAbort();
       emitRunLoopHook(options, {
@@ -835,11 +847,19 @@ async function runLoop(options) {
         payload: { decision: stringifySafe(decision), historyLength: iterations.length }
       });
       if (isTerminalDecision(decision)) {
-        return await finalizeAndEmitEnded(options, decision, iterations, loopStart, now, runId);
+        return await finalizeAndEmitEnded(
+          options,
+          decision,
+          iterations,
+          loopStart,
+          now,
+          runId,
+          mounts
+        );
       }
       if (lineageState) await pruneLineage(lineageState, iterations);
     }
-    return await decideAndFinalize(options, iterations, loopStart, now, runId);
+    return await decideAndFinalize(options, iterations, loopStart, now, runId, mounts);
   } finally {
     if (options.ctx.signal) options.ctx.signal.removeEventListener("abort", onOuterAbort);
     await Promise.allSettled(
@@ -849,7 +869,7 @@ async function runLoop(options) {
     if (lineageState) await lineageState.lineage.teardown();
   }
 }
-async function setUpLineage(options, maxConcurrency) {
+async function setUpLineage(options, maxConcurrency, recordMount) {
   const lineageOpts = options.lineage;
   if (!lineageOpts || !lineageOpts.sessionContinuity && !lineageOpts.forkFanout) return void 0;
   if (options.onWorkerBox) {
@@ -861,7 +881,8 @@ async function setUpLineage(options, maxConcurrency) {
   return {
     lineage: createSandboxLineage(options.ctx.sandboxClient, capabilities, {
       maxConcurrency,
-      streaming: lineageOpts.streaming
+      streaming: lineageOpts.streaming,
+      recordMount
     }),
     options: lineageOpts,
     handles: /* @__PURE__ */ new Map(),
@@ -991,7 +1012,7 @@ async function executeIteration(args) {
       args.lineageState?.handles.set(args.item.index, acquired.handle);
       stream = acquired.events;
     } else {
-      box = await createSandboxForSpec(args.ctx.sandboxClient, spec, args.signal);
+      box = await createSandboxForSpec(args.ctx.sandboxClient, spec, args.signal, args.recordMount);
       const prompt = spec.taskToPrompt(args.item.task);
       stream = args.streaming === "poll" ? promptEvents("poll", box, prompt, `${args.runId}-i${args.item.index}`, args.signal) : box.streamPrompt(prompt, { signal: args.signal });
     }
@@ -1060,13 +1081,13 @@ async function executeIteration(args) {
       await destroySandboxSafe(box, args.ctx.traceEmitter, args.runId, args.now);
     }
   }
-  if (isAbortError(slot.error) || args.signal.aborted) {
+  if (isAbortError2(slot.error) || args.signal.aborted) {
     if (slot.error) throw slot.error;
     throwAbort();
   }
   if (slot.error instanceof ValidationError) throw slot.error;
 }
-function isAbortError(err) {
+function isAbortError2(err) {
   return err instanceof Error && err.name === "AbortError";
 }
 var TEARDOWN_TIMEOUT_MS2 = 15e3;
@@ -1120,15 +1141,35 @@ function readSandboxId(box) {
   const raw = box.id;
   return typeof raw === "string" && raw.length > 0 ? raw : void 0;
 }
-async function createSandboxForSpec(client, spec, signal) {
+async function createSandboxForSpec(client, spec, signal, recordMount) {
   const opts = buildBackendOptions(spec.profile, spec.sandboxOverrides);
   if (signal.aborted) throwAbort();
   const box = await acquireSandbox(client, opts, { signal });
-  await spec.prepareBox?.(box, { signal });
+  await invokePrepareBox(spec, box, signal, recordMount);
   return box;
 }
+async function invokePrepareBox(spec, box, signal, recordMount) {
+  if (!spec.prepareBox) return;
+  await spec.prepareBox(box, { signal, recordMount: recordMount ?? noopMountRecorder });
+}
+var noopMountRecorder = () => {
+};
 function finalize(args) {
-  const winner = args.options.selectWinner ? args.options.selectWinner(args.iterations) : args.options.driver.selectWinner?.(args.iterations) ?? defaultSelectWinner(args.iterations);
+  let selector;
+  let winner;
+  if (args.options.selectWinner) {
+    selector = "caller";
+    winner = args.options.selectWinner(args.iterations);
+  } else {
+    const authored = args.options.driver.selectWinner?.(args.iterations);
+    if (authored) {
+      selector = "driver";
+      winner = authored;
+    } else {
+      selector = "default";
+      winner = defaultSelectWinner(args.iterations);
+    }
+  }
   const costUsd = args.iterations.reduce((sum, iter) => sum + (iter.costUsd || 0), 0);
   const tokenUsage = args.iterations.reduce((acc, iter) => {
     addTokenUsage(acc, iter.tokenUsage);
@@ -1140,11 +1181,36 @@ function finalize(args) {
     winner,
     durationMs: args.now() - args.startMs,
     costUsd,
-    tokenUsage
+    tokenUsage,
+    provenance: {
+      mounts: args.mounts,
+      selectionReceipts: buildSelectionReceipts(args.iterations, winner, selector)
+    }
   };
   return result;
 }
-async function decideAndFinalize(options, iterations, startMs, now, runId) {
+function buildSelectionReceipts(iterations, winner, selector) {
+  const receipts = [];
+  for (const iter of iterations) {
+    if (iter.output === void 0 || iter.error) continue;
+    const selected = winner?.iterationIndex === iter.index;
+    const receipt = {
+      candidateIndex: iter.index,
+      selected,
+      selector
+    };
+    if (iter.verdict?.score !== void 0) receipt.score = iter.verdict.score;
+    if (selector === "default") receipt.reason = defaultSelectorReason(iter, selected);
+    receipts.push(receipt);
+  }
+  return receipts;
+}
+function defaultSelectorReason(iter, selected) {
+  const valid = iter.verdict?.valid === true;
+  if (selected) return valid ? "best valid score" : "best non-errored score (no valid candidate)";
+  return valid ? "valid but not top score" : "not selected";
+}
+async function decideAndFinalize(options, iterations, startMs, now, runId, mounts) {
   emitRunLoopHook(options, {
     target: "agent.decision",
     phase: "before",
@@ -1166,10 +1232,10 @@ async function decideAndFinalize(options, iterations, startMs, now, runId) {
     timestamp: now(),
     payload: { decision: stringifySafe(decision), historyLength: iterations.length }
   });
-  return finalizeAndEmitEnded(options, decision, iterations, startMs, now, runId);
+  return finalizeAndEmitEnded(options, decision, iterations, startMs, now, runId, mounts);
 }
-async function finalizeAndEmitEnded(options, decision, iterations, startMs, now, runId) {
-  const result = finalize({ options, decision, iterations, startMs, now, runId });
+async function finalizeAndEmitEnded(options, decision, iterations, startMs, now, runId, mounts) {
+  const result = finalize({ options, decision, iterations, startMs, now, runId, mounts });
   emitRunLoopHook(options, {
     target: "agent.run",
     phase: "after",
@@ -1605,7 +1671,7 @@ async function runChild(live, executor, childAbort, task, opts, pool, ticket, bl
   } catch (err) {
     reconcileOnce(live.spent);
     await teardownSafe(executor, "brutalKill");
-    const aborted = childAbort.signal.aborted || isAbortError2(err);
+    const aborted = childAbort.signal.aborted || isAbortError3(err);
     return downRecord(errMessage(err), aborted || isInfraError(err), executor.metered?.());
   }
 }
@@ -1707,7 +1773,7 @@ function isAgentSpec(value) {
   const v = value;
   return "profile" in v && "harness" in v;
 }
-function isAbortError2(err) {
+function isAbortError3(err) {
   return typeof err === "object" && err !== null && "name" in err && err.name === "AbortError";
 }
 function isInfraError(err) {
@@ -2126,12 +2192,12 @@ function createWorktreeCliExecutor(options) {
   }
   const runId = options.runId ?? randomUUID();
   const controller = new AbortController();
+  const budgetExempt = options.budgetExempt ?? true;
   let run;
   let artifact;
   return {
     runtime: "cli",
-    // A harness CLI cannot account tokens — exclude it from the conserved pool + equal-k.
-    budgetExempt: true,
+    budgetExempt,
     async execute(_task, signal) {
       const linked = linkSignals(signal, controller.signal);
       const started = Date.now();
@@ -2153,7 +2219,9 @@ function createWorktreeCliExecutor(options) {
       });
       const spent = {
         iterations: 1,
-        // budgetExempt: spend is recorded zero (not metered), never a fabricated cost.
+        // The worktree-harness core surfaces no token/usd usage, so tokens/usd are a genuine zero
+        // (NOT a fabricated cost). When budgetExempt is true the pool ignores this spend entirely;
+        // when explicitly false the scope debits exactly this captured spend — the real iteration.
         tokens: zeroTokenUsage(),
         usd: 0,
         ms: Date.now() - started
@@ -3769,10 +3837,14 @@ function createCoordinationTools(opts) {
       return q.status !== "answered" && q.status !== "deferred";
     });
   };
+  const maxLiveWorkers = opts.maxLiveWorkers;
+  const liveWorkerCount = () => opts.scope.view.nodes.filter(
+    (n) => n.status !== "done" && n.status !== "failed" && n.status !== "cancelled"
+  ).length;
   const tools = [
     {
       name: "spawn_agent",
-      description: "Start a worker the driver will drive. `profile` is the worker or another driver; `task` is what it should do. Reserves budget from the conserved pool and fails closed. Pass an optional `budget` (per-field) to give a hard sub-task more than the default \u2014 it merges over the per-worker default; the conserved pool is still the hard fence.",
+      description: 'Start a worker the driver will drive. `profile` is the worker or another driver; `task` is what it should do. Reserves budget from the conserved pool and fails closed. Pass an optional `budget` (per-field) to give a hard sub-task more than the default \u2014 it merges over the per-worker default; the conserved pool is still the hard fence. When a max-live-workers cap is set it also fails closed (`error: "max-live-workers"`) while that many workers are still in flight \u2014 settle or steer one before spawning another.',
       inputSchema: {
         type: "object",
         properties: {
@@ -3794,6 +3866,8 @@ function createCoordinationTools(opts) {
       },
       handler: (raw) => {
         const a = obj(raw);
+        if (maxLiveWorkers !== void 0 && maxLiveWorkers > 0 && liveWorkerCount() >= maxLiveWorkers)
+          return Promise.resolve({ error: "max-live-workers" });
         const agent = opts.makeWorkerAgent(a.profile);
         const budget = a.budget === void 0 ? opts.perWorker : mergeBudget(opts.perWorker, a.budget);
         const res = opts.scope.spawn(agent, a.task, {
@@ -4073,7 +4147,8 @@ function driverAgent(opts) {
         scope,
         blobs: opts.blobs,
         makeWorkerAgent: opts.makeWorkerAgent,
-        perWorker: opts.perWorker
+        perWorker: opts.perWorker,
+        ...opts.maxLiveWorkers !== void 0 ? { maxLiveWorkers: opts.maxLiveWorkers } : {}
       });
       const byName = new Map(coord.tools.map((t) => [t.name, t]));
       const toolSpecs = [
@@ -5157,6 +5232,7 @@ function supervise(profile, task, opts) {
     blobs,
     makeWorkerAgent,
     perWorker,
+    ...opts.maxLiveWorkers !== void 0 ? { maxLiveWorkers: opts.maxLiveWorkers } : {},
     ...opts.router ? { router: opts.router } : {},
     ...opts.brain ? { brain: opts.brain } : {},
     ...opts.driveHarness ? { driveHarness: opts.driveHarness } : {},
@@ -6036,6 +6112,7 @@ async function serveCoordinationMcp(opts) {
     blobs: opts.blobs,
     makeWorkerAgent: opts.makeWorkerAgent,
     perWorker: opts.perWorker,
+    ...opts.maxLiveWorkers !== void 0 ? { maxLiveWorkers: opts.maxLiveWorkers } : {},
     ...opts.analysts ? { analysts: opts.analysts } : {},
     ...opts.analyzeOnSettle ? { analyzeOnSettle: opts.analyzeOnSettle } : {},
     ...opts.onEvent ? { onEvent: opts.onEvent } : {},
@@ -6112,6 +6189,7 @@ function supervisorAgent(profile, deps) {
       makeWorkerAgent: deps.makeWorkerAgent,
       perWorker: deps.perWorker,
       systemPrompt,
+      ...deps.maxLiveWorkers !== void 0 ? { maxLiveWorkers: deps.maxLiveWorkers } : {},
       ...deps.extraTools ? { extraTools: deps.extraTools } : {},
       ...deps.executeExtraTool ? { executeExtraTool: deps.executeExtraTool } : {},
       ...deps.maxTurns !== void 0 ? { maxTurns: deps.maxTurns } : {}
@@ -6130,7 +6208,8 @@ function supervisorAgent(profile, deps) {
         scope,
         blobs: deps.blobs,
         makeWorkerAgent: deps.makeWorkerAgent,
-        perWorker: deps.perWorker
+        perWorker: deps.perWorker,
+        ...deps.maxLiveWorkers !== void 0 ? { maxLiveWorkers: deps.maxLiveWorkers } : {}
       });
       try {
         await driveHarness({ profile, task, scope, coordinationMcpUrl: mcp.url });
@@ -6157,6 +6236,7 @@ export {
   randomSuffix,
   throwAbort,
   throwIfAborted,
+  isAbortError,
   sleep,
   stringifySafe,
   zeroTokenUsage,
@@ -6253,4 +6333,4 @@ export {
   createInProcessTransport,
   serveCoordinationMcp
 };
-//# sourceMappingURL=chunk-55WKGOGU.js.map
+//# sourceMappingURL=chunk-NCH4XUZ7.js.map