@cartisien/engram-mcp 0.3.3 → 0.4.0

package/dist/client.js

@@ -18,7 +18,10 @@ export async function getEngram() {
         maxContextLength: config.maxContextLength,
         dedupThreshold: config.dedupThreshold,
         enableWAL: config.enableWAL,
-        graphMemory: true,
+        // T-P3-06 — honor the config (which honors ENGRAM_GRAPH_MEMORY env, default false).
+        // Previous code forced `true` regardless of env, so graph extraction ran in every
+        // MCP session and wrote inferred entities into graph_edges.
+        graphMemory: config.graphMemory,
         enableFTS5: true,
         semanticSearch: config.semanticSearch,
     });

package/dist/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAC/B,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,IAAI,QAAQ,GAAkB,IAAI,CAAC;AAEnC,MAAM,CAAC,KAAK,UAAU,SAAS;IAC7B,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAE9B,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAE5B,6BAA6B;IAC7B,IAAI,MAAM,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;QACjC,MAAM,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3D,CAAC;IAED,QAAQ,GAAG,IAAI,MAAM,CAAC;QACpB,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,cAAc,EAAE,MAAM,CAAC,cAAc;QACrC,gBAAgB,EAAE,MAAM,CAAC,gBAAgB;QACzC,cAAc,EAAE,MAAM,CAAC,cAAc;QACrC,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,WAAW,EAAE,IAAI;QACjB,UAAU,EAAE,IAAI;QAChB,cAAc,EAAE,MAAM,CAAC,cAAc;KACtC,CAAC,CAAC;IAEH,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;IACtB,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,cAAc;IAC5B,OAAO,UAAU,EAAE,CAAC,SAAS,CAAC;AAChC,CAAC"}
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAC/B,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,IAAI,QAAQ,GAAkB,IAAI,CAAC;AAEnC,MAAM,CAAC,KAAK,UAAU,SAAS;IAC7B,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAE9B,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAE5B,6BAA6B;IAC7B,IAAI,MAAM,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;QACjC,MAAM,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3D,CAAC;IAED,QAAQ,GAAG,IAAI,MAAM,CAAC;QACpB,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,cAAc,EAAE,MAAM,CAAC,cAAc;QACrC,gBAAgB,EAAE,MAAM,CAAC,gBAAgB;QACzC,cAAc,EAAE,MAAM,CAAC,cAAc;QACrC,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,oFAAoF;QACpF,kFAAkF;QAClF,4DAA4D;QAC5D,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,UAAU,EAAE,IAAI;QAChB,cAAc,EAAE,MAAM,CAAC,cAAc;KACtC,CAAC,CAAC;IAEH,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;IACtB,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,cAAc;IAC5B,OAAO,UAAU,EAAE,CAAC,SAAS,CAAC;AAChC,CAAC"}

package/dist/config.js

@@ -3,6 +3,14 @@ import { join } from 'path';
 function env(key, fallback) {
     return process.env[key] ?? fallback;
 }
+/** Parse a boolean-ish env var. Returns the default unless the value is "true". */
+function envBool(key, fallback) {
+    const raw = process.env[key];
+    if (raw === undefined)
+        return fallback;
+    const v = raw.trim().toLowerCase();
+    return v === 'true' || v === '1' || v === 'yes';
+}
 export function loadConfig() {
     return {
         dbPath: env('ENGRAM_DB_PATH', join(homedir(), '.engram', 'memory.db')),
@@ -12,9 +20,13 @@ export function loadConfig() {
         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
+        enableWAL: envBool('ENGRAM_ENABLE_WAL', true),
+        semanticSearch: envBool('ENGRAM_SEMANTIC_SEARCH', true),
+        // T-P3-06 — graph memory is OFF by default. The regex-based extractor
+        // writes inferred entities (which may include PII pulled from chat
+        // content) into the graph_edges table. Privacy-by-default requires
+        // explicit opt-in. Enable via ENGRAM_GRAPH_MEMORY=true.
+        graphMemory: envBool('ENGRAM_GRAPH_MEMORY', false),
     };
 }
 //# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -1 +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"}
+{"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,mFAAmF;AACnF,SAAS,OAAO,CAAC,GAAW,EAAE,QAAiB;IAC7C,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC7B,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,QAAQ,CAAC;IACvC,MAAM,CAAC,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACnC,OAAO,CAAC,KAAK,MAAM,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,KAAK,CAAC;AAClD,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,OAAO,CAAC,mBAAmB,EAAE,IAAI,CAAC;QAC7C,cAAc,EAAE,OAAO,CAAC,wBAAwB,EAAE,IAAI,CAAC;QACvD,sEAAsE;QACtE,mEAAmE;QACnE,mEAAmE;QACnE,wDAAwD;QACxD,WAAW,EAAE,OAAO,CAAC,qBAAqB,EAAE,KAAK,CAAC;KACnD,CAAC;AACJ,CAAC"}

package/dist/dispatch.d.ts

@@ -0,0 +1,402 @@
+import type { Engram } from '@cartisien/engram';
+/**
+ * Single source of truth for the tool registry and dispatch.
+ *
+ * Both transports consume this: the stdio bin (`server.ts`) and the in-process
+ * `McpServer` (`mcp-server.ts`) used by the hosted API. Previously the switch
+ * lived only inside `server.ts`'s stdio `main()`, so the hosted path had no way
+ * to reach the tools and returned 501.
+ */
+export declare const ALL_TOOLS: ({
+    readonly name: "remember";
+    readonly description: "Store a new memory with automatic entity extraction, theme detection, and relationship mapping.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly content: {
+                readonly type: "string";
+                readonly description: "The memory text to store";
+            };
+            readonly role: {
+                readonly type: "string";
+                readonly enum: readonly ["user", "assistant", "system"];
+                readonly default: "user";
+            };
+            readonly session_id: {
+                readonly type: "string";
+                readonly description: "Session identifier (defaults to ENGRAM_SESSION_ID)";
+            };
+            readonly timestamp: {
+                readonly type: "string";
+                readonly description: "ISO8601 timestamp (defaults to now)";
+            };
+            readonly metadata: {
+                readonly type: "object";
+                readonly description: "Arbitrary key-value metadata";
+            };
+            readonly extract_entities: {
+                readonly type: "boolean";
+                readonly default: true;
+                readonly description: "Auto-extract entities and store in graph";
+            };
+        };
+        readonly required: readonly ["content"];
+    };
+} | {
+    readonly name: "recall";
+    readonly description: "Retrieve relevant memories with entity, theme, and emotional context. Returns 360° relational intelligence around the query.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly query: {
+                readonly type: "string";
+                readonly description: "What to search for";
+            };
+            readonly session_id: {
+                readonly type: "string";
+            };
+            readonly limit: {
+                readonly type: "number";
+                readonly default: 5;
+                readonly description: "Max results (default: 5, max: 50)";
+            };
+            readonly min_relevance: {
+                readonly type: "number";
+                readonly default: 0.7;
+                readonly description: "Minimum relevance score 0-1";
+            };
+            readonly include_context: {
+                readonly type: "boolean";
+                readonly default: true;
+            };
+            readonly time_range: {
+                readonly type: "object";
+                readonly properties: {
+                    readonly start: {
+                        readonly type: "string";
+                        readonly description: "ISO8601 start date";
+                    };
+                    readonly end: {
+                        readonly type: "string";
+                        readonly description: "ISO8601 end date";
+                    };
+                };
+            };
+            readonly entity_filter: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "string";
+                };
+                readonly description: "Only return memories mentioning these entities";
+            };
+            readonly theme_filter: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "string";
+                };
+                readonly description: "Only return memories matching these themes";
+            };
+            readonly tiers: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "string";
+                };
+                readonly description: "Memory tiers to search: working, long_term, archived";
+            };
+        };
+        readonly required: readonly ["query"];
+    };
+} | {
+    readonly name: "search";
+    readonly description: "Raw hybrid search with pagination and filtering. Use for precise control over results.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly query: {
+                readonly type: "string";
+            };
+            readonly session_id: {
+                readonly type: "string";
+            };
+            readonly search_type: {
+                readonly type: "string";
+                readonly enum: readonly ["hybrid", "semantic", "fts", "graph"];
+                readonly default: "hybrid";
+            };
+            readonly limit: {
+                readonly type: "number";
+                readonly default: 10;
+            };
+            readonly offset: {
+                readonly type: "number";
+                readonly default: 0;
+            };
+            readonly semantic_weight: {
+                readonly type: "number";
+                readonly description: "0-1, weight for semantic vs BM25 (not yet configurable in v0.7)";
+            };
+            readonly filters: {
+                readonly type: "object";
+                readonly properties: {
+                    readonly role: {
+                        readonly type: "array";
+                        readonly items: {
+                            readonly type: "string";
+                        };
+                    };
+                    readonly tier: {
+                        readonly type: "array";
+                        readonly items: {
+                            readonly type: "string";
+                        };
+                    };
+                    readonly date_after: {
+                        readonly type: "string";
+                    };
+                    readonly date_before: {
+                        readonly type: "string";
+                    };
+                };
+            };
+        };
+        readonly required: readonly ["query"];
+    };
+} | {
+    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"];
+    };
+} | {
+    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"];
+    };
+} | {
+    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"];
+    };
+} | {
+    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";
+            };
+        };
+    };
+} | {
+    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";
+                    };
+                };
+            };
+        };
+    };
+} | {
+    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"];
+    };
+} | {
+    readonly name: "stats";
+    readonly description: "Get memory statistics for a session: counts by role/tier, embeddings coverage, importance scores, and graph metrics.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly session_id: {
+                readonly type: "string";
+            };
+            readonly include_graph: {
+                readonly type: "boolean";
+                readonly default: true;
+                readonly description: "Include entity graph node/edge counts";
+            };
+        };
+    };
+} | {
+    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"];
+    };
+})[];
+/**
+ * Dispatch a single tool call against a given Engram instance and return the
+ * raw tool result (an `McpResponse`). Transport layers are responsible for
+ * wrapping this into their own envelope (MCP `content` blocks, HTTP JSON, ...).
+ *
+ * Runtime validation lives in each tool handler; the `unknown` cast mirrors the
+ * original stdio dispatcher.
+ */
+export declare function callTool(engram: Engram, name: string, args?: Record<string, unknown>): Promise<unknown>;

package/dist/dispatch.js

@@ -0,0 +1,75 @@
+import { VERSION } from './response.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';
+/**
+ * Single source of truth for the tool registry and dispatch.
+ *
+ * Both transports consume this: the stdio bin (`server.ts`) and the in-process
+ * `McpServer` (`mcp-server.ts`) used by the hosted API. Previously the switch
+ * lived only inside `server.ts`'s stdio `main()`, so the hosted path had no way
+ * to reach the tools and returned 501.
+ */
+export 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,
+];
+/**
+ * Dispatch a single tool call against a given Engram instance and return the
+ * raw tool result (an `McpResponse`). Transport layers are responsible for
+ * wrapping this into their own envelope (MCP `content` blocks, HTTP JSON, ...).
+ *
+ * Runtime validation lives in each tool handler; the `unknown` cast mirrors the
+ * original stdio dispatcher.
+ */
+export async function callTool(engram, name, args = {}) {
+    const a = args;
+    switch (name) {
+        case 'remember':
+            return toolRemember(engram, a);
+        case 'recall':
+            return toolRecall(engram, a);
+        case 'search':
+            return toolSearch(engram, a);
+        case 'context':
+            return toolContext(engram, a);
+        case 'impact':
+            return toolImpact(engram, a);
+        case 'detect_changes':
+            return toolDetectChanges(engram, a);
+        case 'consolidate':
+            return toolConsolidate(engram, a);
+        case 'process_detect':
+            return toolProcessDetect(engram, a);
+        case 'forget':
+            return toolForget(engram, a);
+        case 'stats':
+            return toolStats(engram, a);
+        case 'graph':
+            return toolGraph(engram, a);
+        default:
+            return {
+                success: false,
+                error: { code: 'UNKNOWN_TOOL', message: `Unknown tool: ${name}` },
+                meta: { query_time_ms: 0, version: VERSION, session_id: 'unknown' },
+            };
+    }
+}
+//# sourceMappingURL=dispatch.js.map

package/dist/dispatch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch.js","sourceRoot":"","sources":["../src/dispatch.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACpE,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACjE,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AACrF,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC7E,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AACrF,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAE3D;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,eAAe;IACf,aAAa;IACb,aAAa;IACb,cAAc;IACd,aAAa;IACb,qBAAqB;IACrB,kBAAkB;IAClB,qBAAqB;IACrB,aAAa;IACb,YAAY;IACZ,YAAY;CACb,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,MAAc,EACd,IAAY,EACZ,OAAgC,EAAE;IAElC,MAAM,CAAC,GAAG,IAAe,CAAC;IAC1B,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,UAAU;YACb,OAAO,YAAY,CAAC,MAAM,EAAE,CAAuC,CAAC,CAAC;QACvE,KAAK,QAAQ;YACX,OAAO,UAAU,CAAC,MAAM,EAAE,CAAqC,CAAC,CAAC;QACnE,KAAK,QAAQ;YACX,OAAO,UAAU,CAAC,MAAM,EAAE,CAAqC,CAAC,CAAC;QACnE,KAAK,SAAS;YACZ,OAAO,WAAW,CAAC,MAAM,EAAE,CAAsC,CAAC,CAAC;QACrE,KAAK,QAAQ;YACX,OAAO,UAAU,CAAC,MAAM,EAAE,CAAqC,CAAC,CAAC;QACnE,KAAK,gBAAgB;YACnB,OAAO,iBAAiB,CAAC,MAAM,EAAE,CAA4C,CAAC,CAAC;QACjF,KAAK,aAAa;YAChB,OAAO,eAAe,CAAC,MAAM,EAAE,CAA0C,CAAC,CAAC;QAC7E,KAAK,gBAAgB;YACnB,OAAO,iBAAiB,CAAC,MAAM,EAAE,CAA4C,CAAC,CAAC;QACjF,KAAK,QAAQ;YACX,OAAO,UAAU,CAAC,MAAM,EAAE,CAAqC,CAAC,CAAC;QACnE,KAAK,OAAO;YACV,OAAO,SAAS,CAAC,MAAM,EAAE,CAAoC,CAAC,CAAC;QACjE,KAAK,OAAO;YACV,OAAO,SAAS,CAAC,MAAM,EAAE,CAAoC,CAAC,CAAC;QACjE;YACE,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,iBAAiB,IAAI,EAAE,EAAE;gBACjE,IAAI,EAAE,EAAE,aAAa,EAAE,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE;aACpE,CAAC;IACN,CAAC;AACH,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Library entry for @cartisien/engram-mcp.
+ *
+ * Side-effect free: importing this module must NOT start a stdio server (the
+ * bin, `server.ts`, does that). The hosted API imports `McpServer` from here to
+ * run the tools in-process, per workspace.
+ */
+export { McpServer } from './mcp-server.js';
+export type { McpServerOptions, JsonRpcResponse } from './mcp-server.js';
+export { ALL_TOOLS, callTool } from './dispatch.js';
+export { extractEntities, entityRelation } from './analysis/entities.js';
+export type { ExtractedEntity, EntityType } from './analysis/entities.js';
+export { VERSION } from './response.js';

package/dist/index.js

@@ -0,0 +1,12 @@
+/**
+ * Library entry for @cartisien/engram-mcp.
+ *
+ * Side-effect free: importing this module must NOT start a stdio server (the
+ * bin, `server.ts`, does that). The hosted API imports `McpServer` from here to
+ * run the tools in-process, per workspace.
+ */
+export { McpServer } from './mcp-server.js';
+export { ALL_TOOLS, callTool } from './dispatch.js';
+export { extractEntities, entityRelation } from './analysis/entities.js';
+export { VERSION } from './response.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAEzE,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC"}

package/dist/mcp-server.d.ts

@@ -0,0 +1,40 @@
+import type { Engram } from '@cartisien/engram';
+export interface McpServerOptions {
+    /** Workspace-scoped Engram instance the tools operate against. */
+    engram: Engram;
+    /** SSE sink for the GET stream: `(event, data) => void`. */
+    onEvent?: (event: string, data: unknown) => void;
+}
+export interface JsonRpcResponse {
+    jsonrpc: '2.0';
+    id: string | number | null;
+    result?: unknown;
+    error?: {
+        code: number;
+        message: string;
+        data?: unknown;
+    };
+}
+export declare class McpServer {
+    private readonly engram;
+    private readonly onEvent?;
+    private keepAlive?;
+    constructor(opts: McpServerOptions);
+    /**
+     * Open the server→client SSE channel. The Engram tools are request/response
+     * only and never push server-initiated notifications, so the stream simply
+     * announces readiness and emits periodic keepalives to keep proxies from
+     * closing an idle connection. Actual tool calls flow through `handle()`.
+     */
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    /**
+     * Handle one JSON-RPC message, or a batch array. Returns the response(s), or
+     * `null` for notifications (messages without an `id`), which per JSON-RPC
+     * receive no reply — the caller should answer 202 with no body.
+     */
+    handle(message: unknown): Promise<JsonRpcResponse | JsonRpcResponse[] | null>;
+    private handleOne;
+    private ok;
+    private err;
+}

package/dist/mcp-server.js

@@ -0,0 +1,127 @@
+import { ALL_TOOLS, callTool } from './dispatch.js';
+import { VERSION } from './response.js';
+/**
+ * In-process, transport-agnostic MCP server.
+ *
+ * The stdio bin (`server.ts`) wires the tools to a `StdioServerTransport`. The
+ * hosted API instead needs to drive the same tools per-workspace over HTTP, so
+ * it constructs one of these with an injected, workspace-scoped Engram instance
+ * and calls `handle()` (Streamable-HTTP POST) or `start()`/`stop()` (the SSE
+ * GET channel). This is what the API's `import('@cartisien/engram-mcp')` looks
+ * for; before it existed the hosted endpoint returned 501.
+ *
+ * `handle()` implements the JSON-RPC 2.0 subset the MCP protocol requires
+ * (`initialize`, `tools/list`, `tools/call`, `ping`, and notifications). It is
+ * stateless: each call is self-contained, which matches the API POST handler
+ * creating a fresh server per request.
+ */
+const PROTOCOL_VERSION = '2024-11-05';
+const SERVER_INFO = { name: 'engram', version: VERSION };
+export class McpServer {
+    engram;
+    onEvent;
+    keepAlive;
+    constructor(opts) {
+        this.engram = opts.engram;
+        this.onEvent = opts.onEvent;
+    }
+    /**
+     * Open the server→client SSE channel. The Engram tools are request/response
+     * only and never push server-initiated notifications, so the stream simply
+     * announces readiness and emits periodic keepalives to keep proxies from
+     * closing an idle connection. Actual tool calls flow through `handle()`.
+     */
+    async start() {
+        this.onEvent?.('ready', { serverInfo: SERVER_INFO, protocolVersion: PROTOCOL_VERSION });
+        this.keepAlive = setInterval(() => {
+            try {
+                this.onEvent?.('ping', {});
+            }
+            catch {
+                /* stream already closed — stop() will clear the timer */
+            }
+        }, 25_000);
+        // Don't let keepalives alone hold the event loop open.
+        this.keepAlive.unref?.();
+    }
+    async stop() {
+        if (this.keepAlive) {
+            clearInterval(this.keepAlive);
+            this.keepAlive = undefined;
+        }
+    }
+    /**
+     * Handle one JSON-RPC message, or a batch array. Returns the response(s), or
+     * `null` for notifications (messages without an `id`), which per JSON-RPC
+     * receive no reply — the caller should answer 202 with no body.
+     */
+    async handle(message) {
+        if (Array.isArray(message)) {
+            const out = [];
+            for (const m of message) {
+                const r = await this.handleOne(m);
+                if (r)
+                    out.push(r);
+            }
+            return out.length ? out : null;
+        }
+        return this.handleOne(message);
+    }
+    async handleOne(req) {
+        const id = req?.id ?? null;
+        // JSON-RPC notifications omit `id` entirely (undefined). `id: null` or
+        // `id: 0` are valid request ids and still expect a response.
+        if (!req || req.id === undefined) {
+            // e.g. notifications/initialized, notifications/cancelled — no-op, no reply.
+            return null;
+        }
+        const method = req.method;
+        try {
+            switch (method) {
+                case 'initialize':
+                    return this.ok(id, {
+                        protocolVersion: req.params?.protocolVersion ?? PROTOCOL_VERSION,
+                        capabilities: { tools: {} },
+                        serverInfo: SERVER_INFO,
+                    });
+                case 'ping':
+                    return this.ok(id, {});
+                case 'tools/list':
+                    return this.ok(id, {
+                        tools: ALL_TOOLS.map((t) => ({
+                            name: t.name,
+                            description: t.description,
+                            inputSchema: t.inputSchema,
+                        })),
+                    });
+                case 'tools/call': {
+                    const name = req.params?.name;
+                    const args = (req.params?.arguments ?? {});
+                    if (!name) {
+                        return this.err(id, -32602, 'Invalid params: tool name is required');
+                    }
+                    const result = await callTool(this.engram, name, args);
+                    const isError = !!(result &&
+                        typeof result === 'object' &&
+                        result.success === false);
+                    return this.ok(id, {
+                        content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+                        isError,
+                    });
+                }
+                default:
+                    return this.err(id, -32601, `Method not found: ${method ?? '(none)'}`);
+            }
+        }
+        catch (err) {
+            return this.err(id, -32603, `Internal error: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    ok(id, result) {
+        return { jsonrpc: '2.0', id, result };
+    }
+    err(id, code, message) {
+        return { jsonrpc: '2.0', id, error: { code, message } };
+    }
+}
+//# sourceMappingURL=mcp-server.js.map

package/dist/mcp-server.js.map

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

package/dist/response.d.ts

@@ -13,5 +13,6 @@ export interface McpResponse<T = unknown> {
     };
     suggestions?: string[];
 }
+export declare const VERSION: 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

@@ -1,4 +1,8 @@
-const VERSION = '0.2.0';
+import { createRequire } from 'node:module';
+// Single-source the version from package.json — hardcoded copies drifted
+// (package.json was bumped to 0.3.0 while '0.2.0' lingered in three files).
+// '../package.json' resolves to the package root from both src/ and dist/.
+export const VERSION = createRequire(import.meta.url)('../package.json').version;
 export function ok(data, sessionId, startMs, suggestions) {
     return {
         success: true,

package/dist/response.js.map

@@ -1 +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"}
+{"version":3,"file":"response.js","sourceRoot":"","sources":["../src/response.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAU5C,yEAAyE;AACzE,4EAA4E;AAC5E,2EAA2E;AAC3E,MAAM,CAAC,MAAM,OAAO,GAAW,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,iBAAiB,CAAC,CAAC,OAAO,CAAC;AAEzF,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

@@ -1,7 +1,10 @@
 #!/usr/bin/env node
 /**
- * Engram MCP Server v0.2.0
+ * Engram MCP Server (version: see package.json)
  * Exposes agent memory as structured relational intelligence.
- * Transport: stdio
+ * Transport: stdio (this is the `engram-mcp` bin).
+ *
+ * The tool registry and dispatch live in ./dispatch.js so the hosted API's
+ * in-process McpServer (./mcp-server.js) drives exactly the same tools.
  */
 export {};

package/dist/server.js

@@ -1,39 +1,20 @@
 #!/usr/bin/env node
 /**
- * Engram MCP Server v0.2.0
+ * Engram MCP Server (version: see package.json)
  * Exposes agent memory as structured relational intelligence.
- * Transport: stdio
+ * Transport: stdio (this is the `engram-mcp` bin).
+ *
+ * The tool registry and dispatch live in ./dispatch.js so the hosted API's
+ * in-process McpServer (./mcp-server.js) drives exactly the same tools.
  */
 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,
-];
+import { VERSION } from './response.js';
+import { ALL_TOOLS, callTool } from './dispatch.js';
 async function main() {
-    const server = new Server({ name: 'engram', version: '0.2.0' }, { capabilities: { tools: {} } });
+    const server = new Server({ name: 'engram', version: VERSION }, { capabilities: { tools: {} } });
     // List available tools
     server.setRequestHandler(ListToolsRequestSchema, async () => ({
         tools: ALL_TOOLS.map(t => ({
@@ -42,54 +23,11 @@ async function main() {
             inputSchema: t.inputSchema,
         })),
     }));
-    // Handle tool calls
+    // Handle tool calls — stdio uses the process-global (config-driven) Engram.
     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' },
-                };
-        }
+        const result = await callTool(engram, name, args);
         return {
             content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
         };

package/dist/server.js.map

@@ -1 +1 @@
-{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":";AACA;;;;;;;GAOG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EACL,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,oCAAoC,CAAC;AAE5C,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEpD,KAAK,UAAU,IAAI;IACjB,MAAM,MAAM,GAAG,IAAI,MAAM,CACvB,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,EACpC,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,CAChC,CAAC;IAEF,uBAAuB;IACvB,MAAM,CAAC,iBAAiB,CAAC,sBAAsB,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;QAC5D,KAAK,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YACzB,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,WAAW,EAAE,CAAC,CAAC,WAAW;YAC1B,WAAW,EAAE,CAAC,CAAC,WAAW;SAC3B,CAAC,CAAC;KACJ,CAAC,CAAC,CAAC;IAEJ,4EAA4E;IAC5E,MAAM,CAAC,iBAAiB,CAAC,qBAAqB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QAChE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;QACtD,MAAM,MAAM,GAAG,MAAM,SAAS,EAAE,CAAC;QACjC,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,MAAM,EAAE,IAAI,EAAE,IAA+B,CAAC,CAAC;QAC7E,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;SACnE,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAClC,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACnB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,2BAA2B,GAAG,IAAI,CAAC,CAAC;IACzD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "@cartisien/engram-mcp",
-  "version": "0.3.3",
+  "version": "0.4.0",
   "description": "MCP server for Engram — structured agent memory as relational intelligence",
   "type": "module",
-  "main": "dist/server.js",
+  "main": "dist/index.js",
   "bin": {
     "engram-mcp": "dist/server.js"
   },
@@ -31,6 +31,14 @@
   "engines": {
     "node": ">=18.0.0"
   },
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
   "scripts": {
     "build": "tsc",
     "dev": "tsc --watch",