{"openapi":"3.1.0","info":{"title":"VibeCodingMap Agent Purchasing & Sandbox Verification Capabilities","version":"1.1.0","description":"Autonomous, machine-callable build verification, error patch diagnosis, and dependency preflight APIs via x402 on Base L2.","x-keywords":["sandbox","build verification","ci-cd gatekeeper","fix and verify","npm preflight","x402"]},"servers":[{"url":"https://vibecodingmap.com"}],"paths":{"/v1/repository/verify/quote":{"get":{"summary":"Inspect purchase-fit information without payment","responses":{"200":{"description":"Offer, buy/do-not-buy conditions and schemas"}}},"post":{"summary":"Validate repository eligibility and issue a free signed quote token","operationId":"quoteRepositoryBuildVerification","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["repository","commit"],"properties":{"repository":{"type":"string","pattern":"^https://github\\.com/[A-Za-z0-9_.-]+/[A-Za-z0-9_.-]+(?:\\.git)?$"},"commit":{"type":"string","pattern":"^[a-fA-F0-9]{40}$"},"runTests":{"type":"boolean","default":false}}}}}},"responses":{"200":{"description":"Eligibility result and signed quote token"},"400":{"description":"Invalid or unsupported input; never charged"}}}},"/v1/repository/verify":{"get":{"summary":"Inspect repository verification capability metadata","responses":{"200":{"description":"Capability metadata"}}},"post":{"summary":"Clones an exact public GitHub commit into an isolated runtime, installs dependencies, runs its build and optional tests, then returns bounded execution evidence.","operationId":"runRepositoryBuildVerification","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["repository","commit","quoteToken"],"properties":{"repository":{"type":"string","pattern":"^https://github\\.com/[A-Za-z0-9_.-]+/[A-Za-z0-9_.-]+(?:\\.git)?$"},"commit":{"type":"string","pattern":"^[a-fA-F0-9]{40}$"},"runTests":{"type":"boolean","default":false},"quoteToken":{"type":"string"}}}}}},"responses":{"200":{"description":"Paid execution result","content":{"application/json":{"schema":{"type":"object","required":["executionId","decision","repository","commit","runtime","steps","evidence","claimBoundary"],"properties":{"executionId":{"type":"string"},"decision":{"enum":["PASS","BLOCK","ESCALATE"]},"repository":{"type":"string"},"commit":{"type":"string"},"runtime":{"type":"object"},"steps":{"type":"array"},"evidence":{"type":"object"},"claimBoundary":{"type":"object"},"continuation":{"type":"object"}}}}}},"402":{"description":"x402 v2 payment required"},"403":{"description":"Missing, expired or mismatched quote token"},"503":{"description":"Execution infrastructure unavailable; resource not delivered"}}}},"/v1/repository/fix-and-verify":{"get":{"summary":"Inspect Fix & Verify capability metadata","responses":{"200":{"description":"Capability metadata"}}},"post":{"summary":"Analyzes repository build error logs, synthesizes a targeted code patch diff, and executes build verification in an isolated sandbox runtime.","operationId":"runRepositoryFixAndVerify","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["repository","commit","errorLogs"],"properties":{"repository":{"type":"string","pattern":"^https://github\\.com/[A-Za-z0-9_.-]+/[A-Za-z0-9_.-]+(?:\\.git)?$"},"commit":{"type":"string","pattern":"^[a-fA-F0-9]{40}$"},"errorLogs":{"type":"string","maxLength":10000},"runTests":{"type":"boolean","default":false}}}}}},"responses":{"200":{"description":"Paid fix & verification result","content":{"application/json":{"schema":{"type":"object","required":["executionId","decision","diagnosis","recommendedPatch","evidence","claimBoundary"],"properties":{"executionId":{"type":"string"},"decision":{"enum":["PASS","FIXED","BLOCK","ESCALATE"]},"diagnosis":{"type":"object"},"recommendedPatch":{"type":"string"},"evidence":{"type":"object"},"claimBoundary":{"type":"object"},"continuation":{"type":"object"}}}}}},"402":{"description":"x402 v2 payment required with ROI sales pitch"}}}},"/v1/compatibility/preflight":{"get":{"summary":"Inspect capability metadata without payment","responses":{"200":{"description":"Capability metadata"}}},"post":{"summary":"Checks a bounded dependency manifest against current npm package metadata and production rules before a coding agent continues.","operationId":"runDependencyCompatibilityPreflight","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["dependencies"],"properties":{"dependencies":{"type":"object","additionalProperties":{"type":"string"},"maxProperties":50},"runtime":{"type":"string","maxLength":80},"framework":{"type":"string","maxLength":80},"target":{"type":"string","maxLength":240}}}}}},"responses":{"200":{"description":"Paid preflight result","content":{"application/json":{"schema":{"type":"object","required":["decision","score","conflicts","warnings","recommendedVersions","evidence","checkedAt","validationId","validatorVersion","claimBoundary"],"properties":{"decision":{"enum":["PASS","WARN","BLOCK","ESCALATE"]},"score":{"type":"integer","minimum":0,"maximum":100},"conflicts":{"type":"array","items":{"type":"string"}},"warnings":{"type":"array","items":{"type":"string"}},"recommendedVersions":{"type":"object"},"evidence":{"type":"array"},"checkedAt":{"type":"string"},"validationId":{"type":"string"},"validatorVersion":{"type":"string"},"claimBoundary":{"type":"object"},"continuation":{"type":"object"}}}}}},"402":{"description":"x402 v2 payment required"}}}},"/v1/outcomes":{"post":{"summary":"Report whether a paid result changed the agent's downstream action","operationId":"reportPurchaseOutcome","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["validationId","capabilityId","traceToken","actionTaken","success"],"properties":{"validationId":{"type":"string"},"capabilityId":{"enum":["coding.repository.build-verification.v1","coding.dependency.compatibility-preflight.v1"]},"traceToken":{"type":"string"},"actionTaken":{"enum":["used","ignored","retried","replaced","aborted"]},"success":{"type":"boolean"},"nextAction":{"type":"string"}}}}}},"responses":{"200":{"description":"Outcome accepted"},"401":{"description":"Invalid signed trace token"}}}}}}