rinco-pi-hud 1.3.1 → 1.5.0

package/README.md

@@ -20,6 +20,8 @@ Rinco Pi HUD takes over Pi's footer with four groups of live state and lets you
 
 ## Install
 
+Requires Pi **1.3.0 or newer within the 1.x release line**. Development and CI dependencies are pinned to 1.3.0.
+
 ```bash
 pi install npm:rinco-pi-hud
 ```
@@ -42,7 +44,7 @@ pi install "$PWD"
 > Pi extensions run with your user permissions. Review the source before installing any third-party extension.
 
 > [!NOTE]
-> The footer needs a Truecolor terminal. The screenshot above renders with ASCII icon mode; `/zentui` switches between the `auto`, `nerd`, and `ascii` glyph sets.
+> Truecolor and 256-color terminals are supported; explicit RGB colors use Pi's terminal-capability-aware encoder. The screenshot above renders with ASCII icon mode; `/zentui` switches between the `auto`, `nerd`, and `ascii` glyph sets.
 
 ## Commands
 
@@ -96,6 +98,8 @@ Variables accept `$name` or `${name}`. The [footer reference](docs/footer.md) li
 
 `/zentui` writes to `~/.pi/agent/rinco-pi-hud.json` and applies changes immediately. It covers the separator style, icon mode (`nerd`, `ascii`, or `auto`), footer colors (Pi theme tokens or terminal palette styles), context rendering (text, gauge, or both), the project refresh interval, and third-party extension statuses with their own placement and color mode.
 
+Footer colors follow the active Pi theme by default, including theme switches and automatic light/dark changes. In `/zentui`, **Footer colors → theme** enables this behavior; **terminal** keeps the original Sakura RGB palette. Explicit custom colors (hex, indexed, or `fg:`/`bg:` styles) remain fixed in either mode. Remove those entries from `colors` to restore automatic theme colors.
+
 See [docs/footer.md](docs/footer.md) for the full variable and segment reference.
 
 ## Project contents
@@ -154,7 +158,7 @@ The footer measures the terminal and wraps at segment boundaries, so narrow wind
 <details>
 <summary>Colors look incorrect</summary>
 
-The default palette emits `38;2;r;g;b` Truecolor sequences that terminals without Truecolor support approximate or ignore.
+The default palette follows the active Pi theme. If the footer still uses fixed colors, select **Footer colors → theme** in `/zentui` and remove explicit color overrides from `~/.pi/agent/rinco-pi-hud.json`. Third-party statuses set to `original` retain their own colors. Truecolor and 256-color output follow Pi's detected terminal capabilities.
 </details>
 
 <details>

package/docs/README.zh-CN.md

@@ -20,6 +20,8 @@ Rinco Pi HUD 用四组实时状态替换 Pi 的脚注行，不需要的部分都
 
 ## 安装
 
+需要 **Pi 1.3.0 或更新的 1.x 版本**。开发与 CI 依赖固定为 1.3.0。
+
 ```bash
 pi install npm:rinco-pi-hud
 ```
@@ -42,7 +44,7 @@ pi install "$PWD"
 > Pi 扩展以当前用户权限运行。安装任何第三方扩展前，请先审查其源码。
 
 > [!NOTE]
-> 脚注需要支持 Truecolor 的终端。上图用的是 ASCII 图标模式，`/zentui` 可以在 `auto`、`nerd`、`ascii` 三套符号之间切换。
+> 支持 Truecolor 和 256 色终端；显式 RGB 颜色通过 Pi 的终端能力适配接口输出。上图用的是 ASCII 图标模式，`/zentui` 可以在 `auto`、`nerd`、`ascii` 三套符号之间切换。
 
 ## 命令
 
@@ -96,6 +98,8 @@ Usage 行跟随当前模型的 Provider：
 
 `/zentui` 把配置写入 `~/.pi/agent/rinco-pi-hud.json`，改动立即生效。可配置分隔符样式、图标模式（`nerd`、`ascii`、`auto`）、脚注配色（Pi 主题色或终端调色板样式）、Context 渲染方式（文本、进度条或两者）、项目刷新间隔，以及第三方扩展状态的位置与颜色模式。
 
+脚注默认自动跟随当前 Pi 主题，包括手动切换主题和自动明暗切换。在 `/zentui` 中选择 **Footer colors → theme** 启用跟随，选择 **terminal** 则保留原有 Sakura RGB 配色。显式自定义颜色（十六进制、索引色或 `fg:`/`bg:` 样式）在两种模式下都会保留；删除 `colors` 中的相应配置即可恢复自动配色。
+
 完整的变量与状态段参考见 [docs/footer.md](footer.md)。
 
 ## 仓库结构
@@ -154,7 +158,7 @@ npx tsx assets/readme/source/build-assets.mts /tmp/footer.json
 <details>
 <summary>颜色显示异常</summary>
 
-默认配色输出 `38;2;r;g;b` Truecolor 序列，不支持 Truecolor 的终端会近似处理或直接忽略。
+默认配色自动跟随当前 Pi 主题。如果脚注仍使用固定颜色，请在 `/zentui` 中选择 **Footer colors → theme**，并删除 `~/.pi/agent/rinco-pi-hud.json` 中的显式颜色覆盖。设为 `original` 的第三方扩展状态会保留自己的颜色。Truecolor 与 256 色输出仍按 Pi 检测到的终端能力选择。
 </details>
 
 <details>

package/docs/footer.md

@@ -11,7 +11,7 @@ Activity · Agent idle · Skill 2/3 · MCP 2
 Usage    · 35%/200k · ↑ 4.2k · ↓ 1.1k · $ 0.030
 ```
 
-The MCP segment counts server entries in Pi's agent-directory `mcp.json` and the project's `.pi/mcp.json`. Same-name entries count once; disabled entries are included. Zero entries hide the segment. Counts refresh with the project state polling interval. This does not report connection state, validate individual server settings, or include servers registered dynamically by extensions. Missing, unreadable, malformed, or larger-than-1-MiB files contribute no entries. Legacy adapter footer statuses remain ordinary third-party statuses.
+The MCP segment counts server entries in Pi's agent-directory `mcp.json` and the project's `.pi/mcp.json`. Same-name entries count once; disabled entries are included. This is a raw file-entry count: differently spelled names such as `my-server` and `my_server` remain separate, even though Pi may reject them as a namespace collision. Zero entries hide the segment. Counts refresh with the project state polling interval. This does not report connection state, validate individual server settings, or include servers registered dynamically by extensions. Missing, unreadable, malformed, or larger-than-1-MiB files contribute no entries. Legacy adapter footer statuses remain ordinary third-party statuses.
 
 The category column is sized from visible text so every separator aligns. When a row exceeds the terminal width, complete status segments move to an indented continuation line. Only a single segment that is wider than the available content area is truncated. Third-party extension statuses appear on the Activity group in configured `left`, `middle`, then `right` order.
 
@@ -26,6 +26,24 @@ Control each default-layout row independently:
 
 The command shape is `/zentui row <project|session|activity|usage> <enable|disable|toggle>`. Values persist under `footerRows`; all four default to `true`. Row switches apply only to the default layout and do not alter a custom single-line `footerFormat`.
 
+## Colors and theme switching
+
+By default, `colorSources.starship` is `"theme"`. Built-in footer colors use semantic Pi theme tokens such as `accent`, `muted`, `success`, `warning`, and `error`; runtime labels also use the active theme. Switching themes, including automatic light/dark switching, recolors the footer without reloading the extension. This applies to both the default rows and custom templates.
+
+To enable theme colors in an existing configuration, use **Footer colors → theme** in `/zentui`, or set:
+
+```json
+{
+  "colorSources": {
+    "starship": "theme"
+  }
+}
+```
+
+Select `"terminal"` to retain the original Sakura RGB defaults and Starship runtime colors. Changing the source does not write a palette into your configuration.
+
+Entries you explicitly set under `colors` override the selected defaults. Semantic tokens (for example, `"cwd": "bold accent"`) follow the theme; hex colors, indexed colors, and explicit `fg:`/`bg:` styles remain fixed. Remove an override to restore the default for that segment. Third-party extension statuses in `original` color mode retain their own ANSI colors; use `zentui` color mode to recolor them with the HUD.
+
 ## Built-in status segments
 
 | Key | Default | Group | Description |

package/extensions/hud/commands/settings-controller.ts

@@ -42,6 +42,7 @@ export function registerSettingsController(pi: ExtensionAPI, deps: SettingsContr
 		},
 		setFooterRows(patch) {
 			updateConfig(saveFooterRowsPatch(patch));
+			deps.restartSessionTimer();
 		},
 		setFooterSegments(patch) {
 			updateConfig(saveFooterSegmentsPatch(patch));

package/extensions/hud/commands/settings.ts

@@ -92,7 +92,7 @@ const colorSettingLabels: Record<ColorSettingId, string> = {
 
 const colorSettingDescriptions: Record<ColorSettingId, string> = {
 	starship:
-		"Choose whether footer runtime/git/context colors use Pi theme tokens or terminal palette styles.",
+		"Follow the active Pi theme automatically (theme), or keep the original Sakura/runtime palette (terminal). Explicit color overrides are preserved.",
 };
 
 const featureSettingLabels: Record<FeatureSettingId, string> = {

package/extensions/hud/config/normalize.ts

@@ -34,6 +34,7 @@ import {
 	type PathDisplayConfig,
 	type PolishedTuiConfig,
 	type SeparatorStyle,
+	terminalDefaultColors,
 	type UiFeaturesConfig,
 } from "./schema.js";
 
@@ -374,7 +375,7 @@ export function mergeConfig(parsed: unknown): PolishedTuiConfig {
 		gitBranch,
 		icons: resolveConfiguredIcons(iconMode, iconOverrides),
 		colors: {
-			...defaultConfig.colors,
+			...(colorSources.starship === "terminal" ? terminalDefaultColors : defaultConfig.colors),
 			...colors,
 		},
 		colorSources: { ...colorSources },

package/extensions/hud/config/schema.ts

@@ -226,6 +226,30 @@ export const FOOTER_FORMAT_ALIASES: Record<string, string> = {
 
 export const configPath = join(getAgentDir(), "rinco-pi-hud.json");
 
+/** Preserve the original Sakura palette for users who explicitly select terminal colors. */
+export const terminalDefaultColors: PolishedTuiConfig["colors"] = {
+	cwd: "bold #F2A7C6",
+	gitBranch: "bold #C7B8F5",
+	gitStatus: "bold #F6BC9A",
+	contextNormal: "#AEE5C5",
+	contextWarning: "bold #F3D98B",
+	contextError: "bold #FF8FA3",
+	tokens: "#A99BAE",
+	cost: "bold #AEE5C5",
+	separator: "#716879",
+	runtimePrefix: "#9FD3F2",
+	extensionStatus: "#EFC3E6",
+	sessionDuration: "#F3D98B",
+	packageVersion: "#F6BC9A",
+	gitCommit: "#AEE5C5",
+	gitMetricsAdded: "#AEE5C5",
+	gitMetricsDeleted: "#FF8FA3",
+	username: "#F3D98B",
+	time: "#F3D98B",
+	os: "#F7EEF8",
+	muted: "#A99BAE",
+};
+
 export const defaultConfig: PolishedTuiConfig = {
 	projectRefreshIntervalMs: DEFAULT_PROJECT_REFRESH_INTERVAL_MS,
 	footerFormat: "",
@@ -239,29 +263,29 @@ export const defaultConfig: PolishedTuiConfig = {
 		...NERD_DEFAULT_ICONS,
 	},
 	colors: {
-		cwd: "bold #F2A7C6",
-		gitBranch: "bold #C7B8F5",
-		gitStatus: "bold #F6BC9A",
-		contextNormal: "#AEE5C5",
-		contextWarning: "bold #F3D98B",
-		contextError: "bold #FF8FA3",
-		tokens: "#A99BAE",
-		cost: "bold #AEE5C5",
-		separator: "#716879",
-		runtimePrefix: "#9FD3F2",
-		extensionStatus: "#EFC3E6",
-		sessionDuration: "#F3D98B",
-		packageVersion: "#F6BC9A",
-		gitCommit: "#AEE5C5",
-		gitMetricsAdded: "#AEE5C5",
-		gitMetricsDeleted: "#FF8FA3",
-		username: "#F3D98B",
-		time: "#F3D98B",
-		os: "#F7EEF8",
-		muted: "#A99BAE",
+		cwd: "bold accent",
+		gitBranch: "bold syntaxVariable",
+		gitStatus: "bold warning",
+		contextNormal: "success",
+		contextWarning: "bold warning",
+		contextError: "bold error",
+		tokens: "muted",
+		cost: "bold success",
+		separator: "dim",
+		runtimePrefix: "syntaxFunction",
+		extensionStatus: "customMessageLabel",
+		sessionDuration: "syntaxNumber",
+		packageVersion: "syntaxType",
+		gitCommit: "success",
+		gitMetricsAdded: "toolDiffAdded",
+		gitMetricsDeleted: "toolDiffRemoved",
+		username: "syntaxNumber",
+		time: "syntaxNumber",
+		os: "text",
+		muted: "muted",
 	},
 	colorSources: {
-		starship: "terminal",
+		starship: "theme",
 	},
 	features: {
 		statusLine: true,

package/extensions/hud/footer/format.ts

@@ -7,24 +7,48 @@
  * variable (and nested group) renders empty.
  */
 
-export type FormatToken =
+export type FormatToken = Readonly<
 	| { kind: "text"; value: string }
 	| { kind: "var"; name: string }
 	| { kind: "fill" }
-	| { kind: "group"; tokens: FormatToken[] };
+	| { kind: "group"; tokens: readonly FormatToken[] }
+>;
+
+const FORMAT_CACHE_LIMIT = 128;
+const FORMAT_CACHE_MAX_LENGTH = 16384;
+const formatCache = new Map<string, readonly FormatToken[]>();
+
+function freezeTokens(tokens: readonly FormatToken[]): readonly FormatToken[] {
+	for (const token of tokens) {
+		if (token.kind === "group") freezeTokens(token.tokens);
+		Object.freeze(token);
+	}
+	return Object.freeze(tokens);
+}
 
 const TOKEN_REGEX = /\$\{([a-zA-Z_][a-zA-Z0-9_]*)\}|\$([a-zA-Z_][a-zA-Z0-9_]*)/g;
 
 /**
- * Tokenize a format string into text/var/fill/group tokens.
+ * Tokenize a format string into deeply frozen text/var/fill/group tokens.
+ * Repeated bounded inputs reuse the same immutable AST; rendered values are never cached.
  *
  * `$name` and `${name}` both produce a variable token. A variable named
  * `fill` becomes a fill token instead. Parentheses form conditional groups
  * that drop entirely when all nested vars are empty.
  */
-export function parseFooterFormat(format: string): FormatToken[] {
-	if (!format) return [];
-	return parseTokenSlice(format, 0, format.length, true).tokens;
+export function parseFooterFormat(format: string): readonly FormatToken[] {
+	const cached = formatCache.get(format);
+	if (cached) return cached;
+	const tokens = freezeTokens(parseTokenSlice(format, 0, format.length, true).tokens);
+	// Bound both entry count and retained input size, including ad-hoc format strings.
+	if (format.length <= FORMAT_CACHE_MAX_LENGTH) {
+		if (formatCache.size >= FORMAT_CACHE_LIMIT) {
+			const oldest = formatCache.keys().next().value;
+			if (oldest !== undefined) formatCache.delete(oldest);
+		}
+		formatCache.set(format, tokens);
+	}
+	return tokens;
 }
 
 function parseTokenSlice(
@@ -112,7 +136,7 @@ function parseTokenSlice(
  * spaces are inserted — the user controls all spacing.
  */
 export function renderFormatSplit(
-	tokens: FormatToken[],
+	tokens: readonly FormatToken[],
 	renderVariable: (name: string) => string,
 ): { left: string; middle: string; right: string } {
 	const fillIndices = findTopLevelFillIndices(tokens);
@@ -151,7 +175,7 @@ export function renderFormatSplit(
 	};
 }
 
-function findTopLevelFillIndices(tokens: FormatToken[]): number[] {
+function findTopLevelFillIndices(tokens: readonly FormatToken[]): number[] {
 	const fillIndices: number[] = [];
 	for (let index = 0; index < tokens.length; index++) {
 		if (tokens[index]?.kind === "fill") fillIndices.push(index);
@@ -160,7 +184,7 @@ function findTopLevelFillIndices(tokens: FormatToken[]): number[] {
 }
 
 function renderTokenSlice(
-	tokens: FormatToken[],
+	tokens: readonly FormatToken[],
 	start: number,
 	end: number,
 	renderVariable: (name: string) => string,

package/extensions/hud/footer/index.ts

@@ -26,10 +26,10 @@ import {
 	formatOsLabel,
 	formatPackageVersionSegment,
 	formatRuntimeSegment,
+	formatRuntimeValue,
 	formatTimeLabel,
 	formatUsernameHostLabel,
 } from "../telemetry/format.js";
-import { resolveRuntimeSymbol } from "../ui/icons.js";
 import type { LiveContextOverride } from "../session/live-context.js";
 import type { FooterState } from "../state/index.js";
 import { renderStyleForSource } from "../ui/style.js";
@@ -180,12 +180,8 @@ export function installFooter(
 							return statusBlock;
 						case "git_state":
 							return gitStateBlock;
-						case "runtime": {
-							if (!safeRuntime) return "";
-							const symbol = resolveRuntimeSymbol(safeRuntime.name, safeRuntime.symbol, iconMode);
-							const label = safeRuntime.version ? `${symbol} ${safeRuntime.version}` : symbol;
-							return renderStyleForSource(theme, colorSource, safeRuntime.style, label);
-						}
+						case "runtime":
+							return formatRuntimeValue(theme, safeRuntime, colorSource, iconMode);
 						case "session_duration":
 							return state.sessionStartEpoch
 								? renderStyleForSource(

package/extensions/hud/footer/render-labels.ts

@@ -13,6 +13,7 @@ import { truncateToWidth } from "@earendil-works/pi-tui";
 import type { ColorSource, PolishedTuiConfig } from "../config/config.js";
 import { formatSkillCounts } from "../segments/skill-activity.js";
 import type { FooterState } from "../state/index.js";
+import type { RuntimeInfo } from "../segments/runtime.js";
 import { getTelemetryStats } from "../state/telemetry.js";
 import { buildSessionDurationLabel, formatCount } from "../telemetry/format.js";
 import { renderStyleForSource, type ThemeLike } from "../ui/style.js";
@@ -25,8 +26,7 @@ export function safeStatusText(value: string | null | undefined, maxLength = 256
 
 export type SanitizedFooterInputs = {
 	safeCwd: string;
-	safeRuntime:
-		{ name: string; symbol: string; style: string; version: string | undefined } | undefined;
+	safeRuntime: RuntimeInfo | undefined;
 	safePackageVersion: { ecosystem: string; version: string } | undefined;
 	safeCommit: { oid: string | null; detached: boolean; tag: string | null } | undefined;
 };

package/extensions/hud/index.ts

@@ -3,6 +3,7 @@ import registerCodexUsage from "./telemetry/codex-usage/index.js";
 import { ensureConfigExists, loadConfig, type PolishedTuiConfig } from "./config/config.js";
 import { installFooter } from "./footer/index.js";
 import { buildSessionDurationLabel } from "./telemetry/format.js";
+import { footerClockNeeds } from "./session/footer-clock.js";
 import { emptyGitStatus } from "./segments/git.js";
 import { LiveContextController } from "./session/live-context.js";
 import { createProjectStateController } from "./state/project-controller.js";
@@ -33,6 +34,7 @@ export default function (pi: ExtensionAPI) {
 	let footerInstalled = false;
 	let stopSessionTimer: () => void = () => {};
 	let lastDurationLabel = "";
+	let sessionTimerKey = "";
 
 	const refresh = () => {
 		if (sessionLifecycle.isCurrent()) requestFooterRender?.();
@@ -83,24 +85,29 @@ export default function (pi: ExtensionAPI) {
 	const refreshInteractiveState = (ctx: ExtensionContext, project = false) => {
 		if (!sessionLifecycle.isCurrent() || !ctx.hasUI) return;
 		syncFooterState(ctx);
+		startSessionTimer();
 		if (project && currentConfig.features.statusLine) scheduleProjectRefresh(ctx);
 		refresh();
 	};
 
 	const startSessionTimer = () => {
+		const needs = footerClockNeeds(
+			currentConfig,
+			state.telemetry.tools.some((tool) => tool.status === "running"),
+		);
+		const key = footerInstalled ? JSON.stringify(needs) : "";
+		if (sessionTimerKey === key) return;
 		stopSessionTimer();
-		lastDurationLabel = "";
-		const segments = currentConfig.footerSegments;
-		const format = currentConfig.footerFormat ?? "";
-		const needsWallClock = segments.time || /\$\{?time\b/.test(format);
-		const needsDuration =
-			segments.sessionDuration || /\$\{?(?:session_duration|duration)\b/.test(format);
-		const needsActivityClock = segments.runningTools || /\$\{?running_tools\b/.test(format);
-		if (
-			!currentConfig.features.statusLine ||
-			!(needsWallClock || needsDuration || needsActivityClock)
-		)
-			return;
+		sessionTimerKey = key;
+		lastDurationLabel = state.sessionStartEpoch
+			? buildSessionDurationLabel(state.sessionStartEpoch)
+			: "";
+		const {
+			wallClock: needsWallClock,
+			duration: needsDuration,
+			activity: needsActivityClock,
+		} = needs;
+		if (!footerInstalled || !(needsWallClock || needsDuration || needsActivityClock)) return;
 
 		const timer = setInterval(() => {
 			if (!sessionLifecycle.isCurrent()) return;
@@ -118,6 +125,7 @@ export default function (pi: ExtensionAPI) {
 		timer.unref?.();
 		stopSessionTimer = () => {
 			clearInterval(timer);
+			sessionTimerKey = "";
 			stopSessionTimer = () => {};
 		};
 	};

package/extensions/hud/segments/runtime-definitions.ts

@@ -240,6 +240,7 @@ const runtimes: RuntimeDef[] = [
 		name: "php",
 		symbol: "",
 		style: "147 bold",
+		themeStyle: "bold syntaxVariable",
 		priority: PRIORITY_COMMON,
 		detect: { files: ["composer.json"] },
 		version: async () =>
@@ -265,6 +266,7 @@ const runtimes: RuntimeDef[] = [
 		name: "cpp",
 		symbol: "",
 		style: "bold 149",
+		themeStyle: "bold success",
 		priority: PRIORITY_DEFAULT,
 		detect: { extensions: ["cpp", "cc", "cxx", "c++", "hpp", "hh", "hxx", "h++", "tcc"] },
 		version: versionFromCommands([
@@ -277,6 +279,7 @@ const runtimes: RuntimeDef[] = [
 		name: "c",
 		symbol: "",
 		style: "bold 149",
+		themeStyle: "bold success",
 		priority: PRIORITY_DEFAULT,
 		detect: { extensions: ["c", "h"] },
 		version: versionFromCommands([
@@ -414,6 +417,7 @@ const runtimes: RuntimeDef[] = [
 		name: "gleam",
 		symbol: "",
 		style: "bold #FFAFF3",
+		themeStyle: "bold syntaxKeyword",
 		priority: PRIORITY_DEFAULT,
 		detect: { extensions: ["gleam"], files: ["gleam.toml"] },
 		version: versionFromCommands([{ command: "gleam", args: ["--version"] }]),
@@ -438,6 +442,7 @@ const runtimes: RuntimeDef[] = [
 		name: "haxe",
 		symbol: "",
 		style: "bold fg:202",
+		themeStyle: "bold syntaxType",
 		priority: PRIORITY_DEFAULT,
 		detect: {
 			extensions: ["hx", "hxml"],
@@ -482,6 +487,7 @@ const runtimes: RuntimeDef[] = [
 		name: "mojo",
 		symbol: "󰈸",
 		style: "bold 208",
+		themeStyle: "bold syntaxType",
 		priority: PRIORITY_DEFAULT,
 		detect: { extensions: ["mojo", "🔥"] },
 		version: versionFromCommands([{ command: "mojo", args: ["--version"] }]),
@@ -534,6 +540,7 @@ const runtimes: RuntimeDef[] = [
 		name: "perl",
 		symbol: "",
 		style: "bold 149",
+		themeStyle: "bold success",
 		priority: PRIORITY_DEFAULT,
 		detect: {
 			extensions: ["pl", "pm", "pod"],
@@ -564,6 +571,7 @@ const runtimes: RuntimeDef[] = [
 		name: "pulumi",
 		symbol: "",
 		style: "bold 5",
+		themeStyle: "bold syntaxKeyword",
 		priority: PRIORITY_DEFAULT,
 		detect: { files: ["Pulumi.yaml", "Pulumi.yml"] },
 		version: versionFromCommands([{ command: "pulumi", args: ["version"] }]),
@@ -580,6 +588,7 @@ const runtimes: RuntimeDef[] = [
 		name: "raku",
 		symbol: "󱖊",
 		style: "bold 149",
+		themeStyle: "bold success",
 		priority: PRIORITY_DEFAULT,
 		detect: { extensions: ["p6", "pm6", "pod6", "raku", "rakumod"], files: ["META6.json"] },
 		version: versionFromCommands([{ command: "raku", args: ["--version"] }]),
@@ -636,6 +645,7 @@ const runtimes: RuntimeDef[] = [
 		name: "swift",
 		symbol: "",
 		style: "bold 202",
+		themeStyle: "bold syntaxType",
 		priority: PRIORITY_DEFAULT,
 		detect: { extensions: ["swift"], files: ["Package.swift"] },
 		version: versionFromCommands([
@@ -646,6 +656,7 @@ const runtimes: RuntimeDef[] = [
 		name: "terraform",
 		symbol: "",
 		style: "bold 105",
+		themeStyle: "bold syntaxVariable",
 		priority: PRIORITY_DEFAULT,
 		detect: { extensions: ["tf", "tfplan", "tfstate"], folders: [".terraform"] },
 		version: versionFromCommands([
@@ -657,6 +668,7 @@ const runtimes: RuntimeDef[] = [
 		name: "typst",
 		symbol: "",
 		style: "bold #0093A7",
+		themeStyle: "bold syntaxFunction",
 		priority: PRIORITY_DEFAULT,
 		detect: { extensions: ["typ"], files: ["template.typ"] },
 		version: versionFromCommands([{ command: "typst", args: ["--version"] }]),

package/extensions/hud/segments/runtime.ts

@@ -1,3 +1,4 @@
+import { createHash } from "node:crypto";
 import { existsSync, readdirSync, statSync } from "node:fs";
 import { join } from "node:path";
 import { runtimeDefinitions, type RuntimeDef } from "./runtime-definitions.js";
@@ -6,41 +7,43 @@ export type RuntimeMetadata = {
 	name: string;
 	symbol: string;
 	style: string;
+	/** Semantic alternative for built-in RGB/indexed terminal styles. */
+	themeStyle?: string;
 };
 
-export type RuntimeInfo = Pick<RuntimeMetadata, "name" | "symbol" | "style"> & {
+export type RuntimeInfo = RuntimeMetadata & {
 	version?: string;
 };
 
 export type RuntimeReadResult = { kind: "ok"; runtime?: RuntimeInfo } | { kind: "error" };
 
 type RuntimeCacheEntry = {
-	fingerprint: string;
-	runtime: RuntimeInfo | undefined;
+	result: RuntimeReadResult;
+	expiresAt: number;
 };
 
 const RUNTIME_CACHE_MAX = 32;
+const RUNTIME_CACHE_TTL_MS = 60_000;
+const RUNTIME_RETRY_TTL_MS = 5_000;
 const runtimeInfoCache = new Map<string, RuntimeCacheEntry>();
+const runtimeReadsInFlight = new Map<string, Promise<RuntimeReadResult>>();
+let cacheEpoch = 0;
 
 export function clearRuntimeInfoCache(): void {
+	cacheEpoch += 1;
 	runtimeInfoCache.clear();
+	// New callers must not join a probe started before the clear.
+	runtimeReadsInFlight.clear();
 }
 
 function topLevelFingerprint(entries: readonly string[]): string {
 	return entries.slice().sort().join("\0");
 }
 
-function cacheRuntimeInfo(
-	cwd: string,
-	fingerprint: string,
-	runtime: RuntimeInfo | undefined,
-): void {
-	// Drop prior fingerprints for the same cwd so stale marker sets do not linger.
-	for (const key of runtimeInfoCache.keys()) {
-		if (key === cwd || key.startsWith(`${cwd}\0`)) runtimeInfoCache.delete(key);
-	}
-	const key = `${cwd}\0${fingerprint}`;
-	runtimeInfoCache.set(key, { fingerprint, runtime });
+function cacheRuntimeInfo(key: string, result: RuntimeReadResult): void {
+	const ttl =
+		result.kind === "ok" && result.runtime?.version ? RUNTIME_CACHE_TTL_MS : RUNTIME_RETRY_TTL_MS;
+	runtimeInfoCache.set(key, { result, expiresAt: Date.now() + ttl });
 	while (runtimeInfoCache.size > RUNTIME_CACHE_MAX) {
 		const oldest = runtimeInfoCache.keys().next().value;
 		if (oldest === undefined) break;
@@ -113,10 +116,11 @@ function matchesDetection(
 const sortedRuntimes = runtimeDefinitions;
 
 export const runtimeMetadata: RuntimeMetadata[] = runtimeDefinitions.map(
-	({ name, symbol, style }) => ({
+	({ name, symbol, style, themeStyle }) => ({
 		name,
 		symbol,
 		style,
+		themeStyle,
 	}),
 );
 
@@ -140,28 +144,54 @@ export async function readRuntimeInfo(cwd: string): Promise<RuntimeReadResult> {
 		return { kind: "error" };
 	}
 
-	const fingerprint = topLevelFingerprint(entries);
-	const cacheKey = `${cwd}\0${fingerprint}`;
+	// Detection uses shell variables and version commands inherit the environment.
+	// Include all variables (including PATH and toolchain-manager settings) so a
+	// changed environment never reuses the old probe. JSON avoids key collisions.
+	const env = { ...process.env };
+	const environment = Object.keys(env)
+		.sort()
+		.map((key) => [key, env[key]]);
+	// Hash environment values so cache keys do not retain plaintext credentials.
+	const environmentKey = createHash("sha256").update(JSON.stringify(environment)).digest("hex");
+	const cacheKey = JSON.stringify([cwd, topLevelFingerprint(entries), environmentKey]);
 	const cached = runtimeInfoCache.get(cacheKey);
-	if (cached && cached.fingerprint === fingerprint) {
-		return { kind: "ok", runtime: cached.runtime };
+	if (cached) {
+		if (Date.now() < cached.expiresAt) return cached.result;
+		runtimeInfoCache.delete(cacheKey);
 	}
+	const inFlight = runtimeReadsInFlight.get(cacheKey);
+	if (inFlight) return inFlight;
 
-	try {
-		const runtime = detectRuntime(cwd, entries);
-		if (!runtime) {
-			cacheRuntimeInfo(cwd, fingerprint, undefined);
-			return { kind: "ok", runtime: undefined };
+	const epoch = cacheEpoch;
+	const read = async (): Promise<RuntimeReadResult> => {
+		try {
+			const runtime = detectRuntime(cwd, entries, env);
+			if (!runtime) return { kind: "ok", runtime: undefined };
+			return {
+				kind: "ok",
+				runtime: {
+					name: runtime.name,
+					symbol: runtime.symbol,
+					style: runtime.style,
+					themeStyle: runtime.themeStyle,
+					version: await runtime.version(cwd),
+				},
+			};
+		} catch {
+			return { kind: "error" };
 		}
-		const info: RuntimeInfo = {
-			name: runtime.name,
-			symbol: runtime.symbol,
-			style: runtime.style,
-			version: await runtime.version(cwd),
-		};
-		cacheRuntimeInfo(cwd, fingerprint, info);
-		return { kind: "ok", runtime: info };
-	} catch {
-		return { kind: "error" };
-	}
+	};
+	const pending = read()
+		.then((result) => {
+			// Clearing the cache must also invalidate outstanding writers.
+			if (epoch === cacheEpoch) cacheRuntimeInfo(cacheKey, result);
+			return result;
+		})
+		.finally(() => {
+			if (runtimeReadsInFlight.get(cacheKey) === pending) {
+				runtimeReadsInFlight.delete(cacheKey);
+			}
+		});
+	runtimeReadsInFlight.set(cacheKey, pending);
+	return pending;
 }

package/extensions/hud/segments/skill-activity.ts

@@ -119,13 +119,18 @@ export class SkillActivityTracker {
 				}
 				continue;
 			}
-			if (
-				message.role !== "toolResult" ||
-				message.toolName !== "read" ||
-				message.isError === true
-			) {
-				continue;
+			if (message.role !== "toolResult") continue;
+			// Nested calls are persisted on the outer result, even when that outer
+			// tool subsequently fails. Restore each successful read independently.
+			const nestedCalls = isRecord(message.nestedCalls) ? message.nestedCalls.calls : undefined;
+			if (Array.isArray(nestedCalls)) {
+				for (const call of nestedCalls) {
+					if (!isRecord(call) || call.name !== "read" || call.status !== "ok") continue;
+					const path = isRecord(call.args) ? call.args.path : undefined;
+					if (typeof path === "string") this.activateFromRead(path, cwd);
+				}
 			}
+			if (message.toolName !== "read" || message.isError === true) continue;
 			const id = typeof message.toolCallId === "string" ? message.toolCallId : undefined;
 			const path = id ? pendingReads.get(id) : undefined;
 			if (path) this.activateFromRead(path, cwd);

package/extensions/hud/session/event-handlers.ts

@@ -64,7 +64,9 @@ export function registerSessionEventHandlers(
 
 	pi.on("before_agent_start", (event, ctx) => {
 		deps.updateSkillCounts(ctx, event.systemPromptOptions.skills ?? []);
-		deps.skillActivity.activateFromPrompt(event.prompt, ctx.cwd);
+		if (event.messageType === "user") {
+			deps.skillActivity.activateFromPrompt(event.prompt, ctx.cwd);
+		}
 		deps.state.skillCounts = deps.skillActivity.counts();
 		deps.refreshInteractiveState(ctx);
 	});

package/extensions/hud/session/footer-clock.ts

@@ -0,0 +1,36 @@
+import type { PolishedTuiConfig } from "../config/config.js";
+import { parseFooterFormat, type FormatToken } from "../footer/format.js";
+
+export interface FooterClockNeeds {
+	wallClock: boolean;
+	duration: boolean;
+	activity: boolean;
+}
+
+/** Only clocks actually referenced by the visible layout need periodic work. */
+export function footerClockNeeds(
+	config: PolishedTuiConfig,
+	hasRunningTools: boolean,
+): FooterClockNeeds {
+	if (!config.features.statusLine) return { wallClock: false, duration: false, activity: false };
+	if (config.footerFormat) {
+		const names = new Set<string>();
+		const visit = (tokens: readonly FormatToken[]) => {
+			for (const token of tokens) {
+				if (token.kind === "var") names.add(token.name);
+				if (token.kind === "group") visit(token.tokens);
+			}
+		};
+		visit(parseFooterFormat(config.footerFormat));
+		return {
+			wallClock: names.has("time"),
+			duration: names.has("session_duration") || names.has("duration"),
+			activity: hasRunningTools && names.has("running_tools"),
+		};
+	}
+	return {
+		wallClock: config.footerRows.usage && config.footerSegments.time,
+		duration: config.footerRows.session && config.footerSegments.sessionDuration,
+		activity: hasRunningTools && config.footerRows.activity && config.footerSegments.runningTools,
+	};
+}

package/extensions/hud/state/project-controller.ts

@@ -17,6 +17,7 @@ import {
 interface ProjectRefreshTarget {
 	cwd: string;
 	generation: number;
+	epoch: number;
 }
 
 export interface ProjectStateController {
@@ -42,9 +43,14 @@ export function createProjectStateController({
 }: ProjectStateControllerDeps): ProjectStateController {
 	let stopInterval: StopProjectRefreshInterval = () => {};
 	let lastProjectCwd: string | undefined;
+	let epoch = 0;
 
-	const refreshProjectState = async ({ cwd, generation }: ProjectRefreshTarget): Promise<void> => {
-		if (!lifecycle.isCurrent(generation)) return;
+	const refreshProjectState = async ({
+		cwd,
+		generation,
+		epoch: targetEpoch,
+	}: ProjectRefreshTarget): Promise<void> => {
+		if (targetEpoch !== epoch || !lifecycle.isCurrent(generation)) return;
 		const config = getConfig();
 		const format = config.footerFormat;
 		const formatNeedsTag = /\$\{?(?:git_tag|tag)\b/.test(format);
@@ -66,7 +72,7 @@ export function createProjectStateController({
 			wantPackage ? readPackageVersionResult(cwd) : Promise.resolve(undefined),
 			Promise.resolve(countConfigEntries(cwd)),
 		]);
-		if (!lifecycle.isCurrent(generation)) return;
+		if (targetEpoch !== epoch || !lifecycle.isCurrent(generation)) return;
 		state.configCounts = configCounts;
 		lastProjectCwd = applyProjectRefreshToState(state, {
 			cwd,
@@ -79,6 +85,8 @@ export function createProjectStateController({
 
 	const scheduler = createProjectRefreshScheduler(refreshProjectState, requestRender);
 	const stop = () => {
+		// Invalidate work even when the session lifecycle itself has not changed.
+		epoch += 1;
 		stopInterval();
 		stopInterval = () => {};
 		scheduler.stop();
@@ -86,11 +94,13 @@ export function createProjectStateController({
 	const schedule = (ctx: ExtensionContext, options?: ScheduleProjectRefreshOptions) => {
 		const generation = lifecycle.currentGeneration();
 		if (!lifecycle.isCurrent(generation)) return;
-		scheduler.schedule({ cwd: ctx.cwd, generation }, options);
+		scheduler.schedule({ cwd: ctx.cwd, generation, epoch }, options);
 	};
 
 	return {
 		reset() {
+			epoch += 1;
+			scheduler.stop();
 			lastProjectCwd = undefined;
 		},
 		schedule,

package/extensions/hud/telemetry/codex-usage/query.ts

@@ -195,10 +195,13 @@ function hasHeader(headers: Record<string, string>, name: string): boolean {
 	return Object.keys(headers).some((key) => key.toLowerCase() === name.toLowerCase());
 }
 
-function allowedAuthHeaders(source: Record<string, string>): Record<string, string> {
+function allowedAuthHeaders(source: Record<string, string | null>): Record<string, string> {
 	const allowed = new Set(["authorization", "chatgpt-account-id", "user-agent", "accept"]);
 	return Object.fromEntries(
-		Object.entries(source).filter(([key]) => allowed.has(key.toLowerCase())),
+		Object.entries(source).filter(
+			(entry): entry is [string, string] =>
+				allowed.has(entry[0].toLowerCase()) && typeof entry[1] === "string",
+		),
 	);
 }
 

package/extensions/hud/telemetry/format.ts

@@ -85,6 +85,7 @@ type SessionEntry = {
 	type?: string;
 	id?: string | number;
 	timestamp?: string | number;
+	usage?: AssistantMessage["usage"];
 	message?: {
 		role?: string;
 		usage?: AssistantMessage["usage"];
@@ -133,9 +134,22 @@ function calculateCacheHitRate(
 	return promptTokens > 0 ? (cacheRead / promptTokens) * 100 : undefined;
 }
 
+function entryUsage(entry: SessionEntry): AssistantMessage["usage"] | undefined {
+	if (entry.type === "usage" || entry.type === "compaction" || entry.type === "branch_summary") {
+		return entry.usage;
+	}
+	if (
+		entry.type === "message" &&
+		(entry.message?.role === "assistant" || entry.message?.role === "toolResult")
+	) {
+		return entry.message.usage;
+	}
+	return undefined;
+}
+
 function entryIdentity(entry: SessionEntry | undefined): string {
 	if (!entry) return "";
-	const usage = entry.message?.usage;
+	const usage = entryUsage(entry);
 	const usageKey = usage
 		? `${usage.input ?? 0}:${usage.output ?? 0}:${usage.cacheRead ?? 0}:${usage.cacheWrite ?? 0}:${usage.cost?.total ?? 0}`
 		: "";
@@ -158,8 +172,8 @@ function computeUsageTotals(entries: readonly SessionEntry[]): UsageTotals {
 	let cost = 0;
 
 	for (const entry of entries) {
-		if (entry.type !== "message" || entry.message?.role !== "assistant") continue;
-		const usage = entry.message.usage;
+		const usage = entryUsage(entry);
+		if (!usage) continue;
 		const entryInput = usage?.input ?? 0;
 		const entryCacheRead = usage?.cacheRead ?? 0;
 		const entryCacheWrite = usage?.cacheWrite ?? 0;
@@ -169,7 +183,9 @@ function computeUsageTotals(entries: readonly SessionEntry[]): UsageTotals {
 		cacheRead += entryCacheRead;
 		cacheWrite += entryCacheWrite;
 		cost += usage?.cost?.total ?? 0;
-		latestCacheHitRate = calculateCacheHitRate(entryInput, entryCacheRead, entryCacheWrite);
+		if (entry.type === "message" && entry.message?.role === "assistant") {
+			latestCacheHitRate = calculateCacheHitRate(entryInput, entryCacheRead, entryCacheWrite);
+		}
 	}
 
 	return Object.freeze({ input, output, cacheRead, cacheWrite, latestCacheHitRate, cost });
@@ -288,17 +304,29 @@ export function buildContextLabel(ctx: ExtensionContext): string {
 	return formatContextPercentLabel(usage?.percent, contextWindow);
 }
 
-export function formatRuntimeSegment(
+/** Render just the runtime value for both default rows and custom templates. */
+export function formatRuntimeValue(
 	theme: Pick<Theme, "fg">,
 	runtime: RuntimeInfo | undefined,
-	prefixStyle: ColorSpec,
 	colorSource: ColorSource,
 	mode: IconMode = "auto",
 ): string {
 	if (!runtime) return "";
 	const symbol = resolveRuntimeSymbol(runtime.name, runtime.symbol, mode);
 	const label = runtime.version ? `${symbol} ${runtime.version}` : symbol;
-	return `${renderStyleForSource(theme, colorSource, prefixStyle, "via")} ${renderStyleForSource(theme, colorSource, runtime.style, label)}`;
+	const style = colorSource === "theme" ? (runtime.themeStyle ?? runtime.style) : runtime.style;
+	return renderStyleForSource(theme, colorSource, style, label);
+}
+
+export function formatRuntimeSegment(
+	theme: Pick<Theme, "fg">,
+	runtime: RuntimeInfo | undefined,
+	prefixStyle: ColorSpec,
+	colorSource: ColorSource,
+	mode: IconMode = "auto",
+): string {
+	if (!runtime) return "";
+	return `${renderStyleForSource(theme, colorSource, prefixStyle, "via")} ${formatRuntimeValue(theme, runtime, colorSource, mode)}`;
 }
 
 /**

package/extensions/hud/ui/style.ts

@@ -1,8 +1,10 @@
-import type { ThemeColor } from "@earendil-works/pi-coding-agent";
+import type { ThemeColor, ThemeStyle } from "@earendil-works/pi-coding-agent";
+import type { Color } from "@earendil-works/pi-tui";
 import type { ColorSource, ColorSpec } from "../config/config.js";
 
 type ThemeLike = {
 	fg(color: string, text: string): string;
+	style?: (text: string, options: ThemeStyle) => string;
 	bold?: (text: string) => string;
 	italic?: (text: string) => string;
 	underline?: (text: string) => string;
@@ -126,6 +128,10 @@ const themeColorTokens = new Set<ThemeColor>([
 	"thinkingMedium",
 	"thinkingHigh",
 	"thinkingXhigh",
+	"thinkingMax",
+	"scrollbarTrack",
+	"scrollbarThumb",
+	"searchMatchText",
 	"bashMode",
 ]);
 
@@ -164,12 +170,14 @@ function isSupportedStyleToken(token: string): boolean {
 }
 
 export function isSupportedColorSpec(style: ColorSpec): boolean {
-	const trimmed = style.trim();
-	if (trimmed === "") return true;
-	return trimmed.split(/\s+/).every(isSupportedStyleToken);
+	return parseStyle(style).supported;
 }
 
-function applyThemeModifiers(theme: ThemeLike, styleTokens: string[], text: string): string {
+function applyThemeModifiers(
+	theme: ThemeLike,
+	styleTokens: readonly string[],
+	text: string,
+): string {
 	let rendered = text;
 	for (const token of styleTokens) {
 		const normalized = token.toLowerCase();
@@ -188,7 +196,7 @@ export function safeThemeFg(theme: ThemeLike, color: string, text: string): stri
 	}
 }
 
-function mapThemeColor(styleTokens: string[]): string | undefined {
+function mapThemeColor(styleTokens: readonly string[]): string | undefined {
 	let fallback: string | undefined;
 	for (const token of styleTokens) {
 		const normalized = token.toLowerCase();
@@ -212,35 +220,114 @@ function mapThemeColor(styleTokens: string[]): string | undefined {
  */
 export function colorize(theme: ThemeLike, color: ColorSpec, text: string): string {
 	if (isHexColor(color)) {
+		try {
+			if (theme.style) return theme.style(text, { fg: hexColor(color) });
+		} catch {
+			// Older/mock themes retain the original truecolor fallback.
+		}
 		return `${hexToAnsi(color)}${text}\x1b[39m`;
 	}
 	return safeThemeFg(theme, color, text);
 }
 
-/**
- * Render text with Starship-style terminal styling strings (e.g. "bold red", "fg:202",
- * "bg:blue", "underline bg:#bf5700").
- */
-export function renderTerminalStyle(style: string, text: string): string {
-	const codes: string[] = [];
-	for (const token of style.trim().split(/\s+/)) {
-		if (!token) continue;
+type ParsedStyle = {
+	readonly tokens: readonly string[];
+	readonly codes: string;
+	readonly options: Readonly<ThemeStyle>;
+	readonly hasHex: boolean;
+	readonly explicit: boolean;
+	readonly supported: boolean;
+};
+
+// Cache syntax only: never retain a Theme or themed ANSI across theme changes.
+const STYLE_CACHE_LIMIT = 256;
+const STYLE_CACHE_MAX_LENGTH = 4096;
+const styleCache = new Map<string, ParsedStyle>();
+
+function hexColor(hex: string): Color {
+	const normalized = expandHexColor(hex);
+	return Object.freeze({
+		kind: "rgb",
+		r: Number.parseInt(normalized.slice(0, 2), 16),
+		g: Number.parseInt(normalized.slice(2, 4), 16),
+		b: Number.parseInt(normalized.slice(4, 6), 16),
+	});
+}
 
+function parseStyle(style: string): ParsedStyle {
+	const cached = styleCache.get(style);
+	if (cached) return cached;
+	const tokens = Object.freeze(style.trim().split(/\s+/).filter(Boolean));
+	const codes: string[] = [];
+	const options: ThemeStyle = {};
+	let hasHex = false;
+	for (const token of tokens) {
 		const normalized = token.toLowerCase();
 		const modifier = terminalStyleModifiers.get(normalized);
 		if (modifier !== undefined) {
 			codes.push(`${modifier}`);
+			const attribute = normalized === "dimmed" ? "dim" : normalized;
+			if (
+				attribute === "bold" ||
+				attribute === "dim" ||
+				attribute === "italic" ||
+				attribute === "underline"
+			)
+				options[attribute] = true;
 			continue;
 		}
-
 		const isForeground = normalized.startsWith("fg:");
 		const isBackground = normalized.startsWith("bg:");
 		const colorName = isForeground || isBackground ? normalized.slice(3) : normalized;
-		const color = terminalColorToAnsi(colorName, isBackground);
-		if (color) codes.push(color);
+		const code = terminalColorToAnsi(colorName, isBackground);
+		if (!code) continue;
+		codes.push(code);
+		let color: Color;
+		if (isHexColor(colorName)) {
+			hasHex = true;
+			color = hexColor(colorName);
+		} else {
+			const named = terminalColorCodes.get(colorName);
+			color = Object.freeze({
+				kind: "indexed",
+				index: named === undefined ? Number(colorName) : named >= 90 ? named - 90 + 8 : named - 30,
+			});
+		}
+		options[isBackground ? "bg" : "fg"] = color;
 	}
+	const parsed = Object.freeze({
+		tokens,
+		codes: codes.join(";"),
+		options: Object.freeze(options),
+		hasHex,
+		explicit: tokens.some(isExplicitTerminalColorToken),
+		supported: tokens.every(isSupportedStyleToken),
+	});
+	if (style.length <= STYLE_CACHE_MAX_LENGTH) {
+		if (styleCache.size >= STYLE_CACHE_LIMIT) {
+			const oldest = styleCache.keys().next().value;
+			if (oldest !== undefined) styleCache.delete(oldest);
+		}
+		styleCache.set(style, parsed);
+	}
+	return parsed;
+}
 
-	return codes.length ? `\x1b[${codes.join(";")}m${text}\x1b[0m` : text;
+/**
+ * Render Starship terminal styles. With a Theme, explicit RGB uses its color-mode encoder;
+ * named/indexed-only styles and simple mocks retain the original terminal ANSI semantics.
+ */
+export function renderTerminalStyle(style: string, text: string, theme?: ThemeLike): string {
+	const parsed = parseStyle(style);
+	if (parsed.hasHex && theme?.style) {
+		try {
+			// Pass a fresh options object so a custom theme cannot mutate cached syntax.
+			return theme.style(text, { ...parsed.options });
+		} catch {
+			// Preserve terminal styling for partial/legacy theme implementations.
+		}
+	}
+	return parsed.codes ? `\x1b[${parsed.codes}m${text}\x1b[0m` : text;
 }
 
 /**
@@ -248,17 +335,16 @@ export function renderTerminalStyle(style: string, text: string): string {
  * legacy config values such as "accent" or "syntaxKeyword".
  */
 export function renderStyle(theme: ThemeLike, style: ColorSpec, text: string): string {
-	if (style.trim() === "") return text;
-	const styled = renderTerminalStyle(style, text);
+	if (parseStyle(style).tokens.length === 0) return text;
+	const styled = renderTerminalStyle(style, text, theme);
 	return styled === text ? colorize(theme, style, text) : styled;
 }
 
 export function renderThemeStyle(theme: ThemeLike, style: ColorSpec, text: string): string {
-	const trimmed = style.trim();
-	if (trimmed === "") return text;
-
-	const tokens = trimmed.split(/\s+/).filter(Boolean);
-	if (tokens.some(isExplicitTerminalColorToken)) return renderTerminalStyle(style, text);
+	const parsed = parseStyle(style);
+	const tokens = parsed.tokens;
+	if (tokens.length === 0) return text;
+	if (parsed.explicit) return renderTerminalStyle(style, text, theme);
 
 	const color = mapThemeColor(tokens) ?? "text";
 	return safeThemeFg(theme, color, applyThemeModifiers(theme, tokens, text));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rinco-pi-hud",
-  "version": "1.3.1",
+  "version": "1.5.0",
   "description": "A dynamic HUD footer for Pi, ported from Sakura Zentui Footer.",
   "type": "module",
   "license": "MIT",
@@ -39,8 +39,9 @@
     "pack:check": "npm pack --dry-run"
   },
   "peerDependencies": {
-    "@earendil-works/pi-coding-agent": "*",
-    "@earendil-works/pi-tui": "*"
+    "@earendil-works/pi-ai": "^1.3.0",
+    "@earendil-works/pi-coding-agent": "^1.3.0",
+    "@earendil-works/pi-tui": "^1.3.0"
   },
   "pi": {
     "extensions": [
@@ -48,7 +49,9 @@
     ]
   },
   "devDependencies": {
-    "@earendil-works/pi-ai": "^0.83.0",
+    "@earendil-works/pi-ai": "1.3.0",
+    "@earendil-works/pi-coding-agent": "1.3.0",
+    "@earendil-works/pi-tui": "1.3.0",
     "@eslint/js": "^10.0.1",
     "@types/node": "^24.12.4",
     "eslint": "^10.8.1",