agentmall 0.1.16 → 0.1.18

package/dist/cli.js

@@ -283,7 +283,7 @@ var RULE_WIDTH = 48;
 function banner() {
   console.log();
   console.log(
-    `  ${c.bold}\u25CE agentmall${c.reset}  ${c.dim}\u2014 buy anything with a URL${c.reset}`
+    `  ${c.bold}\u25CE AgentMall${c.reset}  ${c.dim}\u2014 buy from the world's biggest retailers with a URL${c.reset}`
   );
 }
 function section(title) {
@@ -405,6 +405,71 @@ var FAILURE_MESSAGES = {
 function formatCents(cents) {
   return `$${(cents / 100).toFixed(2)}`;
 }
+function compactTrackingValue(value) {
+  if (typeof value === "string") {
+    const trimmed = value.trim();
+    return trimmed || null;
+  }
+  if (typeof value === "number" || typeof value === "boolean") {
+    return String(value);
+  }
+  return null;
+}
+function normalizeTrackingCarrier(carrier, trackingNumber) {
+  const carrierValue = carrier?.trim().toLowerCase() ?? null;
+  const trackingValue = trackingNumber?.trim().toUpperCase() ?? null;
+  if ((carrierValue === "znlogic" || carrierValue === "amazon logistics") && trackingValue?.startsWith("TBA")) {
+    return "amazon";
+  }
+  return carrierValue;
+}
+function trackingUrlForCarrier(carrier, trackingNumber) {
+  if (!trackingNumber) return null;
+  switch (normalizeTrackingCarrier(carrier, trackingNumber)) {
+    case "ups":
+      return `https://www.ups.com/track?tracknum=${encodeURIComponent(trackingNumber)}`;
+    case "fedex":
+      return `https://www.fedex.com/fedextrack/?trknbr=${encodeURIComponent(trackingNumber)}`;
+    case "usps":
+      return `https://tools.usps.com/go/TrackConfirmAction?tLabels=${encodeURIComponent(trackingNumber)}`;
+    case "amazon":
+      return `https://www.amazon.com/progress-tracker/package/?trackingId=${encodeURIComponent(trackingNumber)}`;
+    case "dhl":
+      return `https://www.dhl.com/us-en/home/tracking.html?tracking-id=${encodeURIComponent(trackingNumber)}`;
+    default:
+      return null;
+  }
+}
+function trackingLines(tracking) {
+  const direct = compactTrackingValue(tracking);
+  if (direct) return [direct];
+  if (Array.isArray(tracking)) {
+    return tracking.flatMap((entry) => trackingLines(entry)).filter((line2, index, lines2) => line2 && lines2.indexOf(line2) === index);
+  }
+  if (!tracking || typeof tracking !== "object") {
+    return [];
+  }
+  const record = tracking;
+  const carrierRaw = compactTrackingValue(record.carrier) ?? compactTrackingValue(record.provider) ?? compactTrackingValue(record.shipper);
+  const number = compactTrackingValue(record.tracking_number) ?? compactTrackingValue(record.trackingNumber) ?? compactTrackingValue(record.number) ?? compactTrackingValue(record.code);
+  const carrier = normalizeTrackingCarrier(carrierRaw, number);
+  const url = compactTrackingValue(record.tracking_url) ?? compactTrackingValue(record.trackingUrl) ?? compactTrackingValue(record.url) ?? trackingUrlForCarrier(carrier, number);
+  const lines = [];
+  if (carrier && number) {
+    lines.push(`${carrier}: ${number}`);
+  } else if (number) {
+    lines.push(number);
+  } else if (carrier) {
+    lines.push(carrier);
+  }
+  if (url) lines.push(url);
+  for (const nestedKey of ["shipments", "tracking_numbers", "trackingNumbers", "numbers"]) {
+    if (nestedKey in record) {
+      lines.push(...trackingLines(record[nestedKey]));
+    }
+  }
+  return lines.filter((line2, index, all) => line2 && all.indexOf(line2) === index);
+}
 function getBudgetBasePrice(product) {
   return product.price;
 }
@@ -568,6 +633,13 @@ function displayStatus(purchase) {
   if (purchase.deliveryMethod) {
     kv("Shipping", purchase.deliveryMethod);
   }
+  const tracking = trackingLines(purchase.tracking);
+  if (tracking.length) {
+    kv("Tracking", tracking[0]);
+    for (const extra of tracking.slice(1)) {
+      kv("", extra, { dim: true });
+    }
+  }
   kv("Created", new Date(purchase.createdAt).toLocaleString(), { dim: true });
   gap();
 }
@@ -592,7 +664,7 @@ function displayRefund(refund2) {
 import { input, confirm, select } from "@inquirer/prompts";
 async function promptProductUrl() {
   return input({
-    message: "Product URL",
+    message: "Product URL or retailer link",
     validate: (value) => {
       try {
         const url = new URL(value);
@@ -758,6 +830,19 @@ async function getBuyerToken(purchaseId) {
 
 // src/cli/index.ts
 var EMAIL_PATTERN = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+var SUPPORTED_RETAILER_LABELS = [
+  "Amazon",
+  "Walmart",
+  "Target",
+  "Best Buy",
+  "Home Depot",
+  "eBay",
+  "Lowe's",
+  "Wayfair",
+  "Ace Hardware",
+  "1-800-Flowers",
+  "Pokemon Center"
+];
 function parseTempoBalance(balance) {
   const parsed = Number.parseFloat(balance ?? "0");
   return Number.isFinite(parsed) ? parsed : 0;
@@ -939,6 +1024,11 @@ async function buy(urlArg) {
   try {
     banner();
     gap();
+    if (!urlArg) {
+      muted("Paste a product URL from a supported retailer.");
+      muted(`Supported retailers: ${SUPPORTED_RETAILER_LABELS.join(", ")}.`);
+      gap();
+    }
     const url = urlArg ?? await promptProductUrl();
     const client = new AgentMall();
     const product = await spin(
@@ -1059,32 +1149,38 @@ async function buy(urlArg) {
     throw error;
   }
 }
-async function status(purchaseId) {
+async function status(purchaseId, options) {
   banner();
   const apiSecret = process.env.AGENTMALL_API_SECRET;
-  const buyerToken = apiSecret ? null : await getBuyerToken(purchaseId);
+  const buyerToken = apiSecret ? null : options?.buyerToken?.trim() || await getBuyerToken(purchaseId);
   const client = apiSecret ? new AgentMall({ apiSecret }) : new AgentMall();
   if (!apiSecret && !buyerToken) {
     throw new Error(
-      "No saved buyer token found for this order on this machine."
+      "No saved buyer token found for this order on this machine. Pass --buyer-token amtk_... to check it manually."
     );
   }
+  if (!apiSecret && options?.buyerToken?.trim()) {
+    await saveBuyerToken(purchaseId, options.buyerToken.trim());
+  }
   const result = await spin(
     "Fetching order",
     () => client.purchases.get(purchaseId, buyerToken ? { buyerToken } : void 0)
   );
   displayStatus(result);
 }
-async function refund(purchaseId) {
+async function refund(purchaseId, options) {
   banner();
   const apiSecret = process.env.AGENTMALL_API_SECRET;
-  const buyerToken = apiSecret ? null : await getBuyerToken(purchaseId);
+  const buyerToken = apiSecret ? null : options?.buyerToken?.trim() || await getBuyerToken(purchaseId);
   const client = apiSecret ? new AgentMall({ apiSecret }) : new AgentMall();
   if (!apiSecret && !buyerToken) {
     throw new Error(
-      "No saved buyer token found for this order on this machine."
+      "No saved buyer token found for this order on this machine. Pass --buyer-token amtk_... to check it manually."
     );
   }
+  if (!apiSecret && options?.buyerToken?.trim()) {
+    await saveBuyerToken(purchaseId, options.buyerToken.trim());
+  }
   const result = await spin(
     "Fetching refund",
     () => client.refunds.getByPurchase(
@@ -1135,6 +1231,17 @@ var c2 = {
 };
 var args = process.argv.slice(2);
 var command = args[0];
+function readBuyerTokenFlag(values) {
+  const inline = values.find((value) => value.startsWith("--buyer-token="));
+  if (inline) {
+    const token2 = inline.slice("--buyer-token=".length).trim();
+    return token2 || void 0;
+  }
+  const index = values.indexOf("--buyer-token");
+  if (index === -1) return void 0;
+  const token = values[index + 1]?.trim();
+  return token || void 0;
+}
 async function main() {
   try {
     switch (command) {
@@ -1143,17 +1250,17 @@ async function main() {
         break;
       case "status":
         if (!args[1]) {
-          console.error("Usage: agentmall status <purchase_id>");
+          console.error("Usage: agentmall status <purchase_id> [--buyer-token <token>]");
           process.exit(1);
         }
-        await status(args[1]);
+        await status(args[1], { buyerToken: readBuyerTokenFlag(args.slice(2)) });
         break;
       case "refund":
         if (!args[1]) {
-          console.error("Usage: agentmall refund <purchase_id>");
+          console.error("Usage: agentmall refund <purchase_id> [--buyer-token <token>]");
           process.exit(1);
         }
-        await refund(args[1]);
+        await refund(args[1], { buyerToken: readBuyerTokenFlag(args.slice(2)) });
         break;
       case "onboard":
       case "setup":
@@ -1187,7 +1294,7 @@ function printHelp() {
   };
   console.log();
   console.log(
-    `  ${c2.bold}\u25CE agentmall${c2.reset}  ${c2.dim}\u2014 buy anything with a URL${c2.reset}`
+    `  ${c2.bold}\u25CE AgentMall${c2.reset}  ${c2.dim}\u2014 buy from the world's biggest retailers with a URL${c2.reset}`
   );
   console.log();
   console.log(`  ${rule("Commands")}`);
@@ -1215,6 +1322,9 @@ function printHelp() {
     `  ${c2.dim}$${c2.reset} npx agentmall https://amazon.com/dp/B0DWTMJHCG`
   );
   console.log(`  ${c2.dim}$${c2.reset} npx agentmall status pur_abc123`);
+  console.log(
+    `  ${c2.dim}$${c2.reset} npx agentmall status pur_abc123 --buyer-token amtk_...`
+  );
   console.log(`  ${c2.dim}$${c2.reset} npx agentmall refund pur_abc123`);
   console.log();
 }

package/dist/index.d.cts

@@ -90,6 +90,7 @@ type Purchase = {
     status: PurchaseLifecycleStatus;
     items: PurchaseItem[];
     deliveryMethod?: string;
+    tracking?: unknown;
     maxBudget: number;
     finalTotal?: number;
     merchantReferences?: string[];

package/dist/index.d.ts

@@ -90,6 +90,7 @@ type Purchase = {
     status: PurchaseLifecycleStatus;
     items: PurchaseItem[];
     deliveryMethod?: string;
+    tracking?: unknown;
     maxBudget: number;
     finalTotal?: number;
     merchantReferences?: string[];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentmall",
-  "version": "0.1.16",
+  "version": "0.1.18",
   "description": "SDK and CLI for the AgentMall API — let AI agents buy physical products from US retailers",
   "type": "module",
   "main": "./dist/index.js",