mpd-llm-cli 0.1.18 → 0.1.20

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

@@ -0,0 +1,61 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { useState, useEffect, useCallback } from 'react';
+import { exec } from 'node:child_process';
+import fs from 'node:fs';
+import fsPromises from 'node:fs/promises';
+import path from 'path';
+export function useGitBranchName(cwd) {
+    const [branchName, setBranchName] = useState(undefined);
+    const fetchBranchName = useCallback(() => exec('git rev-parse --abbrev-ref HEAD', { cwd }, (error, stdout, _stderr) => {
+        if (error) {
+            setBranchName(undefined);
+            return;
+        }
+        const branch = stdout.toString().trim();
+        if (branch && branch !== 'HEAD') {
+            setBranchName(branch);
+        }
+        else {
+            exec('git rev-parse --short HEAD', { cwd }, (error, stdout, _stderr) => {
+                if (error) {
+                    setBranchName(undefined);
+                    return;
+                }
+                setBranchName(stdout.toString().trim());
+            });
+        }
+    }), [cwd, setBranchName]);
+    useEffect(() => {
+        fetchBranchName(); // Initial fetch
+        const gitLogsHeadPath = path.join(cwd, '.git', 'logs', 'HEAD');
+        let watcher;
+        const setupWatcher = async () => {
+            try {
+                // Check if .git/logs/HEAD exists, as it might not in a new repo or orphaned head
+                await fsPromises.access(gitLogsHeadPath, fs.constants.F_OK);
+                watcher = fs.watch(gitLogsHeadPath, (eventType) => {
+                    // Changes to .git/logs/HEAD (appends) indicate HEAD has likely changed
+                    if (eventType === 'change' || eventType === 'rename') {
+                        // Handle rename just in case
+                        fetchBranchName();
+                    }
+                });
+            }
+            catch (_watchError) {
+                // Silently ignore watcher errors (e.g. permissions or file not existing),
+                // similar to how exec errors are handled.
+                // The branch name will simply not update automatically.
+            }
+        };
+        setupWatcher();
+        return () => {
+            watcher?.close();
+        };
+    }, [cwd, fetchBranchName]);
+    return branchName;
+}
+//# sourceMappingURL=useGitBranchName.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useGitBranchName.js","sourceRoot":"","sources":["../../../../src/ui/hooks/useGitBranchName.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AACzD,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAC1C,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,UAAU,MAAM,kBAAkB,CAAC;AAC1C,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,MAAM,UAAU,gBAAgB,CAAC,GAAW;IAC1C,MAAM,CAAC,UAAU,EAAE,aAAa,CAAC,GAAG,QAAQ,CAAqB,SAAS,CAAC,CAAC;IAE5E,MAAM,eAAe,GAAG,WAAW,CACjC,GAAG,EAAE,CACH,IAAI,CACF,iCAAiC,EACjC,EAAE,GAAG,EAAE,EACP,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE;QACzB,IAAI,KAAK,EAAE,CAAC;YACV,aAAa,CAAC,SAAS,CAAC,CAAC;YACzB,OAAO;QACT,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC;QACxC,IAAI,MAAM,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;YAChC,aAAa,CAAC,MAAM,CAAC,CAAC;QACxB,CAAC;aAAM,CAAC;YACN,IAAI,CACF,4BAA4B,EAC5B,EAAE,GAAG,EAAE,EACP,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE;gBACzB,IAAI,KAAK,EAAE,CAAC;oBACV,aAAa,CAAC,SAAS,CAAC,CAAC;oBACzB,OAAO;gBACT,CAAC;gBACD,aAAa,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC;YAC1C,CAAC,CACF,CAAC;QACJ,CAAC;IACH,CAAC,CACF,EACH,CAAC,GAAG,EAAE,aAAa,CAAC,CACrB,CAAC;IAEF,SAAS,CAAC,GAAG,EAAE;QACb,eAAe,EAAE,CAAC,CAAC,gBAAgB;QAEnC,MAAM,eAAe,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;QAC/D,IAAI,OAAiC,CAAC;QAEtC,MAAM,YAAY,GAAG,KAAK,IAAI,EAAE;YAC9B,IAAI,CAAC;gBACH,iFAAiF;gBACjF,MAAM,UAAU,CAAC,MAAM,CAAC,eAAe,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;gBAC5D,OAAO,GAAG,EAAE,CAAC,KAAK,CAAC,eAAe,EAAE,CAAC,SAAiB,EAAE,EAAE;oBACxD,uEAAuE;oBACvE,IAAI,SAAS,KAAK,QAAQ,IAAI,SAAS,KAAK,QAAQ,EAAE,CAAC;wBACrD,6BAA6B;wBAC7B,eAAe,EAAE,CAAC;oBACpB,CAAC;gBACH,CAAC,CAAC,CAAC;YACL,CAAC;YAAC,OAAO,WAAW,EAAE,CAAC;gBACrB,0EAA0E;gBAC1E,0CAA0C;gBAC1C,wDAAwD;YAC1D,CAAC;QACH,CAAC,CAAC;QAEF,YAAY,EAAE,CAAC;QAEf,OAAO,GAAG,EAAE;YACV,OAAO,EAAE,KAAK,EAAE,CAAC;QACnB,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC,CAAC;IAE3B,OAAO,UAAU,CAAC;AACpB,CAAC"}

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

@@ -0,0 +1,22 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { HistoryItem } from '../types.js';
+type HistoryItemUpdater = (prevItem: HistoryItem) => Partial<Omit<HistoryItem, 'id'>>;
+export interface UseHistoryManagerReturn {
+    history: HistoryItem[];
+    addItem: (itemData: Omit<HistoryItem, 'id'>, baseTimestamp: number) => number;
+    updateItem: (id: number, updates: Partial<Omit<HistoryItem, 'id'>> | HistoryItemUpdater) => void;
+    clearItems: () => void;
+    loadHistory: (newHistory: HistoryItem[]) => void;
+}
+/**
+ * Custom hook to manage the chat history state.
+ *
+ * Encapsulates the history array, message ID generation, adding items,
+ * updating items, and clearing the history.
+ */
+export declare function useHistory(): UseHistoryManagerReturn;
+export {};

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

@@ -0,0 +1,72 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { useState, useRef, useCallback } from 'react';
+/**
+ * Custom hook to manage the chat history state.
+ *
+ * Encapsulates the history array, message ID generation, adding items,
+ * updating items, and clearing the history.
+ */
+export function useHistory() {
+    const [history, setHistory] = useState([]);
+    const messageIdCounterRef = useRef(0);
+    // Generates a unique message ID based on a timestamp and a counter.
+    const getNextMessageId = useCallback((baseTimestamp) => {
+        messageIdCounterRef.current += 1;
+        return baseTimestamp + messageIdCounterRef.current;
+    }, []);
+    const loadHistory = useCallback((newHistory) => {
+        setHistory(newHistory);
+    }, []);
+    // Adds a new item to the history state with a unique ID.
+    const addItem = useCallback((itemData, baseTimestamp) => {
+        const id = getNextMessageId(baseTimestamp);
+        const newItem = { ...itemData, id };
+        setHistory((prevHistory) => {
+            if (prevHistory.length > 0) {
+                const lastItem = prevHistory[prevHistory.length - 1];
+                // Prevent adding duplicate consecutive user messages
+                if (lastItem.type === 'user' &&
+                    newItem.type === 'user' &&
+                    lastItem.text === newItem.text) {
+                    return prevHistory; // Don't add the duplicate
+                }
+            }
+            return [...prevHistory, newItem];
+        });
+        return id; // Return the generated ID (even if not added, to keep signature)
+    }, [getNextMessageId]);
+    /**
+     * Updates an existing history item identified by its ID.
+     * @deprecated Prefer not to update history item directly as we are currently
+     * rendering all history items in <Static /> for performance reasons. Only use
+     * if ABSOLUTELY NECESSARY
+     */
+    //
+    const updateItem = useCallback((id, updates) => {
+        setHistory((prevHistory) => prevHistory.map((item) => {
+            if (item.id === id) {
+                // Apply updates based on whether it's an object or a function
+                const newUpdates = typeof updates === 'function' ? updates(item) : updates;
+                return { ...item, ...newUpdates };
+            }
+            return item;
+        }));
+    }, []);
+    // Clears the entire history state and resets the ID counter.
+    const clearItems = useCallback(() => {
+        setHistory([]);
+        messageIdCounterRef.current = 0;
+    }, []);
+    return {
+        history,
+        addItem,
+        updateItem,
+        clearItems,
+        loadHistory,
+    };
+}
+//# sourceMappingURL=useHistoryManager.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useHistoryManager.js","sourceRoot":"","sources":["../../../../src/ui/hooks/useHistoryManager.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AAmBtD;;;;;GAKG;AACH,MAAM,UAAU,UAAU;IACxB,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,QAAQ,CAAgB,EAAE,CAAC,CAAC;IAC1D,MAAM,mBAAmB,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;IAEtC,oEAAoE;IACpE,MAAM,gBAAgB,GAAG,WAAW,CAAC,CAAC,aAAqB,EAAU,EAAE;QACrE,mBAAmB,CAAC,OAAO,IAAI,CAAC,CAAC;QACjC,OAAO,aAAa,GAAG,mBAAmB,CAAC,OAAO,CAAC;IACrD,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,MAAM,WAAW,GAAG,WAAW,CAAC,CAAC,UAAyB,EAAE,EAAE;QAC5D,UAAU,CAAC,UAAU,CAAC,CAAC;IACzB,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,yDAAyD;IACzD,MAAM,OAAO,GAAG,WAAW,CACzB,CAAC,QAAiC,EAAE,aAAqB,EAAU,EAAE;QACnE,MAAM,EAAE,GAAG,gBAAgB,CAAC,aAAa,CAAC,CAAC;QAC3C,MAAM,OAAO,GAAgB,EAAE,GAAG,QAAQ,EAAE,EAAE,EAAiB,CAAC;QAEhE,UAAU,CAAC,CAAC,WAAW,EAAE,EAAE;YACzB,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC3B,MAAM,QAAQ,GAAG,WAAW,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;gBACrD,qDAAqD;gBACrD,IACE,QAAQ,CAAC,IAAI,KAAK,MAAM;oBACxB,OAAO,CAAC,IAAI,KAAK,MAAM;oBACvB,QAAQ,CAAC,IAAI,KAAK,OAAO,CAAC,IAAI,EAC9B,CAAC;oBACD,OAAO,WAAW,CAAC,CAAC,0BAA0B;gBAChD,CAAC;YACH,CAAC;YACD,OAAO,CAAC,GAAG,WAAW,EAAE,OAAO,CAAC,CAAC;QACnC,CAAC,CAAC,CAAC;QACH,OAAO,EAAE,CAAC,CAAC,iEAAiE;IAC9E,CAAC,EACD,CAAC,gBAAgB,CAAC,CACnB,CAAC;IAEF;;;;;OAKG;IACH,EAAE;IACF,MAAM,UAAU,GAAG,WAAW,CAC5B,CACE,EAAU,EACV,OAA8D,EAC9D,EAAE;QACF,UAAU,CAAC,CAAC,WAAW,EAAE,EAAE,CACzB,WAAW,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;YACvB,IAAI,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC;gBACnB,8DAA8D;gBAC9D,MAAM,UAAU,GACd,OAAO,OAAO,KAAK,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;gBAC1D,OAAO,EAAE,GAAG,IAAI,EAAE,GAAG,UAAU,EAAiB,CAAC;YACnD,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC,CAAC,CACH,CAAC;IACJ,CAAC,EACD,EAAE,CACH,CAAC;IAEF,6DAA6D;IAC7D,MAAM,UAAU,GAAG,WAAW,CAAC,GAAG,EAAE;QAClC,UAAU,CAAC,EAAE,CAAC,CAAC;QACf,mBAAmB,CAAC,OAAO,GAAG,CAAC,CAAC;IAClC,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,OAAO;QACL,OAAO;QACP,OAAO;QACP,UAAU;QACV,UAAU;QACV,WAAW;KACZ,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,19 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+interface UseInputHistoryProps {
+    userMessages: readonly string[];
+    onSubmit: (value: string) => void;
+    isActive: boolean;
+    currentQuery: string;
+    onChange: (value: string) => void;
+}
+interface UseInputHistoryReturn {
+    handleSubmit: (value: string) => void;
+    navigateUp: () => boolean;
+    navigateDown: () => boolean;
+}
+export declare function useInputHistory({ userMessages, onSubmit, isActive, currentQuery, onChange, }: UseInputHistoryProps): UseInputHistoryReturn;
+export {};

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

@@ -0,0 +1,84 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { useState, useCallback } from 'react';
+export function useInputHistory({ userMessages, onSubmit, isActive, currentQuery, onChange, }) {
+    const [historyIndex, setHistoryIndex] = useState(-1);
+    const [originalQueryBeforeNav, setOriginalQueryBeforeNav] = useState('');
+    const resetHistoryNav = useCallback(() => {
+        setHistoryIndex(-1);
+        setOriginalQueryBeforeNav('');
+    }, []);
+    const handleSubmit = useCallback((value) => {
+        const trimmedValue = value.trim();
+        if (trimmedValue) {
+            onSubmit(trimmedValue); // Parent handles clearing the query
+        }
+        resetHistoryNav();
+    }, [onSubmit, resetHistoryNav]);
+    const navigateUp = useCallback(() => {
+        if (!isActive)
+            return false;
+        if (userMessages.length === 0)
+            return false;
+        let nextIndex = historyIndex;
+        if (historyIndex === -1) {
+            // Store the current query from the parent before navigating
+            setOriginalQueryBeforeNav(currentQuery);
+            nextIndex = 0;
+        }
+        else if (historyIndex < userMessages.length - 1) {
+            nextIndex = historyIndex + 1;
+        }
+        else {
+            return false; // Already at the oldest message
+        }
+        if (nextIndex !== historyIndex) {
+            setHistoryIndex(nextIndex);
+            const newValue = userMessages[userMessages.length - 1 - nextIndex];
+            onChange(newValue);
+            return true;
+        }
+        return false;
+    }, [
+        historyIndex,
+        setHistoryIndex,
+        onChange,
+        userMessages,
+        isActive,
+        currentQuery, // Use currentQuery from props
+        setOriginalQueryBeforeNav,
+    ]);
+    const navigateDown = useCallback(() => {
+        if (!isActive)
+            return false;
+        if (historyIndex === -1)
+            return false; // Not currently navigating history
+        const nextIndex = historyIndex - 1;
+        setHistoryIndex(nextIndex);
+        if (nextIndex === -1) {
+            // Reached the end of history navigation, restore original query
+            onChange(originalQueryBeforeNav);
+        }
+        else {
+            const newValue = userMessages[userMessages.length - 1 - nextIndex];
+            onChange(newValue);
+        }
+        return true;
+    }, [
+        historyIndex,
+        setHistoryIndex,
+        originalQueryBeforeNav,
+        onChange,
+        userMessages,
+        isActive,
+    ]);
+    return {
+        handleSubmit,
+        navigateUp,
+        navigateDown,
+    };
+}
+//# sourceMappingURL=useInputHistory.js.map

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

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

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

@@ -0,0 +1,29 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export interface Key {
+    name: string;
+    ctrl: boolean;
+    meta: boolean;
+    shift: boolean;
+    paste: boolean;
+    sequence: string;
+}
+/**
+ * A hook that listens for keypress events from stdin, providing a
+ * key object that mirrors the one from Node's `readline` module,
+ * adding a 'paste' flag for characters input as part of a bracketed
+ * paste (when enabled).
+ *
+ * Pastes are currently sent as a single key event where the full paste
+ * is in the sequence field.
+ *
+ * @param onKeypress - The callback function to execute on each keypress.
+ * @param options - Options to control the hook's behavior.
+ * @param options.isActive - Whether the hook should be actively listening for input.
+ */
+export declare function useKeypress(onKeypress: (key: Key) => void, { isActive }: {
+    isActive: boolean;
+}): void;

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

@@ -0,0 +1,86 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { useEffect, useRef } from 'react';
+import { useStdin } from 'ink';
+import readline from 'readline';
+/**
+ * A hook that listens for keypress events from stdin, providing a
+ * key object that mirrors the one from Node's `readline` module,
+ * adding a 'paste' flag for characters input as part of a bracketed
+ * paste (when enabled).
+ *
+ * Pastes are currently sent as a single key event where the full paste
+ * is in the sequence field.
+ *
+ * @param onKeypress - The callback function to execute on each keypress.
+ * @param options - Options to control the hook's behavior.
+ * @param options.isActive - Whether the hook should be actively listening for input.
+ */
+export function useKeypress(onKeypress, { isActive }) {
+    const { stdin, setRawMode } = useStdin();
+    const onKeypressRef = useRef(onKeypress);
+    useEffect(() => {
+        onKeypressRef.current = onKeypress;
+    }, [onKeypress]);
+    useEffect(() => {
+        if (!isActive || !stdin.isTTY) {
+            return;
+        }
+        setRawMode(true);
+        const rl = readline.createInterface({ input: stdin });
+        let isPaste = false;
+        let pasteBuffer = Buffer.alloc(0);
+        const handleKeypress = (_, key) => {
+            if (key.name === 'paste-start') {
+                isPaste = true;
+            }
+            else if (key.name === 'paste-end') {
+                isPaste = false;
+                onKeypressRef.current({
+                    name: '',
+                    ctrl: false,
+                    meta: false,
+                    shift: false,
+                    paste: true,
+                    sequence: pasteBuffer.toString(),
+                });
+                pasteBuffer = Buffer.alloc(0);
+            }
+            else {
+                if (isPaste) {
+                    pasteBuffer = Buffer.concat([pasteBuffer, Buffer.from(key.sequence)]);
+                }
+                else {
+                    // Handle special keys
+                    if (key.name === 'return' && key.sequence === '\x1B\r') {
+                        key.meta = true;
+                    }
+                    onKeypressRef.current({ ...key, paste: isPaste });
+                }
+            }
+        };
+        readline.emitKeypressEvents(stdin, rl);
+        stdin.on('keypress', handleKeypress);
+        return () => {
+            stdin.removeListener('keypress', handleKeypress);
+            rl.close();
+            setRawMode(false);
+            // If we are in the middle of a paste, send what we have.
+            if (isPaste) {
+                onKeypressRef.current({
+                    name: '',
+                    ctrl: false,
+                    meta: false,
+                    shift: false,
+                    paste: true,
+                    sequence: pasteBuffer.toString(),
+                });
+                pasteBuffer = Buffer.alloc(0);
+            }
+        };
+    }, [isActive, stdin, setRawMode]);
+}
+//# sourceMappingURL=useKeypress.js.map

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

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

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

@@ -0,0 +1,10 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { StreamingState } from '../types.js';
+export declare const useLoadingIndicator: (streamingState: StreamingState) => {
+    elapsedTime: number;
+    currentLoadingPhrase: string;
+};

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

@@ -0,0 +1,44 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { StreamingState } from '../types.js';
+import { useTimer } from './useTimer.js';
+import { usePhraseCycler } from './usePhraseCycler.js';
+import { useState, useEffect, useRef } from 'react'; // Added useRef
+export const useLoadingIndicator = (streamingState) => {
+    const [timerResetKey, setTimerResetKey] = useState(0);
+    const isTimerActive = streamingState === StreamingState.Responding;
+    const elapsedTimeFromTimer = useTimer(isTimerActive, timerResetKey);
+    const isPhraseCyclingActive = streamingState === StreamingState.Responding;
+    const isWaiting = streamingState === StreamingState.WaitingForConfirmation;
+    const currentLoadingPhrase = usePhraseCycler(isPhraseCyclingActive, isWaiting);
+    const [retainedElapsedTime, setRetainedElapsedTime] = useState(0);
+    const prevStreamingStateRef = useRef(null);
+    useEffect(() => {
+        if (prevStreamingStateRef.current === StreamingState.WaitingForConfirmation &&
+            streamingState === StreamingState.Responding) {
+            setTimerResetKey((prevKey) => prevKey + 1);
+            setRetainedElapsedTime(0); // Clear retained time when going back to responding
+        }
+        else if (streamingState === StreamingState.Idle &&
+            prevStreamingStateRef.current === StreamingState.Responding) {
+            setTimerResetKey((prevKey) => prevKey + 1); // Reset timer when becoming idle from responding
+            setRetainedElapsedTime(0);
+        }
+        else if (streamingState === StreamingState.WaitingForConfirmation) {
+            // Capture the time when entering WaitingForConfirmation
+            // elapsedTimeFromTimer will hold the last value from when isTimerActive was true.
+            setRetainedElapsedTime(elapsedTimeFromTimer);
+        }
+        prevStreamingStateRef.current = streamingState;
+    }, [streamingState, elapsedTimeFromTimer]);
+    return {
+        elapsedTime: streamingState === StreamingState.WaitingForConfirmation
+            ? retainedElapsedTime
+            : elapsedTimeFromTimer,
+        currentLoadingPhrase,
+    };
+};
+//# sourceMappingURL=useLoadingIndicator.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useLoadingIndicator.js","sourceRoot":"","sources":["../../../../src/ui/hooks/useLoadingIndicator.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC,CAAC,eAAe;AAEpE,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,cAA8B,EAAE,EAAE;IACpE,MAAM,CAAC,aAAa,EAAE,gBAAgB,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;IACtD,MAAM,aAAa,GAAG,cAAc,KAAK,cAAc,CAAC,UAAU,CAAC;IAEnE,MAAM,oBAAoB,GAAG,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC,CAAC;IAEpE,MAAM,qBAAqB,GAAG,cAAc,KAAK,cAAc,CAAC,UAAU,CAAC;IAC3E,MAAM,SAAS,GAAG,cAAc,KAAK,cAAc,CAAC,sBAAsB,CAAC;IAC3E,MAAM,oBAAoB,GAAG,eAAe,CAC1C,qBAAqB,EACrB,SAAS,CACV,CAAC;IAEF,MAAM,CAAC,mBAAmB,EAAE,sBAAsB,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;IAClE,MAAM,qBAAqB,GAAG,MAAM,CAAwB,IAAI,CAAC,CAAC;IAElE,SAAS,CAAC,GAAG,EAAE;QACb,IACE,qBAAqB,CAAC,OAAO,KAAK,cAAc,CAAC,sBAAsB;YACvE,cAAc,KAAK,cAAc,CAAC,UAAU,EAC5C,CAAC;YACD,gBAAgB,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC;YAC3C,sBAAsB,CAAC,CAAC,CAAC,CAAC,CAAC,oDAAoD;QACjF,CAAC;aAAM,IACL,cAAc,KAAK,cAAc,CAAC,IAAI;YACtC,qBAAqB,CAAC,OAAO,KAAK,cAAc,CAAC,UAAU,EAC3D,CAAC;YACD,gBAAgB,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,iDAAiD;YAC7F,sBAAsB,CAAC,CAAC,CAAC,CAAC;QAC5B,CAAC;aAAM,IAAI,cAAc,KAAK,cAAc,CAAC,sBAAsB,EAAE,CAAC;YACpE,wDAAwD;YACxD,kFAAkF;YAClF,sBAAsB,CAAC,oBAAoB,CAAC,CAAC;QAC/C,CAAC;QAED,qBAAqB,CAAC,OAAO,GAAG,cAAc,CAAC;IACjD,CAAC,EAAE,CAAC,cAAc,EAAE,oBAAoB,CAAC,CAAC,CAAC;IAE3C,OAAO;QACL,WAAW,EACT,cAAc,KAAK,cAAc,CAAC,sBAAsB;YACtD,CAAC,CAAC,mBAAmB;YACrB,CAAC,CAAC,oBAAoB;QAC1B,oBAAoB;KACrB,CAAC;AACJ,CAAC,CAAC"}

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

@@ -0,0 +1,10 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Logger } from '@google/gemini-cli-core';
+/**
+ * Hook to manage the logger instance.
+ */
+export declare const useLogger: () => Logger | null;

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

@@ -0,0 +1,29 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { useState, useEffect } from 'react';
+import { sessionId, Logger } from '@google/gemini-cli-core';
+/**
+ * Hook to manage the logger instance.
+ */
+export const useLogger = () => {
+    const [logger, setLogger] = useState(null);
+    useEffect(() => {
+        const newLogger = new Logger(sessionId);
+        /**
+         * Start async initialization, no need to await. Using await slows down the
+         * time from launch to see the gemini-cli prompt and it's better to not save
+         * messages than for the cli to hanging waiting for the logger to loading.
+         */
+        newLogger
+            .initialize()
+            .then(() => {
+            setLogger(newLogger);
+        })
+            .catch(() => { });
+    }, []);
+    return logger;
+};
+//# sourceMappingURL=useLogger.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useLogger.js","sourceRoot":"","sources":["../../../../src/ui/hooks/useLogger.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAE5D;;GAEG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,GAAG,EAAE;IAC5B,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,QAAQ,CAAgB,IAAI,CAAC,CAAC;IAE1D,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,SAAS,GAAG,IAAI,MAAM,CAAC,SAAS,CAAC,CAAC;QACxC;;;;WAIG;QACH,SAAS;aACN,UAAU,EAAE;aACZ,IAAI,CAAC,GAAG,EAAE;YACT,SAAS,CAAC,SAAS,CAAC,CAAC;QACvB,CAAC,CAAC;aACD,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IACrB,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC"}

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

@@ -0,0 +1,14 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export declare const WITTY_LOADING_PHRASES: string[];
+export declare const PHRASE_CHANGE_INTERVAL_MS = 15000;
+/**
+ * Custom hook to manage cycling through loading phrases.
+ * @param isActive Whether the phrase cycling should be active.
+ * @param isWaiting Whether to show a specific waiting phrase.
+ * @returns The current loading phrase.
+ */
+export declare const usePhraseCycler: (isActive: boolean, isWaiting: boolean) => string;