@vinaes/succ 1.3.19

package/dist/lib/db/memories.d.ts

@@ -0,0 +1,174 @@
+import { MemoryType } from './schema.js';
+export interface Memory {
+    id: number;
+    content: string;
+    tags: string[];
+    source: string | null;
+    type?: string | null;
+    quality_score: number | null;
+    quality_factors: Record<string, number> | null;
+    access_count: number;
+    last_accessed: string | null;
+    valid_from: string | null;
+    valid_until: string | null;
+    correction_count: number;
+    is_invariant: boolean;
+    priority_score: number | null;
+    created_at: string;
+}
+export interface MemorySearchResult {
+    id: number;
+    content: string;
+    tags: string[];
+    source: string | null;
+    quality_score: number | null;
+    quality_factors: Record<string, number> | null;
+    access_count: number;
+    last_accessed: string | null;
+    valid_from: string | null;
+    valid_until: string | null;
+    created_at: string;
+    similarity: number;
+}
+export interface SaveMemoryResult {
+    id: number;
+    isDuplicate: boolean;
+    similarity?: number;
+}
+export interface QualityScoreData {
+    score: number;
+    factors: Record<string, number>;
+}
+/**
+ * Check if a similar memory already exists (semantic deduplication)
+ * Returns the existing memory ID if found, null otherwise
+ */
+export declare function findSimilarMemory(embedding: number[], threshold?: number): {
+    id: number;
+    content: string;
+    similarity: number;
+} | null;
+/**
+ * Save a new memory with optional deduplication, type, quality score, auto-linking, and validity period
+ * Returns { id, isDuplicate, similarity?, linksCreated? }
+ */
+export declare function saveMemory(content: string, embedding: number[], tags?: string[], source?: string, options?: {
+    deduplicate?: boolean;
+    type?: MemoryType;
+    autoLink?: boolean;
+    linkThreshold?: number;
+    qualityScore?: QualityScoreData;
+    validFrom?: string | Date;
+    validUntil?: string | Date;
+}): SaveMemoryResult & {
+    linksCreated?: number;
+};
+/**
+ * Search memories by semantic similarity with temporal awareness.
+ * Uses sqlite-vec for fast KNN search when available, falls back to brute-force.
+ */
+export declare function searchMemories(queryEmbedding: number[], limit?: number, threshold?: number, tags?: string[], since?: Date, options?: {
+    includeExpired?: boolean;
+    asOfDate?: Date;
+}): MemorySearchResult[];
+/**
+ * Get recent memories
+ */
+export declare function getRecentMemories(limit?: number): Memory[];
+/**
+ * Delete a memory by ID
+ */
+export declare function deleteMemory(id: number): boolean;
+/**
+ * Soft-invalidate a memory during consolidation.
+ * Sets valid_until = now and records which memory superseded it.
+ * The memory remains in the database for historical queries and rollback.
+ */
+export declare function invalidateMemory(memoryId: number, supersededById: number): boolean;
+/**
+ * Restore a soft-invalidated memory by clearing valid_until and invalidated_by.
+ * Used by the consolidation rollback (undo) feature.
+ */
+export declare function restoreInvalidatedMemory(memoryId: number): boolean;
+/**
+ * Get consolidation history: merged memories and what they superseded.
+ * Returns merge operations with their source originals.
+ */
+export declare function getConsolidationHistory(limit?: number): Array<{
+    mergedMemoryId: number;
+    mergedContent: string;
+    originalIds: number[];
+    mergedAt: string;
+}>;
+/**
+ * Get memory stats including type breakdown
+ */
+export declare function getMemoryStats(): {
+    total_memories: number;
+    active_memories: number;
+    invalidated_memories: number;
+    oldest_memory: string | null;
+    newest_memory: string | null;
+    by_type: Record<string, number>;
+    stale_count: number;
+};
+/**
+ * Delete memories older than a given date
+ */
+export declare function deleteMemoriesOlderThan(date: Date): number;
+/**
+ * Delete memories by tag
+ */
+export declare function deleteMemoriesByTag(tag: string): number;
+/**
+ * Get memory by ID
+ */
+export declare function getMemoryById(id: number): Memory | null;
+/**
+ * Delete memories by IDs (batch operation for retention cleanup).
+ */
+export declare function deleteMemoriesByIds(ids: number[]): number;
+/**
+ * Search memories as they existed at a specific point in time.
+ * Core function for point-in-time queries.
+ */
+export declare function searchMemoriesAsOf(queryEmbedding: number[], asOfDate: Date, limit?: number, threshold?: number): MemorySearchResult[];
+export interface MemoryBatchInput {
+    content: string;
+    embedding: number[];
+    tags: string[];
+    type: MemoryType;
+    source?: string;
+    qualityScore?: QualityScoreData;
+    validFrom?: string | Date;
+    validUntil?: string | Date;
+}
+export interface MemoryBatchResult {
+    saved: number;
+    skipped: number;
+    results: Array<{
+        index: number;
+        isDuplicate: boolean;
+        id?: number;
+        reason: 'duplicate' | 'saved';
+        similarity?: number;
+    }>;
+}
+/**
+ * Save multiple memories in a single transaction with batch duplicate checking.
+ * Optimized for session processing to avoid N+1 query problem.
+ *
+ * Performance: ~95% reduction in DB overhead vs individual saveMemory() calls
+ * - Before: N*2 queries (N duplicate checks + N inserts)
+ * - After: 1 duplicate check + 1 batch insert
+ *
+ * @param memories - Array of memories to save
+ * @param deduplicateThreshold - Similarity threshold for duplicate detection (default 0.92)
+ * @returns Batch save results with per-memory status
+ */
+export declare function saveMemoriesBatch(memories: MemoryBatchInput[], deduplicateThreshold?: number, options?: {
+    autoLink?: boolean;
+    linkThreshold?: number;
+    deduplicate?: boolean;
+}): MemoryBatchResult;
+//# sourceMappingURL=memories.d.ts.map

package/dist/lib/db/memories.d.ts.map

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