runbios-sdk 0.2.19-dev.278 → 0.2.19-dev.281

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.19-dev.278";
+export declare const VERSION = "0.2.19-dev.281";
 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.19-dev.278';
+export const VERSION = '0.2.19-dev.281';
 export class RunBiOS {
     /** Search models, fetch configs, check adapter compatibility. */
     models;

package/dist/resources/loop.d.ts

@@ -402,7 +402,9 @@ export declare class Loop {
      * numbers `minimums` shows. 503 `AGENT_COULD_NOT_START` means the key the
      * attempt would be scored with could not be renewed just then: nothing was
      * started, so press train now again in a minute. Every refusal is a
-     * `TrainingRuleRunRefusalCode`.
+     * `TrainingRuleRunRefusalCode`. When the attempt in flight is waiting for
+     * GPUs to compare (`active_run.state` `waiting_gpus`), this books its two
+     * comparison machines again at once instead of starting another attempt.
      */
     runPipeline(id: string): Promise<PipelineMutationResponse>;
     /**

package/dist/resources/loop.js

@@ -555,7 +555,9 @@ export class Loop {
      * numbers `minimums` shows. 503 `AGENT_COULD_NOT_START` means the key the
      * attempt would be scored with could not be renewed just then: nothing was
      * started, so press train now again in a minute. Every refusal is a
-     * `TrainingRuleRunRefusalCode`.
+     * `TrainingRuleRunRefusalCode`. When the attempt in flight is waiting for
+     * GPUs to compare (`active_run.state` `waiting_gpus`), this books its two
+     * comparison machines again at once instead of starting another attempt.
      */
     async runPipeline(id) {
         return this._http.fetchPost(`/api/loop/pipelines/${encodeURIComponent(id)}/run`, {});

package/dist/types.d.ts

@@ -2866,7 +2866,18 @@ export interface TrainingRecipe {
     lora_rank: number | null;
     lora_alpha: number | null;
 }
-export type TrainingRunState = 'built' | 'registering' | 'dataset_validating' | 'preflighting' | 'job_creating' | 'training' | 'checkpoint_ready' | 'candidate_booking' | 'candidate_running' | 'evaluating' | 'reported' | 'awaiting_review' | 'promoting' | 'waiting_funds' | 'promoted' | 'rejected' | 'expired' | 'failed' | 'budget_stopped' | 'cancelled' | 'superseded' | 'rolled_back';
+export type TrainingRunState = 'built' | 'registering' | 'dataset_validating' | 'preflighting' | 'job_creating' | 'training' | 'checkpoint_ready' | 'candidate_booking' | 'candidate_running' | 'evaluating' | 'reported' | 'awaiting_review' | 'promoting' | 'waiting_funds'
+/**
+ * Trained, and waiting for GPUs to run the new model and the one it is
+ * compared with side by side: one machine got a GPU and the other did not
+ * within 20 minutes, so both were stopped. Each try can bill the machine
+ * that got a GPU for up to those 20 minutes; nothing bills between tries.
+ * It keeps what it trained, books both again after 30 minutes, then 1, 2
+ * and 4 hours, and ends (`failed`, `COMPARISON_NO_GPUS`) after four tries or
+ * 24 hours (`COMPARISON_WORKSPACE_FULL` when what was missing was room in
+ * the workspace). Train now books them again at once.
+ */
+ | 'waiting_gpus' | 'promoted' | 'rejected' | 'expired' | 'failed' | 'budget_stopped' | 'cancelled' | 'superseded' | 'rolled_back';
 /** The closed set a run never leaves. */
 export declare const TERMINAL_RUN_STATES: readonly TrainingRunState[];
 export type TrainingVerdict = 'better' | 'not_better' | 'inconclusive' | 'not_evaluated';
@@ -2957,7 +2968,19 @@ export interface TrainingRun {
      */
     error_next_step: string | null;
     billed_training_cents: number;
+    /**
+     * The comparison machines: each from the first time it was on a GPU to its
+     * stop, less any time back in the GPU queue, at the price the platform
+     * placed it at.
+     */
     billed_candidate_cents: number;
+    /**
+     * True when a comparison machine was charged: the figure is then the most
+     * it can have cost ("up to"), since it counts each machine from its first
+     * boot where the platform bills from its first answer (and at the hourly
+     * cap when no placement price was reported).
+     */
+    billed_candidate_up_to: boolean;
     spent_eval_cents: number;
     train_rows: number | null;
     holdout_rows: number | null;
@@ -3049,6 +3072,8 @@ export interface TrainingRunSummary {
     holdout_rows: number | null;
     billed_training_cents: number;
     billed_candidate_cents: number;
+    /** See {@link TrainingRun.billed_candidate_up_to}. */
+    billed_candidate_up_to: boolean;
     spent_eval_cents: number;
     /** The fourth money column. A row that leaves it out adds up short. */
     benchmark_spent_cents: number;
@@ -3574,6 +3599,11 @@ export interface PipelineActiveRun {
     gpu_seconds: number | null;
     /** What it has been billed so far, in cents. */
     cost_cents: number;
+    /**
+     * True when a comparison machine was charged in `cost_cents`: the figure is
+     * the most it can have cost, so show it as "up to".
+     */
+    cost_up_to: boolean;
     /** The version number it will take if it is put live. */
     will_be_version: number;
     /** Always null: nothing in flight is a version yet. */
@@ -3646,6 +3676,14 @@ export interface PipelineVersion {
      * not what it did.
      */
     cost_includes_candidate_ceiling: boolean;
+    /**
+     * True when `cost_cents` is the most the version can have cost rather than
+     * what it did: its comparison machines at their ceilings
+     * (`cost_includes_candidate_ceiling`), or one charged (counted from its
+     * first boot, where the platform bills from its first answer). Show it as
+     * "up to".
+     */
+    cost_up_to: boolean;
     /** Machine time the attempt held (training and comparison); null when unknown. */
     gpu_seconds: number | null;
     created_at: string;
@@ -3694,6 +3732,8 @@ export interface PipelineAttempt {
     gpu_seconds: number | null;
     /** As the versions are priced once it has ended; as recorded so far while it runs. */
     cost_cents: number;
+    /** See {@link PipelineVersion.cost_up_to}. */
+    cost_up_to: boolean;
     verdict: TrainingVerdict | null;
     win_rate: number | null;
     evaluation_id: string | null;

package/package.json

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