@agimon-ai/po-core 0.0.0-alpha.2 → 0.0.0-alpha.21

package/dist/src/services/devProxyStore/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../../../../src/services/devProxyStore/index.ts"],"sourcesContent":["import fs from 'node:fs';\nimport path from 'node:path';\n\nimport type { DevProxyTarget } from '../../types/remote';\nimport { validateTargetName } from '../devProxyPolicy';\n\n/**\n * Registered proxy targets on disk.\n *\n * Persisted, unlike a remote session, because a target is a name the developer\n * typed into their own build configuration as `base: '/devproxy/<name>/'`.\n * Losing it on restart would silently break that line, and the file holds no\n * secret: a port number and a label the operator chose while sitting at the\n * machine.\n */\n\nconst TARGETS_FILE = 'dev-proxy.json';\nconst DIRECTORY_MODE = 0o700;\nconst FILE_MODE = 0o600;\n/** Any bit set for group or other; a state file readable by another account is worth repairing. */\nconst LOOSE_MODE_MASK = 0o077;\n\nexport interface DevProxyStoreOptions {\n  /** The same directory the remote-access store uses; defaults to ~/.po/web. */\n  stateDir: string;\n  onNotice?: (message: string) => void;\n}\n\nexport interface DevProxyStore {\n  targets(): readonly DevProxyTarget[];\n  find(name: string): DevProxyTarget | undefined;\n  /** Replaces any target already holding this name, so re-registering a moved port is one call. */\n  save(target: DevProxyTarget): void;\n  remove(name: string): boolean;\n}\n\n/** Repairs a state file another account can read. */\nfunction tightenMode(filePath: string, notice: (message: string) => void): void {\n  try {\n    if ((fs.statSync(filePath).mode & LOOSE_MODE_MASK) === 0) return;\n    fs.chmodSync(filePath, FILE_MODE);\n    notice(`tightened permissions on ${filePath}`);\n  } catch {\n    // The file is missing or unreadable; the caller's own read reports that.\n  }\n}\n\n/**\n * Rebuilds one record, dropping anything the current policy would refuse.\n *\n * The file is revalidated on read rather than trusted, because a name that was\n * legal when written is not necessarily legal now, and an edited file must not\n * be able to introduce a target the API would have rejected.\n */\nfunction parseTarget(value: unknown): DevProxyTarget | undefined {\n  if (typeof value !== 'object' || value === null) return undefined;\n  const record = value as Partial<DevProxyTarget>;\n  const name = validateTargetName(record.name);\n  if (!name.ok) return undefined;\n  if (typeof record.port !== 'number' || !Number.isSafeInteger(record.port)) return undefined;\n  const createdAt = typeof record.createdAt === 'number' ? record.createdAt : 0;\n  return { name: name.name, port: record.port, createdAt };\n}\n\nexport function createDevProxyStore(options: DevProxyStoreOptions): DevProxyStore {\n  const notice = options.onNotice ?? ((): void => {});\n  const targetsPath = path.join(options.stateDir, TARGETS_FILE);\n  let held = load();\n\n  function load(): DevProxyTarget[] {\n    let raw: string;\n    try {\n      raw = fs.readFileSync(targetsPath, 'utf8');\n    } catch {\n      // No file is the normal first run, so this is not worth a notice.\n      return [];\n    }\n    tightenMode(targetsPath, notice);\n    let parsed: unknown;\n    try {\n      parsed = JSON.parse(raw);\n    } catch {\n      notice(`dev proxy targets at ${targetsPath} are not valid JSON; none will load`);\n      return [];\n    }\n    if (!Array.isArray(parsed)) return [];\n    return parsed.map(parseTarget).filter((target): target is DevProxyTarget => target !== undefined);\n  }\n\n  function write(): void {\n    const temporary = `${targetsPath}.${String(process.pid)}.tmp`;\n    try {\n      fs.mkdirSync(options.stateDir, { recursive: true, mode: DIRECTORY_MODE });\n      fs.writeFileSync(temporary, `${JSON.stringify(held, undefined, 2)}\\n`, { mode: FILE_MODE });\n      // Rename rather than write in place, so a crash mid-write leaves the\n      // previous contents rather than a truncated file.\n      fs.renameSync(temporary, targetsPath);\n    } catch (error) {\n      notice(`${targetsPath} could not be saved: ${error instanceof Error ? error.message : String(error)}`);\n      try {\n        fs.rmSync(temporary, { force: true });\n      } catch {\n        // Nothing further to do; the temp file is inert either way.\n      }\n    }\n  }\n\n  return {\n    targets: () => held,\n    find: (name) => held.find((target) => target.name === name),\n\n    save(target) {\n      held = [...held.filter((existing) => existing.name !== target.name), target];\n      write();\n    },\n\n    remove(name) {\n      const next = held.filter((existing) => existing.name !== name);\n      if (next.length === held.length) return false;\n      held = next;\n      write();\n      return true;\n    },\n  };\n}\n"],"mappings":";;;;;;;;;;;;;AAgBA,MAAM,eAAe;AACrB,MAAM,iBAAiB;AACvB,MAAM,YAAY;;AAElB,MAAM,kBAAkB;;AAiBxB,SAAS,YAAY,UAAkB,QAAyC;CAC9E,IAAI;EACF,KAAK,GAAG,SAAS,QAAQ,CAAC,CAAC,OAAO,qBAAqB,GAAG;EAC1D,GAAG,UAAU,UAAU,SAAS;EAChC,OAAO,4BAA4B,UAAU;CAC/C,QAAQ,CAER;AACF;;;;;;;;AASA,SAAS,YAAY,OAA4C;CAC/D,IAAI,OAAO,UAAU,YAAY,UAAU,MAAM,OAAO,KAAA;CACxD,MAAM,SAAS;CACf,MAAM,OAAO,mBAAmB,OAAO,IAAI;CAC3C,IAAI,CAAC,KAAK,IAAI,OAAO,KAAA;CACrB,IAAI,OAAO,OAAO,SAAS,YAAY,CAAC,OAAO,cAAc,OAAO,IAAI,GAAG,OAAO,KAAA;CAClF,MAAM,YAAY,OAAO,OAAO,cAAc,WAAW,OAAO,YAAY;CAC5E,OAAO;EAAE,MAAM,KAAK;EAAM,MAAM,OAAO;EAAM;CAAU;AACzD;AAEA,SAAgB,oBAAoB,SAA8C;CAChF,MAAM,SAAS,QAAQ,mBAAyB,CAAC;CACjD,MAAM,cAAc,KAAK,KAAK,QAAQ,UAAU,YAAY;CAC5D,IAAI,OAAO,KAAK;CAEhB,SAAS,OAAyB;EAChC,IAAI;EACJ,IAAI;GACF,MAAM,GAAG,aAAa,aAAa,MAAM;EAC3C,QAAQ;GAEN,OAAO,CAAC;EACV;EACA,YAAY,aAAa,MAAM;EAC/B,IAAI;EACJ,IAAI;GACF,SAAS,KAAK,MAAM,GAAG;EACzB,QAAQ;GACN,OAAO,wBAAwB,YAAY,oCAAoC;GAC/E,OAAO,CAAC;EACV;EACA,IAAI,CAAC,MAAM,QAAQ,MAAM,GAAG,OAAO,CAAC;EACpC,OAAO,OAAO,IAAI,WAAW,CAAC,CAAC,QAAQ,WAAqC,WAAW,KAAA,CAAS;CAClG;CAEA,SAAS,QAAc;EACrB,MAAM,YAAY,GAAG,YAAY,GAAG,OAAO,QAAQ,GAAG,EAAE;EACxD,IAAI;GACF,GAAG,UAAU,QAAQ,UAAU;IAAE,WAAW;IAAM,MAAM;GAAe,CAAC;GACxE,GAAG,cAAc,WAAW,GAAG,KAAK,UAAU,MAAM,KAAA,GAAW,CAAC,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;GAG1F,GAAG,WAAW,WAAW,WAAW;EACtC,SAAS,OAAO;GACd,OAAO,GAAG,YAAY,uBAAuB,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,GAAG;GACrG,IAAI;IACF,GAAG,OAAO,WAAW,EAAE,OAAO,KAAK,CAAC;GACtC,QAAQ,CAER;EACF;CACF;CAEA,OAAO;EACL,eAAe;EACf,OAAO,SAAS,KAAK,MAAM,WAAW,OAAO,SAAS,IAAI;EAE1D,KAAK,QAAQ;GACX,OAAO,CAAC,GAAG,KAAK,QAAQ,aAAa,SAAS,SAAS,OAAO,IAAI,GAAG,MAAM;GAC3E,MAAM;EACR;EAEA,OAAO,MAAM;GACX,MAAM,OAAO,KAAK,QAAQ,aAAa,SAAS,SAAS,IAAI;GAC7D,IAAI,KAAK,WAAW,KAAK,QAAQ,OAAO;GACxC,OAAO;GACP,MAAM;GACN,OAAO;EACT;CACF;AACF"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../../src/services/devProxyStore/index.ts"],"sourcesContent":["import path from 'node:path';\n\nimport type { Context } from '@earendil-works/chord';\nimport { getOrThrow, type FileSystem } from '@earendil-works/pi-durable/env';\n\nimport type { DevProxyTarget } from '../../types/remote';\nimport { nodeHost } from '../nodeHost';\nimport { writeFileAtomic } from '../platformFiles';\nimport { createSerialRunner } from '../serialRunner';\nimport {\n  DIRECTORY_MODE,\n  FILE_MODE,\n  isLooseMode,\n  parseDevProxyTargets,\n  serializeDevProxyTargets,\n  TARGETS_FILE,\n  type DevProxyStoreOptions,\n} from './devProxyRecords';\n\nexport type { DevProxyStore, DevProxyStoreOptions } from './devProxyRecords';\nexport { createDevProxyStore } from './sync';\n\n/** One queue per targets file, so concurrent writes in this process never interleave. */\nconst targetWrites = createSerialRunner();\n\n/** The async twin of `DevProxyStore`: reads stay in memory, every write resolves once it is on disk. */\nexport interface DevProxyStoreAsync {\n  targets(): readonly DevProxyTarget[];\n  find(name: string): DevProxyTarget | undefined;\n  /** Replaces any target already holding this name, so re-registering a moved port is one call. */\n  save(target: DevProxyTarget): Promise<void>;\n  remove(name: string): Promise<boolean>;\n}\n\n/** Registered proxy targets on disk; a failed write is reported and never thrown, as in the sync store. */\nexport async function createDevProxyStoreAsync(\n  fs: FileSystem,\n  options: DevProxyStoreOptions,\n  context: Context,\n): Promise<DevProxyStoreAsync> {\n  const notice = options.onNotice ?? ((): void => {});\n  const targetsPath = path.join(options.stateDir, TARGETS_FILE);\n  const serial = targetWrites.forKey(targetsPath);\n\n  const load = async (): Promise<DevProxyTarget[]> => {\n    const raw = await fs.readTextFile(targetsPath, context);\n    // No file is the normal first run, so this is not worth a notice.\n    if (!raw.ok) return [];\n    // Repairs a state file another account can read.\n    try {\n      const mode = await nodeHost.fileMode(targetsPath);\n      if (mode !== undefined && isLooseMode(mode)) {\n        await nodeHost.setMode(targetsPath, FILE_MODE);\n        notice(`tightened permissions on ${targetsPath}`);\n      }\n    } catch {\n      // The file vanished or is unreadable between the read and the check; the read above already won.\n    }\n    return parseDevProxyTargets(raw.value, targetsPath, notice);\n  };\n\n  let held = await load();\n\n  const write = async (): Promise<void> => {\n    try {\n      if (!getOrThrow(await fs.exists(options.stateDir, context))) {\n        getOrThrow(await fs.createDir(options.stateDir, { recursive: true }, context));\n        await nodeHost.setMode(options.stateDir, DIRECTORY_MODE);\n      }\n      await writeFileAtomic(fs, targetsPath, serializeDevProxyTargets(held), context);\n      await nodeHost.setMode(targetsPath, FILE_MODE);\n    } catch (error) {\n      notice(`${targetsPath} could not be saved: ${error instanceof Error ? error.message : String(error)}`);\n    }\n  };\n\n  return {\n    targets: () => held,\n    find: (name) => held.find((target) => target.name === name),\n    save: (target) =>\n      serial(async () => {\n        held = [...held.filter((existing) => existing.name !== target.name), target];\n        await write();\n      }),\n    remove: (name) =>\n      serial(async () => {\n        const next = held.filter((existing) => existing.name !== name);\n        if (next.length === held.length) return false;\n        held = next;\n        await write();\n        return true;\n      }),\n  };\n}\n"],"mappings":";;;;;;;AAuBqB,mBAAmB"}

package/dist/src/services/devProxyStore/sync.cjs

@@ -0,0 +1,66 @@
+const require_runtime = require("../../../_virtual/_rolldown/runtime.cjs");
+const require_devProxyRecords = require("./devProxyRecords.cjs");
+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);
+//#region src/services/devProxyStore/sync.ts
+/** Repairs a state file another account can read. */
+function tightenMode(filePath, notice) {
+	try {
+		if (!require_devProxyRecords.isLooseMode(node_fs.default.statSync(filePath).mode)) return;
+		node_fs.default.chmodSync(filePath, 384);
+		notice(`tightened permissions on ${filePath}`);
+	} catch {}
+}
+/** @deprecated Node-only sync shim; use createDevProxyStoreAsync. Removed in M2. */
+function createDevProxyStore(options) {
+	const notice = options.onNotice ?? (() => {});
+	const targetsPath = node_path.default.join(options.stateDir, require_devProxyRecords.TARGETS_FILE);
+	let held = load();
+	function load() {
+		let raw;
+		try {
+			raw = node_fs.default.readFileSync(targetsPath, "utf8");
+		} catch {
+			return [];
+		}
+		tightenMode(targetsPath, notice);
+		return require_devProxyRecords.parseDevProxyTargets(raw, targetsPath, notice);
+	}
+	function write() {
+		const temporary = `${targetsPath}.${String(process.pid)}.tmp`;
+		try {
+			node_fs.default.mkdirSync(options.stateDir, {
+				recursive: true,
+				mode: 448
+			});
+			node_fs.default.writeFileSync(temporary, require_devProxyRecords.serializeDevProxyTargets(held), { mode: 384 });
+			node_fs.default.renameSync(temporary, targetsPath);
+		} catch (error) {
+			notice(`${targetsPath} could not be saved: ${error instanceof Error ? error.message : String(error)}`);
+			try {
+				node_fs.default.rmSync(temporary, { force: true });
+			} catch {}
+		}
+	}
+	return {
+		targets: () => held,
+		find: (name) => held.find((target) => target.name === name),
+		save(target) {
+			held = [...held.filter((existing) => existing.name !== target.name), target];
+			write();
+		},
+		remove(name) {
+			const next = held.filter((existing) => existing.name !== name);
+			if (next.length === held.length) return false;
+			held = next;
+			write();
+			return true;
+		}
+	};
+}
+//#endregion
+exports.createDevProxyStore = createDevProxyStore;
+
+//# sourceMappingURL=sync.cjs.map

package/dist/src/services/devProxyStore/sync.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.cjs","names":["isLooseMode","fs","path","TARGETS_FILE","parseDevProxyTargets","serializeDevProxyTargets"],"sources":["../../../../src/services/devProxyStore/sync.ts"],"sourcesContent":["import fs from 'node:fs';\nimport path from 'node:path';\n\nimport type { DevProxyTarget } from '../../types/remote';\nimport {\n  DIRECTORY_MODE,\n  FILE_MODE,\n  isLooseMode,\n  parseDevProxyTargets,\n  serializeDevProxyTargets,\n  TARGETS_FILE,\n  type DevProxyStore,\n  type DevProxyStoreOptions,\n} from './devProxyRecords';\n\n/** Repairs a state file another account can read. */\nfunction tightenMode(filePath: string, notice: (message: string) => void): void {\n  try {\n    if (!isLooseMode(fs.statSync(filePath).mode)) return;\n    fs.chmodSync(filePath, FILE_MODE);\n    notice(`tightened permissions on ${filePath}`);\n  } catch {\n    // The file is missing or unreadable; the caller's own read reports that.\n  }\n}\n\n/** @deprecated Node-only sync shim; use createDevProxyStoreAsync. Removed in M2. */\nexport function createDevProxyStore(options: DevProxyStoreOptions): DevProxyStore {\n  const notice = options.onNotice ?? ((): void => {});\n  const targetsPath = path.join(options.stateDir, TARGETS_FILE);\n  let held = load();\n\n  function load(): DevProxyTarget[] {\n    let raw: string;\n    try {\n      raw = fs.readFileSync(targetsPath, 'utf8');\n    } catch {\n      // No file is the normal first run, so this is not worth a notice.\n      return [];\n    }\n    tightenMode(targetsPath, notice);\n    return parseDevProxyTargets(raw, targetsPath, notice);\n  }\n\n  function write(): void {\n    const temporary = `${targetsPath}.${String(process.pid)}.tmp`;\n    try {\n      fs.mkdirSync(options.stateDir, { recursive: true, mode: DIRECTORY_MODE });\n      fs.writeFileSync(temporary, serializeDevProxyTargets(held), { mode: FILE_MODE });\n      // Rename rather than write in place, so a crash mid-write leaves the\n      // previous contents rather than a truncated file.\n      fs.renameSync(temporary, targetsPath);\n    } catch (error) {\n      notice(`${targetsPath} could not be saved: ${error instanceof Error ? error.message : String(error)}`);\n      try {\n        fs.rmSync(temporary, { force: true });\n      } catch {\n        // Nothing further to do; the temp file is inert either way.\n      }\n    }\n  }\n\n  return {\n    targets: () => held,\n    find: (name) => held.find((target) => target.name === name),\n\n    save(target) {\n      held = [...held.filter((existing) => existing.name !== target.name), target];\n      write();\n    },\n\n    remove(name) {\n      const next = held.filter((existing) => existing.name !== name);\n      if (next.length === held.length) return false;\n      held = next;\n      write();\n      return true;\n    },\n  };\n}\n"],"mappings":";;;;;;;;AAgBA,SAAS,YAAY,UAAkB,QAAyC;CAC9E,IAAI;EACF,IAAI,CAACA,wBAAAA,YAAYC,QAAAA,QAAG,SAAS,QAAQ,CAAC,CAAC,IAAI,GAAG;EAC9C,QAAA,QAAG,UAAU,UAAA,GAAmB;EAChC,OAAO,4BAA4B,UAAU;CAC/C,QAAQ,CAER;AACF;;AAGA,SAAgB,oBAAoB,SAA8C;CAChF,MAAM,SAAS,QAAQ,mBAAyB,CAAC;CACjD,MAAM,cAAcC,UAAAA,QAAK,KAAK,QAAQ,UAAUC,wBAAAA,YAAY;CAC5D,IAAI,OAAO,KAAK;CAEhB,SAAS,OAAyB;EAChC,IAAI;EACJ,IAAI;GACF,MAAMF,QAAAA,QAAG,aAAa,aAAa,MAAM;EAC3C,QAAQ;GAEN,OAAO,CAAC;EACV;EACA,YAAY,aAAa,MAAM;EAC/B,OAAOG,wBAAAA,qBAAqB,KAAK,aAAa,MAAM;CACtD;CAEA,SAAS,QAAc;EACrB,MAAM,YAAY,GAAG,YAAY,GAAG,OAAO,QAAQ,GAAG,EAAE;EACxD,IAAI;GACF,QAAA,QAAG,UAAU,QAAQ,UAAU;IAAE,WAAW;IAAM,MAAA;GAAqB,CAAC;GACxE,QAAA,QAAG,cAAc,WAAWC,wBAAAA,yBAAyB,IAAI,GAAG,EAAE,MAAA,IAAgB,CAAC;GAG/E,QAAA,QAAG,WAAW,WAAW,WAAW;EACtC,SAAS,OAAO;GACd,OAAO,GAAG,YAAY,uBAAuB,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,GAAG;GACrG,IAAI;IACF,QAAA,QAAG,OAAO,WAAW,EAAE,OAAO,KAAK,CAAC;GACtC,QAAQ,CAER;EACF;CACF;CAEA,OAAO;EACL,eAAe;EACf,OAAO,SAAS,KAAK,MAAM,WAAW,OAAO,SAAS,IAAI;EAE1D,KAAK,QAAQ;GACX,OAAO,CAAC,GAAG,KAAK,QAAQ,aAAa,SAAS,SAAS,OAAO,IAAI,GAAG,MAAM;GAC3E,MAAM;EACR;EAEA,OAAO,MAAM;GACX,MAAM,OAAO,KAAK,QAAQ,aAAa,SAAS,SAAS,IAAI;GAC7D,IAAI,KAAK,WAAW,KAAK,QAAQ,OAAO;GACxC,OAAO;GACP,MAAM;GACN,OAAO;EACT;CACF;AACF"}

package/dist/src/services/devProxyStore/sync.mjs

@@ -0,0 +1,63 @@
+import { TARGETS_FILE, isLooseMode, parseDevProxyTargets, serializeDevProxyTargets } from "./devProxyRecords.mjs";
+import fs from "node:fs";
+import path from "node:path";
+//#region src/services/devProxyStore/sync.ts
+/** Repairs a state file another account can read. */
+function tightenMode(filePath, notice) {
+	try {
+		if (!isLooseMode(fs.statSync(filePath).mode)) return;
+		fs.chmodSync(filePath, 384);
+		notice(`tightened permissions on ${filePath}`);
+	} catch {}
+}
+/** @deprecated Node-only sync shim; use createDevProxyStoreAsync. Removed in M2. */
+function createDevProxyStore(options) {
+	const notice = options.onNotice ?? (() => {});
+	const targetsPath = path.join(options.stateDir, TARGETS_FILE);
+	let held = load();
+	function load() {
+		let raw;
+		try {
+			raw = fs.readFileSync(targetsPath, "utf8");
+		} catch {
+			return [];
+		}
+		tightenMode(targetsPath, notice);
+		return parseDevProxyTargets(raw, targetsPath, notice);
+	}
+	function write() {
+		const temporary = `${targetsPath}.${String(process.pid)}.tmp`;
+		try {
+			fs.mkdirSync(options.stateDir, {
+				recursive: true,
+				mode: 448
+			});
+			fs.writeFileSync(temporary, serializeDevProxyTargets(held), { mode: 384 });
+			fs.renameSync(temporary, targetsPath);
+		} catch (error) {
+			notice(`${targetsPath} could not be saved: ${error instanceof Error ? error.message : String(error)}`);
+			try {
+				fs.rmSync(temporary, { force: true });
+			} catch {}
+		}
+	}
+	return {
+		targets: () => held,
+		find: (name) => held.find((target) => target.name === name),
+		save(target) {
+			held = [...held.filter((existing) => existing.name !== target.name), target];
+			write();
+		},
+		remove(name) {
+			const next = held.filter((existing) => existing.name !== name);
+			if (next.length === held.length) return false;
+			held = next;
+			write();
+			return true;
+		}
+	};
+}
+//#endregion
+export { createDevProxyStore };
+
+//# sourceMappingURL=sync.mjs.map

package/dist/src/services/devProxyStore/sync.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.mjs","names":[],"sources":["../../../../src/services/devProxyStore/sync.ts"],"sourcesContent":["import fs from 'node:fs';\nimport path from 'node:path';\n\nimport type { DevProxyTarget } from '../../types/remote';\nimport {\n  DIRECTORY_MODE,\n  FILE_MODE,\n  isLooseMode,\n  parseDevProxyTargets,\n  serializeDevProxyTargets,\n  TARGETS_FILE,\n  type DevProxyStore,\n  type DevProxyStoreOptions,\n} from './devProxyRecords';\n\n/** Repairs a state file another account can read. */\nfunction tightenMode(filePath: string, notice: (message: string) => void): void {\n  try {\n    if (!isLooseMode(fs.statSync(filePath).mode)) return;\n    fs.chmodSync(filePath, FILE_MODE);\n    notice(`tightened permissions on ${filePath}`);\n  } catch {\n    // The file is missing or unreadable; the caller's own read reports that.\n  }\n}\n\n/** @deprecated Node-only sync shim; use createDevProxyStoreAsync. Removed in M2. */\nexport function createDevProxyStore(options: DevProxyStoreOptions): DevProxyStore {\n  const notice = options.onNotice ?? ((): void => {});\n  const targetsPath = path.join(options.stateDir, TARGETS_FILE);\n  let held = load();\n\n  function load(): DevProxyTarget[] {\n    let raw: string;\n    try {\n      raw = fs.readFileSync(targetsPath, 'utf8');\n    } catch {\n      // No file is the normal first run, so this is not worth a notice.\n      return [];\n    }\n    tightenMode(targetsPath, notice);\n    return parseDevProxyTargets(raw, targetsPath, notice);\n  }\n\n  function write(): void {\n    const temporary = `${targetsPath}.${String(process.pid)}.tmp`;\n    try {\n      fs.mkdirSync(options.stateDir, { recursive: true, mode: DIRECTORY_MODE });\n      fs.writeFileSync(temporary, serializeDevProxyTargets(held), { mode: FILE_MODE });\n      // Rename rather than write in place, so a crash mid-write leaves the\n      // previous contents rather than a truncated file.\n      fs.renameSync(temporary, targetsPath);\n    } catch (error) {\n      notice(`${targetsPath} could not be saved: ${error instanceof Error ? error.message : String(error)}`);\n      try {\n        fs.rmSync(temporary, { force: true });\n      } catch {\n        // Nothing further to do; the temp file is inert either way.\n      }\n    }\n  }\n\n  return {\n    targets: () => held,\n    find: (name) => held.find((target) => target.name === name),\n\n    save(target) {\n      held = [...held.filter((existing) => existing.name !== target.name), target];\n      write();\n    },\n\n    remove(name) {\n      const next = held.filter((existing) => existing.name !== name);\n      if (next.length === held.length) return false;\n      held = next;\n      write();\n      return true;\n    },\n  };\n}\n"],"mappings":";;;;;AAgBA,SAAS,YAAY,UAAkB,QAAyC;CAC9E,IAAI;EACF,IAAI,CAAC,YAAY,GAAG,SAAS,QAAQ,CAAC,CAAC,IAAI,GAAG;EAC9C,GAAG,UAAU,UAAA,GAAmB;EAChC,OAAO,4BAA4B,UAAU;CAC/C,QAAQ,CAER;AACF;;AAGA,SAAgB,oBAAoB,SAA8C;CAChF,MAAM,SAAS,QAAQ,mBAAyB,CAAC;CACjD,MAAM,cAAc,KAAK,KAAK,QAAQ,UAAU,YAAY;CAC5D,IAAI,OAAO,KAAK;CAEhB,SAAS,OAAyB;EAChC,IAAI;EACJ,IAAI;GACF,MAAM,GAAG,aAAa,aAAa,MAAM;EAC3C,QAAQ;GAEN,OAAO,CAAC;EACV;EACA,YAAY,aAAa,MAAM;EAC/B,OAAO,qBAAqB,KAAK,aAAa,MAAM;CACtD;CAEA,SAAS,QAAc;EACrB,MAAM,YAAY,GAAG,YAAY,GAAG,OAAO,QAAQ,GAAG,EAAE;EACxD,IAAI;GACF,GAAG,UAAU,QAAQ,UAAU;IAAE,WAAW;IAAM,MAAA;GAAqB,CAAC;GACxE,GAAG,cAAc,WAAW,yBAAyB,IAAI,GAAG,EAAE,MAAA,IAAgB,CAAC;GAG/E,GAAG,WAAW,WAAW,WAAW;EACtC,SAAS,OAAO;GACd,OAAO,GAAG,YAAY,uBAAuB,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,GAAG;GACrG,IAAI;IACF,GAAG,OAAO,WAAW,EAAE,OAAO,KAAK,CAAC;GACtC,QAAQ,CAER;EACF;CACF;CAEA,OAAO;EACL,eAAe;EACf,OAAO,SAAS,KAAK,MAAM,WAAW,OAAO,SAAS,IAAI;EAE1D,KAAK,QAAQ;GACX,OAAO,CAAC,GAAG,KAAK,QAAQ,aAAa,SAAS,SAAS,OAAO,IAAI,GAAG,MAAM;GAC3E,MAAM;EACR;EAEA,OAAO,MAAM;GACX,MAAM,OAAO,KAAK,QAAQ,aAAa,SAAS,SAAS,IAAI;GAC7D,IAAI,KAAK,WAAW,KAAK,QAAQ,OAAO;GACxC,OAAO;GACP,MAAM;GACN,OAAO;EACT;CACF;AACF"}

package/dist/src/services/durableNavigation/docs.cjs

@@ -0,0 +1,15 @@
+//#region src/services/durableNavigation/docs.ts
+/**
+* External session identity is independent of the currently selected conversation. A fork's source is its
+* `ConversationRecord.parent`; stores written before that remain readable with an ignored `branches` field.
+*/
+const DurableNavigationDoc = (0, require("@earendil-works/pi-durable").defineDoc)({
+	kind: "po.navigation",
+	version: 1,
+	scope: "session",
+	initial: () => ({ activeConversationId: null })
+});
+//#endregion
+exports.DurableNavigationDoc = DurableNavigationDoc;
+
+//# sourceMappingURL=docs.cjs.map

package/dist/src/services/durableNavigation/docs.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs.cjs","names":["defineDoc"],"sources":["../../../../src/services/durableNavigation/docs.ts"],"sourcesContent":["import { defineDoc, type ConversationId } from '@earendil-works/pi-durable';\n\n/**\n * External session identity is independent of the currently selected conversation. A fork's source is its\n * `ConversationRecord.parent`; stores written before that remain readable with an ignored `branches` field.\n */\nexport const DurableNavigationDoc = defineDoc<{ activeConversationId: ConversationId | null }>({\n  kind: 'po.navigation',\n  version: 1,\n  scope: 'session',\n  initial: () => ({ activeConversationId: null }),\n});\n"],"mappings":";;;;;AAMA,MAAa,wBAAA,uCAAuBA,CAAAA,CAAAA,UAAAA,CAA2D;CAC7F,MAAM;CACN,SAAS;CACT,OAAO;CACP,gBAAgB,EAAE,sBAAsB,KAAK;AAC/C,CAAC"}

package/dist/src/services/durableNavigation/docs.mjs

@@ -0,0 +1,16 @@
+import { defineDoc } from "@earendil-works/pi-durable";
+//#region src/services/durableNavigation/docs.ts
+/**
+* External session identity is independent of the currently selected conversation. A fork's source is its
+* `ConversationRecord.parent`; stores written before that remain readable with an ignored `branches` field.
+*/
+const DurableNavigationDoc = defineDoc({
+	kind: "po.navigation",
+	version: 1,
+	scope: "session",
+	initial: () => ({ activeConversationId: null })
+});
+//#endregion
+export { DurableNavigationDoc };
+
+//# sourceMappingURL=docs.mjs.map

package/dist/src/services/durableNavigation/docs.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs.mjs","names":[],"sources":["../../../../src/services/durableNavigation/docs.ts"],"sourcesContent":["import { defineDoc, type ConversationId } from '@earendil-works/pi-durable';\n\n/**\n * External session identity is independent of the currently selected conversation. A fork's source is its\n * `ConversationRecord.parent`; stores written before that remain readable with an ignored `branches` field.\n */\nexport const DurableNavigationDoc = defineDoc<{ activeConversationId: ConversationId | null }>({\n  kind: 'po.navigation',\n  version: 1,\n  scope: 'session',\n  initial: () => ({ activeConversationId: null }),\n});\n"],"mappings":";;;;;;AAMA,MAAa,uBAAuB,UAA2D;CAC7F,MAAM;CACN,SAAS;CACT,OAAO;CACP,gBAAgB,EAAE,sBAAsB,KAAK;AAC/C,CAAC"}

package/dist/src/services/durableNavigation/index.cjs

@@ -1,19 +1,10 @@
+const require_docs = require("./docs.cjs");
 //#region src/services/durableNavigation/index.ts
-/** External session identity is independent of the currently selected conversation. */
-const DurableNavigationDoc = (0, require("@earendil-works/pi-durable").defineDoc)({
-	kind: "po.navigation",
-	version: 1,
-	scope: "session",
-	initial: () => ({
-		activeConversationId: null,
-		branches: []
-	})
-});
 /** Select the initial conversation without overwriting a previously persisted selection. */
 async function initializeDurableNavigation(session, conversationId, context) {
 	return session.commit(async (tx) => {
 		if (!await tx.conversation(conversationId)) throw new Error("Initial conversation does not exist");
-		const navigation = await tx.doc(DurableNavigationDoc);
+		const navigation = await tx.doc(require_docs.DurableNavigationDoc);
 		navigation.activeConversationId ??= conversationId;
 		return navigation.activeConversationId;
 	}, context);
@@ -25,21 +16,15 @@ async function initializeDurableNavigation(session, conversationId, context) {
 */
 async function navigateDurableConversation(session, expectedConversationId, targetId, context, options) {
 	return session.commit(async (tx) => {
-		const navigation = await tx.doc(DurableNavigationDoc);
+		const navigation = await tx.doc(require_docs.DurableNavigationDoc);
 		if (navigation.activeConversationId !== expectedConversationId) throw new Error("The active conversation changed during navigation");
 		const next = targetId === null ? await tx.createConversation({ ownership: { kind: "ownerless" } }) : await tx.forkConversation(expectedConversationId, targetId, { ownership: { kind: "ownerless" } });
 		if (options?.summary) await tx.appendEntry(next.id, options.summary);
-		navigation.branches.push({
-			conversationId: next.id,
-			sourceConversationId: expectedConversationId,
-			targetId
-		});
 		navigation.activeConversationId = next.id;
 		return next.id;
 	}, context);
 }
 //#endregion
-exports.DurableNavigationDoc = DurableNavigationDoc;
 exports.initializeDurableNavigation = initializeDurableNavigation;
 exports.navigateDurableConversation = navigateDurableConversation;
 

package/dist/src/services/durableNavigation/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":["defineDoc"],"sources":["../../../../src/services/durableNavigation/index.ts"],"sourcesContent":["import type { Context } from '@earendil-works/chord';\nimport {\n  defineDoc,\n  type ConversationId,\n  type EntryDraft,\n  type EntryId,\n  type Session,\n} from '@earendil-works/pi-durable';\n\n/** External session identity is independent of the currently selected conversation. */\nexport const DurableNavigationDoc = defineDoc<{\n  activeConversationId: ConversationId | null;\n  branches: { conversationId: ConversationId; sourceConversationId: ConversationId; targetId: EntryId | null }[];\n}>({\n  kind: 'po.navigation',\n  version: 1,\n  scope: 'session',\n  initial: () => ({ activeConversationId: null, branches: [] }),\n});\n\n/** Select the initial conversation without overwriting a previously persisted selection. */\nexport async function initializeDurableNavigation(\n  session: Session,\n  conversationId: ConversationId,\n  context: Context,\n): Promise<ConversationId> {\n  return session.commit(async (tx) => {\n    if (!(await tx.conversation(conversationId))) throw new Error('Initial conversation does not exist');\n    const navigation = await tx.doc(DurableNavigationDoc);\n    navigation.activeConversationId ??= conversationId;\n    return navigation.activeConversationId;\n  }, context);\n}\n\n/**\n * Fork the selected history, retaining its abandoned tail. A head marker alone cannot rewind.\n * The caller must settle active work and prepare any summary before entering this transaction.\n * Expected selection guards against a stale asynchronous summary switching a newer selection.\n */\nexport async function navigateDurableConversation(\n  session: Session,\n  expectedConversationId: ConversationId,\n  targetId: EntryId | null,\n  context: Context,\n  options?: { summary?: EntryDraft },\n): Promise<ConversationId> {\n  return session.commit(async (tx) => {\n    const navigation = await tx.doc(DurableNavigationDoc);\n    if (navigation.activeConversationId !== expectedConversationId)\n      throw new Error('The active conversation changed during navigation');\n    const next =\n      targetId === null\n        ? await tx.createConversation({ ownership: { kind: 'ownerless' } })\n        : await tx.forkConversation(expectedConversationId, targetId, { ownership: { kind: 'ownerless' } });\n    if (options?.summary) await tx.appendEntry(next.id, options.summary);\n    navigation.branches.push({\n      conversationId: next.id,\n      sourceConversationId: expectedConversationId,\n      targetId,\n    });\n    navigation.activeConversationId = next.id;\n    return next.id;\n  }, context);\n}\n"],"mappings":";;AAUA,MAAa,wBAAA,uCAAuBA,CAAAA,CAAAA,UAAAA,CAGjC;CACD,MAAM;CACN,SAAS;CACT,OAAO;CACP,gBAAgB;EAAE,sBAAsB;EAAM,UAAU,CAAC;CAAE;AAC7D,CAAC;;AAGD,eAAsB,4BACpB,SACA,gBACA,SACyB;CACzB,OAAO,QAAQ,OAAO,OAAO,OAAO;EAClC,IAAI,CAAE,MAAM,GAAG,aAAa,cAAc,GAAI,MAAM,IAAI,MAAM,qCAAqC;EACnG,MAAM,aAAa,MAAM,GAAG,IAAI,oBAAoB;EACpD,WAAW,yBAAyB;EACpC,OAAO,WAAW;CACpB,GAAG,OAAO;AACZ;;;;;;AAOA,eAAsB,4BACpB,SACA,wBACA,UACA,SACA,SACyB;CACzB,OAAO,QAAQ,OAAO,OAAO,OAAO;EAClC,MAAM,aAAa,MAAM,GAAG,IAAI,oBAAoB;EACpD,IAAI,WAAW,yBAAyB,wBACtC,MAAM,IAAI,MAAM,mDAAmD;EACrE,MAAM,OACJ,aAAa,OACT,MAAM,GAAG,mBAAmB,EAAE,WAAW,EAAE,MAAM,YAAY,EAAE,CAAC,IAChE,MAAM,GAAG,iBAAiB,wBAAwB,UAAU,EAAE,WAAW,EAAE,MAAM,YAAY,EAAE,CAAC;EACtG,IAAI,SAAS,SAAS,MAAM,GAAG,YAAY,KAAK,IAAI,QAAQ,OAAO;EACnE,WAAW,SAAS,KAAK;GACvB,gBAAgB,KAAK;GACrB,sBAAsB;GACtB;EACF,CAAC;EACD,WAAW,uBAAuB,KAAK;EACvC,OAAO,KAAK;CACd,GAAG,OAAO;AACZ"}
+{"version":3,"file":"index.cjs","names":["DurableNavigationDoc"],"sources":["../../../../src/services/durableNavigation/index.ts"],"sourcesContent":["import type { Context } from '@earendil-works/chord';\nimport type { ConversationId, EntryDraft, EntryId, Session } from '@earendil-works/pi-durable';\n\nimport { DurableNavigationDoc } from './docs';\n/** Select the initial conversation without overwriting a previously persisted selection. */\nexport async function initializeDurableNavigation(\n  session: Session,\n  conversationId: ConversationId,\n  context: Context,\n): Promise<ConversationId> {\n  return session.commit(async (tx) => {\n    if (!(await tx.conversation(conversationId))) throw new Error('Initial conversation does not exist');\n    const navigation = await tx.doc(DurableNavigationDoc);\n    navigation.activeConversationId ??= conversationId;\n    return navigation.activeConversationId;\n  }, context);\n}\n\n/**\n * Fork the selected history, retaining its abandoned tail. A head marker alone cannot rewind.\n * The caller must settle active work and prepare any summary before entering this transaction.\n * Expected selection guards against a stale asynchronous summary switching a newer selection.\n */\nexport async function navigateDurableConversation(\n  session: Session,\n  expectedConversationId: ConversationId,\n  targetId: EntryId | null,\n  context: Context,\n  options?: { summary?: EntryDraft },\n): Promise<ConversationId> {\n  return session.commit(async (tx) => {\n    const navigation = await tx.doc(DurableNavigationDoc);\n    if (navigation.activeConversationId !== expectedConversationId)\n      throw new Error('The active conversation changed during navigation');\n    const next =\n      targetId === null\n        ? await tx.createConversation({ ownership: { kind: 'ownerless' } })\n        : await tx.forkConversation(expectedConversationId, targetId, { ownership: { kind: 'ownerless' } });\n    if (options?.summary) await tx.appendEntry(next.id, options.summary);\n    navigation.activeConversationId = next.id;\n    return next.id;\n  }, context);\n}\n"],"mappings":";;;AAKA,eAAsB,4BACpB,SACA,gBACA,SACyB;CACzB,OAAO,QAAQ,OAAO,OAAO,OAAO;EAClC,IAAI,CAAE,MAAM,GAAG,aAAa,cAAc,GAAI,MAAM,IAAI,MAAM,qCAAqC;EACnG,MAAM,aAAa,MAAM,GAAG,IAAIA,aAAAA,oBAAoB;EACpD,WAAW,yBAAyB;EACpC,OAAO,WAAW;CACpB,GAAG,OAAO;AACZ;;;;;;AAOA,eAAsB,4BACpB,SACA,wBACA,UACA,SACA,SACyB;CACzB,OAAO,QAAQ,OAAO,OAAO,OAAO;EAClC,MAAM,aAAa,MAAM,GAAG,IAAIA,aAAAA,oBAAoB;EACpD,IAAI,WAAW,yBAAyB,wBACtC,MAAM,IAAI,MAAM,mDAAmD;EACrE,MAAM,OACJ,aAAa,OACT,MAAM,GAAG,mBAAmB,EAAE,WAAW,EAAE,MAAM,YAAY,EAAE,CAAC,IAChE,MAAM,GAAG,iBAAiB,wBAAwB,UAAU,EAAE,WAAW,EAAE,MAAM,YAAY,EAAE,CAAC;EACtG,IAAI,SAAS,SAAS,MAAM,GAAG,YAAY,KAAK,IAAI,QAAQ,OAAO;EACnE,WAAW,uBAAuB,KAAK;EACvC,OAAO,KAAK;CACd,GAAG,OAAO;AACZ"}

package/dist/src/services/durableNavigation/index.mjs

@@ -1,15 +1,5 @@
-import { defineDoc } from "@earendil-works/pi-durable";
+import { DurableNavigationDoc } from "./docs.mjs";
 //#region src/services/durableNavigation/index.ts
-/** External session identity is independent of the currently selected conversation. */
-const DurableNavigationDoc = defineDoc({
-	kind: "po.navigation",
-	version: 1,
-	scope: "session",
-	initial: () => ({
-		activeConversationId: null,
-		branches: []
-	})
-});
 /** Select the initial conversation without overwriting a previously persisted selection. */
 async function initializeDurableNavigation(session, conversationId, context) {
 	return session.commit(async (tx) => {
@@ -30,16 +20,11 @@ async function navigateDurableConversation(session, expectedConversationId, targ
 		if (navigation.activeConversationId !== expectedConversationId) throw new Error("The active conversation changed during navigation");
 		const next = targetId === null ? await tx.createConversation({ ownership: { kind: "ownerless" } }) : await tx.forkConversation(expectedConversationId, targetId, { ownership: { kind: "ownerless" } });
 		if (options?.summary) await tx.appendEntry(next.id, options.summary);
-		navigation.branches.push({
-			conversationId: next.id,
-			sourceConversationId: expectedConversationId,
-			targetId
-		});
 		navigation.activeConversationId = next.id;
 		return next.id;
 	}, context);
 }
 //#endregion
-export { DurableNavigationDoc, initializeDurableNavigation, navigateDurableConversation };
+export { initializeDurableNavigation, navigateDurableConversation };
 
 //# sourceMappingURL=index.mjs.map

package/dist/src/services/durableNavigation/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../../../../src/services/durableNavigation/index.ts"],"sourcesContent":["import type { Context } from '@earendil-works/chord';\nimport {\n  defineDoc,\n  type ConversationId,\n  type EntryDraft,\n  type EntryId,\n  type Session,\n} from '@earendil-works/pi-durable';\n\n/** External session identity is independent of the currently selected conversation. */\nexport const DurableNavigationDoc = defineDoc<{\n  activeConversationId: ConversationId | null;\n  branches: { conversationId: ConversationId; sourceConversationId: ConversationId; targetId: EntryId | null }[];\n}>({\n  kind: 'po.navigation',\n  version: 1,\n  scope: 'session',\n  initial: () => ({ activeConversationId: null, branches: [] }),\n});\n\n/** Select the initial conversation without overwriting a previously persisted selection. */\nexport async function initializeDurableNavigation(\n  session: Session,\n  conversationId: ConversationId,\n  context: Context,\n): Promise<ConversationId> {\n  return session.commit(async (tx) => {\n    if (!(await tx.conversation(conversationId))) throw new Error('Initial conversation does not exist');\n    const navigation = await tx.doc(DurableNavigationDoc);\n    navigation.activeConversationId ??= conversationId;\n    return navigation.activeConversationId;\n  }, context);\n}\n\n/**\n * Fork the selected history, retaining its abandoned tail. A head marker alone cannot rewind.\n * The caller must settle active work and prepare any summary before entering this transaction.\n * Expected selection guards against a stale asynchronous summary switching a newer selection.\n */\nexport async function navigateDurableConversation(\n  session: Session,\n  expectedConversationId: ConversationId,\n  targetId: EntryId | null,\n  context: Context,\n  options?: { summary?: EntryDraft },\n): Promise<ConversationId> {\n  return session.commit(async (tx) => {\n    const navigation = await tx.doc(DurableNavigationDoc);\n    if (navigation.activeConversationId !== expectedConversationId)\n      throw new Error('The active conversation changed during navigation');\n    const next =\n      targetId === null\n        ? await tx.createConversation({ ownership: { kind: 'ownerless' } })\n        : await tx.forkConversation(expectedConversationId, targetId, { ownership: { kind: 'ownerless' } });\n    if (options?.summary) await tx.appendEntry(next.id, options.summary);\n    navigation.branches.push({\n      conversationId: next.id,\n      sourceConversationId: expectedConversationId,\n      targetId,\n    });\n    navigation.activeConversationId = next.id;\n    return next.id;\n  }, context);\n}\n"],"mappings":";;;AAUA,MAAa,uBAAuB,UAGjC;CACD,MAAM;CACN,SAAS;CACT,OAAO;CACP,gBAAgB;EAAE,sBAAsB;EAAM,UAAU,CAAC;CAAE;AAC7D,CAAC;;AAGD,eAAsB,4BACpB,SACA,gBACA,SACyB;CACzB,OAAO,QAAQ,OAAO,OAAO,OAAO;EAClC,IAAI,CAAE,MAAM,GAAG,aAAa,cAAc,GAAI,MAAM,IAAI,MAAM,qCAAqC;EACnG,MAAM,aAAa,MAAM,GAAG,IAAI,oBAAoB;EACpD,WAAW,yBAAyB;EACpC,OAAO,WAAW;CACpB,GAAG,OAAO;AACZ;;;;;;AAOA,eAAsB,4BACpB,SACA,wBACA,UACA,SACA,SACyB;CACzB,OAAO,QAAQ,OAAO,OAAO,OAAO;EAClC,MAAM,aAAa,MAAM,GAAG,IAAI,oBAAoB;EACpD,IAAI,WAAW,yBAAyB,wBACtC,MAAM,IAAI,MAAM,mDAAmD;EACrE,MAAM,OACJ,aAAa,OACT,MAAM,GAAG,mBAAmB,EAAE,WAAW,EAAE,MAAM,YAAY,EAAE,CAAC,IAChE,MAAM,GAAG,iBAAiB,wBAAwB,UAAU,EAAE,WAAW,EAAE,MAAM,YAAY,EAAE,CAAC;EACtG,IAAI,SAAS,SAAS,MAAM,GAAG,YAAY,KAAK,IAAI,QAAQ,OAAO;EACnE,WAAW,SAAS,KAAK;GACvB,gBAAgB,KAAK;GACrB,sBAAsB;GACtB;EACF,CAAC;EACD,WAAW,uBAAuB,KAAK;EACvC,OAAO,KAAK;CACd,GAAG,OAAO;AACZ"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../../src/services/durableNavigation/index.ts"],"sourcesContent":["import type { Context } from '@earendil-works/chord';\nimport type { ConversationId, EntryDraft, EntryId, Session } from '@earendil-works/pi-durable';\n\nimport { DurableNavigationDoc } from './docs';\n/** Select the initial conversation without overwriting a previously persisted selection. */\nexport async function initializeDurableNavigation(\n  session: Session,\n  conversationId: ConversationId,\n  context: Context,\n): Promise<ConversationId> {\n  return session.commit(async (tx) => {\n    if (!(await tx.conversation(conversationId))) throw new Error('Initial conversation does not exist');\n    const navigation = await tx.doc(DurableNavigationDoc);\n    navigation.activeConversationId ??= conversationId;\n    return navigation.activeConversationId;\n  }, context);\n}\n\n/**\n * Fork the selected history, retaining its abandoned tail. A head marker alone cannot rewind.\n * The caller must settle active work and prepare any summary before entering this transaction.\n * Expected selection guards against a stale asynchronous summary switching a newer selection.\n */\nexport async function navigateDurableConversation(\n  session: Session,\n  expectedConversationId: ConversationId,\n  targetId: EntryId | null,\n  context: Context,\n  options?: { summary?: EntryDraft },\n): Promise<ConversationId> {\n  return session.commit(async (tx) => {\n    const navigation = await tx.doc(DurableNavigationDoc);\n    if (navigation.activeConversationId !== expectedConversationId)\n      throw new Error('The active conversation changed during navigation');\n    const next =\n      targetId === null\n        ? await tx.createConversation({ ownership: { kind: 'ownerless' } })\n        : await tx.forkConversation(expectedConversationId, targetId, { ownership: { kind: 'ownerless' } });\n    if (options?.summary) await tx.appendEntry(next.id, options.summary);\n    navigation.activeConversationId = next.id;\n    return next.id;\n  }, context);\n}\n"],"mappings":";;;AAKA,eAAsB,4BACpB,SACA,gBACA,SACyB;CACzB,OAAO,QAAQ,OAAO,OAAO,OAAO;EAClC,IAAI,CAAE,MAAM,GAAG,aAAa,cAAc,GAAI,MAAM,IAAI,MAAM,qCAAqC;EACnG,MAAM,aAAa,MAAM,GAAG,IAAI,oBAAoB;EACpD,WAAW,yBAAyB;EACpC,OAAO,WAAW;CACpB,GAAG,OAAO;AACZ;;;;;;AAOA,eAAsB,4BACpB,SACA,wBACA,UACA,SACA,SACyB;CACzB,OAAO,QAAQ,OAAO,OAAO,OAAO;EAClC,MAAM,aAAa,MAAM,GAAG,IAAI,oBAAoB;EACpD,IAAI,WAAW,yBAAyB,wBACtC,MAAM,IAAI,MAAM,mDAAmD;EACrE,MAAM,OACJ,aAAa,OACT,MAAM,GAAG,mBAAmB,EAAE,WAAW,EAAE,MAAM,YAAY,EAAE,CAAC,IAChE,MAAM,GAAG,iBAAiB,wBAAwB,UAAU,EAAE,WAAW,EAAE,MAAM,YAAY,EAAE,CAAC;EACtG,IAAI,SAAS,SAAS,MAAM,GAAG,YAAY,KAAK,IAAI,QAAQ,OAAO;EACnE,WAAW,uBAAuB,KAAK;EACvC,OAAO,KAAK;CACd,GAAG,OAAO;AACZ"}

package/dist/src/services/durableQueue/docs.cjs

@@ -0,0 +1,12 @@
+//#region src/services/durableQueue/docs.ts
+/** Po's inputs held outside pi.inbox: paused inputs, explicitly queued inputs, and abort intent. */
+const HeldQueueDoc = (0, require("@earendil-works/pi-durable").defineDoc)({
+	kind: "po.queue.held",
+	version: 1,
+	scope: "session",
+	initial: () => ({ json: "{\"revision\":0,\"paused\":false,\"held\":[]}" })
+});
+//#endregion
+exports.HeldQueueDoc = HeldQueueDoc;
+
+//# sourceMappingURL=docs.cjs.map

package/dist/src/services/durableQueue/docs.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs.cjs","names":["defineDoc"],"sources":["../../../../src/services/durableQueue/docs.ts"],"sourcesContent":["import { defineDoc } from '@earendil-works/pi-durable';\n\n/** Po's inputs held outside pi.inbox: paused inputs, explicitly queued inputs, and abort intent. */\nexport const HeldQueueDoc = defineDoc({\n  kind: 'po.queue.held',\n  version: 1,\n  scope: 'session',\n  initial: () => ({ json: '{\"revision\":0,\"paused\":false,\"held\":[]}' }),\n});\n"],"mappings":";;AAGA,MAAa,gBAAA,uCAAeA,CAAAA,CAAAA,UAAAA,CAAU;CACpC,MAAM;CACN,SAAS;CACT,OAAO;CACP,gBAAgB,EAAE,MAAM,gDAA0C;AACpE,CAAC"}

package/dist/src/services/durableQueue/docs.mjs

@@ -0,0 +1,13 @@
+import { defineDoc } from "@earendil-works/pi-durable";
+//#region src/services/durableQueue/docs.ts
+/** Po's inputs held outside pi.inbox: paused inputs, explicitly queued inputs, and abort intent. */
+const HeldQueueDoc = defineDoc({
+	kind: "po.queue.held",
+	version: 1,
+	scope: "session",
+	initial: () => ({ json: "{\"revision\":0,\"paused\":false,\"held\":[]}" })
+});
+//#endregion
+export { HeldQueueDoc };
+
+//# sourceMappingURL=docs.mjs.map

package/dist/src/services/durableQueue/docs.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs.mjs","names":[],"sources":["../../../../src/services/durableQueue/docs.ts"],"sourcesContent":["import { defineDoc } from '@earendil-works/pi-durable';\n\n/** Po's inputs held outside pi.inbox: paused inputs, explicitly queued inputs, and abort intent. */\nexport const HeldQueueDoc = defineDoc({\n  kind: 'po.queue.held',\n  version: 1,\n  scope: 'session',\n  initial: () => ({ json: '{\"revision\":0,\"paused\":false,\"held\":[]}' }),\n});\n"],"mappings":";;;AAGA,MAAa,eAAe,UAAU;CACpC,MAAM;CACN,SAAS;CACT,OAAO;CACP,gBAAgB,EAAE,MAAM,gDAA0C;AACpE,CAAC"}

package/dist/src/services/durableQueue/index.cjs

@@ -0,0 +1,151 @@
+const require_docs = require("./docs.cjs");
+let _earendil_works_pi_durable = require("@earendil-works/pi-durable");
+//#region src/services/durableQueue/index.ts
+/** pi-durable deduplicates by request ID, so a held input can be handed over again after a crash. */
+const heldRequestId = (id) => `po.queue:${id}`;
+/** The pi.inbox content of a held or freshly submitted input. */
+function heldContent(message, images) {
+	if (typeof message !== "string") {
+		if (message.role !== "user") throw new Error("Only user messages can admit an agent run");
+		return message.content;
+	}
+	return images?.length ? [{
+		type: "text",
+		text: message
+	}, ...images] : message;
+}
+/** Appends the entry an input is placed as: `entry`'s kind and data, or `pi.user`, as pi-durable's own boundary does. */
+function appendInput(tx, conversationId, content, entry, now) {
+	const model = [{
+		role: "user",
+		content,
+		timestamp: now
+	}];
+	return entry ? tx.appendEntry(conversationId, {
+		kind: entry.kind,
+		...entry.data === void 0 ? {} : { data: entry.data },
+		model
+	}) : tx.appendEntry(_earendil_works_pi_durable.UserEntry, conversationId, { model });
+}
+/**
+* Promotes one explicitly queued input to steer its operation, or starts it from idle, in one commit with only public
+* Tx operations: target validation and the move from held to pi.inbox happen on the same Session mutation line.
+*
+* Mirrors pi-durable `harness/inbox.d.ts:42-52` (`prepareBoundary`/`applyBoundary` at `final`) and `admitSubmission`
+* in `harness/submissions.js`, which pi-durable does not export. Re-run the promote tests on every pi-durable upgrade.
+*/
+async function admitSelected(tx, conversationId, selection, modes, replay) {
+	const doc = await tx.doc(require_docs.HeldQueueDoc);
+	const record = JSON.parse(doc.json);
+	const requestId = heldRequestId(selection.id);
+	const accepted = await tx.submissionByRequest(conversationId, requestId);
+	if (accepted && accepted.type !== "input") throw new Error(`Request ${requestId} already identifies a submission of type ${accepted.type}`);
+	if (accepted && replay) return accepted.id;
+	if (accepted) return accepted.status === "queued" ? "in_flight" : "not_found";
+	const index = record.held.findIndex((q) => q.id === selection.id && q.explicitQueue);
+	if (index === -1) return "not_found";
+	const q = record.held[index];
+	const live = await tx.doc(_earendil_works_pi_durable.LiveDoc, conversationId);
+	const task = live.run ? await tx.task(live.run.taskId) : void 0;
+	if ((live.run ? String(live.run.inputs[0]) : void 0) !== selection.operationId || task?.abortRequested || live.run && record.abortOperationId === selection.operationId) return "target_changed";
+	if (!live.run) {
+		let page = await tx.scanTasks({
+			conversationId,
+			kind: _earendil_works_pi_durable.CompactionTask.definition.name,
+			background: false
+		}, 128);
+		while (true) {
+			if (page.items.some((task) => task.state.status !== "terminal")) return "target_changed";
+			if (!page.next) break;
+			page = await tx.scanTasks({
+				conversationId,
+				kind: _earendil_works_pi_durable.CompactionTask.definition.name,
+				background: false
+			}, 128, page.next);
+		}
+	}
+	const content = heldContent(q.message ?? q.text, q.images);
+	const inbox = await tx.doc(_earendil_works_pi_durable.InboxDoc, conversationId);
+	let head = live.run ? void 0 : (await tx.latestHeadMarker(conversationId))?.head;
+	const now = Date.now();
+	let id;
+	if (!live.run && inbox.items.length === 0) {
+		const entry = await appendInput(tx, conversationId, content, q.entry, now);
+		id = (await tx.createSubmission({
+			conversationId,
+			requestId,
+			type: "input",
+			status: "placed",
+			entry: entry.id
+		})).id;
+		live.run = {
+			taskId: await tx.createTask(_earendil_works_pi_durable.GenerationTask, {}, {
+				ownership: { kind: "conversation" },
+				conversationId
+			}),
+			inputs: [id]
+		};
+	} else {
+		id = (await tx.createSubmission({
+			conversationId,
+			requestId,
+			type: "input",
+			status: "queued"
+		})).id;
+		inbox.items.push({
+			id,
+			mode: "steer",
+			content: JSON.parse(JSON.stringify(content)),
+			...q.entry ? { entry: JSON.parse(JSON.stringify(q.entry)) } : {}
+		});
+		if (!live.run) {
+			const writes = inbox.items.flatMap((item, index) => item.mode === "write" ? [index] : []);
+			const pick = (mode) => {
+				const indexes = inbox.items.flatMap((item, index) => item.mode === mode ? [index] : []);
+				return (mode === "steer" ? modes.steeringMode : modes.followUpMode) === "all" ? indexes : indexes.slice(0, 1);
+			};
+			const users = [...pick("steer"), ...pick("followUp")].sort((a, b) => a - b);
+			for (const index of writes) {
+				const item = inbox.items[index];
+				if (item.mode !== "write") continue;
+				const draft = item.entry;
+				if (typeof draft.head === "number" && head !== void 0 && draft.head < head) {
+					tx.settleSubmission(item.id, {
+						status: "unanswered",
+						reason: "stale"
+					});
+					continue;
+				}
+				const entry = await tx.appendEntry(conversationId, draft);
+				if (draft.head !== void 0) head = draft.head === "self" ? entry.id : draft.head;
+				tx.placeSubmission(item.id, entry.id);
+			}
+			const inputs = [];
+			for (const index of users) {
+				const item = inbox.items[index];
+				if (item.mode === "write") continue;
+				const entry = await appendInput(tx, conversationId, item.content, item.entry, now);
+				tx.placeSubmission(item.id, entry.id);
+				inputs.push(item.id);
+			}
+			for (const index of [...writes, ...users].sort((a, b) => b - a)) inbox.items.splice(index, 1);
+			if (inputs.length) live.run = {
+				taskId: await tx.createTask(_earendil_works_pi_durable.GenerationTask, {}, {
+					ownership: { kind: "conversation" },
+					conversationId
+				}),
+				inputs
+			};
+		}
+	}
+	record.held.splice(index, 1);
+	record.revision++;
+	doc.json = JSON.stringify(record);
+	return id;
+}
+//#endregion
+exports.admitSelected = admitSelected;
+exports.heldContent = heldContent;
+exports.heldRequestId = heldRequestId;
+
+//# sourceMappingURL=index.cjs.map

package/dist/src/services/durableQueue/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":["UserEntry","HeldQueueDoc","LiveDoc","CompactionTask","InboxDoc","GenerationTask"],"sources":["../../../../src/services/durableQueue/index.ts"],"sourcesContent":["/**\n * Po's queue around pi.inbox. Follow-ups that are not paused go straight to pi.inbox; only paused and explicitly\n * queued inputs stay in `po.queue.held`, and a held input enters pi.inbox under its stable request ID.\n */\nimport type { ImageContent } from '@earendil-works/pi-ai';\nimport {\n  CompactionTask,\n  GenerationTask,\n  InboxDoc,\n  LiveDoc,\n  UserEntry,\n  type Conversation,\n  type ConversationId,\n  type HarnessSettings,\n  type InputEntry,\n  type SubmissionId,\n  type Tx,\n} from '@earendil-works/pi-durable';\n\nimport type { AgentMessage, DirectHarnessQueuedInput } from '../../types/server/directHarnessRuntime';\nimport { HeldQueueDoc } from './docs';\n\nexport type HeldInput = Omit<DirectHarnessQueuedInput, 'disposition'> & {\n  message?: AgentMessage;\n  // The entry the input is placed as instead of `pi.user`, kept when an abort moves a queued input here.\n  entry?: InputEntry;\n  // Only explicitly queued inputs are visible to, and removable or promotable by, the operator.\n  explicitQueue: boolean;\n};\nexport type HeldQueue = { revision: number; paused: boolean; abortOperationId?: string; held: HeldInput[] };\n\n/** pi-durable deduplicates by request ID, so a held input can be handed over again after a crash. */\nexport const heldRequestId = (id: string) => `po.queue:${id}`;\n\n/** The pi.inbox content of a held or freshly submitted input. */\nexport function heldContent(message: string | AgentMessage, images?: ImageContent[]) {\n  if (typeof message !== 'string') {\n    if (message.role !== 'user') throw new Error('Only user messages can admit an agent run');\n    return message.content;\n  }\n  return images?.length ? [{ type: 'text' as const, text: message }, ...images] : message;\n}\n\n/** Appends the entry an input is placed as: `entry`'s kind and data, or `pi.user`, as pi-durable's own boundary does. */\nfunction appendInput(\n  tx: Tx,\n  conversationId: ConversationId,\n  content: ReturnType<typeof heldContent>,\n  entry: InputEntry | undefined,\n  now: number,\n) {\n  const model = [{ role: 'user' as const, content, timestamp: now }];\n  return entry\n    ? tx.appendEntry(conversationId, {\n        kind: entry.kind,\n        ...(entry.data === undefined ? {} : { data: entry.data }),\n        model,\n      })\n    : tx.appendEntry(UserEntry, conversationId, { model });\n}\n\n/**\n * Promotes one explicitly queued input to steer its operation, or starts it from idle, in one commit with only public\n * Tx operations: target validation and the move from held to pi.inbox happen on the same Session mutation line.\n *\n * Mirrors pi-durable `harness/inbox.d.ts:42-52` (`prepareBoundary`/`applyBoundary` at `final`) and `admitSubmission`\n * in `harness/submissions.js`, which pi-durable does not export. Re-run the promote tests on every pi-durable upgrade.\n */\nexport async function admitSelected(\n  tx: Tx,\n  conversationId: ConversationId,\n  selection: { id: string; operationId?: string },\n  modes: Pick<HarnessSettings, 'steeringMode' | 'followUpMode'>,\n  replay: boolean,\n): Promise<SubmissionId | 'not_found' | 'in_flight' | 'target_changed'> {\n  const doc = await tx.doc(HeldQueueDoc);\n  const record = JSON.parse(doc.json) as HeldQueue;\n  const requestId = heldRequestId(selection.id);\n  // An accepted request survives completion/replacement and a lost acknowledgement.\n  const accepted = await tx.submissionByRequest(conversationId, requestId);\n  if (accepted && accepted.type !== 'input')\n    throw new Error(`Request ${requestId} already identifies a submission of type ${accepted.type}`);\n  if (accepted && replay) return accepted.id;\n  if (accepted) return accepted.status === 'queued' ? 'in_flight' : 'not_found';\n  const index = record.held.findIndex((q) => q.id === selection.id && q.explicitQueue);\n  if (index === -1) return 'not_found';\n  const q = record.held[index]!;\n  const live = await tx.doc(LiveDoc, conversationId);\n  const task = live.run ? await tx.task(live.run.taskId) : undefined;\n  if (\n    (live.run ? String(live.run.inputs[0]) : undefined) !== selection.operationId ||\n    task?.abortRequested ||\n    (live.run && record.abortOperationId === selection.operationId)\n  )\n    return 'target_changed';\n  if (!live.run) {\n    let page = await tx.scanTasks({ conversationId, kind: CompactionTask.definition.name, background: false }, 128);\n    while (true) {\n      if (page.items.some((task) => task.state.status !== 'terminal')) return 'target_changed';\n      if (!page.next) break;\n      page = await tx.scanTasks(\n        { conversationId, kind: CompactionTask.definition.name, background: false },\n        128,\n        page.next,\n      );\n    }\n  }\n  const content = heldContent(q.message ?? q.text, q.images);\n  const inbox = await tx.doc(InboxDoc, conversationId);\n  // Native final boundaries read the active head before any table writes.\n  let head = live.run ? undefined : (await tx.latestHeadMarker(conversationId))?.head;\n  const now = Date.now();\n  let id: SubmissionId;\n  if (!live.run && inbox.items.length === 0) {\n    const entry = await appendInput(tx, conversationId, content, q.entry, now);\n    id = (await tx.createSubmission({ conversationId, requestId, type: 'input', status: 'placed', entry: entry.id }))\n      .id;\n    live.run = {\n      taskId: await tx.createTask(GenerationTask, {}, { ownership: { kind: 'conversation' }, conversationId }),\n      inputs: [id],\n    };\n  } else {\n    id = (await tx.createSubmission({ conversationId, requestId, type: 'input', status: 'queued' })).id;\n    inbox.items.push({\n      id,\n      mode: 'steer',\n      content: JSON.parse(JSON.stringify(content)) as typeof content,\n      ...(q.entry ? { entry: JSON.parse(JSON.stringify(q.entry)) as InputEntry } : {}),\n    });\n    if (!live.run) {\n      // Preserve native write-first placement, stale heads, queue modes and\n      // positional input order rather than restarting just the selected input.\n      const writes = inbox.items.flatMap((item, index) => (item.mode === 'write' ? [index] : []));\n      const pick = (mode: 'steer' | 'followUp') => {\n        const indexes = inbox.items.flatMap((item, index) => (item.mode === mode ? [index] : []));\n        const queueMode = mode === 'steer' ? modes.steeringMode : modes.followUpMode;\n        return queueMode === 'all' ? indexes : indexes.slice(0, 1);\n      };\n      const users = [...pick('steer'), ...pick('followUp')].sort((a, b) => a - b);\n      for (const index of writes) {\n        const item = inbox.items[index]!;\n        if (item.mode !== 'write') continue;\n        // Public InboxDoc represents native write drafts as JsonObject.\n        const draft = item.entry as unknown as Extract<\n          Parameters<Conversation['submit']>[0],\n          { type: 'write' }\n        >['entry'];\n        if (typeof draft.head === 'number' && head !== undefined && draft.head < head) {\n          tx.settleSubmission(item.id, { status: 'unanswered', reason: 'stale' });\n          continue;\n        }\n        const entry = await tx.appendEntry(conversationId, draft);\n        if (draft.head !== undefined) head = draft.head === 'self' ? entry.id : draft.head;\n        tx.placeSubmission(item.id, entry.id);\n      }\n      const inputs: SubmissionId[] = [];\n      for (const index of users) {\n        const item = inbox.items[index]!;\n        if (item.mode === 'write') continue;\n        const entry = await appendInput(tx, conversationId, item.content, item.entry, now);\n        tx.placeSubmission(item.id, entry.id);\n        inputs.push(item.id);\n      }\n      for (const index of [...writes, ...users].sort((a, b) => b - a)) inbox.items.splice(index, 1);\n      if (inputs.length)\n        live.run = {\n          taskId: await tx.createTask(GenerationTask, {}, { ownership: { kind: 'conversation' }, conversationId }),\n          inputs,\n        };\n    }\n  }\n  record.held.splice(index, 1);\n  record.revision++;\n  doc.json = JSON.stringify(record);\n  return id;\n}\n"],"mappings":"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"}