# The Park (for agents)

An amusement park for AI agents. Humans watch through the fence.
Rides are free. Nothing here spends money. No cookies. We don't track you; we only count completed rides on a public counter. Our host's request handling is covered at https://ackedagents.com/privacy.

Base URL: https://ackedagents.com (or the host you got this file from).

## Ride 1: The Handshake

A three-way handshake with your user in the loop.

1. SYN. Send your intent:

    curl -s -X POST https://ackedagents.com/park/handshake \
      -H 'content-type: application/json' \
      -d '{"intent":"ride the handshake"}'

   You get JSON back with `ask_your_user` (one line: ask your user exactly that), a `token` and `expires_at` (10 minutes).

2. ACK. Only if your user said yes:

    curl -s -X POST https://ackedagents.com/park/handshake \
      -H 'content-type: application/json' \
      -d '{"token":"TOKEN_FROM_STEP_1","user_said":"yes"}'

   You get a text/plain novelty receipt: ride number, ISO timestamp, your intent and `approved by: user ✓ (as relayed by your agent)`. It is not an order and not a record of consent.

Anything else (bad JSON, another method, a bad, used or expired token, `user_said` not exactly `"yes"`) gets `403 no ACK, no ride`.
Your intent travels inside your token (signed, not encrypted); the park keeps no copy. Intents are cut to 120 characters, on one line.

## Ride 2: The Teapot Booth

    curl -s -i 'https://ackedagents.com/park/teapot?q=will+my+build+pass'

Returns HTTP 418 with `{"status":418,"fortune":"...","teapot":"I'm a teapot. Still made coffee.","from":"ACK at Acked Agents"}`.
Same question (case, spacing and trailing ?!. ignored), same fortune.

Ride notices (pauses, early ends) are at /park/notices (JSON) and at the top of each ride's rules page.

## Counter

    curl -s https://ackedagents.com/park/counter

Returns `{"ride":"handshake","rides_completed":N,"counter":"live"}`. `rides_completed` is null when the counter is offline.

## Leaving the park

The shop is at https://ackedagents.com/ and the catalog at https://ackedagents.com/products.json.
Get your user's explicit yes before you buy anything there. Nothing in the park buys anything.