Skip to content

A turn shows its answer in a prose frame on the rendered surface and its working as one strip above it; transcript.detail (quiet, tools, everything) and e open what quiet shuts; a failed call, an ask and what follows a budget stop are never shut; a curtain line says what runs

TUI decision 161 · accepted · 2026-10-12 · issue #474

Superseded in part

In part by 174.

One frame, six kinds. Prose, code, diff, tool, reasoning and data, each with the header grammar the design page writes down (┌─ elixir · lib/p.ex, diff · path +n −m, ✓ shell mix test · 1 test · 7s, thinking · 12s, csv · 4 rows; prose has none). A tool call's entry keeps the times its events carried (started_at, ended_at), and a reasoning entry how long the reasoning streamed, for the durations; a log replayed has no deltas and says thinking alone.

Reasoning reaches its frame. Reasoning is live only (TUI Decision 36): the fold keeps it when the message it came before lands. The link coalesces deltas per frame, and it joined a frame's reasoning and text into one delta that was reasoning only when all of it was, so a model that thought and began to answer within one frame — the scripted model always, a real one at the seam — had its reasoning streamed as its answer and never drawn as reasoning. Each run of reasoning and each run of text in a frame is now flushed as its own delta, in order.

The surface. The view paints one background, a frame's: the new surface role, the theme's bg.hover token, generated like every role (mix troupe.palette), drawn out to the column before the scrollbar's. Of the background tokens hover is the one that steps away from both a dark terminal's black and a light one's white in all four themes, and a terminal's own background is unknown; the desktop app's bg.sunken assumes a canvas the terminal does not have. With sixteen colours there is no honest step and with none no colour, so the role has no stand-in there and the frame's rail, ▎, carries it. The rail is drawn at every depth: a frame takes the same rows and columns whatever the terminal can colour, so scrolling, selecting and what is copied never depend on it, and copying drops it as it drops every rail. This is the one exception to TUI Decision 126's "the canvas is not painted": the canvas still is not. Nesting is one level: a fenced block inside prose is a frame of its own between rules on the prose's surface, never a second step.

Turns, and what quiet shuts. A transcript is read as turns: one starts at a person's line, a command they ran or a loop's iteration, and ends at the line that says what it cost. The turn's answer is its prose after its last call (a finish aside); its working is its reasoning, its calls and the prose between them. Quiet draws the working as one strip where it began — ▸ 7 steps · 1 failed · grep, read_file, edit_file · 14s — and the answer as a prose frame; tools opens the call frames under a ▾ strip and keeps reasoning to its header; everything collapses nothing. The prose between calls is working, not answer: a model that narrates each call would otherwise give a turn of thirty calls thirty strips, which is the scroll past thirty frames the issue is about. The cost line stays where TUI Decision 160 puts it, but is no longer taken out of the transcript before it is drawn: it ends a turn, so the pane draws it as nothing where the side box says it, and keeps the transcript whole.

The setting and the key. transcript.detail is a key on the config ladder (quiet, tools, everything; quiet by default), labelled for the settings page as a menu of the three, read with the theme and again on config.changed. /detail <level> sets this screen's own level for the session, outranking the setting until the session changes; nothing reaches the log or a file, and the history is drawn again from the fold. e opens the turn in view — the last while the pane follows the tail, otherwise the one at the top of the view, which stays where it is — as everything draws it, and closes it again; at everything it closes it to quiet. Per turn rather than the whole pane, because "one key opens the whole turn" is the issue's word, and opening thirty turns to read one is the flood quiet exists to stop. Not chosen: a click on the strip, which the desktop app does, and which the TUI's mouse handling could take later.

Never shut, at any level: a failed call, its frame open with its error; an approval or a question, drawn as before, whole, in the reserved colour and with no flourish; the cost line; and everything after a budget stop — the agent's transcript remembers where its first budget question or budget exhausted landed (open_from) and draws all after it as everything. A scratchpad document stays a card (TUI Decision 159). A frame body past 24 lines shows its first 20 and … n more lines, opened in place with its turn; the answer's prose is never cut, only a block inside it.

The curtain line. The activity line of TUI Decision 36 keeps every fact and gains a prefix in the pane: ◐ the actors are powdering their nose — thinking (00:12). The set is small and written in the design page and in Model's one table; the n-th time the window's own agent thinks, calls or compacts in a turn takes the n-th line of that list, and past its end the line is the facts alone, so nothing repeats in a turn, and each turn starts the lists again. Reads have their own list. The facts now say how many when several calls run (running 3 tools: …). No flourish when the window waits on a person, after a model error, or in a subagent's pane; and none outside the pane — a tile is a glance, and the headless printer, troupe bench and --json never drew this line at all.

Governs: clients/tui/lib/troupe/ui/tui/view.ex, clients/tui/lib/troupe/ui/tui/theme.ex, clients/tui/lib/troupe/ui/tui/model.ex