@membox-cloud/membox 0.1.0

package/dist/src/tools/unlock.js

@@ -0,0 +1,72 @@
+import { readState } from "../store/local-state.js";
+import { vaultSession } from "../store/session.js";
+import { unlockWithPassphrase } from "../cli/unlock.js";
+import { readSecretFile } from "./secret-file.js";
+import { jsonResult } from "./result.js";
+export function createUnlockTool() {
+    return {
+        name: "membox_unlock",
+        label: "Membox Vault Unlock",
+        description: "Unlock Membox Vault using a local passphrase file. The passphrase stays on the machine and is never sent to the server.",
+        parameters: {
+            type: "object",
+            properties: {
+                passphrase_file: {
+                    type: "string",
+                    description: "Path to a local file containing the vault passphrase. On Unix, the file must not be readable by group or others.",
+                },
+            },
+            required: ["passphrase_file"],
+            additionalProperties: false,
+        },
+        async execute(_toolCallId, params) {
+            const state = await readState();
+            if (!state?.setup_complete) {
+                return jsonResult({
+                    error: true,
+                    message: "Vault not set up. Complete browser authorization and final setup first.",
+                });
+            }
+            if (vaultSession.isUnlocked()) {
+                return jsonResult({
+                    ok: true,
+                    already_unlocked: true,
+                    message: "Vault is already unlocked.",
+                });
+            }
+            if (!params?.passphrase_file) {
+                return jsonResult({
+                    error: true,
+                    message: "Missing required parameter: `passphrase_file`.",
+                });
+            }
+            try {
+                const { value, resolvedPath } = await readSecretFile(params.passphrase_file, {
+                    label: "Passphrase",
+                    trimWhitespace: false,
+                });
+                const unlocked = await unlockWithPassphrase(value, {
+                    announceDeriving: true,
+                });
+                if (!unlocked) {
+                    return jsonResult({
+                        error: true,
+                        message: "Unlock failed. Check the passphrase file contents or recover the vault on this machine.",
+                    });
+                }
+                return jsonResult({
+                    ok: true,
+                    unlocked: true,
+                    passphrase_file: resolvedPath,
+                    message: "Vault unlocked.",
+                });
+            }
+            catch (err) {
+                return jsonResult({
+                    error: true,
+                    message: `Unlock failed: ${err instanceof Error ? err.message : String(err)}`,
+                });
+            }
+        },
+    };
+}

package/openclaw.plugin.json

@@ -0,0 +1,16 @@
+{
+  "id": "membox",
+  "name": "Membox Vault",
+  "description": "Zero-knowledge encrypted memory sync for OpenClaw",
+  "version": "0.1.0",
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {
+      "serverUrl": {
+        "type": "string",
+        "description": "Membox sync server URL (default: https://membox.cloud)"
+      }
+    }
+  }
+}

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@membox-cloud/membox",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist/",
+    "openclaw.plugin.json",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@noble/hashes": "^1.7.1",
+    "@noble/ciphers": "^1.2.1",
+    "@noble/curves": "^1.8.1",
+    "hash-wasm": "^4.11.0",
+    "keytar": "^7.9.0"
+  },
+  "peerDependencies": {
+    "openclaw": ">=2026.3.7"
+  },
+  "peerDependenciesMeta": {
+    "openclaw": {
+      "optional": true
+    }
+  },
+  "openclaw": {
+    "extensions": [
+      "./dist/index.js"
+    ]
+  }
+}