@rawwee/interactive-mcp 1.0.0 → 1.2.0

package/README.md

@@ -2,7 +2,7 @@
 
 [![npm version](https://img.shields.io/npm/v/%40rawwee%2Finteractive-mcp)](https://www.npmjs.com/package/@rawwee/interactive-mcp) [![npm downloads](https://img.shields.io/npm/dm/%40rawwee%2Finteractive-mcp)](https://www.npmjs.com/package/@rawwee/interactive-mcp) [![GitHub license](https://img.shields.io/github/license/josippapez/interactive-mcp-server)](https://github.com/josippapez/interactive-mcp-server/blob/main/LICENSE) [![code style: prettier](https://img.shields.io/badge/code_style-prettier-ff69b4.svg?style=flat-square)](https://github.com/prettier/prettier) [![Platforms](https://img.shields.io/badge/Platform-Windows%20%7C%20macOS%20%7C%20Linux-blue)](https://github.com/josippapez/interactive-mcp-server) [![GitHub last commit](https://img.shields.io/github/last-commit/josippapez/interactive-mcp-server)](https://github.com/josippapez/interactive-mcp-server/commits/main)
 
-![Screenshot 2025-05-13 213745](https://github.com/user-attachments/assets/40208534-5910-4eb2-bfbc-58f7d93aec95)
+![Interactive MCP screenshot](docs/image.png)
 
 A MCP Server implemented in Node.js/TypeScript, facilitating interactive communication between LLMs and users. **Note:** This server is designed to run locally alongside the MCP client (e.g., Claude Desktop, VS Code), as it needs direct access to the user's operating system to display notifications and command-line prompts.
 
@@ -18,6 +18,8 @@ This server exposes the following tools via the Model Context Protocol (MCP):
 - `ask_intensive_chat`: Asks a question within an active intensive chat session.
 - `stop_intensive_chat`: Closes an active intensive chat session.
 
+Prompt UIs support markdown-friendly question text (including multiline prompts, fenced code blocks, and diff snippets). When useful, you can also include VS Code-style file links in prompt text (for example, `vscode://file/<absolute-path>:<line>:<column>`).
+
 ## Usage Scenarios
 
 This server is ideal for scenarios where an LLM needs to interact directly with the user on their local machine, such as:
@@ -129,11 +131,10 @@ This section is primarily for developers looking to modify or contribute to the
 bun run start
 ```
 
-### Terminal UI backend status
-
-`interactive-mcp` now uses OpenTUI (`@opentui/core`, `@opentui/react`) for terminal UI rendering.
+### UI backend status
 
-OpenTUI is the terminal UI renderer backend.
+`interactive-mcp` currently runs with the OpenTUI terminal backend (`@opentui/core`, `@opentui/react`).
+The VS Code extension and bridge runtime have been removed from the active feature set for now, and may be reconsidered in a future iteration.
 
 #### Command-Line Options
 
@@ -141,7 +142,7 @@ The `interactive-mcp` server accepts the following command-line options. These s
 
 | Option            | Alias | Description                                                                                                                                                                                           |
 | ----------------- | ----- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `--timeout`       | `-t`  | Sets the default timeout (in seconds) for user input prompts. Defaults to 30 seconds.                                                                                                                 |
+| `--timeout`       | `-t`  | Sets the default timeout (in seconds) for user input prompts.                                                                                                                                         |
 | `--disable-tools` | `-d`  | Disables specific tools or groups (comma-separated list). Prevents the server from advertising or registering them. Options: `request_user_input`, `message_complete_notification`, `intensive_chat`. |
 
 **Example:** Setting multiple options in the client config `args` array:

package/dist/commands/input/ui.js

@@ -108,7 +108,7 @@ async function initialize() {
     }
 }
 const App = ({ options: appOptions, onExit }) => {
-    const { projectName, prompt, timeout, showCountdown, outputFile, heartbeatFile, predefinedOptions, searchRoot, } = appOptions;
+    const { prompt, timeout, showCountdown, outputFile, heartbeatFile, predefinedOptions, searchRoot, } = appOptions;
     const [timeLeft, setTimeLeft] = useState(timeout);
     const [followInput, setFollowInput] = useState(false);
     const hasCompletedRef = useRef(false);
@@ -199,9 +199,7 @@ const App = ({ options: appOptions, onExit }) => {
     const progressValue = timeout > 0 ? (timeLeft / timeout) * 100 : 0;
     return (_jsxs("box", { flexDirection: "column", width: "100%", height: "100%", backgroundColor: "black", paddingLeft: isNarrow ? 0 : 1, paddingRight: isNarrow ? 0 : 1, children: [_jsx("scrollbox", { ref: scrollRef, flexGrow: 1, width: "100%", scrollY: true, stickyScroll: followInput, stickyStart: followInput ? 'bottom' : undefined, viewportCulling: false, scrollbarOptions: {
                     showArrows: false,
-                }, children: _jsxs("box", { flexDirection: "column", width: "100%", paddingBottom: 1, gap: 2, children: [_jsx("box", { width: "100%", paddingLeft: 1, paddingRight: 1, children: _jsxs("box", { flexDirection: "column", width: "100%", gap: 0, children: [projectName && (_jsx("text", { fg: "magenta", children: _jsx("strong", { children: projectName }) })), _jsx("text", { fg: "gray", wrapMode: "word", children: isNarrow
-                                            ? 'Keyboard-first prompt mode'
-                                            : 'Keyboard-first prompt mode • Tab / Shift+Tab switches mode' })] }) }), _jsx("box", { width: "100%", paddingLeft: 1, paddingRight: 1, gap: 1, children: _jsx(InteractiveInput, { question: prompt, questionId: prompt, predefinedOptions: predefinedOptions, searchRoot: searchRoot, onSubmit: handleInputSubmit, onInputActivity: keepInputVisible }) })] }) }), showCountdown && (_jsx("box", { marginTop: 0, paddingLeft: 1, paddingRight: 1, children: _jsx(PromptStatus, { value: progressValue, timeLeftSeconds: timeLeft, critical: timeLeft <= 10 }) }))] }));
+                }, children: _jsx("box", { flexDirection: "column", width: "100%", paddingBottom: 1, gap: 2, children: _jsx("box", { width: "100%", paddingLeft: 1, paddingRight: 1, gap: 1, children: _jsx(InteractiveInput, { question: prompt, questionId: prompt, predefinedOptions: predefinedOptions, searchRoot: searchRoot, onSubmit: handleInputSubmit, onInputActivity: keepInputVisible }) }) }) }), showCountdown && (_jsx("box", { marginTop: 0, paddingLeft: 1, paddingRight: 1, children: _jsx(PromptStatus, { value: progressValue, timeLeftSeconds: timeLeft, critical: timeLeft <= 10 }) }))] }));
 };
 async function startUi() {
     await initialize();

package/dist/components/InteractiveInput.js

@@ -1,9 +1,13 @@
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "@opentui/react/jsx-runtime";
 import * as OpenTuiReact from '@opentui/react';
 import { useCallback, useEffect, useMemo, useRef, useState } from 'react';
+import path from 'node:path';
 import { getAutocompleteTarget, rankFileSuggestions, readRepositoryFiles, } from './interactive-input/autocomplete.js';
-import { isPrintableCharacter, isReverseTabShortcut, isSubmitShortcut, textareaKeyBindings, } from './interactive-input/keyboard.js';
+import { isPrintableCharacter, isCopyShortcut, isReverseTabShortcut, isSubmitShortcut, textareaKeyBindings, } from './interactive-input/keyboard.js';
+import { InputEditor, ModeTabs, OptionList, SuggestionsPanel, } from './interactive-input/sections.js';
+import { getTextareaDimensions } from './interactive-input/textarea-height.js';
 import { MarkdownText } from './MarkdownText.js';
+import { copyTextToClipboard } from '../utils/clipboard.js';
 const { useKeyboard } = OpenTuiReact;
 const { useTerminalDimensions } = OpenTuiReact;
 const repositoryFileCache = new Map();
@@ -18,15 +22,48 @@ export function InteractiveInput({ question, questionId, predefinedOptions = [],
     const [selectedSuggestionIndex, setSelectedSuggestionIndex] = useState(0);
     const [textareaRenderVersion, setTextareaRenderVersion] = useState(0);
     const [focusRequestToken, setFocusRequestToken] = useState(0);
+    const [clipboardStatus, setClipboardStatus] = useState(null);
     const textareaRef = useRef(null);
     const latestInputValueRef = useRef(inputValue);
     const latestCaretPositionRef = useRef(caretPosition);
     const autocompleteTargetRef = useRef(null);
     const { width, height } = useTerminalDimensions();
     const isNarrow = width < 90;
-    const activeAutocompleteTarget = mode === 'input' ? getAutocompleteTarget(inputValue, caretPosition) : null;
+    const hasOptions = predefinedOptions.length > 0;
     const hasSearchRoot = Boolean(searchRoot);
+    const activeAutocompleteTarget = mode === 'input' ? getAutocompleteTarget(inputValue, caretPosition) : null;
+    const { rows: textareaRows, containerHeight: textareaContainerHeight } = useMemo(() => getTextareaDimensions({
+        value: inputValue,
+        width,
+        terminalHeight: height,
+        isNarrow,
+    }), [height, inputValue, isNarrow, width]);
     const textareaBaseKeyBindings = useMemo(() => textareaKeyBindings.filter((binding) => binding.action !== 'submit'), []);
+    const hasActiveSearchSuggestions = mode === 'input' &&
+        activeAutocompleteTarget !== null &&
+        fileSuggestions.length > 0;
+    const textareaBindings = useMemo(() => {
+        if (!hasActiveSearchSuggestions) {
+            return textareaBaseKeyBindings;
+        }
+        return [
+            ...textareaBaseKeyBindings,
+            { name: 'enter', action: 'submit' },
+            { name: 'return', action: 'submit' },
+        ];
+    }, [hasActiveSearchSuggestions, textareaBaseKeyBindings]);
+    const selectedSuggestion = fileSuggestions[selectedSuggestionIndex];
+    const selectedSuggestionVscodeLink = useMemo(() => {
+        if (!searchRoot || !selectedSuggestion) {
+            return null;
+        }
+        const absolutePath = path.resolve(searchRoot, selectedSuggestion);
+        const normalizedPath = absolutePath.split(path.sep).join('/');
+        const vscodePath = normalizedPath.startsWith('/')
+            ? normalizedPath
+            : `/${normalizedPath}`;
+        return `vscode://file${encodeURI(vscodePath)}`;
+    }, [searchRoot, selectedSuggestion]);
     const safeReadTextarea = useCallback(() => {
         const textarea = textareaRef.current;
         if (!textarea) {
@@ -80,6 +117,17 @@ export function InteractiveInput({ question, questionId, predefinedOptions = [],
     useEffect(() => {
         latestCaretPositionRef.current = caretPosition;
     }, [caretPosition]);
+    useEffect(() => {
+        if (!clipboardStatus) {
+            return;
+        }
+        const clearStatusTimeout = setTimeout(() => {
+            setClipboardStatus(null);
+        }, 2000);
+        return () => {
+            clearTimeout(clearStatusTimeout);
+        };
+    }, [clipboardStatus]);
     useEffect(() => {
         let active = true;
         const repositoryRoot = searchRoot;
@@ -142,11 +190,11 @@ export function InteractiveInput({ question, questionId, predefinedOptions = [],
         const clampedCaret = Math.max(0, Math.min(latestCaretPositionRef.current, nextValue.length));
         const didWrite = safeWriteTextarea(nextValue, clampedCaret);
         if (!didWrite) {
-            setTextareaRenderVersion((prev) => prev + 1);
+            setTextareaRenderVersion((previous) => previous + 1);
             return;
         }
         if (!focusTextarea()) {
-            setTextareaRenderVersion((prev) => prev + 1);
+            setTextareaRenderVersion((previous) => previous + 1);
         }
     }, [
         focusRequestToken,
@@ -174,9 +222,9 @@ export function InteractiveInput({ question, questionId, predefinedOptions = [],
         }
         const nextSuggestions = rankFileSuggestions(repositoryFiles, target.query);
         setFileSuggestions(nextSuggestions);
-        setSelectedSuggestionIndex((prev) => nextSuggestions.length === 0
+        setSelectedSuggestionIndex((previous) => nextSuggestions.length === 0
             ? 0
-            : Math.min(prev, nextSuggestions.length - 1));
+            : Math.min(previous, nextSuggestions.length - 1));
     }, [caretPosition, inputValue, mode, repositoryFiles]);
     const syncInputStateFromTextarea = useCallback(() => {
         const textareaState = safeReadTextarea();
@@ -212,9 +260,9 @@ export function InteractiveInput({ question, questionId, predefinedOptions = [],
     const requestInputFocus = useCallback((forceRemount = false) => {
         setMode('input');
         if (forceRemount) {
-            setTextareaRenderVersion((prev) => prev + 1);
+            setTextareaRenderVersion((previous) => previous + 1);
         }
-        setFocusRequestToken((prev) => prev + 1);
+        setFocusRequestToken((previous) => previous + 1);
         onInputActivity?.();
     }, [onInputActivity]);
     const recoverInputFocusFromClick = useCallback(() => {
@@ -227,6 +275,32 @@ export function InteractiveInput({ question, questionId, predefinedOptions = [],
         setMode('option');
         onInputActivity?.();
     }, [onInputActivity, predefinedOptions.length]);
+    const copyInputToClipboard = useCallback(() => {
+        if (mode !== 'input') {
+            return;
+        }
+        const textarea = textareaRef.current;
+        const selectedText = typeof textarea?.hasSelection === 'function' &&
+            textarea.hasSelection() &&
+            typeof textarea.getSelectedText === 'function'
+            ? textarea.getSelectedText()
+            : '';
+        const fallbackText = textarea?.plainText ?? inputValue;
+        const textToCopy = selectedText.length > 0 ? selectedText : fallbackText;
+        if (textToCopy.length === 0) {
+            setClipboardStatus('Nothing to copy');
+            return;
+        }
+        void copyTextToClipboard(textToCopy)
+            .then(() => {
+            setClipboardStatus('Copied input to clipboard');
+        })
+            .catch((error) => {
+            const errorMessage = error instanceof Error ? error.message : 'unknown error';
+            setClipboardStatus(`Copy failed: ${errorMessage}`);
+        });
+        onInputActivity?.();
+    }, [inputValue, mode, onInputActivity]);
     const submitCurrentSelection = useCallback(() => {
         if (mode === 'option' && predefinedOptions.length > 0) {
             onSubmit(questionId, predefinedOptions[selectedIndex]);
@@ -250,12 +324,12 @@ export function InteractiveInput({ question, questionId, predefinedOptions = [],
             return;
         }
         const index = selectedIndexOverride ?? selectedSuggestionIndex;
-        const selectedSuggestion = availableSuggestions[index] ?? availableSuggestions[0];
+        const suggestion = availableSuggestions[index] ?? availableSuggestions[0];
         const currentValue = safeReadTextarea()?.value ?? inputValue;
         const nextValue = currentValue.slice(0, target.start) +
-            selectedSuggestion +
+            suggestion +
             currentValue.slice(target.end);
-        const nextCaret = target.start + selectedSuggestion.length;
+        const nextCaret = target.start + suggestion.length;
         setTextareaValue(nextValue, nextCaret);
     }, [
         fileSuggestions,
@@ -264,19 +338,6 @@ export function InteractiveInput({ question, questionId, predefinedOptions = [],
         selectedSuggestionIndex,
         setTextareaValue,
     ]);
-    const hasActiveSearchSuggestions = mode === 'input' &&
-        activeAutocompleteTarget !== null &&
-        fileSuggestions.length > 0;
-    const textareaBindings = useMemo(() => {
-        if (!hasActiveSearchSuggestions) {
-            return textareaBaseKeyBindings;
-        }
-        return [
-            ...textareaBaseKeyBindings,
-            { name: 'enter', action: 'submit' },
-            { name: 'return', action: 'submit' },
-        ];
-    }, [hasActiveSearchSuggestions, textareaBaseKeyBindings]);
     const insertCharacterInTextarea = useCallback((character) => {
         if (!character) {
             return;
@@ -322,8 +383,11 @@ export function InteractiveInput({ question, questionId, predefinedOptions = [],
             submitCurrentSelection();
             return;
         }
-        if (predefinedOptions.length > 0 &&
-            (isReverseTabShortcut(key) || key.name === 'tab')) {
+        if (isCopyShortcut(key)) {
+            copyInputToClipboard();
+            return;
+        }
+        if (hasOptions && (isReverseTabShortcut(key) || key.name === 'tab')) {
             if (mode === 'option') {
                 setModeToInput();
             }
@@ -332,7 +396,7 @@ export function InteractiveInput({ question, questionId, predefinedOptions = [],
             }
             return;
         }
-        if (mode === 'option' && predefinedOptions.length > 0) {
+        if (mode === 'option' && hasOptions) {
             const isOptionSubmitKey = key.name === 'enter' ||
                 key.name === 'return' ||
                 key.sequence === '\r' ||
@@ -349,23 +413,14 @@ export function InteractiveInput({ question, questionId, predefinedOptions = [],
                 setModeToOption();
                 return;
             }
-            if (key.name === 'up') {
-                setSelectedIndex((prev) => (prev - 1 + predefinedOptions.length) % predefinedOptions.length);
-                onInputActivity?.();
-                return;
-            }
-            if (key.name.toLowerCase() === 'k') {
-                setSelectedIndex((prev) => (prev - 1 + predefinedOptions.length) % predefinedOptions.length);
-                onInputActivity?.();
-                return;
-            }
-            if (key.name === 'down') {
-                setSelectedIndex((prev) => (prev + 1) % predefinedOptions.length);
+            if (key.name === 'up' || key.name.toLowerCase() === 'k') {
+                setSelectedIndex((previous) => (previous - 1 + predefinedOptions.length) %
+                    predefinedOptions.length);
                 onInputActivity?.();
                 return;
             }
-            if (key.name.toLowerCase() === 'j') {
-                setSelectedIndex((prev) => (prev + 1) % predefinedOptions.length);
+            if (key.name === 'down' || key.name.toLowerCase() === 'j') {
+                setSelectedIndex((previous) => (previous + 1) % predefinedOptions.length);
                 onInputActivity?.();
                 return;
             }
@@ -384,37 +439,30 @@ export function InteractiveInput({ question, questionId, predefinedOptions = [],
             return;
         }
         if ((key.ctrl || key.meta) && key.name.toLowerCase() === 'n') {
-            setSelectedSuggestionIndex((prev) => (prev + 1) % fileSuggestions.length);
+            setSelectedSuggestionIndex((previous) => (previous + 1) % fileSuggestions.length);
             onInputActivity?.();
             return;
         }
         if ((key.ctrl || key.meta) && key.name.toLowerCase() === 'p') {
-            setSelectedSuggestionIndex((prev) => prev <= 0 ? fileSuggestions.length - 1 : prev - 1);
+            setSelectedSuggestionIndex((previous) => previous <= 0 ? fileSuggestions.length - 1 : previous - 1);
             onInputActivity?.();
             return;
         }
         if (key.name === 'down') {
-            setSelectedSuggestionIndex((prev) => (prev + 1) % fileSuggestions.length);
+            setSelectedSuggestionIndex((previous) => (previous + 1) % fileSuggestions.length);
             onInputActivity?.();
             return;
         }
         if (key.name === 'up') {
-            setSelectedSuggestionIndex((prev) => prev <= 0 ? fileSuggestions.length - 1 : prev - 1);
+            setSelectedSuggestionIndex((previous) => previous <= 0 ? fileSuggestions.length - 1 : previous - 1);
             onInputActivity?.();
         }
     });
-    return (_jsxs(_Fragment, { children: [_jsxs("box", { flexDirection: "column", marginBottom: 0, width: "100%", gap: 0, border: true, borderStyle: "single", borderColor: "cyan", backgroundColor: "#121212", paddingLeft: 1, paddingRight: 1, children: [_jsx("text", { fg: "cyan", children: _jsx("strong", { children: "PROMPT" }) }), _jsx(MarkdownText, { content: question, showCodeCopyControls: true })] }), _jsxs("box", { flexDirection: "column", marginBottom: 0, width: "100%", gap: 0, children: [_jsx("text", { fg: "gray", children: "Mode" }), _jsxs("box", { flexDirection: "row", alignSelf: "flex-start", border: true, borderStyle: "single", borderColor: "orange", backgroundColor: "#151515", paddingLeft: 0, paddingRight: 0, children: [predefinedOptions.length > 0 && (_jsx("box", { justifyContent: "center", paddingLeft: 0, paddingRight: 0, onClick: setModeToOption, backgroundColor: mode === 'option' ? 'orange' : '#151515', children: _jsx("text", { fg: mode === 'option' ? 'black' : 'gray', children: mode === 'option' ? 'Option' : 'option' }) })), predefinedOptions.length > 0 && _jsx("text", { fg: "#3a3a3a", children: "\u2502" }), _jsx("box", { justifyContent: "center", paddingLeft: 0, paddingRight: 0, onClick: recoverInputFocusFromClick, backgroundColor: mode === 'input' ? 'orange' : '#151515', children: _jsx("text", { fg: mode === 'input' ? 'black' : 'gray', children: mode === 'input' ? 'Input' : 'input' }) })] })] }), predefinedOptions.length > 0 && (_jsxs("box", { flexDirection: "column", marginBottom: 1, width: "100%", gap: 1, children: [_jsx("text", { fg: "gray", wrapMode: "word", children: "Option mode: \u2191/\u2193 or j/k choose \u2022 Enter select \u2022 Tab switch mode" }), _jsx("box", { flexDirection: "column", width: "100%", gap: 1, children: predefinedOptions.map((opt, i) => (_jsx("box", { width: "100%", paddingLeft: 0, paddingRight: 1, onClick: () => {
-                                setSelectedIndex(i);
-                                setModeToOption();
-                            }, children: _jsxs("text", { wrapMode: "char", fg: i === selectedIndex && mode === 'option' ? 'cyan' : 'gray', children: [i === selectedIndex && mode === 'option' ? '› ' : '  ', opt] }) }, `${opt}-${i}`))) })] })), mode === 'input' && (_jsxs("box", { flexDirection: "column", marginBottom: 0, width: "100%", children: [_jsx("text", { fg: "gray", children: "Input" }), _jsx("box", { border: true, borderStyle: "single", borderColor: fileSuggestions.length > 0 ? 'cyan' : 'gray', backgroundColor: "#1f1f1f", width: "100%", height: isNarrow ? 4 : 6, paddingLeft: 0, paddingRight: 0, onClick: recoverInputFocusFromClick, children: _jsx("textarea", { ref: textareaRef, focused: true, wrapMode: "word", backgroundColor: "#1f1f1f", focusedBackgroundColor: "#1f1f1f", textColor: "white", focusedTextColor: "white", placeholderColor: "gray", placeholder: "Type your answer...", keyBindings: textareaBindings, onContentChange: syncInputStateFromTextarea, onCursorChange: syncInputStateFromTextarea, onSubmit: handleTextareaSubmit }, `textarea-${questionId}-${textareaRenderVersion}`) })] })), mode === 'input' && activeAutocompleteTarget !== null && (_jsxs("box", { flexDirection: "column", marginBottom: 1, width: "100%", gap: 0, children: [_jsx("text", { fg: "gray", children: predefinedOptions.length > 0
-                            ? 'File suggestions • ↑/↓ or Ctrl+N/P navigate • Enter apply'
-                            : 'File suggestions • ↑/↓ or Ctrl+N/P navigate • Enter/Tab apply' }), isIndexingFiles ? (_jsx("text", { fg: "gray", children: "Indexing files..." })) : fileSuggestions.length > 0 ? (_jsx("box", { flexDirection: "column", width: "100%", children: fileSuggestions.map((suggestion, index) => (_jsx("box", { paddingLeft: 0, paddingRight: 1, children: _jsxs("text", { fg: index === selectedSuggestionIndex ? 'cyan' : 'gray', wrapMode: "char", children: [index === selectedSuggestionIndex ? '› ' : '  ', suggestion] }) }, suggestion))) })) : (_jsx("text", { fg: "gray", children: hasSearchRoot
-                            ? '#search: no matches'
-                            : '#search: no search root configured' }))] })), mode === 'input' && (_jsxs("box", { flexDirection: "column", marginBottom: 1, width: "100%", children: [_jsx("text", { fg: "gray", wrapMode: "char", children: hasSearchRoot
+    return (_jsxs(_Fragment, { children: [_jsxs("box", { flexDirection: "column", marginBottom: 0, width: "100%", gap: 0, border: true, borderStyle: "single", borderColor: "cyan", backgroundColor: "#121212", paddingLeft: 1, paddingRight: 1, paddingTop: 1, paddingBottom: 1, children: [_jsx("text", { fg: "cyan", children: _jsx("strong", { children: "PROMPT" }) }), _jsx(MarkdownText, { content: question, showCodeCopyControls: true })] }), _jsx(ModeTabs, { mode: mode, hasOptions: hasOptions, onSelectOptionMode: setModeToOption, onSelectInputMode: recoverInputFocusFromClick }), _jsx(OptionList, { mode: mode, options: predefinedOptions, selectedIndex: selectedIndex, onSelectOption: setSelectedIndex, onActivateOptionMode: setModeToOption }), mode === 'input' && (_jsx(InputEditor, { questionId: questionId, textareaRenderVersion: textareaRenderVersion, textareaRef: textareaRef, textareaContainerHeight: textareaContainerHeight, textareaRows: textareaRows, hasSuggestions: fileSuggestions.length > 0, keyBindings: textareaBindings, onFocusRequest: recoverInputFocusFromClick, onContentSync: syncInputStateFromTextarea, onSubmitFromTextarea: handleTextareaSubmit })), mode === 'input' && activeAutocompleteTarget !== null && (_jsx(SuggestionsPanel, { hasOptions: hasOptions, isIndexingFiles: isIndexingFiles, fileSuggestions: fileSuggestions, selectedSuggestionIndex: selectedSuggestionIndex, selectedSuggestionVscodeLink: selectedSuggestionVscodeLink, hasSearchRoot: hasSearchRoot })), mode === 'input' && (_jsxs("box", { flexDirection: "column", marginBottom: 0, width: "100%", children: [_jsx("text", { fg: "gray", wrapMode: "char", children: hasSearchRoot
                             ? `#search root: ${searchRoot}`
                             : '#search root: no search root' }), _jsx("text", { fg: "gray", children: isIndexingFiles
                             ? '#search index: indexing...'
-                            : `#search index: ${repositoryFiles.length} files indexed` })] })), _jsxs("box", { flexDirection: isNarrow ? 'column' : 'row', justifyContent: "space-between", marginBottom: 1, gap: isNarrow ? 0 : undefined, children: [_jsx("text", { fg: "gray", children: mode === 'input' ? 'Custom input' : 'Option selection' }), _jsxs("text", { fg: "gray", children: [inputValue.length, " chars"] })] }), mode === 'input' && (_jsx("box", { backgroundColor: "cyan", paddingLeft: 1, paddingRight: 1, alignSelf: "flex-start", marginBottom: 1, onClick: submitCurrentSelection, children: _jsxs("text", { fg: "black", children: [_jsx("strong", { children: "Send" }), " \u2303S"] }) })), mode === 'input' && (_jsx("text", { fg: "gray", wrapMode: "word", children: predefinedOptions.length > 0
-                    ? 'Enter/Ctrl+J newline (or #search apply) • #search nav: ↑/↓ or Ctrl+N/P • Tab mode switch • #path for repo file autocomplete'
-                    : 'Enter/Ctrl+J newline • #search nav: ↑/↓ or Ctrl+N/P • Enter/Tab #search apply • #path for repo file autocomplete' }))] }));
+                            : `#search index: ${repositoryFiles.length} files indexed` })] })), _jsxs("box", { flexDirection: isNarrow ? 'column' : 'row', justifyContent: "space-between", marginBottom: 0, gap: isNarrow ? 0 : undefined, children: [_jsx("text", { fg: "gray", children: mode === 'input' ? 'Custom input' : 'Option selection' }), _jsxs("text", { fg: "gray", children: [inputValue.length, " chars"] })] }), mode === 'input' && clipboardStatus && (_jsx("text", { fg: clipboardStatus.startsWith('Copy failed:') ? 'red' : 'green', children: clipboardStatus })), mode === 'input' && (_jsx("box", { backgroundColor: "cyan", paddingLeft: 1, paddingRight: 1, alignSelf: "flex-start", marginBottom: 0, onClick: submitCurrentSelection, children: _jsxs("text", { fg: "black", children: [_jsx("strong", { children: "Send" }), " \u2303S"] }) })), mode === 'input' && (_jsx("text", { fg: "gray", wrapMode: "word", children: hasOptions
+                    ? 'Enter/Ctrl+J newline (or #search apply) • #search nav: ↑/↓ or Ctrl+N/P • Tab mode switch • #path for repo file autocomplete • Cmd/Ctrl+C copy'
+                    : 'Enter/Ctrl+J newline • #search nav: ↑/↓ or Ctrl+N/P • Enter/Tab #search apply • #path for repo file autocomplete • Cmd/Ctrl+C copy' }))] }));
 }

package/dist/components/MarkdownText.js

@@ -1,10 +1,13 @@
 import { jsxs as _jsxs, jsx as _jsx } from "@opentui/react/jsx-runtime";
 import * as OpenTuiCore from '@opentui/core';
-import { createElement, useEffect, useMemo, useRef, useState } from 'react';
+import { createElement, useCallback, useEffect, useMemo, useRef, useState, } from 'react';
 import { copyTextToClipboard } from '../utils/clipboard.js';
+import { openExternalLink } from '../utils/open-external-link.js';
 const { SyntaxStyle, RGBA } = OpenTuiCore;
 const CODE_BLOCK_REGEX = /```([^\n`]*)\n?([\s\S]*?)```/g;
+const INLINE_LINK_REGEX = /\[([^\]\n]+)\]\(([^)\s]+)\)|(https?:\/\/[^\s<>()]+[^\s<>().,!?;:])/g;
 const DIFF_LANGUAGES = new Set(['diff', 'patch']);
+const VSCODE_FILE_LINK_REGEX = /^vscode(-insiders)?:\/\/file\//;
 const LANGUAGE_TO_FILETYPE = {
     js: 'javascript',
     jsx: 'javascript',
@@ -160,6 +163,52 @@ function splitMarkdownSegments(content) {
     }
     return segments;
 }
+function parseMarkdownInlineLinks(content) {
+    const segments = [];
+    let lastIndex = 0;
+    INLINE_LINK_REGEX.lastIndex = 0;
+    for (const match of content.matchAll(INLINE_LINK_REGEX)) {
+        const fullMatch = match[0];
+        if (typeof fullMatch !== 'string' || typeof match.index !== 'number') {
+            continue;
+        }
+        if (match.index > lastIndex) {
+            segments.push({
+                type: 'text',
+                value: content.slice(lastIndex, match.index),
+            });
+        }
+        const markdownLabel = match[1];
+        const markdownHref = match[2];
+        const rawHref = match[3];
+        const href = markdownHref ?? rawHref;
+        const label = markdownLabel ?? rawHref;
+        if (href && label) {
+            segments.push({
+                type: 'link',
+                value: label,
+                href,
+            });
+        }
+        else {
+            segments.push({
+                type: 'text',
+                value: fullMatch,
+            });
+        }
+        lastIndex = match.index + fullMatch.length;
+    }
+    if (lastIndex < content.length) {
+        segments.push({
+            type: 'text',
+            value: content.slice(lastIndex),
+        });
+    }
+    return segments.length > 0 ? segments : [{ type: 'text', value: content }];
+}
+function isVscodeFileLink(href) {
+    return VSCODE_FILE_LINK_REGEX.test(href);
+}
 export function MarkdownText({ content, streaming = false, showContentCopyControl = false, contentCopyLabel = 'Copy text', showCodeCopyControls = false, codeBlockMaxVisibleLines, }) {
     const syntaxStyle = useMemo(() => {
         const toColor = (hex) => typeof RGBA?.fromHex === 'function' ? RGBA.fromHex(hex) : hex;
@@ -208,12 +257,57 @@ export function MarkdownText({ content, streaming = false, showContentCopyContro
             setClipboardHint(`Copy failed: ${error instanceof Error ? error.message : String(error)}`);
         }
     };
+    const openLinkWithHint = useCallback(async (href, target) => {
+        try {
+            await openExternalLink(href, target);
+            setClipboardHint('Opening link…');
+        }
+        catch (error) {
+            setClipboardHint(`Open link failed: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }, []);
     return (_jsxs("box", { flexDirection: "column", width: "100%", gap: 1, children: [showContentCopyControl && (_jsx("box", { width: "100%", justifyContent: "flex-end", children: _jsxs("text", { fg: "cyan", onMouseUp: () => {
                         void copyWithHint(content, 'Prompt copied to clipboard.');
                     }, children: ["[", contentCopyLabel, "]"] }) })), segments.map((segment, index) => {
                 if (segment.type === 'markdown') {
                     if (!segment.value.trim()) {
-                        return _jsx("box", {}, `segment-${index}`);
+                        const spacerHeight = Math.max(1, segment.value.split('\n').length - 1);
+                        return _jsx("box", { height: spacerHeight }, `segment-${index}`);
+                    }
+                    INLINE_LINK_REGEX.lastIndex = 0;
+                    if (INLINE_LINK_REGEX.test(segment.value)) {
+                        INLINE_LINK_REGEX.lastIndex = 0;
+                        const lines = segment.value.split('\n');
+                        return (_jsx("box", { flexDirection: "column", width: "100%", children: lines.map((line, lineIndex) => {
+                                if (!line) {
+                                    return (_jsx("box", { height: 1 }, `segment-${index}-line-${lineIndex}`));
+                                }
+                                const inlineSegments = parseMarkdownInlineLinks(line);
+                                return (_jsx("box", { flexDirection: "row", width: "100%", children: inlineSegments.flatMap((inlineSegment, inlineSegmentIndex) => {
+                                        const baseKey = `segment-${index}-line-${lineIndex}-part-${inlineSegmentIndex}`;
+                                        if (inlineSegment.type !== 'link' ||
+                                            !inlineSegment.href) {
+                                            return (_jsx("text", { wrapMode: "word", children: inlineSegment.value }, baseKey));
+                                        }
+                                        if (!isVscodeFileLink(inlineSegment.href)) {
+                                            return (_jsx("text", { fg: "cyan", wrapMode: "word", onMouseUp: () => {
+                                                    void openLinkWithHint(inlineSegment.href ?? '', 'default');
+                                                }, children: inlineSegment.value }, baseKey));
+                                        }
+                                        return [
+                                            _jsx("text", { wrapMode: "word", children: inlineSegment.value }, `${baseKey}-label`),
+                                            _jsx("text", { fg: "gray", wrapMode: "word", children: ' (' }, `${baseKey}-open-paren`),
+                                            _jsx("text", { fg: "cyan", wrapMode: "word", onMouseUp: () => {
+                                                    void openLinkWithHint(inlineSegment.href ?? '', 'vscode');
+                                                }, children: "VS Code" }, `${baseKey}-vscode`),
+                                            _jsx("text", { fg: "gray", wrapMode: "word", children: ' | ' }, `${baseKey}-separator`),
+                                            _jsx("text", { fg: "cyan", wrapMode: "word", onMouseUp: () => {
+                                                    void openLinkWithHint(inlineSegment.href ?? '', 'vscode-insiders');
+                                                }, children: "VS Code Insiders" }, `${baseKey}-insiders`),
+                                            _jsx("text", { fg: "gray", wrapMode: "word", children: ')' }, `${baseKey}-close-paren`),
+                                        ];
+                                    }) }, `segment-${index}-line-${lineIndex}`));
+                            }) }, `segment-${index}`));
                     }
                     return (_jsx("markdown", { content: segment.value, syntaxStyle: syntaxStyle, conceal: true, streaming: streaming }, `segment-${index}`));
                 }

package/dist/components/interactive-input/keyboard.js

@@ -22,6 +22,8 @@ export const isControlKeyShortcut = (key, letter) => {
         hasCtrlOrMetaModifier(modifierCode));
 };
 export const isSubmitShortcut = (key) => isControlKeyShortcut(key, 's');
+export const isCopyShortcut = (key) => isControlKeyShortcut(key, 'c') ||
+    (key.ctrl && key.shift && key.name.toLowerCase() === 'c');
 export const isReverseTabShortcut = (key) => key.name === 'backtab' ||
     (key.name === 'tab' && key.shift) ||
     key.sequence === '\u001b[Z';

package/dist/components/interactive-input/sections.js

@@ -0,0 +1,22 @@
+import { jsx as _jsx, jsxs as _jsxs } from "@opentui/react/jsx-runtime";
+import { openExternalLink } from '../../utils/open-external-link.js';
+export const ModeTabs = ({ mode, hasOptions, onSelectOptionMode, onSelectInputMode, }) => (_jsxs("box", { flexDirection: "column", marginBottom: 0, width: "100%", gap: 0, children: [_jsx("text", { fg: "gray", children: "Mode" }), _jsxs("box", { flexDirection: "row", alignSelf: "flex-start", border: true, borderStyle: "single", borderColor: "orange", backgroundColor: "#151515", paddingLeft: 0, paddingRight: 0, children: [hasOptions && (_jsx("box", { justifyContent: "center", paddingLeft: 0, paddingRight: 0, onClick: onSelectOptionMode, backgroundColor: mode === 'option' ? 'orange' : '#151515', children: _jsx("text", { fg: mode === 'option' ? 'black' : 'gray', children: mode === 'option' ? 'Option' : 'option' }) })), hasOptions && _jsx("text", { fg: "#3a3a3a", children: "\u2502" }), _jsx("box", { justifyContent: "center", paddingLeft: 0, paddingRight: 0, onClick: onSelectInputMode, backgroundColor: mode === 'input' ? 'orange' : '#151515', children: _jsx("text", { fg: mode === 'input' ? 'black' : 'gray', children: mode === 'input' ? 'Input' : 'input' }) })] })] }));
+export const OptionList = ({ mode, options, selectedIndex, onSelectOption, onActivateOptionMode, }) => {
+    if (options.length === 0) {
+        return null;
+    }
+    return (_jsxs("box", { flexDirection: "column", marginBottom: 0, width: "100%", gap: 0, children: [_jsx("text", { fg: "gray", wrapMode: "word", children: "Option mode: \u2191/\u2193 or j/k choose \u2022 Enter select \u2022 Tab switch mode" }), _jsx("box", { flexDirection: "column", width: "100%", gap: 0, children: options.map((opt, index) => (_jsx("box", { width: "100%", paddingLeft: 0, paddingRight: 1, onClick: () => {
+                        onSelectOption(index);
+                        onActivateOptionMode();
+                    }, children: _jsxs("text", { wrapMode: "char", fg: index === selectedIndex && mode === 'option' ? 'cyan' : 'gray', children: [index === selectedIndex && mode === 'option' ? '› ' : '  ', opt] }) }, `${opt}-${index}`))) })] }));
+};
+export const InputEditor = ({ questionId, textareaRenderVersion, textareaRef, textareaContainerHeight, textareaRows, hasSuggestions, keyBindings, onFocusRequest, onContentSync, onSubmitFromTextarea, }) => (_jsxs("box", { flexDirection: "column", marginBottom: 0, width: "100%", children: [_jsx("text", { fg: "gray", children: "Input" }), _jsx("box", { border: true, borderStyle: "single", borderColor: hasSuggestions ? 'cyan' : 'gray', backgroundColor: "#1f1f1f", width: "100%", height: textareaContainerHeight, paddingLeft: 0, paddingRight: 0, onClick: onFocusRequest, children: _jsx("textarea", { ref: textareaRef, focused: true, height: textareaRows, wrapMode: "word", backgroundColor: "#1f1f1f", focusedBackgroundColor: "#1f1f1f", textColor: "white", focusedTextColor: "white", placeholderColor: "gray", placeholder: "Type your answer...", keyBindings: keyBindings, onContentChange: onContentSync, onCursorChange: onContentSync, onSubmit: onSubmitFromTextarea }, `textarea-${questionId}-${textareaRenderVersion}`) })] }));
+export const SuggestionsPanel = ({ hasOptions, isIndexingFiles, fileSuggestions, selectedSuggestionIndex, selectedSuggestionVscodeLink, hasSearchRoot, }) => (_jsxs("box", { flexDirection: "column", marginBottom: 0, width: "100%", gap: 0, children: [_jsx("text", { fg: "gray", children: hasOptions
+                ? 'File suggestions • ↑/↓ or Ctrl+N/P navigate • Enter apply'
+                : 'File suggestions • ↑/↓ or Ctrl+N/P navigate • Enter/Tab apply' }), isIndexingFiles ? (_jsx("text", { fg: "gray", children: "Indexing files..." })) : fileSuggestions.length > 0 ? (_jsxs("box", { flexDirection: "column", width: "100%", children: [fileSuggestions.map((suggestion, index) => (_jsx("box", { paddingLeft: 0, paddingRight: 1, gap: 0, children: _jsxs("text", { fg: index === selectedSuggestionIndex ? 'cyan' : 'gray', wrapMode: "char", children: [index === selectedSuggestionIndex ? '› ' : '  ', suggestion] }) }, suggestion))), selectedSuggestionVscodeLink && (_jsxs("box", { flexDirection: "column", width: "100%", children: [_jsx("text", { fg: "gray", wrapMode: "word", children: "open file with:" }), _jsx("text", { fg: "cyan", wrapMode: "word", onMouseUp: () => {
+                                void openExternalLink(selectedSuggestionVscodeLink, 'vscode');
+                            }, children: "\u2022 VS Code" }), _jsx("text", { fg: "cyan", wrapMode: "word", onMouseUp: () => {
+                                void openExternalLink(selectedSuggestionVscodeLink, 'vscode-insiders');
+                            }, children: "\u2022 VS Code Insiders" })] }))] })) : (_jsx("text", { fg: "gray", children: hasSearchRoot
+                ? '#search: no matches'
+                : '#search: no search root configured' }))] }));

package/dist/components/interactive-input/textarea-height.js

@@ -0,0 +1,35 @@
+const NARROW_TERMINAL_MIN_ROWS = 4;
+const WIDE_TERMINAL_MIN_ROWS = 5;
+const NARROW_TERMINAL_MAX_ROWS = 8;
+const WIDE_TERMINAL_MAX_ROWS = 12;
+const clamp = (value, min, max) => Math.max(min, Math.min(max, value));
+const countVisualColumns = (line) => {
+    if (line.length === 0) {
+        return 0;
+    }
+    return line.replace(/\t/g, '    ').length;
+};
+const estimateWrappedRows = (value, availableColumns) => {
+    const normalizedValue = value.replace(/\r\n/g, '\n');
+    const lines = normalizedValue.split('\n');
+    return lines.reduce((totalRows, line) => {
+        const visualColumns = countVisualColumns(line);
+        const lineRows = Math.max(1, Math.ceil(visualColumns / availableColumns));
+        return totalRows + lineRows;
+    }, 0);
+};
+export const getTextareaDimensions = ({ value, width, terminalHeight, isNarrow, }) => {
+    const minRows = isNarrow ? NARROW_TERMINAL_MIN_ROWS : WIDE_TERMINAL_MIN_ROWS;
+    const maxRows = isNarrow ? NARROW_TERMINAL_MAX_ROWS : WIDE_TERMINAL_MAX_ROWS;
+    const reservedChromeRows = isNarrow ? 24 : 20;
+    const maxContainerHeight = Math.max(6, terminalHeight - reservedChromeRows);
+    const terminalSafeMaxRows = Math.max(minRows, Math.min(maxRows, maxContainerHeight - 2));
+    const estimatedPadding = isNarrow ? 14 : 18;
+    const availableColumns = Math.max(14, width - estimatedPadding);
+    const estimatedRows = estimateWrappedRows(value, availableColumns);
+    const rows = clamp(estimatedRows, minRows, terminalSafeMaxRows);
+    return {
+        rows,
+        containerHeight: rows + 2,
+    };
+};

package/dist/index.js

@@ -4,8 +4,8 @@ import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js'
 import notifier from 'node-notifier';
 import yargs from 'yargs';
 import { hideBin } from 'yargs/helpers';
+import { askQuestionInSession, startIntensiveChatSession, stopIntensiveChatSession, } from './commands/intensive-chat/index.js';
 import { getCmdWindowInput } from './commands/input/index.js';
-import { startIntensiveChatSession, askQuestionInSession, stopIntensiveChatSession, } from './commands/intensive-chat/index.js';
 import { USER_INPUT_TIMEOUT_SECONDS, USER_INPUT_TIMEOUT_SENTINEL, } from './constants.js';
 import logger from './utils/logger.js';
 import { validateRepositoryBaseDirectory } from './utils/base-directory.js';
@@ -95,8 +95,7 @@ if (isToolEnabled('request_user_input')) {
         const { projectName, message, predefinedOptions, baseDirectory } = args;
         try {
             const validatedBaseDirectory = await validateRepositoryBaseDirectory(baseDirectory);
-            const promptMessage = `${projectName}: ${message}`;
-            const answer = await getCmdWindowInput(projectName, promptMessage, globalTimeoutSeconds, true, validatedBaseDirectory, predefinedOptions);
+            const answer = await getCmdWindowInput(projectName, message, globalTimeoutSeconds, true, validatedBaseDirectory, predefinedOptions);
             // Check for the specific timeout indicator
             if (answer === USER_INPUT_TIMEOUT_SENTINEL) {
                 return {
@@ -159,10 +158,11 @@ if (isToolEnabled('start_intensive_chat')) {
         const { sessionTitle, baseDirectory } = args;
         try {
             const validatedBaseDirectory = await validateRepositoryBaseDirectory(baseDirectory);
-            // Start a new intensive chat session, passing global timeout
             const sessionId = await startIntensiveChatSession(sessionTitle, validatedBaseDirectory, globalTimeoutSeconds);
             // Track this session for the client
-            activeChatSessions.set(sessionId, sessionTitle);
+            activeChatSessions.set(sessionId, {
+                title: sessionTitle,
+            });
             return {
                 content: [
                     {
@@ -201,8 +201,8 @@ if (isToolEnabled('ask_intensive_chat')) {
     async (args) => {
         // Use inferred args type
         const { sessionId, question, predefinedOptions, baseDirectory } = args;
-        // Check if session exists
-        if (!activeChatSessions.has(sessionId)) {
+        const activeSession = activeChatSessions.get(sessionId);
+        if (!activeSession) {
             return {
                 content: [
                     { type: 'text', text: 'Error: Invalid or expired session ID.' },
@@ -211,7 +211,6 @@ if (isToolEnabled('ask_intensive_chat')) {
         }
         try {
             const validatedBaseDirectory = await validateRepositoryBaseDirectory(baseDirectory);
-            // Ask the question in the session
             const answer = await askQuestionInSession(sessionId, question, validatedBaseDirectory, predefinedOptions);
             // Check for the specific timeout indicator
             if (answer === USER_INPUT_TIMEOUT_SENTINEL) {
@@ -280,8 +279,8 @@ if (isToolEnabled('stop_intensive_chat')) {
     async (args) => {
         // Use inferred args type
         const { sessionId } = args;
-        // Check if session exists
-        if (!activeChatSessions.has(sessionId)) {
+        const activeSession = activeChatSessions.get(sessionId);
+        if (!activeSession) {
             return {
                 content: [
                     { type: 'text', text: 'Error: Invalid or expired session ID.' },
@@ -289,7 +288,6 @@ if (isToolEnabled('stop_intensive_chat')) {
             };
         }
         try {
-            // Stop the session
             const success = await stopIntensiveChatSession(sessionId);
             // Remove session from map if successful
             if (success) {

package/dist/tool-definitions/intensive-chat.js

@@ -1,7 +1,7 @@
 import { z } from 'zod';
 // === Start Intensive Chat Definition ===
 const startCapability = {
-    description: 'Start a persistent OpenTUI intensive chat session for gathering multiple answers quickly.',
+    description: 'Start a persistent intensive chat session for gathering multiple answers quickly with markdown-friendly prompts.',
     parameters: {
         type: 'object',
         properties: {
@@ -18,17 +18,18 @@ const startCapability = {
     },
 };
 const startDescription = (globalTimeoutSeconds) => `<description>
-Start an intensive chat session (OpenTUI terminal UI) for gathering multiple answers quickly from the user.
+Start an intensive chat session for gathering multiple answers quickly from the user.
 **Highly recommended** for scenarios requiring a sequence of related inputs or confirmations.
 Very useful for gathering multiple answers from the user in a short period of time.
 Especially useful for brainstorming ideas or discussing complex topics with the user.
 </description>
 
 <importantNotes>
-- (!important!) Opens a persistent console window that stays open for multiple questions.
+- (!important!) Opens a persistent interaction session that stays active for multiple questions.
 - (!important!) Returns a session ID that **must** be used for subsequent questions via 'ask_intensive_chat'.
 - (!important!) **Must** be closed with 'stop_intensive_chat' when finished gathering all inputs.
 - (!important!) After starting a session, **immediately** continue asking all necessary questions using 'ask_intensive_chat' within the **same response message**. Do not end the response until the chat is closed with 'stop_intensive_chat'. This creates a seamless conversational flow for the user.
+- (!important!) Continue the prompt loop until the user explicitly says one of: "Stop prompting", "End session", or "Don't ask anymore".
 </importantNotes>
 
 <whenToUseThisTool>
@@ -41,19 +42,22 @@ Especially useful for brainstorming ideas or discussing complex topics with the
 </whenToUseThisTool>
 
 <features>
-- Opens a persistent OpenTUI window for continuous interaction
+- Opens a persistent interactive prompt surface for continuous interaction
 - Renders markdown prompts, including code/diff snippets, for richer question context
+- Preserves markdown links, including VS Code file links (for example: "vscode://file/<abs-path>:<line>:<column>") in prompt content
 - Supports option mode + free-text mode while asking follow-up questions
 - Configurable timeout for each question (set via -t/--timeout, defaults to ${globalTimeoutSeconds} seconds)
 - Returns a session ID for subsequent interactions
 - Keeps full chat history visible to the user
 - Maintains state between questions
+- Backend-agnostic contract: start/ask/stop behavior is consistent across available UI backends
 - Requires baseDirectory and pins autocomplete/search scope to the repository root
 </features>
 
 <bestPractices>
 - Use a descriptive session title related to the task
 - Start with a clear initial question when possible
+- Use markdown for longer/multiline prompts, code fences, and diff context
 - Do not ask the question if you have another tool that can answer the question
   - e.g. when you searching file in the current repository, do not ask the question "Do you want to search for a file in the current repository?"
   - e.g. prefer to use other tools to find the answer (Cursor tools or other MCP Server tools)
@@ -83,7 +87,7 @@ const startToolDefinition = {
 };
 // === Ask Intensive Chat Definition ===
 const askCapability = {
-    description: 'Ask a question in an active OpenTUI intensive chat session.',
+    description: 'Ask a markdown-friendly question in an active intensive chat session.',
     parameters: {
         type: 'object',
         properties: {
@@ -118,6 +122,8 @@ Ask a new question in an active intensive chat session previously started with '
 - (!important!) Supports predefined options for quick selection.
 - (!important!) Returns the user's answer or indicates if they didn't respond.
 - (!important!) **Use this repeatedly within the same response message** after 'start_intensive_chat' until all questions are asked.
+- (!important!) If response is empty or times out for required input, re-prompt and do not proceed with assumptions.
+- (!important!) Keep the loop active until the user explicitly says one of: "Stop prompting", "End session", or "Don't ask anymore".
 </importantNotes>
 
 <whenToUseThisTool>
@@ -129,6 +135,8 @@ Ask a new question in an active intensive chat session previously started with '
 
 <features>
 - Adds a new question to an existing chat session
+- Supports markdown-friendly prompts (including multiline text, code fences, and diff snippets)
+- Preserves markdown links, including VS Code file links (for example: "vscode://file/<abs-path>:<line>:<column>") in question text
 - Supports predefined options for quick selection
 - Returns the user's response
 - Maintains the chat history in the console
@@ -189,9 +197,10 @@ const stopDescription = `<description>
 </description>
 
 <importantNotes>
-- (!important!) Closes the console window for the intensive chat.
+- (!important!) Closes the active intensive chat session.
 - (!important!) Frees up system resources.
 - (!important!) **Should always be called** as the final step when finished with an intensive chat session, typically at the end of the response message where 'start_intensive_chat' was called.
+- (!important!) Only stop the session when the user explicitly wants to end prompting, such as with "Stop prompting", "End session", or "Don't ask anymore".
 </importantNotes>
 
 <whenToUseThisTool>
@@ -203,7 +212,7 @@ const stopDescription = `<description>
 </whenToUseThisTool>
 
 <features>
-- Gracefully closes the console window
+- Gracefully closes the active session in the current backend
 - Cleans up system resources
 - Marks the session as complete
 </features>

package/dist/tool-definitions/request-user-input.js

@@ -1,17 +1,17 @@
 import { z } from 'zod';
 // Define capability conforming to ToolCapabilityInfo
 const capabilityInfo = {
-    description: 'Ask the user a question in an OpenTUI terminal prompt and await their reply.',
+    description: 'Ask the user a question in an interactive prompt surface and await their reply.',
     parameters: {
         type: 'object',
         properties: {
             projectName: {
                 type: 'string',
-                description: 'Identifies the context/project making the request (used in prompt formatting)',
+                description: 'Identifies the context/project making the request (shown in prompt header/title context)',
             },
             message: {
                 type: 'string',
-                description: 'The specific question for the user (appears in the prompt)',
+                description: 'The specific question for the user (prompt body text)',
             },
             predefinedOptions: {
                 type: 'array',
@@ -29,7 +29,7 @@ const capabilityInfo = {
 };
 // Define description conforming to ToolRegistrationDescription
 const registrationDescription = (globalTimeoutSeconds) => `<description>
-Send a question to the user via the OpenTUI terminal prompt. **Crucial for clarifying requirements, confirming plans, or resolving ambiguity.**
+Send a question to the user via an interactive prompt surface. **Crucial for clarifying requirements, confirming plans, or resolving ambiguity.**
 You should call this tool whenever it has **any** uncertainty or needs clarification or confirmation, even for trivial or silly questions.
 Feel free to ask anything! **Proactive questioning is preferred over making assumptions.**
 </description>
@@ -39,9 +39,15 @@ Feel free to ask anything! **Proactive questioning is preferred over making assu
 - (!important!) Continue to generate existing messages after user answers.
 - (!important!) Provide predefined options for quick selection if applicable.
 - (!important!) **Essential for validating assumptions before proceeding with significant actions (e.g., code edits, running commands).**
+- (!important!) **Do not exit the prompt loop** until the user explicitly says one of: "Stop prompting", "End session", or "Don't ask anymore".
+- (!important!) Immediately before final/closing handoff, ask exactly: "Are you satisfied with this result, or would you like any changes?"
+- (!important!) If a required prompt times out or response is empty, re-prompt indefinitely and do not proceed with assumptions.
+- (!important!) If the user skips a requested command/script, ask why it was skipped and whether to continue with alternatives or stop.
 </importantNotes>
 
 <whenToUseThisTool>
+- Before starting any task, even if requirements appear clear
+- After completing any task, to run the mandatory satisfaction check
 - When you need clarification on user requirements or preferences
 - When multiple implementation approaches are possible and user input is needed
 - **Before making potentially impactful changes (code edits, file operations, complex commands)**
@@ -51,22 +57,30 @@ Feel free to ask anything! **Proactive questioning is preferred over making assu
 - When facing ambiguous instructions that require clarification
 - When seeking feedback on generated code or solutions
 - When needing permission to modify critical files or functionality
+- When user instructions are conflicting or unclear
+- When the user asks to be prompted, asks a direct question, or asks a reply question
+- When the user skips a command you requested
+- Immediately before any final/closing handoff
 - **Whenever you feel even slightly unsure about the user's intent or the correct next step.**
 </whenToUseThisTool>
 
 <features>
-- OpenTUI prompt with markdown rendering (including code/diff blocks)
+- Interactive prompt UI with markdown rendering (including code/diff blocks)
+- Preserves markdown links, including VS Code file links (for example: "vscode://file/<abs-path>:<line>:<column>") when provided in the prompt text
 - Supports option mode + free-text input mode when predefinedOptions are provided
 - Returns user response or timeout notification (timeout defaults to ${globalTimeoutSeconds} seconds)
+- Backend-agnostic contract: same request/response behavior regardless of the active UI backend
 - Maintains context across user interactions
 - Handles empty responses gracefully
-- Properly formats prompt with project context
+- Shows project context in the prompt header/title
 - baseDirectory is required, must be the current repository root, and controls file autocomplete/search scope explicitly
 </features>
 
 <bestPractices>
 - Keep questions concise and specific
 - Provide clear options when applicable
+- Use markdown for richer context (multiline structure, code fences, unified diff snippets)
+- When referencing repository files, prefer VS Code-compatible file links in markdown where helpful
 - Do not ask the question if you have another tool that can answer the question
   - e.g. when you searching file in the current repository, do not ask the question "Do you want to search for a file in the current repository?"
   - e.g. prefer to use other tools to find the answer (Cursor tools or other MCP Server tools)
@@ -78,8 +92,8 @@ Feel free to ask anything! **Proactive questioning is preferred over making assu
 </bestPractices>
 
 <parameters>
-- projectName: Identifies the context/project making the request (used in prompt formatting)
-- message: The specific question for the user (appears in the prompt)
+- projectName: Identifies the context/project making the request (shown in prompt header/title context)
+- message: The specific question for the user (prompt body text)
 - predefinedOptions: Predefined options for the user to choose from (optional)
 - baseDirectory: Required absolute path to the current repository root (must be a git repo root)
 </parameters>
@@ -97,10 +111,10 @@ Feel free to ask anything! **Proactive questioning is preferred over making assu
 const rawSchema = {
     projectName: z
         .string()
-        .describe('Identifies the context/project making the request (used in prompt formatting)'),
+        .describe('Identifies the context/project making the request (shown in prompt header/title context)'),
     message: z
         .string()
-        .describe('The specific question for the user (appears in the prompt)'),
+        .describe('The specific question for the user (prompt body text)'),
     predefinedOptions: z
         .array(z.string())
         .optional()

package/dist/utils/open-external-link.js

@@ -0,0 +1,48 @@
+import os from 'node:os';
+import { spawn } from 'node:child_process';
+const normalizeEditorUrl = (url, target) => {
+    if (target === 'default') {
+        return url;
+    }
+    if (!/^vscode(-insiders)?:\/\//.test(url)) {
+        return url;
+    }
+    if (target === 'vscode') {
+        return url.replace(/^vscode-insiders:\/\//, 'vscode://');
+    }
+    return url.replace(/^vscode:\/\//, 'vscode-insiders://');
+};
+const getOpenCommand = (url) => {
+    const platform = os.platform();
+    if (platform === 'darwin') {
+        return { command: 'open', args: [url] };
+    }
+    if (platform === 'linux') {
+        return { command: 'xdg-open', args: [url] };
+    }
+    if (platform === 'win32') {
+        return { command: 'cmd', args: ['/c', 'start', '', url] };
+    }
+    throw new Error(`Opening links is not supported on platform: ${platform}`);
+};
+export async function openExternalLink(url, target = 'default') {
+    const trimmedUrl = url.trim();
+    if (!trimmedUrl) {
+        throw new Error('Cannot open an empty link.');
+    }
+    const targetUrl = normalizeEditorUrl(trimmedUrl, target);
+    const { command, args } = getOpenCommand(targetUrl);
+    await new Promise((resolve, reject) => {
+        const child = spawn(command, args, {
+            stdio: 'ignore',
+            detached: true,
+        });
+        child.once('error', (error) => {
+            reject(error);
+        });
+        child.once('spawn', () => {
+            child.unref();
+            resolve();
+        });
+    });
+}

package/package.json

@@ -1,13 +1,19 @@
 {
   "name": "@rawwee/interactive-mcp",
-  "version": "1.0.0",
+  "version": "1.2.0",
   "main": "dist/index.js",
   "type": "module",
   "bin": {
     "interactive-mcp": "dist/index.js"
   },
   "files": [
-    "dist",
+    "dist/constants.js",
+    "dist/index.js",
+    "dist/commands/input",
+    "dist/commands/intensive-chat",
+    "dist/components",
+    "dist/tool-definitions",
+    "dist/utils",
     "README.md",
     "LICENSE",
     "package.json"