@semiont/core 0.5.22 → 0.5.24

package/dist/chunk-3WTQZOGO.js

@@ -0,0 +1,143 @@
+import { baseUrl, EventBus, BRIDGED_CHANNELS, BUS_OPERATIONS } from './chunk-4JTZMWZB.js';
+import { BehaviorSubject, Subject } from 'rxjs';
+
+function isOperation(channel) {
+  return channel in BUS_OPERATIONS;
+}
+function retryKeyOf(channel, payload) {
+  const entries = Object.entries(payload).filter(([k]) => k !== "correlationId" && k !== "_trace" && k !== "_userId").sort(([a], [b]) => a < b ? -1 : 1);
+  return `${channel} ${JSON.stringify(entries)}`;
+}
+var FaultyTransport = class {
+  baseUrl = baseUrl("faulty://simulator");
+  state$ = new BehaviorSubject("open");
+  errorsSubject = new Subject();
+  errors$ = this.errorsSubject.asObservable();
+  /** Every request-channel emit, in order — the L2 accounting surface. */
+  requestLog = [];
+  bus = new EventBus();
+  schedule;
+  makeResponse;
+  replyQueues = /* @__PURE__ */ new Map();
+  requestCount = 0;
+  timers = /* @__PURE__ */ new Set();
+  disposed = false;
+  constructor(cfg = {}) {
+    this.schedule = cfg.schedule ?? [];
+    this.makeResponse = cfg.makeResponse ?? (() => ({}));
+  }
+  /**
+   * Queue responses for `op`, consumed FIFO — one per request that reaches
+   * the simulated backend — before falling back to `makeResponse`
+   * (SDK-TESTING-DOUBLE.md, gap 2). The queue scripts the BACKEND; the fault
+   * schedule scripts the WIRE. Consequences, deliberately: `duplicate-reply`
+   * replays one entry's body twice, and a `drop-reply` still consumes its
+   * entry (the backend answered; the wire ate it) — so "first reply lost,
+   * the retry sees the NEXT page" is expressible. `reject-emit` consumes
+   * nothing: that request never reached the backend.
+   */
+  queueReply(op, ...responses) {
+    const q = this.replyQueues.get(op) ?? [];
+    q.push(...responses);
+    this.replyQueues.set(op, q);
+  }
+  // ── Bus primitives ──────────────────────────────────────────────────────
+  async emit(channel, payload, resourceScope) {
+    if (this.disposed) return;
+    const name = channel;
+    if (!isOperation(name)) {
+      const target = resourceScope === void 0 ? this.bus.get(channel) : this.bus.scope(resourceScope).get(channel);
+      target.next(payload);
+      return;
+    }
+    const record = payload;
+    const action = this.schedule.length === 0 ? { kind: "deliver" } : this.schedule[this.requestCount % this.schedule.length];
+    this.requestCount += 1;
+    this.requestLog.push({
+      channel: name,
+      action,
+      correlationId: typeof record.correlationId === "string" ? record.correlationId : void 0,
+      retryKey: retryKeyOf(name, record),
+      payload: { ...record }
+    });
+    if (action.kind === "reject-emit") {
+      throw new Error(`FaultyTransport: emit rejected by schedule (reject-emit) on ${name}`);
+    }
+    this.bus.get(channel).next(payload);
+    const queue = this.replyQueues.get(name);
+    const response = queue && queue.length > 0 ? queue.shift() : this.makeResponse(name, record);
+    const reply = () => {
+      if (this.disposed) return;
+      const replyPayload = response === void 0 ? { correlationId: record.correlationId } : { correlationId: record.correlationId, response };
+      const resultChannel = BUS_OPERATIONS[name].result;
+      this.bus.get(resultChannel).next(replyPayload);
+    };
+    switch (action.kind) {
+      case "deliver":
+        queueMicrotask(reply);
+        break;
+      case "duplicate-reply":
+        queueMicrotask(reply);
+        queueMicrotask(reply);
+        break;
+      case "delay": {
+        const t = setTimeout(() => {
+          this.timers.delete(t);
+          reply();
+        }, action.ms);
+        this.timers.add(t);
+        break;
+      }
+    }
+  }
+  on(channel, handler) {
+    const sub = this.bus.get(channel).subscribe(handler);
+    return () => sub.unsubscribe();
+  }
+  stream(channel) {
+    return this.bus.get(channel);
+  }
+  subscribeToResource(_rid) {
+    return () => {
+    };
+  }
+  /**
+   * Correlated-reply tracking (BUS-RESUMPTION.md Phase 2 / SDK-DEBT S1),
+   * exposed for assertions: `busRequest` registers each cid here before its
+   * emit and releases on settle, so a test can pin the tracked set at any
+   * point of a request's lifecycle. Delivery in this double is bus-direct
+   * (nothing to replay), so tracking has no behavioral effect.
+   */
+  pendingReplies = /* @__PURE__ */ new Set();
+  trackReply(correlationId) {
+    this.pendingReplies.add(correlationId);
+    let released = false;
+    return () => {
+      if (released) return;
+      released = true;
+      this.pendingReplies.delete(correlationId);
+    };
+  }
+  bridgeInto(bus) {
+    for (const channel of BRIDGED_CHANNELS) {
+      this.bus.get(channel).subscribe((payload) => {
+        bus.get(channel).next(payload);
+      });
+    }
+  }
+  // ── Lifecycle ───────────────────────────────────────────────────────────
+  dispose() {
+    if (this.disposed) return;
+    this.disposed = true;
+    for (const t of this.timers) clearTimeout(t);
+    this.timers.clear();
+    this.state$.next("closed");
+    this.state$.complete();
+    this.errorsSubject.complete();
+    this.bus.destroy();
+  }
+};
+
+export { FaultyTransport, retryKeyOf };
+//# sourceMappingURL=chunk-3WTQZOGO.js.map
+//# sourceMappingURL=chunk-3WTQZOGO.js.map

package/dist/chunk-3WTQZOGO.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/faulty-transport.ts"],"names":[],"mappings":"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","file":"chunk-3WTQZOGO.js","sourcesContent":["/**\n * FaultyTransport — a seeded, scriptable `ITransport` simulator for the\n * liveness axioms (`.plans/LIVENESS-AXIOMS.md`). fast-check draws a fault\n * schedule; the transport applies one `FaultAction` per request-channel emit\n * and synthesizes replies from the `BUS_OPERATIONS` registry, so real\n * compositions (`busRequest`, SWR caches, live queries) run unmodified against\n * generated wire behavior no hand-written test names.\n *\n * Home is core (not sdk/test-utils) for the same reason as\n * `assertStateUnitAxioms`: it needs only core types, and every layer —\n * including `http-transport`, below sdk — can consume it via\n * `@semiont/core/testing` without a dependency cycle.\n *\n * Deterministic-by-construction: no `Date.now`, no randomness of its own —\n * all variation comes in through the schedule (fast-check owns the seed).\n * Time is real `setTimeout` at millisecond scale; properties pass a small\n * explicit `timeoutMs` to `busRequest`, so nothing waits 30 s.\n */\n\nimport { BehaviorSubject, Subject, type Observable } from 'rxjs';\nimport type { SemiontError } from './errors';\nimport type { BaseUrl } from './branded-types';\nimport { baseUrl as makeBaseUrl } from './branded-types';\nimport type { ResourceId } from './identifiers';\nimport type { EventMap } from './bus-protocol';\nimport type { ConnectionState, ITransport } from './transport';\nimport { EventBus } from './event-bus';\nimport { BRIDGED_CHANNELS } from './bridged-channels';\nimport { BUS_OPERATIONS, type BusOperationKey } from './bus-operations';\n\n/** One wire behavior, applied to a single request-channel emit. */\nexport type FaultAction =\n  | { kind: 'deliver' }\n  | { kind: 'drop-reply' }\n  | { kind: 'delay'; ms: number }\n  | { kind: 'duplicate-reply' }\n  | { kind: 'reject-emit' };\n\n/** requestLog entry — one per request-channel emit, in arrival order. */\nexport interface RequestLogEntry {\n  channel: BusOperationKey;\n  /** The action the schedule assigned to this emit. */\n  action: FaultAction;\n  correlationId: string | undefined;\n  /**\n   * Request identity for retry accounting: channel + payload minus the\n   * per-issue fields (`correlationId`, `_trace`, `_userId`). Two emits with\n   * the same key are the same logical request re-issued.\n   */\n  retryKey: string;\n  /**\n   * The payload as emitted — envelope, options, params, `correlationId` and\n   * all. This is the surface for \"assert what my orchestrator actually SENT\"\n   * (SDK-TESTING-DOUBLE gap 6): without it every consumer harness re-invented\n   * a per-channel `transport.on(...)` wire recorder alongside this log.\n   *\n   * SHALLOW snapshot: the top level is copied at emit time, so a caller that\n   * mutates its own payload object afterwards cannot rewrite history. Nested\n   * objects are shared by reference — deep-freeze is not worth the cost in a\n   * double, and no in-repo caller mutates nested request payloads.\n   */\n  payload: Record<string, unknown>;\n}\n\nexport interface FaultyTransportConfig {\n  /**\n   * The i-th request-channel emit applies `schedule[i % schedule.length]`.\n   * Empty/omitted → every request delivers.\n   */\n  schedule?: readonly FaultAction[];\n  /**\n   * Synthesize the `response` value for a delivered reply. Return `undefined`\n   * for a void ack (`{ correlationId }` only). Default: `{}` for every op.\n   */\n  makeResponse?: (operation: BusOperationKey, payload: Record<string, unknown>) => unknown;\n}\n\nfunction isOperation(channel: string): channel is BusOperationKey {\n  return channel in BUS_OPERATIONS;\n}\n\n/** Stable request identity: channel + sorted payload minus per-issue fields. */\nexport function retryKeyOf(channel: string, payload: Record<string, unknown>): string {\n  const entries = Object.entries(payload)\n    .filter(([k]) => k !== 'correlationId' && k !== '_trace' && k !== '_userId')\n    .sort(([a], [b]) => (a < b ? -1 : 1));\n  return `${channel} ${JSON.stringify(entries)}`;\n}\n\nexport class FaultyTransport implements ITransport {\n  readonly baseUrl: BaseUrl = makeBaseUrl('faulty://simulator');\n  readonly state$ = new BehaviorSubject<ConnectionState>('open');\n  private readonly errorsSubject = new Subject<SemiontError>();\n  readonly errors$: Observable<SemiontError> = this.errorsSubject.asObservable();\n\n  /** Every request-channel emit, in order — the L2 accounting surface. */\n  readonly requestLog: RequestLogEntry[] = [];\n\n  private readonly bus = new EventBus();\n  private readonly schedule: readonly FaultAction[];\n  private readonly makeResponse: (op: BusOperationKey, payload: Record<string, unknown>) => unknown;\n  private readonly replyQueues = new Map<BusOperationKey, unknown[]>();\n  private requestCount = 0;\n  private readonly timers = new Set<ReturnType<typeof setTimeout>>();\n  private disposed = false;\n\n  constructor(cfg: FaultyTransportConfig = {}) {\n    this.schedule = cfg.schedule ?? [];\n    this.makeResponse = cfg.makeResponse ?? (() => ({}));\n  }\n\n  /**\n   * Queue responses for `op`, consumed FIFO — one per request that reaches\n   * the simulated backend — before falling back to `makeResponse`\n   * (SDK-TESTING-DOUBLE.md, gap 2). The queue scripts the BACKEND; the fault\n   * schedule scripts the WIRE. Consequences, deliberately: `duplicate-reply`\n   * replays one entry's body twice, and a `drop-reply` still consumes its\n   * entry (the backend answered; the wire ate it) — so \"first reply lost,\n   * the retry sees the NEXT page\" is expressible. `reject-emit` consumes\n   * nothing: that request never reached the backend.\n   */\n  queueReply(op: BusOperationKey, ...responses: unknown[]): void {\n    const q = this.replyQueues.get(op) ?? [];\n    q.push(...responses);\n    this.replyQueues.set(op, q);\n  }\n\n  // ── Bus primitives ──────────────────────────────────────────────────────\n\n  async emit<K extends keyof EventMap>(\n    channel: K,\n    payload: EventMap[K],\n    resourceScope?: ResourceId,\n  ): Promise<void> {\n    if (this.disposed) return;\n    const name = channel as string;\n    if (!isOperation(name)) {\n      // Non-request channel: forward as-is (scoped or global).\n      const target = resourceScope === undefined\n        ? this.bus.get(channel)\n        : this.bus.scope(resourceScope as string).get(channel);\n      target.next(payload);\n      return;\n    }\n\n    const record = payload as Record<string, unknown>;\n    const action: FaultAction = this.schedule.length === 0\n      ? { kind: 'deliver' }\n      : this.schedule[this.requestCount % this.schedule.length]!;\n    this.requestCount += 1;\n    this.requestLog.push({\n      channel: name,\n      action,\n      correlationId: typeof record.correlationId === 'string' ? record.correlationId : undefined,\n      retryKey: retryKeyOf(name, record),\n      payload: { ...record },\n    });\n\n    if (action.kind === 'reject-emit') {\n      // Models a /bus/emit 4xx: the request never reaches the bus.\n      throw new Error(`FaultyTransport: emit rejected by schedule (reject-emit) on ${name}`);\n    }\n\n    // The request itself is observable (handlers-eye view), then the\n    // simulator plays backend: synthesize the registry reply per the action.\n    this.bus.get(channel).next(payload);\n\n    // The backend's answer is computed ONCE per request that reaches it —\n    // the reply QUEUE scripts the backend, the fault schedule scripts the\n    // wire (SDK-TESTING-DOUBLE.md Phase 2). So `duplicate-reply` replays the\n    // same body twice, and a `drop-reply` still consumes its queue entry:\n    // the backend answered, the wire ate it.\n    const queue = this.replyQueues.get(name);\n    const response = queue && queue.length > 0 ? queue.shift() : this.makeResponse(name, record);\n\n    const reply = (): void => {\n      if (this.disposed) return;\n      const replyPayload = response === undefined\n        ? { correlationId: record.correlationId }\n        : { correlationId: record.correlationId, response };\n      const resultChannel = BUS_OPERATIONS[name].result as keyof EventMap;\n      this.bus.get(resultChannel).next(replyPayload as EventMap[keyof EventMap]);\n    };\n\n    switch (action.kind) {\n      case 'deliver':\n        queueMicrotask(reply);\n        break;\n      case 'duplicate-reply':\n        queueMicrotask(reply);\n        queueMicrotask(reply);\n        break;\n      case 'delay': {\n        const t = setTimeout(() => { this.timers.delete(t); reply(); }, action.ms);\n        this.timers.add(t);\n        break;\n      }\n      case 'drop-reply':\n        break;\n    }\n  }\n\n  on<K extends keyof EventMap>(channel: K, handler: (payload: EventMap[K]) => void): () => void {\n    const sub = this.bus.get(channel).subscribe(handler);\n    return () => sub.unsubscribe();\n  }\n\n  stream<K extends keyof EventMap>(channel: K): Observable<EventMap[K]> {\n    return this.bus.get(channel);\n  }\n\n  subscribeToResource(_rid: ResourceId): () => void {\n    // Mirrors the real HttpTransport: distinct scopes COMPOSE\n    // (MULTI-RESOURCE-SCOPE). Delivery here is bus-direct and never\n    // scope-gated, so acquisition needs no bookkeeping and release\n    // (idempotent by construction) is a no-op.\n    return () => {};\n  }\n\n  /**\n   * Correlated-reply tracking (BUS-RESUMPTION.md Phase 2 / SDK-DEBT S1),\n   * exposed for assertions: `busRequest` registers each cid here before its\n   * emit and releases on settle, so a test can pin the tracked set at any\n   * point of a request's lifecycle. Delivery in this double is bus-direct\n   * (nothing to replay), so tracking has no behavioral effect.\n   */\n  readonly pendingReplies = new Set<string>();\n\n  trackReply(correlationId: string): () => void {\n    this.pendingReplies.add(correlationId);\n    let released = false;\n    return () => {\n      if (released) return;\n      released = true;\n      this.pendingReplies.delete(correlationId);\n    };\n  }\n\n  bridgeInto(bus: EventBus): void {\n    for (const channel of BRIDGED_CHANNELS) {\n      this.bus.get(channel as keyof EventMap).subscribe((payload) => {\n        bus.get(channel as keyof EventMap).next(payload as EventMap[keyof EventMap]);\n      });\n    }\n  }\n\n  // ── Lifecycle ───────────────────────────────────────────────────────────\n\n  dispose(): void {\n    if (this.disposed) return;\n    this.disposed = true;\n    for (const t of this.timers) clearTimeout(t);\n    this.timers.clear();\n    this.state$.next('closed');\n    this.state$.complete();\n    this.errorsSubject.complete();\n    // Completes every subject: in-flight busRequests resolve `bus.closed`.\n    this.bus.destroy();\n  }\n}\n"]}

package/dist/chunk-4JTZMWZB.js

@@ -0,0 +1,330 @@
+import { Subject } from 'rxjs';
+
+// src/branded-types.ts
+function email(value) {
+  return value;
+}
+function authCode(value) {
+  return value;
+}
+function googleCredential(value) {
+  return value;
+}
+function accessToken(value) {
+  return value;
+}
+function refreshToken(value) {
+  return value;
+}
+function mcpToken(value) {
+  return value;
+}
+function cloneToken(value) {
+  return value;
+}
+function jobId(value) {
+  return value;
+}
+function userDID(value) {
+  return value;
+}
+function entityType(value) {
+  return value;
+}
+function searchQuery(value) {
+  return value;
+}
+function baseUrl(value) {
+  return value;
+}
+function resourceUri(uri) {
+  if (!uri.startsWith("http://") && !uri.startsWith("https://")) {
+    throw new TypeError(`Expected ResourceUri, got: ${uri}`);
+  }
+  return uri;
+}
+function annotationUri(uri) {
+  if (!uri.startsWith("http://") && !uri.startsWith("https://")) {
+    throw new TypeError(`Expected AnnotationUri, got: ${uri}`);
+  }
+  return uri;
+}
+function resourceAnnotationUri(uri) {
+  if (!uri.startsWith("http://") && !uri.startsWith("https://")) {
+    throw new TypeError(`Expected ResourceAnnotationUri, got: ${uri}`);
+  }
+  if (!uri.includes("/resources/") || !uri.includes("/annotations/")) {
+    throw new TypeError(`Expected nested ResourceAnnotationUri format, got: ${uri}`);
+  }
+  return uri;
+}
+
+// src/bus-operations.ts
+var BUS_OPERATIONS = {
+  // ── BIND ────────────────────────────────────────────────────────
+  "bind:update-body": { result: "bind:body-updated", failure: "bind:body-update-failed" },
+  // ── BROWSE (reads) ──────────────────────────────────────────────
+  "browse:resource-requested": { result: "browse:resource-result", failure: "browse:resource-failed" },
+  "browse:resources-requested": { result: "browse:resources-result", failure: "browse:resources-failed" },
+  "browse:annotation-requested": { result: "browse:annotation-result", failure: "browse:annotation-failed" },
+  "browse:annotations-requested": { result: "browse:annotations-result", failure: "browse:annotations-failed" },
+  "browse:annotation-history-requested": { result: "browse:annotation-history-result", failure: "browse:annotation-history-failed" },
+  "browse:events-requested": { result: "browse:events-result", failure: "browse:events-failed" },
+  "browse:referenced-by-requested": { result: "browse:referenced-by-result", failure: "browse:referenced-by-failed" },
+  "browse:entity-types-requested": { result: "browse:entity-types-result", failure: "browse:entity-types-failed" },
+  "browse:tag-schemas-requested": { result: "browse:tag-schemas-result", failure: "browse:tag-schemas-failed" },
+  "browse:agents-requested": { result: "browse:agents-result", failure: "browse:agents-failed" },
+  "browse:directory-requested": { result: "browse:directory-result", failure: "browse:directory-failed" },
+  // dormant — backend handler complete, no client caller yet (annotation-detail capability)
+  "browse:annotation-context-requested": { result: "browse:annotation-context-result", failure: "browse:annotation-context-failed" },
+  // ── FRAME (KB schema writes) ────────────────────────────────────
+  "frame:add-entity-type": { result: "frame:entity-type-add-ok", failure: "frame:entity-type-add-failed" },
+  "frame:add-tag-schema": { result: "frame:tag-schema-add-ok", failure: "frame:tag-schema-add-failed" },
+  // ── GATHER ──────────────────────────────────────────────────────
+  // streaming: take-1 result + failure plus an intermediate progress channel
+  "gather:requested": { result: "gather:complete", failure: "gather:failed", progress: "gather:annotation-progress" },
+  "gather:resource-requested": { result: "gather:resource-complete", failure: "gather:resource-failed" },
+  // dormant — backend handler complete, no client caller yet (annotation summary)
+  "gather:summary-requested": { result: "gather:summary-result", failure: "gather:summary-failed" },
+  // ── JOB ─────────────────────────────────────────────────────────
+  "job:create": { result: "job:created", failure: "job:create-failed" },
+  "job:status-requested": { result: "job:status-result", failure: "job:status-failed" },
+  "job:cancel-requested": { result: "job:cancel-ok", failure: "job:cancel-failed" },
+  // worker-side: the worker claims a queued job (not an SDK call)
+  "job:claim": { result: "job:claimed", failure: "job:claim-failed" },
+  // ── MARK ────────────────────────────────────────────────────────
+  "mark:create-request": { result: "mark:create-ok", failure: "mark:create-failed" },
+  "mark:delete": { result: "mark:delete-ok", failure: "mark:delete-failed" },
+  "mark:archive": { result: "mark:archive-ok", failure: "mark:archive-failed" },
+  "mark:unarchive": { result: "mark:unarchive-ok", failure: "mark:unarchive-failed" },
+  "mark:update-entity-types": { result: "mark:update-entity-types-ok", failure: "mark:update-entity-types-failed" },
+  // ── MATCH ───────────────────────────────────────────────────────
+  // take-1 dressed as an Observable in the SDK; no progress channel
+  "match:search-requested": { result: "match:search-results", failure: "match:search-failed" },
+  // ── WEAVE ───────────────────────────────────────────────────────
+  // Graph-projection rebuild, served by the Weaver (WEAVER-ISOLATION D3)
+  "weave:rebuild": { result: "weave:rebuild-ok", failure: "weave:rebuild-failed" },
+  // ── YIELD ───────────────────────────────────────────────────────
+  // live in-process (resource-operations.ts emits + awaits via race()); the
+  // client also .on()-subscribes -ok for cache invalidation
+  "yield:create": { result: "yield:create-ok", failure: "yield:create-failed" },
+  // dormant — handler in stower exists, no request emitter; client pre-subscribes -ok
+  "yield:update": { result: "yield:update-ok", failure: "yield:update-failed" },
+  "yield:clone-create": { result: "yield:clone-created", failure: "yield:clone-create-failed" },
+  "yield:clone-resource-requested": { result: "yield:clone-resource-result", failure: "yield:clone-resource-failed" },
+  "yield:clone-token-requested": { result: "yield:clone-token-generated", failure: "yield:clone-token-failed" }
+};
+
+// src/bridged-channels.ts
+var BRIDGED_BROADCASTS = [
+  "job:report-progress",
+  "job:complete",
+  "job:fail",
+  "frame:entity-type-added",
+  "frame:tag-schema-added",
+  "beckon:focus",
+  "beckon:sparkle",
+  "bus:resume-gap"
+];
+var REGISTRY_REPLIES = Object.keys(BUS_OPERATIONS).flatMap(
+  (key) => {
+    const op = BUS_OPERATIONS[key];
+    return "progress" in op ? [op.result, op.failure, op.progress] : [op.result, op.failure];
+  }
+);
+var BRIDGED_CHANNELS = [
+  ...REGISTRY_REPLIES,
+  ...BRIDGED_BROADCASTS
+];
+
+// src/bus-log.ts
+var NODE_BUS_LOG = typeof process !== "undefined" && !!process.env?.SEMIONT_BUS_LOG;
+var IS_NODE = typeof process !== "undefined" && !!process.versions?.node;
+function busLogEnabled() {
+  const g = globalThis;
+  if (g.__SEMIONT_BUS_LOG__) return true;
+  return NODE_BUS_LOG;
+}
+var traceIdProvider;
+function setBusLogTraceIdProvider(fn) {
+  traceIdProvider = fn;
+}
+function busLog(op, channel, payload, scope) {
+  if (!busLogEnabled()) return;
+  const cidRaw = payload?.correlationId;
+  const cid = typeof cidRaw === "string" ? cidRaw.slice(0, 8) : void 0;
+  let traceId;
+  if (traceIdProvider) {
+    try {
+      traceId = traceIdProvider();
+    } catch {
+    }
+  }
+  const tag = `[bus ${op}] ${channel}` + (scope ? ` scope=${scope}` : "") + (cid ? ` cid=${cid}` : "") + (traceId ? ` trace=${traceId.slice(0, 8)}` : "");
+  console.debug(tag, payload);
+}
+function warnUnobservedRepliesEnabled() {
+  return IS_NODE;
+}
+var unobservedReplyWarned = /* @__PURE__ */ new Set();
+function warnIfUnobservedReply(channel, payload, observerCount) {
+  if (observerCount > 0) return;
+  const cidRaw = payload?.correlationId;
+  if (typeof cidRaw !== "string" || cidRaw.length === 0) return;
+  if (BRIDGED_CHANNELS.includes(channel)) return;
+  if (unobservedReplyWarned.has(channel)) return;
+  unobservedReplyWarned.add(channel);
+  console.warn(
+    `[bus DROP] ${channel} cid=${cidRaw.slice(0, 8)} emitted with 0 subscribers and not in BRIDGED_CHANNELS \u2014 a correlation reply with no forwarder is dropped, so the awaiting client times out (no error). Bridge it by declaring its operation in BUS_OPERATIONS (packages/core/src/bus-operations.ts) \u2014 or, if it is a non-reply broadcast, add it to BRIDGED_BROADCASTS (packages/core/src/bridged-channels.ts) \u2014 so transports subscribe to it.`
+  );
+}
+var EventBus = class {
+  subjects;
+  isDestroyed;
+  constructor() {
+    this.subjects = /* @__PURE__ */ new Map();
+    this.isDestroyed = false;
+  }
+  /**
+   * Get the RxJS Subject for an event
+   *
+   * Returns a typed Subject that can be used with all RxJS operators.
+   * Subjects are created lazily on first access.
+   *
+   * @param eventName - The event name
+   * @returns The RxJS Subject for this event
+   *
+   * @example
+   * ```typescript
+   * // Emit
+   * eventBus.get('beckon:hover').next({ annotationId: 'ann-1' });
+   *
+   * // Subscribe
+   * const sub = eventBus.get('beckon:hover').subscribe(handleHover);
+   *
+   * // With operators
+   * eventBus.get('beckon:hover')
+   *   .pipe(debounceTime(100), distinctUntilChanged())
+   *   .subscribe(handleHover);
+   * ```
+   */
+  get(eventName) {
+    if (this.isDestroyed) {
+      throw new Error(`Cannot access event '${String(eventName)}' on destroyed bus`);
+    }
+    if (!this.subjects.has(eventName)) {
+      const subject = new Subject();
+      const wantBusLog = busLogEnabled();
+      const wantDropCheck = warnUnobservedRepliesEnabled();
+      if (wantBusLog || wantDropCheck) {
+        const wrapped = subject;
+        const originalNext = subject.next.bind(subject);
+        subject.next = (value) => {
+          if (wantBusLog) busLog("EMIT", String(eventName), value);
+          if (wantDropCheck) warnIfUnobservedReply(String(eventName), value, wrapped.observers.length);
+          originalNext(value);
+        };
+      }
+      this.subjects.set(eventName, subject);
+    }
+    return this.subjects.get(eventName);
+  }
+  /**
+   * Get the RxJS Subject for a domain event type (PersistedEventType).
+   *
+   * Domain event channels carry `StoredEvent`. This method avoids the need
+   * for `as keyof EventMap` casts when subscribing to domain event channels
+   * using runtime `PersistedEventType` strings.
+   */
+  getDomainEvent(eventType) {
+    return this.get(eventType);
+  }
+  /**
+   * Destroy the event bus and complete all subjects
+   *
+   * After calling destroy(), no new events can be emitted or subscribed to.
+   * All active subscriptions will be completed.
+   */
+  destroy() {
+    if (this.isDestroyed) {
+      return;
+    }
+    for (const subject of this.subjects.values()) {
+      subject.complete();
+    }
+    this.subjects.clear();
+    this.isDestroyed = true;
+  }
+  /**
+   * Check if the event bus has been destroyed
+   */
+  get destroyed() {
+    return this.isDestroyed;
+  }
+  /**
+   * Create a resource-scoped event bus
+   *
+   * Events emitted or subscribed through the scoped bus are isolated to that resource.
+   * Internally, events are namespaced but the API remains identical to the parent bus.
+   *
+   * @param resourceId - Resource identifier to scope events to
+   * @returns A scoped event bus for this resource
+   *
+   * @example
+   * ```typescript
+   * const eventBus = new EventBus();
+   * const resource1 = eventBus.scope('resource-1');
+   * const resource2 = eventBus.scope('resource-2');
+   *
+   * // These are isolated - only resource1 subscribers will fire
+   * resource1.get('detection:progress').next({ status: 'started' });
+   * ```
+   */
+  scope(resourceId) {
+    return new ScopedEventBus(this, resourceId);
+  }
+};
+var ScopedEventBus = class _ScopedEventBus {
+  constructor(parent, scopePrefix) {
+    this.parent = parent;
+    this.scopePrefix = scopePrefix;
+  }
+  parent;
+  scopePrefix;
+  /**
+   * Get the RxJS Subject for a scoped event
+   *
+   * Returns the same type as the parent bus, but events are isolated to this scope.
+   * Internally uses namespaced keys but preserves type safety.
+   *
+   * @param event - The event name
+   * @returns The RxJS Subject for this scoped event
+   */
+  get(event) {
+    const scopedKey = `${this.scopePrefix}:${event}`;
+    const parentSubjects = this.parent.subjects;
+    if (!parentSubjects.has(scopedKey)) {
+      parentSubjects.set(scopedKey, new Subject());
+    }
+    return parentSubjects.get(scopedKey);
+  }
+  /** Get the RxJS Subject for a domain event type on this scoped bus. */
+  getDomainEvent(eventType) {
+    return this.get(eventType);
+  }
+  /**
+   * Create a nested scope
+   *
+   * Allows hierarchical scoping like `resource-1:subsystem-a`
+   *
+   * @param subScope - Additional scope level
+   * @returns A nested scoped event bus
+   */
+  scope(subScope) {
+    return new _ScopedEventBus(this.parent, `${this.scopePrefix}:${subScope}`);
+  }
+};
+
+export { BRIDGED_CHANNELS, BUS_OPERATIONS, EventBus, ScopedEventBus, accessToken, annotationUri, authCode, baseUrl, busLog, busLogEnabled, cloneToken, email, entityType, googleCredential, jobId, mcpToken, refreshToken, resourceAnnotationUri, resourceUri, searchQuery, setBusLogTraceIdProvider, userDID };
+//# sourceMappingURL=chunk-4JTZMWZB.js.map
+//# sourceMappingURL=chunk-4JTZMWZB.js.map

package/dist/chunk-4JTZMWZB.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/branded-types.ts","../src/bus-operations.ts","../src/bridged-channels.ts","../src/bus-log.ts","../src/event-bus.ts"],"names":[],"mappings":"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","file":"chunk-4JTZMWZB.js","sourcesContent":["/**\n * Branded string types for compile-time type safety\n *\n * These types are zero-cost at runtime but prevent mixing\n * different string types at compile time.\n */\n\nimport type { components } from './types';\n\n// ============================================================================\n// OPENAPI-GENERATED TYPES (use directly from spec)\n// ============================================================================\n\nexport type Motivation = components['schemas']['Motivation'];\nexport type ContentFormat = components['schemas']['ContentFormat'];\n\n// ============================================================================\n// AUTHENTICATION & TOKENS\n// ============================================================================\n\nexport type Email = string & { readonly __brand: 'Email' };\nexport type AuthCode = string & { readonly __brand: 'AuthCode' };\nexport type GoogleCredential = string & { readonly __brand: 'GoogleCredential' };\nexport type AccessToken = string & { readonly __brand: 'AccessToken' };\nexport type RefreshToken = string & { readonly __brand: 'RefreshToken' };\nexport type MCPToken = string & { readonly __brand: 'MCPToken' };\nexport type CloneToken = string & { readonly __brand: 'CloneToken' };\n\n// ============================================================================\n// SYSTEM IDENTIFIERS\n// ============================================================================\n\nexport type JobId = string & { readonly __brand: 'JobId' };\nexport type UserDID = string & { readonly __brand: 'UserDID' };\nexport type EntityType = string & { readonly __brand: 'EntityType' };\nexport type SearchQuery = string & { readonly __brand: 'SearchQuery' };\nexport type BaseUrl = string & { readonly __brand: 'BaseUrl' };\n\n// ============================================================================\n// HELPER FUNCTIONS (minimal validation, just branding)\n// ============================================================================\n\nexport function email(value: string): Email { return value as Email; }\nexport function authCode(value: string): AuthCode { return value as AuthCode; }\nexport function googleCredential(value: string): GoogleCredential { return value as GoogleCredential; }\nexport function accessToken(value: string): AccessToken { return value as AccessToken; }\nexport function refreshToken(value: string): RefreshToken { return value as RefreshToken; }\nexport function mcpToken(value: string): MCPToken { return value as MCPToken; }\nexport function cloneToken(value: string): CloneToken { return value as CloneToken; }\nexport function jobId(value: string): JobId { return value as JobId; }\nexport function userDID(value: string): UserDID { return value as UserDID; }\nexport function entityType(value: string): EntityType { return value as EntityType; }\nexport function searchQuery(value: string): SearchQuery { return value as SearchQuery; }\nexport function baseUrl(value: string): BaseUrl { return value as BaseUrl; }\n\n// Motivation is an OpenAPI enum — use its values directly, no helper needed.\n// ContentFormat is a free-form MIME string whose base type must be a\n// SupportedMediaType; validation lives in media-types.ts, not in a brand.\n\n// ============================================================================\n// HTTP URI TYPES\n// ============================================================================\n\n// Branded type definitions for HTTP URIs returned by the API\nexport type ResourceUri = string & { readonly __brand: 'ResourceUri' };\n\n// W3C flat format for content negotiation: http://localhost:4000/annotations/{id}\nexport type AnnotationUri = string & { readonly __brand: 'AnnotationUri' };\n\n// Nested format for CRUD operations: http://localhost:4000/resources/{resourceId}/annotations/{annotationId}\nexport type ResourceAnnotationUri = string & { readonly __brand: 'ResourceAnnotationUri' };\n\n// Factory functions with runtime validation\nexport function resourceUri(uri: string): ResourceUri {\n  if (!uri.startsWith('http://') && !uri.startsWith('https://')) {\n    throw new TypeError(`Expected ResourceUri, got: ${uri}`);\n  }\n  return uri as ResourceUri;\n}\n\nexport function annotationUri(uri: string): AnnotationUri {\n  if (!uri.startsWith('http://') && !uri.startsWith('https://')) {\n    throw new TypeError(`Expected AnnotationUri, got: ${uri}`);\n  }\n  return uri as AnnotationUri;\n}\n\nexport function resourceAnnotationUri(uri: string): ResourceAnnotationUri {\n  if (!uri.startsWith('http://') && !uri.startsWith('https://')) {\n    throw new TypeError(`Expected ResourceAnnotationUri, got: ${uri}`);\n  }\n  // Additional validation: must contain /resources/ and /annotations/\n  if (!uri.includes('/resources/') || !uri.includes('/annotations/')) {\n    throw new TypeError(`Expected nested ResourceAnnotationUri format, got: ${uri}`);\n  }\n  return uri as ResourceAnnotationUri;\n}\n","// ⚠ GENERATED FILE — do not edit.\n//\n// Authority:   specs/src/bus/registry.json  (channels, payloads, operations)\n// Regenerate:  node scripts/bus/generate-ts.mjs\n// Go counterpart: node scripts/bus/generate-go.mjs → packages/sdk-go/bus\n//\n// Payload schemas themselves live in the OpenAPI components; the registry\n// names which one each channel carries. Add or change a channel THERE.\n\nimport type { EventName, EmittableChannel } from './bus-protocol';\n\n/**\n * BUS_OPERATIONS — the request/reply operations registry (Tier 1).\n *\n * Each entry declares ONE operation as the triple that was previously three\n * loose, independently-maintained facts spread across call sites:\n *   - the request channel (the key — an `EmittableChannel`),\n *   - the `result` channel (success reply),\n *   - the `failure` channel,\n *   - and, for a streaming op, an optional `progress` channel.\n *\n * `BridgedChannel` / `BRIDGED_CHANNELS` are DERIVED from this map\n * (bridged-channels.ts): every reply lands in the bridged fan-in set by\n * construction, so \"a reply channel forgotten from BRIDGED_CHANNELS\" — the\n * recurring bug class (gather:resource-complete, frame:*-add-failed) — is no\n * longer representable. See .plans/BUS-OPERATIONS-REGISTRY.md.\n *\n * `Partial<Record<EmittableChannel, …>>` enforces that every key is a real\n * emittable request. `result`/`failure`/`progress` stay `EventName` rather than\n * `BridgedChannel` to avoid a circular reference (BridgedChannel derives from\n * this map); the derivation closes the loop instead.\n */\nexport interface BusOperationSpec {\n  result: EventName;\n  failure: EventName;\n  /** Streaming ops only: an intermediate channel that also bridges. */\n  progress?: EventName;\n}\n\nexport const BUS_OPERATIONS = {\n  // ── BIND ────────────────────────────────────────────────────────\n  'bind:update-body':                    { result: 'bind:body-updated',              failure: 'bind:body-update-failed' },\n\n  // ── BROWSE (reads) ──────────────────────────────────────────────\n  'browse:resource-requested':           { result: 'browse:resource-result',         failure: 'browse:resource-failed' },\n  'browse:resources-requested':          { result: 'browse:resources-result',        failure: 'browse:resources-failed' },\n  'browse:annotation-requested':         { result: 'browse:annotation-result',       failure: 'browse:annotation-failed' },\n  'browse:annotations-requested':        { result: 'browse:annotations-result',      failure: 'browse:annotations-failed' },\n  'browse:annotation-history-requested': { result: 'browse:annotation-history-result', failure: 'browse:annotation-history-failed' },\n  'browse:events-requested':             { result: 'browse:events-result',           failure: 'browse:events-failed' },\n  'browse:referenced-by-requested':      { result: 'browse:referenced-by-result',    failure: 'browse:referenced-by-failed' },\n  'browse:entity-types-requested':       { result: 'browse:entity-types-result',     failure: 'browse:entity-types-failed' },\n  'browse:tag-schemas-requested':        { result: 'browse:tag-schemas-result',      failure: 'browse:tag-schemas-failed' },\n  'browse:agents-requested':             { result: 'browse:agents-result',           failure: 'browse:agents-failed' },\n  'browse:directory-requested':          { result: 'browse:directory-result',        failure: 'browse:directory-failed' },\n  // dormant — backend handler complete, no client caller yet (annotation-detail capability)\n  'browse:annotation-context-requested': { result: 'browse:annotation-context-result', failure: 'browse:annotation-context-failed' },\n\n  // ── FRAME (KB schema writes) ────────────────────────────────────\n  'frame:add-entity-type':               { result: 'frame:entity-type-add-ok',       failure: 'frame:entity-type-add-failed' },\n  'frame:add-tag-schema':                { result: 'frame:tag-schema-add-ok',        failure: 'frame:tag-schema-add-failed' },\n\n  // ── GATHER ──────────────────────────────────────────────────────\n  // streaming: take-1 result + failure plus an intermediate progress channel\n  'gather:requested':                    { result: 'gather:complete',                failure: 'gather:failed', progress: 'gather:annotation-progress' },\n  'gather:resource-requested':           { result: 'gather:resource-complete',       failure: 'gather:resource-failed' },\n  // dormant — backend handler complete, no client caller yet (annotation summary)\n  'gather:summary-requested':            { result: 'gather:summary-result',          failure: 'gather:summary-failed' },\n\n  // ── JOB ─────────────────────────────────────────────────────────\n  'job:create':                          { result: 'job:created',                    failure: 'job:create-failed' },\n  'job:status-requested':                { result: 'job:status-result',              failure: 'job:status-failed' },\n  'job:cancel-requested':                { result: 'job:cancel-ok',                  failure: 'job:cancel-failed' },\n  // worker-side: the worker claims a queued job (not an SDK call)\n  'job:claim':                           { result: 'job:claimed',                    failure: 'job:claim-failed' },\n\n  // ── MARK ────────────────────────────────────────────────────────\n  'mark:create-request':                 { result: 'mark:create-ok',                 failure: 'mark:create-failed' },\n  'mark:delete':                         { result: 'mark:delete-ok',                 failure: 'mark:delete-failed' },\n  'mark:archive':                        { result: 'mark:archive-ok',                failure: 'mark:archive-failed' },\n  'mark:unarchive':                      { result: 'mark:unarchive-ok',              failure: 'mark:unarchive-failed' },\n  'mark:update-entity-types':            { result: 'mark:update-entity-types-ok',    failure: 'mark:update-entity-types-failed' },\n\n  // ── MATCH ───────────────────────────────────────────────────────\n  // take-1 dressed as an Observable in the SDK; no progress channel\n  'match:search-requested':              { result: 'match:search-results',           failure: 'match:search-failed' },\n\n  // ── WEAVE ───────────────────────────────────────────────────────\n  // Graph-projection rebuild, served by the Weaver (WEAVER-ISOLATION D3)\n  'weave:rebuild':                       { result: 'weave:rebuild-ok',               failure: 'weave:rebuild-failed' },\n\n  // ── YIELD ───────────────────────────────────────────────────────\n  // live in-process (resource-operations.ts emits + awaits via race()); the\n  // client also .on()-subscribes -ok for cache invalidation\n  'yield:create':                        { result: 'yield:create-ok',                failure: 'yield:create-failed' },\n  // dormant — handler in stower exists, no request emitter; client pre-subscribes -ok\n  'yield:update':                        { result: 'yield:update-ok',                failure: 'yield:update-failed' },\n  'yield:clone-create':                  { result: 'yield:clone-created',            failure: 'yield:clone-create-failed' },\n  'yield:clone-resource-requested':      { result: 'yield:clone-resource-result',    failure: 'yield:clone-resource-failed' },\n  'yield:clone-token-requested':         { result: 'yield:clone-token-generated',    failure: 'yield:clone-token-failed' },\n} as const satisfies Partial<Record<EmittableChannel, BusOperationSpec>>;\n\n/** The request-channel key of a registered operation — what `busRequest` takes. */\nexport type BusOperationKey = keyof typeof BUS_OPERATIONS;\n","// ⚠ GENERATED FILE — do not edit.\n//\n// Authority:   specs/src/bus/registry.json  (channels, payloads, operations)\n// Regenerate:  node scripts/bus/generate-ts.mjs\n// Go counterpart: node scripts/bus/generate-go.mjs → packages/sdk-go/bus\n//\n// Payload schemas themselves live in the OpenAPI components; the registry\n// names which one each channel carries. Add or change a channel THERE.\n\nimport type { EventName } from './bus-protocol';\nimport { BUS_OPERATIONS } from './bus-operations';\n\n/**\n * BRIDGED_CHANNELS\n *\n * The set of bus channels that any concrete transport bridges into the\n * caller-supplied bus via `bridgeInto`. Transport-neutral: every concrete\n * `ITransport` shares the same set; HTTP delivers them via SSE, in-process\n * transports forward them directly from the local actor bus.\n *\n * This is the *fan-in* set — channels for events the transport receives and\n * pushes onto the client's bus. It is not the same as the channels the client\n * emits (which is open-ended).\n *\n * It is DERIVED, not hand-listed: the request/reply replies come from\n * `BUS_OPERATIONS` (bus-operations.ts), so no operation's reply can be\n * forgotten here — that was the recurring unbridged-reply bug class. The only\n * hand-maintained part is `BRIDGED_BROADCASTS`: the genuine non-request/reply\n * minority (lifecycle events and UI/infra signals that no single requester\n * owns). See .plans/BUS-OPERATIONS-REGISTRY.md.\n *\n * Resource-scoped channels (joined/left via `subscribeToResource`) are tracked\n * separately by transports that care about scope (HTTP).\n */\n\n/**\n * Bridged channels with no owning operation: job-lifecycle events (multi-viewer,\n * no single requester owns the reply), KB-global frame domain events, UI signals,\n * and SSE infrastructure. A reply channel must NOT go here — declare its\n * operation in `BUS_OPERATIONS` instead.\n */\nexport const BRIDGED_BROADCASTS = [\n  'job:report-progress',\n  'job:complete',\n  'job:fail',\n  'frame:entity-type-added',\n  'frame:tag-schema-added',\n  'beckon:focus',\n  'beckon:sparkle',\n  'bus:resume-gap',\n] as const satisfies readonly EventName[];\n\n// ── Derivation ──────────────────────────────────────────────────────────────\n// Every operation's result + failure (+ progress) channel bridges, by\n// construction. Type and runtime are derived from the same `BUS_OPERATIONS`.\n\ntype OpSpecs = (typeof BUS_OPERATIONS)[keyof typeof BUS_OPERATIONS];\n\n// Generic wrapper so the conditional distributes over each union member (a bare\n// `OpSpecs extends …` would test the whole union at once and collapse to never\n// because only the streaming ops carry `progress`).\ntype ProgressChannel<O> = O extends { progress: infer P extends EventName } ? P : never;\n\n/** The union of every reply channel declared in the registry. */\ntype RegistryReply = OpSpecs['result'] | OpSpecs['failure'] | ProgressChannel<OpSpecs>;\n\n// Iterate by typed key so each op's literal reply types survive — the element\n// type stays `RegistryReply` (no widening to `EventName`), so the composed\n// array is `BridgedChannel[]` with no narrowing assertion. The runtime proof\n// that this derived set is exactly the intended one is the equality test in\n// __tests__/bus-invariants.test.ts.\nconst REGISTRY_REPLIES = (Object.keys(BUS_OPERATIONS) as (keyof typeof BUS_OPERATIONS)[]).flatMap(\n  (key) => {\n    const op = BUS_OPERATIONS[key];\n    return 'progress' in op ? [op.result, op.failure, op.progress] : [op.result, op.failure];\n  },\n);\n\nexport const BRIDGED_CHANNELS: readonly BridgedChannel[] = [\n  ...REGISTRY_REPLIES,\n  ...BRIDGED_BROADCASTS,\n];\n\n/**\n * The SUBSCRIBE-side subset of `EventName` — the channels a client can receive\n * over a concrete transport. See the family note on `EventName` in\n * bus-protocol.ts (emit on an `EmittableChannel`, subscribe on a `BridgedChannel`).\n */\nexport type BridgedChannel = RegistryReply | (typeof BRIDGED_BROADCASTS)[number];\n","/**\n * Bus logging — runtime-toggleable cross-wire visibility.\n *\n * One line per event that crosses a process boundary, in a grep-able\n * format that's symmetric across frontend and backend:\n *\n *   [bus EMIT] <channel> [scope=X] [cid=<first8>] <payload>\n *   [bus RECV] <channel> [scope=X] [cid=<first8>] <payload>\n *   [bus SSE]  <channel> [scope=X] [cid=<first8>] <payload>\n *\n * Tier 1 of `.plans/OBSERVABILITY.md`. Forward-compatible with Tier 2:\n * the `cid` printed here is exactly the prefix of the W3C trace-id we\n * adopt later.\n *\n * Cost when disabled: one property read per call, zero allocations.\n *\n * Enable:\n *   - Browser:  `window.__SEMIONT_BUS_LOG__ = true` (DevTools or e2e init)\n *   - Node:     `SEMIONT_BUS_LOG=1` in the process env (read at module load)\n */\n\nimport { BRIDGED_CHANNELS } from './bridged-channels';\n\nconst NODE_BUS_LOG =\n  typeof process !== 'undefined' && !!process.env?.SEMIONT_BUS_LOG;\n\nconst IS_NODE =\n  typeof process !== 'undefined' && !!process.versions?.node;\n\nexport type BusOp = 'EMIT' | 'RECV' | 'SSE' | 'PUT' | 'GET';\n\nexport function busLogEnabled(): boolean {\n  const g = globalThis as { __SEMIONT_BUS_LOG__?: boolean };\n  if (g.__SEMIONT_BUS_LOG__) return true;\n  return NODE_BUS_LOG;\n}\n\n/**\n * Optional active-span trace-id provider. When a Tier 2 OTel SDK is\n * initialized, `@semiont/observability` registers a provider here that\n * returns the active span's W3C `trace_id`. busLog appends it to each\n * emitted line so the grep-timeline correlates with the span tree in\n * an APM UI.\n *\n * Decoupling: `@semiont/core` does not depend on `@opentelemetry/api`.\n * If no provider is registered (Tier 1-only deployments, or before\n * `initObservabilityNode` runs), the field is omitted from the line —\n * same shape as before this hook existed.\n */\nlet traceIdProvider: (() => string | undefined) | undefined;\n\nexport function setBusLogTraceIdProvider(fn: (() => string | undefined) | undefined): void {\n  traceIdProvider = fn;\n}\n\nexport function busLog(\n  op: BusOp,\n  channel: string,\n  payload: unknown,\n  scope?: string,\n): void {\n  if (!busLogEnabled()) return;\n  const cidRaw = (payload as { correlationId?: unknown } | null | undefined)?.correlationId;\n  const cid = typeof cidRaw === 'string' ? cidRaw.slice(0, 8) : undefined;\n  let traceId: string | undefined;\n  if (traceIdProvider) {\n    try { traceId = traceIdProvider(); } catch { /* noop */ }\n  }\n  const tag =\n    `[bus ${op}] ${channel}` +\n    (scope ? ` scope=${scope}` : '') +\n    (cid ? ` cid=${cid}` : '') +\n    (traceId ? ` trace=${traceId.slice(0, 8)}` : '');\n  // eslint-disable-next-line no-console\n  console.debug(tag, payload);\n}\n\n/**\n * Whether to run the unobserved-reply check on every local emit.\n *\n * On in Node (backend + worker + smelter), where a dropped reply is a real\n * delivery bug; off in the browser, where a 0-observer bridged reply just\n * means the awaiting `busRequest` already resolved/timed out (benign).\n *\n * Always-on (no env flag) by design: the failure it catches is rare and\n * high-signal, and the whole point is that it fires with zero setup — the\n * incident that motivated it (.plans/bugs/gather-resource-complete-not-bridged.md)\n * ran with bus-logging off, so a flag-gated check would have stayed silent.\n */\nexport function warnUnobservedRepliesEnabled(): boolean {\n  return IS_NODE;\n}\n\n/** One line per channel per process — a missing fan-in wiring is a config\n *  bug, so the first dropped reply is enough; we don't spam on retries. */\nconst unobservedReplyWarned = new Set<string>();\n\n/**\n * The silent-dropped-reply detector.\n *\n * A correlation-bearing payload is a request/reply *reply* (`*-result`,\n * `*-complete`, `*-failed`, …). If one is emitted on the backend bus with\n * **zero local observers**, nothing forwards it — no SSE subscription, no\n * in-process consumer — so the awaiting client never receives it and times\n * out 30 s later with no error logged anywhere. That is exactly how\n * `gather:resource-complete` failed when it was missing from\n * `BRIDGED_CHANNELS` (.plans/bugs/gather-resource-complete-not-bridged.md).\n *\n * Emits one WARN per channel naming the likely fix. Ignored (no warning):\n * non-reply emits (no `correlationId`), emits with observers, and — crucially —\n * channels already in `BRIDGED_CHANNELS`: a 0-observer emit there is a redundant\n * copy, not a gap (see .plans/bugs/BRIDGE-GAPS.md). So the detector fires only\n * for a genuine missing forwarder, and its remediation text is always correct.\n */\nexport function warnIfUnobservedReply(\n  channel: string,\n  payload: unknown,\n  observerCount: number,\n): void {\n  if (observerCount > 0) return;\n  const cidRaw = (payload as { correlationId?: unknown } | null | undefined)?.correlationId;\n  if (typeof cidRaw !== 'string' || cidRaw.length === 0) return;\n  // A 0-observer emit on a *bridged* channel is a redundant copy (a global +\n  // resource-scoped dual-emit, or an SSE reconnect replay), not a missing\n  // forwarder — the first copy already reached the awaiting `take(1)`\n  // subscriber. Only a NOT-bridged channel is a genuine drop. (`busRequest` now\n  // types its reply channels `BridgedChannel`, so an unbridged reply is a\n  // compile error; this runtime check covers non-`busRequest` correlation\n  // emits.) See .plans/bugs/BRIDGE-GAPS.md.\n  if ((BRIDGED_CHANNELS as readonly string[]).includes(channel)) return;\n  if (unobservedReplyWarned.has(channel)) return;\n  unobservedReplyWarned.add(channel);\n  // eslint-disable-next-line no-console\n  console.warn(\n    `[bus DROP] ${channel} cid=${cidRaw.slice(0, 8)} emitted with 0 subscribers and not in ` +\n      `BRIDGED_CHANNELS — a correlation reply with no forwarder is dropped, so the awaiting ` +\n      `client times out (no error). Bridge it by declaring its operation in BUS_OPERATIONS ` +\n      `(packages/core/src/bus-operations.ts) — or, if it is a non-reply broadcast, add it to ` +\n      `BRIDGED_BROADCASTS (packages/core/src/bridged-channels.ts) — so transports subscribe to it.`,\n  );\n}\n","/**\n * RxJS-based Event Bus\n *\n * Framework-agnostic event bus providing direct access to typed RxJS Subjects.\n *\n * Can be used in Node.js, browser, workers, CLI - anywhere RxJS runs.\n */\n\nimport { Subject } from 'rxjs';\nimport { busLog, busLogEnabled, warnIfUnobservedReply, warnUnobservedRepliesEnabled } from './bus-log';\nimport type { EventMap } from './bus-protocol';\nimport type { StoredEvent } from './event-base';\nimport type { PersistedEventType } from './persisted-events';\n\n/**\n * RxJS-based event bus\n *\n * Provides direct access to RxJS Subjects for each event type.\n * Use standard RxJS patterns for emitting and subscribing.\n *\n * @example\n * ```typescript\n * const eventBus = new EventBus();\n *\n * // Emit events\n * eventBus.get('beckon:hover').next({ annotationId: 'ann-1' });\n *\n * // Subscribe to events\n * const subscription = eventBus.get('beckon:hover').subscribe(({ annotationId }) => {\n *   console.log('Hover:', annotationId);\n * });\n *\n * // Use RxJS operators\n * import { debounceTime } from 'rxjs/operators';\n * eventBus.get('beckon:hover')\n *   .pipe(debounceTime(100))\n *   .subscribe(handleHover);\n *\n * // Cleanup\n * subscription.unsubscribe();\n * eventBus.destroy();\n * ```\n */\nexport class EventBus {\n  private subjects: Map<keyof EventMap, Subject<any>>;\n  private isDestroyed: boolean;\n\n  constructor() {\n    this.subjects = new Map();\n    this.isDestroyed = false;\n  }\n\n  /**\n   * Get the RxJS Subject for an event\n   *\n   * Returns a typed Subject that can be used with all RxJS operators.\n   * Subjects are created lazily on first access.\n   *\n   * @param eventName - The event name\n   * @returns The RxJS Subject for this event\n   *\n   * @example\n   * ```typescript\n   * // Emit\n   * eventBus.get('beckon:hover').next({ annotationId: 'ann-1' });\n   *\n   * // Subscribe\n   * const sub = eventBus.get('beckon:hover').subscribe(handleHover);\n   *\n   * // With operators\n   * eventBus.get('beckon:hover')\n   *   .pipe(debounceTime(100), distinctUntilChanged())\n   *   .subscribe(handleHover);\n   * ```\n   */\n  get<K extends keyof EventMap>(eventName: K): Subject<EventMap[K]> {\n    if (this.isDestroyed) {\n      throw new Error(`Cannot access event '${String(eventName)}' on destroyed bus`);\n    }\n\n    if (!this.subjects.has(eventName)) {\n      const subject = new Subject<EventMap[K]>();\n      // When bus-log is enabled (`SEMIONT_BUS_LOG=1` or\n      // `window.__SEMIONT_BUS_LOG__ = true`), wrap `.next()` so every\n      // local emit on this channel produces a `[bus EMIT] <channel> ...`\n      // line on `console.debug` — same shape as cross-wire emits from\n      // HttpTransport. This is what makes local-only fan-out signals\n      // (`beckon.hover`, `beckon.sparkle`, `mark.request`, etc.)\n      // visible to the e2e bus capture and to a developer's DevTools.\n      // The `busLogEnabled()` check is at first-`get` time per channel;\n      // setting the flag after channels are constructed won't\n      // retroactively wrap them. The bus capture fixture uses\n      // `addInitScript` so the flag is set before any namespace\n      // construction, which is when `get()` is first called.\n      //\n      // Independently, on Node we wrap `.next()` to catch *dropped replies*:\n      // a correlation-bearing payload emitted with zero observers (see\n      // `warnIfUnobservedReply`). This needs no flag — it's how the\n      // `gather:resource-complete` bridge gap stayed invisible until a 30 s\n      // timeout. The two wraps share one closure when both are active.\n      const wantBusLog = busLogEnabled();\n      const wantDropCheck = warnUnobservedRepliesEnabled();\n      if (wantBusLog || wantDropCheck) {\n        const wrapped = subject;\n        const originalNext = subject.next.bind(subject);\n        subject.next = (value: EventMap[K]): void => {\n          if (wantBusLog) busLog('EMIT', String(eventName), value as object);\n          if (wantDropCheck) warnIfUnobservedReply(String(eventName), value, wrapped.observers.length);\n          originalNext(value);\n        };\n      }\n      this.subjects.set(eventName, subject);\n    }\n    return this.subjects.get(eventName)!;\n  }\n\n  /**\n   * Get the RxJS Subject for a domain event type (PersistedEventType).\n   *\n   * Domain event channels carry `StoredEvent`. This method avoids the need\n   * for `as keyof EventMap` casts when subscribing to domain event channels\n   * using runtime `PersistedEventType` strings.\n   */\n  getDomainEvent(eventType: PersistedEventType): Subject<StoredEvent> {\n    return this.get(eventType as keyof EventMap) as unknown as Subject<StoredEvent>;\n  }\n\n  /**\n   * Destroy the event bus and complete all subjects\n   *\n   * After calling destroy(), no new events can be emitted or subscribed to.\n   * All active subscriptions will be completed.\n   */\n  destroy(): void {\n    if (this.isDestroyed) {\n      return;\n    }\n\n    for (const subject of this.subjects.values()) {\n      subject.complete();\n    }\n\n    this.subjects.clear();\n    this.isDestroyed = true;\n  }\n\n  /**\n   * Check if the event bus has been destroyed\n   */\n  get destroyed(): boolean {\n    return this.isDestroyed;\n  }\n\n  /**\n   * Create a resource-scoped event bus\n   *\n   * Events emitted or subscribed through the scoped bus are isolated to that resource.\n   * Internally, events are namespaced but the API remains identical to the parent bus.\n   *\n   * @param resourceId - Resource identifier to scope events to\n   * @returns A scoped event bus for this resource\n   *\n   * @example\n   * ```typescript\n   * const eventBus = new EventBus();\n   * const resource1 = eventBus.scope('resource-1');\n   * const resource2 = eventBus.scope('resource-2');\n   *\n   * // These are isolated - only resource1 subscribers will fire\n   * resource1.get('detection:progress').next({ status: 'started' });\n   * ```\n   */\n  scope(resourceId: string): ScopedEventBus {\n    return new ScopedEventBus(this, resourceId);\n  }\n}\n\n/**\n * Resource-scoped event bus\n *\n * Provides isolated event streams per resource while maintaining the same API\n * as the parent EventBus. Events are internally namespaced by resourceId.\n */\nexport class ScopedEventBus {\n  constructor(\n    private parent: EventBus,\n    private scopePrefix: string\n  ) {}\n\n  /**\n   * Get the RxJS Subject for a scoped event\n   *\n   * Returns the same type as the parent bus, but events are isolated to this scope.\n   * Internally uses namespaced keys but preserves type safety.\n   *\n   * @param event - The event name\n   * @returns The RxJS Subject for this scoped event\n   */\n  get<E extends keyof EventMap>(event: E): Subject<EventMap[E]> {\n    // Internally namespace the event key, but preserve return type\n    const scopedKey = `${this.scopePrefix}:${event as string}`;\n\n    // Access parent's subjects map directly (needs cast for private access)\n    const parentSubjects = (this.parent as any).subjects as Map<string, Subject<any>>;\n\n    if (!parentSubjects.has(scopedKey)) {\n      parentSubjects.set(scopedKey, new Subject<EventMap[E]>());\n    }\n    return parentSubjects.get(scopedKey)!;\n  }\n\n  /** Get the RxJS Subject for a domain event type on this scoped bus. */\n  getDomainEvent(eventType: PersistedEventType): Subject<StoredEvent> {\n    return this.get(eventType as keyof EventMap) as unknown as Subject<StoredEvent>;\n  }\n\n  /**\n   * Create a nested scope\n   *\n   * Allows hierarchical scoping like `resource-1:subsystem-a`\n   *\n   * @param subScope - Additional scope level\n   * @returns A nested scoped event bus\n   */\n  scope(subScope: string): ScopedEventBus {\n    return new ScopedEventBus(this.parent, `${this.scopePrefix}:${subScope}`);\n  }\n}\n"]}