Skip to content

feat(runtime): configure an ACP agent's model and reasoning from Quartet - #82

Merged
lvndry merged 4 commits into
mainfrom
feat/acp-runtime-config
Sep 19, 2026
Merged

lvndry merged 4 commits into
mainfrom
feat/acp-runtime-config

Conversation

@lvndry

@lvndry lvndry commented Sep 19, 2026 •

Copy link
Copy Markdown
Owner

What & why

ACP agents (Claude, Codex) expose their own session settings — which model, what reasoning level — but until now Quartet treated all of that as off-limits, showing a read-only note telling you to configure the agent by hand. This adds a model/reasoning picker to the runtime view.

Quartet discovers the choices from the agent itself (ACP session config options), so the dropdowns show exactly what the connected agent supports — no hardcoded model list. Opening the runtime screen probes the agent (a throwaway session) to populate the options without making you open a room first. A choice is saved to the identity and reapplied to every session the agent starts, so it survives restarts, and it also tracks changes the agent makes on its own.

How to verify

  • Connect an ACP identity (--runtime claude / --runtime codex) and open Your runtime: it briefly probes the agent, then shows model and reasoning selectors.
  • Change the model; confirm it takes effect and, after restarting the bridge, the choice is still selected (persisted in identities/<id>/config.json under runtime.configOptions).
  • Codex reasoning effort (low/medium/high) shows as its own selector and applies to the next turn.
  • Edge case: an agent that exposes nothing shows a note plus a "Try again" button; a Jazz identity is unaffected.

Depends on nothing beyond the adapters already installed. Builds on #81 (merged).

🤖 Generated with Claude Code

An ACP agent advertises its session config options — model, reasoning level, mode — on
session/new, and takes session/set_config_option to change them. The ACP runtime now captures
those options, reapplies the operator's saved choices to every session (a fresh session starts
at the agent's defaults), tracks config_option_update the agent pushes on its own, and exposes
a setter. Choices persist per identity in config.json and are relayed into the bridge snapshot,
so a model or effort picked once survives restarts.
…board

The runtime view was a read-only note telling you to configure the agent elsewhere. It now
renders a selector per option the agent discloses, bound to the live snapshot, and writing a
choice back through /api/runtime/config. Options appear once a room exists to read them from;
anything the agent does not expose stays configured in the agent, as the footer still says.
@vercel

vercel Bot commented Sep 19, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
quartet Ready Ready Preview Sep 19, 2026 10:45am UTC

The options only exist once a session does, so the runtime screen opened to an empty page
telling you to go open a room first. It now asks the bridge to probe — open one throwaway
session, read the options (applying saved selections), close it — when the screen is shown,
with a loading line while it runs and a retry if the agent could not be reached.
The four places that had to agree on the preset list — the config type union, the ACP_PRESETS
record, the wizard's CHOICES, and the hand-written error string — collapse into one catalog in
runtime-catalog.ts, so adding a built-in is a single entry. A machine can register its own
agents in ~/.quartet/runtimes.json (name → command/args/label/installHint); they appear in the
wizard, answer to --runtime <name>, and carry an install hint, with built-in and reserved names
protected. An agent that does not speak ACP still needs its own TurnRunner; this is only about
the ACP shortcuts.
@lvndry
lvndry merged commit 8d493c7 into main Sep 19, 2026
4 of 5 checks passed
@lvndry
lvndry deleted the feat/acp-runtime-config branch September 19, 2026 10:45

This branch was successfully deployed

1 active deployment
Preview — 7af19f20 Deployed Sep 19, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant