mnemospark 1.0.0 → 1.1.0

package/dist/cli.js

@@ -4197,12 +4197,12 @@ var TAR_OVERHEAD_BYTES = 10 * 1024 * 1024;
 var QUOTE_VALIDITY_USER_NOTE = "Quotes are valid for one hour. Please run price-storage again if you need a new quote.";
 var MNEMOSPARK_SUPPORT_EMAIL = "pluggedin@mnemospark.ai";
 var CLOUD_HELP_FOOTER_STATE = "Local state: mnemospark records quotes, objects, payments, cron jobs, friendly names, and operation metadata in ~/.openclaw/mnemospark/state.db (SQLite). For troubleshooting and correlation, commands and the HTTP proxy append structured JSON lines to ~/.openclaw/mnemospark/events.jsonl. Monthly storage billing jobs are listed in ~/.openclaw/cron/jobs.json for OpenClaw scheduling.";
-var REQUIRED_PRICE_STORAGE = "--wallet-address, --object-id, --object-id-hash, --gb, --provider, --region";
-var REQUIRED_UPLOAD = "--quote-id, --wallet-address, --object-id, --object-id-hash";
-var REQUIRED_BACKUP = "<file|directory> and --name <friendly-name>";
-var REQUIRED_PAYMENT_SETTLE = "--wallet-address and (--quote-id | --renewal with --object-key)";
-var REQUIRED_STORAGE_OBJECT = "--wallet-address and one of (--object-key | --name [--latest|--at])";
-var REQUIRED_LS = "--wallet-address (for one object add --object-key or --name [--latest|--at]; omit both to list the bucket)";
+var REQUIRED_PRICE_STORAGE = "wallet-address:, object-id:, object-id-hash:, gb:, provider:, region:";
+var REQUIRED_UPLOAD = "quote-id:, wallet-address:, object-id:, object-id-hash:";
+var REQUIRED_BACKUP = "<file|directory> and name:<friendly-name>";
+var REQUIRED_PAYMENT_SETTLE = "wallet-address: and (quote-id: | renewal:true with object-key:)";
+var REQUIRED_STORAGE_OBJECT = "wallet-address: and one of (object-key: | name: [latest:true|at:<timestamp>])";
+var REQUIRED_LS = "wallet-address: (for one object add object-key: or name: [latest:true|at:<timestamp>]; omit both to list the bucket)";
 var ORCHESTRATOR_MODES = /* @__PURE__ */ new Set(["inline", "subagent"]);
 function expandTilde(path) {
   const trimmed = path.trim();
@@ -4217,66 +4217,66 @@ function expandTilde(path) {
 var CLOUD_HELP_TEXT = [
   "\u2601\uFE0F **mnemospark - Wallet and go.** \u{1F499}",
   "",
-  "**Syntax:** use `/mnemospark cloud \u2026`. Arguments may use `key:value`, `key=value`, or `--key value`. 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.",
+  "**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**",
   "",
   "\u2022 `/mnemospark cloud` or `/mnemospark cloud help` \u2014 show this message (equivalent: `/mnemospark cloud:true help:true`)",
   "",
-  "\u2022 `/mnemospark cloud backup <file|directory> --name <friendly-name> [--async] [--orchestrator <inline|subagent>] [--timeout-seconds <n>]`",
+  "\u2022 `/mnemospark cloud backup <file|directory> name:<friendly-name> [async:true] [orchestrator:<inline|subagent>] [timeout-seconds:<n>]`",
   "  Purpose: create a local tar+gzip archive under ~/.openclaw/mnemospark/backup (filename from sanitized friendly name) and record metadata in SQLite for later price-storage and upload.",
   "  Required: " + REQUIRED_BACKUP,
   "",
-  "\u2022 `/mnemospark cloud price-storage --wallet-address <addr> --object-id <id> --object-id-hash <hash> --gb <gb> --provider aws --region us-east-1`",
-  "  Purpose: request a storage quote before upload (defaults shown; override `--provider` / `--region` for other regions).",
+  "\u2022 `/mnemospark cloud price-storage wallet-address:<addr> object-id:<id> object-id-hash:<hash> gb:<gb> provider:aws region:us-east-1`",
+  "  Purpose: request a storage quote before upload (defaults shown; override `provider:` / `region:` for other regions).",
   "  Required: " + REQUIRED_PRICE_STORAGE,
   "  Shorter: `wallet:\u2026 object:\u2026 hash:\u2026 gb:\u2026 provider:\u2026 region:\u2026`",
   "",
-  "\u2022 `/mnemospark cloud 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>]`",
+  "\u2022 `/mnemospark cloud upload quote-id:<quote-id> wallet-address:<addr> object-id:<id> object-id-hash:<hash> [name:<friendly-name>] [async:true] [orchestrator:<inline|subagent>] [timeout-seconds:<n>]`",
   "  Purpose: upload an encrypted object using a valid quote-id.",
   "  Required: " + REQUIRED_UPLOAD,
   "",
-  "\u2022 `/mnemospark cloud payment-settle (--quote-id <quote-id> | --renewal --object-key <key>) --wallet-address <addr> [--object-id <id>] [--storage-price <n>]`",
+  "\u2022 `/mnemospark cloud payment-settle (quote-id:<quote-id> | renewal:true object-key:<key>) wallet-address:<addr> [object-id:<id>] [storage-price:<n>]`",
   "  Purpose: settle storage payment before upload (quote) or on the monthly cron (renewal, no new quote). Uses the same proxy + x402 path as upload pre-settlement.",
   "  Required: " + REQUIRED_PAYMENT_SETTLE + " (wallet private key must match the address).",
   "",
-  "\u2022 `/mnemospark cloud ls --wallet-address <addr> [--object-key <key> | --name <friendly-name> | omit both to list bucket] [--latest|--at <timestamp>]`",
+  "\u2022 `/mnemospark cloud ls wallet-address:<addr> [object-key:<key> | name:<friendly-name> | omit both to list bucket] [latest:true|at:<timestamp>]`",
   "  Purpose: stat one object or list all keys in the wallet bucket (S3).",
   "  Required: " + REQUIRED_LS,
   "",
-  "\u2022 `/mnemospark cloud download --wallet-address <addr> [--object-key <object-key> | --name <friendly-name>] [--latest|--at <timestamp>] [--async] [--orchestrator <inline|subagent>] [--timeout-seconds <n>]`",
+  "\u2022 `/mnemospark cloud download wallet-address:<addr> [object-key:<object-key> | name:<friendly-name>] [latest:true|at:<timestamp>] [async:true] [orchestrator:<inline|subagent>] [timeout-seconds:<n>]`",
   "  Purpose: fetch an object to local disk.",
   "  Required: " + REQUIRED_STORAGE_OBJECT,
   "",
-  "\u2022 `/mnemospark cloud delete --wallet-address <addr> [--object-key <object-key> | --name <friendly-name>] [--latest|--at <timestamp>]`",
+  "\u2022 `/mnemospark cloud delete wallet-address:<addr> [object-key:<object-key> | name:<friendly-name>] [latest:true|at:<timestamp>]`",
   "  Purpose: remove a remote object and local cron tracking when present.",
   "  Required: " + REQUIRED_STORAGE_OBJECT,
   "",
-  "\u2022 `/mnemospark cloud op-status --operation-id <id> [--cancel]`",
+  "\u2022 `/mnemospark cloud op-status operation-id:<id> [cancel:true]`",
   "  Purpose: inspect async operation status, or request cancellation for subagent runs.",
-  "  Required: --operation-id",
+  "  Required: operation-id:<id>",
   "",
   "Async orchestration flags (`backup`, `upload`, `download` only):",
-  "\u2022 `--async`",
+  "\u2022 `async:true`",
   "  Start operation in background and return quickly with operation-id.",
-  "\u2022 `--orchestrator <inline|subagent>`",
+  "\u2022 `orchestrator:<inline|subagent>`",
   "  Choose async engine. Default when omitted is `inline`.",
   "  Use `subagent` for explicit subagent session tracking and cancellation.",
-  "\u2022 `--timeout-seconds <n>`",
-  "  Optional per-operation timeout. Valid only with `--async --orchestrator subagent`.",
+  "\u2022 `timeout-seconds:<n>`",
+  "  Optional per-operation timeout. Valid only with `async:true` and `orchestrator:subagent`.",
   "  `n` must be a positive integer (seconds).",
-  "\u2022 `op-status --cancel`",
+  "\u2022 `op-status` with `cancel:true`",
   "  Cancel a subagent-orchestrated operation by operation-id (idempotent).",
   "",
   "Examples:",
-  "\u2022 `/mnemospark cloud upload ... --async --orchestrator subagent`",
-  "\u2022 `/mnemospark cloud download ... --async --orchestrator subagent --timeout-seconds 900`",
-  "\u2022 `/mnemospark cloud op-status --operation-id <id>`",
-  "\u2022 `/mnemospark cloud op-status --operation-id <id> --cancel`",
+  "\u2022 `/mnemospark cloud upload ... async:true orchestrator:subagent`",
+  "\u2022 `/mnemospark cloud download ... async:true orchestrator:subagent timeout-seconds:900`",
+  "\u2022 `/mnemospark cloud op-status operation-id:<id>`",
+  "\u2022 `/mnemospark cloud op-status operation-id:<id> cancel:true`",
   "",
   CLOUD_HELP_FOOTER_STATE,
   "",
-  "Backup uses your configured mnemospark wallet key (no `--wallet-address` flag). Commands price-storage, upload, ls, download, delete, and payment-settle require `--wallet-address` on the command line (must match that wallet)."
+  "Backup uses your configured mnemospark wallet key (no `wallet-address:` argument). Commands price-storage, upload, ls, download, delete, and payment-settle require `wallet-address:<addr>` (or `wallet:<addr>`) on the command line (must match that wallet)."
 ].join("\n");
 var UnsupportedBackupPlatformError = class extends Error {
   constructor(platform) {
@@ -4397,7 +4397,7 @@ function parseAsyncOperationArgs(flags) {
     timeoutSeconds: parsedTimeoutSeconds === void 0 ? void 0 : parsedTimeoutSeconds
   };
 }
-var INVALID_ASYNC_FLAGS_MESSAGE = "invalid async flags. `--orchestrator`/`--timeout-seconds` require `--async`, and `--timeout-seconds` is only valid with `--orchestrator subagent`.";
+var INVALID_ASYNC_FLAGS_MESSAGE = "invalid async flags. `orchestrator:` and `timeout-seconds:` require `async:true`, and `timeout-seconds:` is only valid with `orchestrator:subagent`.";
 function stripAsyncControlFlags(args) {
   const tokens = tokenizeArgsRaw(args ?? "");
   const filtered = [];
@@ -4793,7 +4793,7 @@ async function resolveLocalUploadArchivePath(backupDir, objectId, friendlyName)
   } catch {
     return {
       ok: false,
-      message: `Cannot upload storage object: local archive not found. Run /mnemospark cloud backup with --name (canonical layout) or restore the legacy file at ${legacyPath}.`
+      message: `Cannot upload storage object: local archive not found. Run /mnemospark cloud backup with name:<friendly-name> (canonical layout) or restore the legacy file at ${legacyPath}.`
     };
   }
 }
@@ -5353,8 +5353,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}\``,
     "",
@@ -5362,7 +5365,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}`
@@ -5412,13 +5415,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()) {
@@ -5437,7 +5440,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}\``,
     "",
@@ -5448,15 +5451,15 @@ 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).`,
     "",
     "Region examples (merge into the command above):",
-    "North America: `--provider aws --region us-east-1`",
-    "Europe: `--provider aws --region eu-north-1`",
-    "South America: `--provider aws --region sa-east-1`",
-    "Asia Pacific: `--provider aws --region ap-northeast-1`"
+    "North America: `provider:aws region:us-east-1`",
+    "Europe: `provider:aws region:eu-north-1`",
+    "South America: `provider:aws region:sa-east-1`",
+    "Asia Pacific: `provider:aws region:ap-northeast-1`"
   ].join("\n");
 }
 function createInProcessSubagentOrchestrator() {
@@ -5937,7 +5940,7 @@ async function runCloudCommandHandler(ctx, options, executionContext = {}) {
   }
   if (parsed.mode === "payment-settle-invalid") {
     return {
-      text: `Cannot settle payment: required arguments are ${REQUIRED_PAYMENT_SETTLE}. Optional: --object-id, --storage-price.`,
+      text: `Cannot settle payment: required arguments are ${REQUIRED_PAYMENT_SETTLE}. Optional: object-id:, storage-price:.`,
       isError: true
     };
   }
@@ -5967,7 +5970,7 @@ async function runCloudCommandHandler(ctx, options, executionContext = {}) {
   }
   if (parsed.mode === "op-status-invalid") {
     return {
-      text: "Cannot get operation status: required arguments are --operation-id.",
+      text: "Cannot get operation status: required arguments are operation-id:<id>.",
       isError: true
     };
   }
@@ -6103,7 +6106,7 @@ ${operation.result_text}` : meta;
     const walletAccount = privateKeyToAccount5(walletKey);
     if (walletAccount.address.toLowerCase() !== req.wallet_address.toLowerCase()) {
       return {
-        text: `Cannot settle payment: wallet key address ${walletAccount.address} does not match --wallet-address ${req.wallet_address}.`,
+        text: `Cannot settle payment: wallet key address ${walletAccount.address} does not match wallet-address: ${req.wallet_address}.`,
         isError: true
       };
     }
@@ -6197,7 +6200,7 @@ ${operation.result_text}` : meta;
       });
       const label = req.renewal ? `object ${req.object_key}` : `quote ${req.quote_id}`;
       return {
-        text: transId ? `Payment settled for ${label} (trans_id: ${transId}).` : `Payment settled for ${label}.`
+        text: transId ? `Payment settled for ${label} (trans-id: ${transId}).` : `Payment settled for ${label}.`
       };
     }
     await datastore.upsertPayment({
@@ -6453,14 +6456,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);
@@ -6562,7 +6571,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")
     };
   }
@@ -6795,7 +6805,7 @@ operation-id: ${operationId}`,
       const walletAccount = privateKeyToAccount5(walletKey);
       if (walletAccount.address.toLowerCase() !== parsed.uploadRequest.wallet_address.toLowerCase()) {
         return {
-          text: `Cannot upload storage object: wallet key address ${walletAccount.address} does not match --wallet-address ${parsed.uploadRequest.wallet_address}.`,
+          text: `Cannot upload storage object: wallet key address ${walletAccount.address} does not match wallet-address: ${parsed.uploadRequest.wallet_address}.`,
           isError: true
         };
       }