{
  "openapi": "3.1.1",
  "info": {
    "title": "CompuArt Public Agent API",
    "version": "1.0.0",
    "summary": "Read-only public storefront discovery endpoints for CompuArt Egypt.",
    "description": "This API describes CompuArt's public read-only agent discovery surface. It does not expose authenticated or transactional operations.",
    "contact": {
      "name": "CompuArt Support",
      "url": "https://compuartstore.com/contact-us/"
    }
  },
  "externalDocs": {
    "description": "Additional public discovery documents",
    "url": "https://compuartstore.com/auth.md"
  },
  "servers": [
    {
      "url": "https://compuartstore.com/",
      "description": "Production storefront"
    }
  ],
  "paths": {
    "/wp-json/compuart-agent/v1/catalog": {
      "get": {
        "operationId": "getPublicCatalogDiscovery",
        "summary": "Get the public catalog discovery document",
        "description": "Returns CompuArt's public read-only discovery metadata for agent clients.",
        "responses": {
          "200": {
            "description": "Public discovery metadata",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CatalogDiscoveryDocument"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "CatalogDiscoveryDocument": {
        "type": "object",
        "required": [
          "site",
          "discovery",
          "support",
          "commerce",
          "policies"
        ],
        "properties": {
          "site": {
            "$ref": "#/components/schemas/SiteInfo"
          },
          "discovery": {
            "$ref": "#/components/schemas/DiscoveryInfo"
          },
          "support": {
            "$ref": "#/components/schemas/SupportInfo"
          },
          "commerce": {
            "$ref": "#/components/schemas/CommerceInfo"
          },
          "policies": {
            "$ref": "#/components/schemas/PolicyInfo"
          }
        }
      },
      "SiteInfo": {
        "type": "object",
        "required": [
          "name",
          "url",
          "description"
        ],
        "properties": {
          "name": {
            "type": "string"
          },
          "url": {
            "type": "string",
            "format": "uri"
          },
          "description": {
            "type": "string"
          }
        }
      },
      "DiscoveryInfo": {
        "type": "object",
        "required": [
          "agent_card",
          "mcp_card",
          "mcp_server_card",
          "a2a_agent_card",
          "agent_skills",
          "auth_md",
          "catalog_api",
          "api_catalog",
          "openapi_url"
        ],
        "properties": {
          "agent_card": {
            "type": "string",
            "format": "uri"
          },
          "mcp_card": {
            "type": "string",
            "format": "uri"
          },
          "mcp_server_card": {
            "type": "string",
            "format": "uri"
          },
          "a2a_agent_card": {
            "type": "string",
            "format": "uri"
          },
          "agent_skills": {
            "type": "string",
            "format": "uri"
          },
          "auth_md": {
            "type": "string",
            "format": "uri"
          },
          "catalog_api": {
            "type": "string",
            "format": "uri"
          },
          "api_catalog": {
            "type": "string",
            "format": "uri"
          },
          "openapi_url": {
            "type": "string",
            "format": "uri"
          }
        }
      },
      "SupportInfo": {
        "type": "object",
        "required": [
          "support_url",
          "contact_url",
          "warranty_url",
          "shipping_url",
          "returns_url",
          "faq_url",
          "privacy_policy_url",
          "terms_url"
        ],
        "properties": {
          "support_url": {
            "type": "string",
            "format": "uri"
          },
          "contact_url": {
            "type": "string",
            "format": "uri"
          },
          "warranty_url": {
            "type": "string",
            "format": "uri"
          },
          "shipping_url": {
            "type": "string",
            "format": "uri"
          },
          "returns_url": {
            "type": "string",
            "format": "uri"
          },
          "faq_url": {
            "type": "string",
            "format": "uri"
          },
          "privacy_policy_url": {
            "type": "string",
            "format": "uri"
          },
          "terms_url": {
            "type": "string",
            "format": "uri"
          }
        }
      },
      "CommerceInfo": {
        "type": "object",
        "required": [
          "currency",
          "cart_url",
          "checkout_url"
        ],
        "properties": {
          "currency": {
            "type": "string",
            "enum": [
              "EGP"
            ]
          },
          "cart_url": {
            "type": "string",
            "format": "uri"
          },
          "checkout_url": {
            "type": "string",
            "format": "uri"
          }
        }
      },
      "PolicyInfo": {
        "type": "object",
        "required": [
          "public_read_only",
          "authenticated_actions_supported",
          "markdown_negotiation"
        ],
        "properties": {
          "public_read_only": {
            "type": "boolean"
          },
          "authenticated_actions_supported": {
            "type": "boolean"
          },
          "markdown_negotiation": {
            "type": "boolean"
          }
        }
      }
    }
  }
}