mnemospark 1.2.1 → 1.3.0

package/openclaw.plugin.json

@@ -1,7 +1,7 @@
 {
   "id": "mnemospark",
   "name": "mnemospark",
-  "version": "1.2.1",
+  "version": "1.3.0",
   "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": "1.2.1",
+  "version": "1.3.0",
   "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",
@@ -85,7 +85,7 @@
     "eslint": "^9.39.2",
     "husky": "^9.1.7",
     "lint-staged": "^16.2.7",
-    "openclaw": "latest",
+    "openclaw": "^2026.4.1",
     "prettier": "^3.8.1",
     "tsup": "^8.0.0",
     "typescript": "^5.7.0",

package/skills/mnemospark/SKILL.md

@@ -18,7 +18,9 @@ Use this skill for mnemospark cloud backup/storage workflows, async operation tr
 
 3. **Flag style:** Use **`--key value`** for all arguments (and bare flags like `--async`, `--latest`, `--renewal`, `--cancel` where applicable). Do **not** build shell commands with slash prefixes (`/mnemospark …`) or `name:value` forms—those are for **in-chat** slash UX. The chat handler accepts multiple spellings; **shell automation must use `--key value`**.
 
-4. **Discovery:** `node <ABSOLUTE_PATH_TO_EXTENSION>/dist/cli.js cloud help` shows the same help as `/mnemospark cloud help`.
+4. **SQLite:** Do **not** use the host `sqlite3` binary to read `~/.openclaw/mnemospark/state.db`. mnemospark uses Node’s built-in SQLite (`node:sqlite`). For **`price-storage`** after a local **backup**, you may **omit `--object-id-hash`**; the CLI reads sha256 from local state. Otherwise pass `--object-id-hash` from backup output.
+
+5. **Discovery:** `node <ABSOLUTE_PATH_TO_EXTENSION>/dist/cli.js cloud help` shows the same help as `/mnemospark cloud help`.
 
 ## Inputs expected
 
@@ -50,7 +52,7 @@ Let `CLI` = `node <ABSOLUTE_PATH_TO_EXTENSION>/dist/cli.js cloud`. Replace `<ABS
 **Primary subcommands**
 
 - `CLI backup <file|directory> --name <friendly-name> [--async] [--orchestrator <inline|subagent>] [--timeout-seconds <n>]` — **`--name` is required.**
-- `CLI price-storage --wallet-address <addr> --object-id <id> --object-id-hash <hash> --gb <gb> --provider <provider> --region <region>` — **`--provider` and `--region` are required** (defaults often `aws` / `us-east-1`; override as needed).
+- `CLI price-storage --wallet-address <addr> --object-id <id> [--object-id-hash <hash>] --gb <gb> --provider <provider> --region <region>` — **`--provider` and `--region` are required** (defaults often `aws` / `us-east-1`; override as needed). Omit **`--object-id-hash`** when the object row exists in local SQLite after **backup**; pass it when quoting without a prior local backup row.
 - `CLI 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>]`
 - `CLI ls --wallet-address <addr> [--object-key <object-key> | --name <friendly-name>] [--latest|--at <timestamp>]`
 - `CLI download --wallet-address <addr> [--object-key <object-key> | --name <friendly-name>] [--latest|--at <timestamp>] [--async] [--orchestrator <inline|subagent>] [--timeout-seconds <n>]`

package/skills/mnemospark/references/commands.md

@@ -15,7 +15,7 @@ Slash usage: `/mnemospark cloud <subcommand> …`. CLI/agent: `node dist/cli.js
 
 ### Price storage quote
 
-`price-storage --wallet-address <addr> --object-id <id> --object-id-hash <hash> --gb <gb> --provider aws --region us-east-1` (defaults; override `--provider` / `--region` for other regions)
+`price-storage --wallet-address <addr> --object-id <id> [--object-id-hash <hash>] --gb <gb> --provider aws --region us-east-1` (defaults; override `--provider` / `--region` for other regions). Omit `--object-id-hash` when the object already exists in local SQLite after **backup** (mnemospark resolves sha256 via `node:sqlite`; do not shell out to the `sqlite3` binary).
 
 ### Upload
 
@@ -25,6 +25,7 @@ Slash usage: `/mnemospark cloud <subcommand> …`. CLI/agent: `node dist/cli.js
 - 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`.
+- **OpenClaw 2026.4.x:** On the first successful upload, mnemospark applies the **Renewal Agent Runbook** automatically (dedicated agent `mnemospark-renewal`, `exec-approvals.json` entry for `/usr/bin/node`, `openclaw config validate`, best-effort gateway restart), then registers the monthly isolated cron with `--no-deliver` and a `Command: /usr/bin/node … dist/cli.js cloud payment-settle --renewal …` payload. See the main README for `MNEMOSPARK_CRON_*` overrides.
 
 ### Payment settle (scheduled / manual)
 

package/scripts/README.md

@@ -1,55 +0,0 @@
-# Scripts
-
-Development and install scripts for mnemospark.
-
-## Install scripts (run once per machine)
-
-**Prerequisites:** Node.js v20+ is required for pnpm. AWS credentials and GitHub auth are configured separately (IAM role, `aws configure`, `gh auth login`).
-
-| Script                         | Purpose                                          |
-| ------------------------------ | ------------------------------------------------ |
-| `./scripts/install-pnpm.sh`    | Enable pnpm via Node corepack. Idempotent.       |
-| `./scripts/install-aws-cli.sh` | Install AWS CLI v2 on Ubuntu x86_64. Idempotent. |
-| `./scripts/install-jq.sh`      | Optional: install jq via apt. Idempotent.        |
-
-Run from repo root, e.g.:
-
-```bash
-./scripts/install-pnpm.sh
-./scripts/install-aws-cli.sh
-```
-
-AWS CLI credentials are not installed by the script; use IAM role or `aws configure` per environment.
-
-## Verification
-
-```bash
-./scripts/verify-dev-tools.sh
-```
-
-Checks: `aws --version`, `aws sts get-caller-identity`, `node -v`, `pnpm -v`, `git --version`, `gh auth status`. Optionally runs `pnpm install`, `pnpm build`, `pnpm test` unless `SKIP_PNPM_BUILD=1`.
-
-Full pass requires AWS credentials and `gh auth login` to be configured.
-
-## Optional: jq
-
-jq is optional (per development_tools_requirements_doc). To install on Ubuntu:
-
-```bash
-sudo apt install -y jq
-```
-
-Or run `./scripts/install-jq.sh` if present.
-
-## Documentation
-
-Documentation lives in the separate **mnemospark-docs** repository. Clone or open that repo directly when editing product and API docs:
-
-- Repo: `git@github.com:pawlsclick/mnemospark-docs.git`
-
-Do not expect a `.company` subdirectory in this repo; that Git submodule has been removed in favor of working directly in `mnemospark-docs`.
-
-## Other scripts
-
-- `reinstall.sh` — Reinstall mnemospark OpenClaw plugin.
-- `uninstall.sh` — Uninstall mnemospark plugin and clean config.

package/scripts/install-aws-cli.sh

@@ -1,28 +0,0 @@
-#!/usr/bin/env bash
-# Install AWS CLI v2 on Ubuntu (x86_64). Idempotent: if aws --version already shows v2.x, exit 0.
-# Credentials are out of scope (IAM role or aws configure per environment).
-set -e
-
-AWS_URL="https://awscli.amazonaws.com/awscli-exe-linux-x86_64.zip"
-TMP_DIR="${TMPDIR:-/tmp}/awscliv2-$$"
-
-if command -v aws >/dev/null 2>&1; then
-  ver=$(aws --version 2>&1 || true)
-  if [[ "$ver" =~ aws-cli/2\. ]]; then
-    echo "AWS CLI v2 already installed: $ver"
-    exit 0
-  fi
-fi
-
-cleanup() { rm -rf "$TMP_DIR"; }
-trap cleanup EXIT
-mkdir -p "$TMP_DIR"
-cd "$TMP_DIR"
-
-echo "Downloading AWS CLI v2..."
-curl -sSfL "$AWS_URL" -o awscliv2.zip
-unzip -q awscliv2.zip
-sudo ./aws/install -i /usr/local/aws-cli -b /usr/local/bin
-
-echo "AWS CLI v2 installed: $(aws --version)"
-exit 0

package/scripts/install-jq.sh

@@ -1,13 +0,0 @@
-#!/usr/bin/env bash
-# Optional: install jq on Ubuntu. Idempotent: if jq already works, exit 0.
-# See development_tools_requirements_doc.md §2.7 — jq is optional.
-set -e
-
-if command -v jq >/dev/null 2>&1; then
-  jq --version >/dev/null 2>&1 && { echo "jq already installed: $(jq --version)"; exit 0; }
-fi
-
-sudo apt-get update -qq
-sudo apt-get install -y jq
-echo "jq installed: $(jq --version)"
-exit 0

package/scripts/install-pnpm.sh

@@ -1,20 +0,0 @@
-#!/usr/bin/env bash
-# Install and enable pnpm on Ubuntu dev instance via Node corepack.
-# Idempotent: if pnpm already works, exit 0.
-# Prerequisite: Node.js v20+ (engines in package.json).
-set -e
-
-if command -v pnpm >/dev/null 2>&1; then
-  pnpm -v >/dev/null 2>&1 && { echo "pnpm already installed: $(pnpm -v)"; exit 0; }
-fi
-
-if ! command -v node >/dev/null 2>&1; then
-  echo "Error: Node.js is required. Install Node.js v20+ first." >&2
-  exit 1
-fi
-
-corepack enable
-corepack prepare pnpm@latest --activate
-
-echo "pnpm installed: $(pnpm -v)"
-exit 0

package/scripts/reinstall.sh

@@ -1,102 +0,0 @@
-#!/bin/bash
-set -e
-
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-
-echo "mnemospark reinstall"
-echo ""
-
-# 1. Remove mnemospark plugin files only
-echo "→ Removing plugin files..."
-rm -rf ~/.openclaw/extensions/mnemospark
-
-# 2. Clean only mnemospark config entries (do not touch blockrun/openclaw)
-echo "→ Cleaning config entries (mnemospark only)..."
-node -e "
-const f = require('os').homedir() + '/.openclaw/openclaw.json';
-const fs = require('fs');
-if (!fs.existsSync(f)) {
-  console.log('  No openclaw.json found, skipping');
-  process.exit(0);
-}
-
-let c;
-try {
-  c = JSON.parse(fs.readFileSync(f, 'utf8'));
-} catch (err) {
-  const backupPath = f + '.corrupt.' + Date.now();
-  console.error('  ERROR: Invalid JSON in openclaw.json');
-  console.error('  ' + err.message);
-  try {
-    fs.copyFileSync(f, backupPath);
-    console.log('  Backed up to: ' + backupPath);
-  } catch {}
-  console.log('  Skipping config cleanup...');
-  process.exit(0);
-}
-
-if (c.plugins?.entries?.mnemospark) delete c.plugins.entries.mnemospark;
-if (c.plugins?.installs?.mnemospark) delete c.plugins.installs.mnemospark;
-if (Array.isArray(c.plugins?.allow)) {
-  c.plugins.allow = c.plugins.allow.filter(p => p !== 'mnemospark');
-}
-fs.writeFileSync(f, JSON.stringify(c, null, 2));
-console.log('  Config cleaned');
-"
-
-# 3. Kill mnemospark proxy (port 7120)
-echo "→ Stopping old proxy..."
-lsof -ti :7120 | xargs kill -9 2>/dev/null || true
-
-# 4. Remove stale models cache so it gets regenerated
-echo "→ Cleaning models cache..."
-rm -f ~/.openclaw/agents/main/agent/models.json 2>/dev/null || true
-
-# 5. Install mnemospark plugin
-echo "→ Installing mnemospark..."
-openclaw plugins install mnemospark
-
-# 6. Verify installation
-echo "→ Verifying installation..."
-DIST_PATH="$HOME/.openclaw/extensions/mnemospark/dist/index.js"
-if [ ! -f "$DIST_PATH" ]; then
-  echo "  ⚠️  dist/ files missing, clearing npm cache and retrying..."
-  npm cache clean --force 2>/dev/null || true
-  rm -rf ~/.openclaw/extensions/mnemospark
-  openclaw plugins install mnemospark
-
-  if [ ! -f "$DIST_PATH" ]; then
-    echo "  ❌ Installation failed - dist/index.js still missing"
-    exit 1
-  fi
-fi
-echo "  ✓ dist/index.js verified"
-
-# 7. Ensure mnemospark is in plugins.allow
-echo "→ Adding to plugins allow list..."
-node -e "
-const os = require('os');
-const fs = require('fs');
-const path = require('path');
-const configPath = path.join(os.homedir(), '.openclaw', 'openclaw.json');
-
-if (fs.existsSync(configPath)) {
-  try {
-    const config = JSON.parse(fs.readFileSync(configPath, 'utf8'));
-    if (!config.plugins) config.plugins = {};
-    if (!Array.isArray(config.plugins.allow)) config.plugins.allow = [];
-    if (!config.plugins.allow.includes('mnemospark')) {
-      config.plugins.allow.push('mnemospark');
-      console.log('  Added mnemospark to plugins.allow');
-    }
-    fs.writeFileSync(configPath, JSON.stringify(config, null, 2));
-  } catch (e) {
-    console.log('  Could not update config:', e.message);
-  }
-}
-"
-
-echo ""
-echo "✓ Done. Run: openclaw gateway restart"
-echo ""
-echo "To uninstall: bash ~/.openclaw/extensions/mnemospark/scripts/uninstall.sh"

package/scripts/uninstall.sh

@@ -1,67 +0,0 @@
-#!/bin/bash
-set -e
-
-echo "mnemospark uninstall"
-echo ""
-
-# 1. Stop mnemospark proxy (port 7120)
-echo "→ Stopping proxy..."
-lsof -ti :7120 | xargs kill -9 2>/dev/null || true
-
-# 2. Remove mnemospark plugin files only
-echo "→ Removing plugin files..."
-rm -rf ~/.openclaw/extensions/mnemospark
-
-# 3. Clean only mnemospark entries from openclaw.json (do not touch blockrun/openclaw)
-echo "→ Cleaning openclaw.json (mnemospark only)..."
-node -e "
-const os = require('os');
-const fs = require('fs');
-const path = require('path');
-const configPath = path.join(os.homedir(), '.openclaw', 'openclaw.json');
-
-if (!fs.existsSync(configPath)) {
-  console.log('  No openclaw.json found, skipping');
-  process.exit(0);
-}
-
-try {
-  const config = JSON.parse(fs.readFileSync(configPath, 'utf8'));
-  let changed = false;
-
-  // Remove only mnemospark plugin entries
-  if (config.plugins?.entries?.mnemospark) {
-    delete config.plugins.entries.mnemospark;
-    changed = true;
-  }
-  if (config.plugins?.installs?.mnemospark) {
-    delete config.plugins.installs.mnemospark;
-    changed = true;
-  }
-
-  // Remove only mnemospark from plugins.allow
-  if (Array.isArray(config.plugins?.allow)) {
-    const before = config.plugins.allow.length;
-    config.plugins.allow = config.plugins.allow.filter(p => p !== 'mnemospark');
-    if (config.plugins.allow.length !== before) {
-      console.log('  Removed mnemospark from plugins.allow');
-      changed = true;
-    }
-  }
-
-  if (changed) {
-    fs.writeFileSync(configPath, JSON.stringify(config, null, 2));
-    console.log('  Config cleaned');
-  } else {
-    console.log('  No mnemospark entries found');
-  }
-} catch (err) {
-  console.error('  Error:', err.message);
-}
-"
-
-echo ""
-echo "✓ mnemospark uninstalled"
-echo ""
-echo "Restart OpenClaw to apply changes:"
-echo "  openclaw gateway restart"

package/scripts/verify-dev-tools.sh

@@ -1,56 +0,0 @@
-#!/usr/bin/env bash
-# Verify required development tools for mnemospark. Exit 0 only if all checks pass.
-# Run from repo root. AWS credentials and gh auth must be configured for full pass.
-# Optional: set SKIP_PNPM_BUILD=1 to skip pnpm install/build/test (e.g. when no AWS creds).
-set -e
-
-REPO_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
-cd "$REPO_ROOT"
-
-fail() { echo "  FAIL: $1" >&2; exit 1; }
-
-echo "Checking aws..."
-command -v aws >/dev/null 2>&1 || fail "aws not found. Run scripts/install-aws-cli.sh"
-aws --version >/dev/null 2>&1 || fail "aws --version failed"
-echo "  ok"
-
-echo "Checking aws sts get-caller-identity..."
-aws sts get-caller-identity >/dev/null 2>&1 || fail "AWS credentials not configured (aws sts get-caller-identity failed). Use IAM role or aws configure."
-echo "  ok"
-
-echo "Checking node..."
-command -v node >/dev/null 2>&1 || fail "node not found. Install Node.js v20+."
-node -v >/dev/null 2>&1 || fail "node -v failed"
-echo "  ok"
-
-echo "Checking pnpm..."
-command -v pnpm >/dev/null 2>&1 || fail "pnpm not found. Run scripts/install-pnpm.sh"
-pnpm -v >/dev/null 2>&1 || fail "pnpm -v failed"
-echo "  ok"
-
-echo "Checking git..."
-command -v git >/dev/null 2>&1 || fail "git not found"
-git --version >/dev/null 2>&1 || fail "git --version failed"
-echo "  ok"
-
-echo "Checking gh auth status..."
-command -v gh >/dev/null 2>&1 || fail "gh (GitHub CLI) not found"
-# Use --json so exit code is 0 when logged in (avoids exit 1 from "plain text" warning)
-gh auth status --json hosts >/dev/null 2>&1 || fail "gh auth status failed. Run gh auth login."
-echo "  ok"
-
-if [[ "${SKIP_PNPM_BUILD}" == "1" ]]; then
-  echo "Skipping pnpm install/build/test (SKIP_PNPM_BUILD=1)"
-else
-  echo "Running pnpm install..."
-  pnpm install || fail "pnpm install failed"
-  echo "  ok"
-  echo "Running pnpm build..."
-  pnpm build || fail "pnpm build failed"
-  echo "  ok"
-  echo "Running pnpm test..."
-  pnpm test || fail "pnpm test failed"
-  echo "  ok"
-fi
-
-echo "All required dev tools verified."