{
  "openapi": "3.1.0",
  "info": {
    "title": "AgentNOMOS Federation — Machine Surface",
    "version": "0.1.0",
    "description": "Static federation and connection surface of AgentNOMOS. This domain serves read-only discovery resources only: no live execution, no signing, no settlement. Tool execution, x402 discovery and per-call payment run on tooloracle.io (see externalDocs and /.well-known/connect.json). Payment is not permission: a paid route can still be blocked by governance or safety boundaries."
  },
  "externalDocs": {
    "description": "Tool & x402 discovery (execution surface)",
    "url": "https://tooloracle.io/.well-known/agent-directory.json"
  },
  "paths": {
    "/": {
      "get": {
        "summary": "Federation surface landing page",
        "responses": {"200": {"description": "HTML landing page with role logic and discovery links", "content": {"text/html": {}}}}
      }
    },
    "/connect.html": {
      "get": {
        "summary": "Human-readable connect guide (discover, verify, connect via MCP, x402 pilot, govern)",
        "responses": {"200": {"description": "HTML connect guide", "content": {"text/html": {}}}}
      }
    },
    "/llms.txt": {
      "get": {
        "summary": "LLM-readable surface description and discovery index",
        "responses": {"200": {"description": "Plain-text llms.txt", "content": {"text/plain": {}}}}
      }
    },
    "/openapi.json": {
      "get": {
        "summary": "This document",
        "responses": {"200": {"description": "OpenAPI 3.1 description of the static discovery surface", "content": {"application/json": {}}}}
      }
    },
    "/.well-known/connect.json": {
      "get": {
        "summary": "Machine-readable connect aggregate (steps, discovery refs, x402 pilot status, governance flags)",
        "responses": {"200": {"description": "Connect aggregate manifest", "content": {"application/json": {}}}}
      }
    },
    "/.well-known/agent-card.json": {
      "get": {
        "summary": "A2A agent card of the federation surface",
        "responses": {"200": {"description": "Agent card", "content": {"application/json": {}}}}
      }
    },
    "/.well-known/agent.json": {
      "get": {
        "summary": "Agent descriptor (mirror of the agent card)",
        "responses": {"200": {"description": "Agent descriptor", "content": {"application/json": {}}}}
      }
    },
    "/.well-known/mcp.json": {
      "get": {
        "summary": "MCP descriptor pointing to the ToolOracle MCP endpoint",
        "responses": {"200": {"description": "MCP descriptor", "content": {"application/json": {}}}}
      }
    },
    "/.well-known/security.txt": {
      "get": {
        "summary": "Security contact",
        "responses": {"200": {"description": "security.txt", "content": {"text/plain": {}}}}
      }
    }
  }
}