@steno-ai/engine 0.1.14 → 0.1.16

package/src/identity/resolver.ts

@@ -0,0 +1,149 @@
+export interface IdentityCandidate {
+  id: string;
+  canonicalName: string;
+  entityType: string;
+  properties: Record<string, unknown>;
+}
+
+export interface AliasCandidate {
+  primaryEntityId: string;
+  aliasEntityId: string;
+  confidence: number;
+  matchReason: 'email_match' | 'fuzzy_name' | 'temporal_cooccurrence' | 'manual';
+}
+
+/**
+ * Jaro-Winkler similarity algorithm.
+ * Returns a value between 0 (no similarity) and 1 (identical).
+ */
+export function jaroWinkler(s1: string, s2: string): number {
+  if (s1 === s2) return 1.0;
+  if (s1.length === 0 || s2.length === 0) return 0.0;
+
+  const matchDistance = Math.floor(Math.max(s1.length, s2.length) / 2) - 1;
+
+  const s1Matches = new Array(s1.length).fill(false);
+  const s2Matches = new Array(s2.length).fill(false);
+
+  let matches = 0;
+  let transpositions = 0;
+
+  // Find matching characters
+  for (let i = 0; i < s1.length; i++) {
+    const start = Math.max(0, i - matchDistance);
+    const end = Math.min(i + matchDistance + 1, s2.length);
+
+    for (let j = start; j < end; j++) {
+      if (s2Matches[j] || s1[i] !== s2[j]) continue;
+      s1Matches[i] = true;
+      s2Matches[j] = true;
+      matches++;
+      break;
+    }
+  }
+
+  if (matches === 0) return 0.0;
+
+  // Count transpositions
+  let k = 0;
+  for (let i = 0; i < s1.length; i++) {
+    if (!s1Matches[i]) continue;
+    while (!s2Matches[k]) k++;
+    if (s1[i] !== s2[k]) transpositions++;
+    k++;
+  }
+
+  const jaro =
+    (matches / s1.length + matches / s2.length + (matches - transpositions / 2) / matches) / 3;
+
+  // Winkler prefix bonus (up to 4 common prefix chars)
+  let prefix = 0;
+  for (let i = 0; i < Math.min(4, Math.min(s1.length, s2.length)); i++) {
+    if (s1[i] === s2[i]) prefix++;
+    else break;
+  }
+
+  return jaro + prefix * 0.1 * (1 - jaro);
+}
+
+/**
+ * Normalize a name for fuzzy comparison:
+ * lowercase and strip separators (. _ - @).
+ */
+export function normalizeName(name: string): string {
+  return name.toLowerCase().replace(/[._\-@]/g, '');
+}
+
+/**
+ * Resolve identities across a list of entity candidates using a three-tier strategy:
+ *  1. Exact email match (confidence 1.0)
+ *  2. Fuzzy canonical name match via Jaro-Winkler (confidence 0.6–0.8)
+ *
+ * Returns alias pairs without duplicates.
+ */
+export function resolveIdentities(entities: IdentityCandidate[]): AliasCandidate[] {
+  const aliases: AliasCandidate[] = [];
+  const seen = new Set<string>();
+
+  const addAlias = (
+    primaryEntityId: string,
+    aliasEntityId: string,
+    confidence: number,
+    matchReason: AliasCandidate['matchReason'],
+  ): void => {
+    const key = [primaryEntityId, aliasEntityId].sort().join(':');
+    if (seen.has(key)) return;
+    seen.add(key);
+    aliases.push({ primaryEntityId, aliasEntityId, confidence, matchReason });
+  };
+
+  // Tier 1: Email match (confidence 1.0)
+  const emailGroups = new Map<string, IdentityCandidate[]>();
+  for (const entity of entities) {
+    const email = entity.properties['email'];
+    if (typeof email !== 'string' || email.trim() === '') continue;
+    const normalizedEmail = email.toLowerCase();
+    const group = emailGroups.get(normalizedEmail) ?? [];
+    group.push(entity);
+    emailGroups.set(normalizedEmail, group);
+  }
+
+  for (const group of emailGroups.values()) {
+    if (group.length < 2) continue;
+    const primary = group[0]!;
+    for (let i = 1; i < group.length; i++) {
+      addAlias(primary.id, group[i]!.id, 1.0, 'email_match');
+    }
+  }
+
+  // Tier 2: Fuzzy name match (confidence 0.6–0.8)
+  // Threshold: Jaro-Winkler >= 0.85, same entity type required
+  const JARO_WINKLER_THRESHOLD = 0.85;
+
+  for (let i = 0; i < entities.length; i++) {
+    for (let j = i + 1; j < entities.length; j++) {
+      const a = entities[i]!;
+      const b = entities[j]!;
+
+      // Must be same entity type
+      if (a.entityType !== b.entityType) continue;
+
+      // Skip if already aliased
+      const key = [a.id, b.id].sort().join(':');
+      if (seen.has(key)) continue;
+
+      const normA = normalizeName(a.canonicalName);
+      const normB = normalizeName(b.canonicalName);
+      const similarity = jaroWinkler(normA, normB);
+
+      if (similarity >= JARO_WINKLER_THRESHOLD) {
+        // Map similarity [0.85, 1.0] → confidence [0.6, 0.8]
+        const confidence = 0.6 + ((similarity - 0.85) / 0.15) * 0.2;
+        const clampedConfidence = Math.min(0.8, Math.max(0.6, confidence));
+        addAlias(a.id, b.id, clampedConfidence, 'fuzzy_name');
+      }
+    }
+  }
+
+  return aliases;
+}

package/src/index.ts

@@ -10,3 +10,4 @@ export * from './sessions/index.js';
 export * from './feedback/index.js';
 export * from './profiles/index.js';
 export * from './scratchpad/index.js';
+export * from './identity/index.js';

package/src/models/entity.ts

@@ -16,6 +16,19 @@ export const EntitySchema = z.object({
 
 export type Entity = z.infer<typeof EntitySchema>;
 
+export const AliasSchema = z.object({
+  id: z.string().uuid(),
+  tenantId: z.string().uuid(),
+  primaryEntityId: z.string().uuid(),
+  aliasEntityId: z.string().uuid(),
+  confidence: z.number().min(0).max(1),
+  matchReason: z.enum(['email_match', 'fuzzy_name', 'temporal_cooccurrence', 'manual']),
+  confirmedBy: z.string().nullable(),
+  confirmedAt: z.coerce.date().nullable(),
+  createdAt: z.coerce.date(),
+});
+export type Alias = z.infer<typeof AliasSchema>;
+
 export const CreateEntitySchema = z.object({
   tenantId: z.string().uuid(),
   name: z.string().min(1).max(500),

package/src/retrieval/graph-traversal.ts

@@ -41,14 +41,17 @@ export function tokenizeQuery(query: string): string[] {
  *    - 1-hop = 0.5
  *    - 2-hop = 0.25
  *    - 3-hop = 0.125
+ *
+ * Note: Entity lookups are tenant-scoped.
+ * Fact retrieval is scope-filtered to prevent cross-user data leakage.
  */
 export async function graphSearch(
   storage: StorageAdapter,
   embedding: EmbeddingAdapter,
   query: string,
   tenantId: string,
-  _scope: string,
-  _scopeId: string,
+  scope: string,
+  scopeId: string,
   limit: number,
   config?: Partial<GraphSearchConfig>,
 ): Promise<Candidate[]> {
@@ -183,7 +186,7 @@ export async function graphSearch(
     // Single query: get all facts linked to any of these entities
     try {
       const batchResult = await storage.getFactsForEntities(
-        tenantId, entityIds, PER_ENTITY_LIMIT
+        tenantId, entityIds, PER_ENTITY_LIMIT, scope, scopeId
       );
 
       for (const { entityId, fact } of batchResult) {
@@ -214,7 +217,7 @@ export async function graphSearch(
         const hopDepth = entityHopMap.get(entity.id) ?? maxDepth;
         const graphScore = 1 / Math.pow(2, hopDepth);
         try {
-          const factsResult = await storage.getFactsForEntity(tenantId, entity.id, { limit: 3 });
+          const factsResult = await storage.getFactsForEntity(tenantId, entity.id, { limit: 3 }, scope, scopeId);
           for (const fact of factsResult.data) {
             if (!candidateMap.has(fact.id)) {
               candidateMap.set(fact.id, {

package/src/retrieval/search.ts

@@ -55,19 +55,74 @@ export async function search(
   // 1. Run retrieval signals
   const t0 = Date.now();
 
+  // Determine whether to use multi-scope search
+  const useMultiScope = options.scopeIds && options.scopeIds.length > 0;
+
   const tCompound = Date.now();
-  const compoundPromise = compoundSearchSignal(config.storage, effectiveEmbedding, options.query, options.tenantId, options.scope, options.scopeId, limit * fetchMultiplier).catch(() => ({ vectorCandidates: [] as Candidate[], keywordCandidates: [] as Candidate[] }));
+  let compoundPromise: Promise<{ vectorCandidates: Candidate[]; keywordCandidates: Candidate[] }>;
+
+  if (useMultiScope) {
+    // Multi-scope path: run vectorSearchMultiScope + keywordSearchMultiScope in parallel
+    compoundPromise = (async () => {
+      const embedding = await effectiveEmbedding.embed(options.query);
+      const [vectorResults, keywordResults] = await Promise.all([
+        config.storage.vectorSearchMultiScope({
+          embedding,
+          tenantId: options.tenantId,
+          scope: options.scope,
+          scopeIds: options.scopeIds!,
+          limit: limit * fetchMultiplier,
+          asOf: options.temporalFilter?.asOf,
+        }).catch(() => [] as import('../adapters/storage.js').VectorSearchResult[]),
+        config.storage.keywordSearchMultiScope({
+          query: options.query,
+          tenantId: options.tenantId,
+          scope: options.scope,
+          scopeIds: options.scopeIds!,
+          limit: limit * fetchMultiplier,
+          asOf: options.temporalFilter?.asOf,
+        }).catch(() => [] as import('../adapters/storage.js').KeywordSearchResult[]),
+      ]);
+      const vectorCandidates: Candidate[] = vectorResults.map(r => ({
+        fact: r.fact,
+        vectorScore: r.similarity,
+        keywordScore: 0,
+        graphScore: 0,
+        recencyScore: 0,
+        salienceScore: 0,
+        temporalScore: 0,
+        source: 'vector' as const,
+      }));
+      const keywordCandidates: Candidate[] = keywordResults.map(r => ({
+        fact: r.fact,
+        vectorScore: 0,
+        keywordScore: r.rankScore,
+        graphScore: 0,
+        recencyScore: 0,
+        salienceScore: 0,
+        temporalScore: 0,
+        source: 'keyword' as const,
+      }));
+      return { vectorCandidates, keywordCandidates };
+    })().catch(() => ({ vectorCandidates: [] as Candidate[], keywordCandidates: [] as Candidate[] }));
+  } else {
+    // Single-scope path (original behavior)
+    compoundPromise = compoundSearchSignal(config.storage, effectiveEmbedding, options.query, options.tenantId, options.scope, options.scopeId, limit * fetchMultiplier).catch(() => ({ vectorCandidates: [] as Candidate[], keywordCandidates: [] as Candidate[] }));
+  }
 
   let graphPromise: Promise<Candidate[]> | null = null;
   let triggerPromise: Promise<{ candidates: Candidate[]; triggersMatched: string[] }> | null = null;
 
+  // Graph and trigger searches use single scope (scopeId or first of scopeIds)
+  const effectiveScopeId = useMultiScope ? options.scopeIds![0]! : options.scopeId;
+
   if (!isFast) {
     const tGraph = Date.now();
-    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 })
+    graphPromise = graphSearch(config.storage, effectiveEmbedding, options.query, options.tenantId, options.scope, effectiveScopeId, limit * fetchMultiplier, { maxDepth: config.graphMaxDepth, maxEntities: config.graphMaxEntities, asOf: options.temporalFilter?.asOf })
       .then(r => { console.error(`[steno-search] graph: ${Date.now() - tGraph}ms (${Array.isArray(r) ? r.length : 0} candidates)`); return r; })
       .catch(() => [] as Candidate[]);
     const tTrigger = Date.now();
-    triggerPromise = matchTriggers(config.storage, effectiveEmbedding, options.query, options.tenantId, options.scope, options.scopeId)
+    triggerPromise = matchTriggers(config.storage, effectiveEmbedding, options.query, options.tenantId, options.scope, effectiveScopeId)
       .then(r => { console.error(`[steno-search] trigger: ${Date.now() - tTrigger}ms`); return r; })
       .catch(() => ({ candidates: [] as Candidate[], triggersMatched: [] as string[] }));
   }

package/src/retrieval/types.ts

@@ -15,6 +15,7 @@ export interface SearchOptions {
   weights?: FusionWeights;     // override default fusion weights
   tokenBudget?: number;        // max estimated tokens for results (rough: chars/4). Trims lowest-scored results to fit.
   fast?: boolean;              // skip graph traversal + reranking for <300ms latency
+  scopeIds?: string[];         // when present, query across multiple scopeIds instead of a single one
 }
 
 /** Configurable fusion weights (should sum to 1.0 — normalized if not) */

package/src/adapters/cache.d.ts

@@ -1,9 +0,0 @@
-export interface CacheAdapter {
-    get<T>(key: string): Promise<T | null>;
-    set<T>(key: string, value: T, ttlSeconds?: number): Promise<void>;
-    del(key: string): Promise<void>;
-    incr(key: string): Promise<number>;
-    expire(key: string, ttlSeconds: number): Promise<void>;
-    ping(): Promise<boolean>;
-}
-//# sourceMappingURL=cache.d.ts.map

package/src/adapters/cache.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["cache.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IAC3B,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IACvC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClE,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChC,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACnC,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvD,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;CAC1B"}

package/src/adapters/cache.js

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=cache.js.map

package/src/adapters/cache.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"cache.js","sourceRoot":"","sources":["cache.ts"],"names":[],"mappings":""}

package/src/adapters/embedding.d.ts

@@ -1,7 +0,0 @@
-export interface EmbeddingAdapter {
-    embed(text: string): Promise<number[]>;
-    embedBatch(texts: string[]): Promise<number[][]>;
-    readonly model: string;
-    readonly dimensions: number;
-}
-//# sourceMappingURL=embedding.d.ts.map

package/src/adapters/embedding.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"embedding.d.ts","sourceRoot":"","sources":["embedding.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,gBAAgB;IAC/B,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACvC,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IACjD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B"}

package/src/adapters/embedding.js

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=embedding.js.map

package/src/adapters/embedding.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"embedding.js","sourceRoot":"","sources":["embedding.ts"],"names":[],"mappings":""}

package/src/adapters/llm.d.ts

@@ -1,19 +0,0 @@
-export interface LLMMessage {
-    role: 'system' | 'user' | 'assistant';
-    content: string;
-}
-export interface LLMResponse {
-    content: string;
-    tokensInput: number;
-    tokensOutput: number;
-    model: string;
-}
-export interface LLMAdapter {
-    complete(messages: LLMMessage[], options?: {
-        temperature?: number;
-        maxTokens?: number;
-        responseFormat?: 'json';
-    }): Promise<LLMResponse>;
-    readonly model: string;
-}
-//# sourceMappingURL=llm.d.ts.map

package/src/adapters/llm.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"llm.d.ts","sourceRoot":"","sources":["llm.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAC;IACtC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,QAAQ,EAAE,UAAU,EAAE,EAAE,OAAO,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,cAAc,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IACxI,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB"}

package/src/adapters/llm.js

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=llm.js.map

package/src/adapters/llm.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"llm.js","sourceRoot":"","sources":["llm.ts"],"names":[],"mappings":""}

package/src/adapters/perplexity-embedding.d.ts

@@ -1,24 +0,0 @@
-import type { EmbeddingAdapter } from './embedding.js';
-export interface PerplexityEmbeddingConfig {
-    apiKey: string;
-    model?: string;
-    dimensions?: number;
-}
-/**
- * Perplexity embedding adapter using pplx-embed models.
- * SOTA quality at $0.03/1M tokens for pplx-embed-v1-4b.
- *
- * IMPORTANT: Perplexity returns base64-encoded int8 embeddings by default.
- * These are decoded to float32 and L2-normalized for cosine similarity compatibility
- * with pgvector and other vector DBs.
- */
-export declare class PerplexityEmbeddingAdapter implements EmbeddingAdapter {
-    readonly model: string;
-    readonly dimensions: number;
-    private readonly apiKey;
-    private readonly baseUrl;
-    constructor(config: PerplexityEmbeddingConfig);
-    embed(text: string): Promise<number[]>;
-    embedBatch(texts: string[]): Promise<number[][]>;
-}
-//# sourceMappingURL=perplexity-embedding.d.ts.map

package/src/adapters/perplexity-embedding.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"perplexity-embedding.d.ts","sourceRoot":"","sources":["perplexity-embedding.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAEvD,MAAM,WAAW,yBAAyB;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;GAOG;AACH,qBAAa,0BAA2B,YAAW,gBAAgB;IACjE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA6C;gBAEzD,MAAM,EAAE,yBAAyB;IAMvC,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAKtC,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;CA+BvD"}

package/src/adapters/perplexity-embedding.js

@@ -1,78 +0,0 @@
-/**
- * Perplexity embedding adapter using pplx-embed models.
- * SOTA quality at $0.03/1M tokens for pplx-embed-v1-4b.
- *
- * IMPORTANT: Perplexity returns base64-encoded int8 embeddings by default.
- * These are decoded to float32 and L2-normalized for cosine similarity compatibility
- * with pgvector and other vector DBs.
- */
-export class PerplexityEmbeddingAdapter {
-    model;
-    dimensions;
-    apiKey;
-    baseUrl = 'https://api.perplexity.ai/v1/embeddings';
-    constructor(config) {
-        this.apiKey = config.apiKey;
-        this.model = config.model ?? 'pplx-embed-v1-4b';
-        this.dimensions = config.dimensions ?? 2000;
-    }
-    async embed(text) {
-        const results = await this.embedBatch([text]);
-        return results[0];
-    }
-    async embedBatch(texts) {
-        if (texts.length === 0)
-            return [];
-        const response = await fetch(this.baseUrl, {
-            method: 'POST',
-            headers: {
-                'Authorization': `Bearer ${this.apiKey}`,
-                'Content-Type': 'application/json',
-            },
-            body: JSON.stringify({
-                input: texts,
-                model: this.model,
-                ...(this.dimensions !== 2560 ? { dimensions: this.dimensions } : {}),
-            }),
-        });
-        if (!response.ok) {
-            const error = await response.text();
-            throw new Error(`Perplexity embedding failed (${response.status}): ${error}`);
-        }
-        const data = await response.json();
-        // Sort by index to ensure correct order
-        const sorted = data.data.sort((a, b) => a.index - b.index);
-        // Decode base64 int8 → float32 → L2-normalize
-        return sorted.map(d => decodeAndNormalize(d.embedding));
-    }
-}
-/**
- * Decode a base64-encoded int8 embedding to a normalized float32 array.
- * Perplexity embeddings are unnormalized int8 — we must L2-normalize
- * for cosine similarity to work correctly with pgvector.
- */
-function decodeAndNormalize(b64String) {
-    // Decode base64 using atob (works in both Node.js and browsers)
-    const binaryStr = atob(b64String);
-    const bytes = new Uint8Array(binaryStr.length);
-    for (let i = 0; i < binaryStr.length; i++) {
-        bytes[i] = binaryStr.charCodeAt(i);
-    }
-    const int8 = new Int8Array(bytes.buffer);
-    const float32 = new Array(int8.length);
-    // Convert int8 to float32 and compute norm
-    let norm = 0;
-    for (let i = 0; i < int8.length; i++) {
-        float32[i] = int8[i];
-        norm += float32[i] * float32[i];
-    }
-    // L2-normalize so cosine similarity == inner product in pgvector
-    norm = Math.sqrt(norm);
-    if (norm > 0) {
-        for (let i = 0; i < float32.length; i++) {
-            float32[i] = float32[i] / norm;
-        }
-    }
-    return float32;
-}
-//# sourceMappingURL=perplexity-embedding.js.map

package/src/adapters/perplexity-embedding.js.map

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

package/src/adapters/storage.d.ts

@@ -1,173 +0,0 @@
-import type { Fact, CreateFact, Entity, CreateEntity, Edge, CreateEdge, Trigger, CreateTrigger, MemoryAccess, CreateMemoryAccess, Extraction, CreateExtraction, Session, CreateSession, Tenant, CreateTenant, ApiKey, CreateApiKey, UsageRecord, Webhook, CreateWebhook } from '../models/index.js';
-export interface PaginationOptions {
-    limit: number;
-    cursor?: string;
-}
-export interface PaginatedResult<T> {
-    data: T[];
-    cursor: string | null;
-    hasMore: boolean;
-}
-export interface VectorSearchOptions {
-    embedding: number[];
-    tenantId: string;
-    scope: string;
-    scopeId: string;
-    limit: number;
-    minSimilarity?: number;
-    validOnly?: boolean;
-    asOf?: Date;
-}
-export interface VectorSearchResult {
-    fact: Fact;
-    similarity: number;
-}
-export interface KeywordSearchOptions {
-    query: string;
-    tenantId: string;
-    scope: string;
-    scopeId: string;
-    limit: number;
-    validOnly?: boolean;
-    asOf?: Date;
-}
-export interface KeywordSearchResult {
-    fact: Fact;
-    rankScore: number;
-}
-export interface CompoundSearchOptions {
-    embedding: number[];
-    query: string;
-    tenantId: string;
-    scope: string;
-    scopeId: string;
-    limit: number;
-    minSimilarity?: number;
-}
-export interface CompoundSearchResult {
-    source: 'vector' | 'keyword';
-    fact: Fact;
-    relevanceScore: number;
-}
-export interface GraphTraversalOptions {
-    tenantId: string;
-    entityIds: string[];
-    maxDepth: number;
-    maxEntities: number;
-    validOnly?: boolean;
-    asOf?: Date;
-}
-export interface GraphTraversalResult {
-    entities: Entity[];
-    edges: Edge[];
-}
-export interface StorageAdapter {
-    createFact(fact: CreateFact & {
-        id: string;
-        lineageId: string;
-        embeddingModel: string;
-        embeddingDim: number;
-        embedding?: number[];
-    }): Promise<Fact>;
-    getFact(tenantId: string, id: string): Promise<Fact | null>;
-    getFactsByIds(tenantId: string, ids: string[]): Promise<Fact[]>;
-    getFactsByLineage(tenantId: string, lineageId: string): Promise<Fact[]>;
-    getFactsByScope(tenantId: string, scope: string, scopeId: string, options: PaginationOptions): Promise<PaginatedResult<Fact>>;
-    invalidateFact(tenantId: string, id: string): Promise<void>;
-    purgeFacts(tenantId: string, scope: string, scopeId: string): Promise<number>;
-    updateDecayScores(tenantId: string, facts: Array<{
-        id: string;
-        decayScore: number;
-        lastAccessed?: Date;
-        frequency?: number;
-        importance?: number;
-    }>): Promise<void>;
-    vectorSearch(options: VectorSearchOptions): Promise<VectorSearchResult[]>;
-    keywordSearch(options: KeywordSearchOptions): Promise<KeywordSearchResult[]>;
-    compoundSearch(options: CompoundSearchOptions): Promise<CompoundSearchResult[]>;
-    createEntity(entity: CreateEntity & {
-        id: string;
-        embedding?: number[];
-        embeddingModel?: string;
-        embeddingDim?: number;
-    }): Promise<Entity>;
-    getEntity(tenantId: string, id: string): Promise<Entity | null>;
-    findEntityByCanonicalName(tenantId: string, canonicalName: string, entityType: string): Promise<Entity | null>;
-    findEntitiesByEmbedding(tenantId: string, embedding: number[], limit: number, minSimilarity?: number): Promise<Array<{
-        entity: Entity;
-        similarity: number;
-    }>>;
-    getEntitiesForTenant(tenantId: string, options: PaginationOptions): Promise<PaginatedResult<Entity>>;
-    linkFactEntity(factId: string, entityId: string, role: string): Promise<void>;
-    getEntitiesForFact(factId: string): Promise<Entity[]>;
-    getFactsForEntity(tenantId: string, entityId: string, options: PaginationOptions): Promise<PaginatedResult<Fact>>;
-    getFactsForEntities(tenantId: string, entityIds: string[], perEntityLimit: number): Promise<Array<{
-        entityId: string;
-        fact: Fact;
-    }>>;
-    createEdge(edge: CreateEdge & {
-        id: string;
-    }): Promise<Edge>;
-    getEdgesForEntity(tenantId: string, entityId: string): Promise<Edge[]>;
-    graphTraversal(options: GraphTraversalOptions): Promise<GraphTraversalResult>;
-    createTrigger(trigger: CreateTrigger & {
-        id: string;
-    }): Promise<Trigger>;
-    getTrigger(tenantId: string, id: string): Promise<Trigger | null>;
-    getActiveTriggers(tenantId: string, scope: string, scopeId: string): Promise<Trigger[]>;
-    updateTrigger(tenantId: string, id: string, updates: Partial<Trigger>): Promise<Trigger>;
-    deleteTrigger(tenantId: string, id: string): Promise<void>;
-    incrementTriggerFired(tenantId: string, id: string): Promise<void>;
-    createMemoryAccess(access: CreateMemoryAccess & {
-        id: string;
-    }): Promise<MemoryAccess>;
-    updateFeedback(tenantId: string, factId: string, feedback: {
-        wasUseful: boolean;
-        feedbackType: string;
-        feedbackDetail?: string;
-        wasCorrected?: boolean;
-    }): Promise<void>;
-    createExtraction(extraction: CreateExtraction & {
-        id: string;
-    }): Promise<Extraction>;
-    getExtraction(tenantId: string, id: string): Promise<Extraction | null>;
-    updateExtraction(tenantId: string, id: string, updates: Partial<Extraction>): Promise<Extraction>;
-    getExtractionByHash(tenantId: string, inputHash: string): Promise<Extraction | null>;
-    deleteExtraction(tenantId: string, id: string): Promise<void>;
-    getExtractionsByTenant(tenantId: string, options: PaginationOptions): Promise<PaginatedResult<Extraction>>;
-    createSession(session: CreateSession & {
-        id: string;
-    }): Promise<Session>;
-    getSession(tenantId: string, id: string): Promise<Session | null>;
-    endSession(tenantId: string, id: string, summary?: string, topics?: string[]): Promise<Session>;
-    getSessionsByScope(tenantId: string, scope: string, scopeId: string, options: PaginationOptions): Promise<PaginatedResult<Session>>;
-    createTenant(tenant: CreateTenant & {
-        id: string;
-    }): Promise<Tenant>;
-    getTenant(id: string): Promise<Tenant | null>;
-    getTenantBySlug(slug: string): Promise<Tenant | null>;
-    updateTenant(id: string, updates: Partial<Tenant>): Promise<Tenant>;
-    createApiKey(apiKey: CreateApiKey & {
-        id: string;
-        keyHash: string;
-        keyPrefix: string;
-    }): Promise<ApiKey>;
-    getApiKeyByPrefix(prefix: string): Promise<ApiKey | null>;
-    getApiKeysForTenant(tenantId: string): Promise<ApiKey[]>;
-    revokeApiKey(tenantId: string, id: string): Promise<void>;
-    updateApiKeyLastUsed(id: string): Promise<void>;
-    incrementUsage(tenantId: string, tokens: number, queries: number, extractions: number, costUsd: number): Promise<void>;
-    getUsage(tenantId: string, periodStart: Date): Promise<UsageRecord | null>;
-    getCurrentUsage(tenantId: string): Promise<UsageRecord | null>;
-    createWebhook(webhook: CreateWebhook & {
-        id: string;
-        secretHash: string;
-        signingKey: string;
-    }): Promise<Webhook>;
-    getWebhook(tenantId: string, id: string): Promise<Webhook | null>;
-    getWebhooksForTenant(tenantId: string): Promise<Webhook[]>;
-    getWebhooksByEvent(tenantId: string, event: string): Promise<Webhook[]>;
-    deleteWebhook(tenantId: string, id: string): Promise<void>;
-    ping(): Promise<boolean>;
-}
-//# sourceMappingURL=storage.d.ts.map