@timmeck/brain-core 2.36.24 → 2.36.25

package/dist/tool-learning/tool-patterns.d.ts

@@ -0,0 +1,47 @@
+import type Database from 'better-sqlite3';
+export interface ToolSequence {
+    sequence: string[];
+    count: number;
+}
+export interface ToolPrediction {
+    tool: string;
+    probability: number;
+}
+export interface ToolPair {
+    toolA: string;
+    toolB: string;
+    count: number;
+}
+/** A single from→to transition with its count. */
+export interface ToolTransition {
+    from: string;
+    to: string;
+    count: number;
+}
+export declare class ToolPatternAnalyzer {
+    private db;
+    private log;
+    private stmtAllUsage;
+    private stmtWindowUsage;
+    constructor(db: Database.Database);
+    /**
+     * Find common tool sequences (N-grams) of the given window size.
+     * Returns sequences sorted by frequency descending.
+     */
+    getSequences(windowSize?: number): ToolSequence[];
+    /**
+     * Build a Markov transition matrix: which tool follows which.
+     * Returns Map<toolA, Map<toolB, count>>.
+     */
+    getTransitions(): Map<string, Map<string, number>>;
+    /**
+     * Predict the top 3 most likely next tools given the current tool,
+     * based on transition probabilities from the Markov chain.
+     */
+    predictNext(currentTool: string): ToolPrediction[];
+    /**
+     * Find tool pairs that frequently occur together within 5-minute windows.
+     * Returns pairs sorted by co-occurrence count descending.
+     */
+    getFrequentPairs(): ToolPair[];
+}

package/dist/tool-learning/tool-patterns.js

@@ -0,0 +1,125 @@
+// ── Tool Pattern Analyzer — Sequence & Transition Analysis ───
+//
+// Analyzes tool usage sequences to find patterns, build Markov
+// transition matrices, and predict likely next tools.
+import { getLogger } from '../utils/logger.js';
+// ── Engine ──────────────────────────────────────────────
+export class ToolPatternAnalyzer {
+    db;
+    log = getLogger();
+    // Prepared statements
+    stmtAllUsage;
+    stmtWindowUsage;
+    constructor(db) {
+        this.db = db;
+        // These statements query the tool_usage table created by ToolTracker
+        this.stmtAllUsage = db.prepare(`
+      SELECT tool_name, created_at FROM tool_usage ORDER BY created_at ASC
+    `);
+        this.stmtWindowUsage = db.prepare(`
+      SELECT tool_name, created_at FROM tool_usage ORDER BY created_at ASC
+    `);
+        this.log.info('[tool-patterns] Analyzer initialized');
+    }
+    /**
+     * Find common tool sequences (N-grams) of the given window size.
+     * Returns sequences sorted by frequency descending.
+     */
+    getSequences(windowSize = 3) {
+        const rows = this.stmtAllUsage.all();
+        if (rows.length < windowSize)
+            return [];
+        const seqMap = new Map();
+        for (let i = 0; i <= rows.length - windowSize; i++) {
+            const seq = rows.slice(i, i + windowSize).map(r => r.tool_name);
+            const key = seq.join(' → ');
+            seqMap.set(key, (seqMap.get(key) ?? 0) + 1);
+        }
+        const sequences = [];
+        for (const [key, count] of seqMap.entries()) {
+            if (count >= 2) {
+                sequences.push({ sequence: key.split(' → '), count });
+            }
+        }
+        sequences.sort((a, b) => b.count - a.count);
+        return sequences;
+    }
+    /**
+     * Build a Markov transition matrix: which tool follows which.
+     * Returns Map<toolA, Map<toolB, count>>.
+     */
+    getTransitions() {
+        const rows = this.stmtAllUsage.all();
+        const transitions = new Map();
+        for (let i = 0; i < rows.length - 1; i++) {
+            const from = rows[i].tool_name;
+            const to = rows[i + 1].tool_name;
+            if (!transitions.has(from)) {
+                transitions.set(from, new Map());
+            }
+            const inner = transitions.get(from);
+            inner.set(to, (inner.get(to) ?? 0) + 1);
+        }
+        return transitions;
+    }
+    /**
+     * Predict the top 3 most likely next tools given the current tool,
+     * based on transition probabilities from the Markov chain.
+     */
+    predictNext(currentTool) {
+        const transitions = this.getTransitions();
+        const fromMap = transitions.get(currentTool);
+        if (!fromMap || fromMap.size === 0)
+            return [];
+        // Calculate total transitions from this tool
+        let total = 0;
+        for (const count of fromMap.values()) {
+            total += count;
+        }
+        const predictions = [];
+        for (const [tool, count] of fromMap.entries()) {
+            predictions.push({
+                tool,
+                probability: count / total,
+            });
+        }
+        predictions.sort((a, b) => b.probability - a.probability);
+        return predictions.slice(0, 3);
+    }
+    /**
+     * Find tool pairs that frequently occur together within 5-minute windows.
+     * Returns pairs sorted by co-occurrence count descending.
+     */
+    getFrequentPairs() {
+        const rows = this.stmtWindowUsage.all();
+        if (rows.length < 2)
+            return [];
+        const pairMap = new Map();
+        const WINDOW_MS = 5 * 60 * 1000; // 5 minutes
+        for (let i = 0; i < rows.length; i++) {
+            const timeI = new Date(rows[i].created_at).getTime();
+            for (let j = i + 1; j < rows.length; j++) {
+                const timeJ = new Date(rows[j].created_at).getTime();
+                if (timeJ - timeI > WINDOW_MS)
+                    break;
+                const toolA = rows[i].tool_name;
+                const toolB = rows[j].tool_name;
+                if (toolA === toolB)
+                    continue;
+                // Normalize pair key (alphabetical order) so A-B and B-A count together
+                const key = toolA < toolB ? `${toolA}|${toolB}` : `${toolB}|${toolA}`;
+                pairMap.set(key, (pairMap.get(key) ?? 0) + 1);
+            }
+        }
+        const pairs = [];
+        for (const [key, count] of pairMap.entries()) {
+            if (count >= 2) {
+                const [toolA, toolB] = key.split('|');
+                pairs.push({ toolA, toolB, count });
+            }
+        }
+        pairs.sort((a, b) => b.count - a.count);
+        return pairs;
+    }
+}
+//# sourceMappingURL=tool-patterns.js.map

package/dist/tool-learning/tool-patterns.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-patterns.js","sourceRoot":"","sources":["../../src/tool-learning/tool-patterns.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,EAAE;AACF,+DAA+D;AAC/D,sDAAsD;AAGtD,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AA2B/C,2DAA2D;AAE3D,MAAM,OAAO,mBAAmB;IACtB,EAAE,CAAoB;IACtB,GAAG,GAAG,SAAS,EAAE,CAAC;IAE1B,sBAAsB;IACd,YAAY,CAAqB;IACjC,eAAe,CAAqB;IAE5C,YAAY,EAAqB;QAC/B,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;QAEb,qEAAqE;QACrE,IAAI,CAAC,YAAY,GAAG,EAAE,CAAC,OAAO,CAAC;;KAE9B,CAAC,CAAC;QAEH,IAAI,CAAC,eAAe,GAAG,EAAE,CAAC,OAAO,CAAC;;KAEjC,CAAC,CAAC;QAEH,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,sCAAsC,CAAC,CAAC;IACxD,CAAC;IAED;;;OAGG;IACH,YAAY,CAAC,UAAU,GAAG,CAAC;QACzB,MAAM,IAAI,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,EAAsD,CAAC;QAEzF,IAAI,IAAI,CAAC,MAAM,GAAG,UAAU;YAAE,OAAO,EAAE,CAAC;QAExC,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;QAEzC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC,MAAM,GAAG,UAAU,EAAE,CAAC,EAAE,EAAE,CAAC;YACnD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;YAChE,MAAM,GAAG,GAAG,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC5B,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAC9C,CAAC;QAED,MAAM,SAAS,GAAmB,EAAE,CAAC;QACrC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,EAAE,EAAE,CAAC;YAC5C,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;gBACf,SAAS,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;YACxD,CAAC;QACH,CAAC;QAED,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;QAC5C,OAAO,SAAS,CAAC;IACnB,CAAC;IAED;;;OAGG;IACH,cAAc;QACZ,MAAM,IAAI,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,EAAsD,CAAC;QACzF,MAAM,WAAW,GAAG,IAAI,GAAG,EAA+B,CAAC;QAE3D,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YACzC,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,CAAE,CAAC,SAAS,CAAC;YAChC,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,CAAE,CAAC,SAAS,CAAC;YAElC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC3B,WAAW,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,GAAG,EAAE,CAAC,CAAC;YACnC,CAAC;YACD,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,CAAC,IAAI,CAAE,CAAC;YACrC,KAAK,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAC1C,CAAC;QAED,OAAO,WAAW,CAAC;IACrB,CAAC;IAED;;;OAGG;IACH,WAAW,CAAC,WAAmB;QAC7B,MAAM,WAAW,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC;QAC1C,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QAE7C,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,IAAI,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QAE9C,6CAA6C;QAC7C,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;YACrC,KAAK,IAAI,KAAK,CAAC;QACjB,CAAC;QAED,MAAM,WAAW,GAAqB,EAAE,CAAC;QACzC,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;YAC9C,WAAW,CAAC,IAAI,CAAC;gBACf,IAAI;gBACJ,WAAW,EAAE,KAAK,GAAG,KAAK;aAC3B,CAAC,CAAC;QACL,CAAC;QAED,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC,WAAW,CAAC,CAAC;QAC1D,OAAO,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACjC,CAAC;IAED;;;OAGG;IACH,gBAAgB;QACd,MAAM,IAAI,GAAG,IAAI,CAAC,eAAe,CAAC,GAAG,EAAsD,CAAC;QAE5F,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,EAAE,CAAC;QAE/B,MAAM,OAAO,GAAG,IAAI,GAAG,EAAkB,CAAC;QAC1C,MAAM,SAAS,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,YAAY;QAE7C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACrC,MAAM,KAAK,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,CAAE,CAAC,UAAU,CAAC,CAAC,OAAO,EAAE,CAAC;YAEtD,KAAK,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBACzC,MAAM,KAAK,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,CAAE,CAAC,UAAU,CAAC,CAAC,OAAO,EAAE,CAAC;gBAEtD,IAAI,KAAK,GAAG,KAAK,GAAG,SAAS;oBAAE,MAAM;gBAErC,MAAM,KAAK,GAAG,IAAI,CAAC,CAAC,CAAE,CAAC,SAAS,CAAC;gBACjC,MAAM,KAAK,GAAG,IAAI,CAAC,CAAC,CAAE,CAAC,SAAS,CAAC;gBAEjC,IAAI,KAAK,KAAK,KAAK;oBAAE,SAAS;gBAE9B,wEAAwE;gBACxE,MAAM,GAAG,GAAG,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,IAAI,KAAK,EAAE,CAAC;gBACtE,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YAChD,CAAC;QACH,CAAC;QAED,MAAM,KAAK,GAAe,EAAE,CAAC;QAC7B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;YAC7C,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;gBACf,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAqB,CAAC;gBAC1D,KAAK,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;YACtC,CAAC;QACH,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;QACxC,OAAO,KAAK,CAAC;IACf,CAAC;CACF"}

package/dist/tool-learning/tool-tracker.d.ts

@@ -0,0 +1,58 @@
+import type Database from 'better-sqlite3';
+import type { ThoughtStream } from '../consciousness/thought-stream.js';
+export type ToolOutcome = 'success' | 'failure' | 'partial';
+export interface ToolUsageRecord {
+    id?: number;
+    tool_name: string;
+    context: string | null;
+    duration_ms: number | null;
+    outcome: ToolOutcome;
+    metadata: Record<string, unknown> | null;
+    created_at: string;
+}
+export interface ToolStats {
+    tool: string;
+    totalUses: number;
+    successRate: number;
+    avgDuration: number;
+    lastUsed: string;
+}
+export interface ToolRecommendation {
+    tool: string;
+    score: number;
+    successRate: number;
+    frequency: number;
+}
+export interface ToolTrackerStatus {
+    totalTracked: number;
+    uniqueTools: number;
+    avgSuccessRate: number;
+}
+export interface ToolTrackerConfig {
+    brainName: string;
+}
+export declare function runToolTrackerMigration(db: Database.Database): void;
+export declare class ToolTracker {
+    private db;
+    private config;
+    private ts;
+    private log;
+    private stmtInsert;
+    private stmtStatsSingle;
+    private stmtStatsAll;
+    private stmtRecommend;
+    private stmtTotalTracked;
+    private stmtUniqueTools;
+    private stmtAvgSuccessRate;
+    constructor(db: Database.Database, config: ToolTrackerConfig);
+    /** Set the ThoughtStream for consciousness integration. */
+    setThoughtStream(stream: ThoughtStream): void;
+    /** Record a tool usage event. */
+    recordUsage(tool: string, context: string | null, duration: number | null, outcome?: ToolOutcome, metadata?: Record<string, unknown>): void;
+    /** Get statistics for a specific tool, or all tools if none specified. */
+    getToolStats(tool?: string): ToolStats | ToolStats[];
+    /** Recommend top-5 tools for a given context based on success rate * frequency. */
+    recommend(context: string): ToolRecommendation[];
+    /** Get tracker status summary. */
+    getStatus(): ToolTrackerStatus;
+}

package/dist/tool-learning/tool-tracker.js

@@ -0,0 +1,135 @@
+// ── Tool Tracker — Usage Recording & Recommendation ──────────
+//
+// Tracks tool usage with context, duration, and outcome.
+// Provides statistics and context-based recommendations.
+import { getLogger } from '../utils/logger.js';
+// ── Migration ───────────────────────────────────────────
+export function runToolTrackerMigration(db) {
+    db.exec(`
+    CREATE TABLE IF NOT EXISTS tool_usage (
+      id INTEGER PRIMARY KEY,
+      tool_name TEXT NOT NULL,
+      context TEXT,
+      duration_ms INTEGER,
+      outcome TEXT DEFAULT 'success' CHECK(outcome IN ('success','failure','partial')),
+      metadata TEXT,
+      created_at TEXT DEFAULT (datetime('now'))
+    );
+    CREATE INDEX IF NOT EXISTS idx_tool_usage_tool_name ON tool_usage(tool_name);
+  `);
+}
+// ── Engine ──────────────────────────────────────────────
+export class ToolTracker {
+    db;
+    config;
+    ts = null;
+    log = getLogger();
+    // Prepared statements
+    stmtInsert;
+    stmtStatsSingle;
+    stmtStatsAll;
+    stmtRecommend;
+    stmtTotalTracked;
+    stmtUniqueTools;
+    stmtAvgSuccessRate;
+    constructor(db, config) {
+        this.db = db;
+        this.config = config;
+        runToolTrackerMigration(db);
+        // Prepare all statements
+        this.stmtInsert = db.prepare(`
+      INSERT INTO tool_usage (tool_name, context, duration_ms, outcome, metadata)
+      VALUES (?, ?, ?, ?, ?)
+    `);
+        this.stmtStatsSingle = db.prepare(`
+      SELECT
+        tool_name AS tool,
+        COUNT(*) AS totalUses,
+        CAST(SUM(CASE WHEN outcome = 'success' THEN 1 ELSE 0 END) AS REAL) / COUNT(*) AS successRate,
+        COALESCE(AVG(duration_ms), 0) AS avgDuration,
+        MAX(created_at) AS lastUsed
+      FROM tool_usage
+      WHERE tool_name = ?
+      GROUP BY tool_name
+    `);
+        this.stmtStatsAll = db.prepare(`
+      SELECT
+        tool_name AS tool,
+        COUNT(*) AS totalUses,
+        CAST(SUM(CASE WHEN outcome = 'success' THEN 1 ELSE 0 END) AS REAL) / COUNT(*) AS successRate,
+        COALESCE(AVG(duration_ms), 0) AS avgDuration,
+        MAX(created_at) AS lastUsed
+      FROM tool_usage
+      GROUP BY tool_name
+      ORDER BY totalUses DESC
+    `);
+        this.stmtRecommend = db.prepare(`
+      SELECT
+        tool_name AS tool,
+        COUNT(*) AS frequency,
+        CAST(SUM(CASE WHEN outcome = 'success' THEN 1 ELSE 0 END) AS REAL) / COUNT(*) AS successRate
+      FROM tool_usage
+      WHERE context LIKE ?
+      GROUP BY tool_name
+      ORDER BY (CAST(SUM(CASE WHEN outcome = 'success' THEN 1 ELSE 0 END) AS REAL) / COUNT(*)) * COUNT(*) DESC
+      LIMIT 5
+    `);
+        this.stmtTotalTracked = db.prepare(`
+      SELECT COUNT(*) AS total FROM tool_usage
+    `);
+        this.stmtUniqueTools = db.prepare(`
+      SELECT COUNT(DISTINCT tool_name) AS unique_tools FROM tool_usage
+    `);
+        this.stmtAvgSuccessRate = db.prepare(`
+      SELECT COALESCE(
+        CAST(SUM(CASE WHEN outcome = 'success' THEN 1 ELSE 0 END) AS REAL) / NULLIF(COUNT(*), 0),
+        0
+      ) AS avgRate
+      FROM tool_usage
+    `);
+        this.log.info(`[tool-tracker] Initialized for ${config.brainName}`);
+    }
+    /** Set the ThoughtStream for consciousness integration. */
+    setThoughtStream(stream) {
+        this.ts = stream;
+    }
+    /** Record a tool usage event. */
+    recordUsage(tool, context, duration, outcome = 'success', metadata) {
+        this.stmtInsert.run(tool, context, duration, outcome, metadata ? JSON.stringify(metadata) : null);
+        this.ts?.emit('tool-tracker', 'analyzing', `Recorded ${tool} usage: ${outcome}${duration ? ` (${duration}ms)` : ''}`, 'routine');
+    }
+    /** Get statistics for a specific tool, or all tools if none specified. */
+    getToolStats(tool) {
+        if (tool) {
+            const row = this.stmtStatsSingle.get(tool);
+            if (!row) {
+                return { tool, totalUses: 0, successRate: 0, avgDuration: 0, lastUsed: '' };
+            }
+            return row;
+        }
+        return this.stmtStatsAll.all();
+    }
+    /** Recommend top-5 tools for a given context based on success rate * frequency. */
+    recommend(context) {
+        const pattern = `%${context}%`;
+        const rows = this.stmtRecommend.all(pattern);
+        return rows.map(r => ({
+            tool: r.tool,
+            score: r.successRate * r.frequency,
+            successRate: r.successRate,
+            frequency: r.frequency,
+        }));
+    }
+    /** Get tracker status summary. */
+    getStatus() {
+        const total = this.stmtTotalTracked.get().total;
+        const unique = this.stmtUniqueTools.get().unique_tools;
+        const avgRate = this.stmtAvgSuccessRate.get().avgRate;
+        return {
+            totalTracked: total,
+            uniqueTools: unique,
+            avgSuccessRate: avgRate,
+        };
+    }
+}
+//# sourceMappingURL=tool-tracker.js.map

package/dist/tool-learning/tool-tracker.js.map

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

package/dist/user-model/__tests__/user-model.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/user-model/__tests__/user-model.test.js

@@ -0,0 +1,142 @@
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+import Database from 'better-sqlite3';
+vi.mock('../../utils/logger.js', () => ({
+    getLogger: () => ({
+        info: vi.fn(), warn: vi.fn(), error: vi.fn(), debug: vi.fn(),
+    }),
+}));
+import { UserModel, runUserModelMigration } from '../user-model.js';
+import { AdaptiveContext } from '../adaptive-context.js';
+function createDb() {
+    return new Database(':memory:');
+}
+describe('UserModel', () => {
+    let db;
+    beforeEach(() => {
+        db = createDb();
+    });
+    afterEach(() => {
+        db.close();
+    });
+    it('sets and gets a preference', () => {
+        const model = new UserModel(db, { brainName: 'test' });
+        model.setPreference('theme', 'dark');
+        expect(model.getPreference('theme')).toBe('dark');
+    });
+    it('returns null for unknown preference', () => {
+        const model = new UserModel(db, { brainName: 'test' });
+        expect(model.getPreference('nonexistent')).toBeNull();
+    });
+    it('updateFromInteraction tracks tool frequency', () => {
+        const model = new UserModel(db, { brainName: 'test' });
+        model.updateFromInteraction('mcp.search', 'finding code', 'success');
+        model.updateFromInteraction('mcp.search', 'finding docs', 'success');
+        const profile = model.getProfile();
+        expect(profile.topTools).toContain('mcp.search');
+    });
+    it('infers beginner skill level for < 3 successful uses', () => {
+        const model = new UserModel(db, { brainName: 'test' });
+        model.updateFromInteraction('trading.analyze', 'stocks', 'success');
+        model.updateFromInteraction('trading.analyze', 'stocks', 'success');
+        const profile = model.getProfile();
+        expect(profile.skillDomains.get('trading')).toBe('beginner');
+    });
+    it('infers intermediate skill level for 3-10 successful uses', () => {
+        const model = new UserModel(db, { brainName: 'test' });
+        for (let i = 0; i < 5; i++) {
+            model.updateFromInteraction('trading.analyze', 'stocks', 'success');
+        }
+        const profile = model.getProfile();
+        expect(profile.skillDomains.get('trading')).toBe('intermediate');
+    });
+    it('infers expert skill level for > 10 successful uses', () => {
+        const model = new UserModel(db, { brainName: 'test' });
+        for (let i = 0; i < 12; i++) {
+            model.updateFromInteraction('coding.refactor', 'cleanup', 'success');
+        }
+        const profile = model.getProfile();
+        expect(profile.skillDomains.get('coding')).toBe('expert');
+    });
+    it('getProfile returns complete structure', () => {
+        const model = new UserModel(db, { brainName: 'test' });
+        model.updateFromInteraction('mcp.search', 'ctx', 'success');
+        const profile = model.getProfile();
+        expect(profile.skillDomains).toBeInstanceOf(Map);
+        expect(Array.isArray(profile.topTools)).toBe(true);
+        expect(Array.isArray(profile.activeHours)).toBe(true);
+        expect(Array.isArray(profile.errorPatterns)).toBe(true);
+    });
+    it('migration is idempotent', () => {
+        const model1 = new UserModel(db, { brainName: 'test' });
+        model1.setPreference('lang', 'en');
+        // Run migration again
+        runUserModelMigration(db);
+        const model2 = new UserModel(db, { brainName: 'test' });
+        expect(model2.getPreference('lang')).toBe('en');
+    });
+    it('getStatus returns correct counts', () => {
+        const model = new UserModel(db, { brainName: 'test' });
+        const emptyStatus = model.getStatus();
+        expect(emptyStatus.totalKeys).toBe(0);
+        expect(emptyStatus.domains).toBe(0);
+        expect(emptyStatus.lastUpdated).toBeNull();
+        model.updateFromInteraction('mcp.search', 'ctx', 'success');
+        const status = model.getStatus();
+        expect(status.totalKeys).toBeGreaterThan(0);
+        expect(status.domains).toBeGreaterThanOrEqual(1);
+        expect(status.lastUpdated).not.toBeNull();
+    });
+});
+describe('AdaptiveContext', () => {
+    it('returns concise for all-expert profile', () => {
+        const ctx = new AdaptiveContext();
+        const profile = {
+            skillDomains: new Map([['coding', 'expert'], ['trading', 'expert']]),
+            topTools: [],
+            activeHours: [],
+            errorPatterns: [],
+        };
+        const result = ctx.enrichPrompt('How do I do X?', profile);
+        expect(result).toContain('Be concise');
+        expect(result).toContain('How do I do X?');
+        expect(ctx.getDetailLevel(profile)).toBe('concise');
+    });
+    it('returns detailed for profile with any beginner domain', () => {
+        const ctx = new AdaptiveContext();
+        const profile = {
+            skillDomains: new Map([['coding', 'expert'], ['trading', 'beginner']]),
+            topTools: [],
+            activeHours: [],
+            errorPatterns: [],
+        };
+        const result = ctx.enrichPrompt('How do I do X?', profile);
+        expect(result).toContain('Explain in detail');
+        expect(result).toContain('How do I do X?');
+        expect(ctx.getDetailLevel(profile)).toBe('detailed');
+    });
+    it('returns unmodified prompt for default/mixed profile', () => {
+        const ctx = new AdaptiveContext();
+        const profile = {
+            skillDomains: new Map([['coding', 'intermediate'], ['trading', 'expert']]),
+            topTools: [],
+            activeHours: [],
+            errorPatterns: [],
+        };
+        const result = ctx.enrichPrompt('How do I do X?', profile);
+        expect(result).toBe('How do I do X?');
+        expect(ctx.getDetailLevel(profile)).toBe('normal');
+    });
+    it('returns normal for empty profile', () => {
+        const ctx = new AdaptiveContext();
+        const profile = {
+            skillDomains: new Map(),
+            topTools: [],
+            activeHours: [],
+            errorPatterns: [],
+        };
+        const result = ctx.enrichPrompt('Hello', profile);
+        expect(result).toBe('Hello');
+        expect(ctx.getDetailLevel(profile)).toBe('normal');
+    });
+});
+//# sourceMappingURL=user-model.test.js.map

package/dist/user-model/__tests__/user-model.test.js.map

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

package/dist/user-model/adaptive-context.d.ts

@@ -0,0 +1,18 @@
+import type { UserProfile } from './user-model.js';
+export type DetailLevel = 'concise' | 'normal' | 'detailed';
+export declare class AdaptiveContext {
+    /**
+     * Enrich a base prompt based on the user's profile.
+     * - If all domains are 'expert': prepend concise instructions.
+     * - If any domain is 'beginner': prepend detailed instructions.
+     * - Default: return prompt unmodified.
+     */
+    enrichPrompt(basePrompt: string, profile: UserProfile): string;
+    /**
+     * Determine the appropriate detail level from a user profile.
+     * - 'concise': all domains are expert level
+     * - 'detailed': any domain is beginner level
+     * - 'normal': default / mixed intermediate
+     */
+    getDetailLevel(profile: UserProfile): DetailLevel;
+}

package/dist/user-model/adaptive-context.js

@@ -0,0 +1,46 @@
+// ── Adaptive Context — Prompt Enrichment Based on User Profile ─
+//
+// Adjusts prompt detail level based on the user's skill profile.
+// Expert users get concise responses; beginners get detailed explanations.
+// ── Functions ───────────────────────────────────────────
+export class AdaptiveContext {
+    /**
+     * Enrich a base prompt based on the user's profile.
+     * - If all domains are 'expert': prepend concise instructions.
+     * - If any domain is 'beginner': prepend detailed instructions.
+     * - Default: return prompt unmodified.
+     */
+    enrichPrompt(basePrompt, profile) {
+        const level = this.getDetailLevel(profile);
+        switch (level) {
+            case 'concise':
+                return `Be concise. Skip basics.\n\n${basePrompt}`;
+            case 'detailed':
+                return `Explain in detail with examples.\n\n${basePrompt}`;
+            default:
+                return basePrompt;
+        }
+    }
+    /**
+     * Determine the appropriate detail level from a user profile.
+     * - 'concise': all domains are expert level
+     * - 'detailed': any domain is beginner level
+     * - 'normal': default / mixed intermediate
+     */
+    getDetailLevel(profile) {
+        const domains = profile.skillDomains;
+        if (domains.size === 0)
+            return 'normal';
+        const levels = Array.from(domains.values());
+        // If any domain is beginner, give detailed responses
+        if (levels.some(l => l === 'beginner')) {
+            return 'detailed';
+        }
+        // If ALL domains are expert, be concise
+        if (levels.every(l => l === 'expert')) {
+            return 'concise';
+        }
+        return 'normal';
+    }
+}
+//# sourceMappingURL=adaptive-context.js.map

package/dist/user-model/adaptive-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adaptive-context.js","sourceRoot":"","sources":["../../src/user-model/adaptive-context.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,EAAE;AACF,iEAAiE;AACjE,2EAA2E;AAQ3E,2DAA2D;AAE3D,MAAM,OAAO,eAAe;IAC1B;;;;;OAKG;IACH,YAAY,CAAC,UAAkB,EAAE,OAAoB;QACnD,MAAM,KAAK,GAAG,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;QAE3C,QAAQ,KAAK,EAAE,CAAC;YACd,KAAK,SAAS;gBACZ,OAAO,+BAA+B,UAAU,EAAE,CAAC;YACrD,KAAK,UAAU;gBACb,OAAO,uCAAuC,UAAU,EAAE,CAAC;YAC7D;gBACE,OAAO,UAAU,CAAC;QACtB,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACH,cAAc,CAAC,OAAoB;QACjC,MAAM,OAAO,GAAG,OAAO,CAAC,YAAY,CAAC;QAErC,IAAI,OAAO,CAAC,IAAI,KAAK,CAAC;YAAE,OAAO,QAAQ,CAAC;QAExC,MAAM,MAAM,GAAiB,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;QAE1D,qDAAqD;QACrD,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,UAAU,CAAC,EAAE,CAAC;YACvC,OAAO,UAAU,CAAC;QACpB,CAAC;QAED,wCAAwC;QACxC,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,QAAQ,CAAC,EAAE,CAAC;YACtC,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;CACF"}

package/dist/user-model/index.d.ts

@@ -0,0 +1,4 @@
+export { UserModel, runUserModelMigration } from './user-model.js';
+export { AdaptiveContext } from './adaptive-context.js';
+export type { SkillLevel, UserProfile, UserModelConfig, UserModelStatus, } from './user-model.js';
+export type { DetailLevel, } from './adaptive-context.js';

package/dist/user-model/index.js

@@ -0,0 +1,3 @@
+export { UserModel, runUserModelMigration } from './user-model.js';
+export { AdaptiveContext } from './adaptive-context.js';
+//# sourceMappingURL=index.js.map

package/dist/user-model/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/user-model/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AACnE,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC"}