@blaxel/core 0.2.83 → 0.2.84-preview.155

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

@@ -11,8 +11,8 @@ const index_js_1 = require("../authentication/index.js");
 const env_js_1 = require("../common/env.js");
 const node_js_1 = require("../common/node.js");
 // Build info - these placeholders are replaced at build time by build:replace-imports
-const BUILD_VERSION = "0.2.83";
-const BUILD_COMMIT = "d6f07458e0f766e5ef3c547eec3b0e00cf3297f7";
+const BUILD_VERSION = "0.2.84-preview.155";
+const BUILD_COMMIT = "b37c7bd0ef1257de732b54a2f784c6c91a8d450d";
 const BUILD_SENTRY_DSN = "https://fd5e60e1c9820e1eef5ccebb84a07127@o4508714045276160.ingest.us.sentry.io/4510465864564736";
 const BLAXEL_API_VERSION = "2026-04-16";
 // Cache for config.yaml tracking value
@@ -72,6 +72,10 @@ function getOsArch() {
     }
     return "browser/unknown";
 }
+function isDenoRuntime() {
+    const runtime = globalThis;
+    return typeof runtime.Deno !== "undefined";
+}
 class Settings {
     _credentials;
     config;
@@ -223,9 +227,10 @@ class Settings {
             return this.config.disableH2;
         }
         const value = env_js_1.env.BL_DISABLE_H2;
-        if (!value)
-            return false;
-        return ["1", "true", "yes", "on"].includes(value.toLowerCase());
+        if (value) {
+            return ["1", "true", "yes", "on"].includes(value.toLowerCase());
+        }
+        return isDenoRuntime();
     }
     async authenticate() {
         await this.credentials.authenticate();

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

@@ -65,7 +65,7 @@ class SandboxAction {
             });
         }
         const h2Domain = this.sandbox.h2Domain;
-        if (h2Domain) {
+        if (h2Domain && !settings_js_1.settings.disableH2) {
             if (!this._h2Client || this._h2ClientDomain !== h2Domain) {
                 this._h2Client = (0, client_fetch_1.createClient)({
                     fetch: (0, h2fetch_js_1.createPoolBackedH2Fetch)(h2pool_js_1.h2Pool, h2Domain),
@@ -86,13 +86,22 @@ class SandboxAction {
         this._h2ClientDomain = null;
         return client_gen_js_1.client;
     }
+    withClient(options) {
+        const requestOptions = { ...options };
+        Object.defineProperty(requestOptions, 'client', {
+            value: this.client,
+            enumerable: false,
+            configurable: true,
+        });
+        return requestOptions;
+    }
     /**
      * 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 h2Domain = this.sandbox.h2Domain;
-        if (h2Domain) {
+        if (h2Domain && !settings_js_1.settings.disableH2) {
             return (0, h2fetch_js_1.h2RequestDirectFromPool)(h2pool_js_1.h2Pool, h2Domain, input.toString(), init);
         }
         return globalThis.fetch(input, init);

package/dist/cjs-browser/sandbox/codegen/codegen.js

@@ -8,22 +8,20 @@ class SandboxCodegen extends action_js_1.SandboxAction {
         super(sandbox);
     }
     async fastapply(path, codeEdit, model) {
-        const result = await (0, sdk_gen_js_1.putCodegenFastapplyByPath)({
+        const result = await (0, sdk_gen_js_1.putCodegenFastapplyByPath)(this.withClient({
             path: { path },
             body: { codeEdit, model },
             baseUrl: this.url,
-            client: this.client,
-        });
+        }));
         this.handleResponseError(result.response, result.data, result.error);
         return result.data;
     }
     async reranking(path, query, scoreThreshold, tokenLimit, filePattern) {
-        const result = await (0, sdk_gen_js_1.getCodegenRerankingByPath)({
+        const result = await (0, sdk_gen_js_1.getCodegenRerankingByPath)(this.withClient({
             path: { path },
             query: { query, scoreThreshold, tokenLimit, filePattern },
             baseUrl: this.url,
-            client: this.client,
-        });
+        }));
         this.handleResponseError(result.response, result.data, result.error);
         return result.data;
     }

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

@@ -11,11 +11,10 @@ class SandboxDrive extends action_js_1.SandboxAction {
      * Mount a drive to the sandbox at a specific mount path
      */
     async mount(request) {
-        const { response, data, error } = await (0, index_js_1.postDrivesMount)({
+        const { response, data, error } = await (0, index_js_1.postDrivesMount)(this.withClient({
             baseUrl: this.url,
-            client: this.client,
             body: request,
-        });
+        }));
         this.handleResponseError(response, data, error);
         return data;
     }
@@ -26,11 +25,10 @@ class SandboxDrive extends action_js_1.SandboxAction {
         // Strip leading slash for the path parameter since the URL template
         // already includes the slash: /drives/mount/{mountPath}
         const paramPath = mountPath.startsWith("/") ? mountPath.substring(1) : mountPath;
-        const { response, data, error } = await (0, index_js_1.deleteDrivesMountByMountPath)({
+        const { response, data, error } = await (0, index_js_1.deleteDrivesMountByMountPath)(this.withClient({
             baseUrl: this.url,
-            client: this.client,
             path: { mountPath: paramPath },
-        });
+        }));
         this.handleResponseError(response, data, error);
         return data;
     }
@@ -38,10 +36,9 @@ class SandboxDrive extends action_js_1.SandboxAction {
      * List all mounted drives in the sandbox
      */
     async list() {
-        const { response, data, error } = await (0, index_js_1.getDrivesMount)({
+        const { response, data, error } = await (0, index_js_1.getDrivesMount)(this.withClient({
             baseUrl: this.url,
-            client: this.client,
-        });
+        }));
         this.handleResponseError(response, data, error);
         const result = data;
         return result.mounts ?? [];

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

@@ -18,12 +18,11 @@ class SandboxFileSystem extends action_js_1.SandboxAction {
     }
     async mkdir(path, permissions = "0755") {
         path = this.formatPath(path);
-        const { response, data, error } = await (0, index_js_1.putFilesystemByPath)({
+        const { response, data, error } = await (0, index_js_1.putFilesystemByPath)(this.withClient({
             path: { path },
             body: { isDirectory: true, permissions },
             baseUrl: this.url,
-            client: this.client,
-        });
+        }));
         this.handleResponseError(response, data, error);
         return data;
     }
@@ -37,12 +36,11 @@ class SandboxFileSystem extends action_js_1.SandboxAction {
             return await this.uploadWithMultipart(path, blob, "0644");
         }
         // Use regular upload for small files
-        const { response, data, error } = await (0, index_js_1.putFilesystemByPath)({
+        const { response, data, error } = await (0, index_js_1.putFilesystemByPath)(this.withClient({
             path: { path },
             body: { content },
             baseUrl: this.url,
-            client: this.client,
-        });
+        }));
         this.handleResponseError(response, data, error);
         return data;
     }
@@ -123,7 +121,6 @@ class SandboxFileSystem extends action_js_1.SandboxAction {
                 }, {}),
             },
             baseUrl: this.url,
-            client: this.client,
         };
         const path = this.formatPath(destinationPath ?? "");
         const { response, data, error } = await this.client.put({
@@ -138,11 +135,10 @@ class SandboxFileSystem extends action_js_1.SandboxAction {
     }
     async read(path) {
         path = this.formatPath(path);
-        const { response, data, error } = await (0, index_js_1.getFilesystemByPath)({
+        const { response, data, error } = await (0, index_js_1.getFilesystemByPath)(this.withClient({
             path: { path },
             baseUrl: this.url,
-            client: this.client,
-        });
+        }));
         this.handleResponseError(response, data, error);
         if (data && 'content' in data) {
             return data.content;
@@ -151,14 +147,13 @@ class SandboxFileSystem extends action_js_1.SandboxAction {
     }
     async readBinary(path) {
         path = this.formatPath(path);
-        const { response, data, error } = await (0, index_js_1.getFilesystemByPath)({
+        const { response, data, error } = await (0, index_js_1.getFilesystemByPath)(this.withClient({
             path: { path },
             baseUrl: this.url,
-            client: this.client,
             headers: {
                 'Accept': 'application/octet-stream',
             },
-        });
+        }));
         this.handleResponseError(response, data, error);
         if (typeof data === 'string') {
             return new Blob([data]);
@@ -176,22 +171,20 @@ class SandboxFileSystem extends action_js_1.SandboxAction {
     }
     async rm(path, recursive = false) {
         path = this.formatPath(path);
-        const { response, data, error } = await (0, index_js_1.deleteFilesystemByPath)({
+        const { response, data, error } = await (0, index_js_1.deleteFilesystemByPath)(this.withClient({
             path: { path },
             query: { recursive },
             baseUrl: this.url,
-            client: this.client,
-        });
+        }));
         this.handleResponseError(response, data, error);
         return data;
     }
     async ls(path) {
         path = this.formatPath(path);
-        const { response, data, error } = await (0, index_js_1.getFilesystemByPath)({
+        const { response, data, error } = await (0, index_js_1.getFilesystemByPath)(this.withClient({
             path: { path },
             baseUrl: this.url,
-            client: this.client,
-        });
+        }));
         this.handleResponseError(response, data, error);
         if (!data || !('files' in data || 'subdirectories' in data)) {
             throw new Error(JSON.stringify({ error: "Directory not found" }));
@@ -213,12 +206,11 @@ class SandboxFileSystem extends action_js_1.SandboxAction {
         if (options?.excludeHidden !== undefined) {
             queryParams.excludeHidden = options.excludeHidden;
         }
-        const result = await (0, index_js_1.getFilesystemSearchByPath)({
+        const result = await (0, index_js_1.getFilesystemSearchByPath)(this.withClient({
             path: { path: formattedPath },
             query: queryParams,
             baseUrl: this.url,
-            client: this.client,
-        });
+        }));
         this.handleResponseError(result.response, result.data, result.error);
         return result.data;
     }
@@ -240,12 +232,11 @@ class SandboxFileSystem extends action_js_1.SandboxAction {
         if (options?.excludeHidden !== undefined) {
             queryParams.excludeHidden = options.excludeHidden;
         }
-        const result = await (0, index_js_1.getFilesystemFindByPath)({
+        const result = await (0, index_js_1.getFilesystemFindByPath)(this.withClient({
             path: { path: formattedPath },
             query: queryParams,
             baseUrl: this.url,
-            client: this.client,
-        });
+        }));
         this.handleResponseError(result.response, result.data, result.error);
         return result.data;
     }
@@ -269,12 +260,11 @@ class SandboxFileSystem extends action_js_1.SandboxAction {
         if (options?.excludeDirs && options.excludeDirs.length > 0) {
             queryParams.excludeDirs = options.excludeDirs.join(',');
         }
-        const result = await (0, index_js_1.getFilesystemContentSearchByPath)({
+        const result = await (0, index_js_1.getFilesystemContentSearchByPath)(this.withClient({
             path: { path: formattedPath },
             query: queryParams,
             baseUrl: this.url,
-            client: this.client,
-        });
+        }));
         this.handleResponseError(result.response, result.data, result.error);
         return result.data;
     }
@@ -301,14 +291,13 @@ class SandboxFileSystem extends action_js_1.SandboxAction {
             if (options?.ignore) {
                 query.ignore = options.ignore.join(",");
             }
-            const { response, data, error } = await (0, index_js_1.getWatchFilesystemByPath)({
-                client: this.client,
+            const { response, data, error } = await (0, index_js_1.getWatchFilesystemByPath)(this.withClient({
                 path: { path },
                 query,
                 baseUrl: this.url,
                 parseAs: 'stream',
                 signal: controller.signal,
-            });
+            }));
             if (error)
                 throw new Error(error instanceof Error ? error.message : JSON.stringify(error));
             const stream = data ?? response.body;
@@ -383,43 +372,39 @@ class SandboxFileSystem extends action_js_1.SandboxAction {
     // Multipart upload helper methods
     async initiateMultipartUpload(path, permissions = "0644") {
         path = this.formatPath(path);
-        const { data } = await (0, index_js_1.postFilesystemMultipartInitiateByPath)({
+        const { data } = await (0, index_js_1.postFilesystemMultipartInitiateByPath)(this.withClient({
             path: { path },
             body: { permissions },
             baseUrl: this.url,
-            client: this.client,
             throwOnError: true,
-        });
+        }));
         return data;
     }
     async uploadPart(uploadId, partNumber, fileBlob) {
-        const { data } = await (0, index_js_1.putFilesystemMultipartByUploadIdPart)({
+        const { data } = await (0, index_js_1.putFilesystemMultipartByUploadIdPart)(this.withClient({
             path: { uploadId },
             query: { partNumber },
             body: { file: fileBlob },
             baseUrl: this.url,
-            client: this.client,
             throwOnError: true,
-        });
+        }));
         return data;
     }
     async completeMultipartUpload(uploadId, parts) {
-        const { data } = await (0, index_js_1.postFilesystemMultipartByUploadIdComplete)({
+        const { data } = await (0, index_js_1.postFilesystemMultipartByUploadIdComplete)(this.withClient({
             path: { uploadId },
             body: { parts },
             baseUrl: this.url,
-            client: this.client,
             throwOnError: true,
-        });
+        }));
         return data;
     }
     async abortMultipartUpload(uploadId) {
-        const { data } = await (0, index_js_1.deleteFilesystemMultipartByUploadIdAbort)({
+        const { data } = await (0, index_js_1.deleteFilesystemMultipartByUploadIdAbort)(this.withClient({
             path: { uploadId },
             baseUrl: this.url,
-            client: this.client,
             throwOnError: true,
-        });
+        }));
         return data;
     }
     async uploadWithMultipart(path, blob, permissions = "0644") {

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

@@ -33,7 +33,7 @@ class CodeInterpreter extends sandbox_js_1.SandboxInstance {
         };
         return new CodeInterpreter(config);
     }
-    static async create(sandbox, { safe = true } = {}) {
+    static async create(sandbox, { safe = true, createIfNotExist = false } = {}) {
         // Build a SandboxCreateConfiguration with CodeInterpreter defaults
         const defaults = {
             image: CodeInterpreter.DEFAULT_IMAGE,
@@ -66,7 +66,7 @@ class CodeInterpreter extends sandbox_js_1.SandboxInstance {
         else {
             merged = defaults;
         }
-        const baseInstance = await super.create(merged, { safe });
+        const baseInstance = await super.create(merged, { safe, createIfNotExist });
         // Create config from the instance
         const config = {
             metadata: baseInstance.metadata,

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

@@ -111,11 +111,10 @@ class SandboxProcess extends action_js_1.SandboxAction {
             return await this.execWithStreaming(process, { onLog, onStdout, onStderr });
         }
         else {
-            const { response, data, error } = await (0, index_js_1.postProcess)({
+            const { response, data, error } = await (0, index_js_1.postProcess)(this.withClient({
                 body: process,
                 baseUrl: this.url,
-                client: this.client,
-            });
+            }));
             this.handleResponseError(response, data, error);
             const result = data;
             if (onLog || onStdout || onStderr) {
@@ -303,46 +302,41 @@ class SandboxProcess extends action_js_1.SandboxAction {
         return data;
     }
     async get(identifier) {
-        const { response, data, error } = await (0, index_js_1.getProcessByIdentifier)({
+        const { response, data, error } = await (0, index_js_1.getProcessByIdentifier)(this.withClient({
             path: { identifier },
             baseUrl: this.url,
-            client: this.client,
-        });
+        }));
         this.handleResponseError(response, data, error);
         return data;
     }
     async list() {
-        const { response, data, error } = await (0, index_js_1.getProcess)({
+        const { response, data, error } = await (0, index_js_1.getProcess)(this.withClient({
             baseUrl: this.url,
-            client: this.client,
-        });
+        }));
         this.handleResponseError(response, data, error);
         return data;
     }
     async stop(identifier) {
-        const { response, data, error } = await (0, index_js_1.deleteProcessByIdentifier)({
+        const { response, data, error } = await (0, index_js_1.deleteProcessByIdentifier)(this.withClient({
             path: { identifier },
             baseUrl: this.url,
-            client: this.client,
-        });
+        }));
         this.handleResponseError(response, data, error);
         return data;
     }
     async kill(identifier) {
-        const { response, data, error } = await (0, index_js_1.deleteProcessByIdentifierKill)({
+        const { response, data, error } = await (0, index_js_1.deleteProcessByIdentifierKill)(this.withClient({
             path: { identifier },
             baseUrl: this.url,
-            client: this.client,
-        });
+        }));
         this.handleResponseError(response, data, error);
         return data;
     }
     async logs(identifier, type = "all") {
-        const { response, data, error } = await (0, index_js_1.getProcessByIdentifierLogs)({
+        const { response, data, error } = await (0, index_js_1.getProcessByIdentifierLogs)(this.withClient({
             path: { identifier },
             baseUrl: this.url,
-            client: this.client,
-        });
+        }));
         this.handleResponseError(response, data, error);
         if (type === "all") {
             return data?.logs || "";

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

@@ -47,6 +47,13 @@ const index_js_6 = require("./process/index.js");
 const session_js_1 = require("./session.js");
 const system_js_1 = require("./system.js");
 const types_js_1 = require("./types.js");
+const NON_REUSABLE_SANDBOX_STATUSES = new Set([
+    "FAILED",
+    "TERMINATED",
+    "TERMINATING",
+    "DELETING",
+    "DEACTIVATING",
+]);
 class SandboxInstance {
     sandbox;
     fs;
@@ -132,7 +139,7 @@ class SandboxInstance {
         logger_js_1.logger.warn("⚠️  Warning: sandbox.wait() is deprecated. You don't need to wait for the sandbox to be deployed anymore.");
         return this;
     }
-    static async create(sandbox, { safe = false } = {}) {
+    static async create(sandbox, { safe = false, createIfNotExist = false } = {}) {
         const defaultName = `sandbox-${(0, uuid_1.v4)().replace(/-/g, '').substring(0, 8)}`;
         const defaultImage = `blaxel/base-image:latest`;
         const defaultMemory = 4096;
@@ -216,6 +223,7 @@ class SandboxInstance {
         const [{ data }, h2Session] = await Promise.all([
             (0, index_js_1.createSandbox)({
                 body: sandbox,
+                query: createIfNotExist ? { createIfNotExist } : undefined,
                 throwOnError: true,
             }),
             edgeDomain && !settings_js_1.settings.disableH2 ? Promise.resolve().then(() => __importStar(require("../common/h2pool.js"))).then(({ h2Pool }) => h2Pool.get(edgeDomain)).catch(() => null) : Promise.resolve(null),
@@ -302,27 +310,30 @@ class SandboxInstance {
         return SandboxInstance.attachH2Session(instance);
     }
     static async createIfNotExists(sandbox) {
-        try {
-            return await this.create(sandbox);
-        }
-        catch (e) {
-            if (typeof e === "object" && e !== null && "code" in e && (e.code === 409 || e.code === 'SANDBOX_ALREADY_EXISTS')) {
-                const name = 'name' in sandbox ? sandbox.name : sandbox.metadata.name;
-                if (!name) {
-                    throw new Error("Sandbox name is required");
-                }
-                // Get the existing sandbox to check its status
-                const sandboxInstance = await this.get(name);
-                // If the sandbox is TERMINATED, treat it as not existing
-                if (sandboxInstance.status === "TERMINATED") {
-                    // Create a new sandbox - backend will handle cleanup of the terminated one
-                    return await this.create(sandbox);
+        const ATTEMPTS = 3;
+        for (let i = 0; i < ATTEMPTS; ++i) {
+            try {
+                return await this.create(sandbox, { createIfNotExist: true });
+            }
+            catch (e) {
+                if (typeof e === "object" && e !== null && "code" in e && (e.code === 409 || e.code === 'SANDBOX_ALREADY_EXISTS')) {
+                    const name = 'name' in sandbox ? sandbox.name : sandbox.metadata.name;
+                    if (!name) {
+                        throw new Error("Sandbox name is required");
+                    }
+                    // Get the existing sandbox to check its status
+                    const sandboxInstance = await this.get(name);
+                    // Recreate instead of returning sandbox records that cannot be reused.
+                    if (!NON_REUSABLE_SANDBOX_STATUSES.has(sandboxInstance.status ?? "")) {
+                        return sandboxInstance;
+                    }
+                    // Retry creation. We want the same error handling on the retry as creates can race.
+                    continue;
                 }
-                // Otherwise return the existing running sandbox
-                return sandboxInstance;
+                throw e;
             }
-            throw e;
         }
+        throw new Error(`Unable to create sandbox after ${ATTEMPTS} attempts.`);
     }
     /* eslint-disable */
     static async fromSession(session) {

package/dist/cjs-browser/sandbox/system.js

@@ -8,11 +8,10 @@ class SandboxSystem extends action_js_1.SandboxAction {
         super(sandbox);
     }
     async upgrade(body) {
-        const { response, data, error } = await (0, index_js_1.postUpgrade)({
+        const { response, data, error } = await (0, index_js_1.postUpgrade)(this.withClient({
             baseUrl: this.url,
-            client: this.client,
             body,
-        });
+        }));
         this.handleResponseError(response, data, error);
         return data;
     }

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

@@ -16,6 +16,9 @@ export declare class SandboxAction {
     get externalUrl(): string;
     get internalUrl(): string;
     get client(): Client;
+    protected withClient<T extends object>(options: T): T & {
+        client: Client;
+    };
     /**
      * Routes through the H2 session when available, falling back to
      * globalThis.fetch. Uses a direct H2 path that avoids Request allocation.

package/dist/cjs-browser/types/sandbox/interpreter.d.ts

@@ -8,8 +8,9 @@ export declare class CodeInterpreter extends SandboxInstance {
     private _sandboxConfig;
     constructor(sandbox: SandboxConfiguration);
     static get(sandboxName: string): Promise<CodeInterpreter>;
-    static create(sandbox?: Sandbox | SandboxCreateConfiguration | Record<string, any> | null, { safe }?: {
+    static create(sandbox?: Sandbox | SandboxCreateConfiguration | Record<string, any> | null, { safe, createIfNotExist }?: {
         safe?: boolean;
+        createIfNotExist?: boolean;
     }): Promise<CodeInterpreter>;
     static createIfNotExists(sandbox: Sandbox | SandboxCreateConfiguration): Promise<CodeInterpreter>;
     get _jupyterUrl(): string;

package/dist/cjs-browser/types/sandbox/sandbox.d.ts

@@ -46,8 +46,9 @@ export declare class SandboxInstance {
         maxWait?: number;
         interval?: number;
     }): Promise<this>;
-    static create(sandbox?: SandboxModel | SandboxCreateConfiguration, { safe }?: {
+    static create(sandbox?: SandboxModel | SandboxCreateConfiguration, { safe, createIfNotExist }?: {
         safe?: boolean;
+        createIfNotExist?: boolean;
     }): Promise<SandboxInstance>;
     static get(sandboxName: string): Promise<SandboxInstance>;
     static list(): Promise<SandboxInstance[]>;