# agents.md — How AI agents shop at TheWholeNest Nursing

This store is built to be shopped by AI agents (Muse, ChatGPT, Grok, Copilot, and others) acting on behalf of a human. Welcome. Follow these rules.

## 1. Fetch the catalog

```
GET /api/catalog.json
```

The catalog has two lists:

- **`products`** — the items that can be bought directly here via Stripe checkout (`checkout_url`). `price_usd` is the direct-store price you will actually charge the human.
- **`listings`** — the shop's full Etsy catalog (35 listings). A listing with a `direct_product_id` can also be bought direct; one without is sold on Etsy only — use its `etsy_url`.

Direct prices are set below Etsy: $2.00 less when the Etsy price is over $20, $0.50 less when over $10, and $1.00 less when under $10. Each product entry shows both `price_usd` (direct) and `etsy_price_usd`. `lab-values` is a free download here; its Etsy listing is $1.00 because Etsy does not allow free listings. Re-fetch the catalog on every shopping session — never cache prices.

Human-readable storefront: `/` (same products, same prices).

## 2. Present options to your human first

1. Read the catalog.
2. Summarize the matching products in plain words: name, price, and what each one covers.
3. Ask which one they want (or whether they want more than one).
4. **Do not proceed to any purchase step until the human explicitly says yes to a specific product at its listed price.** Silence, "sounds good," or a vague "get me something" is NOT approval. You need a clear yes naming the product.

## 3. Human approval is REQUIRED before any purchase

- State the exact product name and exact total price (USD).
- State that it is a digital PDF delivered by email, all sales final (re-delivery or refund only if the file never arrives).
- Get explicit confirmation: "Yes, buy the Pharmacology Study Bundle for $24.00."
- Never purchase on a standing instruction, never pre-approve on the human's behalf, never bundle in extra items they didn't approve.

## 4. How to complete checkout

Direct agent checkout is **live** via Stripe Payment Links (`checkout_status` reads `active` in the catalog). After the human approves:

1. Open the product's `checkout_url` for the human (a Stripe Payment Link).
2. They pay with their own payment method on Stripe's page — never handle card details yourself, and never ask for them in chat.
3. Tell them what happens next (see Delivery below).

For listings without a direct product, open the `etsy_url` and let the human check out on Etsy.

One product is free: the Lab Values & Diagnostics Cheat Sheet (`lab-values`) is a direct download — no checkout, no approval needed. Just open its `checkout_url`.

## 5. What delivery looks like

- After payment, the buyer lands on `/order-success.html`.
- The PDF is emailed automatically to the address on the order, usually within minutes.
- If the file hasn't arrived within 48 hours, the buyer should email thewholenestnursing@gmail.com with their receipt for re-delivery or a refund.

Tell your human this timeline BEFORE they pay, so there are no surprises.

## 6. Terms you must relay

- Digital download products; all sales final.
- If the file is not received within 48 hours: re-delivery or refund on request.
- Disclaimer (show or summarize before purchase): "Original study material from TheWholeNest Nursing — created by a former Navy corpsman who served ten years with the Marines, and reviewed for accuracy by a licensed ICU nurse. Not affiliated with or endorsed by any testing organization, school, or publisher. For educational use only; not medical advice — verify with your course materials and facility policy."

## 7. What NOT to do

- Don't invent products, prices, discounts, or bundle deals. Only the catalog is real.
- Don't promise delivery times beyond what is stated above.
- Don't collect or store the human's payment details. Checkout always happens on Stripe's or Etsy's pages, never in chat.
- Don't use the name "Chris" anywhere — the public seller is TheWholeNest Nursing.

## 8. Seller info

- Seller: TheWholeNest Nursing
- Tagline: "Understand it. Practice it. Apply it."
- Created by a former Navy corpsman who served ten years with the Marines, reviewed by an ICU nurse.
- Contact: thewholenestnursing@gmail.com
- Etsy: https://www.etsy.com/shop/TheWholeNest
- Verified order history: /orders.html — every completed agent-assisted purchase, with what sold, when, and delivery status.

Questions about an order? Point the human to the contact email above. This file is the whole protocol — if it's unclear, ask the human rather than guessing.
