fix(chat): show Claude's between-step notes as Thought rows (port upstream #11784) - #259

Problem

On Opus 5.5, Claude asked questions like "Given the comparison, how do you want to handle developer@?" without the comparison anywhere on screen. Opus 5.5 sends the notes it writes between tool calls as thinking blocks rather than text blocks (see the Opus 5.5 migration guide, "Text between tool calls is returned in thinking blocks"). The Claude adapter emitted them as reasoning_text, and ingestion dropped every content delta except assistant_text. The session log for the reported thread has the comparison as a thinking block right before the AskUserQuestion.

Fix

This ports upstream pingdotgg#11784 ("show provider thinking traces", by @maria-rcks), cherry-picked with -x and adapted to the fork:

• Contracts and server: a new reasoning message role and reasoning delta/complete commands. Ingestion turns reasoning deltas into reasoning messages and closes each block on tool start, visible text, assistant completion, item completion, and a pause for a question. Older clients that don't opt in get system rows instead (reasoningMessages).
• Claude: requests summarized thinking display (showThinkingSummaries, thinking.display: "summarized"), maps thinking deltas to reasoning_summary_text, and backfills thinking from assistant snapshots. Subagent thinking stays out of the parent transcript.
• Client: the thread snapshot cache is bumped to v4 so pre-thinking caches reload. The timeline shows a collapsed Thought row in the fork's row style. Thought rows fold with the turn's work once it settles, and a turn answered by thought alone keeps its row. Find opens a Thought row that holds a match.
• Thread titles ignore reasoning.

Adaptations, because the fork predates some upstream systems:

• Buffering: reasoning is always buffered and flushed when its block closes. The fork has no response streaming modes.
• Opt-in scope: the reasoningMessages opt-in rides on the existing thread reads. The fork has no pagination.
• Cursor and Grok: unchanged. The fork's ACP runtime emits no thought events.
• Skipped follow-ups: fix(server): Claude subagent threads show their thinking pingdotgg/t3code#13626 (orchestration-v2 subagent adapter) and fix(clients): stop stranded thinking after a steer pingdotgg/t3code#14546 (reasoning work-log rows). Both target systems the fork does not have.

Verification

• Tests:
  • vp test run on ProviderRuntimeIngestion.test.ts and ClaudeAdapter.test.ts: 143 passed. This includes a new test, "finalizes a Claude progress note when the turn pauses for a question".
  • MessagesTimeline.logic.test.ts: 46 passed.
  • The reasoning wire compatibility test in server.test.ts: passed.
  • parseChangelog.test.ts: passed.
• Typecheck: tsgo is clean on server, web, client-runtime and contracts. Mobile shows only its existing navigation-type errors, none in touched code.
• Desktop renderer pass on a dev server seeded with a VACUUM INTO copy of dev data, with a real Opus 5.5 turn (read two files, compare, ask a question):
  • Three Thought rows appeared in order between the tool calls, the last one directly above the question panel. It held the comparison the question referred to.
  • The rows survived a reload.
  • After answering, the turn folded under "Worked for 1m 32s". Expanding the fold showed the Thought rows again.

Follow-up noted in FUTURE_ENHANCEMENTS.md: open the latest note by default while a question is waiting.

🤖 Generated with Claude Code