node — TypeScript script

The node template ships Node.js 20 LTS, npm, the typescript compiler, and yarn. Pick it for TypeScript / Node scripts and any workflow that needs to install npm packages at runtime.

What you’ll learn

Picking template="node" to skip a Node install
Writing a .ts file into the sandbox, compiling with tsc, running with node

Prerequisites

export DECLAW_API_KEY="your-api-key"
export DECLAW_DOMAIN="your-declaw-instance.example.com:8080"

Code

Python
TypeScript

import textwrap

from declaw import Sandbox


SCRIPT = textwrap.dedent("""\
    declare const process: { version: string };
    type Order = { id: string; qty: number; price: number };

    const orders: Order[] = [
      { id: "A-1", qty: 3, price: 19.99 },
      { id: "A-2", qty: 1, price: 49.50 },
      { id: "B-1", qty: 5, price: 4.25 },
    ];

    const total = orders.reduce((s, o) => s + o.qty * o.price, 0);
    const summary = {
      orders: orders.length,
      units: orders.reduce((s, o) => s + o.qty, 0),
      total: Number(total.toFixed(2)),
      node: process.version,
    };
    console.log(JSON.stringify(summary, null, 2));
""")


def main() -> None:
    sbx = Sandbox.create(template="node", timeout=120)
    try:
        for tool in ("node", "npm", "tsc"):
            r = sbx.commands.run(f"{tool} --version")
            print(f"{tool}: {r.stdout.strip()}")

        sbx.files.write("/tmp/orders.ts", SCRIPT)

        r = sbx.commands.run("cd /tmp && tsc --target ES2020 orders.ts && node orders.js")
        if r.exit_code != 0:
            print("compile/run failed:", r.stderr)
            return
        print("\nscript output:")
        print(r.stdout)
    finally:
        sbx.kill()


if __name__ == "__main__":
    main()

import "dotenv/config";
import { Sandbox } from "@declaw/sdk";

const SCRIPT = `declare const process: { version: string };
type Order = { id: string; qty: number; price: number };

const orders: Order[] = [
  { id: "A-1", qty: 3, price: 19.99 },
  { id: "A-2", qty: 1, price: 49.50 },
  { id: "B-1", qty: 5, price: 4.25 },
];

const total = orders.reduce((s, o) => s + o.qty * o.price, 0);
const summary = {
  orders: orders.length,
  units: orders.reduce((s, o) => s + o.qty, 0),
  total: Number(total.toFixed(2)),
  node: process.version,
};
console.log(JSON.stringify(summary, null, 2));
`;

async function main(): Promise<void> {
  const sbx = await Sandbox.create({ template: "node", timeout: 120 });
  try {
    for (const tool of ["node", "npm", "tsc"]) {
      const r = await sbx.commands.run(`${tool} --version`);
      console.log(`${tool}: ${r.stdout.trim()}`);
    }

    await sbx.files.write("/tmp/orders.ts", SCRIPT);

    const r = await sbx.commands.run(
      "cd /tmp && tsc --target ES2020 orders.ts && node orders.js",
    );
    if (r.exitCode !== 0) {
      console.log("compile/run failed:", r.stderr);
      return;
    }
    console.log("\nscript output:");
    console.log(r.stdout);
  } finally {
    await sbx.kill();
  }
}

main().catch(console.error);

Expected output

node: v20.20.2
npm: 10.8.2
tsc: Version 6.0.2

script output:
{
  "orders": 3,
  "units": 9,
  "total": 130.72,
  "node": "v20.20.2"
}

Need an actual TypeScript Declaw client inside the sandbox? npm install @declaw/sdk works at runtime against the node template — but for an agent-in-sandbox pattern, the ai-agent template is usually a better starting point.

python code-interpreter

Getting Started

Built-in Templates

Commands

PTY

OpenAI Agents

Filesystem

Volumes

Network Policies

PII Protection

Security Features

LLM Providers

Framework Integrations

Agent-in-Sandbox

Real-World Patterns

Security Demos

node — TypeScript script

What you’ll learn

Prerequisites

Code

Expected output

​What you’ll learn

​Prerequisites

​Code

​Expected output

What you’ll learn

Prerequisites

Code

Expected output