universal-agent-protocol 0.5.0

package/dist/memory/memory-maintenance.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Automated Memory Maintenance
+ *
+ * Periodic maintenance tasks: verify stale claims, prune decayed entries,
+ * consolidate daily logs, and surface maintenance recommendations.
+ *
+ * Inspired by Total Recall's maintenance cadences and Clawe's heartbeat system.
+ */
+export interface MaintenanceResult {
+    staleEntriesPruned: number;
+    decayedEntriesUpdated: number;
+    dailyLogsArchived: number;
+    duplicatesRemoved: number;
+    staleWorktrees: string[];
+    recommendations: string[];
+}
+export interface MaintenanceConfig {
+    staleDaysThreshold: number;
+    decayRate: number;
+    minImportanceAfterDecay: number;
+    archiveDaysOld: number;
+    duplicateSimilarityThreshold: number;
+}
+/**
+ * Run full maintenance cycle on the memory database.
+ */
+export declare function runMaintenance(dbPath: string, config?: Partial<MaintenanceConfig>): MaintenanceResult;
+/**
+ * Get a quick health summary without running full maintenance.
+ */
+export declare function getHealthSummary(dbPath: string): {
+    memoriesCount: number;
+    sessionCount: number;
+    dailyLogCount: number;
+    staleCount: number;
+    unpromotedCount: number;
+    healthy: boolean;
+};
+//# sourceMappingURL=memory-maintenance.d.ts.map

package/dist/memory/memory-maintenance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-maintenance.d.ts","sourceRoot":"","sources":["../../src/memory/memory-maintenance.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH,MAAM,WAAW,iBAAiB;IAChC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,iBAAiB;IAChC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,uBAAuB,EAAE,MAAM,CAAC;IAChC,cAAc,EAAE,MAAM,CAAC;IACvB,4BAA4B,EAAE,MAAM,CAAC;CACtC;AAUD;;GAEG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,MAAM,EACd,MAAM,GAAE,OAAO,CAAC,iBAAiB,CAAM,GACtC,iBAAiB,CA0CnB;AAoOD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG;IAChD,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,OAAO,CAAC;CAClB,CAyCA"}

package/dist/memory/memory-maintenance.js

@@ -0,0 +1,305 @@
+/**
+ * Automated Memory Maintenance
+ *
+ * Periodic maintenance tasks: verify stale claims, prune decayed entries,
+ * consolidate daily logs, and surface maintenance recommendations.
+ *
+ * Inspired by Total Recall's maintenance cadences and Clawe's heartbeat system.
+ */
+import Database from 'better-sqlite3';
+import { existsSync, readdirSync, statSync } from 'fs';
+import { join } from 'path';
+import { ensureDailyLogSchema } from './daily-log.js';
+const DEFAULT_CONFIG = {
+    staleDaysThreshold: 14,
+    decayRate: 0.95,
+    minImportanceAfterDecay: 1,
+    archiveDaysOld: 30,
+    duplicateSimilarityThreshold: 0.92,
+};
+/**
+ * Run full maintenance cycle on the memory database.
+ */
+export function runMaintenance(dbPath, config = {}) {
+    const cfg = { ...DEFAULT_CONFIG, ...config };
+    const result = {
+        staleEntriesPruned: 0,
+        decayedEntriesUpdated: 0,
+        dailyLogsArchived: 0,
+        duplicatesRemoved: 0,
+        staleWorktrees: [],
+        recommendations: [],
+    };
+    if (!existsSync(dbPath)) {
+        result.recommendations.push('Database not found. Run `uap init` first.');
+        return result;
+    }
+    const db = new Database(dbPath);
+    try {
+        // 1. Apply importance decay to old memories
+        result.decayedEntriesUpdated = applyDecay(db, cfg);
+        // 2. Prune entries that decayed below minimum importance
+        result.staleEntriesPruned = pruneStale(db, cfg);
+        // 3. Archive old daily log entries
+        result.dailyLogsArchived = archiveDailyLogs(db, cfg);
+        // 4. Remove duplicates
+        result.duplicatesRemoved = removeDuplicates(db);
+        // 5. Detect stale worktrees
+        result.staleWorktrees = detectStaleWorktrees(dbPath, cfg);
+        // 6. Generate recommendations
+        result.recommendations = generateRecommendations(db, cfg, result.staleWorktrees);
+    }
+    finally {
+        db.close();
+    }
+    return result;
+}
+function applyDecay(db, cfg) {
+    const now = Date.now();
+    let updated = 0;
+    try {
+        const rows = db.prepare(`
+      SELECT id, importance, timestamp
+      FROM memories
+      WHERE importance > ?
+    `).all(cfg.minImportanceAfterDecay);
+        const updateStmt = db.prepare('UPDATE memories SET importance = ? WHERE id = ?');
+        for (const row of rows) {
+            const daysSince = (now - new Date(row.timestamp).getTime()) / (1000 * 60 * 60 * 24);
+            if (daysSince < 1)
+                continue; // Skip recent entries
+            const decayed = Math.round(row.importance * Math.pow(cfg.decayRate, daysSince));
+            if (decayed !== row.importance && decayed >= cfg.minImportanceAfterDecay) {
+                updateStmt.run(decayed, row.id);
+                updated++;
+            }
+        }
+    }
+    catch {
+        // Table might not exist
+    }
+    try {
+        const rows = db.prepare(`
+      SELECT id, importance, timestamp
+      FROM session_memories
+      WHERE importance > ?
+    `).all(cfg.minImportanceAfterDecay);
+        const updateStmt = db.prepare('UPDATE session_memories SET importance = ? WHERE id = ?');
+        for (const row of rows) {
+            const daysSince = (now - new Date(row.timestamp).getTime()) / (1000 * 60 * 60 * 24);
+            if (daysSince < 1)
+                continue;
+            const decayed = Math.round(row.importance * Math.pow(cfg.decayRate, daysSince));
+            if (decayed !== row.importance && decayed >= cfg.minImportanceAfterDecay) {
+                updateStmt.run(decayed, row.id);
+                updated++;
+            }
+        }
+    }
+    catch {
+        // Table might not exist
+    }
+    return updated;
+}
+function pruneStale(db, cfg) {
+    let pruned = 0;
+    const cutoffDate = new Date();
+    cutoffDate.setDate(cutoffDate.getDate() - cfg.staleDaysThreshold);
+    const cutoff = cutoffDate.toISOString();
+    try {
+        const result = db.prepare(`
+      DELETE FROM memories
+      WHERE importance <= ? AND timestamp < ?
+    `).run(cfg.minImportanceAfterDecay, cutoff);
+        pruned += result.changes;
+    }
+    catch {
+        // Table might not exist
+    }
+    try {
+        const result = db.prepare(`
+      DELETE FROM session_memories
+      WHERE importance <= ? AND timestamp < ?
+    `).run(cfg.minImportanceAfterDecay, cutoff);
+        pruned += result.changes;
+    }
+    catch {
+        // Table might not exist
+    }
+    return pruned;
+}
+function archiveDailyLogs(db, cfg) {
+    try {
+        ensureDailyLogSchema(db);
+        const cutoff = new Date();
+        cutoff.setDate(cutoff.getDate() - cfg.archiveDaysOld);
+        const cutoffDate = cutoff.toISOString().split('T')[0];
+        // Delete promoted entries older than threshold
+        const result = db.prepare(`
+      DELETE FROM daily_log WHERE date < ? AND promoted = 1
+    `).run(cutoffDate);
+        return result.changes;
+    }
+    catch {
+        return 0;
+    }
+}
+function removeDuplicates(db) {
+    let removed = 0;
+    try {
+        // Remove exact duplicates in memories (keep lowest id)
+        const result = db.prepare(`
+      DELETE FROM memories
+      WHERE id NOT IN (
+        SELECT MIN(id) FROM memories GROUP BY content, project_id
+      )
+    `).run();
+        removed += result.changes;
+    }
+    catch {
+        // Table might not exist
+    }
+    try {
+        // Remove exact duplicates in session_memories
+        const result = db.prepare(`
+      DELETE FROM session_memories
+      WHERE id NOT IN (
+        SELECT MIN(id) FROM session_memories GROUP BY content, session_id
+      )
+    `).run();
+        removed += result.changes;
+    }
+    catch {
+        // Table might not exist
+    }
+    return removed;
+}
+function detectStaleWorktrees(dbPath, cfg) {
+    // Look for .worktrees directory relative to the DB path
+    // DB is typically at agents/data/memory/short_term.db, project root is 3 levels up
+    const projectRoot = join(dbPath, '..', '..', '..', '..');
+    const worktreesDir = join(projectRoot, '.worktrees');
+    if (!existsSync(worktreesDir))
+        return [];
+    const stale = [];
+    const staleDays = cfg.archiveDaysOld; // reuse same threshold
+    const cutoff = Date.now() - staleDays * 24 * 60 * 60 * 1000;
+    try {
+        const entries = readdirSync(worktreesDir);
+        for (const entry of entries) {
+            const entryPath = join(worktreesDir, entry);
+            try {
+                const stats = statSync(entryPath);
+                if (stats.isDirectory() && stats.mtimeMs < cutoff) {
+                    stale.push(entry);
+                }
+            }
+            catch {
+                // Skip entries we can't stat
+            }
+        }
+    }
+    catch {
+        // Can't read directory
+    }
+    return stale;
+}
+function generateRecommendations(db, cfg, staleWorktrees = []) {
+    const recs = [];
+    try {
+        // Check total memory count
+        const memCount = db.prepare('SELECT COUNT(*) as c FROM memories').get().c;
+        if (memCount > 45) {
+            recs.push(`Working memory near capacity (${memCount}/50). Consider promoting important entries and pruning old ones.`);
+        }
+        // Check for stale entries
+        const staleDate = new Date();
+        staleDate.setDate(staleDate.getDate() - cfg.staleDaysThreshold);
+        const staleCount = db.prepare(`
+      SELECT COUNT(*) as c FROM memories WHERE timestamp < ? AND importance <= 3
+    `).get(staleDate.toISOString()).c;
+        if (staleCount > 0) {
+            recs.push(`${staleCount} stale entries with low importance found. Run maintenance again or review manually.`);
+        }
+    }
+    catch {
+        // Table might not exist
+    }
+    try {
+        // Check unpromoted daily log entries
+        ensureDailyLogSchema(db);
+        const unpromoted = db.prepare(`
+      SELECT COUNT(*) as c FROM daily_log WHERE promoted = 0
+    `).get().c;
+        if (unpromoted > 10) {
+            recs.push(`${unpromoted} unpromoted daily log entries. Run \`uap memory promote\` to review.`);
+        }
+    }
+    catch {
+        // Table might not exist
+    }
+    try {
+        // Check for entries with very low importance
+        const lowImp = db.prepare(`
+      SELECT COUNT(*) as c FROM session_memories WHERE importance <= 2
+    `).get().c;
+        if (lowImp > 20) {
+            recs.push(`${lowImp} session memories with very low importance. These may be pruned on next maintenance.`);
+        }
+    }
+    catch {
+        // Table might not exist
+    }
+    if (staleWorktrees.length > 0) {
+        recs.push(`${staleWorktrees.length} stale worktrees found (>${cfg.archiveDaysOld} days old): ${staleWorktrees.slice(0, 5).join(', ')}${staleWorktrees.length > 5 ? '...' : ''}. Run \`uap worktree cleanup <id>\` to remove.`);
+    }
+    if (recs.length === 0) {
+        recs.push('Memory system is healthy. No action needed.');
+    }
+    return recs;
+}
+/**
+ * Get a quick health summary without running full maintenance.
+ */
+export function getHealthSummary(dbPath) {
+    const summary = {
+        memoriesCount: 0,
+        sessionCount: 0,
+        dailyLogCount: 0,
+        staleCount: 0,
+        unpromotedCount: 0,
+        healthy: true,
+    };
+    if (!existsSync(dbPath))
+        return summary;
+    const db = new Database(dbPath, { readonly: true });
+    try {
+        try {
+            summary.memoriesCount = db.prepare('SELECT COUNT(*) as c FROM memories').get().c;
+        }
+        catch { /* table doesn't exist */ }
+        try {
+            summary.sessionCount = db.prepare('SELECT COUNT(*) as c FROM session_memories').get().c;
+        }
+        catch { /* table doesn't exist */ }
+        try {
+            summary.dailyLogCount = db.prepare('SELECT COUNT(*) as c FROM daily_log').get().c;
+            summary.unpromotedCount = db.prepare('SELECT COUNT(*) as c FROM daily_log WHERE promoted = 0').get().c;
+        }
+        catch { /* table doesn't exist */ }
+        const staleDate = new Date();
+        staleDate.setDate(staleDate.getDate() - 14);
+        try {
+            summary.staleCount = db.prepare(`
+        SELECT COUNT(*) as c FROM memories WHERE timestamp < ? AND importance <= 3
+      `).get(staleDate.toISOString()).c;
+        }
+        catch { /* table doesn't exist */ }
+        summary.healthy = summary.memoriesCount <= 45 && summary.staleCount < 10 && summary.unpromotedCount < 20;
+    }
+    finally {
+        db.close();
+    }
+    return summary;
+}
+//# sourceMappingURL=memory-maintenance.js.map

package/dist/memory/memory-maintenance.js.map

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

package/dist/memory/model-router.d.ts

@@ -0,0 +1,102 @@
+/**
+ * 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.
+ */
+export type ModelId = 'glm-4.7' | 'gpt-5.2' | 'claude-opus-4.5' | 'gpt-5.2-codex';
+export interface CategoryStats {
+    attempts: number;
+    successes: number;
+}
+export interface ModelFingerprint {
+    id: ModelId;
+    strengths: string[];
+    weaknesses: string[];
+    avgLatencyMs: number;
+    successRate: number;
+    costPerTask: number;
+    maxComplexity: 'easy' | 'medium' | 'hard';
+    bestCategories: string[];
+    categoryStats?: Record<string, CategoryStats>;
+}
+export interface RoutingDecision {
+    primary: ModelId;
+    fallback: ModelId[];
+    reason: string;
+    estimatedLatencyMs: number;
+    estimatedSuccessRate: number;
+    estimatedCost: number;
+}
+export interface RoutingConfig {
+    preferLatency: boolean;
+    preferAccuracy: boolean;
+    maxCostPerTask: number;
+    maxLatencyMs: number;
+    availableModels: ModelId[];
+}
+/**
+ * Failure handlers for model-specific known issues
+ */
+declare const FAILURE_HANDLERS: Record<string, {
+    action: 'add_context' | 'reduce_context' | 'switch_model';
+    context?: string;
+    fallbackModel?: ModelId;
+}>;
+/**
+ * Route a task to the best model
+ */
+export declare function routeTask(instruction: string, difficulty?: 'easy' | 'medium' | 'hard', config?: Partial<RoutingConfig>): RoutingDecision;
+/**
+ * Get failure handler for a model-specific error
+ */
+export declare function getFailureHandler(modelId: ModelId, errorType: string): typeof FAILURE_HANDLERS[string] | null;
+/**
+ * Get model fingerprint
+ */
+export declare function getModelFingerprint(modelId: ModelId): ModelFingerprint | null;
+/**
+ * Get all model fingerprints
+ */
+export declare function getAllModelFingerprints(): Record<ModelId, ModelFingerprint>;
+/**
+ * Update model fingerprint with new benchmark data
+ */
+export declare function updateModelFingerprint(modelId: ModelId, updates: Partial<Pick<ModelFingerprint, 'avgLatencyMs' | 'successRate' | 'costPerTask'>>): void;
+/**
+ * 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 declare function recordTaskOutcome(modelId: ModelId, success: boolean, latencyMs: number, taskCategory?: string): void;
+/**
+ * Get routing recommendation with explanation
+ */
+export declare function explainRouting(instruction: string, difficulty?: 'easy' | 'medium' | 'hard'): string;
+/**
+ * OPT 8: Close fingerprint database connection
+ */
+export declare function closeFingerprintDb(): void;
+/**
+ * OPT 8: Force reload fingerprints from database
+ */
+export declare function reloadFingerprints(): void;
+export declare const ModelRouter: {
+    routeTask: typeof routeTask;
+    getFailureHandler: typeof getFailureHandler;
+    getModelFingerprint: typeof getModelFingerprint;
+    getAllModelFingerprints: typeof getAllModelFingerprints;
+    updateModelFingerprint: typeof updateModelFingerprint;
+    recordTaskOutcome: typeof recordTaskOutcome;
+    explainRouting: typeof explainRouting;
+    closeFingerprintDb: typeof closeFingerprintDb;
+    reloadFingerprints: typeof reloadFingerprints;
+};
+export default ModelRouter;
+//# sourceMappingURL=model-router.d.ts.map

package/dist/memory/model-router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-router.d.ts","sourceRoot":"","sources":["../../src/memory/model-router.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAWH,MAAM,MAAM,OAAO,GAAG,SAAS,GAAG,SAAS,GAAG,iBAAiB,GAAG,eAAe,CAAC;AAElF,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,OAAO,CAAC;IACZ,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAC;IAC1C,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;CAC/C;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,kBAAkB,EAAE,MAAM,CAAC;IAC3B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,aAAa;IAC5B,aAAa,EAAE,OAAO,CAAC;IACvB,cAAc,EAAE,OAAO,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,OAAO,EAAE,CAAC;CAC5B;AAyND;;GAEG;AACH,QAAA,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE;IACrC,MAAM,EAAE,aAAa,GAAG,gBAAgB,GAAG,cAAc,CAAC;IAC1D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB,CAcA,CAAC;AAuFF;;GAEG;AACH,wBAAgB,SAAS,CACvB,WAAW,EAAE,MAAM,EACnB,UAAU,GAAE,MAAM,GAAG,QAAQ,GAAG,MAAiB,EACjD,MAAM,GAAE,OAAO,CAAC,aAAa,CAAM,GAClC,eAAe,CAoCjB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,gBAAgB,CAAC,MAAM,CAAC,GAAG,IAAI,CAE7G;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,gBAAgB,GAAG,IAAI,CAE7E;AAED;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,MAAM,CAAC,OAAO,EAAE,gBAAgB,CAAC,CAE3E;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,gBAAgB,EAAE,cAAc,GAAG,aAAa,GAAG,aAAa,CAAC,CAAC,GACvF,IAAI,CAcN;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,OAAO,EAChB,SAAS,EAAE,MAAM,EACjB,YAAY,CAAC,EAAE,MAAM,GACpB,IAAI,CA4BN;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,GAAE,MAAM,GAAG,QAAQ,GAAG,MAAiB,GAAG,MAAM,CAc7G;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAKzC;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC;AAED,eAAO,MAAM,WAAW;;;;;;;;;;CAUvB,CAAC;AAEF,eAAe,WAAW,CAAC"}