@mastra/e2b 0.10.0-alpha.4 → 0.10.0
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/CHANGELOG.md +53 -0
- package/dist/index.cjs +39 -22
- package/dist/index.cjs.map +1 -1
- package/dist/index.js +39 -22
- package/dist/index.js.map +1 -1
- package/dist/sandbox/index.d.ts +28 -9
- package/dist/sandbox/index.d.ts.map +1 -1
- package/package.json +6 -6
package/dist/sandbox/index.d.ts
CHANGED
|
@@ -17,7 +17,7 @@ type InstructionsOption = string | ((opts: {
|
|
|
17
17
|
}) => string);
|
|
18
18
|
import { MastraSandbox } from '@mastra/core/workspace';
|
|
19
19
|
import { Sandbox } from 'e2b';
|
|
20
|
-
import type { SandboxLifecycle, SandboxNetworkOpts } from 'e2b';
|
|
20
|
+
import type { SandboxConnectOpts, SandboxLifecycle, SandboxNetworkOpts, SandboxOpts } from 'e2b';
|
|
21
21
|
import type { TemplateSpec } from '../utils/template.js';
|
|
22
22
|
import { E2BProcessManager } from './process-manager.js';
|
|
23
23
|
/**
|
|
@@ -133,8 +133,8 @@ export interface E2BSandboxOptions extends Omit<MastraSandboxOptions, 'processes
|
|
|
133
133
|
*/
|
|
134
134
|
export declare class E2BSandbox extends MastraSandbox<Sandbox> {
|
|
135
135
|
readonly id: string;
|
|
136
|
-
readonly name
|
|
137
|
-
readonly provider
|
|
136
|
+
readonly name: string;
|
|
137
|
+
readonly provider: string;
|
|
138
138
|
status: ProviderStatus;
|
|
139
139
|
readonly mounts: MountManager;
|
|
140
140
|
readonly processes: E2BProcessManager;
|
|
@@ -148,20 +148,20 @@ export declare class E2BSandbox extends MastraSandbox<Sandbox> {
|
|
|
148
148
|
* deployments without waking a paused sandbox.
|
|
149
149
|
*/
|
|
150
150
|
readonly networking: SandboxNetworking;
|
|
151
|
-
|
|
151
|
+
protected _sandbox: Sandbox | null;
|
|
152
152
|
private _createdAt;
|
|
153
153
|
private _isRetrying;
|
|
154
154
|
private readonly timeout;
|
|
155
|
-
|
|
155
|
+
protected readonly templateSpec?: TemplateSpec;
|
|
156
156
|
private readonly metadata;
|
|
157
157
|
private readonly network?;
|
|
158
158
|
private readonly lifecycle;
|
|
159
|
-
|
|
159
|
+
protected readonly connectionOpts: Record<string, string>;
|
|
160
160
|
private readonly _preferredSandboxId?;
|
|
161
161
|
private readonly _instructionsOverride?;
|
|
162
162
|
private readonly _constructorOptions;
|
|
163
163
|
/** Resolved template ID after building (if needed) */
|
|
164
|
-
|
|
164
|
+
protected _resolvedTemplateId?: string;
|
|
165
165
|
/** Promise for template preparation (started in constructor) */
|
|
166
166
|
private _templatePreparePromise?;
|
|
167
167
|
constructor(options?: E2BSandboxOptions);
|
|
@@ -308,6 +308,19 @@ export declare class E2BSandbox extends MastraSandbox<Sandbox> {
|
|
|
308
308
|
* Connecting to a paused sandbox resumes it.
|
|
309
309
|
*/
|
|
310
310
|
private findExistingSandbox;
|
|
311
|
+
/**
|
|
312
|
+
* Create a new SDK sandbox from a resolved template ID.
|
|
313
|
+
*
|
|
314
|
+
* Override point for providers layered on the E2B SDK whose `Sandbox`
|
|
315
|
+
* class extends `e2b`'s (e.g. `@e2b/desktop`): override to call their
|
|
316
|
+
* `Sandbox.create`. Connection options are already spread into `opts`.
|
|
317
|
+
*/
|
|
318
|
+
protected createSdkSandbox(templateId: string, opts: SandboxOpts): Promise<Sandbox>;
|
|
319
|
+
/**
|
|
320
|
+
* Connect to (and resume) an existing SDK sandbox by its E2B sandbox ID.
|
|
321
|
+
* Override point — see {@link createSdkSandbox}.
|
|
322
|
+
*/
|
|
323
|
+
protected connectSdkSandbox(sandboxId: string, opts: SandboxConnectOpts): Promise<Sandbox>;
|
|
311
324
|
/**
|
|
312
325
|
* Resolve the template specification to a template ID.
|
|
313
326
|
*
|
|
@@ -315,12 +328,18 @@ export declare class E2BSandbox extends MastraSandbox<Sandbox> {
|
|
|
315
328
|
* - TemplateBuilder: Build and return the template ID
|
|
316
329
|
* - Function: Apply to base mountable template, then build
|
|
317
330
|
* - undefined: Use default mountable template (cached)
|
|
331
|
+
*
|
|
332
|
+
* Override point: subclasses with a different default template (e.g.
|
|
333
|
+
* desktop sandboxes) override this and {@link buildDefaultTemplate}.
|
|
318
334
|
*/
|
|
319
|
-
|
|
335
|
+
protected resolveTemplate(): Promise<string>;
|
|
320
336
|
/**
|
|
321
337
|
* Build the default mountable template (bypasses exists check).
|
|
338
|
+
*
|
|
339
|
+
* Override point: called from the template-not-found retry path in
|
|
340
|
+
* `start()` when no explicit template was configured.
|
|
322
341
|
*/
|
|
323
|
-
|
|
342
|
+
protected buildDefaultTemplate(): Promise<string>;
|
|
324
343
|
/**
|
|
325
344
|
* Write marker file for detecting config changes on reconnect.
|
|
326
345
|
* Stores both the mount path and config hash in the file.
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sandbox/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,KAAK,EACV,WAAW,EACX,mBAAmB,EACnB,WAAW,EAEX,cAAc,EACd,YAAY,EACZ,oBAAoB,EACpB,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,EAEpB,MAAM,wBAAwB,CAAC;AAEhC;;GAEG;AACH,KAAK,kBAAkB,GAAG,MAAM,GAAG,CAAC,CAAC,IAAI,EAAE;IAAE,mBAAmB,EAAE,MAAM,CAAC;IAAC,cAAc,CAAC,EAAE,cAAc,CAAA;CAAE,KAAK,MAAM,CAAC,CAAC;AACxH,OAAO,EAAE,aAAa,EAAwB,MAAM,wBAAwB,CAAC;AAC7E,OAAO,EAAE,OAAO,EAAY,MAAM,KAAK,CAAC;AACxC,OAAO,KAAK,
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sandbox/index.ts"],"names":[],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@mastra/e2b",
|
|
3
|
-
"version": "0.10.0
|
|
3
|
+
"version": "0.10.0",
|
|
4
4
|
"description": "E2B cloud sandbox provider for Mastra workspaces",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "dist/index.js",
|
|
@@ -32,12 +32,12 @@
|
|
|
32
32
|
"tsdown": "0.22.9",
|
|
33
33
|
"typescript": "^6.0.3",
|
|
34
34
|
"vitest": "4.1.10",
|
|
35
|
-
"@internal/lint": "0.0.
|
|
36
|
-
"@
|
|
37
|
-
"@internal/workspace-test-utils": "0.0.
|
|
35
|
+
"@internal/lint": "0.0.126",
|
|
36
|
+
"@mastra/core": "1.62.0",
|
|
37
|
+
"@internal/workspace-test-utils": "0.0.70",
|
|
38
|
+
"@internal/types-builder": "0.0.101",
|
|
38
39
|
"@mastra/gcs": "0.3.2",
|
|
39
|
-
"@mastra/s3": "0.6.1"
|
|
40
|
-
"@mastra/core": "1.62.0-alpha.11"
|
|
40
|
+
"@mastra/s3": "0.6.1"
|
|
41
41
|
},
|
|
42
42
|
"peerDependencies": {
|
|
43
43
|
"@mastra/core": ">=1.55.0-0 <2.0.0-0"
|