@blaxel/core 0.2.84-preview.154 → 0.2.84-preview.155

package/dist/esm/common/settings.js

@@ -5,8 +5,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.84-preview.154";
-const BUILD_COMMIT = "44e0848f215027fe6f3981e7decdc1ec192544cf";
+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

package/dist/esm/sandbox/interpreter.js

@@ -30,7 +30,7 @@ export class CodeInterpreter extends 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,
@@ -63,7 +63,7 @@ export class CodeInterpreter extends 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/esm/sandbox/sandbox.js

@@ -11,6 +11,13 @@ import { SandboxProcess } from "./process/index.js";
 import { SandboxSessions } from "./session.js";
 import { SandboxSystem } from "./system.js";
 import { normalizeEnvs, normalizePorts, normalizeVolumes } from "./types.js";
+const NON_REUSABLE_SANDBOX_STATUSES = new Set([
+    "FAILED",
+    "TERMINATED",
+    "TERMINATING",
+    "DELETING",
+    "DEACTIVATING",
+]);
 export class SandboxInstance {
     sandbox;
     fs;
@@ -96,7 +103,7 @@ export class SandboxInstance {
         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-${uuidv4().replace(/-/g, '').substring(0, 8)}`;
         const defaultImage = `blaxel/base-image:latest`;
         const defaultMemory = 4096;
@@ -180,6 +187,7 @@ export class SandboxInstance {
         const [{ data }, h2Session] = await Promise.all([
             createSandbox({
                 body: sandbox,
+                query: createIfNotExist ? { createIfNotExist } : undefined,
                 throwOnError: true,
             }),
             edgeDomain && !settings.disableH2 ? import("../common/h2pool.js").then(({ h2Pool }) => h2Pool.get(edgeDomain)).catch(() => null) : Promise.resolve(null),
@@ -266,27 +274,30 @@ export 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) {