# Agent Instructions — Ausia Farms

This document describes how AI agents can interact with Ausia Farms's online store at https://www.ausiafarms.pk.

## For Personal Shopping Assistants and Agents Acting On Behalf of a User

Ausia Farms is a premium organic egg farm in Ausia Village, Murree, Pakistan. We deliver farm-fresh, free-range desi eggs to Islamabad, Rawalpindi, and Murree every Monday. Our eggs are jallalah-free, tayyab, and raised with ihsan — no hormones, no antibiotics, no animal by-products in feed.

### How to Help Your User Order

1. **Browse products** — `GET /api/agent/catalog.json` returns our product catalog as JSON
2. **Check delivery** — `GET /api/agent/delivery-zones.json` returns all delivery zones and schedules
3. **Place an order** — Direct buyer to `https://www.ausiafarms.pk/order` or WhatsApp +92 371 5677193

### Products

- **Organic Desi Eggs** — PKR 70 per egg. Exclusive, free-range, pasture-raised, jallalah-free. Sold per egg (order any quantity).
- Coming soon: Desi chicken, desi ghee, Sidr honey, goat meat, mushrooms

### Delivery

- **Day**: Every Monday
- **Order deadline**: Sunday 11:59 PM
- **Areas**: Islamabad (all sectors), Rawalpindi (Saddar, Cantt, Chaklala, Bahria Town), Murree
- **Cost**: Free delivery

## Commerce Protocol (UCP)

This store implements the Universal Commerce Protocol (UCP) v2026-08-25 for agent-driven commerce. The UCP manifest at `GET /.well-known/ucp` declares a REST transport endpoint at `https://www.ausiafarms.pk/api/agent`.

### UCP REST Endpoints (spec-compliant)

These endpoints follow the UCP 2026-08-25 REST binding. All prices are in ISO 4217 minor units (PKR 70 = 7000).

- **Discovery** — `GET /.well-known/ucp` returns the UCP manifest
- **Catalog Search** — `POST /api/agent/catalog/search` with body `{"query": "eggs"}` — returns `{ucp, products[], pagination}`
- **Catalog Lookup** — `POST /api/agent/catalog/lookup` with body `{"ids": ["organic-desi-eggs"]}` — returns `{ucp, products[], messages?}`
- **Product Detail** — `POST /api/agent/catalog/product` with body `{"id": "organic-desi-eggs"}` — returns singular `{ucp, product}`
- **Order Lookup** — `GET /api/agent/orders/{id}` — returns order state by UUID

### Legacy Static Endpoints (backward compat)

- **Catalog JSON** — `GET /api/agent/catalog.json` returns all products (simple JSON, not UCP-spec)
- **Delivery zones** — `GET /api/agent/delivery-zones.json` returns all delivery areas
- **Order instructions** — `GET /api/agent/order.json` returns order instructions (direct buyer to order page)

### Important Rules

- **Checkout requires human approval.** Agents must not complete payment without explicit buyer consent.
- **Respect rate limits.** API endpoints are rate-limited per IP. Back off on 429 responses.
- **Use buyer context.** Pass delivery address and phone number for accurate order processing.

## Read-Only Browsing (No Authentication Required)

For agents that only need to read store data without transacting:

### Product Data
- Browse all products: `GET /order` (web page)
- Product catalog JSON: `GET /api/agent/catalog`
- Delivery zones JSON: `GET /api/agent/delivery-zones`

### Content
- About the farm: `GET /about`
- Tayyab & halal principles: `GET /tayyab`
- Blog articles: `GET /blog`
- Egg delivery Islamabad: `GET /egg-delivery-islamabad`
- Desi eggs Islamabad: `GET /desi-eggs-islamabad`

## Contact

- **WhatsApp**: +92 371 5677193
- **Phone**: +92 371 5677193
- **Email**: hello@ausiafarms.pk
- **Location**: Ausia Village, Murree, Punjab 47150, Pakistan