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

package/dist/runtime-protocol.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=runtime-protocol.cjs.map

package/dist/runtime-protocol.cjs.map

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

@@ -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=runtime-protocol.d.cts.map

package/dist/runtime-protocol.d.cts.map

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

package/dist/runtime-protocol.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=runtime-protocol.d.mts.map

package/dist/runtime-protocol.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-protocol.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"}

package/dist/runtime-protocol.mjs

@@ -0,0 +1,215 @@
+import { Type } from "typebox";
+import { Check, Errors } from "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 = Type.Object({
+	code: Type.String({ minLength: 1 }),
+	message: Type.String({ minLength: 1 }),
+	retryable: Type.Optional(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 = Type.Object({
+	protocol: Type.String({ minLength: 1 }),
+	version: Type.Literal(1),
+	kind: Type.String({ minLength: 1 }),
+	messageId: Type.String({ minLength: 1 }),
+	correlationId: Type.Optional(Type.String({ minLength: 1 })),
+	source: Type.String({ minLength: 1 }),
+	sessionId: Type.String({ minLength: 1 })
+}, { additionalProperties: false });
+function envelopeSchema(payload) {
+	return 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 Errors(schema, value).slice(0, 3).map((error) => `${error.instancePath || "/"} ${error.message}`).join("; ");
+}
+function assertValid(channel, schema, value) {
+	if (!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
+export { DOOM_PROTOCOL_ERROR_CODE, DoomProtocolError, DoomProtocolValidationError, ProtocolErrorSchema, createProtocolRuntime, defineJob, defineNotification, defineRequestReply };
+
+//# sourceMappingURL=runtime-protocol.mjs.map