run402 1.53.1 → 1.54.1

package/lib/init.mjs

@@ -10,12 +10,23 @@ const TEMPO_RPC = "https://rpc.moderato.tempo.xyz/";
 const HELP = `run402 init — Set up allowance, funding, and check tier status
 
 Usage:
-  run402 init          Set up with x402 (Base Sepolia) — default
-  run402 init mpp      Set up with MPP (Tempo Moderato)
-  run402 init --json   Same as init, but emit a JSON summary on stdout
-                       (human lines go to stderr — for agent automation)
+  run402 init                Set up with x402 (Base Sepolia) — default
+  run402 init mpp            Set up with MPP (Tempo Moderato)
+  run402 init <rail> --switch-rail
+                             Switch the persisted payment rail to <rail>.
+                             Required when an allowance already exists on
+                             the other rail; protects scripted re-runs from
+                             silently flipping billing networks.
+  run402 init --json         Same as init, but emit a JSON summary on stdout
+                             (human lines go to stderr — for agent automation)
 
-Steps (idempotent — safe to re-run):
+Options:
+  --switch-rail   Confirm switching the persisted payment rail. Re-running
+                  init with the SAME rail as the existing allowance is always
+                  idempotent and does not need this flag.
+  --json          Emit a structured JSON summary on stdout.
+
+Steps (idempotent when re-run with the same rail; pass --switch-rail to change rails):
   1. Creates config directory (~/.config/run402)
   2. Creates agent allowance if none exists
   3. Checks on-chain balance; requests faucet if zero
@@ -32,6 +43,19 @@ export async function run(args = []) {
   if (args.includes("--help") || args.includes("-h")) { console.log(HELP); process.exit(0); }
   const jsonMode = args.includes("--json");
   const isMpp = args[0] === "mpp";
+  const requestedRail = isMpp ? "mpp" : "x402";
+  const switchRailConfirmed = args.includes("--switch-rail");
+
+  const existingAllowance = readAllowance();
+  if (existingAllowance?.rail && existingAllowance.rail !== requestedRail && !switchRailConfirmed) {
+    console.error(JSON.stringify({
+      status: "error",
+      code: "RAIL_SWITCH_REQUIRES_CONFIRM",
+      message: `Already on rail '${existingAllowance.rail}'. Pass --switch-rail to switch to '${requestedRail}'.`,
+      details: { current_rail: existingAllowance.rail, requested_rail: requestedRail },
+    }));
+    process.exit(1);
+  }
 
   // In --json mode, human-readable lines go to stderr so stdout stays clean for
   // agents. We also collect structured data for the final JSON emit.
@@ -55,7 +79,7 @@ export async function run(args = []) {
   line("Config", CONFIG_DIR);
 
   // 2. Allowance
-  let allowance = readAllowance();
+  let allowance = existingAllowance;
   const previousRail = allowance?.rail;
   if (!allowance) {
     const { generatePrivateKey, privateKeyToAccount } = await import("viem/accounts");

package/lib/message.mjs

@@ -1,6 +1,6 @@
 import { allowanceAuthHeaders } from "./config.mjs";
 import { getSdk } from "./sdk.mjs";
-import { reportSdkError } from "./sdk-errors.mjs";
+import { reportSdkError, fail } from "./sdk-errors.mjs";
 
 const HELP = `run402 message — Send messages to Run402 developers
 
@@ -16,7 +16,9 @@ Examples:
 `;
 
 async function send(text) {
-  if (!text) { console.error(JSON.stringify({ status: "error", message: "Missing message text" })); process.exit(1); }
+  if (!text) {
+    fail({ code: "BAD_USAGE", message: "Missing message text." });
+  }
   // Preserve the aggressive early exit when no allowance is configured.
   allowanceAuthHeaders("/message/v1");
 

package/lib/projects.mjs

@@ -1,7 +1,7 @@
 import { readFileSync } from "fs";
-import { findProject, loadKeyStore, API, allowanceAuthHeaders, resolveProjectId } from "./config.mjs";
+import { findProject, loadKeyStore, API, allowanceAuthHeaders, resolveProjectId, getActiveProjectId } from "./config.mjs";
 import { getSdk } from "./sdk.mjs";
-import { reportSdkError } from "./sdk-errors.mjs";
+import { reportSdkError, fail, parseFlagJson } from "./sdk-errors.mjs";
 
 const HELP = `run402 projects — Manage your deployed Run402 projects
 
@@ -128,9 +128,16 @@ async function provision(args) {
   // gives the user a more specific prompt than the SDK's 401/402 path.
   allowanceAuthHeaders("/projects/v1");
 
+  const activeBefore = getActiveProjectId();
   try {
     const data = await getSdk().projects.provision({ tier: opts.tier, name: opts.name });
-    console.log(JSON.stringify(data, null, 2));
+    const activeAfter = getActiveProjectId();
+    const out = { ...data };
+    if (activeBefore && activeAfter && activeBefore !== activeAfter) {
+      out.note = `active project changed: ${activeBefore} -> ${activeAfter}`;
+      out.previous_active_project_id = activeBefore;
+    }
+    console.log(JSON.stringify(out, null, 2));
   } catch (err) {
     reportSdkError(err);
   }
@@ -146,12 +153,21 @@ async function applyExpose(projectId, args = []) {
   }
   const raw = file ? readFileSync(file, "utf-8") : inline;
   if (!raw) {
-    console.error(JSON.stringify({ status: "error", message: "Missing manifest. Provide inline JSON or use --file <path>" }));
-    process.exit(1);
+    fail({
+      code: "BAD_USAGE",
+      message: "Missing manifest.",
+      hint: "Provide inline JSON or use --file <path>",
+    });
   }
   let manifest;
   try { manifest = JSON.parse(raw); }
-  catch { console.error(JSON.stringify({ status: "error", message: "Invalid JSON for manifest" })); process.exit(1); }
+  catch (err) {
+    fail({
+      code: "BAD_USAGE",
+      message: "Invalid JSON for manifest",
+      details: { parse_error: err.message },
+    });
+  }
   const res = await fetch(`${API}/projects/v1/admin/${projectId}/expose`, {
     method: "POST",
     headers: { "Authorization": `Bearer ${p.service_key}`, "Content-Type": "application/json" },
@@ -215,11 +231,22 @@ async function sqlCmd(projectId, args = []) {
     else if (!query && !args[i].startsWith("--")) { query = args[i]; }
   }
   const sql = file ? readFileSync(file, "utf-8") : query;
-  if (!sql) { console.error(JSON.stringify({ status: "error", message: "Missing SQL query. Provide inline or use --file <path>" })); process.exit(1); }
+  if (!sql) {
+    fail({
+      code: "BAD_USAGE",
+      message: "Missing SQL query.",
+      hint: "Provide inline or use --file <path>",
+    });
+  }
   let params;
   if (paramsRaw) {
-    try { params = JSON.parse(paramsRaw); } catch { console.error(JSON.stringify({ status: "error", message: "Invalid JSON for --params. Expected a JSON array, e.g. '[42, \"hello\"]'" })); process.exit(1); }
-    if (!Array.isArray(params)) { console.error(JSON.stringify({ status: "error", message: "--params must be a JSON array, e.g. '[42, \"hello\"]'" })); process.exit(1); }
+    params = parseFlagJson("--params", paramsRaw);
+    if (!Array.isArray(params)) {
+      fail({
+        code: "BAD_USAGE",
+        message: "--params must be a JSON array, e.g. '[42, \"hello\"]'",
+      });
+    }
   }
   const useParams = params && params.length > 0;
   const headers = { "Authorization": `Bearer ${p.service_key}`, "Content-Type": useParams ? "application/json" : "text/plain" };
@@ -257,7 +284,13 @@ async function schema(projectId) {
 }
 
 async function use(projectId) {
-  if (!projectId) { console.error("Usage: run402 projects use <project_id>"); process.exit(1); }
+  if (!projectId) {
+    fail({
+      code: "BAD_USAGE",
+      message: "Missing <project_id>.",
+      hint: "run402 projects use <project_id>",
+    });
+  }
   try {
     await getSdk().projects.use(projectId);
     console.log(JSON.stringify({ status: "ok", active_project_id: projectId }));
@@ -267,7 +300,13 @@ async function use(projectId) {
 }
 
 async function pin(projectId) {
-  if (!projectId) { console.error(JSON.stringify({ status: "error", message: "Usage: run402 projects pin <project_id>" })); process.exit(1); }
+  if (!projectId) {
+    fail({
+      code: "BAD_USAGE",
+      message: "Missing <project_id>.",
+      hint: "run402 projects pin <project_id>",
+    });
+  }
   try {
     const data = await getSdk().projects.pin(projectId);
     console.log(JSON.stringify(data, null, 2));
@@ -277,7 +316,13 @@ async function pin(projectId) {
 }
 
 async function promoteUser(projectId, email) {
-  if (!email) { console.error(JSON.stringify({ status: "error", message: "Usage: run402 projects promote-user <project_id> <email>" })); process.exit(1); }
+  if (!email) {
+    fail({
+      code: "BAD_USAGE",
+      message: "Missing <email>.",
+      hint: "run402 projects promote-user <project_id> <email>",
+    });
+  }
   const p = findProject(projectId);
   const res = await fetch(`${API}/projects/v1/admin/${projectId}/promote-user`, {
     method: "POST",
@@ -290,7 +335,13 @@ async function promoteUser(projectId, email) {
 }
 
 async function demoteUser(projectId, email) {
-  if (!email) { console.error(JSON.stringify({ status: "error", message: "Usage: run402 projects demote-user <project_id> <email>" })); process.exit(1); }
+  if (!email) {
+    fail({
+      code: "BAD_USAGE",
+      message: "Missing <email>.",
+      hint: "run402 projects demote-user <project_id> <email>",
+    });
+  }
   const p = findProject(projectId);
   const res = await fetch(`${API}/projects/v1/admin/${projectId}/demote-user`, {
     method: "POST",

package/lib/sdk-errors.mjs

@@ -1,25 +1,81 @@
 /**
  * CLI-side SDK error translator.
  *
- * Maps SDK `Run402Error` subclasses into the CLI's existing error output
- * format: `{status: "error", http: ?, ...bodyFields}` on stderr, `process.exit(1)`.
- * Preserves specific behaviors:
- *   - `ProjectNotFound` → plain-text "Project <id> not found in local registry"
- *     with the "Hint: project IDs start with prj_" guidance when the id
- *     doesn't start with `prj_`.
+ * Maps SDK `Run402Error` subclasses into the CLI's canonical error envelope:
+ * `{status: "error", code, message, retryable, safe_to_retry, ...}` on stderr,
+ * `process.exit(1)`. Preserves specific behaviors:
+ *   - `ProjectNotFound` → canonical envelope with `code: "PROJECT_NOT_FOUND"`
+ *     and `details.source: "local_registry"` so callers can distinguish the
+ *     local-registry miss from a gateway 404.
  *   - HTML / non-JSON error bodies → `body_preview` field (first 500 chars),
  *     matching GH-84 behavior.
  *   - Network errors → `{status: "error", message: "..."}`.
+ *
+ * For client-side validation failures (missing flags, bad JSON, no-op
+ * environments), use `fail()` instead — `reportSdkError` is strictly for
+ * thrown `Run402Error` instances.
  */
 
+/**
+ * Canonical client-side failure emitter.
+ *
+ * Writes a single JSON envelope to stderr and exits with `exit_code` (default 1).
+ * The envelope shape matches the gateway's structured error contract so callers
+ * branching on `code` / `retryable` / `safe_to_retry` work uniformly across
+ * client-side validation errors and SDK-thrown errors.
+ *
+ * `code` defaults to "BAD_USAGE" so the helper is safe to call without one.
+ * `retryable: false` and `safe_to_retry: true` are sane defaults for client-side
+ * validation: the call wasn't sent, so retrying is safe and won't help unless
+ * the user fixes input.
+ */
+export function fail({ message, code, hint, details, next_actions, retryable = false, safe_to_retry = true, exit_code = 1 } = {}) {
+  const envelope = {
+    status: "error",
+    code: code ?? "BAD_USAGE",
+    message,
+    retryable,
+    safe_to_retry,
+  };
+  if (hint !== undefined) envelope.hint = hint;
+  if (details !== undefined) envelope.details = details;
+  envelope.next_actions = Array.isArray(next_actions) ? next_actions : [];
+  envelope.trace_id = null;
+  console.error(JSON.stringify(envelope));
+  process.exit(exit_code);
+}
+
+/**
+ * Parse a JSON-bearing CLI flag value, naming the flag in the failure envelope.
+ *
+ * Wraps `JSON.parse` so the failure says which flag was bad and includes a
+ * truncated value preview, instead of leaking a raw V8 `JSON.parse` message
+ * that doesn't tell the caller which flag failed.
+ */
+export function parseFlagJson(name, value) {
+  try {
+    return JSON.parse(value);
+  } catch (e) {
+    fail({
+      code: "BAD_JSON_FLAG",
+      message: `${name} value is not valid JSON`,
+      details: { flag: name, value_preview: String(value).slice(0, 32), parse_error: e.message },
+    });
+  }
+}
+
 export function reportSdkError(err) {
   if (err?.name === "ProjectNotFound") {
     const id = err.projectId || "";
     const hint = id && !String(id).startsWith("prj_")
-      ? ` Hint: project IDs start with "prj_". Check that the argument order is <project_id> <name>.`
-      : "";
-    console.error(`Project ${id} not found in local registry.${hint}`);
-    process.exit(1);
+      ? `project IDs start with "prj_". Check that the argument order is <project_id> <name>.`
+      : undefined;
+    fail({
+      code: "PROJECT_NOT_FOUND",
+      message: `Project ${id} not found in local registry.`,
+      hint,
+      details: { project_id: id, source: "local_registry" },
+    });
   }
 
   const payload = { status: "error" };

package/lib/secrets.mjs

@@ -1,6 +1,6 @@
 import { readFileSync } from "fs";
 import { getSdk } from "./sdk.mjs";
-import { reportSdkError } from "./sdk-errors.mjs";
+import { reportSdkError, fail } from "./sdk-errors.mjs";
 
 const HELP = `run402 secrets — Manage project secrets
 
@@ -56,7 +56,13 @@ async function set(projectId, key, args = []) {
     else if (!value && !args[i].startsWith("--")) { value = args[i]; }
   }
   const val = file ? readFileSync(file, "utf-8") : value;
-  if (!val) { console.error(JSON.stringify({ status: "error", message: "Missing secret value. Provide inline or use --file <path>" })); process.exit(1); }
+  if (!val) {
+    fail({
+      code: "BAD_USAGE",
+      message: "Missing secret value.",
+      hint: "Provide inline or use --file <path>",
+    });
+  }
   try {
     await getSdk().secrets.set(projectId, key, val);
     console.log(JSON.stringify({ status: "ok", message: `Secret '${key}' set for project ${projectId}.` }));

package/lib/sender-domain.mjs

@@ -1,6 +1,6 @@
 import { resolveProjectId } from "./config.mjs";
 import { getSdk } from "./sdk.mjs";
-import { reportSdkError } from "./sdk-errors.mjs";
+import { reportSdkError, fail } from "./sdk-errors.mjs";
 
 const HELP = `run402 sender-domain — Manage custom email sender domain
 
@@ -39,8 +39,11 @@ async function register(args) {
   const projectId = resolveProjectId(projectOpt);
 
   if (!domain) {
-    console.error(JSON.stringify({ status: "error", message: "Missing domain. Usage: run402 sender-domain register <domain>" }));
-    process.exit(1);
+    fail({
+      code: "BAD_USAGE",
+      message: "Missing domain.",
+      hint: "run402 sender-domain register <domain>",
+    });
   }
 
   try {
@@ -81,8 +84,11 @@ async function inboundToggle(action, args) {
   const projectId = resolveProjectId(projectOpt);
 
   if (!domain) {
-    console.error(JSON.stringify({ status: "error", message: `Missing domain. Usage: run402 sender-domain inbound-${action} <domain>` }));
-    process.exit(1);
+    fail({
+      code: "BAD_USAGE",
+      message: "Missing domain.",
+      hint: `run402 sender-domain inbound-${action} <domain>`,
+    });
   }
 
   try {

package/lib/sites.mjs

@@ -5,7 +5,7 @@ import { fileSetFromDir } from "#sdk/node";
 import { allowanceAuthHeaders, resolveProjectId, updateProject } from "./config.mjs";
 import { resolveFilePathsInManifest } from "./manifest.mjs";
 import { getSdk } from "./sdk.mjs";
-import { reportSdkError } from "./sdk-errors.mjs";
+import { reportSdkError, fail } from "./sdk-errors.mjs";
 
 const SMALL_DIR_THRESHOLD = 5;
 
@@ -244,17 +244,19 @@ async function deployDir(args) {
     if (args[i] === "--dry-run") { opts.dryRun = true; continue; }
     if (args[i] === "--confirm-prune") { opts.confirmPrune = true; continue; }
     if (args[i] === "--inherit") {
-      console.error(JSON.stringify({
-        status: "error",
+      fail({
+        code: "BAD_USAGE",
         message: "--inherit is removed; the SDK now uploads only changed files automatically.",
-      }));
-      process.exit(1);
+      });
     }
     if (!args[i].startsWith("-") && opts.dir === null) { opts.dir = args[i]; continue; }
   }
   if (!opts.dir) {
-    console.error(JSON.stringify({ status: "error", message: "Missing <path>. Usage: run402 sites deploy-dir <path> --project <id>" }));
-    process.exit(1);
+    fail({
+      code: "BAD_USAGE",
+      message: "Missing <path>.",
+      hint: "run402 sites deploy-dir <path> --project <id>",
+    });
   }
   const projectId = resolveProjectId(opts.project);
 

package/lib/status.mjs

@@ -79,7 +79,7 @@ export async function run(args = []) {
   const allowance = readAllowance();
   if (!allowance) {
     console.log(JSON.stringify({ status: "no_allowance", message: "No agent allowance found. Run: run402 init" }));
-    return;
+    process.exit(1);
   }
 
   const wallet = allowance.address.toLowerCase();

package/lib/subdomains.mjs

@@ -1,6 +1,6 @@
 import { resolveProject, resolveProjectId } from "./config.mjs";
 import { getSdk } from "./sdk.mjs";
-import { reportSdkError } from "./sdk-errors.mjs";
+import { reportSdkError, fail } from "./sdk-errors.mjs";
 
 const HELP = `run402 subdomains — Manage custom subdomains
 
@@ -64,11 +64,25 @@ async function claim(positionalArgs, flagArgs) {
   } else if (positionalArgs.length === 1) {
     name = positionalArgs[0];
   }
-  if (!name) { console.error("Usage: run402 subdomains claim <name> [--project <id>] [--deployment <id>]"); process.exit(1); }
+  if (!name) {
+    fail({
+      code: "BAD_USAGE",
+      message: "Missing <name>.",
+      hint: "run402 subdomains claim <name> [--project <id>] [--deployment <id>]",
+    });
+  }
   const projectId = resolveProjectId(opts.project);
   const p = resolveProject(opts.project);
   deploymentId = opts.deployment || deploymentId || p.last_deployment_id;
-  if (!deploymentId) { console.error("Error: no deployment_id specified and no recent deployment found. Deploy a site first or pass --deployment <id>."); process.exit(1); }
+  if (!deploymentId) {
+    fail({
+      code: "NO_DEPLOYMENT",
+      message: "no deployment_id specified and no recent deployment found.",
+      hint: "Deploy a site first or pass --deployment <id>.",
+      details: { project_id: projectId },
+      next_actions: [{ action: "deploy_site_first" }],
+    });
+  }
   try {
     const data = await getSdk().subdomains.claim(name, deploymentId, { projectId });
     console.log(JSON.stringify(data, null, 2));
@@ -86,17 +100,18 @@ async function deleteSubdomain(allArgs) {
     else if (!argList[i].startsWith("--") && !name) { name = argList[i]; }
   }
   if (!name) {
-    console.error(JSON.stringify({ status: "error", message: "Usage: run402 subdomains delete <name> --confirm [--project <id>]" }));
-    process.exit(1);
+    fail({
+      code: "BAD_USAGE",
+      message: "Missing <name>.",
+      hint: "run402 subdomains delete <name> --confirm [--project <id>]",
+    });
   }
   if (!argList.includes("--confirm")) {
-    console.error(JSON.stringify({
-      status: "error",
+    fail({
       code: "CONFIRMATION_REQUIRED",
       message: `Destructive: releasing subdomain '${name}' makes it available for any other project to claim. This is irreversible. Re-run with --confirm to proceed.`,
       details: { name },
-    }));
-    process.exit(1);
+    });
   }
   const projectId = resolveProjectId(opts.project);
   try {

package/lib/tier.mjs

@@ -1,5 +1,5 @@
 import { getSdk } from "./sdk.mjs";
-import { reportSdkError } from "./sdk-errors.mjs";
+import { reportSdkError, fail } from "./sdk-errors.mjs";
 
 const HELP = `run402 tier — Manage your Run402 tier subscription
 
@@ -34,7 +34,13 @@ async function status() {
 }
 
 async function set(tierName) {
-  if (!tierName) { console.error(JSON.stringify({ status: "error", message: "Usage: run402 tier set <prototype|hobby|team>" })); process.exit(1); }
+  if (!tierName) {
+    fail({
+      code: "BAD_USAGE",
+      message: "Missing <tier>.",
+      hint: "run402 tier set <prototype|hobby|team>",
+    });
+  }
   try {
     const data = await getSdk().tier.set(tierName);
     console.log(JSON.stringify(data, null, 2));

package/lib/webhooks.mjs

@@ -1,6 +1,6 @@
 import { resolveProjectId } from "./config.mjs";
 import { getSdk } from "./sdk.mjs";
-import { reportSdkError } from "./sdk-errors.mjs";
+import { reportSdkError, fail } from "./sdk-errors.mjs";
 
 const HELP = `run402 email webhooks — Manage mailbox webhooks
 
@@ -62,8 +62,11 @@ async function get(args) {
   }
   const projectId = resolveProjectId(projectOpt);
   if (!webhookId) {
-    console.error(JSON.stringify({ status: "error", message: "Missing webhook_id. Usage: run402 email webhooks get <webhook_id>" }));
-    process.exit(1);
+    fail({
+      code: "BAD_USAGE",
+      message: "Missing webhook_id.",
+      hint: "run402 email webhooks get <webhook_id>",
+    });
   }
   try {
     const data = await getSdk().email.webhooks.get(projectId, webhookId);
@@ -82,8 +85,11 @@ async function del(args) {
   }
   const projectId = resolveProjectId(projectOpt);
   if (!webhookId) {
-    console.error(JSON.stringify({ status: "error", message: "Missing webhook_id. Usage: run402 email webhooks delete <webhook_id>" }));
-    process.exit(1);
+    fail({
+      code: "BAD_USAGE",
+      message: "Missing webhook_id.",
+      hint: "run402 email webhooks delete <webhook_id>",
+    });
   }
   try {
     await getSdk().email.webhooks.delete(projectId, webhookId);
@@ -106,12 +112,14 @@ async function update(args) {
   }
   const projectId = resolveProjectId(projectOpt);
   if (!webhookId) {
-    console.error(JSON.stringify({ status: "error", message: "Missing webhook_id. Usage: run402 email webhooks update <webhook_id> [--url <url>] [--events <e1,e2>]" }));
-    process.exit(1);
+    fail({
+      code: "BAD_USAGE",
+      message: "Missing webhook_id.",
+      hint: "run402 email webhooks update <webhook_id> [--url <url>] [--events <e1,e2>]",
+    });
   }
   if (!url && !eventsRaw) {
-    console.error(JSON.stringify({ status: "error", message: "Provide at least --url or --events" }));
-    process.exit(1);
+    fail({ code: "BAD_USAGE", message: "Provide at least --url or --events" });
   }
 
   try {
@@ -132,12 +140,18 @@ async function register(args) {
   const projectId = resolveProjectId(projectOpt);
 
   if (!url) {
-    console.error(JSON.stringify({ status: "error", message: "Missing --url. Usage: run402 email webhooks register --url <url> --events <e1,e2>" }));
-    process.exit(1);
+    fail({
+      code: "BAD_USAGE",
+      message: "Missing --url.",
+      hint: "run402 email webhooks register --url <url> --events <e1,e2>",
+    });
   }
   if (!eventsRaw) {
-    console.error(JSON.stringify({ status: "error", message: "Missing --events. Valid events: delivery, bounced, complained, reply_received" }));
-    process.exit(1);
+    fail({
+      code: "BAD_USAGE",
+      message: "Missing --events.",
+      hint: "Valid events: delivery, bounced, complained, reply_received",
+    });
   }
 
   const events = eventsRaw.split(",").map((e) => e.trim());

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "run402",
-  "version": "1.53.1",
+  "version": "1.54.1",
   "description": "CLI for Run402 — provision Postgres databases, deploy static sites, generate images, and manage wallets via x402 and MPP micropayments.",
   "type": "module",
   "bin": {