mnemospark 1.0.1 → 1.2.0

package/dist/index.js

@@ -3014,6 +3014,15 @@ var USER_AGENT = `mnemospark/${VERSION}`;
 import { existsSync, readFileSync } from "fs";
 import { privateKeyToAccount as privateKeyToAccount6 } from "viem/accounts";
 
+// src/cloud-help-onboarding.ts
+var CLOUD_ONBOARDING_BLOCK_LINES = [
+  "",
+  "Start here to securely upload a file and we'll guide you along the way. Copy the line below and replace <file|directory> with the file or directory you'd like to save to the cloud and replace <friendly-name> with an easy to remember name.",
+  "",
+  "`/mnemospark cloud backup <file|directory> name:<friendly-name> async:true`",
+  ""
+];
+
 // src/cloud-command.ts
 import { spawn } from "child_process";
 import {
@@ -4261,7 +4270,7 @@ function expandTilde(path) {
 }
 var CLOUD_HELP_TEXT = [
   "\u2601\uFE0F **mnemospark - Wallet and go.** \u{1F499}",
-  "",
+  ...CLOUD_ONBOARDING_BLOCK_LINES,
   "**Syntax:** use `/mnemospark cloud \u2026`. Prefer `key:value` for arguments; `key=value` and `--key value` are also accepted. Optional verbose markers: `cloud:true`, `price-storage:true`, etc. Aliases: `wallet:` \u2192 wallet-address, `object:` \u2192 object-id, `quote:` \u2192 quote-id, `hash:` \u2192 object-id-hash.",
   "",
   "**Cloud Commands**",
@@ -5398,8 +5407,11 @@ async function maybeCleanupLocalBackupArchive(archivePath) {
   } catch {
   }
 }
+function formatMnemosparkCommandCopyBlock(commandLine) {
+  return ["```", commandLine, "```"].join("\n");
+}
 function formatStorageUploadUserMessage(upload, cronJobId) {
-  const lsLine = `/mnemospark cloud ls wallet-address:\`${upload.addr}\``;
+  const lsCommand = `/mnemospark cloud ls wallet-address:${upload.addr}`;
   return [
     `Your file \`${upload.object_id}\` with key \`${upload.object_key}\` has been stored using \`${upload.provider}\` in folder \`${upload.bucket_name}\` in region \`${upload.location}\``,
     "",
@@ -5407,7 +5419,7 @@ function formatStorageUploadUserMessage(upload, cronJobId) {
     "",
     "To view your cloud storage run the command:",
     "",
-    lsLine,
+    formatMnemosparkCommandCopyBlock(lsCommand),
     "",
     "Thank you for using mnemospark!",
     `Reach out if you need anything: ${MNEMOSPARK_SUPPORT_EMAIL}`
@@ -5457,13 +5469,13 @@ function extractLsErrorMessage(error) {
   return null;
 }
 function formatPriceStorageUserMessage(quote, localArchiveHint) {
-  const uploadLine = `/mnemospark cloud upload quote-id:\`${quote.quote_id}\` wallet-address:\`${quote.addr}\` object-id:\`${quote.object_id}\` object-id-hash:\`${quote.object_id_hash}\``;
+  const uploadCommand = `/mnemospark cloud upload quote-id:${quote.quote_id} wallet-address:${quote.addr} object-id:${quote.object_id} object-id-hash:${quote.object_id_hash}`;
   const lines = [
     `Your storage quote \`${quote.quote_id}\`: storage price \`$${quote.storage_price}\` for file \`${quote.object_id}\` with file size \`${quote.object_size_gb}\` in \`${quote.provider}\` \`${quote.location}\`.`,
     "",
     "If you accept this quote, run:",
     "",
-    uploadLine,
+    formatMnemosparkCommandCopyBlock(uploadCommand),
     ""
   ];
   if (localArchiveHint?.trim()) {
@@ -5482,7 +5494,7 @@ var DEFAULT_BACKUP_QUOTE_PROVIDER = "aws";
 var DEFAULT_BACKUP_QUOTE_REGION = "us-east-1";
 function formatBackupSuccessUserMessage(result, walletAddress, friendlyName) {
   const hash = result.objectIdHash.replace(/\s/g, "");
-  const priceStorageLine = `/mnemospark cloud price-storage wallet-address:\`${walletAddress}\` object-id:\`${result.objectId}\` object-id-hash:\`${hash}\` gb:\`${result.objectSizeGb}\` provider:${DEFAULT_BACKUP_QUOTE_PROVIDER} region:${DEFAULT_BACKUP_QUOTE_REGION}`;
+  const priceStorageCommand = `/mnemospark cloud price-storage wallet-address:${walletAddress} object-id:${result.objectId} object-id-hash:${hash} gb:${result.objectSizeGb} provider:${DEFAULT_BACKUP_QUOTE_PROVIDER} region:${DEFAULT_BACKUP_QUOTE_REGION}`;
   return [
     `Backup archive: \`${result.archivePath}\``,
     "",
@@ -5493,7 +5505,7 @@ function formatBackupSuccessUserMessage(result, walletAddress, friendlyName) {
     "",
     "Next, request a storage quote.",
     "",
-    priceStorageLine,
+    formatMnemosparkCommandCopyBlock(priceStorageCommand),
     "",
     `The default region is ${DEFAULT_BACKUP_QUOTE_REGION}. Change the command parameters to switch regions (not required).`,
     "",
@@ -6498,14 +6510,20 @@ ${operation.result_text}` : meta;
             error_message: operationAfterDispatch?.error_message ?? null
           });
         }
+        const subagentMetaLines = [
+          `Operation started in background. operation-id: ${operationId}`,
+          `orchestrator: subagent`,
+          `subagent-session-id: ${dispatchResult.sessionId}`,
+          timeoutSeconds ? `timeout-seconds: ${timeoutSeconds}` : null
+        ].filter((line) => Boolean(line));
         return {
           text: [
-            `Operation started in background. operation-id: ${operationId}`,
-            `orchestrator: subagent`,
-            `subagent-session-id: ${dispatchResult.sessionId}`,
-            timeoutSeconds ? `timeout-seconds: ${timeoutSeconds}` : null,
-            `Use /mnemospark cloud op-status operation-id:${operationId}`
-          ].filter((line) => Boolean(line)).join("\n")
+            ...subagentMetaLines,
+            "",
+            formatMnemosparkCommandCopyBlock(
+              `/mnemospark cloud op-status operation-id:${operationId}`
+            )
+          ].join("\n")
         };
       } catch (dispatchError) {
         const dispatchMessage = dispatchError instanceof Error ? dispatchError.message : String(dispatchError);
@@ -6607,7 +6625,8 @@ operation-id: ${operationId}`,
       text: [
         `Operation started in background. operation-id: ${operationId}`,
         `orchestrator: inline`,
-        `Use /mnemospark cloud op-status operation-id:${operationId}`
+        "",
+        formatMnemosparkCommandCopyBlock(`/mnemospark cloud op-status operation-id:${operationId}`)
       ].join("\n")
     };
   }
@@ -7349,17 +7368,21 @@ operation-id: ${operationId}`,
 // src/mnemospark-handler.ts
 var MNEMOSPARK_ROOT_HELP_TEXT = [
   "\u2601\uFE0F **mnemospark - Wallet and go.** \u{1F499}",
+  ...CLOUD_ONBOARDING_BLOCK_LINES,
+  "To view the full help menu use these commands:",
   "",
-  "**Syntax:** `/mnemospark cloud \u2026` or `/mnemospark wallet \u2026`",
-  "Arguments may use `key:value`, `key=value`, or `--key value`. Optional verbose markers: `cloud:true`, `price-storage:true`, etc. (same as bare words).",
-  "Aliases include `wallet:` \u2192 wallet-address, `object:` \u2192 object-id, `quote:` \u2192 quote-id (see `/mnemospark cloud help`).",
-  "",
-  "**Cloud storage** \u2014 full reference:",
+  "**Cloud storage**",
   "\u2022 `/mnemospark cloud help`",
   "",
-  "**Wallet** \u2014 status:",
+  "**Wallet status and funding link:**",
   "\u2022 `/mnemospark wallet`",
-  "\u2022 `/mnemospark wallet help` \u2014 commands and funding link"
+  "\u2022 `/mnemospark wallet help`",
+  "",
+  "**Let your agent run mnemospark for you:**",
+  "",
+  "mnemospark installs as an OpenClaw extension under `~/.openclaw/extensions/mnemospark/`. Point your agent at the bundled skill:",
+  "",
+  "Install the mnemospark skill available at `~/.openclaw/extensions/mnemospark/skills/mnemospark/SKILL.md`"
 ].join("\n");
 var MNEMOSPARK_WALLET_HELP_TEXT = (address) => [
   "\u2601\uFE0F **mnemospark Wallet**",