fix(cli): render oversized live tool results by byte size

With content now riding live tool_result frames, a result that exceeds
the 48 KB live budget arrives as an empty placeholder plus contentBytes.
Render the truthful byte count in the compact row (instead of the
'(no output)' lie) and a dim note in the expanded card; the terminal
reconcile still heals the full body from the durable transcript at turn
end, clearing the placeholder.

Generated-by: Maka (Kimi K3)

Author: Astro-Han

packages/cli/src/__tests__/pi-transcript.test.ts

@@ -302,6 +302,88 @@ describe('Maka Pi TUI transcript', () => {
     assert.equal(state.entries.at(-1)?.kind, 'notice');
   });
 
+  test('shows the byte size of an oversized live tool result instead of no output', () => {
+    const state = createMakaPiTranscriptState();
+    applyMakaSessionEventToTranscript(
+      state,
+      event({
+        type: 'tool_start',
+        toolUseId: 'big-1',
+        toolName: 'Bash',
+        args: { command: 'npm test' },
+      }),
+    );
+    applyMakaSessionEventToTranscript(
+      state,
+      event({
+        type: 'tool_result',
+        toolUseId: 'big-1',
+        isError: false,
+        durationMs: 2500,
+        content: { kind: 'text', text: '' },
+        contentBytes: 100_000,
+      }),
+    );
+
+    const compact = renderMakaPiTranscript(state, meta(), 80).map(stripAnsi).join('\n');
+    assert.match(compact, /100000 bytes/);
+    assert.doesNotMatch(compact, /no output/);
+
+    assert.equal(toggleAllToolExpansion(state), true);
+    const expanded = renderMakaPiTranscript(state, meta(), 80).map(stripAnsi).join('\n');
+    assert.match(expanded, /too large to show live: 100000 bytes/);
+  });
+
+  test('the terminal reconcile replaces an oversized placeholder with the durable content', () => {
+    const state = createMakaPiTranscriptState();
+    applyMakaSessionEventToTranscript(
+      state,
+      event({
+        type: 'tool_start',
+        toolUseId: 'big-1',
+        toolName: 'Bash',
+        args: { command: 'npm test' },
+      }),
+    );
+    applyMakaSessionEventToTranscript(
+      state,
+      event({
+        type: 'tool_result',
+        toolUseId: 'big-1',
+        isError: false,
+        content: { kind: 'text', text: '' },
+        contentBytes: 100_000,
+      }),
+    );
+
+    assert.equal(
+      reconcileToolsWithStoredMessages(state, 'turn-1', [
+        {
+          type: 'tool_call',
+          id: 'big-1',
+          turnId: 'turn-1',
+          ts: 1,
+          toolName: 'Bash',
+          args: { command: 'npm test' },
+        },
+        {
+          type: 'tool_result',
+          id: 'big-1-result',
+          turnId: 'turn-1',
+          ts: 2,
+          toolUseId: 'big-1',
+          isError: false,
+          content: { kind: 'text', text: 'all 3 suites passed' },
+        },
+      ]),
+      true,
+    );
+
+    const row = renderMakaPiTranscript(state, meta(), 80).map(stripAnsi).join('\n');
+    assert.match(row, /all 3 suites passed|1 line · 19 bytes/);
+    assert.doesNotMatch(row, /100000 bytes/);
+  });
+
   test('removes a live poll card that the durable transcript folds into its Bash parent', () => {
     const state = createMakaPiTranscriptState();
     for (const tool of [

packages/cli/src/pi-transcript-tools.ts

@@ -193,7 +193,15 @@ function renderExpandedToolBlock(entry: MakaPiToolEntry, width: number): string[
     }
     lines.push(...renderToolStreams(entry.outputDeltas.values(), width));
   }
-  if (entry.result || entry.output) {
+  if (entry.resultBytes !== undefined && !plainResultText(entry)) {
+    lines.push(
+      ...renderIndented(
+        ansi.dim(`Result too large to show live: ${entry.resultBytes} bytes`),
+        width,
+        2,
+      ),
+    );
+  } else if (entry.result || entry.output) {
     lines.push(...renderToolResult(entry, width));
   }
   if (
@@ -258,6 +266,11 @@ function pipeOutputLineCount(output: { stdout?: string; stderr?: string }): numb
 
 function compactToolSummary(entry: MakaPiToolEntry): CompactToolSummary | undefined {
   const result = entry.result;
+  // An oversized live result carried only its byte size (#3521): show the
+  // truthful size rather than the empty placeholder's `no output`.
+  if (entry.resultBytes !== undefined && !plainResultText(entry)) {
+    return { text: `${entry.resultBytes} bytes`, protect: true };
+  }
   if (result?.kind === 'shell_run') {
     if (entry.toolName === 'WriteStdin') {
       return { text: formatPtyControlOperation(result.operation, entry.input) };

packages/cli/src/pi-transcript.ts

@@ -182,6 +182,12 @@ export type MakaPiTranscriptEntry =
       output?: string;
       /** In-memory revision for render-cache invalidation when a result is replaced. */
       resultVersion: number;
+      /**
+       * Serialized size of a settled result whose content exceeded the live
+       * frame budget and was omitted (#3521). Cleared when real content lands
+       * (live or via the terminal reconcile).
+       */
+      resultBytes?: number;
       progress: BoundedChunkBuffer<string>;
       outputDeltas: BoundedChunkBuffer<MakaPiToolOutputDelta>;
       durationMs?: number;
@@ -406,6 +412,7 @@ export function reconcileToolsWithStoredMessages(
     entry.input = structuredClone(durable.input);
     entry.result = durable.result ? structuredClone(durable.result) : undefined;
     entry.output = durable.output;
+    delete entry.resultBytes;
     entry.durationMs = durable.durationMs;
     entry.status = durable.status;
     entry.hidden = durable.hidden;
@@ -634,6 +641,7 @@ export function applyMakaSessionEventToTranscript(
           result: event.content,
           output: formatToolResultContent(event.content),
           resultVersion: 1,
+          ...(event.contentBytes === undefined ? {} : { resultBytes: event.contentBytes }),
           durationMs: event.durationMs,
           status: event.isError ? 'error' : 'done',
           expanded: state.expandAllTools,
@@ -681,6 +689,8 @@ export function applyMakaSessionEventToTranscript(
           tool.status = toolResultTranscriptStatus(event.content, event.isError);
           tool.result = event.content;
           tool.output = formatToolResultContent(event.content);
+          if (event.contentBytes === undefined) delete tool.resultBytes;
+          else tool.resultBytes = event.contentBytes;
           tool.durationMs = event.durationMs;
           tool.resultVersion += 1;
         }
@@ -696,6 +706,7 @@ export function applyMakaSessionEventToTranscript(
           result: event.content,
           output: formatToolResultContent(event.content),
           resultVersion: 1,
+          ...(event.contentBytes === undefined ? {} : { resultBytes: event.contentBytes }),
           durationMs: event.durationMs,
           status: toolResultTranscriptStatus(event.content, event.isError),
           expanded: state.expandAllTools,