engram-sdk 0.1.0

package/dist/mcp.js

@@ -0,0 +1,349 @@
+#!/usr/bin/env node
+// ============================================================
+// Engram MCP Server — Memory tools for any MCP-compatible agent
+// ============================================================
+//
+// Works with: Claude Code, Cursor, Windsurf, Cline, etc.
+//
+// Setup (Claude Code):
+//   Add to ~/.claude/claude_desktop_config.json:
+//   {
+//     "mcpServers": {
+//       "engram": {
+//         "command": "npx",
+//         "args": ["engram", "mcp"],
+//         "env": {
+//           "ENGRAM_OWNER": "my-agent",
+//           "GEMINI_API_KEY": "your-key-here"
+//         }
+//       }
+//     }
+//   }
+//
+// Or run standalone:
+//   ENGRAM_OWNER=my-agent npx tsx src/mcp.ts
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { z } from 'zod';
+import { Vault } from './vault.js';
+import { GeminiEmbeddings, OpenAIEmbeddings } from './embeddings.js';
+import path from 'path';
+import { homedir } from 'os';
+import { readFileSync, writeFileSync, existsSync } from 'fs';
+// ============================================================
+// Config from environment
+// ============================================================
+const owner = process.env.ENGRAM_OWNER ?? 'default';
+const engramDir = path.join(homedir(), '.engram');
+const dbPath = process.env.ENGRAM_DB_PATH ?? path.join(engramDir, `${owner}.db`);
+const geminiKey = process.env.GEMINI_API_KEY;
+const openaiKey = process.env.OPENAI_API_KEY;
+const anthropicKey = process.env.ANTHROPIC_API_KEY;
+// Determine LLM provider
+const llmProvider = process.env.ENGRAM_LLM_PROVIDER ??
+    (geminiKey ? 'gemini' : openaiKey ? 'openai' : anthropicKey ? 'anthropic' : undefined);
+const llmKey = geminiKey ?? openaiKey ?? anthropicKey;
+// ============================================================
+// Initialize Vault
+// ============================================================
+const vaultConfig = {
+    owner,
+    dbPath,
+    ...(llmProvider && llmKey ? {
+        llm: {
+            provider: llmProvider,
+            apiKey: llmKey,
+        },
+    } : {}),
+};
+let embedder;
+if (geminiKey) {
+    embedder = new GeminiEmbeddings(geminiKey);
+}
+else if (openaiKey) {
+    embedder = new OpenAIEmbeddings(openaiKey);
+}
+const vault = new Vault(vaultConfig, embedder);
+// ============================================================
+// Auto-ingest state
+// ============================================================
+const INGEST_STATE_PATH = path.join(homedir(), '.config', 'engram', 'ingest-state.json');
+function loadIngestState() {
+    if (existsSync(INGEST_STATE_PATH)) {
+        return JSON.parse(readFileSync(INGEST_STATE_PATH, 'utf-8'));
+    }
+    return { lastIngestedLine: {}, lastRunAt: new Date(0).toISOString(), totalMemoriesCreated: 0, totalRunCount: 0 };
+}
+function saveIngestState(state) {
+    const dir = path.dirname(INGEST_STATE_PATH);
+    if (!existsSync(dir)) {
+        const { mkdirSync } = require('fs');
+        mkdirSync(dir, { recursive: true });
+    }
+    writeFileSync(INGEST_STATE_PATH, JSON.stringify(state, null, 2));
+}
+// ============================================================
+// Create MCP Server
+// ============================================================
+const server = new McpServer({
+    name: 'engram',
+    version: '0.1.0',
+});
+// ============================================================
+// Tool: remember
+// ============================================================
+server.tool('engram_remember', 'Store a memory in the Engram vault. Auto-extracts entities and topics if not provided.', {
+    content: z.string().describe('The memory content — a clear statement worth remembering'),
+    type: z.enum(['episodic', 'semantic', 'procedural']).optional().describe('Memory type: episodic (events), semantic (facts), procedural (how-to)'),
+    entities: z.array(z.string()).optional().describe('People, projects, tools, places mentioned'),
+    topics: z.array(z.string()).optional().describe('Topic tags'),
+    salience: z.number().min(0).max(1).optional().describe('Importance 0-1 (default 0.5)'),
+    status: z.enum(['active', 'pending', 'fulfilled', 'superseded', 'archived']).optional().describe('Memory lifecycle status'),
+}, async (args) => {
+    const memory = vault.remember({
+        content: args.content,
+        type: args.type,
+        entities: args.entities,
+        topics: args.topics,
+        salience: args.salience,
+        status: args.status,
+    });
+    // Compute embedding async
+    if (embedder) {
+        vault.computeAndStoreEmbedding(memory.id, memory.content).catch(() => { });
+    }
+    return {
+        content: [{
+                type: 'text',
+                text: JSON.stringify({
+                    stored: true,
+                    id: memory.id,
+                    entities: memory.entities,
+                    topics: memory.topics,
+                    salience: memory.salience,
+                    status: memory.status,
+                }, null, 2),
+            }],
+    };
+});
+// ============================================================
+// Tool: recall
+// ============================================================
+server.tool('engram_recall', 'Recall relevant memories from the Engram vault. Uses semantic search when embeddings are available.', {
+    context: z.string().describe('What you want to remember — a question or topic'),
+    entities: z.array(z.string()).optional().describe('Filter by specific entities'),
+    topics: z.array(z.string()).optional().describe('Filter by topics'),
+    limit: z.number().int().min(1).max(50).optional().describe('Max results (default 10)'),
+}, async (args) => {
+    const memories = await vault.recall({
+        context: args.context,
+        entities: args.entities,
+        topics: args.topics,
+        limit: args.limit ?? 10,
+    });
+    if (memories.length === 0) {
+        return { content: [{ type: 'text', text: 'No relevant memories found.' }] };
+    }
+    const formatted = memories.map((m, i) => `[${i + 1}] (${m.type}, salience=${m.salience.toFixed(2)}, status=${m.status})\n${m.content}\nEntities: ${m.entities.join(', ') || 'none'} | Topics: ${m.topics.join(', ') || 'none'}`).join('\n\n');
+    return {
+        content: [{
+                type: 'text',
+                text: `Found ${memories.length} memories:\n\n${formatted}`,
+            }],
+    };
+});
+// ============================================================
+// Tool: forget
+// ============================================================
+server.tool('engram_forget', 'Forget a memory. Soft forget reduces salience to 0; hard forget permanently deletes.', {
+    id: z.string().describe('Memory ID to forget'),
+    hard: z.boolean().optional().describe('Permanently delete (default: soft forget)'),
+}, async (args) => {
+    vault.forget(args.id, args.hard ?? false);
+    return {
+        content: [{ type: 'text', text: `Memory ${args.id} ${args.hard ? 'permanently deleted' : 'soft forgotten (salience → 0)'}.` }],
+    };
+});
+// ============================================================
+// Tool: consolidate
+// ============================================================
+server.tool('engram_consolidate', 'Run the consolidation engine — distills recent episodes into semantic knowledge, discovers entities, finds contradictions, forms connections.', {}, async () => {
+    const report = await vault.consolidate();
+    return {
+        content: [{
+                type: 'text',
+                text: JSON.stringify(report, null, 2),
+            }],
+    };
+});
+// ============================================================
+// Tool: connect
+// ============================================================
+server.tool('engram_connect', 'Create a relationship between two memories in the knowledge graph.', {
+    sourceId: z.string().describe('Source memory ID'),
+    targetId: z.string().describe('Target memory ID'),
+    type: z.enum([
+        'supports', 'contradicts', 'elaborates', 'supersedes',
+        'causes', 'caused_by', 'part_of', 'instance_of',
+        'associated_with', 'temporal_next', 'derived_from',
+    ]).describe('Relationship type'),
+    strength: z.number().min(0).max(1).optional().describe('Connection strength 0-1'),
+}, async (args) => {
+    const edge = vault.connect(args.sourceId, args.targetId, args.type, args.strength);
+    return {
+        content: [{ type: 'text', text: `Connected: ${args.sourceId} —[${args.type}]→ ${args.targetId} (strength: ${edge.strength})` }],
+    };
+});
+// ============================================================
+// Tool: stats
+// ============================================================
+server.tool('engram_stats', 'Get vault statistics — memory counts by type, entity count, etc.', {}, async () => {
+    const stats = vault.stats();
+    const entities = vault.entities();
+    return {
+        content: [{
+                type: 'text',
+                text: JSON.stringify({
+                    ...stats,
+                    topEntities: entities.slice(0, 10).map(e => ({ name: e.name, memories: e.memoryCount })),
+                }, null, 2),
+            }],
+    };
+});
+// ============================================================
+// Tool: ingest
+// ============================================================
+server.tool('engram_ingest', 'Auto-ingest a conversation transcript or raw text. Extracts structured memories using LLM.', {
+    text: z.string().describe('Raw conversation text or transcript to ingest'),
+    humanName: z.string().optional().describe('Name of the human in the conversation'),
+}, async (args) => {
+    if (!geminiKey) {
+        // Simple mode: just remember with auto-extraction
+        const memory = vault.remember({ content: args.text });
+        return { content: [{ type: 'text', text: `Stored 1 memory (simple mode — set GEMINI_API_KEY for LLM extraction).` }] };
+    }
+    // LLM extraction
+    const prompt = `You are a memory extraction engine. Analyze this text and extract structured memories.
+
+TEXT:
+${args.text.slice(0, 4000)}
+
+Extract memories worth keeping long-term. For each:
+- content: Clear standalone statement
+- type: "episodic", "semantic", or "procedural"
+- entities: People, projects, tools mentioned
+- topics: Topic tags
+- salience: 0.0-1.0
+- status: "active" or "pending" (for commitments)
+
+Be selective. Skip trivial content.
+
+JSON: {"memories": [{"content":"...","type":"...","entities":["..."],"topics":["..."],"salience":0.5,"status":"active"}]}
+If nothing worth remembering: {"memories": []}`;
+    try {
+        const response = await fetch(`https://generativelanguage.googleapis.com/v1beta/models/gemini-2.0-flash:generateContent?key=${geminiKey}`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({
+                contents: [{ parts: [{ text: prompt }] }],
+                generationConfig: { responseMimeType: 'application/json', maxOutputTokens: 2048 },
+            }),
+        });
+        if (!response.ok) {
+            const memory = vault.remember({ content: args.text });
+            return { content: [{ type: 'text', text: `LLM unavailable, stored 1 raw memory as fallback.` }] };
+        }
+        const data = await response.json();
+        const text = data.candidates?.[0]?.content?.parts?.[0]?.text ?? '{}';
+        const parsed = JSON.parse(text);
+        let created = 0;
+        for (const mem of parsed.memories ?? []) {
+            if (mem.salience < 0.2)
+                continue;
+            // Security filter
+            if (/(?:sk-|api[_-]?key|password|token|secret)[:\s=]+\S{10,}/i.test(mem.content))
+                continue;
+            if (/AIza[a-zA-Z0-9_-]{30,}/.test(mem.content))
+                continue;
+            vault.remember({
+                content: mem.content,
+                type: mem.type ?? 'episodic',
+                entities: mem.entities ?? [],
+                topics: [...(mem.topics ?? []), 'auto-ingested'],
+                salience: mem.salience ?? 0.5,
+                status: mem.status ?? 'active',
+            });
+            created++;
+        }
+        return { content: [{ type: 'text', text: `Extracted ${created} memories from text.` }] };
+    }
+    catch (err) {
+        const memory = vault.remember({ content: args.text });
+        return { content: [{ type: 'text', text: `LLM error, stored 1 raw memory as fallback.` }] };
+    }
+});
+// ============================================================
+// Tool: surface
+// ============================================================
+server.tool('engram_surface', 'Proactive memory surfacing — send current context and get back memories you SHOULD know about right now. Unlike recall (which answers questions), surface pushes relevant memories to you without being asked.', {
+    context: z.string().describe('What is happening right now — current conversation, task, or situation'),
+    activeEntities: z.array(z.string()).optional().describe('People, projects, tools currently active in conversation'),
+    activeTopics: z.array(z.string()).optional().describe('Topics currently being discussed'),
+    seen: z.array(z.string()).optional().describe('Memory IDs already seen this session (to avoid repeats)'),
+}, async (args) => {
+    const results = await vault.surface({
+        context: args.context,
+        activeEntities: args.activeEntities,
+        activeTopics: args.activeTopics,
+        seen: args.seen,
+    });
+    if (results.length === 0) {
+        return { content: [{ type: 'text', text: 'No proactive memories to surface right now.' }] };
+    }
+    const formatted = results.map((r, i) => `[${i + 1}] (relevance: ${r.relevance.toFixed(2)}) ${r.memory.content}\n    Why: ${r.reason}\n    Path: ${r.activationPath}`).join('\n\n');
+    return {
+        content: [{
+                type: 'text',
+                text: `💡 ${results.length} memories surfaced:\n\n${formatted}`,
+            }],
+    };
+});
+// ============================================================
+// Tool: briefing
+// ============================================================
+server.tool('engram_briefing', 'Get a structured session briefing — key facts, pending commitments, recent activity, and contradictions. Use at session start instead of reading flat memory files.', {
+    context: z.string().optional().describe('Optional context to focus the briefing on'),
+}, async (args) => {
+    const briefing = await vault.briefing(args.context ?? '');
+    return {
+        content: [{
+                type: 'text',
+                text: JSON.stringify(briefing, null, 2),
+            }],
+    };
+});
+// ============================================================
+// Tool: entities
+// ============================================================
+server.tool('engram_entities', 'List all tracked entities (people, projects, concepts) with memory counts.', {}, async () => {
+    const entities = vault.entities();
+    if (entities.length === 0) {
+        return { content: [{ type: 'text', text: 'No entities tracked yet.' }] };
+    }
+    const formatted = entities.map(e => `${e.name} (${e.type}, ${e.memoryCount} memories, importance: ${e.importance.toFixed(2)})`).join('\n');
+    return { content: [{ type: 'text', text: `${entities.length} entities:\n${formatted}` }] };
+});
+// ============================================================
+// Start server
+// ============================================================
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error(`🧠 Engram MCP server running (owner: ${owner}, db: ${dbPath})`);
+    if (embedder)
+        console.error(`   Embeddings: ${geminiKey ? 'Gemini' : 'OpenAI'}`);
+    if (llmProvider)
+        console.error(`   LLM: ${llmProvider} (consolidation enabled)`);
+}
+main().catch(console.error);
+//# sourceMappingURL=mcp.js.map

package/dist/mcp.js.map

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

package/dist/server.d.ts

@@ -0,0 +1,17 @@
+#!/usr/bin/env node
+import type { VaultConfig } from './types.js';
+interface ServerConfig {
+    port?: number;
+    host?: string;
+    /** Map of API key → vault config. Each key gets its own vault. */
+    vaults: Record<string, VaultConfig>;
+    /** Default vault config for single-tenant mode */
+    defaultVault?: VaultConfig;
+}
+export declare function createEngramServer(config: ServerConfig): {
+    listen: () => Promise<void>;
+    close: () => Promise<void>;
+    server: import("http").Server<typeof import("http").IncomingMessage, typeof import("http").ServerResponse>;
+};
+export {};
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":";AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAO9C,UAAU,YAAY;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kEAAkE;IAClE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACpC,kDAAkD;IAClD,YAAY,CAAC,EAAE,WAAW,CAAC;CAC5B;AAkaD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,YAAY;;;;EAwGtD"}