feat(tool): add opt-in zvec-grep search tool

.gitignore

@@ -137,6 +137,7 @@ tmp/
 # code graph skills
 .venv
 .codegraph
+.zvec-grep/
 .qwen/computer-use/installed.json
 # Auto-generated computer-use marker can also appear under nested packages.
 **/.qwen/computer-use/

packages/cli/src/config/config.test.ts

@@ -21,7 +21,7 @@ import {
   SessionIdConflictError,
   type CliArgs,
 } from './config.js';
-import type { Settings } from './settings.js';
+import { LoadedSettings, SettingScope, type Settings } from './settings.js';
 import * as ServerConfig from '@qwen-code/qwen-code-core';
 import { isWorkspaceTrusted } from './trustedFolders.js';
 import { resetMcpApprovalsForTesting } from './mcpApprovals.js';
@@ -2546,6 +2546,53 @@ describe('mergeExcludeTools', () => {
     expect(config.getPermissionsDeny()).toContain('tool_search');
   });
 
+  it('should leave zvec_grep disabled by default', async () => {
+    process.argv = ['node', 'script.js'];
+    const argv = await parseArguments();
+    const settings: Settings = {};
+    const config = await loadCliConfig(settings, argv, undefined, []);
+    expect(config.isZvecGrepEnabled()).toBe(false);
+  });
+
+  it('should enable zvec_grep when tools.zvecGrep.enabled is true', async () => {
+    process.argv = ['node', 'script.js'];
+    const argv = await parseArguments();
+    const settings: Settings = {
+      tools: { zvecGrep: { enabled: true } },
+    };
+    const config = await loadCliConfig(settings, argv, undefined, []);
+    expect(config.isZvecGrepEnabled()).toBe(true);
+  });
+
+  it('should persist the zvec_grep workspace opt-out', async () => {
+    vi.mocked(isWorkspaceTrusted).mockReturnValue({
+      isTrusted: true,
+      source: 'file',
+    });
+    const setValue = vi
+      .spyOn(LoadedSettings.prototype, 'setValue')
+      .mockImplementation(() => {});
+    process.argv = ['node', 'script.js'];
+    const argv = await parseArguments();
+    const settings: Settings = {
+      tools: { zvecGrep: { enabled: true } },
+    };
+    try {
+      const config = await loadCliConfig(settings, argv, undefined, []);
+
+      expect(config.canDisableZvecGrepForWorkspace()).toBe(true);
+      await config.disableZvecGrepForWorkspace();
+
+      expect(setValue).toHaveBeenCalledWith(
+        SettingScope.Workspace,
+        'tools.zvecGrep.enabled',
+        false,
+      );
+    } finally {
+      setValue.mockRestore();
+    }
+  });
+
   it('should auto-disable tool_search for deepseek-v4 models', async () => {
     process.argv = ['node', 'script.js', '--model', 'deepseek-v4-flash'];
     const argv = await parseArguments();

packages/cli/src/config/config.ts

@@ -2110,6 +2110,16 @@ export async function loadCliConfig(
       disabledSlashCommands.length > 0 ? disabledSlashCommands : undefined,
     disabledSkillNamesProvider:
       bareMode || safeMode ? undefined : disabledSkillNamesProvider,
+    zvecGrepEnabled:
+      bareMode || safeMode ? false : settings.tools?.zvecGrep?.enabled === true,
+    onDisableZvecGrepForWorkspace: async () => {
+      const currentSettings = loadSettings(cwd);
+      currentSettings.setValue(
+        SettingScope.Workspace,
+        'tools.zvecGrep.enabled',
+        false,
+      );
+    },
     terminalImageRenderSupportProvider: interactive
       ? async () => {
           const { getTerminalImageRenderSupport } = await import(

packages/cli/src/config/settingsSchema.ts

@@ -2521,6 +2521,27 @@ const SETTINGS_SCHEMA = {
           },
         },
       },
+      zvecGrep: {
+        type: 'object',
+        label: 'Zvec Grep',
+        category: 'Tools',
+        requiresRestart: true,
+        default: {},
+        description: 'Settings for the zvec-grep built-in search tool.',
+        showInDialog: false,
+        properties: {
+          enabled: {
+            type: 'boolean',
+            label: 'Enable Zvec Grep',
+            category: 'Tools',
+            requiresRestart: true,
+            default: false,
+            description:
+              'When enabled, registers the zvec_grep built-in tool. Disabled by default.',
+            showInDialog: false,
+          },
+        },
+      },
       shell: {
         type: 'object',
         label: 'Shell',

packages/cli/src/i18n/locales/en.js

@@ -182,6 +182,7 @@ export default {
   'toolDisplayName.ReadFile': 'toolDisplayName.ReadFile',
   'toolDisplayName.ZoomImage': 'toolDisplayName.ZoomImage',
   'toolDisplayName.Grep': 'toolDisplayName.Grep',
+  'toolDisplayName.ZvecGrep': 'toolDisplayName.ZvecGrep',
   'toolDisplayName.Glob': 'toolDisplayName.Glob',
   'toolDisplayName.Shell': 'toolDisplayName.Shell',
   'toolDisplayName.Shell Command': 'toolDisplayName.Shell Command',

packages/cli/src/i18n/locales/zh-TW.js

@@ -173,6 +173,7 @@ export default {
   'toolDisplayName.ReadFile': '讀取檔案',
   'toolDisplayName.ZoomImage': '縮放圖像',
   'toolDisplayName.Grep': 'Grep',
+  'toolDisplayName.ZvecGrep': '語義搜尋',
   'toolDisplayName.Glob': 'Glob',
   'toolDisplayName.Shell': '運行命令',
   'toolDisplayName.Shell Command': 'Shell 命令',

packages/cli/src/i18n/locales/zh.js

@@ -174,6 +174,7 @@ export default {
   'toolDisplayName.ReadFile': '读取文件',
   'toolDisplayName.ZoomImage': '缩放图像',
   'toolDisplayName.Grep': 'Grep',
+  'toolDisplayName.ZvecGrep': '语义搜索',
   'toolDisplayName.Glob': 'Glob',
   'toolDisplayName.Shell': '运行命令',
   'toolDisplayName.Shell Command': 'Shell 命令',

packages/cli/src/ui/components/messages/AskUserQuestionDialog.test.tsx

@@ -173,6 +173,22 @@ describe('<AskUserQuestionDialog />', () => {
       expect(lastFrame()).toContain('Type something...');
     });
 
+    it('hides custom input when the question only supports fixed choices', () => {
+      const details = createConfirmationDetails({
+        questions: [createSingleQuestion({ allowCustomInput: false })],
+      });
+      const onConfirm = vi.fn();
+
+      const { lastFrame } = renderWithProviders(
+        <AskUserQuestionDialog
+          confirmationDetails={details}
+          onConfirm={onConfirm}
+        />,
+      );
+
+      expect(lastFrame()).not.toContain('Type something...');
+    });
+
     it('renders help text for single select', () => {
       const details = createConfirmationDetails();
       const onConfirm = vi.fn();

packages/cli/src/ui/components/messages/AskUserQuestionDialog.tsx

@@ -88,13 +88,17 @@ export const AskUserQuestionDialog: React.FC<AskUserQuestionDialogProps> = ({
     ? null
     : confirmationDetails.questions[currentQuestionIndex];
   const isMultiSelect = currentQuestion?.multiSelect ?? false;
+  const allowCustomInput = currentQuestion?.allowCustomInput !== false;
   // Options + custom input ("Other")
-  const totalOptions = currentQuestion ? currentQuestion.options.length + 1 : 2;
+  const totalOptions = currentQuestion
+    ? currentQuestion.options.length + (allowCustomInput ? 1 : 0)
+    : 2;
 
   // Check if the custom input option is selected
   const isCustomInputSelected =
     !isSubmitTab &&
     currentQuestion &&
+    allowCustomInput &&
     selectedIndex === currentQuestion.options.length;
 
   const getCustomInputValue = (idx: number) =>
@@ -103,6 +107,7 @@ export const AskUserQuestionDialog: React.FC<AskUserQuestionDialogProps> = ({
   const isCustomInputAnswer =
     !isSubmitTab &&
     currentQuestion &&
+    allowCustomInput &&
     !isMultiSelect &&
     selectedOptions[currentQuestionIndex] !== undefined &&
     !currentQuestion.options.some(
@@ -331,7 +336,10 @@ export const AskUserQuestionDialog: React.FC<AskUserQuestionDialogProps> = ({
         // Handle multi-select: Enter advances to next question / submits
         if (isMultiSelect && currentQuestion) {
           // Custom input is handled by TextInput's onSubmit
-          if (selectedIndex === currentQuestion.options.length) {
+          if (
+            allowCustomInput &&
+            selectedIndex === currentQuestion.options.length
+          ) {
             return;
           }
           handleMultiSelectSubmit();
@@ -523,7 +531,10 @@ export const AskUserQuestionDialog: React.FC<AskUserQuestionDialogProps> = ({
         })}
 
         {/* Type something option/input */}
-        <Box flexDirection="column">
+        <Box
+          flexDirection="column"
+          display={allowCustomInput ? 'flex' : 'none'}
+        >
           {isCustomInputSelected ? (
             // Inline TextInput replaces the option text
             <Box>

packages/core/src/config/config.test.ts

@@ -8542,6 +8542,34 @@ describe('setApprovalMode with folder trust', () => {
       vi.clearAllMocks();
     });
 
+    it('should not register zvec-grep tool by default', async () => {
+      const config = new Config({ ...baseParams, useRipgrep: false });
+      await config.initialize();
+
+      const calls = (ToolRegistry.prototype.registerFactory as Mock).mock.calls;
+      const zvecGrepRegistrations = calls.filter(
+        (call) => call[0] === ToolNames.ZVEC_GREP,
+      );
+
+      expect(zvecGrepRegistrations.length).toBe(0);
+    });
+
+    it('should register zvec-grep tool when enabled', async () => {
+      const config = new Config({
+        ...baseParams,
+        useRipgrep: false,
+        zvecGrepEnabled: true,
+      });
+      await config.initialize();
+
+      const calls = (ToolRegistry.prototype.registerFactory as Mock).mock.calls;
+      const zvecGrepRegistrations = calls.filter(
+        (call) => call[0] === ToolNames.ZVEC_GREP,
+      );
+
+      expect(zvecGrepRegistrations.length).toBe(1);
+    });
+
     it('registers the background-agent roster tool', async () => {
       const config = new Config(baseParams);
       await config.initialize();

packages/core/src/config/config.ts

@@ -967,6 +967,9 @@ export interface ConfigParameters {
    * Names returned must be lower-cased; consumers compare case-insensitively.
    */
   disabledSkillNamesProvider?: () => ReadonlySet<string>;
+  zvecGrepEnabled?: boolean;
+  /** Persists a workspace-scoped opt-out selected from zvec-grep setup. */
+  onDisableZvecGrepForWorkspace?: () => Promise<void>;
   terminalImageRenderSupportProvider?: () => Promise<TerminalImageRenderSupport>;
   /**
    * Skill discovery levels that should not be loaded. Sourced from
@@ -1813,6 +1816,7 @@ export class Config {
   private readonly disabledSkillNamesProvider:
     | (() => ReadonlySet<string>)
     | null;
+  private readonly zvecGrepEnabled: boolean;
   private readonly terminalImageRenderSupportProvider:
     | (() => Promise<TerminalImageRenderSupport>)
     | null;
@@ -2022,6 +2026,7 @@ export class Config {
     ruleType: 'allow' | 'ask' | 'deny',
     rule: string,
   ) => Promise<void>;
+  private readonly onDisableZvecGrepForWorkspaceCallback?: () => Promise<void>;
   private initialized: boolean = false;
   private initializationPromise?: Promise<void>;
   private initializationSucceeded = false;
@@ -2132,6 +2137,7 @@ export class Config {
       ...(params.disabledSlashCommands ?? []),
     ]);
     this.disabledSkillNamesProvider = params.disabledSkillNamesProvider ?? null;
+    this.zvecGrepEnabled = params.zvecGrepEnabled ?? false;
     this.terminalImageRenderSupportProvider =
       params.terminalImageRenderSupportProvider ?? null;
     this.disabledSkillLevels = new Set(params.disabledSkillLevels ?? []);
@@ -2303,6 +2309,8 @@ export class Config {
     this.allowedHttpHookUrls = params.allowedHttpHookUrls ?? [];
     this.allowPrivateNetworkHooks = params.allowPrivateNetworkHooks ?? false;
     this.onPersistPermissionRuleCallback = params.onPersistPermissionRule;
+    this.onDisableZvecGrepForWorkspaceCallback =
+      params.onDisableZvecGrepForWorkspace;
 
     // (web search removed)
     this.useRipgrep = params.useRipgrep ?? true;
@@ -5143,6 +5151,18 @@ export class Config {
     return this.disabledSkillNamesProvider?.() ?? EMPTY_DISABLED_SKILL_NAMES;
   }
 
+  isZvecGrepEnabled(): boolean {
+    return this.zvecGrepEnabled;
+  }
+
+  canDisableZvecGrepForWorkspace(): boolean {
+    return this.onDisableZvecGrepForWorkspaceCallback !== undefined;
+  }
+
+  async disableZvecGrepForWorkspace(): Promise<void> {
+    await this.onDisableZvecGrepForWorkspaceCallback?.();
+  }
+
   /**
    * Returns skill discovery levels excluded through
    * `settings.skills.disabledLevels`.
@@ -8009,6 +8029,13 @@ export class Config {
       return new ZoomImageTool(this);
     });
 
+    if (this.isZvecGrepEnabled()) {
+      await registerLazy(ToolNames.ZVEC_GREP, async () => {
+        const { ZvecGrepTool } = await import('../tools/zvec-grep.js');
+        return new ZvecGrepTool(this);
+      });
+    }
+
     // --- Grep / RipGrep (conditional) ---
     if (this.getUseRipgrep()) {
       let useRipgrep = false;

packages/core/src/core/coreToolScheduler.test.ts

@@ -16806,6 +16806,19 @@ describe('extractToolFilePaths', () => {
     ).toEqual(['packages/core', 'packages/core/**/*.ts']);
   });
 
+  it('extracts zvec_grep paths and globs as path-shaped file filters', () => {
+    expect(
+      extractToolFilePaths('zvec_grep', {
+        operation: 'rg',
+        query: 'validate',
+        path: 'packages/core',
+        paths: ['src', 'include'],
+        glob: '**/*.{h,cc}',
+        exclude: ['thirdparty/**'],
+      }),
+    ).toEqual(['packages/core', 'src', 'include', 'packages/core/**/*.{h,cc}']);
+  });
+
   it('decodes file:// URIs for lsp via fileURLToPath', () => {
     // Regression: LSP `filePath` is allowed to be a `file://` URI.
     // Forwarding the URI as-is to the activation registry would never

packages/core/src/core/coreToolScheduler.ts

@@ -531,6 +531,7 @@ const FS_PATH_TOOL_NAMES: ReadonlySet<string> = new Set<string>([
   ToolNames.EDIT,
   ToolNames.WRITE_FILE,
   ToolNames.GREP,
+  ToolNames.ZVEC_GREP,
   ToolNames.GLOB,
   ToolNames.LS,
   ToolNames.LSP,
@@ -714,6 +715,27 @@ export function extractToolFilePaths(
       return out;
     }
 
+    case ToolNames.ZVEC_GREP: {
+      const pathField = obj['path'];
+      const pathsField = obj['paths'];
+      const globField = obj['glob'];
+      push(pathField);
+      if (Array.isArray(pathsField)) {
+        for (const item of pathsField) {
+          push(item);
+        }
+      }
+      if (typeof globField === 'string' && globField.length > 0) {
+        push(
+          joinSearchRootAndGlob(
+            typeof pathField === 'string' ? pathField : undefined,
+            globField,
+          ),
+        );
+      }
+      return out;
+    }
+
     case ToolNames.LS:
       push(obj['path']);
       return out;