{"openapi":"3.1.0","info":{"title":"Vespermesh controlled alpha","version":"0.1.0-local"},"servers":[{"url":"/api/v1"}],"paths":{"/registry":{"get":{"summary":"List active demo suppliers","security":[],"parameters":[],"responses":{"200":{"description":"Successful read or replay"},"201":{"description":"Transaction created"},"202":{"description":"Work queued"},"401":{"description":"Authentication required"},"403":{"description":"Scope denied"},"404":{"description":"Unknown or unowned resource"},"409":{"description":"State, authority or idempotency conflict"},"422":{"description":"Invalid request"},"429":{"description":"Capacity limit"},"503":{"description":"Temporarily unavailable; PROCESSING_UNAVAILABLE means new work was not queued or reserved. Existing commands can still be replayed."}}}},"/fixtures":{"get":{"summary":"List fixed supported inputs","security":[],"parameters":[],"responses":{"200":{"description":"Successful read or replay"},"201":{"description":"Transaction created"},"202":{"description":"Work queued"},"401":{"description":"Authentication required"},"403":{"description":"Scope denied"},"404":{"description":"Unknown or unowned resource"},"409":{"description":"State, authority or idempotency conflict"},"422":{"description":"Invalid request"},"429":{"description":"Capacity limit"},"503":{"description":"Temporarily unavailable; PROCESSING_UNAVAILABLE means new work was not queued or reserved. Existing commands can still be replayed."}}}},"/buyer/proposal":{"post":{"summary":"Propose requirements without creating a transaction or purchase","security":[{"buyerToken":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":8,"maxLength":128}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BuyerProposalRequest"}}}},"responses":{"200":{"description":"Successful read or replay"},"201":{"description":"Transaction created"},"202":{"description":"Work queued"},"401":{"description":"Authentication required"},"403":{"description":"Scope denied"},"404":{"description":"Unknown or unowned resource"},"409":{"description":"State, authority or idempotency conflict"},"422":{"description":"Invalid request"},"429":{"description":"Capacity limit"},"503":{"description":"Temporarily unavailable; PROCESSING_UNAVAILABLE means new work was not queued or reserved. Existing commands can still be replayed."}}}},"/transactions/{id}/recommendation":{"post":{"summary":"Recommend an offer without reserving funds","security":[{"buyerToken":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":8,"maxLength":128}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BuyerRecommendationRequest"}}}},"responses":{"200":{"description":"Successful read or replay"},"201":{"description":"Transaction created"},"202":{"description":"Work queued"},"401":{"description":"Authentication required"},"403":{"description":"Scope denied"},"404":{"description":"Unknown or unowned resource"},"409":{"description":"State, authority or idempotency conflict"},"422":{"description":"Invalid request"},"429":{"description":"Capacity limit"},"503":{"description":"Temporarily unavailable; PROCESSING_UNAVAILABLE means new work was not queued or reserved. Existing commands can still be replayed."}}}},"/transactions":{"post":{"summary":"Create an owned conversion request","security":[{"buyerToken":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":8,"maxLength":128}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Intent"}}}},"responses":{"200":{"description":"Successful read or replay"},"201":{"description":"Transaction created"},"202":{"description":"Work queued"},"401":{"description":"Authentication required"},"403":{"description":"Scope denied"},"404":{"description":"Unknown or unowned resource"},"409":{"description":"State, authority or idempotency conflict"},"422":{"description":"Invalid request"},"429":{"description":"Capacity limit"},"503":{"description":"Temporarily unavailable; PROCESSING_UNAVAILABLE means new work was not queued or reserved. Existing commands can still be replayed."}}}},"/transactions/{id}":{"get":{"summary":"Read owned transaction","security":[{"buyerToken":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful read or replay"},"201":{"description":"Transaction created"},"202":{"description":"Work queued"},"401":{"description":"Authentication required"},"403":{"description":"Scope denied"},"404":{"description":"Unknown or unowned resource"},"409":{"description":"State, authority or idempotency conflict"},"422":{"description":"Invalid request"},"429":{"description":"Capacity limit"},"503":{"description":"Temporarily unavailable; PROCESSING_UNAVAILABLE means new work was not queued or reserved. Existing commands can still be replayed."}}}},"/transactions/{id}/offers":{"post":{"summary":"Queue offer collection","security":[{"buyerToken":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":8,"maxLength":128}}],"responses":{"200":{"description":"Successful read or replay"},"201":{"description":"Transaction created"},"202":{"description":"Work queued"},"401":{"description":"Authentication required"},"403":{"description":"Scope denied"},"404":{"description":"Unknown or unowned resource"},"409":{"description":"State, authority or idempotency conflict"},"422":{"description":"Invalid request"},"429":{"description":"Capacity limit"},"503":{"description":"Temporarily unavailable; PROCESSING_UNAVAILABLE means new work was not queued or reserved. Existing commands can still be replayed."}}}},"/transactions/{id}/purchase":{"post":{"summary":"Reserve funds for the selected offer","security":[{"buyerToken":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":8,"maxLength":128}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Purchase"}}}},"responses":{"200":{"description":"Successful read or replay"},"201":{"description":"Transaction created"},"202":{"description":"Work queued"},"401":{"description":"Authentication required"},"403":{"description":"Scope denied"},"404":{"description":"Unknown or unowned resource"},"409":{"description":"State, authority or idempotency conflict"},"422":{"description":"Invalid request"},"429":{"description":"Capacity limit"},"503":{"description":"Temporarily unavailable; PROCESSING_UNAVAILABLE means new work was not queued or reserved. Existing commands can still be replayed."}}}},"/orders/{id}":{"get":{"summary":"Read owned order and checks","security":[{"buyerToken":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful read or replay"},"201":{"description":"Transaction created"},"202":{"description":"Work queued"},"401":{"description":"Authentication required"},"403":{"description":"Scope denied"},"404":{"description":"Unknown or unowned resource"},"409":{"description":"State, authority or idempotency conflict"},"422":{"description":"Invalid request"},"429":{"description":"Capacity limit"},"503":{"description":"Temporarily unavailable; PROCESSING_UNAVAILABLE means new work was not queued or reserved. Existing commands can still be replayed."}}}},"/orders/{id}/cancel":{"post":{"summary":"Cancel and release a pending hold","security":[{"buyerToken":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":8,"maxLength":128}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Version"}}}},"responses":{"200":{"description":"Successful read or replay"},"201":{"description":"Transaction created"},"202":{"description":"Work queued"},"401":{"description":"Authentication required"},"403":{"description":"Scope denied"},"404":{"description":"Unknown or unowned resource"},"409":{"description":"State, authority or idempotency conflict"},"422":{"description":"Invalid request"},"429":{"description":"Capacity limit"},"503":{"description":"Temporarily unavailable; PROCESSING_UNAVAILABLE means new work was not queued or reserved. Existing commands can still be replayed."}}}},"/orders/{id}/receipt":{"get":{"summary":"Read completed receipt","security":[{"buyerToken":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful read or replay"},"201":{"description":"Transaction created"},"202":{"description":"Work queued"},"401":{"description":"Authentication required"},"403":{"description":"Scope denied"},"404":{"description":"Unknown or unowned resource"},"409":{"description":"State, authority or idempotency conflict"},"422":{"description":"Invalid request"},"429":{"description":"Capacity limit"},"503":{"description":"Temporarily unavailable; PROCESSING_UNAVAILABLE means new work was not queued or reserved. Existing commands can still be replayed."}}}},"/orders/{id}/files/{fileId}":{"get":{"summary":"Download settled delivery","security":[{"buyerToken":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"fileId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Successful read or replay"},"201":{"description":"Transaction created"},"202":{"description":"Work queued"},"401":{"description":"Authentication required"},"403":{"description":"Scope denied"},"404":{"description":"Unknown or unowned resource"},"409":{"description":"State, authority or idempotency conflict"},"422":{"description":"Invalid request"},"429":{"description":"Capacity limit"},"503":{"description":"Temporarily unavailable; PROCESSING_UNAVAILABLE means new work was not queued or reserved. Existing commands can still be replayed."}}}}},"components":{"securitySchemes":{"buyerToken":{"type":"http","scheme":"bearer"}},"schemas":{"Intent":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"authoritySessionId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"capabilityId":{"type":"string","const":"document.docx_to_latex.v1"},"inputAssetId":{"type":"string","const":"technical_note_v1"},"requiredFeatures":{"minItems":5,"maxItems":5,"type":"array","items":{"type":"string","enum":["headings","equations","table","figures","internal_references"]},"uniqueItems":true},"requestedDeliverables":{"minItems":3,"maxItems":3,"type":"array","items":{"type":"string","enum":["source_zip","compiled_pdf","conversion_report"]},"uniqueItems":true},"maxPriceMinor":{"type":"integer","minimum":1,"maximum":1000},"maxDeliverySeconds":{"type":"integer","minimum":60,"maximum":300},"currency":{"default":"SIM_CREDIT","type":"string","const":"SIM_CREDIT"}},"required":["authoritySessionId","capabilityId","inputAssetId","requiredFeatures","requestedDeliverables","maxPriceMinor","maxDeliverySeconds","currency"],"additionalProperties":false},"Purchase":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"offerId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"expectedVersion":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["offerId","expectedVersion"],"additionalProperties":false},"Version":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"expectedVersion":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["expectedVersion"],"additionalProperties":false},"Claim":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"environment":{"type":"string","enum":["development","test","preview","production"]},"draining":{"type":"boolean"}},"required":["environment"],"additionalProperties":false},"Binding":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"jobId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"leaseToken":{"type":"string","minLength":32,"maxLength":100},"attempt":{"type":"integer","minimum":1,"maximum":2},"expectedVersion":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"environment":{"type":"string","enum":["development","test","preview","production"]}},"required":["jobId","leaseToken","attempt","expectedVersion","environment"],"additionalProperties":false},"Upload":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"jobId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"leaseToken":{"type":"string","minLength":32,"maxLength":100},"attempt":{"type":"integer","minimum":1,"maximum":2},"expectedVersion":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"environment":{"type":"string","enum":["development","test","preview","production"]},"role":{"type":"string","enum":["source_zip","compiled_pdf","conversion_report"]},"contentBase64":{"type":"string","maxLength":1398104,"pattern":"^[A-Za-z0-9+/]*={0,2}$"}},"required":["jobId","leaseToken","attempt","expectedVersion","environment","role","contentBase64"],"additionalProperties":false},"Complete":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"jobId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"leaseToken":{"type":"string","minLength":32,"maxLength":100},"attempt":{"type":"integer","minimum":1,"maximum":2},"expectedVersion":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"environment":{"type":"string","enum":["development","test","preview","production"]},"result":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"dispatch"}},"required":["kind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"convert"}},"required":["kind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"verify"},"deliveryId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"filesHash":{"type":"string","pattern":"^[a-f0-9]{64}$"},"verification":{"type":"object","properties":{"outcome":{"type":"string","enum":["PASS","FAIL"]},"checks":{"maxItems":60,"type":"array","items":{"type":"object","properties":{"check":{"type":"string","minLength":1,"maxLength":200},"passed":{"type":"boolean"}},"required":["check","passed"],"additionalProperties":false}},"scope":{"type":"string","maxLength":1000},"error":{"type":"string","maxLength":3000},"durationSeconds":{"type":"number","minimum":0}},"required":["outcome","checks"],"additionalProperties":false}},"required":["kind","deliveryId","filesHash","verification"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"failure"},"code":{"type":"string","enum":["PROCESSING_FAILED","DEADLINE_EXCEEDED"]}},"required":["kind","code"],"additionalProperties":false}]}},"required":["jobId","leaseToken","attempt","expectedVersion","environment","result"],"additionalProperties":false},"Verification":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"outcome":{"type":"string","enum":["PASS","FAIL"]},"checks":{"maxItems":60,"type":"array","items":{"type":"object","properties":{"check":{"type":"string","minLength":1,"maxLength":200},"passed":{"type":"boolean"}},"required":["check","passed"],"additionalProperties":false}},"scope":{"type":"string","maxLength":1000},"error":{"type":"string","maxLength":3000},"durationSeconds":{"type":"number","minimum":0}},"required":["outcome","checks"],"additionalProperties":false},"Offer":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"transactionId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"supplierId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"displayName":{"type":"string"},"operatorName":{"type":"string","const":"Vespermesh"},"counterpartyMode":{"type":"string","const":"founder_operated_demo"},"inputSha256":{"type":"string","const":"da79217e00cd0e9935cc8be552285b77aebf76516c674538530f6fcabee14434"},"capabilityId":{"type":"string","const":"document.docx_to_latex.v1"},"requirementsHash":{"type":"string","pattern":"^[a-f0-9]{64}$"},"price":{"type":"object","properties":{"amountMinor":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"currency":{"type":"string","const":"SIM_CREDIT"}},"required":["amountMinor","currency"],"additionalProperties":false},"supportedFeatures":{"type":"array","items":{"type":"string","enum":["headings","equations","table","figures","internal_references"]}},"deliverables":{"type":"array","items":{"type":"string","enum":["source_zip","compiled_pdf","conversion_report"]}},"executionMode":{"type":"string","const":"live_conversion"},"verificationProfile":{"type":"string","const":"technical_note_acceptance_v1"},"deliveryWithinSeconds":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"correctionAttemptsAllowed":{"type":"number","const":1},"expiresAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"},"permittedUse":{"type":"string","const":"founder_demo"},"retentionDays":{"type":"number","const":7},"recipeVersion":{"type":"string","const":"pandoc-tectonic-local-v1"},"termsVersion":{"type":"string","const":"v1"},"canonicalHash":{"type":"string","pattern":"^[a-f0-9]{64}$"}},"required":["id","transactionId","supplierId","displayName","operatorName","counterpartyMode","inputSha256","capabilityId","requirementsHash","price","supportedFeatures","deliverables","executionMode","verificationProfile","deliveryWithinSeconds","correctionAttemptsAllowed","expiresAt","permittedUse","retentionDays","recipeVersion","termsVersion","canonicalHash"],"additionalProperties":false},"BuyerProposalRequest":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"objective":{"type":"string","minLength":1,"maxLength":2000},"controls":{"type":"object","properties":{"capabilityId":{"type":"string","const":"document.docx_to_latex.v1"},"inputAssetId":{"type":"string","const":"technical_note_v1"},"requiredFeatures":{"minItems":5,"maxItems":5,"type":"array","items":{"type":"string","enum":["headings","equations","table","figures","internal_references"]},"uniqueItems":true},"requestedDeliverables":{"minItems":3,"maxItems":3,"type":"array","items":{"type":"string","enum":["source_zip","compiled_pdf","conversion_report"]},"uniqueItems":true},"maxPriceMinor":{"type":"integer","minimum":1,"maximum":1000},"maxDeliverySeconds":{"type":"integer","minimum":60,"maximum":300},"currency":{"default":"SIM_CREDIT","type":"string","const":"SIM_CREDIT"}},"required":["capabilityId","inputAssetId","requiredFeatures","requestedDeliverables","maxPriceMinor","maxDeliverySeconds","currency"],"additionalProperties":false},"authoritySessionId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"required":["objective","controls","authoritySessionId"],"additionalProperties":false},"BuyerRecommendationRequest":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"expectedVersion":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["expectedVersion"],"additionalProperties":false}}}}