@coreidentitylabs/open-graph-memory-mcp 1.0.1

package/dist/llm/openai-provider.js

@@ -0,0 +1,141 @@
+// =============================================================================
+// OpenAI-Compatible LLM Provider
+// =============================================================================
+// Works with: OpenAI, Azure OpenAI, Ollama (OpenAI-compat mode), and any
+// provider exposing the OpenAI chat completions & embeddings API.
+// =============================================================================
+import { getExtractionSystemPrompt, getExtractionUserPrompt, } from "./prompts.js";
+export class OpenAIProvider {
+    apiKey;
+    baseUrl;
+    chatModel;
+    embeddingModel;
+    constructor(apiKey, baseUrl, chatModel, embeddingModel) {
+        this.apiKey = apiKey;
+        this.baseUrl = baseUrl.replace(/\/$/, ""); // strip trailing slash
+        this.chatModel = chatModel;
+        this.embeddingModel = embeddingModel;
+    }
+    /**
+     * Extract entities and relationships from text using the chat model.
+     */
+    async extractEntitiesAndRelations(text, existingEntities) {
+        const messages = [
+            { role: "system", content: getExtractionSystemPrompt(existingEntities) },
+            { role: "user", content: getExtractionUserPrompt(text) },
+        ];
+        const responseText = await this.chatCompletion(messages);
+        try {
+            // Clean response — strip markdown code fences if present
+            let cleaned = responseText.trim();
+            if (cleaned.startsWith("```")) {
+                cleaned = cleaned
+                    .replace(/^```(?:json)?\s*\n?/, "")
+                    .replace(/\n?```\s*$/, "");
+            }
+            const parsed = JSON.parse(cleaned);
+            const entities = (parsed.entities ?? [])
+                .map((e) => {
+                const entity = e;
+                return {
+                    name: String(entity.name ?? ""),
+                    type: validateNodeType(String(entity.type ?? "entity")),
+                    description: String(entity.description ?? ""),
+                    metadata: entity.metadata ?? {},
+                };
+            })
+                .filter((e) => e.name.length > 0);
+            const relations = (parsed.relations ?? [])
+                .map((r) => {
+                const rel = r;
+                return {
+                    source: String(rel.source ?? ""),
+                    target: String(rel.target ?? ""),
+                    relation: String(rel.relation ?? "related_to"),
+                    description: rel.description ? String(rel.description) : undefined,
+                    weight: typeof rel.weight === "number" ? rel.weight : 0.8,
+                };
+            })
+                .filter((r) => r.source.length > 0 && r.target.length > 0);
+            return { entities, relations };
+        }
+        catch (parseError) {
+            console.error(`[open-memory] Failed to parse LLM extraction response:`, parseError);
+            console.error(`[open-memory] Raw response:`, responseText);
+            return { entities: [], relations: [] };
+        }
+    }
+    /**
+     * Generate a single embedding vector.
+     */
+    async generateEmbedding(text) {
+        const result = await this.embeddingRequest([text]);
+        return result[0] ?? [];
+    }
+    /**
+     * Generate embeddings for multiple texts in a single batch.
+     */
+    async generateEmbeddingBatch(texts) {
+        return this.embeddingRequest(texts);
+    }
+    // ---------------------------------------------------------------------------
+    // HTTP Helpers
+    // ---------------------------------------------------------------------------
+    async chatCompletion(messages) {
+        const url = `${this.baseUrl}/chat/completions`;
+        const response = await fetch(url, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                Authorization: `Bearer ${this.apiKey}`,
+            },
+            body: JSON.stringify({
+                model: this.chatModel,
+                messages,
+                temperature: 0.1,
+                max_tokens: 4096,
+            }),
+        });
+        if (!response.ok) {
+            const errorBody = await response.text();
+            throw new Error(`LLM chat completion failed (${response.status}): ${errorBody}`);
+        }
+        const data = (await response.json());
+        return data.choices[0]?.message?.content ?? "";
+    }
+    async embeddingRequest(inputs) {
+        const url = `${this.baseUrl}/embeddings`;
+        const response = await fetch(url, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                Authorization: `Bearer ${this.apiKey}`,
+            },
+            body: JSON.stringify({
+                model: this.embeddingModel,
+                input: inputs,
+            }),
+        });
+        if (!response.ok) {
+            const errorBody = await response.text();
+            throw new Error(`LLM embedding request failed (${response.status}): ${errorBody}`);
+        }
+        const data = (await response.json());
+        return data.data.map((d) => d.embedding);
+    }
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function validateNodeType(type) {
+    const valid = [
+        "entity",
+        "concept",
+        "event",
+        "code_pattern",
+        "decision",
+        "conversation",
+    ];
+    return valid.includes(type) ? type : "entity";
+}
+//# sourceMappingURL=openai-provider.js.map

package/dist/llm/openai-provider.js.map

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

package/dist/llm/prompts.d.ts

@@ -0,0 +1,10 @@
+/**
+ * System prompt for entity and relationship extraction from developer conversations.
+ * Instructs the LLM to return structured JSON with entities and relations.
+ */
+export declare function getExtractionSystemPrompt(existingEntities: string[]): string;
+/**
+ * Build the user message for extraction.
+ */
+export declare function getExtractionUserPrompt(text: string): string;
+//# sourceMappingURL=prompts.d.ts.map

package/dist/llm/prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../src/llm/prompts.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,gBAAgB,EAAE,MAAM,EAAE,GAAG,MAAM,CAkD5E;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE5D"}

package/dist/llm/prompts.js

@@ -0,0 +1,63 @@
+// =============================================================================
+// Extraction Prompts — Optimized for developer conversations
+// =============================================================================
+/**
+ * System prompt for entity and relationship extraction from developer conversations.
+ * Instructs the LLM to return structured JSON with entities and relations.
+ */
+export function getExtractionSystemPrompt(existingEntities) {
+    const existingList = existingEntities.length > 0
+        ? `\n\nKnown entities already in memory (use these exact names for entity resolution):\n${existingEntities.map((e) => `- ${e}`).join("\n")}`
+        : "";
+    return `You are a specialized entity and relationship extraction system for developer conversations.
+
+Your task is to extract structured entities and relationships from the given text.
+
+## Entity Types
+- **entity**: People, teams, organizations, tools, libraries, frameworks, services, APIs, databases
+- **concept**: Abstract ideas, design patterns, paradigms, methodologies
+- **event**: Meetings, deployments, incidents, releases, decisions made at a point in time
+- **code_pattern**: Recurring code structures, architectural patterns, implementation approaches
+- **decision**: Technical decisions with rationale (e.g., "chose React Query over SWR because...")
+- **conversation**: Conversation summaries or session references
+
+## Extraction Rules
+1. Extract SPECIFIC entities, not generic terms (e.g., "React Query" not "library")
+2. For each entity, provide a concise but informative description
+3. For relationships, use clear verb-based relation types (uses, depends_on, replaced_by, decided_to, part_of, implements, configures, deployed_to, etc.)
+4. If an entity matches one of the known entities below, use the EXACT same name
+5. Capture temporal information when present (e.g., "decided last week" → include in metadata)
+6. Focus on information a developer would want to recall later
+${existingList}
+
+## Output Format
+Return ONLY valid JSON in this exact format:
+{
+  "entities": [
+    {
+      "name": "EntityName",
+      "type": "entity|concept|event|code_pattern|decision",
+      "description": "Concise description of what this entity is and its relevance",
+      "metadata": { "optional": "key-value pairs for extra context" }
+    }
+  ],
+  "relations": [
+    {
+      "source": "SourceEntityName",
+      "target": "TargetEntityName",
+      "relation": "verb_based_relation",
+      "description": "Brief description of this relationship"
+    }
+  ]
+}
+
+Return an empty arrays if no meaningful entities or relationships can be extracted.
+Do NOT include markdown code fences or any text outside the JSON.`;
+}
+/**
+ * Build the user message for extraction.
+ */
+export function getExtractionUserPrompt(text) {
+    return `Extract entities and relationships from the following text:\n\n${text}`;
+}
+//# sourceMappingURL=prompts.js.map

package/dist/llm/prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../../src/llm/prompts.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,6DAA6D;AAC7D,gFAAgF;AAEhF;;;GAGG;AACH,MAAM,UAAU,yBAAyB,CAAC,gBAA0B;IAClE,MAAM,YAAY,GAChB,gBAAgB,CAAC,MAAM,GAAG,CAAC;QACzB,CAAC,CAAC,wFAAwF,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;QAC5I,CAAC,CAAC,EAAE,CAAC;IAET,OAAO;;;;;;;;;;;;;;;;;;;EAmBP,YAAY;;;;;;;;;;;;;;;;;;;;;;;;kEAwBoD,CAAC;AACnE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,uBAAuB,CAAC,IAAY;IAClD,OAAO,kEAAkE,IAAI,EAAE,CAAC;AAClF,CAAC"}

package/dist/llm/provider.d.ts

@@ -0,0 +1,7 @@
+import type { LLMProvider } from "../types.js";
+/**
+ * Create an LLM provider if configured, or return null.
+ * The LLM provider is OPTIONAL — the agent-driven flow works without it.
+ */
+export declare function createLLMProvider(): LLMProvider | null;
+//# sourceMappingURL=provider.d.ts.map

package/dist/llm/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../src/llm/provider.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAI/C;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,WAAW,GAAG,IAAI,CAqBtD"}

package/dist/llm/provider.js

@@ -0,0 +1,25 @@
+// =============================================================================
+// LLM Provider — Interface & Factory
+// =============================================================================
+// Optional: only loaded if LLM_API_KEY is configured.
+// Powers the memory_encode_text tool for server-side entity extraction.
+// =============================================================================
+import { ENV_KEYS } from "../constants.js";
+import { OpenAIProvider } from "./openai-provider.js";
+/**
+ * Create an LLM provider if configured, or return null.
+ * The LLM provider is OPTIONAL — the agent-driven flow works without it.
+ */
+export function createLLMProvider() {
+    const apiKey = process.env[ENV_KEYS.LLM_API_KEY];
+    if (!apiKey) {
+        console.error("[open-memory] No LLM_API_KEY configured. Server-side encoding (memory_encode_text) disabled.");
+        return null;
+    }
+    const baseUrl = process.env[ENV_KEYS.LLM_BASE_URL] ?? "https://api.openai.com/v1";
+    const chatModel = process.env[ENV_KEYS.LLM_CHAT_MODEL] ?? "gpt-4o-mini";
+    const embeddingModel = process.env[ENV_KEYS.LLM_EMBEDDING_MODEL] ?? "text-embedding-3-small";
+    console.error(`[open-memory] LLM provider enabled: ${baseUrl} (chat: ${chatModel}, embed: ${embeddingModel})`);
+    return new OpenAIProvider(apiKey, baseUrl, chatModel, embeddingModel);
+}
+//# sourceMappingURL=provider.js.map

package/dist/llm/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../../src/llm/provider.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,qCAAqC;AACrC,gFAAgF;AAChF,sDAAsD;AACtD,wEAAwE;AACxE,gFAAgF;AAGhF,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD;;;GAGG;AACH,MAAM,UAAU,iBAAiB;IAC/B,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;IAEjD,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,CAAC,KAAK,CACX,8FAA8F,CAC/F,CAAC;QACF,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,OAAO,GACX,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,2BAA2B,CAAC;IACpE,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,cAAc,CAAC,IAAI,aAAa,CAAC;IACxE,MAAM,cAAc,GAClB,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,mBAAmB,CAAC,IAAI,wBAAwB,CAAC;IAExE,OAAO,CAAC,KAAK,CACX,uCAAuC,OAAO,WAAW,SAAS,YAAY,cAAc,GAAG,CAChG,CAAC;IAEF,OAAO,IAAI,cAAc,CAAC,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,cAAc,CAAC,CAAC;AACxE,CAAC"}

package/dist/resources/context-resource.d.ts

@@ -0,0 +1,8 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { StorageBackend } from "../types.js";
+/**
+ * Register MCP resources for automatic context injection.
+ * Agents can read these resources to get relevant context without explicit tool calls.
+ */
+export declare function registerMemoryResources(server: McpServer, store: StorageBackend): void;
+//# sourceMappingURL=context-resource.d.ts.map

package/dist/resources/context-resource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-resource.d.ts","sourceRoot":"","sources":["../../src/resources/context-resource.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,SAAS,EACjB,KAAK,EAAE,cAAc,GACpB,IAAI,CA2DN"}

package/dist/resources/context-resource.js

@@ -0,0 +1,51 @@
+// =============================================================================
+// MCP Resource — Auto-injectable recent memory context
+// =============================================================================
+/**
+ * Register MCP resources for automatic context injection.
+ * Agents can read these resources to get relevant context without explicit tool calls.
+ */
+export function registerMemoryResources(server, store) {
+    // Recent entities resource
+    server.registerResource("recent_entities", "memory://entities/recent", {
+        description: "Most recently updated entities in the memory graph",
+        mimeType: "application/json",
+    }, async () => {
+        const { nodes } = await store.getAllNodes(20, 0);
+        const sorted = nodes
+            .sort((a, b) => new Date(b.updatedAt).getTime() - new Date(a.updatedAt).getTime())
+            .slice(0, 20);
+        const content = sorted.map((n) => ({
+            name: n.name,
+            type: n.type,
+            description: n.description.substring(0, 200),
+            updatedAt: n.updatedAt,
+        }));
+        return {
+            contents: [
+                {
+                    uri: "memory://entities/recent",
+                    mimeType: "application/json",
+                    text: JSON.stringify(content, null, 2),
+                },
+            ],
+        };
+    });
+    // Graph stats resource
+    server.registerResource("graph_stats", "memory://stats", {
+        description: "Current memory graph statistics (node counts, edge counts, backend type)",
+        mimeType: "application/json",
+    }, async () => {
+        const stats = await store.getStats();
+        return {
+            contents: [
+                {
+                    uri: "memory://stats",
+                    mimeType: "application/json",
+                    text: JSON.stringify(stats, null, 2),
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=context-resource.js.map

package/dist/resources/context-resource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-resource.js","sourceRoot":"","sources":["../../src/resources/context-resource.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,uDAAuD;AACvD,gFAAgF;AAKhF;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CACrC,MAAiB,EACjB,KAAqB;IAErB,2BAA2B;IAC3B,MAAM,CAAC,gBAAgB,CACrB,iBAAiB,EACjB,0BAA0B,EAC1B;QACE,WAAW,EAAE,oDAAoD;QACjE,QAAQ,EAAE,kBAAkB;KAC7B,EACD,KAAK,IAAI,EAAE;QACT,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,KAAK,CAAC,WAAW,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;QACjD,MAAM,MAAM,GAAG,KAAK;aACjB,IAAI,CACH,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CACP,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,CACpE;aACA,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAEhB,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACjC,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,WAAW,EAAE,CAAC,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC;YAC5C,SAAS,EAAE,CAAC,CAAC,SAAS;SACvB,CAAC,CAAC,CAAC;QAEJ,OAAO;YACL,QAAQ,EAAE;gBACR;oBACE,GAAG,EAAE,0BAA0B;oBAC/B,QAAQ,EAAE,kBAAkB;oBAC5B,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;iBACvC;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;IAEF,uBAAuB;IACvB,MAAM,CAAC,gBAAgB,CACrB,aAAa,EACb,gBAAgB,EAChB;QACE,WAAW,EACT,0EAA0E;QAC5E,QAAQ,EAAE,kBAAkB;KAC7B,EACD,KAAK,IAAI,EAAE;QACT,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,QAAQ,EAAE,CAAC;QACrC,OAAO;YACL,QAAQ,EAAE;gBACR;oBACE,GAAG,EAAE,gBAAgB;oBACrB,QAAQ,EAAE,kBAAkB;oBAC5B,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;iBACrC;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/retrieval/search.d.ts

@@ -0,0 +1,24 @@
+import type { StorageBackend, SearchResult, NodeType } from "../types.js";
+export interface SearchOptions {
+    query: string;
+    topK?: number;
+    type?: NodeType;
+    timeRange?: {
+        after?: string;
+        before?: string;
+    };
+    traversalDepth?: number;
+}
+/**
+ * Hybrid retrieval combining:
+ * 1. Text match on node names and descriptions
+ * 2. Cosine similarity on embeddings (semantic anchors)
+ * 3. Graph traversal from top anchors (2-hop neighborhood)
+ * 4. Ranking by: score = α·semantic + β·textMatch + γ·recency + δ·accessFreq
+ */
+export declare function hybridSearch(store: StorageBackend, options: SearchOptions): Promise<SearchResult>;
+/**
+ * Get context for a specific topic, formatted for prompt injection.
+ */
+export declare function getContextForTopic(store: StorageBackend, topic: string, maxTokens?: number): Promise<string>;
+//# sourceMappingURL=search.d.ts.map

package/dist/retrieval/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/retrieval/search.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,cAAc,EAId,YAAY,EACZ,QAAQ,EACT,MAAM,aAAa,CAAC;AAOrB,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,SAAS,CAAC,EAAE;QACV,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;GAMG;AACH,wBAAsB,YAAY,CAChC,KAAK,EAAE,cAAc,EACrB,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,YAAY,CAAC,CAyHvB;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,cAAc,EACrB,KAAK,EAAE,MAAM,EACb,SAAS,GAAE,MAAa,GACvB,OAAO,CAAC,MAAM,CAAC,CAiCjB"}

package/dist/retrieval/search.js

@@ -0,0 +1,143 @@
+// =============================================================================
+// Hybrid Retrieval Engine — Semantic + Graph + Text Search
+// =============================================================================
+import { generateLocalEmbedding, cosineSimilarity, } from "../encoding/embedder.js";
+import { DEFAULT_TOP_K, DEFAULT_TRAVERSAL_DEPTH } from "../constants.js";
+/**
+ * Hybrid retrieval combining:
+ * 1. Text match on node names and descriptions
+ * 2. Cosine similarity on embeddings (semantic anchors)
+ * 3. Graph traversal from top anchors (2-hop neighborhood)
+ * 4. Ranking by: score = α·semantic + β·textMatch + γ·recency + δ·accessFreq
+ */
+export async function hybridSearch(store, options) {
+    const { query, topK = DEFAULT_TOP_K, type, timeRange, traversalDepth = DEFAULT_TRAVERSAL_DEPTH, } = options;
+    const queryLower = query.toLowerCase();
+    const queryEmbedding = generateLocalEmbedding(query);
+    // Step 1: Get all candidate nodes
+    const { nodes: allNodes } = await store.getAllNodes(10000, 0);
+    // Step 2: Score each node
+    const scored = [];
+    for (const node of allNodes) {
+        // Apply type filter
+        if (type && node.type !== type)
+            continue;
+        // Apply time range filter
+        if (timeRange?.after && node.createdAt < timeRange.after)
+            continue;
+        if (timeRange?.before && node.createdAt > timeRange.before)
+            continue;
+        let totalScore = 0;
+        let matchType = "text";
+        // Text match scoring
+        const nameMatch = node.name.toLowerCase().includes(queryLower) ? 0.6 : 0;
+        const descMatch = node.description.toLowerCase().includes(queryLower)
+            ? 0.4
+            : 0;
+        // Partial word matching
+        const queryWords = queryLower.split(/\s+/).filter((w) => w.length > 2);
+        let wordMatchScore = 0;
+        for (const word of queryWords) {
+            if (node.name.toLowerCase().includes(word))
+                wordMatchScore += 0.15;
+            if (node.description.toLowerCase().includes(word))
+                wordMatchScore += 0.1;
+        }
+        const textScore = Math.min(1, nameMatch + descMatch + wordMatchScore);
+        // Semantic similarity scoring
+        let semanticScore = 0;
+        if (node.embedding && node.embedding.length > 0) {
+            semanticScore = cosineSimilarity(queryEmbedding, node.embedding);
+            if (semanticScore > textScore)
+                matchType = "semantic";
+        }
+        // Recency boost (decays over 30 days)
+        const ageMs = Date.now() - new Date(node.updatedAt).getTime();
+        const ageDays = ageMs / (1000 * 60 * 60 * 24);
+        const recencyBoost = Math.max(0, 1 - ageDays / 30) * 0.1;
+        // Access frequency boost (capped)
+        const accessBoost = Math.min(node.accessCount / 100, 0.1);
+        // Weighted combination
+        totalScore =
+            0.4 * semanticScore +
+                0.4 * textScore +
+                0.1 * recencyBoost +
+                0.1 * accessBoost;
+        if (totalScore > 0.05) {
+            scored.push({ node, score: totalScore, matchType });
+        }
+    }
+    // Step 3: Sort by score, take top K
+    scored.sort((a, b) => b.score - a.score);
+    const topResults = scored.slice(0, topK);
+    // Step 4: Graph traversal from top anchors to find related context
+    const relatedEdgesMap = new Map();
+    const graphNodeIds = new Set(topResults.map((r) => r.node.id));
+    // Traverse from top 3 anchors
+    const anchors = topResults.slice(0, 3);
+    for (const anchor of anchors) {
+        const neighborhood = await store.getNeighborhood(anchor.node.id, traversalDepth);
+        for (const edge of neighborhood.edges) {
+            relatedEdgesMap.set(edge.id, edge);
+        }
+        // Add graph-discovered nodes that aren't already in results
+        for (const neighbor of neighborhood.nodes) {
+            if (!graphNodeIds.has(neighbor.id)) {
+                graphNodeIds.add(neighbor.id);
+                topResults.push({
+                    node: neighbor,
+                    score: anchor.score * 0.5, // Discounted score for graph neighbors
+                    matchType: "graph",
+                });
+            }
+        }
+    }
+    // Step 5: Update access counts for returned nodes
+    for (const result of topResults) {
+        await store.updateNode(result.node.id, {
+            accessCount: result.node.accessCount + 1,
+            lastAccessedAt: new Date().toISOString(),
+        });
+    }
+    // Re-sort after adding graph neighbors
+    topResults.sort((a, b) => b.score - a.score);
+    return {
+        nodes: topResults.slice(0, topK),
+        relatedEdges: Array.from(relatedEdgesMap.values()),
+        totalNodes: scored.length,
+    };
+}
+/**
+ * Get context for a specific topic, formatted for prompt injection.
+ */
+export async function getContextForTopic(store, topic, maxTokens = 2000) {
+    const results = await hybridSearch(store, {
+        query: topic,
+        topK: 10,
+        traversalDepth: 1,
+    });
+    const lines = [];
+    let estimatedTokens = 0;
+    lines.push(`## Relevant Memory Context: "${topic}"\n`);
+    for (const { node, score } of results.nodes) {
+        if (estimatedTokens > maxTokens)
+            break;
+        const entry = `### ${node.name} (${node.type})\n${node.description}\n`;
+        estimatedTokens += entry.length / 4; // rough token estimate
+        lines.push(entry);
+    }
+    if (results.relatedEdges.length > 0) {
+        lines.push(`### Relationships\n`);
+        for (const edge of results.relatedEdges.slice(0, 10)) {
+            const fromNode = results.nodes.find((n) => n.node.id === edge.source);
+            const toNode = results.nodes.find((n) => n.node.id === edge.target);
+            const fromName = fromNode?.node.name ?? edge.source;
+            const toName = toNode?.node.name ?? edge.target;
+            lines.push(`- ${fromName} **${edge.relation}** ${toName}`);
+            if (edge.description)
+                lines.push(`  _${edge.description}_`);
+        }
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=search.js.map

package/dist/retrieval/search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../../src/retrieval/search.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,2DAA2D;AAC3D,gFAAgF;AAUhF,OAAO,EACL,sBAAsB,EACtB,gBAAgB,GACjB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,aAAa,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAazE;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,KAAqB,EACrB,OAAsB;IAEtB,MAAM,EACJ,KAAK,EACL,IAAI,GAAG,aAAa,EACpB,IAAI,EACJ,SAAS,EACT,cAAc,GAAG,uBAAuB,GACzC,GAAG,OAAO,CAAC;IAEZ,MAAM,UAAU,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;IACvC,MAAM,cAAc,GAAG,sBAAsB,CAAC,KAAK,CAAC,CAAC;IAErD,kCAAkC;IAClC,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,MAAM,KAAK,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IAE9D,0BAA0B;IAC1B,MAAM,MAAM,GAAiB,EAAE,CAAC;IAEhC,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;QAC5B,oBAAoB;QACpB,IAAI,IAAI,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI;YAAE,SAAS;QAEzC,0BAA0B;QAC1B,IAAI,SAAS,EAAE,KAAK,IAAI,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC,KAAK;YAAE,SAAS;QACnE,IAAI,SAAS,EAAE,MAAM,IAAI,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC,MAAM;YAAE,SAAS;QAErE,IAAI,UAAU,GAAG,CAAC,CAAC;QACnB,IAAI,SAAS,GAA4B,MAAM,CAAC;QAEhD,qBAAqB;QACrB,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACzE,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC;YACnE,CAAC,CAAC,GAAG;YACL,CAAC,CAAC,CAAC,CAAC;QAEN,wBAAwB;QACxB,MAAM,UAAU,GAAG,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QACvE,IAAI,cAAc,GAAG,CAAC,CAAC;QACvB,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;YAC9B,IAAI,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC;gBAAE,cAAc,IAAI,IAAI,CAAC;YACnE,IAAI,IAAI,CAAC,WAAW,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC;gBAAE,cAAc,IAAI,GAAG,CAAC;QAC3E,CAAC;QAED,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,cAAc,CAAC,CAAC;QAEtE,8BAA8B;QAC9B,IAAI,aAAa,GAAG,CAAC,CAAC;QACtB,IAAI,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAChD,aAAa,GAAG,gBAAgB,CAAC,cAAc,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;YACjE,IAAI,aAAa,GAAG,SAAS;gBAAE,SAAS,GAAG,UAAU,CAAC;QACxD,CAAC;QAED,sCAAsC;QACtC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,CAAC;QAC9D,MAAM,OAAO,GAAG,KAAK,GAAG,CAAC,IAAI,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC;QAC9C,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,GAAG,OAAO,GAAG,EAAE,CAAC,GAAG,GAAG,CAAC;QAEzD,kCAAkC;QAClC,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,GAAG,GAAG,EAAE,GAAG,CAAC,CAAC;QAE1D,uBAAuB;QACvB,UAAU;YACR,GAAG,GAAG,aAAa;gBACnB,GAAG,GAAG,SAAS;gBACf,GAAG,GAAG,YAAY;gBAClB,GAAG,GAAG,WAAW,CAAC;QAEpB,IAAI,UAAU,GAAG,IAAI,EAAE,CAAC;YACtB,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC,CAAC;QACtD,CAAC;IACH,CAAC;IAED,oCAAoC;IACpC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;IACzC,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;IAEzC,mEAAmE;IACnE,MAAM,eAAe,GAAG,IAAI,GAAG,EAAsB,CAAC;IACtD,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;IAE/D,8BAA8B;IAC9B,MAAM,OAAO,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACvC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,YAAY,GAAG,MAAM,KAAK,CAAC,eAAe,CAC9C,MAAM,CAAC,IAAI,CAAC,EAAE,EACd,cAAc,CACf,CAAC;QAEF,KAAK,MAAM,IAAI,IAAI,YAAY,CAAC,KAAK,EAAE,CAAC;YACtC,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;QACrC,CAAC;QAED,4DAA4D;QAC5D,KAAK,MAAM,QAAQ,IAAI,YAAY,CAAC,KAAK,EAAE,CAAC;YAC1C,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;gBACnC,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;gBAC9B,UAAU,CAAC,IAAI,CAAC;oBACd,IAAI,EAAE,QAAQ;oBACd,KAAK,EAAE,MAAM,CAAC,KAAK,GAAG,GAAG,EAAE,uCAAuC;oBAClE,SAAS,EAAE,OAAO;iBACnB,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IAED,kDAAkD;IAClD,KAAK,MAAM,MAAM,IAAI,UAAU,EAAE,CAAC;QAChC,MAAM,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE;YACrC,WAAW,EAAE,MAAM,CAAC,IAAI,CAAC,WAAW,GAAG,CAAC;YACxC,cAAc,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACzC,CAAC,CAAC;IACL,CAAC;IAED,uCAAuC;IACvC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;IAE7C,OAAO;QACL,KAAK,EAAE,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC;QAChC,YAAY,EAAE,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,MAAM,EAAE,CAAC;QAClD,UAAU,EAAE,MAAM,CAAC,MAAM;KAC1B,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,KAAqB,EACrB,KAAa,EACb,YAAoB,IAAI;IAExB,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,KAAK,EAAE;QACxC,KAAK,EAAE,KAAK;QACZ,IAAI,EAAE,EAAE;QACR,cAAc,EAAE,CAAC;KAClB,CAAC,CAAC;IAEH,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,eAAe,GAAG,CAAC,CAAC;IAExB,KAAK,CAAC,IAAI,CAAC,gCAAgC,KAAK,KAAK,CAAC,CAAC;IAEvD,KAAK,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;QAC5C,IAAI,eAAe,GAAG,SAAS;YAAE,MAAM;QAEvC,MAAM,KAAK,GAAG,OAAO,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,MAAM,IAAI,CAAC,WAAW,IAAI,CAAC;QACvE,eAAe,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,uBAAuB;QAC5D,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACpB,CAAC;IAED,IAAI,OAAO,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpC,KAAK,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;QAClC,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;YACrD,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,IAAI,CAAC,MAAM,CAAC,CAAC;YACtE,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,IAAI,CAAC,MAAM,CAAC,CAAC;YACpE,MAAM,QAAQ,GAAG,QAAQ,EAAE,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,CAAC;YACpD,MAAM,MAAM,GAAG,MAAM,EAAE,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,CAAC;YAChD,KAAK,CAAC,IAAI,CAAC,KAAK,QAAQ,MAAM,IAAI,CAAC,QAAQ,MAAM,MAAM,EAAE,CAAC,CAAC;YAC3D,IAAI,IAAI,CAAC,WAAW;gBAAE,KAAK,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,WAAW,GAAG,CAAC,CAAC;QAC9D,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/storage/factory.d.ts

@@ -0,0 +1,10 @@
+import type { StorageBackend } from "../types.js";
+export type StorageType = "json" | "neo4j";
+/**
+ * Create a storage backend based on environment configuration.
+ *
+ * STORAGE_BACKEND=json  → Local JSON file (default, zero-config)
+ * STORAGE_BACKEND=neo4j → Neo4j graph database
+ */
+export declare function createStorageBackend(): StorageBackend;
+//# sourceMappingURL=factory.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../src/storage/factory.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAKlD,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,OAAO,CAAC;AAE3C;;;;;GAKG;AACH,wBAAgB,oBAAoB,IAAI,cAAc,CA8BrD"}

package/dist/storage/factory.js

@@ -0,0 +1,35 @@
+// =============================================================================
+// Storage Backend Factory
+// =============================================================================
+import { JsonStore } from "./json-store.js";
+import { Neo4jStore } from "./neo4j-store.js";
+import { ENV_KEYS, DEFAULT_MEMORY_STORE_PATH } from "../constants.js";
+/**
+ * Create a storage backend based on environment configuration.
+ *
+ * STORAGE_BACKEND=json  → Local JSON file (default, zero-config)
+ * STORAGE_BACKEND=neo4j → Neo4j graph database
+ */
+export function createStorageBackend() {
+    const backendType = (process.env[ENV_KEYS.STORAGE_BACKEND] ?? "json").toLowerCase();
+    switch (backendType) {
+        case "neo4j": {
+            const uri = process.env[ENV_KEYS.NEO4J_URI];
+            const user = process.env[ENV_KEYS.NEO4J_USER];
+            const password = process.env[ENV_KEYS.NEO4J_PASSWORD];
+            if (!uri || !user || !password) {
+                console.error(`[open-memory] ERROR: Neo4j requires NEO4J_URI, NEO4J_USER, and NEO4J_PASSWORD environment variables.`);
+                process.exit(1);
+            }
+            console.error(`[open-memory] Using Neo4j storage backend at ${uri}`);
+            return new Neo4jStore(uri, user, password);
+        }
+        case "json":
+        default: {
+            const filePath = process.env[ENV_KEYS.MEMORY_STORE_PATH] ?? DEFAULT_MEMORY_STORE_PATH;
+            console.error(`[open-memory] Using JSON storage backend at ${filePath}`);
+            return new JsonStore(filePath);
+        }
+    }
+}
+//# sourceMappingURL=factory.js.map

package/dist/storage/factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../src/storage/factory.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,0BAA0B;AAC1B,gFAAgF;AAGhF,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AAItE;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB;IAClC,MAAM,WAAW,GAAG,CAClB,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,eAAe,CAAC,IAAI,MAAM,CAChD,CAAC,WAAW,EAAiB,CAAC;IAE/B,QAAQ,WAAW,EAAE,CAAC;QACpB,KAAK,OAAO,CAAC,CAAC,CAAC;YACb,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;YAC5C,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;YAC9C,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;YAEtD,IAAI,CAAC,GAAG,IAAI,CAAC,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;gBAC/B,OAAO,CAAC,KAAK,CACX,sGAAsG,CACvG,CAAC;gBACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAClB,CAAC;YAED,OAAO,CAAC,KAAK,CAAC,gDAAgD,GAAG,EAAE,CAAC,CAAC;YACrE,OAAO,IAAI,UAAU,CAAC,GAAG,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;QAC7C,CAAC;QAED,KAAK,MAAM,CAAC;QACZ,OAAO,CAAC,CAAC,CAAC;YACR,MAAM,QAAQ,GACZ,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,iBAAiB,CAAC,IAAI,yBAAyB,CAAC;YACvE,OAAO,CAAC,KAAK,CAAC,+CAA+C,QAAQ,EAAE,CAAC,CAAC;YACzE,OAAO,IAAI,SAAS,CAAC,QAAQ,CAAC,CAAC;QACjC,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/storage/json-store.d.ts

@@ -0,0 +1,34 @@
+import type { StorageBackend, MemoryNode, MemoryEdge, ScoredNode, Subgraph, NodeFilter, GraphStats } from "../types.js";
+export declare class JsonStore implements StorageBackend {
+    private nodes;
+    private edges;
+    private lastConsolidated?;
+    private filePath;
+    constructor(filePath: string);
+    initialize(): Promise<void>;
+    private persist;
+    addNode(node: MemoryNode): Promise<void>;
+    updateNode(id: string, updates: Partial<MemoryNode>): Promise<MemoryNode | null>;
+    deleteNode(id: string): Promise<boolean>;
+    getNode(id: string): Promise<MemoryNode | null>;
+    getNodeByName(name: string): Promise<MemoryNode | null>;
+    findNodes(filter: NodeFilter): Promise<MemoryNode[]>;
+    getAllNodes(limit: number, offset: number): Promise<{
+        nodes: MemoryNode[];
+        total: number;
+    }>;
+    findNodesByEmbedding(embedding: number[], topK: number): Promise<ScoredNode[]>;
+    addEdge(edge: MemoryEdge): Promise<void>;
+    updateEdge(id: string, updates: Partial<MemoryEdge>): Promise<MemoryEdge | null>;
+    deleteEdge(id: string): Promise<boolean>;
+    getEdge(id: string): Promise<MemoryEdge | null>;
+    getEdgesForNode(nodeId: string, direction?: "in" | "out" | "both"): Promise<MemoryEdge[]>;
+    getEdgesBetween(sourceId: string, targetId: string): Promise<MemoryEdge[]>;
+    getNeighborhood(nodeId: string, depth: number): Promise<Subgraph>;
+    getStats(): Promise<GraphStats>;
+    close(): Promise<void>;
+    getNodesMap(): Map<string, MemoryNode>;
+    getEdgesMap(): Map<string, MemoryEdge>;
+    setLastConsolidated(timestamp: string): void;
+}
+//# sourceMappingURL=json-store.d.ts.map

package/dist/storage/json-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-store.d.ts","sourceRoot":"","sources":["../../src/storage/json-store.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EACV,cAAc,EACd,UAAU,EACV,UAAU,EACV,UAAU,EACV,QAAQ,EACR,UAAU,EACV,UAAU,EACX,MAAM,aAAa,CAAC;AAUrB,qBAAa,SAAU,YAAW,cAAc;IAC9C,OAAO,CAAC,KAAK,CAAsC;IACnD,OAAO,CAAC,KAAK,CAAsC;IACnD,OAAO,CAAC,gBAAgB,CAAC,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAS;gBAEb,QAAQ,EAAE,MAAM;IAItB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAqBjC,OAAO,CAAC,OAAO;IAmBT,OAAO,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAKxC,UAAU,CACd,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,OAAO,CAAC,UAAU,CAAC,GAC3B,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAcvB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAcxC,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAI/C,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAUvD,SAAS,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAuBpD,WAAW,CACf,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GACb,OAAO,CAAC;QAAE,KAAK,EAAE,UAAU,EAAE,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAQ5C,oBAAoB,CACxB,SAAS,EAAE,MAAM,EAAE,EACnB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,UAAU,EAAE,CAAC;IAclB,OAAO,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAKxC,UAAU,CACd,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,OAAO,CAAC,UAAU,CAAC,GAC3B,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAcvB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAMxC,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAI/C,eAAe,CACnB,MAAM,EAAE,MAAM,EACd,SAAS,GAAE,IAAI,GAAG,KAAK,GAAG,MAAe,GACxC,OAAO,CAAC,UAAU,EAAE,CAAC;IAclB,eAAe,CACnB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,UAAU,EAAE,CAAC;IAelB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IA2CjE,QAAQ,IAAI,OAAO,CAAC,UAAU,CAAC;IAe/B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAM5B,WAAW,IAAI,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC;IAItC,WAAW,IAAI,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC;IAItC,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;CAI7C"}