@tangle-network/agent-runtime 0.330.0 → 0.331.0

package/dist/{supervisor-6t1YG2PP.js → supervisor-DJXryb1R.js}

@@ -1856,10 +1856,12 @@ const outsideKinds = /* @__PURE__ */ new Set([
 	"workspace-checkpoint-requested",
 	"workspace-checkpoint",
 	"workspace-checkpoint-fork-requested",
+	"workspace-checkpoint-fork-ready",
 	"workspace-checkpoint-fork-teardown",
 	"workspace-checkpoint-capture",
 	"workspace-checkpoint-cleanup",
 	"workspace-restored",
+	"workspace-capture-started",
 	"workspace-capture",
 	"trace-unpropagated",
 	"seat-segment",
@@ -1940,10 +1942,12 @@ async function replaySpawnTree(journal, blobs, root) {
 		if (ev.kind === "workspace-checkpoint-requested") continue;
 		if (ev.kind === "workspace-checkpoint") continue;
 		if (ev.kind === "workspace-checkpoint-fork-requested") continue;
+		if (ev.kind === "workspace-checkpoint-fork-ready") continue;
 		if (ev.kind === "workspace-checkpoint-fork-teardown") continue;
 		if (ev.kind === "workspace-checkpoint-capture") continue;
 		if (ev.kind === "workspace-checkpoint-cleanup") continue;
 		if (ev.kind === "workspace-restored") continue;
+		if (ev.kind === "workspace-capture-started") continue;
 		if (ev.kind === "workspace-capture") continue;
 		if (ev.kind === "trace-unpropagated") continue;
 		if (ev.kind === "seat-segment" || ev.kind === "seat-materialized" || ev.kind === "seat-paused") continue;
@@ -3698,16 +3702,28 @@ function executorEvidenceWriter(args) {
 		});
 	};
 }
-/** @internal The journal writer for `onWorkspaceCapture`; `nextSequence` is the node's own. */
+/** @internal The journal writers for `onWorkspaceCapture` and `onWorkspaceCaptureStarted`;
+*  `nextSequence` is the node's own. */
 function workspaceCaptureWriter(args) {
-	return async (capture) => {
-		await args.journal.appendEvent(args.rootId, {
-			kind: "workspace-capture",
-			id: args.nodeId,
-			...detachedSnapshot(capture, "workspace capture timing"),
-			seq: args.nextSequence(),
-			at: new Date(args.now()).toISOString()
-		});
+	return {
+		onWorkspaceCapture: async (capture) => {
+			await args.journal.appendEvent(args.rootId, {
+				kind: "workspace-capture",
+				id: args.nodeId,
+				...detachedSnapshot(capture, "workspace capture timing"),
+				seq: args.nextSequence(),
+				at: new Date(args.now()).toISOString()
+			});
+		},
+		onWorkspaceCaptureStarted: async (capture) => {
+			await args.journal.appendEvent(args.rootId, {
+				kind: "workspace-capture-started",
+				id: args.nodeId,
+				...detachedSnapshot(capture, "workspace capture start"),
+				seq: args.nextSequence(),
+				at: new Date(args.now()).toISOString()
+			});
+		}
 	};
 }
 function retainedExecutorContext(ctx) {
@@ -12059,6 +12075,11 @@ function sandboxSessionTraceSource(box, sessionId, opts = {}) {
 const WORKSPACE_CHECKPOINT_MARKER_PATH = ".agent-runtime-checkpoint";
 /** Bound on one checkpoint: environment lookup, marker write, and the provider operation. */
 const WORKSPACE_CHECKPOINT_TIMEOUT_MS = 12e4;
+/** Bound on the captures one checkpoint rotation runs, all of them together, forks included.
+*  A turn's own workspace capture also cuts them short when it starts. A capture cut short keeps
+*  its checkpoint, and the owner's release, bounded by `RELEASE_CHECKPOINT_CAPTURES_MS`, captures
+*  it again. */
+const WORKSPACE_CHECKPOINT_ROTATION_CAPTURES_MS = 2 * 6e4;
 /** Bound on creating and reconstructing the fork a checkpoint's capture reads: a Sandbox box
 *  created from a snapshot (measured 2026-09-24: 19 s). The capture itself is bounded by its port. */
 const WORKSPACE_CHECKPOINT_FORK_TIMEOUT_MS = 10 * 6e4;
@@ -12383,9 +12404,14 @@ function createProviderExecutor(provider, profile, ctx, options, placement) {
 			const reportTiming = retention?.onWorkspaceCapture;
 			let timing;
 			const capturedExecutionId = workspaceExecutionId;
+			const started = retention?.onWorkspaceCaptureStarted?.({
+				executionId: capturedExecutionId,
+				environmentId: next.id
+			}).catch(() => void 0) ?? Promise.resolve();
 			workspaceCapturePromise = Promise.all([nativeInFlight, liveInFlight]).then(() => captureProviderWorkspaceSnapshot(workspaceRetention, captureContext, "environment", reportTiming === void 0 ? void 0 : (measured) => {
 				timing = measured;
 			})).finally(async () => {
+				await started;
 				if (timing === void 0 || reportTiming === void 0) return;
 				await reportTiming({
 					executionId: capturedExecutionId,
@@ -25324,13 +25350,11 @@ function registerScopeRetainedOwner(scope, args) {
 				now: args.now,
 				traceRoots
 			}),
-			onWorkspaceCapture: workspaceCaptureWriter({
-				journal: args.journal,
-				rootId: args.rootId,
-				nodeId: args.nodeId,
-				nextSequence: () => state.nextSequence(),
-				now: args.now
-			}),
+			onWorkspaceCapture: (capture) => ownerCaptureWriter(state).onWorkspaceCapture(capture),
+			onWorkspaceCaptureStarted: (capture) => {
+				state.rotationCaptures?.abort(/* @__PURE__ */ new Error("the turn's workspace capture started first; checkpoint kept"));
+				return ownerCaptureWriter(state).onWorkspaceCaptureStarted(capture);
+			},
 			onEndOfTurnWork: (work) => {
 				const prior = state.turnEnd;
 				const settled = work.catch(() => void 0);
@@ -25678,7 +25702,33 @@ async function checkpointOwnerWorkspace(scope, state) {
 		at
 	});
 	const events = await args.journal.loadTree(args.rootId) ?? [];
-	await cleanCheckpoints(state, branching, pendingCheckpoints(events, state).filter((event) => event.environmentId === environment.id && state.captureRefused?.has(event.checkpoint.checkpointId) !== true).slice(0, -2), events, scope.signal);
+	const owned = pendingCheckpoints(events, state).filter((event) => event.environmentId === environment.id && state.captureRefused?.has(event.checkpoint.checkpointId) !== true);
+	const rotation = new AbortController();
+	state.rotationCaptures = rotation;
+	const timer = setTimeout(() => rotation.abort(/* @__PURE__ */ new Error(`the rotation's ${WORKSPACE_CHECKPOINT_ROTATION_CAPTURES_MS} ms for checkpoint captures ran out; checkpoint kept`)), WORKSPACE_CHECKPOINT_ROTATION_CAPTURES_MS);
+	try {
+		await cleanCheckpoints(state, branching, owned.slice(0, -2), events, AbortSignal.any([scope.signal, rotation.signal]));
+	} finally {
+		clearTimeout(timer);
+		if (state.rotationCaptures === rotation) delete state.rotationCaptures;
+	}
+}
+/**
+* The owner's workspace-capture journal writers. A turn's capture starting cuts short the
+* checkpoint rotation's captures: on Discovery canary test-acceptance-canary-20261019j (Runtime
+* 0.327.0) a rotation capture of an older checkpoint started 4 s before the root's final capture,
+* on the same evidence store, and the final capture spent 26.6 of its 32.6 minutes storing its
+* archive until the root's budget deadline aborted the rotation.
+*/
+function ownerCaptureWriter(state) {
+	const { args } = state;
+	return workspaceCaptureWriter({
+		journal: args.journal,
+		rootId: args.rootId,
+		nodeId: args.nodeId,
+		nextSequence: () => state.nextSequence(),
+		now: args.now
+	});
 }
 /** Reconstruct authority for this source only; a replacement cannot own its snapshots. */
 async function checkpointHandle(state, sourceEnvironmentId, signal) {
@@ -25911,6 +25961,19 @@ async function captureBeforeCleanup(state, branching, event, events, parent) {
 			const environment = await runAbortable(() => get(forkId), forkSignal, "checkpoint fork lookup timed out");
 			if (environment === null || environment.id !== forkId || environment.provider !== provider.name) throw new Error(`fork ${forkId} could not be reconstructed`);
 			parent?.throwIfAborted();
+			await args.journal.appendEvent(args.rootId, {
+				kind: "workspace-checkpoint-fork-ready",
+				id: args.nodeId,
+				provider: event.provider,
+				environmentId: event.environmentId,
+				checkpointId,
+				fork: {
+					idempotencyKey: request.idempotencyKey,
+					environmentId: forkId
+				},
+				seq: state.nextSequence(),
+				at: new Date(args.now()).toISOString()
+			});
 			return {
 				environment,
 				checkpoint: event.checkpoint,
@@ -27642,7 +27705,7 @@ function createScope(args) {
 				live.recoveryPending = false;
 			});
 			let captureSeq = 0;
-			const onWorkspaceCapture = workspaceCaptureWriter({
+			const { onWorkspaceCapture, onWorkspaceCaptureStarted } = workspaceCaptureWriter({
 				journal: args.journal,
 				rootId: args.root,
 				nodeId: id,
@@ -27679,6 +27742,7 @@ function createScope(args) {
 				}),
 				onPause,
 				onWorkspaceCapture,
+				onWorkspaceCaptureStarted,
 				continueInvocation: async (nextTask) => {
 					controller.signal.throwIfAborted();
 					if (live.acceptedResult === void 0) throw new ValidationError$1("scope: a retained child continues only after its invocation committed a result");
@@ -31877,4 +31941,4 @@ function isNonEmptySpend(s) {
 //#endregion
 export { SPAWN_RESOURCE_PATH_MAX_BYTES as $, FileSpawnJournal as $i, persistHarnessTranscript as $n, renderProfileMaterializationIssues as $r, AUTHORITY_MARKERS as $t, restoreScopeOwnerAcceptedExecution as A, awaitAbortable$1 as Ai, providerAsExecutor as An, runWorktreeHarness as Ar, verdictFromJudgeScore as At, bindScopeRetainedOwnerProvider as B, canonicalStreamEventFromSandboxEvent as Bi, startRetainedRun as Bn, CodexExecutionDiagnosticError as Br, createSteerableSandboxSession as Bt, deriveNodeExecutionIdentity as C, spendFromUsageTotals as Ca, unknownExecutionBindingReceipt as Ci, captureBeforeDestroy as Cn, toOtelAttributes as Cr, bestComposite as Ct, recordScopeOwnerDriverAttempt as D, promptFromAgentTurnInput as Da, projectSandboxOutcome as Di, runBrainLoop as Dn, sanitizeKnowledgeReadinessReport as Dr, expandQuestions as Dt, noteScopeOwnerPlannedExecution as E, resolveRedactor as Ea, executableAgentSpecSnapshot as Ei, routerBrain as En, sanitizeAgentRuntimeEvent as Er, distillFindings as Et, authoredSeatStages as F, unavailablePauseMs as Fi, sandboxSessionTraceSource as Fn, LOCAL_HARNESSES as Fr, createExecutor as Ft, reconcileScopeRetainedOwnerEnvironment as G, mapSandboxEvent as Gi, createWorkerSlots as Gn, controlProfileMaterialization as Gr, workerTraceEnv as Gt, noteScopeRetainedOwnerCoordination as H, createSandboxUsageLedger as Hi, retainedCreateMaterial as Hn, AGENT_PROFILE_MATERIALIZATION_AXES as Hr, createInPlaceCliExecutor as Ht, seatExecutionProfile as I, unavailableSignalOfFailure as Ii, bridgeRuntimeAttachmentsKey as In, harnessInvocation as Ir, createExecutorRegistry as It, scopeRetainedOwnerPriorSpend as J, sandboxEventServedBackend as Ji, abortError as Jn, profileMaterializationAxes$1 as Jr, taskToPrompt as Jt, scopeRetainedOwnerContext as K, mapSandboxToolEvent as Ki, openSlotGroup as Kn, defineProfileMaterializationContract as Kr, workerTraceHeaders as Kt, abandonScopeRetainedOwnerInvocation as L, TRACE_ROOT_SCHEMA as Li, bridgeStopSignalKey as Ln, harnessSupportsReasoningEffort as Lr, snapshotExecutorConfig as Lt, settledToIteration as M, settlementFailureCause as Mi, resolveAgentEnvironmentProvider as Mn, createWorktree as Mr, captureReusableExecutorConfig as Mt, SeatChain as N, registerRetainedExecutorPreparation as Ni, createPushTraceSource as Nn, removeWorktree as Nr, cliInPlaceExecutor as Nt, recordScopeOwnerMaterialization as O, promptOptionsFromAgentTurnInput as Oa, readSandboxOutcome as Oi, LEAF_CONTINUATION_TASK as On, sanitizeRuntimeStreamEvent as Or, failedItems as Ot, SeatChainExhaustedError as P, retainedExecutorSeamKey as Pi, decodeToolPart as Pn, DEFAULT_LOCAL_HARNESS as Pr, cliWorktreeExecutor as Pt, scopeRetainedOwnerTurnEnded as Q, FileResultBlobStore as Qi, harnessTranscriptArtifact as Qn, promptResourceProfileMaterialization as Qr, createInbox as Qt, beginScopeRetainedOwnerDrive as R, TRACE_SUMMARY_SCHEMA as Ri, reconnectRetainedRun as Rn, localHarnessExecutable as Rr, createWorktreeCliExecutor as Rt, createScope as S, spendFromUsageEvents as Sa, runtimeOwnedScopeOwnerRuntime as Si, SandboxEvidenceRetentionError as Sn, padTraceId as Sr, admitFinding as St, meterRuntimeOwnedProviderAttempt as T, defaultRedactorIdentityMaterial as Ta, executableAgentProfileSnapshot as Ti, readPromptOptions as Tn, createRuntimeStreamEventCollector as Tr, createContinuationKeeper as Tt, prepareScopeRetainedOwnerSeatSwitch as U, extractLlmCallEvent as Ui, destroyInteractiveEnvironment as Un, assertProfileMaterialization as Ur, WORKER_TRACE_PROPAGATION as Ut, consumeScopeRetainedOwnerResult as V, createSandboxToolPartState as Vi, startRetainedRunInEnvironment as Vn, terminateProcessTreeAndConfirm as Vr, createRouterTranscript as Vt, prepareScopeRetainedOwnerTask as W, isSandboxTerminalEvent as Wi, environmentGone as Wn, assertProfileMaterializes as Wr, readWorkerTraceContext as Wt, scopeRetainedOwnerRestorePoint as X, sumSandboxUsage as Xi, runAbortable as Xn, promptModelProfileMaterialization as Xr, createActivityLog as Xt, scopeRetainedOwnerResourceReader as Y, sandboxProgressEvents as Yi, linkAbort as Yn, promptControlProfileMaterialization as Yr, DEFAULT_STALL_AFTER_MS as Yt, scopeRetainedOwnerResult as Z, decodeHarnessUsage as Zi, captureHarnessTranscript as Zn, promptOnlyProfileMaterialization as Zr, readWorkerProgress as Zt, isDriverSpec as _, ReservationWaitRefused as _a, runtimeOwnedDriveHarnessProviderEvidence as _i, defaultSelectWinner as _n, createOtelExporter as _r, mapExecutorResult as _t, collectDelivered as a, replaySpawnTree as aa, worktreeCliProfileMaterialization as ai, peerMailTools as an, runCodeMode as ar, providerVisibleProfile as at, assertRecursiveReservationPolicy as b, meterUsageEvent as ba, runtimeOwnedExecutorProviderEvidence as bi, createSandboxLineage as bn, loopEventToOtelSpan as br, CheckUnavailableError as bt, runTree as c, isTraceAnalysisStore as ca, authoredAgentIdentity as ci, isTerminalNodeStatus as cn, ROUTER_PRICE_SOURCE as cr, attachWorker as ct, classifyDriverFailure as d, contentAddress as da, inheritRuntimeOwnedExecutorAttestation as di, addHarnessUsage as dn, readTraceContextFromEnv as dr, recoverRetainedInteractiveRun as dt, InMemoryResultBlobStore as ea, renderUnsupported as ei, DEFAULT_PEER_MAIL_LIMITS as en, readHarnessTranscript as er, environmentReader as et, runDriverWithRetry as f, detachedFrozen as fa, knownExecutionBindingReceipt as fi, createCodexRolloutStoreReader as fn, traceContextToEnv as fr, startRetainedInteractiveRun as ft, driverExecutorFactory as g, BudgetReconcileFault as ga, recordRuntimeOwnedDriveHarnessProviderEvidence as gi, createSandboxForSpec as gn, createOpenInferenceFileExporter as gr, gateOnDeliverable as gt, driverChild as h, errMessage as ha, providerAttemptEvidence as hi, TERMINAL_DECISIONS as hn, buildRuntimeEventOtelSpans as hr, rollingDispatch as ht, bestDelivered as i, materializeTreeView as ia, validateProfileMaterialization as ii, isPeerMailEnvelope as in, describeCodeModeTools as ir, coordinationProfileToolPrefix as it, scopeOwnerExecutorNodeContext as j, runtimeFailureCause as ji, providerAsSandboxClient as jn, captureWorktreeDiff as jr, bindReusableExecutorExecutionId as jt, recordScopeOwnerPause as k, providerMessageText as ka, abortError$1 as ki, createAgentEnvironmentProviderRegistry as kn, runSettledCommand as kr, passedItems as kt, DriverAttemptsExhaustedError as l, parseWorkerToolTraceArtifact as la, authoredProfileDigest as li, bridgeAdmissionRefusal as ln, createPropagatingTraceEmitter as lr, readWorkerInteractiveBinding as lt, upstreamUnavailableSignal as m, executorFailure as ma, newExecutionAttemptId as mi, readCodexRolloutSession as mn, buildLoopSpanNodes as mr, queueOf as mt, createRootHandle as n, insideCursorNamespace as na, sandboxProfileMaterialization as ni, claimsAuthority as nn, retainHarnessTranscript as nr, resolveSpawnResourcePaths as nt, pickBestDelivered as o, WORKER_TOOL_TRACE_SCHEMA_VERSION as oa, attestRuntimeOwnedPendingExecutor as oi, peerMailVerbNames as on, priceTokens as or, runtimeGraphMetadataKey as ot, summarizeDriverAttempts as p, detachedSnapshot as pa, knownMaterializationReceipt as pi, harnessUsageIsEmpty as pn, buildLoopOtelSpans as pr, freeSlots as pt, scopeRetainedOwnerJournalRoot as q, notifySandboxEventObserver as qi, RunCancellationReason as qn, fullProfileMaterialization as qr, workerTraceSeamKey as qt, createSupervisor as r, loadSpawnForest as ra, unsupportedProfileDimensions as ri, createPeerMailbox as rn, createCodeModeTools as rr, coordinationMcpAlias as rt, runFinalizer as s, captureWorkerTraceEvidence as sa, attestRuntimeOwnedScopeOwner as si, isLiveNodeStatus as sn, routerTokenPrice as sr, interactiveAdmissionSeamKey as st, DEFAULT_MAX_DEPTH as t, InMemorySpawnJournal as ta, sandboxActProfileMaterialization as ti, PEER_MAIL_WIRE_KEY as tn, resolveHarnessTranscriptCapture as tr, hostDirectoryReader as tt, HarnessTurnFailedError as u, workerTraceAnalysisStore as ua, finalizeRuntimeOwnedPendingExecutor as ui, bridgeModelRouteRefusal as un, mergeTraceEnv as ur, reconnectRetainedInteractiveRun as ut, withDriverExecutor as v, assertValidBudget as va, runtimeOwnedExecutorExecutionBinding as vi, isTerminalDecision as vn, flatOtelSpan as vr, CONTINUATIONS_DIR as vt, meterRuntimeOwnedAccounting as w, defaultRedactor as wa, unknownMaterializationReceipt as wi, assertBoxlessPromptOptions as wn, createRuntimeEventCollector as wr, checkVerdictOf as wt, beginScopeOwnerAttempt as x, newUsageTotals as xa, runtimeOwnedPendingExecutorMaterialization as xi, acquireSandbox as xn, padSpanId as xr, admitContinuationPolicy as xt, SUBTREE_RESULT_LIMIT as y, createBudgetPool as ya, runtimeOwnedExecutorMaterialization as yi, runAgentRounds as yn, generateSpanId as yr, CONTINUATION_FACTS as yt, bindScopeRetainedOwnerEnvironmentId as z, assertSandboxServedModel as zi, recoverRetainedRun as zn, parseCodexTokenUsage as zr, DEFAULT_SANDBOX_STEERING_MAX_TURNS as zt };
 
-//# sourceMappingURL=supervisor-6t1YG2PP.js.map
+//# sourceMappingURL=supervisor-DJXryb1R.js.map