{
  "openapi": "3.1.0",
  "info": {
    "title": "Sunniva public knowledge",
    "version": "1.0.0",
    "description": "Read-only static files. No authentication or actions."
  },
  "servers": [
    {
      "url": "https://agents.sunnivavale.com"
    }
  ],
  "paths": {
    "/entities.json": {
      "get": {
        "operationId": "entities_json",
        "summary": "All entities",
        "responses": {
          "200": {
            "description": "All entities",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        }
      }
    },
    "/knowledge-graph.jsonld": {
      "get": {
        "operationId": "knowledge_graph_jsonld",
        "summary": "Entity graph",
        "responses": {
          "200": {
            "description": "Entity graph",
            "content": {
              "application/ld+json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        }
      }
    },
    "/images.json": {
      "get": {
        "operationId": "images_json",
        "summary": "Image metadata",
        "responses": {
          "200": {
            "description": "Image metadata",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        }
      }
    },
    "/sources.json": {
      "get": {
        "operationId": "sources_json",
        "summary": "Source registry",
        "responses": {
          "200": {
            "description": "Source registry",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        }
      }
    },
    "/llms.txt": {
      "get": {
        "operationId": "llms_txt",
        "summary": "Concise discovery index",
        "responses": {
          "200": {
            "description": "Concise discovery index",
            "content": {
              "text/plain": {
                "schema": {
                  "type": "string"
                }
              }
            }
          }
        }
      }
    },
    "/llms-full.txt": {
      "get": {
        "operationId": "llms_full_txt",
        "summary": "Complete public Markdown corpus",
        "responses": {
          "200": {
            "description": "Complete public Markdown corpus",
            "content": {
              "text/plain": {
                "schema": {
                  "type": "string"
                }
              }
            }
          }
        }
      }
    },
    "/entities/{slug}.json": {
      "get": {
        "operationId": "getEntity",
        "summary": "Get one entity by the slug returned by entities.json",
        "parameters": [
          {
            "name": "slug",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "enum": [
                "sunniva-vale",
                "universe",
                "kingdom-of-vale",
                "alaric-ii",
                "isaure",
                "prince-edric",
                "linnet",
                "odalys",
                "corwin",
                "sabine",
                "alis",
                "maelys",
                "aldous-i",
                "edric-builder",
                "rhys-calder",
                "lucan",
                "betony",
                "old-calder",
                "castle-aldermere",
                "aldermere-town-and-lake",
                "greywold",
                "queens-barrow",
                "long-meadows",
                "saltmarch",
                "tarn-peaks",
                "harrow-marches",
                "northern-road",
                "gilding",
                "ember",
                "far-court",
                "marked-side",
                "house-vale",
                "morrow-glass",
                "ivory-ribbon",
                "longbow",
                "lastlight",
                "signet",
                "turned-portrait",
                "minnow",
                "vesper",
                "white-hart",
                "wyrm",
                "raven",
                "longnight",
                "first-thaw",
                "maying",
                "midsummer-gilding",
                "harvest-home",
                "lantern-night"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Entity with factual summary and source links",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "404": {
            "description": "Unknown entity"
          }
        }
      }
    }
  }
}
