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

package/dist/services/historyCreationFileSystem/index.cjs

@@ -0,0 +1,114 @@
+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.85.1 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),
+		readTextLines: backend.readTextLines.bind(backend),
+		readBinaryFile: backend.readBinaryFile.bind(backend),
+		async appendFile(filePath, content, context) {
+			try {
+				if (!admitted || !published || filePath !== destination) 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/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.85.1 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    readTextLines: backend.readTextLines.bind(backend),\n    readBinaryFile: backend.readBinaryFile.bind(backend),\n    async appendFile(filePath, content, context) {\n      try {\n        if (!admitted || !published || filePath !== destination)\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/services/historyCreationFileSystem/index.mjs

@@ -0,0 +1,114 @@
+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.85.1 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),
+		readTextLines: backend.readTextLines.bind(backend),
+		readBinaryFile: backend.readBinaryFile.bind(backend),
+		async appendFile(filePath, content, context) {
+			try {
+				if (!admitted || !published || filePath !== destination) 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/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.85.1 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    readTextLines: backend.readTextLines.bind(backend),\n    readBinaryFile: backend.readBinaryFile.bind(backend),\n    async appendFile(filePath, content, context) {\n      try {\n        if (!admitted || !published || filePath !== destination)\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/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/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/services/hubChannelHarness/index.d.cts

@@ -0,0 +1,17 @@
+import { DoomHubChannel, DoomHubChannelFrame, DoomHubChannelSource, DoomHubSessionScope } from "../../schemas/hubChannel.cjs";
+//#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.cts.map

package/dist/services/hubChannelHarness/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","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/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/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/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/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"}

package/dist/services/kernel/index.cjs

@@ -0,0 +1,147 @@
+//#region src/services/kernel/index.ts
+const DISPOSED_MESSAGE = "The kernel is disposed";
+function sameList(left, right) {
+	if (left === void 0 || left.length !== right.length) return false;
+	return left.every((value, index) => value === right[index]);
+}
+function describe(error) {
+	return error instanceof Error ? error.message : String(error);
+}
+function createDoomKernel(options = {}) {
+	const slots = /* @__PURE__ */ new Map();
+	const dirty = /* @__PURE__ */ new Set();
+	/** Slots whose values render differently without the list itself changing. */
+	const forced = /* @__PURE__ */ new Set();
+	let layers = new Set(options.activeLayers ?? []);
+	let sequence = 0;
+	let tail = Promise.resolve();
+	let scheduled;
+	let disposed = false;
+	const activeOf = (slot) => [...slot.entries.entries()].sort(([left], [right]) => left - right).filter(([, entry]) => entry.layer === void 0 || layers.has(entry.layer)).map(([, entry]) => entry.value);
+	const pushOne = async (slot, force, failures) => {
+		if (slot.disposed) return;
+		const active = activeOf(slot);
+		if (!force && sameList(slot.pushed, active)) return;
+		try {
+			await slot.sink(active);
+			slot.pushed = active;
+		} catch (error) {
+			failures.push(`${slot.name}: ${describe(error)}`);
+		}
+	};
+	const flush = () => {
+		const run = tail.catch(() => void 0).then(async () => {
+			if (dirty.size === 0) return;
+			const pending = [...dirty];
+			const pendingForced = new Set(forced);
+			dirty.clear();
+			forced.clear();
+			const failures = [];
+			for (const name of pending) {
+				const slot = slots.get(name);
+				if (slot) await pushOne(slot, pendingForced.has(name), failures);
+			}
+			if (failures.length > 0) throw new Error(`Kernel slots failed to apply: ${failures.join("; ")}`);
+		});
+		tail = run;
+		return run;
+	};
+	const schedule = () => {
+		if (scheduled) return;
+		scheduled = Promise.resolve().then(() => {
+			scheduled = void 0;
+			return flush().catch(() => void 0);
+		});
+	};
+	const markDirty = (name) => {
+		dirty.add(name);
+	};
+	const contribute = (slot, entry) => {
+		if (disposed) throw new Error(DISPOSED_MESSAGE);
+		const state = slots.get(slot);
+		if (!state) throw new Error(`Unknown kernel slot: ${slot}. Defined slots: ${[...slots.keys()].join(", ") || "none"}`);
+		const key = sequence++;
+		state.entries.set(key, entry);
+		markDirty(slot);
+		schedule();
+		let removed = false;
+		return { dispose() {
+			if (removed) return;
+			removed = true;
+			state.entries.delete(key);
+			markDirty(slot);
+			schedule();
+		} };
+	};
+	return {
+		get activeLayers() {
+			return [...layers];
+		},
+		get slots() {
+			return [...slots.keys()];
+		},
+		defineSlot(name, sink) {
+			if (disposed) throw new Error(DISPOSED_MESSAGE);
+			if (slots.has(name)) throw new Error(`Kernel slot already defined: ${name}`);
+			const state = {
+				name,
+				sink,
+				entries: /* @__PURE__ */ new Map(),
+				pushed: void 0,
+				disposed: false
+			};
+			slots.set(name, state);
+			let removed = false;
+			return {
+				name,
+				contribute: (entry) => contribute(name, entry),
+				dispose() {
+					if (removed) return;
+					removed = true;
+					state.disposed = true;
+					slots.delete(name);
+					dirty.delete(name);
+					forced.delete(name);
+				}
+			};
+		},
+		contribute,
+		async setActiveLayers(next) {
+			if (disposed) throw new Error(DISPOSED_MESSAGE);
+			layers = new Set(next);
+			for (const name of slots.keys()) markDirty(name);
+			await flush();
+		},
+		async refresh(slot) {
+			if (disposed) throw new Error(DISPOSED_MESSAGE);
+			if (slot === void 0) for (const name of slots.keys()) {
+				markDirty(name);
+				forced.add(name);
+			}
+			else if (slots.has(slot)) {
+				markDirty(slot);
+				forced.add(slot);
+			}
+			await flush();
+		},
+		activeValues(slot) {
+			const state = slots.get(slot);
+			return state ? activeOf(state) : [];
+		},
+		contributions(slot) {
+			const state = slots.get(slot);
+			return state ? [...state.entries.values()] : [];
+		},
+		dispose() {
+			if (disposed) return;
+			disposed = true;
+			for (const state of slots.values()) state.disposed = true;
+			slots.clear();
+			dirty.clear();
+		}
+	};
+}
+//#endregion
+exports.createDoomKernel = createDoomKernel;
+
+//# sourceMappingURL=index.cjs.map

package/dist/services/kernel/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":[],"sources":["../../../src/services/kernel/index.ts"],"sourcesContent":["/**\n * The kernel contribution registry.\n *\n * DESIGN PATTERNS:\n * - Pure function of registered contributions plus the active layer set. Every\n *   push recomputes from that state, so there is no incremental bookkeeping to\n *   drift out of sync.\n * - Pushes are serialized on one tail. A sink that awaits cannot interleave\n *   with the next recompute, which is what keeps a host's whole-list setter\n *   from being called out of order.\n * - Registration coalesces into one microtask flush, so composing forty\n *   packages at startup costs one push per slot rather than forty.\n *\n * AVOID:\n * - Pushing a slot whose active list is unchanged. Hosts treat a set call as a\n *   structural change, and a redundant one is visible to the user.\n * - Throwing out of a push loop early. One broken sink must not stop the rest\n *   of the surfaces from reaching the host.\n */\n\nimport type {\n  DoomKernel,\n  KernelContribution,\n  KernelRegistration,\n  KernelSlotHandle,\n  KernelSlotSink,\n} from '../../types/kernel';\n\ninterface SlotState {\n  readonly name: string;\n  readonly sink: KernelSlotSink<unknown>;\n  readonly entries: Map<number, KernelContribution<unknown>>;\n  pushed: readonly unknown[] | undefined;\n  disposed: boolean;\n}\n\nconst DISPOSED_MESSAGE = 'The kernel is disposed';\n\nfunction sameList(left: readonly unknown[] | undefined, right: readonly unknown[]): boolean {\n  if (left === undefined || left.length !== right.length) return false;\n  return left.every((value, index) => value === right[index]);\n}\n\nfunction describe(error: unknown): string {\n  return error instanceof Error ? error.message : String(error);\n}\n\nexport interface CreateDoomKernelOptions {\n  /** Layers active at creation, usually `resolveLayers(config, majorMode)`. */\n  readonly activeLayers?: readonly string[];\n}\n\nexport function createDoomKernel(options: CreateDoomKernelOptions = {}): DoomKernel {\n  const slots = new Map<string, SlotState>();\n  const dirty = new Set<string>();\n  /** Slots whose values render differently without the list itself changing. */\n  const forced = new Set<string>();\n  let layers = new Set(options.activeLayers ?? []);\n  let sequence = 0;\n  let tail: Promise<void> = Promise.resolve();\n  let scheduled: Promise<void> | undefined;\n  let disposed = false;\n\n  const activeOf = (slot: SlotState): readonly unknown[] =>\n    [...slot.entries.entries()]\n      .sort(([left], [right]) => left - right)\n      .filter(([, entry]) => entry.layer === undefined || layers.has(entry.layer))\n      .map(([, entry]) => entry.value);\n\n  const pushOne = async (slot: SlotState, force: boolean, failures: string[]): Promise<void> => {\n    if (slot.disposed) return;\n    const active = activeOf(slot);\n    if (!force && sameList(slot.pushed, active)) return;\n    try {\n      await slot.sink(active);\n      slot.pushed = active;\n    } catch (error) {\n      // Cache only an acknowledged application. A sink may be retried with the\n      // same active values after it recovers.\n      failures.push(`${slot.name}: ${describe(error)}`);\n    }\n  };\n\n  const flush = (): Promise<void> => {\n    const run = tail\n      .catch(() => undefined)\n      .then(async () => {\n        if (dirty.size === 0) return;\n        const pending = [...dirty];\n        const pendingForced = new Set(forced);\n        dirty.clear();\n        forced.clear();\n        const failures: string[] = [];\n        for (const name of pending) {\n          const slot = slots.get(name);\n          if (slot) await pushOne(slot, pendingForced.has(name), failures);\n        }\n        if (failures.length > 0) throw new Error(`Kernel slots failed to apply: ${failures.join('; ')}`);\n      });\n    tail = run;\n    return run;\n  };\n\n  const schedule = (): void => {\n    if (scheduled) return;\n    scheduled = Promise.resolve().then(() => {\n      scheduled = undefined;\n      // A scheduled flush is fire and forget; `refresh` is how a caller waits.\n      return flush().catch(() => undefined);\n    });\n  };\n\n  const markDirty = (name: string): void => {\n    dirty.add(name);\n  };\n\n  const contribute = <TValue>(slot: string, entry: KernelContribution<TValue>): KernelRegistration => {\n    if (disposed) throw new Error(DISPOSED_MESSAGE);\n    const state = slots.get(slot);\n    if (!state)\n      throw new Error(`Unknown kernel slot: ${slot}. Defined slots: ${[...slots.keys()].join(', ') || 'none'}`);\n    const key = sequence++;\n    state.entries.set(key, entry as KernelContribution<unknown>);\n    markDirty(slot);\n    schedule();\n    let removed = false;\n    return {\n      dispose(): void {\n        if (removed) return;\n        removed = true;\n        state.entries.delete(key);\n        markDirty(slot);\n        schedule();\n      },\n    };\n  };\n\n  return {\n    get activeLayers(): readonly string[] {\n      return [...layers];\n    },\n    get slots(): readonly string[] {\n      return [...slots.keys()];\n    },\n    defineSlot<TValue>(name: string, sink: KernelSlotSink<TValue>): KernelSlotHandle<TValue> {\n      if (disposed) throw new Error(DISPOSED_MESSAGE);\n      if (slots.has(name)) throw new Error(`Kernel slot already defined: ${name}`);\n      const state: SlotState = {\n        name,\n        sink: sink as KernelSlotSink<unknown>,\n        entries: new Map(),\n        pushed: undefined,\n        disposed: false,\n      };\n      slots.set(name, state);\n      let removed = false;\n      return {\n        name,\n        contribute: (entry) => contribute(name, entry),\n        dispose(): void {\n          if (removed) return;\n          removed = true;\n          state.disposed = true;\n          slots.delete(name);\n          dirty.delete(name);\n          forced.delete(name);\n        },\n      };\n    },\n    contribute,\n    async setActiveLayers(next: readonly string[]): Promise<void> {\n      if (disposed) throw new Error(DISPOSED_MESSAGE);\n      layers = new Set(next);\n      for (const name of slots.keys()) markDirty(name);\n      await flush();\n    },\n    async refresh(slot?: string): Promise<void> {\n      if (disposed) throw new Error(DISPOSED_MESSAGE);\n      if (slot === undefined) {\n        for (const name of slots.keys()) {\n          markDirty(name);\n          forced.add(name);\n        }\n      } else if (slots.has(slot)) {\n        markDirty(slot);\n        forced.add(slot);\n      }\n      await flush();\n    },\n    activeValues<TValue>(slot: string): readonly TValue[] {\n      const state = slots.get(slot);\n      return state ? (activeOf(state) as readonly TValue[]) : [];\n    },\n    contributions<TValue>(slot: string): readonly KernelContribution<TValue>[] {\n      const state = slots.get(slot);\n      return state ? ([...state.entries.values()] as readonly KernelContribution<TValue>[]) : [];\n    },\n    dispose(): void {\n      if (disposed) return;\n      disposed = true;\n      for (const state of slots.values()) state.disposed = true;\n      slots.clear();\n      dirty.clear();\n    },\n  };\n}\n"],"mappings":"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"}

package/dist/services/kernel/index.d.cts

@@ -0,0 +1,9 @@
+import { DoomKernel } from "../../types/kernel.cjs";
+//#region src/services/kernel/index.d.ts
+export interface CreateDoomKernelOptions {
+  /** Layers active at creation, usually `resolveLayers(config, majorMode)`. */
+  readonly activeLayers?: readonly string[];
+}
+export declare function createDoomKernel(options?: CreateDoomKernelOptions): DoomKernel;
+//#endregion
+//# sourceMappingURL=index.d.cts.map

package/dist/services/kernel/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","names":[],"sources":["../../../src/services/kernel/index.ts"],"mappings":";;iBA+CiB;;WAEN;;wBAGK,iBAAiB,UAAS,0BAA+B"}

package/dist/services/kernel/index.d.mts

@@ -0,0 +1,9 @@
+import { DoomKernel } from "../../types/kernel.mjs";
+//#region src/services/kernel/index.d.ts
+export interface CreateDoomKernelOptions {
+  /** Layers active at creation, usually `resolveLayers(config, majorMode)`. */
+  readonly activeLayers?: readonly string[];
+}
+export declare function createDoomKernel(options?: CreateDoomKernelOptions): DoomKernel;
+//#endregion
+//# sourceMappingURL=index.d.mts.map

package/dist/services/kernel/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../../src/services/kernel/index.ts"],"mappings":";;iBA+CiB;;WAEN;;wBAGK,iBAAiB,UAAS,0BAA+B"}