@susu-eng/gralkor 26.0.0

package/dist/index.js

@@ -0,0 +1,184 @@
+import { fileURLToPath } from "node:url";
+import { dirname, join } from "node:path";
+import { GraphitiClient } from "./client.js";
+import { resolveConfig, validateOntologyConfig, GRAPHITI_URL, resolveProviders, createReadyGate, defaultConfig } from "./config.js";
+import { createMemoryStoreTool, formatFacts, INTERPRETATION_INSTRUCTION, } from "./tools.js";
+import { registerHooks, registerServerService, registerCli, } from "./register.js";
+import { countNativeResults } from "./hooks.js";
+import { searchNativeMemory, readNativeMemoryFile } from "./native-memory.js";
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const pluginDir = join(__dirname, ".."); // dist/ → plugin root
+// OpenClaw calls register() 4+ times per event; only log config once
+let configLogged = false;
+// Guard against duplicate SIGTERM handlers across multiple register() calls
+let sigTermHandlerInstalled = false;
+function registerFullPlugin(api, client, config, dir) {
+    const serverReady = createReadyGate();
+    // Shared group ID: hooks capture agentId, tools read it
+    let currentGroupId = "default";
+    const getGroupId = () => currentGroupId;
+    const setGroupId = (id) => { currentGroupId = id; };
+    // Shared native search function: factory sets it at agent start, hook reads it
+    let nativeSearchFn = null;
+    const getNativeSearch = () => nativeSearchFn;
+    // Native memory tools via OpenClaw memory SDK (getMemorySearchManager)
+    // The factory provides ctx.config and ctx.sessionKey at agent start
+    api.registerTool(
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    (ctx) => {
+        // Capture native search function for the auto-recall hook
+        nativeSearchFn = async (query) => {
+            return (await searchNativeMemory(ctx.config, getGroupId(), query, { sessionKey: ctx.sessionKey })) ?? "";
+        };
+        // memory_search: combines native Markdown + graph facts
+        const memorySearchTool = {
+            name: "memory_search",
+            description: "Search memory for relevant context. Use specific, focused queries.",
+            parameters: {
+                type: "object",
+                properties: {
+                    query: { type: "string" },
+                    limit: { type: "number" },
+                },
+                required: ["query"],
+            },
+            async execute(toolCallId, args) {
+                const groupId = getGroupId();
+                const limit = args.limit ?? 10;
+                if (!serverReady.isReady()) {
+                    throw new Error("[gralkor] memory_search failed: server is not ready");
+                }
+                const [nativeResult, searchResults] = await Promise.all([
+                    searchNativeMemory(ctx.config, groupId, args.query, {
+                        maxResults: limit,
+                        sessionKey: ctx.sessionKey,
+                    }),
+                    client.search(args.query, [groupId], limit),
+                ]);
+                const factCount = searchResults.facts.length;
+                const nativeCount = countNativeResults(nativeResult);
+                console.log(`[gralkor] memory_search result — graph: ${factCount} facts, native: ${nativeCount} results — groupId:${groupId}`);
+                const sections = [];
+                if (nativeCount > 0) {
+                    sections.push(nativeResult);
+                }
+                if (searchResults.facts.length > 0) {
+                    sections.push(formatFacts(searchResults.facts));
+                }
+                if (sections.length === 0) {
+                    return "No memories found.";
+                }
+                sections.push(INTERPRETATION_INSTRUCTION);
+                const combinedResult = sections.join("\n\n");
+                if (config.test) {
+                    console.log(`[gralkor] [test] memory_search query: ${args.query}`);
+                    console.log(`[gralkor] [test] memory_search result:\n${combinedResult}`);
+                }
+                return combinedResult;
+            },
+        };
+        // memory_get: reads native Markdown memory files via SDK
+        const memoryGetTool = {
+            name: "memory_get",
+            description: "Read a memory file by path with optional line range. Use after memory_search to pull specific sections.",
+            parameters: {
+                type: "object",
+                properties: {
+                    path: { type: "string" },
+                    from: { type: "number" },
+                    lines: { type: "number" },
+                },
+                required: ["path"],
+            },
+            async execute(_toolCallId, args) {
+                return readNativeMemoryFile(ctx.config, getGroupId(), args.path, {
+                    from: args.from,
+                    lines: args.lines,
+                });
+            },
+        };
+        return [memorySearchTool, memoryGetTool];
+    }, { names: ["memory_search", "memory_get"] });
+    const storeTool = createMemoryStoreTool(client, config, {
+        getGroupId,
+        serverReady,
+    });
+    api.registerTool(storeTool);
+    const debouncer = registerHooks(api, client, config, { setGroupId, getNativeSearch, serverReady });
+    // Flush pending session buffers on SIGTERM to prevent data loss on shutdown
+    if (!sigTermHandlerInstalled) {
+        sigTermHandlerInstalled = true;
+        process.on("SIGTERM", () => {
+            if (debouncer.pendingCount > 0) {
+                console.log(`[gralkor] SIGTERM received, flushing ${debouncer.pendingCount} pending session buffer(s)...`);
+                debouncer.flushAll().catch((err) => {
+                    console.error("[gralkor] SIGTERM flush failed:", err instanceof Error ? err.message : err);
+                });
+            }
+        });
+    }
+    const resolvedDataDir = config.dataDir ?? join(dir, "..", ".gralkor-data");
+    const manager = registerServerService(api, config, dir, serverReady);
+    // CLI — gralkor commands
+    registerCli(api, client, config, manager, resolvedDataDir);
+}
+export const id = "gralkor";
+export const name = "Gralkor Memory";
+export const description = "Persistent, temporally-aware memory via Graphiti knowledge graphs and FalkorDB";
+export const kind = "memory";
+export const tools = ["memory_search", "memory_get", "memory_add"];
+export const configSchema = {
+    type: "object",
+    properties: {
+        autoCapture: {
+            type: "object",
+            properties: {
+                enabled: { type: "boolean", default: defaultConfig.autoCapture.enabled },
+            },
+        },
+        autoRecall: {
+            type: "object",
+            properties: {
+                enabled: { type: "boolean", default: defaultConfig.autoRecall.enabled },
+                maxResults: { type: "number", default: defaultConfig.autoRecall.maxResults },
+            },
+        },
+        dataDir: {
+            type: "string",
+            description: "Directory for backend data (venv, database). Defaults to .gralkor-data alongside the plugin directory.",
+        },
+        test: {
+            type: "boolean",
+            default: false,
+            description: "Enable test mode — logs full episode bodies and search results for debugging.",
+        },
+    },
+};
+export function register(api) {
+    const config = resolveConfig((api.pluginConfig ?? {}));
+    validateOntologyConfig(config.ontology);
+    if (!configLogged) {
+        configLogged = true;
+        if (config.test) {
+            console.log(`[gralkor] raw pluginConfig: ${JSON.stringify(api.pluginConfig)}`);
+        }
+        const { llmProvider, llmModel, embedderProvider, embedderModel } = resolveProviders(config);
+        const ontologySummary = config.ontology
+            ? `${Object.keys(config.ontology.entities ?? {}).length} entities, ${Object.keys(config.ontology.edges ?? {}).length} edges`
+            : "none";
+        console.log(`[gralkor] config:` +
+            ` llm=${llmProvider}/${llmModel}` +
+            ` embedder=${embedderProvider}/${embedderModel}` +
+            ` ontology=${ontologySummary}` +
+            ` autoCapture=${config.autoCapture.enabled}` +
+            ` autoRecall=${config.autoRecall.enabled} maxResults=${config.autoRecall.maxResults}` +
+            ` idleTimeout=${config.idleTimeoutMs}ms` +
+            ` test=${config.test}` +
+            ` dataDir=${config.dataDir ?? 'default'}`);
+    }
+    const client = new GraphitiClient({ baseUrl: GRAPHITI_URL });
+    registerFullPlugin(api, client, config, pluginDir);
+}
+export default { id, name, description, kind, configSchema, register };
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/native-memory.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Native memory delegation — searches OpenClaw's built-in Markdown memory
+ * via the memory SDK. Lazy-loads SDK modules at runtime (not available at build time).
+ */
+export type MemorySDK = {
+    getMemorySearchManager: (params: {
+        cfg: unknown;
+        agentId: string;
+        purpose?: "default" | "status";
+    }) => Promise<{
+        manager: MemorySearchManager | null;
+        error?: string;
+    }>;
+    readAgentMemoryFile: (params: {
+        cfg: unknown;
+        agentId: string;
+        relPath: string;
+        from?: number;
+        lines?: number;
+    }) => Promise<{
+        text: string;
+        path: string;
+    }>;
+};
+export interface MemorySearchManager {
+    search(query: string, opts?: {
+        maxResults?: number;
+        minScore?: number;
+        sessionKey?: string;
+    }): Promise<Array<{
+        path: string;
+        startLine: number;
+        endLine: number;
+        score: number;
+        snippet: string;
+        source: string;
+    }>>;
+    readFile(params: {
+        relPath: string;
+        from?: number;
+        lines?: number;
+    }): Promise<{
+        text: string;
+        path: string;
+    }>;
+}
+/** Replace the SDK loader (for testing). */
+export declare function setSDKLoader(loader: () => Promise<MemorySDK>): void;
+/** Reset to the default SDK loader (for testing). */
+export declare function resetSDKLoader(): void;
+/**
+ * Search native Markdown memory via the OpenClaw memory SDK.
+ * Returns JSON string matching memory-core's output format ({ results: [...] })
+ * so countNativeResults() can parse it.
+ */
+export declare function searchNativeMemory(cfg: any, agentId: string, query: string, opts?: {
+    maxResults?: number;
+    sessionKey?: string;
+}): Promise<string | null>;
+/**
+ * Read a native memory file via the OpenClaw memory SDK.
+ */
+export declare function readNativeMemoryFile(cfg: any, agentId: string, relPath: string, opts?: {
+    from?: number;
+    lines?: number;
+}): Promise<string>;
+//# sourceMappingURL=native-memory.d.ts.map

package/dist/native-memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-memory.d.ts","sourceRoot":"","sources":["../src/native-memory.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,SAAS,GAAG;IACtB,sBAAsB,EAAE,CAAC,MAAM,EAAE;QAC/B,GAAG,EAAE,OAAO,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,SAAS,GAAG,QAAQ,CAAC;KAChC,KAAK,OAAO,CAAC;QAAE,OAAO,EAAE,mBAAmB,GAAG,IAAI,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACvE,mBAAmB,EAAE,CAAC,MAAM,EAAE;QAC5B,GAAG,EAAE,OAAO,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,KAAK,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC/C,CAAC;AAEF,MAAM,WAAW,mBAAmB;IAClC,MAAM,CACJ,KAAK,EAAE,MAAM,EACb,IAAI,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,GACrE,OAAO,CAAC,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAC;IACxH,QAAQ,CAAC,MAAM,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC/G;AAoBD,4CAA4C;AAC5C,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,OAAO,CAAC,SAAS,CAAC,GAAG,IAAI,CAGnE;AAED,qDAAqD;AACrD,wBAAgB,cAAc,IAAI,IAAI,CAGrC;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CAEtC,GAAG,EAAE,GAAG,EACR,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,IAAI,CAAC,EAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,GAClD,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAiBxB;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CAExC,GAAG,EAAE,GAAG,EACR,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GACvC,OAAO,CAAC,MAAM,CAAC,CAejB"}

package/dist/native-memory.js

@@ -0,0 +1,79 @@
+/**
+ * Native memory delegation — searches OpenClaw's built-in Markdown memory
+ * via the memory SDK. Lazy-loads SDK modules at runtime (not available at build time).
+ */
+let memorySDKPromise = null;
+function defaultLoadMemorySDK() {
+    // Dynamic import paths constructed to prevent TypeScript from resolving them
+    // at build time — these modules are provided by the OpenClaw host at runtime.
+    const sdkBase = "openclaw/plugin-sdk";
+    memorySDKPromise ??= Promise.all([
+        import(/* @vite-ignore */ `${sdkBase}/memory-core`),
+        import(/* @vite-ignore */ `${sdkBase}/memory-core-host-runtime-files`),
+    ]).then(([core, files]) => ({
+        getMemorySearchManager: core.getMemorySearchManager,
+        readAgentMemoryFile: files.readAgentMemoryFile,
+    }));
+    return memorySDKPromise;
+}
+let sdkLoader = defaultLoadMemorySDK;
+/** Replace the SDK loader (for testing). */
+export function setSDKLoader(loader) {
+    sdkLoader = loader;
+    memorySDKPromise = null;
+}
+/** Reset to the default SDK loader (for testing). */
+export function resetSDKLoader() {
+    sdkLoader = defaultLoadMemorySDK;
+    memorySDKPromise = null;
+}
+/**
+ * Search native Markdown memory via the OpenClaw memory SDK.
+ * Returns JSON string matching memory-core's output format ({ results: [...] })
+ * so countNativeResults() can parse it.
+ */
+export async function searchNativeMemory(
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+cfg, agentId, query, opts) {
+    try {
+        const { getMemorySearchManager } = await sdkLoader();
+        const { manager, error } = await getMemorySearchManager({ cfg, agentId });
+        if (!manager) {
+            if (error)
+                console.log(`[gralkor] native memory unavailable: ${error}`);
+            return null;
+        }
+        const results = await manager.search(query, {
+            maxResults: opts?.maxResults,
+            sessionKey: opts?.sessionKey,
+        });
+        return JSON.stringify({ results });
+    }
+    catch (err) {
+        console.log(`[gralkor] native memory search failed: ${err instanceof Error ? err.message : err}`);
+        return null;
+    }
+}
+/**
+ * Read a native memory file via the OpenClaw memory SDK.
+ */
+export async function readNativeMemoryFile(
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+cfg, agentId, relPath, opts) {
+    try {
+        const { readAgentMemoryFile } = await sdkLoader();
+        const result = await readAgentMemoryFile({
+            cfg,
+            agentId,
+            relPath,
+            from: opts?.from,
+            lines: opts?.lines,
+        });
+        return JSON.stringify(result);
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return JSON.stringify({ path: relPath, text: "", error: message });
+    }
+}
+//# sourceMappingURL=native-memory.js.map

package/dist/native-memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-memory.js","sourceRoot":"","sources":["../src/native-memory.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAyBH,IAAI,gBAAgB,GAA8B,IAAI,CAAC;AAEvD,SAAS,oBAAoB;IAC3B,6EAA6E;IAC7E,8EAA8E;IAC9E,MAAM,OAAO,GAAG,qBAAqB,CAAC;IACtC,gBAAgB,KAAK,OAAO,CAAC,GAAG,CAAC;QAC/B,MAAM,CAAC,kBAAkB,CAAC,GAAG,OAAO,cAAc,CAAC;QACnD,MAAM,CAAC,kBAAkB,CAAC,GAAG,OAAO,iCAAiC,CAAC;KACvE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;QAC1B,sBAAsB,EAAE,IAAI,CAAC,sBAAsB;QACnD,mBAAmB,EAAE,KAAK,CAAC,mBAAmB;KAC/C,CAAC,CAAC,CAAC;IACJ,OAAO,gBAAgB,CAAC;AAC1B,CAAC;AAED,IAAI,SAAS,GAA6B,oBAAoB,CAAC;AAE/D,4CAA4C;AAC5C,MAAM,UAAU,YAAY,CAAC,MAAgC;IAC3D,SAAS,GAAG,MAAM,CAAC;IACnB,gBAAgB,GAAG,IAAI,CAAC;AAC1B,CAAC;AAED,qDAAqD;AACrD,MAAM,UAAU,cAAc;IAC5B,SAAS,GAAG,oBAAoB,CAAC;IACjC,gBAAgB,GAAG,IAAI,CAAC;AAC1B,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB;AACtC,8DAA8D;AAC9D,GAAQ,EACR,OAAe,EACf,KAAa,EACb,IAAmD;IAEnD,IAAI,CAAC;QACH,MAAM,EAAE,sBAAsB,EAAE,GAAG,MAAM,SAAS,EAAE,CAAC;QACrD,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,MAAM,sBAAsB,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,CAAC;QAC1E,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,IAAI,KAAK;gBAAE,OAAO,CAAC,GAAG,CAAC,wCAAwC,KAAK,EAAE,CAAC,CAAC;YACxE,OAAO,IAAI,CAAC;QACd,CAAC;QACD,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE;YAC1C,UAAU,EAAE,IAAI,EAAE,UAAU;YAC5B,UAAU,EAAE,IAAI,EAAE,UAAU;SAC7B,CAAC,CAAC;QACH,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;IACrC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,GAAG,CAAC,0CAA0C,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;QAClG,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB;AACxC,8DAA8D;AAC9D,GAAQ,EACR,OAAe,EACf,OAAe,EACf,IAAwC;IAExC,IAAI,CAAC;QACH,MAAM,EAAE,mBAAmB,EAAE,GAAG,MAAM,SAAS,EAAE,CAAC;QAClD,MAAM,MAAM,GAAG,MAAM,mBAAmB,CAAC;YACvC,GAAG;YACH,OAAO;YACP,OAAO;YACP,IAAI,EAAE,IAAI,EAAE,IAAI;YAChB,KAAK,EAAE,IAAI,EAAE,KAAK;SACnB,CAAC,CAAC;QACH,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAChC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjE,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;IACrE,CAAC;AACH,CAAC"}

package/dist/register.d.ts

@@ -0,0 +1,10 @@
+import type { GraphitiClient } from "./client.js";
+import type { GralkorConfig, ReadyGate } from "./config.js";
+import { DebouncedFlush, type RecallOpts, type SessionBuffer } from "./hooks.js";
+import { type ServerManager } from "./server-manager.js";
+import type { PluginApiBase } from "./types.js";
+export type { ServerManager } from "./server-manager.js";
+export declare function registerHooks(api: PluginApiBase, client: GraphitiClient, config: GralkorConfig, opts?: RecallOpts): DebouncedFlush<SessionBuffer>;
+export declare function registerServerService(api: PluginApiBase, config: GralkorConfig, pluginDir: string, serverReady?: ReadyGate): ServerManager;
+export declare function registerCli(api: PluginApiBase, client: GraphitiClient, config: GralkorConfig, manager?: ServerManager, dataDir?: string): void;
+//# sourceMappingURL=register.d.ts.map

package/dist/register.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.d.ts","sourceRoot":"","sources":["../src/register.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE5D,OAAO,EAIL,cAAc,EAEd,KAAK,UAAU,EACf,KAAK,aAAa,EACnB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAuB,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAC9E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,YAAY,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD,wBAAgB,aAAa,CAC3B,GAAG,EAAE,aAAa,EAClB,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,aAAa,EACrB,IAAI,GAAE,UAAe,GACpB,cAAc,CAAC,aAAa,CAAC,CAU/B;AAED,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,aAAa,EAClB,MAAM,EAAE,aAAa,EACrB,SAAS,EAAE,MAAM,EACjB,WAAW,CAAC,EAAE,SAAS,GACtB,aAAa,CAgCf;AAED,wBAAgB,WAAW,CACzB,GAAG,EAAE,aAAa,EAClB,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,aAAa,EACrB,OAAO,CAAC,EAAE,aAAa,EACvB,OAAO,CAAC,EAAE,MAAM,QA2HjB"}

package/dist/register.js

@@ -0,0 +1,150 @@
+import { join } from "node:path";
+import { GRAPHITI_URL, GRAPHITI_PORT, validateConfig, resolveProviders } from "./config.js";
+import { createBeforePromptBuildHandler, createAgentEndHandler, createSessionEndHandler, DebouncedFlush, flushSessionBuffer, } from "./hooks.js";
+import { createServerManager } from "./server-manager.js";
+export function registerHooks(api, client, config, opts = {}) {
+    const debouncer = new DebouncedFlush(config.idleTimeoutMs, (key, buf) => flushSessionBuffer(key, buf, client, { test: config.test }));
+    api.on("before_prompt_build", createBeforePromptBuildHandler(client, config, opts));
+    api.on("agent_end", createAgentEndHandler(config, debouncer));
+    api.on("session_end", createSessionEndHandler(debouncer));
+    return debouncer;
+}
+export function registerServerService(api, config, pluginDir, serverReady) {
+    const dataDir = config.dataDir ?? join(pluginDir, "..", ".gralkor-data");
+    const serverDir = join(pluginDir, "server");
+    const env = {};
+    for (const key of ["OPENAI_API_KEY", "ANTHROPIC_API_KEY", "GOOGLE_API_KEY", "GROQ_API_KEY"]) {
+        if (process.env[key])
+            env[key] = process.env[key];
+    }
+    const manager = createServerManager({
+        dataDir,
+        serverDir,
+        port: GRAPHITI_PORT,
+        env,
+        llmConfig: config.llm,
+        embedderConfig: config.embedder,
+        ontologyConfig: config.ontology,
+        test: config.test,
+    });
+    api.registerService({
+        id: "gralkor-server",
+        async start() {
+            await manager.start();
+            serverReady?.resolve();
+        },
+        async stop() {
+            await manager.stop();
+        },
+    });
+    return manager;
+}
+export function registerCli(api, client, config, manager, dataDir) {
+    api.registerCli(({ program }) => {
+        const gralkor = program
+            .command("gralkor")
+            .description("Manage the Gralkor memory backend");
+        gralkor
+            .command("status")
+            .description("Check Graphiti and FalkorDB connection status")
+            .action(async () => {
+            // Process state
+            if (manager) {
+                console.log(`Server process: ${manager.isRunning() ? "running" : "stopped"}`);
+            }
+            // Config summary
+            const { llmProvider, llmModel, embedderProvider, embedderModel } = resolveProviders(config);
+            console.log(`LLM: ${llmProvider}/${llmModel}`);
+            console.log(`Embedder: ${embedderProvider}/${embedderModel}`);
+            console.log(`Auto-capture: ${config.autoCapture.enabled ? "enabled" : "disabled"}`);
+            console.log(`Auto-recall: ${config.autoRecall.enabled ? "enabled" : "disabled"} (max ${config.autoRecall.maxResults} results)`);
+            // Data directory
+            if (dataDir) {
+                console.log(`Data directory: ${dataDir}`);
+            }
+            // Server health + graph stats
+            try {
+                const result = await client.health();
+                console.log(`Graphiti: ${result.status ?? "reachable"} at ${GRAPHITI_URL}`);
+                if (result.graph) {
+                    if (result.graph.connected) {
+                        console.log(`FalkorDB: connected (${result.graph.node_count ?? 0} nodes, ${result.graph.edge_count ?? 0} edges)`);
+                    }
+                    else {
+                        console.log(`FalkorDB: disconnected — ${result.graph.error ?? "unknown error"}`);
+                    }
+                }
+            }
+            catch (err) {
+                console.error(`Graphiti: unreachable at ${GRAPHITI_URL} — ${err instanceof Error ? err.message : err}`);
+            }
+            // Venv state
+            if (dataDir) {
+                const venvPython = join(dataDir, "venv", "bin", "python");
+                try {
+                    const { execFile } = await import("node:child_process");
+                    const { promisify } = await import("node:util");
+                    const execFileAsync = promisify(execFile);
+                    await execFileAsync(venvPython, ["--version"]);
+                    console.log(`Python venv: ready`);
+                }
+                catch {
+                    console.log(`Python venv: not found`);
+                }
+            }
+        });
+        gralkor
+            .command("check")
+            .description("Validate Gralkor configuration and environment")
+            .action(async () => {
+            const result = await validateConfig(config);
+            for (const check of result.checks) {
+                const icon = check.status === "pass" ? "OK" : check.status === "warn" ? "WARN" : "FAIL";
+                console.log(`  [${icon}] ${check.label}: ${check.message}`);
+            }
+            if (!result.ok) {
+                console.error("\nConfiguration has errors. Fix the issues above before starting.");
+                process.exitCode = 1;
+            }
+            else {
+                console.log("\nConfiguration looks good.");
+            }
+        });
+        gralkor
+            .command("search <group_id> <query...>")
+            .description("Search the knowledge graph")
+            .action(async (groupId, query) => {
+            const q = query.join(" ");
+            try {
+                console.log(`Searching group "${groupId}" for: ${q}`);
+                const results = await client.search(q, [groupId], 10);
+                console.log(`Found ${results.facts.length} facts in group "${groupId}".`);
+                if (results.facts.length === 0) {
+                    console.log("No results found.");
+                    return;
+                }
+                console.log("Facts:\n" +
+                    results.facts.map((f) => {
+                        const validity = f.invalid_at ? ` (invalid since ${f.invalid_at})` : "";
+                        return `  - ${f.fact}${validity}`;
+                    }).join("\n"));
+            }
+            catch (err) {
+                console.error(`Search failed: ${err instanceof Error ? err.message : err}`);
+            }
+        });
+        gralkor
+            .command("clear <group_id>")
+            .description("Clear the knowledge graph for a group")
+            .action(async (groupId) => {
+            try {
+                await client.clearGraph(groupId);
+                console.log(`Cleared graph for group "${groupId}".`);
+            }
+            catch (err) {
+                console.error(`Clear failed: ${err instanceof Error ? err.message : err}`);
+            }
+        });
+    }, { commands: ["gralkor"] });
+}
+//# sourceMappingURL=register.js.map

package/dist/register.js.map

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

package/dist/server-manager.d.ts

@@ -0,0 +1,19 @@
+import { type ModelConfig, type OntologyConfig } from "./config.js";
+export interface ServerManagerOptions {
+    dataDir: string;
+    serverDir: string;
+    port: number;
+    env?: Record<string, string>;
+    llmConfig?: ModelConfig;
+    embedderConfig?: ModelConfig;
+    ontologyConfig?: OntologyConfig;
+    test?: boolean;
+}
+export interface ServerManager {
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    isRunning(): boolean;
+}
+export declare function createServerManager(opts: ServerManagerOptions): ServerManager;
+export declare function serializeOntologyYaml(ontology: OntologyConfig): string;
+//# sourceMappingURL=server-manager.d.ts.map

package/dist/server-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-manager.d.ts","sourceRoot":"","sources":["../src/server-manager.ts"],"names":[],"mappings":"AAKA,OAAO,EAA8F,KAAK,WAAW,EAAE,KAAK,cAAc,EAA+B,MAAM,aAAa,CAAC;AAS7L,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,SAAS,CAAC,EAAE,WAAW,CAAC;IACxB,cAAc,CAAC,EAAE,WAAW,CAAC;IAC7B,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,SAAS,IAAI,OAAO,CAAC;CACtB;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,oBAAoB,GAAG,aAAa,CAkL7E;AAkDD,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,cAAc,GAAG,MAAM,CA+BtE"}