{"openapi":"3.1.1","info":{"title":"Unbalanced API","version":"1.0.0-draft.1","description":"Draft for stateless cash-game poker inference. The server URL is reserved for documentation examples."},"servers":[{"url":"https://api.unbalanced.example","description":"Placeholder. No public endpoint is live."}],"paths":{"/healthz":{"get":{"operationId":"getHealth","summary":"Check basic service health","security":[],"responses":{"200":{"description":"Healthy","headers":{},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Health"}}}}}}},"/openapi.json":{"get":{"operationId":"getOpenApi","summary":"Read the published OpenAPI document","security":[],"responses":{"200":{"description":"OpenAPI document","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/v1/capabilities":{"get":{"operationId":"getCapabilities","summary":"List supported formats and inference options","security":[],"responses":{"200":{"description":"Current capabilities","headers":{},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Capabilities"}}}}}}},"/v1/pricing":{"get":{"operationId":"getPricing","summary":"Read the active USD price schedule","security":[],"responses":{"200":{"description":"Active prices","headers":{},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Pricing"}}}}}}},"/v1/decisions/quote":{"post":{"operationId":"quoteDecision","summary":"Validate a poker spot and quote its exact charge","security":[{"ProjectKey":[]}],"responses":{"200":{"description":"Price quote","headers":{"X-Request-ID":{"description":"Correlation ID for this HTTP attempt.","schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9_-]+$"}},"Cache-Control":{"schema":{"type":"string","const":"no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Quote"},"examples":{"river_with_read":{"summary":"Illustrative quote for the synthetic river fixture","value":{"quote_token":"example-only","expires_at":"2026-11-21T20:05:00Z","route":"model","strategy_version":"cash_example_v1","effort":"medium","speed":"ultrafast","charge":{"currency":"USD","amount_microusd":120000,"price_version":"example_price_v1"},"model":"gpt-6.2-astra"}}}}}},"400":{"description":"invalid_json, invalid_request, missing_idempotency_key","headers":{"X-Request-ID":{"description":"Correlation ID for this HTTP attempt.","schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9_-]+$"}},"Cache-Control":{"schema":{"type":"string","const":"no-store"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"invalid_credentials","headers":{"X-Request-ID":{"description":"Correlation ID for this HTTP attempt.","schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9_-]+$"}},"Cache-Control":{"schema":{"type":"string","const":"no-store"}},"WWW-Authenticate":{"schema":{"type":"string","minLength":1,"maxLength":300}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"402":{"description":"insufficient_credits, max_charge_exceeded","headers":{"X-Request-ID":{"description":"Correlation ID for this HTTP attempt.","schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9_-]+$"}},"Cache-Control":{"schema":{"type":"string","const":"no-store"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"insufficient_scope","headers":{"X-Request-ID":{"description":"Correlation ID for this HTTP attempt.","schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9_-]+$"}},"Cache-Control":{"schema":{"type":"string","const":"no-store"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"413":{"description":"payload_too_large","headers":{"X-Request-ID":{"description":"Correlation ID for this HTTP attempt.","schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9_-]+$"}},"Cache-Control":{"schema":{"type":"string","const":"no-store"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"415":{"description":"unsupported_media_type","headers":{"X-Request-ID":{"description":"Correlation ID for this HTTP attempt.","schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9_-]+$"}},"Cache-Control":{"schema":{"type":"string","const":"no-store"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"invalid_hand, not_hero_turn, unsupported_ruleset, invalid_evidence, unsupported_options, strategy_unavailable","headers":{"X-Request-ID":{"description":"Correlation ID for this HTTP attempt.","schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9_-]+$"}},"Cache-Control":{"schema":{"type":"string","const":"no-store"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"rate_limited","headers":{"X-Request-ID":{"description":"Correlation ID for this HTTP attempt.","schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9_-]+$"}},"Cache-Control":{"schema":{"type":"string","const":"no-store"}},"Retry-After":{"schema":{"type":"integer","minimum":0,"maximum":86400}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"capacity_exceeded, temporarily_unavailable","headers":{"X-Request-ID":{"description":"Correlation ID for this HTTP attempt.","schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9_-]+$"}},"Cache-Control":{"schema":{"type":"string","const":"no-store"}},"Retry-After":{"schema":{"type":"integer","minimum":0,"maximum":86400}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/QuoteRequest"},"examples":{"synthetic":{"summary":"Synthetic heads-up flop decision","value":{"hand":{"game":"nlhe_cash","ruleset":"standard_v1","unit":"usd_cent","blinds":{"small":100,"big":200},"button_seat":1,"seats":[{"seat":1,"starting_stack":20000},{"seat":2,"starting_stack":20000}],"hero_seat":2,"hero_cards":["Ks","Qh"],"board":["Kc","8d","3s"],"actions":[{"street":"preflop","seat":1,"action":"post_sb","street_total":100},{"street":"preflop","seat":2,"action":"post_bb","street_total":200},{"street":"preflop","seat":1,"action":"raise","street_total":600},{"street":"preflop","seat":2,"action":"call","street_total":600}],"assertions":{"pot":1200,"hero_stack":19400,"to_call":0}},"evidence":[{"id":"read-1","seat":1,"kind":"read","basis":"hypothetical","text":"Often calls one small flop bet with a weak pair."}],"options":{"effort":"medium","speed":"standard","max_charge_microusd":150000}}},"river_with_read":{"summary":"Synthetic river decision using Astra and Ultrafast with a hypothetical read","value":{"hand":{"game":"nlhe_cash","ruleset":"standard_v1","unit":"usd_cent","blinds":{"small":100,"big":200},"button_seat":1,"seats":[{"seat":1,"starting_stack":20000},{"seat":2,"starting_stack":20000}],"hero_seat":1,"hero_cards":["As","Kc"],"board":["Kh","8d","3s","4d","2c"],"actions":[{"street":"preflop","seat":1,"action":"post_sb","street_total":100},{"street":"preflop","seat":2,"action":"post_bb","street_total":200},{"street":"preflop","seat":1,"action":"raise","street_total":600},{"street":"preflop","seat":2,"action":"call","street_total":600},{"street":"flop","seat":2,"action":"check"},{"street":"flop","seat":1,"action":"bet","street_total":600},{"street":"flop","seat":2,"action":"call","street_total":600},{"street":"turn","seat":2,"action":"check"},{"street":"turn","seat":1,"action":"check"},{"street":"river","seat":2,"action":"check"}],"assertions":{"pot":2400,"hero_stack":18800,"to_call":0}},"evidence":[{"id":"river-pairs","seat":2,"kind":"read","basis":"hypothetical","text":"Calls half-pot river bets with some middle pairs after the turn checks through."}],"options":{"effort":"medium","speed":"ultrafast","max_charge_microusd":150000,"model":"gpt-6.2-astra"}}}}}}},"x-required-scope":"decisions:write"}},"/v1/decisions":{"post":{"operationId":"createDecision","summary":"Analyze a poker decision","security":[{"ProjectKey":[]}],"responses":{"200":{"description":"Completed result, replay or completed receipt after reply expiry","headers":{"X-Request-ID":{"description":"Correlation ID for this HTTP attempt.","schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9_-]+$"}},"Cache-Control":{"schema":{"type":"string","const":"no-store"}},"X-RateLimit-Limit":{"description":"Decision requests permitted during the applicable rate window.","schema":{"type":"integer","minimum":1}},"X-RateLimit-Remaining":{"description":"Decision requests remaining in the applicable rate window.","schema":{"type":"integer","minimum":0}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DecisionReply"},"examples":{"synthetic":{"summary":"Illustrative fixture, not a live inference","value":{"receipt":{"request_id":"dec_example_01","status":"completed","created_at":"2026-11-21T20:00:00Z","finished_at":"2026-11-21T20:00:00Z","strategy_version":"cash_example_v1","charge":{"currency":"USD","amount_microusd":0,"price_version":"example_price_v1"},"result_availability":"available","result_expires_at":"2026-11-21T20:15:00Z","failure_code":null},"result":{"decision":{"action":"check","street_total":null,"amount_added":0,"unit":"usd_cent","all_in":false},"facts":{"street":"flop","pot":1200,"hero_stack":19400,"to_call":0,"unit":"usd_cent"},"explanation":"Checking lets the preflop raiser act first and keeps their weaker holdings in the hand.","evidence_used":[],"assumptions":[],"sources":[],"versions":{"engine":"example_engine_v1","strategy":"cash_example_v1","variant":"baseline","template":null,"prompt_sha256":null,"provider_model":null},"execution":{"route":"deterministic","effort":null,"speed":null,"elapsed_ms":12,"rule_id":"flop_first_check","model":null}}}},"river_with_read":{"summary":"Simulated result with illustrative charge and latency","value":{"receipt":{"request_id":"dec_example_02","status":"completed","created_at":"2026-11-21T20:00:00Z","finished_at":"2026-11-21T20:00:00Z","strategy_version":"cash_example_v1","charge":{"currency":"USD","amount_microusd":120000,"price_version":"example_price_v1"},"result_availability":"available","result_expires_at":"2026-11-21T20:15:00Z","failure_code":null},"result":{"decision":{"action":"bet","street_total":1200,"amount_added":1200,"unit":"usd_cent","all_in":false},"facts":{"street":"river","pot":2400,"hero_stack":18800,"to_call":0,"unit":"usd_cent"},"explanation":"Half pot targets weaker kings and middle pairs after the turn checks through. The middle-pair calls are an assumption from the supplied read, so a smaller price may be better if those hands are more sensitive than expected.","evidence_used":["river-pairs"],"assumptions":[{"text":"Some middle pairs call half pot after the turn checks through.","basis":"hypothetical_read","evidence_ids":["river-pairs"]}],"sources":[],"versions":{"engine":"example_engine_v1","strategy":"cash_example_v1","variant":"baseline","template":"example_template_v1","prompt_sha256":"0000000000000000000000000000000000000000000000000000000000000000","provider_model":"gpt-6.2-astra"},"execution":{"route":"model","effort":"medium","speed":"ultrafast","elapsed_ms":1900,"rule_id":null,"model":"gpt-6.2-astra"}}}}}}}},"400":{"description":"invalid_json, invalid_request, missing_idempotency_key","headers":{"X-Request-ID":{"description":"Correlation ID for this HTTP attempt.","schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9_-]+$"}},"Cache-Control":{"schema":{"type":"string","const":"no-store"}},"X-RateLimit-Limit":{"description":"Decision requests permitted during the applicable rate window.","schema":{"type":"integer","minimum":1}},"X-RateLimit-Remaining":{"description":"Decision requests remaining in the applicable rate window.","schema":{"type":"integer","minimum":0}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"invalid_credentials","headers":{"X-Request-ID":{"description":"Correlation ID for this HTTP attempt.","schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9_-]+$"}},"Cache-Control":{"schema":{"type":"string","const":"no-store"}},"WWW-Authenticate":{"schema":{"type":"string","minLength":1,"maxLength":300}},"X-RateLimit-Limit":{"description":"Decision requests permitted during the applicable rate window.","schema":{"type":"integer","minimum":1}},"X-RateLimit-Remaining":{"description":"Decision requests remaining in the applicable rate window.","schema":{"type":"integer","minimum":0}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"402":{"description":"insufficient_credits, max_charge_exceeded","headers":{"X-Request-ID":{"description":"Correlation ID for this HTTP attempt.","schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9_-]+$"}},"Cache-Control":{"schema":{"type":"string","const":"no-store"}},"X-RateLimit-Limit":{"description":"Decision requests permitted during the applicable rate window.","schema":{"type":"integer","minimum":1}},"X-RateLimit-Remaining":{"description":"Decision requests remaining in the applicable rate window.","schema":{"type":"integer","minimum":0}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"insufficient_scope","headers":{"X-Request-ID":{"description":"Correlation ID for this HTTP attempt.","schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9_-]+$"}},"Cache-Control":{"schema":{"type":"string","const":"no-store"}},"X-RateLimit-Limit":{"description":"Decision requests permitted during the applicable rate window.","schema":{"type":"integer","minimum":1}},"X-RateLimit-Remaining":{"description":"Decision requests remaining in the applicable rate window.","schema":{"type":"integer","minimum":0}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"idempotency_conflict, request_in_progress, quote_invalid","headers":{"X-Request-ID":{"description":"Correlation ID for this HTTP attempt.","schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9_-]+$"}},"Cache-Control":{"schema":{"type":"string","const":"no-store"}},"Retry-After":{"schema":{"type":"integer","minimum":0,"maximum":86400}},"X-RateLimit-Limit":{"description":"Decision requests permitted during the applicable rate window.","schema":{"type":"integer","minimum":1}},"X-RateLimit-Remaining":{"description":"Decision requests remaining in the applicable rate window.","schema":{"type":"integer","minimum":0}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"413":{"description":"payload_too_large","headers":{"X-Request-ID":{"description":"Correlation ID for this HTTP attempt.","schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9_-]+$"}},"Cache-Control":{"schema":{"type":"string","const":"no-store"}},"X-RateLimit-Limit":{"description":"Decision requests permitted during the applicable rate window.","schema":{"type":"integer","minimum":1}},"X-RateLimit-Remaining":{"description":"Decision requests remaining in the applicable rate window.","schema":{"type":"integer","minimum":0}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"415":{"description":"unsupported_media_type","headers":{"X-Request-ID":{"description":"Correlation ID for this HTTP attempt.","schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9_-]+$"}},"Cache-Control":{"schema":{"type":"string","const":"no-store"}},"X-RateLimit-Limit":{"description":"Decision requests permitted during the applicable rate window.","schema":{"type":"integer","minimum":1}},"X-RateLimit-Remaining":{"description":"Decision requests remaining in the applicable rate window.","schema":{"type":"integer","minimum":0}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"invalid_hand, not_hero_turn, unsupported_ruleset, invalid_evidence, unsupported_options, strategy_unavailable","headers":{"X-Request-ID":{"description":"Correlation ID for this HTTP attempt.","schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9_-]+$"}},"Cache-Control":{"schema":{"type":"string","const":"no-store"}},"X-RateLimit-Limit":{"description":"Decision requests permitted during the applicable rate window.","schema":{"type":"integer","minimum":1}},"X-RateLimit-Remaining":{"description":"Decision requests remaining in the applicable rate window.","schema":{"type":"integer","minimum":0}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"rate_limited","headers":{"X-Request-ID":{"description":"Correlation ID for this HTTP attempt.","schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9_-]+$"}},"Cache-Control":{"schema":{"type":"string","const":"no-store"}},"Retry-After":{"schema":{"type":"integer","minimum":0,"maximum":86400}},"X-RateLimit-Limit":{"description":"Decision requests permitted during the applicable rate window.","schema":{"type":"integer","minimum":1}},"X-RateLimit-Remaining":{"description":"Decision requests remaining in the applicable rate window.","schema":{"type":"integer","minimum":0}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"502":{"description":"invalid_model_answer, provider_error","headers":{"X-Request-ID":{"description":"Correlation ID for this HTTP attempt.","schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9_-]+$"}},"Cache-Control":{"schema":{"type":"string","const":"no-store"}},"X-RateLimit-Limit":{"description":"Decision requests permitted during the applicable rate window.","schema":{"type":"integer","minimum":1}},"X-RateLimit-Remaining":{"description":"Decision requests remaining in the applicable rate window.","schema":{"type":"integer","minimum":0}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"capacity_exceeded, temporarily_unavailable","headers":{"X-Request-ID":{"description":"Correlation ID for this HTTP attempt.","schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9_-]+$"}},"Cache-Control":{"schema":{"type":"string","const":"no-store"}},"Retry-After":{"schema":{"type":"integer","minimum":0,"maximum":86400}},"X-RateLimit-Limit":{"description":"Decision requests permitted during the applicable rate window.","schema":{"type":"integer","minimum":1}},"X-RateLimit-Remaining":{"description":"Decision requests remaining in the applicable rate window.","schema":{"type":"integer","minimum":0}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"504":{"description":"deadline_exceeded","headers":{"X-Request-ID":{"description":"Correlation ID for this HTTP attempt.","schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9_-]+$"}},"Cache-Control":{"schema":{"type":"string","const":"no-store"}},"X-RateLimit-Limit":{"description":"Decision requests permitted during the applicable rate window.","schema":{"type":"integer","minimum":1}},"X-RateLimit-Remaining":{"description":"Decision requests remaining in the applicable rate window.","schema":{"type":"integer","minimum":0}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DecisionRequest"},"examples":{"synthetic":{"summary":"Synthetic heads-up flop decision","value":{"hand":{"game":"nlhe_cash","ruleset":"standard_v1","unit":"usd_cent","blinds":{"small":100,"big":200},"button_seat":1,"seats":[{"seat":1,"starting_stack":20000},{"seat":2,"starting_stack":20000}],"hero_seat":2,"hero_cards":["Ks","Qh"],"board":["Kc","8d","3s"],"actions":[{"street":"preflop","seat":1,"action":"post_sb","street_total":100},{"street":"preflop","seat":2,"action":"post_bb","street_total":200},{"street":"preflop","seat":1,"action":"raise","street_total":600},{"street":"preflop","seat":2,"action":"call","street_total":600}],"assertions":{"pot":1200,"hero_stack":19400,"to_call":0}},"evidence":[{"id":"read-1","seat":1,"kind":"read","basis":"hypothetical","text":"Often calls one small flop bet with a weak pair."}],"options":{"effort":"medium","speed":"standard","max_charge_microusd":150000}}},"river_with_read":{"summary":"Synthetic river decision using Astra and Ultrafast with a hypothetical read","value":{"hand":{"game":"nlhe_cash","ruleset":"standard_v1","unit":"usd_cent","blinds":{"small":100,"big":200},"button_seat":1,"seats":[{"seat":1,"starting_stack":20000},{"seat":2,"starting_stack":20000}],"hero_seat":1,"hero_cards":["As","Kc"],"board":["Kh","8d","3s","4d","2c"],"actions":[{"street":"preflop","seat":1,"action":"post_sb","street_total":100},{"street":"preflop","seat":2,"action":"post_bb","street_total":200},{"street":"preflop","seat":1,"action":"raise","street_total":600},{"street":"preflop","seat":2,"action":"call","street_total":600},{"street":"flop","seat":2,"action":"check"},{"street":"flop","seat":1,"action":"bet","street_total":600},{"street":"flop","seat":2,"action":"call","street_total":600},{"street":"turn","seat":2,"action":"check"},{"street":"turn","seat":1,"action":"check"},{"street":"river","seat":2,"action":"check"}],"assertions":{"pot":2400,"hero_stack":18800,"to_call":0}},"evidence":[{"id":"river-pairs","seat":2,"kind":"read","basis":"hypothetical","text":"Calls half-pot river bets with some middle pairs after the turn checks through."}],"options":{"effort":"medium","speed":"ultrafast","max_charge_microusd":150000,"model":"gpt-6.2-astra"}}}}}}},"parameters":[{"name":"Idempotency-Key","in":"header","schema":{"type":"string","minLength":16,"maxLength":128,"pattern":"^[A-Za-z0-9_.~-]+$"},"required":true,"description":"Unique to the operation. Repeat the same key and body after an ambiguous network failure."}],"x-required-scope":"decisions:write"}},"/v1/decisions/{request_id}":{"get":{"operationId":"getDecision","summary":"Recover a decision status, receipt or recent answer","security":[{"ProjectKey":[]}],"responses":{"200":{"description":"Current status and any authorized replay result","headers":{"X-Request-ID":{"description":"Correlation ID for this HTTP attempt.","schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9_-]+$"}},"Cache-Control":{"schema":{"type":"string","const":"no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DecisionReply"}}}},"400":{"description":"invalid_json, invalid_request, missing_idempotency_key","headers":{"X-Request-ID":{"description":"Correlation ID for this HTTP attempt.","schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9_-]+$"}},"Cache-Control":{"schema":{"type":"string","const":"no-store"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"invalid_credentials","headers":{"X-Request-ID":{"description":"Correlation ID for this HTTP attempt.","schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9_-]+$"}},"Cache-Control":{"schema":{"type":"string","const":"no-store"}},"WWW-Authenticate":{"schema":{"type":"string","minLength":1,"maxLength":300}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"insufficient_scope","headers":{"X-Request-ID":{"description":"Correlation ID for this HTTP attempt.","schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9_-]+$"}},"Cache-Control":{"schema":{"type":"string","const":"no-store"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"not_found","headers":{"X-Request-ID":{"description":"Correlation ID for this HTTP attempt.","schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9_-]+$"}},"Cache-Control":{"schema":{"type":"string","const":"no-store"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"rate_limited","headers":{"X-Request-ID":{"description":"Correlation ID for this HTTP attempt.","schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9_-]+$"}},"Cache-Control":{"schema":{"type":"string","const":"no-store"}},"Retry-After":{"schema":{"type":"integer","minimum":0,"maximum":86400}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"capacity_exceeded, temporarily_unavailable","headers":{"X-Request-ID":{"description":"Correlation ID for this HTTP attempt.","schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9_-]+$"}},"Cache-Control":{"schema":{"type":"string","const":"no-store"}},"Retry-After":{"schema":{"type":"integer","minimum":0,"maximum":86400}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"parameters":[{"name":"request_id","in":"path","schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9_-]+$"},"required":true}],"x-required-scope":"decisions:read"}},"/v1/usage":{"get":{"operationId":"listUsage","summary":"List decision metadata for your project","security":[{"ProjectKey":[]}],"responses":{"200":{"description":"Most recent receipts first, ordered by creation time and request ID","headers":{"X-Request-ID":{"description":"Correlation ID for this HTTP attempt.","schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9_-]+$"}},"Cache-Control":{"schema":{"type":"string","const":"no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UsagePage"}}}},"400":{"description":"invalid_json, invalid_request, missing_idempotency_key","headers":{"X-Request-ID":{"description":"Correlation ID for this HTTP attempt.","schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9_-]+$"}},"Cache-Control":{"schema":{"type":"string","const":"no-store"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"invalid_credentials","headers":{"X-Request-ID":{"description":"Correlation ID for this HTTP attempt.","schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9_-]+$"}},"Cache-Control":{"schema":{"type":"string","const":"no-store"}},"WWW-Authenticate":{"schema":{"type":"string","minLength":1,"maxLength":300}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"insufficient_scope","headers":{"X-Request-ID":{"description":"Correlation ID for this HTTP attempt.","schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9_-]+$"}},"Cache-Control":{"schema":{"type":"string","const":"no-store"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"rate_limited","headers":{"X-Request-ID":{"description":"Correlation ID for this HTTP attempt.","schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9_-]+$"}},"Cache-Control":{"schema":{"type":"string","const":"no-store"}},"Retry-After":{"schema":{"type":"integer","minimum":0,"maximum":86400}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"capacity_exceeded, temporarily_unavailable","headers":{"X-Request-ID":{"description":"Correlation ID for this HTTP attempt.","schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9_-]+$"}},"Cache-Control":{"schema":{"type":"string","const":"no-store"}},"Retry-After":{"schema":{"type":"integer","minimum":0,"maximum":86400}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"parameters":[{"name":"from","in":"query","schema":{"type":"string","minLength":1,"maxLength":40,"format":"date-time"},"required":false,"description":"Inclusive UTC timestamp."},{"name":"to","in":"query","schema":{"type":"string","minLength":1,"maxLength":40,"format":"date-time"},"required":false,"description":"Exclusive UTC timestamp."},{"name":"status","in":"query","schema":{"type":"string","enum":["pending","completed","failed"]},"required":false},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"required":false},{"name":"cursor","in":"query","schema":{"type":"string","minLength":1,"maxLength":1500},"required":false,"description":"Opaque cursor bound to this project and these filters."}],"x-required-scope":"usage:read"}},"/v1/balance":{"get":{"operationId":"getBalance","summary":"Read available account credits","security":[{"ProjectKey":[]}],"responses":{"200":{"description":"Current credit balance","headers":{"X-Request-ID":{"description":"Correlation ID for this HTTP attempt.","schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9_-]+$"}},"Cache-Control":{"schema":{"type":"string","const":"no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Balance"}}}},"401":{"description":"invalid_credentials","headers":{"X-Request-ID":{"description":"Correlation ID for this HTTP attempt.","schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9_-]+$"}},"Cache-Control":{"schema":{"type":"string","const":"no-store"}},"WWW-Authenticate":{"schema":{"type":"string","minLength":1,"maxLength":300}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"insufficient_scope","headers":{"X-Request-ID":{"description":"Correlation ID for this HTTP attempt.","schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9_-]+$"}},"Cache-Control":{"schema":{"type":"string","const":"no-store"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"rate_limited","headers":{"X-Request-ID":{"description":"Correlation ID for this HTTP attempt.","schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9_-]+$"}},"Cache-Control":{"schema":{"type":"string","const":"no-store"}},"Retry-After":{"schema":{"type":"integer","minimum":0,"maximum":86400}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"capacity_exceeded, temporarily_unavailable","headers":{"X-Request-ID":{"description":"Correlation ID for this HTTP attempt.","schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9_-]+$"}},"Cache-Control":{"schema":{"type":"string","const":"no-store"}},"Retry-After":{"schema":{"type":"integer","minimum":0,"maximum":86400}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"x-required-scope":"billing:read"}}},"components":{"securitySchemes":{"ProjectKey":{"type":"http","scheme":"bearer","description":"Project API key. Required scopes are specified on each operation."}},"schemas":{"Card":{"type":"string","minLength":2,"maxLength":2,"pattern":"^[2-9TJQKA][cdhs]$"},"Street":{"type":"string","enum":["preflop","flop","turn","river"]},"Unit":{"type":"string","enum":["usd_cent","chip"]},"EvidenceFamily":{"type":"string","enum":["opening_entry","preflop_response","cbet","stab","facing_bet_response","flop_raise","sizing_tendency","shown_slowplay"]},"OpponentContext":{"type":"object","additionalProperties":false,"properties":{"street":{"$ref":"#/components/schemas/Street"},"position":{"type":"string","enum":["sb","bb","utg","utg1","utg2","lj","hj","co","btn","btn_sb","mp","mp1","mp2"]},"pot_type":{"type":"string","enum":["limped","single_raised","three_bet","four_bet_plus"]},"players":{"type":"integer","minimum":2,"maximum":9},"position_relative":{"type":"string","enum":["in_position","out_of_position","between"]},"board_texture":{"type":"string","enum":["wet","dry","paired","monotone","two_tone","rainbow"]},"price_band":{"type":"string","enum":["small","medium","large","overbet","all_in"]},"min_bet_pct_pot":{"type":"integer","minimum":0,"maximum":10000},"max_bet_pct_pot":{"type":"integer","minimum":0,"maximum":10000}},"required":[]},"Board":{"type":"array","items":{"$ref":"#/components/schemas/Card"},"minItems":0,"maxItems":5,"uniqueItems":true,"oneOf":[{"minItems":0,"maxItems":0},{"minItems":3,"maxItems":3},{"minItems":4,"maxItems":4},{"minItems":5,"maxItems":5}]},"Action":{"type":"object","additionalProperties":false,"properties":{"street":{"$ref":"#/components/schemas/Street"},"seat":{"type":"integer","minimum":1,"maximum":9},"action":{"type":"string","enum":["post_sb","post_bb","check","fold","call","bet","raise"]},"street_total":{"type":"integer","minimum":1,"maximum":1000000000}},"required":["street","seat","action"],"allOf":[{"if":{"properties":{"action":{"enum":["check","fold"]}}},"then":{"not":{"required":["street_total"]}},"else":{"required":["street_total"]}},{"if":{"properties":{"action":{"enum":["post_sb","post_bb"]}}},"then":{"properties":{"street":{"const":"preflop"}}}}]},"Hand":{"type":"object","additionalProperties":false,"properties":{"game":{"type":"string","enum":["nlhe_cash"]},"ruleset":{"type":"string","enum":["standard_v1"]},"unit":{"$ref":"#/components/schemas/Unit"},"blinds":{"type":"object","additionalProperties":false,"properties":{"small":{"type":"integer","minimum":1,"maximum":1000000000},"big":{"type":"integer","minimum":1,"maximum":1000000000}},"required":["small","big"]},"button_seat":{"type":"integer","minimum":1,"maximum":9},"seats":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"seat":{"type":"integer","minimum":1,"maximum":9},"starting_stack":{"type":"integer","minimum":1,"maximum":1000000000}},"required":["seat","starting_stack"]},"minItems":2,"maxItems":9},"hero_seat":{"type":"integer","minimum":1,"maximum":9},"hero_cards":{"type":"array","items":{"$ref":"#/components/schemas/Card"},"minItems":2,"maxItems":2,"uniqueItems":true},"board":{"$ref":"#/components/schemas/Board"},"actions":{"type":"array","items":{"$ref":"#/components/schemas/Action"},"minItems":2,"maxItems":200},"decision_at":{"type":"string","minLength":1,"maxLength":40,"format":"date-time"},"assertions":{"type":"object","additionalProperties":false,"properties":{"pot":{"type":"integer","minimum":0,"maximum":9000000000},"hero_stack":{"type":"integer","minimum":0,"maximum":1000000000},"to_call":{"type":"integer","minimum":0,"maximum":1000000000}},"required":[]}},"required":["game","ruleset","unit","blinds","button_seat","seats","hero_seat","hero_cards","board","actions"]},"ReadEvidence":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string","minLength":1,"maxLength":48,"pattern":"^[A-Za-z0-9_-]+$"},"seat":{"type":"integer","minimum":1,"maximum":9},"kind":{"type":"string","enum":["read"]},"text":{"type":"string","minLength":1,"maxLength":2000},"basis":{"type":"string","enum":["observed","hypothetical"]},"opportunities":{"type":"integer","minimum":1,"maximum":1000000000},"observed_at":{"type":"string","minLength":1,"maxLength":40,"format":"date-time"}},"required":["id","seat","kind","text","basis"]},"StatisticEvidence":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string","minLength":1,"maxLength":48,"pattern":"^[A-Za-z0-9_-]+$"},"seat":{"type":"integer","minimum":1,"maximum":9},"family":{"$ref":"#/components/schemas/EvidenceFamily"},"context":{"$ref":"#/components/schemas/OpponentContext"},"observed_at":{"type":"string","minLength":1,"maxLength":40,"format":"date-time"},"kind":{"type":"string","enum":["statistic"]},"opportunities":{"type":"integer","minimum":1,"maximum":1000000000},"counts":{"type":"object","minProperties":1,"maxProperties":8,"propertyNames":{"pattern":"^[a-z][a-z0-9_]{0,31}$"},"additionalProperties":{"type":"integer","minimum":0,"maximum":1000000000}}},"required":["id","seat","kind","family","context","opportunities","counts"]},"EstimateEvidence":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string","minLength":1,"maxLength":48,"pattern":"^[A-Za-z0-9_-]+$"},"seat":{"type":"integer","minimum":1,"maximum":9},"family":{"$ref":"#/components/schemas/EvidenceFamily"},"context":{"$ref":"#/components/schemas/OpponentContext"},"observed_at":{"type":"string","minLength":1,"maxLength":40,"format":"date-time"},"kind":{"type":"string","enum":["estimate"]},"probabilities_bp":{"type":"object","minProperties":1,"maxProperties":8,"propertyNames":{"pattern":"^[a-z][a-z0-9_]{0,31}$"},"additionalProperties":{"type":"integer","minimum":0,"maximum":10000}},"method":{"type":"string","enum":["individual","population","pool_adjusted","hypothetical"]},"supporting_evidence_ids":{"type":"array","items":{"type":"string","minLength":1,"maxLength":48,"pattern":"^[A-Za-z0-9_-]+$"},"minItems":0,"maxItems":12,"uniqueItems":true}},"required":["id","seat","kind","family","context","probabilities_bp","method"]},"PriorHandEvidence":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string","minLength":1,"maxLength":48,"pattern":"^[A-Za-z0-9_-]+$"},"seat":{"type":"integer","minimum":1,"maximum":9},"kind":{"type":"string","enum":["prior_hand"]},"completed_at":{"type":"string","minLength":1,"maxLength":40,"format":"date-time"},"unit":{"$ref":"#/components/schemas/Unit"},"board":{"$ref":"#/components/schemas/Board"},"opponent_position":{"type":"string","enum":["sb","bb","utg","utg1","utg2","lj","hj","co","btn","btn_sb","mp","mp1","mp2"]},"hero_position":{"type":"string","enum":["sb","bb","utg","utg1","utg2","lj","hj","co","btn","btn_sb","mp","mp1","mp2"]},"excerpt":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"street":{"$ref":"#/components/schemas/Street"},"position":{"type":"string","enum":["sb","bb","utg","utg1","utg2","lj","hj","co","btn","btn_sb","mp","mp1","mp2"]},"action":{"type":"string","enum":["check","fold","call","bet","raise"]},"street_total":{"type":"integer","minimum":1,"maximum":1000000000},"pot_before":{"type":"integer","minimum":0,"maximum":9000000000}},"required":["street","position","action"],"allOf":[{"if":{"properties":{"action":{"enum":["check","fold"]}}},"then":{"not":{"required":["street_total"]}},"else":{"required":["street_total"]}}]},"minItems":1,"maxItems":32},"shown_cards":{"type":"array","items":{"$ref":"#/components/schemas/Card"},"minItems":2,"maxItems":2,"uniqueItems":true}},"required":["id","seat","kind","completed_at","unit","board","opponent_position","excerpt"]},"Options":{"type":"object","additionalProperties":false,"properties":{"effort":{"type":"string","enum":["low","medium","high"],"default":"medium"},"speed":{"type":"string","enum":["standard","priority","ultrafast"],"default":"standard"},"timeout_ms":{"type":"integer","minimum":2000,"maximum":60000,"default":30000},"strategy_version":{"type":"string","minLength":1,"maxLength":120,"pattern":"^[A-Za-z0-9_.-]+$"},"max_charge_microusd":{"type":"integer","minimum":0,"maximum":1000000000000},"replay_response":{"type":"boolean","default":true},"model":{"type":"string","enum":["gpt-6.2-sol","gpt-6.2-astra"],"default":"gpt-6.2-sol"}},"required":[]},"QuoteRequest":{"type":"object","additionalProperties":false,"properties":{"hand":{"$ref":"#/components/schemas/Hand"},"evidence":{"type":"array","items":{"oneOf":[{"$ref":"#/components/schemas/ReadEvidence"},{"$ref":"#/components/schemas/StatisticEvidence"},{"$ref":"#/components/schemas/EstimateEvidence"},{"$ref":"#/components/schemas/PriorHandEvidence"}]},"minItems":0,"maxItems":24},"options":{"$ref":"#/components/schemas/Options"}},"required":["hand"]},"DecisionRequest":{"type":"object","additionalProperties":false,"properties":{"hand":{"$ref":"#/components/schemas/Hand"},"evidence":{"type":"array","items":{"oneOf":[{"$ref":"#/components/schemas/ReadEvidence"},{"$ref":"#/components/schemas/StatisticEvidence"},{"$ref":"#/components/schemas/EstimateEvidence"},{"$ref":"#/components/schemas/PriorHandEvidence"}]},"minItems":0,"maxItems":24},"options":{"$ref":"#/components/schemas/Options"},"quote_token":{"type":"string","minLength":1,"maxLength":4096}},"required":["hand"]},"Charge":{"type":"object","additionalProperties":false,"properties":{"currency":{"type":"string","enum":["USD"]},"amount_microusd":{"type":"integer","minimum":0,"maximum":1000000000000},"price_version":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9_-]+$"}},"required":["currency","amount_microusd","price_version"]},"Quote":{"type":"object","additionalProperties":false,"properties":{"quote_token":{"type":"string","minLength":1,"maxLength":4096},"expires_at":{"type":"string","minLength":1,"maxLength":40,"format":"date-time"},"route":{"type":"string","enum":["deterministic","model"]},"strategy_version":{"type":"string","minLength":1,"maxLength":120,"pattern":"^[A-Za-z0-9_.-]+$"},"effort":{"anyOf":[{"type":"string","enum":["low","medium","high"]},{"type":"null"}]},"speed":{"anyOf":[{"type":"string","enum":["standard","priority","ultrafast"]},{"type":"null"}]},"charge":{"$ref":"#/components/schemas/Charge"},"model":{"anyOf":[{"type":"string","enum":["gpt-6.2-sol","gpt-6.2-astra"]},{"type":"null"}]}},"required":["quote_token","expires_at","route","strategy_version","effort","speed","charge","model"]},"Decision":{"type":"object","additionalProperties":false,"properties":{"action":{"type":"string","enum":["check","fold","call","bet","raise"]},"street_total":{"anyOf":[{"type":"integer","minimum":1,"maximum":1000000000},{"type":"null"}]},"amount_added":{"type":"integer","minimum":0,"maximum":1000000000},"unit":{"$ref":"#/components/schemas/Unit"},"all_in":{"type":"boolean"}},"required":["action","street_total","amount_added","unit","all_in"],"allOf":[{"if":{"properties":{"action":{"enum":["check","fold"]}}},"then":{"properties":{"street_total":{"type":"null"},"amount_added":{"const":0},"all_in":{"const":false}}},"else":{"properties":{"street_total":{"type":"integer","minimum":1,"maximum":1000000000},"amount_added":{"type":"integer","minimum":1,"maximum":1000000000}}}}]},"DerivedFacts":{"type":"object","additionalProperties":false,"properties":{"street":{"$ref":"#/components/schemas/Street"},"pot":{"type":"integer","minimum":0,"maximum":9000000000},"hero_stack":{"type":"integer","minimum":0,"maximum":1000000000},"to_call":{"type":"integer","minimum":0,"maximum":1000000000},"unit":{"$ref":"#/components/schemas/Unit"}},"required":["street","pot","hero_stack","to_call","unit"]},"Versions":{"type":"object","additionalProperties":false,"properties":{"engine":{"type":"string","minLength":1,"maxLength":120,"pattern":"^[A-Za-z0-9_-]+$"},"strategy":{"type":"string","minLength":1,"maxLength":120,"pattern":"^[A-Za-z0-9_.-]+$"},"variant":{"type":"string","minLength":1,"maxLength":120,"pattern":"^[A-Za-z0-9_-]+$"},"template":{"anyOf":[{"type":"string","minLength":1,"maxLength":120,"pattern":"^[A-Za-z0-9_-]+$"},{"type":"null"}]},"prompt_sha256":{"anyOf":[{"type":"string","minLength":64,"maxLength":64,"pattern":"^[0-9a-f]{64}$"},{"type":"null"}]},"provider_model":{"anyOf":[{"type":"string","minLength":1,"maxLength":128},{"type":"null"}]}},"required":["engine","strategy","variant","template","prompt_sha256","provider_model"]},"Execution":{"type":"object","additionalProperties":false,"properties":{"route":{"type":"string","enum":["deterministic","model"]},"effort":{"anyOf":[{"type":"string","enum":["low","medium","high"]},{"type":"null"}]},"speed":{"anyOf":[{"type":"string","enum":["standard","priority","ultrafast"]},{"type":"null"}]},"elapsed_ms":{"type":"integer","minimum":0,"maximum":60000},"rule_id":{"anyOf":[{"type":"string","minLength":1,"maxLength":100,"pattern":"^[A-Za-z0-9_-]+$"},{"type":"null"}]},"model":{"anyOf":[{"type":"string","enum":["gpt-6.2-sol","gpt-6.2-astra"]},{"type":"null"}]}},"required":["route","effort","speed","elapsed_ms","rule_id","model"],"allOf":[{"if":{"properties":{"route":{"const":"deterministic"}}},"then":{"properties":{"effort":{"type":"null"},"speed":{"type":"null"},"rule_id":{"type":"string","minLength":1,"maxLength":100,"pattern":"^[A-Za-z0-9_-]+$"},"model":{"type":"null"}}},"else":{"properties":{"effort":{"type":"string","enum":["low","medium","high"]},"speed":{"type":"string","enum":["standard","priority","ultrafast"]},"rule_id":{"type":"null"},"model":{"type":"string","enum":["gpt-6.2-sol","gpt-6.2-astra"]}}}}]},"Result":{"type":"object","additionalProperties":false,"properties":{"decision":{"$ref":"#/components/schemas/Decision"},"facts":{"$ref":"#/components/schemas/DerivedFacts"},"explanation":{"type":"string","minLength":1,"maxLength":2000,"pattern":"^[^\\r\\n]+$"},"evidence_used":{"type":"array","items":{"type":"string","minLength":1,"maxLength":48,"pattern":"^[A-Za-z0-9_-]+$"},"minItems":0,"maxItems":24,"uniqueItems":true},"assumptions":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"text":{"type":"string","minLength":1,"maxLength":400},"basis":{"type":"string","enum":["hypothetical_read","model_estimate","timing_unverified","strategy_prior"]},"evidence_ids":{"type":"array","items":{"type":"string","minLength":1,"maxLength":48,"pattern":"^[A-Za-z0-9_-]+$"},"minItems":0,"maxItems":24,"uniqueItems":true}},"required":["text","basis","evidence_ids"]},"minItems":0,"maxItems":12},"sources":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"reference":{"type":"string","minLength":1,"maxLength":240},"passage":{"type":"string","minLength":1,"maxLength":240},"verification":{"type":"string","enum":["catalog_text_matched"]}},"required":["reference","passage","verification"]},"minItems":0,"maxItems":4},"versions":{"$ref":"#/components/schemas/Versions"},"execution":{"$ref":"#/components/schemas/Execution"}},"required":["decision","facts","explanation","evidence_used","assumptions","sources","versions","execution"]},"Receipt":{"type":"object","additionalProperties":false,"properties":{"request_id":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9_-]+$"},"status":{"type":"string","enum":["pending","completed","failed"]},"created_at":{"type":"string","minLength":1,"maxLength":40,"format":"date-time"},"finished_at":{"anyOf":[{"type":"string","minLength":1,"maxLength":40,"format":"date-time"},{"type":"null"}]},"strategy_version":{"type":"string","minLength":1,"maxLength":120,"pattern":"^[A-Za-z0-9_.-]+$"},"charge":{"anyOf":[{"$ref":"#/components/schemas/Charge"},{"type":"null"}]},"result_availability":{"type":"string","enum":["available","expired","disabled","not_applicable"]},"result_expires_at":{"anyOf":[{"type":"string","minLength":1,"maxLength":40,"format":"date-time"},{"type":"null"}]},"failure_code":{"anyOf":[{"type":"string","enum":["invalid_json","invalid_request","missing_idempotency_key","invalid_credentials","insufficient_scope","insufficient_credits","max_charge_exceeded","not_found","idempotency_conflict","request_in_progress","quote_invalid","payload_too_large","unsupported_media_type","invalid_hand","not_hero_turn","unsupported_ruleset","invalid_evidence","unsupported_options","strategy_unavailable","rate_limited","invalid_model_answer","provider_error","capacity_exceeded","temporarily_unavailable","deadline_exceeded"]},{"type":"null"}]}},"required":["request_id","status","created_at","finished_at","strategy_version","charge","result_availability","result_expires_at","failure_code"],"allOf":[{"if":{"properties":{"status":{"const":"completed"}}},"then":{"properties":{"charge":{"$ref":"#/components/schemas/Charge"},"finished_at":{"type":"string","minLength":1,"maxLength":40,"format":"date-time"},"failure_code":{"type":"null"},"result_availability":{"type":"string","enum":["available","expired","disabled"]}}},"else":{"properties":{"charge":{"type":"null"},"result_availability":{"const":"not_applicable"},"result_expires_at":{"type":"null"}}}}]},"DecisionReply":{"type":"object","additionalProperties":false,"properties":{"receipt":{"$ref":"#/components/schemas/Receipt"},"result":{"anyOf":[{"$ref":"#/components/schemas/Result"},{"type":"null"}]}},"required":["receipt","result"]},"Balance":{"type":"object","additionalProperties":false,"properties":{"currency":{"type":"string","enum":["USD"]},"balance_microusd":{"type":"integer","minimum":-1000000000000,"maximum":1000000000000},"reserved_microusd":{"type":"integer","minimum":0,"maximum":1000000000000},"available_microusd":{"type":"integer","minimum":0,"maximum":1000000000000},"as_of":{"type":"string","minLength":1,"maxLength":40,"format":"date-time"}},"required":["currency","balance_microusd","reserved_microusd","available_microusd","as_of"]},"UsagePage":{"type":"object","additionalProperties":false,"properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/Receipt"},"minItems":0,"maxItems":100},"next_cursor":{"anyOf":[{"type":"string","minLength":1,"maxLength":1500},{"type":"null"}]}},"required":["items","next_cursor"]},"Capabilities":{"type":"object","additionalProperties":false,"properties":{"game":{"type":"string","enum":["nlhe_cash"]},"ruleset":{"type":"string","enum":["standard_v1"]},"units":{"type":"array","items":{"$ref":"#/components/schemas/Unit"},"minItems":1,"maxItems":2,"uniqueItems":true},"min_players":{"type":"integer","minimum":2,"maximum":9},"max_players":{"type":"integer","minimum":2,"maximum":9},"max_request_bytes":{"type":"integer","minimum":1,"maximum":1000000000},"max_actions":{"type":"integer","minimum":1,"maximum":1000000000},"max_evidence":{"type":"integer","minimum":1,"maximum":1000000000},"max_prior_hands":{"type":"integer","minimum":1,"maximum":1000000000},"min_timeout_ms":{"type":"integer","minimum":1,"maximum":1000000000},"max_timeout_ms":{"type":"integer","minimum":1,"maximum":1000000000},"default_timeout_ms":{"type":"integer","minimum":1,"maximum":1000000000},"default_effort":{"type":"string","enum":["low","medium","high"]},"default_speed":{"type":"string","enum":["standard","priority","ultrafast"]},"enabled_options":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"effort":{"type":"string","enum":["low","medium","high"]},"speed":{"type":"string","enum":["standard","priority","ultrafast"]},"model":{"type":"string","enum":["gpt-6.2-sol","gpt-6.2-astra"]}},"required":["effort","speed","model"]},"minItems":0,"maxItems":18},"default_strategy_version":{"type":"string","minLength":1,"maxLength":120,"pattern":"^[A-Za-z0-9_.-]+$"},"strategy_versions":{"type":"array","items":{"type":"string","minLength":1,"maxLength":120,"pattern":"^[A-Za-z0-9_.-]+$"},"minItems":1,"maxItems":100,"uniqueItems":true},"inference_mode":{"type":"string","enum":["local_rules_only","simulated","provider"]},"limits":{"type":"object","additionalProperties":false,"required":["decision_requests_per_minute","max_in_flight"],"properties":{"decision_requests_per_minute":{"type":"integer","minimum":1},"max_in_flight":{"type":"integer","minimum":1}}},"default_model":{"type":"string","enum":["gpt-6.2-sol","gpt-6.2-astra"]}},"required":["game","ruleset","units","min_players","max_players","max_request_bytes","max_actions","max_evidence","max_prior_hands","min_timeout_ms","max_timeout_ms","default_timeout_ms","default_effort","default_speed","enabled_options","default_strategy_version","strategy_versions","default_model"]},"Pricing":{"type":"object","additionalProperties":false,"properties":{"currency":{"type":"string","enum":["USD"]},"price_version":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9_-]+$"},"effective_at":{"type":"string","minLength":1,"maxLength":40,"format":"date-time"},"deterministic_microusd":{"type":"integer","minimum":0,"maximum":1000000000000},"model_prices":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"effort":{"type":"string","enum":["low","medium","high"]},"speed":{"type":"string","enum":["standard","priority","ultrafast"]},"amount_microusd":{"type":"integer","minimum":0,"maximum":1000000000000},"model":{"type":"string","enum":["gpt-6.2-sol","gpt-6.2-astra"]}},"required":["effort","speed","amount_microusd","model"]},"minItems":0,"maxItems":18}},"required":["currency","price_version","effective_at","deterministic_microusd","model_prices"]},"Problem":{"type":"object","additionalProperties":false,"properties":{"type":{"type":"string","minLength":1,"maxLength":300,"format":"uri-reference"},"title":{"type":"string","minLength":1,"maxLength":150},"status":{"type":"integer","minimum":400,"maximum":599},"code":{"type":"string","enum":["invalid_json","invalid_request","missing_idempotency_key","invalid_credentials","insufficient_scope","insufficient_credits","max_charge_exceeded","not_found","idempotency_conflict","request_in_progress","quote_invalid","payload_too_large","unsupported_media_type","invalid_hand","not_hero_turn","unsupported_ruleset","invalid_evidence","unsupported_options","strategy_unavailable","rate_limited","invalid_model_answer","provider_error","capacity_exceeded","temporarily_unavailable","deadline_exceeded"]},"detail":{"type":"string","minLength":1,"maxLength":600},"request_id":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9_-]+$"},"decision_id":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[A-Za-z0-9_-]+$"},"retry":{"type":"string","enum":["none","same_key","poll","new_request"]},"retry_after_seconds":{"type":"integer","minimum":0,"maximum":86400},"violations":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"pointer":{"type":"string","minLength":0,"maxLength":400},"code":{"type":"string","minLength":1,"maxLength":80,"pattern":"^[A-Za-z0-9_-]+$"},"message":{"type":"string","minLength":1,"maxLength":300}},"required":["pointer","code","message"]},"minItems":0,"maxItems":20}},"required":["type","title","status","code","request_id","retry"]},"Health":{"type":"object","additionalProperties":false,"properties":{"status":{"type":"string","enum":["ok"]}},"required":["status"]}}}}