Skip to content

ADR: Standalone Gateway Desktop session API

Field Value
Status Accepted (deferred implementation)
Date 2026-07-24
Linear JOE-1042, JOE-1044, JOE-1091
Claim boundary Connection and health only; Desktop session operations remain deferred

Context

Desktop can register a Standalone Gateway URL + token for health and support verdicts. Session list, prompt, artifacts, and workflows remain deferred in the workspace support matrix. The product contract forbids presenting a full workspace when those APIs do not exist.

Decision

  1. Shipped promise (now): Standalone Gateway connection/health only.
  2. Not shipped: Desktop chat against Standalone sessions.
  3. Future API (when implemented) must:
  4. Authenticate with Gateway token (no public OpenCode port)
  5. Provide session list/create/prompt/abort + event projection
  6. Redact local host paths by default
  7. Flip support matrix from deferred → supported for session ops only after contract tests pass

Implementation residual

Full API work remains deferred. Tracked residual R-1042. Until implemented, UI must keep connection-only copy (JOE-1044) and must not flip the support matrix to supported without contract tests on the real path.

Consequences

  • Operators can register Standalone for doctor/health.
  • Users cannot be misled into “Gateway chat ready” without the API.