Providers
The two-axis provider model - harnesses and model endpoints, and the cells they form.
donmai runs an agent by combining two independent choices:
- a harness - the loop driver that runs the session (Claude Code, Codex,
OpenCode, Antigravity, Amp, or the in-box
rawloop), and - a model endpoint - the company that serves the model, named by company (Anthropic, OpenAI, Google, or a Local server), declaring its serving hosts, auth modes, wire protocol, and cost model.
A run is one harness paired with one model endpoint. The pairing is valid only when the harness can drive the endpoint's wire protocol on the endpoint's host - that intersection is the capability matrix, and it is computed, never hand-authored.
Why two axes
Keeping the harness separate from the model endpoint means the same company can
be reached through more than one harness, and the same harness can reach more
than one company. Google, for example, is one company with two cells: the
Antigravity harness over an OAuth-CLI host (your own subscription, no key), and
the raw harness over the direct/Vertex API (key-billed). You pick a company and
a harness; you never pick a runtime as if it were a model.
Auth modes and cost
Each cell declares how it authenticates, which determines what it costs:
host-session/local- the cell brings its own auth (a logged-in CLI or an on-box model). No platform key is injected; cost is the user's own subscription, ≈$0 to meter.byok/metered/shared- the cell needs an API key. A key is injected at spawn and spend is metered.
This honesty is structural: a cell that brings its own auth never receives a key, so it can't be silently billed.
Pages
- Capability matrix - every valid
harness × endpointcell that ships today. - Contributing a provider - add a new harness or model endpoint.