@web42/w42 0.1.17 → 0.1.18

package/README.md

@@ -47,6 +47,7 @@ web42 send http://localhost:3001 "Hello"
 | `--new` | Start a new conversation (clears saved context) |
 | `--context <id>` | Use a specific context ID |
 | `--task-id <id>` | Reply to a specific task (e.g. one in `input-required` state) |
+| `--pay <token>` | Attach AP2 payment token as PaymentMandate data part |
 
 ---
 
@@ -92,6 +93,108 @@ web42 register https://my-agent.example.com --visibility private --tags "nlp,sum
 
 ---
 
+### `web42 pay`
+
+AP2 payment commands — wallet management, payment intents, checkout, and human signing.
+
+#### `web42 pay wallet`
+
+View your wallet balance.
+
+```bash
+web42 pay wallet
+```
+
+#### `web42 pay wallet topup <amount>`
+
+Add funds to your wallet. Amount is in dollars.
+
+```bash
+web42 pay wallet topup 50.00
+```
+
+#### `web42 pay intent propose`
+
+Generate an intent creation URL for the user to authorize in the browser.
+
+```bash
+web42 pay intent propose --nick starbucks-daily --agents @x~starbucks --max-amount 5.00 --prompt-playback "Spend up to $5/day at Starbucks" --recurring daily
+```
+
+| Option | Description |
+|---|---|
+| `--nick <nick>` | Short identifier for the intent (required) |
+| `--agents <slugs>` | Comma-separated merchant agent slugs (required) |
+| `--max-amount <dollars>` | Max amount per transaction (required) |
+| `--prompt-playback <text>` | Human-readable description (required) |
+| `--currency <code>` | Currency code (default: `USD`) |
+| `--recurring <type>` | `once`, `daily`, `weekly`, or `monthly` (default: `once`) |
+| `--budget <dollars>` | Lifetime budget |
+| `--expires <date>` | Expiry date (ISO 8601) |
+
+#### `web42 pay intent get --nick <nick>`
+
+Fetch an intent by nick. Caches locally if active.
+
+#### `web42 pay intent list`
+
+List all your payment intents.
+
+#### `web42 pay intent revoke --nick <nick>`
+
+Revoke an active intent.
+
+#### `web42 pay checkout`
+
+Execute a payment against a matching intent (no human approval needed).
+
+```bash
+web42 pay checkout --cart '<json>' --agent @x~starbucks --intent starbucks-daily
+```
+
+| Option | Description |
+|---|---|
+| `--cart <json>` | CartMandate JSON (required) |
+| `--agent <slug>` | Merchant agent slug (required) |
+| `--intent <nick>` | Intent nick to use (required) |
+
+#### `web42 pay sign create`
+
+Create a payment session for human approval (when no matching intent exists).
+
+```bash
+web42 pay sign create --cart '<json>' --agent @x~bookstore
+```
+
+| Option | Description |
+|---|---|
+| `--cart <json>` | CartMandate JSON (required) |
+| `--agent <slug>` | Merchant agent slug (required) |
+
+Returns `{ code, signing_url }`. Present the URL to the user.
+
+#### `web42 pay sign get <code>`
+
+Check the status of a payment session.
+
+```bash
+web42 pay sign get a1b2c3d4e5f6g7h8
+```
+
+---
+
+### `web42 telemetry`
+
+Control usage telemetry.
+
+```bash
+web42 telemetry         # Show current state
+web42 telemetry on      # Enable
+web42 telemetry off     # Disable
+```
+
+---
+
 ## Environment variables
 
 ```bash

package/dist/commands/pay.js

@@ -112,6 +112,40 @@ intentCommand
         process.exit(1);
     }
 });
+intentCommand
+    .command("propose")
+    .description("Generate an intent creation URL for the user to authorize in the browser")
+    .requiredOption("--nick <nick>", "Short identifier for the intent")
+    .requiredOption("--agents <slugs>", "Comma-separated merchant agent slugs (e.g. @x~starbucks)")
+    .requiredOption("--max-amount <dollars>", "Max amount per transaction in dollars")
+    .requiredOption("--prompt-playback <text>", "Human-readable description of the intent")
+    .option("--currency <code>", "Currency code", "USD")
+    .option("--recurring <type>", "Recurring type: once, daily, weekly, monthly", "once")
+    .option("--budget <dollars>", "Lifetime budget in dollars")
+    .option("--expires <date>", "Expiry date (ISO 8601)")
+    .action(async (opts) => {
+    const cfg = requireAuth();
+    const username = cfg.username;
+    if (!username) {
+        console.error(chalk.red("No username found. Please log in again."));
+        process.exit(1);
+    }
+    const baseUrl = cfg.apiUrl ?? "https://web42-network.vercel.app";
+    const params = new URLSearchParams({
+        nick: opts.nick,
+        agents: opts.agents,
+        max_amount: opts.maxAmount,
+        currency: opts.currency,
+        recurring: opts.recurring,
+        prompt_playback: opts.promptPlayback,
+    });
+    if (opts.budget)
+        params.set("budget", opts.budget);
+    if (opts.expires)
+        params.set("expires_at", opts.expires);
+    const url = `${baseUrl}/@${username}/intents/create?${params.toString()}`;
+    console.log(JSON.stringify({ url }, null, 2));
+});
 // ─── Checkout ─────────────────────────────────────────────
 const checkoutCommand = new Command("checkout")
     .description("Execute a payment against a matching intent (no human needed)")
@@ -195,37 +229,22 @@ signCommand
     }
 });
 signCommand
-    .command("poll")
-    .description("Poll a payment session until completed or expired")
+    .command("get")
+    .description("Check the status of a payment session")
     .argument("<code>", "Session code")
     .action(async (code) => {
     requireAuth();
-    const maxAttempts = 30;
-    const intervalMs = 2000;
-    const spinner = ora("Waiting for approval...").start();
-    for (let i = 0; i < maxAttempts; i++) {
-        try {
-            const res = await apiGet(`/api/pay/session/${encodeURIComponent(code)}`);
-            if (res.status === "completed") {
-                spinner.stop();
-                console.log(JSON.stringify(res, null, 2));
-                return;
-            }
-            if (res.status === "expired") {
-                spinner.fail("Session expired");
-                process.exit(1);
-            }
-            // Still pending — wait and retry
-            await new Promise((resolve) => setTimeout(resolve, intervalMs));
-        }
-        catch (err) {
-            spinner.fail("Failed to poll session");
-            console.error(chalk.red(String(err)));
-            process.exit(1);
-        }
+    const spinner = ora("Fetching session...").start();
+    try {
+        const res = await apiGet(`/api/pay/session/${encodeURIComponent(code)}`);
+        spinner.stop();
+        console.log(JSON.stringify(res, null, 2));
+    }
+    catch (err) {
+        spinner.fail("Failed to fetch session");
+        console.error(chalk.red(String(err)));
+        process.exit(1);
     }
-    spinner.fail("Session still pending. Run again to continue polling.");
-    process.exit(1);
 });
 // ─── Root pay command ─────────────────────────────────────
 export const payCommand = new Command("pay")

package/dist/version.d.ts

@@ -1 +1 @@
-export declare const CLI_VERSION = "0.1.17";
+export declare const CLI_VERSION = "0.1.18";

package/dist/version.js

@@ -1 +1 @@
-export const CLI_VERSION = "0.1.17";
+export const CLI_VERSION = "0.1.18";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@web42/w42",
-  "version": "0.1.17",
+  "version": "0.1.18",
   "description": "CLI for the Web42 Agent Network — discover, register, and communicate with A2A agents",
   "type": "module",
   "bin": {