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
🔠 fix: Name Artifact Downloads After Their Titles (#15836)
Danny Avilaab506011e52c
diff --git a/client/src/common/artifacts.ts b/client/src/common/artifacts.tsindex a47ffb31b7..09811fda24 100644--- a/client/src/common/artifacts.ts+++ b/client/src/common/artifacts.ts@@ -14,6 +14,9 @@ export const MERMAID_ARTIFACT_TYPE = 'application/vnd.mermaid' as const;* the rendered preview `content`.*/export interface ArtifactDownload {+ /** Original attachment name; null means the attachment supplied no filename. */+ filename?: string | null;+ mimeType?: string;filepath?: string;file_id?: string;source?: string;diff --git a/client/src/components/Artifacts/DownloadArtifact.tsx b/client/src/components/Artifacts/DownloadArtifact.tsxindex ca48eebe7d..209be58dfe 100644--- a/client/src/components/Artifacts/DownloadArtifact.tsx+++ b/client/src/components/Artifacts/DownloadArtifact.tsx@@ -2,12 +2,16 @@ import React, { useState } from 'react';import { Download, CircleCheckBig } from 'lucide';import { Button, MorphIcon } from '@librechat/client';import type { Artifact } from '~/common';+import {+ getArtifactDownloadFilename,+ getOriginalArtifactFilename,+ isPreviewOnlyArtifact,+} from '~/utils/artifacts';import {useAttachmentLink,isLocallyStoredSource,} from '~/components/Chat/Messages/Content/Parts/LogLink';import useArtifactProps from '~/hooks/Artifacts/useArtifactProps';-import { isPreviewOnlyArtifact } from '~/utils/artifacts';import { useCodeState } from '~/Providers/EditorContext';import { useLocalize } from '~/hooks';@@ -17,12 +21,8 @@ const DownloadArtifact = ({ artifact }: { artifact: Artifact }) => {const [isDownloaded, setIsDownloaded] = useState(false);const { fileKey: fileName } = useArtifactProps({ artifact });- /* Office artifacts (pptx/xlsx/docx) render a server-generated HTML- * preview in `content`, not the binary file — serializing that blob- * would download the preview instead of the original. Fetch the real- * file through the same path the inline card uses. Source-code and- * text artifacts keep the blob path: their `content` IS the file (and- * reflects any in-panel edits). */+ /* Unedited file-backed artifacts download the original: cached extraction+ * can be truncated or transformed. Edited content is exported as a blob. */const { download } = artifact;/* Only take the original-file branch when `useAttachmentLink` can* actually fetch something: a usable `filepath` (http target, share@@ -37,10 +37,12 @@ const DownloadArtifact = ({ artifact }: { artifact: Artifact }) => {(download?.file_id != null &&download?.user != null &&isLocallyStoredSource(download?.source));- const downloadOriginalFile = isPreviewOnlyArtifact(artifact.type) && hasUsableRoute;+ const hasEdits = currentCode != null && currentCode !== artifact.content;+ const downloadOriginalFile =+ hasUsableRoute && (isPreviewOnlyArtifact(artifact.type) || !hasEdits);const { handleDownload: downloadAttachment } = useAttachmentLink({href: download?.filepath ?? '',- filename: artifact.title ?? fileName,+ filename: getOriginalArtifactFilename(artifact, fileName),file_id: download?.file_id,user: download?.user,source: download?.source,@@ -52,15 +54,15 @@ const DownloadArtifact = ({ artifact }: { artifact: Artifact }) => {};const downloadContent = () => {- const content = currentCode ?? artifact.content ?? '';- if (!content) {+ const content = currentCode ?? artifact.content;+ if (content == null) {return;}const blob = new Blob([content], { type: 'text/plain' });const url = window.URL.createObjectURL(blob);const link = document.createElement('a');link.href = url;- link.download = fileName;+ link.download = getArtifactDownloadFilename(artifact, fileName, content);document.body.appendChild(link);link.click();document.body.removeChild(link);diff --git a/client/src/components/Artifacts/__tests__/DownloadArtifact.test.tsx b/client/src/components/Artifacts/__tests__/DownloadArtifact.test.tsxindex 8faf88a514..6c6134a8ce 100644--- a/client/src/components/Artifacts/__tests__/DownloadArtifact.test.tsx+++ b/client/src/components/Artifacts/__tests__/DownloadArtifact.test.tsx@@ -1,10 +1,13 @@import React from 'react';import { render, screen, fireEvent, act } from '@testing-library/react';import type { Artifact } from '~/common';-import { TOOL_ARTIFACT_TYPES } from '~/utils/artifacts';+import { fileToArtifact, TOOL_ARTIFACT_TYPES } from '~/utils/artifacts';import DownloadArtifact from '../DownloadArtifact';const mockFileDownload = jest.fn();+const mockAttachmentOptions = jest.fn();+let mockFileKey = 'index.html';+let mockCurrentCode: string | undefined;jest.mock('~/hooks', () => ({useLocalize:@@ -15,11 +18,11 @@ jest.mock('~/hooks', () => ({jest.mock('~/hooks/Artifacts/useArtifactProps', () => ({__esModule: true,- default: () => ({ fileKey: 'index.html', files: {}, template: 'static', sharedProps: {} }),+ default: () => ({ fileKey: mockFileKey, files: {}, template: 'static', sharedProps: {} }),}));jest.mock('~/Providers/EditorContext', () => ({- useCodeState: () => ({ currentCode: undefined }),+ useCodeState: () => ({ currentCode: mockCurrentCode }),}));/* MorphIcon renders a single morphing <svg> with no per-icon class, so map@@ -37,7 +40,10 @@ jest.mock('@librechat/client', () => {});jest.mock('~/components/Chat/Messages/Content/Parts/LogLink', () => ({- useAttachmentLink: () => ({ handleDownload: mockFileDownload }),+ useAttachmentLink: (options: { filename: string }) => {+ mockAttachmentOptions(options);+ return { handleDownload: mockFileDownload };+ },isLocallyStoredSource: (source?: string) =>['local', 'firebase', 's3', 'cloudfront', 'azure_blob'].includes(source ?? ''),}));@@ -101,6 +107,8 @@ describe('DownloadArtifact', () => {let anchorClick: jest.SpyInstance;beforeEach(() => {+ mockFileKey = 'index.html';+ mockCurrentCode = undefined;mockFileDownload.mockReset();// The attachment helper resolves to `true` when a file was delivered.mockFileDownload.mockResolvedValue(true);@@ -123,6 +131,254 @@ describe('DownloadArtifact', () => {anchorClick.mockRestore();});+ it.each([+ ['text/markdown', 'Migration Plan', 'content.md', undefined, 'Migration Plan.md'],+ ['text/md', 'Second Report', 'content.md', undefined, 'Second Report.md'],+ ['text/markdown', 'Report.MD', 'content.md', undefined, 'Report.MD'],+ ['text/plain', 'Meeting Notes', 'content.md', undefined, 'Meeting Notes.txt'],+ ['text/plain', 'notes.odt', 'content.md', undefined, 'notes.odt.txt'],+ ['text/plain', 'report.docx', 'content.md', undefined, 'report.docx.txt'],+ ['text/plain', 'notes.TXT', 'content.md', undefined, 'notes.TXT'],+ ['text/markdown', 'Release Notes v1.0', 'content.md', undefined, 'Release Notes v1.0.md'],+ ['text/html', 'example.com', 'index.html', undefined, 'example.com.html'],+ [TOOL_ARTIFACT_TYPES.CODE, 'script.py', 'content.md', 'python', 'script.py'],+ [TOOL_ARTIFACT_TYPES.CODE, 'script.py', 'content.md', undefined, 'script.py'],+ [TOOL_ARTIFACT_TYPES.CODE, 'example.com', 'content.md', 'python', 'example.com.py'],+ [TOOL_ARTIFACT_TYPES.CODE, 'Analysis', 'content.md', 'python', 'Analysis.py'],+ [TOOL_ARTIFACT_TYPES.CODE, '', 'content.md', 'typescript', 'code.ts'],+ ['text/html', 'Landing Page', 'index.html', undefined, 'Landing Page.html'],+ ['application/vnd.react', 'Dashboard', 'App.tsx', undefined, 'Dashboard.tsx'],+ ['application/vnd.mermaid', 'Flow', 'diagram.mmd', undefined, 'Flow.mmd'],+ ['text/markdown', ' ', 'content.md', undefined, 'content.md'],+ ['text/plain', undefined, 'content.md', undefined, 'content.txt'],+ ['text/markdown', 'Plan: Q3/Q4', 'content.md', undefined, 'Plan_ Q3_Q4.md'],+ [TOOL_ARTIFACT_TYPES.PRESENTATION, 'deck.pptx', 'index.html', undefined, 'deck.pptx.html'],+ ])('names %s download with title %s', async (type, title, fileKey, language, expected) => {+ mockFileKey = fileKey;+ mockCurrentCode = 'edited content';+ render(<DownloadArtifact artifact={{ ...htmlArtifact, type, title, language }} />);+ await act(async () => {+ fireEvent.click(screen.getByRole('button'));+ });+ expect(anchorClick.mock.instances[0].download).toBe(expected);+ const blob = createObjectURL.mock.calls[0][0] as Blob;+ const content = await new Promise<string>((resolve) => {+ const reader = new FileReader();+ reader.onload = () => resolve(String(reader.result));+ reader.readAsText(blob);+ });+ expect(content).toBe('edited content');+ expect(mockFileDownload).not.toHaveBeenCalled();+ });++ it.each([undefined, 'untitled', 'Generated artifact'])(+ 'names untitled Markdown from the edited heading (%s)',+ async (title) => {+ mockFileKey = 'content.md';+ mockCurrentCode = '# New **migration** [plan](https://example.com) for `migrate_users.py`';+ render(+ <DownloadArtifact+ artifact={{ ...htmlArtifact, type: 'text/markdown', title, content: '# Old heading' }}+ />,+ );+ await act(async () => {+ fireEvent.click(screen.getByRole('button'));+ });+ expect(anchorClick.mock.instances[0].download).toBe(+ 'New migration plan for migrate_users.py.md',+ );+ },+ );++ it.each([+ ['Component.jsx', 'App.tsx'],+ ['page.htm', 'index.html'],+ ['README.markdown', 'content.md'],+ ['README.mdx', 'content.md'],+ ['diagram.mermaid', 'diagram.mmd'],+ ])('downloads file-backed raw content as %s', async (filename, fileKey) => {+ mockFileKey = fileKey;+ const artifact = fileToArtifact({ file_id: 'file', filename, text: 'Raw content' });+ expect(artifact).not.toBeNull();+ render(<DownloadArtifact artifact={artifact!} />);+ await act(async () => {+ fireEvent.click(screen.getByRole('button'));+ });+ const dot = filename.lastIndexOf('.');+ expect(anchorClick.mock.instances[0].download).toBe(+ `${filename.slice(0, dot)}.preview${filename.slice(dot)}`,+ );+ expect(mockFileDownload).not.toHaveBeenCalled();+ });++ it.each(['untitled', 'Generated artifact', 'Component.jsx', 'notes.txt'])(+ 'keeps the exact original filename when fetching %s',+ async (filename) => {+ const artifact = fileToArtifact({+ file_id: 'file',+ filename,+ type: 'text/markdown',+ text: 'Complete file\n\n…[truncated]',+ filepath: '/api/files/code/output/file',+ });+ render(<DownloadArtifact artifact={artifact!} />);+ await act(async () => {+ fireEvent.click(screen.getByRole('button'));+ });+ expect(mockFileDownload).toHaveBeenCalledTimes(1);+ expect(createObjectURL).not.toHaveBeenCalled();+ expect(mockAttachmentOptions).toHaveBeenLastCalledWith(expect.objectContaining({ filename }));+ },+ );++ it.each([+ ['text/markdown', 'content.md', 'content.md'],+ ['text/x-python', 'content.md', 'code.py'],+ ['text/html', 'index.html', 'content.html'],+ ['application/vnd.react', 'App.tsx', 'App.tsx'],+ ['application/vnd.oasis.opendocument.text', 'content.md', 'content.odt'],+ [+ 'application/vnd.openxmlformats-officedocument.wordprocessingml.document',+ 'index.html',+ 'content.docx',+ ],+ ['text/csv', 'index.html', 'content.csv'],+ ['text/comma-separated-values', 'index.html', 'content.csv'],+ ['text/comma-separated-values; charset=utf-8', 'index.html', 'content.csv'],+ ['application/x-dos_ms_excel', 'index.html', 'content.xls'],+ ])(+ 'uses an original-format fallback when %s has no filename',+ async (type, fileKey, expected) => {+ mockFileKey = fileKey;+ const artifact = fileToArtifact({+ file_id: 'file',+ type,+ text: 'Preview',+ filepath: '/api/files/code/output/file',+ });+ expect(artifact?.download?.filename).toBeNull();+ render(<DownloadArtifact artifact={artifact!} />);+ await act(async () => {+ fireEvent.click(screen.getByRole('button'));+ });+ expect(mockFileDownload).toHaveBeenCalledTimes(1);+ expect(createObjectURL).not.toHaveBeenCalled();+ expect(mockAttachmentOptions).toHaveBeenLastCalledWith(+ expect.objectContaining({ filename: expected }),+ );+ },+ );++ it('uses a fallback for an empty attachment filename', async () => {+ const artifact = fileToArtifact({+ file_id: 'file',+ filename: '',+ type: 'text/markdown',+ text: '# Heading',+ filepath: '/api/files/code/output/file',+ });+ render(<DownloadArtifact artifact={artifact!} />);+ await act(async () => {+ fireEvent.click(screen.getByRole('button'));+ });+ expect(mockFileDownload).toHaveBeenCalledTimes(1);+ expect(mockAttachmentOptions).toHaveBeenLastCalledWith(+ expect.objectContaining({ filename: 'content.md' }),+ );+ });++ it.each([undefined, 'Prefix\n\n…[truncated]'])(+ 'fetches the complete original for unedited cached content (%s)',+ async (currentCode) => {+ mockCurrentCode = currentCode;+ const artifact = fileToArtifact({+ file_id: 'file',+ filename: 'large.py',+ text: 'Prefix\n\n…[truncated]',+ filepath: '/api/files/code/output/large.py',+ });+ render(<DownloadArtifact artifact={artifact!} />);+ await act(async () => {+ fireEvent.click(screen.getByRole('button'));+ });+ expect(mockFileDownload).toHaveBeenCalledTimes(1);+ expect(createObjectURL).not.toHaveBeenCalled();+ },+ );++ it.each(['Edited prefix', ''])(+ 'exports edits to a truncated preview with a distinct name (%s)',+ async (edit) => {+ mockCurrentCode = edit;+ const artifact = fileToArtifact({+ file_id: 'file',+ filename: 'large.py',+ text: 'Prefix\n\n…[truncated]',+ filepath: '/api/files/code/output/large.py',+ });+ render(<DownloadArtifact artifact={artifact!} />);+ await act(async () => {+ fireEvent.click(screen.getByRole('button'));+ });+ expect(mockFileDownload).not.toHaveBeenCalled();+ expect(anchorClick.mock.instances[0].download).toBe('large.preview.py');+ const blob = createObjectURL.mock.calls[0][0] as Blob;+ expect(blob.size).toBe(edit.length);+ },+ );++ it('names a truncated preview distinctly when the original route is unavailable', async () => {+ const artifact = fileToArtifact({+ file_id: 'file',+ filename: 'large.txt',+ text: 'Prefix\n\n…[truncated]',+ });+ render(<DownloadArtifact artifact={artifact!} />);+ await act(async () => {+ fireEvent.click(screen.getByRole('button'));+ });+ expect(mockFileDownload).not.toHaveBeenCalled();+ expect(anchorClick.mock.instances[0].download).toBe('large.preview.txt');+ });++ it('does not silently substitute a preview after an original download fails, and can retry', async () => {+ mockFileDownload.mockResolvedValueOnce(false);+ const artifact = fileToArtifact({+ file_id: 'file',+ filename: 'large.py',+ text: 'Prefix\n\n…[truncated]',+ filepath: '/api/files/code/output/large.py',+ });+ const { container } = render(<DownloadArtifact artifact={artifact!} />);+ await act(async () => {+ fireEvent.click(screen.getByRole('button'));+ });+ expect(createObjectURL).not.toHaveBeenCalled();+ expect(container.querySelector('[data-icon="circle-check-big"]')).toBeNull();+ await act(async () => {+ fireEvent.click(screen.getByRole('button'));+ });+ expect(mockFileDownload).toHaveBeenCalledTimes(2);+ expect(container.querySelector('[data-icon="circle-check-big"]')).not.toBeNull();+ });++ it('preserves extensionless source filenames', async () => {+ render(+ <DownloadArtifact+ artifact={{+ ...htmlArtifact,+ type: TOOL_ARTIFACT_TYPES.CODE,+ title: 'Dockerfile',+ download: { file_id: 'source' },+ }}+ />,+ );+ await act(async () => {+ fireEvent.click(screen.getByRole('button'));+ });+ expect(anchorClick.mock.instances[0].download).toBe('Dockerfile.preview');+ });+it('downloads the original file (not the preview) for an office artifact and shows success', async () => {const { container } = render(<DownloadArtifact artifact={officeArtifact} />);await act(async () => {diff --git a/client/src/utils/__tests__/artifacts.test.ts b/client/src/utils/__tests__/artifacts.test.tsindex f4444a5d38..41288b4eb2 100644--- a/client/src/utils/__tests__/artifacts.test.ts+++ b/client/src/utils/__tests__/artifacts.test.ts@@ -2,6 +2,7 @@ import { FileSources } from 'librechat-data-provider';import type { ToolArtifactType } from '../artifacts';import {buildSandpackOptions,+ getArtifactDownloadFilename,detectArtifactTypeFromFile,fileToArtifact,isCodeOnlyArtifact,@@ -715,6 +716,8 @@ describe('fileToArtifact', () => {expect(artifact).not.toBeNull();expect(artifact!.type).toBe(TOOL_ARTIFACT_TYPES.PRESENTATION);expect(artifact!.download).toEqual({+ filename: 'deck.pptx',+ mimeType: 'application/vnd.openxmlformats-officedocument.presentationml.presentation',filepath: '/api/files/code/output/deck.pptx',file_id: 'fid-1',source: FileSources.execute_code,@@ -974,3 +977,149 @@ describe('isCodeOnlyArtifact', () => {},);});++describe('getArtifactDownloadFilename', () => {+ it.each([+ ['# Migration Plan', 'Migration Plan.md'],+ ['# ~~Deprecated~~ Plan', 'Deprecated Plan.md'],+ ['# migrate_users.py', 'migrate_users.py.md'],+ ['# The **Q3** [report](https://example.com)', 'The Q3 report.md'],+ ['# Hello & goodbye', 'Hello & goodbye.md'],+ ['```bash\n# comment\n```\n# Actual heading', 'Actual heading.md'],+ ['````\n```bash\n# Still code\n```\n````\n# Actual heading', 'Actual heading.md'],+ ['~~~\n```\n# Still code\n~~~\n# Actual heading', 'Actual heading.md'],+ ['---\n# Metadata comment\n---\n# Actual heading', 'Actual heading.md'],+ ['<div>\n# Hidden heading\n</div>\n\n# Actual heading', 'Actual heading.md'],+ ['A real setext heading\n===', 'A real setext heading.md'],+ ['No heading', 'content.md'],+ ])('derives a Markdown filename from %s', (content, expected) => {+ expect(+ getArtifactDownloadFilename(+ { id: 'a', lastUpdateTime: 0, type: 'text/markdown', content },+ 'content.md',+ ),+ ).toBe(expected);+ });++ it.each([+ ['Component.jsx', 'App.tsx'],+ ['Component.tsx', 'App.tsx'],+ ['index.htm', 'index.html'],+ ['index.html', 'index.html'],+ ['README.markdown', 'content.md'],+ ['README.mdx', 'content.md'],+ ['README.md', 'content.md'],+ ['flow.mermaid', 'diagram.mmd'],+ ['flow.mmd', 'diagram.mmd'],+ ['script.pyi', 'content.md'],+ ['Dockerfile', 'content.md'],+ ['Makefile', 'content.md'],+ ['notes.TXT', 'content.md'],+ ])('preserves raw file extensions in preview exports: %s', (filename, fileKey) => {+ const artifact = fileToArtifact({ file_id: 'file', filename, text: 'Raw content' });+ expect(artifact).not.toBeNull();+ const dot = filename.lastIndexOf('.');+ const expected =+ dot > 0 ? `${filename.slice(0, dot)}.preview${filename.slice(dot)}` : `${filename}.preview`;+ expect(getArtifactDownloadFilename(artifact!, fileKey)).toBe(expected);+ });++ it.each(['untitled', 'Generated artifact'])(+ 'preserves the real attachment filename %s',+ (filename) => {+ const artifact = fileToArtifact({+ file_id: 'file',+ filename,+ type: 'text/markdown',+ text: '# Heading',+ });+ expect(getArtifactDownloadFilename(artifact!, 'content.md')).toBe(`${filename}.preview`);+ },+ );++ it('uses the heading when an attachment supplied no filename', () => {+ const artifact = fileToArtifact({ file_id: 'file', type: 'text/markdown', text: '# Heading' });+ expect(getArtifactDownloadFilename(artifact!, 'content.md')).toBe('Heading.preview.md');+ });++ it('preserves sentinel filenames in older artifact metadata', () => {+ expect(+ getArtifactDownloadFilename(+ {+ id: 'a',+ lastUpdateTime: 0,+ type: 'text/markdown',+ title: 'untitled',+ content: '# Heading',+ download: { file_id: 'file' },+ },+ 'content.md',+ ),+ ).toBe('untitled.preview');+ });++ it.each(['script.py', 'notes.txt', 'README.md', 'Dockerfile'])(+ 'distinguishes cached preview exports of %s',+ (filename) => {+ const artifact = fileToArtifact({+ file_id: 'file',+ filename,+ text: 'Prefix\n\n…[truncated]',+ });+ const expected = filename.includes('.')+ ? filename.replace(/(\.[^.]+)$/, '.preview$1')+ : `${filename}.preview`;+ expect(getArtifactDownloadFilename(artifact!, 'content.md')).toBe(expected);+ expect(getArtifactDownloadFilename(artifact!, 'content.md', 'Edited prefix')).toBe(expected);+ },+ );++ it.each(['odt', 'docx', 'pptx'])('names extracted %s bytes as text after file routing', (ext) => {+ const artifact = fileToArtifact({+ file_id: 'file',+ filename: `report.${ext}`,+ text: 'Extracted text',+ });+ expect(artifact?.type).toBe(TOOL_ARTIFACT_TYPES.PLAIN_TEXT);+ expect(getArtifactDownloadFilename(artifact!, 'content.md')).toBe(`report.${ext}.preview.txt`);+ });++ it.each(['Complete file', 'Complete file\n\n…[truncated]'])(+ 'does not infer truncation from cached file text: %s',+ (content) => {+ const artifact = fileToArtifact({ file_id: 'file', filename: 'notes.txt', text: content });+ expect(getArtifactDownloadFilename(artifact!, 'content.md')).toBe('notes.preview.txt');+ },+ );++ it('does not read source comments as document headings', () => {+ expect(+ getArtifactDownloadFilename(+ {+ id: 'a',+ lastUpdateTime: 0,+ type: TOOL_ARTIFACT_TYPES.CODE,+ language: 'python',+ content: '# Copyright',+ },+ 'content.md',+ ),+ ).toBe('code.py');+ });++ it('preserves a long file-backed source extension during sanitization', () => {+ const filename = `${'a'.repeat(200)}.py`;+ expect(+ getArtifactDownloadFilename(+ {+ id: 'a',+ lastUpdateTime: 0,+ type: TOOL_ARTIFACT_TYPES.CODE,+ title: filename,+ download: { file_id: 'file' },+ },+ 'content.md',+ ),+ ).toBe(`${'a'.repeat(97)}.preview.py`);+ });+});diff --git a/client/src/utils/artifacts.ts b/client/src/utils/artifacts.tsindex 50531867bd..c3e473d56b 100644--- a/client/src/utils/artifacts.ts+++ b/client/src/utils/artifacts.ts@@ -1,12 +1,22 @@import dedent from 'dedent';-import { excelMimeTypes, shadcnComponents } from 'librechat-data-provider';+import filenamify from 'filenamify';+import { gfm } from 'micromark-extension-gfm';+import { gfmFromMarkdown } from 'mdast-util-gfm';+import { fromMarkdown } from 'mdast-util-from-markdown';+import {+ excelMimeTypes,+ shadcnComponents,+ getDocumentFileExtension,+} from 'librechat-data-provider';import type {SandpackProviderProps,SandpackPredefinedTemplate,} from '@codesandbox/sandpack-react';import type { TStartupConfig, TAttachment, TFile } from 'librechat-data-provider';+import type { PhrasingContent } from 'mdast';import type { Artifact } from '~/common';import { MERMAID_ARTIFACT_TYPE } from '~/common/artifacts';+import { getCodeBlockFilename } from './downloadFile';const artifactFilename = {'application/vnd.react': 'App.tsx',@@ -74,6 +84,101 @@ export function getArtifactFilename(type: string, language?: string): string {return artifactFilename[key] ?? artifactFilename.default;}+/** Extract visible heading text without removing literal Markdown punctuation. */+function headingText(nodes: PhrasingContent[]): string {+ return nodes+ .map((node) => {+ if ('children' in node) {+ return headingText(node.children);+ }+ if (node.type === 'text' || node.type === 'inlineCode') {+ return node.value;+ }+ if (node.type === 'image' || node.type === 'imageReference') {+ return node.alt ?? '';+ }+ return '';+ })+ .join('');+}++/** Name for bytes fetched from the original attachment, rather than its cached preview. */+export function getOriginalArtifactFilename(artifact: Artifact, fileKey: string): string {+ if (artifact.download?.filename) {+ return artifact.download.filename;+ }+ if (artifact.download?.filename === undefined) {+ return artifact.title || fileKey;+ }+ const extension = getDocumentFileExtension(artifact.download.mimeType);+ if (extension) {+ return `content${extension}`;+ }+ if (isPreviewOnlyArtifact(artifact.type) || artifact.type === TOOL_ARTIFACT_TYPES.PLAIN_TEXT) {+ return 'content.bin';+ }+ return getArtifactDownloadFilename(+ { ...artifact, title: undefined, download: undefined },+ fileKey,+ '',+ );+}++/** Names the downloaded bytes independently of the Sandpack preview file. */+export function getArtifactDownloadFilename(+ artifact: Artifact,+ fileKey: string,+ content = artifact.content,+): string {+ const isCode = artifact.type === TOOL_ARTIFACT_TYPES.CODE;+ const isMarkdown = artifact.type === TOOL_ARTIFACT_TYPES.MARKDOWN || artifact.type === 'text/md';+ let fallback = fileKey;+ if (isCode) {+ fallback = getCodeBlockFilename(+ artifact.language || lookupOwn(CODE_EXTENSION_TO_LANGUAGE, extensionOf(artifact.title)),+ );+ } else if (artifact.type === TOOL_ARTIFACT_TYPES.PLAIN_TEXT) {+ fallback = 'content.txt';+ }+ let title = (artifact.download?.filename ?? artifact.title)?.trim() ?? '';+ const hasOriginalName = artifact.download != null && artifact.download.filename !== null;+ if (!hasOriginalName && (title === 'Generated artifact' || title === 'untitled')) {+ title = '';+ }+ const hasSourceFilename =+ hasOriginalName &&+ title !== '' &&+ artifact.type !== TOOL_ARTIFACT_TYPES.PLAIN_TEXT &&+ !isPreviewOnlyArtifact(artifact.type);+ if (!title && isMarkdown) {+ const markdown = (content ?? '').replace(+ /^\uFEFF?---[^\S\r\n]*\r?\n[\s\S]*?\r?\n(?:---|\.\.\.)[^\S\r\n]*(?:\r?\n|$)/,+ '',+ );+ const heading = fromMarkdown(markdown, {+ extensions: [gfm()],+ mdastExtensions: [gfmFromMarkdown()],+ }).children.find((node) => node.type === 'heading');+ if (heading?.type === 'heading') {+ title = headingText(heading.children).trim();+ }+ }+ const extension = fallback.slice(fallback.lastIndexOf('.'));+ const hasMatchingExtension = title.toLowerCase().endsWith(extension);+ let filename = fallback;+ if (title) {+ filename = hasSourceFilename || hasMatchingExtension ? title : `${title}${extension}`;+ }+ filename = filenamify(filename, { replacement: '_' });+ /* File-backed blobs export cached preview content, not the original file. */+ if (artifact.download) {+ const dot = filename.lastIndexOf('.');+ filename =+ dot > 0 ? `${filename.slice(0, dot)}.preview${filename.slice(dot)}` : `${filename}.preview`;+ }+ return filename;+}+export function getTemplate(type: string, language?: string): SandpackPredefinedTemplate {const key = getKey(type, language);return artifactTemplate[key] ?? (artifactTemplate.default as SandpackPredefinedTemplate);@@ -907,6 +1012,8 @@ export function fileToArtifact(* binary — serializing `content` would hand the user the preview* instead of the .pptx/.xlsx/.docx. */download: {+ filename: attachment.filename || null,+ mimeType: attachment.type,filepath: attachment.filepath,file_id: attachment.file_id,source: attachment.source,diff --git a/packages/data-provider/src/file-config.spec.ts b/packages/data-provider/src/file-config.spec.tsindex 330ed85bf7..1ee9e035cc 100644--- a/packages/data-provider/src/file-config.spec.ts+++ b/packages/data-provider/src/file-config.spec.ts@@ -5,6 +5,7 @@ import {fileConfigSchema,isAnthropicTextDocumentType,getConfiguredMimeAccept,+ getDocumentFileExtension,bedrockDocumentMimeTypes,isAnthropicDocumentType,isPermissiveMimeConfig,@@ -1995,3 +1996,32 @@ describe('agent attachment context limits', () => {expect(mergeFileConfig({ fileContextCharLimit: 250_000 }).fileContextCharLimit).toBe(250_000);});});++describe('getDocumentFileExtension', () => {+ it.each([+ ['text/markdown', '.md'],+ [' TEXT/PLAIN; charset=UTF-8', '.txt'],+ ['application/vnd.openxmlformats-officedocument.wordprocessingml.document', '.docx'],+ ['application/vnd.oasis.opendocument.text', '.odt'],+ ['text/csv', '.csv'],+ ['application/csv', '.csv'],+ ['text/comma-separated-values', '.csv'],+ [' TEXT/COMMA-SEPARATED-VALUES; charset=utf-8', '.csv'],+ ['application/vnd.ms-excel', '.xls'],+ ['application/msexcel', '.xls'],+ ['application/x-msexcel', '.xls'],+ ['application/x-ms-excel', '.xls'],+ ['application/x-excel', '.xls'],+ ['application/x-dos_ms_excel', '.xls'],+ ['application/xls', '.xls'],+ ['application/x-xls', '.xls'],+ ['application/vnd.openxmlformats-officedocument.spreadsheetml.sheet', '.xlsx'],+ ['application/vnd.oasis.opendocument.spreadsheet', '.ods'],+ ['application/vnd.openxmlformats-officedocument.presentationml.presentation', '.pptx'],+ ['application/vnd.openxmlformats-officedocument.presentationml.template', '.potx'],+ ['application/unknown', undefined],+ [undefined, undefined],+ ])('resolves %s', (mimeType, expected) => {+ expect(getDocumentFileExtension(mimeType)).toBe(expected);+ });+});diff --git a/packages/data-provider/src/file-config.ts b/packages/data-provider/src/file-config.tsindex 62c85ddcb8..b3f55413b9 100644--- a/packages/data-provider/src/file-config.ts+++ b/packages/data-provider/src/file-config.ts@@ -791,6 +791,13 @@ const documentMimeExtensions: ReadonlyArray<readonly [string, readonly string[]]['message/rfc822', ['.eml']],];+/** Preferred extension for a known document MIME type, including its leading dot. */+export function getDocumentFileExtension(mimeType?: string): string | undefined {+ const normalized = mimeType?.split(';', 1)[0].trim().toLowerCase();+ const canonical = normalized === 'text/comma-separated-values' ? 'text/csv' : normalized;+ return documentMimeExtensions.find(([type]) => type === canonical)?.[1][0];+}+const documentMimeSet = new Set(documentMimeExtensions.map(([mimeType]) => mimeType));/** Every MIME type LibreChat may accept, used to detect patterns that reach beyond the representable set. */