Sandbox Management

// Initialize using environment variables (DAYTONA_API_KEY, DAYTONA_SERVER_URL, DAYTONA_TARGET)
const daytona = new Daytona();

// Create and use a sandbox
const sandbox = await daytona.create({
    language: 'typescript',
    envVars: { NODE_ENV: 'development' }
});

// Execute commands in the sandbox
const response = await sandbox.process.executeCommand('echo "Hello, World!"');
console.log(response.result);

// Execute code in the sandbox
const response = await sandbox.process.codeRun('console.log("Hello, World!")');
console.log(response.result);

// Initialize with explicit configuration
const daytona = new Daytona({
    apiKey: process.env.CUSTOM_API_KEY,
    serverUrl: 'https://daytona.example.com',
    target: 'us'
});

// Create a custom sandbox
const sandbox = await daytona.create({
    language: 'typescript',
    image: 'node:18',
    resources: {
        cpu: 2,
        memory: 4 // 4GB RAM
    },
    autoStopInterval: 60 // Auto-stop after 1 hour of inactivity
});

// Use sandbox features
await sandbox.git.clone('https://github.com/user/repo.git');
await sandbox.process.executeCommand('npm test');

// Using environment variables
// Uses DAYTONA_API_KEY, DAYTONA_SERVER_URL, DAYTONA_TARGET
const daytona = new Daytona();
const sandbox = await daytona.create();

// Using explicit configuration
const config: DaytonaConfig = {
    apiKey: "your-api-key",
    serverUrl: "https://your-server.com",
    target: "us"
};
const daytona = new Daytona(config);

@class

new Daytona(config?: DaytonaConfig): Daytona

create(params?: CreateSandboxParams, timeout?: number): Promise<Sandbox>

// Create a default sandbox
const sandbox = await daytona.create();

// Create a custom sandbox
const params: CreateSandboxParams = {
    language: 'typescript',
    image: 'node:18',
    envVars: {
        NODE_ENV: 'development',
        DEBUG: 'true'
    },
    resources: {
        cpu: 2,
        memory: 4 // 4GB RAM
    },
    autoStopInterval: 60
};
const sandbox = await daytona.create(params, 40);

get(sandboxId: string): Promise<Sandbox>

const sandbox = await daytona.get('my-sandbox-id');
console.log(`Sandbox state: ${sandbox.instance.state}`);

getCurrentSandbox(sandboxId: string): Promise<Sandbox>

const sandbox = await daytona.getCurrentSandbox('my-sandbox-id');
console.log(`Current sandbox state: ${sandbox.instance.state}`);

getCurrentWorkspace(workspaceId: string): Promise<Sandbox>

list(): Promise<Sandbox[]>

const sandboxes = await daytona.list();
for (const sandbox of sandboxes) {
    console.log(`${sandbox.id}: ${sandbox.instance.state}`);
}

remove(sandbox: Sandbox, timeout: number): Promise<void>

const sandbox = await daytona.get('my-sandbox-id');
await daytona.remove(sandbox);

start(sandbox: Sandbox, timeout?: number): Promise<void>

const sandbox = await daytona.get('my-sandbox-id');
// Wait up to 60 seconds for the sandbox to start
await daytona.start(sandbox, 60);

stop(sandbox: Sandbox): Promise<void>

const sandbox = await daytona.get('my-sandbox-id');
await daytona.stop(sandbox);

const params: CreateSandboxParams = {
    language: 'typescript',
    envVars: { NODE_ENV: 'development' },
    resources: {
        cpu: 2,
        memory: 4 // 4GB RAM
    },
    autoStopInterval: 60  // Auto-stop after 1 hour of inactivity
};
const sandbox = await daytona.create(params, 50);

const config: DaytonaConfig = {
    apiKey: "your-api-key",
    serverUrl: "https://your-server.com",
    target: "us"
};
const daytona = new Daytona(config);

const resources: SandboxResources = {
    cpu: 2,
    memory: 4,  // 4GB RAM
    disk: 20    // 20GB disk
};