@199-bio/engram 0.3.2 → 0.4.1

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/graph/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/graph/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/graph/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC"}

package/dist/graph/knowledge-graph.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"knowledge-graph.d.ts","sourceRoot":"","sources":["../../src/graph/knowledge-graph.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,cAAc,EACd,MAAM,EACN,WAAW,EACX,QAAQ,EACT,MAAM,wBAAwB,CAAC;AAGhC,MAAM,WAAW,iBAAkB,SAAQ,MAAM;IAC/C,YAAY,EAAE,WAAW,EAAE,CAAC;IAC5B,aAAa,EAAE,KAAK,CAAC,QAAQ,GAAG;QAAE,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC1D,WAAW,EAAE,KAAK,CAAC,QAAQ,GAAG;QAAE,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACzD;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,YAAY,EAAE,WAAW,EAAE,CAAC;CAC7B;AAED,qBAAa,cAAc;IACb,OAAO,CAAC,EAAE;gBAAF,EAAE,EAAE,cAAc;IAItC;;OAEG;IACH,iBAAiB,CACf,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE,MAAM,CAAC,MAAM,CAAY,GAC9B,MAAM;IAMT;;OAEG;IACH,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI;IAoC5D;;OAEG;IACH,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,GAAG,MAAM,EAAE;IAI5D;;OAEG;IACH,YAAY,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,KAAK,GAAE,MAAY,GAAG,MAAM,EAAE;IAMlE;;OAEG;IACH,cAAc,CACZ,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,MAAM,EACf,cAAc,CAAC,EAAE,MAAM,EACvB,UAAU,GAAE,MAAY,GACvB,WAAW;IAWd;;OAEG;IACH,eAAe,CAAC,cAAc,EAAE,MAAM,GAAG,WAAW,EAAE;IAWtD;;OAEG;IACH,MAAM,CACJ,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EACZ,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACnC,QAAQ;IAgBX;;OAEG;IACH,YAAY,CACV,cAAc,EAAE,MAAM,EACtB,SAAS,GAAE,MAAM,GAAG,IAAI,GAAG,MAAe,GACzC,QAAQ,EAAE;IAWb;;OAEG;IACH,QAAQ,CACN,cAAc,EAAE,MAAM,EACtB,KAAK,GAAE,MAAU,EACjB,aAAa,CAAC,EAAE,MAAM,EAAE,GACvB,cAAc,GAAG,IAAI;IAgBxB;;OAEG;IACH,eAAe,CACb,IAAI,EAAE,MAAM,EACZ,cAAc,CAAC,EAAE,MAAM,GACtB;QAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;QAAC,YAAY,EAAE,WAAW,EAAE,CAAA;KAAE;IAyCtD;;OAEG;IACH,oBAAoB,CAClB,cAAc,EAAE,MAAM,EACtB,KAAK,GAAE,MAAU,GAChB,MAAM,EAAE;CAcZ"}
+{"version":3,"file":"knowledge-graph.d.ts","sourceRoot":"","sources":["../../src/graph/knowledge-graph.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,cAAc,EACd,MAAM,EACN,WAAW,EACX,QAAQ,EACT,MAAM,wBAAwB,CAAC;AAEhC,MAAM,WAAW,iBAAkB,SAAQ,MAAM;IAC/C,YAAY,EAAE,WAAW,EAAE,CAAC;IAC5B,aAAa,EAAE,KAAK,CAAC,QAAQ,GAAG;QAAE,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC1D,WAAW,EAAE,KAAK,CAAC,QAAQ,GAAG;QAAE,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACzD;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,YAAY,EAAE,WAAW,EAAE,CAAC;CAC7B;AAED,qBAAa,cAAc;IACb,OAAO,CAAC,EAAE;gBAAF,EAAE,EAAE,cAAc;IAItC;;OAEG;IACH,iBAAiB,CACf,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE,MAAM,CAAC,MAAM,CAAY,GAC9B,MAAM;IAMT;;OAEG;IACH,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI;IAoC5D;;OAEG;IACH,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,GAAG,MAAM,EAAE;IAI5D;;OAEG;IACH,YAAY,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,KAAK,GAAE,MAAY,GAAG,MAAM,EAAE;IAMlE;;OAEG;IACH,cAAc,CACZ,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,MAAM,EACf,cAAc,CAAC,EAAE,MAAM,EACvB,UAAU,GAAE,MAAY,GACvB,WAAW;IAWd;;OAEG;IACH,eAAe,CAAC,cAAc,EAAE,MAAM,GAAG,WAAW,EAAE;IAWtD;;OAEG;IACH,MAAM,CACJ,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EACZ,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACnC,QAAQ;IAgBX;;OAEG;IACH,YAAY,CACV,cAAc,EAAE,MAAM,EACtB,SAAS,GAAE,MAAM,GAAG,IAAI,GAAG,MAAe,GACzC,QAAQ,EAAE;IAWb;;OAEG;IACH,QAAQ,CACN,cAAc,EAAE,MAAM,EACtB,KAAK,GAAE,MAAU,EACjB,aAAa,CAAC,EAAE,MAAM,EAAE,GACvB,cAAc,GAAG,IAAI;IAcxB;;OAEG;IACH,oBAAoB,CAClB,cAAc,EAAE,MAAM,EACtB,KAAK,GAAE,MAAU,GAChB,MAAM,EAAE;CAcZ"}

package/dist/index.js

@@ -42,7 +42,7 @@ async function initialize() {
 // ============ MCP Server ============
 const server = new Server({
     name: "engram",
-    version: "0.3.2",
+    version: "0.4.1",
 }, {
     capabilities: {
         tools: {},
@@ -53,26 +53,46 @@ const server = new Server({
 const TOOLS = [
     {
         name: "remember",
-        description: "PRIMARY STORAGE TOOL. Use this for ALL new information - conversations, facts, observations, notes. Automatically extracts people, organizations, and places as entities and creates relationships. Do NOT also call create_entity/observe/relate - remember handles entity extraction automatically. Only use remember once per piece of information.",
+        description: "Store information with entities and relationships. Extract key people, organizations, and places from the content and pass them as entities. Include relationships between entities when mentioned (e.g., 'works_at', 'lives_in', 'knows').",
         inputSchema: {
             type: "object",
             properties: {
                 content: {
                     type: "string",
-                    description: "The information to store - can be a conversation snippet, fact, observation, or note",
-                },
-                source: {
-                    type: "string",
-                    description: "Source of the memory (e.g., 'conversation', 'note', 'import')",
-                    default: "conversation",
+                    description: "The information to store",
                 },
                 importance: {
                     type: "number",
-                    description: "Importance score from 0 to 1 (higher = more important). Use 0.7+ for key facts, 0.3- for casual mentions",
+                    description: "0-1 score. Use 0.8+ for key facts (names, preferences, important events), 0.5 for general info, 0.3- for trivial mentions",
                     minimum: 0,
                     maximum: 1,
                     default: 0.5,
                 },
+                entities: {
+                    type: "array",
+                    description: "Key entities mentioned (people, organizations, places). Only include clear, specific named entities.",
+                    items: {
+                        type: "object",
+                        properties: {
+                            name: { type: "string", description: "Entity name (e.g., 'Boris Djordjevic', 'Google', 'Paris')" },
+                            type: { type: "string", enum: ["person", "organization", "place"], description: "Entity type" },
+                        },
+                        required: ["name", "type"],
+                    },
+                },
+                relationships: {
+                    type: "array",
+                    description: "Relationships between entities mentioned in the content",
+                    items: {
+                        type: "object",
+                        properties: {
+                            from: { type: "string", description: "Source entity name" },
+                            to: { type: "string", description: "Target entity name" },
+                            type: { type: "string", description: "Relationship type (e.g., 'works_at', 'lives_in', 'sibling_of', 'knows')" },
+                        },
+                        required: ["from", "to", "type"],
+                    },
+                },
             },
             required: ["content"],
         },
@@ -136,68 +156,6 @@ const TOOLS = [
             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.",
@@ -230,13 +188,33 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
     try {
         switch (name) {
             case "remember": {
-                const { content, source = "conversation", importance = 0.5 } = args;
+                const { content, source = "conversation", importance = 0.5, entities: providedEntities = [], relationships: providedRelationships = [], } = args;
                 // Create memory
                 const memory = db.createMemory(content, source, importance);
                 // Index for semantic search
                 await search.indexMemory(memory);
-                // Extract and store entities/relationships
-                const { entities, observations } = graph.extractAndStore(content, memory.id);
+                // Store Claude-provided entities and link to memory
+                const storedEntities = [];
+                for (const ent of providedEntities) {
+                    const entity = graph.getOrCreateEntity(ent.name, ent.type);
+                    storedEntities.push(entity.name);
+                    // Create observation linking entity to this memory
+                    db.addObservation(entity.id, content, memory.id, 1.0);
+                }
+                // Store Claude-provided relationships
+                const storedRelations = [];
+                for (const rel of providedRelationships) {
+                    try {
+                        // Ensure both entities exist (create if not provided explicitly)
+                        const fromEntity = graph.getOrCreateEntity(rel.from, "person");
+                        const toEntity = graph.getOrCreateEntity(rel.to, "person");
+                        graph.relate(fromEntity.name, toEntity.name, rel.type);
+                        storedRelations.push(`${rel.from} -[${rel.type}]-> ${rel.to}`);
+                    }
+                    catch {
+                        // Skip invalid relationships
+                    }
+                }
                 return {
                     content: [
                         {
@@ -244,8 +222,8 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                             text: JSON.stringify({
                                 success: true,
                                 memory_id: memory.id,
-                                entities_extracted: entities.map((e) => e.name),
-                                observations_created: observations.length,
+                                entities_stored: storedEntities,
+                                relationships_stored: storedRelations,
                             }, null, 2),
                         },
                     ],
@@ -307,81 +285,6 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                     ],
                 };
             }
-            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/retrieval/hybrid.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hybrid.d.ts","sourceRoot":"","sources":["../../src/retrieval/hybrid.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAA0B,MAAM,cAAc,CAAC;AAGzF,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE;QACP,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;CACH;AAED,qBAAa,YAAY;IAErB,OAAO,CAAC,EAAE;IACV,OAAO,CAAC,KAAK;IACb,OAAO,CAAC,SAAS;gBAFT,EAAE,EAAE,cAAc,EAClB,KAAK,EAAE,cAAc,EACrB,SAAS,EAAE,gBAAgB,GAAG,eAAe;IAGvD;;;;;OAKG;IACG,MAAM,CACV,KAAK,EAAE,MAAM,EACb,OAAO,GAAE;QACP,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,YAAY,CAAC,EAAE,OAAO,CAAC;KACnB,GACL,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAqHhC;;OAEG;YACW,UAAU;IASxB;;OAEG;YACW,cAAc;IAS5B;;OAEG;YACW,WAAW;IAezB;;OAEG;IACG,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOhD;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAYhD;;OAEG;IACG,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAGvD"}
+{"version":3,"file":"hybrid.d.ts","sourceRoot":"","sources":["../../src/retrieval/hybrid.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAA0B,MAAM,cAAc,CAAC;AAEzF,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE;QACP,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;CACH;AAED,qBAAa,YAAY;IAErB,OAAO,CAAC,EAAE;IACV,OAAO,CAAC,KAAK;IACb,OAAO,CAAC,SAAS;gBAFT,EAAE,EAAE,cAAc,EAClB,KAAK,EAAE,cAAc,EACrB,SAAS,EAAE,gBAAgB,GAAG,eAAe;IAGvD;;;;;OAKG;IACG,MAAM,CACV,KAAK,EAAE,MAAM,EACb,OAAO,GAAE;QACP,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,YAAY,CAAC,EAAE,OAAO,CAAC;KACnB,GACL,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAqHhC;;OAEG;YACW,UAAU;IASxB;;OAEG;YACW,cAAc;IAS5B;;OAEG;YACW,WAAW;IAmBzB;;OAEG;IACG,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOhD;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAYhD;;OAEG;IACG,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAGvD"}

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":"AAAA;;;GAGG;AAOH,MAAM,WAAW,MAAM;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,IAAI,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,IAAI,GAAG,IAAI,CAAC;CAC5B;AAED,MAAM,WAAW,MAAM;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,QAAQ,GAAG,OAAO,GAAG,SAAS,GAAG,OAAO,GAAG,cAAc,CAAC;IAChE,UAAU,EAAE,IAAI,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CAC1C;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,IAAI,CAAC;IACjB,WAAW,EAAE,IAAI,GAAG,IAAI,CAAC;CAC1B;AAED,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC3C,UAAU,EAAE,IAAI,CAAC;CAClB;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,EAAE,CAAoB;IAC9B,OAAO,CAAC,SAAS,CAA8C;gBAEnD,MAAM,EAAE,MAAM;IAoB1B,OAAO,CAAC,UAAU;IAyFlB,YAAY,CACV,OAAO,EAAE,MAAM,EACf,MAAM,GAAE,MAAuB,EAC/B,UAAU,GAAE,MAAY,GACvB,MAAM;IAUT,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAKpC,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,SAAS,GAAG,YAAY,CAAC,CAAC,GAAG,MAAM,GAAG,IAAI;IAqBjG,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAMjC,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAI7B,cAAc,CAAC,KAAK,GAAE,MAAa,GAAG,MAAM,EAAE;IAO9C,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,GAAE,MAAW,GAAG,KAAK,CAAC,MAAM,GAAG;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAkBhF,OAAO,CAAC,eAAe;IAavB,YAAY,CACV,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,EACpB,QAAQ,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAW,GAC9C,MAAM;IAUT,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAKpC,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAU7C;;;OAGG;IACH,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,GAAE,MAAY,GAAG,MAAM,GAAG,IAAI;IA+BvE;;;OAGG;IACH,OAAO,CAAC,uBAAuB;IA4C/B;;OAEG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG;QAAE,iBAAiB,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,MAAM,CAAA;KAAE;IAgCxG;;OAEG;IACH,qBAAqB,IAAI,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,mBAAmB,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAoCjF,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,GAAG,MAAM,EAAE;IAgB9D,YAAY,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,KAAK,GAAE,MAAY,GAAG,MAAM,EAAE;IAiBlE,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAQjC,cAAc,CACZ,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,cAAc,GAAE,MAAM,GAAG,IAAW,EACpC,UAAU,GAAE,MAAY,GACvB,WAAW;IAUd,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI;IAK9C,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,cAAc,GAAE,OAAe,GAAG,WAAW,EAAE;IAYvF,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAOnC,cAAc,CACZ,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EACZ,UAAU,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAW,GAChD,QAAQ;IAUX,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI;IAKxC,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,GAAE,MAAM,GAAG,IAAI,GAAG,MAAe,GAAG,QAAQ,EAAE;IAiB5F,YAAY,CAAC,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI;IActF,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAQnC,QAAQ,CACN,aAAa,EAAE,MAAM,EACrB,KAAK,GAAE,MAAU,EACjB,aAAa,CAAC,EAAE,MAAM,EAAE,GACvB;QAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;QAAC,SAAS,EAAE,QAAQ,EAAE,CAAC;QAAC,YAAY,EAAE,WAAW,EAAE,CAAA;KAAE;IA2C7E,QAAQ,IAAI;QACV,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,YAAY,EAAE,MAAM,CAAC;KACtB;IAeD,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,OAAO,CAAC,IAAI;IASZ,OAAO,CAAC,WAAW;IAYnB,OAAO,CAAC,WAAW;IAUnB,OAAO,CAAC,gBAAgB;IAYxB,OAAO,CAAC,aAAa;CAUtB"}

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;YAwKT,WAAW;IAgCzB,OAAO,CAAC,SAAS;CAclB"}

package/package.json

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

package/src/graph/index.ts

@@ -1,2 +1 @@
-export * from "./extractor.js";
 export * from "./knowledge-graph.js";

package/src/graph/knowledge-graph.ts

@@ -9,7 +9,6 @@ import {
   Observation,
   Relation,
 } from "../storage/database.js";
-import { entityExtractor, ExtractedEntity } from "./extractor.js";
 
 export interface EntityWithDetails extends Entity {
   observations: Observation[];
@@ -191,55 +190,6 @@ export class KnowledgeGraph {
     };
   }
 
-  // ============ Auto-extraction ============
-
-  /**
-   * Extract entities from text and add them to the graph
-   */
-  extractAndStore(
-    text: string,
-    sourceMemoryId?: string
-  ): { entities: Entity[]; observations: Observation[] } {
-    const extracted = entityExtractor.extractAll(text);
-    const entities: Entity[] = [];
-    const observations: Observation[] = [];
-
-    for (const ext of extracted) {
-      // Only store high-confidence extractions
-      if (ext.confidence < 0.5) continue;
-
-      // Get or create entity
-      const entity = this.getOrCreateEntity(ext.name, ext.type);
-      entities.push(entity);
-
-      // Create observation linking this entity to the memory content
-      const obs = this.db.addObservation(
-        entity.id,
-        text,
-        sourceMemoryId || null,
-        ext.confidence
-      );
-      observations.push(obs);
-    }
-
-    // Extract and create relationships
-    const relationships = entityExtractor.extractRelationships(text);
-    for (const rel of relationships) {
-      try {
-        // Ensure both entities exist
-        const fromEntity = this.getOrCreateEntity(rel.subject, "person");
-        const toEntity = this.getOrCreateEntity(rel.object, "person");
-
-        // Create the relation
-        this.db.createRelation(fromEntity.id, toEntity.id, rel.relation);
-      } catch {
-        // Silently ignore relation creation failures
-      }
-    }
-
-    return { entities, observations };
-  }
-
   /**
    * Find memories related to an entity by traversing the graph
    */

package/src/index.ts

@@ -60,7 +60,7 @@ async function initialize(): Promise<void> {
 const server = new Server(
   {
     name: "engram",
-    version: "0.3.2",
+    version: "0.4.1",
   },
   {
     capabilities: {
@@ -75,26 +75,46 @@ const TOOLS = [
   {
     name: "remember",
     description:
-      "PRIMARY STORAGE TOOL. Use this for ALL new information - conversations, facts, observations, notes. Automatically extracts people, organizations, and places as entities and creates relationships. Do NOT also call create_entity/observe/relate - remember handles entity extraction automatically. Only use remember once per piece of information.",
+      "Store information with entities and relationships. Extract key people, organizations, and places from the content and pass them as entities. Include relationships between entities when mentioned (e.g., 'works_at', 'lives_in', 'knows').",
     inputSchema: {
       type: "object" as const,
       properties: {
         content: {
           type: "string",
-          description: "The information to store - can be a conversation snippet, fact, observation, or note",
-        },
-        source: {
-          type: "string",
-          description: "Source of the memory (e.g., 'conversation', 'note', 'import')",
-          default: "conversation",
+          description: "The information to store",
         },
         importance: {
           type: "number",
-          description: "Importance score from 0 to 1 (higher = more important). Use 0.7+ for key facts, 0.3- for casual mentions",
+          description: "0-1 score. Use 0.8+ for key facts (names, preferences, important events), 0.5 for general info, 0.3- for trivial mentions",
           minimum: 0,
           maximum: 1,
           default: 0.5,
         },
+        entities: {
+          type: "array",
+          description: "Key entities mentioned (people, organizations, places). Only include clear, specific named entities.",
+          items: {
+            type: "object",
+            properties: {
+              name: { type: "string", description: "Entity name (e.g., 'Boris Djordjevic', 'Google', 'Paris')" },
+              type: { type: "string", enum: ["person", "organization", "place"], description: "Entity type" },
+            },
+            required: ["name", "type"],
+          },
+        },
+        relationships: {
+          type: "array",
+          description: "Relationships between entities mentioned in the content",
+          items: {
+            type: "object",
+            properties: {
+              from: { type: "string", description: "Source entity name" },
+              to: { type: "string", description: "Target entity name" },
+              type: { type: "string", description: "Relationship type (e.g., 'works_at', 'lives_in', 'sibling_of', 'knows')" },
+            },
+            required: ["from", "to", "type"],
+          },
+        },
       },
       required: ["content"],
     },
@@ -159,68 +179,6 @@ const TOOLS = [
       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.",
@@ -256,10 +214,18 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
   try {
     switch (name) {
       case "remember": {
-        const { content, source = "conversation", importance = 0.5 } = args as {
+        const {
+          content,
+          source = "conversation",
+          importance = 0.5,
+          entities: providedEntities = [],
+          relationships: providedRelationships = [],
+        } = args as {
           content: string;
           source?: string;
           importance?: number;
+          entities?: Array<{ name: string; type: "person" | "organization" | "place" }>;
+          relationships?: Array<{ from: string; to: string; type: string }>;
         };
 
         // Create memory
@@ -268,8 +234,28 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
         // Index for semantic search
         await search.indexMemory(memory);
 
-        // Extract and store entities/relationships
-        const { entities, observations } = graph.extractAndStore(content, memory.id);
+        // Store Claude-provided entities and link to memory
+        const storedEntities: string[] = [];
+        for (const ent of providedEntities) {
+          const entity = graph.getOrCreateEntity(ent.name, ent.type);
+          storedEntities.push(entity.name);
+          // Create observation linking entity to this memory
+          db.addObservation(entity.id, content, memory.id, 1.0);
+        }
+
+        // Store Claude-provided relationships
+        const storedRelations: string[] = [];
+        for (const rel of providedRelationships) {
+          try {
+            // Ensure both entities exist (create if not provided explicitly)
+            const fromEntity = graph.getOrCreateEntity(rel.from, "person");
+            const toEntity = graph.getOrCreateEntity(rel.to, "person");
+            graph.relate(fromEntity.name, toEntity.name, rel.type);
+            storedRelations.push(`${rel.from} -[${rel.type}]-> ${rel.to}`);
+          } catch {
+            // Skip invalid relationships
+          }
+        }
 
         return {
           content: [
@@ -278,8 +264,8 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
               text: JSON.stringify({
                 success: true,
                 memory_id: memory.id,
-                entities_extracted: entities.map((e) => e.name),
-                observations_created: observations.length,
+                entities_stored: storedEntities,
+                relationships_stored: storedRelations,
               }, null, 2),
             },
           ],
@@ -355,93 +341,6 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
         };
       }
 
-      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/retrieval/hybrid.ts

@@ -6,7 +6,6 @@
 import { EngramDatabase, Memory } from "../storage/database.js";
 import { KnowledgeGraph } from "../graph/knowledge-graph.js";
 import { ColBERTRetriever, SimpleRetriever, SearchResult, Document } from "./colbert.js";
-import { entityExtractor } from "../graph/extractor.js";
 
 export interface HybridSearchResult {
   memory: Memory;
@@ -183,15 +182,19 @@ export class HybridSearch {
   }
 
   /**
-   * Graph-based search: find entities in query, traverse graph
+   * Graph-based search: find known entities in query, traverse graph
    */
   private async searchGraph(query: string): Promise<string[]> {
-    // Extract entities from query
-    const entities = entityExtractor.extractAll(query);
+    // Find known entities whose names appear in the query
+    const queryLower = query.toLowerCase();
+    const allEntities = this.graph.listEntities(undefined, 500);
+    const matchedEntities = allEntities.filter(e =>
+      queryLower.includes(e.name.toLowerCase())
+    );
 
     const memoryIds = new Set<string>();
 
-    for (const entity of entities) {
+    for (const entity of matchedEntities) {
       // Find related memory IDs through graph traversal
       const relatedIds = this.graph.findRelatedMemoryIds(entity.name, 2);
       relatedIds.forEach(id => memoryIds.add(id));

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

@@ -147,9 +147,8 @@ export class EngramWebServer {
       const { content, source, importance } = body as any;
       const memory = this.db.createMemory(content, source || "web", importance || 0.5);
       await this.search.indexMemory(memory);
-      const { entities, observations } = this.graph.extractAndStore(content, memory.id);
       res.writeHead(201);
-      res.end(JSON.stringify({ memory, entities_extracted: entities.length, observations_created: observations.length }));
+      res.end(JSON.stringify({ memory }));
       return;
     }
 
@@ -226,6 +225,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" }));

package/src/graph/extractor.ts

@@ -1,441 +0,0 @@
-/**
- * Entity extraction from text using heuristics
- * No external APIs - pure local processing
- */
-
-export interface ExtractedEntity {
-  name: string;
-  type: "person" | "place" | "concept" | "event" | "organization";
-  confidence: number;
-  span: { start: number; end: number };
-}
-
-// Common words that look like names but aren't
-const STOPWORDS = new Set([
-  "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",
-  "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",
-  "if", "because", "while", "although", "though", "after", "before",
-  "since", "until", "unless", "however", "therefore", "thus", "hence",
-  "monday", "tuesday", "wednesday", "thursday", "friday", "saturday", "sunday",
-  "january", "february", "march", "april", "may", "june", "july",
-  "august", "september", "october", "november", "december",
-  "today", "tomorrow", "yesterday", "morning", "afternoon", "evening", "night",
-  "said", "says", "told", "asked", "replied", "answered", "mentioned",
-  "think", "know", "believe", "feel", "want", "need", "like", "love",
-]);
-
-// Common titles that precede names
-const TITLES = ["mr", "mrs", "ms", "miss", "dr", "prof", "sir", "lady", "lord"];
-
-// Organization suffixes and keywords
-const ORG_SUFFIXES = [
-  "inc", "inc.", "corp", "corp.", "corporation", "llc", "llp", "ltd", "ltd.",
-  "limited", "co", "co.", "company", "companies", "group", "holdings",
-  "partners", "partnership", "associates", "foundation", "institute",
-  "university", "college", "school", "hospital", "clinic", "bank",
-  "capital", "ventures", "labs", "laboratory", "laboratories",
-  "technologies", "tech", "software", "systems", "solutions", "services",
-  "industries", "international", "global", "worldwide", "enterprises",
-];
-
-// Well-known organizations (case-insensitive matching)
-// Note: Avoid short words that could match common English words (e.g., "WHO")
-const KNOWN_ORGANIZATIONS = new Set([
-  "goldman sachs", "morgan stanley", "jp morgan", "jpmorgan", "citibank",
-  "bank of america", "wells fargo", "barclays", "deutsche bank", "hsbc",
-  "credit suisse", "ubs", "blackrock", "blackstone", "kkr", "carlyle",
-  "apollo global", "bridgewater", "citadel", "two sigma", "renaissance technologies",
-  "google", "alphabet", "microsoft", "apple", "amazon", "meta", "facebook",
-  "netflix", "tesla", "nvidia", "intel", "amd", "ibm", "oracle", "salesforce",
-  "adobe", "spotify", "uber", "lyft", "airbnb", "stripe", "square", "paypal",
-  "twitter", "x corp", "linkedin", "snapchat", "tiktok", "bytedance",
-  "openai", "anthropic", "deepmind", "cohere", "stability ai", "midjourney",
-  "199 biotechnologies", "199 bio",
-  "harvard university", "stanford university", "yale university", "princeton university",
-  "columbia university", "oxford university", "cambridge university",
-  "mit", "caltech", "nyu", "ucla", "usc", "berkeley",
-  "fbi", "cia", "nsa", "nasa", "fda", "sec", "fcc", "epa", "doj",
-  "united nations", "world bank", "imf", "nato", "european union",
-  "red cross", "unicef", "greenpeace", "amnesty international",
-  "new york times", "washington post", "wall street journal", "bbc", "cnn",
-  "nbc", "abc news", "cbs news", "fox news", "reuters", "associated press", "bloomberg",
-]);
-
-// Words that look like names but aren't (nationalities, religions, etc.)
-const NOT_PERSON_NAMES = new Set([
-  "russian", "american", "british", "chinese", "japanese", "german", "french",
-  "italian", "spanish", "indian", "brazilian", "mexican", "canadian", "australian",
-  "muslim", "christian", "jewish", "hindu", "buddhist", "atheist", "catholic",
-  "protestant", "orthodox", "sunni", "shia", "sikh", "jain",
-  "asian", "european", "african", "latin", "caucasian", "middle eastern",
-]);
-
-// Common places (US states, major cities, countries)
-const KNOWN_PLACES = new Set([
-  "california", "new york", "texas", "florida", "washington", "massachusetts",
-  "colorado", "illinois", "pennsylvania", "ohio", "georgia", "michigan",
-  "san francisco", "los angeles", "seattle", "boston", "chicago", "miami",
-  "london", "paris", "tokyo", "singapore", "hong kong", "dubai", "berlin",
-  "sydney", "toronto", "vancouver", "amsterdam", "zurich", "geneva",
-  "usa", "uk", "china", "japan", "germany", "france", "india", "canada",
-  "australia", "brazil", "mexico", "russia", "spain", "italy", "switzerland",
-]);
-
-// Relationship words that often precede person mentions
-const RELATION_WORDS = [
-  "brother", "sister", "mother", "father", "mom", "dad", "mum",
-  "son", "daughter", "wife", "husband", "partner", "boyfriend", "girlfriend",
-  "uncle", "aunt", "cousin", "nephew", "niece", "grandmother", "grandfather",
-  "grandma", "grandpa", "friend", "colleague", "boss", "ex", "fiancé", "fiancée",
-];
-
-export class EntityExtractor {
-  /**
-   * Extract all entities from text
-   */
-  extractAll(text: string): ExtractedEntity[] {
-    const entities: ExtractedEntity[] = [];
-
-    // Extract organizations FIRST (higher priority)
-    const orgs = this.extractOrganizations(text);
-    entities.push(...orgs);
-
-    // Track organization names to avoid re-extracting as persons
-    const orgNames = new Set(orgs.map((o) => o.name.toLowerCase()));
-
-    // Extract persons (excluding already-found orgs)
-    const persons = this.extractPersons(text).filter(
-      (p) => !orgNames.has(p.name.toLowerCase())
-    );
-    entities.push(...persons);
-
-    // First: filter out entities with bad prefixes/suffixes
-    const badSuffixes = ["managing", "as", "last", "and", "or", "the", "a", "an", "for", "with"];
-    const badPrefixes = ["he", "she", "they", "my", "his", "her", "the", "a", "an", "joined"];
-
-    const cleanEntities = entities.filter((entity) => {
-      const words = entity.name.toLowerCase().split(/\s+/);
-      const lastWord = words[words.length - 1];
-      const firstWord = words[0];
-      if (badSuffixes.includes(lastWord)) return false;
-      if (badPrefixes.includes(firstWord)) return false;
-      return true;
-    });
-
-    // Deduplicate by name, preferring higher confidence and orgs over persons
-    const seen = new Map<string, ExtractedEntity>();
-    for (const entity of cleanEntities) {
-      const key = entity.name.toLowerCase();
-      const existing = seen.get(key);
-      if (!existing) {
-        seen.set(key, entity);
-      } else if (entity.type === "organization" && existing.type === "person") {
-        // Prefer org over person
-        seen.set(key, entity);
-      } else if (entity.confidence > existing.confidence && entity.type === existing.type) {
-        seen.set(key, entity);
-      }
-    }
-
-    // Remove entities that are proper substrings of other entities with same type
-    const result = Array.from(seen.values());
-    return result.filter((entity) => {
-      const key = entity.name.toLowerCase();
-      for (const other of result) {
-        const otherKey = other.name.toLowerCase();
-        if (otherKey !== key && other.type === entity.type) {
-          // If this entity is a prefix of another (longer) entity, keep the shorter one
-          // unless the longer one has much higher confidence
-          if (otherKey.startsWith(key + " ") && other.confidence > entity.confidence + 0.1) {
-            return false;
-          }
-        }
-      }
-      return true;
-    });
-  }
-
-  /**
-   * Extract organizations from text
-   */
-  extractOrganizations(text: string): ExtractedEntity[] {
-    const results: ExtractedEntity[] = [];
-    const foundNames = new Set<string>();
-
-    // Pattern 1: Check for known organizations
-    for (const orgName of KNOWN_ORGANIZATIONS) {
-      const pattern = new RegExp(`\\b${this.escapeRegex(orgName)}\\b`, "gi");
-      let match;
-      while ((match = pattern.exec(text)) !== null) {
-        const name = match[0];
-        const key = name.toLowerCase();
-        if (!foundNames.has(key)) {
-          foundNames.add(key);
-          results.push({
-            name,
-            type: "organization",
-            confidence: 0.95,
-            span: { start: match.index, end: match.index + name.length },
-          });
-        }
-      }
-    }
-
-    // Pattern 2: Capitalized word(s) followed by org suffixes
-    // Allow single word + suffix (e.g., "Acme Corporation")
-    // Use case-sensitive matching for proper nouns, handle suffix case separately
-    const suffixPatternStr = ORG_SUFFIXES.map(s =>
-      `${s.charAt(0).toUpperCase()}${s.slice(1)}|${s.toLowerCase()}`
-    ).join("|");
-    const suffixPattern = new RegExp(
-      `(?:^|[^A-Za-z])([A-Z][a-z]+(?:\\s+[A-Z][a-z]+)*)\\s+(${suffixPatternStr})(?=\\s|,|\\.|\\)|$)`,
-      "g"
-    );
-    let match;
-    while ((match = suffixPattern.exec(text)) !== null) {
-      const baseName = match[1].trim();
-      const suffix = match[2].trim();
-      const fullName = `${baseName} ${suffix}`;
-      const key = fullName.toLowerCase();
-
-      // Skip common adjective+suffix combos
-      const firstWord = baseName.split(/\s+/)[0].toLowerCase();
-      if (NOT_PERSON_NAMES.has(firstWord)) continue;
-      // Skip single words that are not proper nouns
-      if (STOPWORDS.has(firstWord)) continue;
-
-      if (!foundNames.has(key)) {
-        foundNames.add(key);
-        results.push({
-          name: fullName,
-          type: "organization",
-          confidence: 0.85,
-          span: { start: match.index, end: match.index + fullName.length },
-        });
-      }
-    }
-
-    // Pattern 3: "works at/for X", "joined X" - only extract multi-word org names
-    // Single-word orgs should be in KNOWN_ORGANIZATIONS
-    // Use case-sensitive matching for proper nouns (no 'i' flag)
-    const workPattern = /(?:works?\s+(?:at|for)|joined|employed\s+(?:at|by)|hired\s+by)\s+([A-Z][a-z]+(?:\s+[A-Z][a-z]+){1,2})(?=\s+[a-z]|\s*[,.]|\s*$)/g;
-
-    while ((match = workPattern.exec(text)) !== null) {
-      const name = match[1].trim();
-      const key = name.toLowerCase();
-      const words = name.split(/\s+/);
-
-      // Skip if first word is a stopword or nationality/religion
-      if (STOPWORDS.has(words[0].toLowerCase()) ||
-          NOT_PERSON_NAMES.has(words[0].toLowerCase())) {
-        continue;
-      }
-
-      if (!foundNames.has(key)) {
-        foundNames.add(key);
-        results.push({
-          name,
-          type: "organization",
-          confidence: 0.7,
-          span: { start: match.index, end: match.index + match[0].length },
-        });
-      }
-    }
-
-    return results;
-  }
-
-  /**
-   * Escape special regex characters
-   */
-  private escapeRegex(str: string): string {
-    return str.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-  }
-
-  /**
-   * Extract person names from text using heuristics
-   */
-  extractPersons(text: string): ExtractedEntity[] {
-    const persons: ExtractedEntity[] = [];
-
-    // Pattern 1: Capitalized words (potential names)
-    persons.push(...this.extractCapitalizedNames(text));
-
-    // Pattern 2: Possessive patterns ("X's brother", "my friend X")
-    persons.push(...this.extractFromPossessives(text));
-
-    // Pattern 3: Relation patterns ("her brother", "my mom")
-    persons.push(...this.extractFromRelations(text));
-
-    return persons;
-  }
-
-  /**
-   * Extract capitalized words that look like names
-   */
-  private extractCapitalizedNames(text: string): ExtractedEntity[] {
-    const results: ExtractedEntity[] = [];
-
-    // Match capitalized words not at sentence start
-    // This regex finds sequences of capitalized words
-    const pattern = /(?<=[.!?]\s+|^)([A-Z][a-z]+(?:\s+[A-Z][a-z]+)*)|(?<=[a-z]\s)([A-Z][a-z]+(?:\s+[A-Z][a-z]+)*)/g;
-
-    let match;
-    while ((match = pattern.exec(text)) !== null) {
-      const name = (match[1] || match[2]).trim();
-      const words = name.split(/\s+/);
-
-      // Filter out stopwords, nationality/religion words, places, and single common words
-      const cleanWords = words.filter(
-        (w) => !STOPWORDS.has(w.toLowerCase()) &&
-               !NOT_PERSON_NAMES.has(w.toLowerCase()) &&
-               !KNOWN_PLACES.has(w.toLowerCase()) &&
-               w.length > 1
-      );
-
-      if (cleanWords.length === 0) continue;
-
-      const cleanName = cleanWords.join(" ");
-
-      // Skip if it's just a common word
-      if (cleanWords.length === 1 && cleanWords[0].length < 4) continue;
-
-      // Higher confidence for multi-word names
-      const confidence = cleanWords.length >= 2 ? 0.8 : 0.5;
-
-      results.push({
-        name: cleanName,
-        type: "person",
-        confidence,
-        span: { start: match.index, end: match.index + match[0].length },
-      });
-    }
-
-    return results;
-  }
-
-  /**
-   * Extract names from possessive patterns like "Sarah's brother"
-   */
-  private extractFromPossessives(text: string): ExtractedEntity[] {
-    const results: ExtractedEntity[] = [];
-
-    // Match "Name's something"
-    const pattern = /([A-Z][a-z]+(?:\s+[A-Z][a-z]+)?)'s\s+(\w+)/g;
-
-    let match;
-    while ((match = pattern.exec(text)) !== null) {
-      const name = match[1].trim();
-      const following = match[2].toLowerCase();
-
-      // Higher confidence if followed by a relationship word
-      const isRelation = RELATION_WORDS.includes(following);
-      const confidence = isRelation ? 0.95 : 0.7;
-
-      if (!STOPWORDS.has(name.toLowerCase())) {
-        results.push({
-          name,
-          type: "person",
-          confidence,
-          span: { start: match.index, end: match.index + name.length },
-        });
-      }
-
-      // If followed by relationship word, the whole thing might reference another person
-      // e.g., "Sarah's brother" - we create a derived entity
-      if (isRelation) {
-        results.push({
-          name: `${name}'s ${following}`,
-          type: "person",
-          confidence: 0.6,
-          span: { start: match.index, end: match.index + match[0].length },
-        });
-      }
-    }
-
-    return results;
-  }
-
-  /**
-   * Extract from relationship patterns like "her brother", "my friend John"
-   */
-  private extractFromRelations(text: string): ExtractedEntity[] {
-    const results: ExtractedEntity[] = [];
-
-    // Pattern: possessive + relation word + optional name
-    const pronouns = ["my", "his", "her", "their", "our"];
-    const relationPattern = new RegExp(
-      `(${pronouns.join("|")})\\s+(${RELATION_WORDS.join("|")})(?:\\s+([A-Z][a-z]+))?`,
-      "gi"
-    );
-
-    let match;
-    while ((match = relationPattern.exec(text)) !== null) {
-      const pronoun = match[1];
-      const relation = match[2];
-      const name = match[3];
-
-      if (name && !STOPWORDS.has(name.toLowerCase())) {
-        // Explicit name mentioned
-        results.push({
-          name,
-          type: "person",
-          confidence: 0.9,
-          span: {
-            start: match.index + match[0].length - name.length,
-            end: match.index + match[0].length,
-          },
-        });
-      }
-    }
-
-    return results;
-  }
-
-  /**
-   * Extract relationship mentions (not entities, but useful for graph)
-   */
-  extractRelationships(text: string): Array<{
-    subject: string;
-    relation: string;
-    object: string;
-    confidence: number;
-  }> {
-    const relationships: Array<{
-      subject: string;
-      relation: string;
-      object: string;
-      confidence: number;
-    }> = [];
-
-    // Pattern: "X's [relation]" implies relationship
-    const possessivePattern = /([A-Z][a-z]+(?:\s+[A-Z][a-z]+)?)'s\s+(\w+)/g;
-
-    let match;
-    while ((match = possessivePattern.exec(text)) !== null) {
-      const subject = match[1].trim();
-      const relWord = match[2].toLowerCase();
-
-      if (RELATION_WORDS.includes(relWord)) {
-        relationships.push({
-          subject,
-          relation: relWord,
-          object: `${subject}'s ${relWord}`, // placeholder name
-          confidence: 0.7,
-        });
-      }
-    }
-
-    return relationships;
-  }
-}
-
-// Singleton instance
-export const entityExtractor = new EntityExtractor();