@blaxel/core 0.3.12-preview.266 → 0.3.12

package/dist/cjs/common/settings.js

@@ -30,8 +30,8 @@ function missingCredentialsMessage() {
     return "No Blaxel credentials found. Set the BL_API_KEY and BL_WORKSPACE environment variables, or run `bl login`.";
 }
 // Build info - these placeholders are replaced at build time by build:replace-imports
-const BUILD_VERSION = "0.3.12-preview.266";
-const BUILD_COMMIT = "3049e74b685f1456a0819bf69f4e50c964f2dfff";
+const BUILD_VERSION = "0.3.12";
+const BUILD_COMMIT = "4b5045ad4c5d7510d577039bb63f662efbfbf689";
 const BUILD_SENTRY_DSN = "https://fd5e60e1c9820e1eef5ccebb84a07127@o4508714045276160.ingest.us.sentry.io/4510465864564736";
 const BLAXEL_API_VERSION = "2026-04-28";
 // Bun < 1.3.11 never sends connection-level WINDOW_UPDATE: the pooled h2

package/dist/cjs/drive/index.js

@@ -28,6 +28,7 @@ class DriveInstance {
     get displayName() {
         return this.drive.metadata.displayName;
     }
+    /** @deprecated Only legacy drives created with a size still report one. */
     get size() {
         return this.drive.spec.size;
     }
@@ -53,7 +54,6 @@ class DriveInstance {
                     labels: config.labels
                 },
                 spec: {
-                    size: config.size,
                     region: config.region || settings_js_1.settings.region,
                     permissions: config.permissions,
                 }
@@ -155,8 +155,6 @@ class DriveInstance {
                     metadataUpdates.labels = updates.metadata.labels;
             }
             if (updates.spec) {
-                if (updates.spec.size !== undefined)
-                    specUpdates.size = updates.spec.size;
                 if (updates.spec.region !== undefined)
                     specUpdates.region = updates.spec.region;
                 if (updates.spec.permissions !== undefined)
@@ -169,8 +167,6 @@ class DriveInstance {
                 metadataUpdates.displayName = updates.displayName;
             if (updates.labels !== undefined)
                 metadataUpdates.labels = updates.labels;
-            if (updates.size !== undefined)
-                specUpdates.size = updates.size;
             if (updates.region !== undefined)
                 specUpdates.region = updates.region;
             if (updates.permissions !== undefined)

package/dist/cjs/sandbox/sandbox.js

@@ -122,6 +122,15 @@ class SandboxInstance {
     get lastUsedAt() {
         return this.sandbox.lastUsedAt;
     }
+    /**
+     * Infrastructure failures the compute plane recorded for this sandbox, oldest
+     * first. Entries with `fatal: true` are the ones that moved it to FAILED; the
+     * others (e.g. a microVM that exited and restarted) are informational. Only
+     * returned when a single sandbox is read, never in listings.
+     */
+    get errors() {
+        return this.sandbox.errors ?? [];
+    }
     get h2Domain() {
         return this.sandbox.h2Domain ?? null;
     }

package/dist/cjs/types/client/types.gen.d.ts

@@ -120,7 +120,7 @@ export type ApiKey = TimeFields & OwnerFields & {
      */
     readonly apiKey?: string;
     /**
-     * Duration until expiration. Supports formats like '30d' (30 days), '24h' (24 hours), '1w' (1 week). If not set, the API key never expires.
+     * Duration until expiration. Supports formats like '30d' (30 days), '24h' (24 hours), '1w' (1 week). Must be positive and at most 10 years. If not set, the API key never expires.
      */
     expires_in?: string;
     /**
@@ -145,7 +145,7 @@ export type ApiKey = TimeFields & OwnerFields & {
  */
 export type ApiKeyWritable = TimeFields & OwnerFields & {
     /**
-     * Duration until expiration. Supports formats like '30d' (30 days), '24h' (24 hours), '1w' (1 week). If not set, the API key never expires.
+     * Duration until expiration. Supports formats like '30d' (30 days), '24h' (24 hours), '1w' (1 week). Must be positive and at most 10 years. If not set, the API key never expires.
      */
     expires_in?: string;
     /**
@@ -720,7 +720,7 @@ export type Drive = {
 export type DriveWritable = {
     events?: CoreEventsWritable;
     metadata: MetadataWritable;
-    spec: DriveSpecWritable;
+    spec: DriveSpec;
     state?: DriveStateWritable;
 };
 /**
@@ -766,27 +766,6 @@ export type DrivePermission = {
  * Immutable drive configuration set at creation time
  */
 export type DriveSpec = {
-    /**
-     * The internal infrastructure resource identifier for this drive (bucket name)
-     */
-    readonly infrastructureId?: string;
-    /**
-     * Permissions controlling which workloads can access this drive. Empty means all workloads in the workspace can access the drive. Maximum 3 permissions.
-     */
-    permissions?: Array<DrivePermission>;
-    /**
-     * Deployment region for the drive (e.g., us-pdx-1, eu-lon-1). Must match the region of resources it attaches to.
-     */
-    region?: string;
-    /**
-     * Optional size limit for the drive in GB. If not specified, drive has no size limit.
-     */
-    size?: number;
-};
-/**
- * Immutable drive configuration set at creation time
- */
-export type DriveSpecWritable = {
     /**
      * Permissions controlling which workloads can access this drive. Empty means all workloads in the workspace can access the drive. Maximum 3 permissions.
      */
@@ -795,10 +774,6 @@ export type DriveSpecWritable = {
      * Deployment region for the drive (e.g., us-pdx-1, eu-lon-1). Must match the region of resources it attaches to.
      */
     region?: string;
-    /**
-     * Optional size limit for the drive in GB. If not specified, drive has no size limit.
-     */
-    size?: number;
 };
 /**
  * Current runtime state of the drive
@@ -3515,6 +3490,10 @@ export type SsoDomainSpecWritable = {
  * Lightweight virtual machine for secure AI code execution. Sandboxes resume from standby in under 25ms and automatically scale to zero after inactivity, preserving memory state including running processes and filesystem.
  */
 export type Sandbox = {
+    /**
+     * Infrastructure failures recorded on the sandbox, oldest first (read-only, managed by the system)
+     */
+    readonly errors?: Array<SandboxInfrastructureError>;
     events?: CoreEvents;
     /**
      * Time in seconds until the sandbox is automatically deleted based on TTL and lifecycle policies. Only present for sandboxes with lifecycle configured.
@@ -3698,6 +3677,31 @@ export type SandboxForkResponse = {
      */
     type?: 'sandbox' | 'application';
 };
+/**
+ * Infrastructure failure the compute plane reported for a sandbox
+ */
+export type SandboxInfrastructureError = {
+    /**
+     * Stable code of the failure pattern
+     */
+    code?: string;
+    /**
+     * Whether the failure was terminal, putting the sandbox in FAILED, as opposed to being cleared by a restart
+     */
+    fatal?: boolean;
+    /**
+     * Instance the failure was reported for
+     */
+    instance?: string;
+    /**
+     * Reason reported with the failure
+     */
+    message?: string;
+    /**
+     * Time at which the failure was recorded
+     */
+    time?: string;
+};
 /**
  * Lifecycle configuration controlling automatic sandbox deletion based on idle time, max age, or specific dates
  */
@@ -3863,6 +3867,10 @@ export type SandboxScheduleExecution = {
      * Creation timestamp (read-only).
      */
     readonly createdAt?: string;
+    /**
+     * Reason the execution failed, naming the resource that could not be reached. Empty when the command was accepted by the sandbox.
+     */
+    error?: string;
     /**
      * RFC 3339 time at which the command was submitted.
      */
@@ -3892,6 +3900,10 @@ export type SandboxScheduleExecution = {
  * One recorded execution of a sandbox schedule. statusCode is the HTTP status from submitting the command to the sandbox (the scheduler does not wait for the command to finish). Stored in the dedicated scheduleexecutions table.
  */
 export type SandboxScheduleExecutionWritable = {
+    /**
+     * Reason the execution failed, naming the resource that could not be reached. Empty when the command was accepted by the sandbox.
+     */
+    error?: string;
     /**
      * RFC 3339 time at which the command was submitted.
      */
@@ -4294,7 +4306,7 @@ export type Volume = {
 export type VolumeWritable = {
     events?: CoreEventsWritable;
     metadata: MetadataWritable;
-    spec: VolumeSpecWritable;
+    spec: VolumeSpec;
     state?: VolumeStateWritable;
 };
 /**
@@ -4347,27 +4359,6 @@ export type VolumeListWritable = {
  * Immutable volume configuration set at creation time (size and region cannot be changed after creation)
  */
 export type VolumeSpec = {
-    /**
-     * The internal infrastructure resource identifier for this volume
-     */
-    readonly infrastructureId?: string;
-    /**
-     * Deployment region for the volume (e.g., us-pdx-1, eu-lon-1). Must match the region of sandboxes it attaches to.
-     */
-    region?: string;
-    /**
-     * Storage capacity in megabytes. Can be increased after creation but not decreased.
-     */
-    size?: number;
-    /**
-     * Volume template to initialize from, with optional revision (e.g., "mytemplate:1" or "mytemplate:latest")
-     */
-    template?: string;
-};
-/**
- * Immutable volume configuration set at creation time (size and region cannot be changed after creation)
- */
-export type VolumeSpecWritable = {
     /**
      * Deployment region for the volume (e.g., us-pdx-1, eu-lon-1). Must match the region of sandboxes it attaches to.
      */
@@ -4725,6 +4716,10 @@ export type WorkspaceUser = {
  * API version (e.g., 2026-04-16). Defaults to the earliest stable version if omitted. See https://docs.blaxel.ai/api-reference/introduction#api-versioning.
  */
 export type BlaxelVersion = string;
+/**
+ * Comma-separated list of statuses to filter on (e.g. `DEPLOYED,FAILED`). Values are case-insensitive; unknown values are rejected with a 400. Selecting every status is equivalent to omitting the parameter. Bound into the cursor fingerprint so a cursor opened with one selection cannot be reused with another. Filtering itself requires the 2026-04-28 Blaxel-Version (the paginated listing); on earlier versions the value is still validated but the listing is unfiltered, except for sandboxes where it is applied on every version.
+ */
+export type ListingStatus = string;
 /**
  * Start from a known pagination boundary. `end` is only supported for `createdAt` listings (asc or desc) and returns the tail page directly without walking every cursor from the first page.
  */
@@ -4769,6 +4764,10 @@ export type ListAgentsData = {
          * Start from a known pagination boundary. `end` is only supported for `createdAt` listings (asc or desc) and returns the tail page directly without walking every cursor from the first page.
          */
         anchor?: 'end';
+        /**
+         * Comma-separated list of statuses to filter on (e.g. `DEPLOYED,FAILED`). Values are case-insensitive; unknown values are rejected with a 400. Selecting every status is equivalent to omitting the parameter. Bound into the cursor fingerprint so a cursor opened with one selection cannot be reused with another. Filtering itself requires the 2026-04-28 Blaxel-Version (the paginated listing); on earlier versions the value is still validated but the listing is unfiltered, except for sandboxes where it is applied on every version.
+         */
+        status?: string;
     };
     url: '/agents';
 };
@@ -4992,6 +4991,10 @@ export type ListApplicationsData = {
          * Start from a known pagination boundary. `end` is only supported for `createdAt` listings (asc or desc) and returns the tail page directly without walking every cursor from the first page.
          */
         anchor?: 'end';
+        /**
+         * Comma-separated list of statuses to filter on (e.g. `DEPLOYED,FAILED`). Values are case-insensitive; unknown values are rejected with a 400. Selecting every status is equivalent to omitting the parameter. Bound into the cursor fingerprint so a cursor opened with one selection cannot be reused with another. Filtering itself requires the 2026-04-28 Blaxel-Version (the paginated listing); on earlier versions the value is still validated but the listing is unfiltered, except for sandboxes where it is applied on every version.
+         */
+        status?: string;
     };
     url: '/applications';
 };
@@ -5445,6 +5448,10 @@ export type ListDrivesData = {
          * Filter drives by external ID. When set, only drives matching this caller-owned identifier are returned.
          */
         externalId?: string;
+        /**
+         * Comma-separated list of statuses to filter on (e.g. `DEPLOYED,FAILED`). Values are case-insensitive; unknown values are rejected with a 400. Selecting every status is equivalent to omitting the parameter. Bound into the cursor fingerprint so a cursor opened with one selection cannot be reused with another. Filtering itself requires the 2026-04-28 Blaxel-Version (the paginated listing); on earlier versions the value is still validated but the listing is unfiltered, except for sandboxes where it is applied on every version.
+         */
+        status?: string;
     };
     url: '/drives';
 };
@@ -5788,6 +5795,10 @@ export type ListFunctionsData = {
          * Start from a known pagination boundary. `end` is only supported for `createdAt` listings (asc or desc) and returns the tail page directly without walking every cursor from the first page.
          */
         anchor?: 'end';
+        /**
+         * Comma-separated list of statuses to filter on (e.g. `DEPLOYED,FAILED`). Values are case-insensitive; unknown values are rejected with a 400. Selecting every status is equivalent to omitting the parameter. Bound into the cursor fingerprint so a cursor opened with one selection cannot be reused with another. Filtering itself requires the 2026-04-28 Blaxel-Version (the paginated listing); on earlier versions the value is still validated but the listing is unfiltered, except for sandboxes where it is applied on every version.
+         */
+        status?: string;
     };
     url: '/functions';
 };
@@ -6554,6 +6565,10 @@ export type ListJobsData = {
          * Start from a known pagination boundary. `end` is only supported for `createdAt` listings (asc or desc) and returns the tail page directly without walking every cursor from the first page.
          */
         anchor?: 'end';
+        /**
+         * Comma-separated list of statuses to filter on (e.g. `DEPLOYED,FAILED`). Values are case-insensitive; unknown values are rejected with a 400. Selecting every status is equivalent to omitting the parameter. Bound into the cursor fingerprint so a cursor opened with one selection cannot be reused with another. Filtering itself requires the 2026-04-28 Blaxel-Version (the paginated listing); on earlier versions the value is still validated but the listing is unfiltered, except for sandboxes where it is applied on every version.
+         */
+        status?: string;
     };
     url: '/jobs';
 };
@@ -6906,6 +6921,10 @@ export type ListModelsData = {
          * Start from a known pagination boundary. `end` is only supported for `createdAt` listings (asc or desc) and returns the tail page directly without walking every cursor from the first page.
          */
         anchor?: 'end';
+        /**
+         * Comma-separated list of statuses to filter on (e.g. `DEPLOYED,FAILED`). Values are case-insensitive; unknown values are rejected with a 400. Selecting every status is equivalent to omitting the parameter. Bound into the cursor fingerprint so a cursor opened with one selection cannot be reused with another. Filtering itself requires the 2026-04-28 Blaxel-Version (the paginated listing); on earlier versions the value is still validated but the listing is unfiltered, except for sandboxes where it is applied on every version.
+         */
+        status?: string;
     };
     url: '/models';
 };
@@ -7365,6 +7384,10 @@ export type ListSandboxesData = {
          * Start from a known pagination boundary. `end` is only supported for `createdAt` listings (asc or desc) and returns the tail page directly without walking every cursor from the first page.
          */
         anchor?: 'end';
+        /**
+         * Comma-separated list of statuses to filter on (e.g. `DEPLOYED,FAILED`). When set it takes precedence over `showTerminated`. Unknown values are rejected with a 400. Bound into the cursor fingerprint.
+         */
+        status?: string;
         /**
          * Filter sandboxes by external ID. When set, only sandboxes matching this caller-owned identifier are returned.
          */
@@ -8579,6 +8602,10 @@ export type ListVolumesData = {
          * Filter volumes by external ID. When set, only volumes matching this caller-owned identifier are returned.
          */
         externalId?: string;
+        /**
+         * Comma-separated list of statuses to filter on (e.g. `DEPLOYED,FAILED`). Values are case-insensitive; unknown values are rejected with a 400. Selecting every status is equivalent to omitting the parameter. Bound into the cursor fingerprint so a cursor opened with one selection cannot be reused with another. Filtering itself requires the 2026-04-28 Blaxel-Version (the paginated listing); on earlier versions the value is still validated but the listing is unfiltered, except for sandboxes where it is applied on every version.
+         */
+        status?: string;
     };
     url: '/volumes';
 };

package/dist/cjs/types/drive/index.d.ts

@@ -4,6 +4,7 @@ export type DriveCreateConfiguration = {
     name?: string;
     displayName?: string;
     labels?: Record<string, string>;
+    /** @deprecated Drives have no size limit: the control plane ignores this. */
     size?: number;
     region?: string;
     permissions?: Array<DrivePermission>;
@@ -17,6 +18,7 @@ export declare class DriveInstance {
     get status(): string | undefined;
     get name(): string;
     get displayName(): string | undefined;
+    /** @deprecated Only legacy drives created with a size still report one. */
     get size(): number | undefined;
     get region(): string | undefined;
     get permissions(): DrivePermission[] | undefined;
@@ -53,6 +55,7 @@ export declare class DriveInstance {
         q?: string;
         anchor?: "end";
         externalId?: string;
+        status?: string;
     }>>;
     static delete(driveName: string): Promise<{
         message?: string;

package/dist/cjs/types/sandbox/sandbox.d.ts

@@ -47,6 +47,13 @@ export declare class SandboxInstance {
     get events(): import("../client/types.gen.js").CoreEvents | undefined;
     get spec(): import("../client/types.gen.js").SandboxSpec;
     get lastUsedAt(): string | undefined;
+    /**
+     * Infrastructure failures the compute plane recorded for this sandbox, oldest
+     * first. Entries with `fatal: true` are the ones that moved it to FAILED; the
+     * others (e.g. a microVM that exited and restarted) are informational. Only
+     * returned when a single sandbox is read, never in listings.
+     */
+    get errors(): import("../client/types.gen.js").SandboxInfrastructureError[];
     get h2Domain(): string | null;
     /**
      * Warm and attach an H2 session based on the sandbox's region.
@@ -131,6 +138,7 @@ export declare class SandboxInstance {
         sort?: "createdAt:desc" | "createdAt:asc" | "name:asc" | "name:desc";
         q?: string;
         anchor?: "end";
+        status?: string;
         externalId?: string;
     }>>;
     static delete(sandboxName: string): Promise<SandboxModel>;

package/dist/cjs/types/volume/index.d.ts

@@ -53,6 +53,7 @@ export declare class VolumeInstance {
         q?: string;
         anchor?: "end";
         externalId?: string;
+        status?: string;
     }>>;
     static delete(volumeName: string): Promise<Volume>;
     delete(): Promise<Volume>;