@vinaes/succ 1.3.19

package/dist/lib/storage/index.js

@@ -0,0 +1,727 @@
+/**
+ * Storage abstraction layer for succ.
+ *
+ * This module provides a unified async interface for database operations,
+ * routing through the StorageDispatcher to the configured backend:
+ * - SQLite (default) with sqlite-vec for vectors
+ * - PostgreSQL with pgvector for vectors
+ * - Optional Qdrant for vector search (with any SQL backend)
+ *
+ * ALL data functions are async and route through the dispatcher.
+ * Connection/lifecycle functions remain sync re-exports.
+ */
+import { getConfig, getDbPath, getGlobalDbPath } from '../config.js';
+import { getStorageDispatcher } from './dispatcher.js';
+import { ConfigError } from '../errors.js';
+// ===========================================================================
+// Types — canonical abstract types from storage/types.ts
+// ===========================================================================
+export * from './types.js';
+// ===========================================================================
+// Connection — lifecycle only (close/cleanup)
+// NOTE: getDb/getGlobalDb intentionally NOT exported here.
+// All data access must go through the dispatcher.
+// If you need raw SQLite access, import from db/connection.js directly.
+// ===========================================================================
+export { closeDb, closeGlobalDb } from '../db/connection.js';
+// ===========================================================================
+// Dispatcher — lifecycle and info helpers
+// ===========================================================================
+export { getStorageDispatcher, initStorageDispatcher, closeStorageDispatcher, resetStorageDispatcher, getBackendType, getVectorBackendType, isPostgresBackend, isQdrantVectors, getPostgresBackend, getQdrantStore, StorageDispatcher, } from './dispatcher.js';
+// Backend implementations (available for direct use if needed)
+export { PostgresBackend, createPostgresBackend } from './backends/postgresql.js';
+export { QdrantVectorStore, createQdrantVectorStore } from './vector/qdrant.js';
+// ===========================================================================
+// Storage Config (sync utility functions)
+// ===========================================================================
+export function getStorageConfig() {
+    const config = getConfig();
+    return {
+        backend: config.storage?.backend ?? 'sqlite',
+        vector: config.storage?.vector ?? 'builtin',
+        sqlite: config.storage?.sqlite ?? {},
+        postgresql: config.storage?.postgresql ?? {},
+        qdrant: config.storage?.qdrant ?? {},
+    };
+}
+export function validateStorageConfig() {
+    const config = getStorageConfig();
+    if (config.backend === 'sqlite' && config.sqlite) {
+        if (config.sqlite.busy_timeout !== undefined && config.sqlite.busy_timeout < 0) {
+            throw new ConfigError('storage.sqlite.busy_timeout must be a positive number');
+        }
+    }
+    if (config.backend === 'postgresql') {
+        if (!config.postgresql.connection_string && !config.postgresql.database) {
+            throw new ConfigError('PostgreSQL backend requires either connection_string or database in storage.postgresql config');
+        }
+    }
+    if (config.vector === 'qdrant') {
+        if (config.qdrant.url && !config.qdrant.url.startsWith('http')) {
+            throw new ConfigError('storage.qdrant.url must be a valid HTTP(S) URL');
+        }
+    }
+}
+export function getStorageInfo() {
+    const config = getStorageConfig();
+    if (config.backend === 'sqlite') {
+        return {
+            backend: 'sqlite',
+            vector: config.vector === 'qdrant' ? 'qdrant' : 'sqlite-vec',
+            path: getDbPath(),
+            globalPath: getGlobalDbPath(),
+        };
+    }
+    if (config.backend === 'postgresql') {
+        const pgConfig = config.postgresql;
+        return {
+            backend: 'postgresql',
+            vector: config.vector === 'qdrant' ? 'qdrant' : 'pgvector',
+            path: pgConfig.connection_string ||
+                `${pgConfig.host ?? 'localhost'}:${pgConfig.port ?? 5432}/${pgConfig.database ?? 'succ'}`,
+        };
+    }
+    return {
+        backend: config.backend,
+        vector: config.vector,
+    };
+}
+// ===========================================================================
+// Document Operations — async wrappers routing through dispatcher
+// ===========================================================================
+export async function upsertDocument(filePath, chunkIndex, content, startLine, endLine, embedding, symbolName, symbolType, signature) {
+    const d = await getStorageDispatcher();
+    return d.upsertDocument(filePath, chunkIndex, content, startLine, endLine, embedding, symbolName, symbolType, signature);
+}
+export async function upsertDocumentsBatch(documents) {
+    const d = await getStorageDispatcher();
+    return d.upsertDocumentsBatch(documents);
+}
+export async function upsertDocumentsBatchWithHashes(documents) {
+    const d = await getStorageDispatcher();
+    return d.upsertDocumentsBatchWithHashes(documents);
+}
+export async function deleteDocumentsByPath(filePath) {
+    const d = await getStorageDispatcher();
+    return d.deleteDocumentsByPath(filePath);
+}
+export async function searchDocuments(queryEmbedding, limit, threshold) {
+    const d = await getStorageDispatcher();
+    return d.searchDocuments(queryEmbedding, limit, threshold);
+}
+export async function getRecentDocuments(limit) {
+    const d = await getStorageDispatcher();
+    return d.getRecentDocuments(limit);
+}
+export async function getStats() {
+    const d = await getStorageDispatcher();
+    return d.getStats();
+}
+export async function clearDocuments() {
+    const d = await getStorageDispatcher();
+    return d.clearDocuments();
+}
+export async function clearCodeDocuments() {
+    const d = await getStorageDispatcher();
+    return d.clearCodeDocuments();
+}
+export async function getStoredEmbeddingDimension() {
+    const d = await getStorageDispatcher();
+    return d.getStoredEmbeddingDimension();
+}
+// ===========================================================================
+// File Hashes
+// ===========================================================================
+export async function getFileHash(filePath) {
+    const d = await getStorageDispatcher();
+    return d.getFileHash(filePath);
+}
+export async function setFileHash(filePath, hash) {
+    const d = await getStorageDispatcher();
+    return d.setFileHash(filePath, hash);
+}
+export async function deleteFileHash(filePath) {
+    const d = await getStorageDispatcher();
+    return d.deleteFileHash(filePath);
+}
+export async function getAllFileHashes() {
+    const d = await getStorageDispatcher();
+    return d.getAllFileHashes();
+}
+export async function getAllFileHashesWithTimestamps() {
+    const d = await getStorageDispatcher();
+    return d.getAllFileHashesWithTimestamps();
+}
+/**
+ * Check which indexed files are stale (modified or deleted since indexing).
+ * Uses mtime-first optimization: only reads+hashes files whose mtime > indexed_at.
+ */
+export async function getStaleFiles(projectRoot) {
+    const { createHash } = await import('crypto');
+    const { readFileSync, statSync } = await import('fs');
+    const { resolve, sep } = await import('path');
+    const entries = await getAllFileHashesWithTimestamps();
+    const stale = [];
+    const deleted = [];
+    for (const entry of entries) {
+        // Code-indexed files have "code:" prefix — strip it for disk path
+        const isCode = entry.file_path.startsWith('code:');
+        const relativePath = isCode ? entry.file_path.slice(5) : entry.file_path;
+        // Normalize path separators for current OS
+        const normalized = relativePath.split(/[\\/]/).join(sep);
+        const fullPath = resolve(projectRoot, normalized);
+        try {
+            const stat = statSync(fullPath);
+            // Compare mtime against indexed_at — only hash if file is newer
+            const indexedAt = new Date(entry.indexed_at).getTime();
+            if (stat.mtimeMs > indexedAt) {
+                // File was modified after indexing — verify with hash
+                const content = readFileSync(fullPath, 'utf-8');
+                const currentHash = createHash('md5').update(content).digest('hex');
+                if (currentHash !== entry.content_hash) {
+                    stale.push(entry.file_path);
+                }
+            }
+        }
+        catch {
+            // File doesn't exist on disk
+            deleted.push(entry.file_path);
+        }
+    }
+    return { stale, deleted, total: entries.length };
+}
+/**
+ * Convenience wrapper returning counts (used by status displays).
+ */
+export async function getStaleFileCount(projectRoot) {
+    const result = await getStaleFiles(projectRoot);
+    return { stale: result.stale.length, deleted: result.deleted.length, total: result.total };
+}
+// ===========================================================================
+// Local Memories
+// ===========================================================================
+export async function findSimilarMemory(embedding, threshold) {
+    const d = await getStorageDispatcher();
+    return d.findSimilarMemory(embedding, threshold);
+}
+export async function saveMemory(content, embedding, tags, source, options) {
+    const d = await getStorageDispatcher();
+    // Adapt qualityScore: consumers pass { score, factors }, dispatcher wants separate params
+    let qs;
+    let qf;
+    if (options?.qualityScore && typeof options.qualityScore === 'object') {
+        qs = options.qualityScore.score;
+        qf = options.qualityScore.factors;
+    }
+    else if (typeof options?.qualityScore === 'number') {
+        qs = options.qualityScore;
+        qf = options?.qualityFactors;
+    }
+    // Convert Date to string for validity
+    const validFrom = options?.validFrom instanceof Date ? options.validFrom.toISOString() : options?.validFrom;
+    const validUntil = options?.validUntil instanceof Date ? options.validUntil.toISOString() : options?.validUntil;
+    const result = await d.saveMemory(content, embedding, tags ?? [], source, {
+        type: options?.type,
+        deduplicate: options?.deduplicate,
+        qualityScore: qs,
+        qualityFactors: qf,
+        validFrom,
+        validUntil,
+    });
+    // Convert dispatcher result to backward-compatible format
+    return {
+        id: result.id,
+        isDuplicate: !result.created,
+        existingId: result.duplicate?.id,
+        similarity: result.duplicate?.similarity,
+        linksCreated: 0,
+    };
+}
+export async function saveMemoriesBatch(memories, deduplicateThreshold, options) {
+    const d = await getStorageDispatcher();
+    return d.saveMemoriesBatch(memories, deduplicateThreshold, options);
+}
+export async function searchMemories(queryEmbedding, limit, threshold, tags, since, options) {
+    const d = await getStorageDispatcher();
+    return d.searchMemories(queryEmbedding, limit, threshold, tags, since, options);
+}
+export async function getRecentMemories(limit) {
+    const d = await getStorageDispatcher();
+    return d.getRecentMemories(limit);
+}
+export async function incrementCorrectionCount(memoryId) {
+    const d = await getStorageDispatcher();
+    return d.incrementCorrectionCount(memoryId);
+}
+export async function setMemoryInvariant(memoryId, isInvariant) {
+    const d = await getStorageDispatcher();
+    return d.setMemoryInvariant(memoryId, isInvariant);
+}
+export async function getPinnedMemories(threshold) {
+    const d = await getStorageDispatcher();
+    return d.getPinnedMemories(threshold);
+}
+export async function updatePriorityScore(memoryId, score) {
+    const d = await getStorageDispatcher();
+    return d.updatePriorityScore(memoryId, score);
+}
+export async function recomputePriorityScore(memoryId) {
+    const d = await getStorageDispatcher();
+    return d.recomputePriorityScore(memoryId);
+}
+export async function deleteMemory(id) {
+    const d = await getStorageDispatcher();
+    return d.deleteMemory(id);
+}
+export async function invalidateMemory(memoryId, supersededById) {
+    const d = await getStorageDispatcher();
+    return d.invalidateMemory(memoryId, supersededById);
+}
+export async function restoreInvalidatedMemory(memoryId) {
+    const d = await getStorageDispatcher();
+    return d.restoreInvalidatedMemory(memoryId);
+}
+export async function getConsolidationHistory(limit) {
+    const d = await getStorageDispatcher();
+    return d.getConsolidationHistory(limit);
+}
+export async function getMemoryStats() {
+    const d = await getStorageDispatcher();
+    return d.getMemoryStats();
+}
+export async function deleteMemoriesOlderThan(date) {
+    const d = await getStorageDispatcher();
+    return d.deleteMemoriesOlderThan(date);
+}
+export async function deleteMemoriesByTag(tag) {
+    const d = await getStorageDispatcher();
+    return d.deleteMemoriesByTag(tag);
+}
+export async function getMemoryById(id) {
+    const d = await getStorageDispatcher();
+    return d.getMemoryById(id);
+}
+export async function deleteMemoriesByIds(ids) {
+    const d = await getStorageDispatcher();
+    return d.deleteMemoriesByIds(ids);
+}
+export async function searchMemoriesAsOf(queryEmbedding, asOfDate, limit, threshold) {
+    const d = await getStorageDispatcher();
+    return d.searchMemoriesAsOf(queryEmbedding, asOfDate, limit, threshold);
+}
+export async function incrementMemoryAccess(memoryId, weight) {
+    const d = await getStorageDispatcher();
+    return d.incrementMemoryAccess(memoryId, weight);
+}
+export async function incrementMemoryAccessBatch(accesses) {
+    const d = await getStorageDispatcher();
+    return d.incrementMemoryAccessBatch(accesses);
+}
+export async function getAllMemoriesForRetention() {
+    const d = await getStorageDispatcher();
+    return d.getAllMemoriesForRetention();
+}
+// ===========================================================================
+// Global Memories
+// ===========================================================================
+export async function findSimilarGlobalMemory(embedding, threshold) {
+    const d = await getStorageDispatcher();
+    return d.findSimilarGlobalMemory(embedding, threshold);
+}
+export async function saveGlobalMemory(content, embedding, tags, source, projectOrOptions, options) {
+    const d = await getStorageDispatcher();
+    // Handle overloaded signature: (content, embedding, tags, source, project?, options?)
+    let opts;
+    if (typeof projectOrOptions === 'string') {
+        // Called as: saveGlobalMemory(content, embedding, tags, source, projectName, options?)
+        opts = options;
+    }
+    else {
+        // Called as: saveGlobalMemory(content, embedding, tags, source, options?)
+        opts = projectOrOptions;
+    }
+    const result = await d.saveGlobalMemory(content, embedding, tags ?? [], source, opts);
+    // Convert dispatcher result to backward-compatible format
+    return {
+        id: result.id,
+        isDuplicate: !result.created,
+        existingId: result.duplicate?.id,
+        similarity: result.duplicate?.similarity,
+    };
+}
+export async function searchGlobalMemories(queryEmbedding, limit, threshold, tags) {
+    const d = await getStorageDispatcher();
+    return d.searchGlobalMemories(queryEmbedding, limit, threshold, tags);
+}
+export async function getRecentGlobalMemories(limit) {
+    const d = await getStorageDispatcher();
+    return d.getRecentGlobalMemories(limit);
+}
+export async function deleteGlobalMemory(id) {
+    const d = await getStorageDispatcher();
+    return d.deleteGlobalMemory(id);
+}
+export async function getGlobalMemoryStats() {
+    const d = await getStorageDispatcher();
+    return d.getGlobalMemoryStats();
+}
+// ===========================================================================
+// BM25 Index Management
+// ===========================================================================
+export async function invalidateCodeBm25Index() {
+    const d = await getStorageDispatcher();
+    return d.invalidateCodeBm25Index();
+}
+export async function invalidateDocsBm25Index() {
+    const d = await getStorageDispatcher();
+    return d.invalidateDocsBm25Index();
+}
+export async function invalidateMemoriesBm25Index() {
+    const d = await getStorageDispatcher();
+    return d.invalidateMemoriesBm25Index();
+}
+export async function invalidateGlobalMemoriesBm25Index() {
+    const d = await getStorageDispatcher();
+    return d.invalidateGlobalMemoriesBm25Index();
+}
+export async function invalidateBM25Index() {
+    const d = await getStorageDispatcher();
+    return d.invalidateBM25Index();
+}
+export async function updateCodeBm25Index(docId, content, symbolName, signature) {
+    const d = await getStorageDispatcher();
+    return d.updateCodeBm25Index(docId, content, symbolName, signature);
+}
+export async function updateMemoriesBm25Index(memoryId, content) {
+    const d = await getStorageDispatcher();
+    return d.updateMemoriesBm25Index(memoryId, content);
+}
+export async function updateGlobalMemoriesBm25Index(memoryId, content) {
+    const d = await getStorageDispatcher();
+    return d.updateGlobalMemoriesBm25Index(memoryId, content);
+}
+// ===========================================================================
+// Hybrid Search
+// ===========================================================================
+export async function hybridSearchCode(query, queryEmbedding, limit, threshold, alpha, filters) {
+    const d = await getStorageDispatcher();
+    return d.hybridSearchCode(query, queryEmbedding, limit, threshold, alpha, filters);
+}
+export async function hybridSearchDocs(query, queryEmbedding, limit, threshold, alpha) {
+    const d = await getStorageDispatcher();
+    return d.hybridSearchDocs(query, queryEmbedding, limit, threshold, alpha);
+}
+export async function hybridSearchMemories(query, queryEmbedding, limit, threshold, alpha) {
+    const d = await getStorageDispatcher();
+    return d.hybridSearchMemories(query, queryEmbedding, limit, threshold, alpha);
+}
+export async function hybridSearchGlobalMemories(query, queryEmbedding, limit, threshold, alpha, tags, since) {
+    const d = await getStorageDispatcher();
+    return d.hybridSearchGlobalMemories(query, queryEmbedding, limit, threshold, alpha, tags, since);
+}
+// ===========================================================================
+// Memory Links (Knowledge Graph)
+// ===========================================================================
+export async function createMemoryLink(sourceId, targetId, relation, weight, optionsOrValidFrom, validUntil) {
+    const d = await getStorageDispatcher();
+    let vf;
+    let vu;
+    if (typeof optionsOrValidFrom === 'object') {
+        vf = optionsOrValidFrom.validFrom;
+        vu = optionsOrValidFrom.validUntil;
+    }
+    else {
+        vf = optionsOrValidFrom;
+        vu = validUntil;
+    }
+    return d.createMemoryLink(sourceId, targetId, relation, weight, vf, vu);
+}
+export async function deleteMemoryLink(sourceId, targetId, relation) {
+    const d = await getStorageDispatcher();
+    return d.deleteMemoryLink(sourceId, targetId, relation);
+}
+export async function getMemoryLinks(memoryId) {
+    const d = await getStorageDispatcher();
+    return d.getMemoryLinks(memoryId);
+}
+export async function getMemoryWithLinks(memoryId, options) {
+    const d = await getStorageDispatcher();
+    return d.getMemoryWithLinks(memoryId, options);
+}
+export async function findConnectedMemories(memoryId, maxDepth) {
+    const d = await getStorageDispatcher();
+    return d.findConnectedMemories(memoryId, maxDepth);
+}
+export async function findRelatedMemoriesForLinking(memoryId, threshold, maxLinks) {
+    const d = await getStorageDispatcher();
+    return d.findRelatedMemoriesForLinking(memoryId, threshold, maxLinks);
+}
+export async function createAutoLinks(memoryId, threshold, maxLinks) {
+    const d = await getStorageDispatcher();
+    return d.createAutoLinks(memoryId, threshold, maxLinks);
+}
+export async function autoLinkSimilarMemories(threshold, maxLinks) {
+    const d = await getStorageDispatcher();
+    return d.autoLinkSimilarMemories(threshold, maxLinks);
+}
+export async function getGraphStats() {
+    const d = await getStorageDispatcher();
+    return d.getGraphStats();
+}
+export async function invalidateMemoryLink(sourceId, targetId, relation) {
+    const d = await getStorageDispatcher();
+    return d.invalidateMemoryLink(sourceId, targetId, relation);
+}
+export async function getMemoryLinksAsOf(memoryId, asOfDate) {
+    const d = await getStorageDispatcher();
+    return d.getMemoryLinksAsOf(memoryId, asOfDate);
+}
+export async function findConnectedMemoriesAsOf(memoryId, asOfDate, maxDepth) {
+    const d = await getStorageDispatcher();
+    return d.findConnectedMemoriesAsOf(memoryId, asOfDate, maxDepth);
+}
+export async function getGraphStatsAsOf(asOfDate) {
+    const d = await getStorageDispatcher();
+    return d.getGraphStatsAsOf(asOfDate);
+}
+// ===========================================================================
+// Graph Enrichment
+// ===========================================================================
+export async function updateMemoryTags(memoryId, tags) {
+    const d = await getStorageDispatcher();
+    return d.updateMemoryTags(memoryId, tags);
+}
+export async function updateMemoryLink(linkId, updates) {
+    const d = await getStorageDispatcher();
+    return d.updateMemoryLink(linkId, updates);
+}
+export async function upsertCentralityScore(memoryId, degree, normalizedDegree) {
+    const d = await getStorageDispatcher();
+    return d.upsertCentralityScore(memoryId, degree, normalizedDegree);
+}
+export async function getCentralityScores(memoryIds) {
+    const d = await getStorageDispatcher();
+    return d.getCentralityScores(memoryIds);
+}
+export async function deleteMemoryLinksByIds(ids) {
+    const d = await getStorageDispatcher();
+    return d.deleteMemoryLinksByIds(ids);
+}
+export async function findIsolatedMemoryIds() {
+    const d = await getStorageDispatcher();
+    return d.findIsolatedMemoryIds();
+}
+// ===========================================================================
+// Token Frequency
+// ===========================================================================
+export async function updateTokenFrequencies(tokens) {
+    const d = await getStorageDispatcher();
+    return d.updateTokenFrequencies(tokens);
+}
+export async function getTokenFrequency(token) {
+    const d = await getStorageDispatcher();
+    return d.getTokenFrequency(token);
+}
+export async function getTokenFrequencies(tokens) {
+    const d = await getStorageDispatcher();
+    return d.getTokenFrequencies(tokens);
+}
+export async function getTotalTokenCount() {
+    const d = await getStorageDispatcher();
+    return d.getTotalTokenCount();
+}
+export async function getTopTokens(limit) {
+    const d = await getStorageDispatcher();
+    return d.getTopTokens(limit);
+}
+export async function clearTokenFrequencies() {
+    const d = await getStorageDispatcher();
+    return d.clearTokenFrequencies();
+}
+export async function getTokenFrequencyStats() {
+    const d = await getStorageDispatcher();
+    return d.getTokenFrequencyStats();
+}
+// ===========================================================================
+// Token Stats
+// ===========================================================================
+export async function recordTokenStat(record) {
+    const d = await getStorageDispatcher();
+    return d.recordTokenStat(record);
+}
+export async function getTokenStatsAggregated() {
+    const d = await getStorageDispatcher();
+    return d.getTokenStatsAggregated();
+}
+export async function getTokenStatsSummary() {
+    const d = await getStorageDispatcher();
+    return d.getTokenStatsSummary();
+}
+export async function clearTokenStats() {
+    const d = await getStorageDispatcher();
+    return d.clearTokenStats();
+}
+// ===========================================================================
+// Web Search History
+// ===========================================================================
+export async function recordWebSearch(record) {
+    const d = await getStorageDispatcher();
+    return d.recordWebSearch(record);
+}
+export async function getWebSearchHistory(filter) {
+    const d = await getStorageDispatcher();
+    return d.getWebSearchHistory(filter ?? {});
+}
+export async function getWebSearchSummary() {
+    const d = await getStorageDispatcher();
+    return d.getWebSearchSummary();
+}
+export async function getTodayWebSearchSpend() {
+    const d = await getStorageDispatcher();
+    return d.getTodayWebSearchSpend();
+}
+export async function clearWebSearchHistory() {
+    const d = await getStorageDispatcher();
+    return d.clearWebSearchHistory();
+}
+// ===========================================================================
+// Qdrant Backfill
+// ===========================================================================
+export async function backfillQdrant(target, options) {
+    const d = await getStorageDispatcher();
+    return d.backfillQdrant(target, options);
+}
+// ===========================================================================
+// Skills
+// ===========================================================================
+export async function upsertSkill(skill) {
+    const d = await getStorageDispatcher();
+    return d.upsertSkill(skill);
+}
+export async function getAllSkills() {
+    const d = await getStorageDispatcher();
+    return d.getAllSkills();
+}
+export async function searchSkillsDb(query, limit) {
+    const d = await getStorageDispatcher();
+    return d.searchSkills(query, limit);
+}
+export async function getSkillByName(name) {
+    const d = await getStorageDispatcher();
+    return d.getSkillByName(name);
+}
+export async function trackSkillUsageDb(name) {
+    const d = await getStorageDispatcher();
+    return d.trackSkillUsage(name);
+}
+export async function deleteSkill(name) {
+    const d = await getStorageDispatcher();
+    return d.deleteSkill(name);
+}
+export async function clearExpiredSkyllCache() {
+    const d = await getStorageDispatcher();
+    return d.clearExpiredSkyllCache();
+}
+export async function getCachedSkyllSkill(skyllId) {
+    const d = await getStorageDispatcher();
+    return d.getCachedSkyllSkill(skyllId);
+}
+export async function getSkyllCacheStats() {
+    const d = await getStorageDispatcher();
+    return d.getSkyllCacheStats();
+}
+// ===========================================================================
+// Bulk Export (for checkpoint, graph-export)
+// ===========================================================================
+export async function getAllMemoriesForExport() {
+    const d = await getStorageDispatcher();
+    return d.getAllMemoriesForExport();
+}
+export async function getAllDocumentsForExport() {
+    const d = await getStorageDispatcher();
+    return d.getAllDocumentsForExport();
+}
+export async function getAllMemoryLinksForExport() {
+    const d = await getStorageDispatcher();
+    return d.getAllMemoryLinksForExport();
+}
+export async function getAllCentralityForExport() {
+    const d = await getStorageDispatcher();
+    return d.getAllCentralityForExport();
+}
+// ===========================================================================
+// Bulk Restore (for checkpoint restore)
+// ===========================================================================
+export async function bulkRestore(data) {
+    const d = await getStorageDispatcher();
+    return d.bulkRestore(data);
+}
+// ===========================================================================
+// Learning Deltas
+// ===========================================================================
+export async function appendLearningDelta(delta) {
+    const d = await getStorageDispatcher();
+    return d.appendLearningDelta(delta);
+}
+export async function appendRawLearningDelta(text) {
+    const d = await getStorageDispatcher();
+    return d.appendRawLearningDelta(text);
+}
+export async function getLearningDeltas(options) {
+    const d = await getStorageDispatcher();
+    return d.getLearningDeltas(options);
+}
+// ===========================================================================
+// AI Readiness Stats
+// ===========================================================================
+export async function getCodeFileCount() {
+    const d = await getStorageDispatcher();
+    return d.getCodeFileCount();
+}
+export async function getDocsFileCount() {
+    const d = await getStorageDispatcher();
+    return d.getDocsFileCount();
+}
+export async function getAverageMemoryQuality() {
+    const d = await getStorageDispatcher();
+    return d.getAverageMemoryQuality();
+}
+// ===========================================================================
+// Filtered Memory Export (for agents-md-generator)
+// ===========================================================================
+export async function getMemoriesForAgentsExport(options) {
+    const d = await getStorageDispatcher();
+    return d.getMemoriesForAgentsExport(options);
+}
+// ===========================================================================
+// Consolidation Helpers
+// ===========================================================================
+export async function getAllMemoriesWithEmbeddings(options) {
+    const d = await getStorageDispatcher();
+    return d.getAllMemoriesWithEmbeddings(options);
+}
+export async function getMemoryEmbeddingsByIds(ids) {
+    const d = await getStorageDispatcher();
+    return d.getMemoryEmbeddingsByIds(ids);
+}
+export async function deleteMemoryLinksForMemory(memoryId) {
+    const d = await getStorageDispatcher();
+    return d.deleteMemoryLinksForMemory(memoryId);
+}
+export async function updateMemoryEmbeddingsBatch(updates) {
+    const d = await getStorageDispatcher();
+    return d.updateMemoryEmbeddingsBatch(updates);
+}
+export async function getMemoriesNeedingReembedding(limit = 100, afterId = 0) {
+    const d = await getStorageDispatcher();
+    return d.getMemoriesNeedingReembedding(limit, afterId);
+}
+export async function getMemoryCount() {
+    const d = await getStorageDispatcher();
+    return d.getMemoryCount();
+}
+export async function getMemoryEmbeddingCount() {
+    const d = await getStorageDispatcher();
+    return d.getMemoryEmbeddingCount();
+}
+//# sourceMappingURL=index.js.map