@minns/openclaw-minns 0.3.2 → 0.3.3

package/dist/index.d.ts

@@ -1,5 +1,7 @@
+import type { OpenClawPluginApi } from "openclaw/plugin-sdk";
 declare const _default: {
     id: string;
-    register(api: any): void;
+    name: string;
+    register(api: OpenClawPluginApi): void;
 };
 export default _default;

package/dist/index.js

@@ -1,9 +1,162 @@
+import { spawn } from "node:child_process";
+import { loadConfig, buildClient } from "./config.js";
+import { dispatch } from "./tools.js";
+const PLUGIN_ID = "openclaw-minns";
+function getPluginConfig(api) {
+    return (api.config?.plugins?.entries?.[PLUGIN_ID]?.config ?? {});
+}
+function mask(v) {
+    if (!v)
+        return "missing";
+    if (v.length <= 6)
+        return "***";
+    return `${v.slice(0, 3)}***${v.slice(-2)}`;
+}
 export default {
-    id: "openclaw-minns",
+    id: PLUGIN_ID,
+    name: "Minns MCP Bridge",
     register(api) {
-        // Wire your MCP bridge here using plugin config:
-        // api.config.plugins?.entries?.minns?.config
-        // and register tools/services as needed.
-    }
+        let proc = null;
+        let startCount = 0;
+        let lastExit = null;
+        const stop = () => {
+            if (!proc)
+                return;
+            try {
+                proc.kill("SIGTERM");
+            }
+            catch { }
+            proc = null;
+        };
+        const start = () => {
+            if (proc)
+                return; // already running
+            const cfg = getPluginConfig(api);
+            const command = cfg.command?.trim() || "openclaw-minns-mcp";
+            const args = Array.isArray(cfg.args) ? cfg.args : [];
+            const env = {
+                ...process.env,
+                ...(cfg.env ?? {}),
+            };
+            proc = spawn(command, args, {
+                env,
+                stdio: ["pipe", "pipe", "pipe"],
+            });
+            startCount += 1;
+            api.logger.info?.(`[${PLUGIN_ID}] started: ${command} ${args.join(" ")}`.trim());
+            proc.stdout.on("data", (d) => {
+                api.logger.debug?.(`[${PLUGIN_ID}] stdout: ${String(d).trim()}`);
+            });
+            proc.stderr.on("data", (d) => {
+                api.logger.warn?.(`[${PLUGIN_ID}] stderr: ${String(d).trim()}`);
+            });
+            proc.on("exit", (code, signal) => {
+                lastExit = { code, signal, at: new Date().toISOString() };
+                api.logger.warn?.(`[${PLUGIN_ID}] exited code=${code} signal=${signal ?? "none"}`);
+                proc = null;
+            });
+            proc.on("error", (err) => {
+                api.logger.error?.(`[${PLUGIN_ID}] process error: ${err instanceof Error ? err.message : String(err)}`);
+            });
+        };
+        // start on plugin load
+        start();
+        // graceful shutdown on process exit
+        const shutdown = () => stop();
+        process.once("SIGINT", shutdown);
+        process.once("SIGTERM", shutdown);
+        api.registerCommand({
+            name: "minns",
+            description: "Minns MCP bridge controls: status|ping|restart|stop|start",
+            acceptsArgs: true,
+            handler: async (ctx) => {
+                const arg = (ctx.args ?? "").trim().toLowerCase();
+                const cfg = getPluginConfig(api);
+                const env = cfg.env ?? {};
+                if (arg === "ping") {
+                    return { text: proc ? "pong (mcp running)" : "pong (plugin loaded, mcp stopped)" };
+                }
+                if (arg === "restart") {
+                    stop();
+                    start();
+                    return { text: "Minns MCP restarted" };
+                }
+                if (arg === "stop") {
+                    stop();
+                    return { text: "Minns MCP stopped." };
+                }
+                if (arg === "start") {
+                    start();
+                    return { text: proc ? "Minns MCP running" : "Minns MCP failed to start" };
+                }
+                const cmd = cfg.command?.trim() || "openclaw-minns-mcp";
+                const cmdArgs = Array.isArray(cfg.args) ? cfg.args : [];
+                return {
+                    text: [
+                        "openclaw-minns status",
+                        `running: ${proc ? "yes" : "no"}`,
+                        `pid: ${proc?.pid ?? "-"}`,
+                        `starts: ${startCount}`,
+                        `command: ${cmd} ${cmdArgs.join(" ")}`.trim(),
+                        `MINNS_BASE_URL: ${env.MINNS_BASE_URL ?? "(not set)"}`,
+                        `MINNS_API_KEY: ${mask(env.MINNS_API_KEY)}`,
+                        `lastExit: ${lastExit
+                            ? `${lastExit.at} (code=${lastExit.code}, signal=${lastExit.signal ?? "none"})`
+                            : "none"}`,
+                        "",
+                        "Use: /minns ping | /minns restart | /minns stop | /minns start",
+                    ].join("\n"),
+                };
+            },
+        });
+        // ------------------------------------------------------------------
+        // Hook: inbound message → Minns SDK
+        // ------------------------------------------------------------------
+        const minnsCfg = loadConfig();
+        const minnsClient = buildClient(minnsCfg);
+        api.registerHook({
+            id: "minns-inbound",
+            description: "Send inbound DM messages to Minns for memory & claim extraction",
+            events: ["message.received"],
+            async handler(event) {
+                const text = (event.text ?? "").trim();
+                if (!text)
+                    return;
+                // Only process DMs (skip group/channel noise)
+                const kind = event.peer?.kind ?? "";
+                if (kind && kind !== "direct" && kind !== "dm")
+                    return;
+                const agentId = 1; // default plugin agent
+                const sessionId = event.timestamp ?? Date.now();
+                try {
+                    // 1. Capture the message as a Context event (enables claim extraction)
+                    await minnsClient
+                        .event("openclaw", {
+                        agentId,
+                        sessionId,
+                        enableSemantic: true,
+                    })
+                        .context(text, "dm_message")
+                        .state({
+                        channel: event.channel,
+                        sender_id: event.senderId,
+                        peer_kind: kind,
+                    })
+                        .send();
+                    api.logger.debug?.(`[${PLUGIN_ID}] ingested message from ${event.senderId ?? "unknown"}`);
+                    // 2. Search for relevant memories to provide context back
+                    const memories = await dispatch(minnsClient, "memory.search", {
+                        query: text,
+                        limit: 5,
+                        agent_id: agentId,
+                    });
+                    api.logger.debug?.(`[${PLUGIN_ID}] memory recall: ${JSON.stringify(memories)}`);
+                }
+                catch (err) {
+                    api.logger.error?.(`[${PLUGIN_ID}] hook error: ${err instanceof Error ? err.message : String(err)}`);
+                }
+            },
+        });
+    },
 };
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,eAAe;IACb,EAAE,EAAE,gBAAgB;IACpB,QAAQ,CAAC,GAAQ;QACf,iDAAiD;QACjD,6CAA6C;QAC7C,yCAAyC;IAC3C,CAAC;CACF,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@minns/openclaw-minns",
-  "version": "0.3.2",
+  "version": "0.3.3",
   "description": "MCP stdio server integrating Minns EventGraphDB into OpenClaw",
   "type": "module",
   "main": "./dist/mcp.js",