@agent-cards/commerce-sdk 0.18.13 → 0.18.15

package/dist/buy-tool.d.ts

@@ -44,6 +44,7 @@ import { type BuyToolModelView } from './model-view.js';
 import { type MessagePace, type MessageStream } from './messages.js';
 import { type ShopperMessage } from './shopper-message.js';
 import { type BuyStoreWait } from './store-wait.js';
+import { type ShopperLocation } from './shopper-location.js';
 /**
  * Where the purchase stands:
  * - `needs_input`: Agentcard asks the shopper something, or shows a cart.
@@ -159,7 +160,7 @@ export interface BuyToolStore {
     linkSent: boolean;
 }
 /** A product the last search found. */
-/** What taking a product does: `reserve` a table, `book` a flight, room, class or ticket, `buy` anything else. */
+/** What taking a product does: `reserve` a table, `book` a flight, room, rental car, class, ticket or event, `buy` anything else. */
 export type BuyToolProductAction = 'buy' | 'reserve' | 'book';
 /** The action a product of `merchant` takes (BuyToolProductAction). */
 export declare function productAction(merchant: string | null | undefined): BuyToolProductAction;
@@ -347,6 +348,8 @@ export interface BuyToolOptions extends BuyStoreWait {
     sendLink?: (link: BuyToolLink) => void | Promise<void>;
     /** Where the orders go, when you already hold the shopper's address. The model never sets it. */
     deliveryAddress?: BuyDeliveryAddress;
+    /** Where the shopper buys from, as your app knows it: sent on every request, so Agentcard knows their country before their first message. */
+    shopperLocation?: ShopperLocation;
     /** With `accessToken`: where Agentcard answers. Default `https://api.agentcard.sh`. */
     baseUrl?: string;
     /** With `accessToken`: the fetch to call Agentcard with. Default: the global fetch. */
@@ -828,9 +831,4 @@ export declare function handedNote(answer: string): string;
 export declare function nextStepPrompt(message: ShopperMessage): string;
 /** Shared with the merchant monitor so link eligibility uses the tool's product mapping. */
 export declare function productsOf(turn: BuyTurn): BuyToolProduct[];
-/**
- * A buy tool for one shopper. With a company client, name the shopper with
- * `externalUserId`; with a shopper's own `accessToken`, the token names them.
- * Throws a TypeError for options that cannot work, before any call.
- */
 export declare function buyTool(options: BuyToolOptions): BuyTool;

package/dist/buy-tool.js

@@ -9,12 +9,15 @@ import { joinLeadIns, leadInJoiner, messageStream, paceOf, paragraphsOf, sleep,
 import { isStale, messageInChat } from './shopper-message.js';
 import { actionLinkId, isActionLink } from './action-links.js';
 import { checkStoreWait, storeWaitFields, withLateCards } from './store-wait.js';
+import { shopperLocationOf } from './shopper-location.js';
 import { ACK_REACTION, ackAt, answersCheckout, answersQuestion, asksForSimilar, holdsBack, instantAck as instantAckOf, isNewRequest, isPickText, keepsYes, namesStore, nextTemplate, readsAsAckLine, slowStepLine } from './ack.js';
+/** The merchants whose products are booked: a seat, a room, a car or an event, never an item shipped. */
+const BOOKED = new Set(['flights', 'hotels', 'cars', 'tickets', 'classes', 'gomry']);
 /** The action a product of `merchant` takes (BuyToolProductAction). */
 export function productAction(merchant) {
     if (merchant === 'reservations')
         return 'reserve';
-    return merchant === 'flights' || merchant === 'hotels' || merchant === 'tickets' || merchant === 'classes' ? 'book' : 'buy';
+    return merchant && BOOKED.has(merchant) ? 'book' : 'buy';
 }
 const isObject = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
 /**
@@ -741,6 +744,13 @@ function endTurn(state) {
  * `externalUserId`; with a shopper's own `accessToken`, the token names them.
  * Throws a TypeError for options that cannot work, before any call.
  */
+/**
+ * The carts as an app shows them, in order: two lists read the same only when they show the same carts at the same price.
+ * The hash alone is not enough, since a store pricing a cart again changes `pricing` and its total under one hash.
+ */
+function cartsKey(carts) {
+    return JSON.stringify(carts.map((c) => [c.hash, c.totalCents, c.pricing === true, c.totalIsEstimate, c.items.map((i) => [i.line_id, i.qty, i.lineTotalCents])]));
+}
 export function buyTool(options) {
     const o = options ?? {};
     if ((o.agentcard === undefined) === (o.accessToken === undefined)) {
@@ -761,6 +771,7 @@ export function buyTool(options) {
         throw new TypeError('Pass threadId as your own id for the chat or thread, 1 to 200 characters, or leave it out.');
     }
     const threadId = o.threadId?.trim();
+    const shopperLocation = shopperLocationOf(o.shopperLocation);
     checkStoreWait(o);
     /** Whether a message is this tool's to read (`messageInChat`): its chat's purchase, or news about the shopper alone. */
     const inThisThread = (message) => messageInChat(message, threadId);
@@ -899,6 +910,9 @@ export function buyTool(options) {
     let declinedNoCart = false;
     /** The conversation and the carts of the last answer, for a `nextStep` call that cannot read the conversation. */
     let lastConversationId = null;
+    /** Calls started, in order, and the newest one whose carts onCart heard: an older call's answer never replaces a newer call's carts. */
+    let callsStarted = 0;
+    let cartsFromCall = 0;
     let lastCarts = [];
     /** The cart the last answer showed: the cart a confirm sent now confirms. */
     let lastShownCart = null;
@@ -1663,11 +1677,19 @@ export function buyTool(options) {
      * from its timing. Every link, answer and instant reply of the call goes to the turn it started in.
      */
     const answerIn = async (raw, explicit) => {
+        const callNo = ++callsStarted;
         const startedAt = Date.now();
         // A step link held for the message that introduces it goes out before this call hands over any of its own.
         explicit?.release?.();
         const withdrawalsAtStart = withdrawals;
-        const input = parseBuyToolInput(raw);
+        const parsedInput = parseBuyToolInput(raw);
+        // A tapped turn's first call that names no product and no store picks the tapped card (TurnState.tapped).
+        const tappedId = explicit?.tapped ?? null;
+        if (explicit)
+            explicit.tapped = null;
+        const input = tappedId && !parsedInput.confirm && !parsedInput.new_order && !parsedInput.product_id && !parsedInput.store_id
+            ? { ...parsedInput, product_id: tappedId }
+            : parsedInput;
         // With carts at more than one store waiting, a new order would drop every one of them: "cancel the
         // reservation, keep the flowers" started a new conversation and lost the flowers cart (2026-10-20).
         // The ask goes to the same purchase instead, and Agentcard drops only the cart it names.
@@ -2103,6 +2125,11 @@ export function buyTool(options) {
                     ...(t.onCart
                         ? {
                             onCart: async ({ cart, carts, conversationId }) => {
+                                // A newer call already handed on its carts: this older stream's are stale, however late they come.
+                                if (callNo < cartsFromCall)
+                                    return;
+                                t.cartsHeard = cartsKey(carts);
+                                cartsFromCall = callNo;
                                 try {
                                     await t.onCart(cart, { carts, conversationId });
                                 }
@@ -2120,6 +2147,8 @@ export function buyTool(options) {
             // Every request names the tool's thread, so Agentcard continues this chat's purchase and no other.
             if (threadId)
                 sent = { ...sent, thread_id: threadId };
+            if (shopperLocation)
+                sent = { ...sent, shopper_location: shopperLocation };
             // Every request names how long the reply waits for stores, and what happens to a store that answers after it.
             sent = { ...sent, ...storeWaitFields(t.storeWait ?? {}, o) };
             if (plan && 'local' in plan) {
@@ -2281,6 +2310,26 @@ export function buyTool(options) {
             if (turn) {
                 lastCartCount = result.carts.length;
                 lastCarts = result.carts;
+                // The answer's carts are the conversation's as they stand, an empty list included: onCart hears them when the stream
+                // sent none or older ones, so an app never keeps showing a cart Agentcard no longer holds (a stream sends a cart only
+                // when a tool changed it, and a call with stream: false sends none).
+                // An answer the stream lost before Agentcard sent it (`turn_timeout`, or another error_code) holds no carts of its own,
+                // so the app keeps the carts it last heard rather than hiding one Agentcard may still hold.
+                const conversationId = result.conversation_id ?? lastConversationId;
+                // A newer call that already handed on carts holds the fresher ones, so this older answer's carts stay unheard.
+                const current = t.onCart && conversationId && !result.error_code && callNo >= cartsFromCall;
+                // A current answer is the newest word on the carts even when they did not change, so an older call stays stale after it.
+                if (current)
+                    cartsFromCall = callNo;
+                if (current && cartsKey(result.carts) !== t.cartsHeard) {
+                    t.cartsHeard = cartsKey(result.carts);
+                    try {
+                        await t.onCart(result.cart ?? null, { carts: result.carts, conversationId: conversationId });
+                    }
+                    catch {
+                        // The app's display failing never fails the call.
+                    }
+                }
                 declinedNoCart = result.status === 'declined' && result.carts.length === 0;
             }
             if (result.conversation_id)
@@ -2619,6 +2668,7 @@ export function buyTool(options) {
         const answered = previousTurn !== null && (previousTurn.results?.length ?? 0) > 0;
         // A tap names its card by the id its link carried, whatever answer showed it: the pick goes straight with that id.
         const tappedId = typeof options?.tapped?.productId === 'string' && options.tapped.productId.trim() ? options.tapped.productId.trim() : null;
+        state.tapped = tappedId;
         // A `nextStep` turn's call is the same whatever the model writes (`stepPlan` reads where the purchase stands), so it goes
         // straight too: with `replyAsWritten`, a step whose answer is a link, such as the approval after a saved card, needs no model.
         const direct = !directOn || running > 0

package/dist/client.d.ts

@@ -16,6 +16,7 @@ import { type BuyFulfilledBy } from './fulfilled-by.js';
 import { type BuyCardSize } from './card-size.js';
 import { type AgentcardListener, type ListenOptions } from './listen.js';
 import { type ShopperMessage } from './shopper-message.js';
+import type { BuyShopperLocation } from './shopper-location.js';
 /** The fetch the client calls: Node 18 and later have one built in. */
 export type FetchLike = (url: string, init: {
     method: string;
@@ -363,6 +364,8 @@ export interface BuyRequest {
     };
     payment_source?: 'vault';
     delivery_address?: BuyDeliveryAddress;
+    /** Where the shopper buys from, as your app knows it. `buyTool({ shopperLocation })` sends it on every request. */
+    shopper_location?: BuyShopperLocation;
     external_user_id?: string;
     user_id?: string;
     /** `false` asks for no line that says what Agentcard is looking for (`onAck`): the shopper already read one. */
@@ -432,6 +435,11 @@ export interface BuyCartLine {
     ref: string | null;
     /** The product's page at its store, as an http or https address, or null when Agentcard sent none. */
     url: string | null;
+    /**
+     * The id `removeCartLine` takes to take this line out of its cart, at any store. Null from an older API, and for a line
+     * Agentcard recorded before it captured the store's product id.
+     */
+    line_id: string | null;
     /** Who sells or books the line, where that is not the store the cart names (`via StubHub`); absent when Agentcard named none. */
     fulfilled_by?: BuyFulfilledBy;
 }
@@ -852,6 +860,14 @@ export declare class AgentcardClient {
     buy(body: BuyRequest, stream?: BuyStreamHandlers): Promise<BuyTurn>;
     /** One read of a conversation: whether a turn is running, the last checkout, the orders it placed, the carts on the table. */
     conversation(conversationId: string, who?: Shopper): Promise<BuyConversation>;
+    /**
+     * Takes one line out of a cart the conversation shows, by the line's `line_id`, at any store, and answers the
+     * conversation as `conversation()` reads it, with the carts as they stand after the remove. A cart left with no line
+     * leaves `carts`. Throws `AgentcardApiError` with `code` `line_not_removable` and the store's reason when the store
+     * cannot take that line out, `line_not_found` for a line the conversation does not show, and `turn_in_progress` while a
+     * turn of the conversation still runs; the cart is then as it was.
+     */
+    removeCartLine(conversationId: string, lineId: string, who?: Shopper): Promise<BuyConversation>;
     /**
      * The Vault link a shopper opens to connect to your company and add a card.
      * Agentcard returns the link it already opened for this shopper while that

package/dist/client.js

@@ -252,6 +252,7 @@ function cartOf(v) {
                 product_id: str(i.product_id),
                 ref: str(i.ref),
                 url: pageUrl(i.url),
+                line_id: str(i.line_id),
                 ...fulfilledByField(i),
             };
         }) : [],
@@ -865,6 +866,22 @@ export class AgentcardClient {
             : who.userId ? `?user_id=${encodeURIComponent(who.userId)}` : '';
         return conversationOf(await this.call('GET', `/buy/conversations/${encodeURIComponent(conversationId)}${query}`, undefined, CALL_TIMEOUT_MS));
     }
+    /**
+     * Takes one line out of a cart the conversation shows, by the line's `line_id`, at any store, and answers the
+     * conversation as `conversation()` reads it, with the carts as they stand after the remove. A cart left with no line
+     * leaves `carts`. Throws `AgentcardApiError` with `code` `line_not_removable` and the store's reason when the store
+     * cannot take that line out, `line_not_found` for a line the conversation does not show, and `turn_in_progress` while a
+     * turn of the conversation still runs; the cart is then as it was.
+     */
+    async removeCartLine(conversationId, lineId, who = {}) {
+        if (!str(conversationId))
+            throw new TypeError('Pass the conversation_id a purchase answer named.');
+        if (!str(lineId))
+            throw new TypeError('Pass the line_id of a cart line the conversation shows.');
+        this.checkShopper(who);
+        const shopper = who.externalUserId ? { external_user_id: who.externalUserId } : who.userId ? { user_id: who.userId } : {};
+        return conversationOf(await this.call('POST', `/buy/conversations/${encodeURIComponent(conversationId)}/cart/remove`, { line_id: lineId, ...shopper }, CALL_TIMEOUT_MS));
+    }
     /**
      * The Vault link a shopper opens to connect to your company and add a card.
      * Agentcard returns the link it already opened for this shopper while that

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 export { verifyAgentcardWebhook, AgentcardSignatureError, type AgentcardSignatureReason, type AgentcardEvent, type VerifyOptions, } from './verify.js';
+export { shopperLocationOf, type ShopperLocation, type ShopperShipTo, type BuyShopperLocation } from './shopper-location.js';
 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 { ORDER_STEPS, updateOrder, arrivalText, type ShopperOrder, type OrderStep, type OrderPathStep, type OrderStepState, type ArrivalTextOptions, } from './order.js';

package/dist/index.js

@@ -1,4 +1,5 @@
 export { verifyAgentcardWebhook, AgentcardSignatureError, } from './verify.js';
+export { shopperLocationOf } from './shopper-location.js';
 export { readPurchaseMessage, } from './message.js';
 export { readShopperMessage, isStale, SHOPPER_EVENT_TYPES, NEXT_STEP_KINDS, } from './shopper-message.js';
 export { ORDER_STEPS, updateOrder, arrivalText, } from './order.js';

package/dist/message.d.ts

@@ -32,6 +32,12 @@ export interface PurchaseFacts {
     merchantName?: string;
     /** The total in the currency's minor unit: 2306 is $23.06. */
     totalCents?: number;
+    /**
+     * On an order whose store sets the final amount at checkout (a retail order): the estimate the shopper approved, in
+     * place of `totalCents` until the store confirms the charge, and the most the store may charge.
+     */
+    estimatedTotalCents?: number;
+    chargeUpToCents?: number;
     /** The three-letter currency code. */
     currency?: string;
     cardBrand?: string;

package/dist/message.js

@@ -21,6 +21,8 @@ const STRING_FACTS = [
 ];
 const NUMBER_FACTS = [
     ['total_cents', 'totalCents'],
+    ['estimated_total_cents', 'estimatedTotalCents'],
+    ['charge_up_to_cents', 'chargeUpToCents'],
     ['nudge_number', 'nudgeNumber'],
 ];
 function readFacts(raw) {

package/dist/model-view.d.ts

@@ -246,11 +246,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 or a place to book, which can have no page, with an id a pick takes. A flight's card
+ * or a flight option, a place to book or any other booking (a hotel, a rental car, an event), 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' | 'availability'>): string | null;
+export declare function productCardKey(product: Pick<BuyToolProduct, 'id' | 'ref' | 'url' | 'flight' | 'availability'> & Partial<Pick<BuyToolProduct, 'action'>>): string | null;
 /**
  * The carts' grand totals, one per currency, summed from each cart's `totalCents`, which already holds its tip, fees and
  * tax: a display string is never parsed. Carts in two currencies are never added together.

package/dist/model-view.js

@@ -184,14 +184,16 @@ 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 or a place to book, which can have no page, with an id a pick takes. A flight's card
+ * or a flight option, a place to book or any other booking (a hotel, a rental car, an event), 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 || product.availability ? pickId(product) : null;
+    // A booking the shopper picks by its id, such as a hotel, a rental car or an event, has no page either: on 2026-11-04 a trip's
+    // hotels and cars reached chat.opencommerce.sh as groups of ids with no card to draw.
+    return product.flight || product.availability || product.action === 'book' || product.action === 'reserve' ? pickId(product) : null;
 }
 /** True when `store`, the domain an answer's `cart_building` names, is the store `cart` is at. */
 function buildingAt(cart, store) {

package/dist/shopper-location.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Where your shopper buys from, as your app knows it: `buyTool({ shopperLocation })` sends it on every request as
+ * `shopper_location`, so Agentcard knows the shopper's country before their first message. Each part is optional, and
+ * Agentcard trusts them in this order: what the shopper says, then `country` or `shipTo`, then addresses Agentcard already
+ * holds for them, their identity check and their phone, and last `ipCountry` and `locale`. With none of it, the shopper reads
+ * as being in the United States.
+ */
+/** A delivery address your app holds for the shopper. Agentcard reads its `country`, or a US ZIP or Canadian postal code. */
+export interface ShopperShipTo {
+    street?: string;
+    city?: string;
+    state?: string;
+    zip?: string;
+    /** ISO 3166-1 alpha-2, such as AU. */
+    country?: string;
+}
+export interface ShopperLocation {
+    /** The country your app holds for the shopper, ISO 3166-1 alpha-2, such as AU. */
+    country?: string;
+    /** The shopper's default delivery address in your app. */
+    shipTo?: ShopperShipTo;
+    /** The country of the shopper's own request to your app, as your server or CDN reads it from their IP address. */
+    ipCountry?: string;
+    /** The shopper's browser language, such as en-AU. */
+    locale?: string;
+}
+/** `shopper_location` as `POST /buy` takes it. */
+export interface BuyShopperLocation {
+    country?: string;
+    ship_to?: ShopperShipTo;
+    ip_country?: string;
+    locale?: string;
+}
+/** The location as `POST /buy` takes it, or undefined when it holds nothing. Throws a TypeError on a country that is not two letters. */
+export declare function shopperLocationOf(location: ShopperLocation | undefined): BuyShopperLocation | undefined;

package/dist/shopper-location.js

@@ -0,0 +1,43 @@
+/**
+ * Where your shopper buys from, as your app knows it: `buyTool({ shopperLocation })` sends it on every request as
+ * `shopper_location`, so Agentcard knows the shopper's country before their first message. Each part is optional, and
+ * Agentcard trusts them in this order: what the shopper says, then `country` or `shipTo`, then addresses Agentcard already
+ * holds for them, their identity check and their phone, and last `ipCountry` and `locale`. With none of it, the shopper reads
+ * as being in the United States.
+ */
+const code = (value, name) => {
+    if (value === undefined)
+        return undefined;
+    if (typeof value !== 'string' || !/^[A-Za-z]{2}$/.test(value.trim())) {
+        throw new TypeError(`Pass ${name} as a two-letter country code, such as AU, or leave it out.`);
+    }
+    return value.trim().toUpperCase();
+};
+/** The location as `POST /buy` takes it, or undefined when it holds nothing. Throws a TypeError on a country that is not two letters. */
+export function shopperLocationOf(location) {
+    if (location === undefined)
+        return undefined;
+    if (location === null || typeof location !== 'object')
+        throw new TypeError('Pass shopperLocation as an object, or leave it out.');
+    const country = code(location.country, 'shopperLocation.country');
+    for (const part of ['street', 'city', 'state', 'zip']) {
+        const value = location.shipTo?.[part];
+        if (value !== undefined && (typeof value !== 'string' || value.length > 200)) {
+            throw new TypeError(`Pass shopperLocation.shipTo.${part} as text of at most 200 characters, or leave it out.`);
+        }
+    }
+    const shipTo = location.shipTo ? { ...location.shipTo, country: code(location.shipTo.country, 'shopperLocation.shipTo.country') } : undefined;
+    if (shipTo && shipTo.country === undefined)
+        delete shipTo.country;
+    const ipCountry = code(location.ipCountry, 'shopperLocation.ipCountry');
+    const locale = location.locale?.trim() || undefined;
+    if (locale && locale.length > 35)
+        throw new TypeError('Pass shopperLocation.locale as a language tag, such as en-AU, or leave it out.');
+    const wire = {
+        ...(country ? { country } : {}),
+        ...(shipTo ? { ship_to: shipTo } : {}),
+        ...(ipCountry ? { ip_country: ipCountry } : {}),
+        ...(locale ? { locale } : {}),
+    };
+    return Object.keys(wire).length > 0 ? wire : undefined;
+}

package/dist/shopper-message.js

@@ -6,6 +6,7 @@
 import { isRecord } from './verify.js';
 import { readPurchaseMessage } from './message.js';
 import { orderFrom, orderStepOf } from './order.js';
+import { money } from './model-view.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.
@@ -103,6 +104,12 @@ function readOrderConfirmed(event) {
     const { data, store, base } = read;
     const retailerOrderId = text(data.retailer_order_id, 80);
     const deliveryWindow = text(data.delivery_window, 80);
+    // What the card was captured for, now that the store has set tax and shipping: the one amount a retail order's messages
+    // name as charged, since the placed message named only the estimate and the ceiling. A confirmation that carries the
+    // store's total and no capture names the total as the store's, never as a charge.
+    const currency = text(data.currency, 8) ?? 'usd';
+    const charged = money(count(data.charged_cents), currency);
+    const total = charged ? null : money(count(data.final_total_cents), currency);
     const facts = present({
         merchantName: store ?? undefined,
         storeName: text(data.store_name, 64),
@@ -122,8 +129,9 @@ function readOrderConfirmed(event) {
         ...base,
         kind: 'order_confirmed',
         advances: false,
-        text: `${who}${retailerOrderId ? `, order number ${retailerOrderId}` : ''}.${deliveryWindow ? ` Expected delivery: ${deliveryWindow}.` : ''}`,
+        text: `${who}${retailerOrderId ? `, order number ${retailerOrderId}` : ''}.${charged ? ` Charged ${charged}.` : total ? ` Total ${total}.` : ''}${deliveryWindow ? ` Expected delivery: ${deliveryWindow}.` : ''}`,
         note: `[event: the store accepted this user's order${store ? ` at ${store}` : ''} on its side, outside this conversation.` +
+            `${charged ? ` The store charged ${charged}, its final amount with tax and shipping.` : total ? ` The store's total is ${total}, with tax and shipping; the charge is not confirmed yet.` : ''}` +
             `${retailerOrderId ? ` The store's order number is ${retailerOrderId}.` : ''}` +
             `${deliveryWindow ? ` The store quotes delivery ${deliveryWindow}.` : ''} ${SYSTEM_LINE}]`,
         facts,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-cards/commerce-sdk",
-  "version": "0.18.13",
+  "version": "0.18.15",
   "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.",
   "homepage": "https://opencommerce.sh",
   "type": "module",