@tangle-network/agent-runtime 0.84.0 → 0.86.0

package/dist/loop-runner-bin.js

@@ -2,10 +2,10 @@
 import {
   parseLoopRunnerArgv,
   runLoopRunnerCli
-} from "./chunk-XBSWWF6A.js";
+} from "./chunk-EJ7MAQN4.js";
 import "./chunk-SGKPNBXE.js";
-import "./chunk-UJW6EVNY.js";
-import "./chunk-XN5TIJGP.js";
+import "./chunk-3TZOXS7B.js";
+import "./chunk-F7OO2SKB.js";
 import "./chunk-UD4BHQMI.js";
 import "./chunk-BZF3KQ6G.js";
 import "./chunk-YPA5MLVE.js";

package/dist/loops.d.ts

@@ -6,7 +6,7 @@ import { d as ResultBlobStore, S as SpawnJournal, N as NodeId, j as SpawnEvent,
 export { A as AgentSpec, a as Executor, l as ExecutorContext, m as ExecutorResult, R as Runtime, n as SupervisorOpts, T as TreeView, W as WidenGate } from './types-Driepl87.js';
 import { ak as MakeWorkerAgent, A as AnalystRegistry, o as CoordinationTools, n as CoordinationEvent, ar as QuestionPolicy, a$ as ExecutorConfig } from './coordination-CuDLO8wj.js';
 export { b0 as BusEvent, b1 as BusRecord, b2 as BusStats, b3 as EventBus, b4 as ProviderSeam, b5 as PublishOptions, b6 as cliWorktreeExecutor, b7 as createEventBus, b8 as createExecutor, b9 as createExecutorRegistry } from './coordination-CuDLO8wj.js';
-import { R as RuntimeHooks, I as Iteration, S as SandboxClient, W as Driver, A as AgentRunSpec, b 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 } from './types-ESeMOj94.js';
+import { R as RuntimeHooks, I as Iteration, S as SandboxClient, W as Driver, A as AgentRunSpec, b 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, i as AgentExecutionBackend, o as AgentTaskStatus, B as BackendErrorDetail } from './types-ESeMOj94.js';
 export { $ as LoopDecisionPayload, a0 as LoopEndedPayload, a1 as LoopIterationDispatchPayload, a2 as LoopIterationEndedPayload, a3 as LoopIterationStartedPayload, a4 as LoopPlanDescription, a5 as LoopPlanPayload, d as LoopSandboxPlacement, a6 as LoopStartedPayload, a7 as LoopTeardownFailedPayload, e as LoopTraceEmitter, c as LoopTraceEvent, a8 as MountManifestEntry, a9 as RunProvenance, aa as SelectionReceipt, ab as ValidationCtx } from './types-ESeMOj94.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';
@@ -544,8 +544,10 @@ interface LeaderboardBenchScore {
     detail?: string;
 }
 /** Structurally `BenchmarkAdapter` (bench registry shape): `name`,
- *  `preflight()`, `loadTasks()`, deterministic `judge()`, `goldArtifact()`. */
-interface LeaderboardBenchmarkAdapter {
+ *  `preflight()`, `loadTasks()`, deterministic `judge()`, `goldArtifact()`.
+ *  Generic over the artifact channel; the `string` default IS the registry
+ *  shape, so a default-artifact adapter registers unchanged. */
+interface LeaderboardBenchmarkAdapter<TArtifact = string> {
     readonly name: string;
     preflight(): Promise<void>;
     loadTasks(opts?: {
@@ -553,10 +555,29 @@ interface LeaderboardBenchmarkAdapter {
         split?: string;
         ids?: string[];
     }): Promise<LeaderboardBenchTask[]>;
-    judge(task: LeaderboardBenchTask, artifact: string): Promise<LeaderboardBenchScore>;
+    judge(task: LeaderboardBenchTask, artifact: TArtifact): Promise<LeaderboardBenchScore>;
     goldArtifact(task: LeaderboardBenchTask): Promise<string | undefined>;
 }
-interface LeaderboardSpec<TCase> {
+/** Per-shot outcome context passed as `onCellEvents`'s third argument — how a
+ *  thrown shot (which never reaches `parseOutput`) stays visible through the
+ *  facade instead of surfacing only as an empty zero-token cell. */
+interface LeaderboardIterationInfo {
+    /** 0-based shot index within the cell. */
+    index: number;
+    /** The shot's thrown error message, when the shot failed before scoring. */
+    error?: string;
+    /** The shot's validator verdict, when the shot reached scoring. */
+    verdict?: {
+        score?: number;
+    };
+}
+/**
+ * The declarative leaderboard spec. `TArtifact` is the artifact channel the
+ * dispatch produces and the judges score — `string` (the default) is the plain
+ * agent-response-text path; a structured artifact type flows natively once the
+ * spec supplies `parseOutput` (or a LEVEL-2 `dispatch`) producing it.
+ */
+interface LeaderboardSpec<TCase, TArtifact = string> {
     /** Leaderboard name — the scenario `kind`, default profile name, and report title. */
     name: string;
     /** The case corpus. Every case needs a stable string id (see `caseId`). */
@@ -567,10 +588,10 @@ interface LeaderboardSpec<TCase> {
     /** The per-case task prompt. May be async (e.g. built by shelling out to a
      *  reference implementation); resolved ONCE per case before dispatch. */
     prompt: (c: TCase) => string | Promise<string>;
-    /** The domain grader: agent output text → score. Used BOTH as the per-shot
-     *  validator (a shot with `composite > 0` stops the naive retry loop) and,
-     *  wrapped as a campaign judge, as the recorded leaderboard score. */
-    score: (output: string, c: TCase) => number | LeaderboardScore;
+    /** The domain grader: agent output artifact → score. Used BOTH as the
+     *  per-shot validator (a shot with `composite > 0` stops the naive retry
+     *  loop) and, wrapped as a campaign judge, as the recorded leaderboard score. */
+    score: (output: TArtifact, c: TCase) => number | LeaderboardScore;
     /** Harness × model axes for `expandProfileAxes`. Defaults: the canonical
      *  `CODING_HARNESSES` × the base profile's `model.default`. `--harnesses` /
      *  `--models` override per run. */
@@ -601,22 +622,36 @@ interface LeaderboardSpec<TCase> {
     setup?: (ctx: LeaderboardRunContext) => Promise<void> | void;
     /** Runs once after the matrix, even on failure (reap boxes, close handles). */
     teardown?: (ctx: LeaderboardRunContext) => Promise<void> | void;
-    /** Per-cell event tap: the raw sandbox events of each parsed iteration,
-     *  with the case — the seam for domain metric capture (search counts,
-     *  citations) without a substrate change. */
-    onCellEvents?: (events: readonly SandboxEvent[], c: TCase) => void;
-    /** Output decode override: raw events → the scored output text. Default:
-     *  the sandbox SDK's `collectAgentResponseText` (final answer text; empty
-     *  string when the stream carried none — which then scores 0). */
-    parseOutput?: (events: readonly SandboxEvent[], c: TCase) => string;
+    /** Per-cell event tap: the raw sandbox events of EVERY shot, with the case —
+     *  the seam for domain metric capture (search counts, citations) without a
+     *  substrate change. Fires once per shot after the cell's loop settles, in
+     *  shot order, including thrown shots (whose events may be partial or empty);
+     *  the third argument carries the shot's index + error/verdict outcome. */
+    onCellEvents?: (events: readonly SandboxEvent[], c: TCase, iteration?: LeaderboardIterationInfo) => void;
+    /** Output decode override: raw events → the scored artifact. Default: the
+     *  sandbox SDK's `collectAgentResponseText` (final answer text; empty string
+     *  when the stream carried none — which then scores 0). The default only
+     *  produces `string`, so a spec with a structured `TArtifact` MUST supply
+     *  this (or a LEVEL-2 `dispatch`). */
+    parseOutput?: (events: readonly SandboxEvent[], c: TCase) => TArtifact;
+    /**
+     * Resolve the model the backend ACTUALLY served off a shot's raw events.
+     * Required for HARNESS_NATIVE_MODEL-snapped cells (a vendor-locked harness ×
+     * 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`;
+     * in-family cells (concrete declared model) never need it.
+     */
+    resolveModel?: (events: readonly SandboxEvent[]) => string | undefined;
     /** Result export. Default: write `matrix-result.json` under the run dir and
      *  print (+ write) the ranked leaderboard markdown under the export dir. */
-    export?: (result: RunProfileMatrixResult<string, LeaderboardScenario<TCase>>, ctx: LeaderboardRunContext) => Promise<void> | void;
+    export?: (result: RunProfileMatrixResult<TArtifact, LeaderboardScenario<TCase>>, ctx: LeaderboardRunContext) => Promise<void> | void;
     /** LEVEL 2 — full dispatch replacement (in-process products bring their own).
      *  The default is `loopDispatch` + `naiveDriver` over the resolved backend. */
-    dispatch?: ProfileDispatchFn<LeaderboardScenario<TCase>, string>;
+    dispatch?: ProfileDispatchFn<LeaderboardScenario<TCase>, TArtifact>;
     /** LEVEL 2 — full judge replacement. Default: `score` wrapped as one judge. */
-    judges?: JudgeConfig<string, LeaderboardScenario<TCase>>[];
+    judges?: JudgeConfig<TArtifact, LeaderboardScenario<TCase>>[];
     /** Naive-retry shot cap per cell (`--shots`). Default 1. */
     shots?: number;
     /** Replicates per cell (`--reps`). Default 1. */
@@ -624,9 +659,9 @@ interface LeaderboardSpec<TCase> {
     /** Passthrough overrides spread onto the final `runProfileMatrix` call
      *  (e.g. `maxConcurrency`, `costCeiling`, `integrity`, `storage`) — spread
      *  LAST, so anything the facade wired can be overridden. */
-    matrix?: Partial<RunProfileMatrixOptions<LeaderboardScenario<TCase>, string>>;
+    matrix?: Partial<RunProfileMatrixOptions<LeaderboardScenario<TCase>, TArtifact>>;
 }
-interface DefinedLeaderboard<TCase> {
+interface DefinedLeaderboard<TCase, TArtifact = string> {
     /**
      * Parse flags, run the matrix, export, and return the raw result.
      *
@@ -640,11 +675,11 @@ interface DefinedLeaderboard<TCase> {
      * would silently reuse a prior FAILED zero-token cell and skip dispatch —
      * only an explicit `--run-dir` opts into that resume behavior.
      */
-    run(argv?: string[]): Promise<RunProfileMatrixResult<string, LeaderboardScenario<TCase>>>;
+    run(argv?: string[]): Promise<RunProfileMatrixResult<TArtifact, LeaderboardScenario<TCase>>>;
     /** The same domain surface in the structural `BenchmarkAdapter` shape. */
-    toBenchmarkAdapter(): LeaderboardBenchmarkAdapter;
+    toBenchmarkAdapter(): LeaderboardBenchmarkAdapter<TArtifact>;
 }
-declare function defineLeaderboard<TCase>(spec: LeaderboardSpec<TCase>): DefinedLeaderboard<TCase>;
+declare function defineLeaderboard<TCase, TArtifact = string>(spec: LeaderboardSpec<TCase, TArtifact>): DefinedLeaderboard<TCase, TArtifact>;
 
 /**
  * The third-person observer — the connective tissue that closes the loop.
@@ -2745,6 +2780,136 @@ declare function selectChampion(report: BenchmarkReport, fieldOrder: string[], p
 /** Multi-generation strategy search: author candidates from tournament losses, play them against the incumbent at equal budget, promote via `promotionGate` on an untouched holdout slice. */
 declare function runStrategyEvolution(cfg: StrategyEvolutionConfig): Promise<EvolutionReport>;
 
+/**
+ * `streamAgentTurn` — the ONE run-a-turn event-stream contract over every
+ * execution substrate: a sandbox box (`SandboxInstance.streamPrompt`), a
+ * one-shot `Executor` (cli-bridge / router / BYO, via `ExecutorFactory`), and
+ * an in-process `AgentExecutionBackend` (the `resolveAgentBackend` output).
+ *
+ * One function, one vocabulary: every backend kind yields the existing
+ * `RuntimeStreamEvent` union incrementally and ALWAYS terminates with a
+ * `final` event whose `text` is the turn's final text and whose
+ * `metadata.tokenUsage` / `metadata.costUsd` / `metadata.model` carry the
+ * turn's metered usage. `collectAgentTurn` drains a stream into that terminal
+ * summary plus the full event list.
+ *
+ * This is a UNIFICATION seam, not a new stream parser — each kind is a thin
+ * adapter over code that already exists and is already hardened:
+ *   - `box`      — `mapSandboxEvent` + `extractLlmCallEvent` (sandbox-events.ts)
+ *                  project the sandbox event stream; nothing is re-mapped here.
+ *   - `executor` — `inlineSandboxClient` (the ONE executor→box adapter) turns
+ *                  the factory into a box, then the box path drives it. The
+ *                  executor's settle/teardown lifecycle stays in that adapter.
+ *   - `chat`     — the backend's own `stream()` surface, normalized by
+ *                  `normalizeBackendStreamEvent` (the same projection
+ *                  `runAgentTaskStream` applies).
+ *
+ * Distinct from `openSandboxRun` (box-only, session resume over one persistent
+ * artifact, raw `SandboxEvent` deliverables) and from `runAgentTaskStream`
+ * (full task lifecycle: knowledge preflight, session store, resume). This is
+ * the minimal turn primitive underneath both worlds: prompt in, one normalized
+ * event stream out, terminal result+usage guaranteed on every non-thrown path.
+ *
+ * Stream envelope: `backend_start` → incremental events → (`backend_error` on
+ * failure) → `final`. A caller-initiated abort terminates with
+ * `final.status: 'aborted'`; an expired `timeoutMs` deadline with
+ * `final.status: 'failed'` — so cancellation stays distinguishable from a
+ * blown deadline.
+ *
+ * @experimental
+ */
+
+/**
+ * The execution substrate one turn runs on — a closed discriminated union over
+ * the three stream surfaces the runtime already owns.
+ *
+ * @experimental
+ */
+type AgentTurnBackend = {
+    /** A live sandbox box: the turn is one `box.streamPrompt(prompt)` call. */
+    kind: 'box';
+    box: SandboxInstance;
+    /** Model label stamped on cost-only `llm_call` events. Default `'agent'`. */
+    agentRunName?: string;
+} | {
+    /**
+     * A one-shot `Executor` (cli-bridge / router / BYO): the factory is
+     * instantiated fresh for the turn via `inlineSandboxClient`, run once on
+     * the prompt, and torn down — the same per-spawn lifecycle the supervise
+     * runtime gives it.
+     */
+    kind: 'executor';
+    factory: ExecutorFactory<unknown>;
+    /** Model label stamped on cost-only `llm_call` events. Default `'agent'`. */
+    agentRunName?: string;
+} | {
+    /**
+     * An in-process `AgentExecutionBackend` (`resolveAgentBackend` output or
+     * any custom backend): the turn is one `backend.stream()` call.
+     */
+    kind: 'chat';
+    backend: AgentExecutionBackend;
+};
+/** @experimental */
+interface StreamAgentTurnOptions {
+    /** Caller-initiated cancellation. Terminates the stream with `final.status: 'aborted'`. */
+    signal?: AbortSignal;
+    /**
+     * Wall-clock deadline for the whole turn in ms. An expired deadline aborts
+     * the backend and terminates the stream with `final.status: 'failed'`
+     * (a blown deadline is a turn failure, not a caller cancellation).
+     */
+    timeoutMs?: number;
+}
+/**
+ * Metered usage of one turn, summed over every cost-bearing event the backend
+ * emitted. `input`/`output` are token counts (0 when the backend reported
+ * none — the honest sum, never a fabricated estimate). `costUsd`/`model` are
+ * present only when the backend actually reported them.
+ *
+ * @experimental
+ */
+interface AgentTurnUsage {
+    input: number;
+    output: number;
+    costUsd?: number;
+    model?: string;
+}
+/**
+ * A drained turn: the terminal summary plus every event the stream yielded.
+ * `status`/`error` mirror the terminal `final` event so a failed or aborted
+ * turn stays inspectable without re-scanning `events`.
+ *
+ * @experimental
+ */
+interface CollectedAgentTurn {
+    finalText: string;
+    usage: AgentTurnUsage;
+    events: RuntimeStreamEvent[];
+    status: AgentTaskStatus;
+    error?: BackendErrorDetail;
+}
+/**
+ * Run ONE agent turn on any backend kind and stream its events. Yields the
+ * `RuntimeStreamEvent` vocabulary incrementally and always ends with a `final`
+ * event carrying the turn's text and usage (`metadata.tokenUsage`,
+ * `metadata.costUsd?`, `metadata.model?`) — on success, failure, abort, and
+ * timeout alike. The generator never throws; failures surface in-band as
+ * `backend_error` + `final` with a typed `error` detail.
+ *
+ * @experimental
+ */
+declare function streamAgentTurn(backend: AgentTurnBackend, prompt: string, opts?: StreamAgentTurnOptions): AsyncGenerator<RuntimeStreamEvent>;
+/**
+ * Drain a `streamAgentTurn` stream (or any `RuntimeStreamEvent` stream that
+ * honors its terminal contract) into the turn summary plus the full event
+ * list. Fail-loud: throws when the stream ends without a terminal `final`
+ * event — a stream that violates the contract must not read as an empty turn.
+ *
+ * @experimental
+ */
+declare function collectAgentTurn(stream: AsyncIterable<RuntimeStreamEvent>): Promise<CollectedAgentTurn>;
+
 /**
  *
  * The supervisor's intelligence is AUTHORING the agents it spawns — not pressing buttons.
@@ -3778,4 +3943,4 @@ declare function runInWorkspace<T>(ws: Workspace, body: (cwd: string) => Promise
     commitOnInvalid?: boolean;
 }): Promise<WorkspaceRun<T>>;
 
-export { Agent, AgentRunSpec, type AgenticOptions, type AgenticRunResult, type AgenticSurface, type AgenticTask, type AgenticTool, AnalystRegistry, type AnytimeReport, type AnytimeStrategySummary, type AnytimeTaskCurve, type ApplyContinuation, type ArtifactHandle, AssertTraceDerivedFindings, type AuditIntentInput, type AuditIntentOptions, type AuthorStrategyOptions, type AuthoredProfile, type AuthoredStrategy, type BenchmarkCell, type BenchmarkConfig, type BenchmarkLift, type BenchmarkReport, type BenchmarkStrategySummary, type BenchmarkTaskRow, Budget, type BudgetPool, type BudgetReadout, type ChampionPick, type ChampionPolicy, type CheckpointCapableBox, CombinatorShape, type CompletionAnalyst, type CompletionEvidence, type CompletionPolicy, type CompletionVerdict, CoordinationEvent, type CoordinationMcpHandle, Corpus, CorpusFilter, CorpusRecord, type CreateScopeAnalystOptions, type CriuCapableClient, DefinePersonaInput, type DefinedLeaderboard, type DelegateOptions, type Deliverable, DeliverableSpec, type DriveHarness, Driver, type DriverAgentOptions, type DumbDriverOptions, type Environment, EqualKArm, EqualKOnCostOptions, EqualKVerdict, type EvolutionArchiveNode, type EvolutionAuthor, type EvolutionBandInfo, type EvolutionCandidate, type EvolutionGeneration, type EvolutionReport, ExecCtx, ExecutorConfig, ExecutorFactory, ExecutorRegistry, FanoutOptions, FanoutWinnerSelector, FileCorpus, type ForkCapableBox, type GitWorkspaceOptions, type HarvestCorpusOptions, type HarvestFailure, type HarvestReport, InMemoryCorpus, InMemoryResultBlobStore, type InMemoryRunContext, type InMemoryRunContextOptions, InMemorySpawnJournal, type InProcessOnPrompt, type InProcessPromptCtx, type InProcessSandboxClientOptions, type Inbox, type InboxMessage, type IntentAudit, type Interval, Iteration, type Leaderboard, type LeaderboardBenchScore, type LeaderboardBenchTask, type LeaderboardBenchmarkAdapter, type LeaderboardFlagSpec, type LeaderboardOptions, type LeaderboardRow, type LeaderboardRunContext, type LeaderboardScenario, type LeaderboardScore, type LeaderboardSpec, type LoopCampaignDispatchOptions, type LoopDispatchOptions, LoopLineageOptions, type LoopOptionsForDispatch, LoopResult, LoopShape, LoopTokenUsage, LoopUntilSpec, LoopWinner, MakeWorkerAgent, type McpEndpoint, type McpEnvironmentOptions, MountRecorder, type NaiveDriverOptions, type Observation, type ObserveInput, type ObserveOptions, type OpenSandboxRunOptions, Outcome, OutputAdapter, type PairwiseOptions, type PairwiseVerdict, PanelSpec, Persona, PipelineStage, type ProfileRichness, type ProfileRichnessThresholds, type PromotionGateOptions, type PromotionVerdict, type RegistryAnalyzeProjection, RenderCorpusToInstructionsOptions, type ReservationTicket, type ResolveSandboxClientOptions, ResultBlobStore, RouterConfig, type RunAgenticOptions, RunPersonifiedOptions, type SandboxCapabilities, SandboxClient, type SandboxLineage, type SandboxLineageHandle, type SandboxRun, SandboxRunAbortError, Scope, ScopeAnalyst, ScopeAnalyzeInput, ScopeWidenGate, type SessionCapableBox, type SessionTraceBox, Settled, ShapeRegistry, type Shell, type ShotPersona, type ShotSpec, Spend, SteerContext, type SteeringDecision, type Strategy, type StrategyCtx, type StrategyEvolutionConfig, type StrategyResult, type SuperviseOptions, type SuperviseSurfaceOptions, type SuperviseSurfaceResult, SupervisedResult, Supervisor, type SupervisorAgentDeps, type SupervisorProfile, type SurfaceScore, type SurfaceWorkerConfig, type SurfaceWorkerOut, ToolLoopChat, ToolLoopCompactionOptions, type TraceSource, type TrajectoryAnalysis, TrajectoryReport, TrajectoryReportOptions, type TurnResult, UsageEvent, type UsageSink, Validator, type VerifierEnvironmentOptions, VerifySpec, type WatchTraceOptions, type WaterfallCollector, type WaterfallReport, type WaterfallSpan, WidenSpec, WinnerStrategy, type Workspace, type WorkspaceCommit, type WorkspaceRun, acquireSandbox, adaptiveRefine, analyzeTrace, anytimeReport, asAuthoredProfile, assertModelAllowed, assertStrategyContract, assertTraceDerivedFindings, assessAuthoredProfile, auditIntent, authorStrategy, authoredWorker, breadthStrategy, buildSteerContext, builtinShapes, completionAuthorizes, contentAddress, createBudgetPool, createInMemoryRunContext, createInbox, createMcpEnvironment, createPushTraceSource, createSandboxLineage, createScope, createScopeAnalyst, createShapeRegistry, createSupervisor, createVerifierEnvironment, createWaterfallCollector, decodeToolPart, defaultAnalystInstruction, defaultAuditorInstruction, defaultDelegateBudget, defaultProfileRichnessThresholds, defaultSelectWinner, defaultToolDetectors, defineLeaderboard, definePersona, defineStrategy, delegate, depthStrategy, deterministicCompletion, discriminatingMeans, driverAgent, dumbDriver, equalKOnCost, extractLlmCallEvent, failuresAnalyst, fanout, finalizeBestDelivered, flatWidenGate, gitWorkspace, harvestCorpus, inProcessSandboxClient, inlineSandboxClient, jjWorkspace, leaderboard, localShell, loopCampaignDispatch, loopDispatch, loopUntil, mapSandboxEvent, naiveDriver, observe, openSandboxRun, pairwiseSignificance, panel, pickChampion, pipeline, printBenchmarkReport, probeSandboxCapabilities, profileRichnessFinding, promotionGate, refine, registerShape, registryScopeAnalyst, renderAnytimeTable, renderCorpusToInstructions, renderLeaderboardHtml, renderLeaderboardMarkdown, renderLeaderboardSvg, renderPairwiseMarkdown, renderReport, reportLoopUsage, resolveSandboxClient, runAgentic, runBenchmark, runInWorkspace, runLoop, runPersonified, runStrategyEvolution, sample, sampleThenRefine, sandboxSessionTraceSource, selectChampion, selectValidWinner, sentinelCompletion, serveCoordinationMcp, settledToIteration, spendFromUsageEvents, stopSentinel, strategyAuthorContract, sumSandboxUsage, supervise, superviseSurface, supervisorAgent, supervisorInstructions, trajectoryReport, verify, watchTrace, widen, workerFromBackend };
+export { Agent, AgentRunSpec, type AgentTurnBackend, type AgentTurnUsage, type AgenticOptions, type AgenticRunResult, type AgenticSurface, type AgenticTask, type AgenticTool, AnalystRegistry, type AnytimeReport, type AnytimeStrategySummary, type AnytimeTaskCurve, type ApplyContinuation, type ArtifactHandle, AssertTraceDerivedFindings, type AuditIntentInput, type AuditIntentOptions, type AuthorStrategyOptions, type AuthoredProfile, type AuthoredStrategy, type BenchmarkCell, type BenchmarkConfig, type BenchmarkLift, type BenchmarkReport, type BenchmarkStrategySummary, type BenchmarkTaskRow, Budget, type BudgetPool, type BudgetReadout, type ChampionPick, type ChampionPolicy, type CheckpointCapableBox, type CollectedAgentTurn, CombinatorShape, type CompletionAnalyst, type CompletionEvidence, type CompletionPolicy, type CompletionVerdict, CoordinationEvent, type CoordinationMcpHandle, Corpus, CorpusFilter, CorpusRecord, type CreateScopeAnalystOptions, type CriuCapableClient, DefinePersonaInput, type DefinedLeaderboard, type DelegateOptions, type Deliverable, DeliverableSpec, type DriveHarness, Driver, type DriverAgentOptions, type DumbDriverOptions, type Environment, EqualKArm, EqualKOnCostOptions, EqualKVerdict, type EvolutionArchiveNode, type EvolutionAuthor, type EvolutionBandInfo, type EvolutionCandidate, type EvolutionGeneration, type EvolutionReport, ExecCtx, ExecutorConfig, ExecutorFactory, ExecutorRegistry, FanoutOptions, FanoutWinnerSelector, FileCorpus, type ForkCapableBox, type GitWorkspaceOptions, type HarvestCorpusOptions, type HarvestFailure, type HarvestReport, InMemoryCorpus, InMemoryResultBlobStore, type InMemoryRunContext, type InMemoryRunContextOptions, InMemorySpawnJournal, type InProcessOnPrompt, type InProcessPromptCtx, type InProcessSandboxClientOptions, type Inbox, type InboxMessage, type IntentAudit, type Interval, Iteration, type Leaderboard, type LeaderboardBenchScore, type LeaderboardBenchTask, type LeaderboardBenchmarkAdapter, type LeaderboardFlagSpec, type LeaderboardIterationInfo, type LeaderboardOptions, type LeaderboardRow, type LeaderboardRunContext, type LeaderboardScenario, type LeaderboardScore, type LeaderboardSpec, type LoopCampaignDispatchOptions, type LoopDispatchOptions, LoopLineageOptions, type LoopOptionsForDispatch, LoopResult, LoopShape, LoopTokenUsage, LoopUntilSpec, LoopWinner, MakeWorkerAgent, type McpEndpoint, type McpEnvironmentOptions, MountRecorder, type NaiveDriverOptions, type Observation, type ObserveInput, type ObserveOptions, type OpenSandboxRunOptions, Outcome, OutputAdapter, type PairwiseOptions, type PairwiseVerdict, PanelSpec, Persona, PipelineStage, type ProfileRichness, type ProfileRichnessThresholds, type PromotionGateOptions, type PromotionVerdict, type RegistryAnalyzeProjection, RenderCorpusToInstructionsOptions, type ReservationTicket, type ResolveSandboxClientOptions, ResultBlobStore, RouterConfig, type RunAgenticOptions, RunPersonifiedOptions, type SandboxCapabilities, SandboxClient, type SandboxLineage, type SandboxLineageHandle, type SandboxRun, SandboxRunAbortError, Scope, ScopeAnalyst, ScopeAnalyzeInput, ScopeWidenGate, type SessionCapableBox, type SessionTraceBox, Settled, ShapeRegistry, type Shell, type ShotPersona, type ShotSpec, Spend, SteerContext, type SteeringDecision, type Strategy, type StrategyCtx, type StrategyEvolutionConfig, type StrategyResult, type StreamAgentTurnOptions, type SuperviseOptions, type SuperviseSurfaceOptions, type SuperviseSurfaceResult, SupervisedResult, Supervisor, type SupervisorAgentDeps, type SupervisorProfile, type SurfaceScore, type SurfaceWorkerConfig, type SurfaceWorkerOut, ToolLoopChat, ToolLoopCompactionOptions, type TraceSource, type TrajectoryAnalysis, TrajectoryReport, TrajectoryReportOptions, type TurnResult, UsageEvent, type UsageSink, Validator, type VerifierEnvironmentOptions, VerifySpec, type WatchTraceOptions, type WaterfallCollector, type WaterfallReport, type WaterfallSpan, WidenSpec, WinnerStrategy, type Workspace, type WorkspaceCommit, type WorkspaceRun, acquireSandbox, adaptiveRefine, analyzeTrace, anytimeReport, asAuthoredProfile, assertModelAllowed, assertStrategyContract, assertTraceDerivedFindings, assessAuthoredProfile, auditIntent, authorStrategy, authoredWorker, breadthStrategy, buildSteerContext, builtinShapes, collectAgentTurn, completionAuthorizes, contentAddress, createBudgetPool, createInMemoryRunContext, createInbox, createMcpEnvironment, createPushTraceSource, createSandboxLineage, createScope, createScopeAnalyst, createShapeRegistry, createSupervisor, createVerifierEnvironment, createWaterfallCollector, decodeToolPart, defaultAnalystInstruction, defaultAuditorInstruction, defaultDelegateBudget, defaultProfileRichnessThresholds, defaultSelectWinner, defaultToolDetectors, defineLeaderboard, definePersona, defineStrategy, delegate, depthStrategy, deterministicCompletion, discriminatingMeans, driverAgent, dumbDriver, equalKOnCost, extractLlmCallEvent, failuresAnalyst, fanout, finalizeBestDelivered, flatWidenGate, gitWorkspace, harvestCorpus, inProcessSandboxClient, inlineSandboxClient, jjWorkspace, leaderboard, localShell, loopCampaignDispatch, loopDispatch, loopUntil, mapSandboxEvent, naiveDriver, observe, openSandboxRun, pairwiseSignificance, panel, pickChampion, pipeline, printBenchmarkReport, probeSandboxCapabilities, profileRichnessFinding, promotionGate, refine, registerShape, registryScopeAnalyst, renderAnytimeTable, renderCorpusToInstructions, renderLeaderboardHtml, renderLeaderboardMarkdown, renderLeaderboardSvg, renderPairwiseMarkdown, renderReport, reportLoopUsage, resolveSandboxClient, runAgentic, runBenchmark, runInWorkspace, runLoop, runPersonified, runStrategyEvolution, sample, sampleThenRefine, sandboxSessionTraceSource, selectChampion, selectValidWinner, sentinelCompletion, serveCoordinationMcp, settledToIteration, spendFromUsageEvents, stopSentinel, strategyAuthorContract, streamAgentTurn, sumSandboxUsage, supervise, superviseSurface, supervisorAgent, supervisorInstructions, trajectoryReport, verify, watchTrace, widen, workerFromBackend };

package/dist/loops.js

@@ -12,6 +12,7 @@ import {
   breadthStrategy,
   buildSteerContext,
   builtinShapes,
+  collectAgentTurn,
   completionAuthorizes,
   computeFindingId,
   createMcpEnvironment,
@@ -81,13 +82,14 @@ import {
   sentinelCompletion,
   stopSentinel,
   strategyAuthorContract,
+  streamAgentTurn,
   superviseSurface,
   trajectoryReport,
   verify,
   watchTrace,
   widen,
   worktreeFanout
-} from "./chunk-UJW6EVNY.js";
+} from "./chunk-3TZOXS7B.js";
 import {
   InMemoryResultBlobStore,
   InMemorySpawnJournal,
@@ -129,7 +131,7 @@ import {
   supervisorAgent,
   supervisorInstructions,
   workerFromBackend
-} from "./chunk-XN5TIJGP.js";
+} from "./chunk-F7OO2SKB.js";
 import "./chunk-UD4BHQMI.js";
 import {
   createAgentEnvironmentProviderRegistry,
@@ -169,6 +171,7 @@ export {
   buildSteerContext,
   builtinShapes,
   cliWorktreeExecutor,
+  collectAgentTurn,
   completionAuthorizes,
   computeFindingId,
   contentAddress,
@@ -273,6 +276,7 @@ export {
   spendFromUsageEvents,
   stopSentinel,
   strategyAuthorContract,
+  streamAgentTurn,
   sumSandboxUsage,
   supervise,
   superviseSurface,

package/dist/mcp/bin.js

@@ -9,7 +9,7 @@ import {
   DelegationTaskQueue,
   FileDelegationStore,
   createMcpServer
-} from "../chunk-XN5TIJGP.js";
+} from "../chunk-F7OO2SKB.js";
 import "../chunk-UD4BHQMI.js";
 import "../chunk-BZF3KQ6G.js";
 import "../chunk-4J6RBI3K.js";

package/dist/mcp/index.js

@@ -6,7 +6,7 @@ import {
 import {
   mcpToolsForRuntimeMcp,
   mcpToolsForRuntimeMcpSubset
-} from "../chunk-G7HQI6DB.js";
+} from "../chunk-U4TS65XZ.js";
 import {
   createKbGate
 } from "../chunk-SGKPNBXE.js";
@@ -14,7 +14,7 @@ import {
   assertTraceDerivedFindings,
   runCoderChecks,
   selectValidWinner
-} from "../chunk-UJW6EVNY.js";
+} from "../chunk-3TZOXS7B.js";
 import {
   DELEGATE_DESCRIPTION,
   DELEGATE_FEEDBACK_DESCRIPTION,
@@ -64,7 +64,7 @@ import {
   validateDelegateUiAuditArgs,
   validateDelegationHistoryArgs,
   validateDelegationStatusArgs
-} from "../chunk-XN5TIJGP.js";
+} from "../chunk-F7OO2SKB.js";
 import "../chunk-UD4BHQMI.js";
 import {
   deleteBoxSafe,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tangle-network/agent-runtime",
-  "version": "0.84.0",
+  "version": "0.86.0",
   "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": {