@blaxel/core 0.3.20 → 0.3.21

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

@@ -3,8 +3,8 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 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.getDriveByExternalId = exports.createDriveAccessToken = exports.updateDrive = exports.getDrive = exports.deleteDrive = exports.createDrive = exports.listDrives = exports.verifyCustomDomain = exports.unshareCustomDomain = exports.shareCustomDomain = exports.listCustomDomainShares = exports.updateCustomDomain = exports.getCustomDomain = exports.deleteCustomDomain = exports.createCustomDomain = exports.listCustomDomains = exports.getConfiguration = exports.getChangelog = 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.createSandboxPreview = exports.listSandboxPreviews = exports.forkSandbox = exports.archiveSandbox = 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 = exports.createIntegrationConnection = exports.listIntegrationConnections = exports.getIntegration = exports.deleteImageTag = exports.unshareImage = void 0;
-exports.getVpc = exports.deleteVpc = exports.createVpc = exports.listVpcs = exports.getVolumeByExternalId = 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.getSandboxScheduleMetrics = exports.listSchedules = exports.listScheduleExecutions = exports.getSandboxByExternalId = exports.unarchiveSandbox = exports.restoreSandboxSnapshot = exports.deleteSandboxSnapshot = exports.createSandboxSnapshot = exports.listSandboxSnapshots = exports.updateSandboxSchedule = exports.getSandboxSchedule = exports.deleteSandboxSchedule = exports.createSandboxSchedule = exports.listSandboxSchedules = exports.listSandboxScheduleExecutions = exports.deleteSandboxPreviewToken = exports.createSandboxPreviewToken = exports.listSandboxPreviewTokens = exports.updateSandboxPreview = exports.getSandboxPreview = exports.deleteSandboxPreview = void 0;
-exports.checkWorkspaceAvailability = exports.leaveWorkspace = 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 = void 0;
+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.forkSnapshot = exports.getSnapshot = exports.deleteSnapshot = exports.createSnapshot = exports.listSnapshots = exports.deleteApiKeyForServiceAccount = exports.createApiKeyForServiceAccount = exports.listApiKeysForServiceAccount = exports.updateWorkspaceServiceAccount = exports.deleteWorkspaceServiceAccount = exports.createWorkspaceServiceAccount = exports.getWorkspaceServiceAccounts = exports.getSandboxScheduleMetrics = exports.listSchedules = exports.listScheduleExecutions = exports.getSandboxByExternalId = exports.unarchiveSandbox = exports.restoreSandboxSnapshot = exports.deleteSandboxSnapshot = exports.createSandboxSnapshot = exports.listSandboxSnapshots = exports.updateSandboxSchedule = exports.getSandboxSchedule = exports.deleteSandboxSchedule = exports.createSandboxSchedule = exports.listSandboxSchedules = exports.listSandboxScheduleExecutions = exports.deleteSandboxPreviewToken = exports.createSandboxPreviewToken = exports.listSandboxPreviewTokens = exports.updateSandboxPreview = exports.getSandboxPreview = exports.deleteSandboxPreview = void 0;
+exports.checkWorkspaceAvailability = exports.leaveWorkspace = 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.getVolumeByExternalId = void 0;
 const client_gen_1 = require("./client.gen");
 /**
  * List all agents
@@ -2302,6 +2302,99 @@ const deleteApiKeyForServiceAccount = (options) => {
     });
 };
 exports.deleteApiKeyForServiceAccount = deleteApiKeyForServiceAccount;
+/**
+ * List snapshots
+ * Returns the snapshots of the workspace, newest first by default, including the ones whose source object has been deleted. 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 keep returning a bare array.
+ */
+const listSnapshots = (options) => {
+    return (options?.client ?? client_gen_1.client).get({
+        security: [
+            {
+                scheme: 'bearer',
+                type: 'http'
+            }
+        ],
+        url: '/snapshots',
+        ...options
+    });
+};
+exports.listSnapshots = listSnapshots;
+/**
+ * Create snapshot
+ * Captures a snapshot from a source object. The snapshot belongs to the workspace rather than to its source, so it survives the deletion of the object it was captured from, and carries what creating a sandbox or an application from it needs.
+ */
+const createSnapshot = (options) => {
+    return (options.client ?? client_gen_1.client).post({
+        security: [
+            {
+                scheme: 'bearer',
+                type: 'http'
+            }
+        ],
+        url: '/snapshots',
+        ...options,
+        headers: {
+            'Content-Type': 'application/json',
+            ...options?.headers
+        }
+    });
+};
+exports.createSnapshot = createSnapshot;
+/**
+ * Delete snapshot
+ * Deletes a snapshot. There is a single snapshot object, so this removes it for the whole workspace, whether or not the object it was captured from still exists.
+ */
+const deleteSnapshot = (options) => {
+    return (options.client ?? client_gen_1.client).delete({
+        security: [
+            {
+                scheme: 'bearer',
+                type: 'http'
+            }
+        ],
+        url: '/snapshots/{snapshotName}',
+        ...options
+    });
+};
+exports.deleteSnapshot = deleteSnapshot;
+/**
+ * Get snapshot
+ * Returns a snapshot of the workspace by name.
+ */
+const getSnapshot = (options) => {
+    return (options.client ?? client_gen_1.client).get({
+        security: [
+            {
+                scheme: 'bearer',
+                type: 'http'
+            }
+        ],
+        url: '/snapshots/{snapshotName}',
+        ...options
+    });
+};
+exports.getSnapshot = getSnapshot;
+/**
+ * Fork snapshot
+ * Creates a new sandbox or application from a snapshot. The snapshot is enough on its own, so this works after the object it was captured from has been deleted.
+ */
+const forkSnapshot = (options) => {
+    return (options.client ?? client_gen_1.client).post({
+        security: [
+            {
+                scheme: 'bearer',
+                type: 'http'
+            }
+        ],
+        url: '/snapshots/{snapshotName}/fork',
+        ...options,
+        headers: {
+            'Content-Type': 'application/json',
+            ...options?.headers
+        }
+    });
+};
+exports.forkSnapshot = forkSnapshot;
 /**
  * List deployment templates
  * Returns all deployment templates available for creating agents, functions, and other resources with pre-configured settings and code.

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.20";
-const BUILD_COMMIT = "0be98e0951c3607a16d4c40b7612ad7a8c147703";
+const BUILD_VERSION = "0.3.21";
+const BUILD_COMMIT = "3ccc635cd5e9e15a606e3b4c4ae618f992bf4eed";
 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/index.js

@@ -34,6 +34,7 @@ __exportStar(require("./jobs/index.js"), exports);
 __exportStar(require("./mcp/index.js"), exports);
 __exportStar(require("./models/index.js"), exports);
 __exportStar(require("./sandbox/index.js"), exports);
+__exportStar(require("./snapshot/index.js"), exports);
 __exportStar(require("./telemetry/telemetry.js"), exports);
 __exportStar(require("./tools/index.js"), exports);
 __exportStar(require("./tools/types.js"), exports);

package/dist/cjs/sandbox/index.js

@@ -43,6 +43,7 @@ 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("./snapshot.js"), exports);
 __exportStar(require("./session.js"), exports);
 __exportStar(require("./sandbox.js"), exports);
 __exportStar(require("./system.js"), exports);

package/dist/cjs/sandbox/sandbox.js

@@ -46,6 +46,7 @@ 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 snapshot_js_1 = require("./snapshot.js");
 const session_js_1 = require("./session.js");
 const system_js_1 = require("./system.js");
 const types_js_1 = require("./types.js");
@@ -110,6 +111,7 @@ class SandboxInstance {
     codegen;
     system;
     drives;
+    snapshots;
     h2Session;
     constructor(sandbox) {
         this.sandbox = sandbox;
@@ -122,6 +124,7 @@ class SandboxInstance {
         this.codegen = new index_js_2.SandboxCodegen(sandbox);
         this.system = new system_js_1.SandboxSystem(sandbox);
         this.drives = new index_js_3.SandboxDrive(sandbox);
+        this.snapshots = new snapshot_js_1.SandboxSnapshotsResource(sandbox);
         this.h2Session = null;
     }
     get metadata() {
@@ -195,6 +198,7 @@ class SandboxInstance {
      * sandbox state and can be forked into new sandboxes or applications.
      *
      * @param name - Optional human-readable name for the snapshot.
+     * @deprecated Use `sandbox.snapshots.create(name)`.
      */
     async snapshot(name) {
         const { data } = await (0, index_js_1.createSandboxSnapshot)({
@@ -206,6 +210,8 @@ class SandboxInstance {
     }
     /**
      * List the snapshots of this sandbox.
+     *
+     * @deprecated Use `sandbox.snapshots.list()`.
      */
     async listSnapshots() {
         const { data } = await (0, index_js_1.listSandboxSnapshots)({
@@ -216,6 +222,8 @@ class SandboxInstance {
     }
     /**
      * Delete a snapshot of this sandbox by its ID.
+     *
+     * @deprecated Use `sandbox.snapshots.delete(name)`.
      */
     async deleteSnapshot(snapshotId) {
         await (0, index_js_1.deleteSandboxSnapshot)({
@@ -233,6 +241,7 @@ class SandboxInstance {
      * is: connections to a sandbox still resuming are retried by the gateway.
      *
      * @param snapshotId - ID of the snapshot to restore this sandbox to.
+     * @deprecated Use `sandbox.snapshots.restore(name)`.
      */
     async restore(snapshotId) {
         const { data } = await (0, index_js_1.restoreSandboxSnapshot)({

package/dist/cjs/sandbox/snapshot.js

@@ -0,0 +1,77 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SandboxSnapshotsResource = void 0;
+const index_js_1 = require("../client/index.js");
+const index_js_2 = require("../snapshot/index.js");
+/**
+ * SandboxSnapshotsResource is the sandbox's view of the workspace's snapshots: the
+ * ones captured from it. A snapshot itself belongs to the workspace, so
+ * deleting one here deletes it everywhere, and it stays after this sandbox is
+ * deleted.
+ */
+class SandboxSnapshotsResource {
+    sandbox;
+    constructor(sandbox) {
+        this.sandbox = sandbox;
+    }
+    get sandboxName() {
+        return this.sandbox.metadata.name;
+    }
+    /**
+     * Capture a snapshot of the sandbox.
+     *
+     * @param name - Name of the snapshot, unique among this sandbox's
+     * snapshots. Generated when omitted.
+     */
+    async create(name) {
+        return await index_js_2.Snapshot.create({
+            ...(name !== undefined ? { name } : {}),
+            source: { name: this.sandboxName, kind: "sandbox" },
+        });
+    }
+    /** List the snapshots captured from this sandbox. */
+    async list() {
+        const { data } = await (0, index_js_1.listSandboxSnapshots)({
+            path: { sandboxName: this.sandboxName },
+            throwOnError: true,
+        });
+        return data.map((snapshot) => new index_js_2.Snapshot(snapshot));
+    }
+    /**
+     * Find a snapshot captured from this sandbox by its name, or by its
+     * identifier. Names are only unique within the sandbox, which is why the
+     * workspace-level `Snapshot.get` takes the identifier instead.
+     */
+    async get(snapshotName) {
+        const snapshots = await this.list();
+        const found = snapshots.find((s) => s.name === snapshotName || s.id === snapshotName);
+        if (!found) {
+            throw new Error(`Snapshot ${snapshotName} not found on sandbox ${this.sandboxName}`);
+        }
+        return found;
+    }
+    /**
+     * Delete a snapshot captured from this sandbox. The snapshot is a workspace
+     * object, so it is removed for the whole workspace.
+     */
+    async delete(snapshotName) {
+        await (0, index_js_1.deleteSandboxSnapshot)({
+            path: { sandboxName: this.sandboxName, snapshotId: snapshotName },
+            throwOnError: true,
+        });
+    }
+    /**
+     * Restore the sandbox to one of its snapshots. The sandbox keeps its name,
+     * its URLs and its previews: the running instance is torn down and rebuilt
+     * from the snapshot, so everything written since it was taken is lost unless
+     * it was snapshotted too.
+     */
+    async restore(snapshotName) {
+        const { data } = await (0, index_js_1.restoreSandboxSnapshot)({
+            path: { sandboxName: this.sandboxName, snapshotId: snapshotName },
+            throwOnError: true,
+        });
+        return data;
+    }
+}
+exports.SandboxSnapshotsResource = SandboxSnapshotsResource;

package/dist/cjs/snapshot/index.js

@@ -0,0 +1,145 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Snapshot = void 0;
+const index_js_1 = require("../client/index.js");
+const pagination_js_1 = require("../common/pagination.js");
+/**
+ * A snapshot is a workspace resource: it is captured from a sandbox, but it
+ * outlives it. Deleting the sandbox it came from leaves the snapshot in place,
+ * with `source.deleted` set, and it still carries what a fork needs to run.
+ */
+class Snapshot {
+    snapshot;
+    constructor(snapshot) {
+        this.snapshot = snapshot;
+    }
+    get name() {
+        return this.snapshot.name;
+    }
+    /** Identifier of the snapshot on the compute plane. */
+    get id() {
+        return this.snapshot.id;
+    }
+    get status() {
+        return this.snapshot.status;
+    }
+    get workspace() {
+        return this.snapshot.workspace;
+    }
+    get createdAt() {
+        return this.snapshot.createdAt;
+    }
+    /** The object the snapshot was captured from, and whether it still exists. */
+    get source() {
+        return this.snapshot.source;
+    }
+    /** The configuration a fork of this snapshot runs with. */
+    get spec() {
+        return this.snapshot.spec;
+    }
+    /**
+     * Capture a snapshot of a source object.
+     *
+     * @example
+     * ```ts
+     * const snapshot = await Snapshot.create({
+     *   name: "my-snapshot",
+     *   source: { name: "my-sandbox" },
+     * });
+     * ```
+     */
+    static async create(config) {
+        const { data } = await (0, index_js_1.createSnapshot)({
+            body: {
+                ...(config.name !== undefined ? { name: config.name } : {}),
+                source: {
+                    name: config.source.name,
+                    ...(config.source.kind !== undefined ? { kind: config.source.kind } : {}),
+                },
+            },
+            throwOnError: true,
+        });
+        return new Snapshot(data);
+    }
+    /**
+     * Fetch a snapshot by its identifier (`snapshot.id`). Names are only unique
+     * within the sandbox they were captured from, so the workspace-level routes
+     * take the identifier; use `sandbox.snapshots.get(name)` to address one by
+     * name.
+     */
+    static async get(snapshotId) {
+        const { data } = await (0, index_js_1.getSnapshot)({
+            path: { snapshotName: snapshotId },
+            throwOnError: true,
+        });
+        return new Snapshot(data);
+    }
+    /**
+     * List one page of the workspace's snapshots.
+     *
+     * The returned page exposes `data` for the current page, `meta` for cursor
+     * metadata, and `nextPage()` / `autoPagingEach()` / `autoPagingToArray()`
+     * helpers. Iterate it directly with `for await` to walk every page.
+     *
+     * @example
+     * ```ts
+     * const page = await Snapshot.list({ limit: 50 });
+     * for await (const snapshot of page) {
+     *   console.log(snapshot.name);
+     * }
+     * ```
+     */
+    static async list(query) {
+        const fetchPage = async (pageQuery) => {
+            const { data } = await (0, index_js_1.listSnapshots)({
+                query: pageQuery,
+                throwOnError: true,
+            });
+            return data;
+        };
+        return (0, pagination_js_1.createPaginatedList)({
+            response: await fetchPage(query),
+            fetchPage,
+            mapItem: (snapshot) => new Snapshot(snapshot),
+            query,
+        });
+    }
+    /**
+     * Delete a snapshot. There is one snapshot object, so this removes it for
+     * the whole workspace, whether or not the sandbox it came from still exists.
+     */
+    static async delete(snapshotId) {
+        const { data } = await (0, index_js_1.deleteSnapshot)({
+            path: { snapshotName: snapshotId },
+            throwOnError: true,
+        });
+        return data;
+    }
+    async delete() {
+        return await Snapshot.delete(this.id);
+    }
+    /**
+     * Create a sandbox or an application from this snapshot. This works after
+     * the sandbox the snapshot was captured from has been deleted.
+     *
+     * @param targetName - Name of the sandbox/application to create.
+     * @param options - Fork options (target type, port, traffic, ...).
+     */
+    async fork(targetName, options = {}) {
+        const { data } = await (0, index_js_1.forkSnapshot)({
+            path: { snapshotName: this.id },
+            body: {
+                targetName,
+                targetType: options.targetType ?? "sandbox",
+                ...(options.port !== undefined ? { port: options.port } : {}),
+                ...(options.traffic !== undefined ? { traffic: options.traffic } : {}),
+                ...(options.customDomain !== undefined ? { customDomain: options.customDomain } : {}),
+                ...(options.prefix !== undefined ? { prefix: options.prefix } : {}),
+                ...(options.envs !== undefined ? { envs: options.envs } : {}),
+            },
+            throwOnError: true,
+        });
+        return data;
+    }
+}
+exports.Snapshot = Snapshot;

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

@@ -1,5 +1,5 @@
 import type { Options as ClientOptions, TDataShape, Client } from '@hey-api/client-fetch';
-import type { ListAgentsData, CreateAgentData, DeleteAgentData, GetAgentData, UpdateAgentData, ListAgentRevisionsData, ListApplicationsData, CreateApplicationData, DeleteApplicationData, GetApplicationData, UpdateApplicationData, CreateApplicationCustomDomainData, ListApplicationRevisionsData, GetChangelogData, GetConfigurationData, ListCustomDomainsData, CreateCustomDomainData, DeleteCustomDomainData, GetCustomDomainData, UpdateCustomDomainData, ListCustomDomainSharesData, ShareCustomDomainData, UnshareCustomDomainData, VerifyCustomDomainData, ListDrivesData, CreateDriveData, DeleteDriveData, GetDriveData, UpdateDriveData, CreateDriveAccessTokenData, GetDriveByExternalIdData, GetDriveJwksData, ListAllEgressGatewaysData, GetEgressGatewayUsageData, ListAllEgressIpsData, GetWorkspaceFeaturesData, TestFeatureFlagData, ListFunctionsData, CreateFunctionData, DeleteFunctionData, GetFunctionData, UpdateFunctionData, ListFunctionRevisionsData, CleanupImagesData, ListImagesData, CreateImageData, DeleteImageData, GetImageData, ListImageSharesData, ShareImageData, ShareImageResponse, UnshareImageData, DeleteImageTagData, GetIntegrationData, ListIntegrationConnectionsData, CreateIntegrationConnectionData, DeleteIntegrationConnectionData, GetIntegrationConnectionData, UpdateIntegrationConnectionData, GetIntegrationConnectionModelEndpointConfigurationsData, ListIntegrationConnectionModelsData, GetIntegrationConnectionModelData, ListJobsData, CreateJobData, DeleteJobData, GetJobData, UpdateJobData, ListJobExecutionsData, CreateJobExecutionData, DeleteJobExecutionData, GetJobExecutionData, ListJobExecutionTasksData, ListJobRevisionsData, ListLocationsData, ListMcpHubDefinitionsData, ListModelsData, CreateModelData, DeleteModelData, GetModelData, UpdateModelData, ListModelRevisionsData, ListPendingImageSharesData, AcceptImageShareData, DeclineImageShareData, ListPoliciesData, CreatePolicyData, DeletePolicyData, GetPolicyData, UpdatePolicyData, GetPolicyUsagesData, ListPublicIpsData, ListSandboxHubDefinitionsData, ListSandboxesData, CreateSandboxData, DeleteSandboxData, GetSandboxData, UpdateSandboxData, ArchiveSandboxData, ForkSandboxData, ListSandboxPreviewsData, CreateSandboxPreviewData, DeleteSandboxPreviewData, GetSandboxPreviewData, UpdateSandboxPreviewData, ListSandboxPreviewTokensData, CreateSandboxPreviewTokenData, DeleteSandboxPreviewTokenData, ListSandboxScheduleExecutionsData, ListSandboxSchedulesData, CreateSandboxScheduleData, DeleteSandboxScheduleData, GetSandboxScheduleData, UpdateSandboxScheduleData, ListSandboxSnapshotsData, CreateSandboxSnapshotData, DeleteSandboxSnapshotData, RestoreSandboxSnapshotData, UnarchiveSandboxData, GetSandboxByExternalIdData, ListScheduleExecutionsData, ListSchedulesData, GetSandboxScheduleMetricsData, GetWorkspaceServiceAccountsData, CreateWorkspaceServiceAccountData, DeleteWorkspaceServiceAccountData, UpdateWorkspaceServiceAccountData, ListApiKeysForServiceAccountData, CreateApiKeyForServiceAccountData, DeleteApiKeyForServiceAccountData, ListTemplatesData, GetTemplateData, ListWorkspaceUsersData, InviteWorkspaceUserData, RemoveWorkspaceUserData, UpdateWorkspaceUserRoleData, ListVolumeTemplatesData, CreateVolumeTemplateData, DeleteVolumeTemplateData, GetVolumeTemplateData, UpdateVolumeTemplateData, DeleteVolumeTemplateVersionData, ListVolumesData, CreateVolumeData, DeleteVolumeData, GetVolumeData, UpdateVolumeData, GetVolumeByExternalIdData, ListVpcsData, CreateVpcData, DeleteVpcData, GetVpcData, ListEgressGatewaysData, CreateEgressGatewayData, DeleteEgressGatewayData, GetEgressGatewayData, ListEgressIpsData, CreateEgressIpData, DeleteEgressIpData, GetEgressIpData, ListWorkspacesData, CreateWorkspaceData, DeleteWorkspaceData, GetWorkspaceData, UpdateWorkspaceData, LeaveWorkspaceData, CheckWorkspaceAvailabilityData } from './types.gen.js';
+import type { ListAgentsData, CreateAgentData, DeleteAgentData, GetAgentData, UpdateAgentData, ListAgentRevisionsData, ListApplicationsData, CreateApplicationData, DeleteApplicationData, GetApplicationData, UpdateApplicationData, CreateApplicationCustomDomainData, ListApplicationRevisionsData, GetChangelogData, GetConfigurationData, ListCustomDomainsData, CreateCustomDomainData, DeleteCustomDomainData, GetCustomDomainData, UpdateCustomDomainData, ListCustomDomainSharesData, ShareCustomDomainData, UnshareCustomDomainData, VerifyCustomDomainData, ListDrivesData, CreateDriveData, DeleteDriveData, GetDriveData, UpdateDriveData, CreateDriveAccessTokenData, GetDriveByExternalIdData, GetDriveJwksData, ListAllEgressGatewaysData, GetEgressGatewayUsageData, ListAllEgressIpsData, GetWorkspaceFeaturesData, TestFeatureFlagData, ListFunctionsData, CreateFunctionData, DeleteFunctionData, GetFunctionData, UpdateFunctionData, ListFunctionRevisionsData, CleanupImagesData, ListImagesData, CreateImageData, DeleteImageData, GetImageData, ListImageSharesData, ShareImageData, ShareImageResponse, UnshareImageData, DeleteImageTagData, GetIntegrationData, ListIntegrationConnectionsData, CreateIntegrationConnectionData, DeleteIntegrationConnectionData, GetIntegrationConnectionData, UpdateIntegrationConnectionData, GetIntegrationConnectionModelEndpointConfigurationsData, ListIntegrationConnectionModelsData, GetIntegrationConnectionModelData, ListJobsData, CreateJobData, DeleteJobData, GetJobData, UpdateJobData, ListJobExecutionsData, CreateJobExecutionData, DeleteJobExecutionData, GetJobExecutionData, ListJobExecutionTasksData, ListJobRevisionsData, ListLocationsData, ListMcpHubDefinitionsData, ListModelsData, CreateModelData, DeleteModelData, GetModelData, UpdateModelData, ListModelRevisionsData, ListPendingImageSharesData, AcceptImageShareData, DeclineImageShareData, ListPoliciesData, CreatePolicyData, DeletePolicyData, GetPolicyData, UpdatePolicyData, GetPolicyUsagesData, ListPublicIpsData, ListSandboxHubDefinitionsData, ListSandboxesData, CreateSandboxData, DeleteSandboxData, GetSandboxData, UpdateSandboxData, ArchiveSandboxData, ForkSandboxData, ListSandboxPreviewsData, CreateSandboxPreviewData, DeleteSandboxPreviewData, GetSandboxPreviewData, UpdateSandboxPreviewData, ListSandboxPreviewTokensData, CreateSandboxPreviewTokenData, DeleteSandboxPreviewTokenData, ListSandboxScheduleExecutionsData, ListSandboxSchedulesData, CreateSandboxScheduleData, DeleteSandboxScheduleData, GetSandboxScheduleData, UpdateSandboxScheduleData, ListSandboxSnapshotsData, CreateSandboxSnapshotData, DeleteSandboxSnapshotData, RestoreSandboxSnapshotData, UnarchiveSandboxData, GetSandboxByExternalIdData, ListScheduleExecutionsData, ListSchedulesData, GetSandboxScheduleMetricsData, GetWorkspaceServiceAccountsData, CreateWorkspaceServiceAccountData, DeleteWorkspaceServiceAccountData, UpdateWorkspaceServiceAccountData, ListApiKeysForServiceAccountData, CreateApiKeyForServiceAccountData, DeleteApiKeyForServiceAccountData, ListSnapshotsData, CreateSnapshotData, DeleteSnapshotData, GetSnapshotData, ForkSnapshotData, ListTemplatesData, GetTemplateData, ListWorkspaceUsersData, InviteWorkspaceUserData, RemoveWorkspaceUserData, UpdateWorkspaceUserRoleData, ListVolumeTemplatesData, CreateVolumeTemplateData, DeleteVolumeTemplateData, GetVolumeTemplateData, UpdateVolumeTemplateData, DeleteVolumeTemplateVersionData, ListVolumesData, CreateVolumeData, DeleteVolumeData, GetVolumeData, UpdateVolumeData, GetVolumeByExternalIdData, ListVpcsData, CreateVpcData, DeleteVpcData, GetVpcData, ListEgressGatewaysData, CreateEgressGatewayData, DeleteEgressGatewayData, GetEgressGatewayData, ListEgressIpsData, CreateEgressIpData, DeleteEgressIpData, GetEgressIpData, ListWorkspacesData, CreateWorkspaceData, DeleteWorkspaceData, GetWorkspaceData, UpdateWorkspaceData, LeaveWorkspaceData, CheckWorkspaceAvailabilityData } from './types.gen.js';
 export type Options<TData extends TDataShape = TDataShape, ThrowOnError extends boolean = boolean> = ClientOptions<TData, ThrowOnError> & {
     /**
      * You can provide a client instance returned by `createClient()` instead of
@@ -703,6 +703,31 @@ export declare const createApiKeyForServiceAccount: <ThrowOnError extends boolea
  * Revokes an API key for a service account. The key becomes invalid immediately and any requests using it will fail authentication.
  */
 export declare const deleteApiKeyForServiceAccount: <ThrowOnError extends boolean = false>(options: Options<DeleteApiKeyForServiceAccountData, ThrowOnError>) => import("@hey-api/client-fetch").RequestResult<unknown, unknown, ThrowOnError>;
+/**
+ * List snapshots
+ * Returns the snapshots of the workspace, newest first by default, including the ones whose source object has been deleted. 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 keep returning a bare array.
+ */
+export declare const listSnapshots: <ThrowOnError extends boolean = false>(options?: Options<ListSnapshotsData, ThrowOnError>) => import("@hey-api/client-fetch").RequestResult<import("./types.gen.js").SandboxSnapshotList, import("./types.gen.js")._Error, ThrowOnError>;
+/**
+ * Create snapshot
+ * Captures a snapshot from a source object. The snapshot belongs to the workspace rather than to its source, so it survives the deletion of the object it was captured from, and carries what creating a sandbox or an application from it needs.
+ */
+export declare const createSnapshot: <ThrowOnError extends boolean = false>(options: Options<CreateSnapshotData, ThrowOnError>) => import("@hey-api/client-fetch").RequestResult<import("./types.gen.js").SandboxSnapshot, import("./types.gen.js")._Error, ThrowOnError>;
+/**
+ * Delete snapshot
+ * Deletes a snapshot. There is a single snapshot object, so this removes it for the whole workspace, whether or not the object it was captured from still exists.
+ */
+export declare const deleteSnapshot: <ThrowOnError extends boolean = false>(options: Options<DeleteSnapshotData, ThrowOnError>) => import("@hey-api/client-fetch").RequestResult<void, import("./types.gen.js")._Error, ThrowOnError>;
+/**
+ * Get snapshot
+ * Returns a snapshot of the workspace by name.
+ */
+export declare const getSnapshot: <ThrowOnError extends boolean = false>(options: Options<GetSnapshotData, ThrowOnError>) => import("@hey-api/client-fetch").RequestResult<import("./types.gen.js").SandboxSnapshot, import("./types.gen.js")._Error, ThrowOnError>;
+/**
+ * Fork snapshot
+ * Creates a new sandbox or application from a snapshot. The snapshot is enough on its own, so this works after the object it was captured from has been deleted.
+ */
+export declare const forkSnapshot: <ThrowOnError extends boolean = false>(options: Options<ForkSnapshotData, ThrowOnError>) => import("@hey-api/client-fetch").RequestResult<import("./types.gen.js").SandboxForkResponse, import("./types.gen.js")._Error, ThrowOnError>;
 /**
  * List deployment templates
  * Returns all deployment templates available for creating agents, functions, and other resources with pre-configured settings and code.