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

package/dist/runtimePiSettings.cjs

@@ -0,0 +1,116 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_runtime = require("./_virtual/_rolldown/runtime.cjs");
+const require_runtimeJson = require("./runtimeJson.cjs");
+const require_doomPackage = require("./doomPackage.cjs");
+let node_os = require("node:os");
+node_os = require_runtime.__toESM(node_os, 1);
+let node_path = require("node:path");
+node_path = require_runtime.__toESM(node_path, 1);
+//#region src/services/piSettings/index.ts
+/**
+* Pi's user settings, as `doompi sync` maintains them.
+*
+* The Doom package is registered globally so a plain `pi` process can find the
+* lightweight package bootstrap before project resources are trusted. Sync owns
+* the extension registration, ambient-discovery filter, theme resource, selected default theme, and quiet-startup keys
+* while preserving every unrelated user setting.
+*/
+const PI_CODING_AGENT_DIR_ENV = "PI_CODING_AGENT_DIR";
+const PI_DIRECTORY = ".pi";
+const AGENT_DIRECTORY = "agent";
+const SETTINGS_FILE = "settings.json";
+const THEMES_DIRECTORY = "themes";
+const EXTENSIONS_KEY = "extensions";
+const THEMES_KEY = "themes";
+const THEME_KEY = "theme";
+const QUIET_STARTUP_KEY = "quietStartup";
+const HOME_ALIAS = "~";
+const HOME_ALIAS_PREFIX = "~/";
+/** The stable package entry Pi loads for every synced repository. */
+const DOOM_EXTENSION = require_doomPackage.DOOM_PACKAGE_NAME;
+/** Suppresses Pi's ambient extension-directory scan while leaving explicit sources intact. */
+const AMBIENT_EXTENSION_FILTER = "!extensions/**";
+/**
+* Pi built-in extensions kept off under DoomPi. doompi-mcp owns `/mcp` and MCP servers. Codemode and
+* tool search are opt-in in plain Pi, but DoomPi activates every registered tool, so leaving them
+* loaded would declare both to the model in every session.
+*/
+const DISABLED_PI_BUILTINS = [
+	"-builtin:mcp",
+	"-builtin:codemode",
+	"-builtin:tool-search"
+];
+/** Pi's user configuration directory, honoring its documented override. */
+function piAgentDirectory(environment = process.env, homeDirectory = node_os.default.homedir()) {
+	const configured = environment[PI_CODING_AGENT_DIR_ENV]?.trim();
+	if (!configured) return node_path.default.join(homeDirectory, PI_DIRECTORY, AGENT_DIRECTORY);
+	if (configured === HOME_ALIAS) return homeDirectory;
+	if (configured.startsWith(HOME_ALIAS_PREFIX)) return node_path.default.join(homeDirectory, configured.slice(2));
+	return node_path.default.resolve(configured);
+}
+function piSettingsPath(agentDirectory) {
+	return node_path.default.join(agentDirectory, SETTINGS_FILE);
+}
+function piThemeDirectory(agentDirectory) {
+	return node_path.default.join(agentDirectory, THEMES_DIRECTORY);
+}
+function stringList(value) {
+	return Array.isArray(value) ? value.filter((entry) => typeof entry === "string") : [];
+}
+function settingsRelativePath(agentDirectory, target) {
+	const relative = node_path.default.relative(agentDirectory, target);
+	if (relative.startsWith("..") || node_path.default.isAbsolute(relative)) return target;
+	return relative.split(node_path.default.sep).join("/");
+}
+function isManagedExtension(value) {
+	const normalized = value.replaceAll("\\", "/");
+	return normalized === DOOM_EXTENSION || normalized === "!extensions/**" || DISABLED_PI_BUILTINS.includes(normalized);
+}
+function isLegacyDoomTheme(value, themeName) {
+	const normalized = value.replaceAll("\\", "/");
+	return normalized.endsWith(`/doom/${themeName}.json`) || normalized === `doom/${themeName}.json`;
+}
+/** Produces the user settings content for an update, without writing it. */
+function mergePiSettings(current, agentDirectory, update) {
+	const theme = settingsRelativePath(agentDirectory, update.themePath);
+	const extensions = [
+		DOOM_EXTENSION,
+		AMBIENT_EXTENSION_FILTER,
+		...DISABLED_PI_BUILTINS,
+		...stringList(current[EXTENSIONS_KEY]).filter((value) => !isManagedExtension(value))
+	];
+	const themes = [theme, ...stringList(current[THEMES_KEY]).filter((value) => value !== theme && !isLegacyDoomTheme(value, update.themeName))];
+	return {
+		...current,
+		[QUIET_STARTUP_KEY]: true,
+		[EXTENSIONS_KEY]: extensions,
+		[THEMES_KEY]: themes,
+		[THEME_KEY]: typeof current[THEME_KEY] === "string" ? current[THEME_KEY] : update.themeName
+	};
+}
+function readPiSettings(agentDirectory) {
+	const settings = require_runtimeJson.readJson(piSettingsPath(agentDirectory));
+	return require_runtimeJson.isRecord(settings) ? settings : {};
+}
+function serializePiSettings(settings) {
+	return `${JSON.stringify(settings, null, 2)}\n`;
+}
+/** Merges the Doom-owned keys into Pi's user settings file. */
+function writePiSettings(agentDirectory, update) {
+	const settingsPath = piSettingsPath(agentDirectory);
+	require_runtimeJson.writeFileAtomic(settingsPath, serializePiSettings(mergePiSettings(readPiSettings(agentDirectory), agentDirectory, update)));
+	return settingsPath;
+}
+//#endregion
+exports.AMBIENT_EXTENSION_FILTER = AMBIENT_EXTENSION_FILTER;
+exports.DISABLED_PI_BUILTINS = DISABLED_PI_BUILTINS;
+exports.DOOM_EXTENSION = DOOM_EXTENSION;
+exports.mergePiSettings = mergePiSettings;
+exports.piAgentDirectory = piAgentDirectory;
+exports.piSettingsPath = piSettingsPath;
+exports.piThemeDirectory = piThemeDirectory;
+exports.readPiSettings = readPiSettings;
+exports.serializePiSettings = serializePiSettings;
+exports.writePiSettings = writePiSettings;
+
+//# sourceMappingURL=runtimePiSettings.cjs.map

package/dist/runtimePiSettings.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtimePiSettings.cjs","names":["DOOM_PACKAGE_NAME","os","path","readJson","isRecord"],"sources":["../src/services/piSettings/index.ts"],"sourcesContent":["import os from 'node:os';\nimport path from 'node:path';\n\nimport { DOOM_PACKAGE_NAME } from '../doomPackage';\nimport { isRecord, readJson, writeFileAtomic } from '../json';\nimport type { JsonObject } from '../json';\n\n/**\n * Pi's user settings, as `doompi sync` maintains them.\n *\n * The Doom package is registered globally so a plain `pi` process can find the\n * lightweight package bootstrap before project resources are trusted. Sync owns\n * the extension registration, ambient-discovery filter, theme resource, selected default theme, and quiet-startup keys\n * while preserving every unrelated user setting.\n */\n\nconst PI_CODING_AGENT_DIR_ENV = 'PI_CODING_AGENT_DIR';\nconst PI_DIRECTORY = '.pi';\nconst AGENT_DIRECTORY = 'agent';\nconst SETTINGS_FILE = 'settings.json';\nconst THEMES_DIRECTORY = 'themes';\nconst EXTENSIONS_KEY = 'extensions';\nconst THEMES_KEY = 'themes';\nconst THEME_KEY = 'theme';\nconst QUIET_STARTUP_KEY = 'quietStartup';\nconst HOME_ALIAS = '~';\nconst HOME_ALIAS_PREFIX = '~/';\n/** The stable package entry Pi loads for every synced repository. */\nexport const DOOM_EXTENSION = DOOM_PACKAGE_NAME;\n/** Suppresses Pi's ambient extension-directory scan while leaving explicit sources intact. */\nexport const AMBIENT_EXTENSION_FILTER = '!extensions/**';\n/**\n * Pi built-in extensions kept off under DoomPi. doompi-mcp owns `/mcp` and MCP servers. Codemode and\n * tool search are opt-in in plain Pi, but DoomPi activates every registered tool, so leaving them\n * loaded would declare both to the model in every session.\n */\nexport const DISABLED_PI_BUILTINS: readonly string[] = ['-builtin:mcp', '-builtin:codemode', '-builtin:tool-search'];\nexport interface PiSettingsUpdate {\n  /** Absolute path to the synchronized user theme file. */\n  themePath: string;\n  themeName: string;\n}\n\n/** Pi's user configuration directory, honoring its documented override. */\nexport function piAgentDirectory(\n  environment: NodeJS.ProcessEnv = process.env,\n  homeDirectory: string = os.homedir(),\n): string {\n  const configured = environment[PI_CODING_AGENT_DIR_ENV]?.trim();\n  if (!configured) return path.join(homeDirectory, PI_DIRECTORY, AGENT_DIRECTORY);\n  if (configured === HOME_ALIAS) return homeDirectory;\n  if (configured.startsWith(HOME_ALIAS_PREFIX)) {\n    return path.join(homeDirectory, configured.slice(HOME_ALIAS_PREFIX.length));\n  }\n  return path.resolve(configured);\n}\n\nexport function piSettingsPath(agentDirectory: string): string {\n  return path.join(agentDirectory, SETTINGS_FILE);\n}\n\nexport function piThemeDirectory(agentDirectory: string): string {\n  return path.join(agentDirectory, THEMES_DIRECTORY);\n}\n\nfunction stringList(value: unknown): string[] {\n  return Array.isArray(value) ? value.filter((entry): entry is string => typeof entry === 'string') : [];\n}\n\nfunction settingsRelativePath(agentDirectory: string, target: string): string {\n  const relative = path.relative(agentDirectory, target);\n  if (relative.startsWith('..') || path.isAbsolute(relative)) return target;\n  return relative.split(path.sep).join('/');\n}\n\nfunction isManagedExtension(value: string): boolean {\n  const normalized = value.replaceAll('\\\\', '/');\n  return (\n    normalized === DOOM_EXTENSION ||\n    normalized === AMBIENT_EXTENSION_FILTER ||\n    DISABLED_PI_BUILTINS.includes(normalized)\n  );\n}\n\nfunction isLegacyDoomTheme(value: string, themeName: string): boolean {\n  const normalized = value.replaceAll('\\\\', '/');\n  return normalized.endsWith(`/doom/${themeName}.json`) || normalized === `doom/${themeName}.json`;\n}\n\n/** Produces the user settings content for an update, without writing it. */\nexport function mergePiSettings(current: JsonObject, agentDirectory: string, update: PiSettingsUpdate): JsonObject {\n  const theme = settingsRelativePath(agentDirectory, update.themePath);\n  // First in the list, so the harness environment is hydrated before any\n  // extension a user added themselves runs. The filter affects only Pi's\n  // automatic extensions/** scan; explicit settings and CLI entries still load.\n  const extensions = [\n    DOOM_EXTENSION,\n    AMBIENT_EXTENSION_FILTER,\n    ...DISABLED_PI_BUILTINS,\n    ...stringList(current[EXTENSIONS_KEY]).filter((value) => !isManagedExtension(value)),\n  ];\n  const themes = [\n    theme,\n    ...stringList(current[THEMES_KEY]).filter(\n      (value) => value !== theme && !isLegacyDoomTheme(value, update.themeName),\n    ),\n  ];\n  return {\n    ...current,\n    [QUIET_STARTUP_KEY]: true,\n    [EXTENSIONS_KEY]: extensions,\n    [THEMES_KEY]: themes,\n    // Only filled in when unset: a theme the user picked later is their choice,\n    // and re-imposing the Doom theme on every sync would silently undo it.\n    [THEME_KEY]: typeof current[THEME_KEY] === 'string' ? current[THEME_KEY] : update.themeName,\n  };\n}\n\nexport function readPiSettings(agentDirectory: string): JsonObject {\n  const settings = readJson(piSettingsPath(agentDirectory));\n  return isRecord(settings) ? settings : {};\n}\n\nexport function serializePiSettings(settings: JsonObject): string {\n  return `${JSON.stringify(settings, null, 2)}\\n`;\n}\n\n/** Merges the Doom-owned keys into Pi's user settings file. */\nexport function writePiSettings(agentDirectory: string, update: PiSettingsUpdate): string {\n  const settingsPath = piSettingsPath(agentDirectory);\n  writeFileAtomic(\n    settingsPath,\n    serializePiSettings(mergePiSettings(readPiSettings(agentDirectory), agentDirectory, update)),\n  );\n  return settingsPath;\n}\n"],"mappings":"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"}

package/dist/runtimePiSettings.d.mts

@@ -0,0 +1,29 @@
+import { JsonObject } from "./runtimeJson.mjs";
+//#region src/services/piSettings/index.d.ts
+/** The stable package entry Pi loads for every synced repository. */
+export declare const DOOM_EXTENSION = "@agimon-ai/doompi";
+/** Suppresses Pi's ambient extension-directory scan while leaving explicit sources intact. */
+export declare const AMBIENT_EXTENSION_FILTER = "!extensions/**";
+/**
+ * Pi built-in extensions kept off under DoomPi. doompi-mcp owns `/mcp` and MCP servers. Codemode and
+ * tool search are opt-in in plain Pi, but DoomPi activates every registered tool, so leaving them
+ * loaded would declare both to the model in every session.
+ */
+export declare const DISABLED_PI_BUILTINS: readonly string[];
+export interface PiSettingsUpdate {
+  /** Absolute path to the synchronized user theme file. */
+  themePath: string;
+  themeName: string;
+}
+/** Pi's user configuration directory, honoring its documented override. */
+export declare function piAgentDirectory(environment?: NodeJS.ProcessEnv, homeDirectory?: string): string;
+export declare function piSettingsPath(agentDirectory: string): string;
+export declare function piThemeDirectory(agentDirectory: string): string;
+/** Produces the user settings content for an update, without writing it. */
+export declare function mergePiSettings(current: JsonObject, agentDirectory: string, update: PiSettingsUpdate): JsonObject;
+export declare function readPiSettings(agentDirectory: string): JsonObject;
+export declare function serializePiSettings(settings: JsonObject): string;
+/** Merges the Doom-owned keys into Pi's user settings file. */
+export declare function writePiSettings(agentDirectory: string, update: PiSettingsUpdate): string;
+//#endregion
+//# sourceMappingURL=runtimePiSettings.d.mts.map

package/dist/runtimePiSettings.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtimePiSettings.d.mts","names":[],"sources":["../src/services/piSettings/index.ts"],"mappings":";;;qBA4Ba;;qBAEA;;;;;;qBAMA;iBACI;;EAEf;EACA;;;wBAIc,iBACd,cAAa,OAAO,YACpB;wBAWc,eAAe;wBAIf,iBAAiB;;wBA6BjB,gBAAgB,SAAS,YAAY,wBAAwB,QAAQ,mBAAmB;wBA4BxF,eAAe,yBAAyB;wBAKxC,oBAAoB,UAAU;;wBAK9B,gBAAgB,wBAAwB,QAAQ"}

package/dist/runtimePiSettings.mjs

@@ -0,0 +1,103 @@
+import { isRecord, readJson, writeFileAtomic } from "./runtimeJson.mjs";
+import { DOOM_PACKAGE_NAME } from "./doomPackage.mjs";
+import os from "node:os";
+import path from "node:path";
+//#region src/services/piSettings/index.ts
+/**
+* Pi's user settings, as `doompi sync` maintains them.
+*
+* The Doom package is registered globally so a plain `pi` process can find the
+* lightweight package bootstrap before project resources are trusted. Sync owns
+* the extension registration, ambient-discovery filter, theme resource, selected default theme, and quiet-startup keys
+* while preserving every unrelated user setting.
+*/
+const PI_CODING_AGENT_DIR_ENV = "PI_CODING_AGENT_DIR";
+const PI_DIRECTORY = ".pi";
+const AGENT_DIRECTORY = "agent";
+const SETTINGS_FILE = "settings.json";
+const THEMES_DIRECTORY = "themes";
+const EXTENSIONS_KEY = "extensions";
+const THEMES_KEY = "themes";
+const THEME_KEY = "theme";
+const QUIET_STARTUP_KEY = "quietStartup";
+const HOME_ALIAS = "~";
+const HOME_ALIAS_PREFIX = "~/";
+/** The stable package entry Pi loads for every synced repository. */
+const DOOM_EXTENSION = DOOM_PACKAGE_NAME;
+/** Suppresses Pi's ambient extension-directory scan while leaving explicit sources intact. */
+const AMBIENT_EXTENSION_FILTER = "!extensions/**";
+/**
+* Pi built-in extensions kept off under DoomPi. doompi-mcp owns `/mcp` and MCP servers. Codemode and
+* tool search are opt-in in plain Pi, but DoomPi activates every registered tool, so leaving them
+* loaded would declare both to the model in every session.
+*/
+const DISABLED_PI_BUILTINS = [
+	"-builtin:mcp",
+	"-builtin:codemode",
+	"-builtin:tool-search"
+];
+/** Pi's user configuration directory, honoring its documented override. */
+function piAgentDirectory(environment = process.env, homeDirectory = os.homedir()) {
+	const configured = environment[PI_CODING_AGENT_DIR_ENV]?.trim();
+	if (!configured) return path.join(homeDirectory, PI_DIRECTORY, AGENT_DIRECTORY);
+	if (configured === HOME_ALIAS) return homeDirectory;
+	if (configured.startsWith(HOME_ALIAS_PREFIX)) return path.join(homeDirectory, configured.slice(2));
+	return path.resolve(configured);
+}
+function piSettingsPath(agentDirectory) {
+	return path.join(agentDirectory, SETTINGS_FILE);
+}
+function piThemeDirectory(agentDirectory) {
+	return path.join(agentDirectory, THEMES_DIRECTORY);
+}
+function stringList(value) {
+	return Array.isArray(value) ? value.filter((entry) => typeof entry === "string") : [];
+}
+function settingsRelativePath(agentDirectory, target) {
+	const relative = path.relative(agentDirectory, target);
+	if (relative.startsWith("..") || path.isAbsolute(relative)) return target;
+	return relative.split(path.sep).join("/");
+}
+function isManagedExtension(value) {
+	const normalized = value.replaceAll("\\", "/");
+	return normalized === DOOM_EXTENSION || normalized === "!extensions/**" || DISABLED_PI_BUILTINS.includes(normalized);
+}
+function isLegacyDoomTheme(value, themeName) {
+	const normalized = value.replaceAll("\\", "/");
+	return normalized.endsWith(`/doom/${themeName}.json`) || normalized === `doom/${themeName}.json`;
+}
+/** Produces the user settings content for an update, without writing it. */
+function mergePiSettings(current, agentDirectory, update) {
+	const theme = settingsRelativePath(agentDirectory, update.themePath);
+	const extensions = [
+		DOOM_EXTENSION,
+		AMBIENT_EXTENSION_FILTER,
+		...DISABLED_PI_BUILTINS,
+		...stringList(current[EXTENSIONS_KEY]).filter((value) => !isManagedExtension(value))
+	];
+	const themes = [theme, ...stringList(current[THEMES_KEY]).filter((value) => value !== theme && !isLegacyDoomTheme(value, update.themeName))];
+	return {
+		...current,
+		[QUIET_STARTUP_KEY]: true,
+		[EXTENSIONS_KEY]: extensions,
+		[THEMES_KEY]: themes,
+		[THEME_KEY]: typeof current[THEME_KEY] === "string" ? current[THEME_KEY] : update.themeName
+	};
+}
+function readPiSettings(agentDirectory) {
+	const settings = readJson(piSettingsPath(agentDirectory));
+	return isRecord(settings) ? settings : {};
+}
+function serializePiSettings(settings) {
+	return `${JSON.stringify(settings, null, 2)}\n`;
+}
+/** Merges the Doom-owned keys into Pi's user settings file. */
+function writePiSettings(agentDirectory, update) {
+	const settingsPath = piSettingsPath(agentDirectory);
+	writeFileAtomic(settingsPath, serializePiSettings(mergePiSettings(readPiSettings(agentDirectory), agentDirectory, update)));
+	return settingsPath;
+}
+//#endregion
+export { AMBIENT_EXTENSION_FILTER, DISABLED_PI_BUILTINS, DOOM_EXTENSION, mergePiSettings, piAgentDirectory, piSettingsPath, piThemeDirectory, readPiSettings, serializePiSettings, writePiSettings };
+
+//# sourceMappingURL=runtimePiSettings.mjs.map

package/dist/runtimePiSettings.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtimePiSettings.mjs","names":[],"sources":["../src/services/piSettings/index.ts"],"sourcesContent":["import os from 'node:os';\nimport path from 'node:path';\n\nimport { DOOM_PACKAGE_NAME } from '../doomPackage';\nimport { isRecord, readJson, writeFileAtomic } from '../json';\nimport type { JsonObject } from '../json';\n\n/**\n * Pi's user settings, as `doompi sync` maintains them.\n *\n * The Doom package is registered globally so a plain `pi` process can find the\n * lightweight package bootstrap before project resources are trusted. Sync owns\n * the extension registration, ambient-discovery filter, theme resource, selected default theme, and quiet-startup keys\n * while preserving every unrelated user setting.\n */\n\nconst PI_CODING_AGENT_DIR_ENV = 'PI_CODING_AGENT_DIR';\nconst PI_DIRECTORY = '.pi';\nconst AGENT_DIRECTORY = 'agent';\nconst SETTINGS_FILE = 'settings.json';\nconst THEMES_DIRECTORY = 'themes';\nconst EXTENSIONS_KEY = 'extensions';\nconst THEMES_KEY = 'themes';\nconst THEME_KEY = 'theme';\nconst QUIET_STARTUP_KEY = 'quietStartup';\nconst HOME_ALIAS = '~';\nconst HOME_ALIAS_PREFIX = '~/';\n/** The stable package entry Pi loads for every synced repository. */\nexport const DOOM_EXTENSION = DOOM_PACKAGE_NAME;\n/** Suppresses Pi's ambient extension-directory scan while leaving explicit sources intact. */\nexport const AMBIENT_EXTENSION_FILTER = '!extensions/**';\n/**\n * Pi built-in extensions kept off under DoomPi. doompi-mcp owns `/mcp` and MCP servers. Codemode and\n * tool search are opt-in in plain Pi, but DoomPi activates every registered tool, so leaving them\n * loaded would declare both to the model in every session.\n */\nexport const DISABLED_PI_BUILTINS: readonly string[] = ['-builtin:mcp', '-builtin:codemode', '-builtin:tool-search'];\nexport interface PiSettingsUpdate {\n  /** Absolute path to the synchronized user theme file. */\n  themePath: string;\n  themeName: string;\n}\n\n/** Pi's user configuration directory, honoring its documented override. */\nexport function piAgentDirectory(\n  environment: NodeJS.ProcessEnv = process.env,\n  homeDirectory: string = os.homedir(),\n): string {\n  const configured = environment[PI_CODING_AGENT_DIR_ENV]?.trim();\n  if (!configured) return path.join(homeDirectory, PI_DIRECTORY, AGENT_DIRECTORY);\n  if (configured === HOME_ALIAS) return homeDirectory;\n  if (configured.startsWith(HOME_ALIAS_PREFIX)) {\n    return path.join(homeDirectory, configured.slice(HOME_ALIAS_PREFIX.length));\n  }\n  return path.resolve(configured);\n}\n\nexport function piSettingsPath(agentDirectory: string): string {\n  return path.join(agentDirectory, SETTINGS_FILE);\n}\n\nexport function piThemeDirectory(agentDirectory: string): string {\n  return path.join(agentDirectory, THEMES_DIRECTORY);\n}\n\nfunction stringList(value: unknown): string[] {\n  return Array.isArray(value) ? value.filter((entry): entry is string => typeof entry === 'string') : [];\n}\n\nfunction settingsRelativePath(agentDirectory: string, target: string): string {\n  const relative = path.relative(agentDirectory, target);\n  if (relative.startsWith('..') || path.isAbsolute(relative)) return target;\n  return relative.split(path.sep).join('/');\n}\n\nfunction isManagedExtension(value: string): boolean {\n  const normalized = value.replaceAll('\\\\', '/');\n  return (\n    normalized === DOOM_EXTENSION ||\n    normalized === AMBIENT_EXTENSION_FILTER ||\n    DISABLED_PI_BUILTINS.includes(normalized)\n  );\n}\n\nfunction isLegacyDoomTheme(value: string, themeName: string): boolean {\n  const normalized = value.replaceAll('\\\\', '/');\n  return normalized.endsWith(`/doom/${themeName}.json`) || normalized === `doom/${themeName}.json`;\n}\n\n/** Produces the user settings content for an update, without writing it. */\nexport function mergePiSettings(current: JsonObject, agentDirectory: string, update: PiSettingsUpdate): JsonObject {\n  const theme = settingsRelativePath(agentDirectory, update.themePath);\n  // First in the list, so the harness environment is hydrated before any\n  // extension a user added themselves runs. The filter affects only Pi's\n  // automatic extensions/** scan; explicit settings and CLI entries still load.\n  const extensions = [\n    DOOM_EXTENSION,\n    AMBIENT_EXTENSION_FILTER,\n    ...DISABLED_PI_BUILTINS,\n    ...stringList(current[EXTENSIONS_KEY]).filter((value) => !isManagedExtension(value)),\n  ];\n  const themes = [\n    theme,\n    ...stringList(current[THEMES_KEY]).filter(\n      (value) => value !== theme && !isLegacyDoomTheme(value, update.themeName),\n    ),\n  ];\n  return {\n    ...current,\n    [QUIET_STARTUP_KEY]: true,\n    [EXTENSIONS_KEY]: extensions,\n    [THEMES_KEY]: themes,\n    // Only filled in when unset: a theme the user picked later is their choice,\n    // and re-imposing the Doom theme on every sync would silently undo it.\n    [THEME_KEY]: typeof current[THEME_KEY] === 'string' ? current[THEME_KEY] : update.themeName,\n  };\n}\n\nexport function readPiSettings(agentDirectory: string): JsonObject {\n  const settings = readJson(piSettingsPath(agentDirectory));\n  return isRecord(settings) ? settings : {};\n}\n\nexport function serializePiSettings(settings: JsonObject): string {\n  return `${JSON.stringify(settings, null, 2)}\\n`;\n}\n\n/** Merges the Doom-owned keys into Pi's user settings file. */\nexport function writePiSettings(agentDirectory: string, update: PiSettingsUpdate): string {\n  const settingsPath = piSettingsPath(agentDirectory);\n  writeFileAtomic(\n    settingsPath,\n    serializePiSettings(mergePiSettings(readPiSettings(agentDirectory), agentDirectory, update)),\n  );\n  return settingsPath;\n}\n"],"mappings":";;;;;;;;;;;;;AAgBA,MAAM,0BAA0B;AAChC,MAAM,eAAe;AACrB,MAAM,kBAAkB;AACxB,MAAM,gBAAgB;AACtB,MAAM,mBAAmB;AACzB,MAAM,iBAAiB;AACvB,MAAM,aAAa;AACnB,MAAM,YAAY;AAClB,MAAM,oBAAoB;AAC1B,MAAM,aAAa;AACnB,MAAM,oBAAoB;;AAE1B,MAAa,iBAAiB;;AAE9B,MAAa,2BAA2B;;;;;;AAMxC,MAAa,uBAA0C;CAAC;CAAgB;CAAqB;AAAsB;;AAQnH,SAAgB,iBACd,cAAiC,QAAQ,KACzC,gBAAwB,GAAG,QAAQ,GAC3B;CACR,MAAM,aAAa,YAAY,wBAAwB,EAAE,KAAK;CAC9D,IAAI,CAAC,YAAY,OAAO,KAAK,KAAK,eAAe,cAAc,eAAe;CAC9E,IAAI,eAAe,YAAY,OAAO;CACtC,IAAI,WAAW,WAAW,iBAAiB,GACzC,OAAO,KAAK,KAAK,eAAe,WAAW,MAAM,CAAwB,CAAC;CAE5E,OAAO,KAAK,QAAQ,UAAU;AAChC;AAEA,SAAgB,eAAe,gBAAgC;CAC7D,OAAO,KAAK,KAAK,gBAAgB,aAAa;AAChD;AAEA,SAAgB,iBAAiB,gBAAgC;CAC/D,OAAO,KAAK,KAAK,gBAAgB,gBAAgB;AACnD;AAEA,SAAS,WAAW,OAA0B;CAC5C,OAAO,MAAM,QAAQ,KAAK,IAAI,MAAM,QAAQ,UAA2B,OAAO,UAAU,QAAQ,IAAI,CAAC;AACvG;AAEA,SAAS,qBAAqB,gBAAwB,QAAwB;CAC5E,MAAM,WAAW,KAAK,SAAS,gBAAgB,MAAM;CACrD,IAAI,SAAS,WAAW,IAAI,KAAK,KAAK,WAAW,QAAQ,GAAG,OAAO;CACnE,OAAO,SAAS,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,GAAG;AAC1C;AAEA,SAAS,mBAAmB,OAAwB;CAClD,MAAM,aAAa,MAAM,WAAW,MAAM,GAAG;CAC7C,OACE,eAAe,kBACf,eAAA,oBACA,qBAAqB,SAAS,UAAU;AAE5C;AAEA,SAAS,kBAAkB,OAAe,WAA4B;CACpE,MAAM,aAAa,MAAM,WAAW,MAAM,GAAG;CAC7C,OAAO,WAAW,SAAS,SAAS,UAAU,MAAM,KAAK,eAAe,QAAQ,UAAU;AAC5F;;AAGA,SAAgB,gBAAgB,SAAqB,gBAAwB,QAAsC;CACjH,MAAM,QAAQ,qBAAqB,gBAAgB,OAAO,SAAS;CAInE,MAAM,aAAa;EACjB;EACA;EACA,GAAG;EACH,GAAG,WAAW,QAAQ,eAAe,CAAC,CAAC,QAAQ,UAAU,CAAC,mBAAmB,KAAK,CAAC;CACrF;CACA,MAAM,SAAS,CACb,OACA,GAAG,WAAW,QAAQ,WAAW,CAAC,CAAC,QAChC,UAAU,UAAU,SAAS,CAAC,kBAAkB,OAAO,OAAO,SAAS,CAC1E,CACF;CACA,OAAO;EACL,GAAG;GACF,oBAAoB;GACpB,iBAAiB;GACjB,aAAa;GAGb,YAAY,OAAO,QAAQ,eAAe,WAAW,QAAQ,aAAa,OAAO;CACpF;AACF;AAEA,SAAgB,eAAe,gBAAoC;CACjE,MAAM,WAAW,SAAS,eAAe,cAAc,CAAC;CACxD,OAAO,SAAS,QAAQ,IAAI,WAAW,CAAC;AAC1C;AAEA,SAAgB,oBAAoB,UAA8B;CAChE,OAAO,GAAG,KAAK,UAAU,UAAU,MAAM,CAAC,EAAE;AAC9C;;AAGA,SAAgB,gBAAgB,gBAAwB,QAAkC;CACxF,MAAM,eAAe,eAAe,cAAc;CAClD,gBACE,cACA,oBAAoB,gBAAgB,eAAe,cAAc,GAAG,gBAAgB,MAAM,CAAC,CAC7F;CACA,OAAO;AACT"}

package/dist/runtimeProtocol.cjs

@@ -0,0 +1,223 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+let typebox = require("typebox");
+let typebox_value = require("typebox/value");
+//#region src/schemas/protocol.ts
+const DOOM_PROTOCOL_ERROR_CODE = {
+	aborted: "ABORTED",
+	invalidMessage: "INVALID_MESSAGE",
+	providerError: "PROVIDER_ERROR",
+	timeout: "TIMEOUT"
+};
+const DEFAULT_PROTOCOL_TIMEOUT_MS = 5e3;
+const DEFAULT_DUPLICATE_WINDOW = 256;
+const ProtocolErrorSchema = typebox.Type.Object({
+	code: typebox.Type.String({ minLength: 1 }),
+	message: typebox.Type.String({ minLength: 1 }),
+	retryable: typebox.Type.Optional(typebox.Type.Boolean())
+}, { additionalProperties: false });
+var DoomProtocolError = class extends Error {
+	code;
+	retryable;
+	constructor(payload) {
+		super(payload.message);
+		this.name = "DoomProtocolError";
+		this.code = payload.code;
+		this.retryable = payload.retryable ?? false;
+	}
+};
+var DoomProtocolValidationError = class extends DoomProtocolError {
+	constructor(channel, details) {
+		super({
+			code: DOOM_PROTOCOL_ERROR_CODE.invalidMessage,
+			message: `Invalid message on ${channel}: ${details}`
+		});
+		this.name = "DoomProtocolValidationError";
+	}
+};
+const EnvelopeBaseSchema = typebox.Type.Object({
+	protocol: typebox.Type.String({ minLength: 1 }),
+	version: typebox.Type.Literal(1),
+	kind: typebox.Type.String({ minLength: 1 }),
+	messageId: typebox.Type.String({ minLength: 1 }),
+	correlationId: typebox.Type.Optional(typebox.Type.String({ minLength: 1 })),
+	source: typebox.Type.String({ minLength: 1 }),
+	sessionId: typebox.Type.String({ minLength: 1 })
+}, { additionalProperties: false });
+function envelopeSchema(payload) {
+	return typebox.Type.Object({
+		...EnvelopeBaseSchema.properties,
+		payload
+	}, { additionalProperties: false });
+}
+function protocolName(channel) {
+	const match = /^(doom:[^:]+(?::[^:]+)*):v\d+:/.exec(channel);
+	if (!match) throw new Error(`Invalid Doom protocol channel: ${channel}`);
+	return match[1];
+}
+function validationDetails(schema, value) {
+	return (0, typebox_value.Errors)(schema, value).slice(0, 3).map((error) => `${error.instancePath || "/"} ${error.message}`).join("; ");
+}
+function assertValid(channel, schema, value) {
+	if (!(0, typebox_value.Check)(schema, value)) throw new DoomProtocolValidationError(channel, validationDetails(schema, value));
+}
+function asProtocolError(error) {
+	if (error instanceof DoomProtocolError) return {
+		code: error.code,
+		message: error.message,
+		retryable: error.retryable
+	};
+	return {
+		code: DOOM_PROTOCOL_ERROR_CODE.providerError,
+		message: error instanceof Error ? error.message : String(error)
+	};
+}
+function defineNotification(definition) {
+	protocolName(definition.channel);
+	return definition;
+}
+function defineRequestReply(definition) {
+	const protocol = protocolName(definition.channels.request);
+	for (const channel of [definition.channels.response, definition.channels.error]) if (protocolName(channel) !== protocol) throw new Error("Request/reply channels must share one protocol");
+	return {
+		requestChannel: definition.channels.request,
+		responseChannel: definition.channels.response,
+		errorChannel: definition.channels.error,
+		requestKind: definition.kinds.request,
+		responseKind: definition.kinds.response,
+		request: definition.request,
+		response: definition.response
+	};
+}
+const defineJob = defineRequestReply;
+function createProtocolRuntime(options) {
+	const timeoutDefault = options.defaultTimeoutMs ?? DEFAULT_PROTOCOL_TIMEOUT_MS;
+	const duplicateWindow = options.duplicateWindow ?? DEFAULT_DUPLICATE_WINDOW;
+	const createMessageId = options.createMessageId ?? (() => `${options.source}:${crypto.randomUUID()}`);
+	const rethrowAsync = (error) => {
+		queueMicrotask(() => {
+			throw error instanceof Error ? error : new Error(String(error));
+		});
+	};
+	function duplicateGuard() {
+		const handled = /* @__PURE__ */ new Set();
+		return (messageId) => {
+			if (handled.has(messageId)) return false;
+			handled.add(messageId);
+			if (handled.size > duplicateWindow) handled.delete(handled.values().next().value);
+			return true;
+		};
+	}
+	function base(channel, kind, messageId = createMessageId(), correlationId) {
+		return {
+			protocol: protocolName(channel),
+			version: 1,
+			kind,
+			messageId,
+			...correlationId ? { correlationId } : {},
+			source: options.source,
+			sessionId: options.sessionId
+		};
+	}
+	return {
+		notify(definition, payload) {
+			assertValid(definition.channel, definition.payload, payload);
+			options.bus.emit(definition.channel, {
+				...base(definition.channel, definition.kind),
+				payload
+			});
+		},
+		onNotification(definition, handler) {
+			const schema = envelopeSchema(definition.payload);
+			const remember = duplicateGuard();
+			return options.bus.on(definition.channel, (message) => {
+				assertValid(definition.channel, schema, message);
+				const envelope = message;
+				if (envelope.sessionId !== options.sessionId) return;
+				if (!remember(envelope.messageId)) return;
+				Promise.resolve(handler(envelope.payload, envelope)).catch(rethrowAsync);
+			});
+		},
+		request(definition, payload, requestOptions = {}) {
+			assertValid(definition.requestChannel, definition.request, payload);
+			const messageId = createMessageId();
+			const responseSchema = envelopeSchema(definition.response);
+			const errorSchema = envelopeSchema(ProtocolErrorSchema);
+			return new Promise((resolve, reject) => {
+				let settled = false;
+				const cleanups = [];
+				const finish = (action) => {
+					if (settled) return;
+					settled = true;
+					for (const cleanup of cleanups.splice(0)) cleanup();
+					action();
+				};
+				cleanups.push(options.bus.on(definition.responseChannel, (message) => {
+					assertValid(definition.responseChannel, responseSchema, message);
+					const envelope = message;
+					if (envelope.sessionId !== options.sessionId) return;
+					if (envelope.correlationId !== messageId) return;
+					if (requestOptions.expectedSource && envelope.source !== requestOptions.expectedSource) return;
+					finish(() => resolve(envelope.payload));
+				}), options.bus.on(definition.errorChannel, (message) => {
+					assertValid(definition.errorChannel, errorSchema, message);
+					const envelope = message;
+					if (envelope.sessionId !== options.sessionId) return;
+					if (envelope.correlationId !== messageId) return;
+					if (requestOptions.expectedSource && envelope.source !== requestOptions.expectedSource) return;
+					finish(() => reject(new DoomProtocolError(envelope.payload)));
+				}));
+				const timer = setTimeout(() => finish(() => reject(new DoomProtocolError({
+					code: DOOM_PROTOCOL_ERROR_CODE.timeout,
+					message: `Timed out waiting for ${definition.responseKind}`
+				}))), requestOptions.timeoutMs ?? timeoutDefault);
+				cleanups.push(() => clearTimeout(timer));
+				if (requestOptions.signal) {
+					const abort = () => finish(() => reject(new DoomProtocolError({
+						code: DOOM_PROTOCOL_ERROR_CODE.aborted,
+						message: "Request aborted"
+					})));
+					requestOptions.signal.addEventListener("abort", abort, { once: true });
+					cleanups.push(() => requestOptions.signal?.removeEventListener("abort", abort));
+					if (requestOptions.signal.aborted) return abort();
+				}
+				options.bus.emit(definition.requestChannel, {
+					...base(definition.requestChannel, definition.requestKind, messageId),
+					payload
+				});
+			});
+		},
+		provide(definition, handler) {
+			const requestSchema = envelopeSchema(definition.request);
+			const remember = duplicateGuard();
+			return options.bus.on(definition.requestChannel, (message) => {
+				assertValid(definition.requestChannel, requestSchema, message);
+				const envelope = message;
+				if (envelope.sessionId !== options.sessionId) return;
+				if (!remember(envelope.messageId)) return;
+				Promise.resolve().then(() => handler(envelope.payload, envelope)).then((payload) => {
+					assertValid(definition.responseChannel, definition.response, payload);
+					options.bus.emit(definition.responseChannel, {
+						...base(definition.responseChannel, definition.responseKind, createMessageId(), envelope.messageId),
+						payload
+					});
+				}, (error) => {
+					options.bus.emit(definition.errorChannel, {
+						...base(definition.errorChannel, "error", createMessageId(), envelope.messageId),
+						payload: asProtocolError(error)
+					});
+				});
+			});
+		}
+	};
+}
+//#endregion
+exports.DOOM_PROTOCOL_ERROR_CODE = DOOM_PROTOCOL_ERROR_CODE;
+exports.DoomProtocolError = DoomProtocolError;
+exports.DoomProtocolValidationError = DoomProtocolValidationError;
+exports.ProtocolErrorSchema = ProtocolErrorSchema;
+exports.createProtocolRuntime = createProtocolRuntime;
+exports.defineJob = defineJob;
+exports.defineNotification = defineNotification;
+exports.defineRequestReply = defineRequestReply;
+
+//# sourceMappingURL=runtimeProtocol.cjs.map

package/dist/runtimeProtocol.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtimeProtocol.cjs","names":["Type","Errors","Check"],"sources":["../src/schemas/protocol.ts"],"sourcesContent":["import { type Static, type TSchema, Type } from 'typebox';\nimport { Check, Errors } from 'typebox/value';\n\nexport const DOOM_PROTOCOL_ERROR_CODE = {\n  aborted: 'ABORTED',\n  invalidMessage: 'INVALID_MESSAGE',\n  providerError: 'PROVIDER_ERROR',\n  timeout: 'TIMEOUT',\n} as const;\n\nconst DEFAULT_PROTOCOL_TIMEOUT_MS = 5_000;\nconst DEFAULT_DUPLICATE_WINDOW = 256;\n\nexport interface EventBusLike {\n  emit(event: string, data: unknown): void;\n  on(event: string, handler: (data: unknown) => void): () => void;\n}\n\nexport const ProtocolErrorSchema = Type.Object(\n  {\n    code: Type.String({ minLength: 1 }),\n    message: Type.String({ minLength: 1 }),\n    retryable: Type.Optional(Type.Boolean()),\n  },\n  { additionalProperties: false },\n);\n\nexport type ProtocolErrorPayload = Static<typeof ProtocolErrorSchema>;\n\nexport class DoomProtocolError extends Error {\n  readonly code: string;\n  readonly retryable: boolean;\n\n  constructor(payload: ProtocolErrorPayload) {\n    super(payload.message);\n    this.name = 'DoomProtocolError';\n    this.code = payload.code;\n    this.retryable = payload.retryable ?? false;\n  }\n}\n\nexport class DoomProtocolValidationError extends DoomProtocolError {\n  constructor(channel: string, details: string) {\n    super({ code: DOOM_PROTOCOL_ERROR_CODE.invalidMessage, message: `Invalid message on ${channel}: ${details}` });\n    this.name = 'DoomProtocolValidationError';\n  }\n}\n\nexport interface ProtocolIdentity {\n  source: string;\n  sessionId: string;\n}\n\ninterface ProtocolEnvelope<TPayload> extends ProtocolIdentity {\n  protocol: string;\n  version: 1;\n  kind: string;\n  messageId: string;\n  correlationId?: string;\n  payload: TPayload;\n}\n\nexport interface NotificationDefinition<TPayload extends TSchema> {\n  channel: string;\n  kind: string;\n  payload: TPayload;\n}\n\nexport interface RequestReplyDefinition<TRequest extends TSchema, TResponse extends TSchema> {\n  requestChannel: string;\n  responseChannel: string;\n  errorChannel: string;\n  requestKind: string;\n  responseKind: string;\n  request: TRequest;\n  response: TResponse;\n}\n\nexport interface RequestOptions {\n  signal?: AbortSignal;\n  timeoutMs?: number;\n  /** Ignore correlated replies from any source except this exact provider. */\n  expectedSource?: string;\n}\n\nexport interface ProtocolRuntimeOptions extends ProtocolIdentity {\n  bus: EventBusLike;\n  defaultTimeoutMs?: number;\n  createMessageId?: () => string;\n  duplicateWindow?: number;\n}\n\nexport interface ProtocolRuntime {\n  notify<TPayload extends TSchema>(definition: NotificationDefinition<TPayload>, payload: Static<TPayload>): void;\n  onNotification<TPayload extends TSchema>(\n    definition: NotificationDefinition<TPayload>,\n    handler: (payload: Static<TPayload>, identity: ProtocolIdentity) => void | Promise<void>,\n  ): () => void;\n  request<TRequest extends TSchema, TResponse extends TSchema>(\n    definition: RequestReplyDefinition<TRequest, TResponse>,\n    payload: Static<TRequest>,\n    options?: RequestOptions,\n  ): Promise<Static<TResponse>>;\n  provide<TRequest extends TSchema, TResponse extends TSchema>(\n    definition: RequestReplyDefinition<TRequest, TResponse>,\n    handler: (payload: Static<TRequest>, identity: ProtocolIdentity) => Static<TResponse> | Promise<Static<TResponse>>,\n  ): () => void;\n}\n\nconst EnvelopeBaseSchema = Type.Object(\n  {\n    protocol: Type.String({ minLength: 1 }),\n    version: Type.Literal(1),\n    kind: Type.String({ minLength: 1 }),\n    messageId: Type.String({ minLength: 1 }),\n    correlationId: Type.Optional(Type.String({ minLength: 1 })),\n    source: Type.String({ minLength: 1 }),\n    sessionId: Type.String({ minLength: 1 }),\n  },\n  { additionalProperties: false },\n);\n\nfunction envelopeSchema<TPayload extends TSchema>(payload: TPayload) {\n  return Type.Object({ ...EnvelopeBaseSchema.properties, payload }, { additionalProperties: false });\n}\n\nfunction protocolName(channel: string): string {\n  const match = /^(doom:[^:]+(?::[^:]+)*):v\\d+:/.exec(channel);\n  if (!match) throw new Error(`Invalid Doom protocol channel: ${channel}`);\n  return match[1];\n}\n\nfunction validationDetails(schema: TSchema, value: unknown): string {\n  return Errors(schema, value)\n    .slice(0, 3)\n    .map((error) => `${error.instancePath || '/'} ${error.message}`)\n    .join('; ');\n}\n\nfunction assertValid<TSchemaValue extends TSchema>(\n  channel: string,\n  schema: TSchemaValue,\n  value: unknown,\n): asserts value is Static<TSchemaValue> {\n  if (!Check(schema, value)) throw new DoomProtocolValidationError(channel, validationDetails(schema, value));\n}\n\nfunction asProtocolError(error: unknown): ProtocolErrorPayload {\n  if (error instanceof DoomProtocolError) {\n    return { code: error.code, message: error.message, retryable: error.retryable };\n  }\n  return {\n    code: DOOM_PROTOCOL_ERROR_CODE.providerError,\n    message: error instanceof Error ? error.message : String(error),\n  };\n}\n\nexport function defineNotification<TPayload extends TSchema>(definition: {\n  channel: `doom:${string}:${string}:v1:${string}`;\n  kind: string;\n  payload: TPayload;\n}): NotificationDefinition<TPayload> {\n  protocolName(definition.channel);\n  return definition;\n}\n\nexport function defineRequestReply<TRequest extends TSchema, TResponse extends TSchema>(definition: {\n  channels: {\n    request: `doom:${string}:${string}:v1:${string}`;\n    response: `doom:${string}:${string}:v1:${string}`;\n    error: `doom:${string}:${string}:v1:${string}`;\n  };\n  kinds: { request: string; response: string };\n  request: TRequest;\n  response: TResponse;\n}): RequestReplyDefinition<TRequest, TResponse> {\n  const protocol = protocolName(definition.channels.request);\n  for (const channel of [definition.channels.response, definition.channels.error]) {\n    if (protocolName(channel) !== protocol) throw new Error('Request/reply channels must share one protocol');\n  }\n  return {\n    requestChannel: definition.channels.request,\n    responseChannel: definition.channels.response,\n    errorChannel: definition.channels.error,\n    requestKind: definition.kinds.request,\n    responseKind: definition.kinds.response,\n    request: definition.request,\n    response: definition.response,\n  };\n}\n\nexport const defineJob = defineRequestReply;\n\nexport function createProtocolRuntime(options: ProtocolRuntimeOptions): ProtocolRuntime {\n  const timeoutDefault = options.defaultTimeoutMs ?? DEFAULT_PROTOCOL_TIMEOUT_MS;\n  const duplicateWindow = options.duplicateWindow ?? DEFAULT_DUPLICATE_WINDOW;\n  const createMessageId = options.createMessageId ?? (() => `${options.source}:${crypto.randomUUID()}`);\n\n  const rethrowAsync = (error: unknown): void => {\n    queueMicrotask(() => {\n      throw error instanceof Error ? error : new Error(String(error));\n    });\n  };\n\n  function duplicateGuard(): (messageId: string) => boolean {\n    const handled = new Set<string>();\n    return (messageId) => {\n      if (handled.has(messageId)) return false;\n      handled.add(messageId);\n      if (handled.size > duplicateWindow) handled.delete(handled.values().next().value as string);\n      return true;\n    };\n  }\n\n  function base(channel: string, kind: string, messageId = createMessageId(), correlationId?: string) {\n    return {\n      protocol: protocolName(channel),\n      version: 1 as const,\n      kind,\n      messageId,\n      ...(correlationId ? { correlationId } : {}),\n      source: options.source,\n      sessionId: options.sessionId,\n    };\n  }\n\n  return {\n    notify<TPayload extends TSchema>(definition: NotificationDefinition<TPayload>, payload: Static<TPayload>) {\n      assertValid(definition.channel, definition.payload, payload);\n      options.bus.emit(definition.channel, { ...base(definition.channel, definition.kind), payload });\n    },\n\n    onNotification<TPayload extends TSchema>(\n      definition: NotificationDefinition<TPayload>,\n      handler: (payload: Static<TPayload>, identity: ProtocolIdentity) => void | Promise<void>,\n    ) {\n      const schema = envelopeSchema(definition.payload);\n      const remember = duplicateGuard();\n      return options.bus.on(definition.channel, (message) => {\n        assertValid(definition.channel, schema, message);\n        const envelope = message as unknown as ProtocolEnvelope<Static<TPayload>>;\n        if (envelope.sessionId !== options.sessionId) return;\n        if (!remember(envelope.messageId)) return;\n        void Promise.resolve(handler(envelope.payload, envelope)).catch(rethrowAsync);\n      });\n    },\n\n    request<TRequest extends TSchema, TResponse extends TSchema>(\n      definition: RequestReplyDefinition<TRequest, TResponse>,\n      payload: Static<TRequest>,\n      requestOptions: RequestOptions = {},\n    ) {\n      assertValid(definition.requestChannel, definition.request, payload);\n      const messageId = createMessageId();\n      const responseSchema = envelopeSchema(definition.response);\n      const errorSchema = envelopeSchema(ProtocolErrorSchema);\n      return new Promise<Static<typeof definition.response>>((resolve, reject) => {\n        let settled = false;\n        const cleanups: Array<() => void> = [];\n        const finish = (action: () => void) => {\n          if (settled) return;\n          settled = true;\n          for (const cleanup of cleanups.splice(0)) cleanup();\n          action();\n        };\n        cleanups.push(\n          options.bus.on(definition.responseChannel, (message) => {\n            assertValid(definition.responseChannel, responseSchema, message);\n            const envelope = message as unknown as ProtocolEnvelope<Static<TResponse>>;\n            if (envelope.sessionId !== options.sessionId) return;\n            if (envelope.correlationId !== messageId) return;\n            if (requestOptions.expectedSource && envelope.source !== requestOptions.expectedSource) return;\n            finish(() => resolve(envelope.payload));\n          }),\n          options.bus.on(definition.errorChannel, (message) => {\n            assertValid(definition.errorChannel, errorSchema, message);\n            const envelope = message as unknown as ProtocolEnvelope<ProtocolErrorPayload>;\n            if (envelope.sessionId !== options.sessionId) return;\n            if (envelope.correlationId !== messageId) return;\n            if (requestOptions.expectedSource && envelope.source !== requestOptions.expectedSource) return;\n            finish(() => reject(new DoomProtocolError(envelope.payload)));\n          }),\n        );\n        const timer = setTimeout(\n          () =>\n            finish(() =>\n              reject(\n                new DoomProtocolError({\n                  code: DOOM_PROTOCOL_ERROR_CODE.timeout,\n                  message: `Timed out waiting for ${definition.responseKind}`,\n                }),\n              ),\n            ),\n          requestOptions.timeoutMs ?? timeoutDefault,\n        );\n        cleanups.push(() => clearTimeout(timer));\n        if (requestOptions.signal) {\n          const abort = () =>\n            finish(() =>\n              reject(new DoomProtocolError({ code: DOOM_PROTOCOL_ERROR_CODE.aborted, message: 'Request aborted' })),\n            );\n          requestOptions.signal.addEventListener('abort', abort, { once: true });\n          cleanups.push(() => requestOptions.signal?.removeEventListener('abort', abort));\n          if (requestOptions.signal.aborted) return abort();\n        }\n        options.bus.emit(definition.requestChannel, {\n          ...base(definition.requestChannel, definition.requestKind, messageId),\n          payload,\n        });\n      });\n    },\n\n    provide<TRequest extends TSchema, TResponse extends TSchema>(\n      definition: RequestReplyDefinition<TRequest, TResponse>,\n      handler: (\n        payload: Static<TRequest>,\n        identity: ProtocolIdentity,\n      ) => Static<TResponse> | Promise<Static<TResponse>>,\n    ) {\n      const requestSchema = envelopeSchema(definition.request);\n      const remember = duplicateGuard();\n      return options.bus.on(definition.requestChannel, (message) => {\n        assertValid(definition.requestChannel, requestSchema, message);\n        const envelope = message as unknown as ProtocolEnvelope<Static<TRequest>>;\n        if (envelope.sessionId !== options.sessionId) return;\n        if (!remember(envelope.messageId)) return;\n        void Promise.resolve()\n          .then(() => handler(envelope.payload, envelope))\n          .then(\n            (payload) => {\n              assertValid(definition.responseChannel, definition.response, payload);\n              options.bus.emit(definition.responseChannel, {\n                ...base(definition.responseChannel, definition.responseKind, createMessageId(), envelope.messageId),\n                payload,\n              });\n            },\n            (error) => {\n              options.bus.emit(definition.errorChannel, {\n                ...base(definition.errorChannel, 'error', createMessageId(), envelope.messageId),\n                payload: asProtocolError(error),\n              });\n            },\n          );\n      });\n    },\n  };\n}\n"],"mappings":"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"}

package/dist/runtimeProtocol.d.mts

@@ -0,0 +1,84 @@
+import { Static, TSchema, Type } from "typebox";
+//#region src/schemas/protocol.d.ts
+export declare const DOOM_PROTOCOL_ERROR_CODE: {
+  readonly aborted: 'ABORTED';
+  readonly invalidMessage: 'INVALID_MESSAGE';
+  readonly providerError: 'PROVIDER_ERROR';
+  readonly timeout: 'TIMEOUT';
+};
+export interface EventBusLike {
+  emit(event: string, data: unknown): void;
+  on(event: string, handler: (data: unknown) => void): () => void;
+}
+export declare const ProtocolErrorSchema: Type.TObject<{
+  code: Type.TString;
+  message: Type.TString;
+  retryable: Type.TOptional<Type.TBoolean>;
+}>;
+export type ProtocolErrorPayload = Static<typeof ProtocolErrorSchema>;
+export declare class DoomProtocolError extends Error {
+  readonly code: string;
+  readonly retryable: boolean;
+  constructor(payload: ProtocolErrorPayload);
+}
+export declare class DoomProtocolValidationError extends DoomProtocolError {
+  constructor(channel: string, details: string);
+}
+export interface ProtocolIdentity {
+  source: string;
+  sessionId: string;
+}
+export interface NotificationDefinition<TPayload extends TSchema> {
+  channel: string;
+  kind: string;
+  payload: TPayload;
+}
+export interface RequestReplyDefinition<TRequest extends TSchema, TResponse extends TSchema> {
+  requestChannel: string;
+  responseChannel: string;
+  errorChannel: string;
+  requestKind: string;
+  responseKind: string;
+  request: TRequest;
+  response: TResponse;
+}
+export interface RequestOptions {
+  signal?: AbortSignal;
+  timeoutMs?: number;
+  /** Ignore correlated replies from any source except this exact provider. */
+  expectedSource?: string;
+}
+export interface ProtocolRuntimeOptions extends ProtocolIdentity {
+  bus: EventBusLike;
+  defaultTimeoutMs?: number;
+  createMessageId?: () => string;
+  duplicateWindow?: number;
+}
+export interface ProtocolRuntime {
+  notify<TPayload extends TSchema>(definition: NotificationDefinition<TPayload>, payload: Static<TPayload>): void;
+  onNotification<TPayload extends TSchema>(definition: NotificationDefinition<TPayload>, handler: (payload: Static<TPayload>, identity: ProtocolIdentity) => void | Promise<void>): () => void;
+  request<TRequest extends TSchema, TResponse extends TSchema>(definition: RequestReplyDefinition<TRequest, TResponse>, payload: Static<TRequest>, options?: RequestOptions): Promise<Static<TResponse>>;
+  provide<TRequest extends TSchema, TResponse extends TSchema>(definition: RequestReplyDefinition<TRequest, TResponse>, handler: (payload: Static<TRequest>, identity: ProtocolIdentity) => Static<TResponse> | Promise<Static<TResponse>>): () => void;
+}
+export declare function defineNotification<TPayload extends TSchema>(definition: {
+  channel: `doom:${string}:${string}:v1:${string}`;
+  kind: string;
+  payload: TPayload;
+}): NotificationDefinition<TPayload>;
+export declare function defineRequestReply<TRequest extends TSchema, TResponse extends TSchema>(definition: {
+  channels: {
+    request: `doom:${string}:${string}:v1:${string}`;
+    response: `doom:${string}:${string}:v1:${string}`;
+    error: `doom:${string}:${string}:v1:${string}`;
+  };
+  kinds: {
+    request: string;
+    response: string;
+  };
+  request: TRequest;
+  response: TResponse;
+}): RequestReplyDefinition<TRequest, TResponse>;
+export declare const defineJob: typeof defineRequestReply;
+export declare function createProtocolRuntime(options: ProtocolRuntimeOptions): ProtocolRuntime;
+//#endregion
+//# sourceMappingURL=runtimeProtocol.d.mts.map

package/dist/runtimeProtocol.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtimeProtocol.d.mts","names":[],"sources":["../src/schemas/protocol.ts"],"mappings":";;qBAGa;WACX;WACA;WACA;WACA;;iBAMe;EACf,KAAK,eAAe;EACpB,GAAG,eAAe,UAAU;;qBAGjB,qBAAmB,KAAA;;;;;YASpB,uBAAuB,cAAc;qBAEpC,0BAA0B;WAC5B;WACA;EAET,YAAY,SAAS;;qBAQV,oCAAoC;EAC/C,YAAY,iBAAiB;;iBAMd;EACf;EACA;;iBAYe,uBAAuB,iBAAiB;EACvD;EACA;EACA,SAAS;;iBAGM,uBAAuB,iBAAiB,SAAS,kBAAkB;EAClF;EACA;EACA;EACA;EACA;EACA,SAAS;EACT,UAAU;;iBAGK;EACf,SAAS;EACT;;EAEA;;iBAGe,+BAA+B;EAC9C,KAAK;EACL;EACA;EACA;;iBAGe;EACf,OAAO,iBAAiB,SAAS,YAAY,uBAAuB,WAAW,SAAS,OAAO;EAC/F,eAAe,iBAAiB,SAC9B,YAAY,uBAAuB,WACnC,UAAU,SAAS,OAAO,WAAW,UAAU,4BAA4B;EAE7E,QAAQ,iBAAiB,SAAS,kBAAkB,SAClD,YAAY,uBAAuB,UAAU,YAC7C,SAAS,OAAO,WAChB,UAAU,iBACT,QAAQ,OAAO;EAClB,QAAQ,iBAAiB,SAAS,kBAAkB,SAClD,YAAY,uBAAuB,UAAU,YAC7C,UAAU,SAAS,OAAO,WAAW,UAAU,qBAAqB,OAAO,aAAa,QAAQ,OAAO;;wBAoD3F,mBAAmB,iBAAiB,SAAS;EAC3D;EACA;EACA,SAAS;IACP,uBAAuB;wBAKX,mBAAmB,iBAAiB,SAAS,kBAAkB,SAAS;EACtF;IACE;IACA;IACA;;EAEF;IAAS;IAAiB;;EAC1B,SAAS;EACT,UAAU;IACR,uBAAuB,UAAU;qBAgBxB,kBAAS;wBAEN,sBAAsB,SAAS,yBAAyB"}