@mastra/platform-workspace 1.4.0 → 1.4.1-alpha.1

package/CHANGELOG.md

@@ -1,5 +1,39 @@
 # @mastra/platform
 
+## 1.4.1-alpha.1
+
+### Patch Changes
+
+- Starting a sandbox now reports whether it created a fresh sandbox or reconnected to an existing one, so an `onStart` handler can run first-time setup only when it's actually needed: ([#21984](https://github.com/mastra-ai/mastra/pull/21984))
+
+  ```typescript
+  new E2BSandbox({
+    id: 'session-1',
+    onStart: async ({ outcome }) => {
+      if (outcome === 'created') await cloneRepo();
+    },
+  });
+  ```
+
+- Updated dependencies [[`4ff3ee2`](https://github.com/mastra-ai/mastra/commit/4ff3ee2bff7ed07528b4817f8f49639031c72a4d), [`c24754c`](https://github.com/mastra-ai/mastra/commit/c24754c1fb6fe144e5051e536e98c8a18b0214ac), [`45dd6ee`](https://github.com/mastra-ai/mastra/commit/45dd6ee089bd7df0d0c98a10098e483fd388e04a), [`32d3583`](https://github.com/mastra-ai/mastra/commit/32d358332cb8ac2306b83b73cf3536e74dbd435e), [`aca2869`](https://github.com/mastra-ai/mastra/commit/aca2869b2031982f3c4a2f52525c9be7cf123ef8)]:
+  - @mastra/core@1.62.0-alpha.11
+
+## 1.4.1-alpha.0
+
+### Patch Changes
+
+- Honor the sandbox runtime environment (`setEnv()`/`getEnv()` from `@mastra/core`) in every workspace sandbox provider. Environment variables set after construction now reach subsequent commands on all providers: ([#22250](https://github.com/mastra-ai/mastra/pull/22250))
+
+  - Process-manager-routed providers (E2B, Blaxel, Cloudflare, Daytona, Docker, Modal, Vercel microVM spawns) inherit the merge from the core spawn wrapper; their duplicated per-manager env plumbing is removed.
+  - Providers with their own exec transports (AgentCore, Apple Container, Railway, Vercel microVM and serverless `executeCommand`, Platform's private-network, WebSocket lease, and E2B lease paths) now merge `getEnv()` under per-call env.
+
+  Constructor `env` continues to behave as before: it seeds the sandbox runtime environment, and providers that bake env into the VM or container at creation time (Docker, Modal, Railway, Apple Container, Vercel, Platform) still do so. Per-call `env` on `executeCommand` still takes precedence for that command only.
+
+  Removed exported types (minor bump for these two packages): `BlaxelProcessManagerOptions` from `@mastra/blaxel` and `RailwayProcessManagerOptions` from `@mastra/railway`. Both existed only to pass `env` into a process manager constructed by hand; the core spawn wrapper now owns that merge, so the option and its type are gone.
+
+- Updated dependencies [[`aa3a85d`](https://github.com/mastra-ai/mastra/commit/aa3a85daf094c683bb97efdf4b6a696d2e474af5), [`d29d06f`](https://github.com/mastra-ai/mastra/commit/d29d06fe00bbd35b4571150ea04c59d2ed783c71), [`e6516df`](https://github.com/mastra-ai/mastra/commit/e6516dfcdae4f4ac0e7971d84359a81385ee602f), [`0b2a3d1`](https://github.com/mastra-ai/mastra/commit/0b2a3d1783875c5b97b7b36ab3d03d7360e0dde7), [`6bb5d71`](https://github.com/mastra-ai/mastra/commit/6bb5d7193fe9166b219f0fccae17db7a5ae86e65), [`57de7d6`](https://github.com/mastra-ai/mastra/commit/57de7d644ba7146edb4e9e6111ec4fa98c3a59e9), [`e8e299c`](https://github.com/mastra-ai/mastra/commit/e8e299cc6abdfc39947e2fec25803493015d3882), [`edfc548`](https://github.com/mastra-ai/mastra/commit/edfc548886bc7bae17b681f8b6b41a47eb32bcd2), [`a8a4871`](https://github.com/mastra-ai/mastra/commit/a8a4871215f51da95c47129602157ce5372f634a), [`5165cdc`](https://github.com/mastra-ai/mastra/commit/5165cdcdcf50e144bb8113278535196cc9b07065), [`6bb5d71`](https://github.com/mastra-ai/mastra/commit/6bb5d7193fe9166b219f0fccae17db7a5ae86e65), [`9ee8120`](https://github.com/mastra-ai/mastra/commit/9ee8120ce17f76b9f617489e05a283353742690a), [`d975e92`](https://github.com/mastra-ai/mastra/commit/d975e924d4936f46c386bd3dee39c671720289f6), [`1cfa878`](https://github.com/mastra-ai/mastra/commit/1cfa8784d8da0dfaa0317e5048bc48b6084a5ea5), [`c118318`](https://github.com/mastra-ai/mastra/commit/c1183181c9804303db4b511c2e2648f8b714712b), [`fc07c64`](https://github.com/mastra-ai/mastra/commit/fc07c6465043e08e99193a6751a01c56ffc2e7a1), [`542dee2`](https://github.com/mastra-ai/mastra/commit/542dee254167f974ff8cbbbfc0ce10f9a2616a7b), [`a58483c`](https://github.com/mastra-ai/mastra/commit/a58483cff1a9d41fce7c931843f48cb0ac450f64), [`a58483c`](https://github.com/mastra-ai/mastra/commit/a58483cff1a9d41fce7c931843f48cb0ac450f64), [`895e9df`](https://github.com/mastra-ai/mastra/commit/895e9dfc17d6f34299eca64e317ded9e5f5e5ef8)]:
+  - @mastra/core@1.62.0-alpha.8
+
 ## 1.4.0
 
 ### Minor Changes

package/dist/index.cjs

@@ -983,18 +983,6 @@ var PlatformSandbox = class PlatformSandbox extends _mastra_core_workspace.Mastr
 	*/
 	_captureInFlight = null;
 	/**
-	* In-flight `start()` attempt. Concurrent callers on a fresh instance
-	* coalesce onto this single promise so a `POST /sandbox` is not fired
-	* N times when N fleet callers race to bring the same logical sandbox
-	* up. Published **synchronously** with `??=` before the first `await`
-	* so a later caller cannot slip through the null check while the
-	* originator is mid-round-trip. Cleared when the shared attempt
-	* settles (success or failure) so the next call sees a clean slot.
-	*
-	* Mirrors OSS `@mastra/railway` `RailwaySandbox._startInFlight`.
-	*/
-	_startInFlight = null;
-	/**
 	* Generation token for the sidecar probe. Incremented on every `start()`
 	* and on teardown. The probe captures this value when it begins; if the
 	* generation has changed by the time the probe succeeds, the probe skips
@@ -1079,22 +1067,20 @@ var PlatformSandbox = class PlatformSandbox extends _mastra_core_workspace.Mastr
 			...this._addressRegistry !== void 0 && { addressRegistry: this._addressRegistry }
 		});
 	}
-	async start() {
-		this._startInFlight ??= this._doStart().finally(() => {
-			this._startInFlight = null;
-		});
-		return this._startInFlight;
-	}
 	/**
-	* The single `start` attempt behind {@link start}'s coalescing wrapper.
+	* Start the sandbox: reattach to a known provider `sandboxId` when one is
+	* set and still live, otherwise provision a fresh sandbox via the proxy.
 	*
-	* Split out so the wrapper can install a shared in-flight promise
-	* synchronously (before the first `await`) without inlining the reattach
-	* / retry logic. Joined callers observe whatever outcome this method
-	* produces — success returns normally, failures propagate to every
-	* awaiter.
+	* Concurrent-caller coalescing lives in the `MastraSandbox` base class
+	* (constructor-wrapped `start()`): joined callers share one attempt and
+	* observe its result; the in-flight slot is cleared on settle so a failed
+	* attempt is not a permanent latch.
+	*
+	* Reports `outcome: 'connected'` on reattach and `outcome: 'created'` on provision.
+	* Note: a `POST /sandbox` seeded from an id-keyed checkpoint is still a
+	* fresh VM and reports `outcome: 'created'`.
 	*/
-	async _doStart() {
+	async start() {
 		const startedAt = Date.now();
 		if (this._sandboxId) try {
 			const requestStartedAt = Date.now();
@@ -1105,7 +1091,7 @@ var PlatformSandbox = class PlatformSandbox extends _mastra_core_workspace.Mastr
 				this._createdAt = json.createdAt ? new Date(json.createdAt) : /* @__PURE__ */ new Date();
 				this._populateAddressFromResponse(json);
 				this._logStartComplete(json.id, startedAt, requestMs, "reattach");
-				return;
+				return { outcome: "connected" };
 			}
 			this._sandboxId = void 0;
 		} catch (error) {
@@ -1140,6 +1126,7 @@ var PlatformSandbox = class PlatformSandbox extends _mastra_core_workspace.Mastr
 		this._createdAt = json.createdAt ? new Date(json.createdAt) : /* @__PURE__ */ new Date();
 		this._populateAddressFromResponse(json);
 		this._logStartComplete(json.id, startedAt, requestMs, "provision");
+		return { outcome: "created" };
 	}
 	/**
 	* One timing summary per completed `start()` — the whole
@@ -1495,10 +1482,18 @@ var PlatformSandbox = class PlatformSandbox extends _mastra_core_workspace.Mastr
 		const started = Date.now();
 		const fullCommand = buildCommand(command, args);
 		const effectiveTimeout = options?.timeout ?? this._timeout;
+		const sandboxEnv = this.getEnv();
+		const execCallOptions = Object.keys(sandboxEnv).length > 0 ? {
+			...options,
+			env: {
+				...sandboxEnv,
+				...options?.env
+			}
+		} : options;
 		await this._awaitTransportReady();
 		const instanceUrl = this._addressRegistry?.get(this._sandboxId);
 		if (instanceUrl) {
-			const privateNet = await this._tryExecViaPrivateNetwork(instanceUrl, fullCommand, effectiveTimeout, options);
+			const privateNet = await this._tryExecViaPrivateNetwork(instanceUrl, fullCommand, effectiveTimeout, execCallOptions);
 			if (privateNet) {
 				const privateExit = privateNet.exitCode ?? 124;
 				return {
@@ -1512,7 +1507,7 @@ var PlatformSandbox = class PlatformSandbox extends _mastra_core_workspace.Mastr
 				};
 			}
 		}
-		const result = await this._runDirectExec(fullCommand, effectiveTimeout, options);
+		const result = await this._runDirectExec(fullCommand, effectiveTimeout, execCallOptions);
 		const exitCode = result.exitCode ?? 124;
 		return {
 			success: exitCode === 0,
@@ -1560,6 +1555,7 @@ var PlatformSandbox = class PlatformSandbox extends _mastra_core_workspace.Mastr
 					this._lease = null;
 					const priorSandboxId = this._sandboxId;
 					this._sandboxId = void 0;
+					this.status = "stopped";
 					throw new SandboxDestroyedError(`Sandbox ${priorSandboxId ?? "(unknown)"} was destroyed; /exec-lease returned 410`, {
 						...priorSandboxId && { sandboxId: priorSandboxId },
 						command: fullCommand,