@graphrefly/ts 0.0.0 → 0.0.1

package/dist/orchestration/messaging.cjs

@@ -0,0 +1,314 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/orchestration/messaging.ts
+var messaging_exports = {};
+__export(messaging_exports, {
+  orchestrationMessageAckCommands: () => orchestrationMessageAckCommands,
+  orchestrationMessageCommand: () => orchestrationMessageCommand,
+  orchestrationMessagingRecipe: () => orchestrationMessagingRecipe,
+  processEventOutboxCommands: () => processEventOutboxCommands
+});
+module.exports = __toCommonJS(messaging_exports);
+
+// src/protocol/messages.ts
+var SENTINEL = void 0;
+
+// src/ctx/types.ts
+function depWaves(ctx, depIndex) {
+  return ctx.waveData[depIndex] ?? [];
+}
+function depBatch(ctx, depIndex) {
+  const waves = depWaves(ctx, depIndex);
+  if (waves.length === 0) return null;
+  const flattened = waves.flat().filter((v) => v !== SENTINEL);
+  return flattened.length === 0 ? [] : flattened;
+}
+
+// src/orchestration/messaging.ts
+function orchestrationMessagingRecipe(graph, opts) {
+  const name = opts.name ?? "orchestrationMessaging";
+  const runtime = graph.node(
+    [opts.deliveries],
+    (ctx) => {
+      for (const raw of depBatch(ctx, 0) ?? []) {
+        const page = raw;
+        for (const message of page.messages) {
+          const delivery = messageDelivery(page, message);
+          const command = orchestrationMessageCommand(message, delivery, opts.policy);
+          if (command === void 0) {
+            ctx.down([["DATA", { kind: "issue", issue: messageIssue(message, delivery) }]]);
+          } else {
+            ctx.down([["DATA", { kind: "command", command }]]);
+          }
+        }
+      }
+    },
+    {
+      name: `${name}/runtime`,
+      factory: "orchestrationMessagingRuntime",
+      partial: true,
+      completeWhenDepsComplete: false,
+      errorWhenDepsError: false
+    }
+  );
+  const issues = project(
+    graph,
+    runtime,
+    `${name}/issues`,
+    "orchestrationMessagingIssues",
+    (fact) => fact.kind === "issue" ? fact.issue : void 0
+  );
+  const commands = project(
+    graph,
+    runtime,
+    `${name}/commands`,
+    "orchestrationMessagingCommands",
+    (fact) => fact.kind === "command" ? fact.command : void 0
+  );
+  return {
+    commands,
+    ackCommands: orchestrationMessageAckCommands(graph, {
+      name: `${name}/ackCommands`,
+      commands,
+      status: opts.status,
+      issues,
+      ackRejected: opts.policy?.ackRejected ?? true
+    }),
+    ...opts.events === void 0 || opts.policy?.outboxTopic === void 0 ? {} : {
+      outboxCommands: processEventOutboxCommands(graph, opts.events, opts.policy.outboxTopic, {
+        name: `${name}/outboxCommands`
+      })
+    },
+    issues
+  };
+}
+function orchestrationMessageCommand(message, delivery, policy) {
+  const mapped = policy?.command?.(message, delivery);
+  if (mapped !== void 0) return commandWithDelivery(mapped, delivery);
+  if (!isObjectRecord(message.payload)) return void 0;
+  const id = stringField(message.payload, "id") ?? delivery.commandId;
+  const type = stringField(message.payload, "type");
+  if (type === void 0) return void 0;
+  return commandWithDelivery(
+    {
+      id,
+      type,
+      payload: message.payload.payload,
+      processId: stringField(message.payload, "processId"),
+      correlationId: stringField(message.payload, "correlationId"),
+      causationId: stringField(message.payload, "causationId"),
+      metadata: {
+        ...objectField(message.payload, "metadata") ?? {}
+      }
+    },
+    delivery
+  );
+}
+function orchestrationMessageAckCommands(graph, opts) {
+  return graph.node(
+    opts.issues === void 0 ? [opts.commands, opts.status] : [opts.commands, opts.status, opts.issues],
+    (ctx) => {
+      const deliveries = ctx.state.get() ?? /* @__PURE__ */ new Map();
+      for (const raw of depBatch(ctx, 0) ?? []) {
+        const command = raw;
+        const delivery = commandDelivery(command);
+        if (delivery !== void 0) pushDelivery(deliveries, command.id, delivery);
+      }
+      for (const raw of depBatch(ctx, 1) ?? []) {
+        const status = raw;
+        if (status.state === "rejected" && opts.ackRejected === false) continue;
+        if (status.commandId === void 0) continue;
+        const delivery = shiftDelivery(deliveries, status.commandId);
+        if (delivery === void 0) continue;
+        ctx.down([
+          ["DATA", ackCommand(delivery, ackCommandId("orchestration", delivery, "status"))]
+        ]);
+      }
+      if (opts.issues !== void 0) {
+        for (const raw of depBatch(ctx, 2) ?? []) {
+          const delivery = issueDelivery(raw);
+          if (delivery !== void 0) {
+            ctx.down([
+              ["DATA", ackCommand(delivery, ackCommandId("orchestration", delivery, "issue"))]
+            ]);
+          }
+        }
+      }
+      ctx.state.set(deliveries);
+    },
+    {
+      name: opts.name ?? "orchestrationMessaging/ackCommands",
+      factory: "orchestrationMessagingAckCommands",
+      partial: true,
+      completeWhenDepsComplete: false,
+      errorWhenDepsError: false
+    }
+  );
+}
+function processEventOutboxCommands(graph, events, topic, opts = {}) {
+  return graph.node(
+    [events],
+    (ctx) => {
+      for (const event of depBatch(ctx, 0) ?? []) {
+        const typed = event;
+        ctx.down([
+          [
+            "DATA",
+            {
+              kind: "publish",
+              topic,
+              payload: typed,
+              key: typed.processId,
+              commandId: `${typed.id}:process-outbox`,
+              idempotencyKey: typed.id
+            }
+          ]
+        ]);
+      }
+    },
+    {
+      name: opts.name ?? "orchestrationMessaging/outboxCommands",
+      factory: "orchestrationMessagingOutboxCommands",
+      completeWhenDepsComplete: false,
+      errorWhenDepsError: false
+    }
+  );
+}
+function project(graph, runtime, name, factory, pick) {
+  return graph.node(
+    [runtime],
+    (ctx) => {
+      for (const fact of depBatch(ctx, 0) ?? []) {
+        const value = pick(fact);
+        if (value !== void 0) ctx.down([["DATA", value]]);
+      }
+    },
+    { name, factory, partial: true, completeWhenDepsComplete: false, errorWhenDepsError: false }
+  );
+}
+function messageIssue(message, delivery) {
+  return {
+    kind: "issue",
+    code: "orchestration-message-lowering-rejected",
+    message: "Orchestration messaging recipe could not lower retained message to a command fact",
+    severity: "error",
+    source: "orchestration.messaging",
+    metadata: {
+      messageBus: {
+        topic: delivery.topic,
+        seq: delivery.seq,
+        subscriptionId: delivery.subscriptionId,
+        commandId: delivery.commandId
+      }
+    },
+    details: message
+  };
+}
+function ackCommand(delivery, commandId) {
+  return {
+    kind: "ack",
+    topic: delivery.topic,
+    subscriptionId: delivery.subscriptionId,
+    seq: delivery.seq,
+    commandId
+  };
+}
+function ackCommandId(namespace, delivery, reason) {
+  return `${namespace}:${delivery.topic}:${delivery.subscriptionId}:${delivery.seq}:${reason}-ack`;
+}
+function commandWithDelivery(command, delivery) {
+  return {
+    ...command,
+    metadata: {
+      ...command.metadata ?? {},
+      messageBus: delivery
+    }
+  };
+}
+function messageDelivery(page, message) {
+  return {
+    topic: page.topic,
+    seq: message.seq,
+    subscriptionId: page.subscriptionId,
+    commandId: isObjectRecord(message.payload) && typeof message.payload.id === "string" ? message.payload.id : message.commandId ?? `${page.topic}:${message.seq}`
+  };
+}
+function pushDelivery(deliveries, commandId, delivery) {
+  const queue = deliveries.get(commandId) ?? [];
+  deliveries.set(commandId, [...queue, delivery]);
+}
+function shiftDelivery(deliveries, commandId) {
+  const queue = deliveries.get(commandId);
+  if (queue === void 0 || queue.length === 0) return void 0;
+  const [first, ...rest] = queue;
+  if (rest.length === 0) deliveries.delete(commandId);
+  else deliveries.set(commandId, rest);
+  return first;
+}
+function issueDelivery(issue) {
+  const metadata = isObjectRecord(issue.metadata) ? issue.metadata : void 0;
+  const messageBus = isObjectRecord(metadata?.messageBus) ? metadata.messageBus : void 0;
+  if (messageBus === void 0) return void 0;
+  if (typeof messageBus.topic !== "string" || typeof messageBus.seq !== "number") return void 0;
+  if (typeof messageBus.subscriptionId !== "string") return void 0;
+  if (typeof messageBus.commandId !== "string") return void 0;
+  return {
+    topic: messageBus.topic,
+    seq: messageBus.seq,
+    subscriptionId: messageBus.subscriptionId,
+    commandId: messageBus.commandId
+  };
+}
+function commandDelivery(command) {
+  const metadata = isObjectRecord(command.metadata) ? command.metadata : void 0;
+  const messageBus = isObjectRecord(metadata?.messageBus) ? metadata.messageBus : void 0;
+  if (messageBus === void 0) return void 0;
+  return messageBusDelivery(messageBus);
+}
+function messageBusDelivery(messageBus) {
+  if (typeof messageBus.topic !== "string" || typeof messageBus.seq !== "number") return void 0;
+  if (typeof messageBus.subscriptionId !== "string") return void 0;
+  const commandId = typeof messageBus.commandId === "string" ? messageBus.commandId : "";
+  return {
+    topic: messageBus.topic,
+    seq: messageBus.seq,
+    subscriptionId: messageBus.subscriptionId,
+    commandId
+  };
+}
+function stringField(record, key) {
+  const value = record[key];
+  return typeof value === "string" && value.length > 0 ? value : void 0;
+}
+function objectField(record, key) {
+  const value = record[key];
+  return isObjectRecord(value) ? value : void 0;
+}
+function isObjectRecord(value) {
+  return typeof value === "object" && value !== null;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  orchestrationMessageAckCommands,
+  orchestrationMessageCommand,
+  orchestrationMessagingRecipe,
+  processEventOutboxCommands
+});
+//# sourceMappingURL=messaging.cjs.map

package/dist/orchestration/messaging.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/orchestration/messaging.ts","../../src/protocol/messages.ts","../../src/ctx/types.ts"],"sourcesContent":["/**\n * Optional orchestration-over-messageBus recipe (D349/D351/D353).\n *\n * Ack commands are graph-derived from visible ProcessBundle accepted/rejected\n * material; retained delivery receipt is never an ack.\n */\n\nimport { depBatch } from \"../ctx/types.js\";\nimport type { DataIssue } from \"../data/index.js\";\nimport type { Graph } from \"../graph/graph.js\";\nimport type {\n\tMessageBusAvailablePage,\n\tMessageBusCommand,\n\tMessageBusMessage,\n} from \"../messaging/index.js\";\nimport type { Node } from \"../node/node.js\";\nimport type { ProcessCommand, ProcessEvent, ProcessStatus } from \"../orchestration/index.js\";\n\nexport interface OrchestrationMessagingPolicy<TPayload = unknown, TCommand = unknown> {\n\treadonly command?: (\n\t\tmessage: MessageBusMessage<TPayload>,\n\t\tdelivery: MessageBusDelivery,\n\t) => ProcessCommand<TCommand> | undefined;\n\treadonly ackRejected?: boolean;\n\treadonly outboxTopic?: string;\n}\n\nexport interface OrchestrationMessagingRecipeOptions<\n\tTPayload = unknown,\n\tTCommand = unknown,\n\tTEvent = unknown,\n> {\n\treadonly name?: string;\n\treadonly deliveries: Node<MessageBusAvailablePage<TPayload>>;\n\treadonly status: Node<ProcessStatus>;\n\treadonly events?: Node<ProcessEvent<TEvent>>;\n\treadonly policy?: OrchestrationMessagingPolicy<TPayload, TCommand>;\n}\n\nexport interface OrchestrationMessagingRecipeBundle<TCommand = unknown> {\n\treadonly commands: Node<ProcessCommand<TCommand>>;\n\treadonly ackCommands: Node<MessageBusCommand>;\n\treadonly outboxCommands?: Node<MessageBusCommand>;\n\treadonly issues: Node<DataIssue>;\n}\n\ntype OrchestrationMessagingFact<TCommand> =\n\t| { readonly kind: \"command\"; readonly command: ProcessCommand<TCommand> }\n\t| { readonly kind: \"issue\"; readonly issue: DataIssue };\n\nexport interface MessageBusDelivery {\n\treadonly topic: string;\n\treadonly seq: number;\n\treadonly subscriptionId: string;\n\treadonly commandId: string;\n}\n\n/** Build the optional D349/D351 orchestration messaging recipe. */\nexport function orchestrationMessagingRecipe<\n\tTPayload = unknown,\n\tTCommand = unknown,\n\tTEvent = unknown,\n>(\n\tgraph: Graph,\n\topts: OrchestrationMessagingRecipeOptions<TPayload, TCommand, TEvent>,\n): OrchestrationMessagingRecipeBundle<TCommand> {\n\tconst name = opts.name ?? \"orchestrationMessaging\";\n\tconst runtime = graph.node<OrchestrationMessagingFact<TCommand>>(\n\t\t[opts.deliveries],\n\t\t(ctx) => {\n\t\t\tfor (const raw of depBatch(ctx, 0) ?? []) {\n\t\t\t\tconst page = raw as MessageBusAvailablePage<TPayload>;\n\t\t\t\tfor (const message of page.messages) {\n\t\t\t\t\tconst delivery = messageDelivery(page, message);\n\t\t\t\t\tconst command = orchestrationMessageCommand(message, delivery, opts.policy);\n\t\t\t\t\tif (command === undefined) {\n\t\t\t\t\t\tctx.down([[\"DATA\", { kind: \"issue\", issue: messageIssue(message, delivery) }]]);\n\t\t\t\t\t} else {\n\t\t\t\t\t\tctx.down([[\"DATA\", { kind: \"command\", command }]]);\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\t\t},\n\t\t{\n\t\t\tname: `${name}/runtime`,\n\t\t\tfactory: \"orchestrationMessagingRuntime\",\n\t\t\tpartial: true,\n\t\t\tcompleteWhenDepsComplete: false,\n\t\t\terrorWhenDepsError: false,\n\t\t},\n\t);\n\tconst issues = project(\n\t\tgraph,\n\t\truntime,\n\t\t`${name}/issues`,\n\t\t\"orchestrationMessagingIssues\",\n\t\t(fact) => (fact.kind === \"issue\" ? fact.issue : undefined),\n\t);\n\tconst commands = project(\n\t\tgraph,\n\t\truntime,\n\t\t`${name}/commands`,\n\t\t\"orchestrationMessagingCommands\",\n\t\t(fact) => (fact.kind === \"command\" ? fact.command : undefined),\n\t);\n\treturn {\n\t\tcommands,\n\t\tackCommands: orchestrationMessageAckCommands(graph, {\n\t\t\tname: `${name}/ackCommands`,\n\t\t\tcommands,\n\t\t\tstatus: opts.status,\n\t\t\tissues,\n\t\t\tackRejected: opts.policy?.ackRejected ?? true,\n\t\t}),\n\t\t...(opts.events === undefined || opts.policy?.outboxTopic === undefined\n\t\t\t? {}\n\t\t\t: {\n\t\t\t\t\toutboxCommands: processEventOutboxCommands(graph, opts.events, opts.policy.outboxTopic, {\n\t\t\t\t\t\tname: `${name}/outboxCommands`,\n\t\t\t\t\t}),\n\t\t\t\t}),\n\t\tissues,\n\t};\n}\n\nexport function orchestrationMessageCommand<TPayload = unknown, TCommand = unknown>(\n\tmessage: MessageBusMessage<TPayload>,\n\tdelivery: MessageBusDelivery,\n\tpolicy?: OrchestrationMessagingPolicy<TPayload, TCommand>,\n): ProcessCommand<TCommand> | undefined {\n\tconst mapped = policy?.command?.(message, delivery);\n\tif (mapped !== undefined) return commandWithDelivery(mapped, delivery);\n\tif (!isObjectRecord(message.payload)) return undefined;\n\tconst id = stringField(message.payload, \"id\") ?? delivery.commandId;\n\tconst type = stringField(message.payload, \"type\");\n\tif (type === undefined) return undefined;\n\treturn commandWithDelivery(\n\t\t{\n\t\t\tid,\n\t\t\ttype,\n\t\t\tpayload: message.payload.payload as TCommand,\n\t\t\tprocessId: stringField(message.payload, \"processId\"),\n\t\t\tcorrelationId: stringField(message.payload, \"correlationId\"),\n\t\t\tcausationId: stringField(message.payload, \"causationId\"),\n\t\t\tmetadata: {\n\t\t\t\t...(objectField(message.payload, \"metadata\") ?? {}),\n\t\t\t},\n\t\t},\n\t\tdelivery,\n\t);\n}\n\nexport function orchestrationMessageAckCommands(\n\tgraph: Graph,\n\topts: {\n\t\treadonly name?: string;\n\t\treadonly commands: Node<ProcessCommand>;\n\t\treadonly status: Node<ProcessStatus>;\n\t\treadonly issues?: Node<DataIssue>;\n\t\treadonly ackRejected?: boolean;\n\t},\n): Node<MessageBusCommand> {\n\treturn graph.node<MessageBusCommand>(\n\t\topts.issues === undefined\n\t\t\t? [opts.commands, opts.status]\n\t\t\t: [opts.commands, opts.status, opts.issues],\n\t\t(ctx) => {\n\t\t\tconst deliveries =\n\t\t\t\tctx.state.get<Map<string, MessageBusDelivery[]>>() ??\n\t\t\t\tnew Map<string, MessageBusDelivery[]>();\n\t\t\tfor (const raw of depBatch(ctx, 0) ?? []) {\n\t\t\t\tconst command = raw as ProcessCommand;\n\t\t\t\tconst delivery = commandDelivery(command);\n\t\t\t\tif (delivery !== undefined) pushDelivery(deliveries, command.id, delivery);\n\t\t\t}\n\t\t\tfor (const raw of depBatch(ctx, 1) ?? []) {\n\t\t\t\tconst status = raw as ProcessStatus;\n\t\t\t\tif (status.state === \"rejected\" && opts.ackRejected === false) continue;\n\t\t\t\tif (status.commandId === undefined) continue;\n\t\t\t\tconst delivery = shiftDelivery(deliveries, status.commandId);\n\t\t\t\tif (delivery === undefined) continue;\n\t\t\t\tctx.down([\n\t\t\t\t\t[\"DATA\", ackCommand(delivery, ackCommandId(\"orchestration\", delivery, \"status\"))],\n\t\t\t\t]);\n\t\t\t}\n\t\t\tif (opts.issues !== undefined) {\n\t\t\t\tfor (const raw of depBatch(ctx, 2) ?? []) {\n\t\t\t\t\tconst delivery = issueDelivery(raw as DataIssue);\n\t\t\t\t\tif (delivery !== undefined) {\n\t\t\t\t\t\tctx.down([\n\t\t\t\t\t\t\t[\"DATA\", ackCommand(delivery, ackCommandId(\"orchestration\", delivery, \"issue\"))],\n\t\t\t\t\t\t]);\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\t\t\tctx.state.set(deliveries);\n\t\t},\n\t\t{\n\t\t\tname: opts.name ?? \"orchestrationMessaging/ackCommands\",\n\t\t\tfactory: \"orchestrationMessagingAckCommands\",\n\t\t\tpartial: true,\n\t\t\tcompleteWhenDepsComplete: false,\n\t\t\terrorWhenDepsError: false,\n\t\t},\n\t);\n}\n\nexport function processEventOutboxCommands<TEvent>(\n\tgraph: Graph,\n\tevents: Node<ProcessEvent<TEvent>>,\n\ttopic: string,\n\topts: { readonly name?: string } = {},\n): Node<MessageBusCommand> {\n\treturn graph.node<MessageBusCommand>(\n\t\t[events],\n\t\t(ctx) => {\n\t\t\tfor (const event of depBatch(ctx, 0) ?? []) {\n\t\t\t\tconst typed = event as ProcessEvent<TEvent>;\n\t\t\t\tctx.down([\n\t\t\t\t\t[\n\t\t\t\t\t\t\"DATA\",\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\tkind: \"publish\",\n\t\t\t\t\t\t\ttopic,\n\t\t\t\t\t\t\tpayload: typed,\n\t\t\t\t\t\t\tkey: typed.processId,\n\t\t\t\t\t\t\tcommandId: `${typed.id}:process-outbox`,\n\t\t\t\t\t\t\tidempotencyKey: typed.id,\n\t\t\t\t\t\t} satisfies MessageBusCommand,\n\t\t\t\t\t],\n\t\t\t\t]);\n\t\t\t}\n\t\t},\n\t\t{\n\t\t\tname: opts.name ?? \"orchestrationMessaging/outboxCommands\",\n\t\t\tfactory: \"orchestrationMessagingOutboxCommands\",\n\t\t\tcompleteWhenDepsComplete: false,\n\t\t\terrorWhenDepsError: false,\n\t\t},\n\t);\n}\n\nfunction project<T, TCommand>(\n\tgraph: Graph,\n\truntime: Node<OrchestrationMessagingFact<TCommand>>,\n\tname: string,\n\tfactory: string,\n\tpick: (fact: OrchestrationMessagingFact<TCommand>) => T | undefined,\n): Node<T> {\n\treturn graph.node<T>(\n\t\t[runtime],\n\t\t(ctx) => {\n\t\t\tfor (const fact of depBatch(ctx, 0) ?? []) {\n\t\t\t\tconst value = pick(fact as OrchestrationMessagingFact<TCommand>);\n\t\t\t\tif (value !== undefined) ctx.down([[\"DATA\", value]]);\n\t\t\t}\n\t\t},\n\t\t{ name, factory, partial: true, completeWhenDepsComplete: false, errorWhenDepsError: false },\n\t);\n}\n\nfunction messageIssue(message: MessageBusMessage, delivery: MessageBusDelivery): DataIssue {\n\treturn {\n\t\tkind: \"issue\",\n\t\tcode: \"orchestration-message-lowering-rejected\",\n\t\tmessage: \"Orchestration messaging recipe could not lower retained message to a command fact\",\n\t\tseverity: \"error\",\n\t\tsource: \"orchestration.messaging\",\n\t\tmetadata: {\n\t\t\tmessageBus: {\n\t\t\t\ttopic: delivery.topic,\n\t\t\t\tseq: delivery.seq,\n\t\t\t\tsubscriptionId: delivery.subscriptionId,\n\t\t\t\tcommandId: delivery.commandId,\n\t\t\t},\n\t\t},\n\t\tdetails: message,\n\t};\n}\n\nfunction ackCommand(delivery: MessageBusDelivery, commandId: string): MessageBusCommand {\n\treturn {\n\t\tkind: \"ack\",\n\t\ttopic: delivery.topic,\n\t\tsubscriptionId: delivery.subscriptionId,\n\t\tseq: delivery.seq,\n\t\tcommandId,\n\t};\n}\n\nfunction ackCommandId(namespace: string, delivery: MessageBusDelivery, reason: string): string {\n\treturn `${namespace}:${delivery.topic}:${delivery.subscriptionId}:${delivery.seq}:${reason}-ack`;\n}\n\nfunction commandWithDelivery<TCommand>(\n\tcommand: ProcessCommand<TCommand>,\n\tdelivery: MessageBusDelivery,\n): ProcessCommand<TCommand> {\n\treturn {\n\t\t...command,\n\t\tmetadata: {\n\t\t\t...(command.metadata ?? {}),\n\t\t\tmessageBus: delivery,\n\t\t},\n\t};\n}\n\nfunction messageDelivery(\n\tpage: MessageBusAvailablePage,\n\tmessage: MessageBusMessage,\n): MessageBusDelivery {\n\treturn {\n\t\ttopic: page.topic,\n\t\tseq: message.seq,\n\t\tsubscriptionId: page.subscriptionId,\n\t\tcommandId:\n\t\t\tisObjectRecord(message.payload) && typeof message.payload.id === \"string\"\n\t\t\t\t? message.payload.id\n\t\t\t\t: (message.commandId ?? `${page.topic}:${message.seq}`),\n\t};\n}\n\nfunction pushDelivery(\n\tdeliveries: Map<string, MessageBusDelivery[]>,\n\tcommandId: string,\n\tdelivery: MessageBusDelivery,\n): void {\n\tconst queue = deliveries.get(commandId) ?? [];\n\tdeliveries.set(commandId, [...queue, delivery]);\n}\n\nfunction shiftDelivery(\n\tdeliveries: Map<string, MessageBusDelivery[]>,\n\tcommandId: string,\n): MessageBusDelivery | undefined {\n\tconst queue = deliveries.get(commandId);\n\tif (queue === undefined || queue.length === 0) return undefined;\n\tconst [first, ...rest] = queue;\n\tif (rest.length === 0) deliveries.delete(commandId);\n\telse deliveries.set(commandId, rest);\n\treturn first;\n}\n\nfunction issueDelivery(issue: DataIssue): MessageBusDelivery | undefined {\n\tconst metadata = isObjectRecord(issue.metadata) ? issue.metadata : undefined;\n\tconst messageBus = isObjectRecord(metadata?.messageBus) ? metadata.messageBus : undefined;\n\tif (messageBus === undefined) return undefined;\n\tif (typeof messageBus.topic !== \"string\" || typeof messageBus.seq !== \"number\") return undefined;\n\tif (typeof messageBus.subscriptionId !== \"string\") return undefined;\n\tif (typeof messageBus.commandId !== \"string\") return undefined;\n\treturn {\n\t\ttopic: messageBus.topic,\n\t\tseq: messageBus.seq,\n\t\tsubscriptionId: messageBus.subscriptionId,\n\t\tcommandId: messageBus.commandId,\n\t};\n}\n\nfunction commandDelivery(command: ProcessCommand): MessageBusDelivery | undefined {\n\tconst metadata = isObjectRecord(command.metadata) ? command.metadata : undefined;\n\tconst messageBus = isObjectRecord(metadata?.messageBus) ? metadata.messageBus : undefined;\n\tif (messageBus === undefined) return undefined;\n\treturn messageBusDelivery(messageBus);\n}\n\nfunction messageBusDelivery(messageBus: Record<string, unknown>): MessageBusDelivery | undefined {\n\tif (typeof messageBus.topic !== \"string\" || typeof messageBus.seq !== \"number\") return undefined;\n\tif (typeof messageBus.subscriptionId !== \"string\") return undefined;\n\tconst commandId = typeof messageBus.commandId === \"string\" ? messageBus.commandId : \"\";\n\treturn {\n\t\ttopic: messageBus.topic,\n\t\tseq: messageBus.seq,\n\t\tsubscriptionId: messageBus.subscriptionId,\n\t\tcommandId,\n\t};\n}\n\nfunction stringField(record: Record<string, unknown>, key: string): string | undefined {\n\tconst value = record[key];\n\treturn typeof value === \"string\" && value.length > 0 ? value : undefined;\n}\n\nfunction objectField(\n\trecord: Record<string, unknown>,\n\tkey: string,\n): Record<string, unknown> | undefined {\n\tconst value = record[key];\n\treturn isObjectRecord(value) ? value : undefined;\n}\n\nfunction isObjectRecord(value: unknown): value is Record<string, unknown> {\n\treturn typeof value === \"object\" && value !== null;\n}\n","/**\n * Wave-protocol message types and the tier const table.\n *\n * Canonical authority: ~/src/graphrefly/spec/rules.jsonl\n *   R-msg-format, R-msg-closed-set, R-tier (D34), R-data-payload, R-sentinel.\n */\n\n/** Opaque pause-lock / pull identifier (R-pause-lockset, R-pull). */\nexport type LockId = string | symbol;\n\n/** Explicit pull demand payload (D269/D272). Params are holder-visible context, never DATA-up. */\nexport interface PullDemand {\n\treadonly pullId: LockId;\n\treadonly params?: unknown;\n}\n\n/**\n * The CLOSED set of 11 message types (R-msg-closed-set / D9 + D269 + START handshake).\n * No open set, no user-defined custom types. Adding a type is a spec change.\n */\nexport type Message =\n\t| readonly [\"START\"]\n\t| readonly [\"DIRTY\"]\n\t| readonly [\"DATA\", unknown]\n\t| readonly [\"RESOLVED\"]\n\t| readonly [\"INVALIDATE\"]\n\t| readonly [\"COMPLETE\"]\n\t| readonly [\"ERROR\", unknown]\n\t| readonly [\"TEARDOWN\"]\n\t| readonly [\"PAUSE\", LockId]\n\t| readonly [\"RESUME\", LockId]\n\t| readonly [\"PULL\", PullDemand];\n\n/** One array of messages delivered in one call = one Wave (R-wave-boundary). */\nexport type Wave = readonly Message[];\n\n/** The message-type tag (the first tuple element). */\nexport type MessageType = Message[0];\n\n/**\n * SENTINEL = absence-of-DATA (R-sentinel / D16). TS representation is `undefined`.\n * Never a valid DATA payload; `null` IS a valid DATA value (domain-level absence).\n */\nexport const SENTINEL = undefined;\n\n/** R-data-payload: ERROR payloads must not collide with terminal metadata shorthand. */\nexport function isInvalidErrorPayload(v: unknown): boolean {\n\treturn v === SENTINEL || typeof v === \"boolean\";\n}\n\n/** R-data-payload / D78: host-language failures that collide with ctx.terminal shorthand become diagnostics. */\nexport function errorPayload(reason: unknown, fallback = \"error without a valid payload\"): unknown {\n\treturn isInvalidErrorPayload(reason) ? new Error(fallback) : reason;\n}\n\nexport const TIER_START = 0;\nexport const TIER_CONTROL = 1;\nexport const TIER_NOTIFICATION = 2;\nexport const TIER_VALUE = 3;\nexport const TIER_SETTLE = 4;\nexport const TIER_TERMINAL = 5;\nexport const TIER_TEARDOWN = 6;\n\n/**\n * Tier const table (R-tier / D34). Tiers below value dispatch immediately; value\n * and above are batch-deferred. This is a compile-time const table (D18), not runtime config.\n */\nconst TIER: Record<MessageType, number> = {\n\tSTART: TIER_START,\n\tPAUSE: TIER_CONTROL,\n\tRESUME: TIER_CONTROL,\n\tPULL: TIER_CONTROL,\n\tDIRTY: TIER_NOTIFICATION,\n\tDATA: TIER_VALUE,\n\tRESOLVED: TIER_VALUE,\n\tINVALIDATE: TIER_SETTLE,\n\tCOMPLETE: TIER_TERMINAL,\n\tERROR: TIER_TERMINAL,\n\tTEARDOWN: TIER_TEARDOWN,\n};\n\nexport function messageTier(t: MessageType): number {\n\treturn TIER[t];\n}\n\n/** Value and above are deferred inside a batch (DATA/RESOLVED/INVALIDATE/terminal/teardown). */\nexport function isDeferredTier(t: MessageType): boolean {\n\treturn TIER[t] >= TIER_VALUE;\n}\n\n/** Value-tier messages (DATA/RESOLVED) occupy the tier-3 slot. */\nexport function isValueTier(t: MessageType): boolean {\n\treturn TIER[t] === TIER_VALUE;\n}\n\n/** The pause buffer holds the settle slice only: value-tier DATA/RESOLVED plus INVALIDATE. */\nexport function isPauseBufferedTier(t: MessageType): boolean {\n\tconst tier = TIER[t];\n\treturn tier === TIER_VALUE || tier === TIER_SETTLE;\n}\n\n/**\n * A TERMINAL message = tier 5 (COMPLETE | ERROR), R-tier / D34. Detected via the CENTRAL tier\n * table, NOT a per-variant `=== \"COMPLETE\" || === \"ERROR\"` check — so terminal routing stays\n * driven by the one const table (feedback_use_tier_for_signal_routing); discriminate COMPLETE vs\n * ERROR within the tier by the message type only where the handling actually differs.\n */\nexport function isTerminal(t: MessageType): boolean {\n\treturn TIER[t] === TIER_TERMINAL;\n}\n\n/**\n * ctx.up carries control/demand tiers only (R-ctx-up / D269): DIRTY, PAUSE, RESUME, PULL,\n * INVALIDATE, TEARDOWN. DATA/RESOLVED (tier 3) and COMPLETE/ERROR (tier 5) are\n * down-only.\n */\nexport function isUpAllowed(t: MessageType): boolean {\n\tconst tier = TIER[t];\n\treturn tier !== TIER_VALUE && tier !== TIER_TERMINAL;\n}\n","/**\n * The fn-invocation context and per-dep input shapes.\n *\n * Canonical authority: ~/src/graphrefly/spec/rules.jsonl\n *   R-fn-contract (D8/D27), R-ctx-state (D23/D29), R-cleanup-hooks (D28), R-ctx-up.\n */\n\nimport type { Dispatcher } from \"../dispatcher/index.js\";\nimport type { EnvironmentDrivers } from \"../graph/environment.js\";\nimport type { Node } from \"../node/node.js\";\nimport { type Message, type PullDemand, SENTINEL, type Wave } from \"../protocol/messages.js\";\n\n/** A downstream sink callback (the only way to connect to a node's output). */\nexport type Sink = (msg: Message, delivery?: DeliveryMeta) => void;\n\n/** Internal delivery metadata used to preserve the upstream `ctx.down(msgs)` wave boundary. */\nexport interface DeliveryMeta {\n\treadonly wave: object;\n\treadonly last: boolean;\n}\n\n/**\n * Internal current-value reader. It is deliberately a symbol-backed implementation detail:\n * raw ctx exposes `waveData` + `terminal`; helpers below derive from that plus this dep cache.\n */\nexport const CTX_DEP_CACHE: unique symbol = Symbol(\"graphrefly.ctx.depCache\");\n\nexport interface CtxDepCache {\n\treadonly latest: readonly unknown[];\n}\n\n/** Internal node-construction binding for graph-local helper-created deps. */\nexport const CTX_NODE_BINDING: unique symbol = Symbol(\"graphrefly.ctx.nodeBinding\");\n\nexport interface CtxNodeBinding {\n\treadonly dispatcher: Dispatcher;\n\tcreate<T>(factory: () => Node<T>): Node<T>;\n}\n\n/** Per-dep wave projections: dep -> waves -> values/SENTINEL markers. */\nexport type WaveData = readonly (readonly (readonly unknown[])[])[];\n\n/** Terminal metadata parallel to `waveData`: false = none, true = COMPLETE, otherwise ERROR payload. */\nexport type TerminalData = readonly unknown[];\n\nexport function isTerminalNone(t: unknown): boolean {\n\treturn t === false || t === undefined;\n}\n\nexport function isTerminalComplete(t: unknown): t is true {\n\treturn t === true;\n}\n\nexport function isTerminalError(t: unknown): boolean {\n\treturn !isTerminalNone(t) && !isTerminalComplete(t);\n}\n\nexport function terminalErrorValue(t: unknown): unknown {\n\treturn isTerminalError(t) ? t : undefined;\n}\n\n/**\n * Per-node private cross-wave state (R-ctx-state / D23,D29). Default fresh-lifecycle\n * wipe; `persist(true)` keeps it across lifecycle transitions.\n */\nexport interface CtxState {\n\tget<S = unknown>(): S | undefined;\n\tset<S = unknown>(v: S): void;\n\tpersist(on?: boolean): void;\n}\n\n/**\n * Deferred SELF-rewire (R-rewire-deferred / D47). A node fn may, DURING its run, request a\n * mutation of its OWN dep set; the request is QUEUED and applied at the committed wave boundary\n * (after the current wave settles / batch commit / final-lock RESUME) as a fresh wave, reusing\n * R-rewire surgical/Option-C semantics (D42). This is the ONLY legal self-triggered rewire — an\n * IMMEDIATE in-fn `node.subscribeDep/unsubscribeDep/replaceDeps` is the D37 mid-fn feedback-cycle ERROR. An\n * added cached dep pushes `[DIRTY,DATA]` on the boundary wave (R-push-subscribe); a removed dep\n * is drained and, if it loses its last subscriber, `_deactivate`s + fires `onDeactivation`\n * (input-side teardown — the basis for higher-order operator cancellation / abortInFlight).\n */\nexport interface RewireNext {\n\t/** Defer subscribing to a dep (paired with the re-supplied fn — positional fn-deps lock, SD-1). */\n\tsubscribeDep(dep: Node<unknown>, fn: NodeFn): void;\n\t/** Defer unsubscribing from a dep (its source is torn down if it loses its last subscriber). */\n\tunsubscribeDep(dep: Node<unknown>, fn: NodeFn): void;\n\t/** Defer replacing the whole dep set (surgical: kept deps untouched, removed drained, added fresh-subscribe). */\n\treplaceDeps(deps: Node<unknown>[], fn: NodeFn): void;\n}\n\n/**\n * The single argument to a node fn: `(ctx) => void` (R-fn-contract / D8). All emission\n * is explicit via `ctx.down`; there is no return-value framing.\n */\nexport interface Ctx {\n\t/**\n\t * Emit upstream toward deps — control tiers only (R-ctx-up). IMMEDIATE. `towardDep` (a dep index)\n\t * routes the wave up ONE declared edge (R-up-routing directed-up); omitted = broadcast up all deps.\n\t * A pull DEMAND is `up([[PULL, { pullId, params }]])` — but for a SELF-demand (demanding a dep\n\t * this fn also reads) use {@link Ctx.upNext} instead, since an immediate demand whose delivery loops back\n\t * re-enters this fn mid-wave (D37 / R-reentrancy).\n\t */\n\tup(msgs: Wave, towardDep?: number): void;\n\t/** Emit downstream toward sinks. */\n\tdown(msgs: Wave): void;\n\t/**\n\t * The single raw dep-value input surface (R-ctx-wave-data / D77): dep -> upstream waves ->\n\t * per-wave DATA payloads and INVALIDATE/SENTINEL markers. `waveData[i] = []` means dep i\n\t * delivered no wave to this invocation; `waveData[i] = [[]]` means RESOLVED-only.\n\t */\n\twaveData: WaveData;\n\t/** Terminal metadata for the same invocation; terminal values never enter `waveData`. */\n\tterminal: TerminalData;\n\tstate: CtxState;\n\t/** Release external resources on deactivation (R-cleanup-hooks). */\n\tonDeactivation(fn: () => void): void;\n\t/** Flush on INVALIDATE (R-cleanup-hooks). */\n\tonInvalidate(fn: () => void): void;\n\t/** Graph-owned environment drivers for source/adapter boundaries (D130/D131). */\n\tenvironment(): EnvironmentDrivers;\n\t/** Holder-visible context for a PULL-caused invocation (D272); absent for ordinary waves. */\n\treadonly pull?: PullDemand;\n\t/**\n\t * Deferred SELF-rewire (R-rewire-deferred / D47) — the substrate affordance higher-order\n\t * operators (switchMap/mergeMap/concatMap/exhaustMap/flatMap) use to grow/shrink their own\n\t * inner-source dep set in response to their own data. Always present; see {@link RewireNext}.\n\t */\n\trewireNext: RewireNext;\n\t/**\n\t * Deferred up — the boundary-deferred form of {@link Ctx.up} (R-up-routing / R-pull / D59). Routes\n\t * `msgs` up from this node at the COMMITTED wave boundary (broadcast, or up the single `towardDep`\n\t * edge), riding the same R-rewire-deferred (D47) drain as {@link RewireNext}. This is the\n\t * SELF-DEMAND path: a consumer issues `ctx.upNext([[PULL, { pullId, params }]])` to demand a pull\n\t * dep it ALSO reads — the cone-routed PULL reaches the pullId-holder, whose delivery loops back as a\n\t * FRESH wave (not a mid-fn re-entry → no D37). The consumer accepts one-wave latency (the\n\t * HTTP-request model). No node reference needed: the author writes the pullId verbatim.\n\t */\n\tupNext(msgs: Wave, towardDep?: number): void;\n\t/**\n\t * Read a dep's latest value by index (dynamicNode only, R-dynamic-node / D35).\n\t * Present only on dynamicNode fns; all declared deps still participate in wave\n\t * tracking. Under D49/R-resolved-undirty an unread dep's change still fires the fn,\n\t * which re-emits its (unchanged) output as a DATA occurrence — there is NO equals-\n\t * absorption; pair with distinctUntilChanged to suppress unchanged re-emits (opt-in).\n\t */\n\ttrack?(depIndex: number): unknown;\n\t[CTX_DEP_CACHE]?: CtxDepCache;\n\t[CTX_NODE_BINDING]?: CtxNodeBinding;\n}\n\n/** A node fn (R-fn-contract). Registered in a dispatcher pool, indexed by Handle. */\nexport type NodeFn = (ctx: Ctx) => void;\n\n/** Number of declared dep slots visible in this invocation. */\nexport function depCount(ctx: Ctx): number {\n\treturn ctx.waveData.length;\n}\n\n/** DATA/SENTINEL projection batches delivered by one dep in this invocation. */\nexport function depWaves(ctx: Ctx, depIndex: number): readonly (readonly unknown[])[] {\n\treturn ctx.waveData[depIndex] ?? [];\n}\n\n/** Flattened DATA projection for old event-counting operator bodies; null = no wave. */\nexport function depBatch(ctx: Ctx, depIndex: number): readonly unknown[] | null {\n\tconst waves = depWaves(ctx, depIndex);\n\tif (waves.length === 0) return null;\n\tconst flattened = waves.flat().filter((v) => v !== SENTINEL);\n\treturn flattened.length === 0 ? [] : flattened;\n}\n\n/** Latest cached DATA for a dep, derived from implementation-owned dep cache. */\nexport function depLatest(ctx: Ctx, depIndex: number): unknown {\n\treturn ctx[CTX_DEP_CACHE]?.latest[depIndex];\n}\n\n/** Terminal metadata for one dep: false = none, true = COMPLETE, otherwise ERROR payload. */\nexport function depTerminal(ctx: Ctx, depIndex: number): unknown {\n\tconst t = ctx.terminal[depIndex];\n\treturn t === undefined ? false : t;\n}\n"],"mappings":"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","names":[]}

package/dist/orchestration/messaging.d.cts

@@ -0,0 +1,59 @@
+import { DataIssue } from '../data/index.cjs';
+import { d as Graph } from '../graph-DCEWh4T2.cjs';
+import { MessageBusMessage, MessageBusCommand, MessageBusAvailablePage } from '../messaging/index.cjs';
+import { N as Node } from '../types-CcPIn7sy.cjs';
+import { ProcessCommand, ProcessStatus, ProcessEvent } from './index.cjs';
+import '../core/index.cjs';
+import '../messages-CAzUPPJM.cjs';
+import '../codec-BB7p8fJc.cjs';
+import '../describe-DYMw_l1C.cjs';
+import '../resilience-Dig3Q7n0.cjs';
+import '../agent-runtime-DZTJ3C-p.cjs';
+import '../work-item-runtime-qaVgsL0T.cjs';
+
+/**
+ * Optional orchestration-over-messageBus recipe (D349/D351/D353).
+ *
+ * Ack commands are graph-derived from visible ProcessBundle accepted/rejected
+ * material; retained delivery receipt is never an ack.
+ */
+
+interface OrchestrationMessagingPolicy<TPayload = unknown, TCommand = unknown> {
+    readonly command?: (message: MessageBusMessage<TPayload>, delivery: MessageBusDelivery) => ProcessCommand<TCommand> | undefined;
+    readonly ackRejected?: boolean;
+    readonly outboxTopic?: string;
+}
+interface OrchestrationMessagingRecipeOptions<TPayload = unknown, TCommand = unknown, TEvent = unknown> {
+    readonly name?: string;
+    readonly deliveries: Node<MessageBusAvailablePage<TPayload>>;
+    readonly status: Node<ProcessStatus>;
+    readonly events?: Node<ProcessEvent<TEvent>>;
+    readonly policy?: OrchestrationMessagingPolicy<TPayload, TCommand>;
+}
+interface OrchestrationMessagingRecipeBundle<TCommand = unknown> {
+    readonly commands: Node<ProcessCommand<TCommand>>;
+    readonly ackCommands: Node<MessageBusCommand>;
+    readonly outboxCommands?: Node<MessageBusCommand>;
+    readonly issues: Node<DataIssue>;
+}
+interface MessageBusDelivery {
+    readonly topic: string;
+    readonly seq: number;
+    readonly subscriptionId: string;
+    readonly commandId: string;
+}
+/** Build the optional D349/D351 orchestration messaging recipe. */
+declare function orchestrationMessagingRecipe<TPayload = unknown, TCommand = unknown, TEvent = unknown>(graph: Graph, opts: OrchestrationMessagingRecipeOptions<TPayload, TCommand, TEvent>): OrchestrationMessagingRecipeBundle<TCommand>;
+declare function orchestrationMessageCommand<TPayload = unknown, TCommand = unknown>(message: MessageBusMessage<TPayload>, delivery: MessageBusDelivery, policy?: OrchestrationMessagingPolicy<TPayload, TCommand>): ProcessCommand<TCommand> | undefined;
+declare function orchestrationMessageAckCommands(graph: Graph, opts: {
+    readonly name?: string;
+    readonly commands: Node<ProcessCommand>;
+    readonly status: Node<ProcessStatus>;
+    readonly issues?: Node<DataIssue>;
+    readonly ackRejected?: boolean;
+}): Node<MessageBusCommand>;
+declare function processEventOutboxCommands<TEvent>(graph: Graph, events: Node<ProcessEvent<TEvent>>, topic: string, opts?: {
+    readonly name?: string;
+}): Node<MessageBusCommand>;
+
+export { type MessageBusDelivery, type OrchestrationMessagingPolicy, type OrchestrationMessagingRecipeBundle, type OrchestrationMessagingRecipeOptions, orchestrationMessageAckCommands, orchestrationMessageCommand, orchestrationMessagingRecipe, processEventOutboxCommands };

package/dist/orchestration/messaging.d.ts

@@ -0,0 +1,59 @@
+import { DataIssue } from '../data/index.js';
+import { d as Graph } from '../graph-D-1-SQeC.js';
+import { MessageBusMessage, MessageBusCommand, MessageBusAvailablePage } from '../messaging/index.js';
+import { N as Node } from '../types-BsJvElYZ.js';
+import { ProcessCommand, ProcessStatus, ProcessEvent } from './index.js';
+import '../core/index.js';
+import '../messages-CAzUPPJM.js';
+import '../codec-BB7p8fJc.js';
+import '../describe-BpyJuWkw.js';
+import '../resilience-Dig3Q7n0.js';
+import '../agent-runtime-BesGDZcB.js';
+import '../work-item-runtime-C3M79vE9.js';
+
+/**
+ * Optional orchestration-over-messageBus recipe (D349/D351/D353).
+ *
+ * Ack commands are graph-derived from visible ProcessBundle accepted/rejected
+ * material; retained delivery receipt is never an ack.
+ */
+
+interface OrchestrationMessagingPolicy<TPayload = unknown, TCommand = unknown> {
+    readonly command?: (message: MessageBusMessage<TPayload>, delivery: MessageBusDelivery) => ProcessCommand<TCommand> | undefined;
+    readonly ackRejected?: boolean;
+    readonly outboxTopic?: string;
+}
+interface OrchestrationMessagingRecipeOptions<TPayload = unknown, TCommand = unknown, TEvent = unknown> {
+    readonly name?: string;
+    readonly deliveries: Node<MessageBusAvailablePage<TPayload>>;
+    readonly status: Node<ProcessStatus>;
+    readonly events?: Node<ProcessEvent<TEvent>>;
+    readonly policy?: OrchestrationMessagingPolicy<TPayload, TCommand>;
+}
+interface OrchestrationMessagingRecipeBundle<TCommand = unknown> {
+    readonly commands: Node<ProcessCommand<TCommand>>;
+    readonly ackCommands: Node<MessageBusCommand>;
+    readonly outboxCommands?: Node<MessageBusCommand>;
+    readonly issues: Node<DataIssue>;
+}
+interface MessageBusDelivery {
+    readonly topic: string;
+    readonly seq: number;
+    readonly subscriptionId: string;
+    readonly commandId: string;
+}
+/** Build the optional D349/D351 orchestration messaging recipe. */
+declare function orchestrationMessagingRecipe<TPayload = unknown, TCommand = unknown, TEvent = unknown>(graph: Graph, opts: OrchestrationMessagingRecipeOptions<TPayload, TCommand, TEvent>): OrchestrationMessagingRecipeBundle<TCommand>;
+declare function orchestrationMessageCommand<TPayload = unknown, TCommand = unknown>(message: MessageBusMessage<TPayload>, delivery: MessageBusDelivery, policy?: OrchestrationMessagingPolicy<TPayload, TCommand>): ProcessCommand<TCommand> | undefined;
+declare function orchestrationMessageAckCommands(graph: Graph, opts: {
+    readonly name?: string;
+    readonly commands: Node<ProcessCommand>;
+    readonly status: Node<ProcessStatus>;
+    readonly issues?: Node<DataIssue>;
+    readonly ackRejected?: boolean;
+}): Node<MessageBusCommand>;
+declare function processEventOutboxCommands<TEvent>(graph: Graph, events: Node<ProcessEvent<TEvent>>, topic: string, opts?: {
+    readonly name?: string;
+}): Node<MessageBusCommand>;
+
+export { type MessageBusDelivery, type OrchestrationMessagingPolicy, type OrchestrationMessagingRecipeBundle, type OrchestrationMessagingRecipeOptions, orchestrationMessageAckCommands, orchestrationMessageCommand, orchestrationMessagingRecipe, processEventOutboxCommands };