@blaxel/core 0.2.71-dev.101 → 0.2.71-dev.105

package/dist/esm-browser/common/autoload.js

@@ -21,6 +21,28 @@ for (const interceptor of responseInterceptors) {
 }
 // Initialize Sentry for SDK error tracking immediately when module loads
 initSentry();
+// Background H2 connection warming (Node.js only)
+const isNode = typeof process !== "undefined" && process.versions != null && process.versions.node != null;
+/* eslint-disable */
+const isBrowser = typeof globalThis !== "undefined" && globalThis?.window !== undefined;
+if (isNode && !isBrowser) {
+    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.
+        const region = settings.region;
+        if (region) {
+            import("./h2pool.js").then(({ h2Pool }) => {
+                const edgeSuffix = settings.env === "prod" ? "bl.run" : "runv2.blaxel.dev";
+                h2Pool.warm(`any.${region}.${edgeSuffix}`);
+            }).catch(() => { });
+        }
+    }
+    catch {
+        // Silently ignore warming failures
+    }
+}
 // Allow to set custom configuration for browser environment
 export function initialize(config) {
     settings.setConfig(config);
@@ -34,3 +56,11 @@ export function initialize(config) {
 export function authenticate() {
     return settings.authenticate();
 }
+/**
+ * Close all pooled H2 connections. Call this for explicit cleanup
+ * (e.g. in test teardown or before process exit).
+ */
+export async function closeConnections() {
+    const { h2Pool } = await import("./h2pool.js");
+    h2Pool.closeAll();
+}

package/dist/esm-browser/common/h2fetch.js

@@ -0,0 +1,4 @@
+// Browser stub - H2 fetch is Node.js only, falls back to global fetch
+export function createH2Fetch(session) { return (input) => globalThis.fetch(input); }
+export function createPoolBackedH2Fetch(pool, domain) { return (input) => globalThis.fetch(input); }
+export function h2RequestDirect(session, url, init) { return globalThis.fetch(url, init); }

package/dist/esm-browser/common/h2pool.js

@@ -0,0 +1,4 @@
+// Browser stub - H2 pool is Node.js only
+const noop = () => {};
+const noopAsync = async () => null;
+export const h2Pool = { warm: noop, get: noopAsync, tryGet: () => null, closeAll: noop };

package/dist/esm-browser/common/h2warm.js

@@ -0,0 +1,2 @@
+// Browser stub - H2 warming is Node.js only
+export async function establishH2(sniHostname) { return null; }

package/dist/esm-browser/common/settings.js

@@ -3,8 +3,8 @@ import { authentication } from "../authentication/index.js";
 import { env } from "../common/env.js";
 import { fs, os, path } from "../common/node.js";
 // Build info - these placeholders are replaced at build time by build:replace-imports
-const BUILD_VERSION = "0.2.71-dev.101";
-const BUILD_COMMIT = "dccf33c2f51602cd1cd06116b55d326f4645465a";
+const BUILD_VERSION = "0.2.71-dev.105";
+const BUILD_COMMIT = "cd4e249990c84664410df2d7158d13d6342300ed";
 const BUILD_SENTRY_DSN = "https://fd5e60e1c9820e1eef5ccebb84a07127@o4508714045276160.ingest.us.sentry.io/4510465864564736";
 // Cache for config.yaml tracking value
 let configTrackingValue = null;

package/dist/esm-browser/sandbox/action.js

@@ -1,4 +1,7 @@
 import { createClient } from "@hey-api/client-fetch";
+import { interceptors } from "../client/interceptors.js";
+import { responseInterceptors } from "../client/responseInterceptor.js";
+import { createH2Fetch, h2RequestDirect } from "../common/h2fetch.js";
 import { getForcedUrl, getGlobalUniqueHash } from "../common/internal.js";
 import { settings } from "../common/settings.js";
 import { client as defaultClient } from "./client/client.gen.js";
@@ -28,6 +31,7 @@ export class ResponseError extends Error {
 }
 export class SandboxAction {
     sandbox;
+    _h2Client = null;
     constructor(sandbox) {
         this.sandbox = sandbox;
     }
@@ -54,8 +58,37 @@ export class SandboxAction {
                 headers: this.sandbox.headers,
             });
         }
+        const session = this.sandbox.h2Session;
+        if (session && !session.closed && !session.destroyed) {
+            if (!this._h2Client) {
+                this._h2Client = createClient({
+                    fetch: createH2Fetch(session),
+                });
+                for (const interceptor of interceptors) {
+                    // @ts-expect-error - Interceptor is not typed
+                    this._h2Client.interceptors.request.use(interceptor);
+                }
+                for (const interceptor of responseInterceptors) {
+                    this._h2Client.interceptors.response.use(interceptor);
+                }
+            }
+            return this._h2Client;
+        }
+        // Invalidate cached H2 client when session is no longer usable
+        this._h2Client = null;
         return defaultClient;
     }
+    /**
+     * Routes through the H2 session when available, falling back to
+     * globalThis.fetch. Uses a direct H2 path that avoids Request allocation.
+     */
+    h2Fetch(input, init) {
+        const session = this.sandbox.h2Session;
+        if (session && !session.closed && !session.destroyed) {
+            return h2RequestDirect(session, input.toString(), init);
+        }
+        return globalThis.fetch(input, init);
+    }
     get forcedUrl() {
         if (this.sandbox.forceUrl)
             return this.sandbox.forceUrl;

package/dist/esm-browser/sandbox/drive/drive.js

@@ -14,7 +14,7 @@ export class SandboxDrive extends SandboxAction {
             mountPath: request.mountPath,
             drivePath: request.drivePath || "/",
         };
-        const response = await fetch(`${this.url}/drives/mount`, {
+        const response = await this.h2Fetch(`${this.url}/drives/mount`, {
             method: 'POST',
             headers: {
                 ...headers,
@@ -37,7 +37,7 @@ export class SandboxDrive extends SandboxAction {
         const normalizedPath = mountPath.startsWith('/') ? mountPath : `/${mountPath}`;
         // Remove leading slash for URL (DELETE /drives/mnt/test not /drives//mnt/test)
         const urlPath = normalizedPath.substring(1);
-        const response = await fetch(`${this.url}/drives/mount/${urlPath}`, {
+        const response = await this.h2Fetch(`${this.url}/drives/mount/${urlPath}`, {
             method: 'DELETE',
             headers,
         });
@@ -52,7 +52,7 @@ export class SandboxDrive extends SandboxAction {
      */
     async list() {
         const headers = this.sandbox.forceUrl ? this.sandbox.headers : settings.headers;
-        const response = await fetch(`${this.url}/drives/mount`, {
+        const response = await this.h2Fetch(`${this.url}/drives/mount`, {
             method: 'GET',
             headers,
         });

package/dist/esm-browser/sandbox/filesystem/filesystem.js

@@ -98,8 +98,7 @@ export class SandboxFileSystem extends SandboxAction {
         if (this.forcedUrl) {
             url = `${this.forcedUrl.toString()}/filesystem/${path}`;
         }
-        // Make the request using fetch instead of axios for better FormData handling
-        const response = await fetch(url, {
+        const response = await this.h2Fetch(url, {
             method: 'PUT',
             headers: {
                 ...settings.headers,

package/dist/esm-browser/sandbox/interpreter.js

@@ -1,3 +1,4 @@
+import { h2RequestDirect } from "../common/h2fetch.js";
 import { logger } from "../common/logger.js";
 import { settings } from "../common/settings.js";
 import { SandboxInstance } from "./sandbox.js";
@@ -23,6 +24,7 @@ export class CodeInterpreter extends SandboxInstance {
             spec: base.spec,
             status: base.status,
             events: base.events,
+            h2Session: base.h2Session,
         };
         return new CodeInterpreter(config);
     }
@@ -80,6 +82,7 @@ export class CodeInterpreter extends SandboxInstance {
             spec: baseInstance.spec,
             status: baseInstance.status,
             events: baseInstance.events,
+            h2Session: baseInstance.h2Session,
         };
         // Preserve forceUrl and headers from input if it was a dict-like object
         if (sandbox && typeof sandbox === "object" && !Array.isArray(sandbox)) {
@@ -98,6 +101,13 @@ export class CodeInterpreter extends SandboxInstance {
     get _jupyterUrl() {
         return this.process.url;
     }
+    _fetch(input, init) {
+        const session = this._sandboxConfig.h2Session;
+        if (session && !session.closed && !session.destroyed) {
+            return h2RequestDirect(session, input.toString(), init);
+        }
+        return globalThis.fetch(input, init);
+    }
     static OutputMessage = class {
         text;
         timestamp;
@@ -257,7 +267,7 @@ export class CodeInterpreter extends SandboxInstance {
             }, readTimeout * 1000);
         }
         try {
-            const response = await fetch(`${this._jupyterUrl}/port/8888/execute`, {
+            const response = await this._fetch(`${this._jupyterUrl}/port/8888/execute`, {
                 method: "POST",
                 headers: {
                     ...headers,
@@ -356,7 +366,7 @@ export class CodeInterpreter extends SandboxInstance {
             }, requestTimeout * 1000);
         }
         try {
-            const response = await fetch(`${this._jupyterUrl}/port/8888/contexts`, {
+            const response = await this._fetch(`${this._jupyterUrl}/port/8888/contexts`, {
                 method: "POST",
                 headers: {
                     ...headers,

package/dist/esm-browser/sandbox/process/process.js

@@ -18,7 +18,7 @@ export class SandboxProcess extends SandboxAction {
         const done = (async () => {
             try {
                 const headers = this.sandbox.forceUrl ? this.sandbox.headers : settings.headers;
-                const stream = await fetch(`${this.url}/process/${identifier}/logs/stream`, {
+                const stream = await this.h2Fetch(`${this.url}/process/${identifier}/logs/stream`, {
                     method: 'GET',
                     signal: controller.signal,
                     headers,
@@ -120,7 +120,7 @@ export class SandboxProcess extends SandboxAction {
     async execWithStreaming(processRequest, options) {
         const headers = this.sandbox.forceUrl ? this.sandbox.headers : settings.headers;
         const controller = new AbortController();
-        const response = await fetch(`${this.url}/process`, {
+        const response = await this.h2Fetch(`${this.url}/process`, {
             method: 'POST',
             signal: controller.signal,
             headers: {

package/dist/esm-browser/sandbox/sandbox.js

@@ -21,6 +21,8 @@ export class SandboxInstance {
     codegen;
     system;
     drives;
+    /* eslint-disable @typescript-eslint/no-explicit-any */
+    h2Session;
     constructor(sandbox) {
         this.sandbox = sandbox;
         this.process = new SandboxProcess(sandbox);
@@ -31,6 +33,7 @@ export class SandboxInstance {
         this.codegen = new SandboxCodegen(sandbox);
         this.system = new SandboxSystem(sandbox);
         this.drives = new SandboxDrive(sandbox);
+        this.h2Session = null;
     }
     get metadata() {
         return this.sandbox.metadata;
@@ -47,6 +50,27 @@ export class SandboxInstance {
     get lastUsedAt() {
         return this.sandbox.lastUsedAt;
     }
+    /**
+     * Warm and attach an H2 session based on the sandbox's region.
+     * Shared by create(), get(), list(), and update helpers.
+     */
+    static async attachH2Session(instance) {
+        const region = instance.spec?.region;
+        if (!region)
+            return instance;
+        const edgeSuffix = settings.env === "prod" ? "bl.run" : "runv2.blaxel.dev";
+        const edgeDomain = `any.${region}.${edgeSuffix}`;
+        try {
+            const { h2Pool } = await import("../common/h2pool.js");
+            const h2Session = await h2Pool.get(edgeDomain);
+            instance.h2Session = h2Session;
+            instance.sandbox.h2Session = h2Session;
+        }
+        catch {
+            // H2 warming is best-effort; fall back to regular fetch
+        }
+        return instance;
+    }
     get expiresIn() {
         return this.sandbox.expiresIn;
     }
@@ -128,11 +152,24 @@ export class SandboxInstance {
         }
         sandbox.spec.runtime.image = sandbox.spec.runtime.image || defaultImage;
         sandbox.spec.runtime.memory = sandbox.spec.runtime.memory || defaultMemory;
-        const { data } = await createSandbox({
-            body: sandbox,
-            throwOnError: true,
-        });
-        const instance = new SandboxInstance(data);
+        const edgeSuffix = settings.env === "prod" ? "bl.run" : "runv2.blaxel.dev";
+        const edgeDomain = sandbox.spec?.region ? `any.${sandbox.spec.region}.${edgeSuffix}` : null;
+        // Kick off warming so h2Pool.get() can join it during the API call
+        if (edgeDomain) {
+            import("../common/h2pool.js").then(({ h2Pool }) => h2Pool.warm(edgeDomain)).catch(() => { });
+        }
+        const [{ data }, h2Session] = await Promise.all([
+            createSandbox({
+                body: sandbox,
+                throwOnError: true,
+            }),
+            edgeDomain ? import("../common/h2pool.js").then(({ h2Pool }) => h2Pool.get(edgeDomain)).catch(() => null) : Promise.resolve(null),
+        ]);
+        // Inject the H2 session into the config so subsystems can use it
+        const config = { ...data, h2Session };
+        const instance = new SandboxInstance(config);
+        instance.h2Session = h2Session;
+        // Note: H2 session already attached via Promise.all above, no need for attachH2Session()
         // TODO remove this part once we have a better way to handle this
         if (safe) {
             try {
@@ -149,11 +186,13 @@ export class SandboxInstance {
             },
             throwOnError: true,
         });
-        return new SandboxInstance(data);
+        const instance = new SandboxInstance(data);
+        return SandboxInstance.attachH2Session(instance);
     }
     static async list() {
         const { data } = await listSandboxes({ throwOnError: true });
-        return data.map((sandbox) => new SandboxInstance(sandbox));
+        const instances = data.map((sandbox) => new SandboxInstance(sandbox));
+        return Promise.all(instances.map((instance) => SandboxInstance.attachH2Session(instance)));
     }
     static async delete(sandboxName) {
         const { data } = await deleteSandbox({
@@ -165,6 +204,8 @@ export class SandboxInstance {
         return data;
     }
     async delete() {
+        // Don't close the H2 session — it's shared via h2Pool
+        this.h2Session = null;
         return await SandboxInstance.delete(this.metadata.name);
     }
     static async updateMetadata(sandboxName, metadata) {
@@ -176,7 +217,7 @@ export class SandboxInstance {
             throwOnError: true,
         });
         const instance = new SandboxInstance(data);
-        return instance;
+        return SandboxInstance.attachH2Session(instance);
     }
     static async updateTtl(sandboxName, ttl) {
         const sandbox = await SandboxInstance.get(sandboxName);
@@ -187,7 +228,7 @@ export class SandboxInstance {
             throwOnError: true,
         });
         const instance = new SandboxInstance(data);
-        return instance;
+        return SandboxInstance.attachH2Session(instance);
     }
     static async updateLifecycle(sandboxName, lifecycle) {
         const sandbox = await SandboxInstance.get(sandboxName);
@@ -198,7 +239,7 @@ export class SandboxInstance {
             throwOnError: true,
         });
         const instance = new SandboxInstance(data);
-        return instance;
+        return SandboxInstance.attachH2Session(instance);
     }
     static async createIfNotExists(sandbox) {
         try {

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@blaxel/core",
-	"version": "0.2.71-dev.101",
+	"version": "0.2.71-dev.105",
 	"description": "Blaxel Core SDK for TypeScript",
 	"license": "MIT",
 	"author": "Blaxel, INC (https://blaxel.ai)",