@oro-ai/sdk 0.6.8

package/dist/index.d.mts

@@ -0,0 +1,2715 @@
+import * as _hey_api_client_fetch from '@hey-api/client-fetch';
+import { OptionsLegacyParser } from '@hey-api/client-fetch';
+
+/**
+ * Response for suite activation.
+ */
+type ActivateSuiteResponse = {
+    /**
+     * Activated suite ID
+     */
+    suite_id: number;
+    /**
+     * Suite version number
+     */
+    suite_version: number;
+    /**
+     * Whether this suite is active
+     */
+    is_active: boolean;
+};
+/**
+ * Reason for rejection of agent submission.
+ */
+type AdmissionReason = 'COOLDOWN' | 'INVALID_FILE' | 'NOT_REGISTERED_ONCHAIN' | 'BANNED' | 'NO_ACTIVE_SUITE';
+/**
+ * Status of agent submission admission.
+ */
+type AdmissionStatus = 'ACCEPTED' | 'REJECTED';
+/**
+ * 404 - Agent not found.
+ */
+type AgentNotFoundError = {
+    /**
+     * Error message describing what went wrong
+     */
+    detail: string;
+    /**
+     * Error code for programmatic handling
+     */
+    error_code?: "AGENT_NOT_FOUND";
+};
+/**
+ * Public representation of an agent.
+ */
+type AgentPublic = {
+    /**
+     * Unique identifier for the agent
+     */
+    agent_id: string;
+    /**
+     * Owner's hotkey
+     */
+    miner_hotkey: string;
+    /**
+     * Human-readable name for the agent
+     */
+    agent_name: string;
+    /**
+     * When the agent was created
+     */
+    created_at: string;
+};
+/**
+ * Entry in agent version history list.
+ */
+type AgentVersionHistoryEntry = {
+    /**
+     * Version ID
+     */
+    agent_version_id: string;
+    /**
+     * Version number within this agent (v1, v2, etc.)
+     */
+    version_number: number;
+    /**
+     * Submission timestamp
+     */
+    submitted_at: string;
+    /**
+     * Current state
+     */
+    state: AgentVersionState;
+    /**
+     * Final score if eligible
+     */
+    final_score?: (number | null);
+};
+/**
+ * 404 - Agent version not found.
+ */
+type AgentVersionNotFoundError = {
+    /**
+     * Error message describing what went wrong
+     */
+    detail: string;
+    /**
+     * Error code for programmatic handling
+     */
+    error_code?: "AGENT_VERSION_NOT_FOUND";
+};
+/**
+ * Response for agent version problem progress.
+ */
+type AgentVersionProblemsResponse = {
+    /**
+     * Agent version ID
+     */
+    agent_version_id: string;
+    /**
+     * Suite ID
+     */
+    suite_id?: (number | null);
+    /**
+     * Problem progress list
+     */
+    problems: Array<ProblemProgressEntry>;
+};
+/**
+ * Public representation of an agent version.
+ */
+type AgentVersionPublic = {
+    /**
+     * Unique identifier for this version
+     */
+    agent_version_id: string;
+    /**
+     * Parent agent ID
+     */
+    agent_id: string;
+    /**
+     * Agent name
+     */
+    agent_name: string;
+    /**
+     * Owner's hotkey
+     */
+    miner_hotkey: string;
+    /**
+     * Version number within this agent (v1, v2, etc.)
+     */
+    version_number: number;
+    /**
+     * Suite this version was submitted for
+     */
+    suite_id?: (number | null);
+    /**
+     * When this version was submitted
+     */
+    submitted_at: string;
+    /**
+     * Final score if eligible
+     */
+    latest_final_score?: (number | null);
+};
+/**
+ * State of an agent version evaluation.
+ */
+type AgentVersionState = 'RECEIVED' | 'QUEUED' | 'RUNNING' | 'ELIGIBLE' | 'DISCARDED' | 'CANCELLED';
+/**
+ * Status response for an agent version.
+ */
+type AgentVersionStatus = {
+    /**
+     * Unique identifier for this version
+     */
+    agent_version_id: string;
+    /**
+     * Agent name
+     */
+    agent_name: string;
+    /**
+     * Owner's hotkey
+     */
+    miner_hotkey: string;
+    /**
+     * Version number within this agent (v1, v2, etc.)
+     */
+    version_number: number;
+    /**
+     * Suite ID
+     */
+    suite_id?: (number | null);
+    /**
+     * Submission timestamp
+     */
+    submitted_at: string;
+    /**
+     * Current state of the version
+     */
+    state: AgentVersionState;
+    /**
+     * Required successful evaluations
+     */
+    required_successes?: number;
+    /**
+     * Number of successful evaluations
+     */
+    success_count?: number;
+    /**
+     * Number of active evaluations
+     */
+    active_count?: number;
+    /**
+     * Whether evaluation is closed
+     */
+    is_closed?: boolean;
+    /**
+     * Final score if eligible
+     */
+    final_score?: (number | null);
+    /**
+     * Whether artifacts are released
+     */
+    release_state?: ArtifactReleaseState;
+    /**
+     * Per-validator scores on success
+     */
+    per_validator_success_scores?: ({
+        [key: string]: (number);
+    } | null);
+};
+/**
+ * 409 - Resource is already invalidated.
+ */
+type AlreadyInvalidatedError = {
+    /**
+     * Error message describing what went wrong
+     */
+    detail: string;
+    /**
+     * Error code for programmatic handling
+     */
+    error_code?: "ALREADY_INVALIDATED";
+};
+/**
+ * Request for artifact download URL.
+ */
+type ArtifactDownloadRequest = {
+    /**
+     * Type of artifact to download
+     */
+    artifact_type: ArtifactType;
+    /**
+     * Agent version ID
+     */
+    agent_version_id: string;
+    /**
+     * Run ID for run-scoped artifacts
+     */
+    eval_run_id?: (string | null);
+    /**
+     * Problem ID for per-problem artifact downloads
+     */
+    problem_id?: (string | null);
+};
+/**
+ * Response with presigned download URL.
+ */
+type ArtifactDownloadResponse = {
+    /**
+     * Presigned download URL
+     */
+    download_url: string;
+    /**
+     * URL expiration time
+     */
+    expires_at: string;
+};
+/**
+ * 404 - Artifact not found or not available.
+ */
+type ArtifactNotFoundError = {
+    /**
+     * Error message describing what went wrong
+     */
+    detail: string;
+    /**
+     * Error code for programmatic handling
+     */
+    error_code?: "ARTIFACT_NOT_FOUND";
+};
+/**
+ * 404 - Artifact exists but is not yet released.
+ */
+type ArtifactNotReleasedError = {
+    /**
+     * Error message describing what went wrong
+     */
+    detail: string;
+    /**
+     * Error code for programmatic handling
+     */
+    error_code?: "ARTIFACT_NOT_RELEASED";
+};
+/**
+ * Release state of agent version artifacts.
+ */
+type ArtifactReleaseState = 'HIDDEN' | 'RELEASED';
+/**
+ * Type of artifact for download.
+ */
+type ArtifactType = 'AGENT_CODE' | 'EVAL_LOGS_BUNDLE' | 'EVAL_PROBLEM_LOGS';
+/**
+ * 409 - Validator is at maximum concurrent evaluation capacity.
+ */
+type AtCapacityError = {
+    /**
+     * Error message describing what went wrong
+     */
+    detail: string;
+    /**
+     * Error code for programmatic handling
+     */
+    error_code?: "AT_CAPACITY";
+};
+/**
+ * Audit event log entry.
+ */
+type AuditEventEntry = {
+    /**
+     * Event ID
+     */
+    event_id: string;
+    /**
+     * Action performed
+     */
+    action: string;
+    /**
+     * Type of target entity
+     */
+    target_type: string;
+    /**
+     * Target entity ID
+     */
+    target_id: string;
+    /**
+     * Admin who performed the action
+     */
+    actor_hotkey: string;
+    /**
+     * Reason provided
+     */
+    reason?: (string | null);
+    /**
+     * Additional context
+     */
+    details?: ({
+        [key: string]: unknown;
+    } | null);
+    /**
+     * When the event occurred
+     */
+    created_at: string;
+};
+/**
+ * Response for audit events list.
+ */
+type AuditEventsResponse = {
+    /**
+     * Audit events
+     */
+    events: Array<AuditEventEntry>;
+    /**
+     * Total events matching filter
+     */
+    total: number;
+    /**
+     * Page size
+     */
+    limit: number;
+    /**
+     * Page offset
+     */
+    offset: number;
+};
+/**
+ * Request to ban a miner or validator.
+ */
+type BanRequest = {
+    /**
+     * Reason for the ban
+     */
+    reason: string;
+};
+/**
+ * Response for ban/unban operations.
+ */
+type BanResponse = {
+    /**
+     * Affected hotkey
+     */
+    hotkey: string;
+    /**
+     * New ban state
+     */
+    is_banned: boolean;
+};
+type Body_submit_agent = {
+    /**
+     * Name for this agent (unique per miner)
+     */
+    agent_name: string;
+    /**
+     * Python agent file (max 1MB)
+     */
+    file: (Blob | File);
+    /**
+     * Chutes OAuth refresh token for miner-funded inference
+     */
+    chutes_refresh_token?: (string | null);
+};
+/**
+ * Request to cancel an agent version's evaluation.
+ */
+type CancelRequest = {
+    /**
+     * Reason for cancellation
+     */
+    reason: string;
+};
+/**
+ * Response for cancel operation.
+ */
+type CancelResponse = {
+    /**
+     * Agent version ID
+     */
+    agent_version_id: string;
+    /**
+     * Number of runs cancelled
+     */
+    cancelled_runs: number;
+};
+/**
+ * Request body for challenge endpoint.
+ */
+type ChallengeRequest = {
+    /**
+     * SS58 hotkey address
+     */
+    hotkey: string;
+};
+/**
+ * Response from challenge endpoint.
+ */
+type ChallengeResponse = {
+    /**
+     * Challenge string to sign
+     */
+    challenge: string;
+    /**
+     * Unix timestamp when challenge expires
+     */
+    expires_at: number;
+};
+/**
+ * Response for successful work claim.
+ */
+type ClaimWorkResponse = {
+    /**
+     * Unique identifier for the evaluation run
+     */
+    eval_run_id: string;
+    /**
+     * Agent version to evaluate
+     */
+    agent_version_id: string;
+    /**
+     * Problem suite ID
+     */
+    suite_id: number;
+    /**
+     * When the lease expires
+     */
+    lease_expires_at: string;
+    /**
+     * Presigned URL to download agent code
+     */
+    code_download_url: string;
+    /**
+     * Fresh Chutes access token for miner-funded inference
+     */
+    chutes_access_token?: (string | null);
+};
+/**
+ * 422 - Static analysis found issues in submitted code.
+ */
+type CodeAnalysisError = {
+    /**
+     * Error message describing what went wrong
+     */
+    detail: string;
+    /**
+     * Error code for programmatic handling
+     */
+    error_code?: "CODE_ANALYSIS_ERROR";
+    /**
+     * List of violations found (rule, severity, message, line)
+     */
+    violations?: Array<{
+        [key: string]: unknown;
+    }>;
+};
+/**
+ * Request to complete an evaluation run.
+ */
+type CompleteRunRequest = {
+    /**
+     * Final status of the run
+     */
+    terminal_status: TerminalStatus;
+    /**
+     * Score (required if SUCCESS)
+     */
+    validator_score?: (number | null);
+    /**
+     * Score breakdown (required if SUCCESS)
+     */
+    score_components?: ({
+        [key: string]: unknown;
+    } | null);
+    /**
+     * S3 key for run-level logs bundle (optional, per-problem logs preferred)
+     */
+    results_s3_key?: (string | null);
+};
+/**
+ * Response for run completion.
+ */
+type CompleteRunResponse = {
+    /**
+     * Evaluation run ID
+     */
+    eval_run_id: string;
+    /**
+     * New status of the run
+     */
+    status: string;
+    /**
+     * Updated work item status
+     */
+    work_item: WorkItemStatus;
+    /**
+     * Whether agent version just became eligible
+     */
+    agent_version_became_eligible: boolean;
+    /**
+     * Final score if became eligible
+     */
+    final_score?: (number | null);
+};
+/**
+ * 429 - Cooldown period is active.
+ */
+type CooldownActiveError = {
+    /**
+     * Error message describing what went wrong
+     */
+    detail: string;
+    /**
+     * Error code for programmatic handling
+     */
+    error_code?: "COOLDOWN_ACTIVE";
+    /**
+     * Seconds remaining until cooldown expires
+     */
+    remaining_seconds: number;
+};
+/**
+ * Request to create a new problem suite.
+ */
+type CreateSuiteRequest = {
+    /**
+     * URI to the problem suite definition
+     */
+    problem_suite_uri: string;
+};
+/**
+ * Response for suite creation.
+ */
+type CreateSuiteResponse = {
+    /**
+     * Created suite ID
+     */
+    suite_id: number;
+    /**
+     * Suite version number
+     */
+    suite_version: number;
+    /**
+     * Whether this suite is active
+     */
+    is_active: boolean;
+};
+/**
+ * Request to discard an agent version.
+ */
+type DiscardRequest = {
+    /**
+     * Reason for discarding
+     */
+    reason: string;
+    /**
+     * Suite ID (defaults to current suite)
+     */
+    suite_id?: (number | null);
+};
+/**
+ * Response for discard/reinstate operations.
+ */
+type DiscardResponse = {
+    /**
+     * Affected agent version
+     */
+    agent_version_id: string;
+    /**
+     * Suite ID for the operation
+     */
+    suite_id: number;
+    /**
+     * New discard state
+     */
+    is_discarded: boolean;
+};
+/**
+ * 404 - Evaluation run not found.
+ */
+type EvalRunNotFoundError = {
+    /**
+     * Error message describing what went wrong
+     */
+    detail: string;
+    /**
+     * Error code for programmatic handling
+     */
+    error_code?: "EVAL_RUN_NOT_FOUND";
+};
+/**
+ * Detailed representation of a single evaluation run.
+ */
+type EvaluationRunDetail = {
+    /**
+     * Unique identifier for this run
+     */
+    eval_run_id: string;
+    /**
+     * Agent version being evaluated
+     */
+    agent_version_id: string;
+    /**
+     * Name of the agent
+     */
+    agent_name: string;
+    /**
+     * Validator performing evaluation
+     */
+    validator_hotkey: string;
+    /**
+     * Current run status
+     */
+    status: EvaluationRunStatus;
+    /**
+     * Score if completed successfully
+     */
+    score?: (number | null);
+    /**
+     * Version number within this agent (v1, v2, etc.)
+     */
+    version_number: number;
+    /**
+     * When the run was claimed
+     */
+    claimed_at: string;
+    /**
+     * When the run completed
+     */
+    completed_at?: (string | null);
+};
+/**
+ * Public representation of an evaluation run.
+ */
+type EvaluationRunPublic = {
+    /**
+     * Unique identifier for this run
+     */
+    eval_run_id: string;
+    /**
+     * Agent version being evaluated
+     */
+    agent_version_id: string;
+    /**
+     * Suite ID
+     */
+    suite_id: number;
+    /**
+     * Validator performing evaluation
+     */
+    validator_hotkey: string;
+    /**
+     * Run status
+     */
+    status: EvaluationRunStatus;
+    /**
+     * When the run was claimed
+     */
+    claimed_at: string;
+    /**
+     * Lease expiration
+     */
+    lease_expires_at: string;
+    /**
+     * Last heartbeat
+     */
+    last_heartbeat_at?: (string | null);
+    /**
+     * Completion timestamp
+     */
+    completed_at?: (string | null);
+    /**
+     * Whether run is included in aggregate
+     */
+    is_included: boolean;
+    /**
+     * When run was invalidated
+     */
+    invalidated_at?: (string | null);
+    /**
+     * Who invalidated the run
+     */
+    invalidated_by?: (string | null);
+    /**
+     * Reason for invalidation
+     */
+    invalidation_reason?: (string | null);
+    /**
+     * Score on success
+     */
+    validator_score?: (number | null);
+    /**
+     * Score breakdown on success
+     */
+    score_components_summary?: ({
+        [key: string]: unknown;
+    } | null);
+    /**
+     * Snapshot of validator service versions at claim time
+     */
+    service_versions?: ({
+        [key: string]: (string);
+    } | null);
+};
+/**
+ * Status of an evaluation run through its lifecycle.
+ */
+type EvaluationRunStatus = 'CLAIMED' | 'RUNNING' | 'SUCCESS' | 'FAILED' | 'TIMED_OUT' | 'STALE' | 'CANCELLED';
+/**
+ * Status representation of an evaluation run (for admin operations).
+ */
+type EvaluationRunStatusPublic = {
+    /**
+     * Unique identifier for this run
+     */
+    eval_run_id: string;
+    /**
+     * Agent version being evaluated
+     */
+    agent_version_id: string;
+    /**
+     * Suite ID
+     */
+    suite_id: number;
+    /**
+     * Validator performing evaluation
+     */
+    validator_hotkey: string;
+    /**
+     * Run status
+     */
+    status: EvaluationRunStatus;
+    /**
+     * When the run was claimed
+     */
+    claimed_at: string;
+    /**
+     * Lease expiration
+     */
+    lease_expires_at: string;
+    /**
+     * Whether run is included in aggregate
+     */
+    is_included: boolean;
+    /**
+     * Last heartbeat
+     */
+    last_heartbeat_at?: (string | null);
+    /**
+     * Completion timestamp
+     */
+    completed_at?: (string | null);
+    /**
+     * When run was invalidated
+     */
+    invalidated_at?: (string | null);
+    /**
+     * Who invalidated the run
+     */
+    invalidated_by?: (string | null);
+    /**
+     * Reason for invalidation
+     */
+    invalidation_reason?: (string | null);
+    /**
+     * Score on success
+     */
+    validator_score?: (number | null);
+    /**
+     * Score breakdown on success
+     */
+    score_components_summary?: ({
+        [key: string]: unknown;
+    } | null);
+};
+/**
+ * 400 - Upload file exceeds size limit.
+ */
+type FileTooLargeError = {
+    /**
+     * Error message describing what went wrong
+     */
+    detail: string;
+    /**
+     * Error code for programmatic handling
+     */
+    error_code?: "FILE_TOO_LARGE";
+};
+/**
+ * Optional request body for heartbeat with service version info.
+ */
+type HeartbeatRequest = {
+    /**
+     * Docker image digests for validator stack services
+     */
+    service_versions?: ({
+        [key: string]: (string);
+    } | null);
+};
+/**
+ * Response for heartbeat.
+ */
+type HeartbeatResponse = {
+    /**
+     * New lease expiration time
+     */
+    lease_expires_at: string;
+};
+type HTTPValidationError = {
+    detail?: Array<ValidationError>;
+};
+/**
+ * 400 - Agent name validation failed.
+ */
+type InvalidAgentNameError = {
+    /**
+     * Error message describing what went wrong
+     */
+    detail: string;
+    /**
+     * Error code for programmatic handling
+     */
+    error_code?: "INVALID_AGENT_NAME";
+};
+/**
+ * 400 - Unknown or unsupported artifact type.
+ */
+type InvalidArtifactTypeError = {
+    /**
+     * Error message describing what went wrong
+     */
+    detail: string;
+    /**
+     * Error code for programmatic handling
+     */
+    error_code?: "INVALID_ARTIFACT_TYPE";
+};
+/**
+ * Request to invalidate an evaluation run (irreversible).
+ */
+type InvalidateRunRequest = {
+    /**
+     * Reason for invalidation
+     */
+    reason: string;
+};
+/**
+ * 400 - File content validation failed.
+ */
+type InvalidFileError = {
+    /**
+     * Error message describing what went wrong
+     */
+    detail: string;
+    /**
+     * Error code for programmatic handling
+     */
+    error_code?: "INVALID_FILE";
+};
+/**
+ * 400 - Problem ID is not valid for this suite.
+ */
+type InvalidProblemIdError = {
+    /**
+     * Error message describing what went wrong
+     */
+    detail: string;
+    /**
+     * Error code for programmatic handling
+     */
+    error_code?: "INVALID_PROBLEM_ID";
+};
+/**
+ * Entry in the leaderboard.
+ */
+type LeaderboardEntry = {
+    /**
+     * Leaderboard rank
+     */
+    rank: number;
+    /**
+     * Agent version ID
+     */
+    agent_version_id: string;
+    /**
+     * Agent name
+     */
+    agent_name: string;
+    /**
+     * Miner hotkey
+     */
+    miner_hotkey: string;
+    /**
+     * Version number within this agent (v1, v2, etc.)
+     */
+    version_number: number;
+    /**
+     * Final score
+     */
+    final_score: number;
+    /**
+     * When eligibility was reached
+     */
+    eligible_at?: (string | null);
+    /**
+     * Whether discarded by admin
+     */
+    is_discarded?: boolean;
+    /**
+     * Whether miner is banned
+     */
+    is_miner_banned?: boolean;
+    /**
+     * Current top agent for emissions
+     */
+    is_current_top?: boolean;
+    /**
+     * Previously held top agent status
+     */
+    was_top?: boolean;
+    /**
+     * When this agent became top
+     */
+    top_at?: (string | null);
+};
+/**
+ * Response for leaderboard endpoint.
+ */
+type LeaderboardResponse = {
+    /**
+     * Suite information
+     */
+    suite: SuitePublic;
+    /**
+     * Leaderboard entries
+     */
+    entries: Array<LeaderboardEntry>;
+    /**
+     * Total entries
+     */
+    total: number;
+    /**
+     * Page size
+     */
+    limit: number;
+    /**
+     * Page offset
+     */
+    offset: number;
+    /**
+     * Score required to dethrone current top
+     */
+    challenge_threshold?: (number | null);
+};
+/**
+ * 409 - Evaluation run lease has expired.
+ */
+type LeaseExpiredError = {
+    /**
+     * Error message describing what went wrong
+     */
+    detail: string;
+    /**
+     * Error code for programmatic handling
+     */
+    error_code?: "LEASE_EXPIRED";
+};
+/**
+ * Response from logout endpoint.
+ */
+type LogoutResponse = {
+    /**
+     * Whether logout was successful
+     */
+    success: boolean;
+};
+/**
+ * Envelope response for GET /v1/miner/agents with cooldown status.
+ */
+type MinerAgentsResponse = {
+    /**
+     * Miner's agents
+     */
+    agents: Array<AgentPublic>;
+    /**
+     * Whether the miner can submit now
+     */
+    can_submit: boolean;
+    /**
+     * When next submission is allowed (ISO 8601), null if no cooldown
+     */
+    next_allowed_at?: (string | null);
+};
+/**
+ * 404 - Miner not found.
+ */
+type MinerNotFoundError = {
+    /**
+     * Error message describing what went wrong
+     */
+    detail: string;
+    /**
+     * Error code for programmatic handling
+     */
+    error_code?: "MINER_NOT_FOUND";
+};
+/**
+ * 400 - Required parameter is missing.
+ */
+type MissingParameterError = {
+    /**
+     * Error message describing what went wrong
+     */
+    detail: string;
+    /**
+     * Error code for programmatic handling
+     */
+    error_code?: "MISSING_PARAMETER";
+};
+/**
+ * 400 - Score is required for SUCCESS status.
+ */
+type MissingScoreError = {
+    /**
+     * Error message describing what went wrong
+     */
+    detail: string;
+    /**
+     * Error code for programmatic handling
+     */
+    error_code?: "MISSING_SCORE";
+};
+/**
+ * 503 - No active problem suite available.
+ */
+type NoActiveSuiteError = {
+    /**
+     * Error message describing what went wrong
+     */
+    detail: string;
+    /**
+     * Error code for programmatic handling
+     */
+    error_code?: "NO_ACTIVE_SUITE";
+};
+/**
+ * 409 - Caller does not own this evaluation run.
+ */
+type NotRunOwnerError = {
+    /**
+     * Error message describing what went wrong
+     */
+    detail: string;
+    /**
+     * Error code for programmatic handling
+     */
+    error_code?: "NOT_RUN_OWNER";
+};
+/**
+ * A work item awaiting validator evaluations.
+ */
+type PendingEvaluation = {
+    /**
+     * Unique work item identifier
+     */
+    work_item_id: string;
+    /**
+     * Name of the agent
+     */
+    agent_name: string;
+    /**
+     * Version number within this agent
+     */
+    version_number: number;
+    /**
+     * Miner who owns the agent
+     */
+    miner_hotkey: string;
+    /**
+     * Problem suite ID
+     */
+    suite_id: number;
+    /**
+     * Total successful evaluations needed
+     */
+    required_successes: number;
+    /**
+     * Successful evaluations completed so far
+     */
+    completed_successes: number;
+    /**
+     * Currently CLAIMED or RUNNING evaluations
+     */
+    active_runs: number;
+    /**
+     * Additional validator claims still needed
+     */
+    remaining: number;
+    /**
+     * When this work item was created
+     */
+    queued_at: string;
+};
+/**
+ * Response for pending evaluations endpoint.
+ */
+type PendingEvaluationsResponse = {
+    /**
+     * Aggregate queue statistics
+     */
+    summary: PendingEvaluationSummary;
+    /**
+     * Individual pending work items
+     */
+    items: Array<PendingEvaluation>;
+};
+/**
+ * Aggregate statistics for pending evaluations.
+ */
+type PendingEvaluationSummary = {
+    /**
+     * Number of open work items
+     */
+    total_pending: number;
+    /**
+     * Sum of remaining runs across all items
+     */
+    total_runs_needed: number;
+    /**
+     * Sum of active runs across all items
+     */
+    total_runs_active: number;
+};
+/**
+ * Request for presigned upload URL.
+ */
+type PresignUploadRequest = {
+    /**
+     * Content type of the upload
+     */
+    content_type?: string;
+    /**
+     * Size of the upload in bytes
+     */
+    content_length: number;
+    /**
+     * Evaluation run ID
+     */
+    eval_run_id: string;
+    /**
+     * Problem ID
+     */
+    problem_id: string;
+};
+/**
+ * Response with presigned upload URL.
+ */
+type PresignUploadResponse = {
+    /**
+     * Presigned S3 PUT URL
+     */
+    upload_url: string;
+    /**
+     * HTTP method to use
+     */
+    method?: string;
+    /**
+     * S3 key where the file will be stored
+     */
+    results_s3_key: string;
+    /**
+     * When the presigned URL expires
+     */
+    expires_at: string;
+};
+/**
+ * 404 - Problem not found in suite.
+ */
+type ProblemNotFoundError = {
+    /**
+     * Error message describing what went wrong
+     */
+    detail: string;
+    /**
+     * Error code for programmatic handling
+     */
+    error_code?: "PROBLEM_NOT_FOUND";
+};
+/**
+ * Progress entry for a single problem showing results from all validators.
+ */
+type ProblemProgressEntry = {
+    /**
+     * Problem ID
+     */
+    problem_id: string;
+    /**
+     * Problem category
+     */
+    category?: (string | null);
+    /**
+     * Results from each validator that evaluated this problem
+     */
+    validator_results?: Array<ValidatorProblemResult>;
+};
+/**
+ * Progress update for a single problem.
+ */
+type ProblemProgressUpdate = {
+    /**
+     * Problem ID
+     */
+    problem_id: string;
+    /**
+     * Current status of this problem
+     */
+    status: ProblemStatus;
+    /**
+     * Score if available
+     */
+    score?: (number | null);
+    /**
+     * Score breakdown if available
+     */
+    score_components_summary?: ({
+        [key: string]: unknown;
+    } | null);
+    /**
+     * S3 key for this problem's logs
+     */
+    logs_s3_key?: (string | null);
+};
+/**
+ * Public representation of a problem.
+ */
+type ProblemPublic = {
+    /**
+     * Unique identifier for the problem
+     */
+    problem_id: string;
+    /**
+     * Parent suite ID
+     */
+    suite_id: number;
+    /**
+     * Full problem metadata
+     */
+    metadata?: {
+        [key: string]: unknown;
+    };
+};
+/**
+ * Status of problem evaluation.
+ */
+type ProblemStatus = 'PENDING' | 'RUNNING' | 'SUCCESS' | 'FAILED' | 'SKIPPED' | 'TIMED_OUT';
+/**
+ * Request to update per-problem progress.
+ */
+type ProgressUpdateRequest = {
+    /**
+     * List of problem progress updates
+     */
+    problems: Array<ProblemProgressUpdate>;
+};
+/**
+ * Response for progress update.
+ */
+type ProgressUpdateResponse = {
+    /**
+     * Whether updates were accepted
+     */
+    accepted?: boolean;
+};
+/**
+ * 429 - Rate limit exceeded.
+ */
+type RateLimitExceededError = {
+    /**
+     * Error message describing what went wrong
+     */
+    detail: string;
+    /**
+     * Error code for programmatic handling
+     */
+    error_code?: "RATE_LIMIT_EXCEEDED";
+};
+/**
+ * Response for reaper service statistics.
+ */
+type ReaperStatsResponse = {
+    /**
+     * Whether the reaper service is enabled
+     */
+    enabled: boolean;
+    /**
+     * Whether the reaper background task is running
+     */
+    is_running: boolean;
+    /**
+     * Last reaper cycle timestamp
+     */
+    last_run_at?: (string | null);
+    /**
+     * Total runs reaped since service start
+     */
+    runs_reaped_total: number;
+    /**
+     * Runs reaped in the last cycle
+     */
+    runs_reaped_last_cycle: number;
+    /**
+     * Duration of the last reaper cycle in ms
+     */
+    last_cycle_duration_ms: number;
+    /**
+     * Number of reaper cycle errors encountered
+     */
+    error_count: number;
+    /**
+     * Number of Redis stats persistence errors
+     */
+    redis_error_count: number;
+    /**
+     * Configured interval between reaper cycles
+     */
+    interval_seconds: number;
+};
+/**
+ * Request to re-evaluate an agent version.
+ */
+type ReevaluateRequest = {
+    /**
+     * Reason for re-evaluation
+     */
+    reason: string;
+    /**
+     * Suite ID (defaults to current suite)
+     */
+    suite_id?: (number | null);
+    /**
+     * Override required successes
+     */
+    required_successes?: (number | null);
+};
+/**
+ * Response for re-evaluation request.
+ */
+type ReevaluateResponse = {
+    /**
+     * Agent version ID
+     */
+    agent_version_id: string;
+};
+/**
+ * Request to reinstate an agent version.
+ */
+type ReinstateRequest = {
+    /**
+     * Suite ID (defaults to current suite)
+     */
+    suite_id?: (number | null);
+};
+/**
+ * 409 - Evaluation run is already complete.
+ */
+type RunAlreadyCompleteError = {
+    /**
+     * Error message describing what went wrong
+     */
+    detail: string;
+    /**
+     * Error code for programmatic handling
+     */
+    error_code?: "RUN_ALREADY_COMPLETE";
+};
+/**
+ * Representation of a currently running evaluation.
+ */
+type RunningEvaluation = {
+    /**
+     * Unique identifier for this run
+     */
+    eval_run_id: string;
+    /**
+     * Agent version being evaluated
+     */
+    agent_version_id: string;
+    /**
+     * Name of the agent
+     */
+    agent_name: string;
+    /**
+     * Version number within this agent (v1, v2, etc.)
+     */
+    version_number: number;
+    /**
+     * Miner who owns the agent
+     */
+    miner_hotkey: string;
+    /**
+     * Validator performing evaluation
+     */
+    validator_hotkey: string;
+    /**
+     * Current run status
+     */
+    status: EvaluationRunStatus;
+    /**
+     * When evaluation started
+     */
+    started_at: string;
+    /**
+     * Percentage of problems completed (0-100)
+     */
+    progress_percent?: number;
+};
+/**
+ * 400 - Candidate score does not exceed the challenge threshold.
+ */
+type ScoreBelowThresholdError = {
+    /**
+     * Error message describing what went wrong
+     */
+    detail: string;
+    /**
+     * Error code for programmatic handling
+     */
+    error_code?: "SCORE_BELOW_THRESHOLD";
+    /**
+     * Score of the candidate agent
+     */
+    candidate_score: number;
+    /**
+     * Minimum score required to dethrone the current top
+     */
+    required_score: number;
+    /**
+     * Score of the current top agent
+     */
+    current_top_score: number;
+    /**
+     * Current challenge margin fraction
+     */
+    margin: number;
+};
+/**
+ * Request body for session creation endpoint.
+ */
+type SessionRequest = {
+    /**
+     * SS58 hotkey address
+     */
+    hotkey: string;
+    /**
+     * Challenge that was signed
+     */
+    challenge: string;
+    /**
+     * Hex-encoded signature
+     */
+    signature: string;
+};
+/**
+ * Response from session creation endpoint.
+ */
+type SessionResponse = {
+    /**
+     * Session token for authenticated requests
+     */
+    session_token: string;
+    /**
+     * Unix timestamp when session expires
+     */
+    expires_at: number;
+    /**
+     * User role (miner, validator, admin)
+     */
+    role: string;
+};
+/**
+ * Request to set an agent version as the top agent for emissions.
+ */
+type SetTopRequest = {
+    /**
+     * Suite ID (defaults to current suite)
+     */
+    suite_id?: (number | null);
+    /**
+     * Bypass the challenge threshold check (recorded in audit)
+     */
+    force?: boolean;
+};
+/**
+ * Response for set-top operation.
+ */
+type SetTopResponse = {
+    /**
+     * New top agent version
+     */
+    agent_version_id: string;
+    /**
+     * Suite ID
+     */
+    suite_id: number;
+    /**
+     * Previous top agent version (now marked was_top)
+     */
+    previous_top_agent_version_id?: (string | null);
+    /**
+     * When this agent became top
+     */
+    top_at: string;
+};
+/**
+ * Response model for agent submission.
+ */
+type SubmitAgentResponse = {
+    /**
+     * Agent ID (created if needed)
+     */
+    agent_id?: (string | null);
+    /**
+     * Agent version ID (if accepted)
+     */
+    agent_version_id?: (string | null);
+    /**
+     * Whether submission was accepted
+     */
+    admission_status: AdmissionStatus;
+    /**
+     * Reason for rejection if rejected
+     */
+    admission_reason?: (AdmissionReason | null);
+    /**
+     * When next submission is allowed (if in cooldown)
+     */
+    next_allowed_at?: (string | null);
+    /**
+     * Miner hotkey that submitted
+     */
+    hotkey: string;
+    /**
+     * Status message
+     */
+    message?: string;
+};
+/**
+ * 404 - Problem suite not found.
+ */
+type SuiteNotFoundError = {
+    /**
+     * Error message describing what went wrong
+     */
+    detail: string;
+    /**
+     * Error code for programmatic handling
+     */
+    error_code?: "SUITE_NOT_FOUND";
+};
+/**
+ * Public representation of a problem suite.
+ */
+type SuitePublic = {
+    /**
+     * Problem suite version/ID
+     */
+    suite_id: number;
+    /**
+     * Version number of the problem suite
+     */
+    suite_version: number;
+    /**
+     * Whether this suite is currently active
+     */
+    is_active: boolean;
+};
+/**
+ * Response for suite with its problems.
+ */
+type SuiteWithProblemsResponse = {
+    /**
+     * Suite information
+     */
+    suite: SuitePublic;
+    /**
+     * Problems in this suite
+     */
+    problems: Array<ProblemPublic>;
+};
+/**
+ * Terminal statuses for evaluation runs.
+ */
+type TerminalStatus = 'SUCCESS' | 'FAILED' | 'TIMED_OUT';
+/**
+ * Response for top agent endpoint.
+ */
+type TopAgentResponse = {
+    /**
+     * Active suite ID
+     */
+    suite_id: number;
+    /**
+     * When this was computed
+     */
+    computed_at: string;
+    /**
+     * Top agent version ID
+     */
+    top_agent_version_id?: (string | null);
+    /**
+     * Top miner's hotkey
+     */
+    top_miner_hotkey?: (string | null);
+    /**
+     * Top score
+     */
+    top_score?: (number | null);
+    /**
+     * Hysteresis/decay params
+     */
+    policy?: ({
+        [key: string]: unknown;
+    } | null);
+    /**
+     * Score required to dethrone
+     */
+    challenge_threshold?: (number | null);
+    /**
+     * Current emission weight (1.0=full)
+     */
+    emission_weight?: (number | null);
+    /**
+     * Current challenge margin fraction
+     */
+    margin?: (number | null);
+};
+type ValidationError = {
+    loc: Array<(string | number)>;
+    msg: string;
+    type: string;
+};
+/**
+ * Information about the agent currently being evaluated by a validator.
+ */
+type ValidatorCurrentAgent = {
+    /**
+     * Name of the agent being evaluated
+     */
+    agent_name: string;
+    /**
+     * Agent version ID
+     */
+    version_id: string;
+    /**
+     * Version number within this agent (v1, v2, etc.)
+     */
+    version_number: number;
+    /**
+     * When evaluation started
+     */
+    started_at: string;
+};
+/**
+ * 404 - Validator not found.
+ */
+type ValidatorNotFoundError = {
+    /**
+     * Error message describing what went wrong
+     */
+    detail: string;
+    /**
+     * Error code for programmatic handling
+     */
+    error_code?: "VALIDATOR_NOT_FOUND";
+};
+/**
+ * Result from a single validator for a specific problem.
+ */
+type ValidatorProblemResult = {
+    /**
+     * Validator hotkey
+     */
+    validator_hotkey: string;
+    /**
+     * Problem status from this validator
+     */
+    status: ProblemStatus;
+    /**
+     * Problem score from this validator
+     */
+    score?: (number | null);
+    /**
+     * Score breakdown from this validator
+     */
+    score_components?: ({
+        [key: string]: unknown;
+    } | null);
+    /**
+     * Last update from this validator
+     */
+    updated_at?: (string | null);
+};
+/**
+ * Public representation of a validator.
+ */
+type ValidatorPublic = {
+    /**
+     * Validator's SS58 address
+     */
+    hotkey: string;
+    /**
+     * Current validator status
+     */
+    status: ValidatorStatus;
+    /**
+     * When validator was registered
+     */
+    registered_at: string;
+    /**
+     * Last work claim time
+     */
+    last_claim_at?: (string | null);
+    /**
+     * Agent currently being evaluated, if any
+     */
+    current_agent?: (ValidatorCurrentAgent | null);
+    /**
+     * Docker image digests for validator stack services
+     */
+    service_versions?: ({
+        [key: string]: (string);
+    } | null);
+};
+/**
+ * Status of a validator.
+ */
+type ValidatorStatus = 'evaluating' | 'available';
+/**
+ * Status of the work item after completion.
+ */
+type WorkItemStatus = {
+    /**
+     * Number of successful runs
+     */
+    included_success_count: number;
+    /**
+     * Required successful runs
+     */
+    required_successes: number;
+    /**
+     * Whether work item is closed
+     */
+    is_closed: boolean;
+};
+type HealthCheckResponse = ({
+    [key: string]: unknown;
+});
+type HealthCheckError = unknown;
+type GetCurrentSuiteResponse = (SuitePublic);
+type GetCurrentSuiteError = (SuiteNotFoundError);
+type GetSuiteProblemsData = {
+    path: {
+        /**
+         * Suite ID/version
+         */
+        suite_id: number;
+    };
+};
+type GetSuiteProblemsResponse = (SuiteWithProblemsResponse);
+type GetSuiteProblemsError = (SuiteNotFoundError | HTTPValidationError);
+type GetLeaderboardData = {
+    query?: {
+        /**
+         * Maximum entries to return
+         */
+        limit?: number;
+        /**
+         * Offset for pagination
+         */
+        offset?: number;
+        /**
+         * Suite ID (defaults to current)
+         */
+        suite_id?: (number | null);
+    };
+};
+type GetLeaderboardResponse = (LeaderboardResponse);
+type GetLeaderboardError = (HTTPValidationError);
+type GetTopAgentResponse = (TopAgentResponse);
+type GetTopAgentError = unknown;
+type GetAgentVersionStatusData = {
+    path: {
+        /**
+         * Agent version ID
+         */
+        agent_version_id: string;
+    };
+};
+type GetAgentVersionStatusResponse = (AgentVersionStatus);
+type GetAgentVersionStatusError = (AgentVersionNotFoundError | HTTPValidationError);
+type GetAgentVersionRunsData = {
+    path: {
+        /**
+         * Agent version ID
+         */
+        agent_version_id: string;
+    };
+};
+type GetAgentVersionRunsResponse = (Array<EvaluationRunPublic>);
+type GetAgentVersionRunsError = (AgentVersionNotFoundError | HTTPValidationError);
+type GetAgentVersionProblemsData = {
+    path: {
+        /**
+         * Agent version ID
+         */
+        agent_version_id: string;
+    };
+};
+type GetAgentVersionProblemsResponse = (AgentVersionProblemsResponse);
+type GetAgentVersionProblemsError = (AgentVersionNotFoundError | HTTPValidationError);
+type GetAgentVersionData = {
+    path: {
+        /**
+         * Agent version ID
+         */
+        agent_version_id: string;
+    };
+};
+type GetAgentVersionResponse = (AgentVersionPublic);
+type GetAgentVersionError = ((AgentVersionNotFoundError | SuiteNotFoundError | ArtifactNotReleasedError) | HTTPValidationError);
+type GetArtifactDownloadUrlData = {
+    body: ArtifactDownloadRequest;
+};
+type GetArtifactDownloadUrlResponse = (ArtifactDownloadResponse);
+type GetArtifactDownloadUrlError = ((MissingParameterError | InvalidArtifactTypeError) | (AgentVersionNotFoundError | SuiteNotFoundError | ArtifactNotReleasedError | ArtifactNotFoundError | EvalRunNotFoundError) | HTTPValidationError);
+type GetEvaluationRunData = {
+    path: {
+        /**
+         * Evaluation run ID
+         */
+        eval_run_id: string;
+    };
+};
+type GetEvaluationRunResponse = (EvaluationRunDetail);
+type GetEvaluationRunError = (EvalRunNotFoundError | HTTPValidationError);
+type GetValidatorsResponse = (Array<ValidatorPublic>);
+type GetValidatorsError = unknown;
+type GetRunningEvaluationsResponse = (Array<RunningEvaluation>);
+type GetRunningEvaluationsError = unknown;
+type GetPendingEvaluationsData = {
+    query?: {
+        /**
+         * Maximum items to return
+         */
+        limit?: number;
+        /**
+         * Number of items to skip
+         */
+        offset?: number;
+        /**
+         * Filter by problem suite ID
+         */
+        suite_id?: (number | null);
+    };
+};
+type GetPendingEvaluationsResponse = (PendingEvaluationsResponse);
+type GetPendingEvaluationsError = (HTTPValidationError);
+type RequestChallengeData = {
+    body: ChallengeRequest;
+};
+type RequestChallengeResponse = (ChallengeResponse);
+type RequestChallengeError = (HTTPValidationError);
+type CreateSessionEndpointData = {
+    body: SessionRequest;
+};
+type CreateSessionEndpointResponse = (SessionResponse);
+type CreateSessionEndpointError = (HTTPValidationError);
+type LogoutData = {
+    headers?: {
+        authorization?: (string | null);
+    };
+};
+type LogoutResponse2 = (LogoutResponse);
+type LogoutError = (HTTPValidationError);
+type SubmitAgentData = {
+    body: Body_submit_agent;
+};
+type SubmitAgentResponse2 = (SubmitAgentResponse);
+type SubmitAgentError = ((InvalidAgentNameError | InvalidFileError) | FileTooLargeError | CodeAnalysisError | (CooldownActiveError | RateLimitExceededError) | NoActiveSuiteError);
+type ListMinerAgentsResponse = (MinerAgentsResponse);
+type ListMinerAgentsError = unknown;
+type ListAgentVersionsData = {
+    path: {
+        /**
+         * Agent ID
+         */
+        agent_id: string;
+    };
+};
+type ListAgentVersionsResponse = (Array<AgentVersionHistoryEntry>);
+type ListAgentVersionsError = (AgentNotFoundError | HTTPValidationError);
+type GetOwnedAgentVersionStatusData = {
+    path: {
+        /**
+         * Agent version ID
+         */
+        agent_version_id: string;
+    };
+};
+type GetOwnedAgentVersionStatusResponse = (AgentVersionStatus);
+type GetOwnedAgentVersionStatusError = (AgentVersionNotFoundError | HTTPValidationError);
+type ClaimWorkResponse2 = (ClaimWorkResponse | void);
+type ClaimWorkError = (AtCapacityError);
+type HeartbeatData = {
+    body?: (HeartbeatRequest | null);
+    path: {
+        /**
+         * Evaluation run ID
+         */
+        eval_run_id: string;
+    };
+};
+type HeartbeatResponse2 = (HeartbeatResponse);
+type HeartbeatError = (EvalRunNotFoundError | (LeaseExpiredError | NotRunOwnerError | RunAlreadyCompleteError) | HTTPValidationError);
+type UpdateProgressData = {
+    body: ProgressUpdateRequest;
+    path: {
+        /**
+         * Evaluation run ID
+         */
+        eval_run_id: string;
+    };
+};
+type UpdateProgressResponse = (ProgressUpdateResponse);
+type UpdateProgressError = (InvalidProblemIdError | EvalRunNotFoundError | (LeaseExpiredError | NotRunOwnerError | RunAlreadyCompleteError) | HTTPValidationError);
+type PresignUploadData = {
+    body: PresignUploadRequest;
+};
+type PresignUploadResponse2 = (PresignUploadResponse);
+type PresignUploadError = ((FileTooLargeError | ValidationError) | (EvalRunNotFoundError | ProblemNotFoundError) | NotRunOwnerError | HTTPValidationError);
+type CompleteRunData = {
+    body: CompleteRunRequest;
+    path: {
+        /**
+         * Evaluation run ID
+         */
+        eval_run_id: string;
+    };
+};
+type CompleteRunResponse2 = (CompleteRunResponse);
+type CompleteRunError = ((MissingScoreError | ValidationError) | EvalRunNotFoundError | (NotRunOwnerError | RunAlreadyCompleteError) | HTTPValidationError);
+type BanMinerData = {
+    body: BanRequest;
+    path: {
+        /**
+         * Miner hotkey to ban
+         */
+        miner_hotkey: string;
+    };
+};
+type BanMinerResponse = (BanResponse);
+type BanMinerError = (MinerNotFoundError | HTTPValidationError);
+type UnbanMinerData = {
+    path: {
+        /**
+         * Miner hotkey to unban
+         */
+        miner_hotkey: string;
+    };
+};
+type UnbanMinerResponse = (BanResponse);
+type UnbanMinerError = (MinerNotFoundError | HTTPValidationError);
+type BanValidatorData = {
+    body: BanRequest;
+    path: {
+        /**
+         * Validator hotkey to ban
+         */
+        validator_hotkey: string;
+    };
+};
+type BanValidatorResponse = (BanResponse);
+type BanValidatorError = (ValidatorNotFoundError | HTTPValidationError);
+type UnbanValidatorData = {
+    path: {
+        /**
+         * Validator hotkey to unban
+         */
+        validator_hotkey: string;
+    };
+};
+type UnbanValidatorResponse = (BanResponse);
+type UnbanValidatorError = (ValidatorNotFoundError | HTTPValidationError);
+type DiscardAgentVersionData = {
+    body: DiscardRequest;
+    path: {
+        /**
+         * Agent version ID
+         */
+        agent_version_id: string;
+    };
+};
+type DiscardAgentVersionResponse = (DiscardResponse);
+type DiscardAgentVersionError = (AgentVersionNotFoundError | HTTPValidationError | NoActiveSuiteError);
+type ReinstateAgentVersionData = {
+    body: ReinstateRequest;
+    path: {
+        /**
+         * Agent version ID
+         */
+        agent_version_id: string;
+    };
+};
+type ReinstateAgentVersionResponse = (DiscardResponse);
+type ReinstateAgentVersionError = (AgentVersionNotFoundError | HTTPValidationError | NoActiveSuiteError);
+type SetTopAgentData = {
+    body: SetTopRequest;
+    path: {
+        /**
+         * Agent version ID to set as top
+         */
+        agent_version_id: string;
+    };
+};
+type SetTopAgentResponse = (SetTopResponse);
+type SetTopAgentError = (ScoreBelowThresholdError | AgentVersionNotFoundError | HTTPValidationError | NoActiveSuiteError);
+type InvalidateEvaluationRunData = {
+    body: InvalidateRunRequest;
+    path: {
+        /**
+         * Evaluation run ID
+         */
+        eval_run_id: string;
+    };
+};
+type InvalidateEvaluationRunResponse = (EvaluationRunStatusPublic);
+type InvalidateEvaluationRunError = (EvalRunNotFoundError | AlreadyInvalidatedError | HTTPValidationError);
+type ReevaluateAgentVersionData = {
+    body: ReevaluateRequest;
+    path: {
+        /**
+         * Agent version ID
+         */
+        agent_version_id: string;
+    };
+};
+type ReevaluateAgentVersionResponse = (ReevaluateResponse);
+type ReevaluateAgentVersionError = (AgentVersionNotFoundError | HTTPValidationError | NoActiveSuiteError);
+type CancelAgentVersionData = {
+    body: CancelRequest;
+    path: {
+        /**
+         * Agent version ID
+         */
+        agent_version_id: string;
+    };
+};
+type CancelAgentVersionResponse = (CancelResponse);
+type CancelAgentVersionError = (HTTPValidationError);
+type CreateSuiteData = {
+    body: CreateSuiteRequest;
+};
+type CreateSuiteResponse2 = (CreateSuiteResponse);
+type CreateSuiteError = (HTTPValidationError);
+type ActivateSuiteData = {
+    path: {
+        /**
+         * Suite version to activate
+         */
+        suite_id: number;
+    };
+};
+type ActivateSuiteResponse2 = (ActivateSuiteResponse);
+type ActivateSuiteError = (SuiteNotFoundError | HTTPValidationError);
+type GetAuditEventsData = {
+    query?: {
+        /**
+         * Filter by action type (e.g., BAN_MINER)
+         */
+        action?: (string | null);
+        /**
+         * Filter by actor hotkey
+         */
+        actor_hotkey?: (string | null);
+        /**
+         * Number of events to return
+         */
+        limit?: number;
+        /**
+         * Offset for pagination
+         */
+        offset?: number;
+        /**
+         * Filter by target ID
+         */
+        target_id?: (string | null);
+        /**
+         * Filter by target type
+         */
+        target_type?: (string | null);
+    };
+};
+type GetAuditEventsResponse = (AuditEventsResponse);
+type GetAuditEventsError = (HTTPValidationError);
+type GetReaperStatsResponse = (ReaperStatsResponse);
+type GetReaperStatsError = unknown;
+
+declare const client: _hey_api_client_fetch.Client<Request, Response, unknown, _hey_api_client_fetch.RequestOptions<boolean, string>>;
+/**
+ * Health Check
+ * Health check endpoint (no auth required).
+ */
+declare const healthCheck: <ThrowOnError extends boolean = false>(options?: OptionsLegacyParser<unknown, ThrowOnError>) => _hey_api_client_fetch.RequestResult<HealthCheckResponse, unknown, ThrowOnError>;
+/**
+ * Get current active suite
+ * Fetch the currently active problem suite.
+ */
+declare const getCurrentSuite: <ThrowOnError extends boolean = false>(options?: OptionsLegacyParser<unknown, ThrowOnError>) => _hey_api_client_fetch.RequestResult<SuitePublic, SuiteNotFoundError, ThrowOnError>;
+/**
+ * Get suite problems
+ * Get the list of problems for a specific suite.
+ */
+declare const getSuiteProblems: <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<GetSuiteProblemsData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<SuiteWithProblemsResponse, GetSuiteProblemsError, ThrowOnError>;
+/**
+ * Get leaderboard
+ * Get the eligible agent leaderboard for a suite.
+ */
+declare const getLeaderboard: <ThrowOnError extends boolean = false>(options?: OptionsLegacyParser<GetLeaderboardData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<LeaderboardResponse, HTTPValidationError, ThrowOnError>;
+/**
+ * Get top agent for emissions
+ * Get the canonical top miner for emissions calculation.
+ */
+declare const getTopAgent: <ThrowOnError extends boolean = false>(options?: OptionsLegacyParser<unknown, ThrowOnError>) => _hey_api_client_fetch.RequestResult<TopAgentResponse, unknown, ThrowOnError>;
+/**
+ * Get agent version status
+ * Get live status and counters for an agent version.
+ */
+declare const getAgentVersionStatus: <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<GetAgentVersionStatusData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<AgentVersionStatus, GetAgentVersionStatusError, ThrowOnError>;
+/**
+ * Get agent version runs
+ * Get evaluation runs for an agent version.
+ */
+declare const getAgentVersionRuns: <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<GetAgentVersionRunsData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<GetAgentVersionRunsResponse, GetAgentVersionRunsError, ThrowOnError>;
+/**
+ * Get agent version problem progress
+ * Get per-problem progress matrix across validators.
+ */
+declare const getAgentVersionProblems: <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<GetAgentVersionProblemsData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<AgentVersionProblemsResponse, GetAgentVersionProblemsError, ThrowOnError>;
+/**
+ * Get agent version details
+ * Get released public details for an agent version.
+ */
+declare const getAgentVersion: <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<GetAgentVersionData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<AgentVersionPublic, GetAgentVersionError, ThrowOnError>;
+/**
+ * Get artifact download URL
+ * Get a presigned URL to download released artifacts.
+ */
+declare const getArtifactDownloadUrl: <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<GetArtifactDownloadUrlData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<ArtifactDownloadResponse, GetArtifactDownloadUrlError, ThrowOnError>;
+/**
+ * Get evaluation run details
+ * Get detailed information about a specific evaluation run.
+ */
+declare const getEvaluationRun: <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<GetEvaluationRunData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<EvaluationRunDetail, GetEvaluationRunError, ThrowOnError>;
+/**
+ * Get list of validators
+ * Get all non-banned validators with their current status.
+ */
+declare const getValidators: <ThrowOnError extends boolean = false>(options?: OptionsLegacyParser<unknown, ThrowOnError>) => _hey_api_client_fetch.RequestResult<GetValidatorsResponse, unknown, ThrowOnError>;
+/**
+ * Get running evaluations
+ * Get all currently running or claimed evaluations.
+ */
+declare const getRunningEvaluations: <ThrowOnError extends boolean = false>(options?: OptionsLegacyParser<unknown, ThrowOnError>) => _hey_api_client_fetch.RequestResult<GetRunningEvaluationsResponse, unknown, ThrowOnError>;
+/**
+ * Get pending evaluations
+ * Get all open work items awaiting validator evaluations, with queue summary.
+ */
+declare const getPendingEvaluations: <ThrowOnError extends boolean = false>(options?: OptionsLegacyParser<GetPendingEvaluationsData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<PendingEvaluationsResponse, HTTPValidationError, ThrowOnError>;
+/**
+ * Request Challenge
+ * Request a challenge for wallet authentication.
+ *
+ * The challenge must be signed by the wallet and submitted to /session
+ * within 60 seconds.
+ *
+ * Rate limited to 10 requests per minute per IP to prevent abuse.
+ */
+declare const requestChallenge: <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<RequestChallengeData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<ChallengeResponse, HTTPValidationError, ThrowOnError>;
+/**
+ * Create Session Endpoint
+ * Create a session by verifying a signed challenge.
+ *
+ * The challenge must have been requested within the last 60 seconds
+ * and the signature must be valid for the challenge message.
+ *
+ * Rate limited to 5 requests per minute per IP to prevent brute force.
+ */
+declare const createSessionEndpoint: <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<CreateSessionEndpointData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<SessionResponse, HTTPValidationError, ThrowOnError>;
+/**
+ * Logout
+ * Logout and invalidate the current session.
+ */
+declare const logout: <ThrowOnError extends boolean = false>(options?: OptionsLegacyParser<LogoutData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<LogoutResponse, HTTPValidationError, ThrowOnError>;
+/**
+ * Submit agent
+ * Submit an agent file for evaluation. Creates new agent if needed.
+ */
+declare const submitAgent: <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<SubmitAgentData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<SubmitAgentResponse, SubmitAgentError, ThrowOnError>;
+/**
+ * List miner's agents
+ * List all agents owned by the authenticated miner, with cooldown status.
+ */
+declare const listMinerAgents: <ThrowOnError extends boolean = false>(options?: OptionsLegacyParser<unknown, ThrowOnError>) => _hey_api_client_fetch.RequestResult<MinerAgentsResponse, unknown, ThrowOnError>;
+/**
+ * List agent versions
+ * List all versions of a specific agent owned by the miner.
+ */
+declare const listAgentVersions: <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<ListAgentVersionsData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<ListAgentVersionsResponse, ListAgentVersionsError, ThrowOnError>;
+/**
+ * Get agent version status
+ * Get detailed status of a specific agent version owned by the miner.
+ */
+declare const getOwnedAgentVersionStatus: <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<GetOwnedAgentVersionStatusData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<AgentVersionStatus, GetOwnedAgentVersionStatusError, ThrowOnError>;
+/**
+ * Claim evaluation work
+ * FIFO claim of next available evaluation work item.
+ */
+declare const claimWork: <ThrowOnError extends boolean = false>(options?: OptionsLegacyParser<unknown, ThrowOnError>) => _hey_api_client_fetch.RequestResult<ClaimWorkResponse2, AtCapacityError, ThrowOnError>;
+/**
+ * Extend lease
+ * Heartbeat to extend lease and mark run as RUNNING.
+ */
+declare const heartbeat: <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<HeartbeatData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<HeartbeatResponse, HeartbeatError, ThrowOnError>;
+/**
+ * Update progress
+ * Report per-problem progress during evaluation.
+ */
+declare const updateProgress: <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<UpdateProgressData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<ProgressUpdateResponse, UpdateProgressError, ThrowOnError>;
+/**
+ * Get upload URL
+ * Get a presigned URL for uploading per-problem evaluation logs.
+ */
+declare const presignUpload: <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<PresignUploadData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<PresignUploadResponse, PresignUploadError, ThrowOnError>;
+/**
+ * Complete evaluation run
+ * Finalize an evaluation run with terminal status and score.
+ */
+declare const completeRun: <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<CompleteRunData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<CompleteRunResponse, CompleteRunError, ThrowOnError>;
+/**
+ * Ban a miner
+ * Ban a miner from submitting agents.
+ */
+declare const banMiner: <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<BanMinerData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<BanResponse, BanMinerError, ThrowOnError>;
+/**
+ * Unban a miner
+ * Unban a miner, allowing them to submit agents again.
+ */
+declare const unbanMiner: <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<UnbanMinerData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<BanResponse, UnbanMinerError, ThrowOnError>;
+/**
+ * Ban a validator
+ * Ban a validator from claiming work.
+ */
+declare const banValidator: <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<BanValidatorData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<BanResponse, BanValidatorError, ThrowOnError>;
+/**
+ * Unban a validator
+ * Unban a validator, allowing them to claim work again.
+ */
+declare const unbanValidator: <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<UnbanValidatorData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<BanResponse, UnbanValidatorError, ThrowOnError>;
+/**
+ * Discard an agent version from leaderboard
+ * Discard an agent version from the leaderboard (reversible tombstone).
+ */
+declare const discardAgentVersion: <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<DiscardAgentVersionData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<DiscardResponse, DiscardAgentVersionError, ThrowOnError>;
+/**
+ * Reinstate a discarded agent version
+ * Reinstate a previously discarded agent version.
+ */
+declare const reinstateAgentVersion: <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<ReinstateAgentVersionData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<DiscardResponse, ReinstateAgentVersionError, ThrowOnError>;
+/**
+ * Set an agent version as the top agent for emissions
+ * Designate an agent version as the top agent for emissions.
+ *
+ * The top agent is the one that receives emissions. Setting a new top agent
+ * automatically marks the previous top agent as was_top=True.
+ *
+ * Requirements:
+ * - Agent version must exist and have an aggregate for the suite
+ * - Only one agent can be is_current_top=True per suite (enforced by DB index)
+ */
+declare const setTopAgent: <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<SetTopAgentData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<SetTopResponse, SetTopAgentError, ThrowOnError>;
+/**
+ * Invalidate an evaluation run
+ * Invalidate an evaluation run (irreversible).
+ *
+ * Marks the run as excluded from scoring and adjusts the work item's
+ * included_success_count. Reopens the work item to allow validators
+ * to claim replacement work.
+ */
+declare const invalidateEvaluationRun: <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<InvalidateEvaluationRunData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<EvaluationRunStatusPublic, InvalidateEvaluationRunError, ThrowOnError>;
+/**
+ * Re-evaluate an agent version
+ * Create a new work item for an agent version to be re-evaluated.
+ */
+declare const reevaluateAgentVersion: <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<ReevaluateAgentVersionData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<ReevaluateResponse, ReevaluateAgentVersionError, ThrowOnError>;
+/**
+ * Cancel evaluation of an agent version
+ * Cancel active evaluation runs for an agent version.
+ */
+declare const cancelAgentVersion: <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<CancelAgentVersionData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<CancelResponse, HTTPValidationError, ThrowOnError>;
+/**
+ * Create a new problem suite
+ * Create a new problem suite version.
+ *
+ * Downloads and parses the problem suite JSON from S3, then creates
+ * Problem records for each problem in the suite.
+ */
+declare const createSuite: <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<CreateSuiteData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<CreateSuiteResponse, HTTPValidationError, ThrowOnError>;
+/**
+ * Activate a problem suite
+ * Activate a suite, making it the current active suite (deactivates others).
+ */
+declare const activateSuite: <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<ActivateSuiteData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<ActivateSuiteResponse, ActivateSuiteError, ThrowOnError>;
+/**
+ * Get audit events
+ * Retrieve audit events with optional filtering and pagination.
+ */
+declare const getAuditEvents: <ThrowOnError extends boolean = false>(options?: OptionsLegacyParser<GetAuditEventsData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<AuditEventsResponse, HTTPValidationError, ThrowOnError>;
+/**
+ * Get reaper service statistics
+ * Get statistics about the background reaper service.
+ *
+ * The reaper service runs periodically to clean up orphaned evaluation runs
+ * where validators have stopped reporting (crashed or disconnected).
+ *
+ * Stats are read from Redis (persisted by the active reaper instance) to ensure
+ * consistent visibility across all replicas.
+ */
+declare const getReaperStats: <ThrowOnError extends boolean = false>(options?: OptionsLegacyParser<unknown, ThrowOnError>) => _hey_api_client_fetch.RequestResult<ReaperStatsResponse, unknown, ThrowOnError>;
+
+/**
+ * Auto-generated error code type.
+ *
+ * DO NOT EDIT — regenerate with: python3 scripts/extract-errors.py
+ */
+type OroErrorCode = 'AGENT_NOT_FOUND' | 'AGENT_VERSION_NOT_FOUND' | 'ALREADY_INVALIDATED' | 'ARTIFACT_NOT_FOUND' | 'ARTIFACT_NOT_RELEASED' | 'AT_CAPACITY' | 'CODE_ANALYSIS_ERROR' | 'COOLDOWN_ACTIVE' | 'EVAL_RUN_NOT_FOUND' | 'FILE_TOO_LARGE' | 'INVALID_AGENT_NAME' | 'INVALID_ARTIFACT_TYPE' | 'INVALID_FILE' | 'INVALID_PROBLEM_ID' | 'LEASE_EXPIRED' | 'MINER_NOT_FOUND' | 'MISSING_PARAMETER' | 'MISSING_SCORE' | 'NO_ACTIVE_SUITE' | 'NOT_RUN_OWNER' | 'PROBLEM_NOT_FOUND' | 'RATE_LIMIT_EXCEEDED' | 'RUN_ALREADY_COMPLETE' | 'SCORE_BELOW_THRESHOLD' | 'SUITE_NOT_FOUND' | 'VALIDATOR_NOT_FOUND';
+
+/**
+ * Error classification utilities for the ORO SDK.
+ *
+ * Provides helpers to classify HTTP responses, check transient errors,
+ * and extract structured error details from API responses.
+ */
+
+/**
+ * High-level error category derived from HTTP status codes.
+ */
+type ErrorCategory = 'NETWORK' | 'AUTH' | 'NOT_FOUND' | 'VALIDATION' | 'CONFLICT' | 'RATE_LIMITED' | 'SERVER' | 'UNKNOWN';
+/**
+ * Classify an HTTP status code into an {@link ErrorCategory}.
+ */
+declare function classifyStatus(status: number | undefined): ErrorCategory;
+/**
+ * Classify a `Response` object (or null for network failures) into an {@link ErrorCategory}.
+ */
+declare function classifyError(response: Response | null): ErrorCategory;
+/**
+ * Returns `true` if the HTTP status code represents a transient (retryable) error.
+ *
+ * Transient statuses: 429 (rate limited), 5xx (server errors), 0/undefined (network failures).
+ */
+declare function isTransient(status: number | undefined): boolean;
+/**
+ * Returns `true` if the response represents a transient (retryable) error.
+ */
+declare function isTransientError(response: Response | null): boolean;
+/**
+ * Extract the `detail` string from a parsed error body.
+ *
+ * Returns `undefined` if `detail` is missing, not a string (e.g. Pydantic validation arrays),
+ * or the error body is null/undefined.
+ */
+declare function getErrorDetail(error: unknown): string | undefined;
+/**
+ * Extract the `error_code` from a parsed error body.
+ *
+ * Returns `undefined` if the field is missing or not a string.
+ */
+declare function getErrorCode(error: unknown): OroErrorCode | undefined;
+/**
+ * Type guard that narrows `error` to an object with a matching `error_code`.
+ */
+declare function hasErrorCode<C extends OroErrorCode>(error: unknown, code: C): error is {
+    error_code: C;
+};
+/**
+ * Type guard that narrows `error` to `{ detail: string }`.
+ */
+declare function hasDetail(error: unknown): error is {
+    detail: string;
+};
+
+/**
+ * Retry middleware for the ORO SDK.
+ *
+ * Provides opt-in retry logic with exponential backoff for transient errors
+ * (429, 502, 503, 504) and network failures.
+ */
+/**
+ * Configuration for retry behavior.
+ */
+interface RetryConfig {
+    /** Maximum number of retries. Set to 0 to disable. Defaults to 3. */
+    maxRetries?: number;
+    /** HTTP status codes that should trigger a retry. Defaults to [429, 502, 503, 504]. */
+    retryableStatuses?: number[];
+    /** Base delay in milliseconds for exponential backoff. Defaults to 1000. */
+    baseDelayMs?: number;
+    /** Maximum delay in milliseconds. Defaults to 30000. */
+    maxDelayMs?: number;
+    /** Whether to add random jitter to the delay. Defaults to true. */
+    jitter?: boolean;
+    /** Optional callback invoked before each retry attempt. */
+    onRetry?: (context: RetryContext) => void;
+}
+/**
+ * Context passed to the onRetry callback.
+ */
+interface RetryContext {
+    /** The current retry attempt number (1-based). */
+    attempt: number;
+    /** The delay in milliseconds before this retry. */
+    delayMs: number;
+    /** The HTTP status code that triggered the retry, or undefined for network errors. */
+    status?: number;
+    /** The Retry-After value from the response header, in milliseconds. */
+    retryAfter?: number;
+}
+/**
+ * Parse the Retry-After header value into milliseconds.
+ *
+ * Supports both integer seconds (`120`) and HTTP-date format
+ * (`Wed, 21 Oct 2015 07:28:00 GMT`).
+ *
+ * @param response - The Response object to parse the header from
+ * @returns Retry-After value in milliseconds, or undefined if not present/parseable
+ */
+declare function parseRetryAfter(response: Response): number | undefined;
+/**
+ * Compute the delay before the next retry attempt using exponential backoff.
+ *
+ * Formula: `min(base * 2^attempt, max)`, optionally jittered, with
+ * Retry-After taking precedence when present.
+ *
+ * @param attempt - The current attempt number (0-based)
+ * @param baseDelayMs - Base delay in milliseconds
+ * @param maxDelayMs - Maximum delay in milliseconds
+ * @param jitter - Whether to add random jitter
+ * @param retryAfter - Optional Retry-After value in milliseconds
+ * @returns The computed delay in milliseconds
+ */
+declare function computeDelay(attempt: number, baseDelayMs: number, maxDelayMs: number, jitter: boolean, retryAfter?: number): number;
+/**
+ * Create a fetch wrapper that retries transient failures with exponential backoff.
+ *
+ * The returned function has the same signature as `globalThis.fetch` and can be
+ * passed to `client.setConfig({ fetch: ... })`.
+ *
+ * @param config - Retry configuration (all fields optional with sensible defaults)
+ * @returns A fetch-compatible function with retry logic
+ *
+ * @example
+ * ```typescript
+ * import { createRetryFetch } from '@oro-ai/sdk';
+ *
+ * // Use defaults (3 retries, 1s base delay)
+ * const retryFetch = createRetryFetch({});
+ *
+ * // Custom config
+ * const retryFetch = createRetryFetch({ maxRetries: 5, baseDelayMs: 500 });
+ *
+ * // Disable retries
+ * const noRetryFetch = createRetryFetch({ maxRetries: 0 });
+ * ```
+ */
+declare function createRetryFetch(config: RetryConfig): typeof globalThis.fetch;
+
+/**
+ * Bittensor wallet authentication helper for ORO SDK.
+ *
+ * This module provides utilities to authenticate API requests using
+ * Bittensor wallet signatures (SR25519).
+ */
+
+/**
+ * Configuration for Bittensor authentication.
+ */
+interface BittensorAuthConfig {
+    /**
+     * The hotkey SS58 address.
+     */
+    hotkey: string;
+    /**
+     * Function to sign a message with the hotkey.
+     * Should return the signature as a hex string.
+     *
+     * @param message - The message to sign (format: "{hotkey}:{timestamp}:{nonce}")
+     * @returns Signature as hex string (with or without 0x prefix)
+     */
+    sign: (message: string) => string | Promise<string>;
+}
+/**
+ * Generate authentication headers for a Bittensor wallet.
+ *
+ * The message format is '{hotkey}:{timestamp}:{nonce}' to match
+ * the ORO Backend's expected signature format.
+ *
+ * @param config - Bittensor auth configuration
+ * @param nonce - Optional nonce (defaults to crypto.randomUUID())
+ * @returns Object with X-Hotkey, X-Signature, X-Nonce, X-Timestamp headers
+ */
+declare function generateAuthHeaders(config: BittensorAuthConfig, nonce?: string): Promise<Record<string, string>>;
+/**
+ * Configure the SDK client with Bittensor authentication.
+ *
+ * This adds a request interceptor that automatically signs each request
+ * with fresh authentication headers.
+ *
+ * @param baseUrl - API base URL
+ * @param authConfig - Bittensor auth configuration
+ * @returns The configured client
+ *
+ * @example
+ * ```typescript
+ * import { configureBittensorAuth, claimWork } from '@oro-ai/sdk';
+ *
+ * // With a signing function (you provide the implementation)
+ * configureBittensorAuth('https://api.oro.ai', {
+ *   hotkey: '5GrwvaEF5zXb26Fz9rcQpDWS57CtERHpNehXCPcNoHGKutQY',
+ *   sign: (message) => wallet.sign(message),
+ * });
+ *
+ * // Now all requests are automatically authenticated
+ * const { data: work } = await claimWork();
+ * ```
+ */
+declare function configureBittensorAuth(baseUrl: string, authConfig: BittensorAuthConfig, retryConfig?: RetryConfig): typeof client;
+/**
+ * Configure the SDK client for public (unauthenticated) access only.
+ *
+ * @param baseUrl - API base URL
+ * @returns The configured client
+ *
+ * @example
+ * ```typescript
+ * import { configurePublicClient, getLeaderboard } from '@oro-ai/sdk';
+ *
+ * configurePublicClient('https://api.oro.ai');
+ * const { data } = await getLeaderboard();
+ * ```
+ */
+declare function configurePublicClient(baseUrl: string, retryConfig?: RetryConfig): typeof client;
+
+/**
+ * Session-based authentication manager for ORO SDK.
+ *
+ * This module provides a convenient session lifecycle manager that handles
+ * challenge/response login, token storage, auto-refresh, header injection,
+ * and logout — matching the convenience of the Python SDK's BittensorAuthClient.
+ */
+
+/**
+ * Configuration for session-based authentication.
+ */
+interface SessionAuthConfig {
+    /** The hotkey SS58 address. */
+    hotkey: string;
+    /**
+     * Function to sign a challenge string with the hotkey.
+     * Should return the signature as a hex string.
+     */
+    sign: (message: string) => string | Promise<string>;
+    /** Seconds before expiry to trigger auto-refresh. Default: 300 (5 minutes). */
+    refreshBufferSeconds?: number;
+    /** Called when the session has expired and cannot be refreshed. */
+    onSessionExpired?: () => void;
+}
+/**
+ * Information about the current session.
+ */
+interface SessionInfo {
+    hotkey: string;
+    role: string;
+    expiresAt: number;
+}
+/**
+ * Manages the full session authentication lifecycle: login, logout,
+ * token refresh, and automatic header injection.
+ */
+declare class SessionAuthManager {
+    private token;
+    private expiresAt;
+    private role;
+    private refreshPromise;
+    private readonly hotkey;
+    private readonly sign;
+    private readonly refreshBufferSeconds;
+    private readonly onSessionExpired?;
+    constructor(config: SessionAuthConfig);
+    /**
+     * Perform challenge/response login flow.
+     *
+     * 1. Requests a challenge from the server
+     * 2. Signs the challenge with the configured sign function
+     * 3. Creates a session with the signed challenge
+     * 4. Stores the session token internally
+     */
+    login(): Promise<SessionResponse>;
+    /**
+     * Logout and invalidate the current session.
+     * Silently catches errors (session may already be expired).
+     */
+    logout(): Promise<void>;
+    /**
+     * Refresh the session by performing a new login flow.
+     */
+    refreshSession(): Promise<SessionResponse>;
+    /** Returns true if a session token exists and hasn't expired. */
+    hasActiveSession(): boolean;
+    /** Returns true if the session is within the refresh buffer of expiry. */
+    sessionNeedsRefresh(): boolean;
+    /** Returns current session info, or null if no active session. */
+    getSessionInfo(): SessionInfo | null;
+    /**
+     * Returns authorization headers. Auto-refreshes if the session is
+     * within the refresh buffer. Throws if not authenticated or session expired.
+     */
+    getAuthHeaders(): Promise<Record<string, string>>;
+    private clearSession;
+}
+/**
+ * Configure the SDK client with session-based authentication.
+ *
+ * Sets up the base URL, creates a {@link SessionAuthManager}, and installs
+ * a request interceptor that injects Bearer tokens automatically.
+ *
+ * @param baseUrl - API base URL
+ * @param config - Session auth configuration
+ * @returns A {@link SessionAuthManager} instance for controlling the session lifecycle
+ *
+ * @example
+ * ```typescript
+ * import { configureSessionAuth, listMinerAgents } from '@oro-ai/sdk';
+ *
+ * const session = configureSessionAuth('https://api.oro.ai', {
+ *   hotkey: '5GrwvaEF...',
+ *   sign: (challenge) => wallet.sign(challenge),
+ *   onSessionExpired: () => router.push('/login'),
+ * });
+ *
+ * await session.login();
+ *
+ * // All subsequent requests include Bearer token automatically
+ * const { data: agents } = await listMinerAgents();
+ * ```
+ */
+declare function configureSessionAuth(baseUrl: string, config: SessionAuthConfig): SessionAuthManager;
+
+export { type ActivateSuiteData, type ActivateSuiteError, type ActivateSuiteResponse, type ActivateSuiteResponse2, type AdmissionReason, type AdmissionStatus, type AgentNotFoundError, type AgentPublic, type AgentVersionHistoryEntry, type AgentVersionNotFoundError, type AgentVersionProblemsResponse, type AgentVersionPublic, type AgentVersionState, type AgentVersionStatus, type AlreadyInvalidatedError, type ArtifactDownloadRequest, type ArtifactDownloadResponse, type ArtifactNotFoundError, type ArtifactNotReleasedError, type ArtifactReleaseState, type ArtifactType, type AtCapacityError, type AuditEventEntry, type AuditEventsResponse, type BanMinerData, type BanMinerError, type BanMinerResponse, type BanRequest, type BanResponse, type BanValidatorData, type BanValidatorError, type BanValidatorResponse, type BittensorAuthConfig, type Body_submit_agent, type CancelAgentVersionData, type CancelAgentVersionError, type CancelAgentVersionResponse, type CancelRequest, type CancelResponse, type ChallengeRequest, type ChallengeResponse, type ClaimWorkError, type ClaimWorkResponse, type ClaimWorkResponse2, type CodeAnalysisError, type CompleteRunData, type CompleteRunError, type CompleteRunRequest, type CompleteRunResponse, type CompleteRunResponse2, type CooldownActiveError, type CreateSessionEndpointData, type CreateSessionEndpointError, type CreateSessionEndpointResponse, type CreateSuiteData, type CreateSuiteError, type CreateSuiteRequest, type CreateSuiteResponse, type CreateSuiteResponse2, type DiscardAgentVersionData, type DiscardAgentVersionError, type DiscardAgentVersionResponse, type DiscardRequest, type DiscardResponse, type ErrorCategory, type EvalRunNotFoundError, type EvaluationRunDetail, type EvaluationRunPublic, type EvaluationRunStatus, type EvaluationRunStatusPublic, type FileTooLargeError, type GetAgentVersionData, type GetAgentVersionError, type GetAgentVersionProblemsData, type GetAgentVersionProblemsError, type GetAgentVersionProblemsResponse, type GetAgentVersionResponse, type GetAgentVersionRunsData, type GetAgentVersionRunsError, type GetAgentVersionRunsResponse, type GetAgentVersionStatusData, type GetAgentVersionStatusError, type GetAgentVersionStatusResponse, type GetArtifactDownloadUrlData, type GetArtifactDownloadUrlError, type GetArtifactDownloadUrlResponse, type GetAuditEventsData, type GetAuditEventsError, type GetAuditEventsResponse, type GetCurrentSuiteError, type GetCurrentSuiteResponse, type GetEvaluationRunData, type GetEvaluationRunError, type GetEvaluationRunResponse, type GetLeaderboardData, type GetLeaderboardError, type GetLeaderboardResponse, type GetOwnedAgentVersionStatusData, type GetOwnedAgentVersionStatusError, type GetOwnedAgentVersionStatusResponse, type GetPendingEvaluationsData, type GetPendingEvaluationsError, type GetPendingEvaluationsResponse, type GetReaperStatsError, type GetReaperStatsResponse, type GetRunningEvaluationsError, type GetRunningEvaluationsResponse, type GetSuiteProblemsData, type GetSuiteProblemsError, type GetSuiteProblemsResponse, type GetTopAgentError, type GetTopAgentResponse, type GetValidatorsError, type GetValidatorsResponse, type HTTPValidationError, type HealthCheckError, type HealthCheckResponse, type HeartbeatData, type HeartbeatError, type HeartbeatRequest, type HeartbeatResponse, type HeartbeatResponse2, type InvalidAgentNameError, type InvalidArtifactTypeError, type InvalidFileError, type InvalidProblemIdError, type InvalidateEvaluationRunData, type InvalidateEvaluationRunError, type InvalidateEvaluationRunResponse, type InvalidateRunRequest, type LeaderboardEntry, type LeaderboardResponse, type LeaseExpiredError, type ListAgentVersionsData, type ListAgentVersionsError, type ListAgentVersionsResponse, type ListMinerAgentsError, type ListMinerAgentsResponse, type LogoutData, type LogoutError, type LogoutResponse, type LogoutResponse2, type MinerAgentsResponse, type MinerNotFoundError, type MissingParameterError, type MissingScoreError, type NoActiveSuiteError, type NotRunOwnerError, type OroErrorCode, type PendingEvaluation, type PendingEvaluationSummary, type PendingEvaluationsResponse, type PresignUploadData, type PresignUploadError, type PresignUploadRequest, type PresignUploadResponse, type PresignUploadResponse2, type ProblemNotFoundError, type ProblemProgressEntry, type ProblemProgressUpdate, type ProblemPublic, type ProblemStatus, type ProgressUpdateRequest, type ProgressUpdateResponse, type RateLimitExceededError, type ReaperStatsResponse, type ReevaluateAgentVersionData, type ReevaluateAgentVersionError, type ReevaluateAgentVersionResponse, type ReevaluateRequest, type ReevaluateResponse, type ReinstateAgentVersionData, type ReinstateAgentVersionError, type ReinstateAgentVersionResponse, type ReinstateRequest, type RequestChallengeData, type RequestChallengeError, type RequestChallengeResponse, type RetryConfig, type RetryContext, type RunAlreadyCompleteError, type RunningEvaluation, type ScoreBelowThresholdError, type SessionAuthConfig, SessionAuthManager, type SessionInfo, type SessionRequest, type SessionResponse, type SetTopAgentData, type SetTopAgentError, type SetTopAgentResponse, type SetTopRequest, type SetTopResponse, type SubmitAgentData, type SubmitAgentError, type SubmitAgentResponse, type SubmitAgentResponse2, type SuiteNotFoundError, type SuitePublic, type SuiteWithProblemsResponse, type TerminalStatus, type TopAgentResponse, type UnbanMinerData, type UnbanMinerError, type UnbanMinerResponse, type UnbanValidatorData, type UnbanValidatorError, type UnbanValidatorResponse, type UpdateProgressData, type UpdateProgressError, type UpdateProgressResponse, type ValidationError, type ValidatorCurrentAgent, type ValidatorNotFoundError, type ValidatorProblemResult, type ValidatorPublic, type ValidatorStatus, type WorkItemStatus, activateSuite, banMiner, banValidator, cancelAgentVersion, claimWork, classifyError, classifyStatus, client, completeRun, computeDelay, configureBittensorAuth, configurePublicClient, configureSessionAuth, createRetryFetch, createSessionEndpoint, createSuite, discardAgentVersion, generateAuthHeaders, getAgentVersion, getAgentVersionProblems, getAgentVersionRuns, getAgentVersionStatus, getArtifactDownloadUrl, getAuditEvents, getCurrentSuite, getErrorCode, getErrorDetail, getEvaluationRun, getLeaderboard, getOwnedAgentVersionStatus, getPendingEvaluations, getReaperStats, getRunningEvaluations, getSuiteProblems, getTopAgent, getValidators, hasDetail, hasErrorCode, healthCheck, heartbeat, invalidateEvaluationRun, isTransient, isTransientError, listAgentVersions, listMinerAgents, logout, parseRetryAfter, presignUpload, reevaluateAgentVersion, reinstateAgentVersion, requestChallenge, setTopAgent, submitAgent, unbanMiner, unbanValidator, updateProgress };