universal-agent-protocol 0.5.0

package/dist/memory/short-term/schema.js

@@ -0,0 +1,119 @@
+import Database from 'better-sqlite3';
+import { existsSync, mkdirSync } from 'fs';
+import { dirname } from 'path';
+export function ensureShortTermSchema(db) {
+    db.exec(`
+    CREATE TABLE IF NOT EXISTS memories (
+      id INTEGER PRIMARY KEY AUTOINCREMENT,
+      timestamp TEXT NOT NULL,
+      type TEXT NOT NULL CHECK(type IN ('action', 'observation', 'thought', 'goal')),
+      content TEXT NOT NULL,
+      project_id TEXT NOT NULL DEFAULT 'default',
+      importance INTEGER NOT NULL DEFAULT 5
+    );
+    CREATE INDEX IF NOT EXISTS idx_memories_project_id ON memories(project_id);
+    CREATE INDEX IF NOT EXISTS idx_memories_timestamp ON memories(timestamp);
+    CREATE INDEX IF NOT EXISTS idx_memories_type ON memories(type);
+    CREATE INDEX IF NOT EXISTS idx_memories_project_type ON memories(project_id, type);
+  `);
+    // Migration: add importance column if missing (for existing databases created before importance was added)
+    try {
+        const cols = db.prepare("PRAGMA table_info(memories)").all();
+        if (!cols.some(c => c.name === 'importance')) {
+            db.exec(`ALTER TABLE memories ADD COLUMN importance INTEGER NOT NULL DEFAULT 5`);
+        }
+    }
+    catch {
+        // Ignore migration errors - column may already exist
+    }
+    // Create importance index after migration ensures column exists
+    db.exec(`CREATE INDEX IF NOT EXISTS idx_memories_importance ON memories(importance DESC)`);
+    // Enable WAL mode for concurrent reads and better write performance
+    db.pragma('journal_mode = WAL');
+    db.pragma('synchronous = NORMAL');
+    db.pragma('mmap_size = 268435456');
+    db.pragma('cache_size = -64000');
+    // Create FTS5 virtual table for full-text search
+    db.exec(`
+    CREATE VIRTUAL TABLE IF NOT EXISTS memories_fts USING fts5(
+      content,
+      type,
+      content_rowid=id,
+      tokenize='porter unicode61'
+    );
+  `);
+    // Populate FTS if empty but memories exist
+    const ftsCount = db.prepare('SELECT COUNT(*) as c FROM memories_fts').get().c;
+    const memCount = db.prepare('SELECT COUNT(*) as c FROM memories').get().c;
+    if (ftsCount === 0 && memCount > 0) {
+        db.exec(`
+      INSERT INTO memories_fts(rowid, content, type)
+      SELECT id, content, type FROM memories;
+    `);
+    }
+}
+export function ensureSessionSchema(db) {
+    db.exec(`
+    CREATE TABLE IF NOT EXISTS session_memories (
+      id INTEGER PRIMARY KEY AUTOINCREMENT,
+      session_id TEXT NOT NULL,
+      timestamp TEXT NOT NULL,
+      type TEXT NOT NULL,
+      content TEXT NOT NULL,
+      importance INTEGER DEFAULT 5
+    );
+    CREATE UNIQUE INDEX IF NOT EXISTS idx_session_unique ON session_memories(session_id, content);
+    CREATE INDEX IF NOT EXISTS idx_session_id ON session_memories(session_id);
+    CREATE INDEX IF NOT EXISTS idx_session_timestamp ON session_memories(timestamp);
+    CREATE INDEX IF NOT EXISTS idx_session_importance ON session_memories(importance DESC);
+    CREATE INDEX IF NOT EXISTS idx_session_id_importance ON session_memories(session_id, importance DESC);
+  `);
+    // Create FTS5 for session memories
+    db.exec(`
+    CREATE VIRTUAL TABLE IF NOT EXISTS session_memories_fts USING fts5(
+      content,
+      type,
+      content_rowid=id,
+      tokenize='porter unicode61'
+    );
+  `);
+}
+export function ensureKnowledgeSchema(db) {
+    db.exec(`
+    CREATE TABLE IF NOT EXISTS entities (
+      id INTEGER PRIMARY KEY AUTOINCREMENT,
+      type TEXT NOT NULL,
+      name TEXT NOT NULL,
+      first_seen TEXT NOT NULL,
+      last_seen TEXT NOT NULL,
+      mention_count INTEGER NOT NULL DEFAULT 1,
+      UNIQUE(type, name)
+    );
+    CREATE INDEX IF NOT EXISTS idx_entities_type ON entities(type);
+
+    CREATE TABLE IF NOT EXISTS relationships (
+      id INTEGER PRIMARY KEY AUTOINCREMENT,
+      source_id INTEGER NOT NULL,
+      target_id INTEGER NOT NULL,
+      relation TEXT NOT NULL,
+      timestamp TEXT NOT NULL,
+      UNIQUE(source_id, target_id, relation),
+      FOREIGN KEY (source_id) REFERENCES entities(id),
+      FOREIGN KEY (target_id) REFERENCES entities(id)
+    );
+    CREATE INDEX IF NOT EXISTS idx_relationships_source ON relationships(source_id);
+    CREATE INDEX IF NOT EXISTS idx_relationships_target ON relationships(target_id);
+  `);
+}
+export function initializeMemoryDatabase(dbPath) {
+    const dir = dirname(dbPath);
+    if (!existsSync(dir)) {
+        mkdirSync(dir, { recursive: true });
+    }
+    const db = new Database(dbPath);
+    ensureShortTermSchema(db);
+    ensureSessionSchema(db);
+    ensureKnowledgeSchema(db);
+    db.close();
+}
+//# sourceMappingURL=schema.js.map

package/dist/memory/short-term/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../src/memory/short-term/schema.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AACtC,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AAC3C,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAE/B,MAAM,UAAU,qBAAqB,CAAC,EAAqB;IACzD,EAAE,CAAC,IAAI,CAAC;;;;;;;;;;;;;GAaP,CAAC,CAAC;IAEH,2GAA2G;IAC3G,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,EAAE,CAAC,OAAO,CAAC,6BAA6B,CAAC,CAAC,GAAG,EAA6B,CAAC;QACxF,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,YAAY,CAAC,EAAE,CAAC;YAC7C,EAAE,CAAC,IAAI,CAAC,uEAAuE,CAAC,CAAC;QACnF,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,qDAAqD;IACvD,CAAC;IAED,gEAAgE;IAChE,EAAE,CAAC,IAAI,CAAC,iFAAiF,CAAC,CAAC;IAE3F,oEAAoE;IACpE,EAAE,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC;IAChC,EAAE,CAAC,MAAM,CAAC,sBAAsB,CAAC,CAAC;IAClC,EAAE,CAAC,MAAM,CAAC,uBAAuB,CAAC,CAAC;IACnC,EAAE,CAAC,MAAM,CAAC,qBAAqB,CAAC,CAAC;IAEjC,iDAAiD;IACjD,EAAE,CAAC,IAAI,CAAC;;;;;;;GAOP,CAAC,CAAC;IAEH,2CAA2C;IAC3C,MAAM,QAAQ,GAAI,EAAE,CAAC,OAAO,CAAC,wCAAwC,CAAC,CAAC,GAAG,EAAoB,CAAC,CAAC,CAAC;IACjG,MAAM,QAAQ,GAAI,EAAE,CAAC,OAAO,CAAC,oCAAoC,CAAC,CAAC,GAAG,EAAoB,CAAC,CAAC,CAAC;IAC7F,IAAI,QAAQ,KAAK,CAAC,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;QACnC,EAAE,CAAC,IAAI,CAAC;;;KAGP,CAAC,CAAC;IACL,CAAC;AACH,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,EAAqB;IACvD,EAAE,CAAC,IAAI,CAAC;;;;;;;;;;;;;;GAcP,CAAC,CAAC;IAEH,mCAAmC;IACnC,EAAE,CAAC,IAAI,CAAC;;;;;;;GAOP,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,EAAqB;IACzD,EAAE,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;;;;;;;;;GAwBP,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,MAAc;IACrD,MAAM,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC5B,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACrB,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACtC,CAAC;IAED,MAAM,EAAE,GAAG,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAC;IAChC,qBAAqB,CAAC,EAAE,CAAC,CAAC;IAC1B,mBAAmB,CAAC,EAAE,CAAC,CAAC;IACxB,qBAAqB,CAAC,EAAE,CAAC,CAAC;IAC1B,EAAE,CAAC,KAAK,EAAE,CAAC;AACb,CAAC"}

package/dist/memory/short-term/sqlite.d.ts

@@ -0,0 +1,50 @@
+import type { ShortTermMemoryBackend } from './factory.js';
+interface ShortTermMemory {
+    id?: number;
+    timestamp: string;
+    type: 'action' | 'observation' | 'thought' | 'goal';
+    content: string;
+    projectId?: string;
+    importance?: number;
+}
+export declare class SQLiteShortTermMemory implements ShortTermMemoryBackend {
+    private db;
+    private projectId;
+    private maxEntries;
+    private cache;
+    constructor(config: {
+        dbPath: string;
+        projectId?: string;
+        maxEntries?: number;
+    });
+    private initSchema;
+    store(type: ShortTermMemory['type'], content: string, importance?: number): Promise<void>;
+    storeBatch(entries: Array<{
+        type: ShortTermMemory['type'];
+        content: string;
+        timestamp?: string;
+        importance?: number;
+    }>): Promise<void>;
+    getRecent(limit?: number): Promise<ShortTermMemory[]>;
+    query(searchTerm: string, limit?: number): Promise<ShortTermMemory[]>;
+    /**
+     * Sanitize search term for FTS5 query syntax
+     * Wraps each word in double quotes to prevent FTS5 syntax errors from
+     * special characters like AND, OR, NOT, *, -, parentheses, etc.
+     */
+    private sanitizeFTS5Query;
+    private queryWithoutCache;
+    getByType(type: ShortTermMemory['type'], limit?: number): Promise<ShortTermMemory[]>;
+    count(): Promise<number>;
+    private prune;
+    clear(): Promise<void>;
+    close(): Promise<void>;
+    exportAll(): Promise<ShortTermMemory[]>;
+    importAll(memories: Array<{
+        type: ShortTermMemory['type'];
+        content: string;
+        timestamp?: string;
+    }>): Promise<number>;
+}
+export {};
+//# sourceMappingURL=sqlite.d.ts.map

package/dist/memory/short-term/sqlite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite.d.ts","sourceRoot":"","sources":["../../../src/memory/short-term/sqlite.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAE3D,UAAU,eAAe;IACvB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,QAAQ,GAAG,aAAa,GAAG,SAAS,GAAG,MAAM,CAAC;IACpD,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,qBAAa,qBAAsB,YAAW,sBAAsB;IAClE,OAAO,CAAC,EAAE,CAAoB;IAC9B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,KAAK,CAAgF;gBAEjF,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE;IAe/E,OAAO,CAAC,UAAU;IAIZ,KAAK,CAAC,IAAI,EAAE,eAAe,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,GAAE,MAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAuB5F,UAAU,CACd,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,eAAe,CAAC,MAAM,CAAC,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,GAC1G,OAAO,CAAC,IAAI,CAAC;IAuBV,SAAS,CAAC,KAAK,SAAK,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAWjD,KAAK,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAwDvE;;;;OAIG;IACH,OAAO,CAAC,iBAAiB;YAOX,iBAAiB;IA2BzB,SAAS,CAAC,IAAI,EAAE,eAAe,CAAC,MAAM,CAAC,EAAE,KAAK,SAAK,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAWhF,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC;YAUhB,KAAK;IAmBb,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAQtB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAKtB,SAAS,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;IAWvC,SAAS,CACb,QAAQ,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,eAAe,CAAC,MAAM,CAAC,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,GACtF,OAAO,CAAC,MAAM,CAAC;CAInB"}

package/dist/memory/short-term/sqlite.js

@@ -0,0 +1,221 @@
+import Database from 'better-sqlite3';
+import { existsSync, mkdirSync } from 'fs';
+import { dirname } from 'path';
+import { ensureShortTermSchema } from './schema.js';
+import { getSpeculativeCache } from '../speculative-cache.js';
+export class SQLiteShortTermMemory {
+    db;
+    projectId;
+    maxEntries;
+    cache = getSpeculativeCache({ maxEntries: 50, ttlMs: 120000, preWarmEnabled: true });
+    constructor(config) {
+        // Ensure directory exists
+        const dir = dirname(config.dbPath);
+        if (!existsSync(dir)) {
+            mkdirSync(dir, { recursive: true });
+        }
+        this.db = new Database(config.dbPath);
+        this.projectId = config.projectId || 'default';
+        this.maxEntries = config.maxEntries || 50;
+        // Initialize schema
+        this.initSchema();
+    }
+    initSchema() {
+        ensureShortTermSchema(this.db);
+    }
+    async store(type, content, importance = 5) {
+        const timestamp = new Date().toISOString();
+        const stmt = this.db.prepare(`
+      INSERT INTO memories (timestamp, type, content, project_id, importance)
+      VALUES (?, ?, ?, ?, ?)
+    `);
+        const result = stmt.run(timestamp, type, content, this.projectId, importance);
+        // Update FTS5 index
+        try {
+            const ftsStmt = this.db.prepare(`
+        INSERT INTO memories_fts(rowid, content, type)
+        VALUES (?, ?, ?)
+      `);
+            ftsStmt.run(result.lastInsertRowid, content, type);
+        }
+        catch {
+            // FTS5 not available, ignore
+        }
+        // Auto-prune if exceeds maxEntries
+        await this.prune();
+    }
+    async storeBatch(entries) {
+        const stmt = this.db.prepare(`
+      INSERT INTO memories (timestamp, type, content, project_id, importance)
+      VALUES (?, ?, ?, ?, ?)
+    `);
+        const insertMany = this.db.transaction((items) => {
+            for (const entry of items) {
+                stmt.run(entry.timestamp || new Date().toISOString(), entry.type, entry.content, this.projectId, entry.importance ?? 5);
+            }
+        });
+        insertMany(entries);
+        await this.prune();
+    }
+    async getRecent(limit = 50) {
+        const stmt = this.db.prepare(`
+      SELECT id, timestamp, type, content, project_id as projectId, importance
+      FROM memories
+      WHERE project_id = ?
+      ORDER BY id DESC
+      LIMIT ?
+    `);
+        return stmt.all(this.projectId, limit);
+    }
+    async query(searchTerm, limit = 10) {
+        // Check speculative cache first
+        const cacheKey = `${this.projectId}:${searchTerm}:${limit}`;
+        const cached = this.cache.get(cacheKey);
+        if (cached) {
+            return cached.result;
+        }
+        let results = [];
+        // Sanitize search term for FTS5 - escape special characters and wrap in quotes
+        // FTS5 special chars: AND OR NOT * " - ( ) NEAR
+        const sanitizedTerm = this.sanitizeFTS5Query(searchTerm);
+        // Try FTS5 first for faster full-text search
+        try {
+            const ftsStmt = this.db.prepare(`
+        SELECT m.id, m.timestamp, m.type, m.content, m.project_id as projectId, m.importance
+        FROM memories_fts fts
+        JOIN memories m ON fts.rowid = m.id
+        WHERE memories_fts MATCH ? AND m.project_id = ?
+        ORDER BY rank
+        LIMIT ?
+      `);
+            results = ftsStmt.all(sanitizedTerm, this.projectId, limit);
+        }
+        catch {
+            // FTS5 not available or query syntax error, fall through to LIKE
+        }
+        // Fallback to LIKE search if FTS5 returned nothing
+        if (results.length === 0) {
+            const stmt = this.db.prepare(`
+        SELECT id, timestamp, type, content, project_id as projectId, importance
+        FROM memories
+        WHERE project_id = ? AND content LIKE ?
+        ORDER BY id DESC
+        LIMIT ?
+      `);
+            results = stmt.all(this.projectId, `%${searchTerm}%`, limit);
+        }
+        // Store in cache
+        this.cache.set(cacheKey, results);
+        // Pre-warm cache for predicted next queries
+        this.cache.preWarm(searchTerm, async (q) => {
+            const predictedKey = `${this.projectId}:${q}:${limit}`;
+            if (!this.cache.get(predictedKey)) {
+                return this.queryWithoutCache(q, limit);
+            }
+            return [];
+        }).catch(() => { });
+        return results;
+    }
+    /**
+     * Sanitize search term for FTS5 query syntax
+     * Wraps each word in double quotes to prevent FTS5 syntax errors from
+     * special characters like AND, OR, NOT, *, -, parentheses, etc.
+     */
+    sanitizeFTS5Query(searchTerm) {
+        const words = searchTerm.trim().split(/\s+/).filter(w => w.length > 0);
+        if (words.length === 0)
+            return '""';
+        // Quote each word individually and join with spaces (implicit AND)
+        return words.map(w => `"${w.replace(/"/g, '""')}"`).join(' ');
+    }
+    async queryWithoutCache(searchTerm, limit) {
+        const sanitizedTerm = this.sanitizeFTS5Query(searchTerm);
+        try {
+            const ftsStmt = this.db.prepare(`
+        SELECT m.id, m.timestamp, m.type, m.content, m.project_id as projectId, m.importance
+        FROM memories_fts fts
+        JOIN memories m ON fts.rowid = m.id
+        WHERE memories_fts MATCH ? AND m.project_id = ?
+        ORDER BY rank
+        LIMIT ?
+      `);
+            const results = ftsStmt.all(sanitizedTerm, this.projectId, limit);
+            if (results.length > 0)
+                return results;
+        }
+        catch {
+            // FTS5 not available
+        }
+        const stmt = this.db.prepare(`
+      SELECT id, timestamp, type, content, project_id as projectId, importance
+      FROM memories
+      WHERE project_id = ? AND content LIKE ?
+      ORDER BY id DESC
+      LIMIT ?
+    `);
+        return stmt.all(this.projectId, `%${searchTerm}%`, limit);
+    }
+    async getByType(type, limit = 50) {
+        const stmt = this.db.prepare(`
+      SELECT id, timestamp, type, content, project_id as projectId, importance
+      FROM memories
+      WHERE project_id = ? AND type = ?
+      ORDER BY id DESC
+      LIMIT ?
+    `);
+        return stmt.all(this.projectId, type, limit);
+    }
+    async count() {
+        const stmt = this.db.prepare(`
+      SELECT COUNT(*) as count
+      FROM memories
+      WHERE project_id = ?
+    `);
+        const result = stmt.get(this.projectId);
+        return result.count;
+    }
+    async prune() {
+        const count = await this.count();
+        if (count > this.maxEntries) {
+            const toDelete = count - this.maxEntries;
+            // Importance-aware pruning: delete lowest importance first, then oldest
+            // This retains high-value memories longer regardless of age
+            const stmt = this.db.prepare(`
+        DELETE FROM memories
+        WHERE id IN (
+          SELECT id FROM memories
+          WHERE project_id = ?
+          ORDER BY importance ASC, id ASC
+          LIMIT ?
+        )
+      `);
+            stmt.run(this.projectId, toDelete);
+        }
+    }
+    async clear() {
+        const stmt = this.db.prepare(`
+      DELETE FROM memories
+      WHERE project_id = ?
+    `);
+        stmt.run(this.projectId);
+    }
+    async close() {
+        this.db.close();
+    }
+    // Export all memories as JSON (useful for backup/migration)
+    async exportAll() {
+        const stmt = this.db.prepare(`
+      SELECT id, timestamp, type, content, project_id as projectId, importance
+      FROM memories
+      WHERE project_id = ?
+      ORDER BY id ASC
+    `);
+        return stmt.all(this.projectId);
+    }
+    // Import memories from JSON (useful for restore/migration)
+    async importAll(memories) {
+        await this.storeBatch(memories);
+        return memories.length;
+    }
+}
+//# sourceMappingURL=sqlite.js.map

package/dist/memory/short-term/sqlite.js.map

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

package/dist/memory/speculative-cache.d.ts

@@ -0,0 +1,111 @@
+/**
+ * Speculative Cache for UAP Memory System
+ *
+ * Pre-computes likely next queries based on task patterns.
+ * Reduces latency by predicting and caching memory retrievals.
+ *
+ * Enhanced with task classifier integration for smarter prefetching
+ */
+export interface CacheEntry {
+    query: string;
+    result: unknown[];
+    embedding?: number[];
+    usageCount: number;
+    lastUsed: Date;
+    createdAt: Date;
+    predictedBy?: string;
+    taskCategory?: string;
+}
+export interface CacheConfig {
+    maxEntries: number;
+    ttlMs: number;
+    preWarmEnabled: boolean;
+    predictionDepth: number;
+}
+/**
+ * Speculative Memory Cache
+ */
+export declare class SpeculativeCache {
+    private config;
+    private cache;
+    private queryHistory;
+    private taskPatterns;
+    constructor(config?: Partial<CacheConfig>);
+    /**
+     * Get from cache with automatic staleness check
+     */
+    get(query: string): CacheEntry | null;
+    /**
+     * Set cache entry
+     */
+    set(query: string, result: unknown[], predictedBy?: string): void;
+    /**
+     * Record query for pattern analysis
+     */
+    private recordQuery;
+    /**
+     * Detect task category from query
+     */
+    private detectCategory;
+    /**
+     * Get predicted queries based on current context
+     * Enhanced with seeded transition chains for faster cache warming
+     */
+    getPredictedQueries(currentQuery: string): string[];
+    /**
+     * Analyze query sequences for patterns
+     */
+    private analyzeQuerySequences;
+    /**
+     * Pre-warm cache with predicted queries
+     */
+    preWarm(currentQuery: string, fetcher: (query: string) => Promise<unknown[]>): Promise<void>;
+    /**
+     * Evict least recently used entry
+     */
+    private evictLRU;
+    /**
+     * Normalize query for cache key
+     */
+    private normalizeQuery;
+    /**
+     * Get cache statistics
+     */
+    getStats(): {
+        size: number;
+        hitRate: number;
+        avgUsage: number;
+        topPatterns: Array<{
+            category: string;
+            count: number;
+        }>;
+    };
+    /**
+     * Clear expired entries
+     */
+    cleanup(): number;
+    /**
+     * Clear all cache
+     */
+    clear(): void;
+    /**
+     * OPTIMIZATION 6: Load historical query patterns from SQLite database
+     * Pre-warms queryHistory and taskPatterns from persisted memory data
+     */
+    loadFromDb(dbPath: string): Promise<number>;
+}
+export declare function getSpeculativeCache(config?: Partial<CacheConfig>): SpeculativeCache;
+/**
+ * OPTIMIZATION 6: Initialize cache with historical data from database
+ * Call this at startup to warm the cache from persisted memories
+ */
+export declare function initializeCacheFromDb(dbPath: string, config?: Partial<CacheConfig>): Promise<{
+    cache: SpeculativeCache;
+    entriesLoaded: number;
+}>;
+/**
+ * OPTIMIZATION 10: Auto-warm cache with high-value Terminal-Bench patterns
+ * Call this at startup to pre-populate cache with proven knowledge chains
+ */
+export declare function autoWarmCache(cache?: SpeculativeCache): number;
+//# sourceMappingURL=speculative-cache.d.ts.map

package/dist/memory/speculative-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"speculative-cache.d.ts","sourceRoot":"","sources":["../../src/memory/speculative-cache.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,OAAO,EAAE,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,IAAI,CAAC;IACf,SAAS,EAAE,IAAI,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,OAAO,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;CACzB;AA0ED;;GAEG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,KAAK,CAAsC;IACnD,OAAO,CAAC,YAAY,CAAgB;IACpC,OAAO,CAAC,YAAY,CAAkC;gBAE1C,MAAM,GAAE,OAAO,CAAC,WAAW,CAAM;IAI7C;;OAEG;IACH,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI;IAoBrC;;OAEG;IACH,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI;IAqBjE;;OAEG;IACH,OAAO,CAAC,WAAW;IAgBnB;;OAEG;IACH,OAAO,CAAC,cAAc;IActB;;;OAGG;IACH,mBAAmB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,EAAE;IA2BnD;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAiC7B;;OAEG;IACG,OAAO,CACX,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,EAAE,CAAC,GAC7C,OAAO,CAAC,IAAI,CAAC;IAoBhB;;OAEG;IACH,OAAO,CAAC,QAAQ;IAehB;;OAEG;IACH,OAAO,CAAC,cAAc;IAItB;;OAEG;IACH,QAAQ,IAAI;QACV,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,MAAM,CAAC;QACjB,WAAW,EAAE,KAAK,CAAC;YAAE,QAAQ,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KACzD;IAkBD;;OAEG;IACH,OAAO,IAAI,MAAM;IAejB;;OAEG;IACH,KAAK,IAAI,IAAI;IAMb;;;OAGG;IACG,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CA2DlD;AAKD,wBAAgB,mBAAmB,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,gBAAgB,CAKnF;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,GAC5B,OAAO,CAAC;IAAE,KAAK,EAAE,gBAAgB,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE,CAAC,CAI7D;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,CAAC,EAAE,gBAAgB,GAAG,MAAM,CAkC9D"}