> ## Documentation Index
> Fetch the complete documentation index at: https://learn.getodin.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Node.js Execution Toolkit

> Optimized for JavaScript/TypeScript workloads

<img src="https://mintcdn.com/odinai/lpgvTq8jdlbX6DFk/img/agents-toolkits/20.jpg?fit=max&auto=format&n=lpgvTq8jdlbX6DFk&q=85&s=5c2348c7c6f4379c2a2e4ecb25915670" alt="Node.js Code Execution Toolkit" width="643" height="279" data-path="img/agents-toolkits/20.jpg" />

**How to reach:** Main sidebar > "Agents" > Select agent > "Toolkits" tab > "Code & Development" > "Node.js Code Execution"

1. Open your agent > "Toolkits" tab > "Code & Development" category > Find "Node.js Code Execution" toolkit.
2. Click "Add to Agent" on Node.js Code Execution, then "Configure". Click "Save".

## Node.js Code Execution Toolkit

Execute Node.js/JavaScript code in a secure sandbox environment with NPM package support and file management capabilities. Optimized for JavaScript/TypeScript workloads, API integrations, JSON processing, async operations, and web automation.

## Node.js Toolkit Configuration

<img src="https://mintcdn.com/odinai/roGQaiEdYiaHx-Y8/img/agents-toolkits/nodejs-config.png?fit=max&auto=format&n=roGQaiEdYiaHx-Y8&q=85&s=c910a57c7806c680fb3f0af2470aa89e" alt="Node.js Toolkit Configuration Panel" width="1588" height="1143" data-path="img/agents-toolkits/nodejs-config.png" />

Configure the Node.js sandbox environment. This toolkit allows the agent to execute Node.js/JavaScript code, upload files, and manage files in the sandbox.

## Security Information

* Node.js code runs in a secure, isolated sandbox environment
* Each chat session gets its own dedicated sandbox with persistent state
* Files uploaded to the sandbox are isolated from other users and projects
* Sandboxes automatically clean up after the session ends

## Available Tools (5/5)

**Code Execution:**

* **Execute Code**: Execute Node.js/JavaScript code in a secure sandbox environment

**File Management:**

* **Search Files**: Search for files in the knowledge base to upload to sandbox
* **Upload File**: Upload files from knowledge base to the Node.js sandbox
* **List Files**: List all files currently available in the sandbox
* **Create Download URL**: Create secure download URLs for files in the sandbox

## Use Cases

* **API Integration**: Call REST APIs and handle OAuth flows.
* **JSON Processing**: Parse and transform JSON data structures.
* **Web Automation**: Scrape websites and automate forms.
* **Data Transformation**: Convert between formats (CSV, JSON, XML, YAML).

## Example Code

Below is an example Node.js script demonstrating NPM package usage, dependency checking, and the required `module.exports` pattern with a `main()` entry point function:

```javascript theme={null}
const _ = require("lodash");
const PACKAGES = ["lodash", "@google-cloud/bigquery", "axios"];

const isPackageInstalled = (packageName) => {
    try {
        require.resolve(packageName);
        return true;
    } catch (e) {
        return false;
    }
};

const getPackageVersion = (packageName) => {
    if (!isPackageInstalled(packageName)) return {
        isInstalled: false,
        version: null,
        message: "Package is not installed",
        package: packageName,
    };

    const version = require(`${packageName}/package.json`).version;
    return {
        isInstalled: true,
        version,
        message: `Package is installed with version ${version}`,
        package: packageName,
    };
};

const test = () => {
    return _.map(PACKAGES, (pkg) => getPackageVersion(pkg));
};

async function main(inputText, maxLength = 100, options = {}) {
    /**
     * Main function that will be executed
     *
     * @param {string} inputText - The text to process
     * @param {number} maxLength - Maximum length of output (default: 100)
     * @param {object} options - Additional processing options (default: {})
     */

    return { data: test() };
}

// The entry point function will be called with the arguments you define
module.exports = { main };
```

## Key Points from Example

* **Entry Point**: The `main()` function is the entry point, exported via `module.exports = { main }`.
* **NPM Packages**: Use `require()` to import installed packages (e.g., lodash, axios, @google-cloud/bigquery).
* **Package Checking**: Use `require.resolve()` to check if a package is available in the sandbox.
* **Async Support**: The main function can be async for handling API calls and file operations.
* **Parameters**: Define parameters with defaults (e.g., `maxLength = 100`, `options = {}`) for flexible input.
* **Return Format**: Return results as an object (e.g., `{ data: ... }`) for structured output.