@tangle-network/agent-runtime 0.177.0 → 0.178.0

package/dist/{supervisor-ChLgoYhG.js → supervisor-DyDgxgpl.js}

@@ -11144,8 +11144,38 @@ function createRetainedRunHandle(environment, session, initialControlRef, capabi
 	const clock = now ?? Date.now;
 	const measuredCapabilities = structuredClone(capabilities);
 	let activeControlRef = freezeControlRef(initialControlRef);
+	const knownControlRefDigests = /* @__PURE__ */ new Set([canonicalCandidateDigest(activeControlRef)]);
+	const synchronizeActiveControlRef = () => {
+		let candidate;
+		try {
+			candidate = session.controlRef;
+		} catch (error) {
+			throw new RetainedRunProviderContractError("provider retained session control reference read failed", {
+				code: "RETAINED_CONTROL_REF_READ_FAILED",
+				cause: error
+			});
+		}
+		if (candidate === void 0) return;
+		const parsed = AgentExactRunControlRefSchema.safeParse(candidate);
+		if (!parsed.success) throw new RetainedRunProviderContractError("provider retained session returned an invalid current control reference", {
+			code: "RETAINED_CONTROL_REF_INVALID",
+			cause: parsed.error
+		});
+		const candidateDigest = canonicalCandidateDigest(parsed.data);
+		if (sameControlCoordinates(parsed.data, activeControlRef) || knownControlRefDigests.has(candidateDigest)) return;
+		try {
+			activeControlRef = freezeControlRef(exactContinuedControlRef(parsed.data, activeControlRef));
+			knownControlRefDigests.add(candidateDigest);
+		} catch (error) {
+			throw new RetainedRunProviderContractError("provider retained session advanced to an invalid control reference", {
+				code: "RETAINED_CONTROL_REF_ADVANCE_INVALID",
+				cause: error
+			});
+		}
+	};
 	const snapshot = async (reason, signal) => {
 		if (signal?.aborted) throw abortError(signal.reason);
+		synchronizeActiveControlRef();
 		let status;
 		try {
 			status = await awaitAbortable$1(Promise.resolve().then(() => session.status({ signal })), signal);
@@ -11153,6 +11183,7 @@ function createRetainedRunHandle(environment, session, initialControlRef, capabi
 			if (signal?.aborted) throw abortError(signal.reason);
 			status = "unknown";
 		}
+		synchronizeActiveControlRef();
 		const effect = status === "cancelled" ? "cancelled" : status === "completed" || status === "failed" || status === "expired" ? "not_live" : "unknown";
 		return {
 			runId: activeControlRef.runId,
@@ -11164,8 +11195,137 @@ function createRetainedRunHandle(environment, session, initialControlRef, capabi
 			...signal?.aborted ? { signal: String(signal.reason ?? "aborted") } : {}
 		};
 	};
+	const assertContinuationIsCurrent = (continuationSource, nextControlRef) => {
+		if (!sameControlCoordinates(activeControlRef, continuationSource) && !sameControlCoordinates(activeControlRef, nextControlRef)) throw new Error("provider advanced the retained session while another native continuation was pending");
+	};
+	const missingContinuationAdmission = () => new RetainedRunProviderContractError("provider accepted a native continuation without an admission reference", { code: "RETAINED_NATIVE_CONTINUATION_ADMISSION_MISSING" });
+	const executeNativeContinuation = async (request, turn, admission, expectedSource) => {
+		synchronizeActiveControlRef();
+		const exactRequest = NativeContextContinuationRequestSchema.parse(request);
+		const continuationSource = expectedSource ?? activeControlRef;
+		if (!sameControlCoordinates(activeControlRef, continuationSource)) throw new Error("native continuation retained-run control changed before admission");
+		if (!sameControlCoordinates(exactRequest.run, continuationSource)) throw new Error("native continuation request targets another retained run");
+		const { timeoutMs, signal, ...semanticTurn } = turn;
+		if (nativeContextContinuationTurnDigest(semanticTurn) !== exactRequest.turnDigest) throw new Error("native continuation request targets another user turn");
+		const nativeCapabilities = measuredCapabilities.nativeContinuation;
+		if (nativeCapabilities?.atomicBoundary !== true || nativeCapabilities.requestIdempotency !== true || !session.continueNative) throw new Error(`provider "${activeControlRef.provider}" does not support retry-safe native continuation`);
+		if (admission !== void 0 && nativeCapabilities.admissionControl !== true) throw new Error(`provider "${activeControlRef.provider}" does not advertise early native continuation admission control`);
+		let outcome;
+		try {
+			outcome = AgentNativeContextContinuationResultSchema.parse(await awaitAbortable$1(Promise.resolve().then(() => {
+				const providerOptions = {
+					turn: semanticTurn,
+					...timeoutMs === void 0 ? {} : { timeoutMs },
+					...signal === void 0 ? {} : { signal },
+					...admission === void 0 ? {} : { onAdmission: admission.onAdmission }
+				};
+				return session.continueNative(exactRequest, providerOptions);
+			}), signal));
+		} catch (error) {
+			try {
+				synchronizeActiveControlRef();
+			} catch (syncError) {
+				throw new AggregateError([error, syncError], "native continuation failed and its current control reference could not be read");
+			}
+			throw error;
+		}
+		const admissionFailure = admission?.failure();
+		if (admissionFailure !== void 0) throw admissionFailure;
+		synchronizeActiveControlRef();
+		if (outcome.acknowledgement.operationId !== exactRequest.operationId || outcome.acknowledgement.requestDigest !== exactRequest.requestDigest) throw new Error("provider returned a native continuation result for another request");
+		if (outcome.acknowledgement.actualBoundary !== void 0) {
+			const actualBoundary = NativeContextBoundaryProofSchema.parse(outcome.acknowledgement.actualBoundary);
+			assertBoundaryBinding(exactRequest.run, actualBoundary);
+		}
+		if (outcome.acknowledgement.status !== "accepted" && outcome.acknowledgement.status !== "replayed") return structuredClone(outcome);
+		if (admission !== void 0 && !admission.isSettled() && outcome.acknowledgement.status === "accepted") throw missingContinuationAdmission();
+		if (!("result" in outcome) || !("controlRef" in outcome)) throw new Error("provider omitted the successful native continuation result");
+		if (!agentNativeContextContinuationResultMatchesRequest(exactRequest, outcome)) throw new Error("provider returned a native continuation result for another request");
+		const nextControlRef = exactContinuedControlRef(outcome.controlRef, continuationSource);
+		assertResultBinding(nextControlRef, outcome.result);
+		assertContinuationIsCurrent(continuationSource, nextControlRef);
+		if (admission !== void 0 && !admission.isSettled()) {
+			if (outcome.acknowledgement.status !== "replayed") throw missingContinuationAdmission();
+			admission.onAdmission(nextControlRef);
+		}
+		const admittedControlRef = admission?.controlRef();
+		if (admission !== void 0 && admittedControlRef === void 0) throw missingContinuationAdmission();
+		if (admittedControlRef !== void 0 && !sameControlCoordinates(nextControlRef, admittedControlRef)) throw new RetainedRunProviderContractError("provider changed the native continuation run after admission", { code: "RETAINED_NATIVE_CONTINUATION_RESULT_CHANGED" });
+		activeControlRef = freezeControlRef(nextControlRef);
+		knownControlRefDigests.add(canonicalCandidateDigest(activeControlRef));
+		return structuredClone({
+			...outcome,
+			controlRef: copyControlRef(activeControlRef)
+		});
+	};
+	const beginNativeContinuation = (request, turn) => {
+		synchronizeActiveControlRef();
+		if (measuredCapabilities.nativeContinuation?.admissionControl !== true) throw new Error(`provider "${activeControlRef.provider}" does not advertise early native continuation admission control`);
+		const continuationSource = activeControlRef;
+		let admissionSettled = false;
+		let admissionCalled = false;
+		let admittedControlRef;
+		let admissionFailure;
+		let resolveAdmission;
+		let rejectAdmission;
+		const admissionPromise = new Promise((resolve, reject) => {
+			resolveAdmission = resolve;
+			rejectAdmission = reject;
+		});
+		admissionPromise.catch(() => void 0);
+		const failAdmission = (error) => {
+			admissionFailure ??= error;
+			if (admissionSettled) return;
+			admissionSettled = true;
+			rejectAdmission(error);
+		};
+		const onAdmission = (candidate) => {
+			if (admissionCalled) {
+				const error = new RetainedRunProviderContractError("provider called native continuation admission more than once", { code: "RETAINED_NATIVE_CONTINUATION_ADMISSION_DUPLICATE" });
+				failAdmission(error);
+				throw error;
+			}
+			admissionCalled = true;
+			try {
+				const nextControlRef = exactContinuedControlRef(AgentExactRunControlRefSchema.parse(candidate), continuationSource);
+				assertContinuationIsCurrent(continuationSource, nextControlRef);
+				activeControlRef = freezeControlRef(nextControlRef);
+				knownControlRefDigests.add(canonicalCandidateDigest(activeControlRef));
+				admittedControlRef = activeControlRef;
+				if (!admissionSettled) {
+					admissionSettled = true;
+					resolveAdmission(copyControlRef(activeControlRef));
+				}
+			} catch (error) {
+				const contractError = error instanceof RetainedRunProviderContractError ? error : new RetainedRunProviderContractError(error instanceof Error ? error.message : "provider returned an invalid native continuation admission reference", {
+					code: "RETAINED_NATIVE_CONTINUATION_ADMISSION_INVALID",
+					cause: error
+				});
+				failAdmission(contractError);
+				throw contractError;
+			}
+		};
+		const result = executeNativeContinuation(request, turn, {
+			isSettled: () => admissionSettled,
+			failure: () => admissionFailure,
+			controlRef: () => admittedControlRef === void 0 ? void 0 : copyControlRef(admittedControlRef),
+			onAdmission
+		}, continuationSource);
+		result.then((outcome) => {
+			if (admissionSettled) return;
+			const error = new RetainedRunProviderContractError(outcome.acknowledgement.status === "accepted" || outcome.acknowledgement.status === "replayed" ? "provider accepted a native continuation without an admission reference" : "native continuation ended without durable admission", { code: outcome.acknowledgement.status === "accepted" || outcome.acknowledgement.status === "replayed" ? "RETAINED_NATIVE_CONTINUATION_ADMISSION_MISSING" : "RETAINED_NATIVE_CONTINUATION_NOT_ADMITTED" });
+			failAdmission(error);
+		}, (error) => {
+			failAdmission(error);
+		});
+		return {
+			admission: admissionPromise,
+			result
+		};
+	};
 	return {
 		get controlRef() {
+			synchronizeActiveControlRef();
 			return copyControlRef(activeControlRef);
 		},
 		get capabilities() {
@@ -11185,8 +11345,12 @@ function createRetainedRunHandle(environment, session, initialControlRef, capabi
 			}
 			return current;
 		},
-		events: (options) => retainedRunEvents(session, copyControlRef(activeControlRef), options, clock),
+		events: (options) => {
+			synchronizeActiveControlRef();
+			return retainedRunEvents(session, copyControlRef(activeControlRef), options, clock);
+		},
 		result: async () => {
+			synchronizeActiveControlRef();
 			let candidate;
 			try {
 				candidate = await exactSessionResult(session);
@@ -11202,6 +11366,7 @@ function createRetainedRunHandle(environment, session, initialControlRef, capabi
 				code: "RETAINED_RESULT_SCHEMA_INVALID",
 				cause: parsed.error
 			});
+			synchronizeActiveControlRef();
 			try {
 				assertResultBinding(activeControlRef, parsed.data);
 			} catch (error) {
@@ -11213,51 +11378,33 @@ function createRetainedRunHandle(environment, session, initialControlRef, capabi
 			return structuredClone(parsed.data);
 		},
 		async respondToInteraction(command, options) {
+			synchronizeActiveControlRef();
 			const exactCommand = InteractionResponseCommandSchema.parse(command);
 			assertInteractionBinding(activeControlRef, exactCommand);
 			if (measuredCapabilities.interactions?.replay !== true || measuredCapabilities.interactions.responseIdempotency !== true) throw new Error(`provider "${activeControlRef.provider}" does not promise retry-safe interaction responses`);
 			const respond = session.respondToInteraction ?? environment.respondToInteraction;
 			if (!respond) throw new Error(`provider "${activeControlRef.provider}" does not support interaction responses`);
 			const acknowledgement = InteractionAcknowledgementSchema.parse(await awaitAbortable$1(Promise.resolve().then(() => respond.call(session.respondToInteraction ? session : environment, exactCommand, options)), options?.signal));
+			synchronizeActiveControlRef();
 			if (acknowledgement.operationId !== exactCommand.operationId || acknowledgement.commandDigest !== exactCommand.commandDigest || canonicalCandidateDigest(acknowledgement.binding) !== canonicalCandidateDigest(exactCommand.binding)) throw new Error("provider returned an interaction acknowledgement for another command");
 			return structuredClone(acknowledgement);
 		},
 		async contextBoundary(options) {
+			synchronizeActiveControlRef();
 			if (!session.contextBoundary) return null;
 			const proof = await awaitAbortable$1(Promise.resolve().then(() => session.contextBoundary(options)), options?.signal);
+			synchronizeActiveControlRef();
 			if (proof === null) return null;
 			const exactProof = NativeContextBoundaryProofSchema.parse(proof);
 			assertBoundaryBinding(activeControlRef, exactProof);
 			return structuredClone(exactProof);
 		},
-		async continueNative(request, turn) {
-			const exactRequest = NativeContextContinuationRequestSchema.parse(request);
-			if (!sameControlCoordinates(exactRequest.run, activeControlRef)) throw new Error("native continuation request targets another retained run");
-			const { timeoutMs, signal, ...semanticTurn } = turn;
-			if (nativeContextContinuationTurnDigest(semanticTurn) !== exactRequest.turnDigest) throw new Error("native continuation request targets another user turn");
-			if (measuredCapabilities.nativeContinuation?.atomicBoundary !== true || measuredCapabilities.nativeContinuation.requestIdempotency !== true || !session.continueNative) throw new Error(`provider "${activeControlRef.provider}" does not support retry-safe native continuation`);
-			const outcome = AgentNativeContextContinuationResultSchema.parse(await awaitAbortable$1(Promise.resolve().then(() => session.continueNative(exactRequest, {
-				turn: semanticTurn,
-				...timeoutMs === void 0 ? {} : { timeoutMs },
-				...signal === void 0 ? {} : { signal }
-			})), signal));
-			if (outcome.acknowledgement.operationId !== exactRequest.operationId || outcome.acknowledgement.requestDigest !== exactRequest.requestDigest) throw new Error("provider returned a native continuation result for another request");
-			if (outcome.acknowledgement.actualBoundary !== void 0) {
-				const actualBoundary = NativeContextBoundaryProofSchema.parse(outcome.acknowledgement.actualBoundary);
-				assertBoundaryBinding(exactRequest.run, actualBoundary);
-			}
-			if (outcome.acknowledgement.status !== "accepted" && outcome.acknowledgement.status !== "replayed") return structuredClone(outcome);
-			if (!("result" in outcome) || !("controlRef" in outcome)) throw new Error("provider omitted the successful native continuation result");
-			if (!agentNativeContextContinuationResultMatchesRequest(exactRequest, outcome)) throw new Error("provider returned a native continuation result for another request");
-			const nextControlRef = exactContinuedControlRef(outcome.controlRef, activeControlRef);
-			assertResultBinding(nextControlRef, outcome.result);
-			activeControlRef = freezeControlRef(nextControlRef);
-			return structuredClone({
-				...outcome,
-				controlRef: copyControlRef(activeControlRef)
-			});
+		beginNativeContinuation,
+		continueNative(request, turn) {
+			return executeNativeContinuation(request, turn, void 0, void 0);
 		},
 		async cancel(options) {
+			synchronizeActiveControlRef();
 			assertStableText(options.operationId, "retained cancellation operation id");
 			if (options.reason !== void 0) assertStableText(options.reason, "retained cancellation reason");
 			if (options.signal?.aborted) throw abortError(options.signal.reason);
@@ -15292,4 +15439,4 @@ function isNonEmptySpend(s) {
 //#endregion
 export { bridgeRuntimeAttachmentsKey as $, buildRuntimeEventOtelSpans as $t, readWorkerInteractiveBinding as A, profileMaterializationAxes$1 as An, isLiveNodeStatus as At, retainedCreateMaterial as B, worktreeCliProfileMaterialization as Bn, probeSandboxCapabilities as Bt, timerAt as C, parseCodexTokenUsage as Cn, DEFAULT_PEER_MAIL_LIMITS as Ct, readWorkerInteractiveAdmissions as D, controlProfileMaterialization as Dn, isPeerMailEnvelope as Dt, interactiveAdmissionSeamKey as E, assertProfileMaterialization as En, createPeerMailbox as Et, startRetainedInteractiveRun as F, renderProfileMaterializationIssues as Fn, createSandboxForSpec as Ft, DEFAULT_SUCCESSFUL_SHUTDOWN_MS as G, observedModelMatchesDeclared as Gt, freeSlots as H, routerBrain as Ht, reconnectRetainedRun as I, renderUnsupported as In, defaultSelectWinner as It, createBudgetPool as J, readTraceContextFromEnv as Jt, teardownExecutor as K, createPropagatingTraceEmitter as Kt, recoverRetainedRun as L, sandboxActProfileMaterialization as Ln, isTerminalDecision as Lt, workerInteractiveBindingsDir as M, promptModelProfileMaterialization as Mn, createInPlaceCliExecutor as Mt, reconnectRetainedInteractiveRun as N, promptOnlyProfileMaterialization as Nn, taskToPrompt as Nt, workerInteractiveAdmissionFile as O, defineProfileMaterializationContract as On, peerMailTools as Ot, recoverRetainedInteractiveRun as P, promptResourceProfileMaterialization as Pn, TERMINAL_DECISIONS as Pt, bridgeModelRouteRefusal as Q, buildLoopSpanNodes as Qt, startRetainedRun as R, unsupportedProfileDimensions as Rn, runAgentRounds as Rt, pollFor as S, localHarnessExecutable as Sn, AUTHORITY_MARKERS as St, waitUntil as T, AGENT_PROFILE_MATERIALIZATION_AXES as Tn, claimsAuthority as Tt, queueOf as U, runBrainLoop as Ut, effectiveConcurrency as V, acquireSandbox as Vt, rollingDispatch as W, canonicalObservedModel as Wt, bindReusableExecutorExecutionId as X, INTELLIGENCE_WIRE_VERSION as Xt, spendFromUsageEvents as Y, traceContextToEnv as Yt, bridgeAdmissionRead as Z, buildLoopOtelSpans as Zt, recordScopeOwnerMaterialization as _, createWorktree as _n, sandboxSessionTraceSource as _t, uncertainSpawnBudgets as a, loopEventToOtelSpan as an, createExecutorRegistry as at, createWaitProbes as b, LOCAL_HARNESSES as bn, readWorkerProgress as bt, pickBestDelivered as c, toOtelAttributes as cn, WORKER_TRACE_PROPAGATION as ct, driverChild as d, sanitizeAgentRuntimeEvent as dn, workerTraceHeaders as dt, createOpenInferenceFileExporter as en, bridgeStopSignalKey as et, withDriverExecutor as f, sanitizeKnowledgeReadinessReport as fn, workerTraceSeamKey as ft, meterRuntimeOwnedProviderAttempt as g, captureWorktreeDiff as gn, decodeToolPart as gt, meterRuntimeOwnedAccounting as h, runWorktreeHarness as hn, createPushTraceSource as ht, sumMeasuredSpendFromEvents as i, generateSpanId as in, createExecutor as it, workerInteractiveBindingFile as j, promptControlProfileMaterialization as jn, isTerminalNodeStatus as jt, attachWorker as k, fullProfileMaterialization as kn, peerMailVerbNames as kt, runFinalizer as l, createRuntimeEventCollector as ln, readWorkerTraceContext as lt, deriveNodeExecutionIdentity as m, runSettledCommand as mn, createSteerableSandboxSession as mt, createSupervisor as n, exportEvalRuns as nn, cliInPlaceExecutor as nt, bestDelivered as o, padSpanId as on, snapshotExecutorConfig as ot, createScope as p, sanitizeRuntimeStreamEvent as pn, DEFAULT_SANDBOX_STEERING_MAX_TURNS as pt, assertValidBudget as q, mergeTraceEnv as qt, maxSeqOf as r, flatOtelSpan as rn, cliWorktreeExecutor as rt, collectDelivered as s, padTraceId as sn, createWorktreeCliExecutor as st, createRootHandle as t, createOtelExporter as tn, captureReusableExecutorConfig as tt, runTree as u, createRuntimeStreamEventCollector as un, workerTraceEnv as ut, scopeOwnerExecutorNodeContext as v, removeWorktree as vn, DEFAULT_STALL_AFTER_MS as vt, validateWaitSpec as w, CodexExecutionDiagnosticError as wn, PEER_MAIL_WIRE_KEY as wt, isWaitOutcome as x, harnessSupportsReasoningEffort as xn, createInbox as xt, settledToIteration as y, DEFAULT_LOCAL_HARNESS as yn, createActivityLog as yt, startRetainedRunInEnvironment as z, validateProfileMaterialization as zn, createSandboxLineage as zt };
 
-//# sourceMappingURL=supervisor-ChLgoYhG.js.map
+//# sourceMappingURL=supervisor-DyDgxgpl.js.map