neotoma 0.4.2 → 0.4.3

package/README.md

@@ -220,6 +220,35 @@ Neotoma exposes state via MCP. Local storage only in preview. Local built-in aut
 
 **Representative actions:** `store`, `retrieve_entities`, `retrieve_entity_snapshot`, `merge_entities`, `list_observations`, `create_relationship`, `list_relationships`, `list_timeline_events`, `retrieve_graph_neighborhood`. Full list: [MCP spec](docs/specs/MCP_SPEC.md).
 
+### OpenClaw native plugin
+
+Neotoma ships as a native OpenClaw plugin with `kind: "memory"`, so it can fill the dedicated memory slot. All 30+ MCP tools are registered as agent tools.
+
+```bash
+openclaw plugins install neotoma
+```
+
+Then assign it to the memory slot in your OpenClaw config:
+
+```json5
+{
+  plugins: {
+    slots: { memory: "neotoma" },
+    entries: {
+      neotoma: {
+        enabled: true,
+        config: {
+          dataDir: "~/.local/share/neotoma",
+          environment: "production"
+        }
+      }
+    }
+  }
+}
+```
+
+Verify installation: `openclaw plugins inspect neotoma` shows `Format: native`, `Kind: memory`, and all registered tool contracts.
+
 ## Common questions
 
 **Platform memory (Claude, ChatGPT) is good enough — why add another tool?**

package/dist/openclaw_entry.d.ts

@@ -0,0 +1,45 @@
+/**
+ * OpenClaw native plugin entry point for Neotoma.
+ *
+ * Registers all Neotoma MCP tools as OpenClaw agent tools so that
+ * `openclaw plugins install neotoma` makes Neotoma's structured memory
+ * available in any OpenClaw session.
+ *
+ * The plugin declares `kind: "memory"` in its manifest, meaning users
+ * can assign it to the memory slot via `plugins.slots.memory = "neotoma"`.
+ */
+interface NeotomaPluginConfig {
+    dataDir?: string;
+    environment?: string;
+    openaiApiKey?: string;
+    encryptionEnabled?: boolean;
+}
+interface PluginApi {
+    config?: NeotomaPluginConfig;
+    registerTool(def: {
+        name: string;
+        description: string;
+        parameters: Record<string, unknown>;
+        execute(id: string, params: Record<string, unknown>): Promise<{
+            content: Array<{
+                type: string;
+                text: string;
+            }>;
+        }>;
+    }): void;
+}
+/**
+ * Plugin entry object conforming to the OpenClaw plugin interface.
+ *
+ * When loaded by OpenClaw, the host wraps this with `definePluginEntry`
+ * from `openclaw/plugin-sdk/plugin-entry`. The export shape (id, name,
+ * description, register) satisfies the native plugin contract.
+ */
+declare const neotomaPlugin: {
+    id: string;
+    name: string;
+    description: string;
+    register(api: PluginApi): void;
+};
+export default neotomaPlugin;
+//# sourceMappingURL=openclaw_entry.d.ts.map

package/dist/openclaw_entry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openclaw_entry.d.ts","sourceRoot":"","sources":["../src/openclaw_entry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AASH,UAAU,mBAAmB;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAiCD,UAAU,SAAS;IACjB,MAAM,CAAC,EAAE,mBAAmB,CAAC;IAC7B,YAAY,CAAC,GAAG,EAAE;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACpC,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC;YAC5D,OAAO,EAAE,KAAK,CAAC;gBAAE,IAAI,EAAE,MAAM,CAAC;gBAAC,IAAI,EAAE,MAAM,CAAA;aAAE,CAAC,CAAC;SAChD,CAAC,CAAC;KACJ,GAAG,IAAI,CAAC;CACV;AAED;;;;;;GAMG;AACH,QAAA,MAAM,aAAa;;;;kBAMH,SAAS;CAmBxB,CAAC;AAEF,eAAe,aAAa,CAAC"}

package/dist/openclaw_entry.js

@@ -0,0 +1,75 @@
+/**
+ * OpenClaw native plugin entry point for Neotoma.
+ *
+ * Registers all Neotoma MCP tools as OpenClaw agent tools so that
+ * `openclaw plugins install neotoma` makes Neotoma's structured memory
+ * available in any OpenClaw session.
+ *
+ * The plugin declares `kind: "memory"` in its manifest, meaning users
+ * can assign it to the memory slot via `plugins.slots.memory = "neotoma"`.
+ */
+import { buildToolDefinitions } from "./tool_definitions.js";
+import { initDatabase } from "./db.js";
+import { NeotomaServer } from "./server.js";
+let serverInstance = null;
+let initPromise = null;
+function applyConfig(cfg) {
+    if (cfg.dataDir) {
+        process.env.NEOTOMA_DATA_DIR = cfg.dataDir;
+    }
+    if (cfg.environment) {
+        process.env.NEOTOMA_ENV = cfg.environment;
+    }
+    if (cfg.openaiApiKey) {
+        process.env.OPENAI_API_KEY = cfg.openaiApiKey;
+    }
+    if (cfg.encryptionEnabled !== undefined) {
+        process.env.NEOTOMA_ENCRYPTION_ENABLED = cfg.encryptionEnabled ? "true" : "false";
+    }
+    process.env.NEOTOMA_ACTIONS_DISABLE_AUTOSTART = "1";
+}
+async function ensureServer(cfg) {
+    if (serverInstance)
+        return serverInstance;
+    if (initPromise)
+        return initPromise;
+    initPromise = (async () => {
+        applyConfig(cfg);
+        await initDatabase();
+        const server = new NeotomaServer();
+        serverInstance = server;
+        return server;
+    })();
+    return initPromise;
+}
+/**
+ * Plugin entry object conforming to the OpenClaw plugin interface.
+ *
+ * When loaded by OpenClaw, the host wraps this with `definePluginEntry`
+ * from `openclaw/plugin-sdk/plugin-entry`. The export shape (id, name,
+ * description, register) satisfies the native plugin contract.
+ */
+const neotomaPlugin = {
+    id: "neotoma",
+    name: "Neotoma",
+    description: "Structured personal data memory with append-only observations, schema evolution, and provenance tracking",
+    register(api) {
+        const pluginConfig = api.config ?? {};
+        const tools = buildToolDefinitions();
+        for (const tool of tools) {
+            api.registerTool({
+                name: tool.name,
+                description: tool.description,
+                parameters: tool.inputSchema,
+                async execute(_id, params) {
+                    const server = await ensureServer(pluginConfig);
+                    const { ensureLocalDevUser } = await import("./services/local_auth.js");
+                    const localUser = ensureLocalDevUser();
+                    return server.executeToolForCli(tool.name, params, localUser.id);
+                },
+            });
+        }
+    },
+};
+export default neotomaPlugin;
+//# sourceMappingURL=openclaw_entry.js.map

package/dist/openclaw_entry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openclaw_entry.js","sourceRoot":"","sources":["../src/openclaw_entry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,IAAI,cAAc,GAAyB,IAAI,CAAC;AAChD,IAAI,WAAW,GAAkC,IAAI,CAAC;AAStD,SAAS,WAAW,CAAC,GAAwB;IAC3C,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;QAChB,OAAO,CAAC,GAAG,CAAC,gBAAgB,GAAG,GAAG,CAAC,OAAO,CAAC;IAC7C,CAAC;IACD,IAAI,GAAG,CAAC,WAAW,EAAE,CAAC;QACpB,OAAO,CAAC,GAAG,CAAC,WAAW,GAAG,GAAG,CAAC,WAAW,CAAC;IAC5C,CAAC;IACD,IAAI,GAAG,CAAC,YAAY,EAAE,CAAC;QACrB,OAAO,CAAC,GAAG,CAAC,cAAc,GAAG,GAAG,CAAC,YAAY,CAAC;IAChD,CAAC;IACD,IAAI,GAAG,CAAC,iBAAiB,KAAK,SAAS,EAAE,CAAC;QACxC,OAAO,CAAC,GAAG,CAAC,0BAA0B,GAAG,GAAG,CAAC,iBAAiB,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC;IACpF,CAAC;IACD,OAAO,CAAC,GAAG,CAAC,iCAAiC,GAAG,GAAG,CAAC;AACtD,CAAC;AAED,KAAK,UAAU,YAAY,CAAC,GAAwB;IAClD,IAAI,cAAc;QAAE,OAAO,cAAc,CAAC;IAC1C,IAAI,WAAW;QAAE,OAAO,WAAW,CAAC;IAEpC,WAAW,GAAG,CAAC,KAAK,IAAI,EAAE;QACxB,WAAW,CAAC,GAAG,CAAC,CAAC;QACjB,MAAM,YAAY,EAAE,CAAC;QACrB,MAAM,MAAM,GAAG,IAAI,aAAa,EAAE,CAAC;QACnC,cAAc,GAAG,MAAM,CAAC;QACxB,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC,EAAE,CAAC;IAEL,OAAO,WAAW,CAAC;AACrB,CAAC;AAcD;;;;;;GAMG;AACH,MAAM,aAAa,GAAG;IACpB,EAAE,EAAE,SAAS;IACb,IAAI,EAAE,SAAS;IACf,WAAW,EACT,0GAA0G;IAE5G,QAAQ,CAAC,GAAc;QACrB,MAAM,YAAY,GAAwB,GAAG,CAAC,MAAM,IAAI,EAAE,CAAC;QAC3D,MAAM,KAAK,GAAG,oBAAoB,EAAE,CAAC;QAErC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,GAAG,CAAC,YAAY,CAAC;gBACf,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,WAAW,EAAE,IAAI,CAAC,WAAW;gBAC7B,UAAU,EAAE,IAAI,CAAC,WAAW;gBAE5B,KAAK,CAAC,OAAO,CAAC,GAAW,EAAE,MAA+B;oBACxD,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,YAAY,CAAC,CAAC;oBAChD,MAAM,EAAE,kBAAkB,EAAE,GAAG,MAAM,MAAM,CAAC,0BAA0B,CAAC,CAAC;oBACxE,MAAM,SAAS,GAAG,kBAAkB,EAAE,CAAC;oBACvC,OAAO,MAAM,CAAC,iBAAiB,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,CAAC,CAAC;gBACnE,CAAC;aACF,CAAC,CAAC;QACL,CAAC;IACH,CAAC;CACF,CAAC;AAEF,eAAe,aAAa,CAAC"}

package/dist/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,6BAA6B,EAAE,MAAM,oDAAoD,CAAC;AAoEnG,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,sBAAsB,CAAC,CAAa;IAC5C,OAAO,CAAC,mBAAmB,CAAuB;IAClD,OAAO,CAAC,YAAY,CAAuB;IAC3C,OAAO,CAAC,WAAW,CAA6D;IAChF,qGAAqG;IACrG,OAAO,CAAC,mBAAmB,CAAuB;IAClD,yGAAyG;IACzG,OAAO,CAAC,gBAAgB,CAAkC;IAC1D,0GAA0G;IAC1G,OAAO,CAAC,aAAa,CAAyD;IAC9E,OAAO,CAAC,MAAM,CAAC,qBAAqB,CAAkB;IACtD,OAAO,CAAC,MAAM,CAAC,6BAA6B,CAAO;IACnD,OAAO,CAAC,MAAM,CAAC,gCAAgC,CAAO;IACtD,OAAO,CAAC,MAAM,CAAC,gCAAgC,CAAsB;IACrE,OAAO,CAAC,sBAAsB,CAAS;IACvC,OAAO,CAAC,wBAAwB,CAAK;IACrC,OAAO,CAAC,yBAAyB,CAAuB;;IAuBxD,OAAO,CAAC,WAAW;IAInB,OAAO,CAAC,6BAA6B;IAoCrC,OAAO,CAAC,8BAA8B;IAwBtC,OAAO,CAAC,uBAAuB;IAc/B;;;;OAIG;IACH,OAAO,CAAC,sBAAsB;IAiJ9B;;;OAGG;IACH,OAAO,CAAC,0BAA0B;IA4ClC;;;OAGG;IACH,sBAAsB,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI;IAIlD,OAAO,CAAC,oCAAoC;IAsB5C,OAAO,CAAC,yBAAyB;IAMjC,OAAO,CAAC,2BAA2B;YAerB,6BAA6B;YAqB7B,sBAAsB;YA4BtB,yBAAyB;YAUzB,0BAA0B;IAiBxC,OAAO,CAAC,uBAAuB;IAW/B;;;;;OAKG;IACH,OAAO,CAAC,sBAAsB;IAgB9B;;;OAGG;YACW,oBAAoB;IAwBlC;;;OAGG;YACW,oBAAoB;YAgIpB,cAAc;IA4C5B;;;;;OAKG;YACW,oBAAoB;IAUlC,OAAO,CAAC,iBAAiB;IAy6BZ,iBAAiB,CAC5B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,OAAO,EACb,MAAM,EAAE,MAAM,GACb,OAAO,CAAC;QAAE,OAAO,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE,CAAC;YAKhD,WAAW;IAwEzB;;OAEG;IACH,OAAO,CAAC,qBAAqB;YA4Uf,eAAe;IAmC7B,OAAO,CAAC,iBAAiB;YAgBX,qBAAqB;YAkCrB,SAAS;IAiCvB,OAAO,CAAC,uBAAuB;YAkFjB,sBAAsB;YAmHtB,gBAAgB;YA0BhB,uBAAuB;YAqFvB,kBAAkB;YAkGlB,iBAAiB;YAiGjB,uBAAuB;YAyCvB,gBAAgB;YA2ChB,kBAAkB;YA2ElB,0BAA0B;YAkB1B,uBAAuB;YAqHvB,yBAAyB;YA2LzB,mBAAmB;YAkCnB,eAAe;IAgD7B;;OAEG;YACW,uBAAuB;IAiCrC;;OAEG;YACW,wBAAwB;IAiCtC;;OAEG;YACW,uBAAuB;IAyCrC;;OAEG;YACW,cAAc;YAqCd,KAAK;IA2KnB,OAAO,CAAC,kBAAkB;YAQZ,6BAA6B;YA0E7B,sBAAsB;YAsCtB,kCAAkC;YAoElC,uBAAuB;YAoYvB,OAAO;YA8GP,aAAa;IA0C3B,qGAAqG;YACvF,YAAY;IAyB1B,gHAAgH;YAClG,kBAAkB;IA4BhC,mHAAmH;YACrG,aAAa;IAyB3B,+HAA+H;YACjH,mBAAmB;IA4BjC;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAmLxB;;OAEG;YACW,yBAAyB;IA2FvC;;OAEG;YACW,sBAAsB;IAuFpC;;OAEG;YACW,sBAAsB;IAsCpC;;OAEG;YACW,wBAAwB;IAkCtC;;OAEG;YACW,yBAAyB;IAsCvC;;OAEG;YACW,kBAAkB;IA0EhC;;OAEG;YACW,mBAAmB;IA0HjC;;OAEG;YACW,YAAY;IAsC1B;;OAEG;YACW,sBAAsB;IA2EpC;;OAEG;YACW,+BAA+B;IA0H7C;;OAEG;YACW,4BAA4B;IA2H1C;;OAEG;YACW,iBAAiB;IA+B/B,OAAO,CAAC,iBAAiB;IAiBnB,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ1B;;;OAGG;IACG,OAAO,CAAC,SAAS,EAAE,6BAA6B,GAAG,OAAO,CAAC,IAAI,CAAC;IAOtE;;OAEG;YACW,oBAAoB;CAYnC"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}