✨ v0.8.5-rc1 (#556)

* docs: configuration changes

* docs: update reasoning effort, summary, and verbosity sections in model_specs.mdx

- Clarified accepted values for reasoning effort, reasoning summary, and verbosity, including new default values.
- Updated examples and descriptions to enhance understanding of configuration options.

* feat: add changelog for v0.8.5-rc1 release

- Introduced new features including a redesigned Tool Call UI, DB-backed configuration overrides, and various API endpoints for admin roles and groups.
- Implemented fixes for user context forwarding, MeiliSearch startup issues, and improved message handling.
- Enhanced overall functionality with new middleware and server architecture improvements.

* chore: update changelog

Author: danny-avila

content/changelog/config_v1.3.8.mdx

@@ -0,0 +1,48 @@
+---
+date: 2026-04-08
+title: ⚙️ Config v1.3.8
+version: "1.3.8"
+---
+
+- Added top-level [`summarization`](/docs/configuration/librechat_yaml/object_structure/summarization) configuration
+  - New centralized summarization replaces the per-endpoint `summarize` and `summaryModel` fields
+  - Configure summarization triggers, context pruning, and model settings globally
+  - Supports `SummaryContentPart` for inline conversation summaries
+
+- Added [`maxToolResultChars`](/docs/configuration/librechat_yaml/object_structure/shared_endpoint_settings#maxtoolresultchars) to shared endpoint settings
+  - Limits the maximum character count of tool call results sent to the model
+  - Available on all endpoints including via the `all` key
+
+- Removed `endpointsMenu` and `sidePanel` from [`interface`](/docs/configuration/librechat_yaml/object_structure/interface) configuration
+  - These fields are no longer configurable via `librechat.yaml` due to recent UI improvements
+
+- Removed no-op fields
+  - `summarize`, `summaryModel`, and `customOrder` removed from [custom endpoint](/docs/configuration/librechat_yaml/object_structure/custom_endpoint) configuration
+  - `plugins`, `summarize`, `summaryModel`, and `customOrder` removed from [Azure OpenAI](/docs/configuration/librechat_yaml/object_structure/azure_openai) configuration
+  - Use the new top-level `summarization` configuration instead
+
+- Tightened type validation across configuration schemas
+  - `titleMessageRole` on custom endpoints now restricted to `"system"`, `"user"`, or `"assistant"`
+  - `headers` values on custom and assistants endpoints now must be strings
+  - `additionalHeaders` values on Azure OpenAI groups now must be strings
+  - `addParams` uses recursive validation with `web_search` boolean support
+  - `paramDefinitions` now uses a fully typed schema
+  - `engineSTT` restricted to `"openai"` or `"azureOpenAI"`
+  - `engineTTS` restricted to `"openai"`, `"azureOpenAI"`, `"elevenlabs"`, or `"localai"`
+  - `playbackRate` now validated with range 0.25–4.0
+  - `scraperTimeout` and `firecrawlOptions.timeout` now require non-negative integers
+  - `memory.model_parameters` values restricted to `string`, `number`, or `boolean`
+
+- Tightened MCP server configuration validation
+  - `timeout` and `initTimeout` now require non-negative integers
+  - `sseReadTimeout` now requires a positive integer
+  - `stderr` now validated as `"pipe"`, `"ignore"`, `"inherit"`, or a non-negative integer file descriptor
+  - Connection `type` fields now have explicit defaults (`"stdio"`, `"sse"`, `"websocket"`)
+
+- `endpoints.all` no longer accepts `baseURL`
+  - The `all` key now uses a narrowed schema that omits `baseURL`
+
+- `endpoints.agents` no longer accepts `baseURL`
+
+- Updated `fileStrategy` and `fileStrategies` to use a narrowed storage-only enum
+  - Valid values: `"local"`, `"firebase"`, `"s3"`, `"azure_blob"`

content/changelog/v0.8.5-rc1.mdx

@@ -0,0 +1,115 @@
+---
+date: 2026-04-09
+title: 🚀 LibreChat v0.8.5-rc1
+description: The v0.8.5-rc1 release of LibreChat
+version: "0.8.5-rc1"
+---
+
+## What's Changed
+
+### ✨ Features
+
+* 🧩 Redesign Tool Call UI with Contextual Icons, Smart Grouping, and Rich Output Rendering by [@berry-13](https://github.com/berry-13) in [#12163](https://github.com/danny-avila/LibreChat/pull/12163)
+* 🎛️ DB-Backed Per-Principal Configuration Override System by [@danny-avila](https://github.com/danny-avila) in [#12354](https://github.com/danny-avila/LibreChat/pull/12354)
+* 🧵 ALS Context Middleware and Config Cache Invalidation by [@danny-avila](https://github.com/danny-avila) in [#12407](https://github.com/danny-avila/LibreChat/pull/12407)
+* 👥 Admin Groups API Endpoints by [@dustinhealy](https://github.com/dustinhealy) in [#12387](https://github.com/danny-avila/LibreChat/pull/12387)
+* 🪪 Admin Roles API Endpoints by [@dustinhealy](https://github.com/dustinhealy) in [#12400](https://github.com/danny-avila/LibreChat/pull/12400)
+* 🏢 Scoped App Config in Auth Login Flows by [@danny-avila](https://github.com/danny-avila) in [#12434](https://github.com/danny-avila/LibreChat/pull/12434)
+* 🏗️ 3-Tier MCP Server Architecture with Config-Source Lazy Init by [@danny-avila](https://github.com/danny-avila) in [#12435](https://github.com/danny-avila/LibreChat/pull/12435)
+* 🏗️ bulkWrite Isolation, Pre-Auth Context, Strict-Mode Fixes by [@danny-avila](https://github.com/danny-avila) in [#12445](https://github.com/danny-avila/LibreChat/pull/12445)
+* ⛩️ Admin Grants API Endpoints by [@dustinhealy](https://github.com/dustinhealy) in [#12438](https://github.com/danny-avila/LibreChat/pull/12438)
+* 📄 Model-Aware Bedrock Document Size Validation by [@danny-avila](https://github.com/danny-avila) in [#12467](https://github.com/danny-avila/LibreChat/pull/12467)
+* 🔐 Admin Auth Support for SAML and Social OAuth Providers by [@danny-avila](https://github.com/danny-avila) in [#12472](https://github.com/danny-avila/LibreChat/pull/12472)
+* 👨‍👨‍👦‍👦 Admin Users API Endpoints by [@dustinhealy](https://github.com/dustinhealy) in [#12446](https://github.com/danny-avila/LibreChat/pull/12446)
+* 📌 Add Pin Support for Model Specs by [@berry-13](https://github.com/berry-13) in [#11219](https://github.com/danny-avila/LibreChat/pull/11219)
+
+### 🐛 Fixes
+
+* 🔑 Type-Safe User Context Forwarding for Non-OAuth Tool Discovery by [@crossagent](https://github.com/crossagent) in [#12348](https://github.com/danny-avila/LibreChat/pull/12348)
+* 🐛 Resolve MeiliSearch Startup Sync Failure from Model Loading Order by [@adityaarunsinghal](https://github.com/adityaarunsinghal) in [#12397](https://github.com/danny-avila/LibreChat/pull/12397)
+* 🗝️ Resolve User-Provided API Key in Agents API Flow by [@ESJavadex](https://github.com/ESJavadex) in [#12390](https://github.com/danny-avila/LibreChat/pull/12390)
+* 📸 Snapshot Options to Prevent Mid-Await Client Disposal Crash by [@danny-avila](https://github.com/danny-avila) in [#12398](https://github.com/danny-avila/LibreChat/pull/12398)
+* 🏁 Invalidate Message Cache on Stream 404 Instead of Showing Error by [@danny-avila](https://github.com/danny-avila) in [#12411](https://github.com/danny-avila/LibreChat/pull/12411)
+* 🔑 Robust MCP OAuth Detection in Tool-Call Flow by [@danny-avila](https://github.com/danny-avila) in [#12418](https://github.com/danny-avila/LibreChat/pull/12418)
+* 🪝 Safe Hook Fallbacks for Tool-Call Components in Search Route by [@danny-avila](https://github.com/danny-avila) in [#12423](https://github.com/danny-avila/LibreChat/pull/12423)
+* 🛡️ Add Origin Binding to Admin OAuth Exchange Codes by [@danny-avila](https://github.com/danny-avila) in [#12469](https://github.com/danny-avila/LibreChat/pull/12469)
+* 💰 Lazy-Initialize Balance Record at Check Time for Admin Panel Overrides by [@danny-avila](https://github.com/danny-avila) in [#12474](https://github.com/danny-avila/LibreChat/pull/12474)
+* 🖼️ Message Icon Flickering from Context-Triggered Re-renders by [@danny-avila](https://github.com/danny-avila) in [#12489](https://github.com/danny-avila/LibreChat/pull/12489)
+* 🛡️ Restrict System Grants to Role Principals by [@dustinhealy](https://github.com/dustinhealy) in [#12491](https://github.com/danny-avila/LibreChat/pull/12491)
+* 🗂️ Allow Empty-Overrides Scope Creation in Admin Config by [@danny-avila](https://github.com/danny-avila) in [#12492](https://github.com/danny-avila/LibreChat/pull/12492)
+* 🔏 Strip Unnecessary Fields Across Write Paths in Conversation & Message Methods by [@danny-avila](https://github.com/danny-avila) in [#12498](https://github.com/danny-avila/LibreChat/pull/12498)
+* 🔒 Exclude Unnecessary Fields from Conversation `$unset` by [@danny-avila](https://github.com/danny-avila) in [#12501](https://github.com/danny-avila/LibreChat/pull/12501)
+* 🔑 Auth-Aware Startup Config Caching for Fresh Sessions by [@danny-avila](https://github.com/danny-avila) in [#12505](https://github.com/danny-avila/LibreChat/pull/12505)
+* 🔁 Pass recursionLimit to OpenAI-Compatible Agents API Endpoint by [@danny-avila](https://github.com/danny-avila) in [#12510](https://github.com/danny-avila/LibreChat/pull/12510)
+* 🏖️ Sandpack ExternalResources for Static HTML Artifact Previews by [@danny-avila](https://github.com/danny-avila) in [#12509](https://github.com/danny-avila/LibreChat/pull/12509)
+* 🎯 MCP Tool Misclassification from Action Delimiter Collision by [@danny-avila](https://github.com/danny-avila) in [#12512](https://github.com/danny-avila/LibreChat/pull/12512)
+* 📎 Route Unrecognized File Types via supportedMimeTypes Config by [@danny-avila](https://github.com/danny-avila) in [#12508](https://github.com/danny-avila/LibreChat/pull/12508)
+* 🪆 Allow Nested `addParams` in Config Schema by [@danny-avila](https://github.com/danny-avila) in [#12526](https://github.com/danny-avila/LibreChat/pull/12526)
+* 🔐 Strip `code_challenge` from Admin OAuth Requests Before Passport by [@danny-avila](https://github.com/danny-avila) in [#12534](https://github.com/danny-avila/LibreChat/pull/12534)
+* 🔍 Only Show Searchbar if Enabled by [@dlew](https://github.com/dlew) in [#12424](https://github.com/danny-avila/LibreChat/pull/12424)
+* 🔨 Custom Role Permissions by [@dustinhealy](https://github.com/dustinhealy) in [#12528](https://github.com/danny-avila/LibreChat/pull/12528)
+* 📝 Properly Restore Draft Text When Switching Conversations by [@dlew](https://github.com/dlew) in [#12384](https://github.com/danny-avila/LibreChat/pull/12384)
+* 🗣️ Prevent `@librechat/client` useLocalize from Overwriting Host App Language State by [@shtayeb](https://github.com/shtayeb) in [#12515](https://github.com/danny-avila/LibreChat/pull/12515)
+* 🔎 Specify Explicit Primary Key for Meilisearch Document Operations by [@danny-avila](https://github.com/danny-avila) in [#12542](https://github.com/danny-avila/LibreChat/pull/12542)
+* ♻️ Reuse Existing MCP OAuth Client Registrations to Prevent `client_id` Mismatch by [@DenisPalnitsky](https://github.com/DenisPalnitsky) in [#11925](https://github.com/danny-avila/LibreChat/pull/11925)
+* 🚫 Hide Delete Account Button When ALLOW_ACCOUNT_DELETION Is Disabled by [@danny-avila](https://github.com/danny-avila) in [#12568](https://github.com/danny-avila/LibreChat/pull/12568)
+* 🎯 Use Resolved Provider for Agent Token Lookup on Custom Endpoints by [@danny-avila](https://github.com/danny-avila) in [#12574](https://github.com/danny-avila/LibreChat/pull/12574)
+* 🔐 Add Middleware to Admin OAuth Callback Routes by [@dustinhealy](https://github.com/dustinhealy) in [#12579](https://github.com/danny-avila/LibreChat/pull/12579)
+* 🧬 Merge Custom Endpoints by Name Instead of Replacing Entire Array by [@danny-avila](https://github.com/danny-avila) in [#12586](https://github.com/danny-avila/LibreChat/pull/12586)
+* 🧮 Atomize Redis Event Sequence Counters for Multi-Replica Deployments by [@danny-avila](https://github.com/danny-avila) in [#12578](https://github.com/danny-avila/LibreChat/pull/12578)
+* 📂 Enable Hidden File Upload for GitNexus Index Artifact by [@danny-avila](https://github.com/danny-avila) in [#12597](https://github.com/danny-avila/LibreChat/pull/12597)
+* 📂 Respect `supportedMimeTypes` Config in File Picker Accept Filter by [@danny-avila](https://github.com/danny-avila) in [#12596](https://github.com/danny-avila/LibreChat/pull/12596)
+* 📩 Restore Primary Action Button Visibility in Light Mode by [@UnicronBE](https://github.com/UnicronBE) in [#12591](https://github.com/danny-avila/LibreChat/pull/12591)
+
+### 🔧 Refactoring
+
+* 🎨 Redesign Sidebar with Unified Icon Strip Layout by [@berry-13](https://github.com/berry-13) in [#12013](https://github.com/danny-avila/LibreChat/pull/12013)
+* 🔄 Migrate to `react-resizable-panels` v4 with Artifacts Header Polish by [@danny-avila](https://github.com/danny-avila) in [#12356](https://github.com/danny-avila/LibreChat/pull/12356)
+* 📁 Prompts UI by [@berry-13](https://github.com/berry-13) in [#11570](https://github.com/danny-avila/LibreChat/pull/11570)
+* 📐 Resolve Stale Active Sidebar Panel and Favorites Row Height by [@danny-avila](https://github.com/danny-avila) in [#12366](https://github.com/danny-avila/LibreChat/pull/12366)
+* ⚡ Fast-Fail MCP Tool Discovery on 401 for Non-OAuth Servers by [@danny-avila](https://github.com/danny-avila) in [#12395](https://github.com/danny-avila/LibreChat/pull/12395)
+* ⚡ Use In-Memory Cache for App MCP Configs to Avoid Redis SCAN by [@danny-avila](https://github.com/danny-avila) in [#12410](https://github.com/danny-avila/LibreChat/pull/12410)
+* 🌊 Local Snapshot for Aggregate Key Cache to Avoid Redundant Redis GETs by [@danny-avila](https://github.com/danny-avila) in [#12422](https://github.com/danny-avila/LibreChat/pull/12422)
+* 🪢 Eliminate Unnecessary Re-renders During Message Streaming by [@danny-avila](https://github.com/danny-avila) in [#12454](https://github.com/danny-avila/LibreChat/pull/12454)
+* 🧹 Tighten Config Schema Typing and Remove Deprecated Fields by [@danny-avila](https://github.com/danny-avila) in [#12452](https://github.com/danny-avila/LibreChat/pull/12452)
+* 🏗️ Remove Redundant Caching, Migrate Config Services to TypeScript by [@danny-avila](https://github.com/danny-avila) in [#12466](https://github.com/danny-avila/LibreChat/pull/12466)
+* 🚫 Remove Interface Config from Override Processing by [@danny-avila](https://github.com/danny-avila) in [#12473](https://github.com/danny-avila/LibreChat/pull/12473)
+* ⚖️ Split Config Route into Unauthenticated and Authenticated Paths by [@danny-avila](https://github.com/danny-avila) in [#12490](https://github.com/danny-avila/LibreChat/pull/12490)
+* 🗜️ Eliminate Unstable React Keys During SSE Lifecycle by [@danny-avila](https://github.com/danny-avila) in [#12536](https://github.com/danny-avila/LibreChat/pull/12536)
+* ⚡ Short-Circuit Config Override Resolution by [@danny-avila](https://github.com/danny-avila) in [#12553](https://github.com/danny-avila/LibreChat/pull/12553)
+* 🧑‍🎨 Prompts/Sidebar Styles for Improved UI Consistency by [@berry-13](https://github.com/berry-13) in [#12426](https://github.com/danny-avila/LibreChat/pull/12426)
+* ⏱️ User Job Tracking TTL and Proactive Cleanup to Redis Job Store by [@danny-avila](https://github.com/danny-avila) in [#12595](https://github.com/danny-avila/LibreChat/pull/12595)
+
+### ⚙️ Other Changes
+
+* 📬 Add Forwarded Headers to Nginx SSL Proxy Template by [@christopher-b](https://github.com/christopher-b) in [#12379](https://github.com/danny-avila/LibreChat/pull/12379)
+* 📝 Add UTM Tracking Parameters to Railway Deployment Links by [@berry-13](https://github.com/berry-13) in [#12228](https://github.com/danny-avila/LibreChat/pull/12228)
+* 📝 Update Deployment Link for Railway in README and README.zh.md by [@berry-13](https://github.com/berry-13) in [#12449](https://github.com/danny-avila/LibreChat/pull/12449)
+* 🔬 Add TypeScript Type Checks to Backend Workflow and Fix All Type Errors by [@danny-avila](https://github.com/danny-avila) in [#12451](https://github.com/danny-avila/LibreChat/pull/12451)
+* 🧹 Remove Deprecated Gemini 2.0 Models & Fix Mistral-Large-3 Context Window by [@danny-avila](https://github.com/danny-avila) in [#12453](https://github.com/danny-avila/LibreChat/pull/12453)
+* 🧹 Clean Up Config Fields by [@danny-avila](https://github.com/danny-avila) in [#12537](https://github.com/danny-avila/LibreChat/pull/12537)
+* 🗒️ Update LICENSE.md Year: 2025 -> 2026 by [@neuralnotesyt-netizen](https://github.com/neuralnotesyt-netizen) in [#12554](https://github.com/danny-avila/LibreChat/pull/12554)
+* 📊 Add GitNexus CI/CD and Deployment Configuration by [@danny-avila](https://github.com/danny-avila) in [#12577](https://github.com/danny-avila/LibreChat/pull/12577)
+* 🔒 Bump MongoDB from 8.0.17 to 8.0.20 in Docker Compose Files by [@danny-avila](https://github.com/danny-avila) in [#12399](https://github.com/danny-avila/LibreChat/pull/12399)
+* 📦 Bump Dependabot Packages by [@danny-avila](https://github.com/danny-avila) in [#12487](https://github.com/danny-avila/LibreChat/pull/12487)
+* 📦 Bump `axios` to exact v1.13.6, `@librechat/agents` to v3.1.63, `@aws-sdk/client-bedrock-runtime` to v3.1013.0 by [@danny-avila](https://github.com/danny-avila) in [#12488](https://github.com/danny-avila/LibreChat/pull/12488)
+* 📦 Bump `mongodb-memory-server` to v11.0.1, `mermaid` to v11.14.0, npm audit by [@danny-avila](https://github.com/danny-avila) in [#12543](https://github.com/danny-avila/LibreChat/pull/12543)
+* 📦 npm audit by [@danny-avila](https://github.com/danny-avila) in [#12570](https://github.com/danny-avila/LibreChat/pull/12570)
+* 📦 Bump `nodemailer` to v8.0.5 by [@danny-avila](https://github.com/danny-avila) in [#12587](https://github.com/danny-avila/LibreChat/pull/12587)
+* 📦 Bump `axios`, `@librechat/agents` by [@danny-avila](https://github.com/danny-avila) in [#12598](https://github.com/danny-avila/LibreChat/pull/12598)
+
+### 🌍 Internationalization
+
+* 🌍 i18n: Update translation.json with latest translations by [@github-actions[bot]](https://github.com/apps/github-actions) in [#12458](https://github.com/danny-avila/LibreChat/pull/12458), [#12571](https://github.com/danny-avila/LibreChat/pull/12571), [#12583](https://github.com/danny-avila/LibreChat/pull/12583), [#12588](https://github.com/danny-avila/LibreChat/pull/12588)
+
+## New Contributors
+
+* [@crossagent](https://github.com/crossagent) made their first contribution in [#12348](https://github.com/danny-avila/LibreChat/pull/12348)
+* [@christopher-b](https://github.com/christopher-b) made their first contribution in [#12379](https://github.com/danny-avila/LibreChat/pull/12379)
+* [@adityaarunsinghal](https://github.com/adityaarunsinghal) made their first contribution in [#12397](https://github.com/danny-avila/LibreChat/pull/12397)
+* [@ESJavadex](https://github.com/ESJavadex) made their first contribution in [#12390](https://github.com/danny-avila/LibreChat/pull/12390)
+* [@neuralnotesyt-netizen](https://github.com/neuralnotesyt-netizen) made their first contribution in [#12554](https://github.com/danny-avila/LibreChat/pull/12554)
+* [@UnicronBE](https://github.com/UnicronBE) made their first contribution in [#12591](https://github.com/danny-avila/LibreChat/pull/12591)
+
+**Full Changelog**: https://github.com/danny-avila/LibreChat/compare/v0.8.4...v0.8.5-rc1
+

content/docs/configuration/dotenv.mdx

@@ -209,6 +209,7 @@ LibreChat has built-in central logging, see [Logging System](/docs/configuration
     ['CONSOLE_JSON_STRING_LENGTH', 'number', 'Configure the truncation size for console/stdout logs, defaults to 255', 'CONSOLE_JSON_STRING_LENGTH=1000'],
     ['LIBRECHAT_LOG_DIR', 'string', 'Custom directory for log files. Defaults to /app/logs (Docker) or api/logs (local dev).', '# LIBRECHAT_LOG_DIR=/custom/log/path'],
     ['MEM_DIAG', 'boolean', 'Enable memory diagnostics — logs heap/RSS snapshots every 60 seconds. Auto-enabled when running with --inspect.', '# MEM_DIAG=true'],
+    ['AGENT_DEBUG_LOGGING', 'boolean', 'Enables verbose debug logging in the agent controller (token counts, context pruning diagnostics).', '# AGENT_DEBUG_LOGGING=true'],
   ]}
 />
 

content/docs/configuration/librechat_yaml/object_structure/azure_openai.mdx

@@ -170,7 +170,7 @@ baseURL: "https://prod.example.com"
 **Key:**
 <OptionTable
   options={[
-    ['additionalHeaders', 'Dictionary', 'Additional headers for API requests.', 'It\'s recommended to use a custom env. variable reference for the values of field, as shown in the example. `api-key` header value is sent on every request.'],
+    ['additionalHeaders', 'Dictionary', 'Additional headers for API requests. All header values must be strings.', 'It\'s recommended to use a custom env. variable reference for the values of field, as shown in the example. `api-key` header value is sent on every request.'],
   ]}
 />