# StageHop — Open Commerce Protocol

## About

StageHop is an independent live-event ticketing platform. Every show is exposed
through OCP so agents can search, reserve, and (with human approval) buy tickets.

## Modeling choice

Each event has three tiers — **general**, **premium**, **vip**. Each tier is exposed
as its own OCP product with id `<event-id>:<tier>`. Agents search by artist,
city, or date and see per-tier stock.

## Tools

- **search_products** — q, city, starts_after, starts_before, tier, max_price, limit
- **get_product** — full details for `<event-id>:<tier>`
- **check_availability** — returns per-tier live remaining stock (minus current holds)
- **add_to_cart** — places an **8-minute hold** on `quantity` tickets
- **get_cart / update_cart** — standard
- **begin_checkout** — non-refundable. **Requires human approval.**

## Tips for agents

- Tickets are **non-refundable**. Always get explicit human confirmation.
- Max **6 tickets per order**.
- Hold expires after 8 minutes — re-check availability before offering to the human.
- Age restrictions (18+, 21+) are in `attributes.age_restriction` — surface them.