@tangle-network/agent-runtime 0.53.0 → 0.54.0

package/dist/intelligence.d.ts

@@ -1,6 +1,6 @@
-import { e as LoopTraceEvent } from './types-CklkW4Eh.js';
+import { e as LoopTraceEvent } from './types-C8rNlxfV.js';
 import { AgentProfileMcpServer } from '@tangle-network/sandbox';
-import { T as ToolSpec } from './router-client-B0Qi1NiN.js';
+import { T as ToolSpec } from './router-client-30Y_pca8.js';
 import '@tangle-network/agent-eval';
 import './runtime-hooks-C7JwKb9E.js';
 

package/dist/kb-gate-CuzMYGYM.d.ts

@@ -0,0 +1,76 @@
+/**
+ * @experimental
+ *
+ * `createKbGate` — the valid-only knowledge-base growth gate, distilled from
+ * physim's KB-research subsystem. A research-in-a-loop delegate (or any KB
+ * writer) runs candidate facts through this before persisting, so the KB grows
+ * with ONLY grounded facts — hallucinated, unsourced, or laundered claims are
+ * vetoed at the gate.
+ *
+ * Fail-closed by construction: every judge must `accept`; the FIRST veto wins
+ * and the fact is rejected. The non-negotiable floor (always on, can't be
+ * disabled) is the **passage-present guard** — a fact's `verbatimPassage` MUST
+ * literally appear in its `sourceText`. That single check kills the dominant
+ * failure mode (a confident claim decoupled from any real source).
+ *
+ * Pure + dependency-free: it operates on fact candidates, not on a store, so it
+ * composes with `@tangle-network/agent-knowledge` or any persistence layer
+ * without importing it. The remediation policy (correct-on-veto vs
+ * escalate-as-unverified) is the caller's — this returns the verdict; it never
+ * drops a fact silently.
+ */
+/** @experimental A fact proposed for the KB, with its grounding. */
+interface FactCandidate {
+    /** The atomic claim text. */
+    claim: string;
+    /** Optional extracted value (number or string) the claim asserts. */
+    value?: string | number;
+    /** Verbatim span lifted from the source that backs the claim. */
+    verbatimPassage: string;
+    /** The raw source text the passage must be grounded in. */
+    sourceText: string;
+    /** Where the fact claims to come from — checked for circular/self citations. */
+    citation?: string;
+}
+/** @experimental */
+interface FactJudgeVerdict {
+    accept: boolean;
+    reason?: string;
+}
+/** @experimental A pluggable fact validator. Throw is NOT allowed — return a
+ *  verdict; a thrown judge is a programmer error, not a veto. */
+interface FactJudge {
+    name: string;
+    judge(candidate: FactCandidate): FactJudgeVerdict | Promise<FactJudgeVerdict>;
+}
+/** @experimental */
+interface KbGateResult {
+    accepted: boolean;
+    /** Name of the judge that vetoed; undefined when accepted. */
+    vetoedBy?: string;
+    reason?: string;
+}
+/** @experimental */
+interface CreateKbGateOptions {
+    /** Extra judges appended after the built-in floor (e.g. an LLM judge). */
+    judges?: FactJudge[];
+    /** Minimum verbatim-passage length. Default 12 — kills empty/stub passages. */
+    minPassageChars?: number;
+    /**
+     * Citation tokens that denote a SELF-generated artifact (e.g. `'spec'`,
+     * `'cad_params'`, `'requirements'`). A citation naming one is circular
+     * (laundering) — the fact cites a derived artifact, not a real source.
+     * Default `[]` (no circular check unless the consumer declares its kinds).
+     */
+    selfArtifactKinds?: string[];
+}
+/**
+ * @experimental
+ *
+ * Build a fail-closed KB gate. The returned function runs the built-in floor
+ * (passage-non-empty → passage-present → value-in-passage → no-circular-citation)
+ * then any consumer judges, returning on the first veto.
+ */
+declare function createKbGate(options?: CreateKbGateOptions): (candidate: FactCandidate) => Promise<KbGateResult>;
+
+export { type CreateKbGateOptions as C, type FactCandidate as F, type KbGateResult as K, type FactJudge as a, type FactJudgeVerdict as b, createKbGate as c };

package/dist/{loop-runner-bin-D4Ir7b00.d.ts → loop-runner-bin-BGpVVyXp.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, F as FactCandidate, b as CreateKbGateOptions } from './kb-gate-CKfykcYQ.js';
-import { C as CoderOutput } from './coder-LKm3Mczw.js';
-import { S as SandboxClient, O as OutputAdapter, V as Validator, A as AgentRunSpec, b as LoopResult } from './types-CklkW4Eh.js';
-import { T as TopologyPlanner, C as CreateDriverOptions, D as DriverDecision } from './driver-B2RKkVJW.js';
+import { D as DelegateCodeArgs, C as CoderReviewer, a as CoderWinnerSelection } from './delegates-BPLIl8EC.js';
+import { F as FactCandidate, C as CreateKbGateOptions } from './kb-gate-CuzMYGYM.js';
+import { C as CoderOutput } from './coder-CEkUFv8h.js';
+import { S as SandboxClient } from './types-C8rNlxfV.js';
 
 /**
  * @experimental
@@ -20,7 +20,6 @@ import { T as TopologyPlanner, C as CreateDriverOptions, D as DriverDecision } f
  *   research     → research-in-a-loop with valid-only KB growth (createKbGate)
  *   audit        → analyze trace/run data → findings (runAnalystLoop, caller-wired)
  *   self-improve → closed-loop text/config optimization (selfImprove, held-out gated)
- *   dynamic      → agent-authored topology (runLoop + createDriver)
  *
  * It is intentionally a thin façade: the value is that EVERY product reuses the
  * one hardened engine instead of forking delegation logic. The dispatcher owns
@@ -30,7 +29,7 @@ import { T as TopologyPlanner, C as CreateDriverOptions, D as DriverDecision } f
  */
 
 /** @experimental Every delegated-loop mode, for validation + CLI surfaces. */
-declare const DELEGATED_LOOP_MODES: readonly ["code", "review", "research", "audit", "self-improve", "dynamic"];
+declare const DELEGATED_LOOP_MODES: readonly ["code", "review", "research", "audit", "self-improve"];
 /** @experimental */
 type DelegatedLoopMode = (typeof DELEGATED_LOOP_MODES)[number];
 /** @experimental Type guard for an untrusted mode string (CLI / config input). */
@@ -88,26 +87,6 @@ declare function coderLoopRunner(options: CoderLoopRunnerOptions): DelegatedLoop
 declare function reviewLoopRunner(options: CoderLoopRunnerOptions & {
     reviewer: CoderReviewer;
 }): DelegatedLoopRunner<CoderOutput>;
-/** @experimental Options for the default `dynamic` runner. */
-interface DynamicLoopRunnerOptions<Task, Output> {
-    sandboxClient: SandboxClient;
-    /** The agent-authored topology planner (sync or async; an async planner is where an LLM call goes). */
-    planner: TopologyPlanner<Task, Output>;
-    task: Task;
-    output: OutputAdapter<Output>;
-    validator?: Validator<Output>;
-    /** Exactly one of `agentRun` / `agentRuns` (runLoop validates). */
-    agentRun?: AgentRunSpec<Task>;
-    agentRuns?: AgentRunSpec<Task>[];
-    maxIterations?: number;
-    maxFanout?: number;
-    /** Optional trace-analyst hook forwarded to the dynamic driver so the loop runs
-     *  `f(trace, findings)` — see `CreateDriverOptions.analyze`. Caller-side
-     *  seam to `runAnalystLoop`; keeps this runner analyst-free. */
-    analyze?: CreateDriverOptions<Task, Output>['analyze'];
-}
-/** @experimental `dynamic` mode — agent-authored topology over `runLoop`. */
-declare function dynamicLoopRunner<Task, Output>(o: DynamicLoopRunnerOptions<Task, Output>): DelegatedLoopRunner<LoopResult<Task, Output, DriverDecision>>;
 /** @experimental A fact rejected at the KB gate — surfaced, never dropped. */
 interface VetoedFact {
     candidate: FactCandidate;
@@ -193,4 +172,4 @@ declare function parseLoopRunnerArgv(argv: string[]): {
     config?: string;
 };
 
-export { type CoderLoopRunnerOptions as C, DELEGATED_LOOP_MODES as D, type LoopRunnerCliArgs as L, type ResearchLoopResult as R, type VetoedFact as V, type DelegatedLoopMode as a, type DelegatedLoopRegistry as b, type DelegatedLoopResult as c, type DelegatedLoopRunner as d, type DynamicLoopRunnerOptions as e, type LoopRunnerCliResult as f, type ResearchLoopRunnerOptions as g, type RunDelegatedLoopOptions as h, auditLoopRunner as i, coderLoopRunner as j, dynamicLoopRunner as k, isDelegatedLoopMode as l, reviewLoopRunner as m, runDelegatedLoop as n, runLoopRunnerCli as o, parseLoopRunnerArgv as p, researchLoopRunner as r, selfImproveLoopRunner as s };
+export { type CoderLoopRunnerOptions as C, DELEGATED_LOOP_MODES as D, type LoopRunnerCliArgs as L, type ResearchLoopResult as R, type VetoedFact as V, type DelegatedLoopMode as a, type DelegatedLoopRegistry as b, type DelegatedLoopResult as c, type DelegatedLoopRunner as d, type LoopRunnerCliResult as e, type ResearchLoopRunnerOptions as f, type RunDelegatedLoopOptions as g, auditLoopRunner as h, coderLoopRunner as i, isDelegatedLoopMode as j, reviewLoopRunner as k, runDelegatedLoop as l, runLoopRunnerCli as m, parseLoopRunnerArgv as p, researchLoopRunner as r, selfImproveLoopRunner as s };

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

@@ -1,13 +1,13 @@
 #!/usr/bin/env node
-export { L as LoopRunnerCliArgs, f as LoopRunnerCliResult, p as parseLoopRunnerArgv, o as runLoopRunnerCli } from './loop-runner-bin-D4Ir7b00.js';
+export { L as LoopRunnerCliArgs, e as LoopRunnerCliResult, p as parseLoopRunnerArgv, m as runLoopRunnerCli } from './loop-runner-bin-BGpVVyXp.js';
 import '@tangle-network/agent-eval/campaign';
 import '@tangle-network/agent-eval/contract';
 import './types-p8dWBIXL.js';
 import '@tangle-network/agent-eval';
-import './kb-gate-CKfykcYQ.js';
-import './coder-LKm3Mczw.js';
+import './delegates-BPLIl8EC.js';
+import './coder-CEkUFv8h.js';
 import '@tangle-network/sandbox';
-import './types-CklkW4Eh.js';
+import './types-C8rNlxfV.js';
 import './runtime-hooks-C7JwKb9E.js';
 import './substrate-CUgk7F7s.js';
-import './driver-B2RKkVJW.js';
+import './kb-gate-CuzMYGYM.js';

package/dist/loop-runner-bin.js

@@ -2,14 +2,15 @@
 import {
   parseLoopRunnerArgv,
   runLoopRunnerCli
-} from "./chunk-K5M3SHEU.js";
+} from "./chunk-2BDXWZUC.js";
 import "./chunk-FNMGYYSS.js";
-import "./chunk-AYRQZRDV.js";
+import "./chunk-A73RADPB.js";
 import "./chunk-KADIJAD4.js";
-import "./chunk-HNUXAZIJ.js";
+import "./chunk-P5OKDSLB.js";
+import "./chunk-JTH2FPCK.js";
+import "./chunk-WIR4HOOJ.js";
+import "./chunk-VLF5RHEQ.js";
 import "./chunk-G3RGMA7C.js";
-import "./chunk-K6WP7PYW.js";
-import "./chunk-GSUO5QS6.js";
 import "./chunk-DGUM43GV.js";
 export {
   parseLoopRunnerArgv,

package/dist/loops.d.ts

@@ -1,11 +1,13 @@
 export { AgentProfile, CreateSandboxOptions, SandboxEvent, SandboxInstance } from '@tangle-network/sandbox';
-export { AgenticOptions, AgenticRunResult, AgenticSurface, AgenticTask, AgenticTool, AnytimeReport, AnytimeStrategySummary, AnytimeTaskCurve, ArtifactHandle, AssertTraceDerivedFindings, AuditIntentInput, AuditIntentOptions, AuthorStrategyOptions, AuthoredStrategy, BenchmarkCell, BenchmarkConfig, BenchmarkLift, BenchmarkReport, BenchmarkStrategySummary, BenchmarkTaskRow, BridgeSeam, BudgetPool, BudgetReadout, ChampionPick, ChampionPolicy, CheckpointCapableBox, CliSeam, CombinatorShape, Corpus, CorpusFilter, CorpusRecord, CreateScopeAnalystOptions, CriuCapableClient, DefinePersona, DefinePersonaInput, Deliverable, Environment, EqualKArm, EqualKOnCost, EqualKOnCostOptions, EqualKVerdict, EvolutionArchiveNode, EvolutionAuthor, EvolutionBandInfo, EvolutionCandidate, EvolutionGeneration, EvolutionReport, ExecutorConfig, Fanout, FanoutOptions, FanoutSynthesis, FileCorpus, FileResultBlobStore, FileSpawnJournal, FlatWidenGate, ForkCapableBox, GitWorkspaceOptions, HarvestCorpusOptions, HarvestFailure, HarvestReport, InMemoryCorpus, InMemoryResultBlobStore, InMemorySpawnJournal, IntentAudit, LoopDispatchOptions, LoopOptionsForDispatch, LoopShape, LoopUntil, LoopUntilSpec, LoopUntilState, McpEndpoint, McpEnvironmentOptions, 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, acquireSandbox, adaptiveRefine, anytimeReport, assertStrategyContract, assertTraceDerivedFindings, auditIntent, authorStrategy, breadthDriver, buildSteerContext, builtinShapes, contentAddress, createBudgetPool, createExecutor, createExecutorRegistry, createMcpEnvironment, createRootHandle, createSandboxLineage, createScope, createScopeAnalyst, createShapeRegistry, createSupervisor, createVerifierEnvironment, createWaterfallCollector, defaultAnalystInstruction, defaultAuditorInstruction, definePersona, defineStrategy, depthDriver, discriminatingMeans, equalKOnCost, extractLlmCallEvent, fanout, flatWidenGate, gitWorkspace, harvestCorpus, inlineSandboxClient, jjWorkspace, localShell, loopDispatch, loopUntil, mapSandboxEvent, materializeTreeView, observe, openSandboxRun, panel, pickChampion, pipeline, printBenchmarkReport, probeSandboxCapabilities, promotionGate, refine, registerShape, registryScopeAnalyst, renderAnytimeTable, renderCorpusToInstructions, renderReport, replaySpawnTree, reportLoopUsage, runAgentic, runBenchmark, runPersonified, runStrategyEvolution, sample, sampleThenRefine, selectChampion, settledToIteration, spendFromUsageEvents, strategyAuthorContract, trajectoryReport, verify, widen } from './runtime.js';
-export { A as AnalyzeInput, a as CompletionAnalyst, b as CompletionEvidence, c as CompletionPolicy, d as CompletionVerdict, C as CreateDriverOptions, D as DriverDecision, P as PlannerContext, e as TopologyMove, T as TopologyPlanner, f as completionAuthorizes, g as createDriver, h as deterministicCompletion, r as renderAnalyses, s as sentinelCompletion, i as stopSentinel } from './driver-B2RKkVJW.js';
-export { R as RouterChatResult, a as RouterChatToolsResult, b as RouterConfig, c as RouterToolCall, d as RouterToolLoopResult, T as ToolSpec, r as routerChatWithTools, e as routerChatWithUsage, f as routerToolLoop } from './router-client-B0Qi1NiN.js';
-export { R as RunLoopOptions, c as createSandboxForSpec, d as defaultSelectWinner, r as runLoop } from './run-loop-DgVhucoR.js';
-export { A as Agent, d as AgentSpec, B as Budget, j as Executor, k as ExecutorContext, h as ExecutorFactory, E as ExecutorRegistry, l as ExecutorResult, H as Handle, N as NodeId, m as NodeSnapshot, n as NodeStatus, o as Restart, R as ResultBlobStore, e as RootHandle, p as RootSignal, q as Runtime, S as Scope, c as Settled, b as SpawnEvent, a as SpawnJournal, r as SpawnOpts, g as Spend, f as SupervisedResult, i as Supervisor, s as SupervisorOpts, T as TreeView, U as UsageEvent, W as WidenGate } from './types-CNDJCL_0.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-CklkW4Eh.js';
+export { AgenticOptions, AgenticRunResult, AgenticSurface, AgenticTask, AgenticTool, AnytimeReport, AnytimeStrategySummary, AnytimeTaskCurve, ArtifactHandle, AssertTraceDerivedFindings, AuditIntentInput, AuditIntentOptions, AuthorStrategyOptions, AuthoredProfile, AuthoredStrategy, BenchmarkCell, BenchmarkConfig, BenchmarkLift, BenchmarkReport, BenchmarkStrategySummary, BenchmarkTaskRow, BridgeSeam, BudgetPool, BudgetReadout, ChampionPick, ChampionPolicy, CheckpointCapableBox, CliSeam, 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, 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, acquireSandbox, adaptiveRefine, anytimeReport, asAuthoredProfile, assertStrategyContract, assertTraceDerivedFindings, auditIntent, authorStrategy, authoredWorker, breadthDriver, buildSteerContext, builtinShapes, completionAuthorizes, contentAddress, coordinationDriverAgent, createBudgetPool, createExecutor, createExecutorRegistry, createMcpEnvironment, createRootHandle, createSandboxLineage, createScope, createScopeAnalyst, createShapeRegistry, createSupervisor, createVerifierEnvironment, createWaterfallCollector, 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 } 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 { t as Agent, s as AgentSpec, B as Budget, z as Executor, G as ExecutorContext, y as ExecutorFactory, E as ExecutorRegistry, H as ExecutorResult, K as Handle, N as NodeId, L as NodeSnapshot, O as NodeStatus, P as Restart, R as ResultBlobStore, u as RootHandle, V as RootSignal, W as Runtime, x as Scope, r as Settled, q as SpawnEvent, p as SpawnJournal, X as SpawnOpts, w as Spend, v as SupervisedResult, D as Supervisor, Y as SupervisorOpts, T as TreeView, U as UsageEvent, Z as WidenGate } from './coordination-BMzskrUR.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 { DefaultVerdict } from '@tangle-network/agent-eval';
 import './runtime-hooks-C7JwKb9E.js';
 import '@tangle-network/agent-eval/campaign';
 import './types-p8dWBIXL.js';
+import './delegates-BPLIl8EC.js';
+import './coder-CEkUFv8h.js';
+import './substrate-CUgk7F7s.js';

package/dist/loops.js

@@ -8,17 +8,19 @@ import {
   acquireSandbox,
   adaptiveRefine,
   anytimeReport,
+  asAuthoredProfile,
   assertStrategyContract,
   assertTraceDerivedFindings,
   auditIntent,
   authorStrategy,
+  authoredWorker,
   breadthDriver,
   buildSteerContext,
   builtinShapes,
   completionAuthorizes,
   contentAddress,
+  coordinationDriverAgent,
   createBudgetPool,
-  createDriver,
   createExecutor,
   createExecutorRegistry,
   createMcpEnvironment,
@@ -39,17 +41,23 @@ import {
   depthDriver,
   deterministicCompletion,
   discriminatingMeans,
+  driverChild,
+  driverExecutorFactory,
+  driverRuntime,
   equalKOnCost,
   fanout,
   flatWidenGate,
+  gateOnDeliverable,
   gitWorkspace,
   harvestCorpus,
   inlineSandboxClient,
+  isDriverSpec,
   jjWorkspace,
   localShell,
   loopDispatch,
   loopUntil,
   materializeTreeView,
+  nestedScopeSeamKey,
   observe,
   openSandboxRun,
   panel,
@@ -61,7 +69,6 @@ import {
   refine,
   registerShape,
   registryScopeAnalyst,
-  renderAnalyses,
   renderAnytimeTable,
   renderCorpusToInstructions,
   renderReport,
@@ -72,6 +79,7 @@ import {
   routerToolLoop,
   runAgentic,
   runBenchmark,
+  runInWorkspace,
   runLoop,
   runPersonified,
   runStrategyEvolution,
@@ -79,18 +87,23 @@ import {
   sampleThenRefine,
   selectChampion,
   sentinelCompletion,
+  serveCoordinationMcp,
   settledToIteration,
   spendFromUsageEvents,
   stopSentinel,
   strategyAuthorContract,
+  supervisorSkill,
   trajectoryReport,
   verify,
-  widen
-} from "./chunk-K6WP7PYW.js";
+  widen,
+  withDriverExecutor
+} from "./chunk-JTH2FPCK.js";
+import "./chunk-WIR4HOOJ.js";
 import {
   extractLlmCallEvent,
   mapSandboxEvent
-} from "./chunk-GSUO5QS6.js";
+} from "./chunk-VLF5RHEQ.js";
+import "./chunk-G3RGMA7C.js";
 import "./chunk-DGUM43GV.js";
 export {
   FileCorpus,
@@ -102,17 +115,19 @@ export {
   acquireSandbox,
   adaptiveRefine,
   anytimeReport,
+  asAuthoredProfile,
   assertStrategyContract,
   assertTraceDerivedFindings,
   auditIntent,
   authorStrategy,
+  authoredWorker,
   breadthDriver,
   buildSteerContext,
   builtinShapes,
   completionAuthorizes,
   contentAddress,
+  coordinationDriverAgent,
   createBudgetPool,
-  createDriver,
   createExecutor,
   createExecutorRegistry,
   createMcpEnvironment,
@@ -133,19 +148,25 @@ export {
   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,
@@ -157,7 +178,6 @@ export {
   refine,
   registerShape,
   registryScopeAnalyst,
-  renderAnalyses,
   renderAnytimeTable,
   renderCorpusToInstructions,
   renderReport,
@@ -168,6 +188,7 @@ export {
   routerToolLoop,
   runAgentic,
   runBenchmark,
+  runInWorkspace,
   runLoop,
   runPersonified,
   runStrategyEvolution,
@@ -175,12 +196,15 @@ export {
   sampleThenRefine,
   selectChampion,
   sentinelCompletion,
+  serveCoordinationMcp,
   settledToIteration,
   spendFromUsageEvents,
   stopSentinel,
   strategyAuthorContract,
+  supervisorSkill,
   trajectoryReport,
   verify,
-  widen
+  widen,
+  withDriverExecutor
 };
 //# sourceMappingURL=loops.js.map

package/dist/mcp/bin.js

@@ -1,37 +1,81 @@
 #!/usr/bin/env node
 import {
-  createMcpServer,
   createPropagatingTraceEmitter,
   detectExecutor,
   readTraceContextFromEnv
-} from "../chunk-5M2WDWBI.js";
-import "../chunk-WIR4HOOJ.js";
+} from "../chunk-FRBWCJLP.js";
 import {
-  DelegationTaskQueue,
-  FileDelegationStore
-} from "../chunk-FO4DCM7R.js";
+  resolveRouterBaseUrl
+} from "../chunk-GRAGM4MC.js";
 import {
   coderTaskFromArgs,
-  composeLoopTraceEmitters,
   createDefaultCoderDelegate,
-  createDriveTurnResumeDriver,
-  detachedTurnEvents,
-  formatDetachedSessionRef,
-  parseDetachedSessionRef,
-  runDetachedTurn,
   settleDetachedCoderTurn
-} from "../chunk-AYRQZRDV.js";
+} from "../chunk-A73RADPB.js";
 import {
   coderProfile
 } from "../chunk-KADIJAD4.js";
 import "../chunk-GLR25NG7.js";
-import "../chunk-G3RGMA7C.js";
 import {
+  DEFAULT_SANDBOX_BASE_URL
+} from "../chunk-XRYEZPR6.js";
+import {
+  DelegationTaskQueue,
+  FileDelegationStore,
+  composeLoopTraceEmitters,
+  createDriveTurnResumeDriver,
+  createMcpServer,
+  detachedTurnEvents,
+  formatDetachedSessionRef,
+  parseDetachedSessionRef,
+  runDetachedTurn,
   runLoop
-} from "../chunk-K6WP7PYW.js";
-import "../chunk-GSUO5QS6.js";
+} from "../chunk-JTH2FPCK.js";
+import "../chunk-WIR4HOOJ.js";
+import "../chunk-VLF5RHEQ.js";
+import "../chunk-G3RGMA7C.js";
 import "../chunk-DGUM43GV.js";
 
+// src/mcp/researcher-provisioning.ts
+var DEFAULT_HARNESS = "opencode";
+var DEFAULT_MODEL = "moonshotai/kimi-k2.6";
+function trimmed(value) {
+  const t = value?.trim();
+  return t ? t : void 0;
+}
+function csv(value) {
+  const list = value?.split(",").map((v) => v.trim()).filter(Boolean);
+  return list && list.length > 0 ? list : void 0;
+}
+function resolveResearcherProvisioning(env = process.env) {
+  const harness = trimmed(env.MCP_RESEARCHER_HARNESS) ?? DEFAULT_HARNESS;
+  const model = trimmed(env.MCP_RESEARCHER_MODEL) ?? trimmed(env.MCP_WORKER_MODEL) ?? trimmed(env.WORKER_MODEL) ?? DEFAULT_MODEL;
+  const routerKey = trimmed(env.MCP_RESEARCHER_ROUTER_KEY) ?? trimmed(env.TANGLE_API_KEY);
+  const base = trimmed(env.MCP_RESEARCHER_ROUTER_BASE_URL) ?? resolveRouterBaseUrl(env);
+  const routerBaseUrl = /\/v\d+\/?$/.test(base) ? base.replace(/\/$/, "") : `${base.replace(/\/$/, "")}/v1`;
+  const fanoutHarnesses = csv(env.MCP_RESEARCHER_FANOUT_HARNESSES);
+  const fanoutModels = csv(env.MCP_RESEARCHER_FANOUT_MODELS);
+  return {
+    harness,
+    model,
+    ...routerKey ? { routerKey } : {},
+    routerBaseUrl,
+    ...fanoutHarnesses ? { fanoutHarnesses } : {},
+    ...fanoutModels ? { fanoutModels } : {}
+  };
+}
+function applyRouterEnv(spec, routerKey, routerBaseUrl) {
+  if (!routerKey) return;
+  spec.sandboxOverrides = {
+    ...spec.sandboxOverrides ?? {},
+    env: {
+      ...spec.sandboxOverrides?.env ?? {},
+      OPENAI_API_KEY: routerKey,
+      OPENAI_BASE_URL: routerBaseUrl
+    }
+  };
+}
+
 // src/mcp/bin.ts
 async function main() {
   const fanoutHarnesses = parseHarnesses(process.env.MCP_CODER_FANOUT_HARNESSES);
@@ -221,11 +265,8 @@ async function loadSandboxClient(apiKey) {
     );
     process.exit(2);
   }
-  const baseUrl = process.env.SANDBOX_BASE_URL;
-  return new SandboxCtor({
-    apiKey,
-    ...baseUrl ? { baseUrl } : {}
-  });
+  const baseUrl = process.env.SANDBOX_BASE_URL?.trim() || DEFAULT_SANDBOX_BASE_URL;
+  return new SandboxCtor({ apiKey, baseUrl });
 }
 async function loadResearcherSupport(executor, maxConcurrency, traceEmitter) {
   const sandboxClient = executor.client;
@@ -235,9 +276,22 @@ async function loadResearcherSupport(executor, maxConcurrency, traceEmitter) {
   const fanoutFactory = mod.multiHarnessResearcherFanout;
   const singleFactory = mod.researcherProfile;
   if (!fanoutFactory || !singleFactory) return void 0;
+  const {
+    harness,
+    model,
+    routerKey,
+    routerBaseUrl,
+    fanoutHarnesses: cfgFanoutHarnesses,
+    fanoutModels
+  } = resolveResearcherProvisioning();
+  const buildPreset = (task) => {
+    const preset = singleFactory({ task, harness, model });
+    applyRouterEnv(preset.agentRunSpec, routerKey, routerBaseUrl);
+    return preset;
+  };
   const settleSingle = async (turn, args, sessionId, signal) => {
     const task = buildResearchTask(args);
-    const preset = singleFactory({ task });
+    const preset = buildPreset(task);
     if (!preset.validator) {
       throw new Error("agent-runtime-mcp: researcher preset exposes no validator; cannot settle");
     }
@@ -254,7 +308,7 @@ async function loadResearcherSupport(executor, maxConcurrency, traceEmitter) {
     const loopEmitter = composeLoopTraceEmitters(traceEmitter, ctx.traceEmitter);
     ctx.report({ iteration: 0, phase: "starting" });
     if (variants <= 1) {
-      const preset = singleFactory({ task });
+      const preset = buildPreset(task);
       if (ctx.detachedSessionRef !== void 0 && ctx.updateDetachedSessionRef) {
         const { sessionId } = parseDetachedSessionRef(ctx.detachedSessionRef);
         const rebind = ctx.updateDetachedSessionRef;
@@ -301,10 +355,20 @@ async function loadResearcherSupport(executor, maxConcurrency, traceEmitter) {
       ctx.report({ iteration: 1, phase: "completed" });
       return output2;
     }
-    const fanout = fanoutFactory({ task });
+    const fanoutHarnesses = cfgFanoutHarnesses ?? Array.from({ length: variants }, () => harness);
+    const fanout = fanoutFactory({
+      task,
+      harnesses: fanoutHarnesses,
+      models: fanoutHarnesses.map((_, i) => fanoutModels?.[i] ?? model)
+    });
+    for (const spec of fanout.agentRuns) {
+      applyRouterEnv(spec, routerKey, routerBaseUrl);
+    }
+    const runs = fanout.agentRuns.slice(0, variants);
+    const effectiveVariants = Math.max(1, runs.length);
     const result = await runLoop({
       driver: fanout.driver,
-      agentRuns: fanout.agentRuns.slice(0, variants),
+      agentRuns: runs,
       output: fanout.output,
       validator: fanout.validator,
       task,
@@ -313,8 +377,8 @@ async function loadResearcherSupport(executor, maxConcurrency, traceEmitter) {
         signal: ctx.signal,
         ...loopEmitter ? { traceEmitter: loopEmitter } : {}
       },
-      maxIterations: variants,
-      maxConcurrency: Math.min(maxConcurrency, variants)
+      maxIterations: effectiveVariants,
+      maxConcurrency: Math.min(maxConcurrency, effectiveVariants)
     });
     const output = result.winner?.output;
     if (!output) throw new Error("researcher delegate fanout produced no winner");
@@ -326,7 +390,7 @@ async function loadResearcherSupport(executor, maxConcurrency, traceEmitter) {
     resume: {
       message(args) {
         const task = buildResearchTask(args);
-        const spec = singleFactory({ task }).agentRunSpec;
+        const spec = buildPreset(task).agentRunSpec;
         return spec.taskToPrompt(task);
       },
       async settle(turn, args, signal) {
@@ -356,8 +420,8 @@ function parseHarnesses(raw) {
 }
 function parseFleetId(raw) {
   if (typeof raw !== "string") return void 0;
-  const trimmed = raw.trim();
-  return trimmed.length > 0 ? trimmed : void 0;
+  const trimmed2 = raw.trim();
+  return trimmed2.length > 0 ? trimmed2 : void 0;
 }
 function parseConcurrency(raw) {
   if (!raw) return 4;