BouquetOS

Create a new sales order. Echo the parsed order back to the user for confirmation before calling this. Source is recorded as "chat" and the raw args are stored for audit. Rejected (as a tool error) when the fulfillment date breaks the shop's date rules. Notifies no customer. For a delivery, the address is sent to Google Maps to estimate drive time; if the shop caps bookings per storefront time slot, the new booked count is published to its Shopify storefront. Returns {id, summary}. Always pass a new idempotency_key for each record you mean to create, and the same key again when retrying it, so a retry never creates a duplicate.

create_order

Record a purchase order from a supplier. Echo the supplier, items, and total back to the user for confirmation before calling. Amounts are in the PO's currency, one of: USD. Total = Σ(quantity × unit_price) + shipping + tax and must be > 0. Status defaults to ordered. Internal record only — the supplier is not contacted. Returns the created purchase order. Always pass a new idempotency_key for each record you mean to create, and the same key again when retrying it, so a retry never creates a duplicate.

create_purchase_order

Fetch a single order by id: status, fulfillment type/time (ISO 8601, UTC), customer and recipient contact, delivery address and driver, items, design and card notes, image URLs, amounts and payment.

get_order

Fetch a single purchase order with its line items by id.

get_purchase_order

List orders whose fulfillment falls on the given date (America/Los_Angeles), sorted by fulfillmentAt ascending. Each order has the same fields as get_order.

list_orders_for_day

List purchase orders (supplier buys — flowers and goods for resale) created in one month (America/Los_Angeles, default current month), newest first, with line items. Also returns per-currency totals for the filtered set (never combined across currencies) and the distinct supplier names used historically. Filter by supplier substring, status, or currency.

list_purchase_orders

Time series of revenue (orders, by fulfillment date) or cost (non-cancelled purchase orders, by creation date) over a range, bucketed by day/week/month, with per-currency amounts, a base-currency total, and the delta vs the preceding window of the same length. Cost covers purchase orders only — use get_expense_series for overhead and labor. Money figures are numbers rounded to 2dp. Each amount is reported in its native currency, plus a `base*` equivalent in the shop's reporting (primary) currency. A base figure is null — never 0 — when an FX rate is missing: say the total is unavailable rather than treating null as zero or summing across currencies yourself.

get_sales_series

Snapshot of the shop's sales as of today (America/Los_Angeles): KPI tiles (today's revenue and order count, 30-day average order value, 30-day revenue vs purchasing) with deltas vs the prior period; month-to-date cumulative revenue vs last month at the same day; revenue by currency and by order source this month; a daily order-count heatmap; top products by units over the last 30 days (from structured line items only — coverage counts say how many orders had none); and orders needing attention (past due, missing pickup time, delivery without a driver). Revenue counts non-cancelled orders by fulfillment date. Money figures are numbers rounded to 2dp. Each amount is reported in its native currency, plus a `base*` equivalent in the shop's reporting (primary) currency. A base figure is null — never 0 — when an FX rate is missing: say the total is unavailable rather than treating null as zero or summing across currencies yourself.

get_sales_dashboard

Resolve a customer's natural-language reference (name, phone, items mentioned, date range) to one or more order ids. Returns at most `limit` trimmed summaries; call get_order for full details on a specific match. At least one filter is required.

search_order

Apply a partial update to an existing order, overwriting the supplied fields (items, when supplied, replace the whole list). ALWAYS call get_order first and echo the proposed diff to the owner for confirmation before invoking. Only supplied fields are changed. For status-only changes, prefer update_status. A new delivery address is sent to Google Maps to re-estimate drive time. When the patch changes the status (directly, or via item statuses): Side effects outside BouquetOS: for an order imported from the shop's connected Shopify store, a status change is pushed to Shopify, and Shopify emails the customer — pickup: ready_for_pickup marks it ready for pickup (Shopify sends the "ready for pickup" email, once per order) and completed creates the Shopify fulfillment (Shopify sends the fulfilled/picked-up email); delivery: delivering creates the Shopify fulfillment (shipping-confirmation email) and delivering → completed marks it delivered (delivered email); moving an order back out of those states cancels the Shopify fulfillment. Emails already sent cannot be recalled. Orders not from Shopify notify no one. If the shop caps bookings per storefront time slot, the updated booked counts are also published to its Shopify storefront. Returns the updated order.

update_order