@tangle-network/agent-runtime 1.0.0 → 2.0.2

package/dist/durable-file-DstVeHcj.js

@@ -0,0 +1,228 @@
+import { randomUUID } from "node:crypto";
+import { tryAcquireAtomicFileLock } from "@tangle-network/agent-eval/ledger-core";
+import { closeSync, constants, existsSync, fchmodSync, fstatSync, fsyncSync, linkSync, lstatSync, openSync, readFileSync, renameSync, statSync, unlinkSync, writeFileSync, writeSync } from "node:fs";
+import { dirname, join, relative, resolve } from "node:path";
+import { AsyncLocalStorage } from "node:async_hooks";
+// src/durable/run-fence.ts
+const claims = new AsyncLocalStorage();
+const publications = new AsyncLocalStorage();
+/** Bind asynchronous work, including callbacks, to the generation that admitted it. @internal */
+function runWithWriteClaim(claim, operation) {
+	return claims.run(claim, operation);
+}
+/** Capture a store's acquisition once, even when later called from an unrelated emitter. @internal */
+function captureRunWriteContext() {
+	let claim = claims.getStore();
+	return (operation) => {
+		claim ??= claims.getStore();
+		return claims.run(claim, operation);
+	};
+}
+/** Serialize claim changes and file mutations under the same cross-process guard. @internal */
+function mutateRunClaim(path, operation) {
+	const legacyGuard = `${path}.guard`;
+	if (existsSync(legacyGuard)) throw new Error(`supervisePursuit: cannot mutate ${path}; inspect ${legacyGuard} and remove it only after confirming no lock mutation is active`);
+	const deadline = performance.now() + 5e3;
+	const sleeper = new Int32Array(new SharedArrayBuffer(4));
+	for (;;) {
+		const acquisition = tryAcquireAtomicFileLock({ lockPath: `${path}.mutation` });
+		if (acquisition.acquired) try {
+			return operation();
+		} finally {
+			acquisition.lock.release();
+		}
+		if (performance.now() >= deadline) throw new Error(`run directory mutation is held: ${path}`);
+		Atomics.wait(sleeper, 0, 0, 10);
+	}
+}
+/**
+* Fence an actual file mutation, not an earlier advisory check. No await occurs between the
+* ownership check and publication, and acquire/release use this same guard. Unclaimed standalone
+* stores retain their existing single-writer contract; pursuit-owned work always carries a claim.
+* @internal
+*/
+function fenceRunWrite(operation) {
+	const claim = claims.getStore();
+	if (claim === void 0) return operation();
+	const publication = publications.getStore();
+	if (publication?.active && publication.claim.path === claim.path && publication.claim.generation === claim.generation) return operation();
+	return mutateRunClaim(claim.path, () => {
+		let holder;
+		try {
+			const fd = openSync(claim.path, "r");
+			try {
+				const stat = fstatSync(fd, { bigint: true });
+				if (stat.dev.toString() !== claim.lock.dev || stat.ino.toString() !== claim.lock.ino || stat.birthtimeNs.toString() !== claim.lock.birthtimeNs) throw new Error("run lock inode changed");
+				holder = JSON.parse(readFileSync(fd, "utf8"));
+			} finally {
+				closeSync(fd);
+			}
+		} catch (cause) {
+			throw new Error(`run directory generation ${claim.generation} lost its claim`, { cause });
+		}
+		if (holder?.generation !== claim.generation || holder.lock?.dev !== claim.lock.dev || holder.lock?.ino !== claim.lock.ino || holder.lock?.birthtimeNs !== claim.lock.birthtimeNs) throw new Error(`run directory generation ${claim.generation} lost its claim`);
+		const publication = {
+			claim,
+			active: true
+		};
+		try {
+			return publications.run(publication, operation);
+		} finally {
+			publication.active = false;
+		}
+	});
+}
+/** Persistent generation counter survives a clean release of supervise.lock. @internal */
+function runGenerationPath(runDir) {
+	return resolve(runDir, "supervise.generation");
+}
+// src/runtime/supervise/durable-file.ts
+/**
+* Small filesystem durability primitives for Runtime-owned state.
+*
+* Callers must validate their path and parent directory before invoking these functions.
+* The exclusive writer protects a no-clobber publication race; the atomic writer replaces one
+* state file after its temporary contents reach stable storage.
+*
+* @internal
+*/
+/**
+* Publish a new file without replacing a concurrent winner. The published entry is a hard link
+* of the temporary file, so a content function sees the published file's inode.
+*/
+function publishExclusiveDurableFile(filePath, content, options = {}) {
+	return fenceRunWrite(() => publishExclusiveDurableFileUnchecked(filePath, content, options));
+}
+function publishExclusiveDurableFileUnchecked(filePath, content, options = {}) {
+	const temporaryPath = `${filePath}.${randomUUID()}.tmp`;
+	let operationFailed = false;
+	let operationError;
+	let published = false;
+	try {
+		writeExclusiveDurableFile(temporaryPath, content, options);
+		try {
+			linkSync(temporaryPath, filePath);
+			syncDurableDirectory(dirname(filePath));
+			published = true;
+		} catch (error) {
+			if (!isAlreadyExistsError(error)) throw error;
+		}
+	} catch (error) {
+		operationFailed = true;
+		operationError = error;
+	}
+	let cleanupError;
+	try {
+		unlinkSync(temporaryPath);
+	} catch (error) {
+		if (!isNoEntryError(error)) cleanupError = error;
+	}
+	if (operationFailed) throw operationError;
+	if (cleanupError !== void 0) throw cleanupError;
+	return published;
+}
+/** Fsync a directory after publishing a durable file entry. */
+function syncDurableDirectory(directoryPath) {
+	const fd = openSync(directoryPath, "r");
+	try {
+		fsyncSync(fd);
+	} finally {
+		closeSync(fd);
+	}
+}
+/** Fsync one durable file after its contents reach stable storage. */
+function syncDurableFile(filePath, exactMode) {
+	const fd = openSync(filePath, "r");
+	try {
+		if (exactMode !== void 0 && process.platform !== "win32") fchmodSync(fd, exactMode);
+		fsyncSync(fd);
+	} finally {
+		closeSync(fd);
+	}
+}
+/** Append one record with O_APPEND, then fsync the file and containing directory. */
+function appendDurableFile(filePath, content, options = {}) {
+	fenceRunWrite(() => appendDurableFileUnchecked(filePath, content, options));
+}
+function appendDurableFileUnchecked(filePath, content, options = {}) {
+	const flags = constants.O_APPEND | constants.O_CREAT | constants.O_WRONLY | (typeof constants.O_NOFOLLOW === "number" ? constants.O_NOFOLLOW : 0);
+	const fd = openSync(filePath, flags, options.mode ?? 384);
+	try {
+		if (process.platform !== "win32") fchmodSync(fd, options.mode ?? 384);
+		const expectedBytes = Buffer.byteLength(content, "utf8");
+		const writtenBytes = writeSync(fd, content, void 0, "utf8");
+		if (writtenBytes !== expectedBytes) throw new Error(`durable append wrote ${writtenBytes} of ${expectedBytes} bytes to '${filePath}'`);
+		fsyncSync(fd);
+	} finally {
+		closeSync(fd);
+	}
+	syncDurableDirectory(dirname(filePath));
+}
+/** Reject a path that escapes its run directory or traverses a symbolic link. */
+function assertNoSymlinkDescendant(root, target, label = "path") {
+	const base = resolve(root);
+	const exact = resolve(target);
+	const rel = relative(base, exact);
+	if (rel === ".." || rel.startsWith(`..${process.platform === "win32" ? "\\" : "/"}`)) throw new Error(`${label} path escapes its run directory`);
+	if (existsSync(base) && lstatSync(base).isSymbolicLink()) throw new Error(`${label} path contains a symbolic link: ${base}`);
+	let current = base;
+	for (const part of rel.split(/[\\/]/u).filter(Boolean)) {
+		current = join(current, part);
+		if (!existsSync(current)) continue;
+		if (lstatSync(current).isSymbolicLink()) throw new Error(`${label} path contains a symbolic link: ${current}`);
+	}
+}
+/** Write, fsync, atomically replace, and fsync one Runtime-owned state file.
+* preserveMode retains ordinary access permissions despite the current umask; a new
+* file keeps normal creation semantics. Callers still own path validation and write exclusion. */
+function writeAtomicDurableFile(filePath, content, options = {}) {
+	fenceRunWrite(() => writeAtomicDurableFileUnchecked(filePath, content, options));
+}
+function writeAtomicDurableFileUnchecked(filePath, content, options = {}) {
+	const temporaryPath = `${filePath}.${randomUUID()}.tmp`;
+	let operationFailed = false;
+	let operationError;
+	try {
+		let mode = options.mode;
+		let exactMode = false;
+		if (options.preserveMode) try {
+			mode = statSync(filePath).mode & 511;
+			exactMode = true;
+		} catch (error) {
+			if (!isNoEntryError(error)) throw error;
+		}
+		writeExclusiveDurableFile(temporaryPath, content, { mode }, exactMode);
+		renameSync(temporaryPath, filePath);
+		syncDurableDirectory(dirname(filePath));
+	} catch (error) {
+		operationFailed = true;
+		operationError = error;
+	}
+	let cleanupError;
+	try {
+		unlinkSync(temporaryPath);
+	} catch (error) {
+		if (!isNoEntryError(error)) cleanupError = error;
+	}
+	if (operationFailed) throw operationError;
+	if (cleanupError !== void 0) throw cleanupError;
+}
+function writeExclusiveDurableFile(filePath, content, options, exactMode = false) {
+	const fd = openSync(filePath, "wx", options.mode ?? 438);
+	try {
+		const text = typeof content === "string" ? content : content(fstatSync(fd, { bigint: true }));
+		writeFileSync(fd, text, "utf8");
+	} finally {
+		closeSync(fd);
+	}
+	syncDurableFile(filePath, exactMode ? options.mode : void 0);
+}
+function isAlreadyExistsError(error) {
+	return error !== null && typeof error === "object" && "code" in error && error.code === "EEXIST";
+}
+function isNoEntryError(error) {
+	return error !== null && typeof error === "object" && "code" in error && error.code === "ENOENT";
+}
+export { writeAtomicDurableFile as a, mutateRunClaim as c, syncDurableDirectory as i, runGenerationPath as l, assertNoSymlinkDescendant as n, captureRunWriteContext as o, publishExclusiveDurableFile as r, fenceRunWrite as s, appendDurableFile as t, runWithWriteClaim as u };
+
+//# sourceMappingURL=durable-file-DstVeHcj.js.map

package/dist/durable-file-DstVeHcj.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"durable-file-DstVeHcj.js","names":["fsConstants"],"sources":["../src/durable/run-fence.ts","../src/runtime/supervise/durable-file.ts"],"sourcesContent":["import { AsyncLocalStorage } from 'node:async_hooks'\nimport { closeSync, existsSync, fstatSync, openSync, readFileSync } from 'node:fs'\nimport { resolve } from 'node:path'\nimport { tryAcquireAtomicFileLock } from '@tangle-network/agent-eval/ledger-core'\nimport type { LockIdentity } from '@tangle-network/agent-eval/lock-holder'\n\n/** The immutable claim carried by every write in one directory execution. @internal */\nexport interface RunWriteClaim {\n  readonly path: string\n  readonly generation: number\n  readonly lock: LockIdentity\n}\n\nconst claims = new AsyncLocalStorage<RunWriteClaim | undefined>()\nconst publications = new AsyncLocalStorage<{ readonly claim: RunWriteClaim; active: boolean }>()\n\n/** Bind asynchronous work, including callbacks, to the generation that admitted it. @internal */\nexport function runWithWriteClaim<T>(claim: RunWriteClaim, operation: () => T): T {\n  return claims.run(claim, operation)\n}\n\n/** Capture a store's acquisition once, even when later called from an unrelated emitter. @internal */\nexport function captureRunWriteContext(): <T>(operation: () => T) => T {\n  let claim = claims.getStore()\n  return <T>(operation: () => T): T => {\n    claim ??= claims.getStore()\n    return claims.run(claim, operation)\n  }\n}\n\n/** Serialize claim changes and file mutations under the same cross-process guard. @internal */\nexport function mutateRunClaim<T>(path: string, operation: () => T): T {\n  // Old writers use an unowned directory guard. Never race one or guess that it is stale.\n  const legacyGuard = `${path}.guard`\n  if (existsSync(legacyGuard)) {\n    throw new Error(\n      `supervisePursuit: cannot mutate ${path}; inspect ${legacyGuard} and remove it only after confirming no lock mutation is active`,\n    )\n  }\n  const deadline = performance.now() + 5_000\n  const sleeper = new Int32Array(new SharedArrayBuffer(4))\n  for (;;) {\n    const acquisition = tryAcquireAtomicFileLock({ lockPath: `${path}.mutation` })\n    if (acquisition.acquired) {\n      try {\n        return operation()\n      } finally {\n        acquisition.lock.release()\n      }\n    }\n    if (performance.now() >= deadline) throw new Error(`run directory mutation is held: ${path}`)\n    Atomics.wait(sleeper, 0, 0, 10)\n  }\n}\n\n/**\n * Fence an actual file mutation, not an earlier advisory check. No await occurs between the\n * ownership check and publication, and acquire/release use this same guard. Unclaimed standalone\n * stores retain their existing single-writer contract; pursuit-owned work always carries a claim.\n * @internal\n */\nexport function fenceRunWrite<T>(operation: () => T): T {\n  const claim = claims.getStore()\n  if (claim === undefined) return operation()\n  const publication = publications.getStore()\n  if (\n    publication?.active &&\n    publication.claim.path === claim.path &&\n    publication.claim.generation === claim.generation\n  )\n    return operation()\n  return mutateRunClaim(claim.path, () => {\n    let holder: Partial<RunWriteClaim> | undefined\n    try {\n      const fd = openSync(claim.path, 'r')\n      try {\n        const stat = fstatSync(fd, { bigint: true })\n        if (\n          stat.dev.toString() !== claim.lock.dev ||\n          stat.ino.toString() !== claim.lock.ino ||\n          stat.birthtimeNs.toString() !== claim.lock.birthtimeNs\n        ) {\n          throw new Error('run lock inode changed')\n        }\n        holder = JSON.parse(readFileSync(fd, 'utf8')) as Partial<RunWriteClaim>\n      } finally {\n        closeSync(fd)\n      }\n    } catch (cause) {\n      throw new Error(`run directory generation ${claim.generation} lost its claim`, { cause })\n    }\n    if (\n      holder?.generation !== claim.generation ||\n      holder.lock?.dev !== claim.lock.dev ||\n      holder.lock?.ino !== claim.lock.ino ||\n      holder.lock?.birthtimeNs !== claim.lock.birthtimeNs\n    ) {\n      throw new Error(`run directory generation ${claim.generation} lost its claim`)\n    }\n    // Nested synchronous primitives share the guard. A callback queued here keeps its claim,\n    // but cannot inherit a live guard after this publication has returned.\n    const publication = { claim, active: true }\n    try {\n      return publications.run(publication, operation)\n    } finally {\n      publication.active = false\n    }\n  })\n}\n\n/** Persistent generation counter survives a clean release of supervise.lock. @internal */\nexport function runGenerationPath(runDir: string): string {\n  return resolve(runDir, 'supervise.generation')\n}\n","/**\n * Small filesystem durability primitives for Runtime-owned state.\n *\n * Callers must validate their path and parent directory before invoking these functions.\n * The exclusive writer protects a no-clobber publication race; the atomic writer replaces one\n * state file after its temporary contents reach stable storage.\n *\n * @internal\n */\n\nimport { randomUUID } from 'node:crypto'\nimport {\n  type BigIntStats,\n  closeSync,\n  existsSync,\n  fchmodSync,\n  constants as fsConstants,\n  fstatSync,\n  fsyncSync,\n  linkSync,\n  lstatSync,\n  openSync,\n  renameSync,\n  statSync,\n  unlinkSync,\n  writeFileSync,\n  writeSync,\n} from 'node:fs'\nimport { dirname, join, relative, resolve } from 'node:path'\nimport { fenceRunWrite } from '../../durable/run-fence'\n\ninterface DurableFileOptions {\n  readonly mode?: number\n}\n\n/**\n * File content, or content computed from the new file's own stat when it must name the file's\n * inode (a lock record that later proves it was written for this very file).\n */\ntype DurableFileContent = string | ((file: BigIntStats) => string)\n\n/**\n * Publish a new file without replacing a concurrent winner. The published entry is a hard link\n * of the temporary file, so a content function sees the published file's inode.\n */\nexport function publishExclusiveDurableFile(\n  filePath: string,\n  content: DurableFileContent,\n  options: DurableFileOptions = {},\n): boolean {\n  return fenceRunWrite(() => publishExclusiveDurableFileUnchecked(filePath, content, options))\n}\n\nfunction publishExclusiveDurableFileUnchecked(\n  filePath: string,\n  content: DurableFileContent,\n  options: DurableFileOptions = {},\n): boolean {\n  const temporaryPath = `${filePath}.${randomUUID()}.tmp`\n  let operationFailed = false\n  let operationError: unknown\n  let published = false\n  try {\n    writeExclusiveDurableFile(temporaryPath, content, options)\n    try {\n      linkSync(temporaryPath, filePath)\n      syncDurableDirectory(dirname(filePath))\n      published = true\n    } catch (error) {\n      if (!isAlreadyExistsError(error)) throw error\n    }\n  } catch (error) {\n    operationFailed = true\n    operationError = error\n  }\n  let cleanupError: unknown\n  try {\n    unlinkSync(temporaryPath)\n  } catch (error) {\n    if (!isNoEntryError(error)) cleanupError = error\n  }\n  if (operationFailed) throw operationError\n  if (cleanupError !== undefined) throw cleanupError\n  return published\n}\n\n/** Fsync a directory after publishing a durable file entry. */\nexport function syncDurableDirectory(directoryPath: string): void {\n  const fd = openSync(directoryPath, 'r')\n  try {\n    fsyncSync(fd)\n  } finally {\n    closeSync(fd)\n  }\n}\n\n/** Fsync one durable file after its contents reach stable storage. */\nfunction syncDurableFile(filePath: string, exactMode?: number): void {\n  const fd = openSync(filePath, 'r')\n  try {\n    if (exactMode !== undefined && process.platform !== 'win32') fchmodSync(fd, exactMode)\n    fsyncSync(fd)\n  } finally {\n    closeSync(fd)\n  }\n}\n\n/** Append one record with O_APPEND, then fsync the file and containing directory. */\nexport function appendDurableFile(\n  filePath: string,\n  content: string,\n  options: DurableFileOptions = {},\n): void {\n  fenceRunWrite(() => appendDurableFileUnchecked(filePath, content, options))\n}\n\nfunction appendDurableFileUnchecked(\n  filePath: string,\n  content: string,\n  options: DurableFileOptions = {},\n): void {\n  const flags =\n    fsConstants.O_APPEND |\n    fsConstants.O_CREAT |\n    fsConstants.O_WRONLY |\n    (typeof fsConstants.O_NOFOLLOW === 'number' ? fsConstants.O_NOFOLLOW : 0)\n  const fd = openSync(filePath, flags, options.mode ?? 0o600)\n  try {\n    if (process.platform !== 'win32') fchmodSync(fd, options.mode ?? 0o600)\n    const expectedBytes = Buffer.byteLength(content, 'utf8')\n    const writtenBytes = writeSync(fd, content, undefined, 'utf8')\n    if (writtenBytes !== expectedBytes) {\n      throw new Error(\n        `durable append wrote ${writtenBytes} of ${expectedBytes} bytes to '${filePath}'`,\n      )\n    }\n    fsyncSync(fd)\n  } finally {\n    closeSync(fd)\n  }\n  syncDurableDirectory(dirname(filePath))\n}\n\n/** Reject a path that escapes its run directory or traverses a symbolic link. */\nexport function assertNoSymlinkDescendant(root: string, target: string, label = 'path'): void {\n  const base = resolve(root)\n  const exact = resolve(target)\n  const rel = relative(base, exact)\n  if (rel === '..' || rel.startsWith(`..${process.platform === 'win32' ? '\\\\' : '/'}`)) {\n    throw new Error(`${label} path escapes its run directory`)\n  }\n  if (existsSync(base) && lstatSync(base).isSymbolicLink()) {\n    throw new Error(`${label} path contains a symbolic link: ${base}`)\n  }\n  let current = base\n  for (const part of rel.split(/[\\\\/]/u).filter(Boolean)) {\n    current = join(current, part)\n    if (!existsSync(current)) continue\n    if (lstatSync(current).isSymbolicLink()) {\n      throw new Error(`${label} path contains a symbolic link: ${current}`)\n    }\n  }\n}\n\n/** Write, fsync, atomically replace, and fsync one Runtime-owned state file.\n * preserveMode retains ordinary access permissions despite the current umask; a new\n * file keeps normal creation semantics. Callers still own path validation and write exclusion. */\nexport function writeAtomicDurableFile(\n  filePath: string,\n  content: string,\n  options: DurableFileOptions & { readonly preserveMode?: boolean } = {},\n): void {\n  fenceRunWrite(() => writeAtomicDurableFileUnchecked(filePath, content, options))\n}\n\nfunction writeAtomicDurableFileUnchecked(\n  filePath: string,\n  content: string,\n  options: DurableFileOptions & { readonly preserveMode?: boolean } = {},\n): void {\n  const temporaryPath = `${filePath}.${randomUUID()}.tmp`\n  let operationFailed = false\n  let operationError: unknown\n  try {\n    let mode = options.mode\n    let exactMode = false\n    if (options.preserveMode) {\n      try {\n        mode = statSync(filePath).mode & 0o777\n        exactMode = true\n      } catch (error) {\n        if (!isNoEntryError(error)) throw error\n      }\n    }\n    writeExclusiveDurableFile(temporaryPath, content, { mode }, exactMode)\n    renameSync(temporaryPath, filePath)\n    syncDurableDirectory(dirname(filePath))\n  } catch (error) {\n    operationFailed = true\n    operationError = error\n  }\n  let cleanupError: unknown\n  try {\n    unlinkSync(temporaryPath)\n  } catch (error) {\n    if (!isNoEntryError(error)) cleanupError = error\n    // A successful rename removes the temporary directory entry.\n  }\n  if (operationFailed) throw operationError\n  if (cleanupError !== undefined) throw cleanupError\n}\n\nfunction writeExclusiveDurableFile(\n  filePath: string,\n  content: DurableFileContent,\n  options: DurableFileOptions,\n  exactMode = false,\n): void {\n  const fd = openSync(filePath, 'wx', options.mode ?? 0o666)\n  try {\n    const text = typeof content === 'string' ? content : content(fstatSync(fd, { bigint: true }))\n    writeFileSync(fd, text, 'utf8')\n  } finally {\n    closeSync(fd)\n  }\n  syncDurableFile(filePath, exactMode ? options.mode : undefined)\n}\n\nfunction isAlreadyExistsError(error: unknown): boolean {\n  return (\n    error !== null &&\n    typeof error === 'object' &&\n    'code' in error &&\n    (error as { code?: unknown }).code === 'EEXIST'\n  )\n}\n\nfunction isNoEntryError(error: unknown): boolean {\n  return (\n    error !== null &&\n    typeof error === 'object' &&\n    'code' in error &&\n    (error as { code?: unknown }).code === 'ENOENT'\n  )\n}\n"],"mappings":"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"}

package/dist/durable.d.ts

@@ -1,4 +1,4 @@
-import { $d as SeatSelectionInput, $u as observerRecordDigest, Ad as RUN_FORK_CORRELATION_KEYS, Au as SuperviseGraphPursuitOptions, Bu as PursuitNodePlatform, Cu as PursuitVersionChain, D as RetainedPendingCause, Dp as CoordinationPublicAddress, Du as VersionJudge, Eh as ToolLoopCompactionOptions, Eu as SettledPursuitVersion, Fd as AuthorizedSpawn, Ff as readRootStream, Fu as supervisePursuit, Gu as PursuitRunProjection, Hf as DriveHarnessOwnerContext, Hu as PursuitNodeTiming, Id as AuthorizedSpawnContext, If as readRootStreamReceipt, Iu as RunReopen, Ju as projectPursuit, Ku as PursuitRunTotals, Lu as PursuitObserverDelivery, Mp as CoordinationRejectReason, Mu as SupervisePursuitOptions, Nu as SupervisedPursuitResult, Op as CoordinationReadAccess, Ou as VersionVerdict, Pf as RootStreamRecord, Pu as superviseGraphPursuit, Qd as SeatSelection, Qf as ManagerWakePolicy, Qu as ObserverRecordKind, Qv as QuestionEscalationOutcome, Ru as PursuitCostProvenance, Su as NextPursuitVersionInput, Tu as PursuitVersions, Uu as PursuitNodeUsage, V as NodeId, Vu as PursuitNodeProjection, Wf as ResolveDriveHarness, Wu as PursuitProjection, Xu as ObserverJournal, Yu as FileObserverJournal, Yv as EscalateQuestion, Zu as ObserverRecord, _f as ParkedRun, _y as MapOnSettleRoute, bf as RunParkingRecord, bu as JudgedPursuitVersion, cy as AuthorizedDownMessage, dy as DownMessageAuthorizationInput, gf as DeadlineCheckIn, it as SupervisedResult, jp as CoordinationHttpAudit, ju as SupervisePursuitError, kd as PursuitFork, kp as CoordinationTransportOptions, ku as assertPursuitVersions, qu as PursuitStatus, rb as AnalyzeOnSettleRoute, rt as RootStreamReceipt, tf as SelectSeat, uy as ContinuityMode, vf as RunParkedError, wp as CoordinationAuthentication, wu as PursuitVersionStop, xf as readRunParking, xu as NextPursuitVersion, yf as RunParkingPolicy, zd as WorkerSlots, zu as PursuitNodeCost, zv as WorkerWatchOptions } from "./types-DTHxh4X9.js";
+import { $d as SeatSelectionInput, $u as observerRecordDigest, Ad as RUN_FORK_CORRELATION_KEYS, Au as SuperviseGraphPursuitOptions, Bu as PursuitNodePlatform, Cu as PursuitVersionChain, D as RetainedPendingCause, Dp as CoordinationPublicAddress, Du as VersionJudge, Eh as ToolLoopCompactionOptions, Eu as SettledPursuitVersion, Fd as AuthorizedSpawn, Ff as readRootStream, Fu as supervisePursuit, Gu as PursuitRunProjection, Hf as DriveHarnessOwnerContext, Hu as PursuitNodeTiming, Id as AuthorizedSpawnContext, If as readRootStreamReceipt, Iu as RunReopen, Ju as projectPursuit, Ku as PursuitRunTotals, Lu as PursuitObserverDelivery, Mp as CoordinationRejectReason, Mu as SupervisePursuitOptions, Nu as SupervisedPursuitResult, Op as CoordinationReadAccess, Ou as VersionVerdict, Pf as RootStreamRecord, Pu as superviseGraphPursuit, Qd as SeatSelection, Qf as ManagerWakePolicy, Qu as ObserverRecordKind, Qv as QuestionEscalationOutcome, Ru as PursuitCostProvenance, Su as NextPursuitVersionInput, Tu as PursuitVersions, Uu as PursuitNodeUsage, V as NodeId, Vu as PursuitNodeProjection, Wf as ResolveDriveHarness, Wu as PursuitProjection, Xu as ObserverJournal, Yu as FileObserverJournal, Yv as EscalateQuestion, Zu as ObserverRecord, _f as ParkedRun, _y as MapOnSettleRoute, bf as RunParkingRecord, bu as JudgedPursuitVersion, cy as AuthorizedDownMessage, dy as DownMessageAuthorizationInput, gf as DeadlineCheckIn, it as SupervisedResult, jp as CoordinationHttpAudit, ju as SupervisePursuitError, kd as PursuitFork, kp as CoordinationTransportOptions, ku as assertPursuitVersions, qu as PursuitStatus, rb as AnalyzeOnSettleRoute, rt as RootStreamReceipt, tf as SelectSeat, uy as ContinuityMode, vf as RunParkedError, wp as CoordinationAuthentication, wu as PursuitVersionStop, xf as readRunParking, xu as NextPursuitVersion, yf as RunParkingPolicy, zd as WorkerSlots, zu as PursuitNodeCost, zv as WorkerWatchOptions } from "./types-BfnQq-_k.js";
 import { n as RuntimeDecisionKind, r as RuntimeDecisionPoint, t as RuntimeDecisionEvidenceRef } from "./runtime-hooks-ZQqPw-0g.js";
 import { a as ChatTurnProducer, c as handleChatTurn, i as ChatTurnIdentity, n as ChatStreamEvent, o as ChatTurnResult, r as ChatTurnHooks, s as RunChatTurnInput, t as deriveExecutionId } from "./execution-handle-CujvqgCn.js";
 import { LockIdentity } from "@tangle-network/agent-eval/lock-holder";

package/dist/durable.js

@@ -1,14 +1,16 @@
-import { C as runGenerationPath, D as runtimeFailureCause, S as mutateRunClaim, Tt as assertValidBudget, _ as publishExclusiveDurableFile, a as isNoEntError, rt as contentAddress, t as FileSpawnJournal, v as syncDurableDirectory, w as runWithWriteClaim, x as fenceRunWrite, y as writeAtomicDurableFile } from "./journal-store-BJPMUydp.js";
-import { Jr as authoredProfileDigest, i as RunParkedError, lr as failedItems, pt as loadSpawnForest, r as assertResumeLimits, s as readRunParking, ur as isFiniteNumber } from "./supervisor-hHU3ZJnR.js";
+import { cr as failedItems, i as RunParkedError, lr as isFiniteNumber, pt as loadSpawnForest, qr as authoredProfileDigest, r as assertResumeLimits, s as readRunParking } from "./supervisor-L7u3pQ1j.js";
 import { f as RuntimeRunStateError, m as ValidationError } from "./errors-AzSuGI23.js";
-import { c as errorMessage } from "./util-ebWMWzY0.js";
+import { c as errorMessage } from "./util-BX20UJ9X.js";
+import { H as contentAddress, d as createFileObserverHooks, f as observerRecordDigest, h as runtimeFailureCause, nt as assertValidBudget, t as FileSpawnJournal, u as FileObserverJournal } from "./journal-store-BpCOCDoO.js";
+import { n as isNoEntError } from "./jsonl-file-BBP9Dz9w.js";
+import { a as writeAtomicDurableFile, c as mutateRunClaim, i as syncDurableDirectory, l as runGenerationPath, r as publishExclusiveDurableFile, s as fenceRunWrite, u as runWithWriteClaim } from "./durable-file-DstVeHcj.js";
 import { a as withPursuitContext, t as composeRuntimeHooks } from "./runtime-hooks-CsW2pfFk.js";
-import { a as applyExactAgentProfileDiff } from "./profile-C01SQZKa.js";
-import { a as superviseRootProfile, gt as readRootStreamReceipt, ht as readRootStream, t as supervise } from "./supervise-BXw89Ajc.js";
-import { a as runCancelRequestFile, o as runCancellationFile, v as supervisorRunDir, x as workerCancellationsDir } from "./run-cancellation-CoJRKvih.js";
-import { a as graphExecutionOptions, i as superviseAgentGraph } from "./graph-D6FL1xze.js";
+import { a as applyExactAgentProfileDiff } from "./profile-Dir2A1_2.js";
+import { J as readRootStreamReceipt, a as superviseRootProfile, q as readRootStream, t as supervise } from "./supervise-Cl0F57m9.js";
+import { a as runCancelRequestFile, o as runCancellationFile, v as supervisorRunDir, x as workerCancellationsDir } from "./run-cancellation-Cpm-BIUu.js";
+import { a as graphExecutionOptions, i as superviseAgentGraph } from "./graph-CM-6CV_K.js";
 import { n as handleChatTurn, t as deriveExecutionId } from "./execution-handle-Bd2_nUB6.js";
-import { a as observerRecordDigest, i as createFileObserverHooks, n as projectPursuit, r as FileObserverJournal, t as discoverDurableSupervisionRun } from "./supervision-discovery-CewADdEs.js";
+import { n as projectPursuit, t as discoverDurableSupervisionRun } from "./supervision-discovery-C3t0Xw-T.js";
 import { agentProfileSchema, canonicalAgentProfileDigest, canonicalCandidateDigest, canonicalCandidateJson, sha256Bytes } from "@tangle-network/agent-interface";
 import { closeSync, existsSync, fstatSync, mkdirSync, openSync, readFileSync, readdirSync, renameSync, unlinkSync } from "node:fs";
 import { basename, dirname, isAbsolute, join, relative, resolve, sep } from "node:path";