pi-observability 1.3.0 → 1.3.1

package/README.md

@@ -4,15 +4,15 @@ A [pi](https://github.com/mariozechner/pi) extension that replaces the default f
 
 ## Features
 
-- **Live footer bar** showing:
-  - Session input/output tokens & estimated cost
-  - Live TPS (tokens per second) during streaming
-  - Session runtime
-  - Current model, thinking level, fast mode & git branch
-  - Git diff stats (added/removed lines)
-  - Context usage (current / max)
-  - **Thinking level colors match pi's input field** — off/low/medium/high use the same theme colors as the editor border
-  - **Rainbow mode** — `xhigh` and `max` thinking levels render the model indicator in cycling rainbow colors
+- **Live footer bar** — Fully customizable status bar with configurable segments, layout presets, and context-zone thresholds:
+  - **Model & thinking level** — Colors match pi's input field (off/low/medium/high). `xhigh`/`max` renders in rainbow
+  - **Session runtime**
+  - **Working directory** — Toggle between folder name or full path
+  - **Git branch & diff stats** — Added/removed lines
+  - **Context usage** — Progress bar + percentage + token count, with color-coded zones
+  - **Session tokens** — Input/output totals
+  - **Live TPS** — During streaming (chunk-based estimate)
+  - **Estimated cost**
 
 - **`/obs` command** — Full-screen TUI dashboard with per-turn breakdowns and last 10 session history. Renders through pi's native TUI (no console spam), with theme-aware borders and dynamic terminal width.
 
@@ -20,33 +20,58 @@ A [pi](https://github.com/mariozechner/pi) extension that replaces the default f
 
 - **`/obs-toggle` command** — Toggle the live footer on/off
 
-## Preview
-
-### Screed recording
-
-> GitHub does not render inline MP4 players in `README.md`, so here's a short animated preview. Click it to open the full recording.
+- **`/obs-settings` command** — Interactive TUI for customizing the footer: choose from 4 layout presets or toggle individual segments and set context-usage warning thresholds
 
-[![Animated preview of pi-observability](./demo-preview.gif)](./output.mp4)
+## Preview
 
-[Open the full screed recording (MP4)](./output.mp4)
+![pi-observability demo](./demo-preview.gif)
 
 ### Footer
 
 Compact single-line layout that falls back to two lines when the terminal is narrow:
 
 ```
-gpt-5.5:high ▸ ⏱ 12:34 ▸ 📁 my-app ▸  main +42 -7 ▸ ctx 4.2k/200k ▸ ↑1.2k ↓3.4k ▸ ⚡45.2 ▸ $0.0042
+gpt-5.5:high ▸ ⏱ 12:34 ▸ 📁 my-app ▸  main +42 -7 ▸ ctx [████░░░░░░] 42% 4.2k/200k ▸ ↑1.2k ↓3.4k ▸ $0.0042
 ```
 
 With `xhigh` or `max` thinking, the model name renders in rainbow:
 
 ```
-gpt-5.5:xhigh ▸ ⏱ 12:34 ▸ 📁 my-app ▸ ↑1.2k ↓3.4k ▸ ⚡45.2 ▸ $0.0042
+gpt-5.5:xhigh ▸ ⏱ 12:34 ▸ 📁 my-app ▸ ↑1.2k ↓3.4k ▸ $0.0042
 ```
 
-### Git diff in the status bar
+#### Settings
+
+Run `/obs-settings` to open the interactive settings panel:
+
+| Preset | Description |
+|--------|-------------|
+| `minimal` | Model, context usage (bar + numbers), cost only |
+| `standard` | Everything except TPS (default) |
+| `verbose` | All segments on |
+| `performance` | Model, context %, TPS, cost |
+
+Individual segments you can toggle:
+
+- **Model & Thinking** — Model name + thinking level
+- **Runtime** — Session timer
+- **Working Directory** — Current folder or full path (`/obs-toggle-path`)
+- **Git Branch & Diff** — Branch name + added/removed line counts
+- **Context Usage** — Master toggle with 3 sub-options:
+  - Progress bar (`[████░░░░░░]`)
+  - Percentage
+  - Token count (`used/total`)
+- **Session Tokens** — Total input/output
+- **TPS** — Live during streaming, last-turn when idle
+- **Cost** — Estimated session cost
+
+Context-usage color zones (configurable):
 
-![Git diff in the footer status bar](./diff.png)
+| Zone | Default | Color |
+|------|---------|-------|
+| Normal | ≤ 70% | Green |
+| Expert | 71–85% | Yellow |
+| Warning | > 85% | Red |
 
 ### Dashboard (`/obs`)
 
@@ -104,6 +129,7 @@ cp -r extensions/* ~/.pi/agent/extensions/
 | `/obs` | Open full observability dashboard in TUI overlay |
 | `/obs-toggle` | Toggle the observability footer on/off |
 | `/obs-toggle-path` | Toggle between folder name and full path in footer |
+| `/obs-settings` | Open interactive footer settings (presets, segments, context zones) |
 
 ## Migration from TPS
 

package/extensions/lib/footer-engine/format.ts

@@ -1,5 +1,5 @@
 import { homedir } from "node:os";
-import type { ThemeColor } from "@mariozechner/pi-coding-agent";
+import type { ThemeColor } from "@earendil-works/pi-coding-agent";
 
 export function fmtDuration(ms: number): string {
   if (!Number.isFinite(ms) || ms < 0) ms = 0;

package/extensions/lib/footer-engine/layout.ts

@@ -1,4 +1,4 @@
-import { visibleWidth, truncateToWidth } from "@mariozechner/pi-tui";
+import { visibleWidth, truncateToWidth } from "@earendil-works/pi-tui";
 import type { LayoutAssembler } from "./types.js";
 
 export const defaultAssembler: LayoutAssembler = (segments, width, theme) => {

package/extensions/lib/footer-engine/segments.ts

@@ -11,12 +11,13 @@ import {
 
 export const builtinRenderers: Record<string, SegmentRenderer> = {
   modelThink(input) {
-    const { model, thinkingLevel, theme } = input;
+    const { model, thinkingLevel, fastModeEnabled, serviceTier, theme } = input;
     const text = `${model}:${thinkingLevel}`;
+    const tier = fastModeEnabled ? theme.fg("accent", ` ⚡${serviceTier ?? "fast"}`) : "";
     if (thinkingLevel === "xhigh" || thinkingLevel === "max") {
-      return rainbowText(text);
+      return rainbowText(text) + tier;
     }
-    return theme.fg(thinkingColor(thinkingLevel), text);
+    return theme.fg(thinkingColor(thinkingLevel), text) + tier;
   },
 
   runtime(input) {

package/extensions/lib/footer-engine/types.ts

@@ -1,4 +1,4 @@
-import type { ContextUsage, Theme as PiTheme } from "@mariozechner/pi-coding-agent";
+import type { ContextUsage, Theme as PiTheme } from "@earendil-works/pi-coding-agent";
 
 export type SegmentKey =
   | "modelThink"
@@ -29,6 +29,9 @@ export interface FooterInput {
   totalInputTokens: number;
   totalOutputTokens: number;
   totalCost: number;
+  fastModeSupported: boolean;
+  fastModeEnabled: boolean;
+  serviceTier: string | null;
   contextUsage: ContextUsage | null;
   cwd: string;
   showFullPath: boolean;

package/extensions/observability.ts

@@ -20,13 +20,19 @@
 
 import { homedir } from "node:os";
 import { join } from "node:path";
-import type { AssistantMessage } from "@mariozechner/pi-ai";
+import type { AssistantMessage } from "@earendil-works/pi-ai";
 import type {
   ExtensionAPI,
   ExtensionContext,
   Theme as PiTheme,
-} from "@mariozechner/pi-coding-agent";
-import { Key, matchesKey, SettingsList, truncateToWidth, visibleWidth } from "@mariozechner/pi-tui";
+} from "@earendil-works/pi-coding-agent";
+import {
+  Key,
+  matchesKey,
+  SettingsList,
+  truncateToWidth,
+  visibleWidth,
+} from "@earendil-works/pi-tui";
 
 import {
   loadSettings,
@@ -127,18 +133,20 @@ function getStringProp(value: unknown, key: string): string | undefined {
 
 function getServiceTierFromPayload(payload: unknown): string | null {
   const tier = getStringProp(payload, "service_tier") ?? getStringProp(payload, "serviceTier");
-  return tier?.trim() || null;
+  return tier?.trim().toLowerCase() || null;
+}
+
+function isFastServiceTier(serviceTier: string | null): boolean {
+  // OpenAI's actual fast/priority tier is `priority`. Older/local shims may
+  // still emit `fast`, so keep accepting it for backwards-compatible display.
+  return serviceTier === "priority" || serviceTier === "fast";
 }
 
 function supportsFastMode(ctx: ExtensionContext): boolean {
   const model = ctx.model;
   if (!model) return false;
-  if (model.api !== "openai-codex-responses") return false;
-  return (
-    model.provider === "openai-codex" ||
-    model.provider === "openai" ||
-    model.id.toLowerCase().includes("gpt-5.5")
-  );
+  if (model.provider !== "openai" && model.provider !== "openai-codex") return false;
+  return model.api === "openai-responses" || model.api === "openai-codex-responses";
 }
 
 /* ───── Dashboard formatting ───── */
@@ -168,6 +176,9 @@ function buildDashboard(
     branch
       ? `Branch: ${branch}    Model: ${ctx.model?.id ?? "none"}`
       : `Model: ${ctx.model?.id ?? "none"}`,
+    state.serviceTier
+      ? `Service tier: ${state.serviceTier}${state.fastModeEnabled ? " (fast)" : ""}`
+      : `Fast mode: ${state.fastModeSupported ? "available" : "not available"}`,
     `Tokens: ↑${fmtTokens(totalIn)} ↓${fmtTokens(totalOut)}`,
     `Cost: $${totalCost.toFixed(6)}`,
   ];
@@ -345,8 +356,8 @@ export default function (pi: ExtensionAPI) {
   });
 
   pi.on("before_provider_request", async (event, ctx) => {
-    state.serviceTier = getServiceTierFromPayload(event.payload)?.toLowerCase() ?? null;
-    state.fastModeEnabled = state.serviceTier === "fast";
+    state.serviceTier = getServiceTierFromPayload(event.payload);
+    state.fastModeEnabled = isFastServiceTier(state.serviceTier);
     state.fastModeSupported = supportsFastMode(ctx) || state.fastModeEnabled;
   });
 
@@ -539,6 +550,9 @@ export default function (pi: ExtensionAPI) {
             totalInputTokens: totalIn,
             totalOutputTokens: totalOut,
             totalCost,
+            fastModeSupported: state.fastModeSupported,
+            fastModeEnabled: state.fastModeEnabled,
+            serviceTier: state.serviceTier,
             contextUsage: ctx.getContextUsage() ?? null,
             cwd: ctx.cwd,
             showFullPath: state.showFullPath,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-observability",
-  "version": "1.3.0",
+  "version": "1.3.1",
   "description": "Live observability dashboard for pi coding agent sessions — tokens, cost, TPS, runtime, git stats, and context usage",
   "keywords": [
     "cli",
@@ -37,17 +37,17 @@
     "publish:pkg": "npm publish"
   },
   "devDependencies": {
-    "@mariozechner/pi-ai": "latest",
-    "@mariozechner/pi-coding-agent": "latest",
-    "@mariozechner/pi-tui": "latest",
+    "@earendil-works/pi-ai": "latest",
+    "@earendil-works/pi-coding-agent": "latest",
+    "@earendil-works/pi-tui": "latest",
     "oxfmt": "^0.47.0",
     "oxlint": "^1.62.0",
     "typescript": "^5.4.0"
   },
   "peerDependencies": {
-    "@mariozechner/pi-ai": "*",
-    "@mariozechner/pi-coding-agent": "*",
-    "@mariozechner/pi-tui": "*"
+    "@earendil-works/pi-ai": "*",
+    "@earendil-works/pi-coding-agent": "*",
+    "@earendil-works/pi-tui": "*"
   },
   "pi": {
     "extensions": [