pi-minimal-footer 0.6.0 → 0.7.1

package/CHANGELOG.md

@@ -7,6 +7,35 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.7.1] - 2026-10-16
+
+### Fixed
+
+- Use the correct Copilot account credentials when displaying quota usage
+- Keep extension statuses on one footer line when they contain newlines or tabs
+
+- Cover Pi 1.3.0 in compatibility checks
+
+## [0.7.0] - 2026-10-13
+
+### Fixed
+
+- Remove an unused, completed implementation plan from the documentation
+
+### Added
+
+- Programmatically enable or disable the footer for the current session without changing saved settings:
+  ```typescript
+  pi.events.emit("pi-minimal-footer:set-enabled", { enabled: false }); // disable
+  pi.events.emit("pi-minimal-footer:set-enabled", { enabled: true });  // enable
+  ```
+
+### Changed
+
+- Strengthen TypeScript checks and make provider endpoint lookups explicit
+- Refine the package description and discovery keywords
+- Shorten the README introduction and use a thinner footer preview; keep the Pi package preview unchanged
+
 ## [0.6.0] - 2026-10-08
 
 ### Fixed
@@ -234,7 +263,9 @@ First npm-ready release.
 
 - Project scaffold — `extensions/index.ts` with basic footer structure, `package.json` with pi extension manifest, `README.md`, `LICENSE` (MIT)
 
-[Unreleased]: https://github.com/Ryu-CZ/pi-minimal-footer/compare/v0.6.0...HEAD
+[Unreleased]: https://github.com/Ryu-CZ/pi-minimal-footer/compare/v0.7.1...HEAD
+[0.7.1]: https://github.com/Ryu-CZ/pi-minimal-footer/compare/v0.7.0...v0.7.1
+[0.7.0]: https://github.com/Ryu-CZ/pi-minimal-footer/compare/v0.6.0...v0.7.0
 [0.6.0]: https://github.com/Ryu-CZ/pi-minimal-footer/compare/v0.5.3...v0.6.0
 [0.5.3]: https://github.com/Ryu-CZ/pi-minimal-footer/compare/v0.5.2...v0.5.3
 [0.5.2]: https://github.com/Ryu-CZ/pi-minimal-footer/compare/v0.5.1...v0.5.2

package/README.md

@@ -7,9 +7,9 @@
   <a href="https://pi.dev/packages/pi-minimal-footer"><img src="https://img.shields.io/badge/pi-package-1a1a2e" alt="pi package"></a>
 </p>
 
-Pi minimal footer is an opinionated, compact, one-line status bar for [Pi](https://github.com/earendil-works/pi).
+An opinionated, compact, one-line status bar for [Pi](https://github.com/earendil-works/pi).
 
-![Footer preview: ~/git/project   main        🧠 Karpathy  🪽 Icarus  model · 42/200k · [⣿⣿⣿⣤⠀⠀⠀⠀⠀⠀]↻1d8h](media/github-preview.png)
+![Footer preview: ~/git/project   main        🧠 Karpathy  🪽 Icarus  model · 42/200k · [⣿⣿⣿⣤⠀⠀⠀⠀⠀⠀]↻1d8h](media/preview.png)
 
 **Left**
 
@@ -116,6 +116,22 @@ Provided by other extensions; hidden with `showSkills: false`. Narrow terminals
 
 Only one footer extension can be active. For plugin integration, see [VISION.md](VISION.md#plugin-integration).
 
+## Programmatic control
+
+Other Pi extensions can enable or disable the footer for the current session without changing saved settings:
+
+```typescript
+pi.events.emit("pi-minimal-footer:set-enabled", { enabled: false }); // disable
+pi.events.emit("pi-minimal-footer:set-enabled", { enabled: true });  // enable
+```
+
+- Events work only while this extension's session is active.
+- The latest command or event wins.
+- `/minfooter on/off` saves your preference into config; events don't.
+- Enabling may replace another footer.
+- Disabling restores Pi's default footer if this footer is active; it leaves another extension's active footer untouched.
+- New sessions and `/reload` use your saved preference.
+
 ## Development & design
 
 Install from source:

package/VISION.md

@@ -113,6 +113,21 @@ Use a unique key. Pi requests a redraw when statuses change; no footer-specific
 
 Footer ownership is exclusive: another extension calling `ctx.ui.setFooter()` replaces this footer. Usage requests, new Git queries, and footer-owned timers stop on disposal; an in-flight Git query may complete, but lifecycle state refreshes alone never start one.
 
+#### Session-only footer control
+
+Extensions can temporarily override footer visibility without changing the user's saved setting:
+
+```typescript
+pi.events.emit("pi-minimal-footer:set-enabled", { enabled: false });
+pi.events.emit("pi-minimal-footer:set-enabled", { enabled: true });
+```
+
+Emit after this extension's `session_start` handler has run; events before startup or after shutdown are ignored. The payload must contain a boolean `enabled`; invalid payloads are ignored. Changes are silent and do not write settings.
+
+The latest explicit action wins: `/minfooter on/off` changes the current footer and saves the preference, while this event changes only the current session. Normal refreshes never undo the choice. A new session or extension reload starts from the saved preference.
+
+Disabling restores Pi's default footer only if we still own the active footer; otherwise it leaves the active footer untouched. Enabling explicitly installs our footer and may replace another extension's footer; repeated enables while we own it do nothing. Neither action restores a previous extension's footer. A coordinating extension must choose the active footer—there is no priority stack or automatic reactivation.
+
 ### Code map
 
 - `extensions/index.ts`: settings, plain state updates, active-footer refresh gate, layout, footer lifecycle, and `/minfooter`.

package/extensions/index.ts

@@ -262,6 +262,7 @@ function buildLine(
 export default function (pi: ExtensionAPI) {
   let config = readConfig();
   let enabled = config.enabled !== false;
+  let currentCtx: ExtensionContext | undefined;
   const state: FooterState = {
     cwd: process.cwd(), model: "no-model", context: "?", gitSync: "",
     gitInitialized: false, gitHighlighted: false, gitRequest: 0,
@@ -294,7 +295,6 @@ export default function (pi: ExtensionAPI) {
 
   function install(ctx: ExtensionContext): void {
     config = readConfig();
-    enabled = config.enabled !== false;
     if (ctx.mode !== "tui") { usageLimits.stop(); return; }
 
     if (!enabled) {
@@ -384,7 +384,7 @@ export default function (pi: ExtensionAPI) {
       return {
         render(width: number): string[] {
           const statuses = config.showSkills
-            ? [...footerData.getExtensionStatuses().values()].filter((s) => s.trim())
+            ? [...footerData.getExtensionStatuses().values()].map((s) => s.replace(/[\r\n\t]/g, " ")).filter((s) => s.trim())
             : [];
           const branch = config.showGitBranch ? footerData.getGitBranch() : null;
           const branchText = branch ? ` ${branch}${state.gitSync}` : "";
@@ -426,7 +426,19 @@ export default function (pi: ExtensionAPI) {
 
   // ── Lifecycle events (passive; no footer re-install) ────────────────
 
+  pi.events.on("pi-minimal-footer:set-enabled", (data) => {
+    if (!currentCtx || typeof data !== "object" || data === null ||
+        !("enabled" in data) || typeof data.enabled !== "boolean") return;
+    if (enabled === data.enabled && (!enabled || disposeFooter !== null)) return;
+    enabled = data.enabled;
+    updateState(currentCtx, state);
+    install(currentCtx);
+    refreshFooter();
+  });
+
   pi.on("session_start", async (_event, ctx) => {
+    currentCtx = ctx;
+    enabled = readConfig().enabled !== false;
     usageLimits.stop();
     updateState(ctx, state);
     install(ctx);
@@ -467,6 +479,7 @@ export default function (pi: ExtensionAPI) {
   });
 
   pi.on("session_shutdown", async () => {
+    currentCtx = undefined;
     usageLimits.stop();
     disposeFooter?.();
   });

package/extensions/lib/usage-limits.ts

@@ -197,7 +197,7 @@ export class UsageLimits {
     if (!this.ctx || this.request) return;
     const selected = this.selectedWindow();
     // Keep the sampled deadline when unrelated windows reschedule the timer.
-    let next = Math.max(this.attemptedAt, selected ? this.updatedAt[selected[0]] : 0) + this.refreshDelay;
+    let next = Math.max(this.attemptedAt, selected ? this.updatedAt[selected[0]] ?? 0 : 0) + this.refreshDelay;
     const resetAt = selected?.[1].resetAt;
     if (resetAt != null && resetAt > this.attemptedAt) next = Math.min(next, resetAt);
     this.timer = setTimeout(() => { this.timer = null; void this.poll(); }, Math.max(1, next - Date.now()));

package/extensions/lib/usage-providers.ts

@@ -73,6 +73,8 @@ function storedOAuth(provider: string): Record<string, unknown> {
 
 export async function usageRequest(ctx: ExtensionContext, model: NonNullable<ExtensionContext["model"]>): Promise<{ url: string; init: RequestInit } | null> {
   const provider = model.provider;
+  const url = ENDPOINTS[provider];
+  if (!url) return null;
   const auth = await ctx.modelRegistry.getApiKeyAndHeaders(model);
   if (!auth.ok) {
     // Pi exposes missing credentials as a message, alongside transient OAuth errors.
@@ -96,7 +98,9 @@ export async function usageRequest(ctx: ExtensionContext, model: NonNullable<Ext
   } else if (provider === "github-copilot") {
     // Quota API needs the GitHub login token, not the exchanged inference token.
     const refresh = storedOAuth(provider).refresh;
-    token = auth.env?.COPILOT_GITHUB_TOKEN ?? process.env.COPILOT_GITHUB_TOKEN ?? (typeof refresh === "string" ? refresh : undefined);
+    if (ctx.modelRegistry.isUsingOAuth?.(model) ?? typeof refresh === "string") {
+      token = typeof refresh === "string" ? refresh : undefined;
+    }
     Object.assign(headers, { "Editor-Version": "vscode/1.96.2", "User-Agent": "GitHubCopilotChat/0.26.7", "X-Github-Api-Version": "2025-04-01" });
   } else if (provider === "google-gemini-cli" && token?.startsWith("{")) {
     const credentials = record(JSON.parse(token));
@@ -110,7 +114,7 @@ export async function usageRequest(ctx: ExtensionContext, model: NonNullable<Ext
     init.body = "{}";
     headers["Content-Type"] = "application/json";
   }
-  return { url: ENDPOINTS[provider], init };
+  return { url, init };
 }
 
 function isObject(value: unknown): value is Record<string, unknown> {
@@ -148,7 +152,7 @@ export function parseUsageWindows(provider: string, model: string, payload: unkn
       recognized = true;
       if (data.rate_limit !== null && !isObject(data.rate_limit)) malformed = true;
       const limits = record(data.rate_limit);
-      for (const [key, name] of [["primary", "primary_window"], ["secondary", "secondary_window"]]) {
+      for (const [key, name] of [["primary", "primary_window"], ["secondary", "secondary_window"]] as const) {
         add(key, limits[name], (w) => windowFrom(number(w.used_percent),
           Object.hasOwn(w, "limit_window_seconds") ? number(w.limit_window_seconds) ?? NaN : undefined,
           resetSeconds(w.reset_at) ?? relativeReset(w.reset_after_seconds)));

package/package.json

@@ -1,13 +1,17 @@
 {
   "name": "pi-minimal-footer",
-  "version": "0.6.0",
-  "description": "An opinionated minimal footer extension for Pi — clean status line with path, extension statuses, model, and context usage.",
+  "version": "0.7.1",
+  "description": "An opinionated minimal Pi footer - one-line status bar showing subscription usage, path, status, model and context.",
   "keywords": [
+    "footer",
+    "minimal",
+    "usage",
+    "limits",
+    "status-bar",
+    "one-line",
     "pi-package",
     "pi-extension",
-    "pi",
-    "footer",
-    "minimal"
+    "pi"
   ],
   "homepage": "https://github.com/Ryu-CZ/pi-minimal-footer#readme",
   "bugs": {