@semiont/make-meaning 0.5.29 → 0.5.31

package/dist/archivist-main.js

@@ -1,12 +1,12 @@
 import { HttpTransport } from '@semiont/http-transport';
-import { accessToken, EventBus, baseUrl as baseUrl$1, errField, PERSISTED_EVENT_TYPES, retryWithBackoff, isTransientFetchError, STARTUP_FETCH_RETRY, userId, resourceId, generateUuid, annotationId, getBodySource, getTargetSource, getTargetSelector, getExactText, getStorageUri, cloneToken, getResourceEntityTypes, didToAgent, assembleAnnotation, busRequest, BUS_OPERATIONS, getPrimaryRepresentation, decodeRepresentation, getResourceId, deriveViews, getTextPositionSelector, isAnnotatable, softwareToAgent } from '@semiont/core';
+import { replyChannelsFor, accessToken, EventBus, baseUrl as baseUrl$1, errField, PERSISTED_EVENT_TYPES, retryWithBackoff, isTransientFetchError, STARTUP_FETCH_RETRY, userId, resourceId, generateUuid, annotationId, getBodySource, getTargetSource, getTargetSelector, getExactText, getStorageUri, cloneToken, getResourceEntityTypes, didToAgent, assembleAnnotation, busRequest, getPrimaryRepresentation, decodeRepresentation, getResourceId, deriveViews, getTextPositionSelector, isAnnotatable, softwareToAgent } from '@semiont/core';
 import { loadEnvironmentConfig, SemiontProject } from '@semiont/core/node';
 import { createEventStore, resolveStorageUri, EventQuery } from '@semiont/event-sourcing';
 import { WorkingTreeStore, createAnchoredTextStore, RepresentationMissing, ChecksumMismatchError } from '@semiont/content';
 import { getGraphDatabase, compareByRecencyThenId } from '@semiont/graph';
 import { createEmbeddingProvider, createVectorStore, mergeByResource } from '@semiont/vectors';
 import { promises } from 'fs';
-import { withActorSpan, recordGatherDegrade } from '@semiont/observability';
+import { registerFactPumpDepthProvider, withActorSpan, recordGatherDegrade } from '@semiont/observability';
 import * as path3 from 'path';
 import { DEFAULT_ENTITY_TYPES, getEntityTypes } from '@semiont/ontology';
 import { createInferenceClient } from '@semiont/inference';
@@ -7804,7 +7804,7 @@ var require_tap = __commonJS({
     var lift_1 = require_lift();
     var OperatorSubscriber_1 = require_OperatorSubscriber();
     var identity_1 = require_identity();
-    function tap(observerOrNext, error, complete) {
+    function tap2(observerOrNext, error, complete) {
       var tapObserver = isFunction_1.isFunction(observerOrNext) || error || complete ? { next: observerOrNext, error, complete } : observerOrNext;
       return tapObserver ? lift_1.operate(function(source, subscriber) {
         var _a;
@@ -7833,7 +7833,7 @@ var require_tap = __commonJS({
         }));
       }) : identity_1.identity;
     }
-    exports.tap = tap;
+    exports.tap = tap2;
   }
 });
 
@@ -9727,8 +9727,7 @@ var require_operators = __commonJS({
 });
 
 // src/archivist-main.ts
-var import_rxjs5 = __toESM(require_cjs());
-var import_operators4 = __toESM(require_operators());
+var import_rxjs6 = __toESM(require_cjs());
 
 // src/stower.ts
 var import_rxjs = __toESM(require_cjs());
@@ -9772,6 +9771,7 @@ var STOWER_CHANNELS = [
   "yield:update",
   "yield:mv",
   "mark:create",
+  "mark:commit",
   "mark:delete",
   "mark:update-body",
   "frame:add-entity-type",
@@ -9808,6 +9808,7 @@ var Stower = class {
       pipe("yield:update", (e) => this.handleYieldUpdate(e)),
       pipe("yield:mv", (e) => this.handleYieldMv(e)),
       pipe("mark:create", (e) => this.handleMarkCreate(e)),
+      pipe("mark:commit", (e) => this.handleMarkCommit(e)),
       pipe("mark:delete", (e) => this.handleMarkDelete(e)),
       pipe("mark:update-body", (e) => this.handleMarkUpdateBody(e)),
       pipe("frame:add-entity-type", (e) => this.handleAddEntityType(e)),
@@ -10033,6 +10034,61 @@ var Stower = class {
       });
     }
   }
+  /**
+   * Persist a detection unit's annotations as ONE acknowledged batch, then
+   * answer (JOB-RESTART-SAFETY P6).
+   *
+   * The difference from `mark:create` is the reply, and it is the whole point.
+   * `mark:create` is fire-and-forget: the worker's emit resolves when the bus
+   * accepts it, which says nothing about the event log, so a down Stower loses
+   * a unit silently and a flapping one hangs the worker forever. This answers
+   * only after every append has returned, so the worker can gate unit
+   * completion — and its checkpoint — on durability.
+   *
+   * Appends are sequential, not concurrent: the event log is the system of
+   * record and a batch that half-lands under concurrency is harder to reason
+   * about than one that stops at the first failure. A partial batch is
+   * reported as a failure and the worker retries the WHOLE unit, which is safe
+   * because ids are deterministic (P3) and the annotation fold is idempotent
+   * by id — re-appending what already landed changes nothing.
+   */
+  async handleMarkCommit(event) {
+    if (!event._userId) {
+      throw new Error("mark:commit missing _userId (gateway injection)");
+    }
+    const annotations = event.annotations ?? [];
+    try {
+      let persisted = 0;
+      for (const annotation of annotations) {
+        await this.stores.eventStore.appendEvent({
+          type: "mark:added",
+          resourceId: resourceId(event.resourceId),
+          userId: userId(event._userId),
+          version: 1,
+          payload: { annotation }
+        });
+        persisted++;
+      }
+      this.logger.debug("Committed annotation batch", {
+        correlationId: event.correlationId,
+        resourceId: event.resourceId,
+        persisted
+      });
+      this.eventBus.get("mark:commit-ok").next({
+        correlationId: event.correlationId,
+        response: { persisted, annotationIds: annotations.map((a) => String(a.id)) }
+      });
+    } catch (error) {
+      this.logger.error("Failed to commit annotation batch", {
+        correlationId: event.correlationId,
+        error: errField(error)
+      });
+      this.eventBus.get("mark:commit-failed").next({
+        correlationId: event.correlationId,
+        message: error instanceof Error ? error.message : String(error)
+      });
+    }
+  }
   async handleMarkDelete(event) {
     if (!event._userId) {
       throw new Error("mark:delete missing _userId (gateway injection)");
@@ -10280,8 +10336,8 @@ var import_operators2 = __toESM(require_operators());
 
 // src/smelt-progress.ts
 var SmeltProgressTimeout = class extends Error {
-  constructor(resourceId6, contentChecksum, timeoutMs) {
-    super(`smelt:settled not observed for ${resourceId6} (checksum ${contentChecksum.slice(0, 12)}\u2026) within ${timeoutMs}ms`);
+  constructor(resourceId8, contentChecksum, timeoutMs) {
+    super(`smelt:settled not observed for ${resourceId8} (checksum ${contentChecksum.slice(0, 12)}\u2026) within ${timeoutMs}ms`);
     this.name = "SmeltProgressTimeout";
   }
 };
@@ -10292,7 +10348,7 @@ function createSmeltProgress(eventBus) {
   const waiters = /* @__PURE__ */ new Set();
   let disposed = false;
   let lastSweep = Date.now();
-  const subscription = eventBus.get("smelt:settled").subscribe(({ resourceId: resourceId6, contentChecksum, outcome }) => {
+  const subscription = eventBus.get("smelt:settled").subscribe(({ resourceId: resourceId8, contentChecksum, outcome }) => {
     const now = Date.now();
     if (now - lastSweep >= SWEEP_INTERVAL_MS) {
       lastSweep = now;
@@ -10300,9 +10356,9 @@ function createSmeltProgress(eventBus) {
         if (now - entry.at >= SETTLED_TTL_MS) settled.delete(rid);
       }
     }
-    settled.set(resourceId6, { contentChecksum, outcome, at: now });
+    settled.set(resourceId8, { contentChecksum, outcome, at: now });
     for (const waiter of waiters) {
-      if (waiter.resourceId === resourceId6 && waiter.contentChecksum === contentChecksum) {
+      if (waiter.resourceId === resourceId8 && waiter.contentChecksum === contentChecksum) {
         clearTimeout(waiter.timer);
         waiters.delete(waiter);
         waiter.resolve(outcome);
@@ -10310,24 +10366,24 @@ function createSmeltProgress(eventBus) {
     }
   });
   return {
-    settledAt: (resourceId6) => {
-      const entry = settled.get(resourceId6);
+    settledAt: (resourceId8) => {
+      const entry = settled.get(resourceId8);
       return entry ? { contentChecksum: entry.contentChecksum, outcome: entry.outcome } : void 0;
     },
-    whenSettled: (resourceId6, contentChecksum, timeoutMs) => {
+    whenSettled: (resourceId8, contentChecksum, timeoutMs) => {
       if (disposed) return Promise.resolve("inert");
-      const current = settled.get(resourceId6);
+      const current = settled.get(resourceId8);
       if (current && current.contentChecksum === contentChecksum) {
         return Promise.resolve(current.outcome);
       }
       return new Promise((resolve2, reject) => {
         const waiter = {
-          resourceId: resourceId6,
+          resourceId: resourceId8,
           contentChecksum,
           resolve: resolve2,
           timer: setTimeout(() => {
             waiters.delete(waiter);
-            reject(new SmeltProgressTimeout(resourceId6, contentChecksum, timeoutMs));
+            reject(new SmeltProgressTimeout(resourceId8, contentChecksum, timeoutMs));
           }, timeoutMs)
         };
         waiters.add(waiter);
@@ -10349,17 +10405,19 @@ function createSmeltProgress(eventBus) {
 
 // src/read-anchored-text.ts
 var ANCHORED_TEXT_SETTLE_TIMEOUT_MS = 15e3;
-async function readAnchoredText(kb, resourceId6) {
-  const view = await kb.views.get(resourceId(resourceId6));
+async function readAnchoredText(kb, resourceId8, settleTimeoutMs = ANCHORED_TEXT_SETTLE_TIMEOUT_MS) {
+  const view = await kb.views.get(resourceId(resourceId8));
   const checksum = getPrimaryRepresentation(view?.resource)?.checksum;
-  if (!checksum) return null;
+  if (!checksum) return { kind: "unknown" };
   const hit = await kb.anchoredText.read(checksum);
   if (hit) return hit;
   try {
-    const outcome = await kb.smeltProgress.whenSettled(resourceId6, checksum, ANCHORED_TEXT_SETTLE_TIMEOUT_MS);
-    return outcome === "indexed" ? kb.anchoredText.read(checksum) : null;
+    const outcome = await kb.smeltProgress.whenSettled(resourceId8, checksum, settleTimeoutMs);
+    if (outcome === "skipped") return { kind: "no-map" };
+    if (outcome === "inert") return { kind: "not-yet" };
+    return await kb.anchoredText.read(checksum) ?? { kind: "not-yet" };
   } catch (error) {
-    if (error instanceof SmeltProgressTimeout) return null;
+    if (error instanceof SmeltProgressTimeout) return { kind: "not-yet" };
     throw error;
   }
 }
@@ -10411,11 +10469,11 @@ function representationSource(resource) {
     mediaType: primary.mediaType
   };
 }
-async function resolveRepresentation(deps, resourceId6) {
-  const view = await deps.views.get(resourceId6);
-  if (!view?.resource) throw new RepresentationMissing(String(resourceId6), "resource");
+async function resolveRepresentation(deps, resourceId8) {
+  const view = await deps.views.get(resourceId8);
+  if (!view?.resource) throw new RepresentationMissing(String(resourceId8), "resource");
   const source = representationSource(view.resource);
-  if (!source) throw new RepresentationMissing(String(resourceId6), "representation");
+  if (!source) throw new RepresentationMissing(String(resourceId8), "representation");
   return { stream: deps.content.retrieveStream(source.storageUri), mediaType: source.mediaType };
 }
 var SEMANTIC_OVER_FETCH = 4;
@@ -10423,8 +10481,8 @@ var ResourceContext = class _ResourceContext {
   /**
    * Get resource metadata from view storage
    */
-  static async getResourceMetadata(resourceId6, kb) {
-    const view = await kb.views.get(resourceId6);
+  static async getResourceMetadata(resourceId8, kb) {
+    const view = await kb.views.get(resourceId8);
     if (!view) {
       return null;
     }
@@ -10547,8 +10605,8 @@ var ResourceContext = class _ResourceContext {
 
 // src/weave-progress.ts
 var WeaveProgressTimeout = class extends Error {
-  constructor(resourceId6, sequenceNumber, timeoutMs) {
-    super(`weave:applied parity not reached for ${resourceId6} (seq ${sequenceNumber}) within ${timeoutMs}ms`);
+  constructor(resourceId8, sequenceNumber, timeoutMs) {
+    super(`weave:applied parity not reached for ${resourceId8} (seq ${sequenceNumber}) within ${timeoutMs}ms`);
     this.name = "WeaveProgressTimeout";
   }
 };
@@ -10572,19 +10630,19 @@ var GraphContext = class {
    *  - annotations on the resource → `annotation` nodes + `annotation-of` edges,
    *    so siblingEntityTypes = union of those nodes' entityTypes
    */
-  static async buildKnowledgeGraph(resourceId6, kb, logger2) {
-    let mainDoc = await kb.graph.getResource(resourceId6);
+  static async buildKnowledgeGraph(resourceId8, kb, logger2) {
+    let mainDoc = await kb.graph.getResource(resourceId8);
     if (!mainDoc) {
-      const view = await kb.views.get(resourceId6);
+      const view = await kb.views.get(resourceId8);
       if (view) {
         if (view.lastSequence !== void 0) {
           try {
             await kb.weaveProgress.whenApplied(
-              String(resourceId6),
+              String(resourceId8),
               view.lastSequence,
               PROJECTION_BARRIER_TIMEOUT_MS
             );
-            mainDoc = await kb.graph.getResource(resourceId6);
+            mainDoc = await kb.graph.getResource(resourceId8);
           } catch (error) {
             if (!(error instanceof WeaveProgressTimeout)) throw error;
           }
@@ -10592,19 +10650,19 @@ var GraphContext = class {
         if (!mainDoc) {
           for (const delayMs of PROJECTION_LAG_BACKOFF_MS) {
             await new Promise((resolve2) => setTimeout(resolve2, delayMs));
-            mainDoc = await kb.graph.getResource(resourceId6);
+            mainDoc = await kb.graph.getResource(resourceId8);
             if (mainDoc) break;
           }
         }
         if (!mainDoc) {
           recordGatherDegrade("graph");
           logger2?.warn("[gather DEGRADED] graph projection did not catch up \u2014 resource present in views, absent in graph", {
-            resourceId: String(resourceId6),
+            resourceId: String(resourceId8),
             lastSequence: view.lastSequence,
             barrierTimeoutMs: PROJECTION_BARRIER_TIMEOUT_MS
           });
           throw new Error(
-            `Graph projection did not catch up for ${String(resourceId6)} \u2014 present in views, absent in graph (Weaver lag, not a missing resource)`
+            `Graph projection did not catch up for ${String(resourceId8)} \u2014 present in views, absent in graph (Weaver lag, not a missing resource)`
           );
         }
       }
@@ -10612,11 +10670,11 @@ var GraphContext = class {
     if (!mainDoc) {
       throw new Error("Resource not found");
     }
-    const mainId = String(resourceId6);
+    const mainId = String(resourceId8);
     const [connections, referencedBy, annotations] = await Promise.all([
-      kb.graph.getResourceConnections(resourceId6),
-      kb.graph.getResourceReferencedBy(resourceId6),
-      kb.graph.getResourceAnnotations(resourceId6)
+      kb.graph.getResourceConnections(resourceId8),
+      kb.graph.getResourceReferencedBy(resourceId8),
+      kb.graph.getResourceAnnotations(resourceId8)
     ]);
     const nodes = [];
     const edges = [];
@@ -10636,7 +10694,7 @@ var GraphContext = class {
     const citedSeen = /* @__PURE__ */ new Set();
     for (const ann of referencedBy) {
       const source = getTargetSource(ann.target);
-      if (!source || source === String(resourceId6) || !ann.id || seen.has(ann.id)) continue;
+      if (!source || source === String(resourceId8) || !ann.id || seen.has(ann.id)) continue;
       if (!citedSeen.has(source)) {
         citedSeen.add(source);
         const view = await kb.views.get(resourceId(source));
@@ -10670,7 +10728,7 @@ var AnnotationContext = class {
    * @returns Rich context for LLM processing
    * @throws Error if annotation or resource not found
    */
-  static async buildLLMContext(annotationId4, resourceId6, kb, embeddingProvider, options = {}, inferenceClient, logger2) {
+  static async buildLLMContext(annotationId4, resourceId8, kb, embeddingProvider, options = {}, inferenceClient, logger2) {
     const {
       includeSourceContext = true,
       includeTargetContext = true,
@@ -10679,22 +10737,22 @@ var AnnotationContext = class {
     if (contextWindow < 100 || contextWindow > 5e3) {
       throw new Error("contextWindow must be between 100 and 5000");
     }
-    logger2?.debug("Building LLM context", { annotationId: annotationId4, resourceId: resourceId6 });
-    logger2?.debug("Getting view for resource", { resourceId: resourceId6 });
+    logger2?.debug("Building LLM context", { annotationId: annotationId4, resourceId: resourceId8 });
+    logger2?.debug("Getting view for resource", { resourceId: resourceId8 });
     let sourceView;
     try {
-      sourceView = await kb.views.get(resourceId6);
+      sourceView = await kb.views.get(resourceId8);
       logger2?.debug("Retrieved view", { hasView: !!sourceView });
       if (!sourceView) {
         throw new Error("Source resource not found");
       }
     } catch (error) {
-      logger2?.error("Error getting view", { resourceId: resourceId6, error });
+      logger2?.error("Error getting view", { resourceId: resourceId8, error });
       throw error;
     }
     logger2?.debug("Looking for annotation in resource", {
       annotationId: annotationId4,
-      resourceId: resourceId6,
+      resourceId: resourceId8,
       totalAnnotations: sourceView.annotations.annotations.length,
       firstFiveIds: sourceView.annotations.annotations.slice(0, 5).map((a) => a.id)
     });
@@ -10704,9 +10762,9 @@ var AnnotationContext = class {
       throw new Error("Annotation not found in view");
     }
     const targetSource = getTargetSource(annotation.target);
-    logger2?.debug("Validating target resource", { targetSource, expectedResourceId: resourceId6 });
-    if (targetSource !== String(resourceId6)) {
-      throw new Error(`Annotation target resource ID (${targetSource}) does not match expected resource ID (${resourceId6})`);
+    logger2?.debug("Validating target resource", { targetSource, expectedResourceId: resourceId8 });
+    if (targetSource !== String(resourceId8)) {
+      throw new Error(`Annotation target resource ID (${targetSource}) does not match expected resource ID (${resourceId8})`);
     }
     const sourceDoc = sourceView.resource;
     const bodySource = getBodySource(annotation.body);
@@ -10722,7 +10780,7 @@ var AnnotationContext = class {
         throw new Error("Source content not found: no storageUri");
       }
       const primaryRep = getPrimaryRepresentation(sourceDoc);
-      const { data: sourceContent } = await kb.content.getBinary(resourceId6);
+      const { data: sourceContent } = await kb.content.getBinary(resourceId8);
       const contentStr = decodeRepresentation(Buffer.from(sourceContent), primaryRep?.mediaType ?? "text/plain");
       const targetSelectorRaw = getTargetSelector(annotation.target);
       const targetSelector = Array.isArray(targetSelectorRaw) ? targetSelectorRaw[0] : targetSelectorRaw;
@@ -10769,9 +10827,9 @@ var AnnotationContext = class {
         };
       }
     }
-    logger2?.debug("Building knowledge graph", { resourceId: resourceId6 });
-    const graph = await GraphContext.buildKnowledgeGraph(resourceId6, kb, logger2);
-    const views = deriveViews(graph, String(resourceId6), annotationId4);
+    logger2?.debug("Building knowledge graph", { resourceId: resourceId8 });
+    const graph = await GraphContext.buildKnowledgeGraph(resourceId8, kb, logger2);
+    const views = deriveViews(graph, String(resourceId8), annotationId4);
     const entityTypeStats = await kb.graph.getEntityTypeStats();
     const entityTypeFrequencies = {};
     for (const stat of entityTypeStats) {
@@ -10808,7 +10866,7 @@ Summary:`;
         const results = await kb.vectors.searchAnnotations(focalEmbedding, {
           limit: 10,
           scoreThreshold: 0.5,
-          filter: { excludeResourceId: resourceId6 }
+          filter: { excludeResourceId: resourceId8 }
         });
         const similar = [];
         for (const r of results) {
@@ -10861,10 +10919,10 @@ Summary:`;
    * Get resource annotations from view storage (fast path)
    * Throws if view missing
    */
-  static async getResourceAnnotations(resourceId6, kb) {
-    const view = await kb.views.get(resourceId6);
+  static async getResourceAnnotations(resourceId8, kb) {
+    const view = await kb.views.get(resourceId8);
     if (!view) {
-      throw new Error(`Resource ${resourceId6} not found in view storage`);
+      throw new Error(`Resource ${resourceId8} not found in view storage`);
     }
     return view.annotations;
   }
@@ -10872,8 +10930,8 @@ Summary:`;
    * Get all annotations
    * @returns Array of all annotation objects
    */
-  static async getAllAnnotations(resourceId6, kb) {
-    const annotations = await this.getResourceAnnotations(resourceId6, kb);
+  static async getAllAnnotations(resourceId8, kb) {
+    const annotations = await this.getResourceAnnotations(resourceId8, kb);
     return this.enrichResolvedReferences(annotations.annotations, kb);
   }
   /**
@@ -10942,8 +11000,8 @@ Summary:`;
    * Get resource stats (version info)
    * @returns Version and timestamp info for the annotations
    */
-  static async getResourceStats(resourceId6, kb) {
-    const annotations = await this.getResourceAnnotations(resourceId6, kb);
+  static async getResourceStats(resourceId8, kb) {
+    const annotations = await this.getResourceAnnotations(resourceId8, kb);
     return {
       resourceId: annotations.resourceId,
       version: annotations.version,
@@ -10953,15 +11011,15 @@ Summary:`;
   /**
    * Check if resource exists in view storage
    */
-  static async resourceExists(resourceId6, kb) {
-    return kb.views.exists(resourceId6);
+  static async resourceExists(resourceId8, kb) {
+    return kb.views.exists(resourceId8);
   }
   /**
    * Get a single annotation by ID
    * O(1) lookup using resource ID to access view storage
    */
-  static async getAnnotation(annotationId4, resourceId6, kb) {
-    const annotations = await this.getResourceAnnotations(resourceId6, kb);
+  static async getAnnotation(annotationId4, resourceId8, kb) {
+    const annotations = await this.getResourceAnnotations(resourceId8, kb);
     return annotations.annotations.find((a) => a.id === annotationId4) || null;
   }
   /**
@@ -10978,8 +11036,8 @@ Summary:`;
   /**
    * Get annotation context (selected text with surrounding context)
    */
-  static async getAnnotationContext(annotationId4, resourceId6, contextBefore, contextAfter, kb) {
-    const annotation = await this.getAnnotation(annotationId4, resourceId6, kb);
+  static async getAnnotationContext(annotationId4, resourceId8, contextBefore, contextAfter, kb) {
+    const annotation = await this.getAnnotation(annotationId4, resourceId8, kb);
     if (!annotation) {
       throw new Error("Annotation not found");
     }
@@ -11010,8 +11068,8 @@ Summary:`;
   /**
    * Generate AI summary of annotation in context
    */
-  static async generateAnnotationSummary(annotationId4, resourceId6, kb, inferenceClient) {
-    const annotation = await this.getAnnotation(annotationId4, resourceId6, kb);
+  static async generateAnnotationSummary(annotationId4, resourceId8, kb, inferenceClient) {
+    const annotation = await this.getAnnotation(annotationId4, resourceId8, kb);
     if (!annotation) {
       throw new Error("Annotation not found");
     }
@@ -11092,10 +11150,10 @@ Entity types: ${entityTypes.join(", ")}`;
     return inferenceClient.generateText(summaryPrompt, 500, 0.5);
   }
 };
-async function assembleResourceGraph(kb, resourceId6) {
+async function assembleResourceGraph(kb, resourceId8) {
   const eventQuery = new EventQuery(kb.eventStore.log.storage);
-  const events = await eventQuery.getResourceEvents(resourceId6);
-  const stored = await kb.eventStore.views.materializer.materialize(events, resourceId6);
+  const events = await eventQuery.getResourceEvents(resourceId8);
+  const stored = await kb.eventStore.views.materializer.materialize(events, resourceId8);
   if (!stored) return null;
   const annotations = stored.annotations.annotations;
   const entityReferences = annotations.filter((a) => {
@@ -11214,7 +11272,6 @@ function deriveAgentRoster(config2) {
 var BROWSER_CHANNELS = [
   "browse:resource-requested",
   "browse:anchored-text-requested",
-  "browse:anchored-text-by-checksum-requested",
   "browse:resources-requested",
   "browse:annotations-requested",
   "browse:annotation-requested",
@@ -11267,7 +11324,6 @@ var Browser = class {
     this.subscriptions.push(
       pipe("browse:resource-requested", (e) => this.handleBrowseResource(e)).subscribe({ error: errorHandler }),
       pipe("browse:anchored-text-requested", (e) => this.handleAnchoredText(e)).subscribe({ error: errorHandler }),
-      pipe("browse:anchored-text-by-checksum-requested", (e) => this.handleAnchoredTextByChecksum(e)).subscribe({ error: errorHandler }),
       pipe("browse:resources-requested", (e) => this.handleBrowseResources(e)).subscribe({ error: errorHandler }),
       pipe("browse:annotations-requested", (e) => this.handleBrowseAnnotations(e)).subscribe({ error: errorHandler }),
       pipe("browse:annotation-requested", (e) => this.handleBrowseAnnotation(e)).subscribe({ error: errorHandler }),
@@ -11321,20 +11377,6 @@ var Browser = class {
    * parser nor engine. Read-only over the wire: the Smelter is the sole
    * writer and never answers here.
    */
-  async handleAnchoredTextByChecksum(event) {
-    try {
-      this.eventBus.get("browse:anchored-text-by-checksum-result").next({
-        correlationId: event.correlationId,
-        response: await this.kb.anchoredText.read(event.checksum)
-      });
-    } catch (error) {
-      this.logger.error("Browse anchored text by checksum failed", { checksum: event.checksum, error: errField(error) });
-      this.eventBus.get("browse:anchored-text-by-checksum-failed").next({
-        correlationId: event.correlationId,
-        message: error instanceof Error ? error.message : String(error)
-      });
-    }
-  }
   async handleBrowseResource(event) {
     try {
       const response = await assembleResourceGraph(this.kb, resourceId(event.resourceId));
@@ -12014,6 +12056,56 @@ var CloneTokenManager = class {
     this.logger.info("CloneTokenManager actor stopped");
   }
 };
+var MATCHER_CHANNELS = [
+  "match:search-requested"
+];
+
+// src/gatherer.ts
+var GATHERER_CHANNELS = [
+  "gather:requested",
+  "gather:resource-requested"
+];
+
+// src/service-channels.ts
+var SMELTER_AWAITED_OPERATIONS = [
+  "browse:resource-requested",
+  "browse:annotations-requested",
+  "browse:resources-requested"
+];
+replyChannelsFor(SMELTER_AWAITED_OPERATIONS);
+var WEAVER_AWAITED_OPERATIONS = [
+  "browse:resources-requested",
+  "browse:events-requested",
+  "browse:annotations-requested"
+];
+replyChannelsFor(WEAVER_AWAITED_OPERATIONS);
+var LIBRARIAN_INBOUND_CHANNELS = [
+  ...MATCHER_CHANNELS,
+  ...GATHERER_CHANNELS,
+  "gather:summary-requested",
+  "weave:applied",
+  "smelt:settled"
+];
+replyChannelsFor(LIBRARIAN_INBOUND_CHANNELS);
+var ARCHIVIST_INBOUND_CHANNELS = [
+  ...STOWER_CHANNELS,
+  ...BROWSER_CHANNELS,
+  ...CLONE_TOKEN_CHANNELS,
+  "mark:create-request",
+  "smelt:settled",
+  // The annotation-context read moved here with the bytes (SINGLE-KB-MOUNT D5).
+  "browse:annotation-context-requested"
+];
+var ARCHIVIST_OUTBOUND_STRAYS = [
+  "mark:body-update-failed",
+  // op keyed 'bind:update-body' (gateway handler re-emits mark:update-body)
+  "yield:move-failed"
+  // yield:mv has no registered operation; failure is direct-subscribed
+];
+var ARCHIVIST_OUTBOUND_CHANNELS = [
+  ...ARCHIVIST_OUTBOUND_STRAYS,
+  ...replyChannelsFor(ARCHIVIST_INBOUND_CHANNELS)
+];
 var LIMITS_ENRICH_BUDGET_MS = 1500;
 function createLimitsDiscovery(config2, logger2, options) {
   const clientFactory = createInferenceClient;
@@ -12157,6 +12249,40 @@ function createArchivistServer(deps) {
     res.end();
   });
 }
+
+// src/fact-pump.ts
+var import_rxjs5 = __toESM(require_cjs());
+function createFactPump(facts$, deps) {
+  let depth = 0;
+  const publish = async (event) => {
+    try {
+      const type = event.type;
+      await Promise.all([
+        deps.emit(type, event),
+        ...event.resourceId ? [deps.emit(type, event, event.resourceId)] : []
+      ]);
+    } catch (error) {
+      deps.logger.error("Fact publish failed \u2014 projectors will heal on their next catch-up", {
+        type: event.type,
+        resourceId: event.resourceId,
+        sequenceNumber: event.metadata?.sequenceNumber,
+        error: errField(error)
+      });
+    }
+  };
+  const subscription = facts$.pipe(
+    (0, import_rxjs5.tap)(() => {
+      depth += 1;
+    }),
+    (0, import_rxjs5.concatMap)((event) => (0, import_rxjs5.from)(publish(event).finally(() => {
+      depth -= 1;
+    })))
+  ).subscribe();
+  return {
+    depth: () => depth,
+    unsubscribe: () => subscription.unsubscribe()
+  };
+}
 async function assertAnnotatableTarget(kb, target) {
   const view = await kb.views.get(resourceId(target));
   const mediaType = getPrimaryRepresentation(view?.resource)?.mediaType;
@@ -12255,8 +12381,8 @@ function registerAnnotationContextHandler(eventBus, kb, parentLogger) {
 }
 function workingTreeContentReads(views, content) {
   return {
-    getBinary: async (resourceId6) => {
-      const { stream, mediaType } = await resolveRepresentation({ views, content }, resourceId6);
+    getBinary: async (resourceId8) => {
+      const { stream, mediaType } = await resolveRepresentation({ views, content }, resourceId8);
       const chunks = [];
       for await (const chunk of stream) chunks.push(chunk);
       const buf = Buffer.concat(chunks);
@@ -12303,15 +12429,15 @@ function eventAnnotationId(event) {
       return null;
   }
 }
-async function readAnnotationFromView(kb, resourceId6, annotationId4) {
-  const allAnnotations = await AnnotationContext.getAllAnnotations(resourceId6, kb);
+async function readAnnotationFromView(kb, resourceId8, annotationId4) {
+  const allAnnotations = await AnnotationContext.getAllAnnotations(resourceId8, kb);
   return allAnnotations.find((a) => a.id === annotationId4) ?? null;
 }
 function wireEnrichment(eventStore, kb) {
-  eventStore.setEnrichEvent(async (event, resourceId6) => {
+  eventStore.setEnrichEvent(async (event, resourceId8) => {
     const annId = eventAnnotationId(event);
     if (annId === null) return event;
-    const annotation = await readAnnotationFromView(kb, resourceId6, annId);
+    const annotation = await readAnnotationFromView(kb, resourceId8, annId);
     if (annotation === null) return event;
     return { ...event, annotation };
   });
@@ -12346,34 +12472,8 @@ if (config.services.vectors.type === "memory") {
 }
 var workerSecret = process.env.SEMIONT_WORKER_SECRET ?? "";
 var skipRebuild = process.env.SEMIONT_SKIP_REBUILD === "true";
-var healthPort = 9093;
+var healthPort = 24103;
 var logger = createProcessLogger("archivist");
-var INBOUND_CHANNELS = [
-  ...STOWER_CHANNELS,
-  ...BROWSER_CHANNELS,
-  ...CLONE_TOKEN_CHANNELS,
-  "mark:create-request",
-  "smelt:settled",
-  // The annotation-context read moved here with the bytes (SINGLE-KB-MOUNT D5).
-  "browse:annotation-context-requested"
-];
-var OUTBOUND_STRAYS = [
-  "mark:body-update-failed",
-  // op keyed 'bind:update-body' (gateway handler re-emits mark:update-body)
-  "yield:move-failed"
-  // yield:mv has no registered operation; failure is direct-subscribed
-];
-function outboundChannels() {
-  const out = new Set(OUTBOUND_STRAYS);
-  for (const ch of INBOUND_CHANNELS) {
-    const op = BUS_OPERATIONS[ch];
-    if (!op) continue;
-    out.add(op.result);
-    out.add(op.failure);
-    if ("progress" in op && op.progress) out.add(op.progress);
-  }
-  return [...out];
-}
 async function authenticate() {
   if (!workerSecret) {
     logger.warn("No SEMIONT_WORKER_SECRET set \u2014 using empty token");
@@ -12412,7 +12512,7 @@ async function main() {
   const { initObservabilityNode } = await import('@semiont/observability/node');
   initObservabilityNode({ serviceName: "semiont-archivist" });
   logger.info("Authenticating", { baseUrl });
-  const tokenSubject = new import_rxjs5.BehaviorSubject(accessToken(await authenticate()));
+  const tokenSubject = new import_rxjs6.BehaviorSubject(accessToken(await authenticate()));
   logger.info("Authenticated");
   const refreshToken = async () => {
     const token = await authenticate();
@@ -12487,18 +12587,22 @@ async function main() {
   const httpTransport = new HttpTransport({
     baseUrl: baseUrl$1(baseUrl),
     token$: tokenSubject,
-    tokenRefresher: refreshToken
+    tokenRefresher: refreshToken,
+    // Exactly the inbound roster — never the full bridged set, whose global
+    // reply fan-out is the worker-OOM failure mode. This process awaits no
+    // wire replies (busRequest's isSubscribed gate fails fast if one is ever
+    // added without growing the roster), so inbound IS the subscription.
+    channels: ARCHIVIST_INBOUND_CHANNELS
   });
   const pumps = [];
-  httpTransport.actor.addChannels([...INBOUND_CHANNELS]);
-  for (const channel of INBOUND_CHANNELS) {
+  for (const channel of ARCHIVIST_INBOUND_CHANNELS) {
     pumps.push(
       httpTransport.stream(channel).subscribe((payload) => {
         localBus.get(channel).next(payload);
       })
     );
   }
-  const outbound = outboundChannels();
+  const outbound = ARCHIVIST_OUTBOUND_CHANNELS;
   for (const channel of outbound) {
     pumps.push(
       localBus.get(channel).subscribe((payload) => {
@@ -12508,26 +12612,13 @@ async function main() {
       })
     );
   }
-  const publishFact = async (event) => {
-    try {
-      const type = event.type;
-      await httpTransport.emit(type, event);
-      if (event.resourceId) {
-        await httpTransport.emit(type, event, event.resourceId);
-      }
-    } catch (error) {
-      logger.error("Fact publish failed \u2014 projectors will heal on their next catch-up", {
-        type: event.type,
-        resourceId: event.resourceId,
-        sequenceNumber: event.metadata?.sequenceNumber,
-        error: errField(error)
-      });
-    }
-  };
-  pumps.push(
-    (0, import_rxjs5.merge)(...PERSISTED_EVENT_TYPES.map((type) => localBus.getDomainEvent(type))).pipe((0, import_operators4.concatMap)((event) => (0, import_rxjs5.from)(publishFact(event)))).subscribe()
+  const factPump = createFactPump(
+    (0, import_rxjs6.merge)(...PERSISTED_EVENT_TYPES.map((type) => localBus.getDomainEvent(type))),
+    { emit: (channel, payload, scope) => httpTransport.emit(channel, payload, scope), logger }
   );
-  logger.info("Bus pumps attached", { inbound: INBOUND_CHANNELS.length, outbound: outbound.length, facts: PERSISTED_EVENT_TYPES.length });
+  pumps.push({ unsubscribe: () => factPump.unsubscribe() });
+  registerFactPumpDepthProvider(() => factPump.depth());
+  logger.info("Bus pumps attached", { inbound: ARCHIVIST_INBOUND_CHANNELS.length, outbound: outbound.length, facts: PERSISTED_EVENT_TYPES.length });
   const server = createArchivistServer({
     events: eventStore.log,
     content,
@@ -12558,7 +12649,7 @@ async function main() {
   };
   process.on("SIGTERM", shutdown);
   process.on("SIGINT", shutdown);
-  logger.info("Archivist serving", { channels: INBOUND_CHANNELS.length });
+  logger.info("Archivist serving", { channels: ARCHIVIST_INBOUND_CHANNELS.length });
 }
 main().catch((error) => {
   logger.error("Fatal", { error: error instanceof Error ? error.message : String(error), stack: error instanceof Error ? error.stack : void 0 });