[atornsii]

This adds the setup agent step to the ldcli setup wizard, on top of the adapter from PR 1.

What changed

• The agent step replaces the init step. Setup always uses the agent. If OpenCode is missing or the agent fails, setup stops with the error. It does not use the init templates.
• ldcli setup --project <key> --environment <key> selects the project and environment and skips their screens, so one command can start setup.
• ldcli setup agentcontrol --path . --sdk-id node-server --flag-key my-new-flag runs only the agent step, without the wizard.
• The step shows finished tool calls, and it shows the agent's questions with numbered options (s skips). Permission requests are queued, if a version asks for them.
• After the run, the wizard lists the changed files and shows the export command for the SDK's own credential only. It then goes to the existing verify step.
• Setup stops OpenCode when the user quits, when a run finishes starting after the user quit, and when the terminal closes (SIGHUP).

Testing

Wizard tests with a fake runner cover the agent step, the queue of permission requests, questions with one or several items, the error when the agent cannot run or fails, the --project and --environment presets and an unknown key, the close on quit, and the credential line. ldcli setup agentcontrol tests cover permission and question input on the terminal.

Diagram

flowchart TD
  setup["setup.go<br/>NewSetupCmd: --project, --environment<br/>AddCommand newAgentCmd"]:::chg
  cmdag["agent.go<br/>agentTask<br/>credentialExport, describeTool<br/>newAgentCmd, runAgent<br/>streamAgent, askQuestions"]:::new
  model["model.go<br/>stepAgent, agentRunner, agentRun<br/>permission and question queues<br/>runTracker"]:::chg
  view["view.go<br/>agentView, agentWaitView"]:::chg
  upd["update.go<br/>handleAgentEvent<br/>agentFailed, closeAgent<br/>answerAgentQuestion"]:::chg
  cmds["commands.go<br/>startAgent, waitForAgentEvent<br/>replyAgent, answerAgent"]:::chg
  pkg["internal/setup/agent from #894<br/>Runner.Start, Run.Events"]:::earlier
  verify["verify step<br/>existing wizard step"]:::earlier
  setup -->|newAgentCmd| cmdag
  setup -->|runner, mode| model
  view -->|reads state| model
  upd -->|updates state| model
  upd -->|returns tea.Cmd| cmds
  upd -->|describeTool, credentialExport| cmdag
  cmds -->|agentTask| cmdag
  cmds -->|Start, Events, Reply, Answer| pkg
  cmdag -->|runAgent| pkg
  upd -->|agent done| verify
  classDef new fill:#e6f0fa,stroke:#1d6fb8,stroke-width:2px,color:#19202b
  classDef chg fill:#fbf1e1,stroke:#a86a12,stroke-width:2px,color:#19202b
  classDef earlier fill:#ffffff,stroke:#7a8494,stroke-dasharray:5 4,color:#19202b
  classDef ext fill:#eceefa,stroke:#4e5a9c,stroke-width:2px,color:#19202b

Loading

Blue boxes are new files, orange boxes are changed files, dashed boxes are files from an earlier PR, and purple boxes are outside ldcli. A solid arrow goes from the caller to the code that it calls. A dashed arrow shows data that moves without a direct call.

setup.go adds the --project and --environment flags, gives the runner to the wizard model, and registers ldcli setup agentcontrol. When the project or environment list loads, update.go selects a preset key and skips that screen. In the wizard, commands.go starts the run and waits for each event as a Bubble Tea command (a function that returns a message to the wizard). update.go handles each event, changes the state in model.go, and returns the next command. view.go draws that state. If the agent cannot run or fails, update.go stops setup with the error. When the agent finishes, the wizard goes to the existing verify step. The ldcli setup agentcontrol subcommand in agent.go uses the same runner without the wizard.

This PR uses only the Runner and Run interfaces and the Event types from #894. It does not change the agent package.

Stack

This is one of six PRs for the ldcli setup agent. Review and merge them in order, after #877 (Go 1.26):

1. OpenCode adapter
2. Wizard agent step
3. macOS sandbox
4. AI SDK and relay
5. OpenCode handler
6. Run fixes

They replace #876 and #878.

🤖 Generated with Claude Code