runbios-sdk 0.2.1-rc.98 → 0.2.2-dev.171

package/README.md

@@ -239,17 +239,47 @@ const preview = await client.datasets.preview('ds_abc123', { pageSize: 5 });
 
 // Import from HuggingFace
 const imported = await client.datasets.importFromHuggingFace({
-  repoId: 'databricks/dolly-15k',
+  repoId: 'HuggingFaceH4/ultrachat_200k',
   integrationId: 'int_abc123',
-  name: 'Dolly 15k',
+  name: 'Ultrachat SFT',
+  subset: 'default',
+  split: 'train_sft',
 });
 
 // Validate before upload
 const validation = await client.datasets.validate('./data.jsonl');
 ```
 
+#### Connected Hub search and exact source selection
+
+Use `client.integrations.list()` to discover connected accounts, then select the
+returned ID explicitly. `client.integrations.browse(integrationId, { query,
+page, limit })` searches with that account's access. Discovery returns account
+metadata, never stored credentials.
+
+Pass the same `integrationId` to `datasets.previewHub` and
+`datasets.importFromHuggingFace`. Preview returns `available_configs` and
+`available_splits`; choose the actual subset/split rather than assuming `train`.
+A missing or unauthorized integration is an error, not anonymous fallback.
+Public imports without an integration use `datasets.registerHuggingFace` and
+require `workspaceId` on the client or method call.
+
+Both import methods accept `revision`, `maxSamples`, `sampleStrategy` and
+`importMode`. The service records immutable source metadata for resume. A Hub
+preview does not prove readiness or preview an arbitrary older revision: inspect
+the registered dataset when importing an explicit revision. Poll
+`datasets.getStatus(id)` until `ready` before selecting it for training; a client
+polling timeout does not cancel the background import.
+
 ### Training
 
+`datasetIds` preserves source order. Pass the same `mixing` object to preflight
+and create: `{ mode: 'interleave', weights: [3, 1], seed: 42 }`. Weights match the
+ordered IDs. Modes are `sequential`, `shuffle`, `interleave`, and `phased`; phased
+plans contain ordered `phases` with `name`, `portion`, optional `weights`, and
+`shuffle`. The default composition seed is 42. Resume reconstructs data from
+source pins and the stored plan and verifies the checksum.
+
 ```typescript
 const request = {
   idempotencyKey: 'training-create-20260711-0001',

package/dist/client.d.ts

@@ -1,4 +1,4 @@
-import type { BiOSConfig, ApiErrorBody, AvailableGpuAlternative, CapacityMinimumRequirement } from './types.js';
+import type { BiOSConfig, ApiErrorBody, AvailableGpuAlternative, CapacityMinimumRequirement, LoopImportResult } from './types.js';
 /**
  * Typed error thrown by every SDK method when the API returns a non-2xx status.
  *
@@ -135,6 +135,53 @@ export declare const COMING_SOON_CODES: readonly ["TRAINING_COMING_SOON", "DATAS
 export declare class ComingSoonError extends ApiError {
     constructor(status: number, body: ApiErrorBody);
 }
+/** The code an import answers with when some rows were understood and then could not be stored. */
+export declare const IMPORT_INCOMPLETE_CODE = "IMPORT_INCOMPLETE";
+/**
+ * An import that did not finish: some rows could not be stored, or some
+ * verdicts that arrived with them could not be written.
+ *
+ * The rows it names were read and understood, so there is nothing to fix in
+ * the file: this is a storage failure, not a shape one. The full outcome is on
+ * {@link LoopImportIncompleteError.outcome} — what landed, which conversations
+ * it became, and which row positions did not — because a failure that reports
+ * only "it failed" leaves the caller with no move except sending everything
+ * again.
+ *
+ * HOW TO RECOVER. Send the same rows again with `importId`, the token this
+ * call was filed under. That is what makes the second call a RETRY: rows that
+ * already arrived come back under `already_present` instead of being stored
+ * twice, and a verdict that failed to write is attempted again. Repeat it
+ * exactly; a call that repeats nothing is a second import, on purpose, because
+ * a repeat is otherwise indistinguishable from the next page of a longer file.
+ *
+ * THE WHOLE FILE, not the rows this names, unless you sent `row_ids`. Without
+ * them a row is identified by its place in the call, so a shorter list moves
+ * every row after the gap and each is imported again.
+ */
+export declare class LoopImportIncompleteError extends ApiError {
+    /** Counts, notes and ids for the import, in the same shape a success returns. */
+    readonly outcome: LoopImportResult;
+    constructor(status: number, body: ApiErrorBody);
+    /**
+     * The token to repeat as `import_id` to retry this call. Without it the retry
+     * is a second import rather than a retry, and what already landed is stored
+     * again.
+     */
+    get importId(): string | undefined;
+    /**
+     * Row positions that were not stored, counting from 1 in the order you sent
+     * them. They say what is missing; they are a smaller file to send back only
+     * if you sent `row_ids`.
+     */
+    get notSavedRows(): number[];
+    /**
+     * Row positions whose conversation stored and whose verdict did not. Those
+     * conversations are in the loop waiting for review; retrying records the
+     * verdict.
+     */
+    get verdictsNotSavedRows(): number[];
+}
 /** Whether a machine code is one of the permanent GPU rejections. */
 export declare function isPermanentGpuCode(code: string | undefined): boolean;
 /**

package/dist/client.js

@@ -191,6 +191,63 @@ export class ComingSoonError extends ApiError {
         this.name = 'ComingSoonError';
     }
 }
+/** The code an import answers with when some rows were understood and then could not be stored. */
+export const IMPORT_INCOMPLETE_CODE = 'IMPORT_INCOMPLETE';
+/**
+ * An import that did not finish: some rows could not be stored, or some
+ * verdicts that arrived with them could not be written.
+ *
+ * The rows it names were read and understood, so there is nothing to fix in
+ * the file: this is a storage failure, not a shape one. The full outcome is on
+ * {@link LoopImportIncompleteError.outcome} — what landed, which conversations
+ * it became, and which row positions did not — because a failure that reports
+ * only "it failed" leaves the caller with no move except sending everything
+ * again.
+ *
+ * HOW TO RECOVER. Send the same rows again with `importId`, the token this
+ * call was filed under. That is what makes the second call a RETRY: rows that
+ * already arrived come back under `already_present` instead of being stored
+ * twice, and a verdict that failed to write is attempted again. Repeat it
+ * exactly; a call that repeats nothing is a second import, on purpose, because
+ * a repeat is otherwise indistinguishable from the next page of a longer file.
+ *
+ * THE WHOLE FILE, not the rows this names, unless you sent `row_ids`. Without
+ * them a row is identified by its place in the call, so a shorter list moves
+ * every row after the gap and each is imported again.
+ */
+export class LoopImportIncompleteError extends ApiError {
+    /** Counts, notes and ids for the import, in the same shape a success returns. */
+    outcome;
+    constructor(status, body) {
+        super(status, body);
+        this.name = 'LoopImportIncompleteError';
+        this.outcome = body;
+    }
+    /**
+     * The token to repeat as `import_id` to retry this call. Without it the retry
+     * is a second import rather than a retry, and what already landed is stored
+     * again.
+     */
+    get importId() {
+        return this.outcome.import_id;
+    }
+    /**
+     * Row positions that were not stored, counting from 1 in the order you sent
+     * them. They say what is missing; they are a smaller file to send back only
+     * if you sent `row_ids`.
+     */
+    get notSavedRows() {
+        return this.outcome.not_saved_rows ?? [];
+    }
+    /**
+     * Row positions whose conversation stored and whose verdict did not. Those
+     * conversations are in the loop waiting for review; retrying records the
+     * verdict.
+     */
+    get verdictsNotSavedRows() {
+        return this.outcome.verdicts_not_saved_rows ?? [];
+    }
+}
 /** Whether a machine code is one of the permanent GPU rejections. */
 export function isPermanentGpuCode(code) {
     return typeof code === 'string' && PERMANENT_GPU_CODES.includes(code);
@@ -225,6 +282,12 @@ export function buildApiError(status, body) {
     if (code && COMING_SOON_CODES.includes(code)) {
         return new ComingSoonError(status, body);
     }
+    // A half-finished import carries its whole outcome in the body. Leaving it as
+    // a plain ApiError makes the counts reachable only by casting `.body`, which
+    // is the same as not publishing them.
+    if (code === IMPORT_INCOMPLETE_CODE) {
+        return new LoopImportIncompleteError(status, body);
+    }
     return new ApiError(status, body);
 }
 // ============================================================================
@@ -276,7 +339,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-staging.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

@@ -26,20 +26,23 @@
 import type { BiOSConfig, ApiKeyIntrospection } from './types.js';
 import { Models } from './resources/models.js';
 import { Datasets } from './resources/datasets.js';
+import { Integrations } from './resources/integrations.js';
 import { Training } from './resources/training.js';
 import { Wallet } from './resources/wallet.js';
 import { GPU } from './resources/gpu.js';
 import { Inference } from './resources/inference.js';
+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.1-rc.98";
+export declare const VERSION = "0.2.2-dev.171";
 export declare class RunBiOS {
     /** Search models, fetch configs, check adapter compatibility. */
     readonly models: Models;
     /** Upload, import, preview, and manage training datasets. */
     readonly datasets: Datasets;
+    readonly integrations: Integrations;
     /** Create, monitor, stop, and resume fine-tuning jobs. */
     readonly training: Training;
     /** Check wallet balance. */
@@ -51,6 +54,12 @@ export declare class RunBiOS {
      * serving deployments, plus OpenAI-compatible non-streaming and SSE calls.
      */
     readonly inference: Inference;
+    /**
+     * The Conscious Loop. Capture what your model was asked and answered, record
+     * whether it was right, and turn those judgements into training data for
+     * SFT, DPO or GRPO. Nothing is captured until you turn it on for a source.
+     */
+    readonly loop: Loop;
     /** @internal */
     private readonly _http;
     constructor(config: BiOSConfig);
@@ -58,11 +67,14 @@ export declare class RunBiOS {
 }
 /** @deprecated Use {@link RunBiOS}. */
 export { RunBiOS as BiOS };
-export { ApiError, GpuRejectionError, CapacityUnavailableError, ComingSoonError, CAPACITY_UNAVAILABLE_CODE, COMING_SOON_CODES, PERMANENT_GPU_CODES, isPermanentGpuCode, gpuRejectionCodeForReason, } from './client.js';
+export { ApiError, GpuRejectionError, CapacityUnavailableError, ComingSoonError, LoopImportIncompleteError, CAPACITY_UNAVAILABLE_CODE, COMING_SOON_CODES, IMPORT_INCOMPLETE_CODE, PERMANENT_GPU_CODES, isPermanentGpuCode, gpuRejectionCodeForReason, } from './client.js';
 export { Models } from './resources/models.js';
 export { Datasets } from './resources/datasets.js';
+export { Integrations, type HuggingFaceIntegration, type IntegrationBrowseParams } from './resources/integrations.js';
 export { Training } from './resources/training.js';
 export { Wallet } from './resources/wallet.js';
 export { GPU, type GPURecommendation } from './resources/gpu.js';
 export { Inference, validateChatRequest, parseSSE, buildInferenceRequest, contextSizingBasis, type ContextSizingBasis, CONTEXT_DEFAULT_CEILING, CONTEXT_EDITABLE_FLOOR, type ChatMessage, type FunctionTool, type ChatCompletionParams, type ChatCompletionResponse, type ChatCompletionChunk, } from './resources/inference.js';
-export type { BiOSConfig, PaginatedResponse, ApiErrorBody, AvailableGpuAlternative, CapacityMinimumRequirement, InferenceBookingAccepted, Model, ModelSearchParams, ModelSearchResponse, ModelDetailResponse, ModelConfig, Dataset, DatasetListParams, DatasetListResponse, DatasetUploadParams, DatasetPreview, DatasetPreviewParams, DatasetImportHFParams, DatasetRegisterHFParams, DatasetHubSearchParams, DatasetHubPreviewParams, DatasetValidation, DatasetFormatVariant, DatasetFormatSpec, DatasetFormatSpecs, DatasetStorageUsage, TrainingMethod, RLHFAlgorithm, AdapterType, TrainingJobStatus, TrainingStatusFilter, TrainingCreateParams, TrainingListParams, TrainingListResponse, TrainingJob, TrainingMetrics, MetricPoint, MetricGraphConfig, TrainingCheckpoint, TrainingLogs, TrainingLogEntry, TrainingStopResponse, TrainingResumeResponse, CanonicalTrainingRequest, TrainingPreflightDataset, TrainingPreflightWarning, TrainingPreflightResponse, TrainingCapabilityChoice, TrainingConfigFieldCapability, TrainingCapabilities, GPUChoice, WalletBalance, Transaction, TransactionListResponse, TransactionListParams, GPUInfo, GPUPricingResponse, GPUOptionsParams, GPUOption, GPUOptionSuggestion, GPUOptionsResponse, InferenceStatus, InferenceCreateParams, InferenceUpdateParams, InferenceDeployment, InferenceDeploymentSummary, InferenceCreateResponse, InferenceListResponse, InferenceUpdateResponse, InferenceLifecycleResponse, InferenceDeleteResponse, InferenceGPUOptionMarket, InferenceGPUOption, InferenceGPUAlternative, InferenceGPUOptionsParams, InferenceGPUOptionsResponse, InferenceCanonicalRequest, InferencePreflightWarning, InferencePreflightResponse, AdapterCompatibility, AdapterCompatibilityResponse, AdapterCompatibilityParams, SupportedArchitecture, ArchitectureScope, SupportedArchitecturesResponse, ApiKey, ApiKeyScope, ApiKeyIntrospection, Organization, OrgMember, OrgInvite, Workspace, Integration, IntegrationCreateParams, StorageUsage, StorageObject, PromptTokensDetails, ChatCompletionUsage, } from './types.js';
+export type { BiOSConfig, PaginatedResponse, ApiErrorBody, AvailableGpuAlternative, CapacityMinimumRequirement, InferenceBookingAccepted, Model, ModelSearchParams, ModelSearchResponse, ModelDetailResponse, ModelConfig, Dataset, DatasetListParams, DatasetListResponse, DatasetUploadParams, DatasetPreview, DatasetPreviewParams, DatasetImportHFParams, DatasetRegisterHFParams, DatasetHubSearchParams, DatasetHubPreviewParams, DatasetValidation, DatasetFormatVariant, DatasetFormatSpec, DatasetFormatSpecs, DatasetStorageUsage, TrainingMethod, RLHFAlgorithm, AdapterType, TrainingJobStatus, TrainingStatusFilter, TrainingCreateParams, TrainingListParams, TrainingListResponse, TrainingJob, TrainingMetrics, TrainingResourceMetrics, TrainingDeviceMetrics, MetricPoint, MetricGraphConfig, TrainingCheckpoint, TrainingLogs, TrainingLogEntry, TrainingStopResponse, TrainingResumeResponse, CanonicalTrainingRequest, TrainingPreflightDataset, TrainingPreflightWarning, TrainingPreflightResponse, TrainingCapabilityChoice, TrainingConfigFieldCapability, TrainingCapabilities, GPUChoice, WalletBalance, Transaction, TransactionListResponse, TransactionListParams, GPUInfo, GPUPricingResponse, GPUOptionsParams, TrainingRecommendParams, TrainingAdvisorVerdict, TrainingAdvisorRecommendation, TrainingAdvisorUserShape, TrainingAdvisorJustification, TrainingAdvisorBasis, GPUOption, GPUOptionSuggestion, GPUOptionsResponse, InferenceStatus, InferenceCreateParams, InferenceUpdateParams, InferenceDeployment, InferenceDeploymentSummary, InferenceCreateResponse, InferenceListResponse, InferenceUpdateResponse, InferenceLifecycleResponse, InferenceDeleteResponse, InferenceGPUOptionMarket, InferenceGPUOption, InferenceGPUAlternative, InferenceGPUOptionsParams, InferenceGPUOptionsResponse, InferenceCanonicalRequest, InferencePreflightWarning, InferencePreflightResponse, AdapterCompatibility, AdapterCompatibilityResponse, AdapterCompatibilityParams, SupportedArchitecture, ArchitectureScope, SupportedArchitecturesResponse, ApiKey, ApiKeyScope, ApiKeyIntrospection, Organization, OrgMember, OrgInvite, Workspace, Integration, IntegrationCreateParams, StorageUsage, StorageObject, PromptTokensDetails, ChatCompletionUsage, TrainingCadence, TrainingCombinator, ServingKind, TrainingRulePausedReason, LoopTrainingMethod, TrainType, GradersScope, TrainingTrigger, TrainingRunState, TrainingVerdict, TrainingDecision, NotifyState, EvaluationStatus, EvaluationItemStatus, EvaluationWinner, EvaluationWarningCode, ConsentVia, TrainingToolCall, TrainingMessage, TrainingRuleServing, TrainingGPURung, TrainingRule, TrainingRuleConsent, TrainingRulePreflightRefusal, TrainingRuleKeyRef, TrainingRuleKeyCheck, TrainingRulePreflight, TrainingRuleBuildSpec, TrainingRuleTriggerInput, TrainingRuleTrainingInput, TrainingRuleDeployInput, TrainingRuleMoneyInput, TrainingRuleEvaluationInput, TrainingRulePromotionInput, TrainingRuleAcceptTerms, TrainingRulePreflightRequest, TrainingRuleCreateRequest, TrainingRuleUpdateRequest, TrainingRuleConsentRequest, TrainingRuleListParams, TrainingRunPromoteRequest, TrainingRunRejectRequest, TrainingRunRollbackRequest, TrainingRunCancelRequest, TrainingRunListParams, TrainingRun, TrainingRunSummary, TrainingRunEvent, TrainingRunLinks, TrainingRunActions, EvaluationRef, EvaluationDecoding, EvaluationJudgeDimension, EvaluationDimensionScore, EvaluationGraderScore, EvaluationWarning, EvaluationMargin, JudgeAgreementDimension, JudgeAgreement, Evaluation, EvaluationItemSide, EvaluationItem, EvaluationItemListParams, JudgeAgreementParams, AgentSettings, AgentSettingsRequest, BenchmarkStatus, BenchmarkSourceKind, BenchmarkRunStatus, BenchmarkScoring, BenchmarkDimensionScore, Benchmark, BenchmarkItem, BenchmarkRun, BenchmarkHistoryPoint, BenchmarkSource, BenchmarkCreateParams, BenchmarkListParams, BenchmarkItemListParams, BenchmarkHistoryParams, BenchmarkRetireParams, TrainingRuleBenchmarkRequest, InferenceAlias, InferenceAliasRequest, TrainingRuleListResponse, TrainingRuleResponse, TrainingRuleMutationResponse, TrainingRuleDeleteResponse, TrainingRunListResponse, TrainingRunResponse, TrainingRunActionResponse, EvaluationItemsResponse, AgentSettingsResponse, InferenceAliasListResponse, InferenceAliasResponse, InferenceAliasDeleteResponse, BenchmarkListResponse, BenchmarkItemsResponse, BenchmarkHistoryResponse, } from './types.js';
+/** The closed set of run states a training run never leaves. */
+export { TERMINAL_RUN_STATES } from './types.js';

package/dist/index.js

@@ -26,20 +26,23 @@
 import { HttpClient, envInferenceKey } from './client.js';
 import { Models } from './resources/models.js';
 import { Datasets } from './resources/datasets.js';
+import { Integrations } from './resources/integrations.js';
 import { Training } from './resources/training.js';
 import { Wallet } from './resources/wallet.js';
 import { GPU } from './resources/gpu.js';
 import { Inference } from './resources/inference.js';
+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.1-rc.98';
+export const VERSION = '0.2.2-dev.171';
 export class RunBiOS {
     /** Search models, fetch configs, check adapter compatibility. */
     models;
     /** Upload, import, preview, and manage training datasets. */
     datasets;
+    integrations;
     /** Create, monitor, stop, and resume fine-tuning jobs. */
     training;
     /** Check wallet balance. */
@@ -51,6 +54,12 @@ export class RunBiOS {
      * serving deployments, plus OpenAI-compatible non-streaming and SSE calls.
      */
     inference;
+    /**
+     * The Conscious Loop. Capture what your model was asked and answered, record
+     * whether it was right, and turn those judgements into training data for
+     * SFT, DPO or GRPO. Nothing is captured until you turn it on for a source.
+     */
+    loop;
     /** @internal */
     _http;
     constructor(config) {
@@ -58,9 +67,11 @@ export class RunBiOS {
         this._http = http;
         this.models = new Models(http);
         this.datasets = new Datasets(http);
+        this.integrations = new Integrations(http);
         this.training = new Training(http);
         this.wallet = new Wallet(http);
         this.gpu = new GPU(http);
+        this.loop = new Loop(http);
         // Inference-key resolution, most specific first:
         //   1. an explicit inferenceKey (a per-deployment sk-bios-... key)
         //   2. RUNBIOS_INFERENCE_KEY from the environment (legacy: BIOS_INFERENCE_KEY)
@@ -84,10 +95,13 @@ export { RunBiOS as BiOS };
 // ---------------------------------------------------------------------------
 // Re-exports
 // ---------------------------------------------------------------------------
-export { ApiError, GpuRejectionError, CapacityUnavailableError, ComingSoonError, CAPACITY_UNAVAILABLE_CODE, COMING_SOON_CODES, PERMANENT_GPU_CODES, isPermanentGpuCode, gpuRejectionCodeForReason, } from './client.js';
+export { ApiError, GpuRejectionError, CapacityUnavailableError, ComingSoonError, LoopImportIncompleteError, CAPACITY_UNAVAILABLE_CODE, COMING_SOON_CODES, IMPORT_INCOMPLETE_CODE, PERMANENT_GPU_CODES, isPermanentGpuCode, gpuRejectionCodeForReason, } from './client.js';
 export { Models } from './resources/models.js';
 export { Datasets } from './resources/datasets.js';
+export { Integrations } from './resources/integrations.js';
 export { Training } from './resources/training.js';
 export { Wallet } from './resources/wallet.js';
 export { GPU } from './resources/gpu.js';
 export { Inference, validateChatRequest, parseSSE, buildInferenceRequest, contextSizingBasis, CONTEXT_DEFAULT_CEILING, CONTEXT_EDITABLE_FLOOR, } from './resources/inference.js';
+/** The closed set of run states a training run never leaves. */
+export { TERMINAL_RUN_STATES } from './types.js';

package/dist/resources/datasets.d.ts

@@ -84,10 +84,14 @@ export declare class Datasets {
      *
      * @example
      * ```ts
+     * The selected split must already expose canonical rows: a `messages` array
+     * for SFT or a `text` field for CPT. Legacy layouts are rejected with
+     * conversion guidance rather than remapped silently.
+     *
      * const imported = await client.datasets.importFromHuggingFace({
-     *   repoId: 'databricks/dolly-15k',
+     *   repoId: 'your-org/dataset-with-messages',
      *   integrationId: 'int_abc123',
-     *   name: 'Dolly 15k',
+     *   name: 'Canonical SFT data',
      * });
      * console.log(`Imported: ${imported.id}`);
      * ```
@@ -99,8 +103,8 @@ export declare class Datasets {
      * @example
      * ```ts
      * const ds = await client.datasets.registerHuggingFace({
-     *   repo_id: 'databricks/dolly-15k',
-     *   name: 'Dolly 15k',
+     *   repo_id: 'your-org/dataset-with-text',
+     *   name: 'Canonical CPT corpus',
      *   split: 'train',
      * });
      * ```

package/dist/resources/datasets.js

@@ -114,6 +114,9 @@ export class Datasets {
             const message = err instanceof Error ? err.message : String(err);
             throw new Error(`Failed to read file at "${params.filePath}": ${message}`);
         }
+        if (!fileName.toLowerCase().endsWith('.jsonl')) {
+            throw new Error('RunBiOS: dataset uploads accept .jsonl only — one JSON object per line, with "messages" for SFT or "text" for CPT');
+        }
         const blob = new Blob([fileData]);
         const formData = new FormData();
         formData.append('file', blob, fileName);
@@ -181,10 +184,14 @@ export class Datasets {
      *
      * @example
      * ```ts
+     * The selected split must already expose canonical rows: a `messages` array
+     * for SFT or a `text` field for CPT. Legacy layouts are rejected with
+     * conversion guidance rather than remapped silently.
+     *
      * const imported = await client.datasets.importFromHuggingFace({
-     *   repoId: 'databricks/dolly-15k',
+     *   repoId: 'your-org/dataset-with-messages',
      *   integrationId: 'int_abc123',
-     *   name: 'Dolly 15k',
+     *   name: 'Canonical SFT data',
      * });
      * console.log(`Imported: ${imported.id}`);
      * ```
@@ -196,6 +203,7 @@ export class Datasets {
         return normalizeDataset(await this._http.fetchPost(`/api/datasets/integrations/${encodeURIComponent(params.integrationId)}/import`, {
             dataset_id: params.repoId,
             name: params.name || params.repoId.split('/').pop() || params.repoId,
+            revision: params.revision,
             subset: params.subset,
             split: params.split,
             max_samples: params.maxSamples,
@@ -210,8 +218,8 @@ export class Datasets {
      * @example
      * ```ts
      * const ds = await client.datasets.registerHuggingFace({
-     *   repo_id: 'databricks/dolly-15k',
-     *   name: 'Dolly 15k',
+     *   repo_id: 'your-org/dataset-with-text',
+     *   name: 'Canonical CPT corpus',
      *   split: 'train',
      * });
      * ```
@@ -232,6 +240,7 @@ export class Datasets {
             description: raw.description,
             hf_subset: raw.subset ?? raw.hf_subset,
             hf_split: raw.split ?? raw.hf_split,
+            hf_revision: raw.revision ?? raw.hf_revision,
             max_samples: raw.maxSamples ?? raw.max_samples,
             sample_strategy: raw.sampleStrategy ?? raw.sample_strategy,
             column_mapping: raw.columnMapping ?? raw.column_mapping,
@@ -341,6 +350,8 @@ export class Datasets {
             q.set('subset', params.subset);
         if (params.limit !== undefined)
             q.set('limit', String(params.limit));
+        if (params.integrationId)
+            q.set('integration_id', params.integrationId);
         return this._http.fetchGet(`/api/datasets/hub-preview?${q}`);
     }
     /**

package/dist/resources/gpu.js

@@ -46,6 +46,13 @@ export class GPU {
         if (params.modelActiveParamsB !== undefined) {
             q.set('model_active_params_b', String(params.modelActiveParamsB));
         }
+        if (params.maxLength !== undefined)
+            q.set('max_length', String(params.maxLength));
+        if (params.effectiveBatch !== undefined)
+            q.set('effective_batch', String(params.effectiveBatch));
+        else if (params.perDeviceTrainBatchSize !== undefined) {
+            q.set('per_device_train_batch_size', String(params.perDeviceTrainBatchSize));
+        }
         return this._http.fetchGet(`/api/training/gpu-options?${q}`);
     }
     /**

package/dist/resources/inference.d.ts

@@ -1,5 +1,5 @@
 import type { HttpClient } from '../client.js';
-import type { InferenceDeployment, InferenceDeploymentSummary, InferenceBookingAccepted, InferenceCreateParams, InferenceCreateResponse, InferenceDeleteResponse, InferenceGPUOptionsParams, InferenceGPUOptionsResponse, InferenceLifecycleResponse, InferenceListParams, InferenceListResponse, InferenceNotificationListResponse, InferencePreflightResponse, InferenceUpdateResponse, InferenceUpdateParams } from '../types.js';
+import type { InferenceDeployment, InferenceDeploymentSummary, InferenceBookingAccepted, InferenceCreateParams, InferenceCreateResponse, InferenceDeleteResponse, InferenceGPUOptionsParams, InferenceGPUOptionsResponse, InferenceLifecycleResponse, InferenceListParams, InferenceListResponse, InferenceNotificationListResponse, InferencePreflightResponse, InferenceUpdateResponse, InferenceUpdateParams, InferenceAlias, InferenceAliasRequest, InferenceAliasDeleteResponse } from '../types.js';
 /**
  * Serving context-length policy, owned and enforced by the server. Mirrored
  * here for documentation only -- never to pre-empt a server verdict.
@@ -62,7 +62,13 @@ export interface ChatCompletionParams extends Record<string, unknown> {
     /**
      * Standardized reasoning effort. Forwarded to `/v1/chat/completions` as
      * `reasoning_effort`. Use `'none'` to disable reasoning where the model
-     * allows it.
+     * allows it — with reasoning off, no thinking tokens are generated or billed.
+     *
+     * `'low'` and `'medium'` minimise or skip thinking. `'high'`, `'xhigh'` and
+     * `'max'` think, and thinking tokens are billed as output tokens AND count
+     * against `max_tokens` — so a small `max_tokens` at those levels can be spent
+     * entirely on thinking and return an empty `content` with
+     * `finish_reason: "length"`. Budget generously at `'xhigh'`/`'max'`.
      */
     reasoningEffort?: 'none' | 'minimal' | 'low' | 'medium' | 'high' | 'xhigh' | 'max';
     inferenceKey?: string;
@@ -207,6 +213,31 @@ export declare class Inference {
     restart(id: string): Promise<InferenceLifecycleResponse>;
     update(id: string, params: InferenceUpdateParams): Promise<InferenceUpdateResponse>;
     delete(id: string): Promise<InferenceDeleteResponse>;
+    /**
+     * Point a name at a deployment, creating the alias or moving an existing one.
+     *
+     * THIS CHANGES WHAT ANSWERS YOUR TRAFFIC the moment it returns. The reply
+     * carries `previous_target_inference_id`, which is what to put back if the
+     * new target turns out to be wrong.
+     *
+     * `origin` records why the handle moved -- a run id, a person, a script --
+     * and is worth setting: an alias that changed with no reason recorded is an
+     * incident nobody can reconstruct.
+     *
+     * Refused when the name already belongs to a live deployment
+     * (`ALIAS_NAME_IS_A_DEPLOYMENT`), when the target is not running, degraded or
+     * provisioning (`TARGET_NOT_SERVABLE`), and with `404` when the target is not
+     * in this workspace.
+     */
+    setAlias(name: string, params: InferenceAliasRequest): Promise<InferenceAlias>;
+    /** Every alias in the workspace, with what each one points at today. */
+    listAliases(): Promise<InferenceAlias[]>;
+    /**
+     * Remove an alias. The name goes back to the deployment that owns it, if one
+     * does; callers still using the alias stop resolving, so move it rather than
+     * delete it when something is still calling it.
+     */
+    deleteAlias(name: string): Promise<InferenceAliasDeleteResponse>;
     /**
      * Model-fit GPU choices joined to the authoritative deployment market
      * snapshot. MODEL-ADDRESSED (recommended, book-first §2): pass `model` (or

package/dist/resources/inference.js

@@ -326,7 +326,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-staging.runbios.ai').replace(/\/+$/, '');
+        this.baseUrl = (config.baseUrl || envBaseUrl() || 'https://api-dev.runbios.ai').replace(/\/+$/, '');
         this.timeout = config.timeout ?? 900_000;
         this._http = http;
     }
@@ -629,6 +629,51 @@ export class Inference {
     delete(id) {
         return this.http.fetchDelete(`/api/inference/${encodeURIComponent(id)}`);
     }
+    // --------------------------------------------------------------------------
+    // Aliases -- re-pointable public handles
+    // --------------------------------------------------------------------------
+    //
+    // An alias is a name your callers use that you can move to a different
+    // deployment without them changing anything. It is what the automatic
+    // training loop re-points when it promotes a candidate, and it is what makes
+    // a rollback one row write rather than a redeployment.
+    //
+    // Reads carry `deployments:read` and writes `deployments:write`: an alias
+    // decides which model answers a customer's traffic, so it is fenced like the
+    // deployment it points at rather than like a label.
+    /**
+     * Point a name at a deployment, creating the alias or moving an existing one.
+     *
+     * THIS CHANGES WHAT ANSWERS YOUR TRAFFIC the moment it returns. The reply
+     * carries `previous_target_inference_id`, which is what to put back if the
+     * new target turns out to be wrong.
+     *
+     * `origin` records why the handle moved -- a run id, a person, a script --
+     * and is worth setting: an alias that changed with no reason recorded is an
+     * incident nobody can reconstruct.
+     *
+     * Refused when the name already belongs to a live deployment
+     * (`ALIAS_NAME_IS_A_DEPLOYMENT`), when the target is not running, degraded or
+     * provisioning (`TARGET_NOT_SERVABLE`), and with `404` when the target is not
+     * in this workspace.
+     */
+    async setAlias(name, params) {
+        const res = await this.http.fetchPut(`/api/inference/aliases/${encodeURIComponent(name)}`, params);
+        return res.alias;
+    }
+    /** Every alias in the workspace, with what each one points at today. */
+    async listAliases() {
+        const res = await this.http.fetchGet('/api/inference/aliases');
+        return res.aliases || [];
+    }
+    /**
+     * Remove an alias. The name goes back to the deployment that owns it, if one
+     * does; callers still using the alias stop resolving, so move it rather than
+     * delete it when something is still calling it.
+     */
+    async deleteAlias(name) {
+        return this.http.fetchDelete(`/api/inference/aliases/${encodeURIComponent(name)}`);
+    }
     /**
      * Model-fit GPU choices joined to the authoritative deployment market
      * snapshot. MODEL-ADDRESSED (recommended, book-first §2): pass `model` (or

package/dist/resources/integrations.d.ts

@@ -0,0 +1,21 @@
+import type { HttpClient } from '../client.js';
+export interface HuggingFaceIntegration {
+    id: string;
+    label: string;
+    provider: string;
+    status: string;
+    hf_username?: string;
+    scope?: string;
+}
+export interface IntegrationBrowseParams {
+    query?: string;
+    page?: number;
+    limit?: number;
+    sort?: 'downloads' | 'likes' | 'modified';
+}
+export declare class Integrations {
+    private readonly _http;
+    constructor(_http: HttpClient);
+    list(): Promise<HuggingFaceIntegration[]>;
+    browse(id: string, params?: IntegrationBrowseParams): Promise<Record<string, unknown>>;
+}

package/dist/resources/integrations.js

@@ -0,0 +1,20 @@
+export class Integrations {
+    _http;
+    constructor(_http) {
+        this._http = _http;
+    }
+    async list() {
+        const result = await this._http.fetchGet('/api/datasets/integrations');
+        if (!Array.isArray(result.integrations))
+            throw new Error('The integration service did not return an account list');
+        return result.integrations;
+    }
+    async browse(id, params = {}) {
+        const query = new URLSearchParams({ page: String(params.page ?? 1), limit: String(params.limit ?? 20) });
+        if (params.query !== undefined)
+            query.set('search', params.query);
+        if (params.sort !== undefined)
+            query.set('sort', params.sort);
+        return this._http.fetchGet(`/api/datasets/integrations/${encodeURIComponent(id)}/browse?${query}`);
+    }
+}