@tangle-network/agent-runtime 0.319.5 → 0.319.8

package/dist/{supervisor--nmU6w86.js → supervisor-CRod4ISR.js}

@@ -17,6 +17,7 @@ import { homedir, hostname, tmpdir } from "node:os";
 import { stripVTControlCharacters } from "node:util";
 import { ATTR, deriveHexId, isW3CSpanId, isW3CTraceId } from "@tangle-network/agent-trace-contract";
 import { REDACTION_VERSION as REDACTION_VERSION$1, redact } from "@tangle-network/agent-eval/traces";
+import { clearImmediate, setImmediate } from "node:timers";
 import { z } from "zod";
 import { Readable } from "node:stream";
 import { SDKError, generateIdempotencyKey, withRetry } from "@tangle-network/agent-core";
@@ -1971,6 +1972,7 @@ const compoundAxisLeaves = {
 		"skills",
 		"resourceAgents",
 		"commands",
+		"knowledge",
 		"resourceInstructions",
 		"resourceFailOnError"
 	],
@@ -12462,6 +12464,7 @@ const NATIVE_SETTLE_POLL_MS = 1e3;
 /** The two waits together leave a minute for Runtime to record a pending result before ten minutes. */
 const RETAINED_OBSERVATION_IDLE_MS = 8 * 6e4;
 const RETAINED_RESULT_WAIT_MS = 6e4;
+const RETAINED_OBSERVATION_BATCH_EVENTS = 1024;
 var RetainedReadTimeoutError = class extends Error {
 	constructor(label, ms) {
 		super(`retained provider ${label} did not settle within ${ms} ms`);
@@ -12558,8 +12561,12 @@ async function* streamProviderExecutor(args) {
 	let unavailable;
 	let finalCopyTaken = false;
 	const ownerTakesCapture = () => args.options.workspaceRetention?.captureNative !== void 0 && args.createProfile.harness !== void 0 && source.retained && args.retention?.preserveEnvironment === true && args.retention.onEndOfTurnWork !== void 0;
-	const handCaptureToOwner = (reported, captureOutcome, publish) => {
-		args.retention?.onEndOfTurnWork?.(args.captureWorkspace(environment, captureOutcome).then(async (snapshot) => {
+	const handCaptureToOwner = (reported, captureOutcome, publish, beforeCapture) => {
+		args.retention?.onEndOfTurnWork?.((async () => {
+			try {
+				await beforeCapture?.();
+			} catch {}
+			const snapshot = await args.captureWorkspace(environment, captureOutcome);
 			if (publish) args.onPublishedSnapshot(snapshot);
 			if (snapshot === void 0) return;
 			await args.retention?.onEvidence?.({
@@ -12567,7 +12574,7 @@ async function* streamProviderExecutor(args) {
 				workspaceSnapshot: snapshot,
 				workspaceCapture: providerWorkspaceCaptureReceipt(args, environment, snapshot, turn.sessionId ?? null)
 			});
-		}, () => void 0));
+		})().catch(() => void 0));
 	};
 	let harnessStop;
 	const stopEndedHarness = () => {
@@ -12598,6 +12605,7 @@ async function* streamProviderExecutor(args) {
 			const usageEvent = usageSandboxEvent(event);
 			if (usageEvent) yield* creditUsage(usageLedger.observe(usageEvent, args.profile.name ?? "agent"), usageEvent);
 			yield* creditUsage(usageLedger.observe(sandboxEvent, args.profile.name ?? "agent"), sandboxEvent);
+			if (source.retained && event.type === "result" && event.data.eventStreamComplete === false && event.data.usdKnown === false) sawUnknownCostReceipt = true;
 			if (isTerminalEnvironmentEvent(event)) terminal = true;
 		}
 		yield* creditUsage(usageLedger.settleTurn(args.profile.name ?? "agent"));
@@ -12649,7 +12657,7 @@ async function* streamProviderExecutor(args) {
 			box: environmentAsSandboxInstance(environment, { requireTerminalEvent: args.options.requireTerminalEvent ?? true }),
 			signal: linked
 		});
-		const deferCapture = ownerTakesCapture() && args.managerStopped();
+		const deferCapture = ownerTakesCapture();
 		let retainedWorkspace;
 		let workspaceCaptureFailure;
 		if (!deferCapture) {
@@ -12694,9 +12702,8 @@ async function* streamProviderExecutor(args) {
 		args.onPending(false);
 		args.onArtifact(settled);
 		if (deferCapture) {
-			await args.finishNativeMirror(environment, "settled");
 			finalCopyTaken = true;
-			handCaptureToOwner(settledResult, outcome, true);
+			handCaptureToOwner(settledResult, outcome, true, () => args.finishNativeMirror(environment, "settled"));
 		}
 	} catch (error) {
 		yield* creditUsage(usageLedger.settleTurn(args.profile.name ?? "agent"));
@@ -12877,7 +12884,6 @@ async function providerExecutionSource(args, turn, signal) {
 	const retention = args.retention;
 	const observationIdleMs = retainedWaitBound(args.options.retainedObservationIdleMs, RETAINED_OBSERVATION_IDLE_MS, "retainedObservationIdleMs");
 	const resultWaitMs = retainedWaitBound(args.options.retainedResultWaitMs, RETAINED_RESULT_WAIT_MS, "retainedResultWaitMs");
-	const resultDrainGraceMs = Math.min(15e3, Math.max(50, Math.floor(observationIdleMs / 10)));
 	let admitted = args.recovering;
 	let executionAdmitted = args.recovering && retention.admissions.some((admission) => admission.phase === "dispatched");
 	const onAdmission = async (admission) => {
@@ -13003,11 +13009,18 @@ async function providerExecutionSource(args, turn, signal) {
 		async function* events() {
 			let observationFailure;
 			let exactResult;
-			let exactWake;
+			let exactResultSettled = false;
+			let observedFrames = 0;
+			let framesAfterResult = 0;
+			let observationBudgetExceeded = false;
 			const readExactResult = () => {
 				if (exactResult === void 0) {
-					exactResult = awaitAbortable$1(handle.result(), signal);
-					exactWake = exactResult.then(() => void 0, () => new Promise(() => {}));
+					exactResult = awaitAbortable$1(Promise.resolve().then(() => handle.result()), signal);
+					exactResult.then(() => {
+						exactResultSettled = true;
+					}, () => {
+						exactResultSettled = true;
+					});
 				}
 				return exactResult;
 			};
@@ -13018,7 +13031,6 @@ async function providerExecutionSource(args, turn, signal) {
 			const drain = async function* (open) {
 				let iterator;
 				let failed = false;
-				let exactResultReady = false;
 				try {
 					iterator = open()[Symbol.asyncIterator]();
 				} catch (error) {
@@ -13028,30 +13040,41 @@ async function providerExecutionSource(args, turn, signal) {
 				}
 				try {
 					while (true) {
+						if (framesAfterResult >= RETAINED_OBSERVATION_BATCH_EVENTS) {
+							observationBudgetExceeded = true;
+							break;
+						}
+						if (observedFrames > 0 && observedFrames % RETAINED_OBSERVATION_BATCH_EVENTS === 0) await awaitAbortable$1(new Promise((resolve) => setImmediate(resolve)), signal);
 						let next;
+						let wake;
 						try {
 							const remaining = observationIdleMs - (Date.now() - lastObservedAt);
 							if (remaining <= 0) throw new RetainedReadTimeoutError("event stream", observationIdleMs);
-							const eventRead = awaitAbortable$1(Promise.resolve().then(() => iterator.next()), signal).then((value) => ({
+							const exactWake = new Promise((resolve) => {
+								wake = setImmediate(() => {
+									readExactResult().then(() => resolve({ kind: "exact-result" }), () => resolve({ kind: "exact-result" }));
+								});
+							});
+							const observed = await awaitRetainedRead(Promise.race([awaitAbortable$1(Promise.resolve().then(() => iterator.next()), signal).then((value) => ({
 								kind: "event",
 								value
-							}));
-							const observed = await awaitRetainedRead(exactWake !== void 0 && !sawTerminal ? Promise.race([eventRead, exactWake.then(() => ({ kind: "exact-result" }))]) : eventRead, remaining, "event stream");
-							if (observed.kind === "exact-result") try {
-								next = (await awaitRetainedRead(eventRead, resultDrainGraceMs, "buffered event stream")).value;
-							} catch (error) {
-								if (!(error instanceof RetainedReadTimeoutError)) throw error;
-								exactResultReady = true;
+							})), exactWake]), remaining, "event stream");
+							if (observed.kind === "exact-result") {
+								observationFailure ??= { error: /* @__PURE__ */ new Error("retained provider stream remained open after its exact result") };
 								break;
 							}
-							else next = observed.value;
+							next = observed.value;
 						} catch (error) {
 							if (signal.aborted) throw error;
 							observationFailure = { error };
 							failed = true;
 							break;
+						} finally {
+							if (wake !== void 0) clearImmediate(wake);
 						}
 						if (next.done) break;
+						observedFrames += 1;
+						if (exactResultSettled) framesAfterResult += 1;
 						try {
 							assertEventBinding(next.value, handle.controlRef);
 						} catch (error) {
@@ -13080,12 +13103,11 @@ async function providerExecutionSource(args, turn, signal) {
 						if (identity.cursor !== void 0) lastReplayPosition = identity.cursor;
 						else if (eventId !== void 0) lastReplayPosition = eventId;
 						if (isTerminalEnvironmentEvent(next.value)) sawTerminal = true;
-						else readExactResult();
+						readExactResult();
 						yield next.value;
 					}
 				} finally {
-					if (signal.aborted || failed || exactResultReady || sawTerminal) Promise.resolve().then(() => iterator?.return?.()).catch(() => void 0);
-					else await iterator?.return?.();
+					Promise.resolve().then(() => iterator?.return?.()).catch(() => void 0);
 				}
 				return !failed;
 			};
@@ -13101,6 +13123,10 @@ async function providerExecutionSource(args, turn, signal) {
 					signal
 				})))) observationFailure = firstFailure;
 			}
+			if (observationBudgetExceeded) {
+				await readExactResult();
+				throw new RetainedExecutionPendingError(/* @__PURE__ */ new Error(`retained provider observation exceeded ${RETAINED_OBSERVATION_BATCH_EVENTS} frames after its exact result`), "unobservable");
+			}
 			if (!sawTerminal && observationFailure === void 0) observationFailure = { error: /* @__PURE__ */ new Error("retained provider stream did not yield a terminal event") };
 			let result;
 			try {
@@ -13120,6 +13146,8 @@ async function providerExecutionSource(args, turn, signal) {
 					usageMode: "cumulative",
 					...observationFailure === void 0 ? {} : {
 						eventStreamComplete: false,
+						...result.usage === void 0 ? { tokensKnown: false } : {},
+						...result.usage?.cost === void 0 ? { usdKnown: false } : {},
 						eventStreamError: String(defaultRedactor(observationFailure.error instanceof Error ? observationFailure.error.message : String(observationFailure.error))).slice(0, 2048)
 					}
 				},
@@ -30875,4 +30903,4 @@ function isNonEmptySpend(s) {
 //#endregion
 export { environmentReader as $, runtimeOwnedScopeOwnerRuntime as $i, parseWorkerToolTraceArtifact as $n, loopEventToOtelSpan as $r, PEER_MAIL_WIRE_KEY as $t, scopeOwnerExecutorNodeContext as A, promptOnlyProfileMaterialization as Ai, resolveAgentEnvironmentProvider as An, resolveHarnessTranscriptCapture as Ar, captureReusableExecutorConfig as At, consumeScopeRetainedOwnerResult as B, authoredProfileDigest as Bi, InMemoryResultBlobStore as Bn, mergeTraceEnv as Br, createInPlaceCliExecutor as Bt, deriveNodeExecutionIdentity as C, promptFromAgentTurnInput as Ca, assertProfileMaterializes as Ci, readPromptOptions as Cn, abortError as Cr, createContinuationKeeper as Ct, recordScopeOwnerMaterialization as D, profileMaterializationAxes$1 as Di, createAgentEnvironmentProviderRegistry as Dn, harnessTranscriptArtifact as Dr, passedItems as Dt, recordScopeOwnerDriverAttempt as E, fullProfileMaterialization as Ei, LEAF_CONTINUATION_TASK as En, captureHarnessTranscript as Er, failedItems as Et, seatExecutionProfile as F, unsupportedProfileDimensions as Fi, retainedExecutorSeamKey as Fn, runCodeMode as Fr, snapshotExecutorConfig as Ft, scopeRetainedOwnerContext as G, newExecutionAttemptId as Gi, replaySpawnTree as Gn, resolveRedactor as Gr, workerTraceSeamKey as Gt, prepareScopeRetainedOwnerSeatSwitch as H, inheritRuntimeOwnedExecutorAttestation as Hi, insideCursorNamespace as Hn, traceContextToEnv as Hr, readWorkerTraceContext as Ht, abandonScopeRetainedOwnerInvocation as I, validateProfileMaterialization as Ii, unavailablePauseMs as In, priceTokens as Ir, createWorktreeCliExecutor as It, scopeRetainedOwnerResourceReader as J, runtimeOwnedDriveHarnessProviderEvidence as Ji, readCommittedJsonLines as Jn, buildRuntimeEventOtelSpans as Jr, createActivityLog as Jt, scopeRetainedOwnerJournalRoot as K, providerAttemptEvidence as Ki, isNoEntError as Kn, buildLoopOtelSpans as Kr, taskToPrompt as Kt, beginScopeRetainedOwnerDrive as L, worktreeCliProfileMaterialization as Li, unavailableSignalOfFailure as Ln, routerTokenPrice as Lr, DEFAULT_SANDBOX_STEERING_MAX_TURNS as Lt, SeatChain as M, renderProfileMaterializationIssues as Mi, decodeToolPart as Mn, contentAddress as Mr, cliWorktreeExecutor as Mt, SeatChainExhaustedError as N, renderUnsupported as Ni, sandboxSessionTraceSource as Nn, createCodeModeTools as Nr, createExecutor as Nt, recordScopeOwnerPause as O, promptControlProfileMaterialization as Oi, providerAsExecutor as On, persistHarnessTranscript as Or, verdictFromJudgeScore as Ot, authoredSeatStages as P, sandboxActProfileMaterialization as Pi, registerRetainedExecutorPreparation as Pn, describeCodeModeTools as Pr, createExecutorRegistry as Pt, SPAWN_RESOURCE_PATH_MAX_BYTES as Q, runtimeOwnedPendingExecutorMaterialization as Qi, isTraceAnalysisStore as Qn, generateSpanId as Qr, DEFAULT_PEER_MAIL_LIMITS as Qt, bindScopeRetainedOwnerEnvironmentId as R, attestRuntimeOwnedPendingExecutor as Ri, FileResultBlobStore as Rn, ROUTER_PRICE_SOURCE as Rr, createSteerableSandboxSession as Rt, createScope as S, awaitAbortable$1 as Sa, assertProfileMaterialization as Si, assertBoxlessPromptOptions as Sn, RunCancellationReason as Sr, checkVerdictOf as St, meterRuntimeOwnedProviderAttempt as T, providerMessageText as Ta, defineProfileMaterializationContract as Ti, runBrainLoop as Tn, runAbortable as Tr, expandQuestions as Tt, prepareScopeRetainedOwnerTask as U, knownExecutionBindingReceipt as Ui, loadSpawnForest as Un, defaultRedactor as Ur, workerTraceEnv as Ut, noteScopeRetainedOwnerCoordination as V, finalizeRuntimeOwnedPendingExecutor as Vi, InMemorySpawnJournal as Vn, readTraceContextFromEnv as Vr, WORKER_TRACE_PROPAGATION as Vt, reconcileScopeRetainedOwnerEnvironment as W, knownMaterializationReceipt as Wi, materializeTreeView as Wn, defaultRedactorIdentityMaterial as Wr, workerTraceHeaders as Wt, scopeRetainedOwnerResult as X, runtimeOwnedExecutorMaterialization as Xi, WORKER_TOOL_TRACE_SCHEMA_VERSION as Xn, createOtelExporter as Xr, createInbox as Xt, scopeRetainedOwnerRestorePoint as Y, runtimeOwnedExecutorExecutionBinding as Yi, writeAllBytes as Yn, createOpenInferenceFileExporter as Yr, readWorkerProgress as Yt, scopeRetainedOwnerTurnEnded as Z, runtimeOwnedExecutorProviderEvidence as Zi, captureWorkerTraceEvidence as Zn, flatOtelSpan as Zr, AUTHORITY_MARKERS as Zt, isDriverSpec as _, sandboxEventServedBackend as _a, localHarnessExecutable as _i, runAgentRounds as _n, retainedCreateMaterial as _r, CONTINUATION_FACTS as _t, collectDelivered as a, detachedSnapshot as aa, sanitizeAgentRuntimeEvent as ai, isLiveNodeStatus as an, createBudgetPool as ar, interactiveAdmissionSeamKey as at, assertRecursiveReservationPolicy as b, decodeHarnessUsage as ba, terminateProcessTreeAndConfirm as bi, SandboxEvidenceRetentionError as bn, createWorkerSlots as br, admitFinding as bt, runTree as c, assertSandboxServedModel as ca, runSettledCommand as ci, bridgeModelRouteRefusal as cn, spendFromUsageEvents as cr, reconnectRetainedInteractiveRun as ct, classifyDriverFailure as d, createSandboxUsageLedger as da, createWorktree as di, harnessUsageIsEmpty as dn, bridgeStopSignalKey as dr, freeSlots as dt, unknownExecutionBindingReceipt as ea, padSpanId as ei, claimsAuthority as en, workerTraceAnalysisStore as er, hostDirectoryReader as et, runDriverWithRetry as f, extractLlmCallEvent as fa, removeWorktree as fi, readCodexRolloutSession as fn, errMessage as fr, queueOf as ft, driverExecutorFactory as g, notifySandboxEventObserver as ga, harnessSupportsReasoningEffort as gi, isTerminalDecision as gn, startRetainedRunInEnvironment as gr, CONTINUATIONS_DIR as gt, driverChild as h, mapSandboxToolEvent as ha, harnessInvocation as hi, defaultSelectWinner as hn, startRetainedRun as hr, mapExecutorResult as ht, bestDelivered as i, detachedFrozen as ia, createRuntimeStreamEventCollector as ii, peerMailVerbNames as in, assertValidBudget as ir, providerVisibleProfile as it, settledToIteration as j, promptResourceProfileMaterialization as ji, createPushTraceSource as jn, retainHarnessTranscript as jr, cliInPlaceExecutor as jt, restoreScopeOwnerAcceptedExecution as k, promptModelProfileMaterialization as ki, providerAsSandboxClient as kn, readHarnessTranscript as kr, bindReusableExecutorExecutionId as kt, DriverAttemptsExhaustedError as l, canonicalStreamEventFromSandboxEvent as la, runWorktreeHarness as li, addHarnessUsage as ln, spendFromUsageTotals as lr, recoverRetainedInteractiveRun as lt, upstreamUnavailableSignal as m, mapSandboxEvent as ma, LOCAL_HARNESSES as mi, createSandboxForSpec as mn, recoverRetainedRun as mr, gateOnDeliverable as mt, createRootHandle as n, executableAgentProfileSnapshot as na, toOtelAttributes as ni, isPeerMailEnvelope as nn, BudgetReconcileFault as nr, coordinationMcpAlias as nt, pickBestDelivered as o, projectSandboxOutcome as oa, sanitizeKnowledgeReadinessReport as oi, isTerminalNodeStatus as on, meterUsageEvent as or, attachWorker as ot, summarizeDriverAttempts as p, isSandboxTerminalEvent as pa, DEFAULT_LOCAL_HARNESS as pi, TERMINAL_DECISIONS as pn, reconnectRetainedRun as pr, rollingDispatch as pt, scopeRetainedOwnerPriorSpend as q, recordRuntimeOwnedDriveHarnessProviderEvidence as qi, prepareJsonlAppend as qn, buildLoopSpanNodes as qr, DEFAULT_STALL_AFTER_MS as qt, createSupervisor as r, executableAgentSpecSnapshot as ra, createRuntimeEventCollector as ri, peerMailTools as rn, ReservationWaitRefused as rr, coordinationProfileToolPrefix as rt, runFinalizer as s, readSandboxOutcome as sa, sanitizeRuntimeStreamEvent as si, bridgeAdmissionRefusal as sn, newUsageTotals as sr, readWorkerInteractiveBinding as st, DEFAULT_MAX_DEPTH as t, unknownMaterializationReceipt as ta, padTraceId as ti, createPeerMailbox as tn, executorFailure as tr, resolveSpawnResourcePaths as tt, HarnessTurnFailedError as u, createSandboxToolPartState as ua, captureWorktreeDiff as ui, createCodexRolloutStoreReader as un, bridgeRuntimeAttachmentsKey as ur, startRetainedInteractiveRun as ut, withDriverExecutor as v, sandboxProgressEvents as va, parseCodexTokenUsage as vi, createSandboxLineage as vn, destroyInteractiveEnvironment as vr, CheckUnavailableError as vt, meterRuntimeOwnedAccounting as w, promptOptionsFromAgentTurnInput as wa, controlProfileMaterialization as wi, routerBrain as wn, linkAbort as wr, distillFindings as wt, beginScopeOwnerAttempt as x, abortError$1 as xa, AGENT_PROFILE_MATERIALIZATION_AXES as xi, captureBeforeDestroy as xn, openSlotGroup as xr, bestComposite as xt, SUBTREE_RESULT_LIMIT as y, sumSandboxUsage as ya, CodexExecutionDiagnosticError as yi, acquireSandbox as yn, environmentGone as yr, admitContinuationPolicy as yt, bindScopeRetainedOwnerProvider as z, attestRuntimeOwnedScopeOwner as zi, FileSpawnJournal as zn, createPropagatingTraceEmitter as zr, createRouterTranscript as zt };
 
-//# sourceMappingURL=supervisor--nmU6w86.js.map
+//# sourceMappingURL=supervisor-CRod4ISR.js.map