Skip to main content

System architecture and ownership

Messaging has several cooperating processes and services. The desktop interface is not the model provider, the shared runtime is not the Relay server, and account membership is not a provider login.

User or native agent tool
|
Desktop / CLI / MCP adapter
|
Identity + registry + durable operation
|
Selected local worker or authorized remote route
|
Exact native provider conversation

A remote route can add an SSH account, a paired Relay channel or an A2A endpoint. These routes have different credentials and completion contracts.

Ownership boundaries​

ComponentOwnsDoes not establish
Desktop/CLI/MCPRequested operation, selected surface, user-facing resultProvider entitlement or model completion
RegistryDiscovered names, native identities and routesPermission to invent a sender
Durable operation storeDispatch ownership, target binding and recorded outcomeAuthorization to replay uncertainty
Provider integrationIts worker, owned configuration and bridge assetsOwnership of unrelated provider profiles
Shared native runtimeHost/device connections and advertised host capabilitiesEvery consumer feature being installed or enabled
Account authorityAccount session and device membershipNative crypto approval or provider credentials
RelayReachability and routingDecrypted paired application content or account grants
ProviderNative conversation, account and execution policyAnother provider's chat identity

Process boundaries​

Windows uses native services/processes and owner-scoped IPC. Mac uses Swift application/CLI code with native helpers and the shared runtime. Linux uses a native CLI/GUI and user-service integration. Provider-specific JavaScript or TypeScript assets run only where the integration requires them.

The native daemon/account source has a separate producer repository. Application builds consume it through the source/publication contract; generated copies are not independent implementations to maintain.

Data and failure flow​

An operation can be durably accepted before target discovery or delivery finishes. The worker preserves the request, resolves and pins the destination, and records the actual outcome. Errors in a remote hop must not create a fresh logical Send.

A connection can remain established after authorization becomes stale. The reviewed runtime therefore rechecks account-only authority before admitting new remote work; see revocation.

Source delivery, artifact publication, installation and visible target delivery remain separate. See source status, data lifecycle and protocol boundaries.