@blaxel/core 0.2.70 → 0.2.71-dev.105

package/dist/cjs/mcp/server.js

@@ -38,8 +38,6 @@ const uuid_1 = require("uuid");
 const ws_1 = __importStar(require("ws"));
 const env_js_1 = require("../common/env.js");
 const logger_js_1 = require("../common/logger.js");
-const telemetry_js_1 = require("../telemetry/telemetry.js");
-const spans = new Map();
 class BlaxelMcpServerTransport {
     port;
     wss;
@@ -74,26 +72,10 @@ class BlaxelMcpServerTransport {
                 ws,
             });
             this.onconnection?.(clientId);
-            ws.on("message", (data) => {
-                const span = (0, telemetry_js_1.startSpan)("message", {
-                    attributes: {
-                        "mcp.client.id": clientId,
-                        "span.type": "mcp.message",
-                    },
-                    isRoot: false,
-                });
+            ws.on("message", async (data) => {
                 try {
                     const msg = JSON.parse(data.toString());
-                    this.messageHandler?.(msg, clientId);
-                    if ("method" in msg && "id" in msg && "params" in msg) {
-                        span.setAttributes({
-                            "mcp.message.parsed": true,
-                            "mcp.method": msg.method,
-                            "mcp.messageId": msg.id,
-                            "mcp.toolName": msg.params?.name,
-                        });
-                        spans.set(clientId + ":" + msg.id, span);
-                    }
+                    await this.messageHandler?.(msg, clientId);
                     // Handle msg.id safely
                     const msgId = msg.id ? String(msg.id) : "";
                     const [cId, parsedMsgId] = msgId.split(":");
@@ -101,27 +83,7 @@ class BlaxelMcpServerTransport {
                     // Use optional chaining for safe access
                     const client = this.clients.get(cId ?? "");
                     if (client?.ws?.readyState === ws_1.default.OPEN) {
-                        const msgSpan = spans.get(cId + ":" + (msg.id ?? ""));
-                        try {
-                            client.ws.send(JSON.stringify(msg));
-                            if (msgSpan) {
-                                msgSpan.setAttributes({
-                                    "mcp.message.response_sent": true,
-                                });
-                            }
-                        }
-                        catch (err) {
-                            if (msgSpan) {
-                                msgSpan.setStatus("error"); // Error status
-                                msgSpan.recordException(err);
-                            }
-                            throw err;
-                        }
-                        finally {
-                            if (msgSpan) {
-                                msgSpan.end();
-                            }
-                        }
+                        client.ws.send(JSON.stringify(msg));
                     }
                     else {
                         this.clients.delete(cId);
@@ -130,14 +92,11 @@ class BlaxelMcpServerTransport {
                 }
                 catch (err) {
                     if (err instanceof Error) {
-                        span.setStatus("error"); // Error status
-                        span.recordException(err);
                         this.onerror?.(err);
                     }
                     else {
                         this.onerror?.(new Error(`Failed to parse message: ${String(err)}`));
                     }
-                    span.end();
                 }
             });
             ws.on("close", () => {
@@ -159,27 +118,7 @@ class BlaxelMcpServerTransport {
             // Send to specific client
             const client = this.clients.get(cId);
             if (client?.ws?.readyState === ws_1.default.OPEN) {
-                const msgSpan = spans.get(cId + ":" + msg.id);
-                try {
-                    client.ws.send(data);
-                    if (msgSpan) {
-                        msgSpan.setAttributes({
-                            "mcp.message.response_sent": true,
-                        });
-                    }
-                }
-                catch (err) {
-                    if (msgSpan) {
-                        msgSpan.setStatus("error"); // Error status
-                        msgSpan.recordException(err);
-                    }
-                    throw err;
-                }
-                finally {
-                    if (msgSpan) {
-                        msgSpan.end();
-                    }
-                }
+                client.ws.send(data);
             }
             else {
                 this.clients.delete(cId);

package/dist/cjs/sandbox/action.js

@@ -2,6 +2,9 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SandboxAction = exports.ResponseError = void 0;
 const client_fetch_1 = require("@hey-api/client-fetch");
+const interceptors_js_1 = require("../client/interceptors.js");
+const responseInterceptor_js_1 = require("../client/responseInterceptor.js");
+const h2fetch_js_1 = require("../common/h2fetch.js");
 const internal_js_1 = require("../common/internal.js");
 const settings_js_1 = require("../common/settings.js");
 const client_gen_js_1 = require("./client/client.gen.js");
@@ -32,6 +35,7 @@ class ResponseError extends Error {
 exports.ResponseError = ResponseError;
 class SandboxAction {
     sandbox;
+    _h2Client = null;
     constructor(sandbox) {
         this.sandbox = sandbox;
     }
@@ -58,8 +62,37 @@ class SandboxAction {
                 headers: this.sandbox.headers,
             });
         }
+        const session = this.sandbox.h2Session;
+        if (session && !session.closed && !session.destroyed) {
+            if (!this._h2Client) {
+                this._h2Client = (0, client_fetch_1.createClient)({
+                    fetch: (0, h2fetch_js_1.createH2Fetch)(session),
+                });
+                for (const interceptor of interceptors_js_1.interceptors) {
+                    // @ts-expect-error - Interceptor is not typed
+                    this._h2Client.interceptors.request.use(interceptor);
+                }
+                for (const interceptor of responseInterceptor_js_1.responseInterceptors) {
+                    this._h2Client.interceptors.response.use(interceptor);
+                }
+            }
+            return this._h2Client;
+        }
+        // Invalidate cached H2 client when session is no longer usable
+        this._h2Client = null;
         return client_gen_js_1.client;
     }
+    /**
+     * 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 (0, h2fetch_js_1.h2RequestDirect)(session, input.toString(), init);
+        }
+        return globalThis.fetch(input, init);
+    }
     get forcedUrl() {
         if (this.sandbox.forceUrl)
             return this.sandbox.forceUrl;

package/dist/cjs/sandbox/drive/drive.js

@@ -17,7 +17,7 @@ class SandboxDrive extends action_js_1.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,
@@ -40,7 +40,7 @@ class SandboxDrive extends action_js_1.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,
         });
@@ -55,7 +55,7 @@ class SandboxDrive extends action_js_1.SandboxAction {
      */
     async list() {
         const headers = this.sandbox.forceUrl ? this.sandbox.headers : settings_js_1.settings.headers;
-        const response = await fetch(`${this.url}/drives/mount`, {
+        const response = await this.h2Fetch(`${this.url}/drives/mount`, {
             method: 'GET',
             headers,
         });

package/dist/cjs/sandbox/filesystem/filesystem.js

@@ -101,8 +101,7 @@ class SandboxFileSystem extends action_js_1.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_js_1.settings.headers,

package/dist/cjs/sandbox/interpreter.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CodeInterpreter = void 0;
+const h2fetch_js_1 = require("../common/h2fetch.js");
 const logger_js_1 = require("../common/logger.js");
 const settings_js_1 = require("../common/settings.js");
 const sandbox_js_1 = require("./sandbox.js");
@@ -26,6 +27,7 @@ class CodeInterpreter extends sandbox_js_1.SandboxInstance {
             spec: base.spec,
             status: base.status,
             events: base.events,
+            h2Session: base.h2Session,
         };
         return new CodeInterpreter(config);
     }
@@ -83,6 +85,7 @@ class CodeInterpreter extends sandbox_js_1.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)) {
@@ -101,6 +104,13 @@ class CodeInterpreter extends sandbox_js_1.SandboxInstance {
     get _jupyterUrl() {
         return this.process.url;
     }
+    _fetch(input, init) {
+        const session = this._sandboxConfig.h2Session;
+        if (session && !session.closed && !session.destroyed) {
+            return (0, h2fetch_js_1.h2RequestDirect)(session, input.toString(), init);
+        }
+        return globalThis.fetch(input, init);
+    }
     static OutputMessage = class {
         text;
         timestamp;
@@ -260,7 +270,7 @@ class CodeInterpreter extends sandbox_js_1.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,
@@ -359,7 +369,7 @@ class CodeInterpreter extends sandbox_js_1.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/cjs/sandbox/process/process.js

@@ -21,7 +21,7 @@ class SandboxProcess extends action_js_1.SandboxAction {
         const done = (async () => {
             try {
                 const headers = this.sandbox.forceUrl ? this.sandbox.headers : settings_js_1.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,
@@ -123,7 +123,7 @@ class SandboxProcess extends action_js_1.SandboxAction {
     async execWithStreaming(processRequest, options) {
         const headers = this.sandbox.forceUrl ? this.sandbox.headers : settings_js_1.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/cjs/sandbox/sandbox.js

@@ -1,4 +1,37 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SandboxInstance = void 0;
 const uuid_1 = require("uuid");
@@ -24,6 +57,8 @@ class SandboxInstance {
     codegen;
     system;
     drives;
+    /* eslint-disable @typescript-eslint/no-explicit-any */
+    h2Session;
     constructor(sandbox) {
         this.sandbox = sandbox;
         this.process = new index_js_6.SandboxProcess(sandbox);
@@ -34,6 +69,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.h2Session = null;
     }
     get metadata() {
         return this.sandbox.metadata;
@@ -50,6 +86,27 @@ 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_js_1.settings.env === "prod" ? "bl.run" : "runv2.blaxel.dev";
+        const edgeDomain = `any.${region}.${edgeSuffix}`;
+        try {
+            const { h2Pool } = await Promise.resolve().then(() => __importStar(require("../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;
     }
@@ -131,11 +188,24 @@ class SandboxInstance {
         }
         sandbox.spec.runtime.image = sandbox.spec.runtime.image || defaultImage;
         sandbox.spec.runtime.memory = sandbox.spec.runtime.memory || defaultMemory;
-        const { data } = await (0, index_js_1.createSandbox)({
-            body: sandbox,
-            throwOnError: true,
-        });
-        const instance = new SandboxInstance(data);
+        const edgeSuffix = settings_js_1.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) {
+            Promise.resolve().then(() => __importStar(require("../common/h2pool.js"))).then(({ h2Pool }) => h2Pool.warm(edgeDomain)).catch(() => { });
+        }
+        const [{ data }, h2Session] = await Promise.all([
+            (0, index_js_1.createSandbox)({
+                body: sandbox,
+                throwOnError: true,
+            }),
+            edgeDomain ? Promise.resolve().then(() => __importStar(require("../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 {
@@ -152,11 +222,13 @@ class SandboxInstance {
             },
             throwOnError: true,
         });
-        return new SandboxInstance(data);
+        const instance = new SandboxInstance(data);
+        return SandboxInstance.attachH2Session(instance);
     }
     static async list() {
         const { data } = await (0, index_js_1.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 (0, index_js_1.deleteSandbox)({
@@ -168,6 +240,8 @@ 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) {
@@ -179,7 +253,7 @@ 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);
@@ -190,7 +264,7 @@ 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);
@@ -201,7 +275,7 @@ class SandboxInstance {
             throwOnError: true,
         });
         const instance = new SandboxInstance(data);
-        return instance;
+        return SandboxInstance.attachH2Session(instance);
     }
     static async createIfNotExists(sandbox) {
         try {

package/dist/cjs/tools/index.js

@@ -1,10 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getToolMetadata = exports.blTool = exports.blTools = exports.BLTools = exports.getTool = void 0;
+exports.getToolMetadata = exports.blTool = exports.blTools = exports.BLTools = exports.getTool = exports.McpTool = void 0;
 const index_js_1 = require("../cache/index.js");
 const client_js_1 = require("../client/client.js");
 const internal_js_1 = require("../common/internal.js");
 const mcpTool_js_1 = require("./mcpTool.js");
+var mcpTool_js_2 = require("./mcpTool.js");
+Object.defineProperty(exports, "McpTool", { enumerable: true, get: function () { return mcpTool_js_2.McpTool; } });
 const getTool = async (name, options) => {
     return await (0, mcpTool_js_1.getMcpTool)(name, options);
 };

package/dist/cjs/tools/mcpTool.js

@@ -9,7 +9,6 @@ const logger_js_1 = require("../common/logger.js");
 const settings_js_1 = require("../common/settings.js");
 const index_js_2 = require("../index.js");
 const client_js_1 = require("../mcp/client.js");
-const telemetry_js_1 = require("../telemetry/telemetry.js");
 const zodSchema_js_1 = require("./zodSchema.js");
 const McpToolCache = new Map();
 class McpTool {
@@ -141,47 +140,24 @@ class McpTool {
         }
     }
     async listTools() {
-        const span = (0, telemetry_js_1.startSpan)(this.name, {
-            attributes: {
-                "span.type": "tool.list",
-            },
+        logger_js_1.logger.debug(`MCP:${this.name}:Listing tools`);
+        await this.start();
+        const { tools } = (await this.client.listTools());
+        await this.close();
+        const result = tools.map((tool) => {
+            return {
+                name: tool.name,
+                description: tool.description,
+                inputSchema: (0, zodSchema_js_1.schemaToZodSchema)(tool.inputSchema),
+                originalSchema: tool.inputSchema,
+                call: (input) => {
+                    return this.call(tool.name, input);
+                },
+            };
         });
-        try {
-            logger_js_1.logger.debug(`MCP:${this.name}:Listing tools`);
-            await this.start();
-            const { tools } = (await this.client.listTools());
-            await this.close();
-            const result = tools.map((tool) => {
-                return {
-                    name: tool.name,
-                    description: tool.description,
-                    inputSchema: (0, zodSchema_js_1.schemaToZodSchema)(tool.inputSchema),
-                    originalSchema: tool.inputSchema,
-                    call: (input) => {
-                        return this.call(tool.name, input);
-                    },
-                };
-            });
-            span.setAttribute("tool.list.result", JSON.stringify(result));
-            return result;
-        }
-        catch (err) {
-            span.setStatus("error");
-            span.recordException(err);
-            throw err;
-        }
-        finally {
-            span.end();
-        }
+        return result;
     }
     async call(toolName, args) {
-        const span = (0, telemetry_js_1.startSpan)(this.name + "." + toolName, {
-            attributes: {
-                "span.type": "tool.call",
-                "tool.name": toolName,
-                "tool.args": JSON.stringify(args),
-            },
-        });
         try {
             logger_js_1.logger.debug(`MCP:${this.name}:Tool calling`, toolName, JSON.stringify(args));
             logger_js_1.logger.debug(`MCP:${this.name}:Tool calling:start`);
@@ -195,7 +171,6 @@ class McpTool {
             logger_js_1.logger.debug(`MCP:${this.name}:Tool calling:result`);
             await this.close();
             logger_js_1.logger.debug(`MCP:${this.name}:Tool result`, toolName, JSON.stringify(args));
-            span.setAttribute("tool.call.result", JSON.stringify(result));
             return result;
         }
         catch (err) {
@@ -210,9 +185,6 @@ class McpTool {
             }
             throw err;
         }
-        finally {
-            span.end();
-        }
     }
     async getTransport(forcedUrl) {
         if (!this.transportName) {

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

@@ -1,5 +1,5 @@
 import { Agent } from "../client/index.js";
-declare class BlAgent {
+export declare class BlAgent {
     agentName: string;
     constructor(agentName: string);
     get fallbackUrl(): import("url").URL | null;
@@ -12,4 +12,3 @@ declare class BlAgent {
 }
 export declare const blAgent: (agentName: string) => BlAgent;
 export declare const getAgentMetadata: (agent: string) => Promise<Agent | null>;
-export {};

package/dist/cjs/types/common/autoload.d.ts

@@ -1,3 +1,8 @@
 import { Config } from "./settings.js";
 export declare function initialize(config: Config): void;
 export declare function authenticate(): Promise<void>;
+/**
+ * Close all pooled H2 connections. Call this for explicit cleanup
+ * (e.g. in test teardown or before process exit).
+ */
+export declare function closeConnections(): Promise<void>;

package/dist/cjs/types/common/h2fetch.d.ts

@@ -0,0 +1,22 @@
+import http2 from "http2";
+import type { h2Pool as H2PoolType } from "./h2pool.js";
+/**
+ * Creates a fetch()-compatible function that sends requests over an existing
+ * HTTP/2 session. Falls back to global fetch() if the session is closed,
+ * destroyed, or if the H2 request times out.
+ */
+export declare function createH2Fetch(session: http2.ClientHttp2Session): (input: Request) => Promise<Response>;
+/**
+ * Creates a fetch()-compatible function backed by the H2 session pool.
+ *
+ * Non-blocking: checks the pool cache synchronously. If a warm session is
+ * available it's used immediately; otherwise the request goes through
+ * regular fetch with zero delay (the pool keeps warming in the background
+ * so subsequent calls get H2).
+ */
+export declare function createPoolBackedH2Fetch(pool: typeof H2PoolType, domain: string): (input: Request) => Promise<Response>;
+/**
+ * Low-level H2 request that takes raw URL + init, skipping Request construction.
+ * Used by SandboxAction.h2Fetch() for direct calls from subsystems.
+ */
+export declare function h2RequestDirect(session: http2.ClientHttp2Session, url: string, init?: RequestInit): Promise<Response>;

package/dist/cjs/types/common/h2pool.d.ts

@@ -0,0 +1,38 @@
+import type http2 from "http2";
+/**
+ * Singleton H2 session pool keyed by edge domain.
+ *
+ * - `warm(domain)` starts a background connection (fire-and-forget).
+ * - `get(domain)` returns a live session immediately if cached, or awaits
+ *   an in-flight warming, or establishes a fresh one.
+ * - Closed / destroyed sessions are automatically evicted.
+ */
+declare class H2Pool {
+    private sessions;
+    private inflight;
+    private _establish;
+    /**
+     * Lazily resolve the establish function so the http2 / tls / dns modules
+     * are only imported in Node.js environments.
+     */
+    private establish;
+    /**
+     * Fire-and-forget background warming. Safe to call multiple times for
+     * the same domain — only one connection attempt per domain at a time.
+     */
+    warm(domain: string): void;
+    /**
+     * Synchronous cache check. Returns a live cached session or `null`.
+     * Never blocks, never establishes — use for non-blocking fast paths.
+     */
+    tryGet(domain: string): http2.ClientHttp2Session | null;
+    /**
+     * Get a live H2 session for `domain`. Returns immediately from cache,
+     * joins an in-flight warming, or starts a new one.
+     */
+    get(domain: string): Promise<http2.ClientHttp2Session | null>;
+    /** Close all sessions (for cleanup). */
+    closeAll(): void;
+}
+export declare const h2Pool: H2Pool;
+export {};

package/dist/cjs/types/common/h2warm.d.ts

@@ -0,0 +1,2 @@
+import http2 from "http2";
+export declare function establishH2(sniHostname: string): Promise<http2.ClientHttp2Session>;

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

@@ -1,5 +1,5 @@
 import { CreateJobExecutionRequest, JobExecution } from "../client/index.js";
-declare class BlJob {
+export declare class BlJob {
     jobName: string;
     constructor(jobName: string);
     run(tasks: Record<string, unknown>[], options?: {
@@ -39,4 +39,3 @@ declare class BlJob {
     }): Promise<JobExecution>;
 }
 export declare const blJob: (jobName: string) => BlJob;
-export {};

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

@@ -1,3 +1,4 @@
+import { type Client } from "@hey-api/client-fetch";
 import { SandboxConfiguration } from "./types.js";
 export declare class ResponseError extends Error {
     response: Response;
@@ -7,12 +8,18 @@ export declare class ResponseError extends Error {
 }
 export declare class SandboxAction {
     protected sandbox: SandboxConfiguration;
+    private _h2Client;
     constructor(sandbox: SandboxConfiguration);
     get name(): string;
     get fallbackUrl(): string | null;
     get externalUrl(): string;
     get internalUrl(): string;
-    get client(): import("@hey-api/client-fetch").Client;
+    get client(): Client;
+    /**
+     * Routes through the H2 session when available, falling back to
+     * globalThis.fetch. Uses a direct H2 path that avoids Request allocation.
+     */
+    protected h2Fetch(input: string | URL, init?: RequestInit): Promise<Response>;
     get forcedUrl(): string | import("url").URL | null;
     get url(): string;
     handleResponseError(response: Response, data: unknown, error: unknown): void;