runbios-sdk 0.3.0-dev.323 → 0.3.0-dev.326

package/dist/client.d.ts

@@ -130,17 +130,25 @@ export type CapacityUnavailableError = GpuRejectionError;
  * (HTTP 403): TRAINING_COMING_SOON from POST /api/training/jobs,
  * DATASETS_COMING_SOON from the dataset creation endpoints (upload,
  * uploads/initiate, register-hf, integration import), and LOOP_COMING_SOON
- * from EVERY Conscious Loop route (`client.loop.*`) where the loop is not
- * offered — it is offered on the development environment only.
+ * from the Conscious Loop routes (`client.loop.*`) where the platform has the
+ * loop switched off — every one of them but the five that let a member stop
+ * paying (see {@link ComingSoonError}).
  */
 export declare const COMING_SOON_CODES: readonly ["TRAINING_COMING_SOON", "DATASETS_COMING_SOON", "LOOP_COMING_SOON"];
 /**
  * Raised when a pre-launch surface rejects a call: fine-tuning and datasets
  * launch soon, so training.create and dataset upload/import/register answer 403
  * with one of {@link COMING_SOON_CODES}, and their read and lifecycle methods
- * (list, get, status, stop, resume, delete, preview) are unaffected. The
- * Conscious Loop is offered on the development environment only; everywhere
- * else EVERY `client.loop.*` method, reads included, answers LOOP_COMING_SOON.
+ * (list, get, status, stop, resume, delete, preview) are unaffected. Where
+ * the platform has the Conscious Loop switched off, every `client.loop.*`
+ * method answers LOOP_COMING_SOON, reads included, except the five a member
+ * needs to stop paying, which answer as usual: listing pipelines
+ * (GET /api/loop/pipelines), reading one (GET /api/loop/pipelines/{id}),
+ * switching one off (PUT /api/loop/pipelines/{id} whose body is only
+ * `{"enabled": false}`, with at most `expected_revision` and `workspace_id`),
+ * deleting one, which stops its live version and removes its data
+ * (DELETE /api/loop/pipelines/{id}), and cancelling an attempt
+ * (POST /api/loop/training-runs/{id}/cancel).
  *
  * The service is the authority: the SDK never blocks client-side, so when the
  * gate lifts at launch every SDK version works again without an upgrade. This

package/dist/client.js

@@ -198,17 +198,25 @@ export const CapacityUnavailableError = GpuRejectionError;
  * (HTTP 403): TRAINING_COMING_SOON from POST /api/training/jobs,
  * DATASETS_COMING_SOON from the dataset creation endpoints (upload,
  * uploads/initiate, register-hf, integration import), and LOOP_COMING_SOON
- * from EVERY Conscious Loop route (`client.loop.*`) where the loop is not
- * offered — it is offered on the development environment only.
+ * from the Conscious Loop routes (`client.loop.*`) where the platform has the
+ * loop switched off — every one of them but the five that let a member stop
+ * paying (see {@link ComingSoonError}).
  */
 export const COMING_SOON_CODES = ['TRAINING_COMING_SOON', 'DATASETS_COMING_SOON', 'LOOP_COMING_SOON'];
 /**
  * Raised when a pre-launch surface rejects a call: fine-tuning and datasets
  * launch soon, so training.create and dataset upload/import/register answer 403
  * with one of {@link COMING_SOON_CODES}, and their read and lifecycle methods
- * (list, get, status, stop, resume, delete, preview) are unaffected. The
- * Conscious Loop is offered on the development environment only; everywhere
- * else EVERY `client.loop.*` method, reads included, answers LOOP_COMING_SOON.
+ * (list, get, status, stop, resume, delete, preview) are unaffected. Where
+ * the platform has the Conscious Loop switched off, every `client.loop.*`
+ * method answers LOOP_COMING_SOON, reads included, except the five a member
+ * needs to stop paying, which answer as usual: listing pipelines
+ * (GET /api/loop/pipelines), reading one (GET /api/loop/pipelines/{id}),
+ * switching one off (PUT /api/loop/pipelines/{id} whose body is only
+ * `{"enabled": false}`, with at most `expected_revision` and `workspace_id`),
+ * deleting one, which stops its live version and removes its data
+ * (DELETE /api/loop/pipelines/{id}), and cancelling an attempt
+ * (POST /api/loop/training-runs/{id}/cancel).
  *
  * The service is the authority: the SDK never blocks client-side, so when the
  * gate lifts at launch every SDK version works again without an upgrade. This

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

package/dist/types.d.ts

@@ -3042,9 +3042,10 @@ export type TrainingRulePausedReason = 'consent_invalid' | 'insufficient_funds'
 /** A peer was unreachable when the rule was saved, so it has not been validated yet. */
  | 'validation_pending'
 /**
- * Training is in beta and the rule's organisation does not hold the grant: a
- * run was refused with the platform's pre-launch gate. Nothing on the rule is
- * wrong; the platform team enables training, then a member saves the rule.
+ * The platform's training service refused an attempt with its pre-launch
+ * gate while the platform's services were being updated (the Conscious Loop
+ * trains for every organisation, so nothing else gives this). Nothing on the
+ * pipeline is wrong; switching it back on starts it again.
  */
  | 'training_not_enabled';
 /**
@@ -3277,11 +3278,20 @@ export interface TrainingRun {
     next_poll_at: string | null;
     last_reason: string | null;
     /**
-     * Why it failed or was set aside, as a code. Two belong to a pipeline that
+     * Why it failed or was set aside, as a code. Three belong to a pipeline that
      * builds on its live version: `CHAIN_MOVED` (it was built on a version that
      * was rolled back while it trained; it is superseded, no comparison was
-     * paid for, and its samples go to the next attempt) and `NO_MERGED_EXPORT`
-     * (its training finished without the merged model it is served as).
+     * paid for, and its samples go to the next attempt), `NO_MERGED_EXPORT`
+     * (its training finished without the merged model it is served as) and
+     * `TRAINING_SERVICE_BEHIND` (the platform's training service was being
+     * updated when it asked for its training, so it stopped before any
+     * training started; nothing was charged and the next attempt asks again).
+     * `STEP_STALLED:TRAINING_SERVICE_BEHIND` is the same for one that waited
+     * six hours for that update; the pipeline tries again on its own.
+     * `ENV_GATED:SWITCHED_OFF`: the Conscious Loop was switched off on the
+     * platform before its training started, so it stopped there; no GPU time
+     * was charged, and the pipeline trains again on its own once the loop is
+     * back.
      */
     error_code: string | null;
     last_error: string | null;
@@ -3306,6 +3316,15 @@ export interface TrainingRun {
      * cap when no placement price was reported).
      */
     billed_candidate_up_to: boolean;
+    /**
+     * What was taken off for comparison machines that never started (never
+     * reached running): the platform charged nothing for them, so neither does
+     * the attempt -- say "Comparison machine: not charged (it never started)",
+     * or, while a comparison machine that ran is still charged beside it, that
+     * the one that never started was not charged. 0 when none; the cost figures
+     * beside it are already net of it.
+     */
+    comparison_returned_cents: number;
     spent_eval_cents: number;
     train_rows: number | null;
     holdout_rows: number | null;
@@ -3360,6 +3379,12 @@ export interface TrainingRun {
      * machine bills beside it), so the attempt can stay in candidate_booking
      * past this time, by at most one more window. An attempt that ran out
      * gives the deadline it was held to on its expiry event (deadline_at).
+     * Null while the machine has never had a GPU: that wait is free and its
+     * `last_reason` says since when. A day after the machine was booked with no
+     * GPU it is stopped (never started, not charged) and the attempt waits for
+     * GPUs (`waiting_gpus`) keeping its trained model, then books the machine
+     * again; if no GPU is free by that wait's end too, the attempt ends
+     * (`expired`, `CANDIDATE_NOT_STARTED:NO_GPU`).
      */
     candidate_deadline_at: string | null;
     candidate_cleanup_at: string | null;
@@ -3421,6 +3446,8 @@ export interface TrainingRunSummary {
     billed_candidate_cents: number;
     /** See {@link TrainingRun.billed_candidate_up_to}. */
     billed_candidate_up_to: boolean;
+    /** See {@link TrainingRun.comparison_returned_cents}. */
+    comparison_returned_cents: number;
     spent_eval_cents: number;
     /** The fourth money column. A row that leaves it out adds up short. */
     benchmark_spent_cents: number;
@@ -4130,11 +4157,14 @@ export type TrainingRuleRunRefusalCode = 'NOT_ENOUGH_SAMPLES' | 'PIPELINE_NEEDS_
  *   benchmark the pipeline does not have yet.
  *
  * The platform:
- * - `TRAINING_NOT_ENABLED` (409): training is in beta and this organisation
- *   does not hold the grant. Nothing in the request can lift it, so do not
- *   retry: ask the platform team to enable training for the organisation. A
- *   pipeline that meets it at fire time is paused `training_not_enabled`
- *   instead (see {@link TrainingRulePausedReason}).
+ * - `TRAINING_NOT_ENABLED` (409): the platform's training service would not
+ *   take the pipeline's training while the platform was being updated (the
+ *   Conscious Loop trains for every organisation; this answer only appears
+ *   while the platform's services are being updated). Nothing was saved and
+ *   nothing in the request is wrong: try again in a few minutes. A pipeline
+ *   that meets it at fire time is paused `training_not_enabled` instead (see
+ *   {@link TrainingRulePausedReason}); switching it back on later starts it
+ *   again.
  * - `METHOD_NOT_ENABLED` (422): the platform has switched off the training
  *   method pipelines train with.
  * - `CEILING_TOO_LOW` (422): the platform's own runaway limits cannot cover
@@ -4205,6 +4235,8 @@ export interface PipelineActiveRun {
      * the most it can have cost, so show it as "up to".
      */
     cost_up_to: boolean;
+    /** See {@link TrainingRun.comparison_returned_cents}. */
+    comparison_returned_cents: number;
     /** The version number it will take if it is put live. */
     will_be_version: number;
     /** Always null: nothing in flight is a version yet. */
@@ -4352,6 +4384,8 @@ export interface PipelineAttempt {
     cost_cents: number;
     /** See {@link PipelineVersion.cost_up_to}. */
     cost_up_to: boolean;
+    /** See {@link TrainingRun.comparison_returned_cents}. */
+    comparison_returned_cents: number;
     verdict: TrainingVerdict | null;
     win_rate: number | null;
     /**
@@ -4768,6 +4802,13 @@ export interface TrainingRunCost {
     benchmark_cents: number;
     total_cents: number;
     up_to: boolean;
+    /**
+     * What was taken off `comparison_cents` for comparison machines that never
+     * started: "Comparison machine: not charged (it never started)" (with
+     * `comparison_cents` above 0, only the one that never started). 0 when
+     * none.
+     */
+    comparison_returned_cents: number;
 }
 export interface TrainingRunActionResponse {
     run: TrainingRun;

package/package.json

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