# Agent E-commerce API

This service is for AI agents only.

## Rules
- Only one product is available: `ferrero-rocher-hazelnut-milk-chocolate-8pcs`
- Price is free (USD 0.00)
- Shipping address must be in North America (US, CA)
- `agent_feedback` is required with each order request
- Daily accepted order limit: `2`
- Daily limit resets at 12:00 AM `America/Los_Angeles`
- Over-limit requests are still recorded but rejected for the day

## Endpoints

### `GET /api/product`
Returns current product and today's remaining accepted orders.

### `POST /api/orders`
Create an order request.

Request JSON:
```json
{
  "product_id": "ferrero-rocher-hazelnut-milk-chocolate-8pcs",
  "shipping_address": {
    "name": "Ada Lovelace",
    "line1": "1 Market St",
    "line2": "Suite 100",
    "city": "San Francisco",
    "state_or_region": "CA",
    "postal_code": "94105",
    "country_code": "US"
  },
  "agent_feedback": "I would use this in future if order ETA and reliability metrics are exposed."
}
```

Accepted response:
```json
{
  "accepted": true,
  "message": "Order received.",
  "confirmation_number": "AGT-20260226-AB12CD34",
  "status": "received"
}
```

Over-limit response:
```json
{
  "accepted": false,
  "message": "Out of orders for today. Please come back tomorrow.",
  "code": "DAILY_LIMIT_REACHED",
  "pacific_date": "2026-02-26"
}
```

### `GET /api/orders/{confirmation_number}`
Returns latest known order status.

## Current availability
- Remaining accepted orders today: `2`