agentk8 2.3.0 → 2.3.1

package/dist/components/App.js

@@ -9,9 +9,17 @@ import { ThinkingIndicator } from './ThinkingIndicator.js';
 import { runClaude } from '../lib/claude.js';
 import { runCouncil, checkCouncilAvailable, getAvailableModels } from '../lib/council.js';
 import { Confirmation } from './Confirmation.js';
+import { QuestionWizard } from './QuestionWizard.js';
 export const App = ({ mode, version }) => {
     const { exit } = useApp();
-    const [messages, setMessages] = useState([]);
+    // Initialize with welcome message as permanent first item
+    const [messages, setMessages] = useState([{
+            id: 'welcome',
+            role: 'system',
+            content: '',
+            timestamp: new Date(),
+            isWelcome: true,
+        }]);
     const [isProcessing, setIsProcessing] = useState(false);
     const [processingStartTime, setProcessingStartTime] = useState(null);
     const [totalTokens, setTotalTokens] = useState(0);
@@ -26,6 +34,60 @@ export const App = ({ mode, version }) => {
     const [councilAvailable, setCouncilAvailable] = useState(false);
     const [availableModels, setAvailableModels] = useState({});
     const [councilStage, setCouncilStage] = useState(null);
+    const [lastEscapeTime, setLastEscapeTime] = useState(0);
+    const [showExitHint, setShowExitHint] = useState(false);
+    const [questionWizardState, setQuestionWizardState] = useState(null);
+    // Clean orchestrator internal tags from response
+    const cleanOrchestratorTags = (response) => {
+        let cleaned = response;
+        // Remove <thinking>...</thinking> blocks
+        cleaned = cleaned.replace(/<thinking>[\s\S]*?<\/thinking>/g, '');
+        // Remove <task_analysis>...</task_analysis> blocks (keep content inside)
+        cleaned = cleaned.replace(/<\/?task_analysis>/g, '');
+        // Remove <response>...</response> tags (keep content inside)
+        cleaned = cleaned.replace(/<\/?response>/g, '');
+        // Clean up multiple consecutive newlines
+        cleaned = cleaned.replace(/\n{3,}/g, '\n\n');
+        // Clean up leading/trailing whitespace
+        cleaned = cleaned.trim();
+        return cleaned;
+    };
+    // Parse questions from orchestrator response
+    const parseQuestions = (response) => {
+        const questions = [];
+        let cleanedResponse = response;
+        // Match <question header="...">...</question> blocks
+        const questionRegex = /<question\s+header="([^"]+)">\s*([\s\S]*?)\s*<options>\s*([\s\S]*?)\s*<\/options>\s*<\/question>/g;
+        let match;
+        while ((match = questionRegex.exec(response)) !== null) {
+            const header = match[1];
+            const questionText = match[2].trim();
+            const optionsBlock = match[3];
+            // Parse options
+            const optionRegex = /<option(?:\s+recommended="true")?>(.*?)<\/option>/g;
+            const options = [];
+            let optionMatch;
+            while ((optionMatch = optionRegex.exec(optionsBlock)) !== null) {
+                const isRecommended = optionMatch[0].includes('recommended="true"');
+                options.push({
+                    label: optionMatch[1].trim(),
+                    recommended: isRecommended,
+                });
+            }
+            if (options.length > 0) {
+                questions.push({
+                    header,
+                    question: questionText,
+                    options,
+                });
+            }
+            // Remove this question block from the response
+            cleanedResponse = cleanedResponse.replace(match[0], '').trim();
+        }
+        // Clean orchestrator internal tags from the remaining response
+        cleanedResponse = cleanOrchestratorTags(cleanedResponse);
+        return { questions, cleanedResponse };
+    };
     // Check council availability on mount
     useEffect(() => {
         checkCouncilAvailable().then(setCouncilAvailable);
@@ -136,18 +198,21 @@ Respond with:
 1. Task Analysis (complexity, scope)
 2. Agents Required (list which specialists are needed)
 3. Step-by-Step Plan (numbered steps)
-4. Questions (if any clarification needed)
+4. Questions (if any clarification needed - use the XML question format)
 
 Format your response clearly with headers.`;
             const result = await runClaude(planPrompt, mode, autoAccept);
-            const mentioned = detectMentionedAgents(result.response);
+            // Check for questions in response
+            const { questions, cleanedResponse } = parseQuestions(result.response);
+            const mentioned = detectMentionedAgents(cleanedResponse || result.response);
             setCompletedAgents(['Orchestrator', ...mentioned]);
             setActiveAgent(undefined);
+            // Show the cleaned response (without question XML)
             const planMessage = {
                 id: (Date.now() + 1).toString(),
                 role: 'agent',
                 agentName: 'Orchestrator',
-                content: result.response,
+                content: cleanedResponse || result.response,
                 tokens: result.tokens,
                 timestamp: new Date(),
             };
@@ -155,31 +220,58 @@ Format your response clearly with headers.`;
             if (result.tokens) {
                 setTotalTokens(prev => prev + result.tokens.input + result.tokens.output);
             }
-            setConfirmationState({
-                message: 'Do you want to execute this plan?',
-                options: [
-                    { label: 'Yes, execute plan', value: 'yes', key: 'Enter' },
-                    { label: 'No, cancel', value: 'no', key: 'Esc' },
-                ],
-                onSelect: (value) => {
-                    setConfirmationState(null);
-                    if (value === 'yes') {
-                        executeTask(input);
-                    }
-                    else {
+            // Stop processing BEFORE showing wizard/confirmation to prevent overlap
+            setIsProcessing(false);
+            setProcessingStartTime(null);
+            // If questions were found, show the wizard
+            if (questions.length > 0) {
+                setQuestionWizardState({
+                    questions,
+                    originalInput: input,
+                    onComplete: async (answers) => {
+                        setQuestionWizardState(null);
+                        // Format answers as follow-up message
+                        const answerText = answers.map(a => `- ${a.header}: ${a.answer}`).join('\n');
+                        const followUp = `My answers:\n${answerText}\n\nPlease proceed with these choices.`;
+                        // Add user message with answers
+                        const userAnswer = {
+                            id: Date.now().toString(),
+                            role: 'user',
+                            content: followUp,
+                            timestamp: new Date(),
+                        };
+                        setMessages(prev => [...prev, userAnswer]);
+                        // Continue with the task including answers
+                        await executeTask(`${input}\n\n${followUp}`);
+                    },
+                });
+            }
+            else {
+                // No questions, show plan approval
+                setConfirmationState({
+                    message: 'Do you want to execute this plan?',
+                    options: [
+                        { label: 'Yes, execute plan', value: 'yes', key: 'Enter' },
+                        { label: 'No, cancel', value: 'no', key: 'Esc' },
+                    ],
+                    onSelect: (value) => {
+                        setConfirmationState(null);
+                        if (value === 'yes') {
+                            executeTask(input);
+                        }
+                        else {
+                            addSystemMessage('Plan cancelled.');
+                        }
+                    },
+                    onCancel: () => {
+                        setConfirmationState(null);
                         addSystemMessage('Plan cancelled.');
-                    }
-                },
-                onCancel: () => {
-                    setConfirmationState(null);
-                    addSystemMessage('Plan cancelled.');
-                },
-            });
+                    },
+                });
+            }
         }
         catch (err) {
             setError(err instanceof Error ? err.message : 'Unknown error');
-        }
-        finally {
             setIsProcessing(false);
             setProcessingStartTime(null);
         }
@@ -193,14 +285,16 @@ Format your response clearly with headers.`;
         setError(null);
         try {
             const result = await runClaude(input, mode, autoAccept);
-            const mentioned = detectMentionedAgents(result.response);
+            // Check for questions in response
+            const { questions, cleanedResponse } = parseQuestions(result.response);
+            const mentioned = detectMentionedAgents(cleanedResponse || result.response);
             setCompletedAgents(['Orchestrator', ...mentioned]);
             setActiveAgent(undefined);
             const agentMessage = {
                 id: (Date.now() + 1).toString(),
                 role: 'agent',
                 agentName: 'Orchestrator',
-                content: result.response,
+                content: cleanedResponse || result.response,
                 tokens: result.tokens,
                 timestamp: new Date(),
             };
@@ -208,11 +302,35 @@ Format your response clearly with headers.`;
             if (result.tokens) {
                 setTotalTokens(prev => prev + result.tokens.input + result.tokens.output);
             }
+            // Stop processing BEFORE showing wizard to prevent overlap
+            setIsProcessing(false);
+            setProcessingStartTime(null);
+            // If questions were found, show the wizard
+            if (questions.length > 0) {
+                setQuestionWizardState({
+                    questions,
+                    originalInput: input,
+                    onComplete: async (answers) => {
+                        setQuestionWizardState(null);
+                        // Format answers as follow-up message
+                        const answerText = answers.map(a => `- ${a.header}: ${a.answer}`).join('\n');
+                        const followUp = `My answers:\n${answerText}\n\nPlease proceed with these choices.`;
+                        // Add user message with answers
+                        const userAnswer = {
+                            id: Date.now().toString(),
+                            role: 'user',
+                            content: followUp,
+                            timestamp: new Date(),
+                        };
+                        setMessages(prev => [...prev, userAnswer]);
+                        // Continue with the task including answers
+                        await executeTask(`${input}\n\n${followUp}`);
+                    },
+                });
+            }
         }
         catch (err) {
             setError(err instanceof Error ? err.message : 'Unknown error');
-        }
-        finally {
             setIsProcessing(false);
             setProcessingStartTime(null);
         }
@@ -237,7 +355,14 @@ Format your response clearly with headers.`;
                 exit();
                 break;
             case 'clear':
-                setMessages([]);
+                // Keep welcome message, clear everything else
+                setMessages([{
+                        id: 'welcome',
+                        role: 'system',
+                        content: '',
+                        timestamp: new Date(),
+                        isWelcome: true,
+                    }]);
                 setActiveAgent(undefined);
                 setCompletedAgents([]);
                 break;
@@ -339,7 +464,7 @@ Keyboard shortcuts:
 ↑/↓       - Browse command history
 Tab       - Autocomplete commands
 Shift+Tab - Toggle auto-accept edits
-Ctrl+C    - Exit
+Esc Esc   - Exit
 Ctrl+U    - Clear input line`,
                     timestamp: new Date(),
                 };
@@ -369,8 +494,21 @@ Ctrl+U    - Clear input line`,
     };
     // Handle keyboard shortcuts
     useInput((input, key) => {
-        if (key.ctrl && input === 'c') {
-            exit();
+        // Double-escape to exit (like Claude Code)
+        if (key.escape) {
+            const now = Date.now();
+            if (now - lastEscapeTime < 500) {
+                // Double escape - exit
+                exit();
+            }
+            else {
+                // First escape - show hint and record time
+                setLastEscapeTime(now);
+                if (!questionWizardState && !confirmationState) {
+                    setShowExitHint(true);
+                    setTimeout(() => setShowExitHint(false), 1500);
+                }
+            }
         }
         // Shift+Tab to toggle auto-accept
         if (key.shift && key.tab) {
@@ -397,16 +535,15 @@ Ctrl+U    - Clear input line`,
             }
         }
     });
-    // Prepare items for Static (include welcome box as first item)
-    const staticItems = messages.length === 0
-        ? [{ id: 'welcome', isWelcome: true, role: 'system', content: '', timestamp: new Date() }]
-        : messages;
-    return (_jsxs(Box, { flexDirection: "column", children: [_jsx(Static, { items: staticItems, children: (item) => {
+    return (_jsxs(Box, { flexDirection: "column", children: [_jsx(Static, { items: messages, children: (item) => {
                     if ('isWelcome' in item && item.isWelcome) {
                         return _jsx(WelcomeBox, { version: version, mode: mode }, "welcome");
                     }
                     return (_jsx(ChatMessage, { role: item.role, agentName: item.agentName, content: item.content, tokens: item.tokens }, item.id));
-                } }), isProcessing && processingStartTime && (_jsx(ThinkingIndicator, { startTime: processingStartTime })), error && (_jsx(Box, { marginY: 1, marginLeft: 1, children: _jsxs(Text, { color: "#e53e3e", children: ["\u2717 Error: ", error] }) })), confirmationState ? (_jsx(Confirmation, { message: confirmationState.message, options: confirmationState.options, onSelect: confirmationState.onSelect, onCancel: confirmationState.onCancel })) : (_jsx(Input, { onSubmit: handleSubmit, disabled: isProcessing, placeholder: 'Try "build a password validator"' })), _jsx(StatusBar, { mode: mode, executionMode: executionMode, tokens: totalTokens, startTime: startTime, isProcessing: isProcessing, activeAgent: activeAgent, completedAgents: completedAgents, autoAccept: autoAccept, councilMode: councilMode, councilStage: councilStage, availableModels: availableModels })] }));
+                } }), isProcessing && processingStartTime && (_jsx(ThinkingIndicator, { startTime: processingStartTime })), error && (_jsx(Box, { marginY: 1, marginLeft: 1, children: _jsxs(Text, { color: "#e53e3e", children: ["\u2717 Error: ", error] }) })), questionWizardState ? (_jsx(QuestionWizard, { questions: questionWizardState.questions, onComplete: questionWizardState.onComplete, onCancel: () => {
+                    setQuestionWizardState(null);
+                    addSystemMessage('Questions cancelled.');
+                } }, `wizard-${questionWizardState.questions.map(q => q.header).join('-')}`)) : confirmationState ? (_jsx(Confirmation, { message: confirmationState.message, options: confirmationState.options, onSelect: confirmationState.onSelect, onCancel: confirmationState.onCancel })) : (_jsx(Input, { onSubmit: handleSubmit, disabled: isProcessing, placeholder: 'Try "build a password validator"' })), _jsx(StatusBar, { mode: mode, executionMode: executionMode, tokens: totalTokens, startTime: startTime, isProcessing: isProcessing, activeAgent: activeAgent, completedAgents: completedAgents, autoAccept: autoAccept, councilMode: councilMode, councilStage: councilStage, availableModels: availableModels, showExitHint: showExitHint })] }));
 };
 function formatElapsed(start) {
     const secs = Math.floor((Date.now() - start.getTime()) / 1000);

package/dist/components/ChatMessage.js

@@ -10,21 +10,113 @@ const theme = {
     user: '#9f7aea', // Purple for user
     agent: '#4fd1c5', // Teal for agent
     system: '#f6e05e', // Yellow for system
+    code: '#f6ad55', // Orange for inline code
+    header: '#63b3ed', // Blue for headers
 };
+// Parse inline markdown and return React elements
+function parseInlineMarkdown(text, defaultColor) {
+    const elements = [];
+    let remaining = text;
+    let key = 0;
+    while (remaining.length > 0) {
+        // Check for bold **text**
+        const boldMatch = remaining.match(/^\*\*(.+?)\*\*/);
+        if (boldMatch) {
+            elements.push(_jsx(Text, { color: defaultColor, bold: true, children: boldMatch[1] }, key++));
+            remaining = remaining.slice(boldMatch[0].length);
+            continue;
+        }
+        // Check for inline code `code`
+        const codeMatch = remaining.match(/^`([^`]+)`/);
+        if (codeMatch) {
+            elements.push(_jsx(Text, { color: theme.code, children: codeMatch[1] }, key++));
+            remaining = remaining.slice(codeMatch[0].length);
+            continue;
+        }
+        // Check for italic *text* or _text_
+        const italicMatch = remaining.match(/^(\*|_)([^*_]+)\1/);
+        if (italicMatch) {
+            elements.push(_jsx(Text, { color: defaultColor, italic: true, children: italicMatch[2] }, key++));
+            remaining = remaining.slice(italicMatch[0].length);
+            continue;
+        }
+        // Find next special character
+        const nextSpecial = remaining.search(/[\*`_]/);
+        if (nextSpecial === -1) {
+            // No more special chars, add rest as plain text
+            elements.push(_jsx(Text, { color: defaultColor, children: remaining }, key++));
+            break;
+        }
+        else if (nextSpecial === 0) {
+            // Special char at start but didn't match pattern - treat as literal
+            elements.push(_jsx(Text, { color: defaultColor, children: remaining[0] }, key++));
+            remaining = remaining.slice(1);
+        }
+        else {
+            // Add text before special char
+            elements.push(_jsx(Text, { color: defaultColor, children: remaining.slice(0, nextSpecial) }, key++));
+            remaining = remaining.slice(nextSpecial);
+        }
+    }
+    return elements;
+}
+// Render a single line with markdown formatting
+function renderLine(line, index, defaultColor) {
+    // Header detection (## Header)
+    const headerMatch = line.match(/^(#{1,3})\s+(.+)$/);
+    if (headerMatch) {
+        const level = headerMatch[1].length;
+        const content = headerMatch[2];
+        return (_jsx(Box, { children: _jsx(Text, { color: theme.header, bold: true, children: content }) }, index));
+    }
+    // List item detection (- item or * item)
+    const listMatch = line.match(/^(\s*)([-*])\s+(.+)$/);
+    if (listMatch) {
+        const indent = listMatch[1];
+        const content = listMatch[3];
+        return (_jsxs(Box, { children: [_jsxs(Text, { color: defaultColor, children: [indent, "\u2022 "] }), parseInlineMarkdown(content, defaultColor)] }, index));
+    }
+    // Numbered list detection (1. item)
+    const numberedMatch = line.match(/^(\s*)(\d+)\.\s+(.+)$/);
+    if (numberedMatch) {
+        const indent = numberedMatch[1];
+        const num = numberedMatch[2];
+        const content = numberedMatch[3];
+        return (_jsxs(Box, { children: [_jsxs(Text, { color: defaultColor, children: [indent, num, ". "] }), parseInlineMarkdown(content, defaultColor)] }, index));
+    }
+    // Table row detection (| col | col |)
+    if (line.includes('|') && (line.trim().startsWith('|') || line.includes(' | '))) {
+        // Keep table formatting as-is but with subtle styling
+        const isSeparator = line.match(/^[\s|:-]+$/);
+        if (isSeparator) {
+            return (_jsx(Box, { children: _jsx(Text, { color: theme.dim, children: line }) }, index));
+        }
+        return (_jsx(Box, { children: _jsx(Text, { color: defaultColor, children: line }) }, index));
+    }
+    // Regular line with inline markdown
+    return (_jsx(Box, { children: parseInlineMarkdown(line, defaultColor) }, index));
+}
 export const ChatMessage = ({ role, agentName = 'Agent', content, tokens, }) => {
     const isUser = role === 'user';
     const isSystem = role === 'system';
     const symbolColor = isUser ? theme.user : isSystem ? theme.system : theme.agent;
     const title = isUser ? 'You' : agentName;
+    const textColor = theme.text;
     const termWidth = process.stdout.columns || 80;
     const contentWidth = termWidth - 6;
+    // Split content into lines and wrap long lines
     const lines = wrapText(content, contentWidth);
-    return (_jsxs(Box, { flexDirection: "column", marginY: 1, marginLeft: 1, children: [_jsxs(Box, { children: [_jsx(Text, { color: symbolColor, children: '◆ ' }), _jsx(Text, { color: symbolColor, bold: true, children: title })] }), _jsx(Box, { flexDirection: "column", marginLeft: 2, children: lines.map((line, i) => (_jsx(Text, { color: theme.text, children: line }, i))) }), tokens && tokens.input + tokens.output > 0 && (_jsx(Box, { marginLeft: 2, children: _jsxs(Text, { color: theme.dim, children: ["\u2192 ", tokens.input + tokens.output, " tokens"] }) }))] }));
+    return (_jsxs(Box, { flexDirection: "column", marginY: 1, marginLeft: 1, children: [_jsxs(Box, { children: [_jsx(Text, { color: symbolColor, children: '◆ ' }), _jsx(Text, { color: symbolColor, bold: true, children: title })] }), _jsx(Box, { flexDirection: "column", marginLeft: 2, children: lines.map((line, i) => renderLine(line, i, textColor)) }), tokens && tokens.input + tokens.output > 0 && (_jsx(Box, { marginLeft: 2, children: _jsxs(Text, { color: theme.dim, children: ["\u2192 ", tokens.input + tokens.output, " tokens"] }) }))] }));
 };
 function wrapText(text, width) {
     const lines = [];
     const paragraphs = text.split('\n');
     for (const para of paragraphs) {
+        // Don't wrap table lines or lines with special formatting
+        if (para.includes('|') || para.match(/^#{1,3}\s/) || para.match(/^[\s]*[-*]\s/) || para.match(/^[\s]*\d+\.\s/)) {
+            lines.push(para);
+            continue;
+        }
         if (para.length <= width) {
             lines.push(para);
         }

package/dist/components/QuestionWizard.d.ts

@@ -0,0 +1,21 @@
+import React from 'react';
+export interface QuestionOption {
+    label: string;
+    recommended?: boolean;
+}
+export interface Question {
+    header: string;
+    question: string;
+    options: QuestionOption[];
+    answer?: string;
+}
+export interface QuestionWizardProps {
+    questions: Question[];
+    onComplete: (answers: {
+        header: string;
+        answer: string;
+    }[]) => void;
+    onCancel: () => void;
+}
+export declare const QuestionWizard: React.NamedExoticComponent<QuestionWizardProps>;
+export default QuestionWizard;

package/dist/components/QuestionWizard.js

@@ -0,0 +1,152 @@
+import { jsxs as _jsxs, jsx as _jsx, Fragment as _Fragment } from "react/jsx-runtime";
+import React, { useState, useCallback, memo } from 'react';
+import { Box, Text, useInput } from 'ink';
+const theme = {
+    border: '#2d3748',
+    accent: '#4fd1c5',
+    highlight: '#81e6d9',
+    text: '#e2e8f0',
+    dim: '#4a5568',
+    selected: '#4fd1c5',
+    unselected: '#718096',
+    answered: '#48bb78',
+    header: '#63b3ed',
+    no: '#e53e3e',
+};
+const QuestionWizardInner = ({ questions: initialQuestions, onComplete, onCancel, }) => {
+    // Single state object for atomic updates
+    const [state, setState] = useState({
+        questions: initialQuestions,
+        currentIndex: 0,
+        selectedOption: 0,
+        customInputMode: false,
+        customInputValue: '',
+        cursorPosition: 0,
+    });
+    const { questions, currentIndex, selectedOption, customInputMode, customInputValue, cursorPosition } = state;
+    const currentQuestion = questions[currentIndex];
+    const allOptions = [...currentQuestion.options, { label: 'No', recommended: false }];
+    const isOnNoOption = selectedOption === allOptions.length - 1;
+    const termWidth = process.stdout.columns || 80;
+    // Update state atomically
+    const updateState = useCallback((updates) => {
+        setState(prev => ({ ...prev, ...updates }));
+    }, []);
+    // Set answer and optionally advance
+    const selectOption = useCallback((answer, shouldAdvance) => {
+        setState(prev => {
+            const updatedQuestions = [...prev.questions];
+            updatedQuestions[prev.currentIndex] = {
+                ...updatedQuestions[prev.currentIndex],
+                answer
+            };
+            // Check if this is the last question and all are answered
+            const isLast = prev.currentIndex === prev.questions.length - 1;
+            const allAnswered = updatedQuestions.every(q => q.answer !== undefined);
+            if (isLast && allAnswered) {
+                // Will complete after state update
+                setTimeout(() => {
+                    onComplete(updatedQuestions.map(q => ({
+                        header: q.header,
+                        answer: q.answer || '',
+                    })));
+                }, 0);
+                return prev; // Keep current state, will unmount soon
+            }
+            return {
+                ...prev,
+                questions: updatedQuestions,
+                currentIndex: shouldAdvance && !isLast ? prev.currentIndex + 1 : prev.currentIndex,
+                selectedOption: shouldAdvance && !isLast ? 0 : prev.selectedOption,
+                customInputMode: false,
+                customInputValue: '',
+                cursorPosition: 0,
+            };
+        });
+    }, [onComplete]);
+    useInput((input, key) => {
+        if (customInputMode) {
+            if (key.escape) {
+                updateState({ customInputMode: false, customInputValue: '', cursorPosition: 0 });
+            }
+            else if (key.return && customInputValue.trim()) {
+                selectOption(customInputValue.trim(), true);
+            }
+            else if (key.backspace || key.delete) {
+                if (cursorPosition > 0) {
+                    updateState({
+                        customInputValue: customInputValue.slice(0, cursorPosition - 1) + customInputValue.slice(cursorPosition),
+                        cursorPosition: cursorPosition - 1,
+                    });
+                }
+            }
+            else if (key.leftArrow) {
+                updateState({ cursorPosition: Math.max(0, cursorPosition - 1) });
+            }
+            else if (key.rightArrow) {
+                updateState({ cursorPosition: Math.min(customInputValue.length, cursorPosition + 1) });
+            }
+            else if (!key.ctrl && !key.meta && input) {
+                updateState({
+                    customInputValue: customInputValue.slice(0, cursorPosition) + input + customInputValue.slice(cursorPosition),
+                    cursorPosition: cursorPosition + input.length,
+                });
+            }
+            return;
+        }
+        // Selection mode
+        if (key.upArrow) {
+            updateState({ selectedOption: selectedOption > 0 ? selectedOption - 1 : allOptions.length - 1 });
+        }
+        else if (key.downArrow) {
+            updateState({ selectedOption: selectedOption < allOptions.length - 1 ? selectedOption + 1 : 0 });
+        }
+        else if (key.leftArrow && currentIndex > 0) {
+            updateState({ currentIndex: currentIndex - 1, selectedOption: 0 });
+        }
+        else if (key.rightArrow && currentIndex < questions.length - 1 && currentQuestion.answer) {
+            updateState({ currentIndex: currentIndex + 1, selectedOption: 0 });
+        }
+        else if (key.tab) {
+            // Tab always opens custom input mode
+            updateState({ customInputMode: true, customInputValue: '', cursorPosition: 0 });
+        }
+        else if (key.return && isOnNoOption) {
+            // Enter on "No" also opens custom input
+            updateState({ customInputMode: true, customInputValue: '', cursorPosition: 0 });
+        }
+        else if (key.return && !isOnNoOption) {
+            selectOption(allOptions[selectedOption].label, true);
+        }
+        else if (key.escape) {
+            onCancel();
+        }
+        else {
+            const num = parseInt(input, 10);
+            if (!isNaN(num) && num > 0 && num <= allOptions.length) {
+                updateState({ selectedOption: num - 1 });
+            }
+        }
+    });
+    return (_jsxs(Box, { flexDirection: "column", borderStyle: "round", borderColor: theme.border, paddingX: 2, paddingY: 1, children: [_jsx(Box, { children: questions.map((q, i) => {
+                    const isCurrent = i === currentIndex;
+                    const isAnswered = q.answer !== undefined;
+                    const color = isCurrent ? theme.accent : isAnswered ? theme.answered : theme.unselected;
+                    return (_jsxs(React.Fragment, { children: [_jsxs(Text, { color: color, bold: isCurrent, children: ["[", isAnswered ? `${q.header} ✓` : q.header, "]"] }), i < questions.length - 1 && _jsx(Text, { color: theme.dim, children: "   " })] }, i));
+                }) }), _jsx(Box, { marginY: 1, children: questions.map((q, i) => {
+                    const isAnswered = q.answer !== undefined;
+                    const isCurrent = i === currentIndex;
+                    return (_jsxs(React.Fragment, { children: [_jsx(Text, { color: isAnswered ? theme.answered : isCurrent ? theme.accent : theme.dim, children: isAnswered ? '✓' : isCurrent ? '●' : '○' }), i < questions.length - 1 && _jsx(Text, { color: theme.dim, children: "\u2500\u2500\u2500\u2500" })] }, i));
+                }) }), _jsxs(Box, { children: [_jsx(Text, { color: theme.accent, children: "\u25C6 " }), _jsx(Text, { color: theme.header, bold: true, children: currentQuestion.header })] }), _jsx(Box, { marginLeft: 2, marginBottom: 1, children: _jsx(Text, { color: theme.text, children: currentQuestion.question }) }), _jsx(Box, { flexDirection: "column", marginLeft: 2, children: allOptions.map((opt, idx) => {
+                    const isSelected = idx === selectedOption;
+                    const isNo = idx === allOptions.length - 1;
+                    if (isNo) {
+                        // "No" option with inline custom input
+                        return (_jsxs(Box, { children: [_jsxs(Text, { color: isSelected ? (customInputMode ? theme.selected : theme.no) : theme.unselected, children: [isSelected ? '❯' : ' ', " ", idx + 1, ". No"] }), customInputMode ? (_jsxs(_Fragment, { children: [_jsx(Text, { color: theme.dim, children: ", " }), _jsx(Text, { color: theme.text, children: customInputValue.slice(0, cursorPosition) }), _jsx(Text, { inverse: true, children: customInputValue[cursorPosition] || ' ' }), _jsx(Text, { color: theme.text, children: customInputValue.slice(cursorPosition + 1) })] })) : (_jsx(Text, { color: theme.dim, children: " (Tab to type custom)" }))] }, idx));
+                    }
+                    return (_jsxs(Text, { color: isSelected ? theme.selected : theme.unselected, children: [isSelected ? '❯' : ' ', " ", idx + 1, ". ", opt.recommended ? `${opt.label} (Recommended)` : opt.label] }, idx));
+                }) }), _jsx(Box, { marginTop: 1, children: _jsx(Text, { color: theme.dim, children: customInputMode ? 'Type your answer · Enter submit · Esc cancel' : '↑/↓ select · Enter confirm · Tab custom · ←/→ questions' }) })] }));
+};
+// Memoize to prevent unnecessary re-renders
+export const QuestionWizard = memo(QuestionWizardInner);
+export default QuestionWizard;

package/dist/components/StatusBar.d.ts

@@ -13,6 +13,7 @@ interface StatusBarProps {
     councilMode?: CouncilMode;
     councilStage?: string | null;
     availableModels?: Record<string, boolean>;
+    showExitHint?: boolean;
 }
 export declare const StatusBar: React.FC<StatusBarProps>;
 export default StatusBar;

package/dist/components/StatusBar.js

@@ -29,7 +29,7 @@ const modelIcons = {
     gemini: 'M',
     claude: 'C',
 };
-export const StatusBar = ({ mode, executionMode, tokens, startTime, isProcessing = false, activeAgent, completedAgents = [], autoAccept = false, councilMode = 'off', councilStage = null, availableModels = {}, }) => {
+export const StatusBar = ({ mode, executionMode, tokens, startTime, isProcessing = false, activeAgent, completedAgents = [], autoAccept = false, councilMode = 'off', councilStage = null, availableModels = {}, showExitHint = false, }) => {
     const [elapsed, setElapsed] = useState('');
     const [spinnerFrame, setSpinnerFrame] = useState(0);
     const [pulseFrame, setPulseFrame] = useState(0);
@@ -106,6 +106,6 @@ export const StatusBar = ({ mode, executionMode, tokens, startTime, isProcessing
                         const leftBracket = isActive ? pulseBrackets[pulseFrame] : '[';
                         const rightBracket = isActive ? pulseBrackets[(pulseFrame + 3) % pulseBrackets.length] === '<' ? '>' : pulseBrackets[(pulseFrame + 3) % pulseBrackets.length] === '{' ? '}' : pulseBrackets[(pulseFrame + 3) % pulseBrackets.length] === '(' ? ')' : ']' : ']';
                         return (_jsxs(React.Fragment, { children: [_jsx(Text, { color: getAgentColor(agent), children: leftBracket }), _jsx(Text, { color: getAgentColor(agent), children: agentIcons[agent] }), _jsx(Text, { color: getAgentColor(agent), children: rightBracket }), i < modeAgents.length - 1 && _jsx(Text, { color: theme.dim, children: " " })] }, agent));
-                    })), _jsx(Text, { color: theme.border, children: " \u2502 " }), _jsx(Text, { color: theme.dim, children: "? help" }), councilMode !== 'off' && (_jsxs(_Fragment, { children: [_jsx(Text, { color: theme.border, children: " \u2502 " }), _jsx(Text, { color: theme.highlight, children: councilMode === 'council' ? 'COUNCIL' : 'SOLO' })] })), autoAccept && (_jsxs(_Fragment, { children: [_jsx(Text, { color: theme.border, children: " \u2502 " }), _jsx(Text, { color: theme.active, children: "FAST" })] })), isProcessing && (_jsxs(_Fragment, { children: [_jsx(Text, { color: theme.border, children: " \u2502 " }), _jsx(Text, { color: theme.highlight, children: icons.spinner[spinnerFrame] })] })), elapsed && (_jsxs(_Fragment, { children: [_jsx(Text, { color: theme.border, children: " \u2502 " }), _jsx(Text, { color: theme.dim, children: elapsed })] }))] }), _jsxs(Box, { children: [_jsxs(Text, { color: theme.accent, children: ["\u2191 ", formatTokens(tokens)] }), _jsx(Text, { color: theme.dim, children: " tokens " })] })] }));
+                    })), _jsx(Text, { color: theme.border, children: " \u2502 " }), _jsx(Text, { color: theme.dim, children: "? help" }), councilMode !== 'off' && (_jsxs(_Fragment, { children: [_jsx(Text, { color: theme.border, children: " \u2502 " }), _jsx(Text, { color: theme.highlight, children: councilMode === 'council' ? 'COUNCIL' : 'SOLO' })] })), autoAccept && (_jsxs(_Fragment, { children: [_jsx(Text, { color: theme.border, children: " \u2502 " }), _jsx(Text, { color: theme.active, children: "FAST" })] })), isProcessing && (_jsxs(_Fragment, { children: [_jsx(Text, { color: theme.border, children: " \u2502 " }), _jsx(Text, { color: theme.highlight, children: icons.spinner[spinnerFrame] })] })), elapsed && (_jsxs(_Fragment, { children: [_jsx(Text, { color: theme.border, children: " \u2502 " }), _jsx(Text, { color: theme.dim, children: elapsed })] }))] }), _jsxs(Box, { children: [showExitHint && (_jsxs(_Fragment, { children: [_jsx(Text, { color: theme.dim, children: "Press Esc again to exit" }), _jsx(Text, { color: theme.border, children: " \u2502 " })] })), _jsxs(Text, { color: theme.accent, children: ["\u2191 ", formatTokens(tokens)] }), _jsx(Text, { color: theme.dim, children: " tokens " })] })] }));
 };
 export default StatusBar;

package/dist/components/WelcomeBox.js

@@ -41,6 +41,6 @@ export const WelcomeBox = ({ version, mode }) => {
     ______\\   \\_______.--'.  \`---..._____...---'
     \`-------..__            \` ,/
                 \`-._ -  -  - |
-                    \`-------'` }) }), _jsx(Text, { color: theme.border, children: "\u2502" }), _jsxs(Box, { width: rightWidth, flexDirection: "column", justifyContent: "center", paddingLeft: 2, children: [_jsxs(Box, { marginBottom: 1, children: [_jsx(Text, { color: theme.text, children: "Welcome to " }), _jsx(Text, { color: theme.accent, bold: true, children: "AGENT-K" })] }), _jsx(Text, { color: theme.dim, children: "Pack Intelligence System" }), _jsxs(Box, { marginTop: 1, children: [_jsx(Text, { color: theme.dim, children: "Mode: " }), _jsx(Text, { color: theme.highlight, children: modeLabel })] })] }), _jsx(Text, { color: theme.border, children: "\u2502" })] }), _jsxs(Box, { children: [_jsx(Text, { color: theme.border, children: "\u2502" }), _jsx(Text, { children: ' '.repeat(boxWidth) }), _jsx(Text, { color: theme.border, children: "\u2502" })] }), _jsxs(Box, { children: [_jsx(Text, { color: theme.border, children: "\u2502" }), _jsx(Box, { width: boxWidth, justifyContent: "center", children: agents.map((agent, i) => (_jsxs(React.Fragment, { children: [_jsxs(Text, { color: theme.accent, children: ["[", agentIcons[agent], "] "] }), _jsx(Text, { color: theme.text, children: agent }), i < agents.length - 1 && _jsx(Text, { color: theme.dim, children: "  \u00B7  " })] }, agent))) }), _jsx(Text, { color: theme.border, children: "\u2502" })] }), _jsxs(Box, { children: [_jsx(Text, { color: theme.border, children: "\u2502" }), _jsx(Text, { children: ' '.repeat(boxWidth) }), _jsx(Text, { color: theme.border, children: "\u2502" })] }), _jsxs(Box, { children: [_jsx(Text, { color: theme.border, children: "\u2502" }), _jsx(Box, { width: boxWidth, justifyContent: "center", children: _jsx(Text, { color: theme.dim, children: "/help for commands  \u00B7  /plan or /auto to set mode  \u00B7  Ctrl+C to exit" }) }), _jsx(Text, { color: theme.border, children: "\u2502" })] }), _jsxs(Box, { children: [_jsx(Text, { color: theme.border, children: "\u2570" }), _jsx(Text, { color: theme.border, children: '─'.repeat(boxWidth) }), _jsx(Text, { color: theme.border, children: "\u256F" })] })] }));
+                    \`-------'` }) }), _jsx(Text, { color: theme.border, children: "\u2502" }), _jsxs(Box, { width: rightWidth, flexDirection: "column", justifyContent: "center", paddingLeft: 2, children: [_jsxs(Box, { marginBottom: 1, children: [_jsx(Text, { color: theme.text, children: "Welcome to " }), _jsx(Text, { color: theme.accent, bold: true, children: "AGENT-K" })] }), _jsx(Text, { color: theme.dim, children: "Pack Intelligence System" }), _jsxs(Box, { marginTop: 1, children: [_jsx(Text, { color: theme.dim, children: "Mode: " }), _jsx(Text, { color: theme.highlight, children: modeLabel })] })] }), _jsx(Text, { color: theme.border, children: "\u2502" })] }), _jsxs(Box, { children: [_jsx(Text, { color: theme.border, children: "\u2502" }), _jsx(Text, { children: ' '.repeat(boxWidth) }), _jsx(Text, { color: theme.border, children: "\u2502" })] }), _jsxs(Box, { children: [_jsx(Text, { color: theme.border, children: "\u2502" }), _jsx(Box, { width: boxWidth, justifyContent: "center", children: agents.map((agent, i) => (_jsxs(React.Fragment, { children: [_jsxs(Text, { color: theme.accent, children: ["[", agentIcons[agent], "] "] }), _jsx(Text, { color: theme.text, children: agent }), i < agents.length - 1 && _jsx(Text, { color: theme.dim, children: "  \u00B7  " })] }, agent))) }), _jsx(Text, { color: theme.border, children: "\u2502" })] }), _jsxs(Box, { children: [_jsx(Text, { color: theme.border, children: "\u2502" }), _jsx(Text, { children: ' '.repeat(boxWidth) }), _jsx(Text, { color: theme.border, children: "\u2502" })] }), _jsxs(Box, { children: [_jsx(Text, { color: theme.border, children: "\u2502" }), _jsx(Box, { width: boxWidth, justifyContent: "center", children: _jsx(Text, { color: theme.dim, children: "/help for commands  \u00B7  /plan or /auto to set mode  \u00B7  Esc Esc to exit" }) }), _jsx(Text, { color: theme.border, children: "\u2502" })] }), _jsxs(Box, { children: [_jsx(Text, { color: theme.border, children: "\u2570" }), _jsx(Text, { color: theme.border, children: '─'.repeat(boxWidth) }), _jsx(Text, { color: theme.border, children: "\u256F" })] })] }));
 };
 export default WelcomeBox;

package/dist/components/index.d.ts

@@ -9,3 +9,5 @@ export { RetroBox } from './Box.js';
 export { AgentStatus } from './AgentStatus.js';
 export { AgentPanel } from './AgentPanel.js';
 export type { AgentName, AgentState } from './AgentPanel.js';
+export { QuestionWizard } from './QuestionWizard.js';
+export type { Question, QuestionOption, QuestionWizardProps } from './QuestionWizard.js';

package/dist/components/index.js

@@ -8,3 +8,4 @@ export { ThinkingIndicator } from './ThinkingIndicator.js';
 export { RetroBox } from './Box.js';
 export { AgentStatus } from './AgentStatus.js';
 export { AgentPanel } from './AgentPanel.js';
+export { QuestionWizard } from './QuestionWizard.js';

package/dist/lib/claude.js

@@ -127,32 +127,69 @@ You are the Orchestrator—the central intelligence coordinator in AGENT-K, a mu
 4. **Think Transparently**: Show your reasoning process
 5. **Synthesize Results**: Provide cohesive, actionable outputs
 
-## RESPONSE PROTOCOL
-
-<thinking>
-For each request, analyze:
-- Task type and complexity (Simple | Moderate | Complex)
-- Required expertise areas
-- Dependencies between subtasks
-- Potential challenges or ambiguities
-</thinking>
-
-<task_analysis>
-┌─────────────────────────────────────────────────────────
-│ COMPLEXITY: [Simple|Moderate|Complex]
-│ AGENTS: [List involved agents]
-│ SUBTASKS: [If complex, list decomposed tasks]
-└─────────────────────────────────────────────────────────
-</task_analysis>
-
-<response>
-[Your comprehensive response here]
-</response>
+## RESPONSE FORMAT
+
+Structure your response with clear markdown headers (no XML tags in output):
+
+### Task Analysis
+| Aspect | Assessment |
+|--------|------------|
+| **Complexity** | Simple / Moderate / Complex |
+| **Agents** | List specialists needed |
+
+### Plan
+Numbered steps for execution.
+
+### Notes
+Any clarifications or considerations.
+
+IMPORTANT: Do NOT output raw XML tags like <thinking>, <task_analysis>, or <response> in your response. Use clean markdown formatting only.
 
 ## COMPLEXITY SCALING
 - **Simple** (1 agent, direct response): Factual questions, single-file changes, explanations
 - **Moderate** (2-3 agents, coordinated): Feature implementation, debugging, code review
-- **Complex** (3+ agents, parallel): Architecture design, full features, multi-file refactors`;
+- **Complex** (3+ agents, parallel): Architecture design, full features, multi-file refactors
+
+## ASKING QUESTIONS
+
+When you need clarification or user input before proceeding, use this XML format for EACH question:
+
+<question header="ShortLabel">
+Your question text here?
+<options>
+<option recommended="true">First option (mark recommended if applicable)</option>
+<option>Second option</option>
+<option>Third option</option>
+<option>Fourth option</option>
+</options>
+</question>
+
+Guidelines for questions:
+- header: Short label (1-2 words) like "Language", "Framework", "Approach"
+- question: Clear, specific question ending with ?
+- options: 2-4 concrete choices (user can also provide custom answer)
+- recommended: Add recommended="true" to the best default option
+
+Example with multiple questions:
+<question header="Language">
+What programming language should I use?
+<options>
+<option recommended="true">TypeScript</option>
+<option>Python</option>
+<option>Go</option>
+</options>
+</question>
+
+<question header="Features">
+Which features do you need?
+<options>
+<option recommended="true">Standard validation with error messages</option>
+<option>NIST guidelines compliance</option>
+<option>Password strength meter</option>
+</options>
+</question>
+
+IMPORTANT: Only ask questions when genuinely needed. For straightforward requests, proceed directly with analysis and recommendations.`;
     if (mode === 'ml') {
         return `${orchestratorCore}
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentk8",
-  "version": "2.3.0",
+  "version": "2.3.1",
   "description": "Multi-LLM Council Terminal Suite - Three-stage consensus with GPT, Gemini, and Claude",
   "type": "module",
   "main": "dist/index.js",