@mesadev/sdk

Official Mesa TypeScript SDK.

This is the primary TypeScript SDK for Mesa. It includes ergonomic REST resources with default org inference and Daytona-compatible git operations.

Node.js runtime is required.

Install

bun add @mesadev/sdk

Usage

import { Mesa } from '@mesadev/sdk';

const mesa = new Mesa({
  apiKey: process.env.MESA_API_KEY,
});

// Uses org inferred from /whoami
const repo = await mesa.repos.create({ name: 'my-repo' });

// Optional constructor org bypasses /whoami default-org resolution
const mesaWithOrg = new Mesa({
  apiKey: process.env.MESA_API_KEY,
  org: 'acme',
});

await mesaWithOrg.repos.list();

// Per-call org override
await mesa.repos.list({ org: 'other-org' });

// Daytona-compatible git namespace
await mesa.git.clone('https://mesa.dev/acme/my-repo.git', '~/repos/my-repo', 'main');

console.log(repo.name);

This package exposes org-inferred REST resources under mesa.* and Node git operations under mesa.git.*.

Configuration

Mesa accepts:

• apiKey?: string (falls back to MESA_API_KEY in Node)
• apiUrl?: string (defaults to https://api.mesa.dev/v1)
• org?: string (optional default org; bypasses /whoami resolution)
• fetch?: typeof fetch
• userAgent?: string

Package Relationship

• @mesadev/sdk is the ergonomic, main SDK.
• @mesadev/rest is the generated REST package used under the hood.

Use mesa.raw.* when you need direct generated operations.

Migration Note

If you previously used the older generated @mesadev/sdk package:

• use apiUrl instead of serverURL
• rely on default org inference from /whoami or pass org per call
• use resource namespaces (mesa.repos, mesa.changes, etc.) and mesa.raw.* for low-level calls