agent-memory-graph 0.1.0

package/dist/src/index.d.ts

@@ -0,0 +1,129 @@
+import { type Entity, type Relationship, type GraphStats } from './graph/engine.js';
+import { type Config } from './config/defaults.js';
+import { type ExtractionResult } from './extract/extractor.js';
+import { type SearchResult } from './search/hybrid.js';
+import { type NLQueryResult } from './search/natural-language.js';
+import { type ExportFormat } from './sync/export.js';
+export interface MemoryGraphOptions {
+    /** Path to SQLite database file */
+    path?: string;
+    /** Path to config file (optional) */
+    configPath?: string;
+    /** Inline config override (optional) */
+    config?: Partial<Config>;
+}
+/**
+ * MemoryGraph — Domain-agnostic knowledge graph for AI agents.
+ *
+ * Zero-config, local-first, SQLite-powered.
+ *
+ * @example
+ * ```ts
+ * import { MemoryGraph } from 'agent-memory-graph';
+ *
+ * const graph = new MemoryGraph();
+ * await graph.ingest("Alice works on Project Atlas using Rust");
+ * const answer = await graph.ask("What does Alice work on?");
+ * console.log(answer);
+ * ```
+ */
+export declare class MemoryGraph {
+    private engine;
+    private config;
+    constructor(options?: MemoryGraphOptions);
+    /**
+     * Ingest text: extract entities and relationships, store in graph.
+     */
+    ingest(text: string, options?: {
+        source?: string;
+        sessionId?: string;
+    }): Promise<ExtractionResult>;
+    /**
+     * Ask a natural language question against the graph.
+     */
+    ask(question: string): Promise<NLQueryResult>;
+    /**
+     * Search entities by keyword.
+     */
+    search(query: string, limit?: number): SearchResult[];
+    /**
+     * Add an entity manually.
+     */
+    addEntity(name: string, type: string, properties?: Record<string, unknown>): Entity;
+    /**
+     * Add a relationship manually.
+     */
+    addRelation(from: string, relation: string, to: string, options?: {
+        fromType?: string;
+        toType?: string;
+    }): Relationship;
+    /**
+     * Find an entity by name.
+     */
+    findEntity(name: string, type?: string): Entity | null;
+    /**
+     * List entities, optionally filtered by type.
+     */
+    listEntities(options?: {
+        type?: string;
+        limit?: number;
+    }): Entity[];
+    /**
+     * Delete an entity and its relationships.
+     */
+    deleteEntity(nameOrId: string): boolean;
+    /**
+     * Find shortest path between two entities.
+     */
+    findPath(from: string, to: string, maxHops?: number): {
+        path: string[];
+        relations: string[];
+    } | null;
+    /**
+     * Get all entities and relationships within N hops of an entity.
+     */
+    neighborhood(entityName: string, hops?: number): {
+        entities: Entity[];
+        relationships: Relationship[];
+    };
+    /**
+     * Export graph to a format (json, mermaid, dot, csv).
+     */
+    export(format: ExportFormat, options?: {
+        includeProperties?: boolean;
+        maxEntities?: number;
+    }): string;
+    /**
+     * Import from a MEMORY.md file or directory.
+     */
+    importFrom(path: string): Promise<{
+        entities: number;
+        relationships: number;
+    }>;
+    /**
+     * Find and optionally merge duplicate entities.
+     */
+    deduplicate(options?: {
+        threshold?: number;
+        autoMerge?: boolean;
+    }): Array<{
+        entity: string;
+        duplicateOf: string;
+        similarity: number;
+    }>;
+    /**
+     * Get graph statistics.
+     */
+    stats(): GraphStats;
+    /**
+     * Close database connection.
+     */
+    close(): void;
+}
+export type { Entity, Relationship, GraphStats } from './graph/engine.js';
+export type { Config } from './config/schema.js';
+export type { ExtractionResult, ExtractedEntity, ExtractedRelation } from './extract/extractor.js';
+export type { SearchResult } from './search/hybrid.js';
+export type { NLQueryResult } from './search/natural-language.js';
+export type { ExportFormat } from './sync/export.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/index.d.ts.map

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

package/dist/src/index.js

@@ -0,0 +1,174 @@
+import { GraphEngine } from './graph/engine.js';
+import { loadConfig } from './config/defaults.js';
+import { extractFromText } from './extract/extractor.js';
+import { hybridSearch } from './search/hybrid.js';
+import { naturalLanguageQuery } from './search/natural-language.js';
+import { exportGraph } from './sync/export.js';
+import { importFromMemoryMd, importFromDirectory } from './sync/memory-md.js';
+import { findDuplicates, mergeEntities } from './extract/dedup.js';
+/**
+ * MemoryGraph — Domain-agnostic knowledge graph for AI agents.
+ *
+ * Zero-config, local-first, SQLite-powered.
+ *
+ * @example
+ * ```ts
+ * import { MemoryGraph } from 'agent-memory-graph';
+ *
+ * const graph = new MemoryGraph();
+ * await graph.ingest("Alice works on Project Atlas using Rust");
+ * const answer = await graph.ask("What does Alice work on?");
+ * console.log(answer);
+ * ```
+ */
+export class MemoryGraph {
+    engine;
+    config;
+    constructor(options = {}) {
+        this.config = loadConfig(options.configPath);
+        // Apply inline overrides
+        if (options.config) {
+            this.config = { ...this.config, ...options.config };
+        }
+        const dbPath = options.path ?? this.config.storage.path;
+        this.engine = new GraphEngine(dbPath);
+    }
+    // ─── Core API ──────────────────────────────────────────────────
+    /**
+     * Ingest text: extract entities and relationships, store in graph.
+     */
+    async ingest(text, options = {}) {
+        const result = await extractFromText(text, this.config);
+        // Store entities
+        for (const entity of result.entities) {
+            this.engine.addEntity(entity.name, entity.type, entity.properties ?? {}, {
+                source: options.source,
+                confidence: entity.confidence,
+            });
+        }
+        // Store relationships
+        for (const rel of result.relationships) {
+            this.engine.addRelation(rel.from, rel.relation, rel.to, {
+                source: options.source,
+                confidence: rel.confidence,
+                fromType: rel.fromType,
+                toType: rel.toType,
+            });
+        }
+        // Log extraction
+        this.engine.logExtraction(text, result.entities, result.relationships, options.sessionId);
+        return result;
+    }
+    /**
+     * Ask a natural language question against the graph.
+     */
+    async ask(question) {
+        return naturalLanguageQuery(question, this.engine, this.config);
+    }
+    /**
+     * Search entities by keyword.
+     */
+    search(query, limit) {
+        return hybridSearch(this.engine, query, {
+            ...this.config,
+            query: { ...this.config.query, maxResults: limit ?? this.config.query.maxResults },
+        });
+    }
+    // ─── Entity Management ─────────────────────────────────────────
+    /**
+     * Add an entity manually.
+     */
+    addEntity(name, type, properties = {}) {
+        return this.engine.addEntity(name, type, properties);
+    }
+    /**
+     * Add a relationship manually.
+     */
+    addRelation(from, relation, to, options) {
+        return this.engine.addRelation(from, relation, to, options);
+    }
+    /**
+     * Find an entity by name.
+     */
+    findEntity(name, type) {
+        return this.engine.findEntityByName(name, type);
+    }
+    /**
+     * List entities, optionally filtered by type.
+     */
+    listEntities(options) {
+        return this.engine.listEntities(options);
+    }
+    /**
+     * Delete an entity and its relationships.
+     */
+    deleteEntity(nameOrId) {
+        const entity = this.engine.getEntity(nameOrId) ?? this.engine.findEntityByName(nameOrId);
+        if (!entity)
+            return false;
+        return this.engine.deleteEntity(entity.id);
+    }
+    // ─── Graph Operations ──────────────────────────────────────────
+    /**
+     * Find shortest path between two entities.
+     */
+    findPath(from, to, maxHops) {
+        return this.engine.findPath(from, to, maxHops ?? this.config.query.maxHops);
+    }
+    /**
+     * Get all entities and relationships within N hops of an entity.
+     */
+    neighborhood(entityName, hops = 1) {
+        return this.engine.getNeighborhood(entityName, hops);
+    }
+    // ─── Import / Export ───────────────────────────────────────────
+    /**
+     * Export graph to a format (json, mermaid, dot, csv).
+     */
+    export(format, options) {
+        return exportGraph(this.engine, { format, ...options });
+    }
+    /**
+     * Import from a MEMORY.md file or directory.
+     */
+    async importFrom(path) {
+        const { statSync } = await import('node:fs');
+        const stat = statSync(path);
+        if (stat.isDirectory()) {
+            const result = await importFromDirectory(path, this.engine, this.config);
+            return { entities: result.entities, relationships: result.relationships };
+        }
+        return importFromMemoryMd(path, this.engine, this.config);
+    }
+    // ─── Maintenance ───────────────────────────────────────────────
+    /**
+     * Find and optionally merge duplicate entities.
+     */
+    deduplicate(options) {
+        const threshold = options?.threshold ?? this.config.deduplication.similarityThreshold;
+        const duplicates = findDuplicates(this.engine, threshold);
+        if (options?.autoMerge) {
+            for (const dup of duplicates) {
+                mergeEntities(this.engine, dup.duplicateOf.id, dup.entity.id);
+            }
+        }
+        return duplicates.map(d => ({
+            entity: d.entity.name,
+            duplicateOf: d.duplicateOf.name,
+            similarity: d.similarity,
+        }));
+    }
+    /**
+     * Get graph statistics.
+     */
+    stats() {
+        return this.engine.stats();
+    }
+    /**
+     * Close database connection.
+     */
+    close() {
+        this.engine.close();
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

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

package/dist/src/search/hybrid.d.ts

@@ -0,0 +1,22 @@
+import type { Config } from '../config/schema.js';
+import { GraphEngine } from '../graph/engine.js';
+export interface SearchResult {
+    entity: {
+        id: string;
+        name: string;
+        type: string;
+        properties: Record<string, unknown>;
+    };
+    relations: Array<{
+        direction: 'outgoing' | 'incoming';
+        relation: string;
+        target: string;
+        targetType: string;
+    }>;
+    score?: number;
+}
+/**
+ * Hybrid search: combines FTS + graph context.
+ */
+export declare function hybridSearch(engine: GraphEngine, query: string, config: Config): SearchResult[];
+//# sourceMappingURL=hybrid.d.ts.map

package/dist/src/search/hybrid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hybrid.d.ts","sourceRoot":"","sources":["../../../src/search/hybrid.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE;QACN,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACrC,CAAC;IACF,SAAS,EAAE,KAAK,CAAC;QACf,SAAS,EAAE,UAAU,GAAG,UAAU,CAAC;QACnC,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC,CAAC;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,WAAW,EACnB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GACb,YAAY,EAAE,CAsChB"}

package/dist/src/search/hybrid.js

@@ -0,0 +1,38 @@
+/**
+ * Hybrid search: combines FTS + graph context.
+ */
+export function hybridSearch(engine, query, config) {
+    const limit = config.query.maxResults;
+    // Step 1: FTS search for matching entities
+    const entities = engine.searchEntities(query, limit);
+    // Step 2: Enrich with relationship context
+    const results = entities.map(entity => {
+        const outgoing = engine.getRelationsFrom(entity.id);
+        const incoming = engine.getRelationsTo(entity.id);
+        const relations = [
+            ...outgoing.map(r => ({
+                direction: 'outgoing',
+                relation: r.relation,
+                target: r.to_name,
+                targetType: r.to_type,
+            })),
+            ...incoming.map(r => ({
+                direction: 'incoming',
+                relation: r.relation,
+                target: r.from_name,
+                targetType: r.from_type,
+            })),
+        ];
+        return {
+            entity: {
+                id: entity.id,
+                name: entity.name,
+                type: entity.type,
+                properties: entity.properties,
+            },
+            relations,
+        };
+    });
+    return results;
+}
+//# sourceMappingURL=hybrid.js.map

package/dist/src/search/hybrid.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hybrid.js","sourceRoot":"","sources":["../../../src/search/hybrid.ts"],"names":[],"mappings":"AAmBA;;GAEG;AACH,MAAM,UAAU,YAAY,CAC1B,MAAmB,EACnB,KAAa,EACb,MAAc;IAEd,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC;IAEtC,2CAA2C;IAC3C,MAAM,QAAQ,GAAG,MAAM,CAAC,cAAc,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IAErD,2CAA2C;IAC3C,MAAM,OAAO,GAAmB,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE;QACpD,MAAM,QAAQ,GAAG,MAAM,CAAC,gBAAgB,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACpD,MAAM,QAAQ,GAAG,MAAM,CAAC,cAAc,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAElD,MAAM,SAAS,GAAG;YAChB,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;gBACpB,SAAS,EAAE,UAAmB;gBAC9B,QAAQ,EAAE,CAAC,CAAC,QAAQ;gBACpB,MAAM,EAAE,CAAC,CAAC,OAAO;gBACjB,UAAU,EAAE,CAAC,CAAC,OAAO;aACtB,CAAC,CAAC;YACH,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;gBACpB,SAAS,EAAE,UAAmB;gBAC9B,QAAQ,EAAE,CAAC,CAAC,QAAQ;gBACpB,MAAM,EAAE,CAAC,CAAC,SAAS;gBACnB,UAAU,EAAE,CAAC,CAAC,SAAS;aACxB,CAAC,CAAC;SACJ,CAAC;QAEF,OAAO;YACL,MAAM,EAAE;gBACN,EAAE,EAAE,MAAM,CAAC,EAAE;gBACb,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,UAAU,EAAE,MAAM,CAAC,UAAU;aAC9B;YACD,SAAS;SACV,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/src/search/natural-language.d.ts

@@ -0,0 +1,20 @@
+import type { Config } from '../config/schema.js';
+import { GraphEngine } from '../graph/engine.js';
+export interface NLQueryResult {
+    answer: string;
+    entities: Array<{
+        name: string;
+        type: string;
+    }>;
+    paths?: Array<{
+        path: string[];
+        relations: string[];
+    }>;
+    confidence: number;
+}
+/**
+ * Translate a natural language question into graph operations and return an answer.
+ * Uses pattern matching for common queries, falls back to entity-name extraction.
+ */
+export declare function naturalLanguageQuery(question: string, engine: GraphEngine, config: Config): Promise<NLQueryResult>;
+//# sourceMappingURL=natural-language.d.ts.map

package/dist/src/search/natural-language.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"natural-language.d.ts","sourceRoot":"","sources":["../../../src/search/natural-language.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAChD,KAAK,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,EAAE,CAAC;QAAC,SAAS,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;IACvD,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,CACxC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,WAAW,EACnB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,aAAa,CAAC,CAiGxB"}