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

package/dist/src/services/historyOwnership/type.d.mts

@@ -0,0 +1,15 @@
+//#region src/services/historyOwnership/type.d.ts
+export interface HistoryOwnershipLease {
+  assertQuiescent(): void | Promise<void>;
+  release(): void | Promise<void>;
+}
+/**
+ * The caller must establish ownership and stop all managed writers before this
+ * adapter reads or publishes a session. A filesystem lock cannot prove that an
+ * unmanaged Pi process has stopped, so the boundary stays explicit.
+ */
+export interface HistoryOwnership {
+  acquire(sourcePath: string): HistoryOwnershipLease | Promise<HistoryOwnershipLease>;
+}
+//#endregion
+//# sourceMappingURL=type.d.mts.map

package/dist/src/services/historyOwnership/type.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"type.d.mts","names":[],"sources":["../../../../src/services/historyOwnership/type.ts"],"mappings":";iBAAiB;EACf,0BAA0B;EAC1B,kBAAkB;;;;;;;iBAQH;EACf,QAAQ,qBAAqB,wBAAwB,QAAQ"}

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

@@ -3,7 +3,7 @@ const DEFAULT_SESSION = {
 	sessionId: "s1",
 	cwd: "/repo"
 };
-function doomHubChannelHarness(channel, options = {}) {
+function poHubChannelHarness(channel, options = {}) {
 	const sessions = [...options.sessions ?? [DEFAULT_SESSION]];
 	const published = [];
 	const notices = [];
@@ -45,6 +45,6 @@ function doomHubChannelHarness(channel, options = {}) {
 	};
 }
 //#endregion
-exports.doomHubChannelHarness = doomHubChannelHarness;
+exports.poHubChannelHarness = poHubChannelHarness;
 
 //# sourceMappingURL=index.cjs.map

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

@@ -1 +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"}
+{"version":3,"file":"index.cjs","names":[],"sources":["../../../../src/services/hubChannelHarness/index.ts"],"sourcesContent":["import type {\n  PoHubChannel,\n  PoHubChannelFrame,\n  PoHubChannelHost,\n  PoHubChannelSource,\n  PoHubSessionScope,\n} from '../../schemas/hubChannel';\n\nexport interface PoHubChannelHarness {\n  source: PoHubChannelSource;\n  readonly published: readonly PoHubChannelFrame[];\n  readonly notices: readonly string[];\n  snapshot(sessionId?: string): unknown;\n  addSession(scope: PoHubSessionScope): void;\n  removeSession(sessionId: string): void;\n  close(): void;\n}\n\nexport interface PoHubChannelHarnessOptions {\n  sessions?: readonly PoHubSessionScope[];\n}\n\nconst DEFAULT_SESSION: PoHubSessionScope = { sessionId: 's1', cwd: '/repo' };\n\nexport function poHubChannelHarness(\n  channel: PoHubChannel,\n  options: PoHubChannelHarnessOptions = {},\n): PoHubChannelHarness {\n  const sessions = [...(options.sessions ?? [DEFAULT_SESSION])];\n  const published: PoHubChannelFrame[] = [];\n  const notices: string[] = [];\n  const host: PoHubChannelHost = {\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,kBAAqC;CAAE,WAAW;CAAM,KAAK;AAAQ;AAE3E,SAAgB,oBACd,SACA,UAAsC,CAAC,GAClB;CACrB,MAAM,WAAW,CAAC,GAAI,QAAQ,YAAY,CAAC,eAAe,CAAE;CAC5D,MAAM,YAAiC,CAAC;CACxC,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

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

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

@@ -1 +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"}
+{"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,oBACd,SAAS,cACT,UAAS,6BACR"}

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

@@ -3,7 +3,7 @@ const DEFAULT_SESSION = {
 	sessionId: "s1",
 	cwd: "/repo"
 };
-function doomHubChannelHarness(channel, options = {}) {
+function poHubChannelHarness(channel, options = {}) {
 	const sessions = [...options.sessions ?? [DEFAULT_SESSION]];
 	const published = [];
 	const notices = [];
@@ -45,6 +45,6 @@ function doomHubChannelHarness(channel, options = {}) {
 	};
 }
 //#endregion
-export { doomHubChannelHarness };
+export { poHubChannelHarness };
 
 //# sourceMappingURL=index.mjs.map

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

@@ -1 +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"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../../src/services/hubChannelHarness/index.ts"],"sourcesContent":["import type {\n  PoHubChannel,\n  PoHubChannelFrame,\n  PoHubChannelHost,\n  PoHubChannelSource,\n  PoHubSessionScope,\n} from '../../schemas/hubChannel';\n\nexport interface PoHubChannelHarness {\n  source: PoHubChannelSource;\n  readonly published: readonly PoHubChannelFrame[];\n  readonly notices: readonly string[];\n  snapshot(sessionId?: string): unknown;\n  addSession(scope: PoHubSessionScope): void;\n  removeSession(sessionId: string): void;\n  close(): void;\n}\n\nexport interface PoHubChannelHarnessOptions {\n  sessions?: readonly PoHubSessionScope[];\n}\n\nconst DEFAULT_SESSION: PoHubSessionScope = { sessionId: 's1', cwd: '/repo' };\n\nexport function poHubChannelHarness(\n  channel: PoHubChannel,\n  options: PoHubChannelHarnessOptions = {},\n): PoHubChannelHarness {\n  const sessions = [...(options.sessions ?? [DEFAULT_SESSION])];\n  const published: PoHubChannelFrame[] = [];\n  const notices: string[] = [];\n  const host: PoHubChannelHost = {\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,kBAAqC;CAAE,WAAW;CAAM,KAAK;AAAQ;AAE3E,SAAgB,oBACd,SACA,UAAsC,CAAC,GAClB;CACrB,MAAM,WAAW,CAAC,GAAI,QAAQ,YAAY,CAAC,eAAe,CAAE;CAC5D,MAAM,YAAiC,CAAC;CACxC,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/json/core.cjs

@@ -0,0 +1,30 @@
+const require_index = require("../platformFiles/index.cjs");
+//#region src/services/json/core.ts
+function isRecord(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+/** Parses a JSON object, treating missing or blank content as the fallback. */
+function parseJsonObject(content, fallback = {}) {
+	const trimmed = content?.trim();
+	return trimmed ? JSON.parse(trimmed) : fallback;
+}
+/** The on-disk form of a JSON state file: two-space indent and a trailing newline. */
+function serializeJson(value) {
+	return `${JSON.stringify(value, null, 2)}\n`;
+}
+/** Reads a JSON object, treating a missing or empty file as the fallback. */
+async function readJsonAsync(fs, filePath, context, fallback = {}) {
+	return parseJsonObject(await require_index.readTextIfExists(fs, filePath, context), fallback);
+}
+/** Writes a JSON object through a uniquely named temporary file and a rename. */
+async function writeJsonAsync(fs, filePath, value, context) {
+	await require_index.writeFileAtomic(fs, filePath, serializeJson(value), context);
+}
+//#endregion
+exports.isRecord = isRecord;
+exports.parseJsonObject = parseJsonObject;
+exports.readJsonAsync = readJsonAsync;
+exports.serializeJson = serializeJson;
+exports.writeJsonAsync = writeJsonAsync;
+
+//# sourceMappingURL=core.cjs.map

package/dist/src/services/json/core.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.cjs","names":["readTextIfExists","writeFileAtomicAsync"],"sources":["../../../../src/services/json/core.ts"],"sourcesContent":["import type { Context } from '@earendil-works/chord';\nimport type { FileSystem } from '@earendil-works/pi-durable/env';\n\nimport { readTextIfExists, writeFileAtomic as writeFileAtomicAsync } from '../platformFiles';\n\n/**\n * JSON state helpers for files the harness owns on disk.\n *\n * Compatibility frontends read these files while another repository's harness\n * may be writing them, so writes go through a rename rather than a truncate.\n */\n\nexport type JsonObject = Record<string, unknown>;\n\nexport function isRecord(value: unknown): value is JsonObject {\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\n/** Parses a JSON object, treating missing or blank content as the fallback. */\nexport function parseJsonObject(content: string | undefined, fallback: JsonObject = {}): JsonObject {\n  const trimmed = content?.trim();\n  return trimmed ? (JSON.parse(trimmed) as JsonObject) : fallback;\n}\n\n/** The on-disk form of a JSON state file: two-space indent and a trailing newline. */\nexport function serializeJson(value: JsonObject): string {\n  return `${JSON.stringify(value, null, 2)}\\n`;\n}\n\n/** Reads a JSON object, treating a missing or empty file as the fallback. */\nexport async function readJsonAsync(\n  fs: FileSystem,\n  filePath: string,\n  context: Context,\n  fallback: JsonObject = {},\n): Promise<JsonObject> {\n  return parseJsonObject(await readTextIfExists(fs, filePath, context), fallback);\n}\n\n/** Writes a JSON object through a uniquely named temporary file and a rename. */\nexport async function writeJsonAsync(\n  fs: FileSystem,\n  filePath: string,\n  value: JsonObject,\n  context: Context,\n): Promise<void> {\n  await writeFileAtomicAsync(fs, filePath, serializeJson(value), context);\n}\n"],"mappings":";;AAcA,SAAgB,SAAS,OAAqC;CAC5D,OAAO,OAAO,UAAU,YAAY,UAAU,QAAQ,CAAC,MAAM,QAAQ,KAAK;AAC5E;;AAGA,SAAgB,gBAAgB,SAA6B,WAAuB,CAAC,GAAe;CAClG,MAAM,UAAU,SAAS,KAAK;CAC9B,OAAO,UAAW,KAAK,MAAM,OAAO,IAAmB;AACzD;;AAGA,SAAgB,cAAc,OAA2B;CACvD,OAAO,GAAG,KAAK,UAAU,OAAO,MAAM,CAAC,EAAE;AAC3C;;AAGA,eAAsB,cACpB,IACA,UACA,SACA,WAAuB,CAAC,GACH;CACrB,OAAO,gBAAgB,MAAMA,cAAAA,iBAAiB,IAAI,UAAU,OAAO,GAAG,QAAQ;AAChF;;AAGA,eAAsB,eACpB,IACA,UACA,OACA,SACe;CACf,MAAMC,cAAAA,gBAAqB,IAAI,UAAU,cAAc,KAAK,GAAG,OAAO;AACxE"}

package/dist/src/services/json/core.d.mts

@@ -0,0 +1,21 @@
+import { FileSystem } from "@earendil-works/pi-durable/env";
+import { Context } from "@earendil-works/chord";
+//#region src/services/json/core.d.ts
+/**
+ * JSON state helpers for files the harness owns on disk.
+ *
+ * Compatibility frontends read these files while another repository's harness
+ * may be writing them, so writes go through a rename rather than a truncate.
+ */
+export type JsonObject = Record<string, unknown>;
+export declare function isRecord(value: unknown): value is JsonObject;
+/** Parses a JSON object, treating missing or blank content as the fallback. */
+export declare function parseJsonObject(content: string | undefined, fallback?: JsonObject): JsonObject;
+/** The on-disk form of a JSON state file: two-space indent and a trailing newline. */
+export declare function serializeJson(value: JsonObject): string;
+/** Reads a JSON object, treating a missing or empty file as the fallback. */
+export declare function readJsonAsync(fs: FileSystem, filePath: string, context: Context, fallback?: JsonObject): Promise<JsonObject>;
+/** Writes a JSON object through a uniquely named temporary file and a rename. */
+export declare function writeJsonAsync(fs: FileSystem, filePath: string, value: JsonObject, context: Context): Promise<void>;
+//#endregion
+//# sourceMappingURL=core.d.mts.map

package/dist/src/services/json/core.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.d.mts","names":[],"sources":["../../../../src/services/json/core.ts"],"mappings":";;;;;;;;;YAYY,aAAa;wBAET,SAAS,iBAAiB,SAAS;;wBAKnC,gBAAgB,6BAA6B,WAAU,aAAkB;;wBAMzE,cAAc,OAAO;;wBAKf,cACpB,IAAI,YACJ,kBACA,SAAS,SACT,WAAU,aACT,QAAQ;;wBAKW,eACpB,IAAI,YACJ,kBACA,OAAO,YACP,SAAS,UACR"}

package/dist/src/services/json/core.mjs

@@ -0,0 +1,26 @@
+import { readTextIfExists, writeFileAtomic } from "../platformFiles/index.mjs";
+//#region src/services/json/core.ts
+function isRecord(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+/** Parses a JSON object, treating missing or blank content as the fallback. */
+function parseJsonObject(content, fallback = {}) {
+	const trimmed = content?.trim();
+	return trimmed ? JSON.parse(trimmed) : fallback;
+}
+/** The on-disk form of a JSON state file: two-space indent and a trailing newline. */
+function serializeJson(value) {
+	return `${JSON.stringify(value, null, 2)}\n`;
+}
+/** Reads a JSON object, treating a missing or empty file as the fallback. */
+async function readJsonAsync(fs, filePath, context, fallback = {}) {
+	return parseJsonObject(await readTextIfExists(fs, filePath, context), fallback);
+}
+/** Writes a JSON object through a uniquely named temporary file and a rename. */
+async function writeJsonAsync(fs, filePath, value, context) {
+	await writeFileAtomic(fs, filePath, serializeJson(value), context);
+}
+//#endregion
+export { isRecord, parseJsonObject, readJsonAsync, serializeJson, writeJsonAsync };
+
+//# sourceMappingURL=core.mjs.map

package/dist/src/services/json/core.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.mjs","names":["writeFileAtomicAsync"],"sources":["../../../../src/services/json/core.ts"],"sourcesContent":["import type { Context } from '@earendil-works/chord';\nimport type { FileSystem } from '@earendil-works/pi-durable/env';\n\nimport { readTextIfExists, writeFileAtomic as writeFileAtomicAsync } from '../platformFiles';\n\n/**\n * JSON state helpers for files the harness owns on disk.\n *\n * Compatibility frontends read these files while another repository's harness\n * may be writing them, so writes go through a rename rather than a truncate.\n */\n\nexport type JsonObject = Record<string, unknown>;\n\nexport function isRecord(value: unknown): value is JsonObject {\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\n/** Parses a JSON object, treating missing or blank content as the fallback. */\nexport function parseJsonObject(content: string | undefined, fallback: JsonObject = {}): JsonObject {\n  const trimmed = content?.trim();\n  return trimmed ? (JSON.parse(trimmed) as JsonObject) : fallback;\n}\n\n/** The on-disk form of a JSON state file: two-space indent and a trailing newline. */\nexport function serializeJson(value: JsonObject): string {\n  return `${JSON.stringify(value, null, 2)}\\n`;\n}\n\n/** Reads a JSON object, treating a missing or empty file as the fallback. */\nexport async function readJsonAsync(\n  fs: FileSystem,\n  filePath: string,\n  context: Context,\n  fallback: JsonObject = {},\n): Promise<JsonObject> {\n  return parseJsonObject(await readTextIfExists(fs, filePath, context), fallback);\n}\n\n/** Writes a JSON object through a uniquely named temporary file and a rename. */\nexport async function writeJsonAsync(\n  fs: FileSystem,\n  filePath: string,\n  value: JsonObject,\n  context: Context,\n): Promise<void> {\n  await writeFileAtomicAsync(fs, filePath, serializeJson(value), context);\n}\n"],"mappings":";;AAcA,SAAgB,SAAS,OAAqC;CAC5D,OAAO,OAAO,UAAU,YAAY,UAAU,QAAQ,CAAC,MAAM,QAAQ,KAAK;AAC5E;;AAGA,SAAgB,gBAAgB,SAA6B,WAAuB,CAAC,GAAe;CAClG,MAAM,UAAU,SAAS,KAAK;CAC9B,OAAO,UAAW,KAAK,MAAM,OAAO,IAAmB;AACzD;;AAGA,SAAgB,cAAc,OAA2B;CACvD,OAAO,GAAG,KAAK,UAAU,OAAO,MAAM,CAAC,EAAE;AAC3C;;AAGA,eAAsB,cACpB,IACA,UACA,SACA,WAAuB,CAAC,GACH;CACrB,OAAO,gBAAgB,MAAM,iBAAiB,IAAI,UAAU,OAAO,GAAG,QAAQ;AAChF;;AAGA,eAAsB,eACpB,IACA,UACA,OACA,SACe;CACf,MAAMA,gBAAqB,IAAI,UAAU,cAAc,KAAK,GAAG,OAAO;AACxE"}

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

@@ -0,0 +1,48 @@
+const require_runtime = require("../../../_virtual/_rolldown/runtime.cjs");
+const require_core = require("./core.cjs");
+let node_crypto = require("node:crypto");
+let node_fs = require("node:fs");
+node_fs = require_runtime.__toESM(node_fs, 1);
+let node_path = require("node:path");
+node_path = require_runtime.__toESM(node_path, 1);
+//#region src/services/json/sync.ts
+const ATOMIC_FILE_SUFFIX = ".tmp";
+/**
+* Reads a JSON object, treating a missing or empty file as the fallback.
+*
+* @deprecated Node-only sync shim; use readJsonAsync. Removed in M2.
+*/
+function readJson(filePath, fallback = {}) {
+	if (!node_fs.default.existsSync(filePath)) return fallback;
+	return require_core.parseJsonObject(node_fs.default.readFileSync(filePath, "utf8"), fallback);
+}
+/**
+* Writes through a uniquely named temporary file in the same directory.
+*
+* The pid and a UUID are both in the name so two harnesses writing the same
+* target cannot collide on the temporary path, and a failed write cleans up
+* after itself rather than leaving the fragment behind.
+*
+* @deprecated Node-only sync shim; use writeFileAtomic from `@agimon-ai/po-core/platform`. Removed in M2.
+*/
+function writeFileAtomic(filePath, content) {
+	node_fs.default.mkdirSync(node_path.default.dirname(filePath), { recursive: true });
+	const temporaryPath = `${filePath}.${process.pid}.${(0, node_crypto.randomUUID)()}${ATOMIC_FILE_SUFFIX}`;
+	try {
+		node_fs.default.writeFileSync(temporaryPath, content);
+		node_fs.default.renameSync(temporaryPath, filePath);
+	} catch (error) {
+		node_fs.default.rmSync(temporaryPath, { force: true });
+		throw error;
+	}
+}
+/** @deprecated Node-only sync shim; use writeJsonAsync. Removed in M2. */
+function writeJson(filePath, value) {
+	writeFileAtomic(filePath, require_core.serializeJson(value));
+}
+//#endregion
+exports.readJson = readJson;
+exports.writeFileAtomic = writeFileAtomic;
+exports.writeJson = writeJson;
+
+//# sourceMappingURL=sync.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sync.cjs","names":["fs","parseJsonObject","path","randomUUID","serializeJson"],"sources":["../../../../src/services/json/sync.ts"],"sourcesContent":["import { randomUUID } from 'node:crypto';\nimport fs from 'node:fs';\nimport path from 'node:path';\n\nimport { parseJsonObject, serializeJson } from './core';\nimport type { JsonObject } from './core';\n\nconst ATOMIC_FILE_SUFFIX = '.tmp';\n\n/**\n * Reads a JSON object, treating a missing or empty file as the fallback.\n *\n * @deprecated Node-only sync shim; use readJsonAsync. Removed in M2.\n */\nexport function readJson(filePath: string, fallback: JsonObject = {}): JsonObject {\n  if (!fs.existsSync(filePath)) return fallback;\n  return parseJsonObject(fs.readFileSync(filePath, 'utf8'), fallback);\n}\n\n/**\n * Writes through a uniquely named temporary file in the same directory.\n *\n * The pid and a UUID are both in the name so two harnesses writing the same\n * target cannot collide on the temporary path, and a failed write cleans up\n * after itself rather than leaving the fragment behind.\n *\n * @deprecated Node-only sync shim; use writeFileAtomic from `@agimon-ai/po-core/platform`. Removed in M2.\n */\nexport function writeFileAtomic(filePath: string, content: string): void {\n  fs.mkdirSync(path.dirname(filePath), { recursive: true });\n  const temporaryPath = `${filePath}.${process.pid}.${randomUUID()}${ATOMIC_FILE_SUFFIX}`;\n  try {\n    fs.writeFileSync(temporaryPath, content);\n    fs.renameSync(temporaryPath, filePath);\n  } catch (error) {\n    fs.rmSync(temporaryPath, { force: true });\n    throw error;\n  }\n}\n\n/** @deprecated Node-only sync shim; use writeJsonAsync. Removed in M2. */\nexport function writeJson(filePath: string, value: JsonObject): void {\n  writeFileAtomic(filePath, serializeJson(value));\n}\n"],"mappings":";;;;;;;;AAOA,MAAM,qBAAqB;;;;;;AAO3B,SAAgB,SAAS,UAAkB,WAAuB,CAAC,GAAe;CAChF,IAAI,CAACA,QAAAA,QAAG,WAAW,QAAQ,GAAG,OAAO;CACrC,OAAOC,aAAAA,gBAAgBD,QAAAA,QAAG,aAAa,UAAU,MAAM,GAAG,QAAQ;AACpE;;;;;;;;;;AAWA,SAAgB,gBAAgB,UAAkB,SAAuB;CACvE,QAAA,QAAG,UAAUE,UAAAA,QAAK,QAAQ,QAAQ,GAAG,EAAE,WAAW,KAAK,CAAC;CACxD,MAAM,gBAAgB,GAAG,SAAS,GAAG,QAAQ,IAAI,IAAA,GAAGC,YAAAA,WAAAA,CAAW,IAAI;CACnE,IAAI;EACF,QAAA,QAAG,cAAc,eAAe,OAAO;EACvC,QAAA,QAAG,WAAW,eAAe,QAAQ;CACvC,SAAS,OAAO;EACd,QAAA,QAAG,OAAO,eAAe,EAAE,OAAO,KAAK,CAAC;EACxC,MAAM;CACR;AACF;;AAGA,SAAgB,UAAU,UAAkB,OAAyB;CACnE,gBAAgB,UAAUC,aAAAA,cAAc,KAAK,CAAC;AAChD"}

package/dist/src/services/json/sync.d.mts

@@ -0,0 +1,22 @@
+import { JsonObject } from "./core.mjs";
+//#region src/services/json/sync.d.ts
+/**
+ * Reads a JSON object, treating a missing or empty file as the fallback.
+ *
+ * @deprecated Node-only sync shim; use readJsonAsync. Removed in M2.
+ */
+export declare function readJson(filePath: string, fallback?: JsonObject): JsonObject;
+/**
+ * Writes through a uniquely named temporary file in the same directory.
+ *
+ * The pid and a UUID are both in the name so two harnesses writing the same
+ * target cannot collide on the temporary path, and a failed write cleans up
+ * after itself rather than leaving the fragment behind.
+ *
+ * @deprecated Node-only sync shim; use writeFileAtomic from `@agimon-ai/po-core/platform`. Removed in M2.
+ */
+export declare function writeFileAtomic(filePath: string, content: string): void;
+/** @deprecated Node-only sync shim; use writeJsonAsync. Removed in M2. */
+export declare function writeJson(filePath: string, value: JsonObject): void;
+//#endregion
+//# sourceMappingURL=sync.d.mts.map

package/dist/src/services/json/sync.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.d.mts","names":[],"sources":["../../../../src/services/json/sync.ts"],"mappings":";;;;;;;wBAcgB,SAAS,kBAAkB,WAAU,aAAkB;;;;;;;;;;wBAcvD,gBAAgB,kBAAkB;;wBAalC,UAAU,kBAAkB,OAAO"}

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

@@ -0,0 +1,43 @@
+import { parseJsonObject, serializeJson } from "./core.mjs";
+import { randomUUID } from "node:crypto";
+import fs from "node:fs";
+import path from "node:path";
+//#region src/services/json/sync.ts
+const ATOMIC_FILE_SUFFIX = ".tmp";
+/**
+* Reads a JSON object, treating a missing or empty file as the fallback.
+*
+* @deprecated Node-only sync shim; use readJsonAsync. Removed in M2.
+*/
+function readJson(filePath, fallback = {}) {
+	if (!fs.existsSync(filePath)) return fallback;
+	return parseJsonObject(fs.readFileSync(filePath, "utf8"), fallback);
+}
+/**
+* Writes through a uniquely named temporary file in the same directory.
+*
+* The pid and a UUID are both in the name so two harnesses writing the same
+* target cannot collide on the temporary path, and a failed write cleans up
+* after itself rather than leaving the fragment behind.
+*
+* @deprecated Node-only sync shim; use writeFileAtomic from `@agimon-ai/po-core/platform`. Removed in M2.
+*/
+function writeFileAtomic(filePath, content) {
+	fs.mkdirSync(path.dirname(filePath), { recursive: true });
+	const temporaryPath = `${filePath}.${process.pid}.${randomUUID()}${ATOMIC_FILE_SUFFIX}`;
+	try {
+		fs.writeFileSync(temporaryPath, content);
+		fs.renameSync(temporaryPath, filePath);
+	} catch (error) {
+		fs.rmSync(temporaryPath, { force: true });
+		throw error;
+	}
+}
+/** @deprecated Node-only sync shim; use writeJsonAsync. Removed in M2. */
+function writeJson(filePath, value) {
+	writeFileAtomic(filePath, serializeJson(value));
+}
+//#endregion
+export { readJson, writeFileAtomic, writeJson };
+
+//# sourceMappingURL=sync.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sync.mjs","names":[],"sources":["../../../../src/services/json/sync.ts"],"sourcesContent":["import { randomUUID } from 'node:crypto';\nimport fs from 'node:fs';\nimport path from 'node:path';\n\nimport { parseJsonObject, serializeJson } from './core';\nimport type { JsonObject } from './core';\n\nconst ATOMIC_FILE_SUFFIX = '.tmp';\n\n/**\n * Reads a JSON object, treating a missing or empty file as the fallback.\n *\n * @deprecated Node-only sync shim; use readJsonAsync. Removed in M2.\n */\nexport function readJson(filePath: string, fallback: JsonObject = {}): JsonObject {\n  if (!fs.existsSync(filePath)) return fallback;\n  return parseJsonObject(fs.readFileSync(filePath, 'utf8'), fallback);\n}\n\n/**\n * Writes through a uniquely named temporary file in the same directory.\n *\n * The pid and a UUID are both in the name so two harnesses writing the same\n * target cannot collide on the temporary path, and a failed write cleans up\n * after itself rather than leaving the fragment behind.\n *\n * @deprecated Node-only sync shim; use writeFileAtomic from `@agimon-ai/po-core/platform`. Removed in M2.\n */\nexport function writeFileAtomic(filePath: string, content: string): void {\n  fs.mkdirSync(path.dirname(filePath), { recursive: true });\n  const temporaryPath = `${filePath}.${process.pid}.${randomUUID()}${ATOMIC_FILE_SUFFIX}`;\n  try {\n    fs.writeFileSync(temporaryPath, content);\n    fs.renameSync(temporaryPath, filePath);\n  } catch (error) {\n    fs.rmSync(temporaryPath, { force: true });\n    throw error;\n  }\n}\n\n/** @deprecated Node-only sync shim; use writeJsonAsync. Removed in M2. */\nexport function writeJson(filePath: string, value: JsonObject): void {\n  writeFileAtomic(filePath, serializeJson(value));\n}\n"],"mappings":";;;;;AAOA,MAAM,qBAAqB;;;;;;AAO3B,SAAgB,SAAS,UAAkB,WAAuB,CAAC,GAAe;CAChF,IAAI,CAAC,GAAG,WAAW,QAAQ,GAAG,OAAO;CACrC,OAAO,gBAAgB,GAAG,aAAa,UAAU,MAAM,GAAG,QAAQ;AACpE;;;;;;;;;;AAWA,SAAgB,gBAAgB,UAAkB,SAAuB;CACvE,GAAG,UAAU,KAAK,QAAQ,QAAQ,GAAG,EAAE,WAAW,KAAK,CAAC;CACxD,MAAM,gBAAgB,GAAG,SAAS,GAAG,QAAQ,IAAI,GAAG,WAAW,IAAI;CACnE,IAAI;EACF,GAAG,cAAc,eAAe,OAAO;EACvC,GAAG,WAAW,eAAe,QAAQ;CACvC,SAAS,OAAO;EACd,GAAG,OAAO,eAAe,EAAE,OAAO,KAAK,CAAC;EACxC,MAAM;CACR;AACF;;AAGA,SAAgB,UAAU,UAAkB,OAAyB;CACnE,gBAAgB,UAAU,cAAc,KAAK,CAAC;AAChD"}

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

@@ -7,7 +7,7 @@ function sameList(left, right) {
 function describe(error) {
 	return error instanceof Error ? error.message : String(error);
 }
-function createDoomKernel(options = {}) {
+function createPoKernel(options = {}) {
 	const slots = /* @__PURE__ */ new Map();
 	const dirty = /* @__PURE__ */ new Set();
 	/** Slots whose values render differently without the list itself changing. */
@@ -142,6 +142,6 @@ function createDoomKernel(options = {}) {
 	};
 }
 //#endregion
-exports.createDoomKernel = createDoomKernel;
+exports.createPoKernel = createPoKernel;
 
 //# sourceMappingURL=index.cjs.map

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

@@ -1 +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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"}
+{"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  PoKernel,\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 CreatePoKernelOptions {\n  /** Layers active at creation, usually `resolveLayers(config, majorMode)`. */\n  readonly activeLayers?: readonly string[];\n}\n\nexport function createPoKernel(options: CreatePoKernelOptions = {}): PoKernel {\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":";AAoCA,MAAM,mBAAmB;AAEzB,SAAS,SAAS,MAAsC,OAAoC;CAC1F,IAAI,SAAS,KAAA,KAAa,KAAK,WAAW,MAAM,QAAQ,OAAO;CAC/D,OAAO,KAAK,OAAO,OAAO,UAAU,UAAU,MAAM,MAAM;AAC5D;AAEA,SAAS,SAAS,OAAwB;CACxC,OAAO,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AAC9D;AAOA,SAAgB,eAAe,UAAiC,CAAC,GAAa;CAC5E,MAAM,wBAAQ,IAAI,IAAuB;CACzC,MAAM,wBAAQ,IAAI,IAAY;;CAE9B,MAAM,yBAAS,IAAI,IAAY;CAC/B,IAAI,SAAS,IAAI,IAAI,QAAQ,gBAAgB,CAAC,CAAC;CAC/C,IAAI,WAAW;CACf,IAAI,OAAsB,QAAQ,QAAQ;CAC1C,IAAI;CACJ,IAAI,WAAW;CAEf,MAAM,YAAY,SAChB,CAAC,GAAG,KAAK,QAAQ,QAAQ,CAAC,CAAC,CACxB,MAAM,CAAC,OAAO,CAAC,WAAW,OAAO,KAAK,CAAC,CACvC,QAAQ,GAAG,WAAW,MAAM,UAAU,KAAA,KAAa,OAAO,IAAI,MAAM,KAAK,CAAC,CAAC,CAC3E,KAAK,GAAG,WAAW,MAAM,KAAK;CAEnC,MAAM,UAAU,OAAO,MAAiB,OAAgB,aAAsC;EAC5F,IAAI,KAAK,UAAU;EACnB,MAAM,SAAS,SAAS,IAAI;EAC5B,IAAI,CAAC,SAAS,SAAS,KAAK,QAAQ,MAAM,GAAG;EAC7C,IAAI;GACF,MAAM,KAAK,KAAK,MAAM;GACtB,KAAK,SAAS;EAChB,SAAS,OAAO;GAGd,SAAS,KAAK,GAAG,KAAK,KAAK,IAAI,SAAS,KAAK,GAAG;EAClD;CACF;CAEA,MAAM,cAA6B;EACjC,MAAM,MAAM,KACT,YAAY,KAAA,CAAS,CAAC,CACtB,KAAK,YAAY;GAChB,IAAI,MAAM,SAAS,GAAG;GACtB,MAAM,UAAU,CAAC,GAAG,KAAK;GACzB,MAAM,gBAAgB,IAAI,IAAI,MAAM;GACpC,MAAM,MAAM;GACZ,OAAO,MAAM;GACb,MAAM,WAAqB,CAAC;GAC5B,KAAK,MAAM,QAAQ,SAAS;IAC1B,MAAM,OAAO,MAAM,IAAI,IAAI;IAC3B,IAAI,MAAM,MAAM,QAAQ,MAAM,cAAc,IAAI,IAAI,GAAG,QAAQ;GACjE;GACA,IAAI,SAAS,SAAS,GAAG,MAAM,IAAI,MAAM,iCAAiC,SAAS,KAAK,IAAI,GAAG;EACjG,CAAC;EACH,OAAO;EACP,OAAO;CACT;CAEA,MAAM,iBAAuB;EAC3B,IAAI,WAAW;EACf,YAAY,QAAQ,QAAQ,CAAC,CAAC,WAAW;GACvC,YAAY,KAAA;GAEZ,OAAO,MAAM,CAAC,CAAC,YAAY,KAAA,CAAS;EACtC,CAAC;CACH;CAEA,MAAM,aAAa,SAAuB;EACxC,MAAM,IAAI,IAAI;CAChB;CAEA,MAAM,cAAsB,MAAc,UAA0D;EAClG,IAAI,UAAU,MAAM,IAAI,MAAM,gBAAgB;EAC9C,MAAM,QAAQ,MAAM,IAAI,IAAI;EAC5B,IAAI,CAAC,OACH,MAAM,IAAI,MAAM,wBAAwB,KAAK,mBAAmB,CAAC,GAAG,MAAM,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,KAAK,QAAQ;EAC1G,MAAM,MAAM;EACZ,MAAM,QAAQ,IAAI,KAAK,KAAoC;EAC3D,UAAU,IAAI;EACd,SAAS;EACT,IAAI,UAAU;EACd,OAAO,EACL,UAAgB;GACd,IAAI,SAAS;GACb,UAAU;GACV,MAAM,QAAQ,OAAO,GAAG;GACxB,UAAU,IAAI;GACd,SAAS;EACX,EACF;CACF;CAEA,OAAO;EACL,IAAI,eAAkC;GACpC,OAAO,CAAC,GAAG,MAAM;EACnB;EACA,IAAI,QAA2B;GAC7B,OAAO,CAAC,GAAG,MAAM,KAAK,CAAC;EACzB;EACA,WAAmB,MAAc,MAAwD;GACvF,IAAI,UAAU,MAAM,IAAI,MAAM,gBAAgB;GAC9C,IAAI,MAAM,IAAI,IAAI,GAAG,MAAM,IAAI,MAAM,gCAAgC,MAAM;GAC3E,MAAM,QAAmB;IACvB;IACM;IACN,yBAAS,IAAI,IAAI;IACjB,QAAQ,KAAA;IACR,UAAU;GACZ;GACA,MAAM,IAAI,MAAM,KAAK;GACrB,IAAI,UAAU;GACd,OAAO;IACL;IACA,aAAa,UAAU,WAAW,MAAM,KAAK;IAC7C,UAAgB;KACd,IAAI,SAAS;KACb,UAAU;KACV,MAAM,WAAW;KACjB,MAAM,OAAO,IAAI;KACjB,MAAM,OAAO,IAAI;KACjB,OAAO,OAAO,IAAI;IACpB;GACF;EACF;EACA;EACA,MAAM,gBAAgB,MAAwC;GAC5D,IAAI,UAAU,MAAM,IAAI,MAAM,gBAAgB;GAC9C,SAAS,IAAI,IAAI,IAAI;GACrB,KAAK,MAAM,QAAQ,MAAM,KAAK,GAAG,UAAU,IAAI;GAC/C,MAAM,MAAM;EACd;EACA,MAAM,QAAQ,MAA8B;GAC1C,IAAI,UAAU,MAAM,IAAI,MAAM,gBAAgB;GAC9C,IAAI,SAAS,KAAA,GACX,KAAK,MAAM,QAAQ,MAAM,KAAK,GAAG;IAC/B,UAAU,IAAI;IACd,OAAO,IAAI,IAAI;GACjB;QACK,IAAI,MAAM,IAAI,IAAI,GAAG;IAC1B,UAAU,IAAI;IACd,OAAO,IAAI,IAAI;GACjB;GACA,MAAM,MAAM;EACd;EACA,aAAqB,MAAiC;GACpD,MAAM,QAAQ,MAAM,IAAI,IAAI;GAC5B,OAAO,QAAS,SAAS,KAAK,IAA0B,CAAC;EAC3D;EACA,cAAsB,MAAqD;GACzE,MAAM,QAAQ,MAAM,IAAI,IAAI;GAC5B,OAAO,QAAS,CAAC,GAAG,MAAM,QAAQ,OAAO,CAAC,IAA8C,CAAC;EAC3F;EACA,UAAgB;GACd,IAAI,UAAU;GACd,WAAW;GACX,KAAK,MAAM,SAAS,MAAM,OAAO,GAAG,MAAM,WAAW;GACrD,MAAM,MAAM;GACZ,MAAM,MAAM;EACd;CACF;AACF"}

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

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

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

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

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

@@ -7,7 +7,7 @@ function sameList(left, right) {
 function describe(error) {
 	return error instanceof Error ? error.message : String(error);
 }
-function createDoomKernel(options = {}) {
+function createPoKernel(options = {}) {
 	const slots = /* @__PURE__ */ new Map();
 	const dirty = /* @__PURE__ */ new Set();
 	/** Slots whose values render differently without the list itself changing. */
@@ -142,6 +142,6 @@ function createDoomKernel(options = {}) {
 	};
 }
 //#endregion
-export { createDoomKernel };
+export { createPoKernel };
 
 //# sourceMappingURL=index.mjs.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","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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"}
+{"version":3,"file":"index.mjs","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  PoKernel,\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 CreatePoKernelOptions {\n  /** Layers active at creation, usually `resolveLayers(config, majorMode)`. */\n  readonly activeLayers?: readonly string[];\n}\n\nexport function createPoKernel(options: CreatePoKernelOptions = {}): PoKernel {\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/src/services/nativeChildTools/index.cjs

@@ -0,0 +1,16 @@
+let _earendil_works_pi_coding_agent = require("@earendil-works/pi-coding-agent");
+//#region src/services/nativeChildTools/index.ts
+/** Pi's built-in coding tools a child session may be granted by name. */
+const NATIVE_TOOL_FACTORIES = {
+	read: _earendil_works_pi_coding_agent.createReadTool,
+	bash: _earendil_works_pi_coding_agent.createBashTool,
+	edit: _earendil_works_pi_coding_agent.createEditTool,
+	write: _earendil_works_pi_coding_agent.createWriteTool,
+	grep: _earendil_works_pi_coding_agent.createGrepTool,
+	find: _earendil_works_pi_coding_agent.createFindTool,
+	ls: _earendil_works_pi_coding_agent.createLsTool
+};
+//#endregion
+exports.NATIVE_TOOL_FACTORIES = NATIVE_TOOL_FACTORIES;
+
+//# sourceMappingURL=index.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":["createReadTool","createBashTool","createEditTool","createWriteTool","createGrepTool","createFindTool","createLsTool"],"sources":["../../../../src/services/nativeChildTools/index.ts"],"sourcesContent":["import {\n  createBashTool,\n  createEditTool,\n  createFindTool,\n  createGrepTool,\n  createLsTool,\n  createReadTool,\n  createWriteTool,\n} from '@earendil-works/pi-coding-agent';\n\n/** Pi's built-in coding tools a child session may be granted by name. */\nexport const NATIVE_TOOL_FACTORIES = {\n  read: createReadTool,\n  bash: createBashTool,\n  edit: createEditTool,\n  write: createWriteTool,\n  grep: createGrepTool,\n  find: createFindTool,\n  ls: createLsTool,\n};\n"],"mappings":";;;AAWA,MAAa,wBAAwB;CACnC,MAAMA,gCAAAA;CACN,MAAMC,gCAAAA;CACN,MAAMC,gCAAAA;CACN,OAAOC,gCAAAA;CACP,MAAMC,gCAAAA;CACN,MAAMC,gCAAAA;CACN,IAAIC,gCAAAA;AACN"}

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

@@ -0,0 +1,16 @@
+import { createBashTool, createEditTool, createFindTool, createGrepTool, createLsTool, createReadTool, createWriteTool } from "@earendil-works/pi-coding-agent";
+//#region src/services/nativeChildTools/index.ts
+/** Pi's built-in coding tools a child session may be granted by name. */
+const NATIVE_TOOL_FACTORIES = {
+	read: createReadTool,
+	bash: createBashTool,
+	edit: createEditTool,
+	write: createWriteTool,
+	grep: createGrepTool,
+	find: createFindTool,
+	ls: createLsTool
+};
+//#endregion
+export { NATIVE_TOOL_FACTORIES };
+
+//# sourceMappingURL=index.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../../src/services/nativeChildTools/index.ts"],"sourcesContent":["import {\n  createBashTool,\n  createEditTool,\n  createFindTool,\n  createGrepTool,\n  createLsTool,\n  createReadTool,\n  createWriteTool,\n} from '@earendil-works/pi-coding-agent';\n\n/** Pi's built-in coding tools a child session may be granted by name. */\nexport const NATIVE_TOOL_FACTORIES = {\n  read: createReadTool,\n  bash: createBashTool,\n  edit: createEditTool,\n  write: createWriteTool,\n  grep: createGrepTool,\n  find: createFindTool,\n  ls: createLsTool,\n};\n"],"mappings":";;;AAWA,MAAa,wBAAwB;CACnC,MAAM;CACN,MAAM;CACN,MAAM;CACN,OAAO;CACP,MAAM;CACN,MAAM;CACN,IAAI;AACN"}

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

@@ -0,0 +1,30 @@
+const require_runtime = require("../../../_virtual/_rolldown/runtime.cjs");
+let node_os = require("node:os");
+node_os = require_runtime.__toESM(node_os, 1);
+let node_fs_promises = require("node:fs/promises");
+node_fs_promises = require_runtime.__toESM(node_fs_promises, 1);
+//#region src/services/nodeHost/index.ts
+/**
+* Host details that only a Node process has. Portable modules reach them through
+* this seam; the edge build swaps in `index.edge.ts`.
+*/
+const nodeHost = {
+	homeDirectory: () => node_os.default.homedir(),
+	temporaryDirectory: () => node_os.default.tmpdir(),
+	processId: () => process.pid,
+	/** POSIX permission bits; the edge has no owner to protect against, so it skips this. */
+	setMode: (filePath, mode) => node_fs_promises.default.chmod(filePath, mode),
+	/** POSIX permission bits of an existing file, or `undefined` when it is missing. */
+	fileMode: async (filePath) => {
+		try {
+			return (await node_fs_promises.default.stat(filePath)).mode & 4095;
+		} catch (error) {
+			if (error.code === "ENOENT") return void 0;
+			throw error;
+		}
+	}
+};
+//#endregion
+exports.nodeHost = nodeHost;
+
+//# sourceMappingURL=index.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":["os","fs"],"sources":["../../../../src/services/nodeHost/index.ts"],"sourcesContent":["import fs from 'node:fs/promises';\nimport os from 'node:os';\n\n/**\n * Host details that only a Node process has. Portable modules reach them through\n * this seam; the edge build swaps in `index.edge.ts`.\n */\nexport const nodeHost = {\n  homeDirectory: (): string => os.homedir(),\n  temporaryDirectory: (): string => os.tmpdir(),\n  processId: (): number => process.pid,\n  /** POSIX permission bits; the edge has no owner to protect against, so it skips this. */\n  setMode: (filePath: string, mode: number): Promise<void> => fs.chmod(filePath, mode),\n  /** POSIX permission bits of an existing file, or `undefined` when it is missing. */\n  fileMode: async (filePath: string): Promise<number | undefined> => {\n    try {\n      return (await fs.stat(filePath)).mode & 0o7777;\n    } catch (error) {\n      if ((error as NodeJS.ErrnoException).code === 'ENOENT') return undefined;\n      throw error;\n    }\n  },\n};\n"],"mappings":";;;;;;;;;;AAOA,MAAa,WAAW;CACtB,qBAA6BA,QAAAA,QAAG,QAAQ;CACxC,0BAAkCA,QAAAA,QAAG,OAAO;CAC5C,iBAAyB,QAAQ;;CAEjC,UAAU,UAAkB,SAAgCC,iBAAAA,QAAG,MAAM,UAAU,IAAI;;CAEnF,UAAU,OAAO,aAAkD;EACjE,IAAI;GACF,QAAQ,MAAMA,iBAAAA,QAAG,KAAK,QAAQ,EAAA,CAAG,OAAO;EAC1C,SAAS,OAAO;GACd,IAAK,MAAgC,SAAS,UAAU,OAAO,KAAA;GAC/D,MAAM;EACR;CACF;AACF"}