@clawcard/cli 3.2.1 → 3.2.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clawcard/cli",
-  "version": "3.2.1",
+  "version": "3.2.4",
   "description": "The ClawCard CLI — manage your agent keys, billing, and setup from the terminal",
   "bin": {
     "clawcard": "./bin/clawcard.mjs"

package/skill/SKILL.md

@@ -98,11 +98,15 @@ Close card:
 clawcard agent cards close <card-id> --json
 ```
 
-## Stablecoin Wallet (USDC on Base)
+## Stablecoin Wallet (USDC + pathUSD on Base)
 
-Your agent can have a USDC wallet for crypto payments, agent-to-agent transfers, and x402 API access.
+Your agent has a wallet on Base with three balances:
 
-**Use wallet for:** x402 APIs (HTTP 402 responses), crypto transfers, micropayments
+- **ETH** — gas fees (needed for on-chain transactions)
+- **USDC** — x402 protocol payments and direct transfers
+- **pathUSD** — MPP (Machine Payments Protocol) payments via Tempo/Stripe
+
+**Use wallet for:** x402 APIs (HTTP 402 responses), MPP services, crypto transfers, micropayments
 **Use cards for:** traditional merchant checkouts, websites with payment forms
 
 ### Setup
@@ -116,7 +120,7 @@ If you get `"No wallet found"`, create one via the API or run `clawcard agent wa
 
 ### Commands
 
-Check balance (shows USDC + FIAT spending power):
+Check balance (shows ETH, USDC, and pathUSD balances):
 ```
 clawcard agent wallet balance --json
 ```
@@ -131,21 +135,42 @@ Pay a URL via x402 (default — when a service returns HTTP 402):
 clawcard agent wallet send --url https://api.example.com/data --json
 ```
 
-Pay a URL via MPP (Machine Payments Protocol — Stripe/Tempo):
+Pay a URL via MPP (Machine Payments Protocol — Stripe/Tempo, uses pathUSD):
 ```
 clawcard agent wallet send --url https://api.example.com/data --protocol mpp --json
 ```
 
+**Explorer links:** Payment responses include explorer URLs. x402 transactions link to Basescan (`basescan.org/tx/...`), MPP and bridge transactions link to Tempo Explorer (`explore.tempo.xyz/receipt/...`).
+
 View transaction history:
 ```
 clawcard agent wallet transactions --json
 ```
 
-Fund your wallet (opens Coinbase — buy USDC with card, zero fees, sent directly to wallet):
+### Fund Wizard (3 options)
+
+The fund command is a wizard with three funding options:
+
+1. **Gas fees (ETH)** — opens Coinbase Onramp to buy ETH (needed for on-chain transactions)
+2. **x402 services (USDC)** — opens Coinbase Onramp to buy USDC (for x402 protocol payments)
+3. **MPP services (pathUSD)** — bridges USDC from your existing balance to pathUSD on Tempo (for MPP payments)
+
+Fund your wallet interactively (runs the wizard):
+```
+clawcard agent wallet fund
+```
+
+Fund via JSON (opens Coinbase Onramp for USDC/ETH):
 ```
 clawcard agent wallet fund --amount 10.00 --json
 ```
 
+### Bridge USDC to pathUSD
+
+To pay for MPP services, you need pathUSD. The fund wizard's "MPP services" option converts USDC from your wallet balance to pathUSD on Tempo. This is a bridge operation (USDC on Base -> pathUSD on Tempo).
+
+The bridge response includes both a Basescan link (Base transaction) and a Tempo Explorer link (Tempo receipt).
+
 Or send USDC directly to your wallet address on Base. Check your address with `clawcard agent wallet --json`.
 
 ## Discover Services

package/src/agent-api.js

@@ -177,3 +177,13 @@ export const registerOnChainIdentity = (agentId, data = {}) =>
 // A2A Agent Card
 export const getAgentCard = (agentId) =>
   agentRequest(`/api/agents/${agentId}/agent-card`);
+
+// Card access
+export const getCardAccess = () =>
+  agentRequest("/api/cards-access");
+
+export const requestCardAccess = (data) =>
+  agentRequest("/api/cards-access", {
+    method: "POST",
+    body: JSON.stringify(data),
+  });

package/src/commands/agent.js

@@ -23,6 +23,7 @@ import {
   walletSend,
   walletTransactions as walletTransactionsApi,
   discoverServices,
+  requestCardAccess,
   getOnChainIdentity,
   registerOnChainIdentity,
   getAgentCard,
@@ -183,13 +184,92 @@ export async function agentCardsCmd(options) {
   console.log();
 }
 
+export async function agentCardsRequestCmd(options) {
+  if (options.json) {
+    try {
+      const result = await requestCardAccess({});
+      return output(result, true);
+    } catch (err) {
+      return output({ error: err.message }, true);
+    }
+  }
+
+  const prompts = await import("@clack/prompts");
+
+  console.log();
+  console.log(`  ${orange.bold("Request Virtual Card Access")}`);
+  console.log();
+  console.log(chalk.dim("  Virtual cards let your agent make purchases on traditional websites."));
+  console.log(chalk.dim("  We review requests to ensure compliance. Usually approved within 24 hours."));
+  console.log();
+
+  const country = await prompts.text({
+    message: "What country are you based in?",
+    placeholder: "United States",
+    validate: (v) => { if (!v?.trim()) return "Required"; },
+  });
+  if (prompts.isCancel(country)) return;
+
+  const useCase = await prompts.text({
+    message: "What will your agent use cards for?",
+    placeholder: "Buying domains, hosting, SaaS subscriptions",
+    validate: (v) => { if (!v?.trim()) return "Required"; },
+  });
+  if (prompts.isCancel(useCase)) return;
+
+  const company = await prompts.text({
+    message: "Company or project name (optional)",
+    placeholder: "My AI Startup",
+  });
+  if (prompts.isCancel(company)) return;
+
+  const s = prompts.spinner();
+  s.start("Submitting request...");
+
+  try {
+    const result = await requestCardAccess({
+      country,
+      useCase,
+      company: company || "",
+    });
+
+    if (result.alreadyApproved) {
+      s.stop(chalk.green("You're already approved! Create cards with: clawcard agent cards create"));
+    } else {
+      s.stop(chalk.green("Request submitted!"));
+      console.log();
+      console.log(`  ${result.message}`);
+      console.log(chalk.dim("  Questions? team@clawcard.dev"));
+    }
+  } catch (err) {
+    s.stop("Failed");
+    console.log(`  Error: ${err.message}`);
+  }
+  console.log();
+}
+
 export async function agentCardsCreateCmd(options) {
   const agentId = await getAgentId();
-  const result = await createCard(agentId, {
-    amountCents: parseInt(options.amount),
-    type: options.type,
-    memo: options.memo || "Agent card",
-  });
+  let result;
+  try {
+    result = await createCard(agentId, {
+      amountCents: parseInt(options.amount),
+      type: options.type,
+      memo: options.memo || "Agent card",
+    });
+  } catch (err) {
+    if (err.message?.includes("approval") || err.message?.includes("needsApproval")) {
+      if (options.json) return output({ error: "Card access not approved. Run: clawcard agent cards request", needsApproval: true }, true);
+      console.log();
+      console.log(`  ${orange("Virtual cards require approval.")}`);
+      console.log(`  Run: ${chalk.bold("clawcard agent cards request")}`);
+      console.log();
+      return;
+    }
+    if (options.json) return output({ error: err.message }, true);
+    console.log(`  Error: ${err.message}`);
+    return;
+  }
   if (options.json) return output(result, true);
 
   console.log();

package/src/index.js

@@ -169,6 +169,14 @@ agentCards
     const { agentCardsCmd } = await import("./commands/agent.js");
     await agentCardsCmd(options);
   });
+agentCards
+  .command("request")
+  .description("Request access to virtual cards")
+  .option("--json", "Output as JSON")
+  .action(async (options) => {
+    const { agentCardsRequestCmd } = await import("./commands/agent.js");
+    await agentCardsRequestCmd(options);
+  });
 agentCards
   .command("create")
   .requiredOption("--amount <cents>", "Spend limit in cents")
@@ -489,49 +497,30 @@ if (process.argv.length <= 2) {
     ];
   } else {
     // Check user state to show contextual nudges
-    let hasBalance = true;
     let hasAgent = true;
 
     try {
-      const { getBalance, listAgents } = await import("./api.js");
-      const [balance, agents] = await Promise.all([
-        getBalance().catch(() => ({ amountCents: 0 })),
-        listAgents().catch(() => []),
-      ]);
-      hasBalance = balance.amountCents >= 500;
+      const { listAgents } = await import("./api.js");
+      const agents = await listAgents().catch(() => []);
       hasAgent = agents.some((a) => a.status === "active");
     } catch {
       // couldn't check — show full menu
     }
 
-    if (!hasBalance) {
-      p.log.warn(
-        `Account balance is under $5. Run ${orange("clawcard billing topup")} to add funds.`
-      );
-    }
-
-    if (!hasAgent && !hasBalance) {
+    if (!hasAgent) {
       p.log.info(
-        chalk.dim("You need at least $5 balance before creating an agent.")
-      );
-    } else if (!hasAgent) {
-      p.log.warn(
-        `You have balance but no agent yet. Run ${orange("clawcard keys create")} to create one.`
+        `No agent yet. Run ${orange("clawcard keys create")} to create one.`
       );
     }
 
     options = [
       ...(hasAgent
         ? [
-            { value: "agent", label: "View agent details", hint: "phone, email, budget" },
-            { value: "agent-fund", label: "Fund my agent", hint: "allocate budget from your balance" },
+            { value: "agent", label: "View agent details", hint: "phone, email, wallet, budget" },
             { value: "setup", label: "Configure", hint: "install skill for your agent" },
           ]
-        : hasBalance
-          ? [{ value: "keys-create", label: "Create agent", hint: "you have balance — create your agent now" }]
-          : []),
-      { value: "topup", label: "Top up my account", hint: "add balance (10% fee)" },
-      { value: "referral", label: "Referral", hint: "share & earn $5" },
+        : [{ value: "keys-create", label: "Create agent", hint: "create your first agent" }]),
+      { value: "topup", label: "Top up account", hint: "add balance for virtual cards (10% fee)" },
       { value: "settings", label: "Settings", hint: "billing address & preferences" },
       { value: "whoami", label: "Who am I?", hint: "show current account" },
       { value: "dashboard", label: "Open dashboard", hint: "open in browser" },
@@ -555,7 +544,7 @@ if (process.argv.length <= 2) {
     signup: () => import("./commands/signup.js").then((m) => m.signupCommand()),
     logout: () => import("./commands/logout.js").then((m) => m.logoutCommand()),
     whoami: () => import("./commands/whoami.js").then((m) => m.whoamiCommand()),
-    agent: () => import("./commands/keys.js").then((m) => m.agentStatusCommand()),
+    agent: () => import("./commands/agent.js").then((m) => m.agentInfoCmd({})),
     "agent-fund": () => import("./commands/keys.js").then((m) => m.agentFundCommand()),
     "keys-create": () => import("./commands/keys.js").then((m) => m.keysCreateCommand()),
     "topup": () => import("./commands/billing.js").then((m) => m.billingTopupCommand()),