@tangle-network/agent-runtime 0.94.6 → 0.94.7

package/dist/knowledge.d.ts

@@ -1,15 +1,15 @@
 import { KnowledgeReadinessSpec, BuildEvalKnowledgeBundleOptions, KnowledgeBaseQualityOptions, KnowledgeImprovementResult, KnowledgeImprovementOptions } from '@tangle-network/agent-knowledge';
-import { E as ExecutorConfig } from './coordination-pOGZuYS7.js';
-import { a as SuperviseOptions, S as SupervisorProfile } from './supervise-Y3w878fN.js';
-import { B as Budget, b as SupervisedResult } from './types-DHLXdLVN.js';
-import { D as DeliverableSpec } from './completion-gate-CfX2thvL.js';
+import { E as ExecutorConfig } from './coordination-o0TzS7Ms.js';
+import { a as SuperviseOptions, S as SupervisorProfile } from './supervise-CRwaJIkd.js';
+import { B as Budget, b as SupervisedResult } from './types-CogNCaw7.js';
+import { D as DeliverableSpec } from './completion-gate-tzwyyD-E.js';
 import '@tangle-network/agent-interface';
 import './substrate-DO2GHNg2.js';
-import './types-Kjr5W6OF.js';
+import './types-CKmyZ9TP.js';
 import '@tangle-network/agent-eval';
 import '@tangle-network/sandbox';
-import './sanitize-Dr3SliRC.js';
-import './local-harness-CePtFrwu.js';
+import './sanitize-Dcbjp0tU.js';
+import './local-harness-ZLMkKdZc.js';
 import 'node:child_process';
 import './environment-provider.js';
 import '@tangle-network/agent-interface/environment-provider';

package/dist/knowledge.js

@@ -6,16 +6,16 @@ import {
   knowledgeReadinessDeliverable,
   runKnowledgeImprovementJob,
   runSupervisedKnowledgeUpdate
-} from "./chunk-RNWDH5Z3.js";
+} from "./chunk-TNUBPPZA.js";
 import "./chunk-5QOB7H74.js";
-import "./chunk-LWNMCOEA.js";
+import "./chunk-FRXDOBFP.js";
 import "./chunk-DPEUKJRO.js";
 import "./chunk-ISTDY47H.js";
 import "./chunk-WIPGQ4GT.js";
 import "./chunk-VSWBYWFK.js";
 import "./chunk-3MDZX7YU.js";
-import "./chunk-FVJ7M3DA.js";
-import "./chunk-WQA5Y6PD.js";
+import "./chunk-M22PL4GH.js";
+import "./chunk-EP6RVHMX.js";
 import "./chunk-YEJR7IXO.js";
 import "./chunk-DGUM43GV.js";
 export {

package/dist/lifecycle.d.ts

@@ -2,9 +2,9 @@ import { AgentProfile } from '@tangle-network/agent-interface';
 import { a as ProfileArtifact, A as ArtifactKind, b as ArtifactStatus, c as ArtifactInput, E as EvalRunner, d as EvalResult, G as GenerateContext, C as CandidateGenerator, e as PromotionVerdict, P as PromotionGate } from './generator-YkAQrOoD.js';
 export { f as ArtifactPayloads, H as HeldOutPromotionGateOptions, M as MarginalLift, g as MeasureMarginalLiftOptions, h as heldOutPromotionGate, m as measureMarginalLift, t as thresholdPromotionGate } from './generator-YkAQrOoD.js';
 import { LlmClientOptions, AnalystFinding } from '@tangle-network/agent-eval';
-import { M as McpServeSpec } from './mcp-serve-verifier-D7hCZIkT.js';
-import { L as LocalHarness } from './local-harness-CePtFrwu.js';
-import './agentic-generator-CL1q0H91.js';
+import { M as McpServeSpec } from './mcp-serve-verifier-BO4MEsR3.js';
+import { L as LocalHarness } from './local-harness-ZLMkKdZc.js';
+import './agentic-generator-1g7GDba7.js';
 import '@tangle-network/agent-eval/campaign';
 import 'node:child_process';
 

package/dist/lifecycle.js

@@ -6,8 +6,8 @@ import {
 import {
   agenticGenerator,
   commandVerifier
-} from "./chunk-4WWSICFY.js";
-import "./chunk-WQA5Y6PD.js";
+} from "./chunk-GHXW56PO.js";
+import "./chunk-EP6RVHMX.js";
 import {
   ValidationError
 } from "./chunk-YEJR7IXO.js";

package/dist/{local-harness-CePtFrwu.d.ts → local-harness-ZLMkKdZc.d.ts}

@@ -160,4 +160,4 @@ declare function runLocalHarness(options: RunLocalHarnessOptions): Promise<Local
 /** Parse and validate the one terminal usage event emitted by `codex exec --json`. */
 declare function parseCodexTokenUsage(stdout: string): CodexTokenUsage;
 
-export { type CodexTokenUsage as C, type LocalHarness as L, type RunLocalHarnessOptions as R, type CodexExecutionPolicy as a, type CodexExecutionEvidence as b, type LocalHarnessResult as c, parseCodexTokenUsage as p, runLocalHarness as r };
+export { type CodexTokenUsage as C, type LocalHarness as L, type RunLocalHarnessOptions as R, type CodexExecutionEvidence as a, type CodexExecutionPolicy as b, type LocalHarnessResult as c, parseCodexTokenUsage as p, runLocalHarness as r };

package/dist/{loop-runner-bin-B4PwjVaF.d.ts → loop-runner-bin-iTSxSmpv.d.ts}

@@ -2,8 +2,8 @@ import { Scenario } from '@tangle-network/agent-eval/campaign';
 import { SelfImproveOptions, SelfImproveResult } from '@tangle-network/agent-eval/contract';
 import { R as RunAnalystLoopOpts, a as RunAnalystLoopResult } from './types-BC3bZpH0.js';
 import { F as FactCandidate, C as CreateKbGateOptions } from './kb-gate-CwHO0vz6.js';
-import { B as Budget } from './types-DHLXdLVN.js';
-import { A as AuthoredHarness, W as WinnerStrategy, a as WorktreeFanoutOptions, b as WorktreePatchArtifact } from './worktree-fanout-DmBvR-_O.js';
+import { B as Budget } from './types-CogNCaw7.js';
+import { A as AuthoredHarness, W as WinnerStrategy, a as WorktreeFanoutOptions, b as WorktreePatchArtifact } from './worktree-fanout-BJy24LYe.js';
 
 /**
  *

package/dist/loop-runner-bin.d.ts

@@ -1,15 +1,15 @@
 #!/usr/bin/env node
-export { L as LoopRunnerCliArgs, e as LoopRunnerCliResult, p as parseLoopRunnerArgv, k as runLoopRunnerCli } from './loop-runner-bin-B4PwjVaF.js';
+export { L as LoopRunnerCliArgs, e as LoopRunnerCliResult, p as parseLoopRunnerArgv, k as runLoopRunnerCli } from './loop-runner-bin-iTSxSmpv.js';
 import '@tangle-network/agent-eval/campaign';
 import '@tangle-network/agent-eval/contract';
 import './types-BC3bZpH0.js';
 import '@tangle-network/agent-eval';
 import './kb-gate-CwHO0vz6.js';
-import './types-DHLXdLVN.js';
+import './types-CogNCaw7.js';
 import '@tangle-network/agent-interface';
 import '@tangle-network/sandbox';
-import './types-Kjr5W6OF.js';
-import './worktree-fanout-DmBvR-_O.js';
-import './completion-gate-CfX2thvL.js';
-import './local-harness-CePtFrwu.js';
+import './types-CKmyZ9TP.js';
+import './worktree-fanout-BJy24LYe.js';
+import './completion-gate-tzwyyD-E.js';
+import './local-harness-ZLMkKdZc.js';
 import 'node:child_process';

package/dist/loop-runner-bin.js

@@ -2,18 +2,18 @@
 import {
   parseLoopRunnerArgv,
   runLoopRunnerCli
-} from "./chunk-63TIZHMI.js";
+} from "./chunk-KYPVUEJ4.js";
 import "./chunk-SGKPNBXE.js";
-import "./chunk-GKZ6DFDN.js";
-import "./chunk-ZQZX77MM.js";
-import "./chunk-LWNMCOEA.js";
+import "./chunk-7HH22XN4.js";
+import "./chunk-QDSOD7RC.js";
+import "./chunk-FRXDOBFP.js";
 import "./chunk-DPEUKJRO.js";
 import "./chunk-ISTDY47H.js";
 import "./chunk-WIPGQ4GT.js";
 import "./chunk-VSWBYWFK.js";
 import "./chunk-3MDZX7YU.js";
-import "./chunk-FVJ7M3DA.js";
-import "./chunk-WQA5Y6PD.js";
+import "./chunk-M22PL4GH.js";
+import "./chunk-EP6RVHMX.js";
 import "./chunk-YEJR7IXO.js";
 import "./chunk-DGUM43GV.js";
 export {

package/dist/loops.d.ts

@@ -1,29 +1,29 @@
-import { ChatClient, RunRecord, HarnessType, AgentProfile, AnalystFinding, AnalystRunInputs, ToolSpan, StreamingDetector, DetectorSignal, buildTrajectory } from '@tangle-network/agent-eval';
+import { ChatClient, RunRecord, HarnessType, AgentProfile, MaximumCharge, AnalystFinding, AnalystRunInputs, ToolSpan, StreamingDetector, DetectorSignal, buildTrajectory } from '@tangle-network/agent-eval';
 export { AnalystFinding, DefaultVerdict, computeFindingId, makeFinding } from '@tangle-network/agent-eval';
 import { SandboxEvent, SandboxInstance, CreateSandboxOptions, PromptOptions, TaskOptions } from '@tangle-network/sandbox';
 export { AgentProfile, CreateSandboxOptions, SandboxEvent, SandboxInstance } from '@tangle-network/sandbox';
-import { a as ResultBlobStore, f as SpawnJournal, N as NodeId, j as SpawnEvent, E as ExecutorFactory, A as Agent, B as Budget, S as Scope, h as Settled, b as SupervisedResult, i as Spend, U as UsageEvent, e as ExecutorRegistry, k as Supervisor } from './types-DHLXdLVN.js';
-export { d as AgentSpec, c as Executor, l as ExecutorContext, m as ExecutorResult, R as Runtime, n as SupervisorOpts, T as TreeView, W as WidenGate } from './types-DHLXdLVN.js';
-import { M as MakeWorkerAgent, A as AnalystRegistry, o as CoordinationTools, n as CoordinationEvent, as as QuestionPolicy, E as ExecutorConfig } from './coordination-pOGZuYS7.js';
-export { bh as BusEvent, bi as BusRecord, bj as BusStats, bk as EventBus, bl as ProviderSeam, bm as PublishOptions, bn as cliWorktreeExecutor, bo as createEventBus, bp as createExecutor, bq as createExecutorRegistry } from './coordination-pOGZuYS7.js';
-import { R as RuntimeHooks, I as Iteration, S as SandboxClient, D as Driver, d as AgentRunSpec, c as OutputAdapter, V as Validator, E as ExecCtx, X as LoopWinner, Y as LoopLineageOptions, Z as LoopResult, L as LoopTokenUsage, a as RuntimeStreamEvent, _ as MountRecorder, k as AgentExecutionBackend, b as AgentTaskStatus, B as BackendErrorDetail, $ as SelectionReceipt } from './types-Kjr5W6OF.js';
-export { a0 as LoopDecisionPayload, a1 as LoopEndedPayload, a2 as LoopIterationDispatchPayload, a3 as LoopIterationEndedPayload, a4 as LoopIterationStartedPayload, a5 as LoopPlanDescription, a6 as LoopPlanPayload, f as LoopSandboxPlacement, a7 as LoopStartedPayload, a8 as LoopTeardownFailedPayload, g as LoopTraceEmitter, e as LoopTraceEvent, a9 as MountManifestEntry, aa as RunProvenance, ab as ValidationCtx } from './types-Kjr5W6OF.js';
+import { a as ResultBlobStore, f as SpawnJournal, N as NodeId, j as SpawnEvent, E as ExecutorFactory, A as Agent, B as Budget, S as Scope, h as Settled, b as SupervisedResult, i as Spend, U as UsageEvent, e as ExecutorRegistry, k as Supervisor } from './types-CogNCaw7.js';
+export { d as AgentSpec, c as Executor, l as ExecutorContext, m as ExecutorResult, R as Runtime, n as SupervisorOpts, T as TreeView, W as WidenGate } from './types-CogNCaw7.js';
+import { M as MakeWorkerAgent, A as AnalystRegistry, o as CoordinationTools, n as CoordinationEvent, as as QuestionPolicy, E as ExecutorConfig } from './coordination-o0TzS7Ms.js';
+export { bh as BusEvent, bi as BusRecord, bj as BusStats, bk as EventBus, bl as ProviderSeam, bm as PublishOptions, bn as cliWorktreeExecutor, bo as createEventBus, bp as createExecutor, bq as createExecutorRegistry } from './coordination-o0TzS7Ms.js';
+import { R as RuntimeHooks, I as Iteration, S as SandboxClient, D as Driver, d as AgentRunSpec, c as OutputAdapter, V as Validator, E as ExecCtx, X as LoopWinner, Y as LoopLineageOptions, Z as LoopResult, L as LoopTokenUsage, a as RuntimeStreamEvent, _ as MountRecorder, k as AgentExecutionBackend, b as AgentTaskStatus, B as BackendErrorDetail, $ as SelectionReceipt } from './types-CKmyZ9TP.js';
+export { a0 as LoopDecisionPayload, a1 as LoopEndedPayload, a2 as LoopIterationDispatchPayload, a3 as LoopIterationEndedPayload, a4 as LoopIterationStartedPayload, a5 as LoopPlanDescription, a6 as LoopPlanPayload, f as LoopSandboxPlacement, a7 as LoopStartedPayload, a8 as LoopTeardownFailedPayload, g as LoopTraceEmitter, e as LoopTraceEvent, a9 as MountManifestEntry, aa as RunProvenance, ab as ValidationCtx } from './types-CKmyZ9TP.js';
 import { RunProfileMatrixResult, Scenario, ProfileDispatchFn, JudgeConfig, RunProfileMatrixOptions, DispatchFn } from '@tangle-network/agent-eval/campaign';
 export { AgentEnvironmentProviderRef, AgentEnvironmentProviderRegistry, ProviderAsSandboxClientOptions, ProviderExecutorOptions, SandboxClientProviderOptions, createAgentEnvironmentProviderRegistry, providerAsExecutor, providerAsSandboxClient, resolveAgentEnvironmentProvider, sandboxClientAsProvider } from './environment-provider.js';
-import { C as CorpusRecord, c as Corpus, O as Outcome, S as ScopeAnalyzeInput, d as AssertTraceDerivedFindings, e as SteerContext, f as ScopeAnalyst, F as FanoutOptions, g as CombinatorShape, h as ScopeWidenGate, L as LoopUntilSpec, P as PanelSpec, i as PipelineStage, W as WinnerStrategy, j as FanoutWinnerSelector, V as VerifySpec, k as WidenSpec, l as CorpusFilter, R as RenderCorpusToInstructionsOptions, D as DefinePersonaInput, m as Persona, n as RunPersonifiedOptions, o as ShapeRegistry, p as LoopShape, E as EqualKArm, q as EqualKOnCostOptions, r as EqualKVerdict, T as TrajectoryReportOptions, s as TrajectoryReport } from './worktree-fanout-DmBvR-_O.js';
-export { A as AuthoredHarness, t as DefinePersona, u as EqualKOnCost, v as Fanout, w as FanoutSynthesis, x as FlatWidenGate, y as LoopUntil, z as LoopUntilState, B as Panel, G as PanelJudge, H as PanelVerdict, I as PatchDeliverableOptions, J as PersonaContext, K as PersonaExecutors, M as Pipeline, N as RenderCorpusToInstructions, Q as RunPersonified, U as ShapeBudget, X as ShapeContext, Y as TrajectoryNode, Z as TrajectoryReportFn, _ as Verify, $ as Widen, a0 as WidenDecision, a1 as WidenLineage, a2 as WorktreeCliExecutorOptions, a as WorktreeFanoutOptions, b as WorktreePatchArtifact, a3 as createWorktreeCliExecutor, a4 as patchDelivered, a5 as worktreeFanout } from './worktree-fanout-DmBvR-_O.js';
+import { C as CorpusRecord, c as Corpus, O as Outcome, S as ScopeAnalyzeInput, d as AssertTraceDerivedFindings, e as SteerContext, f as ScopeAnalyst, F as FanoutOptions, g as CombinatorShape, h as ScopeWidenGate, L as LoopUntilSpec, P as PanelSpec, i as PipelineStage, W as WinnerStrategy, j as FanoutWinnerSelector, V as VerifySpec, k as WidenSpec, l as CorpusFilter, R as RenderCorpusToInstructionsOptions, D as DefinePersonaInput, m as Persona, n as RunPersonifiedOptions, o as ShapeRegistry, p as LoopShape, E as EqualKArm, q as EqualKOnCostOptions, r as EqualKVerdict, T as TrajectoryReportOptions, s as TrajectoryReport } from './worktree-fanout-BJy24LYe.js';
+export { A as AuthoredHarness, t as DefinePersona, u as EqualKOnCost, v as Fanout, w as FanoutSynthesis, x as FlatWidenGate, y as LoopUntil, z as LoopUntilState, B as Panel, G as PanelJudge, H as PanelVerdict, I as PatchDeliverableOptions, J as PersonaContext, K as PersonaExecutors, M as Pipeline, N as RenderCorpusToInstructions, Q as RunPersonified, U as ShapeBudget, X as ShapeContext, Y as TrajectoryNode, Z as TrajectoryReportFn, _ as Verify, $ as Widen, a0 as WidenDecision, a1 as WidenLineage, a2 as WorktreeCliExecutorOptions, a as WorktreeFanoutOptions, b as WorktreePatchArtifact, a3 as createWorktreeCliExecutor, a4 as patchDelivered, a5 as worktreeFanout } from './worktree-fanout-BJy24LYe.js';
 import { b as AnalystRegistryLike } from './types-BC3bZpH0.js';
 import { AgentProfile as AgentProfile$1 } from '@tangle-network/agent-interface';
-import { R as RouterConfig, T as ToolLoopChat, a as ToolLoopCompactionOptions } from './sanitize-Dr3SliRC.js';
-export { j as RouterChatResult, k as RouterChatToolsResult, l as RouterToolCall, m as RouterToolLoopResult, n as ToolLoopCompaction, b as ToolSpec, r as routerBrain, o as routerChatWithTools, p as routerChatWithUsage, q as routerToolLoop } from './sanitize-Dr3SliRC.js';
-import { D as DeliverableSpec } from './completion-gate-CfX2thvL.js';
-export { g as WorktreeCommandResult, h as gateOnDeliverable } from './completion-gate-CfX2thvL.js';
-import { S as SupervisorProfile } from './supervise-Y3w878fN.js';
-export { D as DriveHarness, a as SuperviseOptions, b as SupervisorAgentDeps, s as supervise, c as supervisorAgent, w as workerFromBackend } from './supervise-Y3w878fN.js';
+import { R as RouterConfig, T as ToolLoopChat, a as ToolLoopCompactionOptions } from './sanitize-Dcbjp0tU.js';
+export { j as RouterChatResult, k as RouterChatToolsResult, l as RouterToolCall, m as RouterToolLoopResult, n as ToolLoopCompaction, b as ToolSpec, r as routerBrain, o as routerChatWithTools, p as routerChatWithUsage, q as routerToolLoop } from './sanitize-Dcbjp0tU.js';
+import { D as DeliverableSpec } from './completion-gate-tzwyyD-E.js';
+export { g as WorktreeCommandResult, h as gateOnDeliverable } from './completion-gate-tzwyyD-E.js';
+import { S as SupervisorProfile } from './supervise-CRwaJIkd.js';
+export { D as DriveHarness, a as SuperviseOptions, b as SupervisorAgentDeps, s as supervise, c as supervisorAgent, w as workerFromBackend } from './supervise-CRwaJIkd.js';
 import { stuckLoopView, toolWasteView } from '@tangle-network/agent-eval/pipelines';
 export { AgentEnvironment, AgentEnvironmentCapabilities, AgentEnvironmentEvent, AgentEnvironmentProvider, AgentEnvironmentQuery, AgentEnvironmentStatus, AgentEnvironmentSummary, AgentProfileRef, AgentSession, AgentSessionRef, AgentSessionStatus, AgentTurnInput, AgentTurnResult, CheckpointRef, CheckpointRequest, CreateAgentEnvironmentInput, ExecRequest, ExecResult, ForkRequest, PlacementInfo, ResourceRequest, WorkspaceRequest } from '@tangle-network/agent-interface/environment-provider';
 import './substrate-DO2GHNg2.js';
-import './local-harness-CePtFrwu.js';
+import './local-harness-ZLMkKdZc.js';
 import 'node:child_process';
 
 /**
@@ -641,7 +641,7 @@ interface LeaderboardSpec<TCase, TArtifact = string> {
      * an out-of-family model expands to the `default` sentinel): the RunRecord
      * must pin a real snapshot-bearing model id, which only the dispatch —
      * reading the backend's usage/terminal events — can know. When this returns
-     * a value the default dispatch reports it via `ctx.cost.observeModel`;
+     * a value the default dispatch records it on the paid-call receipt;
      * in-family cells (concrete declared model) never need it.
      */
     resolveModel?: (events: readonly SandboxEvent[]) => string | undefined;
@@ -657,6 +657,9 @@ interface LeaderboardSpec<TCase, TArtifact = string> {
     shots?: number;
     /** Replicates per cell (`--reps`). Default 1. */
     reps?: number;
+    /** Provider- or executor-enforced maximum for one cell dispatch. Required
+     * before execution when `matrix.costCeiling` is configured. */
+    maximumCharge?: MaximumCharge | ((profile: AgentProfile, scenario: LeaderboardScenario<TCase>) => MaximumCharge | undefined);
     /** Passthrough overrides spread onto the final `runProfileMatrix` call
      *  (e.g. `maxConcurrency`, `costCeiling`, `integrity`, `storage`) — spread
      *  LAST, so anything the facade wired can be overridden. */
@@ -1033,6 +1036,11 @@ interface LoopDispatchOptions<Task, Output, Decision, TScenario extends Scenario
     forwardTrace?: boolean;
     /** Cost-meter source label for the loop's spend. Default `'loop'`. */
     costSource?: string;
+    /** Provider- or executor-enforced maximum for this whole cell dispatch.
+     * Required by agent-eval before execution when the campaign is cost-capped. */
+    maximumCharge?: MaximumCharge | ((scenario: TScenario, profile: AgentProfile) => MaximumCharge | undefined);
+    /** Resolve the model actually served from the completed loop. */
+    resolveCostModel?: (result: LoopResult<Task, Output, Decision>, scenario: TScenario, profile: AgentProfile) => string | undefined;
 }
 /** Options for adapting plain agent-eval campaign scenarios into runtime `runLoop` cells. */
 interface LoopCampaignDispatchOptions<Task, Output, Decision, TScenario extends Scenario, TArtifact> {
@@ -1046,6 +1054,10 @@ interface LoopCampaignDispatchOptions<Task, Output, Decision, TScenario extends
     forwardTrace?: boolean;
     /** Cost-meter source label for the loop's spend. Default `'loop'`. */
     costSource?: string;
+    /** Provider- or executor-enforced maximum for this whole cell dispatch. */
+    maximumCharge?: MaximumCharge | ((scenario: TScenario) => MaximumCharge | undefined);
+    /** Resolve the model actually served from the completed loop. */
+    resolveCostModel?: (result: LoopResult<Task, Output, Decision>, scenario: TScenario) => string | undefined;
 }
 /**
  * Adapter for plain `runCampaign` scenarios. This is the runtime-side pair for
@@ -2109,10 +2121,11 @@ declare function extractLlmCallEvent(event: SandboxEvent, agentRunName: string):
  * `openSandboxRun` cell. Folds `extractLlmCallEvent` over the stream (which reads usage off EVERY backend
  * event shape), so a `runProfileMatrix` dispatch can report it to `ctx.cost`:
  *
- *     const turn = await run.start(prompt)
- *     const u = sumSandboxUsage(turn.events)
- *     if (u.input || u.output) ctx.cost.observeTokens({ input: u.input, output: u.output })
- *     if (u.costUsd) ctx.cost.observe(u.costUsd, 'sandbox-cell')
+ *     receipt: (turn) => {
+ *       const u = sumSandboxUsage(turn.events)
+ *       return { model, inputTokens: u.input, outputTokens: u.output,
+ *         ...(u.costUsd > 0 ? { actualCostUsd: u.costUsd } : {}) }
+ *     }
  *
  * Without this a cell reads `{tokens:0, cost:0}` and the backend-integrity guard correctly aborts the
  * matrix as a stub. `agentRunName` is the fallback model label for cost-only events (default `'agent'`).
@@ -4025,8 +4038,8 @@ interface TrajectoryAnalysis {
     /** Structured run summary (tool-call count, step order). Steps carry a single timestamp, so per-span
      *  duration is 0; loop/waste detection keys on call PATTERNS + cross-span windows, not durations. */
     readonly trajectory: Awaited<ReturnType<typeof buildTrajectory>>;
-    /** Full-run repeated-call view (total occurrences + window) — catches a loop the online consecutive
-     *  detector interleaves past. */
+    /** Full-run repeated-call view (total occurrences + window) — allows one intervening call so it
+     * catches a loop the online consecutive detector interleaves past. */
     readonly stuckLoop: Awaited<ReturnType<typeof stuckLoopView>>;
     /** Wasted-vs-total tool-call ratio for the run. */
     readonly toolWaste: Awaited<ReturnType<typeof toolWasteView>>;

package/dist/loops.js

@@ -102,7 +102,7 @@ import {
   watchTrace,
   widen,
   worktreeFanout
-} from "./chunk-GKZ6DFDN.js";
+} from "./chunk-7HH22XN4.js";
 import {
   acquireSandbox,
   asAuthoredProfile,
@@ -140,7 +140,7 @@ import {
   supervisorAgent,
   supervisorInstructions,
   workerFromBackend
-} from "./chunk-LWNMCOEA.js";
+} from "./chunk-FRXDOBFP.js";
 import "./chunk-DPEUKJRO.js";
 import {
   assertModelAllowed
@@ -164,8 +164,8 @@ import {
   mapSandboxEvent,
   mapSandboxToolEvent,
   sumSandboxUsage
-} from "./chunk-FVJ7M3DA.js";
-import "./chunk-WQA5Y6PD.js";
+} from "./chunk-M22PL4GH.js";
+import "./chunk-EP6RVHMX.js";
 import "./chunk-YEJR7IXO.js";
 import "./chunk-DGUM43GV.js";
 export {

package/dist/mcp/bin.js

@@ -9,14 +9,14 @@ import {
   DelegationTaskQueue,
   FileDelegationStore,
   createMcpServer
-} from "../chunk-LWNMCOEA.js";
+} from "../chunk-FRXDOBFP.js";
 import "../chunk-DPEUKJRO.js";
 import "../chunk-ISTDY47H.js";
 import "../chunk-WIPGQ4GT.js";
 import "../chunk-VSWBYWFK.js";
 import "../chunk-3MDZX7YU.js";
-import "../chunk-FVJ7M3DA.js";
-import "../chunk-WQA5Y6PD.js";
+import "../chunk-M22PL4GH.js";
+import "../chunk-EP6RVHMX.js";
 import "../chunk-YEJR7IXO.js";
 import "../chunk-DGUM43GV.js";
 

package/dist/mcp/index.d.ts

@@ -1,18 +1,18 @@
-import { S as SandboxClient, f as LoopSandboxPlacement } from '../types-Kjr5W6OF.js';
-import { F as FleetHandle, D as DelegationExecutor, a as DelegationTaskQueue, b as FeedbackStore, c as DelegateFeedbackResult, d as DelegateFeedbackArgs, U as UiAuditorDelegate, e as DelegateUiAuditArgs, f as DelegateUiAuditResult, g as DelegationHistoryResult, h as DelegationHistoryArgs, i as DelegationStatusResult, j as DelegationStatusArgs } from '../coordination-pOGZuYS7.js';
-export { A as AnalystRegistry, C as CappedDelegationTrace, k as CoderDelegate, l as CoderReview, m as CoderReviewer, n as CoordinationEvent, o as CoordinationTools, p as CoordinationToolsOptions, q as DELEGATE_DESCRIPTION, r as DELEGATE_INPUT_SCHEMA, s as DELEGATE_TOOL_NAME, t as DELEGATION_TRACE_MAX_BYTES, u as DELEGATION_TRACE_MAX_SPANS, v as DelegateArgs, w as DelegateCodeArgs, x as DelegateCodeConfig, y as DelegateCodeResult, z as DelegateHandlerOptions, B as DelegateResearchArgs, G as DelegateResearchConfig, H as DelegateResearchResult, I as DelegateResult, J as DelegateRunCtx, K as DelegateUiAuditConfig, L as DelegateUiAuditRoute, N as DelegationError, O as DelegationFeedbackSnapshot, P as DelegationHistoryEntry, Q as DelegationPersistenceError, R as DelegationProfile, S as DelegationProgress, T as DelegationRecord, V as DelegationResultPayload, W as DelegationResumeContext, X as DelegationResumeDriver, Y as DelegationResumeTick, Z as DelegationRunContext, _ as DelegationStateCorruptError, $ as DelegationStatus, a0 as DelegationStore, a1 as DelegationTaskQueueOptions, a2 as DelegationTraceCaps, a3 as DelegationTraceCollector, a4 as DelegationTraceSpan, a5 as DetachedSessionDelegateOptions, a6 as DetachedSessionRefParts, a7 as DetachedTurn, a8 as DetachedTurnResumeDriverOptions, a9 as DetachedWinnerSelection, aa as DriveTurnCapableBox, ab as DriveTurnTick, ac as FeedbackEvent, ad as FeedbackRating, ae as FeedbackRefersTo, af as FileDelegationStore, ag as FileDelegationStoreOptions, ah as FleetWorkspaceExecutorOptions, ai as InMemoryDelegationStore, aj as InMemoryFeedbackStore, ak as JsonRpcMessage, al as JsonRpcResponse, M as MakeWorkerAgent, am as McpServer, an as McpServerOptions, ao as McpToolDescriptor, ap as McpTransport, aq as Question, ar as QuestionDecision, as as QuestionPolicy, at as QuestionRecord, au as ResearchOutputShape, av as ResearchSource, aw as RunDetachedTurnOptions, ax as SettleDetachedCoderTurnOptions, ay as SettledWorker, az as SiblingSandboxExecutorOptions, aA as SubmitInput, aB as SubmitOutput, aC as TraceContext, aD as UiAuditorDelegationOutput, aE as buildDelegationTraceSpans, aF as capDelegationTrace, aG as coderTaskFromArgs, aH as composeLoopTraceEmitters, aI as createCoordinationTools, aJ as createDelegateHandler, aK as createDelegationTraceCollector, aL as createDetachedTurnResumeDriver, aM as createFleetWorkspaceExecutor, aN as createInProcessTransport, aO as createMcpServer, aP as createPropagatingTraceEmitter, aQ as createSiblingSandboxExecutor, aR as detachedSessionDelegate, aS as detachedTurnEvents, aT as eventToSnapshot, aU as formatDetachedSessionRef, aV as hashIdempotencyInput, aW as parseDetachedSessionRef, aX as readTraceContextFromEnv, aY as runDetachedTurn, aZ as settleDetachedCoderTurn, a_ as traceContextToEnv, a$ as validateDelegateArgs } from '../coordination-pOGZuYS7.js';
-import { L as LocalHarness, r as runLocalHarness } from '../local-harness-CePtFrwu.js';
-export { b as CodexExecutionEvidence, a as CodexExecutionPolicy, C as CodexTokenUsage, c as LocalHarnessResult, R as RunLocalHarnessOptions, p as parseCodexTokenUsage } from '../local-harness-CePtFrwu.js';
-import { G as GitRunner } from '../completion-gate-CfX2thvL.js';
-export { C as CreateWorktreeOptions, b as DiffOptions, c as DiffResult, R as RemoveWorktreeOptions, d as WorktreeHandle, e as captureWorktreeDiff, f as createWorktree, r as removeWorktree } from '../completion-gate-CfX2thvL.js';
+import { S as SandboxClient, f as LoopSandboxPlacement } from '../types-CKmyZ9TP.js';
+import { F as FleetHandle, D as DelegationExecutor, a as DelegationTaskQueue, b as FeedbackStore, c as DelegateFeedbackResult, d as DelegateFeedbackArgs, U as UiAuditorDelegate, e as DelegateUiAuditArgs, f as DelegateUiAuditResult, g as DelegationHistoryResult, h as DelegationHistoryArgs, i as DelegationStatusResult, j as DelegationStatusArgs } from '../coordination-o0TzS7Ms.js';
+export { A as AnalystRegistry, C as CappedDelegationTrace, k as CoderDelegate, l as CoderReview, m as CoderReviewer, n as CoordinationEvent, o as CoordinationTools, p as CoordinationToolsOptions, q as DELEGATE_DESCRIPTION, r as DELEGATE_INPUT_SCHEMA, s as DELEGATE_TOOL_NAME, t as DELEGATION_TRACE_MAX_BYTES, u as DELEGATION_TRACE_MAX_SPANS, v as DelegateArgs, w as DelegateCodeArgs, x as DelegateCodeConfig, y as DelegateCodeResult, z as DelegateHandlerOptions, B as DelegateResearchArgs, G as DelegateResearchConfig, H as DelegateResearchResult, I as DelegateResult, J as DelegateRunCtx, K as DelegateUiAuditConfig, L as DelegateUiAuditRoute, N as DelegationError, O as DelegationFeedbackSnapshot, P as DelegationHistoryEntry, Q as DelegationPersistenceError, R as DelegationProfile, S as DelegationProgress, T as DelegationRecord, V as DelegationResultPayload, W as DelegationResumeContext, X as DelegationResumeDriver, Y as DelegationResumeTick, Z as DelegationRunContext, _ as DelegationStateCorruptError, $ as DelegationStatus, a0 as DelegationStore, a1 as DelegationTaskQueueOptions, a2 as DelegationTraceCaps, a3 as DelegationTraceCollector, a4 as DelegationTraceSpan, a5 as DetachedSessionDelegateOptions, a6 as DetachedSessionRefParts, a7 as DetachedTurn, a8 as DetachedTurnResumeDriverOptions, a9 as DetachedWinnerSelection, aa as DriveTurnCapableBox, ab as DriveTurnTick, ac as FeedbackEvent, ad as FeedbackRating, ae as FeedbackRefersTo, af as FileDelegationStore, ag as FileDelegationStoreOptions, ah as FleetWorkspaceExecutorOptions, ai as InMemoryDelegationStore, aj as InMemoryFeedbackStore, ak as JsonRpcMessage, al as JsonRpcResponse, M as MakeWorkerAgent, am as McpServer, an as McpServerOptions, ao as McpToolDescriptor, ap as McpTransport, aq as Question, ar as QuestionDecision, as as QuestionPolicy, at as QuestionRecord, au as ResearchOutputShape, av as ResearchSource, aw as RunDetachedTurnOptions, ax as SettleDetachedCoderTurnOptions, ay as SettledWorker, az as SiblingSandboxExecutorOptions, aA as SubmitInput, aB as SubmitOutput, aC as TraceContext, aD as UiAuditorDelegationOutput, aE as buildDelegationTraceSpans, aF as capDelegationTrace, aG as coderTaskFromArgs, aH as composeLoopTraceEmitters, aI as createCoordinationTools, aJ as createDelegateHandler, aK as createDelegationTraceCollector, aL as createDetachedTurnResumeDriver, aM as createFleetWorkspaceExecutor, aN as createInProcessTransport, aO as createMcpServer, aP as createPropagatingTraceEmitter, aQ as createSiblingSandboxExecutor, aR as detachedSessionDelegate, aS as detachedTurnEvents, aT as eventToSnapshot, aU as formatDetachedSessionRef, aV as hashIdempotencyInput, aW as parseDetachedSessionRef, aX as readTraceContextFromEnv, aY as runDetachedTurn, aZ as settleDetachedCoderTurn, a_ as traceContextToEnv, a$ as validateDelegateArgs } from '../coordination-o0TzS7Ms.js';
+import { L as LocalHarness, r as runLocalHarness } from '../local-harness-ZLMkKdZc.js';
+export { a as CodexExecutionEvidence, b as CodexExecutionPolicy, C as CodexTokenUsage, c as LocalHarnessResult, R as RunLocalHarnessOptions, p as parseCodexTokenUsage } from '../local-harness-ZLMkKdZc.js';
+import { G as GitRunner } from '../completion-gate-tzwyyD-E.js';
+export { C as CreateWorktreeOptions, b as DiffOptions, c as DiffResult, R as RemoveWorktreeOptions, d as WorktreeHandle, e as captureWorktreeDiff, f as createWorktree, r as removeWorktree } from '../completion-gate-tzwyyD-E.js';
 export { C as CreateKbGateOptions, F as FactCandidate, a as FactJudge, b as FactJudgeVerdict, K as KbGateResult, c as createKbGate } from '../kb-gate-CwHO0vz6.js';
-export { m as mcpToolsForRuntimeMcp, a as mcpToolsForRuntimeMcpSubset } from '../openai-tools-BMOu1t3A.js';
+export { m as mcpToolsForRuntimeMcp, a as mcpToolsForRuntimeMcpSubset } from '../openai-tools-0wACz8f8.js';
 import { AnalystFinding } from '@tangle-network/agent-eval';
 import { U as UiLens } from '../substrate-DO2GHNg2.js';
 import '@tangle-network/sandbox';
-import '../types-DHLXdLVN.js';
+import '../types-CogNCaw7.js';
 import '@tangle-network/agent-interface';
-import '../sanitize-Dr3SliRC.js';
+import '../sanitize-Dcbjp0tU.js';
 import '../environment-provider.js';
 import '@tangle-network/agent-interface/environment-provider';
 import 'node:child_process';

package/dist/mcp/index.js

@@ -9,7 +9,7 @@ import {
 import {
   mcpToolsForRuntimeMcp,
   mcpToolsForRuntimeMcpSubset
-} from "../chunk-4VMRCEI6.js";
+} from "../chunk-MSUWXCHD.js";
 import {
   createKbGate
 } from "../chunk-SGKPNBXE.js";
@@ -17,7 +17,7 @@ import {
   assertTraceDerivedFindings,
   runCoderChecks,
   selectValidWinner
-} from "../chunk-GKZ6DFDN.js";
+} from "../chunk-7HH22XN4.js";
 import {
   DELEGATE_DESCRIPTION,
   DELEGATE_FEEDBACK_DESCRIPTION,
@@ -67,7 +67,7 @@ import {
   validateDelegateUiAuditArgs,
   validateDelegationHistoryArgs,
   validateDelegationStatusArgs
-} from "../chunk-LWNMCOEA.js";
+} from "../chunk-FRXDOBFP.js";
 import "../chunk-DPEUKJRO.js";
 import "../chunk-ISTDY47H.js";
 import "../chunk-WIPGQ4GT.js";
@@ -78,12 +78,12 @@ import {
   throwAbort,
   throwIfAborted
 } from "../chunk-3MDZX7YU.js";
-import "../chunk-FVJ7M3DA.js";
+import "../chunk-M22PL4GH.js";
 import {
   CodexExecutionDiagnosticError,
   parseCodexTokenUsage,
   runLocalHarness
-} from "../chunk-WQA5Y6PD.js";
+} from "../chunk-EP6RVHMX.js";
 import {
   ValidationError
 } from "../chunk-YEJR7IXO.js";

package/dist/{mcp-serve-verifier-D7hCZIkT.d.ts → mcp-serve-verifier-BO4MEsR3.d.ts}

@@ -1,4 +1,4 @@
-import { V as Verifier } from './agentic-generator-CL1q0H91.js';
+import { V as Verifier } from './agentic-generator-1g7GDba7.js';
 
 /**
  * `mcpServeVerifier` — the intrinsic verifier for a built MCP server: the

package/dist/{openai-tools-BMOu1t3A.d.ts → openai-tools-0wACz8f8.d.ts}

@@ -1,4 +1,4 @@
-import { O as OpenAIChatTool } from './types-Kjr5W6OF.js';
+import { O as OpenAIChatTool } from './types-CKmyZ9TP.js';
 
 /**
  *

package/dist/profiles.d.ts

@@ -1,7 +1,7 @@
 import { a as UiFinding, U as UiLens } from './substrate-DO2GHNg2.js';
 export { C as CoderTask, b as UI_FINDING_SEVERITIES, c as UI_LENSES, d as UiFindingScreenshot, e as UiFindingSeverity, f as coderTaskToPrompt } from './substrate-DO2GHNg2.js';
 import { AgentProfile, SandboxEvent } from '@tangle-network/sandbox';
-import { V as Validator, d as AgentRunSpec, c as OutputAdapter, D as Driver, S as SandboxClient } from './types-Kjr5W6OF.js';
+import { V as Validator, d as AgentRunSpec, c as OutputAdapter, D as Driver, S as SandboxClient } from './types-CKmyZ9TP.js';
 import { AgentProfile as AgentProfile$1 } from '@tangle-network/agent-interface';
 import '@tangle-network/agent-eval';
 

package/dist/{sanitize-Dr3SliRC.d.ts → sanitize-Dcbjp0tU.d.ts}

@@ -1,5 +1,5 @@
 import { ControlEvalResult, KnowledgeReadinessReport, KnowledgeRequirement } from '@tangle-network/agent-eval';
-import { A as AgentRuntimeEvent, a as RuntimeStreamEvent, b as AgentTaskStatus } from './types-Kjr5W6OF.js';
+import { A as AgentRuntimeEvent, a as RuntimeStreamEvent, b as AgentTaskStatus } from './types-CKmyZ9TP.js';
 
 /**
  * THE canonical agentic tool-loop. One inference turn → run any requested tools → fold the

package/dist/{supervise-Y3w878fN.d.ts → supervise-CRwaJIkd.d.ts}

@@ -1,7 +1,7 @@
-import { S as Scope, a as ResultBlobStore, B as Budget, A as Agent, b as SupervisedResult } from './types-DHLXdLVN.js';
-import { M as MakeWorkerAgent, A as AnalystRegistry, E as ExecutorConfig } from './coordination-pOGZuYS7.js';
-import { R as RouterConfig, T as ToolLoopChat, a as ToolLoopCompactionOptions } from './sanitize-Dr3SliRC.js';
-import { D as DeliverableSpec } from './completion-gate-CfX2thvL.js';
+import { S as Scope, a as ResultBlobStore, B as Budget, A as Agent, b as SupervisedResult } from './types-CogNCaw7.js';
+import { M as MakeWorkerAgent, A as AnalystRegistry, E as ExecutorConfig } from './coordination-o0TzS7Ms.js';
+import { R as RouterConfig, T as ToolLoopChat, a as ToolLoopCompactionOptions } from './sanitize-Dcbjp0tU.js';
+import { D as DeliverableSpec } from './completion-gate-tzwyyD-E.js';
 
 /** The supervisor's profile — the subset of an `AgentProfile` that selects + shapes its brain.
  *  `harness` is the backend-as-data discriminant; `systemPrompt` is the standing instruction. */

package/dist/{types-Kjr5W6OF.d.ts → types-CKmyZ9TP.d.ts}

@@ -825,10 +825,8 @@ interface AgentRunSpec<Task> {
 interface OutputAdapter<Output> {
     parse(events: SandboxEvent[]): Output;
 }
-/** LLM token usage. Structurally matches agent-eval's `RunTokenUsage` /
- *  `CampaignTokenUsage` ({ input, output }) so a loop result maps straight
- *  onto `ctx.cost.observeTokens` in a `runProfileMatrix` dispatch — without
- *  which the backend-integrity guard reads the run as a stub. */
+/** LLM token usage. Structurally maps into agent-eval's paid-call receipt so a
+ * campaign dispatch settles real usage instead of appearing as a stub. */
 interface LoopTokenUsage {
     input: number;
     output: number;
@@ -989,9 +987,8 @@ interface LoopResult<Task, Output, Decision> {
     durationMs: number;
     /** Sum of every iteration's `costUsd`. */
     costUsd: number;
-    /** Sum of every iteration's token usage. Forward to
-     *  `ctx.cost.observeTokens` in a `runProfileMatrix` dispatch so the
-     *  integrity guard sees real LLM activity. */
+    /** Sum of every iteration's token usage. `loopDispatch` commits it through
+     *  the campaign's paid-call receipt. */
     tokenUsage: LoopTokenUsage;
     /** Domain-free run provenance for auditability: the mount manifest recorded
      *  during `prepareBox` and the selection receipts for how the winner was

package/dist/{types-DHLXdLVN.d.ts → types-CogNCaw7.d.ts}

@@ -1,7 +1,7 @@
 import { DefaultVerdict } from '@tangle-network/agent-eval';
 import { AgentProfile } from '@tangle-network/agent-interface';
 import { BackendType } from '@tangle-network/sandbox';
-import { L as LoopTokenUsage, R as RuntimeHooks } from './types-Kjr5W6OF.js';
+import { L as LoopTokenUsage, R as RuntimeHooks } from './types-CKmyZ9TP.js';
 
 /**
  *

package/dist/{worktree-fanout-DmBvR-_O.d.ts → worktree-fanout-BJy24LYe.d.ts}

@@ -1,10 +1,10 @@
 import { AgentProfile } from '@tangle-network/agent-interface';
 import { AnalystFinding, DefaultVerdict } from '@tangle-network/agent-eval';
-import { d as AgentSpec, e as ExecutorRegistry, B as Budget, A as Agent, f as SpawnJournal, a as ResultBlobStore, g as RootHandle, b as SupervisedResult, N as NodeId, h as Settled, i as Spend, S as Scope, c as Executor } from './types-DHLXdLVN.js';
-import { R as RuntimeHooks, I as Iteration } from './types-Kjr5W6OF.js';
+import { d as AgentSpec, e as ExecutorRegistry, B as Budget, A as Agent, f as SpawnJournal, a as ResultBlobStore, g as RootHandle, b as SupervisedResult, N as NodeId, h as Settled, i as Spend, S as Scope, c as Executor } from './types-CogNCaw7.js';
+import { R as RuntimeHooks, I as Iteration } from './types-CKmyZ9TP.js';
 import { BackendType } from '@tangle-network/sandbox';
-import { W as WorktreeHarnessResult, G as GitRunner, a as WorktreeCheckRunner, D as DeliverableSpec } from './completion-gate-CfX2thvL.js';
-import { L as LocalHarness, r as runLocalHarness } from './local-harness-CePtFrwu.js';
+import { W as WorktreeHarnessResult, G as GitRunner, a as WorktreeCheckRunner, D as DeliverableSpec } from './completion-gate-tzwyyD-E.js';
+import { L as LocalHarness, r as runLocalHarness } from './local-harness-ZLMkKdZc.js';
 
 /**
  *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tangle-network/agent-runtime",
-  "version": "0.94.6",
+  "version": "0.94.7",
   "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": {
@@ -104,7 +104,7 @@
   },
   "devDependencies": {
     "@biomejs/biome": "^2.4.15",
-    "@tangle-network/agent-eval": "^0.115.1",
+    "@tangle-network/agent-eval": "0.117.1",
     "@tangle-network/agent-interface": "^0.25.0",
     "@tangle-network/sandbox": "^0.9.7",
     "@types/node": "^25.9.3",
@@ -135,7 +135,7 @@
   "license": "MIT",
   "packageManager": "pnpm@10.28.0",
   "peerDependencies": {
-    "@tangle-network/agent-eval": ">=0.115.1 <1.0.0",
+    "@tangle-network/agent-eval": ">=0.117.1 <1.0.0",
     "@tangle-network/agent-interface": ">=0.25.0 <1.0.0",
     "@tangle-network/sandbox": ">=0.8.0 <1.0.0",
     "playwright": "^1.40.0"