@blackms/aistack 1.0.0

package/dist/memory/fts-search.js

@@ -0,0 +1,136 @@
+/**
+ * Full-text search using SQLite FTS5
+ */
+export class FTSSearch {
+    db;
+    constructor(db) {
+        this.db = db;
+    }
+    /**
+     * Search memory using FTS5 full-text search
+     */
+    search(query, options = {}) {
+        const { namespace, limit = 10, highlightStart = '<b>', highlightEnd = '</b>', } = options;
+        // Escape FTS5 special characters in query
+        const escapedQuery = this.escapeFTSQuery(query);
+        let sql = `
+      SELECT
+        m.id, m.key, m.namespace, m.content, m.embedding, m.metadata,
+        m.created_at, m.updated_at,
+        bm25(memory_fts) as rank,
+        snippet(memory_fts, 1, ?, ?, '...', 32) as snippet
+      FROM memory_fts fts
+      JOIN memory m ON m.rowid = fts.rowid
+      WHERE memory_fts MATCH ?
+    `;
+        const params = [highlightStart, highlightEnd, escapedQuery];
+        if (namespace) {
+            sql += ' AND m.namespace = ?';
+            params.push(namespace);
+        }
+        sql += ' ORDER BY rank LIMIT ?';
+        params.push(limit);
+        const rows = this.db.prepare(sql).all(...params);
+        return rows.map(row => ({
+            entry: this.rowToEntry(row),
+            score: this.normalizeScore(row.rank),
+            matchType: 'fts',
+        }));
+    }
+    /**
+     * Search with phrase matching (exact phrase)
+     */
+    phraseSearch(phrase, options = {}) {
+        // Wrap in quotes for exact phrase match
+        const query = `"${phrase.replace(/"/g, '""')}"`;
+        return this.search(query, options);
+    }
+    /**
+     * Search with prefix matching (autocomplete)
+     */
+    prefixSearch(prefix, options = {}) {
+        // Add * for prefix matching
+        const query = prefix
+            .split(/\s+/)
+            .filter(term => term.length > 0)
+            .map(term => `${term}*`)
+            .join(' ');
+        return this.search(query, options);
+    }
+    /**
+     * Check if a term exists in the index
+     */
+    termExists(term, namespace) {
+        let sql = `
+      SELECT 1 FROM memory_fts fts
+      JOIN memory m ON m.rowid = fts.rowid
+      WHERE memory_fts MATCH ?
+    `;
+        const params = [this.escapeFTSQuery(term)];
+        if (namespace) {
+            sql += ' AND m.namespace = ?';
+            params.push(namespace);
+        }
+        sql += ' LIMIT 1';
+        const result = this.db.prepare(sql).get(...params);
+        return result !== undefined;
+    }
+    /**
+     * Get suggestions based on existing content
+     */
+    suggest(partial, limit = 5) {
+        const results = this.prefixSearch(partial, { limit });
+        const suggestions = new Set();
+        for (const result of results) {
+            // Extract matching terms from content
+            const words = result.entry.content.toLowerCase().split(/\s+/);
+            for (const word of words) {
+                if (word.startsWith(partial.toLowerCase()) && word.length > partial.length) {
+                    suggestions.add(word);
+                    if (suggestions.size >= limit)
+                        break;
+                }
+            }
+            if (suggestions.size >= limit)
+                break;
+        }
+        return Array.from(suggestions);
+    }
+    /**
+     * Escape special FTS5 characters in query
+     */
+    escapeFTSQuery(query) {
+        // FTS5 special characters: " - ^ * ( ) { } [ ] | : AND OR NOT NEAR
+        // We want to allow basic search, so we escape problematic characters
+        return query
+            .replace(/"/g, '""') // Escape double quotes
+            .replace(/[(){}[\]|:^]/g, ' ') // Replace special chars with spaces
+            .replace(/\s+/g, ' ') // Normalize whitespace
+            .trim();
+    }
+    /**
+     * Normalize BM25 score to 0-1 range
+     * BM25 returns negative values where more negative = better match
+     */
+    normalizeScore(bm25Score) {
+        // Convert BM25 to a positive score
+        // BM25 values typically range from -25 to 0 for good matches
+        const normalized = Math.min(1, Math.max(0, 1 + bm25Score / 25));
+        return Math.round(normalized * 1000) / 1000; // Round to 3 decimal places
+    }
+    rowToEntry(row) {
+        return {
+            id: row.id,
+            key: row.key,
+            namespace: row.namespace,
+            content: row.content,
+            embedding: row.embedding
+                ? new Float32Array(row.embedding.buffer)
+                : undefined,
+            metadata: row.metadata ? JSON.parse(row.metadata) : undefined,
+            createdAt: new Date(row.created_at),
+            updatedAt: new Date(row.updated_at),
+        };
+    }
+}
+//# sourceMappingURL=fts-search.js.map

package/dist/memory/fts-search.js.map

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

package/dist/memory/index.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Memory module - unified interface for storage and search
+ */
+import type { MemoryEntry, MemorySearchResult, MemoryStoreOptions, MemorySearchOptions, AgentStackConfig, Session, Task } from '../types.js';
+export declare class MemoryManager {
+    private sqliteStore;
+    private fts;
+    private vector;
+    private config;
+    constructor(config: AgentStackConfig);
+    /**
+     * Store a key-value pair in memory
+     */
+    store(key: string, content: string, options?: MemoryStoreOptions): Promise<MemoryEntry>;
+    /**
+     * Get a memory entry by key
+     */
+    get(key: string, namespace?: string): MemoryEntry | null;
+    /**
+     * Get a memory entry by ID
+     */
+    getById(id: string): MemoryEntry | null;
+    /**
+     * Delete a memory entry
+     */
+    delete(key: string, namespace?: string): boolean;
+    /**
+     * List memory entries
+     */
+    list(namespace?: string, limit?: number, offset?: number): MemoryEntry[];
+    /**
+     * Count memory entries
+     */
+    count(namespace?: string): number;
+    /**
+     * Search memory using FTS and optionally vector search
+     */
+    search(query: string, options?: MemorySearchOptions): Promise<MemorySearchResult[]>;
+    /**
+     * Merge and deduplicate search results from different sources
+     */
+    private mergeResults;
+    createSession(metadata?: Record<string, unknown>): Session;
+    getSession(id: string): Session | null;
+    endSession(id: string): boolean;
+    getActiveSession(): Session | null;
+    createTask(agentType: string, input?: string, sessionId?: string): Task;
+    getTask(id: string): Task | null;
+    updateTaskStatus(id: string, status: Task['status'], output?: string): boolean;
+    listTasks(sessionId?: string, status?: Task['status']): Task[];
+    /**
+     * Reindex all entries for vector search
+     */
+    reindex(namespace?: string): Promise<number>;
+    /**
+     * Get vector search statistics
+     */
+    getVectorStats(namespace?: string): {
+        total: number;
+        indexed: number;
+        coverage: number;
+    };
+    close(): void;
+    vacuum(): void;
+}
+export { SQLiteStore } from './sqlite-store.js';
+export { FTSSearch } from './fts-search.js';
+export { VectorSearch } from './vector-search.js';
+/**
+ * Get or create the memory manager instance
+ */
+export declare function getMemoryManager(config?: AgentStackConfig): MemoryManager;
+/**
+ * Reset the memory manager instance
+ */
+export declare function resetMemoryManager(): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/memory/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/memory/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACV,WAAW,EACX,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,gBAAgB,EAChB,OAAO,EACP,IAAI,EACL,MAAM,aAAa,CAAC;AAQrB,qBAAa,aAAa;IACxB,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,GAAG,CAAY;IACvB,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,MAAM,CAAmB;gBAErB,MAAM,EAAE,gBAAgB;IAepC;;OAEG;IACG,KAAK,CACT,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,WAAW,CAAC;IAavB;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI;IAIxD;;OAEG;IACH,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI;IAIvC;;OAEG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO;IAIhD;;OAEG;IACH,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,WAAW,EAAE;IAIxE;;OAEG;IACH,KAAK,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM;IAIjC;;OAEG;IACG,MAAM,CACV,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAqChC;;OAEG;IACH,OAAO,CAAC,YAAY;IA6BpB,aAAa,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO;IAI1D,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI;IAItC,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAI/B,gBAAgB,IAAI,OAAO,GAAG,IAAI;IAMlC,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI;IAIvE,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAIhC,gBAAgB,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO;IAI9E,SAAS,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,IAAI,CAAC,QAAQ,CAAC,GAAG,IAAI,EAAE;IAM9D;;OAEG;IACG,OAAO,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAUlD;;OAEG;IACH,cAAc,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE;IAMxF,KAAK,IAAI,IAAI;IAKb,MAAM,IAAI,IAAI;CAGf;AAGD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAKlD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,CAAC,EAAE,gBAAgB,GAAG,aAAa,CAQzE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAKzC"}

package/dist/memory/index.js

@@ -0,0 +1,203 @@
+/**
+ * Memory module - unified interface for storage and search
+ */
+import { SQLiteStore } from './sqlite-store.js';
+import { FTSSearch } from './fts-search.js';
+import { VectorSearch } from './vector-search.js';
+import { logger } from '../utils/logger.js';
+const log = logger.child('memory');
+export class MemoryManager {
+    sqliteStore;
+    fts;
+    vector;
+    config;
+    constructor(config) {
+        this.config = config;
+        this.sqliteStore = new SQLiteStore(config.memory.path);
+        // @ts-expect-error - accessing internal db for FTS
+        this.fts = new FTSSearch(this.sqliteStore.db);
+        this.vector = new VectorSearch(this.sqliteStore, config);
+        log.info('Memory manager initialized', {
+            path: config.memory.path,
+            vectorEnabled: this.vector.isEnabled(),
+        });
+    }
+    // ==================== Memory Operations ====================
+    /**
+     * Store a key-value pair in memory
+     */
+    async store(key, content, options = {}) {
+        const namespace = options.namespace ?? this.config.memory.defaultNamespace;
+        const entry = this.sqliteStore.store(key, content, { ...options, namespace });
+        // Index for vector search if enabled
+        if (options.generateEmbedding !== false && this.vector.isEnabled()) {
+            await this.vector.indexEntry(entry);
+        }
+        log.debug('Stored memory entry', { key, namespace });
+        return entry;
+    }
+    /**
+     * Get a memory entry by key
+     */
+    get(key, namespace) {
+        return this.sqliteStore.get(key, namespace ?? this.config.memory.defaultNamespace);
+    }
+    /**
+     * Get a memory entry by ID
+     */
+    getById(id) {
+        return this.sqliteStore.getById(id);
+    }
+    /**
+     * Delete a memory entry
+     */
+    delete(key, namespace) {
+        return this.sqliteStore.delete(key, namespace ?? this.config.memory.defaultNamespace);
+    }
+    /**
+     * List memory entries
+     */
+    list(namespace, limit, offset) {
+        return this.sqliteStore.list(namespace, limit, offset);
+    }
+    /**
+     * Count memory entries
+     */
+    count(namespace) {
+        return this.sqliteStore.count(namespace);
+    }
+    /**
+     * Search memory using FTS and optionally vector search
+     */
+    async search(query, options = {}) {
+        const { namespace, limit = 10, threshold = 0.7, useVector } = options;
+        // Decide whether to use vector search
+        const shouldUseVector = useVector ?? this.vector.isEnabled();
+        let results = [];
+        // Try vector search first if enabled
+        if (shouldUseVector && this.vector.isEnabled()) {
+            const vectorResults = await this.vector.search(query, {
+                namespace,
+                limit,
+                threshold,
+            });
+            results = vectorResults;
+        }
+        // If no vector results or vector disabled, use FTS
+        if (results.length === 0) {
+            results = this.fts.search(query, { namespace, limit });
+        }
+        // If we have both, merge and deduplicate
+        if (shouldUseVector && this.vector.isEnabled() && results.length > 0) {
+            const ftsResults = this.fts.search(query, { namespace, limit });
+            results = this.mergeResults(results, ftsResults, limit);
+        }
+        log.debug('Search completed', {
+            query: query.slice(0, 50),
+            results: results.length,
+        });
+        return results;
+    }
+    /**
+     * Merge and deduplicate search results from different sources
+     */
+    mergeResults(vectorResults, ftsResults, limit) {
+        const seen = new Set();
+        const merged = [];
+        // Add vector results first (higher quality)
+        for (const result of vectorResults) {
+            if (!seen.has(result.entry.id)) {
+                seen.add(result.entry.id);
+                merged.push(result);
+            }
+        }
+        // Add FTS results that weren't in vector results
+        for (const result of ftsResults) {
+            if (!seen.has(result.entry.id) && merged.length < limit) {
+                seen.add(result.entry.id);
+                merged.push(result);
+            }
+        }
+        return merged.slice(0, limit);
+    }
+    // ==================== Session Operations ====================
+    createSession(metadata) {
+        return this.sqliteStore.createSession(metadata);
+    }
+    getSession(id) {
+        return this.sqliteStore.getSession(id);
+    }
+    endSession(id) {
+        return this.sqliteStore.endSession(id);
+    }
+    getActiveSession() {
+        return this.sqliteStore.getActiveSession();
+    }
+    // ==================== Task Operations ====================
+    createTask(agentType, input, sessionId) {
+        return this.sqliteStore.createTask(agentType, input, sessionId);
+    }
+    getTask(id) {
+        return this.sqliteStore.getTask(id);
+    }
+    updateTaskStatus(id, status, output) {
+        return this.sqliteStore.updateTaskStatus(id, status, output);
+    }
+    listTasks(sessionId, status) {
+        return this.sqliteStore.listTasks(sessionId, status);
+    }
+    // ==================== Vector Search ====================
+    /**
+     * Reindex all entries for vector search
+     */
+    async reindex(namespace) {
+        if (!this.vector.isEnabled()) {
+            log.warn('Vector search not enabled');
+            return 0;
+        }
+        const entries = this.sqliteStore.list(namespace, 10000);
+        return this.vector.indexBatch(entries);
+    }
+    /**
+     * Get vector search statistics
+     */
+    getVectorStats(namespace) {
+        return this.vector.getStats(namespace);
+    }
+    // ==================== Cleanup ====================
+    close() {
+        this.sqliteStore.close();
+        log.info('Memory manager closed');
+    }
+    vacuum() {
+        this.sqliteStore.vacuum();
+    }
+}
+// Export components
+export { SQLiteStore } from './sqlite-store.js';
+export { FTSSearch } from './fts-search.js';
+export { VectorSearch } from './vector-search.js';
+// Singleton instance
+let instance = null;
+/**
+ * Get or create the memory manager instance
+ */
+export function getMemoryManager(config) {
+    if (!instance) {
+        if (!config) {
+            throw new Error('Configuration required to initialize memory manager');
+        }
+        instance = new MemoryManager(config);
+    }
+    return instance;
+}
+/**
+ * Reset the memory manager instance
+ */
+export function resetMemoryManager() {
+    if (instance) {
+        instance.close();
+        instance = null;
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/memory/index.js.map

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

package/dist/memory/sqlite-store.d.ts

@@ -0,0 +1,36 @@
+/**
+ * SQLite-based memory store with FTS5 full-text search
+ */
+import type { MemoryEntry, MemoryStoreOptions, Session, Task } from '../types.js';
+export declare class SQLiteStore {
+    private db;
+    private readonly dbPath;
+    constructor(dbPath: string);
+    private initSchema;
+    store(key: string, content: string, options?: MemoryStoreOptions): MemoryEntry;
+    get(key: string, namespace?: string): MemoryEntry | null;
+    getById(id: string): MemoryEntry | null;
+    delete(key: string, namespace?: string): boolean;
+    deleteById(id: string): boolean;
+    list(namespace?: string, limit?: number, offset?: number): MemoryEntry[];
+    count(namespace?: string): number;
+    storeEmbedding(id: string, embedding: number[]): void;
+    getEntriesWithEmbeddings(namespace?: string): Array<{
+        id: string;
+        embedding: number[];
+    }>;
+    private rowToEntry;
+    createSession(metadata?: Record<string, unknown>): Session;
+    getSession(id: string): Session | null;
+    endSession(id: string): boolean;
+    getActiveSession(): Session | null;
+    private rowToSession;
+    createTask(agentType: string, input?: string, sessionId?: string): Task;
+    getTask(id: string): Task | null;
+    updateTaskStatus(id: string, status: Task['status'], output?: string): boolean;
+    listTasks(sessionId?: string, status?: Task['status']): Task[];
+    private rowToTask;
+    close(): void;
+    vacuum(): void;
+}
+//# sourceMappingURL=sqlite-store.d.ts.map

package/dist/memory/sqlite-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-store.d.ts","sourceRoot":"","sources":["../../src/memory/sqlite-store.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,OAAO,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAsFlF,qBAAa,WAAW;IACtB,OAAO,CAAC,EAAE,CAAoB;IAC9B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAEpB,MAAM,EAAE,MAAM;IAiB1B,OAAO,CAAC,UAAU;IAMlB,KAAK,CACH,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,kBAAuB,GAC/B,WAAW;IA0Cd,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,GAAE,MAAkB,GAAG,WAAW,GAAG,IAAI;IAYnE,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI;IAYvC,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,GAAE,MAAkB,GAAG,OAAO;IAQ3D,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAQ/B,IAAI,CACF,SAAS,CAAC,EAAE,MAAM,EAClB,KAAK,GAAE,MAAY,EACnB,MAAM,GAAE,MAAU,GACjB,WAAW,EAAE;IAmBhB,KAAK,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM;IAcjC,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,IAAI;IAQrD,wBAAwB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAqBxF,OAAO,CAAC,UAAU;IAiBlB,aAAa,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO;IAoB1D,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI;IAQtC,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAY/B,gBAAgB,IAAI,OAAO,GAAG,IAAI;IAalC,OAAO,CAAC,YAAY;IAYpB,UAAU,CACR,SAAS,EAAE,MAAM,EACjB,KAAK,CAAC,EAAE,MAAM,EACd,SAAS,CAAC,EAAE,MAAM,GACjB,IAAI;IAqBP,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAQhC,gBAAgB,CACd,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,EACtB,MAAM,CAAC,EAAE,MAAM,GACd,OAAO;IAcV,SAAS,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,IAAI,CAAC,QAAQ,CAAC,GAAG,IAAI,EAAE;IAoB9D,OAAO,CAAC,SAAS;IAejB,KAAK,IAAI,IAAI;IAKb,MAAM,IAAI,IAAI;CAIf"}