runbios-sdk 0.2.16 → 0.2.17-dev.268

package/dist/client.d.ts

@@ -118,14 +118,18 @@ export type CapacityUnavailableError = GpuRejectionError;
  * Machine codes the services answer with while a surface is pre-launch
  * (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).
+ * 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.
  */
-export declare const COMING_SOON_CODES: readonly ["TRAINING_COMING_SOON", "DATASETS_COMING_SOON"];
+export declare const COMING_SOON_CODES: readonly ["TRAINING_COMING_SOON", "DATASETS_COMING_SOON", "LOOP_COMING_SOON"];
 /**
- * Raised when a pre-launch surface rejects a creation call: fine-tuning and
- * datasets launch soon, so training.create and dataset upload/import/register
- * answer 403 with one of {@link COMING_SOON_CODES}. Read and lifecycle methods
- * (list, get, status, stop, resume, delete, preview) are unaffected.
+ * 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.
  *
  * 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

@@ -171,14 +171,18 @@ export const CapacityUnavailableError = GpuRejectionError;
  * Machine codes the services answer with while a surface is pre-launch
  * (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).
+ * 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.
  */
-export const COMING_SOON_CODES = ['TRAINING_COMING_SOON', 'DATASETS_COMING_SOON'];
+export const COMING_SOON_CODES = ['TRAINING_COMING_SOON', 'DATASETS_COMING_SOON', 'LOOP_COMING_SOON'];
 /**
- * Raised when a pre-launch surface rejects a creation call: fine-tuning and
- * datasets launch soon, so training.create and dataset upload/import/register
- * answer 403 with one of {@link COMING_SOON_CODES}. Read and lifecycle methods
- * (list, get, status, stop, resume, delete, preview) are unaffected.
+ * 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.
  *
  * 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
@@ -340,7 +344,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.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.16";
+export declare const VERSION = "0.2.17-dev.268";
 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.16';
+export const VERSION = '0.2.17-dev.268';
 export class RunBiOS {
     /** Search models, fetch configs, check adapter compatibility. */
     models;

package/dist/resources/inference.js

@@ -336,7 +336,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.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/loop.d.ts

@@ -12,6 +12,11 @@ import type { LoopTrace, LoopTraceListResponse, LoopTraceListParams, LoopCapture
  * deliberately absent from the Read Only preset, because what they return is
  * your raw prompts and completions rather than catalog metadata.
  *
+ * Offered on the development environment only for now. Anywhere else every
+ * method here, reads included, rejects with a `ComingSoonError` whose
+ * `code` is `LOOP_COMING_SOON` (HTTP 403): a deliberate product state, not an
+ * outage, so retrying cannot succeed there.
+ *
  * @example
  * ```ts
  * // 1. Decide that this source is recorded.
@@ -225,9 +230,17 @@ export declare class Loop {
      * A label may name a `parent`, which is what makes a MASTER GROUP: labelling
      * something `refunds` with parent `billing` makes it selectable as either,
      * and selecting `billing` later gathers every child without you maintaining
-     * a list of them.
+     * a list of them. The parent applies to the bare `labels` only: sent with
+     * `attributes` and no labels it would group nothing, and is refused.
+     *
+     * Leave `parent` out and a label the conversation already carries keeps
+     * the group it has: re-running `label(id, ['refunds'])` does not take
+     * `refunds` out of `billing`. Pass `''` to take the labels out of their
+     * group; the labels themselves stay.
      *
      * Labels are lowercased and trimmed, so `Refunds` and `refunds` are one label.
+     * A conversation carries at most 32 across every dimension; a label it
+     * already has does not count again.
      */
     label(traceId: string, labels: string[], parent?: string, attributes?: Record<string, string>): Promise<LoopLabel[]>;
     /**

package/dist/resources/loop.js

@@ -10,6 +10,11 @@
  * deliberately absent from the Read Only preset, because what they return is
  * your raw prompts and completions rather than catalog metadata.
  *
+ * Offered on the development environment only for now. Anywhere else every
+ * method here, reads included, rejects with a `ComingSoonError` whose
+ * `code` is `LOOP_COMING_SOON` (HTTP 403): a deliberate product state, not an
+ * outage, so retrying cannot succeed there.
+ *
  * @example
  * ```ts
  * // 1. Decide that this source is recorded.
@@ -288,9 +293,17 @@ export class Loop {
      * A label may name a `parent`, which is what makes a MASTER GROUP: labelling
      * something `refunds` with parent `billing` makes it selectable as either,
      * and selecting `billing` later gathers every child without you maintaining
-     * a list of them.
+     * a list of them. The parent applies to the bare `labels` only: sent with
+     * `attributes` and no labels it would group nothing, and is refused.
+     *
+     * Leave `parent` out and a label the conversation already carries keeps
+     * the group it has: re-running `label(id, ['refunds'])` does not take
+     * `refunds` out of `billing`. Pass `''` to take the labels out of their
+     * group; the labels themselves stay.
      *
      * Labels are lowercased and trimmed, so `Refunds` and `refunds` are one label.
+     * A conversation carries at most 32 across every dimension; a label it
+     * already has does not count again.
      */
     async label(traceId, labels, parent, attributes) {
         const res = await this._http.fetchPost(`/api/loop/traces/${encodeURIComponent(traceId)}/labels`, { labels, parent, attributes });

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.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.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;
@@ -2571,7 +2571,11 @@ export interface LoopSignalParams {
     labels?: string[];
     /** The same, by dimension: `{ category: 'billing' }`. */
     attributes?: Record<string, string>;
-    /** The master group the bare labels belong to. */
+    /**
+     * The master group the bare labels belong to. Left out, a label the
+     * conversation already carries keeps its group; `''` takes the labels out
+     * of their group.
+     */
     parent?: string;
 }
 export interface LoopTrace {

package/package.json

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