agent-memory-graph 0.1.0

package/dist/src/sync/memory-md.js

@@ -0,0 +1,78 @@
+import { readFileSync, existsSync } from 'node:fs';
+import { extractFromText } from '../extract/extractor.js';
+/**
+ * Import entities and relationships from a MEMORY.md file.
+ * Splits the file into sections and extracts from each.
+ */
+export async function importFromMemoryMd(filePath, engine, config) {
+    if (!existsSync(filePath)) {
+        throw new Error(`File not found: ${filePath}`);
+    }
+    const content = readFileSync(filePath, 'utf-8');
+    // Split into meaningful sections (by headers or double newlines)
+    const sections = splitIntoSections(content);
+    let totalEntities = 0;
+    let totalRelationships = 0;
+    for (const section of sections) {
+        if (section.trim().length < 20)
+            continue; // Skip tiny sections
+        try {
+            const result = await extractFromText(section, config);
+            // Store entities
+            for (const entity of result.entities) {
+                engine.addEntity(entity.name, entity.type, entity.properties ?? {}, {
+                    source: filePath,
+                    confidence: entity.confidence,
+                });
+                totalEntities++;
+            }
+            // Store relationships
+            for (const rel of result.relationships) {
+                engine.addRelation(rel.from, rel.relation, rel.to, {
+                    source: filePath,
+                    confidence: rel.confidence,
+                    fromType: rel.fromType,
+                    toType: rel.toType,
+                });
+                totalRelationships++;
+            }
+        }
+        catch (err) {
+            console.warn(`[agent-memory-graph] Failed to extract from section: ${err}`);
+        }
+    }
+    return { entities: totalEntities, relationships: totalRelationships };
+}
+/**
+ * Import from a directory of markdown files.
+ */
+export async function importFromDirectory(dirPath, engine, config) {
+    const { readdirSync, statSync } = await import('node:fs');
+    const { join } = await import('node:path');
+    let totalEntities = 0;
+    let totalRelationships = 0;
+    let fileCount = 0;
+    const entries = readdirSync(dirPath);
+    for (const entry of entries) {
+        const fullPath = join(dirPath, entry);
+        const stat = statSync(fullPath);
+        if (stat.isFile() && (entry.endsWith('.md') || entry.endsWith('.txt'))) {
+            const result = await importFromMemoryMd(fullPath, engine, config);
+            totalEntities += result.entities;
+            totalRelationships += result.relationships;
+            fileCount++;
+        }
+    }
+    return { entities: totalEntities, relationships: totalRelationships, files: fileCount };
+}
+// ─── Helpers ─────────────────────────────────────────────────────
+function splitIntoSections(content) {
+    // Split by markdown headers or double newlines
+    const sections = content.split(/(?=^#{1,3}\s)/m);
+    // If no headers found, split by double newlines
+    if (sections.length <= 1) {
+        return content.split(/\n\n+/).filter(s => s.trim().length > 0);
+    }
+    return sections.filter(s => s.trim().length > 0);
+}
+//# sourceMappingURL=memory-md.js.map

package/dist/src/sync/memory-md.js.map

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

package/openclaw.plugin.json

@@ -0,0 +1,55 @@
+{
+  "id": "memory-graph",
+  "name": "Memory Graph",
+  "description": "Auto-builds a knowledge graph from conversations. Extracts entities and relationships from every message, stores in local SQLite, and exposes query/search/path tools to the agent.",
+  "contracts": {
+    "tools": ["memory_graph_query", "memory_graph_ingest", "memory_graph_search", "memory_graph_path", "memory_graph_stats"]
+  },
+  "activation": {
+    "onStartup": true
+  },
+  "configSchema": {
+    "type": "object",
+    "properties": {
+      "dbPath": {
+        "type": "string",
+        "description": "Path to SQLite database file",
+        "default": "~/.openclaw/data/memory-graph.db"
+      },
+      "autoIngest": {
+        "type": "boolean",
+        "description": "Automatically extract entities from every inbound message",
+        "default": true
+      },
+      "minConfidence": {
+        "type": "number",
+        "description": "Minimum confidence threshold for extracted entities (0.0-1.0)",
+        "default": 0.7
+      },
+      "extractionModel": {
+        "type": "string",
+        "description": "Model to use for entity extraction (empty = use default agent model)",
+        "default": ""
+      },
+      "maxHops": {
+        "type": "number",
+        "description": "Maximum graph traversal hops for path queries",
+        "default": 3
+      },
+      "domains": {
+        "type": "array",
+        "description": "Optional domain hints to improve extraction accuracy",
+        "items": {
+          "type": "object",
+          "properties": {
+            "name": { "type": "string" },
+            "entityHints": { "type": "array", "items": { "type": "string" } },
+            "relationHints": { "type": "array", "items": { "type": "string" } }
+          }
+        },
+        "default": []
+      }
+    },
+    "additionalProperties": false
+  }
+}

package/package.json

@@ -0,0 +1,90 @@
+{
+  "name": "agent-memory-graph",
+  "version": "0.1.0",
+  "description": "Domain-agnostic knowledge graph memory for AI agents. Zero-config, local-first, SQLite-powered. Works as OpenClaw skill (CLI) or plugin (auto-hook).",
+  "type": "module",
+  "main": "dist/src/index.js",
+  "types": "dist/src/index.d.ts",
+  "bin": {
+    "memory-graph": "dist/cli/index.js"
+  },
+  "openclaw": {
+    "extensions": [
+      "./dist/plugin/entry.js"
+    ],
+    "compat": {
+      "pluginApi": ">=2026.3.24-beta.2",
+      "minGatewayVersion": "2026.3.24-beta.2"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "eslint src/",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "ai",
+    "agent",
+    "memory",
+    "knowledge-graph",
+    "graph-database",
+    "sqlite",
+    "llm",
+    "openclaw",
+    "openclaw-plugin",
+    "local-first",
+    "domain-agnostic"
+  ],
+  "author": "KLSGG",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/KLSGG/agent-memory-graph"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "better-sqlite3": "^11.7.0",
+    "nanoid": "^5.0.9",
+    "openai": "^4.78.0",
+    "zod": "^3.24.0"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.12",
+    "@types/node": "^22.10.0",
+    "typescript": "^5.7.0",
+    "vitest": "^3.0.0",
+    "eslint": "^9.0.0"
+  },
+  "peerDependencies": {
+    "openclaw": ">=2026.3.24-beta.2",
+    "@sinclair/typebox": ">=0.32.0",
+    "@anthropic-ai/sdk": ">=0.30.0"
+  },
+  "peerDependenciesMeta": {
+    "openclaw": {
+      "optional": true
+    },
+    "@sinclair/typebox": {
+      "optional": true
+    },
+    "@anthropic-ai/sdk": {
+      "optional": true
+    }
+  },
+  "files": [
+    "dist/",
+    "config/",
+    "openclaw.plugin.json",
+    "README.md",
+    "LICENSE"
+  ],
+  "homepage": "https://github.com/KLSGG/agent-memory-graph#readme",
+  "bugs": {
+    "url": "https://github.com/KLSGG/agent-memory-graph/issues"
+  }
+}