@199-bio/engram 0.3.1 → 0.4.0

package/dist/graph/extractor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"extractor.d.ts","sourceRoot":"","sources":["../../src/graph/extractor.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,QAAQ,GAAG,OAAO,GAAG,SAAS,GAAG,OAAO,GAAG,cAAc,CAAC;IAChE,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;CACtC;AAwFD,qBAAa,eAAe;IAC1B;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,EAAE;IA8D3C;;OAEG;IACH,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,EAAE;IAuFrD;;OAEG;IACH,OAAO,CAAC,WAAW;IAInB;;OAEG;IACH,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,EAAE;IAe/C;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAyC/B;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAuC9B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAiC5B;;OAEG;IACH,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,CAAC;QACxC,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;CA4BH;AAGD,eAAO,MAAM,eAAe,iBAAwB,CAAC"}
+{"version":3,"file":"extractor.d.ts","sourceRoot":"","sources":["../../src/graph/extractor.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,QAAQ,GAAG,OAAO,GAAG,SAAS,GAAG,OAAO,GAAG,cAAc,CAAC;IAChE,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;CACtC;AAwID,qBAAa,eAAe;IAC1B;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,EAAE;IA8D3C;;OAEG;IACH,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,EAAE;IAuFrD;;OAEG;IACH,OAAO,CAAC,WAAW;IAInB;;OAEG;IACH,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,EAAE;IAe/C;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAyC/B;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAuC9B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAiC5B;;OAEG;IACH,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,CAAC;QACxC,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;CA4BH;AAGD,eAAO,MAAM,eAAe,iBAAwB,CAAC"}

package/dist/index.js

@@ -42,7 +42,7 @@ async function initialize() {
 // ============ MCP Server ============
 const server = new Server({
     name: "engram",
-    version: "0.3.1",
+    version: "0.4.0",
 }, {
     capabilities: {
         tools: {},
@@ -136,153 +136,6 @@ const TOOLS = [
             openWorldHint: false,
         },
     },
-    {
-        name: "create_entity",
-        description: "ADVANCED: Manually create an entity. Rarely needed - remember auto-extracts entities. Only use when: (1) creating an entity that won't appear in any memory content, or (2) correcting entity type after auto-extraction.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                name: {
-                    type: "string",
-                    description: "Entity name (e.g., 'John Smith', 'Paris', 'Machine Learning')",
-                },
-                type: {
-                    type: "string",
-                    enum: ["person", "place", "concept", "event", "organization"],
-                    description: "Type of entity",
-                },
-            },
-            required: ["name", "type"],
-        },
-        annotations: {
-            title: "Create Entity",
-            readOnlyHint: false,
-            destructiveHint: false,
-            idempotentHint: true,
-            openWorldHint: false,
-        },
-    },
-    {
-        name: "observe",
-        description: "ADVANCED: Add a fact to an EXISTING entity without creating a memory. Rarely needed - use remember instead, which stores the content AND links it to entities. Only use observe for adding metadata or corrections to entities.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                entity: {
-                    type: "string",
-                    description: "Entity name to add observation to (must already exist)",
-                },
-                observation: {
-                    type: "string",
-                    description: "The fact or observation to record",
-                },
-                confidence: {
-                    type: "number",
-                    description: "Confidence in this observation (0-1)",
-                    default: 1.0,
-                },
-            },
-            required: ["entity", "observation"],
-        },
-        annotations: {
-            title: "Add Observation",
-            readOnlyHint: false,
-            destructiveHint: false,
-            idempotentHint: false,
-            openWorldHint: false,
-        },
-    },
-    {
-        name: "relate",
-        description: "ADVANCED: Manually create a relationship between two entities. Rarely needed - remember auto-extracts relationships from text. Only use when: (1) the relationship wasn't captured by auto-extraction, or (2) you need to add a relationship not mentioned in any memory.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                from: {
-                    type: "string",
-                    description: "Source entity name",
-                },
-                to: {
-                    type: "string",
-                    description: "Target entity name",
-                },
-                relation: {
-                    type: "string",
-                    description: "Type of relationship (e.g., 'sibling', 'works_at', 'knows', 'located_in')",
-                },
-            },
-            required: ["from", "to", "relation"],
-        },
-        annotations: {
-            title: "Create Relationship",
-            readOnlyHint: false,
-            destructiveHint: false,
-            idempotentHint: true,
-            openWorldHint: false,
-        },
-    },
-    {
-        name: "query_entity",
-        description: "Get all stored information about a specific person, place, or organization. Use after recall to get deeper details about an entity mentioned in search results.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                entity: {
-                    type: "string",
-                    description: "Entity name to query",
-                },
-            },
-            required: ["entity"],
-        },
-        annotations: {
-            title: "Query Entity",
-            readOnlyHint: true,
-            destructiveHint: false,
-            idempotentHint: true,
-            openWorldHint: false,
-        },
-    },
-    {
-        name: "list_entities",
-        description: "List all known entities (people, places, organizations, etc.). Use to browse the knowledge graph or find entity names for query_entity.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                type: {
-                    type: "string",
-                    enum: ["person", "place", "concept", "event", "organization"],
-                    description: "Filter by entity type (optional)",
-                },
-                limit: {
-                    type: "number",
-                    description: "Maximum number of entities to return",
-                    default: 50,
-                },
-            },
-        },
-        annotations: {
-            title: "List Entities",
-            readOnlyHint: true,
-            destructiveHint: false,
-            idempotentHint: true,
-            openWorldHint: false,
-        },
-    },
-    {
-        name: "stats",
-        description: "Get memory statistics (counts of memories, entities, relations, observations)",
-        inputSchema: {
-            type: "object",
-            properties: {},
-        },
-        annotations: {
-            title: "Get Statistics",
-            readOnlyHint: true,
-            destructiveHint: false,
-            idempotentHint: true,
-            openWorldHint: false,
-        },
-    },
     {
         name: "engram_web",
         description: "Launch the Engram web interface for browsing, searching, and editing memories visually. Returns a URL to open in your browser.",
@@ -392,143 +245,6 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                     ],
                 };
             }
-            case "create_entity": {
-                const { name: entityName, type } = args;
-                const entity = graph.getOrCreateEntity(entityName, type);
-                return {
-                    content: [
-                        {
-                            type: "text",
-                            text: JSON.stringify({
-                                success: true,
-                                entity: {
-                                    id: entity.id,
-                                    name: entity.name,
-                                    type: entity.type,
-                                },
-                            }, null, 2),
-                        },
-                    ],
-                };
-            }
-            case "observe": {
-                const { entity: entityName, observation, confidence = 1.0 } = args;
-                // Ensure entity exists
-                const entity = graph.getOrCreateEntity(entityName, "person");
-                // Add observation
-                const obs = graph.addObservation(entity.id, observation, undefined, confidence);
-                return {
-                    content: [
-                        {
-                            type: "text",
-                            text: JSON.stringify({
-                                success: true,
-                                entity: entity.name,
-                                observation_id: obs.id,
-                            }, null, 2),
-                        },
-                    ],
-                };
-            }
-            case "relate": {
-                const { from, to, relation } = args;
-                // Ensure both entities exist
-                const fromEntity = graph.getOrCreateEntity(from, "person");
-                const toEntity = graph.getOrCreateEntity(to, "person");
-                // Create relation
-                const rel = graph.relate(fromEntity.id, toEntity.id, relation);
-                return {
-                    content: [
-                        {
-                            type: "text",
-                            text: JSON.stringify({
-                                success: true,
-                                relation: {
-                                    id: rel.id,
-                                    from: fromEntity.name,
-                                    to: toEntity.name,
-                                    type: rel.type,
-                                },
-                            }, null, 2),
-                        },
-                    ],
-                };
-            }
-            case "query_entity": {
-                const { entity: entityName } = args;
-                const details = graph.getEntityDetails(entityName);
-                if (!details) {
-                    return {
-                        content: [
-                            {
-                                type: "text",
-                                text: JSON.stringify({ success: false, error: "Entity not found" }),
-                            },
-                        ],
-                    };
-                }
-                return {
-                    content: [
-                        {
-                            type: "text",
-                            text: JSON.stringify({
-                                entity: {
-                                    id: details.id,
-                                    name: details.name,
-                                    type: details.type,
-                                    created_at: details.created_at.toISOString(),
-                                },
-                                observations: details.observations.map((o) => ({
-                                    content: o.content.substring(0, 200) + (o.content.length > 200 ? "..." : ""),
-                                    confidence: o.confidence,
-                                    valid_from: o.valid_from.toISOString(),
-                                })),
-                                relations_from: details.relationsFrom.map((r) => ({
-                                    type: r.type,
-                                    to: r.targetEntity.name,
-                                })),
-                                relations_to: details.relationsTo.map((r) => ({
-                                    type: r.type,
-                                    from: r.sourceEntity.name,
-                                })),
-                            }, null, 2),
-                        },
-                    ],
-                };
-            }
-            case "list_entities": {
-                const { type, limit = 50 } = args;
-                const entities = graph.listEntities(type, limit);
-                return {
-                    content: [
-                        {
-                            type: "text",
-                            text: JSON.stringify({
-                                entities: entities.map((e) => ({
-                                    id: e.id,
-                                    name: e.name,
-                                    type: e.type,
-                                })),
-                                count: entities.length,
-                            }, null, 2),
-                        },
-                    ],
-                };
-            }
-            case "stats": {
-                const stats = db.getStats();
-                return {
-                    content: [
-                        {
-                            type: "text",
-                            text: JSON.stringify({
-                                ...stats,
-                                database_path: DB_FILE,
-                            }, null, 2),
-                        },
-                    ],
-                };
-            }
             case "engram_web": {
                 const { port = 3847 } = args;
                 // Create or reuse web server

package/dist/storage/database.d.ts.map

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

package/dist/web/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/web/server.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAiBtD,UAAU,gBAAgB;IACxB,EAAE,EAAE,cAAc,CAAC;IACnB,KAAK,EAAE,cAAc,CAAC;IACtB,MAAM,EAAE,YAAY,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,EAAE,CAAiB;IAC3B,OAAO,CAAC,KAAK,CAAiB;IAC9B,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,IAAI,CAAS;gBAET,OAAO,EAAE,gBAAgB;IAO/B,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC;IAkB9B,IAAI,IAAI,IAAI;YAOE,aAAa;YA+Bb,SAAS;YAgIT,WAAW;IAgCzB,OAAO,CAAC,SAAS;CAclB"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/web/server.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAiBtD,UAAU,gBAAgB;IACxB,EAAE,EAAE,cAAc,CAAC;IACnB,KAAK,EAAE,cAAc,CAAC;IACtB,MAAM,EAAE,YAAY,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,EAAE,CAAiB;IAC3B,OAAO,CAAC,KAAK,CAAiB;IAC9B,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,IAAI,CAAS;gBAET,OAAO,EAAE,gBAAgB;IAO/B,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC;IAkB9B,IAAI,IAAI,IAAI;YAOE,aAAa;YA+Bb,SAAS;YAyKT,WAAW;IAgCzB,OAAO,CAAC,SAAS;CAclB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@199-bio/engram",
-  "version": "0.3.1",
+  "version": "0.4.0",
   "description": "Give Claude a perfect memory. Local-first MCP server with hybrid search.",
   "type": "module",
   "main": "dist/index.js",

package/src/graph/extractor.ts

@@ -10,25 +10,73 @@ export interface ExtractedEntity {
   span: { start: number; end: number };
 }
 
-// Common words that look like names but aren't
+// Common words that look like names but aren't (including verbs, adjectives, common nouns)
 const STOPWORDS = new Set([
+  // Articles, conjunctions, prepositions
   "the", "a", "an", "and", "or", "but", "in", "on", "at", "to", "for",
   "of", "with", "by", "from", "as", "is", "was", "are", "were", "been",
   "be", "have", "has", "had", "do", "does", "did", "will", "would",
   "could", "should", "may", "might", "must", "shall", "can", "need",
+  // Pronouns
   "this", "that", "these", "those", "i", "you", "he", "she", "it",
   "we", "they", "what", "which", "who", "whom", "whose", "where",
   "when", "why", "how", "all", "each", "every", "both", "few", "more",
   "most", "other", "some", "such", "no", "not", "only", "same", "so",
   "than", "too", "very", "just", "also", "now", "here", "there", "then",
+  // Conjunctions
   "if", "because", "while", "although", "though", "after", "before",
   "since", "until", "unless", "however", "therefore", "thus", "hence",
+  // Days and months
   "monday", "tuesday", "wednesday", "thursday", "friday", "saturday", "sunday",
   "january", "february", "march", "april", "may", "june", "july",
   "august", "september", "october", "november", "december",
+  // Time words
   "today", "tomorrow", "yesterday", "morning", "afternoon", "evening", "night",
+  // Common verbs (often capitalized at sentence start)
   "said", "says", "told", "asked", "replied", "answered", "mentioned",
   "think", "know", "believe", "feel", "want", "need", "like", "love",
+  "crashed", "gets", "getting", "got", "planning", "planned", "plans",
+  "working", "worked", "works", "going", "went", "gone", "coming", "came",
+  "looking", "looked", "looks", "trying", "tried", "tries", "using", "used",
+  "making", "made", "makes", "taking", "took", "takes", "giving", "gave",
+  "seeing", "saw", "seen", "being", "having", "doing", "saying", "getting",
+  "finding", "found", "keeping", "kept", "letting", "let", "putting", "put",
+  "running", "ran", "calling", "called", "moving", "moved", "living", "lived",
+  "starting", "started", "seems", "seemed", "showing", "showed", "hearing",
+  "playing", "played", "standing", "stood", "understanding", "understood",
+  "turning", "turned", "following", "followed", "watching", "watched",
+  "adding", "added", "changing", "changed", "writing", "wrote", "reading",
+  "learning", "learned", "growing", "grew", "opening", "opened", "walking",
+  "winning", "won", "offering", "offered", "remembering", "remembered",
+  "considering", "considered", "appearing", "appeared", "buying", "bought",
+  "waiting", "waited", "serving", "served", "dying", "died", "sending", "sent",
+  "building", "built", "staying", "stayed", "falling", "fell", "cutting", "cut",
+  "reaching", "reached", "killing", "killed", "raising", "raised", "passing",
+  "selling", "sold", "deciding", "decided", "returning", "returned",
+  // Common adjectives (often capitalized at sentence start)
+  "good", "bad", "great", "small", "large", "big", "little", "old", "young",
+  "new", "first", "last", "long", "short", "high", "low", "right", "wrong",
+  "next", "early", "late", "hard", "easy", "clear", "full", "empty", "ready",
+  "sure", "open", "closed", "free", "busy", "hot", "cold", "warm", "cool",
+  "fast", "slow", "strong", "weak", "deep", "wide", "near", "far", "dark",
+  "light", "heavy", "simple", "complex", "real", "true", "false", "best",
+  "worst", "happy", "sad", "angry", "afraid", "sorry", "glad", "nice",
+  "fine", "okay", "different", "similar", "same", "special", "important",
+  "interesting", "beautiful", "wonderful", "terrible", "amazing", "awesome",
+  // Common nouns (sentence starters)
+  "people", "time", "year", "years", "way", "day", "days", "man", "woman",
+  "child", "children", "world", "life", "hand", "part", "place", "case",
+  "week", "weeks", "company", "system", "program", "question", "work",
+  "government", "number", "point", "home", "water", "room", "mother",
+  "area", "money", "story", "fact", "month", "months", "lot", "right",
+  "study", "book", "books", "eye", "eyes", "job", "word", "words",
+  "business", "issue", "issues", "side", "kind", "head", "house", "service",
+  "friend", "friends", "power", "hour", "hours", "game", "line", "end",
+  "member", "members", "law", "car", "city", "community", "name", "names",
+  "team", "minute", "minutes", "idea", "ideas", "body", "information",
+  "back", "parent", "parents", "face", "others", "level", "office", "door",
+  "health", "person", "art", "war", "history", "party", "result", "change",
+  "reason", "research", "girl", "guy", "moment", "air", "teacher", "force",
 ]);
 
 // Common titles that precede names

package/src/index.ts

@@ -60,7 +60,7 @@ async function initialize(): Promise<void> {
 const server = new Server(
   {
     name: "engram",
-    version: "0.3.1",
+    version: "0.4.0",
   },
   {
     capabilities: {
@@ -159,153 +159,6 @@ const TOOLS = [
       openWorldHint: false,
     },
   },
-  {
-    name: "create_entity",
-    description: "ADVANCED: Manually create an entity. Rarely needed - remember auto-extracts entities. Only use when: (1) creating an entity that won't appear in any memory content, or (2) correcting entity type after auto-extraction.",
-    inputSchema: {
-      type: "object" as const,
-      properties: {
-        name: {
-          type: "string",
-          description: "Entity name (e.g., 'John Smith', 'Paris', 'Machine Learning')",
-        },
-        type: {
-          type: "string",
-          enum: ["person", "place", "concept", "event", "organization"],
-          description: "Type of entity",
-        },
-      },
-      required: ["name", "type"],
-    },
-    annotations: {
-      title: "Create Entity",
-      readOnlyHint: false,
-      destructiveHint: false,
-      idempotentHint: true,
-      openWorldHint: false,
-    },
-  },
-  {
-    name: "observe",
-    description: "ADVANCED: Add a fact to an EXISTING entity without creating a memory. Rarely needed - use remember instead, which stores the content AND links it to entities. Only use observe for adding metadata or corrections to entities.",
-    inputSchema: {
-      type: "object" as const,
-      properties: {
-        entity: {
-          type: "string",
-          description: "Entity name to add observation to (must already exist)",
-        },
-        observation: {
-          type: "string",
-          description: "The fact or observation to record",
-        },
-        confidence: {
-          type: "number",
-          description: "Confidence in this observation (0-1)",
-          default: 1.0,
-        },
-      },
-      required: ["entity", "observation"],
-    },
-    annotations: {
-      title: "Add Observation",
-      readOnlyHint: false,
-      destructiveHint: false,
-      idempotentHint: false,
-      openWorldHint: false,
-    },
-  },
-  {
-    name: "relate",
-    description: "ADVANCED: Manually create a relationship between two entities. Rarely needed - remember auto-extracts relationships from text. Only use when: (1) the relationship wasn't captured by auto-extraction, or (2) you need to add a relationship not mentioned in any memory.",
-    inputSchema: {
-      type: "object" as const,
-      properties: {
-        from: {
-          type: "string",
-          description: "Source entity name",
-        },
-        to: {
-          type: "string",
-          description: "Target entity name",
-        },
-        relation: {
-          type: "string",
-          description: "Type of relationship (e.g., 'sibling', 'works_at', 'knows', 'located_in')",
-        },
-      },
-      required: ["from", "to", "relation"],
-    },
-    annotations: {
-      title: "Create Relationship",
-      readOnlyHint: false,
-      destructiveHint: false,
-      idempotentHint: true,
-      openWorldHint: false,
-    },
-  },
-  {
-    name: "query_entity",
-    description: "Get all stored information about a specific person, place, or organization. Use after recall to get deeper details about an entity mentioned in search results.",
-    inputSchema: {
-      type: "object" as const,
-      properties: {
-        entity: {
-          type: "string",
-          description: "Entity name to query",
-        },
-      },
-      required: ["entity"],
-    },
-    annotations: {
-      title: "Query Entity",
-      readOnlyHint: true,
-      destructiveHint: false,
-      idempotentHint: true,
-      openWorldHint: false,
-    },
-  },
-  {
-    name: "list_entities",
-    description: "List all known entities (people, places, organizations, etc.). Use to browse the knowledge graph or find entity names for query_entity.",
-    inputSchema: {
-      type: "object" as const,
-      properties: {
-        type: {
-          type: "string",
-          enum: ["person", "place", "concept", "event", "organization"],
-          description: "Filter by entity type (optional)",
-        },
-        limit: {
-          type: "number",
-          description: "Maximum number of entities to return",
-          default: 50,
-        },
-      },
-    },
-    annotations: {
-      title: "List Entities",
-      readOnlyHint: true,
-      destructiveHint: false,
-      idempotentHint: true,
-      openWorldHint: false,
-    },
-  },
-  {
-    name: "stats",
-    description: "Get memory statistics (counts of memories, entities, relations, observations)",
-    inputSchema: {
-      type: "object" as const,
-      properties: {},
-    },
-    annotations: {
-      title: "Get Statistics",
-      readOnlyHint: true,
-      destructiveHint: false,
-      idempotentHint: true,
-      openWorldHint: false,
-    },
-  },
   {
     name: "engram_web",
     description: "Launch the Engram web interface for browsing, searching, and editing memories visually. Returns a URL to open in your browser.",
@@ -440,177 +293,6 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
         };
       }
 
-      case "create_entity": {
-        const { name: entityName, type } = args as {
-          name: string;
-          type: "person" | "place" | "concept" | "event" | "organization";
-        };
-
-        const entity = graph.getOrCreateEntity(entityName, type);
-
-        return {
-          content: [
-            {
-              type: "text" as const,
-              text: JSON.stringify({
-                success: true,
-                entity: {
-                  id: entity.id,
-                  name: entity.name,
-                  type: entity.type,
-                },
-              }, null, 2),
-            },
-          ],
-        };
-      }
-
-      case "observe": {
-        const { entity: entityName, observation, confidence = 1.0 } = args as {
-          entity: string;
-          observation: string;
-          confidence?: number;
-        };
-
-        // Ensure entity exists
-        const entity = graph.getOrCreateEntity(entityName, "person");
-
-        // Add observation
-        const obs = graph.addObservation(entity.id, observation, undefined, confidence);
-
-        return {
-          content: [
-            {
-              type: "text" as const,
-              text: JSON.stringify({
-                success: true,
-                entity: entity.name,
-                observation_id: obs.id,
-              }, null, 2),
-            },
-          ],
-        };
-      }
-
-      case "relate": {
-        const { from, to, relation } = args as {
-          from: string;
-          to: string;
-          relation: string;
-        };
-
-        // Ensure both entities exist
-        const fromEntity = graph.getOrCreateEntity(from, "person");
-        const toEntity = graph.getOrCreateEntity(to, "person");
-
-        // Create relation
-        const rel = graph.relate(fromEntity.id, toEntity.id, relation);
-
-        return {
-          content: [
-            {
-              type: "text" as const,
-              text: JSON.stringify({
-                success: true,
-                relation: {
-                  id: rel.id,
-                  from: fromEntity.name,
-                  to: toEntity.name,
-                  type: rel.type,
-                },
-              }, null, 2),
-            },
-          ],
-        };
-      }
-
-      case "query_entity": {
-        const { entity: entityName } = args as { entity: string };
-
-        const details = graph.getEntityDetails(entityName);
-
-        if (!details) {
-          return {
-            content: [
-              {
-                type: "text" as const,
-                text: JSON.stringify({ success: false, error: "Entity not found" }),
-              },
-            ],
-          };
-        }
-
-        return {
-          content: [
-            {
-              type: "text" as const,
-              text: JSON.stringify({
-                entity: {
-                  id: details.id,
-                  name: details.name,
-                  type: details.type,
-                  created_at: details.created_at.toISOString(),
-                },
-                observations: details.observations.map((o) => ({
-                  content: o.content.substring(0, 200) + (o.content.length > 200 ? "..." : ""),
-                  confidence: o.confidence,
-                  valid_from: o.valid_from.toISOString(),
-                })),
-                relations_from: details.relationsFrom.map((r) => ({
-                  type: r.type,
-                  to: r.targetEntity.name,
-                })),
-                relations_to: details.relationsTo.map((r) => ({
-                  type: r.type,
-                  from: r.sourceEntity.name,
-                })),
-              }, null, 2),
-            },
-          ],
-        };
-      }
-
-      case "list_entities": {
-        const { type, limit = 50 } = args as {
-          type?: "person" | "place" | "concept" | "event" | "organization";
-          limit?: number;
-        };
-
-        const entities = graph.listEntities(type, limit);
-
-        return {
-          content: [
-            {
-              type: "text" as const,
-              text: JSON.stringify({
-                entities: entities.map((e) => ({
-                  id: e.id,
-                  name: e.name,
-                  type: e.type,
-                })),
-                count: entities.length,
-              }, null, 2),
-            },
-          ],
-        };
-      }
-
-      case "stats": {
-        const stats = db.getStats();
-
-        return {
-          content: [
-            {
-              type: "text" as const,
-              text: JSON.stringify({
-                ...stats,
-                database_path: DB_FILE,
-              }, null, 2),
-            },
-          ],
-        };
-      }
-
       case "engram_web": {
         const { port = 3847 } = args as { port?: number };
 

package/src/storage/database.ts

@@ -358,6 +358,41 @@ export class EngramDatabase {
     return shared / total * 0.7;
   }
 
+  /**
+   * Merge two entities: transfers all observations and relations from source to target, then deletes source
+   */
+  mergeEntities(targetId: string, sourceId: string): { observationsMoved: number; relationsMoved: number } {
+    // Move observations from source to target
+    const obsResult = this.db.prepare(
+      "UPDATE observations SET entity_id = ? WHERE entity_id = ?"
+    ).run(targetId, sourceId);
+
+    // Move relations where source is from_entity
+    const relFromResult = this.db.prepare(
+      "UPDATE relations SET from_entity = ? WHERE from_entity = ?"
+    ).run(targetId, sourceId);
+
+    // Move relations where source is to_entity
+    const relToResult = this.db.prepare(
+      "UPDATE relations SET to_entity = ? WHERE to_entity = ?"
+    ).run(targetId, sourceId);
+
+    // Delete duplicate relations (same from, to, type)
+    this.db.prepare(`
+      DELETE FROM relations WHERE id NOT IN (
+        SELECT MIN(id) FROM relations GROUP BY from_entity, to_entity, type
+      )
+    `).run();
+
+    // Delete the source entity
+    this.deleteEntity(sourceId);
+
+    return {
+      observationsMoved: obsResult.changes,
+      relationsMoved: relFromResult.changes + relToResult.changes,
+    };
+  }
+
   /**
    * Find all potential duplicate entities
    */

package/src/web/server.ts

@@ -226,6 +226,47 @@ export class EngramWebServer {
       return;
     }
 
+    // GET /api/tidy - analyze duplicates
+    if (pathname === "/api/tidy" && method === "GET") {
+      const duplicates = this.db.findDuplicateEntities();
+      res.end(JSON.stringify({
+        duplicate_groups: duplicates.map((d) => ({
+          keep: { id: d.entity.id, name: d.entity.name, type: d.entity.type },
+          merge: d.potentialDuplicates.map((p) => ({
+            id: p.id,
+            name: p.name,
+            type: p.type,
+          })),
+        })),
+        total_duplicates: duplicates.reduce((sum, d) => sum + d.potentialDuplicates.length, 0),
+      }));
+      return;
+    }
+
+    // POST /api/tidy - merge duplicates
+    if (pathname === "/api/tidy" && method === "POST") {
+      const duplicates = this.db.findDuplicateEntities();
+      let totalMerged = 0;
+      let observationsMoved = 0;
+      let relationsMoved = 0;
+
+      for (const group of duplicates) {
+        for (const dupe of group.potentialDuplicates) {
+          const result = this.db.mergeEntities(group.entity.id, dupe.id);
+          totalMerged++;
+          observationsMoved += result.observationsMoved;
+          relationsMoved += result.relationsMoved;
+        }
+      }
+
+      res.end(JSON.stringify({
+        entities_merged: totalMerged,
+        observations_moved: observationsMoved,
+        relations_moved: relationsMoved,
+      }));
+      return;
+    }
+
     // 404 for unknown API routes
     res.writeHead(404);
     res.end(JSON.stringify({ error: "Not found" }));