runbios-sdk 0.2.6-rc.201 → 0.2.7-dev.202

package/README.md

@@ -320,8 +320,14 @@ const job = await client.training.create(request);
 const jobs = await client.training.list({ status: 'running' });
 const page = await client.training.listPage({ limit: 50, offset: 0 });
 
-// Get metrics
-const metrics = await client.training.getMetrics('job_abc123');
+// Get a compact, model-readable report (metric averages/ranges/best steps and GPU averages/peaks)
+const report = await client.training.getMetrics('job_abc123', { view: 'summary' });
+for (const metric of report.metric_summaries ?? []) {
+  console.log(metric.label, metric.latest, metric.average, metric.best);
+}
+
+// Request a bounded curve only when you need its shape
+const metrics = await client.training.getMetrics('job_abc123', { view: 'series', maxPoints: 200 });
 for (const point of metrics.metrics) console.log(point.step, point.loss);
 
 // Get checkpoints

package/dist/client.js

@@ -340,7 +340,7 @@ export class HttpClient {
     constructor(config) {
         // Default host stays api.runbios.ai for now; cutover to api.runbios.ai is
         // planned once its DNS exists.
-        this.baseUrl = (config.baseUrl || envBaseUrl() || 'https://api-staging.runbios.ai').replace(/\/+$/, '');
+        this.baseUrl = (config.baseUrl || envBaseUrl() || 'https://api-dev.runbios.ai').replace(/\/+$/, '');
         this.apiKey = config.apiKey ?? envApiKey();
         this.accessToken = config.accessToken;
         this.orgId = config.orgId;

package/dist/index.d.ts

@@ -36,7 +36,7 @@ import { Loop } from './resources/loop.js';
  * SDK version. Sent as part of the User-Agent header.
  * Must match package.json "version" -- enforced by a contract test.
  */
-export declare const VERSION = "0.2.6-rc.201";
+export declare const VERSION = "0.2.7-dev.202";
 export declare class RunBiOS {
     /** Search models, fetch configs, check adapter compatibility. */
     readonly models: Models;

package/dist/index.js

@@ -36,7 +36,7 @@ import { Loop } from './resources/loop.js';
  * SDK version. Sent as part of the User-Agent header.
  * Must match package.json "version" -- enforced by a contract test.
  */
-export const VERSION = '0.2.6-rc.201';
+export const VERSION = '0.2.7-dev.202';
 export class RunBiOS {
     /** Search models, fetch configs, check adapter compatibility. */
     models;

package/dist/resources/inference.js

@@ -326,7 +326,7 @@ export class Inference {
         this.key = config.inferenceKey || envInferenceKey() || envApiKey();
         // Same default host as HttpClient (api.runbios.ai); api.runbios.ai cutover
         // is planned once its DNS exists — update both call sites together.
-        this.baseUrl = (config.baseUrl || envBaseUrl() || 'https://api-staging.runbios.ai').replace(/\/+$/, '');
+        this.baseUrl = (config.baseUrl || envBaseUrl() || 'https://api-dev.runbios.ai').replace(/\/+$/, '');
         this.timeout = config.timeout ?? 900_000;
         this._http = http;
     }

package/dist/resources/training.d.ts

@@ -1,5 +1,5 @@
 import type { HttpClient } from '../client.js';
-import type { TrainingCreateParams, TrainingListParams, TrainingJob, TrainingListResponse, TrainingMetrics, TrainingCheckpoint, TrainingLogs, TrainingStopResponse, TrainingResumeResponse, TrainingPreflightResponse, TrainingRecommendParams, TrainingAdvisorVerdict, TrainingCapabilities } from '../types.js';
+import type { TrainingCreateParams, TrainingListParams, TrainingJob, TrainingListResponse, TrainingMetrics, TrainingMetricsOptions, TrainingCheckpoint, TrainingLogs, TrainingStopResponse, TrainingResumeResponse, TrainingPreflightResponse, TrainingRecommendParams, TrainingAdvisorVerdict, TrainingCapabilities } from '../types.js';
 /**
  * Create, monitor, and manage fine-tuning training jobs.
  */
@@ -93,15 +93,17 @@ export declare class Training {
      * Get training metrics (loss curves, learning rate, throughput) for a job.
      *
      * @param id - Training job ID.
+     * @param options - Choose semantic summaries, a bounded series, or the backward-compatible full rows.
      *
      * @example
      * ```ts
-     * const metrics = await client.training.getMetrics('job_abc123');
-     * console.log(`Current loss: ${metrics.metrics.at(-1)?.loss}`);
-     * console.log(`${metrics.metrics.length} metric points`);
+     * const report = await client.training.getMetrics('job_abc123', { view: 'summary' });
+     * console.log(report.metric_summaries?.find(metric => metric.key === 'loss'));
+     * const curve = await client.training.getMetrics('job_abc123', { view: 'series', maxPoints: 200 });
+     * console.log(`${curve.metrics.length} bounded metric points`);
      * ```
      */
-    getMetrics(id: string): Promise<TrainingMetrics>;
+    getMetrics(id: string, options?: TrainingMetricsOptions): Promise<TrainingMetrics>;
     /**
      * List checkpoints saved during training.
      *

package/dist/resources/training.js

@@ -343,20 +343,38 @@ export class Training {
      * Get training metrics (loss curves, learning rate, throughput) for a job.
      *
      * @param id - Training job ID.
+     * @param options - Choose semantic summaries, a bounded series, or the backward-compatible full rows.
      *
      * @example
      * ```ts
-     * const metrics = await client.training.getMetrics('job_abc123');
-     * console.log(`Current loss: ${metrics.metrics.at(-1)?.loss}`);
-     * console.log(`${metrics.metrics.length} metric points`);
+     * const report = await client.training.getMetrics('job_abc123', { view: 'summary' });
+     * console.log(report.metric_summaries?.find(metric => metric.key === 'loss'));
+     * const curve = await client.training.getMetrics('job_abc123', { view: 'series', maxPoints: 200 });
+     * console.log(`${curve.metrics.length} bounded metric points`);
      * ```
      */
-    async getMetrics(id) {
-        const result = await this._http.fetchGet(`/api/training/jobs/${encodeURIComponent(id)}/metrics`);
+    async getMetrics(id, options = {}) {
+        if (options.maxPoints !== undefined && (!Number.isInteger(options.maxPoints) || options.maxPoints < 1 || options.maxPoints > 1000)) {
+            throw new Error('RunBiOS: maxPoints must be an integer between 1 and 1000');
+        }
+        const query = new URLSearchParams();
+        if (options.view)
+            query.set('view', options.view);
+        if (options.maxPoints !== undefined)
+            query.set('max_points', String(options.maxPoints));
+        const encodedQuery = query.toString();
+        const suffix = encodedQuery ? `?${encodedQuery}` : '';
+        const result = await this._http.fetchGet(`/api/training/jobs/${encodeURIComponent(id)}/metrics${suffix}`);
         const metrics = Array.isArray(result.metrics)
             ? result.metrics
             : Array.isArray(result.steps) ? result.steps : [];
-        return { ...result, metrics, graph_configs: result.graph_configs || [], steps: metrics };
+        return {
+            ...result,
+            metrics,
+            graph_configs: result.graph_configs || [],
+            metric_summaries: result.metric_summaries || [],
+            steps: metrics,
+        };
     }
     /**
      * List checkpoints saved during training.

package/dist/types.d.ts

@@ -8,13 +8,13 @@ export interface BiOSConfig {
     orgId?: string;
     /** Workspace ID. Optional when using API keys (resolved from the key). Can override for multi-workspace keys. */
     workspaceId?: string;
-    /** Base URL for the API. Falls back to the RUNBIOS_BASE_URL environment variable (legacy: BIOS_BASE_URL), then the canonical https://api-staging.runbios.ai hostname. */
+    /** Base URL for the API. Falls back to the RUNBIOS_BASE_URL environment variable (legacy: BIOS_BASE_URL), then the canonical https://api-dev.runbios.ai hostname. */
     baseUrl?: string;
     /** Request timeout in milliseconds. Defaults to 30000. */
     timeout?: number;
     /** Default per-deployment inference key. Can be overridden per inference call. */
     inferenceKey?: string;
-    /** Inference base URL. Defaults to baseUrl, then https://api-staging.runbios.ai. */
+    /** Inference base URL. Defaults to baseUrl, then https://api-dev.runbios.ai. */
     inferenceBaseUrl?: string;
     /** End-to-end inference timeout in milliseconds. Defaults to 15 minutes. */
     inferenceTimeout?: number;
@@ -837,13 +837,93 @@ export interface TrainingResourceMetrics {
     disk_total_gib: number | null;
     gpus: TrainingDeviceMetrics[];
 }
+export interface TrainingResourceValueSummary {
+    average: number;
+    peak: number;
+    samples: number;
+}
+export interface TrainingDeviceResourceSummary {
+    memory_used_mib: TrainingResourceValueSummary | null;
+    memory_total_mib: number | null;
+    utilization_pct: TrainingResourceValueSummary | null;
+    temperature_c: TrainingResourceValueSummary | null;
+}
+export interface TrainingResourceSummary {
+    scope: 'attempt';
+    aggregation: 'sample_mean';
+    sample_count: number;
+    first_sampled_at: string | null;
+    last_sampled_at: string | null;
+    gpu_count: number | null;
+    gpu_memory_used_mib: TrainingResourceValueSummary | null;
+    gpu_memory_total_mib: number | null;
+    gpu_utilization_pct: TrainingResourceValueSummary | null;
+    gpu_temperature_c: TrainingResourceValueSummary | null;
+    host_ram_used_gib: TrainingResourceValueSummary | null;
+    host_ram_limit_gib: number | null;
+    host_ram_pct: TrainingResourceValueSummary | null;
+    host_cpu_usage_pct: TrainingResourceValueSummary | null;
+    host_cpu_limit_cores: number | null;
+    disk_used_gib: TrainingResourceValueSummary | null;
+    disk_total_gib: number | null;
+    gpus: TrainingDeviceResourceSummary[];
+}
+export interface TrainingMetricSummary {
+    key: string;
+    label: string;
+    unit: string;
+    goal: 'minimize' | 'maximize' | 'schedule' | 'progress' | 'observe' | string;
+    points: number;
+    first: number;
+    latest: number;
+    minimum: number;
+    maximum: number;
+    average: number;
+    change: number;
+    change_percent?: number;
+    first_step: number;
+    last_step: number;
+    best?: number;
+    best_step?: number;
+}
+export interface TrainingSeriesMeta {
+    view: 'full' | 'series' | 'summary';
+    x_axis: 'step';
+    included: boolean;
+    total_points: number;
+    returned_points: number;
+    downsampled: boolean;
+    sampling: 'none' | 'uniform';
+}
+export interface TrainingMetricsOptions {
+    view?: 'full' | 'series' | 'summary';
+    maxPoints?: number;
+}
+export interface TrainingMetricsRunContext {
+    status: string;
+    training_method?: string | null;
+    rlhf_type?: string | null;
+    train_type: string;
+    model_id: string;
+    model_revision: string;
+    current_step: number;
+    total_steps: number;
+    gpu_type: string;
+    gpu_count: number;
+    parameters: Record<string, unknown>;
+    omitted_parameter_keys: string[];
+}
 /** Training metrics for a job. */
 export interface TrainingMetrics {
     metrics: MetricPoint[];
     training_method?: string | null;
     rlhf_type?: string | null;
     graph_configs: MetricGraphConfig[];
+    metric_summaries?: TrainingMetricSummary[];
     resource_metrics?: TrainingResourceMetrics | null;
+    resource_summary?: TrainingResourceSummary | null;
+    series_meta?: TrainingSeriesMeta;
+    run_context?: TrainingMetricsRunContext;
     /** @deprecated Use metrics. Populated as a compatibility alias. */
     steps?: MetricPoint[];
 }
@@ -867,6 +947,8 @@ export interface MetricGraphConfig {
     key: string;
     label: string;
     color: string;
+    unit?: string;
+    goal?: string;
 }
 /** A training checkpoint. */
 export interface TrainingCheckpoint {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "runbios-sdk",
-  "version": "0.2.6-rc.201",
+  "version": "0.2.7-dev.202",
   "description": "Official TypeScript SDK for the Run BiOS training and deployment platform API",
   "type": "module",
   "main": "./dist/index.js",