OpenCode external attach, catalog, and verifier matrix

[chuks-qua]

Parent

#1621

What to build

OpenCode leaves coming-soon state: the catalog shows it with discovered models, an external serve URL can be attached as a shared backend, and the full verifier matrix passes on web and desktop clients.

Decision Sources

• Serve OpenCode sessions through a pooled serve + SDK provider #1621 (availability gate, catalog flip, verifier matrix) and its working companion .dev/verification/opencode-serve-architecture.html.
• Prove provider-completeness journeys across clients and providers #1617: verifier feature map and cross-client journeys; missing access is a coverage gap, not a pass.
• External prior art: shared-server port contention ÔÇö an attached server is never owned or closed by the app.

Acceptance criteria

• Journey: set an external serve URL ÔåÆ threads run on it; closing the app leaves it running; a second client attached to the same server sees the sessions.
• Journey: full verifier pass on web and desktop ÔÇö diff source labels, all review routes, retry staleness rejection, four-surface invalidation refresh, reconnect durability.
• Upstream binary, server, and SDK versions recorded in implementation evidence.

Blocked by

• OpenCode resume and paged history #1623, OpenCode event mapping and permissions #1624, OpenCode push turn-diff and Review labels #1625, OpenCode approval review and resolved modes #1626

Key references

• Program: Provider-neutral Codex protocol completeness #1610 (provider completeness) — read before starting; its decisions bind this ticket.
• Spec: Serve OpenCode sessions through a pooled serve + SDK provider #1621 — full contracts, diagrams, and sequencing.
• Visual companion: .dev/verification/opencode-serve-architecture.html in the main worktree (topology, turn sequence, state, contract drafts).
• Upstream docs: https://opencode.ai/docs/server/ and https://opencode.ai/docs/sdk/
• Prior art: Synara opencodeRuntime.ts (pooled serve per cwd) and T3 Code Layers/OpenCodeAdapter.ts plus issues #2691, #3601, #3604 (failure modes to avoid).