xonecas.io
64875
Mc

mini-coder / commit bb894b8

feat(cli): add reasoning display toggle and wiring

xonecas2026-03-11 bb894b887f8b0d568209552fc678210ed51701bf parent ee1f347

11 files changed

src/agent/agent.ts+11−0
@@ -10,6 +10,7 @@ import {
1010 listMcpServers,
1111 setPreferredActiveAgent,
1212 setPreferredModel,
13+ setPreferredShowReasoning,
1314 setPreferredThinkingEffort,
1415 } from "../session/db/index.ts";
1516 import type { SubagentSummary } from "../tools/subagent.ts";
@@ -25,6 +26,7 @@ interface AgentOptions {
2526 model: string;
2627 cwd: string;
2728 initialThinkingEffort: ThinkingEffort | null;
29+ initialShowReasoning: boolean;
2830 sessionId?: string;
2931 initialPrompt?: string;
3032 reporter: AgentReporter;
@@ -96,6 +98,7 @@ export async function runAgent(
9698 mcpTools,
9799 initialModel: currentModel,
98100 initialThinkingEffort: opts.initialThinkingEffort,
101+ initialShowReasoning: opts.initialShowReasoning,
99102 sessionId: opts.sessionId,
100103 extraSystemPrompt: opts.agentSystemPrompt,
101104 isSubagent: opts.headless,
@@ -133,6 +136,13 @@ export async function runAgent(
133136 runner.currentThinkingEffort = e;
134137 setPreferredThinkingEffort(e);
135138 },
139+ get showReasoning() {
140+ return runner.showReasoning;
141+ },
142+ setShowReasoning: (show) => {
143+ runner.showReasoning = show;
144+ setPreferredShowReasoning(show);
145+ },
136146 get planMode() {
137147 return runner.planMode;
138148 },
@@ -195,6 +205,7 @@ export async function runAgent(
195205 ralphMode: runner.ralphMode,
196206 thinkingEffort: runner.currentThinkingEffort,
197207 activeAgent: activeAgentName,
208+ showReasoning: runner.showReasoning,
198209 });
199210 }
200211
src/agent/reporter.ts+6−1
@@ -6,6 +6,7 @@ export interface TurnResult {
66 outputTokens: number;
77 contextTokens: number;
88 newMessages: CoreMessage[];
9+ reasoningText: string;
910 }
1011
1112 export interface StatusBarData {
@@ -21,6 +22,7 @@ export interface StatusBarData {
2122 ralphMode: boolean;
2223 thinkingEffort?: string | null;
2324 activeAgent?: string | null;
25+ showReasoning?: boolean;
2426 }
2527
2628 export interface AgentReporter {
@@ -32,7 +34,10 @@ export interface AgentReporter {
3234 startSpinner(label?: string): void;
3335 stopSpinner(): void;
3436
35- renderTurn(events: AsyncIterable<TurnEvent>): Promise<TurnResult>;
37+ renderTurn(
38+ events: AsyncIterable<TurnEvent>,
39+ opts?: { showReasoning?: boolean },
40+ ): Promise<TurnResult>;
3641 renderStatusBar(data: StatusBarData): void;
3742 renderHook(toolName: string, scriptPath: string, success: boolean): void;
3843
src/agent/session-runner.ts+6−1
@@ -34,6 +34,7 @@ interface SessionRunnerOptions {
3434 mcpTools: ToolDef[];
3535 initialModel: string;
3636 initialThinkingEffort: ThinkingEffort | null;
37+ initialShowReasoning: boolean;
3738 sessionId?: string | undefined;
3839 extraSystemPrompt?: string | undefined;
3940 isSubagent?: boolean | undefined;
@@ -47,6 +48,7 @@ export class SessionRunner {
4748 public mcpTools: ToolDef[];
4849 public currentModel: string;
4950 public currentThinkingEffort: ThinkingEffort | null;
51+ public showReasoning: boolean;
5052
5153 public session!: ActiveSession;
5254 public coreHistory!: CoreMessage[];
@@ -70,6 +72,7 @@ export class SessionRunner {
7072 this.mcpTools = opts.mcpTools;
7173 this.currentModel = opts.initialModel;
7274 this.currentThinkingEffort = opts.initialThinkingEffort;
75+ this.showReasoning = opts.initialShowReasoning;
7376 this.extraSystemPrompt = opts.extraSystemPrompt;
7477 this.isSubagent = opts.isSubagent;
7578 this.killSubprocesses = opts.killSubprocesses;
@@ -180,7 +183,9 @@ export class SessionRunner {
180183 });
181184
182185 const { inputTokens, outputTokens, contextTokens, newMessages } =
183- await this.reporter.renderTurn(events);
186+ await this.reporter.renderTurn(events, {
187+ showReasoning: this.showReasoning,
188+ });
184189
185190 if (newMessages.length > 0) {
186191 this.coreHistory.push(...newMessages);
src/cli/commands.ts+29−0
@@ -28,6 +28,8 @@ export interface CommandContext {
2828 setModel: (model: string) => void;
2929 thinkingEffort: ThinkingEffort | null;
3030 setThinkingEffort: (effort: ThinkingEffort | null) => void;
31+ showReasoning: boolean;
32+ setShowReasoning: (show: boolean) => void;
3133 planMode: boolean;
3234 setPlanMode: (enabled: boolean) => void;
3335 ralphMode: boolean;
@@ -195,6 +197,28 @@ async function handleModel(ctx: CommandContext, args: string): Promise<void> {
195197 );
196198 }
197199
200+function handleReasoning(ctx: CommandContext, args: string): void {
201+ const mode = args.trim().toLowerCase();
202+ if (!mode) {
203+ ctx.setShowReasoning(!ctx.showReasoning);
204+ writeln(
205+ `${PREFIX.success} reasoning display ${ctx.showReasoning ? c.green("on") : c.dim("off")}`,
206+ );
207+ return;
208+ }
209+ if (mode === "on") {
210+ ctx.setShowReasoning(true);
211+ writeln(`${PREFIX.success} reasoning display ${c.green("on")}`);
212+ return;
213+ }
214+ if (mode === "off") {
215+ ctx.setShowReasoning(false);
216+ writeln(`${PREFIX.success} reasoning display ${c.dim("off")}`);
217+ return;
218+ }
219+ writeln(`${PREFIX.error} usage: /reasoning <on|off>`);
220+}
221+
198222 function handlePlan(ctx: CommandContext): void {
199223 ctx.setPlanMode(!ctx.planMode);
200224 if (ctx.planMode) {
@@ -453,6 +477,7 @@ function handleHelp(
453477 const cmds: [string, string][] = [
454478 ["/model [id]", "list or switch models (fetches live list)"],
455479 ["/undo", "remove the last turn from conversation history"],
480+ ["/reasoning [on|off]", "toggle display of model reasoning output"],
456481 ["/plan", "toggle plan mode (read-only tools + MCP)"],
457482 [
458483 "/ralph",
@@ -557,6 +582,10 @@ export async function handleCommand(
557582 await handleUndo(ctx);
558583 return { type: "handled" };
559584
585+ case "reasoning":
586+ handleReasoning(ctx, args);
587+ return { type: "handled" };
588+
560589 case "plan":
561590 handlePlan(ctx);
562591 return { type: "handled" };
src/cli/headless-reporter.ts+15−2
@@ -19,18 +19,25 @@ export class HeadlessReporter implements AgentReporter {
1919 startSpinner(_label?: string): void {}
2020 stopSpinner(): void {}
2121
22- async renderTurn(events: AsyncIterable<TurnEvent>): Promise<TurnResult> {
22+ async renderTurn(
23+ events: AsyncIterable<TurnEvent>,
24+ _opts?: { showReasoning?: boolean },
25+ ): Promise<TurnResult> {
2326 let inputTokens = 0;
2427 let outputTokens = 0;
2528 let contextTokens = 0;
2629 let newMessages: CoreMessage[] = [];
2730 let accumulatedText = "";
31+ let reasoningText = "";
2832
2933 for await (const event of events) {
3034 switch (event.type) {
3135 case "text-delta":
3236 accumulatedText += event.delta;
3337 break;
38+ case "reasoning-delta":
39+ reasoningText += event.delta;
40+ break;
3441 case "turn-complete":
3542 inputTokens = event.inputTokens;
3643 outputTokens = event.outputTokens;
@@ -52,7 +59,13 @@ export class HeadlessReporter implements AgentReporter {
5259 }
5360 }
5461
55- return { inputTokens, outputTokens, contextTokens, newMessages };
62+ return {
63+ inputTokens,
64+ outputTokens,
65+ contextTokens,
66+ newMessages,
67+ reasoningText,
68+ };
5669 }
5770
5871 renderStatusBar(_data: StatusBarData): void {}
src/cli/output-reporter.ts+5−2
@@ -47,8 +47,11 @@ export class CliReporter implements AgentReporter {
4747 this.spinner.stop();
4848 }
4949
50- async renderTurn(events: AsyncIterable<TurnEvent>): Promise<TurnResult> {
51- return renderTurn(events, this.spinner);
50+ async renderTurn(
51+ events: AsyncIterable<TurnEvent>,
52+ opts?: { showReasoning?: boolean },
53+ ): Promise<TurnResult> {
54+ return renderTurn(events, this.spinner, opts);
5255 }
5356
5457 renderStatusBar(data: StatusBarData): void {
src/cli/status-bar.ts+2−0
@@ -44,12 +44,14 @@ export function renderStatusBar(opts: {
4444 ralphMode?: boolean;
4545 thinkingEffort?: string | null;
4646 activeAgent?: string | null;
47+ showReasoning?: boolean;
4748 }): void {
4849 const cols = (process.stdout as NodeJS.WriteStream).columns ?? 80;
4950
5051 // Build segments from right priority (rightmost items drop first)
5152 const left: string[] = [c.cyan(opts.model)];
5253 if (opts.thinkingEffort) left.push(c.dim(`✦ ${opts.thinkingEffort}`));
54+ if (opts.showReasoning) left.push(c.dim("🤔"));
5355 if (opts.provider && opts.provider !== "zen") left.push(c.dim(opts.provider));
5456 left.push(c.dim(opts.sessionId.slice(0, 8)));
5557 if (opts.ralphMode) left.push(c.magenta("↻ ralph"));
src/cli/stream-render.test.ts+29−0
@@ -65,6 +65,7 @@ describe("renderTurn", () => {
6565 outputTokens: 2,
6666 contextTokens: 3,
6767 newMessages: [],
68+ reasoningText: "",
6869 });
6970 });
7071
@@ -102,4 +103,32 @@ describe("renderTurn", () => {
102103 expect(hasAnsi(lines[1] ?? "", "[33m")).toBe(true);
103104 expect(hasAnsi(lines[2] ?? "", "[2m")).toBe(true);
104105 });
106+ test("can hide reasoning output while still accumulating reasoning text", async () => {
107+ captureStdout();
108+
109+ const result = await renderTurn(
110+ eventsFrom([
111+ { type: "reasoning-delta", delta: "step 1\nstep 2" },
112+ { type: "text-delta", delta: "final" },
113+ done(),
114+ ]),
115+ new Spinner(),
116+ { showReasoning: false },
117+ );
118+
119+ expect(strip(stdout)).toBe("◆ final\n");
120+ expect(result.reasoningText).toBe("step 1\nstep 2");
121+ });
122+
123+ test("renders reasoning output by default and accumulates it", async () => {
124+ captureStdout();
125+
126+ const result = await renderTurn(
127+ eventsFrom([{ type: "reasoning-delta", delta: "thinking" }, done()]),
128+ new Spinner(),
129+ );
130+
131+ expect(strip(stdout)).toBe("Thinking...\nthinking\n");
132+ expect(result.reasoningText).toBe("thinking");
133+ });
105134 });
src/cli/stream-render.ts+15−1
@@ -12,16 +12,20 @@ import { renderToolCall, renderToolResult } from "./tool-render.ts";
1212 export async function renderTurn(
1313 events: AsyncIterable<TurnEvent>,
1414 spinner: Spinner,
15+ opts?: { showReasoning?: boolean },
1516 ): Promise<{
1617 inputTokens: number;
1718 outputTokens: number;
1819 contextTokens: number;
1920 newMessages: CoreMessage[];
21+ reasoningText: string;
2022 }> {
23+ const showReasoning = opts?.showReasoning ?? true;
2124 let inText = false;
2225 let inReasoning = false;
2326 let rawBuffer = "";
2427 let accumulatedText = "";
28+ let accumulatedReasoning = "";
2529
2630 let inFence = false;
2731
@@ -84,6 +88,10 @@ export async function renderTurn(
8488 break;
8589 }
8690 case "reasoning-delta": {
91+ accumulatedReasoning += event.delta;
92+ if (!showReasoning) {
93+ break;
94+ }
8795 if (!inReasoning) {
8896 if (inText) {
8997 flushAnyText();
@@ -150,5 +158,11 @@ export async function renderTurn(
150158 }
151159 }
152160
153- return { inputTokens, outputTokens, contextTokens, newMessages };
161+ return {
162+ inputTokens,
163+ outputTokens,
164+ contextTokens,
165+ newMessages,
166+ reasoningText: accumulatedReasoning,
167+ };
154168 }
src/index.ts+3−0
@@ -24,6 +24,7 @@ import { autoDiscoverModel } from "./llm-api/providers.ts";
2424
2525 import {
2626 getPreferredModel,
27+ getPreferredShowReasoning,
2728 getPreferredThinkingEffort,
2829 } from "./session/db/index.ts";
2930 import { getMostRecentSession, printSessionList } from "./session/manager.ts";
@@ -297,6 +298,7 @@ async function main(): Promise<void> {
297298 model: modelOverride,
298299 cwd: runCwd,
299300 initialThinkingEffort: getPreferredThinkingEffort(),
301+ initialShowReasoning: getPreferredShowReasoning(),
300302 reporter: new HeadlessReporter(),
301303 initialPrompt: args.prompt ?? "",
302304 headless: true,
@@ -333,6 +335,7 @@ async function main(): Promise<void> {
333335 model,
334336 cwd: args.cwd,
335337 initialThinkingEffort: getPreferredThinkingEffort(),
338+ initialShowReasoning: getPreferredShowReasoning(),
336339 reporter: new CliReporter(),
337340 };
338341 if (sessionId) agentOpts.sessionId = sessionId;
src/session/db/settings-repo.ts+11−0
@@ -42,6 +42,17 @@ export function setPreferredThinkingEffort(
4242 setSetting("preferred_thinking_effort", effort);
4343 }
4444 }
45+
46+export function getPreferredShowReasoning(): boolean {
47+ const v = getSetting("preferred_show_reasoning");
48+ if (v === null) return true;
49+ return v !== "false";
50+}
51+
52+export function setPreferredShowReasoning(show: boolean): void {
53+ setSetting("preferred_show_reasoning", show ? "true" : "false");
54+}
55+
4556 export function getPreferredActiveAgent(): string | null {
4657 return getSetting("preferred_active_agent");
4758 }