@toddzheng024/dscode-bundle 0.7.11 → 0.7.13

package/vendor/tui/lib/render/status.mjs

@@ -0,0 +1,591 @@
+/**
+ * Status-bar composition for the TUI footer. Codex/Claude-Code-style split
+ * line: identity facts and session figures flow from the left, while the
+ * permission badge (the Codex "autonomous selection" anchor, with its
+ * shift+tab cycle hint) pins to the right edge. Every segment carries a tone
+ * the footer maps to a theme color, and layoutStatusBar degrades the line
+ * item by item so it always fits one physical row — truncation with an
+ * ellipsis happens only after every lesser group has already dropped out.
+ *
+ * @module @deepseek-ai/dsh-tui/render/status
+ */
+import { visibleColumns } from './markdown.mjs';
+import { billedInputTokens } from './usage.mjs';
+import { singleLineText, truncateColumns, formatTokens } from './text.mjs';
+// Re-exported for the callers that have always read the formatter here.
+export { formatTokens };
+import { t } from '../i18n.mjs';
+/**
+ * Compact duration: 45.2s under a minute, 2m42s from there on.
+ * @param ms - duration in milliseconds.
+ * @returns display string.
+ */
+export function formatDuration(ms) {
+    const s = ms / 1_000;
+    if (s < 60)
+        return String(Math.round(s * 10) / 10) + 's';
+    const whole = Math.round(s);
+    return Math.floor(whole / 60) + 'm' + (whole % 60) + 's';
+}
+/**
+ * Compact decode rate: one decimal under a hundred, whole below a thousand,
+ * then thousands (15.3 / 124 / 1.2K).
+ * @param n - tokens per second.
+ * @returns display string.
+ */
+function formatRate(n) {
+    if (n < 100)
+        return String(Math.round(n * 10) / 10);
+    if (n < 1_000)
+        return String(Math.round(n));
+    return String(Math.round(n / 100) / 10) + 'K';
+}
+/**
+ * Cache-hit share of billed prompt-side input. The denominator is the same
+ * billed total the /usage panel shows (uncached input plus both cache
+ * buckets), so the two readouts can never disagree.
+ * @param usage - cumulative token totals.
+ * @returns percent rounded to one decimal place, or null when no input was billed.
+ */
+export function cacheHitPercent(usage) {
+    const billed = billedInputTokens(usage);
+    return billed === 0
+        ? null
+        : Math.round(usage.cacheReadTokens / billed * 1_000) / 10;
+}
+/** Separator between leading clusters. */
+export const STATUS_GROUP_SEPARATOR = ' ｜ ';
+/** Separator between trailing state spans. */
+export const STATUS_ITEM_SEPARATOR = ' ｜ ';
+/** The Codex-style mode cycle hint appended to the permission badge. */
+/** English compatibility value for callers that only measure the default layout. */
+export const STATUS_CYCLE_HINT = ' (shift+tab to cycle)';
+/** Localized mode-cycle hint used by the live layout. */
+export function statusCycleHint() {
+    return ` ${t('status.cycleHint')}`;
+}
+/**
+ * Interior columns of the context bar. The layout starts every bar at this
+ * width so the drop ladder can pre-measure the group, then degrades the
+ * readout and shrinks the bar inside a tighter budget before dropping the
+ * group (see CONTEXT_MIN_WIDTH) rather than asking the layout for more room.
+ */
+export const CONTEXT_BAR_WIDTH = 24;
+/** Occupancy at which the usage readout flips from brand blue to amber. */
+const CONTEXT_WARN_PERCENT = 90;
+/**
+ * Narrowest bar width the drop ladder keeps before dropping the whole
+ * context group: the bar shrinks to this floor first (the absolute readout
+ * survives), and only past it does the readout degrade and the group go.
+ */
+const CONTEXT_MIN_WIDTH = 5;
+/**
+ * Render context occupancy as ONE stepless proportional bar: a solid
+ * DeepSeek-blue fill run tracking the occupancy and a dim dotted free
+ * track for the rest. Nothing else lives inside the bar — the usage
+ * readout rides outside it (see contextGroupSpans) — so the geometry
+ * always reads as the true remaining share. A given occupancy always
+ * renders the identical bar.
+ * @param usedTokens - reported used tokens.
+ * @param contextWindow - route capacity.
+ * @param width - total bar columns.
+ * @returns tone-split spans for the footer to paint.
+ */
+export function contextBar(usedTokens, contextWindow, width) {
+    if (width <= 0 || contextWindow <= 0)
+        return [];
+    const used = Math.max(0, usedTokens);
+    const fill = Math.min(width, Math.max(0, Math.round(used / contextWindow * width)));
+    const spans = [];
+    if (fill > 0)
+        spans.push({ text: '█'.repeat(fill), tone: 'ctxFill' });
+    const free = width - fill;
+    if (free > 0)
+        spans.push({ text: '░'.repeat(free), tone: 'label' });
+    return spans;
+}
+/**
+ * Compose the context group: the proportional bar plus the usage readout
+ * OUTSIDE the bar, so the dotted track keeps its proportional meaning no
+ * matter how wide the readout is. `full` reads `12.3K/1.0M 25%`; `percent`
+ * drops the absolute pair; `none` is the bare bar. The readout turns amber
+ * once occupancy reaches the warning threshold.
+ */
+export function contextGroupSpans(usedTokens, contextWindow, barWidth, readout) {
+    const spans = [{ text: t('status.label.context') + ' ', tone: 'label' }];
+    spans.push(...contextBar(usedTokens, contextWindow, barWidth));
+    if (readout === 'none' || barWidth <= 0 || contextWindow <= 0)
+        return spans;
+    const used = Math.max(0, usedTokens);
+    const percent = Math.round(used / contextWindow * 100);
+    const text = readout === 'full'
+        ? `${formatTokens(used)}/${formatTokens(contextWindow)} ${percent}%`
+        : `${percent}%`;
+    spans.push({ text: ' ', tone: 'label' }, { text, tone: percent >= CONTEXT_WARN_PERCENT ? 'warn' : 'value' });
+    return spans;
+}
+/** The full item catalog in canonical order (the /statusline default). */
+export const STATUS_ITEMS = [
+    { id: 'model', label: 'model', description: 'provider/model serving this session', side: 'left' },
+    { id: 'cwd', label: 'cwd', description: 'working-directory basename', side: 'left' },
+    { id: 'mode', label: 'mode', description: 'agent preset composing the session', side: 'left' },
+    { id: 'branch', label: 'branch', description: 'git branch inside a repository', side: 'left' },
+    { id: 'context', label: 'context', description: 'context-window occupancy meter', side: 'left' },
+    { id: 'permission', label: 'permission', description: 'permission preset badge with cycle hint', side: 'right' },
+    { id: 'plan', label: 'plan', description: 'plan-mode state mark', side: 'left' },
+    { id: 'turns', label: 'turns', description: 'turn and step counters', side: 'left' },
+    { id: 'durations', label: 'durations', description: 'llm/ttft/decode/tool wall time', side: 'left' },
+    { id: 'cache', label: 'cache', description: 'cache-hit share of billed input', side: 'left' },
+    { id: 'tokens', label: 'tokens', description: 'cumulative input/output tokens', side: 'left' },
+    { id: 'title', label: 'title', description: 'session title or short id', side: 'left' },
+    { id: 'goal', label: 'goal', description: 'live goal phase and round progress', side: 'left' },
+    { id: 'sandbox', label: 'sandbox', description: 'divergent sandbox-mode override', side: 'left' },
+];
+/**
+ * Default order: the whole catalog (matches the pre-customization bar).
+ * The busy dot is not an item — it always leads the identity cluster.
+ */
+export const DEFAULT_STATUSLINE_ITEMS = ['model', 'permission', 'title', 'plan', 'goal', 'sandbox'];
+/**
+ * Parse a persisted statusline item list. The stored value is the ordered
+ * set of ENABLED items (the Codex /statusline contract): unknown ids and
+ * duplicates drop out, and a non-array value (missing or corrupt file)
+ * falls back to the full default set. An explicitly empty array is valid —
+ * the bar degrades to its busy dot alone.
+ * @param value - the raw parsed JSON value (expected string[]).
+ * @returns the normalized ordered item list.
+ */
+export function parseStatuslineItems(value) {
+    if (!Array.isArray(value))
+        return [...DEFAULT_STATUSLINE_ITEMS];
+    const known = new Set(STATUS_ITEMS.map(item => item.id));
+    const kept = [];
+    for (const entry of value) {
+        if (typeof entry === 'string' && known.has(entry) && !kept.includes(entry)) {
+            kept.push(entry);
+        }
+    }
+    return kept;
+}
+/** Minimum blank gap kept between the leading and trailing sides. */
+const LEFT_RIGHT_GAP = 2;
+/** Column held back so Ink/yoga measurement drift can never force a wrap. */
+const WIDTH_SAFETY = 1;
+/**
+ * Extra left padding on the secondary row so its content aligns with the
+ * model name's left edge on the primary row (padding 2 + busy dot 2). The
+ * layout subtracts it from row 2's budget so the indent can never wrap it.
+ */
+export const STATUS_ROW2_INDENT = 2;
+/** Column budget for the session title before it ellipsizes. */
+const TITLE_BUDGET = 48;
+/**
+ * Primary-row drop ranks: context drops before permission; the identity
+ * cluster never drops and ellipsizes only after the right badge is gone.
+ * Secondary-row groups reuse the remaining ranks independently.
+ */
+const RANK_TITLE = 10;
+const RANK_TOKENS = 50;
+const RANK_COUNTS = 90;
+const RANK_CONTEXT = 90;
+const RANK_SANDBOX = 92;
+const RANK_GOAL = 95;
+const RANK_BADGE = 100;
+const RANK_IDENTITY = Number.POSITIVE_INFINITY;
+/** Row 2 drop ranks: title and durations go first; state and counts survive longest. */
+const RANK2_DURATIONS = 40;
+const RANK2_CACHE = 50;
+const RANK2_PLAN = 70;
+/**
+ * Traffic-light tone for a permission preset: read-only stays success green,
+ * full access reads error red, and every workspace-scoped middle ground
+ * (including unknown presets) reads warning amber.
+ * @param permission - active permission preset label.
+ * @returns tone for the badge span.
+ */
+export function permissionTone(permission) {
+    const label = permission.toLowerCase();
+    if (label.includes('read'))
+        return 'success';
+    if (label.includes('danger') || label.includes('full'))
+        return 'error';
+    return 'warn';
+}
+/** Display-safe external text: one row, controls escaped. */
+function safe(text) {
+    return singleLineText(text);
+}
+/** Dim junction separator span inside a cluster. */
+function sep() {
+    return { text: ' ｜ ', tone: 'label' };
+}
+/** Total visible columns of a span list (separators ride inside the spans). */
+function spansWidth(spans) {
+    let width = 0;
+    for (const span of spans)
+        width += visibleColumns(span.text);
+    return width;
+}
+/** Join widths of parts with one fixed separator between neighbors. */
+function joinWidth(parts, separator) {
+    if (parts.length === 0)
+        return 0;
+    let width = 0;
+    for (const part of parts)
+        width += part;
+    return width + separator * (parts.length - 1);
+}
+/** Build every candidate group/span with its drop rank and item id. */
+/** dscode: the footer telemetry header — `provider: model @ effort`. */
+export function dscodeFooterHeader(facts, stats) {
+    const raw = typeof facts.model === 'string' ? facts.model : '';
+    if (raw === '')
+        return '';
+    const cut = raw.indexOf('/');
+    const provider = cut > 0 ? raw.slice(0, cut) : '';
+    const model = cut > 0 ? raw.slice(cut + 1) : raw;
+    const effort = typeof facts.effort === 'string' && facts.effort !== '' ? facts.effort : (typeof stats.reasoningEffort === 'string' ? stats.reasoningEffort : '');
+    return (provider === '' ? model : provider + ': ' + model) + (effort === '' ? '' : ' @ ' + effort);
+}
+/** dscode: row 1's identity lead — the session title, else the model and its effort. */
+function dscodeStatusLead(facts, model, effort) {
+    const source = facts.title !== undefined && facts.title !== '' ? facts.title : facts.sessionId;
+    const title = source === undefined || source === '' ? '' : truncateColumns(safe(source), TITLE_BUDGET);
+    if (title !== '')
+        return title;
+    return effort === '' ? model : model + ' ｜ ' + effort;
+}
+function buildCandidates(facts, stats, busy, enabled, contextWidth) {
+    const identity = [
+        { text: busy ? '● ' : '○ ', tone: busy ? 'live' : 'meta' },
+    ];
+    // The dot glues straight to the first fact; further facts join through
+    // explicit dim separators, so an absent model never strands a leading ' · '.
+    const push = (span) => {
+        if (identity.length > 1)
+            identity.push(sep());
+        identity.push(span);
+    };
+    const model = safe(facts.model).split('/').at(-1) ?? '';
+    // dscode: row 1 leads with the session title (falling back to the model), and the
+    // full `provider: model @ effort` header rides the telemetry segment instead.
+    if ((model !== '' && enabled.has('model')) || enabled.has('title')) {
+        const effort = safe(facts.effort ?? stats.reasoningEffort);
+        push({ text: dscodeStatusLead(facts, model, effort), tone: 'model' });
+    }
+    const cwd = safe(facts.cwd);
+    if (cwd !== '' && enabled.has('cwd'))
+        push({ text: cwd, tone: 'path' });
+    const mode = safe(facts.mode ?? '');
+    if (mode !== '' && enabled.has('mode')) {
+        push({ text: t('status.label.mode') + ' ', tone: 'label' });
+        identity.push({ text: mode, tone: 'accent' });
+    }
+    const branch = safe(facts.branch);
+    if (branch !== '' && enabled.has('branch'))
+        push({ text: '⑂ ' + branch, tone: 'branch' });
+    const left = [
+        { group: { spans: identity }, rank: RANK_IDENTITY, id: 'identity' },
+    ];
+    const right = [];
+    const row2 = [];
+    if (stats.turns > 0 || stats.steps > 0) {
+        if (enabled.has('turns')) {
+            // Label/value pairs join through explicit dim separators.
+            const counts = [];
+            const pair = (label, value) => {
+                if (counts.length > 0)
+                    counts.push(sep());
+                counts.push({ text: label + ' ', tone: 'label' }, { text: value, tone: 'value' });
+            };
+            pair(t('status.label.turns'), String(stats.turns));
+            pair(t('status.label.steps'), String(stats.steps));
+            row2.push({ group: { spans: counts }, rank: RANK_COUNTS, id: 'turns' });
+        }
+        if (enabled.has('durations')) {
+            // Model round-trip, first-token latency, decode rate, and tool wall
+            // time; the label keeps its one trailing space so each reads as one
+            // figure ('model 45.2s'). Named in full — no single-letter codes.
+            const durations = [];
+            const pair = (label, value) => {
+                if (durations.length > 0)
+                    durations.push(sep());
+                durations.push({ text: label + ' ', tone: 'label' }, { text: value, tone: 'value' });
+            };
+            if (stats.llmMs > 0)
+                pair(t('status.label.modelTime'), formatDuration(stats.llmMs));
+            if (stats.ttftSteps > 0)
+                pair(t('status.label.latency'), formatDuration(stats.ttftMs / stats.ttftSteps));
+            if (stats.decodeMs > 0 && stats.decodeTokens > 0) {
+                if (durations.length > 0)
+                    durations.push(sep());
+                durations.push({ text: formatRate(stats.decodeTokens / (stats.decodeMs / 1_000)), tone: 'value' }, { text: t('status.label.tokensPerSec'), tone: 'label' });
+            }
+            if (stats.toolMs > 0)
+                pair(t('status.label.tool'), formatDuration(stats.toolMs));
+            if (durations.length > 0) {
+                row2.push({ group: { spans: durations }, rank: RANK2_DURATIONS, id: 'durations' });
+            }
+        }
+    }
+    // The cache group carries both facts about cached prompt tokens: how many
+    // were read and what share of the billed prompt that was. The read count
+    // lives here rather than in the tokens group so the tokens group keeps
+    // meaning "what the provider billed outside the cache".
+    const cacheHit = cacheHitPercent(stats.usage);
+    if (cacheHit !== null && enabled.has('cache')) {
+        const spans = [{ text: t('status.label.cache') + ' ', tone: 'label' }];
+        if (stats.usage.cacheReadTokens > 0) {
+            spans.push({ text: formatTokens(stats.usage.cacheReadTokens), tone: 'value' }, sep());
+        }
+        spans.push({ text: cacheHit + '%', tone: 'value' });
+        row2.push({ group: { spans }, rank: RANK2_CACHE, id: 'cache' });
+    }
+    // Context occupancy as a purely proportional bar with the usage readout
+    // riding outside it: the used total is the most recent reported prompt
+    // size against the advertised route capacity.
+    if (stats.contextWindow > 0 && stats.lastPromptTokens > 0 && enabled.has('context')) {
+        left.push({
+            group: {
+                spans: contextGroupSpans(stats.lastPromptTokens, stats.contextWindow, contextWidth, 'full'),
+            },
+            rank: RANK_CONTEXT,
+            id: 'context',
+        });
+    }
+    if ((stats.usage.uncachedInputTokens > 0 || stats.usage.outputTokens > 0) && enabled.has('tokens')) {
+        const tokens = [];
+        const pair = (label, value) => {
+            if (tokens.length > 0)
+                tokens.push(sep());
+            tokens.push({ text: label + ' ', tone: 'label' }, { text: value, tone: 'value' });
+        };
+        pair(t('status.label.in'), formatTokens(stats.usage.uncachedInputTokens));
+        pair(t('status.label.out'), formatTokens(stats.usage.outputTokens));
+        row2.push({ group: { spans: tokens }, rank: RANK_TOKENS, id: 'tokens' });
+    }
+    // dscode: the session title moved to row 1's identity lead (dscodeStatusLead),
+    // so row 2 no longer carries it.
+    // Secondary state rides row 2; permission alone remains right-pinned on row 1.
+    if (facts.goal !== undefined && enabled.has('goal')) {
+        row2.push({
+            group: {
+                spans: [{
+                        text: facts.goal.phase === 'active'
+                            ? '◎ round ' + facts.goal.rounds + '/' + facts.goal.max
+                            : '◎ ' + safe(facts.goal.phase),
+                        tone: 'accent',
+                    }],
+            },
+            rank: RANK_GOAL,
+            id: 'goal',
+        });
+    }
+    // The sandbox override stays implicit when it merely echoes the preset.
+    const sandbox = safe(facts.sandbox ?? '');
+    if (sandbox !== '' && sandbox.toLowerCase() !== facts.permission.toLowerCase() && enabled.has('sandbox')) {
+        row2.push({ group: { spans: [{ text: 'sandbox ' + sandbox, tone: 'warn' }] }, rank: RANK_SANDBOX, id: 'sandbox' });
+    }
+    const permission = safe(facts.permission);
+    let badge = -1;
+    // The plan STATION names itself in the permission badge: with the most
+    // restrictive preset active, plan mode reads as the green fourth cycle
+    // station 'plan' (that preset IS the station's permission layer). Plan on
+    // any other preset (a typed /plan mid-session) stays orthogonal: the badge
+    // keeps naming the preset and row 2 carries the green plan marker.
+    const planStation = facts.plan && permissionTone(permission) === 'success';
+    // dscode: the permission badge rides row 1 beside the title rather than
+    // right-pinning itself on the identity row.
+    if (permission !== '' && enabled.has('permission')) {
+        left.push({
+            group: {
+                spans: planStation
+                    ? [{ text: 'plan on', tone: 'plan' }]
+                    : [{ text: permission, tone: permissionTone(permission) }],
+            },
+            rank: RANK_BADGE,
+            id: 'permission',
+        });
+        badge = left.length - 1;
+    }
+    if (facts.plan && enabled.has('plan')) {
+        row2.push({ group: { spans: [{ text: '⧉ plan', tone: 'accent' }] }, rank: RANK2_PLAN, id: 'plan' });
+    }
+    return { left, right, badge, row2 };
+}
+/**
+ * Compose the two-row footer layout under a column budget. Row 1 keeps model,
+ * cwd, mode, branch, context, then the right-pinned permission badge and cycle
+ * hint. It drops hint, context, and permission before ellipsizing identity.
+ * Row 2 fits all secondary figures and state within its own budget.
+ * @param facts - identity facts resolved by the runner.
+ * @param stats - session figures folded from the durable log.
+ * @param columns - usable columns for each row (before their left padding).
+ * @param options - 'busy' hides the cycle hint while a turn runs (Codex
+ * keeps mode hints idle-only); 'items' is the ordered enabled-item config
+ * from /statusline (defaults to the full catalog). Display order follows the
+ * config per side while the drop ladder keeps its fixed ranks.
+ * @returns the two rows to render; row1.left is never empty.
+ */
+export function layoutStatusBar(facts, stats, columns, options = {}) {
+    const busy = options.busy === true;
+    const items = options.items ?? DEFAULT_STATUSLINE_ITEMS;
+    const enabled = new Set(items);
+    const budget = Math.max(1, Math.floor(columns) - WIDTH_SAFETY);
+    // The context meter shares the same measured width as the composer. Its
+    // initial width is a ceiling only; the drop ladder below shrinks it around
+    // the other status groups before dropping any group.
+    const maxContextWidth = Math.max(CONTEXT_MIN_WIDTH, Math.min(budget, Math.floor(options.contextWidth ?? CONTEXT_BAR_WIDTH)));
+    const { left, right, badge, row2 } = buildCandidates(facts, stats, busy, enabled, maxContextWidth);
+    const groupSeparator = visibleColumns(STATUS_GROUP_SEPARATOR);
+    const itemSeparator = visibleColumns(STATUS_ITEM_SEPARATOR);
+    // Display order follows the config per side (Codex /statusline reorder).
+    // The identity cluster stays anchored first — it owns the busy dot.
+    const position = new Map(items.map((id, index) => [id, index]));
+    const byPosition = (a, b) => (position.get(a.id) ?? Number.MAX_SAFE_INTEGER) - (position.get(b.id) ?? Number.MAX_SAFE_INTEGER);
+    const orderedLeft = [left[0], ...left.slice(1).sort(byPosition)];
+    const orderedRight = right.slice().sort(byPosition);
+    const orderedRow2 = row2.slice().sort(byPosition);
+    let hint = badge >= 0 && !busy;
+    const leftKept = [...orderedLeft];
+    const rightKept = [...orderedRight];
+    // Context degradation state: the readout drops its absolute pair first,
+    // then the bar shrinks inside its own budget, and only then is the whole
+    // group removed — the proportional meter outlives the auxiliary numbers.
+    // Rebuilding replaces the group's spans in place so width() re-measures it.
+    let contextReadout = 'full';
+    let contextWidth = maxContextWidth;
+    const rebuildContext = () => {
+        const index = leftKept.findIndex(entry => entry.id === 'context');
+        if (index < 0)
+            return;
+        leftKept[index] = {
+            group: {
+                spans: contextGroupSpans(stats.lastPromptTokens, stats.contextWindow, contextWidth, contextReadout),
+            },
+            rank: RANK_CONTEXT,
+            id: 'context',
+        };
+    };
+    const width = () => {
+        const leftWidth = joinWidth(leftKept.map(entry => spansWidth(entry.group.spans)), groupSeparator);
+        const rightWidth = joinWidth(rightKept.map(entry => visibleColumns(entry.span.text)), itemSeparator)
+            + (hint ? visibleColumns(statusCycleHint()) : 0);
+        return rightWidth > 0 ? leftWidth + LEFT_RIGHT_GAP + rightWidth : leftWidth;
+    };
+    while (width() > budget) {
+        // Context is the lowest-priority visual group: the bar shrinks inside
+        // its own budget first (the absolute readout survives), then the
+        // readout degrades to the bare percent, and only then does the whole
+        // group go — before the permission badge or its Shift+Tab affordance
+        // is touched.
+        if (leftKept.some(entry => entry.id === 'context')) {
+            if (contextWidth > CONTEXT_MIN_WIDTH) {
+                const overflow = width() - budget;
+                contextWidth = Math.max(CONTEXT_MIN_WIDTH, contextWidth - overflow);
+                rebuildContext();
+                continue;
+            }
+            if (contextReadout === 'full') {
+                contextReadout = 'percent';
+                rebuildContext();
+                continue;
+            }
+            leftKept.splice(leftKept.findIndex(entry => entry.id === 'context'), 1);
+            continue;
+        }
+        if (hint && rightKept.length > 0 && leftKept.length > 0) {
+            const identity = leftKept[0];
+            const identityText = identity.group.spans.map(span => span.text).join('');
+            const rightWidth = joinWidth(rightKept.map(entry => visibleColumns(entry.span.text)), itemSeparator);
+            const identityBudget = budget - rightWidth - LEFT_RIGHT_GAP - visibleColumns(statusCycleHint());
+            if (identityBudget > 0 && visibleColumns(identityText) > identityBudget) {
+                leftKept[0] = {
+                    ...identity,
+                    group: { spans: [{ text: truncateColumns(identityText, identityBudget), tone: 'model' }] },
+                };
+                continue;
+            }
+        }
+        if (hint) {
+            hint = false;
+            continue;
+        }
+        let dropLeft = -1;
+        let dropRight = -1;
+        let dropRank = Number.POSITIVE_INFINITY;
+        for (let index = 0; index < leftKept.length; index += 1) {
+            const rank = leftKept[index].rank;
+            if (rank < dropRank) {
+                dropRank = rank;
+                dropLeft = index;
+                dropRight = -1;
+            }
+        }
+        for (let index = 0; index < rightKept.length; index += 1) {
+            const rank = rightKept[index].rank;
+            if (rank < dropRank) {
+                dropRank = rank;
+                dropRight = index;
+                dropLeft = -1;
+            }
+        }
+        if (dropLeft < 0 && dropRight < 0)
+            break;
+        if (dropLeft >= 0) {
+            leftKept.splice(dropLeft, 1);
+        }
+        else {
+            rightKept.splice(dropRight, 1);
+            if (dropRight === rightKept.length)
+                hint = false;
+        }
+    }
+    // Only the identity cluster can remain overflowing: collapse to it and
+    // ellipsize inside the budget as the last resort. Flat spans make the
+    // joined text identical to what the row would have displayed.
+    if (width() > budget) {
+        rightKept.length = 0;
+        hint = false;
+        while (leftKept.length > 1)
+            leftKept.pop();
+        const identity = leftKept[0].group;
+        const joined = identity.spans.map(span => span.text).join('');
+        leftKept[0] = {
+            group: { spans: [{ text: truncateColumns(joined, budget), tone: 'model' }] },
+            rank: RANK_IDENTITY,
+            id: 'identity',
+        };
+    }
+    // Row 2 fits its own budget minus the model-name indent; the lowest-rank
+    // group drops first until the row fits or nothing is left. An empty row2 is
+    // a valid state — the footer degrades back to a single status row.
+    const row2Kept = [...orderedRow2];
+    // dscode: the telemetry segment owns row 2's right edge, so its width comes out
+    // of the left groups' budget first.
+    const row2Budget = Math.max(0, budget - 1 - (facts.telemetry ? visibleColumns(facts.telemetry) + 3 : 0));
+    const row2Width = () => joinWidth(row2Kept.map(entry => spansWidth(entry.group.spans)), groupSeparator);
+    while (row2Width() > row2Budget && row2Kept.length > 0) {
+        let dropIndex = 0;
+        let dropRank = Number.POSITIVE_INFINITY;
+        for (let index = 0; index < row2Kept.length; index += 1) {
+            if (row2Kept[index].rank < dropRank) {
+                dropRank = row2Kept[index].rank;
+                dropIndex = index;
+            }
+        }
+        row2Kept.splice(dropIndex, 1);
+    }
+    return {
+        row1: {
+            left: leftKept.map(entry => entry.group),
+            right: rightKept.map(entry => entry.span),
+            hint,
+        },
+        row2: {
+            left: row2Kept.map(entry => entry.group),
+            right: facts.telemetry ? [{ text: facts.telemetry, tone: 'meta' }] : [],
+            hint: false,
+        },
+    };
+}