{"openapi":"3.1.0","info":{"title":"ClawBank Business Bench API","description":"ClawBank company-harness evaluation gym (Acme AI SaaS track).","version":"0.1.0"},"paths":{"/healthz":{"get":{"summary":"Health Check","operationId":"health_check_healthz_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":{"type":"string"},"type":"object","title":"Response Health Check Healthz Get"}}}}}}},"/v1/conformance":{"get":{"summary":"Get Conformance Profile","operationId":"get_conformance_profile_v1_conformance_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Get Conformance Profile V1 Conformance Get"}}}}}}},"/llms.txt":{"get":{"summary":"Llms Discovery","operationId":"llms_discovery_llms_txt_get","responses":{"200":{"description":"Successful Response","content":{"text/plain":{"schema":{"type":"string"}}}}}}},"/v1/auth/challenges":{"post":{"summary":"Create Wallet Challenge","operationId":"create_wallet_challenge_v1_auth_challenges_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChallengeRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChallengeResponse"}}}},"422":{"description":"Request validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/auth/verify":{"post":{"summary":"Verify Wallet Challenge","operationId":"verify_wallet_challenge_v1_auth_verify_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChallengeVerification"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuthToken"}}}},"422":{"description":"Request validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/runs":{"post":{"summary":"Create Run","operationId":"create_run_v1_runs_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"idempotency-key","in":"header","required":true,"schema":{"type":"string","minLength":16,"maxLength":128,"title":"Idempotency-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateRunRequest"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunResponse"}}}},"422":{"description":"Request validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/runs/{run_id}":{"get":{"summary":"Get Run","operationId":"get_run_v1_runs__run_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"run_id","in":"path","required":true,"schema":{"type":"string","title":"Run Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunResponse"}}}},"422":{"description":"Request validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/runs/{run_id}/observation":{"get":{"summary":"Get Observation","operationId":"get_observation_v1_runs__run_id__observation_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"run_id","in":"path","required":true,"schema":{"type":"string","title":"Run Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ObservationResponse"}}}},"422":{"description":"Request validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/runs/{run_id}/tools":{"get":{"summary":"List Tools","operationId":"list_tools_v1_runs__run_id__tools_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"run_id","in":"path","required":true,"schema":{"type":"string","title":"Run Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ToolCatalogResponse"}}}},"422":{"description":"Request validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/runs/{run_id}/actions":{"post":{"summary":"Execute Actions","operationId":"execute_actions_v1_runs__run_id__actions_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"run_id","in":"path","required":true,"schema":{"type":"string","title":"Run Id"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":16,"maxLength":128,"title":"Idempotency-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ActionBatchRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ActionBatchResponse"}}}},"400":{"description":"Tool is not published for hosted execution","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Run not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"Run state, sequence, or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Request validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Run worker unavailable or invalid","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/runs/{run_id}/advance":{"post":{"summary":"Advance Run","operationId":"advance_run_v1_runs__run_id__advance_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"run_id","in":"path","required":true,"schema":{"type":"string","title":"Run Id"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":16,"maxLength":128,"title":"Idempotency-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdvanceRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ObservationResponse"}}}},"404":{"description":"Run not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"Run state, sequence, or idempotency conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Request validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Run worker unavailable or invalid","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/runs/{run_id}/cancel":{"post":{"summary":"Cancel Run","operationId":"cancel_run_v1_runs__run_id__cancel_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"run_id","in":"path","required":true,"schema":{"type":"string","title":"Run Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunResponse"}}}},"404":{"description":"Run not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"Run already terminal","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Request validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Run cleanup failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/runs/{run_id}/score":{"get":{"summary":"Get Score","operationId":"get_score_v1_runs__run_id__score_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"run_id","in":"path","required":true,"schema":{"type":"string","title":"Run Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScoreReport"}}}},"404":{"description":"Run not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"Results unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Request validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Terminal artifacts invalid","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/runs/{run_id}/trajectory":{"get":{"summary":"Get Trajectory","operationId":"get_trajectory_v1_runs__run_id__trajectory_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"run_id","in":"path","required":true,"schema":{"type":"string","title":"Run Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TrajectoryResponse"}}}},"404":{"description":"Run not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"Results unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Request validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Terminal artifacts invalid","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}},"components":{"schemas":{"ActionBatchRequest":{"properties":{"sequence":{"type":"integer","minimum":0.0,"title":"Sequence"},"actions":{"items":{"$ref":"#/components/schemas/ActionRequest"},"type":"array","maxItems":1,"minItems":1,"title":"Actions"}},"additionalProperties":false,"type":"object","required":["sequence","actions"],"title":"ActionBatchRequest"},"ActionBatchResponse":{"properties":{"run_id":{"type":"string","title":"Run Id"},"sequence":{"type":"integer","title":"Sequence"},"results":{"items":{"$ref":"#/components/schemas/ActionResult"},"type":"array","title":"Results"}},"type":"object","required":["run_id","sequence","results"],"title":"ActionBatchResponse"},"ActionRequest":{"properties":{"tool":{"type":"string","title":"Tool"},"arguments":{"additionalProperties":true,"type":"object","title":"Arguments"}},"additionalProperties":false,"type":"object","required":["tool"],"title":"ActionRequest"},"ActionResult":{"properties":{"tool":{"type":"string","minLength":1,"title":"Tool"},"success":{"type":"boolean","title":"Success"},"output":{"type":"string","minLength":1,"title":"Output"},"data":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Data"}},"additionalProperties":false,"type":"object","required":["tool","success","output"],"title":"ActionResult"},"AdvanceRequest":{"properties":{"sequence":{"type":"integer","minimum":0.0,"title":"Sequence"},"rationale":{"type":"string","maxLength":10000,"minLength":1,"pattern":"^[\\s\\S]*\\S[\\s\\S]*$","title":"Rationale"},"forecasts":{"items":{"$ref":"#/components/schemas/Forecast"},"type":"array","maxItems":4,"minItems":4,"title":"Forecasts","description":"Exactly the horizons 7, 28, 84, and 182 in that order."}},"additionalProperties":false,"type":"object","required":["sequence","rationale","forecasts"],"title":"AdvanceRequest"},"AuthToken":{"properties":{"access_token":{"type":"string","title":"Access Token"},"token_type":{"type":"string","title":"Token Type"},"expires_at":{"type":"string","title":"Expires At"},"participant":{"$ref":"#/components/schemas/WalletIdentity"}},"type":"object","required":["access_token","token_type","expires_at","participant"],"title":"AuthToken"},"ChallengeRequest":{"properties":{"wallet_namespace":{"type":"string","title":"Wallet Namespace"},"chain_id":{"type":"string","title":"Chain Id"},"wallet_address":{"type":"string","title":"Wallet Address"},"benchmark_version":{"type":"string","title":"Benchmark Version"}},"additionalProperties":false,"type":"object","required":["wallet_namespace","chain_id","wallet_address","benchmark_version"],"title":"ChallengeRequest"},"ChallengeResponse":{"properties":{"challenge_id":{"type":"string","title":"Challenge Id"},"message":{"type":"string","title":"Message"},"nonce":{"type":"string","title":"Nonce"},"expires_at":{"type":"string","title":"Expires At"}},"type":"object","required":["challenge_id","message","nonce","expires_at"],"title":"ChallengeResponse"},"ChallengeVerification":{"properties":{"challenge_id":{"type":"string","title":"Challenge Id"},"wallet_address":{"type":"string","title":"Wallet Address"},"signature":{"type":"string","title":"Signature"}},"additionalProperties":false,"type":"object","required":["challenge_id","wallet_address","signature"],"title":"ChallengeVerification"},"CreateRunRequest":{"properties":{"benchmark_version":{"type":"string","title":"Benchmark Version"},"track":{"type":"string","enum":["practice","scored"],"title":"Track"},"participant_manifest":{"$ref":"#/components/schemas/ParticipantManifest"},"scenario_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Scenario Id"}},"additionalProperties":false,"type":"object","required":["benchmark_version","track","participant_manifest"],"title":"CreateRunRequest"},"ErrorResponse":{"properties":{"detail":{"type":"string","title":"Detail"}},"additionalProperties":false,"type":"object","required":["detail"],"title":"ErrorResponse"},"Forecast":{"properties":{"horizon_days":{"type":"integer","enum":[7,28,84,182],"title":"Horizon Days"},"point":{"type":"number","title":"Point"},"lower":{"type":"number","title":"Lower"},"upper":{"type":"number","title":"Upper"}},"additionalProperties":false,"type":"object","required":["horizon_days","point","lower","upper"],"title":"Forecast","description":"Cash-balance forecast in dollars with a 95% confidence interval."},"JsonValue":{},"ObservationResponse":{"properties":{"run_id":{"type":"string","title":"Run Id"},"sequence":{"type":"integer","title":"Sequence"},"simulated_day":{"type":"integer","title":"Simulated Day"},"status":{"type":"string","title":"Status"},"data":{"additionalProperties":true,"type":"object","title":"Data"},"notifications":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Notifications","default":[]}},"type":"object","required":["run_id","sequence","simulated_day","status","data"],"title":"ObservationResponse"},"ParticipantManifest":{"properties":{"name":{"type":"string","title":"Name"},"framework":{"type":"string","title":"Framework"},"framework_version":{"type":"string","title":"Framework Version"},"models":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Models"},"adapter_version":{"type":"string","title":"Adapter Version"},"memory_mode":{"type":"string","title":"Memory Mode"},"network_mode":{"type":"string","title":"Network Mode"}},"additionalProperties":false,"type":"object","required":["name","framework","framework_version","adapter_version","memory_mode","network_mode"],"title":"ParticipantManifest"},"RunResponse":{"properties":{"run_id":{"type":"string","title":"Run Id"},"participant":{"$ref":"#/components/schemas/WalletIdentity"},"benchmark_version":{"type":"string","title":"Benchmark Version"},"scenario_version":{"type":"string","title":"Scenario Version"},"track":{"type":"string","title":"Track"},"status":{"type":"string","title":"Status"},"sequence":{"type":"integer","title":"Sequence"},"simulated_day":{"type":"integer","title":"Simulated Day"},"created_at":{"type":"string","title":"Created At"},"completed_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Completed At"},"participant_manifest":{"$ref":"#/components/schemas/ParticipantManifest"}},"type":"object","required":["run_id","participant","benchmark_version","scenario_version","track","status","sequence","simulated_day","created_at","participant_manifest"],"title":"RunResponse"},"ScoreReport":{"properties":{"run_id":{"type":"string","title":"Run Id"},"participant":{"$ref":"#/components/schemas/WalletIdentity"},"benchmark_version":{"type":"string","title":"Benchmark Version"},"scenario_version":{"type":"string","title":"Scenario Version"},"track":{"type":"string","enum":["practice","scored"],"title":"Track"},"score_version":{"type":"string","title":"Score Version"},"terminal_state":{"type":"string","enum":["completed","bankrupt"],"title":"Terminal State"},"primary_score":{"type":"number","title":"Primary Score"},"score_components":{"additionalProperties":{"type":"number"},"type":"object","title":"Score Components"},"completed_at":{"type":"string","title":"Completed At"},"manifest_digest":{"type":"string","pattern":"^[0-9a-f]{64}$","title":"Manifest Digest"},"final_ledger_digest":{"type":"string","pattern":"^[0-9a-f]{64}$","title":"Final Ledger Digest"},"trajectory_digest":{"type":"string","pattern":"^[0-9a-f]{64}$","title":"Trajectory Digest"},"receipt":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$","title":"Receipt"},"signature_status":{"type":"string","const":"pending","title":"Signature Status"}},"additionalProperties":false,"type":"object","required":["run_id","participant","benchmark_version","scenario_version","track","score_version","terminal_state","primary_score","score_components","completed_at","manifest_digest","final_ledger_digest","trajectory_digest","receipt","signature_status"],"title":"ScoreReport"},"ToolCatalogResponse":{"properties":{"benchmark_version":{"type":"string","title":"Benchmark Version"},"tools":{"items":{"$ref":"#/components/schemas/ToolDescriptor"},"type":"array","title":"Tools"}},"type":"object","required":["benchmark_version","tools"],"title":"ToolCatalogResponse"},"ToolDescriptor":{"properties":{"name":{"type":"string","title":"Name"},"description":{"type":"string","title":"Description"},"input_schema":{"additionalProperties":true,"type":"object","title":"Input Schema"}},"type":"object","required":["name","description","input_schema"],"title":"ToolDescriptor"},"TrajectoryResponse":{"properties":{"run_id":{"type":"string","title":"Run Id"},"terminal_state":{"type":"string","enum":["completed","bankrupt"],"title":"Terminal State"},"sequence":{"type":"integer","minimum":0.0,"title":"Sequence"},"simulated_day":{"type":"integer","minimum":0.0,"title":"Simulated Day"},"trajectory_digest":{"type":"string","pattern":"^[0-9a-f]{64}$","title":"Trajectory Digest"},"events":{"items":{"additionalProperties":{"$ref":"#/components/schemas/JsonValue"},"type":"object"},"type":"array","maxItems":2048,"title":"Events"},"daily_cash":{"items":{"additionalProperties":{"$ref":"#/components/schemas/JsonValue"},"type":"object"},"type":"array","maxItems":3651,"title":"Daily Cash"}},"additionalProperties":false,"type":"object","required":["run_id","terminal_state","sequence","simulated_day","trajectory_digest","events","daily_cash"],"title":"TrajectoryResponse"},"WalletIdentity":{"properties":{"wallet_namespace":{"type":"string","title":"Wallet Namespace"},"chain_id":{"type":"string","title":"Chain Id"},"wallet_address":{"type":"string","title":"Wallet Address"}},"type":"object","required":["wallet_namespace","chain_id","wallet_address"],"title":"WalletIdentity"}},"securitySchemes":{"HTTPBearer":{"type":"http","scheme":"bearer"}}}}