@rawwee/interactive-mcp 1.0.0 → 1.1.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:

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

@@ -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 {

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 OpenTUI intensive chat session for gathering multiple answers quickly with markdown-friendly prompts.',
     parameters: {
         type: 'object',
         properties: {
@@ -43,6 +43,7 @@ Especially useful for brainstorming ideas or discussing complex topics with the
 <features>
 - Opens a persistent OpenTUI window 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
@@ -54,6 +55,7 @@ Especially useful for brainstorming ideas or discussing complex topics with the
 <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 +85,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 OpenTUI intensive chat session.',
     parameters: {
         type: 'object',
         properties: {
@@ -129,6 +131,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

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 OpenTUI terminal prompt with markdown-friendly rendering 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',
@@ -56,17 +56,20 @@ Feel free to ask anything! **Proactive questioning is preferred over making assu
 
 <features>
 - OpenTUI prompt 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)
 - 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 +81,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 +100,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,6 +1,6 @@
 {
   "name": "@rawwee/interactive-mcp",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "main": "dist/index.js",
   "type": "module",
   "bin": {