@oro-ai/sdk 0.6.8

package/src/generated/sdk.gen.ts

@@ -0,0 +1,481 @@
+// This file is auto-generated by @hey-api/openapi-ts
+
+import { createClient, createConfig, type OptionsLegacyParser, formDataBodySerializer } from '@hey-api/client-fetch';
+import type { HealthCheckError, HealthCheckResponse, GetCurrentSuiteError, GetCurrentSuiteResponse, GetSuiteProblemsData, GetSuiteProblemsError, GetSuiteProblemsResponse, GetLeaderboardData, GetLeaderboardError, GetLeaderboardResponse, GetTopAgentError, GetTopAgentResponse, GetAgentVersionStatusData, GetAgentVersionStatusError, GetAgentVersionStatusResponse, GetAgentVersionRunsData, GetAgentVersionRunsError, GetAgentVersionRunsResponse, GetAgentVersionProblemsData, GetAgentVersionProblemsError, GetAgentVersionProblemsResponse, GetAgentVersionData, GetAgentVersionError, GetAgentVersionResponse, GetArtifactDownloadUrlData, GetArtifactDownloadUrlError, GetArtifactDownloadUrlResponse, GetEvaluationRunData, GetEvaluationRunError, GetEvaluationRunResponse, GetValidatorsError, GetValidatorsResponse, GetRunningEvaluationsError, GetRunningEvaluationsResponse, GetPendingEvaluationsData, GetPendingEvaluationsError, GetPendingEvaluationsResponse, RequestChallengeData, RequestChallengeError, RequestChallengeResponse, CreateSessionEndpointData, CreateSessionEndpointError, CreateSessionEndpointResponse, LogoutData, LogoutError, LogoutResponse2, SubmitAgentData, SubmitAgentError, SubmitAgentResponse2, ListMinerAgentsError, ListMinerAgentsResponse, ListAgentVersionsData, ListAgentVersionsError, ListAgentVersionsResponse, GetOwnedAgentVersionStatusData, GetOwnedAgentVersionStatusError, GetOwnedAgentVersionStatusResponse, ClaimWorkError, ClaimWorkResponse2, HeartbeatData, HeartbeatError, HeartbeatResponse2, UpdateProgressData, UpdateProgressError, UpdateProgressResponse, PresignUploadData, PresignUploadError, PresignUploadResponse2, CompleteRunData, CompleteRunError, CompleteRunResponse2, BanMinerData, BanMinerError, BanMinerResponse, UnbanMinerData, UnbanMinerError, UnbanMinerResponse, BanValidatorData, BanValidatorError, BanValidatorResponse, UnbanValidatorData, UnbanValidatorError, UnbanValidatorResponse, DiscardAgentVersionData, DiscardAgentVersionError, DiscardAgentVersionResponse, ReinstateAgentVersionData, ReinstateAgentVersionError, ReinstateAgentVersionResponse, SetTopAgentData, SetTopAgentError, SetTopAgentResponse, InvalidateEvaluationRunData, InvalidateEvaluationRunError, InvalidateEvaluationRunResponse, ReevaluateAgentVersionData, ReevaluateAgentVersionError, ReevaluateAgentVersionResponse, CancelAgentVersionData, CancelAgentVersionError, CancelAgentVersionResponse, CreateSuiteData, CreateSuiteError, CreateSuiteResponse2, ActivateSuiteData, ActivateSuiteError, ActivateSuiteResponse2, GetAuditEventsData, GetAuditEventsError, GetAuditEventsResponse, GetReaperStatsError, GetReaperStatsResponse } from './types.gen';
+
+export const client = createClient(createConfig());
+
+/**
+ * Health Check
+ * Health check endpoint (no auth required).
+ */
+export const healthCheck = <ThrowOnError extends boolean = false>(options?: OptionsLegacyParser<unknown, ThrowOnError>) => {
+    return (options?.client ?? client).get<HealthCheckResponse, HealthCheckError, ThrowOnError>({
+        ...options,
+        url: '/health'
+    });
+};
+
+/**
+ * Get current active suite
+ * Fetch the currently active problem suite.
+ */
+export const getCurrentSuite = <ThrowOnError extends boolean = false>(options?: OptionsLegacyParser<unknown, ThrowOnError>) => {
+    return (options?.client ?? client).get<GetCurrentSuiteResponse, GetCurrentSuiteError, ThrowOnError>({
+        ...options,
+        url: '/v1/public/suites/current'
+    });
+};
+
+/**
+ * Get suite problems
+ * Get the list of problems for a specific suite.
+ */
+export const getSuiteProblems = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<GetSuiteProblemsData, ThrowOnError>) => {
+    return (options?.client ?? client).get<GetSuiteProblemsResponse, GetSuiteProblemsError, ThrowOnError>({
+        ...options,
+        url: '/v1/public/suites/{suite_id}/problems'
+    });
+};
+
+/**
+ * Get leaderboard
+ * Get the eligible agent leaderboard for a suite.
+ */
+export const getLeaderboard = <ThrowOnError extends boolean = false>(options?: OptionsLegacyParser<GetLeaderboardData, ThrowOnError>) => {
+    return (options?.client ?? client).get<GetLeaderboardResponse, GetLeaderboardError, ThrowOnError>({
+        ...options,
+        url: '/v1/public/leaderboard'
+    });
+};
+
+/**
+ * Get top agent for emissions
+ * Get the canonical top miner for emissions calculation.
+ */
+export const getTopAgent = <ThrowOnError extends boolean = false>(options?: OptionsLegacyParser<unknown, ThrowOnError>) => {
+    return (options?.client ?? client).get<GetTopAgentResponse, GetTopAgentError, ThrowOnError>({
+        ...options,
+        url: '/v1/public/top'
+    });
+};
+
+/**
+ * Get agent version status
+ * Get live status and counters for an agent version.
+ */
+export const getAgentVersionStatus = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<GetAgentVersionStatusData, ThrowOnError>) => {
+    return (options?.client ?? client).get<GetAgentVersionStatusResponse, GetAgentVersionStatusError, ThrowOnError>({
+        ...options,
+        url: '/v1/public/agent-versions/{agent_version_id}/status'
+    });
+};
+
+/**
+ * Get agent version runs
+ * Get evaluation runs for an agent version.
+ */
+export const getAgentVersionRuns = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<GetAgentVersionRunsData, ThrowOnError>) => {
+    return (options?.client ?? client).get<GetAgentVersionRunsResponse, GetAgentVersionRunsError, ThrowOnError>({
+        ...options,
+        url: '/v1/public/agent-versions/{agent_version_id}/runs'
+    });
+};
+
+/**
+ * Get agent version problem progress
+ * Get per-problem progress matrix across validators.
+ */
+export const getAgentVersionProblems = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<GetAgentVersionProblemsData, ThrowOnError>) => {
+    return (options?.client ?? client).get<GetAgentVersionProblemsResponse, GetAgentVersionProblemsError, ThrowOnError>({
+        ...options,
+        url: '/v1/public/agent-versions/{agent_version_id}/problems'
+    });
+};
+
+/**
+ * Get agent version details
+ * Get released public details for an agent version.
+ */
+export const getAgentVersion = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<GetAgentVersionData, ThrowOnError>) => {
+    return (options?.client ?? client).get<GetAgentVersionResponse, GetAgentVersionError, ThrowOnError>({
+        ...options,
+        url: '/v1/public/agent-versions/{agent_version_id}'
+    });
+};
+
+/**
+ * Get artifact download URL
+ * Get a presigned URL to download released artifacts.
+ */
+export const getArtifactDownloadUrl = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<GetArtifactDownloadUrlData, ThrowOnError>) => {
+    return (options?.client ?? client).post<GetArtifactDownloadUrlResponse, GetArtifactDownloadUrlError, ThrowOnError>({
+        ...options,
+        url: '/v1/public/artifacts/download-url'
+    });
+};
+
+/**
+ * Get evaluation run details
+ * Get detailed information about a specific evaluation run.
+ */
+export const getEvaluationRun = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<GetEvaluationRunData, ThrowOnError>) => {
+    return (options?.client ?? client).get<GetEvaluationRunResponse, GetEvaluationRunError, ThrowOnError>({
+        ...options,
+        url: '/v1/public/evaluation-runs/{eval_run_id}'
+    });
+};
+
+/**
+ * Get list of validators
+ * Get all non-banned validators with their current status.
+ */
+export const getValidators = <ThrowOnError extends boolean = false>(options?: OptionsLegacyParser<unknown, ThrowOnError>) => {
+    return (options?.client ?? client).get<GetValidatorsResponse, GetValidatorsError, ThrowOnError>({
+        ...options,
+        url: '/v1/public/validators'
+    });
+};
+
+/**
+ * Get running evaluations
+ * Get all currently running or claimed evaluations.
+ */
+export const getRunningEvaluations = <ThrowOnError extends boolean = false>(options?: OptionsLegacyParser<unknown, ThrowOnError>) => {
+    return (options?.client ?? client).get<GetRunningEvaluationsResponse, GetRunningEvaluationsError, ThrowOnError>({
+        ...options,
+        url: '/v1/public/evaluations/running'
+    });
+};
+
+/**
+ * Get pending evaluations
+ * Get all open work items awaiting validator evaluations, with queue summary.
+ */
+export const getPendingEvaluations = <ThrowOnError extends boolean = false>(options?: OptionsLegacyParser<GetPendingEvaluationsData, ThrowOnError>) => {
+    return (options?.client ?? client).get<GetPendingEvaluationsResponse, GetPendingEvaluationsError, ThrowOnError>({
+        ...options,
+        url: '/v1/public/evaluations/pending'
+    });
+};
+
+/**
+ * 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.
+ */
+export const requestChallenge = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<RequestChallengeData, ThrowOnError>) => {
+    return (options?.client ?? client).post<RequestChallengeResponse, RequestChallengeError, ThrowOnError>({
+        ...options,
+        url: '/v1/auth/challenge'
+    });
+};
+
+/**
+ * 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.
+ */
+export const createSessionEndpoint = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<CreateSessionEndpointData, ThrowOnError>) => {
+    return (options?.client ?? client).post<CreateSessionEndpointResponse, CreateSessionEndpointError, ThrowOnError>({
+        ...options,
+        url: '/v1/auth/session'
+    });
+};
+
+/**
+ * Logout
+ * Logout and invalidate the current session.
+ */
+export const logout = <ThrowOnError extends boolean = false>(options?: OptionsLegacyParser<LogoutData, ThrowOnError>) => {
+    return (options?.client ?? client).post<LogoutResponse2, LogoutError, ThrowOnError>({
+        ...options,
+        url: '/v1/auth/logout'
+    });
+};
+
+/**
+ * Submit agent
+ * Submit an agent file for evaluation. Creates new agent if needed.
+ */
+export const submitAgent = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<SubmitAgentData, ThrowOnError>) => {
+    return (options?.client ?? client).post<SubmitAgentResponse2, SubmitAgentError, ThrowOnError>({
+        ...options,
+        ...formDataBodySerializer,
+        headers: {
+            'Content-Type': null,
+            ...options?.headers
+        },
+        url: '/v1/miner/submit'
+    });
+};
+
+/**
+ * List miner's agents
+ * List all agents owned by the authenticated miner, with cooldown status.
+ */
+export const listMinerAgents = <ThrowOnError extends boolean = false>(options?: OptionsLegacyParser<unknown, ThrowOnError>) => {
+    return (options?.client ?? client).get<ListMinerAgentsResponse, ListMinerAgentsError, ThrowOnError>({
+        ...options,
+        url: '/v1/miner/agents'
+    });
+};
+
+/**
+ * List agent versions
+ * List all versions of a specific agent owned by the miner.
+ */
+export const listAgentVersions = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<ListAgentVersionsData, ThrowOnError>) => {
+    return (options?.client ?? client).get<ListAgentVersionsResponse, ListAgentVersionsError, ThrowOnError>({
+        ...options,
+        url: '/v1/miner/agents/{agent_id}/versions'
+    });
+};
+
+/**
+ * Get agent version status
+ * Get detailed status of a specific agent version owned by the miner.
+ */
+export const getOwnedAgentVersionStatus = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<GetOwnedAgentVersionStatusData, ThrowOnError>) => {
+    return (options?.client ?? client).get<GetOwnedAgentVersionStatusResponse, GetOwnedAgentVersionStatusError, ThrowOnError>({
+        ...options,
+        url: '/v1/miner/agent-versions/{agent_version_id}'
+    });
+};
+
+/**
+ * Claim evaluation work
+ * FIFO claim of next available evaluation work item.
+ */
+export const claimWork = <ThrowOnError extends boolean = false>(options?: OptionsLegacyParser<unknown, ThrowOnError>) => {
+    return (options?.client ?? client).post<ClaimWorkResponse2, ClaimWorkError, ThrowOnError>({
+        ...options,
+        url: '/v1/validator/work/claim'
+    });
+};
+
+/**
+ * Extend lease
+ * Heartbeat to extend lease and mark run as RUNNING.
+ */
+export const heartbeat = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<HeartbeatData, ThrowOnError>) => {
+    return (options?.client ?? client).post<HeartbeatResponse2, HeartbeatError, ThrowOnError>({
+        ...options,
+        url: '/v1/validator/evaluation-runs/{eval_run_id}/heartbeat'
+    });
+};
+
+/**
+ * Update progress
+ * Report per-problem progress during evaluation.
+ */
+export const updateProgress = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<UpdateProgressData, ThrowOnError>) => {
+    return (options?.client ?? client).post<UpdateProgressResponse, UpdateProgressError, ThrowOnError>({
+        ...options,
+        url: '/v1/validator/evaluation-runs/{eval_run_id}/progress'
+    });
+};
+
+/**
+ * Get upload URL
+ * Get a presigned URL for uploading per-problem evaluation logs.
+ */
+export const presignUpload = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<PresignUploadData, ThrowOnError>) => {
+    return (options?.client ?? client).post<PresignUploadResponse2, PresignUploadError, ThrowOnError>({
+        ...options,
+        url: '/v1/validator/uploads/presign'
+    });
+};
+
+/**
+ * Complete evaluation run
+ * Finalize an evaluation run with terminal status and score.
+ */
+export const completeRun = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<CompleteRunData, ThrowOnError>) => {
+    return (options?.client ?? client).post<CompleteRunResponse2, CompleteRunError, ThrowOnError>({
+        ...options,
+        url: '/v1/validator/evaluation-runs/{eval_run_id}/complete'
+    });
+};
+
+/**
+ * Ban a miner
+ * Ban a miner from submitting agents.
+ */
+export const banMiner = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<BanMinerData, ThrowOnError>) => {
+    return (options?.client ?? client).post<BanMinerResponse, BanMinerError, ThrowOnError>({
+        ...options,
+        url: '/v1/admin/miners/{miner_hotkey}/ban'
+    });
+};
+
+/**
+ * Unban a miner
+ * Unban a miner, allowing them to submit agents again.
+ */
+export const unbanMiner = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<UnbanMinerData, ThrowOnError>) => {
+    return (options?.client ?? client).post<UnbanMinerResponse, UnbanMinerError, ThrowOnError>({
+        ...options,
+        url: '/v1/admin/miners/{miner_hotkey}/unban'
+    });
+};
+
+/**
+ * Ban a validator
+ * Ban a validator from claiming work.
+ */
+export const banValidator = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<BanValidatorData, ThrowOnError>) => {
+    return (options?.client ?? client).post<BanValidatorResponse, BanValidatorError, ThrowOnError>({
+        ...options,
+        url: '/v1/admin/validators/{validator_hotkey}/ban'
+    });
+};
+
+/**
+ * Unban a validator
+ * Unban a validator, allowing them to claim work again.
+ */
+export const unbanValidator = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<UnbanValidatorData, ThrowOnError>) => {
+    return (options?.client ?? client).post<UnbanValidatorResponse, UnbanValidatorError, ThrowOnError>({
+        ...options,
+        url: '/v1/admin/validators/{validator_hotkey}/unban'
+    });
+};
+
+/**
+ * Discard an agent version from leaderboard
+ * Discard an agent version from the leaderboard (reversible tombstone).
+ */
+export const discardAgentVersion = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<DiscardAgentVersionData, ThrowOnError>) => {
+    return (options?.client ?? client).post<DiscardAgentVersionResponse, DiscardAgentVersionError, ThrowOnError>({
+        ...options,
+        url: '/v1/admin/agent-versions/{agent_version_id}/discard'
+    });
+};
+
+/**
+ * Reinstate a discarded agent version
+ * Reinstate a previously discarded agent version.
+ */
+export const reinstateAgentVersion = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<ReinstateAgentVersionData, ThrowOnError>) => {
+    return (options?.client ?? client).post<ReinstateAgentVersionResponse, ReinstateAgentVersionError, ThrowOnError>({
+        ...options,
+        url: '/v1/admin/agent-versions/{agent_version_id}/reinstate'
+    });
+};
+
+/**
+ * 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)
+ */
+export const setTopAgent = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<SetTopAgentData, ThrowOnError>) => {
+    return (options?.client ?? client).post<SetTopAgentResponse, SetTopAgentError, ThrowOnError>({
+        ...options,
+        url: '/v1/admin/agent-versions/{agent_version_id}/set-top'
+    });
+};
+
+/**
+ * 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.
+ */
+export const invalidateEvaluationRun = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<InvalidateEvaluationRunData, ThrowOnError>) => {
+    return (options?.client ?? client).post<InvalidateEvaluationRunResponse, InvalidateEvaluationRunError, ThrowOnError>({
+        ...options,
+        url: '/v1/admin/evaluation-runs/{eval_run_id}/invalidate'
+    });
+};
+
+/**
+ * Re-evaluate an agent version
+ * Create a new work item for an agent version to be re-evaluated.
+ */
+export const reevaluateAgentVersion = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<ReevaluateAgentVersionData, ThrowOnError>) => {
+    return (options?.client ?? client).post<ReevaluateAgentVersionResponse, ReevaluateAgentVersionError, ThrowOnError>({
+        ...options,
+        url: '/v1/admin/agent-versions/{agent_version_id}/reevaluate'
+    });
+};
+
+/**
+ * Cancel evaluation of an agent version
+ * Cancel active evaluation runs for an agent version.
+ */
+export const cancelAgentVersion = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<CancelAgentVersionData, ThrowOnError>) => {
+    return (options?.client ?? client).post<CancelAgentVersionResponse, CancelAgentVersionError, ThrowOnError>({
+        ...options,
+        url: '/v1/admin/agent-versions/{agent_version_id}/cancel'
+    });
+};
+
+/**
+ * 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.
+ */
+export const createSuite = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<CreateSuiteData, ThrowOnError>) => {
+    return (options?.client ?? client).post<CreateSuiteResponse2, CreateSuiteError, ThrowOnError>({
+        ...options,
+        url: '/v1/admin/suites'
+    });
+};
+
+/**
+ * Activate a problem suite
+ * Activate a suite, making it the current active suite (deactivates others).
+ */
+export const activateSuite = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<ActivateSuiteData, ThrowOnError>) => {
+    return (options?.client ?? client).post<ActivateSuiteResponse2, ActivateSuiteError, ThrowOnError>({
+        ...options,
+        url: '/v1/admin/suites/{suite_id}/activate'
+    });
+};
+
+/**
+ * Get audit events
+ * Retrieve audit events with optional filtering and pagination.
+ */
+export const getAuditEvents = <ThrowOnError extends boolean = false>(options?: OptionsLegacyParser<GetAuditEventsData, ThrowOnError>) => {
+    return (options?.client ?? client).get<GetAuditEventsResponse, GetAuditEventsError, ThrowOnError>({
+        ...options,
+        url: '/v1/admin/audit-events'
+    });
+};
+
+/**
+ * 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.
+ */
+export const getReaperStats = <ThrowOnError extends boolean = false>(options?: OptionsLegacyParser<unknown, ThrowOnError>) => {
+    return (options?.client ?? client).get<GetReaperStatsResponse, GetReaperStatsError, ThrowOnError>({
+        ...options,
+        url: '/v1/admin/reaper/stats'
+    });
+};