DeepSeek-Reasonix/internal/frontend/tui/render.go

package tui

import (
	"fmt"
	"strings"
	"time"

	"reasonix/internal/base/i18n"
	"reasonix/internal/base/textutil"
	"reasonix/internal/contract/event"
	"reasonix/internal/contract/eventwire"
	"reasonix/internal/contract/pricing"
	"reasonix/internal/frontend/termrender"
)

const (
	toolPreviewLines = 4
	diffPreviewLines = 24
)

// diffFoldLines is the fold limit new diffs are drawn with; /diff-fold sets it
// to 0, which shows every line.
var diffFoldLines = diffPreviewLines

// renderItem is a settled row as it goes into the scrollback. shown is how much
// of an answer's text an earlier print already carried.
func renderItem(it *Item, width, shown int, hideRail bool) string {
	switch it.Kind {
	case ItemUser:
		return renderUser(it, width)
	case ItemSay:
		// Thinking with nothing said after it is a step, not an answer: it gets
		// its marker and no speaker header.
		if strings.TrimSpace(it.Text) == "" {
			if !hasThought(it.Reasoning) {
				return ""
			}
			return "\n" + thought(it, width)
		}
		if shown >= len(it.Text) && shown > 0 {
			return ""
		}
		return withThought(it, shown, width, renderSayPart(it.Text[shown:], shown == 0, width, hideRail))
	case ItemTool:
		return renderTool(it, width)
	case ItemApproval:
		// An allowed call speaks for itself in the card that follows; only a
		// refusal leaves something the reader would otherwise not see.
		if it.Verdict != "deny" && it.Verdict != "revise_plan" && it.Verdict != "exit_plan" {
			return ""
		}
		return termrender.Dim("  ✗ " + fmt.Sprintf(i18n.M.TUIDeclinedFmt, it.Approval.Tool, oneLine(it.Approval.Subject, width-20)))
	case ItemAsk:
		prompt := i18n.M.TUIQuestion
		if len(it.Ask.Questions) > 0 {
			prompt = it.Ask.Questions[0].Prompt
		}
		return termrender.Dim("  ? " + oneLine(prompt, width/2) + " → " + oneLine(it.Verdict, width/2))
	case ItemNotice:
		return renderNotice(it)
	case ItemCompaction:
		return renderCompaction(it, width)
	case ItemReceipt:
		return renderReceipt(it.Receipt, width, it.ReceiptLine)
	case ItemUsage:
		return renderUsage(it.Usage, width)
	case ItemWorked:
		return termrender.Dim("  " + fmt.Sprintf(i18n.M.ChatWorkedForFmt, i18n.Elapsed(time.Duration(it.WorkedMs)*time.Millisecond)))
	}
	return ""
}

// renderUser draws the person's line and what came with it. A turn can carry
// no words and still be a turn — the record says so by its image count — so
// the attachment gets its own line rather than the row quietly disappearing.
// Via is only ever set on a restored turn, and says which paired device the
// line came from without touching the window's own rows.
func renderUser(it *Item, width int) string {
	mark := "› "
	if it.Steer {
		mark = "↳ "
	}
	var lines []string
	if strings.TrimSpace(it.Text) != "" {
		for r := range strings.SplitSeq(termrender.Hardwrap(strings.TrimRight(it.Text, "\n"), max(width-5, 10)), "\n") {
			lines = append(lines, "  "+termrender.Accent(mark+r))
			mark = "  "
		}
	}
	if it.Images > 0 {
		lines = append(lines, "  "+termrender.Dim(mark+fmt.Sprintf(i18n.M.ChatImageAttachedFmt, it.Images)))
	}
	if it.Via != nil {
		lines = append(lines, termrender.Dim("  "+fmt.Sprintf(i18n.M.ChatFromDeviceFmt, it.Via.Ordinal)))
	}
	if len(lines) == 0 {
		return ""
	}
	return "\n" + strings.Join(lines, "\n")
}

// renderSayPart renders a stretch of an answer. Only the first stretch carries
// the speaker's header; the rest continue under it. A stretch is cut after a
// blank line, so each later one starts a new block and gets that line back.
func renderSayPart(text string, first bool, width int, hideRail bool) string {
	if first {
		return "\n" + termrender.AssistantBlock(text, width, hideRail)
	}
	return "\n" + indent(strings.TrimRight(termrender.RenderMarkdown(text, max(width-2, 10), hideRail), "\n"), "  ")
}

// withThought puts the thinking marker above the first stretch of an answer.
func withThought(it *Item, shown, width int, out string) string {
	if shown > 0 || !hasThought(it.Reasoning) {
		return out
	}
	return "\n" + thought(it, width) + "\n" + out
}

// thought is the thinking marker, and the thinking itself once a full-screen
// row has been opened. The marker always sits on the row's second line.
func thought(it *Item, width int) string {
	mark := "▎"
	switch it.Fold {
	case foldShut:
		mark = "▸"
	case foldOpen, foldPinned:
		mark = "▾"
	}
	hint := ""
	if it.Fold == foldShut || it.Fold == foldOpen {
		hint = " (Ctrl+O)"
	}
	lines := []string{termrender.Dim("  " + mark + " " + fmt.Sprintf(i18n.M.ChatThoughtForFmt, (it.ThoughtMs+500)/1000) + hint)}
	if it.Fold == foldOpen || it.Fold == foldPinned {
		// Styled per row: the transcript is split into rows after rendering, and
		// one style spanning several would reach only the first of them.
		for l := range strings.SplitSeq(termrender.Cells().Wrap(strings.TrimSpace(it.Reasoning), max(width-6, 10), ""), "\n") {
			lines = append(lines, termrender.Dim("    "+l))
		}
	}
	return strings.Join(lines, "\n")
}

const (
	connector         = "  ⎿  "
	shellPreviewLines = 10
	shellExpandLines  = 200
)

func renderTool(it *Item, width int) string {
	t := it.Tool
	if t.Diff != "" {
		return "\n" + strings.Join(termrender.DiffBlock(t.Name, t.Args, event.FileDiff{Diff: t.Diff, Added: t.Added, Removed: t.Removed}, width, diffFoldLines), "\n")
	}
	lines := []string{termrender.ToolCard(t.Name, t.Args, width)}
	avail := width - len([]rune(connector))
	switch {
	case t.Err != "":
		lines = append(lines, termrender.Dim(connector)+termrender.Red(oneLine(t.Err, avail)))
	case it.Running:
		if last := lastLine(t.Output); last != "" {
			lines = append(lines, termrender.Dim(connector+oneLine(last, avail)))
		}
	case termrender.IsShellTool(t.Name):
		if t.OutputDiff {
			lines = append(lines, diffRows(it.shellOutput(), width, it.Fold)...)
		} else {
			lines = append(lines, outputSummary(t.Name, it.shellOutput(), avail, it.Fold)...)
		}
	default:
		if spec, ok := chartOf(it); ok {
			lines = append(lines, chartRows(spec, width, it.Fold)...)
		} else if t.OutputDiff {
			lines = append(lines, diffRows(t.Output, width, it.Fold)...)
		} else {
			lines = append(lines, outputSummary(t.Name, t.Output, avail, it.Fold)...)
		}
	}
	for _, v := range t.Videos {
		lines = append(lines, termrender.Dim(connector+fmt.Sprintf(i18n.M.TUIVideoSentFmt, v.Name, videoDetail(v), v.Model)))
	}
	if n := len(it.Children); n > 0 {
		lines = append(lines, termrender.Dim(connector+fmt.Sprintf(i18n.M.TUISubagentCallsFmt, n)))
	}
	return "\n" + strings.Join(lines, "\n")
}

// outputSummary leaves a marker of a finished call: a shell command's first
// lines, since what it printed is what the user ran it for, and a line count
// for any other tool, whose output the model already has.
func outputSummary(name, out string, width int, f outputFold) []string {
	out = strings.TrimRight(out, "\n")
	if out == "" {
		return nil
	}
	src := strings.Split(out, "\n")
	if !termrender.IsShellTool(name) {
		return []string{termrender.Dim(connector + fmt.Sprintf("%d lines", len(src)))}
	}
	limit := shellPreviewLines
	if f == foldOpen {
		limit = shellExpandLines
	}
	shown := src[:min(len(src), limit)]
	lines := make([]string, 0, len(shown)+1)
	for i, l := range shown {
		gutter := strings.Repeat(" ", len([]rune(connector)))
		if i == 0 {
			gutter = connector
		}
		lines = append(lines, termrender.Dim(gutter+oneLine(l, width)))
	}
	hint := ""
	if f != foldFixed {
		hint = " (Ctrl+B)"
	}
	if extra := len(src) - len(shown); extra > 0 {
		lines = append(lines, termrender.Dim(strings.Repeat(" ", len([]rune(connector)))+fmt.Sprintf("… %d more lines", extra)+hint))
	}
	return lines
}

// diffRows renders a marked whole-diff shell result as diff rows, opening the
// fold to show more of it. The rows carry the card's "⎿" connector on the first
// line and an aligned gutter after, matching every other tool card's body.
func diffRows(out string, width int, f outputFold) []string {
	maxLines := diffFoldLines
	if f == foldOpen {
		maxLines = shellExpandLines
	}
	// DiffText lays each row out to the width it is given, under a two-space
	// card indent; the connector below is three cells wider than that indent, so
	// the body is laid out three cells narrower and every row still fits.
	body := max(width-len([]rune(connector))+2, 1)
	rows := termrender.DiffText(out, body, maxLines)
	gutter := strings.Repeat(" ", len([]rune(connector)))
	for i, r := range rows {
		mark := gutter
		if i == 0 {
			mark = termrender.Dim(connector)
		}
		// DiffText rows carry a 2-space card indent; replace it with the
		// connector/gutter so the body aligns under the card header.
		rows[i] = mark + strings.TrimPrefix(r, "  ")
	}
	return rows
}

// renderUsage is what one model request cost, under a quiet rule: history,
// so it stays in the scrollback in a quieter voice than the footer.
func renderUsage(u *eventwire.Usage, width int) string {
	total := shortTokens(u.TotalTokens) + " tok"
	if u.Estimated {
		total = "≈" + total
	}
	groups := []string{total}
	if u.PromptTokens > 0 {
		fresh := u.CacheMissTokens
		if fresh == 0 {
			fresh = max(u.PromptTokens-u.CacheHitTokens, 0)
		}
		groups = append(groups, "in "+shortTokens(u.PromptTokens), "cached "+shortTokens(u.CacheHitTokens), "new "+shortTokens(fresh))
	}
	groups = append(groups, "out "+shortTokens(u.CompletionTokens))
	if u.ReasoningTokens > 0 {
		groups = append(groups, "reasoning "+shortTokens(u.ReasoningTokens))
	}
	if u.Cost > 0 {
		code := u.CurrencyCode
		if code == "" {
			code = u.Currency
		}
		groups = append(groups, fmt.Sprintf("≈%s%.4f", pricing.CurrencySymbol(code), u.Cost))
		if u.CostQuote != nil {
			if band := rateBandText(u.CostQuote.RateBand); band != "" {
				groups = append(groups, band)
			}
		}
	}
	if u.Estimated {
		groups = append(groups, "estimated")
	}
	for i, g := range groups {
		groups[i] = footerValue(g)
	}
	rule := footerIndent + termrender.ThemeFg(termrender.ActiveTheme().Border, strings.Repeat("─", max(width-1-len(footerIndent), 1)))
	return "\n" + rule + "\n" + footerIndent + footerLabel(i18n.M.ChatTurnReceiptLabel) + "  " + strings.Join(groups, footerLabel(" · "))
}

// renderCompaction is 1.x's card for a finished fold: what it folded, the
// digest it wrote, and the estimated size before and after. A fold that wrote
// no digest folded nothing, and the notice beside it says why.
func renderCompaction(it *Item, width int) string {
	c := it.Compaction
	if !it.Done {
		return termrender.Dim("  ⋯ " + i18n.M.CompactionWorking)
	}
	if c != nil && strings.TrimSpace(c.Summary) == "" && c.Trigger != "manual" {
		if why, ok := i18n.M.CompactionWhy[c.Code]; ok && c.Code != "" {
			return termrender.Dim("  ⊘ " + fmt.Sprintf(i18n.M.CompactionAbortedFmt, why))
		}
	}
	if c == nil || strings.TrimSpace(c.Summary) == "" {
		return ""
	}
	trigger := c.Trigger
	switch c.Trigger {
	case "auto":
		trigger = i18n.M.CompactionAuto
	case "manual":
		trigger = i18n.M.CompactionManual
	}
	lines := []string{termrender.Accent(fmt.Sprintf("◆ %s · %d %s · %s", i18n.M.CompactionTitle, c.Messages, i18n.M.CompactionUnit, trigger))}
	for ln := range strings.SplitSeq(strings.TrimRight(c.Summary, "\n"), "\n") {
		for row := range strings.SplitSeq(termrender.Cells().Wrap(ln, max(width-6, 10), ""), "\n") {
			lines = append(lines, termrender.Dim("  │ "+row))
		}
	}
	if c.SourceTokens > 0 || c.ProjectionTokens > 0 {
		lines = append(lines, termrender.Dim(fmt.Sprintf("  │ %s: ~%s → ~%s", i18n.M.CompactionEstimatedTokens,
			shortTokens(c.SourceTokens), shortTokens(c.ProjectionTokens))))
	}
	return "\n" + strings.Join(lines, "\n")
}

// codedNoticeText words a coded notice in the UI language from its typed payload; a
// code with no wording here, or a payload that does not decode, keeps the
// kernel's English.
const unappliedSteerCap = 400

func codedNoticeText(it *Item) string {
	switch it.Code {
	case event.NoticeCodeCompacted:
		return i18n.M.NoticeCompacted
	case event.NoticeCodeCompactDeclined:
		if why, ok := i18n.M.CompactionWhy[it.Detail]; ok {
			return fmt.Sprintf(i18n.M.NoticeCompactDeclinedFmt, why)
		}
	case event.NoticeCodeCompactFailed:
		if why, ok := i18n.M.CompactionWhy[it.Detail]; ok {
			return fmt.Sprintf(i18n.M.NoticeCompactFailedFmt, why)
		}
	case event.NoticeCodeCompactHeld:
		if why, ok := i18n.M.CompactionWhy[it.Detail]; ok {
			return fmt.Sprintf(i18n.M.NoticeCompactHeldFmt, why)
		}
	case event.NoticeCodeUnappliedSteer:
		if it.Detail != "" {
			return fmt.Sprintf(i18n.M.NoticeUnappliedSteerFmt, textutil.TruncateGraphemes(textutil.SanitizeDisplay(it.Detail), unappliedSteerCap, "…"))
		}
		return textutil.TruncateGraphemes(textutil.SanitizeDisplay(it.Text), unappliedSteerCap, "…")
	case event.NoticeCodeInboxRecovered:
		if p, ok := event.DecodeInboxRecovered(it.Detail); ok {
			return fmt.Sprintf(i18n.M.NoticeInboxRecoveredFmt, p.Count)
		}
	case event.NoticeCodeInboxUnrecovered:
		// The payload names the queue directory for a diagnostic, not for the
		// reader: the sentence is the same whatever it holds, and a Detail that
		// is not the payload keeps the kernel's own text.
		if _, ok := event.DecodeInboxUnrecovered(it.Detail); ok {
			return i18n.M.NoticeInboxUnrecovered
		}
	case event.NoticeCodeCompactionTelemetry:
		if text, ok := compactionNoticeText(it.Detail); ok {
			return text
		}
	case event.NoticeCodeJobStarted, event.NoticeCodeJobFinished, event.NoticeCodeJobKilled:
		if p, ok := event.DecodeJobNotice(it.Detail); ok {
			name := p.Label
			if name == "" {
				name = p.ID
			}
			switch it.Code {
			case event.NoticeCodeJobStarted:
				return fmt.Sprintf(i18n.M.NoticeJobStartedFmt, name)
			case event.NoticeCodeJobKilled:
				return fmt.Sprintf(i18n.M.NoticeJobKilledFmt, name)
			}
			return fmt.Sprintf(i18n.M.NoticeJobFinishedFmt, name)
		}
	case event.NoticeCodeJobFailed:
		if p, ok := event.DecodeJobNotice(it.Detail); ok {
			name := p.Label
			if name == "" {
				name = p.ID
			}
			return fmt.Sprintf(i18n.M.NoticeJobFailedFmt, name) + jobFailure(p)
		}
	case event.NoticeCodeExtensionSkipped:
		if p, ok := event.DecodeExtensionSkipped(it.Detail); ok && p.Reason == event.ExtensionSkipReasonNoLiveSidecar {
			return fmt.Sprintf(i18n.M.NoticeExtSkippedFmt, p.Extension, p.Point)
		}
	}
	return it.Text
}

// jobFailure words how a failed job's process ended from the typed fields,
// falling back to the job function's own error text when none were written.
func jobFailure(p event.JobNotice) string {
	switch {
	case p.Signal > 0:
		return ": " + fmt.Sprintf(i18n.M.NoticeJobSignalFmt, p.Signal)
	case p.ExitCode != nil:
		return ": " + fmt.Sprintf(i18n.M.NoticeJobExitFmt, *p.ExitCode)
	}
	return jobError(p.Error)
}

func jobError(msg string) string {
	if msg == "" {
		return ""
	}
	return ": " + textutil.TruncateGraphemes(textutil.SanitizeDisplay(msg), unappliedSteerCap, "…")
}

func renderNotice(it *Item) string {
	mark := termrender.Dim("  · ")
	switch it.Level {
	case "error":
		mark = termrender.Red("  ✗ ")
	case "warn", "warning":
		mark = termrender.Yellow("  ! ")
	}
	text := codedNoticeText(it)
	if it.Count > 1 {
		text += termrender.Dim(fmt.Sprintf(" (×%d)", it.Count))
	}
	if it.Code == event.NoticeCodeContextReport && it.Detail != "" {
		text += "\n" + indent(strings.TrimRight(it.Detail, "\n"), "    ")
	}
	return mark + text
}

// oneLine fits s on one row of width cells: a wide rune takes two, so the cut
// is measured on screen rather than in runes.
func oneLine(s string, width int) string {
	s = strings.TrimSpace(strings.ReplaceAll(s, "\n", " "))
	if width > 1 && termrender.VisibleWidth(s) > width {
		return termrender.Truncate(s, width, "…")
	}
	return s
}

func lastLine(s string) string {
	s = strings.TrimRight(s, "\n")
	if i := strings.LastIndexByte(s, '\n'); i >= 0 {
		return s[i+1:]
	}
	return s
}

func indent(block, prefix string) string {
	lines := strings.Split(block, "\n")
	for i, l := range lines {
		if l != "" {
			lines[i] = prefix + l
		}
	}
	return strings.Join(lines, "\n")
}

// hasThought is false for reasoning that carries no text: a block of only
// whitespace has nothing to fold, so it earns no "thought for 0s" marker.
func hasThought(reasoning string) bool { return strings.TrimSpace(reasoning) != "" }

// videoDetail is a video's size and, when the container said it, its length.
func videoDetail(v eventwire.VideoShown) string {
	detail := textutil.HumanBytes(v.Size)
	if v.DurationMs > 0 {
		detail += fmt.Sprintf(" · %.1fs", float64(v.DurationMs)/1000)
	}
	return detail
}

// compactionNoticeText words a finished fold from its typed payload, or reports
// false for a Detail that is not one so the kernel's own text stays.
func compactionNoticeText(detail string) (string, bool) {
	p, ok := event.DecodeCompactionNotice(detail)
	if !ok {
		return "", false
	}
	how := p.Mode
	switch p.Mode {
	case "summarized":
		how = i18n.M.CompactionHowSummarized
	case "degraded":
		how = i18n.M.CompactionHowDegraded
	case "archived":
		how = i18n.M.CompactionHowArchived
	}
	return fmt.Sprintf(i18n.M.NoticeCompactionFmt, how, p.SourceTokens, p.ProjectionTokens), true
}