* 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
* 🔱 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
* feat: Add Lia's Behavior Engine
A framework-free engine that plays Lia's actions step by step, moves her along a platform, and lets her choose her own activities. An attention budget keeps her quiet while the user types and saves bigger routines for when they step away. The catalog holds feelings, speech, gestures, dances, travel, small routines and page reactions.
* fix: Let a Click Wake Lia From a Nap and Run One Animation Loop
* fix: Keep Lia Stopped When Stopped Mid-Frame and Snap Walks Under Reduced Motion
* fix: Wake Lia When Typing Interrupts a Nap and Keep Her Walks on the Current Platform
* test: Drive Lia's Engine on Real Animation Frames in a Browser
* fix: Keep One Animation Loop Across a Mid-Frame Restart and Place Lia Before Her First Move
* fix: Play Every Step of an Action the Host Chains From onAction
* test: Require Lia's Reduced-Motion Chooser to Pick Something
* fix: Keep Lia Free to Act Before the First Keystroke and Skip Pointer Walks Without a Pointer
* fix: Hold Lia's Step While She Has No Layout and Replace Actions Without a Gap
* fix: Keep the Walk of an Action Started When the Previous One Ends
* fix: Wake Lia From a Nap Played Above Reaction Priority
* fix: Pause Lia's Screen and Face Clocks Along With Her Step
* fix: Stop Lia's Own Clock While She Has No Layout and Ignore Empty Obstacles
* 🪜 feat: Light the Fold Path to the Hovered Activity Row
- Every fold that holds the hovered row lights its rail from its header down to that row; the innermost turns into the row with an elbow, so depth reads as the number of lit rails.
- One pointer listener on the outermost fold writes the path onto the rails directly (a data attribute and a length variable), coalesced to one frame: hovering repaints rails, never rows.
- Rows are found by the shared glyph slot every row line starts with, so no row component marks itself.
- The path clears over a rail (which shows its own collapse hover), on touch, on a press and when the pointer leaves.
* fix: Invalidate Fold Hover Paths and Reuse Glyph Lists
* fix: Scope Fold Paths to Agent Lanes and Register Subagent Glyphs
* fix: Re-Hit-Test Queued Fold Paths After Scroll
* fix: Clear Fold Paths After Ancestor Layout Shifts
---------
Co-authored-by: Lia <lia@librechat.ai>
- Running chats ring their avatar instead of a trailing spinner, so the row menu stays reachable mid-run.
- A reply that lands unseen lifts its chat into a Finished group under Running until it is opened; chats marked unread by hand keep their date.
- Running and Finished headings show their counts and announce them.
- Project chats now list under Chats with their folder badge; a persisted Show project chats toggle in the chat list menu restores the project-only view.
- Badges read project names from the loaded project list before fetching one by id.
- Spinner takes a strokeWidth for the thin ring.
* feat: Add Lia's Pixel Art Renderer
Lia is a small CRT monitor mascot with a face on its screen. This adds the canvas renderer: the body, feet and arm poses, body poses, 62 expressions built from eyes, mouths, brows and extras, and the built-in screens for booting, sending and crashing. Nothing renders it yet.
* test: Assert Each Built-In Lia Screen Draws Its Own Picture
* test: Include the Cached Face Image in Lia's Drawing Signatures
* fix: Clip Lia's Glitch Strips to Her Screen and End the Hide Pose Fully Hidden
* test: Check Lia's Pixel Art in a Real Browser Canvas
* test: Share the Page That Serves Lia's Engine to Browser Specs
* test: Bound-Check Where Lia's Images Land, Not Just Her Rectangles
* test: Check Lia's Face Bounds for Every Gaze Direction
* fix: Drop Lia's Sunglasses In From the Top Row of Her Screen
* test: Check Where Lia's Glitch Strips Are Copied From, Not Only Where They Land
* perf: Batch Prompt Group Permissions in the Sidebar
* perf: Skip the Prompt Permission Batch When the List Is Empty
Add scenario coverage for batched prompt row permissions.
* test: Retry Opening Prompt Row Menus Until Their Items Render
* fix: Warn When interface.webSearch Blocks Native Search in Model Specs
interface.webSearch syncs the WEB_SEARCH permission, which also gates
provider-native search since #15875. A deployment that set it to false to
hide LibreChat's search tool silently lost native search on its model
specs. Startup now names the affected specs, describes the native-only
configuration, and notes that removing the key keeps the stored permission.
Related to #16673
* fix: Warn When a Stored Role Denies Native Search With interface.webSearch Unset
* perf: Trim Per-Token and Per-Render Work in Streaming and Lists
* test: Assert Rendered Diff Rows Alongside Render Counts
* refactor: Read the Active Sidebar Row Through the Existing Index Selector
Drops the new Recoil selector: conversationIdByIndex(0) already yields a primitive id, so rows still skip re-renders on every conversation write. The DiffView row test keeps the real cn behind a spy and derives the per-row cost from the first render.
* test: Cover the Sidebar Active Row Across Chat Switches and New Chat
The Settings dialog is a Headless UI panel at z-50, not an OGDialog, so it set no dialog depth and its Select lists kept their z-40 layer, opening invisibly behind the panel. A new DialogLayer counts it as one dialog level, so popovers inside it take the depth-aware z-index they get inside an OGDialog.
* feat: Size Roles for the Select List
The Select list drew a fixed max-h-96 and min-w-[8rem], the last hard-coded sizes among the ten shared primitives. They are now the listMaxHeight and listMinWidth appearance roles, defaulting to 24rem and 8rem. The ClickHouse theme sizes the list by its trigger and keeps the 24rem cap, since Click UI caps it only at the viewport's available height.
* test: Resize the Select List From a Reference Theme