/** * @license * Copyright 2025 Google LLC * SPDX-License-Identifier: Apache-2.0 */ const { mockProcessExit } = vi.hoisted(() => ({ mockProcessExit: vi.fn((_code?: number): never => undefined as never), })); vi.mock('node:process', () => ({ default: { exit: mockProcessExit, cwd: vi.fn(() => '/mock/cwd'), get env() { return process.env; }, platform: 'test-platform', version: 'test-node-version', memoryUsage: vi.fn(() => ({ rss: 12345678, heapTotal: 23456789, heapUsed: 10234567, external: 1234567, arrayBuffers: 123456, })), }, exit: mockProcessExit, cwd: vi.fn(() => '/mock/cwd'), get env() { return process.env; }, platform: 'test-platform', version: 'test-node-version', memoryUsage: vi.fn(() => ({ rss: 12345678, heapTotal: 23456789, heapUsed: 10234567, external: 1234567, arrayBuffers: 123456, })), })); vi.mock('node:fs/promises', () => ({ readFile: vi.fn(), writeFile: vi.fn(), mkdir: vi.fn(), })); const mockGetCliVersionFn = vi.fn(() => Promise.resolve('0.1.0')); vi.mock('../../utils/version.js', () => ({ getCliVersion: (...args: []) => mockGetCliVersionFn(...args), })); import { act, renderHook } from '@testing-library/react'; import { vi, describe, it, expect, beforeEach, beforeAll, Mock } from 'vitest'; import open from 'open'; import { useSlashCommandProcessor } from './slashCommandProcessor.js'; import { SlashCommandProcessorResult } from '../types.js'; import { Config, GeminiClient } from '@google/gemini-cli-core'; import { useSessionStats } from '../contexts/SessionContext.js'; import { LoadedSettings } from '../../config/settings.js'; import * as ShowMemoryCommandModule from './useShowMemoryCommand.js'; import { CommandService } from '../../services/CommandService.js'; import { SlashCommand } from '../commands/types.js'; vi.mock('../contexts/SessionContext.js', () => ({ useSessionStats: vi.fn(), })); vi.mock('../../services/CommandService.js'); vi.mock('./useShowMemoryCommand.js', () => ({ SHOW_MEMORY_COMMAND_NAME: '/memory show', createShowMemoryAction: vi.fn(() => vi.fn()), })); vi.mock('open', () => ({ default: vi.fn(), })); vi.mock('@google/gemini-cli-core', async (importOriginal) => { const actual = await importOriginal(); return { ...actual, }; }); describe('useSlashCommandProcessor', () => { let mockAddItem: ReturnType; let mockClearItems: ReturnType; let mockLoadHistory: ReturnType; let mockRefreshStatic: ReturnType; let mockSetShowHelp: ReturnType; let mockOnDebugMessage: ReturnType; let mockOpenThemeDialog: ReturnType; let mockOpenAuthDialog: ReturnType; let mockOpenEditorDialog: ReturnType; let mockSetQuittingMessages: ReturnType; let mockTryCompressChat: ReturnType; let mockGeminiClient: GeminiClient; let mockConfig: Config; let mockCorgiMode: ReturnType; const mockUseSessionStats = useSessionStats as Mock; beforeEach(() => { vi.clearAllMocks(); mockAddItem = vi.fn(); mockClearItems = vi.fn(); mockLoadHistory = vi.fn(); mockRefreshStatic = vi.fn(); mockSetShowHelp = vi.fn(); mockOnDebugMessage = vi.fn(); mockOpenThemeDialog = vi.fn(); mockOpenAuthDialog = vi.fn(); mockOpenEditorDialog = vi.fn(); mockSetQuittingMessages = vi.fn(); mockTryCompressChat = vi.fn(); mockGeminiClient = { tryCompressChat: mockTryCompressChat, } as unknown as GeminiClient; mockConfig = { getDebugMode: vi.fn(() => false), getGeminiClient: () => mockGeminiClient, getSandbox: vi.fn(() => 'test-sandbox'), getModel: vi.fn(() => 'test-model'), getProjectRoot: vi.fn(() => '/test/dir'), getCheckpointingEnabled: vi.fn(() => true), getBugCommand: vi.fn(() => undefined), getSessionId: vi.fn(() => 'test-session-id'), getIdeMode: vi.fn(() => false), } as unknown as Config; mockCorgiMode = vi.fn(); mockUseSessionStats.mockReturnValue({ stats: { sessionStartTime: new Date('2025-01-01T00:00:00.000Z'), cumulative: { promptCount: 0, promptTokenCount: 0, candidatesTokenCount: 0, totalTokenCount: 0, cachedContentTokenCount: 0, toolUsePromptTokenCount: 0, thoughtsTokenCount: 0, }, }, }); (open as Mock).mockClear(); mockProcessExit.mockClear(); (ShowMemoryCommandModule.createShowMemoryAction as Mock).mockClear(); process.env = { ...globalThis.process.env }; }); const getProcessorHook = () => { const settings = { merged: { contextFileName: 'GEMINI.md', }, } as unknown as LoadedSettings; return renderHook(() => useSlashCommandProcessor( mockConfig, settings, mockAddItem, mockClearItems, mockLoadHistory, mockRefreshStatic, mockSetShowHelp, mockOnDebugMessage, mockOpenThemeDialog, mockOpenAuthDialog, mockOpenEditorDialog, mockCorgiMode, mockSetQuittingMessages, vi.fn(), // mockOpenPrivacyNotice ), ); }; describe('Command Processing', () => { let ActualCommandService: typeof CommandService; beforeAll(async () => { const actual = (await vi.importActual( '../../services/CommandService.js', )) as { CommandService: typeof CommandService }; ActualCommandService = actual.CommandService; }); beforeEach(() => { vi.clearAllMocks(); }); it('should execute a registered command', async () => { const mockAction = vi.fn(); const newCommand: SlashCommand = { name: 'test', action: mockAction }; const mockLoader = async () => [newCommand]; // We create the instance outside the mock implementation. const commandServiceInstance = new ActualCommandService( mockConfig, mockLoader, ); // This mock ensures the hook uses our pre-configured instance. vi.mocked(CommandService).mockImplementation( () => commandServiceInstance, ); const { result } = getProcessorHook(); await vi.waitFor(() => { // We check that the `slashCommands` array, which is the public API // of our hook, eventually contains the command we injected. expect( result.current.slashCommands.some((c) => c.name === 'test'), ).toBe(true); }); let commandResult: SlashCommandProcessorResult | false = false; await act(async () => { commandResult = await result.current.handleSlashCommand('/test'); }); expect(mockAction).toHaveBeenCalledTimes(1); expect(commandResult).toEqual({ type: 'handled' }); }); it('should return "schedule_tool" for a command returning a tool action', async () => { const mockAction = vi.fn().mockResolvedValue({ type: 'tool', toolName: 'my_tool', toolArgs: { arg1: 'value1' }, }); const newCommand: SlashCommand = { name: 'test', action: mockAction }; const mockLoader = async () => [newCommand]; const commandServiceInstance = new ActualCommandService( mockConfig, mockLoader, ); vi.mocked(CommandService).mockImplementation( () => commandServiceInstance, ); const { result } = getProcessorHook(); await vi.waitFor(() => { expect( result.current.slashCommands.some((c) => c.name === 'test'), ).toBe(true); }); const commandResult = await result.current.handleSlashCommand('/test'); expect(mockAction).toHaveBeenCalledTimes(1); expect(commandResult).toEqual({ type: 'schedule_tool', toolName: 'my_tool', toolArgs: { arg1: 'value1' }, }); }); it('should return "handled" for a command returning a message action', async () => { const mockAction = vi.fn().mockResolvedValue({ type: 'message', messageType: 'info', content: 'This is a message', }); const newCommand: SlashCommand = { name: 'test', action: mockAction }; const mockLoader = async () => [newCommand]; const commandServiceInstance = new ActualCommandService( mockConfig, mockLoader, ); vi.mocked(CommandService).mockImplementation( () => commandServiceInstance, ); const { result } = getProcessorHook(); await vi.waitFor(() => { expect( result.current.slashCommands.some((c) => c.name === 'test'), ).toBe(true); }); const commandResult = await result.current.handleSlashCommand('/test'); expect(mockAction).toHaveBeenCalledTimes(1); expect(mockAddItem).toHaveBeenCalledWith( expect.objectContaining({ type: 'info', text: 'This is a message', }), expect.any(Number), ); expect(commandResult).toEqual({ type: 'handled' }); }); it('should return "handled" for a command returning a dialog action', async () => { const mockAction = vi.fn().mockResolvedValue({ type: 'dialog', dialog: 'help', }); const newCommand: SlashCommand = { name: 'test', action: mockAction }; const mockLoader = async () => [newCommand]; const commandServiceInstance = new ActualCommandService( mockConfig, mockLoader, ); vi.mocked(CommandService).mockImplementation( () => commandServiceInstance, ); const { result } = getProcessorHook(); await vi.waitFor(() => { expect( result.current.slashCommands.some((c) => c.name === 'test'), ).toBe(true); }); const commandResult = await result.current.handleSlashCommand('/test'); expect(mockAction).toHaveBeenCalledTimes(1); expect(mockSetShowHelp).toHaveBeenCalledWith(true); expect(commandResult).toEqual({ type: 'handled' }); }); it('should open the auth dialog for a command returning an auth dialog action', async () => { const mockAction = vi.fn().mockResolvedValue({ type: 'dialog', dialog: 'auth', }); const newAuthCommand: SlashCommand = { name: 'auth', action: mockAction }; const mockLoader = async () => [newAuthCommand]; const commandServiceInstance = new ActualCommandService( mockConfig, mockLoader, ); vi.mocked(CommandService).mockImplementation( () => commandServiceInstance, ); const { result } = getProcessorHook(); await vi.waitFor(() => { expect( result.current.slashCommands.some((c) => c.name === 'auth'), ).toBe(true); }); const commandResult = await result.current.handleSlashCommand('/auth'); expect(mockAction).toHaveBeenCalledTimes(1); expect(mockOpenAuthDialog).toHaveBeenCalledWith(); expect(commandResult).toEqual({ type: 'handled' }); }); it('should open the theme dialog for a command returning a theme dialog action', async () => { const mockAction = vi.fn().mockResolvedValue({ type: 'dialog', dialog: 'theme', }); const newCommand: SlashCommand = { name: 'test', action: mockAction }; const mockLoader = async () => [newCommand]; const commandServiceInstance = new ActualCommandService( mockConfig, mockLoader, ); vi.mocked(CommandService).mockImplementation( () => commandServiceInstance, ); const { result } = getProcessorHook(); await vi.waitFor(() => { expect( result.current.slashCommands.some((c) => c.name === 'test'), ).toBe(true); }); const commandResult = await result.current.handleSlashCommand('/test'); expect(mockAction).toHaveBeenCalledTimes(1); expect(mockOpenThemeDialog).toHaveBeenCalledWith(); expect(commandResult).toEqual({ type: 'handled' }); }); it('should show help for a parent command with no action', async () => { const parentCommand: SlashCommand = { name: 'parent', subCommands: [ { name: 'child', description: 'A child.', action: vi.fn() }, ], }; const mockLoader = async () => [parentCommand]; const commandServiceInstance = new ActualCommandService( mockConfig, mockLoader, ); vi.mocked(CommandService).mockImplementation( () => commandServiceInstance, ); const { result } = getProcessorHook(); await vi.waitFor(() => { expect( result.current.slashCommands.some((c) => c.name === 'parent'), ).toBe(true); }); await act(async () => { await result.current.handleSlashCommand('/parent'); }); expect(mockAddItem).toHaveBeenCalledWith( expect.objectContaining({ type: 'info', text: expect.stringContaining( "Command '/parent' requires a subcommand.", ), }), expect.any(Number), ); }); }); });