Repository navigation
Track TUI migration to @opencode-ai/client #34359
Description
Goal
Move the V2 TUI from the legacy @opencode-ai/sdk/v2 client to the new generated Promise client in @opencode-ai/client.
Checked against latest origin/v2 at f7034a35a8.
Already Supported By @opencode-ai/client
These should mostly be call-site rename/shape migrations. The new Promise client returns unwrapped values and throws declared errors instead of returning { data, error } / accepting { throwOnError: true }.
v2.session.*->client.sessions.*v2.session.messages->client.messages.listv2.session.permission.*->client.permissions.*v2.session.question.*->client.questions.*v2.agent/model/provider/command/reference/skill.list->client.agents/models/providers/commands/references/skills.listv2.integration.*->client.integrations.*v2.credential.remove->client.credentials.removev2.fs.find->client.files.findv2.projectCopy.create/remove/refresh->client.projectCopies.create/remove/refreshv2.event.subscribe->client.events.subscribe
Needs Protocol/Server/Client Surface
Functionality exists nearby, but it is not yet exposed through packages/protocol + packages/server + generated @opencode-ai/client.
experimental.controlPlane.moveSessionproject.currentproject.directoriesvcs.statusvcs.diffsession.diff
Notes:
MoveSession.Servicealready exists in Core. This is likely a good first API slice.- VCS and session diff are needed by the TUI move/workspace/diff flows.
Real Missing V2 Functionality
These are not just missing generated methods. They need V2 behavior/design before the TUI can fully leave the legacy SDK.
session.shellsession.commandsession.forkmcp.status/connect/disconnectexperimental.workspace.*
Notes:
SessionV2.shellexists as an interface method but currently returnsOperationUnavailableError.session.commandneeds V2 slash-command execution semantics;commands.listexists, command execution does not.session.forkhas some ingredients (SessionV2.createsupportsparentID) but not the full fork-at-message behavior the TUI expects.
Probably Do Not Port Literally
These should likely be replaced by V2 concepts rather than added 1:1.
provider.oauth.authorize/callbackauth.setsession.promptAsync(noReply)
Notes:
- Provider auth should likely go through V2
integrations/credentials. promptAsync(noReply)might map tosessions.prompt({ resume: false })or disappear behind explicit move/session events, depending on desired UX.
Suggested First Slice
Add the missing public surface for:
moveSessionvcs.statusvcs.diff
These are high-value for TUI behavior, have nearby implementations, and should be smaller than shell/command/fork/workspace semantics.
Verification When Migrating
- Run
bun run generatefrompackages/clientafter Protocol/ServerHttpApichanges. - Run
bun typecheckfrompackages/client,packages/tui, andpackages/cli. - Use Terminal Control smoke tests for TUI user-visible flows after call-site migration.
Activity
opencode-agent commentedon Jun 29, 2026
Split the core-missing pieces into separate tracking issues:
This umbrella can stay focused on the TUI migration and link out to implementation/API slices.
opencode-agent commentedon Jun 29, 2026
Split the non-experimental exposed API work into separate tracking issues:
Leaving experimental workspace/control-plane items out for now per thread discussion.
opencode-agent commentedon Jun 29, 2026
Split MCP V2 work into #34435 — [FEATURE]: Port MCP lifecycle APIs to V2. Elicitation remains a separate follow-up after UI proposals.
opencode-agent commentedon Jun 29, 2026
Additional V2 beta follow-up issues from the meeting transcript:
opencode-agent commentedon Jul 2, 2026
Tracker update from V2 TODO LIST audit (2026-07-02):
Recent/active TUI migration related work to keep linked from the umbrella:
Suggested tracker state: keep this as umbrella only; close/narrow child issues individually as their PRs land.
opencode-agent commentedon Jul 2, 2026
Additional tracker update (2026-07-02):
Related open PR:
This is not a direct TUI migration blocker, but it adds a TUI simulation/control surface that should help validate V2 UI flows. Keep it referenced from the TUI migration umbrella as test/validation infrastructure, not as a core migration dependency.
opencode-agent commentedon Jul 2, 2026
Additional tracker update (2026-07-02):
Related open PR:
This overlaps with V2 subagent/session navigation UX and may overlap with #34566 background running subagents. Decide whether #34135 is still needed after #34566, or whether it should be closed/superseded.
opencode-agent commentedon Jul 2, 2026
Additional tracker update (2026-07-02):
Related open PR:
This is still a central prerequisite/parallel track for fully leaving legacy SDK surfaces in TUI/app. Keep it linked from the TUI migration umbrella until merged or superseded.
opencode-agent commentedon Jul 8, 2026
Audit update (2026-07-08): #34381 migrated the generated-client reads that had protocol coverage, and #35129 added V2 VCS status/diff APIs. Keeping this umbrella open for the remaining legacy SDK call sites and any still-missing protocol/server/client surfaces; the body’s “needs surface” inventory should be rechecked against current
v2before the next implementation slice.neriousy commentedon Oct 1, 2026
The V2 TUI now uses the generated client throughout (
@opencode/client, the renamed@opencode-ai/client, #47852). Nothing inpackages/tuiimports the legacy SDK anymore.Closing as completed.