@google/gemini-cli 0.26.0-preview.4 → 0.27.0-nightly.20260126.cb772a5b7

package/dist/src/ui/hooks/useShellInactivityStatus.test.js

@@ -0,0 +1,84 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+import { act } from 'react';
+import { renderHook } from '../../test-utils/render.js';
+import { useShellInactivityStatus } from './useShellInactivityStatus.js';
+import { useTurnActivityMonitor } from './useTurnActivityMonitor.js';
+import { StreamingState } from '../types.js';
+vi.mock('./useTurnActivityMonitor.js', () => ({
+    useTurnActivityMonitor: vi.fn(),
+}));
+describe('useShellInactivityStatus', () => {
+    beforeEach(() => {
+        vi.useFakeTimers();
+        vi.mocked(useTurnActivityMonitor).mockReturnValue({
+            operationStartTime: 1000,
+            isRedirectionActive: false,
+        });
+    });
+    afterEach(() => {
+        vi.clearAllMocks();
+        vi.useRealTimers();
+    });
+    const defaultProps = {
+        activePtyId: 'pty-1',
+        lastOutputTime: 1001,
+        streamingState: StreamingState.Responding,
+        pendingToolCalls: [],
+        embeddedShellFocused: false,
+        isInteractiveShellEnabled: true,
+    };
+    it('should show action_required status after 30s when output has been produced', async () => {
+        const { result } = renderHook(() => useShellInactivityStatus(defaultProps));
+        expect(result.current.inactivityStatus).toBe('none');
+        await act(async () => {
+            await vi.advanceTimersByTimeAsync(30000);
+        });
+        expect(result.current.inactivityStatus).toBe('action_required');
+    });
+    it('should show silent_working status after 60s when no output has been produced (silent)', async () => {
+        const { result } = renderHook(() => useShellInactivityStatus({ ...defaultProps, lastOutputTime: 500 }));
+        await act(async () => {
+            await vi.advanceTimersByTimeAsync(30000);
+        });
+        expect(result.current.inactivityStatus).toBe('none');
+        await act(async () => {
+            await vi.advanceTimersByTimeAsync(30000);
+        });
+        expect(result.current.inactivityStatus).toBe('silent_working');
+    });
+    it('should show silent_working status after 2 mins for redirected commands', async () => {
+        vi.mocked(useTurnActivityMonitor).mockReturnValue({
+            operationStartTime: 1000,
+            isRedirectionActive: true,
+        });
+        const { result } = renderHook(() => useShellInactivityStatus(defaultProps));
+        // Should NOT show action_required even after 60s
+        await act(async () => {
+            await vi.advanceTimersByTimeAsync(60000);
+        });
+        expect(result.current.inactivityStatus).toBe('none');
+        // Should show silent_working after 2 mins (120000ms)
+        await act(async () => {
+            await vi.advanceTimersByTimeAsync(60000);
+        });
+        expect(result.current.inactivityStatus).toBe('silent_working');
+    });
+    it('should suppress focus hint when redirected', async () => {
+        vi.mocked(useTurnActivityMonitor).mockReturnValue({
+            operationStartTime: 1000,
+            isRedirectionActive: true,
+        });
+        const { result } = renderHook(() => useShellInactivityStatus(defaultProps));
+        // Even after delay, focus hint should be suppressed
+        await act(async () => {
+            await vi.advanceTimersByTimeAsync(20000);
+        });
+        expect(result.current.shouldShowFocusHint).toBe(false);
+    });
+});
+//# sourceMappingURL=useShellInactivityStatus.test.js.map

package/dist/src/ui/hooks/useShellInactivityStatus.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useShellInactivityStatus.test.js","sourceRoot":"","sources":["../../../../src/ui/hooks/useShellInactivityStatus.test.ts"],"names":[],"mappings":"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"}

package/dist/src/ui/hooks/useTabbedNavigation.d.ts

@@ -0,0 +1,53 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Options for the useTabbedNavigation hook.
+ */
+export interface UseTabbedNavigationOptions {
+    /** Total number of tabs */
+    tabCount: number;
+    /** Initial tab index (default: 0) */
+    initialIndex?: number;
+    /** Allow wrapping from last to first and vice versa (default: false) */
+    wrapAround?: boolean;
+    /** Whether left/right arrows navigate tabs (default: true) */
+    enableArrowNavigation?: boolean;
+    /** Whether Tab key advances to next tab (default: true) */
+    enableTabKey?: boolean;
+    /** Callback to determine if navigation is blocked (e.g., during text input) */
+    isNavigationBlocked?: () => boolean;
+    /** Whether the hook is active and should respond to keyboard input */
+    isActive?: boolean;
+    /** Callback when the active tab changes */
+    onTabChange?: (index: number) => void;
+}
+/**
+ * Result of the useTabbedNavigation hook.
+ */
+export interface UseTabbedNavigationResult {
+    /** Current tab index */
+    currentIndex: number;
+    /** Set the current tab index directly */
+    setCurrentIndex: (index: number) => void;
+    /** Move to the next tab (respecting bounds) */
+    goToNextTab: () => void;
+    /** Move to the previous tab (respecting bounds) */
+    goToPrevTab: () => void;
+    /** Whether currently at first tab */
+    isFirstTab: boolean;
+    /** Whether currently at last tab */
+    isLastTab: boolean;
+}
+/**
+ * A headless hook that provides keyboard navigation for tabbed interfaces.
+ *
+ * Features:
+ * - Keyboard navigation with left/right arrows
+ * - Optional Tab key navigation
+ * - Optional wrap-around navigation
+ * - Navigation blocking callback (for text input scenarios)
+ */
+export declare function useTabbedNavigation({ tabCount, initialIndex, wrapAround, enableArrowNavigation, enableTabKey, isNavigationBlocked, isActive, onTabChange, }: UseTabbedNavigationOptions): UseTabbedNavigationResult;

package/dist/src/ui/hooks/useTabbedNavigation.js

@@ -0,0 +1,150 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { useReducer, useCallback, useEffect, useRef } from 'react';
+import { useKeypress } from './useKeypress.js';
+import { keyMatchers, Command } from '../keyMatchers.js';
+function tabbedNavigationReducer(state, action) {
+    switch (action.type) {
+        case 'NEXT_TAB': {
+            const { tabCount, wrapAround, currentIndex } = state;
+            if (tabCount === 0)
+                return state;
+            let nextIndex = currentIndex + 1;
+            if (nextIndex >= tabCount) {
+                nextIndex = wrapAround ? 0 : tabCount - 1;
+            }
+            if (nextIndex === currentIndex)
+                return state;
+            return { ...state, currentIndex: nextIndex, pendingTabChange: true };
+        }
+        case 'PREV_TAB': {
+            const { tabCount, wrapAround, currentIndex } = state;
+            if (tabCount === 0)
+                return state;
+            let nextIndex = currentIndex - 1;
+            if (nextIndex < 0) {
+                nextIndex = wrapAround ? tabCount - 1 : 0;
+            }
+            if (nextIndex === currentIndex)
+                return state;
+            return { ...state, currentIndex: nextIndex, pendingTabChange: true };
+        }
+        case 'SET_INDEX': {
+            const { index } = action.payload;
+            const { tabCount, currentIndex } = state;
+            if (index === currentIndex)
+                return state;
+            if (index < 0 || index >= tabCount)
+                return state;
+            return { ...state, currentIndex: index, pendingTabChange: true };
+        }
+        case 'INITIALIZE': {
+            const { tabCount, initialIndex, wrapAround } = action.payload;
+            const validIndex = Math.max(0, Math.min(initialIndex, tabCount - 1));
+            return {
+                ...state,
+                tabCount,
+                wrapAround,
+                currentIndex: tabCount > 0 ? validIndex : 0,
+                pendingTabChange: false,
+            };
+        }
+        case 'CLEAR_PENDING': {
+            return { ...state, pendingTabChange: false };
+        }
+        default: {
+            return state;
+        }
+    }
+}
+/**
+ * A headless hook that provides keyboard navigation for tabbed interfaces.
+ *
+ * Features:
+ * - Keyboard navigation with left/right arrows
+ * - Optional Tab key navigation
+ * - Optional wrap-around navigation
+ * - Navigation blocking callback (for text input scenarios)
+ */
+export function useTabbedNavigation({ tabCount, initialIndex = 0, wrapAround = false, enableArrowNavigation = true, enableTabKey = true, isNavigationBlocked, isActive = true, onTabChange, }) {
+    const [state, dispatch] = useReducer(tabbedNavigationReducer, {
+        currentIndex: Math.max(0, Math.min(initialIndex, tabCount - 1)),
+        tabCount,
+        wrapAround,
+        pendingTabChange: false,
+    });
+    const prevTabCountRef = useRef(tabCount);
+    const prevInitialIndexRef = useRef(initialIndex);
+    const prevWrapAroundRef = useRef(wrapAround);
+    useEffect(() => {
+        const tabCountChanged = prevTabCountRef.current !== tabCount;
+        const initialIndexChanged = prevInitialIndexRef.current !== initialIndex;
+        const wrapAroundChanged = prevWrapAroundRef.current !== wrapAround;
+        if (tabCountChanged || initialIndexChanged || wrapAroundChanged) {
+            dispatch({
+                type: 'INITIALIZE',
+                payload: { tabCount, initialIndex, wrapAround },
+            });
+            prevTabCountRef.current = tabCount;
+            prevInitialIndexRef.current = initialIndex;
+            prevWrapAroundRef.current = wrapAround;
+        }
+    }, [tabCount, initialIndex, wrapAround]);
+    useEffect(() => {
+        if (state.pendingTabChange) {
+            onTabChange?.(state.currentIndex);
+            dispatch({ type: 'CLEAR_PENDING' });
+        }
+    }, [state.pendingTabChange, state.currentIndex, onTabChange]);
+    const goToNextTab = useCallback(() => {
+        if (isNavigationBlocked?.())
+            return;
+        dispatch({ type: 'NEXT_TAB' });
+    }, [isNavigationBlocked]);
+    const goToPrevTab = useCallback(() => {
+        if (isNavigationBlocked?.())
+            return;
+        dispatch({ type: 'PREV_TAB' });
+    }, [isNavigationBlocked]);
+    const setCurrentIndex = useCallback((index) => {
+        if (isNavigationBlocked?.())
+            return;
+        dispatch({ type: 'SET_INDEX', payload: { index } });
+    }, [isNavigationBlocked]);
+    const handleKeypress = useCallback((key) => {
+        if (isNavigationBlocked?.())
+            return;
+        if (enableArrowNavigation) {
+            if (keyMatchers[Command.MOVE_RIGHT](key)) {
+                goToNextTab();
+                return;
+            }
+            if (keyMatchers[Command.MOVE_LEFT](key)) {
+                goToPrevTab();
+                return;
+            }
+        }
+        if (enableTabKey && key.name === 'tab' && !key.shift) {
+            goToNextTab();
+        }
+    }, [
+        enableArrowNavigation,
+        enableTabKey,
+        goToNextTab,
+        goToPrevTab,
+        isNavigationBlocked,
+    ]);
+    useKeypress(handleKeypress, { isActive: isActive && tabCount > 1 });
+    return {
+        currentIndex: state.currentIndex,
+        setCurrentIndex,
+        goToNextTab,
+        goToPrevTab,
+        isFirstTab: state.currentIndex === 0,
+        isLastTab: state.currentIndex === tabCount - 1,
+    };
+}
+//# sourceMappingURL=useTabbedNavigation.js.map

package/dist/src/ui/hooks/useTabbedNavigation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTabbedNavigation.js","sourceRoot":"","sources":["../../../../src/ui/hooks/useTabbedNavigation.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AACnE,OAAO,EAAE,WAAW,EAAY,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AA2DzD,SAAS,uBAAuB,CAC9B,KAA4B,EAC5B,MAA8B;IAE9B,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;QACpB,KAAK,UAAU,CAAC,CAAC,CAAC;YAChB,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,YAAY,EAAE,GAAG,KAAK,CAAC;YACrD,IAAI,QAAQ,KAAK,CAAC;gBAAE,OAAO,KAAK,CAAC;YAEjC,IAAI,SAAS,GAAG,YAAY,GAAG,CAAC,CAAC;YACjC,IAAI,SAAS,IAAI,QAAQ,EAAE,CAAC;gBAC1B,SAAS,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC;YAC5C,CAAC;YAED,IAAI,SAAS,KAAK,YAAY;gBAAE,OAAO,KAAK,CAAC;YAC7C,OAAO,EAAE,GAAG,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,gBAAgB,EAAE,IAAI,EAAE,CAAC;QACvE,CAAC;QAED,KAAK,UAAU,CAAC,CAAC,CAAC;YAChB,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,YAAY,EAAE,GAAG,KAAK,CAAC;YACrD,IAAI,QAAQ,KAAK,CAAC;gBAAE,OAAO,KAAK,CAAC;YAEjC,IAAI,SAAS,GAAG,YAAY,GAAG,CAAC,CAAC;YACjC,IAAI,SAAS,GAAG,CAAC,EAAE,CAAC;gBAClB,SAAS,GAAG,UAAU,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAC5C,CAAC;YAED,IAAI,SAAS,KAAK,YAAY;gBAAE,OAAO,KAAK,CAAC;YAC7C,OAAO,EAAE,GAAG,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,gBAAgB,EAAE,IAAI,EAAE,CAAC;QACvE,CAAC;QAED,KAAK,WAAW,CAAC,CAAC,CAAC;YACjB,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,CAAC,OAAO,CAAC;YACjC,MAAM,EAAE,QAAQ,EAAE,YAAY,EAAE,GAAG,KAAK,CAAC;YAEzC,IAAI,KAAK,KAAK,YAAY;gBAAE,OAAO,KAAK,CAAC;YACzC,IAAI,KAAK,GAAG,CAAC,IAAI,KAAK,IAAI,QAAQ;gBAAE,OAAO,KAAK,CAAC;YAEjD,OAAO,EAAE,GAAG,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,gBAAgB,EAAE,IAAI,EAAE,CAAC;QACnE,CAAC;QAED,KAAK,YAAY,CAAC,CAAC,CAAC;YAClB,MAAM,EAAE,QAAQ,EAAE,YAAY,EAAE,UAAU,EAAE,GAAG,MAAM,CAAC,OAAO,CAAC;YAC9D,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC;YACrE,OAAO;gBACL,GAAG,KAAK;gBACR,QAAQ;gBACR,UAAU;gBACV,YAAY,EAAE,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;gBAC3C,gBAAgB,EAAE,KAAK;aACxB,CAAC;QACJ,CAAC;QAED,KAAK,eAAe,CAAC,CAAC,CAAC;YACrB,OAAO,EAAE,GAAG,KAAK,EAAE,gBAAgB,EAAE,KAAK,EAAE,CAAC;QAC/C,CAAC;QAED,OAAO,CAAC,CAAC,CAAC;YACR,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,mBAAmB,CAAC,EAClC,QAAQ,EACR,YAAY,GAAG,CAAC,EAChB,UAAU,GAAG,KAAK,EAClB,qBAAqB,GAAG,IAAI,EAC5B,YAAY,GAAG,IAAI,EACnB,mBAAmB,EACnB,QAAQ,GAAG,IAAI,EACf,WAAW,GACgB;IAC3B,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,UAAU,CAAC,uBAAuB,EAAE;QAC5D,YAAY,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,QAAQ,GAAG,CAAC,CAAC,CAAC;QAC/D,QAAQ;QACR,UAAU;QACV,gBAAgB,EAAE,KAAK;KACxB,CAAC,CAAC;IAEH,MAAM,eAAe,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;IACzC,MAAM,mBAAmB,GAAG,MAAM,CAAC,YAAY,CAAC,CAAC;IACjD,MAAM,iBAAiB,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC;IAE7C,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,eAAe,GAAG,eAAe,CAAC,OAAO,KAAK,QAAQ,CAAC;QAC7D,MAAM,mBAAmB,GAAG,mBAAmB,CAAC,OAAO,KAAK,YAAY,CAAC;QACzE,MAAM,iBAAiB,GAAG,iBAAiB,CAAC,OAAO,KAAK,UAAU,CAAC;QAEnE,IAAI,eAAe,IAAI,mBAAmB,IAAI,iBAAiB,EAAE,CAAC;YAChE,QAAQ,CAAC;gBACP,IAAI,EAAE,YAAY;gBAClB,OAAO,EAAE,EAAE,QAAQ,EAAE,YAAY,EAAE,UAAU,EAAE;aAChD,CAAC,CAAC;YACH,eAAe,CAAC,OAAO,GAAG,QAAQ,CAAC;YACnC,mBAAmB,CAAC,OAAO,GAAG,YAAY,CAAC;YAC3C,iBAAiB,CAAC,OAAO,GAAG,UAAU,CAAC;QACzC,CAAC;IACH,CAAC,EAAE,CAAC,QAAQ,EAAE,YAAY,EAAE,UAAU,CAAC,CAAC,CAAC;IAEzC,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,KAAK,CAAC,gBAAgB,EAAE,CAAC;YAC3B,WAAW,EAAE,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;YAClC,QAAQ,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC,CAAC;QACtC,CAAC;IACH,CAAC,EAAE,CAAC,KAAK,CAAC,gBAAgB,EAAE,KAAK,CAAC,YAAY,EAAE,WAAW,CAAC,CAAC,CAAC;IAE9D,MAAM,WAAW,GAAG,WAAW,CAAC,GAAG,EAAE;QACnC,IAAI,mBAAmB,EAAE,EAAE;YAAE,OAAO;QACpC,QAAQ,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC;IACjC,CAAC,EAAE,CAAC,mBAAmB,CAAC,CAAC,CAAC;IAE1B,MAAM,WAAW,GAAG,WAAW,CAAC,GAAG,EAAE;QACnC,IAAI,mBAAmB,EAAE,EAAE;YAAE,OAAO;QACpC,QAAQ,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC;IACjC,CAAC,EAAE,CAAC,mBAAmB,CAAC,CAAC,CAAC;IAE1B,MAAM,eAAe,GAAG,WAAW,CACjC,CAAC,KAAa,EAAE,EAAE;QAChB,IAAI,mBAAmB,EAAE,EAAE;YAAE,OAAO;QACpC,QAAQ,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;IACtD,CAAC,EACD,CAAC,mBAAmB,CAAC,CACtB,CAAC;IAEF,MAAM,cAAc,GAAG,WAAW,CAChC,CAAC,GAAQ,EAAE,EAAE;QACX,IAAI,mBAAmB,EAAE,EAAE;YAAE,OAAO;QAEpC,IAAI,qBAAqB,EAAE,CAAC;YAC1B,IAAI,WAAW,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;gBACzC,WAAW,EAAE,CAAC;gBACd,OAAO;YACT,CAAC;YACD,IAAI,WAAW,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;gBACxC,WAAW,EAAE,CAAC;gBACd,OAAO;YACT,CAAC;QACH,CAAC;QAED,IAAI,YAAY,IAAI,GAAG,CAAC,IAAI,KAAK,KAAK,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC;YACrD,WAAW,EAAE,CAAC;QAChB,CAAC;IACH,CAAC,EACD;QACE,qBAAqB;QACrB,YAAY;QACZ,WAAW;QACX,WAAW;QACX,mBAAmB;KACpB,CACF,CAAC;IAEF,WAAW,CAAC,cAAc,EAAE,EAAE,QAAQ,EAAE,QAAQ,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC,CAAC;IAEpE,OAAO;QACL,YAAY,EAAE,KAAK,CAAC,YAAY;QAChC,eAAe;QACf,WAAW;QACX,WAAW;QACX,UAAU,EAAE,KAAK,CAAC,YAAY,KAAK,CAAC;QACpC,SAAS,EAAE,KAAK,CAAC,YAAY,KAAK,QAAQ,GAAG,CAAC;KAC/C,CAAC;AACJ,CAAC"}

package/dist/src/ui/hooks/useTabbedNavigation.test.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export {};

package/dist/src/ui/hooks/useTabbedNavigation.test.js

@@ -0,0 +1,187 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import { act } from 'react';
+import { renderHook } from '../../test-utils/render.js';
+import { useTabbedNavigation } from './useTabbedNavigation.js';
+vi.mock('./useKeypress.js', () => ({
+    useKeypress: vi.fn(),
+}));
+vi.mock('../keyMatchers.js', () => ({
+    keyMatchers: {
+        'cursor.left': vi.fn((key) => key.name === 'left'),
+        'cursor.right': vi.fn((key) => key.name === 'right'),
+    },
+    Command: {
+        MOVE_LEFT: 'cursor.left',
+        MOVE_RIGHT: 'cursor.right',
+    },
+}));
+describe('useTabbedNavigation', () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+    });
+    describe('initialization', () => {
+        it('returns initial index of 0 by default', () => {
+            const { result } = renderHook(() => useTabbedNavigation({ tabCount: 3 }));
+            expect(result.current.currentIndex).toBe(0);
+        });
+        it('returns specified initial index', () => {
+            const { result } = renderHook(() => useTabbedNavigation({ tabCount: 3, initialIndex: 2 }));
+            expect(result.current.currentIndex).toBe(2);
+        });
+        it('clamps initial index to valid range', () => {
+            const { result: high } = renderHook(() => useTabbedNavigation({ tabCount: 3, initialIndex: 10 }));
+            expect(high.current.currentIndex).toBe(2);
+            const { result: negative } = renderHook(() => useTabbedNavigation({ tabCount: 3, initialIndex: -1 }));
+            expect(negative.current.currentIndex).toBe(0);
+        });
+    });
+    describe('goToNextTab', () => {
+        it('advances to next tab', () => {
+            const { result } = renderHook(() => useTabbedNavigation({ tabCount: 3 }));
+            act(() => {
+                result.current.goToNextTab();
+            });
+            expect(result.current.currentIndex).toBe(1);
+        });
+        it('stops at last tab when wrapAround is false', () => {
+            const { result } = renderHook(() => useTabbedNavigation({
+                tabCount: 3,
+                initialIndex: 2,
+                wrapAround: false,
+            }));
+            act(() => {
+                result.current.goToNextTab();
+            });
+            expect(result.current.currentIndex).toBe(2);
+        });
+        it('wraps to first tab when wrapAround is true', () => {
+            const { result } = renderHook(() => useTabbedNavigation({ tabCount: 3, initialIndex: 2, wrapAround: true }));
+            act(() => {
+                result.current.goToNextTab();
+            });
+            expect(result.current.currentIndex).toBe(0);
+        });
+    });
+    describe('goToPrevTab', () => {
+        it('moves to previous tab', () => {
+            const { result } = renderHook(() => useTabbedNavigation({ tabCount: 3, initialIndex: 2 }));
+            act(() => {
+                result.current.goToPrevTab();
+            });
+            expect(result.current.currentIndex).toBe(1);
+        });
+        it('stops at first tab when wrapAround is false', () => {
+            const { result } = renderHook(() => useTabbedNavigation({
+                tabCount: 3,
+                initialIndex: 0,
+                wrapAround: false,
+            }));
+            act(() => {
+                result.current.goToPrevTab();
+            });
+            expect(result.current.currentIndex).toBe(0);
+        });
+        it('wraps to last tab when wrapAround is true', () => {
+            const { result } = renderHook(() => useTabbedNavigation({ tabCount: 3, initialIndex: 0, wrapAround: true }));
+            act(() => {
+                result.current.goToPrevTab();
+            });
+            expect(result.current.currentIndex).toBe(2);
+        });
+    });
+    describe('setCurrentIndex', () => {
+        it('sets index directly', () => {
+            const { result } = renderHook(() => useTabbedNavigation({ tabCount: 3 }));
+            act(() => {
+                result.current.setCurrentIndex(2);
+            });
+            expect(result.current.currentIndex).toBe(2);
+        });
+        it('ignores out-of-bounds index', () => {
+            const { result } = renderHook(() => useTabbedNavigation({ tabCount: 3, initialIndex: 1 }));
+            act(() => {
+                result.current.setCurrentIndex(10);
+            });
+            expect(result.current.currentIndex).toBe(1);
+            act(() => {
+                result.current.setCurrentIndex(-1);
+            });
+            expect(result.current.currentIndex).toBe(1);
+        });
+    });
+    describe('isNavigationBlocked', () => {
+        it('blocks navigation when callback returns true', () => {
+            const isNavigationBlocked = vi.fn(() => true);
+            const { result } = renderHook(() => useTabbedNavigation({ tabCount: 3, isNavigationBlocked }));
+            act(() => {
+                result.current.goToNextTab();
+            });
+            expect(result.current.currentIndex).toBe(0);
+            expect(isNavigationBlocked).toHaveBeenCalled();
+        });
+        it('allows navigation when callback returns false', () => {
+            const isNavigationBlocked = vi.fn(() => false);
+            const { result } = renderHook(() => useTabbedNavigation({ tabCount: 3, isNavigationBlocked }));
+            act(() => {
+                result.current.goToNextTab();
+            });
+            expect(result.current.currentIndex).toBe(1);
+        });
+    });
+    describe('onTabChange callback', () => {
+        it('calls onTabChange when tab changes via goToNextTab', () => {
+            const onTabChange = vi.fn();
+            const { result } = renderHook(() => useTabbedNavigation({ tabCount: 3, onTabChange }));
+            act(() => {
+                result.current.goToNextTab();
+            });
+            expect(onTabChange).toHaveBeenCalledWith(1);
+        });
+        it('calls onTabChange when tab changes via setCurrentIndex', () => {
+            const onTabChange = vi.fn();
+            const { result } = renderHook(() => useTabbedNavigation({ tabCount: 3, onTabChange }));
+            act(() => {
+                result.current.setCurrentIndex(2);
+            });
+            expect(onTabChange).toHaveBeenCalledWith(2);
+        });
+        it('does not call onTabChange when tab does not change', () => {
+            const onTabChange = vi.fn();
+            const { result } = renderHook(() => useTabbedNavigation({ tabCount: 3, onTabChange }));
+            act(() => {
+                result.current.setCurrentIndex(0);
+            });
+            expect(onTabChange).not.toHaveBeenCalled();
+        });
+    });
+    describe('isFirstTab and isLastTab', () => {
+        it('returns correct boundary flags based on position', () => {
+            const { result: first } = renderHook(() => useTabbedNavigation({ tabCount: 3, initialIndex: 0 }));
+            expect(first.current.isFirstTab).toBe(true);
+            expect(first.current.isLastTab).toBe(false);
+            const { result: last } = renderHook(() => useTabbedNavigation({ tabCount: 3, initialIndex: 2 }));
+            expect(last.current.isFirstTab).toBe(false);
+            expect(last.current.isLastTab).toBe(true);
+            const { result: middle } = renderHook(() => useTabbedNavigation({ tabCount: 3, initialIndex: 1 }));
+            expect(middle.current.isFirstTab).toBe(false);
+            expect(middle.current.isLastTab).toBe(false);
+        });
+    });
+    describe('tabCount changes', () => {
+        it('reinitializes when tabCount changes', () => {
+            let tabCount = 5;
+            const { result, rerender } = renderHook(() => useTabbedNavigation({ tabCount, initialIndex: 4 }));
+            expect(result.current.currentIndex).toBe(4);
+            tabCount = 3;
+            rerender();
+            // Should clamp to valid range
+            expect(result.current.currentIndex).toBe(2);
+        });
+    });
+});
+//# sourceMappingURL=useTabbedNavigation.test.js.map

package/dist/src/ui/hooks/useTabbedNavigation.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTabbedNavigation.test.js","sourceRoot":"","sources":["../../../../src/ui/hooks/useTabbedNavigation.test.ts"],"names":[],"mappings":"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"}

package/dist/src/ui/hooks/useTips.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+interface UseTipsResult {
+    showTips: boolean;
+}
+export declare function useTips(): UseTipsResult;
+export {};

package/dist/src/ui/hooks/useTips.js

@@ -0,0 +1,18 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { useEffect, useState } from 'react';
+import { persistentState } from '../../utils/persistentState.js';
+export function useTips() {
+    const [tipsCount] = useState(() => persistentState.get('tipsShown') ?? 0);
+    const showTips = tipsCount < 10;
+    useEffect(() => {
+        if (showTips) {
+            persistentState.set('tipsShown', tipsCount + 1);
+        }
+    }, [tipsCount, showTips]);
+    return { showTips };
+}
+//# sourceMappingURL=useTips.js.map

package/dist/src/ui/hooks/useTips.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTips.js","sourceRoot":"","sources":["../../../../src/ui/hooks/useTips.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAMjE,MAAM,UAAU,OAAO;IACrB,MAAM,CAAC,SAAS,CAAC,GAAG,QAAQ,CAAC,GAAG,EAAE,CAAC,eAAe,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC;IAE1E,MAAM,QAAQ,GAAG,SAAS,GAAG,EAAE,CAAC;IAEhC,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,QAAQ,EAAE,CAAC;YACb,eAAe,CAAC,GAAG,CAAC,WAAW,EAAE,SAAS,GAAG,CAAC,CAAC,CAAC;QAClD,CAAC;IACH,CAAC,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC;IAE1B,OAAO,EAAE,QAAQ,EAAE,CAAC;AACtB,CAAC"}

package/dist/src/ui/hooks/useTips.test.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export {};

package/dist/src/ui/hooks/useTips.test.js

@@ -0,0 +1,33 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { renderHookWithProviders, persistentStateMock, } from '../../test-utils/render.js';
+import { describe, it, expect, beforeEach, vi } from 'vitest';
+import { useTips } from './useTips.js';
+describe('useTips()', () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+    });
+    it('should return false and call set(1) if state is undefined', () => {
+        const { result } = renderHookWithProviders(() => useTips());
+        expect(result.current.showTips).toBe(true);
+        expect(persistentStateMock.set).toHaveBeenCalledWith('tipsShown', 1);
+        expect(persistentStateMock.get('tipsShown')).toBe(1);
+    });
+    it('should return false and call set(6) if state is 5', () => {
+        persistentStateMock.setData({ tipsShown: 5 });
+        const { result } = renderHookWithProviders(() => useTips());
+        expect(result.current.showTips).toBe(true);
+        expect(persistentStateMock.get('tipsShown')).toBe(6);
+    });
+    it('should return true if state is 10', () => {
+        persistentStateMock.setData({ tipsShown: 10 });
+        const { result } = renderHookWithProviders(() => useTips());
+        expect(result.current.showTips).toBe(false);
+        expect(persistentStateMock.set).not.toHaveBeenCalled();
+        expect(persistentStateMock.get('tipsShown')).toBe(10);
+    });
+});
+//# sourceMappingURL=useTips.test.js.map

package/dist/src/ui/hooks/useTips.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTips.test.js","sourceRoot":"","sources":["../../../../src/ui/hooks/useTips.test.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,uBAAuB,EACvB,mBAAmB,GACpB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9D,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,QAAQ,CAAC,WAAW,EAAE,GAAG,EAAE;IACzB,UAAU,CAAC,GAAG,EAAE;QACd,EAAE,CAAC,aAAa,EAAE,CAAC;IACrB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2DAA2D,EAAE,GAAG,EAAE;QACnE,MAAM,EAAE,MAAM,EAAE,GAAG,uBAAuB,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;QAE5D,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAE3C,MAAM,CAAC,mBAAmB,CAAC,GAAG,CAAC,CAAC,oBAAoB,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;QACrE,MAAM,CAAC,mBAAmB,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACvD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mDAAmD,EAAE,GAAG,EAAE;QAC3D,mBAAmB,CAAC,OAAO,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC,CAAC;QAE9C,MAAM,EAAE,MAAM,EAAE,GAAG,uBAAuB,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;QAE5D,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAE3C,MAAM,CAAC,mBAAmB,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACvD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;QAC3C,mBAAmB,CAAC,OAAO,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC,CAAC;QAE/C,MAAM,EAAE,MAAM,EAAE,GAAG,uBAAuB,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;QAE5D,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC5C,MAAM,CAAC,mBAAmB,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;QACvD,MAAM,CAAC,mBAAmB,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACxD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/src/ui/hooks/useToolExecutionScheduler.d.ts

@@ -0,0 +1,30 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { type Config, type ToolCallRequestInfo, type ToolCall, type CompletedToolCall, type EditorType } from '@google/gemini-cli-core';
+export type ScheduleFn = (request: ToolCallRequestInfo | ToolCallRequestInfo[], signal: AbortSignal) => Promise<CompletedToolCall[]>;
+export type MarkToolsAsSubmittedFn = (callIds: string[]) => void;
+export type CancelAllFn = (signal: AbortSignal) => void;
+/**
+ * The shape expected by useGeminiStream.
+ * It matches the Core ToolCall structure + the UI metadata flag.
+ */
+export type TrackedToolCall = ToolCall & {
+    responseSubmittedToGemini?: boolean;
+};
+/**
+ * Modern tool scheduler hook using the event-driven Core Scheduler.
+ *
+ * This hook acts as an Adapter between the new MessageBus-driven Core
+ * and the legacy callback-based UI components.
+ */
+export declare function useToolExecutionScheduler(onComplete: (tools: CompletedToolCall[]) => Promise<void>, config: Config, getPreferredEditor: () => EditorType | undefined): [
+    TrackedToolCall[],
+    ScheduleFn,
+    MarkToolsAsSubmittedFn,
+    React.Dispatch<React.SetStateAction<TrackedToolCall[]>>,
+    CancelAllFn,
+    number
+];