@agent-cards/commerce-sdk 0.13.0 → 0.15.0

package/dist/direct.js

@@ -0,0 +1,237 @@
+/**
+ * The buy call a shopper's message makes with no model deciding it: `directCall` reads the message, and
+ * what Agentcard last asked the shopper, and returns the call your app sends straight to Agentcard, or
+ * null when your model decides. Only three kinds of message go straight:
+ *
+ * - a request to buy or book something: a shopping verb with what to get (`find me usb-c cables under
+ *   $20`, `i need a gift for my dad`, `add a toothbrush from walmart to my cart`), a product link, a
+ *   product at a named store (`aa batteries on amazon`), or a table (`a table for 2 tonight at 7`);
+ * - a pick of what Agentcard just showed, by a card's tap (`I'll take the KODAK AA (24 Pack) ($13.49)`,
+ *   `Order from Shake Shack`), its place (`the first one`, `#2`, `1 and 3`) or a reference (`that one`);
+ * - the answer to the question Agentcard just asked: the address, name or code it asked for, a short
+ *   answer such as `medium` or `size 9`, or a plain yes to the total it asked the shopper to confirm.
+ *
+ * Everything else goes to the model: a question, small talk, a change of mind (`no`, `wait`, `cancel`),
+ * a command to the cart, and anything about the account, an order or how the chat works. A pick or an
+ * answer goes straight only while the shopper's last turn ended on Agentcard's answer, so a reply to
+ * something your model said reaches your model.
+ *
+ * The rule is tuned for precision over recall: a message that reaches Agentcard by mistake gets a
+ * purchase reply to small talk, while one the model reads by mistake costs only the model's call. On
+ * the 188 labelled messages in `test/fixtures/direct-messages.json`, it sends none it should not.
+ */
+import { ABOUT, ACKNOWLEDGED, CAPABILITY, CART_COMMAND, CHECKOUT, CHITCHAT, FILLER, asksForDetails, isNewRequest, isPickText, namesStore, plain } from './ack.js';
+/** The longest message that goes straight: a long one is read by the model. */
+const MAX_CHARS = 500;
+/** The steps a shopper answers with their own details or a code. */
+const DETAIL_STEPS = new Set(['shipping_details', 'guest_details', 'verification_code']);
+/** The words of a message: plain, with punctuation, `please` and `thanks` taken out. */
+function wordsOf(text) {
+    return plain(text).replace(/[^\p{L}\p{N}\s$'&+./#-]+/gu, ' ').replace(/[!?.,;:]+(?=\s|$)/g, ' ').replace(/[!?,;:]+/g, ' ').replace(/\b(?:please|pls|plz|thanks|thank you|thx|ty)\b/g, ' ').replace(/\s+/g, ' ').trim();
+}
+/** Words a message opens with before it says anything: a greeting or filler. */
+const OPENING = /^(?:(?:hey+|hi+|hello+|yo|hiya|howdy|good (?:morning|afternoon|evening)|ok|okay|so|um|uh|also|and|alright|cool|great)(?: there)?\s+)+/;
+/** A change of mind, a refusal or a stall: never an answer to send on. */
+const TAKEBACK = /^(?:i'?ll think|let me think|thinking|i'?m thinking|let me check|i'?ll check|i'?ll let you know|no|nope|nah|not (?:yet|now|really|sure)|cancel|stop|wait|hold on|hang on|never ?mind|nvm|forget (?:it|that|about it)|start over|nothing|none|neither|later|maybe|idk|i don'?t know|dunno|not sure|hmm+|um+|uh+|lol|lmao|haha+|ok|okay|k|kk|thanks?|ty|cool|nice|great|wow|oh|ah)\b/;
+/** Words that say the message is about something other than buying, wherever they sit. */
+const NOT_SHOPPING = new RegExp([
+    'joke', 'weather', 'forecast', 'news', 'poem', 'riddle', 'lyrics', 'translate', 'homework', 'essay', 'coding', 'python', 'javascript',
+    'bug', 'error', 'crash(?:ed|es)?', 'broken', 'not working', "doesn'?t work", 'refund', 'return policy', 'password', 'log ?in', 'sign ?in',
+    'account', 'api', 'support', 'customer service', 'agent ?card', 'what time', 'time is it', "today'?s date", 'human', 'real person',
+    'cancel', 'track(?:ing)?', "where'?s my", 'status', 'receipt', 'invoice', 'unsubscribe', 'privacy', 'kyc', 'identity', 'verify',
+    'promo', 'coupon', 'discount code', 'charged', 'charge me', 'balance', 'wallet', 'approve', 'approval', 'link',
+    '(?:my|a|the|new|your|payment|credit|debit|virtual|bank|visa|mastercard) card', 'card (?:number|details|on file)',
+]
+    .map((word) => `\\b${word}\\b`)
+    .join('|'));
+/** A message that opens as a question: the model reads it, unless it asks Agentcard to get something (`can you find me ...`). */
+const QUESTION_START = /^(?:what|whats|what'?s|where|wheres|where'?s|when|why|how|who|whose|which|is|are|was|were|do|does|did|should|shall|will|would|have|has|tell me|explain|any idea|wanna|you)\b/;
+/** A shopping verb and what follows it, after any opening such as `can you`. */
+const SHOP_FRAME = new RegExp('^(?:(?:can|could|would|will) (?:you|u) (?:please )?|please |i\'?d like (?:you )?to |help me )?' +
+    '(?:find(?: me| us)?|search(?: for)?|look(?:ing)? for|look up|show me|shop for|buy(?: me)?|order(?: me)?|purchase|get me|get us|grab(?: me)?|pick up|book(?: me)?|reserve|add|' +
+    "i want|i need|we need|we want|i'?d like|id like|i would like|i'?m looking for|im looking for|we'?re looking for|i'?m after|im after|" +
+    'need|want|can i get|could i get|can i have|could i have|i\'?ll have|send me|get)\\s+(.+)$');
+/** What a shopping verb takes that names nothing to buy: help, a person, a pronoun, the cart, a question. */
+const NOT_AN_ITEM = /^(?:(?:stuff|things|anything|items|products|everything)(?: (?:on|from|at|in|here|there|online)\b.*)?$|help|some help|assistance|someone|somebody|a human|a person|an agent|to (?!(?:buy|order|get|find|book|reserve|purchase|shop|grab|try)\b)\w+|info|information|advice|more info|you|u|me|it|this|that|these|those|them|nothing|out|lost|more|again|a (?:moment|minute|sec|second|break|nap|hug|vacation|friend)|how|what|where|why|when|who|(?:the |my |our )?(?:cart|basket|order|orders|total|purchases?|history|address)|my)\b/;
+/** A verb that needs an object word after it before it names a thing: `add` alone, or `get` with one word, says too little. */
+const MIN_ITEM_CHARS = 3;
+/** Stores a shopper names by brand, so `aa batteries amazon` reads as a product at a store. */
+const STORES = "amazon|walmart|target|best ?buy|costco|home depot|lowe'?s|ebay|etsy|doordash|door dash|uber ?eats|instacart|cvs|walgreens|nike|adidas|sephora|ulta|macy'?s|nordstrom|ikea|wayfair|chewy|whole foods|trader joe'?s|safeway|kroger|old navy|uniqlo|zara|h&m|rei|staples|office depot|barnes (?:&|and) noble|petco|petsmart|aldi|publix|sam'?s club|shein|temu|newegg|lululemon|patagonia|allbirds|glossier|shake shack|chipotle|starbucks|mcdonald'?s|taco bell|five guys|souvla|opentable|resy|1-800-flowers|zappos|kohl'?s|ace hardware|hollister|abercrombie|gap|apple store|dick'?s sporting goods";
+/** A store's own address, such as `livlyclothing.com`. */
+const DOMAIN = '[a-z0-9][a-z0-9-]*\\.(?:com|co|net|org|shop|store|us|uk|ca|io|co\\.uk)';
+/** A thing at a named store: `aa batteries from amazon`, `bows at livlyclothing.com`, `aa batteries amazon`, `tacos near me`. */
+const AT_STORE = new RegExp(`^(?:a |an |some |\\d+ )?[\\p{L}\\p{N}$'&+./-]+(?: [\\p{L}\\p{N}$'&+./-]+){0,9} (?:(?:(?:from|at|on|off) (?:the )?(?:${STORES}|${DOMAIN}))(?: [\\p{L}\\p{N}$'&+./-]+){0,6}|(?:${STORES})|near me)$`, 'u');
+/** Words a thing never opens with: a pronoun or a verb of the chat. */
+const NOT_A_THING = /^(?:i|i'?m|im|i'?ll|ill|i'?ve|ive|we|we'?re|you|u|your|it|its|it'?s|this|that|these|those|they|he|she|my|our|let|lets|let'?s|thank|thanks|just|still|so|not|no|yes|cool|nice|great|love|like|hate|wish|hope|think|guess|really|very|too)\b/;
+/** A table, or a reservation, for a number of people. */
+const TABLE = /^(?:(?:a |an |book (?:a |me a |us a )?)?(?:\w+ )?)?(?:table|reservation|res|booking) for (?:\d{1,2}|one|two|three|four|five|six|seven|eight|ten|twelve)\b/;
+/** A count or size a product is named by: `81 ct`, `30 rolls`, `160ct`, `6 pack`, `12 oz`. */
+const COUNTED = /\b\d+(?:\.\d+)? ?(?:ct|count|pk|pack|packs|rolls?|pcs|pieces|oz|fl oz|ml|lb|lbs|kg|g|gb|tb|mah|inch|in|ft|qt|quart|gallon|gal|capsules|tablets|caplets|gels|bars|cans|bottles)\b/;
+/** Words that tell of something that already happened, not something to get: `returned 3 bottles`, `the 12 pack never came`. */
+const HAPPENED = /\b(?:returned|bought|ordered|got|received|have|had|has|was|were|is|are|did|never|came|arrived|missing|broke|broken|delivered|shipped|yesterday|last)\b/;
+/** A purchase that already happened, which the shopper tells of rather than asks for: `returned my nike shoes yesterday`. */
+const PAST = /\b(?:returned|bought|ordered|received|arrived|came|never|yesterday|last (?:week|time|month|night)|already|refund(?:ed)?|expired)\b/;
+/** A correction of what came before, such as `actually i need AAA not AA`: the model reads it with what it corrects. */
+const CORRECTION = /^(?:actually|instead|no|nah|nope|wait|oh wait|hmm|oops|sorry|i meant|meant)\b|\bnot\b|\binstead\b/;
+/** Words that point at something only the shopper knows, such as `the usual` or `my home address`, or at a step to repeat. */
+const REFERS = /\b(?:whatever|anything|up to you|you pick|you choose|your call|surprise me|dealer'?s choice|usual|same as|as before|like before|like last time|my (?:home|work|office|regular|normal)\b|code|again)\b/;
+/** A complaint or a joke at a price or a store, which asks for nothing: `another $9.99 delivery fee on doordash`, `duracell is a ripoff`. */
+const COMPLAINT = /\b(?:fees?|ripoff|rip off|scam|overpriced|ugh|smh|annoying|terrible|worst|sucks|hate|love that|tbh|lol|lmao|wtf|seriously|bruh)\b/;
+const LINK = /\bhttps?:\/\/\S+|\bwww\.\S+/i;
+/**
+ * True when the message asks to buy or book something, read with no context: a shopping verb with what
+ * to get, a product link, a product at a named store, or a table. A question, small talk, a pick or an
+ * answer, a command to the cart, the shopper's own details and anything about the account read false.
+ */
+export function isProductAsk(text) {
+    const raw = String(text ?? '');
+    if (raw.length > MAX_CHARS)
+        return false;
+    const words = wordsOf(raw);
+    if (!/[\p{L}]/u.test(words))
+        return false;
+    const bare = words.replace(OPENING, '');
+    if (LINK.test(raw))
+        return !QUESTION_START.test(bare) && !NOT_SHOPPING.test(words.replace(/\S*https?:\/\/\S+|\S*www\.\S+/g, ''));
+    if (!isNewRequest(raw) || CAPABILITY.test(words) || NOT_SHOPPING.test(words) || PAST.test(words) || CORRECTION.test(words) || REFERS.test(words) || COMPLAINT.test(words))
+        return false;
+    // A question goes to the model, unless it asks Agentcard to get something: `can you find me usb-c cables?`.
+    const framed = SHOP_FRAME.exec(bare);
+    if (/\?/.test(raw) && !(framed && /^(?:can|could|would|will) (?:you|u)\b/.test(bare)))
+        return false;
+    if (QUESTION_START.test(bare))
+        return false;
+    if (framed) {
+        const item = framed[1].trim();
+        return item.length >= MIN_ITEM_CHARS && !NOT_AN_ITEM.test(item);
+    }
+    if (TABLE.test(bare))
+        return true;
+    // A product named with its count or size, such as `tide pods 81 ct` or `kirkland toilet paper 30 rolls`, with no verb.
+    if (COUNTED.test(bare) && !NOT_A_THING.test(bare) && !HAPPENED.test(bare) && bare.split(' ').length <= 10)
+        return true;
+    return AT_STORE.test(bare) && !NOT_A_THING.test(bare);
+}
+/** A plain yes: to a total, the go-ahead that confirms it. */
+const YES = /^(?:y|ya|yes+|yeah|yea|yep|yup|sure|confirm(?:ed)?|sounds good|looks good|perfect|yes (?:please|place it|go ahead|do it|confirm|that'?s right|correct))$/;
+function isYes(words) {
+    if (YES.test(words) || CHECKOUT.test(words))
+        return true;
+    // A yes, then the go-ahead in other words: `yep go ahead`, `ok do it`, `yes, place the order`, `sure, sounds good`.
+    const rest = words.replace(FILLER, '');
+    return rest !== words && (rest === '' || YES.test(rest) || CHECKOUT.test(rest));
+}
+/** Words that open a new request or a question rather than a short answer. */
+const REQUEST_START = /^(?:find|search|look|show|get|order|buy|book|can|could|would|will|what|which|how|is|are|do|does|did|i want|i need|please)\b/;
+/** Words that open an objection to giving details: the model answers it. */
+const OBJECTION = /\b(?:expired|wrong|invalid|another|new code|resend|lol|don'?t|do not|won'?t|didn'?t|did not|haven'?t|not|never|no|rather not|why|what|where|how|privacy|safe|secure|instead|different|change)\b/;
+/** Words that weigh a product rather than pick it: `duracell is too expensive`, `energizer instead of these`. */
+const DOUBT = /\b(?:far|close|closest|open|hours|distance|minutes|rating|reviews|not|no|too|expensive|cheaper|pricey|better|worse|than|instead|vs|versus|or|compare|difference|why|isn'?t|aren'?t|don'?t|doesn'?t|hate|meh)\b/;
+const ORDINALS = { first: 1, second: 2, third: 3, fourth: 4, fifth: 5, sixth: 6, seventh: 7, eighth: 8 };
+/** The places in a list a message names, such as `1 and 3` or `the second one`, in order: empty when it names none. */
+function placesOf(bare, count) {
+    const said = bare.replace(/^(?:i'?ll take|i'?ll do|i'?ll go with|go with|let'?s do|lets do|i want|give me|get me|add|the|both|option|options|number|numbers|item|#)\s*/g, ' ');
+    const tokens = said.match(/#?\d{1,2}(?:st|nd|rd|th)?|first|second|third|fourth|fifth|sixth|seventh|eighth|last/g) ?? [];
+    // The places stand alone, joined by `and` or a comma, with only `the`, `one`, `ones`, `option` or `#` around them.
+    const rest = said.replace(/#?\d{1,2}(?:st|nd|rd|th)?|first|second|third|fourth|fifth|sixth|seventh|eighth|last|\band\b|&|\+|,|\bthe\b|\bones?\b|\boptions?\b|\bnumbers?\b|\bitems?\b|#|\bplease\b/g, ' ').trim();
+    if (tokens.length === 0 || rest !== '')
+        return null;
+    const places = tokens.map((token) => (token === 'last' ? count : ORDINALS[token] ?? Number(token.replace(/\D/g, ''))));
+    return places.every((place) => place >= 1 && place <= count) ? places : null;
+}
+/** Text as lowercase words with single spaces, as the tool compares a product's name with a tap. */
+function nameWords(text) {
+    return String(text ?? '').toLowerCase().replace(/[^\p{L}\p{N}]+/gu, ' ').trim();
+}
+/** The pick a message makes of what Agentcard just showed, null when it picks nothing, or false when it counts past the list. */
+function pickOf(raw, bare, context) {
+    const products = context.products ?? [];
+    const stores = context.stores ?? [];
+    const call = (fields) => ({ input: { ask: raw, confirm: false, new_order: false, product_id: null, store_id: null, ...fields }, reason: 'pick' });
+    if (stores.length > 0) {
+        const said = ` ${nameWords(raw)} `;
+        // A store's card names it whole; a store named with the dishes to order from it (`five guys, bacon cheeseburger`) picks it too.
+        const named = stores.filter((store) => namesStore(raw, [store.name]) || (nameWords(store.name).length >= 5 && said.includes(` ${nameWords(store.name)} `)));
+        if (named.length === 1 && !QUESTION_START.test(bare) && !DOUBT.test(said))
+            return call({ store_id: named[0].storeId });
+        if (named.length > 0 && (QUESTION_START.test(bare) || DOUBT.test(said)))
+            return false;
+        if (named.length > 1)
+            return call({});
+    }
+    if (products.length > 0) {
+        // A card's tap names the product whole: `I'll take the KODAK AA Alkaline Batteries (24 Pack) ($13.49)`.
+        const said = nameWords(raw);
+        const named = products.filter((product) => nameWords(product.name).length >= 12 && said.includes(nameWords(product.name)));
+        if (named.length === 1)
+            return call({ product_id: named[0].productId });
+        if (named.length > 1)
+            return call({});
+        // A word only one product's name holds, such as its brand: `lets do the coppertop ones`, `duracell 24 count is fine`.
+        const words = new Set(said.split(' '));
+        const owners = (word) => products.filter((product) => nameWords(product.name).split(' ').includes(word));
+        const marked = products.filter((product) => nameWords(product.name).split(' ').some((word) => word.length >= 4 && !/^\d/.test(word) && words.has(word) && owners(word).length === 1));
+        if (marked.length === 1 && said.split(' ').length <= 10 && !QUESTION_START.test(bare) && !DOUBT.test(said))
+            return call({ product_id: marked[0].productId });
+        const places = placesOf(bare, products.length);
+        if (places)
+            return call(places.length === 1 ? { product_id: products[places[0] - 1].productId } : {});
+        // A place past the end of the list picks nothing the shopper saw.
+        if (placesOf(bare, Number.MAX_SAFE_INTEGER))
+            return false;
+        if (/^(?:both|all|all of them|both of them|all three|all 3)$/.test(bare))
+            return call({});
+    }
+    if ((products.length > 0 || stores.length > 0) && isPickText(raw))
+        return call({});
+    return null;
+}
+/**
+ * The call a shopper's message makes straight to Agentcard, with no model deciding it, or null when
+ * your model decides: see the top of this file for what goes straight. `ask` carries the shopper's
+ * words as they sent them, a confirm goes in only for a plain yes to the total Agentcard asked them to
+ * confirm, and a pick names its `product_id` or `store_id` only when the message names one exactly.
+ *
+ * ```ts
+ * directCall('find me usb-c cables under $20'); // { input: { ask: 'find me usb-c cables under $20', confirm: false, ... }, reason: 'product_ask' }
+ * directCall('what time is it'); // null
+ * directCall('yes', { answered: true, nextAction: 'confirm' }); // { input: { ask: 'yes', confirm: true, ... }, reason: 'confirm' }
+ * ```
+ */
+export function directCall(shopperText, context = {}) {
+    const raw = String(shopperText ?? '').trim();
+    if (raw === '' || raw.length > MAX_CHARS)
+        return null;
+    const ctx = context ?? {};
+    const words = wordsOf(raw);
+    if (!/[\p{L}\p{N}]/u.test(words))
+        return null;
+    const bare = words.replace(OPENING, '') || words;
+    const plainCall = (reason, confirm = false) => ({ input: { ask: raw, confirm, new_order: false, product_id: null, store_id: null }, reason });
+    if (ctx.answered === true && !/\?/.test(raw)) {
+        const told = CHITCHAT.test(words) || ABOUT.test(words) || CART_COMMAND.test(words) || CAPABILITY.test(words);
+        if (ctx.nextAction === 'confirm' && isYes(words))
+            return plainCall('confirm', true);
+        // A question, a story of what happened, an objection or a change of mind is the model's to answer, whatever came before.
+        const aside = QUESTION_START.test(bare) || REFERS.test(words) || COMPLAINT.test(words) || PAST.test(words) || NOT_SHOPPING.test(words) || OBJECTION.test(words) || CORRECTION.test(words);
+        if (!told && !aside && !TAKEBACK.test(words)) {
+            const pick = pickOf(raw, bare, ctx);
+            if (pick === false)
+                return null;
+            if (pick)
+                return pick;
+            // The address, name or code Agentcard asked for: what the shopper sends is the answer, unless it objects.
+            const details = (typeof ctx.nextAction === 'string' && DETAIL_STEPS.has(ctx.nextAction)) || asksForDetails(ctx.asked);
+            if (details && !OBJECTION.test(words) && !REQUEST_START.test(bare) && !QUESTION_START.test(bare) && !PAST.test(words) && !/\b(?:same as|on file|you have|the usual|ur|your)\b/.test(words) && !/^(?:resend|send|again|still)\b/.test(bare) && !NOT_SHOPPING.test(words) && words.split(' ').length <= 40)
+                return plainCall('answer');
+            // A short answer to Agentcard's question, such as `medium` after `what size?`, or a yes to `want me to check amazon?`.
+            if (/\?/.test(String(ctx.asked ?? '')) && ctx.nextAction !== 'confirm' && !NOT_SHOPPING.test(words)) {
+                if (isYes(words))
+                    return plainCall('answer');
+                if (!ACKNOWLEDGED.test(words) && words.split(' ').length <= 4 && !REQUEST_START.test(bare))
+                    return plainCall('answer');
+            }
+        }
+    }
+    return isProductAsk(raw) ? plainCall('product_ask') : null;
+}

package/dist/events.d.ts

@@ -3,7 +3,7 @@
  * name. The stream (`agentcard.listen`) and a webhook endpoint carry the same types, with the same
  * envelope and the same ids. A test holds this list to the backend's catalog.
  */
-export declare const AGENTCARD_EVENT_TYPES: readonly ["card.created", "card.updated", "card.closed", "cardholder.created", "cardholder.updated", "transaction.authorized", "transaction.declined", "transaction.cleared", "transaction.voided", "balance.low", "cardholder_onboarding_session.completed", "platform_connect_session.completed", "merchant.connected", "order.placed", "order.confirmed", "order.failed", "order.updated", "purchase.message", "connection.created", "connected_card.updated", "vault.card_stored", "vault.session_linked", "vault.session_card_picked", "vault.payment_permission.updated", "action.confirmed", "action.done", "checkout_authorization.approved", "checkout_authorization.submitted", "checkout_authorization.declined", "checkout_authorization.cancelled", "checkout_authorization.expired", "checkout_authorization.duplicate_charge", "checkout_authorization.refused", "checkout_authorization.watched", "checkout_authorization.amount_mismatch", "checkout_authorization.settled", "checkout_authorization.settlement_unconfirmed", "checkout_authorization.outcome_reported", "card_flow.started", "card_flow.failed", "transfer.approved", "transfer.initiated", "transfer.completed", "transfer.failed", "transfer.released", "wallet.funded", "user_wallet.funding_detected", "user_wallet.funded", "wallet.balance.low", "recovery.requested", "recovery.completed", "recovery.rejected", "wallet.withdrawal.initiated", "wallet.withdrawal.completed", "wallet.withdrawal.failed", "identity.verification.updated", "approval.requested", "reward.earned", "reward.reversed", "wallet_link.opened"];
+export declare const AGENTCARD_EVENT_TYPES: readonly ['card.created', 'card.updated', 'card.closed', 'cardholder.created', 'cardholder.updated', 'transaction.authorized', 'transaction.declined', 'transaction.cleared', 'transaction.voided', 'balance.low', 'cardholder_onboarding_session.completed', 'platform_connect_session.completed', 'merchant.connected', 'order.placed', 'order.confirmed', 'order.failed', 'order.updated', 'purchase.message', 'connection.created', 'connected_card.updated', 'vault.card_stored', 'vault.session_linked', 'vault.session_card_picked', 'vault.payment_permission.updated', 'action.confirmed', 'action.done', 'checkout_authorization.approved', 'checkout_authorization.submitted', 'checkout_authorization.declined', 'checkout_authorization.cancelled', 'checkout_authorization.expired', 'checkout_authorization.duplicate_charge', 'checkout_authorization.refused', 'checkout_authorization.watched', 'checkout_authorization.amount_mismatch', 'checkout_authorization.settled', 'checkout_authorization.settlement_unconfirmed', 'checkout_authorization.outcome_reported', 'card_flow.started', 'card_flow.failed', 'transfer.approved', 'transfer.initiated', 'transfer.completed', 'transfer.failed', 'transfer.released', 'wallet.funded', 'user_wallet.funding_detected', 'user_wallet.funded', 'wallet.balance.low', 'recovery.requested', 'recovery.completed', 'recovery.rejected', 'wallet.withdrawal.initiated', 'wallet.withdrawal.completed', 'wallet.withdrawal.failed', 'identity.verification.updated', 'approval.requested', 'reward.earned', 'reward.reversed', 'wallet_link.opened'];
 /** One event type Agentcard sends. A type Agentcard adds later still reads as its own name. */
 export type AgentcardEventType = (typeof AGENTCARD_EVENT_TYPES)[number];
 /** Whether a filter entry names something Agentcard sends: an event type, a family such as `order.*`, or `*`. */

package/dist/index.d.ts

@@ -2,12 +2,13 @@ export { verifyAgentcardWebhook, AgentcardSignatureError, type AgentcardSignatur
 export { readPurchaseMessage, type PurchaseMessage, type PurchaseMessageKind, type PurchaseFacts, } from './message.js';
 export { readShopperMessage, isStale, SHOPPER_EVENT_TYPES, NEXT_STEP_KINDS, type NextStepKind, type ShopperMessage, type ShopperMessageKind, type ShopperFacts, type ShopperEventType, type OrderStatus, } from './shopper-message.js';
 export { agentcardWebhook, purchaseAgentWebhook, type AgentcardWebhookOptions, type AgentcardWebhookHandler, type PurchaseAgentWebhookOptions, type WebhookFetchRequest, type WebhookRequest, type WebhookResponse, } from './handler.js';
-export { AgentcardClient, AgentcardApiError, BUY_TURN_TIMEOUT_MS, DEFAULT_BASE_URL, type AgentcardClientOptions, type FetchLike, type FetchLikeResponse, type BuyProgress, type BuyProgressStage, type BuyCatalogUpdate, type BuyStreamHandlers, type Shopper, type BuyRequest, type BuyDeliveryAddress, type BuyTurn, type BuyStatus, type BuyCart, type BuyCartBuilding, type BuyCartLine, type BuyCartFeeLine, type BuyStore, type BuyCatalog, type BuyCatalogItem, type BuyFlightItinerary, type BuyPaymentSource, type BuyConversation, type BuyLastCheckout, type BuyOrder, type VaultLink, type BuyNextAction, type BuyPick, type BuyStoreChoice, type BuyStorePick, type BuyStores, } from './client.js';
+export { AgentcardClient, AgentcardApiError, BUY_TURN_TIMEOUT_MS, DEFAULT_BASE_URL, type AgentcardClientOptions, type AgentcardTraceOptions, type OtelApi, type TraceContext, type FetchLike, type FetchLikeResponse, type BuyProgress, type BuyProgressStage, type BuyCatalogUpdate, type BuyAvailability, type BuyAvailabilityUpdate, type BuyFoundUpdate, type BuyTurnStatus, type BuySegmentUpdate, type BuyCartUpdate, type BuyDeltaUpdate, type BuyStreamHandlers, type Shopper, type BuyRequest, type BuyDeliveryAddress, type BuyTurn, type BuyStatus, type BuyCart, type BuyCartBuilding, type BuyCartLine, type BuyCartFeeLine, type BuyStore, type BuyCatalog, type BuyCatalogItem, type BuyFlightItinerary, type BuyPaymentSource, type BuyConversation, type BuyLastCheckout, type BuyOrder, type VaultLink, type BuyNextAction, type BuyPick, type BuyStoreChoice, type BuyStorePick, type BuyStores, } from './client.js';
 export { BUY_TOOL_NAME, BUY_TOOL_DESCRIPTION, buyToolDefinition, parseBuyToolInput, type BuyToolDefinition, type BuyToolInput, type BuyToolInputSchema, type BuyToolInputCheck, type BuyToolStandardSchema, type OpenAIBuyTool, } from './definition.js';
 export { toMessages, messageStream, typingDelay, type MessagePace, type MessageStream, type MessageStreamOptions, } from './messages.js';
-export { buyTool, nextStepPrompt, type BuyTool, type BuyToolOptions, type BuyToolResult, type BuyToolStatus, type BuyToolLink, type BuyToolProduct, type BuyToolProductAction, productAction, type BuyToolStore, type BuyToolTurn, type BuyToolTurnItem, type BuyToolTurnOptions, type BuyToolTurnMessage, type BuyAckMode, } from './buy-tool.js';
+export { buyTool, nextStepPrompt, type BuyTool, type BuyToolOptions, type BuyToolResult, type BuyToolStatus, type BuyToolLink, type BuyToolFound, type BuyToolAvailability, type BuyToolProduct, type BuyToolProductAction, productAction, type BuyToolStore, type BuyToolTurn, type BuyToolTurnItem, type BuyToolTurnOptions, type BuyToolTurnMessage, type BuyAckMode, } from './buy-tool.js';
 export { instantAck, instantReaction, ackFor, keepsYes, ACK_REACTION, type AckForOptions } from './ack.js';
-export { forModel, forModelError, replyAsWritten, stripLinks, type BuyToolModelView, type BuyToolModelCart, type BuyToolModelProduct, type BuyToolModelStore, } from './model-view.js';
+export { directCall, isProductAsk, type DirectCall, type DirectContext, type DirectReason } from './direct.js';
+export { forModel, forModelError, replyAsWritten, withoutCardList, stripLinks, type BuyToolModelView, type BuyToolModelCart, type BuyToolModelProduct, type BuyToolModelStore, } from './model-view.js';
 export { toAnthropicTool, toOpenRouterTool, type AnthropicBuyTool, type OpenRouterToolkit, type ZodLike, } from './adapters.js';
 export { listenToAgentcard, type AgentcardListener, type ListenOptions, type ListenCursorStore, type StreamFetch, } from './listen.js';
 export { ACTION_LINK_ENDINGS, ACTION_LINK_KINDS, actionLinkId, actionLinkOutcome, isActionLink, type ActionLinkKind, type ActionLinkMessage, type ActionLinkOutcome, } from './action-links.js';

package/dist/index.js

@@ -7,7 +7,8 @@ export { BUY_TOOL_NAME, BUY_TOOL_DESCRIPTION, buyToolDefinition, parseBuyToolInp
 export { toMessages, messageStream, typingDelay, } from './messages.js';
 export { buyTool, nextStepPrompt, productAction, } from './buy-tool.js';
 export { instantAck, instantReaction, ackFor, keepsYes, ACK_REACTION } from './ack.js';
-export { forModel, forModelError, replyAsWritten, stripLinks, } from './model-view.js';
+export { directCall, isProductAsk } from './direct.js';
+export { forModel, forModelError, replyAsWritten, withoutCardList, stripLinks, } from './model-view.js';
 export { toAnthropicTool, toOpenRouterTool, } from './adapters.js';
 export { listenToAgentcard, } from './listen.js';
 export { ACTION_LINK_ENDINGS, ACTION_LINK_KINDS, actionLinkId, actionLinkOutcome, isActionLink, } from './action-links.js';

package/dist/model-view.d.ts

@@ -26,6 +26,7 @@ export interface BuyToolModelCart {
         variant: string | null;
     }>;
     fees: string | null;
+    fees_status?: 'known' | 'pending' | 'unknown';
     /** The store's own fee and tax lines inside `fees`, by the store's labels. Empty when it itemized none. */
     fee_lines: Array<{
         label: string;
@@ -89,6 +90,8 @@ export interface BuyToolModelView {
     shopper_need_not_reply: boolean;
     /** True when the shopper already got a message this turn saying their request is being worked on, so the reply opens with no acknowledgement of its own. */
     shopper_already_told_looking: boolean;
+    /** True when the shopper already read `reply`, every message of it, as Agentcard wrote it, so the answer adds only what it leaves out. */
+    shopper_already_read_reply: boolean;
     /** True when the shopper already has the link this answer needed. */
     link_sent: boolean;
     /**
@@ -119,6 +122,13 @@ export interface BuyToolModelView {
  * entirely, and a bare address reads as the site's name (siteName), so the store a reply names stays in it.
  */
 export declare function stripLinks(text: string): string;
+/**
+ * Agentcard's reply as the shopper and the model read it, with every link taken out (stripLinks) and no line left pointing at
+ * one. A line that pointed at a link ends as a sentence when the answer sent the shopper what it pointed at, a product or a
+ * store card or a step's link, and goes when it sent none, so the reply never promises what the shopper does not get. 2026-10-27, chat.opencommerce.sh:
+ * "here's the stool on Wayfair:" reached the shopper with nothing after it.
+ */
+export declare function replyWithoutLinks(reply: string, sent: boolean): string;
 /**
  * An amount in its currency's minor unit, as the model reads it: the currency's own minor units place the
  * decimal point, so 1331 is $13.31 in USD, CA$13.31 in CAD and ¥1,331 in JPY. An amount whose currency
@@ -159,10 +169,11 @@ export declare function pickId(product: Pick<BuyToolProduct, 'id' | 'ref'>): str
 export declare function cardKey(product: Pick<BuyToolProduct, 'id' | 'ref' | 'url'>): string | 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).
+ * or a flight option or a place to book, which can have 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),
+ * and a place's card is where the shopper reads whether it has room.
  */
-export declare function productCardKey(product: Pick<BuyToolProduct, 'id' | 'ref' | 'url' | 'flight'>): string | null;
+export declare function productCardKey(product: Pick<BuyToolProduct, 'id' | 'ref' | 'url' | 'flight' | 'availability'>): string | null;
 /** How long until `iso`, from `now`, as the shopper reads it: `about 24 hours`, `about 15 minutes`, `no longer`, or null. */
 export declare function expiresIn(iso: string | null | undefined, now?: number): string | null;
 /**
@@ -179,12 +190,26 @@ export declare function forModel(result: BuyToolResult): BuyToolModelView;
  * Null for any other answer, which your model puts in its own words, and for a line the tool wrote
  * itself for your model, such as the note that the cart changed or a `nextStep` turn's ask for the
  * shopper's yes: only the reply Agentcard sent, as `envelope` holds it, is written for the shopper.
+ * Null as well once the shopper read the reply through `onText` (`shopper_already_read_reply`).
  *
  * ```ts
  * replyAsWritten(result); // 'found two at Amazon. want the first one?'
  * ```
  */
 export declare function replyAsWritten(result: BuyToolResult): string | null;
+/**
+ * Agentcard's reply without the list its cards already show the shopper: each list line that names a product or
+ * store whose card went out, the line that led into that list (`here are a few:`, `other choices:`), a sentence that
+ * points at a number the list gave (`the dishwand in #8`), and, past the one or two products a reply recommends in
+ * words, each further sentence that names another card. What is left is the reply around the list, such as `found
+ * these at amazon.` and `which one do you want?`. A reply whose cards went out names none of them twice over.
+ *
+ * ```ts
+ * withoutCardList('Two I'd suggest:\n- Duracell AA, 24 pack, $20.78\n\nWhich one?', ['Duracell AA Batteries, 24 Count']);
+ * // 'Which one?'
+ * ```
+ */
+export declare function withoutCardList(reply: string, cardNames: readonly string[]): string;
 /**
  * A thrown error as the model may read it: the same message with every link
  * taken out, and the original error on `cause` for your logs. A TypeError

package/dist/model-view.js

@@ -59,6 +59,24 @@ export function stripLinks(text) {
         .replace(/\n{3,}/g, '\n\n')
         .trim();
 }
+/**
+ * A line that points at a link with a colon, the link after it on the same line or alone on the next: `here's the stool on
+ * Wayfair: https://www.wayfair.com/...`, one in angle brackets, or a bare address with a path or query (`vault.agentcard.sh?token=...`,
+ * never a bare `www.walmart.com`, which stripLinks keeps as the store's name). Every such
+ * link comes out of what the shopper reads (stripLinks), and the colon would then point at nothing. A Markdown link is not one:
+ * stripLinks keeps its label, which the shopper reads after the colon. A question mark that ends the sentence is not a query,
+ * as HOST_PATH reads it (`Buy from: glossier.com?`), and a page whose path ends in a bracket keeps it (`stool_(oak)`).
+ */
+const POINTS_AT_LINK = /^([^\n]*?\S)[ \t]*:[ \t]*(?:\n[ \t]*)?<?(?:https?:\/\/|(?:www\.)?(?:[\p{L}\p{N}-]+\.)+\p{L}{2,}(?:[/#]|\?(?![.,;:!?]*(?:[\s<>"'`)\]]|$))))[^\s<>"'`\]]*>?[ \t]*[.!]?[ \t]*$/gimu;
+/**
+ * Agentcard's reply as the shopper and the model read it, with every link taken out (stripLinks) and no line left pointing at
+ * one. A line that pointed at a link ends as a sentence when the answer sent the shopper what it pointed at, a product or a
+ * store card or a step's link, and goes when it sent none, so the reply never promises what the shopper does not get. 2026-10-27, chat.opencommerce.sh:
+ * "here's the stool on Wayfair:" reached the shopper with nothing after it.
+ */
+export function replyWithoutLinks(reply, sent) {
+    return stripLinks(String(reply ?? '').replace(POINTS_AT_LINK, (_line, lead) => (sent ? `${lead}.` : '')));
+}
 /** A currency's minor units as Intl knows them: 2 for USD and CAD, 0 for JPY. */
 function minorUnits(format) {
     return format.resolvedOptions().maximumFractionDigits ?? 0;
@@ -135,13 +153,14 @@ export function cardKey(product) {
 }
 /**
  * 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).
+ * or a flight option or a place to book, which can have 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),
+ * and a place's card is where the shopper reads whether it has room.
  */
 export function productCardKey(product) {
     if (typeof product.url === 'string' && product.url !== '')
         return cardKey(product);
-    return product.flight ? pickId(product) : null;
+    return product.flight || product.availability ? pickId(product) : null;
 }
 function cartView(cart) {
     return {
@@ -159,7 +178,8 @@ function cartView(cart) {
             options: (line.options ?? []).map(stripLinks).filter((o) => o !== ''),
             variant: line.variant ? stripLinks(line.variant) || null : null,
         })),
-        fees: cart.serviceFeesCents > 0 ? money(cart.serviceFeesCents, cart.currency) : null,
+        fees: cart.serviceFeesCents !== null && cart.serviceFeesCents > 0 ? money(cart.serviceFeesCents, cart.currency) : null,
+        fees_status: cart.serviceFeesStatus,
         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),
@@ -217,7 +237,7 @@ export function forModel(result) {
         status,
         next_action: result.next_action ?? null,
         ...(result.cart_building ? { cart_building: { store: stripLinks(result.cart_building.store) } } : {}),
-        reply: stripLinks(result.reply),
+        reply: replyWithoutLinks(result.reply, products.some(held) || stores.some(heldStore) || result.link_sent === true),
         cart: result.cart ? cartView(result.cart) : null,
         carts: (result.carts ?? []).map(cartView),
         products: products.map((product) => ({ product_id: pickId(product), name: stripLinks(product.name), store: stripLinks(product.store ?? ''), price: productPrice(product), link_sent: held(product) })),
@@ -226,6 +246,7 @@ export function forModel(result) {
         // A step's ask is one short line: an approval Agentcard places on its own needs no "no need to reply" beside it.
         shopper_need_not_reply: result.shopper_need_not_reply === true && !STEP_ACTIONS.has(result.next_action ?? ''),
         shopper_already_told_looking: result.shopper_already_told_looking === true,
+        shopper_already_read_reply: result.shopper_already_read_reply === true,
         link_sent: result.link_sent === true,
         links_sent: result.link_sent === true
             ? [...new Set((result.links ?? []).map((link) => link.kind).filter((kind) => kind === 'vault' || kind === 'approval' || kind === 'store_login'))]
@@ -249,17 +270,140 @@ export function forModel(result) {
  * Null for any other answer, which your model puts in its own words, and for a line the tool wrote
  * itself for your model, such as the note that the cart changed or a `nextStep` turn's ask for the
  * shopper's yes: only the reply Agentcard sent, as `envelope` holds it, is written for the shopper.
+ * Null as well once the shopper read the reply through `onText` (`shopper_already_read_reply`).
  *
  * ```ts
  * replyAsWritten(result); // 'found two at Amazon. want the first one?'
  * ```
  */
 export function replyAsWritten(result) {
+    // The shopper already read every message of it through onText: handing it out again would say it twice.
+    if (result.shopper_already_read_reply === true)
+        return null;
     // The tool's own lines tell the model what to say, so only Agentcard's reply, unchanged, goes out as is.
     const agentcards = typeof result.envelope?.reply === 'string' && result.envelope.reply === result.reply;
     const view = forModel(result);
     const reply = view.reply.trim();
-    return agentcards && view.status === 'needs_input' && reply !== '' ? reply : null;
+    if (!agentcards || view.status !== 'needs_input' || reply === '')
+        return null;
+    const cards = [...view.products.filter((product) => product.link_sent).map((product) => product.name), ...view.stores.filter((store) => store.link_sent).map((store) => store.name)];
+    // A reply with nothing left once the cards' list comes out is your model's to word.
+    return withoutCardList(reply, cards) || null;
+}
+/** A line that opens a list: `- `, `* `, `• `, `1. ` or `1) `. */
+const LIST_ITEM = /^\s*(?:[-*•]|\d{1,2}[.)])\s+/;
+/** A price, in any of the currencies a store writes one in. */
+const PRICE = /[$£€]\s?\d/;
+/** The place a sentence points at in a numbered list, such as `#8` or `number 3`, where `a #2 Phillips head` names a kind of thing. */
+const LIST_NUMBER = /(?<!\ba )(?<!\ban )(?:#(\d{1,2})\b|\bnumber (\d{1,2})\b)/i;
+/** A unit a size or a count is written in, so `10 ft`, `10-ft` and `10ft` read as one word. */
+const UNIT = /(\d)[\s-]+(ft|feet|foot|inch|inches|oz|fl|ml|l|g|kg|lb|lbs|gb|tb|mb|w|mah|v|cm|mm|m|pack|pk|ct|count|pcs|pieces)\b/gi;
+/**
+ * A size one text spells one way and a card's name another, so `24 pack` reads as the card's `24 Count`. Inches lose
+ * their unit, so `41 in black` reads as the card's `41` and `10 in` as its `10in`: `in` is a word as often as a unit.
+ */
+const SAME_UNIT = new Map([['feet', 'ft'], ['foot', 'ft'], ['in', ''], ['inch', ''], ['inches', ''], ['pk', 'pack'], ['ct', 'pack'], ['count', 'pack'], ['pcs', 'pack'], ['pieces', 'pack'], ['lbs', 'lb']]);
+/** A size or a count written as one word, such as `24pack` or `10ft`. */
+const SIZE = /^(\d+)(\p{L}+)$/u;
+/** A text's words, lowercased, letters and digits only, with markdown's bold marks gone and a size written as one word. */
+function wordsOf(text) {
+    return text
+        .toLowerCase()
+        .replace(UNIT, '$1$2')
+        .split(/[^\p{L}\p{N}]+/u)
+        .filter((word) => word !== '')
+        .map((word) => word.replace(SIZE, (whole, count, unit) => `${count}${SAME_UNIT.get(unit) ?? unit}`));
+}
+/**
+ * The card a text names, by the first six words of the card's name: at least two of them, and most of them, in the
+ * text. Null when it names none. A name of one word never counts in prose, where a generic word such as `soap` would.
+ * A size or a count among those words has to be in the text too, so the 3ft cable's line never reads as the 10ft card.
+ */
+function cardNamed(text, cards, inList) {
+    const said = new Set(wordsOf(text));
+    for (const [index, name] of cards.entries()) {
+        const head = name.slice(0, 6);
+        if (!head.every((word) => !/\d/.test(word) || said.has(word)))
+            continue;
+        const hits = head.filter((word) => said.has(word)).length;
+        if (head.length === 1 ? inList && hits === 1 : hits >= Math.max(2, Math.ceil(head.length * 0.6)))
+            return index;
+    }
+    return null;
+}
+/**
+ * Agentcard's reply without the list its cards already show the shopper: each list line that names a product or
+ * store whose card went out, the line that led into that list (`here are a few:`, `other choices:`), a sentence that
+ * points at a number the list gave (`the dishwand in #8`), and, past the one or two products a reply recommends in
+ * words, each further sentence that names another card. What is left is the reply around the list, such as `found
+ * these at amazon.` and `which one do you want?`. A reply whose cards went out names none of them twice over.
+ *
+ * ```ts
+ * withoutCardList('Two I'd suggest:\n- Duracell AA, 24 pack, $20.78\n\nWhich one?', ['Duracell AA Batteries, 24 Count']);
+ * // 'Which one?'
+ * ```
+ */
+export function withoutCardList(reply, cardNames) {
+    const cards = cardNames.map(wordsOf).filter((name) => name.length > 0);
+    if (cards.length === 0)
+        return reply.trim();
+    // A text that opens with a card's name and gives its price is a list line, as a reply writes one without a bullet.
+    const opensCard = (text) => {
+        const words = wordsOf(text);
+        return PRICE.test(text) && cards.some((name) => name.length >= 2 && name.slice(0, 3).every((word, i) => words[i] === word));
+    };
+    const lines = reply.split('\n');
+    const kind = lines.map((line) => {
+        if (LIST_ITEM.test(line))
+            return cardNamed(line.replace(LIST_ITEM, ''), cards, true) !== null ? 'item' : 'kept';
+        return opensCard(line) ? 'named' : 'kept';
+    });
+    const dropped = kind.map((of) => of !== 'kept');
+    // The numbers the dropped list gave, so a number of a product's own, `a #2 Phillips head`, keeps its sentence.
+    const numbers = new Set(lines.flatMap((line, i) => (dropped[i] ? [Number(/^\s*(\d{1,2})[.)]\s/.exec(line)?.[1])] : [])).filter((number) => Number.isInteger(number)));
+    // The list a line leads into: the lines from the next one with words on it to the first that is not a list line, so a
+    // question on the line after the last item, `Which one?`, is no part of the list.
+    const listAfter = (line) => {
+        const start = lines.findIndex((after, j) => j > line && after.trim() !== '');
+        if (start === -1)
+            return [];
+        let end = start;
+        while (end < lines.length && (LIST_ITEM.test(lines[end]) || kind[end] === 'named'))
+            end += 1;
+        return dropped.slice(start, end);
+    };
+    const named = new Set();
+    const kept = [];
+    lines.forEach((line, i) => {
+        if (kind[i] === 'item')
+            return;
+        let text = line;
+        // The line that leads into a list whose every line went loses the sentence that leads in: `Two I'd suggest:` or
+        // `Other choices:`. A list that keeps a line, for a product no card shows, keeps its lead too.
+        const list = listAfter(i);
+        if (text.trim().endsWith(':') && list.length > 0 && list.every(Boolean))
+            text = text.trim().replace(/(?:^|(?<=[.!?])\s+)[^.!?]*:$/, '');
+        const sentences = text.split(/(?<=[.!?])\s+/).filter((sentence) => {
+            const place = LIST_NUMBER.exec(sentence);
+            if (place && numbers.has(Number(place[1] ?? place[2])))
+                return false;
+            const card = cardNamed(sentence, cards, false);
+            // A list line written without a bullet keeps the sentences its card does not say, such as the question after it.
+            if (kind[i] === 'named')
+                return card === null && !opensCard(sentence);
+            if (card === null || named.has(card))
+                return true;
+            // A reply recommends one or two products in words; a sentence that names a third is the list again.
+            if (named.size >= 2)
+                return false;
+            named.add(card);
+            return true;
+        });
+        if (kind[i] === 'named' && sentences.length === 0)
+            return;
+        kept.push(sentences.join(' ').trimEnd());
+    });
+    return kept.join('\n').replace(/\n{3,}/g, '\n\n').trim();
 }
 /**
  * A thrown error as the model may read it: the same message with every link

package/dist/shopper-message.d.ts

@@ -9,7 +9,7 @@ import { type PurchaseFacts, type PurchaseMessageKind } from './message.js';
  * The event types that carry a message for a shopper. Subscribe your endpoint to each by name:
  * a catch-all `*` alone does not turn `purchase.message` on.
  */
-export declare const SHOPPER_EVENT_TYPES: readonly ["purchase.message", "order.confirmed", "order.updated"];
+export declare const SHOPPER_EVENT_TYPES: readonly ['purchase.message', 'order.confirmed', 'order.updated'];
 /** One of the event types that carry a message for a shopper. */
 export type ShopperEventType = (typeof SHOPPER_EVENT_TYPES)[number];
 /**
@@ -18,7 +18,7 @@ export type ShopperEventType = (typeof SHOPPER_EVENT_TYPES)[number];
  * to the store (`store_connected`), or declined the approval (`approval_declined`), outside the chat.
  * `buy.nextStep(message)` opens that turn. Every other kind's `text` is the whole message: post it as is.
  */
-export declare const NEXT_STEP_KINDS: readonly ["card_added", "store_connected", "approval_declined"];
+export declare const NEXT_STEP_KINDS: readonly ['card_added', 'store_connected', 'approval_declined'];
 /** A kind after which the agent takes the next step on its own. */
 export type NextStepKind = (typeof NEXT_STEP_KINDS)[number];
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-cards/commerce-sdk",
-  "version": "0.13.0",
+  "version": "0.15.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",
@@ -40,6 +40,14 @@
     "webhooks",
     "purchases"
   ],
+  "peerDependencies": {
+    "@opentelemetry/api": "^1.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@opentelemetry/api": {
+      "optional": true
+    }
+  },
   "engines": {
     "node": ">=18"
   },