@blaxel/core 0.2.96-preview.203 → 0.2.96-preview.205

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

@@ -61,7 +61,7 @@ export declare const getCodegenRerankingByPath: <ThrowOnError extends boolean =
 export declare const getDrivesMount: <ThrowOnError extends boolean = false>(options?: Options<GetDrivesMountData, ThrowOnError>) => import("@hey-api/client-fetch").RequestResult<import("./types.gen").DriveListResponse, import("./types.gen").ErrorResponse, ThrowOnError>;
 /**
  * Attach a drive to a local path
- * Mounts an agent drive using the blfs binary to a local path, optionally mounting a subpath within the drive
+ * Mounts an agent drive using the blfs binary to a local path, optionally mounting a subpath within the drive. Supports optional UID/GID mapping to remap file ownership between the local sandbox and the filer (always mapped to filer UID/GID 0). Mapping values can be set per-request via uidMap/gidMap fields, or globally via BLFS_UID_MAP/BLFS_GID_MAP environment variables (request values take precedence).
  */
 export declare const postDrivesMount: <ThrowOnError extends boolean = false>(options: Options<PostDrivesMountData, ThrowOnError>) => import("@hey-api/client-fetch").RequestResult<import("./types.gen").DriveMountResponse, import("./types.gen").ErrorResponse, ThrowOnError>;
 /**
@@ -221,7 +221,7 @@ export declare const getProcessByIdentifierLogsStream: <ThrowOnError extends boo
  * Triggers an upgrade of the sandbox-api process. Returns 200 immediately before upgrading.
  * The upgrade will: download the specified binary from GitHub releases, validate it, and restart.
  * All running processes will be preserved across the upgrade.
- * Available versions: "develop" (default), "main", "latest", or specific tag like "v1.0.0"
+ * Available versions: "latest" (default, most recent release), "develop", "main", or specific tag like "v1.0.0"
  * You can also specify a custom baseUrl for forks (defaults to https://github.com/blaxel-ai/sandbox/releases)
  */
 export declare const postUpgrade: <ThrowOnError extends boolean = false>(options?: Options<PostUpgradeData, ThrowOnError>) => import("@hey-api/client-fetch").RequestResult<import("./types.gen").SuccessResponse, import("./types.gen").ErrorResponse, ThrowOnError>;

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

@@ -37,8 +37,16 @@ export type DriveListResponse = {
 export type DriveMountInfo = {
     driveName?: string;
     drivePath?: string;
+    /**
+     * The local GID used for this mount
+     */
+    gidMap?: string;
     mountPath?: string;
     readOnly?: boolean;
+    /**
+     * The local UID used for this mount
+     */
+    uidMap?: string;
 };
 export type DriveMountRequest = {
     driveName: string;
@@ -46,19 +54,35 @@ export type DriveMountRequest = {
      * Optional, defaults to "/"
      */
     drivePath?: string;
+    /**
+     * Optional, local GID to map (filer GID is always 0)
+     */
+    gidMap?: string;
     mountPath: string;
     /**
      * Optional, defaults to false
      */
     readOnly?: boolean;
+    /**
+     * Optional, local UID to map (filer UID is always 0)
+     */
+    uidMap?: string;
 };
 export type DriveMountResponse = {
     driveName?: string;
     drivePath?: string;
+    /**
+     * The local GID used for this mount
+     */
+    gidMap?: string;
     message?: string;
     mountPath?: string;
     readOnly?: boolean;
     success?: boolean;
+    /**
+     * The local UID used for this mount
+     */
+    uidMap?: string;
 };
 export type DriveUnmountResponse = {
     message?: string;
@@ -175,6 +199,9 @@ export type ProcessRequest = {
      * Disable scale-to-zero while process runs. Default timeout is 600s (10 minutes). Set timeout to 0 for infinite.
      */
     keepAlive?: boolean;
+    /**
+     * Maximum number of restarts on failure. Set to a negative value (e.g. -1) for unlimited restarts.
+     */
     maxRestarts?: number;
     name?: string;
     restartOnFailure?: boolean;
@@ -241,7 +268,7 @@ export type UpgradeRequest = {
      */
     baseUrl?: string;
     /**
-     * Version to upgrade to: "develop", "main", "latest", or specific tag like "v1.0.0"
+     * Version to upgrade to: "latest" (default), "develop", "main", or specific tag like "v1.0.0"
      */
     version?: string;
 };

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

@@ -3,6 +3,7 @@ export * from "./filesystem/index.js";
 export * from "./codegen/index.js";
 export { SandboxDrive, type DriveMountRequest, type DriveMountResponse, type DriveMountInfo, type DriveUnmountResponse } from "./drive/index.js";
 export * from "./preview.js";
+export * from "./schedule.js";
 export * from "./session.js";
 export * from "./sandbox.js";
 export * from "./system.js";

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

@@ -30,8 +30,8 @@ export declare class SandboxPreviews {
     constructor(sandbox: Sandbox);
     get sandboxName(): string;
     list(): Promise<SandboxPreview[]>;
-    create(preview: Preview): Promise<SandboxPreview>;
-    createIfNotExists(preview: Preview): Promise<SandboxPreview>;
+    create(preview: Preview, force?: boolean): Promise<SandboxPreview>;
+    createIfNotExists(preview: Preview, force?: boolean): Promise<SandboxPreview>;
     get(previewName: string): Promise<SandboxPreview>;
     delete(previewName: string): Promise<Preview>;
     private waitForDeletion;

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

@@ -1,20 +1,23 @@
 import type http2 from "http2";
-import { SandboxLifecycle, Sandbox as SandboxModel } from "../client/index.js";
+import { type ListSandboxesData, type SandboxLifecycle, type Sandbox as SandboxModel } from "../client/index.js";
 import { SandboxCodegen } from "./codegen/index.js";
 import { SandboxDrive } from "./drive/index.js";
 import { SandboxFileSystem } from "./filesystem/index.js";
 import { SandboxNetwork } from "./network/index.js";
 import { SandboxPreviews } from "./preview.js";
 import { SandboxProcess } from "./process/index.js";
+import { SandboxSchedules } from "./schedule.js";
 import { SandboxSessions } from "./session.js";
 import { SandboxSystem } from "./system.js";
 import { SandboxConfiguration, SandboxCreateConfiguration, SandboxUpdateMetadata, SandboxUpdateNetwork, SessionWithToken } from "./types.js";
+export type SandboxListQuery = NonNullable<ListSandboxesData["query"]>;
 export declare class SandboxInstance {
     private sandbox;
     fs: SandboxFileSystem;
     network: SandboxNetwork;
     process: SandboxProcess;
     previews: SandboxPreviews;
+    schedules: SandboxSchedules;
     sessions: SandboxSessions;
     codegen: SandboxCodegen;
     system: SandboxSystem;
@@ -52,9 +55,41 @@ export declare class SandboxInstance {
     }): Promise<SandboxInstance>;
     static get(sandboxName: string): Promise<SandboxInstance>;
     static getByExternalId(externalId: string): Promise<SandboxInstance>;
-    static list({ externalId }?: {
+    /**
+     * List one page of sandboxes.
+     *
+     * The returned page exposes `data` for the current page, `meta` for cursor
+     * metadata, and helpers to fetch more pages only when you need them.
+     *
+     * @example
+     * ```ts
+     * const page = await SandboxInstance.list({ limit: 50 });
+     *
+     * for (const sandbox of page.data) {
+     *   console.log(sandbox.metadata.name);
+     * }
+     *
+     * const nextPage = await page.nextPage();
+     * ```
+     *
+     * @example
+     * ```ts
+     * const page = await SandboxInstance.list({ limit: 100 });
+     *
+     * for await (const sandbox of page) {
+     *   console.log(sandbox.metadata.name);
+     * }
+     * ```
+     */
+    static list(query?: SandboxListQuery): Promise<import("../common/pagination.js").PaginatedList<SandboxInstance, {
+        showTerminated?: boolean;
+        cursor?: string;
+        limit?: number;
+        sort?: "createdAt:desc" | "createdAt:asc" | "name:asc" | "name:desc";
+        q?: string;
+        anchor?: "end";
         externalId?: string;
-    }): Promise<SandboxInstance[]>;
+    }>>;
     static delete(sandboxName: string): Promise<SandboxModel>;
     delete(): Promise<SandboxModel>;
     static updateMetadata(sandboxName: string, metadata: SandboxUpdateMetadata): Promise<SandboxInstance>;

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

@@ -0,0 +1,16 @@
+import type { ListSandboxScheduleExecutionsData, ListSandboxSchedulesData, Sandbox, SandboxScheduleEntry, SandboxScheduleExecution } from "../client/index.js";
+/** Optional filters for listing schedules (`type`, `q`, `limit`, `cursor`, `sort`). */
+export type SandboxScheduleListOptions = NonNullable<ListSandboxSchedulesData["query"]>;
+/** Optional filters for listing schedule executions (`q`, `limit`, `cursor`, `sort`). */
+export type SandboxScheduleExecutionListOptions = NonNullable<ListSandboxScheduleExecutionsData["query"]>;
+export declare class SandboxSchedules {
+    private sandbox;
+    constructor(sandbox: Sandbox);
+    get sandboxName(): string;
+    list(options?: SandboxScheduleListOptions): Promise<SandboxScheduleEntry[]>;
+    create(schedule: SandboxScheduleEntry): Promise<SandboxScheduleEntry>;
+    get(scheduleId: string): Promise<SandboxScheduleEntry>;
+    update(scheduleId: string, schedule: SandboxScheduleEntry): Promise<SandboxScheduleEntry>;
+    delete(scheduleId: string): Promise<SandboxScheduleEntry>;
+    executions(options?: SandboxScheduleExecutionListOptions): Promise<SandboxScheduleExecution[]>;
+}

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

@@ -1,12 +1,13 @@
-import { Volume } from "../client/index.js";
-export interface VolumeCreateConfiguration {
+import { type ListVolumesData, type Volume } from "../client/index.js";
+export type VolumeListQuery = NonNullable<ListVolumesData["query"]>;
+export type VolumeCreateConfiguration = {
     name?: string;
     displayName?: string;
     labels?: Record<string, string>;
     size?: number;
     region?: string;
     template?: string;
-}
+};
 export declare class VolumeInstance {
     private volume;
     constructor(volume: Volume);
@@ -19,7 +20,39 @@ export declare class VolumeInstance {
     get region(): string | undefined;
     static create(config: VolumeCreateConfiguration | Volume): Promise<VolumeInstance>;
     static get(volumeName: string): Promise<VolumeInstance>;
-    static list(): Promise<VolumeInstance[]>;
+    /**
+     * List one page of volumes.
+     *
+     * The returned page exposes `data` for the current page, `meta` for cursor
+     * metadata, and helpers to fetch more pages only when you need them.
+     *
+     * @example
+     * ```ts
+     * const page = await VolumeInstance.list({ limit: 50 });
+     *
+     * for (const volume of page.data) {
+     *   console.log(volume.name);
+     * }
+     *
+     * const nextPage = await page.nextPage();
+     * ```
+     *
+     * @example
+     * ```ts
+     * const page = await VolumeInstance.list({ limit: 100 });
+     *
+     * for await (const volume of page) {
+     *   console.log(volume.name);
+     * }
+     * ```
+     */
+    static list(query?: VolumeListQuery): Promise<import("../common/pagination.js").PaginatedList<VolumeInstance, {
+        cursor?: string;
+        limit?: number;
+        sort?: "createdAt:desc" | "createdAt:asc" | "name:asc" | "name:desc";
+        q?: string;
+        anchor?: "end";
+    }>>;
     static delete(volumeName: string): Promise<Volume>;
     delete(): Promise<Volume>;
     static update(volumeName: string, updates: VolumeCreateConfiguration | Volume): Promise<VolumeInstance>;

package/dist/cjs/volume/index.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.VolumeInstance = void 0;
 const uuid_1 = require("uuid");
 const index_js_1 = require("../client/index.js");
+const pagination_js_1 = require("../common/pagination.js");
 const settings_js_1 = require("../common/settings.js");
 class VolumeInstance {
     volume;
@@ -88,10 +89,46 @@ class VolumeInstance {
         });
         return new VolumeInstance(data);
     }
-    static async list() {
-        const { data } = await (0, index_js_1.listVolumes)({ throwOnError: true });
-        const items = Array.isArray(data) ? data : (data?.data ?? []);
-        return items.map((volume) => new VolumeInstance(volume));
+    /**
+     * List one page of volumes.
+     *
+     * The returned page exposes `data` for the current page, `meta` for cursor
+     * metadata, and helpers to fetch more pages only when you need them.
+     *
+     * @example
+     * ```ts
+     * const page = await VolumeInstance.list({ limit: 50 });
+     *
+     * for (const volume of page.data) {
+     *   console.log(volume.name);
+     * }
+     *
+     * const nextPage = await page.nextPage();
+     * ```
+     *
+     * @example
+     * ```ts
+     * const page = await VolumeInstance.list({ limit: 100 });
+     *
+     * for await (const volume of page) {
+     *   console.log(volume.name);
+     * }
+     * ```
+     */
+    static async list(query) {
+        const fetchPage = async (pageQuery) => {
+            const { data } = await (0, index_js_1.listVolumes)({
+                query: pageQuery,
+                throwOnError: true,
+            });
+            return data;
+        };
+        return (0, pagination_js_1.createPaginatedList)({
+            response: await fetchPage(query),
+            fetchPage,
+            mapItem: (volume) => new VolumeInstance(volume),
+            query,
+        });
     }
     static async delete(volumeName) {
         const { data } = await (0, index_js_1.deleteVolume)({