universal-agent-protocol 0.5.0

package/dist/memory/model-router.js

@@ -0,0 +1,448 @@
+/**
+ * Model Routing Intelligence for UAP
+ *
+ * Routes tasks to the optimal model based on:
+ * - Task classification and difficulty
+ * - Model capability fingerprints (benchmarked data)
+ * - Latency/accuracy/cost tradeoffs
+ * - Fallback chains for resilience
+ * - OPT 8: Persistent fingerprint data from SQLite
+ *
+ * Based on BENCHMARK_ANALYSIS.md and MODEL_BENCHMARK_RESULTS.md data.
+ */
+import Database from 'better-sqlite3';
+import { existsSync, mkdirSync } from 'fs';
+import { dirname, join } from 'path';
+import { fileURLToPath } from 'url';
+import { classifyTask } from './task-classifier.js';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const DEFAULT_CONFIG = {
+    preferLatency: false,
+    preferAccuracy: true,
+    maxCostPerTask: 0.05,
+    maxLatencyMs: 120000,
+    availableModels: ['glm-4.7', 'gpt-5.2', 'claude-opus-4.5', 'gpt-5.2-codex'],
+};
+// OPTIMIZATION 5: Pre-seeded with benchmark data for per-category routing
+const MODEL_FINGERPRINTS = {
+    'glm-4.7': {
+        id: 'glm-4.7',
+        strengths: ['speed', 'simple-code', 'patterns', 'typescript', 'bug-detection'],
+        weaknesses: ['complex-algorithms', 'long-context', 'multi-step-code', 'context-awareness'],
+        avgLatencyMs: 11373,
+        successRate: 0.625,
+        costPerTask: 0.001,
+        maxComplexity: 'medium',
+        bestCategories: ['coding', 'testing', 'debugging'],
+        categoryStats: {
+            coding: { attempts: 8, successes: 5 },
+            testing: { attempts: 5, successes: 4 },
+            debugging: { attempts: 4, successes: 3 },
+            security: { attempts: 4, successes: 2 },
+            'file-ops': { attempts: 3, successes: 1 },
+            sysadmin: { attempts: 3, successes: 1 },
+        },
+    },
+    'gpt-5.2': {
+        id: 'gpt-5.2',
+        strengths: ['balance', 'consistency', 'general-purpose', 'algorithm', 'multi-step'],
+        weaknesses: ['refactoring', 'latency-sensitive'],
+        avgLatencyMs: 21286,
+        successRate: 0.875,
+        costPerTask: 0.005,
+        maxComplexity: 'hard',
+        bestCategories: ['coding', 'security', 'file-ops', 'debugging'],
+        categoryStats: {
+            coding: { attempts: 8, successes: 7 },
+            security: { attempts: 6, successes: 5 },
+            'file-ops': { attempts: 5, successes: 4 },
+            debugging: { attempts: 5, successes: 5 },
+            sysadmin: { attempts: 4, successes: 3 },
+            'ml-training': { attempts: 3, successes: 2 },
+            'constraint-satisfaction': { attempts: 3, successes: 3 },
+        },
+    },
+    'claude-opus-4.5': {
+        id: 'claude-opus-4.5',
+        strengths: ['accuracy', 'complex-reasoning', 'edge-cases', 'error-handling', 'refactoring'],
+        weaknesses: ['latency', 'cost'],
+        avgLatencyMs: 26359,
+        successRate: 0.875,
+        costPerTask: 0.02,
+        maxComplexity: 'hard',
+        bestCategories: ['security', 'coding', 'sysadmin', 'debugging'],
+        categoryStats: {
+            security: { attempts: 8, successes: 7 },
+            coding: { attempts: 8, successes: 7 },
+            sysadmin: { attempts: 5, successes: 5 },
+            debugging: { attempts: 5, successes: 4 },
+            'file-ops': { attempts: 5, successes: 4 },
+            'ml-training': { attempts: 3, successes: 2 },
+            'constraint-satisfaction': { attempts: 3, successes: 2 },
+        },
+    },
+    'gpt-5.2-codex': {
+        id: 'gpt-5.2-codex',
+        strengths: ['code-specific', 'syntax-accuracy', 'context-awareness', 'all-difficulties'],
+        weaknesses: ['latency', 'cost', 'non-code-tasks'],
+        avgLatencyMs: 102399,
+        successRate: 1.0,
+        costPerTask: 0.01,
+        maxComplexity: 'hard',
+        bestCategories: ['coding', 'testing'],
+        categoryStats: {
+            coding: { attempts: 8, successes: 8 },
+            testing: { attempts: 5, successes: 5 },
+            security: { attempts: 3, successes: 3 },
+            'file-ops': { attempts: 3, successes: 2 },
+        },
+    },
+};
+const COMPLEXITY_RANK = { easy: 1, medium: 2, hard: 3 };
+// OPT 8: SQLite-backed fingerprint persistence
+let fingerprintDb = null;
+function getFingerprintDb() {
+    if (fingerprintDb)
+        return fingerprintDb;
+    const dbDir = join(__dirname, '../../agents/data/memory');
+    if (!existsSync(dbDir)) {
+        mkdirSync(dbDir, { recursive: true });
+    }
+    const dbPath = join(dbDir, 'model_fingerprints.db');
+    fingerprintDb = new Database(dbPath);
+    fingerprintDb.pragma('journal_mode = WAL');
+    // Create schema
+    fingerprintDb.exec(`
+    CREATE TABLE IF NOT EXISTS fingerprint_updates (
+      model_id TEXT NOT NULL,
+      avg_latency_ms REAL,
+      success_rate REAL,
+      updated_at INTEGER,
+      PRIMARY KEY (model_id)
+    );
+    
+    CREATE TABLE IF NOT EXISTS category_stats (
+      model_id TEXT NOT NULL,
+      category TEXT NOT NULL,
+      attempts INTEGER DEFAULT 0,
+      successes INTEGER DEFAULT 0,
+      updated_at INTEGER,
+      PRIMARY KEY (model_id, category)
+    );
+    
+    CREATE INDEX IF NOT EXISTS idx_category_stats_model ON category_stats(model_id);
+  `);
+    return fingerprintDb;
+}
+/**
+ * OPT 8: Load persisted fingerprint data on module init
+ */
+function loadPersistedFingerprints() {
+    try {
+        const db = getFingerprintDb();
+        // Load global updates
+        const updates = db.prepare('SELECT * FROM fingerprint_updates').all();
+        for (const update of updates) {
+            const fp = MODEL_FINGERPRINTS[update.model_id];
+            if (fp) {
+                // Blend persisted data with defaults (70% persisted, 30% default)
+                fp.avgLatencyMs = fp.avgLatencyMs * 0.3 + update.avg_latency_ms * 0.7;
+                fp.successRate = fp.successRate * 0.3 + update.success_rate * 0.7;
+            }
+        }
+        // Load category stats
+        const categoryData = db.prepare('SELECT * FROM category_stats').all();
+        for (const cat of categoryData) {
+            const fp = MODEL_FINGERPRINTS[cat.model_id];
+            if (fp) {
+                if (!fp.categoryStats)
+                    fp.categoryStats = {};
+                // Merge with existing stats
+                const existing = fp.categoryStats[cat.category] || { attempts: 0, successes: 0 };
+                fp.categoryStats[cat.category] = {
+                    attempts: existing.attempts + cat.attempts,
+                    successes: existing.successes + cat.successes,
+                };
+            }
+        }
+    }
+    catch (err) {
+        // Silently fail - fingerprints will use defaults
+        console.warn('Failed to load persisted fingerprints:', err);
+    }
+}
+/**
+ * OPT 8: Persist fingerprint updates to SQLite
+ */
+function persistFingerprintUpdate(modelId) {
+    try {
+        const db = getFingerprintDb();
+        const fp = MODEL_FINGERPRINTS[modelId];
+        if (!fp)
+            return;
+        db.prepare(`
+      INSERT OR REPLACE INTO fingerprint_updates (model_id, avg_latency_ms, success_rate, updated_at)
+      VALUES (?, ?, ?, ?)
+    `).run(modelId, fp.avgLatencyMs, fp.successRate, Date.now());
+    }
+    catch (err) {
+        console.warn('Failed to persist fingerprint update:', err);
+    }
+}
+/**
+ * OPT 8: Persist category stats to SQLite
+ */
+function persistCategoryStats(modelId, category) {
+    try {
+        const db = getFingerprintDb();
+        const fp = MODEL_FINGERPRINTS[modelId];
+        const stats = fp?.categoryStats?.[category];
+        if (!stats)
+            return;
+        db.prepare(`
+      INSERT OR REPLACE INTO category_stats (model_id, category, attempts, successes, updated_at)
+      VALUES (?, ?, ?, ?, ?)
+    `).run(modelId, category, stats.attempts, stats.successes, Date.now());
+    }
+    catch (err) {
+        console.warn('Failed to persist category stats:', err);
+    }
+}
+// Initialize on module load
+loadPersistedFingerprints();
+/**
+ * Failure handlers for model-specific known issues
+ */
+const FAILURE_HANDLERS = {
+    'gpt-5.2-codex:permission_denied': {
+        action: 'add_context',
+        context: 'Do not attempt file operations. Return code only.',
+        fallbackModel: 'gpt-5.2',
+    },
+    'glm-4.7:timeout': {
+        action: 'reduce_context',
+        fallbackModel: 'gpt-5.2',
+    },
+    'glm-4.7:context_overflow': {
+        action: 'reduce_context',
+        fallbackModel: 'gpt-5.2',
+    },
+};
+/**
+ * OPTIMIZATION 5: Enhanced per-category scoring with confidence weighting
+ * Score a model for a given task using category-specific success rates
+ */
+function scoreModel(model, classification, difficulty, config) {
+    let score = 0;
+    // Category match bonus - INCREASED weight for proven categories
+    if (model.bestCategories.includes(classification.category)) {
+        score += 40; // Increased from 30
+    }
+    // Complexity match
+    if (COMPLEXITY_RANK[model.maxComplexity] >= COMPLEXITY_RANK[difficulty]) {
+        score += 20;
+    }
+    else {
+        score -= 50; // Penalty for difficulty exceeding capability
+    }
+    // OPTIMIZATION 5: Use per-category success rate with confidence weighting
+    // If we have enough data (>=3 attempts), weight category rate 2x higher than global
+    const categoryRate = getCategorySuccessRate(model, classification.category);
+    const categoryAttempts = model.categoryStats?.[classification.category]?.attempts || 0;
+    let effectiveSuccessRate;
+    if (categoryRate !== null && categoryAttempts >= 3) {
+        // Blend category and global rates, weighted by sample size confidence
+        const confidence = Math.min(categoryAttempts / 10, 1); // Max confidence at 10 samples
+        effectiveSuccessRate = categoryRate * confidence + model.successRate * (1 - confidence);
+        // Bonus for having category-specific data
+        score += 10;
+    }
+    else {
+        effectiveSuccessRate = model.successRate;
+    }
+    // Success rate (0-30 points) - INCREASED from 25
+    score += effectiveSuccessRate * 30;
+    // Latency preference (0-15 points)
+    if (config.preferLatency) {
+        const latencyScore = Math.max(0, 1 - (model.avgLatencyMs / 120000));
+        score += latencyScore * 15;
+    }
+    // Accuracy preference bonus
+    if (config.preferAccuracy) {
+        score += effectiveSuccessRate * 10;
+    }
+    // Cost constraint
+    if (model.costPerTask > config.maxCostPerTask) {
+        score -= 20;
+    }
+    // Latency constraint
+    if (model.avgLatencyMs > config.maxLatencyMs) {
+        score -= 30;
+    }
+    // Keyword match with model strengths - INCREASED weight
+    const taskKeywords = classification.keywords.map(k => k.toLowerCase());
+    for (const strength of model.strengths) {
+        if (taskKeywords.some(kw => strength.includes(kw) || kw.includes(strength))) {
+            score += 8; // Increased from 5
+        }
+    }
+    return score;
+}
+/**
+ * Get per-category success rate if enough data exists (>=3 attempts)
+ * Returns null if not enough data, allowing fallback to global rate
+ */
+function getCategorySuccessRate(model, category) {
+    const stats = model.categoryStats?.[category];
+    if (!stats || stats.attempts < 3)
+        return null;
+    return stats.successes / stats.attempts;
+}
+/**
+ * Route a task to the best model
+ */
+export function routeTask(instruction, difficulty = 'medium', config = {}) {
+    const cfg = { ...DEFAULT_CONFIG, ...config };
+    const classification = classifyTask(instruction);
+    // Score all available models
+    const scored = cfg.availableModels
+        .filter(id => MODEL_FINGERPRINTS[id])
+        .map(id => ({
+        id,
+        fingerprint: MODEL_FINGERPRINTS[id],
+        score: scoreModel(MODEL_FINGERPRINTS[id], classification, difficulty, cfg),
+    }))
+        .sort((a, b) => b.score - a.score);
+    if (scored.length === 0) {
+        return {
+            primary: 'gpt-5.2',
+            fallback: ['claude-opus-4.5'],
+            reason: 'No available models matched, defaulting to GPT 5.2',
+            estimatedLatencyMs: 21286,
+            estimatedSuccessRate: 0.875,
+            estimatedCost: 0.005,
+        };
+    }
+    const primary = scored[0];
+    const fallbacks = scored.slice(1).map(s => s.id);
+    return {
+        primary: primary.id,
+        fallback: fallbacks,
+        reason: `${primary.id} selected for ${classification.category}/${difficulty} task (score: ${primary.score.toFixed(0)})`,
+        estimatedLatencyMs: primary.fingerprint.avgLatencyMs,
+        estimatedSuccessRate: primary.fingerprint.successRate,
+        estimatedCost: primary.fingerprint.costPerTask,
+    };
+}
+/**
+ * Get failure handler for a model-specific error
+ */
+export function getFailureHandler(modelId, errorType) {
+    return FAILURE_HANDLERS[`${modelId}:${errorType}`] || null;
+}
+/**
+ * Get model fingerprint
+ */
+export function getModelFingerprint(modelId) {
+    return MODEL_FINGERPRINTS[modelId] || null;
+}
+/**
+ * Get all model fingerprints
+ */
+export function getAllModelFingerprints() {
+    return { ...MODEL_FINGERPRINTS };
+}
+/**
+ * Update model fingerprint with new benchmark data
+ */
+export function updateModelFingerprint(modelId, updates) {
+    const fp = MODEL_FINGERPRINTS[modelId];
+    if (!fp)
+        return;
+    if (updates.avgLatencyMs !== undefined) {
+        // Exponential moving average
+        fp.avgLatencyMs = fp.avgLatencyMs * 0.7 + updates.avgLatencyMs * 0.3;
+    }
+    if (updates.successRate !== undefined) {
+        fp.successRate = fp.successRate * 0.7 + updates.successRate * 0.3;
+    }
+    if (updates.costPerTask !== undefined) {
+        fp.costPerTask = updates.costPerTask;
+    }
+}
+/**
+ * Record task outcome to update model fingerprints (feedback loop)
+ * Call this after each task completes to improve future routing decisions
+ * OPT 8: Now persists to SQLite for cross-session learning
+ */
+export function recordTaskOutcome(modelId, success, latencyMs, taskCategory) {
+    const fp = MODEL_FINGERPRINTS[modelId];
+    if (!fp)
+        return;
+    // Update global success rate using exponential moving average
+    const newSuccessRate = success ? 1.0 : 0.0;
+    fp.successRate = fp.successRate * 0.9 + newSuccessRate * 0.1;
+    // Update latency using exponential moving average
+    fp.avgLatencyMs = fp.avgLatencyMs * 0.8 + latencyMs * 0.2;
+    // OPT 8: Persist global fingerprint update
+    persistFingerprintUpdate(modelId);
+    // Update per-category stats if category provided
+    if (taskCategory) {
+        if (!fp.categoryStats)
+            fp.categoryStats = {};
+        if (!fp.categoryStats[taskCategory]) {
+            fp.categoryStats[taskCategory] = { attempts: 0, successes: 0 };
+        }
+        fp.categoryStats[taskCategory].attempts++;
+        if (success) {
+            fp.categoryStats[taskCategory].successes++;
+        }
+        // OPT 8: Persist category stats
+        persistCategoryStats(modelId, taskCategory);
+    }
+}
+/**
+ * Get routing recommendation with explanation
+ */
+export function explainRouting(instruction, difficulty = 'medium') {
+    const decision = routeTask(instruction, difficulty);
+    const fingerprint = MODEL_FINGERPRINTS[decision.primary];
+    const lines = [
+        `Primary Model: ${decision.primary}`,
+        `Reason: ${decision.reason}`,
+        `Expected Latency: ${(decision.estimatedLatencyMs / 1000).toFixed(1)}s`,
+        `Expected Success: ${(decision.estimatedSuccessRate * 100).toFixed(0)}%`,
+        `Strengths: ${fingerprint?.strengths.slice(0, 3).join(', ') || 'N/A'}`,
+        `Fallbacks: ${decision.fallback.join(' -> ') || 'None'}`,
+    ];
+    return lines.join('\n');
+}
+/**
+ * OPT 8: Close fingerprint database connection
+ */
+export function closeFingerprintDb() {
+    if (fingerprintDb) {
+        fingerprintDb.close();
+        fingerprintDb = null;
+    }
+}
+/**
+ * OPT 8: Force reload fingerprints from database
+ */
+export function reloadFingerprints() {
+    loadPersistedFingerprints();
+}
+export const ModelRouter = {
+    routeTask,
+    getFailureHandler,
+    getModelFingerprint,
+    getAllModelFingerprints,
+    updateModelFingerprint,
+    recordTaskOutcome,
+    explainRouting,
+    closeFingerprintDb,
+    reloadFingerprints,
+};
+export default ModelRouter;
+//# sourceMappingURL=model-router.js.map

package/dist/memory/model-router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-router.js","sourceRoot":"","sources":["../../src/memory/model-router.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AACtC,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AAC3C,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AACpC,OAAO,EAAE,YAAY,EAA2B,MAAM,sBAAsB,CAAC;AAE7E,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;AAsCtC,MAAM,cAAc,GAAkB;IACpC,aAAa,EAAE,KAAK;IACpB,cAAc,EAAE,IAAI;IACpB,cAAc,EAAE,IAAI;IACpB,YAAY,EAAE,MAAM;IACpB,eAAe,EAAE,CAAC,SAAS,EAAE,SAAS,EAAE,iBAAiB,EAAE,eAAe,CAAC;CAC5E,CAAC;AAEF,0EAA0E;AAC1E,MAAM,kBAAkB,GAAsC;IAC5D,SAAS,EAAE;QACT,EAAE,EAAE,SAAS;QACb,SAAS,EAAE,CAAC,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,YAAY,EAAE,eAAe,CAAC;QAC9E,UAAU,EAAE,CAAC,oBAAoB,EAAE,cAAc,EAAE,iBAAiB,EAAE,mBAAmB,CAAC;QAC1F,YAAY,EAAE,KAAK;QACnB,WAAW,EAAE,KAAK;QAClB,WAAW,EAAE,KAAK;QAClB,aAAa,EAAE,QAAQ;QACvB,cAAc,EAAE,CAAC,QAAQ,EAAE,SAAS,EAAE,WAAW,CAAC;QAClD,aAAa,EAAE;YACb,MAAM,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE;YACrC,OAAO,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE;YACtC,SAAS,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE;YACxC,QAAQ,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE;YACvC,UAAU,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE;YACzC,QAAQ,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE;SACxC;KACF;IACD,SAAS,EAAE;QACT,EAAE,EAAE,SAAS;QACb,SAAS,EAAE,CAAC,SAAS,EAAE,aAAa,EAAE,iBAAiB,EAAE,WAAW,EAAE,YAAY,CAAC;QACnF,UAAU,EAAE,CAAC,aAAa,EAAE,mBAAmB,CAAC;QAChD,YAAY,EAAE,KAAK;QACnB,WAAW,EAAE,KAAK;QAClB,WAAW,EAAE,KAAK;QAClB,aAAa,EAAE,MAAM;QACrB,cAAc,EAAE,CAAC,QAAQ,EAAE,UAAU,EAAE,UAAU,EAAE,WAAW,CAAC;QAC/D,aAAa,EAAE;YACb,MAAM,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE;YACrC,QAAQ,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE;YACvC,UAAU,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE;YACzC,SAAS,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE;YACxC,QAAQ,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE;YACvC,aAAa,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE;YAC5C,yBAAyB,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE;SACzD;KACF;IACD,iBAAiB,EAAE;QACjB,EAAE,EAAE,iBAAiB;QACrB,SAAS,EAAE,CAAC,UAAU,EAAE,mBAAmB,EAAE,YAAY,EAAE,gBAAgB,EAAE,aAAa,CAAC;QAC3F,UAAU,EAAE,CAAC,SAAS,EAAE,MAAM,CAAC;QAC/B,YAAY,EAAE,KAAK;QACnB,WAAW,EAAE,KAAK;QAClB,WAAW,EAAE,IAAI;QACjB,aAAa,EAAE,MAAM;QACrB,cAAc,EAAE,CAAC,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE,WAAW,CAAC;QAC/D,aAAa,EAAE;YACb,QAAQ,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE;YACvC,MAAM,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE;YACrC,QAAQ,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE;YACvC,SAAS,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE;YACxC,UAAU,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE;YACzC,aAAa,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE;YAC5C,yBAAyB,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE;SACzD;KACF;IACD,eAAe,EAAE;QACf,EAAE,EAAE,eAAe;QACnB,SAAS,EAAE,CAAC,eAAe,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,kBAAkB,CAAC;QACxF,UAAU,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,gBAAgB,CAAC;QACjD,YAAY,EAAE,MAAM;QACpB,WAAW,EAAE,GAAG;QAChB,WAAW,EAAE,IAAI;QACjB,aAAa,EAAE,MAAM;QACrB,cAAc,EAAE,CAAC,QAAQ,EAAE,SAAS,CAAC;QACrC,aAAa,EAAE;YACb,MAAM,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE;YACrC,OAAO,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE;YACtC,QAAQ,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE;YACvC,UAAU,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE;SAC1C;KACF;CACF,CAAC;AAEF,MAAM,eAAe,GAAG,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;AAExD,+CAA+C;AAC/C,IAAI,aAAa,GAA6B,IAAI,CAAC;AAEnD,SAAS,gBAAgB;IACvB,IAAI,aAAa;QAAE,OAAO,aAAa,CAAC;IAExC,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,EAAE,0BAA0B,CAAC,CAAC;IAC1D,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;QACvB,SAAS,CAAC,KAAK,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACxC,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,EAAE,uBAAuB,CAAC,CAAC;IACpD,aAAa,GAAG,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAC;IACrC,aAAa,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC;IAE3C,gBAAgB;IAChB,aAAa,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;;;;GAmBlB,CAAC,CAAC;IAEH,OAAO,aAAa,CAAC;AACvB,CAAC;AAED;;GAEG;AACH,SAAS,yBAAyB;IAChC,IAAI,CAAC;QACH,MAAM,EAAE,GAAG,gBAAgB,EAAE,CAAC;QAE9B,sBAAsB;QACtB,MAAM,OAAO,GAAG,EAAE,CAAC,OAAO,CAAC,mCAAmC,CAAC,CAAC,GAAG,EAIjE,CAAC;QAEH,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,MAAM,EAAE,GAAG,kBAAkB,CAAC,MAAM,CAAC,QAAmB,CAAC,CAAC;YAC1D,IAAI,EAAE,EAAE,CAAC;gBACP,kEAAkE;gBAClE,EAAE,CAAC,YAAY,GAAG,EAAE,CAAC,YAAY,GAAG,GAAG,GAAG,MAAM,CAAC,cAAc,GAAG,GAAG,CAAC;gBACtE,EAAE,CAAC,WAAW,GAAG,EAAE,CAAC,WAAW,GAAG,GAAG,GAAG,MAAM,CAAC,YAAY,GAAG,GAAG,CAAC;YACpE,CAAC;QACH,CAAC;QAED,sBAAsB;QACtB,MAAM,YAAY,GAAG,EAAE,CAAC,OAAO,CAAC,8BAA8B,CAAC,CAAC,GAAG,EAKjE,CAAC;QAEH,KAAK,MAAM,GAAG,IAAI,YAAY,EAAE,CAAC;YAC/B,MAAM,EAAE,GAAG,kBAAkB,CAAC,GAAG,CAAC,QAAmB,CAAC,CAAC;YACvD,IAAI,EAAE,EAAE,CAAC;gBACP,IAAI,CAAC,EAAE,CAAC,aAAa;oBAAE,EAAE,CAAC,aAAa,GAAG,EAAE,CAAC;gBAC7C,4BAA4B;gBAC5B,MAAM,QAAQ,GAAG,EAAE,CAAC,aAAa,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;gBACjF,EAAE,CAAC,aAAa,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG;oBAC/B,QAAQ,EAAE,QAAQ,CAAC,QAAQ,GAAG,GAAG,CAAC,QAAQ;oBAC1C,SAAS,EAAE,QAAQ,CAAC,SAAS,GAAG,GAAG,CAAC,SAAS;iBAC9C,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,iDAAiD;QACjD,OAAO,CAAC,IAAI,CAAC,wCAAwC,EAAE,GAAG,CAAC,CAAC;IAC9D,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAS,wBAAwB,CAAC,OAAgB;IAChD,IAAI,CAAC;QACH,MAAM,EAAE,GAAG,gBAAgB,EAAE,CAAC;QAC9B,MAAM,EAAE,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC;QACvC,IAAI,CAAC,EAAE;YAAE,OAAO;QAEhB,EAAE,CAAC,OAAO,CAAC;;;KAGV,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC,YAAY,EAAE,EAAE,CAAC,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;IAC/D,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,IAAI,CAAC,uCAAuC,EAAE,GAAG,CAAC,CAAC;IAC7D,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAS,oBAAoB,CAAC,OAAgB,EAAE,QAAgB;IAC9D,IAAI,CAAC;QACH,MAAM,EAAE,GAAG,gBAAgB,EAAE,CAAC;QAC9B,MAAM,EAAE,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC;QACvC,MAAM,KAAK,GAAG,EAAE,EAAE,aAAa,EAAE,CAAC,QAAQ,CAAC,CAAC;QAC5C,IAAI,CAAC,KAAK;YAAE,OAAO;QAEnB,EAAE,CAAC,OAAO,CAAC;;;KAGV,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;IACzE,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,IAAI,CAAC,mCAAmC,EAAE,GAAG,CAAC,CAAC;IACzD,CAAC;AACH,CAAC;AAED,4BAA4B;AAC5B,yBAAyB,EAAE,CAAC;AAE5B;;GAEG;AACH,MAAM,gBAAgB,GAIjB;IACH,iCAAiC,EAAE;QACjC,MAAM,EAAE,aAAa;QACrB,OAAO,EAAE,mDAAmD;QAC5D,aAAa,EAAE,SAAS;KACzB;IACD,iBAAiB,EAAE;QACjB,MAAM,EAAE,gBAAgB;QACxB,aAAa,EAAE,SAAS;KACzB;IACD,0BAA0B,EAAE;QAC1B,MAAM,EAAE,gBAAgB;QACxB,aAAa,EAAE,SAAS;KACzB;CACF,CAAC;AAEF;;;GAGG;AACH,SAAS,UAAU,CACjB,KAAuB,EACvB,cAAkC,EAClC,UAAsC,EACtC,MAAqB;IAErB,IAAI,KAAK,GAAG,CAAC,CAAC;IAEd,gEAAgE;IAChE,IAAI,KAAK,CAAC,cAAc,CAAC,QAAQ,CAAC,cAAc,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC3D,KAAK,IAAI,EAAE,CAAC,CAAC,oBAAoB;IACnC,CAAC;IAED,mBAAmB;IACnB,IAAI,eAAe,CAAC,KAAK,CAAC,aAAa,CAAC,IAAI,eAAe,CAAC,UAAU,CAAC,EAAE,CAAC;QACxE,KAAK,IAAI,EAAE,CAAC;IACd,CAAC;SAAM,CAAC;QACN,KAAK,IAAI,EAAE,CAAC,CAAC,8CAA8C;IAC7D,CAAC;IAED,0EAA0E;IAC1E,oFAAoF;IACpF,MAAM,YAAY,GAAG,sBAAsB,CAAC,KAAK,EAAE,cAAc,CAAC,QAAQ,CAAC,CAAC;IAC5E,MAAM,gBAAgB,GAAG,KAAK,CAAC,aAAa,EAAE,CAAC,cAAc,CAAC,QAAQ,CAAC,EAAE,QAAQ,IAAI,CAAC,CAAC;IAEvF,IAAI,oBAA4B,CAAC;IACjC,IAAI,YAAY,KAAK,IAAI,IAAI,gBAAgB,IAAI,CAAC,EAAE,CAAC;QACnD,sEAAsE;QACtE,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,gBAAgB,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,+BAA+B;QACtF,oBAAoB,GAAG,YAAY,GAAG,UAAU,GAAG,KAAK,CAAC,WAAW,GAAG,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC;QACxF,0CAA0C;QAC1C,KAAK,IAAI,EAAE,CAAC;IACd,CAAC;SAAM,CAAC;QACN,oBAAoB,GAAG,KAAK,CAAC,WAAW,CAAC;IAC3C,CAAC;IAED,iDAAiD;IACjD,KAAK,IAAI,oBAAoB,GAAG,EAAE,CAAC;IAEnC,mCAAmC;IACnC,IAAI,MAAM,CAAC,aAAa,EAAE,CAAC;QACzB,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,YAAY,GAAG,MAAM,CAAC,CAAC,CAAC;QACpE,KAAK,IAAI,YAAY,GAAG,EAAE,CAAC;IAC7B,CAAC;IAED,4BAA4B;IAC5B,IAAI,MAAM,CAAC,cAAc,EAAE,CAAC;QAC1B,KAAK,IAAI,oBAAoB,GAAG,EAAE,CAAC;IACrC,CAAC;IAED,kBAAkB;IAClB,IAAI,KAAK,CAAC,WAAW,GAAG,MAAM,CAAC,cAAc,EAAE,CAAC;QAC9C,KAAK,IAAI,EAAE,CAAC;IACd,CAAC;IAED,qBAAqB;IACrB,IAAI,KAAK,CAAC,YAAY,GAAG,MAAM,CAAC,YAAY,EAAE,CAAC;QAC7C,KAAK,IAAI,EAAE,CAAC;IACd,CAAC;IAED,wDAAwD;IACxD,MAAM,YAAY,GAAG,cAAc,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;IACvE,KAAK,MAAM,QAAQ,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;QACvC,IAAI,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC;YAC5E,KAAK,IAAI,CAAC,CAAC,CAAC,mBAAmB;QACjC,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;GAGG;AACH,SAAS,sBAAsB,CAAC,KAAuB,EAAE,QAAgB;IACvE,MAAM,KAAK,GAAG,KAAK,CAAC,aAAa,EAAE,CAAC,QAAQ,CAAC,CAAC;IAC9C,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,QAAQ,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAC9C,OAAO,KAAK,CAAC,SAAS,GAAG,KAAK,CAAC,QAAQ,CAAC;AAC1C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS,CACvB,WAAmB,EACnB,aAAyC,QAAQ,EACjD,SAAiC,EAAE;IAEnC,MAAM,GAAG,GAAG,EAAE,GAAG,cAAc,EAAE,GAAG,MAAM,EAAE,CAAC;IAC7C,MAAM,cAAc,GAAG,YAAY,CAAC,WAAW,CAAC,CAAC;IAEjD,6BAA6B;IAC7B,MAAM,MAAM,GAAG,GAAG,CAAC,eAAe;SAC/B,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,kBAAkB,CAAC,EAAE,CAAC,CAAC;SACpC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;QACV,EAAE;QACF,WAAW,EAAE,kBAAkB,CAAC,EAAE,CAAC;QACnC,KAAK,EAAE,UAAU,CAAC,kBAAkB,CAAC,EAAE,CAAC,EAAE,cAAc,EAAE,UAAU,EAAE,GAAG,CAAC;KAC3E,CAAC,CAAC;SACF,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;IAErC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO;YACL,OAAO,EAAE,SAAS;YAClB,QAAQ,EAAE,CAAC,iBAAiB,CAAC;YAC7B,MAAM,EAAE,oDAAoD;YAC5D,kBAAkB,EAAE,KAAK;YACzB,oBAAoB,EAAE,KAAK;YAC3B,aAAa,EAAE,KAAK;SACrB,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;IAC1B,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAEjD,OAAO;QACL,OAAO,EAAE,OAAO,CAAC,EAAE;QACnB,QAAQ,EAAE,SAAS;QACnB,MAAM,EAAE,GAAG,OAAO,CAAC,EAAE,iBAAiB,cAAc,CAAC,QAAQ,IAAI,UAAU,iBAAiB,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG;QACvH,kBAAkB,EAAE,OAAO,CAAC,WAAW,CAAC,YAAY;QACpD,oBAAoB,EAAE,OAAO,CAAC,WAAW,CAAC,WAAW;QACrD,aAAa,EAAE,OAAO,CAAC,WAAW,CAAC,WAAW;KAC/C,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAgB,EAAE,SAAiB;IACnE,OAAO,gBAAgB,CAAC,GAAG,OAAO,IAAI,SAAS,EAAE,CAAC,IAAI,IAAI,CAAC;AAC7D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAAgB;IAClD,OAAO,kBAAkB,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC;AAC7C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,uBAAuB;IACrC,OAAO,EAAE,GAAG,kBAAkB,EAAE,CAAC;AACnC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB,CACpC,OAAgB,EAChB,OAAwF;IAExF,MAAM,EAAE,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC;IACvC,IAAI,CAAC,EAAE;QAAE,OAAO;IAEhB,IAAI,OAAO,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;QACvC,6BAA6B;QAC7B,EAAE,CAAC,YAAY,GAAG,EAAE,CAAC,YAAY,GAAG,GAAG,GAAG,OAAO,CAAC,YAAY,GAAG,GAAG,CAAC;IACvE,CAAC;IACD,IAAI,OAAO,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;QACtC,EAAE,CAAC,WAAW,GAAG,EAAE,CAAC,WAAW,GAAG,GAAG,GAAG,OAAO,CAAC,WAAW,GAAG,GAAG,CAAC;IACpE,CAAC;IACD,IAAI,OAAO,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;QACtC,EAAE,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;IACvC,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAC/B,OAAgB,EAChB,OAAgB,EAChB,SAAiB,EACjB,YAAqB;IAErB,MAAM,EAAE,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC;IACvC,IAAI,CAAC,EAAE;QAAE,OAAO;IAEhB,8DAA8D;IAC9D,MAAM,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;IAC3C,EAAE,CAAC,WAAW,GAAG,EAAE,CAAC,WAAW,GAAG,GAAG,GAAG,cAAc,GAAG,GAAG,CAAC;IAE7D,kDAAkD;IAClD,EAAE,CAAC,YAAY,GAAG,EAAE,CAAC,YAAY,GAAG,GAAG,GAAG,SAAS,GAAG,GAAG,CAAC;IAE1D,2CAA2C;IAC3C,wBAAwB,CAAC,OAAO,CAAC,CAAC;IAElC,iDAAiD;IACjD,IAAI,YAAY,EAAE,CAAC;QACjB,IAAI,CAAC,EAAE,CAAC,aAAa;YAAE,EAAE,CAAC,aAAa,GAAG,EAAE,CAAC;QAC7C,IAAI,CAAC,EAAE,CAAC,aAAa,CAAC,YAAY,CAAC,EAAE,CAAC;YACpC,EAAE,CAAC,aAAa,CAAC,YAAY,CAAC,GAAG,EAAE,QAAQ,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;QACjE,CAAC;QACD,EAAE,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC,QAAQ,EAAE,CAAC;QAC1C,IAAI,OAAO,EAAE,CAAC;YACZ,EAAE,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC,SAAS,EAAE,CAAC;QAC7C,CAAC;QAED,gCAAgC;QAChC,oBAAoB,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;IAC9C,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,WAAmB,EAAE,aAAyC,QAAQ;IACnG,MAAM,QAAQ,GAAG,SAAS,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;IACpD,MAAM,WAAW,GAAG,kBAAkB,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IAEzD,MAAM,KAAK,GAAG;QACZ,kBAAkB,QAAQ,CAAC,OAAO,EAAE;QACpC,WAAW,QAAQ,CAAC,MAAM,EAAE;QAC5B,qBAAqB,CAAC,QAAQ,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG;QACvE,qBAAqB,CAAC,QAAQ,CAAC,oBAAoB,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG;QACxE,cAAc,WAAW,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,EAAE;QACtE,cAAc,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,MAAM,EAAE;KACzD,CAAC;IAEF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB;IAChC,IAAI,aAAa,EAAE,CAAC;QAClB,aAAa,CAAC,KAAK,EAAE,CAAC;QACtB,aAAa,GAAG,IAAI,CAAC;IACvB,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB;IAChC,yBAAyB,EAAE,CAAC;AAC9B,CAAC;AAED,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,SAAS;IACT,iBAAiB;IACjB,mBAAmB;IACnB,uBAAuB;IACvB,sBAAsB;IACtB,iBAAiB;IACjB,cAAc;IACd,kBAAkB;IAClB,kBAAkB;CACnB,CAAC;AAEF,eAAe,WAAW,CAAC"}

package/dist/memory/multi-view-memory.d.ts

@@ -0,0 +1,134 @@
+/**
+ * Multi-View Memory System for UAP
+ *
+ * Implements:
+ * 1. Multi-view indexing (entity, temporal, semantic type views)
+ * 2. ENGRAM-style memory typing (episodic, semantic, procedural)
+ * 3. Async embedding generation
+ * 4. Speculative cache integration with task classifier
+ *
+ * Based on SimpleMem (2026) and ENGRAM (2025) research
+ */
+/**
+ * ENGRAM-style memory types
+ */
+export type ENGRAMMemoryType = 'episodic' | 'semantic' | 'procedural';
+/**
+ * Multi-view indexed memory entry
+ */
+export interface MultiViewMemory {
+    id: string;
+    content: string;
+    memoryType: ENGRAMMemoryType;
+    entities: string[];
+    temporalBucket: string;
+    semanticType: string;
+    embedding?: number[];
+    embeddingPending?: boolean;
+    importance: number;
+    accessCount: number;
+    lastAccessed: Date;
+    qualityScore: number;
+}
+/**
+ * Multi-view index structure
+ */
+export interface MultiViewIndex {
+    byEntity: Map<string, Set<string>>;
+    byTemporal: Map<string, Set<string>>;
+    bySemanticType: Map<string, Set<string>>;
+    byENGRAMType: Map<ENGRAMMemoryType, Set<string>>;
+}
+/**
+ * Classify memory into ENGRAM type
+ */
+export declare function classifyENGRAMType(content: string, context?: {
+    type?: string;
+}): ENGRAMMemoryType;
+/**
+ * Extract temporal bucket from content/timestamp
+ */
+export declare function extractTemporalBucket(content: string, timestamp?: string): string;
+/**
+ * Multi-View Memory Manager
+ */
+export declare class MultiViewMemoryManager {
+    private memories;
+    private index;
+    private embeddingQueue;
+    private isProcessingEmbeddings;
+    /**
+     * Add memory with multi-view indexing
+     */
+    add(content: string, options?: {
+        id?: string;
+        semanticType?: string;
+        entities?: string[];
+        timestamp?: string;
+        importance?: number;
+        generateEmbedding?: boolean;
+    }): Promise<MultiViewMemory>;
+    /**
+     * Index memory in all views
+     */
+    private indexMemory;
+    /**
+     * Query by entity
+     */
+    queryByEntity(entity: string): MultiViewMemory[];
+    /**
+     * Query by ENGRAM type
+     */
+    queryByENGRAMType(type: ENGRAMMemoryType): MultiViewMemory[];
+    /**
+     * Query by temporal bucket
+     */
+    queryByTemporal(bucket: string): MultiViewMemory[];
+    /**
+     * Smart query using task classification to select best view
+     */
+    smartQuery(query: string, limit?: number): Promise<MultiViewMemory[]>;
+    /**
+     * Get retrieval strategy based on task classification
+     */
+    private getRetrievalStrategy;
+    /**
+     * Execute a single strategy step
+     */
+    private executeStrategyStep;
+    /**
+     * Semantic search using embeddings
+     */
+    semanticSearch(query: string, limit?: number): Promise<MultiViewMemory[]>;
+    /**
+     * Process embedding queue asynchronously
+     */
+    private processEmbeddingQueue;
+    /**
+     * Extract entities from content
+     */
+    private extractEntities;
+    /**
+     * Record memory access
+     */
+    recordAccess(memoryId: string): void;
+    /**
+     * Get statistics
+     */
+    getStats(): {
+        totalMemories: number;
+        byENGRAMType: Record<ENGRAMMemoryType, number>;
+        pendingEmbeddings: number;
+        entitiesIndexed: number;
+    };
+    /**
+     * Export all memories
+     */
+    export(): MultiViewMemory[];
+    /**
+     * Import memories
+     */
+    import(memories: MultiViewMemory[]): Promise<void>;
+}
+export declare function getMultiViewMemoryManager(): MultiViewMemoryManager;
+//# sourceMappingURL=multi-view-memory.d.ts.map

package/dist/memory/multi-view-memory.d.ts.map

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