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

package/dist/runtimePiSettings.mjs

@@ -1,241 +1,3 @@
-import { DOOM_PACKAGE_NAME } from "./doomPackage.mjs";
-import { isRecord, readJson, writeFileAtomic } from "./runtimeJson.mjs";
-import fs from "node:fs";
-import os from "node:os";
-import path from "node:path";
-//#region src/services/piSettings/index.ts
-/**
-* Pi's user settings, as `po 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";
-/** Moves Po's whole home, agent directory included, away from `~/.po`. */
-const PO_HOME_ENV = "PO_HOME";
-const PO_HOME_DIRECTORY = ".po";
-/** Plain Pi's home, whose agent directory Po falls back to for model config. */
-const PI_HOME_DIRECTORY = ".pi";
-const AGENT_DIRECTORY = "agent";
-const RUNTIME_DIRECTORY = "runtime";
-const SETTINGS_FILE = "settings.json";
-const AUTH_FILE = "auth.json";
-const MODELS_FILE = "models.json";
-const THEMES_DIRECTORY = "themes";
-const EXTENSIONS_KEY = "extensions";
-const THEMES_KEY = "themes";
-const THEME_KEY = "theme";
-const QUIET_STARTUP_KEY = "quietStartup";
-const PO_THEME_NAME = "po-dark";
-const PO_THEME_FILE = `${PO_THEME_NAME}.json`;
-const PACKAGE_MANIFEST = "package.json";
-const AGIMON_SCOPE_PREFIX = "@agimon-ai/";
-const NPM_SOURCE_PREFIX = "npm:";
-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 Po. po-mcp owns `/mcp` and MCP servers. Codemode and
-* tool search are opt-in in plain Pi, but Po 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"
-];
-/** Ownership marker `po init` wrote into the dispatcher package manifest. */
-const PO_DISPATCHER_MARKER = 1;
-/**
-* Expands `~` and resolves a relative path against home, never the cwd, so every
-* Po process lands on the same directory wherever it was started.
-*/
-function resolveConfiguredDirectory(configured, homeDirectory) {
-	if (configured === HOME_ALIAS) return homeDirectory;
-	if (configured.startsWith(HOME_ALIAS_PREFIX)) return path.join(homeDirectory, configured.slice(2));
-	return path.resolve(homeDirectory, configured);
-}
-/**
-* Po's home: config, workspaces, runtime registry and its Pi agent directory.
-* Defaults to `~/.po`; `PO_HOME` moves all of it.
-*/
-function poHomeDirectory(homeDirectory = os.homedir(), environment = process.env) {
-	const configured = environment[PO_HOME_ENV]?.trim();
-	return configured ? resolveConfiguredDirectory(configured, homeDirectory) : path.join(homeDirectory, PO_HOME_DIRECTORY);
-}
-/**
-* The single install root for runtime packages every Po root shares: its
-* `package.json` declares them and its `node_modules` holds them.
-*/
-function poRuntimeDirectory(homeDirectory = os.homedir(), environment = process.env) {
-	return path.join(poHomeDirectory(homeDirectory, environment), RUNTIME_DIRECTORY);
-}
-/**
-* True when a directory's `.po` folder exists and is a repository's own configuration.
-*
-* Po's home is `~/.po`, so the home directory carries a `.po` folder too. That folder is
-* the global layer, not a repository marker: walking up from any path under home must not
-* stop at home and treat the global configuration as repository configuration.
-*/
-function hasRepositoryDoomDirectory(directory, homeDirectory = os.homedir(), environment = process.env) {
-	const marker = path.resolve(directory, PO_HOME_DIRECTORY);
-	if (marker === path.resolve(poHomeDirectory(homeDirectory, environment))) return false;
-	try {
-		return fs.statSync(marker).isDirectory();
-	} catch {
-		return false;
-	}
-}
-/**
-* The Pi agent directory Po runs with. Honors Pi's documented override; every Po
-* entry point sets that override, so the default only applies to library callers.
-*/
-function piAgentDirectory(environment = process.env, homeDirectory = os.homedir()) {
-	const configured = environment[PI_CODING_AGENT_DIR_ENV]?.trim();
-	if (!configured) return path.join(poHomeDirectory(homeDirectory, environment), AGENT_DIRECTORY);
-	return resolveConfiguredDirectory(configured, homeDirectory);
-}
-/** True when the directory names a model: credentials, a custom provider, or a default. */
-function hasModelConfig(agentDirectory) {
-	try {
-		return fs.existsSync(path.join(agentDirectory, MODELS_FILE)) || Object.keys(readJson(path.join(agentDirectory, AUTH_FILE))).length > 0 || typeof readJson(piSettingsPath(agentDirectory)).defaultProvider === "string";
-	} catch {
-		return true;
-	}
-}
-/**
-* Where Po reads auth.json and models.json from. Po's own agent
-* directory when it names a model; otherwise plain Pi's `~/.pi/agent`, so a user who
-* already set Pi up can start a session before configuring Po.
-*/
-function modelConfigDirectory(agentDirectory, homeDirectory = os.homedir()) {
-	if (hasModelConfig(agentDirectory)) return agentDirectory;
-	const pi = path.join(homeDirectory, PI_HOME_DIRECTORY, AGENT_DIRECTORY);
-	return pi !== agentDirectory && hasModelConfig(pi) ? pi : agentDirectory;
-}
-/** Model defaults fall back independently of credentials, only when settings.json is absent. */
-function modelSettingsDirectory(agentDirectory, homeDirectory = os.homedir()) {
-	if (fs.existsSync(piSettingsPath(agentDirectory))) return agentDirectory;
-	const pi = path.join(homeDirectory, PI_HOME_DIRECTORY, AGENT_DIRECTORY);
-	return fs.existsSync(piSettingsPath(pi)) ? pi : agentDirectory;
-}
-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;
-}
-/** Whether a directory is the dispatcher package `po init` generated, by its manifest ownership marker. */
-function isPoDispatcherPackage(directory) {
-	try {
-		const parsed = JSON.parse(fs.readFileSync(path.join(directory, PACKAGE_MANIFEST), "utf8"));
-		return parsed.name === "@agimon-ai/po" && parsed.poDispatcher === 1;
-	} catch {
-		return false;
-	}
-}
-function poDispatcherDirectory(agentDirectory) {
-	const directory = path.join(agentDirectory, ...DOOM_PACKAGE_NAME.split("/"));
-	return fs.lstatSync(directory, { throwIfNoEntry: false })?.isDirectory() && isPoDispatcherPackage(directory) ? directory : void 0;
-}
-function isOtherAgimonDistribution(value) {
-	const normalized = value.startsWith(NPM_SOURCE_PREFIX) ? value.slice(4) : value;
-	return normalized.startsWith(AGIMON_SCOPE_PREFIX) && normalized !== DOOM_EXTENSION;
-}
-function isSharedFilter(value) {
-	return value === "!extensions/**" || DISABLED_PI_BUILTINS.includes(value);
-}
-/**
-* Removes the entries `po init` and older `po sync` runs added to Pi's user agent directory.
-*
-* The shared ambient and built-in filters stay while another `@agimon-ai/*` distribution (doompi)
-* is still registered, because it relies on the same filters. Unrelated settings are preserved,
-* and nothing is written when no Po entry is present. Returns the paths and entries it removed.
-*/
-function removePoPiSettings(agentDirectory) {
-	const removed = [];
-	const settingsPath = piSettingsPath(agentDirectory);
-	const themePath = path.join(piThemeDirectory(agentDirectory), PO_THEME_FILE);
-	const current = readPiSettings(agentDirectory);
-	const extensions = stringList(current[EXTENSIONS_KEY]);
-	const themes = stringList(current[THEMES_KEY]);
-	const isPoTheme = (value) => path.resolve(agentDirectory, value) === themePath;
-	if (extensions.includes(DOOM_EXTENSION) || themes.some(isPoTheme) || current[THEME_KEY] === PO_THEME_NAME) {
-		const keepFilters = extensions.some(isOtherAgimonDistribution);
-		const next = { ...current };
-		if (Array.isArray(current[EXTENSIONS_KEY])) next[EXTENSIONS_KEY] = current[EXTENSIONS_KEY].filter((value) => value !== DOOM_EXTENSION && (keepFilters || typeof value !== "string" || !isSharedFilter(value)));
-		if (Array.isArray(current[THEMES_KEY])) next[THEMES_KEY] = current[THEMES_KEY].filter((value) => typeof value !== "string" || !isPoTheme(value));
-		if (current[THEME_KEY] === PO_THEME_NAME) delete next[THEME_KEY];
-		writeFileAtomic(settingsPath, serializePiSettings(next));
-		removed.push(settingsPath);
-	}
-	if (fs.lstatSync(themePath, { throwIfNoEntry: false })?.isFile()) {
-		fs.rmSync(themePath, { force: true });
-		removed.push(themePath);
-	}
-	const dispatcher = poDispatcherDirectory(agentDirectory);
-	if (dispatcher) {
-		fs.rmSync(dispatcher, {
-			recursive: true,
-			force: true
-		});
-		removed.push(dispatcher);
-	}
-	return removed;
-}
-//#endregion
-export { AMBIENT_EXTENSION_FILTER, DISABLED_PI_BUILTINS, DOOM_EXTENSION, PO_DISPATCHER_MARKER, PO_HOME_ENV, hasRepositoryDoomDirectory, isPoDispatcherPackage, mergePiSettings, modelConfigDirectory, modelSettingsDirectory, piAgentDirectory, piSettingsPath, piThemeDirectory, poHomeDirectory, poRuntimeDirectory, readPiSettings, removePoPiSettings, serializePiSettings, writePiSettings };
-
-//# sourceMappingURL=runtimePiSettings.mjs.map
+import { AGENT_DIRECTORY, AMBIENT_EXTENSION_FILTER, AUTH_FILE, DISABLED_PI_BUILTINS, MODELS_FILE, PI_HOME_DIRECTORY, PO_DISPATCHER_MARKER, PO_EXTENSION, PO_HOME_DIRECTORY, PO_HOME_ENV, PO_THEME_FILE, hasRepositoryPoDirectoryAsync, isPoDispatcherManifest, isPoDispatcherPackageAsync, isPoHomeMarker, mergePiSettings, modelConfigDirectoryAsync, modelSettingsDirectoryAsync, normalizePiSettings, piAgentDirectory, piSettingsPath, piThemeDirectory, poDispatcherPath, poHomeDirectory, poRuntimeDirectory, poThemePath, prunePoPiSettings, readPiSettingsAsync, removePoPiSettingsAsync, serializePiSettings, writePiSettingsAsync } from "./src/services/piSettings/core.mjs";
+import { hasRepositoryPoDirectory, isPoDispatcherPackage, modelConfigDirectory, modelSettingsDirectory, readPiSettings, removePoPiSettings, writePiSettings } from "./src/services/piSettings/sync.mjs";
+export { AGENT_DIRECTORY, AMBIENT_EXTENSION_FILTER, AUTH_FILE, DISABLED_PI_BUILTINS, MODELS_FILE, PI_HOME_DIRECTORY, PO_DISPATCHER_MARKER, PO_EXTENSION, PO_HOME_DIRECTORY, PO_HOME_ENV, PO_THEME_FILE, hasRepositoryPoDirectory, hasRepositoryPoDirectoryAsync, isPoDispatcherManifest, isPoDispatcherPackage, isPoDispatcherPackageAsync, isPoHomeMarker, mergePiSettings, modelConfigDirectory, modelConfigDirectoryAsync, modelSettingsDirectory, modelSettingsDirectoryAsync, normalizePiSettings, piAgentDirectory, piSettingsPath, piThemeDirectory, poDispatcherPath, poHomeDirectory, poRuntimeDirectory, poThemePath, prunePoPiSettings, readPiSettings, readPiSettingsAsync, removePoPiSettings, removePoPiSettingsAsync, serializePiSettings, writePiSettings, writePiSettingsAsync };

package/dist/runtimeProtocol.cjs

@@ -2,7 +2,7 @@ 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 = {
+const PO_PROTOCOL_ERROR_CODE = {
 	aborted: "ABORTED",
 	invalidMessage: "INVALID_MESSAGE",
 	providerError: "PROVIDER_ERROR",
@@ -15,23 +15,23 @@ const ProtocolErrorSchema = typebox.Type.Object({
 	message: typebox.Type.String({ minLength: 1 }),
 	retryable: typebox.Type.Optional(typebox.Type.Boolean())
 }, { additionalProperties: false });
-var DoomProtocolError = class extends Error {
+var PoProtocolError = class extends Error {
 	code;
 	retryable;
 	constructor(payload) {
 		super(payload.message);
-		this.name = "DoomProtocolError";
+		this.name = "PoProtocolError";
 		this.code = payload.code;
 		this.retryable = payload.retryable ?? false;
 	}
 };
-var DoomProtocolValidationError = class extends DoomProtocolError {
+var PoProtocolValidationError = class extends PoProtocolError {
 	constructor(channel, details) {
 		super({
-			code: DOOM_PROTOCOL_ERROR_CODE.invalidMessage,
+			code: PO_PROTOCOL_ERROR_CODE.invalidMessage,
 			message: `Invalid message on ${channel}: ${details}`
 		});
-		this.name = "DoomProtocolValidationError";
+		this.name = "PoProtocolValidationError";
 	}
 };
 const EnvelopeBaseSchema = typebox.Type.Object({
@@ -50,8 +50,8 @@ function envelopeSchema(payload) {
 	}, { additionalProperties: false });
 }
 function protocolName(channel) {
-	const match = /^(doom:[^:]+(?::[^:]+)*):v\d+:/.exec(channel);
-	if (!match) throw new Error(`Invalid Doom protocol channel: ${channel}`);
+	const match = /^(po:[^:]+(?::[^:]+)*):v\d+:/.exec(channel);
+	if (!match) throw new Error(`Invalid Po protocol channel: ${channel}`);
 	return match[1];
 }
 /** Up to three field-level problems, e.g. `/ must have required properties path`. */
@@ -62,16 +62,16 @@ function validationDetails(schema, value) {
 	}).join("; ");
 }
 function assertValid(channel, schema, value) {
-	if (!(0, typebox_value.Check)(schema, value)) throw new DoomProtocolValidationError(channel, validationDetails(schema, value));
+	if (!(0, typebox_value.Check)(schema, value)) throw new PoProtocolValidationError(channel, validationDetails(schema, value));
 }
 function asProtocolError(error) {
-	if (error instanceof DoomProtocolError) return {
+	if (error instanceof PoProtocolError) return {
 		code: error.code,
 		message: error.message,
 		retryable: error.retryable
 	};
 	return {
-		code: DOOM_PROTOCOL_ERROR_CODE.providerError,
+		code: PO_PROTOCOL_ERROR_CODE.providerError,
 		message: error instanceof Error ? error.message : String(error)
 	};
 }
@@ -168,16 +168,16 @@ function createProtocolRuntime(options) {
 					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)));
+					finish(() => reject(new PoProtocolError(envelope.payload)));
 				}));
-				const timer = setTimeout(() => finish(() => reject(new DoomProtocolError({
-					code: DOOM_PROTOCOL_ERROR_CODE.timeout,
+				const timer = setTimeout(() => finish(() => reject(new PoProtocolError({
+					code: PO_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,
+					const abort = () => finish(() => reject(new PoProtocolError({
+						code: PO_PROTOCOL_ERROR_CODE.aborted,
 						message: "Request aborted"
 					})));
 					requestOptions.signal.addEventListener("abort", abort, { once: true });
@@ -215,9 +215,9 @@ function createProtocolRuntime(options) {
 	};
 }
 //#endregion
-exports.DOOM_PROTOCOL_ERROR_CODE = DOOM_PROTOCOL_ERROR_CODE;
-exports.DoomProtocolError = DoomProtocolError;
-exports.DoomProtocolValidationError = DoomProtocolValidationError;
+exports.PO_PROTOCOL_ERROR_CODE = PO_PROTOCOL_ERROR_CODE;
+exports.PoProtocolError = PoProtocolError;
+exports.PoProtocolValidationError = PoProtocolValidationError;
 exports.ProtocolErrorSchema = ProtocolErrorSchema;
 exports.createProtocolRuntime = createProtocolRuntime;
 exports.defineJob = defineJob;

package/dist/runtimeProtocol.cjs.map

@@ -1 +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\n/** Up to three field-level problems, e.g. `/ must have required properties path`. */\nexport function validationDetails(schema: TSchema, value: unknown): string {\n  return (\n    Errors(schema, value)\n      // Each extra key also yields a bare `schema is false`; the additionalProperties entry names them instead.\n      .filter((error) => !(error.keyword === 'boolean' && error.schemaPath.endsWith('/additionalProperties')))\n      .slice(0, 3)\n      .map((error) => {\n        const extra =\n          error.keyword === 'additionalProperties'\n            ? `: ${((error.params as { additionalProperties?: string[] }).additionalProperties ?? []).join(', ')}`\n            : '';\n        return `${error.instancePath || '/'} ${error.message}${extra}`;\n      })\n      .join('; ')\n  );\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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"}
+{"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 PO_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 PoProtocolError extends Error {\n  readonly code: string;\n  readonly retryable: boolean;\n\n  constructor(payload: ProtocolErrorPayload) {\n    super(payload.message);\n    this.name = 'PoProtocolError';\n    this.code = payload.code;\n    this.retryable = payload.retryable ?? false;\n  }\n}\n\nexport class PoProtocolValidationError extends PoProtocolError {\n  constructor(channel: string, details: string) {\n    super({ code: PO_PROTOCOL_ERROR_CODE.invalidMessage, message: `Invalid message on ${channel}: ${details}` });\n    this.name = 'PoProtocolValidationError';\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 = /^(po:[^:]+(?::[^:]+)*):v\\d+:/.exec(channel);\n  if (!match) throw new Error(`Invalid Po protocol channel: ${channel}`);\n  return match[1];\n}\n\n/** Up to three field-level problems, e.g. `/ must have required properties path`. */\nexport function validationDetails(schema: TSchema, value: unknown): string {\n  return (\n    Errors(schema, value)\n      // Each extra key also yields a bare `schema is false`; the additionalProperties entry names them instead.\n      .filter((error) => !(error.keyword === 'boolean' && error.schemaPath.endsWith('/additionalProperties')))\n      .slice(0, 3)\n      .map((error) => {\n        const extra =\n          error.keyword === 'additionalProperties'\n            ? `: ${((error.params as { additionalProperties?: string[] }).additionalProperties ?? []).join(', ')}`\n            : '';\n        return `${error.instancePath || '/'} ${error.message}${extra}`;\n      })\n      .join('; ')\n  );\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 PoProtocolValidationError(channel, validationDetails(schema, value));\n}\n\nfunction asProtocolError(error: unknown): ProtocolErrorPayload {\n  if (error instanceof PoProtocolError) {\n    return { code: error.code, message: error.message, retryable: error.retryable };\n  }\n  return {\n    code: PO_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: `po:${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: `po:${string}:${string}:v1:${string}`;\n    response: `po:${string}:${string}:v1:${string}`;\n    error: `po:${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 PoProtocolError(envelope.payload)));\n          }),\n        );\n        const timer = setTimeout(\n          () =>\n            finish(() =>\n              reject(\n                new PoProtocolError({\n                  code: PO_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 PoProtocolError({ code: PO_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

@@ -1,6 +1,6 @@
 import { Static, TSchema, Type } from "typebox";
 //#region src/schemas/protocol.d.ts
-export declare const DOOM_PROTOCOL_ERROR_CODE: {
+export declare const PO_PROTOCOL_ERROR_CODE: {
   readonly aborted: 'ABORTED';
   readonly invalidMessage: 'INVALID_MESSAGE';
   readonly providerError: 'PROVIDER_ERROR';
@@ -16,12 +16,12 @@ export declare const ProtocolErrorSchema: Type.TObject<{
   retryable: Type.TOptional<Type.TBoolean>;
 }>;
 export type ProtocolErrorPayload = Static<typeof ProtocolErrorSchema>;
-export declare class DoomProtocolError extends Error {
+export declare class PoProtocolError extends Error {
   readonly code: string;
   readonly retryable: boolean;
   constructor(payload: ProtocolErrorPayload);
 }
-export declare class DoomProtocolValidationError extends DoomProtocolError {
+export declare class PoProtocolValidationError extends PoProtocolError {
   constructor(channel: string, details: string);
 }
 export interface ProtocolIdentity {
@@ -63,15 +63,15 @@ export interface ProtocolRuntime {
 /** Up to three field-level problems, e.g. `/ must have required properties path`. */
 export declare function validationDetails(schema: TSchema, value: unknown): string;
 export declare function defineNotification<TPayload extends TSchema>(definition: {
-  channel: `doom:${string}:${string}:v1:${string}`;
+  channel: `po:${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}`;
+    request: `po:${string}:${string}:v1:${string}`;
+    response: `po:${string}:${string}:v1:${string}`;
+    error: `po:${string}:${string}:v1:${string}`;
   };
   kinds: {
     request: string;

package/dist/runtimeProtocol.d.mts.map

@@ -1 +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;;;wBA4B3F,kBAAkB,QAAQ,SAAS;wBAmCnC,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"}
+{"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,wBAAwB;WAC1B;WACA;EAET,YAAY,SAAS;;qBAQV,kCAAkC;EAC7C,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;;;wBA4B3F,kBAAkB,QAAQ,SAAS;wBAmCnC,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"}

package/dist/runtimeProtocol.mjs

@@ -1,7 +1,7 @@
 import { Type } from "typebox";
 import { Check, Errors } from "typebox/value";
 //#region src/schemas/protocol.ts
-const DOOM_PROTOCOL_ERROR_CODE = {
+const PO_PROTOCOL_ERROR_CODE = {
 	aborted: "ABORTED",
 	invalidMessage: "INVALID_MESSAGE",
 	providerError: "PROVIDER_ERROR",
@@ -14,23 +14,23 @@ const ProtocolErrorSchema = Type.Object({
 	message: Type.String({ minLength: 1 }),
 	retryable: Type.Optional(Type.Boolean())
 }, { additionalProperties: false });
-var DoomProtocolError = class extends Error {
+var PoProtocolError = class extends Error {
 	code;
 	retryable;
 	constructor(payload) {
 		super(payload.message);
-		this.name = "DoomProtocolError";
+		this.name = "PoProtocolError";
 		this.code = payload.code;
 		this.retryable = payload.retryable ?? false;
 	}
 };
-var DoomProtocolValidationError = class extends DoomProtocolError {
+var PoProtocolValidationError = class extends PoProtocolError {
 	constructor(channel, details) {
 		super({
-			code: DOOM_PROTOCOL_ERROR_CODE.invalidMessage,
+			code: PO_PROTOCOL_ERROR_CODE.invalidMessage,
 			message: `Invalid message on ${channel}: ${details}`
 		});
-		this.name = "DoomProtocolValidationError";
+		this.name = "PoProtocolValidationError";
 	}
 };
 const EnvelopeBaseSchema = Type.Object({
@@ -49,8 +49,8 @@ function envelopeSchema(payload) {
 	}, { additionalProperties: false });
 }
 function protocolName(channel) {
-	const match = /^(doom:[^:]+(?::[^:]+)*):v\d+:/.exec(channel);
-	if (!match) throw new Error(`Invalid Doom protocol channel: ${channel}`);
+	const match = /^(po:[^:]+(?::[^:]+)*):v\d+:/.exec(channel);
+	if (!match) throw new Error(`Invalid Po protocol channel: ${channel}`);
 	return match[1];
 }
 /** Up to three field-level problems, e.g. `/ must have required properties path`. */
@@ -61,16 +61,16 @@ function validationDetails(schema, value) {
 	}).join("; ");
 }
 function assertValid(channel, schema, value) {
-	if (!Check(schema, value)) throw new DoomProtocolValidationError(channel, validationDetails(schema, value));
+	if (!Check(schema, value)) throw new PoProtocolValidationError(channel, validationDetails(schema, value));
 }
 function asProtocolError(error) {
-	if (error instanceof DoomProtocolError) return {
+	if (error instanceof PoProtocolError) return {
 		code: error.code,
 		message: error.message,
 		retryable: error.retryable
 	};
 	return {
-		code: DOOM_PROTOCOL_ERROR_CODE.providerError,
+		code: PO_PROTOCOL_ERROR_CODE.providerError,
 		message: error instanceof Error ? error.message : String(error)
 	};
 }
@@ -167,16 +167,16 @@ function createProtocolRuntime(options) {
 					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)));
+					finish(() => reject(new PoProtocolError(envelope.payload)));
 				}));
-				const timer = setTimeout(() => finish(() => reject(new DoomProtocolError({
-					code: DOOM_PROTOCOL_ERROR_CODE.timeout,
+				const timer = setTimeout(() => finish(() => reject(new PoProtocolError({
+					code: PO_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,
+					const abort = () => finish(() => reject(new PoProtocolError({
+						code: PO_PROTOCOL_ERROR_CODE.aborted,
 						message: "Request aborted"
 					})));
 					requestOptions.signal.addEventListener("abort", abort, { once: true });
@@ -214,6 +214,6 @@ function createProtocolRuntime(options) {
 	};
 }
 //#endregion
-export { DOOM_PROTOCOL_ERROR_CODE, DoomProtocolError, DoomProtocolValidationError, ProtocolErrorSchema, createProtocolRuntime, defineJob, defineNotification, defineRequestReply, validationDetails };
+export { PO_PROTOCOL_ERROR_CODE, PoProtocolError, PoProtocolValidationError, ProtocolErrorSchema, createProtocolRuntime, defineJob, defineNotification, defineRequestReply, validationDetails };
 
 //# sourceMappingURL=runtimeProtocol.mjs.map