@pugi/cli 0.1.0-alpha.10 → 0.1.0-alpha.15

package/dist/tui/repl-render.js

@@ -19,8 +19,11 @@
 import React from 'react';
 import { render } from 'ink';
 import { Repl } from './repl.js';
+import { printPugMascotPreInk } from './repl-splash-mascot.js';
 import { ReplSession, } from '../core/repl/session.js';
 import { resolveWorkspaceContext } from '../core/repl/workspace-context.js';
+import { SqliteSessionStore } from '../core/repl/store/index.js';
+import { slugForCwd } from '../core/repl/history.js';
 /**
  * Mount the REPL and resolve when the user exits via Ctrl+C × 2 or
  * `/quit`. The session is closed (server-side stays alive; resume via
@@ -33,6 +36,18 @@ export async function renderRepl(options) {
     // best-effort — any FS error falls back to a basename-only summary,
     // never blocks REPL launch. Wave 4 fix 2026-05-25.
     const workspace = options.workspace ?? resolveWorkspaceContext(process.cwd());
+    // α6.4: open the local SessionStore for `/resume` persistence. The
+    // store lives under `~/.pugi/projects/<slug>/`; failure is fail-safe
+    // — we log a one-line warning to stderr and continue with the REPL
+    // in memory-only mode. Lock-busy errors get the friendliest message
+    // so an operator running two REPLs in the same project understands
+    // the constraint.
+    const projectSlug = slugForCwd(process.cwd());
+    const { store, openedSessionId } = await openLocalStore({
+        projectSlug,
+        workspaceRoot: process.cwd(),
+        resumeLocalSessionId: options.resumeLocalSessionId,
+    });
     const session = new ReplSession({
         apiUrl: options.apiUrl,
         apiKey: options.apiKey,
@@ -40,20 +55,90 @@ export async function renderRepl(options) {
         cliVersion: options.cliVersion,
         transport,
         workspace,
+        store,
+        localSessionId: openedSessionId,
     });
+    // Restore the transcript from the JSONL log if we resumed an
+    // existing session. The restore is idempotent and bypasses persist
+    // (no double-write of replayed rows).
+    if (store && openedSessionId && options.resumeLocalSessionId) {
+        try {
+            const events = await store.loadEvents(openedSessionId, { limit: 500 });
+            session.restoreTranscript(events);
+        }
+        catch (error) {
+            const msg = error instanceof Error ? error.message : String(error);
+            process.stderr.write(`[pugi] Could not restore session ${openedSessionId.slice(0, 13)}: ${msg}\n`);
+        }
+    }
     // Kick off the connect; the Repl renders the connecting state until
     // the session pushes `connection: 'on_watch'` from the SSE onOpen.
     void session.start();
+    // α6.14.2 wave 5: paint the chafa-baked brand-pug ANSI render to
+    // stdout BEFORE Ink mounts. Ink's layout engine would mis-measure
+    // the truecolor escape sequences, so the pug must land verbatim.
+    // The flag is passed into <Repl /> so the splash component knows to
+    // skip its own hand-crafted PUG_MASCOT column — otherwise the
+    // operator sees both the chafa pug AND the ASCII fallback stacked.
+    // When skipSplash is true (operator opted out via --no-splash), we
+    // suppress the pre-print too so the boot stays silent.
+    const mascotPrePrinted = options.skipSplash === true ? false : printPugMascotPreInk(process.stdout);
     const instance = render(React.createElement(Repl, {
         session,
         updateBanner: options.updateBanner ?? null,
         skipSplash: options.skipSplash === true,
+        hideToolStream: options.hideToolStream === true,
+        mascotPrePrinted,
     }));
     try {
         await instance.waitUntilExit();
     }
     finally {
         session.close();
+        if (store) {
+            try {
+                await store.close();
+            }
+            catch {
+                /* idempotent — already closed */
+            }
+        }
+    }
+}
+/**
+ * Open the local SessionStore for the REPL bootstrap. Returns
+ * `{ store: null, openedSessionId: undefined }` on any error so the
+ * caller falls through to memory-only mode rather than failing the
+ * launch. The one error we surface verbatim is the lock-busy case —
+ * that one is operator-actionable.
+ */
+async function openLocalStore(input) {
+    // Honour an explicit opt-out for offline-strict environments / CI.
+    // PUGI_DISABLE_SESSION_STORE=1 wipes the integration to zero. Useful
+    // for hermetic test runs and for operators who do not want any
+    // persistence under $HOME.
+    if (process.env.PUGI_DISABLE_SESSION_STORE === '1') {
+        return { store: null, openedSessionId: undefined };
+    }
+    try {
+        const store = new SqliteSessionStore({ projectSlug: input.projectSlug });
+        const row = await store.open({
+            id: input.resumeLocalSessionId,
+            workspaceRoot: input.workspaceRoot,
+            projectSlug: input.projectSlug,
+        });
+        return { store, openedSessionId: row.id };
+    }
+    catch (error) {
+        const code = error?.code;
+        const msg = error instanceof Error ? error.message : String(error);
+        if (code === 'EBUSY_SESSION_LOCK') {
+            process.stderr.write(`[pugi] ${msg} Continuing without local session persistence.\n`);
+        }
+        else {
+            process.stderr.write(`[pugi] Local session store unavailable (${msg}). Continuing in memory-only mode.\n`);
+        }
+        return { store: null, openedSessionId: undefined };
     }
 }
 /* ------------------------------------------------------------------ */

package/dist/tui/repl-splash-mascot.js

@@ -0,0 +1,118 @@
+/**
+ * Chafa-validated brand-pug ANSI loader (α6.14.2 wave 5).
+ *
+ * CEO dogfood 2026-05-25: the hand-crafted 9-row ASCII pug in
+ * `repl-splash-art.ts` reads as "точно не похожа" — too abstract to
+ * carry the brand at boot. This module loads a pre-baked truecolor
+ * ANSI render of the canonical hero-pug PNG (cyber-zoo pug face with
+ * cyan eyes + circuit + chip) so the splash matches the brand glyph
+ * the operator already sees on pugi.io.
+ *
+ * Generation (operator-side, one-shot):
+ *   chafa --size 32x16 --symbols=block+space --colors=full \
+ *     apps/clawhost-web/public/brand/hero-pug.png \
+ *     > apps/pugi-cli/assets/pugi-mascot.ansi
+ *
+ * The output is committed verbatim to the repo and shipped inside the
+ * `@pugi/cli` npm tarball under `assets/pugi-mascot.ansi` (the
+ * `package.json` `files` allowlist explicitly opts in). Runtime does
+ * NOT need `chafa` installed — we just read the file bytes and write
+ * them to stdout. If the file is missing (degraded install, tarball
+ * corruption, dev cwd drift), the splash falls back to the hand-crafted
+ * `PUG_MASCOT` art so the boot never crashes.
+ *
+ * The pre-Ink write convention mirrors the Claude Code Chrome plugin
+ * splash pattern: raw bytes go to `process.stdout` BEFORE the Ink
+ * render mount, so the terminal interprets the truecolor escapes
+ * directly instead of Ink trying to layout-engine over them.
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { dirname, resolve as resolvePath } from 'node:path';
+import { fileURLToPath } from 'node:url';
+/**
+ * Resolve the on-disk path to `pugi-mascot.ansi` relative to the
+ * compiled module. The CLI ships to `node_modules/@pugi/cli/dist/tui/`
+ * so the asset lives at `node_modules/@pugi/cli/assets/pugi-mascot.ansi`
+ * — two directory hops up from this file. In a local `pnpm dev`
+ * checkout the structure is the same (`src/tui/` ⇒ `../../assets/`)
+ * because tsx re-resolves the same relative tree.
+ */
+export function pugMascotAssetPath() {
+    const here = dirname(fileURLToPath(import.meta.url));
+    return resolvePath(here, '..', '..', 'assets', 'pugi-mascot.ansi');
+}
+/**
+ * Read the chafa-baked ANSI render of the brand pug. Returns the raw
+ * bytes verbatim (UTF-8 string) — the terminal interprets the truecolor
+ * escapes directly. Returns null when the file is missing, unreadable,
+ * or trivially empty so the caller can fall back to `PUG_MASCOT`.
+ *
+ * `chafa --colors=full` wraps the render with cursor-hide (`\e[?25l`)
+ * on the head and cursor-show (`\e[?25h`) on the tail. We strip those
+ * so the splash does not accidentally hide the cursor across the rest
+ * of the REPL boot (Ink itself manages the cursor once it mounts).
+ *
+ * The asset is supply-chain controlled (committed in-repo, shipped in
+ * the npm tarball) so an arbitrary attacker cannot inject escapes
+ * today. The defence-in-depth strip below still drops categories of
+ * escapes that the splash has no legitimate need to emit — OSC window
+ * title sets, mouse-tracking enables, screen clears, cursor-position
+ * reports — so a future swap of the asset (or a corrupt tarball) cannot
+ * disrupt the terminal beyond the splash region. Truecolor (`CSI 38;2;
+ * R;G;B m`), reset (`CSI 0 m`), and explicit forms of cursor / line
+ * motion the render needs are left in.
+ */
+export function loadPugMascotAnsi() {
+    const path = pugMascotAssetPath();
+    try {
+        if (!existsSync(path))
+            return null;
+        const raw = readFileSync(path, 'utf8');
+        if (!raw || raw.length === 0)
+            return null;
+        // 1. Drop OSC sequences. Two terminator forms:
+        //      ESC ] ... BEL          (0x1b 0x5d ... 0x07)
+        //      ESC ] ... ESC \        (0x1b 0x5d ... 0x1b 0x5c, the ST form)
+        //    A truecolor splash never needs OSC (those are for window title,
+        //    icon, clipboard, hyperlinks, color-palette change). Drop them
+        //    so a corrupted asset cannot rename the operator's terminal tab
+        //    or smuggle a hyperlink into the splash region.
+        // 2. Drop CSI ? <mode> [hl] for mouse-tracking and screen-buffer
+        //    switch modes (1000, 1001, 1002, 1003, 1004, 1005, 1006, 1015,
+        //    1049, 47, 1047, 1048). These would either start swallowing
+        //    mouse input or flip the terminal into the alternate screen.
+        // 3. Drop CSI 6 n (cursor-position report). Would inject a fake
+        //    CPR into the operator's stdin stream.
+        // 4. Drop CSI [23]J / CSI [23]K (full screen / line clear). A
+        //    chafa render uses cursor-positioning per row, not bulk
+        //    erases; bulk clears would wipe whatever the operator already
+        //    had on screen above the splash.
+        // The cursor-hide/show wrappers (CSI ? 25 [lh]) are handled by
+        // the same CSI-?-mode pattern as the mouse / alt-screen modes.
+        const stripped = raw
+            .replace(/\x1b\][^\x07\x1b]*(?:\x07|\x1b\\)/g, '')
+            .replace(/\x1b\[\?(?:25|47|1000|1001|1002|1003|1004|1005|1006|1015|1047|1048|1049)[lh]/g, '')
+            .replace(/\x1b\[6n/g, '')
+            .replace(/\x1b\[[23]?[JK]/g, '');
+        if (stripped.trim().length === 0)
+            return null;
+        return stripped;
+    }
+    catch {
+        // Best-effort: any FS / decode error returns null so the splash
+        // falls back to the hand-crafted ASCII art. Never throws.
+        return null;
+    }
+}
+export function printPugMascotPreInk(sink) {
+    const ansi = loadPugMascotAnsi();
+    if (ansi === null)
+        return false;
+    // Trailing newline so the Ink header lands on a fresh row rather
+    // than smashing into the last pug row.
+    sink.write(ansi);
+    if (!ansi.endsWith('\n'))
+        sink.write('\n');
+    return true;
+}
+//# sourceMappingURL=repl-splash-mascot.js.map

package/dist/tui/repl-splash.js

@@ -61,7 +61,13 @@ export function ReplSplash(props) {
     if (props.skipSplash) {
         return null;
     }
-    return (_jsxs(Box, { flexDirection: "column", paddingX: 1, paddingY: 1, children: [_jsxs(Box, { flexDirection: "row", children: [_jsx(MascotColumn, {}), _jsxs(Box, { flexDirection: "column", marginLeft: 2, marginTop: 1, children: [_jsxs(Box, { children: [_jsx(Text, { bold: true, children: "Pugi" }), _jsx(Text, { bold: true, color: "cyan", children: ".io" }), _jsx(Text, { dimColor: true, children: `  v${props.cliVersion}` })] }), _jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsx(HeaderRow, { label: "Plan", value: props.plan ?? PLACEHOLDER }), _jsx(HeaderRow, { label: "Model", value: props.model ?? PLACEHOLDER }), _jsx(HeaderRow, { label: "Tenant", value: props.tenant ?? PLACEHOLDER }), _jsx(HeaderRow, { label: "Workspace", value: props.workspaceLabel })] })] })] }), _jsx(Box, { marginTop: 1, children: _jsx(Text, { dimColor: true, children: '─'.repeat(40) }) }), _jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsx(Text, { dimColor: true, children: "Tips for getting started:" }), _jsx(TipRow, { index: 1, text: "Type a brief, the workforce dispatches" }), _jsx(TipRow, { index: 2, text: "/help for slash commands, /web <url> to pull a page" }), _jsx(TipRow, { index: 3, text: "/skills install <name> for Anthropic / OpenClaw skills" })] })] }));
+    // α6.14.2 wave 5: when the host pre-printed the chafa-baked brand-pug
+    // ANSI render to stdout before Ink mounted, suppress the hand-crafted
+    // PUG_MASCOT column here so the operator does not see two stacked
+    // pugs. The header card still renders inline so wordmark + status
+    // rows stay attached to the splash flow.
+    const showHandCraftedMascot = props.mascotPrePrinted !== true;
+    return (_jsxs(Box, { flexDirection: "column", paddingX: 1, paddingY: 1, children: [_jsxs(Box, { flexDirection: "row", children: [showHandCraftedMascot ? _jsx(MascotColumn, {}) : null, _jsxs(Box, { flexDirection: "column", marginLeft: showHandCraftedMascot ? 2 : 0, marginTop: 1, children: [_jsxs(Box, { children: [_jsx(Text, { bold: true, children: "Pugi" }), _jsx(Text, { bold: true, color: "cyan", children: ".io" }), _jsx(Text, { dimColor: true, children: `  v${props.cliVersion}` })] }), _jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsx(HeaderRow, { label: "Plan", value: props.plan ?? PLACEHOLDER }), _jsx(HeaderRow, { label: "Model", value: props.model ?? PLACEHOLDER }), _jsx(HeaderRow, { label: "Tenant", value: props.tenant ?? PLACEHOLDER }), _jsx(HeaderRow, { label: "Workspace", value: props.workspaceLabel })] })] })] }), _jsx(Box, { marginTop: 1, children: _jsx(Text, { dimColor: true, children: '─'.repeat(40) }) }), _jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsx(Text, { dimColor: true, children: "Tips for getting started:" }), _jsx(TipRow, { index: 1, text: "Type a brief, the workforce dispatches" }), _jsx(TipRow, { index: 2, text: "/help for slash commands, /web <url> to pull a page" }), _jsx(TipRow, { index: 3, text: "/skills install <name> for Anthropic / OpenClaw skills" })] })] }));
 }
 /**
  * Renders the multi-line ASCII pug. Each row is split into colored

package/dist/tui/repl.js

@@ -20,22 +20,32 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { useCallback, useEffect, useMemo, useState } from 'react';
 import { Box, Text, useApp, useInput } from 'ink';
 import { PUGI_TAGLINE, THE_TEN } from '@pugi/personas';
-import { AgentTree } from './agent-tree.js';
+import { AgentTreePane } from './agent-tree-pane.js';
+import { AskModal, PlanReviewModal } from './ask-modal.js';
 import { ConversationPane } from './conversation-pane.js';
 import { InputBox } from './input-box.js';
 import { ReplSplash } from './repl-splash.js';
 import { StatusBar } from './status-bar.js';
+import { ToolStreamPane } from './tool-stream-pane.js';
 import { UpdateBanner } from './update-banner.js';
 import { collectWorkspaceContext } from './workspace-context.js';
 import { slugForCwd } from '../core/repl/history.js';
 import { SLASH_COMMAND_HELP, SLASH_COMMAND_GROUPS } from '../core/repl/slash-commands.js';
 const TICK_INTERVAL_MS = 200;
 const PULSE_INTERVAL_MS = 700;
+// α6.12: maximum transcript rows the conversation pane renders at once.
+// Older rows scroll off the top; full history stays in session state.
+const CONVERSATION_WINDOW = 12;
 export function Repl(props) {
     const [state, setState] = useState(props.session.getState());
     const [overlay, setOverlay] = useState('none');
     const [pulsePhase, setPulsePhase] = useState(0);
     const [tickNow, setTickNow] = useState((props.now ?? Date.now)());
+    // α6.12: operator-driven collapse for the tool stream pane. The CLI
+    // host can hide the pane entirely via `--no-tool-stream`; this state
+    // is the runtime toggle (Ctrl+T) for operators who want the pane on
+    // screen but folded to a single row while they read a long reply.
+    const [toolStreamCollapsed, setToolStreamCollapsed] = useState(false);
     // α6.14 wave 3: boot splash visible until first input, first
     // `agent.spawned` event, or 10s idle. The host gates the initial
     // visibility on `--no-splash` / PUGI_SKIP_SPLASH via `skipSplash`.
@@ -122,7 +132,31 @@ export function Repl(props) {
             setOverlay('none');
         }
     }, { isActive: overlay === 'help' || overlay === 'roster' });
-    return (_jsxs(Box, { flexDirection: "column", paddingX: 1, children: [props.updateBanner ? _jsx(UpdateBanner, { result: props.updateBanner }) : null, splashVisible ? (_jsx(ReplSplash, { cliVersion: state.cliVersion, workspaceLabel: state.workspaceLabel, plan: props.splashPlan, model: props.splashModel, tenant: props.splashTenant, onDismiss: dismissSplash })) : null, _jsx(Header, { state: state }), _jsx(Box, { flexDirection: "column", marginTop: 1, children: overlay === 'help' ? (_jsx(HelpOverlay, {})) : overlay === 'roster' ? (_jsx(RosterOverlay, {})) : overlay === 'farewell' ? (_jsx(FarewellOverlay, {})) : (_jsx(MainArea, { state: state, personaNames: personaNames, nowEpochMs: tickNow })) }), _jsxs(Box, { flexDirection: "column", marginTop: 1, children: [overlay === 'farewell' ? null : (_jsx(InputBox, { onSubmit: handleSubmit, onExit: handleExit, now: props.now, 
+    // α6.12: Ctrl+T toggles the tool stream pane between expanded and
+    // collapsed states. Active only while no overlay is open, so the
+    // toggle never fights the help/roster dismiss handler. The input box
+    // owns its own raw-input mode, so this listener only fires on the
+    // global Ctrl+T binding rather than every printable keystroke.
+    useInput((input, key) => {
+        if (key.ctrl && input === 't') {
+            setToolStreamCollapsed((prev) => !prev);
+        }
+    }, { isActive: overlay === 'none' && props.hideToolStream !== true });
+    // α6.3 office-hours: a pending ask or plan-review modal pauses input
+    // until the operator resolves it. The modal owns its own useInput
+    // hook, so the InputBox unmounts while a modal is open to avoid two
+    // raw-input listeners competing for the same keystroke. Resolution
+    // forwards through ReplSession.resolveAsk / resolvePlanReview.
+    const askPending = state.pendingAsk !== null;
+    const planPending = state.pendingPlanReview !== null;
+    const modalActive = askPending || planPending;
+    const handleAskResolve = useCallback((verdict) => {
+        void props.session.resolveAsk(verdict);
+    }, [props.session]);
+    const handlePlanReviewResolve = useCallback((result) => {
+        void props.session.resolvePlanReview(result);
+    }, [props.session]);
+    return (_jsxs(Box, { flexDirection: "column", paddingX: 1, children: [props.updateBanner ? _jsx(UpdateBanner, { result: props.updateBanner }) : null, splashVisible ? (_jsx(ReplSplash, { cliVersion: state.cliVersion, workspaceLabel: state.workspaceLabel, plan: props.splashPlan, model: props.splashModel, tenant: props.splashTenant, onDismiss: dismissSplash, mascotPrePrinted: props.mascotPrePrinted === true })) : null, _jsx(Header, { state: state }), _jsx(Box, { flexDirection: "column", marginTop: 1, children: overlay === 'help' ? (_jsx(HelpOverlay, {})) : overlay === 'roster' ? (_jsx(RosterOverlay, {})) : overlay === 'farewell' ? (_jsx(FarewellOverlay, {})) : (_jsx(MainArea, { state: state, personaNames: personaNames, nowEpochMs: tickNow, hideToolStream: props.hideToolStream === true, toolStreamCollapsed: toolStreamCollapsed })) }), state.pendingAsk ? (_jsx(Box, { marginTop: 1, children: _jsx(AskModal, { tag: state.pendingAsk, onResolve: handleAskResolve }) })) : null, state.pendingPlanReview ? (_jsx(Box, { marginTop: 1, children: _jsx(PlanReviewModal, { tag: state.pendingPlanReview, onResolve: handlePlanReviewResolve }) })) : null, _jsxs(Box, { flexDirection: "column", marginTop: 1, children: [overlay === 'farewell' || modalActive ? null : (_jsx(InputBox, { onSubmit: handleSubmit, onExit: handleExit, now: props.now, 
                         // Slug from process.cwd() (full path) so two workspaces with
                         // the same basename do not share history. state.workspaceLabel
                         // is the basename only. Codex review P2.
@@ -131,13 +165,23 @@ export function Repl(props) {
 function Header({ state }) {
     return (_jsxs(Box, { children: [_jsx(Text, { bold: true, children: "Pugi" }), _jsx(Text, { bold: true, color: "cyan", children: ".io" }), _jsx(Text, { dimColor: true, children: `  ·  workspace: ${state.workspaceLabel}  ·  v${state.cliVersion}  ·  ` }), _jsx(Text, { color: "cyan", children: state.connection === 'on_watch' ? 'on watch' : state.connection.replace('_', ' ') })] }));
 }
-function MainArea({ state, personaNames, nowEpochMs, }) {
-    // Show the last 12 transcript rows in the conversation slot so the
-    // bottom of the frame stays anchored to the input box. The agent
-    // tree drops below the transcript; new agents push the operator
-    // line up the screen, mirroring Claude Code / Codex CLI.
-    const conversationSlice = state.transcript.slice(-12);
-    return (_jsxs(Box, { flexDirection: "column", children: [_jsx(ConversationPane, { rows: conversationSlice, personaNames: personaNames }), _jsx(Box, { marginTop: 1, children: _jsx(AgentTree, { agents: state.agents, nowEpochMs: nowEpochMs }) })] }));
+function MainArea({ state, personaNames, nowEpochMs, hideToolStream, toolStreamCollapsed, }) {
+    // α6.12: three vertical panes stacked above the input box.
+    //
+    //   1. Conversation pane (top)  - transcript with Markdown render.
+    //   2. Tool stream pane (mid)   - live Read/Edit/Bash/Grep lines.
+    //                                  Hidden when `--no-tool-stream` is
+    //                                  set; collapsed via Ctrl+T while
+    //                                  the pane is visible.
+    //   3. Agent tree pane (bottom) - Cyber-Zoo roster with persona /
+    //                                  status / duration / token counts.
+    //
+    // The window over the transcript is small (last 12 rows) so the
+    // bottom of the frame stays anchored to the input box. New agents
+    // push the operator line up the screen, mirroring Claude Code /
+    // Codex CLI / Gemini CLI rendering.
+    const conversationSlice = state.transcript.slice(-CONVERSATION_WINDOW);
+    return (_jsxs(Box, { flexDirection: "column", children: [_jsx(ConversationPane, { rows: conversationSlice, personaNames: personaNames }), hideToolStream ? null : (_jsx(Box, { marginTop: 1, children: _jsx(ToolStreamPane, { calls: state.toolCalls, collapsed: toolStreamCollapsed }) })), _jsx(Box, { marginTop: 1, children: _jsx(AgentTreePane, { agents: state.agents, nowEpochMs: nowEpochMs }) })] }));
 }
 function HelpOverlay() {
     // Group commands by their `group` field so the operator scans the
@@ -187,12 +231,17 @@ function applyVerdictSideEffects(verdict, handlers) {
         case 'clear':
         case 'version':
         case 'jobs':
+        case 'ask':
+        case 'consensus':
         case 'diff':
         case 'cost':
         case 'status':
+        case 'resume':
         case 'stub':
             // All non-overlay verdicts: the session module already appended
-            // any operator-visible system lines. No further UI side effect.
+            // any operator-visible system lines (and, for `ask`, set
+            // pendingAsk so the modal renders on the next frame). No further
+            // UI side effect needed here.
             return;
     }
 }

package/dist/tui/tool-stream-pane.js

@@ -0,0 +1,91 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Box, Text } from 'ink';
+const DEFAULT_COLLAPSE_THRESHOLD = 5;
+const DEFAULT_MAX_ROWS = 8;
+export function ToolStreamPane(props) {
+    const calls = props.calls;
+    const collapseThreshold = props.collapseThreshold ?? DEFAULT_COLLAPSE_THRESHOLD;
+    const maxRows = props.maxRows ?? DEFAULT_MAX_ROWS;
+    if (calls.length === 0) {
+        return (_jsxs(Box, { flexDirection: "column", children: [_jsx(PaneHeader, { count: 0, collapsed: props.collapsed }), _jsx(Text, { dimColor: true, children: "No tool calls yet. Dispatch a brief and watch tools land here." })] }));
+    }
+    if (props.collapsed === true) {
+        return (_jsx(Box, { flexDirection: "column", children: _jsx(PaneHeader, { count: calls.length, collapsed: true }) }));
+    }
+    // Tail-window the rows so a long-running session does not overflow
+    // the bottom half of the frame. Older rows stay in the session state
+    // for /jobs and /diff inspection.
+    const visible = calls.slice(-maxRows);
+    return (_jsxs(Box, { flexDirection: "column", children: [_jsx(PaneHeader, { count: calls.length, collapsed: false }), visible.map((call) => (_jsx(ToolCallRow, { call: call, collapseThreshold: collapseThreshold }, call.id)))] }));
+}
+function PaneHeader({ count, collapsed }) {
+    const verb = collapsed ? 'Ctrl+T to expand' : 'Ctrl+T to collapse';
+    return (_jsxs(Box, { children: [_jsx(Text, { bold: true, dimColor: true, children: '─ tools ' }), _jsx(Text, { dimColor: true, children: `(${count})  ` }), _jsx(Text, { dimColor: true, children: verb })] }));
+}
+function ToolCallRow({ call, collapseThreshold, }) {
+    const glyph = statusGlyph(call.status);
+    const color = statusColor(call.status);
+    const label = formatToolLabel(call.tool, call.args);
+    const summary = formatSummary(call);
+    const showHint = (call.resultLines ?? 0) > collapseThreshold;
+    return (_jsxs(Box, { children: [_jsx(Text, { color: color, children: glyph }), _jsx(Text, { children: ' ' }), _jsx(Text, { bold: true, children: label }), _jsx(Text, { dimColor: true, children: `  ${summary}` }), showHint ? (_jsx(Text, { dimColor: true, children: `  · ${call.resultLines} lines, Ctrl+O to expand` })) : null] }));
+}
+function statusGlyph(status) {
+    switch (status) {
+        case 'running':
+            return '→';
+        case 'ok':
+            return '✓';
+        case 'error':
+            return '✗';
+    }
+}
+function statusColor(status) {
+    switch (status) {
+        case 'running':
+            return 'cyan';
+        case 'ok':
+            return 'green';
+        case 'error':
+            return 'red';
+    }
+}
+/**
+ * Render the canonical `Tool(args)` form. Tool names are capitalised
+ * the way Claude Code shows them; args are truncated to 60 chars so
+ * the row stays single-line even on 80-col terminals.
+ */
+function formatToolLabel(tool, args) {
+    const name = toolDisplayName(tool);
+    const trimmedArgs = args.length > 60 ? `${args.slice(0, 57)}…` : args;
+    return `${name}(${trimmedArgs})`;
+}
+function toolDisplayName(tool) {
+    switch (tool) {
+        case 'read':
+            return 'Read';
+        case 'edit':
+            return 'Edit';
+        case 'bash':
+            return 'Bash';
+        case 'grep':
+            return 'Grep';
+        case 'glob':
+            return 'Glob';
+        case 'web_fetch':
+            return 'WebFetch';
+    }
+}
+function formatSummary(call) {
+    if (call.status === 'running') {
+        return call.detail ?? 'running...';
+    }
+    if (call.status === 'error') {
+        return call.detail ?? 'error';
+    }
+    // ok
+    const duration = typeof call.durationMs === 'number' ? `${call.durationMs}ms` : '';
+    const detail = call.detail ?? 'OK';
+    return duration.length > 0 ? `${detail} ${duration}` : detail;
+}
+//# sourceMappingURL=tool-stream-pane.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pugi/cli",
-  "version": "0.1.0-alpha.10",
+  "version": "0.1.0-alpha.15",
   "description": "Pugi CLI — terminal-native software execution system",
   "homepage": "https://pugi.io",
   "repository": {
@@ -28,11 +28,12 @@
   "files": [
     "bin/run.js",
     "dist/**/*.js",
+    "assets/**/*.ansi",
     "README.md",
     "LICENSE"
   ],
   "engines": {
-    "node": ">=20"
+    "node": ">=22.5.0"
   },
   "publishConfig": {
     "access": "public"
@@ -48,7 +49,7 @@
     "undici": "^8.3.0",
     "zod": "^3.23.0",
     "@pugi/personas": "0.1.0",
-    "@pugi/sdk": "0.1.0-alpha.10"
+    "@pugi/sdk": "0.1.0-alpha.15"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",