@neuralis/brain-core 0.1.0 → 0.2.1

package/dist/src/embeddings/factory.js

@@ -20,11 +20,12 @@
  *    blocking `buildSharedInfra()` during brain-core init().
  */
 import { resolveOperatorEndpointEgress } from '@neuralis/package-system/web-common';
-import { resolveActiveEmbeddingConfig, resolveActiveEmbeddingShape, resolveEmbeddingConfigFor, resolveEmbeddingModel, getBrainConfigNumber, getBrainConfigProvider, getBrainConfigString, ActiveEmbeddingModelUnresolvableError, } from '../config/env.js';
+import { resolveActiveEmbeddingConfig, requireEmbeddingEnabled, resolveActiveEmbeddingShape, resolveEmbeddingConfigFor, resolveEmbeddingModel, getBrainConfigNumber, getBrainConfigProvider, getBrainConfigString, ActiveEmbeddingModelUnresolvableError, EmbeddingDisabledError, EmbeddingMetadataOnlyError, EmbeddingCredentialMissingError, EmbeddingUnavailableError, } from '../config/env.js';
 import { buildEmbedUsageGuard } from './usageGate.js';
 import { embedModelMarker, embedRecipeOf, supportsEmbedInput, tagEmbedding } from './models.js';
 import { peekActiveLock } from './lock.js';
-import { CHARS_PER_TOKEN, estimateMediaTokens, estimateTokens, getEmbeddingUsageMeter } from './usage.js';
+import { CHARS_PER_TOKEN, estimateMediaTokens, estimateTokens, getEmbeddingUsageMeter, isEmbeddingBudgetStopError } from './usage.js';
+import { isProviderQuotaExhaustedError } from './providerQuota.js';
 import { DeterministicEmbedder } from './clients/DeterministicEmbedder.js';
 import { OllamaEmbedder } from './clients/OllamaEmbedder.js';
 import { OPENAI_MAX_INPUT_CHARS, OpenAIEmbedder } from './clients/OpenAIEmbedder.js';
@@ -257,13 +258,31 @@ function activeBuildFingerprint() {
     const provider = getBrainConfigProvider();
     const lock = peekActiveLock();
     return JSON.stringify([
-        lock ? `${lock.modelId}@${lock.dimension}#${lock.embedRecipe}` : [provider?.get('embeddingModelId'), provider?.get('embeddingDimension')],
+        lock?.mode === 'dense' ? `${lock.modelId}@${lock.dimension}#${lock.embedRecipe}` : [provider?.get('embeddingModelId'), provider?.get('embeddingDimension')],
         provider?.get('embeddingEndpoints') ?? null,
         provider?.get('openaiBaseUrl') ?? null,
         provider?.get('qwenEmbeddingBaseUrl') ?? null,
         provider?.get('ollamaUrl') ?? null,
     ]);
 }
+/** Safe availability reasons; arbitrary provider/schema/program errors do not qualify. */
+export function embeddingUnavailableReason(error) {
+    if (error instanceof EmbeddingUnavailableError)
+        return error.reason;
+    if (error instanceof EmbeddingDisabledError)
+        return 'disabled';
+    if (error instanceof EmbeddingMetadataOnlyError)
+        return 'metadata_only';
+    if (error instanceof EmbeddingCredentialMissingError)
+        return 'credentials';
+    if (error instanceof ActiveEmbeddingModelUnresolvableError)
+        return 'model_missing';
+    if (isEmbeddingBudgetStopError(error))
+        return 'budget';
+    if (isProviderQuotaExhaustedError(error))
+        return 'quota';
+    return undefined;
+}
 /** A media input the model's registry row does not list (the modality gate). */
 export class EmbedInputUnsupportedError extends Error {
     kind;
@@ -287,6 +306,7 @@ export class LazyEmbedder {
     #builtAt = embedderGeneration;
     #builtFrom = '';
     async #resolve() {
+        requireEmbeddingEnabled();
         const fingerprint = activeBuildFingerprint();
         if (this.#cached && (this.#builtAt !== embedderGeneration || this.#builtFrom !== fingerprint)) {
             this.#cached = null;

package/dist/src/embeddings/factory.js.map

@@ -1 +1 @@
-{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../../src/embeddings/factory.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../../src/embeddings/factory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,6BAA6B,EAAE,MAAM,qCAAqC,CAAC;AAEpF,OAAO,EACL,4BAA4B,EAC5B,uBAAuB,EACvB,2BAA2B,EAC3B,yBAAyB,EACzB,qBAAqB,EACrB,oBAAoB,EACpB,sBAAsB,EACtB,oBAAoB,EACpB,qCAAqC,EACrC,sBAAsB,EACtB,0BAA0B,EAC1B,+BAA+B,EAC/B,yBAAyB,GAE1B,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,kBAAkB,EAAE,YAAY,EAAmD,MAAM,aAAa,CAAC;AACjJ,OAAO,EAAE,cAAc,EAA4B,MAAM,WAAW,CAAC;AACrE,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,cAAc,EAAE,sBAAsB,EAAE,0BAA0B,EAAE,MAAM,YAAY,CAAC;AACtI,OAAO,EAAE,6BAA6B,EAAE,MAAM,oBAAoB,CAAC;AACnE,OAAO,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAC3E,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,sBAAsB,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AACrF,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAE7D,kEAAkE;AAClE,SAAS,SAAS,CAAC,MAA+B;IAChD,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC;IACnD,IAAI,OAAO,KAAK,MAAM,IAAI,CAAC,OAAO;QAAE,OAAO,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,SAAS,EAAE,UAAU,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;IACtG,MAAM,MAAM,GAAG;QACb,EAAE,EAAE,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,QAAQ;QACpC,OAAO;QACP,8EAA8E;QAC9E,IAAI,EAAE,MAAe;QACrB,OAAO;QACP,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAChC,CAAC;IACF,OAAO,KAAK,IAAI,EAAE;QAChB,MAAM,GAAG,GAAG,MAAM,6BAA6B,CAAC,MAAM,CAAC,CAAC;QACxD,OAAO,EAAE,SAAS,EAAE,GAAG,CAAC,SAAS,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC;IAC5D,CAAC,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,MAAgC;IAEhC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,4BAA4B,EAAE,CAAC,CAAC;IAClE,MAAM,MAAM,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC;IACrC,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC,YAAY,KAAK,IAAI,IAAI,QAAQ,CAAC,IAAI,CAAC,UAAU,KAAK,SAAS,CAAC;IAC9F,OAAO,OAAO,CAAC,CAAC,CAAC,IAAI,eAAe,CAAC,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;AACvE,CAAC;AAED,uEAAuE;AACvE,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,UAA+B;IACpE,MAAM,IAAI,GAAG,qBAAqB,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;IACvD,IAAI,CAAC,IAAI;QAAE,MAAM,IAAI,qCAAqC,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;IAC/E,IAAI,aAAa,CAAC,IAAI,CAAC,KAAK,UAAU,CAAC,WAAW,EAAE,CAAC;QACnD,wEAAwE;QACxE,uEAAuE;QACvE,MAAM,IAAI,KAAK,CAAC,4BAA4B,UAAU,CAAC,OAAO,IAAI,UAAU,CAAC,WAAW,KAAK,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACtH,CAAC;IACD,OAAO,aAAa,CAAC,MAAM,yBAAyB,CAAC,IAAI,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC;AACpF,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAwB;IACzD,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,cAAc,GAAG,eAAe,CAAC,CAAC;IACnE,QAAQ,IAAI,CAAC,QAAQ,EAAE,CAAC;QACtB,KAAK,QAAQ,CAAC;QACd,KAAK,UAAU;YACb,OAAO,IAAI,CAAC,GAAG,CAAC,sBAAsB,EAAE,QAAQ,CAAC,CAAC;QACpD;YACE,OAAO,QAAQ,CAAC;IACpB,CAAC;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAwB;IACvD,OAAO,IAAI,CAAC,QAAQ,KAAK,QAAQ,IAAI,IAAI,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;AAC/F,CAAC;AAED,SAAS,WAAW,CAAC,QAAiC;IACpD,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,QAAQ,CAAC;IACtD,2EAA2E;IAC3E,6EAA6E;IAC7E,2EAA2E;IAC3E,kFAAkF;IAClF,MAAM,SAAS,GAAG,oBAAoB,CAAC,IAAI,CAAC,YAAY,IAAI,SAAS,CAAC,CAAC;IACvE,MAAM,MAAM,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;IAEnC,QAAQ,IAAI,CAAC,QAAQ,EAAE,CAAC;QACtB,KAAK,eAAe;YAClB,OAAO,IAAI,qBAAqB,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC;QAClD,KAAK,QAAQ;YACX,OAAO,IAAI,cAAc,CAAC;gBACxB,GAAG,EAAE,OAAO,IAAI,IAAI,CAAC,cAAe;gBACpC,KAAK,EAAE,IAAI,CAAC,UAAU;gBACtB,sEAAsE;gBACtE,yEAAyE;gBACzE,aAAa,EAAE,IAAI,CAAC,GAAG,CACrB,CAAC,EACD,oBAAoB,CAAC,6BAA6B,EAAE,gCAAgC,EAAE,CAAC,CAAC,CACzF;gBACD,oGAAoG;gBACpG,SAAS,EAAE,oBAAoB,CAAC,uBAAuB,EAAE,SAAS,EAAE,KAAK,CAAC;aAC3E,CAAC,CAAC;QACL,KAAK,QAAQ,CAAC;QACd,KAAK,UAAU;YACb,OAAO,IAAI,cAAc,CAAC;gBACxB,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC7B,MAAM;gBACN,SAAS;gBACT,KAAK,EAAE,IAAI,CAAC,UAAU;gBACtB,SAAS;gBACT,OAAO,EAAE,OAAO,IAAI,IAAI,CAAC,cAAe;gBACxC,mDAAmD;gBACnD,UAAU,EAAE,oBAAoB,CAAC,uBAAuB,EAAE,SAAS,EAAE,CAAC,CAAC;aACxE,CAAC,CAAC;QACL,KAAK,QAAQ;YACX,OAAO,IAAI,cAAc,CAAC;gBACxB,aAAa,EAAE,kBAAkB,CAAC,IAAI,CAAC;gBACvC,UAAU,EAAE,oBAAoB,CAAC,uBAAuB,EAAE,SAAS,EAAE,CAAC,CAAC;gBACvE,MAAM,EAAE,MAAO;gBACf,MAAM;gBACN,SAAS;gBACT,KAAK,EAAE,IAAI,CAAC,UAAU;gBACtB,SAAS;gBACT,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC/B,WAAW,EAAE,aAAa,CAAC,IAAI,CAAC,KAAK,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW;aAC1E,CAAC,CAAC;QACL,KAAK,MAAM;YACT,OAAO,IAAI,YAAY,CAAC;gBACtB,MAAM,EAAE,MAAO;gBACf,MAAM;gBACN,SAAS;gBACT,KAAK,EAAE,IAAI,CAAC,UAAU;gBACtB,SAAS;gBACT,OAAO,EAAE,OAAO,IAAI,IAAI,CAAC,cAAe;aACzC,CAAC,CAAC;QACL,KAAK,QAAQ;YACX,OAAO,IAAI,cAAc,CAAC;gBACxB,MAAM,EAAE,MAAO;gBACf,MAAM;gBACN,SAAS;gBACT,KAAK,EAAE,IAAI,CAAC,UAAU;gBACtB,SAAS;gBACT,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC/B,UAAU,EAAE,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC;aAC9C,CAAC,CAAC;IACP,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,OAAO,eAAe;IACjB,MAAM,CAAe;IACrB,KAAK,CAAqB;IAEnC,qCAAqC;IACrC,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,YAAY,KAAmB,EAAE,IAAwB;QACvD,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QACpB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAClB,IAAI,CAAC,KAAK,CAAC,UAAU;YAAE,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;QACnD,IAAI,CAAC,KAAK,CAAC,YAAY;YAAE,IAAI,CAAC,YAAY,GAAG,SAAS,CAAC;IACzD,CAAC;IAED,OAAO,CAAC,QAAgB,EAAE,MAA0B,EAAE,SAAS,GAAG,KAAK;QACrE,sBAAsB,EAAE,EAAE,MAAM,CAAC;YAC/B,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,EAAE;YACpB,MAAM,EAAE,MAAM,IAAI,QAAQ;YAC1B,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACrF,GAAG,CAAC,MAAM,KAAK,SAAS,IAAI,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAClE,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,UAAU;QACd,OAAO,gBAAgB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACtC,CAAC;IAED,YAAY,GAAmE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;QACnG,sBAAsB,EAAE,EAAE,QAAQ,EAAE,CAAC;QACrC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,YAAa,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QAC5D,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,KAAK,MAAM;YACpC,CAAC,CAAC,cAAc,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC;YACnC,CAAC,CAAC,mBAAmB,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QAC5D,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,MAAM,CAAC,KAAK,EAAE,eAAe,EAAE,MAAM,CAAC,KAAK,EAAE,QAAQ,EAAE,SAAS,KAAK,IAAI,CAAC,CAAC;QAClG,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC;IAEF,KAAK,CAAC,SAAS,CAAC,IAAY,EAAE,IAAgB;QAC5C,sBAAsB,EAAE,EAAE,QAAQ,EAAE,CAAC;QACrC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QACvD,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,KAAK,EAAE,eAAe,EAAE,MAAM,CAAC,KAAK,EAAE,QAAQ,EAAE,SAAS,KAAK,IAAI,CAAC,CAAC;QACrH,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,UAAU,GAAsE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;QACpG,sBAAsB,EAAE,EAAE,QAAQ,EAAE,CAAC;QACrC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,UAAW,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QAC1D,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,KAAK,EAAE,eAAe,EAAE,MAAM,CAAC,KAAK,EAAE,QAAQ,EAAE,SAAS,KAAK,IAAI,CAAC,CAAC;QACrJ,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC;CACH;AAED;;;;;GAKG;AACH,IAAI,kBAAkB,GAAG,CAAC,CAAC;AAE3B,+FAA+F;AAC/F,MAAM,UAAU,mBAAmB;IACjC,kBAAkB,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,qCAAqC,CAAC,KAAkC;IACtF,IAAI,KAAK,CAAC,KAAK,CAAC,IAAI,KAAK,QAAQ;QAAE,OAAO;IAC1C,mBAAmB,EAAE,CAAC;AACxB,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,sBAAsB;IAC7B,MAAM,QAAQ,GAAG,sBAAsB,EAAE,CAAC;IAC1C,MAAM,IAAI,GAAG,cAAc,EAAE,CAAC;IAC9B,OAAO,IAAI,CAAC,SAAS,CAAC;QACpB,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,GAAG,CAAC,kBAAkB,CAAC,EAAE,QAAQ,EAAE,GAAG,CAAC,oBAAoB,CAAC,CAAC;QAC3J,QAAQ,EAAE,GAAG,CAAC,oBAAoB,CAAC,IAAI,IAAI;QAC3C,QAAQ,EAAE,GAAG,CAAC,eAAe,CAAC,IAAI,IAAI;QACtC,QAAQ,EAAE,GAAG,CAAC,sBAAsB,CAAC,IAAI,IAAI;QAC7C,QAAQ,EAAE,GAAG,CAAC,WAAW,CAAC,IAAI,IAAI;KACnC,CAAC,CAAC;AACL,CAAC;AAID,0FAA0F;AAC1F,MAAM,UAAU,0BAA0B,CAAC,KAAc;IACvD,IAAI,KAAK,YAAY,yBAAyB;QAAE,OAAO,KAAK,CAAC,MAAM,CAAC;IACpE,IAAI,KAAK,YAAY,sBAAsB;QAAE,OAAO,UAAU,CAAC;IAC/D,IAAI,KAAK,YAAY,0BAA0B;QAAE,OAAO,eAAe,CAAC;IACxE,IAAI,KAAK,YAAY,+BAA+B;QAAE,OAAO,aAAa,CAAC;IAC3E,IAAI,KAAK,YAAY,qCAAqC;QAAE,OAAO,eAAe,CAAC;IACnF,IAAI,0BAA0B,CAAC,KAAK,CAAC;QAAE,OAAO,QAAQ,CAAC;IACvD,IAAI,6BAA6B,CAAC,KAAK,CAAC;QAAE,OAAO,OAAO,CAAC;IACzD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,gFAAgF;AAChF,MAAM,OAAO,0BAA2B,SAAQ,KAAK;IAE9B,IAAI;IADhB,IAAI,GAAG,yBAAkC,CAAC;IACnD,YAAqB,IAAY;QAC/B,KAAK,CAAC,2BAA2B,IAAI,4DAA4D,CAAC,CAAC;oBADhF,IAAI;QAEvB,IAAI,CAAC,IAAI,GAAG,4BAA4B,CAAC;IAC3C,CAAC;CACF;AAED;;;;;;GAMG;AACH,MAAM,OAAO,YAAY;IACvB,OAAO,GAAuB,IAAI,CAAC;IACnC,QAAQ,GAAgC,IAAI,CAAC;IAC7C,QAAQ,GAAG,kBAAkB,CAAC;IAC9B,UAAU,GAAG,EAAE,CAAC;IAEhB,KAAK,CAAC,QAAQ;QACZ,uBAAuB,EAAE,CAAC;QAC1B,MAAM,WAAW,GAAG,sBAAsB,EAAE,CAAC;QAC7C,IAAI,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,QAAQ,KAAK,kBAAkB,IAAI,IAAI,CAAC,UAAU,KAAK,WAAW,CAAC,EAAE,CAAC;YAC9F,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACtB,CAAC;QACD,IAAI,IAAI,CAAC,OAAO;YAAE,OAAO,IAAI,CAAC,OAAO,CAAC;QACtC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACnB,IAAI,CAAC,QAAQ,GAAG,kBAAkB,CAAC;YACnC,IAAI,CAAC,UAAU,GAAG,WAAW,CAAC;YAC9B,IAAI,CAAC,QAAQ,GAAG,4BAA4B,EAAE;iBAC3C,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC;gBACvB,IAAI,EAAE,MAAM,aAAa,CAAC,MAAM,CAAC;gBACjC,MAAM,EAAE,gBAAgB,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,MAAM,CAAC,SAAS,EAAE,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;gBACtF,UAAU,EAAE,gBAAgB,CAAC,MAAM,CAAC,IAAI,CAAC;aAC1C,CAAC,CAAC;iBACF,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE;gBACd,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;gBACrB,OAAO,KAAK,CAAC;YACf,CAAC,CAAC;iBACD,OAAO,CAAC,GAAG,EAAE;gBACZ,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;YACvB,CAAC,CAAC,CAAC;QACP,CAAC;QACD,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,IAAY,EAAE,IAAgB;QAC5C,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,QAAQ,EAAE,CAAC;QAC/C,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAChD,YAAY,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;QACvC,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,UAAU;QACd,IAAI,CAAC;YACH,OAAO,gBAAgB,CAAC,CAAC,MAAM,2BAA2B,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;QACtE,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,CAAC,MAAM,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,YAAY,CAAC,KAAiB,EAAE,IAAgB;QACpD,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM;YAAE,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QACnE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,IAAI,CAAC,QAAQ,EAAE,CAAC;QAC3D,IAAI,CAAC,IAAI,CAAC,YAAY,IAAI,CAAC,kBAAkB,CAAC,UAAU,EAAE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YACtE,MAAM,IAAI,0BAA0B,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACnD,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QACpD,YAAY,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;QACvC,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,KAAe,EAAE,IAAgB;QAChD,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,QAAQ,EAAE,CAAC;QAC/C,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACpB,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;YACjD,KAAK,MAAM,MAAM,IAAI,KAAK,CAAC,UAAU;gBAAE,YAAY,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YACpE,OAAO,KAAK,CAAC;QACf,CAAC;QACD,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;QAC7E,OAAO;YACL,UAAU,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;YACjE,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,KAAK;SACzB,CAAC;IACJ,CAAC;CACF"}

package/dist/src/embeddings/lock.d.ts

@@ -14,16 +14,17 @@
  * the run (paused) with its shadow — a resume re-verifies from the start but
  * re-embeds only what the shadow does not already hold.
  *
- * Format: v2. A v1 lock (dimension-only, one collection) reads as generation 1
- * with the base recipe; a lock NEWER than this binary is a typed refusal
+ * Format: v3 metadata/dense serving records, the ONLY format this runtime reads.
+ * A v1/v2 lock is refused naming the offline upgrade (`pnpm neuralis:upgrade`,
+ * `scripts/embeddingLockV3.ts`); a lock NEWER than this binary is a typed refusal
  * (`RecordNewerError`) — never "no lock", which is what used to overwrite it.
  * Writes are durable (temp + fsync + rename, mode 0600) and serialized in this
  * process, so a batch cursor, a dirty-id flush and the swap never interleave.
  */
-import { type EmbeddingProviderId } from './models.js';
+import type { EmbeddingProviderId } from './models.js';
 /** The data-format ledger kind of this record (declared in `store/dataFormats.ts`). */
 export declare const EMBEDDING_LOCK_KIND: "brain-core/embedding-lock";
-export declare const EMBEDDING_LOCK_VERSION: 2;
+export declare const EMBEDDING_LOCK_VERSION: 3;
 /** One model's identity as the vectors of a generation know it. */
 export type EmbeddingGeneration = {
     modelId: string;
@@ -39,6 +40,7 @@ export type EmbeddingRebuild = {
     generation: number;
     shadowCollection: string;
     state: EmbeddingRebuildState;
+    phase: 'prepared' | 'copying' | 'ready';
     startedAt: string;
     /** The scan's position in the ACTIVE collection (progress; a resume re-verifies from the start). */
     cursor?: string;
@@ -59,20 +61,27 @@ export type EmbeddingRebuild = {
     lastError?: string;
     updatedAt: string;
 };
-export type EmbeddingLock = EmbeddingGeneration & {
-    version: 2;
-    generation: number;
+type EmbeddingServingRecord = {
+    version: 3;
     collection: string;
     createdAt: string;
-    /** Set when the lock was written for a collection that already existed without one — its model label is inferred. */
-    backfilledAt?: string;
     rebuild?: EmbeddingRebuild;
 };
+export type MetadataEmbeddingLock = EmbeddingServingRecord & {
+    mode: 'metadata';
+};
+export type DenseEmbeddingLock = EmbeddingServingRecord & EmbeddingGeneration & {
+    mode: 'dense';
+    generation: number;
+    /** A pre-existing collection's model label was inferred, not proved. */
+    backfilledAt?: string;
+};
+export type EmbeddingLock = MetadataEmbeddingLock | DenseEmbeddingLock;
 declare const LOCK_RELATIVE = "app/config/embedding-lock.json";
 /** The lock file exists but is not a lock — never overwritten, never read as "no lock". */
 export declare class EmbeddingLockInvalidError extends Error {
     readonly code: 'embedding_lock_invalid';
-    constructor(detail: string);
+    constructor(detail: string, remedy?: string);
 }
 export declare function readLock(appRoot: string): Promise<EmbeddingLock | null>;
 export declare function writeLock(appRoot: string, lock: EmbeddingLock): Promise<void>;
@@ -93,7 +102,9 @@ export declare function mutateLock(appRoot: string, fn: (lock: EmbeddingLock | n
 export declare function buildLockRecord(shape: EmbeddingGeneration, collection: string, opts?: {
     backfilled?: boolean;
     now?: string;
-}): EmbeddingLock;
+}): DenseEmbeddingLock;
+/** A serving collection with no invented model or dense schema. */
+export declare function buildMetadataLockRecord(collection: string, now?: string): MetadataEmbeddingLock;
 /** The generation identity a lock records (without the rebuild state). */
 export declare function generationOf(lock: EmbeddingGeneration): EmbeddingGeneration;
 /** Do two generations write vectors into the same space? `apiModelId` is superseded in place, so it is not compared. */

package/dist/src/embeddings/lock.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lock.d.ts","sourceRoot":"","sources":["../../../src/embeddings/lock.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"lock.d.ts","sourceRoot":"","sources":["../../../src/embeddings/lock.ts"],"names":[],"mappings":"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"}

package/dist/src/embeddings/lock.js

@@ -14,8 +14,9 @@
  * the run (paused) with its shadow — a resume re-verifies from the start but
  * re-embeds only what the shadow does not already hold.
  *
- * Format: v2. A v1 lock (dimension-only, one collection) reads as generation 1
- * with the base recipe; a lock NEWER than this binary is a typed refusal
+ * Format: v3 metadata/dense serving records, the ONLY format this runtime reads.
+ * A v1/v2 lock is refused naming the offline upgrade (`pnpm neuralis:upgrade`,
+ * `scripts/embeddingLockV3.ts`); a lock NEWER than this binary is a typed refusal
  * (`RecordNewerError`) — never "no lock", which is what used to overwrite it.
  * Writes are durable (temp + fsync + rename, mode 0600) and serialized in this
  * process, so a batch cursor, a dirty-id flush and the swap never interleave.
@@ -23,7 +24,6 @@
 import { readFile, mkdir, unlink } from 'node:fs/promises';
 import { join, dirname } from 'node:path';
 import { assertRecordFormat, durableReplaceFile } from '@neuralis/package-system/data';
-import { EMBED_RECIPE_BASE } from './models.js';
 import { EMBEDDING_LOCK_FORMAT } from '../store/dataFormats.js';
 /** The data-format ledger kind of this record (declared in `store/dataFormats.ts`). */
 export const EMBEDDING_LOCK_KIND = EMBEDDING_LOCK_FORMAT.kind;
@@ -32,8 +32,8 @@ const LOCK_RELATIVE = 'app/config/embedding-lock.json';
 /** The lock file exists but is not a lock — never overwritten, never read as "no lock". */
 export class EmbeddingLockInvalidError extends Error {
     code = 'embedding_lock_invalid';
-    constructor(detail) {
-        super(`EMBEDDING_LOCK_INVALID: ${detail}. Fix or remove ${LOCK_RELATIVE} (a removal is a vector reset).`);
+    constructor(detail, remedy = `Fix or remove ${LOCK_RELATIVE} (a removal is a vector reset).`) {
+        super(`EMBEDDING_LOCK_INVALID: ${detail}. ${remedy}`);
         this.name = 'EmbeddingLockInvalidError';
     }
 }
@@ -48,33 +48,46 @@ function parseLock(raw) {
         throw new EmbeddingLockInvalidError('not a JSON object');
     const version = typeof raw.version === 'number' ? raw.version : undefined;
     assertRecordFormat(EMBEDDING_LOCK_KIND, version, EMBEDDING_LOCK_VERSION);
-    if (version !== 1 && version !== 2)
+    if (version === 1 || version === 2) {
+        throw new EmbeddingLockInvalidError(`format v${version} predates this build`, 'Stop the app and run `neuralis upgrade` (it converts the lock offline).');
+    }
+    if (version !== 3)
         throw new EmbeddingLockInvalidError(`unknown version ${String(raw.version)}`);
-    if (typeof raw.modelId !== 'string' || !raw.modelId)
-        throw new EmbeddingLockInvalidError('modelId missing');
-    if (typeof raw.dimension !== 'number' || !(raw.dimension > 0))
-        throw new EmbeddingLockInvalidError('dimension missing');
     if (typeof raw.collection !== 'string' || !raw.collection)
         throw new EmbeddingLockInvalidError('collection missing');
-    if (version === 1) {
-        // v1 → generation 1, the base recipe (every client's document request was
-        // the base one when v1 locks were written).
-        return {
-            version: 2,
-            generation: 1,
-            collection: raw.collection,
-            modelId: raw.modelId,
-            provider: raw.provider,
-            apiModelId: typeof raw.apiModelId === 'string' ? raw.apiModelId : '',
-            embedRecipe: EMBED_RECIPE_BASE,
-            dimension: raw.dimension,
-            createdAt: typeof raw.createdAt === 'string' ? raw.createdAt : '',
-        };
+    if (typeof raw.createdAt !== 'string')
+        throw new EmbeddingLockInvalidError('createdAt missing');
+    let rebuild;
+    if (raw.rebuild !== undefined) {
+        if (!isRecord(raw.rebuild))
+            throw new EmbeddingLockInvalidError('rebuild invalid');
+        const phase = raw.rebuild.phase;
+        if (phase !== 'prepared' && phase !== 'copying' && phase !== 'ready')
+            throw new EmbeddingLockInvalidError('rebuild phase invalid');
+        // Existing rebuild validation belongs to the job resolver; retain its durable state.
+        rebuild = raw.rebuild;
     }
-    if (typeof raw.generation !== 'number' || !(raw.generation >= 1)) {
-        throw new EmbeddingLockInvalidError('generation missing');
-    }
-    return raw;
+    const serving = { version: 3, collection: raw.collection, createdAt: raw.createdAt, ...(rebuild ? { rebuild } : {}) };
+    if (raw.mode === 'metadata')
+        return { ...serving, mode: 'metadata' };
+    if (raw.mode !== 'dense')
+        throw new EmbeddingLockInvalidError('mode invalid');
+    if (typeof raw.modelId !== 'string' || !raw.modelId)
+        throw new EmbeddingLockInvalidError('modelId missing');
+    if (typeof raw.dimension !== 'number' || !Number.isInteger(raw.dimension) || raw.dimension <= 0)
+        throw new EmbeddingLockInvalidError('dimension invalid');
+    if (typeof raw.generation !== 'number' || !Number.isInteger(raw.generation) || raw.generation < 1)
+        throw new EmbeddingLockInvalidError('generation invalid');
+    if (typeof raw.provider !== 'string' || typeof raw.apiModelId !== 'string')
+        throw new EmbeddingLockInvalidError('provider identity missing');
+    if (typeof raw.embedRecipe !== 'string' || !raw.embedRecipe)
+        throw new EmbeddingLockInvalidError('embedRecipe missing');
+    return {
+        ...serving, mode: 'dense', generation: raw.generation, modelId: raw.modelId,
+        provider: raw.provider, apiModelId: raw.apiModelId,
+        embedRecipe: raw.embedRecipe, dimension: raw.dimension,
+        ...(typeof raw.backfilledAt === 'string' ? { backfilledAt: raw.backfilledAt } : {}),
+    };
 }
 export async function readLock(appRoot) {
     let text;
@@ -160,7 +173,8 @@ export function mutateLock(appRoot, fn) {
 export function buildLockRecord(shape, collection, opts = {}) {
     const now = opts.now ?? new Date().toISOString();
     return {
-        version: 2,
+        version: 3,
+        mode: 'dense',
         generation: 1,
         collection,
         modelId: shape.modelId,
@@ -172,6 +186,10 @@ export function buildLockRecord(shape, collection, opts = {}) {
         ...(opts.backfilled ? { backfilledAt: now } : {}),
     };
 }
+/** A serving collection with no invented model or dense schema. */
+export function buildMetadataLockRecord(collection, now = new Date().toISOString()) {
+    return { version: 3, mode: 'metadata', collection, createdAt: now };
+}
 /** The generation identity a lock records (without the rebuild state). */
 export function generationOf(lock) {
     return {

package/dist/src/embeddings/lock.js.map

@@ -1 +1 @@
-{"version":3,"file":"lock.js","sourceRoot":"","sources":["../../../src/embeddings/lock.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"lock.js","sourceRoot":"","sources":["../../../src/embeddings/lock.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAEvF,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,uFAAuF;AACvF,MAAM,CAAC,MAAM,mBAAmB,GAAG,qBAAqB,CAAC,IAAI,CAAC;AAC9D,MAAM,CAAC,MAAM,sBAAsB,GAAG,qBAAqB,CAAC,OAAO,CAAC;AAsDpE,MAAM,aAAa,GAAG,gCAAgC,CAAC;AAEvD,2FAA2F;AAC3F,MAAM,OAAO,yBAA0B,SAAQ,KAAK;IACzC,IAAI,GAAG,wBAAiC,CAAC;IAClD,YAAY,MAAc,EAAE,MAAM,GAAG,iBAAiB,aAAa,iCAAiC;QAClG,KAAK,CAAC,2BAA2B,MAAM,KAAK,MAAM,EAAE,CAAC,CAAC;QACtD,IAAI,CAAC,IAAI,GAAG,2BAA2B,CAAC;IAC1C,CAAC;CACF;AAED,SAAS,WAAW,CAAC,OAAe;IAClC,OAAO,IAAI,CAAC,OAAO,EAAE,QAAQ,EAAE,qBAAqB,CAAC,CAAC;AACxD,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED,SAAS,SAAS,CAAC,GAAY;IAC7B,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,MAAM,IAAI,yBAAyB,CAAC,mBAAmB,CAAC,CAAC;IAC7E,MAAM,OAAO,GAAG,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;IAC1E,kBAAkB,CAAC,mBAAmB,EAAE,OAAO,EAAE,sBAAsB,CAAC,CAAC;IACzE,IAAI,OAAO,KAAK,CAAC,IAAI,OAAO,KAAK,CAAC,EAAE,CAAC;QACnC,MAAM,IAAI,yBAAyB,CAAC,WAAW,OAAO,sBAAsB,EAAE,yEAAyE,CAAC,CAAC;IAC3J,CAAC;IACD,IAAI,OAAO,KAAK,CAAC;QAAE,MAAM,IAAI,yBAAyB,CAAC,mBAAmB,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACjG,IAAI,OAAO,GAAG,CAAC,UAAU,KAAK,QAAQ,IAAI,CAAC,GAAG,CAAC,UAAU;QAAE,MAAM,IAAI,yBAAyB,CAAC,oBAAoB,CAAC,CAAC;IACrH,IAAI,OAAO,GAAG,CAAC,SAAS,KAAK,QAAQ;QAAE,MAAM,IAAI,yBAAyB,CAAC,mBAAmB,CAAC,CAAC;IAChG,IAAI,OAAqC,CAAC;IAC1C,IAAI,GAAG,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QAC9B,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC;YAAE,MAAM,IAAI,yBAAyB,CAAC,iBAAiB,CAAC,CAAC;QACnF,MAAM,KAAK,GAAG,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC;QAChC,IAAI,KAAK,KAAK,UAAU,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,OAAO;YAAE,MAAM,IAAI,yBAAyB,CAAC,uBAAuB,CAAC,CAAC;QACnI,qFAAqF;QACrF,OAAO,GAAG,GAAG,CAAC,OAA2B,CAAC;IAC5C,CAAC;IACD,MAAM,OAAO,GAAG,EAAE,OAAO,EAAE,CAAU,EAAE,UAAU,EAAE,GAAG,CAAC,UAAU,EAAE,SAAS,EAAE,GAAG,CAAC,SAAS,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;IAC/H,IAAI,GAAG,CAAC,IAAI,KAAK,UAAU;QAAE,OAAO,EAAE,GAAG,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;IACrE,IAAI,GAAG,CAAC,IAAI,KAAK,OAAO;QAAE,MAAM,IAAI,yBAAyB,CAAC,cAAc,CAAC,CAAC;IAC9E,IAAI,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ,IAAI,CAAC,GAAG,CAAC,OAAO;QAAE,MAAM,IAAI,yBAAyB,CAAC,iBAAiB,CAAC,CAAC;IAC5G,IAAI,OAAO,GAAG,CAAC,SAAS,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,GAAG,CAAC,SAAS,IAAI,CAAC;QAAE,MAAM,IAAI,yBAAyB,CAAC,mBAAmB,CAAC,CAAC;IAC1J,IAAI,OAAO,GAAG,CAAC,UAAU,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,GAAG,CAAC,UAAU,GAAG,CAAC;QAAE,MAAM,IAAI,yBAAyB,CAAC,oBAAoB,CAAC,CAAC;IAC7J,IAAI,OAAO,GAAG,CAAC,QAAQ,KAAK,QAAQ,IAAI,OAAO,GAAG,CAAC,UAAU,KAAK,QAAQ;QAAE,MAAM,IAAI,yBAAyB,CAAC,2BAA2B,CAAC,CAAC;IAC7I,IAAI,OAAO,GAAG,CAAC,WAAW,KAAK,QAAQ,IAAI,CAAC,GAAG,CAAC,WAAW;QAAE,MAAM,IAAI,yBAAyB,CAAC,qBAAqB,CAAC,CAAC;IACxH,OAAO;QACL,GAAG,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,CAAC,UAAU,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO;QAC3E,QAAQ,EAAE,GAAG,CAAC,QAA+B,EAAE,UAAU,EAAE,GAAG,CAAC,UAAU;QACzE,WAAW,EAAE,GAAG,CAAC,WAAW,EAAE,SAAS,EAAE,GAAG,CAAC,SAAS;QACtD,GAAG,CAAC,OAAO,GAAG,CAAC,YAAY,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,GAAG,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACpF,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,OAAe;IAC5C,IAAI,IAAY,CAAC;IACjB,IAAI,CAAC;QACH,IAAI,GAAG,MAAM,QAAQ,CAAC,WAAW,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,CAAC;IACtD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAK,GAA6B,EAAE,IAAI,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAC;QACnE,MAAM,GAAG,CAAC;IACZ,CAAC;IACD,IAAI,GAAY,CAAC;IACjB,IAAI,CAAC;QACH,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACzB,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,yBAAyB,CAAC,gBAAgB,CAAC,CAAC;IACxD,CAAC;IACD,OAAO,SAAS,CAAC,GAAG,CAAC,CAAC;AACxB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,OAAe,EAAE,IAAmB;IAClE,MAAM,IAAI,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;IAClC,MAAM,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAC7D,MAAM,kBAAkB,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAC/E,eAAe,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AACtC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,OAAe;IAC9C,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC;IACrC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAK,GAA6B,EAAE,IAAI,KAAK,QAAQ;YAAE,MAAM,GAAG,CAAC;IACnE,CAAC;IACD,IAAI,eAAe,EAAE,OAAO,KAAK,OAAO;QAAE,eAAe,GAAG,IAAI,CAAC;AACnE,CAAC;AAED,+EAA+E;AAC/E,EAAE;AACF,kEAAkE;AAClE,2EAA2E;AAC3E,+EAA+E;AAC/E,+EAA+E;AAC/E,iEAAiE;AAEjE,IAAI,eAAe,GAA2D,IAAI,CAAC;AACnF,IAAI,cAAc,GAAqB,OAAO,CAAC,OAAO,EAAE,CAAC;AAEzD,kEAAkE;AAClE,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,OAAe;IACjD,IAAI,eAAe,IAAI,eAAe,CAAC,OAAO,KAAK,OAAO;QAAE,OAAO,eAAe,CAAC,IAAI,CAAC;IACxF,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,CAAC;IACrC,eAAe,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IACpC,OAAO,IAAI,CAAC;AACd,CAAC;AAED,uFAAuF;AACvF,MAAM,UAAU,cAAc;IAC5B,OAAO,eAAe,CAAC,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;AAC5D,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,gBAAgB;IAC9B,eAAe,GAAG,IAAI,CAAC;AACzB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,UAAU,CACxB,OAAe,EACf,EAAwD;IAExD,MAAM,GAAG,GAAG,cAAc,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE;QACzC,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,CAAC;QACxC,MAAM,IAAI,GAAG,EAAE,CAAC,OAAO,CAAC,CAAC;QACzB,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;YAClB,eAAe,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;YAC7C,OAAO,OAAO,CAAC;QACjB,CAAC;QACD,MAAM,SAAS,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAC/B,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;IACH,cAAc,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IAC5C,OAAO,GAAG,CAAC;AACb,CAAC;AAED,8FAA8F;AAC9F,MAAM,UAAU,eAAe,CAC7B,KAA0B,EAC1B,UAAkB,EAClB,IAAI,GAA2C,EAAE;IAEjD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACjD,OAAO;QACL,OAAO,EAAE,CAAC;QACV,IAAI,EAAE,OAAO;QACb,UAAU,EAAE,CAAC;QACb,UAAU;QACV,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,SAAS,EAAE,GAAG;QACd,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAClD,CAAC;AACJ,CAAC;AAED,mEAAmE;AACnE,MAAM,UAAU,uBAAuB,CAAC,UAAkB,EAAE,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;IACxF,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC;AACtE,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,YAAY,CAAC,IAAyB;IACpD,OAAO;QACL,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,SAAS,EAAE,IAAI,CAAC,SAAS;KAC1B,CAAC;AACJ,CAAC;AAED,wHAAwH;AACxH,MAAM,UAAU,eAAe,CAAC,CAAsB,EAAE,CAAsB;IAC5E,OAAO,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,SAAS,KAAK,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,WAAW,KAAK,CAAC,CAAC,WAAW,CAAC;AACnG,CAAC;AAED,OAAO,EAAE,aAAa,EAAE,CAAC"}

package/dist/src/embeddings/retry.d.ts

@@ -1,3 +1,8 @@
+/** Bound transport and body consumption even when a provider ignores cancellation. */
+export declare function requestEmbeddingResponse(fetchImpl: typeof fetch, url: string, init: RequestInit, signal?: AbortSignal): Promise<{
+    response: Response;
+    raw: string;
+}>;
 /** Existing bounded backoff shared by embedding clients. */
 export declare function waitEmbedRetry(ms: number, signal?: AbortSignal, abortMessage?: string): Promise<void>;
 export declare function retryDelayMs(rawText: string, attempt: number, retryAfter?: string | null): number;

package/dist/src/embeddings/retry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../../src/embeddings/retry.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,EAAE,YAAY,SAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAO9G;AACD,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAajG"}
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../../src/embeddings/retry.ts"],"names":[],"mappings":"AAEA,sFAAsF;AACtF,wBAAsB,wBAAwB,CAC5C,SAAS,EAAE,OAAO,KAAK,EACvB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,WAAW,EACjB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC;IAAE,QAAQ,EAAE,QAAQ,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC,CA6B9C;AAED,4DAA4D;AAC5D,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,EAAE,YAAY,SAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAO9G;AACD,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAajG"}

package/dist/src/embeddings/retry.js

@@ -1,3 +1,38 @@
+import { EmbeddingUnavailableError, getBrainConfigNumber } from '../config/env.js';
+/** Bound transport and body consumption even when a provider ignores cancellation. */
+export async function requestEmbeddingResponse(fetchImpl, url, init, signal) {
+    signal?.throwIfAborted();
+    const timeoutMs = getBrainConfigNumber('embeddingRequestTimeoutMs', undefined, 30_000);
+    if (!Number.isFinite(timeoutMs) || timeoutMs <= 0)
+        throw new Error('INVALID_EMBEDDING_REQUEST_TIMEOUT');
+    const controller = new AbortController();
+    let timer;
+    let onAbort;
+    const cancellation = new Promise((_resolve, reject) => {
+        onAbort = () => { controller.abort(signal?.reason); reject(signal?.reason); };
+        signal?.addEventListener('abort', onAbort, { once: true });
+        timer = setTimeout(() => {
+            const error = new EmbeddingUnavailableError('timeout');
+            controller.abort(error);
+            reject(error);
+        }, timeoutMs);
+    });
+    try {
+        return await Promise.race([
+            (async () => {
+                const response = await fetchImpl(url, { ...init, signal: controller.signal });
+                const raw = await response.text();
+                return { response, raw };
+            })(),
+            cancellation,
+        ]);
+    }
+    finally {
+        clearTimeout(timer);
+        if (onAbort)
+            signal?.removeEventListener('abort', onAbort);
+    }
+}
 /** Existing bounded backoff shared by embedding clients. */
 export function waitEmbedRetry(ms, signal, abortMessage = 'EMBED_ABORTED') {
     return new Promise((resolve, reject) => {

package/dist/src/embeddings/retry.js.map

@@ -1 +1 @@
-{"version":3,"file":"retry.js","sourceRoot":"","sources":["../../../src/embeddings/retry.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,MAAM,UAAU,cAAc,CAAC,EAAU,EAAE,MAAoB,EAAE,YAAY,GAAG,eAAe;IAC7F,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,IAAI,MAAM,EAAE,OAAO,EAAE,CAAC;YAAC,MAAM,CAAC,IAAI,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC;YAAC,OAAO;QAAC,CAAC;QACjE,MAAM,OAAO,GAAG,GAAG,EAAE,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAChF,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,GAAG,MAAM,EAAE,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAClG,MAAM,EAAE,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7D,CAAC,CAAC,CAAC;AACL,CAAC;AACD,MAAM,UAAU,YAAY,CAAC,OAAe,EAAE,OAAe,EAAE,UAA0B;IACvF,IAAI,UAAU,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC;QACnC,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC9F,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC;YAAE,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,CAAC;IACtF,CAAC;IACD,MAAM,IAAI,GAAG,qCAAqC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACjE,IAAI,IAAI,EAAE,CAAC;QACT,MAAM,KAAK,GAAG,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QACzC,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC;QAChE,IAAI,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,CAAC;YAAE,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,GAAG,EAAE,MAAM,CAAC,CAAC;IAClF,CAAC;IACD,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,IAAI,OAAO,EAAE,MAAM,CAAC,CAAC;AAC9C,CAAC"}
+{"version":3,"file":"retry.js","sourceRoot":"","sources":["../../../src/embeddings/retry.ts"],"names":[],"mappings":"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"}

package/dist/src/events/pending.d.ts

@@ -0,0 +1,56 @@
+/**
+ * The `pending` event subject — ONE content-free summary per quiet window that
+ * a project has changes waiting for review (and, separately, that reviews were
+ * resolved). It never says which files, how many or whose: a reader opens the
+ * Changes view, whose per-record filtered list and count are the truth.
+ *
+ * PRODUCER: an OBSERVER on each project's own filesystem bus, attached when the
+ * project's infra entry is built (`CommunityInfraFactory`) — never through the
+ * factory's pinning `subscribe`, which would keep every project alive forever.
+ * Pending-relevant events (`isPendingRelevantEvent`) arrive PER FILE, so the
+ * observer coalesces: a 2 s quiet window (restarted by each event, capped at
+ * 10 s from the window's first event), one `unref()`'d timer per project with
+ * a window open, cleared when the entry is disposed. The summary is addressed
+ * to the bounded set of real actors seen in the window (followers come from
+ * the host). A burst notifies 2 s after it ends, at most 10 s after it began —
+ * stacked on, and independent of, the Files client's own 1 s / 5 s
+ * `pending:changed` re-count debounce.
+ *
+ * `visible`: a role-holding member of the event's project — the declaration's
+ * `requires.features` (`drive.read`, the pending route's feature) is checked by
+ * the host before this runs. Content-free, so nothing else is needed to judge
+ * it; the list behind the `nav` re-applies every per-record gate.
+ *
+ * RESOLUTION: the Inbox/popover marking a row read when it is shown or opened
+ * is the mechanism; a resolved review does NOT clear another reader's
+ * warning (`pending.review.resolved` declares no `clears`).
+ */
+import { type EventBridge, type EventVisibilityPredicate, type NeuralisEventInput } from '@neuralis/package-system/contracts';
+export declare const subject = "pending";
+/** The quiet window and its ceiling — code floors of a coalescer, not tunables of a product. */
+export declare const PENDING_SUMMARY_QUIET_MS = 2000;
+export declare const PENDING_SUMMARY_MAX_WAIT_MS = 10000;
+/** At most this many addressed actors per summary; followers are the host's. */
+export declare const PENDING_SUMMARY_MAX_ACTORS = 50;
+export type PendingSignalPublish = (input: Omit<NeuralisEventInput, 'projectId'> & {
+    projectId: string;
+}) => unknown;
+export type PendingObserver = {
+    /** Feed one bus event; anything not pending-relevant costs a string check. */
+    observe(event: Record<string, unknown>): void;
+    /** Drop the open window (its timer included) — the entry is gone. */
+    dispose(): void;
+};
+/**
+ * One project's coalescing observer. `publisher()` is read when a window
+ * CLOSES, so an observer born before the subject's bridge is wired simply stays
+ * silent until it is.
+ */
+export declare function createPendingObserver(projectId: string, publisher: () => PendingSignalPublish | undefined, timers?: {
+    set: (fn: () => void, ms: number) => ReturnType<typeof setTimeout>;
+    clear: (handle: ReturnType<typeof setTimeout>) => void;
+    now: () => number;
+}): PendingObserver;
+export declare const visible: EventVisibilityPredicate;
+export declare const bridge: EventBridge;
+//# sourceMappingURL=pending.d.ts.map

package/dist/src/events/pending.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pending.d.ts","sourceRoot":"","sources":["../../../src/events/pending.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,EAEL,KAAK,WAAW,EAChB,KAAK,wBAAwB,EAC7B,KAAK,kBAAkB,EACxB,MAAM,oCAAoC,CAAC;AAI5C,eAAO,MAAM,OAAO,YAAY,CAAC;AAEjC,gGAAgG;AAChG,eAAO,MAAM,wBAAwB,OAAQ,CAAC;AAC9C,eAAO,MAAM,2BAA2B,QAAS,CAAC;AAClD,gFAAgF;AAChF,eAAO,MAAM,0BAA0B,KAAK,CAAC;AAE7C,MAAM,MAAM,oBAAoB,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,kBAAkB,EAAE,WAAW,CAAC,GAAG;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,KAAK,OAAO,CAAC;AAErH,MAAM,MAAM,eAAe,GAAG;IAC5B,8EAA8E;IAC9E,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC9C,qEAAqE;IACrE,OAAO,IAAI,IAAI,CAAC;CACjB,CAAC;AAIF;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,oBAAoB,GAAG,SAAS,EACjD,MAAM,GAAE;IAAE,GAAG,EAAE,CAAC,EAAE,EAAE,MAAM,IAAI,EAAE,EAAE,EAAE,MAAM,KAAK,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC;IAAC,KAAK,EAAE,CAAC,MAAM,EAAE,UAAU,CAAC,OAAO,UAAU,CAAC,KAAK,IAAI,CAAC;IAAC,GAAG,EAAE,MAAM,MAAM,CAAA;CAEtJ,GACA,eAAe,CAkDjB;AAED,eAAO,MAAM,OAAO,EAAE,wBACwE,CAAC;AAE/F,eAAO,MAAM,MAAM,EAAE,WAIpB,CAAC"}

package/dist/src/events/pending.js

@@ -0,0 +1,108 @@
+/**
+ * The `pending` event subject — ONE content-free summary per quiet window that
+ * a project has changes waiting for review (and, separately, that reviews were
+ * resolved). It never says which files, how many or whose: a reader opens the
+ * Changes view, whose per-record filtered list and count are the truth.
+ *
+ * PRODUCER: an OBSERVER on each project's own filesystem bus, attached when the
+ * project's infra entry is built (`CommunityInfraFactory`) — never through the
+ * factory's pinning `subscribe`, which would keep every project alive forever.
+ * Pending-relevant events (`isPendingRelevantEvent`) arrive PER FILE, so the
+ * observer coalesces: a 2 s quiet window (restarted by each event, capped at
+ * 10 s from the window's first event), one `unref()`'d timer per project with
+ * a window open, cleared when the entry is disposed. The summary is addressed
+ * to the bounded set of real actors seen in the window (followers come from
+ * the host). A burst notifies 2 s after it ends, at most 10 s after it began —
+ * stacked on, and independent of, the Files client's own 1 s / 5 s
+ * `pending:changed` re-count debounce.
+ *
+ * `visible`: a role-holding member of the event's project — the declaration's
+ * `requires.features` (`drive.read`, the pending route's feature) is checked by
+ * the host before this runs. Content-free, so nothing else is needed to judge
+ * it; the list behind the `nav` re-applies every per-record gate.
+ *
+ * RESOLUTION: the Inbox/popover marking a row read when it is shown or opened
+ * is the mechanism; a resolved review does NOT clear another reader's
+ * warning (`pending.review.resolved` declares no `clears`).
+ */
+import { isSentinelId, } from '@neuralis/package-system/contracts';
+import { isPendingRelevantEvent } from '../domain/events.js';
+export const subject = 'pending';
+/** The quiet window and its ceiling — code floors of a coalescer, not tunables of a product. */
+export const PENDING_SUMMARY_QUIET_MS = 2_000;
+export const PENDING_SUMMARY_MAX_WAIT_MS = 10_000;
+/** At most this many addressed actors per summary; followers are the host's. */
+export const PENDING_SUMMARY_MAX_ACTORS = 50;
+const FILES_NAV = { widgetType: 'filesystem', initialState: { nav: { kind: 'filesystem', action: 'open-pending' } } };
+/**
+ * One project's coalescing observer. `publisher()` is read when a window
+ * CLOSES, so an observer born before the subject's bridge is wired simply stays
+ * silent until it is.
+ */
+export function createPendingObserver(projectId, publisher, timers = {
+    set: (fn, ms) => setTimeout(fn, ms), clear: (handle) => clearTimeout(handle), now: () => Date.now(),
+}) {
+    let timer;
+    let openedAt = 0;
+    let required = false;
+    let resolved = false;
+    const actors = new Set();
+    const flush = () => {
+        timer = undefined;
+        const publish = publisher();
+        const audience = [...actors];
+        const kinds = [required ? 'pending.review.required' : null, resolved ? 'pending.review.resolved' : null]
+            .filter((kind) => kind !== null);
+        required = false;
+        resolved = false;
+        actors.clear();
+        if (!publish)
+            return;
+        for (const event of kinds) {
+            try {
+                publish({ event, subjectId: 'pending', projectId, data: { nav: FILES_NAV },
+                    ...(audience.length ? { audience: { userIds: audience } } : {}) });
+            }
+            catch {
+                // A refused publish is the producer's bug and is loud in the hub's own log; the bus goes on.
+            }
+        }
+    };
+    return {
+        observe(event) {
+            if (event.projectId !== projectId || !isPendingRelevantEvent(event))
+                return;
+            const payload = (event.payload ?? {});
+            if (payload.status === 'pending_review')
+                required = true;
+            else
+                resolved = true;
+            const actor = event.userId;
+            if (typeof actor === 'string' && actor && !isSentinelId(actor) && actors.size < PENDING_SUMMARY_MAX_ACTORS)
+                actors.add(actor);
+            const now = timers.now();
+            if (timer === undefined)
+                openedAt = now;
+            else
+                timers.clear(timer);
+            const wait = Math.max(0, Math.min(PENDING_SUMMARY_QUIET_MS, openedAt + PENDING_SUMMARY_MAX_WAIT_MS - now));
+            timer = timers.set(flush, wait);
+            timer.unref?.();
+        },
+        dispose() {
+            if (timer !== undefined)
+                timers.clear(timer);
+            timer = undefined;
+            actors.clear();
+            required = false;
+            resolved = false;
+        },
+    };
+}
+export const visible = (event, session) => Boolean(session.role) && Boolean(session.projectId) && event.projectId === session.projectId;
+export const bridge = (publish, state) => {
+    const factory = state.infraFactory;
+    factory.setPendingPublisher((input) => publish(input));
+    return () => factory.setPendingPublisher(undefined);
+};
+//# sourceMappingURL=pending.js.map

package/dist/src/events/pending.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pending.js","sourceRoot":"","sources":["../../../src/events/pending.ts"],"names":[],"mappings":"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"}