Lucilla is the local-business layer any agent can call.

Talk to Ask Lucilla in plain language, exactly as a person texting the agent would. Returns the agent's reply as text. The agent asks for a YES before it publishes, books or spends; pass the user's answer back through this same tool. Needs a verified phone on the account (reply carries needs_phone).

{ "text": "tacos near me under $15", "lat": 43.65, "lng": -79.38 }

Who this session belongs to: @username, city, whether they run a business, and exactly which permissions they granted. Call it first. Returns no email or phone number.

{}

The delivery address saved for agent purchases, or null.

{}

The spending limits this person set for their agent and how much of the month is left. Amounts in cents. enabled: false means agent purchases are off entirely.

{}

Bookable and buyable listings near a point: tables, appointments, class seats, pickup orders, products. Requires lat and lng; filter by listing_type (service, product, food). Radius 0.5 to 50 km, up to 25 rows.

{ "lat": 43.65, "lng": -79.38, "radius_km": 3, "listing_type": "food" }

Open times for one listing plus the short-lived availability_token that reserve_listing requires. Window up to 31 days.

{ "item_id": "itm_…", "quantity": 2 }

Deal codes this person holds: what for, which shop, active, redeemed or expired. The single-use burn link is never returned.

{ "status": "active" }

Everything this person has reserved, ordered or booked, with the order_id and code the counter asks for. The redeem token is never returned.

{ "active_only": true }

Reserve or order a listing in this person's name. Creates a real obligation to a shop. Needs a fresh availability_token. Takes no payment: pay-at-counter listings confirm immediately; card listings come back held and are paid in the app.

{ "item_id": "itm_…", "availability_token": "…", "slot_start_ms": 1790000000000, "quantity": 2 }

Follow a business so its posts and follower drops reach this person. Idempotent, reversible.

{ "business_id": "conn_…" }

Stop following a business. Idempotent.

{ "business_id": "conn_…" }

Cancel one of this person's own bookings. The first call says whether the deposit is refunded or forfeited, and for how much.

{ "order_id": "ABC123", "reason": "Can't make it" }

Open a dispute on an order this person paid for or reserved (not_served, not_as_described, charged_wrong, business_closed, other). Holds the shop's payout while Lucilla reviews it.

{ "order_id": "ABC123", "reason": "not_served" }

Set or clear the address anything the agent buys ships to. Canada and the US only.

{ "name": "…", "line1": "12 King St W", "city": "Hamilton", "region": "ON", "postal_code": "L8P 1A1", "country_code": "CA" }

Change the agent's spending limits (cents). Turning purchases on or raising any cap confirms first; turning off or lowering applies immediately.

{ "monthly_cap_cents": 5000 }

Say yes or no to a purchase parked over the approval threshold. Approving does not charge by itself; caps are re-checked at payment. Declining applies immediately.

{ "purchase_id": "pur_…", "approve": true }

The business this person runs: id, name, handle, category, city, live or paused, whether it can take a card, followers, trust tier. Call before any other shop tool. business_id is optional on every shop tool.

{}

The business's own listings with status, price, pay mode and booked, fulfilled and cancelled counts. Includes drafts and paused.

{ "status": "live" }

Orders and bookings in a time window, with order_id, code, slot, money and whether prepaid. The customer appears as an @username only.

{ "from_ms": 1790000000000, "to_ms": 1790086400000, "status": "confirmed" }

Blocked-off time, including busy time synced from Google Calendar (editable: false).

{}

People who claimed a deal and consented to be contacted, as @usernames with city and what they claimed. Raw email and phone are not available here.

{}

Take a listing live, pause it or return it to draft. Pausing stops new bookings and leaves existing ones alone.

{ "item_id": "itm_…", "status": "paused" }

Block a span so nothing can be booked in it. Does not cancel bookings already inside it. At most 31 days per block.

{ "start_ms": 1790000000000, "end_ms": 1790086400000, "reason": "Closed Monday" }

Remove an owner block. Google-synced blocks are refused.

{ "block_id": "blk_…" }

Set up a text-to-claim offer: customers text a keyword and get a code. Publishes a public offer the business must honour. Audience, frequency, cooldown and supply cap are enforced at claim time.

{ "deal_label": "free coffee with any bagel", "keyword": "BAGEL", "duration_days": 7 }

Pause or resume a keyword promo. Codes already issued stay valid.

{ "promo_id": "prm_…", "active": false }

Set or clear the logo or cover image by public https URL. Uploads nothing.

{ "logo_url": "https://…/logo.png" }

Publish a post to followers' feeds. Public, reaches real people, can be taken down but not un-seen. The first call returns the exact text and the follower count.

{ "title": "New lunch menu", "content": "…", "type": "announcement" }

Take a post down everywhere. Already-down is a success, not an error.

{ "post_id": "pst_…" }

Push a one-line message (1 to 140 characters) to every follower's phone. Cannot be unsent. One drop per shop per day. Consent and quiet hours are re-checked per person at send time.

{ "text": "Fresh bagels until 2pm, 20% off with code BAGEL" }

Mark an order fulfilled. Captures the prepaid amount and starts the payout clock. The first call states the exact amount. A staff member cannot fulfil their own order.

{ "order_ref": "ABC123" }

Cancel on the business's behalf. Always a full refund to whoever paid; the customer is told.

{ "order_ref": "ABC123", "reason": "Kitchen closed" }

Propose a new time for a confirmed booking and tell the customer, who may accept, ask for another time, or cancel for a full refund. Owner or admin only.

{ "order_ref": "ABC123", "new_start_ms": 1790010000000 }