@blaxel/core 0.2.90-dev.181 → 0.2.90-preview.183

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

@@ -1,13 +1,13 @@
 "use strict";
 // This file is auto-generated by @hey-api/openapi-ts
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.listJobs = exports.getIntegrationConnectionModel = exports.listIntegrationConnectionModels = exports.getIntegrationConnectionModelEndpointConfigurations = exports.updateIntegrationConnection = exports.getIntegrationConnection = exports.deleteIntegrationConnection = 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.listAgentRevisions = exports.updateAgent = exports.getAgent = exports.deleteAgent = exports.createAgent = exports.listAgents = void 0;
-exports.listTemplates = exports.deleteApiKeyForServiceAccount = exports.createApiKeyForServiceAccount = exports.listApiKeysForServiceAccount = exports.updateWorkspaceServiceAccount = exports.deleteWorkspaceServiceAccount = exports.createWorkspaceServiceAccount = exports.getWorkspaceServiceAccounts = 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 = 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 = void 0;
+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 = 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.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.listAgentRevisions = exports.updateAgent = exports.getAgent = exports.deleteAgent = exports.createAgent = exports.listAgents = void 0;
+exports.inviteWorkspaceUser = exports.listWorkspaceUsers = exports.getTemplate = exports.listTemplates = exports.deleteApiKeyForServiceAccount = exports.createApiKeyForServiceAccount = exports.listApiKeysForServiceAccount = exports.updateWorkspaceServiceAccount = exports.deleteWorkspaceServiceAccount = exports.createWorkspaceServiceAccount = exports.getWorkspaceServiceAccounts = 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.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.getJobExecution = exports.deleteJobExecution = exports.createJobExecution = exports.listJobExecutions = exports.updateJob = exports.getJob = exports.deleteJob = 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 = void 0;
 const client_gen_1 = require("./client.gen");
 /**
  * List all agents
- * Returns AI agents deployed in the workspace. Each agent includes its deployment status, runtime configuration, and global inference endpoint URL. 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 with all agents.
+ * Returns all AI agents deployed in the workspace. Each agent includes its deployment status, runtime configuration, and global inference endpoint URL.
  */
 const listAgents = (options) => {
     return (options?.client ?? client_gen_1.client).get({
@@ -239,7 +239,7 @@ const verifyCustomDomain = (options) => {
 exports.verifyCustomDomain = verifyCustomDomain;
 /**
  * List drives
- * Returns all drives in the workspace. Drives provide persistent storage that can be attached to agents, functions, and sandboxes. Starting with API version 2026-04-28, the response wraps items in `{data, meta}` and supports cursor pagination via the `cursor` and `limit` query parameters; older versions keep returning a bare array with all drives.
+ * Returns all drives in the workspace. Drives provide persistent storage that can be attached to agents, functions, and sandboxes.
  */
 const listDrives = (options) => {
     return (options?.client ?? client_gen_1.client).get({
@@ -374,23 +374,6 @@ const listAllEgressGateways = (options) => {
     });
 };
 exports.listAllEgressGateways = listAllEgressGateways;
-/**
- * Egress gateway sandbox attachments
- * Returns the inverse map (gateway → sandbox names) for the workspace. Used by the egress-IPs UI to render attachment counts without fetching the sandboxes listing full client-side.
- */
-const getEgressGatewayUsage = (options) => {
-    return (options?.client ?? client_gen_1.client).get({
-        security: [
-            {
-                scheme: 'bearer',
-                type: 'http'
-            }
-        ],
-        url: '/egressgateways/usage',
-        ...options
-    });
-};
-exports.getEgressGatewayUsage = getEgressGatewayUsage;
 /**
  * List all egress IPs across all VPCs and gateways in the workspace
  */
@@ -443,7 +426,7 @@ const testFeatureFlag = (options) => {
 exports.testFeatureFlag = testFeatureFlag;
 /**
  * List all MCP servers
- * Returns MCP server functions deployed in the workspace. Each function includes its deployment status, transport protocol (websocket or http-stream), and endpoint URL. 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 with all functions.
+ * Returns all MCP server functions deployed in the workspace. Each function includes its deployment status, transport protocol (websocket or http-stream), and endpoint URL.
  */
 const listFunctions = (options) => {
     return (options?.client ?? client_gen_1.client).get({
@@ -875,7 +858,7 @@ const getIntegrationConnectionModel = (options) => {
 exports.getIntegrationConnectionModel = getIntegrationConnectionModel;
 /**
  * List batch jobs
- * Returns batch job definitions in the workspace. Each job can be triggered to run multiple parallel tasks with configurable concurrency and retry settings. 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 with all jobs.
+ * Returns all batch job definitions in the workspace. Each job can be triggered to run multiple parallel tasks with configurable concurrency and retry settings.
  */
 const listJobs = (options) => {
     return (options?.client ?? client_gen_1.client).get({
@@ -968,7 +951,7 @@ const updateJob = (options) => {
 exports.updateJob = updateJob;
 /**
  * List job executions
- * Returns executions for a batch job. 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 the legacy offset/limit contract and return a bare array.
+ * Returns paginated list of executions for a batch job, sorted by creation time. Each execution contains status, task counts, and timing information.
  */
 const listJobExecutions = (options) => {
     return (options.client ?? client_gen_1.client).get({
@@ -1038,23 +1021,6 @@ const getJobExecution = (options) => {
     });
 };
 exports.getJobExecution = getJobExecution;
-/**
- * List execution tasks
- * Returns one cursor-paginated page of an execution's tasks. Tasks are derived from event history each request; only the in-memory slicing is paginated, the events scan still fetches the whole event log behind the scenes. Available starting with API version 2026-04-28.
- */
-const listJobExecutionTasks = (options) => {
-    return (options.client ?? client_gen_1.client).get({
-        security: [
-            {
-                scheme: 'bearer',
-                type: 'http'
-            }
-        ],
-        url: '/jobs/{jobId}/executions/{executionId}/tasks',
-        ...options
-    });
-};
-exports.listJobExecutionTasks = listJobExecutionTasks;
 /**
  * List job revisions
  * Returns revisions for a job by name.
@@ -1108,7 +1074,7 @@ const listMcpHubDefinitions = (options) => {
 exports.listMcpHubDefinitions = listMcpHubDefinitions;
 /**
  * List model endpoints
- * Returns model gateway endpoints configured in the workspace. Each model represents a proxy to an external LLM provider (OpenAI, Anthropic, etc.) with unified access control. 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 with all models.
+ * Returns all model gateway endpoints configured in the workspace. Each model represents a proxy to an external LLM provider (OpenAI, Anthropic, etc.) with unified access control.
  */
 const listModels = (options) => {
     return (options?.client ?? client_gen_1.client).get({
@@ -1269,7 +1235,7 @@ const declineImageShare = (options) => {
 exports.declineImageShare = declineImageShare;
 /**
  * List governance policies
- * Returns governance policies in the workspace. Policies control deployment locations, hardware flavors, and token limits for agents, functions, and models. 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 with all policies.
+ * Returns all governance policies in the workspace. Policies control deployment locations, hardware flavors, and token limits for agents, functions, and models.
  */
 const listPolicies = (options) => {
     return (options?.client ?? client_gen_1.client).get({
@@ -1360,23 +1326,6 @@ const updatePolicy = (options) => {
     });
 };
 exports.updatePolicy = updatePolicy;
-/**
- * List resources using a policy
- * Returns the names of every resource (agent, function, model, sandbox, job) currently referencing the given policy. Replaces the client-side fan-out the policies UI used to do over the listings.
- */
-const getPolicyUsages = (options) => {
-    return (options.client ?? client_gen_1.client).get({
-        security: [
-            {
-                scheme: 'bearer',
-                type: 'http'
-            }
-        ],
-        url: '/policies/{policyName}/usages',
-        ...options
-    });
-};
-exports.getPolicyUsages = getPolicyUsages;
 /**
  * List public ips
  * Returns a list of all public ips used in Blaxel..
@@ -1413,7 +1362,7 @@ const listSandboxHubDefinitions = (options) => {
 exports.listSandboxHubDefinitions = listSandboxHubDefinitions;
 /**
  * List sandboxes
- * Returns sandboxes in the workspace. Each sandbox includes its configuration, status, and endpoint URL. Terminated sandboxes are hidden by default; pass `showTerminated=true` to include them. 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 of all sandboxes.
+ * Returns all sandboxes in the workspace. Each sandbox includes its configuration, status, and endpoint URL.
  */
 const listSandboxes = (options) => {
     return (options?.client ?? client_gen_1.client).get({
@@ -2005,7 +1954,7 @@ const deleteVolumeTemplateVersion = (options) => {
 exports.deleteVolumeTemplateVersion = deleteVolumeTemplateVersion;
 /**
  * List persistent volumes
- * Returns persistent storage volumes in the workspace. Volumes can be attached to sandboxes for durable file storage that persists across sessions and sandbox deletions. 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 of volumes.
+ * Returns all persistent storage volumes in the workspace. Volumes can be attached to sandboxes for durable file storage that persists across sessions and sandbox deletions.
  */
 const listVolumes = (options) => {
     return (options?.client ?? client_gen_1.client).get({

package/dist/cjs/common/autoload.js

@@ -41,11 +41,13 @@ const client_gen_js_1 = require("../client/client.gen.js");
 const interceptors_js_1 = require("../client/interceptors.js");
 const responseInterceptor_js_1 = require("../client/responseInterceptor.js");
 const client_gen_js_2 = require("../sandbox/client/client.gen.js");
+const controlPlaneFetch_js_1 = require("./controlPlaneFetch.js");
 const settings_js_1 = require("./settings.js");
 var lazyInit_js_1 = require("./lazyInit.js");
 Object.defineProperty(exports, "ensureAutoloaded", { enumerable: true, get: function () { return lazyInit_js_1.ensureAutoloaded; } });
 client_gen_js_1.client.setConfig({
     baseUrl: settings_js_1.settings.baseUrl,
+    fetch: controlPlaneFetch_js_1.controlPlaneFetch,
 });
 // Register request interceptors
 for (const interceptor of interceptors_js_1.interceptors) {
@@ -90,6 +92,7 @@ function initialize(config) {
     settings_js_1.settings.setConfig(config);
     client_gen_js_1.client.setConfig({
         baseUrl: settings_js_1.settings.baseUrl,
+        fetch: controlPlaneFetch_js_1.controlPlaneFetch,
     });
     client_gen_js_2.client.setConfig({
         baseUrl: settings_js_1.settings.baseUrl,

package/dist/cjs/common/controlPlaneFetch.js

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.nativeFetchSupportsH2 = void 0;
+exports.undiciSupportsNativeH2 = undiciSupportsNativeH2;
+exports.shouldUseControlPlaneH2 = shouldUseControlPlaneH2;
+exports.controlPlaneFetch = controlPlaneFetch;
+const h2fetch_js_1 = require("./h2fetch.js");
+const h2pool_js_1 = require("./h2pool.js");
+const settings_js_1 = require("./settings.js");
+const h2FetchByHost = new Map();
+// Node's global fetch dispatcher only negotiates HTTP/2 by default starting
+// with undici 8 (Node 26+); undici 7 (Node 24) and undici 6 (Node 22) still
+// ALPN to HTTP/1.1 for fetch, verified empirically against api.blaxel.ai. On
+// undici >= 8 the pooled wrapper is redundant, so we prefer the native path.
+function undiciSupportsNativeH2(undiciVersion) {
+    const major = Number(undiciVersion?.split(".")[0] ?? 0);
+    return major >= 8;
+}
+// `process`/`process.versions` is absent on Cloudflare Workers and other
+// non-Node runtimes, and `process.versions.undici` is undefined on Bun/Deno;
+// all of those resolve to `false` and keep the wrapper as the fallback.
+exports.nativeFetchSupportsH2 = typeof process !== "undefined" && undiciSupportsNativeH2(process.versions?.undici);
+function shouldUseControlPlaneH2(url, h2Disabled, proxyConfigured = false, nativeH2 = false, forceWrapper = false) {
+    if (h2Disabled || proxyConfigured)
+        return false;
+    if (url.protocol !== "https:")
+        return false;
+    // Token refresh is sequential and unauthenticated; it cannot contribute to
+    // the create burst TLS storm, and device-mode refresh currently relies on the
+    // native fetch path.
+    if (url.pathname.endsWith("/oauth/token"))
+        return false;
+    if (!(url.hostname.endsWith("blaxel.ai") || url.hostname.endsWith("blaxel.dev"))) {
+        return false;
+    }
+    // Native fetch already negotiates HTTP/2: skip the redundant wrapper unless
+    // explicitly forced (e.g. to exercise the pooled path on a modern runtime).
+    if (nativeH2 && !forceWrapper)
+        return false;
+    return true;
+}
+function controlPlaneFetch(input) {
+    const url = new URL(input.url);
+    const proxyConfigured = Boolean(settings_js_1.settings.config.proxy);
+    // Global disableH2 still wins; disableControlPlaneH2 opts out of just the
+    // control-plane wrapper while leaving data-plane H2 in place.
+    const h2Disabled = settings_js_1.settings.disableH2 || settings_js_1.settings.disableControlPlaneH2;
+    if (!shouldUseControlPlaneH2(url, h2Disabled, proxyConfigured, exports.nativeFetchSupportsH2, settings_js_1.settings.forceControlPlaneH2)) {
+        return globalThis.fetch(input);
+    }
+    let h2Fetch = h2FetchByHost.get(url.hostname);
+    if (!h2Fetch) {
+        h2Fetch = (0, h2fetch_js_1.createPoolBackedH2Fetch)(h2pool_js_1.h2Pool, url.hostname);
+        h2FetchByHost.set(url.hostname, h2Fetch);
+    }
+    return h2Fetch(input);
+}

package/dist/cjs/common/h2fetch.js

@@ -7,7 +7,7 @@ exports.h2RequestDirectFromPool = h2RequestDirectFromPool;
 exports.h2RequestDirect = h2RequestDirect;
 const settings_js_1 = require("./settings.js");
 const h2ref_js_1 = require("./h2ref.js");
-const MIN_H2_SESSION_MAX_LISTENERS = 256;
+const MIN_H2_SESSION_MAX_LISTENERS = 64;
 const sessionsWithListenerBudget = new WeakSet();
 /**
  * Per-domain async semaphore that bounds the number of in-flight HTTP/2

package/dist/cjs/common/lazyInit.js

@@ -36,6 +36,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.ensureAutoloaded = ensureAutoloaded;
 const client_gen_js_1 = require("../client/client.gen.js");
 const client_gen_js_2 = require("../sandbox/client/client.gen.js");
+const controlPlaneFetch_js_1 = require("./controlPlaneFetch.js");
 const sentry_js_1 = require("./sentry.js");
 const settings_js_1 = require("./settings.js");
 let autoloaded = false;
@@ -69,7 +70,7 @@ function ensureAutoloaded() {
     // Keep the clients' baseUrl in sync with the now-resolved env. Without
     // this, the module-load `client.setConfig({ baseUrl })` would be stuck on
     // the prod default for users who rely on `config.yaml` (no env vars).
-    client_gen_js_1.client.setConfig({ baseUrl: settings_js_1.settings.baseUrl });
+    client_gen_js_1.client.setConfig({ baseUrl: settings_js_1.settings.baseUrl, fetch: controlPlaneFetch_js_1.controlPlaneFetch });
     client_gen_js_2.client.setConfig({ baseUrl: settings_js_1.settings.baseUrl });
     // Initialize Sentry for SDK error tracking.
     (0, sentry_js_1.initSentry)();
@@ -80,9 +81,9 @@ function ensureAutoloaded() {
     if (isNode && !isBrowser && !settings_js_1.settings.disableH2) {
         try {
             // Pre-warm edge H2 for the configured region so the first
-            // SandboxInstance.create() gets an instant session via the pool.
-            // The control-plane client (api.blaxel.ai) stays on regular fetch
-            // which already benefits from undici's built-in connection pooling.
+            // SandboxInstance.create() gets an instant data-plane session via the
+            // pool. Control-plane H2 is intentionally not warmed; its cold burst
+            // relies on pool deduplication instead.
             const region = settings_js_1.settings.region;
             if (region) {
                 Promise.resolve().then(() => __importStar(require("./h2pool.js"))).then(({ h2Pool }) => {

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.90-dev.181";
-const BUILD_COMMIT = "588f48a812b2e4e0ff556b9008896ad944741f53";
+const BUILD_VERSION = "0.2.90-preview.183";
+const BUILD_COMMIT = "e47f7913315215d00a881153cf552d424046a303";
 const BUILD_SENTRY_DSN = "https://fd5e60e1c9820e1eef5ccebb84a07127@o4508714045276160.ingest.us.sentry.io/4510465864564736";
-const BLAXEL_API_VERSION = "2026-04-28";
+const BLAXEL_API_VERSION = "2026-04-16";
 // Cache for config.yaml tracking value
 let configTrackingValue = null;
 let configTrackingLoaded = false;
@@ -250,6 +250,31 @@ class Settings {
         }
         return isDenoRuntime();
     }
+    // Control-plane-only escape hatch: disables the control-plane H2 wrapper
+    // without affecting data-plane (edge) H2. `disableH2` is the global override
+    // and is checked separately by callers, so it always wins.
+    get disableControlPlaneH2() {
+        if (typeof this.config.disableControlPlaneH2 === "boolean") {
+            return this.config.disableControlPlaneH2;
+        }
+        const value = env_js_1.env.BL_DISABLE_CONTROL_PLANE_H2;
+        if (value) {
+            return ["1", "true", "yes", "on"].includes(value.toLowerCase());
+        }
+        return false;
+    }
+    // Forces the control-plane H2 wrapper on even when native fetch already
+    // supports H2 (undici >= 7). `disableH2`/`disableControlPlaneH2` still win.
+    get forceControlPlaneH2() {
+        if (typeof this.config.forceControlPlaneH2 === "boolean") {
+            return this.config.forceControlPlaneH2;
+        }
+        const value = env_js_1.env.BL_FORCE_CONTROL_PLANE_H2;
+        if (value) {
+            return ["1", "true", "yes", "on"].includes(value.toLowerCase());
+        }
+        return false;
+    }
     get maxConcurrentH2Requests() {
         if (typeof this.config.maxConcurrentH2Requests === "number") {
             return this.config.maxConcurrentH2Requests;

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-28 when BL_API_VERSION is not set', async () => {
+    (0, vitest_1.it)('defaults to 2026-04-16 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-28');
+        (0, vitest_1.expect)(settings.apiVersion).toBe('2026-04-16');
     });
     (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-28');
+            (0, vitest_1.expect)(settings.headers['Blaxel-Version']).toBe('2026-04-16');
         }
         finally {
             settings.credentials = previous;

package/dist/cjs/drive/index.js

@@ -3,7 +3,6 @@ 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;
@@ -87,44 +86,9 @@ class DriveInstance {
         });
         return new DriveInstance(data);
     }
-    /**
-     * 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 list() {
+        const { data } = await (0, index_js_1.listDrives)({ throwOnError: true });
+        return data.map((drive) => new DriveInstance(drive));
     }
     static async delete(driveName) {
         const { data } = await (0, index_js_1.deleteDrive)({

package/dist/cjs/index.js

@@ -23,7 +23,6 @@ __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,7 +3,6 @@ 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 {
@@ -79,50 +78,18 @@ class BlJob {
         return data;
     }
     /**
-     * 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,
-     * });
-     * ```
+     * List all executions for this job
      */
-    async listExecutions(query) {
+    async listExecutions() {
         logger_js_1.logger.debug(`Listing executions for job: ${this.jobName}`);
-        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 { data } = await (0, index_js_1.listJobExecutions)({
+            path: {
+                jobId: this.jobName,
+            },
+            headers: settings_js_1.settings.headers,
+            throwOnError: true,
         });
+        return data ?? [];
     }
     /**
      * 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. 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).
+ * Mounts an agent drive using the blfs binary to a local path, optionally mounting a subpath within the drive
  */
 const postDrivesMount = (options) => {
     return (options.client ?? client_gen_1.client).post({

package/dist/cjs/sandbox/preview.js

@@ -105,29 +105,24 @@ class SandboxPreviews {
         });
         return data.map((preview) => new SandboxPreview(preview));
     }
-    async create(preview, force) {
-        const query = {};
-        if (force) {
-            query['force'] = 'true';
-        }
+    async create(preview) {
         const { data } = await (0, index_js_1.createSandboxPreview)({
             path: {
                 sandboxName: this.sandboxName,
             },
-            query,
             body: preview,
             throwOnError: true,
         });
         return new SandboxPreview(data);
     }
-    async createIfNotExists(preview, force) {
+    async createIfNotExists(preview) {
         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, force);
+                return this.create(preview);
             }
             throw e;
         }

package/dist/cjs/sandbox/sandbox.js

@@ -37,7 +37,6 @@ 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");
@@ -273,46 +272,10 @@ class SandboxInstance {
         const instance = new SandboxInstance(data);
         return SandboxInstance.attachH2Session(instance);
     }
-    /**
-     * 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,
-        });
+    static async list() {
+        const { data } = await (0, index_js_1.listSandboxes)({ throwOnError: true });
+        const instances = data.map((sandbox) => new SandboxInstance(sandbox));
+        return Promise.all(instances.map((instance) => SandboxInstance.attachH2Session(instance)));
     }
     static async delete(sandboxName) {
         const { data } = await (0, index_js_1.deleteSandbox)({