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

package/dist/cjs/client/sdk.gen.js

@@ -2,8 +2,9 @@
 // This file is auto-generated by @hey-api/openapi-ts
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createIntegrationConnection = exports.listIntegrationConnections = exports.getIntegration = exports.deleteImageTag = exports.unshareImage = exports.shareImage = exports.listImageShares = exports.getImage = exports.deleteImage = exports.createImage = exports.listImages = exports.cleanupImages = exports.listFunctionRevisions = exports.updateFunction = exports.getFunction = exports.deleteFunction = exports.createFunction = exports.listFunctions = exports.testFeatureFlag = exports.getWorkspaceFeatures = exports.listAllEgressIps = exports.getEgressGatewayUsage = exports.listAllEgressGateways = exports.getDriveJwks = exports.createDriveAccessToken = exports.updateDrive = exports.getDrive = exports.deleteDrive = exports.createDrive = exports.listDrives = exports.verifyCustomDomain = exports.updateCustomDomain = exports.getCustomDomain = exports.deleteCustomDomain = exports.createCustomDomain = exports.listCustomDomains = exports.getConfiguration = exports.listApplicationRevisions = exports.createApplicationCustomDomain = exports.updateApplication = exports.getApplication = exports.deleteApplication = exports.createApplication = exports.listApplications = exports.listAgentRevisions = exports.updateAgent = exports.getAgent = exports.deleteAgent = exports.createAgent = exports.listAgents = void 0;
-exports.getSandboxByExternalId = exports.deleteSandboxPreviewToken = exports.createSandboxPreviewToken = exports.listSandboxPreviewTokens = exports.updateSandboxPreview = exports.getSandboxPreview = exports.deleteSandboxPreview = exports.createSandboxPreview = exports.listSandboxPreviews = exports.updateSandbox = exports.getSandbox = exports.deleteSandbox = exports.createSandbox = exports.listSandboxes = exports.listSandboxHubDefinitions = exports.listPublicIps = exports.getPolicyUsages = exports.updatePolicy = exports.getPolicy = exports.deletePolicy = exports.createPolicy = exports.listPolicies = exports.declineImageShare = exports.acceptImageShare = exports.listPendingImageShares = exports.listModelRevisions = exports.updateModel = exports.getModel = exports.deleteModel = exports.createModel = exports.listModels = exports.listMcpHubDefinitions = exports.listLocations = exports.listJobRevisions = exports.listJobExecutionTasks = exports.getJobExecution = exports.deleteJobExecution = exports.createJobExecution = exports.listJobExecutions = exports.updateJob = exports.getJob = exports.deleteJob = exports.createJob = exports.listJobs = exports.getIntegrationConnectionModel = exports.listIntegrationConnectionModels = exports.getIntegrationConnectionModelEndpointConfigurations = exports.updateIntegrationConnection = exports.getIntegrationConnection = exports.deleteIntegrationConnection = void 0;
-exports.checkWorkspaceAvailability = exports.leaveWorkspace = exports.acceptWorkspaceInvitation = exports.declineWorkspaceInvitation = exports.updateWorkspace = exports.getWorkspace = exports.deleteWorkspace = exports.createWorkspace = exports.listWorkspaces = exports.getEgressIp = exports.deleteEgressIp = exports.createEgressIp = exports.listEgressIps = exports.getEgressGateway = exports.deleteEgressGateway = exports.createEgressGateway = exports.listEgressGateways = exports.getVpc = exports.deleteVpc = exports.createVpc = exports.listVpcs = exports.updateVolume = exports.getVolume = exports.deleteVolume = exports.createVolume = exports.listVolumes = exports.deleteVolumeTemplateVersion = exports.updateVolumeTemplate = exports.getVolumeTemplate = exports.deleteVolumeTemplate = exports.createVolumeTemplate = exports.listVolumeTemplates = exports.updateWorkspaceUserRole = exports.removeWorkspaceUser = exports.inviteWorkspaceUser = exports.listWorkspaceUsers = exports.getTemplate = exports.listTemplates = exports.deleteApiKeyForServiceAccount = exports.createApiKeyForServiceAccount = exports.listApiKeysForServiceAccount = exports.updateWorkspaceServiceAccount = exports.deleteWorkspaceServiceAccount = exports.createWorkspaceServiceAccount = exports.getWorkspaceServiceAccounts = void 0;
+exports.listSandboxScheduleExecutions = exports.deleteSandboxPreviewToken = exports.createSandboxPreviewToken = exports.listSandboxPreviewTokens = exports.updateSandboxPreview = exports.getSandboxPreview = exports.deleteSandboxPreview = exports.createSandboxPreview = exports.listSandboxPreviews = exports.updateSandbox = exports.getSandbox = exports.deleteSandbox = exports.createSandbox = exports.listSandboxes = exports.listSandboxHubDefinitions = exports.listPublicIps = exports.getPolicyUsages = exports.updatePolicy = exports.getPolicy = exports.deletePolicy = exports.createPolicy = exports.listPolicies = exports.declineImageShare = exports.acceptImageShare = exports.listPendingImageShares = exports.listModelRevisions = exports.updateModel = exports.getModel = exports.deleteModel = exports.createModel = exports.listModels = exports.listMcpHubDefinitions = exports.listLocations = exports.listJobRevisions = exports.listJobExecutionTasks = exports.getJobExecution = exports.deleteJobExecution = exports.createJobExecution = exports.listJobExecutions = exports.updateJob = exports.getJob = exports.deleteJob = exports.createJob = exports.listJobs = exports.getIntegrationConnectionModel = exports.listIntegrationConnectionModels = exports.getIntegrationConnectionModelEndpointConfigurations = exports.updateIntegrationConnection = exports.getIntegrationConnection = exports.deleteIntegrationConnection = void 0;
+exports.leaveWorkspace = exports.acceptWorkspaceInvitation = exports.declineWorkspaceInvitation = exports.updateWorkspace = exports.getWorkspace = exports.deleteWorkspace = exports.createWorkspace = exports.listWorkspaces = exports.getEgressIp = exports.deleteEgressIp = exports.createEgressIp = exports.listEgressIps = exports.getEgressGateway = exports.deleteEgressGateway = exports.createEgressGateway = exports.listEgressGateways = exports.getVpc = exports.deleteVpc = exports.createVpc = exports.listVpcs = exports.updateVolume = exports.getVolume = exports.deleteVolume = exports.createVolume = exports.listVolumes = exports.deleteVolumeTemplateVersion = exports.updateVolumeTemplate = exports.getVolumeTemplate = exports.deleteVolumeTemplate = exports.createVolumeTemplate = exports.listVolumeTemplates = exports.updateWorkspaceUserRole = exports.removeWorkspaceUser = exports.inviteWorkspaceUser = exports.listWorkspaceUsers = exports.getTemplate = exports.listTemplates = exports.deleteApiKeyForServiceAccount = exports.createApiKeyForServiceAccount = exports.listApiKeysForServiceAccount = exports.updateWorkspaceServiceAccount = exports.deleteWorkspaceServiceAccount = exports.createWorkspaceServiceAccount = exports.getWorkspaceServiceAccounts = exports.getSandboxByExternalId = exports.updateSandboxSchedule = exports.getSandboxSchedule = exports.deleteSandboxSchedule = exports.createSandboxSchedule = exports.listSandboxSchedules = void 0;
+exports.checkWorkspaceAvailability = void 0;
 const client_gen_1 = require("./client.gen");
 /**
  * List all agents
@@ -1782,6 +1783,116 @@ const deleteSandboxPreviewToken = (options) => {
     });
 };
 exports.deleteSandboxPreviewToken = deleteSandboxPreviewToken;
+/**
+ * List Sandbox Schedule Executions
+ * Returns the execution history of a Sandbox's schedules (across all schedules of the sandbox), newest first. Cursor-paginated via the `cursor` and `limit` query parameters. Each item records the HTTP status of submitting the scheduled command and the process name for log lookup.
+ */
+const listSandboxScheduleExecutions = (options) => {
+    return (options.client ?? client_gen_1.client).get({
+        security: [
+            {
+                scheme: 'bearer',
+                type: 'http'
+            }
+        ],
+        url: '/sandboxes/{sandboxName}/schedule-executions',
+        ...options
+    });
+};
+exports.listSandboxScheduleExecutions = listSandboxScheduleExecutions;
+/**
+ * List Sandbox Schedules
+ * Returns the schedules configured on a Sandbox. Starting with API version 2026-04-28 the response is wrapped in `{data, meta}` and supports cursor pagination via the `cursor` and `limit` query parameters; older versions return a bare array.
+ */
+const listSandboxSchedules = (options) => {
+    return (options.client ?? client_gen_1.client).get({
+        security: [
+            {
+                scheme: 'bearer',
+                type: 'http'
+            }
+        ],
+        url: '/sandboxes/{sandboxName}/schedules',
+        ...options
+    });
+};
+exports.listSandboxSchedules = listSandboxSchedules;
+/**
+ * Create Sandbox Schedule
+ * Adds a schedule to a Sandbox.
+ */
+const createSandboxSchedule = (options) => {
+    return (options.client ?? client_gen_1.client).post({
+        security: [
+            {
+                scheme: 'bearer',
+                type: 'http'
+            }
+        ],
+        url: '/sandboxes/{sandboxName}/schedules',
+        ...options,
+        headers: {
+            'Content-Type': 'application/json',
+            ...options?.headers
+        }
+    });
+};
+exports.createSandboxSchedule = createSandboxSchedule;
+/**
+ * Delete Sandbox Schedule
+ * Deletes a Sandbox Schedule by id.
+ */
+const deleteSandboxSchedule = (options) => {
+    return (options.client ?? client_gen_1.client).delete({
+        security: [
+            {
+                scheme: 'bearer',
+                type: 'http'
+            }
+        ],
+        url: '/sandboxes/{sandboxName}/schedules/{scheduleId}',
+        ...options
+    });
+};
+exports.deleteSandboxSchedule = deleteSandboxSchedule;
+/**
+ * Get Sandbox Schedule
+ * Returns a Sandbox Schedule by id.
+ */
+const getSandboxSchedule = (options) => {
+    return (options.client ?? client_gen_1.client).get({
+        security: [
+            {
+                scheme: 'bearer',
+                type: 'http'
+            }
+        ],
+        url: '/sandboxes/{sandboxName}/schedules/{scheduleId}',
+        ...options
+    });
+};
+exports.getSandboxSchedule = getSandboxSchedule;
+/**
+ * Update Sandbox Schedule
+ * Updates a Sandbox Schedule by id.
+ */
+const updateSandboxSchedule = (options) => {
+    return (options.client ?? client_gen_1.client).put({
+        security: [
+            {
+                scheme: 'bearer',
+                type: 'http'
+            }
+        ],
+        url: '/sandboxes/{sandboxName}/schedules/{scheduleId}',
+        ...options,
+        headers: {
+            'Content-Type': 'application/json',
+            ...options?.headers
+        }
+    });
+};
+exports.updateSandboxSchedule = updateSandboxSchedule;
 /**
  * Get sandbox by external ID
  * Returns the most recent non-terminated sandbox matching the given external ID. If no active sandbox is found, returns 404.

package/dist/cjs/common/pagination.js

@@ -0,0 +1,92 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.unwrapListData = unwrapListData;
+exports.createPaginatedList = createPaginatedList;
+function unwrapListData(response) {
+    if (!response) {
+        return [];
+    }
+    if (Array.isArray(response)) {
+        return response;
+    }
+    return response.data ?? [];
+}
+function unwrapListMeta(response) {
+    if (!response || Array.isArray(response)) {
+        return { hasMore: false };
+    }
+    return response.meta ?? { hasMore: false };
+}
+async function createPaginatedList({ response, fetchPage, mapItem, query, seenCursors, }) {
+    const meta = unwrapListMeta(response);
+    const data = await Promise.all(unwrapListData(response).map(mapItem));
+    const cursors = new Set(seenCursors);
+    if (query?.cursor) {
+        cursors.add(query.cursor);
+    }
+    const list = {
+        data,
+        meta,
+        // Derive `hasMore` from cursor presence, not `meta.hasMore`: `nextPage()`
+        // can only advance when there is a `nextCursor`, so a consumer doing
+        // `if (page.hasMore) await page.nextPage()` must never see `hasMore: true`
+        // while `nextPage()` returns null. Keeping the two in sync prevents silent
+        // truncation if the API ever sends `hasMore: true` without a cursor.
+        get hasMore() {
+            return Boolean(list.nextCursor);
+        },
+        get nextCursor() {
+            return meta.nextCursor || undefined;
+        },
+        async nextPage() {
+            const cursor = list.nextCursor;
+            if (!cursor) {
+                return null;
+            }
+            if (cursors.has(cursor)) {
+                throw new Error("Pagination returned a repeated cursor");
+            }
+            const nextQuery = { ...(query ?? {}), cursor };
+            const nextSeenCursors = new Set(cursors);
+            nextSeenCursors.add(cursor);
+            return createPaginatedList({
+                response: await fetchPage(nextQuery),
+                fetchPage,
+                mapItem,
+                query: nextQuery,
+                seenCursors: nextSeenCursors,
+            });
+        },
+        async autoPagingEach(onItem) {
+            for await (const item of list) {
+                const shouldContinue = await onItem(item);
+                if (shouldContinue === false) {
+                    return;
+                }
+            }
+        },
+        async autoPagingToArray(options) {
+            if (!options || !Number.isFinite(options.limit) || options.limit <= 0) {
+                throw new Error("autoPagingToArray requires a positive limit");
+            }
+            const items = [];
+            for await (const item of list) {
+                items.push(item);
+                if (items.length >= options.limit) {
+                    return items;
+                }
+            }
+            return items;
+        },
+        async *[Symbol.asyncIterator]() {
+            let page = list;
+            while (page) {
+                for (const item of page.data) {
+                    yield item;
+                }
+                page = await page.nextPage();
+            }
+        },
+    };
+    return list;
+}

package/dist/cjs/common/pagination.test.js

@@ -0,0 +1,81 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const pagination_js_1 = require("./pagination.js");
+(0, vitest_1.describe)("pagination helpers", () => {
+    (0, vitest_1.it)("unwraps legacy array and paginated list responses", () => {
+        (0, vitest_1.expect)((0, pagination_js_1.unwrapListData)([{ name: "legacy" }])).toEqual([{ name: "legacy" }]);
+        (0, vitest_1.expect)((0, pagination_js_1.unwrapListData)({
+            data: [{ name: "paginated" }],
+            meta: { hasMore: false },
+        })).toEqual([{ name: "paginated" }]);
+    });
+    (0, vitest_1.it)("returns page data and lets callers request the next page", async () => {
+        const cursors = [];
+        const fetchPage = async (query) => {
+            await Promise.resolve();
+            cursors.push(query?.cursor);
+            if (!query?.cursor) {
+                return {
+                    data: ["first"],
+                    meta: { hasMore: true, nextCursor: "next-page" },
+                };
+            }
+            return {
+                data: ["second"],
+                meta: { hasMore: false },
+            };
+        };
+        const page = await (0, pagination_js_1.createPaginatedList)({
+            response: await fetchPage(),
+            fetchPage,
+            mapItem: (item) => item.toUpperCase(),
+        });
+        (0, vitest_1.expect)(page.data).toEqual(["FIRST"]);
+        (0, vitest_1.expect)(page.hasMore).toBe(true);
+        (0, vitest_1.expect)(page.nextCursor).toBe("next-page");
+        const nextPage = await page.nextPage();
+        (0, vitest_1.expect)(nextPage?.data).toEqual(["SECOND"]);
+        (0, vitest_1.expect)(cursors).toEqual([undefined, "next-page"]);
+    });
+    (0, vitest_1.it)("keeps hasMore consistent with nextPage when the API omits a cursor", async () => {
+        const fetchPage = async () => {
+            await Promise.resolve();
+            // API reports more data but gives no cursor to fetch it.
+            return {
+                data: ["only"],
+                meta: { hasMore: true },
+            };
+        };
+        const page = await (0, pagination_js_1.createPaginatedList)({
+            response: await fetchPage(),
+            fetchPage,
+            mapItem: (item) => item,
+        });
+        // hasMore must reflect what nextPage() can actually deliver.
+        (0, vitest_1.expect)(page.hasMore).toBe(false);
+        await (0, vitest_1.expect)(page.nextPage()).resolves.toBeNull();
+        await (0, vitest_1.expect)(page.autoPagingToArray({ limit: 10 })).resolves.toEqual(["only"]);
+    });
+    (0, vitest_1.it)("supports auto paging with an explicit limit", async () => {
+        const fetchPage = async (query) => {
+            await Promise.resolve();
+            if (!query?.cursor) {
+                return {
+                    data: ["first"],
+                    meta: { hasMore: true, nextCursor: "next-page" },
+                };
+            }
+            return {
+                data: ["second"],
+                meta: { hasMore: false },
+            };
+        };
+        const page = await (0, pagination_js_1.createPaginatedList)({
+            response: await fetchPage(),
+            fetchPage,
+            mapItem: (item) => item,
+        });
+        await (0, vitest_1.expect)(page.autoPagingToArray({ limit: 2 })).resolves.toEqual(["first", "second"]);
+    });
+});

package/dist/cjs/common/settings.js

@@ -28,10 +28,10 @@ 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.2.96-preview.203";
-const BUILD_COMMIT = "a709e2f3c52a8973b18719ac1325f315896dabc0";
+const BUILD_VERSION = "0.2.96-preview.205";
+const BUILD_COMMIT = "b2439e6cde8dee15ff0ff166366670a4f48d8ade";
 const BUILD_SENTRY_DSN = "https://fd5e60e1c9820e1eef5ccebb84a07127@o4508714045276160.ingest.us.sentry.io/4510465864564736";
-const BLAXEL_API_VERSION = "2026-04-16";
+const BLAXEL_API_VERSION = "2026-04-28";
 // Cache for config.yaml tracking value
 let configTrackingValue = null;
 let configTrackingLoaded = false;

package/dist/cjs/common/settings.test.js

@@ -43,10 +43,10 @@ const env_js_1 = require("./env.js");
     (0, vitest_1.afterEach)(() => {
         delete env_js_1.env.BL_API_VERSION;
     });
-    (0, vitest_1.it)('defaults to 2026-04-16 when BL_API_VERSION is not set', async () => {
+    (0, vitest_1.it)('defaults to 2026-04-28 when BL_API_VERSION is not set', async () => {
         delete env_js_1.env.BL_API_VERSION;
         const { settings } = await Promise.resolve().then(() => __importStar(require('./settings.js')));
-        (0, vitest_1.expect)(settings.apiVersion).toBe('2026-04-16');
+        (0, vitest_1.expect)(settings.apiVersion).toBe('2026-04-28');
     });
     (0, vitest_1.it)('headers include Blaxel-Version set to the default', async () => {
         delete env_js_1.env.BL_API_VERSION;
@@ -55,7 +55,7 @@ const env_js_1 = require("./env.js");
         const previous = settings.credentials;
         settings.credentials = new apikey_js_1.ApiKey({ apiKey: 'test-key', workspace: 'test-ws' });
         try {
-            (0, vitest_1.expect)(settings.headers['Blaxel-Version']).toBe('2026-04-16');
+            (0, vitest_1.expect)(settings.headers['Blaxel-Version']).toBe('2026-04-28');
         }
         finally {
             settings.credentials = previous;

package/dist/cjs/drive/index.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.DriveInstance = 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 DriveInstance {
     drive;
@@ -90,10 +91,44 @@ class DriveInstance {
         });
         return new DriveInstance(data);
     }
-    static async list() {
-        const { data } = await (0, index_js_1.listDrives)({ throwOnError: true });
-        const items = Array.isArray(data) ? data : (data?.data ?? []);
-        return items.map((drive) => new DriveInstance(drive));
+    /**
+     * List one page of drives.
+     *
+     * 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 DriveInstance.list({ limit: 50 });
+     *
+     * for (const drive of page.data) {
+     *   console.log(drive.name);
+     * }
+     *
+     * const nextPage = await page.nextPage();
+     * ```
+     *
+     * @example
+     * ```ts
+     * const allDrives = await (await DriveInstance.list()).autoPagingToArray({
+     *   limit: 1000,
+     * });
+     * ```
+     */
+    static async list(query) {
+        const fetchPage = async (pageQuery) => {
+            const { data } = await (0, index_js_1.listDrives)({
+                query: pageQuery,
+                throwOnError: true,
+            });
+            return data;
+        };
+        return (0, pagination_js_1.createPaginatedList)({
+            response: await fetchPage(query),
+            fetchPage,
+            mapItem: (drive) => new DriveInstance(drive),
+            query,
+        });
     }
     static async delete(driveName) {
         const { data } = await (0, index_js_1.deleteDrive)({

package/dist/cjs/index.js

@@ -23,6 +23,7 @@ __exportStar(require("./common/node.js"), exports);
 __exportStar(require("./common/errors.js"), exports);
 __exportStar(require("./common/internal.js"), exports);
 __exportStar(require("./common/logger.js"), exports);
+__exportStar(require("./common/pagination.js"), exports);
 __exportStar(require("./common/settings.js"), exports);
 __exportStar(require("./common/webhook.js"), exports);
 __exportStar(require("./drive/index.js"), exports);

package/dist/cjs/jobs/jobs.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.blJob = void 0;
 const index_js_1 = require("../client/index.js");
 const logger_js_1 = require("../common/logger.js");
+const pagination_js_1 = require("../common/pagination.js");
 const settings_js_1 = require("../common/settings.js");
 const telemetry_js_1 = require("../telemetry/telemetry.js");
 class BlJob {
@@ -78,19 +79,50 @@ class BlJob {
         return data;
     }
     /**
-     * List all executions for this job
+     * List one page of executions for this job.
+     *
+     * 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 job = blJob("daily-import");
+     * const page = await job.listExecutions({ limit: 50 });
+     *
+     * for (const execution of page.data) {
+     *   console.log(execution.status);
+     * }
+     *
+     * const nextPage = await page.nextPage();
+     * ```
+     *
+     * @example
+     * ```ts
+     * const job = blJob("daily-import");
+     * const executions = await (await job.listExecutions()).autoPagingToArray({
+     *   limit: 1000,
+     * });
+     * ```
      */
-    async listExecutions() {
+    async listExecutions(query) {
         logger_js_1.logger.debug(`Listing executions for job: ${this.jobName}`);
-        const { data } = await (0, index_js_1.listJobExecutions)({
-            path: {
-                jobId: this.jobName,
-            },
-            headers: settings_js_1.settings.headers,
-            throwOnError: true,
+        const fetchPage = async (pageQuery) => {
+            const { data } = await (0, index_js_1.listJobExecutions)({
+                path: {
+                    jobId: this.jobName,
+                },
+                query: pageQuery,
+                headers: settings_js_1.settings.headers,
+                throwOnError: true,
+            });
+            return data;
+        };
+        return (0, pagination_js_1.createPaginatedList)({
+            response: await fetchPage(query),
+            fetchPage,
+            mapItem: (execution) => execution,
+            query,
         });
-        const items = Array.isArray(data) ? data : (data?.data ?? []);
-        return items;
     }
     /**
      * Get the status of a specific execution

package/dist/cjs/sandbox/client/sdk.gen.js

@@ -92,7 +92,7 @@ const getDrivesMount = (options) => {
 exports.getDrivesMount = getDrivesMount;
 /**
  * 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).
  */
 const postDrivesMount = (options) => {
     return (options.client ?? client_gen_1.client).post({
@@ -643,7 +643,7 @@ exports.getProcessByIdentifierLogsStream = getProcessByIdentifierLogsStream;
  * 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)
  */
 const postUpgrade = (options) => {

package/dist/cjs/sandbox/index.js

@@ -37,6 +37,7 @@ __exportStar(require("./codegen/index.js"), exports);
 var index_js_2 = require("./drive/index.js");
 Object.defineProperty(exports, "SandboxDrive", { enumerable: true, get: function () { return index_js_2.SandboxDrive; } });
 __exportStar(require("./preview.js"), exports);
+__exportStar(require("./schedule.js"), exports);
 __exportStar(require("./session.js"), exports);
 __exportStar(require("./sandbox.js"), exports);
 __exportStar(require("./system.js"), exports);

package/dist/cjs/sandbox/preview.js

@@ -105,24 +105,29 @@ class SandboxPreviews {
         });
         return data.map((preview) => new SandboxPreview(preview));
     }
-    async create(preview) {
+    async create(preview, force) {
+        const query = {};
+        if (force) {
+            query['force'] = 'true';
+        }
         const { data } = await (0, index_js_1.createSandboxPreview)({
             path: {
                 sandboxName: this.sandboxName,
             },
+            query,
             body: preview,
             throwOnError: true,
         });
         return new SandboxPreview(data);
     }
-    async createIfNotExists(preview) {
+    async createIfNotExists(preview, force) {
         try {
             const previewInstance = await this.get(preview.metadata.name);
             return previewInstance;
         }
         catch (e) {
             if (typeof e === "object" && e !== null && "code" in e && e.code === 404) {
-                return this.create(preview);
+                return this.create(preview, force);
             }
             throw e;
         }

package/dist/cjs/sandbox/sandbox.js

@@ -37,6 +37,7 @@ exports.SandboxInstance = void 0;
 const uuid_1 = require("uuid");
 const index_js_1 = require("../client/index.js");
 const logger_js_1 = require("../common/logger.js");
+const pagination_js_1 = require("../common/pagination.js");
 const settings_js_1 = require("../common/settings.js");
 const index_js_2 = require("./codegen/index.js");
 const index_js_3 = require("./drive/index.js");
@@ -44,6 +45,7 @@ const index_js_4 = require("./filesystem/index.js");
 const index_js_5 = require("./network/index.js");
 const preview_js_1 = require("./preview.js");
 const index_js_6 = require("./process/index.js");
+const schedule_js_1 = require("./schedule.js");
 const session_js_1 = require("./session.js");
 const system_js_1 = require("./system.js");
 const types_js_1 = require("./types.js");
@@ -77,6 +79,7 @@ class SandboxInstance {
     network;
     process;
     previews;
+    schedules;
     sessions;
     codegen;
     system;
@@ -88,6 +91,7 @@ class SandboxInstance {
         this.fs = new index_js_4.SandboxFileSystem(sandbox, this.process);
         this.network = new index_js_5.SandboxNetwork(sandbox);
         this.previews = new preview_js_1.SandboxPreviews(sandbox);
+        this.schedules = new schedule_js_1.SandboxSchedules(sandbox);
         this.sessions = new session_js_1.SandboxSessions(sandbox);
         this.codegen = new index_js_2.SandboxCodegen(sandbox);
         this.system = new system_js_1.SandboxSystem(sandbox);
@@ -280,40 +284,46 @@ class SandboxInstance {
         const instance = new SandboxInstance(data);
         return SandboxInstance.attachH2Session(instance);
     }
-    static async list({ externalId } = {}) {
-        const { data: raw } = await (0, index_js_1.listSandboxes)({
-            query: externalId ? { externalId } : undefined,
-            throwOnError: true,
+    /**
+     * 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 async list(query) {
+        const fetchPage = async (pageQuery) => {
+            const { data } = await (0, index_js_1.listSandboxes)({
+                query: pageQuery,
+                throwOnError: true,
+            });
+            return data;
+        };
+        return (0, pagination_js_1.createPaginatedList)({
+            response: await fetchPage(query),
+            fetchPage,
+            mapItem: (sandbox) => SandboxInstance.attachH2Session(new SandboxInstance(sandbox)),
+            query,
         });
-        const items = (Array.isArray(raw) ? raw : (raw?.data ?? []));
-        const instances = items.map((sb) => new SandboxInstance(sb));
-        if (!settings_js_1.settings.disableH2) {
-            const { h2Pool } = await Promise.resolve().then(() => __importStar(require("../common/h2pool.js")));
-            const uniqueDomains = [
-                ...new Set(instances
-                    .map((i) => SandboxInstance.edgeDomainForRegion(i.spec?.region))
-                    .filter((d) => d !== null)),
-            ];
-            const sessionByDomain = new Map();
-            await Promise.all(uniqueDomains.map(async (domain) => {
-                try {
-                    sessionByDomain.set(domain, await h2Pool.get(domain));
-                }
-                catch {
-                    sessionByDomain.set(domain, null);
-                }
-            }));
-            for (const instance of instances) {
-                const domain = SandboxInstance.edgeDomainForRegion(instance.spec?.region);
-                if (domain) {
-                    const session = sessionByDomain.get(domain) ?? null;
-                    instance.h2Session = session;
-                    instance.sandbox.h2Session = session;
-                    instance.sandbox.h2Domain = domain;
-                }
-            }
-        }
-        return instances;
     }
     static async delete(sandboxName) {
         const { data } = await (0, index_js_1.deleteSandbox)({