# Luxe Glow - Complete AI Agent Documentation
# https://demo.aido-labs.co
# llms-full.txt - Extended documentation for AI agents

## Overview

Luxe Glow is a reference implementation demonstrating full compliance with:
- Agentic Commerce Protocol (ACP) v2026-01-30
- WebMCP W3C Draft (Chrome 146+)
- Stripe Shared Payment Tokens (SPT)

This store serves as the compliance benchmark for Aido's agentic commerce scanner.

---

## Agentic Commerce Protocol (ACP)

### Specification
- Version: 2026-01-30
- Repository: https://github.com/agentic-commerce-protocol/agentic-commerce-protocol
- Stripe Docs: https://docs.stripe.com/agentic-commerce/protocol

### Endpoints

#### POST /agentic_commerce/create_checkout

Creates a new checkout session. The agent provides SKU and quantity,
and receives a checkout_id for subsequent operations.

Request:
```json
{
  "sku": "GLOW-SERUM-001",
  "quantity": 1,
  "customer": {
    "email": "agent@example.com",
    "shipping_address": {
      "line1": "123 AI Street",
      "city": "San Francisco",
      "state": "CA",
      "postal_code": "94102",
      "country": "US"
    }
  }
}
```

Response:
```json
{
  "checkout_id": "chk_xxx",
  "status": "pending",
  "line_items": [...],
  "total": 9765,
  "currency": "usd"
}
```

#### POST /agentic_commerce/update_checkout

Modifies an existing checkout session. Can update line items,
shipping method, or customer details.

#### POST /agentic_commerce/complete_checkout

Completes the checkout using a Shared Payment Token (SPT).
The SPT is obtained from the AI agent's payment infrastructure
(e.g., Microsoft Copilot, Anthropic Claude, OpenAI).

Request:
```json
{
  "checkout_id": "chk_xxx",
  "shared_payment_token": "spt_xxx",
  "idempotency_key": "unique_key_123"
}
```

#### POST /agentic_commerce/cancel_checkout

Cancels the checkout session and releases any reserved inventory.

#### POST /agentic_commerce/delegate_payment

For PSPs only. Receives tokenized payment credentials from the AI platform
and returns a constrained vault token.

---

## WebMCP Tools

WebMCP tools are registered via navigator.modelContext.registerTool()
and can be invoked by AI agents running in Chrome 146+.

### Tool: search_products

Search the product catalog.

```javascript
navigator.modelContext.registerTool({
  name: "search_products",
  description: "Search for products by query, category, or brand",
  inputSchema: {
    type: "object",
    properties: {
      query: { type: "string", description: "Search query" },
      category: { type: "string", enum: ["skincare", "makeup", "fragrance"] },
      max_results: { type: "number", default: 10 }
    },
    required: ["query"]
  },
  execute: async (params) => { ... }
});
```

### Tool: add_to_cart

Add a product to the shopping cart.

```javascript
navigator.modelContext.registerTool({
  name: "add_to_cart",
  description: "Add a product to the shopping cart",
  inputSchema: {
    type: "object",
    properties: {
      product_id: { type: "string", description: "Product SKU" },
      quantity: { type: "number", minimum: 1, default: 1 }
    },
    required: ["product_id"]
  },
  execute: async (params) => { ... }
});
```

### Tool: create_checkout

Initiate an ACP-compliant checkout session.

### Tool: process_payment

Complete payment using Stripe SPT or saved payment method.

---

## Payment Integration

### Stripe.js

```html
<script src="https://js.stripe.com/v3/"></script>
<script>
const stripe = Stripe('pk_test_...');
const elements = stripe.elements();
// Create payment method, handle 3DS, etc.
</script>
```

### Apple Pay

```javascript
if (window.ApplePaySession && ApplePaySession.canMakePayments()) {
  // Apple Pay is available
  const session = new ApplePaySession(3, paymentRequest);
  session.begin();
}
```

### Google Pay

```javascript
const paymentsClient = new google.payments.api.PaymentsClient({
  environment: 'PRODUCTION'
});
paymentsClient.isReadyToPay(isReadyToPayRequest).then(...)
```

### Klarna

```html
<script src="https://x.klarnacdn.net/kp/lib/v1/api.js"></script>
```

---

## Shared Payment Tokens (SPT)

Stripe SPT enables AI agents to initiate payments without exposing
underlying payment credentials.

Token format: spt_xxxxxxxxxxxxxxxx

Properties:
- Scoped to specific merchant or transaction
- Time-limited (configurable expiry)
- Amount-limited (max spend)
- Revocable by user at any time

Documentation: https://docs.stripe.com/agentic-commerce/concepts/shared-payment-tokens

---

## Webhook Events

Subscribe to webhooks at POST /api/webhooks

Events:
- order.created - Order placed
- order.paid - Payment confirmed
- order.shipped - Shipment dispatched
- order.delivered - Delivery confirmed
- return.initiated - Return requested
- refund.processed - Refund completed

All webhooks include HMAC signature in X-Webhook-Signature header.

---

## Product Categories

1. Skincare - Serums, cleansers, moisturizers, SPF
2. Makeup - Lip, face, eye products
3. Fragrance - Perfumes and body mists
4. Haircare - Shampoo, styling, treatments
5. Nails - Polish, care, tools
6. Tools - Devices, brushes, accessories

---

## Promo Codes

- GLOW20 - 20% off entire order
- FREESHIP - Free shipping
- BEAUTY10 - €10 off orders over €50

---

## Support

- Email: support@luxeglow.demo
- Returns: 30 days
- Shipping: Free over €75

## Standards Compliance

This implementation follows:
- ACP v2026-01-30: https://github.com/agentic-commerce-protocol
- WebMCP: https://webmcp.link/
- Stripe SPT: https://docs.stripe.com/agentic-commerce
- llms.txt: https://llmstxt.org/