@web42/w42 0.1.20 → 0.1.22

package/dist/commands/intent.js

@@ -0,0 +1,105 @@
+import chalk from "chalk";
+import { Command } from "commander";
+import ora from "ora";
+import { apiGet, apiPost, hintForError } from "../utils/api.js";
+import { requireAuth, setConfigValue } from "../utils/config.js";
+export const intentCommand = new Command("intent").description("Manage payment intents");
+intentCommand
+    .command("get")
+    .description("Fetch an intent by nick")
+    .argument("<nick>", "Intent nick")
+    .action(async (nick) => {
+    requireAuth();
+    const spinner = ora(`Fetching intent ${nick}...`).start();
+    try {
+        const res = await apiGet(`/api/pay/intent/${encodeURIComponent(nick)}`);
+        spinner.stop();
+        if (res.status === "active") {
+            setConfigValue(`intents.${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)));
+        console.error(chalk.dim(hintForError(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();
+        for (const intent of intents) {
+            if (intent.status === "active" && typeof intent.nick === "string") {
+                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)));
+        console.error(chalk.dim(hintForError(err)));
+        process.exit(1);
+    }
+});
+intentCommand
+    .command("revoke")
+    .description("Revoke an active intent")
+    .argument("<nick>", "Intent nick")
+    .action(async (nick) => {
+    requireAuth();
+    const spinner = ora(`Revoking intent ${nick}...`).start();
+    try {
+        const res = await apiPost(`/api/pay/intent/${encodeURIComponent(nick)}/revoke`, {});
+        spinner.stop();
+        setConfigValue(`intents.${nick}`, "");
+        console.log(JSON.stringify(res, null, 2));
+    }
+    catch (err) {
+        spinner.fail("Failed to revoke intent");
+        console.error(chalk.red(String(err)));
+        console.error(chalk.dim(hintForError(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. w42/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));
+});

package/dist/commands/register.js

@@ -2,8 +2,8 @@ import chalk from "chalk";
 import { Command } from "commander";
 import inquirer from "inquirer";
 import ora from "ora";
-import { apiGet, apiPost } from "../utils/api.js";
-import { getConfig, isAuthenticated } from "../utils/config.js";
+import { apiGet, apiPost, hintForError } from "../utils/api.js";
+import { getConfig } from "../utils/config.js";
 function toSlugPart(name) {
     return name
         .toLowerCase()
@@ -35,6 +35,7 @@ export const registerCommand = new Command("register")
     catch (err) {
         cardSpinner.fail("Could not fetch agent card");
         console.error(chalk.red(`  ${cardUrl}: ${String(err)}`));
+        console.error(chalk.dim("  Make sure the agent server is running and serving /.well-known/agent-card.json"));
         process.exit(1);
     }
     cardSpinner.stop();
@@ -45,7 +46,7 @@ export const registerCommand = new Command("register")
         const check = await apiGet(`/api/agents/check?url=${encodeURIComponent(url)}`);
         if (check.registered) {
             alreadyRegistered = true;
-            const displaySlug = check.slug.replace("~", "/");
+            const displaySlug = check.slug;
             checkSpinner.warn(`Already registered as ${chalk.cyan(displaySlug)}`);
         }
         else {
@@ -67,16 +68,8 @@ export const registerCommand = new Command("register")
         if (!proceed)
             process.exit(0);
     }
-    // ── Step 3: Auth gate ──────────────────────────────────────────────────
-    if (!isAuthenticated()) {
-        console.log();
-        console.log(chalk.yellow("You must be logged in to register an agent."));
-        console.log(chalk.dim("Run: ") + chalk.cyan("w42 auth login"));
-        process.exit(0);
-    }
+    // ── Step 3: Slug prompt + availability check ───────────────────────────
     const cfg = getConfig();
-    const username = cfg.username;
-    // ── Step 4: Slug prompt + availability check ───────────────────────────
     const defaultSlugPart = toSlugPart(agentCard.name ?? "my-agent") || "my-agent";
     console.log();
     if (agentCard.name)
@@ -90,7 +83,7 @@ export const registerCommand = new Command("register")
             {
                 type: "input",
                 name: "slugPart",
-                message: `Agent slug ${chalk.dim(`(@${username}/`)}`,
+                message: `Agent slug ${chalk.dim("(w42/")}`,
                 default: defaultSlugPart,
                 validate: (input) => {
                     if (!input)
@@ -102,12 +95,12 @@ export const registerCommand = new Command("register")
             },
         ]);
         slugPart = answer.slugPart;
-        const fullSlug = `@${username}~${slugPart}`;
+        const fullSlug = "w42/" + slugPart;
         const slugSpinner = ora("Checking slug availability...").start();
         try {
             const check = await apiGet(`/api/agents/check?slug=${encodeURIComponent(fullSlug)}`);
             if (check.taken) {
-                slugSpinner.fail(`${chalk.cyan(`@${username}/${slugPart}`)} is already taken — choose another`);
+                slugSpinner.fail(`${chalk.cyan(`w42/${slugPart}`)} is already taken — choose another`);
                 continue;
             }
             slugSpinner.stop();
@@ -115,7 +108,7 @@ export const registerCommand = new Command("register")
         catch {
             slugSpinner.warn("Could not verify slug — proceeding anyway");
         }
-        console.log(chalk.dim(`  Full slug: @${username}/${slugPart}`));
+        console.log(chalk.dim(`  Full slug: w42/${slugPart}`));
         break;
     }
     // ── Step 5: POST ───────────────────────────────────────────────────────
@@ -129,19 +122,19 @@ export const registerCommand = new Command("register")
         const data = await apiPost("/api/agents", body);
         const slug = data.agent?.slug ?? "unknown";
         const name = data.agent?.agent_card?.name ?? agentCard.name ?? slug;
-        const displaySlug = slug.replace("~", "/");
         if (data.created) {
-            registerSpinner.succeed(`Registered "${name}" (${displaySlug})`);
+            registerSpinner.succeed(`Registered "${name}" (${slug})`);
         }
         else {
-            registerSpinner.succeed(`Updated "${name}" (${displaySlug})`);
+            registerSpinner.succeed(`Updated "${name}" (${slug})`);
         }
         console.log(chalk.dim(`  Send:  w42 send ${slug} "hello"`));
-        console.log(chalk.dim(`  View:  ${cfg.apiUrl}/${displaySlug.replace("@", "")}`));
+        console.log(chalk.dim(`  View:  ${cfg.apiUrl}/${slug}`));
     }
     catch (err) {
         registerSpinner.fail("Registration failed");
         console.error(chalk.red(String(err)));
+        console.error(chalk.dim(hintForError(err)));
         process.exit(1);
     }
 });

package/dist/commands/search.js

@@ -1,7 +1,7 @@
 import { Command } from "commander";
 import chalk from "chalk";
 import ora from "ora";
-import { apiGet } from "../utils/api.js";
+import { apiGet, hintForError } from "../utils/api.js";
 import { printBanner } from "../utils/banner.js";
 import { getConfig } from "../utils/config.js";
 function getCardName(card) {
@@ -71,6 +71,7 @@ export const searchCommand = new Command("search")
         spinner.stop();
         if (agents.length === 0) {
             console.log(chalk.yellow(`No agents found for "${query}".`));
+            console.log(chalk.dim("Try different keywords or a broader search term."));
             return;
         }
         const limit = parseInt(opts.limit, 10) || 10;
@@ -83,7 +84,7 @@ export const searchCommand = new Command("search")
             const stars = agent.stars_count > 0 ? `★ ${agent.stars_count}` : "";
             const skills = formatSkills(agent.agent_card.skills);
             // Header: - <name (link)> | <slug> | <stars>
-            const nameLink = chalk.bold.cyan(terminalLink(name, `${config.apiUrl}/${agent.slug.replace("~", "/").replace(/^@/, "")}`));
+            const nameLink = chalk.bold.cyan(terminalLink(name, `${config.apiUrl}/${agent.slug}`));
             const slugLabel = chalk.dim(agent.slug);
             const separator = chalk.dim(" | ");
             const headerParts = [nameLink, slugLabel];
@@ -112,6 +113,7 @@ export const searchCommand = new Command("search")
     catch (error) {
         spinner.fail("Search failed");
         console.error(chalk.red(String(error)));
+        console.error(chalk.dim(hintForError(error)));
         process.exit(1);
     }
 });

package/dist/commands/send.js

@@ -4,8 +4,8 @@ import { Command } from "commander";
 import ora from "ora";
 import { v4 as uuidv4 } from "uuid";
 import { isCartMandatePart, parseCartMandate } from "@web42/auth";
-import { apiPost } from "../utils/api.js";
-import { getConfig, getConfigValue, isTelemetryEnabled, requireAuth, setConfigValue } from "../utils/config.js";
+import { apiPost, hintForError } from "../utils/api.js";
+import { getCachedIntents, getConfig, getConfigValue, isTelemetryEnabled, requireAuth, setConfigValue } from "../utils/config.js";
 import { getTx, saveTx, updateTx } from "../utils/tx-store.js";
 function isUrl(s) {
     return s.startsWith("http://") || s.startsWith("https://");
@@ -32,16 +32,42 @@ function printPart(part, agentSlug) {
             const cart = parseCartMandate(part);
             if (cart) {
                 const total = cart.contents.payment_request.details.total;
+                const slug = agentSlug ?? "unknown";
                 const txId = saveTx({
                     cartMandate: cart,
-                    agentSlug: agentSlug ?? "unknown",
+                    agentSlug: slug,
                 });
                 console.log(chalk.cyan(`\n[CartMandate] ${txId}`));
                 for (const item of cart.contents.payment_request.details.displayItems) {
                     console.log(`  ${item.label}: ${item.amount.currency} ${item.amount.value.toFixed(2)}`);
                 }
                 console.log(chalk.bold(`  Total: ${total.amount.currency} ${total.amount.value.toFixed(2)}`));
-                console.log(chalk.dim(`\nTo pay: w42 pay sign create --tx ${txId}`));
+                // Check locally-cached intents for auto-checkout hints
+                const totalCents = Math.round(total.amount.value * 100);
+                const cartCurrency = total.amount.currency.toLowerCase();
+                const now = new Date();
+                const matchingIntents = getCachedIntents().filter((intent) => {
+                    if (intent.status !== "active")
+                        return false;
+                    if (intent.expires_at && new Date(intent.expires_at) <= now)
+                        return false;
+                    if (!intent.agent_slugs.includes(slug))
+                        return false;
+                    if (totalCents > intent.max_amount_cents)
+                        return false;
+                    if (intent.currency.toLowerCase() !== cartCurrency)
+                        return false;
+                    return true;
+                });
+                if (matchingIntents.length > 0) {
+                    console.log(chalk.green(`\n  Auto-checkout available:`));
+                    for (const intent of matchingIntents) {
+                        console.log(chalk.green(`    w42 cart checkout ${txId} --intent ${intent.nick}`));
+                    }
+                }
+                else {
+                    console.log(chalk.dim(`\nTo pay: w42 cart sign ${txId}`));
+                }
                 return;
             }
         }
@@ -103,12 +129,10 @@ 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 <tx_id>", "Attach PaymentMandate from a transaction (use tx ID from w42 pay list)")
+    .option("--pay <tx_id>", "Attach PaymentMandate from a transaction (use tx ID from w42 cart list)")
     .action(async (rawAgent, userMessage, opts) => {
-    // Normalize slug: @user/name → @user~name (DB format)
-    const agent = rawAgent.includes("/") && !isUrl(rawAgent)
-        ? rawAgent.replace("/", "~")
-        : rawAgent;
+    // Agent slug can be provided directly (no conversion needed)
+    const agent = rawAgent;
     const config = requireAuth();
     let agentUrl;
     let bearerToken;
@@ -135,6 +159,7 @@ export const sendCommand = new Command("send")
             catch (err) {
                 spinner.fail("Failed to get auth token");
                 console.error(chalk.red(String(err)));
+                console.error(chalk.dim(hintForError(err)));
                 process.exit(1);
             }
         }
@@ -165,6 +190,7 @@ export const sendCommand = new Command("send")
             catch (err) {
                 spinner.fail(`Failed to authenticate with ${agent}`);
                 console.error(chalk.red(String(err)));
+                console.error(chalk.dim(hintForError(err)));
                 process.exit(1);
             }
         }
@@ -218,15 +244,15 @@ export const sendCommand = new Command("send")
         if (opts.pay) {
             const tx = getTx(opts.pay);
             if (!tx) {
-                console.error(chalk.red(`Transaction ${opts.pay} not found. Run: w42 pay list`));
+                console.error(chalk.red(`Transaction ${opts.pay} not found. Run: w42 cart list`));
                 process.exit(1);
             }
             if (tx.status === "cart_received") {
-                console.error(chalk.red(`Session not created yet. Run: w42 pay sign create --tx ${opts.pay}`));
+                console.error(chalk.red(`Session not created yet. Run: w42 cart sign ${opts.pay}`));
                 process.exit(1);
             }
             if (tx.status === "session_created") {
-                console.error(chalk.red(`Payment not yet approved. Run: w42 pay sign get ${opts.pay}`));
+                console.error(chalk.red(`Payment not yet approved. Run: w42 cart poll ${opts.pay}`));
                 process.exit(1);
             }
             if (!tx.paymentMandate) {

package/dist/commands/serve.js

@@ -135,6 +135,7 @@ export const serveCommand = new Command("serve")
     }
     catch {
         console.error(chalk.red("Failed to parse agent-card.json."));
+        console.error(chalk.dim("Validate the file with a JSON linter — it may have a syntax error."));
         process.exit(1);
     }
     const agentName = cardData.name ?? "Untitled Agent";

package/dist/index.js

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

package/dist/utils/api.d.ts

@@ -1,5 +1,12 @@
 export declare function apiRequest(path: string, options?: RequestInit): Promise<Response>;
+export declare class ApiError extends Error {
+    readonly code: string | undefined;
+    readonly status: number;
+    constructor(message: string, code: string | undefined, status: number);
+}
 export declare function apiGet<T>(path: string): Promise<T>;
 export declare function apiPost<T>(path: string, data: unknown): Promise<T>;
+/** Returns a short contextual hint based on the error type. */
+export declare function hintForError(err: unknown): string;
 export declare function apiDelete<T>(path: string): Promise<T>;
 export declare function apiFormData<T>(path: string, formData: FormData): Promise<T>;

package/dist/utils/api.js

@@ -14,11 +14,21 @@ export async function apiRequest(path, options = {}) {
         headers,
     });
 }
+export class ApiError extends Error {
+    code;
+    status;
+    constructor(message, code, status) {
+        super(message);
+        this.code = code;
+        this.status = status;
+        this.name = "ApiError";
+    }
+}
 export async function apiGet(path) {
     const res = await apiRequest(path);
     if (!res.ok) {
         const body = await res.json().catch(() => ({}));
-        throw new Error(body.error || `API error: ${res.status}`);
+        throw new ApiError(body.error || `API error: ${res.status}`, body.code, res.status);
     }
     return res.json();
 }
@@ -29,10 +39,22 @@ export async function apiPost(path, data) {
     });
     if (!res.ok) {
         const body = await res.json().catch(() => ({}));
-        throw new Error(body.error || `API error: ${res.status}`);
+        throw new ApiError(body.error || `API error: ${res.status}`, body.code, res.status);
     }
     return res.json();
 }
+/** Returns a short contextual hint based on the error type. */
+export function hintForError(err) {
+    if (err instanceof ApiError) {
+        if (err.status === 401)
+            return "Run `w42 auth login` to reauthenticate.";
+        if (err.status === 403)
+            return "You don't have permission to do this.";
+        if (err.status >= 500)
+            return "Server error — try again later.";
+    }
+    return "Check your network connection and try again.";
+}
 export async function apiDelete(path) {
     const res = await apiRequest(path, { method: "DELETE" });
     if (!res.ok) {

package/dist/utils/config.d.ts

@@ -22,6 +22,18 @@ 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 interface CachedIntent {
+    nick: string;
+    agent_slugs: string[];
+    max_amount_cents: number;
+    currency: string;
+    status: string;
+    expires_at?: string | null;
+    spent_cents: number;
+    budget_cents?: number | null;
+}
+/** Return all locally-cached intents that are still plausibly active. */
+export declare function getCachedIntents(): CachedIntent[];
 export declare function isTelemetryEnabled(): boolean;
 export declare function setTelemetry(enabled: boolean): void;
 export {};

package/dist/utils/config.js

@@ -59,6 +59,27 @@ export function getConfigValue(key) {
     // eslint-disable-next-line @typescript-eslint/no-explicit-any
     return config.get(key);
 }
+/** Return all locally-cached intents that are still plausibly active. */
+export function getCachedIntents() {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const intentsMap = config.get("intents");
+    if (!intentsMap)
+        return [];
+    const results = [];
+    for (const raw of Object.values(intentsMap)) {
+        if (!raw)
+            continue;
+        try {
+            const intent = typeof raw === "string" ? JSON.parse(raw) : raw;
+            if (intent && typeof intent === "object")
+                results.push(intent);
+        }
+        catch {
+            // skip corrupted entry
+        }
+    }
+    return results;
+}
 export function isTelemetryEnabled() {
     return config.get("telemetry") !== false;
 }

package/dist/version.d.ts

@@ -1 +1 @@
-export declare const CLI_VERSION = "0.1.20";
+export declare const CLI_VERSION = "0.1.22";

package/dist/version.js

@@ -1 +1 @@
-export const CLI_VERSION = "0.1.20";
+export const CLI_VERSION = "0.1.22";

package/package.json

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

package/dist/commands/pay.d.ts

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