Skip to content

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

📂 fix: Preserve Nested Skill Paths in Code-Env Uploads (#12877)

Danny Avila4a5fc701d265
diff --git a/api/server/services/Files/Code/crud.js b/api/server/services/Files/Code/crud.js
index fdbedb56eb..6b4e58d89b 100644
--- a/api/server/services/Files/Code/crud.js
+++ b/api/server/services/Files/Code/crud.js
@@ -3,6 +3,7 @@ const { logger } = require('@librechat/data-schemas');
const { getCodeBaseURL } = require('@librechat/agents');
const {
logAxiosError,
+ appendCodeEnvFile,
createAxiosInstance,
codeServerHttpAgent,
codeServerHttpsAgent,
@@ -62,7 +63,7 @@ async function uploadCodeEnvFile({ req, stream, filename, entity_id = '' }) {
if (entity_id.length > 0) {
form.append('entity_id', entity_id);
}
- form.append('file', stream, filename);
+ appendCodeEnvFile(form, stream, filename);
const baseURL = getCodeBaseURL();
/** @type {import('axios').AxiosRequestConfig} */
@@ -131,7 +132,7 @@ async function batchUploadCodeEnvFiles({ req, files, entity_id = '', read_only =
form.append('read_only', 'true');
}
for (const file of files) {
- form.append('file', file.stream, file.filename);
+ appendCodeEnvFile(form, file.stream, file.filename);
}
const baseURL = getCodeBaseURL();
diff --git a/api/server/services/Files/Code/crud.spec.js b/api/server/services/Files/Code/crud.spec.js
index aa2fd8e3e7..487ae56786 100644
--- a/api/server/services/Files/Code/crud.spec.js
+++ b/api/server/services/Files/Code/crud.spec.js
@@ -13,6 +13,9 @@ jest.mock('@librechat/api', () => {
const http = require('http');
const https = require('https');
return {
+ appendCodeEnvFile: jest.fn((form, stream, filename) => {
+ form.append('file', stream, { filename });
+ }),
logAxiosError: jest.fn(({ message }) => message),
createAxiosInstance: jest.fn(() => mockAxios),
codeServerHttpAgent: new http.Agent({ keepAlive: false }),
diff --git a/packages/api/src/files/code/form.spec.ts b/packages/api/src/files/code/form.spec.ts
new file mode 100644
index 0000000000..2bc572ab54
--- /dev/null
+++ b/packages/api/src/files/code/form.spec.ts
@@ -0,0 +1,52 @@
+import { Readable } from 'stream';
+import FormData from 'form-data';
+
+import { appendCodeEnvFile, getCodeEnvFileOptions } from './form';
+
+function renderMultipartDisposition(append: (form: FormData) => void): Promise<string> {
+ const form = new FormData();
+ append(form);
+
+ const chunks: Buffer[] = [];
+ form.on('data', (chunk: Buffer | string) => {
+ chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
+ });
+
+ return new Promise<string>((resolve, reject) => {
+ form.on('end', () => {
+ const body = Buffer.concat(chunks).toString('utf8');
+ resolve(body.match(/Content-Disposition:.*/)?.[0] ?? '');
+ });
+ form.on('error', reject);
+ form.resume();
+ });
+}
+
+describe('code env FormData filenames', () => {
+ it('uses filepath for nested filenames so form-data preserves directories', async () => {
+ const disposition = await renderMultipartDisposition((form) => {
+ appendCodeEnvFile(form, Readable.from(['x']), 'pptx/pptx.py');
+ });
+
+ expect(disposition).toContain('filename="pptx/pptx.py"');
+ });
+
+ it('documents the form-data string overload regression', async () => {
+ const disposition = await renderMultipartDisposition((form) => {
+ form.append('file', Readable.from(['x']), 'pptx/pptx.py');
+ });
+
+ expect(disposition).toContain('filename="pptx.py"');
+ });
+
+ it('keeps flat filenames as filename-only options', () => {
+ expect(getCodeEnvFileOptions('script.py')).toEqual({ filename: 'script.py' });
+ });
+
+ it('normalizes Windows separators before sending path-bearing filenames', () => {
+ expect(getCodeEnvFileOptions('pptx\\pptx.py')).toEqual({
+ filename: 'pptx.py',
+ filepath: 'pptx/pptx.py',
+ });
+ });
+});
diff --git a/packages/api/src/files/code/form.ts b/packages/api/src/files/code/form.ts
new file mode 100644
index 0000000000..38f1f05c45
--- /dev/null
+++ b/packages/api/src/files/code/form.ts
@@ -0,0 +1,31 @@
+import * as path from 'path';
+
+import type FormData from 'form-data';
+
+export interface CodeEnvFileOptions {
+ filename: string;
+ filepath?: string;
+}
+
+/**
+ * Uses `filepath` for nested names because `form-data` strips directories from
+ * the bare string filename overload before codeapi can preserve them.
+ */
+export function getCodeEnvFileOptions(filename: string): CodeEnvFileOptions {
+ const normalized = filename.replace(/\\/g, '/');
+ const basename = path.posix.basename(normalized);
+
+ if (normalized === basename) {
+ return { filename };
+ }
+
+ return { filename: basename, filepath: normalized };
+}
+
+export function appendCodeEnvFile(
+ form: FormData,
+ stream: NodeJS.ReadableStream,
+ filename: string,
+): void {
+ form.append('file', stream, getCodeEnvFileOptions(filename));
+}
diff --git a/packages/api/src/files/code/index.ts b/packages/api/src/files/code/index.ts
index 47852d1abd..b48d6ce3cb 100644
--- a/packages/api/src/files/code/index.ts
+++ b/packages/api/src/files/code/index.ts
@@ -1,2 +1,3 @@
export * from './classify';
export * from './extract';
+export * from './form';