From 1a14ee1b07e8799d6f3a6994b4a3a8b126a6f6ea Mon Sep 17 00:00:00 2001 From: Aron Date: Thu, 11 Dec 2025 11:36:11 -0500 Subject: [PATCH 1/5] Add hideBaseModels to ModelSelectorContext --- .../components/Chat/Menus/Endpoints/ModelSelectorContext.tsx | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/client/src/components/Chat/Menus/Endpoints/ModelSelectorContext.tsx b/client/src/components/Chat/Menus/Endpoints/ModelSelectorContext.tsx index e79d9a2d2139..a2a9f0767ff3 100644 --- a/client/src/components/Chat/Menus/Endpoints/ModelSelectorContext.tsx +++ b/client/src/components/Chat/Menus/Endpoints/ModelSelectorContext.tsx @@ -27,6 +27,7 @@ type ModelSelectorContextType = { agentsMap: t.TAgentsMap | undefined; assistantsMap: t.TAssistantsMap | undefined; endpointsConfig: t.TEndpointsConfig; + hideBaseModels: boolean; // Functions endpointRequiresUserKey: (endpoint: string) => boolean; @@ -201,6 +202,8 @@ export function ModelSelectorProvider({ children, startupConfig }: ModelSelector }); }; + const hideBaseModels = startupConfig?.modelSpecs?.hideBaseModels ?? false; + const value = { // State searchValue, @@ -213,6 +216,7 @@ export function ModelSelectorProvider({ children, startupConfig }: ModelSelector assistantsMap, mappedEndpoints, endpointsConfig, + hideBaseModels, // Functions handleSelectSpec, From bb336f5b5d289aeb833235a66c546977e72765a6 Mon Sep 17 00:00:00 2001 From: Aron Date: Thu, 11 Dec 2025 11:36:55 -0500 Subject: [PATCH 2/5] Implement hideBaseModels for endpoint model rendering Added hideBaseModels prop to conditionally render endpoint models based on specs. --- .../Menus/Endpoints/components/EndpointItem.tsx | 16 ++++++++++++---- 1 file changed, 12 insertions(+), 4 deletions(-) diff --git a/client/src/components/Chat/Menus/Endpoints/components/EndpointItem.tsx b/client/src/components/Chat/Menus/Endpoints/components/EndpointItem.tsx index 52c3fc836718..cb580434a87c 100644 --- a/client/src/components/Chat/Menus/Endpoints/components/EndpointItem.tsx +++ b/client/src/components/Chat/Menus/Endpoints/components/EndpointItem.tsx @@ -61,6 +61,7 @@ export function EndpointItem({ endpoint }: EndpointItemProps) { assistantsMap, modelSpecs, selectedValues, + hideBaseModels, handleOpenKeyDialog, handleSelectEndpoint, endpointSearchValues, @@ -159,10 +160,17 @@ export function EndpointItem({ endpoint }: EndpointItemProps) { {endpointSpecs.map((spec: TModelSpec) => ( ))} - {/* Render endpoint models */} - {filteredModels - ? renderEndpointModels(endpoint, endpoint.models || [], selectedModel, filteredModels) - : endpoint.models && renderEndpointModels(endpoint, endpoint.models, selectedModel)} + {/* Render endpoint models (hidden when hideBaseModels is enabled and there are specs for this endpoint) */} + {!(hideBaseModels && endpointSpecs.length > 0) && + (filteredModels + ? renderEndpointModels( + endpoint, + endpoint.models || [], + selectedModel, + filteredModels, + ) + : endpoint.models && + renderEndpointModels(endpoint, endpoint.models, selectedModel))} )} From b4527b1ef249fe1596783997c3d79a21ab4eb98a Mon Sep 17 00:00:00 2001 From: Aron Date: Thu, 11 Dec 2025 11:37:25 -0500 Subject: [PATCH 3/5] Add hideBaseModels to specsConfigSchema --- packages/data-provider/src/models.ts | 1 + 1 file changed, 1 insertion(+) diff --git a/packages/data-provider/src/models.ts b/packages/data-provider/src/models.ts index 1edca6ea3723..038643a501c3 100644 --- a/packages/data-provider/src/models.ts +++ b/packages/data-provider/src/models.ts @@ -53,6 +53,7 @@ export const tModelSpecSchema = z.object({ export const specsConfigSchema = z.object({ enforce: z.boolean().default(false), prioritize: z.boolean().default(true), + hideBaseModels: z.boolean().default(false), list: z.array(tModelSpecSchema).min(1), addedEndpoints: z.array(z.union([z.string(), eModelEndpointSchema])).optional(), }); From 221cbb3640a8987046cb29646b051102a28f1a94 Mon Sep 17 00:00:00 2001 From: Aron Date: Thu, 11 Dec 2025 11:53:42 -0500 Subject: [PATCH 4/5] Add tests for specsConfigSchema hideBaseModels option --- packages/data-provider/specs/models.spec.ts | 62 +++++++++++++++++++++ 1 file changed, 62 insertions(+) create mode 100644 packages/data-provider/specs/models.spec.ts diff --git a/packages/data-provider/specs/models.spec.ts b/packages/data-provider/specs/models.spec.ts new file mode 100644 index 000000000000..c4473de5ac8c --- /dev/null +++ b/packages/data-provider/specs/models.spec.ts @@ -0,0 +1,62 @@ +import { specsConfigSchema } from '../src/models'; +import { EModelEndpoint } from '../src/schemas'; + +describe('specsConfigSchema', () => { + const validModelSpec = { + name: 'test-model', + label: 'Test Model', + preset: { + endpoint: EModelEndpoint.openAI, + }, + }; + + describe('hideBaseModels option', () => { + it('should default hideBaseModels to false when not provided', () => { + const config = { + list: [validModelSpec], + }; + + const result = specsConfigSchema.safeParse(config); + expect(result.success).toBe(true); + if (result.success) { + expect(result.data.hideBaseModels).toBe(false); + } + }); + + it('should accept hideBaseModels: true', () => { + const config = { + hideBaseModels: true, + list: [validModelSpec], + }; + + const result = specsConfigSchema.safeParse(config); + expect(result.success).toBe(true); + if (result.success) { + expect(result.data.hideBaseModels).toBe(true); + } + }); + + it('should accept hideBaseModels: false', () => { + const config = { + hideBaseModels: false, + list: [validModelSpec], + }; + + const result = specsConfigSchema.safeParse(config); + expect(result.success).toBe(true); + if (result.success) { + expect(result.data.hideBaseModels).toBe(false); + } + }); + + it('should reject hideBaseModels with non-boolean value', () => { + const config = { + hideBaseModels: 'yes', + list: [validModelSpec], + }; + + const result = specsConfigSchema.safeParse(config); + expect(result.success).toBe(false); + }); + }); +}); From d9b0c0a428947704c97a3a1110904bcfd95c25d5 Mon Sep 17 00:00:00 2001 From: Aron Date: Thu, 11 Dec 2025 11:58:44 -0500 Subject: [PATCH 5/5] Document modelSpecs options in librechat.example.yaml Add comments for modelSpecs configuration options --- librechat.example.yaml | 3 +++ 1 file changed, 3 insertions(+) diff --git a/librechat.example.yaml b/librechat.example.yaml index f163f8d4accd..088f39fd6a79 100644 --- a/librechat.example.yaml +++ b/librechat.example.yaml @@ -340,6 +340,9 @@ endpoints: # - If 'group' is a custom name (doesn't match any endpoint), it creates a separate collapsible section # - If 'group' is omitted, the spec appears as a standalone item at the top level # modelSpecs: +# enforce: false # If true, only model specs can be used, not base models +# prioritize: true # If true, model specs are shown before base models +# hideBaseModels: false # If true, hides base models when specs exist for an endpoint # list: # # Example 1: Nested under an endpoint (grouped with openAI endpoint) # - name: "gpt-4o"