mnemospark 1.4.0 → 1.6.0

package/README.md

@@ -31,23 +31,15 @@ openclaw gateway start
 > Plugin registration is done by `openclaw plugins install mnemospark`.
 > The install also bundles the `skills/mnemospark` skill package so the main agent can delegate mnemospark workflows.
 
-### 2) (Optional) Initialize wallet helpers
-
-```bash
-npx mnemospark install --standard
-```
-
-This creates/reuses local wallet helper files under `~/.openclaw/mnemospark/`.
-
-### 3) Restart gateway after updates
+### 2) Restart gateway after updates
 
 ```bash
 openclaw gateway restart
 ```
 
-### 4) Use slash commands in OpenClaw chat
+### 3) Use slash commands in OpenClaw chat
 
-- `/mnemospark wallet` → wallet status; `/mnemospark wallet help` → commands
+- `/mnemospark wallet` → wallet status; `/mnemospark wallet help` → commands; `/mnemospark wallet create` → new key (backs up existing default `wallet.key` if present)
 - `/mnemospark cloud help` → storage command guide
 
 ---
@@ -85,6 +77,7 @@ Have ChatGPT or your favorite LLM evaluate the mnemospark codebase. Here's a [st
 
 - `/mnemospark wallet` — address, balance, and key file path
 - `/mnemospark wallet help` — command list and funding link
+- `/mnemospark wallet create` — create a new wallet (and backup an existing default key file)
 - `/mnemospark wallet export` — export private key for backup (sensitive)
 
 ---

package/dist/cli.js

@@ -2912,7 +2912,8 @@ async function startProxy(options) {
 }
 
 // src/auth.ts
-import { writeFile as writeFile2, readFile as readFile2, mkdir as mkdir3 } from "fs/promises";
+import { existsSync, readFileSync } from "fs";
+import { copyFile, writeFile as writeFile2, readFile as readFile2, mkdir as mkdir3 } from "fs/promises";
 import { join as join5 } from "path";
 import { homedir as homedir4 } from "os";
 import { generatePrivateKey, privateKeyToAccount as privateKeyToAccount4 } from "viem/accounts";
@@ -2927,6 +2928,32 @@ var LEGACY_WALLET_DIR = join5(homedir4(), ".openclaw", "blockrun");
 var LEGACY_WALLET_FILE = join5(LEGACY_WALLET_DIR, "wallet.key");
 var WALLET_DIR = join5(homedir4(), ".openclaw", "mnemospark", "wallet");
 var WALLET_FILE = join5(WALLET_DIR, "wallet.key");
+function resolveWalletKeyForSlashCommandsSync() {
+  const envKey = process.env.MNEMOSPARK_WALLET_KEY?.trim();
+  if (isValidWalletPrivateKey(envKey)) {
+    const account = privateKeyToAccount4(envKey);
+    return {
+      walletKey: envKey,
+      address: account.address,
+      keyPathLabel: "MNEMOSPARK_WALLET_KEY (environment variable)"
+    };
+  }
+  for (const path of [WALLET_FILE, LEGACY_WALLET_FILE]) {
+    try {
+      if (!existsSync(path)) {
+        continue;
+      }
+      const raw = readFileSync(path, "utf-8").trim();
+      if (!isValidWalletPrivateKey(raw)) {
+        continue;
+      }
+      const account = privateKeyToAccount4(raw);
+      return { walletKey: raw, address: account.address, keyPathLabel: path };
+    } catch {
+    }
+  }
+  return null;
+}
 async function loadSavedWallet() {
   for (const path of [WALLET_FILE, LEGACY_WALLET_FILE]) {
     try {
@@ -2964,6 +2991,33 @@ async function generateAndSaveWallet() {
   }
   return { key, address: account.address };
 }
+function pickUniqueWalletKeyBackupPath(walletKeyPath) {
+  const d = /* @__PURE__ */ new Date();
+  const y = d.getFullYear();
+  const m = String(d.getMonth() + 1).padStart(2, "0");
+  const day = String(d.getDate()).padStart(2, "0");
+  const base2 = `${walletKeyPath}.bak-${y}-${m}-${day}`;
+  if (!existsSync(base2)) {
+    return base2;
+  }
+  let n = 2;
+  for (; ; ) {
+    const candidate = `${base2}-${n}`;
+    if (!existsSync(candidate)) {
+      return candidate;
+    }
+    n += 1;
+  }
+}
+async function createMnemosparkWalletWithOptionalBackup() {
+  let backupPath;
+  if (existsSync(WALLET_FILE)) {
+    backupPath = pickUniqueWalletKeyBackupPath(WALLET_FILE);
+    await copyFile(WALLET_FILE, backupPath);
+  }
+  const { key, address } = await generateAndSaveWallet();
+  return { backupPath, key, address };
+}
 async function resolveOrGenerateWalletKey() {
   const envKey = process.env.MNEMOSPARK_WALLET_KEY?.trim();
   if (isValidWalletPrivateKey(envKey)) {
@@ -2990,10 +3044,6 @@ var pkg = require2(join6(__dirname, "..", "package.json"));
 var VERSION = pkg.version;
 var USER_AGENT = `mnemospark/${VERSION}`;
 
-// src/mnemospark-handler.ts
-import { existsSync, readFileSync } from "fs";
-import { privateKeyToAccount as privateKeyToAccount6 } from "viem/accounts";
-
 // src/cloud-help-onboarding.ts
 var CLOUD_ONBOARDING_BLOCK_LINES = [
   "",
@@ -3211,6 +3261,20 @@ function renderHeader(w) {
     HDR_FILE_OR_KEY
   ].join(" ");
 }
+function formatLsCommandCopyBlock(commandLine) {
+  return ["```", commandLine, "```"].join("\n");
+}
+function formatLsWhatsNextFooter(walletAddress) {
+  const downloadLine = `/mnemospark cloud download wallet-address:${walletAddress} [object-key:<object-key> | name:<friendly-name>] [latest:true|at:<timestamp>] [async:true] [orchestrator:<inline|subagent>] [timeout-seconds:<n>]`;
+  const deleteLine = `/mnemospark cloud delete wallet-address:${walletAddress} [object-key:<object-key> | name:<friendly-name>] [latest:true|at:<timestamp>]`;
+  return [
+    "What's next? Would you like to download or delete a file:",
+    "",
+    formatLsCommandCopyBlock(downloadLine),
+    "",
+    formatLsCommandCopyBlock(deleteLine)
+  ].join("\n");
+}
 async function buildMnemosparkLsMessage(result, ctx) {
   const now = ctx.now ?? /* @__PURE__ */ new Date();
   if (isStorageLsListResponse(result)) {
@@ -3227,7 +3291,9 @@ async function buildMnemosparkLsMessage(result, ctx) {
     const fence2 = ["```", [header2, ...bodyLines].join("\n"), "```"].join("\n");
     return `${prose2}
 
-${fence2}`;
+${fence2}
+
+${formatLsWhatsNextFooter(ctx.walletAddress)}`;
   }
   const friendly = await ctx.datastore.findLatestFriendlyNameForObjectKey(
     ctx.walletAddress,
@@ -3264,7 +3330,9 @@ ${fence2}`;
   const fence = ["```", [header, line].join("\n"), "```"].join("\n");
   return `${prose}
 
-${fence}`;
+${fence}
+
+${formatLsWhatsNextFooter(ctx.walletAddress)}`;
 }
 
 // src/cloud-datastore.ts
@@ -4129,7 +4197,8 @@ function routeMnemosparkArgs(args) {
       "\u2022 `/mnemospark help` \u2014 overview",
       "\u2022 `/mnemospark cloud help` \u2014 cloud commands",
       "\u2022 `/mnemospark wallet` \u2014 wallet status",
-      "\u2022 `/mnemospark wallet help` \u2014 wallet commands"
+      "\u2022 `/mnemospark wallet help` \u2014 wallet commands",
+      "\u2022 `/mnemospark wallet create` \u2014 new wallet (backs up existing default key)"
     ].join("\n")
   };
 }
@@ -7589,6 +7658,7 @@ var MNEMOSPARK_ROOT_HELP_TEXT = [
   "**Wallet status and funding link:**",
   "\u2022 `/mnemospark wallet`",
   "\u2022 `/mnemospark wallet help`",
+  "\u2022 `/mnemospark wallet create`",
   "",
   "**Let your agent run mnemospark for you:**",
   "",
@@ -7602,6 +7672,7 @@ var MNEMOSPARK_WALLET_HELP_TEXT = (address) => [
   "**Commands:**",
   "\u2022 `/mnemospark wallet` \u2014 Show address, balance, and key file path",
   "\u2022 `/mnemospark wallet help` \u2014 This message",
+  "\u2022 `/mnemospark wallet create` \u2014 Create a new wallet (and backup an existing wallet)",
   "\u2022 `/mnemospark wallet export` \u2014 Export private key for backup (sensitive)",
   "",
   `**Fund with USDC on Base:** https://basescan.org/address/${address}`
@@ -7611,26 +7682,7 @@ function getDefaultCloudCommandHandler() {
   defaultCloudCommandHandler ??= createCloudCommand().handler;
   return defaultCloudCommandHandler;
 }
-var NO_WALLET_FOUND_TEXT = "No mnemospark wallet found. Run `openclaw plugins install mnemospark`.";
-function resolveWalletFileSync() {
-  try {
-    if (!existsSync(WALLET_FILE)) {
-      return null;
-    }
-    const walletKey = readFileSync(WALLET_FILE, "utf-8").trim();
-    if (!walletKey.startsWith("0x") || walletKey.length !== 66) {
-      return null;
-    }
-    const account = privateKeyToAccount6(walletKey);
-    const address = account.address.replace(/\s/g, "");
-    if (!address) {
-      return null;
-    }
-    return { walletKey, address };
-  } catch {
-    return null;
-  }
-}
+var NO_WALLET_FOUND_TEXT = "No mnemospark wallet found. Run `openclaw plugins install mnemospark` or set MNEMOSPARK_WALLET_KEY.";
 async function runMnemosparkSlashHandler(ctx, options) {
   const route = routeMnemosparkArgs(ctx.args);
   if (route.kind === "root-help") {
@@ -7676,6 +7728,15 @@ async function handleWalletSlash(rest) {
     }
     return buildWalletExportResponse();
   }
+  if (parsed.name === "create") {
+    if (afterFirst.trim()) {
+      return {
+        text: "Unexpected extra arguments after `create`. Use `/mnemospark wallet create` alone.",
+        isError: true
+      };
+    }
+    return buildWalletCreateResponse();
+  }
   if (parsed.name === "status") {
     return buildWalletStatusResponse();
   }
@@ -7684,15 +7745,15 @@ async function handleWalletSlash(rest) {
     isError: true
   };
 }
-async function buildWalletStatusResponse() {
-  const wallet = resolveWalletFileSync();
+async function buildWalletStatusResponse(walletOverride) {
+  const wallet = walletOverride ?? resolveWalletKeyForSlashCommandsSync();
   if (!wallet) {
     return {
       text: NO_WALLET_FOUND_TEXT,
       isError: true
     };
   }
-  const { address } = wallet;
+  const { address, keyPathLabel } = wallet;
   let balanceText = "Balance: (checking...)";
   try {
     const monitor = new BalanceMonitor(address);
@@ -7707,19 +7768,47 @@ async function buildWalletStatusResponse() {
       "",
       `**Address:** \`${address}\``,
       `**${balanceText}**`,
-      `**Key File:** \`${WALLET_FILE}\``,
+      `**Key File:** \`${keyPathLabel}\``,
       "",
       "**Commands:**",
       "\u2022 `/mnemospark wallet` \u2014 Show this status",
       "\u2022 `/mnemospark wallet help` \u2014 Commands and funding link",
+      "\u2022 `/mnemospark wallet create` \u2014 Create a new wallet (and backup an existing wallet)",
       "\u2022 `/mnemospark wallet export` \u2014 Export private key for backup",
       "",
       `**Fund with USDC on Base:** https://basescan.org/address/${address}`
     ].join("\n")
   };
 }
+async function buildWalletCreateResponse() {
+  let backupPath;
+  let createdAddress = "";
+  try {
+    ({ backupPath, address: createdAddress } = await createMnemosparkWalletWithOptionalBackup());
+  } catch (err) {
+    return {
+      text: `Failed to create wallet: ${err instanceof Error ? err.message : String(err)}`,
+      isError: true
+    };
+  }
+  const statusResponse = await buildWalletStatusResponse({
+    address: createdAddress,
+    keyPathLabel: WALLET_FILE
+  });
+  if (statusResponse.isError) {
+    return statusResponse;
+  }
+  const createMessageLines = backupPath ? [
+    "\u2705 Existing wallet key was backed up before creating the new wallet.",
+    `**Backup File:** \`${backupPath}\``
+  ] : ["\u2705 New wallet created."];
+  return {
+    ...statusResponse,
+    text: [...createMessageLines, "", statusResponse.text ?? ""].join("\n")
+  };
+}
 async function buildWalletHelpResponse() {
-  const wallet = resolveWalletFileSync();
+  const wallet = resolveWalletKeyForSlashCommandsSync();
   if (!wallet) {
     return {
       text: NO_WALLET_FOUND_TEXT,
@@ -7730,7 +7819,7 @@ async function buildWalletHelpResponse() {
   return { text: MNEMOSPARK_WALLET_HELP_TEXT(address) };
 }
 async function buildWalletExportResponse() {
-  const wallet = resolveWalletFileSync();
+  const wallet = resolveWalletKeyForSlashCommandsSync();
   if (!wallet) {
     return {
       text: NO_WALLET_FOUND_TEXT,