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

package/dist/index.cjs

@@ -1165,6 +1165,7 @@ var PlatformSandbox = class PlatformSandbox extends _mastra_core_workspace.Mastr
 	_usesProviderRoutes;
 	_environmentId;
 	_sandboxId;
+	_reattach;
 	_seedCheckpointName;
 	_templateDefinition;
 	_templateBuildEnvs;
@@ -1256,6 +1257,7 @@ var PlatformSandbox = class PlatformSandbox extends _mastra_core_workspace.Mastr
 		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;
@@ -1272,6 +1274,16 @@ var PlatformSandbox = class PlatformSandbox extends _mastra_core_workspace.Mastr
 	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 _mastra_core_workspace.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);
 	}
@@ -1301,6 +1313,7 @@ var PlatformSandbox = class PlatformSandbox extends _mastra_core_workspace.Mastr
 			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,
@@ -1343,9 +1356,11 @@ var PlatformSandbox = class PlatformSandbox extends _mastra_core_workspace.Mastr
 				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");