@steno-ai/engine 0.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/adapters/cache.d.ts +9 -0
- package/dist/adapters/cache.d.ts.map +1 -0
- package/dist/adapters/cache.js +2 -0
- package/dist/adapters/cache.js.map +1 -0
- package/dist/adapters/embedding.d.ts +7 -0
- package/dist/adapters/embedding.d.ts.map +1 -0
- package/dist/adapters/embedding.js +2 -0
- package/dist/adapters/embedding.js.map +1 -0
- package/dist/adapters/gemini-embedding.d.ts +18 -0
- package/dist/adapters/gemini-embedding.d.ts.map +1 -0
- package/dist/adapters/gemini-embedding.js +53 -0
- package/dist/adapters/gemini-embedding.js.map +1 -0
- package/dist/adapters/index.d.ts +7 -0
- package/dist/adapters/index.d.ts.map +1 -0
- package/dist/adapters/index.js +7 -0
- package/dist/adapters/index.js.map +1 -0
- package/dist/adapters/llm.d.ts +19 -0
- package/dist/adapters/llm.d.ts.map +1 -0
- package/dist/adapters/llm.js +2 -0
- package/dist/adapters/llm.js.map +1 -0
- package/dist/adapters/perplexity-embedding.d.ts +24 -0
- package/dist/adapters/perplexity-embedding.d.ts.map +1 -0
- package/dist/adapters/perplexity-embedding.js +78 -0
- package/dist/adapters/perplexity-embedding.js.map +1 -0
- package/dist/adapters/storage.d.ts +172 -0
- package/dist/adapters/storage.d.ts.map +1 -0
- package/dist/adapters/storage.js +2 -0
- package/dist/adapters/storage.js.map +1 -0
- package/dist/auth/api-key.d.ts +8 -0
- package/dist/auth/api-key.d.ts.map +1 -0
- package/dist/auth/api-key.js +27 -0
- package/dist/auth/api-key.js.map +1 -0
- package/dist/auth/index.d.ts +2 -0
- package/dist/auth/index.d.ts.map +1 -0
- package/dist/auth/index.js +2 -0
- package/dist/auth/index.js.map +1 -0
- package/dist/config.d.ts +296 -0
- package/dist/config.d.ts.map +1 -0
- package/dist/config.js +92 -0
- package/dist/config.js.map +1 -0
- package/dist/extraction/contradiction.d.ts +15 -0
- package/dist/extraction/contradiction.d.ts.map +1 -0
- package/dist/extraction/contradiction.js +23 -0
- package/dist/extraction/contradiction.js.map +1 -0
- package/dist/extraction/dedup.d.ts +12 -0
- package/dist/extraction/dedup.d.ts.map +1 -0
- package/dist/extraction/dedup.js +93 -0
- package/dist/extraction/dedup.js.map +1 -0
- package/dist/extraction/entity-extractor.d.ts +30 -0
- package/dist/extraction/entity-extractor.d.ts.map +1 -0
- package/dist/extraction/entity-extractor.js +145 -0
- package/dist/extraction/entity-extractor.js.map +1 -0
- package/dist/extraction/hasher.d.ts +5 -0
- package/dist/extraction/hasher.d.ts.map +1 -0
- package/dist/extraction/hasher.js +8 -0
- package/dist/extraction/hasher.js.map +1 -0
- package/dist/extraction/heuristic.d.ts +3 -0
- package/dist/extraction/heuristic.d.ts.map +1 -0
- package/dist/extraction/heuristic.js +282 -0
- package/dist/extraction/heuristic.js.map +1 -0
- package/dist/extraction/index.d.ts +10 -0
- package/dist/extraction/index.d.ts.map +1 -0
- package/dist/extraction/index.js +10 -0
- package/dist/extraction/index.js.map +1 -0
- package/dist/extraction/llm-extractor.d.ts +23 -0
- package/dist/extraction/llm-extractor.d.ts.map +1 -0
- package/dist/extraction/llm-extractor.js +238 -0
- package/dist/extraction/llm-extractor.js.map +1 -0
- package/dist/extraction/pipeline.d.ts +30 -0
- package/dist/extraction/pipeline.d.ts.map +1 -0
- package/dist/extraction/pipeline.js +398 -0
- package/dist/extraction/pipeline.js.map +1 -0
- package/dist/extraction/prompts.d.ts +28 -0
- package/dist/extraction/prompts.d.ts.map +1 -0
- package/dist/extraction/prompts.js +196 -0
- package/dist/extraction/prompts.js.map +1 -0
- package/dist/extraction/sliding-window.d.ts +41 -0
- package/dist/extraction/sliding-window.d.ts.map +1 -0
- package/dist/extraction/sliding-window.js +84 -0
- package/dist/extraction/sliding-window.js.map +1 -0
- package/dist/extraction/types.d.ts +80 -0
- package/dist/extraction/types.d.ts.map +1 -0
- package/dist/extraction/types.js +2 -0
- package/dist/extraction/types.js.map +1 -0
- package/dist/feedback/index.d.ts +2 -0
- package/dist/feedback/index.d.ts.map +1 -0
- package/dist/feedback/index.js +2 -0
- package/dist/feedback/index.js.map +1 -0
- package/dist/feedback/tracker.d.ts +25 -0
- package/dist/feedback/tracker.d.ts.map +1 -0
- package/dist/feedback/tracker.js +90 -0
- package/dist/feedback/tracker.js.map +1 -0
- package/dist/index.d.ts +12 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +13 -0
- package/dist/index.js.map +1 -0
- package/dist/models/api-key.d.ts +54 -0
- package/dist/models/api-key.d.ts.map +1 -0
- package/dist/models/api-key.js +21 -0
- package/dist/models/api-key.js.map +1 -0
- package/dist/models/edge.d.ts +78 -0
- package/dist/models/edge.d.ts.map +1 -0
- package/dist/models/edge.js +29 -0
- package/dist/models/edge.js.map +1 -0
- package/dist/models/entity.d.ts +60 -0
- package/dist/models/entity.d.ts.map +1 -0
- package/dist/models/entity.js +22 -0
- package/dist/models/entity.js.map +1 -0
- package/dist/models/extraction.d.ts +111 -0
- package/dist/models/extraction.d.ts.map +1 -0
- package/dist/models/extraction.js +40 -0
- package/dist/models/extraction.js.map +1 -0
- package/dist/models/fact-entity.d.ts +33 -0
- package/dist/models/fact-entity.d.ts.map +1 -0
- package/dist/models/fact-entity.js +14 -0
- package/dist/models/fact-entity.js.map +1 -0
- package/dist/models/fact.d.ts +191 -0
- package/dist/models/fact.d.ts.map +1 -0
- package/dist/models/fact.js +72 -0
- package/dist/models/fact.js.map +1 -0
- package/dist/models/index.d.ts +13 -0
- package/dist/models/index.d.ts.map +1 -0
- package/dist/models/index.js +13 -0
- package/dist/models/index.js.map +1 -0
- package/dist/models/memory-access.d.ts +89 -0
- package/dist/models/memory-access.d.ts.map +1 -0
- package/dist/models/memory-access.js +33 -0
- package/dist/models/memory-access.js.map +1 -0
- package/dist/models/session.d.ts +60 -0
- package/dist/models/session.d.ts.map +1 -0
- package/dist/models/session.js +23 -0
- package/dist/models/session.js.map +1 -0
- package/dist/models/tenant.d.ts +448 -0
- package/dist/models/tenant.d.ts.map +1 -0
- package/dist/models/tenant.js +23 -0
- package/dist/models/tenant.js.map +1 -0
- package/dist/models/trigger.d.ts +87 -0
- package/dist/models/trigger.d.ts.map +1 -0
- package/dist/models/trigger.js +41 -0
- package/dist/models/trigger.js.map +1 -0
- package/dist/models/usage-record.d.ts +37 -0
- package/dist/models/usage-record.d.ts.map +1 -0
- package/dist/models/usage-record.js +14 -0
- package/dist/models/usage-record.js.map +1 -0
- package/dist/models/webhook.d.ts +50 -0
- package/dist/models/webhook.d.ts.map +1 -0
- package/dist/models/webhook.js +25 -0
- package/dist/models/webhook.js.map +1 -0
- package/dist/profiles/index.d.ts +3 -0
- package/dist/profiles/index.d.ts.map +1 -0
- package/dist/profiles/index.js +2 -0
- package/dist/profiles/index.js.map +1 -0
- package/dist/profiles/profile.d.ts +22 -0
- package/dist/profiles/profile.d.ts.map +1 -0
- package/dist/profiles/profile.js +59 -0
- package/dist/profiles/profile.js.map +1 -0
- package/dist/retrieval/compound-search.d.ts +13 -0
- package/dist/retrieval/compound-search.d.ts.map +1 -0
- package/dist/retrieval/compound-search.js +87 -0
- package/dist/retrieval/compound-search.js.map +1 -0
- package/dist/retrieval/contradiction-surfacer.d.ts +18 -0
- package/dist/retrieval/contradiction-surfacer.d.ts.map +1 -0
- package/dist/retrieval/contradiction-surfacer.js +64 -0
- package/dist/retrieval/contradiction-surfacer.js.map +1 -0
- package/dist/retrieval/embedding-cache.d.ts +17 -0
- package/dist/retrieval/embedding-cache.d.ts.map +1 -0
- package/dist/retrieval/embedding-cache.js +56 -0
- package/dist/retrieval/embedding-cache.js.map +1 -0
- package/dist/retrieval/fusion.d.ts +27 -0
- package/dist/retrieval/fusion.d.ts.map +1 -0
- package/dist/retrieval/fusion.js +87 -0
- package/dist/retrieval/fusion.js.map +1 -0
- package/dist/retrieval/graph-traversal.d.ts +29 -0
- package/dist/retrieval/graph-traversal.d.ts.map +1 -0
- package/dist/retrieval/graph-traversal.js +208 -0
- package/dist/retrieval/graph-traversal.js.map +1 -0
- package/dist/retrieval/index.d.ts +14 -0
- package/dist/retrieval/index.d.ts.map +1 -0
- package/dist/retrieval/index.js +13 -0
- package/dist/retrieval/index.js.map +1 -0
- package/dist/retrieval/keyword-search.d.ts +4 -0
- package/dist/retrieval/keyword-search.d.ts.map +1 -0
- package/dist/retrieval/keyword-search.js +27 -0
- package/dist/retrieval/keyword-search.js.map +1 -0
- package/dist/retrieval/query-expansion.d.ts +20 -0
- package/dist/retrieval/query-expansion.d.ts.map +1 -0
- package/dist/retrieval/query-expansion.js +76 -0
- package/dist/retrieval/query-expansion.js.map +1 -0
- package/dist/retrieval/reranker.d.ts +15 -0
- package/dist/retrieval/reranker.d.ts.map +1 -0
- package/dist/retrieval/reranker.js +47 -0
- package/dist/retrieval/reranker.js.map +1 -0
- package/dist/retrieval/salience-scorer.d.ts +15 -0
- package/dist/retrieval/salience-scorer.d.ts.map +1 -0
- package/dist/retrieval/salience-scorer.js +41 -0
- package/dist/retrieval/salience-scorer.js.map +1 -0
- package/dist/retrieval/search.d.ts +21 -0
- package/dist/retrieval/search.d.ts.map +1 -0
- package/dist/retrieval/search.js +228 -0
- package/dist/retrieval/search.js.map +1 -0
- package/dist/retrieval/temporal-scorer.d.ts +18 -0
- package/dist/retrieval/temporal-scorer.d.ts.map +1 -0
- package/dist/retrieval/temporal-scorer.js +106 -0
- package/dist/retrieval/temporal-scorer.js.map +1 -0
- package/dist/retrieval/trigger-matcher.d.ts +18 -0
- package/dist/retrieval/trigger-matcher.d.ts.map +1 -0
- package/dist/retrieval/trigger-matcher.js +134 -0
- package/dist/retrieval/trigger-matcher.js.map +1 -0
- package/dist/retrieval/types.d.ts +70 -0
- package/dist/retrieval/types.d.ts.map +1 -0
- package/dist/retrieval/types.js +9 -0
- package/dist/retrieval/types.js.map +1 -0
- package/dist/retrieval/vector-search.d.ts +5 -0
- package/dist/retrieval/vector-search.d.ts.map +1 -0
- package/dist/retrieval/vector-search.js +24 -0
- package/dist/retrieval/vector-search.js.map +1 -0
- package/dist/salience/decay.d.ts +9 -0
- package/dist/salience/decay.d.ts.map +1 -0
- package/dist/salience/decay.js +15 -0
- package/dist/salience/decay.js.map +1 -0
- package/dist/salience/index.d.ts +2 -0
- package/dist/salience/index.d.ts.map +1 -0
- package/dist/salience/index.js +2 -0
- package/dist/salience/index.js.map +1 -0
- package/dist/scratchpad/index.d.ts +2 -0
- package/dist/scratchpad/index.d.ts.map +1 -0
- package/dist/scratchpad/index.js +2 -0
- package/dist/scratchpad/index.js.map +1 -0
- package/dist/scratchpad/scratchpad.d.ts +23 -0
- package/dist/scratchpad/scratchpad.d.ts.map +1 -0
- package/dist/scratchpad/scratchpad.js +107 -0
- package/dist/scratchpad/scratchpad.js.map +1 -0
- package/dist/sessions/index.d.ts +2 -0
- package/dist/sessions/index.d.ts.map +1 -0
- package/dist/sessions/index.js +2 -0
- package/dist/sessions/index.js.map +1 -0
- package/dist/sessions/manager.d.ts +11 -0
- package/dist/sessions/manager.d.ts.map +1 -0
- package/dist/sessions/manager.js +63 -0
- package/dist/sessions/manager.js.map +1 -0
- package/package.json +38 -0
- package/src/adapters/cache.d.ts +9 -0
- package/src/adapters/cache.d.ts.map +1 -0
- package/src/adapters/cache.js.map +1 -0
- package/src/adapters/cache.ts +8 -0
- package/src/adapters/embedding.d.ts +7 -0
- package/src/adapters/embedding.d.ts.map +1 -0
- package/src/adapters/embedding.js.map +1 -0
- package/src/adapters/embedding.ts +6 -0
- package/src/adapters/gemini-embedding.ts +67 -0
- package/src/adapters/index.ts +6 -0
- package/src/adapters/llm.d.ts +19 -0
- package/src/adapters/llm.d.ts.map +1 -0
- package/src/adapters/llm.js.map +1 -0
- package/src/adapters/llm.ts +16 -0
- package/src/adapters/perplexity-embedding.d.ts +24 -0
- package/src/adapters/perplexity-embedding.d.ts.map +1 -0
- package/src/adapters/perplexity-embedding.js.map +1 -0
- package/src/adapters/perplexity-embedding.ts +98 -0
- package/src/adapters/storage.d.ts +172 -0
- package/src/adapters/storage.d.ts.map +1 -0
- package/src/adapters/storage.js.map +1 -0
- package/src/adapters/storage.ts +187 -0
- package/src/auth/api-key.ts +33 -0
- package/src/auth/index.ts +1 -0
- package/src/config.d.ts +86 -0
- package/src/config.d.ts.map +1 -0
- package/src/config.js.map +1 -0
- package/src/config.ts +131 -0
- package/src/extraction/contradiction.d.ts +15 -0
- package/src/extraction/contradiction.d.ts.map +1 -0
- package/src/extraction/contradiction.js.map +1 -0
- package/src/extraction/contradiction.ts +33 -0
- package/src/extraction/dedup.d.ts +12 -0
- package/src/extraction/dedup.d.ts.map +1 -0
- package/src/extraction/dedup.js.map +1 -0
- package/src/extraction/dedup.ts +133 -0
- package/src/extraction/entity-extractor.d.ts +30 -0
- package/src/extraction/entity-extractor.d.ts.map +1 -0
- package/src/extraction/entity-extractor.js.map +1 -0
- package/src/extraction/entity-extractor.ts +193 -0
- package/src/extraction/hasher.d.ts +5 -0
- package/src/extraction/hasher.d.ts.map +1 -0
- package/src/extraction/hasher.js.map +1 -0
- package/src/extraction/hasher.ts +7 -0
- package/src/extraction/heuristic.d.ts +3 -0
- package/src/extraction/heuristic.d.ts.map +1 -0
- package/src/extraction/heuristic.js.map +1 -0
- package/src/extraction/heuristic.ts +341 -0
- package/src/extraction/index.ts +9 -0
- package/src/extraction/llm-extractor.d.ts +21 -0
- package/src/extraction/llm-extractor.d.ts.map +1 -0
- package/src/extraction/llm-extractor.js.map +1 -0
- package/src/extraction/llm-extractor.ts +267 -0
- package/src/extraction/pipeline.d.ts +27 -0
- package/src/extraction/pipeline.d.ts.map +1 -0
- package/src/extraction/pipeline.js.map +1 -0
- package/src/extraction/pipeline.ts +515 -0
- package/src/extraction/prompts.js.map +1 -0
- package/src/extraction/prompts.ts +233 -0
- package/src/extraction/sliding-window.d.ts +41 -0
- package/src/extraction/sliding-window.d.ts.map +1 -0
- package/src/extraction/sliding-window.js.map +1 -0
- package/src/extraction/sliding-window.ts +121 -0
- package/src/extraction/types.d.ts +68 -0
- package/src/extraction/types.d.ts.map +1 -0
- package/src/extraction/types.js.map +1 -0
- package/src/extraction/types.ts +80 -0
- package/src/feedback/index.ts +1 -0
- package/src/feedback/tracker.d.ts +25 -0
- package/src/feedback/tracker.d.ts.map +1 -0
- package/src/feedback/tracker.js.map +1 -0
- package/src/feedback/tracker.ts +119 -0
- package/src/index.ts +12 -0
- package/src/models/api-key.d.ts +54 -0
- package/src/models/api-key.d.ts.map +1 -0
- package/src/models/api-key.js.map +1 -0
- package/src/models/api-key.ts +26 -0
- package/src/models/edge.d.ts +78 -0
- package/src/models/edge.d.ts.map +1 -0
- package/src/models/edge.js.map +1 -0
- package/src/models/edge.ts +34 -0
- package/src/models/entity.d.ts +60 -0
- package/src/models/entity.d.ts.map +1 -0
- package/src/models/entity.js.map +1 -0
- package/src/models/entity.ts +27 -0
- package/src/models/extraction.d.ts +111 -0
- package/src/models/extraction.d.ts.map +1 -0
- package/src/models/extraction.js.map +1 -0
- package/src/models/extraction.ts +45 -0
- package/src/models/fact-entity.d.ts +33 -0
- package/src/models/fact-entity.d.ts.map +1 -0
- package/src/models/fact-entity.js.map +1 -0
- package/src/models/fact-entity.ts +19 -0
- package/src/models/fact.ts +85 -0
- package/src/models/index.d.ts +13 -0
- package/src/models/index.d.ts.map +1 -0
- package/src/models/index.js.map +1 -0
- package/src/models/index.ts +12 -0
- package/src/models/memory-access.d.ts +89 -0
- package/src/models/memory-access.d.ts.map +1 -0
- package/src/models/memory-access.js.map +1 -0
- package/src/models/memory-access.ts +41 -0
- package/src/models/session.d.ts +60 -0
- package/src/models/session.d.ts.map +1 -0
- package/src/models/session.js.map +1 -0
- package/src/models/session.ts +28 -0
- package/src/models/tenant.d.ts +214 -0
- package/src/models/tenant.d.ts.map +1 -0
- package/src/models/tenant.js.map +1 -0
- package/src/models/tenant.ts +28 -0
- package/src/models/trigger.d.ts +87 -0
- package/src/models/trigger.d.ts.map +1 -0
- package/src/models/trigger.js.map +1 -0
- package/src/models/trigger.ts +58 -0
- package/src/models/usage-record.d.ts +37 -0
- package/src/models/usage-record.d.ts.map +1 -0
- package/src/models/usage-record.js.map +1 -0
- package/src/models/usage-record.ts +16 -0
- package/src/models/webhook.d.ts +50 -0
- package/src/models/webhook.d.ts.map +1 -0
- package/src/models/webhook.js.map +1 -0
- package/src/models/webhook.ts +30 -0
- package/src/profiles/index.ts +2 -0
- package/src/profiles/profile.ts +81 -0
- package/src/retrieval/compound-search.d.ts +13 -0
- package/src/retrieval/compound-search.d.ts.map +1 -0
- package/src/retrieval/compound-search.js.map +1 -0
- package/src/retrieval/compound-search.ts +104 -0
- package/src/retrieval/contradiction-surfacer.d.ts +18 -0
- package/src/retrieval/contradiction-surfacer.d.ts.map +1 -0
- package/src/retrieval/contradiction-surfacer.js.map +1 -0
- package/src/retrieval/contradiction-surfacer.ts +87 -0
- package/src/retrieval/embedding-cache.d.ts +17 -0
- package/src/retrieval/embedding-cache.d.ts.map +1 -0
- package/src/retrieval/embedding-cache.js.map +1 -0
- package/src/retrieval/embedding-cache.ts +63 -0
- package/src/retrieval/fusion.d.ts +26 -0
- package/src/retrieval/fusion.d.ts.map +1 -0
- package/src/retrieval/fusion.js.map +1 -0
- package/src/retrieval/fusion.ts +129 -0
- package/src/retrieval/graph-traversal.d.ts +28 -0
- package/src/retrieval/graph-traversal.d.ts.map +1 -0
- package/src/retrieval/graph-traversal.js.map +1 -0
- package/src/retrieval/graph-traversal.ts +235 -0
- package/src/retrieval/index.ts +13 -0
- package/src/retrieval/keyword-search.ts +39 -0
- package/src/retrieval/query-expansion.d.ts +20 -0
- package/src/retrieval/query-expansion.d.ts.map +1 -0
- package/src/retrieval/query-expansion.js.map +1 -0
- package/src/retrieval/query-expansion.ts +86 -0
- package/src/retrieval/reranker.d.ts +15 -0
- package/src/retrieval/reranker.d.ts.map +1 -0
- package/src/retrieval/reranker.js.map +1 -0
- package/src/retrieval/reranker.ts +56 -0
- package/src/retrieval/salience-scorer.d.ts +15 -0
- package/src/retrieval/salience-scorer.d.ts.map +1 -0
- package/src/retrieval/salience-scorer.js.map +1 -0
- package/src/retrieval/salience-scorer.ts +57 -0
- package/src/retrieval/search.d.ts +21 -0
- package/src/retrieval/search.d.ts.map +1 -0
- package/src/retrieval/search.js.map +1 -0
- package/src/retrieval/search.ts +271 -0
- package/src/retrieval/temporal-scorer.ts +111 -0
- package/src/retrieval/trigger-matcher.d.ts +18 -0
- package/src/retrieval/trigger-matcher.d.ts.map +1 -0
- package/src/retrieval/trigger-matcher.js.map +1 -0
- package/src/retrieval/trigger-matcher.ts +180 -0
- package/src/retrieval/types.d.ts +66 -0
- package/src/retrieval/types.d.ts.map +1 -0
- package/src/retrieval/types.js.map +1 -0
- package/src/retrieval/types.ts +82 -0
- package/src/retrieval/vector-search.d.ts +5 -0
- package/src/retrieval/vector-search.d.ts.map +1 -0
- package/src/retrieval/vector-search.js.map +1 -0
- package/src/retrieval/vector-search.ts +38 -0
- package/src/salience/decay.d.ts +9 -0
- package/src/salience/decay.d.ts.map +1 -0
- package/src/salience/decay.js.map +1 -0
- package/src/salience/decay.ts +25 -0
- package/src/salience/index.ts +1 -0
- package/src/scratchpad/index.ts +1 -0
- package/src/scratchpad/scratchpad.d.ts +23 -0
- package/src/scratchpad/scratchpad.d.ts.map +1 -0
- package/src/scratchpad/scratchpad.js.map +1 -0
- package/src/scratchpad/scratchpad.ts +140 -0
- package/src/sessions/index.ts +1 -0
- package/src/sessions/manager.ts +87 -0
|
@@ -0,0 +1,111 @@
|
|
|
1
|
+
import type { Candidate } from './types.js';
|
|
2
|
+
|
|
3
|
+
export interface TimeReference {
|
|
4
|
+
year?: number;
|
|
5
|
+
month?: number; // 0-indexed (JS Date convention)
|
|
6
|
+
day?: number;
|
|
7
|
+
ordering?: 'first' | 'last';
|
|
8
|
+
}
|
|
9
|
+
|
|
10
|
+
const MONTH_NAMES = [
|
|
11
|
+
'january', 'february', 'march', 'april', 'may', 'june',
|
|
12
|
+
'july', 'august', 'september', 'october', 'november', 'december',
|
|
13
|
+
];
|
|
14
|
+
const MONTH_ABBR = [
|
|
15
|
+
'jan', 'feb', 'mar', 'apr', 'may', 'jun',
|
|
16
|
+
'jul', 'aug', 'sep', 'oct', 'nov', 'dec',
|
|
17
|
+
];
|
|
18
|
+
|
|
19
|
+
/**
|
|
20
|
+
* Extract temporal references from a search query.
|
|
21
|
+
* Returns null if query has no temporal component.
|
|
22
|
+
*/
|
|
23
|
+
export function extractTimeReference(query: string): TimeReference | null {
|
|
24
|
+
const lower = query.toLowerCase();
|
|
25
|
+
|
|
26
|
+
let ordering: 'first' | 'last' | undefined;
|
|
27
|
+
if (/\bfirst\b/.test(lower)) ordering = 'first';
|
|
28
|
+
if (/\blast\b/.test(lower) && !/\blast\s+(week|month|year)\b/.test(lower)) ordering = 'last';
|
|
29
|
+
|
|
30
|
+
// Try explicit date: "March 15th", "March 15, 2023"
|
|
31
|
+
for (let i = 0; i < MONTH_NAMES.length; i++) {
|
|
32
|
+
const name = MONTH_NAMES[i]!;
|
|
33
|
+
const abbr = MONTH_ABBR[i]!;
|
|
34
|
+
const monthPattern = new RegExp(`(?:${name}|${abbr})\\.?\\s+(\\d{1,2})(?:st|nd|rd|th)?(?:[,\\s]+(\\d{4}))?`, 'i');
|
|
35
|
+
const match = lower.match(monthPattern);
|
|
36
|
+
if (match) {
|
|
37
|
+
return { month: i, day: parseInt(match[1]!, 10), year: match[2] ? parseInt(match[2], 10) : undefined, ordering };
|
|
38
|
+
}
|
|
39
|
+
const reversePattern = new RegExp(`(\\d{1,2})(?:st|nd|rd|th)?\\s+(?:${name}|${abbr})(?:[,\\s]+(\\d{4}))?`, 'i');
|
|
40
|
+
const revMatch = lower.match(reversePattern);
|
|
41
|
+
if (revMatch) {
|
|
42
|
+
return { month: i, day: parseInt(revMatch[1]!, 10), year: revMatch[2] ? parseInt(revMatch[2], 10) : undefined, ordering };
|
|
43
|
+
}
|
|
44
|
+
}
|
|
45
|
+
|
|
46
|
+
// Month-only: "in February", "during March"
|
|
47
|
+
for (let i = 0; i < MONTH_NAMES.length; i++) {
|
|
48
|
+
if (lower.includes(MONTH_NAMES[i]!) || lower.includes(MONTH_ABBR[i]!)) {
|
|
49
|
+
return { month: i, ordering };
|
|
50
|
+
}
|
|
51
|
+
}
|
|
52
|
+
|
|
53
|
+
// Relative: "yesterday", "last week", "last month"
|
|
54
|
+
if (/\byesterday\b/.test(lower)) {
|
|
55
|
+
const d = new Date(); d.setDate(d.getDate() - 1);
|
|
56
|
+
return { year: d.getFullYear(), month: d.getMonth(), day: d.getDate(), ordering };
|
|
57
|
+
}
|
|
58
|
+
if (/\blast\s+week\b/.test(lower)) {
|
|
59
|
+
const d = new Date(); d.setDate(d.getDate() - 7);
|
|
60
|
+
return { year: d.getFullYear(), month: d.getMonth(), day: d.getDate(), ordering };
|
|
61
|
+
}
|
|
62
|
+
if (/\blast\s+month\b/.test(lower)) {
|
|
63
|
+
const d = new Date(); d.setMonth(d.getMonth() - 1);
|
|
64
|
+
return { year: d.getFullYear(), month: d.getMonth(), ordering };
|
|
65
|
+
}
|
|
66
|
+
|
|
67
|
+
if (ordering) return { ordering };
|
|
68
|
+
return null;
|
|
69
|
+
}
|
|
70
|
+
|
|
71
|
+
/**
|
|
72
|
+
* Score candidates by temporal proximity to the query's time reference.
|
|
73
|
+
* Mutates candidates in place, setting their `temporalScore`.
|
|
74
|
+
*/
|
|
75
|
+
export function scoreTemporalRelevance(candidates: Candidate[], timeRef: TimeReference): void {
|
|
76
|
+
// For ordering queries ("which first/last"), score by eventDate order
|
|
77
|
+
if (timeRef.ordering && !timeRef.month && !timeRef.day && !timeRef.year) {
|
|
78
|
+
const withDates = candidates.filter(c => c.fact.eventDate != null);
|
|
79
|
+
if (withDates.length === 0) return;
|
|
80
|
+
withDates.sort((a, b) => {
|
|
81
|
+
const aDate = new Date(a.fact.eventDate!).getTime();
|
|
82
|
+
const bDate = new Date(b.fact.eventDate!).getTime();
|
|
83
|
+
return timeRef.ordering === 'first' ? aDate - bDate : bDate - aDate;
|
|
84
|
+
});
|
|
85
|
+
for (let i = 0; i < withDates.length; i++) {
|
|
86
|
+
withDates[i]!.temporalScore = 1.0 - (i / withDates.length);
|
|
87
|
+
}
|
|
88
|
+
return;
|
|
89
|
+
}
|
|
90
|
+
|
|
91
|
+
// For date-proximity queries, score by distance to reference date
|
|
92
|
+
const now = new Date();
|
|
93
|
+
const refDate = new Date(timeRef.year ?? now.getFullYear(), timeRef.month ?? 0, timeRef.day ?? 15);
|
|
94
|
+
const refTime = refDate.getTime();
|
|
95
|
+
|
|
96
|
+
let maxDistance = 0;
|
|
97
|
+
for (const c of candidates) {
|
|
98
|
+
const eventDate = c.fact.eventDate ?? c.fact.documentDate;
|
|
99
|
+
if (!eventDate) continue;
|
|
100
|
+
const dist = Math.abs(new Date(eventDate).getTime() - refTime);
|
|
101
|
+
if (dist > maxDistance) maxDistance = dist;
|
|
102
|
+
}
|
|
103
|
+
if (maxDistance === 0) return;
|
|
104
|
+
|
|
105
|
+
for (const c of candidates) {
|
|
106
|
+
const eventDate = c.fact.eventDate ?? c.fact.documentDate;
|
|
107
|
+
if (!eventDate) { c.temporalScore = 0; continue; }
|
|
108
|
+
const dist = Math.abs(new Date(eventDate).getTime() - refTime);
|
|
109
|
+
c.temporalScore = 1.0 - (dist / maxDistance);
|
|
110
|
+
}
|
|
111
|
+
}
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
import type { StorageAdapter } from '../adapters/storage.js';
|
|
2
|
+
import type { EmbeddingAdapter } from '../adapters/embedding.js';
|
|
3
|
+
import type { Candidate } from './types.js';
|
|
4
|
+
import type { TriggerCondition } from '../models/trigger.js';
|
|
5
|
+
export declare function matchTriggers(storage: StorageAdapter, embedding: EmbeddingAdapter, query: string, tenantId: string, scope: string, scopeId: string): Promise<{
|
|
6
|
+
candidates: Candidate[];
|
|
7
|
+
triggersMatched: string[];
|
|
8
|
+
}>;
|
|
9
|
+
/** Evaluate a trigger condition against query text */
|
|
10
|
+
export declare function evaluateCondition(condition: TriggerCondition, query: string, context: {
|
|
11
|
+
storage: StorageAdapter;
|
|
12
|
+
embedding: EmbeddingAdapter;
|
|
13
|
+
tenantId: string;
|
|
14
|
+
scope: string;
|
|
15
|
+
scopeId: string;
|
|
16
|
+
}): Promise<boolean>;
|
|
17
|
+
export declare function cosineSimilarity(a: number[], b: number[]): number;
|
|
18
|
+
//# sourceMappingURL=trigger-matcher.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"trigger-matcher.d.ts","sourceRoot":"","sources":["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,CA8EjE;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"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"trigger-matcher.js","sourceRoot":"","sources":["trigger-matcher.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,180 @@
|
|
|
1
|
+
import type { StorageAdapter } from '../adapters/storage.js';
|
|
2
|
+
import type { EmbeddingAdapter } from '../adapters/embedding.js';
|
|
3
|
+
import type { Candidate } from './types.js';
|
|
4
|
+
import type { TriggerCondition } from '../models/trigger.js';
|
|
5
|
+
import { vectorSearch } from './vector-search.js';
|
|
6
|
+
|
|
7
|
+
export async function matchTriggers(
|
|
8
|
+
storage: StorageAdapter,
|
|
9
|
+
embedding: EmbeddingAdapter,
|
|
10
|
+
query: string,
|
|
11
|
+
tenantId: string,
|
|
12
|
+
scope: string,
|
|
13
|
+
scopeId: string,
|
|
14
|
+
): Promise<{ candidates: Candidate[]; triggersMatched: string[] }> {
|
|
15
|
+
// 1. Get active triggers, sorted by priority descending
|
|
16
|
+
const triggers = await storage.getActiveTriggers(tenantId, scope, scopeId);
|
|
17
|
+
// triggers should already be sorted by priority DESC from storage
|
|
18
|
+
|
|
19
|
+
const candidates: Candidate[] = [];
|
|
20
|
+
const triggersMatched: string[] = [];
|
|
21
|
+
|
|
22
|
+
// 2. Evaluate each trigger
|
|
23
|
+
for (const trigger of triggers) {
|
|
24
|
+
const matches = await evaluateCondition(trigger.condition, query, {
|
|
25
|
+
storage,
|
|
26
|
+
embedding,
|
|
27
|
+
tenantId,
|
|
28
|
+
scope,
|
|
29
|
+
scopeId,
|
|
30
|
+
});
|
|
31
|
+
|
|
32
|
+
if (matches) {
|
|
33
|
+
triggersMatched.push(trigger.id);
|
|
34
|
+
|
|
35
|
+
// Surface facts from factIds (batch fetch)
|
|
36
|
+
if (trigger.factIds && trigger.factIds.length > 0) {
|
|
37
|
+
const facts = await storage.getFactsByIds(tenantId, trigger.factIds);
|
|
38
|
+
for (const fact of facts) {
|
|
39
|
+
if (fact.validUntil === null) {
|
|
40
|
+
candidates.push({
|
|
41
|
+
fact,
|
|
42
|
+
vectorScore: 0,
|
|
43
|
+
keywordScore: 0,
|
|
44
|
+
graphScore: 0,
|
|
45
|
+
recencyScore: 0,
|
|
46
|
+
salienceScore: 0,
|
|
47
|
+
temporalScore: 0,
|
|
48
|
+
source: 'trigger',
|
|
49
|
+
triggeredBy: trigger.id,
|
|
50
|
+
});
|
|
51
|
+
}
|
|
52
|
+
}
|
|
53
|
+
}
|
|
54
|
+
|
|
55
|
+
// Surface facts for entityIds
|
|
56
|
+
if (trigger.entityIds && trigger.entityIds.length > 0) {
|
|
57
|
+
for (const entityId of trigger.entityIds) {
|
|
58
|
+
const result = await storage.getFactsForEntity(tenantId, entityId, { limit: 10 });
|
|
59
|
+
for (const fact of result.data) {
|
|
60
|
+
if (fact.validUntil === null) {
|
|
61
|
+
candidates.push({
|
|
62
|
+
fact,
|
|
63
|
+
vectorScore: 0,
|
|
64
|
+
keywordScore: 0,
|
|
65
|
+
graphScore: 0,
|
|
66
|
+
recencyScore: 0,
|
|
67
|
+
salienceScore: 0,
|
|
68
|
+
temporalScore: 0,
|
|
69
|
+
source: 'trigger',
|
|
70
|
+
triggeredBy: trigger.id,
|
|
71
|
+
});
|
|
72
|
+
}
|
|
73
|
+
}
|
|
74
|
+
}
|
|
75
|
+
}
|
|
76
|
+
|
|
77
|
+
// Handle queryTemplate — run a vector sub-search with the template
|
|
78
|
+
if (trigger.queryTemplate) {
|
|
79
|
+
const templateResults = await vectorSearch(
|
|
80
|
+
storage, embedding, trigger.queryTemplate,
|
|
81
|
+
tenantId, scope, scopeId, 5
|
|
82
|
+
);
|
|
83
|
+
for (const c of templateResults) {
|
|
84
|
+
candidates.push({ ...c, source: 'trigger' as const, triggeredBy: trigger.id });
|
|
85
|
+
}
|
|
86
|
+
}
|
|
87
|
+
|
|
88
|
+
// Increment trigger fire count (fire and forget)
|
|
89
|
+
void storage.incrementTriggerFired(tenantId, trigger.id).catch(() => {});
|
|
90
|
+
}
|
|
91
|
+
}
|
|
92
|
+
|
|
93
|
+
return { candidates, triggersMatched };
|
|
94
|
+
}
|
|
95
|
+
|
|
96
|
+
/** Evaluate a trigger condition against query text */
|
|
97
|
+
export async function evaluateCondition(
|
|
98
|
+
condition: TriggerCondition,
|
|
99
|
+
query: string,
|
|
100
|
+
context: {
|
|
101
|
+
storage: StorageAdapter;
|
|
102
|
+
embedding: EmbeddingAdapter;
|
|
103
|
+
tenantId: string;
|
|
104
|
+
scope: string;
|
|
105
|
+
scopeId: string;
|
|
106
|
+
},
|
|
107
|
+
): Promise<boolean> {
|
|
108
|
+
const lowerQuery = query.toLowerCase();
|
|
109
|
+
|
|
110
|
+
// AND: all sub-conditions must match (checked first — if present, only AND logic applies)
|
|
111
|
+
if (condition.AND && condition.AND.length > 0) {
|
|
112
|
+
const results = await Promise.all(
|
|
113
|
+
condition.AND.map((sub) => evaluateCondition(sub, query, context)),
|
|
114
|
+
);
|
|
115
|
+
return results.every(Boolean);
|
|
116
|
+
}
|
|
117
|
+
|
|
118
|
+
// OR: any sub-condition must match (checked second — if present, only OR logic applies)
|
|
119
|
+
if (condition.OR && condition.OR.length > 0) {
|
|
120
|
+
const results = await Promise.all(
|
|
121
|
+
condition.OR.map((sub) => evaluateCondition(sub, query, context)),
|
|
122
|
+
);
|
|
123
|
+
return results.some(Boolean);
|
|
124
|
+
}
|
|
125
|
+
|
|
126
|
+
// topic_match: any topic word appears in query
|
|
127
|
+
if (condition.topic_match && condition.topic_match.length > 0) {
|
|
128
|
+
if (condition.topic_match.some((topic) => lowerQuery.includes(topic.toLowerCase()))) {
|
|
129
|
+
return true;
|
|
130
|
+
}
|
|
131
|
+
}
|
|
132
|
+
|
|
133
|
+
// keyword_any: any keyword appears in query
|
|
134
|
+
if (condition.keyword_any && condition.keyword_any.length > 0) {
|
|
135
|
+
if (condition.keyword_any.some((kw) => lowerQuery.includes(kw.toLowerCase()))) {
|
|
136
|
+
return true;
|
|
137
|
+
}
|
|
138
|
+
}
|
|
139
|
+
|
|
140
|
+
// entity_present: check if entities of given type(s) exist for this tenant
|
|
141
|
+
// NOTE: entity_present currently checks tenant-wide, not scope-specific.
|
|
142
|
+
// A scope-filtered version would require joining through fact_entities → facts.
|
|
143
|
+
// This is acceptable for v1 but should be improved when per-scope entity queries are added.
|
|
144
|
+
if (condition.entity_present && condition.entity_present.length > 0) {
|
|
145
|
+
const entities = await context.storage.getEntitiesForTenant(context.tenantId, { limit: 100 });
|
|
146
|
+
const hasMatchingEntity = entities.data.some((e) =>
|
|
147
|
+
condition.entity_present!.some(
|
|
148
|
+
(type) => e.entityType.toLowerCase() === type.toLowerCase(),
|
|
149
|
+
),
|
|
150
|
+
);
|
|
151
|
+
if (hasMatchingEntity) return true;
|
|
152
|
+
}
|
|
153
|
+
|
|
154
|
+
// semantic_similarity: embed both texts and compare
|
|
155
|
+
if (condition.semantic_similarity) {
|
|
156
|
+
const { text, threshold } = condition.semantic_similarity;
|
|
157
|
+
const [queryEmb, condEmb] = await Promise.all([
|
|
158
|
+
context.embedding.embed(query),
|
|
159
|
+
context.embedding.embed(text),
|
|
160
|
+
]);
|
|
161
|
+
const similarity = cosineSimilarity(queryEmb, condEmb);
|
|
162
|
+
if (similarity >= threshold) return true;
|
|
163
|
+
}
|
|
164
|
+
|
|
165
|
+
return false;
|
|
166
|
+
}
|
|
167
|
+
|
|
168
|
+
export function cosineSimilarity(a: number[], b: number[]): number {
|
|
169
|
+
if (a.length !== b.length || a.length === 0) return 0;
|
|
170
|
+
let dot = 0;
|
|
171
|
+
let normA = 0;
|
|
172
|
+
let normB = 0;
|
|
173
|
+
for (let i = 0; i < a.length; i++) {
|
|
174
|
+
dot += a[i]! * b[i]!;
|
|
175
|
+
normA += a[i]! * a[i]!;
|
|
176
|
+
normB += b[i]! * b[i]!;
|
|
177
|
+
}
|
|
178
|
+
const denom = Math.sqrt(normA) * Math.sqrt(normB);
|
|
179
|
+
return denom === 0 ? 0 : dot / denom;
|
|
180
|
+
}
|
|
@@ -0,0 +1,66 @@
|
|
|
1
|
+
import type { Fact, Entity, Edge } from '../models/index.js';
|
|
2
|
+
/** Options for the main search function */
|
|
3
|
+
export interface SearchOptions {
|
|
4
|
+
query: string;
|
|
5
|
+
tenantId: string;
|
|
6
|
+
scope: string;
|
|
7
|
+
scopeId: string;
|
|
8
|
+
limit?: number;
|
|
9
|
+
includeGraph?: boolean;
|
|
10
|
+
includeHistory?: boolean;
|
|
11
|
+
temporalFilter?: {
|
|
12
|
+
asOf?: Date;
|
|
13
|
+
};
|
|
14
|
+
weights?: FusionWeights;
|
|
15
|
+
}
|
|
16
|
+
/** Configurable fusion weights (should sum to 1.0 — normalized if not) */
|
|
17
|
+
export interface FusionWeights {
|
|
18
|
+
vector: number;
|
|
19
|
+
keyword: number;
|
|
20
|
+
graph: number;
|
|
21
|
+
recency: number;
|
|
22
|
+
salience: number;
|
|
23
|
+
}
|
|
24
|
+
/** A single search result with all signal scores */
|
|
25
|
+
export interface SearchResult {
|
|
26
|
+
fact: Fact;
|
|
27
|
+
score: number;
|
|
28
|
+
signals: {
|
|
29
|
+
vectorScore: number;
|
|
30
|
+
keywordScore: number;
|
|
31
|
+
graphScore: number;
|
|
32
|
+
recencyScore: number;
|
|
33
|
+
salienceScore: number;
|
|
34
|
+
};
|
|
35
|
+
triggeredBy?: string;
|
|
36
|
+
contradiction?: {
|
|
37
|
+
contradicts: Fact;
|
|
38
|
+
status: string;
|
|
39
|
+
timeline: string;
|
|
40
|
+
};
|
|
41
|
+
graph?: {
|
|
42
|
+
entities: Entity[];
|
|
43
|
+
edges: Edge[];
|
|
44
|
+
};
|
|
45
|
+
history?: Fact[];
|
|
46
|
+
}
|
|
47
|
+
/** Full search response */
|
|
48
|
+
export interface SearchResponse {
|
|
49
|
+
results: SearchResult[];
|
|
50
|
+
triggersMatched: string[];
|
|
51
|
+
totalCandidates: number;
|
|
52
|
+
durationMs: number;
|
|
53
|
+
}
|
|
54
|
+
/** Internal: candidate fact before fusion scoring */
|
|
55
|
+
export interface Candidate {
|
|
56
|
+
fact: Fact;
|
|
57
|
+
vectorScore: number;
|
|
58
|
+
keywordScore: number;
|
|
59
|
+
graphScore: number;
|
|
60
|
+
recencyScore: number;
|
|
61
|
+
salienceScore: number;
|
|
62
|
+
source: 'vector' | 'keyword' | 'graph' | 'trigger';
|
|
63
|
+
triggeredBy?: string;
|
|
64
|
+
}
|
|
65
|
+
export declare const DEFAULT_FUSION_WEIGHTS: FusionWeights;
|
|
66
|
+
//# sourceMappingURL=types.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["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;CACzB;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;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;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,MAAM,EAAE,QAAQ,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,CAAC;IACnD,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,eAAO,MAAM,sBAAsB,EAAE,aAMpC,CAAC"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"types.js","sourceRoot":"","sources":["types.ts"],"names":[],"mappings":"AAsEA,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;CACf,CAAC"}
|
|
@@ -0,0 +1,82 @@
|
|
|
1
|
+
import type { Fact, Entity, Edge } from '../models/index.js';
|
|
2
|
+
|
|
3
|
+
/** Options for the main search function */
|
|
4
|
+
export interface SearchOptions {
|
|
5
|
+
query: string;
|
|
6
|
+
tenantId: string;
|
|
7
|
+
scope: string;
|
|
8
|
+
scopeId: string;
|
|
9
|
+
limit?: number; // default 10, max 100
|
|
10
|
+
includeGraph?: boolean; // include related entities/edges in results
|
|
11
|
+
includeHistory?: boolean; // include previous fact versions in results
|
|
12
|
+
temporalFilter?: {
|
|
13
|
+
asOf?: Date; // point-in-time query ("what did we know on this date?")
|
|
14
|
+
};
|
|
15
|
+
weights?: FusionWeights; // override default fusion weights
|
|
16
|
+
tokenBudget?: number; // max estimated tokens for results (rough: chars/4). Trims lowest-scored results to fit.
|
|
17
|
+
}
|
|
18
|
+
|
|
19
|
+
/** Configurable fusion weights (should sum to 1.0 — normalized if not) */
|
|
20
|
+
export interface FusionWeights {
|
|
21
|
+
vector: number; // default 0.30
|
|
22
|
+
keyword: number; // default 0.15
|
|
23
|
+
graph: number; // default 0.15
|
|
24
|
+
recency: number; // default 0.10
|
|
25
|
+
salience: number; // default 0.10
|
|
26
|
+
temporal: number; // default 0.20
|
|
27
|
+
}
|
|
28
|
+
|
|
29
|
+
/** A single search result with all signal scores */
|
|
30
|
+
export interface SearchResult {
|
|
31
|
+
fact: Fact;
|
|
32
|
+
score: number; // final fused score (0-1)
|
|
33
|
+
signals: {
|
|
34
|
+
vectorScore: number;
|
|
35
|
+
keywordScore: number;
|
|
36
|
+
graphScore: number;
|
|
37
|
+
recencyScore: number;
|
|
38
|
+
salienceScore: number;
|
|
39
|
+
temporalScore: number;
|
|
40
|
+
};
|
|
41
|
+
triggeredBy?: string; // trigger ID if surfaced by anticipatory retrieval
|
|
42
|
+
contradiction?: {
|
|
43
|
+
contradicts: Fact;
|
|
44
|
+
status: string;
|
|
45
|
+
timeline: string; // human-readable description e.g. "Opinion changed over ~2 months"
|
|
46
|
+
};
|
|
47
|
+
graph?: {
|
|
48
|
+
entities: Entity[];
|
|
49
|
+
edges: Edge[];
|
|
50
|
+
};
|
|
51
|
+
history?: Fact[]; // previous versions of this fact (ordered by version)
|
|
52
|
+
}
|
|
53
|
+
|
|
54
|
+
/** Full search response */
|
|
55
|
+
export interface SearchResponse {
|
|
56
|
+
results: SearchResult[];
|
|
57
|
+
triggersMatched: string[]; // IDs of triggers that fired
|
|
58
|
+
totalCandidates: number; // total candidates before fusion/limit
|
|
59
|
+
durationMs: number;
|
|
60
|
+
}
|
|
61
|
+
|
|
62
|
+
/** Internal: candidate fact before fusion scoring */
|
|
63
|
+
export interface Candidate {
|
|
64
|
+
fact: Fact;
|
|
65
|
+
vectorScore: number; // 0 if not from vector search
|
|
66
|
+
keywordScore: number; // 0 if not from keyword search
|
|
67
|
+
graphScore: number; // 0 if not from graph traversal
|
|
68
|
+
recencyScore: number; // filled in by salience scorer
|
|
69
|
+
salienceScore: number; // filled in by salience scorer
|
|
70
|
+
temporalScore: number; // filled in by temporal scorer
|
|
71
|
+
source: 'vector' | 'keyword' | 'graph' | 'trigger';
|
|
72
|
+
triggeredBy?: string; // trigger ID if from trigger matcher
|
|
73
|
+
}
|
|
74
|
+
|
|
75
|
+
export const DEFAULT_FUSION_WEIGHTS: FusionWeights = {
|
|
76
|
+
vector: 0.30,
|
|
77
|
+
keyword: 0.15,
|
|
78
|
+
graph: 0.15,
|
|
79
|
+
recency: 0.10,
|
|
80
|
+
salience: 0.10,
|
|
81
|
+
temporal: 0.20,
|
|
82
|
+
};
|
|
@@ -0,0 +1,5 @@
|
|
|
1
|
+
import type { StorageAdapter } from '../adapters/storage.js';
|
|
2
|
+
import type { EmbeddingAdapter } from '../adapters/embedding.js';
|
|
3
|
+
import type { Candidate } from './types.js';
|
|
4
|
+
export declare function vectorSearch(storage: StorageAdapter, embedding: EmbeddingAdapter, query: string, tenantId: string, scope: string, scopeId: string, limit: number, asOf?: Date): Promise<Candidate[]>;
|
|
5
|
+
//# sourceMappingURL=vector-search.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"vector-search.d.ts","sourceRoot":"","sources":["vector-search.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;AAE5C,wBAAsB,YAAY,CAChC,OAAO,EAAE,cAAc,EACvB,SAAS,EAAE,gBAAgB,EAC3B,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,IAAI,CAAC,EAAE,IAAI,GACV,OAAO,CAAC,SAAS,EAAE,CAAC,CAuBtB"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"vector-search.js","sourceRoot":"","sources":["vector-search.ts"],"names":[],"mappings":"AAIA,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,OAAuB,EACvB,SAA2B,EAC3B,KAAa,EACb,QAAgB,EAChB,KAAa,EACb,OAAe,EACf,KAAa,EACb,IAAW;IAEX,MAAM,cAAc,GAAG,MAAM,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAEpD,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,YAAY,CAAC;QACzC,SAAS,EAAE,cAAc;QACzB,QAAQ;QACR,KAAK;QACL,OAAO;QACP,KAAK;QACL,aAAa,EAAE,GAAG;QAClB,SAAS,EAAE,IAAI;QACf,IAAI;KACL,CAAC,CAAC;IAEH,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACzB,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,WAAW,EAAE,CAAC,CAAC,UAAU;QACzB,YAAY,EAAE,CAAC;QACf,UAAU,EAAE,CAAC;QACb,YAAY,EAAE,CAAC;QACf,aAAa,EAAE,CAAC;QAChB,MAAM,EAAE,QAAiB;KAC1B,CAAC,CAAC,CAAC;AACN,CAAC"}
|
|
@@ -0,0 +1,38 @@
|
|
|
1
|
+
import type { StorageAdapter } from '../adapters/storage.js';
|
|
2
|
+
import type { EmbeddingAdapter } from '../adapters/embedding.js';
|
|
3
|
+
import type { Candidate } from './types.js';
|
|
4
|
+
|
|
5
|
+
export async function vectorSearch(
|
|
6
|
+
storage: StorageAdapter,
|
|
7
|
+
embedding: EmbeddingAdapter,
|
|
8
|
+
query: string,
|
|
9
|
+
tenantId: string,
|
|
10
|
+
scope: string,
|
|
11
|
+
scopeId: string,
|
|
12
|
+
limit: number,
|
|
13
|
+
asOf?: Date,
|
|
14
|
+
): Promise<Candidate[]> {
|
|
15
|
+
const queryEmbedding = await embedding.embed(query);
|
|
16
|
+
|
|
17
|
+
const results = await storage.vectorSearch({
|
|
18
|
+
embedding: queryEmbedding,
|
|
19
|
+
tenantId,
|
|
20
|
+
scope,
|
|
21
|
+
scopeId,
|
|
22
|
+
limit,
|
|
23
|
+
minSimilarity: 0.0,
|
|
24
|
+
validOnly: true,
|
|
25
|
+
asOf,
|
|
26
|
+
});
|
|
27
|
+
|
|
28
|
+
return results.map((r) => ({
|
|
29
|
+
fact: r.fact,
|
|
30
|
+
vectorScore: r.similarity,
|
|
31
|
+
keywordScore: 0,
|
|
32
|
+
graphScore: 0,
|
|
33
|
+
recencyScore: 0,
|
|
34
|
+
salienceScore: 0,
|
|
35
|
+
temporalScore: 0,
|
|
36
|
+
source: 'vector' as const,
|
|
37
|
+
}));
|
|
38
|
+
}
|
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
export interface DecayInput {
|
|
2
|
+
importance: number;
|
|
3
|
+
frequency: number;
|
|
4
|
+
lastAccessed: Date | null;
|
|
5
|
+
halfLifeDays: number;
|
|
6
|
+
normalizationK: number;
|
|
7
|
+
}
|
|
8
|
+
export declare function calculateDecayScore(input: DecayInput): number;
|
|
9
|
+
//# sourceMappingURL=decay.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"decay.d.ts","sourceRoot":"","sources":["decay.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,IAAI,GAAG,IAAI,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAgB7D"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"decay.js","sourceRoot":"","sources":["decay.ts"],"names":[],"mappings":"AAQA,MAAM,UAAU,mBAAmB,CAAC,KAAiB;IACnD,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,GAAG,KAAK,CAAC;IAEpF,IAAI,YAAY,KAAK,IAAI;QAAE,OAAO,CAAC,CAAC;IAEpC,sEAAsE;IACtE,MAAM,eAAe,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,YAAY,CAAC,OAAO,EAAE,CAAC,GAAG,CAAC,IAAI,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC;IACtF,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,GAAG,YAAY,CAAC;IACvC,MAAM,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,GAAG,eAAe,CAAC,CAAC;IAE1D,4EAA4E;IAC5E,MAAM,eAAe,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,SAAS,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC;IAE9F,iCAAiC;IACjC,MAAM,KAAK,GAAG,UAAU,GAAG,aAAa,GAAG,eAAe,CAAC;IAC3D,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;AACzC,CAAC"}
|
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
export interface DecayInput {
|
|
2
|
+
importance: number; // 0-1
|
|
3
|
+
frequency: number; // access count
|
|
4
|
+
lastAccessed: Date | null;
|
|
5
|
+
halfLifeDays: number; // configurable, default 30
|
|
6
|
+
normalizationK: number; // configurable, default 50
|
|
7
|
+
}
|
|
8
|
+
|
|
9
|
+
export function calculateDecayScore(input: DecayInput): number {
|
|
10
|
+
const { importance, frequency, lastAccessed, halfLifeDays, normalizationK } = input;
|
|
11
|
+
|
|
12
|
+
if (lastAccessed === null) return 0;
|
|
13
|
+
|
|
14
|
+
// Recency factor: exponential decay using Ebbinghaus forgetting curve
|
|
15
|
+
const daysSinceAccess = (Date.now() - lastAccessed.getTime()) / (1000 * 60 * 60 * 24);
|
|
16
|
+
const lambda = Math.LN2 / halfLifeDays;
|
|
17
|
+
const recencyFactor = Math.exp(-lambda * daysSinceAccess);
|
|
18
|
+
|
|
19
|
+
// Frequency factor: logarithmic scaling with fixed normalization constant K
|
|
20
|
+
const frequencyFactor = Math.min(1.0, Math.log(1 + frequency) / Math.log(1 + normalizationK));
|
|
21
|
+
|
|
22
|
+
// Final score: clamped to [0, 1]
|
|
23
|
+
const score = importance * recencyFactor * frequencyFactor;
|
|
24
|
+
return Math.max(0, Math.min(1, score));
|
|
25
|
+
}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export { calculateDecayScore, type DecayInput } from './decay.js';
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export { getScratchpad, updateScratchpad, getRelevantScratchpad } from './scratchpad.js';
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
import type { StorageAdapter } from '../adapters/storage.js';
|
|
2
|
+
import type { LLMAdapter } from '../adapters/llm.js';
|
|
3
|
+
import type { Scope } from '../config.js';
|
|
4
|
+
/**
|
|
5
|
+
* Get or create a scratchpad for a scope.
|
|
6
|
+
* The scratchpad is stored as a special fact with tag 'scratchpad'.
|
|
7
|
+
*/
|
|
8
|
+
export declare function getScratchpad(storage: StorageAdapter, tenantId: string, scope: Scope, scopeId: string): Promise<string>;
|
|
9
|
+
/**
|
|
10
|
+
* Update the scratchpad after an extraction.
|
|
11
|
+
* Appends new facts to the existing scratchpad, compresses if too long.
|
|
12
|
+
*/
|
|
13
|
+
export declare function updateScratchpad(storage: StorageAdapter, llm: LLMAdapter, tenantId: string, scope: Scope, scopeId: string, newFacts: string[]): Promise<void>;
|
|
14
|
+
/**
|
|
15
|
+
* Compress the scratchpad using an LLM.
|
|
16
|
+
* Preserves the most important information while reducing size.
|
|
17
|
+
*/
|
|
18
|
+
export declare function compressScratchpad(llm: LLMAdapter, content: string): Promise<string>;
|
|
19
|
+
/**
|
|
20
|
+
* Get filtered scratchpad content relevant to a query.
|
|
21
|
+
*/
|
|
22
|
+
export declare function getRelevantScratchpad(storage: StorageAdapter, llm: LLMAdapter, tenantId: string, scope: Scope, scopeId: string, query: string): Promise<string>;
|
|
23
|
+
//# sourceMappingURL=scratchpad.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"scratchpad.d.ts","sourceRoot":"","sources":["scratchpad.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAK1C;;;GAGG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,cAAc,EACvB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,CAAC,CAIjB;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,cAAc,EACvB,GAAG,EAAE,UAAU,EACf,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAAE,GACjB,OAAO,CAAC,IAAI,CAAC,CA2Cf;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CAAC,GAAG,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAyB1F;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,cAAc,EACvB,GAAG,EAAE,UAAU,EACf,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,MAAM,CAAC,CAoBjB"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"scratchpad.js","sourceRoot":"","sources":["scratchpad.ts"],"names":[],"mappings":"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"}
|