@mastra/platform-workspace 1.7.0-alpha.1 → 1.7.0-alpha.2

package/dist/index.js

@@ -1,6 +1,6 @@
 import { Buffer as Buffer$1 } from "buffer";
 import nodePath from "path";
-import { FileExistsError, FileNotFoundError, MastraFilesystem, MastraSandbox, ProcessHandle, SandboxNotReadyError, SandboxProcessManager, UnsupportedStdinCloseError, WorkspaceReadOnlyError } from "@mastra/core/workspace";
+import { FileExistsError, FileNotFoundError, MastraFilesystem, MastraSandbox, ProcessHandle, SandboxError, SandboxNotReadyError, SandboxProcessManager, UnsupportedStdinCloseError, WorkspaceReadOnlyError } from "@mastra/core/workspace";
 import { CommandExitError, Sandbox, TimeoutError } from "e2b";
 import { execFile } from "child_process";
 import { createHash } from "crypto";
@@ -1141,6 +1141,7 @@ var PlatformSandbox = class PlatformSandbox extends MastraSandbox {
 	_usesProviderRoutes;
 	_environmentId;
 	_sandboxId;
+	_reattach;
 	_seedCheckpointName;
 	_templateDefinition;
 	_templateBuildEnvs;
@@ -1232,6 +1233,7 @@ var PlatformSandbox = class PlatformSandbox extends MastraSandbox {
 		this._environmentId = options.environmentId ?? process.env.MASTRA_ENVIRONMENT_ID ?? "";
 		if (!this._environmentId && !options.sandboxId) throw new Error("environmentId is required");
 		this._sandboxId = options.sandboxId;
+		this._reattach = options.reattach ?? "best-effort";
 		this._seedCheckpointName = options.seedCheckpointName;
 		this._usesProviderRoutes = options.template !== void 0;
 		this._template = options.template;
@@ -1248,6 +1250,16 @@ var PlatformSandbox = class PlatformSandbox extends MastraSandbox {
 	generateId() {
 		return `platform-sandbox-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 8)}`;
 	}
+	_failIfReattachRequired(reason, cause) {
+		if (this._reattach !== "required") return;
+		throw new SandboxError(`Platform sandbox ${this._sandboxId} could not be reattached (${reason}); refusing to provision a replacement because reattach is 'required'. Clear the persisted sandboxId to start a fresh sandbox.`, "SANDBOX_REATTACH_FAILED", {
+			provider: "platform",
+			sandboxId: this._sandboxId,
+			logicalId: this.id,
+			reason,
+			...cause !== void 0 && { cause }
+		});
+	}
 	_request(path, options = {}) {
 		return this._usesProviderRoutes ? this._client.requestProvider(path, options) : this._client.request(path, options);
 	}
@@ -1277,6 +1289,7 @@ var PlatformSandbox = class PlatformSandbox extends MastraSandbox {
 			fetch: this._client.fetch,
 			environmentId: this._environmentId,
 			...options.sandboxId !== void 0 && { sandboxId: options.sandboxId },
+			reattach: this._reattach,
 			...seedCheckpointName !== void 0 && { seedCheckpointName },
 			...this._template !== void 0 && { template: this._template },
 			idleTimeoutMinutes: options.idleTimeoutMinutes ?? this._idleTimeoutMinutes,
@@ -1319,9 +1332,11 @@ var PlatformSandbox = class PlatformSandbox extends MastraSandbox {
 				this._logStartComplete(json.id, startedAt, requestMs, "reattach");
 				return { outcome: "connected" };
 			}
+			this._failIfReattachRequired("destroyed");
 			this._sandboxId = void 0;
 		} catch (error) {
 			if (!(error instanceof PlatformApiError) || error.status !== 404 && error.status !== 410) throw error;
+			this._failIfReattachRequired(String(error.status), error);
 			this._sandboxId = void 0;
 		}
 		if (!this._environmentId) throw new Error("environmentId is required");