feat(chat): let users override a conversation's model#39
Merged
Conversation
… profile default Adds a per-conversation model override so any chat session can switch or type a custom model at any time, regardless of whether the underlying runtime already supports it. Persisted on the session (mirrors the chatBypassPermissions pattern), applied via a three-tier fallback (live adapter.setModel -> best-effort /model slash command -> saved for next launch), and always beats the runtime profile's default for that conversation only. Composer's model chip becomes an always-enabled combobox with free-text entry and honest per-outcome feedback, replacing the old dead-end disabled state. Closes #38 Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Contributor
There was a problem hiding this comment.
Pull request overview
This PR adds a conversation-scoped “model override” that users can change at any time from the chat UI (pick-from-list or free-text), persists it on the session record, and applies it on server session start with a three-tier fallback (live adapter switch → best-effort /model <value> turn → saved for next launch). It also adds client-side state and tests to keep the displayed model label honest (only updating once the server confirms live/cleared).
Changes:
- Persist
chatModelOverrideonSessionRecord(DB column + save/load + upgrade path). - Add
chat_set_model/chat_model_resultwebsocket handling on the server with live/sent/pending/cleared outcomes and apply the override on both PTY and chat start paths. - Update client UI/controller to always expose an enabled model control with feedback, plus new/updated tests across server and client behavior.
Reviewed changes
Copilot reviewed 13 out of 13 changed files in this pull request and generated 2 comments.
Show a summary per file
| File | Description |
|---|---|
| test/session-store.test.js | Adds persistence and DB-upgrade coverage for the new chatModelOverride session field. |
| test/chat-wiring.test.js | Adds wiring tests for override precedence, live/sent/pending/cleared outcomes, and user scoping. |
| test/chat-model-controller.test.js | Ensures the UI label only adopts the override when confirmed live/cleared. |
| test/chat-composer.test.js | Verifies model control is always present/enabled and that feedback rendering behaves correctly. |
| src/server/websocket/messages.ts | Implements chat_set_model, persists override, applies fallbacks, and includes override in snapshot/start messages. |
| src/server/types.ts | Adds chatModelOverride?: string to SessionRecord. |
| src/server/services/session-store.ts | Persists chat_model_override to/from SQLite rows. |
| src/server/services/database.ts | Adds chat_model_override column via addColumnIfMissing. |
| src/server/chat/session.ts | Adds adapter-backed setModel() for live model switching when supported. |
| src/server/chat/manager.ts | Exposes setModel() on the session manager. |
| src/client/shell/chat/Composer.tsx | Reworks ModelChip into an always-available picker + free-text input with server feedback banner. |
| src/client/shell/chat/ChatView.tsx | Wires onSetModel + uses controller override value for the displayed model label. |
| src/client/chat/controller.ts | Tracks model override + last result, updates label only on confirmed outcomes, and sends chat_set_model. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
Comment on lines
+1182
to
+1184
| const raw = typeof data.model === 'string' ? data.model.trim() : ''; | ||
| const model = raw || undefined; | ||
| session.chatModelOverride = model; |
Comment on lines
+1260
to
+1266
| sendToWebSocket(wsInfo.ws, { | ||
| type: 'chat_model_result', | ||
| sessionId: session.id, | ||
| model, | ||
| applied: 'pending', | ||
| message: `Saved. This runtime cannot change model mid-session — ${model} will be used the next time a new session starts for this conversation.`, | ||
| }); |
This was referenced Jul 26, 2026
dnviti
added a commit
that referenced
this pull request
Jul 26, 2026
…l /clear (v5.1.2) (#37) * chore: bump version to 5.1.2 * feat(chat): let users override a conversation's model, independent of profile default (#39) Adds a per-conversation model override so any chat session can switch or type a custom model at any time, regardless of whether the underlying runtime already supports it. Persisted on the session (mirrors the chatBypassPermissions pattern), applied via a three-tier fallback (live adapter.setModel -> best-effort /model slash command -> saved for next launch), and always beats the runtime profile's default for that conversation only. Composer's model chip becomes an always-enabled combobox with free-text entry and honest per-outcome feedback, replacing the old dead-end disabled state. Closes #38 Co-authored-by: Claude Sonnet 5 <noreply@anthropic.com> * feat(chat): collapsible turn sections, auto-folded on a new turn (#34) (#40) A long conversation used to be one unbroken wall of fully-expanded turns. Each turn's strip now discloses/hides its own body; only the newest turn opens by default, a turn the user has explicitly opened or closed stays that way across new turns, and jumping to a turn via the rail or search force-opens it. Expand-all/collapse-all lives in the turn index header. Co-authored-by: Claude Sonnet 5 <noreply@anthropic.com> * fix(chat): show Claude's slash commands from the moment a session opens (#41) Claude's CLI does not report `slash_commands` until it has processed a first turn's `system/init`, which only arrives after the first message is written to its stdin. The chat session spawns the process as soon as a chat is opened, well before any message is sent, so the command menu and its composer button stayed empty — looking broken — until a throwaway message unlocked them. The adapter now advertises a static baseline built from this app's own table of Claude's built-in commands as soon as it starts, so the menu and button are populated immediately. The real `init` list — including any project or plugin commands — still arrives with the first turn and replaces this baseline outright, exactly as before. ACP runtimes (kimi, omp) already report commands during their handshake, before any message is sent, so they were never affected. codex, grok and pi have no command support at all; the composer already hides the button entirely rather than showing an empty menu, which is the honest behavior for a runtime that offers none. Closes #30 Co-authored-by: Claude Sonnet 5 <noreply@anthropic.com> * fix(chat): make /clear and /new actually reset the conversation (#47) `/clear` and `/new` forwarded their text to the still-running agent process like any other message, then only added a cosmetic marker that hid prior messages in the UI. The next message sent it right back into the same process, so the agent kept whatever context it already had — the reset never really happened, only its display did. Route clearing commands through the same restart path a manual "start fresh" relaunch already uses: stop the live adapter and start a new one with no resume id, so the next turn talks to a process that was never handed the prior conversation. This also fixes the id persisted for later reconnects, so a rejoin can't resurrect it either. Fixes #43 Co-authored-by: Claude Sonnet 5 <noreply@anthropic.com> * fix(chat): show the answer as it streams, and keep a model override across /clear (#49) Five defects introduced by the four PRs already merged onto the 5.1.2 branch. Each one's own tests passed; all but one lived where two of them met. The chat stopped rendering. MessageList looked messages up in a map memoised on the messages array, but the transcript appends to that array in place, so its identity never changes: the map was built once at mount and every message after it resolved to nothing. The strips above kept ticking while the bodies stayed empty, and reloading "fixed" it because reloading replaces the array. Keyed on the transcript version instead, which is the cadence the neighbouring memo already used — the list still does not re-render per token. A model override no longer survives /clear. The restart replays the options the session was launched with, and the model is the one thing in them that can change while the session is alive, so the conversation quietly went back to the model it opened with after the browser had been told the switch applied. The choice now reaches those options too, by either door: the picker, and a /model typed straight into the composer, which was forwarded untouched and hit the same reversion. A collapsed turn's title escaped its bar. It set neither a size nor nowrap while every sibling in that fixed-height row sets both, so it inherited the page default and wrapped — and without nowrap the ellipsis was inert. An override could not be undone. The server had a "cleared" path, message and all, that nothing in the UI could reach: the text field refuses to submit empty and every listed model carries a name. A typo therefore stayed in force for every later launch of that conversation. Model names are now capped and stripped of control characters, which would otherwise ride into the best-effort /model turn as extra lines. The browser checks gated nothing: npm test runs only the unit suite, and the runner exited 0 when Chrome was absent. With the rendering bug restored, npm test passes 1357/1357 while the browser check fails. They now run in CI and refuse to skip there. Their fixture also grew a second turn, without which no turn is ever collapsed and the broken title was never rendered at all. Every fix has a test confirmed to fail against the unfixed code. Co-authored-by: Claude Opus 5 <noreply@anthropic.com> --------- Co-authored-by: Claude Sonnet 5 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
chatModelOverridefield on the session (mirrors the existingchatBypassPermissionspattern: additive nullable DB column, same save/load shape).adapter.setModel()where implemented → best-effort/model <value>slash-command send where the runtime advertises one → saved for the next time a new session starts for that conversation. Both session-start paths (PTY and chat) now prefer the saved override over the runtime profile's configured default.Composer.tsx's model chip goes from a dead-end disabled control to an always-enabled combobox (pick-from-list + free-text), with an honest feedback banner per outcome (live/sent/pending/cleared) and the active model always visible.Closes #38
Test plan
npm run typecheck— cleannpm run build— cleannpm test— 1341 passing (1337 prior + 4 new)pending/sent(only onlive/cleared, regression test added), and a stale security comment about client-forgeable launch config was updated🤖 Generated with Claude Code