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
🦜 refactor: Use path for Read/Write/Edit/Create File Tools (#13834)
Danny Avila68d142d0e92c
diff --git a/api/package.json b/api/package.jsonindex cc50bcb81c..3a8da6e644 100644--- a/api/package.json+++ b/api/package.json@@ -46,7 +46,7 @@"@azure/storage-blob": "^12.30.0","@google/genai": "^2.8.0","@keyv/redis": "^4.3.3",- "@librechat/agents": "^3.2.38",+ "@librechat/agents": "^3.2.41","@librechat/api": "*","@librechat/data-schemas": "*","@microsoft/microsoft-graph-client": "^3.0.7",diff --git a/e2e/setup/fake-model.js b/e2e/setup/fake-model.jsindex 77f1d98a34..c2ce714b56 100644--- a/e2e/setup/fake-model.js+++ b/e2e/setup/fake-model.js@@ -427,7 +427,7 @@ Created by the Playwright mock e2e suite to verify host file authoring without cfunction buildCreateSkillArgs(skillName) {return {- file_path: `skills/${skillName}/SKILL.md`,+ path: `skills/${skillName}/SKILL.md`,content: buildSkillBody(skillName),overwrite: false,};@@ -435,7 +435,7 @@ function buildCreateSkillArgs(skillName) {function buildEditSkillArgs(skillName) {return {- file_path: `skills/${skillName}/SKILL.md`,+ path: `skills/${skillName}/SKILL.md`,old_text: `description: ${SKILL_DESCRIPTION}`,new_text: `description: ${EDITED_SKILL_DESCRIPTION}`,};diff --git a/package-lock.json b/package-lock.jsonindex 966e1c6a0e..097132596b 100644--- a/package-lock.json+++ b/package-lock.json@@ -61,7 +61,7 @@"@azure/storage-blob": "^12.30.0","@google/genai": "^2.8.0","@keyv/redis": "^4.3.3",- "@librechat/agents": "^3.2.38",+ "@librechat/agents": "^3.2.41","@librechat/api": "*","@librechat/data-schemas": "*","@microsoft/microsoft-graph-client": "^3.0.7",@@ -9834,9 +9834,9 @@}},"node_modules/@librechat/agents": {- "version": "3.2.38",- "resolved": "https://registry.npmjs.org/@librechat/agents/-/agents-3.2.38.tgz",- "integrity": "sha512-jbD+H9T/Bcz2ot50X2J/Ffsq5McFHriS66AhFHMIzUfsbDVbLFSYLj/6K61JRjxegIZ/z/gV6tmVAmZCHWh5kg==",+ "version": "3.2.41",+ "resolved": "https://registry.npmjs.org/@librechat/agents/-/agents-3.2.41.tgz",+ "integrity": "sha512-AjzSrurK/ihORn4NIftlS5CCviBWcT2kkLvYoCuV/aRT2E4HQea6aUfC+g0FIK71pBN9RThQv7Gh3I/7/aMxIw==","license": "MIT","dependencies": {"@anthropic-ai/sdk": "^0.92.0",@@ -11538,7 +11538,8 @@"node_modules/@protobufjs/aspromise": {"version": "1.1.2","resolved": "https://registry.npmjs.org/@protobufjs/aspromise/-/aspromise-1.1.2.tgz",- "integrity": "sha512-j+gKExEuLmKwvz3OgROXtrJ2UG2x8Ch2YZUxahh+s1F2HZ+wAceUNLkvy6zKCPVRkU++ZWQrdxsUeQXmcg4uoQ=="+ "integrity": "sha512-j+gKExEuLmKwvz3OgROXtrJ2UG2x8Ch2YZUxahh+s1F2HZ+wAceUNLkvy6zKCPVRkU++ZWQrdxsUeQXmcg4uoQ==",+ "license": "BSD-3-Clause"},"node_modules/@protobufjs/base64": {"version": "1.1.2",@@ -11557,12 +11558,12 @@"integrity": "sha512-j9ednRT81vYJ9OfVuXG6ERSTdEL1xVsNgqpkxMsbIabzSo3goCjDIveeGv5d03om39ML71RdmrGNjG5SReBP/Q=="},"node_modules/@protobufjs/fetch": {- "version": "1.1.0",- "resolved": "https://registry.npmjs.org/@protobufjs/fetch/-/fetch-1.1.0.tgz",- "integrity": "sha512-lljVXpqXebpsijW71PZaCYeIcE5on1w5DlQy5WH6GLbFryLUrBD4932W/E2BSpfRJWseIL4v/KPgBFxDOIdKpQ==",+ "version": "1.1.1",+ "resolved": "https://registry.npmjs.org/@protobufjs/fetch/-/fetch-1.1.1.tgz",+ "integrity": "sha512-GpptLrs57adMSuHi3VNj0mAF8dwh36LMaYF6XyJ6JMWlVsc+t42tm1HSEDmOs3A8fC9yyeisgLhsTVQokOZ0zw==",+ "license": "BSD-3-Clause","dependencies": {- "@protobufjs/aspromise": "^1.1.1",- "@protobufjs/inquire": "^1.1.0"+ "@protobufjs/aspromise": "^1.1.1"}},"node_modules/@protobufjs/float": {@@ -11571,9 +11572,9 @@"integrity": "sha512-Ddb+kVXlXst9d+R9PfTIxh1EdNkgoRe5tOX6t01f1lYWOvJnSPDBlG241QLzcyPdoNTsblLUdujGSE4RzrTZGQ=="},"node_modules/@protobufjs/inquire": {- "version": "1.1.1",- "resolved": "https://registry.npmjs.org/@protobufjs/inquire/-/inquire-1.1.1.tgz",- "integrity": "sha512-mnzgDV26ueAvk7rsbt9L7bE0SuAoqyuys/sMMrmVcN5x9VsxpcG3rqAUSgDyLp0UZlmNfIbQ4fHfCtreVBk8Ew==",+ "version": "1.1.2",+ "resolved": "https://registry.npmjs.org/@protobufjs/inquire/-/inquire-1.1.2.tgz",+ "integrity": "sha512-pa0vFRuws4wkvaXKK1uXZMAwAX4/t8ANaJo45iw/oQHNQ9q5xUzwgFmVJGXiga2BeN+zpX7Vf9vmsiIa2J+MUw==","license": "BSD-3-Clause"},"node_modules/@protobufjs/path": {@@ -35755,9 +35756,9 @@}},"node_modules/protobufjs": {- "version": "7.5.8",- "resolved": "https://registry.npmjs.org/protobufjs/-/protobufjs-7.5.8.tgz",- "integrity": "sha512-dvpCIeLPbXZS/Ete7yLaO7RenOdken2NHKykBXbsaGxZT0UTltcarBciw+A78SRQs9iMAAVpsYA+l8b1hTePIA==",+ "version": "7.5.9",+ "resolved": "https://registry.npmjs.org/protobufjs/-/protobufjs-7.5.9.tgz",+ "integrity": "sha512-Od4muIm3HW1AouyHF5lONOf1FWo3hY1NbFDoy191X9GzhpgW1clCoaFjfVs2rKJNFYpTNJbje4cbAIDBZJ63ZA==","hasInstallScript": true,"license": "BSD-3-Clause","dependencies": {@@ -35765,9 +35766,9 @@"@protobufjs/base64": "^1.1.2","@protobufjs/codegen": "^2.0.5","@protobufjs/eventemitter": "^1.1.0",- "@protobufjs/fetch": "^1.1.0",+ "@protobufjs/fetch": "^1.1.1","@protobufjs/float": "^1.0.2",- "@protobufjs/inquire": "^1.1.1",+ "@protobufjs/inquire": "^1.1.2","@protobufjs/path": "^1.1.2","@protobufjs/pool": "^1.1.0","@protobufjs/utf8": "^1.1.1",@@ -40365,9 +40366,9 @@"license": "MIT"},"node_modules/undici": {- "version": "7.24.1",- "resolved": "https://registry.npmjs.org/undici/-/undici-7.24.1.tgz",- "integrity": "sha512-5xoBibbmnjlcR3jdqtY2Lnx7WbrD/tHlT01TmvqZUFVc9Q1w4+j5hbnapTqbcXITMH1ovjq/W7BkqBilHiVAaA==",+ "version": "7.28.0",+ "resolved": "https://registry.npmjs.org/undici/-/undici-7.28.0.tgz",+ "integrity": "sha512-cRZYrTDwWznlnRiPjggAGxZXanty6M8RV1ff8Wm4LWXBp7/IG8v5DnOm74DtUBp9OONpK75YlPnIjQqX0dBDtA==","license": "MIT","engines": {"node": ">=20.18.1"@@ -42389,7 +42390,7 @@"@azure/storage-blob": "^12.30.0","@google/genai": "^2.8.0","@keyv/redis": "^4.3.3",- "@librechat/agents": "^3.2.38",+ "@librechat/agents": "^3.2.41","@librechat/data-schemas": "*","@modelcontextprotocol/sdk": "^1.29.0","@opentelemetry/api": "^1.9.0",diff --git a/packages/api/package.json b/packages/api/package.jsonindex 28b18ae90e..913408d94b 100644--- a/packages/api/package.json+++ b/packages/api/package.json@@ -113,7 +113,7 @@"@azure/storage-blob": "^12.30.0","@google/genai": "^2.8.0","@keyv/redis": "^4.3.3",- "@librechat/agents": "^3.2.38",+ "@librechat/agents": "^3.2.41","@librechat/data-schemas": "*","@modelcontextprotocol/sdk": "^1.29.0","@opentelemetry/api": "^1.9.0",diff --git a/packages/api/src/agents/__tests__/initialize.test.ts b/packages/api/src/agents/__tests__/initialize.test.tsindex e770dbd630..601d4706fd 100644--- a/packages/api/src/agents/__tests__/initialize.test.ts+++ b/packages/api/src/agents/__tests__/initialize.test.ts@@ -11,7 +11,7 @@ jest.mock('@librechat/agents', () => ({parameters: {type: 'object',properties: {- file_path: {+ path: {type: 'string',description: 'For skill files: "{skillName}/{path}".',},diff --git a/packages/api/src/agents/handlers.spec.ts b/packages/api/src/agents/handlers.spec.tsindex 0d843c9290..f195837735 100644--- a/packages/api/src/agents/handlers.spec.ts+++ b/packages/api/src/agents/handlers.spec.ts@@ -673,7 +673,7 @@ describe('createToolExecuteHandler', () => {{id: 'call_read_5',name: Constants.READ_FILE,- args: { file_path: 'maybe-disabled-read/SKILL.md' },+ args: { path: 'maybe-disabled-read/SKILL.md' },},]);@@ -717,7 +717,7 @@ describe('createToolExecuteHandler', () => {{id: 'call_read_6',name: Constants.READ_FILE,- args: { file_path: 'manually-primed/references/foo.md' },+ args: { path: 'manually-primed/references/foo.md' },},]);@@ -766,7 +766,7 @@ describe('createToolExecuteHandler', () => {{id: 'call_read_1',name: Constants.READ_FILE,- args: { file_path: 'pii-redactor/SKILL.md' },+ args: { path: 'pii-redactor/SKILL.md' },},]);@@ -795,7 +795,7 @@ describe('createToolExecuteHandler', () => {{id: 'call_read_2',name: Constants.READ_FILE,- args: { file_path: 'normal-skill/SKILL.md' },+ args: { path: 'normal-skill/SKILL.md' },},]);@@ -833,7 +833,7 @@ describe('createToolExecuteHandler', () => {{id: 'call_read_3',name: Constants.READ_FILE,- args: { file_path: 'manual-only-skill/SKILL.md' },+ args: { path: 'manual-only-skill/SKILL.md' },},]);@@ -869,7 +869,7 @@ describe('createToolExecuteHandler', () => {{id: 'call_read_4',name: Constants.READ_FILE,- args: { file_path: 'other-disabled-skill/SKILL.md' },+ args: { path: 'other-disabled-skill/SKILL.md' },},]);@@ -911,7 +911,7 @@ describe('createToolExecuteHandler', () => {{id: 'call_read_always',name: Constants.READ_FILE,- args: { file_path: 'always-applied-legal/SKILL.md' },+ args: { path: 'always-applied-legal/SKILL.md' },},]);@@ -947,7 +947,7 @@ describe('createToolExecuteHandler', () => {{id: 'call_read_pin',name: Constants.READ_FILE,- args: { file_path: 'collides/SKILL.md' },+ args: { path: 'collides/SKILL.md' },},]);@@ -1093,7 +1093,7 @@ describe('createToolExecuteHandler', () => {id: 'call_create_skill',name: 'create_file',args: {- file_path: 'skills/new-skill/SKILL.md',+ path: 'skills/new-skill/SKILL.md',content:'---\nname: new-skill\ndescription: Use for tests\ndisable-model-invocation: true\nallowed-tools:\n - execute_code\n---\n# New skill\n',},@@ -1140,7 +1140,7 @@ describe('createToolExecuteHandler', () => {id: 'call_create_auto_frontmatter',name: 'create_file',args: {- file_path: 'skills/auto-skill/SKILL.md',+ path: 'skills/auto-skill/SKILL.md',content: '# Auto skill\nUse this skill when testing generated frontmatter.\n',},},@@ -1179,7 +1179,7 @@ describe('createToolExecuteHandler', () => {id: 'call_create_block_description',name: 'create_file',args: {- file_path: 'skills/block-description-skill/SKILL.md',+ path: 'skills/block-description-skill/SKILL.md',content:'---\nname: block-description-skill\ndescription: |-\n Use this skill for long descriptions.\n Keep both lines searchable.\n---\n# Block description skill\n',},@@ -1233,7 +1233,7 @@ describe('createToolExecuteHandler', () => {id: 'call_create_skill',name: 'create_file',args: {- file_path: 'skills/new-skill/SKILL.md',+ path: 'skills/new-skill/SKILL.md',content: '---\nname: new-skill\ndescription: Use for tests\n---\n# New skill\n',},},@@ -1241,7 +1241,7 @@ describe('createToolExecuteHandler', () => {id: 'call_create_reference',name: 'create_file',args: {- file_path: 'skills/new-skill/references/a.md',+ path: 'skills/new-skill/references/a.md',content: 'reference text',},},@@ -1307,7 +1307,7 @@ describe('createToolExecuteHandler', () => {id: 'call_create_round_skill',name: 'create_file',args: {- file_path: 'skills/round-skill/SKILL.md',+ path: 'skills/round-skill/SKILL.md',content: createdSkill.body,},},@@ -1320,7 +1320,7 @@ describe('createToolExecuteHandler', () => {{id: 'call_read_round_skill',name: Constants.READ_FILE,- args: { file_path: 'skills/round-skill/SKILL.md' },+ args: { path: 'skills/round-skill/SKILL.md' },},],runtimeConfigurable,@@ -1357,7 +1357,7 @@ describe('createToolExecuteHandler', () => {id: 'call_create_existing',name: 'create_file',args: {- file_path: 'skills/existing-skill/SKILL.md',+ path: 'skills/existing-skill/SKILL.md',content: '---\nname: existing-skill\ndescription: Use for tests\n---\n# Updated\n',},},@@ -1396,7 +1396,7 @@ describe('createToolExecuteHandler', () => {id: 'call_duplicate_stale_skill',name: 'create_file',args: {- file_path: 'skills/stale-skill/SKILL.md',+ path: 'skills/stale-skill/SKILL.md',content: '---\nname: stale-skill\ndescription: Replacement\n---\n# Replacement\n',},},@@ -1437,7 +1437,7 @@ describe('createToolExecuteHandler', () => {id: 'call_edit_excluded_skill',name: 'edit_file',args: {- file_path: 'skills/excluded-skill/SKILL.md',+ path: 'skills/excluded-skill/SKILL.md',old_text: '# Excluded',new_text: '# Changed',},@@ -1477,7 +1477,7 @@ describe('createToolExecuteHandler', () => {id: 'call_recovered_hidden_skill',name: 'edit_file',args: {- file_path: 'skills/hidden-recovered-skill/SKILL.md',+ path: 'skills/hidden-recovered-skill/SKILL.md',old_text: '# Hidden',new_text: '# Changed',},@@ -1519,7 +1519,7 @@ describe('createToolExecuteHandler', () => {id: 'call_edit_file',name: 'edit_file',args: {- file_path: 'skills/edit-skill/references/a.md',+ path: 'skills/edit-skill/references/a.md',old_text: 'hello old',new_text: 'hello new',},@@ -1581,7 +1581,7 @@ describe('createToolExecuteHandler', () => {id: 'call_edit_stale_bundled_file',name: 'edit_file',args: {- file_path: 'skills/edit-skill/references/a.md',+ path: 'skills/edit-skill/references/a.md',old_text: 'hello old',new_text: 'hello new',},@@ -1624,7 +1624,7 @@ describe('createToolExecuteHandler', () => {id: 'call_edit_skill_md_frontmatter',name: 'edit_file',args: {- file_path: 'skills/runtime-skill/SKILL.md',+ path: 'skills/runtime-skill/SKILL.md',old_text: 'description: Use before\naction: ignored',new_text:'description: Use before\nuser-invocable: false\ndisable-model-invocation: true\nallowed-tools:\n - execute_code\nalways-apply: true',@@ -1677,7 +1677,7 @@ describe('createToolExecuteHandler', () => {id: 'call_edit_skill_md_block_description',name: 'edit_file',args: {- file_path: 'skills/runtime-skill/SKILL.md',+ path: 'skills/runtime-skill/SKILL.md',old_text: 'description: Use before',new_text:'description: |-\n Use this skill for long descriptions.\n Keep both lines searchable.',@@ -1717,7 +1717,7 @@ describe('createToolExecuteHandler', () => {id: 'call_edit_skill_md_name',name: 'edit_file',args: {- file_path: 'skills/runtime-skill/SKILL.md',+ path: 'skills/runtime-skill/SKILL.md',old_text: 'name: runtime-skill',new_text: 'name: dev-toolkit',},@@ -1759,7 +1759,7 @@ describe('createToolExecuteHandler', () => {id: 'call_edit_ambiguous',name: 'edit_file',args: {- file_path: 'skills/ambiguous-skill/references/a.md',+ path: 'skills/ambiguous-skill/references/a.md',old_text: 'same',new_text: 'different',},@@ -1796,7 +1796,7 @@ describe('createToolExecuteHandler', () => {id: 'call_edit_hidden_skill',name: 'edit_file',args: {- file_path: 'skills/hidden-skill/SKILL.md',+ path: 'skills/hidden-skill/SKILL.md',old_text: '# Hidden',new_text: '# Changed',},@@ -1841,7 +1841,7 @@ describe('createToolExecuteHandler', () => {id: 'call_edit_primed_hidden_skill',name: 'edit_file',args: {- file_path: 'skills/primed-hidden-skill/SKILL.md',+ path: 'skills/primed-hidden-skill/SKILL.md',old_text: '# Hidden',new_text: '# Changed',},@@ -1883,7 +1883,7 @@ describe('createToolExecuteHandler', () => {id: 'call_overwrite_large',name: 'create_file',args: {- file_path: 'skills/large-skill/references/large.md',+ path: 'skills/large-skill/references/large.md',content: 'replacement',overwrite: true,},@@ -1935,7 +1935,7 @@ describe('createToolExecuteHandler', () => {id: 'call_edit_one',name: 'edit_file',args: {- file_path: 'skills/serial-skill/references/a.md',+ path: 'skills/serial-skill/references/a.md',old_text: 'one',new_text: 'two',},@@ -1944,7 +1944,7 @@ describe('createToolExecuteHandler', () => {id: 'call_edit_two',name: 'edit_file',args: {- file_path: 'skills/serial-skill/references/a.md',+ path: 'skills/serial-skill/references/a.md',old_text: 'two',new_text: 'three',},@@ -1999,7 +1999,7 @@ describe('createToolExecuteHandler', () => {id: 'call_create_sandbox',name: 'create_file',args: {- file_path: '/mnt/data/new.txt',+ path: '/mnt/data/new.txt',content: 'hello world',},codeSessionContext: {@@ -2038,7 +2038,7 @@ describe('createToolExecuteHandler', () => {id: 'call_create_existing_sandbox',name: 'create_file',args: {- file_path: '/mnt/data/existing.txt',+ path: '/mnt/data/existing.txt',content: 'new text\n',},},@@ -2065,7 +2065,7 @@ describe('createToolExecuteHandler', () => {id: 'call_edit_sandbox',name: 'edit_file',args: {- file_path: '/mnt/data/edit.txt',+ path: '/mnt/data/edit.txt',old_text: 'alpha old',new_text: 'alpha new',},@@ -2151,7 +2151,7 @@ describe('createToolExecuteHandler', () => {id: 'call_create_queued_sandbox',name: 'create_file',args: {- file_path: '/mnt/data/queued.txt',+ path: '/mnt/data/queued.txt',content: 'hello world\n',},},@@ -2159,7 +2159,7 @@ describe('createToolExecuteHandler', () => {id: 'call_edit_queued_sandbox',name: 'edit_file',args: {- file_path: '/mnt/data/queued.txt',+ path: '/mnt/data/queued.txt',old_text: 'hello world',new_text: 'goodbye world',},@@ -2193,7 +2193,7 @@ describe('createToolExecuteHandler', () => {id: 'call_no_code_env_authoring',name: 'create_file',args: {- file_path: '/mnt/data/nope.txt',+ path: '/mnt/data/nope.txt',content: 'nope',},},@@ -2218,7 +2218,7 @@ describe('createToolExecuteHandler', () => {id: 'call_code_only_skill_path',name: 'create_file',args: {- file_path: 'skills/nope/SKILL.md',+ path: 'skills/nope/SKILL.md',content: '---\nname: nope\ndescription: Nope\n---\n# Nope\n',},},@@ -2274,7 +2274,7 @@ describe('createToolExecuteHandler', () => {{id: 'call_mnt_1',name: Constants.READ_FILE,- args: { file_path: '/mnt/data/sentinel.txt' },+ args: { path: '/mnt/data/sentinel.txt' },codeSessionContext: {session_id: 'sess-X',files: [{ id: 'f1', name: 'sentinel.txt', session_id: 'sess-X' }],@@ -2303,7 +2303,7 @@ describe('createToolExecuteHandler', () => {{id: 'call_mnt_2',name: Constants.READ_FILE,- args: { file_path: '/mnt/data/sentinel.txt' },+ args: { path: '/mnt/data/sentinel.txt' },},]);@@ -2325,7 +2325,7 @@ describe('createToolExecuteHandler', () => {{id: 'call_unknown_skill',name: Constants.READ_FILE,- args: { file_path: 'not-a-skill/foo.md' },+ args: { path: 'not-a-skill/foo.md' },codeSessionContext: { session_id: 'sess-Y' },} as unknown as ToolCallRequest,]);@@ -2391,7 +2391,7 @@ describe('createToolExecuteHandler', () => {{id: 'call_primed_outside_catalog',name: Constants.READ_FILE,- args: { file_path: 'primed-only-skill/references/foo.md' },+ args: { path: 'primed-only-skill/references/foo.md' },},]);@@ -2440,7 +2440,7 @@ describe('createToolExecuteHandler', () => {{id: 'call_stale_catalog_skill',name: Constants.READ_FILE,- args: { file_path: 'stale-catalog-skill/SKILL.md' },+ args: { path: 'stale-catalog-skill/SKILL.md' },},]);@@ -2475,7 +2475,7 @@ describe('createToolExecuteHandler', () => {{id: 'call_skills_off',name: Constants.READ_FILE,- args: { file_path: 'whatever/path.md' },+ args: { path: 'whatever/path.md' },},]);@@ -2495,7 +2495,7 @@ describe('createToolExecuteHandler', () => {{id: 'call_no_route',name: Constants.READ_FILE,- args: { file_path: 'whatever/path.md' },+ args: { path: 'whatever/path.md' },},]);@@ -2524,7 +2524,7 @@ describe('createToolExecuteHandler', () => {{id: 'call_real_skill',name: Constants.READ_FILE,- args: { file_path: 'real-skill/SKILL.md' },+ args: { path: 'real-skill/SKILL.md' },},]);@@ -2555,7 +2555,7 @@ describe('createToolExecuteHandler', () => {{id: 'call_real_skill_namespace',name: Constants.READ_FILE,- args: { file_path: 'skills/real-skill/SKILL.md' },+ args: { path: 'skills/real-skill/SKILL.md' },},]);@@ -2584,7 +2584,7 @@ describe('createToolExecuteHandler', () => {{id: 'call_explicit_skill_namespace_off',name: Constants.READ_FILE,- args: { file_path: 'skills/whatever/SKILL.md' },+ args: { path: 'skills/whatever/SKILL.md' },},]);@@ -2613,7 +2613,7 @@ describe('createToolExecuteHandler', () => {{id: 'call_trailing_slash',name: Constants.READ_FILE,- args: { file_path: 'output/' },+ args: { path: 'output/' },},]);@@ -2635,7 +2635,7 @@ describe('createToolExecuteHandler', () => {{id: 'call_trailing_slash_no_env',name: Constants.READ_FILE,- args: { file_path: 'output/' },+ args: { path: 'output/' },},]);@@ -2655,7 +2655,7 @@ describe('createToolExecuteHandler', () => {{id: 'call_no_callback',name: Constants.READ_FILE,- args: { file_path: '/mnt/data/x.txt' },+ args: { path: '/mnt/data/x.txt' },},]);@@ -2684,7 +2684,7 @@ describe('createToolExecuteHandler', () => {{id: 'call_huge_file',name: Constants.READ_FILE,- args: { file_path: '/mnt/data/huge.log' },+ args: { path: '/mnt/data/huge.log' },},]);@@ -2712,7 +2712,7 @@ describe('createToolExecuteHandler', () => {{id: 'call_small_file',name: Constants.READ_FILE,- args: { file_path: '/mnt/data/sentinel.txt' },+ args: { path: '/mnt/data/sentinel.txt' },},]);@@ -2733,7 +2733,7 @@ describe('createToolExecuteHandler', () => {{id: 'call_null_result',name: Constants.READ_FILE,- args: { file_path: '/mnt/data/missing.txt' },+ args: { path: '/mnt/data/missing.txt' },},]);@@ -2764,7 +2764,7 @@ describe('createToolExecuteHandler', () => {{id: 'call_png',name: Constants.READ_FILE,- args: { file_path: '/mnt/data/simple_graph.png' },+ args: { path: '/mnt/data/simple_graph.png' },codeSessionContext: { session_id: 'sess-Z' },} as unknown as ToolCallRequest,]);@@ -2789,7 +2789,7 @@ describe('createToolExecuteHandler', () => {{id: 'call_zip',name: Constants.READ_FILE,- args: { file_path: '/mnt/data/archive.zip' },+ args: { path: '/mnt/data/archive.zip' },},]);@@ -2813,7 +2813,7 @@ describe('createToolExecuteHandler', () => {{id: 'call_uppercase',name: Constants.READ_FILE,- args: { file_path: '/mnt/data/CHART.PNG' },+ args: { path: '/mnt/data/CHART.PNG' },},]);@@ -2840,7 +2840,7 @@ describe('createToolExecuteHandler', () => {{id: 'call_nul_sniff',name: Constants.READ_FILE,- args: { file_path: '/mnt/data/mystery_file' },+ args: { path: '/mnt/data/mystery_file' },},]);@@ -2864,7 +2864,7 @@ describe('createToolExecuteHandler', () => {{id: 'call_text',name: Constants.READ_FILE,- args: { file_path: '/mnt/data/notes.txt' },+ args: { path: '/mnt/data/notes.txt' },},]);@@ -2888,7 +2888,7 @@ describe('createToolExecuteHandler', () => {{id: 'call_dotted_dir',name: Constants.READ_FILE,- args: { file_path: '/mnt/data/proj.v1/notes' },+ args: { path: '/mnt/data/proj.v1/notes' },},]);@@ -2916,7 +2916,7 @@ describe('createToolExecuteHandler', () => {{id: 'call_svg',name: Constants.READ_FILE,- args: { file_path: '/mnt/data/icon.svg' },+ args: { path: '/mnt/data/icon.svg' },},]);diff --git a/packages/api/src/agents/handlers.ts b/packages/api/src/agents/handlers.tsindex 2de8884d2c..8605ef498e 100644--- a/packages/api/src/agents/handlers.ts+++ b/packages/api/src/agents/handlers.ts@@ -1374,10 +1374,10 @@ function isSandboxMissingFileError(error: unknown): boolean {function invalidSandboxAuthoringPath(filePath: string): string | null {if (filePath.length === 0) {- return 'file_path is required';+ return 'path is required';}if (filePath.includes('\0')) {- return 'file_path cannot contain NUL bytes';+ return 'path cannot contain NUL bytes';}if (filePath.endsWith('/')) {return `File path "${filePath}" points to a directory. Provide a file path.`;@@ -2270,9 +2270,9 @@ async function handleCreateFileCall(sourceConfigurable?: Record<string, unknown>,sandboxContext?: SandboxSessionContext,): AuthoringResult {- const args = tc.args as { file_path?: unknown; content?: unknown; overwrite?: unknown };- if (typeof args.file_path !== 'string' || args.file_path.length === 0) {- return errorResult(tc, 'file_path is required');+ const args = tc.args as { path?: unknown; content?: unknown; overwrite?: unknown };+ if (typeof args.path !== 'string' || args.path.length === 0) {+ return errorResult(tc, 'path is required');}if (typeof args.content !== 'string') {return errorResult(tc, 'content is required');@@ -2282,25 +2282,25 @@ async function handleCreateFileCall(}const overwrite = args.overwrite === true;- if (!args.file_path.startsWith(SKILL_FILE_PREFIX)) {+ if (!args.path.startsWith(SKILL_FILE_PREFIX)) {if (mergedConfigurable?.codeEnvAvailable !== true) {return errorResult(tc,- `Path "${args.file_path}" is not a skill file, and this agent does not have code execution enabled.`,+ `Path "${args.path}" is not a skill file, and this agent does not have code execution enabled.`,);}return await handleSandboxCreateFileCall({tc,options,req,- filePath: args.file_path,+ filePath: args.path,content: args.content,overwrite,sandboxContext,});}- const parsed = parseSkillAuthoringPath(args.file_path);+ const parsed = parseSkillAuthoringPath(args.path);if (typeof parsed === 'string') {return errorResult(tc, parsed);}@@ -2378,13 +2378,13 @@ async function handleEditFileCall(sandboxContext?: SandboxSessionContext,): AuthoringResult {const args = tc.args as {- file_path?: unknown;+ path?: unknown;old_text?: unknown;new_text?: unknown;edits?: unknown;};- if (typeof args.file_path !== 'string' || args.file_path.length === 0) {- return errorResult(tc, 'file_path is required');+ if (typeof args.path !== 'string' || args.path.length === 0) {+ return errorResult(tc, 'path is required');}const edits = normalizeEditArgs(args);@@ -2392,24 +2392,24 @@ async function handleEditFileCall(return errorResult(tc, edits);}- if (!args.file_path.startsWith(SKILL_FILE_PREFIX)) {+ if (!args.path.startsWith(SKILL_FILE_PREFIX)) {if (mergedConfigurable?.codeEnvAvailable !== true) {return errorResult(tc,- `Path "${args.file_path}" is not a skill file, and this agent does not have code execution enabled.`,+ `Path "${args.path}" is not a skill file, and this agent does not have code execution enabled.`,);}return await handleSandboxEditFileCall({tc,options,req,- filePath: args.file_path,+ filePath: args.path,edits,sandboxContext,});}- const parsed = parseSkillAuthoringPath(args.file_path);+ const parsed = parseSkillAuthoringPath(args.path);if (typeof parsed === 'string') {return errorResult(tc, parsed);}@@ -2511,13 +2511,13 @@ async function handleReadFileCall(): Promise<ToolExecuteResult> {const { getSkillByName, getSkillFileByPath, getStrategyFunctions, updateSkillFileContent } =options;- const args = tc.args as { file_path?: string };- if (!args.file_path) {+ const args = tc.args as { path?: string };+ if (!args.path) {return {toolCallId: tc.id,status: 'error',content: '',- errorMessage: 'file_path is required',+ errorMessage: 'path is required',};}@@ -2529,23 +2529,23 @@ async function handleReadFileCall(* reference (skill paths are relative `{skillName}/...`), and consulting* `getSkillByName` would just burn a DB round-trip on a guaranteed miss.*/- if (args.file_path.startsWith('/mnt/data/')) {+ if (args.path.startsWith('/mnt/data/')) {if (codeEnvAvailable) {- return handleSandboxFileFallback(tc, args.file_path, options, req);+ return handleSandboxFileFallback(tc, args.path, options, req);}return {toolCallId: tc.id,status: 'error',content: '',- errorMessage: `Path "${args.file_path}" is a code-execution sandbox path, but this agent does not have code execution enabled.`,+ errorMessage: `Path "${args.path}" is a code-execution sandbox path, but this agent does not have code execution enabled.`,};}let skillName: string;let relativePath: string;- const explicitSkillNamespace = args.file_path.startsWith(SKILL_FILE_PREFIX);+ const explicitSkillNamespace = args.path.startsWith(SKILL_FILE_PREFIX);if (explicitSkillNamespace) {- const parsed = parseSkillAuthoringPath(args.file_path);+ const parsed = parseSkillAuthoringPath(args.path);if (typeof parsed === 'string') {return {toolCallId: tc.id,@@ -2557,21 +2557,21 @@ async function handleReadFileCall(skillName = parsed.skillName;relativePath = parsed.relativePath;} else {- const slashIdx = args.file_path.indexOf('/');+ const slashIdx = args.path.indexOf('/');if (slashIdx < 1) {if (codeEnvAvailable) {- return handleSandboxFileFallback(tc, args.file_path, options, req);+ return handleSandboxFileFallback(tc, args.path, options, req);}return {toolCallId: tc.id,status: 'error',content: '',- errorMessage: `Invalid file path "${args.file_path}". Use format: {skillName}/{path}`,+ errorMessage: `Invalid file path "${args.path}". Use format: {skillName}/{path}`,};}- skillName = args.file_path.slice(0, slashIdx);- relativePath = args.file_path.slice(slashIdx + 1);+ skillName = args.path.slice(0, slashIdx);+ relativePath = args.path.slice(slashIdx + 1);if (!relativePath) {/*** `read_file("output/")`: a malformed-but-unambiguously-not-a-skill@@ -2580,7 +2580,7 @@ async function handleReadFileCall(* dead-ending with a skill-centric error message.*/if (codeEnvAvailable) {- return handleSandboxFileFallback(tc, args.file_path, options, req);+ return handleSandboxFileFallback(tc, args.path, options, req);}return {toolCallId: tc.id,@@ -2642,7 +2642,7 @@ async function handleReadFileCall(*/if (!skillsEffectivelyEnabled) {if (codeEnvAvailable && !explicitSkillNamespace) {- return handleSandboxFileFallback(tc, args.file_path, options, req);+ return handleSandboxFileFallback(tc, args.path, options, req);}return {toolCallId: tc.id,@@ -2681,7 +2681,7 @@ async function handleReadFileCall(const recovered = await recoverAuthorSkill();if (!recovered) {if (codeEnvAvailable && !explicitSkillNamespace) {- return handleSandboxFileFallback(tc, args.file_path, options, req);+ return handleSandboxFileFallback(tc, args.path, options, req);}return {toolCallId: tc.id,@@ -2763,7 +2763,7 @@ async function handleReadFileCall(return {toolCallId: tc.id,status: 'success',- content: `File: ${args.file_path}\n\n${addLineNumbers(skill.body)}`,+ content: `File: ${args.path}\n\n${addLineNumbers(skill.body)}`,};}@@ -2794,7 +2794,7 @@ async function handleReadFileCall(return {toolCallId: tc.id,status: 'success',- content: `Binary file (${file.mimeType}, ${file.bytes} bytes). Use bash to process: /mnt/data/${args.file_path}`,+ content: `Binary file (${file.mimeType}, ${file.bytes} bytes). Use bash to process: /mnt/data/${args.path}`,};}}@@ -2804,7 +2804,7 @@ async function handleReadFileCall(return {toolCallId: tc.id,status: 'success',- content: `File: ${args.file_path} (${file.bytes} bytes)\n\n${addLineNumbers(file.content)}`,+ content: `File: ${args.path} (${file.bytes} bytes)\n\n${addLineNumbers(file.content)}`,};}@@ -2814,14 +2814,14 @@ async function handleReadFileCall(return {toolCallId: tc.id,status: 'success',- content: `File "${args.file_path}" is too large to read directly (${file.bytes} bytes, limit: ${MAX_READABLE_BYTES}). Invoke the skill first, then use bash to read it at /mnt/data/${args.file_path}.`,+ content: `File "${args.path}" is too large to read directly (${file.bytes} bytes, limit: ${MAX_READABLE_BYTES}). Invoke the skill first, then use bash to read it at /mnt/data/${args.path}.`,};}if (isImage && file.bytes > MAX_BINARY_BYTES) {return {toolCallId: tc.id,status: 'success',- content: `File too large (${file.bytes} bytes, limit: ${MAX_BINARY_BYTES}). Use bash to process: /mnt/data/${args.file_path}`,+ content: `File too large (${file.bytes} bytes, limit: ${MAX_BINARY_BYTES}). Use bash to process: /mnt/data/${args.path}`,};}@@ -2865,7 +2865,7 @@ async function handleReadFileCall(return {toolCallId: tc.id,status: 'success',- content: `File "${args.file_path}" exceeded streaming limit (${streamLimit} bytes). Invoke the skill first, then use bash to read it at /mnt/data/${args.file_path}.`,+ content: `File "${args.path}" exceeded streaming limit (${streamLimit} bytes). Invoke the skill first, then use bash to read it at /mnt/data/${args.path}.`,};}chunks.push(chunk);@@ -2903,7 +2903,7 @@ async function handleReadFileCall(return {toolCallId: tc.id,status: 'success',- content: `Image: ${args.file_path} (${buffer.length} bytes, ${file.mimeType})`,+ content: `Image: ${args.path} (${buffer.length} bytes, ${file.mimeType})`,artifact: {content: [{ type: 'image_url', image_url: { url: `data:${file.mimeType};base64,${base64}` } },@@ -2919,7 +2919,7 @@ async function handleReadFileCall(return {toolCallId: tc.id,status: 'success',- content: `Binary file (${file.mimeType}, ${buffer.length} bytes). Use bash to process: /mnt/data/${args.file_path}`,+ content: `Binary file (${file.mimeType}, ${buffer.length} bytes). Use bash to process: /mnt/data/${args.path}`,};}@@ -2941,14 +2941,14 @@ async function handleReadFileCall(return {toolCallId: tc.id,status: 'success',- content: `File too large (${buffer.length} bytes, limit: ${MAX_READABLE_BYTES}). Use bash: cat /mnt/data/${args.file_path}`,+ content: `File too large (${buffer.length} bytes, limit: ${MAX_READABLE_BYTES}). Use bash: cat /mnt/data/${args.path}`,};}return {toolCallId: tc.id,status: 'success',- content: `File: ${args.file_path} (${buffer.length} bytes)\n\n${addLineNumbers(text)}`,+ content: `File: ${args.path} (${buffer.length} bytes)\n\n${addLineNumbers(text)}`,};} catch (error) {return {@@ -3126,16 +3126,16 @@ function getFileAuthoringQueueKey(if (!isHostFileAuthoringToolCall(tc.name, mergedConfigurable)) {return undefined;}- const args = tc.args as { file_path?: unknown };- if (typeof args.file_path !== 'string' || args.file_path.length === 0) {+ const args = tc.args as { path?: unknown };+ if (typeof args.path !== 'string' || args.path.length === 0) {return undefined;}- if (!args.file_path.startsWith(SKILL_FILE_PREFIX)) {- return `sandbox:${args.file_path}`;+ if (!args.path.startsWith(SKILL_FILE_PREFIX)) {+ return `sandbox:${args.path}`;}- const parsed = parseSkillAuthoringPath(args.file_path);+ const parsed = parseSkillAuthoringPath(args.path);if (typeof parsed === 'string') {- return `skill:${args.file_path}`;+ return `skill:${args.path}`;}return `skill:${parsed.skillName}`;}@@ -3199,8 +3199,8 @@ export function createToolExecuteHandler(options: ToolExecuteOptions): EventHand);const isSandboxFileAuthoringCall =isFileAuthoringCall &&- typeof (tc.args as { file_path?: unknown }).file_path === 'string' &&- !(tc.args as { file_path: string }).file_path.startsWith(SKILL_FILE_PREFIX);+ typeof (tc.args as { path?: unknown }).path === 'string' &&+ !(tc.args as { path: string }).path.startsWith(SKILL_FILE_PREFIX);if (tc.name === Constants.SKILL_TOOL ||tc.name === Constants.READ_FILE ||diff --git a/packages/api/src/agents/tools.spec.ts b/packages/api/src/agents/tools.spec.tsindex 570eba1708..0650a4c093 100644--- a/packages/api/src/agents/tools.spec.ts+++ b/packages/api/src/agents/tools.spec.ts@@ -12,7 +12,7 @@ jest.mock('@librechat/agents', () => ({parameters: {type: 'object',properties: {- file_path: {+ path: {type: 'string',description: 'For skill files: "{skillName}/{path}".',},@@ -55,9 +55,9 @@ const TOOL_DESCRIPTION_ADVISORY_MAX_LENGTH = 1024;function filePathDescription(tool?: LCTool): string {const parameters = tool?.parameters as- | { properties?: { file_path?: { description?: string } } }+ | { properties?: { path?: { description?: string } } }| undefined;- return parameters?.properties?.file_path?.description ?? '';+ return parameters?.properties?.path?.description ?? '';}function maxToolDescriptionLength(definitions: LCTool[]): number {diff --git a/packages/api/src/agents/tools.ts b/packages/api/src/agents/tools.tsindex f554dd3df6..9b9cabb9c9 100644--- a/packages/api/src/agents/tools.ts+++ b/packages/api/src/agents/tools.ts@@ -140,13 +140,13 @@ Use for text, CSV, JSON, Markdown, logs, and small source files at paths returneconst CODE_READ_FILE_PARAMETERS: LCTool['parameters'] = Object.freeze({type: 'object',properties: {- file_path: {+ path: {type: 'string',description:'Path to a file from code execution output, such as "/mnt/data/result.csv" or another path returned by the execution tool.',},},- required: ['file_path'],+ required: ['path'],}) as LCTool['parameters'];const CODE_READ_FILE_DEF: LCTool = Object.freeze({@@ -159,7 +159,7 @@ const CODE_READ_FILE_DEF: LCTool = Object.freeze({const SKILL_CREATE_FILE_PARAMETERS: LCTool['parameters'] = Object.freeze({type: 'object',properties: {- file_path: {+ path: {type: 'string',description:'Path to write. Use "skills/{skillName}/..." for skill files when available, or a code-execution sandbox path such as "/mnt/data/result.txt" when code execution is enabled. For SKILL.md, the YAML frontmatter name must match {skillName}.',@@ -174,13 +174,13 @@ const SKILL_CREATE_FILE_PARAMETERS: LCTool['parameters'] = Object.freeze({default: false,},},- required: ['file_path', 'content'],+ required: ['path', 'content'],}) as LCTool['parameters'];const CODE_CREATE_FILE_PARAMETERS: LCTool['parameters'] = Object.freeze({type: 'object',properties: {- file_path: {+ path: {type: 'string',description:'Path to write in the code-execution sandbox, such as "/mnt/data/result.txt". Prefer /mnt/data/{file} for files that should remain available to later sandbox calls.',@@ -195,13 +195,13 @@ const CODE_CREATE_FILE_PARAMETERS: LCTool['parameters'] = Object.freeze({default: false,},},- required: ['file_path', 'content'],+ required: ['path', 'content'],}) as LCTool['parameters'];const SKILL_EDIT_FILE_PARAMETERS: LCTool['parameters'] = Object.freeze({type: 'object',properties: {- file_path: {+ path: {type: 'string',description:'Path to edit. Use "skills/{skillName}/..." for skill files when available, or a code-execution sandbox path such as "/mnt/data/result.txt" when code execution is enabled. edit_file cannot rename skills; keep SKILL.md frontmatter name equal to {skillName}.',@@ -227,13 +227,13 @@ const SKILL_EDIT_FILE_PARAMETERS: LCTool['parameters'] = Object.freeze({},},},- required: ['file_path'],+ required: ['path'],}) as LCTool['parameters'];const CODE_EDIT_FILE_PARAMETERS: LCTool['parameters'] = Object.freeze({type: 'object',properties: {- file_path: {+ path: {type: 'string',description: 'Path to edit in the code-execution sandbox, such as "/mnt/data/result.txt".',},@@ -258,7 +258,7 @@ const CODE_EDIT_FILE_PARAMETERS: LCTool['parameters'] = Object.freeze({},},},- required: ['file_path'],+ required: ['path'],}) as LCTool['parameters'];const SKILL_CREATE_FILE_DESCRIPTION = `Create a new file, or overwrite an existing file with explicit intent.diff --git a/packages/api/src/mcp/connection.ts b/packages/api/src/mcp/connection.tsindex 2366181684..ff208f0ac3 100644--- a/packages/api/src/mcp/connection.ts+++ b/packages/api/src/mcp/connection.ts@@ -1630,8 +1630,11 @@ export class MCPConnection extends EventEmitter {this.allowedAddresses,);/** Merge headers: SSE defaults < init headers < user headers (user wins) */- const fetchHeaders = new Headers(- Object.assign({}, SSE_REQUEST_HEADERS, resolvedInit?.headers, headers),+ const fetchHeaders = Object.assign(+ {},+ SSE_REQUEST_HEADERS,+ resolvedInit?.headers,+ headers,);return undiciFetch(urlString, {...resolvedInit,