@lobehub/lobehub 2.0.0-next.374 → 2.0.0-next.375

package/CHANGELOG.md

@@ -2,6 +2,31 @@
 
 # Changelog
 
+## [Version 2.0.0-next.375](https://github.com/lobehub/lobe-chat/compare/v2.0.0-next.374...v2.0.0-next.375)
+
+<sup>Released on **2026-01-25**</sup>
+
+#### 🐛 Bug Fixes
+
+- **misc**: Broadcast tools calling and improve auto scroll.
+
+<br/>
+
+<details>
+<summary><kbd>Improvements and Fixes</kbd></summary>
+
+#### What's fixed
+
+- **misc**: Broadcast tools calling and improve auto scroll, closes [#11804](https://github.com/lobehub/lobe-chat/issues/11804) ([c352915](https://github.com/lobehub/lobe-chat/commit/c352915))
+
+</details>
+
+<div align="right">
+
+[![](https://img.shields.io/badge/-BACK_TO_TOP-151515?style=flat-square)](#readme-top)
+
+</div>
+
 ## [Version 2.0.0-next.374](https://github.com/lobehub/lobe-chat/compare/v2.0.0-next.373...v2.0.0-next.374)
 
 <sup>Released on **2026-01-25**</sup>

package/changelog/v1.json

@@ -1,4 +1,13 @@
 [
+  {
+    "children": {
+      "fixes": [
+        "Broadcast tools calling and improve auto scroll."
+      ]
+    },
+    "date": "2026-01-25",
+    "version": "2.0.0-next.375"
+  },
   {
     "children": {
       "features": [

package/locales/en-US/chat.json

@@ -36,7 +36,7 @@
   "compression.summary": "Summary",
   "confirmClearCurrentMessages": "You are about to clear the current session messages. Once cleared, they cannot be retrieved. Please confirm your action.",
   "confirmRemoveChatGroupItemAlert": "This Group will be deleted. Group-specific assistants will also be deleted, while external assistants will not be affected.",
-  "confirmRemoveGroupItemAlert": "You are about to delete this group. After deletion, its agents will be moved to the default list. Please confirm your action.",
+  "confirmRemoveGroupItemAlert": "You are about to delete this category. After deletion, its agents will be moved to the default list. Please confirm your action.",
   "confirmRemoveGroupSuccess": "Group deleted successfully",
   "confirmRemoveSessionItemAlert": "You are about to delete this agent. Once deleted, it cannot be retrieved. Please confirm your action.",
   "confirmRemoveSessionSuccess": "Agent removed successfully",
@@ -239,28 +239,28 @@
   "searchAgents": "Search agents...",
   "selectedAgents": "Selected agents",
   "sendPlaceholder": "Ask, create, or start a task, <hotkey><hotkey/>",
-  "sessionGroup.config": "Group Management",
-  "sessionGroup.confirmRemoveGroupAlert": "This group is about to be deleted. After deletion, the agents in this group will be moved to the default list. Please confirm your operation.",
+  "sessionGroup.config": "Category Management",
+  "sessionGroup.confirmRemoveGroupAlert": "This category is about to be deleted. After deletion, the agents in this category will be moved to the default list. Please confirm your operation.",
   "sessionGroup.createAgentSuccess": "Agent created successfully",
-  "sessionGroup.createGroup": "Add New Group",
-  "sessionGroup.createGroupFailed": "Failed to create group chat",
-  "sessionGroup.createGroupSuccess": "Group chat created successfully",
+  "sessionGroup.createGroup": "Add New Category",
+  "sessionGroup.createGroupFailed": "Failed to create category",
+  "sessionGroup.createGroupSuccess": "Category created successfully",
   "sessionGroup.createSuccess": "Created successfully",
   "sessionGroup.creatingAgent": "Creating agent...",
-  "sessionGroup.groupName": "Group Name",
-  "sessionGroup.inputPlaceholder": "Please enter group name...",
-  "sessionGroup.moveGroup": "Move to Group",
-  "sessionGroup.newGroup": "New Group",
+  "sessionGroup.groupName": "Category Name",
+  "sessionGroup.inputPlaceholder": "Please enter category name...",
+  "sessionGroup.moveGroup": "Move to Category",
+  "sessionGroup.newGroup": "New Category",
   "sessionGroup.noAvailableAgents": "No available agents",
   "sessionGroup.noMatchingAgents": "No matching agents found",
   "sessionGroup.noSelectedAgents": "Please select agents",
-  "sessionGroup.rename": "Rename Group",
+  "sessionGroup.rename": "Rename Category",
   "sessionGroup.renameSuccess": "Renamed successfully",
   "sessionGroup.searchAgents": "Search agents",
   "sessionGroup.selectedAgents": "Selected agents ({{count}})",
   "sessionGroup.sortSuccess": "Reorder successful",
-  "sessionGroup.sorting": "Group sorting updating...",
-  "sessionGroup.tooLong": "Group name length should be between 1-20",
+  "sessionGroup.sorting": "Category sorting updating...",
+  "sessionGroup.tooLong": "Category name length should be between 1-20",
   "shareModal.copy": "Copy",
   "shareModal.copyLink": "Copy Link",
   "shareModal.copyLinkSuccess": "Link copied",

package/locales/zh-CN/chat.json

@@ -36,7 +36,7 @@
   "compression.summary": "摘要",
   "confirmClearCurrentMessages": "确认清空当前会话消息吗？清空后无法恢复",
   "confirmRemoveChatGroupItemAlert": "确认删除该群组吗？群组专有助理将会被同样删除，外部助理不受影响",
-  "confirmRemoveGroupItemAlert": "确认删除该分组吗？分组内的助理会移回默认列表",
+  "confirmRemoveGroupItemAlert": "确认删除该分类吗？分类内的助理会移回默认列表",
   "confirmRemoveGroupSuccess": "群组已删除",
   "confirmRemoveSessionItemAlert": "确认删除该助理吗？删除后无法恢复",
   "confirmRemoveSessionSuccess": "助理已删除",
@@ -239,28 +239,28 @@
   "searchAgents": "搜索助理…",
   "selectedAgents": "已选助理",
   "sendPlaceholder": "从任何想法开始… <hotkey><hotkey/>",
-  "sessionGroup.config": "分组管理",
-  "sessionGroup.confirmRemoveGroupAlert": "确认删除该分组吗？分组内的助理会移回默认列表",
+  "sessionGroup.config": "分类管理",
+  "sessionGroup.confirmRemoveGroupAlert": "确认删除该分类吗？分类内的助理会移回默认列表",
   "sessionGroup.createAgentSuccess": "助理创建成功",
-  "sessionGroup.createGroup": "添加新分组",
-  "sessionGroup.createGroupFailed": "群组创建失败",
-  "sessionGroup.createGroupSuccess": "群组创建成功",
-  "sessionGroup.createSuccess": "分组创建成功",
+  "sessionGroup.createGroup": "添加新分类",
+  "sessionGroup.createGroupFailed": "分类创建失败",
+  "sessionGroup.createGroupSuccess": "分类创建成功",
+  "sessionGroup.createSuccess": "分类创建成功",
   "sessionGroup.creatingAgent": "正在创建助理…",
-  "sessionGroup.groupName": "分组名称",
-  "sessionGroup.inputPlaceholder": "请输入分组名称…",
-  "sessionGroup.moveGroup": "移动到分组",
-  "sessionGroup.newGroup": "新分组",
+  "sessionGroup.groupName": "分类名称",
+  "sessionGroup.inputPlaceholder": "请输入分类名称…",
+  "sessionGroup.moveGroup": "移动到分类",
+  "sessionGroup.newGroup": "新分类",
   "sessionGroup.noAvailableAgents": "暂无可用助理",
   "sessionGroup.noMatchingAgents": "未找到匹配的助理",
   "sessionGroup.noSelectedAgents": "请选择助理",
-  "sessionGroup.rename": "重命名分组",
+  "sessionGroup.rename": "重命名分类",
   "sessionGroup.renameSuccess": "重命名成功",
   "sessionGroup.searchAgents": "搜索助理",
   "sessionGroup.selectedAgents": "已选助理（{{count}}）",
   "sessionGroup.sortSuccess": "排序已更新",
-  "sessionGroup.sorting": "正在更新排序…",
-  "sessionGroup.tooLong": "分组名称长度需为 1–20 个字符",
+  "sessionGroup.sorting": "正在更新分类排序…",
+  "sessionGroup.tooLong": "分类名称长度需为 1–20 个字符",
   "shareModal.copy": "复制",
   "shareModal.copyLink": "复制链接",
   "shareModal.copyLinkSuccess": "链接已复制",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lobehub/lobehub",
-  "version": "2.0.0-next.374",
+  "version": "2.0.0-next.375",
   "description": "LobeHub - an open-source,comprehensive AI Agent framework that supports speech synthesis, multimodal, and extensible Function Call plugin system. Supports one-click free deployment of your private ChatGPT/LLM web application.",
   "keywords": [
     "framework",

package/packages/builtin-tool-group-agent-builder/src/ExecutionRuntime/index.ts

@@ -256,13 +256,15 @@ export class GroupAgentBuilderExecutionRuntime {
 
       // Check if agent is already in the group
       const existingAgents = group.agents || [];
-      const isAlreadyInGroup = existingAgents.some((a) => a.id === args.agentId);
+      const existingAgent = existingAgents.find((a) => a.id === args.agentId);
 
-      if (isAlreadyInGroup) {
+      if (existingAgent) {
         return {
-          content: `Agent ${args.agentId} is already in the group`,
+          content: `Agent ${existingAgent.title || args.agentId} is already in the group`,
           state: {
+            agentAvatar: existingAgent.avatar,
             agentId: args.agentId,
+            agentName: existingAgent.title,
             success: false,
           } as InviteAgentState,
           success: false,
@@ -277,12 +279,22 @@ export class GroupAgentBuilderExecutionRuntime {
 
       const wasAdded = result.added.length > 0;
 
+      // Get the agent info from the updated group
+      const updatedGroup = agentGroupSelectors.getGroupById(groupId)(getChatGroupStoreState());
+      const addedAgent = updatedGroup?.agents?.find((a) => a.id === args.agentId);
+      const agentName = addedAgent?.title;
+      const agentAvatar = addedAgent?.avatar;
+
+      const agentDisplay = agentName ? `${agentName} (ID: ${args.agentId})` : args.agentId;
+
       return {
         content: wasAdded
-          ? `Successfully invited agent ${args.agentId} to the group`
-          : `Agent ${args.agentId} was already in the group`,
+          ? `Successfully invited agent ${agentDisplay} to the group`
+          : `Agent ${agentDisplay} was already in the group`,
         state: {
+          agentAvatar,
           agentId: args.agentId,
+          agentName,
           success: wasAdded,
         } as InviteAgentState,
         success: wasAdded,
@@ -315,9 +327,9 @@ export class GroupAgentBuilderExecutionRuntime {
 
       // Check if agent is in the group
       const existingAgents = group.agents || [];
-      const isInGroup = existingAgents.some((a) => a.id === args.agentId);
+      const agent = existingAgents.find((a) => a.id === args.agentId);
 
-      if (!isInGroup) {
+      if (!agent) {
         return {
           content: `Agent ${args.agentId} is not in the group`,
           state: {
@@ -328,12 +340,20 @@ export class GroupAgentBuilderExecutionRuntime {
         };
       }
 
+      // Get agent info before removing
+      const agentName = agent.title;
+      const agentAvatar = agent.avatar;
+
+      const agentDisplay = agentName ? `${agentName} (ID: ${args.agentId})` : args.agentId;
+
       // Check if this is the supervisor agent (cannot be removed)
       if (group.supervisorAgentId === args.agentId) {
         return {
-          content: `Cannot remove supervisor agent ${args.agentId} from the group`,
+          content: `Cannot remove supervisor agent ${agentDisplay} from the group`,
           state: {
+            agentAvatar,
             agentId: args.agentId,
+            agentName,
             success: false,
           } as RemoveAgentState,
           success: false,
@@ -347,9 +367,11 @@ export class GroupAgentBuilderExecutionRuntime {
       await state.refreshGroupDetail(groupId);
 
       return {
-        content: `Successfully removed agent ${args.agentId} from the group`,
+        content: `Successfully removed agent ${agentDisplay} from the group`,
         state: {
+          agentAvatar,
           agentId: args.agentId,
+          agentName,
           success: true,
         } as RemoveAgentState,
         success: true,

package/packages/builtin-tool-group-agent-builder/src/client/Inspector/InviteAgent/index.tsx

@@ -1,19 +1,31 @@
 'use client';
 
 import type { BuiltinInspectorProps } from '@lobechat/types';
+import { Avatar, Flexbox } from '@lobehub/ui';
 import { createStaticStyles, cssVar, cx } from 'antd-style';
 import { Check } from 'lucide-react';
 import { memo } from 'react';
 import { useTranslation } from 'react-i18next';
 
-import { highlightTextStyles, inspectorTextStyles, shinyTextStyles } from '@/styles';
+import { shinyTextStyles } from '@/styles';
 
 import type { InviteAgentParams, InviteAgentState } from '../../../types';
 
-const styles = createStaticStyles(({ css }) => ({
+const styles = createStaticStyles(({ css, cssVar: cv }) => ({
+  root: css`
+    overflow: hidden;
+    display: flex;
+    gap: 8px;
+    align-items: center;
+  `,
   statusIcon: css`
+    flex-shrink: 0;
     margin-block-end: -2px;
-    margin-inline-start: 4px;
+  `,
+  title: css`
+    flex-shrink: 0;
+    color: ${cv.colorTextSecondary};
+    white-space: nowrap;
   `,
 }));
 
@@ -24,11 +36,12 @@ export const InviteAgentInspector = memo<
 
   const agentId = args?.agentId || partialArgs?.agentId;
   const displayName = pluginState?.agentName || agentId;
+  const avatar = pluginState?.agentAvatar;
 
   // Initial streaming state
   if (isArgumentsStreaming && !agentId) {
     return (
-      <div className={cx(inspectorTextStyles.root, shinyTextStyles.shinyText)}>
+      <div className={cx(styles.root, shinyTextStyles.shinyText)}>
         <span>{t('builtins.lobe-group-agent-builder.apiName.inviteAgent')}</span>
       </div>
     );
@@ -37,18 +50,21 @@ export const InviteAgentInspector = memo<
   const isSuccess = pluginState?.success;
 
   return (
-    <div
-      className={cx(
-        inspectorTextStyles.root,
-        (isArgumentsStreaming || isLoading) && shinyTextStyles.shinyText,
-      )}
+    <Flexbox
+      align={'center'}
+      className={cx(styles.root, (isArgumentsStreaming || isLoading) && shinyTextStyles.shinyText)}
+      gap={8}
+      horizontal
     >
-      <span>{t('builtins.lobe-group-agent-builder.apiName.inviteAgent')}: </span>
-      {displayName && <span className={highlightTextStyles.primary}>{displayName}</span>}
+      <span className={styles.title}>
+        {t('builtins.lobe-group-agent-builder.apiName.inviteAgent')}:
+      </span>
+      {avatar && <Avatar avatar={avatar} shape={'square'} size={20} title={displayName || undefined} />}
+      {displayName && <span>{displayName}</span>}
       {!isLoading && isSuccess && (
         <Check className={styles.statusIcon} color={cssVar.colorSuccess} size={14} />
       )}
-    </div>
+    </Flexbox>
   );
 });
 

package/packages/builtin-tool-group-agent-builder/src/client/Inspector/RemoveAgent/index.tsx

@@ -1,19 +1,31 @@
 'use client';
 
 import type { BuiltinInspectorProps } from '@lobechat/types';
+import { Avatar, Flexbox } from '@lobehub/ui';
 import { createStaticStyles, cssVar, cx } from 'antd-style';
 import { Check } from 'lucide-react';
 import { memo } from 'react';
 import { useTranslation } from 'react-i18next';
 
-import { highlightTextStyles, inspectorTextStyles, shinyTextStyles } from '@/styles';
+import { shinyTextStyles } from '@/styles';
 
 import type { RemoveAgentParams, RemoveAgentState } from '../../../types';
 
-const styles = createStaticStyles(({ css }) => ({
+const styles = createStaticStyles(({ css, cssVar: cv }) => ({
+  root: css`
+    overflow: hidden;
+    display: flex;
+    gap: 8px;
+    align-items: center;
+  `,
   statusIcon: css`
+    flex-shrink: 0;
     margin-block-end: -2px;
-    margin-inline-start: 4px;
+  `,
+  title: css`
+    flex-shrink: 0;
+    color: ${cv.colorTextSecondary};
+    white-space: nowrap;
   `,
 }));
 
@@ -24,11 +36,12 @@ export const RemoveAgentInspector = memo<
 
   const agentId = args?.agentId || partialArgs?.agentId;
   const displayName = pluginState?.agentName || agentId;
+  const avatar = pluginState?.agentAvatar;
 
   // Initial streaming state
   if (isArgumentsStreaming && !agentId) {
     return (
-      <div className={cx(inspectorTextStyles.root, shinyTextStyles.shinyText)}>
+      <div className={cx(styles.root, shinyTextStyles.shinyText)}>
         <span>{t('builtins.lobe-group-agent-builder.apiName.removeAgent')}</span>
       </div>
     );
@@ -37,18 +50,21 @@ export const RemoveAgentInspector = memo<
   const isSuccess = pluginState?.success;
 
   return (
-    <div
-      className={cx(
-        inspectorTextStyles.root,
-        (isArgumentsStreaming || isLoading) && shinyTextStyles.shinyText,
-      )}
+    <Flexbox
+      align={'center'}
+      className={cx(styles.root, (isArgumentsStreaming || isLoading) && shinyTextStyles.shinyText)}
+      gap={8}
+      horizontal
     >
-      <span>{t('builtins.lobe-group-agent-builder.apiName.removeAgent')}: </span>
-      {displayName && <span className={highlightTextStyles.primary}>{displayName}</span>}
+      <span className={styles.title}>
+        {t('builtins.lobe-group-agent-builder.apiName.removeAgent')}:
+      </span>
+      {avatar && <Avatar avatar={avatar} shape={'square'} size={20} title={displayName || undefined} />}
+      {displayName && <span>{displayName}</span>}
       {!isLoading && isSuccess && (
         <Check className={styles.statusIcon} color={cssVar.colorSuccess} size={14} />
       )}
-    </div>
+    </Flexbox>
   );
 });
 

package/packages/builtin-tool-group-agent-builder/src/types.ts

@@ -265,6 +265,10 @@ export interface CreateAgentState {
 }
 
 export interface InviteAgentState {
+  /**
+   * Agent avatar (emoji or URL)
+   */
+  agentAvatar?: string;
   /**
    * Agent identifier that was invited
    */
@@ -280,6 +284,10 @@ export interface InviteAgentState {
 }
 
 export interface RemoveAgentState {
+  /**
+   * Agent avatar (emoji or URL)
+   */
+  agentAvatar?: string;
   /**
    * Agent identifier that was removed
    */

package/packages/context-engine/src/engine/tools/ToolsEngine.ts

@@ -53,17 +53,20 @@ export class ToolsEngine {
    * @returns Processed tools array, or undefined if tools should not be enabled
    */
   generateTools(params: GenerateToolsParams): UniformTool[] | undefined {
-    const { toolIds = [], model, provider, context } = params;
+    const { toolIds = [], model, provider, context, skipDefaultTools } = params;
 
-    // Merge user-provided tool IDs with default tool IDs
-    const allToolIds = [...new Set([...toolIds, ...this.defaultToolIds])];
+    // Merge user-provided tool IDs with default tool IDs (unless skipDefaultTools is true)
+    const allToolIds = skipDefaultTools
+      ? toolIds
+      : [...new Set([...toolIds, ...this.defaultToolIds])];
 
     log(
-      'Generating tools for model=%s, provider=%s, pluginIds=%o (includes %d default tools)',
+      'Generating tools for model=%s, provider=%s, pluginIds=%o (skipDefaultTools=%s, includes %d default tools)',
       model,
       provider,
       allToolIds,
-      this.defaultToolIds.length,
+      skipDefaultTools,
+      skipDefaultTools ? 0 : this.defaultToolIds.length,
     );
 
     // 1. Check if model supports Function Calling
@@ -94,17 +97,20 @@ export class ToolsEngine {
    * @returns Detailed tools generation result
    */
   generateToolsDetailed(params: GenerateToolsParams): ToolsGenerationResult {
-    const { toolIds = [], model, provider, context } = params;
+    const { toolIds = [], model, provider, context, skipDefaultTools } = params;
 
-    // Merge user-provided tool IDs with default tool IDs and deduplicate
-    const allToolIds = [...new Set([...toolIds, ...this.defaultToolIds])];
+    // Merge user-provided tool IDs with default tool IDs and deduplicate (unless skipDefaultTools is true)
+    const allToolIds = skipDefaultTools
+      ? toolIds
+      : [...new Set([...toolIds, ...this.defaultToolIds])];
 
     log(
-      'Generating detailed tools for model=%s, provider=%s, pluginIds=%o (includes %d default tools)',
+      'Generating detailed tools for model=%s, provider=%s, pluginIds=%o (skipDefaultTools=%s, includes %d default tools)',
       model,
       provider,
       allToolIds,
-      this.defaultToolIds.length,
+      skipDefaultTools,
+      skipDefaultTools ? 0 : this.defaultToolIds.length,
     );
 
     // Check if model supports Function Calling

package/packages/context-engine/src/engine/tools/__tests__/ToolsEngine.test.ts

@@ -1135,4 +1135,146 @@ describe('ToolsEngine', () => {
       expect(result).toHaveLength(2);
     });
   });
+
+  describe('skipDefaultTools', () => {
+    it('should not include default tools when skipDefaultTools is true in generateTools', () => {
+      const engine = new ToolsEngine({
+        manifestSchemas: [mockWebBrowsingManifest, mockDalleManifest],
+        defaultToolIds: ['lobe-web-browsing'],
+        enableChecker: () => true,
+        functionCallChecker: () => true,
+      });
+
+      const result = engine.generateTools({
+        toolIds: ['dalle'],
+        model: 'gpt-4',
+        provider: 'openai',
+        skipDefaultTools: true,
+      });
+
+      // Should only include dalle, not the default lobe-web-browsing
+      expect(result).toHaveLength(1);
+      expect(result![0].function.name).toBe('dalle____generateImage____builtin');
+    });
+
+    it('should not include default tools when skipDefaultTools is true in generateToolsDetailed', () => {
+      const engine = new ToolsEngine({
+        manifestSchemas: [mockWebBrowsingManifest, mockDalleManifest],
+        defaultToolIds: ['lobe-web-browsing'],
+        enableChecker: () => true,
+        functionCallChecker: () => true,
+      });
+
+      const result = engine.generateToolsDetailed({
+        toolIds: ['dalle'],
+        model: 'gpt-4',
+        provider: 'openai',
+        skipDefaultTools: true,
+      });
+
+      // Should only include dalle, not the default lobe-web-browsing
+      expect(result.tools).toHaveLength(1);
+      expect(result.enabledToolIds).toEqual(['dalle']);
+      expect(result.enabledManifests).toHaveLength(1);
+      expect(result.enabledManifests[0].identifier).toBe('dalle');
+    });
+
+    it('should return undefined when skipDefaultTools is true and toolIds is empty', () => {
+      const engine = new ToolsEngine({
+        manifestSchemas: [mockWebBrowsingManifest, mockDalleManifest],
+        defaultToolIds: ['lobe-web-browsing', 'dalle'],
+        enableChecker: () => true,
+        functionCallChecker: () => true,
+      });
+
+      const result = engine.generateTools({
+        toolIds: [],
+        model: 'gpt-4',
+        provider: 'openai',
+        skipDefaultTools: true,
+      });
+
+      // Should return undefined when no tools are available
+      expect(result).toBeUndefined();
+    });
+
+    it('should return empty results when skipDefaultTools is true and toolIds is empty in generateToolsDetailed', () => {
+      const engine = new ToolsEngine({
+        manifestSchemas: [mockWebBrowsingManifest, mockDalleManifest],
+        defaultToolIds: ['lobe-web-browsing', 'dalle'],
+        enableChecker: () => true,
+        functionCallChecker: () => true,
+      });
+
+      const result = engine.generateToolsDetailed({
+        toolIds: [],
+        model: 'gpt-4',
+        provider: 'openai',
+        skipDefaultTools: true,
+      });
+
+      // Should return empty results
+      expect(result.tools).toBeUndefined();
+      expect(result.enabledToolIds).toEqual([]);
+      expect(result.enabledManifests).toHaveLength(0);
+    });
+
+    it('should include default tools when skipDefaultTools is false', () => {
+      const engine = new ToolsEngine({
+        manifestSchemas: [mockWebBrowsingManifest, mockDalleManifest],
+        defaultToolIds: ['lobe-web-browsing'],
+        enableChecker: () => true,
+        functionCallChecker: () => true,
+      });
+
+      const result = engine.generateTools({
+        toolIds: ['dalle'],
+        model: 'gpt-4',
+        provider: 'openai',
+        skipDefaultTools: false,
+      });
+
+      // Should include both dalle and the default lobe-web-browsing
+      expect(result).toHaveLength(2);
+    });
+
+    it('should include default tools when skipDefaultTools is undefined (default behavior)', () => {
+      const engine = new ToolsEngine({
+        manifestSchemas: [mockWebBrowsingManifest, mockDalleManifest],
+        defaultToolIds: ['lobe-web-browsing'],
+        enableChecker: () => true,
+        functionCallChecker: () => true,
+      });
+
+      const result = engine.generateTools({
+        toolIds: ['dalle'],
+        model: 'gpt-4',
+        provider: 'openai',
+        // skipDefaultTools not specified
+      });
+
+      // Should include both dalle and the default lobe-web-browsing
+      expect(result).toHaveLength(2);
+    });
+
+    it('should work correctly with empty defaultToolIds', () => {
+      const engine = new ToolsEngine({
+        manifestSchemas: [mockWebBrowsingManifest, mockDalleManifest],
+        defaultToolIds: [],
+        enableChecker: () => true,
+        functionCallChecker: () => true,
+      });
+
+      const result = engine.generateTools({
+        toolIds: ['dalle'],
+        model: 'gpt-4',
+        provider: 'openai',
+        skipDefaultTools: true,
+      });
+
+      // Should only include dalle
+      expect(result).toHaveLength(1);
+      expect(result![0].function.name).toBe('dalle____generateImage____builtin');
+    });
+  });
 });

package/packages/context-engine/src/engine/tools/types.ts

@@ -72,6 +72,12 @@ export interface GenerateToolsParams {
   model: string;
   /** Provider name */
   provider: string;
+  /**
+   * Whether to skip merging default tools.
+   * When true, only the explicitly provided toolIds will be used.
+   * Useful for broadcast scenarios where tools should be completely disabled.
+   */
+  skipDefaultTools?: boolean;
   /** List of tool IDs to enable */
   toolIds?: string[];
 }