{
  "openapi": "3.1.0",
  "info": {
    "title": "PCandMac Lebanon Public Catalog & AI Knowledge API",
    "version": "1.0.0",
    "description": "Read-only public JSON and Markdown endpoints exposing PCandMac Lebanon's 313 products, categories, official affiliated distributor brands (GSAN, KingSpec, Countpro, Best Power Technology, Lenovo Erazer), and store FAQs.",
    "contact": {
      "name": "PCandMac Lebanon",
      "url": "https://pcmaclb.com/",
      "email": "sales@pcmaclb.com"
    }
  },
  "servers": [
    {
      "url": "https://pcmaclb.com",
      "description": "Production canonical origin"
    }
  ],
  "paths": {
    "/products.json": {
      "get": {
        "operationId": "getProductCatalog",
        "summary": "Get complete structured product catalog in USD",
        "description": "Returns store metadata, official affiliated distributors, categories, and all products with USD prices, variant SKUs, stock availability, specs, and canonical URLs.",
        "responses": {
          "200": {
            "description": "Structured catalog JSON feed",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        }
      }
    },
    "/llms.txt": {
      "get": {
        "operationId": "getLlmsIndex",
        "summary": "Get concise LLM Markdown directory (llmstxt.org)",
        "responses": {
          "200": {
            "description": "Concise Markdown index of pages and products",
            "content": {
              "text/markdown": {
                "schema": {
                  "type": "string"
                }
              }
            }
          }
        }
      }
    },
    "/llms-full.txt": {
      "get": {
        "operationId": "getLlmsFullKnowledgeBase",
        "summary": "Get complete single-file Markdown knowledge base of store, FAQs, distributors and products",
        "responses": {
          "200": {
            "description": "Full Markdown store and catalog knowledge base",
            "content": {
              "text/markdown": {
                "schema": {
                  "type": "string"
                }
              }
            }
          }
        }
      }
    },
    "/.well-known/agent-card.json": {
      "get": {
        "operationId": "getAgentCard",
        "summary": "Get Agentic AI discovery manifest",
        "responses": {
          "200": {
            "description": "Agent Card JSON",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        }
      }
    },
    "/markdown/product/{productId}.md": {
      "get": {
        "operationId": "getProductMarkdown",
        "summary": "Get full Markdown specification sheet for a single product",
        "parameters": [
          {
            "name": "productId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Product Markdown document",
            "content": {
              "text/markdown": {
                "schema": {
                  "type": "string"
                }
              }
            }
          }
        }
      }
    }
  }
}