mnemospark 0.1.5 → 0.1.7

package/README.md

@@ -1,7 +1,5 @@
 # mnemospark
 
-### 🚀 Stay tuned mnemospark will be released soon!
-
 mnemospark is an OpenClaw plugin that provides access to hyper-scaler cloud operations and proprietary data sets. Payments via x402 USDC on Base.
 
-Wallet & go 💙 *No forms. No email registration. Just Base.*
+Stay tuned for a working release...

package/README.md.bak

@@ -1,84 +1,22 @@
 # mnemospark
 
-mnemospark is an OpenClaw plugin for storage workflow operations with wallet-based x402 USDC payments.
-
-It focuses on:
-
-- `/mnemospark wallet` for wallet status and export
-- `/mnemospark cloud` for storage workflow commands (backup, price-storage, upload, ls, download, delete)
-- A local proxy that forwards `/mnemospark/*` storage endpoints to the mnemospark backend with wallet-proof signing
-
----
+mnemospark is an OpenClaw plugin that provides access to hyper-scaler cloud operations and proprietary data sets. Payments via x402 USDC on Base.
 
 ## Quick start
 
-```bash
-# Install plugin (from OpenClaw)
-openclaw plugins install mnemospark
-
-# (Optional) run standalone install to create or reuse a wallet
-npx mnemospark install --standard
-
-# (Optional) set wallet key explicitly; if omitted, mnemospark auto-generates one
-export MNEMOSPARK_WALLET_KEY=0x...
-
-# (Optional) point to a custom mnemospark backend API base URL
-export MNEMOSPARK_BACKEND_API_BASE_URL=https://your-backend.example.com
-
-# Start OpenClaw gateway (starts mnemospark proxy in gateway mode)
-openclaw gateway start
-```
-
-In OpenClaw:
-
-- `/mnemospark wallet` to view wallet address and balance
-- `/mnemospark wallet export` to back up your private key
-- `/mnemospark cloud help` to view storage workflow commands
-
----
-
-## Configuration
-
-- **Directory layout:**
-  - Base directory: `~/.openclaw/mnemospark`
-  - Logs and object log: `~/.openclaw/mnemospark/object.log`
-  - Wallet directory: `~/.openclaw/mnemospark/wallet`
-  - Wallet key: `~/.openclaw/mnemospark/wallet/wallet.key` (or `~/.openclaw/blockrun/wallet.key` when reusing a legacy Blockrun wallet)
-  - Backup archives: `~/.openclaw/mnemospark/backup`
-- **Wallet key:** `MNEMOSPARK_WALLET_KEY` (optional). If not provided, mnemospark auto-generates a wallet and stores it under `~/.openclaw/mnemospark/wallet/wallet.key`.
-- **Backend base URL:** `MNEMOSPARK_BACKEND_API_BASE_URL` (optional if default is acceptable).
-- **No backend API key:** do not set `MNEMOSPARK_BACKEND_API_KEY` or `x-api-key`. Backend authentication uses wallet-proof signatures generated by the proxy.
-
-Install flows:
-
-- **Default install:** `npx mnemospark install --default` creates a new Base wallet for mnemospark under `~/.openclaw/mnemospark/wallet/wallet.key` (chmod 600).
-- **Standard install:** `npx mnemospark install --standard` checks for an existing `~/.openclaw/blockrun/wallet.key` and, if present, offers to reuse it for mnemospark; otherwise it behaves like the default install.
-
----
-
-## Workflow and product references
-
-- [mnemospark full workflow](./.company/mnemospark_full_workflow.md)
-- [mnemospark PRD](./.company/mnemospark_PRD.md)
-- [mnemospark backend API spec](./.company/mnemospark_backend_api_spec.md)
-
----
-
-## Python examples (uv)
+1. **Install the plugin in OpenClaw** (required):
 
-Python tooling and examples use [uv](https://docs.astral.sh/uv/) for dependency management. From the repo root:
+   ```bash
+   openclaw plugins install mnemospark
+   openclaw gateway start
+   ```
 
-```bash
-# Install uv (macOS/Linux): curl -LsSf https://astral.sh/uv/install.sh | sh
-uv sync --extra bcm-pricing
-source .venv/bin/activate      # or on Windows: .venv\Scripts\activate
-python examples/s3_storage_cost_estimate.py --gb 100
-python examples/data_transfer_cost_estimate.py --direction in --gb 100
-python examples/data_transfer_cost_estimate.py --direction out --gb 500
-```
+2. **Optional — wallet setup** (creates or reuses a Base wallet; does not register the plugin):
 
----
+   ```bash
+   npx mnemospark install --standard
+   ```
 
-## License
+Plugin registration is handled only by `openclaw plugins install mnemospark`. The `npx mnemospark install` command sets up your wallet and helper scripts under `~/.openclaw/mnemospark/`; it does not write to `~/.openclaw/extensions/`.
 
-MIT
+In OpenClaw: `/mnemospark wallet`, `/mnemospark cloud help`. See the [installation guide](https://github.com/pawlsclick/mnemospark#readme) and [OpenClaw plugins docs](https://docs.openclaw.ai/tools/plugin) if the plugin is not found.

package/dist/cli.js

@@ -2912,9 +2912,10 @@ function createCloudCommand(options = {}) {
 }
 
 // src/cli.ts
+import { spawn as spawn2 } from "child_process";
 import { dirname as dirname4, join as join5 } from "path";
 import { fileURLToPath as fileURLToPath2 } from "url";
-import { mkdir as mkdir4, readFile as readFile3, writeFile as writeFile4, cp } from "fs/promises";
+import { mkdir as mkdir4, readFile as readFile3, writeFile as writeFile4 } from "fs/promises";
 import { existsSync } from "fs";
 import { homedir as homedir3 } from "os";
 function isHexPrivateKey(value) {
@@ -3023,27 +3024,50 @@ function parseArgs(args) {
 var __filename2 = fileURLToPath2(import.meta.url);
 var __dirname2 = dirname4(__filename2);
 var PACKAGE_ROOT = dirname4(__dirname2);
-var EXTENSIONS_DIR = join5(homedir3(), ".openclaw", "extensions", "mnemospark");
 async function ensureDir(path) {
   await mkdir4(path, { recursive: true });
 }
 async function deployExtensionFiles() {
-  await ensureDir(EXTENSIONS_DIR);
   const scriptsSource = join5(PACKAGE_ROOT, "scripts");
-  if (existsSync(scriptsSource)) {
-    await cp(scriptsSource, join5(EXTENSIONS_DIR, "scripts"), { recursive: true });
-    const mnemoScriptsDir = join5(homedir3(), ".openclaw", "mnemospark", "scripts");
-    await ensureDir(mnemoScriptsDir);
-    const uninstallSrc = join5(scriptsSource, "uninstall.sh");
-    if (existsSync(uninstallSrc)) {
-      const content = await readFile3(uninstallSrc);
-      await writeFile4(join5(mnemoScriptsDir, "uninstall.sh"), content, { mode: 493 });
-    }
+  if (!existsSync(scriptsSource)) return;
+  const mnemoScriptsDir = join5(homedir3(), ".openclaw", "mnemospark", "scripts");
+  await ensureDir(mnemoScriptsDir);
+  const uninstallSrc = join5(scriptsSource, "uninstall.sh");
+  if (existsSync(uninstallSrc)) {
+    const content = await readFile3(uninstallSrc);
+    await writeFile4(join5(mnemoScriptsDir, "uninstall.sh"), content, { mode: 493 });
   }
-  const pluginJson = join5(PACKAGE_ROOT, "openclaw.plugin.json");
-  if (existsSync(pluginJson)) {
-    const content = await readFile3(pluginJson);
-    await writeFile4(join5(EXTENSIONS_DIR, "openclaw.plugin.json"), content);
+}
+function isOpenClawAvailable() {
+  return new Promise((resolve3) => {
+    const child = spawn2("openclaw", ["--version"], {
+      stdio: "ignore",
+      shell: true
+    });
+    child.on("error", () => resolve3(false));
+    child.on("close", (code) => resolve3(code === 0));
+  });
+}
+async function promptOrRunOpenClawPluginInstall() {
+  const available = await isOpenClawAvailable();
+  if (available) {
+    console.log("\n[mnemospark] Registering plugin with OpenClaw...");
+    const child = spawn2("openclaw", ["plugins", "install", "mnemospark"], {
+      stdio: "inherit",
+      shell: true
+    });
+    const exitCode = await new Promise((resolve3) => {
+      child.on("close", resolve3);
+    });
+    if (exitCode !== 0) {
+      console.log(
+        "\n[mnemospark] OpenClaw plugin install did not succeed. Run manually: openclaw plugins install mnemospark"
+      );
+    }
+  } else {
+    console.log(
+      "\n[mnemospark] To use mnemospark inside OpenClaw, install the plugin: openclaw plugins install mnemospark"
+    );
   }
 }
 async function readLegacyWalletIfPresent() {
@@ -3159,6 +3183,7 @@ async function runInstall(mode) {
         console.log(
           "[mnemospark] Your wallet will be used for mnemospark storage payments on Base."
         );
+        await promptOrRunOpenClawPluginInstall();
         return;
       }
     }
@@ -3180,6 +3205,7 @@ async function runInstall(mode) {
   console.log(
     "You can acquire USDC on Base from providers like Coinbase and Moonpay. Fund the wallet before running mnemospark."
   );
+  await promptOrRunOpenClawPluginInstall();
 }
 async function runWallet() {
   const { address, source } = await resolveOrGenerateWalletKey();