@steno-ai/engine 0.1.0

package/dist/retrieval/search.js

@@ -0,0 +1,228 @@
+import { DEFAULT_FUSION_WEIGHTS } from './types.js';
+import { compoundSearchSignal } from './compound-search.js';
+import { graphSearch } from './graph-traversal.js';
+import { matchTriggers } from './trigger-matcher.js';
+import { scoreSalience } from './salience-scorer.js';
+import { fuseAndRank } from './fusion.js';
+import { surfaceContradictions } from './contradiction-surfacer.js';
+import { recordAccesses } from '../feedback/tracker.js';
+import { CachedEmbeddingAdapter } from './embedding-cache.js';
+import { extractTimeReference, scoreTemporalRelevance } from './temporal-scorer.js';
+export async function search(config, options) {
+    const startTime = Date.now();
+    const limit = Math.min(options.limit ?? 10, 100);
+    const weights = options.weights ?? config.defaultWeights ?? DEFAULT_FUSION_WEIGHTS;
+    const fetchMultiplier = 3; // fetch 3x limit from each signal for better fusion
+    // Wrap embedding with cache if available
+    const effectiveEmbedding = config.cache
+        ? new CachedEmbeddingAdapter(config.embedding, config.cache)
+        : config.embedding;
+    // 1. Run all signals in PARALLEL — ONE compound search (not multiple)
+    //    Multi-query expansion adds latency (3× embedding calls). Instead:
+    //    - Single compound search with original query (vector + keyword in 1 DB call)
+    //    - Graph search with original query
+    //    - Trigger matching
+    //    All parallel = single round trip time.
+    const t0 = Date.now();
+    const tCompound = Date.now();
+    const compoundPromise = compoundSearchSignal(config.storage, effectiveEmbedding, options.query, options.tenantId, options.scope, options.scopeId, limit * fetchMultiplier).catch(() => ({ vectorCandidates: [], keywordCandidates: [] }));
+    const tGraph = Date.now();
+    const graphPromise = graphSearch(config.storage, effectiveEmbedding, options.query, options.tenantId, options.scope, options.scopeId, limit * fetchMultiplier, { maxDepth: config.graphMaxDepth, maxEntities: config.graphMaxEntities, asOf: options.temporalFilter?.asOf }).catch(() => []);
+    const tTrigger = Date.now();
+    const triggerPromise = matchTriggers(config.storage, effectiveEmbedding, options.query, options.tenantId, options.scope, options.scopeId).catch(() => ({ candidates: [], triggersMatched: [] }));
+    const [compoundResult, graphSettled, triggerSettled] = await Promise.all([
+        compoundPromise.then(r => { console.error(`[steno-search] compound: ${Date.now() - tCompound}ms (vec=${r.vectorCandidates.length}, kw=${r.keywordCandidates.length})`); return r; }),
+        graphPromise.then(r => { console.error(`[steno-search] graph: ${Date.now() - tGraph}ms (${Array.isArray(r) ? r.length : 0} candidates)`); return r; }),
+        triggerPromise.then(r => { console.error(`[steno-search] trigger: ${Date.now() - tTrigger}ms`); return r; }),
+    ]);
+    console.error(`[steno-search] Signals total: ${Date.now() - t0}ms`);
+    const vectorCandidates = compoundResult.vectorCandidates;
+    const keywordCandidates = compoundResult.keywordCandidates;
+    const graphCandidates = Array.isArray(graphSettled) ? graphSettled : [];
+    const triggerResult = triggerSettled;
+    const triggersMatched = triggerResult.triggersMatched;
+    // 2. Triple-tier pre-fusion reranking — rerank each stream INDEPENDENTLY
+    //    Only rerank when there are enough candidates to justify the embedding cost
+    //    before fusion, like Hydra DB's triple-tier architecture.
+    const t1 = Date.now();
+    // Batch-embed query + all unique candidate contents in ONE call
+    const allPreRerankCandidates = [...vectorCandidates, ...graphCandidates];
+    let queryEmbedding = null;
+    const candidateEmbeddings = new Map();
+    // Only rerank if we have >10 candidates — for small sets the original order is fine
+    if (allPreRerankCandidates.length > 10) {
+        try {
+            const uniqueTexts = new Map();
+            for (const c of allPreRerankCandidates) {
+                if (!uniqueTexts.has(c.fact.id))
+                    uniqueTexts.set(c.fact.id, c.fact.content);
+            }
+            const textsToEmbed = [options.query, ...uniqueTexts.values()];
+            const embeddings = await effectiveEmbedding.embedBatch(textsToEmbed);
+            queryEmbedding = embeddings[0];
+            let idx = 1;
+            for (const [factId] of uniqueTexts) {
+                candidateEmbeddings.set(factId, embeddings[idx++]);
+            }
+        }
+        catch {
+            // Reranking fails silently — proceed without it
+        }
+    }
+    // Rerank vector candidates
+    if (queryEmbedding && vectorCandidates.length > 1) {
+        const RERANK_W = 0.4;
+        for (const c of vectorCandidates) {
+            const factEmb = candidateEmbeddings.get(c.fact.id);
+            if (factEmb) {
+                const sim = cosineSim(queryEmbedding, factEmb);
+                c.vectorScore = c.vectorScore * (1 - RERANK_W) + sim * RERANK_W;
+            }
+        }
+        vectorCandidates.sort((a, b) => b.vectorScore - a.vectorScore);
+    }
+    // Rerank graph candidates
+    if (queryEmbedding && graphCandidates.length > 1) {
+        const RERANK_W = 0.4;
+        for (const c of graphCandidates) {
+            const factEmb = candidateEmbeddings.get(c.fact.id);
+            if (factEmb) {
+                const sim = cosineSim(queryEmbedding, factEmb);
+                c.graphScore = c.graphScore * (1 - RERANK_W) + sim * RERANK_W;
+            }
+        }
+        graphCandidates.sort((a, b) => b.graphScore - a.graphScore);
+    }
+    // Keyword candidates skip reranking — FTS scores shouldn't be overridden by embeddings
+    console.error(`[steno-search] Pre-fusion rerank: ${Date.now() - t1}ms`);
+    // 3. Merge all pre-reranked streams
+    const allCandidates = [
+        ...vectorCandidates,
+        ...keywordCandidates,
+        ...graphCandidates,
+        ...triggerResult.candidates,
+    ];
+    if (allCandidates.length === 0) {
+        return {
+            results: [],
+            triggersMatched,
+            totalCandidates: 0,
+            durationMs: Date.now() - startTime,
+        };
+    }
+    // 4. Score salience + recency on all candidates
+    const scoredCandidates = scoreSalience(allCandidates, {
+        halfLifeDays: config.salienceHalfLifeDays,
+        normalizationK: config.salienceNormalizationK,
+    });
+    // 4b. Score temporal relevance if query has time reference
+    const timeRef = extractTimeReference(options.query);
+    if (timeRef) {
+        scoreTemporalRelevance(scoredCandidates, timeRef);
+    }
+    // 5. Fuse and rank
+    const fusionResults = fuseAndRank(scoredCandidates, weights, limit);
+    // 5b. Lineage dedup — keep only the NEWEST version per lineage
+    //     Git-style append-only means multiple versions coexist. For normal queries,
+    //     show only the latest version (by createdAt). For "includeHistory", show all.
+    let dedupedResults = fusionResults;
+    if (!options.includeHistory) {
+        const lineageBest = new Map();
+        for (let i = 0; i < fusionResults.length; i++) {
+            const r = fusionResults[i];
+            const lid = r.fact.lineageId;
+            if (!lid)
+                continue;
+            const existing = lineageBest.get(lid);
+            const createdAt = new Date(r.fact.createdAt);
+            if (!existing || createdAt > existing.createdAt) {
+                lineageBest.set(lid, { idx: i, createdAt, score: r.score });
+            }
+        }
+        const keepIndices = new Set(Array.from(lineageBest.values()).map(v => v.idx));
+        // Also keep facts with no lineage match (unique facts)
+        dedupedResults = fusionResults.filter((r, idx) => {
+            const lid = r.fact.lineageId;
+            if (!lid)
+                return true;
+            return keepIndices.has(idx);
+        });
+    }
+    // 5c. Knowledge chain resolution — if a result has metadata.relationType === 'updates',
+    // check if the fact it updates is ALSO in results. If so, suppress the older one.
+    const updatedFactIds = new Set();
+    for (const r of dedupedResults) {
+        const meta = r.fact.metadata;
+        if (meta?.relationType === 'updates' && meta?.relatedFactId) {
+            updatedFactIds.add(meta.relatedFactId);
+        }
+    }
+    if (updatedFactIds.size > 0) {
+        dedupedResults = dedupedResults.filter(r => !updatedFactIds.has(r.fact.id));
+    }
+    // 5d. Token budget trimming — keep highest-scored results that fit within budget
+    if (options.tokenBudget && options.tokenBudget > 0) {
+        let tokenCount = 0;
+        const budgetResults = [];
+        for (const r of dedupedResults) {
+            // Rough token estimate: content chars / 4, plus sourceChunk if present
+            const factTokens = Math.ceil(r.fact.content.length / 4) +
+                (r.fact.sourceChunk ? Math.ceil(r.fact.sourceChunk.length / 4) : 0);
+            if (tokenCount + factTokens > options.tokenBudget)
+                break;
+            tokenCount += factTokens;
+            budgetResults.push(r);
+        }
+        dedupedResults = budgetResults;
+    }
+    // 6. Enrich with contradiction context
+    let results = await surfaceContradictions(config.storage, options.tenantId, dedupedResults);
+    console.error(`[steno-search] Fusion + dedup: ${Date.now() - t1}ms, Total: ${Date.now() - startTime}ms`);
+    // 6. Optionally enrich with graph context
+    if (options.includeGraph) {
+        for (const result of results) {
+            const entities = await config.storage.getEntitiesForFact(result.fact.id);
+            const edges = [];
+            for (const entity of entities) {
+                const entityEdges = await config.storage.getEdgesForEntity(options.tenantId, entity.id);
+                edges.push(...entityEdges);
+            }
+            result.graph = { entities, edges };
+        }
+    }
+    // 7. Optionally enrich with fact history (previous versions)
+    if (options.includeHistory) {
+        for (const result of results) {
+            const history = await config.storage.getFactsByLineage(options.tenantId, result.fact.lineageId);
+            // Filter out the current fact, sort by version ascending
+            result.history = history
+                .filter(f => f.id !== result.fact.id)
+                .sort((a, b) => a.version - b.version);
+        }
+    }
+    // 8. Record memory accesses for metamemory + update decay scores (fire-and-forget)
+    void recordAccesses(config.storage, options.tenantId, options.query, results, {
+        halfLifeDays: config.salienceHalfLifeDays,
+        normalizationK: config.salienceNormalizationK,
+    }).catch(err => console.error('[steno] Failed to record memory accesses:', err));
+    return {
+        results,
+        triggersMatched,
+        totalCandidates: allCandidates.length,
+        durationMs: Date.now() - startTime,
+    };
+}
+/** Fast cosine similarity for pre-fusion reranking */
+function cosineSim(a, b) {
+    if (a.length !== b.length || a.length === 0)
+        return 0;
+    let dot = 0, normA = 0, normB = 0;
+    for (let i = 0; i < a.length; i++) {
+        dot += a[i] * b[i];
+        normA += a[i] * a[i];
+        normB += b[i] * b[i];
+    }
+    const denom = Math.sqrt(normA) * Math.sqrt(normB);
+    return denom === 0 ? 0 : dot / denom;
+}
+//# sourceMappingURL=search.js.map

package/dist/retrieval/search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../../src/retrieval/search.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAG9D,OAAO,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAiBpF,MAAM,CAAC,KAAK,UAAU,MAAM,CAC1B,MAAoB,EACpB,OAAsB;IAEtB,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC7B,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,EAAE,GAAG,CAAC,CAAC;IACjD,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,MAAM,CAAC,cAAc,IAAI,sBAAsB,CAAC;IACnF,MAAM,eAAe,GAAG,CAAC,CAAC,CAAC,oDAAoD;IAE/E,yCAAyC;IACzC,MAAM,kBAAkB,GAAG,MAAM,CAAC,KAAK;QACrC,CAAC,CAAC,IAAI,sBAAsB,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC;QAC5D,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC;IAErB,sEAAsE;IACtE,uEAAuE;IACvE,kFAAkF;IAClF,wCAAwC;IACxC,wBAAwB;IACxB,4CAA4C;IAC5C,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAEtB,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC7B,MAAM,eAAe,GAAG,oBAAoB,CAAC,MAAM,CAAC,OAAO,EAAE,kBAAkB,EAAE,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,OAAO,EAAE,KAAK,GAAG,eAAe,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,gBAAgB,EAAE,EAAiB,EAAE,iBAAiB,EAAE,EAAiB,EAAE,CAAC,CAAC,CAAC;IACxQ,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC1B,MAAM,YAAY,GAAG,WAAW,CAAC,MAAM,CAAC,OAAO,EAAE,kBAAkB,EAAE,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,OAAO,EAAE,KAAK,GAAG,eAAe,EAAE,EAAE,QAAQ,EAAE,MAAM,CAAC,aAAa,EAAE,WAAW,EAAE,MAAM,CAAC,gBAAgB,EAAE,IAAI,EAAE,OAAO,CAAC,cAAc,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAiB,CAAC,CAAC;IAC5S,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC5B,MAAM,cAAc,GAAG,aAAa,CAAC,MAAM,CAAC,OAAO,EAAE,kBAAkB,EAAE,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,UAAU,EAAE,EAAiB,EAAE,eAAe,EAAE,EAAc,EAAE,CAAC,CAAC,CAAC;IAE5N,MAAM,CAAC,cAAc,EAAE,YAAY,EAAE,cAAc,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QACvE,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC,4BAA4B,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,WAAW,CAAC,CAAC,gBAAgB,CAAC,MAAM,QAAQ,CAAC,CAAC,iBAAiB,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;QACpL,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC,yBAAyB,IAAI,CAAC,GAAG,EAAE,GAAG,MAAM,OAAO,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;QACtJ,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC,2BAA2B,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;KAC7G,CAAC,CAAC;IACH,OAAO,CAAC,KAAK,CAAC,iCAAiC,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;IAEpE,MAAM,gBAAgB,GAAG,cAAc,CAAC,gBAAgB,CAAC;IACzD,MAAM,iBAAiB,GAAG,cAAc,CAAC,iBAAiB,CAAC;IAC3D,MAAM,eAAe,GAAG,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC;IACxE,MAAM,aAAa,GAAG,cAAc,CAAC;IACrC,MAAM,eAAe,GAAG,aAAa,CAAC,eAAe,CAAC;IAEtD,yEAAyE;IACzE,gFAAgF;IAChF,8DAA8D;IAC9D,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAEtB,gEAAgE;IAChE,MAAM,sBAAsB,GAAG,CAAC,GAAG,gBAAgB,EAAE,GAAG,eAAe,CAAC,CAAC;IACzE,IAAI,cAAc,GAAoB,IAAI,CAAC;IAC3C,MAAM,mBAAmB,GAAG,IAAI,GAAG,EAAoB,CAAC;IAExD,oFAAoF;IACpF,IAAI,sBAAsB,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC;QACvC,IAAI,CAAC;YACH,MAAM,WAAW,GAAG,IAAI,GAAG,EAAkB,CAAC;YAC9C,KAAK,MAAM,CAAC,IAAI,sBAAsB,EAAE,CAAC;gBACvC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;oBAAE,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAC9E,CAAC;YACD,MAAM,YAAY,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC;YAC9D,MAAM,UAAU,GAAG,MAAM,kBAAkB,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;YACrE,cAAc,GAAG,UAAU,CAAC,CAAC,CAAE,CAAC;YAChC,IAAI,GAAG,GAAG,CAAC,CAAC;YACZ,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,WAAW,EAAE,CAAC;gBACnC,mBAAmB,CAAC,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,GAAG,EAAE,CAAE,CAAC,CAAC;YACtD,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,gDAAgD;QAClD,CAAC;IACH,CAAC;IAED,2BAA2B;IAC3B,IAAI,cAAc,IAAI,gBAAgB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAClD,MAAM,QAAQ,GAAG,GAAG,CAAC;QACrB,KAAK,MAAM,CAAC,IAAI,gBAAgB,EAAE,CAAC;YACjC,MAAM,OAAO,GAAG,mBAAmB,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACnD,IAAI,OAAO,EAAE,CAAC;gBACZ,MAAM,GAAG,GAAG,SAAS,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC;gBAC/C,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC,GAAG,QAAQ,CAAC,GAAG,GAAG,GAAG,QAAQ,CAAC;YAClE,CAAC;QACH,CAAC;QACD,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC,WAAW,CAAC,CAAC;IACjE,CAAC;IAED,0BAA0B;IAC1B,IAAI,cAAc,IAAI,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACjD,MAAM,QAAQ,GAAG,GAAG,CAAC;QACrB,KAAK,MAAM,CAAC,IAAI,eAAe,EAAE,CAAC;YAChC,MAAM,OAAO,GAAG,mBAAmB,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACnD,IAAI,OAAO,EAAE,CAAC;gBACZ,MAAM,GAAG,GAAG,SAAS,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC;gBAC/C,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,GAAG,QAAQ,CAAC,GAAG,GAAG,GAAG,QAAQ,CAAC;YAChE,CAAC;QACH,CAAC;QACD,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC;IAC9D,CAAC;IACD,uFAAuF;IACvF,OAAO,CAAC,KAAK,CAAC,qCAAqC,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;IAExE,oCAAoC;IACpC,MAAM,aAAa,GAAgB;QACjC,GAAG,gBAAgB;QACnB,GAAG,iBAAiB;QACpB,GAAG,eAAe;QAClB,GAAG,aAAa,CAAC,UAAU;KAC5B,CAAC;IAEF,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/B,OAAO;YACL,OAAO,EAAE,EAAE;YACX,eAAe;YACf,eAAe,EAAE,CAAC;YAClB,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;SACnC,CAAC;IACJ,CAAC;IAED,gDAAgD;IAChD,MAAM,gBAAgB,GAAG,aAAa,CAAC,aAAa,EAAE;QACpD,YAAY,EAAE,MAAM,CAAC,oBAAoB;QACzC,cAAc,EAAE,MAAM,CAAC,sBAAsB;KAC9C,CAAC,CAAC;IAEH,2DAA2D;IAC3D,MAAM,OAAO,GAAG,oBAAoB,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACpD,IAAI,OAAO,EAAE,CAAC;QACZ,sBAAsB,CAAC,gBAAgB,EAAE,OAAO,CAAC,CAAC;IACpD,CAAC;IAED,mBAAmB;IACnB,MAAM,aAAa,GAAG,WAAW,CAAC,gBAAgB,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;IAEpE,+DAA+D;IAC/D,iFAAiF;IACjF,mFAAmF;IACnF,IAAI,cAAc,GAAG,aAAa,CAAC;IACnC,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE,CAAC;QAC5B,MAAM,WAAW,GAAG,IAAI,GAAG,EAA2D,CAAC;QACvF,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,aAAa,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAC9C,MAAM,CAAC,GAAG,aAAa,CAAC,CAAC,CAAE,CAAC;YAC5B,MAAM,GAAG,GAAG,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC;YAC7B,IAAI,CAAC,GAAG;gBAAE,SAAS;YACnB,MAAM,QAAQ,GAAG,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACtC,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAC7C,IAAI,CAAC,QAAQ,IAAI,SAAS,GAAG,QAAQ,CAAC,SAAS,EAAE,CAAC;gBAChD,WAAW,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;YAC9D,CAAC;QACH,CAAC;QACD,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAC9E,uDAAuD;QACvD,cAAc,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE;YAC/C,MAAM,GAAG,GAAG,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC;YAC7B,IAAI,CAAC,GAAG;gBAAE,OAAO,IAAI,CAAC;YACtB,OAAO,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC9B,CAAC,CAAC,CAAC;IACL,CAAC;IAED,wFAAwF;IACxF,kFAAkF;IAClF,MAAM,cAAc,GAAG,IAAI,GAAG,EAAU,CAAC;IACzC,KAAK,MAAM,CAAC,IAAI,cAAc,EAAE,CAAC;QAC/B,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,QAA+C,CAAC;QACpE,IAAI,IAAI,EAAE,YAAY,KAAK,SAAS,IAAI,IAAI,EAAE,aAAa,EAAE,CAAC;YAC5D,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,aAAuB,CAAC,CAAC;QACnD,CAAC;IACH,CAAC;IACD,IAAI,cAAc,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;QAC5B,cAAc,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;IAC9E,CAAC;IAED,iFAAiF;IACjF,IAAI,OAAO,CAAC,WAAW,IAAI,OAAO,CAAC,WAAW,GAAG,CAAC,EAAE,CAAC;QACnD,IAAI,UAAU,GAAG,CAAC,CAAC;QACnB,MAAM,aAAa,GAA0B,EAAE,CAAC;QAChD,KAAK,MAAM,CAAC,IAAI,cAAc,EAAE,CAAC;YAC/B,uEAAuE;YACvE,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;gBACrD,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACtE,IAAI,UAAU,GAAG,UAAU,GAAG,OAAO,CAAC,WAAW;gBAAE,MAAM;YACzD,UAAU,IAAI,UAAU,CAAC;YACzB,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACxB,CAAC;QACD,cAAc,GAAG,aAAa,CAAC;IACjC,CAAC;IAED,uCAAuC;IACvC,IAAI,OAAO,GAAG,MAAM,qBAAqB,CAAC,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC;IAC5F,OAAO,CAAC,KAAK,CAAC,kCAAkC,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,cAAc,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,IAAI,CAAC,CAAC;IAEzG,0CAA0C;IAC1C,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;QACzB,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,kBAAkB,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACzE,MAAM,KAAK,GAA8F,EAAE,CAAC;YAC5G,KAAK,MAAM,MAAM,IAAI,QAAQ,EAAE,CAAC;gBAC9B,MAAM,WAAW,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,iBAAiB,CAAC,OAAO,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;gBACxF,KAAK,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC,CAAC;YAC7B,CAAC;YACD,MAAM,CAAC,KAAK,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;QACrC,CAAC;IACH,CAAC;IAED,6DAA6D;IAC7D,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;QAC3B,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,iBAAiB,CAAC,OAAO,CAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAChG,yDAAyD;YACzD,MAAM,CAAC,OAAO,GAAG,OAAO;iBACrB,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;iBACpC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC;QAC3C,CAAC;IACH,CAAC;IAED,mFAAmF;IACnF,KAAK,cAAc,CAAC,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,KAAK,EAAE,OAAO,EAAE;QAC5E,YAAY,EAAE,MAAM,CAAC,oBAAoB;QACzC,cAAc,EAAE,MAAM,CAAC,sBAAsB;KAC9C,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,2CAA2C,EAAE,GAAG,CAAC,CAAC,CAAC;IAEjF,OAAO;QACL,OAAO;QACP,eAAe;QACf,eAAe,EAAE,aAAa,CAAC,MAAM;QACrC,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;KACnC,CAAC;AACJ,CAAC;AAED,sDAAsD;AACtD,SAAS,SAAS,CAAC,CAAW,EAAE,CAAW;IACzC,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IACtD,IAAI,GAAG,GAAG,CAAC,EAAE,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,CAAC,CAAC;IAClC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAClC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAE,GAAG,CAAC,CAAC,CAAC,CAAE,CAAC;QACrB,KAAK,IAAI,CAAC,CAAC,CAAC,CAAE,GAAG,CAAC,CAAC,CAAC,CAAE,CAAC;QACvB,KAAK,IAAI,CAAC,CAAC,CAAC,CAAE,GAAG,CAAC,CAAC,CAAC,CAAE,CAAC;IACzB,CAAC;IACD,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClD,OAAO,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,KAAK,CAAC;AACvC,CAAC"}

package/dist/retrieval/temporal-scorer.d.ts

@@ -0,0 +1,18 @@
+import type { Candidate } from './types.js';
+export interface TimeReference {
+    year?: number;
+    month?: number;
+    day?: number;
+    ordering?: 'first' | 'last';
+}
+/**
+ * Extract temporal references from a search query.
+ * Returns null if query has no temporal component.
+ */
+export declare function extractTimeReference(query: string): TimeReference | null;
+/**
+ * Score candidates by temporal proximity to the query's time reference.
+ * Mutates candidates in place, setting their `temporalScore`.
+ */
+export declare function scoreTemporalRelevance(candidates: Candidate[], timeRef: TimeReference): void;
+//# sourceMappingURL=temporal-scorer.d.ts.map

package/dist/retrieval/temporal-scorer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"temporal-scorer.d.ts","sourceRoot":"","sources":["../../src/retrieval/temporal-scorer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;CAC7B;AAWD;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CA8CxE;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,SAAS,EAAE,EAAE,OAAO,EAAE,aAAa,GAAG,IAAI,CAoC5F"}

package/dist/retrieval/temporal-scorer.js

@@ -0,0 +1,106 @@
+const MONTH_NAMES = [
+    'january', 'february', 'march', 'april', 'may', 'june',
+    'july', 'august', 'september', 'october', 'november', 'december',
+];
+const MONTH_ABBR = [
+    'jan', 'feb', 'mar', 'apr', 'may', 'jun',
+    'jul', 'aug', 'sep', 'oct', 'nov', 'dec',
+];
+/**
+ * Extract temporal references from a search query.
+ * Returns null if query has no temporal component.
+ */
+export function extractTimeReference(query) {
+    const lower = query.toLowerCase();
+    let ordering;
+    if (/\bfirst\b/.test(lower))
+        ordering = 'first';
+    if (/\blast\b/.test(lower) && !/\blast\s+(week|month|year)\b/.test(lower))
+        ordering = 'last';
+    // Try explicit date: "March 15th", "March 15, 2023"
+    for (let i = 0; i < MONTH_NAMES.length; i++) {
+        const name = MONTH_NAMES[i];
+        const abbr = MONTH_ABBR[i];
+        const monthPattern = new RegExp(`(?:${name}|${abbr})\\.?\\s+(\\d{1,2})(?:st|nd|rd|th)?(?:[,\\s]+(\\d{4}))?`, 'i');
+        const match = lower.match(monthPattern);
+        if (match) {
+            return { month: i, day: parseInt(match[1], 10), year: match[2] ? parseInt(match[2], 10) : undefined, ordering };
+        }
+        const reversePattern = new RegExp(`(\\d{1,2})(?:st|nd|rd|th)?\\s+(?:${name}|${abbr})(?:[,\\s]+(\\d{4}))?`, 'i');
+        const revMatch = lower.match(reversePattern);
+        if (revMatch) {
+            return { month: i, day: parseInt(revMatch[1], 10), year: revMatch[2] ? parseInt(revMatch[2], 10) : undefined, ordering };
+        }
+    }
+    // Month-only: "in February", "during March"
+    for (let i = 0; i < MONTH_NAMES.length; i++) {
+        if (lower.includes(MONTH_NAMES[i]) || lower.includes(MONTH_ABBR[i])) {
+            return { month: i, ordering };
+        }
+    }
+    // Relative: "yesterday", "last week", "last month"
+    if (/\byesterday\b/.test(lower)) {
+        const d = new Date();
+        d.setDate(d.getDate() - 1);
+        return { year: d.getFullYear(), month: d.getMonth(), day: d.getDate(), ordering };
+    }
+    if (/\blast\s+week\b/.test(lower)) {
+        const d = new Date();
+        d.setDate(d.getDate() - 7);
+        return { year: d.getFullYear(), month: d.getMonth(), day: d.getDate(), ordering };
+    }
+    if (/\blast\s+month\b/.test(lower)) {
+        const d = new Date();
+        d.setMonth(d.getMonth() - 1);
+        return { year: d.getFullYear(), month: d.getMonth(), ordering };
+    }
+    if (ordering)
+        return { ordering };
+    return null;
+}
+/**
+ * Score candidates by temporal proximity to the query's time reference.
+ * Mutates candidates in place, setting their `temporalScore`.
+ */
+export function scoreTemporalRelevance(candidates, timeRef) {
+    // For ordering queries ("which first/last"), score by eventDate order
+    if (timeRef.ordering && !timeRef.month && !timeRef.day && !timeRef.year) {
+        const withDates = candidates.filter(c => c.fact.eventDate != null);
+        if (withDates.length === 0)
+            return;
+        withDates.sort((a, b) => {
+            const aDate = new Date(a.fact.eventDate).getTime();
+            const bDate = new Date(b.fact.eventDate).getTime();
+            return timeRef.ordering === 'first' ? aDate - bDate : bDate - aDate;
+        });
+        for (let i = 0; i < withDates.length; i++) {
+            withDates[i].temporalScore = 1.0 - (i / withDates.length);
+        }
+        return;
+    }
+    // For date-proximity queries, score by distance to reference date
+    const now = new Date();
+    const refDate = new Date(timeRef.year ?? now.getFullYear(), timeRef.month ?? 0, timeRef.day ?? 15);
+    const refTime = refDate.getTime();
+    let maxDistance = 0;
+    for (const c of candidates) {
+        const eventDate = c.fact.eventDate ?? c.fact.documentDate;
+        if (!eventDate)
+            continue;
+        const dist = Math.abs(new Date(eventDate).getTime() - refTime);
+        if (dist > maxDistance)
+            maxDistance = dist;
+    }
+    if (maxDistance === 0)
+        return;
+    for (const c of candidates) {
+        const eventDate = c.fact.eventDate ?? c.fact.documentDate;
+        if (!eventDate) {
+            c.temporalScore = 0;
+            continue;
+        }
+        const dist = Math.abs(new Date(eventDate).getTime() - refTime);
+        c.temporalScore = 1.0 - (dist / maxDistance);
+    }
+}
+//# sourceMappingURL=temporal-scorer.js.map

package/dist/retrieval/temporal-scorer.js.map

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

package/dist/retrieval/trigger-matcher.d.ts

@@ -0,0 +1,18 @@
+import type { StorageAdapter } from '../adapters/storage.js';
+import type { EmbeddingAdapter } from '../adapters/embedding.js';
+import type { Candidate } from './types.js';
+import type { TriggerCondition } from '../models/trigger.js';
+export declare function matchTriggers(storage: StorageAdapter, embedding: EmbeddingAdapter, query: string, tenantId: string, scope: string, scopeId: string): Promise<{
+    candidates: Candidate[];
+    triggersMatched: string[];
+}>;
+/** Evaluate a trigger condition against query text */
+export declare function evaluateCondition(condition: TriggerCondition, query: string, context: {
+    storage: StorageAdapter;
+    embedding: EmbeddingAdapter;
+    tenantId: string;
+    scope: string;
+    scopeId: string;
+}): Promise<boolean>;
+export declare function cosineSimilarity(a: number[], b: number[]): number;
+//# sourceMappingURL=trigger-matcher.d.ts.map

package/dist/retrieval/trigger-matcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trigger-matcher.d.ts","sourceRoot":"","sources":["../../src/retrieval/trigger-matcher.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAG7D,wBAAsB,aAAa,CACjC,OAAO,EAAE,cAAc,EACvB,SAAS,EAAE,gBAAgB,EAC3B,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,GACd,OAAO,CAAC;IAAE,UAAU,EAAE,SAAS,EAAE,CAAC;IAAC,eAAe,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAgFjE;AAED,sDAAsD;AACtD,wBAAsB,iBAAiB,CACrC,SAAS,EAAE,gBAAgB,EAC3B,KAAK,EAAE,MAAM,EACb,OAAO,EAAE;IACP,OAAO,EAAE,cAAc,CAAC;IACxB,SAAS,EAAE,gBAAgB,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB,GACA,OAAO,CAAC,OAAO,CAAC,CA2DlB;AAED,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,CAYjE"}

package/dist/retrieval/trigger-matcher.js

@@ -0,0 +1,134 @@
+import { vectorSearch } from './vector-search.js';
+export async function matchTriggers(storage, embedding, query, tenantId, scope, scopeId) {
+    // 1. Get active triggers, sorted by priority descending
+    const triggers = await storage.getActiveTriggers(tenantId, scope, scopeId);
+    // triggers should already be sorted by priority DESC from storage
+    const candidates = [];
+    const triggersMatched = [];
+    // 2. Evaluate each trigger
+    for (const trigger of triggers) {
+        const matches = await evaluateCondition(trigger.condition, query, {
+            storage,
+            embedding,
+            tenantId,
+            scope,
+            scopeId,
+        });
+        if (matches) {
+            triggersMatched.push(trigger.id);
+            // Surface facts from factIds (batch fetch)
+            if (trigger.factIds && trigger.factIds.length > 0) {
+                const facts = await storage.getFactsByIds(tenantId, trigger.factIds);
+                for (const fact of facts) {
+                    if (fact.validUntil === null) {
+                        candidates.push({
+                            fact,
+                            vectorScore: 0,
+                            keywordScore: 0,
+                            graphScore: 0,
+                            recencyScore: 0,
+                            salienceScore: 0,
+                            temporalScore: 0,
+                            source: 'trigger',
+                            triggeredBy: trigger.id,
+                        });
+                    }
+                }
+            }
+            // Surface facts for entityIds
+            if (trigger.entityIds && trigger.entityIds.length > 0) {
+                for (const entityId of trigger.entityIds) {
+                    const result = await storage.getFactsForEntity(tenantId, entityId, { limit: 10 });
+                    for (const fact of result.data) {
+                        if (fact.validUntil === null) {
+                            candidates.push({
+                                fact,
+                                vectorScore: 0,
+                                keywordScore: 0,
+                                graphScore: 0,
+                                recencyScore: 0,
+                                salienceScore: 0,
+                                temporalScore: 0,
+                                source: 'trigger',
+                                triggeredBy: trigger.id,
+                            });
+                        }
+                    }
+                }
+            }
+            // Handle queryTemplate — run a vector sub-search with the template
+            if (trigger.queryTemplate) {
+                const templateResults = await vectorSearch(storage, embedding, trigger.queryTemplate, tenantId, scope, scopeId, 5);
+                for (const c of templateResults) {
+                    candidates.push({ ...c, source: 'trigger', triggeredBy: trigger.id });
+                }
+            }
+            // Increment trigger fire count (fire and forget)
+            void storage.incrementTriggerFired(tenantId, trigger.id).catch(() => { });
+        }
+    }
+    return { candidates, triggersMatched };
+}
+/** Evaluate a trigger condition against query text */
+export async function evaluateCondition(condition, query, context) {
+    const lowerQuery = query.toLowerCase();
+    // AND: all sub-conditions must match (checked first — if present, only AND logic applies)
+    if (condition.AND && condition.AND.length > 0) {
+        const results = await Promise.all(condition.AND.map((sub) => evaluateCondition(sub, query, context)));
+        return results.every(Boolean);
+    }
+    // OR: any sub-condition must match (checked second — if present, only OR logic applies)
+    if (condition.OR && condition.OR.length > 0) {
+        const results = await Promise.all(condition.OR.map((sub) => evaluateCondition(sub, query, context)));
+        return results.some(Boolean);
+    }
+    // topic_match: any topic word appears in query
+    if (condition.topic_match && condition.topic_match.length > 0) {
+        if (condition.topic_match.some((topic) => lowerQuery.includes(topic.toLowerCase()))) {
+            return true;
+        }
+    }
+    // keyword_any: any keyword appears in query
+    if (condition.keyword_any && condition.keyword_any.length > 0) {
+        if (condition.keyword_any.some((kw) => lowerQuery.includes(kw.toLowerCase()))) {
+            return true;
+        }
+    }
+    // entity_present: check if entities of given type(s) exist for this tenant
+    // NOTE: entity_present currently checks tenant-wide, not scope-specific.
+    // A scope-filtered version would require joining through fact_entities → facts.
+    // This is acceptable for v1 but should be improved when per-scope entity queries are added.
+    if (condition.entity_present && condition.entity_present.length > 0) {
+        const entities = await context.storage.getEntitiesForTenant(context.tenantId, { limit: 100 });
+        const hasMatchingEntity = entities.data.some((e) => condition.entity_present.some((type) => e.entityType.toLowerCase() === type.toLowerCase()));
+        if (hasMatchingEntity)
+            return true;
+    }
+    // semantic_similarity: embed both texts and compare
+    if (condition.semantic_similarity) {
+        const { text, threshold } = condition.semantic_similarity;
+        const [queryEmb, condEmb] = await Promise.all([
+            context.embedding.embed(query),
+            context.embedding.embed(text),
+        ]);
+        const similarity = cosineSimilarity(queryEmb, condEmb);
+        if (similarity >= threshold)
+            return true;
+    }
+    return false;
+}
+export function cosineSimilarity(a, b) {
+    if (a.length !== b.length || a.length === 0)
+        return 0;
+    let dot = 0;
+    let normA = 0;
+    let normB = 0;
+    for (let i = 0; i < a.length; i++) {
+        dot += a[i] * b[i];
+        normA += a[i] * a[i];
+        normB += b[i] * b[i];
+    }
+    const denom = Math.sqrt(normA) * Math.sqrt(normB);
+    return denom === 0 ? 0 : dot / denom;
+}
+//# sourceMappingURL=trigger-matcher.js.map

package/dist/retrieval/trigger-matcher.js.map

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

package/dist/retrieval/types.d.ts

@@ -0,0 +1,70 @@
+import type { Fact, Entity, Edge } from '../models/index.js';
+/** Options for the main search function */
+export interface SearchOptions {
+    query: string;
+    tenantId: string;
+    scope: string;
+    scopeId: string;
+    limit?: number;
+    includeGraph?: boolean;
+    includeHistory?: boolean;
+    temporalFilter?: {
+        asOf?: Date;
+    };
+    weights?: FusionWeights;
+    tokenBudget?: number;
+}
+/** Configurable fusion weights (should sum to 1.0 — normalized if not) */
+export interface FusionWeights {
+    vector: number;
+    keyword: number;
+    graph: number;
+    recency: number;
+    salience: number;
+    temporal: number;
+}
+/** A single search result with all signal scores */
+export interface SearchResult {
+    fact: Fact;
+    score: number;
+    signals: {
+        vectorScore: number;
+        keywordScore: number;
+        graphScore: number;
+        recencyScore: number;
+        salienceScore: number;
+        temporalScore: number;
+    };
+    triggeredBy?: string;
+    contradiction?: {
+        contradicts: Fact;
+        status: string;
+        timeline: string;
+    };
+    graph?: {
+        entities: Entity[];
+        edges: Edge[];
+    };
+    history?: Fact[];
+}
+/** Full search response */
+export interface SearchResponse {
+    results: SearchResult[];
+    triggersMatched: string[];
+    totalCandidates: number;
+    durationMs: number;
+}
+/** Internal: candidate fact before fusion scoring */
+export interface Candidate {
+    fact: Fact;
+    vectorScore: number;
+    keywordScore: number;
+    graphScore: number;
+    recencyScore: number;
+    salienceScore: number;
+    temporalScore: number;
+    source: 'vector' | 'keyword' | 'graph' | 'trigger';
+    triggeredBy?: string;
+}
+export declare const DEFAULT_FUSION_WEIGHTS: FusionWeights;
+//# sourceMappingURL=types.d.ts.map

package/dist/retrieval/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/retrieval/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAE7D,2CAA2C;AAC3C,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,cAAc,CAAC,EAAE;QACf,IAAI,CAAC,EAAE,IAAI,CAAC;KACb,CAAC;IACF,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,0EAA0E;AAC1E,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,oDAAoD;AACpD,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,IAAI,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE;QACP,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,EAAE,MAAM,CAAC;QACrB,UAAU,EAAE,MAAM,CAAC;QACnB,YAAY,EAAE,MAAM,CAAC;QACrB,aAAa,EAAE,MAAM,CAAC;QACtB,aAAa,EAAE,MAAM,CAAC;KACvB,CAAC;IACF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE;QACd,WAAW,EAAE,IAAI,CAAC;QAClB,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,KAAK,CAAC,EAAE;QACN,QAAQ,EAAE,MAAM,EAAE,CAAC;QACnB,KAAK,EAAE,IAAI,EAAE,CAAC;KACf,CAAC;IACF,OAAO,CAAC,EAAE,IAAI,EAAE,CAAC;CAClB;AAED,2BAA2B;AAC3B,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,qDAAqD;AACrD,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,IAAI,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,QAAQ,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,CAAC;IACnD,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,eAAO,MAAM,sBAAsB,EAAE,aAOpC,CAAC"}

package/dist/retrieval/types.js

@@ -0,0 +1,9 @@
+export const DEFAULT_FUSION_WEIGHTS = {
+    vector: 0.30,
+    keyword: 0.15,
+    graph: 0.15,
+    recency: 0.10,
+    salience: 0.10,
+    temporal: 0.20,
+};
+//# sourceMappingURL=types.js.map

package/dist/retrieval/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/retrieval/types.ts"],"names":[],"mappings":"AA0EA,MAAM,CAAC,MAAM,sBAAsB,GAAkB;IACnD,MAAM,EAAE,IAAI;IACZ,OAAO,EAAE,IAAI;IACb,KAAK,EAAE,IAAI;IACX,OAAO,EAAE,IAAI;IACb,QAAQ,EAAE,IAAI;IACd,QAAQ,EAAE,IAAI;CACf,CAAC"}