@mastra/e2b 0.0.0

package/dist/utils/template.d.ts

@@ -0,0 +1,84 @@
+import type { TemplateBuilder } from 'e2b';
+/**
+ * Template specification for E2B sandbox.
+ *
+ * Can be:
+ * - `string` - Existing template ID (e.g., 'base', 'my-custom-template')
+ * - `TemplateBuilder` - A built template object from Template()
+ * - `(base: TemplateBuilder) => TemplateBuilder` - Callback to customize the base template
+ *
+ * @example Using template ID
+ * ```typescript
+ * new E2BSandbox({ template: 'my-custom-template' })
+ * ```
+ *
+ * @example Using Template builder
+ * ```typescript
+ * import { Template } from 'e2b';
+ *
+ * new E2BSandbox({
+ *   template: Template()
+ *     .fromUbuntuImage('22.04')
+ *     .aptInstall(['s3fs', 'curl'])
+ *     .setEnvs({ NODE_ENV: 'production' })
+ * })
+ * ```
+ *
+ * @example Customizing default mountable template
+ * ```typescript
+ * new E2BSandbox({
+ *   template: base => base
+ *     .aptInstall(['nodejs', 'npm'])
+ *     .runCmd('npm install -g typescript')
+ * })
+ * ```
+ */
+export type TemplateSpec = string | TemplateBuilder | ((base: TemplateBuilder) => TemplateBuilder);
+/**
+ * Result from createMountableTemplate containing both the template and its ID.
+ */
+export interface MountableTemplateResult {
+    /** The template builder with mount dependencies */
+    template: TemplateBuilder;
+    /** Deterministic template ID for caching */
+    id: string;
+    /** List of apt packages installed in the template */
+    aptPackages: string[];
+}
+/**
+ * Version of the default mountable template.
+ * Increment this when changing the default template dependencies.
+ */
+export declare const MOUNTABLE_TEMPLATE_VERSION = "v1";
+/**
+ * Create a base template with FUSE mounting dependencies pre-installed.
+ *
+ * This template includes s3fs and fuse packages required for mounting
+ * cloud filesystems (S3, GCS, R2) into the sandbox.
+ *
+ * The returned `id` is deterministic, allowing E2BSandbox to check if
+ * the template already exists before building it.
+ *
+ * @example Basic usage
+ * ```typescript
+ * const { template, id } = createMountableTemplate();
+ * // First time: builds and caches the template
+ * // Subsequent times: reuses existing template
+ * const sandbox = new E2BSandbox({ template });
+ * ```
+ *
+ * @example With customization
+ * ```typescript
+ * const { template } = createMountableTemplate();
+ * const customTemplate = template
+ *   .aptInstall(['nodejs', 'npm'])
+ *   .runCmd('npm install -g typescript');
+ *
+ * // Note: customized templates get a unique ID, not the cached one
+ * const sandbox = new E2BSandbox({ template: customTemplate });
+ * ```
+ *
+ * @returns Object with template builder and deterministic ID
+ */
+export declare function createDefaultMountableTemplate(): MountableTemplateResult;
+//# sourceMappingURL=template.d.ts.map

package/dist/utils/template.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.d.ts","sourceRoot":"","sources":["../../src/utils/template.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,KAAK,CAAC;AAM3C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,eAAe,GAAG,CAAC,CAAC,IAAI,EAAE,eAAe,KAAK,eAAe,CAAC,CAAC;AAEnG;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,mDAAmD;IACnD,QAAQ,EAAE,eAAe,CAAC;IAC1B,4CAA4C;IAC5C,EAAE,EAAE,MAAM,CAAC;IACX,qDAAqD;IACrD,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED;;;GAGG;AACH,eAAO,MAAM,0BAA0B,OAAO,CAAC;AAE/C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,8BAA8B,IAAI,uBAAuB,CAmBxE"}

package/package.json

@@ -0,0 +1,70 @@
+{
+  "name": "@mastra/e2b",
+  "version": "0.0.0",
+  "description": "E2B cloud sandbox provider for Mastra workspaces",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.cjs"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "license": "Apache-2.0",
+  "dependencies": {
+    "e2b": "^2.12.1"
+  },
+  "devDependencies": {
+    "@types/node": "22.19.7",
+    "@vitest/coverage-v8": "4.0.12",
+    "@vitest/ui": "4.0.12",
+    "dotenv": "^17.2.3",
+    "eslint": "^9.37.0",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3",
+    "vitest": "4.0.16",
+    "@internal/lint": "0.0.57",
+    "@internal/workspace-test-utils": "0.0.1",
+    "@internal/types-builder": "0.0.32",
+    "@mastra/core": "1.2.1-alpha.0",
+    "@mastra/gcs": "0.0.0",
+    "@mastra/s3": "0.0.0"
+  },
+  "peerDependencies": {
+    "@mastra/core": ">=1.3.0-0 <2.0.0-0"
+  },
+  "files": [
+    "dist",
+    "CHANGELOG.md"
+  ],
+  "homepage": "https://mastra.ai",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mastra-ai/mastra.git",
+    "directory": "workspaces/e2b"
+  },
+  "bugs": {
+    "url": "https://github.com/mastra-ai/mastra/issues"
+  },
+  "engines": {
+    "node": ">=22.13.0"
+  },
+  "scripts": {
+    "build": "tsup --silent --config tsup.config.ts",
+    "build:lib": "pnpm build",
+    "build:watch": "pnpm build --watch",
+    "test:unit": "vitest run --exclude '**/*.integration.test.ts'",
+    "test:watch": "vitest watch",
+    "test": "vitest run ./src/**/*.integration.test.ts",
+    "test:cloud": "pnpm test",
+    "lint": "eslint ."
+  }
+}