@memclaw/plugin 0.9.0 → 0.9.2

package/README.md

@@ -76,23 +76,37 @@ bun install
 
 # Build the plugin
 bun run build
+```
+
+**Option A: Use plugins.load.paths**
+
+```json
+{
+  "plugins": {
+    "load": {
+      "paths": ["/path/to/cortex-mem/examples/@memclaw/plugin"]
+    },
+    "entries": {
+      "memclaw": { "enabled": true }
+    }
+  }
+}
+```
+
+**Option B: Symlink to extensions directory**
 
-# Create a symlink to the plugin directory
-# This makes OpenClaw use your local version
-mkdir -p ~/.openclaw/plugins
-ln -sf "$(pwd)" ~/.openclaw/plugins/memclaw
+```bash
+mkdir -p ~/.openclaw/extensions
+ln -sf "$(pwd)" ~/.openclaw/extensions/memclaw
 ```
 
-Then configure in `openclaw.json` with the local plugin path:
+Then enable in `openclaw.json`:
 
 ```json
 {
   "plugins": {
     "entries": {
-      "memclaw": {
-        "enabled": true,
-        "path": "./plugins/memclaw"
-      }
+      "memclaw": { "enabled": true }
     }
   }
 }

package/dist/index.d.ts

@@ -0,0 +1,100 @@
+/**
+ * MemClaw - Layered Semantic Memory for OpenClaw
+ *
+ * Provides:
+ * - L0/L1/L2 tiered memory retrieval
+ * - Automatic service startup (Qdrant + cortex-mem-service)
+ * - Migration from OpenClaw native memory
+ *
+ * Installation:
+ *   openclaw plugins install memclaw
+ *
+ * Configuration (in openclaw.json):
+ *   {
+ *     "plugins": {
+ *       "entries": {
+ *         "memclaw": {
+ *           "enabled": true,
+ *           "config": {
+ *             "serviceUrl": "http://127.0.0.1:8085",
+ *             "tenantId": "tenant_claw",
+ *             "autoStartServices": true
+ *           }
+ *         }
+ *       }
+ *     }
+ *   }
+ */
+export type { CortexMemClient } from './src/client.js';
+export type { MemClawConfig } from './src/config.js';
+interface PluginLogger {
+    debug?: (msg: string, ...args: unknown[]) => void;
+    info: (msg: string, ...args: unknown[]) => void;
+    warn: (msg: string, ...args: unknown[]) => void;
+    error: (msg: string, ...args: unknown[]) => void;
+}
+interface ToolDefinition {
+    name: string;
+    description: string;
+    parameters: object;
+    execute: (_id: string, params: Record<string, unknown>) => Promise<unknown>;
+    optional?: boolean;
+}
+interface PluginAPI {
+    pluginConfig?: Record<string, unknown>;
+    registerTool(tool: ToolDefinition, opts?: {
+        optional?: boolean;
+    }): void;
+    registerService(service: {
+        id: string;
+        start: () => Promise<void>;
+        stop: () => Promise<void>;
+    }): void;
+    logger: PluginLogger;
+}
+export default function memclawPlugin(api: PluginAPI): {
+    id: string;
+    name: string;
+    version: string;
+};
+export declare const plugin: {
+    id: string;
+    name: string;
+    version: string;
+    configSchema: {
+        type: string;
+        properties: {
+            serviceUrl: {
+                type: string;
+                default: string;
+            };
+            defaultSessionId: {
+                type: string;
+                default: string;
+            };
+            searchLimit: {
+                type: string;
+                default: number;
+            };
+            minScore: {
+                type: string;
+                default: number;
+            };
+            tenantId: {
+                type: string;
+                default: string;
+            };
+            autoStartServices: {
+                type: string;
+                default: boolean;
+            };
+        };
+        required: never[];
+    };
+    register(api: PluginAPI): {
+        id: string;
+        name: string;
+        version: string;
+    };
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAKH,YAAY,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACvD,YAAY,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGrD,UAAU,YAAY;IACrB,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;IAClD,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;IAChD,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;IAChD,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;CACjD;AAED,UAAU,cAAc;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC5E,QAAQ,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,UAAU,SAAS;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,YAAY,CAAC,IAAI,EAAE,cAAc,EAAE,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;IACxE,eAAe,CAAC,OAAO,EAAE;QACxB,EAAE,EAAE,MAAM,CAAC;QACX,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;QAC3B,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;KAC1B,GAAG,IAAI,CAAC;IACT,MAAM,EAAE,YAAY,CAAC;CACrB;AAGD,MAAM,CAAC,OAAO,UAAU,aAAa,CAAC,GAAG,EAAE,SAAS;;;;EAEnD;AAGD,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAgBJ,SAAS;;;;;CAGvB,CAAC"}

package/dist/index.js

@@ -0,0 +1,58 @@
+"use strict";
+/**
+ * MemClaw - Layered Semantic Memory for OpenClaw
+ *
+ * Provides:
+ * - L0/L1/L2 tiered memory retrieval
+ * - Automatic service startup (Qdrant + cortex-mem-service)
+ * - Migration from OpenClaw native memory
+ *
+ * Installation:
+ *   openclaw plugins install memclaw
+ *
+ * Configuration (in openclaw.json):
+ *   {
+ *     "plugins": {
+ *       "entries": {
+ *         "memclaw": {
+ *           "enabled": true,
+ *           "config": {
+ *             "serviceUrl": "http://127.0.0.1:8085",
+ *             "tenantId": "tenant_claw",
+ *             "autoStartServices": true
+ *           }
+ *         }
+ *       }
+ *     }
+ *   }
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.plugin = void 0;
+exports.default = memclawPlugin;
+const plugin_impl_js_1 = require("./plugin-impl.js");
+// Default export - main plugin function
+function memclawPlugin(api) {
+    return (0, plugin_impl_js_1.createPlugin)(api);
+}
+// Named export - object style registration
+exports.plugin = {
+    id: 'memclaw',
+    name: 'MemClaw',
+    version: '0.9.2',
+    configSchema: {
+        type: 'object',
+        properties: {
+            serviceUrl: { type: 'string', default: 'http://localhost:8085' },
+            defaultSessionId: { type: 'string', default: 'default' },
+            searchLimit: { type: 'integer', default: 10 },
+            minScore: { type: 'number', default: 0.6 },
+            tenantId: { type: 'string', default: 'tenant_claw' },
+            autoStartServices: { type: 'boolean', default: true }
+        },
+        required: []
+    },
+    register(api) {
+        return (0, plugin_impl_js_1.createPlugin)(api);
+    }
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;;;AAoCH,gCAEC;AApCD,qDAAgD;AAiChD,wCAAwC;AACxC,SAAwB,aAAa,CAAC,GAAc;IACnD,OAAO,IAAA,6BAAY,EAAC,GAAG,CAAC,CAAC;AAC1B,CAAC;AAED,2CAA2C;AAC9B,QAAA,MAAM,GAAG;IACrB,EAAE,EAAE,SAAS;IACb,IAAI,EAAE,SAAS;IACf,OAAO,EAAE,OAAO;IAChB,YAAY,EAAE;QACb,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACX,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,uBAAuB,EAAE;YAChE,gBAAgB,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE;YACxD,WAAW,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,EAAE,EAAE;YAC7C,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,EAAE;YAC1C,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,aAAa,EAAE;YACpD,iBAAiB,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE;SACrD;QACD,QAAQ,EAAE,EAAE;KACZ;IACD,QAAQ,CAAC,GAAc;QACtB,OAAO,IAAA,6BAAY,EAAC,GAAG,CAAC,CAAC;IAC1B,CAAC;CACD,CAAC"}

package/dist/plugin-impl.d.ts

@@ -0,0 +1,40 @@
+/**
+ * MemClaw Plugin Implementation
+ *
+ * Provides layered semantic memory for OpenClaw with:
+ * - Automatic service startup
+ * - Memory tools (search, recall, add, list, close)
+ * - Migration from OpenClaw native memory
+ */
+interface PluginLogger {
+    debug?: (msg: string, ...args: unknown[]) => void;
+    info: (msg: string, ...args: unknown[]) => void;
+    warn: (msg: string, ...args: unknown[]) => void;
+    error: (msg: string, ...args: unknown[]) => void;
+}
+interface ToolDefinition {
+    name: string;
+    description: string;
+    parameters: object;
+    execute: (_id: string, params: Record<string, unknown>) => Promise<unknown>;
+    optional?: boolean;
+}
+interface PluginAPI {
+    pluginConfig?: Record<string, unknown>;
+    registerTool(tool: ToolDefinition, opts?: {
+        optional?: boolean;
+    }): void;
+    registerService(service: {
+        id: string;
+        start: () => Promise<void>;
+        stop: () => Promise<void>;
+    }): void;
+    logger: PluginLogger;
+}
+export declare function createPlugin(api: PluginAPI): {
+    id: string;
+    name: string;
+    version: string;
+};
+export {};
+//# sourceMappingURL=plugin-impl.d.ts.map

package/dist/plugin-impl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-impl.d.ts","sourceRoot":"","sources":["../plugin-impl.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AA8BH,UAAU,YAAY;IACpB,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;IAClD,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;IAChD,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;IAChD,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;CAClD;AAED,UAAU,cAAc;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC5E,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,UAAU,SAAS;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,YAAY,CAAC,IAAI,EAAE,cAAc,EAAE,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;IACxE,eAAe,CAAC,OAAO,EAAE;QACvB,EAAE,EAAE,MAAM,CAAC;QACX,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;QAC3B,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;KAC3B,GAAG,IAAI,CAAC;IACT,MAAM,EAAE,YAAY,CAAC;CACtB;AAuJD,wBAAgB,YAAY,CAAC,GAAG,EAAE,SAAS;;;;EAiW1C"}