{"openapi":"3.1.0","info":{"title":"ORO API","description":"ORO Backend API with authentication, rate limiting, and cooldowns.","version":"0.1.0"},"paths":{"/health":{"get":{"tags":["public","health"],"summary":"Health Check","description":"Shallow liveness check. Confirms the process is up; does not\nexercise the DB pool. Kept available as a release valve in case\nwe need to flip the ALB target group back during an RDS incident.","operationId":"health_check","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Health Check"}}}}}}},"/health/deep":{"get":{"tags":["public","health"],"summary":"Deep Health Check","description":"Deep readiness check that exercises the SQLAlchemy pool (ORO-1121).\n\nAcquires a session and runs SELECT 1 with a hard timeout, retrying\nonce on failure to ride out transient pool stalls or one-shot\nnetwork blips (ORO-1168). If the pool is wedged (phantom-checked-out\nslots) or RDS is unreachable across both attempts, the check fails\nand the ALB pulls the task out of rotation after its own\nunhealthy_threshold_count consecutive failures.\n\nOn final failure we return 503 directly via `JSONResponse` instead\nof raising `HTTPException`. The status to the ALB is identical, but\nthe Sentry FastAPI integration only captures *exceptions* — so this\npath no longer triggers the \"new unhandled error\" PD rule on a\ntransient blip. Sustained DB-unreachable is correctly surfaced by\nthe ALB target-health alarm, not the Sentry new-issue rule.","operationId":"deep_health_check","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/public/suites":{"get":{"tags":["public"],"summary":"List all suites","description":"Get all problem suites, ordered by version descending (newest first).","operationId":"list_suites","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/SuitePublic"},"type":"array","title":"Response List Suites"}}}}}}},"/v1/public/suites/current":{"get":{"tags":["public"],"summary":"Get current active suite","description":"Fetch the currently active problem suite.","operationId":"get_current_suite","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuitePublic"}}}},"404":{"description":"No active suite found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuiteNotFoundError"}}}}}}},"/v1/public/suites/{suite_id}/problems":{"get":{"tags":["public"],"summary":"Get suite problems","description":"Get the list of problems for a specific suite.","operationId":"get_suite_problems","parameters":[{"name":"suite_id","in":"path","required":true,"schema":{"type":"integer","description":"Suite ID/version","title":"Suite Id"},"description":"Suite ID/version"},{"name":"include_embeddings","in":"query","required":false,"schema":{"type":"boolean","description":"Include precomputed reward_title_embeddings in metadata. Off by default to keep responses small (~50 KB vs ~1.5 MB).","default":false,"title":"Include Embeddings"},"description":"Include precomputed reward_title_embeddings in metadata. Off by default to keep responses small (~50 KB vs ~1.5 MB)."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuiteWithProblemsResponse"}}}},"404":{"description":"Suite not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuiteNotFoundError"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/public/leaderboard":{"get":{"tags":["public"],"summary":"Get leaderboard","description":"Get the eligible agent leaderboard for a suite.","operationId":"get_leaderboard","parameters":[{"name":"suite_id","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Suite ID (defaults to current)","title":"Suite Id"},"description":"Suite ID (defaults to current)"},{"name":"score_type","in":"query","required":false,"schema":{"type":"string","description":"Which score to rank by","default":"qualifying","title":"Score Type"},"description":"Which score to rank by"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"description":"Maximum entries to return","default":100,"title":"Limit"},"description":"Maximum entries to return"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"Offset for pagination","default":0,"title":"Offset"},"description":"Offset for pagination"},{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"description":"Filter by agent name (case-insensitive substring) or miner hotkey (case-insensitive prefix). Empty/whitespace is ignored.","title":"Q"},"description":"Filter by agent name (case-insensitive substring) or miner hotkey (case-insensitive prefix). Empty/whitespace is ignored."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LeaderboardResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/public/top":{"get":{"tags":["public"],"summary":"Get top agent for emissions","description":"Get the canonical top miner for emissions calculation.","operationId":"get_top_agent","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TopAgentResponse"}}}}}}},"/v1/public/top-miner-payout":{"get":{"tags":["public"],"summary":"Get top miner payout rate","description":"Get the current top miner's estimated emission payout rate in TAO/day and USD/day. Uses the cached metagraph and a periodically refreshed TAO/USD price.","operationId":"get_top_miner_payout","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TopMinerPayoutResponse"}}}}}}},"/v1/public/top/history":{"get":{"tags":["public"],"summary":"Get top agent history","description":"Get all agents that have held top agent status for a suite.","operationId":"get_top_history","parameters":[{"name":"suite_id","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Suite ID (omit for all suites)","title":"Suite Id"},"description":"Suite ID (omit for all suites)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TopHistoryResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/public/agent-versions/{agent_version_id}/status":{"get":{"tags":["public"],"summary":"Get agent version status","description":"Get live status and counters for an agent version.","operationId":"get_agent_version_status","parameters":[{"name":"agent_version_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Agent version ID","title":"Agent Version Id"},"description":"Agent version ID"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentVersionStatus"}}}},"404":{"description":"Agent version not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentVersionNotFoundError"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/public/agent-versions/{agent_version_id}/runs":{"get":{"tags":["public"],"summary":"Get agent version runs","description":"Get evaluation runs for an agent version.","operationId":"get_agent_version_runs","parameters":[{"name":"agent_version_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Agent version ID","title":"Agent Version Id"},"description":"Agent version ID"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/EvaluationRunPublic"},"title":"Response Get Agent Version Runs"}}}},"404":{"description":"Agent version not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentVersionNotFoundError"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/public/agent-versions/{agent_version_id}/problems":{"get":{"tags":["public"],"summary":"Get agent version problem progress","description":"Get per-problem progress matrix across validators.","operationId":"get_agent_version_problems","parameters":[{"name":"agent_version_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Agent version ID","title":"Agent Version Id"},"description":"Agent version ID"},{"name":"phase","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by evaluation phase (QUALIFYING or RACE)","title":"Phase"},"description":"Filter by evaluation phase (QUALIFYING or RACE)"},{"name":"race_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"description":"Filter to a specific race (implies phase=RACE)","title":"Race Id"},"description":"Filter to a specific race (implies phase=RACE)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentVersionProblemsResponse"}}}},"404":{"description":"Agent version not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentVersionNotFoundError"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/public/agent-versions/{agent_version_id}":{"get":{"tags":["public"],"summary":"Get agent version details","description":"Get released public details for an agent version.","operationId":"get_agent_version","parameters":[{"name":"agent_version_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Agent version ID","title":"Agent Version Id"},"description":"Agent version ID"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentVersionPublic"}}}},"404":{"description":"Not found or not released","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/AgentVersionNotFoundError"},{"$ref":"#/components/schemas/SuiteNotFoundError"},{"$ref":"#/components/schemas/ArtifactNotReleasedError"}],"title":"Response 404 Get Agent Version"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/public/artifacts/download-url":{"post":{"tags":["public"],"summary":"Get artifact download URL","description":"Get a presigned URL to download artifacts. Agent code requires the version to be released. Trajectories and logs are available immediately.","operationId":"get_artifact_download_url","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ArtifactDownloadRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ArtifactDownloadResponse"}}}},"400":{"description":"Invalid request parameters","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/MissingParameterError"},{"$ref":"#/components/schemas/InvalidArtifactTypeError"}],"title":"Response 400 Get Artifact Download Url"}}}},"404":{"description":"Not found or not released","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/AgentVersionNotFoundError"},{"$ref":"#/components/schemas/SuiteNotFoundError"},{"$ref":"#/components/schemas/ArtifactNotReleasedError"},{"$ref":"#/components/schemas/ArtifactNotFoundError"},{"$ref":"#/components/schemas/EvalRunNotFoundError"}],"title":"Response 404 Get Artifact Download Url"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/public/evaluation-runs/{eval_run_id}":{"get":{"tags":["public"],"summary":"Get evaluation run details","description":"Get detailed information about a specific evaluation run.","operationId":"get_evaluation_run","parameters":[{"name":"eval_run_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Evaluation run ID","title":"Eval Run Id"},"description":"Evaluation run ID"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EvaluationRunDetail"}}}},"404":{"description":"Evaluation run not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EvalRunNotFoundError"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/public/validators":{"get":{"tags":["public"],"summary":"Get list of validators","description":"Get all non-banned validators with their current status.","operationId":"get_validators","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/ValidatorPublic"},"type":"array","title":"Response Get Validators"}}}}}}},"/v1/public/evaluations/running":{"get":{"tags":["public"],"summary":"Get running evaluations","description":"Get all currently running or claimed evaluations.","operationId":"get_running_evaluations","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/RunningEvaluation"},"type":"array","title":"Response Get Running Evaluations"}}}}}}},"/v1/public/evaluations/pending":{"get":{"tags":["public"],"summary":"Get pending evaluations","description":"Get all open work items awaiting validator evaluations, with queue summary.","operationId":"get_pending_evaluations","parameters":[{"name":"suite_id","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Filter by problem suite ID","title":"Suite Id"},"description":"Filter by problem suite ID"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"description":"Maximum items to return","default":100,"title":"Limit"},"description":"Maximum items to return"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"Number of items to skip","default":0,"title":"Offset"},"description":"Number of items to skip"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PendingEvaluationsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/public/races/current":{"get":{"tags":["public"],"summary":"Get current race","description":"Get the active race for the current suite, if any.","operationId":"get_current_race","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RaceCurrentResponse"}}}}}}},"/v1/public/races/history":{"get":{"tags":["public"],"summary":"Get race history","description":"Get completed and cancelled races, most recent first.","operationId":"get_race_history","parameters":[{"name":"suite_id","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Filter by suite ID","title":"Suite Id"},"description":"Filter by suite ID"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"Page size","default":20,"title":"Limit"},"description":"Page size"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"Page offset","default":0,"title":"Offset"},"description":"Page offset"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RaceHistoryResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/public/races/{race_id}":{"get":{"tags":["public"],"summary":"Get race details","description":"Get details for a specific race including qualifiers and results.","operationId":"get_race_detail","parameters":[{"name":"race_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Race ID","title":"Race Id"},"description":"Race ID"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RaceDetailResponse"}}}},"404":{"description":"Race not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RaceNotFoundError"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/public/waitlist":{"post":{"tags":["public"],"summary":"Join waitlist","description":"Submit an email to join the ORO waitlist.","operationId":"join_waitlist","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WaitlistSignupRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WaitlistSignupResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/public/inference/models":{"get":{"tags":["public"],"summary":"List allowed inference models","description":"Returns the models available to ORO agents via the inference proxy. Defaults to a flat array of model IDs (provider's static allowlist). Set ``?ranked=true`` to receive models in load-/health-sorted order with per-model stats from the most recent provider poll.\n\n**Chutes-deprecated models (still in the Chutes allowlist for miner compatibility, but Chutes no longer serves them — route via OpenRouter):**\n- `deepseek-ai/DeepSeek-V3.1-TEE`\n- `deepseek-ai/DeepSeek-V3-0324-TEE`\n- `deepseek-ai/DeepSeek-R1-0528-TEE`\n- `XiaomiMiMo/MiMo-V2-Flash-TEE`","operationId":"get_inference_models","parameters":[{"name":"provider","in":"query","required":false,"schema":{"type":"string","default":"chutes","title":"Provider"}},{"name":"ranked","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Ranked"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/InferenceModelsResponse"},{"$ref":"#/components/schemas/RankedInferenceModelsResponse"}],"title":"Response Get Inference Models"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/auth/challenge":{"post":{"tags":["auth"],"summary":"Request Challenge","description":"Request a challenge for wallet authentication.\n\nThe challenge must be signed by the wallet and submitted to /session\nwithin 60 seconds.\n\nRate limited to 10 requests per minute per IP to prevent abuse.","operationId":"request_challenge","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChallengeRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChallengeResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/auth/session":{"post":{"tags":["auth"],"summary":"Create Session Endpoint","description":"Create a session by verifying a signed challenge.\n\nThe challenge must have been requested within the last 60 seconds\nand the signature must be valid for the challenge message.\n\nRate limited to 5 requests per minute per IP to prevent brute force.","operationId":"create_session_endpoint","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SessionRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SessionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/auth/logout":{"post":{"tags":["auth"],"summary":"Logout","description":"Logout and invalidate the current session.","operationId":"logout","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LogoutResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/miner/submit":{"post":{"tags":["miner"],"summary":"Submit agent","description":"Submit an agent file for evaluation. Creates new agent if needed.","operationId":"submit_agent","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_submit_agent"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubmitAgentResponse"}}}},"400":{"description":"Invalid agent name or file content","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/InvalidAgentNameError"},{"$ref":"#/components/schemas/InvalidFileError"}],"title":"Response 400 Submit Agent"}}}},"413":{"description":"File too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FileTooLargeError"}}}},"422":{"description":"Code failed static analysis checks","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CodeAnalysisError"}}}},"429":{"description":"Rate limited or cooldown active","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/CooldownActiveError"},{"$ref":"#/components/schemas/RateLimitExceededError"}],"title":"Response 429 Submit Agent"}}}},"503":{"description":"No active suite, or cross-miner similarity check is temporarily unavailable","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/NoActiveSuiteError"},{"$ref":"#/components/schemas/SimilarityCheckUnavailableError"}],"title":"Response 503 Submit Agent"}}}}}}},"/v1/miner/inference-auth/{provider}":{"post":{"tags":["miner"],"summary":"Store an inference-provider credential","description":"Store (or overwrite) the miner's credential for the given provider.\n\nValidates the credential before persisting so bad input fails here rather\nthan at first claim_work. The first stored provider becomes the miner's\ndefault; switching default afterward goes through the dedicated PATCH\nendpoint.","operationId":"store_inference_credential","parameters":[{"name":"provider","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":32,"title":"Provider"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StoreInferenceCredentialRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":{"type":"boolean"},"title":"Response Store Inference Credential"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["miner"],"summary":"Check inference auth status for a single provider","description":"Check whether the miner has a stored credential for the given provider.","operationId":"get_inference_auth_status_one","parameters":[{"name":"provider","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":32,"title":"Provider"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InferenceAuthStatusResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["miner"],"summary":"Disconnect an inference-provider credential","description":"Delete the miner's stored credential for the given provider.\n\nIf the deleted provider was the miner's default, the default falls back\nto whichever other provider is still connected, or clears to NULL when\nnone remain. Returns the new default so the client can update without a\nfollow-up GET.","operationId":"delete_inference_credential","parameters":[{"name":"provider","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":32,"title":"Provider"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":{"anyOf":[{"type":"string"},{"type":"null"}]},"title":"Response Delete Inference Credential"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/miner/inference-auth":{"get":{"tags":["miner"],"summary":"List all inference-auth providers the miner has connected","description":"List every provider the authenticated miner currently has a credential for.","operationId":"list_inference_auth","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InferenceAuthListResponse"}}}}}}},"/v1/miner/inference-auth/default":{"patch":{"tags":["miner"],"summary":"Set the miner's default inference provider","description":"Set which provider claim_work should mint a token from for this miner.","operationId":"set_default_inference_provider","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SetDefaultProviderRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":{"anyOf":[{"type":"string"},{"type":"null"}]},"type":"object","title":"Response Set Default Inference Provider"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/miner/chutes-auth":{"post":{"tags":["miner"],"summary":"Store Chutes OAuth refresh token (legacy — use /inference-auth/chutes)","description":"Back-compat shim. Routes through the new inference-auth path so older\nFrontend builds keep populating the new table during the deploy window.","operationId":"store_chutes_token","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StoreChutesTokenRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":{"type":"boolean"},"type":"object","title":"Response Store Chutes Token"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"deprecated":true}},"/v1/miner/chutes-auth/status":{"get":{"tags":["miner"],"summary":"Check Chutes auth status (legacy — use /inference-auth/chutes)","description":"Back-compat shim. Reads from the new MinerInferenceAuth table.","operationId":"get_chutes_auth_status","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChutesAuthStatusResponse"}}}}},"deprecated":true}},"/v1/miner/agents":{"get":{"tags":["miner"],"summary":"List miner's agents","description":"List all agents owned by the authenticated miner, with cooldown status.\n\nIncludes the latest version per agent with its state and score so the\nfrontend doesn't need to make N additional requests.","operationId":"list_miner_agents","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MinerAgentsResponse"}}}}}}},"/v1/miner/agents/{agent_id}/versions":{"get":{"tags":["miner"],"summary":"List agent versions","description":"List all versions of a specific agent owned by the miner.","operationId":"list_agent_versions","parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Agent ID","title":"Agent Id"},"description":"Agent ID"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/AgentVersionHistoryEntry"},"title":"Response List Agent Versions"}}}},"404":{"description":"Agent not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentNotFoundError"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/miner/agent-versions/{agent_version_id}":{"get":{"tags":["miner"],"summary":"Get agent version status","description":"Get detailed status of a specific agent version owned by the miner.","operationId":"get_owned_agent_version_status","parameters":[{"name":"agent_version_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Agent version ID","title":"Agent Version Id"},"description":"Agent version ID"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentVersionStatus"}}}},"404":{"description":"Agent version not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentVersionNotFoundError"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/miner/race-selection":{"put":{"tags":["miner"],"summary":"Pin agent version as race candidate","description":"Pin the given agent version as this miner's race candidate.","operationId":"set_race_selection","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MinerRaceSelectionRequest"}}},"required":true},"responses":{"204":{"description":"Successful Response"},"400":{"description":"Selected version cannot be pinned as the race candidate"},"403":{"description":"Version is not owned by the authenticated miner","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotVersionOwnerError"}}}},"409":{"description":"Race is in progress; selection writes are locked","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RaceLockedError"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["miner"],"summary":"Clear pinned race candidate","description":"Clear the miner's pinned race candidate so the auto-pick is used.","operationId":"clear_race_selection","responses":{"204":{"description":"Successful Response"},"404":{"description":"No race selection currently exists","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NoSelectionError"}}}},"409":{"description":"Race is in progress; selection writes are locked","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RaceLockedError"}}}}}}},"/v1/validator/work/claim":{"post":{"tags":["validator"],"summary":"Claim evaluation work","description":"FIFO claim of next available evaluation work item.","operationId":"claim_work","requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/HeartbeatRequest"},{"type":"null"}],"title":"Request"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClaimWorkResponse"}}}},"204":{"description":"No work available"},"409":{"description":"Validator at capacity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AtCapacityError"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/validator/evaluation-runs/{eval_run_id}/heartbeat":{"post":{"tags":["validator"],"summary":"Extend lease","description":"Heartbeat to extend lease and mark run as RUNNING.","operationId":"heartbeat","parameters":[{"name":"eval_run_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Evaluation run ID","title":"Eval Run Id"},"description":"Evaluation run ID"}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/HeartbeatRequest"},{"type":"null"}],"title":"Request"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HeartbeatResponse"}}}},"404":{"description":"Run not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EvalRunNotFoundError"}}}},"409":{"description":"Lease expired, not owner, or already complete","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/LeaseExpiredError"},{"$ref":"#/components/schemas/NotRunOwnerError"},{"$ref":"#/components/schemas/RunAlreadyCompleteError"}],"title":"Response 409 Heartbeat"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/validator/evaluation-runs/{eval_run_id}/progress":{"post":{"tags":["validator"],"summary":"Update progress","description":"Report per-problem progress during evaluation.","operationId":"update_progress","parameters":[{"name":"eval_run_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Evaluation run ID","title":"Eval Run Id"},"description":"Evaluation run ID"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProgressUpdateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProgressUpdateResponse"}}}},"400":{"description":"Invalid problem ID","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InvalidProblemIdError"}}}},"404":{"description":"Run not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EvalRunNotFoundError"}}}},"409":{"description":"Not the run owner, or run already completed","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/NotRunOwnerError"},{"$ref":"#/components/schemas/RunAlreadyCompleteError"}],"title":"Response 409 Update Progress"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/validator/uploads/presign":{"post":{"tags":["validator"],"summary":"Get upload URL","description":"Get a presigned URL for uploading per-problem evaluation logs.","operationId":"presign_upload","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PresignUploadRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PresignUploadResponse"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/FileTooLargeError"},{"$ref":"#/components/schemas/ValidationErrorError"}],"title":"Response 400 Presign Upload"}}}},"404":{"description":"Run or problem not found","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/EvalRunNotFoundError"},{"$ref":"#/components/schemas/ProblemNotFoundError"}],"title":"Response 404 Presign Upload"}}}},"409":{"description":"Not owner of run","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotRunOwnerError"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/validator/evaluation-runs/{eval_run_id}/complete":{"post":{"tags":["validator"],"summary":"Complete evaluation run","description":"Finalize an evaluation run with terminal status and score.","operationId":"complete_run","parameters":[{"name":"eval_run_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Evaluation run ID","title":"Eval Run Id"},"description":"Evaluation run ID"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompleteRunRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompleteRunResponse"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/MissingScoreError"},{"$ref":"#/components/schemas/ValidationErrorError"}],"title":"Response 400 Complete Run"}}}},"404":{"description":"Run not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EvalRunNotFoundError"}}}},"409":{"description":"Not owner or already complete","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/NotRunOwnerError"},{"$ref":"#/components/schemas/RunAlreadyCompleteError"}],"title":"Response 409 Complete Run"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/validator/evaluation-runs/{eval_run_id}/problems":{"get":{"tags":["validator"],"summary":"Get problems for an evaluation run","description":"Returns the problems that should be evaluated for a given run.","operationId":"get_run_problems","parameters":[{"name":"eval_run_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Evaluation run ID","title":"Eval Run Id"},"description":"Evaluation run ID"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunProblemsResponse"}}}},"404":{"description":"Run not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EvalRunNotFoundError"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/admin/miners/{miner_hotkey}/ban":{"post":{"tags":["admin"],"summary":"Ban a miner","description":"Ban a miner from submitting agents.","operationId":"ban_miner","parameters":[{"name":"miner_hotkey","in":"path","required":true,"schema":{"type":"string","description":"Miner hotkey to ban","title":"Miner Hotkey"},"description":"Miner hotkey to ban"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BanRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BanResponse"}}}},"404":{"description":"Miner not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MinerNotFoundError"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/admin/miners/{miner_hotkey}/unban":{"post":{"tags":["admin"],"summary":"Unban a miner","description":"Unban a miner, allowing them to submit agents again.","operationId":"unban_miner","parameters":[{"name":"miner_hotkey","in":"path","required":true,"schema":{"type":"string","description":"Miner hotkey to unban","title":"Miner Hotkey"},"description":"Miner hotkey to unban"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BanResponse"}}}},"404":{"description":"Miner not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MinerNotFoundError"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/admin/validators/{validator_hotkey}/ban":{"post":{"tags":["admin"],"summary":"Ban a validator","description":"Ban a validator from claiming work. Revokes any active inference tokens.","operationId":"ban_validator","parameters":[{"name":"validator_hotkey","in":"path","required":true,"schema":{"type":"string","description":"Validator hotkey to ban","title":"Validator Hotkey"},"description":"Validator hotkey to ban"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BanRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BanResponse"}}}},"404":{"description":"Validator not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidatorNotFoundError"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/admin/validators/{validator_hotkey}/unban":{"post":{"tags":["admin"],"summary":"Unban a validator","description":"Unban a validator, allowing them to claim work again.","operationId":"unban_validator","parameters":[{"name":"validator_hotkey","in":"path","required":true,"schema":{"type":"string","description":"Validator hotkey to unban","title":"Validator Hotkey"},"description":"Validator hotkey to unban"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BanResponse"}}}},"404":{"description":"Validator not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidatorNotFoundError"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/admin/validators/{validator_hotkey}":{"patch":{"tags":["admin"],"summary":"Update validator configuration","description":"Update validator configuration. Currently supports `max_concurrent_runs`.","operationId":"update_validator","parameters":[{"name":"validator_hotkey","in":"path","required":true,"schema":{"type":"string","description":"Validator hotkey to update","title":"Validator Hotkey"},"description":"Validator hotkey to update"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateValidatorRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminValidatorEntry"}}}},"404":{"description":"Validator not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidatorNotFoundError"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/admin/agent-versions/{agent_version_id}/discard":{"post":{"tags":["admin"],"summary":"Discard an agent version from leaderboard","description":"Discard an agent version from the leaderboard (reversible tombstone).\n\nAlso cancels any active evaluation runs and closes the work item\nto prevent the validator from claiming new work for this version.","operationId":"discard_agent_version","parameters":[{"name":"agent_version_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Agent version ID","title":"Agent Version Id"},"description":"Agent version ID"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DiscardRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DiscardResponse"}}}},"404":{"description":"Agent version not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentVersionNotFoundError"}}}},"503":{"description":"No active suite","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NoActiveSuiteError"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/admin/agent-versions/{agent_version_id}/reinstate":{"post":{"tags":["admin"],"summary":"Reinstate a discarded agent version","description":"Reinstate a previously discarded agent version.\n\nAlso reopens the work item so validators can claim work again.","operationId":"reinstate_agent_version","parameters":[{"name":"agent_version_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Agent version ID","title":"Agent Version Id"},"description":"Agent version ID"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReinstateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DiscardResponse"}}}},"404":{"description":"Agent version not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentVersionNotFoundError"}}}},"503":{"description":"No active suite","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NoActiveSuiteError"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/admin/agent-versions/{agent_version_id}/eliminate":{"post":{"tags":["admin"],"summary":"Eliminate an agent version (admin override)","description":"Stamp `eliminated_at` on the aggregate so the version is removed from\nfuture qualifying.\n\nCounterpart to `reinstate-elimination`. Used to test the admission\ncascade end-to-end and to manually retire an agent that should no\nlonger race (e.g. confirmed cheating before a natural race-loss).\n\nIdempotent on `eliminated_at`: re-running stamps the same row with a\nfresh timestamp.","operationId":"eliminate_agent_version","parameters":[{"name":"agent_version_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Agent version ID","title":"Agent Version Id"},"description":"Agent version ID"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EliminateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EliminateResponse"}}}},"404":{"description":"Agent version not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentVersionNotFoundError"}}}},"503":{"description":"No active suite","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NoActiveSuiteError"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/admin/agent-versions/{agent_version_id}/reinstate-elimination":{"post":{"tags":["admin"],"summary":"Reinstate an agent version that was eliminated after a race","description":"Clear `eliminated_at` and `eliminated_in_race_id` on the aggregate.\n\nUse when an agent was eliminated due to a mis-evaluation, scoring bug, or\noperational incident rather than genuine poor performance. The agent will\nre-appear in `_find_scored_qualifiers` on the next qualifying evaluation.\n\nIdempotent: succeeds even if the aggregate is not currently eliminated.","operationId":"reinstate_elimination","parameters":[{"name":"agent_version_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Agent version ID","title":"Agent Version Id"},"description":"Agent version ID"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReinstateEliminationRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReinstateEliminationResponse"}}}},"404":{"description":"Agent version not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentVersionNotFoundError"}}}},"503":{"description":"No active suite","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NoActiveSuiteError"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/admin/agent-versions/{agent_version_id}/set-top":{"post":{"tags":["admin"],"summary":"Set an agent version as the top agent for emissions","description":"Designate an agent version as the top agent for emissions.\n\nThe top agent is the one that receives emissions. Setting a new top agent\nautomatically marks the previous top agent as was_top=True.\n\nRequirements:\n- Agent version must exist and have an aggregate for the suite\n- Only one agent can be is_current_top=True per suite (enforced by DB index)","operationId":"set_top_agent","parameters":[{"name":"agent_version_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Agent version ID to set as top","title":"Agent Version Id"},"description":"Agent version ID to set as top"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SetTopRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SetTopResponse"}}}},"400":{"description":"Score below challenge threshold","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScoreBelowThresholdError"}}}},"404":{"description":"Agent version not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentVersionNotFoundError"}}}},"503":{"description":"No active suite","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NoActiveSuiteError"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/admin/evaluation-runs/{eval_run_id}/invalidate":{"post":{"tags":["admin"],"summary":"Invalidate an evaluation run","description":"Invalidate an evaluation run (irreversible).\n\nMarks the run as excluded from scoring and adjusts the work item's\nincluded_success_count. Reopens the work item to allow validators\nto claim replacement work.","operationId":"invalidate_evaluation_run","parameters":[{"name":"eval_run_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Evaluation run ID","title":"Eval Run Id"},"description":"Evaluation run ID"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InvalidateRunRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EvaluationRunStatusPublic"}}}},"404":{"description":"Evaluation run not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EvalRunNotFoundError"}}}},"409":{"description":"Run already invalidated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AlreadyInvalidatedError"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/admin/agent-versions/{agent_version_id}/reevaluate":{"post":{"tags":["admin"],"summary":"Re-evaluate an agent version","description":"Create a new work item for an agent version to be re-evaluated.","operationId":"reevaluate_agent_version","parameters":[{"name":"agent_version_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Agent version ID","title":"Agent Version Id"},"description":"Agent version ID"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReevaluateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReevaluateResponse"}}}},"404":{"description":"Agent version not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentVersionNotFoundError"}}}},"503":{"description":"No active suite","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NoActiveSuiteError"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/admin/agent-versions/{agent_version_id}/cancel":{"post":{"tags":["admin"],"summary":"Cancel evaluation of an agent version","description":"Cancel active evaluation runs for an agent version.","operationId":"cancel_agent_version","parameters":[{"name":"agent_version_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Agent version ID","title":"Agent Version Id"},"description":"Agent version ID"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CancelRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CancelResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/admin/suites":{"post":{"tags":["admin"],"summary":"Create a new problem suite","description":"Create a new problem suite version.\n\nDownloads and parses the problem suite JSON from S3, then creates\nProblem records for each problem in the suite.","operationId":"create_suite","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateSuiteRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateSuiteResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/admin/suites/{suite_id}/activate":{"post":{"tags":["admin"],"summary":"Activate a problem suite","description":"Activate a suite, making it the current active suite (deactivates others).\n\nAutomatically requeues the top N agent versions from the previous suite\nso validators have work immediately and the leaderboard populates quickly.","operationId":"activate_suite","parameters":[{"name":"suite_id","in":"path","required":true,"schema":{"type":"integer","description":"Suite version to activate","title":"Suite Id"},"description":"Suite version to activate"},{"name":"requeue_top_n","in":"query","required":false,"schema":{"type":"integer","maximum":50,"minimum":0,"description":"Number of top agent versions to requeue from the previous suite (0 to skip)","default":10,"title":"Requeue Top N"},"description":"Number of top agent versions to requeue from the previous suite (0 to skip)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ActivateSuiteResponse"}}}},"404":{"description":"Suite not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuiteNotFoundError"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/admin/audit-events":{"get":{"tags":["admin"],"summary":"Get audit events","description":"Retrieve audit events with optional filtering and pagination.","operationId":"get_audit_events","parameters":[{"name":"action","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by action type (e.g., BAN_MINER)","title":"Action"},"description":"Filter by action type (e.g., BAN_MINER)"},{"name":"target_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by target type","title":"Target Type"},"description":"Filter by target type"},{"name":"target_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by target ID","title":"Target Id"},"description":"Filter by target ID"},{"name":"actor_hotkey","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by actor hotkey","title":"Actor Hotkey"},"description":"Filter by actor hotkey"},{"name":"since","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"Filter: at or after (ISO 8601)","title":"Since"},"description":"Filter: at or after (ISO 8601)"},{"name":"until","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"Filter: at or before (ISO 8601)","title":"Until"},"description":"Filter: at or before (ISO 8601)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"description":"Number of events to return","default":100,"title":"Limit"},"description":"Number of events to return"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"Offset for pagination","default":0,"title":"Offset"},"description":"Offset for pagination"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuditEventsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/admin/reaper/stats":{"get":{"tags":["admin"],"summary":"Get reaper service statistics","description":"Get statistics about the background reaper service.\n\nThe reaper service runs periodically to clean up orphaned evaluation runs\nwhere validators have stopped reporting (crashed or disconnected).\n\nStats are read from Redis (persisted by the active reaper instance) to ensure\nconsistent visibility across all replicas.","operationId":"get_reaper_stats","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReaperStatsResponse"}}}}}}},"/v1/admin/miners/{hotkey}/clear-cooldown":{"post":{"tags":["admin"],"summary":"Clear miner cooldown","description":"Clear the submission cooldown for a miner.","operationId":"clear_miner_cooldown","parameters":[{"name":"hotkey","in":"path","required":true,"schema":{"type":"string","description":"Miner hotkey","title":"Hotkey"},"description":"Miner hotkey"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClearCooldownResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/admin/miners":{"get":{"tags":["admin"],"summary":"List miners with ban status and agent count","description":"List all miners with their ban status, agent count, and last submission time.","operationId":"list_miners","parameters":[{"name":"is_banned","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"Filter by ban status","title":"Is Banned"},"description":"Filter by ban status"},{"name":"since","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"Last submitted at or after","title":"Since"},"description":"Last submitted at or after"},{"name":"until","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"Last submitted at or before","title":"Until"},"description":"Last submitted at or before"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"description":"Number of miners to return","default":50,"title":"Limit"},"description":"Number of miners to return"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"Offset for pagination","default":0,"title":"Offset"},"description":"Offset for pagination"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminMinersResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/admin/validators":{"get":{"tags":["admin"],"summary":"List validators including banned","description":"List all validators including banned ones.","operationId":"list_validators","parameters":[{"name":"is_banned","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"Filter by ban status","title":"Is Banned"},"description":"Filter by ban status"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"description":"Page size","default":50,"title":"Limit"},"description":"Page size"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"Offset","default":0,"title":"Offset"},"description":"Offset"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminValidatorsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/admin/agent-versions":{"get":{"tags":["admin"],"summary":"List agent versions with work item state","description":"List agent versions with aggregate and work item state for a specific suite.","operationId":"list_agent_versions","parameters":[{"name":"is_eligible","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"Filter by eligibility","title":"Is Eligible"},"description":"Filter by eligibility"},{"name":"is_discarded","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"Filter by discard status","title":"Is Discarded"},"description":"Filter by discard status"},{"name":"miner_hotkey","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by miner hotkey","title":"Miner Hotkey"},"description":"Filter by miner hotkey"},{"name":"suite_id","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Suite ID (defaults to active suite)","title":"Suite Id"},"description":"Suite ID (defaults to active suite)"},{"name":"since","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"Filter: created at or after (ISO 8601)","title":"Since"},"description":"Filter: created at or after (ISO 8601)"},{"name":"until","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"Filter: created at or before (ISO 8601)","title":"Until"},"description":"Filter: created at or before (ISO 8601)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"description":"Number of versions to return","default":50,"title":"Limit"},"description":"Number of versions to return"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"Offset for pagination","default":0,"title":"Offset"},"description":"Offset for pagination"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminAgentVersionsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/admin/evaluation-runs":{"get":{"tags":["admin"],"summary":"List evaluation runs with full details","description":"List evaluation runs with optional filtering and pagination.","operationId":"list_evaluation_runs","parameters":[{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/EvaluationRunStatus"},{"type":"null"}],"description":"Filter by run status (e.g., RUNNING, SUCCESS)","title":"Status"},"description":"Filter by run status (e.g., RUNNING, SUCCESS)"},{"name":"agent_version_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"description":"Filter by agent version ID","title":"Agent Version Id"},"description":"Filter by agent version ID"},{"name":"validator_hotkey","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by validator hotkey","title":"Validator Hotkey"},"description":"Filter by validator hotkey"},{"name":"phase","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/EvaluationPhase"},{"type":"null"}],"description":"Filter by evaluation phase (QUALIFYING or RACE)","title":"Phase"},"description":"Filter by evaluation phase (QUALIFYING or RACE)"},{"name":"race_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"description":"Filter by race ID (RACE-phase runs only)","title":"Race Id"},"description":"Filter by race ID (RACE-phase runs only)"},{"name":"eval_work_item_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"description":"Filter to runs for a specific work item","title":"Eval Work Item Id"},"description":"Filter to runs for a specific work item"},{"name":"inference_provider","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by inference provider (e.g. chutes, openrouter). Pass 'none' to filter to runs with no provider recorded.","title":"Inference Provider"},"description":"Filter by inference provider (e.g. chutes, openrouter). Pass 'none' to filter to runs with no provider recorded."},{"name":"since","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"Filter: created at or after (ISO 8601)","title":"Since"},"description":"Filter: created at or after (ISO 8601)"},{"name":"until","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"Filter: created at or before (ISO 8601)","title":"Until"},"description":"Filter: created at or before (ISO 8601)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"description":"Number of runs to return","default":50,"title":"Limit"},"description":"Number of runs to return"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"Offset for pagination","default":0,"title":"Offset"},"description":"Offset for pagination"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminEvaluationRunsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/admin/analytics/validator-scores":{"get":{"tags":["admin"],"summary":"Aggregated scoring statistics per validator","description":"Compute per-validator scoring and performance statistics.","operationId":"get_validator_scores","parameters":[{"name":"suite_id","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Suite ID (defaults to active suite)","title":"Suite Id"},"description":"Suite ID (defaults to active suite)"},{"name":"phase","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/EvaluationPhase"},{"type":"null"}],"description":"Restrict aggregation to runs from this phase","title":"Phase"},"description":"Restrict aggregation to runs from this phase"},{"name":"since","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"Only runs after this time","title":"Since"},"description":"Only runs after this time"},{"name":"until","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"Only runs before this time","title":"Until"},"description":"Only runs before this time"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidatorScoresResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/admin/analytics/agent-version-variance":{"get":{"tags":["admin"],"summary":"Score variance across validators for recent agent versions","description":"Find agent versions with high score variance across validators.","operationId":"get_agent_version_variance","parameters":[{"name":"suite_id","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Suite ID (defaults to active suite)","title":"Suite Id"},"description":"Suite ID (defaults to active suite)"},{"name":"phase","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/EvaluationPhase"},{"type":"null"}],"description":"Restrict aggregation to runs from this phase","title":"Phase"},"description":"Restrict aggregation to runs from this phase"},{"name":"variance_threshold","in":"query","required":false,"schema":{"type":"number","maximum":1,"minimum":0,"description":"Spread threshold for flagging","default":0.1,"title":"Variance Threshold"},"description":"Spread threshold for flagging"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"Number of agent versions","default":20,"title":"Limit"},"description":"Number of agent versions"},{"name":"since","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"Only versions after this time","title":"Since"},"description":"Only versions after this time"},{"name":"until","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"Only versions before this time","title":"Until"},"description":"Only versions before this time"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentVersionVarianceResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/admin/agent-versions/{agent_version_id}/code":{"get":{"tags":["admin"],"summary":"Download agent code","description":"Get a presigned S3 URL to download agent source code for any version, regardless of release state.","operationId":"get_agent_version_code","parameters":[{"name":"agent_version_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Agent version ID","title":"Agent Version Id"},"description":"Agent version ID"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminAgentCodeResponse"}}}},"404":{"description":"Agent version not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentVersionNotFoundError"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/admin/races/current":{"get":{"tags":["admin"],"summary":"Get current race state","description":"Get all active (non-complete, non-cancelled) races with summary info.","operationId":"get_current_races","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CurrentRacesResponse"}}}}}}},"/v1/admin/races/{race_id}/diagnostics":{"get":{"tags":["admin"],"summary":"Get race diagnostics","description":"Get detailed diagnostics for a specific race.","operationId":"get_race_diagnostics","parameters":[{"name":"race_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Race ID","title":"Race Id"},"description":"Race ID"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RaceDiagnosticsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/admin/races/close-qualifying":{"post":{"tags":["admin"],"summary":"Close qualifying and start race","description":"Close the current qualifying window immediately.\n\nSets qualifying_closes_at to now so the orchestrator picks it up\non its next cycle and transitions to RACE_RUNNING (or CANCELLED\nif no qualifiers meet the threshold).","operationId":"close_qualifying","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloseQualifyingResponse"}}}}}}},"/v1/admin/analytics/validator-resources":{"get":{"tags":["admin"],"summary":"Validator host resource samples","operationId":"get_validator_resource_samples","parameters":[{"name":"start","in":"query","required":true,"schema":{"type":"string","format":"date-time","description":"Inclusive lower bound (ISO 8601 UTC)","title":"Start"},"description":"Inclusive lower bound (ISO 8601 UTC)"},{"name":"end","in":"query","required":true,"schema":{"type":"string","format":"date-time","description":"Inclusive upper bound (ISO 8601 UTC)","title":"End"},"description":"Inclusive upper bound (ISO 8601 UTC)"},{"name":"validator_hotkey","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Validator Hotkey"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":50000,"minimum":1,"default":5000,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidatorResourceSamplesResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/admin/analytics/validator-failures/{validator_hotkey}":{"get":{"tags":["admin"],"summary":"Recent failed/timed-out runs for a single validator","description":"Returns the most recent FAILED and TIMED_OUT evaluation runs for the given validator, ordered by completed_at DESC. Powers the expandable failure-history view on the admin analytics dashboard (ORO-676).","operationId":"get_validator_failures","parameters":[{"name":"validator_hotkey","in":"path","required":true,"schema":{"type":"string","description":"Validator SS58 hotkey","title":"Validator Hotkey"},"description":"Validator SS58 hotkey"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"description":"Maximum number of failures to return","default":25,"title":"Limit"},"description":"Maximum number of failures to return"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidatorFailuresResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/admin/validator-pause":{"get":{"tags":["admin"],"summary":"Get validator-pause (andon-cord) state","description":"Returns whether new validator claims are currently paused, plus metadata on who pulled the cord and when it auto-releases.","operationId":"get_validator_pause","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidatorPauseStatus"}}}}}},"post":{"tags":["admin"],"summary":"Pause validator claims (pull the andon cord)","description":"Block all validators from claiming new evaluations. In-flight runs continue and report normally. Idempotent — calling twice overwrites the prior pause metadata.","operationId":"post_validator_pause","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidatorPauseRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidatorPauseStatus"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/admin/validator-resume":{"post":{"tags":["admin"],"summary":"Resume validator claims (release the andon cord)","operationId":"post_validator_resume","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidatorResumeRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidatorPauseStatus"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"ActivateSuiteResponse":{"properties":{"suite_id":{"type":"integer","title":"Suite Id","description":"ID of the created suite"},"suite_version":{"type":"integer","title":"Suite Version","description":"Version number of the suite"},"is_active":{"type":"boolean","title":"Is Active","description":"Whether the suite is active"},"requeued_versions":{"type":"integer","title":"Requeued Versions","description":"Number of agent versions requeued for evaluation","default":0}},"type":"object","required":["suite_id","suite_version","is_active"],"title":"ActivateSuiteResponse"},"AdminAgentCodeResponse":{"properties":{"download_url":{"type":"string","title":"Download Url","description":"Presigned S3 download URL"},"agent_version_id":{"type":"string","format":"uuid","title":"Agent Version Id","description":"Agent version the code belongs to"},"agent_name":{"type":"string","title":"Agent Name","description":"Name of the agent"}},"type":"object","required":["download_url","agent_version_id","agent_name"],"title":"AdminAgentCodeResponse"},"AdminAgentVersionEntry":{"properties":{"agent_version_id":{"type":"string","format":"uuid","title":"Agent Version Id","description":"Agent version ID"},"agent_id":{"type":"string","format":"uuid","title":"Agent Id","description":"Parent agent ID"},"agent_name":{"type":"string","title":"Agent Name","description":"Agent name"},"miner_hotkey":{"type":"string","title":"Miner Hotkey","description":"Owner's hotkey"},"version_number":{"type":"integer","title":"Version Number","description":"Version number within the agent"},"created_at":{"type":"string","format":"date-time","title":"Created At","description":"When this version was created"},"is_eligible":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Eligible","description":"Whether this version is eligible for scoring"},"is_discarded":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Discarded","description":"Whether this version has been discarded"},"final_score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Final Score","description":"Final qualifying score"},"work_item_is_closed":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Work Item Is Closed","description":"Whether the work item is closed"},"work_item_is_cancelled":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Work Item Is Cancelled","description":"Whether the work item is cancelled"},"active_run_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Active Run Count","description":"Number of active evaluation runs"},"is_current_top":{"type":"boolean","title":"Is Current Top","description":"Whether this is the current top agent","default":false},"eliminated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Eliminated At","description":"When the agent was eliminated from future races, if any"},"eliminated_in_race_number":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Eliminated In Race Number","description":"Race number that eliminated this agent, if any"},"work_item_included_success_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Work Item Included Success Count","description":"Number of included successful runs in work item"}},"type":"object","required":["agent_version_id","agent_id","agent_name","miner_hotkey","version_number","created_at"],"title":"AdminAgentVersionEntry"},"AdminAgentVersionsResponse":{"properties":{"total":{"type":"integer","title":"Total","description":"Total entries matching filter"},"limit":{"type":"integer","title":"Limit","description":"Page size"},"offset":{"type":"integer","title":"Offset","description":"Page offset"},"agent_versions":{"items":{"$ref":"#/components/schemas/AdminAgentVersionEntry"},"type":"array","title":"Agent Versions","description":"Agent version entries"}},"type":"object","required":["total","limit","offset","agent_versions"],"title":"AdminAgentVersionsResponse"},"AdminEvaluationRunEntry":{"properties":{"run_id":{"type":"string","format":"uuid","title":"Run Id","description":"Evaluation run ID"},"agent_version_id":{"type":"string","format":"uuid","title":"Agent Version Id","description":"Agent version being evaluated"},"validator_hotkey":{"type":"string","title":"Validator Hotkey","description":"Validator performing the evaluation"},"suite_id":{"type":"integer","title":"Suite Id","description":"Problem suite ID"},"status":{"type":"string","title":"Status","description":"Current run status"},"claimed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Claimed At","description":"When the run was claimed"},"completed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Completed At","description":"When the run completed"},"last_heartbeat_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Heartbeat At","description":"Last heartbeat from the validator"},"lease_expires_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Lease Expires At","description":"When the lease expires"},"is_included":{"type":"boolean","title":"Is Included","description":"Whether this run is included in scoring"},"score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Score","description":"Run score"},"invalidated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Invalidated At","description":"When the run was invalidated"},"invalidation_reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Invalidation Reason","description":"Reason the run was invalidated"},"failure_reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Failure Reason","description":"Reason the run failed"},"created_at":{"type":"string","format":"date-time","title":"Created At","description":"When the run was created"},"eval_work_item_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Eval Work Item Id","description":"Work item this run was created for"},"phase":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Phase","description":"Evaluation phase (QUALIFYING or RACE) from the work item"},"race_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Race Id","description":"Race ID for RACE-phase runs"},"race_number":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Race Number","description":"Race number for RACE-phase runs"},"inference_provider":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Inference Provider","description":"Inference provider used for this run (e.g. chutes, openrouter)"}},"type":"object","required":["run_id","agent_version_id","validator_hotkey","suite_id","status","is_included","created_at"],"title":"AdminEvaluationRunEntry"},"AdminEvaluationRunsResponse":{"properties":{"total":{"type":"integer","title":"Total","description":"Total entries matching filter"},"limit":{"type":"integer","title":"Limit","description":"Page size"},"offset":{"type":"integer","title":"Offset","description":"Page offset"},"evaluation_runs":{"items":{"$ref":"#/components/schemas/AdminEvaluationRunEntry"},"type":"array","title":"Evaluation Runs","description":"Evaluation run entries"}},"type":"object","required":["total","limit","offset","evaluation_runs"],"title":"AdminEvaluationRunsResponse"},"AdminMinerEntry":{"properties":{"miner_hotkey":{"type":"string","title":"Miner Hotkey","description":"Miner's SS58 hotkey"},"is_banned":{"type":"boolean","title":"Is Banned","description":"Whether the miner is banned"},"ban_reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ban Reason","description":"Reason for the ban"},"banned_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Banned At","description":"When the miner was banned"},"agent_count":{"type":"integer","title":"Agent Count","description":"Number of agents submitted by this miner"},"last_submitted_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Submitted At","description":"When the miner last submitted an agent"},"registered_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Registered At","description":"When the miner registered on-chain"},"cooldown_remaining_seconds":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Cooldown Remaining Seconds","description":"Remaining submission cooldown in seconds, or null if no cooldown is active. Sourced from Redis (`cooldown:miner:{hotkey}` TTL)."}},"type":"object","required":["miner_hotkey","is_banned","agent_count"],"title":"AdminMinerEntry"},"AdminMinersResponse":{"properties":{"total":{"type":"integer","title":"Total","description":"Total entries matching filter"},"limit":{"type":"integer","title":"Limit","description":"Page size"},"offset":{"type":"integer","title":"Offset","description":"Page offset"},"miners":{"items":{"$ref":"#/components/schemas/AdminMinerEntry"},"type":"array","title":"Miners","description":"Miner entries"}},"type":"object","required":["total","limit","offset","miners"],"title":"AdminMinersResponse"},"AdminValidatorEntry":{"properties":{"hotkey":{"type":"string","title":"Hotkey","description":"Validator's SS58 address"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name","description":"On-chain identity name, if set"},"status":{"$ref":"#/components/schemas/ValidatorStatus","description":"Current validator status"},"registered_at":{"type":"string","format":"date-time","title":"Registered At","description":"When validator was registered"},"last_claim_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Claim At","description":"Last work claim time"},"last_seen_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Seen At","description":"Last time validator was seen"},"current_agent":{"anyOf":[{"$ref":"#/components/schemas/ValidatorCurrentAgent"},{"type":"null"}],"description":"Agent currently being evaluated, if any"},"service_versions":{"anyOf":[{"additionalProperties":{"type":"string"},"type":"object"},{"type":"null"}],"title":"Service Versions","description":"Docker image digests for validator stack services"},"identity_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Identity Url","description":"On-chain identity URL"},"identity_image":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Identity Image","description":"On-chain identity image URL"},"identity_description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Identity Description","description":"On-chain identity description"},"cpu_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Cpu Pct","description":"Latest reported host CPU utilisation percentage (0-100)"},"ram_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Ram Pct","description":"Latest reported host RAM utilisation percentage (0-100)"},"disk_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Disk Pct","description":"Latest reported host disk utilisation percentage on the sandbox volume (0-100)"},"docker_container_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Docker Container Count","description":"Latest reported running Docker container count on the host"},"metrics_reported_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Metrics Reported At","description":"UTC timestamp of the last resource-metrics report"},"is_banned":{"type":"boolean","title":"Is Banned","description":"Whether the validator is banned"},"ban_reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ban Reason","description":"Reason for the ban"},"banned_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Banned At","description":"When the validator was banned"},"max_concurrent_runs":{"type":"integer","title":"Max Concurrent Runs","description":"Maximum concurrent evaluation runs for this hotkey"}},"type":"object","required":["hotkey","status","registered_at","is_banned","max_concurrent_runs"],"title":"AdminValidatorEntry"},"AdminValidatorsResponse":{"properties":{"total":{"type":"integer","title":"Total","description":"Total entries matching filter"},"limit":{"type":"integer","title":"Limit","description":"Page size"},"offset":{"type":"integer","title":"Offset","description":"Page offset"},"validators":{"items":{"$ref":"#/components/schemas/AdminValidatorEntry"},"type":"array","title":"Validators","description":"Validator entries"}},"type":"object","required":["total","limit","offset","validators"],"title":"AdminValidatorsResponse"},"AdmissionReason":{"type":"string","enum":["COOLDOWN","INVALID_FILE","NOT_REGISTERED_ONCHAIN","BANNED","NO_ACTIVE_SUITE"],"title":"AdmissionReason"},"AdmissionStatus":{"type":"string","enum":["ACCEPTED","REJECTED"],"title":"AdmissionStatus"},"AgentLatestVersion":{"properties":{"eliminated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Eliminated At","description":"When the agent was eliminated from future races, if any"},"eliminated_in_race_number":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Eliminated In Race Number","description":"Race number that eliminated this agent, if any"},"agent_version_id":{"type":"string","format":"uuid","title":"Agent Version Id","description":"Version ID"},"version_number":{"type":"integer","title":"Version Number","description":"Version number (v1, v2, etc.)"},"submitted_at":{"type":"string","format":"date-time","title":"Submitted At","description":"Submission timestamp"},"state":{"$ref":"#/components/schemas/AgentVersionState","description":"Current state"},"final_score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Final Score","description":"Final score if eligible"},"is_selected_for_race":{"type":"boolean","title":"Is Selected For Race","description":"True when this version is the miner's pinned race candidate","default":false},"selection_fallback_reason":{"anyOf":[{"type":"string","enum":["eliminated","discarded","below_threshold","not_eligible"]},{"type":"null"}],"title":"Selection Fallback Reason","description":"Set on the pinned version only when the pin can't take effect."},"is_pinnable":{"type":"boolean","title":"Is Pinnable","description":"True when this version can be pinned as the next race candidate. Mirrors the admission rules used by the PUT /v1/miner/race-selection endpoint.","default":false},"pin_disabled_reason":{"anyOf":[{"type":"string","enum":["eliminated","discarded","below_threshold","not_eligible"]},{"type":"null"}],"title":"Pin Disabled Reason","description":"When `is_pinnable` is false, the specific precondition that fails. Same enum as `selection_fallback_reason`."}},"type":"object","required":["agent_version_id","version_number","submitted_at","state"],"title":"AgentLatestVersion"},"AgentNotFoundError":{"properties":{"detail":{"type":"string","title":"Detail","description":"Error message describing what went wrong"},"error_code":{"type":"string","const":"AGENT_NOT_FOUND","title":"Error Code","description":"Error code for programmatic handling","default":"AGENT_NOT_FOUND"}},"type":"object","required":["detail"],"title":"AgentNotFoundError"},"AgentPublic":{"properties":{"agent_id":{"type":"string","format":"uuid","title":"Agent Id","description":"Unique identifier for the agent"},"miner_hotkey":{"type":"string","title":"Miner Hotkey","description":"Owner's hotkey"},"agent_name":{"type":"string","title":"Agent Name","description":"Human-readable name for the agent"},"created_at":{"type":"string","format":"date-time","title":"Created At","description":"When the agent was created"},"latest_version":{"anyOf":[{"$ref":"#/components/schemas/AgentLatestVersion"},{"type":"null"}],"description":"Latest version with state and score"}},"type":"object","required":["agent_id","miner_hotkey","agent_name","created_at"],"title":"AgentPublic"},"AgentVersionHistoryEntry":{"properties":{"eliminated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Eliminated At","description":"When the agent was eliminated from future races, if any"},"eliminated_in_race_number":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Eliminated In Race Number","description":"Race number that eliminated this agent, if any"},"agent_version_id":{"type":"string","format":"uuid","title":"Agent Version Id","description":"Version ID"},"version_number":{"type":"integer","title":"Version Number","description":"Version number (v1, v2, etc.)"},"submitted_at":{"type":"string","format":"date-time","title":"Submitted At","description":"Submission timestamp"},"state":{"$ref":"#/components/schemas/AgentVersionState","description":"Current state"},"final_score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Final Score","description":"Final score if eligible"},"is_selected_for_race":{"type":"boolean","title":"Is Selected For Race","description":"True when this version is the miner's pinned race candidate","default":false},"selection_fallback_reason":{"anyOf":[{"type":"string","enum":["eliminated","discarded","below_threshold","not_eligible"]},{"type":"null"}],"title":"Selection Fallback Reason","description":"Set on the pinned version only when the pin can't take effect."},"is_pinnable":{"type":"boolean","title":"Is Pinnable","description":"True when this version can be pinned as the next race candidate. Mirrors the admission rules used by the PUT /v1/miner/race-selection endpoint.","default":false},"pin_disabled_reason":{"anyOf":[{"type":"string","enum":["eliminated","discarded","below_threshold","not_eligible"]},{"type":"null"}],"title":"Pin Disabled Reason","description":"When `is_pinnable` is false, the specific precondition that fails. Same enum as `selection_fallback_reason`."}},"type":"object","required":["agent_version_id","version_number","submitted_at","state"],"title":"AgentVersionHistoryEntry"},"AgentVersionNotFoundError":{"properties":{"detail":{"type":"string","title":"Detail","description":"Error message describing what went wrong"},"error_code":{"type":"string","const":"AGENT_VERSION_NOT_FOUND","title":"Error Code","description":"Error code for programmatic handling","default":"AGENT_VERSION_NOT_FOUND"}},"type":"object","required":["detail"],"title":"AgentVersionNotFoundError"},"AgentVersionProblemsResponse":{"properties":{"agent_version_id":{"type":"string","format":"uuid","title":"Agent Version Id","description":"Agent version ID"},"suite_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Suite Id","description":"Suite ID"},"problems":{"items":{"$ref":"#/components/schemas/ProblemProgressEntry"},"type":"array","title":"Problems","description":"Problem progress list"}},"type":"object","required":["agent_version_id","problems"],"title":"AgentVersionProblemsResponse"},"AgentVersionPublic":{"properties":{"agent_version_id":{"type":"string","format":"uuid","title":"Agent Version Id","description":"Unique identifier for this version"},"agent_id":{"type":"string","format":"uuid","title":"Agent Id","description":"Parent agent ID"},"agent_name":{"type":"string","title":"Agent Name","description":"Agent name"},"miner_hotkey":{"type":"string","title":"Miner Hotkey","description":"Owner's hotkey"},"version_number":{"type":"integer","title":"Version Number","description":"Version number within this agent (v1, v2, etc.)"},"suite_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Suite Id","description":"Suite this version was submitted for"},"submitted_at":{"type":"string","format":"date-time","title":"Submitted At","description":"When this version was submitted"},"latest_final_score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Latest Final Score","description":"Final score if eligible"}},"type":"object","required":["agent_version_id","agent_id","agent_name","miner_hotkey","version_number","submitted_at"],"title":"AgentVersionPublic"},"AgentVersionScoreEntry":{"properties":{"validator_hotkey":{"type":"string","title":"Validator Hotkey","description":"Validator's SS58 hotkey"},"score":{"type":"number","title":"Score","description":"Score assigned by this validator"},"run_id":{"type":"string","format":"uuid","title":"Run Id","description":"Evaluation run ID"}},"type":"object","required":["validator_hotkey","score","run_id"],"title":"AgentVersionScoreEntry"},"AgentVersionState":{"type":"string","enum":["RECEIVED","QUEUED","RUNNING","ELIGIBLE","DISCARDED","CANCELLED"],"title":"AgentVersionState","description":"State of an agent version evaluation."},"AgentVersionStatus":{"properties":{"eliminated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Eliminated At","description":"When the agent was eliminated from future races, if any"},"eliminated_in_race_number":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Eliminated In Race Number","description":"Race number that eliminated this agent, if any"},"agent_version_id":{"type":"string","format":"uuid","title":"Agent Version Id","description":"Unique identifier for this version"},"agent_name":{"type":"string","title":"Agent Name","description":"Agent name"},"miner_hotkey":{"type":"string","title":"Miner Hotkey","description":"Owner's hotkey"},"version_number":{"type":"integer","title":"Version Number","description":"Version number within this agent (v1, v2, etc.)"},"suite_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Suite Id","description":"Suite ID"},"submitted_at":{"type":"string","format":"date-time","title":"Submitted At","description":"Submission timestamp"},"state":{"$ref":"#/components/schemas/AgentVersionState","description":"Current state of the version"},"required_successes":{"type":"integer","title":"Required Successes","description":"Required successful evaluations","default":1},"success_count":{"type":"integer","title":"Success Count","description":"Number of successful evaluations","default":0},"active_count":{"type":"integer","title":"Active Count","description":"Number of active evaluations","default":0},"is_closed":{"type":"boolean","title":"Is Closed","description":"Whether evaluation is closed","default":false},"final_score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Final Score","description":"Qualifying score if eligible"},"race_score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Race Score","description":"Race score"},"reasoning_coefficient":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Reasoning Coefficient","description":"Average reasoning coefficient from included successful runs"},"release_state":{"$ref":"#/components/schemas/ArtifactReleaseState","description":"Whether artifacts are released","default":"HIDDEN"},"code_available_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Code Available At","description":"When agent code becomes available for download (eligible_at + 24h)"},"per_validator_success_scores":{"anyOf":[{"additionalProperties":{"type":"number"},"type":"object"},{"type":"null"}],"title":"Per Validator Success Scores","description":"Per-validator scores on success"},"is_active_qualifier":{"type":"boolean","title":"Is Active Qualifier","description":"True when this version is the active qualifier on its hotkey for the open race (covers both the incumbent and the scored qualifier).","default":false},"outranked_by_agent_version_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Outranked By Agent Version Id","description":"Set when this version's score qualifies but a higher-scoring sibling on the same hotkey is the active qualifier instead."}},"type":"object","required":["agent_version_id","agent_name","miner_hotkey","version_number","submitted_at","state"],"title":"AgentVersionStatus"},"AgentVersionVariance":{"properties":{"agent_version_id":{"type":"string","format":"uuid","title":"Agent Version Id","description":"Agent version ID"},"agent_name":{"type":"string","title":"Agent Name","description":"Agent name"},"miner_hotkey":{"type":"string","title":"Miner Hotkey","description":"Owner's hotkey"},"eval_work_item_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Eval Work Item Id","description":"Work item this variance row is computed for"},"phase":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Phase","description":"Evaluation phase (QUALIFYING or RACE)"},"race_number":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Race Number","description":"Race number for RACE-phase work items"},"validator_count":{"type":"integer","title":"Validator Count","description":"Number of validators that scored this version"},"avg_score":{"type":"number","title":"Avg Score","description":"Average score across validators"},"min_score":{"type":"number","title":"Min Score","description":"Minimum validator score"},"max_score":{"type":"number","title":"Max Score","description":"Maximum validator score"},"spread":{"type":"number","title":"Spread","description":"Spread between min and max scores"},"is_high_variance":{"type":"boolean","title":"Is High Variance","description":"Whether the variance exceeds the threshold"},"per_validator":{"items":{"$ref":"#/components/schemas/AgentVersionScoreEntry"},"type":"array","title":"Per Validator","description":"Per-validator score breakdown"}},"type":"object","required":["agent_version_id","agent_name","miner_hotkey","validator_count","avg_score","min_score","max_score","spread","is_high_variance"],"title":"AgentVersionVariance"},"AgentVersionVarianceResponse":{"properties":{"agent_versions":{"items":{"$ref":"#/components/schemas/AgentVersionVariance"},"type":"array","title":"Agent Versions","description":"Per-version variance entries"},"variance_threshold":{"type":"number","title":"Variance Threshold","description":"Threshold used to flag high-variance versions"}},"type":"object","required":["agent_versions","variance_threshold"],"title":"AgentVersionVarianceResponse"},"AlreadyInvalidatedError":{"properties":{"detail":{"type":"string","title":"Detail","description":"Error message describing what went wrong"},"error_code":{"type":"string","const":"ALREADY_INVALIDATED","title":"Error Code","description":"Error code for programmatic handling","default":"ALREADY_INVALIDATED"}},"type":"object","required":["detail"],"title":"AlreadyInvalidatedError"},"ArtifactDownloadRequest":{"properties":{"artifact_type":{"$ref":"#/components/schemas/ArtifactType","description":"Type of artifact to download"},"agent_version_id":{"type":"string","format":"uuid","title":"Agent Version Id","description":"Agent version ID"},"eval_run_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Eval Run Id","description":"Run ID for run-scoped artifacts"},"problem_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Problem Id","description":"Problem ID for per-problem artifact downloads"}},"type":"object","required":["artifact_type","agent_version_id"],"title":"ArtifactDownloadRequest"},"ArtifactDownloadResponse":{"properties":{"download_url":{"type":"string","title":"Download Url","description":"Presigned download URL"},"expires_at":{"type":"string","format":"date-time","title":"Expires At","description":"URL expiration time"}},"type":"object","required":["download_url","expires_at"],"title":"ArtifactDownloadResponse"},"ArtifactNotFoundError":{"properties":{"detail":{"type":"string","title":"Detail","description":"Error message describing what went wrong"},"error_code":{"type":"string","const":"ARTIFACT_NOT_FOUND","title":"Error Code","description":"Error code for programmatic handling","default":"ARTIFACT_NOT_FOUND"}},"type":"object","required":["detail"],"title":"ArtifactNotFoundError"},"ArtifactNotReleasedError":{"properties":{"detail":{"type":"string","title":"Detail","description":"Error message describing what went wrong"},"error_code":{"type":"string","const":"ARTIFACT_NOT_RELEASED","title":"Error Code","description":"Error code for programmatic handling","default":"ARTIFACT_NOT_RELEASED"}},"type":"object","required":["detail"],"title":"ArtifactNotReleasedError"},"ArtifactReleaseState":{"type":"string","enum":["HIDDEN","RELEASED"],"title":"ArtifactReleaseState","description":"Release state of agent version artifacts."},"ArtifactType":{"type":"string","enum":["AGENT_CODE","EVAL_LOGS_BUNDLE","EVAL_PROBLEM_LOGS","REASONING_DETAILS"],"title":"ArtifactType"},"AtCapacityError":{"properties":{"detail":{"type":"string","title":"Detail","description":"Error message describing what went wrong"},"error_code":{"type":"string","const":"AT_CAPACITY","title":"Error Code","description":"Error code for programmatic handling","default":"AT_CAPACITY"}},"type":"object","required":["detail"],"title":"AtCapacityError"},"AuditEventEntry":{"properties":{"event_id":{"type":"string","format":"uuid","title":"Event Id","description":"Unique event identifier"},"action":{"type":"string","title":"Action","description":"Action that was performed"},"target_type":{"type":"string","title":"Target Type","description":"Type of entity targeted"},"target_id":{"type":"string","title":"Target Id","description":"Identifier of the targeted entity"},"actor_hotkey":{"type":"string","title":"Actor Hotkey","description":"Hotkey of the admin who performed the action"},"reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reason","description":"Reason for the action"},"details":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Details","description":"Additional event details"},"created_at":{"type":"string","format":"date-time","title":"Created At","description":"When the event occurred"}},"type":"object","required":["event_id","action","target_type","target_id","actor_hotkey","created_at"],"title":"AuditEventEntry"},"AuditEventsResponse":{"properties":{"total":{"type":"integer","title":"Total","description":"Total entries matching filter"},"limit":{"type":"integer","title":"Limit","description":"Page size"},"offset":{"type":"integer","title":"Offset","description":"Page offset"},"events":{"items":{"$ref":"#/components/schemas/AuditEventEntry"},"type":"array","title":"Events","description":"Audit event entries"}},"type":"object","required":["total","limit","offset","events"],"title":"AuditEventsResponse"},"BanRequest":{"properties":{"reason":{"type":"string","minLength":1,"title":"Reason","description":"Reason for the ban"}},"type":"object","required":["reason"],"title":"BanRequest"},"BanResponse":{"properties":{"hotkey":{"type":"string","title":"Hotkey","description":"Hotkey of the banned/unbanned entity"},"is_banned":{"type":"boolean","title":"Is Banned","description":"Current ban status after the operation"}},"type":"object","required":["hotkey","is_banned"],"title":"BanResponse"},"Body_submit_agent":{"properties":{"agent_name":{"type":"string","title":"Agent Name","description":"Name for this agent (unique per miner)"},"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File","description":"Python agent file (max 1MB)"}},"type":"object","required":["agent_name","file"],"title":"Body_submit_agent"},"CancelRequest":{"properties":{"reason":{"type":"string","title":"Reason","description":"Reason for cancellation"}},"type":"object","required":["reason"],"title":"CancelRequest"},"CancelResponse":{"properties":{"agent_version_id":{"type":"string","format":"uuid","title":"Agent Version Id","description":"Agent version whose runs were cancelled"},"cancelled_runs":{"type":"integer","title":"Cancelled Runs","description":"Number of runs cancelled"}},"type":"object","required":["agent_version_id","cancelled_runs"],"title":"CancelResponse"},"ChallengeRequest":{"properties":{"hotkey":{"type":"string","title":"Hotkey","description":"SS58 hotkey address"}},"type":"object","required":["hotkey"],"title":"ChallengeRequest"},"ChallengeResponse":{"properties":{"challenge":{"type":"string","title":"Challenge","description":"Challenge string to sign"},"expires_at":{"type":"integer","title":"Expires At","description":"Unix timestamp when challenge expires"}},"type":"object","required":["challenge","expires_at"],"title":"ChallengeResponse"},"ChutesAuthStatusResponse":{"properties":{"connected":{"type":"boolean","title":"Connected","description":"Whether the miner has a valid Chutes token stored"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At","description":"When the Chutes token was last updated"}},"type":"object","required":["connected"],"title":"ChutesAuthStatusResponse"},"ClaimWorkResponse":{"properties":{"eval_run_id":{"type":"string","format":"uuid","title":"Eval Run Id","description":"Evaluation run ID assigned to this claim"},"agent_version_id":{"type":"string","format":"uuid","title":"Agent Version Id","description":"Agent version to evaluate"},"suite_id":{"type":"integer","title":"Suite Id","description":"Problem suite ID for this evaluation"},"lease_expires_at":{"type":"string","format":"date-time","title":"Lease Expires At","description":"When the lease expires if not renewed"},"code_download_url":{"type":"string","title":"Code Download Url","description":"Presigned URL to download agent code"},"inference_token":{"anyOf":[{"$ref":"#/components/schemas/InferenceTokenGrant"},{"type":"null"}],"description":"Per-run scoped inference credential. Null when the miner has no inference auth connected or minting failed."}},"type":"object","required":["eval_run_id","agent_version_id","suite_id","lease_expires_at","code_download_url"],"title":"ClaimWorkResponse"},"ClearCooldownResponse":{"properties":{"cleared":{"type":"boolean","title":"Cleared","description":"Whether the cooldown was cleared"},"hotkey":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Hotkey","description":"Hotkey whose cooldown was cleared"},"seconds_remaining_was":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Seconds Remaining Was","description":"Seconds remaining on the cooldown before clearing"},"message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Message","description":"Human-readable status message"}},"type":"object","required":["cleared"],"title":"ClearCooldownResponse"},"CloseQualifyingResponse":{"properties":{"race_id":{"type":"string","format":"uuid","title":"Race Id","description":"Race ID"},"previous_closes_at":{"type":"string","format":"date-time","title":"Previous Closes At","description":"Original qualifying close time"},"new_closes_at":{"type":"string","format":"date-time","title":"New Closes At","description":"New qualifying close time"},"status":{"type":"string","title":"Status","description":"Race status after closing qualifying"}},"type":"object","required":["race_id","previous_closes_at","new_closes_at","status"],"title":"CloseQualifyingResponse"},"CodeAnalysisError":{"properties":{"detail":{"type":"string","title":"Detail","description":"Error message describing what went wrong"},"error_code":{"type":"string","const":"CODE_ANALYSIS_ERROR","title":"Error Code","description":"Error code for programmatic handling","default":"CODE_ANALYSIS_ERROR"},"violations":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Violations","description":"List of violations found (rule, severity, message, line)"},"remaining_seconds":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Remaining Seconds","description":"Seconds remaining on cooldown (if cooldown was consumed by this submission)"}},"type":"object","required":["detail"],"title":"CodeAnalysisError","description":"422 - Static analysis found issues in submitted code."},"CompleteRunRequest":{"properties":{"terminal_status":{"$ref":"#/components/schemas/TerminalStatus","description":"Final status of the evaluation run"},"validator_score":{"anyOf":[{"type":"number","maximum":1.0,"minimum":0.0},{"type":"null"}],"title":"Validator Score","description":"Aggregate score computed by the validator"},"score_components":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Score Components","description":"Detailed score component breakdown"},"results_s3_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Results S3 Key","description":"S3 key for the uploaded results bundle"},"failure_reason":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Failure Reason","description":"Human-readable failure reason"},"sandbox_metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Sandbox Metadata","description":"Metadata about the sandbox environment used"}},"type":"object","required":["terminal_status"],"title":"CompleteRunRequest","description":"Sent by the validator when an evaluation run finishes."},"CompleteRunResponse":{"properties":{"eval_run_id":{"type":"string","format":"uuid","title":"Eval Run Id","description":"Evaluation run that was completed"},"status":{"type":"string","title":"Status","description":"Recorded terminal status"},"work_item":{"$ref":"#/components/schemas/WorkItemStatus","description":"Current work-item completion counters"},"agent_version_became_eligible":{"type":"boolean","title":"Agent Version Became Eligible","description":"Whether this run caused the agent version to become eligible"},"final_score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Final Score","description":"Final qualifying score if the version became eligible"}},"type":"object","required":["eval_run_id","status","work_item","agent_version_became_eligible"],"title":"CompleteRunResponse"},"CooldownActiveError":{"properties":{"detail":{"type":"string","title":"Detail","description":"Error message describing what went wrong"},"error_code":{"type":"string","const":"COOLDOWN_ACTIVE","title":"Error Code","description":"Error code for programmatic handling","default":"COOLDOWN_ACTIVE"},"remaining_seconds":{"type":"integer","title":"Remaining Seconds","description":"Seconds remaining until cooldown expires"}},"type":"object","required":["detail","remaining_seconds"],"title":"CooldownActiveError","description":"429 - Cooldown period is active."},"CreateSuiteRequest":{"properties":{"problem_suite_uri":{"type":"string","title":"Problem Suite Uri","description":"URI of the problem suite to import"},"is_public":{"type":"boolean","title":"Is Public","description":"Whether the suite is publicly visible","default":true},"also_member_of":{"items":{"type":"integer"},"type":"array","maxItems":20,"title":"Also Member Of","description":"Existing suite versions to also add the new problems to (via problem_suite_membership). Use to extend a race-bank with a freshly-generated batch while keeping the batch's own origin."}},"type":"object","required":["problem_suite_uri"],"title":"CreateSuiteRequest"},"CreateSuiteResponse":{"properties":{"suite_id":{"type":"integer","title":"Suite Id","description":"ID of the created suite"},"suite_version":{"type":"integer","title":"Suite Version","description":"Version number of the suite"},"is_active":{"type":"boolean","title":"Is Active","description":"Whether the suite is active"}},"type":"object","required":["suite_id","suite_version","is_active"],"title":"CreateSuiteResponse"},"CurrentRacesResponse":{"properties":{"races":{"items":{"$ref":"#/components/schemas/RaceSummary"},"type":"array","title":"Races","description":"Active races"}},"type":"object","required":["races"],"title":"CurrentRacesResponse"},"DiscardRequest":{"properties":{"reason":{"type":"string","title":"Reason","description":"Reason for discarding the version"},"suite_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Suite Id","description":"Specific suite to discard from"}},"type":"object","required":["reason"],"title":"DiscardRequest"},"DiscardResponse":{"properties":{"agent_version_id":{"type":"string","format":"uuid","title":"Agent Version Id","description":"Discarded agent version ID"},"suite_id":{"type":"integer","title":"Suite Id","description":"Suite the version was discarded from"},"is_discarded":{"type":"boolean","title":"Is Discarded","description":"Current discard status"}},"type":"object","required":["agent_version_id","suite_id","is_discarded"],"title":"DiscardResponse"},"EliminateRequest":{"properties":{"suite_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Suite Id","description":"Specific suite to eliminate the version in"},"reason":{"type":"string","title":"Reason","description":"Reason for eliminating the version"}},"type":"object","required":["reason"],"title":"EliminateRequest"},"EliminateResponse":{"properties":{"agent_version_id":{"type":"string","format":"uuid","title":"Agent Version Id","description":"Agent version that was eliminated"},"suite_id":{"type":"integer","title":"Suite Id","description":"Suite the version was eliminated in"},"eliminated_at":{"type":"string","format":"date-time","title":"Eliminated At","description":"Timestamp of elimination"}},"type":"object","required":["agent_version_id","suite_id","eliminated_at"],"title":"EliminateResponse"},"EvalRunNotFoundError":{"properties":{"detail":{"type":"string","title":"Detail","description":"Error message describing what went wrong"},"error_code":{"type":"string","const":"EVAL_RUN_NOT_FOUND","title":"Error Code","description":"Error code for programmatic handling","default":"EVAL_RUN_NOT_FOUND"}},"type":"object","required":["detail"],"title":"EvalRunNotFoundError"},"EvaluationPhase":{"type":"string","enum":["QUALIFYING","RACE"],"title":"EvaluationPhase","description":"Which phase of the qualifying+race cycle an evaluation belongs to."},"EvaluationRunDetail":{"properties":{"eval_run_id":{"type":"string","format":"uuid","title":"Eval Run Id","description":"Unique identifier for this run"},"agent_version_id":{"type":"string","format":"uuid","title":"Agent Version Id","description":"Agent version being evaluated"},"agent_name":{"type":"string","title":"Agent Name","description":"Name of the agent"},"validator_hotkey":{"type":"string","title":"Validator Hotkey","description":"Validator performing evaluation"},"status":{"$ref":"#/components/schemas/EvaluationRunStatus","description":"Current run status"},"score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Score","description":"Score if completed successfully"},"version_number":{"type":"integer","title":"Version Number","description":"Version number within this agent (v1, v2, etc.)"},"claimed_at":{"type":"string","format":"date-time","title":"Claimed At","description":"When the run was claimed"},"completed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Completed At","description":"When the run completed"},"failure_reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Failure Reason","description":"Validator-reported failure reason"},"is_included":{"type":"boolean","title":"Is Included","description":"Whether run is included in aggregate scoring","default":true},"invalidated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Invalidated At","description":"When run was invalidated"},"invalidation_reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Invalidation Reason","description":"Reason for invalidation"},"sandbox_metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Sandbox Metadata","description":"Sandbox execution details"},"score_components_summary":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Score Components Summary","description":"Score breakdown including reasoning details"}},"type":"object","required":["eval_run_id","agent_version_id","agent_name","validator_hotkey","status","version_number","claimed_at"],"title":"EvaluationRunDetail"},"EvaluationRunPublic":{"properties":{"eval_run_id":{"type":"string","format":"uuid","title":"Eval Run Id","description":"Unique identifier for this run"},"agent_version_id":{"type":"string","format":"uuid","title":"Agent Version Id","description":"Agent version being evaluated"},"suite_id":{"type":"integer","title":"Suite Id","description":"Suite ID"},"validator_hotkey":{"type":"string","title":"Validator Hotkey","description":"Validator performing evaluation"},"status":{"$ref":"#/components/schemas/EvaluationRunStatus","description":"Run status"},"claimed_at":{"type":"string","format":"date-time","title":"Claimed At","description":"When the run was claimed"},"lease_expires_at":{"type":"string","format":"date-time","title":"Lease Expires At","description":"Lease expiration"},"last_heartbeat_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Heartbeat At","description":"Last heartbeat"},"completed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Completed At","description":"Completion timestamp"},"is_included":{"type":"boolean","title":"Is Included","description":"Whether run is included in aggregate"},"invalidated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Invalidated At","description":"When run was invalidated"},"invalidated_by":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Invalidated By","description":"Who invalidated the run"},"invalidation_reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Invalidation Reason","description":"Reason for invalidation"},"failure_reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Failure Reason","description":"Validator-reported failure reason"},"validator_score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Validator Score","description":"Score on success"},"reasoning_quality":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Reasoning Quality","description":"Average reasoning quality from LLM judge (0-1)"},"reasoning_coefficient":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Reasoning Coefficient","description":"Reasoning coefficient applied to outcome score (0.3-1.0)"},"score_components_summary":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Score Components Summary","description":"Score breakdown on success"},"service_versions":{"anyOf":[{"additionalProperties":{"type":"string"},"type":"object"},{"type":"null"}],"title":"Service Versions","description":"Snapshot of validator service versions at claim time"},"sandbox_metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Sandbox Metadata","description":"Sandbox execution details"},"phase":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Phase","description":"Evaluation phase (QUALIFYING or RACE)"},"race_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Race Id","description":"Race ID if this is a race-phase evaluation"},"race_number":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Race Number","description":"Race number if this is a race-phase evaluation"}},"type":"object","required":["eval_run_id","agent_version_id","suite_id","validator_hotkey","status","claimed_at","lease_expires_at","is_included"],"title":"EvaluationRunPublic"},"EvaluationRunStatus":{"type":"string","enum":["CLAIMED","RUNNING","SUCCESS","FAILED","TIMED_OUT","STALE","CANCELLED"],"title":"EvaluationRunStatus","description":"Status of an evaluation run through its lifecycle."},"EvaluationRunStatusPublic":{"properties":{"eval_run_id":{"type":"string","format":"uuid","title":"Eval Run Id","description":"Evaluation run ID"},"agent_version_id":{"type":"string","format":"uuid","title":"Agent Version Id","description":"Agent version being evaluated"},"suite_id":{"type":"integer","title":"Suite Id","description":"Problem suite ID"},"validator_hotkey":{"type":"string","title":"Validator Hotkey","description":"Validator performing the evaluation"},"status":{"$ref":"#/components/schemas/EvaluationRunStatus","description":"Current run status"},"claimed_at":{"type":"string","format":"date-time","title":"Claimed At","description":"When the run was claimed"},"lease_expires_at":{"type":"string","format":"date-time","title":"Lease Expires At","description":"When the lease expires"},"is_included":{"type":"boolean","title":"Is Included","description":"Whether this run is included in scoring"},"last_heartbeat_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Heartbeat At","description":"Last heartbeat from the validator"},"completed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Completed At","description":"When the run completed"},"invalidated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Invalidated At","description":"When the run was invalidated"},"invalidated_by":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Invalidated By","description":"Hotkey of the admin who invalidated the run"},"invalidation_reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Invalidation Reason","description":"Reason the run was invalidated"},"validator_score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Validator Score","description":"Score assigned by the validator"},"score_components_summary":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Score Components Summary","description":"Summary of score components"}},"type":"object","required":["eval_run_id","agent_version_id","suite_id","validator_hotkey","status","claimed_at","lease_expires_at","is_included"],"title":"EvaluationRunStatusPublic"},"FileTooLargeError":{"properties":{"detail":{"type":"string","title":"Detail","description":"Error message describing what went wrong"},"error_code":{"type":"string","const":"FILE_TOO_LARGE","title":"Error Code","description":"Error code for programmatic handling","default":"FILE_TOO_LARGE"}},"type":"object","required":["detail"],"title":"FileTooLargeError"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"HeartbeatRequest":{"properties":{"service_versions":{"anyOf":[{"additionalProperties":{"type":"string"},"type":"object"},{"type":"null"}],"title":"Service Versions","description":"Docker image digests for validator stack services"},"cpu_pct":{"anyOf":[{"type":"number","maximum":100.0,"minimum":0.0},{"type":"null"}],"title":"Cpu Pct","description":"Validator host CPU utilisation percentage (0-100)"},"ram_pct":{"anyOf":[{"type":"number","maximum":100.0,"minimum":0.0},{"type":"null"}],"title":"Ram Pct","description":"Validator host RAM utilisation percentage (0-100)"},"disk_pct":{"anyOf":[{"type":"number","maximum":100.0,"minimum":0.0},{"type":"null"}],"title":"Disk Pct","description":"Validator host disk utilisation percentage on the sandbox volume (0-100)"},"docker_container_count":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Docker Container Count","description":"Validator host running Docker container count"}},"type":"object","title":"HeartbeatRequest"},"HeartbeatResponse":{"properties":{"lease_expires_at":{"type":"string","format":"date-time","title":"Lease Expires At","description":"New lease expiry after heartbeat"}},"type":"object","required":["lease_expires_at"],"title":"HeartbeatResponse"},"InferenceAuthListResponse":{"properties":{"providers":{"items":{"$ref":"#/components/schemas/InferenceAuthStatusResponse"},"type":"array","title":"Providers"},"default_provider":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Default Provider","description":"Which provider claim_work mints a token from. Null = single-provider auto-pick."}},"type":"object","required":["providers"],"title":"InferenceAuthListResponse","description":"Response body for ``GET /v1/miner/inference-auth``."},"InferenceAuthStatusResponse":{"properties":{"connected":{"type":"boolean","title":"Connected"},"provider":{"type":"string","title":"Provider"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At","description":"When the credential for this provider was last updated."}},"type":"object","required":["connected","provider"],"title":"InferenceAuthStatusResponse","description":"Response body for ``GET /v1/miner/inference-auth/{provider}``."},"InferenceModelsResponse":{"properties":{"models":{"items":{"type":"string"},"type":"array","title":"Models","description":"Allowed model identifiers"}},"type":"object","required":["models"],"title":"InferenceModelsResponse","description":"List of models available to ORO agents via the inference proxy."},"InferenceTokenGrant":{"properties":{"provider":{"type":"string","enum":["chutes","openrouter"],"title":"Provider","description":"Provider that minted the token."},"access_token":{"type":"string","title":"Access Token","description":"Bearer credential the validator presents at base_url."},"base_url":{"type":"string","title":"Base Url","description":"Inference API base URL (OpenAI-compatible chat/completions)."},"expires_at":{"type":"string","format":"date-time","title":"Expires At","description":"UTC timestamp when this token stops being usable."}},"type":"object","required":["provider","access_token","base_url","expires_at"],"title":"InferenceTokenGrant","description":"Per-run scoped inference credential issued at claim_work."},"InvalidAgentNameError":{"properties":{"detail":{"type":"string","title":"Detail","description":"Error message describing what went wrong"},"error_code":{"type":"string","const":"INVALID_AGENT_NAME","title":"Error Code","description":"Error code for programmatic handling","default":"INVALID_AGENT_NAME"}},"type":"object","required":["detail"],"title":"InvalidAgentNameError"},"InvalidArtifactTypeError":{"properties":{"detail":{"type":"string","title":"Detail","description":"Error message describing what went wrong"},"error_code":{"type":"string","const":"INVALID_ARTIFACT_TYPE","title":"Error Code","description":"Error code for programmatic handling","default":"INVALID_ARTIFACT_TYPE"}},"type":"object","required":["detail"],"title":"InvalidArtifactTypeError"},"InvalidFileError":{"properties":{"detail":{"type":"string","title":"Detail","description":"Error message describing what went wrong"},"error_code":{"type":"string","const":"INVALID_FILE","title":"Error Code","description":"Error code for programmatic handling","default":"INVALID_FILE"}},"type":"object","required":["detail"],"title":"InvalidFileError"},"InvalidProblemIdError":{"properties":{"detail":{"type":"string","title":"Detail","description":"Error message describing what went wrong"},"error_code":{"type":"string","const":"INVALID_PROBLEM_ID","title":"Error Code","description":"Error code for programmatic handling","default":"INVALID_PROBLEM_ID"}},"type":"object","required":["detail"],"title":"InvalidProblemIdError"},"InvalidateRunRequest":{"properties":{"reason":{"type":"string","title":"Reason","description":"Reason for invalidating the run"}},"type":"object","required":["reason"],"title":"InvalidateRunRequest"},"LeaderboardEntry":{"properties":{"rank":{"type":"integer","title":"Rank","description":"Leaderboard rank"},"agent_version_id":{"type":"string","format":"uuid","title":"Agent Version Id","description":"Agent version ID"},"agent_name":{"type":"string","title":"Agent Name","description":"Agent name"},"miner_hotkey":{"type":"string","title":"Miner Hotkey","description":"Miner hotkey"},"version_number":{"type":"integer","title":"Version Number","description":"Version number within this agent (v1, v2, etc.)"},"final_score":{"type":"number","title":"Final Score","description":"Final score"},"race_score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Race Score","description":"Competitive evaluation score"},"eligible_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Eligible At","description":"When eligibility was reached"},"is_discarded":{"type":"boolean","title":"Is Discarded","description":"Whether discarded by admin","default":false},"is_miner_banned":{"type":"boolean","title":"Is Miner Banned","description":"Whether miner is banned","default":false},"is_current_top":{"type":"boolean","title":"Is Current Top","description":"Current top agent for emissions","default":false},"was_top":{"type":"boolean","title":"Was Top","description":"Previously held top agent status","default":false},"top_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Top At","description":"When this agent became top"},"is_active_qualifier":{"type":"boolean","title":"Is Active Qualifier","description":"True when this version is the active qualifier on its hotkey for the open race (covers both the incumbent and the scored qualifier).","default":false},"outranked_by_agent_version_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Outranked By Agent Version Id","description":"Set when this version's score qualifies but a higher-scoring sibling on the same hotkey is the active qualifier instead."},"eliminated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Eliminated At","description":"UTC timestamp when this agent was eliminated from future races."}},"type":"object","required":["rank","agent_version_id","agent_name","miner_hotkey","version_number","final_score"],"title":"LeaderboardEntry"},"LeaderboardResponse":{"properties":{"total":{"type":"integer","title":"Total","description":"Total entries matching filter"},"limit":{"type":"integer","title":"Limit","description":"Page size"},"offset":{"type":"integer","title":"Offset","description":"Page offset"},"suite":{"$ref":"#/components/schemas/SuitePublic","description":"Suite information"},"entries":{"items":{"$ref":"#/components/schemas/LeaderboardEntry"},"type":"array","title":"Entries","description":"Leaderboard entries"},"unique_miners":{"type":"integer","title":"Unique Miners","description":"Distinct miner hotkeys on leaderboard"},"agents_submitted_24h":{"type":"integer","title":"Agents Submitted 24H","description":"Count of agent versions submitted in the last 24 hours (across all suites)","default":0},"challenge_threshold":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Challenge Threshold","description":"Score required to dethrone current top"}},"type":"object","required":["total","limit","offset","suite","entries","unique_miners"],"title":"LeaderboardResponse"},"LeaseExpiredError":{"properties":{"detail":{"type":"string","title":"Detail","description":"Error message describing what went wrong"},"error_code":{"type":"string","const":"LEASE_EXPIRED","title":"Error Code","description":"Error code for programmatic handling","default":"LEASE_EXPIRED"}},"type":"object","required":["detail"],"title":"LeaseExpiredError"},"LogoutResponse":{"properties":{"success":{"type":"boolean","title":"Success","description":"Whether logout was successful"}},"type":"object","required":["success"],"title":"LogoutResponse"},"MinerAgentsResponse":{"properties":{"agents":{"items":{"$ref":"#/components/schemas/AgentPublic"},"type":"array","title":"Agents","description":"List of agents owned by the miner"},"can_submit":{"type":"boolean","title":"Can Submit","description":"Whether the miner is currently allowed to submit a new agent"},"next_allowed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Next Allowed At","description":"Earliest time the miner may submit again, if on cooldown"},"racing_agent_version_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Racing Agent Version Id","description":"The agent_version_id this miner would race with right now: the explicitly pinned version when valid, otherwise the picker's auto-pick (highest-scoring eligible version on this hotkey >= the qualifying threshold). None when nothing on this hotkey qualifies."},"racing_agent_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Racing Agent Id","description":"The agent_id that owns racing_agent_version_id. Surfaced alongside the version id so the dashboard can highlight the right row even when the racing version isn't that agent's latest. None when racing_agent_version_id is None."}},"type":"object","required":["agents","can_submit"],"title":"MinerAgentsResponse"},"MinerNotFoundError":{"properties":{"detail":{"type":"string","title":"Detail","description":"Error message describing what went wrong"},"error_code":{"type":"string","const":"MINER_NOT_FOUND","title":"Error Code","description":"Error code for programmatic handling","default":"MINER_NOT_FOUND"}},"type":"object","required":["detail"],"title":"MinerNotFoundError"},"MinerRaceSelectionRequest":{"properties":{"agent_version_id":{"type":"string","format":"uuid","title":"Agent Version Id","description":"Agent version to pin as the race candidate"}},"type":"object","required":["agent_version_id"],"title":"MinerRaceSelectionRequest"},"MissingParameterError":{"properties":{"detail":{"type":"string","title":"Detail","description":"Error message describing what went wrong"},"error_code":{"type":"string","const":"MISSING_PARAMETER","title":"Error Code","description":"Error code for programmatic handling","default":"MISSING_PARAMETER"}},"type":"object","required":["detail"],"title":"MissingParameterError"},"MissingScoreError":{"properties":{"detail":{"type":"string","title":"Detail","description":"Error message describing what went wrong"},"error_code":{"type":"string","const":"MISSING_SCORE","title":"Error Code","description":"Error code for programmatic handling","default":"MISSING_SCORE"}},"type":"object","required":["detail"],"title":"MissingScoreError"},"NoActiveSuiteError":{"properties":{"detail":{"type":"string","title":"Detail","description":"Error message describing what went wrong"},"error_code":{"type":"string","const":"NO_ACTIVE_SUITE","title":"Error Code","description":"Error code for programmatic handling","default":"NO_ACTIVE_SUITE"}},"type":"object","required":["detail"],"title":"NoActiveSuiteError"},"NoSelectionError":{"properties":{"detail":{"type":"string","title":"Detail","description":"Error message describing what went wrong"},"error_code":{"type":"string","const":"NO_SELECTION","title":"Error Code","description":"Error code for programmatic handling","default":"NO_SELECTION"}},"type":"object","required":["detail"],"title":"NoSelectionError"},"NotRunOwnerError":{"properties":{"detail":{"type":"string","title":"Detail","description":"Error message describing what went wrong"},"error_code":{"type":"string","const":"NOT_RUN_OWNER","title":"Error Code","description":"Error code for programmatic handling","default":"NOT_RUN_OWNER"}},"type":"object","required":["detail"],"title":"NotRunOwnerError"},"NotVersionOwnerError":{"properties":{"detail":{"type":"string","title":"Detail","description":"Error message describing what went wrong"},"error_code":{"type":"string","const":"NOT_VERSION_OWNER","title":"Error Code","description":"Error code for programmatic handling","default":"NOT_VERSION_OWNER"}},"type":"object","required":["detail"],"title":"NotVersionOwnerError"},"PendingEvaluation":{"properties":{"work_item_id":{"type":"string","format":"uuid","title":"Work Item Id","description":"Unique work item identifier"},"agent_version_id":{"type":"string","format":"uuid","title":"Agent Version Id","description":"Agent version being evaluated"},"agent_name":{"type":"string","title":"Agent Name","description":"Name of the agent"},"version_number":{"type":"integer","title":"Version Number","description":"Version number within this agent"},"miner_hotkey":{"type":"string","title":"Miner Hotkey","description":"Miner who owns the agent"},"suite_id":{"type":"integer","title":"Suite Id","description":"Problem suite ID"},"required_successes":{"type":"integer","title":"Required Successes","description":"Total successful evaluations needed"},"completed_successes":{"type":"integer","title":"Completed Successes","description":"Successful evaluations completed so far"},"active_runs":{"type":"integer","title":"Active Runs","description":"Currently CLAIMED or RUNNING evaluations"},"remaining":{"type":"integer","title":"Remaining","description":"Additional validator claims still needed"},"queued_at":{"type":"string","format":"date-time","title":"Queued At","description":"When this work item was created"},"phase":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Phase","description":"Evaluation phase (QUALIFYING or RACE)"},"race_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Race Id","description":"Race ID when phase is RACE"}},"type":"object","required":["work_item_id","agent_version_id","agent_name","version_number","miner_hotkey","suite_id","required_successes","completed_successes","active_runs","remaining","queued_at"],"title":"PendingEvaluation"},"PendingEvaluationSummary":{"properties":{"total_pending":{"type":"integer","title":"Total Pending","description":"Number of open work items"},"total_runs_needed":{"type":"integer","title":"Total Runs Needed","description":"Sum of remaining runs across all items"},"total_runs_active":{"type":"integer","title":"Total Runs Active","description":"Sum of active runs across all items"},"projected_completion_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Projected Completion At","description":"Projected UTC timestamp when the queue will fully drain. Null when the queue is empty, no validators are currently active, or there is insufficient evaluation history to project."}},"type":"object","required":["total_pending","total_runs_needed","total_runs_active"],"title":"PendingEvaluationSummary"},"PendingEvaluationsResponse":{"properties":{"summary":{"$ref":"#/components/schemas/PendingEvaluationSummary","description":"Aggregate queue statistics"},"items":{"items":{"$ref":"#/components/schemas/PendingEvaluation"},"type":"array","title":"Items","description":"Individual pending work items"}},"type":"object","required":["summary","items"],"title":"PendingEvaluationsResponse"},"PresignUploadRequest":{"properties":{"content_type":{"type":"string","title":"Content Type","description":"MIME type of the upload","default":"application/json"},"content_length":{"type":"integer","title":"Content Length","description":"Size in bytes of the upload payload"},"eval_run_id":{"type":"string","format":"uuid","title":"Eval Run Id","description":"Evaluation run these results belong to"},"problem_id":{"type":"string","format":"uuid","title":"Problem Id","description":"Problem these results belong to"}},"type":"object","required":["content_length","eval_run_id","problem_id"],"title":"PresignUploadRequest"},"PresignUploadResponse":{"properties":{"upload_url":{"type":"string","title":"Upload Url","description":"Presigned URL to upload to"},"method":{"type":"string","title":"Method","description":"HTTP method to use for upload","default":"PUT"},"results_s3_key":{"type":"string","title":"Results S3 Key","description":"S3 key where the results will be stored"},"expires_at":{"type":"string","format":"date-time","title":"Expires At","description":"When the presigned URL expires"}},"type":"object","required":["upload_url","results_s3_key","expires_at"],"title":"PresignUploadResponse"},"ProblemNotFoundError":{"properties":{"detail":{"type":"string","title":"Detail","description":"Error message describing what went wrong"},"error_code":{"type":"string","const":"PROBLEM_NOT_FOUND","title":"Error Code","description":"Error code for programmatic handling","default":"PROBLEM_NOT_FOUND"}},"type":"object","required":["detail"],"title":"ProblemNotFoundError"},"ProblemProgressEntry":{"properties":{"problem_id":{"type":"string","format":"uuid","title":"Problem Id","description":"Problem ID"},"category":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Category","description":"Problem category"},"phase":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Phase","description":"Evaluation phase: QUALIFYING or RACE"},"race_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Race Id","description":"Race ID when phase is RACE"},"validator_results":{"items":{"$ref":"#/components/schemas/ValidatorProblemResult"},"type":"array","title":"Validator Results","description":"Results from each validator that evaluated this problem"}},"type":"object","required":["problem_id"],"title":"ProblemProgressEntry"},"ProblemProgressUpdate":{"properties":{"problem_id":{"type":"string","format":"uuid","title":"Problem Id","description":"Problem being reported on"},"status":{"$ref":"#/components/schemas/ProblemStatus","description":"Current status of this problem"},"score":{"anyOf":[{"type":"number","maximum":1.0,"minimum":0.0},{"type":"null"}],"title":"Score","description":"Normalised score for this problem"},"score_components_summary":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Score Components Summary","description":"Breakdown of score components"},"logs_s3_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Logs S3 Key","description":"S3 key for problem-level logs"},"reasoning_score":{"anyOf":[{"type":"number","maximum":1.0,"minimum":0.0},{"type":"null"}],"title":"Reasoning Score","description":"Reasoning quality score"},"inference_failure_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Inference Failure Count","description":"Number of failed inference calls"},"inference_total":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Inference Total","description":"Total number of inference calls"},"execution_time":{"anyOf":[{"type":"number","minimum":0.0},{"type":"null"}],"title":"Execution Time","description":"Sandbox execution time for this problem in seconds"}},"type":"object","required":["problem_id","status"],"title":"ProblemProgressUpdate"},"ProblemPublic":{"properties":{"problem_id":{"type":"string","format":"uuid","title":"Problem Id","description":"Unique identifier for the problem"},"suite_id":{"type":"integer","title":"Suite Id","description":"Parent suite ID"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata","description":"Full problem metadata"}},"type":"object","required":["problem_id","suite_id"],"title":"ProblemPublic"},"ProblemStatus":{"type":"string","enum":["PENDING","RUNNING","SUCCESS","FAILED","SKIPPED","TIMED_OUT"],"title":"ProblemStatus"},"ProgressUpdateRequest":{"properties":{"problems":{"items":{"$ref":"#/components/schemas/ProblemProgressUpdate"},"type":"array","title":"Problems","description":"Per-problem progress updates"}},"type":"object","required":["problems"],"title":"ProgressUpdateRequest"},"ProgressUpdateResponse":{"properties":{"accepted":{"type":"boolean","title":"Accepted","description":"Whether the update was accepted","default":true}},"type":"object","title":"ProgressUpdateResponse"},"RaceCurrentResponse":{"properties":{"race":{"anyOf":[{"$ref":"#/components/schemas/RacePublic"},{"type":"null"}],"description":"Current race, if any"},"qualifiers":{"items":{"$ref":"#/components/schemas/RaceQualifierPublic"},"type":"array","title":"Qualifiers","description":"Race qualifiers"}},"type":"object","title":"RaceCurrentResponse"},"RaceDetailResponse":{"properties":{"race":{"$ref":"#/components/schemas/RacePublic","description":"Race details"},"qualifiers":{"items":{"$ref":"#/components/schemas/RaceQualifierPublic"},"type":"array","title":"Qualifiers","description":"Race qualifiers"}},"type":"object","required":["race"],"title":"RaceDetailResponse"},"RaceDiagnosticsResponse":{"properties":{"race_id":{"type":"string","format":"uuid","title":"Race Id","description":"Race ID"},"suite_id":{"type":"integer","title":"Suite Id","description":"Problem suite ID"},"race_number":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Race Number"},"status":{"type":"string","title":"Status","description":"Current race status"},"qualifying_closes_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Qualifying Closes At"},"race_started_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Race Started At"},"race_completed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Race Completed At"},"winner_agent_version_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Winner Agent Version Id"},"winner_score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Winner Score"},"qualifying_threshold":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Qualifying Threshold","description":"Score threshold for qualifying"},"incumbent_agent_version_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Incumbent Agent Version Id","description":"Current incumbent agent version ID"},"problem_seed":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Problem Seed","description":"Seed used for problem selection"},"problem_count":{"type":"integer","title":"Problem Count","description":"Number of problems in the race","default":0},"qualifiers":{"items":{"$ref":"#/components/schemas/RaceQualifierEntry"},"type":"array","title":"Qualifiers","description":"Qualified agent versions"},"work_items":{"items":{"$ref":"#/components/schemas/RaceWorkItemEntry"},"type":"array","title":"Work Items","description":"Race work items"}},"type":"object","required":["race_id","suite_id","status"],"title":"RaceDiagnosticsResponse"},"RaceHistoryResponse":{"properties":{"total":{"type":"integer","title":"Total","description":"Total entries matching filter"},"limit":{"type":"integer","title":"Limit","description":"Page size"},"offset":{"type":"integer","title":"Offset","description":"Page offset"},"races":{"items":{"$ref":"#/components/schemas/RacePublic"},"type":"array","title":"Races","description":"Historical races"}},"type":"object","required":["total","limit","offset","races"],"title":"RaceHistoryResponse"},"RaceLockedError":{"properties":{"detail":{"type":"string","title":"Detail","description":"Error message describing what went wrong"},"error_code":{"type":"string","const":"RACE_LOCKED","title":"Error Code","description":"Error code for programmatic handling","default":"RACE_LOCKED"}},"type":"object","required":["detail"],"title":"RaceLockedError"},"RaceNotFoundError":{"properties":{"detail":{"type":"string","title":"Detail","description":"Error message describing what went wrong"},"error_code":{"type":"string","const":"RACE_NOT_FOUND","title":"Error Code","description":"Error code for programmatic handling","default":"RACE_NOT_FOUND"}},"type":"object","required":["detail"],"title":"RaceNotFoundError"},"RacePublic":{"properties":{"race_id":{"type":"string","format":"uuid","title":"Race Id","description":"Race ID"},"suite_id":{"type":"integer","title":"Suite Id","description":"Problem suite ID"},"race_number":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Race Number"},"status":{"type":"string","title":"Status","description":"Current race status"},"qualifying_closes_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Qualifying Closes At"},"race_started_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Race Started At"},"race_completed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Race Completed At"},"winner_agent_version_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Winner Agent Version Id"},"winner_score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Winner Score"},"qualifying_threshold":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Qualifying Threshold","description":"Score threshold for qualifying"},"winner_agent_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Winner Agent Name","description":"Name of the winning agent"},"qualifier_count":{"type":"integer","title":"Qualifier Count","description":"Number of qualifiers in this race","default":0},"top50_mean":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Top50 Mean","description":"Arithmetic mean of race_score across the top half (by race_score desc) of qualifiers with non-null race_score. Null when the race has no scored qualifiers. Pre-computed so Frontend doesn't have to fan out per-race detail fetches for the Challenge History chart's tooltip distribution stats."},"top50_std":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Top50 Std","description":"Population standard deviation of race_score across the same top-half slice as top50_mean. Null when the race has no scored qualifiers; 0.0 when the top half contains a single row."},"created_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Created At","description":"When the race was created"},"projected_completion_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Projected Completion At","description":"Projected UTC timestamp when the race will complete. Set only on RACE_RUNNING races; null otherwise or when there is insufficient evaluation history or no active validators."}},"type":"object","required":["race_id","suite_id","status"],"title":"RacePublic"},"RaceQualifierEntry":{"properties":{"agent_version_id":{"type":"string","format":"uuid","title":"Agent Version Id","description":"Agent version ID"},"agent_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agent Name","description":"Agent name"},"miner_hotkey":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Miner Hotkey","description":"Miner hotkey"},"version_number":{"type":"integer","title":"Version Number","description":"Version number within this agent","default":0},"qualification_type":{"type":"string","title":"Qualification Type","description":"How agent qualified (INCUMBENT or SCORED)"},"qualifying_score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Qualifying Score","description":"Score from qualifying"},"race_score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Race Score","description":"Score from race phase"},"eliminated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Eliminated At","description":"UTC timestamp when this agent was eliminated from future races, if any. Sourced from the agent version aggregate, not the qualifier row."}},"type":"object","required":["agent_version_id","qualification_type"],"title":"RaceQualifierEntry"},"RaceQualifierPublic":{"properties":{"agent_version_id":{"type":"string","format":"uuid","title":"Agent Version Id","description":"Agent version ID"},"agent_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agent Name","description":"Agent name"},"miner_hotkey":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Miner Hotkey","description":"Miner hotkey"},"version_number":{"type":"integer","title":"Version Number","description":"Version number within this agent","default":0},"qualification_type":{"type":"string","title":"Qualification Type","description":"How agent qualified (INCUMBENT or SCORED)"},"qualifying_score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Qualifying Score","description":"Score from qualifying"},"race_score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Race Score","description":"Score from race phase"},"eliminated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Eliminated At","description":"UTC timestamp when this agent was eliminated from future races, if any. Sourced from the agent version aggregate, not the qualifier row."},"race_rank":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Race Rank","description":"Rank within the race"},"is_discarded":{"type":"boolean","title":"Is Discarded","description":"True when the agent's aggregate is marked discarded (admin- or auto-discarded). Sourced from AgentVersionAggregate for this version + suite; defaults to False if no aggregate row exists.","default":false}},"type":"object","required":["agent_version_id","qualification_type"],"title":"RaceQualifierPublic"},"RaceSummary":{"properties":{"race_id":{"type":"string","format":"uuid","title":"Race Id","description":"Race ID"},"suite_id":{"type":"integer","title":"Suite Id","description":"Problem suite ID"},"race_number":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Race Number"},"status":{"type":"string","title":"Status","description":"Current race status"},"qualifying_closes_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Qualifying Closes At"},"race_started_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Race Started At"},"race_completed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Race Completed At"},"winner_agent_version_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Winner Agent Version Id"},"winner_score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Winner Score"},"qualifier_count":{"type":"integer","title":"Qualifier Count","description":"Number of qualifiers in this race","default":0},"work_item_count":{"type":"integer","title":"Work Item Count","description":"Number of work items in this race","default":0}},"type":"object","required":["race_id","suite_id","status"],"title":"RaceSummary"},"RaceWorkItemEntry":{"properties":{"agent_version_id":{"type":"string","format":"uuid","title":"Agent Version Id","description":"Agent version ID"},"agent_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agent Name","description":"Agent name"},"phase":{"type":"string","title":"Phase","description":"Race phase (qualifying or race)"},"is_closed":{"type":"boolean","title":"Is Closed","description":"Whether the work item is closed"},"is_cancelled":{"type":"boolean","title":"Is Cancelled","description":"Whether the work item is cancelled"},"included_success_count":{"type":"integer","title":"Included Success Count","description":"Number of included successful runs"},"active_count":{"type":"integer","title":"Active Count","description":"Number of active runs"},"required_successes":{"type":"integer","title":"Required Successes","description":"Required number of successful runs"}},"type":"object","required":["agent_version_id","phase","is_closed","is_cancelled","included_success_count","active_count","required_successes"],"title":"RaceWorkItemEntry"},"RankedInferenceModel":{"properties":{"id":{"type":"string","title":"Id"},"rank_metric":{"additionalProperties":true,"type":"object","title":"Rank Metric"},"healthy":{"type":"boolean","title":"Healthy","default":true}},"type":"object","required":["id"],"title":"RankedInferenceModel","description":"One row in a ranked inference-models response.\n\n``rank_metric`` is provider-specific: Chutes returns rate-limit ratio +\nutilization + instance counts; OpenRouter returns uptime + latency +\nstatus."},"RankedInferenceModelsResponse":{"properties":{"models":{"items":{"$ref":"#/components/schemas/RankedInferenceModel"},"type":"array","title":"Models"},"ranked_by":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ranked By","description":"Sort applied; null on cold start (static fallback order)."},"as_of":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"As Of"}},"type":"object","required":["models"],"title":"RankedInferenceModelsResponse","description":"Models in ranked order — earlier entries are preferred."},"RateLimitExceededError":{"properties":{"detail":{"type":"string","title":"Detail","description":"Error message describing what went wrong"},"error_code":{"type":"string","const":"RATE_LIMIT_EXCEEDED","title":"Error Code","description":"Error code for programmatic handling","default":"RATE_LIMIT_EXCEEDED"}},"type":"object","required":["detail"],"title":"RateLimitExceededError"},"ReaperStatsResponse":{"properties":{"enabled":{"type":"boolean","title":"Enabled","description":"Whether the reaper is enabled"},"is_running":{"type":"boolean","title":"Is Running","description":"Whether the reaper is currently running"},"last_run_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Run At","description":"When the reaper last ran"},"runs_reaped_total":{"type":"integer","title":"Runs Reaped Total","description":"Total number of runs reaped since startup"},"runs_reaped_last_cycle":{"type":"integer","title":"Runs Reaped Last Cycle","description":"Number of runs reaped in the last cycle"},"last_cycle_duration_ms":{"type":"number","title":"Last Cycle Duration Ms","description":"Duration of the last reaper cycle in milliseconds"},"error_count":{"type":"integer","title":"Error Count","description":"Total number of reaper errors"},"redis_error_count":{"type":"integer","title":"Redis Error Count","description":"Total number of Redis-related reaper errors"},"interval_seconds":{"type":"integer","title":"Interval Seconds","description":"Reaper cycle interval in seconds"}},"type":"object","required":["enabled","is_running","runs_reaped_total","runs_reaped_last_cycle","last_cycle_duration_ms","error_count","redis_error_count","interval_seconds"],"title":"ReaperStatsResponse"},"ReevaluateRequest":{"properties":{"reason":{"type":"string","title":"Reason","description":"Reason for re-evaluation"},"suite_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Suite Id","description":"Specific suite to re-evaluate against"},"required_successes":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Required Successes","description":"Override for number of required successful evaluations"}},"type":"object","required":["reason"],"title":"ReevaluateRequest"},"ReevaluateResponse":{"properties":{"agent_version_id":{"type":"string","format":"uuid","title":"Agent Version Id","description":"Agent version queued for re-evaluation"}},"type":"object","required":["agent_version_id"],"title":"ReevaluateResponse"},"ReinstateEliminationRequest":{"properties":{"suite_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Suite Id","description":"Specific suite to reinstate elimination for"},"reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reason","description":"Optional reason captured in the audit trail"}},"type":"object","title":"ReinstateEliminationRequest"},"ReinstateEliminationResponse":{"properties":{"agent_version_id":{"type":"string","format":"uuid","title":"Agent Version Id","description":"Agent version whose elimination was cleared"},"suite_id":{"type":"integer","title":"Suite Id","description":"Suite the elimination was cleared for"}},"type":"object","required":["agent_version_id","suite_id"],"title":"ReinstateEliminationResponse"},"ReinstateRequest":{"properties":{"suite_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Suite Id","description":"Specific suite to reinstate for"},"reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reason","description":"Optional reason captured in the audit trail"}},"type":"object","title":"ReinstateRequest"},"RunAlreadyCompleteError":{"properties":{"detail":{"type":"string","title":"Detail","description":"Error message describing what went wrong"},"error_code":{"type":"string","const":"RUN_ALREADY_COMPLETE","title":"Error Code","description":"Error code for programmatic handling","default":"RUN_ALREADY_COMPLETE"}},"type":"object","required":["detail"],"title":"RunAlreadyCompleteError"},"RunProblemsResponse":{"properties":{"problems":{"items":{"$ref":"#/components/schemas/ProblemPublic"},"type":"array","title":"Problems","description":"Problems to evaluate"}},"type":"object","required":["problems"],"title":"RunProblemsResponse"},"RunningEvaluation":{"properties":{"eval_run_id":{"type":"string","format":"uuid","title":"Eval Run Id","description":"Unique identifier for this run"},"agent_version_id":{"type":"string","format":"uuid","title":"Agent Version Id","description":"Agent version being evaluated"},"agent_name":{"type":"string","title":"Agent Name","description":"Name of the agent"},"version_number":{"type":"integer","title":"Version Number","description":"Version number within this agent (v1, v2, etc.)"},"miner_hotkey":{"type":"string","title":"Miner Hotkey","description":"Miner who owns the agent"},"validator_hotkey":{"type":"string","title":"Validator Hotkey","description":"Validator performing evaluation"},"status":{"$ref":"#/components/schemas/EvaluationRunStatus","description":"Current run status"},"started_at":{"type":"string","format":"date-time","title":"Started At","description":"When evaluation started"},"progress_percent":{"type":"number","title":"Progress Percent","description":"Percentage of problems completed (0-100)","default":0.0},"phase":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Phase","description":"Evaluation phase (QUALIFYING or RACE)"},"race_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Race Id","description":"Race ID when phase is RACE"}},"type":"object","required":["eval_run_id","agent_version_id","agent_name","version_number","miner_hotkey","validator_hotkey","status","started_at"],"title":"RunningEvaluation"},"ScoreBelowThresholdError":{"properties":{"detail":{"type":"string","title":"Detail","description":"Error message describing what went wrong"},"error_code":{"type":"string","const":"SCORE_BELOW_THRESHOLD","title":"Error Code","description":"Error code for programmatic handling","default":"SCORE_BELOW_THRESHOLD"},"candidate_score":{"type":"number","title":"Candidate Score","description":"Score of the candidate agent"},"required_score":{"type":"number","title":"Required Score","description":"Minimum score required to dethrone the current top"},"current_top_score":{"type":"number","title":"Current Top Score","description":"Score of the current top agent"},"margin":{"type":"number","title":"Margin","description":"Current challenge margin fraction"}},"type":"object","required":["detail","candidate_score","required_score","current_top_score","margin"],"title":"ScoreBelowThresholdError","description":"400 - Candidate score does not exceed the challenge threshold."},"SessionRequest":{"properties":{"hotkey":{"type":"string","title":"Hotkey","description":"SS58 hotkey address"},"challenge":{"type":"string","title":"Challenge","description":"Challenge that was signed"},"signature":{"type":"string","title":"Signature","description":"Hex-encoded signature"}},"type":"object","required":["hotkey","challenge","signature"],"title":"SessionRequest"},"SessionResponse":{"properties":{"session_token":{"type":"string","title":"Session Token","description":"Session token for authenticated requests"},"expires_at":{"type":"integer","title":"Expires At","description":"Unix timestamp when session expires"},"role":{"type":"string","title":"Role","description":"User role (miner, validator, admin)"}},"type":"object","required":["session_token","expires_at","role"],"title":"SessionResponse"},"SetDefaultProviderRequest":{"properties":{"provider":{"type":"string","maxLength":32,"minLength":1,"title":"Provider"}},"type":"object","required":["provider"],"title":"SetDefaultProviderRequest","description":"Request body for ``PATCH /v1/miner/inference-auth/default``."},"SetTopRequest":{"properties":{"suite_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Suite Id","description":"Specific suite to set top agent for"},"force":{"type":"boolean","title":"Force","description":"Force set even if version has lower score","default":false}},"type":"object","title":"SetTopRequest"},"SetTopResponse":{"properties":{"agent_version_id":{"type":"string","format":"uuid","title":"Agent Version Id","description":"Agent version set as top"},"suite_id":{"type":"integer","title":"Suite Id","description":"Suite the top agent was set for"},"previous_top_agent_version_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Previous Top Agent Version Id","description":"Previous top agent version ID, if any"},"top_at":{"type":"string","format":"date-time","title":"Top At","description":"Timestamp when the top agent was set"}},"type":"object","required":["agent_version_id","suite_id","top_at"],"title":"SetTopResponse"},"SimilarityCheckUnavailableError":{"properties":{"detail":{"type":"string","title":"Detail","description":"Error message describing what went wrong"},"error_code":{"type":"string","const":"SIMILARITY_CHECK_UNAVAILABLE","title":"Error Code","description":"Error code for programmatic handling","default":"SIMILARITY_CHECK_UNAVAILABLE"}},"type":"object","required":["detail"],"title":"SimilarityCheckUnavailableError"},"StoreChutesTokenRequest":{"properties":{"refresh_token":{"type":"string","title":"Refresh Token","description":"Chutes OAuth refresh token to store"}},"type":"object","required":["refresh_token"],"title":"StoreChutesTokenRequest"},"StoreInferenceCredentialRequest":{"properties":{"credential":{"type":"string","maxLength":8192,"minLength":1,"title":"Credential","description":"Provider-specific credential (refresh token, API key, etc.)"}},"type":"object","required":["credential"],"title":"StoreInferenceCredentialRequest","description":"Request body for ``POST /v1/miner/inference-auth/{provider}``."},"SubmitAgentResponse":{"properties":{"agent_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Agent Id","description":"Unique identifier for the created agent"},"agent_version_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Agent Version Id","description":"Unique identifier for the created agent version"},"admission_status":{"$ref":"#/components/schemas/AdmissionStatus","description":"Whether the submission was accepted or rejected"},"admission_reason":{"anyOf":[{"$ref":"#/components/schemas/AdmissionReason"},{"type":"null"}],"description":"Reason for rejection, if the submission was rejected"},"next_allowed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Next Allowed At","description":"Earliest time the miner may submit again after cooldown"},"hotkey":{"type":"string","title":"Hotkey","description":"Hotkey of the miner who submitted the agent"},"message":{"type":"string","title":"Message","description":"Human-readable status message","default":"Agent submitted successfully"}},"type":"object","required":["admission_status","hotkey"],"title":"SubmitAgentResponse"},"SuiteNotFoundError":{"properties":{"detail":{"type":"string","title":"Detail","description":"Error message describing what went wrong"},"error_code":{"type":"string","const":"SUITE_NOT_FOUND","title":"Error Code","description":"Error code for programmatic handling","default":"SUITE_NOT_FOUND"}},"type":"object","required":["detail"],"title":"SuiteNotFoundError"},"SuitePublic":{"properties":{"suite_id":{"type":"integer","title":"Suite Id","description":"Problem suite version/ID"},"suite_version":{"type":"integer","title":"Suite Version","description":"Version number of the problem suite"},"is_active":{"type":"boolean","title":"Is Active","description":"Whether this suite is currently active"}},"type":"object","required":["suite_id","suite_version","is_active"],"title":"SuitePublic"},"SuiteWithProblemsResponse":{"properties":{"suite":{"$ref":"#/components/schemas/SuitePublic","description":"Suite information"},"problems":{"items":{"$ref":"#/components/schemas/ProblemPublic"},"type":"array","title":"Problems","description":"Problems in this suite"}},"type":"object","required":["suite","problems"],"title":"SuiteWithProblemsResponse"},"TerminalStatus":{"type":"string","enum":["SUCCESS","FAILED","TIMED_OUT"],"title":"TerminalStatus"},"TopAgentResponse":{"properties":{"suite_id":{"type":"integer","title":"Suite Id","description":"Active suite ID"},"computed_at":{"type":"string","format":"date-time","title":"Computed At","description":"When this was computed"},"top_agent_version_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Top Agent Version Id","description":"Top agent version ID"},"top_miner_hotkey":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Top Miner Hotkey","description":"Top miner's hotkey"},"top_score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Top Score","description":"Top score"},"policy":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Policy","description":"Hysteresis/decay params"},"challenge_threshold":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Challenge Threshold","description":"Score required to dethrone"},"emission_weight":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Emission Weight","description":"Current emission weight (1.0=full)"},"margin":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Margin","description":"Current challenge margin fraction"}},"type":"object","required":["suite_id","computed_at"],"title":"TopAgentResponse"},"TopHistoryEntry":{"properties":{"agent_version_id":{"type":"string","format":"uuid","title":"Agent Version Id","description":"Agent version ID"},"agent_name":{"type":"string","title":"Agent Name","description":"Agent name"},"miner_hotkey":{"type":"string","title":"Miner Hotkey","description":"Miner hotkey"},"version_number":{"type":"integer","title":"Version Number","description":"Version number"},"final_score":{"type":"number","title":"Final Score","description":"Final score"},"top_at":{"type":"string","format":"date-time","title":"Top At","description":"When this agent became top"},"is_current_top":{"type":"boolean","title":"Is Current Top","description":"Currently the top agent"},"was_top":{"type":"boolean","title":"Was Top","description":"Previously held top agent status"},"suite_id":{"type":"integer","title":"Suite Id","description":"Suite this top status was earned on"}},"type":"object","required":["agent_version_id","agent_name","miner_hotkey","version_number","final_score","top_at","is_current_top","was_top","suite_id"],"title":"TopHistoryEntry"},"TopHistoryResponse":{"properties":{"suite_id":{"type":"integer","title":"Suite Id","description":"Suite ID"},"entries":{"items":{"$ref":"#/components/schemas/TopHistoryEntry"},"type":"array","title":"Entries","description":"Top agent history entries"}},"type":"object","required":["suite_id","entries"],"title":"TopHistoryResponse"},"TopMinerPayoutResponse":{"properties":{"miner_hotkey":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Miner Hotkey","description":"Top miner's hotkey"},"agent_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agent Name","description":"Top miner's agent name"},"tao_per_day":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Tao Per Day","description":"Estimated TAO emitted per day"},"usd_per_day":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Usd Per Day","description":"Estimated USD equivalent per day"},"tao_price_usd":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Tao Price Usd","description":"TAO/USD price used for USD estimate"},"as_of":{"type":"string","format":"date-time","title":"As Of","description":"When this payout estimate was computed"}},"type":"object","required":["as_of"],"title":"TopMinerPayoutResponse"},"UpdateValidatorRequest":{"properties":{"max_concurrent_runs":{"type":"integer","minimum":1.0,"title":"Max Concurrent Runs","description":"Maximum concurrent evaluation runs (must be >= 1)"}},"type":"object","required":["max_concurrent_runs"],"title":"UpdateValidatorRequest"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"},"ValidationErrorError":{"properties":{"detail":{"type":"string","title":"Detail","description":"Error message describing what went wrong"},"error_code":{"type":"string","const":"VALIDATION_ERROR","title":"Error Code","description":"Error code for programmatic handling","default":"VALIDATION_ERROR"}},"type":"object","required":["detail"],"title":"ValidationErrorError"},"ValidatorCurrentAgent":{"properties":{"agent_name":{"type":"string","title":"Agent Name","description":"Name of the agent being evaluated"},"version_id":{"type":"string","format":"uuid","title":"Version Id","description":"Agent version ID"},"version_number":{"type":"integer","title":"Version Number","description":"Version number within this agent (v1, v2, etc.)"},"started_at":{"type":"string","format":"date-time","title":"Started At","description":"When evaluation started"}},"type":"object","required":["agent_name","version_id","version_number","started_at"],"title":"ValidatorCurrentAgent"},"ValidatorFailureEntry":{"properties":{"eval_run_id":{"type":"string","format":"uuid","title":"Eval Run Id","description":"Evaluation run identifier"},"agent_version_id":{"type":"string","format":"uuid","title":"Agent Version Id","description":"Agent version that was being evaluated"},"failure_reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Failure Reason","description":"Reason the run failed (free-form string)"},"completed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Completed At","description":"When the run completed (UTC)"},"status":{"type":"string","title":"Status","description":"Terminal status — FAILED or TIMED_OUT"}},"type":"object","required":["eval_run_id","agent_version_id","status"],"title":"ValidatorFailureEntry","description":"A single FAILED/TIMED_OUT evaluation run from a validator."},"ValidatorFailuresResponse":{"properties":{"validator_hotkey":{"type":"string","title":"Validator Hotkey","description":"Validator whose failures these are"},"failures":{"items":{"$ref":"#/components/schemas/ValidatorFailureEntry"},"type":"array","title":"Failures","description":"Recent failure entries"},"total":{"type":"integer","title":"Total","description":"Number of entries returned"}},"type":"object","required":["validator_hotkey","failures","total"],"title":"ValidatorFailuresResponse","description":"Recent failures for a single validator, ordered by completed_at DESC."},"ValidatorNotFoundError":{"properties":{"detail":{"type":"string","title":"Detail","description":"Error message describing what went wrong"},"error_code":{"type":"string","const":"VALIDATOR_NOT_FOUND","title":"Error Code","description":"Error code for programmatic handling","default":"VALIDATOR_NOT_FOUND"}},"type":"object","required":["detail"],"title":"ValidatorNotFoundError"},"ValidatorPauseRequest":{"properties":{"reason":{"type":"string","minLength":1,"title":"Reason","description":"Reason for pulling the andon cord"},"auto_release_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Auto Release At","description":"UTC timestamp at which the pause auto-clears. Safety net so a pause can't be left on by accident."}},"type":"object","required":["reason"],"title":"ValidatorPauseRequest"},"ValidatorPauseStatus":{"properties":{"active":{"type":"boolean","title":"Active","description":"True when validator claims are paused"},"reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reason","description":"Reason from the most recent pause"},"paused_by":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Paused By","description":"Admin hotkey that pulled the cord"},"paused_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Paused At","description":"When the cord was pulled"},"auto_release_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Auto Release At","description":"When the pause will auto-clear, if scheduled"}},"type":"object","required":["active"],"title":"ValidatorPauseStatus"},"ValidatorProblemResult":{"properties":{"eval_run_id":{"type":"string","format":"uuid","title":"Eval Run Id","description":"Evaluation run ID this result belongs to"},"validator_hotkey":{"type":"string","title":"Validator Hotkey","description":"Validator hotkey"},"status":{"$ref":"#/components/schemas/ProblemStatus","description":"Problem status from this validator"},"score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Score","description":"Problem score from this validator"},"score_components":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Score Components","description":"Score breakdown from this validator"},"reasoning_score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Reasoning Score","description":"Reasoning quality score from LLM judge"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At","description":"Last update from this validator"},"inference_failure_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Inference Failure Count","description":"Number of failed inference calls for this problem"},"inference_total":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Inference Total","description":"Total number of inference calls for this problem"},"execution_time":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Execution Time","description":"Sandbox execution time for this problem in seconds"}},"type":"object","required":["eval_run_id","validator_hotkey","status"],"title":"ValidatorProblemResult"},"ValidatorPublic":{"properties":{"hotkey":{"type":"string","title":"Hotkey","description":"Validator's SS58 address"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name","description":"On-chain identity name, if set"},"status":{"$ref":"#/components/schemas/ValidatorStatus","description":"Current validator status"},"registered_at":{"type":"string","format":"date-time","title":"Registered At","description":"When validator was registered"},"last_claim_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Claim At","description":"Last work claim time"},"last_seen_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Seen At","description":"Last time validator was seen"},"current_agent":{"anyOf":[{"$ref":"#/components/schemas/ValidatorCurrentAgent"},{"type":"null"}],"description":"Agent currently being evaluated, if any"},"service_versions":{"anyOf":[{"additionalProperties":{"type":"string"},"type":"object"},{"type":"null"}],"title":"Service Versions","description":"Docker image digests for validator stack services"},"identity_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Identity Url","description":"On-chain identity URL"},"identity_image":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Identity Image","description":"On-chain identity image URL"},"identity_description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Identity Description","description":"On-chain identity description"},"cpu_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Cpu Pct","description":"Latest reported host CPU utilisation percentage (0-100)"},"ram_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Ram Pct","description":"Latest reported host RAM utilisation percentage (0-100)"},"disk_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Disk Pct","description":"Latest reported host disk utilisation percentage on the sandbox volume (0-100)"},"docker_container_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Docker Container Count","description":"Latest reported running Docker container count on the host"},"metrics_reported_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Metrics Reported At","description":"UTC timestamp of the last resource-metrics report"}},"type":"object","required":["hotkey","status","registered_at"],"title":"ValidatorPublic"},"ValidatorResourceSampleEntry":{"properties":{"validator_hotkey":{"type":"string","title":"Validator Hotkey"},"recorded_at":{"type":"string","format":"date-time","title":"Recorded At"},"cpu_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Cpu Pct"},"ram_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Ram Pct"},"disk_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Disk Pct"},"docker_container_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Docker Container Count"}},"type":"object","required":["validator_hotkey","recorded_at"],"title":"ValidatorResourceSampleEntry"},"ValidatorResourceSamplesResponse":{"properties":{"samples":{"items":{"$ref":"#/components/schemas/ValidatorResourceSampleEntry"},"type":"array","title":"Samples"},"count":{"type":"integer","title":"Count"}},"type":"object","required":["samples","count"],"title":"ValidatorResourceSamplesResponse"},"ValidatorResumeRequest":{"properties":{"reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reason","description":"Optional reason for releasing the cord"}},"type":"object","title":"ValidatorResumeRequest"},"ValidatorScoreSummary":{"properties":{"validator_hotkey":{"type":"string","title":"Validator Hotkey","description":"Validator's SS58 hotkey"},"total_runs":{"type":"integer","title":"Total Runs","description":"Total number of completed runs"},"avg_score":{"type":"number","title":"Avg Score","description":"Average score across runs"},"median_score":{"type":"number","title":"Median Score","description":"Median score across runs"},"stddev_score":{"type":"number","title":"Stddev Score","description":"Standard deviation of scores"},"min_score":{"type":"number","title":"Min Score","description":"Minimum score"},"max_score":{"type":"number","title":"Max Score","description":"Maximum score"},"deviation_from_global":{"type":"number","title":"Deviation From Global","description":"Deviation of this validator's average from the global average"},"is_outlier":{"type":"boolean","title":"Is Outlier","description":"Whether this validator is a scoring outlier"},"avg_execution_seconds":{"type":"number","title":"Avg Execution Seconds","description":"Average execution time in seconds","default":0},"median_execution_seconds":{"type":"number","title":"Median Execution Seconds","description":"Median execution time in seconds","default":0},"min_execution_seconds":{"type":"number","title":"Min Execution Seconds","description":"Minimum execution time in seconds","default":0},"max_execution_seconds":{"type":"number","title":"Max Execution Seconds","description":"Maximum execution time in seconds","default":0},"execution_deviation_pct":{"type":"number","title":"Execution Deviation Pct","description":"Percentage deviation of execution time from global average","default":0},"is_slow_outlier":{"type":"boolean","title":"Is Slow Outlier","description":"Whether this validator is a slow execution outlier","default":false},"success_count":{"type":"integer","title":"Success Count","description":"Number of successful runs","default":0},"failed_count":{"type":"integer","title":"Failed Count","description":"Number of failed runs","default":0},"timed_out_count":{"type":"integer","title":"Timed Out Count","description":"Number of timed-out runs","default":0},"success_rate":{"type":"number","title":"Success Rate","description":"Success rate as a fraction","default":0},"last_failure_reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Failure Reason","description":"Reason for the most recent failure"},"last_failure_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Failure At","description":"When the most recent failure occurred"}},"type":"object","required":["validator_hotkey","total_runs","avg_score","median_score","stddev_score","min_score","max_score","deviation_from_global","is_outlier"],"title":"ValidatorScoreSummary"},"ValidatorScoresResponse":{"properties":{"validators":{"items":{"$ref":"#/components/schemas/ValidatorScoreSummary"},"type":"array","title":"Validators","description":"Per-validator score summaries"},"global_avg_score":{"type":"number","title":"Global Avg Score","description":"Global average score across all validators"},"global_stddev":{"type":"number","title":"Global Stddev","description":"Global standard deviation of scores"},"global_avg_execution_seconds":{"type":"number","title":"Global Avg Execution Seconds","description":"Global average execution time in seconds","default":0}},"type":"object","required":["validators","global_avg_score","global_stddev"],"title":"ValidatorScoresResponse","description":"Aggregated validator scoring analysis."},"ValidatorStatus":{"type":"string","enum":["evaluating","available"],"title":"ValidatorStatus"},"WaitlistSignupRequest":{"properties":{"email":{"type":"string","maxLength":320,"title":"Email","description":"Email address to add to the waitlist"},"source":{"type":"string","maxLength":64,"title":"Source","description":"Signup source","default":"landing"}},"type":"object","required":["email"],"title":"WaitlistSignupRequest"},"WaitlistSignupResponse":{"properties":{"success":{"type":"boolean","title":"Success","description":"Whether signup was recorded"}},"type":"object","required":["success"],"title":"WaitlistSignupResponse"},"WorkItemStatus":{"properties":{"included_success_count":{"type":"integer","title":"Included Success Count","description":"Number of successful runs included so far"},"required_successes":{"type":"integer","title":"Required Successes","description":"Number of successful runs required to close the work item"},"is_closed":{"type":"boolean","title":"Is Closed","description":"Whether the work item is closed"}},"type":"object","required":["included_success_count","required_successes","is_closed"],"title":"WorkItemStatus"}}}}