@vinaes/succ 1.3.19

package/dist/lib/skyll-client.js

@@ -0,0 +1,257 @@
+/**
+ * Skyll API Client
+ *
+ * Integrates with Skyll (https://github.com/assafelovic/skyll) for external skill discovery.
+ * Uses aggressive caching to minimize API calls (rate limit: 60 req/hour without API key).
+ *
+ * Features:
+ * - Search skills by keywords
+ * - Get skill details
+ * - Local DB caching with TTL
+ * - Rate limiting
+ */
+import { upsertSkill, getCachedSkyllSkill as getCachedSkyllSkillDb, clearExpiredSkyllCache as clearExpiredSkyllCacheDb, getSkyllCacheStats as getSkyllCacheStatsDb, searchSkillsDb, } from './storage/index.js';
+import { getConfig } from './config.js';
+import { logError, logWarn, logInfo } from './fault-logger.js';
+// ============================================================================
+// Default Config
+// ============================================================================
+const DEFAULT_SKYLL_CONFIG = {
+    enabled: true,
+    endpoint: 'https://api.skyll.app',
+    cacheTtl: 604800, // 7 days
+    onlyWhenNoLocal: true,
+    rateLimit: 30, // Conservative: 30 req/hour (actual limit is 60)
+};
+let rateLimitState = {
+    requests: [],
+    hourStart: Date.now(),
+};
+function checkRateLimit(limit) {
+    const now = Date.now();
+    const hourAgo = now - 3600000;
+    // Reset if hour passed
+    if (rateLimitState.hourStart < hourAgo) {
+        rateLimitState = { requests: [], hourStart: now };
+    }
+    // Filter old requests
+    rateLimitState.requests = rateLimitState.requests.filter((t) => t > hourAgo);
+    return rateLimitState.requests.length < limit;
+}
+function recordRequest() {
+    rateLimitState.requests.push(Date.now());
+}
+// ============================================================================
+// Cache
+// ============================================================================
+async function getCachedSkills(query) {
+    try {
+        // Search via dispatcher (handles both PG and SQLite)
+        const rows = await searchSkillsDb(query, 20);
+        // Filter to only Skyll cached results
+        const skyllRows = rows
+            .filter((r) => r.source === 'skyll')
+            .map((r) => ({
+            id: r.id,
+            name: r.name,
+            description: r.description,
+            source: 'skyll',
+        }));
+        return skyllRows.length > 0 ? skyllRows : null;
+    }
+    catch (err) {
+        logWarn('skyll', err instanceof Error ? err.message : 'Failed to get cached skills');
+        return null;
+    }
+}
+async function cacheSkills(skills, ttlSeconds) {
+    const expires = new Date(Date.now() + ttlSeconds * 1000).toISOString();
+    for (const skill of skills) {
+        try {
+            await upsertSkill({
+                name: skill.title || skill.id,
+                description: skill.description,
+                source: 'skyll',
+                skyllId: skill.id,
+                content: skill.content,
+                cacheExpires: expires,
+            });
+        }
+        catch (err) {
+            logWarn('skyll', err instanceof Error ? err.message : 'Failed to cache skill');
+        }
+    }
+}
+// ============================================================================
+// API Client
+// ============================================================================
+function getSkyllConfig() {
+    const config = getConfig();
+    const skyllConfig = config.skills?.skyll || {};
+    return {
+        enabled: skyllConfig.enabled !== false,
+        endpoint: skyllConfig.endpoint || DEFAULT_SKYLL_CONFIG.endpoint,
+        apiKey: skyllConfig.api_key || process.env.SKYLL_API_KEY,
+        cacheTtl: skyllConfig.cache_ttl || DEFAULT_SKYLL_CONFIG.cacheTtl,
+        onlyWhenNoLocal: skyllConfig.only_when_no_local !== false,
+        rateLimit: skyllConfig.rate_limit || DEFAULT_SKYLL_CONFIG.rateLimit,
+    };
+}
+/**
+ * Search Skyll API for skills matching keywords
+ */
+export async function searchSkyll(keywords, options = {}) {
+    const { limit = 10, skipCache = false } = options;
+    const config = getSkyllConfig();
+    logInfo('skyll', `searchSkyll called with keywords: ${JSON.stringify(keywords)}, enabled=${config.enabled}`);
+    if (!config.enabled) {
+        logInfo('skyll', 'Skyll disabled, returning empty');
+        return [];
+    }
+    const query = keywords.join(' ');
+    // Check cache first
+    if (!skipCache) {
+        const cached = await getCachedSkills(query);
+        if (cached && cached.length > 0) {
+            return cached.slice(0, limit);
+        }
+    }
+    // Check rate limit
+    if (!checkRateLimit(config.rateLimit)) {
+        logWarn('skyll', 'Rate limit reached, using cache only');
+        return (await getCachedSkills(query)) || [];
+    }
+    try {
+        // Skyll API uses GET with query params: /search?q=...&limit=...
+        const searchUrl = `${config.endpoint}/search?q=${encodeURIComponent(query)}&limit=${limit}`;
+        logInfo('skyll', `Calling API: ${searchUrl}`);
+        const headers = {};
+        if (config.apiKey) {
+            headers['Authorization'] = `Bearer ${config.apiKey}`;
+        }
+        const response = await fetch(searchUrl, {
+            method: 'GET',
+            headers,
+            signal: AbortSignal.timeout(10000),
+        });
+        recordRequest();
+        if (!response.ok) {
+            if (response.status === 429) {
+                logWarn('skyll', 'Rate limited by API');
+            }
+            return (await getCachedSkills(query)) || [];
+        }
+        const data = (await response.json());
+        logInfo('skyll', `API returned ${data.skills?.length || 0} skills`);
+        // Cache results
+        if (data.skills && data.skills.length > 0) {
+            await cacheSkills(data.skills, config.cacheTtl);
+        }
+        // Convert to Skill format (Skyll uses 'title' not 'name')
+        return data.skills.slice(0, limit).map((s) => ({
+            name: s.title || s.id,
+            description: s.description,
+            source: 'skyll',
+            skyll_id: s.id,
+            content: s.content,
+        }));
+    }
+    catch (err) {
+        logError('skyll', 'Search failed', err instanceof Error ? err : new Error(String(err)));
+        return (await getCachedSkills(query)) || [];
+    }
+}
+/**
+ * Get skill details from Skyll API
+ */
+export async function getSkyllSkill(skillId) {
+    const config = getSkyllConfig();
+    if (!config.enabled) {
+        return null;
+    }
+    // Check cache first (via dispatcher)
+    try {
+        const cached = await getCachedSkyllSkillDb(skillId);
+        if (cached) {
+            return {
+                name: cached.name,
+                description: cached.description,
+                source: 'skyll',
+                skyll_id: skillId,
+                content: cached.content,
+            };
+        }
+    }
+    catch (err) {
+        logWarn('skyll', err instanceof Error ? err.message : 'Failed to get cached skill');
+    }
+    // Check rate limit
+    if (!checkRateLimit(config.rateLimit)) {
+        return null;
+    }
+    try {
+        const headers = {
+            'Content-Type': 'application/json',
+        };
+        if (config.apiKey) {
+            headers['Authorization'] = `Bearer ${config.apiKey}`;
+        }
+        const response = await fetch(`${config.endpoint}/v1/skills/${skillId}`, {
+            method: 'GET',
+            headers,
+            signal: AbortSignal.timeout(10000),
+        });
+        recordRequest();
+        if (!response.ok) {
+            return null;
+        }
+        const skill = (await response.json());
+        // Cache result
+        await cacheSkills([skill], config.cacheTtl);
+        return {
+            name: skill.title || skill.id,
+            description: skill.description,
+            source: 'skyll',
+            skyll_id: skill.id,
+            content: skill.content,
+        };
+    }
+    catch (err) {
+        logError('skyll', 'Get skill failed', err instanceof Error ? err : new Error(String(err)));
+        return null;
+    }
+}
+/**
+ * Clear expired cache entries
+ */
+export async function clearExpiredCache() {
+    try {
+        return await clearExpiredSkyllCacheDb();
+    }
+    catch (err) {
+        logWarn('skyll', err instanceof Error ? err.message : 'Failed to clear expired cache');
+        return 0;
+    }
+}
+/**
+ * Get Skyll API status
+ */
+export async function getSkyllStatus() {
+    const config = getSkyllConfig();
+    let cachedSkills = 0;
+    try {
+        const stats = await getSkyllCacheStatsDb();
+        cachedSkills = stats.cachedSkills;
+    }
+    catch (err) {
+        logWarn('skyll', err instanceof Error ? err.message : 'Failed to count cached skills');
+    }
+    return {
+        enabled: config.enabled,
+        hasApiKey: !!config.apiKey,
+        requestsThisHour: rateLimitState.requests.length,
+        rateLimit: config.rateLimit,
+        cachedSkills,
+    };
+}
+//# sourceMappingURL=skyll-client.js.map

package/dist/lib/skyll-client.js.map

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

package/dist/lib/storage/backends/interface.d.ts

@@ -0,0 +1,383 @@
+/**
+ * StorageBackend interface for abstracting SQL database operations.
+ *
+ * Implementations:
+ * - SQLite (better-sqlite3)
+ * - PostgreSQL (pg)
+ *
+ * Note: Vector operations are handled by VectorStore interface separately.
+ * This interface focuses on SQL/relational operations.
+ */
+import type Database from 'better-sqlite3';
+import type { Document, DocumentBatch, DocumentBatchWithHash, Memory, GlobalMemory, MemoryLink, MemoryWithLinks, ConnectedMemory, GraphStats, TokenStatRecord, TokenStatsAggregated, MemoryForRetention, MemoryType, LinkRelation, WebSearchHistoryInput, WebSearchHistoryRecord, WebSearchHistoryFilter, WebSearchHistorySummary } from '../types.js';
+/**
+ * StorageBackend interface for SQL database operations.
+ *
+ * Design notes:
+ * - Methods are sync for SQLite compatibility (better-sqlite3 is sync)
+ * - PostgreSQL implementation will wrap async pg in sync-compatible interface
+ * - Vector search is delegated to VectorStore interface
+ */
+export interface StorageBackend {
+    /**
+     * Initialize the database (create tables, run migrations).
+     */
+    init(): void;
+    /**
+     * Close database connections.
+     */
+    close(): void;
+    /**
+     * Get the raw database instance (for advanced use).
+     * Returns better-sqlite3 Database for SQLite, or Pool for PostgreSQL.
+     */
+    getRawDb(): Database.Database | unknown;
+    /**
+     * Get the global database instance (for cross-project memories).
+     */
+    getRawGlobalDb(): Database.Database | unknown;
+    /**
+     * Insert or update a document.
+     * @returns The document ID
+     */
+    upsertDocument(filePath: string, chunkIndex: number, content: string, startLine: number, endLine: number, embeddingBlob: Buffer, symbolName?: string, symbolType?: string, signature?: string): number;
+    /**
+     * Batch upsert documents in a single transaction.
+     */
+    upsertDocumentsBatch(documents: DocumentBatch[], toBlob: (embedding: number[]) => Buffer): void;
+    /**
+     * Batch upsert documents with file hashes in a single transaction.
+     */
+    upsertDocumentsBatchWithHashes(documents: DocumentBatchWithHash[], toBlob: (embedding: number[]) => Buffer): void;
+    /**
+     * Delete all documents for a given file path.
+     * @returns Array of deleted document IDs (for vector cleanup)
+     */
+    deleteDocumentsByPath(filePath: string): number[];
+    /**
+     * Get document IDs for a given file path.
+     */
+    getDocumentIdsByPath(filePath: string): number[];
+    /**
+     * Get documents by IDs.
+     */
+    getDocumentsByIds(ids: number[]): Document[];
+    /**
+     * Get all documents (for brute-force search fallback).
+     */
+    getAllDocuments(): Array<Document & {
+        embedding: Buffer;
+    }>;
+    /**
+     * Get all code documents (file_path LIKE 'code:%').
+     */
+    getAllCodeDocuments(): Array<{
+        id: number;
+        file_path: string;
+        content: string;
+        start_line: number;
+        end_line: number;
+        embedding: Buffer;
+    }>;
+    /**
+     * Get all non-code documents (file_path NOT LIKE 'code:%').
+     */
+    getAllDocsDocuments(): Array<{
+        id: number;
+        file_path: string;
+        content: string;
+        start_line: number;
+        end_line: number;
+        embedding: Buffer;
+    }>;
+    /**
+     * Get recent documents.
+     */
+    getRecentDocuments(limit: number): Array<{
+        file_path: string;
+        chunk_index: number;
+        start_line: number;
+        end_line: number;
+        updated_at: string;
+    }>;
+    /**
+     * Clear all documents.
+     */
+    clearDocuments(): void;
+    /**
+     * Clear only code documents.
+     */
+    clearCodeDocuments(): void;
+    /**
+     * Get document statistics.
+     */
+    getDocumentStats(): {
+        total_documents: number;
+        total_files: number;
+        last_indexed: string | null;
+    };
+    /**
+     * Get stored embedding dimension from first document.
+     */
+    getStoredEmbeddingDimension(): number | null;
+    getFileHash(filePath: string): string | null;
+    setFileHash(filePath: string, hash: string): void;
+    deleteFileHash(filePath: string): void;
+    getAllFileHashes(): Map<string, string>;
+    getAllFileHashesWithTimestamps(): Array<{
+        file_path: string;
+        content_hash: string;
+        indexed_at: string;
+    }>;
+    /**
+     * Save a memory.
+     */
+    saveMemory(content: string, embeddingBlob: Buffer, tags: string[], source: string | undefined, type: MemoryType, qualityScore: number | undefined, qualityFactors: Record<string, number> | undefined, validFrom: string | undefined, validUntil: string | undefined): number;
+    /**
+     * Find similar memory by embedding (for deduplication).
+     */
+    findSimilarMemoryByEmbedding(embedding: number[], threshold: number, cosineSimilarity: (a: number[], b: number[]) => number, bufferToFloatArray: (buffer: Buffer) => number[]): {
+        id: number;
+        content: string;
+        similarity: number;
+    } | null;
+    /**
+     * Get memory by ID.
+     */
+    getMemoryById(id: number): Memory | null;
+    /**
+     * Get recent memories.
+     */
+    getRecentMemories(limit: number): Memory[];
+    /**
+     * Get all memories with embeddings (for vector search fallback).
+     */
+    getAllMemoriesWithEmbeddings(): Array<{
+        id: number;
+        content: string;
+        tags: string | null;
+        source: string | null;
+        type: string | null;
+        created_at: string;
+        embedding: Buffer;
+        last_accessed: string | null;
+        access_count: number;
+        valid_from: string | null;
+        valid_until: string | null;
+    }>;
+    /**
+     * Get memories by IDs.
+     */
+    getMemoriesByIds(ids: number[]): Memory[];
+    /**
+     * Delete a memory by ID.
+     * @returns true if deleted
+     */
+    deleteMemory(id: number): boolean;
+    /**
+     * Delete memories older than date.
+     * @returns number of deleted memories
+     */
+    deleteMemoriesOlderThan(date: Date): number;
+    /**
+     * Delete memories by tag.
+     * @returns number of deleted memories
+     */
+    deleteMemoriesByTag(tag: string): number;
+    /**
+     * Delete memories by IDs.
+     * @returns number of deleted memories
+     */
+    deleteMemoriesByIds(ids: number[]): number;
+    /**
+     * Get memory statistics.
+     */
+    getMemoryStats(): {
+        total_memories: number;
+        by_type: Record<string, number>;
+        by_quality: {
+            high: number;
+            medium: number;
+            low: number;
+            unscored: number;
+        };
+        recent_24h: number;
+        recent_7d: number;
+        recent_30d: number;
+        with_quality_score: number;
+        avg_quality_score: number | null;
+        total_links: number;
+        avg_links_per_memory: number;
+    };
+    /**
+     * Increment memory access count.
+     */
+    incrementMemoryAccess(memoryId: number, weight: number): void;
+    /**
+     * Batch increment memory access counts.
+     */
+    incrementMemoryAccessBatch(accesses: Array<{
+        memoryId: number;
+        weight: number;
+    }>): void;
+    /**
+     * Get all memories for retention analysis.
+     */
+    getAllMemoriesForRetention(): MemoryForRetention[];
+    /**
+     * Save a global memory.
+     */
+    saveGlobalMemory(content: string, embeddingBlob: Buffer, tags: string[], source: string | undefined, project: string | undefined, type: MemoryType): number;
+    /**
+     * Find similar global memory (for deduplication).
+     */
+    findSimilarGlobalMemoryByEmbedding(embedding: number[], threshold: number, cosineSimilarity: (a: number[], b: number[]) => number, bufferToFloatArray: (buffer: Buffer) => number[]): {
+        id: number;
+        content: string;
+        similarity: number;
+    } | null;
+    /**
+     * Get all global memories with embeddings.
+     */
+    getAllGlobalMemoriesWithEmbeddings(): Array<{
+        id: number;
+        content: string;
+        tags: string | null;
+        source: string | null;
+        project: string | null;
+        type: string | null;
+        created_at: string;
+        embedding: Buffer;
+    }>;
+    /**
+     * Get recent global memories.
+     */
+    getRecentGlobalMemories(limit: number): GlobalMemory[];
+    /**
+     * Delete a global memory.
+     */
+    deleteGlobalMemory(id: number): boolean;
+    /**
+     * Get global memory statistics.
+     */
+    getGlobalMemoryStats(): {
+        total_memories: number;
+        by_project: Record<string, number>;
+        by_type: Record<string, number>;
+        by_quality: {
+            high: number;
+            medium: number;
+            low: number;
+            unscored: number;
+        };
+        recent_24h: number;
+        recent_7d: number;
+        with_quality_score: number;
+        avg_quality_score: number | null;
+    };
+    /**
+     * Create a memory link.
+     */
+    createMemoryLink(sourceId: number, targetId: number, relation: LinkRelation, weight: number, validFrom: string | undefined, validUntil: string | undefined): {
+        id: number;
+        created: boolean;
+    };
+    /**
+     * Delete a memory link.
+     */
+    deleteMemoryLink(sourceId: number, targetId: number, relation?: LinkRelation): boolean;
+    /**
+     * Get links for a memory.
+     */
+    getMemoryLinks(memoryId: number): {
+        outgoing: MemoryLink[];
+        incoming: MemoryLink[];
+    };
+    /**
+     * Get memory with all its links.
+     */
+    getMemoryWithLinks(memoryId: number, asOfDate?: Date, includeExpired?: boolean): MemoryWithLinks | null;
+    /**
+     * Find connected memories via BFS.
+     */
+    findConnectedMemories(memoryId: number, maxDepth: number): ConnectedMemory[];
+    /**
+     * Auto-link similar memories.
+     */
+    autoLinkSimilarMemories(threshold: number, maxLinks: number, cosineSimilarity: (a: number[], b: number[]) => number, bufferToFloatArray: (buffer: Buffer) => number[]): number;
+    /**
+     * Get graph statistics.
+     */
+    getGraphStats(): GraphStats;
+    /**
+     * Invalidate (soft delete) a memory link.
+     */
+    invalidateMemoryLink(sourceId: number, targetId: number, relation?: LinkRelation): boolean;
+    /**
+     * Get graph statistics as of a specific date.
+     */
+    getGraphStatsAsOf(asOfDate: Date): GraphStats;
+    /**
+     * Update tags for a memory.
+     */
+    updateMemoryTags(memoryId: number, tags: string[]): void;
+    /**
+     * Update a memory link's relation, weight, and enrichment flag.
+     */
+    updateMemoryLink(linkId: number, updates: {
+        relation?: string;
+        weight?: number;
+        llmEnriched?: boolean;
+    }): void;
+    /**
+     * Upsert centrality score cache for a memory.
+     */
+    upsertCentralityScore(memoryId: number, degree: number, normalizedDegree: number): void;
+    /**
+     * Get centrality scores for a batch of memory IDs.
+     */
+    getCentralityScores(memoryIds: number[]): Map<number, number>;
+    updateTokenFrequencies(tokens: string[]): void;
+    getTokenFrequency(token: string): number;
+    getTokenFrequencies(tokens: string[]): Map<string, number>;
+    getTotalTokenCount(): number;
+    getTopTokens(limit: number): Array<{
+        token: string;
+        frequency: number;
+    }>;
+    clearTokenFrequencies(): void;
+    getTokenFrequencyStats(): {
+        unique_tokens: number;
+        total_frequency: number;
+        avg_frequency: number;
+    };
+    recordTokenStat(record: TokenStatRecord): void;
+    getTokenStatsAggregated(): TokenStatsAggregated[];
+    getTokenStatsSummary(): {
+        total_calls: number;
+        total_returned_tokens: number;
+        total_full_source_tokens: number;
+        total_savings_tokens: number;
+        total_estimated_cost: number;
+        savings_percent: number;
+        by_event_type: TokenStatsAggregated[];
+    };
+    clearTokenStats(): void;
+    recordWebSearch(record: WebSearchHistoryInput): number;
+    getWebSearchHistory(filter: WebSearchHistoryFilter): WebSearchHistoryRecord[];
+    getWebSearchSummary(): WebSearchHistorySummary;
+    getTodayWebSearchSpend(): number;
+    clearWebSearchHistory(): void;
+    getBm25Index(key: string): string | null;
+    setBm25Index(key: string, serialized: string): void;
+    deleteBm25Index(key: string): void;
+    getMetadata(key: string): string | null;
+    setMetadata(key: string, value: string): void;
+    /**
+     * Execute a function within a transaction.
+     * For SQLite, wraps in database.transaction().
+     * For PostgreSQL, wraps in BEGIN/COMMIT/ROLLBACK.
+     */
+    transaction<T>(fn: () => T): T;
+}
+//# sourceMappingURL=interface.d.ts.map

package/dist/lib/storage/backends/interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interface.d.ts","sourceRoot":"","sources":["../../../../src/lib/storage/backends/interface.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,KAAK,EACV,QAAQ,EACR,aAAa,EACb,qBAAqB,EACrB,MAAM,EACN,YAAY,EACZ,UAAU,EACV,eAAe,EACf,eAAe,EACf,UAAU,EACV,eAAe,EACf,oBAAoB,EACpB,kBAAkB,EAClB,UAAU,EACV,YAAY,EACZ,qBAAqB,EACrB,sBAAsB,EACtB,sBAAsB,EACtB,uBAAuB,EACxB,MAAM,aAAa,CAAC;AAErB;;;;;;;GAOG;AACH,MAAM,WAAW,cAAc;IAK7B;;OAEG;IACH,IAAI,IAAI,IAAI,CAAC;IAEb;;OAEG;IACH,KAAK,IAAI,IAAI,CAAC;IAEd;;;OAGG;IACH,QAAQ,IAAI,QAAQ,CAAC,QAAQ,GAAG,OAAO,CAAC;IAExC;;OAEG;IACH,cAAc,IAAI,QAAQ,CAAC,QAAQ,GAAG,OAAO,CAAC;IAM9C;;;OAGG;IACH,cAAc,CACZ,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,aAAa,EAAE,MAAM,EACrB,UAAU,CAAC,EAAE,MAAM,EACnB,UAAU,CAAC,EAAE,MAAM,EACnB,SAAS,CAAC,EAAE,MAAM,GACjB,MAAM,CAAC;IAEV;;OAEG;IACH,oBAAoB,CAAC,SAAS,EAAE,aAAa,EAAE,EAAE,MAAM,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,MAAM,GAAG,IAAI,CAAC;IAEhG;;OAEG;IACH,8BAA8B,CAC5B,SAAS,EAAE,qBAAqB,EAAE,EAClC,MAAM,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,MAAM,GACtC,IAAI,CAAC;IAER;;;OAGG;IACH,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAElD;;OAEG;IACH,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAEjD;;OAEG;IACH,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,QAAQ,EAAE,CAAC;IAE7C;;OAEG;IACH,eAAe,IAAI,KAAK,CAAC,QAAQ,GAAG;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAE3D;;OAEG;IACH,mBAAmB,IAAI,KAAK,CAAC;QAC3B,EAAE,EAAE,MAAM,CAAC;QACX,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC,CAAC;IAEH;;OAEG;IACH,mBAAmB,IAAI,KAAK,CAAC;QAC3B,EAAE,EAAE,MAAM,CAAC;QACX,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC,CAAC;IAEH;;OAEG;IACH,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,CAAC;QACvC,SAAS,EAAE,MAAM,CAAC;QAClB,WAAW,EAAE,MAAM,CAAC;QACpB,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC,CAAC;IAEH;;OAEG;IACH,cAAc,IAAI,IAAI,CAAC;IAEvB;;OAEG;IACH,kBAAkB,IAAI,IAAI,CAAC;IAE3B;;OAEG;IACH,gBAAgB,IAAI;QAClB,eAAe,EAAE,MAAM,CAAC;QACxB,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;KAC7B,CAAC;IAEF;;OAEG;IACH,2BAA2B,IAAI,MAAM,GAAG,IAAI,CAAC;IAM7C,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAC7C,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAClD,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,gBAAgB,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,8BAA8B,IAAI,KAAK,CAAC;QACtC,SAAS,EAAE,MAAM,CAAC;QAClB,YAAY,EAAE,MAAM,CAAC;QACrB,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC,CAAC;IAMH;;OAEG;IACH,UAAU,CACR,OAAO,EAAE,MAAM,EACf,aAAa,EAAE,MAAM,EACrB,IAAI,EAAE,MAAM,EAAE,EACd,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,IAAI,EAAE,UAAU,EAChB,YAAY,EAAE,MAAM,GAAG,SAAS,EAChC,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,EAClD,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,UAAU,EAAE,MAAM,GAAG,SAAS,GAC7B,MAAM,CAAC;IAEV;;OAEG;IACH,4BAA4B,CAC1B,SAAS,EAAE,MAAM,EAAE,EACnB,SAAS,EAAE,MAAM,EACjB,gBAAgB,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,MAAM,EACtD,kBAAkB,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,EAAE,GAC/C;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAE9D;;OAEG;IACH,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAEzC;;OAEG;IACH,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAE3C;;OAEG;IACH,4BAA4B,IAAI,KAAK,CAAC;QACpC,EAAE,EAAE,MAAM,CAAC;QACX,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;QACpB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;QACtB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;QACpB,UAAU,EAAE,MAAM,CAAC;QACnB,SAAS,EAAE,MAAM,CAAC;QAClB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;QAC7B,YAAY,EAAE,MAAM,CAAC;QACrB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;QAC1B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;KAC5B,CAAC,CAAC;IAEH;;OAEG;IACH,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC;IAE1C;;;OAGG;IACH,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;IAElC;;;OAGG;IACH,uBAAuB,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAAC;IAE5C;;;OAGG;IACH,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;IAEzC;;;OAGG;IACH,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;IAE3C;;OAEG;IACH,cAAc,IAAI;QAChB,cAAc,EAAE,MAAM,CAAC;QACvB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAChC,UAAU,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAC;YAAC,GAAG,EAAE,MAAM,CAAC;YAAC,QAAQ,EAAE,MAAM,CAAA;SAAE,CAAC;QAC5E,UAAU,EAAE,MAAM,CAAC;QACnB,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC;QACnB,kBAAkB,EAAE,MAAM,CAAC;QAC3B,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;QACjC,WAAW,EAAE,MAAM,CAAC;QACpB,oBAAoB,EAAE,MAAM,CAAC;KAC9B,CAAC;IAEF;;OAEG;IACH,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAE9D;;OAEG;IACH,0BAA0B,CAAC,QAAQ,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,IAAI,CAAC;IAExF;;OAEG;IACH,0BAA0B,IAAI,kBAAkB,EAAE,CAAC;IAMnD;;OAEG;IACH,gBAAgB,CACd,OAAO,EAAE,MAAM,EACf,aAAa,EAAE,MAAM,EACrB,IAAI,EAAE,MAAM,EAAE,EACd,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,IAAI,EAAE,UAAU,GACf,MAAM,CAAC;IAEV;;OAEG;IACH,kCAAkC,CAChC,SAAS,EAAE,MAAM,EAAE,EACnB,SAAS,EAAE,MAAM,EACjB,gBAAgB,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,MAAM,EACtD,kBAAkB,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,EAAE,GAC/C;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAE9D;;OAEG;IACH,kCAAkC,IAAI,KAAK,CAAC;QAC1C,EAAE,EAAE,MAAM,CAAC;QACX,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;QACpB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;QACtB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;QACvB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;QACpB,UAAU,EAAE,MAAM,CAAC;QACnB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC,CAAC;IAEH;;OAEG;IACH,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,EAAE,CAAC;IAEvD;;OAEG;IACH,kBAAkB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;IAExC;;OAEG;IACH,oBAAoB,IAAI;QACtB,cAAc,EAAE,MAAM,CAAC;QACvB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACnC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAChC,UAAU,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAC;YAAC,GAAG,EAAE,MAAM,CAAC;YAAC,QAAQ,EAAE,MAAM,CAAA;SAAE,CAAC;QAC5E,UAAU,EAAE,MAAM,CAAC;QACnB,SAAS,EAAE,MAAM,CAAC;QAClB,kBAAkB,EAAE,MAAM,CAAC;QAC3B,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;KAClC,CAAC;IAMF;;OAEG;IACH,gBAAgB,CACd,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,YAAY,EACtB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,UAAU,EAAE,MAAM,GAAG,SAAS,GAC7B;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IAEpC;;OAEG;IACH,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC;IAEvF;;OAEG;IACH,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG;QAChC,QAAQ,EAAE,UAAU,EAAE,CAAC;QACvB,QAAQ,EAAE,UAAU,EAAE,CAAC;KACxB,CAAC;IAEF;;OAEG;IACH,kBAAkB,CAChB,QAAQ,EAAE,MAAM,EAChB,QAAQ,CAAC,EAAE,IAAI,EACf,cAAc,CAAC,EAAE,OAAO,GACvB,eAAe,GAAG,IAAI,CAAC;IAE1B;;OAEG;IACH,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,eAAe,EAAE,CAAC;IAE7E;;OAEG;IACH,uBAAuB,CACrB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,gBAAgB,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,MAAM,EACtD,kBAAkB,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,EAAE,GAC/C,MAAM,CAAC;IAEV;;OAEG;IACH,aAAa,IAAI,UAAU,CAAC;IAE5B;;OAEG;IACH,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC;IAE3F;;OAEG;IACH,iBAAiB,CAAC,QAAQ,EAAE,IAAI,GAAG,UAAU,CAAC;IAM9C;;OAEG;IACH,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAEzD;;OAEG;IACH,gBAAgB,CACd,MAAM,EAAE,MAAM,EACd,OAAO,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,OAAO,CAAA;KAAE,GACrE,IAAI,CAAC;IAER;;OAEG;IACH,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAExF;;OAEG;IACH,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAM9D,sBAAsB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAC/C,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IACzC,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3D,kBAAkB,IAAI,MAAM,CAAC;IAC7B,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACzE,qBAAqB,IAAI,IAAI,CAAC;IAC9B,sBAAsB,IAAI;QACxB,aAAa,EAAE,MAAM,CAAC;QACtB,eAAe,EAAE,MAAM,CAAC;QACxB,aAAa,EAAE,MAAM,CAAC;KACvB,CAAC;IAMF,eAAe,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI,CAAC;IAC/C,uBAAuB,IAAI,oBAAoB,EAAE,CAAC;IAClD,oBAAoB,IAAI;QACtB,WAAW,EAAE,MAAM,CAAC;QACpB,qBAAqB,EAAE,MAAM,CAAC;QAC9B,wBAAwB,EAAE,MAAM,CAAC;QACjC,oBAAoB,EAAE,MAAM,CAAC;QAC7B,oBAAoB,EAAE,MAAM,CAAC;QAC7B,eAAe,EAAE,MAAM,CAAC;QACxB,aAAa,EAAE,oBAAoB,EAAE,CAAC;KACvC,CAAC;IACF,eAAe,IAAI,IAAI,CAAC;IAMxB,eAAe,CAAC,MAAM,EAAE,qBAAqB,GAAG,MAAM,CAAC;IACvD,mBAAmB,CAAC,MAAM,EAAE,sBAAsB,GAAG,sBAAsB,EAAE,CAAC;IAC9E,mBAAmB,IAAI,uBAAuB,CAAC;IAC/C,sBAAsB,IAAI,MAAM,CAAC;IACjC,qBAAqB,IAAI,IAAI,CAAC;IAM9B,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IACzC,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACpD,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAMnC,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IACxC,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAM9C;;;;OAIG;IACH,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;CAChC"}

package/dist/lib/storage/backends/interface.js

@@ -0,0 +1,12 @@
+/**
+ * StorageBackend interface for abstracting SQL database operations.
+ *
+ * Implementations:
+ * - SQLite (better-sqlite3)
+ * - PostgreSQL (pg)
+ *
+ * Note: Vector operations are handled by VectorStore interface separately.
+ * This interface focuses on SQL/relational operations.
+ */
+export {};
+//# sourceMappingURL=interface.js.map

package/dist/lib/storage/backends/interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interface.js","sourceRoot":"","sources":["../../../../src/lib/storage/backends/interface.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}