praxis-agent 0.3.0 → 0.4.0

package/dist/cli/interactive.js

@@ -3,8 +3,9 @@ import { homedir } from 'node:os';
 import { resolve } from 'node:path';
 import { useEffect, useMemo, useRef, useState } from 'react';
 import { Box, Text, render, useApp, useInput } from 'ink';
+import { AgentRunCancelledError } from '../core/runtime.js';
 import { redactSensitiveText, sensitiveEnvironmentValues, } from '../platform/sensitive-data.js';
-import { CommandPalette, Composer, DiffDashboard, DialogFrame, ExternalEditorWait, HelpMenu, ListDashboard, MentionPicker, PermissionDashboard, SelectionMenu, SessionPicker, StatusDashboard, Transcript, WelcomePanel, useTerminalWidth, } from './tui/claude-style.js';
+import { CommandPalette, BtwPanel, Composer, DiffDashboard, DialogFrame, ExternalEditorWait, HelpMenu, ListDashboard, MentionPicker, PermissionDashboard, SelectionMenu, SessionPicker, StatusDashboard, Transcript, WelcomePanel, useTerminalWidth, } from './tui/claude-style.js';
 import { loadGitDiff, visiblePatchLines, } from './tui/git-diff.js';
 import { addTuiPermissionRule, loadTuiPermissionRules, removeTuiPermissionRule, } from './tui/permission-settings.js';
 import { filterTuiSlashCommands, mergeTuiSlashCommands, slashCommandQuery, } from './tui/slash-commands.js';
@@ -12,7 +13,7 @@ import { createComposerEditor, deleteComposerToEnd, deleteComposerToStart, delet
 import { applyMentionReference, fileReferenceAtCursor, filterTuiMentionEntries, loadTuiFileEntries, } from './tui/file-picker.js';
 import { editTuiPrompt, openTuiEditorFile, } from './tui/external-editor.js';
 import { suspendTuiProcess } from './tui/terminal-suspend.js';
-import { readTuiClipboard, writeTuiClipboard, } from './tui/clipboard.js';
+import { readTuiClipboard, writeTuiClipboard, writeTuiOsc52Clipboard, } from './tui/clipboard.js';
 import { composerImageIds, deleteComposerImageBackward, deleteComposerImageForward, insertComposerImageMarker, moveComposerCursorAcrossImages, } from './tui/composer-images.js';
 import { defaultTuiKeybindings, ensureTuiKeybindingsFile, hasTuiKeybindingPrefix, loadTuiKeybindings, resolveTuiKeybinding, tuiKeyChord, } from './tui/keybindings.js';
 import { completeTuiWorkspaceDirectory, resolveTuiWorkspaceDirectory, } from './tui/workspace-directories.js';
@@ -185,7 +186,7 @@ function ordinal(value) {
             return `${value}th`;
     }
 }
-export function InteractiveApp({ factory, initialSessions, initialPrompt, initialHistory = [], signal, onCancel, onTurnChange, onCleanup, axScreenReader = false, allowNewSession = true, resume, display = { version: 'dev', cwd: process.cwd() }, terminalWidth, slashCommands = EMPTY_SLASH_COMMANDS, agents = EMPTY_AGENTS, allowDangerouslySkipPermissions = false, additionalDirectories = [], diffLoader, fileLoader, externalEditor = editTuiPrompt, keybindingsConfigRoot, keybindingsFile = ensureTuiKeybindingsFile, keybindingsLoader = loadTuiKeybindings, keybindingsEditor = openTuiEditorFile, suspendProcess = suspendTuiProcess, clipboardReader = readTuiClipboard, clipboardWriter = writeTuiClipboard, exportWriter = writeConversationExport, permissionRuleStore, workspaceDirectoryResolver = resolveTuiWorkspaceDirectory, workspaceDirectoryCompleter = completeTuiWorkspaceDirectory, }) {
+export function InteractiveApp({ factory, initialSessions, initialPrompt, initialHistory = [], signal, onCancel, onTurnChange, onCleanup, axScreenReader = false, allowNewSession = true, resume, display = { version: 'dev', cwd: process.cwd() }, terminalWidth, slashCommands = EMPTY_SLASH_COMMANDS, agents = EMPTY_AGENTS, allowDangerouslySkipPermissions = false, additionalDirectories = [], diffLoader, fileLoader, externalEditor = editTuiPrompt, keybindingsConfigRoot, keybindingsFile = ensureTuiKeybindingsFile, keybindingsLoader = loadTuiKeybindings, keybindingsEditor = openTuiEditorFile, suspendProcess = suspendTuiProcess, clipboardReader = readTuiClipboard, clipboardWriter = writeTuiClipboard, sideQuestionClipboardWriter = writeTuiOsc52Clipboard, exportWriter = writeConversationExport, permissionRuleStore, workspaceDirectoryResolver = resolveTuiWorkspaceDirectory, workspaceDirectoryCompleter = completeTuiWorkspaceDirectory, }) {
     const { exit, suspendTerminal, waitUntilRenderFlush } = useApp();
     const width = useTerminalWidth(terminalWidth);
     const keybindingsRoot = useMemo(() => resolve(keybindingsConfigRoot ??
@@ -246,6 +247,12 @@ export function InteractiveApp({ factory, initialSessions, initialPrompt, initia
     const [editorFooterMessage, setEditorFooterMessage] = useState();
     const [availableSlashCommands, setAvailableSlashCommands] = useState(slashCommands);
     const [availableAgents, setAvailableAgents] = useState(agents);
+    const [btwHistory, setBtwHistory] = useState([]);
+    const btwHistoryRef = useRef([]);
+    const btwIdRef = useRef(0);
+    const btwControllerRef = useRef(null);
+    const [btwCopied, setBtwCopied] = useState(false);
+    const btwCopiedTimerRef = useRef(null);
     const [menu, setMenu] = useState(null);
     const menuRef = useRef(null);
     const [busy, setBusy] = useState(false);
@@ -427,8 +434,11 @@ export function InteractiveApp({ factory, initialSessions, initialPrompt, initia
         planApprovalRef.current?.resolve(false);
         if (exitConfirmationTimerRef.current)
             clearTimeout(exitConfirmationTimerRef.current);
+        if (btwCopiedTimerRef.current)
+            clearTimeout(btwCopiedTimerRef.current);
         scheduledWaitRef.current?.abort();
         turnControllerRef.current?.abort();
+        btwControllerRef.current?.abort();
         const closing = serviceRef.current?.close?.() ?? Promise.resolve();
         if (onCleanupRef.current)
             onCleanupRef.current(closing);
@@ -619,6 +629,11 @@ export function InteractiveApp({ factory, initialSessions, initialPrompt, initia
         menuRef.current = next;
         setMenu(next);
     };
+    const updateBtwHistory = (updater) => {
+        const next = updater(btwHistoryRef.current);
+        btwHistoryRef.current = next;
+        setBtwHistory(next);
+    };
     useEffect(() => {
         if (menu?.kind !== 'compact-progress')
             return;
@@ -1288,6 +1303,126 @@ export function InteractiveApp({ factory, initialSessions, initialPrompt, initia
         onTurnChange?.(showing);
         void showing.finally(() => onTurnChange?.(null));
     };
+    const showBtwUsage = () => {
+        appendPromptHistory('/btw');
+        const showing = (async () => {
+            try {
+                const activeSessionId = await (await service()).recordBtwUsage?.(sessionId ?? undefined, runtimePreferencesRef.current.permissionMode);
+                if (activeSessionId)
+                    setSessionId(activeSessionId);
+                append({ kind: 'user', text: '/btw' });
+                append({ kind: 'local-result', text: 'Usage: /btw <your question>' });
+            }
+            catch (error) {
+                warn(error);
+            }
+        })();
+        onTurnChange?.(showing);
+        void showing.finally(() => onTurnChange?.(null));
+    };
+    const askSideQuestion = (question) => {
+        const id = btwIdRef.current + 1;
+        btwIdRef.current = id;
+        appendPromptHistory(`/btw ${question}`);
+        const entry = {
+            id,
+            question,
+            answer: '',
+            status: 'answering',
+        };
+        updateBtwHistory((entries) => [...entries, entry]);
+        updateMenu({
+            kind: 'btw',
+            selectedIndex: btwHistoryRef.current.length - 1,
+            scrollOffset: 0,
+        });
+        setBtwCopied(false);
+        const controller = new AbortController();
+        btwControllerRef.current?.abort();
+        btwControllerRef.current = controller;
+        const sideSignal = signal
+            ? AbortSignal.any([signal, controller.signal])
+            : controller.signal;
+        const answering = (async () => {
+            try {
+                const commands = await service();
+                if (!commands.answerSideQuestion) {
+                    throw new Error('Side questions are unavailable.');
+                }
+                const result = await commands.answerSideQuestion(sessionId ?? undefined, question, sideSignal, (delta) => updateBtwHistory((entries) => entries.map((item) => item.id === id
+                    ? { ...item, answer: item.answer + delta }
+                    : item)), runtimePreferencesRef.current.permissionMode);
+                if (result.sessionId)
+                    setSessionId(result.sessionId);
+                updateBtwHistory((entries) => entries.map((item) => item.id === id ? { ...item, status: 'complete' } : item));
+                if (sideSignal.aborted)
+                    throw new AgentRunCancelledError();
+                setUsage((current) => ({
+                    inputTokens: (current?.inputTokens ?? 0) + result.usage.inputTokens,
+                    outputTokens: (current?.outputTokens ?? 0) + result.usage.outputTokens,
+                    cacheReadInputTokens: (current?.cacheReadInputTokens ?? 0) +
+                        (result.usage.cacheReadInputTokens ?? 0),
+                    cacheCreationInputTokens: (current?.cacheCreationInputTokens ?? 0) +
+                        (result.usage.cacheCreationInputTokens ?? 0),
+                }));
+                if (result.costUsd !== undefined) {
+                    const sideCostUsd = result.costUsd;
+                    setCostUsd((current) => (current ?? 0) + sideCostUsd);
+                }
+            }
+            catch (error) {
+                updateBtwHistory((entries) => entries.map((item) => item.id === id
+                    ? {
+                        ...item,
+                        status: 'error',
+                        error: sideSignal.aborted
+                            ? 'Cancelled'
+                            : error instanceof Error
+                                ? error.message
+                                : String(error),
+                    }
+                    : item));
+            }
+            finally {
+                if (btwControllerRef.current === controller) {
+                    btwControllerRef.current = null;
+                }
+            }
+        })();
+        onTurnChange?.(answering);
+        void answering.finally(() => onTurnChange?.(null));
+    };
+    const forkSideQuestion = (entry) => {
+        updateBtwHistory((entries) => entries.map((item) => item.id === entry.id ? { ...item, status: 'forking' } : item));
+        const forking = (async () => {
+            try {
+                if (!sessionId) {
+                    throw new Error('Start a conversation before forking a side question.');
+                }
+                const commands = await service();
+                if (!commands.forkSideQuestion) {
+                    throw new Error('Side-question forking is unavailable.');
+                }
+                const result = await commands.forkSideQuestion(sessionId, entry.question);
+                updateMenu(null);
+                append({
+                    kind: 'local-result',
+                    text: `⑂ forked ${result.name} (${result.agentId.slice(-4)})`,
+                });
+            }
+            catch (error) {
+                updateBtwHistory((entries) => entries.map((item) => item.id === entry.id
+                    ? {
+                        ...item,
+                        status: 'error',
+                        error: error instanceof Error ? error.message : String(error),
+                    }
+                    : item));
+            }
+        })();
+        onTurnChange?.(forking);
+        void forking.finally(() => onTurnChange?.(null));
+    };
     const renameSession = (requestedName) => {
         const renaming = (async () => {
             if (!sessionId) {
@@ -2019,6 +2154,69 @@ export function InteractiveApp({ factory, initialSessions, initialPrompt, initia
         }
         const activeMenu = menuRef.current;
         if (activeMenu) {
+            if (activeMenu.kind === 'btw') {
+                const selected = btwHistoryRef.current[activeMenu.selectedIndex];
+                if (key.escape || value === '\u001B') {
+                    btwControllerRef.current?.abort();
+                    btwControllerRef.current = null;
+                    updateMenu(null);
+                    return;
+                }
+                if (key.leftArrow || key.rightArrow) {
+                    updateMenu({
+                        ...activeMenu,
+                        selectedIndex: Math.max(0, Math.min(btwHistoryRef.current.length - 1, activeMenu.selectedIndex + (key.leftArrow ? -1 : 1))),
+                        scrollOffset: 0,
+                    });
+                    setBtwCopied(false);
+                    return;
+                }
+                if (key.upArrow || key.downArrow) {
+                    const maxOffset = Math.max(0, (selected?.answer.split('\n').length ?? 0) - 16);
+                    updateMenu({
+                        ...activeMenu,
+                        scrollOffset: Math.max(0, Math.min(maxOffset, activeMenu.scrollOffset + (key.upArrow ? -1 : 1))),
+                    });
+                    return;
+                }
+                if (lower === 'x' && btwHistoryRef.current.length > 1 && selected) {
+                    updateBtwHistory(() => [selected]);
+                    updateMenu({ kind: 'btw', selectedIndex: 0, scrollOffset: 0 });
+                    setBtwCopied(false);
+                    return;
+                }
+                if (lower === 'c' && selected?.status === 'complete') {
+                    const copying = sideQuestionClipboardWriter(selected.answer).then(() => {
+                        if (!componentMountedRef.current)
+                            return;
+                        setBtwCopied(true);
+                        if (btwCopiedTimerRef.current) {
+                            clearTimeout(btwCopiedTimerRef.current);
+                        }
+                        btwCopiedTimerRef.current = setTimeout(() => {
+                            if (componentMountedRef.current)
+                                setBtwCopied(false);
+                            btwCopiedTimerRef.current = null;
+                        }, 1500);
+                        btwCopiedTimerRef.current.unref?.();
+                    }, (error) => updateBtwHistory((entries) => entries.map((item) => item.id === selected.id
+                        ? {
+                            ...item,
+                            status: 'error',
+                            error: error instanceof Error
+                                ? error.message
+                                : String(error),
+                        }
+                        : item)));
+                    onTurnChange?.(copying);
+                    void copying.finally(() => onTurnChange?.(null));
+                    return;
+                }
+                if (lower === 'f' && selected?.status === 'complete') {
+                    forkSideQuestion(selected);
+                }
+                return;
+            }
             if (activeMenu.kind === 'help') {
                 if (key.escape) {
                     updateMenu(null);
@@ -2790,6 +2988,7 @@ export function InteractiveApp({ factory, initialSessions, initialPrompt, initia
             const copyCommand = /^\/copy(?:\s+(\d+))?$/u.exec(prompt);
             const renameCommand = /^\/rename(?:\s+(.+))?$/u.exec(prompt);
             const cdCommand = /^\/cd(?:\s+(.+))?$/u.exec(prompt);
+            const btwCommand = /^\/btw(?:\s+([\s\S]+))?$/u.exec(prompt);
             if (prompt === '/exit') {
                 exit();
             }
@@ -2830,6 +3029,13 @@ export function InteractiveApp({ factory, initialSessions, initialPrompt, initia
             else if (prompt === '/add-dir') {
                 openWorkspaceDirectoryInput();
             }
+            else if (btwCommand) {
+                const sideQuestion = btwCommand[1]?.trim();
+                if (sideQuestion)
+                    askSideQuestion(sideQuestion);
+                else
+                    showBtwUsage();
+            }
             else if (cdCommand) {
                 append({ kind: 'user', text: prompt });
                 const requestedCwd = cdCommand[1]?.trim();
@@ -3017,7 +3223,7 @@ export function InteractiveApp({ factory, initialSessions, initialPrompt, initia
                         ? `Retry interrupted ${permission.call.name}?`
                         : `Allow ${permission.call.name}?`, screenReader: axScreenReader, children: [_jsx(Text, { bold: true, children: describeTool(permission.call, sensitiveValues) }), _jsx(Text, { children: "\u276F 1. Yes" }), _jsx(Text, { children: " 2. No" }), _jsx(Text, { dimColor: true, children: "Enter/Esc declines \u00B7 y/n quick response" })] })) : planApproval ? (_jsxs(DialogFrame, { title: "Approve this plan and begin implementation?", screenReader: axScreenReader, children: [_jsx(Text, { dimColor: true, children: planApproval.request.planPath }), planApproval.request.plan ? (_jsx(Box, { marginY: 1, children: _jsx(Text, { children: planApproval.request.plan }) })) : null, _jsx(Text, { children: "\u276F 1. Yes, implement the plan" }), _jsx(Text, { children: " 2. No, keep planning" })] })) : question ? (_jsxs(DialogFrame, { title: `${question.questions[question.index]?.header}: ${question.questions[question.index]?.question}`, screenReader: axScreenReader, children: [question.questions[question.index]?.options.map((option, index) => (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Text, { children: [index === 0 ? '❯ ' : '  ', index + 1, ". ", option.label, " \u2014 ", option.description] }), option.preview ? (_jsx(Text, { dimColor: true, children: option.preview })) : null] }, `${index}-${option.label}`))), _jsxs(Text, { children: ["\u203A ", input] }), _jsx(Text, { dimColor: true, children: question.questions[question.index]?.multiSelect
                                 ? 'Enter comma-separated option numbers or custom text · Esc cancels'
-                                : 'Enter one option number or custom text · Esc cancels' })] })) : elicitation ? (_jsxs(DialogFrame, { title: `MCP elicitation (${elicitation.request.serverName})`, screenReader: axScreenReader, children: [_jsx(Text, { children: elicitation.request.message }), elicitation.request.url ? (_jsx(Text, { children: elicitation.request.url })) : null, elicitation.request.requestedSchema ? (_jsx(Text, { dimColor: true, children: JSON.stringify(elicitation.request.requestedSchema) })) : null, _jsxs(Text, { children: ["\u203A ", input] }), _jsx(Text, { dimColor: true, children: "Enter JSON object to accept \u00B7 Esc to cancel" })] })) : menu?.kind === 'model-input' ? (_jsxs(DialogFrame, { title: "Enter model ID", screenReader: axScreenReader, children: [_jsx(Text, { dimColor: true, children: "Enter a model ID supported by the configured provider." }), _jsxs(Text, { children: ["\u203A ", input] }), _jsx(Text, { dimColor: true, children: "Enter confirms \u00B7 Esc cancels" })] })) : menu?.kind === 'export-filename' ? (_jsxs(DialogFrame, { title: "Enter filename:", screenReader: axScreenReader, children: [_jsxs(Text, { children: ["> ", input] }), _jsx(Text, { dimColor: true, children: "Enter to save \u00B7 Esc to go back" })] })) : menu?.kind === 'compact-progress' ? (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { children: "\u273B Compacting conversation\u2026" }), _jsxs(Text, { children: ['▰'.repeat(Math.floor(compactProgress / 2)), '▱'.repeat(50 - Math.floor(compactProgress / 2)), ' ', compactProgress, "%"] })] })) : menu?.kind === 'rewind' ? (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { bold: true, children: " Rewind" }), _jsx(Text, { children: " " }), _jsxs(Text, { children: [' ', "Restore the code and/or conversation to the point before\u2026"] }), _jsx(Text, { children: " " }), (() => {
+                                : 'Enter one option number or custom text · Esc cancels' })] })) : elicitation ? (_jsxs(DialogFrame, { title: `MCP elicitation (${elicitation.request.serverName})`, screenReader: axScreenReader, children: [_jsx(Text, { children: elicitation.request.message }), elicitation.request.url ? (_jsx(Text, { children: elicitation.request.url })) : null, elicitation.request.requestedSchema ? (_jsx(Text, { dimColor: true, children: JSON.stringify(elicitation.request.requestedSchema) })) : null, _jsxs(Text, { children: ["\u203A ", input] }), _jsx(Text, { dimColor: true, children: "Enter JSON object to accept \u00B7 Esc to cancel" })] })) : menu?.kind === 'model-input' ? (_jsxs(DialogFrame, { title: "Enter model ID", screenReader: axScreenReader, children: [_jsx(Text, { dimColor: true, children: "Enter a model ID supported by the configured provider." }), _jsxs(Text, { children: ["\u203A ", input] }), _jsx(Text, { dimColor: true, children: "Enter confirms \u00B7 Esc cancels" })] })) : menu?.kind === 'export-filename' ? (_jsxs(DialogFrame, { title: "Enter filename:", screenReader: axScreenReader, children: [_jsxs(Text, { children: ["> ", input] }), _jsx(Text, { dimColor: true, children: "Enter to save \u00B7 Esc to go back" })] })) : menu?.kind === 'compact-progress' ? (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { children: "\u273B Compacting conversation\u2026" }), _jsxs(Text, { children: ['▰'.repeat(Math.floor(compactProgress / 2)), '▱'.repeat(50 - Math.floor(compactProgress / 2)), ' ', compactProgress, "%"] })] })) : menu?.kind === 'btw' ? (_jsx(BtwPanel, { entries: btwHistory, selectedIndex: menu.selectedIndex, scrollOffset: menu.scrollOffset, copied: btwCopied, width: width, screenReader: axScreenReader })) : menu?.kind === 'rewind' ? (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { bold: true, children: " Rewind" }), _jsx(Text, { children: " " }), _jsxs(Text, { children: [' ', "Restore the code and/or conversation to the point before\u2026"] }), _jsx(Text, { children: " " }), (() => {
                             const window = rewindPointWindow(menu.points, menu.selectedIndex);
                             return (_jsxs(_Fragment, { children: [window.start > 0 ? (_jsxs(Text, { dimColor: true, children: [" \u2191 ", window.start, " more above"] })) : null, menu.points
                                         .slice(window.start, window.end)