{
  "$schema": "https://web4page.org/spec/v1",
  "name": "web4page-org",
  "version": "1.0.0",
  "description": "Agent tools for Web4 Page validation, registry indexing, and IRL resolution. Execute via api.web4page.org.",
  "entity": {
    "name": "web4page.org",
    "slug": "web4page-org",
    "url": "https://web4page.org"
  },
  "server": {
    "api_base": "https://api.web4page.org",
    "openapi": "https://web4page.org/openapi.json",
    "transport": "https"
  },
  "auth": {
    "type": "api_key",
    "header": "X-API-Key",
    "required_for": ["submit_web4page", "update_web4page", "register_irl_slug"],
    "contact": "hello@web4page.org"
  },
  "tools": [
    {
      "name": "validate_web4page",
      "description": "Validate a web4page.json document against the open spec and return entity_score + VCAP zones.",
      "method": "POST",
      "path": "/v1/registry/validate",
      "auth_required": false
    },
    {
      "name": "submit_web4page",
      "description": "Index a Web4 Page in registry.web4page.org.",
      "method": "POST",
      "path": "/v1/registry/submit",
      "auth_required": true
    },
    {
      "name": "get_registry_entity",
      "description": "Fetch an indexed entity by type prefix and slug (e.g. o/web4page-org).",
      "method": "GET",
      "path": "/v1/registry/{prefix}/{slug}",
      "auth_required": false
    },
    {
      "name": "resolve_irl_slug",
      "description": "Resolve an IRL slug to its canonical host and VCAP surface URLs.",
      "method": "GET",
      "path": "/resolve/{slug}",
      "auth_required": false
    },
    {
      "name": "register_irl_slug",
      "description": "Register or update an IRL slug → host mapping in the root resolver index.",
      "method": "POST",
      "path": "/v1/resolve/register",
      "auth_required": true
    }
  ],
  "resources": [
    {
      "name": "web4page_spec",
      "uri": "https://web4page.org/spec/v1/schema.json",
      "mimeType": "application/json",
      "description": "JSON Schema for web4page.json"
    },
    {
      "name": "llms_txt",
      "uri": "https://web4page.org/llms.txt",
      "mimeType": "text/plain",
      "description": "AI grounding file for web4page.org"
    }
  ]
}