@susu-eng/gralkor 26.0.0

package/dist/server-manager.js

@@ -0,0 +1,238 @@
+import { execFile, spawn } from "node:child_process";
+import { existsSync, readdirSync } from "node:fs";
+import { mkdir, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+import { promisify } from "node:util";
+import { DEFAULT_LLM_PROVIDER, DEFAULT_LLM_MODEL, DEFAULT_EMBEDDER_PROVIDER, DEFAULT_EMBEDDER_MODEL } from "./config.js";
+const execFileAsync = promisify(execFile);
+const HEALTH_POLL_INTERVAL_MS = 500;
+const HEALTH_TIMEOUT_MS = 120_000;
+const MONITOR_INTERVAL_MS = 60_000;
+const STOP_GRACE_MS = 5_000;
+export function createServerManager(opts) {
+    let proc = null;
+    let monitorTimer;
+    async function start() {
+        if (proc)
+            return;
+        const bootStart = Date.now();
+        console.log("[gralkor] boot: starting...");
+        await mkdir(opts.dataDir, { recursive: true });
+        const venvDir = join(opts.dataDir, "venv");
+        const venvPython = join(venvDir, "bin", "python");
+        // Ensure uv is available
+        try {
+            await execFileAsync("uv", ["--version"]);
+        }
+        catch {
+            throw new Error("uv is required but not found on PATH. " +
+                "Install: curl -LsSf https://astral.sh/uv/install.sh | sh");
+        }
+        // Sync Python environment
+        const syncEnv = {
+            ...process.env,
+            UV_PROJECT_ENVIRONMENT: venvDir,
+        };
+        console.log("[gralkor] boot: syncing python env...");
+        await execFileAsync("uv", ["sync", "--no-dev", "--frozen", "--directory", opts.serverDir], { env: syncEnv, timeout: 300_000 });
+        console.log("[gralkor] boot: python env ready");
+        // Force-install bundled wheels to override broken PyPI packages.
+        // UV_FIND_LINKS doesn't work with `uv sync --frozen` (lockfile hash
+        // verification rejects locally-built wheels), so we use a separate
+        // `uv pip install` step that bypasses the lockfile entirely.
+        const wheelsDir = join(opts.serverDir, "wheels");
+        if (existsSync(wheelsDir)) {
+            const wheelPaths = readdirSync(wheelsDir)
+                .filter((f) => f.endsWith(".whl"))
+                .map((f) => join(wheelsDir, f));
+            for (const wheelPath of wheelPaths) {
+                try {
+                    console.log("[gralkor] Installing bundled wheel:", wheelPath);
+                    await execFileAsync("uv", ["pip", "install", "--reinstall", "--no-deps", wheelPath, "--python", venvPython], { timeout: 60_000 });
+                }
+                catch {
+                    // Wheel might not be compatible with this platform (e.g. arm64
+                    // wheel on a macOS dev machine) — that's OK, uv sync already
+                    // installed compatible packages from PyPI.
+                    console.log("[gralkor] Bundled wheel not compatible, using PyPI version");
+                }
+            }
+        }
+        // Write dynamic config.yaml from plugin settings (with defaults)
+        const configPath = join(opts.dataDir, "config.yaml");
+        let configYaml = [
+            "llm:",
+            `  provider: "${opts.llmConfig?.provider ?? DEFAULT_LLM_PROVIDER}"`,
+            `  model: "${opts.llmConfig?.model ?? DEFAULT_LLM_MODEL}"`,
+            "embedder:",
+            `  provider: "${opts.embedderConfig?.provider ?? DEFAULT_EMBEDDER_PROVIDER}"`,
+            `  model: "${opts.embedderConfig?.model ?? DEFAULT_EMBEDDER_MODEL}"`,
+            "",
+        ].join("\n");
+        if (opts.test) {
+            configYaml += "test: true\n";
+        }
+        if (opts.ontologyConfig) {
+            configYaml += serializeOntologyYaml(opts.ontologyConfig);
+        }
+        await writeFile(configPath, configYaml, "utf-8");
+        const env = {
+            ...process.env,
+            ...opts.env,
+            FALKORDB_DATA_DIR: join(opts.dataDir, "falkordb"),
+            CONFIG_PATH: configPath,
+        };
+        // Do NOT set FALKORDB_URI — its absence triggers embedded FalkorDBLite mode
+        delete env.FALKORDB_URI;
+        console.log("[gralkor] Starting Graphiti server on port", opts.port);
+        proc = spawn(venvPython, ["-m", "uvicorn", "main:app", "--host", "127.0.0.1", "--port", String(opts.port), "--no-access-log"], {
+            cwd: opts.serverDir,
+            env,
+            stdio: ["ignore", "pipe", "pipe"],
+        });
+        // Forward stdout/stderr
+        proc.stdout?.on("data", (data) => {
+            for (const line of data.toString().split("\n").filter(Boolean)) {
+                console.log("[gralkor] [server]", line);
+            }
+        });
+        proc.stderr?.on("data", (data) => {
+            for (const line of data.toString().split("\n").filter(Boolean)) {
+                console.log("[gralkor] [server]", line);
+            }
+        });
+        proc.on("exit", (code, signal) => {
+            console.log("[gralkor] Server process exited — code:", code, "signal:", signal);
+            proc = null;
+        });
+        // Wait for server to become healthy
+        await waitForHealth(opts.port);
+        console.log("[gralkor] boot: server healthy");
+        const bootDuration = ((Date.now() - bootStart) / 1000).toFixed(1);
+        console.log(`[gralkor] boot: ready (${bootDuration}s)`);
+        // Start health monitor
+        monitorTimer = setInterval(async () => {
+            try {
+                const res = await fetch(`http://127.0.0.1:${opts.port}/health`);
+                await res.text(); // Drain response body to prevent memory leak
+                if (!res.ok) {
+                    console.warn("[gralkor] Server health check returned", res.status);
+                }
+            }
+            catch (err) {
+                console.warn("[gralkor] Server health check failed:", err instanceof Error ? err.message : err);
+            }
+        }, MONITOR_INTERVAL_MS);
+    }
+    async function stop() {
+        if (monitorTimer) {
+            clearInterval(monitorTimer);
+            monitorTimer = undefined;
+        }
+        if (!proc)
+            return;
+        const child = proc;
+        proc = null;
+        // Try graceful SIGTERM first
+        child.kill("SIGTERM");
+        await new Promise((resolve) => {
+            const forceKill = setTimeout(() => {
+                child.kill("SIGKILL");
+                resolve();
+            }, STOP_GRACE_MS);
+            child.on("exit", () => {
+                clearTimeout(forceKill);
+                resolve();
+            });
+        });
+    }
+    function isRunning() {
+        return proc !== null;
+    }
+    return { start, stop, isRunning };
+}
+function yamlQuote(s) {
+    if (/[:#{}[\]|>&*!%@`]/.test(s) || s !== s.trim()) {
+        return `"${s.replace(/\\/g, "\\\\").replace(/"/g, '\\"')}"`;
+    }
+    return `"${s}"`;
+}
+function serializeAttrValue(attr, indent) {
+    if (typeof attr === "string") {
+        return ` ${yamlQuote(attr)}`;
+    }
+    if (Array.isArray(attr)) {
+        return "\n" + attr.map((v) => `${indent}  - ${yamlQuote(v)}`).join("\n");
+    }
+    if ("enum" in attr) {
+        const lines = [
+            `\n${indent}  enum:`,
+            ...attr.enum.map((v) => `${indent}    - ${yamlQuote(v)}`),
+            `${indent}  description: ${yamlQuote(attr.description)}`,
+        ];
+        return lines.join("\n");
+    }
+    // { type, description }
+    return [
+        "",
+        `${indent}  type: ${yamlQuote(attr.type)}`,
+        `${indent}  description: ${yamlQuote(attr.description)}`,
+    ].join("\n");
+}
+function serializeTypeDefs(defs, indent) {
+    const lines = [];
+    for (const [name, def] of Object.entries(defs)) {
+        lines.push(`${indent}${name}:`);
+        lines.push(`${indent}  description: ${yamlQuote(def.description)}`);
+        if (def.attributes && Object.keys(def.attributes).length > 0) {
+            lines.push(`${indent}  attributes:`);
+            for (const [attr, val] of Object.entries(def.attributes)) {
+                lines.push(`${indent}    ${attr}:${serializeAttrValue(val, `${indent}    `)}`);
+            }
+        }
+    }
+    return lines;
+}
+export function serializeOntologyYaml(ontology) {
+    const lines = ["ontology:"];
+    if (ontology.entities && Object.keys(ontology.entities).length > 0) {
+        lines.push("  entities:");
+        lines.push(...serializeTypeDefs(ontology.entities, "    "));
+    }
+    if (ontology.edges && Object.keys(ontology.edges).length > 0) {
+        lines.push("  edges:");
+        lines.push(...serializeTypeDefs(ontology.edges, "    "));
+    }
+    if (ontology.edgeMap && Object.keys(ontology.edgeMap).length > 0) {
+        lines.push("  edgeMap:");
+        for (const [key, values] of Object.entries(ontology.edgeMap)) {
+            lines.push(`    ${yamlQuote(key)}:`);
+            for (const v of values) {
+                lines.push(`      - ${yamlQuote(v)}`);
+            }
+        }
+    }
+    if (ontology.excludedEntityTypes && ontology.excludedEntityTypes.length > 0) {
+        lines.push("  excludedEntityTypes:");
+        for (const name of ontology.excludedEntityTypes) {
+            lines.push(`    - ${yamlQuote(name)}`);
+        }
+    }
+    return lines.join("\n") + "\n";
+}
+async function waitForHealth(port) {
+    const deadline = Date.now() + HEALTH_TIMEOUT_MS;
+    while (Date.now() < deadline) {
+        try {
+            const res = await fetch(`http://127.0.0.1:${port}/health`);
+            if (res.ok)
+                return;
+        }
+        catch {
+            // not ready yet
+        }
+        await new Promise((r) => setTimeout(r, HEALTH_POLL_INTERVAL_MS));
+    }
+    throw new Error(`Graphiti server did not become healthy within ${HEALTH_TIMEOUT_MS / 1000}s`);
+}
+//# sourceMappingURL=server-manager.js.map

package/dist/server-manager.js.map

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

package/dist/tools.d.ts

@@ -0,0 +1,32 @@
+import type { GraphitiClient, Fact } from "./client.js";
+import type { GralkorConfig, ReadyGate } from "./config.js";
+export declare const INTERPRETATION_INSTRUCTION: string;
+export declare function formatFact(f: Fact): string;
+export declare function formatFacts(facts: Fact[]): string;
+export interface StoreToolOpts {
+    getGroupId?: () => string;
+    serverReady?: ReadyGate;
+}
+export declare function createMemoryStoreTool(client: GraphitiClient, config: GralkorConfig, opts?: StoreToolOpts): {
+    name: string;
+    description: string;
+    parameters: {
+        type: "object";
+        properties: {
+            content: {
+                type: "string";
+                description: string;
+            };
+            source_description: {
+                type: "string";
+                description: string;
+            };
+        };
+        required: readonly ["content"];
+    };
+    execute(_toolCallId: string, args: {
+        content: string;
+        source_description?: string;
+    }): Promise<string>;
+};
+//# sourceMappingURL=tools.d.ts.map

package/dist/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE5D,eAAO,MAAM,0BAA0B,QAEkC,CAAC;AAE1E,wBAAgB,UAAU,CAAC,CAAC,EAAE,IAAI,GAAG,MAAM,CAM1C;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,MAAM,CAIjD;AAED,MAAM,WAAW,aAAa;IAC5B,UAAU,CAAC,EAAE,MAAM,MAAM,CAAC;IAC1B,WAAW,CAAC,EAAE,SAAS,CAAC;CACzB;AAED,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,aAAa,EACrB,IAAI,GAAE,aAAkB;;;;;;;;;;;;;;;;;yBAsBP,MAAM,QACb;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,kBAAkB,CAAC,EAAE,MAAM,CAAA;KAAE,GACrD,OAAO,CAAC,MAAM,CAAC;EAwBrB"}

package/dist/tools.js

@@ -0,0 +1,56 @@
+export const INTERPRETATION_INSTRUCTION = "Before responding, interpret these facts for relevance to the task at hand. " +
+    "Doing this step thoughtfully improves response quality significantly.";
+export function formatFact(f) {
+    const createdAt = f.created_at ? ` (created ${f.created_at})` : "";
+    const validAt = f.valid_at ? ` (valid from ${f.valid_at})` : "";
+    const invalidAt = f.invalid_at ? ` (invalid since ${f.invalid_at})` : "";
+    const expiredAt = f.expired_at ? ` (expired ${f.expired_at})` : "";
+    return `- ${f.fact}${createdAt}${validAt}${invalidAt}${expiredAt}`;
+}
+export function formatFacts(facts) {
+    if (facts.length === 0)
+        return "No graph facts found.";
+    const lines = facts.map(formatFact).join("\n");
+    return `Facts (knowledge graph):\n${lines}`;
+}
+export function createMemoryStoreTool(client, config, opts = {}) {
+    const { getGroupId, serverReady } = opts;
+    return {
+        name: "memory_add",
+        description: "Store a thought, insight, reflection, or decision in memory. Conversations are already captured automatically — use this for higher-level reasoning, conclusions, and connections you want to preserve, not for recording what was said.",
+        parameters: {
+            type: "object",
+            properties: {
+                content: {
+                    type: "string",
+                    description: "The information to store in memory",
+                },
+                source_description: {
+                    type: "string",
+                    description: "Optional description of where this information came from",
+                },
+            },
+            required: ["content"],
+        },
+        async execute(_toolCallId, args) {
+            if (serverReady && !serverReady.isReady()) {
+                throw new Error(`[gralkor] memory_add failed: server is not ready`);
+            }
+            const groupId = getGroupId?.() ?? "default";
+            console.log(`[gralkor] memory_add storing — groupId:${groupId} bodySize:${args.content.length}`);
+            if (config.test) {
+                console.log(`[gralkor] [test] episode body:\n${args.content}`);
+            }
+            await client.addEpisode({
+                name: `memory-store-${Date.now()}`,
+                episode_body: args.content,
+                source_description: args.source_description ?? "manual memory_store",
+                group_id: groupId,
+                source: "text",
+            });
+            console.log(`[gralkor] memory_add stored — groupId:${groupId}`);
+            return "Stored successfully. The knowledge graph will extract entities and relationships from this content.";
+        },
+    };
+}
+//# sourceMappingURL=tools.js.map

package/dist/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,MAAM,0BAA0B,GACrC,8EAA8E;IAC9E,uEAAuE,CAAC;AAE1E,MAAM,UAAU,UAAU,CAAC,CAAO;IAChC,MAAM,SAAS,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IACnE,MAAM,OAAO,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IAChE,MAAM,SAAS,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IACzE,MAAM,SAAS,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IACnE,OAAO,KAAK,CAAC,CAAC,IAAI,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,GAAG,SAAS,EAAE,CAAC;AACrE,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAa;IACvC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,uBAAuB,CAAC;IACvD,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC/C,OAAO,6BAA6B,KAAK,EAAE,CAAC;AAC9C,CAAC;AAOD,MAAM,UAAU,qBAAqB,CACnC,MAAsB,EACtB,MAAqB,EACrB,OAAsB,EAAE;IAExB,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,GAAG,IAAI,CAAC;IACzC,OAAO;QACL,IAAI,EAAE,YAAY;QAClB,WAAW,EACT,0OAA0O;QAC5O,UAAU,EAAE;YACV,IAAI,EAAE,QAAiB;YACvB,UAAU,EAAE;gBACV,OAAO,EAAE;oBACP,IAAI,EAAE,QAAiB;oBACvB,WAAW,EAAE,oCAAoC;iBAClD;gBACD,kBAAkB,EAAE;oBAClB,IAAI,EAAE,QAAiB;oBACvB,WAAW,EAAE,0DAA0D;iBACxE;aACF;YACD,QAAQ,EAAE,CAAC,SAAS,CAAU;SAC/B;QACD,KAAK,CAAC,OAAO,CACX,WAAmB,EACnB,IAAsD;YAEtD,IAAI,WAAW,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,EAAE,CAAC;gBAC1C,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;YACtE,CAAC;YAED,MAAM,OAAO,GAAG,UAAU,EAAE,EAAE,IAAI,SAAS,CAAC;YAC5C,OAAO,CAAC,GAAG,CAAC,0CAA0C,OAAO,aAAa,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;YAEjG,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;gBAChB,OAAO,CAAC,GAAG,CAAC,mCAAmC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;YACjE,CAAC;YAED,MAAM,MAAM,CAAC,UAAU,CAAC;gBACtB,IAAI,EAAE,gBAAgB,IAAI,CAAC,GAAG,EAAE,EAAE;gBAClC,YAAY,EAAE,IAAI,CAAC,OAAO;gBAC1B,kBAAkB,EAAE,IAAI,CAAC,kBAAkB,IAAI,qBAAqB;gBACpE,QAAQ,EAAE,OAAO;gBACjB,MAAM,EAAE,MAAM;aACf,CAAC,CAAC;YAEH,OAAO,CAAC,GAAG,CAAC,yCAAyC,OAAO,EAAE,CAAC,CAAC;YAChE,OAAO,qGAAqG,CAAC;QAC/G,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,48 @@
+/**
+ * OpenClaw plugin API surface used by Gralkor.
+ *
+ * OpenClaw doesn't export types, so we define the subset we use here.
+ * Keep in sync with the OpenClaw plugin contract documented in CLAUDE.md.
+ */
+type AnyFn = (...args: any[]) => any;
+/**
+ * Minimal API surface used by shared registration code (hooks, health, CLI).
+ */
+export interface PluginApiBase {
+    /** Plugin-specific config from plugins.entries.<id>.config, validated against configSchema */
+    pluginConfig?: Record<string, unknown>;
+    on(event: string, handler: AnyFn): void;
+    registerService(service: {
+        id: string;
+        start: () => void | Promise<void>;
+        stop: () => void | Promise<void>;
+    }): void;
+    registerCli(registrar: (ctx: {
+        program: any;
+        config: any;
+        workspaceDir?: string;
+        logger: any;
+    }) => void | Promise<void>, opts?: {
+        commands?: string[];
+    }): void;
+}
+/**
+ * Memory-mode API — adds tool registration.
+ *
+ * registerTool is overloaded: accepts both plain tool objects and factory functions.
+ */
+export interface MemoryPluginApi extends PluginApiBase {
+    registerTool(tool: {
+        name: string;
+        description: string;
+        parameters: unknown;
+        execute: AnyFn;
+    }, opts?: {
+        optional?: boolean;
+    }): void;
+    registerTool(factory: (ctx: any) => any | any[] | null, opts?: {
+        names?: string[];
+    }): void;
+}
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,KAAK,KAAK,GAAG,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAC;AAErC;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,8FAA8F;IAC9F,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,GAAG,IAAI,CAAC;IACxC,eAAe,CAAC,OAAO,EAAE;QACvB,EAAE,EAAE,MAAM,CAAC;QACX,KAAK,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QAClC,IAAI,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;KAClC,GAAG,IAAI,CAAC;IACT,WAAW,CACT,SAAS,EAAE,CAAC,GAAG,EAAE;QAEf,OAAO,EAAE,GAAG,CAAC;QAEb,MAAM,EAAE,GAAG,CAAC;QACZ,YAAY,CAAC,EAAE,MAAM,CAAC;QAEtB,MAAM,EAAE,GAAG,CAAC;KACb,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,EAC1B,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,GAC7B,IAAI,CAAC;CACT;AAED;;;;GAIG;AACH,MAAM,WAAW,eAAgB,SAAQ,aAAa;IAEpD,YAAY,CACV,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,KAAK,CAAA;KAAE,EAChF,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,GAC5B,IAAI,CAAC;IAER,YAAY,CAEV,OAAO,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,GAAG,GAAG,GAAG,EAAE,GAAG,IAAI,EACzC,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,GAC1B,IAAI,CAAC;CACT"}

package/dist/types.js

@@ -0,0 +1,8 @@
+/**
+ * OpenClaw plugin API surface used by Gralkor.
+ *
+ * OpenClaw doesn't export types, so we define the subset we use here.
+ * Keep in sync with the OpenClaw plugin contract documented in CLAUDE.md.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/docker-compose.yml

@@ -0,0 +1,34 @@
+services:
+  falkordb:
+    image: falkordb/falkordb:latest
+    restart: unless-stopped
+    ports:
+      - "6379:6379"
+      - "3000:3000"
+    volumes:
+      - ${FALKORDB_DATA_DIR:-falkordb_data}:/var/lib/falkordb/data
+    networks:
+      - gralkor
+
+  graphiti:
+    image: gralkor-server:latest
+    restart: unless-stopped
+    ports:
+      - "8001:8001"
+    env_file:
+      - .env
+    environment:
+      FALKORDB_URI: redis://falkordb:6379
+    volumes:
+      - ./config.yaml:/app/config.yaml:ro
+    depends_on:
+      - falkordb
+    networks:
+      - gralkor
+
+networks:
+  gralkor:
+    name: gralkor
+
+volumes:
+  falkordb_data:

package/openclaw.plugin.json

@@ -0,0 +1,99 @@
+{
+  "id": "gralkor",
+  "kind": "memory",
+  "name": "Gralkor Memory",
+  "description": "Persistent, temporally-aware memory via Graphiti knowledge graphs and FalkorDB",
+  "configSchema": {
+    "type": "object",
+    "properties": {
+      "autoCapture": {
+        "type": "object",
+        "properties": {
+          "enabled": {
+            "type": "boolean",
+            "default": true,
+            "description": "Automatically capture conversations into the graph"
+          }
+        }
+      },
+      "autoRecall": {
+        "type": "object",
+        "properties": {
+          "enabled": {
+            "type": "boolean",
+            "default": true,
+            "description": "Automatically recall relevant context before agent runs"
+          },
+          "maxResults": {
+            "type": "number",
+            "default": 10,
+            "description": "Maximum number of facts to inject as context"
+          }
+        }
+      },
+      "llm": {
+        "type": "object",
+        "properties": {
+          "provider": {
+            "type": "string",
+            "description": "LLM provider for knowledge extraction (openai, anthropic, gemini, groq)"
+          },
+          "model": {
+            "type": "string",
+            "description": "LLM model name (e.g. gpt-4.1-mini, gemini-2.0-flash)"
+          }
+        }
+      },
+      "embedder": {
+        "type": "object",
+        "properties": {
+          "provider": {
+            "type": "string",
+            "description": "Embedding provider (openai, gemini)"
+          },
+          "model": {
+            "type": "string",
+            "description": "Embedding model name (e.g. text-embedding-3-small)"
+          }
+        }
+      },
+      "test": {
+        "type": "boolean",
+        "default": false,
+        "description": "Enable test mode — logs full episode bodies and search results for debugging"
+      }
+    }
+  },
+  "tools": [
+    "memory_search",
+    "memory_get",
+    "memory_add"
+  ],
+  "uiHints": {
+    "autoCapture.enabled": {
+      "label": "Auto-capture conversations"
+    },
+    "autoRecall.enabled": {
+      "label": "Auto-recall context"
+    },
+    "autoRecall.maxResults": {
+      "label": "Max auto-recall results"
+    },
+    "llm.provider": {
+      "label": "LLM provider"
+    },
+    "llm.model": {
+      "label": "LLM model"
+    },
+    "embedder.provider": {
+      "label": "Embedding provider"
+    },
+    "embedder.model": {
+      "label": "Embedding model"
+    },
+    "test": {
+      "label": "Test mode (verbose logging)"
+    }
+  },
+  "version": "26.0.0"
+}

package/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "@susu-eng/gralkor",
+  "version": "26.0.0",
+  "description": "OpenClaw memory plugin powered by Graphiti knowledge graphs and FalkorDB",
+  "type": "module",
+  "main": "./dist/index.js",
+  "bin": {
+    "gralkor": "./dist/cli/bin.js"
+  },
+  "openclaw": {
+    "extensions": [
+      "./dist/index.js"
+    ]
+  },
+  "files": [
+    "dist",
+    "server/Dockerfile",
+    "server/main.py",
+    "server/pyproject.toml",
+    "server/uv.lock",
+    "server/requirements.txt",
+    "server/wheels",
+    "openclaw.plugin.json",
+    "docker-compose.yml",
+    "config.yaml",
+    ".env.example"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/susu-eng/gralkor.git"
+  },
+  "homepage": "https://github.com/susu-eng/gralkor#readme",
+  "bugs": {
+    "url": "https://github.com/susu-eng/gralkor/issues"
+  },
+  "author": "susu-eng",
+  "keywords": [
+    "openclaw",
+    "openclaw-plugin",
+    "graphiti",
+    "falkordb",
+    "knowledge-graph",
+    "memory",
+    "ai-agent"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "peerDependencies": {
+    "openclaw": ">= 2026.1.26"
+  },
+  "devDependencies": {
+    "@types/node": "^25.0.0",
+    "typescript": "^5.7.0",
+    "vitest": "^3.0.0"
+  },
+  "license": "MIT",
+  "scripts": {
+    "build": "tsc",
+    "publish:npm": "bash scripts/publish.sh"
+  }
+}

package/server/Dockerfile

@@ -0,0 +1,7 @@
+FROM python:3.12-slim
+WORKDIR /app
+COPY requirements.txt .
+RUN pip install --no-cache-dir -r requirements.txt
+COPY main.py .
+EXPOSE 8001
+CMD ["uvicorn", "main:app", "--host", "0.0.0.0", "--port", "8001"]