bios-sdk 0.1.1-dev.10 → 0.1.1-dev.13

package/dist/client.d.ts

@@ -1,4 +1,4 @@
-import type { BiOSConfig, ApiErrorBody } from './types.js';
+import type { BiOSConfig, ApiErrorBody, AvailableGpuAlternative } from './types.js';
 /**
  * Typed error thrown by every SDK method when the API returns a non-2xx status.
  *
@@ -12,6 +12,22 @@ import type { BiOSConfig, ApiErrorBody } from './types.js';
  *   }
  * }
  * ```
+ *
+ * Availability rejections are self-recoverable: when the selected GPU is no
+ * longer bookable at submit time the API answers 409 with a machine code and
+ * the currently bookable alternatives, and the SDK surfaces them typed:
+ *
+ * @example
+ * ```ts
+ * try {
+ *   await client.training.create({ ...req, gpu_type: 'A100_80GB' });
+ * } catch (err) {
+ *   if (err instanceof ApiError && err.code === 'SELECTED_GPU_UNAVAILABLE') {
+ *     const next = err.availableGpus?.[0];
+ *     if (next) await client.training.create({ ...req, gpu_type: next.gpu_type });
+ *   }
+ * }
+ * ```
  */
 export declare class ApiError extends Error {
     /** HTTP status code (e.g. 401, 404, 500). */
@@ -20,6 +36,20 @@ export declare class ApiError extends Error {
     readonly code: string | undefined;
     /** Server-assigned request ID for support / debugging. */
     readonly requestId: string | undefined;
+    /**
+     * The full parsed error response body. Availability rejections carry
+     * structured recovery data here (`available_gpus`, `checked_at`).
+     */
+    readonly body: ApiErrorBody;
+    /**
+     * Bookable-now GPU alternatives on availability rejections
+     * (SELECTED_GPU_UNAVAILABLE / CAPACITY_UNAVAILABLE); undefined otherwise.
+     * Every entry fit the requested model when `checkedAt` was stamped —
+     * resubmit with one of these and nothing else changed.
+     */
+    readonly availableGpus: AvailableGpuAlternative[] | undefined;
+    /** Availability snapshot time behind an availability rejection. */
+    readonly checkedAt: string | undefined;
     constructor(status: number, body: ApiErrorBody);
 }
 /** Default API key from `BIOS_API_KEY` when the config omits one. @internal */

package/dist/client.js

@@ -15,6 +15,22 @@ import { VERSION } from './index.js';
  *   }
  * }
  * ```
+ *
+ * Availability rejections are self-recoverable: when the selected GPU is no
+ * longer bookable at submit time the API answers 409 with a machine code and
+ * the currently bookable alternatives, and the SDK surfaces them typed:
+ *
+ * @example
+ * ```ts
+ * try {
+ *   await client.training.create({ ...req, gpu_type: 'A100_80GB' });
+ * } catch (err) {
+ *   if (err instanceof ApiError && err.code === 'SELECTED_GPU_UNAVAILABLE') {
+ *     const next = err.availableGpus?.[0];
+ *     if (next) await client.training.create({ ...req, gpu_type: next.gpu_type });
+ *   }
+ * }
+ * ```
  */
 export class ApiError extends Error {
     /** HTTP status code (e.g. 401, 404, 500). */
@@ -23,6 +39,20 @@ export class ApiError extends Error {
     code;
     /** Server-assigned request ID for support / debugging. */
     requestId;
+    /**
+     * The full parsed error response body. Availability rejections carry
+     * structured recovery data here (`available_gpus`, `checked_at`).
+     */
+    body;
+    /**
+     * Bookable-now GPU alternatives on availability rejections
+     * (SELECTED_GPU_UNAVAILABLE / CAPACITY_UNAVAILABLE); undefined otherwise.
+     * Every entry fit the requested model when `checkedAt` was stamped —
+     * resubmit with one of these and nothing else changed.
+     */
+    availableGpus;
+    /** Availability snapshot time behind an availability rejection. */
+    checkedAt;
     constructor(status, body) {
         const err = body.error;
         const nested = typeof err === 'object' && err !== null ? err : null;
@@ -36,6 +66,10 @@ export class ApiError extends Error {
         this.status = status;
         this.code = (nested ? String(nested.code || '') : body.code) || undefined;
         this.requestId = body.request_id;
+        this.body = body;
+        const alts = body.available_gpus ?? body.available_alternatives;
+        this.availableGpus = Array.isArray(alts) && alts.length > 0 ? alts : undefined;
+        this.checkedAt = body.checked_at;
     }
 }
 // ============================================================================

package/dist/index.d.ts

@@ -63,4 +63,4 @@ export { Training } from './resources/training.js';
 export { Wallet } from './resources/wallet.js';
 export { GPU, type GPURecommendation } from './resources/gpu.js';
 export { Inference, validateChatRequest, parseSSE, type ChatMessage, type FunctionTool, type ChatCompletionParams, type ChatCompletionResponse, type ChatCompletionChunk, } from './resources/inference.js';
-export type { BiOSConfig, PaginatedResponse, ApiErrorBody, Model, ModelSearchParams, ModelSearchResponse, 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, TransactionListParams, GPUInfo, GPUPricingResponse, GPUOptionsParams, GPUOption, GPUOptionSuggestion, GPUOptionsResponse, InferenceStatus, InferenceCreateParams, InferenceUpdateParams, InferenceDeployment, 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, } from './types.js';
+export type { BiOSConfig, PaginatedResponse, ApiErrorBody, AvailableGpuAlternative, Model, ModelSearchParams, ModelSearchResponse, 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, TransactionListParams, GPUInfo, GPUPricingResponse, GPUOptionsParams, GPUOption, GPUOptionSuggestion, GPUOptionsResponse, InferenceStatus, InferenceCreateParams, InferenceUpdateParams, InferenceDeployment, 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, } from './types.js';

package/dist/types.d.ts

@@ -38,6 +38,27 @@ export interface ApiErrorBody {
     message?: string;
     code?: string;
     request_id?: string;
+    /**
+     * Bookable-now GPU alternatives, present on availability rejections
+     * (SELECTED_GPU_UNAVAILABLE / CAPACITY_UNAVAILABLE): each entry fits the
+     * requested model's minimum requirements and was in stock at `checked_at`.
+     * Pick one and resubmit — nothing else about the request needs to change.
+     */
+    available_gpus?: AvailableGpuAlternative[];
+    /** Same contract as `available_gpus`; some surfaces use this field name. */
+    available_alternatives?: AvailableGpuAlternative[];
+    /** When the availability snapshot behind the rejection was taken. */
+    checked_at?: string;
+}
+/** One bookable-now GPU alternative carried on an availability rejection. */
+export interface AvailableGpuAlternative {
+    gpu_type: string;
+    gpu_count?: number;
+    available_count?: number;
+    price_per_hour_cents?: number;
+    provider?: string;
+    region?: string;
+    tier?: string;
 }
 /** A model returned from the HuggingFace-backed model search. */
 export interface Model {

package/package.json

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