# Public API — `mgf-vm-sdk`

> **Master-HEAD banner (REL-03):** tracks the CURRENT main/release surface. Verify your pin via
> `mgf.vm.sdk.__version__` (mirrors `pyproject.toml`). Companion: [`PUBLIC_API.json`](PUBLIC_API.json),
> generated from `__all__` + pinned in CI.

The public surface is exactly `mgf.vm.sdk.__all__`. Modules under a leading underscore
(`_devices`, `_storage`, `_version`) are private.

- **Stability tiers:** every public name is `experimental` (the 0.x window).

## `mgf.vm.sdk`

| Name | Tier | Description |
|---|---|---|
| `VmManagerClient` | experimental | The typed sync client facade over a `Transport`. |
| `AsyncVmManagerClient` | experimental | The async client facade over an `AsyncTransport`. |
| `Transport` | experimental | Protocol: the sync transport seam (submit_op / reads). |
| `AsyncTransport` | experimental | Protocol: the async transport seam. |
| `InProcessTransport` | experimental | In-process production transport (drives mgf-vm-core directly). |
| `AsyncInProcessTransport` | experimental | Async in-process transport. |
| `OperationHandle` | experimental | Typed handle for a submitted operation (status/result/error). |

> The gRPC transport (optional `[grpc]` extra) and test fakes are additional `Transport` impls,
> imported explicitly; the wire/gRPC bindings are kept out of the SDK core by the import-linter contract.
