@cartisien/engram-mcp 0.2.0 → 0.3.0

package/dist/tools/detect_changes.js

@@ -0,0 +1,178 @@
+import { extractEntities } from '../analysis/entities.js';
+import { themeNames } from '../analysis/themes.js';
+import { scoreEmotion } from '../analysis/emotions.js';
+import { ok, fail } from '../response.js';
+import { defaultSession } from '../client.js';
+export async function toolDetectChanges(engram, input) {
+    const start = Date.now();
+    const sessionId = input.session_id ?? defaultSession();
+    if (!['session', 'day', 'week', 'month'].includes(input.baseline)) {
+        return fail('INVALID_INPUT', 'baseline must be session, day, week, or month', sessionId, start);
+    }
+    const scope = input.scope ?? 'all';
+    const now = new Date();
+    // Calculate cutoff for the baseline period
+    const cutoff = new Date(now);
+    switch (input.baseline) {
+        case 'day':
+            cutoff.setDate(cutoff.getDate() - 1);
+            break;
+        case 'week':
+            cutoff.setDate(cutoff.getDate() - 7);
+            break;
+        case 'month':
+            cutoff.setMonth(cutoff.getMonth() - 1);
+            break;
+        case 'session':
+            // Use compare_session_id if provided, else look at most recent 2h vs before
+            cutoff.setHours(cutoff.getHours() - 2);
+            break;
+    }
+    try {
+        // Recent memories (after cutoff)
+        const recent = await engram.recall(sessionId, undefined, {
+            limit: 100,
+            after: cutoff,
+            tiers: ['working', 'long_term'],
+        });
+        // Baseline memories (before cutoff)
+        const baseline = await engram.recall(sessionId, undefined, {
+            limit: 100,
+            before: cutoff,
+            tiers: ['working', 'long_term'],
+        });
+        const comparisonPeriod = `${cutoff.toISOString().slice(0, 10)} to ${now.toISOString().slice(0, 10)}`;
+        const result = { comparison_period: comparisonPeriod };
+        if (scope === 'entities' || scope === 'all') {
+            const recentEntities = collectEntities(recent);
+            const baselineEntities = collectEntities(baseline);
+            const newEntities = [...recentEntities.entries()]
+                .filter(([name]) => !baselineEntities.has(name))
+                .map(([name, info]) => ({ name, type: info.type, first_seen: info.firstSeen }));
+            const strengthened = [...recentEntities.entries()]
+                .filter(([name]) => baselineEntities.has(name))
+                .filter(([name]) => {
+                const rCount = recentEntities.get(name).count;
+                const bCount = baselineEntities.get(name).count;
+                return rCount > bCount;
+            })
+                .map(([name]) => ({
+                entity: name,
+                baseline_count: baselineEntities.get(name).count,
+                recent_count: recentEntities.get(name).count,
+            }));
+            const fading = [...baselineEntities.entries()]
+                .filter(([name]) => {
+                const rCount = recentEntities.get(name)?.count ?? 0;
+                const bCount = baselineEntities.get(name).count;
+                return rCount < bCount * 0.3; // significantly less frequent
+            })
+                .map(([name]) => ({ entity: name }));
+            result.new_entities = newEntities;
+            result.strengthened_entities = strengthened;
+            result.fading_entities = fading;
+        }
+        if (scope === 'themes' || scope === 'all') {
+            const recentThemes = collectThemes(recent);
+            const baselineThemes = collectThemes(baseline);
+            const newThemes = recentThemes.filter(t => !baselineThemes.includes(t));
+            const fadingThemes = baselineThemes.filter(t => !recentThemes.includes(t));
+            result.new_themes = newThemes;
+            result.fading_themes = fadingThemes;
+            result.persistent_themes = recentThemes.filter(t => baselineThemes.includes(t));
+        }
+        if (scope === 'emotions' || scope === 'all') {
+            const recentEmotions = collectEmotions(recent);
+            const baselineEmotions = collectEmotions(baseline);
+            const shifts = [];
+            if (baselineEmotions.dominant !== recentEmotions.dominant) {
+                shifts.push({
+                    window: 'overall',
+                    previous_tone: baselineEmotions.dominant,
+                    current_tone: recentEmotions.dominant,
+                });
+            }
+            result.emotional_shifts = shifts;
+            result.current_emotional_profile = recentEmotions;
+            result.baseline_emotional_profile = baselineEmotions;
+        }
+        // Anomalies
+        const anomalies = [];
+        if (recent.length > baseline.length * 2) {
+            anomalies.push({
+                type: 'high_activity',
+                description: `${recent.length}x more memories than baseline period`,
+                suggestion: 'Agent may be in intensive research or planning mode',
+            });
+        }
+        if (recent.length === 0) {
+            anomalies.push({
+                type: 'no_recent_activity',
+                description: `No memories found after ${cutoff.toISOString().slice(0, 10)}`,
+                suggestion: `Use 'remember' to start storing memories`,
+            });
+        }
+        result.anomalies = anomalies;
+        result.recent_count = recent.length;
+        result.baseline_count = baseline.length;
+        return ok(result, sessionId, start);
+    }
+    catch (err) {
+        return fail('DETECT_CHANGES_FAILED', String(err), sessionId, start);
+    }
+}
+function collectEntities(memories) {
+    const map = new Map();
+    const sorted = [...memories].sort((a, b) => a.timestamp.getTime() - b.timestamp.getTime());
+    for (const m of sorted) {
+        const entities = extractEntities(m.content);
+        for (const e of entities) {
+            const key = e.name.toLowerCase();
+            const existing = map.get(key);
+            if (!existing) {
+                map.set(key, { type: e.type, count: 1, firstSeen: m.timestamp.toISOString() });
+            }
+            else {
+                map.set(key, { ...existing, count: existing.count + 1 });
+            }
+        }
+    }
+    return map;
+}
+function collectThemes(memories) {
+    const counts = {};
+    for (const m of memories) {
+        for (const theme of themeNames(m.content, 3)) {
+            counts[theme] = (counts[theme] ?? 0) + 1;
+        }
+    }
+    return Object.entries(counts)
+        .sort(([, a], [, b]) => b - a)
+        .slice(0, 5)
+        .map(([t]) => t);
+}
+function collectEmotions(memories) {
+    const counts = {};
+    for (const m of memories) {
+        const tone = scoreEmotion(m.content).tone;
+        counts[tone] = (counts[tone] ?? 0) + 1;
+    }
+    const dominant = Object.entries(counts)
+        .sort(([, a], [, b]) => b - a)[0]?.[0] ?? 'neutral';
+    return { dominant, distribution: counts };
+}
+export const DETECT_CHANGES_SCHEMA = {
+    name: 'detect_changes',
+    description: 'Compare recent memory activity against a baseline period to identify new entities, theme shifts, emotional changes, and anomalies.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            baseline: { type: 'string', enum: ['session', 'day', 'week', 'month'], description: 'Time window to compare against' },
+            session_id: { type: 'string' },
+            scope: { type: 'string', enum: ['entities', 'themes', 'emotions', 'all'], default: 'all' },
+            compare_session_id: { type: 'string', description: 'Compare against a specific session instead' },
+        },
+        required: ['baseline'],
+    },
+};
+//# sourceMappingURL=detect_changes.js.map

package/dist/tools/detect_changes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect_changes.js","sourceRoot":"","sources":["../../src/tools/detect_changes.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAS9C,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,MAAc,EAAE,KAAyB;IAC/E,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACzB,MAAM,SAAS,GAAG,KAAK,CAAC,UAAU,IAAI,cAAc,EAAE,CAAC;IAEvD,IAAI,CAAC,CAAC,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;QAClE,OAAO,IAAI,CAAC,eAAe,EAAE,+CAA+C,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;IAClG,CAAC;IAED,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC;IACnC,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;IAEvB,2CAA2C;IAC3C,MAAM,MAAM,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC;IAC7B,QAAQ,KAAK,CAAC,QAAQ,EAAE,CAAC;QACvB,KAAK,KAAK;YAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC;YAAC,MAAM;QAC1D,KAAK,MAAM;YAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC;YAAC,MAAM;QAC1D,KAAK,OAAO;YAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC;YAAC,MAAM;QAC5D,KAAK,SAAS;YACZ,4EAA4E;YAC5E,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC;YAAC,MAAM;IAClD,CAAC;IAED,IAAI,CAAC;QACH,iCAAiC;QACjC,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,SAAS,EAAE;YACvD,KAAK,EAAE,GAAG;YACV,KAAK,EAAE,MAAM;YACb,KAAK,EAAE,CAAC,SAAS,EAAE,WAAW,CAAC;SAChC,CAAC,CAAC;QAEH,oCAAoC;QACpC,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,SAAS,EAAE;YACzD,KAAK,EAAE,GAAG;YACV,MAAM,EAAE,MAAM;YACd,KAAK,EAAE,CAAC,SAAS,EAAE,WAAW,CAAC;SAChC,CAAC,CAAC;QAEH,MAAM,gBAAgB,GAAG,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,GAAG,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;QAErG,MAAM,MAAM,GAA4B,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,CAAC;QAEhF,IAAI,KAAK,KAAK,UAAU,IAAI,KAAK,KAAK,KAAK,EAAE,CAAC;YAC5C,MAAM,cAAc,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;YAC/C,MAAM,gBAAgB,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC;YAEnD,MAAM,WAAW,GAAG,CAAC,GAAG,cAAc,CAAC,OAAO,EAAE,CAAC;iBAC9C,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,gBAAgB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;iBAC/C,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;YAElF,MAAM,YAAY,GAAG,CAAC,GAAG,cAAc,CAAC,OAAO,EAAE,CAAC;iBAC/C,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,gBAAgB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;iBAC9C,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE;gBACjB,MAAM,MAAM,GAAG,cAAc,CAAC,GAAG,CAAC,IAAI,CAAE,CAAC,KAAK,CAAC;gBAC/C,MAAM,MAAM,GAAG,gBAAgB,CAAC,GAAG,CAAC,IAAI,CAAE,CAAC,KAAK,CAAC;gBACjD,OAAO,MAAM,GAAG,MAAM,CAAC;YACzB,CAAC,CAAC;iBACD,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;gBAChB,MAAM,EAAE,IAAI;gBACZ,cAAc,EAAE,gBAAgB,CAAC,GAAG,CAAC,IAAI,CAAE,CAAC,KAAK;gBACjD,YAAY,EAAE,cAAc,CAAC,GAAG,CAAC,IAAI,CAAE,CAAC,KAAK;aAC9C,CAAC,CAAC,CAAC;YAEN,MAAM,MAAM,GAAG,CAAC,GAAG,gBAAgB,CAAC,OAAO,EAAE,CAAC;iBAC3C,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE;gBACjB,MAAM,MAAM,GAAG,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,KAAK,IAAI,CAAC,CAAC;gBACpD,MAAM,MAAM,GAAG,gBAAgB,CAAC,GAAG,CAAC,IAAI,CAAE,CAAC,KAAK,CAAC;gBACjD,OAAO,MAAM,GAAG,MAAM,GAAG,GAAG,CAAC,CAAC,8BAA8B;YAC9D,CAAC,CAAC;iBACD,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;YAEvC,MAAM,CAAC,YAAY,GAAG,WAAW,CAAC;YAClC,MAAM,CAAC,qBAAqB,GAAG,YAAY,CAAC;YAC5C,MAAM,CAAC,eAAe,GAAG,MAAM,CAAC;QAClC,CAAC;QAED,IAAI,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,KAAK,EAAE,CAAC;YAC1C,MAAM,YAAY,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;YAC3C,MAAM,cAAc,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;YAE/C,MAAM,SAAS,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;YACxE,MAAM,YAAY,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;YAE3E,MAAM,CAAC,UAAU,GAAG,SAAS,CAAC;YAC9B,MAAM,CAAC,aAAa,GAAG,YAAY,CAAC;YACpC,MAAM,CAAC,iBAAiB,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;QAClF,CAAC;QAED,IAAI,KAAK,KAAK,UAAU,IAAI,KAAK,KAAK,KAAK,EAAE,CAAC;YAC5C,MAAM,cAAc,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;YAC/C,MAAM,gBAAgB,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC;YAEnD,MAAM,MAAM,GAIP,EAAE,CAAC;YAER,IAAI,gBAAgB,CAAC,QAAQ,KAAK,cAAc,CAAC,QAAQ,EAAE,CAAC;gBAC1D,MAAM,CAAC,IAAI,CAAC;oBACV,MAAM,EAAE,SAAS;oBACjB,aAAa,EAAE,gBAAgB,CAAC,QAAQ;oBACxC,YAAY,EAAE,cAAc,CAAC,QAAQ;iBACtC,CAAC,CAAC;YACL,CAAC;YAED,MAAM,CAAC,gBAAgB,GAAG,MAAM,CAAC;YACjC,MAAM,CAAC,yBAAyB,GAAG,cAAc,CAAC;YAClD,MAAM,CAAC,0BAA0B,GAAG,gBAAgB,CAAC;QACvD,CAAC;QAED,YAAY;QACZ,MAAM,SAAS,GAAqE,EAAE,CAAC;QAEvF,IAAI,MAAM,CAAC,MAAM,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxC,SAAS,CAAC,IAAI,CAAC;gBACb,IAAI,EAAE,eAAe;gBACrB,WAAW,EAAE,GAAG,MAAM,CAAC,MAAM,sCAAsC;gBACnE,UAAU,EAAE,qDAAqD;aAClE,CAAC,CAAC;QACL,CAAC;QAED,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxB,SAAS,CAAC,IAAI,CAAC;gBACb,IAAI,EAAE,oBAAoB;gBAC1B,WAAW,EAAE,2BAA2B,MAAM,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE;gBAC3E,UAAU,EAAE,0CAA0C;aACvD,CAAC,CAAC;QACL,CAAC;QAED,MAAM,CAAC,SAAS,GAAG,SAAS,CAAC;QAC7B,MAAM,CAAC,YAAY,GAAG,MAAM,CAAC,MAAM,CAAC;QACpC,MAAM,CAAC,cAAc,GAAG,QAAQ,CAAC,MAAM,CAAC;QAExC,OAAO,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;IAEtC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,IAAI,CAAC,uBAAuB,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;IACtE,CAAC;AACH,CAAC;AAID,SAAS,eAAe,CAAC,QAAuB;IAC9C,MAAM,GAAG,GAAG,IAAI,GAAG,EAAsB,CAAC;IAC1C,MAAM,MAAM,GAAG,CAAC,GAAG,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC,CAAC;IAE3F,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACvB,MAAM,QAAQ,GAAG,eAAe,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;QAC5C,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;YACzB,MAAM,GAAG,GAAG,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YACjC,MAAM,QAAQ,GAAG,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAC9B,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,SAAS,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;YACjF,CAAC;iBAAM,CAAC;gBACN,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,GAAG,QAAQ,EAAE,KAAK,EAAE,QAAQ,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC,CAAC;YAC3D,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,aAAa,CAAC,QAAuB;IAC5C,MAAM,MAAM,GAA2B,EAAE,CAAC;IAC1C,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;QACzB,KAAK,MAAM,KAAK,IAAI,UAAU,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,CAAC;YAC7C,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;QAC3C,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC;SAC1B,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC;SAC7B,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;SACX,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;AACrB,CAAC;AAED,SAAS,eAAe,CAAC,QAAuB;IAC9C,MAAM,MAAM,GAA2B,EAAE,CAAC;IAC1C,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;QACzB,MAAM,IAAI,GAAG,YAAY,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC;QAC1C,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;IACzC,CAAC;IACD,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC;SACpC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,SAAS,CAAC;IACtD,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,EAAE,CAAC;AAC5C,CAAC;AAED,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,IAAI,EAAE,gBAAgB;IACtB,WAAW,EAAE,oIAAoI;IACjJ,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,EAAE,gCAAgC,EAAE;YACtH,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YAC9B,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE,KAAK,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE;YAC1F,kBAAkB,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,4CAA4C,EAAE;SAClG;QACD,QAAQ,EAAE,CAAC,UAAU,CAAC;KACvB;CACO,CAAC"}

package/dist/tools/forget.d.ts

@@ -0,0 +1,38 @@
+import type { Engram } from '@cartisien/engram';
+export interface ForgetInput {
+    session_id?: string;
+    before?: string;
+    memory_id?: string;
+    include_long_term?: boolean;
+    confirm?: boolean;
+}
+export declare function toolForget(engram: Engram, input: ForgetInput): Promise<import("../response.js").McpResponse<unknown>>;
+export declare const FORGET_SCHEMA: {
+    readonly name: "forget";
+    readonly description: "Delete memories matching criteria. Requires confirm: true. This is irreversible.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly session_id: {
+                readonly type: "string";
+            };
+            readonly before: {
+                readonly type: "string";
+                readonly description: "Delete memories before this ISO8601 date";
+            };
+            readonly memory_id: {
+                readonly type: "string";
+                readonly description: "Delete a specific memory by ID";
+            };
+            readonly include_long_term: {
+                readonly type: "boolean";
+                readonly description: "Also delete long_term memories (default: working only)";
+            };
+            readonly confirm: {
+                readonly type: "boolean";
+                readonly description: "Must be true to execute deletion";
+            };
+        };
+        readonly required: readonly ["confirm"];
+    };
+};

package/dist/tools/forget.js

@@ -0,0 +1,38 @@
+import { ok, fail } from '../response.js';
+import { defaultSession } from '../client.js';
+export async function toolForget(engram, input) {
+    const start = Date.now();
+    const sessionId = input.session_id ?? defaultSession();
+    if (!input.confirm) {
+        return fail('CONFIRMATION_REQUIRED', 'Pass confirm: true to delete memories. This is irreversible.', sessionId, start, ['Use dry_run with other tools first to see what would be affected']);
+    }
+    try {
+        const deleted = await engram.forget(sessionId, {
+            before: input.before ? new Date(input.before) : undefined,
+            id: input.memory_id,
+            includeLongTerm: input.include_long_term,
+        });
+        return ok({ deleted, session_id: sessionId }, sessionId, start, [
+            deleted > 0 ? `Use 'stats' to verify remaining memory count` : 'No memories matched the criteria',
+        ]);
+    }
+    catch (err) {
+        return fail('FORGET_FAILED', String(err), sessionId, start);
+    }
+}
+export const FORGET_SCHEMA = {
+    name: 'forget',
+    description: 'Delete memories matching criteria. Requires confirm: true. This is irreversible.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            session_id: { type: 'string' },
+            before: { type: 'string', description: 'Delete memories before this ISO8601 date' },
+            memory_id: { type: 'string', description: 'Delete a specific memory by ID' },
+            include_long_term: { type: 'boolean', description: 'Also delete long_term memories (default: working only)' },
+            confirm: { type: 'boolean', description: 'Must be true to execute deletion' },
+        },
+        required: ['confirm'],
+    },
+};
+//# sourceMappingURL=forget.js.map

package/dist/tools/forget.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"forget.js","sourceRoot":"","sources":["../../src/tools/forget.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAU9C,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,MAAc,EAAE,KAAkB;IACjE,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACzB,MAAM,SAAS,GAAG,KAAK,CAAC,UAAU,IAAI,cAAc,EAAE,CAAC;IAEvD,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;QACnB,OAAO,IAAI,CACT,uBAAuB,EACvB,8DAA8D,EAC9D,SAAS,EACT,KAAK,EACL,CAAC,kEAAkE,CAAC,CACrE,CAAC;IACJ,CAAC;IAED,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE;YAC7C,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS;YACzD,EAAE,EAAE,KAAK,CAAC,SAAS;YACnB,eAAe,EAAE,KAAK,CAAC,iBAAiB;SACzC,CAAC,CAAC;QAEH,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE;YAC9D,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,8CAA8C,CAAC,CAAC,CAAC,kCAAkC;SAClG,CAAC,CAAC;IAEL,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,IAAI,CAAC,eAAe,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;IAC9D,CAAC;AACH,CAAC;AAED,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,IAAI,EAAE,QAAQ;IACd,WAAW,EAAE,kFAAkF;IAC/F,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YAC9B,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,0CAA0C,EAAE;YACnF,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,gCAAgC,EAAE;YAC5E,iBAAiB,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,wDAAwD,EAAE;YAC7G,OAAO,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,kCAAkC,EAAE;SAC9E;QACD,QAAQ,EAAE,CAAC,SAAS,CAAC;KACtB;CACO,CAAC"}

package/dist/tools/graph.d.ts

@@ -0,0 +1,40 @@
+import type { Engram } from '@cartisien/engram';
+export interface GraphInput {
+    entity: string;
+    session_id?: string;
+    include_memories?: boolean;
+    find_path_to?: string;
+    max_depth?: number;
+}
+export declare function toolGraph(engram: Engram, input: GraphInput): Promise<import("../response.js").McpResponse<unknown>>;
+export declare const GRAPH_SCHEMA: {
+    readonly name: "graph";
+    readonly description: "Query the entity relationship graph. Find connections, relationships, and paths between entities.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly entity: {
+                readonly type: "string";
+                readonly description: "Entity name to query";
+            };
+            readonly session_id: {
+                readonly type: "string";
+            };
+            readonly include_memories: {
+                readonly type: "boolean";
+                readonly default: true;
+                readonly description: "Include related memory snippets";
+            };
+            readonly find_path_to: {
+                readonly type: "string";
+                readonly description: "Find relationship path to this entity";
+            };
+            readonly max_depth: {
+                readonly type: "number";
+                readonly default: 3;
+                readonly description: "Max hops for path finding (1-3)";
+            };
+        };
+        readonly required: readonly ["entity"];
+    };
+};

package/dist/tools/graph.js

@@ -0,0 +1,74 @@
+import { ok, fail } from '../response.js';
+import { defaultSession } from '../client.js';
+export async function toolGraph(engram, input) {
+    const start = Date.now();
+    const sessionId = input.session_id ?? defaultSession();
+    if (!input.entity?.trim()) {
+        return fail('INVALID_INPUT', 'entity is required', sessionId, start);
+    }
+    try {
+        const result = await engram.graph(sessionId, input.entity.toLowerCase());
+        let path = null;
+        if (input.find_path_to) {
+            const pathResult = await engram.graphPath(sessionId, input.entity.toLowerCase(), input.find_path_to.toLowerCase(), Math.min(input.max_depth ?? 3, 3));
+            if (pathResult.found) {
+                path = {
+                    found: true,
+                    hops: pathResult.hops,
+                    confidence: pathResult.confidence,
+                    edges: pathResult.path,
+                };
+            }
+            else {
+                path = { found: false };
+            }
+        }
+        const memories = input.include_memories !== false
+            ? result.relatedMemories.slice(0, 10).map(m => ({
+                id: m.id,
+                content: m.content.slice(0, 150),
+                role: m.role,
+                timestamp: m.timestamp.toISOString(),
+            }))
+            : [];
+        if (!result.relationships.length && !memories.length) {
+            return fail('ENTITY_NOT_FOUND', `Entity '${input.entity}' has no graph data`, sessionId, start, [
+                `Use 'remember' with extract_entities: true to build the entity graph`,
+                `Try 'recall' to find memories mentioning '${input.entity}'`,
+            ]);
+        }
+        return ok({
+            entity: input.entity,
+            relationships: result.relationships.map(r => ({
+                type: r.type,
+                relation: r.relation,
+                target: r.target,
+                confidence: r.confidence ?? 0.5,
+            })),
+            related_memory_count: result.relatedMemories.length,
+            related_memories: memories,
+            path,
+        }, sessionId, start, [
+            `Try 'context' with target_type='entity' for richer context around '${input.entity}'`,
+        ]);
+    }
+    catch (err) {
+        return fail('GRAPH_FAILED', String(err), sessionId, start);
+    }
+}
+export const GRAPH_SCHEMA = {
+    name: 'graph',
+    description: 'Query the entity relationship graph. Find connections, relationships, and paths between entities.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            entity: { type: 'string', description: 'Entity name to query' },
+            session_id: { type: 'string' },
+            include_memories: { type: 'boolean', default: true, description: 'Include related memory snippets' },
+            find_path_to: { type: 'string', description: 'Find relationship path to this entity' },
+            max_depth: { type: 'number', default: 3, description: 'Max hops for path finding (1-3)' },
+        },
+        required: ['entity'],
+    },
+};
+//# sourceMappingURL=graph.js.map

package/dist/tools/graph.js.map

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

package/dist/tools/impact.d.ts

@@ -0,0 +1,39 @@
+import type { Engram } from '@cartisien/engram';
+export interface ImpactInput {
+    hypothetical: string;
+    analysis_type: 'add' | 'update' | 'remove';
+    session_id?: string;
+    target_entity?: string;
+    min_confidence?: number;
+}
+export declare function toolImpact(engram: Engram, input: ImpactInput): Promise<import("../response.js").McpResponse<unknown>>;
+export declare const IMPACT_SCHEMA: {
+    readonly name: "impact";
+    readonly description: "Analyze how a new piece of information would affect existing memory structure. Detects conflicts, affected entities, and themes before storing.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly hypothetical: {
+                readonly type: "string";
+                readonly description: "The new information to analyze";
+            };
+            readonly analysis_type: {
+                readonly type: "string";
+                readonly enum: readonly ["add", "update", "remove"];
+            };
+            readonly session_id: {
+                readonly type: "string";
+            };
+            readonly target_entity: {
+                readonly type: "string";
+                readonly description: "Focus analysis on a specific entity";
+            };
+            readonly min_confidence: {
+                readonly type: "number";
+                readonly default: 0.5;
+                readonly description: "Minimum entity confidence threshold";
+            };
+        };
+        readonly required: readonly ["hypothetical", "analysis_type"];
+    };
+};

package/dist/tools/impact.js

@@ -0,0 +1,143 @@
+import { extractEntities } from '../analysis/entities.js';
+import { themeNames } from '../analysis/themes.js';
+import { ok, fail } from '../response.js';
+import { defaultSession } from '../client.js';
+export async function toolImpact(engram, input) {
+    const start = Date.now();
+    const sessionId = input.session_id ?? defaultSession();
+    if (!input.hypothetical?.trim()) {
+        return fail('INVALID_INPUT', 'hypothetical is required', sessionId, start);
+    }
+    if (!['add', 'update', 'remove'].includes(input.analysis_type)) {
+        return fail('INVALID_INPUT', 'analysis_type must be add, update, or remove', sessionId, start);
+    }
+    const minConfidence = input.min_confidence ?? 0.5;
+    try {
+        // Extract entities from hypothetical
+        const newEntities = extractEntities(input.hypothetical);
+        const newThemes = themeNames(input.hypothetical, 5);
+        // Recall existing memories related to this hypothetical
+        const related = await engram.recall(sessionId, input.hypothetical, {
+            limit: 15,
+            threshold: 0.55,
+            tiers: ['working', 'long_term'],
+        });
+        // Find affected entities
+        const affectedEntities = [];
+        for (const entity of newEntities.filter(e => e.confidence >= minConfidence)) {
+            const entityMemories = related.filter(m => m.content.toLowerCase().includes(entity.name.toLowerCase()));
+            if (entityMemories.length === 0)
+                continue;
+            const impactLevel = entityMemories.length >= 5 ? 'high'
+                : entityMemories.length >= 2 ? 'medium' : 'low';
+            const suggested = [];
+            if (input.analysis_type === 'add')
+                suggested.push(`New context for '${entity.name}' detected`);
+            if (input.analysis_type === 'update')
+                suggested.push(`Update existing memories about '${entity.name}'`);
+            if (input.analysis_type === 'remove')
+                suggested.push(`Review ${entityMemories.length} memories that reference '${entity.name}'`);
+            affectedEntities.push({
+                name: entity.name,
+                impact: impactLevel,
+                reason: `${entityMemories.length} existing memories reference this entity`,
+                related_memories: entityMemories.slice(0, 3).map(m => m.id),
+                suggested_updates: suggested,
+            });
+        }
+        // Affected themes
+        const affectedThemes = newThemes.map(theme => {
+            const themeMemories = related.filter(m => themeNames(m.content, 5).includes(theme));
+            const shift = input.analysis_type === 'add' ? 'expansion'
+                : input.analysis_type === 'remove' ? 'contraction' : 'modification';
+            return {
+                name: theme,
+                impact: themeMemories.length >= 3 ? 'medium' : 'low',
+                shift,
+                memory_count: themeMemories.length,
+            };
+        }).filter(t => t.memory_count > 0);
+        // Detect conflicts: find memories with contradictory information
+        const conflicts = [];
+        // Look for contradiction signals
+        const contradictionPairs = [
+            ['will', "won't"], ['always', 'never'], ['is', "isn't"],
+            ['can', "can't"], ['yes', 'no'], ['include', 'exclude'],
+        ];
+        for (const mem of related.slice(0, 10)) {
+            const memLower = mem.content.toLowerCase();
+            const hypLower = input.hypothetical.toLowerCase();
+            for (const [pos, neg] of contradictionPairs) {
+                const memHasPos = memLower.includes(pos);
+                const hypHasNeg = hypLower.includes(neg);
+                const memHasNeg = memLower.includes(neg);
+                const hypHasPos = hypLower.includes(pos);
+                if ((memHasPos && hypHasNeg) || (memHasNeg && hypHasPos)) {
+                    conflicts.push({
+                        type: 'potential_contradiction',
+                        existing_memory: mem.id,
+                        conflict: `Existing: "${mem.content.slice(0, 80)}..." may conflict with hypothetical`,
+                        resolution_suggestions: ['Review and clarify', `Update memory ${mem.id} if needed`],
+                    });
+                    break;
+                }
+            }
+        }
+        // Overall impact level
+        const hasHighImpact = affectedEntities.some(e => e.impact === 'high');
+        const hasMediumImpact = affectedEntities.some(e => e.impact === 'medium');
+        const impactSummary = hasHighImpact ? 'high' : hasMediumImpact ? 'medium'
+            : affectedEntities.length > 0 ? 'low' : 'minimal';
+        // New relationships
+        const newRelationships = newEntities
+            .filter(e => e.confidence >= minConfidence)
+            .slice(0, 5)
+            .map(e => ({
+            from: e.name.toLowerCase(),
+            to: input.target_entity?.toLowerCase() ?? 'context',
+            type: 'hypothetically_related',
+            confidence: e.confidence,
+        }));
+        const recommendedActions = [];
+        if (input.analysis_type === 'add') {
+            recommendedActions.push("Use 'remember' to store this new information");
+        }
+        if (conflicts.length > 0) {
+            recommendedActions.push(`Review ${conflicts.length} potential conflict(s) before proceeding`);
+        }
+        if (affectedEntities.length > 0) {
+            recommendedActions.push(`${affectedEntities.length} entities affected — consider updating related memories`);
+        }
+        return ok({
+            impact_summary: impactSummary,
+            related_memory_count: related.length,
+            affected_entities: affectedEntities,
+            affected_themes: affectedThemes,
+            conflicts_detected: conflicts.slice(0, 5),
+            new_relationships: newRelationships,
+            recommended_actions: recommendedActions,
+        }, sessionId, start, [
+            "Use 'remember' to store this as a new memory",
+            conflicts.length > 0 ? "Use 'recall' to review conflicting memories" : undefined,
+        ].filter(Boolean));
+    }
+    catch (err) {
+        return fail('IMPACT_FAILED', String(err), sessionId, start);
+    }
+}
+export const IMPACT_SCHEMA = {
+    name: 'impact',
+    description: 'Analyze how a new piece of information would affect existing memory structure. Detects conflicts, affected entities, and themes before storing.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            hypothetical: { type: 'string', description: 'The new information to analyze' },
+            analysis_type: { type: 'string', enum: ['add', 'update', 'remove'] },
+            session_id: { type: 'string' },
+            target_entity: { type: 'string', description: 'Focus analysis on a specific entity' },
+            min_confidence: { type: 'number', default: 0.5, description: 'Minimum entity confidence threshold' },
+        },
+        required: ['hypothetical', 'analysis_type'],
+    },
+};
+//# sourceMappingURL=impact.js.map

package/dist/tools/impact.js.map

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

package/dist/tools/process_detect.d.ts

@@ -0,0 +1,49 @@
+import type { Engram } from '@cartisien/engram';
+export interface ProcessDetectInput {
+    process_type?: 'decision' | 'learning' | 'conflict' | 'planning' | 'all';
+    session_id?: string;
+    entity_focus?: string;
+    min_occurrences?: number;
+    time_range?: {
+        start?: string;
+        end?: string;
+    };
+}
+export declare function toolProcessDetect(engram: Engram, input: ProcessDetectInput): Promise<import("../response.js").McpResponse<unknown>>;
+export declare const PROCESS_DETECT_SCHEMA: {
+    readonly name: "process_detect";
+    readonly description: "Identify recurring conversation and behavior patterns: decision loops, planning sessions, learning moments, and conflict patterns.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly process_type: {
+                readonly type: "string";
+                readonly enum: readonly ["decision", "learning", "conflict", "planning", "all"];
+                readonly default: "all";
+            };
+            readonly session_id: {
+                readonly type: "string";
+            };
+            readonly entity_focus: {
+                readonly type: "string";
+                readonly description: "Focus pattern detection on a specific entity";
+            };
+            readonly min_occurrences: {
+                readonly type: "number";
+                readonly default: 2;
+                readonly description: "Minimum occurrences to consider a pattern";
+            };
+            readonly time_range: {
+                readonly type: "object";
+                readonly properties: {
+                    readonly start: {
+                        readonly type: "string";
+                    };
+                    readonly end: {
+                        readonly type: "string";
+                    };
+                };
+            };
+        };
+    };
+};