@graphrefly/ts 0.0.0 → 0.0.2

package/dist/messaging/index.cjs

@@ -28,11 +28,11 @@ __export(messaging_exports, {
   SPAWNS_TOPIC: () => SPAWNS_TOPIC,
   STANDARD_TOPICS: () => STANDARD_TOPICS,
   TODOS_TOPIC: () => TODOS_TOPIC,
-  dynamicHub: () => dynamicHub,
-  fromHubTopic: () => fromHubTopic,
+  eventMessage: () => eventMessage,
+  eventMessageIssue: () => eventMessageIssue,
   fromTopic: () => fromTopic,
+  isEventMessage: () => isEventMessage,
   messageBus: () => messageBus,
-  toHubTopic: () => toHubTopic,
   toTopic: () => toTopic
 });
 module.exports = __toCommonJS(messaging_exports);
@@ -51,15 +51,132 @@ function depBatch(ctx, depIndex) {
   return flattened.length === 0 ? [] : flattened;
 }
 
-// src/graph/graph.ts
-var lifecycleRegistrars = /* @__PURE__ */ new WeakMap();
-function releaseGraphNodes(graph, nodes, opts = {}) {
-  const registrar = lifecycleRegistrars.get(graph);
-  if (registrar === void 0) throw new Error("graph: unknown lifecycle registrar");
-  registrar.releaseNodes(nodes, opts);
+// src/messaging/internal.ts
+var busStates = /* @__PURE__ */ new WeakMap();
+function registerMessageBusState(bus, state) {
+  busStates.set(bus, state);
+}
+function getMessageBusState(bus) {
+  return busStates.get(bus);
+}
+function attachMessageBusCommandSource(graph, bus, commands) {
+  const state = getMessageBusState(bus);
+  if (state === void 0) throw new Error("messageBus: unknown implementation");
+  if (state.graph !== graph) throw new Error("messageBus: command source graph must match");
+  state.commandSources.push(commands);
+  const busCommands = bus.commands;
+  if (busCommands === void 0) throw new Error("messageBus: missing commands node");
+  busCommands.replaceDeps([...state.commandSources], state.commandBody);
+  let released = false;
+  return () => {
+    if (released) return;
+    released = true;
+    const index = state.commandSources.indexOf(commands);
+    if (index >= 0) state.commandSources.splice(index, 1);
+    busCommands.replaceDeps([...state.commandSources], state.commandBody);
+  };
 }
 
-// src/messaging/index.ts
+// src/messaging/utils.ts
+function pullParams(pull) {
+  return isObjectRecord(pull?.params) ? pull.params : {};
+}
+function publishCommand(commandNode, command) {
+  commandNode.down([["DATA", command]]);
+  return command;
+}
+function makeTopicState() {
+  return { closed: false, headSeq: 1, nextSeq: 1, messages: [] };
+}
+function uniqueTopics(topics) {
+  const unique = [...new Set(topics)];
+  if (unique.length !== topics.length) throw new Error("messageBus: duplicate topic");
+  for (const topic of unique) assertTopicKey(topic, "messageBus");
+  return Object.freeze(unique.sort());
+}
+function assertTopicKey(topic, owner) {
+  const error = validateTopicKey(topic, owner);
+  if (error !== void 0) throw new Error(error);
+}
+function validateTopicKey(topic, owner) {
+  if (typeof topic !== "string" || topic.length === 0)
+    return `${owner}: topic must be a non-empty string`;
+  return void 0;
+}
+function assertNonEmpty(value, owner) {
+  if (typeof value !== "string" || value.length === 0)
+    throw new Error(`${owner}: must be a non-empty string`);
+}
+function positiveLimit(limit) {
+  if (limit === void 0) return 100;
+  if (!Number.isInteger(limit) || limit < 1)
+    throw new Error("messageBus: limit must be a positive integer");
+  return limit;
+}
+function isPositiveSeq(value) {
+  return Number.isInteger(value) && value >= 1;
+}
+function isObjectRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function commandTopic(command) {
+  return isObjectRecord(command) && typeof command.topic === "string" ? command.topic : void 0;
+}
+function commandIdOf(command) {
+  return isObjectRecord(command) && typeof command.commandId === "string" ? command.commandId : void 0;
+}
+function idempotencyKey(topic, key) {
+  return `${topic}\0${key}`;
+}
+
+// src/messaging/event-message.ts
+function eventMessage(type, payload, opts) {
+  assertNonEmpty(type, "eventMessage.type");
+  assertNonEmpty(opts.id, "eventMessage.id");
+  return {
+    id: opts.id,
+    type,
+    payload,
+    ...opts.key === void 0 ? {} : { key: opts.key },
+    ...opts.subjectId === void 0 ? {} : { subjectId: opts.subjectId },
+    ...opts.correlationId === void 0 ? {} : { correlationId: opts.correlationId },
+    ...opts.causationId === void 0 ? {} : { causationId: opts.causationId },
+    ...opts.occurredAtMs === void 0 ? {} : { occurredAtMs: opts.occurredAtMs },
+    ...opts.actor === void 0 ? {} : { actor: opts.actor },
+    ...opts.evidenceRefs === void 0 ? {} : { evidenceRefs: opts.evidenceRefs },
+    ...opts.schema === void 0 ? {} : { schema: opts.schema },
+    ...opts.metadata === void 0 ? {} : { metadata: opts.metadata }
+  };
+}
+function isEventMessage(value) {
+  return eventMessageIssue(value) === void 0;
+}
+function eventMessageIssue(value) {
+  if (!isObjectRecord(value)) {
+    return eventIssue("event message must be an object");
+  }
+  if (typeof value.id !== "string" || value.id.length === 0) {
+    return eventIssue("event message id must be a non-empty string");
+  }
+  if (typeof value.type !== "string" || value.type.length === 0) {
+    return eventIssue("event message type must be a non-empty string");
+  }
+  if (!("payload" in value)) {
+    return eventIssue("event message payload field is required");
+  }
+  return void 0;
+}
+function eventIssue(message) {
+  return {
+    kind: "issue",
+    code: "malformed-event-message",
+    message,
+    severity: "error",
+    source: "messageBus.eventMessage"
+  };
+}
+
+// src/messaging/types.ts
 var PROMPTS_TOPIC = "prompts";
 var RESPONSES_TOPIC = "responses";
 var INJECTIONS_TOPIC = "injections";
@@ -76,727 +193,747 @@ var STANDARD_TOPICS = Object.freeze([
   CONTEXT_TOPIC,
   TODOS_TOPIC
 ]);
-var busStates = /* @__PURE__ */ new WeakMap();
-var dynamicHubStates = /* @__PURE__ */ new WeakMap();
-var DEFAULT_DYNAMIC_HUB_MAX_TOPICS = 1024;
-var DEFAULT_DYNAMIC_HUB_MAX_TOPIC_LENGTH = 256;
-function messageBus(graph, opts) {
-  const unique = [...new Set(opts.topics)];
-  if (unique.length !== opts.topics.length) throw new Error("messageBus: duplicate topic");
-  if (unique.length === 0) throw new Error("messageBus: at least one topic is required");
+
+// src/messaging/index.ts
+function messageBus(graph, opts = {}) {
   const name = opts.name ?? "messageBus";
-  const state = {
-    graph,
-    name,
-    now: opts.now ?? Date.now,
-    topics: Object.freeze([...unique]),
-    records: /* @__PURE__ */ new Map(),
-    seq: 0
-  };
-  for (const topic of unique) {
-    const producers = [];
-    const body = (ctx) => {
-      for (let i = 0; i < producers.length; i++) {
-        for (const produced of depBatch(ctx, i) ?? []) {
-          if (produced.kind === "publish") {
-            ctx.down([
-              [
-                "DATA",
-                produced.envelope
-              ]
-            ]);
-          }
-        }
-      }
-    };
-    const node = graph.node([], body, {
-      name: `${name}/${topic}`,
-      factory: "messageTopic",
-      meta: { topic },
-      completeWhenDepsComplete: false,
-      errorWhenDepsError: false
-    });
-    state.records.set(topic, { node, producers, body });
-  }
-  const bus = {
-    topics: state.topics,
-    topic(topic) {
-      return requireTopic(state, topic);
-    },
-    publish(topic, payload, publishOpts = {}) {
-      const node = requireTopic(state, topic);
-      const envelope = {
-        topic,
-        seq: ++state.seq,
-        payload,
-        timestampMs: state.now(),
-        ...publishOpts.key === void 0 ? {} : { key: publishOpts.key }
-      };
-      node.down([["DATA", envelope]]);
-      return envelope;
-    },
-    has(topic) {
-      return state.records.has(topic);
-    }
-  };
-  busStates.set(bus, state);
-  return bus;
-}
-function dynamicHub(graph, opts = {}) {
-  const name = opts.name ?? "dynamicHub";
-  const unknownTopic = normalizeUnknownTopicPolicy(opts.unknownTopic);
-  const maxTopics = normalizeHubLimit(
-    opts.maxTopics,
-    DEFAULT_DYNAMIC_HUB_MAX_TOPICS,
-    "dynamicHub: maxTopics"
-  );
-  const maxTopicLength = normalizeHubLimit(
-    opts.maxTopicLength,
-    DEFAULT_DYNAMIC_HUB_MAX_TOPIC_LENGTH,
-    "dynamicHub: maxTopicLength"
-  );
-  const now = opts.now ?? Date.now;
-  const initialTopics = uniqueTopics(opts.topics ?? [], maxTopicLength);
-  if (initialTopics.length > maxTopics) {
-    throw new Error("dynamicHub: topics exceed maxTopics");
-  }
+  const initialTopics = uniqueTopics(opts.topics ?? []);
   const commandSources = [];
   const commandBody = (ctx) => {
     for (let i = 0; i < commandSources.length; i++) {
-      for (const command2 of depBatch(ctx, i) ?? []) ctx.down([["DATA", command2]]);
+      for (const command of depBatch(ctx, i) ?? []) ctx.down([["DATA", command]]);
     }
   };
-  const command = graph.node([], commandBody, {
-    name: `${name}/command`,
-    factory: "dynamicHubCommand",
+  const commands = graph.node([], commandBody, {
+    name: `${name}/commands`,
+    factory: "messageBusCommands",
     completeWhenDepsComplete: false,
     errorWhenDepsError: false
   });
-  const events = graph.node(
-    [command],
+  const state = {
+    graph,
+    name,
+    now: opts.now ?? Date.now,
+    topicPolicy: opts.topicPolicy ?? "strict",
+    retention: opts.retention ?? {},
+    dedupe: opts.dedupe ?? { commandId: "status" },
+    topics: new Map(initialTopics.map((topic) => [topic, makeTopicState()])),
+    subscriptions: /* @__PURE__ */ new Map(),
+    seenCommandIds: /* @__PURE__ */ new Set(),
+    seenIdempotencyKeys: /* @__PURE__ */ new Set(),
+    deadLetters: [],
+    deadLetterSeq: 0,
+    commandSources,
+    commandBody
+  };
+  const runtime = graph.node(
+    [commands],
     (ctx) => {
-      const runtime = ctx.state.get() ?? {
-        topics: [...initialTopics],
-        open: true,
-        seq: 0,
-        cursor: 0
-      };
-      ctx.state.persist(true);
-      for (const commandFact of depBatch(ctx, 0) ?? []) {
-        const parsed = parseDynamicHubCommand(commandFact);
-        if (typeof parsed === "string") {
-          ctx.down([["DATA", hubError(runtime, commandFact, parsed, timestampOrFallback(now))]]);
-          continue;
+      for (const command of depBatch(ctx, 0) ?? []) {
+        for (const event of reduceMessageBusCommand(state, command)) {
+          ctx.down([["DATA", event]]);
         }
-        const reduced = reduceDynamicHubCommand(
-          runtime,
-          parsed,
-          unknownTopic,
-          maxTopics,
-          maxTopicLength,
-          now
-        );
-        for (const event of reduced) ctx.down([["DATA", event]]);
       }
-      ctx.state.set(runtime);
     },
     {
-      name: `${name}/events`,
-      factory: "dynamicHubEvents",
-      meta: { unknownTopic },
+      name: `${name}/runtime`,
+      factory: "messageBusRuntime",
       completeWhenDepsComplete: false,
       errorWhenDepsError: false
     }
   );
-  const status = graph.node(
-    [events],
+  graph.retain(runtime, { reason: `${name}.messageBus.runtime` });
+  const messages = graph.node(
+    [runtime],
     (ctx) => {
       for (const event of depBatch(ctx, 0) ?? []) {
         const typed = event;
-        ctx.down([["DATA", typed.status]]);
+        if (typed.kind === "message") ctx.down([["DATA", typed.message]]);
       }
     },
     {
-      name: `${name}/status`,
-      factory: "dynamicHubStatus",
+      name: `${name}/messages`,
+      factory: "messageBusMessages",
       completeWhenDepsComplete: false,
       errorWhenDepsError: false
     }
   );
-  const errors = graph.node(
-    [events],
+  const status = graph.node(
+    [runtime],
     (ctx) => {
       for (const event of depBatch(ctx, 0) ?? []) {
         const typed = event;
-        if (typed.kind !== "error") continue;
-        ctx.down([
-          [
-            "DATA",
-            {
-              ...typed.topic === void 0 ? {} : { topic: typed.topic },
-              error: typed.error,
-              command: typed.command,
-              meta: typed.meta
-            }
-          ]
-        ]);
+        if (typed.kind === "status") ctx.down([["DATA", typed.status]]);
       }
     },
     {
-      name: `${name}/errors`,
-      factory: "dynamicHubErrors",
+      name: `${name}/status`,
+      factory: "messageBusStatus",
       completeWhenDepsComplete: false,
       errorWhenDepsError: false
     }
   );
-  const deadLetter = opts.deadLetter === true || unknownTopic === "dead-letter" ? graph.node(
-    [events],
+  const issues = graph.node(
+    [runtime],
     (ctx) => {
       for (const event of depBatch(ctx, 0) ?? []) {
         const typed = event;
-        if (typed.kind !== "dead-letter") continue;
-        ctx.down([
-          [
-            "DATA",
-            {
-              ...typed.topic === void 0 ? {} : { topic: typed.topic },
-              reason: typed.reason,
-              command: typed.command,
-              meta: typed.meta
-            }
-          ]
-        ]);
+        if (typed.kind === "issue") ctx.down([["DATA", typed.issue]]);
       }
     },
     {
-      name: `${name}/deadLetter`,
-      factory: "dynamicHubDeadLetter",
+      name: `${name}/issues`,
+      factory: "messageBusIssues",
       completeWhenDepsComplete: false,
       errorWhenDepsError: false
     }
-  ) : void 0;
-  const releaseEventsRetain = graph.retain(events, { reason: `${name}.dynamicHub.events` });
-  const hub = {
-    command,
-    events,
+  );
+  const bus = {
+    commands,
+    messages,
     status,
-    errors,
-    ...deadLetter === void 0 ? {} : { deadLetter },
-    create(topic, commandOpts = {}) {
-      return publishHubCommand(command, {
-        kind: "create",
+    issues,
+    ensureTopic(topic, commandOpts = {}) {
+      return publishCommand(commands, {
+        kind: "ensure-topic",
         topic,
-        ...commandOpts.key === void 0 ? {} : { key: commandOpts.key },
-        ...commandOpts.payload === void 0 ? {} : { payload: commandOpts.payload }
+        ...commandOpts.commandId === void 0 ? {} : { commandId: commandOpts.commandId }
       });
     },
-    delete(topic, commandOpts = {}) {
-      return publishHubCommand(command, {
-        kind: "delete",
+    closeTopic(topic, commandOpts = {}) {
+      return publishCommand(commands, {
+        kind: "close-topic",
         topic,
-        ...commandOpts.key === void 0 ? {} : { key: commandOpts.key },
-        ...commandOpts.payload === void 0 ? {} : { payload: commandOpts.payload }
+        ...commandOpts.commandId === void 0 ? {} : { commandId: commandOpts.commandId }
       });
     },
-    publish(topic, payload, commandOpts = {}) {
-      return publishHubCommand(command, {
+    publish(topic, payload, publishOpts = {}) {
+      return publishCommand(commands, {
         kind: "publish",
         topic,
         payload,
-        ...commandOpts.key === void 0 ? {} : { key: commandOpts.key }
+        ...publishOpts.key === void 0 ? {} : { key: publishOpts.key },
+        ...publishOpts.commandId === void 0 ? {} : { commandId: publishOpts.commandId },
+        ...publishOpts.idempotencyKey === void 0 ? {} : { idempotencyKey: publishOpts.idempotencyKey }
       });
     },
-    subscribeTopic(topic, commandOpts = {}) {
-      return publishHubCommand(command, {
-        kind: "subscribe",
-        topic,
-        ...commandOpts.key === void 0 ? {} : { key: commandOpts.key },
-        ...commandOpts.payload === void 0 ? {} : { payload: commandOpts.payload }
-      });
+    topic(topic, projectionOpts = {}) {
+      assertTopicKey(topic, "messageBus.topic");
+      const snapshotPullId = /* @__PURE__ */ Symbol(`${name}/${topic}/topicSnapshot`);
+      const snapshot = graph.node(
+        [messages],
+        (ctx) => {
+          const params = pullParams(ctx.pull);
+          ctx.down([["DATA", topicPage(state, topic, params)]]);
+        },
+        {
+          name: projectionOpts.name ?? `${name}/${topic}/topic`,
+          factory: "messageBusTopicProjection",
+          meta: { topic },
+          pullId: snapshotPullId,
+          partial: true,
+          completeWhenDepsComplete: false,
+          errorWhenDepsError: false
+        }
+      );
+      return { snapshot, snapshotPullId, status, issues };
+    },
+    catalog(projectionOpts = {}) {
+      const snapshotPullId = /* @__PURE__ */ Symbol(`${name}/catalogSnapshot`);
+      const snapshot = graph.node(
+        [runtime],
+        (ctx) => {
+          const params = pullParams(ctx.pull);
+          ctx.down([["DATA", catalogPage(state, params)]]);
+        },
+        {
+          name: projectionOpts.name ?? `${name}/catalog`,
+          factory: "messageBusCatalog",
+          pullId: snapshotPullId,
+          partial: true,
+          completeWhenDepsComplete: false,
+          errorWhenDepsError: false
+        }
+      );
+      return { snapshot, snapshotPullId, status, issues };
+    },
+    deadLetter(projectionOpts = {}) {
+      const snapshotPullId = /* @__PURE__ */ Symbol(`${name}/deadLetterSnapshot`);
+      const snapshot = graph.node(
+        [runtime],
+        (ctx) => {
+          const params = pullParams(ctx.pull);
+          ctx.down([["DATA", deadLetterPage(state, params)]]);
+        },
+        {
+          name: projectionOpts.name ?? `${name}/deadLetter`,
+          factory: "messageBusDeadLetter",
+          pullId: snapshotPullId,
+          partial: true,
+          completeWhenDepsComplete: false,
+          errorWhenDepsError: false
+        }
+      );
+      return { snapshot, snapshotPullId, status, issues };
     },
-    close(commandOpts = {}) {
-      return publishHubCommand(command, {
-        kind: "close",
-        ...commandOpts.key === void 0 ? {} : { key: commandOpts.key },
-        ...commandOpts.payload === void 0 ? {} : { payload: commandOpts.payload }
+    subscription(subscriptionOpts) {
+      assertTopicKey(subscriptionOpts.topic, "messageBus.subscription");
+      assertNonEmpty(subscriptionOpts.subscriptionId, "messageBus.subscriptionId");
+      const sub = ensureSubscription(state, {
+        topic: subscriptionOpts.topic,
+        subscriptionId: subscriptionOpts.subscriptionId,
+        from: subscriptionOpts.from ?? "earliest"
       });
+      const availablePullId = /* @__PURE__ */ Symbol(
+        `${name}/${subscriptionOpts.topic}/${subscriptionOpts.subscriptionId}/available`
+      );
+      const projectionName = subscriptionOpts.name ?? `${name}/${subscriptionOpts.topic}/${subscriptionOpts.subscriptionId}`;
+      const available = graph.node(
+        [messages, status],
+        (ctx) => {
+          const params = pullParams(ctx.pull);
+          ctx.down([["DATA", availablePage(state, sub, params)]]);
+        },
+        {
+          name: `${projectionName}/available`,
+          factory: "messageBusSubscriptionAvailable",
+          meta: { topic: subscriptionOpts.topic, subscriptionId: subscriptionOpts.subscriptionId },
+          pullId: availablePullId,
+          partial: true,
+          completeWhenDepsComplete: false,
+          errorWhenDepsError: false
+        }
+      );
+      const cursor = graph.node(
+        [status],
+        (ctx) => {
+          for (const fact of depBatch(ctx, 0) ?? []) {
+            const typed = fact;
+            const subscriptionMoved = typed.topic === sub.topic && typed.subscriptionId === sub.subscriptionId && (typed.kind === "subscription-acked" || typed.kind === "subscription-sought" || typed.kind === "subscription-closed");
+            const retentionMoved = typed.topic === sub.topic && typed.kind === "retention-trimmed";
+            if (subscriptionMoved || retentionMoved) {
+              ctx.down([["DATA", cursorSnapshot(state, sub)]]);
+            }
+          }
+        },
+        {
+          name: `${projectionName}/cursor`,
+          factory: "messageBusSubscriptionCursor",
+          completeWhenDepsComplete: false,
+          errorWhenDepsError: false
+        }
+      );
+      return {
+        available,
+        availablePullId,
+        cursor,
+        status,
+        issues,
+        ack(seq, commandOpts = {}) {
+          return publishCommand(commands, {
+            kind: "ack",
+            topic: sub.topic,
+            subscriptionId: sub.subscriptionId,
+            seq,
+            ...commandOpts.commandId === void 0 ? {} : { commandId: commandOpts.commandId }
+          });
+        },
+        seek(nextSeq, commandOpts = {}) {
+          return publishCommand(commands, {
+            kind: "seek",
+            topic: sub.topic,
+            subscriptionId: sub.subscriptionId,
+            nextSeq,
+            ...commandOpts.commandId === void 0 ? {} : { commandId: commandOpts.commandId }
+          });
+        },
+        close(commandOpts = {}) {
+          return publishCommand(commands, {
+            kind: "close-subscription",
+            topic: sub.topic,
+            subscriptionId: sub.subscriptionId,
+            ...commandOpts.commandId === void 0 ? {} : { commandId: commandOpts.commandId }
+          });
+        }
+      };
     }
   };
-  dynamicHubStates.set(hub, {
-    graph,
-    name,
-    maxTopicLength,
-    commandSources,
-    commandBody,
-    releaseEventsRetain
-  });
-  return hub;
+  registerMessageBusState(bus, state);
+  return bus;
+}
+function fromTopic(bus, topic) {
+  return bus.topic(topic).snapshot;
 }
-function fromHubTopic(hub, topic, opts = {}) {
-  const state = requireDynamicHubState(hub);
-  assertTopicKey(topic, "fromHubTopic", state.maxTopicLength);
-  return state.graph.node(
-    [hub.events],
+function toTopic(graph, source, bus, topic, opts = {}) {
+  const state = getMessageBusState(bus);
+  if (state === void 0) throw new Error("toTopic: unknown message bus implementation");
+  if (state.graph !== graph) throw new Error("toTopic: bus and source graph must match");
+  assertTopicKey(topic, "toTopic");
+  const commands = graph.node(
+    [source],
     (ctx) => {
-      for (const event of depBatch(ctx, 0) ?? []) {
-        const typed = event;
-        if (typed.kind !== "message" || typed.topic !== topic) continue;
+      for (const value of depBatch(ctx, 0) ?? []) {
+        const key = opts.keyOf?.(value);
+        const commandId = opts.commandIdOf?.(value);
         ctx.down([
           [
             "DATA",
             {
+              kind: "publish",
               topic,
-              seq: typed.meta.seq,
-              payload: typed.payload,
-              timestampMs: typed.meta.timestampMs,
-              ...typed.key === void 0 ? {} : { key: typed.key }
+              payload: value,
+              ...key === void 0 ? {} : { key },
+              ...commandId === void 0 ? {} : { commandId }
             }
           ]
         ]);
       }
     },
     {
-      name: opts.name ?? `${state.name}/${topic}/fromHubTopic`,
-      factory: "fromHubTopic",
+      name: opts.name ?? `${state.name}/${topic}/toTopic`,
+      factory: "toTopic",
       meta: { topic },
       completeWhenDepsComplete: false,
       errorWhenDepsError: false
     }
   );
+  const releaseSource = attachMessageBusCommandSource(
+    graph,
+    bus,
+    commands
+  );
+  let released = false;
+  return {
+    commands,
+    release() {
+      if (released) return;
+      released = true;
+      releaseSource();
+    }
+  };
 }
-function toHubTopic(graph, source, hub, topic, opts = {}) {
-  const state = requireDynamicHubState(hub);
-  assertTopicKey(topic, "toHubTopic", state.maxTopicLength);
-  if (state.graph !== graph) throw new Error("toHubTopic: hub and source graph must match");
-  if (isReachableUpstream(source, hub.command)) {
-    throw new Error("toHubTopic: source already depends on hub command path");
-  }
-  const commands = graph.node(
-    [source],
-    (ctx) => {
-      for (const value of depBatch(ctx, 0) ?? []) {
-        try {
-          const key = opts.keyOf?.(value);
-          ctx.down([
-            [
-              "DATA",
-              {
-                kind: "publish",
-                topic,
-                payload: value,
-                ...key === void 0 ? {} : { key }
-              }
-            ]
-          ]);
-        } catch (error) {
-          ctx.down([
-            [
-              "DATA",
-              {
-                kind: "invalid",
-                topic,
-                error: error instanceof Error ? error.message : String(error)
-              }
-            ]
-          ]);
-        }
-      }
-    },
-    {
-      name: opts.name ?? `${state.name}/${topic}/toHubTopic`,
-      factory: "toHubTopic",
-      meta: { topic },
-      completeWhenDepsComplete: false,
-      errorWhenDepsError: false
+function reduceMessageBusCommand(state, command) {
+  const malformed = validateCommand(command);
+  if (malformed !== void 0) return rejectCommand(state, command, malformed);
+  if (command.commandId !== void 0) {
+    if (state.seenCommandIds.has(command.commandId)) {
+      return duplicateCommandEvents(state, command, "duplicate commandId");
     }
-  );
-  const commandSource = commands;
-  state.commandSources.push(commandSource);
-  try {
-    hub.command.replaceDeps([...state.commandSources], state.commandBody);
-  } catch (error) {
-    state.commandSources.splice(state.commandSources.indexOf(commandSource), 1);
-    releaseGraphNodes(graph, [commands], {
-      reason: "toHubTopic failed command wiring"
-    });
-    throw error;
+    state.seenCommandIds.add(command.commandId);
   }
-  return { commands };
-}
-function fromTopic(bus, topic) {
-  return bus.topic(topic);
-}
-function toTopic(graph, source, bus, topic, opts = {}) {
-  const state = busStates.get(bus);
-  if (state === void 0) throw new Error("toTopic: unknown message bus implementation");
-  if (state.graph !== graph) throw new Error("toTopic: bus and source graph must match");
-  const record = requireTopicRecord(state, topic);
-  const name = opts.name ?? `toTopic/${topic}`;
-  const producer = graph.node(
-    [source],
-    (ctx) => {
-      for (const value of depBatch(ctx, 0) ?? []) {
-        try {
-          const key = opts.keyOf?.(value);
-          const envelope = {
-            topic,
-            seq: ++state.seq,
-            payload: value,
-            timestampMs: state.now(),
-            ...key === void 0 ? {} : { key }
-          };
-          ctx.down([
-            [
-              "DATA",
-              {
-                kind: "publish",
-                envelope
-              }
-            ]
-          ]);
-        } catch (error) {
-          ctx.down([["DATA", { kind: "error", topic, error }]]);
-        }
+  if (command.kind === "publish" && command.idempotencyKey !== void 0 && state.seenIdempotencyKeys.has(idempotencyKey(command.topic, command.idempotencyKey))) {
+    return duplicateCommandEvents(state, command, "duplicate idempotencyKey");
+  }
+  switch (command.kind) {
+    case "ensure-topic":
+      return ensureTopic(state, command.topic, command.commandId);
+    case "close-topic": {
+      const topic = state.topics.get(command.topic);
+      if (topic === void 0) {
+        return issueEvents(state, command, "unknown-topic", `unknown topic '${command.topic}'`);
       }
-    },
-    {
-      name,
-      factory: "toTopic",
-      meta: { topic },
-      completeWhenDepsComplete: false,
-      errorWhenDepsError: false
-    }
-  );
-  record.producers.push(producer);
-  record.node.replaceDeps([...record.producers], record.body);
-  const events = graph.node(
-    [producer, source],
-    (ctx) => {
-      for (const produced of depBatch(ctx, 0) ?? []) {
-        const typed = produced;
-        if (typed.kind === "publish") {
-          ctx.down([
-            [
-              "DATA",
-              {
-                kind: "publish",
-                topic,
-                seq: typed.envelope.seq,
-                payload: typed.envelope.payload
-              }
-            ]
-          ]);
-        } else {
-          ctx.down([
-            ["DATA", { kind: "error", topic, error: typed.error }]
-          ]);
+      topic.closed = true;
+      return [
+        {
+          kind: "status",
+          status: statusFact(state, "topic-closed", {
+            topic: command.topic,
+            commandId: command.commandId
+          })
         }
-      }
-      const terminal = ctx.terminal[0];
-      if (terminal !== false && terminal !== void 0 && terminal !== true) {
-        ctx.down([
-          ["DATA", { kind: "error", topic, error: terminal }]
-        ]);
-      }
-      const sourceTerminal = ctx.terminal[1];
-      if (sourceTerminal === true) {
-        ctx.down([["DATA", { kind: "complete", topic }]]);
-      } else if (sourceTerminal !== false && sourceTerminal !== void 0) {
-        ctx.down([
-          ["DATA", { kind: "error", topic, error: sourceTerminal }]
-        ]);
-      }
-    },
-    {
-      name: `${name}/events`,
-      factory: "toTopicEvents",
-      meta: { topic },
-      completeWhenDepsComplete: false,
-      errorWhenDepsError: false,
-      terminalAsRealInput: true
+      ];
     }
-  );
-  return { events };
-}
-function requireTopic(state, topic) {
-  return requireTopicRecord(state, topic).node;
-}
-function requireTopicRecord(state, topic) {
-  const record = state.records.get(topic);
-  if (record === void 0) throw new Error(`messageBus: unknown topic '${topic}'`);
-  return record;
-}
-function uniqueTopics(topics, maxTopicLength) {
-  const unique = [...new Set(topics)];
-  if (unique.length !== topics.length) throw new Error("dynamicHub: duplicate topic");
-  for (const topic of unique) assertTopicKey(topic, "dynamicHub", maxTopicLength);
-  return Object.freeze(unique.sort());
-}
-function normalizeUnknownTopicPolicy(policy) {
-  if (policy === void 0) return "error";
-  if (policy === "drop" || policy === "error" || policy === "dead-letter" || policy === "create-as-fact") {
-    return policy;
-  }
-  throw new Error("dynamicHub: unknownTopic policy is not recognized");
-}
-function normalizeHubLimit(value, fallback, owner) {
-  if (value === void 0) return fallback;
-  if (!Number.isInteger(value) || value < 1) {
-    throw new Error(`${owner} must be a positive integer`);
+    case "topic-policy":
+      state.topicPolicy = command.topicPolicy;
+      return [
+        {
+          kind: "status",
+          status: statusFact(state, "projection-ready", {
+            commandId: command.commandId,
+            details: { topicPolicy: command.topicPolicy }
+          })
+        }
+      ];
+    case "publish":
+      return publishMessage(state, command);
+    case "ack":
+      return ackSubscription(state, command);
+    case "seek":
+      return seekSubscription(state, command);
+    case "close-subscription":
+      return closeSubscription(state, command);
   }
-  return value;
-}
-function publishHubCommand(commandNode, command) {
-  commandNode.down([["DATA", command]]);
-  return command;
 }
-function parseDynamicHubCommand(value) {
-  if (!isObjectRecord(value)) return "dynamicHub: command fact must be an object";
-  const kind = value.kind;
-  if (kind !== "create" && kind !== "delete" && kind !== "publish" && kind !== "subscribe" && kind !== "close") {
-    return "dynamicHub: command kind is not recognized";
-  }
-  if (kind === "close") {
-    return {
-      kind,
-      ...typeof value.key === "string" ? { key: value.key } : {},
-      ...value.payload === void 0 ? {} : { payload: value.payload }
-    };
-  }
-  const topic = value.topic;
-  if (typeof topic !== "string" || topic.length === 0) {
-    return "dynamicHub: command topic must be a non-empty string";
-  }
-  if (kind === "publish") {
-    if (value.payload === void 0) return "dynamicHub: publish command payload is required";
-    return {
-      kind,
-      topic,
-      payload: value.payload,
-      ...typeof value.key === "string" ? { key: value.key } : {}
-    };
+function publishMessage(state, command) {
+  let topic = state.topics.get(command.topic);
+  const events = [];
+  if (topic === void 0) {
+    if (state.topicPolicy !== "create-as-fact") {
+      return issueEvents(state, command, "unknown-topic", `unknown topic '${command.topic}'`);
+    }
+    events.push(...ensureTopic(state, command.topic, command.commandId));
+    topic = state.topics.get(command.topic);
   }
-  return {
-    kind,
-    topic,
-    ...typeof value.key === "string" ? { key: value.key } : {},
-    ...value.payload === void 0 ? {} : { payload: value.payload }
+  if (topic === void 0)
+    return issueEvents(state, command, "unknown-topic", `unknown topic '${command.topic}'`);
+  if (topic.closed)
+    return issueEvents(state, command, "closed-topic", `closed topic '${command.topic}'`);
+  const message = {
+    topic: command.topic,
+    seq: topic.nextSeq++,
+    payload: command.payload,
+    timestampMs: state.now(),
+    ...command.key === void 0 ? {} : { key: command.key },
+    ...command.idempotencyKey === void 0 ? {} : { idempotencyKey: command.idempotencyKey },
+    ...command.commandId === void 0 ? {} : { commandId: command.commandId }
   };
-}
-function isObjectRecord(value) {
-  return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-function readHubTimestamp(now) {
-  try {
-    const timestampMs = now();
-    return Number.isFinite(timestampMs) ? timestampMs : "dynamicHub: now() must return a finite number";
-  } catch (error) {
-    return `dynamicHub: now() threw: ${error instanceof Error ? error.message : String(error)}`;
+  if (command.idempotencyKey !== void 0) {
+    state.seenIdempotencyKeys.add(idempotencyKey(command.topic, command.idempotencyKey));
   }
+  topic.messages.push(message);
+  events.push({ kind: "message", message });
+  events.push({
+    kind: "status",
+    status: statusFact(state, "message-published", {
+      topic: command.topic,
+      seq: message.seq,
+      commandId: command.commandId
+    })
+  });
+  events.push(...trimRetention(state, command.topic, topic));
+  return events;
 }
-function timestampOrFallback(now) {
-  const timestampMs = readHubTimestamp(now);
-  return typeof timestampMs === "number" ? timestampMs : Date.now();
-}
-function reduceDynamicHubCommand(runtime, command, unknownTopic, maxTopics, maxTopicLength, now) {
-  const topic = "topic" in command ? command.topic : void 0;
-  if (topic !== void 0) {
-    const topicError = validateTopicKey(topic, "dynamicHub", maxTopicLength);
-    if (topicError !== void 0) {
-      return [hubError(runtime, command, topicError, timestampOrFallback(now))];
+function ensureTopic(state, topic, commandId) {
+  assertTopicKey(topic, "messageBus");
+  if (!state.topics.has(topic)) state.topics.set(topic, makeTopicState());
+  return [
+    {
+      kind: "status",
+      status: statusFact(state, "topic-created", { topic, commandId })
     }
+  ];
+}
+function trimRetention(state, topicName, topic) {
+  const max = state.retention.maxMessages;
+  if (max === void 0 || topic.messages.length <= max) return [];
+  if (!Number.isInteger(max) || max < 1) {
+    return issueEvents(
+      state,
+      { kind: "publish", topic: topicName, payload: void 0 },
+      "policy-rejected",
+      "retention.maxMessages must be a positive integer"
+    );
   }
-  if (!runtime.open && command.kind !== "close") {
-    return [hubError(runtime, command, "dynamicHub: hub is closed", timestampOrFallback(now))];
-  }
-  switch (command.kind) {
-    case "create": {
-      const capacityError = canAddHubTopic(runtime, command.topic, maxTopics);
-      if (capacityError !== void 0) {
-        return [hubError(runtime, command, capacityError, timestampOrFallback(now))];
-      }
-      const timestampMs = readHubTimestamp(now);
-      if (typeof timestampMs === "string")
-        return [hubError(runtime, command, timestampMs, Date.now())];
-      addHubTopic(runtime, command.topic);
-      return [hubEvent(runtime, timestampMs, command)];
+  const trimCount = topic.messages.length - max;
+  topic.messages.splice(0, trimCount);
+  topic.headSeq = topic.messages[0]?.seq ?? topic.nextSeq;
+  const events = [
+    {
+      kind: "status",
+      status: statusFact(state, "retention-trimmed", {
+        topic: topicName,
+        headSeq: topic.headSeq,
+        details: { trimCount }
+      })
     }
-    case "delete": {
-      if (!hasHubTopic(runtime, command.topic)) {
-        return unknownHubTopic(runtime, command, unknownTopic, now);
-      }
-      const timestampMs = readHubTimestamp(now);
-      if (typeof timestampMs === "string")
-        return [hubError(runtime, command, timestampMs, Date.now())];
-      deleteHubTopic(runtime, command.topic);
-      return [hubEvent(runtime, timestampMs, command)];
+  ];
+  for (const sub of state.subscriptions.values()) {
+    if (sub.closed || sub.topic !== topicName || sub.nextSeq >= topic.headSeq) continue;
+    sub.retentionGap = true;
+    events.push(
+      ...issueEvents(
+        state,
+        {
+          kind: "seek",
+          topic: topicName,
+          subscriptionId: sub.subscriptionId,
+          nextSeq: sub.nextSeq
+        },
+        "retention-gap",
+        `subscription '${sub.subscriptionId}' is before retained headSeq`
+      )
+    );
+  }
+  return events;
+}
+function ackSubscription(state, command) {
+  const topic = state.topics.get(command.topic);
+  if (topic === void 0)
+    return issueEvents(state, command, "unknown-topic", `unknown topic '${command.topic}'`);
+  const sub = getSubscription(state, command.topic, command.subscriptionId);
+  if (sub === void 0)
+    return issueEvents(
+      state,
+      command,
+      "unknown-subscription",
+      `unknown subscription '${command.subscriptionId}'`
+    );
+  if (sub.closed)
+    return issueEvents(state, command, "subscription-closed", "subscription is closed");
+  if (sub.retentionGap)
+    return issueEvents(state, command, "retention-gap", "subscription must seek before ack");
+  if (command.seq < sub.nextSeq)
+    return issueEvents(state, command, "source-cursor-stale", "ack is behind subscription cursor");
+  if (command.seq >= topic.nextSeq)
+    return issueEvents(state, command, "cursor-out-of-range", "ack is beyond topic tail");
+  sub.nextSeq = Math.max(sub.nextSeq, command.seq + 1);
+  return [
+    {
+      kind: "status",
+      status: statusFact(state, "subscription-acked", {
+        topic: command.topic,
+        subscriptionId: command.subscriptionId,
+        nextSeq: sub.nextSeq,
+        commandId: command.commandId
+      })
     }
-    case "publish": {
-      if (!hasHubTopic(runtime, command.topic)) {
-        if (unknownTopic === "create-as-fact") {
-          const capacityError = canAddHubTopic(runtime, command.topic, maxTopics);
-          if (capacityError !== void 0) {
-            return [hubError(runtime, command, capacityError, timestampOrFallback(now))];
-          }
-          const createTimestampMs = readHubTimestamp(now);
-          if (typeof createTimestampMs === "string") {
-            return [hubError(runtime, command, createTimestampMs, Date.now())];
-          }
-          const messageTimestampMs = readHubTimestamp(now);
-          if (typeof messageTimestampMs === "string") {
-            return [hubError(runtime, command, messageTimestampMs, Date.now())];
-          }
-          addHubTopic(runtime, command.topic);
-          return [
-            hubEvent(runtime, createTimestampMs, { kind: "create", topic: command.topic }),
-            hubEvent(runtime, messageTimestampMs, {
-              kind: "message",
-              topic: command.topic,
-              payload: command.payload,
-              ...command.key === void 0 ? {} : { key: command.key }
-            })
-          ];
-        }
-        return unknownHubTopic(runtime, command, unknownTopic, now);
-      }
-      const timestampMs = readHubTimestamp(now);
-      if (typeof timestampMs === "string")
-        return [hubError(runtime, command, timestampMs, Date.now())];
-      return [
-        hubEvent(runtime, timestampMs, {
-          kind: "message",
-          topic: command.topic,
-          payload: command.payload,
-          ...command.key === void 0 ? {} : { key: command.key }
-        })
-      ];
+  ];
+}
+function seekSubscription(state, command) {
+  const topic = state.topics.get(command.topic);
+  if (topic === void 0)
+    return issueEvents(state, command, "unknown-topic", `unknown topic '${command.topic}'`);
+  const sub = getSubscription(state, command.topic, command.subscriptionId);
+  if (sub === void 0)
+    return issueEvents(
+      state,
+      command,
+      "unknown-subscription",
+      `unknown subscription '${command.subscriptionId}'`
+    );
+  if (sub.closed)
+    return issueEvents(state, command, "subscription-closed", "subscription is closed");
+  if (command.nextSeq < topic.headSeq)
+    return issueEvents(state, command, "retention-gap", "seek is before retained headSeq");
+  if (command.nextSeq > topic.nextSeq)
+    return issueEvents(state, command, "cursor-out-of-range", "seek is beyond topic tail");
+  sub.nextSeq = command.nextSeq;
+  sub.retentionGap = false;
+  return [
+    {
+      kind: "status",
+      status: statusFact(state, "subscription-sought", {
+        topic: command.topic,
+        subscriptionId: command.subscriptionId,
+        nextSeq: sub.nextSeq,
+        commandId: command.commandId
+      })
     }
-    case "subscribe": {
-      if (!hasHubTopic(runtime, command.topic)) {
-        if (unknownTopic === "create-as-fact") {
-          const capacityError = canAddHubTopic(runtime, command.topic, maxTopics);
-          if (capacityError !== void 0) {
-            return [hubError(runtime, command, capacityError, timestampOrFallback(now))];
-          }
-          const createTimestampMs = readHubTimestamp(now);
-          if (typeof createTimestampMs === "string") {
-            return [hubError(runtime, command, createTimestampMs, Date.now())];
-          }
-          const subscribeTimestampMs = readHubTimestamp(now);
-          if (typeof subscribeTimestampMs === "string") {
-            return [hubError(runtime, command, subscribeTimestampMs, Date.now())];
-          }
-          addHubTopic(runtime, command.topic);
-          return [
-            hubEvent(runtime, createTimestampMs, { kind: "create", topic: command.topic }),
-            hubEvent(runtime, subscribeTimestampMs, command)
-          ];
-        }
-        return unknownHubTopic(runtime, command, unknownTopic, now);
-      }
-      const timestampMs = readHubTimestamp(now);
-      if (typeof timestampMs === "string")
-        return [hubError(runtime, command, timestampMs, Date.now())];
-      return [hubEvent(runtime, timestampMs, command)];
+  ];
+}
+function closeSubscription(state, command) {
+  if (!state.topics.has(command.topic))
+    return issueEvents(state, command, "unknown-topic", `unknown topic '${command.topic}'`);
+  const sub = getSubscription(state, command.topic, command.subscriptionId);
+  if (sub === void 0)
+    return issueEvents(
+      state,
+      command,
+      "unknown-subscription",
+      `unknown subscription '${command.subscriptionId}'`
+    );
+  sub.closed = true;
+  return [
+    {
+      kind: "status",
+      status: statusFact(state, "subscription-closed", {
+        topic: command.topic,
+        subscriptionId: command.subscriptionId,
+        nextSeq: sub.nextSeq,
+        commandId: command.commandId
+      })
     }
-    case "close": {
-      const timestampMs = readHubTimestamp(now);
-      if (typeof timestampMs === "string")
-        return [hubError(runtime, command, timestampMs, Date.now())];
-      runtime.open = false;
-      return [hubEvent(runtime, timestampMs, command)];
+  ];
+}
+function issueEvents(state, command, code, message) {
+  const topic = commandTopic(command);
+  const commandId = commandIdOf(command);
+  const issue = {
+    kind: "issue",
+    code,
+    message,
+    severity: "error",
+    source: "messageBus",
+    details: command,
+    metadata: topic === void 0 ? void 0 : { topic }
+  };
+  const entry = {
+    entrySeq: ++state.deadLetterSeq,
+    ...topic === void 0 ? {} : { topic },
+    ...isObjectRecord(command) ? { command } : {},
+    issue,
+    timestampMs: state.now()
+  };
+  state.deadLetters.push(entry);
+  return [
+    { kind: "issue", issue },
+    { kind: "dead-letter", entry },
+    {
+      kind: "status",
+      status: statusFact(state, "command-rejected", {
+        topic,
+        commandId,
+        issueCode: code
+      })
     }
-  }
+  ];
 }
-function hubEvent(runtime, timestampMs, event) {
-  const meta = nextHubMetadata(runtime, timestampMs);
-  return {
-    ...event,
-    meta,
-    status: snapshotHubStatus(runtime, meta, event.kind)
-  };
+function rejectCommand(state, command, reason) {
+  return issueEvents(state, command, "malformed-command", reason);
 }
-function hubError(runtime, command, error, timestampMs) {
-  return hubEvent(runtime, timestampMs, {
-    kind: "error",
-    ...isObjectRecord(command) && typeof command.topic === "string" ? { topic: command.topic } : {},
-    error,
-    command
+function duplicateCommandEvents(state, command, message) {
+  const status = statusFact(state, "duplicate-command", {
+    topic: "topic" in command ? command.topic : void 0,
+    commandId: command.commandId
   });
-}
-function unknownHubTopic(runtime, command, policy, now) {
-  const topic = "topic" in command ? command.topic : void 0;
-  const reason = `dynamicHub: unknown topic '${topic ?? ""}'`;
-  if (policy === "drop") return [];
-  if (policy === "dead-letter") {
+  if (state.dedupe.commandId === "issue") {
     return [
-      hubEvent(runtime, timestampOrFallback(now), {
-        kind: "dead-letter",
-        ...topic === void 0 ? {} : { topic },
-        reason,
-        command
-      })
+      { kind: "status", status },
+      ...issueEvents(state, command, "duplicate-command", message)
     ];
   }
-  return [hubError(runtime, command, reason, timestampOrFallback(now))];
+  return [{ kind: "status", status }];
 }
-function nextHubMetadata(runtime, timestampMs) {
-  runtime.seq += 1;
-  runtime.cursor = runtime.seq;
-  return { seq: runtime.seq, cursor: runtime.cursor, timestampMs };
-}
-function snapshotHubStatus(runtime, meta, kind) {
+function statusFact(state, kind, fields) {
   return {
-    open: runtime.open,
-    topics: Object.freeze([...runtime.topics].sort()),
-    seq: meta.seq,
-    cursor: meta.cursor,
-    lastEventKind: kind
+    kind,
+    timestampMs: state.now(),
+    ...fields.topic === void 0 ? {} : { topic: fields.topic },
+    ...fields.seq === void 0 ? {} : { seq: fields.seq },
+    ...fields.headSeq === void 0 ? {} : { headSeq: fields.headSeq },
+    ...fields.subscriptionId === void 0 ? {} : { subscriptionId: fields.subscriptionId },
+    ...fields.nextSeq === void 0 ? {} : { nextSeq: fields.nextSeq },
+    ...fields.commandId === void 0 ? {} : { commandId: fields.commandId },
+    ...fields.issueCode === void 0 ? {} : { issueCode: fields.issueCode },
+    ...fields.details === void 0 ? {} : { details: fields.details }
   };
 }
-function assertTopicKey(topic, owner, maxTopicLength) {
-  const error = validateTopicKey(topic, owner, maxTopicLength);
-  if (error !== void 0) throw new Error(error);
-}
-function validateTopicKey(topic, owner, maxTopicLength) {
-  if (typeof topic !== "string" || topic.length === 0) {
-    return `${owner}: topic must be a non-empty string`;
+function validateCommand(command) {
+  if (!isObjectRecord(command)) return "command must be an object";
+  if (typeof command.kind !== "string") return "command kind is required";
+  if (!isMessageBusCommandKind(command.kind)) return `unknown command kind '${command.kind}'`;
+  if ("topic" in command) {
+    if (typeof command.topic !== "string") return "messageBus: topic must be a non-empty string";
+    const topicError = validateTopicKey(command.topic, "messageBus");
+    if (topicError !== void 0) return topicError;
+  }
+  if ("subscriptionId" in command && typeof command.subscriptionId !== "string") {
+    return "subscriptionId must be a string";
   }
-  if (topic.length > maxTopicLength) {
-    return `${owner}: topic exceeds maxTopicLength`;
+  if (command.kind === "publish" && command.payload === void 0)
+    return "publish payload is required";
+  if (command.kind === "ack" && !isPositiveSeq(command.seq))
+    return "ack seq must be a positive integer";
+  if (command.kind === "seek" && !isPositiveSeq(command.nextSeq)) {
+    return "seek nextSeq must be a positive integer";
+  }
+  if (command.kind === "topic-policy" && command.topicPolicy !== "strict" && command.topicPolicy !== "create-as-fact") {
+    return "topicPolicy is not recognized";
   }
   return void 0;
 }
-function hasHubTopic(runtime, topic) {
-  return runtime.topics.includes(topic);
-}
-function addHubTopic(runtime, topic) {
-  if (!hasHubTopic(runtime, topic)) runtime.topics = [...runtime.topics, topic];
-}
-function deleteHubTopic(runtime, topic) {
-  runtime.topics = runtime.topics.filter((existing) => existing !== topic);
-}
-function canAddHubTopic(runtime, topic, maxTopics) {
-  if (hasHubTopic(runtime, topic)) return void 0;
-  return runtime.topics.length >= maxTopics ? "dynamicHub: topic count exceeds maxTopics" : void 0;
-}
-function isReachableUpstream(from, target) {
-  const seen = /* @__PURE__ */ new Set();
-  const stack = [from];
-  while (stack.length > 0) {
-    const node = stack.pop();
-    if (node === void 0) continue;
-    if (node === target) return true;
-    if (seen.has(node)) continue;
-    seen.add(node);
-    for (const dep of node.deps) stack.push(dep);
-  }
-  return false;
+function isMessageBusCommandKind(kind) {
+  return kind === "ensure-topic" || kind === "close-topic" || kind === "publish" || kind === "topic-policy" || kind === "ack" || kind === "seek" || kind === "close-subscription";
+}
+function catalogPage(state, params) {
+  const limit = positiveLimit(params.limit);
+  const topics = [...state.topics.entries()].filter(
+    ([topic, value]) => (params.includeClosed ? true : !value.closed) && (params.afterTopic === void 0 || topic > params.afterTopic)
+  ).sort(([a], [b]) => a < b ? -1 : a > b ? 1 : 0);
+  const page = topics.slice(0, limit);
+  const hasMore = topics.length > limit;
+  return {
+    topics: page.map(([topic, value]) => ({
+      topic,
+      closed: value.closed,
+      headSeq: value.headSeq,
+      nextSeq: value.nextSeq,
+      messageCount: value.messages.length
+    })),
+    ...hasMore && page.length > 0 ? { nextAfterTopic: page[page.length - 1]?.[0] } : {},
+    hasMore
+  };
+}
+function topicPage(state, topicName, params) {
+  const topic = state.topics.get(topicName);
+  const start = params.afterSeq === void 0 ? topic?.headSeq ?? 1 : params.afterSeq + 1;
+  const all = (topic?.messages ?? []).filter((message) => message.seq >= start);
+  const limit = positiveLimit(params.limit);
+  const messages = all.slice(0, limit);
+  const hasMore = all.length > limit;
+  return {
+    topic: topicName,
+    messages,
+    fromSeq: start,
+    ...messages.length > 0 ? { throughSeq: messages[messages.length - 1]?.seq } : {},
+    ...hasMore && messages.length > 0 ? { nextAfterSeq: messages[messages.length - 1]?.seq } : {},
+    hasMore
+  };
+}
+function availablePage(state, sub, params) {
+  const cursor = cursorSnapshot(state, sub);
+  const start = params.afterSeq === void 0 ? sub.nextSeq : params.afterSeq + 1;
+  const topic = state.topics.get(sub.topic);
+  const all = sub.retentionGap ? [] : (topic?.messages ?? []).filter((message) => message.seq >= start);
+  const limit = positiveLimit(params.limit);
+  const messages = all.slice(0, limit);
+  const hasMore = all.length > limit;
+  return {
+    topic: sub.topic,
+    subscriptionId: sub.subscriptionId,
+    cursor,
+    messages,
+    fromSeq: start,
+    ...messages.length > 0 ? { throughSeq: messages[messages.length - 1]?.seq } : {},
+    ...hasMore && messages.length > 0 ? { nextAfterSeq: messages[messages.length - 1]?.seq } : {},
+    hasMore
+  };
+}
+function deadLetterPage(state, params) {
+  const limit = positiveLimit(params.limit);
+  const entries = state.deadLetters.filter((entry) => {
+    if (params.afterEntrySeq !== void 0 && entry.entrySeq <= params.afterEntrySeq) return false;
+    if (params.topic !== void 0 && entry.topic !== params.topic) return false;
+    if (params.code !== void 0 && entry.issue.code !== params.code) return false;
+    return true;
+  });
+  const page = entries.slice(0, limit);
+  const hasMore = entries.length > limit;
+  return {
+    entries: page,
+    ...hasMore && page.length > 0 ? { nextAfterEntrySeq: page[page.length - 1]?.entrySeq } : {},
+    hasMore
+  };
+}
+function cursorSnapshot(state, sub) {
+  const topic = state.topics.get(sub.topic);
+  return {
+    topic: sub.topic,
+    subscriptionId: sub.subscriptionId,
+    nextSeq: sub.nextSeq,
+    closed: sub.closed,
+    retentionGap: sub.retentionGap,
+    headSeq: topic?.headSeq ?? 1
+  };
+}
+function ensureSubscription(state, opts) {
+  const key = `${opts.topic}\0${opts.subscriptionId}`;
+  const existing = state.subscriptions.get(key);
+  if (existing !== void 0) return existing;
+  const topic = state.topics.get(opts.topic);
+  const nextSeq = opts.from === "earliest" ? topic?.headSeq ?? 1 : opts.from === "latest" ? topic?.nextSeq ?? 1 : opts.from;
+  const sub = {
+    topic: opts.topic,
+    subscriptionId: opts.subscriptionId,
+    nextSeq,
+    closed: false,
+    retentionGap: topic !== void 0 && nextSeq < topic.headSeq
+  };
+  state.subscriptions.set(key, sub);
+  return sub;
 }
-function requireDynamicHubState(hub) {
-  const state = dynamicHubStates.get(hub);
-  if (state === void 0) throw new Error("dynamicHub: unknown hub implementation");
-  return state;
+function getSubscription(state, topic, subscriptionId) {
+  return state.subscriptions.get(`${topic}\0${subscriptionId}`);
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
@@ -808,11 +945,11 @@ function requireDynamicHubState(hub) {
   SPAWNS_TOPIC,
   STANDARD_TOPICS,
   TODOS_TOPIC,
-  dynamicHub,
-  fromHubTopic,
+  eventMessage,
+  eventMessageIssue,
   fromTopic,
+  isEventMessage,
   messageBus,
-  toHubTopic,
   toTopic
 });
 //# sourceMappingURL=index.cjs.map