@web42/w42 0.1.16 → 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.d.ts

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare const payCommand: Command;

package/dist/commands/pay.js

@@ -0,0 +1,255 @@
+import chalk from "chalk";
+import { Command } from "commander";
+import ora from "ora";
+import { apiGet, apiPost } from "../utils/api.js";
+import { requireAuth, setConfigValue, } from "../utils/config.js";
+// ─── Wallet ───────────────────────────────────────────────
+const walletCommand = new Command("wallet")
+    .description("View or top up your wallet balance")
+    .action(async () => {
+    requireAuth();
+    const spinner = ora("Fetching wallet...").start();
+    try {
+        const res = await apiGet("/api/pay/wallet");
+        spinner.stop();
+        console.log(JSON.stringify(res, null, 2));
+    }
+    catch (err) {
+        spinner.fail("Failed to fetch wallet");
+        console.error(chalk.red(String(err)));
+        process.exit(1);
+    }
+});
+walletCommand
+    .command("topup")
+    .description("Add funds to your wallet")
+    .argument("<amount>", "Amount in dollars (e.g. 50.00)")
+    .action(async (amountStr) => {
+    requireAuth();
+    const amountCents = Math.round(parseFloat(amountStr) * 100);
+    if (isNaN(amountCents) || amountCents <= 0) {
+        console.error(chalk.red("Amount must be a positive number"));
+        process.exit(1);
+    }
+    const spinner = ora("Topping up wallet...").start();
+    try {
+        const res = await apiPost("/api/pay/wallet/topup", { amount_cents: amountCents });
+        spinner.stop();
+        console.log(JSON.stringify(res, null, 2));
+    }
+    catch (err) {
+        spinner.fail("Failed to top up wallet");
+        console.error(chalk.red(String(err)));
+        process.exit(1);
+    }
+});
+// ─── Intent ───────────────────────────────────────────────
+const intentCommand = new Command("intent").description("Manage payment intents");
+intentCommand
+    .command("get")
+    .description("Fetch an intent by nick")
+    .requiredOption("--nick <nick>", "Intent nick")
+    .action(async (opts) => {
+    requireAuth();
+    const spinner = ora(`Fetching intent ${opts.nick}...`).start();
+    try {
+        const res = await apiGet(`/api/pay/intent/${encodeURIComponent(opts.nick)}`);
+        spinner.stop();
+        // Cache if active
+        if (res.status === "active") {
+            setConfigValue(`intents.${opts.nick}`, JSON.stringify(res));
+        }
+        console.log(JSON.stringify(res, null, 2));
+    }
+    catch (err) {
+        spinner.fail("Failed to fetch intent");
+        console.error(chalk.red(String(err)));
+        process.exit(1);
+    }
+});
+intentCommand
+    .command("list")
+    .description("List all your intents")
+    .action(async () => {
+    requireAuth();
+    const spinner = ora("Fetching intents...").start();
+    try {
+        const intents = await apiGet("/api/pay/intent");
+        spinner.stop();
+        // Sync active intents to cache, remove stale ones
+        const activeNicks = new Set();
+        for (const intent of intents) {
+            if (intent.status === "active" && typeof intent.nick === "string") {
+                activeNicks.add(intent.nick);
+                setConfigValue(`intents.${intent.nick}`, JSON.stringify(intent));
+            }
+        }
+        console.log(JSON.stringify(intents, null, 2));
+    }
+    catch (err) {
+        spinner.fail("Failed to list intents");
+        console.error(chalk.red(String(err)));
+        process.exit(1);
+    }
+});
+intentCommand
+    .command("revoke")
+    .description("Revoke an active intent")
+    .requiredOption("--nick <nick>", "Intent nick")
+    .action(async (opts) => {
+    requireAuth();
+    const spinner = ora(`Revoking intent ${opts.nick}...`).start();
+    try {
+        const res = await apiPost(`/api/pay/intent/${encodeURIComponent(opts.nick)}/revoke`, {});
+        spinner.stop();
+        // Remove from cache
+        setConfigValue(`intents.${opts.nick}`, "");
+        console.log(JSON.stringify(res, null, 2));
+    }
+    catch (err) {
+        spinner.fail("Failed to revoke intent");
+        console.error(chalk.red(String(err)));
+        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)")
+    .requiredOption("--cart <json>", "CartMandate JSON")
+    .requiredOption("--agent <slug>", "Merchant agent slug")
+    .requiredOption("--intent <nick>", "Intent nick to use")
+    .action(async (opts) => {
+    requireAuth();
+    let cart;
+    try {
+        cart = JSON.parse(opts.cart);
+    }
+    catch {
+        console.error(chalk.red("Invalid cart JSON"));
+        process.exit(1);
+    }
+    const spinner = ora("Processing checkout...").start();
+    try {
+        const res = await apiPost("/api/pay/checkout", {
+            cart,
+            agent_slug: opts.agent,
+            intent_nick: opts.intent,
+        });
+        spinner.stop();
+        console.log(JSON.stringify(res, null, 2));
+    }
+    catch (err) {
+        spinner.fail("Checkout failed");
+        console.error(chalk.red(String(err)));
+        process.exit(1);
+    }
+});
+// ─── Sign (payment session for human approval) ───────────
+const signCommand = new Command("sign").description("Create a payment session for human approval");
+signCommand
+    .command("create")
+    .description("Create a new payment session")
+    .requiredOption("--cart <json>", "CartMandate JSON")
+    .requiredOption("--agent <slug>", "Merchant agent slug")
+    .action(async (opts) => {
+    requireAuth();
+    let cart;
+    try {
+        cart = JSON.parse(opts.cart);
+    }
+    catch {
+        console.error(chalk.red("Invalid cart JSON"));
+        process.exit(1);
+    }
+    // Extract total from cart
+    let totalCents = 0;
+    let currency = "usd";
+    try {
+        const c = cart;
+        const contents = c.contents;
+        const pr = contents?.payment_request;
+        const details = pr?.details;
+        const total = details?.total;
+        totalCents = Math.round(total.amount.value * 100);
+        currency = total.amount.currency.toLowerCase();
+    }
+    catch {
+        console.error(chalk.red("Could not extract total from cart"));
+        process.exit(1);
+    }
+    const spinner = ora("Creating payment session...").start();
+    try {
+        const res = await apiPost("/api/pay/session", {
+            agent_slug: opts.agent,
+            cart,
+            total_cents: totalCents,
+            currency,
+        });
+        spinner.stop();
+        console.log(JSON.stringify(res, null, 2));
+    }
+    catch (err) {
+        spinner.fail("Failed to create session");
+        console.error(chalk.red(String(err)));
+        process.exit(1);
+    }
+});
+signCommand
+    .command("get")
+    .description("Check the status of a payment session")
+    .argument("<code>", "Session code")
+    .action(async (code) => {
+    requireAuth();
+    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);
+    }
+});
+// ─── Root pay command ─────────────────────────────────────
+export const payCommand = new Command("pay")
+    .description("AP2 payment mandates — wallet, intents, checkout, signing")
+    .addCommand(walletCommand)
+    .addCommand(intentCommand)
+    .addCommand(checkoutCommand)
+    .addCommand(signCommand);

package/dist/commands/send.js

@@ -83,6 +83,7 @@ export const sendCommand = new Command("send")
     .option("--new", "Start a new conversation (clears saved context)")
     .option("--context <id>", "Use a specific context ID")
     .option("--task-id <id>", "Reply to a specific task (e.g. one in input-required state)")
+    .option("--pay <token>", "Attach a payment token as an ap2.mandates.PaymentMandate data part")
     .action(async (rawAgent, userMessage, opts) => {
     // Normalize slug: @user/name → @user~name (DB format)
     const agent = rawAgent.includes("/") && !isUrl(rawAgent)
@@ -196,7 +197,37 @@ export const sendCommand = new Command("send")
             message: {
                 messageId: uuidv4(),
                 role: "user",
-                parts: [{ kind: "text", text: userMessage }],
+                parts: [
+                    { kind: "text", text: userMessage },
+                    ...(opts.pay
+                        ? [
+                            {
+                                kind: "data",
+                                data: {
+                                    "ap2.mandates.PaymentMandate": {
+                                        payment_mandate_contents: {
+                                            payment_mandate_id: "",
+                                            payment_details_id: "",
+                                            payment_details_total: {
+                                                label: "Total",
+                                                amount: { currency: "USD", value: 0 },
+                                                refund_period: 3,
+                                            },
+                                            payment_response: {
+                                                request_id: "",
+                                                method_name: "WEB42_WALLET",
+                                                details: {},
+                                            },
+                                            merchant_agent: agent,
+                                            timestamp: new Date().toISOString(),
+                                        },
+                                        user_authorization: opts.pay,
+                                    },
+                                },
+                            },
+                        ]
+                        : []),
+                ],
                 kind: "message",
                 contextId,
                 ...(opts.taskId ? { taskId: opts.taskId } : {}),

package/dist/index.js

@@ -1,6 +1,7 @@
 #!/usr/bin/env node
 import { Command } from "commander";
 import { authCommand } from "./commands/auth.js";
+import { payCommand } from "./commands/pay.js";
 import { registerCommand } from "./commands/register.js";
 import { searchCommand } from "./commands/search.js";
 import { sendCommand } from "./commands/send.js";
@@ -21,6 +22,7 @@ program
     }
 });
 program.addCommand(authCommand);
+program.addCommand(payCommand);
 program.addCommand(registerCommand);
 program.addCommand(searchCommand);
 program.addCommand(sendCommand);

package/dist/version.d.ts

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

package/dist/version.js

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

package/package.json

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