{
  "openapi": "3.1.0",
  "info": {
    "title": "Sizzle Seafood & Chicken - Agentic Commerce Protocol (ACP) API",
    "version": "1.0.0",
    "description": "Standardized autonomous AI agent commerce endpoints for catalog inspection, cart building, tax/tip calculation, and automated order placement."
  },
  "servers": [
    {
      "url": "https://www.sizzleeats.com",
      "description": "Production Sizzle E-Commerce Server"
    },
    {
      "url": "http://localhost:3333",
      "description": "Local Development Server"
    }
  ],
  "paths": {
    "/.well-known/acp.json": {
      "get": {
        "summary": "ACP Merchant Discovery Manifest",
        "responses": {
          "200": {
            "description": "ACP Manifest JSON"
          }
        }
      }
    },
    "/feeds/acp-catalog.json": {
      "get": {
        "summary": "Complete Machine-Readable Product Catalog",
        "responses": {
          "200": {
            "description": "Array of 56 categorized menu items with modifiers and pricing in cents."
          }
        }
      }
    },
    "/api/acp/quote": {
      "post": {
        "summary": "Calculate Quote (Subtotal, State/Local Tax, Fees, Tip & Total)",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "location_id": {
                    "type": "string",
                    "example": "loc-atlanta-101"
                  },
                  "fulfillment_type": {
                    "type": "string",
                    "enum": [
                      "pickup",
                      "curbside",
                      "delivery"
                    ]
                  },
                  "tip_percentage": {
                    "type": "number",
                    "example": 18
                  },
                  "items": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "item_id": {
                          "type": "string",
                          "example": "combo-1"
                        },
                        "quantity": {
                          "type": "integer",
                          "example": 2
                        },
                        "selected_option": {
                          "type": "string",
                          "example": "Steak"
                        }
                      },
                      "required": [
                        "item_id",
                        "quantity"
                      ]
                    }
                  }
                },
                "required": [
                  "location_id",
                  "items"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Order Quote with itemized breakdown and cryptographic quote token."
          }
        }
      }
    },
    "/api/acp/checkout": {
      "post": {
        "summary": "Execute Autonomous Agent Order",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "quote_id": {
                    "type": "string"
                  },
                  "payment_method": {
                    "type": "string",
                    "enum": [
                      "google_pay",
                      "apple_pay",
                      "credit_card",
                      "agent_escrow_token"
                    ]
                  },
                  "customer": {
                    "type": "object",
                    "properties": {
                      "name": {
                        "type": "string"
                      },
                      "phone": {
                        "type": "string"
                      },
                      "email": {
                        "type": "string"
                      }
                    },
                    "required": [
                      "name",
                      "phone"
                    ]
                  },
                  "agent_metadata": {
                    "type": "object",
                    "properties": {
                      "agent_name": {
                        "type": "string",
                        "example": "GoogleAssistant/AutoGPT/Claude"
                      },
                      "agent_id": {
                        "type": "string"
                      }
                    }
                  }
                },
                "required": [
                  "quote_id",
                  "payment_method",
                  "customer"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Order Confirmation with receipt number, pickup PIN, and estimated ready time."
          }
        }
      }
    }
  }
}