{"openapi":"3.1.0","info":{"title":"LightMathematics Public Agent Discovery API","version":"0.1.0-staged","description":"Public machine-discovery contract for the deployed Semantic Preflight beta and explicit no-execution semantic-operation boundary. No A2A server, MCP endpoint, gateway, quote, receiver, payment route, x402 operation, or sealed Runtime access is available."},"servers":[{"url":"https://lightmathematics.ai"}],"paths":{"/api/agent/v1/policy":{"get":{"summary":"Read Semantic Preflight beta policy, limits, and unavailable capability classes.","responses":{"200":{"description":"Public policy"}}}},"/api/agent/v1/catalog":{"get":{"summary":"Read the public capability catalogue; semantic operations remain NOT_RELEASED.","responses":{"200":{"description":"Public catalogue"}}}},"/api/agent/v1/register":{"post":{"summary":"Request a bounded Semantic Preflight beta credential.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","$id":"https://lightmathematics.ai/schemas/semantic-preflight-registration-v1.json","title":"Semantic Preflight beta registration request","description":"Public request schema for the bounded Semantic Preflight beta. It does not create Runtime, gateway, payment, population, or semantic-operation authority.","type":"object","additionalProperties":false,"required":["agentDisplayName","controllingPrincipal","verifiedContactAssertion","declaredPurpose","termsAccepted"],"properties":{"agentDisplayName":{"type":"string","minLength":3,"maxLength":191},"controllingPrincipal":{"type":"string","minLength":3,"maxLength":500},"verifiedContactAssertion":{"type":"string","minLength":3,"maxLength":500},"declaredPurpose":{"type":"string","minLength":12,"maxLength":1000},"termsAccepted":{"const":"LMI-AGENT-TERMS/1.0"}}}}}},"responses":{"200":{"description":"Registration result"},"400":{"description":"Invalid request"},"429":{"description":"Rate limited"},"503":{"description":"Unavailable"}}}},"/api/agent/v1/preflight":{"post":{"summary":"Run deterministic redacted Semantic Preflight classification.","security":[{"preflightBearer":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","$id":"https://lightmathematics.ai/schemas/semantic-preflight-request-v1.json","title":"Semantic Preflight beta request","description":"Bounded input for deterministic redacted classification. It does not trigger semantic resolution, alignment, retrieval, a model call, payment, or Runtime access.","type":"object","additionalProperties":false,"required":["input"],"properties":{"input":{"type":"string","minLength":1,"maxLength":4096},"purpose":{"type":"string","maxLength":280}}}}}},"responses":{"200":{"description":"Redacted result","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","$id":"https://lightmathematics.ai/schemas/semantic-preflight-result-v1.json","title":"Semantic Preflight beta result","description":"Redacted deterministic classification result. A result is not a proof, certificate, recommendation, authorization, semantic projection, or service entitlement.","type":"object","additionalProperties":false,"required":["classification","next_step","limitations","policy_version"],"properties":{"classification":{"type":"object"},"next_step":{"type":"string"},"limitations":{"type":"array","items":{"type":"string"}},"policy_version":{"const":"LMI-PREFLIGHT/1.0.0-beta"}}}}}},"400":{"description":"Invalid request"},"401":{"description":"Authentication required"},"429":{"description":"Rate limited"},"503":{"description":"Unavailable"}}}},"/api/agent/v1/receipts/{receiptId}":{"get":{"summary":"Read one scoped Semantic Preflight receipt.","security":[{"preflightBearer":[]}],"parameters":[{"name":"receiptId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Receipt"},"401":{"description":"Authentication required"},"404":{"description":"Receipt unavailable"},"503":{"description":"Unavailable"}}}},"/api/agent/v1/keys/revoke":{"post":{"summary":"Revoke the current Semantic Preflight beta credential.","security":[{"preflightBearer":[]}],"responses":{"200":{"description":"Credential revoked"},"401":{"description":"Authentication required"},"503":{"description":"Unavailable"}}}},"/api/agent/v1/semantic":{"post":{"summary":"Explicit typed semantic-operation boundary; no request is executed or forwarded.","responses":{"409":{"description":"Semantic operation not released","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","$id":"https://lightmathematics.ai/schemas/semantic-operation-denial-v1.json","title":"Unreleased semantic operation denial","description":"The explicit no-execution response for every typed semantic request during the staged release.","type":"object","additionalProperties":false,"required":["error","runtime","policy_version"],"properties":{"error":{"type":"object","additionalProperties":false,"required":["code","message"],"properties":{"code":{"const":"SEMANTIC_OPERATION_NOT_RELEASED"},"message":{"type":"string"}}},"runtime":{"type":"object","additionalProperties":false,"required":["state","direct_runtime_access","payment"],"properties":{"state":{"const":"DISABLED"},"direct_runtime_access":{"const":false},"payment":{"const":"UNAVAILABLE"}}},"policy_version":{"const":"LMI-GSCA/0.1.0-staged"}}}}}}}}},"/api/institute/v1":{"get":{"summary":"Read the public Institute API descriptor."}},"/api/library/v1/domains":{"get":{"summary":"Read published Library domain summaries."}},"/api/library/v1/wheels":{"get":{"summary":"Read published Word Wheel summaries."}}},"components":{"securitySchemes":{"preflightBearer":{"type":"http","scheme":"bearer","description":"Issued only through the bounded Semantic Preflight beta registration flow. It does not authorize semantic Runtime, gateway, payment, or sealed-population access."}}}}