@semiont/make-meaning 0.5.26 → 0.5.28

package/dist/index.js

@@ -1,11 +1,12 @@
 import { STALL_THRESHOLD_MS, FsJobQueue } from '@semiont/jobs';
 import { FilesystemViewStorage, resolveStorageUri, EventQuery, createEventStore } from '@semiont/event-sourcing';
-import { getResourceEntityTypes, getResourceId, getTargetSource, resourceId, getPrimaryRepresentation, decodeRepresentation, getBodySource, getTargetSelector, deriveViews, getTextPositionSelector, annotationId, errField, userId, generateUuid, getExactText, busRequest, cloneToken, baseMediaType, isSupportedMediaType, capabilitiesOf, didToAgent, assembleAnnotation, jobId, entityType, baseUrl, busLog, BRIDGED_CHANNELS, burstBuffer, textExtractionOf, chunkText, getPrimaryMediaType, extensionForMediaType, applyBodyOperations, softwareToAgent } from '@semiont/core';
+import { getResourceEntityTypes, getResourceId, getTargetSource, resourceId, getPrimaryRepresentation, decodeRepresentation, getBodySource, getTargetSelector, deriveViews, getTextPositionSelector, annotationId, errField, userId, generateUuid, getExactText, busRequest, cloneToken, baseMediaType, isSupportedMediaType, capabilitiesOf, didToAgent, assembleAnnotation, isGenerationJobParams, jobId, entityType, baseUrl, busLog, BRIDGED_CHANNELS, burstBuffer, textExtractionOf, chunkText, getPrimaryMediaType, extensionForMediaType, applyBodyOperations, softwareToAgent } from '@semiont/core';
 import { recordGatherDegrade, withActorSpan, recordBusEmit, withSpan, SpanKind, registerJobQueueProvider, registerVectorIndexSizeProvider } from '@semiont/observability';
 import { createInferenceClient } from '@semiont/inference';
 import { compareByRecencyThenId, getGraphDatabase } from '@semiont/graph';
 import { WorkingTreeStore, createAnchoredTextStore, deriveStorageUri, anchoredTextStoreOverTransport, EXTRACTORS, calculateChecksum } from '@semiont/content';
 import { getEntityTypes, DEFAULT_ENTITY_TYPES } from '@semiont/ontology';
+import { mergeByResource } from '@semiont/vectors';
 import { promises } from 'fs';
 import * as path3 from 'path';
 import { createGzip, createGunzip } from 'zlib';
@@ -9905,11 +9906,9 @@ async function createKnowledgeBase(eventStore, project, graphDb, eventBus, logge
     graph: graphDb,
     weaveProgress,
     smeltProgress,
+    vectors: options.vectorStore,
     projectionsDir: project.projectionsDir
   };
-  if (options?.vectorStore) {
-    kb.vectors = options.vectorStore;
-  }
   return kb;
 }
 var PROJECTION_LAG_BACKOFF_MS = [25, 50, 100, 200];
@@ -10015,15 +10014,20 @@ var GraphContext = class {
     const citedSeen = /* @__PURE__ */ new Set();
     for (const ann of referencedBy) {
       const source = getTargetSource(ann.target);
-      if (!source || source === String(resourceId10) || citedSeen.has(source)) continue;
-      citedSeen.add(source);
-      const view = await kb.views.get(resourceId(source));
-      addResourceNode(source, view?.resource?.name ?? source, view?.resource ? getResourceEntityTypes(view.resource) : []);
-      edges.push({ source, target: mainId, type: "citation" });
+      if (!source || source === String(resourceId10) || !ann.id || seen.has(ann.id)) continue;
+      if (!citedSeen.has(source)) {
+        citedSeen.add(source);
+        const view = await kb.views.get(resourceId(source));
+        addResourceNode(source, view?.resource?.name ?? source, view?.resource ? getResourceEntityTypes(view.resource) : []);
+      }
+      nodes.push({ id: ann.id, type: "annotation", label: ann.motivation ?? "annotation", entityTypes: getEntityTypes(ann), annotation: ann });
+      seen.add(ann.id);
+      edges.push({ source: ann.id, target: source, type: "annotation-of" });
+      edges.push({ source: ann.id, target: mainId, type: "cites" });
     }
     for (const ann of annotations) {
       if (!ann.id || seen.has(ann.id)) continue;
-      nodes.push({ id: ann.id, type: "annotation", label: ann.motivation ?? "annotation", entityTypes: getEntityTypes(ann) });
+      nodes.push({ id: ann.id, type: "annotation", label: ann.motivation ?? "annotation", entityTypes: getEntityTypes(ann), annotation: ann });
       seen.add(ann.id);
       edges.push({ source: ann.id, target: mainId, type: "annotation-of" });
     }
@@ -10057,7 +10061,19 @@ Format as a simple list, one suggestion per line.`;
   }
   return response.split("\n").map((line) => line.replace(/^[-*•]\s*/, "").trim()).filter((line) => line.length > 0).slice(0, 3);
 }
-var ResourceContext = class {
+
+// src/graph-read-grace.ts
+async function resourceWithViewGrace(kb, rid) {
+  const fromGraph = await kb.graph.getResource(rid).catch(() => null);
+  if (fromGraph) return { resource: fromGraph, laggedBehindView: false };
+  const view = await kb.views.get(rid);
+  if (view) return { resource: view.resource, laggedBehindView: true };
+  return { resource: null, laggedBehindView: false };
+}
+
+// src/resource-context.ts
+var SEMANTIC_OVER_FETCH = 4;
+var ResourceContext = class _ResourceContext {
   /**
    * Get resource metadata from view storage
    */
@@ -10082,21 +10098,67 @@ var ResourceContext = class {
    * barrier-stamped projection, so an unsearched listing is read-your-writes
    * where the graph is only eventually consistent.
    */
-  static async listResources(filters, kb) {
+  static async listResources(filters, kb, semantic) {
     const { search: rawSearch, archived, entityType: entityType2, offset = 0, limit = 50 } = filters ?? {};
     const search = rawSearch?.trim() || void 0;
     if (search) {
-      return kb.graph.listResources({
+      const lexical = await kb.graph.listResources({
         search,
         archived,
         entityTypes: entityType2 ? [entityType2] : void 0,
         offset,
         limit
       });
+      if (lexical.total > 0 || offset > 0) return { ...lexical, matchKind: "lexical" };
+      return _ResourceContext.semanticFallback(search, limit, kb, semantic);
     }
     const allViews = await kb.views.getAll();
     const matches = allViews.map((view) => view.resource).filter((doc) => archived === void 0 || doc.archived === archived).filter((doc) => !entityType2 || getResourceEntityTypes(doc).includes(entityType2)).sort(compareByRecencyThenId);
-    return { resources: matches.slice(offset, offset + limit), total: matches.length };
+    return { resources: matches.slice(offset, offset + limit), total: matches.length, matchKind: "lexical" };
+  }
+  /**
+   * Answer an empty lexical search from the vector index (SEMANTIC-FALLBACK):
+   * embed the query once, fold chunk hits per resource, floor them, and label
+   * the answer 'semantic' so the UI can say "no title matches, but these
+   * documents discuss it".
+   *
+   * Degradation is the contract (axioms S3–S5): unconfigured vectors, an
+   * absent provider, or ANY failure inside the fallback yields the same
+   * empty page the caller already had, labelled 'lexical' — a broken
+   * fallback must never turn a working empty search into an error.
+   *
+   * The floor is applied HERE rather than passed as `scoreThreshold`, so the
+   * below-floor hits exist to be counted — the debug line is the evidence
+   * decision #1's guessed 0.6 gets tuned from.
+   */
+  static async semanticFallback(search, limit, kb, semantic) {
+    const empty = { resources: [], total: 0, matchKind: "lexical" };
+    try {
+      const embedding = await semantic.embeddingProvider.embed(search);
+      const hits = await kb.vectors.searchResources(embedding, { limit: limit * SEMANTIC_OVER_FETCH });
+      const merged = mergeByResource(hits);
+      const aboveFloor = merged.filter((h) => h.score >= semantic.semanticFloor);
+      semantic.logger.debug("[search FALLBACK] semantic score distribution", {
+        chunkHits: hits.length,
+        resources: merged.length,
+        aboveFloor: aboveFloor.length,
+        belowFloor: merged.length - aboveFloor.length,
+        topScore: merged[0]?.score,
+        bottomScore: merged[merged.length - 1]?.score,
+        floor: semantic.semanticFloor
+      });
+      const resources = [];
+      for (const hit of aboveFloor.slice(0, limit)) {
+        const { resource } = await resourceWithViewGrace(kb, hit.resourceId);
+        if (resource) resources.push({ ...resource, content: hit.text });
+      }
+      return { resources, total: aboveFloor.length, matchKind: "semantic" };
+    } catch (error) {
+      semantic.logger.warn("[search FALLBACK] degraded to the empty lexical page", {
+        reason: error instanceof Error ? error.message : String(error)
+      });
+      return empty;
+    }
   }
   /**
    * Add content previews to resources (for search results)
@@ -10146,7 +10208,7 @@ var AnnotationContext = class {
    * @returns Rich context for LLM processing
    * @throws Error if annotation or resource not found
    */
-  static async buildLLMContext(annotationId5, resourceId10, kb, options = {}, inferenceClient, logger, embeddingProvider) {
+  static async buildLLMContext(annotationId5, resourceId10, kb, embeddingProvider, options = {}, inferenceClient, logger) {
     const {
       includeSourceContext = true,
       includeTargetContext = true,
@@ -10278,7 +10340,7 @@ Summary:`;
       }
     }
     let semanticContext;
-    if (kb.vectors && embeddingProvider && sourceContext?.selected) {
+    if (sourceContext?.selected) {
       try {
         const focalEmbedding = await embeddingProvider.embed(sourceContext.selected);
         const results = await kb.vectors.searchAnnotations(focalEmbedding, {
@@ -10286,18 +10348,27 @@ Summary:`;
           scoreThreshold: 0.5,
           filter: { excludeResourceId: resourceId10 }
         });
-        if (results.length > 0) {
-          semanticContext = {
-            similar: results.map((r) => ({
-              text: r.text,
-              resourceId: r.resourceId,
-              annotationId: r.annotationId,
-              score: r.score,
-              entityTypes: r.entityTypes,
-              ...r.machineRead ? { machineRead: true } : {}
-            }))
-          };
-          logger?.debug("Semantic context found", { matches: results.length });
+        const similar = [];
+        for (const r of results) {
+          const matchView = await kb.views.get(r.resourceId);
+          const resourceName = matchView?.resource?.name;
+          if (!resourceName) {
+            logger?.debug("Semantic match dropped \u2014 no view for source resource", { resourceId: String(r.resourceId) });
+            continue;
+          }
+          similar.push({
+            text: r.text,
+            resourceId: r.resourceId,
+            resourceName,
+            annotationId: r.annotationId,
+            score: r.score,
+            entityTypes: r.entityTypes,
+            ...r.machineRead ? { machineRead: true } : {}
+          });
+        }
+        if (similar.length > 0) {
+          semanticContext = { similar };
+          logger?.debug("Semantic context found", { matches: similar.length });
         }
       } catch (error) {
         logger?.warn("Semantic context search failed", { error });
@@ -10602,43 +10673,54 @@ var LLMContext = class {
     if (options.includeContent) content.related = relatedContent;
     let semanticContext;
     const vectors = kb.vectors;
-    if (vectors) {
-      const excludeEntityTypes = options.excludeEntityTypes ?? [];
-      const search = () => vectors.searchByResource(resourceId10, {
-        limit: options.maxResources,
-        scoreThreshold: 0.5,
-        ...excludeEntityTypes.length ? { filter: { excludeEntityTypes } } : {}
-      });
-      let matches = await search();
-      if (matches.length === 0) {
-        const contentChecksum = getPrimaryRepresentation(mainDoc)?.checksum;
-        if (contentChecksum) {
-          try {
-            const outcome = await kb.smeltProgress.whenSettled(resourceIdStr, contentChecksum, settleTimeoutMs);
-            if (outcome === "indexed") {
-              matches = await search();
-            }
-          } catch (error) {
-            if (!(error instanceof SmeltProgressTimeout)) throw error;
-            recordGatherDegrade("vectors");
-            logger.warn("[gather DEGRADED] semanticContext absent \u2014 the vector projection did not settle within the barrier", {
-              resourceId: resourceIdStr,
-              contentChecksum,
-              timeoutMs: settleTimeoutMs
-            });
-          }
+    const excludeEntityTypes = options.excludeEntityTypes ?? [];
+    const search = () => vectors.searchByResource(resourceId10, {
+      limit: options.maxResources,
+      scoreThreshold: 0.5,
+      ...excludeEntityTypes.length ? { filter: { excludeEntityTypes } } : {}
+    });
+    let matches = await search();
+    if (matches.length === 0) {
+      const contentChecksum = getPrimaryRepresentation(mainDoc)?.checksum;
+      if (contentChecksum) {
+        try {
+          const outcome = await kb.smeltProgress.whenSettled(resourceIdStr, contentChecksum, settleTimeoutMs);
+          if (outcome === "indexed") {
+            matches = await search();
+          }
+        } catch (error) {
+          if (!(error instanceof SmeltProgressTimeout)) throw error;
+          recordGatherDegrade("vectors");
+          logger.warn("[gather DEGRADED] semanticContext absent \u2014 the vector projection did not settle within the barrier", {
+            resourceId: resourceIdStr,
+            contentChecksum,
+            timeoutMs: settleTimeoutMs
+          });
         }
       }
-      if (matches.length > 0) {
+    }
+    if (matches.length > 0) {
+      const similar = [];
+      for (const m of matches) {
+        const matchView = await kb.views.get(m.resourceId);
+        const resourceName = matchView?.resource?.name;
+        if (!resourceName) {
+          logger?.debug("Semantic match dropped \u2014 no view for source resource", { resourceId: String(m.resourceId) });
+          continue;
+        }
+        similar.push({
+          text: m.text,
+          resourceId: m.resourceId,
+          resourceName,
+          ...m.annotationId ? { annotationId: m.annotationId } : {},
+          score: m.score,
+          ...m.entityTypes ? { entityTypes: m.entityTypes } : {},
+          ...m.machineRead ? { machineRead: true } : {}
+        });
+      }
+      if (similar.length > 0) {
         semanticContext = {
-          similar: matches.map((m) => ({
-            text: m.text,
-            resourceId: m.resourceId,
-            ...m.annotationId ? { annotationId: m.annotationId } : {},
-            score: m.score,
-            ...m.entityTypes ? { entityTypes: m.entityTypes } : {},
-            ...m.machineRead ? { machineRead: true } : {}
-          })),
+          similar,
           ...excludeEntityTypes.length ? { excludedEntityTypes: excludeEntityTypes } : {}
         };
       }
@@ -10719,10 +10801,10 @@ var Gatherer = class {
         annotationId(event.annotationId),
         resourceId(event.resourceId),
         this.kb,
+        this.embeddingProvider,
         event.options ?? {},
         this.inferenceClient,
-        this.logger,
-        this.embeddingProvider
+        this.logger
       );
       this.eventBus.get("gather:complete").next({
         correlationId: event.correlationId,
@@ -10791,17 +10873,6 @@ var Gatherer = class {
 // src/matcher.ts
 var import_rxjs2 = __toESM(require_cjs());
 var import_operators2 = __toESM(require_operators());
-
-// src/graph-read-grace.ts
-async function resourceWithViewGrace(kb, rid) {
-  const fromGraph = await kb.graph.getResource(rid).catch(() => null);
-  if (fromGraph) return { resource: fromGraph, laggedBehindView: false };
-  const view = await kb.views.get(rid);
-  if (view) return { resource: view.resource, laggedBehindView: true };
-  return { resource: null, laggedBehindView: false };
-}
-
-// src/matcher.ts
 var Matcher = class {
   constructor(kb, eventBus, logger, inferenceClient, embeddingProvider) {
     this.kb = kb;
@@ -11116,7 +11187,7 @@ For each candidate, output a line with the number and score, like:
    * from the scorer.
    */
   async searchVectors(searchTerm) {
-    if (!this.kb.vectors || !this.embeddingProvider || !searchTerm.trim()) return [];
+    if (!searchTerm.trim()) return [];
     try {
       const embedding = await this.embeddingProvider.embed(searchTerm);
       const results = await this.kb.vectors.searchResources(embedding, {
@@ -11680,6 +11751,29 @@ var JOB_TYPES = [
   "tag-annotation",
   "generation"
 ];
+var inferencePairKey = (provider, model) => `${provider} ${model}`;
+function eachAdmittedInference(config, visit) {
+  for (const jobType of JOB_TYPES) {
+    try {
+      visit(resolveWorkerInference(config, jobType), jobType);
+    } catch {
+    }
+  }
+  for (const actor of ["gatherer", "matcher"]) {
+    try {
+      visit(resolveActorInference(config, actor));
+    } catch {
+    }
+  }
+}
+function deriveInferencePairs(config) {
+  const pairs = /* @__PURE__ */ new Map();
+  eachAdmittedInference(config, (inference) => {
+    const key = inferencePairKey(inference.type, inference.model);
+    if (!pairs.has(key)) pairs.set(key, inference);
+  });
+  return pairs;
+}
 function deriveAgentRoster(config) {
   const domain = config.site?.domain;
   if (!domain) {
@@ -11688,8 +11782,8 @@ function deriveAgentRoster(config) {
     );
   }
   const roster = /* @__PURE__ */ new Map();
-  const admit = (inference, jobType) => {
-    const key = `${inference.type}\0${inference.model}`;
+  eachAdmittedInference(config, (inference, jobType) => {
+    const key = inferencePairKey(inference.type, inference.model);
     let entry = roster.get(key);
     if (!entry) {
       entry = {
@@ -11699,19 +11793,7 @@ function deriveAgentRoster(config) {
       roster.set(key, entry);
     }
     if (jobType) entry.servesJobTypes.push(jobType);
-  };
-  for (const jobType of JOB_TYPES) {
-    try {
-      admit(resolveWorkerInference(config, jobType), jobType);
-    } catch {
-    }
-  }
-  for (const actor of ["gatherer", "matcher"]) {
-    try {
-      admit(resolveActorInference(config, actor));
-    } catch {
-    }
-  }
+  });
   return [...roster.values()].map(
     ({ agent, servesJobTypes }) => servesJobTypes.length ? { agent, servesJobTypes } : { agent }
   );
@@ -11719,12 +11801,14 @@ function deriveAgentRoster(config) {
 
 // src/browser.ts
 var Browser = class {
-  constructor(views, kb, eventBus, project, config, logger) {
+  constructor(views, kb, eventBus, project, config, limitsDiscovery, embeddingProvider, logger) {
     this.views = views;
     this.kb = kb;
     this.eventBus = eventBus;
     this.project = project;
     this.config = config;
+    this.limitsDiscovery = limitsDiscovery;
+    this.embeddingProvider = embeddingProvider;
     this.logger = logger;
   }
   views;
@@ -11732,6 +11816,8 @@ var Browser = class {
   eventBus;
   project;
   config;
+  limitsDiscovery;
+  embeddingProvider;
   subscriptions = [];
   logger;
   async initialize() {
@@ -11826,21 +11912,28 @@ var Browser = class {
     try {
       const offset = event.offset ?? 0;
       const limit = event.limit ?? 50;
-      const { resources, total } = await ResourceContext.listResources({
+      const result = await ResourceContext.listResources({
         search: event.search,
         archived: event.archived,
         entityType: event.entityType,
         offset,
         limit
-      }, this.kb);
-      const formattedDocs = event.search ? await ResourceContext.addContentPreviews(resources, this.kb) : resources;
+      }, this.kb, {
+        embeddingProvider: this.embeddingProvider,
+        semanticFloor: this.config.search.semanticFloor,
+        logger: this.logger
+      });
+      const formattedDocs = event.search && result.matchKind === "lexical" ? await ResourceContext.addContentPreviews(result.resources, this.kb) : result.resources;
       this.eventBus.get("browse:resources-result").next({
         correlationId: event.correlationId,
         response: {
           resources: formattedDocs,
-          total,
+          total: result.total,
           offset,
-          limit
+          limit,
+          // The producer of the answer labels it (P1b moved the label here
+          // from a hardcoded 'lexical' when the fallback landed).
+          matchKind: result.matchKind
         }
       });
     } catch (error) {
@@ -12049,7 +12142,7 @@ var Browser = class {
   }
   async handleBrowseAgents(event) {
     try {
-      const agents = deriveAgentRoster(this.config);
+      const agents = await this.limitsDiscovery.enrich(deriveAgentRoster(this.config));
       this.eventBus.get("browse:agents-result").next({
         correlationId: event.correlationId,
         response: { agents }
@@ -12166,6 +12259,63 @@ var Browser = class {
     this.logger.info("Browser actor stopped");
   }
 };
+var LIMITS_ENRICH_BUDGET_MS = 1500;
+function createLimitsDiscovery(config, logger, options) {
+  const clientFactory = createInferenceClient;
+  const budgetMs = LIMITS_ENRICH_BUDGET_MS;
+  const clients = /* @__PURE__ */ new Map();
+  for (const [pair, inference] of deriveInferencePairs(config)) {
+    try {
+      clients.set(pair, clientFactory(inference, logger));
+    } catch (error) {
+      logger.debug("Limits discovery: client construction failed \u2014 pair enriches as absent", {
+        pair,
+        reason: error instanceof Error ? error.message : String(error)
+      });
+    }
+  }
+  const consult = async (pair, client) => {
+    let timer2;
+    try {
+      const discovery = client.limits();
+      const raced = await Promise.race([
+        discovery,
+        new Promise((resolve2) => {
+          timer2 = setTimeout(() => resolve2(void 0), budgetMs);
+        })
+      ]);
+      if (raced === void 0) {
+        void discovery.catch(() => {
+        });
+        logger.debug("Limits discovery: consult exceeded budget \u2014 entry enriches as absent", { pair, budgetMs });
+        return void 0;
+      }
+      return { contextTokens: raced.contextTokens, maxOutputTokens: raced.maxOutputTokens };
+    } catch (error) {
+      logger.debug("Limits discovery: consult failed \u2014 entry enriches as absent", {
+        pair,
+        reason: error instanceof Error ? error.message : String(error)
+      });
+      return void 0;
+    } finally {
+      clearTimeout(timer2);
+    }
+  };
+  return {
+    async enrich(entries) {
+      const settled = await Promise.allSettled(entries.map(async (entry) => {
+        const agent = entry.agent;
+        if (agent["@type"] !== "Software" || !agent.provider || !agent.model) return entry;
+        const pair = inferencePairKey(agent.provider, agent.model);
+        const client = clients.get(pair);
+        if (!client) return entry;
+        const limits = await consult(pair, client);
+        return limits ? { ...entry, limits } : entry;
+      }));
+      return settled.map((s, i) => s.status === "fulfilled" ? s.value : entries[i]);
+    }
+  };
+}
 
 // src/event-enrichment.ts
 function eventAnnotationId(event) {
@@ -12195,7 +12345,7 @@ function asBusRequestPrimitive(eventBus) {
   return {
     emit(channel, payload) {
       eventBus.get(channel).next(payload);
-      return Promise.resolve();
+      return Promise.resolve(-1);
     },
     stream(channel) {
       return eventBus.get(channel).asObservable();
@@ -12644,6 +12794,38 @@ function registerJobCommandHandlers(eventBus, jobQueue, project, parentLogger) {
         throw new Error("_userId is required (injected by bus gateway)");
       }
       const user = parseDidUser(_userId);
+      let effectiveResourceId;
+      if (jobType === "generation") {
+        if (resId !== void 0) {
+          throw new Error(
+            "generation job:create must omit resourceId \u2014 the context's focus is authoritative"
+          );
+        }
+        const bag = params;
+        if (bag && bag.referenceId !== void 0) {
+          throw new Error(
+            "generation job:create must omit params.referenceId \u2014 the context's focus is authoritative"
+          );
+        }
+        if (!isGenerationJobParams(params)) {
+          throw new Error(
+            "generation params do not satisfy GenerationJobParams (title, storageUri, and context are required)"
+          );
+        }
+        const focus = params.context.focus;
+        const rid = focus?.kind === "resource" ? focus.resource?.["@id"] : focus?.kind === "annotation" ? focus.sourceResource?.["@id"] : void 0;
+        if (typeof rid !== "string" || rid.length === 0) {
+          throw new Error(
+            "generation context has no usable focus \u2014 pass a GatheredContext produced by gather.resource(...) or gather.annotation(...)"
+          );
+        }
+        effectiveResourceId = rid;
+      } else {
+        if (typeof resId !== "string" || resId.length === 0) {
+          throw new Error(`${jobType} job:create requires resourceId`);
+        }
+        effectiveResourceId = resId;
+      }
       const job = {
         status: "pending",
         metadata: {
@@ -12662,7 +12844,7 @@ function registerJobCommandHandlers(eventBus, jobQueue, project, parentLogger) {
           maxRetries: jobType === "generation" ? 0 : 1
         },
         params: {
-          resourceId: resourceId(resId),
+          resourceId: resourceId(effectiveResourceId),
           ...params
         }
       };
@@ -12868,35 +13050,40 @@ async function createKnowledgeSystemFromConfig(project, config, eventBus, logger
   logger.info("Connecting to graph database", { type: graphConfig.type });
   const graphDb = await withStartupTimeout("Graph database", getGraphDatabase(graphConfig));
   const eventStore = createEventStore(project, eventBus, logger.child({ component: "event-store" }));
-  let vectorStore;
-  let embeddingProvider;
   const vectorsConfig = config.services.vectors;
   const embeddingConfig = config.services.embedding;
-  if (vectorsConfig && embeddingConfig) {
-    const { createVectorStore, createEmbeddingProvider } = await import('@semiont/vectors');
-    logger.info("Connecting to embedding provider", { type: embeddingConfig.type, model: embeddingConfig.model });
-    embeddingProvider = await withStartupTimeout(
-      "Embedding provider",
-      createEmbeddingProvider(embeddingConfig)
-    );
-    logger.info("Connecting to vector store", { type: vectorsConfig.type ?? "qdrant" });
-    vectorStore = await withStartupTimeout(
-      "Vector store",
-      createVectorStore({
-        type: vectorsConfig.type ?? "qdrant",
-        host: vectorsConfig.host,
-        port: vectorsConfig.port,
-        dimensions: embeddingProvider.dimensions()
-      })
-    );
-    logger.info("Vector search initialized", {
-      store: vectorsConfig.type,
-      embedding: embeddingConfig.type,
-      model: embeddingConfig.model
-    });
-    const store = vectorStore;
-    registerVectorIndexSizeProvider(() => store.count());
+  const { createVectorStore, createEmbeddingProvider } = await import('@semiont/vectors');
+  logger.info("Connecting to embedding provider", { type: embeddingConfig.type, model: embeddingConfig.model });
+  const embeddingProvider = await withStartupTimeout(
+    "Embedding provider",
+    createEmbeddingProvider(embeddingConfig)
+  );
+  logger.info("Connecting to vector store", { type: vectorsConfig.type });
+  const vectorStore = await withStartupTimeout(
+    "Vector store",
+    createVectorStore({
+      type: vectorsConfig.type,
+      host: vectorsConfig.host,
+      port: vectorsConfig.port,
+      // Dimensionality is discovered from the provider, so it is passed as a
+      // thunk rather than probed here: the store calls it only if it needs it
+      // (Qdrant, and only to CREATE a collection). This matches how inference
+      // treats provider-derived facts — the client is built with no I/O and
+      // `limits()` are discovered at the point of use — instead of making a
+      // network round-trip a precondition of booting. A `memory` store, or a
+      // Qdrant whose collections already exist, never consults the provider.
+      dimensions: () => embeddingProvider.dimensions()
+    })
+  );
+  if (vectorsConfig.type === "memory") {
+    logger.info("memory vector store: the index rebuilds from the event log on every restart (reconcile re-embeds)");
   }
+  logger.info("Vector search initialized", {
+    store: vectorsConfig.type,
+    embedding: embeddingConfig.type,
+    model: embeddingConfig.model
+  });
+  registerVectorIndexSizeProvider(() => vectorStore.count());
   const kb = await createKnowledgeBase(eventStore, project, graphDb, eventBus, logger, {
     vectorStore,
     skipRebuild
@@ -12928,7 +13115,8 @@ async function createKnowledgeSystemFromConfig(project, config, eventBus, logger
     embeddingProvider
   );
   await matcher.initialize();
-  const browser = new Browser(kb.views, kb, eventBus, project, config, logger.child({ component: "browser" }));
+  const limitsDiscovery = createLimitsDiscovery(config, logger.child({ component: "limits-discovery" }));
+  const browser = new Browser(kb.views, kb, eventBus, project, config, limitsDiscovery, embeddingProvider, logger.child({ component: "browser" }));
   await browser.initialize();
   const cloneTokenManager = new CloneTokenManager(kb, eventBus, logger.child({ component: "clone-token-manager" }));
   await cloneTokenManager.initialize();
@@ -13011,6 +13199,7 @@ var LocalTransport = class {
         }
       }
     );
+    return -1;
   }
   on(channel, handler) {
     const sub = this.bus.get(channel).subscribe(handler);
@@ -13455,11 +13644,11 @@ var Smelter = class _Smelter {
       key: checksum,
       store: this.anchoredStore
     });
-    if ("declined" in extracted || !extracted.items?.length) {
+    if (extracted.kind === "declined" || !extracted.items?.length) {
       this.logger.info("Re-anchor extraction yielded no geometry", {
         resourceId: rid,
         contentType,
-        ..."declined" in extracted ? { declined: extracted.declined } : {}
+        ...extracted.kind === "declined" ? { declined: extracted.declined } : {}
       });
       return;
     }
@@ -13494,7 +13683,7 @@ var Smelter = class _Smelter {
         key: checksum,
         store: this.anchoredStore
       });
-      if ("declined" in extracted) {
+      if (extracted.kind === "declined") {
         this.logger.debug("Extractor declined", { resourceId: resourceId10, contentType, reason: extracted.declined });
         return { kind: "skipped", checksum, reason: extracted.declined };
       }
@@ -14238,7 +14427,6 @@ async function replayEvent(event, eventBus, eventStore, resolveBlob, contentStor
       break;
     // Job events are transient — skip during replay
     case "job:started":
-    case "job:progress":
     case "job:completed":
     case "job:failed":
       logger?.debug("Skipping job event during replay", { type: event.type });