runbios-sdk 0.2.6-dev.196 → 0.2.6-dev.198

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

package/dist/resources/datasets.d.ts

@@ -1,5 +1,5 @@
 import type { HttpClient } from '../client.js';
-import type { Dataset, DatasetListParams, DatasetListResponse, DatasetUploadParams, DatasetPreview, DatasetPreviewParams, DatasetImportHFParams, DatasetRegisterHFParams, DatasetHubSearchParams, DatasetHubPreviewParams, DatasetValidation, DatasetFormatSpecs, DatasetStorageUsage } from '../types.js';
+import type { Dataset, DatasetListParams, DatasetListResponse, DatasetUploadParams, DatasetPreview, DatasetPreviewParams, DatasetImportHFParams, DatasetRegisterHFParams, DatasetRegisterLoopParams, DatasetHubSearchParams, DatasetHubPreviewParams, DatasetValidation, DatasetFormatSpecs, DatasetStorageUsage } from '../types.js';
 /**
  * Manage training datasets -- upload files, import from HuggingFace,
  * preview contents, and manage storage.
@@ -118,6 +118,30 @@ export declare class Datasets {
      * ```
      */
     registerHuggingFace(params: DatasetRegisterHFParams | Record<string, unknown>): Promise<Dataset>;
+    /**
+     * Turn a curated Conscious Loop set into a dataset training can use.
+     *
+     * Without this, using a loop set from code meant downloading the JSONL and
+     * uploading it again as an unrelated dataset. That works, and it throws away
+     * the one thing that made the set worth having: which conversations, which
+     * verdicts and which judges produced it. Registering keeps that link.
+     *
+     * The set is then put through the SAME validation every uploaded dataset
+     * gets, so it comes back `processing` rather than ready -- poll
+     * {@link getStatus} before training on it. Registering the same set and split
+     * twice is refused rather than billed twice, and an empty set is refused
+     * rather than registered as something that would fail inside the trainer.
+     *
+     * @example
+     * ```ts
+     * const train = await client.datasets.registerLoop({
+     *   loopDatasetId: 'd244894c-7ab4-4b3d-bfda-e0bb4c563ceb',
+     *   name: 'extract-v1 distill SFT',
+     *   split: 'train',
+     * });
+     * ```
+     */
+    registerLoop(params: DatasetRegisterLoopParams | Record<string, unknown>): Promise<Dataset>;
     /**
      * Get the processing status of a dataset.
      *

package/dist/resources/datasets.js

@@ -260,6 +260,45 @@ export class Datasets {
         });
         return normalizeDataset(result);
     }
+    /**
+     * Turn a curated Conscious Loop set into a dataset training can use.
+     *
+     * Without this, using a loop set from code meant downloading the JSONL and
+     * uploading it again as an unrelated dataset. That works, and it throws away
+     * the one thing that made the set worth having: which conversations, which
+     * verdicts and which judges produced it. Registering keeps that link.
+     *
+     * The set is then put through the SAME validation every uploaded dataset
+     * gets, so it comes back `processing` rather than ready -- poll
+     * {@link getStatus} before training on it. Registering the same set and split
+     * twice is refused rather than billed twice, and an empty set is refused
+     * rather than registered as something that would fail inside the trainer.
+     *
+     * @example
+     * ```ts
+     * const train = await client.datasets.registerLoop({
+     *   loopDatasetId: 'd244894c-7ab4-4b3d-bfda-e0bb4c563ceb',
+     *   name: 'extract-v1 distill SFT',
+     *   split: 'train',
+     * });
+     * ```
+     */
+    async registerLoop(params) {
+        const raw = params;
+        const loopDatasetId = String(raw.loopDatasetId || raw.loop_dataset_id || '');
+        if (!loopDatasetId)
+            throw new Error('RunBiOS: loopDatasetId is required');
+        const workspaceId = String(raw.workspaceId || raw.workspace_id || '')
+            || this._http.workspaceId
+            || await this._http.resolveWorkspaceId();
+        const result = await this._http.fetchPost('/api/datasets/register-loop', {
+            loop_dataset_id: loopDatasetId,
+            workspace_id: workspaceId,
+            split: raw.split ?? 'all',
+            ...(raw.name !== undefined && { name: raw.name }),
+        });
+        return normalizeDataset(result);
+    }
     /**
      * Get the processing status of a dataset.
      *

package/dist/types.d.ts

@@ -444,6 +444,21 @@ export interface DatasetRegisterHFParams {
     columnMapping?: Record<string, string>;
     importMode?: 'auto' | 'reference' | 'materialize';
 }
+/** Parameters for registering a curated Conscious Loop set as a dataset. */
+export interface DatasetRegisterLoopParams {
+    /** The Conscious Loop dataset to register. */
+    loopDatasetId: string;
+    /** Defaults to `loop-<first 8 of the loop id>`. */
+    name?: string;
+    /**
+     * Which rows to take. Defaults to `all`, because the loop already split the
+     * set by TIME and re-splitting a deliberate split throws that decision away.
+     * Register `train` and `holdout` separately to score a training job against
+     * the loop's own held-back rows; both can exist at once.
+     */
+    split?: 'all' | 'train' | 'holdout';
+    workspaceId?: string;
+}
 /** Parameters for searching HuggingFace Hub datasets. */
 export interface DatasetHubSearchParams {
     /** Search query. */

package/package.json

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