@snoai/memory 1.5.0 → 1.6.0

package/dist/{retriever-hTIkt3CJ.d.ts → retriever-2RJYAvlD.d.ts}

@@ -1,13 +1,13 @@
-import { h as MemoryCategory, l as DecayScore, r as AggregationQuery, u as DecayableMemory, x as RetrievalResult, y as MemorySearchResult } from "./types-DBEwNYdR.js";
-import { sn as RecallLifecycleConfig } from "./index-BGu91bjB.js";
+import { h as MemoryCategory, l as DecayScore, r as AggregationQuery, u as DecayableMemory, x as RetrievalResult, y as MemorySearchResult } from "./types-El7jViCz.js";
+import { tn as RecallLifecycleConfig } from "./index-CJrMFlAU.js";
 import { t as Embedder } from "./embedding-provider-client-CELWtPgt.js";
 import "./trace-C1JxMfs-.js";
-import "./memory-metadata-codec-CfP9JLVO.js";
+import "./memory-metadata-codec-H8BniJM3.js";
 import { K as RemFacetPolicy } from "./index-DPfJrOFD.js";
-import { C as MemoryStore } from "./memory-store-base-upd9MuG6.js";
-import "./store-DEG06TLb.js";
-import { n as AccessTracker } from "./access-tracker-B1H2AJlH.js";
-import { r as TierPromoter } from "./memory-tier-promoter-Cq23yveQ.js";
+import { C as MemoryStore } from "./memory-store-base-BHYXgsCq.js";
+import "./store-Bz0y76cJ.js";
+import { n as AccessTracker } from "./access-tracker-CFxRg7Bt.js";
+import { r as TierPromoter } from "./memory-tier-promoter-m60-RlAj.js";
 import "@snoai/utils/logger";
 //#region src/engine/retrieval/retrieval-trace.d.ts
 /** @file retrieval-trace.ts
@@ -218,7 +218,7 @@ interface RetrievalConfig {
   vectorWeight: number;
   bm25Weight: number;
   minScore: number;
-  rerank: "cross-encoder" | "lightweight" | "none";
+  rerank: "lightweight" | "none";
   candidatePoolSize: number;
   recencyHalfLifeDays: number;
   recencyWeight: number;
@@ -226,15 +226,10 @@ interface RetrievalConfig {
   temporalExpiry: boolean;
   /** Dynamic memories decay 3× faster in time-decay scoring (default ON) */
   temporalDecay: boolean;
-  rerankApiKey?: string;
   rerankTimeoutMs?: number;
   lengthNormAnchor: number;
   hardMinScore: number;
   timeDecayHalfLifeDays: number;
-  /** Weight for fusion score in rerank blend */
-  rerankBlendVector?: number;
-  /** Weight for cross-encoder score in rerank blend */
-  rerankBlendCross?: number;
   /** Fusion-score weight when rerank="lightweight" (local cosine blend) */
   lightweightFusionWeight?: number;
   /** Cosine-score weight when rerank="lightweight" (local cosine blend) */
@@ -245,15 +240,6 @@ interface RetrievalConfig {
   timeDecayFloor?: number;
   /** Relevance vs diversity tradeoff (default: 0.7) */
   mmrLambda?: number;
-  /** Address of Sno's reranker (the Sno GPU address plus `/rerank`) */
-  rerankEndpoint?: string;
-  /**
-   * Cap on how many candidates are sent to Sno's reranker in total. Candidates
-   * beyond the cap are NOT dropped — they still flow through the standard
-   * `unreturned` preservation-floor path, same as a real reranker choosing
-   * not to return them.
-   */
-  rerankMaxCandidates?: number;
   /** Scaling factor for access-based reinforcement (0 = disabled, default: 0.5) */
   reinforcementFactor?: number;
   /** Hard cap: effective half-life <= baseHalfLife * maxHalfLifeMultiplier (default: 3) */
@@ -281,7 +267,7 @@ interface RetrievalContext {
    */
   includeRefused?: boolean;
   signal?: AbortSignal;
-  /** The time (ms since the epoch) by which a Sno reranker must have finished, retries included, before recall falls back to local ranking; set by callers that have a deadline. */
+  /** The time (ms since the epoch) by which the local model must finish before recall keeps its initial ranking. */
   rerankDeadlineAt?: number;
   sessionId?: string;
   explicitLocale?: string;
@@ -346,37 +332,10 @@ interface RetentionScorer {
 }
 //#endregion
 //#region src/engine/retrieval/retriever-core.d.ts
-/**
- * Enumerates every branch in `rerank()` that fell back to the pre-rerank
- * candidate ordering instead of applying the cross-encoder score. Aggregated
- * via {@link RetrievalStatsCollector} and surfaced as trace stage metadata
- * so callers can attribute degraded ranking without parsing log lines.
- *
- * - `missing_api_key`: cross-encoder configured but no rerankApiKey set;
- *   call routes through the lightweight cosine path instead.
- * - `no_endpoint`: no reranker address (`rerankEndpoint`) was set; rerank was skipped.
- * - `http_error`: the reranker responded with a non-OK status.
- * - `invalid_response`: the reranker answered HTTP 2xx but the response shape did not parse.
- * - `timeout`: the per-call AbortSignal fired before the reranker responded.
- * - `request_error`: any other thrown error inside the fetch path.
- * - `query_over_window`: the query alone fills the reranker's per-pair token window, so no
- *   document could be sent with it. Nothing was requested.
- */
-declare const RERANK_FALLBACK_REASONS: readonly ["missing_api_key", "no_endpoint", "http_error", "invalid_response", "timeout", "request_error", "query_over_window"];
-type RerankFallbackReason = (typeof RERANK_FALLBACK_REASONS)[number];
-interface RerankFallbackSignal {
-  reason: RerankFallbackReason;
-}
 interface RerankOutcome {
   candidates: RetrievalResult[];
   /** Ids of the candidates the local reranker model scored, in its order; the scoring pipeline restores it last. */
   modelOrder?: string[];
-  fallback?: RerankFallbackSignal;
-  stats?: {
-    rerankSentCount: number;
-    rerankReturnedCount: number;
-    rerankBeyondCapCount: number;
-  };
 }
 declare class MemoryRetriever {
   readonly store: MemoryStore;
@@ -452,7 +411,6 @@ interface MemoryRetrieverInternals {
   }): Promise<RerankOutcome>;
   rerankLightweight(candidates: RetrievalResult[], queryVector: Float32Array): RetrievalResult[];
   rerankLocalModel(query: string, ordered: RetrievalResult[], deadlineAt?: number, signal?: AbortSignal): Promise<RerankOutcome>;
-  getRerankSourceScore(result: RetrievalResult): number;
   applyScoringPipeline(results: RetrievalResult[], trace?: TraceCollector, limit?: number, modelOrder?: readonly string[]): RetrievalResult[];
   applyRecencyBoost(results: RetrievalResult[]): RetrievalResult[];
   applyImportanceWeight(results: RetrievalResult[]): RetrievalResult[];
@@ -466,4 +424,4 @@ declare function createRetriever(store: MemoryStore, embedder: Embedder, logger?
   warn: (message: string, fields?: Record<string, unknown>) => void;
 }, config?: RetrievalConfig): MemoryRetriever;
 //#endregion
-export { RerankFallbackSignal as a, collectParallelStage as c, RetrievalContext as d, withServingValidityDefault as f, RerankFallbackReason as i, DEFAULT_RETRIEVAL_CONFIG as l, MemoryRetrieverInternals as n, RerankOutcome as o, RERANK_FALLBACK_REASONS as r, createRetriever as s, MemoryRetriever as t, RetrievalConfig as u };
+export { collectParallelStage as a, RetrievalContext as c, createRetriever as i, withServingValidityDefault as l, MemoryRetrieverInternals as n, DEFAULT_RETRIEVAL_CONFIG as o, RerankOutcome as r, RetrievalConfig as s, MemoryRetriever as t };