Mesa

Overview

Mesa is programmatic Git hosting for agents and automation. The Mesa adapter maps repository files to storagesdk objects, writes through Mesa changes, snapshots to namespaced bookmarks, and forks to bookmarks.

Configuration

import { Storage } from '@storagesdk/core';
import { mesa } from '@storagesdk/adapters/mesa';

const storage = new Storage({
  adapter: mesa({
    repo: 'agent-runs',
    apiKey: process.env.MESA_API_KEY,
    org: 'acme',
  }),
});

mesa({
  repo: string;
  apiKey?: string;
  org?: string;
  bookmark?: string;
  apiUrl?: string;
  vcsUrl?: string;
  userAgent?: string;
  author?: { name: string; email: string };
  committer?: { name: string; email: string };
  commitMessage?: (op, paths) => string;
});

Notes

• bookmark defaults to the repository default bookmark.
• Writes create a Mesa change and move the working bookmark to that change.
• Snapshots are bookmarks under storagesdk/snapshots/<bookmark>/<id>.
• Forks are normal Mesa bookmarks. Mesa bookmarks do not persist fork provenance, so forks.list() and forks.head() omit fromSnapshot.
• url() returns a deterministic mesa:// locator, not a fetchable signed HTTP URL.
• uploadUrl() throws NotSupported; Mesa does not expose object-style presigned upload URLs.

Compatibility