{
  "openapi": "3.1.0",
  "info": {
    "title": "Gold Ranger Ventures — Public Discovery Surface",
    "description": "Read-only HTTP resources for agent discovery on goldranger.xyz. This is not a transactional product API; it exposes studio briefs, usage policy, and machine-readable catalogs.",
    "version": "1.0.0",
    "contact": {
      "name": "Gold Ranger Ventures",
      "email": "hello@goldranger.xyz",
      "url": "https://goldranger.xyz/"
    }
  },
  "servers": [
    {
      "url": "https://goldranger.xyz",
      "description": "Production"
    }
  ],
  "paths": {
    "/": {
      "get": {
        "operationId": "getHomepage",
        "summary": "Studio homepage (HTML or Markdown via content negotiation)",
        "parameters": [
          {
            "name": "Accept",
            "in": "header",
            "schema": {
              "type": "string",
              "enum": ["text/html", "text/markdown", "text/html,text/markdown;q=0.9"]
            },
            "description": "Request text/markdown for a Markdown representation"
          }
        ],
        "responses": {
          "200": {
            "description": "Homepage",
            "content": {
              "text/html": {
                "schema": { "type": "string" }
              },
              "text/markdown": {
                "schema": { "type": "string" }
              }
            }
          }
        }
      }
    },
    "/llms.txt": {
      "get": {
        "operationId": "getLlmsTxt",
        "summary": "Concise LLM-readable studio brief",
        "responses": {
          "200": {
            "description": "Plain-text / markdown brief",
            "content": {
              "text/plain": { "schema": { "type": "string" } },
              "text/markdown": { "schema": { "type": "string" } }
            }
          }
        }
      }
    },
    "/llms-full.txt": {
      "get": {
        "operationId": "getLlmsFullTxt",
        "summary": "Extended LLM-readable studio brief",
        "responses": {
          "200": {
            "description": "Full plain-text / markdown brief",
            "content": {
              "text/plain": { "schema": { "type": "string" } },
              "text/markdown": { "schema": { "type": "string" } }
            }
          }
        }
      }
    },
    "/ai.txt": {
      "get": {
        "operationId": "getAiTxt",
        "summary": "AI crawl and representation guidance",
        "responses": {
          "200": {
            "description": "AI usage policy",
            "content": {
              "text/plain": { "schema": { "type": "string" } }
            }
          }
        }
      }
    },
    "/auth.md": {
      "get": {
        "operationId": "getAuthMd",
        "summary": "Agent auth posture (public site; no registration)",
        "responses": {
          "200": {
            "description": "Auth.md",
            "content": {
              "text/markdown": { "schema": { "type": "string" } }
            }
          }
        }
      }
    },
    "/.well-known/api-catalog": {
      "get": {
        "operationId": "getApiCatalog",
        "summary": "RFC 9727 API catalog (linkset+json)",
        "responses": {
          "200": {
            "description": "Linkset catalog",
            "content": {
              "application/linkset+json": {
                "schema": { "type": "object" }
              }
            }
          }
        }
      }
    },
    "/.well-known/openapi.json": {
      "get": {
        "operationId": "getOpenApi",
        "summary": "This OpenAPI document",
        "responses": {
          "200": {
            "description": "OpenAPI 3.1",
            "content": {
              "application/json": {
                "schema": { "type": "object" }
              }
            }
          }
        }
      }
    },
    "/.well-known/agent-skills/index.json": {
      "get": {
        "operationId": "getAgentSkillsIndex",
        "summary": "Agent Skills discovery index",
        "responses": {
          "200": {
            "description": "Skills index",
            "content": {
              "application/json": {
                "schema": { "type": "object" }
              }
            }
          }
        }
      }
    },
    "/robots.txt": {
      "get": {
        "operationId": "getRobotsTxt",
        "summary": "Crawler directives and Content Signals",
        "responses": {
          "200": {
            "description": "robots.txt",
            "content": {
              "text/plain": { "schema": { "type": "string" } }
            }
          }
        }
      }
    },
    "/sitemap.xml": {
      "get": {
        "operationId": "getSitemap",
        "summary": "XML sitemap",
        "responses": {
          "200": {
            "description": "Sitemap",
            "content": {
              "application/xml": { "schema": { "type": "string" } }
            }
          }
        }
      }
    }
  }
}