# Public API — `mgf-vm-core`

> **Master-HEAD banner (REL-03):** this file + [`PUBLIC_API.json`](PUBLIC_API.json) track the
> CURRENT main/release surface. Verify your pin via `mgf.vm.core.__version__` (mirrors pyproject).
> `PUBLIC_API.json` is generated from `__all__` and pinned in CI.

The public surface is exactly `mgf.vm.core.__all__` (the frozen domain contracts, state machine,
configurators, fakes, and common helpers). **Stability tier:** every public name is `experimental`
(the 0.x window). Categories + invariants are documented at each symbol's docstring + in `DESIGN.md`;
this file is the machine-checkable enumeration (one row per public name).

## `mgf.vm.core`

| Name | Tier |
|---|---|
| `AsyncLifecycleObserver` | experimental |
| `AttachedDevice` | experimental |
| `BackupDiskArtifact` | experimental |
| `BackupManifest` | experimental |
| `CURRENT_BACKUP_SCHEMA_VERSION` | experimental |
| `CURRENT_VMSPEC_SCHEMA_VERSION` | experimental |
| `CancellationEvent` | experimental |
| `CancellationToken` | experimental |
| `ClaimMode` | experimental |
| `CompatibilityResult` | experimental |
| `DeviceAssignment` | experimental |
| `DeviceBackend` | experimental |
| `DeviceCapabilities` | experimental |
| `DeviceId` | experimental |
| `DeviceInfo` | experimental |
| `DeviceSpec` | experimental |
| `DiskImageInfo` | experimental |
| `DiskIo` | experimental |
| `DiskSpec` | experimental |
| `DiskStatus` | experimental |
| `DomainId` | experimental |
| `DomainInfo` | experimental |
| `EventGap` | experimental |
| `FakeDeviceBackend` | experimental |
| `FakeHostDiskBackend` | experimental |
| `FakeHypervisorBackend` | experimental |
| `FakeMetricsBackend` | experimental |
| `FakeNetworkBackend` | experimental |
| `FakeStorageBackend` | experimental |
| `HostDiskBackend` | experimental |
| `HostId` | experimental |
| `HostMetrics` | experimental |
| `HypervisorBackend` | experimental |
| `HypervisorCapabilities` | experimental |
| `InvalidTransition` | experimental |
| `IsolationLevel` | experimental |
| `LeaseEvent` | experimental |
| `LeaseId` | experimental |
| `LeaseInfo` | experimental |
| `LifecycleObserver` | experimental |
| `MetricsBackend` | experimental |
| `MetricsSample` | experimental |
| `MigrationPlan` | experimental |
| `MigrationTarget` | experimental |
| `NetworkBackend` | experimental |
| `NetworkInfo` | experimental |
| `NetworkLease` | experimental |
| `NetworkProfile` | experimental |
| `NetworkSpec` | experimental |
| `NicIo` | experimental |
| `NicSpec` | experimental |
| `NicStatus` | experimental |
| `OperationHandle` | experimental |
| `OperationId` | experimental |
| `OperationKind` | experimental |
| `OperationStatus` | experimental |
| `PoolInfo` | experimental |
| `PoolSpec` | experimental |
| `ProvisioningSpec` | experimental |
| `RestoredDisk` | experimental |
| `RestoredImages` | experimental |
| `SnapshotId` | experimental |
| `SnapshotInfo` | experimental |
| `StorageBackend` | experimental |
| `StorageCapabilities` | experimental |
| `StoragePoolInfo` | experimental |
| `TenantId` | experimental |
| `TransitionCause` | experimental |
| `TransitionEvent` | experimental |
| `VMCredential` | experimental |
| `VMHandle` | experimental |
| `VMMetrics` | experimental |
| `VMState` | experimental |
| `VMStatus` | experimental |
| `Vm` | experimental |
| `VmEvent` | experimental |
| `VmId` | experimental |
| `VmLifecycleStateMachine` | experimental |
| `VmSpec` | experimental |
| `VmState` | experimental |
| `VmStatus` | experimental |
| `VolumeId` | experimental |
| `VolumeInfo` | experimental |
| `VolumeSpec` | experimental |
| `migrate_vmspec` | experimental |
| `vmspec_from_mapping` | experimental |
| `vmspec_to_mapping` | experimental |
