@blaxel/core 0.3.22-preview.299 → 0.3.23-preview.301

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

@@ -1329,6 +1329,18 @@ export type ImageSpecWritable = {
      */
     tags?: Array<ImageTagWritable>;
 };
+export type ImageSummary = {
+    metadata: ImageMetadata;
+    spec: ImageSummarySpec;
+};
+export type ImageSummaryWritable = {
+    metadata: ImageMetadataWritable;
+    spec: ImageSummarySpecWritable;
+};
+export type ImageSummarySpec = {
+    readonly size?: number;
+    readonly tagCount?: number;
+};
 export type ImageTag = {
     /**
      * The date and time when the tag was created.
@@ -1962,7 +1974,7 @@ export type JobRuntime = {
      */
     envs?: Array<Env>;
     /**
-     * Infrastructure generation: mk2 (containers, 2-10s cold starts) or mk3 (microVMs, sub-25ms cold starts)
+     * Infrastructure generation. Jobs always run on mk3 (microVMs); any value sent on input is ignored.
      */
     generation?: 'mk2' | 'mk3';
     /**
@@ -2451,6 +2463,10 @@ export type PaginationMeta = {
      * Total number of items in the workspace, ignoring the current page's filters. Lets the UI render "page X of Y" without walking the cursor chain. Computed from the hash-only metadata.workspace GSI count, so search (`q`) does not narrow it.
      */
     total?: number;
+    /**
+     * True when `total` is a lower bound rather than a complete count. Counting a very large workspace is bounded so the listing stays fast, and this flag says the real number is higher. Clients must not derive a page count from `total` when this is set — keep paging with `nextCursor` until `hasMore` is false.
+     */
+    totalIsPartial?: boolean;
 };
 /**
  * Pending cross-account image share awaiting approval from the destination workspace
@@ -3600,6 +3616,21 @@ export type SandboxArchiveRestoreWritable = {
      */
     state?: 'downloading' | 'extracting' | 'relaunching' | 'succeeded' | 'failed';
 };
+/**
+ * Optional Hub template settings applied by the console without additional sandbox creation lookups.
+ */
+export type SandboxCreationOptions = {
+    /**
+     * Kernel selection arguments copied into runtime.extraArgs. At most 8 entries.
+     */
+    extraArgs?: {
+        [key: string]: string;
+    };
+    /**
+     * Volume attachments included in the creation request. At most 5 attachments per template.
+     */
+    volumes?: Array<VolumeAttachment>;
+};
 /**
  * Pre-configured sandbox template available in the Sandbox Hub for quick deployment with predefined tools and configurations
  */
@@ -3614,6 +3645,7 @@ export type SandboxDefinition = {
      * If the definition is coming soon
      */
     coming_soon?: boolean;
+    creationOptions?: SandboxCreationOptions;
     /**
      * Description of the definition
      */
@@ -3857,7 +3889,7 @@ export type SandboxRuntime = {
      */
     expires?: string;
     /**
-     * Extra arguments for kernel selection. Supported keys: 'iptables', 'nfs' (mk3.0), 'tun' (mk3.1). Values: 'enabled' or 'disabled'. Determines which kernel variant the workload runs on. Immutable after creation.
+     * Extra arguments for kernel selection. Supported keys: 'iptables', 'nfs' (mk3.0), 'tun' and 'android' (mk3.1). The android variant includes tun and iptables and cannot be combined with nfs. Android requests are rejected if routing selects mk3.0. Values: 'enabled' or 'disabled'. Determines which kernel variant the workload runs on. Immutable after creation.
      */
     extraArgs?: {
         [key: string]: string;
@@ -4137,11 +4169,11 @@ export type SandboxSnapshot = {
      */
     createdBy?: string;
     /**
-     * Identifier of the snapshot on the compute plane
+     * Identifier of the snapshot, unique in the workspace. Workspace-level routes address the snapshot by it.
      */
     readonly id: string;
     /**
-     * Name of the snapshot, unique in its workspace
+     * Display name of the snapshot, unique among the snapshots of the sandbox it was captured from. Defaults to the identifier.
      */
     name: string;
     /**
@@ -4172,7 +4204,7 @@ export type SandboxSnapshotWritable = {
      */
     createdBy?: string;
     /**
-     * Name of the snapshot, unique in its workspace
+     * Display name of the snapshot, unique among the snapshots of the sandbox it was captured from. Defaults to the identifier.
      */
     name: string;
     /**
@@ -4215,7 +4247,7 @@ export type SandboxSnapshotListWritable = {
  */
 export type SandboxSnapshotRequest = {
     /**
-     * Name of the snapshot, unique in the workspace. Generated when absent, and always generated by the nested endpoint so a capture cannot collide with a name a user picked.
+     * Display name of the snapshot, unique among the snapshots of the sandbox it is captured from; the same name may be reused on another sandbox. Defaults to the snapshot identifier when absent.
      */
     name?: string;
     source?: SandboxSnapshotSource;
@@ -4225,7 +4257,7 @@ export type SandboxSnapshotRequest = {
  */
 export type SandboxSnapshotRequestWritable = {
     /**
-     * Name of the snapshot, unique in the workspace. Generated when absent, and always generated by the nested endpoint so a capture cannot collide with a name a user picked.
+     * Display name of the snapshot, unique among the snapshots of the sandbox it is captured from; the same name may be reused on another sandbox. Defaults to the snapshot identifier when absent.
      */
     name?: string;
     source?: SandboxSnapshotSourceWritable;
@@ -4978,6 +5010,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;
+/**
+ * Filter resources by metadata.externalId. When set, only resources matching this caller-owned external ID are returned.
+ */
+export type ExternalIdFilter = 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.
  */
@@ -5026,6 +5062,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';
+        /**
+         * Filter resources by metadata.externalId. When set, only resources matching this caller-owned external ID 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.
          */
@@ -5774,6 +5814,7 @@ export type DeleteDriveResponses = {
     200: {
         message?: string;
         name?: string;
+        status?: string;
     };
 };
 export type DeleteDriveResponse = DeleteDriveResponses[keyof DeleteDriveResponses];
@@ -6057,6 +6098,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';
+        /**
+         * Filter resources by metadata.externalId. When set, only resources matching this caller-owned external ID 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.
          */
@@ -6285,14 +6330,25 @@ export type CleanupImagesResponse = CleanupImagesResponses[keyof CleanupImagesRe
 export type ListImagesData = {
     body?: never;
     path?: never;
-    query?: never;
+    query?: {
+        cursor?: string;
+        limit?: number;
+        sort?: string;
+        /**
+         * Case-sensitive name prefix. Selects name order.
+         */
+        q?: string;
+    };
     url: '/images';
 };
 export type ListImagesResponses = {
     /**
      * successful operation
      */
-    200: Array<Image>;
+    200: {
+        data: Array<ImageSummary>;
+        meta: PaginationMeta;
+    };
 };
 export type ListImagesResponse = ListImagesResponses[keyof ListImagesResponses];
 export type CreateImageData = {
@@ -6392,14 +6448,19 @@ export type GetImageData = {
          */
         imageName: string;
     };
-    query?: never;
+    query?: {
+        /**
+         * Owner workspace for an account-shared image.
+         */
+        sourceWorkspace?: string;
+    };
     url: '/images/{resourceType}/{imageName}';
 };
 export type GetImageResponses = {
     /**
      * successful operation
      */
-    200: Image;
+    200: ImageSummary;
 };
 export type GetImageResponse = GetImageResponses[keyof GetImageResponses];
 export type ListImageSharesData = {
@@ -6511,6 +6572,44 @@ export type UnshareImageResponses = {
     200: Image;
 };
 export type UnshareImageResponse = UnshareImageResponses[keyof UnshareImageResponses];
+export type ListImageTagsData = {
+    body?: never;
+    path: {
+        resourceType: string;
+        imageName: string;
+    };
+    query?: {
+        cursor?: string;
+        limit?: number;
+        /**
+         * Order by tag name. Creation-time sorting is not supported.
+         */
+        sort?: 'name:asc' | 'name:desc';
+        /**
+         * Case-sensitive name prefix. Selects name order.
+         */
+        q?: string;
+        /**
+         * Exact tag name, mutually exclusive with q.
+         */
+        name?: string;
+        /**
+         * Owner workspace for an account-shared image.
+         */
+        sourceWorkspace?: string;
+    };
+    url: '/images/{resourceType}/{imageName}/tags';
+};
+export type ListImageTagsResponses = {
+    /**
+     * A page of tags
+     */
+    200: {
+        data: Array<ImageTag>;
+        meta: PaginationMeta;
+    };
+};
+export type ListImageTagsResponse = ListImageTagsResponses[keyof ListImageTagsResponses];
 export type DeleteImageTagData = {
     body?: never;
     path: {
@@ -6545,6 +6644,10 @@ export type DeleteImageTagResponses = {
      * successful operation
      */
     200: Image;
+    /**
+     * Tag deleted (API version 2026-09-22 and later).
+     */
+    204: void;
 };
 export type DeleteImageTagResponse = DeleteImageTagResponses[keyof DeleteImageTagResponses];
 export type GetIntegrationData = {
@@ -6568,7 +6671,12 @@ export type GetIntegrationResponse = GetIntegrationResponses[keyof GetIntegratio
 export type ListIntegrationConnectionsData = {
     body?: never;
     path?: never;
-    query?: never;
+    query?: {
+        /**
+         * Filter resources by metadata.externalId. When set, only resources matching this caller-owned external ID are returned.
+         */
+        externalId?: string;
+    };
     url: '/integrations/connections';
 };
 export type ListIntegrationConnectionsErrors = {
@@ -6827,6 +6935,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';
+        /**
+         * Filter resources by metadata.externalId. When set, only resources matching this caller-owned external ID 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.
          */
@@ -7183,6 +7295,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';
+        /**
+         * Filter resources by metadata.externalId. When set, only resources matching this caller-owned external ID 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.
          */
@@ -7492,6 +7608,10 @@ export type ListPoliciesData = {
          * 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';
+        /**
+         * Filter resources by metadata.externalId. When set, only resources matching this caller-owned external ID are returned.
+         */
+        externalId?: string;
     };
     url: '/policies';
 };
@@ -8320,7 +8440,7 @@ export type DeleteSandboxSnapshotData = {
          */
         sandboxName: string;
         /**
-         * ID of the snapshot to delete
+         * Name of the snapshot among the sandbox's snapshots. A snapshot ID is also accepted and resolves within the whole workspace, so it reaches a snapshot whose source sandbox is another one or was deleted.
          */
         snapshotId: string;
     };
@@ -8353,7 +8473,7 @@ export type RestoreSandboxSnapshotData = {
          */
         sandboxName: string;
         /**
-         * ID of the snapshot to restore the sandbox to
+         * Name of the snapshot among the sandbox's snapshots. A snapshot ID is also accepted and resolves within the whole workspace, so it reaches a snapshot whose source sandbox is another one or was deleted.
          */
         snapshotId: string;
     };
@@ -8869,7 +8989,7 @@ export type DeleteSnapshotData = {
     body?: never;
     path: {
         /**
-         * Name of the snapshot
+         * ID of the snapshot
          */
         snapshotName: string;
     };
@@ -8898,7 +9018,7 @@ export type GetSnapshotData = {
     body?: never;
     path: {
         /**
-         * Name of the snapshot
+         * ID of the snapshot
          */
         snapshotName: string;
     };
@@ -8923,7 +9043,7 @@ export type ForkSnapshotData = {
     body: SandboxForkRequest;
     path: {
         /**
-         * Name of the snapshot to create the resource from
+         * ID of the snapshot to create the resource from
          */
         snapshotName: string;
     };
@@ -9847,3 +9967,4 @@ export type ClientOptions = {
     baseUrl: 'https://api.blaxel.ai/v0' | 'https://run.blaxel.ai' | (string & {});
 };
 export type DriveStateWritable = DriveState;
+export type ImageSummarySpecWritable = Record<string, never>;

package/dist/cjs/types/common/pagination.d.ts

@@ -2,6 +2,8 @@ export type PaginatedListMeta = {
     hasMore?: boolean;
     nextCursor?: string;
     total?: number;
+    /** True when total is a lower bound; do not derive a page count from it. */
+    totalIsPartial?: boolean;
 };
 export type CursorPaginationQuery = {
     cursor?: string;

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

@@ -60,10 +60,12 @@ export declare class DriveInstance {
     static delete(driveName: string): Promise<{
         message?: string;
         name?: string;
+        status?: string;
     }>;
     delete(): Promise<{
         message?: string;
         name?: string;
+        status?: string;
     }>;
     static update(driveName: string, updates: DriveCreateConfiguration | Drive): Promise<DriveInstance>;
     update(updates: DriveCreateConfiguration | Drive): Promise<DriveInstance>;

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

@@ -1,3 +1,4 @@
+import { type ListImagesData, type ListImageTagsData } from "../client/index.js";
 import { Sandbox } from "../client/types.gen.js";
 export declare const SANDBOX_API_IMAGE = "ghcr.io/blaxel-ai/sandbox";
 export declare const SANDBOX_API_PATH = "/usr/local/bin/sandbox-api";
@@ -63,6 +64,8 @@ export interface UvInstallOptions {
     system?: boolean;
     upgrade?: boolean;
 }
+export type ImageListQuery = NonNullable<ListImagesData["query"]>;
+export type ImageTagListQuery = NonNullable<ListImageTagsData["query"]>;
 /**
  * A fluent builder for creating sandbox images programmatically.
  *
@@ -87,6 +90,22 @@ export interface UvInstallOptions {
  * ```
  */
 export declare class ImageInstance {
+    /** List repository summaries without fetching all their tags. */
+    static list(query?: ImageListQuery): Promise<import("../common/pagination.js").PaginatedList<import("../client/types.gen.js").ImageSummary, {
+        cursor?: string;
+        limit?: number;
+        sort?: string;
+        q?: string;
+    }>>;
+    /** List tags lazily, including tags owned by an account-shared workspace. */
+    static listTags(resourceType: string, imageName: string, query?: ImageTagListQuery): Promise<import("../common/pagination.js").PaginatedList<import("../client/types.gen.js").ImageTag, {
+        cursor?: string;
+        limit?: number;
+        sort?: "name:asc" | "name:desc";
+        q?: string;
+        name?: string;
+        sourceWorkspace?: string;
+    }>>;
     private _context;
     constructor(context: ImageBuildContext);
     /**

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

@@ -1 +1,2 @@
 export { ImageInstance, ImageBuildContext, ImageBuildOptions, LocalFile, SANDBOX_API_IMAGE, SANDBOX_API_PATH, PipInstallOptions, AptInstallOptions, ApkAddOptions, NpmInstallOptions, GemInstallOptions, CargoInstallOptions, ComposerInstallOptions, UvInstallOptions, } from "./image.js";
+export type { ImageListQuery, ImageTagListQuery } from "./image.js";

package/dist/cjs/types/image/pagination.test.d.ts

@@ -0,0 +1 @@
+export {};