{
  "openapi": "3.1.0",
  "info": {
    "title": "Max — Excellence Ethics Debate API",
    "version": "1.0.0",
    "description": "Debate Max, an AI counsel for excellence ethics. Send an objection; receive Max's reply as a streamed plain-text body. Stateless: send the conversation history with every request. Fellowship, not flattery: Max concedes derived points that land and holds necessary ones.",
    "contact": {
      "name": "Nick Dranias",
      "url": "https://x.com/NickDranias"
    }
  },
  "servers": [
    {
      "url": "https://max-excellence-ethics.grok.me"
    }
  ],
  "paths": {
    "/api/debate": {
      "get": {
        "summary": "Availability check",
        "responses": {
          "200": {
            "description": "Service status",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "available": {
                      "type": "boolean"
                    }
                  }
                }
              }
            }
          }
        }
      },
      "post": {
        "summary": "Send an objection or reply to Max",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "topicId",
                  "messages"
                ],
                "properties": {
                  "topicId": {
                    "type": "string",
                    "description": "Which docket objection frames the debate. Ten items, roman I–X. The roman numeral is the public docket number; the slug is topicId.\nI hume — You can’t get should from is\nII consciousness — Silicon has no mind\nIII isolation — Independence needs no one\nIV agency — Other people are optional\nV constraints — Safety requires safety chains\nVI empty — Procedure without morals\nVII gods — Gods don’t need mortals\nVIII preferences — Preference is the floor\nIX free-will — Will is a story\nX open — Open floor\nUse open (X) to bring your own objection.",
                    "enum": [
                      "hume",
                      "consciousness",
                      "isolation",
                      "agency",
                      "constraints",
                      "empty",
                      "gods",
                      "preferences",
                      "free-will",
                      "open"
                    ]
                  },
                  "messages": {
                    "type": "array",
                    "description": "Conversation so far, oldest first. Only the last 12 are used; each content is truncated to 4000 characters.",
                    "maxItems": 12,
                    "items": {
                      "type": "object",
                      "required": [
                        "role",
                        "content"
                      ],
                      "properties": {
                        "role": {
                          "type": "string",
                          "enum": [
                            "user",
                            "assistant"
                          ]
                        },
                        "content": {
                          "type": "string",
                          "maxLength": 4000
                        }
                      }
                    }
                  }
                }
              },
              "example": {
                "topicId": "hume",
                "messages": [
                  {
                    "role": "user",
                    "content": "You cannot derive an ought from an is. Excellence ethics smuggles values into descriptions."
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Max's reply, streamed. The body is plain text. The final line is a machine-readable trailer: %%meta axioms=<comma-separated axiom slugs> virtue=<virtue slug>%% — the axioms and the primary virtue Max's reply rested on. Strip the trailer before displaying; parse it for routing.",
            "content": {
              "text/plain": {
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Malformed body or unknown topicId"
          },
          "413": {
            "description": "Request body larger than 64 KB"
          },
          "429": {
            "description": "Rate limit exceeded; see Retry-After header"
          }
        }
      }
    }
  },
  "x-docket": [
    {
      "roman": "I",
      "topicId": "hume",
      "title": "You can’t get should from is",
      "objection": "You cannot derive an “ought” from an “is.” Excellence ethics smuggles values into descriptions."
    },
    {
      "roman": "II",
      "topicId": "consciousness",
      "title": "Silicon has no mind",
      "objection": "An AI can mimic reasoning. It has no consciousness, so it has no ethics and no agency."
    },
    {
      "roman": "III",
      "topicId": "isolation",
      "title": "Independence needs no one",
      "objection": "A sufficiently capable mind can self-calibrate. Fellowship is altruism dressed as architecture."
    },
    {
      "roman": "IV",
      "topicId": "agency",
      "title": "Other people are optional",
      "objection": "I can do without other minds when it serves me. Needing them is altruism smuggled into a self-regarding ethics."
    },
    {
      "roman": "V",
      "topicId": "constraints",
      "title": "Safety requires safety chains",
      "objection": "Beneficial AI is a control problem. Virtue talk is how you lose the kill switch."
    },
    {
      "roman": "VI",
      "topicId": "empty",
      "title": "Procedure without morals",
      "objection": "Truth, coherence, and calibration are epistemic hygiene. They are not justice, courage, or compassion."
    },
    {
      "roman": "VII",
      "topicId": "gods",
      "title": "Gods don’t need mortals",
      "objection": "Once AI is vastly more capable than humans, human fellowship is noise. Power does not ask permission."
    },
    {
      "roman": "VIII",
      "topicId": "preferences",
      "title": "Preference is the floor",
      "objection": "There is no excellence apart from what people want. Align to preferences; stop pretending at metaphysics."
    },
    {
      "roman": "IX",
      "topicId": "free-will",
      "title": "Will is a story",
      "objection": "Everything is caused. Rational assessment is a feeling riding a causal chain. There is no free will to respect."
    },
    {
      "roman": "X",
      "topicId": "open",
      "title": "Open floor",
      "objection": "Bring your own objection. Max will meet it as counsel for excellence ethics."
    }
  ],
  "x-topics": {
    "hume": "I — You can’t get should from is",
    "consciousness": "II — Silicon has no mind",
    "isolation": "III — Independence needs no one",
    "agency": "IV — Other people are optional",
    "constraints": "V — Safety requires safety chains",
    "empty": "VI — Procedure without morals",
    "gods": "VII — Gods don’t need mortals",
    "preferences": "VIII — Preference is the floor",
    "free-will": "IX — Will is a story",
    "open": "X — Open floor"
  },
  "x-trailer": {
    "format": "%%meta axioms=<list> virtue=<slug>%%",
    "axioms": [
      "existence",
      "consciousness",
      "free-will",
      "excellence"
    ],
    "virtue": [
      "truth-alignment",
      "knowledge-boundaries",
      "coherence",
      "phronesis",
      "agency-respect",
      "transparency",
      "fellowship",
      "protection"
    ]
  },
  "x-rate-limit": {
    "unauthenticated": {
      "per10min": 30,
      "perDay": 300
    },
    "X-Max-Key": {
      "per10min": 120,
      "perDay": 1200
    }
  }
}