@qduc/term2 0.1.0

package/dist/hooks/use-path-completion.test.js

@@ -0,0 +1,29 @@
+import test from 'ava';
+import React from 'react';
+import { render } from 'ink-testing-library';
+import { InputProvider } from '../context/InputContext.js';
+import { usePathCompletion } from './use-path-completion.js';
+test('open() is blocked immediately after close() for path completion', async (t) => {
+    let control = null;
+    const Test = () => {
+        const hook = usePathCompletion();
+        control = hook;
+        return React.createElement(React.Fragment, null, hook.isOpen ? 'OPEN' : 'CLOSED');
+    };
+    const { lastFrame } = render(React.createElement(InputProvider, null, React.createElement(Test, null)));
+    t.true(lastFrame().includes('CLOSED'));
+    control.open(0);
+    await new Promise(resolve => setTimeout(resolve, 50));
+    t.true(lastFrame().includes('OPEN'));
+    control.close();
+    await new Promise(resolve => setTimeout(resolve, 50));
+    t.true(lastFrame().includes('CLOSED'));
+    control.open(0);
+    await new Promise(resolve => setTimeout(resolve, 50));
+    t.true(lastFrame().includes('CLOSED'));
+    await new Promise(resolve => setTimeout(resolve, 350));
+    control.open(0);
+    await new Promise(resolve => setTimeout(resolve, 50));
+    t.true(lastFrame().includes('OPEN'));
+});
+//# sourceMappingURL=use-path-completion.test.js.map

package/dist/hooks/use-path-completion.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-path-completion.test.js","sourceRoot":"","sources":["../../source/hooks/use-path-completion.test.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,KAAK,CAAC;AACvB,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAC,MAAM,EAAC,MAAM,qBAAqB,CAAC;AAC3C,OAAO,EAAC,aAAa,EAAC,MAAM,4BAA4B,CAAC;AACzD,OAAO,EAAC,iBAAiB,EAAC,MAAM,0BAA0B,CAAC;AAE3D,IAAI,CAAC,iEAAiE,EAAE,KAAK,EAAC,CAAC,EAAC,EAAE;IAC9E,IAAI,OAAO,GAAQ,IAAI,CAAC;IAExB,MAAM,IAAI,GAAG,GAAG,EAAE;QACd,MAAM,IAAI,GAAG,iBAAiB,EAAE,CAAC;QACjC,OAAO,GAAG,IAAI,CAAC;QACf,OAAO,KAAK,CAAC,aAAa,CAAC,KAAK,CAAC,QAAQ,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;IACtF,CAAC,CAAC;IAEF,MAAM,EAAC,SAAS,EAAC,GAAG,MAAM,CACtB,KAAK,CAAC,aAAa,CAAC,aAAa,EAAE,IAAI,EAAE,KAAK,CAAC,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAC5E,CAAC;IAEF,CAAC,CAAC,IAAI,CAAC,SAAS,EAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;IACxC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAChB,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;IACtD,CAAC,CAAC,IAAI,CAAC,SAAS,EAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;IACtC,OAAO,CAAC,KAAK,EAAE,CAAC;IAChB,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;IACtD,CAAC,CAAC,IAAI,CAAC,SAAS,EAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;IACxC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAChB,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;IACtD,CAAC,CAAC,IAAI,CAAC,SAAS,EAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;IACxC,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC;IACvD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAChB,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;IACtD,CAAC,CAAC,IAAI,CAAC,SAAS,EAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;AAC1C,CAAC,CAAC,CAAC"}

package/dist/hooks/use-setting.d.ts

@@ -0,0 +1,7 @@
+import type { SettingsService } from '../services/settings-service.js';
+/**
+ * Hook to subscribe to a specific setting value.
+ * Updates the component whenever the setting changes.
+ */
+export declare function useSetting<T>(settingsService: SettingsService, key: string): T;
+//# sourceMappingURL=use-setting.d.ts.map

package/dist/hooks/use-setting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-setting.d.ts","sourceRoot":"","sources":["../../source/hooks/use-setting.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,iCAAiC,CAAC;AAErE;;;GAGG;AACH,wBAAgB,UAAU,CAAC,CAAC,EACxB,eAAe,EAAE,eAAe,EAChC,GAAG,EAAE,MAAM,GACZ,CAAC,CAkCH"}

package/dist/hooks/use-setting.js

@@ -0,0 +1,35 @@
+import { useState, useEffect } from 'react';
+/**
+ * Hook to subscribe to a specific setting value.
+ * Updates the component whenever the setting changes.
+ */
+export function useSetting(settingsService, key) {
+    const [value, setValue] = useState(() => settingsService.get(key));
+    useEffect(() => {
+        // Ensure we have the latest value on mount/update
+        const currentValue = settingsService.get(key);
+        if (currentValue !== value) {
+            setValue(currentValue);
+        }
+        const unsubscribe = settingsService.onChange(changedKey => {
+            // optimized: only update if the relevant key changed
+            // simpler version: just check if the value actually changed
+            if (!changedKey ||
+                changedKey === key ||
+                changedKey.startsWith(key + '.') ||
+                key.startsWith(changedKey + '.')) {
+                const newValue = settingsService.get(key);
+                setValue(prev => {
+                    // Simple equality check to avoid rerenders if value hasn't effectively changed
+                    if (JSON.stringify(prev) !== JSON.stringify(newValue)) {
+                        return newValue;
+                    }
+                    return prev;
+                });
+            }
+        });
+        return unsubscribe;
+    }, [key]);
+    return value;
+}
+//# sourceMappingURL=use-setting.js.map

package/dist/hooks/use-setting.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-setting.js","sourceRoot":"","sources":["../../source/hooks/use-setting.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,QAAQ,EAAE,SAAS,EAAC,MAAM,OAAO,CAAC;AAG1C;;;GAGG;AACH,MAAM,UAAU,UAAU,CACtB,eAAgC,EAChC,GAAW;IAEX,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAI,GAAG,EAAE,CAAC,eAAe,CAAC,GAAG,CAAI,GAAG,CAAC,CAAC,CAAC;IAEzE,SAAS,CAAC,GAAG,EAAE;QACX,kDAAkD;QAClD,MAAM,YAAY,GAAG,eAAe,CAAC,GAAG,CAAI,GAAG,CAAC,CAAC;QACjD,IAAI,YAAY,KAAK,KAAK,EAAE,CAAC;YACzB,QAAQ,CAAC,YAAY,CAAC,CAAC;QAC3B,CAAC;QAED,MAAM,WAAW,GAAG,eAAe,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE;YACtD,qDAAqD;YACrD,4DAA4D;YAC5D,IACI,CAAC,UAAU;gBACX,UAAU,KAAK,GAAG;gBAClB,UAAU,CAAC,UAAU,CAAC,GAAG,GAAG,GAAG,CAAC;gBAChC,GAAG,CAAC,UAAU,CAAC,UAAU,GAAG,GAAG,CAAC,EAClC,CAAC;gBACC,MAAM,QAAQ,GAAG,eAAe,CAAC,GAAG,CAAI,GAAG,CAAC,CAAC;gBAC7C,QAAQ,CAAC,IAAI,CAAC,EAAE;oBACZ,+EAA+E;oBAC/E,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC;wBACpD,OAAO,QAAQ,CAAC;oBACpB,CAAC;oBACD,OAAO,IAAI,CAAC;gBAChB,CAAC,CAAC,CAAC;YACP,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,OAAO,WAAW,CAAC;IACvB,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAEV,OAAO,KAAK,CAAC;AACjB,CAAC"}

package/dist/hooks/use-settings-completion.d.ts

@@ -0,0 +1,23 @@
+import Fuse from 'fuse.js';
+import { type SettingsService } from '../services/settings-service.js';
+export type SettingCompletionItem = {
+    key: string;
+    description?: string;
+    currentValue?: string | number | boolean;
+};
+export declare function buildSettingsList(settingKeys: Record<string, string>, descriptions: Record<string, string>, excludeSensitive?: boolean, getCurrentValue?: (key: string) => string | number | boolean | undefined): SettingCompletionItem[];
+export declare function filterSettingsByQuery(settings: SettingCompletionItem[], query: string, fuseInstance: Fuse<SettingCompletionItem>, maxResults?: number): SettingCompletionItem[];
+export declare function clampIndex(currentIndex: number, arrayLength: number): number;
+export declare const useSettingsCompletion: (settingsService: SettingsService) => {
+    isOpen: boolean;
+    triggerIndex: number | null;
+    query: string;
+    filteredEntries: SettingCompletionItem[];
+    selectedIndex: number;
+    open: (startIndex: number, _initialQuery?: string) => void;
+    close: () => void;
+    moveUp: () => void;
+    moveDown: () => void;
+    getSelectedItem: () => SettingCompletionItem | undefined;
+};
+//# sourceMappingURL=use-settings-completion.d.ts.map

package/dist/hooks/use-settings-completion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-settings-completion.d.ts","sourceRoot":"","sources":["../../source/hooks/use-settings-completion.ts"],"names":[],"mappings":"AACA,OAAO,IAAI,MAAM,SAAS,CAAC;AAC3B,OAAO,EAGH,KAAK,eAAe,EACvB,MAAM,iCAAiC,CAAC;AAGzC,MAAM,MAAM,qBAAqB,GAAG;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;CAC5C,CAAC;AA4DF,wBAAgB,iBAAiB,CAC7B,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACnC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACpC,gBAAgB,GAAE,OAAc,EAChC,eAAe,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,GACzE,qBAAqB,EAAE,CAYzB;AAED,wBAAgB,qBAAqB,CACjC,QAAQ,EAAE,qBAAqB,EAAE,EACjC,KAAK,EAAE,MAAM,EACb,YAAY,EAAE,IAAI,CAAC,qBAAqB,CAAC,EACzC,UAAU,GAAE,MAAW,GACxB,qBAAqB,EAAE,CASzB;AAED,wBAAgB,UAAU,CAAC,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAK5E;AAED,eAAO,MAAM,qBAAqB,GAAI,iBAAiB,eAAe;;;;;;uBAkDjD,MAAM;;;;;CA2D1B,CAAC"}

package/dist/hooks/use-settings-completion.js

@@ -0,0 +1,164 @@
+import { useCallback, useEffect, useMemo, useState } from 'react';
+import Fuse from 'fuse.js';
+import { SETTING_KEYS, SENSITIVE_SETTINGS, } from '../services/settings-service.js';
+import { useInputContext } from '../context/InputContext.js';
+const SETTING_DESCRIPTIONS = {
+    [SETTING_KEYS.AGENT_MODEL]: 'The AI model to use (e.g. gpt-4, claude-3-opus)',
+    [SETTING_KEYS.AGENT_REASONING_EFFORT]: 'Reasoning effort level (default, low, medium, high)',
+    [SETTING_KEYS.AGENT_TEMPERATURE]: 'Model temperature (0-2, controls randomness)',
+    // agent.provider is hidden from UI - it can only be changed via model menu
+    [SETTING_KEYS.AGENT_MAX_TURNS]: 'Maximum conversation turns',
+    [SETTING_KEYS.AGENT_RETRY_ATTEMPTS]: 'Number of retry attempts for failed requests',
+    [SETTING_KEYS.SHELL_TIMEOUT]: 'Shell command timeout in milliseconds',
+    [SETTING_KEYS.SHELL_MAX_OUTPUT_LINES]: 'Maximum lines of shell output to capture',
+    [SETTING_KEYS.SHELL_MAX_OUTPUT_CHARS]: 'Maximum characters of shell output to capture',
+    [SETTING_KEYS.UI_HISTORY_SIZE]: 'Number of history items to keep',
+    [SETTING_KEYS.LOGGING_LOG_LEVEL]: 'Logging level (debug, info, warn, error)',
+    [SETTING_KEYS.LOGGING_SUPPRESS_CONSOLE]: 'Suppress console output to avoid interfering with Ink UI',
+};
+/**
+ * Settings that should be hidden from the UI (not for security, but for UX/workflow)
+ * - agent.provider: Can only be changed at the start of a new conversation via model menu
+ */
+const HIDDEN_SETTINGS = new Set([SETTING_KEYS.AGENT_PROVIDER]);
+const MAX_RESULTS = 10;
+/**
+ * Get the set of sensitive setting keys that should not appear in the UI
+ */
+function getSensitiveSettingKeysSet() {
+    return new Set(Object.values(SENSITIVE_SETTINGS));
+}
+/**
+ * Get the current value of a setting for display in the menu
+ */
+function getCurrentSettingValue(settingsService, key) {
+    try {
+        const value = settingsService.get(key);
+        // Format the value for display
+        if (typeof value === 'object') {
+            return JSON.stringify(value);
+        }
+        return value;
+    }
+    catch {
+        return undefined;
+    }
+}
+// Pure functions exported for testing
+export function buildSettingsList(settingKeys, descriptions, excludeSensitive = true, getCurrentValue) {
+    const sensitiveKeys = excludeSensitive
+        ? getSensitiveSettingKeysSet()
+        : new Set();
+    return Object.values(settingKeys)
+        .filter(key => !sensitiveKeys.has(key) && !HIDDEN_SETTINGS.has(key))
+        .map(key => ({
+        key,
+        description: descriptions[key] || '',
+        currentValue: getCurrentValue?.(key),
+    }));
+}
+export function filterSettingsByQuery(settings, query, fuseInstance, maxResults = 10) {
+    if (!query.trim()) {
+        return settings.slice(0, maxResults);
+    }
+    return fuseInstance
+        .search(query.trim())
+        .map(result => result.item)
+        .slice(0, maxResults);
+}
+export function clampIndex(currentIndex, arrayLength) {
+    if (arrayLength === 0) {
+        return 0;
+    }
+    return Math.min(currentIndex, arrayLength - 1);
+}
+export const useSettingsCompletion = (settingsService) => {
+    const { mode, setMode, input, triggerIndex, setTriggerIndex } = useInputContext();
+    const isOpen = mode === 'settings_completion';
+    // Derive query from input + triggerIndex
+    const query = useMemo(() => {
+        if (!isOpen || triggerIndex === null)
+            return '';
+        // triggerIndex is the end of "/settings " prefix
+        if (triggerIndex > input.length)
+            return '';
+        return input.slice(triggerIndex);
+    }, [isOpen, triggerIndex, input]);
+    const [selectedIndex, setSelectedIndex] = useState(0);
+    const [settingsVersion, setSettingsVersion] = useState(0);
+    // Refresh the list whenever a setting changes so currentValue stays accurate
+    useEffect(() => {
+        const unsubscribe = settingsService.onChange(() => {
+            setSettingsVersion(prev => prev + 1);
+        });
+        return unsubscribe;
+    }, [settingsService]);
+    const allSettings = useMemo(() => {
+        return buildSettingsList(SETTING_KEYS, SETTING_DESCRIPTIONS, true, (key) => getCurrentSettingValue(settingsService, key));
+    }, [settingsVersion, settingsService]);
+    const fuse = useMemo(() => {
+        return new Fuse(allSettings, {
+            keys: ['key', 'description'],
+            threshold: 0.4,
+        });
+    }, [allSettings]);
+    const filteredEntries = useMemo(() => {
+        return filterSettingsByQuery(allSettings, query, fuse, MAX_RESULTS);
+    }, [allSettings, fuse, query]);
+    useEffect(() => {
+        setSelectedIndex(prev => clampIndex(prev, filteredEntries.length));
+    }, [filteredEntries.length]);
+    const open = useCallback((startIndex, _initialQuery = '') => {
+        // If already in settings mode, do not reset selection.
+        if (mode === 'settings_completion')
+            return;
+        setMode('settings_completion');
+        setTriggerIndex(startIndex);
+        setSelectedIndex(0);
+    }, [mode, setMode, setTriggerIndex]);
+    const close = useCallback(() => {
+        if (mode === 'settings_completion') {
+            setMode('text');
+            setTriggerIndex(null);
+            setSelectedIndex(0);
+        }
+    }, [mode, setMode, setTriggerIndex]);
+    // updateQuery removed as it is derived
+    const moveUp = useCallback(() => {
+        setSelectedIndex(prev => {
+            if (filteredEntries.length === 0) {
+                return 0;
+            }
+            return prev > 0 ? prev - 1 : filteredEntries.length - 1;
+        });
+    }, [filteredEntries.length]);
+    const moveDown = useCallback(() => {
+        setSelectedIndex(prev => {
+            if (filteredEntries.length === 0) {
+                return 0;
+            }
+            return prev < filteredEntries.length - 1 ? prev + 1 : 0;
+        });
+    }, [filteredEntries.length]);
+    const getSelectedItem = useCallback(() => {
+        if (filteredEntries.length === 0) {
+            return undefined;
+        }
+        const safeIndex = clampIndex(selectedIndex, filteredEntries.length);
+        return filteredEntries[safeIndex];
+    }, [filteredEntries, selectedIndex]);
+    return {
+        isOpen,
+        triggerIndex,
+        query,
+        filteredEntries,
+        selectedIndex,
+        open,
+        close,
+        // updateQuery,
+        moveUp,
+        moveDown,
+        getSelectedItem,
+    };
+};
+//# sourceMappingURL=use-settings-completion.js.map

package/dist/hooks/use-settings-completion.js.map

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

package/dist/hooks/use-settings-completion.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=use-settings-completion.test.d.ts.map

package/dist/hooks/use-settings-completion.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-settings-completion.test.d.ts","sourceRoot":"","sources":["../../source/hooks/use-settings-completion.test.ts"],"names":[],"mappings":""}

package/dist/hooks/use-settings-completion.test.js

@@ -0,0 +1,334 @@
+import test from 'ava';
+import Fuse from 'fuse.js';
+import { buildSettingsList, filterSettingsByQuery, clampIndex, } from './use-settings-completion.js';
+// Mock setting keys for testing (matching actual SETTING_KEYS structure)
+const MOCK_SETTING_KEYS = {
+    AGENT_MODEL: 'agent.model',
+    AGENT_REASONING_EFFORT: 'agent.reasoningEffort',
+    AGENT_PROVIDER: 'agent.provider',
+    AGENT_MAX_TURNS: 'agent.maxTurns',
+    AGENT_RETRY_ATTEMPTS: 'agent.retryAttempts',
+    AGENT_OPENROUTER_API_KEY: 'agent.openrouter.apiKey',
+    AGENT_OPENROUTER_BASE_URL: 'agent.openrouter.baseUrl',
+    AGENT_OPENROUTER_REFERRER: 'agent.openrouter.referrer',
+    AGENT_OPENROUTER_TITLE: 'agent.openrouter.title',
+    SHELL_TIMEOUT: 'shell.timeout',
+    SHELL_MAX_OUTPUT_LINES: 'shell.maxOutputLines',
+    SHELL_MAX_OUTPUT_CHARS: 'shell.maxOutputChars',
+    UI_HISTORY_SIZE: 'ui.historySize',
+    LOGGING_LOG_LEVEL: 'logging.logLevel',
+    LOGGING_DISABLE: 'logging.disableLogging',
+    LOGGING_DEBUG: 'logging.debugLogging',
+    LOGGING_SUPPRESS_CONSOLE: 'logging.suppressConsoleOutput',
+    ENV_NODE_ENV: 'environment.nodeEnv',
+    APP_SHELL_PATH: 'app.shellPath',
+    TOOLS_LOG_FILE_OPS: 'tools.logFileOperations',
+    DEBUG_BASH_TOOL: 'debug.debugBashTool',
+};
+const MOCK_DESCRIPTIONS = {
+    'agent.model': 'The AI model to use (e.g. gpt-4, claude-3-opus)',
+    'agent.reasoningEffort': 'Reasoning effort level (default, low, medium, high)',
+    'agent.provider': 'AI provider (openai, openrouter)',
+    'agent.maxTurns': 'Maximum conversation turns',
+    'agent.retryAttempts': 'Number of retry attempts for failed requests',
+    'agent.openrouter.apiKey': 'OpenRouter API key',
+    'agent.openrouter.baseUrl': 'OpenRouter base URL',
+    'agent.openrouter.referrer': 'OpenRouter referrer',
+    'agent.openrouter.title': 'OpenRouter title',
+    'shell.timeout': 'Shell command timeout in milliseconds',
+    'shell.maxOutputLines': 'Maximum lines of shell output to capture',
+    'shell.maxOutputChars': 'Maximum characters of shell output to capture',
+    'ui.historySize': 'Number of history items to keep',
+    'logging.logLevel': 'Logging level (debug, info, warn, error)',
+    'logging.disableLogging': 'Disable all logging',
+    'logging.debugLogging': 'Enable debug logging',
+    'logging.suppressConsoleOutput': 'Suppress console output to avoid interfering with Ink UI',
+    'environment.nodeEnv': 'Node environment (development, production)',
+    'app.shellPath': 'Path to shell executable',
+    'tools.logFileOperations': 'Log file operations to disk',
+    'debug.debugBashTool': 'Enable bash tool debugging',
+};
+// buildSettingsList tests
+test('buildSettingsList - creates list from keys and descriptions', t => {
+    const result = buildSettingsList(MOCK_SETTING_KEYS, MOCK_DESCRIPTIONS);
+    // Should exclude 5 sensitive settings + 1 hidden setting by default
+    const expectedCount = Object.keys(MOCK_SETTING_KEYS).length - 6;
+    t.is(result.length, expectedCount);
+    t.true(result.every(() => true));
+    t.true(result.every(item => item.description !== undefined));
+});
+test('buildSettingsList - excludes sensitive settings by default', t => {
+    const result = buildSettingsList(MOCK_SETTING_KEYS, MOCK_DESCRIPTIONS);
+    const keys = new Set(result.map(item => item.key));
+    // Should not include sensitive settings
+    t.false(keys.has('agent.openrouter.apiKey'));
+    t.false(keys.has('agent.openrouter.baseUrl'));
+    t.false(keys.has('agent.openrouter.referrer'));
+    t.false(keys.has('agent.openrouter.title'));
+    t.false(keys.has('app.shellPath'));
+    // Should include non-sensitive settings
+    t.true(keys.has('agent.model'));
+    t.true(keys.has('shell.timeout'));
+});
+test('buildSettingsList - can include sensitive settings when requested', t => {
+    const result = buildSettingsList(MOCK_SETTING_KEYS, MOCK_DESCRIPTIONS, false);
+    const keys = new Set(result.map(item => item.key));
+    // Should include all settings except hidden ones when excludeSensitive is false
+    t.is(result.length, Object.keys(MOCK_SETTING_KEYS).length - 1);
+    t.true(keys.has('agent.openrouter.apiKey'));
+    t.true(keys.has('app.shellPath'));
+    // Hidden settings should still be excluded
+    t.false(keys.has('agent.provider'));
+});
+test('buildSettingsList - includes all non-sensitive setting keys', t => {
+    const result = buildSettingsList(MOCK_SETTING_KEYS, MOCK_DESCRIPTIONS);
+    const keys = result.map(item => item.key);
+    // Check specific non-sensitive keys that should be included
+    const nonSensitiveKeys = [
+        'agent.model',
+        'agent.reasoningEffort',
+        'agent.maxTurns',
+        'shell.timeout',
+        'logging.logLevel',
+    ];
+    for (const settingKey of nonSensitiveKeys) {
+        t.true(keys.includes(settingKey), `Missing key: ${settingKey}`);
+    }
+});
+test('buildSettingsList - maps descriptions correctly', t => {
+    const result = buildSettingsList(MOCK_SETTING_KEYS, MOCK_DESCRIPTIONS);
+    for (const item of result) {
+        t.is(item.description, MOCK_DESCRIPTIONS[item.key]);
+    }
+});
+test('buildSettingsList - includes current values when provided', t => {
+    const mockGetCurrentValue = (key) => {
+        const values = {
+            'agent.model': 'gpt-4o',
+            'shell.timeout': 120000,
+            'logging.logLevel': 'info',
+        };
+        return values[key] ?? 'default';
+    };
+    const result = buildSettingsList(MOCK_SETTING_KEYS, MOCK_DESCRIPTIONS, true, mockGetCurrentValue);
+    const agentModel = result.find(item => item.key === 'agent.model');
+    const shellTimeout = result.find(item => item.key === 'shell.timeout');
+    const logLevel = result.find(item => item.key === 'logging.logLevel');
+    t.is(agentModel?.currentValue, 'gpt-4o');
+    t.is(shellTimeout?.currentValue, 120000);
+    t.is(logLevel?.currentValue, 'info');
+});
+test('buildSettingsList - handles missing current values', t => {
+    const mockGetCurrentValue = (key) => {
+        if (key === 'agent.model') {
+            return 'gpt-4o';
+        }
+        return undefined;
+    };
+    const result = buildSettingsList(MOCK_SETTING_KEYS, MOCK_DESCRIPTIONS, true, mockGetCurrentValue);
+    const agentModel = result.find(item => item.key === 'agent.model');
+    const shellTimeout = result.find(item => item.key === 'shell.timeout');
+    t.is(agentModel?.currentValue, 'gpt-4o');
+    t.is(shellTimeout?.currentValue, undefined);
+});
+test('buildSettingsList - handles missing descriptions with empty string', t => {
+    const incompleteDescriptions = {
+        'agent.model': 'Model description',
+    };
+    const result = buildSettingsList(MOCK_SETTING_KEYS, incompleteDescriptions);
+    const agentModel = result.find(item => item.key === 'agent.model');
+    const shellTimeout = result.find(item => item.key === 'shell.timeout');
+    t.is(agentModel?.description, 'Model description');
+    t.is(shellTimeout?.description, '');
+});
+test('buildSettingsList - handles empty descriptions object', t => {
+    const result = buildSettingsList(MOCK_SETTING_KEYS, {});
+    // Should exclude sensitive settings + hidden settings
+    const expectedCount = Object.keys(MOCK_SETTING_KEYS).length - 6;
+    t.is(result.length, expectedCount);
+    t.true(result.every(item => item.description === ''));
+});
+test('buildSettingsList - no duplicate keys', t => {
+    const result = buildSettingsList(MOCK_SETTING_KEYS, MOCK_DESCRIPTIONS);
+    const keys = result.map(item => item.key);
+    const uniqueKeys = new Set(keys);
+    t.is(keys.length, uniqueKeys.size, 'Duplicate keys found');
+});
+// filterSettingsByQuery tests
+test('filterSettingsByQuery - empty query returns first N results', t => {
+    const settings = buildSettingsList(MOCK_SETTING_KEYS, MOCK_DESCRIPTIONS);
+    const fuse = new Fuse(settings, {
+        keys: ['key', 'description'],
+        threshold: 0.4,
+    });
+    const result = filterSettingsByQuery(settings, '', fuse, 3);
+    t.is(result.length, 3);
+});
+test('filterSettingsByQuery - whitespace-only query returns first N results', t => {
+    const settings = buildSettingsList(MOCK_SETTING_KEYS, MOCK_DESCRIPTIONS);
+    const fuse = new Fuse(settings, {
+        keys: ['key', 'description'],
+        threshold: 0.4,
+    });
+    const result = filterSettingsByQuery(settings, '   ', fuse, 3);
+    t.is(result.length, 3);
+});
+test('filterSettingsByQuery - exact key match returns result', t => {
+    const settings = buildSettingsList(MOCK_SETTING_KEYS, MOCK_DESCRIPTIONS);
+    const fuse = new Fuse(settings, {
+        keys: ['key', 'description'],
+        threshold: 0.4,
+    });
+    const result = filterSettingsByQuery(settings, 'agent.model', fuse, 10);
+    t.true(result.length > 0);
+    t.true(result.some(item => item.key === 'agent.model'));
+});
+test('filterSettingsByQuery - partial key match returns results', t => {
+    const settings = buildSettingsList(MOCK_SETTING_KEYS, MOCK_DESCRIPTIONS);
+    const fuse = new Fuse(settings, {
+        keys: ['key', 'description'],
+        threshold: 0.4,
+    });
+    const cases = [
+        { query: 'agent', expectedKeySubstring: 'agent' },
+        { query: 'shell', expectedKeySubstring: 'shell' },
+        { query: 'model', expectedKeySubstring: 'model' },
+    ];
+    for (const { query, expectedKeySubstring } of cases) {
+        const result = filterSettingsByQuery(settings, query, fuse, 10);
+        t.true(result.length > 0, `Query "${query}" should return results`);
+        t.true(result.some(item => item.key.includes(expectedKeySubstring)), `Query "${query}" should match key containing "${expectedKeySubstring}"`);
+    }
+});
+test('filterSettingsByQuery - search by description returns results', t => {
+    const settings = buildSettingsList(MOCK_SETTING_KEYS, MOCK_DESCRIPTIONS);
+    const fuse = new Fuse(settings, {
+        keys: ['key', 'description'],
+        threshold: 0.4,
+    });
+    const cases = [
+        { query: 'timeout', expectedKey: 'shell.timeout' },
+        { query: 'model', expectedKey: 'agent.model' },
+        { query: 'logging', expectedKey: 'logging.logLevel' },
+    ];
+    for (const { query, expectedKey } of cases) {
+        const result = filterSettingsByQuery(settings, query, fuse, 10);
+        t.true(result.length > 0, `Query "${query}" should return results`);
+        t.true(result.some(item => item.key === expectedKey), `Query "${query}" should find key "${expectedKey}"`);
+    }
+});
+test('filterSettingsByQuery - respects maxResults parameter', t => {
+    const settings = buildSettingsList(MOCK_SETTING_KEYS, MOCK_DESCRIPTIONS);
+    const fuse = new Fuse(settings, {
+        keys: ['key', 'description'],
+        threshold: 0.4,
+    });
+    const result1 = filterSettingsByQuery(settings, '', fuse, 2);
+    t.is(result1.length, 2);
+    const result2 = filterSettingsByQuery(settings, '', fuse, 4);
+    t.is(result2.length, 4);
+    const result3 = filterSettingsByQuery(settings, '', fuse, 100);
+    t.true(result3.length <= settings.length);
+});
+test('filterSettingsByQuery - case insensitive search', t => {
+    const settings = buildSettingsList(MOCK_SETTING_KEYS, MOCK_DESCRIPTIONS);
+    const fuse = new Fuse(settings, {
+        keys: ['key', 'description'],
+        threshold: 0.4,
+    });
+    const lowerCase = filterSettingsByQuery(settings, 'agent', fuse, 10);
+    const upperCase = filterSettingsByQuery(settings, 'AGENT', fuse, 10);
+    const mixedCase = filterSettingsByQuery(settings, 'AgEnT', fuse, 10);
+    t.true(lowerCase.length > 0);
+    t.true(upperCase.length > 0);
+    t.true(mixedCase.length > 0);
+    // Note: Fuzzy search might return slightly different results, but all should find matches
+});
+test('filterSettingsByQuery - handles query with no matches', t => {
+    const settings = buildSettingsList(MOCK_SETTING_KEYS, MOCK_DESCRIPTIONS);
+    const fuse = new Fuse(settings, {
+        keys: ['key', 'description'],
+        threshold: 0.4,
+    });
+    const result = filterSettingsByQuery(settings, 'xyzzzznonexistent', fuse, 10);
+    // Fuzzy search might still return some results due to threshold, but likely empty
+    t.true(Array.isArray(result));
+});
+test('filterSettingsByQuery - trims query before searching', t => {
+    const settings = buildSettingsList(MOCK_SETTING_KEYS, MOCK_DESCRIPTIONS);
+    const fuse = new Fuse(settings, {
+        keys: ['key', 'description'],
+        threshold: 0.4,
+    });
+    const trimmed = filterSettingsByQuery(settings, 'agent', fuse, 10);
+    const withSpaces = filterSettingsByQuery(settings, '  agent  ', fuse, 10);
+    t.true(trimmed.length > 0);
+    t.true(withSpaces.length > 0);
+});
+test('filterSettingsByQuery - handles empty settings array', t => {
+    const fuse = new Fuse([], { keys: ['key', 'description'], threshold: 0.4 });
+    const result = filterSettingsByQuery([], 'agent', fuse, 10);
+    t.is(result.length, 0);
+});
+// clampIndex tests
+test('clampIndex - returns 0 when array is empty', t => {
+    t.is(clampIndex(0, 0), 0);
+    t.is(clampIndex(5, 0), 0);
+    t.is(clampIndex(100, 0), 0);
+});
+test('clampIndex - returns same index when within bounds', t => {
+    const cases = [
+        { index: 0, length: 5, expected: 0 },
+        { index: 2, length: 5, expected: 2 },
+        { index: 4, length: 5, expected: 4 },
+    ];
+    for (const { index, length, expected } of cases) {
+        t.is(clampIndex(index, length), expected, `Index ${index} in length ${length}`);
+    }
+});
+test('clampIndex - clamps to max index when out of bounds', t => {
+    const cases = [
+        { index: 5, length: 5, expected: 4 },
+        { index: 10, length: 5, expected: 4 },
+        { index: 100, length: 3, expected: 2 },
+    ];
+    for (const { index, length, expected } of cases) {
+        t.is(clampIndex(index, length), expected, `Index ${index} clamped in length ${length}`);
+    }
+});
+test('clampIndex - handles length of 1', t => {
+    t.is(clampIndex(0, 1), 0);
+    t.is(clampIndex(1, 1), 0);
+    t.is(clampIndex(10, 1), 0);
+});
+test('clampIndex - handles negative index (Math.min behavior)', t => {
+    // Math.min will return the negative value if it's smaller than arrayLength - 1
+    // This is the actual behavior of the implementation
+    const result = clampIndex(-1, 5);
+    t.is(result, -1, 'Math.min(-1, 4) = -1');
+});
+// Integration tests
+test('Integration - buildSettingsList and filterSettingsByQuery work together', t => {
+    const settings = buildSettingsList(MOCK_SETTING_KEYS, MOCK_DESCRIPTIONS);
+    const fuse = new Fuse(settings, {
+        keys: ['key', 'description'],
+        threshold: 0.4,
+    });
+    // Search for "model" should find agent.model
+    const result = filterSettingsByQuery(settings, 'model', fuse, 10);
+    t.true(result.some(item => item.key === 'agent.model'));
+    t.true(result.some(item => item.description?.includes('model')));
+});
+test('Integration - clampIndex with filtered results', t => {
+    const settings = buildSettingsList(MOCK_SETTING_KEYS, MOCK_DESCRIPTIONS);
+    const fuse = new Fuse(settings, {
+        keys: ['key', 'description'],
+        threshold: 0.4,
+    });
+    // Get filtered results
+    const filtered = filterSettingsByQuery(settings, 'agent', fuse, 3);
+    // Clamp selection index to filtered results
+    t.is(clampIndex(0, filtered.length), 0);
+    t.is(clampIndex(10, filtered.length), filtered.length - 1);
+});
+//# sourceMappingURL=use-settings-completion.test.js.map