@oro-ai/sdk 1.0.35 → 1.0.37

package/src/generated/types.gen.ts

@@ -1,48 +1,39 @@
 // This file is auto-generated by @hey-api/openapi-ts
 
-/**
- * Response for suite activation.
- */
 export type ActivateSuiteResponse = {
     /**
-     * Activated suite ID
+     * ID of the created suite
      */
     suite_id: number;
     /**
-     * Suite version number
+     * Version number of the suite
      */
     suite_version: number;
     /**
-     * Whether this suite is active
+     * Whether the suite is active
      */
     is_active: boolean;
     /**
-     * Number of top agent versions requeued from previous suite
+     * Number of agent versions requeued for evaluation
      */
     requeued_versions?: number;
 };
 
-/**
- * Response with presigned download URL for admin agent code access.
- */
 export type AdminAgentCodeResponse = {
     /**
      * Presigned S3 download URL
      */
     download_url: string;
     /**
-     * Agent version ID
+     * Agent version the code belongs to
      */
     agent_version_id: string;
     /**
-     * Agent name
+     * Name of the agent
      */
     agent_name: string;
 };
 
-/**
- * An agent version entry for admin listing.
- */
 export type AdminAgentVersionEntry = {
     /**
      * Agent version ID
@@ -57,11 +48,11 @@ export type AdminAgentVersionEntry = {
      */
     agent_name: string;
     /**
-     * Miner hotkey that owns this agent
+     * Owner's hotkey
      */
     miner_hotkey: string;
     /**
-     * Version number
+     * Version number within the agent
      */
     version_number: number;
     /**
@@ -69,15 +60,15 @@ export type AdminAgentVersionEntry = {
      */
     created_at: string;
     /**
-     * Whether version is eligible
+     * Whether this version is eligible for scoring
      */
     is_eligible?: (boolean | null);
     /**
-     * Whether version is discarded
+     * Whether this version has been discarded
      */
     is_discarded?: (boolean | null);
     /**
-     * Final aggregate score
+     * Final qualifying score
      */
     final_score?: (number | null);
     /**
@@ -97,21 +88,14 @@ export type AdminAgentVersionEntry = {
      */
     is_current_top?: boolean;
     /**
-     * Number of included successful runs
+     * Number of included successful runs in work item
      */
     work_item_included_success_count?: (number | null);
 };
 
-/**
- * Response for admin agent versions listing.
- */
 export type AdminAgentVersionsResponse = {
     /**
-     * List of agent versions
-     */
-    agent_versions: Array<AdminAgentVersionEntry>;
-    /**
-     * Total agent versions matching filter
+     * Total entries matching filter
      */
     total: number;
     /**
@@ -122,11 +106,12 @@ export type AdminAgentVersionsResponse = {
      * Page offset
      */
     offset: number;
+    /**
+     * Agent version entries
+     */
+    agent_versions: Array<AdminAgentVersionEntry>;
 };
 
-/**
- * An evaluation run entry for admin listing.
- */
 export type AdminEvaluationRunEntry = {
     /**
      * Evaluation run ID
@@ -137,15 +122,15 @@ export type AdminEvaluationRunEntry = {
      */
     agent_version_id: string;
     /**
-     * Validator performing evaluation
+     * Validator performing the evaluation
      */
     validator_hotkey: string;
     /**
-     * Problem suite version
+     * Problem suite ID
      */
     suite_id: number;
     /**
-     * Run status
+     * Current run status
      */
     status: string;
     /**
@@ -157,15 +142,15 @@ export type AdminEvaluationRunEntry = {
      */
     completed_at?: (string | null);
     /**
-     * Last heartbeat timestamp
+     * Last heartbeat from the validator
      */
     last_heartbeat_at?: (string | null);
     /**
-     * Lease expiration
+     * When the lease expires
      */
     lease_expires_at?: (string | null);
     /**
-     * Whether run is included in aggregate scoring
+     * Whether this run is included in scoring
      */
     is_included: boolean;
     /**
@@ -177,11 +162,11 @@ export type AdminEvaluationRunEntry = {
      */
     invalidated_at?: (string | null);
     /**
-     * Reason for invalidation
+     * Reason the run was invalidated
      */
     invalidation_reason?: (string | null);
     /**
-     * Reason for failure
+     * Reason the run failed
      */
     failure_reason?: (string | null);
     /**
@@ -190,16 +175,9 @@ export type AdminEvaluationRunEntry = {
     created_at: string;
 };
 
-/**
- * Response for admin evaluation runs listing.
- */
 export type AdminEvaluationRunsResponse = {
     /**
-     * List of evaluation runs
-     */
-    evaluation_runs: Array<AdminEvaluationRunEntry>;
-    /**
-     * Total evaluation runs matching filter
+     * Total entries matching filter
      */
     total: number;
     /**
@@ -210,22 +188,23 @@ export type AdminEvaluationRunsResponse = {
      * Page offset
      */
     offset: number;
+    /**
+     * Evaluation run entries
+     */
+    evaluation_runs: Array<AdminEvaluationRunEntry>;
 };
 
-/**
- * A miner entry for admin listing.
- */
 export type AdminMinerEntry = {
     /**
-     * Miner hotkey (SS58 address)
+     * Miner's SS58 hotkey
      */
     miner_hotkey: string;
     /**
-     * Whether the miner is currently banned
+     * Whether the miner is banned
      */
     is_banned: boolean;
     /**
-     * Reason for ban if banned
+     * Reason for the ban
      */
     ban_reason?: (string | null);
     /**
@@ -233,7 +212,7 @@ export type AdminMinerEntry = {
      */
     banned_at?: (string | null);
     /**
-     * Number of agents owned by this miner
+     * Number of agents submitted by this miner
      */
     agent_count: number;
     /**
@@ -241,21 +220,14 @@ export type AdminMinerEntry = {
      */
     last_submitted_at?: (string | null);
     /**
-     * When the miner was first registered
+     * When the miner registered on-chain
      */
     registered_at?: (string | null);
 };
 
-/**
- * Response for admin miners listing.
- */
 export type AdminMinersResponse = {
     /**
-     * List of miners
-     */
-    miners: Array<AdminMinerEntry>;
-    /**
-     * Total miners matching filter
+     * Total entries matching filter
      */
     total: number;
     /**
@@ -266,11 +238,12 @@ export type AdminMinersResponse = {
      * Page offset
      */
     offset: number;
+    /**
+     * Miner entries
+     */
+    miners: Array<AdminMinerEntry>;
 };
 
-/**
- * Extends ValidatorPublic with admin-only fields (ban status).
- */
 export type AdminValidatorEntry = {
     /**
      * Validator's SS58 address
@@ -319,29 +292,22 @@ export type AdminValidatorEntry = {
      */
     identity_description?: (string | null);
     /**
-     * Whether banned
+     * Whether the validator is banned
      */
     is_banned: boolean;
     /**
-     * Ban reason
+     * Reason for the ban
      */
     ban_reason?: (string | null);
     /**
-     * When banned
+     * When the validator was banned
      */
     banned_at?: (string | null);
 };
 
-/**
- * Response for admin validators listing.
- */
 export type AdminValidatorsResponse = {
     /**
-     * List of validators
-     */
-    validators: Array<AdminValidatorEntry>;
-    /**
-     * Total matching filter
+     * Total entries matching filter
      */
     total: number;
     /**
@@ -352,21 +318,16 @@ export type AdminValidatorsResponse = {
      * Page offset
      */
     offset: number;
+    /**
+     * Validator entries
+     */
+    validators: Array<AdminValidatorEntry>;
 };
 
-/**
- * Reason for rejection of agent submission.
- */
 export type AdmissionReason = 'COOLDOWN' | 'INVALID_FILE' | 'NOT_REGISTERED_ONCHAIN' | 'BANNED' | 'NO_ACTIVE_SUITE';
 
-/**
- * Status of agent submission admission.
- */
 export type AdmissionStatus = 'ACCEPTED' | 'REJECTED';
 
-/**
- * Latest version summary, inlined in agent list responses.
- */
 export type AgentLatestVersion = {
     /**
      * Version ID
@@ -390,9 +351,6 @@ export type AgentLatestVersion = {
     final_score?: (number | null);
 };
 
-/**
- * 404 - Agent not found.
- */
 export type AgentNotFoundError = {
     /**
      * Error message describing what went wrong
@@ -404,9 +362,6 @@ export type AgentNotFoundError = {
     error_code?: "AGENT_NOT_FOUND";
 };
 
-/**
- * Public representation of an agent.
- */
 export type AgentPublic = {
     /**
      * Unique identifier for the agent
@@ -430,16 +385,13 @@ export type AgentPublic = {
     latest_version?: (AgentLatestVersion | null);
 };
 
-/**
- * Entry in agent version history list.
- */
 export type AgentVersionHistoryEntry = {
     /**
      * Version ID
      */
     agent_version_id: string;
     /**
-     * Version number within this agent (v1, v2, etc.)
+     * Version number (v1, v2, etc.)
      */
     version_number: number;
     /**
@@ -456,9 +408,6 @@ export type AgentVersionHistoryEntry = {
     final_score?: (number | null);
 };
 
-/**
- * 404 - Agent version not found.
- */
 export type AgentVersionNotFoundError = {
     /**
      * Error message describing what went wrong
@@ -470,9 +419,6 @@ export type AgentVersionNotFoundError = {
     error_code?: "AGENT_VERSION_NOT_FOUND";
 };
 
-/**
- * Response for agent version problem progress.
- */
 export type AgentVersionProblemsResponse = {
     /**
      * Agent version ID
@@ -488,9 +434,6 @@ export type AgentVersionProblemsResponse = {
     problems: Array<ProblemProgressEntry>;
 };
 
-/**
- * Public representation of an agent version.
- */
 export type AgentVersionPublic = {
     /**
      * Unique identifier for this version
@@ -526,16 +469,13 @@ export type AgentVersionPublic = {
     latest_final_score?: (number | null);
 };
 
-/**
- * Per-validator score for an agent version.
- */
 export type AgentVersionScoreEntry = {
     /**
-     * Validator hotkey
+     * Validator's SS58 hotkey
      */
     validator_hotkey: string;
     /**
-     * Score from this validator
+     * Score assigned by this validator
      */
     score: number;
     /**
@@ -549,9 +489,6 @@ export type AgentVersionScoreEntry = {
  */
 export type AgentVersionState = 'RECEIVED' | 'QUEUED' | 'RUNNING' | 'ELIGIBLE' | 'DISCARDED' | 'CANCELLED';
 
-/**
- * Status response for an agent version.
- */
 export type AgentVersionStatus = {
     /**
      * Unique identifier for this version
@@ -625,9 +562,6 @@ export type AgentVersionStatus = {
 } | null);
 };
 
-/**
- * Score variance across validators for a single agent version.
- */
 export type AgentVersionVariance = {
     /**
      * Agent version ID
@@ -638,7 +572,7 @@ export type AgentVersionVariance = {
      */
     agent_name: string;
     /**
-     * Miner hotkey
+     * Owner's hotkey
      */
     miner_hotkey: string;
     /**
@@ -646,48 +580,42 @@ export type AgentVersionVariance = {
      */
     validator_count: number;
     /**
-     * Mean score
+     * Average score across validators
      */
     avg_score: number;
     /**
-     * Minimum score
+     * Minimum validator score
      */
     min_score: number;
     /**
-     * Maximum score
+     * Maximum validator score
      */
     max_score: number;
     /**
-     * max_score - min_score
+     * Spread between min and max scores
      */
     spread: number;
     /**
-     * True if spread exceeds threshold (default 10%)
+     * Whether the variance exceeds the threshold
      */
     is_high_variance: boolean;
     /**
-     * Individual validator scores
+     * Per-validator score breakdown
      */
-    per_validator: Array<AgentVersionScoreEntry>;
+    per_validator?: Array<AgentVersionScoreEntry>;
 };
 
-/**
- * Response for agent version score variance analytics.
- */
 export type AgentVersionVarianceResponse = {
     /**
-     * Per-version variance data
+     * Per-version variance entries
      */
     agent_versions: Array<AgentVersionVariance>;
     /**
-     * Spread threshold used for flagging
+     * Threshold used to flag high-variance versions
      */
     variance_threshold: number;
 };
 
-/**
- * 409 - Resource is already invalidated.
- */
 export type AlreadyInvalidatedError = {
     /**
      * Error message describing what went wrong
@@ -699,9 +627,6 @@ export type AlreadyInvalidatedError = {
     error_code?: "ALREADY_INVALIDATED";
 };
 
-/**
- * Request for artifact download URL.
- */
 export type ArtifactDownloadRequest = {
     /**
      * Type of artifact to download
@@ -721,9 +646,6 @@ export type ArtifactDownloadRequest = {
     problem_id?: (string | null);
 };
 
-/**
- * Response with presigned download URL.
- */
 export type ArtifactDownloadResponse = {
     /**
      * Presigned download URL
@@ -735,9 +657,6 @@ export type ArtifactDownloadResponse = {
     expires_at: string;
 };
 
-/**
- * 404 - Artifact not found or not available.
- */
 export type ArtifactNotFoundError = {
     /**
      * Error message describing what went wrong
@@ -749,9 +668,6 @@ export type ArtifactNotFoundError = {
     error_code?: "ARTIFACT_NOT_FOUND";
 };
 
-/**
- * 404 - Artifact exists but is not yet released.
- */
 export type ArtifactNotReleasedError = {
     /**
      * Error message describing what went wrong
@@ -768,14 +684,8 @@ export type ArtifactNotReleasedError = {
  */
 export type ArtifactReleaseState = 'HIDDEN' | 'RELEASED';
 
-/**
- * Type of artifact for download.
- */
 export type ArtifactType = 'AGENT_CODE' | 'EVAL_LOGS_BUNDLE' | 'EVAL_PROBLEM_LOGS' | 'REASONING_DETAILS';
 
-/**
- * 409 - Validator is at maximum concurrent evaluation capacity.
- */
 export type AtCapacityError = {
     /**
      * Error message describing what went wrong
@@ -787,36 +697,33 @@ export type AtCapacityError = {
     error_code?: "AT_CAPACITY";
 };
 
-/**
- * Audit event log entry.
- */
 export type AuditEventEntry = {
     /**
-     * Event ID
+     * Unique event identifier
      */
     event_id: string;
     /**
-     * Action performed
+     * Action that was performed
      */
     action: string;
     /**
-     * Type of target entity
+     * Type of entity targeted
      */
     target_type: string;
     /**
-     * Target entity ID
+     * Identifier of the targeted entity
      */
     target_id: string;
     /**
-     * Admin who performed the action
+     * Hotkey of the admin who performed the action
      */
     actor_hotkey: string;
     /**
-     * Reason provided
+     * Reason for the action
      */
     reason?: (string | null);
     /**
-     * Additional context
+     * Additional event details
      */
     details?: ({
     [key: string]: unknown;
@@ -827,16 +734,9 @@ export type AuditEventEntry = {
     created_at: string;
 };
 
-/**
- * Response for audit events list.
- */
 export type AuditEventsResponse = {
     /**
-     * Audit events
-     */
-    events: Array<AuditEventEntry>;
-    /**
-     * Total events matching filter
+     * Total entries matching filter
      */
     total: number;
     /**
@@ -847,11 +747,12 @@ export type AuditEventsResponse = {
      * Page offset
      */
     offset: number;
+    /**
+     * Audit event entries
+     */
+    events: Array<AuditEventEntry>;
 };
 
-/**
- * Request to ban a miner or validator.
- */
 export type BanRequest = {
     /**
      * Reason for the ban
@@ -859,16 +760,13 @@ export type BanRequest = {
     reason: string;
 };
 
-/**
- * Response for ban/unban operations.
- */
 export type BanResponse = {
     /**
-     * Affected hotkey
+     * Hotkey of the banned/unbanned entity
      */
     hotkey: string;
     /**
-     * New ban state
+     * Current ban status after the operation
      */
     is_banned: boolean;
 };
@@ -884,9 +782,6 @@ export type Body_submit_agent = {
     file: (Blob | File);
 };
 
-/**
- * Request to cancel an agent version's evaluation.
- */
 export type CancelRequest = {
     /**
      * Reason for cancellation
@@ -894,12 +789,9 @@ export type CancelRequest = {
     reason: string;
 };
 
-/**
- * Response for cancel operation.
- */
 export type CancelResponse = {
     /**
-     * Agent version ID
+     * Agent version whose runs were cancelled
      */
     agent_version_id: string;
     /**
@@ -908,9 +800,6 @@ export type CancelResponse = {
     cancelled_runs: number;
 };
 
-/**
- * Request body for challenge endpoint.
- */
 export type ChallengeRequest = {
     /**
      * SS58 hotkey address
@@ -918,9 +807,6 @@ export type ChallengeRequest = {
     hotkey: string;
 };
 
-/**
- * Response from challenge endpoint.
- */
 export type ChallengeResponse = {
     /**
      * Challenge string to sign
@@ -932,26 +818,20 @@ export type ChallengeResponse = {
     expires_at: number;
 };
 
-/**
- * Response for Chutes auth status check.
- */
 export type ChutesAuthStatusResponse = {
     /**
-     * Whether the miner has a stored Chutes token
+     * Whether the miner has a valid Chutes token stored
      */
     connected: boolean;
     /**
-     * When the token was last stored or rotated
+     * When the Chutes token was last updated
      */
     updated_at?: (string | null);
 };
 
-/**
- * Response for successful work claim.
- */
 export type ClaimWorkResponse = {
     /**
-     * Unique identifier for the evaluation run
+     * Evaluation run ID assigned to this claim
      */
     eval_run_id: string;
     /**
@@ -959,11 +839,11 @@ export type ClaimWorkResponse = {
      */
     agent_version_id: string;
     /**
-     * Problem suite ID
+     * Problem suite ID for this evaluation
      */
     suite_id: number;
     /**
-     * When the lease expires
+     * When the lease expires if not renewed
      */
     lease_expires_at: string;
     /**
@@ -971,17 +851,33 @@ export type ClaimWorkResponse = {
      */
     code_download_url: string;
     /**
-     * Fresh Chutes access token for miner-funded inference
+     * Optional Chutes access token for sandboxed execution
      */
     chutes_access_token?: (string | null);
 };
 
-/**
- * Response for closing a qualifying window.
- */
+export type ClearCooldownResponse = {
+    /**
+     * Whether the cooldown was cleared
+     */
+    cleared: boolean;
+    /**
+     * Hotkey whose cooldown was cleared
+     */
+    hotkey?: (string | null);
+    /**
+     * Seconds remaining on the cooldown before clearing
+     */
+    seconds_remaining_was?: (number | null);
+    /**
+     * Human-readable status message
+     */
+    message?: (string | null);
+};
+
 export type CloseQualifyingResponse = {
     /**
-     * Race that was closed
+     * Race ID
      */
     race_id: string;
     /**
@@ -989,11 +885,11 @@ export type CloseQualifyingResponse = {
      */
     previous_closes_at: string;
     /**
-     * Updated close time (now)
+     * New qualifying close time
      */
     new_closes_at: string;
     /**
-     * Race status after update
+     * Race status after closing qualifying
      */
     status: string;
 };
@@ -1023,61 +919,58 @@ export type CodeAnalysisError = {
 };
 
 /**
- * Request to complete an evaluation run.
+ * Sent by the validator when an evaluation run finishes.
  */
 export type CompleteRunRequest = {
     /**
-     * Final status of the run
+     * Final status of the evaluation run
      */
     terminal_status: TerminalStatus;
     /**
-     * Score (required if SUCCESS)
+     * Aggregate score computed by the validator
      */
     validator_score?: (number | null);
     /**
-     * Score breakdown (required if SUCCESS)
+     * Detailed score component breakdown
      */
     score_components?: ({
     [key: string]: unknown;
 } | null);
     /**
-     * S3 key for run-level logs bundle (optional, per-problem logs preferred)
+     * S3 key for the uploaded results bundle
      */
     results_s3_key?: (string | null);
     /**
-     * Reason for failure (e.g., 'No Chutes token', 'Sandbox execution failed')
+     * Human-readable failure reason
      */
     failure_reason?: (string | null);
     /**
-     * Sandbox execution details: {exit_code, duration_seconds, stderr_tail}
+     * Metadata about the sandbox environment used
      */
     sandbox_metadata?: ({
     [key: string]: unknown;
 } | null);
 };
 
-/**
- * Response for run completion.
- */
 export type CompleteRunResponse = {
     /**
-     * Evaluation run ID
+     * Evaluation run that was completed
      */
     eval_run_id: string;
     /**
-     * New status of the run
+     * Recorded terminal status
      */
     status: string;
     /**
-     * Updated work item status
+     * Current work-item completion counters
      */
     work_item: WorkItemStatus;
     /**
-     * Whether agent version just became eligible
+     * Whether this run caused the agent version to become eligible
      */
     agent_version_became_eligible: boolean;
     /**
-     * Final score if became eligible
+     * Final qualifying score if the version became eligible
      */
     final_score?: (number | null);
 };
@@ -1100,41 +993,32 @@ export type CooldownActiveError = {
     remaining_seconds: number;
 };
 
-/**
- * Request to create a new problem suite.
- */
 export type CreateSuiteRequest = {
     /**
-     * URI to the problem suite definition
+     * URI of the problem suite to import
      */
     problem_suite_uri: string;
     /**
-     * Whether this suite is queryable via public API
+     * Whether the suite is publicly visible
      */
     is_public?: boolean;
 };
 
-/**
- * Response for suite creation.
- */
 export type CreateSuiteResponse = {
     /**
-     * Created suite ID
+     * ID of the created suite
      */
     suite_id: number;
     /**
-     * Suite version number
+     * Version number of the suite
      */
     suite_version: number;
     /**
-     * Whether this suite is active
+     * Whether the suite is active
      */
     is_active: boolean;
 };
 
-/**
- * Response for current race state.
- */
 export type CurrentRacesResponse = {
     /**
      * Active races
@@ -1142,41 +1026,32 @@ export type CurrentRacesResponse = {
     races: Array<RaceSummary>;
 };
 
-/**
- * Request to discard an agent version.
- */
 export type DiscardRequest = {
     /**
-     * Reason for discarding
+     * Reason for discarding the version
      */
     reason: string;
     /**
-     * Suite ID (defaults to current suite)
+     * Specific suite to discard from
      */
     suite_id?: (number | null);
 };
 
-/**
- * Response for discard/reinstate operations.
- */
 export type DiscardResponse = {
     /**
-     * Affected agent version
+     * Discarded agent version ID
      */
     agent_version_id: string;
     /**
-     * Suite ID for the operation
+     * Suite the version was discarded from
      */
     suite_id: number;
     /**
-     * New discard state
+     * Current discard status
      */
     is_discarded: boolean;
 };
 
-/**
- * 404 - Evaluation run not found.
- */
 export type EvalRunNotFoundError = {
     /**
      * Error message describing what went wrong
@@ -1188,9 +1063,6 @@ export type EvalRunNotFoundError = {
     error_code?: "EVAL_RUN_NOT_FOUND";
 };
 
-/**
- * Detailed representation of a single evaluation run.
- */
 export type EvaluationRunDetail = {
     /**
      * Unique identifier for this run
@@ -1258,9 +1130,6 @@ export type EvaluationRunDetail = {
 } | null);
 };
 
-/**
- * Public representation of an evaluation run.
- */
 export type EvaluationRunPublic = {
     /**
      * Unique identifier for this run
@@ -1356,6 +1225,10 @@ export type EvaluationRunPublic = {
      * Race ID if this is a race-phase evaluation
      */
     race_id?: (string | null);
+    /**
+     * Race number if this is a race-phase evaluation
+     */
+    race_number?: (number | null);
 };
 
 /**
@@ -1363,12 +1236,9 @@ export type EvaluationRunPublic = {
  */
 export type EvaluationRunStatus = 'CLAIMED' | 'RUNNING' | 'SUCCESS' | 'FAILED' | 'TIMED_OUT' | 'STALE' | 'CANCELLED';
 
-/**
- * Status representation of an evaluation run (for admin operations).
- */
 export type EvaluationRunStatusPublic = {
     /**
-     * Unique identifier for this run
+     * Evaluation run ID
      */
     eval_run_id: string;
     /**
@@ -1376,15 +1246,15 @@ export type EvaluationRunStatusPublic = {
      */
     agent_version_id: string;
     /**
-     * Suite ID
+     * Problem suite ID
      */
     suite_id: number;
     /**
-     * Validator performing evaluation
+     * Validator performing the evaluation
      */
     validator_hotkey: string;
     /**
-     * Run status
+     * Current run status
      */
     status: EvaluationRunStatus;
     /**
@@ -1392,48 +1262,45 @@ export type EvaluationRunStatusPublic = {
      */
     claimed_at: string;
     /**
-     * Lease expiration
+     * When the lease expires
      */
     lease_expires_at: string;
     /**
-     * Whether run is included in aggregate
+     * Whether this run is included in scoring
      */
     is_included: boolean;
     /**
-     * Last heartbeat
+     * Last heartbeat from the validator
      */
     last_heartbeat_at?: (string | null);
     /**
-     * Completion timestamp
+     * When the run completed
      */
     completed_at?: (string | null);
     /**
-     * When run was invalidated
+     * When the run was invalidated
      */
     invalidated_at?: (string | null);
     /**
-     * Who invalidated the run
+     * Hotkey of the admin who invalidated the run
      */
     invalidated_by?: (string | null);
     /**
-     * Reason for invalidation
+     * Reason the run was invalidated
      */
     invalidation_reason?: (string | null);
     /**
-     * Score on success
+     * Score assigned by the validator
      */
     validator_score?: (number | null);
     /**
-     * Score breakdown on success
+     * Summary of score components
      */
     score_components_summary?: ({
     [key: string]: unknown;
 } | null);
 };
 
-/**
- * 400 - Upload file exceeds size limit.
- */
 export type FileTooLargeError = {
     /**
      * Error message describing what went wrong
@@ -1445,9 +1312,6 @@ export type FileTooLargeError = {
     error_code?: "FILE_TOO_LARGE";
 };
 
-/**
- * Optional request body for heartbeat with service version info.
- */
 export type HeartbeatRequest = {
     /**
      * Docker image digests for validator stack services
@@ -1457,12 +1321,9 @@ export type HeartbeatRequest = {
 } | null);
 };
 
-/**
- * Response for heartbeat.
- */
 export type HeartbeatResponse = {
     /**
-     * New lease expiration time
+     * New lease expiry after heartbeat
      */
     lease_expires_at: string;
 };
@@ -1471,9 +1332,6 @@ export type HTTPValidationError = {
     detail?: Array<ValidationError>;
 };
 
-/**
- * 400 - Agent name validation failed.
- */
 export type InvalidAgentNameError = {
     /**
      * Error message describing what went wrong
@@ -1485,9 +1343,6 @@ export type InvalidAgentNameError = {
     error_code?: "INVALID_AGENT_NAME";
 };
 
-/**
- * 400 - Unknown or unsupported artifact type.
- */
 export type InvalidArtifactTypeError = {
     /**
      * Error message describing what went wrong
@@ -1499,19 +1354,13 @@ export type InvalidArtifactTypeError = {
     error_code?: "INVALID_ARTIFACT_TYPE";
 };
 
-/**
- * Request to invalidate an evaluation run (irreversible).
- */
 export type InvalidateRunRequest = {
     /**
-     * Reason for invalidation
+     * Reason for invalidating the run
      */
     reason: string;
 };
 
-/**
- * 400 - File content validation failed.
- */
 export type InvalidFileError = {
     /**
      * Error message describing what went wrong
@@ -1523,9 +1372,6 @@ export type InvalidFileError = {
     error_code?: "INVALID_FILE";
 };
 
-/**
- * 400 - Problem ID is not valid for this suite.
- */
 export type InvalidProblemIdError = {
     /**
      * Error message describing what went wrong
@@ -1537,9 +1383,6 @@ export type InvalidProblemIdError = {
     error_code?: "INVALID_PROBLEM_ID";
 };
 
-/**
- * Entry in the leaderboard.
- */
 export type LeaderboardEntry = {
     /**
      * Leaderboard rank
@@ -1595,43 +1438,37 @@ export type LeaderboardEntry = {
     top_at?: (string | null);
 };
 
-/**
- * Response for leaderboard endpoint.
- */
 export type LeaderboardResponse = {
     /**
-     * Suite information
+     * Total entries matching filter
      */
-    suite: SuitePublic;
+    total: number;
     /**
-     * Leaderboard entries
+     * Page size
      */
-    entries: Array<LeaderboardEntry>;
+    limit: number;
     /**
-     * Total entries
+     * Page offset
      */
-    total: number;
+    offset: number;
     /**
-     * Distinct miner hotkeys on leaderboard
+     * Suite information
      */
-    unique_miners: number;
+    suite: SuitePublic;
     /**
-     * Page size
+     * Leaderboard entries
      */
-    limit: number;
+    entries: Array<LeaderboardEntry>;
     /**
-     * Page offset
+     * Distinct miner hotkeys on leaderboard
      */
-    offset: number;
+    unique_miners: number;
     /**
      * Score required to dethrone current top
      */
     challenge_threshold?: (number | null);
 };
 
-/**
- * 409 - Evaluation run lease has expired.
- */
 export type LeaseExpiredError = {
     /**
      * Error message describing what went wrong
@@ -1643,9 +1480,6 @@ export type LeaseExpiredError = {
     error_code?: "LEASE_EXPIRED";
 };
 
-/**
- * Response from logout endpoint.
- */
 export type LogoutResponse = {
     /**
      * Whether logout was successful
@@ -1653,27 +1487,21 @@ export type LogoutResponse = {
     success: boolean;
 };
 
-/**
- * Envelope response for GET /v1/miner/agents with cooldown status.
- */
 export type MinerAgentsResponse = {
     /**
-     * Miner's agents
+     * List of agents owned by the miner
      */
     agents: Array<AgentPublic>;
     /**
-     * Whether the miner can submit now
+     * Whether the miner is currently allowed to submit a new agent
      */
     can_submit: boolean;
     /**
-     * When next submission is allowed (ISO 8601), null if no cooldown
+     * Earliest time the miner may submit again, if on cooldown
      */
     next_allowed_at?: (string | null);
 };
 
-/**
- * 404 - Miner not found.
- */
 export type MinerNotFoundError = {
     /**
      * Error message describing what went wrong
@@ -1685,9 +1513,6 @@ export type MinerNotFoundError = {
     error_code?: "MINER_NOT_FOUND";
 };
 
-/**
- * 400 - Required parameter is missing.
- */
 export type MissingParameterError = {
     /**
      * Error message describing what went wrong
@@ -1699,9 +1524,6 @@ export type MissingParameterError = {
     error_code?: "MISSING_PARAMETER";
 };
 
-/**
- * 400 - Score is required for SUCCESS status.
- */
 export type MissingScoreError = {
     /**
      * Error message describing what went wrong
@@ -1713,9 +1535,6 @@ export type MissingScoreError = {
     error_code?: "MISSING_SCORE";
 };
 
-/**
- * 503 - No active problem suite available.
- */
 export type NoActiveSuiteError = {
     /**
      * Error message describing what went wrong
@@ -1727,9 +1546,6 @@ export type NoActiveSuiteError = {
     error_code?: "NO_ACTIVE_SUITE";
 };
 
-/**
- * 409 - Caller does not own this evaluation run.
- */
 export type NotRunOwnerError = {
     /**
      * Error message describing what went wrong
@@ -1741,9 +1557,6 @@ export type NotRunOwnerError = {
     error_code?: "NOT_RUN_OWNER";
 };
 
-/**
- * A work item awaiting validator evaluations.
- */
 export type PendingEvaluation = {
     /**
      * Unique work item identifier
@@ -1799,9 +1612,6 @@ export type PendingEvaluation = {
     race_id?: (string | null);
 };
 
-/**
- * Response for pending evaluations endpoint.
- */
 export type PendingEvaluationsResponse = {
     /**
      * Aggregate queue statistics
@@ -1813,9 +1623,6 @@ export type PendingEvaluationsResponse = {
     items: Array<PendingEvaluation>;
 };
 
-/**
- * Aggregate statistics for pending evaluations.
- */
 export type PendingEvaluationSummary = {
     /**
      * Number of open work items
@@ -1831,42 +1638,36 @@ export type PendingEvaluationSummary = {
     total_runs_active: number;
 };
 
-/**
- * Request for presigned upload URL.
- */
 export type PresignUploadRequest = {
     /**
-     * Content type of the upload
+     * MIME type of the upload
      */
     content_type?: string;
     /**
-     * Size of the upload in bytes
+     * Size in bytes of the upload payload
      */
     content_length: number;
     /**
-     * Evaluation run ID
+     * Evaluation run these results belong to
      */
     eval_run_id: string;
     /**
-     * Problem ID
+     * Problem these results belong to
      */
     problem_id: string;
 };
 
-/**
- * Response with presigned upload URL.
- */
 export type PresignUploadResponse = {
     /**
-     * Presigned S3 PUT URL
+     * Presigned URL to upload to
      */
     upload_url: string;
     /**
-     * HTTP method to use
+     * HTTP method to use for upload
      */
     method?: string;
     /**
-     * S3 key where the file will be stored
+     * S3 key where the results will be stored
      */
     results_s3_key: string;
     /**
@@ -1875,9 +1676,6 @@ export type PresignUploadResponse = {
     expires_at: string;
 };
 
-/**
- * 404 - Problem not found in suite.
- */
 export type ProblemNotFoundError = {
     /**
      * Error message describing what went wrong
@@ -1889,9 +1687,6 @@ export type ProblemNotFoundError = {
     error_code?: "PROBLEM_NOT_FOUND";
 };
 
-/**
- * Progress entry for a single problem showing results from all validators.
- */
 export type ProblemProgressEntry = {
     /**
      * Problem ID
@@ -1915,12 +1710,9 @@ export type ProblemProgressEntry = {
     validator_results?: Array<ValidatorProblemResult>;
 };
 
-/**
- * Progress update for a single problem.
- */
 export type ProblemProgressUpdate = {
     /**
-     * Problem ID
+     * Problem being reported on
      */
     problem_id: string;
     /**
@@ -1928,36 +1720,33 @@ export type ProblemProgressUpdate = {
      */
     status: ProblemStatus;
     /**
-     * Score if available
+     * Normalised score for this problem
      */
     score?: (number | null);
     /**
-     * Score breakdown if available
+     * Breakdown of score components
      */
     score_components_summary?: ({
     [key: string]: unknown;
 } | null);
     /**
-     * S3 key for this problem's logs
+     * S3 key for problem-level logs
      */
     logs_s3_key?: (string | null);
     /**
-     * Reasoning quality score from LLM judge
+     * Reasoning quality score
      */
     reasoning_score?: (number | null);
     /**
-     * Number of failed inference calls (429s, timeouts) for this problem
+     * Number of failed inference calls
      */
     inference_failure_count?: (number | null);
     /**
-     * Total number of inference calls made for this problem
+     * Total number of inference calls
      */
     inference_total?: (number | null);
 };
 
-/**
- * Public representation of a problem.
- */
 export type ProblemPublic = {
     /**
      * Unique identifier for the problem
@@ -1975,62 +1764,44 @@ export type ProblemPublic = {
     };
 };
 
-/**
- * Status of problem evaluation.
- */
 export type ProblemStatus = 'PENDING' | 'RUNNING' | 'SUCCESS' | 'FAILED' | 'SKIPPED' | 'TIMED_OUT';
 
-/**
- * Request to update per-problem progress.
- */
 export type ProgressUpdateRequest = {
     /**
-     * List of problem progress updates
+     * Per-problem progress updates
      */
     problems: Array<ProblemProgressUpdate>;
 };
 
-/**
- * Response for progress update.
- */
 export type ProgressUpdateResponse = {
     /**
-     * Whether updates were accepted
+     * Whether the update was accepted
      */
     accepted?: boolean;
 };
 
-/**
- * Response for current race state.
- */
 export type RaceCurrentResponse = {
     /**
-     * Active race, if any
+     * Current race, if any
      */
     race?: (RacePublic | null);
     /**
-     * Qualifiers for the active race
+     * Race qualifiers
      */
     qualifiers?: Array<RaceQualifierPublic>;
 };
 
-/**
- * Detailed view of a single race.
- */
 export type RaceDetailResponse = {
     /**
-     * Race information
+     * Race details
      */
     race: RacePublic;
     /**
-     * Qualifiers with scores
+     * Race qualifiers
      */
     qualifiers?: Array<RaceQualifierPublic>;
 };
 
-/**
- * Detailed diagnostics for a specific race.
- */
 export type RaceDiagnosticsResponse = {
     /**
      * Race ID
@@ -2050,27 +1821,35 @@ export type RaceDiagnosticsResponse = {
     race_completed_at?: (string | null);
     winner_agent_version_id?: (string | null);
     winner_score?: (number | null);
+    /**
+     * Score threshold for qualifying
+     */
     qualifying_threshold?: (number | null);
+    /**
+     * Current incumbent agent version ID
+     */
     incumbent_agent_version_id?: (string | null);
+    /**
+     * Seed used for problem selection
+     */
     problem_seed?: (string | null);
     /**
-     * Number of race problems
+     * Number of problems in the race
      */
     problem_count?: number;
+    /**
+     * Qualified agent versions
+     */
     qualifiers?: Array<RaceQualifierEntry>;
+    /**
+     * Race work items
+     */
     work_items?: Array<RaceWorkItemEntry>;
 };
 
-/**
- * Paginated list of completed races.
- */
 export type RaceHistoryResponse = {
     /**
-     * Past races
-     */
-    races: Array<RacePublic>;
-    /**
-     * Total count
+     * Total entries matching filter
      */
     total: number;
     /**
@@ -2081,11 +1860,12 @@ export type RaceHistoryResponse = {
      * Page offset
      */
     offset: number;
+    /**
+     * Historical races
+     */
+    races: Array<RacePublic>;
 };
 
-/**
- * 404 - Race not found.
- */
 export type RaceNotFoundError = {
     /**
      * Error message describing what went wrong
@@ -2097,9 +1877,6 @@ export type RaceNotFoundError = {
     error_code?: "RACE_NOT_FOUND";
 };
 
-/**
- * Public view of a race — extends RaceBase with public-facing fields.
- */
 export type RacePublic = {
     /**
      * Race ID
@@ -2120,26 +1897,23 @@ export type RacePublic = {
     winner_agent_version_id?: (string | null);
     winner_score?: (number | null);
     /**
-     * Minimum score to qualify
+     * Score threshold for qualifying
      */
     qualifying_threshold?: (number | null);
     /**
-     * Winning agent name
+     * Name of the winning agent
      */
     winner_agent_name?: (string | null);
     /**
-     * Number of qualifiers
+     * Number of qualifiers in this race
      */
     qualifier_count?: number;
     /**
-     * When race was created
+     * When the race was created
      */
-    created_at: string;
+    created_at?: (string | null);
 };
 
-/**
- * A qualifier in a race.
- */
 export type RaceQualifierEntry = {
     /**
      * Agent version ID
@@ -2171,9 +1945,6 @@ export type RaceQualifierEntry = {
     race_score?: (number | null);
 };
 
-/**
- * A qualifier in a race (public view) — extends RaceQualifierEntry with rank.
- */
 export type RaceQualifierPublic = {
     /**
      * Agent version ID
@@ -2204,14 +1975,11 @@ export type RaceQualifierPublic = {
      */
     race_score?: (number | null);
     /**
-     * Final rank in race (1 = winner)
+     * Rank within the race
      */
     race_rank?: (number | null);
 };
 
-/**
- * Summary of a race for the current state view.
- */
 export type RaceSummary = {
     /**
      * Race ID
@@ -2232,18 +2000,15 @@ export type RaceSummary = {
     winner_agent_version_id?: (string | null);
     winner_score?: (number | null);
     /**
-     * Number of qualifiers
+     * Number of qualifiers in this race
      */
     qualifier_count?: number;
     /**
-     * Number of work items
+     * Number of work items in this race
      */
     work_item_count?: number;
 };
 
-/**
- * A work item in a race.
- */
 export type RaceWorkItemEntry = {
     /**
      * Agent version ID
@@ -2254,34 +2019,31 @@ export type RaceWorkItemEntry = {
      */
     agent_name?: (string | null);
     /**
-     * Evaluation phase
+     * Race phase (qualifying or race)
      */
     phase: string;
     /**
-     * Whether work is complete
+     * Whether the work item is closed
      */
     is_closed: boolean;
     /**
-     * Whether work was cancelled
+     * Whether the work item is cancelled
      */
     is_cancelled: boolean;
     /**
-     * Successful evaluations
+     * Number of included successful runs
      */
     included_success_count: number;
     /**
-     * Active evaluations
+     * Number of active runs
      */
     active_count: number;
     /**
-     * Required successful evaluations
+     * Required number of successful runs
      */
     required_successes: number;
 };
 
-/**
- * 429 - Rate limit exceeded.
- */
 export type RateLimitExceededError = {
     /**
      * Error message describing what went wrong
@@ -2293,89 +2055,74 @@ export type RateLimitExceededError = {
     error_code?: "RATE_LIMIT_EXCEEDED";
 };
 
-/**
- * Response for reaper service statistics.
- */
 export type ReaperStatsResponse = {
     /**
-     * Whether the reaper service is enabled
+     * Whether the reaper is enabled
      */
     enabled: boolean;
     /**
-     * Whether the reaper background task is running
+     * Whether the reaper is currently running
      */
     is_running: boolean;
     /**
-     * Last reaper cycle timestamp
+     * When the reaper last ran
      */
     last_run_at?: (string | null);
     /**
-     * Total runs reaped since service start
+     * Total number of runs reaped since startup
      */
     runs_reaped_total: number;
     /**
-     * Runs reaped in the last cycle
+     * Number of runs reaped in the last cycle
      */
     runs_reaped_last_cycle: number;
     /**
-     * Duration of the last reaper cycle in ms
+     * Duration of the last reaper cycle in milliseconds
      */
     last_cycle_duration_ms: number;
     /**
-     * Number of reaper cycle errors encountered
+     * Total number of reaper errors
      */
     error_count: number;
     /**
-     * Number of Redis stats persistence errors
+     * Total number of Redis-related reaper errors
      */
     redis_error_count: number;
     /**
-     * Configured interval between reaper cycles
+     * Reaper cycle interval in seconds
      */
     interval_seconds: number;
 };
 
-/**
- * Request to re-evaluate an agent version.
- */
 export type ReevaluateRequest = {
     /**
      * Reason for re-evaluation
      */
     reason: string;
     /**
-     * Suite ID (defaults to current suite)
+     * Specific suite to re-evaluate against
      */
     suite_id?: (number | null);
     /**
-     * Override required successes
+     * Override for number of required successful evaluations
      */
     required_successes?: (number | null);
 };
 
-/**
- * Response for re-evaluation request.
- */
 export type ReevaluateResponse = {
     /**
-     * Agent version ID
+     * Agent version queued for re-evaluation
      */
     agent_version_id: string;
 };
 
-/**
- * Request to reinstate an agent version.
- */
 export type ReinstateRequest = {
     /**
-     * Suite ID (defaults to current suite)
+     * Specific suite to reinstate for
      */
     suite_id?: (number | null);
 };
 
-/**
- * 409 - Evaluation run is already complete.
- */
 export type RunAlreadyCompleteError = {
     /**
      * Error message describing what went wrong
@@ -2387,9 +2134,6 @@ export type RunAlreadyCompleteError = {
     error_code?: "RUN_ALREADY_COMPLETE";
 };
 
-/**
- * Representation of a currently running evaluation.
- */
 export type RunningEvaluation = {
     /**
      * Unique identifier for this run
@@ -2437,12 +2181,9 @@ export type RunningEvaluation = {
     race_id?: (string | null);
 };
 
-/**
- * Problems for an evaluation run.
- */
 export type RunProblemsResponse = {
     /**
-     * Problems to evaluate against
+     * Problems to evaluate
      */
     problems: Array<ProblemPublic>;
 };
@@ -2477,9 +2218,6 @@ export type ScoreBelowThresholdError = {
     margin: number;
 };
 
-/**
- * Request body for session creation endpoint.
- */
 export type SessionRequest = {
     /**
      * SS58 hotkey address
@@ -2495,9 +2233,6 @@ export type SessionRequest = {
     signature: string;
 };
 
-/**
- * Response from session creation endpoint.
- */
 export type SessionResponse = {
     /**
      * Session token for authenticated requests
@@ -2513,89 +2248,74 @@ export type SessionResponse = {
     role: string;
 };
 
-/**
- * Request to set an agent version as the top agent for emissions.
- */
 export type SetTopRequest = {
     /**
-     * Suite ID (defaults to current suite)
+     * Specific suite to set top agent for
      */
     suite_id?: (number | null);
     /**
-     * Bypass the challenge threshold check (recorded in audit)
+     * Force set even if version has lower score
      */
     force?: boolean;
 };
 
-/**
- * Response for set-top operation.
- */
 export type SetTopResponse = {
     /**
-     * New top agent version
+     * Agent version set as top
      */
     agent_version_id: string;
     /**
-     * Suite ID
+     * Suite the top agent was set for
      */
     suite_id: number;
     /**
-     * Previous top agent version (now marked was_top)
+     * Previous top agent version ID, if any
      */
     previous_top_agent_version_id?: (string | null);
     /**
-     * When this agent became top
+     * Timestamp when the top agent was set
      */
     top_at: string;
 };
 
-/**
- * Request body for storing a Chutes refresh token.
- */
 export type StoreChutesTokenRequest = {
     /**
-     * Chutes OAuth refresh token from a fresh code exchange
+     * Chutes OAuth refresh token to store
      */
     refresh_token: string;
 };
 
-/**
- * Response model for agent submission.
- */
 export type SubmitAgentResponse = {
     /**
-     * Agent ID (created if needed)
+     * Unique identifier for the created agent
      */
     agent_id?: (string | null);
     /**
-     * Agent version ID (if accepted)
+     * Unique identifier for the created agent version
      */
     agent_version_id?: (string | null);
     /**
-     * Whether submission was accepted
+     * Whether the submission was accepted or rejected
      */
     admission_status: AdmissionStatus;
     /**
-     * Reason for rejection if rejected
+     * Reason for rejection, if the submission was rejected
      */
     admission_reason?: (AdmissionReason | null);
     /**
-     * When next submission is allowed (if in cooldown)
+     * Earliest time the miner may submit again after cooldown
      */
     next_allowed_at?: (string | null);
     /**
-     * Miner hotkey that submitted
+     * Hotkey of the miner who submitted the agent
      */
     hotkey: string;
     /**
-     * Status message
+     * Human-readable status message
      */
     message?: string;
 };
 
-/**
- * 404 - Problem suite not found.
- */
 export type SuiteNotFoundError = {
     /**
      * Error message describing what went wrong
@@ -2607,9 +2327,6 @@ export type SuiteNotFoundError = {
     error_code?: "SUITE_NOT_FOUND";
 };
 
-/**
- * Public representation of a problem suite.
- */
 export type SuitePublic = {
     /**
      * Problem suite version/ID
@@ -2625,9 +2342,6 @@ export type SuitePublic = {
     is_active: boolean;
 };
 
-/**
- * Response for suite with its problems.
- */
 export type SuiteWithProblemsResponse = {
     /**
      * Suite information
@@ -2639,14 +2353,8 @@ export type SuiteWithProblemsResponse = {
     problems: Array<ProblemPublic>;
 };
 
-/**
- * Terminal statuses for evaluation runs.
- */
 export type TerminalStatus = 'SUCCESS' | 'FAILED' | 'TIMED_OUT';
 
-/**
- * Response for top agent endpoint.
- */
 export type TopAgentResponse = {
     /**
      * Active suite ID
@@ -2688,9 +2396,6 @@ export type TopAgentResponse = {
     margin?: (number | null);
 };
 
-/**
- * A single entry in the top agent history.
- */
 export type TopHistoryEntry = {
     /**
      * Agent version ID
@@ -2730,9 +2435,6 @@ export type TopHistoryEntry = {
     suite_id: number;
 };
 
-/**
- * Response for top agent history endpoint.
- */
 export type TopHistoryResponse = {
     /**
      * Suite ID
@@ -2754,9 +2456,17 @@ export type ValidationError = {
     };
 };
 
-/**
- * Information about the agent currently being evaluated by a validator.
- */
+export type ValidationErrorError = {
+    /**
+     * Error message describing what went wrong
+     */
+    detail: string;
+    /**
+     * Error code for programmatic handling
+     */
+    error_code?: "VALIDATION_ERROR";
+};
+
 export type ValidatorCurrentAgent = {
     /**
      * Name of the agent being evaluated
@@ -2776,9 +2486,6 @@ export type ValidatorCurrentAgent = {
     started_at: string;
 };
 
-/**
- * 404 - Validator not found.
- */
 export type ValidatorNotFoundError = {
     /**
      * Error message describing what went wrong
@@ -2790,9 +2497,6 @@ export type ValidatorNotFoundError = {
     error_code?: "VALIDATOR_NOT_FOUND";
 };
 
-/**
- * Result from a single validator for a specific problem.
- */
 export type ValidatorProblemResult = {
     /**
      * Evaluation run ID this result belongs to
@@ -2834,9 +2538,6 @@ export type ValidatorProblemResult = {
     inference_total?: (number | null);
 };
 
-/**
- * Public representation of a validator.
- */
 export type ValidatorPublic = {
     /**
      * Validator's SS58 address
@@ -2887,11 +2588,11 @@ export type ValidatorPublic = {
 };
 
 /**
- * Response for validator scoring and performance analytics.
+ * Aggregated validator scoring analysis.
  */
 export type ValidatorScoresResponse = {
     /**
-     * Per-validator summaries
+     * Per-validator score summaries
      */
     validators: Array<ValidatorScoreSummary>;
     /**
@@ -2899,33 +2600,30 @@ export type ValidatorScoresResponse = {
      */
     global_avg_score: number;
     /**
-     * Global standard deviation
+     * Global standard deviation of scores
      */
     global_stddev: number;
     /**
-     * Global average execution time
+     * Global average execution time in seconds
      */
     global_avg_execution_seconds?: number;
 };
 
-/**
- * Aggregated scoring and performance stats for a single validator.
- */
 export type ValidatorScoreSummary = {
     /**
-     * Validator hotkey
+     * Validator's SS58 hotkey
      */
     validator_hotkey: string;
     /**
-     * Total completed runs
+     * Total number of completed runs
      */
     total_runs: number;
     /**
-     * Mean score across runs
+     * Average score across runs
      */
     avg_score: number;
     /**
-     * Median score
+     * Median score across runs
      */
     median_score: number;
     /**
@@ -2941,15 +2639,15 @@ export type ValidatorScoreSummary = {
      */
     max_score: number;
     /**
-     * Percentage deviation from the global average (negative = below)
+     * Deviation of this validator's average from the global average
      */
     deviation_from_global: number;
     /**
-     * True if deviation exceeds 1.5 standard deviations from global mean
+     * Whether this validator is a scoring outlier
      */
     is_outlier: boolean;
     /**
-     * Mean seconds from claimed to completed
+     * Average execution time in seconds
      */
     avg_execution_seconds?: number;
     /**
@@ -2957,55 +2655,49 @@ export type ValidatorScoreSummary = {
      */
     median_execution_seconds?: number;
     /**
-     * Fastest run
+     * Minimum execution time in seconds
      */
     min_execution_seconds?: number;
     /**
-     * Slowest run
+     * Maximum execution time in seconds
      */
     max_execution_seconds?: number;
     /**
-     * % deviation from global avg execution time
+     * Percentage deviation of execution time from global average
      */
     execution_deviation_pct?: number;
     /**
-     * Significantly slower than peers
+     * Whether this validator is a slow execution outlier
      */
     is_slow_outlier?: boolean;
     /**
-     * SUCCESS runs
+     * Number of successful runs
      */
     success_count?: number;
     /**
-     * FAILED runs
+     * Number of failed runs
      */
     failed_count?: number;
     /**
-     * TIMED_OUT runs
+     * Number of timed-out runs
      */
     timed_out_count?: number;
     /**
-     * success / total
+     * Success rate as a fraction
      */
     success_rate?: number;
     /**
-     * Most recent failure reason
+     * Reason for the most recent failure
      */
     last_failure_reason?: (string | null);
     /**
-     * When last failure occurred
+     * When the most recent failure occurred
      */
     last_failure_at?: (string | null);
 };
 
-/**
- * Status of a validator.
- */
 export type ValidatorStatus = 'evaluating' | 'available';
 
-/**
- * Request body for waitlist signup.
- */
 export type WaitlistSignupRequest = {
     /**
      * Email address to add to the waitlist
@@ -3017,9 +2709,6 @@ export type WaitlistSignupRequest = {
     source?: string;
 };
 
-/**
- * Response from waitlist signup.
- */
 export type WaitlistSignupResponse = {
     /**
      * Whether signup was recorded
@@ -3027,20 +2716,17 @@ export type WaitlistSignupResponse = {
     success: boolean;
 };
 
-/**
- * Status of the work item after completion.
- */
 export type WorkItemStatus = {
     /**
-     * Number of successful runs
+     * Number of successful runs included so far
      */
     included_success_count: number;
     /**
-     * Required successful runs
+     * Number of successful runs required to close the work item
      */
     required_successes: number;
     /**
-     * Whether work item is closed
+     * Whether the work item is closed
      */
     is_closed: boolean;
 };
@@ -3398,7 +3084,7 @@ export type PresignUploadData = {
 
 export type PresignUploadResponse2 = (PresignUploadResponse);
 
-export type PresignUploadError = ((FileTooLargeError | ValidationError) | (EvalRunNotFoundError | ProblemNotFoundError) | NotRunOwnerError | HTTPValidationError);
+export type PresignUploadError = ((FileTooLargeError | ValidationErrorError) | (EvalRunNotFoundError | ProblemNotFoundError) | NotRunOwnerError | HTTPValidationError);
 
 export type CompleteRunData = {
     body: CompleteRunRequest;
@@ -3412,7 +3098,7 @@ export type CompleteRunData = {
 
 export type CompleteRunResponse2 = (CompleteRunResponse);
 
-export type CompleteRunError = ((MissingScoreError | ValidationError) | EvalRunNotFoundError | (NotRunOwnerError | RunAlreadyCompleteError) | HTTPValidationError);
+export type CompleteRunError = ((MissingScoreError | ValidationErrorError) | EvalRunNotFoundError | (NotRunOwnerError | RunAlreadyCompleteError) | HTTPValidationError);
 
 export type GetRunProblemsData = {
     path: {
@@ -3646,9 +3332,7 @@ export type ClearMinerCooldownData = {
     };
 };
 
-export type ClearMinerCooldownResponse = ({
-    [key: string]: unknown;
-});
+export type ClearMinerCooldownResponse = (ClearCooldownResponse);
 
 export type ClearMinerCooldownError = (HTTPValidationError);