Enhanced ChatGPT Clone: Features Agents, MCP, Skills, DeepSeek, Anthropic, AWS, OpenAI, Responses API, Azure, Groq, o1, GPT-5, Mistral, OpenRouter, Vertex AI, Gemini, Artifacts, AI model switching, message search, Code Interpreter, langchain, DALL-E-3, OpenAPI Actions, Functions, Secure Multi-User Auth, Presets, open-source for self-hosting. Active
TypeScript aianthropicartifactsawsazurechatgptchatgpt-cloneclaudeclonedeepseekgeminigooglegpt-5librechatmcpo1openairesponses-apivisionwebui
🆔 feat: Built-in Build Metadata for Support Triage (#12756)
Danny Avila6d6ea08da4e0
diff --git a/.github/ISSUE_TEMPLATE/BUG-REPORT.yml b/.github/ISSUE_TEMPLATE/BUG-REPORT.ymlindex 610396959f..e7ef45f7c4 100644--- a/.github/ISSUE_TEMPLATE/BUG-REPORT.yml+++ b/.github/ISSUE_TEMPLATE/BUG-REPORT.yml@@ -26,17 +26,14 @@ body:id: version-infoattributes:label: Version Information- description: |- If using Docker, please run and provide the output of:- ```bash- docker images | grep librechat- ```-- If running from source, please run and provide the output of:- ```bash- git rev-parse HEAD- ```- placeholder: Paste the output here+ description: |+ In LibreChat, open **Settings → About** and click **Copy diagnostics**, then paste the result here.+ This captures the exact version, commit, branch, and build date so maintainers can pinpoint the build you're running.++ If the About panel is unavailable (older version / self-hosted with it disabled), please provide as much of the following as possible instead:+ - Docker: `docker images | grep librechat` (image tag) and `docker inspect <image> | grep -i "\"Commit\\|BUILD_"` if build args were set+ - Source: `git rev-parse HEAD` and `git rev-parse --abbrev-ref HEAD`+ placeholder: Paste the diagnostics block herevalidations:required: true- type: textarea@@ -93,4 +90,4 @@ body:description: By submitting this issue, you agree to follow our [Code of Conduct](https://github.com/danny-avila/LibreChat/blob/main/.github/CODE_OF_CONDUCT.md)options:- label: I agree to follow this project's Code of Conduct- required: true\ No newline at end of file+ required: truediff --git a/.github/workflows/dev-branch-images.yml b/.github/workflows/dev-branch-images.ymlindex 464f6ce55a..f0e2ba54b5 100644--- a/.github/workflows/dev-branch-images.yml+++ b/.github/workflows/dev-branch-images.yml@@ -9,6 +9,10 @@ on:- 'api/**'- 'client/**'- 'packages/**'+ - 'package.json'+ - 'package-lock.json'+ - 'Dockerfile'+ - 'Dockerfile.multi'permissions:contents: read@@ -65,6 +69,12 @@ jobs:run: |cp .env.example .env+ - name: Compute build metadata+ run: |+ echo "BUILD_COMMIT=${{ github.sha }}" >> $GITHUB_ENV+ echo "BUILD_BRANCH=${{ github.ref_name }}" >> $GITHUB_ENV+ echo "BUILD_DATE=$(date -u +'%Y-%m-%dT%H:%M:%SZ')" >> $GITHUB_ENV+# Build and push Docker images for each target- name: Build and push Docker imagesuses: docker/build-push-action@v5@@ -79,3 +89,7 @@ jobs:${{ secrets.DOCKERHUB_USERNAME }}/${{ matrix.image_name }}:latestplatforms: linux/amd64,linux/arm64target: ${{ matrix.target }}+ build-args: |+ BUILD_COMMIT=${{ env.BUILD_COMMIT }}+ BUILD_BRANCH=${{ env.BUILD_BRANCH }}+ BUILD_DATE=${{ env.BUILD_DATE }}diff --git a/.github/workflows/dev-images.yml b/.github/workflows/dev-images.ymlindex a9fbef8929..efdd202754 100644--- a/.github/workflows/dev-images.yml+++ b/.github/workflows/dev-images.yml@@ -9,6 +9,10 @@ on:- 'api/**'- 'client/**'- 'packages/**'+ - 'package.json'+ - 'package-lock.json'+ - 'Dockerfile'+ - 'Dockerfile.multi'permissions:contents: read@@ -61,6 +65,12 @@ jobs:run: |cp .env.example .env+ - name: Compute build metadata+ run: |+ echo "BUILD_COMMIT=${{ github.sha }}" >> $GITHUB_ENV+ echo "BUILD_BRANCH=${{ github.ref_name }}" >> $GITHUB_ENV+ echo "BUILD_DATE=$(date -u +'%Y-%m-%dT%H:%M:%SZ')" >> $GITHUB_ENV+# Build and push Docker images for each target- name: Build and push Docker imagesuses: docker/build-push-action@v5@@ -75,3 +85,7 @@ jobs:${{ secrets.DOCKERHUB_USERNAME }}/${{ matrix.image_name }}:latestplatforms: linux/amd64,linux/arm64target: ${{ matrix.target }}+ build-args: |+ BUILD_COMMIT=${{ env.BUILD_COMMIT }}+ BUILD_BRANCH=${{ env.BUILD_BRANCH }}+ BUILD_DATE=${{ env.BUILD_DATE }}diff --git a/.github/workflows/dev-staging-images.yml b/.github/workflows/dev-staging-images.ymlindex 7bb06e5298..6deb86205c 100644--- a/.github/workflows/dev-staging-images.yml+++ b/.github/workflows/dev-staging-images.yml@@ -53,6 +53,12 @@ jobs:run: |cp .env.example .env+ - name: Compute build metadata+ run: |+ echo "BUILD_COMMIT=${{ github.sha }}" >> $GITHUB_ENV+ echo "BUILD_BRANCH=${{ github.ref_name }}" >> $GITHUB_ENV+ echo "BUILD_DATE=$(date -u +'%Y-%m-%dT%H:%M:%SZ')" >> $GITHUB_ENV+# Build and push Docker images for each target- name: Build and push Docker imagesuses: docker/build-push-action@v5@@ -67,3 +73,7 @@ jobs:${{ secrets.DOCKERHUB_USERNAME }}/${{ matrix.image_name }}:latestplatforms: linux/amd64,linux/arm64target: ${{ matrix.target }}+ build-args: |+ BUILD_COMMIT=${{ env.BUILD_COMMIT }}+ BUILD_BRANCH=${{ env.BUILD_BRANCH }}+ BUILD_DATE=${{ env.BUILD_DATE }}diff --git a/.github/workflows/main-image-workflow.yml b/.github/workflows/main-image-workflow.ymlindex 348012de22..e5f76fe26e 100644--- a/.github/workflows/main-image-workflow.yml+++ b/.github/workflows/main-image-workflow.yml@@ -38,6 +38,12 @@ jobs:fiprintf 'LATEST_TAG=%s\n' "$LATEST_TAG" >> "$GITHUB_ENV"+ - name: Compute build metadata+ run: |+ printf 'BUILD_COMMIT=%s\n' "$(git rev-parse HEAD)" >> "$GITHUB_ENV"+ printf 'BUILD_BRANCH=main\n' >> "$GITHUB_ENV"+ printf 'BUILD_DATE=%s\n' "$(date -u +'%Y-%m-%dT%H:%M:%SZ')" >> "$GITHUB_ENV"+# Set up QEMU- name: Set up QEMUuses: docker/setup-qemu-action@v3@@ -80,3 +86,7 @@ jobs:${{ secrets.DOCKERHUB_USERNAME }}/${{ matrix.image_name }}:latestplatforms: linux/amd64,linux/arm64target: ${{ matrix.target }}+ build-args: |+ BUILD_COMMIT=${{ env.BUILD_COMMIT }}+ BUILD_BRANCH=${{ env.BUILD_BRANCH }}+ BUILD_DATE=${{ env.BUILD_DATE }}diff --git a/.github/workflows/tag-images.yml b/.github/workflows/tag-images.ymlindex 4477a89c13..a7d7ee7e9a 100644--- a/.github/workflows/tag-images.yml+++ b/.github/workflows/tag-images.yml@@ -74,6 +74,12 @@ jobs:run: |cp .env.example .env+ - name: Compute build metadata+ run: |+ echo "BUILD_COMMIT=${{ github.sha }}" >> $GITHUB_ENV+ echo "BUILD_BRANCH=${{ github.ref_name }}" >> $GITHUB_ENV+ echo "BUILD_DATE=$(date -u +'%Y-%m-%dT%H:%M:%SZ')" >> $GITHUB_ENV+- name: Resolve image tagsid: image-tagsenv:@@ -104,3 +110,7 @@ jobs:tags: ${{ steps.image-tags.outputs.tags }}platforms: linux/amd64,linux/arm64target: ${{ matrix.target }}+ build-args: |+ BUILD_COMMIT=${{ env.BUILD_COMMIT }}+ BUILD_BRANCH=${{ env.BUILD_BRANCH }}+ BUILD_DATE=${{ env.BUILD_DATE }}diff --git a/Dockerfile b/Dockerfileindex 809f167413..39efed4ca2 100644--- a/Dockerfile+++ b/Dockerfile@@ -59,6 +59,18 @@ RUN \npm prune --production; \npm cache clean --force+# Optional build metadata surfaced in Settings -> About for support triage.+# Declared here (after the heavy install/build steps) so that commit/date+# changing on every CI run does not bust the cache for dependency install+# and frontend build layers. When unset, the backend falls back to local+# git resolution (if .git is present), and finally to empty values.+ARG BUILD_COMMIT=+ARG BUILD_BRANCH=+ARG BUILD_DATE=+ENV BUILD_COMMIT=${BUILD_COMMIT}+ENV BUILD_BRANCH=${BUILD_BRANCH}+ENV BUILD_DATE=${BUILD_DATE}+# Node API setupEXPOSE 3080ENV HOST=0.0.0.0diff --git a/Dockerfile.multi b/Dockerfile.multiindex f392a51e40..30534a0182 100644--- a/Dockerfile.multi+++ b/Dockerfile.multi@@ -4,6 +4,11 @@# Set configurable max-old-space-size with defaultARG NODE_MAX_OLD_SPACE_SIZE=6144+# Optional build metadata surfaced in Settings -> About for support triage.+ARG BUILD_COMMIT=+ARG BUILD_BRANCH=+ARG BUILD_DATE=+# Base for all buildsFROM node:20-alpine AS base-minARG NPM_CI_TIMEOUT_SECONDS=1500@@ -108,6 +113,15 @@ COPY --from=data-provider-build /app/packages/data-provider/dist ./packages/dataCOPY --from=data-schemas-build /app/packages/data-schemas/dist ./packages/data-schemas/distCOPY --from=api-package-build /app/packages/api/dist ./packages/api/distCOPY --from=client-build /app/client/dist ./client/dist+# Propagate build metadata into runtime env so /api/config can expose it.+# Declared here (after the heavy install/copy steps) so that commit/date+# changing on every CI run does not bust the cache for those layers.+ARG BUILD_COMMIT+ARG BUILD_BRANCH+ARG BUILD_DATE+ENV BUILD_COMMIT=${BUILD_COMMIT}+ENV BUILD_BRANCH=${BUILD_BRANCH}+ENV BUILD_DATE=${BUILD_DATE}WORKDIR /app/apiEXPOSE 3080ENV HOST=0.0.0.0diff --git a/api/server/routes/__tests__/config.spec.js b/api/server/routes/__tests__/config.spec.jsindex 52a843116c..d7fbd04446 100644--- a/api/server/routes/__tests__/config.spec.js+++ b/api/server/routes/__tests__/config.spec.js@@ -21,9 +21,16 @@ jest.mock('@librechat/data-schemas', () => ({}));const mockGetCloudFrontConfig = jest.fn(() => null);+const mockResolveBuildInfo = jest.fn(() => ({+ commit: null,+ commitShort: null,+ branch: null,+ buildDate: null,+}));jest.mock('@librechat/api', () => ({...jest.requireActual('@librechat/api'),getCloudFrontConfig: (...args) => mockGetCloudFrontConfig(...args),+ resolveBuildInfo: (...args) => mockResolveBuildInfo(...args),}));const request = require('supertest');@@ -63,6 +70,12 @@ const mockUser = {afterEach(() => {jest.resetAllMocks();+ mockResolveBuildInfo.mockReturnValue({+ commit: null,+ commitShort: null,+ branch: null,+ buildDate: null,+ });delete process.env.APP_TITLE;delete process.env.CHECK_BALANCE;delete process.env.START_BALANCE;@@ -446,4 +459,112 @@ describe('GET /api/config', () => {expect(response.body).toHaveProperty('error');});});++ describe('buildInfo payload', () => {+ const populatedBuildInfo = {+ commit: 'abcdef1234567890abcdef1234567890abcdef12',+ commitShort: 'abcdef1',+ branch: 'dev',+ buildDate: '2026-04-20T12:00:00Z',+ };++ it('includes buildInfo in authenticated response when interface flag is not explicitly disabled', async () => {+ mockGetAppConfig.mockResolvedValue(baseAppConfig);+ mockResolveBuildInfo.mockReturnValue(populatedBuildInfo);+ const app = createApp(mockUser);++ const response = await request(app).get('/api/config');++ expect(response.body.buildInfo).toEqual(populatedBuildInfo);+ });++ it('omits buildInfo when interface.buildInfo is false', async () => {+ mockGetAppConfig.mockResolvedValue({+ ...baseAppConfig,+ interfaceConfig: { ...baseAppConfig.interfaceConfig, buildInfo: false },+ });+ mockResolveBuildInfo.mockReturnValue(populatedBuildInfo);+ const app = createApp(mockUser);++ const response = await request(app).get('/api/config');++ expect(response.body).not.toHaveProperty('buildInfo');+ });++ it('omits buildInfo when all resolver fields are null', async () => {+ mockGetAppConfig.mockResolvedValue(baseAppConfig);+ mockResolveBuildInfo.mockReturnValue({+ commit: null,+ commitShort: null,+ branch: null,+ buildDate: null,+ });+ const app = createApp(mockUser);++ const response = await request(app).get('/api/config');++ expect(response.body).not.toHaveProperty('buildInfo');+ });++ it('includes buildInfo in unauthenticated response when flag is not disabled', async () => {+ mockGetAppConfig.mockResolvedValue(baseAppConfig);+ mockResolveBuildInfo.mockReturnValue(populatedBuildInfo);+ const app = createApp(null);++ const response = await request(app).get('/api/config');++ expect(response.body.buildInfo).toEqual(populatedBuildInfo);+ });++ it('omits buildInfo in unauthenticated response when interface.buildInfo is false', async () => {+ mockGetAppConfig.mockResolvedValue({+ ...baseAppConfig,+ interfaceConfig: { ...baseAppConfig.interfaceConfig, buildInfo: false },+ });+ mockResolveBuildInfo.mockReturnValue(populatedBuildInfo);+ const app = createApp(null);++ const response = await request(app).get('/api/config');++ expect(response.body).not.toHaveProperty('buildInfo');+ });++ it('propagates interface.buildInfo=false in unauthenticated response so clients can hide About tab', async () => {+ mockGetAppConfig.mockResolvedValue({+ ...baseAppConfig,+ interfaceConfig: { ...baseAppConfig.interfaceConfig, buildInfo: false },+ });+ const app = createApp(null);++ const response = await request(app).get('/api/config');++ expect(response.body.interface).toBeDefined();+ expect(response.body.interface.buildInfo).toBe(false);+ });++ it('does not add interface.buildInfo=true to unauthenticated response (default stays implicit)', async () => {+ mockGetAppConfig.mockResolvedValue({+ ...baseAppConfig,+ interfaceConfig: { privacyPolicy: { externalUrl: 'https://x' }, buildInfo: true },+ });+ const app = createApp(null);++ const response = await request(app).get('/api/config');++ expect(response.body.interface).toBeDefined();+ expect(response.body.interface).not.toHaveProperty('buildInfo');+ });++ it('includes interface block with only buildInfo=false when nothing else is set', async () => {+ mockGetAppConfig.mockResolvedValue({+ ...baseAppConfig,+ interfaceConfig: { buildInfo: false },+ });+ const app = createApp(null);++ const response = await request(app).get('/api/config');++ expect(response.body.interface).toEqual({ buildInfo: false });+ });+ });});diff --git a/api/server/routes/config.js b/api/server/routes/config.jsindex 33d1a8a325..28bdd762f7 100644--- a/api/server/routes/config.js+++ b/api/server/routes/config.js@@ -3,6 +3,7 @@ const {isEnabled,getBalanceConfig,getCloudFrontConfig,+ resolveBuildInfo,sanitizeModelSpecs,} = require('@librechat/api');const { defaultSocialLogins } = require('librechat-data-provider');@@ -25,6 +26,13 @@ const publicSharedLinksEnabled =const sharePointFilePickerEnabled = isEnabled(process.env.ENABLE_SHAREPOINT_FILEPICKER);const openidReuseTokens = isEnabled(process.env.OPENID_REUSE_TOKENS);+/**+ * Resolve build metadata eagerly at module load so the first `/api/config`+ * request does not pay the cost of `execFileSync('git', ...)` on the hot path.+ * The resolver caches its result after the first call.+ */+resolveBuildInfo();+function isBirthday() {const today = new Date();return today.getMonth() === 1 && today.getDate() === 11;@@ -105,6 +113,22 @@ function buildSharedPayload() {return payload;}+function buildBuildInfoPayload(interfaceConfig) {+ if (interfaceConfig?.buildInfo === false) {+ return undefined;+ }+ const info = resolveBuildInfo();+ if (!info.commit && !info.branch && !info.buildDate) {+ return undefined;+ }+ return {+ commit: info.commit,+ commitShort: info.commitShort,+ branch: info.branch,+ buildDate: info.buildDate,+ };+}+function buildWebSearchConfig(appConfig) {const ws = appConfig?.webSearch;if (!ws) {@@ -159,7 +183,8 @@ router.get('/', async function (req, res) {};const interfaceConfig = baseConfig?.interfaceConfig;- if (interfaceConfig?.privacyPolicy || interfaceConfig?.termsOfService) {+ const buildInfoDisabled = interfaceConfig?.buildInfo === false;+ if (interfaceConfig?.privacyPolicy || interfaceConfig?.termsOfService || buildInfoDisabled) {payload.interface = {};if (interfaceConfig.privacyPolicy) {payload.interface.privacyPolicy = interfaceConfig.privacyPolicy;@@ -167,6 +192,14 @@ router.get('/', async function (req, res) {if (interfaceConfig.termsOfService) {payload.interface.termsOfService = interfaceConfig.termsOfService;}+ if (buildInfoDisabled) {+ payload.interface.buildInfo = false;+ }+ }++ const unauthBuildInfo = buildBuildInfoPayload(interfaceConfig);+ if (unauthBuildInfo) {+ payload.buildInfo = unauthBuildInfo;}return res.status(200).send(payload);@@ -205,6 +238,11 @@ router.get('/', async function (req, res) {payload.webSearch = webSearch;}+ const buildInfo = buildBuildInfoPayload(appConfig?.interfaceConfig);+ if (buildInfo) {+ payload.buildInfo = buildInfo;+ }+if (!payload.allowAccountDeletion) {try {const userId = req.user.id ?? req.user._id?.toString();diff --git a/client/src/components/Nav/Settings.spec.tsx b/client/src/components/Nav/Settings.spec.tsxnew file mode 100644index 0000000000..114b99ef97--- /dev/null+++ b/client/src/components/Nav/Settings.spec.tsx@@ -0,0 +1,85 @@+import React from 'react';+import { render, screen, waitFor } from '@testing-library/react';+import userEvent from '@testing-library/user-event';+import Settings from './Settings';++const mockUseGetStartupConfig = jest.fn();++jest.mock('~/data-provider', () => ({+ useGetStartupConfig: () => mockUseGetStartupConfig(),+}));++jest.mock('~/hooks', () => ({+ useLocalize: () => (key: string) => key,+}));++jest.mock('~/hooks/usePersonalizationAccess', () => ({+ __esModule: true,+ default: () => ({+ hasMemoryOptOut: false,+ hasAnyPersonalizationFeature: false,+ }),+}));++jest.mock('@librechat/client', () => ({+ GearIcon: () => <span aria-hidden="true" />,+ DataIcon: () => <span aria-hidden="true" />,+ UserIcon: () => <span aria-hidden="true" />,+ SpeechIcon: () => <span aria-hidden="true" />,+ PersonalizationIcon: () => <span aria-hidden="true" />,+ useMediaQuery: () => false,+}));++jest.mock('./SettingsTabs', () => ({+ General: () => <div data-testid="general-panel" />,+ Chat: () => <div data-testid="chat-panel" />,+ Commands: () => <div data-testid="commands-panel" />,+ Speech: () => <div data-testid="speech-panel" />,+ Personalization: () => <div data-testid="personalization-panel" />,+ Data: () => <div data-testid="data-panel" />,+ Balance: () => <div data-testid="balance-panel" />,+ Account: () => <div data-testid="account-panel" />,+ About: () => <div data-testid="about-panel" />,+}));++function renderSettings() {+ return render(<Settings open={true} onOpenChange={jest.fn()} />);+}++beforeEach(() => {+ mockUseGetStartupConfig.mockReturnValue({ data: {} });+});++describe('Settings', () => {+ it('shows the About tab while startup config is loading', () => {+ mockUseGetStartupConfig.mockReturnValue({ data: undefined });++ renderSettings();++ expect(screen.getByText('com_nav_setting_about')).toBeInTheDocument();+ });++ it('hides the About tab only when buildInfo is explicitly disabled', () => {+ mockUseGetStartupConfig.mockReturnValue({ data: { interface: { buildInfo: false } } });++ renderSettings();++ expect(screen.queryByText('com_nav_setting_about')).not.toBeInTheDocument();+ });++ it('resets the active tab when loaded config disables About', async () => {+ const user = userEvent.setup();+ const { rerender } = renderSettings();++ await user.click(screen.getByText('com_nav_setting_about'));+ expect(screen.getByTestId('about-panel')).toBeInTheDocument();++ mockUseGetStartupConfig.mockReturnValue({ data: { interface: { buildInfo: false } } });+ rerender(<Settings open={true} onOpenChange={jest.fn()} />);++ await waitFor(() => {+ expect(screen.queryByTestId('about-panel')).not.toBeInTheDocument();+ });+ expect(screen.getByTestId('general-panel')).toBeInTheDocument();+ });+});diff --git a/client/src/components/Nav/Settings.tsx b/client/src/components/Nav/Settings.tsxindex 4a2f1aacdf..f5574d5616 100644--- a/client/src/components/Nav/Settings.tsx+++ b/client/src/components/Nav/Settings.tsx@@ -1,7 +1,7 @@-import React, { useState, useRef } from 'react';+import React, { useEffect, useState, useRef } from 'react';import * as Tabs from '@radix-ui/react-tabs';import { SettingsTabValues } from 'librechat-data-provider';-import { MessageSquare, Command, DollarSign } from 'lucide-react';+import { MessageSquare, Command, DollarSign, Info } from 'lucide-react';import { Dialog, DialogPanel, DialogTitle, Transition, TransitionChild } from '@headlessui/react';import {GearIcon,@@ -21,6 +21,7 @@ import {Data,Balance,Account,+ About,} from './SettingsTabs';import usePersonalizationAccess from '~/hooks/usePersonalizationAccess';import { useLocalize, TranslationKeys } from '~/hooks';@@ -34,6 +35,13 @@ export default function Settings({ open, onOpenChange }: TDialogProps) {const [activeTab, setActiveTab] = useState(SettingsTabValues.GENERAL);const tabRefs = useRef({});const { hasAnyPersonalizationFeature, hasMemoryOptOut } = usePersonalizationAccess();+ const aboutEnabled = startupConfig?.interface?.buildInfo !== false;++ useEffect(() => {+ if (!aboutEnabled && activeTab === SettingsTabValues.ABOUT) {+ setActiveTab(SettingsTabValues.GENERAL);+ }+ }, [aboutEnabled, activeTab]);const handleKeyDown = (event: React.KeyboardEvent) => {const tabs: SettingsTabValues[] = [@@ -45,6 +53,7 @@ export default function Settings({ open, onOpenChange }: TDialogProps) {SettingsTabValues.DATA,...(startupConfig?.balance?.enabled ? [SettingsTabValues.BALANCE] : []),SettingsTabValues.ACCOUNT,+ ...(aboutEnabled ? [SettingsTabValues.ABOUT] : []),];const currentIndex = tabs.indexOf(activeTab);@@ -121,6 +130,15 @@ export default function Settings({ open, onOpenChange }: TDialogProps) {icon: <UserIcon />,label: 'com_nav_setting_account',},+ ...(aboutEnabled+ ? [+ {+ value: SettingsTabValues.ABOUT,+ icon: <Info className="icon-sm" aria-hidden="true" />,+ label: 'com_nav_setting_about' as TranslationKeys,+ },+ ]+ : ([] as { value: SettingsTabValues; icon: React.JSX.Element; label: TranslationKeys }[])),];const handleTabChange = (value: string) => {@@ -251,6 +269,11 @@ export default function Settings({ open, onOpenChange }: TDialogProps) {<Tabs.Content value={SettingsTabValues.ACCOUNT} tabIndex={-1}><Account /></Tabs.Content>+ {aboutEnabled && (+ <Tabs.Content value={SettingsTabValues.ABOUT} tabIndex={-1}>+ <About />+ </Tabs.Content>+ )}</div></Tabs.Root></div>diff --git a/client/src/components/Nav/SettingsTabs/About/About.spec.tsx b/client/src/components/Nav/SettingsTabs/About/About.spec.tsxnew file mode 100644index 0000000000..46d9158668--- /dev/null+++ b/client/src/components/Nav/SettingsTabs/About/About.spec.tsx@@ -0,0 +1,170 @@+import React from 'react';+import { act, render, screen } from '@testing-library/react';+import userEvent from '@testing-library/user-event';+import { Constants } from 'librechat-data-provider';+import type { TStartupConfig } from 'librechat-data-provider';+import About from './About';++const mockCopy = jest.fn<boolean, unknown[]>();+jest.mock('copy-to-clipboard', () => ({+ __esModule: true,+ default: (...args: unknown[]) => mockCopy(...args),+}));++const mockUseGetStartupConfig = jest.fn();+jest.mock('~/data-provider', () => ({+ useGetStartupConfig: () => mockUseGetStartupConfig(),+}));++jest.mock('~/hooks', () => ({+ useLocalize: () => (key: string) => key,+}));++const populatedBuildInfo: NonNullable<TStartupConfig['buildInfo']> = {+ commit: 'abcdef1234567890abcdef1234567890abcdef12',+ commitShort: 'abcdef1',+ branch: 'dev',+ buildDate: '2026-04-20T12:00:00Z',+};++beforeEach(() => {+ mockCopy.mockReset();+ mockCopy.mockReturnValue(true);+ mockUseGetStartupConfig.mockReturnValue({ data: { buildInfo: populatedBuildInfo } });+});++describe('About', () => {+ describe('rendering', () => {+ it('renders version, commit (short), branch, and build date when buildInfo is populated', () => {+ render(<About />);++ expect(screen.getByText(Constants.VERSION as string)).toBeInTheDocument();+ expect(screen.getByText('abcdef1')).toBeInTheDocument();+ expect(screen.getByText('dev')).toBeInTheDocument();+ expect(screen.getByText('2026-04-20 12:00:00 UTC')).toBeInTheDocument();+ });++ it('renders em-dash placeholders when buildInfo is missing', () => {+ mockUseGetStartupConfig.mockReturnValue({ data: {} });+ render(<About />);++ // version still populated from Constants.VERSION; the other three rows fall back to placeholder+ const placeholders = screen.getAllByText('—');+ expect(placeholders.length).toBeGreaterThanOrEqual(3);+ });++ it('renders em-dash placeholders when startupConfig is undefined (initial load)', () => {+ mockUseGetStartupConfig.mockReturnValue({ data: undefined });+ render(<About />);++ const placeholders = screen.getAllByText('—');+ expect(placeholders.length).toBeGreaterThanOrEqual(3);+ });++ it('shows the raw string when buildDate is not a valid ISO', () => {+ mockUseGetStartupConfig.mockReturnValue({+ data: { buildInfo: { ...populatedBuildInfo, buildDate: 'not-a-date' } },+ });+ render(<About />);+ expect(screen.getByText('not-a-date')).toBeInTheDocument();+ });+ });++ describe('copy diagnostics', () => {+ it('writes a preformatted diagnostics blob to the clipboard on click', async () => {+ const user = userEvent.setup();+ render(<About />);++ await user.click(screen.getByRole('button', { name: /com_nav_about_diagnostics_copy/i }));++ expect(mockCopy).toHaveBeenCalledTimes(1);+ const [blob, options] = mockCopy.mock.calls[0] as [string, { format: string }];+ expect(options).toEqual({ format: 'text/plain' });+ expect(blob).toContain(`LibreChat version: ${Constants.VERSION}`);+ expect(blob).toContain(`Commit: ${populatedBuildInfo.commit}`);+ expect(blob).toContain(`Branch: ${populatedBuildInfo.branch}`);+ expect(blob).toContain('Build date: 2026-04-20 12:00:00 UTC');+ expect(blob).toContain('User agent: ');+ });++ it('writes em-dash placeholders into the blob when buildInfo is missing', async () => {+ mockUseGetStartupConfig.mockReturnValue({ data: {} });+ const user = userEvent.setup();+ render(<About />);++ await user.click(screen.getByRole('button', { name: /com_nav_about_diagnostics_copy/i }));++ const [blob] = mockCopy.mock.calls[0] as [string];+ expect(blob).toContain('Commit: —');+ expect(blob).toContain('Branch: —');+ expect(blob).toContain('Build date: —');+ });++ it('does not flip to "Copied" when copy-to-clipboard reports failure', async () => {+ mockCopy.mockReturnValue(false);+ const user = userEvent.setup();+ render(<About />);++ await user.click(screen.getByRole('button', { name: /com_nav_about_diagnostics_copy/i }));++ expect(+ screen.getByRole('button', { name: /com_nav_about_diagnostics_copy/i }),+ ).toBeInTheDocument();+ expect(+ screen.queryByRole('button', { name: /com_nav_about_diagnostics_copied/i }),+ ).not.toBeInTheDocument();+ expect(screen.getByRole('status').textContent).toBe('');+ });++ it('toggles the button label to "Copied" after click and resets after the timer', async () => {+ jest.useFakeTimers();+ try {+ const user = userEvent.setup({ advanceTimers: jest.advanceTimersByTime });+ render(<About />);++ await user.click(screen.getByRole('button', { name: /com_nav_about_diagnostics_copy/i }));+ expect(+ screen.getByRole('button', { name: /com_nav_about_diagnostics_copied/i }),+ ).toBeInTheDocument();++ act(() => {+ jest.advanceTimersByTime(2000);+ });+ expect(+ screen.getByRole('button', { name: /com_nav_about_diagnostics_copy/i }),+ ).toBeInTheDocument();+ } finally {+ jest.useRealTimers();+ }+ });++ it('clears the pending reset timer on unmount (no state update on unmounted component)', async () => {+ jest.useFakeTimers();+ const clearSpy = jest.spyOn(globalThis, 'clearTimeout');+ try {+ const user = userEvent.setup({ advanceTimers: jest.advanceTimersByTime });+ const { unmount } = render(<About />);+ await user.click(screen.getByRole('button', { name: /com_nav_about_diagnostics_copy/i }));+ clearSpy.mockClear();+ unmount();+ expect(clearSpy).toHaveBeenCalled();+ } finally {+ clearSpy.mockRestore();+ jest.useRealTimers();+ }+ });+ });++ describe('status live region', () => {+ it('announces the copied state via a dedicated sr-only live region', async () => {+ const user = userEvent.setup();+ render(<About />);++ const status = screen.getByRole('status');+ expect(status.textContent).toBe('');++ await user.click(screen.getByRole('button', { name: /com_nav_about_diagnostics_copy/i }));+ expect(status.textContent).toMatch(/com_nav_about_diagnostics_copied/);+ });+ });+});diff --git a/client/src/components/Nav/SettingsTabs/About/About.tsx b/client/src/components/Nav/SettingsTabs/About/About.tsxnew file mode 100644index 0000000000..4a60e828c1--- /dev/null+++ b/client/src/components/Nav/SettingsTabs/About/About.tsx@@ -0,0 +1,138 @@+import React, { useCallback, useEffect, useMemo, useRef, useState } from 'react';+import copy from 'copy-to-clipboard';+import { Check, Copy } from 'lucide-react';+import { Constants } from 'librechat-data-provider';+import type { TStartupConfig } from 'librechat-data-provider';+import { useGetStartupConfig } from '~/data-provider';+import { useLocalize } from '~/hooks';++const UNKNOWN_PLACEHOLDER = '—';++function formatBuildDate(raw: string | null | undefined): string {+ if (!raw) {+ return UNKNOWN_PLACEHOLDER;+ }+ const date = new Date(raw);+ if (Number.isNaN(date.getTime())) {+ return raw;+ }+ return date+ .toISOString()+ .replace('T', ' ')+ .replace(/\.\d{3}Z$/, ' UTC');+}++function buildDiagnosticsBlob(+ version: string,+ buildInfo: TStartupConfig['buildInfo'] | undefined,+): string {+ const lines: string[] = [+ `LibreChat version: ${version}`,+ `Commit: ${buildInfo?.commit ?? UNKNOWN_PLACEHOLDER}`,+ `Branch: ${buildInfo?.branch ?? UNKNOWN_PLACEHOLDER}`,+ `Build date: ${formatBuildDate(buildInfo?.buildDate)}`,+ `User agent: ${typeof navigator !== 'undefined' ? navigator.userAgent : UNKNOWN_PLACEHOLDER}`,+ ];+ return lines.join('\n');+}++function Row({ label, value }: { label: string; value: string }) {+ return (+ <div className="flex items-start justify-between gap-4 py-1.5">+ <div className="text-text-secondary">{label}</div>+ <div className="break-all text-right font-mono text-xs text-text-primary">{value}</div>+ </div>+ );+}++function About() {+ const localize = useLocalize();+ const { data: startupConfig } = useGetStartupConfig();+ const [copied, setCopied] = useState(false);+ const copyResetTimerRef = useRef<ReturnType<typeof setTimeout> | null>(null);++ const buildInfo = startupConfig?.buildInfo;+ const version: string = Constants.VERSION;++ const diagnosticsBlob = useMemo(+ () => buildDiagnosticsBlob(version, buildInfo),+ [version, buildInfo],+ );++ useEffect(+ () => () => {+ if (copyResetTimerRef.current) {+ clearTimeout(copyResetTimerRef.current);+ }+ },+ [],+ );++ const onCopy = useCallback(() => {+ const succeeded = copy(diagnosticsBlob, { format: 'text/plain' });+ if (!succeeded) {+ return;+ }+ setCopied(true);+ if (copyResetTimerRef.current) {+ clearTimeout(copyResetTimerRef.current);+ }+ copyResetTimerRef.current = setTimeout(() => setCopied(false), 2000);+ }, [diagnosticsBlob]);++ return (+ <div className="flex flex-col gap-3 p-1 text-sm text-text-primary">+ <section aria-labelledby="about-version-heading" className="flex flex-col">+ <h3 id="about-version-heading" className="mb-2 text-sm font-medium text-text-primary">+ {localize('com_nav_about_version_heading')}+ </h3>+ <div className="rounded-lg border border-border-light bg-surface-secondary p-3">+ <Row label={localize('com_nav_about_version')} value={version} />+ <Row+ label={localize('com_nav_about_commit')}+ value={buildInfo?.commitShort ?? UNKNOWN_PLACEHOLDER}+ />+ <Row+ label={localize('com_nav_about_branch')}+ value={buildInfo?.branch ?? UNKNOWN_PLACEHOLDER}+ />+ <Row+ label={localize('com_nav_about_build_date')}+ value={formatBuildDate(buildInfo?.buildDate)}+ />+ </div>+ </section>++ <section aria-labelledby="about-diagnostics-heading" className="flex flex-col">+ <h3 id="about-diagnostics-heading" className="mb-2 text-sm font-medium text-text-primary">+ {localize('com_nav_about_diagnostics_heading')}+ </h3>+ <p className="mb-2 text-xs text-text-secondary">+ {localize('com_nav_about_diagnostics_description')}+ </p>+ <button+ type="button"+ onClick={onCopy}+ className="inline-flex items-center justify-center gap-2 self-start rounded-md border border-border-light bg-surface-secondary px-3 py-1.5 text-xs font-medium text-text-primary transition-colors hover:bg-surface-tertiary focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-border-xheavy"+ >+ {copied ? (+ <>+ <Check className="h-4 w-4" aria-hidden="true" />+ {localize('com_nav_about_diagnostics_copied')}+ </>+ ) : (+ <>+ <Copy className="h-4 w-4" aria-hidden="true" />+ {localize('com_nav_about_diagnostics_copy')}+ </>+ )}+ </button>+ <span className="sr-only" role="status" aria-live="polite" aria-atomic="true">+ {copied ? localize('com_nav_about_diagnostics_copied') : ''}+ </span>+ </section>+ </div>+ );+}++export default React.memo(About);diff --git a/client/src/components/Nav/SettingsTabs/index.ts b/client/src/components/Nav/SettingsTabs/index.tsindex 911cbaa98a..7287a330ae 100644--- a/client/src/components/Nav/SettingsTabs/index.ts+++ b/client/src/components/Nav/SettingsTabs/index.ts@@ -6,3 +6,4 @@ export { default as General } from './General/General';export { default as Account } from './Account/Account';export { default as Commands } from './Commands/Commands';export { default as Personalization } from './Personalization';+export { default as About } from './About/About';diff --git a/client/src/locales/en/translation.json b/client/src/locales/en/translation.jsonindex 04c3144e40..0e6dfa39f7 100644--- a/client/src/locales/en/translation.json+++ b/client/src/locales/en/translation.json@@ -577,6 +577,16 @@"com_nav_scroll_button": "Scroll to the end button","com_nav_search_placeholder": "Search messages","com_nav_send_message": "Send message",+ "com_nav_about_branch": "Branch",+ "com_nav_about_build_date": "Built",+ "com_nav_about_commit": "Commit",+ "com_nav_about_diagnostics_copied": "Copied to clipboard",+ "com_nav_about_diagnostics_copy": "Copy diagnostics",+ "com_nav_about_diagnostics_description": "Copy this block when opening a support issue so maintainers can identify the exact build you're running.",+ "com_nav_about_diagnostics_heading": "Diagnostics",+ "com_nav_about_version": "Version",+ "com_nav_about_version_heading": "Build information",+ "com_nav_setting_about": "About","com_nav_setting_account": "Account","com_nav_setting_balance": "Balance","com_nav_setting_chat": "Chat",diff --git a/packages/api/src/app/build.spec.ts b/packages/api/src/app/build.spec.tsnew file mode 100644index 0000000000..629710e4da--- /dev/null+++ b/packages/api/src/app/build.spec.ts@@ -0,0 +1,64 @@+import { resolveBuildInfo, __resetBuildInfoCacheForTests } from './build';++describe('resolveBuildInfo', () => {+ const originalEnv = { ...process.env };++ beforeEach(() => {+ __resetBuildInfoCacheForTests();+ delete process.env.BUILD_COMMIT;+ delete process.env.BUILD_BRANCH;+ delete process.env.BUILD_DATE;+ });++ afterAll(() => {+ process.env = originalEnv;+ });++ it('prefers BUILD_* env vars over git', () => {+ process.env.BUILD_COMMIT = 'abcdef1234567890abcdef1234567890abcdef12';+ process.env.BUILD_BRANCH = 'release/v1.0';+ process.env.BUILD_DATE = '2026-04-20T12:00:00Z';++ const info = resolveBuildInfo();++ expect(info.commit).toBe('abcdef1234567890abcdef1234567890abcdef12');+ expect(info.commitShort).toBe('abcdef1');+ expect(info.branch).toBe('release/v1.0');+ expect(info.buildDate).toBe('2026-04-20T12:00:00Z');+ });++ it('returns null for any field that cannot be resolved', () => {+ __resetBuildInfoCacheForTests();+ const info = resolveBuildInfo();+ // commit/branch may or may not resolve depending on whether the test env has git —+ // but buildDate has no fallback, so it must be null here.+ expect(info.buildDate).toBeNull();+ });++ it('treats empty/whitespace env vars as unset', () => {+ process.env.BUILD_COMMIT = ' ';+ process.env.BUILD_BRANCH = '';+ process.env.BUILD_DATE = ' ';++ const info = resolveBuildInfo();++ expect(info.buildDate).toBeNull();+ // commit/branch will fall back to git or null — can't assert exact value, just that empty env was ignored+ expect(info.commit).not.toBe(' ');+ expect(info.branch).not.toBe('');+ });++ it('normalizes detached-HEAD branch to null', () => {+ process.env.BUILD_BRANCH = 'HEAD';+ const info = resolveBuildInfo();+ expect(info.branch).toBeNull();+ });++ it('caches result across calls', () => {+ process.env.BUILD_COMMIT = 'cached1234567890cached1234567890cached12';+ const first = resolveBuildInfo();+ process.env.BUILD_COMMIT = 'different1234567890different1234567890de';+ const second = resolveBuildInfo();+ expect(second.commit).toBe(first.commit);+ });+});diff --git a/packages/api/src/app/build.ts b/packages/api/src/app/build.tsnew file mode 100644index 0000000000..d8445bff03--- /dev/null+++ b/packages/api/src/app/build.ts@@ -0,0 +1,71 @@+import { execFileSync } from 'child_process';+import { logger } from '@librechat/data-schemas';++export interface BuildInfo {+ commit: string | null;+ commitShort: string | null;+ branch: string | null;+ buildDate: string | null;+}++let cached: BuildInfo | null = null;++function safeGit(args: string[]): string | null {+ try {+ const out = execFileSync('git', args, {+ stdio: ['ignore', 'pipe', 'ignore'],+ timeout: 2000,+ encoding: 'utf8',+ });+ const trimmed = out.trim();+ return trimmed.length > 0 ? trimmed : null;+ } catch {+ return null;+ }+}++function normalize(value: string | undefined): string | null {+ if (typeof value !== 'string') {+ return null;+ }+ const trimmed = value.trim();+ return trimmed.length > 0 ? trimmed : null;+}++/**+ * Resolves the current deployment's build info from (in order): explicit env vars,+ * then local git metadata. Used by `/api/config` to expose commit/branch to clients+ * when `interface.buildInfo` is enabled.+ */+export function resolveBuildInfo(): BuildInfo {+ if (cached) {+ return cached;+ }++ const commit = normalize(process.env.BUILD_COMMIT) ?? safeGit(['rev-parse', 'HEAD']);+ const branch =+ normalize(process.env.BUILD_BRANCH) ?? safeGit(['rev-parse', '--abbrev-ref', 'HEAD']);+ const buildDate = normalize(process.env.BUILD_DATE);++ const info: BuildInfo = {+ commit,+ commitShort: commit ? commit.slice(0, 7) : null,+ branch: branch === 'HEAD' ? null : branch,+ buildDate,+ };++ cached = info;++ if (!info.commit && !info.branch && !info.buildDate) {+ logger.debug(+ '[buildInfo] no BUILD_* env vars set and git metadata unavailable; buildInfo will be empty',+ );+ }++ return info;+}++/** Test hook — resets the in-process cache. Not exported from the package barrel. */+export function __resetBuildInfoCacheForTests(): void {+ cached = null;+}diff --git a/packages/api/src/app/index.ts b/packages/api/src/app/index.tsindex a2eef88ae1..b5380612d2 100644--- a/packages/api/src/app/index.ts+++ b/packages/api/src/app/index.ts@@ -6,3 +6,5 @@ export * from './cdn';export * from './checks';export * from './resolve';export * from './shutdown';+export { resolveBuildInfo } from './build';+export type { BuildInfo } from './build';diff --git a/packages/data-provider/rollup.config.js b/packages/data-provider/rollup.config.jsindex 95cb5206d8..8eb655cc41 100644--- a/packages/data-provider/rollup.config.js+++ b/packages/data-provider/rollup.config.js@@ -1,6 +1,7 @@import typescript from 'rollup-plugin-typescript2';import resolve from '@rollup/plugin-node-resolve';import pkg from './package.json';+import rootPkg from '../../package.json';import peerDepsExternal from 'rollup-plugin-peer-deps-external';import commonjs from '@rollup/plugin-commonjs';import replace from '@rollup/plugin-replace';@@ -9,8 +10,17 @@ import terser from '@rollup/plugin-terser';const plugins = [peerDepsExternal(),resolve(),+ // NOTE: `__LIBRECHAT_VERSION__` is only ever used inside a string literal+ // (e.g. `VERSION = '__LIBRECHAT_VERSION__'` in `src/config.ts`), so substring+ // replacement produces valid JS without needing `JSON.stringify`. Do not+ // repurpose this token as a bare identifier without switching to a quoted+ // replacement value.replace({- __IS_DEV__: process.env.NODE_ENV === 'development',+ preventAssignment: true,+ values: {+ __IS_DEV__: process.env.NODE_ENV === 'development',+ __LIBRECHAT_VERSION__: rootPkg.version,+ },}),commonjs(),typescript({diff --git a/packages/data-provider/src/config.ts b/packages/data-provider/src/config.tsindex 077c72757e..fae3bcd83b 100644--- a/packages/data-provider/src/config.ts+++ b/packages/data-provider/src/config.ts@@ -960,6 +960,7 @@ export const interfaceSchema = z.optional(),fileSearch: z.boolean().optional(),fileCitations: z.boolean().optional(),+ buildInfo: z.boolean().optional(),remoteAgents: z.object({use: z.boolean().optional(),@@ -1020,6 +1021,7 @@ export const interfaceSchema = z},fileSearch: true,fileCitations: true,+ buildInfo: true,remoteAgents: {use: false,create: false,@@ -1134,6 +1136,12 @@ export type TStartupConfig = {>;mcpPlaceholder?: string;conversationImportMaxFileSize?: number;+ buildInfo?: {+ commit?: string | null;+ commitShort?: string | null;+ branch?: string | null;+ buildDate?: string | null;+ };};export enum OCRStrategy {@@ -2106,6 +2114,10 @@ export enum SettingsTabValues {* Tab for Personalization Settings*/PERSONALIZATION = 'personalization',+ /**+ * Tab for About / Build Info+ */+ ABOUT = 'about',}export enum STTProviders {@@ -2140,8 +2152,16 @@ export enum TTSProviders {/** Enum for app-wide constants */export enum Constants {- /** Key for the app's version. */- VERSION = 'v0.8.6-rc1',+ /**+ * Key for the app's version. The placeholder `__LIBRECHAT_VERSION__` is+ * swapped in by `@rollup/plugin-replace` during `npm run build:data-provider`+ * using the value of the root `package.json`'s `version` field. Consumers+ * always import this via the built dist bundle (see `main` field in+ * `packages/data-provider/package.json`), so production and UI code get the+ * substituted value. Only tests that import the TypeScript source directly+ * would observe the raw placeholder.+ */+ VERSION = '__LIBRECHAT_VERSION__',/** Key for the Custom Config's version (librechat.yaml). */CONFIG_VERSION = '1.3.11',/** Standard value for the first message's `parentMessageId` value, to indicate no parent exists. */