bios-sdk 0.1.1-dev.16 → 0.1.1-dev.17

package/dist/resources/training.d.ts

@@ -10,11 +10,26 @@ export declare class Training {
     /** Return the authoritative BIOS image, method, adapter, and hyperparameter contract. */
     capabilities(): Promise<TrainingCapabilities>;
     /**
-     * Create a new training job.
-     *
-     * Provisions GPU resources, downloads the model and dataset, and begins
-     * training. The job starts in "pending" status and progresses through
-     * provisioning, downloading, and running states.
+     * Create a new training job (book-before-reveal).
+     *
+     * The call blocks while the ranked GPU ladder is booked (~40s typical). A
+     * training id and the "training started" email exist only once a real pod is
+     * secured, so the returned `status` is one of:
+     *
+     * - `"booked"` — a GPU was secured (booked == secured); the job then
+     *   progresses through provisioning, downloading, and running on its own.
+     * - `"securing"` — still booking at the deadline; the async tail continues.
+     *   Poll {@link get} until it reaches `booked`/`running` (or terminal).
+     *   Nothing is charged until a pod is real.
+     * - `"queued"` — returned only with explicit queue consent
+     *   (`queueIfUnavailable: true`); waits for stock at zero charge and books
+     *   via the same path.
+     *
+     * If the ladder is exhausted at booking time without queue consent, this
+     * rejects with a `CAPACITY_UNAVAILABLE` (HTTP 409) carrying neutral
+     * alternatives — no phantom job remains and nothing is billed. The SDK never
+     * auto-substitutes a GPU; a transient 503 is a retry, never a capacity
+     * verdict.
      *
      * @example
      * ```ts
@@ -120,7 +135,12 @@ export declare class Training {
      */
     stop(id: string, keepData?: boolean): Promise<TrainingStopResponse>;
     /**
-     * Resume a stopped training job from its last checkpoint.
+     * Resume a stopped or `interrupted` training job from its last checkpoint.
+     *
+     * Use this on a `stopped` job, or one resting at `interrupted` — the
+     * self-heal state a started job enters when its pod is lost and billing has
+     * already been stopped (distinct from `failed`). Resume re-books on secured
+     * capacity before reporting resumed, so book-before-reveal still applies.
      *
      * @param id - Training job ID.
      *

package/dist/resources/training.js

@@ -191,11 +191,26 @@ export class Training {
         return this._http.fetchGet('/api/training/capabilities');
     }
     /**
-     * Create a new training job.
+     * Create a new training job (book-before-reveal).
      *
-     * Provisions GPU resources, downloads the model and dataset, and begins
-     * training. The job starts in "pending" status and progresses through
-     * provisioning, downloading, and running states.
+     * The call blocks while the ranked GPU ladder is booked (~40s typical). A
+     * training id and the "training started" email exist only once a real pod is
+     * secured, so the returned `status` is one of:
+     *
+     * - `"booked"` — a GPU was secured (booked == secured); the job then
+     *   progresses through provisioning, downloading, and running on its own.
+     * - `"securing"` — still booking at the deadline; the async tail continues.
+     *   Poll {@link get} until it reaches `booked`/`running` (or terminal).
+     *   Nothing is charged until a pod is real.
+     * - `"queued"` — returned only with explicit queue consent
+     *   (`queueIfUnavailable: true`); waits for stock at zero charge and books
+     *   via the same path.
+     *
+     * If the ladder is exhausted at booking time without queue consent, this
+     * rejects with a `CAPACITY_UNAVAILABLE` (HTTP 409) carrying neutral
+     * alternatives — no phantom job remains and nothing is billed. The SDK never
+     * auto-substitutes a GPU; a transient 503 is a retry, never a capacity
+     * verdict.
      *
      * @example
      * ```ts
@@ -363,7 +378,12 @@ export class Training {
         return this._http.fetchPost(`/api/training/jobs/${encodeURIComponent(id)}/stop`, { keep_data: keepData });
     }
     /**
-     * Resume a stopped training job from its last checkpoint.
+     * Resume a stopped or `interrupted` training job from its last checkpoint.
+     *
+     * Use this on a `stopped` job, or one resting at `interrupted` — the
+     * self-heal state a started job enters when its pod is lost and billing has
+     * already been stopped (distinct from `failed`). Resume re-books on secured
+     * capacity before reporting resumed, so book-before-reveal still applies.
      *
      * @param id - Training job ID.
      *

package/dist/types.d.ts

@@ -389,9 +389,9 @@ export type RLHFAlgorithm = 'dpo' | 'simpo' | 'cpo' | 'orpo' | 'kto' | 'rm';
 /** Supported adapter types. */
 export type AdapterType = 'lora' | 'qlora' | 'adalora' | 'full' | 'loha' | 'lokr' | 'boft' | 'oft' | 'vera' | 'fourierft' | 'bone' | 'adapter' | 'reft' | 'llamapro' | 'longlora';
 /** Training job status values. */
-export type TrainingJobStatus = 'pending' | 'queued' | 'provisioning' | 'preparing' | 'starting' | 'downloading' | 'running' | 'completed' | 'failed' | 'saving' | 'stopped' | 'stopping' | 'resuming' | 'cancelled';
+export type TrainingJobStatus = 'pending' | 'queued' | 'securing' | 'booked' | 'provisioning' | 'preparing' | 'starting' | 'downloading' | 'running' | 'completed' | 'failed' | 'interrupted' | 'saving' | 'stopped' | 'stopping' | 'resuming' | 'cancelled';
 /** Status values accepted by GET /api/training/jobs?status=. */
-export type TrainingStatusFilter = 'pending' | 'queued' | 'provisioning' | 'preparing' | 'starting' | 'running' | 'saving' | 'completed' | 'failed' | 'stopped';
+export type TrainingStatusFilter = 'pending' | 'queued' | 'securing' | 'booked' | 'provisioning' | 'preparing' | 'starting' | 'running' | 'interrupted' | 'saving' | 'completed' | 'failed' | 'stopped';
 /** One ranked GPU fallback choice. The first choice is the primary. */
 export interface GPUChoice {
     gpuType: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bios-sdk",
-  "version": "0.1.1-dev.16",
+  "version": "0.1.1-dev.17",
   "description": "Official TypeScript SDK for the BIOS training and deployment platform API",
   "type": "module",
   "main": "./dist/index.js",