rinco-pi-hud 1.5.0 → 1.6.1

package/NOTICE

@@ -4,7 +4,12 @@ License: MIT.
 
 This package contains a dynamic HUD footer for Pi, adapted from the Footer
 portion of pi-zentui by Luka: https://github.com/lmilojevicc/pi-zentui
-License: MIT.
+Footer integration snapshot: version 0.32.0, commit
+9e8e798cfcce26cee9e1def4daf3668616482610.
+Adapted modules include template joining/compact layout, custom values,
+repository paths, optional telemetry, and passive live metadata.
+License: MIT. The original copyright and license text is retained at
+extensions/hud/ZENTUI-LICENSE.
 
 Session, model, activity, MCP, configuration-count, and Codex subscription
 status capabilities are adapted from pi-shannon-statusline by RealAlexandreAI:

package/README.md

@@ -26,7 +26,7 @@ Requires Pi **1.3.0 or newer within the 1.x release line**. Development and CI d
 pi install npm:rinco-pi-hud
 ```
 
-Restart Pi afterwards, or run `/reload`. The footer is enabled by default and `/zentui` opens the settings UI.
+Restart Pi afterwards, or run `/reload`. The footer is enabled by default and `/hud` opens the settings UI.
 
 From GitHub, or from a local checkout:
 
@@ -44,29 +44,32 @@ pi install "$PWD"
 > Pi extensions run with your user permissions. Review the source before installing any third-party extension.
 
 > [!NOTE]
-> 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.
+> 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; `/hud` switches between the `auto`, `nerd`, and `ascii` glyph sets.
 
 ## Commands
 
 | Command | Effect |
 | --- | --- |
-| `/zentui` | Settings UI: rows, segments, separator, icons, colors, templates |
-| `/zentui statusline enable\|disable\|toggle` | Show or hide the whole footer |
-| `/zentui row project\|session\|activity\|usage <enable\|disable\|toggle>` | Turn one row on or off |
-| `/zentui format "<template>"` | Replace the four rows with a single-line template |
+| `/hud` | Settings UI: rows, segments, separator, icons, colors, templates |
+| `/hud statusline enable\|disable\|toggle` | Show or hide the whole footer |
+| `/hud row project\|session\|activity\|usage <enable\|disable\|toggle>` | Turn one row on or off |
+| `/hud format "<template>"` | Replace the four rows with a single-line template |
+| `/hud compact-format "<template>"` | Opt into a wrapped template below 80 columns; `clear` removes it |
+| `/hud footer hud\|hidden\|native` | Four-group/template HUD, statuses only, or Pi’s native footer |
+| `/hud layout\|segments\|extensions` | Open a settings section directly |
 | `/codex-status` | Print Codex subscription usage and rate-limit windows |
 | `/usage-refresh` | Refresh the model usage or balance shown in the footer |
 
 ## What it shows
 
-| Row | Segments, each with its own switch under **Built-in segments** in `/zentui` |
+| Row | Segments, each with its own switch under **Built-in segments** in `/hud` |
 | --- | --- |
 | **Project** | directory, git branch, commit and tag, working-tree status, operation state (`MERGING`, `REBASING`, …), diff metrics, runtime, package version, OS, user |
-| **Session** | session name, provider and model, thinking level, turn count, duration |
-| **Activity** | running tools, completed tool counts, active agents, `Agent idle`, skills, MCP servers |
-| **Usage** | context window with a gauge, input and output tokens, cache read/write volume and hit rate, cost, model quota, clock |
+| **Session** | session name, provider and model, thinking level, turn count, duration, clock |
+| **Activity** | running tools, completed tool counts, skills, MCP servers |
+| **Usage** | context window with a gauge, input and output tokens, cache read/write volume and hit rate, cost, model quota |
 
-Rows are toggled with `/zentui row usage disable`; the segments inside them have individual switches in the same UI. Existing configs that used the former aggregate `tokens`, `toolActivity`, or `agentActivity` switches are migrated automatically.
+Rows are toggled with `/hud row usage disable`; the segments inside them have individual switches in the same UI. Existing configs that used the former aggregate `tokens` or `toolActivity` switches are migrated automatically.
 
 ### Model quota
 
@@ -89,18 +92,20 @@ Groups wrap only at segment boundaries. A continuation line realigns under the s
 Set a template for a single-line footer instead of the four groups:
 
 ```text
-/zentui format "$cwd( $git_branch)$fill($context)( $tokens)( $cost)"
+/hud format "$cwd( $git_branch)$fill($context)( $tokens)( $cost)"
 ```
 
-Variables accept `$name` or `${name}`. The [footer reference](docs/footer.md) lists all of them, along with the aliases (`$directory`, `$status`, `$codex`, …). Run `/zentui format` with no argument, or `/zentui format clear`, to go back to the four groups.
+Variables accept `$name` or `${name}`. The [footer reference](docs/footer.md) lists all of them, along with the aliases (`$directory`, `$status`, `$codex`, …). Run `/hud format` with no argument, or `/hud format clear`, to go back to the four groups.
 
 ## Configuration
 
-`/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.
+The HUD uses `/hud`; `/zentui` is reserved for the original Zentui package. There is no legacy command alias. See [Using with Zentui](docs/footer.md#using-with-the-original-zentui) for component separation.
 
-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.
+`/hud` 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.
 
-See [docs/footer.md](docs/footer.md) for the full variable and segment reference.
+Footer colors follow the active Pi theme by default, including theme switches and automatic light/dark changes. In `/hud`, **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.
+
+Footer features are adapted from Zentui **0.32.0**, without installing its editor, messages, working line, tool display, or OMP adapter. New opt-in features include repository-relative paths, `$join_sep`, compact templates, extension-published values, safe status hyperlinks, PR/CI metadata, and average token rate. Defaults and existing configurations remain unchanged. See [docs/upstream-zentui.md](docs/upstream-zentui.md) for the exact snapshot and integration boundaries, and [docs/footer.md](docs/footer.md) for configuration and examples.
 
 ## Project contents
 
@@ -113,11 +118,11 @@ See [docs/footer.md](docs/footer.md) for the full variable and segment reference
 | [`extensions/hud/telemetry/`](extensions/hud/telemetry/format.ts) | Usage formatting, provider balance probes, and the Codex subscription client |
 | [`extensions/hud/session/`](extensions/hud/session/) | Pi event registration, session lifecycle, and live context overlay |
 | [`extensions/hud/state/`](extensions/hud/state/) | Aggregated state, telemetry reducer, and project refresh controller |
-| [`extensions/hud/commands/`](extensions/hud/commands/settings.ts) | `/zentui` settings UI and configuration controller |
+| [`extensions/hud/commands/`](extensions/hud/commands/settings.ts) | `/hud` settings UI and configuration controller |
 | [`extensions/hud/ui/`](extensions/hud/ui/) | Icons and terminal style utilities |
 | [`docs/footer.md`](docs/footer.md) | Complete footer configuration reference |
 | [`docs/CONTRIBUTING.md`](docs/CONTRIBUTING.md) | Local development, testing guidance, and pull request checklist |
-| [`tests/`](tests/) | Vitest suite: footer layout, telemetry, provider balances, MCP configuration counts |
+| [`tests/`](tests/) | Vitest suite: footer layout, telemetry, provider balances, MCP runtime tool counts |
 
 ## Development
 
@@ -152,19 +157,19 @@ Confirm Pi is running in TUI mode rather than headless, JSON, or print mode. The
 <details>
 <summary>The layout looks wrong in a narrow terminal</summary>
 
-The footer measures the terminal and wraps at segment boundaries, so narrow windows show fewer segments per line. Set a `footerFormat` template, or disable low-priority segments in `/zentui`.
+The footer measures the terminal and wraps at segment boundaries, so narrow windows show fewer segments per line. Set a `footerFormat` template, or disable low-priority segments in `/hud`.
 </details>
 
 <details>
 <summary>Colors look incorrect</summary>
 
-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.
+The default palette follows the active Pi theme. If the footer still uses fixed colors, select **Footer colors → theme** in `/hud` 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>
 <summary>Icons are missing or misaligned</summary>
 
-Unicode and Nerd Font glyphs vary between terminals and fonts. Install a Nerd Font, or switch to ASCII icons in `/zentui`.
+Unicode and Nerd Font glyphs vary between terminals and fonts. Install a Nerd Font, or switch to ASCII icons in `/hud`.
 </details>
 
 ## License

package/assets/readme/hero.svg

@@ -15,7 +15,7 @@
 
     <text x="80" y="260" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, 'Liberation Mono', monospace" font-size="20" xml:space="preserve"><tspan> </tspan><tspan fill="#f2a7c6" font-weight="700">Project</tspan><tspan> </tspan><tspan fill="#716879"> › </tspan><tspan fill="#f2a7c6" font-weight="700">rinco-pi-hud</tspan><tspan fill="#716879"> › </tspan><tspan>on </tspan><tspan fill="#c7b8f5" font-weight="700">*</tspan><tspan> </tspan><tspan fill="#c7b8f5" font-weight="700">main</tspan><tspan fill="#716879"> › </tspan><tspan fill="#9fd3f2">via</tspan><tspan> </tspan><tspan fill="#AEE5C5" font-weight="700">node v24.18.0</tspan><tspan fill="#716879"> › </tspan><tspan fill="#f7eef8">linux</tspan></text>
     <text x="80" y="290" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, 'Liberation Mono', monospace" font-size="20" xml:space="preserve"><tspan> </tspan><tspan fill="#9fd3f2">Session</tspan><tspan> </tspan><tspan fill="#716879"> › </tspan><tspan fill="#9fd3f2">deepseek/deepseek-flash</tspan><tspan fill="#716879"> › </tspan><tspan fill="#efc3e6">Thinking level: max</tspan><tspan fill="#716879"> › </tspan><tspan fill="#efc3e6">Turn 3</tspan></text>
-    <text x="80" y="320" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, 'Liberation Mono', monospace" font-size="20" xml:space="preserve"><tspan> </tspan><tspan fill="#efc3e6">Activity</tspan><tspan fill="#716879"> › </tspan><tspan fill="#aee5c5">Tool read × 30 write × 7 edit × 13 bash × 76</tspan><tspan fill="#716879"> › </tspan><tspan fill="#a99bae">Agent idle</tspan></text>
+    <text x="80" y="320" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, 'Liberation Mono', monospace" font-size="20" xml:space="preserve"><tspan> </tspan><tspan fill="#efc3e6">Activity</tspan><tspan fill="#716879"> › </tspan><tspan fill="#aee5c5">Tool read × 30 write × 7 edit × 13 bash × 76</tspan></text>
     <text x="80" y="350" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, 'Liberation Mono', monospace" font-size="20" xml:space="preserve"><tspan> </tspan><tspan fill="#aee5c5">Usage</tspan><tspan>   </tspan><tspan fill="#716879"> › </tspan><tspan fill="#aee5c5">[##--------] 17%/1.0M</tspan><tspan fill="#716879"> › </tspan><tspan fill="#a99bae">↑ 177k</tspan><tspan fill="#716879"> › </tspan><tspan fill="#a99bae">↓ 74k</tspan><tspan fill="#716879"> › </tspan><tspan fill="#a99bae">R 10M</tspan><tspan> </tspan><tspan fill="#aee5c5">CH 99.8%</tspan><tspan fill="#716879"> › </tspan><tspan fill="#aee5c5" font-weight="700">$ 0.204</tspan></text>
   </g>
 </svg>

package/assets/readme/responsive.svg

@@ -14,14 +14,14 @@
     <line x1="194" y1="160" x2="194" y2="334" stroke="#716879" stroke-dasharray="3 5" opacity="0.55"/>
     <text x="80" y="190" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, 'Liberation Mono', monospace" font-size="20" xml:space="preserve"><tspan> </tspan><tspan fill="#f2a7c6" font-weight="700">Project</tspan><tspan> </tspan><tspan fill="#716879"> › </tspan><tspan fill="#f2a7c6" font-weight="700">rinco-pi-hud</tspan><tspan fill="#716879"> › </tspan><tspan>on </tspan><tspan fill="#c7b8f5" font-weight="700">*</tspan><tspan> </tspan><tspan fill="#c7b8f5" font-weight="700">main</tspan><tspan fill="#716879"> › </tspan><tspan fill="#9fd3f2">via</tspan><tspan> </tspan><tspan fill="#AEE5C5" font-weight="700">node v24.18.0</tspan><tspan fill="#716879"> › </tspan><tspan fill="#f7eef8">linux</tspan></text>
     <text x="80" y="220" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, 'Liberation Mono', monospace" font-size="20" xml:space="preserve"><tspan> </tspan><tspan fill="#9fd3f2">Session</tspan><tspan> </tspan><tspan fill="#716879"> › </tspan><tspan fill="#9fd3f2">deepseek/deepseek-flash</tspan><tspan fill="#716879"> › </tspan><tspan fill="#efc3e6">Thinking level: max</tspan><tspan fill="#716879"> › </tspan><tspan fill="#efc3e6">Turn 3</tspan></text>
-    <text x="80" y="250" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, 'Liberation Mono', monospace" font-size="20" xml:space="preserve"><tspan> </tspan><tspan fill="#efc3e6">Activity</tspan><tspan fill="#716879"> › </tspan><tspan fill="#aee5c5">Tool read × 30 write × 7 edit × 13 bash × 76</tspan><tspan fill="#716879"> › </tspan><tspan fill="#a99bae">Agent idle</tspan></text>
+    <text x="80" y="250" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, 'Liberation Mono', monospace" font-size="20" xml:space="preserve"><tspan> </tspan><tspan fill="#efc3e6">Activity</tspan><tspan fill="#716879"> › </tspan><tspan fill="#aee5c5">Tool read × 30 write × 7 edit × 13 bash × 76</tspan></text>
     <text x="80" y="280" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, 'Liberation Mono', monospace" font-size="20" xml:space="preserve"><tspan> </tspan><tspan fill="#aee5c5">Usage</tspan><tspan>   </tspan><tspan fill="#716879"> › </tspan><tspan fill="#aee5c5">[##--------] 17%/1.0M</tspan><tspan fill="#716879"> › </tspan><tspan fill="#a99bae">↑ 177k</tspan><tspan fill="#716879"> › </tspan><tspan fill="#a99bae">↓ 74k</tspan><tspan fill="#716879"> › </tspan><tspan fill="#a99bae">R 10M</tspan><tspan> </tspan><tspan fill="#aee5c5">CH 99.8%</tspan></text>
     <text x="80" y="310" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, 'Liberation Mono', monospace" font-size="20" xml:space="preserve"><tspan>         </tspan><tspan fill="#716879"> › </tspan><tspan fill="#aee5c5" font-weight="700">$ 0.204</tspan></text>
   </g>
   <g id="panel-56">
     <rect x="56" y="368" width="1088" height="298" rx="14" fill="#16131F" stroke="#2C2640"/>
     <text x="80" y="391" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, 'Liberation Mono', monospace" font-size="18" fill="#A99BAE">render(56)</text>
-    <text x="1120" y="391" text-anchor="end" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, 'Liberation Mono', monospace" font-size="18" fill="#A99BAE">8 rows · continuations align</text>
+    <text x="1120" y="391" text-anchor="end" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, 'Liberation Mono', monospace" font-size="18" fill="#A99BAE">7 rows · continuations align</text>
     <line x1="56" y1="402" x2="1144" y2="402" stroke="#2C2640"/>
     <line x1="194" y1="402" x2="194" y2="666" stroke="#716879" stroke-dasharray="3 5" opacity="0.55"/>
     <text x="80" y="432" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, 'Liberation Mono', monospace" font-size="20" xml:space="preserve"><tspan> </tspan><tspan fill="#f2a7c6" font-weight="700">Project</tspan><tspan> </tspan><tspan fill="#716879"> › </tspan><tspan fill="#f2a7c6" font-weight="700">rinco-pi-hud</tspan><tspan fill="#716879"> › </tspan><tspan>on </tspan><tspan fill="#c7b8f5" font-weight="700">*</tspan><tspan> </tspan><tspan fill="#c7b8f5" font-weight="700">main</tspan></text>
@@ -29,8 +29,7 @@
     <text x="80" y="492" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, 'Liberation Mono', monospace" font-size="20" xml:space="preserve"><tspan> </tspan><tspan fill="#9fd3f2">Session</tspan><tspan> </tspan><tspan fill="#716879"> › </tspan><tspan fill="#9fd3f2">deepseek/deepseek-flash</tspan></text>
     <text x="80" y="522" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, 'Liberation Mono', monospace" font-size="20" xml:space="preserve"><tspan>         </tspan><tspan fill="#716879"> › </tspan><tspan fill="#efc3e6">Thinking level: max</tspan><tspan fill="#716879"> › </tspan><tspan fill="#efc3e6">Turn 3</tspan></text>
     <text x="80" y="552" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, 'Liberation Mono', monospace" font-size="20" xml:space="preserve"><tspan> </tspan><tspan fill="#efc3e6">Activity</tspan><tspan fill="#716879"> › </tspan><tspan fill="#aee5c5">Tool read × 30 write × 7 edit × 13 bash × </tspan><tspan>…</tspan></text>
-    <text x="80" y="582" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, 'Liberation Mono', monospace" font-size="20" xml:space="preserve"><tspan>         </tspan><tspan fill="#716879"> › </tspan><tspan fill="#a99bae">Agent idle</tspan></text>
-    <text x="80" y="612" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, 'Liberation Mono', monospace" font-size="20" xml:space="preserve"><tspan> </tspan><tspan fill="#aee5c5">Usage</tspan><tspan>   </tspan><tspan fill="#716879"> › </tspan><tspan fill="#aee5c5">[##--------] 17%/1.0M</tspan><tspan fill="#716879"> › </tspan><tspan fill="#a99bae">↑ 177k</tspan><tspan fill="#716879"> › </tspan><tspan fill="#a99bae">↓ 74k</tspan></text>
-    <text x="80" y="642" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, 'Liberation Mono', monospace" font-size="20" xml:space="preserve"><tspan>         </tspan><tspan fill="#716879"> › </tspan><tspan fill="#a99bae">R 10M</tspan><tspan> </tspan><tspan fill="#aee5c5">CH 99.8%</tspan><tspan fill="#716879"> › </tspan><tspan fill="#aee5c5" font-weight="700">$ 0.204</tspan></text>
+    <text x="80" y="582" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, 'Liberation Mono', monospace" font-size="20" xml:space="preserve"><tspan> </tspan><tspan fill="#aee5c5">Usage</tspan><tspan>   </tspan><tspan fill="#716879"> › </tspan><tspan fill="#aee5c5">[##--------] 17%/1.0M</tspan><tspan fill="#716879"> › </tspan><tspan fill="#a99bae">↑ 177k</tspan><tspan fill="#716879"> › </tspan><tspan fill="#a99bae">↓ 74k</tspan></text>
+    <text x="80" y="612" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, 'Liberation Mono', monospace" font-size="20" xml:space="preserve"><tspan>         </tspan><tspan fill="#716879"> › </tspan><tspan fill="#a99bae">R 10M</tspan><tspan> </tspan><tspan fill="#aee5c5">CH 99.8%</tspan><tspan fill="#716879"> › </tspan><tspan fill="#aee5c5" font-weight="700">$ 0.204</tspan></text>
   </g>
 </svg>

package/docs/CONTRIBUTING.md

@@ -50,7 +50,8 @@ npm run pack:check
 
 Tests live in `tests/`:
 
-- `zentui-status.test.ts` — Config counts, MCP configuration counts, and extension status helpers.
+- `zentui-status.test.ts` — Config counts, telemetry, and skill activity.
+- `mcp-status.test.ts` — Pi runtime MCP namespaces, exposure filtering, and dynamic tool changes.
 - `mcp-footer.test.ts` — MCP count rendering, segment controls, custom formats, and legacy third-party statuses.
 - `codex-usage.test.ts` — Codex payload normalization and model-specific quota formatting.
 - `footer-layout.test.ts` — Four-group categorized layout, segment wrapping, and narrow-width budget.
@@ -61,6 +62,14 @@ Tests live in `tests/`:
 - `model-usage-refresh.test.ts` — Model usage refresh integration.
 - `token-switch-usage.test.ts` — Token Switch balance formatting.
 - `deepseek-balance.test.ts` — DeepSeek balance parsing, formatting, and query safety.
+- `footer-template-enhancements.test.ts` — Conditional joining, compact packing and alignment.
+- `footer-options.test.ts` — New layout persistence, direct commands and settings routes.
+- `footer-lifecycle.test.ts` — Root wiring, ownership/demand cleanup, clock teardown and inactive network gating.
+- `repository-path.test.ts` — Repository paths, worktrees, safe fallback and stale roots.
+- `live-metadata.test.ts` — Demand gating, GitHub identity/TTL and completed-call token rate.
+- `zentui-footer-integration.test.ts` — Publisher bounds, atomic values, links, hidden mode and optional telemetry.
+
+Upstream source versions and adaptation boundaries are recorded in [upstream-zentui.md](upstream-zentui.md).
 
 When adding tests:
 
@@ -95,7 +104,7 @@ Follow the configured conventions:
 The HUD extension is organized into functional modules under `extensions/hud/`:
 
 - **`index.ts`** — Composition root for controllers, shared state, and UI installation.
-- **`commands/`** — `/zentui` presentation and its configuration-persistence controller.
+- **`commands/`** — `/hud` presentation and its configuration-persistence controller.
 - **`config/`** — Configuration model, normalization, and persistence.
 - **`footer/`** — Footer rendering, semantic group construction, responsive layout, and templates.
 - **`segments/`** — State collectors: Git, runtime, MCP, skills, projects, etc.

package/docs/README.zh-CN.md

@@ -26,7 +26,7 @@ Rinco Pi HUD 用四组实时状态替换 Pi 的脚注行，不需要的部分都
 pi install npm:rinco-pi-hud
 ```
 
-装完重启 Pi，或执行 `/reload`。脚注默认启用，`/zentui` 打开设置界面。
+装完重启 Pi，或执行 `/reload`。脚注默认启用，`/hud` 打开设置界面。
 
 从 GitHub 或本地目录安装：
 
@@ -44,29 +44,32 @@ pi install "$PWD"
 > Pi 扩展以当前用户权限运行。安装任何第三方扩展前，请先审查其源码。
 
 > [!NOTE]
-> 支持 Truecolor 和 256 色终端；显式 RGB 颜色通过 Pi 的终端能力适配接口输出。上图用的是 ASCII 图标模式，`/zentui` 可以在 `auto`、`nerd`、`ascii` 三套符号之间切换。
+> 支持 Truecolor 和 256 色终端；显式 RGB 颜色通过 Pi 的终端能力适配接口输出。上图用的是 ASCII 图标模式，`/hud` 可以在 `auto`、`nerd`、`ascii` 三套符号之间切换。
 
 ## 命令
 
 | 命令 | 作用 |
 | --- | --- |
-| `/zentui` | 设置界面：行、状态段、分隔符、图标、颜色、模板 |
-| `/zentui statusline enable\|disable\|toggle` | 显示或隐藏整个脚注 |
-| `/zentui row project\|session\|activity\|usage <enable\|disable\|toggle>` | 开关某一行 |
-| `/zentui format "<template>"` | 用单行模板替换四行布局 |
+| `/hud` | 设置界面：行、状态段、分隔符、图标、颜色、模板 |
+| `/hud statusline enable\|disable\|toggle` | 显示或隐藏整个脚注 |
+| `/hud row project\|session\|activity\|usage <enable\|disable\|toggle>` | 开关某一行 |
+| `/hud format "<template>"` | 用单行模板替换四行布局 |
+| `/hud compact-format "<template>"` | 设置低于 80 列时使用的换行模板；`clear` 清除 |
+| `/hud footer hud\|hidden\|native` | HUD、仅第三方状态、恢复 Pi 原生脚注 |
+| `/hud layout\|segments\|extensions` | 直接打开对应设置页 |
 | `/codex-status` | 打印 Codex 订阅用量与限额窗口 |
 | `/usage-refresh` | 立即刷新脚注上的模型用量或余额 |
 
 ## 显示什么
 
-| 行 | 状态段。每段在 `/zentui` 的 **Built-in segments** 里都有独立开关 |
+| 行 | 状态段。每段在 `/hud` 的 **Built-in segments** 里都有独立开关 |
 | --- | --- |
 | **Project** | 目录、Git 分支、Commit 与 Tag、工作区状态、Git 操作状态（`MERGING`、`REBASING` 等）、差异指标、运行时、包版本、OS、用户 |
-| **Session** | 会话名称、Provider 与模型、Thinking 等级、轮次、会话时长 |
-| **Activity** | 正在运行的 Tool、已完成 Tool 计数、活跃 Agent、`Agent idle`、Skill、MCP Server |
-| **Usage** | Context 窗口与进度条、输入/输出 Token、缓存读写量与命中率、费用、模型限额、时间 |
+| **Session** | 会话名称、Provider 与模型、Thinking 等级、轮次、会话时长、时间 |
+| **Activity** | 正在运行的 Tool、已完成 Tool 计数、Skill、MCP Server |
+| **Usage** | Context 窗口与进度条、输入/输出 Token、缓存读写量与命中率、费用、模型限额 |
 
-行用 `/zentui row usage disable` 开关；行内每个状态段在同一界面里各有开关。使用旧版聚合开关 `tokens`、`toolActivity`、`agentActivity` 的配置会自动迁移。
+行用 `/hud row usage disable` 开关；行内每个状态段在同一界面里各有开关。使用旧版聚合开关 `tokens`、`toolActivity` 的配置会自动迁移。
 
 ### 模型限额
 
@@ -89,18 +92,20 @@ Usage 行跟随当前模型的 Provider：
 想换成单行脚注，设置模板即可：
 
 ```text
-/zentui format "$cwd( $git_branch)$fill($context)( $tokens)( $cost)"
+/hud format "$cwd( $git_branch)$fill($context)( $tokens)( $cost)"
 ```
 
-变量可以写成 `$name` 或 `${name}`。[脚注参考](footer.md)列出了全部变量和别名（`$directory`、`$status`、`$codex` 等）。不带参数的 `/zentui format`（或 `/zentui format clear`）恢复四行分组布局。
+变量可以写成 `$name` 或 `${name}`。[脚注参考](footer.md)列出了全部变量和别名（`$directory`、`$status`、`$codex` 等）。不带参数的 `/hud format`（或 `/hud format clear`）恢复四行分组布局。
 
 ## 配置
 
-`/zentui` 把配置写入 `~/.pi/agent/rinco-pi-hud.json`，改动立即生效。可配置分隔符样式、图标模式（`nerd`、`ascii`、`auto`）、脚注配色（Pi 主题色或终端调色板样式）、Context 渲染方式（文本、进度条或两者）、项目刷新间隔，以及第三方扩展状态的位置与颜色模式。
+本项目使用 `/hud`，把 `/zentui` 留给原版 Zentui，不保留旧命令别名。配置文件和现有设置不变。与原版搭配时，请将 Zentui 的 Footer 设为 Native，让本项目继续管理 HUD；详见[共存说明](footer.md#using-with-the-original-zentui)。
 
-脚注默认自动跟随当前 Pi 主题，包括手动切换主题和自动明暗切换。在 `/zentui` 中选择 **Footer colors → theme** 启用跟随，选择 **terminal** 则保留原有 Sakura RGB 配色。显式自定义颜色（十六进制、索引色或 `fg:`/`bg:` 样式）在两种模式下都会保留；删除 `colors` 中的相应配置即可恢复自动配色。
+`/hud` 把配置写入 `~/.pi/agent/rinco-pi-hud.json`，改动立即生效。可配置分隔符样式、图标模式（`nerd`、`ascii`、`auto`）、脚注配色（Pi 主题色或终端调色板样式）、Context 渲染方式（文本、进度条或两者）、项目刷新间隔，以及第三方扩展状态的位置与颜色模式。
 
-完整的变量与状态段参考见 [docs/footer.md](footer.md)。
+脚注默认自动跟随当前 Pi 主题，包括手动切换主题和自动明暗切换。在 `/hud` 中选择 **Footer colors → theme** 启用跟随，选择 **terminal** 则保留原有 Sakura RGB 配色。显式自定义颜色（十六进制、索引色或 `fg:`/`bg:` 样式）在两种模式下都会保留；删除 `colors` 中的相应配置即可恢复自动配色。
+
+已适配 Zentui **0.32.0** 的 Footer 新功能：仓库相对路径、`$join_sep` 条件分隔符、窄屏模板、扩展发布的自定义值、安全状态超链接，以及按需启用的 PR/CI 与平均 Token 速率。默认四行 HUD、原有配置及余额查询保持不变；不接管编辑器、消息、工作进度行或工具展示，也不引入 OMP 适配。同步快照和边界见[上游集成记录](upstream-zentui.md)，配置示例和完整变量参考见 [docs/footer.md](footer.md)。
 
 ## 仓库结构
 
@@ -113,11 +118,11 @@ Usage 行跟随当前模型的 Provider：
 | [`extensions/hud/telemetry/`](../extensions/hud/telemetry/format.ts) | 用量格式化、各家余额探测与 Codex 订阅客户端 |
 | [`extensions/hud/session/`](../extensions/hud/session/) | Pi 事件注册、会话生命周期与实时 Context 覆盖 |
 | [`extensions/hud/state/`](../extensions/hud/state/) | 聚合状态、Telemetry Reducer 与项目刷新 Controller |
-| [`extensions/hud/commands/`](../extensions/hud/commands/settings.ts) | `/zentui` 设置界面与配置 Controller |
+| [`extensions/hud/commands/`](../extensions/hud/commands/settings.ts) | `/hud` 设置界面与配置 Controller |
 | [`extensions/hud/ui/`](../extensions/hud/ui/) | 图标与终端样式工具 |
 | [`docs/footer.md`](footer.md) | 完整脚注配置参考 |
 | [`docs/CONTRIBUTING.md`](CONTRIBUTING.md) | 本地开发、测试规范和 PR 检查清单 |
-| [`tests/`](../tests/) | Vitest 测试套件：脚注布局、遥测、各家余额与 MCP 配置计数 |
+| [`tests/`](../tests/) | Vitest 测试套件：脚注布局、遥测、各家余额与 MCP 运行时工具计数 |
 
 ## 开发
 
@@ -152,19 +157,19 @@ npx tsx assets/readme/source/build-assets.mts /tmp/footer.json
 <details>
 <summary>窄终端里布局看起来不对</summary>
 
-脚注会测量终端宽度，只在状态段边界换行，所以窗口越窄，每行容纳的状态段越少。可以设置 `footerFormat` 模板，或在 `/zentui` 中关闭低优先级状态段。
+脚注会测量终端宽度，只在状态段边界换行，所以窗口越窄，每行容纳的状态段越少。可以设置 `footerFormat` 模板，或在 `/hud` 中关闭低优先级状态段。
 </details>
 
 <details>
 <summary>颜色显示异常</summary>
 
-默认配色自动跟随当前 Pi 主题。如果脚注仍使用固定颜色，请在 `/zentui` 中选择 **Footer colors → theme**，并删除 `~/.pi/agent/rinco-pi-hud.json` 中的显式颜色覆盖。设为 `original` 的第三方扩展状态会保留自己的颜色。Truecolor 与 256 色输出仍按 Pi 检测到的终端能力选择。
+默认配色自动跟随当前 Pi 主题。如果脚注仍使用固定颜色，请在 `/hud` 中选择 **Footer colors → theme**，并删除 `~/.pi/agent/rinco-pi-hud.json` 中的显式颜色覆盖。设为 `original` 的第三方扩展状态会保留自己的颜色。Truecolor 与 256 色输出仍按 Pi 检测到的终端能力选择。
 </details>
 
 <details>
 <summary>图标缺失或错位</summary>
 
-Unicode 与 Nerd Font 符号的显示效果因终端和字体而异。建议安装 Nerd Font，或在 `/zentui` 中切换到 ASCII 图标。
+Unicode 与 Nerd Font 符号的显示效果因终端和字体而异。建议安装 Nerd Font，或在 `/hud` 中切换到 ASCII 图标。
 </details>
 
 ## 许可证

package/docs/footer.md

@@ -7,30 +7,70 @@ When `footerFormat` is empty, the HUD displays four semantic groups:
 ```text
 Project  · pi-sakura ·  main ·  24.18
 Session  · gpt-5.3 · Thinking level: high · Turn 8
-Activity · Agent idle · Skill 2/3 · MCP 2
+Activity · Tool read × 4 · 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. 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 MCP segment uses Pi's public `pi.getAllTools()` API to count unique MCP namespaces with non-hidden registered tools, including direct, codemode, and deferred exposure. It includes file-configured and dynamically registered servers without reading `mcp.json`, resolving credentials, or creating connections. Hidden tools left behind after disabling or removing a server do not count. The value is read on each footer render (including normal project refreshes); zero hides the segment. This is a runtime tool-availability count, not a connection-health or configured-server count: resource-only servers and servers with no exposed tools are omitted, and a disconnected server may retain registered tools. Use Pi's `/mcp` for full connection status. `pi.getMcpServers()` is not used because it only lists extension registrations, not all configured servers. 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.
 
 Control each default-layout row independently:
 
 ```text
-/zentui row project enable
-/zentui row session disable
-/zentui row activity toggle
-/zentui row usage toggle
+/hud row project enable
+/hud row session disable
+/hud row activity toggle
+/hud row usage toggle
 ```
 
-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`.
+The command shape is `/hud 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`.
+
+## Using with the original Zentui
+
+This package registers `/hud`, not `/zentui`. The original Zentui keeps `/zentui`;
+the HUD has no legacy alias and still uses `rinco-pi-hud.json`.
+
+To use Zentui's User messages, Working line, or Tool display alongside the HUD,
+set Zentui's `components.footer.style` to `"native"` in
+`~/.pi/agent/zentui.json`. Native releases Zentui's Footer ownership without
+removing another extension's footer. Keep this package's status line enabled.
+Do not select Zentui Starship or Hidden while expecting the HUD to remain in control.
+
+Zentui components are independent. Disable its Editor, Thinking and selector borders
+unless wanted. With its Editor disabled, use Working line placement `"above"` rather
+than the editor-border placement. Tool display custom/MCP overrides and replacement
+of Bash renderers require separate consent; installing the package does not authorize them.
+
+## Footer modes
+
+- `/hud footer hud`: enable the normal four groups or configured templates.
+- `/hud footer hidden`: show only allowed third-party statuses, no row when none exist.
+- `/hud footer native`: release ownership to Pi; saved HUD choices remain unchanged.
+
+Hidden and HUD share the existing per-key `extensionStatuses` placement/color policy.
+Native is Pi-owned and does not apply this policy. `/hud layout`, `segments`, and
+`extensions` open the corresponding settings tabs directly.
+
+## Repository paths
+
+`pathDisplay` defaults to `{ "mode": "basename", "depth": 0 }`.
+Select `repository` in Layout → Path display, or set:
+
+```json
+{ "pathDisplay": { "mode": "repository", "depth": 2 } }
+```
+
+Repository root displays `.`; `/repo/packages/core/src` displays `…/core/src` at depth 2.
+Zero depth is unlimited. Worktrees are supported. Until a root qualified for the current cwd
+is available, missing/failed/unsafe roots fall back to the unlimited full path with home `~`
+abbreviation; a stale root is never used to produce a relative path.
 
 ## 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:
+To enable theme colors in an existing configuration, use **Footer colors → theme** in `/hud`, or set:
 
 ```json
 {
@@ -67,30 +107,28 @@ Entries you explicitly set under `colors` override the selected defaults. Semant
 | `sessionDuration` | off | Session | Current session duration |
 | `runningTools` | on | Activity | Currently running native tools and elapsed time |
 | `toolCounts` | on | Activity | Cumulative completed native-tool counts |
-| `activeAgents` | on | Activity | Active primary agent runs |
-| `agentIdle` | on | Activity | `Agent idle` when no primary agent run is active |
 | `skills` | on | Activity | Active/available skills count, e.g. `Skill 1/3` |
-| `mcp` | on | Activity | File-configured MCP servers, e.g. `MCP 2` |
+| `mcp` | on | Activity | MCP namespaces with exposed runtime tools, e.g. `MCP 2` |
 | `context` | on | Usage | Context percentage, window size, and/or gauge |
 | `inputTokens` | on | Usage | Cumulative input tokens |
 | `outputTokens` | on | Usage | Cumulative output tokens |
 | `cacheDetails` | on | Usage | Cache read/write tokens and latest hit rate |
 | `cost` | on | Usage | Cumulative session cost |
 | `codexUsage` | on | Usage | Codex weekly quota remaining |
-| `time` | off | Usage | Current time `HH:MM` |
+| `time` | off | Session | Current time `HH:MM`, after session duration |
 
 ## Template syntax
 
 Set a custom template:
 
 ```text
-/zentui format "$os  $cwd(  $git_branch)$fill($context)(  $tokens)(  $cost)"
+/hud format "$os  $cwd(  $git_branch)$fill($context)(  $tokens)(  $cost)"
 ```
 
 Clear it:
 
 ```text
-/zentui format clear
+/hud format clear
 ```
 
 ### Variables
@@ -99,6 +137,12 @@ Clear it:
 - `( ... )` — conditional group; hidden when all contained variables are empty
 - `$fill` — layout partition marker (0 = left only, 1 = left/right, 2 = left/middle/right)
 - `$sep` — styled ` | ` separator, does not cause a conditional group to show
+- `$join_sep` — insert the styled separator only between populated sibling fields
+
+For example, `$session_name$join_sep($git_branch $git_status)$join_sep$runtime` joins only
+populated fields, with no orphan separator when an intervening field is missing. Each group
+and top-level fill/wrap boundary has its own join scope. Do not pad `$join_sep` with spaces;
+the separator already owns spacing. Templates without it retain their previous behavior.
 
 ### Variable list
 
@@ -139,11 +183,16 @@ Clear it:
 | `$skills` | Active/available skills, e.g. `Skill 1/3` |
 | `$active_skills` | Active skills count only |
 | `$extensions` | Installed Pi packages count |
-| `$mcp` | File-configured MCP server count |
+| `$mcp` | MCP namespace count from Pi's exposed runtime tools |
 | `$tool_counts` | Native tool completion counts |
 | `$running_tools` | Recently running tools |
-| `$active_agents` | Active primary agent runs |
+| `$subscription` | Optional `(sub)` when Pi reports OAuth subscription use (also kimi-coding) |
+| `$auto_compaction` | Optional `(auto)` when public, trust-aware Pi settings report automatic compaction |
+| `$pr_number` / `$pr_url` | Current open GitHub PR number / plain HTTPS URL, qualified against local HEAD |
+| `$ci` | `CI passing`, `CI running`, `CI failed`, `CI no checks`, or `CI stale`; unavailable data is empty |
+| `$token_rate` | Current interaction’s completed-call average, e.g. `48 tok/s avg` |
 | `$sep` | Styled ` | ` |
+| `$join_sep` | Conditional sibling separator |
 | `$fill` | Layout marker, renders nothing |
 
 ### Aliases
@@ -158,13 +207,110 @@ $tag → $git_tag
 $duration → $session_duration
 $session → $session_name
 $thinking_level → $thinking
+$thinkingLevel → $thinking
+$codex_quota → $codex_usage
 $turn_count → $turn
 $codex → $codex_usage
 $tools → $tool_counts
-$agents → $active_agents
 $separator → $sep
 ```
 
+## Opt-in compact templates
+
+Set a separate narrow layout (used below 80 terminal columns):
+
+```text
+/hud compact-format "$cwd$wrap(on $git_branch)$fill$context$wrap_sep$tokens$wrap_sep$extension_statuses"
+```
+
+`$wrap` starts an independently packable chunk with a space boundary.
+`$wrap_sep` uses the configured default-layout separator only when chunks share a row.
+The first top-level `$fill` divides left/right zones; right-hand chunks have priority in
+template order and are right-aligned. Nested/additional fills do not create extra zones.
+`$extension_statuses` expands allowed third-party statuses into separate chunks; the existing
+`$extensions` still reports installed packages. Wide templates keep their existing status placements.
+
+`compactFooterMaxLines` defaults to 2 (range 1–8), and omitted/truncated chunks use `…`.
+Layout → Responsive compact controls `responsiveFooter`; an empty compact format is inert.
+Use `/hud compact-format clear` to return to the existing layout at every width.
+Custom templates and wide templates are otherwise unchanged; arbitrary narrow layouts cannot keep every field.
+
+## Custom extension values
+
+Alias stable publisher keys in JSON, then explicitly reference them in templates:
+
+```json
+{
+  "footerVariables": { "quota": "@scope/usage:quota" },
+  "customValueColorMode": "original",
+  "customValueColors": { "@scope/usage:quota": "bold success" },
+  "footerFormat": "$cwd$fill($quota)($sep$cost)",
+  "compactFooterFormat": "$cwd$fill($quota)$wrap_sep$context"
+}
+```
+
+Aliases cannot shadow builtins, builtin aliases, structural/prototype names, except an explicit
+`ci` alias may replace GitHub CI and suppress its query. At most 16 aliases are accepted.
+Unpublished/empty values drop optional groups. Nothing is automatically appended to templates.
+
+Original color mode preserves safe publisher SGR/HTTP(S) links; Zentui mode uses the current
+HUD extension-status color. `customValueColors` overrides are keyed by publisher ID across
+aliases: explicit styles replace publisher styling, `""` removes styling, and deleting a leaf
+restores inheritance. These JSON-only per-value overrides are independent of `setStatus()` colors.
+Layout → Custom value colors changes the shared mode.
+
+Publish through Pi's shared event bus using Zentui protocol v1:
+
+```typescript
+const key = "@scope/usage:quota";
+const capability = { supported: false, active: false, key };
+pi.events.emit("zentui:variable-capability", capability);
+if (capability.active) {
+  pi.events.emit("zentui:variable", { key, text: "Quota 80%" });
+  ctx.ui.setStatus(key, undefined); // remove only your own fallback
+} else {
+  ctx.ui.setStatus(key, "Quota 80%");
+}
+// Removal also works after demand becomes inactive:
+pi.events.emit("zentui:variable", { key, text: undefined });
+```
+
+Capability probes receive `supported: true`, `version: 1`, and current `active` demand.
+Probe again on each publisher refresh. Active means an owned, enabled current TUI Footer
+references the alias in its wide or enabled compact template, not guaranteed visibility at every width.
+Hidden/native/disabled/unowned consumers are inactive. Registry limits: 16 publisher keys,
+64 UTF-16 units per key, 256 per raw text. Inactive/malformed/oversized updates are ignored;
+empty text removes a value. Session replacement, shutdown or lost ownership/demand clears values.
+Publishers must republish on reactivation and own their refresh/freshness resources.
+A custom value is kept whole or omitted with template recomposition, never partially cropped.
+
+## Status hyperlinks and live metadata
+
+Third-party statuses in `original` mode preserve only SGR and HTTP(S) OSC 8 hyperlinks.
+Unsafe protocols, title, clipboard, cursor controls and embedded line breaks are stripped;
+links and styles are closed before adjacent content. Zentui mode strips publisher styling/links.
+
+```text
+/hud format "$cwd( · PR #$pr_number)( · $ci)$fill($token_rate)"
+```
+
+PR/CI collection is opt-in through template references and requires installed/authenticated
+`gh` plus an unambiguous `github.com` Git remote. No tools are installed or authenticated
+automatically, and no fetch/write is performed. Repository/head changes invalidate results;
+missing CLI/auth/PR, mismatched local/PR HEAD, detached HEAD or conflicting remotes yield empty values.
+A 30-second cache is refreshed by normal session/project synchronization, not an extra polling timer.
+A stale retained check snapshot shows `CI stale`. An explicit `ci` custom alias uses only publisher data.
+
+`$token_rate` divides completed output by observed model-call duration in the current interaction.
+It includes first-byte wait, excludes tools/gaps, and never estimates in-flight output speed.
+It retains completed values until the next interaction; incomplete measurements show `— tok/s avg`.
+
+Optional subscription and compaction markers use public Pi capabilities only and render empty
+when unavailable. Automatic compaction reads respect public project trust and are refreshed during
+normal Footer synchronization. They do not change Pi settings.
+
+See [the integration record](upstream-zentui.md) for the pinned source and differences from full Zentui.
+
 ## Model quota
 
 The status line automatically switches quota display based on model provider: