@falkenslab/agent-kit 0.14.0 → 0.16.0

package/dist/tui/ink/SessionView.js

@@ -2,7 +2,7 @@ import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-run
 import wrapAnsi from "wrap-ansi";
 import { useEffect, useReducer, useRef, useState, useSyncExternalStore } from "react";
 import { Box, measureElement, Static, Text, useInput, useStdout } from "ink";
-import { Select } from "@inkjs/ui";
+import { MultiSelect, Select, TextInput } from "@inkjs/ui";
 import { liveWidth } from "./sessionModel.js";
 import { createRowCache, highlightRow, isMouseReport, mouseEvents, rowsBelow, scrollBy, selectedText, visibleRows, userBarRows, } from "./fullscreen.js";
 import { framePosition } from "./terminalCursor.js";
@@ -11,6 +11,7 @@ import { fitWidth, stripAnsi } from "./lineBuffer.js";
 import * as ui from "../ui.js";
 import { t } from "../../core/messages/index.js";
 import { inkColor } from "../theme.js";
+import { renderMarkdown } from "./markdown.js";
 // Numbered as in the Claude Code CLI's permission prompt; the digits and y/n/q answer too.
 const decisionOptions = () => [
     { label: `1. ${t().yes}`, value: "y" },
@@ -44,16 +45,42 @@ export function previewLines(lines, terminalRows, reservedRows = PANEL_RESERVED_
 }
 function CheckpointPanel({ checkpoint, renderApproval, reservedRows, width, }) {
     const decision = checkpoint.kind === "decision";
-    useInput((input) => {
-        const key = input.toLowerCase();
-        if (decision && DECISION_KEYS[key])
-            checkpoint.answer(DECISION_KEYS[key]);
-        else if (!decision && key === "1")
+    const text = checkpoint.kind === "text";
+    const choice = checkpoint.kind === "choice";
+    useInput((input, key) => {
+        if (text || choice) {
+            if (key.escape)
+                checkpoint.answer("");
+            return;
+        }
+        const lower = input.toLowerCase();
+        if (decision && DECISION_KEYS[lower])
+            checkpoint.answer(DECISION_KEYS[lower]);
+        else if (!decision && lower === "1")
             checkpoint.answer("");
     });
     const { prompt } = checkpoint;
     const { stdout } = useStdout();
-    return (_jsxs(Box, { flexDirection: "column", borderStyle: "round", borderColor: inkColor("accent"), paddingX: 1, children: [renderApproval ? (renderApproval(prompt)) : (_jsxs(_Fragment, { children: [_jsx(Text, { bold: true, children: prompt.title }), previewLines(prompt.lines, stdout.rows, reservedRows, width - PANEL_FRAME_COLUMNS).map((line, index) => (_jsx(Text, { children: line }, index))), !decision && prompt.question ? _jsx(Text, { dimColor: true, children: prompt.question }) : null] })), decision ? (_jsx(Box, { marginTop: 1, children: _jsx(Text, { children: t().proceed }) })) : null, _jsx(Box, { marginTop: decision ? 0 : 1, children: _jsx(Select, { options: decision ? decisionOptions() : manualOptions(), onChange: (value) => checkpoint.answer(decision ? value : "") }, checkpoint.id) })] }));
+    return (_jsxs(Box, { flexDirection: "column", borderStyle: "round", borderColor: inkColor("accent"), paddingX: 1, children: [renderApproval ? (renderApproval(prompt)) : (_jsxs(_Fragment, { children: [_jsx(Text, { bold: true, children: prompt.title }), previewLines(prompt.markdown ? renderMarkdown(prompt.lines.join("\n"), width - PANEL_FRAME_COLUMNS) : prompt.lines, stdout.rows, reservedRows, width - PANEL_FRAME_COLUMNS).map((line, index) => (_jsx(Text, { children: line }, index))), !decision && prompt.question ? _jsx(Text, { dimColor: true, children: prompt.question }) : null] })), decision ? (_jsx(Box, { marginTop: 1, children: _jsx(Text, { children: t().proceed }) })) : null, choice && checkpoint.choice ? (_jsx(ChoiceInput, { choice: checkpoint.choice, onAnswer: (value) => checkpoint.answer(value) }, checkpoint.id)) : text ? (_jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsxs(Box, { children: [_jsx(Text, { children: "> " }), _jsx(TextInput, { placeholder: t().textAnswerHint, onSubmit: (value) => checkpoint.answer(value.trim()) }, checkpoint.id)] }), _jsx(Text, { dimColor: true, children: t().textAnswerKeys })] })) : (_jsx(Box, { marginTop: decision ? 0 : 1, children: _jsx(Select, { options: decision ? decisionOptions() : manualOptions(), onChange: (value) => checkpoint.answer(decision ? value : "") }, checkpoint.id) }))] }));
+}
+/**
+ * A choice's options (one with Select, several with MultiSelect), plus "Other" to type an
+ * answer of one's own; answers as `InteractionPort.askChoice()` says: the numbers, then the
+ * typed answer on the next line.
+ */
+function ChoiceInput({ choice, onAnswer }) {
+    const [typing, setTyping] = useState(null);
+    const options = [...choice.options.map((label, i) => ({ label: `${i + 1}. ${label}`, value: String(i + 1) })), { label: t().otherOption, value: "other" }];
+    if (typing !== null) {
+        return (_jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsxs(Box, { children: [_jsx(Text, { children: "> " }), _jsx(TextInput, { placeholder: t().textAnswerHint, onSubmit: (value) => onAnswer([typing, value.trim()].filter(Boolean).join("\n")) })] }), _jsx(Text, { dimColor: true, children: t().textAnswerKeys })] }));
+    }
+    return (_jsxs(Box, { marginTop: 1, flexDirection: "column", children: [choice.multiple ? (_jsx(MultiSelect, { options: options, onSubmit: (values) => {
+                    const picked = values.filter((value) => value !== "other").join(",");
+                    if (values.includes("other"))
+                        setTyping(picked);
+                    else
+                        onAnswer(picked);
+                } })) : (_jsx(Select, { options: options, onChange: (value) => (value === "other" ? setTyping("") : onAnswer(value)) })), _jsx(Text, { dimColor: true, children: t().choiceKeys(choice.multiple) })] }));
 }
 function formatTokens(count) {
     return count >= 1000 ? `${(count / 1000).toFixed(1)}k` : String(count);
@@ -89,7 +116,21 @@ function LiveArea({ session, checkpoint, renderApproval, mode, width, statusExtr
     return (_jsxs(Box, { flexDirection: "column", flexShrink: 0, width: width, marginTop: session.liveGap ? 1 : 0, children: [stripAnsi(session.live) ? _jsx(Text, { children: session.live }) : null, checkpoint ? (_jsx(CheckpointPanel, { checkpoint: checkpoint, renderApproval: renderApproval, reservedRows: reservedRows, width: width })) : session.busy ? (
             // Always one blank line above the spinner: from this margin, or from the live area's
             // own when a separator is pending and nothing is written above the spinner yet.
-            _jsxs(Box, { flexDirection: "column", marginTop: stripAnsi(session.live) || !session.liveGap ? 1 : 0, children: [_jsx(Working, { label: session.activity ?? t().thinking, startedAt: session.turnStartedAt, width: width }), session.subagentActivity ? _jsx(Text, { dimColor: true, children: fitWidth(`  ↳ ${session.subagentActivity}`, width) }) : null] })) : null, checkpoint ? null : children, _jsx(Text, { children: fitWidth(status, width) })] }));
+            _jsxs(Box, { flexDirection: "column", marginTop: stripAnsi(session.live) || !session.liveGap ? 1 : 0, children: [_jsx(Working, { label: session.activity ?? t().thinking, startedAt: session.turnStartedAt, width: width }), session.subagentActivity ? _jsx(Text, { dimColor: true, children: fitWidth(`  ↳ ${session.subagentActivity}`, width) }) : null] })) : null, checkpoint || !session.todos ? null : _jsx(TodoList, { todos: session.todos, width: width }), checkpoint ? null : children, _jsx(Text, { children: fitWidth(status, width) })] }));
+}
+// At most this many tasks show; the rest are counted (the one in progress always shows).
+const MAX_TODOS = 8;
+/** The agent's task list (TodoWrite), as in the Claude Code CLI: `☐` pending, `◼` in progress, `☑` done. */
+function TodoList({ todos, width }) {
+    const current = todos.findIndex((todo) => todo.status === "in_progress");
+    const first = Math.max(0, Math.min(current - 2, todos.length - MAX_TODOS));
+    const shown = todos.slice(first, first + MAX_TODOS);
+    const hidden = todos.length - shown.length;
+    return (_jsxs(Box, { flexDirection: "column", marginTop: 1, children: [shown.map((todo, i) => {
+                const line = `  ${i === 0 ? "⎿ " : "  "}${todo.status === "completed" ? "☑" : todo.status === "in_progress" ? "◼" : "☐"} ${todo.content}`;
+                const fitted = fitWidth(line, width);
+                return (_jsx(Text, { children: todo.status === "completed" ? ui.dim(ui.strike(fitted)) : todo.status === "in_progress" ? ui.bold(fitted) : fitted }, first + i));
+            }), hidden > 0 ? _jsx(Text, { children: ui.dim(fitWidth(`     ${t().moreTodos(hidden)}`, width)) }) : null] }));
 }
 /** A history line for the inline view: the human's line as a bar, a tool group unfolded with Ctrl+O. */
 function inlineItem(item, expanded, width) {
@@ -133,6 +174,16 @@ function FullscreenSession({ session, checkpoint, renderApproval, mode, header,
         if (height !== historyHeight)
             setHistoryHeight(height);
     });
+    // The history's height now: `historyHeight` is set by the effect above after the layout,
+    // so a key or a click on the first frames would still find the terminal's height.
+    function heightNow() {
+        if (!historyRef.current)
+            return historyHeight;
+        const { height } = measureElement(historyRef.current);
+        if (height !== historyHeight)
+            setHistoryHeight(height);
+        return height;
+    }
     const [anchor, setAnchor] = useState(null);
     // Mirrored in a ref: mouse reports can arrive faster than React re-renders.
     const [selection, setSelectionState] = useState(null);
@@ -161,12 +212,15 @@ function FullscreenSession({ session, checkpoint, renderApproval, mode, header,
         if (!historyRef.current || end === start)
             return null;
         const box = framePosition(historyRef.current);
-        const firstY = box.y + historyHeight - (end - start); // the rows are bottom-aligned
+        const height = heightNow();
+        const firstY = box.y + height - (end - start); // the rows are bottom-aligned
         let offset = y - firstY;
-        if (offset < 0 || offset >= end - start) {
+        // Rows that don't fit are clipped above the box, not clickable.
+        const firstShown = Math.max(0, box.y - firstY);
+        if (offset < firstShown || offset >= end - start) {
             if (!clamp)
                 return null;
-            offset = Math.min(end - start - 1, Math.max(0, offset));
+            offset = Math.min(end - start - 1, Math.max(firstShown, offset));
         }
         return { row: start + offset, col: Math.max(0, x - box.x) };
     }
@@ -174,7 +228,8 @@ function FullscreenSession({ session, checkpoint, renderApproval, mode, header,
         for (const event of mouseEvents(text)) {
             if (event.kind === "wheel-up" || event.kind === "wheel-down") {
                 const steps = event.kind === "wheel-up" ? -WHEEL_ROWS : WHEEL_ROWS;
-                setAnchor((a) => scrollBy(a, steps, total, historyHeight));
+                const height = heightNow();
+                setAnchor((a) => scrollBy(a, steps, total, height));
             }
             else if (event.kind === "press") {
                 const cell = cellAt(event.x, event.y, false);
@@ -205,15 +260,15 @@ function FullscreenSession({ session, checkpoint, renderApproval, mode, header,
         }
     }
     useInput((text, key) => {
-        const page = Math.max(1, historyHeight - 1);
         if (isMouseReport(text))
             handleMouse(text);
         else if (isFocusReport(text))
             return;
-        else if (key.pageUp)
-            setAnchor((a) => scrollBy(a, -page, total, historyHeight));
-        else if (key.pageDown)
-            setAnchor((a) => scrollBy(a, page, total, historyHeight));
+        else if (key.pageUp || key.pageDown) {
+            const height = heightNow();
+            const page = Math.max(1, height - 1);
+            setAnchor((a) => scrollBy(a, key.pageUp ? -page : page, total, height));
+        }
         else if (key.ctrl && key.end)
             setAnchor(null);
         else if (text && !key.ctrl && !key.meta && !key.escape)

package/dist/tui/ink/inkInteraction.d.ts

@@ -1,9 +1,11 @@
-import type { ApprovalPrompt, InteractionPort } from "../../core/interaction.js";
-export type CheckpointKind = "decision" | "manual-intervention";
+import type { ApprovalPrompt, ChoiceSettings, InteractionPort } from "../../core/interaction.js";
+export type CheckpointKind = "decision" | "manual-intervention" | "text" | "choice";
 export interface Checkpoint {
     id: number;
     kind: CheckpointKind;
     prompt: ApprovalPrompt;
+    /** For a choice: the options and whether several can be picked. */
+    choice?: ChoiceSettings;
     /** Settles the checkpoint with the raw answer ("y", "n", "q" for a decision). */
     answer(value: string): void;
 }

package/dist/tui/ink/inkInteraction.js

@@ -1,4 +1,6 @@
+import { parseChoice } from "../../core/hooks/humanInput.js";
 import * as ui from "../ui.js";
+import { renderMarkdown } from "./markdown.js";
 import { t } from "../../core/messages/index.js";
 const outcome = (answer) => ({ y: ui.success(t().approved), n: ui.warn(t().rejected), q: ui.error(t().stopped) })[answer];
 /**
@@ -25,16 +27,30 @@ export function createInkInteraction(note) {
     function record(prompt, outcome) {
         note([ui.heading(`=== ${prompt.title} ===`), ...prompt.lines, outcome].join("\n"));
     }
-    function ask(kind, prompt, signal) {
+    /** How a settled checkpoint is written to the history. */
+    function settledAs(kind, value, choice) {
+        if (kind === "decision")
+            return outcome(value) ?? value;
+        if (kind === "text")
+            return value ? ui.success(`✔ ${value}`) : ui.dim(t().noAnswer);
+        if (kind === "choice" && choice) {
+            const answer = parseChoice(value, choice.options, choice.multiple);
+            const words = [...answer.chosen, ...(answer.other ? [answer.other] : [])];
+            return words.length ? ui.success(`✔ ${words.join("; ")}`) : ui.dim(t().noAnswer);
+        }
+        return ui.success(t().done);
+    }
+    function ask(kind, prompt, signal, choice) {
         return new Promise((resolve) => {
             const checkpoint = {
                 id: nextId++,
                 kind,
                 prompt,
+                ...(choice ? { choice } : {}),
                 answer(value) {
                     if (!remove(checkpoint))
                         return;
-                    record(prompt, kind === "decision" ? (outcome(value) ?? value) : ui.success(t().done));
+                    record(prompt.markdown ? { ...prompt, lines: renderMarkdown(prompt.lines.join("\n"), 80) } : prompt, settledAs(kind, value, choice));
                     resolve(value);
                 },
             };
@@ -50,6 +66,8 @@ export function createInkInteraction(note) {
         port: {
             askDecision: (prompt, signal) => ask("decision", prompt, signal),
             askManualIntervention: (prompt, signal) => ask("manual-intervention", prompt, signal),
+            askText: (prompt, signal) => ask("text", prompt, signal),
+            askChoice: (prompt, choice, signal) => ask("choice", prompt, signal, choice),
             notify: (message) => note(message),
         },
         subscribe(listener) {

package/dist/tui/ink/progressView.d.ts

@@ -2,12 +2,16 @@ import type { Mode } from "../../core/agentSpec.js";
 import { type ConsoleRenderer, type ConsoleRendererOptions } from "../consoleRenderer.js";
 import { type SessionModel } from "./sessionModel.js";
 import { type RenderApproval } from "./SessionView.js";
-import type { ToolPhrase } from "./toolGroup.js";
+import type { ResultFormatter, ToolDetail, ToolPhrase } from "./toolGroup.js";
 import { type Theme } from "../theme.js";
 /** Options of `createProgressView()`. */
 export interface ProgressViewOptions extends Omit<ConsoleRendererOptions, "output"> {
     /** How one of the agent's own tools counts in a folded group's summary (see `InkChatOptions.toolPhrase`). */
     toolPhrase?: (toolName: string) => ToolPhrase | undefined;
+    /** How much of the tool calls shows (see `InkChatOptions.toolDetail`); "full" if not given. */
+    toolDetail?: ToolDetail;
+    /** The result line under a tool call (see `InkChatOptions.formatResult`). */
+    formatResult?: ResultFormatter;
     /** Replaces the default preview in the approval and manual-intervention panels. */
     renderApproval?: RenderApproval;
     /** Shown in the status bar. */

package/dist/tui/ink/runChatInk.d.ts

@@ -4,7 +4,7 @@ import { type ModeControl } from "../../core/session.js";
 import { type ChatTuiOptions } from "../chatTui.js";
 import { type SessionOpener } from "../runs.js";
 import { type RenderApproval } from "./SessionView.js";
-import type { ToolPhrase } from "./toolGroup.js";
+import type { ResultFormatter, ToolDetail, ToolPhrase } from "./toolGroup.js";
 import { type HeaderInfo } from "./header.js";
 export type { HeaderInfo } from "./header.js";
 /** Options of `runChatInk()`: the chat's options plus the Ink-only ones. */
@@ -45,6 +45,21 @@ export interface InkChatOptions extends ChatTuiOptions {
      * counts as "used {n} tools".
      */
     toolPhrase?: (toolName: string) => ToolPhrase | undefined;
+    /**
+     * How much of the tool calls shows: `"full"` (the default), every call with its result
+     * line; `"calls"`, the calls without their results, a failed one with a short line in the
+     * kit's language instead of the tool's error; `"summary"`, one line per group ("Read 2
+     * files, ran 1 shell command"). Ctrl+O unfolds any of them into the full view. For an
+     * audience that doesn't need the tools' raw output. The session log is the same whatever
+     * the level.
+     */
+    toolDetail?: ToolDetail;
+    /**
+     * The line under a tool call for its result, e.g. a friendly one for an MCP tool whose
+     * output is written for the model: a string replaces the kit's (the result's first line),
+     * `null` hides it, `undefined` keeps it. Shown wherever results are (`"full"`, or unfolded).
+     */
+    formatResult?: ResultFormatter;
     /**
      * The session's mode control (`buildSessionOptions()` returns it): the status bar shows the
      * current mode, Shift+Tab switches between the modes it allows ("guided", "interactive"

package/dist/tui/ink/runChatInk.js

@@ -210,6 +210,8 @@ export async function runChatInk(options, tuiOptions = {}) {
     const model = createSessionModel({
         formatAction: tuiOptions.formatAction,
         toolPhrase: tuiOptions.toolPhrase,
+        toolDetail: tuiOptions.toolDetail,
+        formatResult: tuiOptions.formatResult,
         agentLabel: tuiOptions.agentLabel,
         onWrite: mirror,
         width: () => liveWidth(stdout.columns),
@@ -242,12 +244,17 @@ export async function runChatInk(options, tuiOptions = {}) {
     let run;
     let knownCommands;
     let generation = 0;
+    let unsubscribeMode;
     function connect() {
         const own = ++generation;
         queue = createInputQueue({ modeControl: modeControl() });
         run = runQuery(queue.iterable, { ...current.options, promptSuggestions: tuiOptions.promptSuggestions ?? true });
         const events = run.events[Symbol.asyncIterator]();
         input.setMode(modeControl()?.mode ?? null);
+        // The mode can also change from inside the session (the agent leaving plan mode with
+        // present_plan): the status bar follows it.
+        unsubscribeMode?.();
+        unsubscribeMode = modeControl()?.subscribe?.((mode) => input.setMode(mode));
         // Every registered command name and alias, built-ins included, for completion and for
         // catching an unknown "/command" before it reaches the model as plain text (see chatTui.ts).
         knownCommands = run.supportedCommands().then((commands) => new Set(commands.flatMap((c) => [c.name, ...(c.aliases ?? [])])), () => null);

package/dist/tui/ink/sessionModel.d.ts

@@ -1,12 +1,13 @@
 import type { AgentEvent, SessionUsage } from "../../core/runner.js";
 import { type ConsoleRenderer } from "../consoleRenderer.js";
-import { type ToolPhrase } from "./toolGroup.js";
+import { type ResultFormatter, type ToolDetail, type ToolPhrase } from "./toolGroup.js";
+import { type Todo } from "../../core/todos.js";
 export interface HistoryItem {
     id: number;
     text: string;
     /** What it is: the view draws the human's lines as a bar, and the spacing follows it. */
     kind?: OutputKind;
-    /** A folded group of tool calls: the lines it unfolds into with Ctrl+O. */
+    /** A group of tool calls: the lines it unfolds into with Ctrl+O (`text` is the folded view). */
     expanded?: string[];
 }
 /**
@@ -30,17 +31,23 @@ export interface SessionSnapshot {
     activity: string | null;
     /** Label of the latest action taken inside a subagent in this turn. */
     subagentActivity: string | null;
-    /** Tool calls shown one by one with their results (the default); Ctrl+O folds them into a summary line. */
+    /** Tool groups unfolded into every call with its result (Ctrl+O toggles it); folded, they show as `toolDetail` says. */
     expanded: boolean;
     turns: number;
     usage: SessionUsage | null;
     /** How full the context window is (0-100), after the latest turn; null until known. */
     contextPercent: number | null;
+    /** The main agent's task list (TodoWrite), while any task is still to do; null otherwise. */
+    todos: Todo[] | null;
 }
 export interface SessionModelOptions {
     formatAction?: (toolName: string, toolInput: unknown) => string;
     /** How a tool counts in a folded group's summary ("read 2 files"); built-in tools have their own. */
     toolPhrase?: (toolName: string) => ToolPhrase | undefined;
+    /** How much of the tool calls shows until Ctrl+O (see `ToolDetail`); "full" if not given. */
+    toolDetail?: ToolDetail;
+    /** The result line under a tool call (see `ResultFormatter`). */
+    formatResult?: ResultFormatter;
     agentLabel?: string;
     /** Called with everything the console renderer writes, e.g. to mirror a session log. */
     onWrite?: (text: string) => void;

package/dist/tui/ink/sessionModel.js

@@ -5,6 +5,7 @@ import { finishedLength, hasTable, renderMarkdown } from "./markdown.js";
 import { toolGroupExpanded, toolGroupSummary } from "./toolGroup.js";
 import * as ui from "../ui.js";
 import { t } from "../../core/messages/index.js";
+import { hasOpenTodos, parseTodos, TODO_TOOL } from "../../core/todos.js";
 /**
  * Columns the live area may use: short of the edge, where the Windows console wraps early
  * (see lineBuffer.ts). Read on every use, so a resized terminal is picked up.
@@ -29,6 +30,7 @@ const isBlank = (line) => stripAnsi(line).trim() === "";
  */
 export function createSessionModel(options = {}) {
     const formatAction = options.formatAction ?? createFriendlyToolLabel();
+    const toolDetail = options.toolDetail ?? "full";
     const width = () => Math.max(20, options.width?.() ?? 80);
     const listeners = new Set();
     let nextId = 0;
@@ -40,10 +42,11 @@ export function createSessionModel(options = {}) {
         turnStartedAt: null,
         activity: null,
         subagentActivity: null,
-        expanded: true,
+        expanded: toolDetail === "full",
         turns: 0,
         usage: null,
         contextPercent: null,
+        todos: null,
     };
     function update(changes) {
         snapshot = { ...snapshot, ...changes };
@@ -146,7 +149,15 @@ export function createSessionModel(options = {}) {
             return;
         const calls = group;
         group = null;
-        push([groupLine(calls)], "action", { expanded: toolGroupExpanded(calls, width()) });
+        push([folded(calls).join("\n")], "action", { expanded: unfolded(calls) });
+    }
+    /** A group with every call and its result: "full", or any level unfolded with Ctrl+O. */
+    function unfolded(calls) {
+        return toolGroupExpanded(calls, width(), { formatResult: options.formatResult });
+    }
+    /** A group as its level shows it folded: the calls without results, or one summary line. */
+    function folded(calls) {
+        return toolDetail === "calls" ? toolGroupExpanded(calls, width(), { results: false }) : [groupLine(calls)];
     }
     function groupLine(calls) {
         return INDENT + ui.dim(fitWidth(toolGroupSummary(calls, options.toolPhrase), width() - INDENT.length));
@@ -161,7 +172,7 @@ export function createSessionModel(options = {}) {
         let rows = liveRows;
         let kind = liveRows.length > 0 ? "agent" : null;
         if (group) {
-            rows = snapshot.expanded ? toolGroupExpanded(group, width()) : [groupLine(group)];
+            rows = snapshot.expanded ? unfolded(group) : folded(group);
             kind = "action";
         }
         const live = rows.join("\n");
@@ -181,6 +192,15 @@ export function createSessionModel(options = {}) {
                     return;
                 }
                 case "action": {
+                    // The task list isn't a tool call to show: it's drawn above the prompt, and the task
+                    // in progress becomes the spinner's label.
+                    const todos = event.toolName === TODO_TOOL ? parseTodos(event.input) : null;
+                    if (todos) {
+                        const current = todos.find((todo) => todo.status === "in_progress");
+                        snapshot = { ...snapshot, todos: hasOpenTodos(todos) ? todos : null, activity: current?.activeForm ?? snapshot.activity };
+                        refreshLive();
+                        return;
+                    }
                     flushSegment(true);
                     group ??= [];
                     group.push({ id: event.toolUseId, label: formatAction(event.toolName, event.input), toolName: event.toolName, result: null });
@@ -189,6 +209,8 @@ export function createSessionModel(options = {}) {
                     return;
                 }
                 case "tool-result": {
+                    if (event.toolName === TODO_TOOL)
+                        return;
                     const call = group?.find((c) => c.id === event.toolUseId);
                     if (call)
                         call.result = { isError: event.isError, text: event.text };
@@ -273,7 +295,7 @@ export function createSessionModel(options = {}) {
             lastKind = null;
             gapPending = false;
             reply = "";
-            snapshot = { ...snapshot, items: [], live: "", liveGap: false, turns: 0, usage: null, contextPercent: null };
+            snapshot = { ...snapshot, items: [], live: "", liveGap: false, turns: 0, usage: null, contextPercent: null, todos: null };
             refreshLive();
         },
         replay(messages, userLine) {

package/dist/tui/ink/toolGroup.d.ts

@@ -13,6 +13,27 @@ export interface ToolCall {
 }
 /** How a tool counts in a group's summary: the phrase for one call and for several, "{n}" standing for the count. */
 export type { ToolPhrase };
+/**
+ * How much of its tool calls a chat shows: `"full"`, every call with its result line;
+ * `"calls"`, the calls without their results (a failed call says so in one short line);
+ * `"summary"`, one line per group. Ctrl+O unfolds any of them into the full view.
+ */
+export type ToolDetail = "full" | "calls" | "summary";
+/**
+ * The line shown under a tool call for its result: a string replaces the kit's (plain text,
+ * drawn in the result's color, or the error color if it failed), `null` hides it, and
+ * `undefined` keeps the kit's (the result's first line).
+ */
+export type ResultFormatter = (toolName: string, result: {
+    isError: boolean;
+    text: string;
+}) => string | null | undefined;
+/** How `toolGroupExpanded()` draws the results. */
+export interface ResultOptions {
+    /** Show the result lines (the default); without them a failed call shows a short failure line. */
+    results?: boolean;
+    formatResult?: ResultFormatter;
+}
 /**
  * A folded group's one line, as in the Claude Code CLI: "Read 2 files, ran 1 shell
  * command". Calls to the same kind of tool are counted together, in the order they first
@@ -32,6 +53,6 @@ export declare function resultSummary(result: {
 /**
  * The calls one by one: each behind a `●`, then after `⎿` the calls a subagent made (the
  * latest few, dim) and the result in one line (a subagent's answer with its markdown
- * rendered), or "…" while it runs.
+ * rendered), or "…" while it runs. Without `options.results`, only a failure's short line.
  */
-export declare function toolGroupExpanded(calls: readonly ToolCall[], width: number): string[];
+export declare function toolGroupExpanded(calls: readonly ToolCall[], width: number, options?: ResultOptions): string[];

package/dist/tui/ink/toolGroup.js

@@ -43,20 +43,33 @@ export function resultSummary(result, markdown = false) {
     // would cancel a dim around it.
     return ui.toolResult(markdown ? stripAnsi(renderMarkdown(first, 1000)[0] ?? first) : first) + more;
 }
+/** The line under a call for its result, or null for none. */
+function resultLine(call, { results = true, formatResult }) {
+    if (!call.result)
+        return results ? ui.dim("…") : null;
+    if (!results)
+        return call.result.isError ? ui.error(t().toolFailed) : null;
+    const custom = formatResult?.(call.toolName, call.result);
+    if (custom === null)
+        return null;
+    if (custom !== undefined)
+        return call.result.isError ? ui.error(custom) : ui.toolResult(custom);
+    return resultSummary(call.result, SUBAGENT_TOOLS.has(call.toolName));
+}
 /**
  * The calls one by one: each behind a `●`, then after `⎿` the calls a subagent made (the
  * latest few, dim) and the result in one line (a subagent's answer with its markdown
- * rendered), or "…" while it runs.
+ * rendered), or "…" while it runs. Without `options.results`, only a failure's short line.
  */
-export function toolGroupExpanded(calls, width) {
+export function toolGroupExpanded(calls, width, options = {}) {
     return calls.flatMap((call) => {
         const children = call.children ?? [];
         const shown = children.slice(-MAX_CHILDREN);
-        const result = call.result ? fitWidth(resultSummary(call.result, SUBAGENT_TOOLS.has(call.toolName)), width - 5) : ui.dim("…");
+        const result = resultLine(call, options);
         const under = [
             ...(children.length > shown.length ? [ui.dim(t().earlierCalls(children.length - shown.length))] : []),
             ...shown.map((label) => fitWidth(ui.dim(`· ${label}`), width - 5)),
-            result,
+            ...(result === null ? [] : [fitWidth(result, width - 5)]),
         ];
         return [
             `${ui.toolBullet("●")} ${fitWidth(ui.toolLabel(call.label), width - 2)}`,

package/dist/tui/terminalInteraction.js

@@ -80,6 +80,8 @@ async function askOnTerminal(prompt, signal) {
 export const terminalInteractionPort = {
     askDecision: askOnTerminal,
     askManualIntervention: askOnTerminal,
+    askText: askOnTerminal,
+    askChoice: (prompt, choice, signal) => askOnTerminal({ ...prompt, lines: [...prompt.lines, ...choice.options.map((option, i) => `${i + 1}. ${option}`)], question: t().choiceQuestion(choice.multiple) }, signal),
     notify(message) {
         if (stdin.isTTY)
             console.log(message);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@falkenslab/agent-kit",
-  "version": "0.14.0",
+  "version": "0.16.0",
   "description": "Library for building an agent on top of the Claude Agent SDK",
   "author": "Francisco Vargas Ruiz",
   "license": "MIT",
@@ -62,11 +62,17 @@
   },
   "devDependencies": {
     "@eslint/js": "^10.0.1",
+    "@mozilla/readability": "^0.6.0",
     "@types/node": "^24.0.0",
+    "@types/turndown": "^5.0.6",
     "eslint": "^10.9.1",
+    "fflate": "^0.8.3",
     "globals": "^17.11.0",
     "ink-testing-library": "^4.0.0",
+    "linkedom": "^0.18.13",
+    "mammoth": "^1.13.0",
     "tsx": "^4.19.0",
+    "turndown": "^7.2.4",
     "typescript": "^5.7.0",
     "typescript-eslint": "^8.68.0"
   },
@@ -75,5 +81,29 @@
   },
   "publishConfig": {
     "access": "public"
+  },
+  "peerDependencies": {
+    "@mozilla/readability": ">=0.5.0",
+    "linkedom": ">=0.16.0",
+    "turndown": ">=7.0.0",
+    "mammoth": ">=1.6.0",
+    "fflate": ">=0.8.0"
+  },
+  "peerDependenciesMeta": {
+    "@mozilla/readability": {
+      "optional": true
+    },
+    "linkedom": {
+      "optional": true
+    },
+    "turndown": {
+      "optional": true
+    },
+    "mammoth": {
+      "optional": true
+    },
+    "fflate": {
+      "optional": true
+    }
   }
 }