* feat: Let a theme reshape the sign-in field and button
The sign-in floating-label field, the submit button and their shared corner read the new authFieldHeight, authButtonHeight and authControlRadius appearance roles, whose defaults reproduce the 44px field, 48px button and 16px corner. The corner follows radius2xl when a theme names only that. The ClickHouse theme draws them at Click UI's single field and button size with the button's square corner.
* fix: Size the sign-in button by its height role alone
A fixed height with vertical padding left a short theme height less room than the label. Specs now expect the role classes on the sign-in field.
* fix: Keep the reset label and password controls inside a themed field height
The reset request label rests in the middle of the field instead of 12px from its top, and the password field's reveal and copy buttons size from the sign-in field height, 4px off its edges and never under 24px. Both keep their stock positions and sizes.
* fix: Hold the password field controls inside the padding it reserves
The reveal and copy buttons stop growing at the stock 2.25rem, so a taller sign-in field keeps them clear of the typed value.
* feat: Let a theme reshape the second-factor and reset-success actions
The 2FA verify and reset-success continue buttons read authActionHeight and authActionRadius, which follow the sign-in button's height and corner when a theme names those and otherwise the Button height and radiusLg they drew, so the stock screens are unchanged and ClickHouse draws them at 32px with its 4px corner.
* test: Reach the second-factor screen through a pending sign-in
* fix: Rest the reset label inside a minimum-height field and keep the action corner on radiusLg
The reset request label rests from an inset that centers it 2px low as before but never past the field's bottom edge, and the other sign-in actions resolve their corner before the sign-in corner is derived from radius2xl, so a theme that names only radius2xl keeps radiusLg on them.
* fix: Show the Focused State of the InputNumber Option Variant
* test: Probe the InputNumber root rather than its input wrap
* fix: Keep the InputNumber Option Focus Fill Above Its Hover Fill
* feat: Adopt the continue icon, artifact timing, avatar border and dropdown intents Tailwind 3 never rendered
Sizes the continue action's glyph to the 19px of the actions beside it, times the artifact sheet's close to the 250ms its unmount waits for and the docked panel's open to 350ms, frames agent avatars with the 1px border they asked for, and lets the dropdown menu primitive cap its height, grow from its trigger and tint a destructive item's icon.
* fix: Cap the dropdown submenu at the space Radix measures
* test: Stop pinning the adopted artifact durations as inert
The sidebar toggle and the Agent Marketplace link use the nav Button variant and the new chat link hovers in surface-nav-hover, so every control in the desktop rail shares the navigation hover the panel buttons and sidebar rows use.
* feat: Route Every Prompt Category Icon Through a Per-Slot Role
* test: Retry Category Icon Reads While the Prompt List Settles
* fix: Carry the Renamed Category Icon Role to Its Slot 4 Name
* fix: Carry the Renamed Category Icon Role Through Every Color Reader
* fix: Keep Renamed Color Roles Out of the Unknown Token Warnings
* refactor: Paint the desktop icon rail with the nav Button variant
The rail's panel buttons now use the shared nav variant, so their hover and selected fills come from surface-nav-hover and surface-nav-selected like the sidebar rows, and the selected state stays on aria-pressed.
* test: Run the rail nav scenarios on a pointer device
* feat: Give Prompt Category Icons a Purpose Color Role
* fix: Keep Token Formatting and Skip Hover on Touch in the Category Icon Scenario
* test: Refresh the Theme Resolver Pin After Rebasing on the Avatar Ink Change
* fix: Read Math Function Channels in CSS Custom Property Triplets
* fix: Collapse Nested Numeric Math Before the Triplet Check
* fix: Read Exponents and Math Constants in Triplet Channels
* fix: Read round() Strategies in Triplet Math Channels
* 📴 fix: Stamp Legacy Failure Parts When Settling a Compaction Row
* 📴 fix: Redirect the Collision Error Row to the Live Response Id
* 📴 fix: Withhold the Anchor-Colliding Error Row and Keep Pending Rows Fallbacks
* 📴 fix: Scope the Settled-Job Guard to Compactions and Copy Stamped Parts
* test: Cover the Underscore-Leaf Compaction Failure and Abandoned Replies in E2E
* test: Fail the Underscore-Leaf Compaction Through the Blank Summarizer
* refactor: Return the Final Error Row Id From the Settlement
* refactor: Use Spinner Tones, Label Variants and Shared Button Props in Remaining Components
Replaces text colour, round shape and size overrides with the primitives' own tone, variant, shape and size props where the merged classes are identical, drops redundant field overrides, and removes the prose and arbitrary transition classes that generated no CSS or have a token form.
* test: Cover the Quiet Ink of the Marketplace Search Clear Button
* test: Assert the Clear Button Hover Ink Only Where Hover Exists
* refactor: Replace Inline Styles With Classes Outside Chat and the Side Panel
Moves display, overflow, user-select, outline, will-change, backdrop and mask styling onto utility classes and CSS custom properties across Agents, Artifacts, Audio, Bookmarks, Plugins, Projects, Share, routes and the shared client components, and drops the recorded no-inline-styles suppressions they cleared.
* test: Cover Marketplace Grid Columns Driven by the Columns Variable
* test: Pick a Single-File Directory for the Moved-File Prune Fixture
* refactor: Give InputNumber an Option Variant for Setting Values
* fix: Ship the Option InputNumber Reset With the Package Stylesheet
* refactor: Prune the Setting Value Suppressions After Rebase
* refactor: Use Existing Variants and Drop Redundant Overrides in Nav, Skills, Prompts and Endpoints
* test: Cover the Header Menu Trigger in the Default Theme
* chore: Prune Design Suppressions After the Rebase
* a11y: Ring Tabs, Table, Dropdown and Menu Items in the Focus Control Role
* test: Tag the Focus Primitives Scenarios Literally
* test: Match the Dark Focus Rule That Yields to Outline Utilities
* refactor: Keep Menu Items and Table Rows on Their Existing Focus Treatment
* refactor: Leave Tabs and Dropdown on the Global Focus Outline
* test: Assert Both Outline Utility Exclusions in the Dark Focus Rule
* refactor: Clear Chat Input Design Suppressions Through Existing Variants
* test: Cover the Chat Composer Send Path After the Suppression Cleanup
* refactor: Keep the FileUpload Action on Its Ghost Pressed Fill
* feat: Add 10, 11, 13 and 15px Steps to the Theme Type Scale
* test: Prove the Off-Scale Type Steps in the Mock Harness
* style: Sort cn Imports
* refactor: Name the 13 and 15px Steps 1xs and 1sm
* test: Probe the Type Step Roles Instead of Unused Utilities
* fix: Keep Chrome Surfaces and Destructive Confirms Legible in a Quiet-Chrome Theme
* fix: Soften Remaining Inline Destructive Triggers and Canonicalize Zero Chrome Alpha
* fix: Keep Pressed Feedback on the Quiet-Chrome Floating Control and Cover the Quiet Surfaces
* test: Scope the Quiet Surface Scenarios to the Header
* fix: Keep the Two-Factor Disable Trigger on the Soft Destructive Variant
* feat: Show Lia on the Welcome Screen
Adds the opt-in Show Lia setting (off by default) and the interface.mascot deployment flag (allowed by default). Lia mounts only on the landing page, loads lazily after first paint, stands on the composer's top edge clear of the greeting, reacts to typing, files and theme changes, and speaks through localized bubbles. She is decorative and hidden from assistive technology.
* fix: Keep Lia's Long-Message Reaction Re-Armed and Pointer Reads Per Frame
Deleting a message back under 280 characters now re-arms the long-message reaction, pointer handling reads layout at most once per animation frame, and the ChatView specs stub Lia like their other children.
* test: Open Settings from the Phone Drawer in the Lia Scenarios
The opt-in scenario no longer resets the stored preference on reload, and both Settings scenarios open the account menu from the mobile drawer on phones.
* fix: Measure Lia's Caret Like the Composer and Label Her When Idle
The caret mirror copies direction, alignment, indentation, wrapping and box sizing, so right-to-left and wrapped text measure like the composer. Hovering Lia between activities now says she is hanging out instead of showing nothing.
* fix: Wave Off Assistants Sends and Keep Lia's Canvas and Bubble Off Welcome Content
* fix: Keep Lia's Speech Bubble Inside Her Stage
* fix: Wrap Long Translations in Lia's Speech Bubble
* fix: Keep Lia's Long-Message Reaction Until It Plays and Pin the Scenario Greeting
* fix: Make Only Lia's Body Clickable So She Fits Beside Long Greetings
* fix: Let Lia Stand Beside the Composer When the Greeting Fills Its Top
* feat: Let Users Drag Lia Around and Keep Her Near the Composer
* test: Cover Picking Lia Up and Setting Her Down on the Composer
* refactor: Keep Lia's Preference Inside Her Feature
* fix: Let Keyboard Users Pet Lia and Move Her With the Arrow Keys
* test: Shift Only the Wall Clock for Lia's Morning Greeting
* test: Measure Lia's Keyboard Walk Both Ways So the Greeting's Width Cannot Pin Her
* fix: Bring Lia Back When a New Chat Opens During Her Farewell
* fix: Start Lia's Reactions on Her Own Clock After a Pause Without Room
* fix: Load Lia Through Stale-Asset Recovery and Skip the Farewell Before She Appears
* feat: Mark the Lia Settings Toggle as Beta
* refactor: Give Sign-In Controls Button, Input and Alert Variants
* fix: Load the Field Stylesheet From SecretInput
* fix: Default the Floating Fields to the Placeholder Sentinel
* test: Cover the Sign-In Control Roles in the Default Theme
* test: Wait for the Floating Label Transition Before Reading It
* test: Read the Floating Label Scale Property
* fix: Keep Button Heights on Theme Roles and Honor Reduced Motion in Floating Fields
* refactor: Mark Message Text Containers With a Data Attribute
* test: Tag the Private Text Spec as a Scenario
* test: Cover Message Text Containers in a Mobile-Safe Scenario
* fix: Dim a Disabled InputNumber Through Its Nested Input
* test: Cover the Disabled InputNumber Wrapper in the Browser
* test: Tag the InputNumber Scenarios Literally
* fix: Make DataTable Row Estimates Breakpoint- and Leaf-Column-Aware
* test: Cover the Compact Row Estimate Against the Rendered Cell
* test: Tag the Row Estimate Scenarios Literally
* fix: Reconcile stopped generations before detaching the stream
* test: Cover immediate Stop and delayed terminal reconciliation
* test: Accept both terminal outcomes of an immediate Stop
---------
Co-authored-by: Lia <lia@librechat.ai>
* feat: Quiet Prompt Editor Boxes, Table Columns and Destructive Buttons for a Theme
* fix: Outrank the Cell Border Color With the Column Rule Share
* fix: Keep the First Table Cell's Outer Edge Under the Inset Share
* fix: Keep the Batched Edit Divider on the Light Border
* fix: Keep Web Search Source Row Separators on the Light Border
* fix: Quiet the Result Switcher Divider and Keep the RTL Table Edge
* fix: Resolve Table Edges by Cell Direction and Keep the Variables Card Opaque in Details
* fix: Draw Table Frame Edges in Logical Terms So Direction Needs No Selector
* fix: Keep Soft Destructive Hover and Pressed Tints Above 4.5:1
* feat: Let a Theme Quiet Decorative Borders
* test: Cover the Chrome and Inset Border Roles in the Mock Harness
* fix: Draw the Selected Category Tab Edge at the Chrome Share
* fix: Route Chips, Subtle Icon Buttons and Hover Rings Through the Chrome Share
* fix: Draw the Remaining Inner Card Dividers at the Inset Share
* feat: Add a Focus Role for Rows Inside Content
* test: Cover the Subtle Focus Role in the Mock Harness
* test: Probe the Subtle Focus Role Through Its Theme Variable
* test: Focus the Probe to Read the Subtle Focus Utility
* test: Read the Subtle Focus Ring From Its Utility Property
* fix: Ring the Subagent Progress Disclosure in the Subtle Focus Role
* 📴 fix: Finalize Compaction Snapshots and Move Abort Policy Into packages/api
* 🔕 fix: Inspect Every Part When Finalizing and Reuse the Loaded Row
* 📴 fix: Settle Finalized Compaction Rows and Verify Their Anchor
* 📴 fix: Withhold the Unanchored Abort Final and Settle Marked Snapshots
* 📴 fix: Consolidate the Compaction Abort Policy Into One Injected Operation
* 📴 fix: Settle the Live Compaction Row Past an Anchor-Shaped Collision
* 📴 fix: Lift the Failed-Turn Settlement Into the Compaction Module
* 📴 fix: Keep a Removed Round's Failure and Guard Settled Jobs From Snapshots
* ⚡ perf: Read Only the Anchor Id in the Abort Existence Check
* 📴 fix: Withhold the Abort Final Only When a Row Needed Writing
* test: Cover Stopped Compaction Finalization and the Missing Anchor in E2E
* fix: Withhold a Stopped Compaction That Carries No Anchor Id
* fix: Settle Stopped Compactions, Announce Finalized Rows, and Own the Abort Read in packages/api
* test: Accept the Model Spec Query on the Stopped Reply Conversation URL
* fix: Report the Anchor Read Failure Beside a Withheld Compaction Abort
* fix: Synthesize a Compaction Failure Only for a Round After the Latest Outcome
* fix: Skip the Anchor Read When a Stopped Turn Writes No Row
* fix: Decide the Disconnect Snapshot Gate in packages/api
The last-subscriber partial save now asks resolveDisconnectSnapshotMode for
the settled-job decision instead of branching on the job record in the CJS
controller.
* fix: Leave an Already Settled Compaction Row to the Path That Settled It
* 📴 fix: Persist Cancelled Compactions With Their Identity
* 🧪 test: Build the Cancelled-Compaction Leaf on a Real Conversation
* 🧪 test: Assert the Withheld Controls on the Live Cancelled Compaction
* 📴 fix: Keep Live Disconnect Compaction Rows Free of a Synthesized Failure
* 🧪 test: Cover the Compaction Flag in the Redis Job Round Trip
* 📴 fix: Keep a Stopped Compaction Honest and Its Anchor Untouched
* feat: Move Chat Actions Into a Header Options Menu
The header's export/share button becomes a chat options menu with Share, Export, Rename, Pin, Change project, Remove from project, Duplicate, Archive and Delete for the open chat. The sidebar row menu keeps Pin, Mark unread, Rename, Archive and Delete.
* fix: Address Review Findings on the Header Chat Options Menu
Limit read-only subagent threads to share and export, apply the sidebar's rename gate for running chats, let an unchanged title claim ownership, keep later navigation after a late archive, hide history-only actions for temporary chats, expose dialog semantics on the dialog items, and fix import sorting.
* fix: Scope Header Chat Option Dialogs to the Conversation They Opened For
ChatView stays mounted across a route change, so dialog flags now carry the conversation id they were opened for and reset when the open chat or the read-only state changes.
* fix: Settle Header Delete and Rename Dialogs Against the Open Chat
Read the open route when a delete settles, give the delete dialog the id its menu item controls, return focus to the menu item when a rename saves, and only let a close clear the dialog it belongs to.
* fix: Ignore a Late Rename Result After the Dialog Is Gone
A rename that settles after its dialog unmounted no longer closes the parent state or moves focus to the reused menu item.
* fix: Dismiss Header Chat Options When the Route Leaves Their Chat
The route moves before the chat state does and the menu and dialogs are portaled outside the hidden pane, so they are now dismissed on a route change and gated on it. A delete that settles after another chat opened no longer closes that chat's menu, and the options read the freshest cached copy of the chat instead of an older point entry.
* feat: Layered Surface Roles for the ClickHouse Theme
Adds purpose-named roles for the chat canvas, user message, cards, sidebar rows, settings tabs, menu panels, composer and search pill. Each follows the surface it painted before, so the default theme is unchanged; ClickHouse steps them apart with Click UI tokens.
* fix: Align Sticky Phase Headers, Boot Routes, and Row Fades With the Layer Roles
* fix: Cover Trailing Slash and Bare Dashboard Paths in the Boot Canvas Route
* fix: Match Boot Canvas Routes Case-Insensitively
* test: Expect the User Message Role on Other-Author Turns
* test: Expect the User Message Role on the Subagent Briefing
* feat: Tooltip, error alert and artifact preview theme roles
* test: Cover the Tooltip Theme Roles in the Mock Harness
* fix: Lighten the Dark Document Tile and Leave the Preview Color Scheme Alone
* fix: Let the Artifact Preview Frame Follow the System Scheme and Ink Autofill in the Field Text
interface.runningChatRename now defaults to true, so a running chat or a placeholder-title chat can be renamed without a librechat.yaml override. Set it to false during a rolling upgrade from a version without title ownership.
* 🔱 feat: Simplify Steering Controls to Three Modes
* Preserve Admitted Artifacts During Interrupts
* Preserve Result Admission Across Interrupts
* Gate Interrupt for Provider-Hosted Tools
* Match Interrupt Hints to Availability
---------
Co-authored-by: Lia <lia@librechat.ai>
* fix: separate subagents and handoffs into native tools
* test: reselect the saved agent after browser reload
---------
Co-authored-by: Lia <lia@librechat.ai>
* 🔗 feat(agents): use LibreChat prompt groups as agent instructions
Agents can link a prompt group revision or Production as their instructions. The link resolves at the start of each turn through a cached resolver. The cache clears on promote and delete. Editors without VIEW on the group see a restricted placeholder.
* fix: remove duplicate logger import from agent initialization tests
* fix: honor prompt management capabilities for linked agent instructions
* test: seed prompt manager capabilities in authorization fixtures
* fix: clear acknowledged linked prompt edits before version restore
* test: adapt merged chain coverage to prompt-aware payload helper
---------
Co-authored-by: Lia <lia@librechat.ai>
* feat: add app-wide UI scale setting
* test: align dev's new header, drawer and combobox specs with the scaled shell
* fix: keep design-recorded arbitrary values off the same-count swap
* fix: scale composer and reasoning spacing on the spacing scale
* test: reach scaled rows and wait on the composer under the unpainted drawer
* test: cover the scaled composer at both ends of the range
* test: reload the composer scenario at each scale from the live page
* fix: leave the root style untouched at the default scale
* test: align dev's tool output and subagent inset specs with the rem classes
* fix: scale a caller's combobox height cap with its rows
* fix: size the conversation list's row estimate on the scaled drawer breakpoint
* test: align dev's conversation row status spec with the scaled drawer breakpoint
* style: sort the settings dialog imports after the dialog layer merge
* fix: scale the collapsed combobox's fallback popover width
* fix: size the upload glyph on both axes so it grows with the scale
* perf: Cache package builds and make client coverage opt-in
* perf: Add a cached turbo test:ci task and a parallel test:turbo script
* perf: Hash default turbo inputs and live-test env for cached tasks
* perf: Hash live-test credentials in the turbo test cache key
* perf: Hash the ignored backend test env file in the turbo test cache key
* perf: Order test tasks after consumed builds and hash cross-workspace test imports
* test: Cover the cached test runner's keys, build order and client coverage toggle
* perf: Hash the root env file the live responses suite loads
* perf: Stop caching test results and hash the client package's baked env
* fix: Pass every caller variable to test runs and include the shared client suite
* perf: Async Local File Saves and Compile Hot-Path Regexes Once
* perf: Check Closing Code Fences Without a Per-Length Regex Cache
* test: Build the Delivery Route Config Before Routing Instead of Mutating It
mergeFileConfig now memoizes by config identity, so the CSV fallback tests
must set textFallbackWithoutTools when they build the request config rather
than mutate the object after the agent's routing already merged it.
* fix: Write Local Buffers Atomically So Concurrent Saves Cannot Interleave
Async writeFile calls to one deterministic path (OpenID and SAML avatars)
could truncate and interleave each other. Write through a temp file and a
rename instead, and add scenario specs for local saves and longer closing
fences.
* refactor: Move Local Save Logic Into packages/api
saveLocalBuffer, the temp-upload move and the atomic directory writes now live
in packages/api/src/storage/local.ts and receive their paths from the caller;
the Local strategy in /api keeps its logging and calls through. The traversal
check now runs before any directory is created.
* fix: Copy Moved Uploads Through a Temp File and Rename Into Place
Concurrent async copies to one destination could interleave just like direct
writes, so moveLocalFile now fills a sibling temp file and renames it.
* fix: Contain Every Local Write and Move Inside Its Target Directory
The traversal check that guarded saveLocalBuffer now runs in writeLocalFile
and moveLocalFile too, before any directory is created, and the buffer
save accepts only the images and uploads base paths.
* test: Define the Success Assertion Inside the Local File Saves Scenario
* fix: Give Atomic Write Temp Files a Fixed-Length Name So Long Targets Still Fit
* test: Send Image Dimensions and Read the Message Array in the Local Saves Scenarios