Skip to content

External Agent Access

Status: Deferred. Desktop contains the Runtime Config placement for External Agent Access, but token issuance and the action registry stay fail-closed until the Runtime-owned gateway/action plane ships.

External Agent Access is a reserved Desktop surface for future ExternalPrincipal management. The current product build may display Runtime status and an empty ledger projection, but it must not pretend that external AI hosts can receive usable scoped tokens today.

For the platform model, see Platform → Agents → External Agents.

Current Behavior

StateBehavior
Runtime projection availableDesktop can read Runtime's External Agent status projection
Action registry emptyToken issuance remains disabled with reason EXTERNAL_AGENT_ACTION_REGISTRY_EMPTY
Token ledgerEmpty until Runtime admits the action registry and gateway server
Issue / revokeNot a shipped user workflow in this build

The panel is intentionally fail-closed. Starting the runtime daemon is not enough to make External Agent Access usable; Runtime must first own the action descriptor registry, gateway server, token ledger, and audit lineage for this capability.

Why It Is Still Visible

Desktop keeps the placement so the product has a stable home for the future capability and so Runtime can project an explicit disabled reason. That is different from shipping token issuance.

The panel should communicate the disabled reason clearly:

  • no silent success,
  • no pseudo token,
  • no Desktop-local token ledger,
  • no fallback action registry in renderer or Tauri.

Future Capability Boundary

When admitted, External Agent Access will be Runtime-owned:

ConcernOwner
Action descriptorsRuntime
Gateway/serverRuntime
Token ledgerRuntime
Audit lineageRuntime
UI placement and controlsDesktop
Typed projectionSDK

Desktop remains the user-facing placement. It does not own action authority or token truth.

Source Basis

Nimi AI open world platform documentation.