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

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

@@ -0,0 +1,125 @@
+import { DOOM_NOTIFICATION_ENTRY_TYPE, createDoomNotificationEntryData } from "../../schemas/notification.mjs";
+import "../../../notification.mjs";
+import { randomUUID } from "node:crypto";
+//#region src/services/headlessClient/index.ts
+/** Explicit client interactions over the existing browser dialog protocol. */
+function createHeadlessClient(options) {
+	const pending = /* @__PURE__ */ new Map();
+	let disposed = false;
+	const advance = () => pending.values().next().value?.start();
+	return {
+		client: {
+			async notify(request) {
+				if (disposed) throw new Error("Headless client is closed");
+				const data = createDoomNotificationEntryData(request);
+				if (!data) throw new Error("Invalid notification request");
+				try {
+					await options.appendCustomEntry(DOOM_NOTIFICATION_ENTRY_TYPE, data);
+				} catch (error) {
+					options.emitFrame({
+						type: "error",
+						code: "notification_undelivered",
+						error: `${data.body} (not saved to history: ${error instanceof Error ? error.message : String(error)})`
+					});
+				}
+			},
+			setStatus(source, text) {
+				if (disposed) throw new Error("Headless client is closed");
+				options.emitFrame({
+					type: "extension_ui_request",
+					method: "setStatus",
+					statusKey: source,
+					statusText: text
+				});
+			},
+			appendComposerText(text) {
+				if (disposed) throw new Error("Headless client is closed");
+				options.emitFrame({
+					type: "extension_ui_request",
+					method: "append_composer_text",
+					id: randomUUID(),
+					text
+				});
+			},
+			request(request, signal) {
+				if (disposed) return Promise.reject(/* @__PURE__ */ new Error("Headless client is closed"));
+				if (signal?.aborted) return Promise.resolve(void 0);
+				if (![
+					"confirm",
+					"select",
+					"input"
+				].includes(request.kind)) return Promise.reject(/* @__PURE__ */ new Error("Unsupported headless client request"));
+				const labels = request.options?.map((option) => option.label);
+				if (labels && new Set(labels).size !== labels.length) return Promise.reject(/* @__PURE__ */ new Error("Select option labels must be unique"));
+				const id = `headless-ui:${randomUUID()}`;
+				return new Promise((resolve, reject) => {
+					let started = false;
+					const finish = (outcome) => {
+						if (!pending.delete(id)) return;
+						signal?.removeEventListener("abort", abort);
+						try {
+							if (started) options.emitFrame({
+								type: "extension_ui_answered",
+								id
+							});
+							if ("error" in outcome) reject(outcome.error);
+							else resolve(outcome.value);
+						} catch (error) {
+							reject(error);
+						} finally {
+							advance();
+						}
+					};
+					const abort = () => finish({ value: void 0 });
+					pending.set(id, {
+						start() {
+							if (started || disposed) return;
+							started = true;
+							try {
+								options.emitFrame({
+									type: "extension_ui_request",
+									id,
+									method: request.kind === "input" && request.multiline ? "editor" : request.kind,
+									title: request.title,
+									message: request.message,
+									options: labels,
+									placeholder: request.message,
+									prefill: request.initialValue
+								});
+							} catch (error) {
+								finish({ error });
+							}
+						},
+						respond(frame) {
+							if (!started) return;
+							if (frame.cancelled === true) return finish({ value: void 0 });
+							if (request.kind === "confirm") {
+								if (typeof frame.confirmed === "boolean") finish({ value: frame.confirmed });
+							} else if (typeof frame.value === "string") {
+								const selected = request.options?.find((option) => option.label === frame.value);
+								finish({ value: selected?.value ?? frame.value });
+							}
+						},
+						close: () => finish({ error: /* @__PURE__ */ new Error("Headless client is closed") })
+					});
+					signal?.addEventListener("abort", abort, { once: true });
+					advance();
+				});
+			}
+		},
+		receive(frame) {
+			if (frame.type !== "extension_ui_response") return false;
+			if (typeof frame.id === "string") pending.get(frame.id)?.respond(frame);
+			return true;
+		},
+		dispose() {
+			if (disposed) return;
+			disposed = true;
+			for (const request of pending.values()) request.close();
+		}
+	};
+}
+//#endregion
+export { createHeadlessClient };
+
+//# sourceMappingURL=index.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../../src/services/headlessClient/index.ts"],"sourcesContent":["import { randomUUID } from 'node:crypto';\n\nimport { createDoomNotificationEntryData, DOOM_NOTIFICATION_ENTRY_TYPE } from '../../exports/notification';\nimport type {\n  HeadlessClientBridge,\n  HeadlessClientOptions,\n  PendingClientRequest,\n} from '../../types/server/headlessClient';\n\n/** Explicit client interactions over the existing browser dialog protocol. */\nexport function createHeadlessClient(options: HeadlessClientOptions): HeadlessClientBridge {\n  const pending = new Map<string, PendingClientRequest>();\n  let disposed = false;\n  const advance = (): void => pending.values().next().value?.start();\n\n  return {\n    client: {\n      async notify(request) {\n        if (disposed) throw new Error('Headless client is closed');\n        const data = createDoomNotificationEntryData(request);\n        if (!data) throw new Error('Invalid notification request');\n        try {\n          await options.appendCustomEntry(DOOM_NOTIFICATION_ENTRY_TYPE, data);\n        } catch (error) {\n          // Callers fire notify without awaiting, often to report a journal failure. A rejection here\n          // would crash the session server, so a refused append still reaches the browser live.\n          options.emitFrame({\n            type: 'error',\n            code: 'notification_undelivered',\n            error: `${data.body} (not saved to history: ${error instanceof Error ? error.message : String(error)})`,\n          });\n        }\n      },\n      setStatus(source, text) {\n        if (disposed) throw new Error('Headless client is closed');\n        options.emitFrame({ type: 'extension_ui_request', method: 'setStatus', statusKey: source, statusText: text });\n      },\n      appendComposerText(text) {\n        if (disposed) throw new Error('Headless client is closed');\n        options.emitFrame({ type: 'extension_ui_request', method: 'append_composer_text', id: randomUUID(), text });\n      },\n      request(request, signal) {\n        if (disposed) return Promise.reject(new Error('Headless client is closed'));\n        if (signal?.aborted) return Promise.resolve(undefined);\n        if (!['confirm', 'select', 'input'].includes(request.kind)) {\n          return Promise.reject(new Error('Unsupported headless client request'));\n        }\n        const labels = request.options?.map((option) => option.label);\n        if (labels && new Set(labels).size !== labels.length) {\n          return Promise.reject(new Error('Select option labels must be unique'));\n        }\n        const id = `headless-ui:${randomUUID()}`;\n        return new Promise((resolve, reject) => {\n          let started = false;\n          const finish = (outcome: { value: unknown } | { error: unknown }): void => {\n            if (!pending.delete(id)) return;\n            signal?.removeEventListener('abort', abort);\n            try {\n              if (started) options.emitFrame({ type: 'extension_ui_answered', id });\n              if ('error' in outcome) reject(outcome.error);\n              else resolve(outcome.value);\n            } catch (error) {\n              reject(error);\n            } finally {\n              advance();\n            }\n          };\n          const abort = (): void => finish({ value: undefined });\n          pending.set(id, {\n            start() {\n              if (started || disposed) return;\n              started = true;\n              try {\n                options.emitFrame({\n                  type: 'extension_ui_request',\n                  id,\n                  method: request.kind === 'input' && request.multiline ? 'editor' : request.kind,\n                  title: request.title,\n                  message: request.message,\n                  options: labels,\n                  placeholder: request.message,\n                  prefill: request.initialValue,\n                });\n              } catch (error) {\n                finish({ error });\n              }\n            },\n            respond(frame) {\n              if (!started) return;\n              if (frame.cancelled === true) return finish({ value: undefined });\n              if (request.kind === 'confirm') {\n                if (typeof frame.confirmed === 'boolean') finish({ value: frame.confirmed });\n              } else if (typeof frame.value === 'string') {\n                // Rich questionnaire clients return an encoded whole-answer envelope here.\n                const selected = request.options?.find((option) => option.label === frame.value);\n                finish({ value: selected?.value ?? frame.value });\n              }\n            },\n            close: () => finish({ error: new Error('Headless client is closed') }),\n          });\n          signal?.addEventListener('abort', abort, { once: true });\n          advance();\n        });\n      },\n    },\n    receive(frame) {\n      if (frame.type !== 'extension_ui_response') return false;\n      if (typeof frame.id === 'string') pending.get(frame.id)?.respond(frame);\n      return true;\n    },\n    dispose() {\n      if (disposed) return;\n      disposed = true;\n      for (const request of pending.values()) request.close();\n    },\n  };\n}\n"],"mappings":"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"}

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

@@ -0,0 +1,115 @@
+let _earendil_works_pi_agent_core = require("@earendil-works/pi-agent-core");
+//#region src/services/historyCreationFileSystem/index.ts
+function rejected(error, filePath) {
+	return {
+		ok: false,
+		error: new _earendil_works_pi_agent_core.FileError("unknown", error instanceof Error ? error.message : String(error), filePath, error instanceof Error ? error : void 0)
+	};
+}
+/**
+* Own the destination before pinned JsonlSessionRepo computes its final path.
+* Storage remains upstream-owned. Only acquisition and destructive cleanup are gated.
+* Pinned 0.86.0 stages at destination + '.tmp'; an unexpected write fails closed.
+*/
+function createHistoryCreationFileSystem(backend, beforeCreate) {
+	let destination;
+	let staging;
+	let admitted = false;
+	let stagingWritten = false;
+	let published = false;
+	return {
+		cwd: backend.cwd,
+		absolutePath: backend.absolutePath.bind(backend),
+		readTextFile: backend.readTextFile.bind(backend),
+		openTextLineReader: backend.openTextLineReader.bind(backend),
+		readTextLines: backend.readTextLines.bind(backend),
+		readBinaryFile: backend.readBinaryFile.bind(backend),
+		async appendFile(filePath, content, context) {
+			try {
+				if (!admitted || !(filePath === staging && stagingWritten) && !(filePath === destination && published)) return rejected(/* @__PURE__ */ new Error("Unowned history append"), filePath);
+				return await backend.appendFile(filePath, content, context);
+			} catch (error) {
+				return rejected(error, filePath);
+			}
+		},
+		fileInfo: backend.fileInfo.bind(backend),
+		listDir: backend.listDir.bind(backend),
+		canonicalPath: backend.canonicalPath.bind(backend),
+		exists: backend.exists.bind(backend),
+		createDir: backend.createDir.bind(backend),
+		createTempDir: backend.createTempDir.bind(backend),
+		createTempFile: backend.createTempFile.bind(backend),
+		cleanup: backend.cleanup.bind(backend),
+		async joinPath(parts, context) {
+			try {
+				const result = await backend.joinPath(parts, context);
+				if (!result.ok || !result.value.endsWith(".jsonl")) return result;
+				if (destination !== void 0) return rejected(/* @__PURE__ */ new Error("History creation destination was already selected"), result.value);
+				destination = result.value;
+				staging = `${destination}.tmp`;
+				const existing = await backend.exists(destination, context);
+				if (!existing.ok) return existing;
+				if (existing.value) return rejected(/* @__PURE__ */ new Error("Refusing to replace existing history"), destination);
+				await beforeCreate(destination);
+				for (const filePath of [destination, staging]) {
+					const found = await backend.exists(filePath, context);
+					if (!found.ok) return found;
+					if (found.value) return rejected(/* @__PURE__ */ new Error("History creation path is occupied"), filePath);
+				}
+				admitted = true;
+				return result;
+			} catch (error) {
+				return rejected(error, destination);
+			}
+		},
+		async writeFile(filePath, content, context) {
+			try {
+				if (!admitted || filePath !== staging || stagingWritten) return rejected(/* @__PURE__ */ new Error("Unowned history staging write"), filePath);
+				const existing = await backend.exists(filePath, context);
+				if (!existing.ok) return existing;
+				if (existing.value) return rejected(/* @__PURE__ */ new Error("History staging path is occupied"), filePath);
+				const result = await backend.writeFile(filePath, content, context);
+				if (result.ok) stagingWritten = true;
+				return result;
+			} catch (error) {
+				return rejected(error, filePath);
+			}
+		},
+		async renameFile(sourcePath, destinationPath, context) {
+			try {
+				if (!admitted || sourcePath !== staging || destinationPath !== destination || !stagingWritten) return rejected(/* @__PURE__ */ new Error("Unowned history publication"), destinationPath);
+				const result = await backend.renameFile(sourcePath, destinationPath, context);
+				if (result.ok) {
+					published = true;
+					stagingWritten = false;
+				}
+				return result;
+			} catch (error) {
+				return rejected(error, destinationPath);
+			}
+		},
+		async remove(filePath, options, context) {
+			try {
+				if (!(filePath === staging && stagingWritten || filePath === destination && published)) return {
+					ok: true,
+					value: void 0
+				};
+				const result = await backend.remove(filePath, {
+					...options,
+					recursive: false
+				}, context);
+				if (result.ok) {
+					if (filePath === staging) stagingWritten = false;
+					if (filePath === destination) published = false;
+				}
+				return result;
+			} catch (error) {
+				return rejected(error, filePath);
+			}
+		}
+	};
+}
+//#endregion
+exports.createHistoryCreationFileSystem = createHistoryCreationFileSystem;
+
+//# sourceMappingURL=index.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":["FileError"],"sources":["../../../../src/services/historyCreationFileSystem/index.ts"],"sourcesContent":["import { FileError, type FileSystem, type Result } from '@earendil-works/pi-agent-core';\n\nfunction rejected(error: unknown, filePath?: string): Result<never, FileError> {\n  return {\n    ok: false,\n    error: new FileError(\n      'unknown',\n      error instanceof Error ? error.message : String(error),\n      filePath,\n      error instanceof Error ? error : undefined,\n    ),\n  };\n}\n\n/**\n * Own the destination before pinned JsonlSessionRepo computes its final path.\n * Storage remains upstream-owned. Only acquisition and destructive cleanup are gated.\n * Pinned 0.86.0 stages at destination + '.tmp'; an unexpected write fails closed.\n */\nexport function createHistoryCreationFileSystem(\n  backend: FileSystem,\n  beforeCreate: (destinationPath: string) => Promise<void>,\n): FileSystem {\n  let destination: string | undefined;\n  let staging: string | undefined;\n  let admitted = false;\n  let stagingWritten = false;\n  let published = false;\n  return {\n    cwd: backend.cwd,\n    absolutePath: backend.absolutePath.bind(backend),\n    readTextFile: backend.readTextFile.bind(backend),\n    openTextLineReader: backend.openTextLineReader.bind(backend),\n    readTextLines: backend.readTextLines.bind(backend),\n    readBinaryFile: backend.readBinaryFile.bind(backend),\n    async appendFile(filePath, content, context) {\n      try {\n        const ownsStaging = filePath === staging && stagingWritten;\n        const ownsPublished = filePath === destination && published;\n        if (!admitted || (!ownsStaging && !ownsPublished))\n          return rejected(new Error('Unowned history append'), filePath);\n        return await backend.appendFile(filePath, content, context);\n      } catch (error) {\n        return rejected(error, filePath);\n      }\n    },\n    fileInfo: backend.fileInfo.bind(backend),\n    listDir: backend.listDir.bind(backend),\n    canonicalPath: backend.canonicalPath.bind(backend),\n    exists: backend.exists.bind(backend),\n    createDir: backend.createDir.bind(backend),\n    createTempDir: backend.createTempDir.bind(backend),\n    createTempFile: backend.createTempFile.bind(backend),\n    cleanup: backend.cleanup.bind(backend),\n    async joinPath(parts, context) {\n      try {\n        const result = await backend.joinPath(parts, context);\n        if (!result.ok || !result.value.endsWith('.jsonl')) return result;\n        if (destination !== undefined) {\n          return rejected(new Error('History creation destination was already selected'), result.value);\n        }\n        destination = result.value;\n        staging = `${destination}.tmp`;\n        const existing = await backend.exists(destination, context);\n        if (!existing.ok) return existing;\n        if (existing.value) return rejected(new Error('Refusing to replace existing history'), destination);\n        await beforeCreate(destination);\n        // Recheck after acquiring the lease, including abandoned upstream staging.\n        for (const filePath of [destination, staging]) {\n          const found = await backend.exists(filePath, context);\n          if (!found.ok) return found;\n          if (found.value) return rejected(new Error('History creation path is occupied'), filePath);\n        }\n        admitted = true;\n        return result;\n      } catch (error) {\n        return rejected(error, destination);\n      }\n    },\n    async writeFile(filePath, content, context) {\n      try {\n        if (!admitted || filePath !== staging || stagingWritten) {\n          return rejected(new Error('Unowned history staging write'), filePath);\n        }\n        const existing = await backend.exists(filePath, context);\n        if (!existing.ok) return existing;\n        if (existing.value) return rejected(new Error('History staging path is occupied'), filePath);\n        const result = await backend.writeFile(filePath, content, context);\n        if (result.ok) stagingWritten = true;\n        return result;\n      } catch (error) {\n        return rejected(error, filePath);\n      }\n    },\n    async renameFile(sourcePath, destinationPath, context) {\n      try {\n        if (!admitted || sourcePath !== staging || destinationPath !== destination || !stagingWritten) {\n          return rejected(new Error('Unowned history publication'), destinationPath);\n        }\n        const result = await backend.renameFile(sourcePath, destinationPath, context);\n        if (result.ok) {\n          published = true;\n          stagingWritten = false;\n        }\n        return result;\n      } catch (error) {\n        return rejected(error, destinationPath);\n      }\n    },\n    async remove(filePath, options, context) {\n      try {\n        const owned = (filePath === staging && stagingWritten) || (filePath === destination && published);\n        // Upstream calls remove even when creation failed before owning either file.\n        if (!owned) return { ok: true, value: undefined };\n        const result = await backend.remove(filePath, { ...options, recursive: false }, context);\n        if (result.ok) {\n          if (filePath === staging) stagingWritten = false;\n          if (filePath === destination) published = false;\n        }\n        return result;\n      } catch (error) {\n        return rejected(error, filePath);\n      }\n    },\n  };\n}\n"],"mappings":"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"}

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

@@ -0,0 +1,115 @@
+import { FileError } from "@earendil-works/pi-agent-core";
+//#region src/services/historyCreationFileSystem/index.ts
+function rejected(error, filePath) {
+	return {
+		ok: false,
+		error: new FileError("unknown", error instanceof Error ? error.message : String(error), filePath, error instanceof Error ? error : void 0)
+	};
+}
+/**
+* Own the destination before pinned JsonlSessionRepo computes its final path.
+* Storage remains upstream-owned. Only acquisition and destructive cleanup are gated.
+* Pinned 0.86.0 stages at destination + '.tmp'; an unexpected write fails closed.
+*/
+function createHistoryCreationFileSystem(backend, beforeCreate) {
+	let destination;
+	let staging;
+	let admitted = false;
+	let stagingWritten = false;
+	let published = false;
+	return {
+		cwd: backend.cwd,
+		absolutePath: backend.absolutePath.bind(backend),
+		readTextFile: backend.readTextFile.bind(backend),
+		openTextLineReader: backend.openTextLineReader.bind(backend),
+		readTextLines: backend.readTextLines.bind(backend),
+		readBinaryFile: backend.readBinaryFile.bind(backend),
+		async appendFile(filePath, content, context) {
+			try {
+				if (!admitted || !(filePath === staging && stagingWritten) && !(filePath === destination && published)) return rejected(/* @__PURE__ */ new Error("Unowned history append"), filePath);
+				return await backend.appendFile(filePath, content, context);
+			} catch (error) {
+				return rejected(error, filePath);
+			}
+		},
+		fileInfo: backend.fileInfo.bind(backend),
+		listDir: backend.listDir.bind(backend),
+		canonicalPath: backend.canonicalPath.bind(backend),
+		exists: backend.exists.bind(backend),
+		createDir: backend.createDir.bind(backend),
+		createTempDir: backend.createTempDir.bind(backend),
+		createTempFile: backend.createTempFile.bind(backend),
+		cleanup: backend.cleanup.bind(backend),
+		async joinPath(parts, context) {
+			try {
+				const result = await backend.joinPath(parts, context);
+				if (!result.ok || !result.value.endsWith(".jsonl")) return result;
+				if (destination !== void 0) return rejected(/* @__PURE__ */ new Error("History creation destination was already selected"), result.value);
+				destination = result.value;
+				staging = `${destination}.tmp`;
+				const existing = await backend.exists(destination, context);
+				if (!existing.ok) return existing;
+				if (existing.value) return rejected(/* @__PURE__ */ new Error("Refusing to replace existing history"), destination);
+				await beforeCreate(destination);
+				for (const filePath of [destination, staging]) {
+					const found = await backend.exists(filePath, context);
+					if (!found.ok) return found;
+					if (found.value) return rejected(/* @__PURE__ */ new Error("History creation path is occupied"), filePath);
+				}
+				admitted = true;
+				return result;
+			} catch (error) {
+				return rejected(error, destination);
+			}
+		},
+		async writeFile(filePath, content, context) {
+			try {
+				if (!admitted || filePath !== staging || stagingWritten) return rejected(/* @__PURE__ */ new Error("Unowned history staging write"), filePath);
+				const existing = await backend.exists(filePath, context);
+				if (!existing.ok) return existing;
+				if (existing.value) return rejected(/* @__PURE__ */ new Error("History staging path is occupied"), filePath);
+				const result = await backend.writeFile(filePath, content, context);
+				if (result.ok) stagingWritten = true;
+				return result;
+			} catch (error) {
+				return rejected(error, filePath);
+			}
+		},
+		async renameFile(sourcePath, destinationPath, context) {
+			try {
+				if (!admitted || sourcePath !== staging || destinationPath !== destination || !stagingWritten) return rejected(/* @__PURE__ */ new Error("Unowned history publication"), destinationPath);
+				const result = await backend.renameFile(sourcePath, destinationPath, context);
+				if (result.ok) {
+					published = true;
+					stagingWritten = false;
+				}
+				return result;
+			} catch (error) {
+				return rejected(error, destinationPath);
+			}
+		},
+		async remove(filePath, options, context) {
+			try {
+				if (!(filePath === staging && stagingWritten || filePath === destination && published)) return {
+					ok: true,
+					value: void 0
+				};
+				const result = await backend.remove(filePath, {
+					...options,
+					recursive: false
+				}, context);
+				if (result.ok) {
+					if (filePath === staging) stagingWritten = false;
+					if (filePath === destination) published = false;
+				}
+				return result;
+			} catch (error) {
+				return rejected(error, filePath);
+			}
+		}
+	};
+}
+//#endregion
+export { createHistoryCreationFileSystem };
+
+//# sourceMappingURL=index.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../../src/services/historyCreationFileSystem/index.ts"],"sourcesContent":["import { FileError, type FileSystem, type Result } from '@earendil-works/pi-agent-core';\n\nfunction rejected(error: unknown, filePath?: string): Result<never, FileError> {\n  return {\n    ok: false,\n    error: new FileError(\n      'unknown',\n      error instanceof Error ? error.message : String(error),\n      filePath,\n      error instanceof Error ? error : undefined,\n    ),\n  };\n}\n\n/**\n * Own the destination before pinned JsonlSessionRepo computes its final path.\n * Storage remains upstream-owned. Only acquisition and destructive cleanup are gated.\n * Pinned 0.86.0 stages at destination + '.tmp'; an unexpected write fails closed.\n */\nexport function createHistoryCreationFileSystem(\n  backend: FileSystem,\n  beforeCreate: (destinationPath: string) => Promise<void>,\n): FileSystem {\n  let destination: string | undefined;\n  let staging: string | undefined;\n  let admitted = false;\n  let stagingWritten = false;\n  let published = false;\n  return {\n    cwd: backend.cwd,\n    absolutePath: backend.absolutePath.bind(backend),\n    readTextFile: backend.readTextFile.bind(backend),\n    openTextLineReader: backend.openTextLineReader.bind(backend),\n    readTextLines: backend.readTextLines.bind(backend),\n    readBinaryFile: backend.readBinaryFile.bind(backend),\n    async appendFile(filePath, content, context) {\n      try {\n        const ownsStaging = filePath === staging && stagingWritten;\n        const ownsPublished = filePath === destination && published;\n        if (!admitted || (!ownsStaging && !ownsPublished))\n          return rejected(new Error('Unowned history append'), filePath);\n        return await backend.appendFile(filePath, content, context);\n      } catch (error) {\n        return rejected(error, filePath);\n      }\n    },\n    fileInfo: backend.fileInfo.bind(backend),\n    listDir: backend.listDir.bind(backend),\n    canonicalPath: backend.canonicalPath.bind(backend),\n    exists: backend.exists.bind(backend),\n    createDir: backend.createDir.bind(backend),\n    createTempDir: backend.createTempDir.bind(backend),\n    createTempFile: backend.createTempFile.bind(backend),\n    cleanup: backend.cleanup.bind(backend),\n    async joinPath(parts, context) {\n      try {\n        const result = await backend.joinPath(parts, context);\n        if (!result.ok || !result.value.endsWith('.jsonl')) return result;\n        if (destination !== undefined) {\n          return rejected(new Error('History creation destination was already selected'), result.value);\n        }\n        destination = result.value;\n        staging = `${destination}.tmp`;\n        const existing = await backend.exists(destination, context);\n        if (!existing.ok) return existing;\n        if (existing.value) return rejected(new Error('Refusing to replace existing history'), destination);\n        await beforeCreate(destination);\n        // Recheck after acquiring the lease, including abandoned upstream staging.\n        for (const filePath of [destination, staging]) {\n          const found = await backend.exists(filePath, context);\n          if (!found.ok) return found;\n          if (found.value) return rejected(new Error('History creation path is occupied'), filePath);\n        }\n        admitted = true;\n        return result;\n      } catch (error) {\n        return rejected(error, destination);\n      }\n    },\n    async writeFile(filePath, content, context) {\n      try {\n        if (!admitted || filePath !== staging || stagingWritten) {\n          return rejected(new Error('Unowned history staging write'), filePath);\n        }\n        const existing = await backend.exists(filePath, context);\n        if (!existing.ok) return existing;\n        if (existing.value) return rejected(new Error('History staging path is occupied'), filePath);\n        const result = await backend.writeFile(filePath, content, context);\n        if (result.ok) stagingWritten = true;\n        return result;\n      } catch (error) {\n        return rejected(error, filePath);\n      }\n    },\n    async renameFile(sourcePath, destinationPath, context) {\n      try {\n        if (!admitted || sourcePath !== staging || destinationPath !== destination || !stagingWritten) {\n          return rejected(new Error('Unowned history publication'), destinationPath);\n        }\n        const result = await backend.renameFile(sourcePath, destinationPath, context);\n        if (result.ok) {\n          published = true;\n          stagingWritten = false;\n        }\n        return result;\n      } catch (error) {\n        return rejected(error, destinationPath);\n      }\n    },\n    async remove(filePath, options, context) {\n      try {\n        const owned = (filePath === staging && stagingWritten) || (filePath === destination && published);\n        // Upstream calls remove even when creation failed before owning either file.\n        if (!owned) return { ok: true, value: undefined };\n        const result = await backend.remove(filePath, { ...options, recursive: false }, context);\n        if (result.ok) {\n          if (filePath === staging) stagingWritten = false;\n          if (filePath === destination) published = false;\n        }\n        return result;\n      } catch (error) {\n        return rejected(error, filePath);\n      }\n    },\n  };\n}\n"],"mappings":"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"}

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

@@ -0,0 +1,50 @@
+//#region src/services/hubChannelHarness/index.ts
+const DEFAULT_SESSION = {
+	sessionId: "s1",
+	cwd: "/repo"
+};
+function doomHubChannelHarness(channel, options = {}) {
+	const sessions = [...options.sessions ?? [DEFAULT_SESSION]];
+	const published = [];
+	const notices = [];
+	const source = channel.start({
+		sessions: () => sessions,
+		directEvents: {
+			publish: () => void 0,
+			subscribe: () => () => void 0,
+			close: () => void 0
+		},
+		publish: (sessionId, payload) => {
+			published.push({
+				type: channel.frameType,
+				sessionId,
+				payload
+			});
+		},
+		requestSessionApi: () => Promise.resolve(Response.json({ error: "No session API in the channel harness." }, { status: 501 })),
+		onNotice: (message) => notices.push(message)
+	});
+	return {
+		source,
+		published,
+		notices,
+		snapshot(sessionId) {
+			const scope = sessions.find((candidate) => candidate.sessionId === sessionId) ?? sessions[0] ?? DEFAULT_SESSION;
+			return source.payloadFor(scope);
+		},
+		addSession(scope) {
+			sessions.push(scope);
+			source.sessionAdded?.(scope);
+		},
+		removeSession(sessionId) {
+			const index = sessions.findIndex((candidate) => candidate.sessionId === sessionId);
+			if (index >= 0) sessions.splice(index, 1);
+			source.sessionRemoved?.(sessionId);
+		},
+		close: () => source.close()
+	};
+}
+//#endregion
+exports.doomHubChannelHarness = doomHubChannelHarness;
+
+//# sourceMappingURL=index.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":[],"sources":["../../../../src/services/hubChannelHarness/index.ts"],"sourcesContent":["import type {\n  DoomHubChannel,\n  DoomHubChannelFrame,\n  DoomHubChannelHost,\n  DoomHubChannelSource,\n  DoomHubSessionScope,\n} from '../../schemas/hubChannel';\n\nexport interface DoomHubChannelHarness {\n  source: DoomHubChannelSource;\n  readonly published: readonly DoomHubChannelFrame[];\n  readonly notices: readonly string[];\n  snapshot(sessionId?: string): unknown;\n  addSession(scope: DoomHubSessionScope): void;\n  removeSession(sessionId: string): void;\n  close(): void;\n}\n\nexport interface DoomHubChannelHarnessOptions {\n  sessions?: readonly DoomHubSessionScope[];\n}\n\nconst DEFAULT_SESSION: DoomHubSessionScope = { sessionId: 's1', cwd: '/repo' };\n\nexport function doomHubChannelHarness(\n  channel: DoomHubChannel,\n  options: DoomHubChannelHarnessOptions = {},\n): DoomHubChannelHarness {\n  const sessions = [...(options.sessions ?? [DEFAULT_SESSION])];\n  const published: DoomHubChannelFrame[] = [];\n  const notices: string[] = [];\n  const host: DoomHubChannelHost = {\n    sessions: () => sessions,\n    directEvents: {\n      publish: () => undefined,\n      subscribe: () => () => undefined,\n      close: () => undefined,\n    },\n    publish: (sessionId, payload) => {\n      published.push({ type: channel.frameType, sessionId, payload });\n    },\n    requestSessionApi: () =>\n      Promise.resolve(Response.json({ error: 'No session API in the channel harness.' }, { status: 501 })),\n    onNotice: (message) => notices.push(message),\n  };\n  const source = channel.start(host);\n\n  return {\n    source,\n    published,\n    notices,\n    snapshot(sessionId) {\n      const scope = sessions.find((candidate) => candidate.sessionId === sessionId) ?? sessions[0] ?? DEFAULT_SESSION;\n      return source.payloadFor(scope);\n    },\n    addSession(scope) {\n      sessions.push(scope);\n      source.sessionAdded?.(scope);\n    },\n    removeSession(sessionId) {\n      const index = sessions.findIndex((candidate) => candidate.sessionId === sessionId);\n      if (index >= 0) sessions.splice(index, 1);\n      source.sessionRemoved?.(sessionId);\n    },\n    close: () => source.close(),\n  };\n}\n"],"mappings":";AAsBA,MAAM,kBAAuC;CAAE,WAAW;CAAM,KAAK;AAAQ;AAE7E,SAAgB,sBACd,SACA,UAAwC,CAAC,GAClB;CACvB,MAAM,WAAW,CAAC,GAAI,QAAQ,YAAY,CAAC,eAAe,CAAE;CAC5D,MAAM,YAAmC,CAAC;CAC1C,MAAM,UAAoB,CAAC;CAe3B,MAAM,SAAS,QAAQ,MAAM;EAb3B,gBAAgB;EAChB,cAAc;GACZ,eAAe,KAAA;GACf,uBAAuB,KAAA;GACvB,aAAa,KAAA;EACf;EACA,UAAU,WAAW,YAAY;GAC/B,UAAU,KAAK;IAAE,MAAM,QAAQ;IAAW;IAAW;GAAQ,CAAC;EAChE;EACA,yBACE,QAAQ,QAAQ,SAAS,KAAK,EAAE,OAAO,yCAAyC,GAAG,EAAE,QAAQ,IAAI,CAAC,CAAC;EACrG,WAAW,YAAY,QAAQ,KAAK,OAAO;CAEb,CAAC;CAEjC,OAAO;EACL;EACA;EACA;EACA,SAAS,WAAW;GAClB,MAAM,QAAQ,SAAS,MAAM,cAAc,UAAU,cAAc,SAAS,KAAK,SAAS,MAAM;GAChG,OAAO,OAAO,WAAW,KAAK;EAChC;EACA,WAAW,OAAO;GAChB,SAAS,KAAK,KAAK;GACnB,OAAO,eAAe,KAAK;EAC7B;EACA,cAAc,WAAW;GACvB,MAAM,QAAQ,SAAS,WAAW,cAAc,UAAU,cAAc,SAAS;GACjF,IAAI,SAAS,GAAG,SAAS,OAAO,OAAO,CAAC;GACxC,OAAO,iBAAiB,SAAS;EACnC;EACA,aAAa,OAAO,MAAM;CAC5B;AACF"}

package/dist/src/services/hubChannelHarness/index.d.mts

@@ -0,0 +1,17 @@
+import { DoomHubChannel, DoomHubChannelFrame, DoomHubChannelSource, DoomHubSessionScope } from "../../schemas/hubChannel.mjs";
+//#region src/services/hubChannelHarness/index.d.ts
+export interface DoomHubChannelHarness {
+  source: DoomHubChannelSource;
+  readonly published: readonly DoomHubChannelFrame[];
+  readonly notices: readonly string[];
+  snapshot(sessionId?: string): unknown;
+  addSession(scope: DoomHubSessionScope): void;
+  removeSession(sessionId: string): void;
+  close(): void;
+}
+export interface DoomHubChannelHarnessOptions {
+  sessions?: readonly DoomHubSessionScope[];
+}
+export declare function doomHubChannelHarness(channel: DoomHubChannel, options?: DoomHubChannelHarnessOptions): DoomHubChannelHarness;
+//#endregion
+//# sourceMappingURL=index.d.mts.map

package/dist/src/services/hubChannelHarness/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../../../src/services/hubChannelHarness/index.ts"],"mappings":";;iBAQiB;EACf,QAAQ;WACC,oBAAoB;WACpB;EACT,SAAS;EACT,WAAW,OAAO;EAClB,cAAc;EACd;;iBAGe;EACf,oBAAoB;;wBAKN,sBACd,SAAS,gBACT,UAAS,+BACR"}

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

@@ -0,0 +1,50 @@
+//#region src/services/hubChannelHarness/index.ts
+const DEFAULT_SESSION = {
+	sessionId: "s1",
+	cwd: "/repo"
+};
+function doomHubChannelHarness(channel, options = {}) {
+	const sessions = [...options.sessions ?? [DEFAULT_SESSION]];
+	const published = [];
+	const notices = [];
+	const source = channel.start({
+		sessions: () => sessions,
+		directEvents: {
+			publish: () => void 0,
+			subscribe: () => () => void 0,
+			close: () => void 0
+		},
+		publish: (sessionId, payload) => {
+			published.push({
+				type: channel.frameType,
+				sessionId,
+				payload
+			});
+		},
+		requestSessionApi: () => Promise.resolve(Response.json({ error: "No session API in the channel harness." }, { status: 501 })),
+		onNotice: (message) => notices.push(message)
+	});
+	return {
+		source,
+		published,
+		notices,
+		snapshot(sessionId) {
+			const scope = sessions.find((candidate) => candidate.sessionId === sessionId) ?? sessions[0] ?? DEFAULT_SESSION;
+			return source.payloadFor(scope);
+		},
+		addSession(scope) {
+			sessions.push(scope);
+			source.sessionAdded?.(scope);
+		},
+		removeSession(sessionId) {
+			const index = sessions.findIndex((candidate) => candidate.sessionId === sessionId);
+			if (index >= 0) sessions.splice(index, 1);
+			source.sessionRemoved?.(sessionId);
+		},
+		close: () => source.close()
+	};
+}
+//#endregion
+export { doomHubChannelHarness };
+
+//# sourceMappingURL=index.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../../src/services/hubChannelHarness/index.ts"],"sourcesContent":["import type {\n  DoomHubChannel,\n  DoomHubChannelFrame,\n  DoomHubChannelHost,\n  DoomHubChannelSource,\n  DoomHubSessionScope,\n} from '../../schemas/hubChannel';\n\nexport interface DoomHubChannelHarness {\n  source: DoomHubChannelSource;\n  readonly published: readonly DoomHubChannelFrame[];\n  readonly notices: readonly string[];\n  snapshot(sessionId?: string): unknown;\n  addSession(scope: DoomHubSessionScope): void;\n  removeSession(sessionId: string): void;\n  close(): void;\n}\n\nexport interface DoomHubChannelHarnessOptions {\n  sessions?: readonly DoomHubSessionScope[];\n}\n\nconst DEFAULT_SESSION: DoomHubSessionScope = { sessionId: 's1', cwd: '/repo' };\n\nexport function doomHubChannelHarness(\n  channel: DoomHubChannel,\n  options: DoomHubChannelHarnessOptions = {},\n): DoomHubChannelHarness {\n  const sessions = [...(options.sessions ?? [DEFAULT_SESSION])];\n  const published: DoomHubChannelFrame[] = [];\n  const notices: string[] = [];\n  const host: DoomHubChannelHost = {\n    sessions: () => sessions,\n    directEvents: {\n      publish: () => undefined,\n      subscribe: () => () => undefined,\n      close: () => undefined,\n    },\n    publish: (sessionId, payload) => {\n      published.push({ type: channel.frameType, sessionId, payload });\n    },\n    requestSessionApi: () =>\n      Promise.resolve(Response.json({ error: 'No session API in the channel harness.' }, { status: 501 })),\n    onNotice: (message) => notices.push(message),\n  };\n  const source = channel.start(host);\n\n  return {\n    source,\n    published,\n    notices,\n    snapshot(sessionId) {\n      const scope = sessions.find((candidate) => candidate.sessionId === sessionId) ?? sessions[0] ?? DEFAULT_SESSION;\n      return source.payloadFor(scope);\n    },\n    addSession(scope) {\n      sessions.push(scope);\n      source.sessionAdded?.(scope);\n    },\n    removeSession(sessionId) {\n      const index = sessions.findIndex((candidate) => candidate.sessionId === sessionId);\n      if (index >= 0) sessions.splice(index, 1);\n      source.sessionRemoved?.(sessionId);\n    },\n    close: () => source.close(),\n  };\n}\n"],"mappings":";AAsBA,MAAM,kBAAuC;CAAE,WAAW;CAAM,KAAK;AAAQ;AAE7E,SAAgB,sBACd,SACA,UAAwC,CAAC,GAClB;CACvB,MAAM,WAAW,CAAC,GAAI,QAAQ,YAAY,CAAC,eAAe,CAAE;CAC5D,MAAM,YAAmC,CAAC;CAC1C,MAAM,UAAoB,CAAC;CAe3B,MAAM,SAAS,QAAQ,MAAM;EAb3B,gBAAgB;EAChB,cAAc;GACZ,eAAe,KAAA;GACf,uBAAuB,KAAA;GACvB,aAAa,KAAA;EACf;EACA,UAAU,WAAW,YAAY;GAC/B,UAAU,KAAK;IAAE,MAAM,QAAQ;IAAW;IAAW;GAAQ,CAAC;EAChE;EACA,yBACE,QAAQ,QAAQ,SAAS,KAAK,EAAE,OAAO,yCAAyC,GAAG,EAAE,QAAQ,IAAI,CAAC,CAAC;EACrG,WAAW,YAAY,QAAQ,KAAK,OAAO;CAEb,CAAC;CAEjC,OAAO;EACL;EACA;EACA;EACA,SAAS,WAAW;GAClB,MAAM,QAAQ,SAAS,MAAM,cAAc,UAAU,cAAc,SAAS,KAAK,SAAS,MAAM;GAChG,OAAO,OAAO,WAAW,KAAK;EAChC;EACA,WAAW,OAAO;GAChB,SAAS,KAAK,KAAK;GACnB,OAAO,eAAe,KAAK;EAC7B;EACA,cAAc,WAAW;GACvB,MAAM,QAAQ,SAAS,WAAW,cAAc,UAAU,cAAc,SAAS;GACjF,IAAI,SAAS,GAAG,SAAS,OAAO,OAAO,CAAC;GACxC,OAAO,iBAAiB,SAAS;EACnC;EACA,aAAa,OAAO,MAAM;CAC5B;AACF"}