0
Fork 0
mirror of https://github.com/mastra-ai/mastra.git synced 2026-11-17 08:44:46 +00:00
mastra/code-mode/quickjs
History 2026-10-28 13:15:52 +00:00
..
src fix(quickjs): return errors instead of crashing the host on OOM and deep recursion (#24896) 2026-09-23 18:32:29 -07:00
.gitignore Run Code Mode securely in-process without native binaries or Node flags (#21089) 2026-08-09 11:20:39 -07:00
CHANGELOG.md chore: version - exit prerelease mode 2026-10-28 13:15:52 +00:00
lint-staged.config.js refactor(lint): replace ESLint with type-aware oxlint (#27476) 2026-10-18 10:38:35 -07:00
package.json chore: version - exit prerelease mode 2026-10-28 13:15:52 +00:00
README.md chore(*): Update/unify/add READMEs (#22858) 2026-09-02 14:36:59 +02:00
tsconfig.build.json Run Code Mode securely in-process without native binaries or Node flags (#21089) 2026-08-09 11:20:39 -07:00
tsconfig.json Run Code Mode securely in-process without native binaries or Node flags (#21089) 2026-08-09 11:20:39 -07:00
tsdown.config.ts Fix @mastra/quickjs CommonJS build so programs can run (#24722) 2026-09-22 13:21:20 -07:00
vitest.config.ts Run Code Mode securely in-process without native binaries or Node flags (#21089) 2026-08-09 11:20:39 -07:00

@mastra/quickjs

QuickJsCodeModeTransport runs model-authored Code Mode programs in a QuickJS runtime compiled to WebAssembly. Use it when native addons or Node.js startup flags are unavailable, such as in serverless environments, while keeping execution isolated from the host process.

Installation

npm install @mastra/quickjs

Usage

import { Agent } from '@mastra/core/agent';
import { createCodeMode, createTool } from '@mastra/core/tools';
import { QuickJsCodeModeTransport } from '@mastra/quickjs';
import { z } from 'zod';

const getPrice = createTool({
  id: 'getPrice',
  description: 'Get the price of a product',
  inputSchema: z.object({ productId: z.string() }),
  outputSchema: z.object({ price: z.number() }),
  execute: async ({ productId }) => ({ price: productId === 'pro' ? 49 : 19 }),
});

const { tool, instructions } = createCodeMode(
  { tools: { getPrice } },
  new QuickJsCodeModeTransport({ memoryLimitMb: 128 }),
);

const agent = new Agent({
  id: 'pricing-agent',
  name: 'Pricing agent',
  instructions: ['Answer pricing questions.', instructions],
  model: 'openai/gpt-5.6-sol',
  tools: { execute_typescript: tool },
});

Documentation

Changelog

See the package changelog for version history and release notes.

Support

We have an open community Discord. Come and say hello and let us know if you have any questions or need any help getting things running.