@mastra/platform-workspace 1.7.0-alpha.0 → 1.7.0-alpha.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/index.cjs +46 -19
- package/dist/index.cjs.map +1 -1
- package/dist/index.js +47 -20
- package/dist/index.js.map +1 -1
- package/dist/sandbox.d.ts +33 -15
- package/dist/sandbox.d.ts.map +1 -1
- package/package.json +3 -3
package/dist/sandbox.d.ts
CHANGED
|
@@ -35,6 +35,15 @@ export interface PlatformSandboxOptions extends Omit<MastraSandboxOptions, 'proc
|
|
|
35
35
|
id?: string;
|
|
36
36
|
environmentId?: string;
|
|
37
37
|
sandboxId?: string;
|
|
38
|
+
/**
|
|
39
|
+
* What `start()` does when `sandboxId` is set but the platform reports that
|
|
40
|
+
* sandbox is gone (404, 410, or a destroyed record).
|
|
41
|
+
*
|
|
42
|
+
* - `'best-effort'` (default): provision a replacement sandbox.
|
|
43
|
+
* - `'required'`: throw a `SandboxError` with code `SANDBOX_REATTACH_FAILED`
|
|
44
|
+
* instead of provisioning, so the caller can surface the lost VM.
|
|
45
|
+
*/
|
|
46
|
+
reattach?: 'best-effort' | 'required';
|
|
38
47
|
/** Boot-only fallback checkpoint for a fresh sandbox whose primary recovery key has no state. */
|
|
39
48
|
seedCheckpointName?: string;
|
|
40
49
|
/**
|
|
@@ -210,10 +219,19 @@ export declare class PlatformSandbox extends MastraSandbox {
|
|
|
210
219
|
* on a later start.
|
|
211
220
|
*/
|
|
212
221
|
templatePending?: SandboxTemplatePending;
|
|
222
|
+
/**
|
|
223
|
+
* The platform's id for the provisioned sandbox, as returned by the create
|
|
224
|
+
* or reattach response. Persist this to reattach later via the `sandboxId`
|
|
225
|
+
* option. Undefined until the sandbox has been started in this process; a
|
|
226
|
+
* `sandboxId` passed to the constructor is only a hint for `start()` and is
|
|
227
|
+
* not reported here until the proxy confirms it.
|
|
228
|
+
*/
|
|
229
|
+
get sandboxId(): string | undefined;
|
|
213
230
|
private readonly _client;
|
|
214
231
|
private readonly _usesProviderRoutes;
|
|
215
232
|
private readonly _environmentId;
|
|
216
233
|
private _sandboxId?;
|
|
234
|
+
private readonly _reattach;
|
|
217
235
|
private readonly _seedCheckpointName?;
|
|
218
236
|
private _templateDefinition?;
|
|
219
237
|
private _templateBuildEnvs?;
|
|
@@ -295,6 +313,7 @@ export declare class PlatformSandbox extends MastraSandbox {
|
|
|
295
313
|
private _probeTarget;
|
|
296
314
|
constructor(options?: PlatformSandboxOptions);
|
|
297
315
|
private generateId;
|
|
316
|
+
private _failIfReattachRequired;
|
|
298
317
|
private _request;
|
|
299
318
|
/**
|
|
300
319
|
* Construct a sibling {@link PlatformSandbox} that inherits this sandbox's
|
|
@@ -383,17 +402,19 @@ export declare class PlatformSandbox extends MastraSandbox {
|
|
|
383
402
|
*/
|
|
384
403
|
private _awaitTransportReady;
|
|
385
404
|
/**
|
|
386
|
-
* Stop the sandbox
|
|
405
|
+
* Stop this process's use of the sandbox without touching the remote one.
|
|
387
406
|
*
|
|
388
|
-
*
|
|
389
|
-
*
|
|
390
|
-
* `
|
|
391
|
-
*
|
|
392
|
-
*
|
|
407
|
+
* Nothing is sent to workspace-proxy. The VM keeps running and idles out
|
|
408
|
+
* under the environment's own idle policy, the recovery checkpoint stays,
|
|
409
|
+
* and `_sandboxId` is kept so a later `start()` on this instance, or on a
|
|
410
|
+
* new instance constructed with the same `id` or `sandboxId`, reattaches
|
|
411
|
+
* instead of provisioning. `Mastra.shutdown()` stops every registered
|
|
412
|
+
* workspace on SIGINT; releasing the VM here would destroy every live
|
|
413
|
+
* session on a host restart. Use {@link destroy} to release the VM and
|
|
414
|
+
* its checkpoint.
|
|
393
415
|
*
|
|
394
|
-
*
|
|
395
|
-
*
|
|
396
|
-
* {@link destroy} when you want the checkpoint released too.
|
|
416
|
+
* Any in-flight capture is awaited first so the checkpoint reflects the
|
|
417
|
+
* latest disk state the caller asked for.
|
|
397
418
|
*/
|
|
398
419
|
stop(): Promise<void>;
|
|
399
420
|
/**
|
|
@@ -416,12 +437,9 @@ export declare class PlatformSandbox extends MastraSandbox {
|
|
|
416
437
|
/**
|
|
417
438
|
* Release the remote sandbox VM and clear the local state pointing at it.
|
|
418
439
|
*
|
|
419
|
-
*
|
|
420
|
-
*
|
|
421
|
-
*
|
|
422
|
-
* route does not touch the checkpoint on its own, so `stop()` correctly
|
|
423
|
-
* leaves the checkpoint intact and `destroy()` has already removed it
|
|
424
|
-
* before this call.
|
|
440
|
+
* Body of {@link destroy}, called after the checkpoint has been released.
|
|
441
|
+
* The proxy's DELETE route releases the VM (on E2B that kills it), so
|
|
442
|
+
* only destroy() may reach here; stop() never does.
|
|
425
443
|
*/
|
|
426
444
|
private _teardownSandbox;
|
|
427
445
|
/** Persist the configured recovery checkpoint when available. */
|
package/dist/sandbox.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"sandbox.d.ts","sourceRoot":"","sources":["../src/sandbox.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,KAAK,EACV,aAAa,EACb,qBAAqB,EACrB,kBAAkB,EAClB,oBAAoB,EACpB,WAAW,EACX,cAAc,EACd,mBAAmB,EACnB,WAAW,EACX,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,aAAa,EACb,aAAa,
|
|
1
|
+
{"version":3,"file":"sandbox.d.ts","sourceRoot":"","sources":["../src/sandbox.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,KAAK,EACV,aAAa,EACb,qBAAqB,EACrB,kBAAkB,EAClB,oBAAoB,EACpB,WAAW,EACX,cAAc,EACd,mBAAmB,EACnB,WAAW,EACX,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,aAAa,EACb,aAAa,EAIb,qBAAqB,EACtB,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,qBAAqB,EAA0B,MAAM,aAAa,CAAC;AAEjF,OAAO,KAAK,EAAE,0BAA0B,EAAa,MAAM,kBAAkB,CAAC;AAE9E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEnD,OAAO,KAAK,EAA+C,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE1G,OAAO,KAAK,EAAE,sBAAsB,EAA6B,MAAM,eAAe,CAAC;AAGvF,MAAM,MAAM,+BAA+B,GAAG,UAAU,GAAG,SAAS,CAAC;AAErE,MAAM,MAAM,uBAAuB,GAC/B,sBAAsB,GACtB,CAAC,MAAM,sBAAsB,GAAG,SAAS,GAAG,OAAO,CAAC,sBAAsB,GAAG,SAAS,CAAC,CAAC,CAAC;AAE7F;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,WAAW,sBAAsB;IACrC,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAClD,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IAC3C,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC;AAED,MAAM,WAAW,sBAAuB,SAAQ,IAAI,CAAC,oBAAoB,EAAE,WAAW,CAAC,EAAE,qBAAqB;IAC5G,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAE,aAAa,GAAG,UAAU,CAAC;IACtC,iGAAiG;IACjG,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B;;;;;;;;;;;;;OAaG;IACH,QAAQ,CAAC,EAAE,uBAAuB,CAAC;IACnC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,gBAAgB,CAAC,EAAE,+BAA+B,CAAC;IACnD,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,kBAAkB,CAAC;IAClC;;;;;OAKG;IACH,gBAAgB,CAAC,EAAE,0BAA0B,CAAC;IAC9C,6DAA6D;IAC7D,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B;;;;;;OAMG;IACH,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC;;;;;;;;;;;OAWG;IACH,eAAe,CAAC,EAAE,sBAAsB,CAAC;CAC1C;AA6DD;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,sBAAsB;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;CACtB;AAqBD;;;;;;;;;GASG;AACH,qBAAa,yBAA0B,SAAQ,KAAK;IAClD,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IACzC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAE5B,YACE,OAAO,EAAE,MAAM,EACf,WAAW,EAAE;QACX,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,OAAO,CAAC;QAChB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,UAAU,EAAE,MAAM,CAAC;KACpB,EAWF;CACF;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,MAAM,uBAAuB,GAC/B;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,GAC9C;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,GAC/C;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,+BAA+B,GAAG,qBAAqB,CAAA;CAAE,CAAC;AAE3F;;;;;;;;;;GAUG;AACH,qBAAa,qBAAsB,SAAQ,KAAK;IAC9C,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE1B,YAAY,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,EAMlG;CACF;AAkED,cAAM,sBAAuB,SAAQ,qBAAqB,CAAC,eAAe,CAAC;IACzE,OAAO,CAAC,YAAY,CAAK;IAEzB;;;;;;OAMG;IACG,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,mBAAwB,GAAG,OAAO,CAAC,aAAa,CAAC,CAMtF;IAEK,IAAI,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC,CAOnC;CACF;AAED,qBAAa,eAAgB,SAAQ,aAAa;IAChD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,qBAAqB;IAClC,QAAQ,CAAC,QAAQ,cAAc;IAC/B,MAAM,EAAE,cAAc,CAAa;IACnC,SAAiB,SAAS,EAAE,sBAAsB,CAAC;IACnD;;;;;;;;;OASG;IACH,eAAe,CAAC,EAAE,sBAAsB,CAAC;IAEzC;;;;;;OAMG;IACH,IAAI,SAAS,IAAI,MAAM,GAAG,SAAS,CAElC;IAED,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiB;IACzC,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAU;IAC9C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,UAAU,CAAC,CAAS;IAC5B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA6B;IACvD,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAC,CAAS;IAC9C,OAAO,CAAC,mBAAmB,CAAC,CAA4B;IACxD,OAAO,CAAC,kBAAkB,CAAC,CAAyB;IACpD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAA0B;IACrD,OAAO,CAAC,2BAA2B,CAAC,CAAgB;IACpD,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAC,CAAS;IAC9C,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAAkC;IACrE,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAyB;IAC9C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAC,CAAqB;IAC5D,OAAO,CAAC,UAAU,CAAqB;IACvC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAA6B;IAChE,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAgB;IAC/C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAkB;IACpD;;;;;;;;;;OAUG;IACH,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAyB;IAC3D;;;;;OAKG;IACH,OAAO,CAAC,MAAM,CAAgC;IAC9C;;;;;OAKG;IACH,OAAO,CAAC,cAAc,CAAyC;IAC/D;;;;;;;;OAQG;IACH,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAU;IAC1C;;;;;OAKG;IACH,OAAO,CAAC,gBAAgB,CAAiD;IACzE;;;;;OAKG;IACH,OAAO,CAAC,gBAAgB,CAAK;IAC7B;;;;;;;OAOG;IACH,OAAO,CAAC,sBAAsB,CAA8B;IAC5D;;;;OAIG;IACH,OAAO,CAAC,YAAY,CAA2D;IAE/E,YAAY,OAAO,GAAE,sBAA2B,EAqB/C;IAED,OAAO,CAAC,UAAU;IAIlB,OAAO,CAAC,uBAAuB;IAe/B,OAAO,CAAC,QAAQ;IAIhB;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,OAAO,GAAE,mBAAwB,GAAG,eAAe,CA6CxD;IAED;;;;;;;;;;;;OAYG;IACG,KAAK,IAAI,OAAO,CAAC,kBAAkB,CAAC,CAqFzC;YAEa,oBAAoB;YAWpB,gBAAgB;IAa9B;;;;;;;;;;OAUG;IACH,OAAO,CAAC,iBAAiB;IAUzB;;;;;;;;;;;;;;;OAeG;IACH,OAAO,CAAC,4BAA4B;IA0BpC;;;;;;;;;;;;;;OAcG;YACW,yBAAyB;IAqDvC;;;;;;;;;;OAUG;YACW,oBAAoB;IAoBlC;;;;;;;;;;;;;;OAcG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAc1B;IAED;;;;;;;;;;;;;;;OAeG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAiC7B;IAED;;;;;;OAMG;YACW,gBAAgB;IA2B9B,iEAAiE;IAC3D,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAE9B;IAED,yEAAyE;IACzE,QAAQ,CAAC,mBAAmB,EAAE,OAAO,CAAQ;IAE7C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAyCG;IACG,iBAAiB,IAAI,OAAO,CAAC,uBAAuB,CAAC,CAyB1D;IAED;;;;;;;;;OASG;YACW,oBAAoB;IA8BlC;;;;;;;;;OASG;IACH,OAAO,CAAC,oBAAoB;IAW5B;;;;;;;;;;;;;;;;OAgBG;IACG,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,aAAa,CAAC,CAoF9G;IAED;;;;;;;;;;;;;;;;;;;;OAoBG;IACH;;;;;;OAMG;IACH,OAAO,CAAC,QAAQ;YAQF,cAAc;IAiG5B;;;;;;;;;;;;OAYG;YACW,yBAAyB;IA0DvC;;;;;OAKG;IACH,OAAO,CAAC,kBAAkB;IAI1B;;;;;;OAMG;YACW,YAAY;IA6CpB,OAAO,IAAI,OAAO,CAAC,WAAW,CAAC,CA0DpC;IAED,eAAe,CAAC,IAAI,CAAC,EAAE;QAAE,cAAc,CAAC,EAAE,cAAc,CAAA;KAAE,GAAG,MAAM,CAOlE;CACF"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@mastra/platform-workspace",
|
|
3
|
-
"version": "1.7.0-alpha.
|
|
3
|
+
"version": "1.7.0-alpha.2",
|
|
4
4
|
"description": "Mastra Platform workspace sandbox and filesystem providers",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "dist/index.js",
|
|
@@ -28,9 +28,9 @@
|
|
|
28
28
|
"typescript": "^7.0.2",
|
|
29
29
|
"vitest": "4.1.11",
|
|
30
30
|
"@internal/lint": "0.0.141",
|
|
31
|
-
"@internal/workspace": "0.0.13",
|
|
32
31
|
"@internal/types-builder": "0.0.116",
|
|
33
|
-
"@
|
|
32
|
+
"@internal/workspace": "0.0.13",
|
|
33
|
+
"@mastra/core": "1.76.0-alpha.9"
|
|
34
34
|
},
|
|
35
35
|
"peerDependencies": {
|
|
36
36
|
"@mastra/core": ">=1.62.0-0 <2.0.0-0"
|