@mastra/isolated-vm 0.1.1 → 0.1.2-alpha.1

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.
Files changed (5) hide show
  1. package/LICENSE.md +6 -4
  2. package/README.md +53 -0
  3. package/dist/transport.d.ts.map +1 -1
  4. package/package.json +6 -7
  5. package/CHANGELOG.md +0 -59
package/LICENSE.md CHANGED
@@ -1,10 +1,12 @@
1
1
  Portions of this software are licensed as follows:
2
2
 
3
- - All content that resides under any directory named "ee/" within this
3
+ - All content that resides under any directory named `ee/` within this
4
4
  repository, including but not limited to:
5
- - `packages/core/src/auth/ee/`
6
- - `packages/server/src/server/auth/ee/`
7
- is licensed under the license defined in `ee/LICENSE`.
5
+ - `@mastra/core/auth/ee`
6
+ - `@mastra/core/agent-builder/ee`
7
+ - `@mastra/editor/ee`
8
+
9
+ is licensed under the license defined in [`ee/LICENSE`](https://github.com/mastra-ai/mastra/blob/main/ee/LICENSE).
8
10
 
9
11
  - All third-party components incorporated into the Mastra Software are
10
12
  licensed under the original license provided by the owner of the
package/README.md ADDED
@@ -0,0 +1,53 @@
1
+ # @mastra/isolated-vm
2
+
3
+ `IsolatedVmCodeModeTransport` runs model-authored Code Mode programs inside an in-process V8 isolate. Use it when you need a strong execution boundary without starting a separate sandbox process; the isolate has no direct filesystem, network, or process access.
4
+
5
+ ## Installation
6
+
7
+ ```bash
8
+ npm install @mastra/isolated-vm
9
+ ```
10
+
11
+ ## Usage
12
+
13
+ On Node.js 20 and later, start the host process with `--no-node-snapshot` because `isolated-vm` is a native addon.
14
+
15
+ ```typescript
16
+ import { Agent } from '@mastra/core/agent';
17
+ import { createCodeMode, createTool } from '@mastra/core/tools';
18
+ import { IsolatedVmCodeModeTransport } from '@mastra/isolated-vm';
19
+ import { z } from 'zod';
20
+
21
+ const getPrice = createTool({
22
+ id: 'getPrice',
23
+ description: 'Get the price of a product',
24
+ inputSchema: z.object({ productId: z.string() }),
25
+ outputSchema: z.object({ price: z.number() }),
26
+ execute: async ({ productId }) => ({ price: productId === 'pro' ? 49 : 19 }),
27
+ });
28
+
29
+ const { tool, instructions } = createCodeMode(
30
+ { tools: { getPrice } },
31
+ new IsolatedVmCodeModeTransport({ memoryLimitMb: 128 }),
32
+ );
33
+
34
+ const agent = new Agent({
35
+ id: 'pricing-agent',
36
+ name: 'Pricing agent',
37
+ instructions: ['Answer pricing questions.', instructions],
38
+ model: 'openai/gpt-5.6-sol',
39
+ tools: { execute_typescript: tool },
40
+ });
41
+ ```
42
+
43
+ ## Documentation
44
+
45
+ - [Reference: IsolatedVmCodeModeTransport](https://mastra.ai/reference/tools/isolated-vm-transport)
46
+
47
+ ## Changelog
48
+
49
+ See the [package changelog](https://github.com/mastra-ai/mastra/blob/main/code-mode/isolated-vm/CHANGELOG.md) for version history and release notes.
50
+
51
+ ## Support
52
+
53
+ We have an [open community Discord](https://discord.gg/mastra-ai). Come and say hello and let us know if you have any questions or need any help getting things running.
package/dist/transport.d.ts.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAGH,OAAO,KAAK,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAOhF,MAAM,WAAW,kCAAkC;IACjD;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAiCD;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,2BAA4B,YAAW,iBAAiB;;IACnE,QAAQ,CAAC,eAAe,SAAS;gBAIrB,OAAO,GAAE,kCAAuC;IAKtD,GAAG,CAAC,IAAI,EAAE,UAAU,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,kBAAkB,CAAC;CA+OtF"}
1
+ {"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAGH,OAAO,KAAK,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAOhF,MAAM,WAAW,kCAAkC;IACjD;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAiCD;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,2BAA4B,YAAW,iBAAiB;;IACnE,QAAQ,CAAC,eAAe,SAAS;IAIjC,YAAY,OAAO,GAAE,kCAAuC,EAG3D;IAEK,GAAG,CAAC,IAAI,EAAE,UAAU,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,kBAAkB,CAAC,CA8OpF;CACF"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@mastra/isolated-vm",
3
- "version": "0.1.1",
3
+ "version": "0.1.2-alpha.1",
4
4
  "description": "In-process V8 isolate Code Mode transport for Mastra, backed by isolated-vm",
5
5
  "type": "module",
6
6
  "main": "dist/index.js",
@@ -28,18 +28,17 @@
28
28
  "@vitest/coverage-v8": "4.1.10",
29
29
  "eslint": "^10.7.0",
30
30
  "tsdown": "0.22.9",
31
- "typescript": "^6.0.3",
31
+ "typescript": "^7.0.2",
32
32
  "vitest": "4.1.10",
33
- "@internal/lint": "0.0.125",
34
- "@internal/types-builder": "0.0.100",
35
- "@mastra/core": "1.61.0"
33
+ "@internal/lint": "0.0.129",
34
+ "@mastra/core": "1.64.0-alpha.7",
35
+ "@internal/types-builder": "0.0.104"
36
36
  },
37
37
  "peerDependencies": {
38
38
  "@mastra/core": ">=1.55.0-0 <2.0.0-0"
39
39
  },
40
40
  "files": [
41
- "dist",
42
- "CHANGELOG.md"
41
+ "dist"
43
42
  ],
44
43
  "homepage": "https://mastra.ai",
45
44
  "repository": {
package/CHANGELOG.md DELETED
@@ -1,59 +0,0 @@
1
- # @mastra/isolated-vm
2
-
3
- ## 0.1.1
4
-
5
- ### Patch Changes
6
-
7
- - Updated isolated-vm to version 6.2.0 to fix a critical sandbox escape vulnerability (type confusion in ExternalCopy) that could allow untrusted code to corrupt host memory and escape the sandbox. ([#21981](https://github.com/mastra-ai/mastra/pull/21981))
8
-
9
- - Updated dependencies [[`88d14ca`](https://github.com/mastra-ai/mastra/commit/88d14cac008582a618fecc3d5c7fd3bdf4f6ddc3), [`480e491`](https://github.com/mastra-ai/mastra/commit/480e491588bd6a7a1c9ee4407590ad625dd33952), [`9267e9b`](https://github.com/mastra-ai/mastra/commit/9267e9b3d9c2fcf16936050495a787054c2431ab), [`acc3471`](https://github.com/mastra-ai/mastra/commit/acc3471de5f3fde8027ee4e355af292b2bc1bc30), [`b6a771e`](https://github.com/mastra-ai/mastra/commit/b6a771ef23d203ddb348efca8065eff65def8191), [`84a5b69`](https://github.com/mastra-ai/mastra/commit/84a5b699f84d6bae0a34efe5a970d891090b9f41), [`9267e9b`](https://github.com/mastra-ai/mastra/commit/9267e9b3d9c2fcf16936050495a787054c2431ab), [`3bb88dd`](https://github.com/mastra-ai/mastra/commit/3bb88ddf07fb98f3cd16d3bff94e51cd3b45d011), [`d23e75d`](https://github.com/mastra-ai/mastra/commit/d23e75d57cc7cf5b9bfdbee896bf5a6a2484fed7), [`c8faa4e`](https://github.com/mastra-ai/mastra/commit/c8faa4e1cfebaec56b65e754e90b9fe46d153359), [`d378d75`](https://github.com/mastra-ai/mastra/commit/d378d7511f71309ed61a8f6b93cd0361dc6cb70f), [`84a5b69`](https://github.com/mastra-ai/mastra/commit/84a5b699f84d6bae0a34efe5a970d891090b9f41), [`26d4016`](https://github.com/mastra-ai/mastra/commit/26d40160ff7f7d8bf95fee2039a52cbc83863533), [`7c60df5`](https://github.com/mastra-ai/mastra/commit/7c60df5c7872343fbac5c3e5b1175c8076a5abfd), [`9267e9b`](https://github.com/mastra-ai/mastra/commit/9267e9b3d9c2fcf16936050495a787054c2431ab), [`84a5b69`](https://github.com/mastra-ai/mastra/commit/84a5b699f84d6bae0a34efe5a970d891090b9f41), [`f2031a4`](https://github.com/mastra-ai/mastra/commit/f2031a47445e8f67a89ba1309036816f97ab7a65), [`9267e9b`](https://github.com/mastra-ai/mastra/commit/9267e9b3d9c2fcf16936050495a787054c2431ab), [`cad4208`](https://github.com/mastra-ai/mastra/commit/cad42082e6aa1776168a94914f523334be45d929), [`8e529d4`](https://github.com/mastra-ai/mastra/commit/8e529d4ac754efef04b225841349e0da9edf89a6), [`57c5103`](https://github.com/mastra-ai/mastra/commit/57c51035a2a36e3df3c4f32f46bb789a66ed5946), [`038b7b4`](https://github.com/mastra-ai/mastra/commit/038b7b405cb4ac25ab3f3031334111b1f87ac112), [`4132d61`](https://github.com/mastra-ai/mastra/commit/4132d61f8367077120ee9e6420d3224dffd93c93), [`d378d75`](https://github.com/mastra-ai/mastra/commit/d378d7511f71309ed61a8f6b93cd0361dc6cb70f)]:
10
- - @mastra/core@1.61.0
11
-
12
- ## 0.1.1-alpha.0
13
-
14
- ### Patch Changes
15
-
16
- - Updated isolated-vm to version 6.2.0 to fix a critical sandbox escape vulnerability (type confusion in ExternalCopy) that could allow untrusted code to corrupt host memory and escape the sandbox. ([#21981](https://github.com/mastra-ai/mastra/pull/21981))
17
-
18
- - Updated dependencies [[`9267e9b`](https://github.com/mastra-ai/mastra/commit/9267e9b3d9c2fcf16936050495a787054c2431ab), [`acc3471`](https://github.com/mastra-ai/mastra/commit/acc3471de5f3fde8027ee4e355af292b2bc1bc30), [`b6a771e`](https://github.com/mastra-ai/mastra/commit/b6a771ef23d203ddb348efca8065eff65def8191), [`9267e9b`](https://github.com/mastra-ai/mastra/commit/9267e9b3d9c2fcf16936050495a787054c2431ab), [`26d4016`](https://github.com/mastra-ai/mastra/commit/26d40160ff7f7d8bf95fee2039a52cbc83863533), [`9267e9b`](https://github.com/mastra-ai/mastra/commit/9267e9b3d9c2fcf16936050495a787054c2431ab), [`9267e9b`](https://github.com/mastra-ai/mastra/commit/9267e9b3d9c2fcf16936050495a787054c2431ab), [`57c5103`](https://github.com/mastra-ai/mastra/commit/57c51035a2a36e3df3c4f32f46bb789a66ed5946)]:
19
- - @mastra/core@1.61.0-alpha.3
20
-
21
- ## 0.1.0
22
-
23
- ### Minor Changes
24
-
25
- - Added `@mastra/isolated-vm`, a new package with `IsolatedVmCodeModeTransport` — a Code Mode transport that runs model-authored programs in an in-process V8 isolate (backed by `isolated-vm`). The isolate is the execution boundary, so no workspace sandbox is required: the program has no filesystem, network, or process access, and its only capabilities are the `external_*` tool functions bridged back to the host. ([#20359](https://github.com/mastra-ai/mastra/pull/20359))
26
-
27
- ```typescript
28
- import { createCodeMode } from '@mastra/core/tools';
29
- import { IsolatedVmCodeModeTransport } from '@mastra/isolated-vm';
30
-
31
- const { tool, instructions } = createCodeMode({ tools }, new IsolatedVmCodeModeTransport({ memoryLimitMb: 128 }));
32
- ```
33
-
34
- Note: `isolated-vm` is a native addon, and on Node.js 20+ the host process must be started with `--no-node-snapshot` (for example `NODE_OPTIONS=--no-node-snapshot`). See the docs for setup details. Resolves https://github.com/mastra-ai/mastra/issues/20329.
35
-
36
- ### Patch Changes
37
-
38
- - Updated dependencies [[`3f472b4`](https://github.com/mastra-ai/mastra/commit/3f472b468892a1ff14ccb43cc0343b86f7d8fd7d), [`ba369f2`](https://github.com/mastra-ai/mastra/commit/ba369f2a0aaf998da0d6aa033d26f64f96bef8ac), [`35b929b`](https://github.com/mastra-ai/mastra/commit/35b929b7abc3d20d85c7985880960ac2d04a6c86), [`55c9e24`](https://github.com/mastra-ai/mastra/commit/55c9e248c27c1d72b5bb7e94ea6b8a3999eee49f), [`dcfed93`](https://github.com/mastra-ai/mastra/commit/dcfed93e1e256c6abfa792cbb7ca836f5d0e8638), [`2876e15`](https://github.com/mastra-ai/mastra/commit/2876e15b4d2f616a3bc1ed3af57d546c268384ce), [`9b3626a`](https://github.com/mastra-ai/mastra/commit/9b3626aeb1d16fcd34b0a8e94c114ddb80a3b240), [`4696963`](https://github.com/mastra-ai/mastra/commit/469696312ac4c618bc8475b0c5ed7949b8a3455e), [`723aa54`](https://github.com/mastra-ai/mastra/commit/723aa5437106bdb708ae03c0ef6b77aa11291e73), [`07f5b4b`](https://github.com/mastra-ai/mastra/commit/07f5b4ba9d608d88865030732e580298296adf99), [`723aa54`](https://github.com/mastra-ai/mastra/commit/723aa5437106bdb708ae03c0ef6b77aa11291e73), [`723aa54`](https://github.com/mastra-ai/mastra/commit/723aa5437106bdb708ae03c0ef6b77aa11291e73), [`598080f`](https://github.com/mastra-ai/mastra/commit/598080f224edb3f0f5b801035b067fac50a56a03)]:
39
- - @mastra/core@1.55.0
40
-
41
- ## 0.1.0-alpha.0
42
-
43
- ### Minor Changes
44
-
45
- - Added `@mastra/isolated-vm`, a new package with `IsolatedVmCodeModeTransport` — a Code Mode transport that runs model-authored programs in an in-process V8 isolate (backed by `isolated-vm`). The isolate is the execution boundary, so no workspace sandbox is required: the program has no filesystem, network, or process access, and its only capabilities are the `external_*` tool functions bridged back to the host. ([#20359](https://github.com/mastra-ai/mastra/pull/20359))
46
-
47
- ```typescript
48
- import { createCodeMode } from '@mastra/core/tools';
49
- import { IsolatedVmCodeModeTransport } from '@mastra/isolated-vm';
50
-
51
- const { tool, instructions } = createCodeMode({ tools }, new IsolatedVmCodeModeTransport({ memoryLimitMb: 128 }));
52
- ```
53
-
54
- Note: `isolated-vm` is a native addon, and on Node.js 20+ the host process must be started with `--no-node-snapshot` (for example `NODE_OPTIONS=--no-node-snapshot`). See the docs for setup details. Resolves https://github.com/mastra-ai/mastra/issues/20329.
55
-
56
- ### Patch Changes
57
-
58
- - Updated dependencies [[`ba369f2`](https://github.com/mastra-ai/mastra/commit/ba369f2a0aaf998da0d6aa033d26f64f96bef8ac), [`dcfed93`](https://github.com/mastra-ai/mastra/commit/dcfed93e1e256c6abfa792cbb7ca836f5d0e8638), [`2876e15`](https://github.com/mastra-ai/mastra/commit/2876e15b4d2f616a3bc1ed3af57d546c268384ce), [`598080f`](https://github.com/mastra-ai/mastra/commit/598080f224edb3f0f5b801035b067fac50a56a03)]:
59
- - @mastra/core@1.55.0-alpha.1