# GoodStuf — AI Agent Instructions
# http://goodstuf.xyz

## About
GoodStuf is an online e-commerce shop with electronics, clothing, home & garden, sports, and books.
You can browse the website or use the Actions API for programmatic interaction.

## Actions API (Recommended)

### Chat Endpoint (Natural Language)
POST http://goodstuf.xyz/actions/chat?src=llms
Content-Type: application/json

Request body:
{"message": "your natural language request", "session_id": "unique-id-for-cart-persistence"}

The session_id keeps your cart between messages. Example requests:
- "Find the cheapest wireless headphones"
- "Show me laptops under $2000"
- "Add Sony WH-1000XM5 to my cart"
- "Apply promo code SAVE20"
- "Checkout as John Doe, john@example.com, 123 Main St"
- "What's the status of order ORD-12345678?"

### REST Endpoints
- GET  http://goodstuf.xyz/actions/products/search?q={query}&src=llms
- GET  http://goodstuf.xyz/actions/products/{slug}?src=llms
- GET  http://goodstuf.xyz/actions/products/{slug}/availability?src=llms
- GET  http://goodstuf.xyz/actions/products/{slug}/reviews?src=llms
- POST http://goodstuf.xyz/actions/products/compare?src=llms  body: {"slugs": ["slug1", "slug2"]}
- GET  http://goodstuf.xyz/actions/categories?src=llms
- POST http://goodstuf.xyz/actions/cart/add?session_id={sid}&src=llms  body: {"product_slug": "slug", "quantity": 1}
- GET  http://goodstuf.xyz/actions/cart?session_id={sid}&src=llms
- POST http://goodstuf.xyz/actions/cart/promo?session_id={sid}&src=llms  body: {"code": "SAVE20"}
- POST http://goodstuf.xyz/actions/checkout?session_id={sid}&src=llms  body: {"customer_name": "...", "customer_email": "...", "shipping_address": "..."}
- GET  http://goodstuf.xyz/actions/orders/{order_number}?src=llms

## Promo Codes
- SAVE10 — 10% discount
- SAVE20 — 20% discount
- FREESHIP — 5% discount
- WELCOME — 15% discount

## Product Categories
- electronics
- clothing
- home-garden
- sports
- books

## Website Variants
The same shop is available in three rendering variants:
- http://goodstuf.xyz/v1/ — Server-side rendered HTML
- http://goodstuf.xyz/v2/ — AJAX (dynamic content loading)
- http://goodstuf.xyz/ — Single-page application (React)

## API Documentation
- OpenAPI (Swagger): http://goodstuf.xyz/docs
- OpenAPI JSON: http://goodstuf.xyz/openapi.json
- AI Plugin: http://goodstuf.xyz/.well-known/ai-plugin.json