@mastra/platform-workspace 1.2.1 → 1.3.0-alpha.1

package/CHANGELOG.md

@@ -1,5 +1,36 @@
 # @mastra/platform
 
+## 1.3.0-alpha.1
+
+### Patch Changes
+
+- PlatformSandbox restarts use the current sandbox connection after the previous sandbox is deleted or the platform does not return an instance URL, so later commands do not hit a stale sidecar. ([#21798](https://github.com/mastra-ai/mastra/pull/21798))
+
+- PlatformSandbox now restarts a timed-out sidecar health probe on the next command instead of falling back to the slower lease-based exec path for the sandbox's lifetime. If the in-sandbox sidecar was just slow to boot, later commands recover the fast private-network transport automatically. ([#21798](https://github.com/mastra-ai/mastra/pull/21798))
+
+- Declared checkpoint support (`supportsCheckpoints`) so checkpoint-based features like warm base checkpoints and boot-from-checkpoint know snapshots are real. ([#21798](https://github.com/mastra-ai/mastra/pull/21798))
+
+  ```ts
+  // Gate checkpoint-dependent work on the provider's capability flag.
+  if (sandbox.supportsCheckpoints) {
+    await sandbox.snapshot(); // persists a checkpoint that can seed a later boot
+  }
+  ```
+
+- Updated dependencies [[`c549e2f`](https://github.com/mastra-ai/mastra/commit/c549e2f40edc1cac5d9e74e82f90da22b48df084), [`c549e2f`](https://github.com/mastra-ai/mastra/commit/c549e2f40edc1cac5d9e74e82f90da22b48df084), [`2ef2f23`](https://github.com/mastra-ai/mastra/commit/2ef2f230a7aed342e7dc3b2000cd42e4c43e08a7), [`5740ec6`](https://github.com/mastra-ai/mastra/commit/5740ec60c760ffdfbfaa59d603d03b847c864e05)]:
+  - @mastra/core@1.60.0-alpha.13
+
+## 1.3.0-alpha.0
+
+### Minor Changes
+
+- Added `ProcessHandle.closeStdin()` to signal end-of-file to background processes. Local and Docker sandboxes support closing stdin, while providers without an available stdin-close API return a provider-specific unsupported-operation error. Providers signal the unsupported case with the new `UnsupportedStdinCloseError`, and the base class supplies that behavior by default so existing `ProcessHandle` subclasses keep compiling. Calling `handle.writer.end()` also closes stdin, and finishes without an error when the provider cannot close stdin. ([#21606](https://github.com/mastra-ai/mastra/pull/21606))
+
+### Patch Changes
+
+- Updated dependencies [[`4e7a421`](https://github.com/mastra-ai/mastra/commit/4e7a421dce8a48742f785d1e93ad2f43a572b282), [`242e324`](https://github.com/mastra-ai/mastra/commit/242e3241e73cbd5c9bb86a31ebb49ca0256488d4), [`217e967`](https://github.com/mastra-ai/mastra/commit/217e9672d8b3160eb729d8e9f0044949e88da239), [`d774e89`](https://github.com/mastra-ai/mastra/commit/d774e8930c781df8c9effe3763e6b501c099b6cc), [`9c27a53`](https://github.com/mastra-ai/mastra/commit/9c27a53cd9d3de4f3f025bc387d94ce371c33f95), [`dff25a1`](https://github.com/mastra-ai/mastra/commit/dff25a1103fa72ee082a9b6f805ebeb5ce400753), [`217e967`](https://github.com/mastra-ai/mastra/commit/217e9672d8b3160eb729d8e9f0044949e88da239), [`7f78585`](https://github.com/mastra-ai/mastra/commit/7f785857e401570e2ffb316911f126ed363aa537), [`f2a4afd`](https://github.com/mastra-ai/mastra/commit/f2a4afd7e37e809669001ed17724b341a5c1f45e), [`d438148`](https://github.com/mastra-ai/mastra/commit/d438148e222c1e2fb3c652725ce75680962ebec4), [`ba05fe0`](https://github.com/mastra-ai/mastra/commit/ba05fe0738f70cb686777546e968237d09269142), [`d26a8d4`](https://github.com/mastra-ai/mastra/commit/d26a8d4281f28414715b333c85bedaf70d0b2890), [`677cdc6`](https://github.com/mastra-ai/mastra/commit/677cdc6af564dec29a13464d12b7ab2a4efc22e9), [`a318490`](https://github.com/mastra-ai/mastra/commit/a318490e17da32f338d50929c770d901a9b3dd72), [`763e0c6`](https://github.com/mastra-ai/mastra/commit/763e0c61e04d76ad9a9efd301aa57525ca0cbea9), [`23e0be2`](https://github.com/mastra-ai/mastra/commit/23e0be261381e49534b4ff3101c60ee64a946cbf), [`7fc8806`](https://github.com/mastra-ai/mastra/commit/7fc880627d3cbf995d31ea0e8b807bf15417e651), [`0e02eac`](https://github.com/mastra-ai/mastra/commit/0e02eacdb2e30e1697a41910b41163742a181dc1), [`4df174c`](https://github.com/mastra-ai/mastra/commit/4df174c32bddf093a82f273070b8380aef7c9e90), [`f7c25b5`](https://github.com/mastra-ai/mastra/commit/f7c25b5106ddfb48e591f98df7a51e0f2dd01dba), [`dc09cc1`](https://github.com/mastra-ai/mastra/commit/dc09cc1083d861cde192c1cd235324dc75b8c731), [`36b4649`](https://github.com/mastra-ai/mastra/commit/36b4649045a3a380cbab8ceca866db4086223aff), [`377eb81`](https://github.com/mastra-ai/mastra/commit/377eb81ce43b964e3a6b541df172da74a8ff3716)]:
+  - @mastra/core@1.60.0-alpha.8
+
 ## 1.2.1
 
 ### Patch Changes

package/dist/index.cjs

@@ -824,6 +824,9 @@ var PlatformProcessHandle = class extends _mastra_core_workspace.ProcessHandle {
 	async sendStdin() {
 		throw new Error("Platform sandbox command execution does not support stdin");
 	}
+	async closeStdin() {
+		throw new _mastra_core_workspace.UnsupportedStdinCloseError("Platform sandbox command execution does not support closing stdin");
+	}
 };
 var PlatformProcessManager = class extends _mastra_core_workspace.SandboxProcessManager {
 	spawnCounter = 0;
@@ -935,6 +938,12 @@ var PlatformSandbox = class PlatformSandbox extends _mastra_core_workspace.Mastr
 	* failed/timed out, but now coalesced via `_leaseInFlight`).
 	*/
 	_transportReadyPromise = null;
+	/**
+	* The sidecar address of the most recent `start()`, kept so a timed-out
+	* probe can be restarted by a later exec ({@link _awaitTransportReady})
+	* instead of pinning the sandbox to the lease path for its lifetime.
+	*/
+	_probeTarget = null;
 	constructor(options = {}) {
 		super({
 			...options,
@@ -1087,14 +1096,24 @@ var PlatformSandbox = class PlatformSandbox extends _mastra_core_workspace.Mastr
 	* HTTP round-trip.
 	*
 	* `null`/absent `instanceUrl` (proxy discovery failed, or an older proxy
-	* that predates the field) leaves the registry untouched — executes fall
-	* through to the lease path with no branch here.
+	* that predates the field) evicts any stale registry address and leaves
+	* executes on the lease path.
 	*/
 	_populateAddressFromResponse(json) {
 		if (!this._addressRegistry) return;
-		if (!json.instanceUrl) return;
+		if (!json.instanceUrl) {
+			this._probeGeneration++;
+			this._probeTarget = null;
+			this._transportReadyPromise = null;
+			this._addressRegistry.delete(json.id);
+			return;
+		}
 		this._addressRegistry.delete(json.id);
 		const generation = ++this._probeGeneration;
+		this._probeTarget = {
+			sandboxId: json.id,
+			instanceUrl: json.instanceUrl
+		};
 		this._transportReadyPromise = this._probeSidecarThenRegister(json.id, json.instanceUrl, generation);
 	}
 	/**
@@ -1104,8 +1123,9 @@ var PlatformSandbox = class PlatformSandbox extends _mastra_core_workspace.Mastr
 	* fall back to the lease path until the probe succeeds.
 	*
 	* If the sidecar never comes up within {@link SIDECAR_PROBE_TIMEOUT_MS},
-	* the registry stays unpopulated and all execs go via lease for this
-	* sandbox's lifetime (or until a future `start()` re-runs the probe).
+	* the registry stays unpopulated, `_transportReadyPromise` is cleared,
+	* and a later {@link _awaitTransportReady} call restarts the probe
+	* instead of pinning this sandbox to the lease path.
 	*
 	* @param generation - The probe generation captured at call time. If this
 	*   no longer matches `_probeGeneration` when the probe succeeds, the probe
@@ -1139,6 +1159,7 @@ var PlatformSandbox = class PlatformSandbox extends _mastra_core_workspace.Mastr
 			} catch {}
 			await new Promise((r) => setTimeout(r, SIDECAR_PROBE_INTERVAL_MS));
 		}
+		if (generation === this._probeGeneration && this._transportReadyPromise) this._transportReadyPromise = null;
 		this.logger.warn("platform-workspace probe timed out", {
 			sandboxId,
 			sessionId: this._client.sessionId,
@@ -1159,7 +1180,12 @@ var PlatformSandbox = class PlatformSandbox extends _mastra_core_workspace.Mastr
 	*/
 	async _awaitTransportReady() {
 		if (this._sandboxId && this._addressRegistry?.get(this._sandboxId)) return;
-		if (!this._transportReadyPromise) return;
+		if (!this._transportReadyPromise) {
+			const target = this._probeTarget;
+			if (!target || this._sandboxId !== target.sandboxId) return;
+			const generation = ++this._probeGeneration;
+			this._transportReadyPromise = this._probeSidecarThenRegister(target.sandboxId, target.instanceUrl, generation);
+		}
 		await Promise.race([this._transportReadyPromise, new Promise((r) => setTimeout(r, TRANSPORT_READY_WAIT_MS))]);
 	}
 	/**
@@ -1226,6 +1252,8 @@ var PlatformSandbox = class PlatformSandbox extends _mastra_core_workspace.Mastr
 		if (!this._sandboxId) return;
 		const destroyedSandboxId = this._sandboxId;
 		this._probeGeneration++;
+		this._probeTarget = null;
+		this._transportReadyPromise = null;
 		await this._client.request(`/sandbox/${encodeURIComponent(destroyedSandboxId)}`, { method: "DELETE" });
 		this._sandboxId = void 0;
 		this._createdAt = null;
@@ -1236,6 +1264,8 @@ var PlatformSandbox = class PlatformSandbox extends _mastra_core_workspace.Mastr
 	async snapshot() {
 		await this.captureCheckpoint();
 	}
+	/** Snapshots persist real checkpoints that can seed future sandboxes. */
+	supportsCheckpoints = true;
 	/**
 	* Capture the sandbox's checkpoint on demand, outside any refresh timer the
 	* workspace-proxy owns internally.
@@ -1355,6 +1385,9 @@ var PlatformSandbox = class PlatformSandbox extends _mastra_core_workspace.Mastr
 	* the cached `'running'` state (see `MastraSandbox._start`).
 	*/
 	_clearDestroyedState(destroyedSandboxId) {
+		this._probeGeneration++;
+		this._probeTarget = null;
+		this._transportReadyPromise = null;
 		this._sandboxId = void 0;
 		this._createdAt = null;
 		this._lease = null;