Core developers
Go modules and native adapters
To add an operation, give it a versioned contract and a single state owner. A desktop view, a terminal and a paired client can then ask the same owner for the same result.
From request to native effect
| Layer | Responsibility |
|---|---|
| Contract | pkg/protocols/ holds public values, bounded codecs and validation. Decoding must work without opening a socket, reading credentials or launching a process. |
| Operation | internal/moduleops registers a typed descriptor with a version, effect, resource scope and input bounds. moduleauth prepares an immutable request and uses the Host's shared decisionvault for review. |
| Provider | For Codex, codexwire validates provider messages, codexruntime orders the conversation and codexbroker checks the current session and authority. sessionstore records provider effects and their original outcomes. |
| Execution | hostruntime owns admission for the Host instance. supervisor starts the reviewed plan through the selected backend and retains the live handle. |
| Native client | The adapter authenticates its connection, requests the supported operation and presents its result with scope and expiry intact. |
Core uses OS-specific mechanisms behind these interfaces. For example, macOS uses Keychain for the mesh device key, while Linux uses its native Secret Service. A client can consume the same graph-read contract on either system.
A new provider needs its own validated wire and runtime behavior. The presence of a provider name in the catalog establishes only what its corresponding entry reports. Each installation, authentication, model and execution path needs its own evidence.
Implement a status reader
On the authenticated owner-private Unix socket, send a bodyless request with this exact media type:
GET /v1/status HTTP/1.1
Host: localhost
Accept: application/vnd.cleetus.host+json;version=1
Check the expected Host ID, the responding instance and the validity interval. The v1 body is limited to 16 KiB. Each capability reports both support (present, absent or unknown) and availability (ready, unavailable or unknown). For example, a compiled-in backend can have present support while its availability is still unknown. Discard expired observations. On an explicit foreground socket the native reader handles the same checks:
cleetus-host inspect status --host-id "$HOST_ID" --socket "$HOST_SOCKET"
Use a canonical socket path under the owner's private directory. Adding a state-changing operation requires its own typed request, effect and review path. Approvals and audit · IDE architecture