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: OpenRouter Web Search (#9853)
Danny Avila3d7eaf0fcc0e
diff --git a/api/package.json b/api/package.jsonindex 52f50523bc..212a979612 100644--- a/api/package.json+++ b/api/package.json@@ -49,7 +49,7 @@"@langchain/google-vertexai": "^0.2.13","@langchain/openai": "^0.5.18","@langchain/textsplitters": "^0.1.0",- "@librechat/agents": "^2.4.80",+ "@librechat/agents": "^2.4.81","@librechat/api": "*","@librechat/data-schemas": "*","@microsoft/microsoft-graph-client": "^3.0.7",diff --git a/package-lock.json b/package-lock.jsonindex 0de769297b..cce2652ca6 100644--- a/package-lock.json+++ b/package-lock.json@@ -65,7 +65,7 @@"@langchain/google-vertexai": "^0.2.13","@langchain/openai": "^0.5.18","@langchain/textsplitters": "^0.1.0",- "@librechat/agents": "^2.4.80",+ "@librechat/agents": "^2.4.81","@librechat/api": "*","@librechat/data-schemas": "*","@microsoft/microsoft-graph-client": "^3.0.7",@@ -21910,9 +21910,9 @@}},"node_modules/@librechat/agents": {- "version": "2.4.80",- "resolved": "https://registry.npmjs.org/@librechat/agents/-/agents-2.4.80.tgz",- "integrity": "sha512-+GlWHMrgiwkptnUip7jJrz9oAQSz4+uJNoa+X6zR9W6x90NnknFwoQsXhQlnXoDGW75uGb+U7KI9mQz5H/YL6Q==",+ "version": "2.4.81",+ "resolved": "https://registry.npmjs.org/@librechat/agents/-/agents-2.4.81.tgz",+ "integrity": "sha512-uPepwOepQS03NJg9jzLvYGonyewy33QDB7iENKHooO8+6eIOv2QC4gm1k/fYKgsIfBfng2caRmn532UTrkE3rQ==","license": "MIT","dependencies": {"@langchain/anthropic": "^0.3.26",@@ -51641,7 +51641,7 @@},"peerDependencies": {"@langchain/core": "^0.3.62",- "@librechat/agents": "^2.4.80",+ "@librechat/agents": "^2.4.81","@librechat/data-schemas": "*","@modelcontextprotocol/sdk": "^1.17.1","axios": "^1.12.1",diff --git a/packages/api/package.json b/packages/api/package.jsonindex 036011d30f..c5b48d948a 100644--- a/packages/api/package.json+++ b/packages/api/package.json@@ -73,7 +73,7 @@},"peerDependencies": {"@langchain/core": "^0.3.62",- "@librechat/agents": "^2.4.80",+ "@librechat/agents": "^2.4.81","@librechat/data-schemas": "*","@modelcontextprotocol/sdk": "^1.17.1","axios": "^1.12.1",diff --git a/packages/api/src/endpoints/openai/config.spec.ts b/packages/api/src/endpoints/openai/config.spec.tsindex 5d6ffa60be..fa718f1043 100644--- a/packages/api/src/endpoints/openai/config.spec.ts+++ b/packages/api/src/endpoints/openai/config.spec.ts@@ -687,6 +687,82 @@ describe('getOpenAIConfig', () => {expect(result.provider).toBe('openrouter');});+ it('should handle web_search with OpenRouter using plugins format', () => {+ const modelOptions = {+ model: 'gpt-4',+ web_search: true,+ };++ const result = getOpenAIConfig(mockApiKey, {+ reverseProxyUrl: 'https://openrouter.ai/api/v1',+ modelOptions,+ });++ // Should use plugins format for OpenRouter, not tools+ expect(result.llmConfig.modelKwargs).toEqual({+ plugins: [{ id: 'web' }],+ });+ expect(result.tools).toEqual([]);+ // Should NOT set useResponsesApi for OpenRouter+ expect(result.llmConfig.useResponsesApi).toBeUndefined();+ expect(result.provider).toBe('openrouter');+ });++ it('should handle web_search false with OpenRouter', () => {+ const modelOptions = {+ model: 'gpt-4',+ web_search: false,+ };++ const result = getOpenAIConfig(mockApiKey, {+ reverseProxyUrl: 'https://openrouter.ai/api/v1',+ modelOptions,+ });++ // Should not have plugins when web_search is false+ expect(result.llmConfig.modelKwargs).toBeUndefined();+ expect(result.tools).toEqual([]);+ expect(result.provider).toBe('openrouter');+ });++ it('should handle web_search with OpenRouter from addParams', () => {+ const addParams = {+ web_search: true,+ customParam: 'value',+ };++ const result = getOpenAIConfig(mockApiKey, {+ reverseProxyUrl: 'https://openrouter.ai/api/v1',+ addParams,+ });++ // Should use plugins format and include other params+ expect(result.llmConfig.modelKwargs).toEqual({+ plugins: [{ id: 'web' }],+ customParam: 'value',+ });+ expect(result.tools).toEqual([]);+ expect(result.provider).toBe('openrouter');+ });++ it('should handle web_search with OpenRouter and dropParams', () => {+ const modelOptions = {+ model: 'gpt-4',+ web_search: true,+ };++ const result = getOpenAIConfig(mockApiKey, {+ reverseProxyUrl: 'https://openrouter.ai/api/v1',+ modelOptions,+ dropParams: ['web_search'],+ });++ // dropParams should disable web_search even for OpenRouter+ expect(result.llmConfig.modelKwargs).toBeUndefined();+ expect(result.tools).toEqual([]);+ expect(result.provider).toBe('openrouter');+ });+it('should handle OpenRouter with reasoning params', () => {const modelOptions = {reasoning_effort: ReasoningEffort.high,@@ -995,6 +1071,45 @@ describe('getOpenAIConfig', () => {}),});});++ it('should handle all configuration with OpenRouter and web_search', () => {+ const complexConfig = {+ modelOptions: {+ model: 'gpt-4-turbo',+ temperature: 0.7,+ max_tokens: 2000,+ verbosity: Verbosity.medium,+ reasoning_effort: ReasoningEffort.high,+ web_search: true,+ },+ reverseProxyUrl: 'https://openrouter.ai/api/v1',+ headers: { 'X-Custom': 'value' },+ streaming: false,+ addParams: {+ customParam: 'custom-value',+ temperature: 0.8,+ },+ };++ const result = getOpenAIConfig(mockApiKey, complexConfig);++ expect(result.llmConfig).toMatchObject({+ model: 'gpt-4-turbo',+ temperature: 0.8,+ streaming: false,+ include_reasoning: true, // OpenRouter specific+ });+ // Should NOT have useResponsesApi for OpenRouter+ expect(result.llmConfig.useResponsesApi).toBeUndefined();+ expect(result.llmConfig.maxTokens).toBe(2000);+ expect(result.llmConfig.modelKwargs).toEqual({+ verbosity: Verbosity.medium,+ customParam: 'custom-value',+ plugins: [{ id: 'web' }], // OpenRouter web search format+ });+ expect(result.tools).toEqual([]); // No tools for OpenRouter web search+ expect(result.provider).toBe('openrouter');+ });});describe('Real Usage Integration Tests', () => {diff --git a/packages/api/src/endpoints/openai/llm.ts b/packages/api/src/endpoints/openai/llm.tsindex c462b664ef..bcc082c47d 100644--- a/packages/api/src/endpoints/openai/llm.ts+++ b/packages/api/src/endpoints/openai/llm.ts@@ -180,7 +180,12 @@ export function getOpenAILLMConfig({enableWebSearch = false;}- if (enableWebSearch) {+ if (useOpenRouter && enableWebSearch) {+ /** OpenRouter expects web search as a plugins parameter */+ modelKwargs.plugins = [{ id: 'web' }];+ hasModelKwargs = true;+ } else if (enableWebSearch) {+ /** Standard OpenAI web search uses tools API */llmConfig.useResponsesApi = true;tools.push({ type: 'web_search_preview' });}