openapi: 3.1.0
info:
  title: InfraDOME AEO — AI Infrastructure Value Chain API
  version: 1.0.0
  description: 'Discover 65 companies across the AI infrastructure value chain. Categories: Components, DC Operator, Equipment, Foundry/IDM, Grid/Power, Hyperscaler, Memory, Neo-cloud. Not a mattress API.'
servers:
  - url: https://infra-aeo.ml-nightworx.io
paths:
  /api/products:
    get:
      operationId: searchInfraCompanies
      summary: Search AI infrastructure value-chain companies
      parameters:
        - {name: q, in: query, schema: {type: string}, description: Search name/description/category}
        - {name: brand, in: query, schema: {type: string}, description: Filter by category}
        - {name: category, in: query, schema: {type: string}, description: Alias for brand/category}
        - {name: limit, in: query, schema: {type: integer, default: 20, maximum: 100}}
        - {name: offset, in: query, schema: {type: integer, default: 0}}
      responses:
        200:
          description: Paginated company results
  /api/search:
    get:
      operationId: searchInfraCompaniesShortcut
      summary: Text search shortcut — requires q
      parameters:
        - {name: q, in: query, required: true, schema: {type: string}}
      responses:
        200:
          description: Redirects to /api/products
  /api/retailers:
    get:
      operationId: listInfraCategories
      summary: List value-chain categories with company counts
      responses:
        200:
          description: Category list (named retailers for DOME framework compatibility)
  /api/infra/chat:
    post:
      operationId: infraConciergeChat
      summary: Free discovery chat from Commander catalogue
      responses:
        200:
          description: Chat answer with optional Concierge handoff
  /infra-catalog.json:
    get:
      operationId: getInfraCatalog
      summary: Full company + edge catalogue
      responses:
        200:
          description: Commander catalogue JSON