internal/

Package avd is the Android counterpart to internal/simctl: a thin, read-only discovery wrapper over the Android SDK's `emulator` and `adb` for finding the AVDs (Android Virtual Devices) installed on this machine.

Package broker is simbroker's allocation logic: it hands out simulators from a capped pool and reclaims them when their holders are gone.

Package cli is simbroker's command-line surface: a thin layer that parses flags and renders broker results.

Package device is the class-neutral vocabulary the broker speaks: a Device is "one allocatable thing" and a Controller is "how to discover/boot that class of thing." iOS simulators (internal/simctl) and, later, Android emulators (internal/avd) each provide a Controller; the broker never learns the per-platform details (xcrun JSON vs adb plaintext, UDID vs AVD name).

Package mcpserver exposes the broker over the Model Context Protocol (stdio), so an AI agent can claim and release simulators as tool calls.

Package proc answers one question for the broker: "is the process that holds this claim still alive?" — the signal that lets a live holder's lease survive TTL expiry (so we never hand a busy agent's simulator to someone else) while a dead holder's lease is reclaimed immediately.

Package simctl is a thin read-only wrapper over `xcrun simctl` for discovering the iOS simulators installed on this machine.

Package store is simbroker's machine-global state: the set of live claims, persisted to a JSON file and guarded so that concurrent simbroker processes (CLI invocations, the MCP server, other projects) never corrupt it or race on capacity.