hoomanjs 1.31.0 → 1.32.0

package/README.md

@@ -21,7 +21,7 @@ It gives you a practical toolkit to build and run agent workflows:
 - a one-shot `exec` command for single prompts
 - a stateful `chat` interface for iterative sessions
 - a `daemon` command for channel-driven MCP automation
-- an Ink-powered `configure` workflow for app config, prompts, MCP servers, and installed skills
+- an in-chat `/config` workflow (Ink-powered) for app config, prompts, MCP servers, and installed skills
 - an `acp` command for running Hooman as an Agent Client Protocol (ACP) agent over stdio
 
 ## Related
@@ -53,7 +53,6 @@ It gives you a practical toolkit to build and run agent workflows:
 Fastest way to get started without cloning the repo:
 
 ```bash
-npx hoomanjs configure
 npx hoomanjs
 
 # or install globally
@@ -63,14 +62,13 @@ npm i -g hoomanjs
 Or with Bun:
 
 ```bash
-bunx hoomanjs configure
 bunx hoomanjs
 ```
 
 Recommended first run:
 
-1. Run `hooman configure` to choose your LLM provider and model.
-2. Start chatting with `hooman` (same as `hooman chat`).
+1. Start chatting with `hooman` (same as `hooman chat`).
+2. Run `/config` in chat to choose your LLM provider and model, and to manage MCP servers and skills.
 3. Use `hooman exec "your prompt"` for one-off tasks.
 
 ## Must have
@@ -182,6 +180,18 @@ Start in ask mode:
 hooman chat --mode ask
 ```
 
+### Chat commands
+
+Inside an interactive `chat` session, type `/` to discover slash commands:
+
+- `/model` - pick or set the chat model for this session.
+- `/mode` - switch the session mode (`agent`, `ask`, `plan`); see [Session mode](#session-mode).
+- `/yolo` - toggle auto-approve of tool calls (`on` / `off`).
+- `/init` - generate or refresh `AGENTS.md` for the current project.
+- `/compact` - compact the conversation history now and persist the result.
+- `/new` - start a fresh chat session.
+- `/config` - launch the configuration workflow (see below).
+
 ### Session mode
 
 `exec`, `chat`, and `daemon` accept **`-m` / `--mode`** with:
@@ -243,15 +253,15 @@ Runtime tool and prompt switches are controlled from `config.json`:
 - `tools.agents.enabled` (enables built-in `run_subagents` tool)
 - `tools.agents.concurrency` (defaults to `3` when omitted on load; a freshly generated default `config.json` uses `2`)
 
-### `hooman configure`
+### `/config`
 
-Open the Ink configuration workflow.
+The configuration workflow is launched from inside a `chat` session with the `/config` slash command (there is no separate top-level `configure` command). It takes over the terminal on the alternate screen buffer while open, and restores the chat session on exit. Any config changes are picked up when the session re-bootstraps.
 
-```bash
-hooman configure
+```text
+/config
 ```
 
-The configure UI currently lets you:
+The configuration UI currently lets you:
 
 - edit app configuration values
 - choose search provider and set its API key
@@ -751,7 +761,7 @@ The local skills folder is treated as a parent directory of skill subdirectories
 
 When a session starts, the plugin injects available skill metadata into the system prompt and exposes the `skills` tool so the model can activate a skill and load its full instructions on demand.
 
-The configure workflow can:
+The `/config` workflow can:
 
 - search the public skills catalog
 - install a skill from a source string, repo, URL, or local path

package/dist/chat/app.d.ts

@@ -15,6 +15,8 @@ type ChatAppProps = {
     steering: ChatTurnSteeringController;
     prompt?: string;
     onExit: () => void;
+    onNewSession: () => void;
+    onConfigure: () => void;
 };
-export declare function ChatApp({ agent, config, sessionId, manager, registry, approvals, steering, prompt, onExit, }: ChatAppProps): React.JSX.Element;
+export declare function ChatApp({ agent, config, sessionId, manager, registry, approvals, steering, prompt, onExit, onNewSession, onConfigure, }: ChatAppProps): React.JSX.Element;
 export {};

package/dist/chat/app.js

@@ -1,19 +1,21 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { useCallback, useEffect, useMemo, useRef, useState, } from "react";
 import fastq from "fastq";
-import { Box, useApp, useInput, useWindowSize } from "ink";
+import { Box, Static, useApp, useInput, useWindowSize } from "ink";
 import { Message, TextBlock, ToolResultBlock, ToolUseBlock, } from "@strands-agents/sdk";
 import { accumulateUsage, createEmptyUsage, } from "../core/utils/strands-usage-accumulate.js";
 import { modelProviders } from "../core/models/index.js";
 import { formatModeNames, isKnownSessionMode } from "../core/modes/index.js";
 import { takeFileToolDisplay } from "../core/state/file-tool-display.js";
 import { BottomChrome } from "./components/BottomChrome.js";
-import { Transcript } from "./components/Transcript.js";
+import { LiveTranscript, TranscriptLine } from "./components/Transcript.js";
+import { EmptyChatBanner } from "./components/EmptyChatBanner.js";
 import { getTodoViewState } from "../core/state/todos.js";
 import { isExitRequested } from "../core/state/exit-request.js";
 import { getModeState, setSessionMode, } from "../core/state/session-mode.js";
 import { isYoloEnabled, setYoloEnabled } from "../core/state/yolo.js";
 import { applySessionMode } from "../core/agent/sync-tool-registry-mode.js";
+import { getAgentConversationManager, getAgentSessionManager, } from "../core/agent/index.js";
 import { attachmentPathsToPromptBlocks } from "../core/utils/attachments.js";
 import { isMouseInput } from "./mouse.js";
 import { readBundledPrompt } from "../core/prompts/bundled.js";
@@ -237,6 +239,14 @@ function listModelsText(config) {
     ].join("\n");
 }
 const SLASH_COMMANDS = [
+    {
+        name: "compact",
+        description: "Compact conversation history now.",
+    },
+    {
+        name: "config",
+        description: "Launch the configuration flow.",
+    },
     {
         name: "init",
         description: "Generate or refresh AGENTS.md for this project.",
@@ -249,6 +259,10 @@ const SLASH_COMMANDS = [
         name: "model",
         description: "Pick or set the chat model.",
     },
+    {
+        name: "new",
+        description: "Start a new chat session.",
+    },
     {
         name: "yolo",
         description: "Auto-approve tools (on|off).",
@@ -268,36 +282,7 @@ function matchingSlashCommands(input) {
     }
     return SLASH_COMMANDS.filter((item) => item.name.startsWith(query));
 }
-function estimateChromeRows(params) {
-    let rows = 8;
-    if (params.running && params.todoCount > 0) {
-        rows += 2 + params.todoCount;
-    }
-    if (params.queueCount > 0) {
-        rows += 2 + params.queueCount;
-    }
-    if (params.pendingApproval) {
-        rows += 4;
-        return rows;
-    }
-    if (params.picker === "model") {
-        rows += 2 + 4;
-        return rows;
-    }
-    if (params.picker === "yolo") {
-        rows += 2 + 2;
-        return rows;
-    }
-    if (params.picker === "mode") {
-        rows += 2 + 3;
-        return rows;
-    }
-    if (params.slashCommandCount > 0) {
-        rows += params.slashCommandCount + 1;
-    }
-    return rows;
-}
-export function ChatApp({ agent, config, sessionId, manager, registry, approvals, steering, prompt, onExit, }) {
+export function ChatApp({ agent, config, sessionId, manager, registry, approvals, steering, prompt, onExit, onNewSession, onConfigure, }) {
     const { exit } = useApp();
     const windowSize = useWindowSize();
     const [input, setInput] = useState("");
@@ -318,7 +303,7 @@ export function ChatApp({ agent, config, sessionId, manager, registry, approvals
     }, []);
     const [slashHighlightIndex, setSlashHighlightIndex] = useState(0);
     const [queuedPrompts, setQueuedPrompts] = useState([]);
-    const [transcriptScrollOffset, setTranscriptScrollOffset] = useState(0);
+    const [mcpNeedsAttention, setMcpNeedsAttention] = useState(false);
     const [todoState, setTodoState] = useState(() => getTodoViewState(agent));
     const mountedRef = useRef(true);
     const runningRef = useRef(false);
@@ -354,6 +339,27 @@ export function ChatApp({ agent, config, sessionId, manager, registry, approvals
             cancelled = true;
         };
     }, [registry]);
+    // Surface MCP OAuth state in the status bar. Re-checked whenever a turn ends,
+    // since a tool call may have triggered (or completed) an auth flow mid-session.
+    useEffect(() => {
+        let cancelled = false;
+        void manager
+            .listAuthStatuses()
+            .then((rows) => {
+            if (cancelled) {
+                return;
+            }
+            setMcpNeedsAttention(rows.some((row) => row.status === "unauthenticated" || row.status === "expired"));
+        })
+            .catch(() => {
+            if (!cancelled) {
+                setMcpNeedsAttention(false);
+            }
+        });
+        return () => {
+            cancelled = true;
+        };
+    }, [manager, running]);
     useEffect(() => {
         if (!running || turnStartedAt === null) {
             setTurnElapsedMs(0);
@@ -427,6 +433,9 @@ export function ChatApp({ agent, config, sessionId, manager, registry, approvals
     const updateLine = useCallback((id, patch) => {
         setLines((prev) => prev.map((line) => (line.id === id ? { ...line, ...patch } : line)));
     }, []);
+    const removeLine = useCallback((id) => {
+        setLines((prev) => prev.filter((line) => line.id !== id));
+    }, []);
     const moveLineToEnd = useCallback((id) => {
         setLines((prev) => {
             const index = prev.findIndex((line) => line.id === id);
@@ -463,11 +472,17 @@ export function ChatApp({ agent, config, sessionId, manager, registry, approvals
         if (!id) {
             return;
         }
-        updateLine(id, { done: true });
+        const text = `${assistantCommittedTextRef.current}${streamedAssistantBlockRef.current ?? ""}`;
+        if (text.trim().length === 0) {
+            removeLine(id);
+        }
+        else {
+            updateLine(id, { done: true });
+        }
         assistantLineIdRef.current = null;
         assistantCommittedTextRef.current = "";
         streamedAssistantBlockRef.current = null;
-    }, [updateLine]);
+    }, [removeLine, updateLine]);
     const ensureAssistantLine = useCallback(() => {
         const existing = assistantLineIdRef.current;
         if (existing) {
@@ -652,6 +667,95 @@ export function ChatApp({ agent, config, sessionId, manager, registry, approvals
         applySessionMode(agent);
         bumpSessionChrome();
     }, [agent, appendLine, bumpSessionChrome]);
+    const handleCompactCommand = useCallback(async () => {
+        if (runningRef.current) {
+            appendLine({
+                id: nowId(),
+                role: "system",
+                title: "compact",
+                content: "Wait for the active turn to finish before compacting history.",
+                done: true,
+            });
+            return;
+        }
+        const conversationManager = getAgentConversationManager(agent);
+        if (!conversationManager) {
+            appendLine({
+                id: nowId(),
+                role: "system",
+                title: "compact",
+                content: "This session does not have a conversation manager to compact.",
+                done: true,
+            });
+            return;
+        }
+        const beforeCount = agent.messages.length;
+        try {
+            const reduced = await conversationManager.reduce({
+                agent,
+                model: agent.model,
+            });
+            const afterCount = agent.messages.length;
+            if (!reduced) {
+                appendLine({
+                    id: nowId(),
+                    role: "system",
+                    title: "compact",
+                    content: "Conversation history is already too short to compact.",
+                    done: true,
+                });
+                return;
+            }
+            await getAgentSessionManager(agent)?.saveSnapshot({
+                target: agent,
+                isLatest: true,
+            });
+            appendLine({
+                id: nowId(),
+                role: "system",
+                title: "compact",
+                content: `Compacted conversation history for future turns (${beforeCount} messages -> ${afterCount}).`,
+                done: true,
+            });
+        }
+        catch (error) {
+            appendLine({
+                id: nowId(),
+                role: "system",
+                title: "compact",
+                content: error instanceof Error ? error.message : String(error),
+                done: true,
+            });
+        }
+    }, [agent, appendLine]);
+    const handleNewCommand = useCallback(() => {
+        if (runningRef.current) {
+            appendLine({
+                id: nowId(),
+                role: "system",
+                title: "new",
+                content: "Wait for the active turn to finish before starting a new session.",
+                done: true,
+            });
+            return;
+        }
+        onNewSession();
+        exit();
+    }, [appendLine, exit, onNewSession]);
+    const handleConfigCommand = useCallback(() => {
+        if (runningRef.current) {
+            appendLine({
+                id: nowId(),
+                role: "system",
+                title: "config",
+                content: "Wait for the active turn to finish before launching configuration.",
+                done: true,
+            });
+            return;
+        }
+        onConfigure();
+        exit();
+    }, [appendLine, exit, onConfigure]);
     const runTurn = useCallback(async (prompt) => {
         const trimmed = prompt.text.trim();
         if (!trimmed && prompt.attachments.length === 0) {
@@ -895,7 +999,6 @@ export function ChatApp({ agent, config, sessionId, manager, registry, approvals
             id: nowId(),
             prompt: { ...normalized, text: trimmed },
         };
-        setTranscriptScrollOffset(0);
         setQueuedPrompts((prev) => [...prev, item]);
         void queueRef.current?.push(item).catch((error) => {
             if (!mountedRef.current) {
@@ -968,6 +1071,21 @@ export function ChatApp({ agent, config, sessionId, manager, registry, approvals
                 setInput("");
                 return;
             }
+            if (command.name === "compact") {
+                void handleCompactCommand();
+                setInput("");
+                return;
+            }
+            if (command.name === "config") {
+                handleConfigCommand();
+                setInput("");
+                return;
+            }
+            if (command.name === "new") {
+                handleNewCommand();
+                setInput("");
+                return;
+            }
         }
         if (pushPrompt(value)) {
             setInput("");
@@ -975,7 +1093,10 @@ export function ChatApp({ agent, config, sessionId, manager, registry, approvals
     }, [
         appendLine,
         handleModelCommand,
+        handleCompactCommand,
+        handleConfigCommand,
         handleModeCommand,
+        handleNewCommand,
         handleYoloCommand,
         pendingApproval,
         pushPrompt,
@@ -985,24 +1106,9 @@ export function ChatApp({ agent, config, sessionId, manager, registry, approvals
         if (isMouseInput(inputKey)) {
             return;
         }
-        if (!key.ctrl && !key.meta && !key.super) {
-            if (key.pageUp) {
-                setTranscriptScrollOffset((offset) => Math.min(Math.max(0, lines.length - 1), offset + transcriptScrollStep));
-                return;
-            }
-            if (key.pageDown) {
-                setTranscriptScrollOffset((offset) => Math.max(0, offset - transcriptScrollStep));
-                return;
-            }
-            if (key.home) {
-                setTranscriptScrollOffset(Math.max(0, lines.length - 1));
-                return;
-            }
-            if (key.end) {
-                setTranscriptScrollOffset(0);
-                return;
-            }
-        }
+        // Scrolling is handled natively by the terminal: finished transcript
+        // lines are flushed to real scrollback via <Static>, so the user scrolls
+        // with their mouse/trackpad/terminal like any other command output.
         if (key.ctrl && inputKey.toLowerCase() === "c") {
             if (runningRef.current) {
                 agent.cancel();
@@ -1041,38 +1147,36 @@ export function ChatApp({ agent, config, sessionId, manager, registry, approvals
         return `${String(min).padStart(2, "0")}:${String(sec).padStart(2, "0")}`;
     }, [turnElapsedMs]);
     const inputHint = running && queuedPrompts.length > 0 ? INPUT_HINT_WITH_STEERING : INPUT_HINT;
-    const transcriptRows = useMemo(() => Math.max(6, windowSize.rows -
-        estimateChromeRows({
-            running,
-            todoCount: todoState.visible ? todoState.todos.length : 0,
-            queueCount: queuedPrompts.length,
-            pendingApproval: Boolean(pendingApproval),
-            picker,
-            slashCommandCount: !pendingApproval && !picker ? slashCommands.length : 0,
-        }) -
-        2), [
-        pendingApproval,
-        picker,
-        queuedPrompts.length,
-        running,
-        slashCommands.length,
-        todoState.todos.length,
-        todoState.visible,
-        windowSize.rows,
-    ]);
-    const transcriptScrollStep = useMemo(() => Math.max(1, Math.floor(transcriptRows / 3)), [transcriptRows]);
-    useEffect(() => {
-        setTranscriptScrollOffset((offset) => Math.min(offset, lines.length - 1));
-    }, [lines.length]);
-    return (_jsxs(Box, { flexDirection: "column", width: "100%", paddingX: 1, height: Math.max(1, windowSize.rows - 1), children: [_jsx(Transcript, { lines: lines, assistantName: config.name, showEmptyBanner: lines.length === 0, marginTop: 1, maxRows: transcriptRows, scrollOffset: transcriptScrollOffset }), _jsx(BottomChrome, { config: config, running: running, status: status, sessionId: sessionId, currentModel: currentModelLabel(config), yoloOn: isYoloEnabled(agent), sessionMode: getModeState(agent).mode, elapsedLabel: elapsedLabel, turnCount: turnCount, totalTools: totalTools, skillsFound: skillsFound, manager: manager, usage: usage, todoState: todoState, queuedPrompts: queuedPrompts, pendingApproval: Boolean(pendingApproval), picker: picker, slashCommands: slashCommands, slashHighlightIndex: slashHighlightIndex, input: input, inputHint: inputHint, slashMenu: slashMenu, onApprovalDecision: (decision) => approvals.decide(decision), onModelSelect: (name) => {
-                    setPicker(null);
-                    void handleModelCommand(name);
-                }, onYoloSelect: (value) => {
-                    setPicker(null);
-                    void handleYoloCommand(value);
-                }, onModeSelect: (value) => {
-                    setPicker(null);
-                    void handleModeCommand(value);
-                }, onInputChange: setInput, onSubmit: onSubmit })] }));
+    // Split the transcript at the first not-yet-finalized entry. Everything before
+    // it is final and append-only, so it can be flushed to the terminal scrollback
+    // via <Static> (printed once, never re-rendered). Everything from there on is
+    // the live tail that Ink keeps re-rendering: streaming text, running tools,
+    // active reasoning. Using the done-prefix (rather than per-line `done`)
+    // guarantees Static only ever grows and stays in chronological order even when
+    // tools finish out of order.
+    const committedCount = useMemo(() => {
+        let end = 0;
+        while (end < lines.length && lines[end]?.done) {
+            end += 1;
+        }
+        return end;
+    }, [lines]);
+    const committedLines = useMemo(() => lines.slice(0, committedCount), [lines, committedCount]);
+    const liveLines = useMemo(() => lines.slice(committedCount), [lines, committedCount]);
+    // Before the first prompt there is nothing in scrollback yet, so grow the live
+    // region to the full viewport and vertically center the banner (with the
+    // composer pinned to the bottom). Once any line exists the region collapses to
+    // its natural height and finished lines flow into the terminal scrollback.
+    const isEmpty = lines.length === 0;
+    return (_jsxs(Box, { flexDirection: "column", width: "100%", children: [_jsx(Static, { items: committedLines, children: (line) => (_jsx(Box, { paddingX: 1, children: _jsx(TranscriptLine, { line: line, assistantName: config.name }) }, line.id)) }), _jsxs(Box, { flexDirection: "column", width: "100%", paddingX: 1, ...(isEmpty ? { height: Math.max(1, windowSize.rows - 1) } : {}), children: [isEmpty ? (_jsx(Box, { flexDirection: "column", flexGrow: 1, justifyContent: "center", children: _jsx(EmptyChatBanner, {}) })) : null, _jsx(LiveTranscript, { lines: liveLines, assistantName: config.name }), _jsx(BottomChrome, { config: config, running: running, status: status, sessionId: sessionId, currentModel: currentModelLabel(config), yoloOn: isYoloEnabled(agent), sessionMode: getModeState(agent).mode, elapsedLabel: elapsedLabel, turnCount: turnCount, totalTools: totalTools, skillsFound: skillsFound, manager: manager, mcpNeedsAttention: mcpNeedsAttention, usage: usage, todoState: todoState, queuedPrompts: queuedPrompts, pendingApproval: Boolean(pendingApproval), picker: picker, slashCommands: slashCommands, slashHighlightIndex: slashHighlightIndex, input: input, inputHint: inputHint, slashMenu: slashMenu, onApprovalDecision: (decision) => approvals.decide(decision), onModelSelect: (name) => {
+                            setPicker(null);
+                            void handleModelCommand(name);
+                        }, onYoloSelect: (value) => {
+                            setPicker(null);
+                            void handleYoloCommand(value);
+                        }, onModeSelect: (value) => {
+                            setPicker(null);
+                            void handleModeCommand(value);
+                        }, onInputChange: setInput, onSubmit: onSubmit })] })] }));
 }
 //# sourceMappingURL=app.js.map