mnemospark 0.7.0 → 0.8.1

package/openclaw.plugin.json

@@ -1,7 +1,7 @@
 {
   "id": "mnemospark",
   "name": "mnemospark",
-  "version": "0.7.0",
+  "version": "0.8.1",
   "description": "mnemospark is an OpenClaw plugin that gives agentic systems instant, secure access to cloud storage, compute, and proprietary datasets paid via x402 with USDC on Base. Wallet and go.",
   "configSchema": {
     "type": "object",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mnemospark",
-  "version": "0.7.0",
+  "version": "0.8.1",
   "description": "mnemospark is an OpenClaw plugin that gives agentic systems instant, secure access to cloud storage, compute, and proprietary datasets paid via x402 with USDC on Base. Wallet and go.",
   "type": "module",
   "main": "dist/index.js",

package/skills/mnemospark/references/commands.md

@@ -4,9 +4,11 @@
 
 ### Backup
 
-`backup <file|directory> [--name <friendly-name>] [--async] [--orchestrator <inline|subagent>] [--timeout-seconds <n>]`
+`backup <file|directory> --name <friendly-name> [--async] [--orchestrator <inline|subagent>] [--timeout-seconds <n>]`
 
-- Purpose: create a local tar+gzip backup artifact and index metadata.
+- Purpose: create a local tar+gzip backup artifact under `~/.openclaw/mnemospark/backup/` and index metadata in SQLite.
+- **Required:** `--name <friendly-name>` (stored in `state.db`; on-disk filename is a sanitized single path segment derived from it).
+- Duplicate `--name` values that resolve to the same on-disk basename will fail with an “already exists” error.
 - `--timeout-seconds <n>` only applies when `--async --orchestrator subagent`.
 
 ### Price storage quote
@@ -18,14 +20,18 @@
 `upload --quote-id <quote-id> --wallet-address <addr> --object-id <id> --object-id-hash <hash> [--name <friendly-name>] [--async] [--orchestrator <inline|subagent>] [--timeout-seconds <n>]`
 
 - Purpose: upload encrypted object for a valid quote.
+- Local archive path: prefers `backup/<sanitized-friendly-name>` from SQLite (see `backup` + `friendly_names`); falls back to legacy `backup/<object-id>` if that file exists.
+- Optional `--name` must exactly match the friendly name in SQLite for that `object_id` (validation only; not sent to the backend).
 - `--timeout-seconds <n>` only applies when `--async --orchestrator subagent`.
 
 ### Payment settle (scheduled / manual)
 
-`payment-settle --quote-id <quote-id> --wallet-address <addr> [--object-id <id>] [--object-key <key>] [--storage-price <n>]`
+**Quote path (upload prep):** `payment-settle --quote-id <quote-id> --wallet-address <addr> [--object-id <id>] [--object-key <key>] [--storage-price <n>]`
 
-- Purpose: call the same proxy + x402 payment settlement path as upload (for monthly cron lines stored after upload).
-- Required: `--quote-id`, `--wallet-address` (configured private key must match the address).
+**Monthly renewal (no new quote):** `payment-settle --renewal --object-key <key> --wallet-address <addr> [--object-id <id>] [--storage-price <n>]`
+
+- Purpose: call the same proxy + x402 payment settlement path as upload. Cron lines after upload use **renewal** mode so the backend reads price from active inventory (no `QUOTES_TABLE` row).
+- Required: `--wallet-address` and either `--quote-id` or (`--renewal` and `--object-key`). The configured private key must match the address.
 
 ### List
 
@@ -35,7 +41,8 @@
 
 `download --wallet-address <addr> [--object-key <object-key> | --name <friendly-name>] [--latest|--at <timestamp>] [--async] [--orchestrator <inline|subagent>] [--timeout-seconds <n>]`
 
-- Purpose: download object content to local filesystem.
+- Purpose: download object content to local filesystem (default directory `~/.openclaw/mnemospark/downloads/`, overridable with `MNEMOSPARK_DOWNLOAD_DIR`).
+- When SQLite has a friendly name for the object, the saved file basename is the sanitized friendly name; otherwise the layout follows `object_key` as before. The backend still receives only `object_id` / `object_key` semantics via the API.
 - `--timeout-seconds <n>` only applies when `--async --orchestrator subagent`.
 
 ### Delete

package/skills/mnemospark/references/state-and-logs.md

@@ -1,5 +1,10 @@
 # mnemospark State and Logs Reference
 
+## Environment variables (local behavior)
+
+- `MNEMOSPARK_REMOVE_BACKUP_FILE` — after a successful **upload**, remove the local backup archive under `~/.openclaw/mnemospark/backup/`. Default when unset: **remove**. Set to `0`, `false`, `no`, or `n` to keep the file; `1`, `true`, `yes`, or `y` to remove.
+- `MNEMOSPARK_DOWNLOAD_DIR` — override the directory used for download output (default `~/.openclaw/mnemospark/downloads/`).
+
 ## Primary state
 
 - SQLite: `~/.openclaw/mnemospark/state.db`