@cartisien/engram-mcp 0.2.0 → 0.3.0

package/dist/config.js

@@ -0,0 +1,20 @@
+import { homedir } from 'os';
+import { join } from 'path';
+function env(key, fallback) {
+    return process.env[key] ?? fallback;
+}
+export function loadConfig() {
+    return {
+        dbPath: env('ENGRAM_DB_PATH', join(homedir(), '.engram', 'memory.db')),
+        sessionId: env('ENGRAM_SESSION_ID', 'default'),
+        embeddingUrl: env('ENGRAM_EMBEDDING_URL', 'http://localhost:11434'),
+        embeddingModel: env('ENGRAM_EMBEDDING_MODEL', 'nomic-embed-text'),
+        embeddingProvider: env('ENGRAM_EMBEDDING_PROVIDER', 'ollama'),
+        maxContextLength: parseInt(env('ENGRAM_MAX_CONTEXT', '4000'), 10),
+        dedupThreshold: parseFloat(env('ENGRAM_DEDUP_THRESHOLD', '0.95')),
+        enableWAL: env('ENGRAM_ENABLE_WAL', 'true') === 'true',
+        semanticSearch: env('ENGRAM_SEMANTIC_SEARCH', 'true') === 'true',
+        graphMemory: true, // always enabled in MCP server
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;AAC7B,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAe5B,SAAS,GAAG,CAAC,GAAW,EAAE,QAAgB;IACxC,OAAO,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,QAAQ,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,UAAU;IACxB,OAAO;QACL,MAAM,EAAE,GAAG,CAAC,gBAAgB,EAAE,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC;QACtE,SAAS,EAAE,GAAG,CAAC,mBAAmB,EAAE,SAAS,CAAC;QAC9C,YAAY,EAAE,GAAG,CAAC,sBAAsB,EAAE,wBAAwB,CAAC;QACnE,cAAc,EAAE,GAAG,CAAC,wBAAwB,EAAE,kBAAkB,CAAC;QACjE,iBAAiB,EAAE,GAAG,CAAC,2BAA2B,EAAE,QAAQ,CAAC;QAC7D,gBAAgB,EAAE,QAAQ,CAAC,GAAG,CAAC,oBAAoB,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC;QACjE,cAAc,EAAE,UAAU,CAAC,GAAG,CAAC,wBAAwB,EAAE,MAAM,CAAC,CAAC;QACjE,SAAS,EAAE,GAAG,CAAC,mBAAmB,EAAE,MAAM,CAAC,KAAK,MAAM;QACtD,cAAc,EAAE,GAAG,CAAC,wBAAwB,EAAE,MAAM,CAAC,KAAK,MAAM;QAChE,WAAW,EAAE,IAAI,EAAE,+BAA+B;KACnD,CAAC;AACJ,CAAC"}

package/dist/response.d.ts

@@ -0,0 +1,17 @@
+export interface McpResponse<T = unknown> {
+    success: boolean;
+    data?: T;
+    error?: {
+        code: string;
+        message: string;
+        suggestions?: string[];
+    };
+    meta: {
+        query_time_ms: number;
+        version: string;
+        session_id: string;
+    };
+    suggestions?: string[];
+}
+export declare function ok<T>(data: T, sessionId: string, startMs: number, suggestions?: string[]): McpResponse<T>;
+export declare function fail(code: string, message: string, sessionId: string, startMs: number, suggestions?: string[]): McpResponse;

package/dist/response.js

@@ -0,0 +1,17 @@
+const VERSION = '0.2.0';
+export function ok(data, sessionId, startMs, suggestions) {
+    return {
+        success: true,
+        data,
+        meta: { query_time_ms: Date.now() - startMs, version: VERSION, session_id: sessionId },
+        ...(suggestions?.length ? { suggestions } : {}),
+    };
+}
+export function fail(code, message, sessionId, startMs, suggestions) {
+    return {
+        success: false,
+        error: { code, message, ...(suggestions?.length ? { suggestions } : {}) },
+        meta: { query_time_ms: Date.now() - startMs, version: VERSION, session_id: sessionId },
+    };
+}
+//# sourceMappingURL=response.js.map

package/dist/response.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"response.js","sourceRoot":"","sources":["../src/response.ts"],"names":[],"mappings":"AAQA,MAAM,OAAO,GAAG,OAAO,CAAC;AAExB,MAAM,UAAU,EAAE,CAChB,IAAO,EACP,SAAiB,EACjB,OAAe,EACf,WAAsB;IAEtB,OAAO;QACL,OAAO,EAAE,IAAI;QACb,IAAI;QACJ,IAAI,EAAE,EAAE,aAAa,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE;QACtF,GAAG,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAChD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,IAAI,CAClB,IAAY,EACZ,OAAe,EACf,SAAiB,EACjB,OAAe,EACf,WAAsB;IAEtB,OAAO;QACL,OAAO,EAAE,KAAK;QACd,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE;QACzE,IAAI,EAAE,EAAE,aAAa,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE;KACvF,CAAC;AACJ,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+/**
+ * Engram MCP Server v0.2.0
+ * Exposes agent memory as structured relational intelligence.
+ * Transport: stdio
+ */
+export {};

package/dist/server.js

@@ -0,0 +1,104 @@
+#!/usr/bin/env node
+/**
+ * Engram MCP Server v0.2.0
+ * Exposes agent memory as structured relational intelligence.
+ * Transport: stdio
+ */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ListToolsRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+import { getEngram } from './client.js';
+import { toolRemember, REMEMBER_SCHEMA } from './tools/remember.js';
+import { toolRecall, RECALL_SCHEMA } from './tools/recall.js';
+import { toolSearch, SEARCH_SCHEMA } from './tools/search.js';
+import { toolContext, CONTEXT_SCHEMA } from './tools/context.js';
+import { toolImpact, IMPACT_SCHEMA } from './tools/impact.js';
+import { toolDetectChanges, DETECT_CHANGES_SCHEMA } from './tools/detect_changes.js';
+import { toolConsolidate, CONSOLIDATE_SCHEMA } from './tools/consolidate.js';
+import { toolProcessDetect, PROCESS_DETECT_SCHEMA } from './tools/process_detect.js';
+import { toolForget, FORGET_SCHEMA } from './tools/forget.js';
+import { toolStats, STATS_SCHEMA } from './tools/stats.js';
+import { toolGraph, GRAPH_SCHEMA } from './tools/graph.js';
+const ALL_TOOLS = [
+    REMEMBER_SCHEMA,
+    RECALL_SCHEMA,
+    SEARCH_SCHEMA,
+    CONTEXT_SCHEMA,
+    IMPACT_SCHEMA,
+    DETECT_CHANGES_SCHEMA,
+    CONSOLIDATE_SCHEMA,
+    PROCESS_DETECT_SCHEMA,
+    FORGET_SCHEMA,
+    STATS_SCHEMA,
+    GRAPH_SCHEMA,
+];
+async function main() {
+    const server = new Server({ name: 'engram', version: '0.2.0' }, { capabilities: { tools: {} } });
+    // List available tools
+    server.setRequestHandler(ListToolsRequestSchema, async () => ({
+        tools: ALL_TOOLS.map(t => ({
+            name: t.name,
+            description: t.description,
+            inputSchema: t.inputSchema,
+        })),
+    }));
+    // Handle tool calls
+    server.setRequestHandler(CallToolRequestSchema, async (request) => {
+        const { name, arguments: args = {} } = request.params;
+        const engram = await getEngram();
+        let result;
+        // Cast via unknown to satisfy TypeScript — runtime validation is in each tool handler
+        const a = args;
+        switch (name) {
+            case 'remember':
+                result = await toolRemember(engram, a);
+                break;
+            case 'recall':
+                result = await toolRecall(engram, a);
+                break;
+            case 'search':
+                result = await toolSearch(engram, a);
+                break;
+            case 'context':
+                result = await toolContext(engram, a);
+                break;
+            case 'impact':
+                result = await toolImpact(engram, a);
+                break;
+            case 'detect_changes':
+                result = await toolDetectChanges(engram, a);
+                break;
+            case 'consolidate':
+                result = await toolConsolidate(engram, a);
+                break;
+            case 'process_detect':
+                result = await toolProcessDetect(engram, a);
+                break;
+            case 'forget':
+                result = await toolForget(engram, a);
+                break;
+            case 'stats':
+                result = await toolStats(engram, a);
+                break;
+            case 'graph':
+                result = await toolGraph(engram, a);
+                break;
+            default:
+                result = {
+                    success: false,
+                    error: { code: 'UNKNOWN_TOOL', message: `Unknown tool: ${name}` },
+                    meta: { query_time_ms: 0, version: '0.2.0', session_id: 'unknown' },
+                };
+        }
+        return {
+            content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+        };
+    });
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+main().catch((err) => {
+    process.stderr.write(`Engram MCP fatal error: ${err}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/dist/tools/consolidate.d.ts

@@ -0,0 +1,41 @@
+import type { Engram } from '@cartisien/engram';
+export interface ConsolidateInput {
+    trigger?: 'manual' | 'scheduled' | 'threshold';
+    session_id?: string;
+    keep?: number;
+    aggressiveness?: 'conservative' | 'normal' | 'aggressive';
+    dry_run?: boolean;
+}
+export declare function toolConsolidate(engram: Engram, input: ConsolidateInput): Promise<import("../response.js").McpResponse<unknown>>;
+export declare const CONSOLIDATE_SCHEMA: {
+    readonly name: "consolidate";
+    readonly description: "Consolidate working memories into long-term storage. Archives old memories beyond the keep threshold.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly trigger: {
+                readonly type: "string";
+                readonly enum: readonly ["manual", "scheduled", "threshold"];
+                readonly default: "manual";
+            };
+            readonly session_id: {
+                readonly type: "string";
+            };
+            readonly keep: {
+                readonly type: "number";
+                readonly description: "Number of working memories to keep (overrides aggressiveness)";
+            };
+            readonly aggressiveness: {
+                readonly type: "string";
+                readonly enum: readonly ["conservative", "normal", "aggressive"];
+                readonly default: "normal";
+                readonly description: "conservative=keep 50, normal=keep 20, aggressive=keep 10";
+            };
+            readonly dry_run: {
+                readonly type: "boolean";
+                readonly default: false;
+                readonly description: "Preview consolidation without making changes";
+            };
+        };
+    };
+};

package/dist/tools/consolidate.js

@@ -0,0 +1,53 @@
+import { ok, fail } from '../response.js';
+import { defaultSession } from '../client.js';
+const KEEP_BY_AGGRESSIVENESS = {
+    conservative: 50,
+    normal: 20,
+    aggressive: 10,
+};
+export async function toolConsolidate(engram, input) {
+    const start = Date.now();
+    const sessionId = input.session_id ?? defaultSession();
+    const aggressiveness = input.aggressiveness ?? 'normal';
+    const keep = input.keep ?? KEEP_BY_AGGRESSIVENESS[aggressiveness];
+    const dryRun = input.dry_run ?? false;
+    try {
+        const result = await engram.consolidate(sessionId, { keep, dryRun });
+        const suggestions = [];
+        if (result.archived > 0) {
+            suggestions.push(`${result.archived} memories archived — use tier_filter: ['archived'] to access them`);
+        }
+        if (result.summarized === 0) {
+            suggestions.push(`Nothing to consolidate — session has fewer than ${keep} working memories`);
+        }
+        return ok({
+            dry_run: dryRun,
+            trigger: input.trigger ?? 'manual',
+            processed: result.summarized,
+            keep_threshold: keep,
+            actions: {
+                promoted_to_long_term: result.created,
+                archived: result.archived,
+                summarized: result.summarized,
+            },
+        }, sessionId, start, suggestions);
+    }
+    catch (err) {
+        return fail('CONSOLIDATE_FAILED', String(err), sessionId, start);
+    }
+}
+export const CONSOLIDATE_SCHEMA = {
+    name: 'consolidate',
+    description: 'Consolidate working memories into long-term storage. Archives old memories beyond the keep threshold.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            trigger: { type: 'string', enum: ['manual', 'scheduled', 'threshold'], default: 'manual' },
+            session_id: { type: 'string' },
+            keep: { type: 'number', description: 'Number of working memories to keep (overrides aggressiveness)' },
+            aggressiveness: { type: 'string', enum: ['conservative', 'normal', 'aggressive'], default: 'normal', description: 'conservative=keep 50, normal=keep 20, aggressive=keep 10' },
+            dry_run: { type: 'boolean', default: false, description: 'Preview consolidation without making changes' },
+        },
+    },
+};
+//# sourceMappingURL=consolidate.js.map

package/dist/tools/consolidate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"consolidate.js","sourceRoot":"","sources":["../../src/tools/consolidate.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAU9C,MAAM,sBAAsB,GAAG;IAC7B,YAAY,EAAE,EAAE;IAChB,MAAM,EAAE,EAAE;IACV,UAAU,EAAE,EAAE;CACf,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,MAAc,EAAE,KAAuB;IAC3E,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACzB,MAAM,SAAS,GAAG,KAAK,CAAC,UAAU,IAAI,cAAc,EAAE,CAAC;IAEvD,MAAM,cAAc,GAAG,KAAK,CAAC,cAAc,IAAI,QAAQ,CAAC;IACxD,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,IAAI,sBAAsB,CAAC,cAAc,CAAC,CAAC;IAClE,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC;IAEtC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,SAAS,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;QAErE,MAAM,WAAW,GAAa,EAAE,CAAC;QACjC,IAAI,MAAM,CAAC,QAAQ,GAAG,CAAC,EAAE,CAAC;YACxB,WAAW,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,QAAQ,mEAAmE,CAAC,CAAC;QAC1G,CAAC;QACD,IAAI,MAAM,CAAC,UAAU,KAAK,CAAC,EAAE,CAAC;YAC5B,WAAW,CAAC,IAAI,CAAC,mDAAmD,IAAI,mBAAmB,CAAC,CAAC;QAC/F,CAAC;QAED,OAAO,EAAE,CAAC;YACR,OAAO,EAAE,MAAM;YACf,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,QAAQ;YAClC,SAAS,EAAE,MAAM,CAAC,UAAU;YAC5B,cAAc,EAAE,IAAI;YACpB,OAAO,EAAE;gBACP,qBAAqB,EAAE,MAAM,CAAC,OAAO;gBACrC,QAAQ,EAAE,MAAM,CAAC,QAAQ;gBACzB,UAAU,EAAE,MAAM,CAAC,UAAU;aAC9B;SACF,EAAE,SAAS,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC;IAEpC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,IAAI,CAAC,oBAAoB,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;IACnE,CAAC;AACH,CAAC;AAED,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,IAAI,EAAE,aAAa;IACnB,WAAW,EAAE,uGAAuG;IACpH,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,QAAQ,EAAE,WAAW,EAAE,WAAW,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE;YAC1F,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YAC9B,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,+DAA+D,EAAE;YACtG,cAAc,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,cAAc,EAAE,QAAQ,EAAE,YAAY,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,0DAA0D,EAAE;YAC9K,OAAO,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,8CAA8C,EAAE;SAC1G;KACF;CACO,CAAC"}

package/dist/tools/context.d.ts

@@ -0,0 +1,44 @@
+import type { Engram } from '@cartisien/engram';
+export interface ContextInput {
+    target: string;
+    target_type: 'entity' | 'theme' | 'memory';
+    session_id?: string;
+    depth?: number;
+    include_memories?: boolean;
+    include_metrics?: boolean;
+}
+export declare function toolContext(engram: Engram, input: ContextInput): Promise<import("../response.js").McpResponse<unknown>>;
+export declare const CONTEXT_SCHEMA: {
+    readonly name: "context";
+    readonly description: "Get 360° context around a specific entity, theme, or memory. Returns timeline, relationships, emotional arc, and key memories.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly target: {
+                readonly type: "string";
+                readonly description: "Entity name, theme name, or memory_id";
+            };
+            readonly target_type: {
+                readonly type: "string";
+                readonly enum: readonly ["entity", "theme", "memory"];
+            };
+            readonly session_id: {
+                readonly type: "string";
+            };
+            readonly depth: {
+                readonly type: "number";
+                readonly default: 2;
+                readonly description: "Relationship depth (1-3)";
+            };
+            readonly include_memories: {
+                readonly type: "boolean";
+                readonly default: true;
+            };
+            readonly include_metrics: {
+                readonly type: "boolean";
+                readonly default: true;
+            };
+        };
+        readonly required: readonly ["target", "target_type"];
+    };
+};

package/dist/tools/context.js

@@ -0,0 +1,186 @@
+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 toolContext(engram, input) {
+    const start = Date.now();
+    const sessionId = input.session_id ?? defaultSession();
+    if (!input.target?.trim()) {
+        return fail('INVALID_INPUT', 'target is required', sessionId, start);
+    }
+    if (!['entity', 'theme', 'memory'].includes(input.target_type)) {
+        return fail('INVALID_INPUT', 'target_type must be entity, theme, or memory', sessionId, start);
+    }
+    try {
+        if (input.target_type === 'entity') {
+            return await entityContext(engram, input, sessionId, start);
+        }
+        else if (input.target_type === 'theme') {
+            return await themeContext(engram, input, sessionId, start);
+        }
+        else {
+            return await memoryContext(engram, input, sessionId, start);
+        }
+    }
+    catch (err) {
+        return fail('CONTEXT_FAILED', String(err), sessionId, start);
+    }
+}
+async function entityContext(engram, input, sessionId, start) {
+    const graphResult = await engram.graph(sessionId, input.target.toLowerCase());
+    if (!graphResult.relatedMemories.length && !graphResult.relationships.length) {
+        return fail('ENTITY_NOT_FOUND', `Entity '${input.target}' not found in memory`, sessionId, start, [
+            `Use 'remember' to add memories mentioning '${input.target}'`,
+            `Try searching with 'recall' using query: '${input.target}'`,
+        ]);
+    }
+    const memories = graphResult.relatedMemories.slice(0, 20);
+    // Build timeline from memories
+    const timeline = memories
+        .sort((a, b) => a.timestamp.getTime() - b.timestamp.getTime())
+        .map(m => ({
+        date: m.timestamp.toISOString().slice(0, 10),
+        memory_id: m.id,
+        summary: m.content.slice(0, 100) + (m.content.length > 100 ? '...' : ''),
+    }));
+    // Emotional arc: group by month
+    const emotionalArc = buildEmotionalArc(memories.map(m => ({
+        date: m.timestamp,
+        tone: scoreEmotion(m.content).tone,
+    })));
+    // Theme profile
+    const allContent = memories.map(m => m.content).join(' ');
+    const themes = themeNames(allContent, 5);
+    // Key memories: highest importance
+    const keyMemories = memories
+        .sort((a, b) => (b.importance ?? 0.5) - (a.importance ?? 0.5))
+        .slice(0, 3)
+        .map(m => ({
+        id: m.id,
+        summary: m.content.slice(0, 120) + (m.content.length > 120 ? '...' : ''),
+        importance: m.importance ?? 0.5,
+        timestamp: m.timestamp.toISOString(),
+    }));
+    const firstSeen = memories[0]?.timestamp.toISOString() ?? null;
+    return ok({
+        target: {
+            name: input.target,
+            type: 'entity',
+            first_mentioned: firstSeen,
+            mention_count: memories.length,
+        },
+        relationships: {
+            entities: graphResult.relationships.map(r => ({
+                name: r.target,
+                relation: r.relation,
+                type: r.type,
+                confidence: r.confidence ?? 0.5,
+            })),
+        },
+        timeline,
+        themes,
+        emotional_arc: emotionalArc,
+        key_memories: keyMemories,
+    }, sessionId, start, [`Try 'recall' with entity_filter: ['${input.target}'] for full history`]);
+}
+async function themeContext(engram, input, sessionId, start) {
+    // Get memories matching this theme
+    const memories = await engram.recall(sessionId, input.target, {
+        limit: 30,
+        threshold: 0.5,
+        tiers: ['working', 'long_term'],
+    });
+    const themeMatches = memories.filter(m => {
+        const themes = themeNames(m.content, 5);
+        return themes.includes(input.target);
+    });
+    if (themeMatches.length === 0) {
+        return fail('THEME_NOT_FOUND', `No memories found for theme '${input.target}'`, sessionId, start, [
+            `Available: use 'stats' to see recent memory distribution`,
+        ]);
+    }
+    const timeline = themeMatches
+        .sort((a, b) => a.timestamp.getTime() - b.timestamp.getTime())
+        .map(m => ({
+        date: m.timestamp.toISOString().slice(0, 10),
+        memory_id: m.id,
+        summary: m.content.slice(0, 100) + (m.content.length > 100 ? '...' : ''),
+    }));
+    const emotionalArc = buildEmotionalArc(themeMatches.map(m => ({
+        date: m.timestamp,
+        tone: scoreEmotion(m.content).tone,
+    })));
+    return ok({
+        target: { name: input.target, type: 'theme', mention_count: themeMatches.length },
+        timeline,
+        emotional_arc: emotionalArc,
+        key_memories: themeMatches.slice(0, 3).map(m => ({
+            id: m.id,
+            summary: m.content.slice(0, 120),
+            importance: m.importance ?? 0.5,
+        })),
+    }, sessionId, start);
+}
+async function memoryContext(engram, input, sessionId, start) {
+    // Recall memories similar to this memory_id
+    const seed = await engram.recall(sessionId, undefined, { limit: 1 });
+    const target = seed.find(m => m.id === input.target);
+    if (!target) {
+        return fail('MEMORY_NOT_FOUND', `Memory '${input.target}' not found`, sessionId, start);
+    }
+    const similar = await engram.recall(sessionId, target.content, {
+        limit: 10,
+        threshold: 0.6,
+    });
+    return ok({
+        target: {
+            id: target.id,
+            content: target.content,
+            role: target.role,
+            tier: target.tier,
+            timestamp: target.timestamp.toISOString(),
+        },
+        similar_memories: similar.filter(m => m.id !== target.id).map(m => ({
+            id: m.id,
+            content: m.content.slice(0, 120),
+            relevance: m.similarity ?? 0,
+        })),
+        themes: themeNames(target.content, 3),
+        emotional_tone: scoreEmotion(target.content).tone,
+    }, sessionId, start);
+}
+function buildEmotionalArc(entries) {
+    // Group by year-month
+    const byMonth = {};
+    for (const e of entries) {
+        const key = e.date.toISOString().slice(0, 7); // YYYY-MM
+        if (!byMonth[key])
+            byMonth[key] = [];
+        byMonth[key].push(e.tone);
+    }
+    return Object.entries(byMonth).map(([period, tones]) => {
+        // Most common tone
+        const counts = {};
+        for (const t of tones)
+            counts[t] = (counts[t] ?? 0) + 1;
+        const dominant = Object.entries(counts).sort(([, a], [, b]) => b - a)[0]?.[0] ?? 'neutral';
+        return { period, tone: dominant };
+    });
+}
+export const CONTEXT_SCHEMA = {
+    name: 'context',
+    description: 'Get 360° context around a specific entity, theme, or memory. Returns timeline, relationships, emotional arc, and key memories.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            target: { type: 'string', description: 'Entity name, theme name, or memory_id' },
+            target_type: { type: 'string', enum: ['entity', 'theme', 'memory'] },
+            session_id: { type: 'string' },
+            depth: { type: 'number', default: 2, description: 'Relationship depth (1-3)' },
+            include_memories: { type: 'boolean', default: true },
+            include_metrics: { type: 'boolean', default: true },
+        },
+        required: ['target', 'target_type'],
+    },
+};
+//# sourceMappingURL=context.js.map

package/dist/tools/context.js.map

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

package/dist/tools/detect_changes.d.ts

@@ -0,0 +1,35 @@
+import type { Engram } from '@cartisien/engram';
+export interface DetectChangesInput {
+    baseline: 'session' | 'day' | 'week' | 'month';
+    session_id?: string;
+    scope?: 'entities' | 'themes' | 'emotions' | 'all';
+    compare_session_id?: string;
+}
+export declare function toolDetectChanges(engram: Engram, input: DetectChangesInput): Promise<import("../response.js").McpResponse<unknown>>;
+export declare const DETECT_CHANGES_SCHEMA: {
+    readonly name: "detect_changes";
+    readonly description: "Compare recent memory activity against a baseline period to identify new entities, theme shifts, emotional changes, and anomalies.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly baseline: {
+                readonly type: "string";
+                readonly enum: readonly ["session", "day", "week", "month"];
+                readonly description: "Time window to compare against";
+            };
+            readonly session_id: {
+                readonly type: "string";
+            };
+            readonly scope: {
+                readonly type: "string";
+                readonly enum: readonly ["entities", "themes", "emotions", "all"];
+                readonly default: "all";
+            };
+            readonly compare_session_id: {
+                readonly type: "string";
+                readonly description: "Compare against a specific session instead";
+            };
+        };
+        readonly required: readonly ["baseline"];
+    };
+};