@tangle-network/agent-runtime 0.66.0 → 0.68.0

package/dist/index.js

@@ -1,7 +1,7 @@
 import {
   mcpToolsForRuntimeMcp,
   mcpToolsForRuntimeMcpSubset
-} from "./chunk-E4X4FNQZ.js";
+} from "./chunk-OYU5LR4T.js";
 import {
   DEFAULT_ROUTER_BASE_URL,
   cleanModelId,
@@ -21,9 +21,9 @@ import {
   runLoopRunnerCli,
   selfImproveLoopRunner,
   worktreeLoopRunner
-} from "./chunk-YWO4H64E.js";
+} from "./chunk-FCIPUALH.js";
 import "./chunk-FNMGYYSS.js";
-import "./chunk-RYD7ND4A.js";
+import "./chunk-QNUEFNU7.js";
 import "./chunk-DVQGYDN5.js";
 import "./chunk-P5OKDSLB.js";
 import {
@@ -31,7 +31,7 @@ import {
   defineRuntimeHooks,
   notifyRuntimeDecisionPoint,
   notifyRuntimeHookEvent
-} from "./chunk-MT4XM3G6.js";
+} from "./chunk-VKUHUFX7.js";
 import "./chunk-WIR4HOOJ.js";
 import {
   AgentEvalError,

package/dist/loop-runner-bin.js

@@ -2,12 +2,12 @@
 import {
   parseLoopRunnerArgv,
   runLoopRunnerCli
-} from "./chunk-YWO4H64E.js";
+} from "./chunk-FCIPUALH.js";
 import "./chunk-FNMGYYSS.js";
-import "./chunk-RYD7ND4A.js";
+import "./chunk-QNUEFNU7.js";
 import "./chunk-DVQGYDN5.js";
 import "./chunk-P5OKDSLB.js";
-import "./chunk-MT4XM3G6.js";
+import "./chunk-VKUHUFX7.js";
 import "./chunk-WIR4HOOJ.js";
 import "./chunk-VLF5RHEQ.js";
 import "./chunk-O2UPHN7X.js";

package/dist/loops.d.ts

@@ -1,5 +1,5 @@
 export { AgentProfile, CreateSandboxOptions, SandboxEvent, SandboxInstance } from '@tangle-network/sandbox';
-export { AgenticOptions, AgenticRunResult, AgenticSurface, AgenticTask, AgenticTool, AnytimeReport, AnytimeStrategySummary, AnytimeTaskCurve, ArtifactHandle, AuditIntentInput, AuditIntentOptions, AuthorStrategyOptions, AuthoredProfile, AuthoredStrategy, BenchmarkCell, BenchmarkConfig, BenchmarkLift, BenchmarkReport, BenchmarkStrategySummary, BenchmarkTaskRow, BridgeSeam, BudgetPool, BudgetReadout, ChampionPick, ChampionPolicy, CheckpointCapableBox, CliSeam, CliWorktreeSeam, CompletionAnalyst, CompletionEvidence, CompletionPolicy, CompletionVerdict, CoordinationDriverOptions, CoordinationMcpHandle, CreateScopeAnalystOptions, CriuCapableClient, Deliverable, DriverChat, DriverMessage, DriverToolCall, DriverTurn, Environment, EvolutionArchiveNode, EvolutionAuthor, EvolutionBandInfo, EvolutionCandidate, EvolutionGeneration, EvolutionReport, ExecutorConfig, FileCorpus, FileResultBlobStore, FileSpawnJournal, ForkCapableBox, GitWorkspaceOptions, HarvestCorpusOptions, HarvestFailure, HarvestReport, InMemoryCorpus, InMemoryResultBlobStore, InMemorySpawnJournal, Inbox, InboxMessage, IntentAudit, LoopDispatchOptions, LoopOptionsForDispatch, McpEndpoint, McpEnvironmentOptions, NestedScopeSeam, Observation, ObserveInput, ObserveOptions, OpenSandboxRunOptions, PromotionGateOptions, PromotionVerdict, RegistryAnalyzeProjection, ReservationTicket, RouterSeam, RouterToolsSeam, RunAgenticOptions, SandboxCapabilities, SandboxLineage, SandboxLineageHandle, SandboxRun, SandboxSeam, SessionCapableBox, SessionMessageLike, SessionTraceBox, Shell, ShotPersona, ShotSpec, Strategy, StrategyCtx, StrategyEvolutionConfig, StrategyResult, SurfaceScore, ToolPartDecoder, ToolStepInput, TraceSource, TrajectoryAnalysis, TurnResult, UsageSink, VerifierEnvironmentOptions, WatchTraceOptions, WaterfallCollector, WaterfallReport, WaterfallSpan, Workspace, WorkspaceCommit, WorkspaceRun, acquireSandbox, adaptiveRefine, analyzeTrace, anytimeReport, asAuthoredProfile, assertStrategyContract, assertTraceDerivedFindings, auditIntent, authorStrategy, authoredWorker, breadthDriver, buildSteerContext, builtinShapes, cliWorktreeExecutor, completionAuthorizes, contentAddress, coordinationDriverAgent, createBudgetPool, createExecutor, createExecutorRegistry, createInbox, createMcpEnvironment, createPartsTraceSource, createPushTraceSource, createRootHandle, createSandboxLineage, createScope, createScopeAnalyst, createShapeRegistry, createSupervisor, createVerifierEnvironment, createWaterfallCollector, decodeAnthropicPart, decodeOpenAiPart, decodeOpencodePart, decodeToolPart, defaultAnalystInstruction, defaultAuditorInstruction, defaultToolDetectors, definePersona, defineStrategy, depthDriver, deterministicCompletion, discriminatingMeans, driverChild, driverExecutorFactory, driverRuntime, equalKOnCost, extractLlmCallEvent, fanout, flatWidenGate, 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, sandboxSessionTraceSource, selectChampion, selectValidWinner, sentinelCompletion, serveCoordinationMcp, settledToIteration, spendFromUsageEvents, stopSentinel, strategyAuthorContract, supervisorSkill, toToolSpan, toolPartDecoders, trajectoryReport, verify, watchTrace, widen, withDriverExecutor } from './runtime.js';
+export { AgenticOptions, AgenticRunResult, AgenticSurface, AgenticTask, AgenticTool, AnytimeReport, AnytimeStrategySummary, AnytimeTaskCurve, ArtifactHandle, AuditIntentInput, AuditIntentOptions, AuthorStrategyOptions, AuthoredProfile, AuthoredStrategy, BenchmarkCell, BenchmarkConfig, BenchmarkLift, BenchmarkReport, BenchmarkStrategySummary, BenchmarkTaskRow, BridgeSeam, BudgetPool, BudgetReadout, ChampionPick, ChampionPolicy, CheckpointCapableBox, CliSeam, CliWorktreeSeam, CompletionAnalyst, CompletionEvidence, CompletionPolicy, CompletionVerdict, CoordinationDriverOptions, CoordinationMcpHandle, CreateScopeAnalystOptions, CriuCapableClient, Deliverable, DriverChat, DriverMessage, DriverToolCall, DriverTurn, Environment, EvolutionArchiveNode, EvolutionAuthor, EvolutionBandInfo, EvolutionCandidate, EvolutionGeneration, EvolutionReport, ExecutorConfig, FileCorpus, FileResultBlobStore, FileSpawnJournal, ForkCapableBox, GitWorkspaceOptions, HarvestCorpusOptions, HarvestFailure, HarvestReport, InMemoryCorpus, InMemoryResultBlobStore, InMemoryRunContext, InMemoryRunContextOptions, InMemorySpawnJournal, Inbox, InboxMessage, IntentAudit, LoopDispatchOptions, LoopOptionsForDispatch, McpEndpoint, McpEnvironmentOptions, NestedScopeSeam, Observation, ObserveInput, ObserveOptions, OpenSandboxRunOptions, PromotionGateOptions, PromotionVerdict, RegistryAnalyzeProjection, ReservationTicket, RouterSeam, RouterToolsSeam, RunAgenticOptions, SandboxCapabilities, SandboxLineage, SandboxLineageHandle, SandboxRun, SandboxSeam, SessionCapableBox, SessionMessageLike, SessionTraceBox, Shell, ShotPersona, ShotSpec, Strategy, StrategyCtx, StrategyEvolutionConfig, StrategyResult, SurfaceScore, ToolPartDecoder, ToolStepInput, TraceSource, TrajectoryAnalysis, TurnResult, UsageSink, VerifierEnvironmentOptions, WatchTraceOptions, WaterfallCollector, WaterfallReport, WaterfallSpan, Workspace, WorkspaceCommit, WorkspaceRun, acquireSandbox, adaptiveRefine, analyzeTrace, anytimeReport, asAuthoredProfile, assertStrategyContract, assertTraceDerivedFindings, auditIntent, authorStrategy, authoredWorker, breadthDriver, buildSteerContext, builtinShapes, cliWorktreeExecutor, completionAuthorizes, contentAddress, coordinationDriverAgent, createBudgetPool, createExecutor, createExecutorRegistry, createInMemoryRunContext, createInbox, createMcpEnvironment, createPartsTraceSource, createPushTraceSource, createRootHandle, createSandboxLineage, createScope, createScopeAnalyst, createShapeRegistry, createSupervisor, createVerifierEnvironment, createWaterfallCollector, decodeAnthropicPart, decodeOpenAiPart, decodeOpencodePart, decodeToolPart, defaultAnalystInstruction, defaultAuditorInstruction, defaultToolDetectors, definePersona, defineStrategy, depthDriver, deterministicCompletion, discriminatingMeans, driverChild, driverExecutorFactory, driverRuntime, equalKOnCost, extractLlmCallEvent, fanout, flatWidenGate, 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, sandboxSessionTraceSource, selectChampion, selectValidWinner, sentinelCompletion, serveCoordinationMcp, settledToIteration, spendFromUsageEvents, stopSentinel, strategyAuthorContract, supervisorSkill, toToolSpan, toolPartDecoders, trajectoryReport, verify, watchTrace, widen, withDriverExecutor } from './runtime.js';
 export { d as AssertTraceDerivedFindings, A as AuthoredHarness, u as CoderCheckConstraints, v as CoderCheckInput, g as CombinatorShape, c as Corpus, l as CorpusFilter, C as CorpusRecord, w as DefinePersona, D as DefinePersonaInput, t as DeliverableSpec, E as EqualKArm, x as EqualKOnCost, q as EqualKOnCostOptions, r as EqualKVerdict, y as Fanout, F as FanoutOptions, z as FanoutSynthesis, j as FanoutWinnerSelector, B as FlatWidenGate, p as LoopShape, G as LoopUntil, L as LoopUntilSpec, H as LoopUntilState, O as Outcome, I as Panel, J as PanelJudge, P as PanelSpec, K as PanelVerdict, M as PatchDeliverableOptions, m as Persona, N as PersonaContext, Q as PersonaExecutors, U as Pipeline, i as PipelineStage, X as RenderCorpusToInstructions, R as RenderCorpusToInstructionsOptions, Y as RunPersonified, n as RunPersonifiedOptions, f as ScopeAnalyst, S as ScopeAnalyzeInput, h as ScopeWidenGate, Z as ShapeBudget, _ as ShapeContext, o as ShapeRegistry, e as SteerContext, $ as TrajectoryNode, s as TrajectoryReport, a0 as TrajectoryReportFn, T as TrajectoryReportOptions, a1 as Verify, V as VerifySpec, a2 as Widen, a3 as WidenDecision, a4 as WidenLineage, k as WidenSpec, W as WinnerStrategy, a5 as WorktreeCliExecutorOptions, a6 as WorktreeCommandResult, a as WorktreeFanoutOptions, b as WorktreePatchArtifact, a7 as countDiffLines, a8 as createWorktreeCliExecutor, a9 as gateOnDeliverable, aa as isNonEmptyPatch, ab as patchDelivered, ac as runCoderChecks, ad as touchedPathsFromPatch, ae as touchesSecretPath, af as worktreeFanout } from './worktree-fanout-DUiKPApb.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-D3PwlG7J.js';

package/dist/loops.js

@@ -27,6 +27,7 @@ import {
   createEventBus,
   createExecutor,
   createExecutorRegistry,
+  createInMemoryRunContext,
   createInbox,
   createMcpEnvironment,
   createPartsTraceSource,
@@ -122,7 +123,7 @@ import {
   widen,
   withDriverExecutor,
   worktreeFanout
-} from "./chunk-MT4XM3G6.js";
+} from "./chunk-VKUHUFX7.js";
 import "./chunk-WIR4HOOJ.js";
 import {
   extractLlmCallEvent,
@@ -160,6 +161,7 @@ export {
   createEventBus,
   createExecutor,
   createExecutorRegistry,
+  createInMemoryRunContext,
   createInbox,
   createMcpEnvironment,
   createPartsTraceSource,

package/dist/mcp/bin.js

@@ -3,7 +3,7 @@ import {
   createPropagatingTraceEmitter,
   detectExecutor,
   readTraceContextFromEnv
-} from "../chunk-RTNMMHWR.js";
+} from "../chunk-LTEF2LYD.js";
 import {
   resolveRouterBaseUrl
 } from "../chunk-GRAGM4MC.js";
@@ -11,7 +11,7 @@ import {
   coderTaskFromArgs,
   detachedSessionDelegate,
   settleDetachedCoderTurn
-} from "../chunk-RYD7ND4A.js";
+} from "../chunk-QNUEFNU7.js";
 import {
   coderTaskToPrompt
 } from "../chunk-DVQGYDN5.js";
@@ -29,7 +29,7 @@ import {
   parseDetachedSessionRef,
   runDetachedTurn,
   runLoop
-} from "../chunk-MT4XM3G6.js";
+} from "../chunk-VKUHUFX7.js";
 import "../chunk-WIR4HOOJ.js";
 import "../chunk-VLF5RHEQ.js";
 import "../chunk-O2UPHN7X.js";

package/dist/mcp/index.js

@@ -4,11 +4,11 @@ import {
   detectExecutor,
   readTraceContextFromEnv,
   traceContextToEnv
-} from "../chunk-RTNMMHWR.js";
+} from "../chunk-LTEF2LYD.js";
 import {
   mcpToolsForRuntimeMcp,
   mcpToolsForRuntimeMcpSubset
-} from "../chunk-E4X4FNQZ.js";
+} from "../chunk-OYU5LR4T.js";
 import {
   createKbGate
 } from "../chunk-FNMGYYSS.js";
@@ -18,7 +18,7 @@ import {
   createSiblingSandboxExecutor,
   detachedSessionDelegate,
   settleDetachedCoderTurn
-} from "../chunk-RYD7ND4A.js";
+} from "../chunk-QNUEFNU7.js";
 import "../chunk-DVQGYDN5.js";
 import {
   DELEGATION_MCP_SERVER_KEY,
@@ -82,7 +82,7 @@ import {
   validateDelegateUiAuditArgs,
   validateDelegationHistoryArgs,
   validateDelegationStatusArgs
-} from "../chunk-MT4XM3G6.js";
+} from "../chunk-VKUHUFX7.js";
 import "../chunk-WIR4HOOJ.js";
 import "../chunk-VLF5RHEQ.js";
 import {

package/dist/runtime.d.ts

@@ -2635,6 +2635,56 @@ declare function routerDriverChat(c: RouterConfig, opts?: {
     temperature?: number;
 }): DriverChat;
 
+/**
+ * @experimental
+ *
+ * `createInMemoryRunContext` — the one-call bundle of the in-memory stores a
+ * `createSupervisor().run(root, task, opts)` needs: a fresh `InMemorySpawnJournal`
+ * (the event-sourced spawn log), a fresh `InMemoryResultBlobStore` (the
+ * content-addressed `outRef` payload store the driver's `observe`/`finalize` reads
+ * settled outputs through), and a fresh `createExecutorRegistry()` (the open
+ * `AgentSpec → Executor` resolver).
+ *
+ * It exists to kill the boilerplate every offline/local supervised run repeats by
+ * hand — three constructors threaded into `SupervisorOpts` — and to single-source the
+ * ONE wiring invariant that is easy to get wrong: when the root is the recursive
+ * `coordinationDriverAgent` LLM-driver brain AND it may spawn DRIVER children (agents
+ * driving agents), the registry MUST be wrapped with `withDriverExecutor` so a
+ * `role: 'driver'` child resolves to the nested-scope executor — and that SAME blob
+ * store MUST be the one passed to `coordinationDriverAgent({ blobs })`, or the driver
+ * reads from a different store than the scope writes to. Pass `{ withDriver: true }`
+ * and reuse the returned `blobs` for both.
+ *
+ * The spread shape matches `SupervisorOpts` exactly, so the call site reads:
+ *   const run = createInMemoryRunContext()
+ *   await createSupervisor().run(root, task, { budget, runId, ...run })
+ */
+
+/** Options for the in-memory run context. */
+interface InMemoryRunContextOptions {
+    /**
+     * Wrap the executor registry with `withDriverExecutor` so a spawned child marked
+     * `role: 'driver'` resolves to the recursive driver-executor (agents driving agents
+     * over a nested `Scope` on the same conserved pool). Leave `false` for a flat tree of
+     * leaf workers. Default `false`.
+     */
+    readonly withDriver?: boolean;
+}
+/**
+ * The bundle of stores a supervised run needs, shaped to spread into `SupervisorOpts`.
+ * The fields are exactly `SupervisorOpts`' `journal` / `blobs` / `executors`.
+ */
+interface InMemoryRunContext {
+    readonly journal: SpawnJournal;
+    readonly blobs: ResultBlobStore;
+    readonly executors: ExecutorRegistry;
+}
+/**
+ * Build a fresh in-memory run context. Every call returns NEW stores (no shared global
+ * state between runs), so two runs never cross-contaminate their journals/blobs.
+ */
+declare function createInMemoryRunContext(opts?: InMemoryRunContextOptions): InMemoryRunContext;
+
 /**
  * @experimental
  *
@@ -3055,4 +3105,4 @@ declare function runInWorkspace<T>(ws: Workspace, body: (cwd: string) => Promise
     commitOnInvalid?: boolean;
 }): Promise<WorkspaceRun<T>>;
 
-export { Agent, AgentRunSpec, AgentSpec, type AgenticOptions, type AgenticRunResult, type AgenticSurface, type AgenticTask, type AgenticTool, type AnytimeReport, type AnytimeStrategySummary, type AnytimeTaskCurve, 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, type BridgeSeam, Budget, type BudgetPool, type BudgetReadout, type ChampionPick, type ChampionPolicy, type CheckpointCapableBox, type CliSeam, type CliWorktreeSeam, CombinatorShape, type CompletionAnalyst, type CompletionEvidence, type CompletionPolicy, type CompletionVerdict, type CoordinationDriverOptions, type CoordinationMcpHandle, Corpus, CorpusFilter, CorpusRecord, type CreateScopeAnalystOptions, type CriuCapableClient, DefinePersonaInput, type Deliverable, DeliverableSpec, type DriverChat, type DriverMessage, type DriverToolCall, type DriverTurn, type Environment, EqualKArm, EqualKOnCostOptions, EqualKVerdict, type EvolutionArchiveNode, type EvolutionAuthor, type EvolutionBandInfo, type EvolutionCandidate, type EvolutionGeneration, type EvolutionReport, ExecCtx, type ExecutorConfig, ExecutorFactory, ExecutorRegistry, FanoutOptions, FanoutWinnerSelector, FileCorpus, FileResultBlobStore, FileSpawnJournal, type ForkCapableBox, type GitWorkspaceOptions, type HarvestCorpusOptions, type HarvestFailure, type HarvestReport, InMemoryCorpus, InMemoryResultBlobStore, InMemorySpawnJournal, type Inbox, type InboxMessage, type IntentAudit, Iteration, type LoopDispatchOptions, type LoopOptionsForDispatch, LoopResult, LoopShape, LoopTokenUsage, LoopUntilSpec, type McpEndpoint, type McpEnvironmentOptions, type NestedScopeSeam, NodeId, type Observation, type ObserveInput, type ObserveOptions, type OpenSandboxRunOptions, Outcome, PanelSpec, Persona, PipelineStage, type PromotionGateOptions, type PromotionVerdict, type RegistryAnalyzeProjection, RenderCorpusToInstructionsOptions, type ReservationTicket, ResultBlobStore, RootHandle, RouterConfig, type RouterSeam, type RouterToolsSeam, type RunAgenticOptions, RunLoopOptions, RunPersonifiedOptions, type SandboxCapabilities, SandboxClient, type SandboxLineage, type SandboxLineageHandle, type SandboxRun, type SandboxSeam, Scope, ScopeAnalyst, ScopeAnalyzeInput, ScopeWidenGate, type SessionCapableBox, type SessionMessageLike, type SessionTraceBox, Settled, ShapeRegistry, type Shell, type ShotPersona, type ShotSpec, SpawnEvent, SpawnJournal, Spend, SteerContext, type Strategy, type StrategyCtx, type StrategyEvolutionConfig, type StrategyResult, SupervisedResult, Supervisor, type SurfaceScore, type ToolPartDecoder, ToolSpec, type ToolStepInput, type TraceSource, type TrajectoryAnalysis, TrajectoryReport, TrajectoryReportOptions, TreeView, type TurnResult, UsageEvent, type UsageSink, type VerifierEnvironmentOptions, VerifySpec, type WatchTraceOptions, type WaterfallCollector, type WaterfallReport, type WaterfallSpan, WidenSpec, WinnerStrategy, type Workspace, type WorkspaceCommit, type WorkspaceRun, acquireSandbox, adaptiveRefine, analyzeTrace, anytimeReport, asAuthoredProfile, assertStrategyContract, assertTraceDerivedFindings, auditIntent, authorStrategy, authoredWorker, breadthDriver, buildSteerContext, builtinShapes, cliWorktreeExecutor, completionAuthorizes, contentAddress, coordinationDriverAgent, createBudgetPool, createExecutor, createExecutorRegistry, createInbox, createMcpEnvironment, createPartsTraceSource, createPushTraceSource, createRootHandle, createSandboxLineage, createScope, createScopeAnalyst, createShapeRegistry, createSupervisor, createVerifierEnvironment, createWaterfallCollector, decodeAnthropicPart, decodeOpenAiPart, decodeOpencodePart, decodeToolPart, defaultAnalystInstruction, defaultAuditorInstruction, defaultToolDetectors, definePersona, defineStrategy, depthDriver, deterministicCompletion, discriminatingMeans, driverChild, driverExecutorFactory, driverRuntime, equalKOnCost, extractLlmCallEvent, fanout, flatWidenGate, 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, sandboxSessionTraceSource, selectChampion, selectValidWinner, sentinelCompletion, serveCoordinationMcp, settledToIteration, spendFromUsageEvents, stopSentinel, strategyAuthorContract, supervisorSkill, toToolSpan, toolPartDecoders, trajectoryReport, verify, watchTrace, widen, withDriverExecutor };
+export { Agent, AgentRunSpec, AgentSpec, type AgenticOptions, type AgenticRunResult, type AgenticSurface, type AgenticTask, type AgenticTool, type AnytimeReport, type AnytimeStrategySummary, type AnytimeTaskCurve, 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, type BridgeSeam, Budget, type BudgetPool, type BudgetReadout, type ChampionPick, type ChampionPolicy, type CheckpointCapableBox, type CliSeam, type CliWorktreeSeam, CombinatorShape, type CompletionAnalyst, type CompletionEvidence, type CompletionPolicy, type CompletionVerdict, type CoordinationDriverOptions, type CoordinationMcpHandle, Corpus, CorpusFilter, CorpusRecord, type CreateScopeAnalystOptions, type CriuCapableClient, DefinePersonaInput, type Deliverable, DeliverableSpec, type DriverChat, type DriverMessage, type DriverToolCall, type DriverTurn, type Environment, EqualKArm, EqualKOnCostOptions, EqualKVerdict, type EvolutionArchiveNode, type EvolutionAuthor, type EvolutionBandInfo, type EvolutionCandidate, type EvolutionGeneration, type EvolutionReport, ExecCtx, type ExecutorConfig, ExecutorFactory, ExecutorRegistry, FanoutOptions, FanoutWinnerSelector, FileCorpus, FileResultBlobStore, FileSpawnJournal, type ForkCapableBox, type GitWorkspaceOptions, type HarvestCorpusOptions, type HarvestFailure, type HarvestReport, InMemoryCorpus, InMemoryResultBlobStore, type InMemoryRunContext, type InMemoryRunContextOptions, InMemorySpawnJournal, type Inbox, type InboxMessage, type IntentAudit, Iteration, type LoopDispatchOptions, type LoopOptionsForDispatch, LoopResult, LoopShape, LoopTokenUsage, LoopUntilSpec, type McpEndpoint, type McpEnvironmentOptions, type NestedScopeSeam, NodeId, type Observation, type ObserveInput, type ObserveOptions, type OpenSandboxRunOptions, Outcome, PanelSpec, Persona, PipelineStage, type PromotionGateOptions, type PromotionVerdict, type RegistryAnalyzeProjection, RenderCorpusToInstructionsOptions, type ReservationTicket, ResultBlobStore, RootHandle, RouterConfig, type RouterSeam, type RouterToolsSeam, type RunAgenticOptions, RunLoopOptions, RunPersonifiedOptions, type SandboxCapabilities, SandboxClient, type SandboxLineage, type SandboxLineageHandle, type SandboxRun, type SandboxSeam, Scope, ScopeAnalyst, ScopeAnalyzeInput, ScopeWidenGate, type SessionCapableBox, type SessionMessageLike, type SessionTraceBox, Settled, ShapeRegistry, type Shell, type ShotPersona, type ShotSpec, SpawnEvent, SpawnJournal, Spend, SteerContext, type Strategy, type StrategyCtx, type StrategyEvolutionConfig, type StrategyResult, SupervisedResult, Supervisor, type SurfaceScore, type ToolPartDecoder, ToolSpec, type ToolStepInput, type TraceSource, type TrajectoryAnalysis, TrajectoryReport, TrajectoryReportOptions, TreeView, type TurnResult, UsageEvent, type UsageSink, type VerifierEnvironmentOptions, VerifySpec, type WatchTraceOptions, type WaterfallCollector, type WaterfallReport, type WaterfallSpan, WidenSpec, WinnerStrategy, type Workspace, type WorkspaceCommit, type WorkspaceRun, acquireSandbox, adaptiveRefine, analyzeTrace, anytimeReport, asAuthoredProfile, assertStrategyContract, assertTraceDerivedFindings, auditIntent, authorStrategy, authoredWorker, breadthDriver, buildSteerContext, builtinShapes, cliWorktreeExecutor, completionAuthorizes, contentAddress, coordinationDriverAgent, createBudgetPool, createExecutor, createExecutorRegistry, createInMemoryRunContext, createInbox, createMcpEnvironment, createPartsTraceSource, createPushTraceSource, createRootHandle, createSandboxLineage, createScope, createScopeAnalyst, createShapeRegistry, createSupervisor, createVerifierEnvironment, createWaterfallCollector, decodeAnthropicPart, decodeOpenAiPart, decodeOpencodePart, decodeToolPart, defaultAnalystInstruction, defaultAuditorInstruction, defaultToolDetectors, definePersona, defineStrategy, depthDriver, deterministicCompletion, discriminatingMeans, driverChild, driverExecutorFactory, driverRuntime, equalKOnCost, extractLlmCallEvent, fanout, flatWidenGate, 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, sandboxSessionTraceSource, selectChampion, selectValidWinner, sentinelCompletion, serveCoordinationMcp, settledToIteration, spendFromUsageEvents, stopSentinel, strategyAuthorContract, supervisorSkill, toToolSpan, toolPartDecoders, trajectoryReport, verify, watchTrace, widen, withDriverExecutor };

package/dist/runtime.js

@@ -27,6 +27,7 @@ import {
   createEventBus,
   createExecutor,
   createExecutorRegistry,
+  createInMemoryRunContext,
   createInbox,
   createMcpEnvironment,
   createPartsTraceSource,
@@ -122,7 +123,7 @@ import {
   widen,
   withDriverExecutor,
   worktreeFanout
-} from "./chunk-MT4XM3G6.js";
+} from "./chunk-VKUHUFX7.js";
 import "./chunk-WIR4HOOJ.js";
 import {
   extractLlmCallEvent,
@@ -160,6 +161,7 @@ export {
   createEventBus,
   createExecutor,
   createExecutorRegistry,
+  createInMemoryRunContext,
   createInbox,
   createMcpEnvironment,
   createPartsTraceSource,

package/dist/workflow.js

@@ -2,7 +2,7 @@ import {
   createSandboxForSpec,
   describeSandboxPlacement,
   runLoop
-} from "./chunk-MT4XM3G6.js";
+} from "./chunk-VKUHUFX7.js";
 import "./chunk-WIR4HOOJ.js";
 import {
   ValidationError,

package/package.json

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

package/skills/build-with-agent-runtime/SKILL.md

@@ -48,6 +48,18 @@ disagrees with source, the **source is right** — fix the map in the *same turn
 Read the cited `docs/canonical-api.md` row before writing; it carries the live
 signature + the exact "do NOT build".
 
+**The §1.5 law, inline:** an agent IS its full authored `AgentProfile`
+(prompt+skills+tools+mcp+subagents+hooks); you change behavior by AUTHORING the
+profile and letting the substrate materialize it into harness shapes —
+self-verification, iteration, and audit are profile levers (hooks/skills/
+subagents), never glue code.
+
+`AgentProfile` is now owned by `@tangle-network/agent-interface` (the `/runtime`
+barrel still re-exports the sandbox alias for back-compat), which also owns
+`HarnessType` + `ReasoningEffort` and a capability layer
+(`harnessSupportsModel` / `reasoningEffortsFor`) — so harness/model/reasoning
+compatibility is a queryable contract, not an assumption.
+
 | Altitude — I want to… | Use | Source |
 |---|---|---|
 | **Define a genome** (who the agent is + what it can do, ONE surface) | `AgentProfile` (runnable) / `AgentSurfaces` (the editable-coordinate map) — `/runtime`, `/agent` | canonical-api §3.2 |
@@ -61,6 +73,7 @@ signature + the exact "do NOT build".
 | **Add a stateful tool-using domain** | implement `AgenticSurface` (5 hooks) — `/loops` | canonical-api §3.3 |
 | **Benchmark: compare strategies + significance + Pareto on a domain** | `runBenchmark({ environment, tasks, worker, strategies })` — `/loops` | canonical-api §3.3 |
 | **Benchmark: add/run an external benchmark from the harness** | `ADAPTERS`/`resolveAdapter(key)` + a bench gate (`*-gate.mts`) over `openSandboxRun` + `sandboxAgentRun` (`bench/src/sandbox-run.ts`) | canonical-api §3.3 |
+| **Spawn N coding agents on isolated git worktrees, keep the one whose patch passes checks** | `worktreeFanout` + `createWorktreeCliExecutor` + `gateOnDeliverable(DeliverableSpec)` over a raw `WorktreePatchArtifact`, winner via `selectValidWinner` — `/runtime` — NOT a hand-rolled spawn-loop / "coder" role | canonical-api §3.1 / §5 |
 | **Sandbox coding rollout** (fresh box/round, or persistent+resume) | `runLoop(options)` / `openSandboxRun(client, opts, deliverable)` — `/runtime` | canonical-api §3.1 |
 | **Optimize a CODE surface** in a gated loop | `improvementDriver({ worktree, generator })` — `/improvement` | canonical-api §3.4 |
 | **Optimize a PROMPT/config surface** (one call) | `selfImprove({ agent, scenarios, judge, baselineSurface })` — `agent-eval/contract` | canonical-api §3.4 |
@@ -87,6 +100,10 @@ holds the load-bearing invariant the parallel breaks:
   `AgentProfile` (it IS that bundle) + `definePersona` (the run record);
   `sandboxAgentRun({ profile })` is the box seam — never pass a router key into
   the box.
+- "drive N coding agents in worktrees + pick the passing patch" / a "coder" role
+  **≈** `worktreeFanout` + `gateOnDeliverable` (each on its own worktree-CLI leaf,
+  settled ⟺ delivered, winner via `selectValidWinner` — a hand-rolled spawn-loop
+  skips the deliverable gate and the valid-only selection).
 - `new Sandbox()` + acquire + stream + `box.fs.read` + delete **≈**
   `openSandboxRun` (persistent + resume) or `runLoop` (fresh box/round).
 - `Promise.all` over N calls + manual argmax/merge **≈** `fanout` (bypassing the