@agimon-ai/doompi-core 0.0.1-alpha.100

package/dist/historyOwnership.mjs

@@ -0,0 +1,247 @@
+import { randomUUID } from "node:crypto";
+import fs from "node:fs";
+import path from "node:path";
+//#region src/services/historyOwnership/index.ts
+const LOCK_SUFFIX = ".doompi-v4.lock";
+const LOCK_VERSION = 1;
+const LOCK_FORMAT = "doompi-v4-history-ownership";
+function canonicalSourcePath(sourcePath) {
+	const absolute = path.resolve(sourcePath);
+	if (fs.existsSync(absolute)) return fs.realpathSync(absolute);
+	const segments = [path.basename(absolute)];
+	let parent = path.dirname(absolute);
+	while (!fs.existsSync(parent)) {
+		segments.unshift(path.basename(parent));
+		parent = path.dirname(parent);
+	}
+	return path.join(fs.realpathSync(parent), ...segments);
+}
+/** Resolve aliases so every writer and exporter contends for the same lock. */
+function historyOwnershipLockPath(sourcePath) {
+	return `${canonicalSourcePath(sourcePath)}${LOCK_SUFFIX}`;
+}
+function isHistoryObject(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isV4Header(value) {
+	return isHistoryObject(value) && value.kind === "header" && value.v === 4;
+}
+function isV3Header(value) {
+	return isHistoryObject(value) && value.type === "session" && value.version === 3;
+}
+function readHeader(sourcePath, format) {
+	const firstLine = fs.readFileSync(sourcePath, "utf8").split("\n", 1)[0] ?? "";
+	try {
+		return JSON.parse(firstLine);
+	} catch (error) {
+		const message = format === "v4" ? `History ownership source is not canonical v4 JSONL: ${sourcePath}` : `Offline history source is not canonical v3 JSONL: ${sourcePath}`;
+		throw new Error(message, { cause: error });
+	}
+}
+function assertIndependentRegularFile(sourcePath, label) {
+	const stat = fs.statSync(sourcePath);
+	if (!stat.isFile() || stat.nlink !== 1) throw new Error(`${label} must be an independent regular file`);
+}
+function assertV4Source(sourcePath) {
+	if (!fs.existsSync(sourcePath)) return;
+	assertIndependentRegularFile(sourcePath, "Canonical history");
+	if (!isV4Header(readHeader(sourcePath, "v4"))) throw new Error(`History ownership only supports canonical v4 sources: ${sourcePath}`);
+}
+function assertV3Source(sourcePath) {
+	if (!fs.existsSync(sourcePath)) return;
+	assertIndependentRegularFile(sourcePath, "Offline v3 history source");
+	if (!isV3Header(readHeader(sourcePath, "v3"))) throw new Error(`Offline history import only supports v3 sources: ${sourcePath}`);
+}
+function assertSqliteSource(sourcePath) {
+	if (!fs.existsSync(sourcePath)) return;
+	assertIndependentRegularFile(sourcePath, "SQLite history");
+	const descriptor = fs.openSync(sourcePath, "r");
+	try {
+		const header = Buffer.alloc(16);
+		if (fs.readSync(descriptor, header, 0, header.length, 0) !== header.length || header.toString("utf8") !== "SQLite format 3\0") throw new Error(`History ownership source is not SQLite: ${sourcePath}`);
+	} finally {
+		fs.closeSync(descriptor);
+	}
+}
+function isFileSystemError(error) {
+	return error instanceof Error && typeof error.code === "string";
+}
+function readToken(lockPath) {
+	try {
+		const value = JSON.parse(fs.readFileSync(lockPath, "utf8"));
+		return typeof value.token === "string" ? value.token : void 0;
+	} catch {
+		return;
+	}
+}
+/** A dead owner is recoverable only when the entire lock record is recognizable. */
+function readRecoverableLock(lockPath, sourcePath) {
+	try {
+		const stat = fs.lstatSync(lockPath);
+		if (!stat.isFile() || stat.nlink !== 1) return void 0;
+		const value = JSON.parse(fs.readFileSync(lockPath, "utf8"));
+		if (!isHistoryObject(value) || value.version !== LOCK_VERSION || value.format !== LOCK_FORMAT || value.sourcePath !== sourcePath || !Number.isSafeInteger(value.pid) || value.pid <= 0 || typeof value.token !== "string" || !/^[\da-f]{8}(?:-[\da-f]{4}){3}-[\da-f]{12}$/iu.test(value.token)) return void 0;
+		return value;
+	} catch {
+		return;
+	}
+}
+function ownerMayBeAlive(pid) {
+	try {
+		process.kill(pid, 0);
+		return true;
+	} catch (error) {
+		return !(isFileSystemError(error) && error.code === "ESRCH");
+	}
+}
+/** A guard left by a dead acquirer can be retired without touching its source lock. */
+function retireDeadGuard(guard) {
+	try {
+		if (!fs.lstatSync(guard).isDirectory()) return false;
+		const entries = fs.readdirSync(guard);
+		if (entries.length !== 1 || !/^owner-[\da-f-]{36}\.json$/iu.test(entries[0])) return false;
+		const marker = path.join(guard, entries[0]);
+		const markerStat = fs.lstatSync(marker);
+		if (!markerStat.isFile() || markerStat.nlink !== 1) return false;
+		const owner = JSON.parse(fs.readFileSync(marker, "utf8"));
+		if (!isHistoryObject(owner) || !Number.isSafeInteger(owner.pid) || owner.pid <= 0) return false;
+		if (ownerMayBeAlive(owner.pid)) return false;
+		fs.unlinkSync(marker);
+		fs.rmdirSync(guard);
+		return true;
+	} catch {
+		return false;
+	}
+}
+/** All new acquirers hold this guard until their ownership record is durable. */
+function withAcquisitionGuard(lockPath, acquire) {
+	const guard = `${lockPath}.recovery`;
+	try {
+		fs.mkdirSync(guard, { mode: 448 });
+	} catch (error) {
+		if (!isFileSystemError(error) || error.code !== "EEXIST" || !retireDeadGuard(guard)) throw error;
+		fs.mkdirSync(guard, { mode: 448 });
+	}
+	const marker = path.join(guard, `owner-${randomUUID()}.json`);
+	try {
+		fs.writeFileSync(marker, JSON.stringify({ pid: process.pid }), {
+			flag: "wx",
+			mode: 384
+		});
+		return acquire();
+	} finally {
+		fs.rmSync(marker, { force: true });
+		fs.rmdirSync(guard);
+	}
+}
+/** Called only under the acquisition guard, before publishing a new owner. */
+function recoverDeadOwner(lockPath, sourcePath) {
+	try {
+		const record = readRecoverableLock(lockPath, sourcePath);
+		if (!record || ownerMayBeAlive(record.pid)) return false;
+		const before = fs.lstatSync(lockPath);
+		if (readRecoverableLock(lockPath, sourcePath)?.token !== record.token || ownerMayBeAlive(record.pid)) return false;
+		const current = fs.lstatSync(lockPath);
+		if (before.dev !== current.dev || before.ino !== current.ino) return false;
+		fs.unlinkSync(lockPath);
+		return true;
+	} catch (error) {
+		if (isFileSystemError(error) && error.code === "ENOENT") return false;
+		throw error;
+	}
+}
+function releaseLock(lockPath, token, handle) {
+	fs.closeSync(handle);
+	if (readToken(lockPath) === token) fs.rmSync(lockPath, { force: true });
+}
+function createLease(locks, sourcePath, assertQuiescent) {
+	let released = false;
+	return {
+		assertQuiescent: () => {
+			if (released) throw new Error("History ownership lease has been released");
+			for (const lock of locks) {
+				const held = fs.fstatSync(lock.handle);
+				const current = fs.statSync(lock.lockPath);
+				if (held.dev !== current.dev || held.ino !== current.ino || readToken(lock.lockPath) !== lock.token) throw new Error("History ownership lock was replaced");
+			}
+			return assertQuiescent(sourcePath);
+		},
+		release: () => {
+			if (released) return;
+			released = true;
+			let firstError;
+			for (const lock of [...locks].reverse()) try {
+				releaseLock(lock.lockPath, lock.token, lock.handle);
+			} catch (error) {
+				firstError ??= error;
+			}
+			if (firstError !== void 0) throw firstError;
+		}
+	};
+}
+/**
+* Creates the canonical history owner used by runtime writers, export CLI, and
+* the explicit offline importer. The default source boundary remains v4.
+* Complete locks left by a dead process are recovered under an exclusive guard.
+* A live owner or an ambiguous sidecar still blocks acquisition.
+*/
+function createHistoryOwnership(options = {}) {
+	const assertQuiescent = options.assertQuiescent ?? (() => void 0);
+	const assertSource = options.sourceFormat === "sqlite" ? assertSqliteSource : options.sourceFormat === "v3" ? assertV3Source : assertV4Source;
+	return { async acquire(sourcePath) {
+		const absoluteSourcePath = canonicalSourcePath(sourcePath);
+		const paths = [absoluteSourcePath, ...options.additionalPaths ?? []].map(canonicalSourcePath);
+		const canonicalPaths = [...new Set(paths)].sort((left, right) => left.localeCompare(right));
+		const locks = [];
+		let conflictingLockPath = historyOwnershipLockPath(absoluteSourcePath);
+		try {
+			for (const lockedPath of canonicalPaths) {
+				const lockPath = historyOwnershipLockPath(lockedPath);
+				conflictingLockPath = lockPath;
+				const token = randomUUID();
+				const record = {
+					version: LOCK_VERSION,
+					format: LOCK_FORMAT,
+					pid: process.pid,
+					sourcePath: lockedPath,
+					token
+				};
+				fs.mkdirSync(path.dirname(lockPath), {
+					recursive: true,
+					mode: 448
+				});
+				withAcquisitionGuard(lockPath, () => {
+					let handle;
+					try {
+						handle = fs.openSync(lockPath, "wx", 384);
+					} catch (error) {
+						if (!isFileSystemError(error) || error.code !== "EEXIST" || !recoverDeadOwner(lockPath, lockedPath)) throw error;
+						handle = fs.openSync(lockPath, "wx", 384);
+					}
+					const lock = {
+						lockPath,
+						token,
+						handle
+					};
+					locks.push(lock);
+					fs.writeFileSync(handle, `${JSON.stringify(record)}\n`, "utf8");
+					fs.fsyncSync(handle);
+				});
+			}
+			assertSource(absoluteSourcePath);
+		} catch (error) {
+			for (const lock of [...locks].reverse()) try {
+				releaseLock(lock.lockPath, lock.token, lock.handle);
+			} catch {}
+			if (isFileSystemError(error) && error.code === "EEXIST") throw new Error(`History ownership lock already exists or is ambiguous: ${conflictingLockPath}`, { cause: error });
+			throw error;
+		}
+		return createLease(locks, absoluteSourcePath, assertQuiescent);
+	} };
+}
+/** Explicitly named alias for hosts that want to document the v4 boundary. */
+const createV4HistoryOwnership = createHistoryOwnership;
+//#endregion
+export { createHistoryOwnership, createV4HistoryOwnership, historyOwnershipLockPath };
+
+//# sourceMappingURL=historyOwnership.mjs.map

package/dist/historyOwnership.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"historyOwnership.mjs","names":[],"sources":["../src/services/historyOwnership/index.ts"],"sourcesContent":["import { randomUUID } from 'node:crypto';\nimport fs from 'node:fs';\nimport path from 'node:path';\n\nimport type { HistoryOwnership, HistoryOwnershipLease } from '../historyImport';\n\nconst LOCK_SUFFIX = '.doompi-v4.lock';\nconst LOCK_VERSION = 1;\nconst LOCK_FORMAT = 'doompi-v4-history-ownership';\n\ninterface HistoryLockRecord {\n  version: 1;\n  format: 'doompi-v4-history-ownership';\n  pid: number;\n  sourcePath: string;\n  token: string;\n}\n\ninterface HeldHistoryLock {\n  lockPath: string;\n  token: string;\n  handle: number;\n}\n\nexport interface HistoryOwnershipOptions {\n  /** Checks managed writers; this cannot account for an unmanaged Pi process. */\n  assertQuiescent?: (sourcePath: string) => void | Promise<void>;\n  /** The source format admitted by this owner. Defaults to canonical v4. */\n  sourceFormat?: 'v3' | 'v4' | 'sqlite';\n  /** Additional paths to lock for the lifetime of each acquired source lease. */\n  additionalPaths?: readonly string[];\n}\n\nfunction canonicalSourcePath(sourcePath: string): string {\n  const absolute = path.resolve(sourcePath);\n  if (fs.existsSync(absolute)) return fs.realpathSync(absolute);\n  const segments = [path.basename(absolute)];\n  let parent = path.dirname(absolute);\n  while (!fs.existsSync(parent)) {\n    segments.unshift(path.basename(parent));\n    parent = path.dirname(parent);\n  }\n  return path.join(fs.realpathSync(parent), ...segments);\n}\n\n/** Resolve aliases so every writer and exporter contends for the same lock. */\nexport function historyOwnershipLockPath(sourcePath: string): string {\n  return `${canonicalSourcePath(sourcePath)}${LOCK_SUFFIX}`;\n}\n\nfunction isHistoryObject(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\nfunction isV4Header(value: unknown): boolean {\n  return isHistoryObject(value) && value.kind === 'header' && value.v === 4;\n}\n\nfunction isV3Header(value: unknown): boolean {\n  return isHistoryObject(value) && value.type === 'session' && value.version === 3;\n}\n\nfunction readHeader(sourcePath: string, format: 'v3' | 'v4'): unknown {\n  const firstLine = fs.readFileSync(sourcePath, 'utf8').split('\\n', 1)[0] ?? '';\n  try {\n    return JSON.parse(firstLine);\n  } catch (error) {\n    const message =\n      format === 'v4'\n        ? `History ownership source is not canonical v4 JSONL: ${sourcePath}`\n        : `Offline history source is not canonical v3 JSONL: ${sourcePath}`;\n    throw new Error(message, { cause: error });\n  }\n}\n\nfunction assertIndependentRegularFile(sourcePath: string, label: string): void {\n  const stat = fs.statSync(sourcePath);\n  if (!stat.isFile() || stat.nlink !== 1) throw new Error(`${label} must be an independent regular file`);\n}\n\nfunction assertV4Source(sourcePath: string): void {\n  if (!fs.existsSync(sourcePath)) return;\n  assertIndependentRegularFile(sourcePath, 'Canonical history');\n  if (!isV4Header(readHeader(sourcePath, 'v4')))\n    throw new Error(`History ownership only supports canonical v4 sources: ${sourcePath}`);\n}\n\nfunction assertV3Source(sourcePath: string): void {\n  if (!fs.existsSync(sourcePath)) return;\n  assertIndependentRegularFile(sourcePath, 'Offline v3 history source');\n  if (!isV3Header(readHeader(sourcePath, 'v3')))\n    throw new Error(`Offline history import only supports v3 sources: ${sourcePath}`);\n}\n\nfunction assertSqliteSource(sourcePath: string): void {\n  if (!fs.existsSync(sourcePath)) return;\n  assertIndependentRegularFile(sourcePath, 'SQLite history');\n  const descriptor = fs.openSync(sourcePath, 'r');\n  try {\n    const header = Buffer.alloc(16);\n    if (\n      fs.readSync(descriptor, header, 0, header.length, 0) !== header.length ||\n      header.toString('utf8') !== 'SQLite format 3\\u0000'\n    )\n      throw new Error(`History ownership source is not SQLite: ${sourcePath}`);\n  } finally {\n    fs.closeSync(descriptor);\n  }\n}\n\nfunction isFileSystemError(error: unknown): error is NodeJS.ErrnoException {\n  return error instanceof Error && typeof (error as NodeJS.ErrnoException).code === 'string';\n}\n\nfunction readToken(lockPath: string): string | undefined {\n  try {\n    const value = JSON.parse(fs.readFileSync(lockPath, 'utf8')) as Partial<HistoryLockRecord>;\n    return typeof value.token === 'string' ? value.token : undefined;\n  } catch {\n    return undefined;\n  }\n}\n\n/** A dead owner is recoverable only when the entire lock record is recognizable. */\nfunction readRecoverableLock(lockPath: string, sourcePath: string): HistoryLockRecord | undefined {\n  try {\n    const stat = fs.lstatSync(lockPath);\n    if (!stat.isFile() || stat.nlink !== 1) return undefined;\n    const value: unknown = JSON.parse(fs.readFileSync(lockPath, 'utf8'));\n    if (\n      !isHistoryObject(value) ||\n      value.version !== LOCK_VERSION ||\n      value.format !== LOCK_FORMAT ||\n      value.sourcePath !== sourcePath ||\n      !Number.isSafeInteger(value.pid) ||\n      (value.pid as number) <= 0 ||\n      typeof value.token !== 'string' ||\n      !/^[\\da-f]{8}(?:-[\\da-f]{4}){3}-[\\da-f]{12}$/iu.test(value.token)\n    )\n      return undefined;\n    return value as unknown as HistoryLockRecord;\n  } catch {\n    return undefined;\n  }\n}\n\nfunction ownerMayBeAlive(pid: number): boolean {\n  try {\n    process.kill(pid, 0);\n    return true;\n  } catch (error) {\n    return !(isFileSystemError(error) && error.code === 'ESRCH');\n  }\n}\n/** A guard left by a dead acquirer can be retired without touching its source lock. */\nfunction retireDeadGuard(guard: string): boolean {\n  try {\n    const stat = fs.lstatSync(guard);\n    if (!stat.isDirectory()) return false;\n    const entries = fs.readdirSync(guard);\n    // An empty guard might still belong to a process killed between mkdir and\n    // publishing its marker. Fail closed rather than race a new acquirer.\n    if (entries.length !== 1 || !/^owner-[\\da-f-]{36}\\.json$/iu.test(entries[0]!)) return false;\n    const marker = path.join(guard, entries[0]!);\n    const markerStat = fs.lstatSync(marker);\n    if (!markerStat.isFile() || markerStat.nlink !== 1) return false;\n    const owner: unknown = JSON.parse(fs.readFileSync(marker, 'utf8'));\n    if (!isHistoryObject(owner) || !Number.isSafeInteger(owner.pid) || (owner.pid as number) <= 0) return false;\n    if (ownerMayBeAlive(owner.pid as number)) return false;\n    // Only the process that unlinks this unique marker may retire the directory.\n    // Other cleaners see a newly empty guard and refuse to remove it.\n    fs.unlinkSync(marker);\n    fs.rmdirSync(guard);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\n/** All new acquirers hold this guard until their ownership record is durable. */\nfunction withAcquisitionGuard<T>(lockPath: string, acquire: () => T): T {\n  const guard = `${lockPath}.recovery`;\n  try {\n    fs.mkdirSync(guard, { mode: 0o700 });\n  } catch (error) {\n    if (!isFileSystemError(error) || error.code !== 'EEXIST' || !retireDeadGuard(guard)) throw error;\n    fs.mkdirSync(guard, { mode: 0o700 });\n  }\n  const marker = path.join(guard, `owner-${randomUUID()}.json`);\n  try {\n    fs.writeFileSync(marker, JSON.stringify({ pid: process.pid }), { flag: 'wx', mode: 0o600 });\n    return acquire();\n  } finally {\n    fs.rmSync(marker, { force: true });\n    fs.rmdirSync(guard);\n  }\n}\n\n/** Called only under the acquisition guard, before publishing a new owner. */\nfunction recoverDeadOwner(lockPath: string, sourcePath: string): boolean {\n  try {\n    const record = readRecoverableLock(lockPath, sourcePath);\n    if (!record || ownerMayBeAlive(record.pid)) return false;\n    const before = fs.lstatSync(lockPath);\n    if (readRecoverableLock(lockPath, sourcePath)?.token !== record.token || ownerMayBeAlive(record.pid)) return false;\n    const current = fs.lstatSync(lockPath);\n    if (before.dev !== current.dev || before.ino !== current.ino) return false;\n    // The owner is gone, and other recoverers cannot remove this lock while\n    // the guard is held. Legacy writers still contend on the exclusive wx open.\n    fs.unlinkSync(lockPath);\n    return true;\n  } catch (error) {\n    if (isFileSystemError(error) && error.code === 'ENOENT') return false;\n    throw error;\n  }\n}\n\nfunction releaseLock(lockPath: string, token: string, handle: number): void {\n  fs.closeSync(handle);\n  // Recovery only retires a lock after its recorded owner has exited, so that\n  // owner cannot be here releasing it concurrently. A replaced lock is ambiguous.\n  if (readToken(lockPath) === token) fs.rmSync(lockPath, { force: true });\n}\n\nfunction createLease(\n  locks: readonly HeldHistoryLock[],\n  sourcePath: string,\n  assertQuiescent: (sourcePath: string) => void | Promise<void>,\n): HistoryOwnershipLease {\n  let released = false;\n  return {\n    assertQuiescent: () => {\n      if (released) throw new Error('History ownership lease has been released');\n      for (const lock of locks) {\n        const held = fs.fstatSync(lock.handle);\n        const current = fs.statSync(lock.lockPath);\n        if (held.dev !== current.dev || held.ino !== current.ino || readToken(lock.lockPath) !== lock.token) {\n          throw new Error('History ownership lock was replaced');\n        }\n      }\n      return assertQuiescent(sourcePath);\n    },\n    release: () => {\n      if (released) return;\n      released = true;\n      let firstError: unknown;\n      for (const lock of [...locks].reverse()) {\n        try {\n          releaseLock(lock.lockPath, lock.token, lock.handle);\n        } catch (error) {\n          firstError ??= error;\n        }\n      }\n      if (firstError !== undefined) throw firstError;\n    },\n  };\n}\n\n/**\n * Creates the canonical history owner used by runtime writers, export CLI, and\n * the explicit offline importer. The default source boundary remains v4.\n * Complete locks left by a dead process are recovered under an exclusive guard.\n * A live owner or an ambiguous sidecar still blocks acquisition.\n */\nexport function createHistoryOwnership(options: HistoryOwnershipOptions = {}): HistoryOwnership {\n  const assertQuiescent = options.assertQuiescent ?? (() => undefined);\n  const assertSource =\n    options.sourceFormat === 'sqlite'\n      ? assertSqliteSource\n      : options.sourceFormat === 'v3'\n        ? assertV3Source\n        : assertV4Source;\n  return {\n    async acquire(sourcePath: string): Promise<HistoryOwnershipLease> {\n      const absoluteSourcePath = canonicalSourcePath(sourcePath);\n      const paths = [absoluteSourcePath, ...(options.additionalPaths ?? [])].map(canonicalSourcePath);\n      const canonicalPaths = [...new Set(paths)].sort((left, right) => left.localeCompare(right));\n      const locks: HeldHistoryLock[] = [];\n      let conflictingLockPath = historyOwnershipLockPath(absoluteSourcePath);\n      try {\n        for (const lockedPath of canonicalPaths) {\n          const lockPath = historyOwnershipLockPath(lockedPath);\n          conflictingLockPath = lockPath;\n          const token = randomUUID();\n          const record: HistoryLockRecord = {\n            version: LOCK_VERSION,\n            format: LOCK_FORMAT,\n            pid: process.pid,\n            sourcePath: lockedPath,\n            token,\n          };\n          fs.mkdirSync(path.dirname(lockPath), { recursive: true, mode: 0o700 });\n          withAcquisitionGuard(lockPath, () => {\n            let handle: number;\n            try {\n              handle = fs.openSync(lockPath, 'wx', 0o600);\n            } catch (error) {\n              if (!isFileSystemError(error) || error.code !== 'EEXIST' || !recoverDeadOwner(lockPath, lockedPath))\n                throw error;\n              handle = fs.openSync(lockPath, 'wx', 0o600);\n            }\n            const lock = { lockPath, token, handle };\n            locks.push(lock);\n            fs.writeFileSync(handle, `${JSON.stringify(record)}\\n`, 'utf8');\n            fs.fsyncSync(handle);\n          });\n        }\n        assertSource(absoluteSourcePath);\n      } catch (error) {\n        for (const lock of [...locks].reverse()) {\n          try {\n            releaseLock(lock.lockPath, lock.token, lock.handle);\n          } catch {\n            // Preserve the acquisition failure and never remove a replaced lock.\n          }\n        }\n        if (isFileSystemError(error) && error.code === 'EEXIST') {\n          throw new Error(`History ownership lock already exists or is ambiguous: ${conflictingLockPath}`, {\n            cause: error,\n          });\n        }\n        throw error;\n      }\n      return createLease(locks, absoluteSourcePath, assertQuiescent);\n    },\n  };\n}\n\n/** Explicitly named alias for hosts that want to document the v4 boundary. */\nexport const createV4HistoryOwnership = createHistoryOwnership;\n"],"mappings":"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"}

package/dist/hubChannel.cjs

@@ -0,0 +1,4 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_hubChannel = require("./src/schemas/hubChannel.cjs");
+exports.WORKFLOW_DISPATCHER_SESSION_PROVENANCE = require_hubChannel.WORKFLOW_DISPATCHER_SESSION_PROVENANCE;
+exports.WORKFLOW_STEP_SESSION_PROVENANCE = require_hubChannel.WORKFLOW_STEP_SESSION_PROVENANCE;

package/dist/hubChannel.d.mts

@@ -0,0 +1,2 @@
+import { DoomComputerUseHostBinding, DoomComputerUseHostOperation, DoomComputerUseHostRequest, DoomComputerUseSessionAccess, DoomDirectEventBus, DoomDirectEventSubscriptionOptions, DoomHubChannel, DoomHubChannelConnection, DoomHubChannelFrame, DoomHubChannelHost, DoomHubChannelLifecycle, DoomHubChannelSource, DoomHubReservedWorktreeProvisioner, DoomHubReservedWorktreeRequest, DoomHubSessionApiRequest, DoomHubSessionCreateRequest, DoomHubSessionPromptOptions, DoomHubSessionPromptReceipt, DoomHubSessionReservations, DoomHubSessionScope, DoomHubSessionSelection, DoomHubSessionService, DoomPendingSessionSetup, DoomSessionCommunicationEndpoint, DoomSessionContext, WORKFLOW_DISPATCHER_SESSION_PROVENANCE, WORKFLOW_STEP_SESSION_PROVENANCE } from "./src/schemas/hubChannel.mjs";
+export { DoomComputerUseHostBinding, DoomComputerUseHostOperation, DoomComputerUseHostRequest, DoomComputerUseSessionAccess, DoomDirectEventBus, DoomDirectEventSubscriptionOptions, DoomHubChannel, DoomHubChannelConnection, DoomHubChannelFrame, DoomHubChannelHost, DoomHubChannelLifecycle, DoomHubChannelSource, DoomHubReservedWorktreeProvisioner, DoomHubReservedWorktreeRequest, DoomHubSessionApiRequest, DoomHubSessionCreateRequest, DoomHubSessionPromptOptions, DoomHubSessionPromptReceipt, DoomHubSessionReservations, DoomHubSessionScope, DoomHubSessionSelection, DoomHubSessionService, DoomPendingSessionSetup, DoomSessionCommunicationEndpoint, DoomSessionContext, WORKFLOW_DISPATCHER_SESSION_PROVENANCE, WORKFLOW_STEP_SESSION_PROVENANCE };

package/dist/hubChannel.mjs

@@ -0,0 +1,2 @@
+import { WORKFLOW_DISPATCHER_SESSION_PROVENANCE, WORKFLOW_STEP_SESSION_PROVENANCE } from "./src/schemas/hubChannel.mjs";
+export { WORKFLOW_DISPATCHER_SESSION_PROVENANCE, WORKFLOW_STEP_SESSION_PROVENANCE };

package/dist/index.cjs

@@ -0,0 +1,44 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_askUser = require("./src/schemas/askUser.cjs");
+const require_narration = require("./src/schemas/narration.cjs");
+const require_notification = require("./src/schemas/notification.cjs");
+const require_sessionProtocol = require("./src/schemas/sessionProtocol.cjs");
+const require_runtimeProtocol = require("./runtimeProtocol.cjs");
+exports.AskUserBlockedEventSchema = require_askUser.AskUserBlockedEventSchema;
+exports.AskUserPromptEventSchema = require_askUser.AskUserPromptEventSchema;
+exports.AskUserPromptOptionSchema = require_askUser.AskUserPromptOptionSchema;
+exports.AskUserPromptQuestionSchema = require_askUser.AskUserPromptQuestionSchema;
+exports.DOOM_ASK_USER_BLOCKED_EVENT = require_askUser.DOOM_ASK_USER_BLOCKED_EVENT;
+exports.DOOM_ASK_USER_PROMPT_EVENT = require_askUser.DOOM_ASK_USER_PROMPT_EVENT;
+exports.DOOM_COCKPIT_SERVER_ID = require_sessionProtocol.DOOM_COCKPIT_SERVER_ID;
+exports.DOOM_NARRATION_SERVICE = require_narration.DOOM_NARRATION_SERVICE;
+exports.DOOM_NOTIFICATION_ENTRY_TYPE = require_notification.DOOM_NOTIFICATION_ENTRY_TYPE;
+exports.DOOM_NOTIFICATION_ENTRY_VERSION = require_notification.DOOM_NOTIFICATION_ENTRY_VERSION;
+exports.DOOM_NOTIFICATION_SERVICE = require_notification.DOOM_NOTIFICATION_SERVICE;
+exports.DOOM_SESSION_MANAGEMENT_SERVICE_ID = require_sessionProtocol.DOOM_SESSION_MANAGEMENT_SERVICE_ID;
+exports.DOOM_SESSION_SERVICE_ID = require_sessionProtocol.DOOM_SESSION_SERVICE_ID;
+exports.DoomHubService = require_sessionProtocol.DoomHubService;
+exports.DoomNotificationEntryDataSchema = require_notification.DoomNotificationEntryDataSchema;
+exports.DoomNotificationLevelSchema = require_notification.DoomNotificationLevelSchema;
+exports.DoomNotificationRequestSchema = require_notification.DoomNotificationRequestSchema;
+exports.DoomProtocolError = require_runtimeProtocol.DoomProtocolError;
+exports.DoomProtocolValidationError = require_runtimeProtocol.DoomProtocolValidationError;
+exports.DoomSessionManagementService = require_sessionProtocol.DoomSessionManagementService;
+exports.DoomSessionService = require_sessionProtocol.DoomSessionService;
+exports.MAX_DOOM_NOTIFICATION_BODY_CHARACTERS = require_notification.MAX_DOOM_NOTIFICATION_BODY_CHARACTERS;
+exports.MAX_DOOM_NOTIFICATION_SUBTITLE_CHARACTERS = require_notification.MAX_DOOM_NOTIFICATION_SUBTITLE_CHARACTERS;
+exports.MAX_DOOM_NOTIFICATION_TITLE_CHARACTERS = require_notification.MAX_DOOM_NOTIFICATION_TITLE_CHARACTERS;
+exports.MAX_NARRATION_TEXT_CHARACTERS = require_narration.MAX_NARRATION_TEXT_CHARACTERS;
+exports.NarrationRequestSchema = require_narration.NarrationRequestSchema;
+exports.createDoomNotificationEntryData = require_notification.createDoomNotificationEntryData;
+exports.createNarrationRequest = require_narration.createNarrationRequest;
+exports.createProtocolRuntime = require_runtimeProtocol.createProtocolRuntime;
+exports.isDoomNotificationEntryData = require_notification.isDoomNotificationEntryData;
+exports.isDoomNotificationRequest = require_notification.isDoomNotificationRequest;
+exports.isNarrationRequest = require_narration.isNarrationRequest;
+exports.normalizeDoomNotificationRequest = require_notification.normalizeDoomNotificationRequest;
+exports.normalizeNarrationText = require_narration.normalizeNarrationText;
+exports.readDoomNarrationService = require_narration.readDoomNarrationService;
+exports.readDoomNotificationService = require_notification.readDoomNotificationService;
+exports.requireDoomNarrationService = require_narration.requireDoomNarrationService;
+exports.requireDoomNotificationService = require_notification.requireDoomNotificationService;

package/dist/index.d.mts

@@ -0,0 +1,6 @@
+import { AskUserBlockedEvent, AskUserBlockedEventSchema, AskUserPromptEvent, AskUserPromptEventSchema, AskUserPromptOption, AskUserPromptOptionSchema, AskUserPromptQuestion, AskUserPromptQuestionSchema, DOOM_ASK_USER_BLOCKED_EVENT, DOOM_ASK_USER_PROMPT_EVENT } from "./src/schemas/askUser.mjs";
+import { AssistantTranscriptItem, ClearQueueResult, DOOM_COCKPIT_SERVER_ID, DOOM_SESSION_MANAGEMENT_SERVICE_ID, DOOM_SESSION_SERVICE_ID, DoomHubService, DoomSessionManagementService, DoomSessionService, ExtensionUiResponse, FollowUpArgs, HubService, ImageContentPart, JsonValue, ModelRef, PromoteQueuedArgs, PromptArgs, ProtocolEvent, QueuedItemArgs, RewindArgs, RewindResult, RewindSummaryEntry, SessionCommand, SessionCommandSourceInfo, SessionLifecycle, SessionManagementService, SessionMessageArgs, SessionPhase, SessionPresentation, SessionService, SessionServiceState, SessionSnapshot, SessionStateInfo, SessionStats, SessionUsage, SteerArgs, TextContentPart, ThinkingContentPart, ThinkingLevel, ToolCallContentPart, ToolTranscriptItem, TranscriptItem, TranscriptPage, TranscriptPageRequest, TranscriptProgress, UserTranscriptItem } from "./src/schemas/sessionProtocol.mjs";
+import { DOOM_NOTIFICATION_ENTRY_TYPE, DOOM_NOTIFICATION_ENTRY_VERSION, DOOM_NOTIFICATION_SERVICE, DoomNotificationEntryData, DoomNotificationEntryDataSchema, DoomNotificationLevel, DoomNotificationLevelSchema, DoomNotificationRequest, DoomNotificationRequestSchema, DoomNotificationService, MAX_DOOM_NOTIFICATION_BODY_CHARACTERS, MAX_DOOM_NOTIFICATION_SUBTITLE_CHARACTERS, MAX_DOOM_NOTIFICATION_TITLE_CHARACTERS, createDoomNotificationEntryData, isDoomNotificationEntryData, isDoomNotificationRequest, normalizeDoomNotificationRequest, readDoomNotificationService, requireDoomNotificationService } from "./src/schemas/notification.mjs";
+import { DOOM_NARRATION_SERVICE, DoomNarrationService, MAX_NARRATION_TEXT_CHARACTERS, NarrationRequest, NarrationRequestSchema, createNarrationRequest, isNarrationRequest, normalizeNarrationText, readDoomNarrationService, requireDoomNarrationService } from "./src/schemas/narration.mjs";
+import { DoomProtocolError, DoomProtocolValidationError, EventBusLike, ProtocolRuntime, ProtocolRuntimeOptions, RequestOptions, createProtocolRuntime } from "./runtimeProtocol.mjs";
+export { AskUserBlockedEvent, AskUserBlockedEventSchema, AskUserPromptEvent, AskUserPromptEventSchema, AskUserPromptOption, AskUserPromptOptionSchema, AskUserPromptQuestion, AskUserPromptQuestionSchema, AssistantTranscriptItem, ClearQueueResult, DOOM_ASK_USER_BLOCKED_EVENT, DOOM_ASK_USER_PROMPT_EVENT, DOOM_COCKPIT_SERVER_ID, DOOM_NARRATION_SERVICE, DOOM_NOTIFICATION_ENTRY_TYPE, DOOM_NOTIFICATION_ENTRY_VERSION, DOOM_NOTIFICATION_SERVICE, DOOM_SESSION_MANAGEMENT_SERVICE_ID, DOOM_SESSION_SERVICE_ID, DoomHubService, DoomNarrationService, DoomNotificationEntryData, DoomNotificationEntryDataSchema, DoomNotificationLevel, DoomNotificationLevelSchema, DoomNotificationRequest, DoomNotificationRequestSchema, DoomNotificationService, DoomProtocolError, DoomProtocolValidationError, DoomSessionManagementService, DoomSessionService, type EventBusLike, ExtensionUiResponse, FollowUpArgs, HubService, ImageContentPart, JsonValue, MAX_DOOM_NOTIFICATION_BODY_CHARACTERS, MAX_DOOM_NOTIFICATION_SUBTITLE_CHARACTERS, MAX_DOOM_NOTIFICATION_TITLE_CHARACTERS, MAX_NARRATION_TEXT_CHARACTERS, ModelRef, NarrationRequest, NarrationRequestSchema, PromoteQueuedArgs, PromptArgs, ProtocolEvent, type ProtocolRuntime, type ProtocolRuntimeOptions, QueuedItemArgs, type RequestOptions, RewindArgs, RewindResult, RewindSummaryEntry, SessionCommand, SessionCommandSourceInfo, SessionLifecycle, SessionManagementService, SessionMessageArgs, SessionPhase, SessionPresentation, SessionService, SessionServiceState, SessionSnapshot, SessionStateInfo, SessionStats, SessionUsage, SteerArgs, TextContentPart, ThinkingContentPart, ThinkingLevel, ToolCallContentPart, ToolTranscriptItem, TranscriptItem, TranscriptPage, TranscriptPageRequest, TranscriptProgress, UserTranscriptItem, createDoomNotificationEntryData, createNarrationRequest, createProtocolRuntime, isDoomNotificationEntryData, isDoomNotificationRequest, isNarrationRequest, normalizeDoomNotificationRequest, normalizeNarrationText, readDoomNarrationService, readDoomNotificationService, requireDoomNarrationService, requireDoomNotificationService };

package/dist/index.mjs

@@ -0,0 +1,6 @@
+import { AskUserBlockedEventSchema, AskUserPromptEventSchema, AskUserPromptOptionSchema, AskUserPromptQuestionSchema, DOOM_ASK_USER_BLOCKED_EVENT, DOOM_ASK_USER_PROMPT_EVENT } from "./src/schemas/askUser.mjs";
+import { DOOM_NARRATION_SERVICE, MAX_NARRATION_TEXT_CHARACTERS, NarrationRequestSchema, createNarrationRequest, isNarrationRequest, normalizeNarrationText, readDoomNarrationService, requireDoomNarrationService } from "./src/schemas/narration.mjs";
+import { DOOM_NOTIFICATION_ENTRY_TYPE, DOOM_NOTIFICATION_ENTRY_VERSION, DOOM_NOTIFICATION_SERVICE, DoomNotificationEntryDataSchema, DoomNotificationLevelSchema, DoomNotificationRequestSchema, MAX_DOOM_NOTIFICATION_BODY_CHARACTERS, MAX_DOOM_NOTIFICATION_SUBTITLE_CHARACTERS, MAX_DOOM_NOTIFICATION_TITLE_CHARACTERS, createDoomNotificationEntryData, isDoomNotificationEntryData, isDoomNotificationRequest, normalizeDoomNotificationRequest, readDoomNotificationService, requireDoomNotificationService } from "./src/schemas/notification.mjs";
+import { DOOM_COCKPIT_SERVER_ID, DOOM_SESSION_MANAGEMENT_SERVICE_ID, DOOM_SESSION_SERVICE_ID, DoomHubService, DoomSessionManagementService, DoomSessionService } from "./src/schemas/sessionProtocol.mjs";
+import { DoomProtocolError, DoomProtocolValidationError, createProtocolRuntime } from "./runtimeProtocol.mjs";
+export { AskUserBlockedEventSchema, AskUserPromptEventSchema, AskUserPromptOptionSchema, AskUserPromptQuestionSchema, DOOM_ASK_USER_BLOCKED_EVENT, DOOM_ASK_USER_PROMPT_EVENT, DOOM_COCKPIT_SERVER_ID, DOOM_NARRATION_SERVICE, DOOM_NOTIFICATION_ENTRY_TYPE, DOOM_NOTIFICATION_ENTRY_VERSION, DOOM_NOTIFICATION_SERVICE, DOOM_SESSION_MANAGEMENT_SERVICE_ID, DOOM_SESSION_SERVICE_ID, DoomHubService, DoomNotificationEntryDataSchema, DoomNotificationLevelSchema, DoomNotificationRequestSchema, DoomProtocolError, DoomProtocolValidationError, DoomSessionManagementService, DoomSessionService, MAX_DOOM_NOTIFICATION_BODY_CHARACTERS, MAX_DOOM_NOTIFICATION_SUBTITLE_CHARACTERS, MAX_DOOM_NOTIFICATION_TITLE_CHARACTERS, MAX_NARRATION_TEXT_CHARACTERS, NarrationRequestSchema, createDoomNotificationEntryData, createNarrationRequest, createProtocolRuntime, isDoomNotificationEntryData, isDoomNotificationRequest, isNarrationRequest, normalizeDoomNotificationRequest, normalizeNarrationText, readDoomNarrationService, readDoomNotificationService, requireDoomNarrationService, requireDoomNotificationService };

package/dist/json.cjs

@@ -0,0 +1,6 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_runtimeJson = require("./runtimeJson.cjs");
+exports.isRecord = require_runtimeJson.isRecord;
+exports.readJson = require_runtimeJson.readJson;
+exports.writeFileAtomic = require_runtimeJson.writeFileAtomic;
+exports.writeJson = require_runtimeJson.writeJson;

package/dist/json.d.mts

@@ -0,0 +1,2 @@
+import { JsonObject, isRecord, readJson, writeFileAtomic, writeJson } from "./runtimeJson.mjs";
+export { JsonObject, isRecord, readJson, writeFileAtomic, writeJson };

package/dist/json.mjs

@@ -0,0 +1,2 @@
+import { isRecord, readJson, writeFileAtomic, writeJson } from "./runtimeJson.mjs";
+export { isRecord, readJson, writeFileAtomic, writeJson };

package/dist/jsonlSessionRepo.cjs

@@ -0,0 +1,217 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_runtime = require("./_virtual/_rolldown/runtime.cjs");
+let node_crypto = require("node:crypto");
+let node_fs = require("node:fs");
+node_fs = require_runtime.__toESM(node_fs, 1);
+let node_path = require("node:path");
+node_path = require_runtime.__toESM(node_path, 1);
+let _earendil_works_pi_agent_core_harness_context = require("@earendil-works/pi-agent-core/harness/context");
+let _earendil_works_pi_agent_core_harness_session = require("@earendil-works/pi-agent-core/harness/session");
+let _earendil_works_pi_agent_core_node = require("@earendil-works/pi-agent-core/node");
+//#region src/services/jsonlSessionRepo/index.ts
+const PROJECTED_V3_TYPES = /* @__PURE__ */ new Set([
+	"model_change",
+	"thinking_level_change",
+	"active_tools_change",
+	"session_info",
+	"label"
+]);
+function asRecord(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value) ? value : void 0;
+}
+function requireString(value, field) {
+	if (typeof value !== "string" || value.length === 0) throw new Error(`Invalid protected history ${field}`);
+	return value;
+}
+function requireNullableString(value, field) {
+	if (value !== null && typeof value !== "string") throw new Error(`Invalid protected history ${field}`);
+	return value;
+}
+function stableJson(value) {
+	if (Array.isArray(value)) return `[${value.map(stableJson).join(",")}]`;
+	const record = asRecord(value);
+	if (record === void 0) return JSON.stringify(value) ?? "null";
+	return `{${Object.keys(record).sort().map((key) => `${JSON.stringify(key)}:${stableJson(record[key])}`).join(",")}}`;
+}
+function contentHash(record) {
+	const { id: _id, parentId: _parentId, timestamp: _timestamp, kind: _kind, seq: _seq, ...content } = record;
+	if (content.type === "custom_message") {
+		content.type = "message";
+		content.message = {
+			role: "custom",
+			customType: content.customType,
+			content: content.content,
+			details: content.details,
+			display: content.display
+		};
+		delete content.customType;
+		delete content.content;
+		delete content.details;
+		delete content.display;
+	}
+	if (content.type === "branch_summary" && content.fromId === "root") content.fromId = null;
+	if (content.type === "compaction") {
+		delete content.firstKeptEntryId;
+		delete content.retainedTail;
+	}
+	return (0, node_crypto.createHash)("sha256").update(Buffer.from(stableJson(content))).digest("hex");
+}
+function parseJsonl(filePath) {
+	const content = node_fs.default.readFileSync(filePath, "utf8");
+	if (!content.endsWith("\n")) throw new Error(`Protected history file is truncated: ${filePath}`);
+	return content.slice(0, -1).split("\n");
+}
+function parseV3(filePath) {
+	const lines = parseJsonl(filePath);
+	const header = asRecord(JSON.parse(lines[0] ?? ""));
+	if (header?.type !== "session" || header.version !== 3) throw new Error(`Protected history source is not v3: ${filePath}`);
+	return {
+		header,
+		records: lines.slice(1).map((line, index) => {
+			const record = asRecord(JSON.parse(line));
+			if (record === void 0) throw new Error(`Invalid protected history record at line ${index + 2}`);
+			return record;
+		})
+	};
+}
+function parseV4(filePath) {
+	const lines = parseJsonl(filePath);
+	const header = asRecord(JSON.parse(lines[0] ?? ""));
+	if (header?.kind !== "header" || header.v !== 4) throw new Error(`Protected history staging is not v4: ${filePath}`);
+	const entries = [];
+	const branchTips = /* @__PURE__ */ new Map();
+	for (const line of lines.slice(1)) {
+		const value = JSON.parse(line);
+		const writes = Array.isArray(value) ? value : [value];
+		for (const item of writes) {
+			const record = asRecord(item);
+			if (record?.kind === "entry") {
+				const { kind: _kind, seq: _seq, ...entry } = record;
+				entries.push(entry);
+			} else if (record?.kind === "value" && record.namespace === "pi.branch.tip") {
+				const branch = requireString(record.key, "branch name");
+				branchTips.set(branch, record.op === "delete" ? null : requireNullableString(record.value, "branch tip"));
+			}
+		}
+	}
+	return {
+		entries,
+		branchTips
+	};
+}
+function sourceParentId(record) {
+	return requireNullableString(record.parentId, "source parent id");
+}
+function retainedSourceRecords(records) {
+	return records.filter((record) => !PROJECTED_V3_TYPES.has(requireString(record.type, "record type")));
+}
+function resolveNearestRetainedSourceId(sourceId, sourceById, sourceToImported) {
+	const visited = /* @__PURE__ */ new Set();
+	let current = sourceId;
+	while (current !== null) {
+		if (sourceToImported.has(current)) return current;
+		if (visited.has(current)) throw new Error(`Cycle in protected history parent chain: ${current}`);
+		visited.add(current);
+		const record = sourceById.get(current);
+		if (record === void 0) throw new Error(`Protected history parent references unknown entry: ${current}`);
+		current = sourceParentId(record);
+	}
+	return null;
+}
+function resolveRetainedSourceId(sourceId, sourceById, sourceToImported) {
+	const retainedSourceId = resolveNearestRetainedSourceId(sourceId, sourceById, sourceToImported);
+	return retainedSourceId === null ? null : sourceToImported.get(retainedSourceId);
+}
+function buildVerification(source, imported) {
+	const retained = retainedSourceRecords(source.records);
+	if (imported.entries.length !== retained.length) throw new Error("Protected history staging entry count does not match source");
+	const sourceById = /* @__PURE__ */ new Map();
+	for (const record of source.records) {
+		const id = requireString(record.id, "source entry id");
+		if (sourceById.has(id)) throw new Error(`Duplicate protected history source entry id: ${id}`);
+		sourceById.set(id, record);
+	}
+	const sourceToImported = /* @__PURE__ */ new Map();
+	const importedIds = /* @__PURE__ */ new Set();
+	for (const [index, sourceRecord] of retained.entries()) {
+		const sourceId = requireString(sourceRecord.id, "source entry id");
+		const importedRecord = imported.entries[index];
+		if (importedRecord === void 0) throw new Error(`Protected history staging omitted source entry: ${sourceId}`);
+		const importedId = requireString(importedRecord.id, "imported entry id");
+		if (sourceToImported.has(sourceId)) throw new Error(`Duplicate protected history source entry id: ${sourceId}`);
+		if (importedIds.has(importedId)) throw new Error(`Duplicate protected history imported entry id: ${importedId}`);
+		sourceToImported.set(sourceId, importedId);
+		importedIds.add(importedId);
+	}
+	const entries = retained.map((sourceRecord) => {
+		const sourceId = requireString(sourceRecord.id, "source entry id");
+		const importedId = sourceToImported.get(sourceId);
+		if (importedId === void 0) throw new Error(`Protected history omitted source entry: ${sourceId}`);
+		const importedRecord = imported.entries.find((record) => record.id === importedId);
+		if (importedRecord === void 0) throw new Error(`Protected history omitted imported entry: ${importedId}`);
+		const importedParentId = requireNullableString(importedRecord.parentId, "imported parent id");
+		if (resolveRetainedSourceId(sourceParentId(sourceRecord), sourceById, sourceToImported) !== importedParentId) throw new Error(`Protected history parent mismatch: ${sourceId}`);
+		return {
+			sourceId,
+			importedId,
+			sourceParentId: sourceParentId(sourceRecord),
+			importedParentId,
+			sourceContentHash: contentHash(sourceRecord),
+			importedContentHash: contentHash(importedRecord)
+		};
+	});
+	const finalSource = source.records.at(-1);
+	const sourceTipId = finalSource === void 0 ? null : resolveNearestRetainedSourceId(requireString(finalSource.id, "source tip id"), sourceById, sourceToImported);
+	const importedTipId = sourceTipId === null ? null : sourceToImported.get(sourceTipId);
+	if (sourceTipId !== null && importedTipId === void 0) throw new Error(`Protected history omitted source tip: ${sourceTipId}`);
+	if (imported.branchTips.get("main") !== (importedTipId ?? null)) throw new Error("Protected history staging main branch tip mismatch");
+	return {
+		entries,
+		branches: [{
+			sourceTipId,
+			importedTipId: importedTipId ?? null,
+			branch: "main"
+		}],
+		projectedSourceIds: source.records.filter((record) => PROJECTED_V3_TYPES.has(requireString(record.type, "record type"))).map((record) => requireString(record.id, "projected source entry id"))
+	};
+}
+/** Import one v3 history through the pinned upstream JsonlSessionRepo adapter. */
+async function importV3WithPinnedUpstream(input) {
+	const source = parseV3(input.sourcePath);
+	const timestamp = requireString(source.header.timestamp, "session timestamp");
+	const createdAt = Date.parse(timestamp);
+	if (!Number.isFinite(createdAt)) throw new Error("Invalid protected history session timestamp");
+	const cwd = requireString(source.header.cwd, "session cwd");
+	const id = requireString(source.header.id, "session id");
+	const environment = new _earendil_works_pi_agent_core_node.NodeExecutionEnv({ cwd: node_path.default.dirname(node_path.default.resolve(input.stagingPath)) });
+	const repository = new _earendil_works_pi_agent_core_harness_session.JsonlSessionRepo({
+		fileSystem: environment,
+		sessionsRoot: node_path.default.dirname(node_path.default.resolve(input.stagingPath)),
+		now: () => Date.now()
+	});
+	let session;
+	try {
+		session = await repository.open({
+			id,
+			createdAt,
+			storageVersion: _earendil_works_pi_agent_core_harness_session.JSONL_STORAGE_VERSION,
+			cwd,
+			path: node_path.default.resolve(input.stagingPath),
+			modifiedAt: node_fs.default.statSync(input.stagingPath).mtimeMs
+		}, _earendil_works_pi_agent_core_harness_context.BACKGROUND_CONTEXT);
+		const name = await session.getName(_earendil_works_pi_agent_core_harness_context.BACKGROUND_CONTEXT);
+		await session.setName(name, _earendil_works_pi_agent_core_harness_context.BACKGROUND_CONTEXT);
+		await session.close(_earendil_works_pi_agent_core_harness_context.BACKGROUND_CONTEXT);
+		session = void 0;
+		return buildVerification(source, parseV4(input.stagingPath));
+	} finally {
+		if (session !== void 0) await session.close(_earendil_works_pi_agent_core_harness_context.BACKGROUND_CONTEXT).catch(() => void 0);
+		await repository.close(_earendil_works_pi_agent_core_harness_context.BACKGROUND_CONTEXT);
+		await environment.cleanup(_earendil_works_pi_agent_core_harness_context.BACKGROUND_CONTEXT);
+	}
+}
+//#endregion
+exports.contentHash = contentHash;
+exports.importV3WithPinnedUpstream = importV3WithPinnedUpstream;
+
+//# sourceMappingURL=jsonlSessionRepo.cjs.map