{"openapi":"3.1.0","info":{"title":"Agent SOP Compiler API","version":"0.2.0","description":"Paid agent-facing API for compiling, validating, execution-testing, and hardening evidence-linked draft procedures."},"externalDocs":{"description":"Agent usage and payment instructions","url":"https://agent-sop-compiler-production.up.railway.app/SKILL.md"},"servers":[{"url":"https://agent-sop-compiler-production.up.railway.app"}],"paths":{"/v1/compile":{"post":{"operationId":"compileEvidenceToSop","summary":"Compile source text into an evidence-linked draft ($2.00)","parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompileRequest"}}}},"responses":{"200":{"description":"Compiled and verified draft"},"402":{"description":"x402 payment required"},"422":{"description":"Invalid or unsafe input"},"502":{"description":"Model service or model output failure"},"504":{"description":"Model service timeout"}}}},"/v1/validate":{"post":{"operationId":"validateSopEvidence","summary":"Validate every evidence reference ($0.25)","parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidateRequest"}}}},"responses":{"200":{"description":"Validation result"},"402":{"description":"x402 payment required"}}}},"/v1/harden":{"post":{"operationId":"hardenSopForAgentExecution","summary":"Adversarially execution-test and harden an SOP ($1.00)","description":"Analyzes an evidence-linked draft for ambiguity, missing authority, unsafe actions, failure recovery, conflicts, and unverifiable completion. Returns a machine-readable report, proposed fail-closed draft, and SHA-256 integrity hash. The hash detects result changes but is not a signature. Outputs still require human approval.","parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HardeningRequest"}}}},"responses":{"200":{"description":"Hardening report and proposed evidence-linked draft"},"402":{"description":"x402 payment required"},"422":{"description":"Invalid or unsafe input"},"502":{"description":"Model service or model output failure"},"504":{"description":"Model service timeout"}}}}},"components":{"parameters":{"IdempotencyKey":{"name":"Idempotency-Key","in":"header","required":true,"description":"Unique 16-128 character key. Reuse only when retrying the exact same request.","schema":{"type":"string","minLength":16,"maxLength":128}}},"schemas":{"Source":{"type":"object","required":["id","name","content"],"properties":{"id":{"type":"string","pattern":"^[a-zA-Z0-9._-]+$"},"name":{"type":"string"},"content":{"type":"string","minLength":20,"maxLength":50000}}},"CompileRequest":{"type":"object","required":["sources"],"properties":{"title":{"type":"string"},"requestedFormat":{"type":"string","enum":["sop","checklist"],"default":"sop"},"sources":{"type":"array","minItems":1,"maxItems":12,"items":{"$ref":"#/components/schemas/Source"}}}},"ValidateRequest":{"type":"object","required":["document","sources"],"properties":{"document":{"type":"object","description":"SOP document returned by the compile endpoint"},"sources":{"type":"array","minItems":1,"maxItems":12,"items":{"$ref":"#/components/schemas/Source"}}}},"HardeningRequest":{"type":"object","additionalProperties":false,"required":["document","sources"],"properties":{"document":{"type":"object","description":"SOP document returned by the compile endpoint"},"sources":{"type":"array","minItems":1,"maxItems":12,"items":{"$ref":"#/components/schemas/Source"}},"objective":{"type":"string","minLength":1,"maxLength":1000},"constraints":{"type":"array","maxItems":20,"default":[],"items":{"type":"string","minLength":1,"maxLength":500}},"scenarioCount":{"type":"integer","minimum":3,"maximum":12,"default":5}}}}}}