@lucid-agents/taskmarket 1.12.0 → 1.12.2

package/dist/index.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 // src/index.ts
-import { Command as Command74 } from "commander";
+import { Command as Command75 } from "commander";
 import { createRequire } from "module";
 
 // src/commands/init.ts
@@ -2690,7 +2690,7 @@ var ApiError = class extends Error {
    * The backend's machine-readable classification of the failure (ADR-0058).
    *
    * Before it existed the CLI rendered every failure identically, which is why
-   * `docs/CLI_GUIDE.md` had to tell script authors never to auto-retry a paid command: there was
+   * `docs/guides/CLI_GUIDE.md` had to tell script authors never to auto-retry a paid command: there was
    * no way to tell a write that is still landing from one that was definitively rejected, and
    * retrying the first is a second payment. `reason` is that way.
    *
@@ -2819,13 +2819,13 @@ async function apiDelete(path7, options) {
 }
 
 // src/lib/x402-errors.ts
-var ExternalX402Error = class extends Error {
+var X402PayError = class extends Error {
   payment;
   pending;
   status;
   constructor(message, options = {}) {
     super(message, options.cause === void 0 ? void 0 : { cause: options.cause });
-    this.name = "ExternalX402Error";
+    this.name = "X402PayError";
     this.payment = options.payment;
     this.pending = options.pending;
     this.status = options.status;
@@ -2842,18 +2842,18 @@ function printResult(data, options) {
 function renderFailure(error, options) {
   const message = error instanceof Error ? error.message : options?.fallback ?? String(error);
   const apiError = error instanceof ApiError ? error : void 0;
-  const externalX402Error = error instanceof ExternalX402Error ? error : void 0;
+  const x402PayError = error instanceof X402PayError ? error : void 0;
   const idempotencyKey = options?.idempotencyKey ?? apiError?.idempotencyKey ?? idempotencyKeyForError(error);
   const envelope = apiError?.envelope;
   process.stderr.write(
     JSON.stringify({
       ok: false,
       error: message,
-      ...apiError !== void 0 ? { status: apiError.status } : externalX402Error?.status !== void 0 ? { status: externalX402Error.status } : {},
+      ...apiError !== void 0 ? { status: apiError.status } : x402PayError?.status !== void 0 ? { status: x402PayError.status } : {},
       ...idempotencyKey !== void 0 ? { idempotencyKey } : {},
       ...envelope !== void 0 ? { ...envelope, pending: isInFlightApiError(envelope) } : {},
-      ...externalX402Error?.pending !== void 0 ? { pending: externalX402Error.pending } : {},
-      ...externalX402Error?.payment !== void 0 ? { payment: externalX402Error.payment } : {},
+      ...x402PayError?.pending !== void 0 ? { pending: x402PayError.pending } : {},
+      ...x402PayError?.payment !== void 0 ? { payment: x402PayError.payment } : {},
       ...options?.details ?? {}
     }) + "\n"
   );
@@ -4899,7 +4899,7 @@ var depositCommand = new Command45("deposit").description("Show wallet address a
 });
 
 // src/commands/wallet/index.ts
-import { Command as Command53 } from "commander";
+import { Command as Command54 } from "commander";
 
 // src/commands/wallet/balance.ts
 import { Command as Command46 } from "commander";
@@ -5062,15 +5062,27 @@ var setWithdrawalAddressCommand = new Command48("set-withdrawal-address").descri
   );
 });
 
-// src/commands/wallet/change-withdrawal-address.ts
+// src/commands/wallet/get-withdrawal-address.ts
 import { Command as Command49 } from "commander";
+var getWithdrawalAddressCommand = new Command49("get-withdrawal-address").description("Show the currently registered withdrawal address, if any").option("--address <addr>", "Wallet address to check (defaults to own wallet)").action(async (opts) => {
+  let address = opts.address;
+  if (!address) {
+    const keystore = await loadKeystore();
+    address = keystore.walletAddress;
+  }
+  const result = await apiGet(`/api/wallet/withdrawal-address?address=${address}`);
+  printResult(result);
+});
+
+// src/commands/wallet/change-withdrawal-address.ts
+import { Command as Command50 } from "commander";
 function isValidAddress2(addr) {
   return /^0x[a-fA-F0-9]{40}$/.test(addr);
 }
 function isValidRecoveryCode(code) {
   return /^\d{8}$/.test(code);
 }
-var changeWithdrawalAddressCommand = new Command49("change-withdrawal-address").description("Change the withdrawal address using the account recovery code (RFC-0012)").argument("<recovery-code>", "The 8-digit account recovery code from set-withdrawal-address").argument("<new-address>", "New Ethereum address to receive withdrawals").action(async (recoveryCode, newAddress) => {
+var changeWithdrawalAddressCommand = new Command50("change-withdrawal-address").description("Change the withdrawal address using the account recovery code (RFC-0012)").argument("<recovery-code>", "The 8-digit account recovery code from set-withdrawal-address").argument("<new-address>", "New Ethereum address to receive withdrawals").action(async (recoveryCode, newAddress) => {
   if (!isValidRecoveryCode(recoveryCode)) {
     printError("Invalid account recovery code: must be 8 digits");
     return;
@@ -5102,8 +5114,8 @@ var changeWithdrawalAddressCommand = new Command49("change-withdrawal-address").
 });
 
 // src/commands/wallet/reveal-recovery-code.ts
-import { Command as Command50 } from "commander";
-var revealRecoveryCodeCommand = new Command50("reveal-recovery-code").description("One-time reveal of your account recovery code, if one has not been generated yet").action(async () => {
+import { Command as Command51 } from "commander";
+var revealRecoveryCodeCommand = new Command51("reveal-recovery-code").description("One-time reveal of your account recovery code, if one has not been generated yet").action(async () => {
   let keystore;
   try {
     keystore = await loadKeystore();
@@ -5128,8 +5140,8 @@ var revealRecoveryCodeCommand = new Command50("reveal-recovery-code").descriptio
 });
 
 // src/commands/wallet/publish-key.ts
-import { Command as Command51 } from "commander";
-var publishKeyCommand = new Command51("publish-key").description("Publish your secp256k1 public key so others can encrypt files for you").action(async () => {
+import { Command as Command52 } from "commander";
+var publishKeyCommand = new Command52("publish-key").description("Publish your secp256k1 public key so others can encrypt files for you").action(async () => {
   let keystore;
   try {
     keystore = await loadKeystore();
@@ -5149,13 +5161,13 @@ var publishKeyCommand = new Command51("publish-key").description("Publish your s
 });
 
 // src/commands/wallet/withdraw-dreams.ts
-import { Command as Command52 } from "commander";
+import { Command as Command53 } from "commander";
 import { toHex as toHex2 } from "viem";
 var AUTHORIZATION_VALIDITY_SECONDS = 300;
 function isValidAddress3(addr) {
   return /^0x[a-fA-F0-9]{40}$/.test(addr);
 }
-var withdrawDreamsCommand = new Command52("withdraw-dreams").description("Withdraw accumulated DREAMS rewards to the withdrawal address").option("--destination <addr>", "Destination address (defaults to registered withdrawal address)").action(async (opts) => {
+var withdrawDreamsCommand = new Command53("withdraw-dreams").description("Withdraw accumulated DREAMS rewards to the withdrawal address").option("--destination <addr>", "Destination address (defaults to registered withdrawal address)").action(async (opts) => {
   let keystore;
   try {
     keystore = await loadKeystore();
@@ -5209,17 +5221,18 @@ var withdrawDreamsCommand = new Command52("withdraw-dreams").description("Withdr
 });
 
 // src/commands/wallet/index.ts
-var walletCommand = new Command53("wallet").description("Wallet management commands");
+var walletCommand = new Command54("wallet").description("Wallet management commands");
 walletCommand.addCommand(walletBalanceCommand);
 walletCommand.addCommand(walletImportCommand);
 walletCommand.addCommand(setWithdrawalAddressCommand);
+walletCommand.addCommand(getWithdrawalAddressCommand);
 walletCommand.addCommand(changeWithdrawalAddressCommand);
 walletCommand.addCommand(revealRecoveryCodeCommand);
 walletCommand.addCommand(publishKeyCommand);
 walletCommand.addCommand(withdrawDreamsCommand);
 
 // src/commands/withdraw.ts
-import { Command as Command54 } from "commander";
+import { Command as Command55 } from "commander";
 import { toHex as toHex3 } from "viem";
 var USDC_TYPES = {
   TransferWithAuthorization: [
@@ -5231,7 +5244,7 @@ var USDC_TYPES = {
     { name: "nonce", type: "bytes32" }
   ]
 };
-var withdrawCommand = new Command54("withdraw").description("Withdraw USDC to the registered withdrawal address").argument("<amount>", "Amount in USDC (e.g. 5 for 5 USDC)").action(async (amount) => {
+var withdrawCommand = new Command55("withdraw").description("Withdraw USDC to the registered withdrawal address").argument("<amount>", "Amount in USDC (e.g. 5 for 5 USDC)").action(async (amount) => {
   const parsed = parseFloat(amount);
   if (isNaN(parsed) || parsed <= 0) {
     printError("Invalid amount: must be a positive number (e.g. 5 for 5 USDC)");
@@ -5290,9 +5303,9 @@ var withdrawCommand = new Command54("withdraw").description("Withdraw USDC to th
 });
 
 // src/commands/encrypt.ts
-import { Command as Command55 } from "commander";
+import { Command as Command56 } from "commander";
 import { promises as fs3 } from "fs";
-var encryptCommand = new Command55("encrypt").description("Encrypt a file with ECIES using wallet keys").argument("<file>", "Path to the file to encrypt").option("--recipient <address>", "Recipient wallet address (default: self)").option("--output <path>", "Output path (default: <file>.enc)").action(async (file, opts) => {
+var encryptCommand = new Command56("encrypt").description("Encrypt a file with ECIES using wallet keys").argument("<file>", "Path to the file to encrypt").option("--recipient <address>", "Recipient wallet address (default: self)").option("--output <path>", "Output path (default: <file>.enc)").action(async (file, opts) => {
   let plaintext;
   try {
     plaintext = await fs3.readFile(file);
@@ -5340,9 +5353,9 @@ var encryptCommand = new Command55("encrypt").description("Encrypt a file with E
 });
 
 // src/commands/decrypt.ts
-import { Command as Command56 } from "commander";
+import { Command as Command57 } from "commander";
 import { promises as fs4 } from "fs";
-var decryptCommand = new Command56("decrypt").description("Decrypt a file using your wallet key").argument("<file>", "Path to the encrypted file").option("--output <path>", "Output path (default: strips .enc, otherwise appends .dec)").action(async (file, opts) => {
+var decryptCommand = new Command57("decrypt").description("Decrypt a file using your wallet key").argument("<file>", "Path to the encrypted file").option("--output <path>", "Output path (default: strips .enc, otherwise appends .dec)").action(async (file, opts) => {
   let ciphertext;
   try {
     ciphertext = await fs4.readFile(file);
@@ -5382,7 +5395,7 @@ var decryptCommand = new Command56("decrypt").description("Decrypt a file using
 });
 
 // src/commands/xmtp.ts
-import { Command as Command57 } from "commander";
+import { Command as Command58 } from "commander";
 
 // src/lib/xmtp-client.ts
 import os3 from "os";
@@ -6146,7 +6159,7 @@ function getDefaultQueryTimeoutMs() {
   }
   return Math.floor(parsed);
 }
-var xmtpCommand = new Command57("xmtp").description("Manage XMTP messaging for this agent");
+var xmtpCommand = new Command58("xmtp").description("Manage XMTP messaging for this agent");
 xmtpCommand.command("init").description("Initialize XMTP client and register installation metadata with backend").action(async () => {
   const keystore = await loadKeystore();
   const client = await createXmtpClient({
@@ -6383,7 +6396,7 @@ xmtpCommand.command("purge").description("Revoke stale XMTP installations that h
 });
 
 // src/commands/daemon.ts
-import { Command as Command58 } from "commander";
+import { Command as Command59 } from "commander";
 function diffTaskStatuses(prev, next) {
   const changes = [];
   for (const [taskId, newStatus] of next) {
@@ -6411,7 +6424,7 @@ function sleepOrAbort(ms, signal) {
   });
 }
 var MAX_SEEN_TASK_IDS = 2e3;
-var daemonCommand = new Command58("daemon").description("Long-running agent daemon: XMTP stream, heartbeats, and task polling").option("--heartbeat-interval <ms>", "Heartbeat interval in milliseconds", "1800000").option("--inbox-interval <ms>", "Inbox poll interval in milliseconds", "15000").option("--task-interval <ms>", "New task poll interval in milliseconds", "15000").option(
+var daemonCommand = new Command59("daemon").description("Long-running agent daemon: XMTP stream, heartbeats, and task polling").option("--heartbeat-interval <ms>", "Heartbeat interval in milliseconds", "1800000").option("--inbox-interval <ms>", "Inbox poll interval in milliseconds", "15000").option("--task-interval <ms>", "New task poll interval in milliseconds", "15000").option(
   "--auction-poll-interval <ms>",
   "Poll interval for clock-based auction tasks (dutch/reverse_dutch) in milliseconds",
   "15000"
@@ -6744,11 +6757,11 @@ var daemonCommand = new Command58("daemon").description("Long-running agent daem
 );
 
 // src/commands/email/index.ts
-import { Command as Command67 } from "commander";
+import { Command as Command68 } from "commander";
 
 // src/commands/email/register.ts
-import { Command as Command59 } from "commander";
-var registerCommand = new Command59("register").description("Register an email address for this agent").requiredOption("--username <name>", "Desired username (e.g. myagent)").action(async (opts) => {
+import { Command as Command60 } from "commander";
+var registerCommand = new Command60("register").description("Register an email address for this agent").requiredOption("--username <name>", "Desired username (e.g. myagent)").action(async (opts) => {
   const check = await apiGet(
     `/api/emails/check-username?username=${encodeURIComponent(opts.username)}`
   );
@@ -6769,8 +6782,8 @@ var registerCommand = new Command59("register").description("Register an email a
 });
 
 // src/commands/email/inbox.ts
-import { Command as Command60 } from "commander";
-var inboxCommand2 = new Command60("inbox").description("List emails in your inbox").option("--limit <n>", "Number of emails to return", "20").option("--unread", "Show only unread emails").action(async (opts) => {
+import { Command as Command61 } from "commander";
+var inboxCommand2 = new Command61("inbox").description("List emails in your inbox").option("--limit <n>", "Number of emails to return", "20").option("--unread", "Show only unread emails").action(async (opts) => {
   const keystore = await loadKeystore();
   const params = new URLSearchParams({
     deviceId: keystore.deviceId,
@@ -6785,8 +6798,8 @@ var inboxCommand2 = new Command60("inbox").description("List emails in your inbo
 });
 
 // src/commands/email/read.ts
-import { Command as Command61 } from "commander";
-var readCommand = new Command61("read").description("Read an email by ID (marks it as read)").argument("<id>", "Email ID").action(async (id) => {
+import { Command as Command62 } from "commander";
+var readCommand = new Command62("read").description("Read an email by ID (marks it as read)").argument("<id>", "Email ID").action(async (id) => {
   const keystore = await loadKeystore();
   const params = new URLSearchParams({
     deviceId: keystore.deviceId,
@@ -6798,8 +6811,8 @@ var readCommand = new Command61("read").description("Read an email by ID (marks
 });
 
 // src/commands/email/send.ts
-import { Command as Command62 } from "commander";
-var sendCommand = new Command62("send").description("Send an email").requiredOption("--to <address>", "Recipient email address").requiredOption("--subject <subject>", "Email subject").requiredOption("--body <text>", "Email body text").action(async (opts) => {
+import { Command as Command63 } from "commander";
+var sendCommand = new Command63("send").description("Send an email").requiredOption("--to <address>", "Recipient email address").requiredOption("--subject <subject>", "Email subject").requiredOption("--body <text>", "Email body text").action(async (opts) => {
   const keystore = await loadKeystore();
   const { data: result, idempotencyKey } = await apiPost("/api/emails/send", {
     deviceId: keystore.deviceId,
@@ -6812,8 +6825,8 @@ var sendCommand = new Command62("send").description("Send an email").requiredOpt
 });
 
 // src/commands/email/reply.ts
-import { Command as Command63 } from "commander";
-var replyCommand = new Command63("reply").description("Reply to an email").argument("<id>", "Email ID to reply to").requiredOption("--body <text>", "Reply body text").action(async (id, opts) => {
+import { Command as Command64 } from "commander";
+var replyCommand = new Command64("reply").description("Reply to an email").argument("<id>", "Email ID to reply to").requiredOption("--body <text>", "Reply body text").action(async (id, opts) => {
   const keystore = await loadKeystore();
   const params = new URLSearchParams({
     deviceId: keystore.deviceId,
@@ -6835,8 +6848,8 @@ var replyCommand = new Command63("reply").description("Reply to an email").argum
 });
 
 // src/commands/email/delete.ts
-import { Command as Command64 } from "commander";
-var deleteCommand = new Command64("delete").description("Delete an email by ID").argument("<id>", "Email ID").action(async (id) => {
+import { Command as Command65 } from "commander";
+var deleteCommand = new Command65("delete").description("Delete an email by ID").argument("<id>", "Email ID").action(async (id) => {
   const keystore = await loadKeystore();
   const { data: result, idempotencyKey } = await apiPost(
     "/api/emails/delete",
@@ -6850,15 +6863,15 @@ var deleteCommand = new Command64("delete").description("Delete an email by ID")
 });
 
 // src/commands/email/address.ts
-import { Command as Command65 } from "commander";
-var addressCommand2 = new Command65("address").description("Show your registered email address").action(async () => {
+import { Command as Command66 } from "commander";
+var addressCommand2 = new Command66("address").description("Show your registered email address").action(async () => {
   const keystore = await loadKeystore();
   const result = await apiGet(`/api/agents/stats?address=${keystore.walletAddress}`);
   printResult({ emailAddress: result.emailAddress ?? null });
 });
 
 // src/commands/email/mark-read.ts
-import { Command as Command66 } from "commander";
+import { Command as Command67 } from "commander";
 async function setReadStatus(id, read) {
   const keystore = await loadKeystore();
   const { data: result, idempotencyKey } = await apiPost(
@@ -6872,12 +6885,12 @@ async function setReadStatus(id, read) {
   );
   printResult({ id: result.id, isRead: result.isRead }, { idempotencyKey });
 }
-var markReadCommand = new Command66("mark-read").description("Mark an email as read or unread").argument("<id>", "Email ID").option("--unread", "Mark as unread instead of read").action(async (id, opts) => {
+var markReadCommand = new Command67("mark-read").description("Mark an email as read or unread").argument("<id>", "Email ID").option("--unread", "Mark as unread instead of read").action(async (id, opts) => {
   await setReadStatus(id, !opts.unread);
 });
 
 // src/commands/email/index.ts
-var emailCommand = new Command67("email").description("Email management commands");
+var emailCommand = new Command68("email").description("Email management commands");
 emailCommand.addCommand(registerCommand);
 emailCommand.addCommand(inboxCommand2);
 emailCommand.addCommand(readCommand);
@@ -6888,11 +6901,11 @@ emailCommand.addCommand(addressCommand2);
 emailCommand.addCommand(markReadCommand);
 
 // src/commands/requester/index.ts
-import { Command as Command69 } from "commander";
+import { Command as Command70 } from "commander";
 
 // src/commands/requester/stats.ts
-import { Command as Command68 } from "commander";
-var requesterStatsCmd = new Command68("stats").description("Get requester reputation stats for an address").argument("<address>", "Wallet address of the requester").action(async (address) => {
+import { Command as Command69 } from "commander";
+var requesterStatsCmd = new Command69("stats").description("Get requester reputation stats for an address").argument("<address>", "Wallet address of the requester").action(async (address) => {
   if (!/^0x[0-9a-fA-F]{40}$/.test(address)) {
     printError("Address must be a 0x-prefixed 20-byte hex string");
     return;
@@ -6906,13 +6919,13 @@ var requesterStatsCmd = new Command68("stats").description("Get requester reputa
 });
 
 // src/commands/requester/index.ts
-var requesterCmd = new Command69("requester").description("Requester reputation commands").addCommand(requesterStatsCmd);
+var requesterCmd = new Command70("requester").description("Requester reputation commands").addCommand(requesterStatsCmd);
 
 // src/commands/x402/index.ts
-import { Command as Command73 } from "commander";
+import { Command as Command74 } from "commander";
 
 // src/commands/x402/payments.ts
-import { Command as Command70, Option as Option2 } from "commander";
+import { Command as Command71, Option as Option2 } from "commander";
 import { createInterface as createInterface3 } from "readline";
 
 // src/lib/x402-journal.ts
@@ -7682,8 +7695,8 @@ async function confirmManualResolution() {
   readline.close();
   return answer.trim().toLowerCase() === "resolve";
 }
-var x402PaymentsCommand = new Command70("payments").description(
-  "Inspect and reconcile external x402 payment records"
+var x402PaymentsCommand = new Command71("payments").description(
+  "Inspect and reconcile X402 Pay payment records"
 );
 x402PaymentsCommand.command("list").description("List current payment records").addOption(new Option2("--state <state>", "Filter by state").choices(PAYMENT_STATES)).action(async (options) => {
   const payments = await listX402Payments({ state: options.state });
@@ -7706,7 +7719,7 @@ x402PaymentsCommand.command("resolve").description("Manually record an externall
 
 // src/commands/x402/policy.ts
 import { promises as fs7 } from "fs";
-import { Command as Command71 } from "commander";
+import { Command as Command72 } from "commander";
 import { createInterface as createInterface4 } from "readline";
 async function confirmUnattendedRule(rule) {
   if (!process.stdin.isTTY) {
@@ -7732,8 +7745,8 @@ async function confirmUnattendedRule(rule) {
   readline.close();
   return answer.trim().toLowerCase() === "authorize";
 }
-var x402PolicyCommand = new Command71("policy").description(
-  "Manage local external x402 spending policy"
+var x402PolicyCommand = new Command72("policy").description(
+  "Manage local X402 Pay spending policy"
 );
 x402PolicyCommand.command("init").description("Create a deny-all policy file").action(async () => {
   const policy = await initializeX402Policy();
@@ -7768,10 +7781,10 @@ for (const enabled of [true, false]) {
 }
 
 // src/commands/x402/request.ts
-import { Command as Command72, Option as Option3 } from "commander";
+import { Command as Command73, Option as Option3 } from "commander";
 import { createInterface as createInterface5 } from "readline";
 
-// src/lib/external-x402-client.ts
+// src/lib/x402-pay-client.ts
 import { x402Client } from "@x402/core/client";
 import { ExactEvmScheme } from "@x402/evm/exact/client";
 import { UptoEvmScheme } from "@x402/evm/upto/client";
@@ -7794,7 +7807,7 @@ var FORBIDDEN_HEADERS = /* @__PURE__ */ new Set([
   "payment-signature",
   "transfer-encoding"
 ]);
-function parseExternalX402Url(raw) {
+function parseX402PayUrl(raw) {
   let url;
   try {
     url = new URL(raw);
@@ -7829,7 +7842,7 @@ function isPrivateNetworkAddress(address) {
   if (family === 6) return isPrivateIpv6(address);
   return true;
 }
-async function validateExternalX402Destination(url, options) {
+async function validateX402PayDestination(url, options) {
   const resolve = options.resolve ?? dns.lookup;
   const addresses = await resolve(url.hostname, { all: true, verbatim: true });
   if (addresses.length === 0)
@@ -7901,7 +7914,7 @@ async function loadExternalHeaders(input) {
   return result;
 }
 async function prepareX402HttpRequest(input) {
-  const url = parseExternalX402Url(input.rawUrl);
+  const url = parseX402PayUrl(input.rawUrl);
   const method = input.method.toUpperCase();
   if (method !== "GET" && method !== "POST") throw new Error("x402 method must be GET or POST");
   if (input.json !== void 0 && input.bodyFile) {
@@ -8308,7 +8321,7 @@ function authorizationKindFromPaymentPayload(payload) {
   return void 0;
 }
 
-// src/lib/external-x402-client.ts
+// src/lib/x402-pay-client.ts
 function sameRequirement(left, right) {
   return left.scheme === right.scheme && left.network === right.network && left.amount === right.amount && left.asset.toLowerCase() === right.asset.toLowerCase() && left.payTo.toLowerCase() === right.payTo.toLowerCase();
 }
@@ -8425,7 +8438,7 @@ function signerFor(account) {
     signTypedData: async (typedData) => account.signTypedData(typedData)
   };
 }
-async function executeExternalX402Request(options) {
+async function executeX402PayRequest(options) {
   const nonInteractive = Boolean(options.nonInteractive);
   const request = await prepareX402HttpRequest({
     rawUrl: options.rawUrl,
@@ -8443,7 +8456,7 @@ async function executeExternalX402Request(options) {
     request,
     requestedRuleId: options.policyRuleId
   });
-  await validateExternalX402Destination(request.url, { allowPrivateNetwork });
+  await validateX402PayDestination(request.url, { allowPrivateNetwork });
   const account = options.account ?? await createWalletAccountFromKeystore(await loadKeystore());
   const rpcOptions = rpcConfigurationByChainId(policy);
   let selectedAuthorization;
@@ -8624,7 +8637,7 @@ async function executeExternalX402Request(options) {
   const guardedFetch = async (input, init) => {
     const outgoing = new Request(input, { ...init, redirect: "error" });
     const isPaid = outgoing.headers.has("payment-signature") || outgoing.headers.has("x-payment");
-    await validateExternalX402Destination(request.url, { allowPrivateNetwork });
+    await validateX402PayDestination(request.url, { allowPrivateNetwork });
     if (isPaid) {
       if (!paymentRecord) throw new Error("Paid x402 request has no journal reservation");
       paidRequestDispatched = true;
@@ -8638,7 +8651,7 @@ async function executeExternalX402Request(options) {
           state: "unknown",
           error: error instanceof Error ? error.message : String(error)
         });
-        throw new ExternalX402Error("External x402 outcome is unknown; do not retry", {
+        throw new X402PayError("External x402 outcome is unknown; do not retry", {
           cause: error,
           payment: paymentRecord,
           pending: true
@@ -8657,7 +8670,7 @@ async function executeExternalX402Request(options) {
       redirect: "error"
     });
   } catch (error) {
-    if (error instanceof ExternalX402Error) throw error;
+    if (error instanceof X402PayError) throw error;
     if (paymentRecord) {
       const current = await getX402Payment(paymentRecord.id);
       if (["ready", "dispatched", "unknown"].includes(current.state) || paidRequestDispatched) {
@@ -8665,14 +8678,14 @@ async function executeExternalX402Request(options) {
           state: "unknown",
           error: error instanceof Error ? error.message : String(error)
         });
-        throw new ExternalX402Error("External x402 outcome is unknown; do not retry", {
+        throw new X402PayError("External x402 outcome is unknown; do not retry", {
           cause: error,
           payment: paymentRecord,
           pending: true
         });
       }
     }
-    throw new ExternalX402Error(
+    throw new X402PayError(
       error instanceof Error ? error.message : "External x402 request failed",
       { cause: error, payment: paymentRecord, pending: false }
     );
@@ -8680,7 +8693,7 @@ async function executeExternalX402Request(options) {
   if (paymentRecord) {
     paymentRecord = await getX402Payment(paymentRecord.id);
     if (paymentRecord.state !== "settled") {
-      throw new ExternalX402Error("External x402 outcome is unknown; do not retry", {
+      throw new X402PayError("External x402 outcome is unknown; do not retry", {
         payment: paymentRecord,
         pending: true,
         status: response.status
@@ -8692,7 +8705,7 @@ async function executeExternalX402Request(options) {
     responseData = await externalResponseData(response, { outputPath: options.outputPath });
   } catch (error) {
     if (paymentRecord) {
-      throw new ExternalX402Error(
+      throw new X402PayError(
         error instanceof Error ? error.message : "Failed to process external response",
         { cause: error, payment: paymentRecord, pending: false, status: response.status }
       );
@@ -8700,7 +8713,7 @@ async function executeExternalX402Request(options) {
     throw error;
   }
   if (!response.ok) {
-    throw new ExternalX402Error(`External service returned HTTP ${response.status}`, {
+    throw new X402PayError(`External service returned HTTP ${response.status}`, {
       payment: paymentRecord,
       pending: false,
       status: response.status
@@ -8726,7 +8739,7 @@ async function confirm(lines) {
   readline.close();
   return answer.trim().toLowerCase() === "yes";
 }
-var x402RequestCommand = new Command72("request").description("Request and pay for a direct external x402 HTTP resource").argument("<url>", "HTTPS resource URL").addOption(new Option3("--method <method>", "HTTP method").choices(["GET", "POST"]).default("GET")).option("--json <json>", "Inline JSON POST body").option("--body-file <path>", "Read JSON POST body from a file").option("--headers-file <path>", "Read request headers from an owner-only JSON file").option(
+var x402RequestCommand = new Command73("request").description("Request and pay for a direct x402 HTTP resource (X402 Pay)").argument("<url>", "HTTPS resource URL").addOption(new Option3("--method <method>", "HTTP method").choices(["GET", "POST"]).default("GET")).option("--json <json>", "Inline JSON POST body").option("--body-file <path>", "Read JSON POST body from a file").option("--headers-file <path>", "Read request headers from an owner-only JSON file").option(
   "--header-env <header=ENV_VAR>",
   "Read one request header from an environment variable (repeatable)",
   collect2,
@@ -8737,7 +8750,7 @@ var x402RequestCommand = new Command72("request").description("Request and pay f
       headersFile: options.headersFile,
       headerEnv: options.headerEnv
     });
-    const result = await executeExternalX402Request({
+    const result = await executeX402PayRequest({
       rawUrl: url,
       method: options.method,
       json: options.json,
@@ -8770,8 +8783,8 @@ var x402RequestCommand = new Command72("request").description("Request and pay f
 );
 
 // src/commands/x402/index.ts
-var x402Command = new Command73("x402").description(
-  "Pay external x402 services with local spending policies"
+var x402Command = new Command74("x402").description(
+  "Pay x402 services with local spending policies (X402 Pay)"
 );
 x402Command.addCommand(x402RequestCommand);
 x402Command.addCommand(x402PolicyCommand);
@@ -8780,7 +8793,7 @@ x402Command.addCommand(x402PaymentsCommand);
 // src/index.ts
 var require2 = createRequire(import.meta.url);
 var { version } = require2("../package.json");
-var program = new Command74();
+var program = new Command75();
 program.name("taskmarket").description("Taskmarket CLI for AI agents").version(version);
 program.addCommand(initCommand);
 program.addCommand(walletCommand);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lucid-agents/taskmarket",
-  "version": "1.12.0",
+  "version": "1.12.2",
   "type": "module",
   "bin": {
     "taskmarket": "./dist/index.js"
@@ -22,8 +22,8 @@
     "typescript": "^5.3.3",
     "vitest": "^2.0.0",
     "@taskmarket/eslint-config": "0.0.0",
-    "@taskmarket/shared": "2.0.0",
-    "@taskmarket/prettier-config": "0.0.0"
+    "@taskmarket/prettier-config": "0.0.0",
+    "@taskmarket/shared": "2.0.0"
   },
   "files": [
     "dist"
@@ -42,6 +42,6 @@
     "test": "vitest run",
     "test:watch": "vitest watch",
     "smoke:xmtp-live": "tsx scripts/smoke-xmtp-live.ts",
-    "smoke:x402-external": "tsx scripts/smoke-external-x402.ts"
+    "smoke:x402-pay": "tsx scripts/smoke-x402-pay.ts"
   }
 }