@agent-cards/commerce-sdk 0.9.0 → 0.11.0

package/dist/model-view.js

@@ -4,8 +4,14 @@ const MAX_PRODUCTS = 20;
 const MARKDOWN_LINK = /\[([^\]]*)\]\([^)]*\)/g;
 const SCHEME_URL = /\b[a-z][a-z0-9+.-]*:\/\/[^\s<>"'`)\]]*/gi;
 const WWW_URL = /\bwww\.[^\s<>"'`)\]]*/gi;
-/** A host followed by a path, a query or a fragment: `vault.agentcard.sh/a/1`, `vault.agentcard.sh?token=abc`. */
-const HOST_PATH = /\b(?:[a-z0-9-]+\.)+[a-z]{2,}[/?#][^\s<>"'`)\]]*/gi;
+/**
+ * A host followed by a path, a query or a fragment: `vault.agentcard.sh/a/1`, `vault.agentcard.sh?token=abc`. A `?` that
+ * only punctuation follows before a space, a closing bracket or quote, or the end starts no query: in "at glossier.com?
+ * Say yes" it is the question's mark, and the host reads as its site's name (BARE_HOST). A `?` that more of an address
+ * follows starts one, punctuation or not (`glossier.com?.ref=x`), and a `#` always starts a fragment
+ * (`glossier.com#:~:text=Balm`).
+ */
+const HOST_PATH = /\b(?:[a-z0-9-]+\.)+[a-z]{2,}(?:[/#]|\?(?![.,;:!?]*(?:[\s<>"'`)\]]|$)))[^\s<>"'`)\]]*/gi;
 /**
  * A bare host on a common top-level domain, such as `agentcard.sh` or `amazon.com`, which a chat app
  * turns into a link. The list keeps words with a dot, such as `Node.js`, and an email address's host.
@@ -109,13 +115,35 @@ export function pickId(product) {
         return product.ref;
     return typeof product.id === 'string' && product.id !== '' && stripLinks(product.id) === product.id ? product.id : null;
 }
+/**
+ * What tells one product card from another: the product's link-free id, else its page. A restaurant gives
+ * every menu item the store's one page, so a card per page sent one card for a reply that offered three
+ * dishes (2026-10-20, Suavecito Birria & Tacos on DoorDash). Each product the model reads gets its own card.
+ */
+export function cardKey(product) {
+    return pickId(product) ?? (typeof product.url === 'string' && product.url !== '' ? product.url : null);
+}
+/**
+ * The key of the card a product gets, or null when it gets none: a product with a page at its store,
+ * or a flight option, which has no page, with an id a pick takes. A flight's card is how the shopper
+ * taps the flight they want (2026-10-20: three flights listed in text, and no card to tap).
+ */
+export function productCardKey(product) {
+    if (typeof product.url === 'string' && product.url !== '')
+        return cardKey(product);
+    return product.flight ? pickId(product) : null;
+}
 function cartView(cart) {
     return {
         store: stripLinks(cart.store?.name ?? cart.merchant_name) || stripLinks(cart.merchant),
         items: cart.items.map((line) => ({ name: stripLinks(line.name), qty: line.qty, price: money(line.priceCents, cart.currency) })),
         fees: cart.serviceFeesCents > 0 ? money(cart.serviceFeesCents, cart.currency) : null,
+        fee_lines: (cart.merchantFeeLines ?? []).map((line) => ({ label: stripLinks(line.label), amount: money(line.amountCents, cart.currency) })),
         tip: cart.tipCents > 0 ? money(cart.tipCents, cart.currency) : null,
         total: money(cart.totalCents, cart.currency) ?? money(0, cart.currency),
+        total_is_estimate: cart.totalIsEstimate === true,
+        // Agentcard names a ceiling equal to the total only for a hold of exactly the total, as a flight's.
+        max_charge: typeof cart.approvedCeilingCents === 'number' && cart.approvedCeilingCents > 0 && cart.approvedCeilingCents >= cart.totalCents ? money(cart.approvedCeilingCents, cart.currency) : null,
     };
 }
 /**
@@ -127,7 +155,7 @@ function cartView(cart) {
 export function forModel(result) {
     const status = typeof result.status === 'string' && MODEL_STATUSES.has(result.status) ? result.status : 'needs_input';
     const products = shownProducts(result.products);
-    const held = (product) => product.linkSent === true && typeof product.url === 'string' && product.url !== '';
+    const held = (product) => product.linkSent === true && productCardKey(product) !== null;
     const stores = shownStores(result.stores);
     const heldStore = (store) => store.linkSent === true && typeof store.url === 'string' && store.url !== '';
     return {
@@ -141,8 +169,11 @@ export function forModel(result) {
         shopper_need_not_reply: result.shopper_need_not_reply === true,
         shopper_already_told_looking: result.shopper_already_told_looking === true,
         link_sent: result.link_sent === true,
-        // Two products on one page share one link, so the count is of pages.
-        product_links_sent: new Set(products.filter(held).map((product) => product.url)).size,
+        links_sent: result.link_sent === true
+            ? [...new Set((result.links ?? []).map((link) => link.kind).filter((kind) => kind === 'vault' || kind === 'approval' || kind === 'store_login'))]
+            : [],
+        // A card per product, so two dishes on a restaurant's one page are two cards.
+        product_links_sent: new Set(products.filter(held).map(productCardKey)).size,
         // The id the model sent, never the catalog id, which is a store page for a retail product.
         pick: result.pick ? { product_id: pickId({ id: result.pick.product_id, ref: result.pick.ref }), in_cart: result.pick.in_cart === true } : null,
         stores: stores.map((store) => ({ store_id: store.id, name: stripLinks(store.name), eta_minutes: store.etaMinutes, link_sent: heldStore(store) })),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-cards/commerce-sdk",
-  "version": "0.9.0",
+  "version": "0.11.0",
   "description": "Give your agent one tool that buys for your shoppers at real stores, and post each purchase update Agentcard sends into the shopper's chat, over a connection your server opens or a webhook endpoint.",
   "type": "module",
   "main": "dist/index.js",