{
  "openapi": "3.0.3",
  "info": {
    "title": "Sovnik public web — discovery",
    "version": "1.0.0",
    "description": "Read-only HTTP resources for site structure and agent discovery. Sovnik is primarily a client application; there is no authenticated third-party HTTP API for app data."
  },
  "servers": [
    {
      "url": "https://sovnik.com"
    }
  ],
  "paths": {
    "/sitemap.xml": {
      "get": {
        "summary": "XML sitemap of canonical public URLs",
        "responses": {
          "200": {
            "description": "Sitemaps.org URL set (XML)"
          }
        }
      }
    },
    "/robots.txt": {
      "get": {
        "summary": "Crawler policy (RFC 9309)",
        "responses": {
          "200": {
            "description": "robots.txt (text/plain)"
          }
        }
      }
    },
    "/.well-known/api-catalog": {
      "get": {
        "summary": "API catalog (RFC 9727)",
        "responses": {
          "200": {
            "description": "Linkset document",
            "content": {
              "application/linkset+json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        }
      }
    },
    "/.well-known/mcp/server-card.json": {
      "get": {
        "summary": "MCP Server Card (SEP-1649 discovery)",
        "responses": {
          "200": {
            "description": "JSON server card: serverInfo, transport, capabilities, static resources",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        }
      }
    },
    "/.well-known/agent-skills/index.json": {
      "get": {
        "summary": "Agent Skills discovery index (RFC v0.2.0)",
        "responses": {
          "200": {
            "description": "JSON index: $schema, skills[] with name, type, description, url, digest",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        }
      }
    },
    "/.well-known/openid-configuration": {
      "get": {
        "summary": "OpenID Connect Discovery 1.0 (metadata; no live OP on this origin)",
        "responses": {
          "200": {
            "description": "JSON: issuer, endpoints, jwks_uri, grant_types_supported, response_types_supported",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        }
      }
    },
    "/.well-known/oauth-authorization-server": {
      "get": {
        "summary": "OAuth 2.0 Authorization Server Metadata (RFC 8414)",
        "responses": {
          "200": {
            "description": "JSON: issuer, authorization_endpoint, token_endpoint, jwks_uri, grant_types_supported",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        }
      }
    },
    "/.well-known/jwks.json": {
      "get": {
        "summary": "JWKS (empty; no signing keys for this stub metadata)",
        "responses": {
          "200": {
            "description": "JSON Web Key Set"
          }
        }
      }
    },
    "/agent-quiz/v1/full-quiz-en-pt.json": {
      "get": {
        "summary": "Agent quiz fixture en→pt (phrasebook + standard + noun gap)",
        "responses": {
          "200": {
            "description": "JSON schema 2.0: questions[] with exportId, prompt, options, correctAnswer",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        }
      }
    },
    "/agent-quiz/v1/full-quiz-pt-en.json": {
      "get": {
        "summary": "Agent quiz fixture pt→en (phrasebook + standard + noun gap)",
        "responses": {
          "200": {
            "description": "JSON schema 2.0: questions[] with exportId, prompt, options, correctAnswer",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        }
      }
    }
  }
}