@aiwayds/dsh-tui-pi 0.8.3 → 0.9.0

package/lib/font-detect.js

@@ -0,0 +1,124 @@
+/**
+ * Nerd Font detection for the icon-set self-adaptation — a
+ * zero-dependency probe that tells `src/icons.ts` whether the terminal can
+ * render the powerline PUA glyph U+E0B0 (and the other weak-terminal glyphs)
+ * before the `auto` icon-set mode picks between 'nerdfont' and 'plain'.
+ *
+ * Detection is per-platform and deliberately approximate:
+ *
+ *   - Linux: `fc-list -q <name>` for each candidate family. fc-list exits 0
+ *     when the family is installed (quiet mode prints nothing either way).
+ *     When `fc-list` itself is missing (ENOENT — a fontconfig-less system),
+ *     every probe fails and the probe reports "no Nerd Font".
+ *   - macOS: scan `~/Library/Fonts` and `/Library/Fonts` and match file names
+ *     against a Nerd/Powerline heuristic (the real Core Text registry is not
+ *     reachable without Objective-C bindings — a file-name scan is the
+ *     reasonable zero-dependency approximation; it also recognises the TUI's
+ *     own bundled font `dsh-tui-pi-nerd.ttf`, so `node scripts/install-font.mjs`
+ *     flipping the terminal to it is enough to flip `auto` → nerdfont).
+ *   - Windows / anything else: false (no free probe; the conservative answer
+ *     is the plain glyphs).
+ *
+ * The result is memoised at module level — the TUI probes once at startup and
+ * hot-applied 'auto' settings changes resolve against that same snapshot. All
+ * failure paths return `false`; the probe never throws.
+ */
+import { execFile as execFileCb } from 'node:child_process';
+import { readdir as readdirCb } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { promisify } from 'node:util';
+const execFile = promisify(execFileCb);
+const readdir = promisify(readdirCb);
+/** Candidate font families probed with `fc-list -q` on Linux. */
+export const NERD_FONT_CANDIDATES = [
+    'JetBrainsMono Nerd Font',
+    'Hack Nerd Font',
+    'MesloLGS NF',
+    'Cascadia Mono PL',
+    'PowerlineSymbols',
+    '0xProto Nerd Font',
+];
+/**
+ * macOS font-file-name heuristic for a Nerd/Powerline-capable font, incl. the
+ * TUI's own bundled subset (`dsh-tui-pi-nerd.ttf`). `MesloLGS` mirrors the
+ * Linux candidate list (MesloLGS NF ships as `MesloLGS NF Regular.ttf`).
+ */
+export const NERD_FONT_FILE_RE = /Nerd|Powerline|Cascadia.*PL|MesloLGS|dsh-tui-pi-nerd/i;
+/** The real environment: this process's platform, home and filesystem. */
+const realEnv = {
+    platform: process.platform,
+    home: homedir(),
+    readdir: (dir) => readdir(dir),
+    execFile: (file, args, options) => execFile(file, args, options),
+};
+/** Probe one platform with `fc-list -q`; `false` when fc-list is absent. */
+async function probeLinux(env) {
+    for (const candidate of NERD_FONT_CANDIDATES) {
+        try {
+            // 2s cap: a broken fontconfig / stale NFS font dir must fall through to
+            // the plain glyphs instead of hanging the TUI startup.
+            await env.execFile('fc-list', ['-q', candidate], { timeout: 2000 });
+            return true;
+        }
+        catch {
+            // fc-list missing (ENOENT), timed out, or the family not installed —
+            // try the next.
+        }
+    }
+    return false;
+}
+/** Probe macOS by scanning the two font directories for matching file names. */
+async function probeDarwin(env) {
+    for (const dir of [join(env.home, 'Library', 'Fonts'), '/Library/Fonts']) {
+        let names;
+        try {
+            names = await env.readdir(dir);
+        }
+        catch {
+            continue; // missing/unreadable directory — try the next
+        }
+        for (const name of names) {
+            if (NERD_FONT_FILE_RE.test(name))
+                return true;
+        }
+    }
+    return false;
+}
+/**
+ * The full probe against an injected environment: Linux uses fc-list, macOS
+ * uses the font-directory scan, every other platform reports `false`. Never
+ * throws — every platform path is wrapped or falls through to `false`.
+ */
+export async function probeNerdFont(env) {
+    switch (env.platform) {
+        case 'linux':
+            return probeLinux(env);
+        case 'darwin':
+            return probeDarwin(env);
+        default:
+            // Windows and the rest: no free probe, conservative plain answer.
+            return false;
+    }
+}
+/** Module-level memo: the TUI probes once per process, never again. */
+let cachedNerdFont;
+/**
+ * Detect whether a Nerd/Powerline font is available, memoised. The first call
+ * (TUI startup, src/index.ts) runs the platform probe and caches the result;
+ * every later call — including a hot-applied 'auto' iconSet change — resolves
+ * against the same startup snapshot. Never throws.
+ */
+export function detectNerdFontAvailable(env = realEnv) {
+    if (cachedNerdFont !== undefined)
+        return Promise.resolve(cachedNerdFont);
+    return probeNerdFont(env).then((value) => {
+        cachedNerdFont = value;
+        return value;
+    });
+}
+/** Drop the memoised result — a test seam (deterministic probe tests). */
+export function resetNerdFontCache() {
+    cachedNerdFont = undefined;
+}
+//# sourceMappingURL=font-detect.js.map

package/lib/font-detect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"font-detect.js","sourceRoot":"","sources":["../src/font-detect.ts"],"names":[],"mappings":"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"}

package/lib/footer.d.ts

@@ -4,8 +4,9 @@
  * Segments (left → right): fixed brand "dsh" · provider · model+thinking ·
  * context usage · cache-hit rate · message count · tool count, then a
  * right-aligned 24h clock. Segment backgrounds are the pi-powerline-footer
- * palette; separators are U+E0B0 powerline arrows tinted by the neighbouring
- * segment colours.
+ * palette; separators are the powerline arrow from src/icons.ts (U+E0B0 in
+ * nerdfont/auto-with-font, ▸ in the plain icon set), tinted by the
+ * neighbouring segment colours.
  *
  * Render cost is O(segments): every statistic is read from the bridge's
  * incrementally maintained counters (never a session-log scan). The 1s clock

package/lib/footer.js

@@ -4,8 +4,9 @@
  * Segments (left → right): fixed brand "dsh" · provider · model+thinking ·
  * context usage · cache-hit rate · message count · tool count, then a
  * right-aligned 24h clock. Segment backgrounds are the pi-powerline-footer
- * palette; separators are U+E0B0 powerline arrows tinted by the neighbouring
- * segment colours.
+ * palette; separators are the powerline arrow from src/icons.ts (U+E0B0 in
+ * nerdfont/auto-with-font, ▸ in the plain icon set), tinted by the
+ * neighbouring segment colours.
  *
  * Render cost is O(segments): every statistic is read from the bridge's
  * incrementally maintained counters (never a session-log scan). The 1s clock
@@ -15,6 +16,7 @@ import { truncateToWidth, visibleWidth } from '@earendil-works/pi-tui';
 import { ansiBg, ansiFg, BOLD, POWERLINE, RESET } from "./theme/index.js";
 import { hexIsLight } from "./theme/palette.js";
 import { clipToWidth } from "./text.js";
+import { arrowRight } from "./icons.js";
 /**
  * The footer keybinding hint, assembled from the user's `dsh-tui.footerHints`
  * selection (see buildFooterHint) - the pre-feature full string is what the
@@ -80,7 +82,6 @@ export class FooterHint {
         return [` ${styled}${pad} `];
     }
 }
-const ARROW_RIGHT = '\uE0B0';
 const WHITE = ansiFg('#FFFFFF');
 /** Segment text on bright fills (e.g. amber #FFC107): white is unreadable there. */
 const DARK_TEXT = ansiFg('#1f2328');
@@ -103,10 +104,10 @@ function buildSegments(segs) {
         const s = segs[i];
         out += `${ansiBg(s.bgHex)}${BOLD}${segmentText(s.bgHex)} ${s.label} `;
         if (i + 1 < segs.length) {
-            out += `${ansiBg(segs[i + 1].bgHex)}${ansiFg(s.bgHex)}${ARROW_RIGHT}`;
+            out += `${ansiBg(segs[i + 1].bgHex)}${ansiFg(s.bgHex)}${arrowRight()}`;
         }
         else {
-            out += RESET + ansiFg(s.bgHex) + ARROW_RIGHT + RESET;
+            out += RESET + ansiFg(s.bgHex) + arrowRight() + RESET;
         }
     }
     return out;
@@ -157,11 +158,18 @@ export class PowerlineFooter {
                 bgHex: thinkingBg(effort),
             });
         }
-        // Context usage: latest request's input tokens vs. the model's window.
+        // Context usage: the current occupancy estimate (latest request's billed
+        // input + output + a CJK estimate of messages after it) vs. the model's
+        // window — NOT the cumulative inputTokens, which only grows. Percent is
+        // capped at 100 (the window is a hard ceiling; the estimate can overshoot
+        // while it prices pending messages that a compaction will drop).
         const window = this.source.getContextWindow();
-        const used = stats.inputTokens;
+        // Defensive `?? 0`: a stats source without the field (any object missing
+        // contextTokens) degrades to an empty context instead of rendering
+        // `undefined`/`NaN` in the segment.
+        const used = stats.contextTokens ?? 0;
         if (window !== undefined && window > 0) {
-            const percent = (used / window) * 100;
+            const percent = Math.min(100, (used / window) * 100);
             segs.push({
                 label: `🧠 ${fmtNum(used)}/${fmtNum(window)}(${percent.toFixed(1)}%)`,
                 bgHex: contextBg(percent),

package/lib/footer.js.map

@@ -1 +1 @@
-{"version":3,"file":"footer.js","sourceRoot":"","sources":["../src/footer.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"footer.js","sourceRoot":"","sources":["../src/footer.ts"],"names":[],"mappings":"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"}

package/lib/icons.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Icon handling for dsh-tui-pi (icon-set self-adaptation).
+ *
+ * Glyph-risk classification for every symbol this TUI renders:
+ *
+ *   - PUA, must fall back — the ONLY Private Use Area codepoint in the whole
+ *     project is the powerline separator U+E0B0 (footer's arrow between
+ *     segments). No default terminal font ships it, so a terminal without a
+ *     Nerd Font shows a tofu box. `auto`/`plain` swap it for `▸` U+25B8.
+ *
+ *   - Standard Unicode, weak-terminal-risky — U+23F9 `⏹` (stop) and U+2B58
+ *     `⭘` (heavy circle) are standard codepoints, but weak terminals /
+ *     emoji-less fonts still render them as boxes. `auto`/`plain` swap them
+ *     for `■` U+25A0 and `●` U+25CF.
+ *
+ *   - Standard Unicode, rely on system fallback — everything else
+ *     (⚙ ⚠ ⚡ ✓ ✔ ✗ ✘ ⌘ ⎇ ⓘ ◐ ☑ ☐ ◔ ◑ ◕ ◉ ○ ★ ☁ 🤖 🧠 💬 🔧 ● …). Modern
+ *     terminals resolve these via font fallback and they are left untouched
+ *     in every mode.
+ *
+ * Modes (`dsh-tui.iconSet`, persisted in the settings namespace):
+ *   - 'nerdfont': use the PUA powerline glyph (assumes a Nerd Font is the
+ *     terminal's font).
+ *   - 'plain': use the safe standard-Unicode stand-ins for every risky glyph.
+ *   - 'auto' (default): nerdfont when a Nerd Font is detected at startup,
+ *     plain otherwise (see src/font-detect.ts).
+ *
+ * The resolved mode lives in module state: `applyIconSet` is called once at
+ * TUI startup and again on every hot-applied `iconSet` settings change, so
+ * footer/notice/panel accessors return the right glyph at render time. The
+ * module defaults to 'nerdfont' — the pre-feature output (`\uE0B0`) is
+ * preserved unless the resolution lands on 'plain'.
+ */
+/** The persisted/`auto` icon-set mode; 'auto' resolves at startup. */
+export type IconSet = 'auto' | 'nerdfont' | 'plain';
+/** A resolved (non-auto) icon set — the value that drives glyph selection. */
+export type ResolvedIconSet = Exclude<IconSet, 'auto'>;
+/**
+ * Resolve an icon-set mode against the startup font detection: `auto` picks
+ * the nerdfont glyphs when a Nerd Font is available and the plain fallbacks
+ * otherwise; an explicit `nerdfont`/`plain` pin returns itself unchanged.
+ */
+export declare function resolveIconSet(mode: IconSet, nerdfontAvailable: boolean): IconSet;
+/** Set the live resolved icon set (startup + hot-apply, src/index.ts). */
+export declare function applyIconSet(set: IconSet): void;
+/** The live resolved icon set (exposed for tests and the /settings UI). */
+export declare function getResolvedIconSet(): ResolvedIconSet;
+/** The powerline segment separator: `\uE0B0` (nerdfont) / `▸` (plain). */
+export declare function arrowRight(set?: IconSet): string;
+/** The stop glyph: `⏹` (nerdfont) / `■` (plain). */
+export declare function stopIcon(set?: IconSet): string;
+/** The subagent glyph: `⭘` (nerdfont) / `●` (plain). */
+export declare function sunglassesIcon(set?: IconSet): string;

package/lib/icons.js

@@ -0,0 +1,78 @@
+/**
+ * Icon handling for dsh-tui-pi (icon-set self-adaptation).
+ *
+ * Glyph-risk classification for every symbol this TUI renders:
+ *
+ *   - PUA, must fall back — the ONLY Private Use Area codepoint in the whole
+ *     project is the powerline separator U+E0B0 (footer's arrow between
+ *     segments). No default terminal font ships it, so a terminal without a
+ *     Nerd Font shows a tofu box. `auto`/`plain` swap it for `▸` U+25B8.
+ *
+ *   - Standard Unicode, weak-terminal-risky — U+23F9 `⏹` (stop) and U+2B58
+ *     `⭘` (heavy circle) are standard codepoints, but weak terminals /
+ *     emoji-less fonts still render them as boxes. `auto`/`plain` swap them
+ *     for `■` U+25A0 and `●` U+25CF.
+ *
+ *   - Standard Unicode, rely on system fallback — everything else
+ *     (⚙ ⚠ ⚡ ✓ ✔ ✗ ✘ ⌘ ⎇ ⓘ ◐ ☑ ☐ ◔ ◑ ◕ ◉ ○ ★ ☁ 🤖 🧠 💬 🔧 ● …). Modern
+ *     terminals resolve these via font fallback and they are left untouched
+ *     in every mode.
+ *
+ * Modes (`dsh-tui.iconSet`, persisted in the settings namespace):
+ *   - 'nerdfont': use the PUA powerline glyph (assumes a Nerd Font is the
+ *     terminal's font).
+ *   - 'plain': use the safe standard-Unicode stand-ins for every risky glyph.
+ *   - 'auto' (default): nerdfont when a Nerd Font is detected at startup,
+ *     plain otherwise (see src/font-detect.ts).
+ *
+ * The resolved mode lives in module state: `applyIconSet` is called once at
+ * TUI startup and again on every hot-applied `iconSet` settings change, so
+ * footer/notice/panel accessors return the right glyph at render time. The
+ * module defaults to 'nerdfont' — the pre-feature output (`\uE0B0`) is
+ * preserved unless the resolution lands on 'plain'.
+ */
+/** PUA — must fall back (see the classification above). */
+const ARROW_RIGHT_GLYPHS = { nerdfont: '\uE0B0', plain: '\u25B8' };
+/** Standard Unicode, weak-terminal-risky: `⏹` → `■`. */
+const STOP_GLYPHS = { nerdfont: '\u23F9', plain: '\u25A0' };
+/** Standard Unicode, weak-terminal-risky: `⭘` → `●`. */
+const SUNGLASSES_GLYPHS = { nerdfont: '\u2B58', plain: '\u25CF' };
+/**
+ * Resolve an icon-set mode against the startup font detection: `auto` picks
+ * the nerdfont glyphs when a Nerd Font is available and the plain fallbacks
+ * otherwise; an explicit `nerdfont`/`plain` pin returns itself unchanged.
+ */
+export function resolveIconSet(mode, nerdfontAvailable) {
+    if (mode === 'auto')
+        return nerdfontAvailable ? 'nerdfont' : 'plain';
+    return mode;
+}
+/**
+ * The live resolved icon set. Defaults to 'nerdfont' — the legacy output —
+ * so a TUI that renders before the async font detection lands never flickers
+ * from a plain glyph to the powerline arrow; only a resolved 'plain' flips it.
+ */
+let resolvedIconSet = 'nerdfont';
+/** Set the live resolved icon set (startup + hot-apply, src/index.ts). */
+export function applyIconSet(set) {
+    // 'auto' is resolved at startup (font detection, index.ts); a hot-applied
+    // settings 'auto' keeps the current resolved set — never flickers.
+    resolvedIconSet = set === 'auto' ? resolvedIconSet : set;
+}
+/** The live resolved icon set (exposed for tests and the /settings UI). */
+export function getResolvedIconSet() {
+    return resolvedIconSet;
+}
+/** The powerline segment separator: `\uE0B0` (nerdfont) / `▸` (plain). */
+export function arrowRight(set = resolvedIconSet) {
+    return ARROW_RIGHT_GLYPHS[set === 'auto' ? resolvedIconSet : set];
+}
+/** The stop glyph: `⏹` (nerdfont) / `■` (plain). */
+export function stopIcon(set = resolvedIconSet) {
+    return STOP_GLYPHS[set === 'auto' ? resolvedIconSet : set];
+}
+/** The subagent glyph: `⭘` (nerdfont) / `●` (plain). */
+export function sunglassesIcon(set = resolvedIconSet) {
+    return SUNGLASSES_GLYPHS[set === 'auto' ? resolvedIconSet : set];
+}
+//# sourceMappingURL=icons.js.map

package/lib/icons.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"icons.js","sourceRoot":"","sources":["../src/icons.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAWH,2DAA2D;AAC3D,MAAM,kBAAkB,GAAe,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAA;AAC9E,wDAAwD;AACxD,MAAM,WAAW,GAAe,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAA;AACvE,wDAAwD;AACxD,MAAM,iBAAiB,GAAe,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAA;AAE7E;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,IAAa,EAAE,iBAA0B;IACtE,IAAI,IAAI,KAAK,MAAM;QAAE,OAAO,iBAAiB,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO,CAAA;IACpE,OAAO,IAAI,CAAA;AACb,CAAC;AAED;;;;GAIG;AACH,IAAI,eAAe,GAAoB,UAAU,CAAA;AAEjD,0EAA0E;AAC1E,MAAM,UAAU,YAAY,CAAC,GAAY;IACvC,0EAA0E;IAC1E,mEAAmE;IACnE,eAAe,GAAG,GAAG,KAAK,MAAM,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,GAAG,CAAA;AAC1D,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,kBAAkB;IAChC,OAAO,eAAe,CAAA;AACxB,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,UAAU,CAAC,MAAe,eAAe;IACvD,OAAO,kBAAkB,CAAC,GAAG,KAAK,MAAM,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,GAAG,CAAC,CAAA;AACnE,CAAC;AAED,oDAAoD;AACpD,MAAM,UAAU,QAAQ,CAAC,MAAe,eAAe;IACrD,OAAO,WAAW,CAAC,GAAG,KAAK,MAAM,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,GAAG,CAAC,CAAA;AAC5D,CAAC;AAED,wDAAwD;AACxD,MAAM,UAAU,cAAc,CAAC,MAAe,eAAe;IAC3D,OAAO,iBAAiB,CAAC,GAAG,KAAK,MAAM,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,GAAG,CAAC,CAAA;AAClE,CAAC"}

package/lib/index.js

@@ -22,7 +22,9 @@ import { displayPermissionPreset } from "./permission.js";
 import { pickEffort, pickModel, pickPermission, pickSkill, pickTheme } from "./selectors.js";
 import { parseSkillCommand, skillGesture } from "./skills.js";
 import { DshSessionBridge, persistDefaultModel, stashSessionIdForReload, takeStashedSessionId } from "./session.js";
-import { currentThemePreference, readFooterHintsPreference, readPanelHeightPreference, readThemePreference, registerThemeSettings, writeThemePreference, } from "./theme-settings.js";
+import { currentThemePreference, readFooterHintsPreference, readIconSetPreference, readPanelHeightPreference, readSubagentLimits, readThemePreference, registerThemeSettings, writeThemePreference, } from "./theme-settings.js";
+import { applyIconSet, resolveIconSet, stopIcon } from "./icons.js";
+import { detectNerdFontAvailable } from "./font-detect.js";
 import { openAgentManager } from "./agents.js";
 import { openSettingsBrowser } from "./settings.js";
 import { openLoginFlow, openLogoutFlow } from "./login.js";
@@ -90,6 +92,14 @@ export function apply(ctx) {
      * the new segment selection. Armed inside runTui once the TUI exists.
      */
     let applyFooterHintsRef;
+    /**
+     * Live icon-set hot-reload sink, wired to the same watch hook: a committed
+     * `dsh-tui` iconSet change re-resolves the risky glyphs (an 'auto' change
+     * resolves against the startup font-detection snapshot) and repaints the
+     * footer/notices/panels that carry them. Armed inside runTui once the TUI
+     * exists.
+     */
+    let applyIconSetRef;
     ctx.effect(async () => {
         // The theme bundle is built once at TUI startup and held by every
         // component, so the persisted preference must land before startTui — the
@@ -105,17 +115,26 @@ export function apply(ctx) {
         // setTheme replay that follows already renders at that new height.
         // applyTheme carries the theme-bundle identity guard, so a height-only
         // commit never triggers a second rebuild.
-        registerThemeSettings(ctx, (pref, height, footerHints) => {
+        registerThemeSettings(ctx, (pref, height, footerHints, iconSet) => {
             applyPanelHeightRef?.(height);
             applyThemeRef?.(pref);
             applyFooterHintsRef?.(footerHints);
+            applyIconSetRef?.(iconSet);
         });
         const themePreference = await readThemePreference(ctx);
         const panelHeight = await readPanelHeightPreference(ctx);
         const footerHints = await readFooterHintsPreference(ctx);
+        // Icon-set self-adaptation: probe the platform once at startup (the
+        // memoised snapshot shared with every later 'auto' resolution), resolve
+        // the persisted mode against it and push the result into src/icons.ts
+        // BEFORE the TUI's first frame — so the footer renders the right
+        // separator from frame one, never a late plain→powerline flicker.
+        const iconSetPreference = await readIconSetPreference(ctx);
+        const nerdfontAvailable = await detectNerdFontAvailable();
+        applyIconSet(resolveIconSet(iconSetPreference, nerdfontAvailable));
         let disposer;
         try {
-            disposer = runTui(themePreference, panelHeight, footerHints);
+            disposer = runTui(themePreference, panelHeight, footerHints, nerdfontAvailable);
         }
         catch (error) {
             // An async-effect failure after startTui would otherwise orphan the
@@ -136,7 +155,7 @@ export function apply(ctx) {
      * reaches cordis. Returns the effect disposer handed back to cordis on
      * teardown.
      */
-    function runTui(themePreference, panelHeight, footerHints) {
+    function runTui(themePreference, panelHeight, footerHints, nerdfontAvailable) {
         // User keybindings (`~/.dsh/keybindings.json`): a partial map of the app
         // keys, read once per TUI start — `/reload` re-runs apply() and re-reads
         // it. Broken entries surface as notices instead of breaking startup.
@@ -185,7 +204,7 @@ export function apply(ctx) {
                             void stopTask();
                             break;
                         }
-                        renderer.renderNotice('⏹ stopping — Esc was double-pressed', 'info');
+                        renderer.renderNotice(`${stopIcon()} stopping — Esc was double-pressed`, 'info');
                         stopConfirmTimer = setTimeout(() => {
                             stopConfirmTimer = undefined;
                             void stopTask();
@@ -226,7 +245,7 @@ export function apply(ctx) {
                             void disposeAndExit(0);
                             break;
                         }
-                        renderer.renderNotice('⏹ Ctrl+C ×2 — quitting…', 'info');
+                        renderer.renderNotice(`${stopIcon()} Ctrl+C ×2 — quitting…`, 'info');
                         quitConfirmTimer = setTimeout(() => {
                             quitConfirmTimer = undefined;
                             void disposeAndExit(0);
@@ -291,7 +310,7 @@ export function apply(ctx) {
          * ESC/Ctrl+C double-press guards); the notice renders immediately.
          */
         const stopTask = async () => {
-            renderer.renderNotice('⏹ canceling current turn…', 'info');
+            renderer.renderNotice(`${stopIcon()} canceling current turn…`, 'info');
             const cancelled = await bridge.cancelActiveTurn();
             // State raced idle between the decision and the cancel call — nothing
             // to cancel (e.g. the turn settled inside the confirm window).
@@ -318,7 +337,10 @@ export function apply(ctx) {
         // into the last-request area BELOW the editor. Owned here — fed by
         // session events and the bridge's subagent fold, ticked by the live
         // timer, recolored by applyTheme.
-        const liveWidgets = new LiveWidgets(ui.widgets, ui.lastRequest, ui.theme, () => ui.requestRender(), panelHeight);
+        const liveWidgets = new LiveWidgets(ui.widgets, ui.lastRequest, ui.theme, () => ui.requestRender(), panelHeight, 
+        // Live maxRounds for the compact running-agent lines' `round N/M` — read
+        // at every rebuild (the /agents limits panel hot-applies).
+        () => readSubagentLimits(ctx).maxRounds);
         // Arm the panel-height watch sink now that the widgets exist: a committed
         // panelHeight change re-budgets the think/tool panels — they are
         // self-drawing, so the next frame already renders at the new height.
@@ -392,15 +414,16 @@ export function apply(ctx) {
         // Subagent fine-grained control, all in-process (see subagent-policy.ts):
         // a tools.guard denies spawn-tool calls once `maxAgents` children run
         // (workflow fan-out, which bypasses the tool pipeline, is pruned on
-        // `subagent/start`), and when a child's completed turns reach `maxRounds`
-        // the policy queues one wrap-up message into its next turn. Limits are
-        // read live from the `dsh-tui` settings namespace (/agents → l limits).
+        // `subagent/start`), and when a child's assistant-message count reaches
+        // `maxRounds` the policy queues one wrap-up message into its next turn.
+        // Limits are read live from the `dsh-tui` settings namespace
+        // (/agents → l limits).
         const subagentPolicy = applySubagentPolicy(ctx, {
             getLive: () => bridge.getLiveChildren(),
-            getTurnCount: childId => bridge.getTurnCount(childId),
+            getRoundCount: childId => bridge.getRoundCount(childId),
             isSettled: childId => bridge.isChildSettled(childId),
         });
-        bridgeCallbacks.onTurnCount = (childId, count) => subagentPolicy.onTurnCount(childId, count);
+        bridgeCallbacks.onRoundCount = (childId, count) => subagentPolicy.onRoundCount(childId, count);
         /**
          * One O(events) fold of the session log into the effective preset, stored
          * for the badge provider. Runs once per session (ensure/resume, see the
@@ -975,6 +998,14 @@ export function apply(ctx) {
             footerHintsRef = hints;
             ui.requestRender();
         };
+        // Arm the icon-set watch sink: a committed iconSet change hot-applies the
+        // risky glyphs (an 'auto' change resolves against the startup font-
+        // detection snapshot, matching the startup glyph choice) and repaints the
+        // footer/notices/panels that carry them on the next frame.
+        applyIconSetRef = (set) => {
+            applyIconSet(resolveIconSet(set, nerdfontAvailable));
+            ui.requestRender();
+        };
         /**
          * Hot-apply a theme bundle to the running TUI: the transcript rebuilds
          * from its replay buffer, the dock/editor swap to the new bundle, and the