@tangle-network/agent-runtime 0.103.1 → 0.105.0

package/dist/{chunk-EAQ5YRRY.js → chunk-XBG2W2VW.js}

@@ -5,7 +5,6 @@ import {
   buildLoopSpanNodes
 } from "./chunk-2VZYRB55.js";
 import {
-  assertModelAllowed,
   captureWorktreeDiff,
   createActivityLog,
   createSupervisor,
@@ -18,7 +17,7 @@ import {
   runWorktreeChecks,
   runWorktreeHarness,
   withDriverExecutor
-} from "./chunk-6WZZXQV5.js";
+} from "./chunk-HLKC4UYB.js";
 import {
   FileResultBlobStore,
   FileSpawnJournal,
@@ -29,7 +28,7 @@ import {
 import {
   providerAsExecutor,
   resolveAgentEnvironmentProvider
-} from "./chunk-M6MD6JBS.js";
+} from "./chunk-KRBFHMV6.js";
 import {
   addTokenUsage,
   deleteBoxSafe,
@@ -69,6 +68,17 @@ function gateOnDeliverable(inner, deliverable) {
     runtime: inner.runtime,
     ...inner.budgetExempt !== void 0 ? { budgetExempt: inner.budgetExempt } : {},
     ...inner.deliver ? { deliver: (m) => inner.deliver?.(m) } : {},
+    // Forward the OPTIONAL live-observation surfaces so a gated worker stays supervisable
+    // mid-flight. The scope captures `progress`/`traceSource` at spawn and only if the executor
+    // exposes them; a gate that drops them makes `observe_agent` read `recentActivity:[]` and
+    // loses online detection for a running worker (it saw the tokens/turns the fold derives, but
+    // none of the harness's own turn count or tool activity). `metered` is a driver-executor's
+    // OWN-inference subtree total, re-homed by the parent on settle — dropping it would leak a
+    // gated sub-driver's inference out of the journal. Preserve the "undefined ⟺ not implemented"
+    // contract: only expose a method the inner executor actually implements.
+    ...inner.progress ? { progress: () => inner.progress?.() } : {},
+    ...inner.traceSource ? { traceSource: () => inner.traceSource?.() } : {},
+    ...inner.metered ? { metered: () => inner.metered?.() } : {},
     execute(task, signal) {
       const r = inner.execute(task, signal);
       if (isAsyncIterable(r)) {
@@ -95,6 +105,16 @@ function isAsyncIterable(v) {
   return v != null && typeof v[Symbol.asyncIterator] === "function";
 }
 
+// src/runtime/supervise/model-policy.ts
+function assertModelAllowed(model, allowed) {
+  if (!allowed || model === void 0) return;
+  if (!allowed.includes(model)) {
+    throw new ConfigError(
+      `model ${JSON.stringify(model)} is not in the allowed set ${JSON.stringify([...allowed])}`
+    );
+  }
+}
+
 // src/runtime/sandbox-acquire.ts
 var RETRYABLE_HTTP = /* @__PURE__ */ new Set([502, 503, 504, 522, 524, 408, 425, 429]);
 var TERMINAL_STATUS = /* @__PURE__ */ new Set(["failed", "expired", "stopped"]);
@@ -369,19 +389,19 @@ async function destroyBounded(box) {
 // src/runtime/run-loop.ts
 var DEFAULT_MAX_ITERATIONS = 10;
 var DEFAULT_MAX_CONCURRENCY = 4;
-async function runLoop(options) {
+async function runAgentRounds(options) {
   const specs = resolveAgentRuns(options);
   const maxIterations = options.maxIterations ?? DEFAULT_MAX_ITERATIONS;
   if (!Number.isFinite(maxIterations) || maxIterations <= 0) {
-    throw new ValidationError("runLoop: maxIterations must be > 0");
+    throw new ValidationError("runAgentRounds: maxIterations must be > 0");
   }
   const maxConcurrency = options.maxConcurrency ?? DEFAULT_MAX_CONCURRENCY;
   if (!Number.isFinite(maxConcurrency) || maxConcurrency <= 0) {
-    throw new ValidationError("runLoop: maxConcurrency must be > 0");
+    throw new ValidationError("runAgentRounds: maxConcurrency must be > 0");
   }
   const sandboxStreaming = options.lineage?.streaming ?? "sse";
   if (!options.ctx?.sandboxClient || typeof options.ctx.sandboxClient.create !== "function") {
-    throw new ValidationError("runLoop: ctx.sandboxClient.create is required");
+    throw new ValidationError("runAgentRounds: ctx.sandboxClient.create is required");
   }
   const now = options.now ?? Date.now;
   const runId = options.runId ?? `loop-${randomSuffix()}`;
@@ -559,12 +579,13 @@ async function runLoop(options) {
     if (lineageState) await lineageState.lineage.teardown();
   }
 }
+var runLoop = runAgentRounds;
 async function setUpLineage(options, maxConcurrency, recordMount) {
   const lineageOpts = options.lineage;
   if (!lineageOpts || !lineageOpts.sessionContinuity && !lineageOpts.forkFanout) return void 0;
   if (options.onWorkerBox) {
     throw new ValidationError(
-      "runLoop: `lineage` and `onWorkerBox` both own worker boxes \u2014 pass only one"
+      "runAgentRounds: `lineage` and `onWorkerBox` both own worker boxes \u2014 pass only one"
     );
   }
   const capabilities = await probeSandboxCapabilities(options.ctx.sandboxClient);
@@ -584,12 +605,14 @@ function planLineageRound(state, specs, slice, parentIndex, signal) {
   const parent = parentIndex !== void 0 ? state.handles.get(parentIndex) : void 0;
   const promptFor = (offset) => {
     const spec = specs[offset % specs.length];
-    if (!spec) throw new ValidationError("runLoop: no AgentRunSpec available for lineage iteration");
+    if (!spec)
+      throw new ValidationError("runAgentRounds: no AgentRunSpec available for lineage iteration");
     return spec.taskToPrompt(slice[offset]);
   };
   const specAt = (offset) => {
     const spec = specs[offset % specs.length];
-    if (!spec) throw new ValidationError("runLoop: no AgentRunSpec available for lineage iteration");
+    if (!spec)
+      throw new ValidationError("runAgentRounds: no AgentRunSpec available for lineage iteration");
     return spec;
   };
   if (slice.length === 1 && parent && state.options.sessionContinuity) {
@@ -615,7 +638,7 @@ function planLineageRound(state, specs, slice, parentIndex, signal) {
         const branches = await ensureForked();
         const branch = branches[offset];
         if (!branch)
-          throw new ValidationError("runLoop: lineage fork produced no branch for offset");
+          throw new ValidationError("runAgentRounds: lineage fork produced no branch for offset");
         return branch;
       }
     }));
@@ -673,9 +696,9 @@ async function runBatch(args) {
 async function executeIteration(args) {
   const slot = args.iterations[args.item.index];
   if (!slot)
-    throw new ValidationError(`runLoop: missing iteration slot at index ${args.item.index}`);
+    throw new ValidationError(`runAgentRounds: missing iteration slot at index ${args.item.index}`);
   const spec = args.specs[args.item.index % args.specs.length];
-  if (!spec) throw new ValidationError("runLoop: no AgentRunSpec available for iteration");
+  if (!spec) throw new ValidationError("runAgentRounds: no AgentRunSpec available for iteration");
   slot.startedAt = args.now();
   slot.agentRunName = spec.name ?? spec.profile.name ?? "agent";
   await emitTrace(args.ctx.traceEmitter, {
@@ -986,11 +1009,11 @@ function defaultSelectWinner(iterations) {
 }
 function resolveAgentRuns(options) {
   if (options.agentRun && options.agentRuns) {
-    throw new ValidationError("runLoop: pass exactly one of `agentRun` or `agentRuns`");
+    throw new ValidationError("runAgentRounds: pass exactly one of `agentRun` or `agentRuns`");
   }
   if (options.agentRun) return [options.agentRun];
   if (options.agentRuns && options.agentRuns.length > 0) return options.agentRuns;
-  throw new ValidationError("runLoop: `agentRun` or non-empty `agentRuns` is required");
+  throw new ValidationError("runAgentRounds: `agentRun` or non-empty `agentRuns` is required");
 }
 function isTerminalDecision(decision) {
   return decision === "stop" || decision === "pick-winner" || decision === "fail" || decision === "done";
@@ -1301,9 +1324,9 @@ var piExecutor = (spec, ctx) => {
   };
   return {
     runtime: PI_RUNTIME,
-    // pi owns the queue; `deliver` only routes. A forceful message becomes pi's `steer` (which
-    // pi delivers after the current tool batch and before the next model call); a queued one
-    // becomes `follow_up` (after the turn finishes). Never throws — the inbox contract.
+    // pi owns the queue; `deliver` only routes through its state-safe `prompt` command. Its
+    // streaming behavior chooses steer versus follow-up atomically in pi, rather than trusting
+    // this adapter's delayed view of whether the current run has already ended.
     deliver: (m) => inbox.deliver(m),
     progress: () => ({
       turns: state.turns,
@@ -1361,6 +1384,7 @@ async function* streamPiSession(args) {
   };
   const stdoutLines = readJsonLines(proc, (value) => {
     const ev = value;
+    if (ev.type === "agent_start") idle = false;
     if (ev.type === "agent_end") idle = true;
     events.push(ev);
     notify();
@@ -1396,7 +1420,7 @@ ${taskText(args.task)}` : taskText(args.task);
     sendCommand(proc, { type: "prompt", message: opening });
     state.note = "turn 0";
     for (; ; ) {
-      forwardPending(proc, inbox, activity);
+      if (!idle) forwardPending(proc, inbox, activity);
       while (events.length > 0) {
         const ev = events.shift();
         for (const usage of projectPiEvent(ev, args, tokens)) {
@@ -1445,8 +1469,9 @@ function forwardPending(proc, inbox, activity) {
   const pending = inbox.drain();
   for (const m of pending) {
     sendCommand(proc, {
-      type: m.interrupt ? "steer" : "follow_up",
-      message: renderOne(m)
+      type: "prompt",
+      message: renderOne(m),
+      streamingBehavior: m.interrupt ? "steer" : "followUp"
     });
     activity.push({
       at: Date.now(),
@@ -2299,7 +2324,7 @@ async function* streamSandboxLeaf(args) {
     ...args.seam.lineage !== void 0 ? { lineage: args.seam.lineage } : {}
   };
   try {
-    const result = await runLoop(loopOptions);
+    const result = await runAgentRounds(loopOptions);
     const out = result.winner?.output ?? { events: [] };
     const verdict = result.winner?.verdict;
     const spent = {
@@ -6307,9 +6332,11 @@ async function delegate(intent, opts = {}) {
 
 export {
   gateOnDeliverable,
+  assertModelAllowed,
   acquireSandbox,
   probeSandboxCapabilities,
   createSandboxLineage,
+  runAgentRounds,
   runLoop,
   createSandboxForSpec,
   defaultSelectWinner,
@@ -6404,4 +6431,4 @@ export {
   workerFromBackend,
   supervise
 };
-//# sourceMappingURL=chunk-EAQ5YRRY.js.map
+//# sourceMappingURL=chunk-XBG2W2VW.js.map