Workspaces SDK

const ws = await rt.workspaces.create({ name: 'Docs Project', slug: 'docs-project' });

const all = await rt.workspaces.list();                 // auto-paged
const page = await rt.workspaces.listPage({ limit: 20 }); // cursor-aware
const one = await rt.workspaces.get(ws.id);

await rt.workspaces.update(ws.id, { name: 'Docs' });

const usage = await rt.workspaces.usage(ws.id);          // { bytes, fileCount, billableBytes }
const { events } = await rt.workspaces.activity(ws.id, { limit: 50 });

await rt.workspaces.delete(ws.id);                       // soft delete

const files = rt.workspaces.files;

// List + inspect
const { entries } = await files.list(ws.id, { path: 'src', recursive: false });
const info = await files.info(ws.id, 'src/README.md');

// Read
const text = await files.readText(ws.id, 'src/README.md');
const bytes = await files.readBytes(ws.id, 'assets/logo.png');

// Write — content can be a string, Uint8Array, ArrayBuffer, or Blob
await files.write(ws.id, 'notes/todo.md', '# TODO\n- ship docs', { contentType: 'text/markdown' });
await files.write(ws.id, 'data/report.bin', bytes, { overwrite: false }); // 409 if it already exists

// Create a directory, delete a path
await files.mkdir(ws.id, 'cache');
await files.delete(ws.id, 'notes/todo.md');

const sandbox = await rt.sandbox.create({
  template: 'base-ubuntu',
  mounts: [{ workspaceId: ws.id, path: '/workspace' }],
});