@tangle-network/agent-runtime 0.56.0 → 0.57.0

package/dist/{coordination-CfMk-RpQ.d.ts → coordination-BydGBQCZ.d.ts}

@@ -1,8 +1,8 @@
 import { DefaultVerdict } from '@tangle-network/agent-eval';
 import { AgentProfile, BackendType } from '@tangle-network/sandbox';
 import { R as RuntimeHooks } from './runtime-hooks-C7JwKb9E.js';
-import { d as LoopTokenUsage } from './types-C8rNlxfV.js';
-import { b as DelegateFeedbackArgs, c as DelegationFeedbackSnapshot, d as DelegationTaskQueue, e as CoderDelegate, R as ResearcherDelegate, U as UiAuditorDelegate, T as TraceContext } from './delegates-htF7l_H6.js';
+import { e as LoopTokenUsage } from './types-CUzjRFZ3.js';
+import { b as DelegateFeedbackArgs, c as DelegationFeedbackSnapshot, d as DelegationTaskQueue, e as CoderDelegate, R as ResearcherDelegate, U as UiAuditorDelegate, T as TraceContext } from './delegates-C94qchkz.js';
 
 /**
  * @experimental
@@ -98,6 +98,15 @@ interface Executor<Out> {
         verdict?: DefaultVerdict;
         spent: Spend;
     };
+    /**
+     * A driver-executor's OWN-inference subtree total (rolled up from its nested tree's `metered`
+     * events) — the parent scope journals it as a `metered` event for this node on settle, on BOTH
+     * the done AND the down/crash paths, so a crashed sub-driver's partial inference still re-homes
+     * (the pool already debited it via `observe`; the journal must match). NOT reconciled, so it never
+     * trips the reservation clamp. Read on settle, valid after `execute` resolves OR throws. Leaf
+     * executors omit it (returns `undefined`).
+     */
+    metered?(): Spend | undefined;
 }
 /** Terminal artifact of a one-shot `Executor.execute`. */
 interface ExecutorResult<Out> {
@@ -275,12 +284,30 @@ interface Scope<Out> {
      * is a direct call; the sandbox/Agent-Bus transports surface the SAME verb as an MCP tool.
      */
     send(nodeId: NodeId, msg: unknown): boolean;
+    /** This scope's abort signal — aborted when the run is cancelled, a breaker trips, the pool
+     *  is exhausted, or a parent scope cascades. A long-running driver `act` over this scope reads
+     *  it to break promptly (the conserved pool + driver-stop are the other bounds). A nested
+     *  scope carries its own signal, chained off its driver child's abort. */
+    readonly signal: AbortSignal;
+    /**
+     * Meter the driver's OWN compute against the conserved pool — its inference turns, which are
+     * real tokens/usd but not a spawned child (no reserve/reconcile). A direct `free → committed`
+     * debit, so equal-k counts the driver's tokens AND the in-loop budget guard (`budget.tokensLeft`)
+     * halts a driver that thinks the pool dry. `detail` rides an `agent.turn` trace event for live
+     * observability (turn index, tool calls, cumulative spend). It also journals a `metered` event —
+     * the durable twin of the pool debit (as `settled` is the twin of `reconcile`) — so every
+     * journal-based cost reader (`spentFromJournal`, `trajectoryReport`) sums driver inference
+     * automatically. A leaf never calls this; a driver meters each chat turn and awaits it (the
+     * metered event is cost-critical, so it lands before the join-barrier roll-up).
+     */
+    meter(spend: Spend, detail?: Record<string, unknown>): Promise<void>;
     /** The live tree — reads the in-memory nursery, not the journal. */
     readonly view: TreeView;
     /** Conserved-pool readouts (post-reservation). */
     readonly budget: Readonly<{
         tokensLeft: number;
         usdLeft: number;
+        usdCapped: boolean;
         deadlineMs: number;
         reservedTokens: number;
     }>;
@@ -332,6 +359,19 @@ type SpawnEvent = {
     reason: string;
     seq: number;
     at: string;
+} | {
+    /** A driver's OWN inference spend, journaled separately from spawned-child work — the journal
+     *  TWIN of `BudgetPool.observe`, exactly as `settled` is the twin of `reconcile`. So every
+     *  journal-based cost reader sums it automatically — the journal is the single cost ledger.
+     *  It carries spend only and is NOT a settlement: replay + `materializeTreeView` skip it for
+     *  structure, and its `seq` lives outside the cursor-uniqueness namespace. A
+     *  driver re-homes its nested subtree's metered total up to its parent (like settled spend),
+     *  so summing any sub-tree root yields that sub-tree's true driver-inference cost. */
+    kind: 'metered';
+    id: NodeId;
+    spend: Spend;
+    seq: number;
+    at: string;
 };
 /**
  * The spawn-tree event source (mirrors `ConversationJournal`'s begin/append/load shape).
@@ -392,6 +432,13 @@ type SupervisedResult<Out> = {
     verdict?: DefaultVerdict;
     tree: TreeView;
     spentTotal: Spend;
+    /** Where `spentTotal` went: `driverInference` = the drivers' own chat turns (metered via
+     *  `Scope.meter`); `childWork` = every spawned child's reconciled spend (the journal sum).
+     *  `driverInference + childWork === spentTotal`. Present whenever any driver metered. */
+    spentBreakdown?: {
+        driverInference: Spend;
+        childWork: Spend;
+    };
 } | {
     kind: 'no-winner';
     reason: 'all-children-down' | 'budget-exhausted' | 'aborted';
@@ -515,6 +562,75 @@ declare function captureWorktreeDiff(options: DiffOptions): Promise<DiffResult>;
 /** @experimental */
 declare function removeWorktree(options: RemoveWorktreeOptions): Promise<void>;
 
+/**
+ * @experimental
+ *
+ * The child→parent message bus: the ONE pipe carrying every message a worker, sub-driver, or
+ * analyst sends up to the driver — settled outputs, questions, and trace-analyst findings. It
+ * unifies channels that were ad-hoc before (the settled-worker cursor, the ask-parent question
+ * channel, and analyst results) into a single typed primitive with two lanes:
+ *
+ *   - PASS-THROUGH (`subscribe`): every published event reaches subscribers immediately — the
+ *     express lane for online steering and live observation (a UI, a hook, the parent's box).
+ *   - STANDBY (`pull`): events also queue so the driver consumes them on its own cadence. The queue
+ *     is PRIORITY-ordered: a higher-`priority` event (a blocking question) is bumped ahead of
+ *     queued settles/findings so the driver sees it first; ties resolve FIFO by publish order.
+ *
+ * Observability is first-class (A++): every event is stamped with a monotonic `seq` and wall-clock
+ * `at`, the full ordered `history()` is retained as an audit/replay trail, and `stats()` exposes
+ * published/pulled counts by kind. Subscribers receive the stamped record, not a bare event.
+ *
+ * The interface is transport-agnostic on purpose. Same box → this in-process queue. Cross box →
+ * the SAME publish/pull/subscribe surface backed by a durable mailbox on the parent's box (children
+ * POST events with at-least-once retry; payloads are blob refs so the event stays small). Consumers
+ * depend only on this interface, so distribution is a transport swap, never an architecture change.
+ */
+/** Every bus event is a discriminated union member keyed by `type`. */
+interface BusEvent {
+    readonly type: string;
+}
+/** A published event stamped for ordering and observability. `seq` is the monotonic publish index;
+ *  `priority` drives pull order (higher = bumped ahead); `at` is the wall-clock publish time (ms). */
+interface BusRecord<E extends BusEvent> {
+    readonly seq: number;
+    readonly at: number;
+    readonly priority: number;
+    readonly event: E;
+}
+interface PublishOptions {
+    /** Higher = pulled ahead of lower-priority queued events (default 0). A blocking question sets
+     *  this so it bumps to the front of the driver's inbox. */
+    readonly priority?: number;
+    /** Whether the event enters the pull queue (default true). Set `false` for record-only events —
+     *  the parent→child down-leg (steer / answer / resume): they belong in `history()` and reach
+     *  `subscribe` observers, but the parent must never `pull` its own outbound message back. */
+    readonly queue?: boolean;
+}
+interface BusStats {
+    readonly published: number;
+    readonly pulled: number;
+    /** Count published per event `type`. */
+    readonly byKind: Readonly<Record<string, number>>;
+}
+interface EventBus<E extends BusEvent> {
+    /** Stamp + queue the event, then deliver the stamped record to every subscriber in order.
+     *  Returns the stamped record. */
+    publish(event: E, opts?: PublishOptions): Promise<BusRecord<E>>;
+    /** Remove and return the highest-priority QUEUED event whose type is in `kinds` (any if omitted),
+     *  ties broken FIFO by `seq`; `undefined` when nothing matches. */
+    pull(kinds?: ReadonlyArray<E['type']>): E | undefined;
+    /** Register a pass-through handler; it receives the stamped record of every event published after
+     *  registration. Returns an unsubscribe fn. */
+    subscribe(handler: (record: BusRecord<E>) => void | Promise<void>): () => void;
+    /** Count of queued, not-yet-pulled events (filtered by `kinds` when given). */
+    pending(kinds?: ReadonlyArray<E['type']>): number;
+    /** The full ordered log of every event ever published (the audit/replay trail). */
+    history(): ReadonlyArray<BusRecord<E>>;
+    /** Throughput counters for observability dashboards. */
+    stats(): BusStats;
+}
+declare function createEventBus<E extends BusEvent>(now?: () => number): EventBus<E>;
+
 /**
  * @experimental
  *
@@ -706,7 +822,7 @@ declare function createInProcessTransport(): {
  * them into any UI/report envelope it needs.
  */
 
-/** A worker the driver has drained via `await_next`. */
+/** A worker the driver has drained via `await_event`. */
 interface SettledWorker {
     readonly id: string;
     readonly status: 'done' | 'down';
@@ -756,9 +872,38 @@ interface AnalystRegistry {
     }>;
     readonly run: (kindId: string, trace: unknown) => Promise<unknown>;
 }
+/** A trace-analyst result re-entered as a message on the bus (the `finding` event kind). */
+interface AnalystFindingEvent {
+    readonly fromWorker: string;
+    readonly analyst: string;
+    readonly findings: unknown;
+}
+/** A parent→child message (the down-leg): recorded for observability, delivered via the child inbox,
+ *  never pulled back by the parent. `delivered` mirrors whether the live child accepted it. */
+interface DownMessageEvent {
+    readonly toWorker: string;
+    readonly instruction: string;
+    readonly delivered: boolean;
+}
+/** Every message on the one typed pipe. UP (child→parent): question / settled / finding — queued for
+ *  the driver to `pull`. DOWN (parent→child): steer / answer — record-only (history + subscribers),
+ *  routed to the child inbox. New kinds are additive. */
 type CoordinationEvent = {
     readonly type: 'question';
     readonly question: QuestionRecord;
+} | {
+    readonly type: 'settled';
+    readonly worker: SettledWorker;
+} | {
+    readonly type: 'finding';
+    readonly finding: AnalystFindingEvent;
+} | {
+    readonly type: 'steer';
+    readonly down: DownMessageEvent;
+} | {
+    readonly type: 'answer';
+    readonly down: DownMessageEvent;
+    readonly questionId: string;
 };
 type MakeWorkerAgent = (profile: unknown) => Agent<unknown, unknown>;
 interface CoordinationToolsOptions {
@@ -769,6 +914,11 @@ interface CoordinationToolsOptions {
     readonly analysts?: AnalystRegistry;
     readonly onEvent?: (event: CoordinationEvent) => void | Promise<void>;
     readonly questionPolicy?: QuestionPolicy;
+    /** Analyst kind ids to run AUTOMATICALLY when a worker settles `done` (the analyst-on-settle
+     *  hook). Each result is published as a `finding` event on the bus — pass-through to subscribers
+     *  and queued for the driver to pull via `await_event`. Omit/empty = no auto-analysis (default;
+     *  the driver can still run lenses on demand via `run_analyst`). Requires `analysts`. */
+    readonly analyzeOnSettle?: ReadonlyArray<string>;
 }
 interface CoordinationTools {
     readonly tools: McpToolDescriptor[];
@@ -776,8 +926,18 @@ interface CoordinationTools {
     stopReason(): string | undefined;
     settled(): ReadonlyArray<SettledWorker>;
     questions(): ReadonlyArray<QuestionRecord>;
+    /** The full ordered log of every bus event — UP (settled / question / finding) and DOWN
+     *  (steer / answer) — the observability audit + replay trail. Each record carries seq,
+     *  timestamp, and priority. */
+    history(): ReadonlyArray<BusRecord<CoordinationEvent>>;
+    /** Bus throughput counters (published / pulled / by-kind) for live dashboards. */
+    stats(): BusStats;
+    /** Raise a `finding` on the bus from outside the settle hook — the seam an ONLINE detector
+     *  (mid-run, on the worker pipe) uses to tell the driver "this worker is looping/erroring" the
+     *  moment it happens, instead of only at settle. Queued for `await_event` + pass-through. */
+    raiseFinding(finding: AnalystFindingEvent): Promise<void>;
 }
 /** Build the driver's MCP tools over a live scope. */
 declare function createCoordinationTools(opts: CoordinationToolsOptions): CoordinationTools;
 
-export { type NodeSnapshot as $, type AnalystRegistry as A, type Budget as B, type CoordinationEvent as C, type DiffOptions as D, type ExecutorRegistry as E, type FeedbackStore as F, type GitRunner as G, type RootHandle as H, InMemoryFeedbackStore as I, type JsonRpcMessage as J, type SupervisedResult as K, type Spend as L, type MakeWorkerAgent as M, type NodeId as N, type Scope as O, type ExecutorFactory as P, type Question as Q, type RemoveWorktreeOptions as R, type SettledWorker as S, type TreeView as T, type Executor as U, type UsageEvent as V, type WorktreeHandle as W, type Supervisor as X, type ExecutorContext as Y, type ExecutorResult as Z, type Handle as _, type CoordinationTools as a, type NodeStatus as a0, type Restart as a1, type RootSignal as a2, type Runtime as a3, type SpawnOpts as a4, type SupervisorOpts as a5, type WidenGate as a6, type CoordinationToolsOptions as b, type CreateWorktreeOptions as c, type DiffResult as d, type FeedbackEvent as e, type JsonRpcResponse as f, type McpServer as g, type McpServerOptions as h, type McpToolDescriptor as i, type McpTransport as j, type QuestionDecision as k, type QuestionPolicy as l, type QuestionRecord as m, captureWorktreeDiff as n, createCoordinationTools as o, createInProcessTransport as p, createMcpServer as q, createWorktree as r, eventToSnapshot as s, removeWorktree as t, type ResultBlobStore as u, type SpawnJournal as v, type SpawnEvent as w, type Settled as x, type AgentSpec as y, type Agent as z };
+export { type EventBus as $, type AnalystRegistry as A, type Budget as B, type CoordinationEvent as C, type DiffOptions as D, type ExecutorRegistry as E, type FeedbackStore as F, type GitRunner as G, type RootHandle as H, InMemoryFeedbackStore as I, type JsonRpcMessage as J, type SupervisedResult as K, type Spend as L, type MakeWorkerAgent as M, type NodeId as N, type Scope as O, type ExecutorFactory as P, type Question as Q, type RemoveWorktreeOptions as R, type SettledWorker as S, type TreeView as T, type Executor as U, type UsageEvent as V, type WorktreeHandle as W, type Supervisor as X, type BusEvent as Y, type BusRecord as Z, type BusStats as _, type CoordinationTools as a, type ExecutorContext as a0, type ExecutorResult as a1, type Handle as a2, type NodeSnapshot as a3, type NodeStatus as a4, type PublishOptions as a5, type Restart as a6, type RootSignal as a7, type Runtime as a8, type SpawnOpts as a9, type SupervisorOpts as aa, type WidenGate as ab, createEventBus as ac, type CoordinationToolsOptions as b, type CreateWorktreeOptions as c, type DiffResult as d, type FeedbackEvent as e, type JsonRpcResponse as f, type McpServer as g, type McpServerOptions as h, type McpToolDescriptor as i, type McpTransport as j, type QuestionDecision as k, type QuestionPolicy as l, type QuestionRecord as m, captureWorktreeDiff as n, createCoordinationTools as o, createInProcessTransport as p, createMcpServer as q, createWorktree as r, eventToSnapshot as s, removeWorktree as t, type ResultBlobStore as u, type SpawnJournal as v, type SpawnEvent as w, type Settled as x, type AgentSpec as y, type Agent as z };

package/dist/{delegates-htF7l_H6.d.ts → delegates-C94qchkz.d.ts}

@@ -1,5 +1,5 @@
-import { C as CoderOutput, d as CoderTask } from './coder-CdsknxGF.js';
-import { g as LoopTraceEmitter, e as LoopTraceEvent, S as SandboxClient, A as AgentRunSpec } from './types-C8rNlxfV.js';
+import { C as CoderOutput, d as CoderTask } from './coder-CybltHEm.js';
+import { g as LoopTraceEmitter, d as LoopTraceEvent, S as SandboxClient, A as AgentRunSpec } from './types-CUzjRFZ3.js';
 import { SandboxEvent, SandboxInstance } from '@tangle-network/sandbox';
 import { AgentEvalError } from '@tangle-network/agent-eval';
 import { a as UiLens, U as UiFinding } from './substrate-CUgk7F7s.js';
@@ -1422,6 +1422,12 @@ interface CreateDefaultCoderDelegateOptions {
     harness?: string;
     /** Model override for the single-coder path. */
     model?: string;
+    /**
+     * The worker's authored system prompt (§1.5). Flows onto `coderProfile`'s
+     * `profile.prompt.systemPrompt` → through `runLoop` → the executor's `harnessInvocation`, so the
+     * harness runs under this stance, not just the default coder prompt. Omit to keep the default.
+     */
+    systemPrompt?: string;
     /** Default `['claude-code', 'codex', 'opencode/zai-coding-plan/glm-5.1']` when variants > 1. */
     fanoutHarnesses?: string[];
     /** Optional per-harness model override for `variants > 1`. */
@@ -1464,12 +1470,10 @@ interface CreateDefaultCoderDelegateOptions {
  * (driveTurn ticks) so a durable queue resumes them across an MCP restart — a substrate
  * the recursive worktree-CLI leaf does not yet have a journal-replay equivalent for.
  *
- * @deprecated Prefer the generic recursive path for NEW local-repo coding work: author an
- *   `AgentProfile` per harness and run `worktreeCoderFanout(...)` (the `fanout` of
- *   `createWorktreeCliExecutor` leaves, each `gateOnDeliverable(coderDeliverable(...))`, winner
- *   via a valid-only `selectWinner`) through `runPersonified`. This factory stays as the injection seam
- *   `createMcpServer` consumes for SANDBOX-session delegation + detached resume; it will remain
- *   until the worktree-CLI leaf grows the detached-tick resume equivalent.
+ * For NEW local-repo coding, `worktreeCoderFanout` is a generic alternative (author an
+ * `AgentProfile` per harness → `createWorktreeCliExecutor` leaves → `gateOnDeliverable`). This
+ * factory remains first-class: it owns the sandbox-session + detached-resume substrate that the
+ * worktree-CLI leaf does not yet replicate.
  *
  * @experimental
  */

package/dist/index.d.ts

@@ -1,18 +1,18 @@
 import { AgentProfile, AgentEvalError, KnowledgeReadinessReport, RunRecord, ControlEvalResult, KnowledgeRequirement } from '@tangle-network/agent-eval';
 export { AgentEvalError, AgentEvalErrorCode, ConfigError, ControlBudget, ControlDecision, ControlEvalResult, ControlRunResult, ControlStep, DataAcquisitionPlan, JudgeError, KnowledgeReadinessReport, KnowledgeRequirement, NotFoundError, RunRecord, ValidationError } from '@tangle-network/agent-eval';
-import { h as AgentBackendInput, i as AgentExecutionBackend, c as OpenAIChatTool, j as OpenAIChatToolChoice, k as AgentBackendContext, R as RuntimeStreamEvent, K as KnowledgeReadinessDecision, l as RunAgentTaskOptions, m as AgentTaskRunResult, n as RunAgentTaskStreamOptions, o as AgentRuntimeEvent, p as AgentTaskStatus, q as RuntimeSessionStore, r as RuntimeSession } from './types-C8rNlxfV.js';
-export { s as AgentAdapter, t as AgentKnowledgeProvider, u as AgentRuntimeEventSink, v as AgentTaskContext, w as AgentTaskSpec, B as BackendErrorDetail, x as RuntimeRunHandle, y as RuntimeRunPersistenceAdapter, z as RuntimeRunRow, C as startRuntimeRun } from './types-C8rNlxfV.js';
+import { h as AgentBackendInput, i as AgentExecutionBackend, c as OpenAIChatTool, j as OpenAIChatToolChoice, k as AgentBackendContext, R as RuntimeStreamEvent, K as KnowledgeReadinessDecision, l as RunAgentTaskOptions, m as AgentTaskRunResult, n as RunAgentTaskStreamOptions, o as AgentRuntimeEvent, p as AgentTaskStatus, q as RuntimeSessionStore, r as RuntimeSession } from './types-CUzjRFZ3.js';
+export { s as AgentAdapter, t as AgentKnowledgeProvider, u as AgentRuntimeEventSink, v as AgentTaskContext, w as AgentTaskSpec, B as BackendErrorDetail, x as RuntimeRunHandle, y as RuntimeRunPersistenceAdapter, z as RuntimeRunRow, C as startRuntimeRun } from './types-CUzjRFZ3.js';
 import { Scenario, ProfileDispatchFn } from '@tangle-network/agent-eval/campaign';
-export { C as CoderLoopRunnerOptions, D as DELEGATED_LOOP_MODES, a as DelegatedLoopMode, b as DelegatedLoopRegistry, c as DelegatedLoopResult, d as DelegatedLoopRunner, L as LoopRunnerCliArgs, e as LoopRunnerCliResult, R as ResearchLoopResult, f as ResearchLoopRunnerOptions, g as RunDelegatedLoopOptions, V as VetoedFact, h as auditLoopRunner, i as coderLoopRunner, j as isDelegatedLoopMode, p as parseLoopRunnerArgv, r as researchLoopRunner, k as reviewLoopRunner, l as runDelegatedLoop, m as runLoopRunnerCli, s as selfImproveLoopRunner } from './loop-runner-bin-C4YyFGdT.js';
-export { m as mcpToolsForRuntimeMcp, a as mcpToolsForRuntimeMcpSubset } from './openai-tools-CoeLQ7Uo.js';
-export { ax as EvalRunEvent, ay as EvalRunGeneration, az as EvalRunsExportConfig, aA as EvalRunsExportResult, aB as INTELLIGENCE_WIRE_VERSION, aC as LoopSpanNode, aD as OtelAttribute, aE as OtelExportConfig, aF as OtelExporter, aG as OtelSpan, aH as buildLoopOtelSpans, aI as buildLoopSpanNodes, aJ as createOtelExporter, aK as exportEvalRuns, aL as loopEventToOtelSpan } from './delegates-htF7l_H6.js';
+export { C as CoderLoopRunnerOptions, D as DELEGATED_LOOP_MODES, a as DelegatedLoopMode, b as DelegatedLoopRegistry, c as DelegatedLoopResult, d as DelegatedLoopRunner, L as LoopRunnerCliArgs, e as LoopRunnerCliResult, R as ResearchLoopResult, f as ResearchLoopRunnerOptions, g as RunDelegatedLoopOptions, V as VetoedFact, h as auditLoopRunner, i as coderLoopRunner, j as isDelegatedLoopMode, p as parseLoopRunnerArgv, r as researchLoopRunner, k as reviewLoopRunner, l as runDelegatedLoop, m as runLoopRunnerCli, s as selfImproveLoopRunner } from './loop-runner-bin-Noz7P-mS.js';
+export { m as mcpToolsForRuntimeMcp, a as mcpToolsForRuntimeMcpSubset } from './openai-tools-d4GKwgya.js';
+export { ax as EvalRunEvent, ay as EvalRunGeneration, az as EvalRunsExportConfig, aA as EvalRunsExportResult, aB as INTELLIGENCE_WIRE_VERSION, aC as LoopSpanNode, aD as OtelAttribute, aE as OtelExportConfig, aF as OtelExporter, aG as OtelSpan, aH as buildLoopOtelSpans, aI as buildLoopSpanNodes, aJ as createOtelExporter, aK as exportEvalRuns, aL as loopEventToOtelSpan } from './delegates-C94qchkz.js';
 import { R as RuntimeHooks } from './runtime-hooks-C7JwKb9E.js';
 export { b as RuntimeDecisionEvidenceRef, c as RuntimeDecisionKind, d as RuntimeDecisionPoint, e as RuntimeHookContext, f as RuntimeHookErrorContext, a as RuntimeHookEvent, g as RuntimeHookPhase, h as RuntimeHookTarget, i as composeRuntimeHooks, j as defineRuntimeHooks, n as notifyRuntimeDecisionPoint, k as notifyRuntimeHookEvent } from './runtime-hooks-C7JwKb9E.js';
 import '@tangle-network/sandbox';
 import '@tangle-network/agent-eval/contract';
 import './types-p8dWBIXL.js';
 import './kb-gate-CuzMYGYM.js';
-import './coder-CdsknxGF.js';
+import './coder-CybltHEm.js';
 import './substrate-CUgk7F7s.js';
 
 /**

package/dist/index.js

@@ -1,7 +1,7 @@
 import {
   mcpToolsForRuntimeMcp,
   mcpToolsForRuntimeMcpSubset
-} from "./chunk-A265AJ2Q.js";
+} from "./chunk-NJST5D2G.js";
 import {
   DEFAULT_ROUTER_BASE_URL,
   cleanModelId,
@@ -21,17 +21,17 @@ import {
   runDelegatedLoop,
   runLoopRunnerCli,
   selfImproveLoopRunner
-} from "./chunk-5ZOYQWEB.js";
+} from "./chunk-6BOIKGSU.js";
 import "./chunk-FNMGYYSS.js";
-import "./chunk-GFDCNQRO.js";
+import "./chunk-WFEQCRQP.js";
 import "./chunk-P5OKDSLB.js";
 import {
   composeRuntimeHooks,
   defineRuntimeHooks,
   notifyRuntimeDecisionPoint,
   notifyRuntimeHookEvent
-} from "./chunk-ZADWPBOE.js";
-import "./chunk-3BI6PSP3.js";
+} from "./chunk-RLDUT4JL.js";
+import "./chunk-7QYOXFCD.js";
 import "./chunk-WIR4HOOJ.js";
 import {
   AgentEvalError,

package/dist/intelligence.d.ts

@@ -1,4 +1,4 @@
-import { e as LoopTraceEvent } from './types-C8rNlxfV.js';
+import { d as LoopTraceEvent } from './types-CUzjRFZ3.js';
 import { AgentProfileMcpServer } from '@tangle-network/sandbox';
 import { T as ToolSpec } from './router-client-30Y_pca8.js';
 import '@tangle-network/agent-eval';

package/dist/{loop-runner-bin-C4YyFGdT.d.ts → loop-runner-bin-Noz7P-mS.d.ts}

@@ -1,10 +1,10 @@
 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-p8dWBIXL.js';
-import { D as DelegateCodeArgs, C as CoderReviewer, a as CoderWinnerSelection } from './delegates-htF7l_H6.js';
+import { D as DelegateCodeArgs, C as CoderReviewer, a as CoderWinnerSelection } from './delegates-C94qchkz.js';
 import { F as FactCandidate, C as CreateKbGateOptions } from './kb-gate-CuzMYGYM.js';
-import { C as CoderOutput } from './coder-CdsknxGF.js';
-import { S as SandboxClient } from './types-C8rNlxfV.js';
+import { C as CoderOutput } from './coder-CybltHEm.js';
+import { S as SandboxClient } from './types-CUzjRFZ3.js';
 
 /**
  * @experimental

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

@@ -1,13 +1,13 @@
 #!/usr/bin/env node
-export { L as LoopRunnerCliArgs, e as LoopRunnerCliResult, p as parseLoopRunnerArgv, m as runLoopRunnerCli } from './loop-runner-bin-C4YyFGdT.js';
+export { L as LoopRunnerCliArgs, e as LoopRunnerCliResult, p as parseLoopRunnerArgv, m as runLoopRunnerCli } from './loop-runner-bin-Noz7P-mS.js';
 import '@tangle-network/agent-eval/campaign';
 import '@tangle-network/agent-eval/contract';
 import './types-p8dWBIXL.js';
 import '@tangle-network/agent-eval';
-import './delegates-htF7l_H6.js';
-import './coder-CdsknxGF.js';
+import './delegates-C94qchkz.js';
+import './coder-CybltHEm.js';
 import '@tangle-network/sandbox';
-import './types-C8rNlxfV.js';
+import './types-CUzjRFZ3.js';
 import './runtime-hooks-C7JwKb9E.js';
 import './substrate-CUgk7F7s.js';
 import './kb-gate-CuzMYGYM.js';

package/dist/loop-runner-bin.js

@@ -2,12 +2,12 @@
 import {
   parseLoopRunnerArgv,
   runLoopRunnerCli
-} from "./chunk-5ZOYQWEB.js";
+} from "./chunk-6BOIKGSU.js";
 import "./chunk-FNMGYYSS.js";
-import "./chunk-GFDCNQRO.js";
+import "./chunk-WFEQCRQP.js";
 import "./chunk-P5OKDSLB.js";
-import "./chunk-ZADWPBOE.js";
-import "./chunk-3BI6PSP3.js";
+import "./chunk-RLDUT4JL.js";
+import "./chunk-7QYOXFCD.js";
 import "./chunk-WIR4HOOJ.js";
 import "./chunk-VLF5RHEQ.js";
 import "./chunk-GLMFBUKT.js";

package/dist/loops.d.ts

@@ -1,15 +1,16 @@
 export { AgentProfile, CreateSandboxOptions, SandboxEvent, SandboxInstance } from '@tangle-network/sandbox';
-export { AgenticOptions, AgenticRunResult, AgenticSurface, AgenticTask, AgenticTool, AnytimeReport, AnytimeStrategySummary, AnytimeTaskCurve, ArtifactHandle, AssertTraceDerivedFindings, AuditIntentInput, AuditIntentOptions, AuthorStrategyOptions, AuthoredCoderHarness, AuthoredProfile, AuthoredStrategy, BenchmarkCell, BenchmarkConfig, BenchmarkLift, BenchmarkReport, BenchmarkStrategySummary, BenchmarkTaskRow, BridgeSeam, BudgetPool, BudgetReadout, ChampionPick, ChampionPolicy, CheckpointCapableBox, CliSeam, CliWorktreeSeam, CoderDeliverableOptions, CoderWinnerStrategy, CombinatorShape, CompletionAnalyst, CompletionEvidence, CompletionPolicy, CompletionVerdict, CoordinationDriverOptions, CoordinationMcpHandle, Corpus, CorpusFilter, CorpusRecord, CreateScopeAnalystOptions, CriuCapableClient, DefinePersona, DefinePersonaInput, Deliverable, DeliverableSpec, DriverChat, DriverMessage, DriverToolCall, DriverTurn, Environment, EqualKArm, EqualKOnCost, EqualKOnCostOptions, EqualKVerdict, EvolutionArchiveNode, EvolutionAuthor, EvolutionBandInfo, EvolutionCandidate, EvolutionGeneration, EvolutionReport, ExecutorConfig, Fanout, FanoutOptions, FanoutSynthesis, FanoutWinnerSelector, FileCorpus, FileResultBlobStore, FileSpawnJournal, FlatWidenGate, ForkCapableBox, GitWorkspaceOptions, HarvestCorpusOptions, HarvestFailure, HarvestReport, InMemoryCorpus, InMemoryResultBlobStore, InMemorySpawnJournal, IntentAudit, LoopDispatchOptions, LoopOptionsForDispatch, LoopShape, LoopUntil, LoopUntilSpec, LoopUntilState, McpEndpoint, McpEnvironmentOptions, NestedScopeSeam, Observation, ObserveInput, ObserveOptions, OpenSandboxRunOptions, Outcome, Panel, PanelJudge, PanelSpec, PanelVerdict, Persona, PersonaContext, PersonaExecutors, Pipeline, PipelineStage, PromotionGateOptions, PromotionVerdict, RegistryAnalyzeProjection, RenderCorpusToInstructions, RenderCorpusToInstructionsOptions, ReservationTicket, RouterSeam, RouterToolsSeam, RunAgenticOptions, RunPersonified, RunPersonifiedOptions, SandboxCapabilities, SandboxLineage, SandboxLineageHandle, SandboxRun, SandboxSeam, ScopeAnalyst, ScopeAnalyzeInput, ScopeWidenGate, SessionCapableBox, ShapeBudget, ShapeContext, ShapeRegistry, Shell, ShotPersona, ShotSpec, SteerContext, Strategy, StrategyCtx, StrategyEvolutionConfig, StrategyResult, SurfaceScore, TrajectoryNode, TrajectoryReport, TrajectoryReportFn, TrajectoryReportOptions, TurnResult, UsageSink, VerifierEnvironmentOptions, Verify, VerifySpec, WaterfallCollector, WaterfallReport, WaterfallSpan, Widen, WidenDecision, WidenLineage, WidenSpec, Workspace, WorkspaceCommit, WorkspaceRun, WorktreeCliExecutorOptions, WorktreeCoderFanoutOptions, WorktreeCommandResult, WorktreePatchArtifact, acquireSandbox, adaptiveRefine, anytimeReport, asAuthoredProfile, assertStrategyContract, assertTraceDerivedFindings, auditIntent, authorStrategy, authoredWorker, breadthDriver, buildSteerContext, builtinShapes, cliWorktreeExecutor, coderDeliverable, completionAuthorizes, contentAddress, coordinationDriverAgent, createBudgetPool, createExecutor, createExecutorRegistry, createMcpEnvironment, createRootHandle, createSandboxLineage, createScope, createScopeAnalyst, createShapeRegistry, createSupervisor, createVerifierEnvironment, createWaterfallCollector, createWorktreeCliExecutor, defaultAnalystInstruction, defaultAuditorInstruction, definePersona, defineStrategy, depthDriver, deterministicCompletion, discriminatingMeans, driverChild, driverExecutorFactory, driverRuntime, equalKOnCost, extractLlmCallEvent, fanout, flatWidenGate, gateOnDeliverable, gitWorkspace, harvestCorpus, inlineSandboxClient, isDriverSpec, jjWorkspace, localShell, loopDispatch, loopUntil, mapSandboxEvent, materializeTreeView, nestedScopeSeamKey, observe, openSandboxRun, panel, pickChampion, pipeline, printBenchmarkReport, probeSandboxCapabilities, promotionGate, refine, registerShape, registryScopeAnalyst, renderAnytimeTable, renderCorpusToInstructions, renderReport, replaySpawnTree, reportLoopUsage, runAgentic, runBenchmark, runInWorkspace, runPersonified, runStrategyEvolution, sample, sampleThenRefine, selectChampion, sentinelCompletion, serveCoordinationMcp, settledToIteration, spendFromUsageEvents, stopSentinel, strategyAuthorContract, supervisorSkill, trajectoryReport, verify, widen, withDriverExecutor, worktreeCoderFanout } from './runtime.js';
+export { AgenticOptions, AgenticRunResult, AgenticSurface, AgenticTask, AgenticTool, AnytimeReport, AnytimeStrategySummary, AnytimeTaskCurve, ArtifactHandle, AssertTraceDerivedFindings, AuditIntentInput, AuditIntentOptions, AuthorStrategyOptions, AuthoredCoderHarness, AuthoredProfile, AuthoredStrategy, BenchmarkCell, BenchmarkConfig, BenchmarkLift, BenchmarkReport, BenchmarkStrategySummary, BenchmarkTaskRow, BridgeSeam, BudgetPool, BudgetReadout, ChampionPick, ChampionPolicy, CheckpointCapableBox, CliSeam, CliWorktreeSeam, CoderDeliverableOptions, CoderWinnerStrategy, CombinatorShape, CompletionAnalyst, CompletionEvidence, CompletionPolicy, CompletionVerdict, CoordinationDriverOptions, CoordinationMcpHandle, Corpus, CorpusFilter, CorpusRecord, CreateScopeAnalystOptions, CriuCapableClient, DefinePersona, DefinePersonaInput, Deliverable, DeliverableSpec, DetectorMonitor, DetectorMonitorOptions, DriverChat, DriverMessage, DriverToolCall, DriverTurn, Environment, EqualKArm, EqualKOnCost, EqualKOnCostOptions, EqualKVerdict, EvolutionArchiveNode, EvolutionAuthor, EvolutionBandInfo, EvolutionCandidate, EvolutionGeneration, EvolutionReport, ExecutorConfig, Fanout, FanoutOptions, FanoutSynthesis, FanoutWinnerSelector, FileCorpus, FileResultBlobStore, FileSpawnJournal, FlatWidenGate, ForkCapableBox, GitWorkspaceOptions, HarvestCorpusOptions, HarvestFailure, HarvestReport, InMemoryCorpus, InMemoryResultBlobStore, InMemorySpawnJournal, Inbox, InboxMessage, IntentAudit, LoopDispatchOptions, LoopOptionsForDispatch, LoopShape, LoopUntil, LoopUntilSpec, LoopUntilState, McpEndpoint, McpEnvironmentOptions, NestedScopeSeam, Observation, ObserveInput, ObserveOptions, OpenSandboxRunOptions, Outcome, Panel, PanelJudge, PanelSpec, PanelVerdict, Persona, PersonaContext, PersonaExecutors, Pipeline, PipelineStage, PromotionGateOptions, PromotionVerdict, RecordedToolStep, RegistryAnalyzeProjection, RenderCorpusToInstructions, RenderCorpusToInstructionsOptions, ReservationTicket, RouterSeam, RouterToolsSeam, RunAgenticOptions, RunPersonified, RunPersonifiedOptions, SandboxCapabilities, SandboxLineage, SandboxLineageHandle, SandboxRun, SandboxSeam, ScopeAnalyst, ScopeAnalyzeInput, ScopeWidenGate, SessionCapableBox, ShapeBudget, ShapeContext, ShapeRegistry, Shell, ShotPersona, ShotSpec, SteerContext, Strategy, StrategyCtx, StrategyEvolutionConfig, StrategyResult, SurfaceScore, ToolStep, TrajectoryAnalysis, TrajectoryNode, TrajectoryRecorder, TrajectoryReport, TrajectoryReportFn, TrajectoryReportOptions, TurnResult, UsageSink, VerifierEnvironmentOptions, Verify, VerifySpec, WaterfallCollector, WaterfallReport, WaterfallSpan, Widen, WidenDecision, WidenLineage, WidenSpec, Workspace, WorkspaceCommit, WorkspaceRun, WorktreeCliExecutorOptions, WorktreeCoderFanoutOptions, WorktreeCommandResult, WorktreePatchArtifact, acquireSandbox, adaptiveRefine, anytimeReport, asAuthoredProfile, assertStrategyContract, assertTraceDerivedFindings, auditIntent, authorStrategy, authoredWorker, breadthDriver, buildSteerContext, builtinShapes, cliWorktreeExecutor, coderDeliverable, completionAuthorizes, contentAddress, coordinationDriverAgent, createBudgetPool, createDetectorMonitor, createExecutor, createExecutorRegistry, createInbox, createMcpEnvironment, createRootHandle, createSandboxLineage, createScope, createScopeAnalyst, createShapeRegistry, createSupervisor, createTrajectoryRecorder, createVerifierEnvironment, createWaterfallCollector, createWorktreeCliExecutor, defaultAnalystInstruction, defaultAuditorInstruction, defaultToolDetectors, definePersona, defineStrategy, depthDriver, deterministicCompletion, discriminatingMeans, driverChild, driverExecutorFactory, driverRuntime, equalKOnCost, extractLlmCallEvent, fanout, flatWidenGate, gateOnDeliverable, gitWorkspace, harvestCorpus, inlineSandboxClient, isDriverSpec, jjWorkspace, localShell, loopDispatch, loopUntil, mapSandboxEvent, materializeTreeView, nestedScopeSeamKey, observe, openSandboxRun, panel, pickChampion, pipeline, printBenchmarkReport, probeSandboxCapabilities, promotionGate, refine, registerShape, registryScopeAnalyst, renderAnytimeTable, renderCorpusToInstructions, renderReport, replaySpawnTree, reportLoopUsage, routerDriverChat, runAgentic, runBenchmark, runInWorkspace, runPersonified, runStrategyEvolution, sample, sampleThenRefine, selectChampion, sentinelCompletion, serveCoordinationMcp, settledToIteration, spendFromUsageEvents, stopSentinel, strategyAuthorContract, supervisorSkill, trajectoryReport, verify, widen, withDriverExecutor, worktreeCoderFanout } from './runtime.js';
 export { a as RouterChatResult, b as RouterChatToolsResult, R as RouterConfig, c as RouterToolCall, d as RouterToolLoopResult, T as ToolSpec, r as routerChatWithTools, e as routerChatWithUsage, f as routerToolLoop } from './router-client-30Y_pca8.js';
-export { R as RunLoopOptions, c as createSandboxForSpec, d as defaultSelectWinner, r as runLoop } from './run-loop-DluzfJ2h.js';
-export { z as Agent, y as AgentSpec, B as Budget, U as Executor, Y as ExecutorContext, P as ExecutorFactory, E as ExecutorRegistry, Z as ExecutorResult, _ as Handle, N as NodeId, $ as NodeSnapshot, a0 as NodeStatus, a1 as Restart, u as ResultBlobStore, H as RootHandle, a2 as RootSignal, a3 as Runtime, O as Scope, x as Settled, w as SpawnEvent, v as SpawnJournal, a4 as SpawnOpts, L as Spend, K as SupervisedResult, X as Supervisor, a5 as SupervisorOpts, T as TreeView, V as UsageEvent, a6 as WidenGate } from './coordination-CfMk-RpQ.js';
-export { A as AgentRunSpec, D as Driver, E as ExecCtx, I as Iteration, F as LoopDecisionPayload, G as LoopEndedPayload, H as LoopIterationDispatchPayload, J as LoopIterationEndedPayload, M as LoopIterationStartedPayload, a as LoopLineageOptions, N as LoopPlanDescription, P as LoopPlanPayload, b as LoopResult, f as LoopSandboxPlacement, Q as LoopStartedPayload, T as LoopTeardownFailedPayload, d as LoopTokenUsage, g as LoopTraceEmitter, e as LoopTraceEvent, L as LoopWinner, O as OutputAdapter, S as SandboxClient, U as ValidationCtx, V as Validator } from './types-C8rNlxfV.js';
+export { R as RunLoopOptions, c as createSandboxForSpec, d as defaultSelectWinner, r as runLoop } from './run-loop-CcqfR_gy.js';
+export { z as Agent, y as AgentSpec, B as Budget, Y as BusEvent, Z as BusRecord, _ as BusStats, $ as EventBus, U as Executor, a0 as ExecutorContext, P as ExecutorFactory, E as ExecutorRegistry, a1 as ExecutorResult, a2 as Handle, N as NodeId, a3 as NodeSnapshot, a4 as NodeStatus, a5 as PublishOptions, a6 as Restart, u as ResultBlobStore, H as RootHandle, a7 as RootSignal, a8 as Runtime, O as Scope, x as Settled, w as SpawnEvent, v as SpawnJournal, a9 as SpawnOpts, L as Spend, K as SupervisedResult, X as Supervisor, aa as SupervisorOpts, T as TreeView, V as UsageEvent, ab as WidenGate, ac as createEventBus } from './coordination-BydGBQCZ.js';
+export { A as AgentRunSpec, D as Driver, E as ExecCtx, I as Iteration, F as LoopDecisionPayload, G as LoopEndedPayload, H as LoopIterationDispatchPayload, J as LoopIterationEndedPayload, M as LoopIterationStartedPayload, a as LoopLineageOptions, N as LoopPlanDescription, P as LoopPlanPayload, b as LoopResult, f as LoopSandboxPlacement, Q as LoopStartedPayload, T as LoopTeardownFailedPayload, e as LoopTokenUsage, g as LoopTraceEmitter, d as LoopTraceEvent, L as LoopWinner, O as OutputAdapter, S as SandboxClient, U as ValidationCtx, V as Validator } from './types-CUzjRFZ3.js';
 export { DefaultVerdict } from '@tangle-network/agent-eval';
 import './runtime-hooks-C7JwKb9E.js';
 import '@tangle-network/agent-eval/campaign';
 import './types-p8dWBIXL.js';
-import './coder-CdsknxGF.js';
+import './coder-CybltHEm.js';
 import './local-harness-BE_h8szs.js';
 import 'node:child_process';
-import './delegates-htF7l_H6.js';
+import '@tangle-network/agent-eval/pipelines';
+import './delegates-C94qchkz.js';
 import './substrate-CUgk7F7s.js';

package/dist/loops.js

@@ -23,8 +23,11 @@ import {
   contentAddress,
   coordinationDriverAgent,
   createBudgetPool,
+  createDetectorMonitor,
+  createEventBus,
   createExecutor,
   createExecutorRegistry,
+  createInbox,
   createMcpEnvironment,
   createRootHandle,
   createSandboxForSpec,
@@ -33,12 +36,14 @@ import {
   createScopeAnalyst,
   createShapeRegistry,
   createSupervisor,
+  createTrajectoryRecorder,
   createVerifierEnvironment,
   createWaterfallCollector,
   createWorktreeCliExecutor,
   defaultAnalystInstruction,
   defaultAuditorInstruction,
   defaultSelectWinner,
+  defaultToolDetectors,
   definePersona,
   defineStrategy,
   depthDriver,
@@ -79,6 +84,7 @@ import {
   reportLoopUsage,
   routerChatWithTools,
   routerChatWithUsage,
+  routerDriverChat,
   routerToolLoop,
   runAgentic,
   runBenchmark,
@@ -101,8 +107,8 @@ import {
   widen,
   withDriverExecutor,
   worktreeCoderFanout
-} from "./chunk-ZADWPBOE.js";
-import "./chunk-3BI6PSP3.js";
+} from "./chunk-RLDUT4JL.js";
+import "./chunk-7QYOXFCD.js";
 import "./chunk-WIR4HOOJ.js";
 import {
   extractLlmCallEvent,
@@ -136,8 +142,11 @@ export {
   contentAddress,
   coordinationDriverAgent,
   createBudgetPool,
+  createDetectorMonitor,
+  createEventBus,
   createExecutor,
   createExecutorRegistry,
+  createInbox,
   createMcpEnvironment,
   createRootHandle,
   createSandboxForSpec,
@@ -146,12 +155,14 @@ export {
   createScopeAnalyst,
   createShapeRegistry,
   createSupervisor,
+  createTrajectoryRecorder,
   createVerifierEnvironment,
   createWaterfallCollector,
   createWorktreeCliExecutor,
   defaultAnalystInstruction,
   defaultAuditorInstruction,
   defaultSelectWinner,
+  defaultToolDetectors,
   definePersona,
   defineStrategy,
   depthDriver,
@@ -194,6 +205,7 @@ export {
   reportLoopUsage,
   routerChatWithTools,
   routerChatWithUsage,
+  routerDriverChat,
   routerToolLoop,
   runAgentic,
   runBenchmark,

package/dist/mcp/bin.js

@@ -3,7 +3,7 @@ import {
   createPropagatingTraceEmitter,
   detectExecutor,
   readTraceContextFromEnv
-} from "../chunk-UIQTCS6H.js";
+} from "../chunk-TVBXDW7C.js";
 import {
   resolveRouterBaseUrl
 } from "../chunk-GRAGM4MC.js";
@@ -11,7 +11,7 @@ import {
   coderTaskFromArgs,
   createDefaultCoderDelegate,
   settleDetachedCoderTurn
-} from "../chunk-GFDCNQRO.js";
+} from "../chunk-WFEQCRQP.js";
 import {
   DEFAULT_SANDBOX_BASE_URL
 } from "../chunk-XRYEZPR6.js";
@@ -26,10 +26,10 @@ import {
   parseDetachedSessionRef,
   runDetachedTurn,
   runLoop
-} from "../chunk-ZADWPBOE.js";
+} from "../chunk-RLDUT4JL.js";
 import {
   coderProfile
-} from "../chunk-3BI6PSP3.js";
+} from "../chunk-7QYOXFCD.js";
 import "../chunk-WIR4HOOJ.js";
 import "../chunk-VLF5RHEQ.js";
 import "../chunk-GLMFBUKT.js";