createSession

async createSession(
  options?: SessionOptions
): Promise<ExecutionSession>

import { getSandbox } from '@cloudflare/sandbox';

const sandbox = getSandbox(env.SANDBOX, 'my-sandbox');

// Create a session with custom environment
const session = await sandbox.createSession({
  name: 'data-analysis',
  env: {
    API_KEY: 'secret-key',
    DEBUG: 'true'
  },
  cwd: '/workspace/analysis'
});

// Use the session - all operations use session context
const result = await session.exec('echo $API_KEY');
console.log(result.stdout); // "secret-key"

const files = await session.listFiles('.');
console.log(files); // Lists /workspace/analysis

// Create sessions for different users
const user1Session = await sandbox.createSession({
  id: 'user-1',
  env: { USER_ID: '1' },
  cwd: '/workspace/user1'
});

const user2Session = await sandbox.createSession({
  id: 'user-2',
  env: { USER_ID: '2' },
  cwd: '/workspace/user2'
});

// Each session has isolated state
await user1Session.exec('export TOKEN=abc123');
await user2Session.exec('export TOKEN=xyz789');

const result1 = await user1Session.exec('echo $TOKEN');
console.log(result1.stdout); // "abc123"

const result2 = await user2Session.exec('echo $TOKEN');
console.log(result2.stdout); // "xyz789"

const session = await sandbox.createSession({
  name: 'temp-work',
  cwd: '/tmp/session'
});

try {
  // Do work in session
  await session.exec('npm install');
  await session.exec('npm test');
} finally {
  // Cleanup
  await sandbox.deleteSession(session.id);
}