Add Stream Deck Plus dials, touch controls, and model presets

CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## Unreleased
+
+- Added a per-knob Stream Deck + Model Presets dial that immediately and continuously wraps through configurable model/reasoning pairs using Codex's native paired selection path.
+- Added live model and reasoning dropdowns with add, remove, drag, accessible reorder controls, preserved unavailable entries, and an opt-in Ultra policy.
+- Added `SWITCHING…` as non-optimistic pre-confirmation feedback, plus active-position and `UNLISTED` feedback derived only from confirmed state, along with empty, unavailable, and health feedback without keyboard or focus navigation.
+- Added capability-gated Model Presets support for authenticated Mac/Windows relays; older peers fail closed without partial switching.
+- Fixed standalone command keycaps such as Terminal after current Codex builds moved their guarded runner behind the live Micro bridge import.
+
 ## 0.7.0.2 - 2026-07-22
 
 - Normalize remote snapshot timestamps to local receipt time so ordinary Mac/Windows clock differences cannot hide working, selected, approval, or usage state.

README.md

@@ -28,6 +28,7 @@ Windows-only and Mac-only mode have no relay, no second computer dependency, and
 - Native key-down/key-up handling for Micro slots `ACT06` through `ACT12`.
 - Native joystick up, right, down, left, and encoder click.
 - Dedicated reasoning-effort up/down buttons with press-and-hold repeat.
+- Configurable Stream Deck + knobs with independent rotate, press, touch, and live feedback controls, including per-knob Model Presets that immediately switch among ordered model/reasoning pairs; see the [Stream Deck + guide](docs/STREAM_DECK_PLUS.md).
 - Live usage controls: a configurable circular 5-hour/weekly limit key and a two-window overview.
 - A centered reset-credit counter with a deliberate 1.2-second hold before an applicable credit can be consumed.
 - A local `codex://threads/new` action for a new task.
@@ -43,9 +44,10 @@ Windows-only and Mac-only mode have no relay, no second computer dependency, and
 - Elgato Stream Deck 6.6 or newer on the computer connected to the Stream Deck.
 - Node.js 20 or newer for the platform launcher.
 - Windows 10+ or macOS 13+.
-- Tested hardware: standard 15-key Stream Deck MK.2.
+- Tested keypad hardware: standard 15-key Stream Deck MK.2.
+- Stream Deck + is required for the Encoder-only **Codex Dial** action.
 
-Other Stream Deck models may work, but the included layout and physical-device testing target the normal 5×3 MK.2.
+Other keypad models may work, but the included 15-key layout and its existing physical-device testing target the normal 5×3 MK.2. Stream Deck + dial setup and its separate verification boundary are documented in the [Stream Deck + guide](docs/STREAM_DECK_PLUS.md).
 
 ## Quick install
 
@@ -56,6 +58,7 @@ Other Stream Deck models may work, but the included layout and physical-device t
 3. Follow [Windows](docs/WINDOWS.md), [macOS](docs/MACOS.md), or [Windows + Mac](docs/MULTI_HOST.md).
 4. In **Codex Settings > Codex Micro**, choose the agent source, action assignments, joystick actions, and encoder behavior.
 5. Build the two Stream Deck pages below.
+6. On Stream Deck +, add the optional four-knob [Status-focused Codex Dial layout](docs/STREAM_DECK_PLUS.md#status-focused-four-knob-defaults). Its Model Presets knob uses live Codex model/reasoning choices, continuous wrap, Press None, and Fast Mode on touch by default.
 
 The iPhone companion is currently source-only: **a Mac with Xcode is required
 to build, sign, and install it**, even when the phone will control only a

docs/ARCHITECTURE.md

@@ -54,14 +54,19 @@ The same plugin runs on Windows and macOS. It discovers the local loopback port
 4. dispatch Micro HID and joystick events;
 5. emulate native encoder-rotation HID events for reasoning-effort changes;
 6. resolve standalone keycap actions from Codex's live Micro keycap registry and current official command runner;
-7. read Codex's renderer-owned `rate-limit-status` query and normalize its current 5-hour, weekly, and reset-credit state.
+7. read Codex's renderer-owned `rate-limit-status` query and normalize its current 5-hour, weekly, and reset-credit state;
+8. best-effort read the active visible composer's optional reasoning effort for honest Encoder feedback.
 
 The bridge does not emulate a USB HID device and installs no driver.
 
 Usage data remains part of the same typed host snapshot, but usage and reset credits are account-scoped and therefore do not follow the Mac/Windows function-key target. The controller prefers a healthy local account snapshot and falls back to the paired host only when local usage is unavailable. Window identity is derived from the duration returned by Codex rather than from primary/secondary ordering. A missing 5-hour window is represented as unavailable, and Automatic mode falls back to weekly. The bridge refreshes a stale renderer-owned usage query at most once every 15 seconds, so background-window values do not depend on Codex receiving focus.
 
 Reset consumption is the only mutating usage operation. It is a narrow typed relay command and calls Codex's current native reset-credit client only after the Stream Deck key has been held for 1.2 seconds. The bridge verifies both availability and applicability, selects an available plan-supported credit, uses a unique redemption request ID, and then refreshes the renderer query. No credential, raw endpoint access, or arbitrary request surface is exposed to the relay.
 
+`Codex Dial` is one Encoder-only Stream Deck action with versioned, per-instance settings. Its pure dial domain normalizes preset and custom settings against allow-listed bindings, expands each paired-rotation detent into an ordered command, reconciles selector identity, and derives the five stable feedback fields. The action adapter forwards Encoder rotate, down, up, and touch events to the controller; it does not add a second command surface. Rotation can dispatch paired controls immediately or update a selector preview, while press and touch remain independent.
+
+An explicit usage refresh is a typed operation. Locally, one renderer evaluation requests a fresh `rate-limit-status` query and rejects rather than replacing last-known usage when the forced refresh cannot return valid data. Remotely, the relay advertises `usage-refresh`, binds capability and snapshot state to the current authenticated connection generation, publishes a fresh post-command snapshot, and only then acknowledges success. Older peers may omit the optional capability and reasoning field.
+
 ### Optional multi-host relay
 
 The Mac watcher can host an authenticated WebSocket relay on loopback behind an
@@ -147,6 +152,14 @@ The controller uses non-overlapping self-scheduled refreshes and caches the last
 image sent to each action instance. Unchanged keys therefore produce no repeated
 USB image writes. Animated frames are limited to working and approval states.
 
+Encoder feedback uses a custom 200 x 100 layout with keyed title, value, detail,
+indicator, and accent fields. The controller keeps selector and overview state,
+an async command queue, and the last normalized feedback signature per visible
+dial action. `setFeedback` is skipped when that signature is unchanged. Dial
+registration, settings replacement, disappearance, and in-flight render work
+are generation-aware so an obsolete action instance cannot overwrite its
+replacement. See the [Stream Deck + guide](STREAM_DECK_PLUS.md) for the user-facing behavior.
+
 ## Trust boundary
 
 CDP provides privileged access to the Codex renderer. Binding to `127.0.0.1` prevents direct access from another machine, but not from another process running as the same local user. Treat the launcher-started session like any other local debugging session:

docs/MACOS.md

@@ -39,6 +39,10 @@ Tailscale remote access remains a separate optional profile; see
    **Start Codex Deck.command** is the double-clickable equivalent of `start`.
 5. Open **Codex Settings > Codex Micro**, configure the native slots, and add the actions from the [recommended layout](../README.md#recommended-15-key-layout). Leave the Windows/Mac target position empty or replace it with another action.
 
+### Stream Deck + knobs
+
+On a Stream Deck +, drag one **Codex Dial** action onto each knob you want to use. The recommended Model Presets, Agents, Actions, and Usage presets, independent rotate/press/touch settings, and the macOS physical verification checklist are in the [Stream Deck + guide](STREAM_DECK_PLUS.md). The guide's checklist is the verification boundary; this setup page does not by itself claim that a specific build completed hardware QA.
+
 If an archive tool removed executable permissions, restore only the two launcher files:
 
 ```zsh