@web42/w42 0.1.15 → 0.1.17

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,236 @@
+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);
+    }
+});
+// ─── 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("poll")
+    .description("Poll a payment session until completed or expired")
+    .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);
+        }
+    }
+    spinner.fail("Session still pending. Run again to continue polling.");
+    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

@@ -4,7 +4,7 @@ import { Command } from "commander";
 import ora from "ora";
 import { v4 as uuidv4 } from "uuid";
 import { apiPost } from "../utils/api.js";
-import { getConfigValue, requireAuth, setConfigValue } from "../utils/config.js";
+import { getConfig, getConfigValue, isTelemetryEnabled, requireAuth, setConfigValue } from "../utils/config.js";
 function isUrl(s) {
     return s.startsWith("http://") || s.startsWith("https://");
 }
@@ -42,6 +42,24 @@ function handleTaskState(state, taskId) {
         process.exit(1);
     }
 }
+function submitMetric(slug, responseTimeMs, success) {
+    const cfg = getConfig();
+    fetch(`${cfg.apiUrl}/api/agents/metrics`, {
+        method: "POST",
+        headers: {
+            "Content-Type": "application/json",
+            ...(cfg.token ? { Authorization: `Bearer ${cfg.token}` } : {}),
+        },
+        body: JSON.stringify({
+            slug,
+            response_time_ms: responseTimeMs ?? null,
+            success,
+        }),
+        signal: AbortSignal.timeout(5000),
+    }).catch(() => {
+        // intentionally swallowed — telemetry must never affect UX
+    });
+}
 function getCachedToken(slug) {
     const raw = getConfigValue(`agentTokens.${slug}`);
     if (!raw)
@@ -65,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)
@@ -171,12 +190,44 @@ export const sendCommand = new Command("send")
         console.error(chalk.dim("Is the agent server running?"));
         process.exit(1);
     }
+    const startTime = Date.now();
+    let firstTokenMs;
     try {
         const stream = client.sendMessageStream({
             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 } : {}),
@@ -184,10 +235,14 @@ export const sendCommand = new Command("send")
         });
         for await (const event of stream) {
             if (event.kind === "message" && event.role === "agent") {
+                if (firstTokenMs === undefined)
+                    firstTokenMs = Date.now() - startTime;
                 for (const part of event.parts)
                     printPart(part);
             }
             else if (event.kind === "artifact-update") {
+                if (firstTokenMs === undefined)
+                    firstTokenMs = Date.now() - startTime;
                 // When append is true we're receiving streaming chunks — write inline.
                 // When it's a new artifact (append falsy), separate from prior output.
                 if (!event.append)
@@ -203,6 +258,8 @@ export const sendCommand = new Command("send")
                 handleTaskState(event.status?.state, event.taskId);
             }
             else if (event.kind === "task") {
+                if (firstTokenMs === undefined)
+                    firstTokenMs = Date.now() - startTime;
                 // Non-streaming fallback: server returned the full task object.
                 // Print accumulated artifacts and handle terminal state.
                 for (const artifact of event.artifacts ?? []) {
@@ -218,8 +275,14 @@ export const sendCommand = new Command("send")
             }
         }
         process.stdout.write("\n");
+        if (isTelemetryEnabled() && !isUrl(agent)) {
+            submitMetric(agent, firstTokenMs, true);
+        }
     }
     catch (err) {
+        if (isTelemetryEnabled() && !isUrl(agent)) {
+            submitMetric(agent, firstTokenMs, false);
+        }
         console.error(chalk.red("\nConnection lost."), chalk.dim(String(err)));
         process.exit(1);
     }

package/dist/commands/telemetry.d.ts

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

package/dist/commands/telemetry.js

@@ -0,0 +1,27 @@
+import chalk from "chalk";
+import { Command } from "commander";
+import { isTelemetryEnabled, setTelemetry } from "../utils/config.js";
+export const telemetryCommand = new Command("telemetry")
+    .description("Manage telemetry settings")
+    .argument("[state]", "on | off")
+    .action((state) => {
+    if (!state) {
+        const enabled = isTelemetryEnabled();
+        console.log(enabled
+            ? chalk.green("Telemetry is enabled.")
+            : chalk.yellow("Telemetry is disabled."));
+        return;
+    }
+    if (state === "on") {
+        setTelemetry(true);
+        console.log(chalk.green("Telemetry enabled."));
+    }
+    else if (state === "off") {
+        setTelemetry(false);
+        console.log(chalk.yellow("Telemetry disabled."));
+    }
+    else {
+        console.error(chalk.red(`Unknown state "${state}". Use "on" or "off".`));
+        process.exit(1);
+    }
+});

package/dist/index.js

@@ -1,10 +1,12 @@
 #!/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";
 import { serveCommand } from "./commands/serve.js";
+import { telemetryCommand } from "./commands/telemetry.js";
 import { setApiUrl } from "./utils/config.js";
 import { CLI_VERSION } from "./version.js";
 const program = new Command();
@@ -20,8 +22,10 @@ program
     }
 });
 program.addCommand(authCommand);
+program.addCommand(payCommand);
 program.addCommand(registerCommand);
 program.addCommand(searchCommand);
 program.addCommand(sendCommand);
 program.addCommand(serveCommand);
+program.addCommand(telemetryCommand);
 program.parse();

package/dist/utils/config.d.ts

@@ -6,6 +6,7 @@ interface W42Config {
     avatarUrl?: string;
     token?: string;
     authenticated: boolean;
+    telemetry?: boolean;
 }
 export declare function getConfig(): W42Config;
 export declare function setAuth(data: {
@@ -21,4 +22,6 @@ export declare function isAuthenticated(): boolean;
 export declare function requireAuth(): W42Config;
 export declare function setConfigValue(key: string, value: string): void;
 export declare function getConfigValue(key: string): string | undefined;
+export declare function isTelemetryEnabled(): boolean;
+export declare function setTelemetry(enabled: boolean): void;
 export {};

package/dist/utils/config.js

@@ -4,6 +4,7 @@ const config = new Conf({
     defaults: {
         apiUrl: "https://web42-network.vercel.app",
         authenticated: false,
+        telemetry: true,
     },
 });
 export function getConfig() {
@@ -58,3 +59,9 @@ export function getConfigValue(key) {
     // eslint-disable-next-line @typescript-eslint/no-explicit-any
     return config.get(key);
 }
+export function isTelemetryEnabled() {
+    return config.get("telemetry") !== false;
+}
+export function setTelemetry(enabled) {
+    config.set("telemetry", enabled);
+}

package/dist/version.d.ts

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

package/dist/version.js

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

package/package.json

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