@tangle-network/agent-runtime 0.198.2 → 0.200.0

package/dist/{stream-agent-turn-CLOQr497.d.ts → stream-agent-turn-CJWthifS.d.ts}

@@ -1116,6 +1116,8 @@ interface Executor<Out> {
    * `signal` is the spawn-scoped abort (chains the acquire lifecycle for sandbox).
    */
   execute(task: unknown, signal: AbortSignal): Promise<ExecutorResult<Out>> | AsyncIterable<UsageEvent>;
+  /** Reattach the exact journaled execution. This must never start replacement work. */
+  recover?(task: unknown, signal: AbortSignal): Promise<ExecutorResult<Out>> | AsyncIterable<UsageEvent>;
   /**
    * Optional inbox: receive an out-of-band message from the driver mid-run (the `send`/`steer_agent`
    * verb). A streaming executor drains pending messages between turns and folds them into the next
@@ -1962,8 +1964,10 @@ interface Scope<Out> {
    * but redundant. The scope's spawn ordinal + cursor seq are already advanced past the recorded
    * maxima, so any NEW spawn appends without colliding with a journaled event.
    *
-   * @experimental Same-process replay only — live supervised-tree recovery after a
-   * coordinator restart is not implemented (docs/agent-managed-compute/README.md).
+   * Retained provider children can reconcile their original execution through `recoverExecutor`.
+   * Missing recovery evidence leaves keyed work in doubt.
+   * Local ownership does not provide distributed fencing.
+   * @experimental
    */
   readonly resume?: ResumedWork<Out>;
   /** The live tree — reads the in-memory nursery, not the journal. */
@@ -2113,6 +2117,29 @@ type SpawnEvent = {
   profileRef?: string;
   seq: number;
   at: string;
+} | {
+  /** Exact task bytes durable before admitting a retained invocation. */
+  kind: 'execution-input';
+  id: NodeId;
+  taskRef: string;
+  seq: number;
+  at: string;
+} | {
+  /** Credential-free retained-provider admission, committed before the next external effect. */
+  kind: 'execution-admitted';
+  id: NodeId;
+  admission: RetainedRunAdmission;
+  seq: number;
+  at: string;
+} | {
+  /** Recoverable output committed before releasing its provider environment. */
+  kind: 'execution-result';
+  id: NodeId;
+  outRef: string;
+  spent: Spend;
+  verdict?: DefaultVerdict;
+  seq: number;
+  at: string;
 } | {
   /** Volatile transport/session binding for exactly one attempt. The full binding is retained
    * only by digest; descriptor fields are safe structural labels, never credential-bearing URLs. */
@@ -2357,6 +2384,8 @@ interface SupervisorOpts {
   readonly blobs: ResultBlobStore;
   /** Executor resolution — the open registry mapping `AgentSpec` → `Executor`. */
   readonly executors: ExecutorRegistry;
+  /** Reconstruct configured executors for interrupted children before resuming the driver. */
+  readonly recoverExecutor?: ExecutorFactory<unknown>;
   /** Predicate resolution for `poll` wait-states (`Scope.wait`). A `poll` names its predicate so
    *  the wait can be journaled and re-armed by a later process; this is what the name resolves
    *  against. Unset ⇒ `poll` waits are refused (`unknown-probe`); `timer` waits are unaffected. */
@@ -2381,17 +2410,15 @@ interface SupervisorOpts {
    */
   readonly childSettleGraceMs?: number | null;
   /**
-   * Opt into RESUME-FIRST: read any prior journal tree for this `runId` BEFORE beginning a fresh
-   * one, and when a non-empty tree exists rehydrate its committed work onto `Scope.resume`
-   * (`replaySpawnTree` + `materializeTreeView`) instead of starting over. Requires a journal +
-   * blob store that OUTLIVE the process (`createFileRunContext(dir)`); against the in-memory
-   * stores there is never a prior tree, so it is a no-op.
-   *
-   * Default `false` — a run always begins a fresh tree, which is the behavior every existing
-   * consumer has. Resume is a durability contract the caller opts into, never a silent default.
+   * Load prior journal state and expose committed settlements through `Scope.resume`.
+   * Use persistent journal and blob stores to recover across process restarts.
+   * `createFileRunContext` provides the file-backed stores and local ownership lock.
    *
-   * @experimental Rehydrates committed settlements only; live supervised-tree recovery after a
-   * coordinator restart is not implemented (docs/agent-managed-compute/README.md).
+   * Default `false` refuses an existing run ID instead of replacing its journal.
+   * Configure `recoverExecutor` to reconcile retained children before new work is admitted.
+   * Unresolved keyed work remains in doubt.
+   * The file run lock provides local ownership, without distributed fencing.
+   * @experimental
    */
   readonly resume?: boolean;
   readonly now?: () => number;
@@ -3630,6 +3657,8 @@ interface SandboxClientProviderOptions {
   validateProfile?: (profile: AgentProfileRef) => AgentProfileValidationResult | Promise<AgentProfileValidationResult>;
   /** Resolve a named profile before calling Sandbox, which accepts inline profiles only. */
   resolveProfile?: (profileId: string) => AgentProfile | Promise<AgentProfile>;
+  /** Map portable creation into a supported SDK or deployment contract. Runtime attachments
+   * require this explicit mapper until the maintained Sandbox SDK transports them. */
   mapCreateInput?: (input: CreateAgentEnvironmentInput) => CreateSandboxOptions;
 }
 /**
@@ -4601,4 +4630,4 @@ declare function streamAgentTurn(backend: AgentTurnBackend, input: AgentTurnInpu
 declare function collectAgentTurn(stream: AsyncIterable<RuntimeStreamEvent>): Promise<CollectedAgentTurn>;
 //#endregion
 export { resolveSecretEnv as $, RetainedRunEnvironmentAdmission as $a, sanitizeAgentRuntimeEvent as $i, defaultRedactor as $n, SupervisorOpts as $r, WorktreeHarnessResult as $t, Inbox as A, RecoverRetainedInteractiveRunOptions as Aa, OtelExporter as Ai, AUTHORITY_MARKERS as An, ProviderModelAttemptEvidence as Ar, providerAsExecutor as At, createSandboxToolPartState as B, RecoverRetainedRunIntentOptions as Ba, loopEventToOtelSpan as Bi, PeerMailSendInput as Bn, Scope as Br, CodexRolloutStoreReader as Bt, createExecutorRegistry as C, DEFAULT_STALL_AFTER_MS as Ca, EvalRunGeneration as Ci, ToolSpec as Cn, MaterializedModelIdentity as Cr, ProviderExecutorOptions as Ct, SteerableSandboxSession as D, createActivityLog as Da, LoopSpanNode as Di, ToolLoopCompactionOptions as Dn, NodeSnapshot as Dr, SandboxClientProviderOptions as Dt, SteerableSandboxArgs as E, WorkerProgress as Ea, INTELLIGENCE_WIRE_VERSION as Ei, ToolLoopCompaction as En, NodeId as Er, ResourceRequest as Et, SandboxOutputMarker as F, StartRetainedInteractiveRunOptions as Fa, buildRuntimeEventOtelSpans as Fi, PeerMailKind as Fn, RootHandle as Fr, SandboxControlClient as Ft, sandboxEventServedBackend as G, RetainedInteractiveIntentAdmission as Ga, RuntimeStreamEventCollector as Gi, isPeerMailEnvelope as Gn, SpawnPrior as Gr, createCodexRolloutStoreReader as Gt, extractLlmCallEvent as H, RecoverRetainedRunResult as Ha, padTraceId as Hi, PeerMailboxOptions as Hn, SpawnEvent as Hr, CodexRolloutTurn as Ht, SandboxServedBackend as I, NativeContextContinuationExecution as Ia, createOpenInferenceFileExporter as Ii, PeerMailLimits as In, RootMaterialization as Ir, createTangleSandboxExactProcessProvider as It, KeyProvider as J, RetainedRunAdmissionHook as Ja, RuntimeTelemetryOptions as Ji, JsonRpcMessage as Jn, SpendChannel as Jr, HarnessUsage as Jt, sandboxProgressEvents as K, RetainedInteractiveStartedAdmission as Ka, RuntimeStreamEventSink as Ki, peerMailTools as Kn, SpawnRejection as Kr, harnessUsageIsEmpty as Kt, SandboxToolPartState as L, NativeContextContinuationHandle as La, createOtelExporter as Li, PeerMailOutcome as Ln, RootProviderModelEvidence as Lr, CodexForkBoundary as Lt, PeerInboxMessage as M, RetainedInteractiveEnvironmentInput as Ma, RuntimeEventOtelOptions as Mi, PEER_MAIL_WIRE_KEY as Mn, ResultBlobStore as Mr, resolveAgentEnvironmentProvider as Mt, createInbox as N, RetainedInteractiveRunHandle as Na, buildLoopOtelSpans as Ni, PeerMailEnvelope as Nn, ResumedKeyState as Nr, sandboxClientAsProvider as Nt, createSteerableSandboxSession as O, readWorkerProgress as Oa, OtelAttribute as Oi, ToolLoopMessageRecord as On, NodeStatus as Or, WorkspaceRequest as Ot, SandboxLeafOut as P, RetainedInteractiveStartMaterial as Pa, buildLoopSpanNodes as Pi, PeerMailEvent as Pn, ResumedWork as Pr, CreateTangleSandboxExactProcessProviderOptions as Pt, resolveMcpServerLaunch as Q, RetainedRunEffect as Qa, createRuntimeStreamEventCollector as Qi, Redactor as Qn, Supervisor as Qr, WorktreeCommandResult as Qt, SandboxUsageLedger as R, NativeContextContinuationInput as Ra, exportEvalRuns as Ri, PeerMailReadout as Rn, RootSignal as Rr, CodexRolloutIdentity as Rt, createExecutor as S, ActivityNote as Sa, EvalRunEvent as Si, RouterTransportConfig as Sn, MaterializedExecutionIdentity as Sr, ProviderAsSandboxClientOptions as St, SandboxSteeringOptions as T, ScopeProgressInput as Ta, EvalRunsExportResult as Ti, ToolLoopChat as Tn, NodeExecutionIdentity as Tr, ProviderPromptOptions as Tt, mapSandboxEvent as U, RetainedInteractiveAdmission as Ua, toOtelAttributes as Ui, claimsAuthority as Un, SpawnJournal as Ur, CodexStoreDelta as Ut, createSandboxUsageLedger as V, RecoverRetainedRunOptions as Va, padSpanId as Vi, PeerMailbox as Vn, Settled as Vr, CodexRolloutStoreRef as Vt, mapSandboxToolEvent as W, RetainedInteractiveEnvironmentAdmission as Wa, RuntimeEventCollector as Wi, createPeerMailbox as Wn, SpawnOpts as Wr, addHarnessUsage as Wt, envKeyProvider as X, RetainedRunCancellation as Xa, SanitizedKnowledgeRequirement as Xi, McpToolDescriptor as Xn, SteerableRootHandle as Xr, InPlaceHarnessResult as Xt, ResolvedMcpServerLaunch as Y, RetainedRunCancelOptions as Ya, SanitizedKnowledgeReadinessReport as Yi, JsonRpcResponse as Yn, SpendGap as Yr, decodeHarnessUsage as Yt, mcpSecretEnvMetadataKey as Z, RetainedRunDispatchedAdmission as Za, createRuntimeEventCollector as Zi, McpTransport as Zn, SupervisedResult as Zr, WorktreeCheckRunner as Zt, RouterSeam as _, TraceSource as _a, TraceContext as _i, RunLocalHarnessOptions as _n, ExecutorRegistry as _r, CreateAgentEnvironmentInput$1 as _t, StreamAgentTurnOptions as a, WaitProbeRegistry as aa, WaitOpts as ai, RemoveWorktreeOptions as an, RetainedRunStartMaterial as ao, DefaultVerdict as ar, AgentEnvironmentProviderRef as at, cliInPlaceExecutor as b, sandboxSessionTraceSource as ba, readTraceContextFromEnv as bi, parseCodexTokenUsage as bn, ExecutorToolCall as br, ForkRequest as bt, BridgeHarnessStore as c, createWaitProbes as ca, WorkerInteractiveUnavailableReason as ci, createWorktree as cn, StartRetainedRunOptions as co, ExecutorAccounting as cr, AgentEnvironmentStatus as ct, CliInPlaceSeam as d, timerAt as da, WorkerTraceResolver as di, CodexExecutionPolicy as dn, ExecutorContext as dr, AgentSession as dt, sanitizeKnowledgeReadinessReport as ea, TokenUsageProvenance as ei, WorktreeProfileMaterializationReceipt as en, RetainedRunEventOptions as eo, resolveRedactor as er, secretEnvOfMcpServer as et, CliSeam as f, validateWaitSpec as fa, WorkerTraceSeamCarrier as fi, CodexTokenUsage as fn, ExecutorExecutionBinding as fr, AgentSessionRef as ft, ProviderSeam as g, ToolStepInput as ga, workerTraceSeamKey as gi, LocalHarnessResult as gn, ExecutorProgressEvent as gr, CheckpointRequest as gt, ExecutorConfig as h, SessionTraceBox as ha, workerTraceHeaders as hi, LocalHarness as hn, ExecutorNodeContext as hr, CheckpointRef as ht, CollectedAgentTurn as i, WaitProbe as ia, UsageEvent as ii, GitRunner as in, RetainedRunSnapshot as io, Budget as ir, AgentEnvironmentProvider$1 as it, InboxMessage as j, RetainedInteractiveAdmissionHook as ja, OtelSpan as ji, DEFAULT_PEER_MAIL_LIMITS as jn, ProviderModelExecutionEvidence as jr, providerAsSandboxClient as jt, AuthorityInboxMessage as k, ReconnectRetainedInteractiveRunOptions as ka, OtelExportConfig as ki, ToolLoopToolCall as kn, ProfileMaterializationReceipt as kr, createAgentEnvironmentProviderRegistry as kt, BridgeModelCredential as l, isWaitOutcome as la, WorkerTraceEvidence as li, removeWorktree as ln, ExecutorCancellation as lr, AgentEnvironmentSummary as lt, CliWorktreeSeam as m, SessionMessageLike as ma, workerTraceEnv as mi, LOCAL_HARNESSES as mn, ExecutorMaterialization as mr, AgentTurnResult$1 as mt, AgentTurnInput$1 as n, PendingWait as na, UnconfirmedTeardown as ni, DiffOptions as nn, RetainedRunIntentAdmission as no, AgentExecutionRef as nr, AgentEnvironmentCapabilities$1 as nt, collectAgentTurn as o, WaitRejection as oa, WidenGate as oi, WorktreeHandle as on, RetainedRunTurnInput as oo, ExecutionBindingReceipt as or, AgentEnvironmentProviderRegistry as ot, CliWorktreeBridgeSeam as p, waitUntil as pa, readWorkerTraceContext as pi, DEFAULT_LOCAL_HARNESS as pn, ExecutorFactory as pr, AgentSessionStatus$1 as pt, sumSandboxUsage as q, RetainedRunAdmission as qa, RuntimeStreamEventSummary as qi, peerMailVerbNames as qn, Spend as qr, readCodexRolloutSession as qt, AgentTurnUsage as r, WaitOutcome as ra, UnknownMaterializationReason as ri, DiffResult as rn, RetainedRunReplayPoint as ro, AgentSpec as rr, AgentEnvironmentEvent$1 as rt, streamAgentTurn as s, WaitSpec as sa, WorkerInteractiveSession as si, captureWorktreeDiff as sn, StartRetainedRunInEnvironmentOptions as so, Executor as sr, AgentEnvironmentQuery as st, AgentTurnBackend as t, sanitizeRuntimeStreamEvent as ta, TreeView as ti, CreateWorktreeOptions as tn, RetainedRunHandle as to, Agent as tr, AgentEnvironment$1 as tt, BridgeSeam as u, pollFor as ua, WorkerTraceUnavailableReason as ui, CodexExecutionEvidence as un, ExecutorCancellationRequest as ur, AgentProfileRef$1 as ut, RouterToolsSeam as v, createPushTraceSource as va, createPropagatingTraceEmitter as vi, harnessSupportsReasoningEffort as vn, ExecutorResult as vr, ExecRequest as vt, DEFAULT_SANDBOX_STEERING_MAX_TURNS as w, ExecutorProgress as wa, EvalRunsExportConfig as wi, ToolLoopCallContext as wn, NoWinnerError as wr, ProviderLeafOut as wt, cliWorktreeExecutor as x, ActivityLog as xa, traceContextToEnv as xi, runLocalHarness as xn, Handle as xr, PlacementInfo as xt, SandboxSeam as y, decodeToolPart as ya, mergeTraceEnv as yi, localHarnessExecutable as yn, ExecutorTeardownWarning as yr, ExecResult as yt, assertSandboxServedModel as z, ReconnectRetainedRunOptions as za, generateSpanId as zi, PeerMailRefusal as zn, Runtime as zr, CodexRolloutSession as zt };
-//# sourceMappingURL=stream-agent-turn-CLOQr497.d.ts.map
+//# sourceMappingURL=stream-agent-turn-CJWthifS.d.ts.map

package/dist/{structural-rollout-BmDuXyR9.js → structural-rollout-BcMmrpv4.js}

@@ -1,6 +1,5 @@
-import { $r as executableAgentProfileSnapshot, Br as knownExecutionBindingReceipt, Kr as runtimeOwnedExecutorExecutionBinding, Lr as authoredProfileDigest, Qr as unknownMaterializationReceipt, Rt as InMemoryResultBlobStore, Vr as knownMaterializationReceipt, Yr as runtimeOwnedPendingExecutorMaterialization, Zr as unknownExecutionBindingReceipt, a as createSupervisor, ci as promptOptionsFromAgentTurnInput, f as withDriverExecutor, ii as readSandboxOutcome, li as providerMessageText, oi as awaitAbortable, ot as createExecutor, qr as runtimeOwnedExecutorMaterialization, ri as projectSandboxOutcome, rt as captureReusableExecutorConfig, si as promptFromAgentTurnInput, st as createExecutorRegistry, un as observedModelMatchesDeclared, zt as InMemorySpawnJournal } from "./redact-DqfB7oB4.js";
+import { Ai as promptFromAgentTurnInput, Mi as providerMessageText, Rt as InMemoryResultBlobStore, Si as mapSandboxToolEvent, Xr as knownExecutionBindingReceipt, Zr as knownMaterializationReceipt, _i as createSandboxToolPartState, a as createSupervisor, ai as runtimeOwnedPendingExecutorMaterialization, bi as isSandboxTerminalEvent, ci as unknownMaterializationReceipt, gi as canonicalStreamEventFromSandboxEvent, ji as promptOptionsFromAgentTurnInput, ki as awaitAbortable, li as executableAgentProfileSnapshot, m as withDriverExecutor, mi as readSandboxOutcome, ni as runtimeOwnedExecutorExecutionBinding, ot as createExecutor, pi as projectSandboxOutcome, pn as observedModelMatchesDeclared, qr as authoredProfileDigest, ri as runtimeOwnedExecutorMaterialization, rt as captureReusableExecutorConfig, si as unknownExecutionBindingReceipt, st as createExecutorRegistry, vi as createSandboxUsageLedger, xi as mapSandboxEvent, zt as InMemorySpawnJournal } from "./redact-h-oaw11Q.js";
 import { m as ValidationError, p as SessionMismatchError, r as BackendTransportError } from "./errors-DodWX-cb.js";
-import { c as mapSandboxToolEvent, i as createSandboxUsageLedger, n as canonicalStreamEventFromSandboxEvent, o as isSandboxTerminalEvent, r as createSandboxToolPartState, s as mapSandboxEvent } from "./sandbox-events-DbC2WKKS.js";
 import { c as profileModelExecutionSettings, i as concreteModelId, l as profileProviderModel, o as enforceTokenLimits, s as profileBridgeWireModel, t as assertExecutableAgentProfile } from "./model-policy-DKDyr-fc.js";
 import { agentProfileSchema, canonicalAgentProfileDigest, canonicalCandidateDigest, renderInputPartsAsText } from "@tangle-network/agent-interface";
 import { costForTokenPricing, makeProposalFinding, scoreKnowledgeReadiness } from "@tangle-network/agent-eval";
@@ -2806,4 +2805,4 @@ function structuralRollout(config = {}) {
 //#endregion
 export { streamAgentTurn as A, observe as C, optimizerMethod as D, profileOptimizerModelCall as E, newRuntimeSession as F, nowIso as I, startOrResumeRuntimeSession as L, createSandboxPromptBackend as M, normalizeBackendStreamEvent as N, strategyAuthorMethod as O, InMemoryRuntimeSessionStore as P, touchSession as R, defaultAnalystInstruction as S, profileChatClient as T, depthStrategy as _, defaultStructuralRolloutPolicy as a, sample as b, officialChecksFromMeta as c, selectBestIndex as d, structuralRollout as f, defineStrategy as g, breadthStrategy as h, defaultExtractCandidate as i, createIterableBackend as j, collectAgentTurn as k, resolveEntrySymbol as l, adaptiveRefine as m, compareCheckOutcomes as n, filterAuthoredAsserts as o, visibleCheckScore as p, composeCheckSources as r, modelAuthoredChecks as s, canDisplace as t, sandboxCheckRunner as u, refine as v, renderReport as w, sampleThenRefine as x, runAgentic as y };
 
-//# sourceMappingURL=structural-rollout-BmDuXyR9.js.map
+//# sourceMappingURL=structural-rollout-BcMmrpv4.js.map