@oro-ai/sdk 0.6.8

package/dist/index.js

@@ -0,0 +1,737 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  SessionAuthManager: () => SessionAuthManager,
+  activateSuite: () => activateSuite,
+  banMiner: () => banMiner,
+  banValidator: () => banValidator,
+  cancelAgentVersion: () => cancelAgentVersion,
+  claimWork: () => claimWork,
+  classifyError: () => classifyError,
+  classifyStatus: () => classifyStatus,
+  client: () => client,
+  completeRun: () => completeRun,
+  computeDelay: () => computeDelay,
+  configureBittensorAuth: () => configureBittensorAuth,
+  configurePublicClient: () => configurePublicClient,
+  configureSessionAuth: () => configureSessionAuth,
+  createRetryFetch: () => createRetryFetch,
+  createSessionEndpoint: () => createSessionEndpoint,
+  createSuite: () => createSuite,
+  discardAgentVersion: () => discardAgentVersion,
+  generateAuthHeaders: () => generateAuthHeaders,
+  getAgentVersion: () => getAgentVersion,
+  getAgentVersionProblems: () => getAgentVersionProblems,
+  getAgentVersionRuns: () => getAgentVersionRuns,
+  getAgentVersionStatus: () => getAgentVersionStatus,
+  getArtifactDownloadUrl: () => getArtifactDownloadUrl,
+  getAuditEvents: () => getAuditEvents,
+  getCurrentSuite: () => getCurrentSuite,
+  getErrorCode: () => getErrorCode,
+  getErrorDetail: () => getErrorDetail,
+  getEvaluationRun: () => getEvaluationRun,
+  getLeaderboard: () => getLeaderboard,
+  getOwnedAgentVersionStatus: () => getOwnedAgentVersionStatus,
+  getPendingEvaluations: () => getPendingEvaluations,
+  getReaperStats: () => getReaperStats,
+  getRunningEvaluations: () => getRunningEvaluations,
+  getSuiteProblems: () => getSuiteProblems,
+  getTopAgent: () => getTopAgent,
+  getValidators: () => getValidators,
+  hasDetail: () => hasDetail,
+  hasErrorCode: () => hasErrorCode,
+  healthCheck: () => healthCheck,
+  heartbeat: () => heartbeat,
+  invalidateEvaluationRun: () => invalidateEvaluationRun,
+  isTransient: () => isTransient,
+  isTransientError: () => isTransientError,
+  listAgentVersions: () => listAgentVersions,
+  listMinerAgents: () => listMinerAgents,
+  logout: () => logout,
+  parseRetryAfter: () => parseRetryAfter,
+  presignUpload: () => presignUpload,
+  reevaluateAgentVersion: () => reevaluateAgentVersion,
+  reinstateAgentVersion: () => reinstateAgentVersion,
+  requestChallenge: () => requestChallenge,
+  setTopAgent: () => setTopAgent,
+  submitAgent: () => submitAgent,
+  unbanMiner: () => unbanMiner,
+  unbanValidator: () => unbanValidator,
+  updateProgress: () => updateProgress
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/generated/sdk.gen.ts
+var import_client_fetch = require("@hey-api/client-fetch");
+var client = (0, import_client_fetch.createClient)((0, import_client_fetch.createConfig)());
+var healthCheck = (options) => {
+  return (options?.client ?? client).get({
+    ...options,
+    url: "/health"
+  });
+};
+var getCurrentSuite = (options) => {
+  return (options?.client ?? client).get({
+    ...options,
+    url: "/v1/public/suites/current"
+  });
+};
+var getSuiteProblems = (options) => {
+  return (options?.client ?? client).get({
+    ...options,
+    url: "/v1/public/suites/{suite_id}/problems"
+  });
+};
+var getLeaderboard = (options) => {
+  return (options?.client ?? client).get({
+    ...options,
+    url: "/v1/public/leaderboard"
+  });
+};
+var getTopAgent = (options) => {
+  return (options?.client ?? client).get({
+    ...options,
+    url: "/v1/public/top"
+  });
+};
+var getAgentVersionStatus = (options) => {
+  return (options?.client ?? client).get({
+    ...options,
+    url: "/v1/public/agent-versions/{agent_version_id}/status"
+  });
+};
+var getAgentVersionRuns = (options) => {
+  return (options?.client ?? client).get({
+    ...options,
+    url: "/v1/public/agent-versions/{agent_version_id}/runs"
+  });
+};
+var getAgentVersionProblems = (options) => {
+  return (options?.client ?? client).get({
+    ...options,
+    url: "/v1/public/agent-versions/{agent_version_id}/problems"
+  });
+};
+var getAgentVersion = (options) => {
+  return (options?.client ?? client).get({
+    ...options,
+    url: "/v1/public/agent-versions/{agent_version_id}"
+  });
+};
+var getArtifactDownloadUrl = (options) => {
+  return (options?.client ?? client).post({
+    ...options,
+    url: "/v1/public/artifacts/download-url"
+  });
+};
+var getEvaluationRun = (options) => {
+  return (options?.client ?? client).get({
+    ...options,
+    url: "/v1/public/evaluation-runs/{eval_run_id}"
+  });
+};
+var getValidators = (options) => {
+  return (options?.client ?? client).get({
+    ...options,
+    url: "/v1/public/validators"
+  });
+};
+var getRunningEvaluations = (options) => {
+  return (options?.client ?? client).get({
+    ...options,
+    url: "/v1/public/evaluations/running"
+  });
+};
+var getPendingEvaluations = (options) => {
+  return (options?.client ?? client).get({
+    ...options,
+    url: "/v1/public/evaluations/pending"
+  });
+};
+var requestChallenge = (options) => {
+  return (options?.client ?? client).post({
+    ...options,
+    url: "/v1/auth/challenge"
+  });
+};
+var createSessionEndpoint = (options) => {
+  return (options?.client ?? client).post({
+    ...options,
+    url: "/v1/auth/session"
+  });
+};
+var logout = (options) => {
+  return (options?.client ?? client).post({
+    ...options,
+    url: "/v1/auth/logout"
+  });
+};
+var submitAgent = (options) => {
+  return (options?.client ?? client).post({
+    ...options,
+    ...import_client_fetch.formDataBodySerializer,
+    headers: {
+      "Content-Type": null,
+      ...options?.headers
+    },
+    url: "/v1/miner/submit"
+  });
+};
+var listMinerAgents = (options) => {
+  return (options?.client ?? client).get({
+    ...options,
+    url: "/v1/miner/agents"
+  });
+};
+var listAgentVersions = (options) => {
+  return (options?.client ?? client).get({
+    ...options,
+    url: "/v1/miner/agents/{agent_id}/versions"
+  });
+};
+var getOwnedAgentVersionStatus = (options) => {
+  return (options?.client ?? client).get({
+    ...options,
+    url: "/v1/miner/agent-versions/{agent_version_id}"
+  });
+};
+var claimWork = (options) => {
+  return (options?.client ?? client).post({
+    ...options,
+    url: "/v1/validator/work/claim"
+  });
+};
+var heartbeat = (options) => {
+  return (options?.client ?? client).post({
+    ...options,
+    url: "/v1/validator/evaluation-runs/{eval_run_id}/heartbeat"
+  });
+};
+var updateProgress = (options) => {
+  return (options?.client ?? client).post({
+    ...options,
+    url: "/v1/validator/evaluation-runs/{eval_run_id}/progress"
+  });
+};
+var presignUpload = (options) => {
+  return (options?.client ?? client).post({
+    ...options,
+    url: "/v1/validator/uploads/presign"
+  });
+};
+var completeRun = (options) => {
+  return (options?.client ?? client).post({
+    ...options,
+    url: "/v1/validator/evaluation-runs/{eval_run_id}/complete"
+  });
+};
+var banMiner = (options) => {
+  return (options?.client ?? client).post({
+    ...options,
+    url: "/v1/admin/miners/{miner_hotkey}/ban"
+  });
+};
+var unbanMiner = (options) => {
+  return (options?.client ?? client).post({
+    ...options,
+    url: "/v1/admin/miners/{miner_hotkey}/unban"
+  });
+};
+var banValidator = (options) => {
+  return (options?.client ?? client).post({
+    ...options,
+    url: "/v1/admin/validators/{validator_hotkey}/ban"
+  });
+};
+var unbanValidator = (options) => {
+  return (options?.client ?? client).post({
+    ...options,
+    url: "/v1/admin/validators/{validator_hotkey}/unban"
+  });
+};
+var discardAgentVersion = (options) => {
+  return (options?.client ?? client).post({
+    ...options,
+    url: "/v1/admin/agent-versions/{agent_version_id}/discard"
+  });
+};
+var reinstateAgentVersion = (options) => {
+  return (options?.client ?? client).post({
+    ...options,
+    url: "/v1/admin/agent-versions/{agent_version_id}/reinstate"
+  });
+};
+var setTopAgent = (options) => {
+  return (options?.client ?? client).post({
+    ...options,
+    url: "/v1/admin/agent-versions/{agent_version_id}/set-top"
+  });
+};
+var invalidateEvaluationRun = (options) => {
+  return (options?.client ?? client).post({
+    ...options,
+    url: "/v1/admin/evaluation-runs/{eval_run_id}/invalidate"
+  });
+};
+var reevaluateAgentVersion = (options) => {
+  return (options?.client ?? client).post({
+    ...options,
+    url: "/v1/admin/agent-versions/{agent_version_id}/reevaluate"
+  });
+};
+var cancelAgentVersion = (options) => {
+  return (options?.client ?? client).post({
+    ...options,
+    url: "/v1/admin/agent-versions/{agent_version_id}/cancel"
+  });
+};
+var createSuite = (options) => {
+  return (options?.client ?? client).post({
+    ...options,
+    url: "/v1/admin/suites"
+  });
+};
+var activateSuite = (options) => {
+  return (options?.client ?? client).post({
+    ...options,
+    url: "/v1/admin/suites/{suite_id}/activate"
+  });
+};
+var getAuditEvents = (options) => {
+  return (options?.client ?? client).get({
+    ...options,
+    url: "/v1/admin/audit-events"
+  });
+};
+var getReaperStats = (options) => {
+  return (options?.client ?? client).get({
+    ...options,
+    url: "/v1/admin/reaper/stats"
+  });
+};
+
+// src/errors.ts
+function classifyStatus(status) {
+  if (status === void 0 || status === 0) return "NETWORK";
+  if (status === 401 || status === 403) return "AUTH";
+  if (status === 404) return "NOT_FOUND";
+  if (status === 409) return "CONFLICT";
+  if (status === 422) return "VALIDATION";
+  if (status === 429) return "RATE_LIMITED";
+  if (status >= 500 && status < 600) return "SERVER";
+  if (status >= 400 && status < 500) return "VALIDATION";
+  return "UNKNOWN";
+}
+function classifyError(response) {
+  if (!response) return "NETWORK";
+  return classifyStatus(response.status);
+}
+function isTransient(status) {
+  if (status === void 0 || status === 0) return true;
+  if (status === 429) return true;
+  if (status >= 500 && status < 600) return true;
+  return false;
+}
+function isTransientError(response) {
+  if (!response) return true;
+  return isTransient(response.status);
+}
+function getErrorDetail(error) {
+  if (error == null || typeof error !== "object") return void 0;
+  const detail = error.detail;
+  if (typeof detail === "string") return detail;
+  return void 0;
+}
+function getErrorCode(error) {
+  if (error == null || typeof error !== "object") return void 0;
+  const code = error.error_code;
+  if (typeof code === "string") return code;
+  return void 0;
+}
+function hasErrorCode(error, code) {
+  return getErrorCode(error) === code;
+}
+function hasDetail(error) {
+  return getErrorDetail(error) !== void 0;
+}
+
+// src/retry.ts
+var DEFAULT_RETRYABLE_STATUSES = [429, 502, 503, 504];
+var DEFAULT_MAX_RETRIES = 3;
+var DEFAULT_BASE_DELAY_MS = 1e3;
+var DEFAULT_MAX_DELAY_MS = 3e4;
+function parseRetryAfter(response) {
+  const header = response.headers.get("retry-after");
+  if (!header) {
+    return void 0;
+  }
+  const seconds = Number(header);
+  if (!Number.isNaN(seconds) && seconds >= 0) {
+    return seconds * 1e3;
+  }
+  const date = Date.parse(header);
+  if (!Number.isNaN(date)) {
+    const delayMs = date - Date.now();
+    return delayMs > 0 ? delayMs : 0;
+  }
+  return void 0;
+}
+function computeDelay(attempt, baseDelayMs, maxDelayMs, jitter, retryAfter) {
+  if (retryAfter !== void 0) {
+    return Math.min(retryAfter, maxDelayMs);
+  }
+  const exponential = baseDelayMs * Math.pow(2, attempt);
+  const capped = Math.min(exponential, maxDelayMs);
+  if (jitter) {
+    return Math.floor(Math.random() * capped);
+  }
+  return capped;
+}
+function createRetryFetch(config) {
+  const maxRetries = config.maxRetries ?? DEFAULT_MAX_RETRIES;
+  const retryableStatuses = config.retryableStatuses ?? DEFAULT_RETRYABLE_STATUSES;
+  const baseDelayMs = config.baseDelayMs ?? DEFAULT_BASE_DELAY_MS;
+  const maxDelayMs = config.maxDelayMs ?? DEFAULT_MAX_DELAY_MS;
+  const jitter = config.jitter ?? true;
+  const onRetry = config.onRetry;
+  return async (input, init) => {
+    let lastError;
+    let lastResponse;
+    for (let attempt = 0; attempt <= maxRetries; attempt++) {
+      try {
+        let fetchInput = input;
+        let fetchInit = init;
+        if (input instanceof Request) {
+          fetchInput = input.clone();
+          fetchInit = void 0;
+        }
+        const response = await globalThis.fetch(fetchInput, fetchInit);
+        if (attempt < maxRetries && retryableStatuses.includes(response.status)) {
+          lastResponse = response;
+          const retryAfter = parseRetryAfter(response);
+          const delayMs = computeDelay(
+            attempt,
+            baseDelayMs,
+            maxDelayMs,
+            jitter,
+            retryAfter
+          );
+          onRetry?.({
+            attempt: attempt + 1,
+            delayMs,
+            status: response.status,
+            retryAfter
+          });
+          await sleep(delayMs);
+          continue;
+        }
+        return response;
+      } catch (error) {
+        lastError = error;
+        if (attempt < maxRetries) {
+          const delayMs = computeDelay(
+            attempt,
+            baseDelayMs,
+            maxDelayMs,
+            jitter
+          );
+          onRetry?.({
+            attempt: attempt + 1,
+            delayMs
+          });
+          await sleep(delayMs);
+          continue;
+        }
+      }
+    }
+    if (lastResponse) {
+      return lastResponse;
+    }
+    throw lastError;
+  };
+}
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+
+// src/auth.ts
+function isPublicEndpoint(url) {
+  if (!url) {
+    return false;
+  }
+  let pathname;
+  try {
+    const parsed = new URL(url, "http://placeholder");
+    pathname = parsed.pathname;
+  } catch {
+    pathname = url;
+  }
+  return pathname.includes("/v1/public/") || pathname.includes("/v1/auth/") || pathname === "/health" || pathname.endsWith("/health");
+}
+async function generateAuthHeaders(config, nonce) {
+  const cryptoModule = typeof globalThis.crypto !== "undefined" ? globalThis.crypto : await import("crypto");
+  const actualNonce = nonce ?? cryptoModule.randomUUID();
+  const timestamp = Math.floor(Date.now() / 1e3).toString();
+  const message = `${config.hotkey}:${timestamp}:${actualNonce}`;
+  const signature = await config.sign(message);
+  return {
+    "X-Hotkey": config.hotkey,
+    "X-Signature": signature.startsWith("0x") ? signature : `0x${signature}`,
+    "X-Nonce": actualNonce,
+    "X-Timestamp": timestamp
+  };
+}
+function configureBittensorAuth(baseUrl, authConfig, retryConfig) {
+  client.setConfig({
+    baseUrl,
+    fetch: createRetryFetch(retryConfig ?? {})
+  });
+  client.interceptors.request.use(async (request) => {
+    if (isPublicEndpoint(request.url)) {
+      return request;
+    }
+    const headers = await generateAuthHeaders(authConfig);
+    Object.entries(headers).forEach(([key, value]) => {
+      request.headers.set(key, value);
+    });
+    return request;
+  });
+  return client;
+}
+function configurePublicClient(baseUrl, retryConfig) {
+  client.setConfig({
+    baseUrl,
+    fetch: createRetryFetch(retryConfig ?? {})
+  });
+  return client;
+}
+
+// src/session-auth.ts
+var SessionAuthManager = class {
+  token = null;
+  expiresAt = 0;
+  role = "";
+  refreshPromise = null;
+  hotkey;
+  sign;
+  refreshBufferSeconds;
+  onSessionExpired;
+  constructor(config) {
+    this.hotkey = config.hotkey;
+    this.sign = config.sign;
+    this.refreshBufferSeconds = config.refreshBufferSeconds ?? 300;
+    this.onSessionExpired = config.onSessionExpired;
+  }
+  /**
+   * 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
+   */
+  async login() {
+    const { data: challengeData, error: challengeError } = await requestChallenge({
+      body: { hotkey: this.hotkey }
+    });
+    if (challengeError || !challengeData) {
+      throw new Error(
+        `Failed to request challenge: ${challengeError ? JSON.stringify(challengeError) : "no data returned"}`
+      );
+    }
+    const signature = await this.sign(challengeData.challenge);
+    const { data: sessionData, error: sessionError } = await createSessionEndpoint({
+      body: {
+        hotkey: this.hotkey,
+        challenge: challengeData.challenge,
+        signature
+      }
+    });
+    if (sessionError || !sessionData) {
+      throw new Error(
+        `Failed to create session: ${sessionError ? JSON.stringify(sessionError) : "no data returned"}`
+      );
+    }
+    this.token = sessionData.session_token;
+    this.expiresAt = sessionData.expires_at;
+    this.role = sessionData.role;
+    return sessionData;
+  }
+  /**
+   * Logout and invalidate the current session.
+   * Silently catches errors (session may already be expired).
+   */
+  async logout() {
+    if (this.token) {
+      try {
+        await logout({
+          headers: { authorization: `Bearer ${this.token}` }
+        });
+      } catch {
+      }
+    }
+    this.clearSession();
+  }
+  /**
+   * Refresh the session by performing a new login flow.
+   */
+  async refreshSession() {
+    return this.login();
+  }
+  /** Returns true if a session token exists and hasn't expired. */
+  hasActiveSession() {
+    return this.token !== null && Date.now() / 1e3 < this.expiresAt;
+  }
+  /** Returns true if the session is within the refresh buffer of expiry. */
+  sessionNeedsRefresh() {
+    if (!this.token) return false;
+    const now = Date.now() / 1e3;
+    return now >= this.expiresAt - this.refreshBufferSeconds && now < this.expiresAt;
+  }
+  /** Returns current session info, or null if no active session. */
+  getSessionInfo() {
+    if (!this.token) return null;
+    return {
+      hotkey: this.hotkey,
+      role: this.role,
+      expiresAt: this.expiresAt
+    };
+  }
+  /**
+   * Returns authorization headers. Auto-refreshes if the session is
+   * within the refresh buffer. Throws if not authenticated or session expired.
+   */
+  async getAuthHeaders() {
+    if (!this.token) {
+      this.onSessionExpired?.();
+      throw new Error("No active session");
+    }
+    const now = Date.now() / 1e3;
+    if (now >= this.expiresAt) {
+      this.clearSession();
+      this.onSessionExpired?.();
+      throw new Error("Session expired");
+    }
+    if (this.sessionNeedsRefresh()) {
+      if (!this.refreshPromise) {
+        this.refreshPromise = this.refreshSession().catch(() => {
+          return null;
+        }).finally(() => {
+          this.refreshPromise = null;
+        });
+      }
+      await this.refreshPromise;
+    }
+    return { Authorization: `Bearer ${this.token}` };
+  }
+  clearSession() {
+    this.token = null;
+    this.expiresAt = 0;
+    this.role = "";
+    this.refreshPromise = null;
+  }
+};
+function configureSessionAuth(baseUrl, config) {
+  const manager = new SessionAuthManager(config);
+  client.setConfig({ baseUrl });
+  client.interceptors.request.use(async (request) => {
+    if (isPublicEndpoint(request.url)) {
+      return request;
+    }
+    const headers = await manager.getAuthHeaders();
+    Object.entries(headers).forEach(([key, value]) => {
+      request.headers.set(key, value);
+    });
+    return request;
+  });
+  return manager;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  SessionAuthManager,
+  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
+});