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: Add Google Search Grounding Toggle (#8174)
Dustin Healy738d04fac417
diff --git a/api/package.json b/api/package.jsonindex fd002d58ce..6621b37fd9 100644--- a/api/package.json+++ b/api/package.json@@ -48,7 +48,7 @@"@langchain/google-genai": "^0.2.13","@langchain/google-vertexai": "^0.2.13","@langchain/textsplitters": "^0.1.0",- "@librechat/agents": "^2.4.49",+ "@librechat/agents": "^2.4.50","@librechat/api": "*","@librechat/data-schemas": "*","@node-saml/passport-saml": "^5.0.0",diff --git a/api/server/services/Endpoints/agents/agent.js b/api/server/services/Endpoints/agents/agent.jsindex a3523605db..469cacd0e4 100644--- a/api/server/services/Endpoints/agents/agent.js+++ b/api/server/services/Endpoints/agents/agent.js@@ -140,6 +140,14 @@ const initializeAgent = async ({agent.provider = options.provider;}+ if (+ (agent.provider === Providers.GOOGLE || agent.provider === Providers.VERTEXAI) &&+ options?.tools?.length &&+ tools?.length+ ) {+ throw new Error(`{ "type": "${ErrorTypes.GOOGLE_TOOL_CONFLICT}"}`);+ }+/** @type {import('@librechat/agents').ClientOptions} */agent.model_parameters = { ...options.llmConfig };if (options.configOptions) {@@ -162,10 +170,10 @@ const initializeAgent = async ({return {...agent,- tools,attachments,resendFiles,toolContextMap,+ tools: options.tools ?? tools,maxContextTokens: (agentMaxContextTokens - maxTokens) * 0.9,};};diff --git a/client/src/components/Messages/Content/Error.tsx b/client/src/components/Messages/Content/Error.tsxindex 8a9391ccda..77580a3737 100644--- a/client/src/components/Messages/Content/Error.tsx+++ b/client/src/components/Messages/Content/Error.tsx@@ -62,6 +62,7 @@ const errorMessages = {const { info } = json;return info;},+ [ErrorTypes.GOOGLE_TOOL_CONFLICT]: 'com_error_google_tool_conflict',[ViolationTypes.BAN]:'Your account has been temporarily banned due to violations of our service.',invalid_api_key:diff --git a/client/src/components/SidePanel/Parameters/DynamicSwitch.tsx b/client/src/components/SidePanel/Parameters/DynamicSwitch.tsxindex a603ffe89d..eff11f3453 100644--- a/client/src/components/SidePanel/Parameters/DynamicSwitch.tsx+++ b/client/src/components/SidePanel/Parameters/DynamicSwitch.tsx@@ -50,7 +50,7 @@ function DynamicSwitch({<div className="flex justify-between"><LabelhtmlFor={`${settingKey}-dynamic-switch`}- className="text-left text-sm font-medium"+ className="break-words text-left text-sm font-medium">{labelCode ? (localize(label as TranslationKeys) ?? label) : label || settingKey}{' '}{showDefault && (diff --git a/client/src/locales/en/translation.json b/client/src/locales/en/translation.jsonindex 0fcfe0bb42..1e130a0f82 100644--- a/client/src/locales/en/translation.json+++ b/client/src/locales/en/translation.json@@ -233,6 +233,7 @@"com_endpoint_openai_temp": "Higher values = more random, while lower values = more focused and deterministic. We recommend altering this or Top P but not both.","com_endpoint_openai_topp": "An alternative to sampling with temperature, called nucleus sampling, where the model considers the results of the tokens with top_p probability mass. So 0.1 means only the tokens comprising the top 10% probability mass are considered. We recommend altering this or temperature but not both.","com_endpoint_openai_use_responses_api": "Use the Responses API instead of Chat Completions, which includes extended features from OpenAI. Required for o1-pro, o3-pro, and to enable reasoning summaries.",+ "com_endpoint_google_use_search_grounding": "Use Google's search grounding feature to enhance responses with real-time web search results. This enables models to access current information and provide more accurate, up-to-date answers.","com_endpoint_output": "Output","com_endpoint_plug_image_detail": "Image Detail","com_endpoint_plug_resend_files": "Resend Files",@@ -280,6 +281,7 @@"com_endpoint_top_p": "Top P","com_endpoint_use_active_assistant": "Use Active Assistant","com_endpoint_use_responses_api": "Use Responses API",+ "com_endpoint_use_search_grounding": "Grounding with Google Search","com_error_expired_user_key": "Provided key for {{0}} expired at {{1}}. Please provide a new key and try again.","com_error_files_dupe": "Duplicate file detected.","com_error_files_empty": "Empty files are not allowed.",@@ -291,6 +293,7 @@"com_error_heic_conversion": "Failed to convert HEIC image to JPEG. Please try converting the image manually or use a different format.","com_error_input_length": "The latest message token count is too long, exceeding the token limit, or your token limit parameters are misconfigured, adversely affecting the context window. More info: {{0}}. Please shorten your message, adjust the max context size from the conversation parameters, or fork the conversation to continue.","com_error_invalid_agent_provider": "The \"{{0}}\" provider is not available for use with Agents. Please go to your agent's settings and select a currently available provider.",+ "com_error_google_tool_conflict": "Usage of built-in Google tools are not supported with external tools. Please disable either the built-in tools or the external tools.","com_error_invalid_user_key": "Invalid key provided. Please provide a valid key and try again.","com_error_moderation": "It appears that the content submitted has been flagged by our moderation system for not aligning with our community guidelines. We're unable to proceed with this specific topic. If you have any other questions or topics you'd like to explore, please edit your message, or create a new conversation.","com_error_no_base_url": "No base URL found. Please provide one and try again.",diff --git a/package-lock.json b/package-lock.jsonindex 8d04047ef4..7290a012ba 100644--- a/package-lock.json+++ b/package-lock.json@@ -64,7 +64,7 @@"@langchain/google-genai": "^0.2.13","@langchain/google-vertexai": "^0.2.13","@langchain/textsplitters": "^0.1.0",- "@librechat/agents": "^2.4.49",+ "@librechat/agents": "^2.4.50","@librechat/api": "*","@librechat/data-schemas": "*","@node-saml/passport-saml": "^5.0.0",@@ -19436,9 +19436,9 @@}},"node_modules/@librechat/agents": {- "version": "2.4.49",- "resolved": "https://registry.npmjs.org/@librechat/agents/-/agents-2.4.49.tgz",- "integrity": "sha512-Bnp/PZsg1VgnmGS80tW4ssKpcqUZ7xysKesV/8gGaUBF1VDBiYBh0gC6ugfJhltNOv93rEVSucjPlTAuHimNCg==",+ "version": "2.4.50",+ "resolved": "https://registry.npmjs.org/@librechat/agents/-/agents-2.4.50.tgz",+ "integrity": "sha512-8yUndPTa5ctxGBqlzMcyBDi+c6lup37wtXXFJMyBcm2Bx4MhqrEOMdI3HRu/3CsYpRgC07wAK2AwZ593aGLWoA==","license": "MIT","dependencies": {"@langchain/anthropic": "^0.3.23",@@ -46624,7 +46624,7 @@"typescript": "^5.0.4"},"peerDependencies": {- "@librechat/agents": "^2.4.49",+ "@librechat/agents": "^2.4.50","@librechat/data-schemas": "*","@modelcontextprotocol/sdk": "^1.12.3","axios": "^1.8.2",@@ -46717,7 +46717,7 @@},"packages/data-provider": {"name": "librechat-data-provider",- "version": "0.7.89",+ "version": "0.7.899","license": "ISC","dependencies": {"axios": "^1.8.2",diff --git a/packages/api/package.json b/packages/api/package.jsonindex a4c41ec537..8275e35c9c 100644--- a/packages/api/package.json+++ b/packages/api/package.json@@ -69,7 +69,7 @@"registry": "https://registry.npmjs.org/"},"peerDependencies": {- "@librechat/agents": "^2.4.49",+ "@librechat/agents": "^2.4.50","@librechat/data-schemas": "*","@modelcontextprotocol/sdk": "^1.12.3","axios": "^1.8.2",diff --git a/packages/api/src/endpoints/google/llm.ts b/packages/api/src/endpoints/google/llm.tsindex c2c26e3251..e76075f44a 100644--- a/packages/api/src/endpoints/google/llm.ts+++ b/packages/api/src/endpoints/google/llm.ts@@ -1,6 +1,7 @@import { Providers } from '@librechat/agents';import { googleSettings, AuthKeys } from 'librechat-data-provider';import type { GoogleClientOptions, VertexAIClientOptions } from '@librechat/agents';+import type { GoogleAIToolType } from '@langchain/google-common';import type * as t from '~/types';import { isEnabled } from '~/utils';@@ -105,6 +106,7 @@ export function getGoogleConfig(const authHeader = options.authHeader;const {+ grounding,thinking = googleSettings.thinking.default,thinkingBudget = googleSettings.thinkingBudget.default,...modelOptions@@ -187,8 +189,16 @@ export function getGoogleConfig(};}+ const tools: GoogleAIToolType[] = [];++ if (grounding) {+ tools.push({ googleSearch: {} });+ }+// Return the final shapereturn {+ /** @type {GoogleAIToolType[]} */+ tools,/** @type {Providers.GOOGLE | Providers.VERTEXAI} */provider,/** @type {GoogleClientOptions | VertexAIClientOptions} */diff --git a/packages/data-provider/package.json b/packages/data-provider/package.jsonindex cb4e94eb77..90ea975001 100644--- a/packages/data-provider/package.json+++ b/packages/data-provider/package.json@@ -1,6 +1,6 @@{"name": "librechat-data-provider",- "version": "0.7.89",+ "version": "0.7.899","description": "data services for librechat apps","main": "dist/index.js","module": "dist/index.es.js",diff --git a/packages/data-provider/src/config.ts b/packages/data-provider/src/config.tsindex cf69603bf1..7f1b2c8fbe 100644--- a/packages/data-provider/src/config.ts+++ b/packages/data-provider/src/config.ts@@ -1257,6 +1257,10 @@ export enum ErrorTypes {* Google provider returned an error*/GOOGLE_ERROR = 'google_error',+ /**+ * Google provider does not allow custom tools with built-in tools+ */+ GOOGLE_TOOL_CONFLICT = 'google_tool_conflict',/*** Invalid Agent Provider (excluded by Admin)*/diff --git a/packages/data-provider/src/parameterSettings.ts b/packages/data-provider/src/parameterSettings.tsindex 8366987e43..1b28e9cc3c 100644--- a/packages/data-provider/src/parameterSettings.ts+++ b/packages/data-provider/src/parameterSettings.ts@@ -537,6 +537,19 @@ const google: Record<string, SettingDefinition> = {optionType: 'conversation',columnSpan: 2,},+ grounding: {+ key: 'grounding',+ label: 'com_endpoint_use_search_grounding',+ labelCode: true,+ description: 'com_endpoint_google_use_search_grounding',+ descriptionCode: true,+ type: 'boolean',+ default: false,+ component: 'switch',+ optionType: 'model',+ showDefault: false,+ columnSpan: 2,+ },};const googleConfig: SettingsConfiguration = [@@ -550,6 +563,7 @@ const googleConfig: SettingsConfiguration = [librechat.resendFiles,google.thinking,google.thinkingBudget,+ google.grounding,];const googleCol1: SettingsConfiguration = [@@ -567,6 +581,7 @@ const googleCol2: SettingsConfiguration = [librechat.resendFiles,google.thinking,google.thinkingBudget,+ google.grounding,];const openAI: SettingsConfiguration = [diff --git a/packages/data-provider/src/schemas.ts b/packages/data-provider/src/schemas.tsindex 5b654d90bc..de51c35bf2 100644--- a/packages/data-provider/src/schemas.ts+++ b/packages/data-provider/src/schemas.ts@@ -634,6 +634,8 @@ export const tConversationSchema = z.object({reasoning_summary: eReasoningSummarySchema.optional().nullable(),/* OpenAI: use Responses API */useResponsesApi: z.boolean().optional(),+ /* Google: use Search Grounding */+ grounding: z.boolean().optional(),/* assistant */assistant_id: z.string().optional(),/* agents */@@ -736,6 +738,8 @@ export const tQueryParamsSchema = tConversationSchemareasoning_summary: true,/** @endpoints openAI, custom, azureOpenAI */useResponsesApi: true,+ /** @endpoints google */+ grounding: true,/** @endpoints google, anthropic, bedrock */topP: true,/** @endpoints google, anthropic */@@ -818,6 +822,7 @@ export const googleBaseSchema = tConversationSchema.pick({topK: true,thinking: true,thinkingBudget: true,+ grounding: true,iconURL: true,greeting: true,spec: true,@@ -849,6 +854,7 @@ export const googleGenConfigSchema = zthinkingBudget: coerceNumber.optional(),}).optional(),+ grounding: z.boolean().optional(),}).strip().optional();diff --git a/packages/data-schemas/src/types/convo.ts b/packages/data-schemas/src/types/convo.tsindex b97f179b53..1d9ba8749e 100644--- a/packages/data-schemas/src/types/convo.ts+++ b/packages/data-schemas/src/types/convo.ts@@ -47,6 +47,7 @@ export interface IConversation extends Document {reasoning_effort?: string;reasoning_summary?: string;useResponsesApi?: boolean;+ grounding?: boolean;// Additional fieldsfiles?: string[];expiredAt?: Date;