pi-harness-runtime 0.9.7 → 0.9.11

package/CHANGELOG.md

@@ -2,8 +2,19 @@
 
 All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
 
-### [0.9.7](https://github.com/ManotLuijiu/pi-harness-runtime/compare/v0.9.5...v0.9.7) (2026-07-16)
+### [0.9.11](https://github.com/ManotLuijiu/pi-harness-runtime/compare/v0.9.8...v0.9.11) (2026-07-23)
+
+### Bug Fixes
+
+* **release:** test workflow trigger via manual version bump
+* **tests:** update footer-status expectations for provider label prefix
+* **tests:** mirror round-trip expects per-provider shape + source field
 
+### [0.9.8](https://github.com/ManotLuijiu/pi-harness-runtime/compare/v0.9.5...v0.9.8) (2026-07-23)
+
+### Features
+
+* **cookie-sanitizer:** discoverable drop folder + per-provider mirror ([772eda5](https://github.com/ManotLuijiu/pi-harness-runtime/commit/772eda5c5c698572a1cef2dc93df0278e9a380ee))
 
 ### Bug Fixes
 
@@ -12,6 +23,18 @@ All notable changes to this project will be documented in this file. See [standa
 
 ### [0.9.3](https://github.com/ManotLuijiu/pi-harness-runtime/compare/v0.5.0-beta.1...v0.9.3) (2026-07-14)
 
+### Bug Fixes
+
+* auto-resume pi dev with literal resume ([#51](https://github.com/ManotLuijiu/pi-harness-runtime/issues/51)) ([fd98762](https://github.com/ManotLuijiu/pi-harness-runtime/commit/fd987629f6062a4a7ff7a28d9dfb607962f5a4a9))
+
+### [0.9.7](https://github.com/ManotLuijiu/pi-harness-runtime/compare/v0.9.5...v0.9.7) (2026-07-16)
+
+### Bug Fixes
+
+* harden auto-resume after compaction ([13378e8](https://github.com/ManotLuijiu/pi-harness-runtime/commit/13378e852c984ead0e66f0adeffc073ff58af50c))
+* resume after output-limit error stops ([8c75a24](https://github.com/ManotLuijiu/pi-harness-runtime/commit/8c75a2432082c4f9ba6296ffe2d04b636863bf2f))
+
+### [0.9.3](https://github.com/ManotLuijiu/pi-harness-runtime/compare/v0.5.0-beta.1...v0.9.3) (2026-07-14)
 
 ### Bug Fixes
 
@@ -19,21 +42,18 @@ All notable changes to this project will be documented in this file. See [standa
 
 ### [0.9.6](https://github.com/ManotLuijiu/pi-harness-runtime/compare/v0.9.5...v0.9.6) (2026-07-16)
 
-
 ### Bug Fixes
 
 * harden auto-resume after compaction ([13378e8](https://github.com/ManotLuijiu/pi-harness-runtime/commit/13378e852c984ead0e66f0adeffc073ff58af50c))
 
 ### [0.9.3](https://github.com/ManotLuijiu/pi-harness-runtime/compare/v0.5.0-beta.1...v0.9.3) (2026-07-14)
 
-
 ### Bug Fixes
 
 * auto-resume pi dev with literal resume ([#51](https://github.com/ManotLuijiu/pi-harness-runtime/issues/51)) ([fd98762](https://github.com/ManotLuijiu/pi-harness-runtime/commit/fd987629f6062a4a7ff7a28d9dfb607962f5a4a9))
 
 ### [0.9.5](https://github.com/ManotLuijiu/pi-harness-runtime/compare/v0.9.4...v0.9.5) (2026-07-15)
 
-
 ### Features
 
 * add 15 packages from subagent batch + test expansions ([c82d898](https://github.com/ManotLuijiu/pi-harness-runtime/commit/c82d898277779886cdd1f7f42087698762becde3))
@@ -45,14 +65,12 @@ All notable changes to this project will be documented in this file. See [standa
 * add package metadata for auth, scheduler, shared-context, token-estimation ([67e2621](https://github.com/ManotLuijiu/pi-harness-runtime/commit/67e26211633f01de4f0d5eca76abc4d40d1ee0ea))
 * flesh out RFC 71-75 specs + fix codex-adapter LSP types ([38b8643](https://github.com/ManotLuijiu/pi-harness-runtime/commit/38b86438ef45f75d1c34caf5b4f401d29c76d44d))
 
-
 ### Bug Fixes
 
 * auto-resume after compaction and output limits ([0cff2bc](https://github.com/ManotLuijiu/pi-harness-runtime/commit/0cff2bcf9035a699496e2726b74a1576863cf82e))
 
 ### [0.9.4](https://github.com/ManotLuijiu/pi-harness-runtime/compare/v0.5.0-beta.1...v0.9.4) (2026-07-14)
 
-
 ### Features
 
 * configure Dependabot to target develop with auto-merge ([9e12b46](https://github.com/ManotLuijiu/pi-harness-runtime/commit/9e12b4620179b91d2dc1a4627e199920d3890f31))
@@ -60,7 +78,6 @@ All notable changes to this project will be documented in this file. See [standa
 * RFC-0052 skill-registry gap fixes + 40 new RFCs (0061-0100) ([6defd26](https://github.com/ManotLuijiu/pi-harness-runtime/commit/6defd26ff931fb9f93548647bf3a76098aa1d48b))
 * RFC-0060 memory-engine fixes + simplify auto-resume ([#52](https://github.com/ManotLuijiu/pi-harness-runtime/issues/52)) ([fb4de1a](https://github.com/ManotLuijiu/pi-harness-runtime/commit/fb4de1a9d1de74b875aabb58d0c06f7116994ca3))
 
-
 ### Bug Fixes
 
 * collapse duplicate version keys in workspace package.json files ([f3a7289](https://github.com/ManotLuijiu/pi-harness-runtime/commit/f3a728923a96308296e45d7ce3db8fe3ad36780a))
@@ -69,12 +86,10 @@ All notable changes to this project will be documented in this file. See [standa
 
 ### [0.9.1](https://github.com/ManotLuijiu/pi-harness-runtime/compare/v0.7.1...v0.9.1) (2026-07-13)
 
-
 ### Features
 
 * **release:** add synced-workspace release script ([617649d](https://github.com/ManotLuijiu/pi-harness-runtime/commit/617649d0b2227ebb4355eec4979b0c65822d60e3))
 
-
 ### Bug Fixes
 
 * publish missing runtime modules ([3fc7058](https://github.com/ManotLuijiu/pi-harness-runtime/commit/3fc70586d0cd10f4d38eab67e4cadaec20aaeb56))
@@ -82,19 +97,16 @@ All notable changes to this project will be documented in this file. See [standa
 
 ## [0.9.0](https://github.com/ManotLuijiu/pi-harness-runtime/compare/v0.7.1...v0.9.0) (2026-07-13)
 
-
 ### Features
 
 * **release:** add synced-workspace release script ([617649d](https://github.com/ManotLuijiu/pi-harness-runtime/commit/617649d0b2227ebb4355eec4979b0c65822d60e3))
 
-
 ### Bug Fixes
 
 * **release:** remove redundant Bump version step — was double-bumping version (0.7.1→0.8.0) when tag pushed ([413ad6d](https://github.com/ManotLuijiu/pi-harness-runtime/commit/413ad6d49356ec62b94e9a4e09d3475ef39bebd6))
 
 ### [0.7.1](https://github.com/ManotLuijiu/pi-harness-runtime/compare/v0.6.3...v0.7.1) (2026-07-13)
 
-
 ### Bug Fixes
 
 * **release:** set make_latest=true so new releases auto-mark as Latest ([26a7bb9](https://github.com/ManotLuijiu/pi-harness-runtime/commit/26a7bb98f3e603a9d68cbf39ca1558bc579d1a4a))

package/README.md

@@ -191,9 +191,26 @@ bun test   # 131+ tests passing
 
 ## Automatic Quota Fetching
 
-Quota data is automatically fetched from MiniMax console every 5 minutes:
+Quota data is automatically surfaced per-provider:
 
-1. **Setup cookies** (one-time):
+| Provider | Source | Cadence |
+|---|---|---|
+| MiniMax | Playwright + cookies (continuous scrape) | every ~15 min |
+| OpenAI / OpenAI Codex | TUI message capture (signal on limit) | on first limit hit |
+| GLM (Z.ai / Zhipu) | TUI message capture (signal on limit) | on first limit hit |
+| Anthropic | TUI message capture (signal on limit) | on first limit hit |
+| OpenRouter | TUI message capture (signal on limit) | on first limit hit |
+| Other / unknown | (no data — footer shows hint) | — |
+
+The footer line carries the provider label, so you always know which LLM the data is from:
+
+```
+MiniMax:  5h: 92% left · week: 80% left           # continuous (scrape)
+OpenAI:   5h: -- · week: -- (no signal yet)        # pending first limit hit
+GLM:      limit hit (tokens), reset 2026-07-23T17:28:00Z   # TUI signal observed
+```
+
+1. **MiniMax setup** (one-time):
 
    ```bash
    # Install EditThisCookie Chrome extension
@@ -202,13 +219,33 @@ Quota data is automatically fetched from MiniMax console every 5 minutes:
    # Save to ~/.config/minimax-cookies.txt
    ```
 
-2. **Environment** (optional):
+   **Recommended:** drop the file into the dedicated cookie folder. The runtime
+   normalizes any format (Netscape or EditThisCookie JSON, any filename) on its own:
+
+   ```bash
+   # Save cookies as any name, any format into:
+   mkdir -p ~/.pi-harness-runtime/cookies
+   cp ~/Downloads/platform.minimax.io_cookies.txt ~/.pi-harness-runtime/cookies/
+   # …or use the EditThisCookie extension export (JSON) — same folder works.
+   ```
+
+   The `cookie-sanitizer` package (`@pi-harness/cookie-sanitizer`) runs chokidar v5 on this
+   folder, normalizes everything to standard Netscape, and writes the canonical cache at
+   `~/.config/minimax-cookies.txt`. Live update latency: <1 second after drop.
+
+2. **Other providers**: no setup needed. The runtime reads messages from the active
+   session and captures quota-exhaustion signals from the TUI. Once any limit is hit
+   (e.g. `OpenAI: context length exceeded, reset in 3 hr 27 min`), the footer updates
+   immediately and the data persists across `~/.pi/usage-status/mirror.json`.
+
+3. **Environment** (optional override):
 
    ```bash
-   export QUOTA_COOKIE_FILE=~/.config/minimax-cookies.txt
+   export QUOTA_COOKIE_FILE=/path/to/your/cookies.txt
+   # When set, the sanitizer is bypassed and the scraper reads this file directly.
    ```
 
-3. **Done!** Quota auto-refreshes every 5 minutes
+4. **Done!** Quota auto-refreshes every 5 minutes. Cookie file changes sync within ~1 second.
 
 ## Roadmap
 

package/footer-status.ts

@@ -1,4 +1,4 @@
-import type { MirrorRecord } from "./mirror.ts";
+import type { MirrorRecord, ProviderMirrorRecord } from "./mirror.ts";
 import { formatQuotaStatus } from "./harness/e2e/quota-status.js";
 import {
 	parseContextWindowStatusLine,
@@ -39,29 +39,126 @@ export function parseFooterStatusValue(value: string): ParsedFooterStatusValue {
 	return { kind: "unknown", value: null };
 }
 
+/** Display name for a provider id. Used as the footer label. */
+function providerDisplayName(provider: string | null | undefined): string {
+	if (!provider) return "Provider";
+	switch (provider) {
+		case "minimax":
+			return "MiniMax";
+		case "openai":
+			return "OpenAI";
+		case "openai-codex":
+			return "OpenAI Codex";
+		case "glm":
+			return "GLM";
+		case "anthropic":
+			return "Anthropic";
+		case "openrouter":
+			return "OpenRouter";
+		default:
+			return provider;
+	}
+}
+
+/** Hint shown when the provider has no usage data yet. */
+function missingDataHint(
+	provider: string | null | undefined,
+	hasCookieSource: boolean,
+): string {
+	if (provider === "minimax") {
+		return "drop minimax cookies into ~/.pi-harness-runtime/cookies/";
+	}
+	if (provider === "openai-codex") {
+		return "will update on first TUI limit signal";
+	}
+	if (
+		provider === "openai" ||
+		provider === "glm" ||
+		provider === "anthropic" ||
+		provider === "openrouter"
+	) {
+		return "no signal yet (updates on first limit hit)";
+	}
+	if (!hasCookieSource) return "no usage source configured";
+	return "no data yet";
+}
+
+/** Normalize an unknown mirror record into a ProviderMirrorRecord view. */
+function toProviderView(
+	mirror: MirrorRecord | ProviderMirrorRecord | null,
+): ProviderMirrorRecord | null {
+	if (!mirror) return null;
+	const m = mirror as ProviderMirrorRecord;
+	if (typeof m.provider === "string") return m;
+	// Legacy flat-shape: already a single record without a provider wrapper.
+	return {
+		synced_at: m.synced_at ?? new Date().toISOString(),
+		provider: (m as MirrorRecord).provider ?? "",
+		source: "scrape",
+		model: (m as MirrorRecord).model,
+		h5_used_pct: (m as MirrorRecord).h5_used_pct,
+		h5_resets_at: (m as MirrorRecord).h5_resets_at,
+		weekly_used_pct: (m as MirrorRecord).weekly_used_pct,
+		weekly_resets_at: (m as MirrorRecord).weekly_resets_at,
+	};
+}
+
 export function buildFooterStatusValue(
 	local: { today: { tokens: number; cost: number } },
-	mirror: MirrorRecord | null,
+	mirror: MirrorRecord | ProviderMirrorRecord | null,
 	freshness: "fresh" | "stale" | "expired" | "missing",
+	hasCookieSource: boolean = true,
+	activeProvider: string | null = null,
 ): string {
+	const view = toProviderView(mirror);
+	const provider = activeProvider ?? view?.provider ?? null;
+	const label = providerDisplayName(provider);
+
+	// Continuous data path: a fresh record has 5h or weekly percentages.
 	if (
-		mirror &&
+		view &&
 		freshness !== "expired" &&
-		(mirror.h5_used_pct !== undefined || mirror.weekly_used_pct !== undefined)
+		(view.h5_used_pct !== undefined || view.weekly_used_pct !== undefined)
 	) {
 		const quotaStatus = formatQuotaStatus({
-			provider: "minimax",
-			h5UsedPct: mirror.h5_used_pct ?? 0,
-			h5ResetsAt: mirror.h5_resets_at,
-			weeklyUsedPct: mirror.weekly_used_pct ?? 0,
-			weeklyResetsAt: mirror.weekly_resets_at,
-			scrapedAt: mirror.synced_at,
+			provider: (provider ?? "minimax") as "minimax",
+			h5UsedPct: view.h5_used_pct ?? 0,
+			h5ResetsAt: view.h5_resets_at,
+			weeklyUsedPct: view.weekly_used_pct ?? 0,
+			weeklyResetsAt: view.weekly_resets_at,
+			scrapedAt: view.synced_at,
 		});
 		const freshnessSuffix =
 			freshness === "fresh" || freshness === "missing" ? "" : ` · ${freshness}`;
-		return `${quotaStatus.extended}${freshnessSuffix}`;
+		return `${label}: ${quotaStatus.extended}${freshnessSuffix}`;
+	}
+
+	// TUI-signal path: an exhausted record from a limit hit.
+	if (
+		view &&
+		view.exhausted &&
+		(view.limitType !== undefined || view.resets_at !== undefined)
+	) {
+		const reset = view.resets_at ?? view.h5_resets_at ?? "soon";
+		return `${label}: limit hit (${view.limitType ?? "tokens"}), reset ${reset}`;
+	}
+
+	// Discoverable hint when we have no data yet.
+	if (
+		provider &&
+		(!view || freshness === "expired" || freshness === "missing")
+	) {
+		const hint = missingDataHint(provider, hasCookieSource);
+		// MiniMax-on-fresh-machine still gets the cookie hint; for others
+		// the hint explains the signal-driven design.
+		if (provider === "minimax" && !hasCookieSource) {
+			return `${label}: 5h: -- (${hint})`;
+		}
+		return `${label}: 5h: -- · week: -- (${hint})`;
 	}
 
+	// Silent fallback: only reached if we genuinely don't know the provider.
+	// No "5h/week: --" line here because we'd be making up data.
 	const todayStr = `${(local.today.tokens / 1000).toFixed(1)}k tok · $${local.today.cost.toFixed(3)}`;
 	return `today: ${todayStr}`;
 }

package/harness/e2e/minimax-quota-scraper.ts

@@ -10,7 +10,7 @@
  * - Capture API responses for usage data
  */
 
-import { existsSync, readFileSync } from "node:fs";
+import { existsSync, readFileSync, readdirSync, statSync } from "node:fs";
 import { join } from "node:path";
 import { homedir } from "node:os";
 import { parseMiniMaxQuotaText } from "./minimax-quota-parser.js";
@@ -385,10 +385,19 @@ export class MiniMaxQuotaScraper {
 			throw new Error(msg);
 		}
 
+		// Pre-load the canonical cache so that the runtime-owned file
+		// (written by packages/cookie-sanitizer) takes precedence over
+		// whatever `this.config.cookieFile` points at. Both eventually
+		// resolve to the same standard Netscape format.
 		const cookies = loadNetscapeCookies(this.config.cookieFile!);
 
 		if (cookies.length === 0) {
-			const msg = `No cookies found in ${this.config.cookieFile}\nExport cookies from browser in Netscape format.`;
+			const dropHint = join(homedir(), ".pi-harness-runtime", "cookies");
+			const msg =
+				`No cookies found.\n` +
+				`Drop your platform.minimax.io cookies (Netscape or EditThisCookie JSON) into:\n` +
+				`  ${dropHint}\n` +
+				`…or run: bun packages/auth/src/run-minimax-auth.ts auth`;
 			if (!this.config.quiet) console.error("[MiniMaxQuotaScraper] " + msg);
 			throw new Error(msg);
 		}
@@ -474,10 +483,43 @@ export class MiniMaxQuotaScraper {
 	}
 
 	/**
-	 * Check if cookie file exists
+	 * Check if any cookie source exists.
+	 *
+	 * "Source" can be either:
+	 *   - the canonical cache (this.config.cookieFile) — runtime-owned,
+	 *     populated by packages/cookie-sanitizer
+	 *   - the user-facing drop folder — ~/.pi-harness-runtime/cookies/
+	 *     — populated by humans (any name, any format)
+	 *
+	 * Either is enough to attempt the scrape.
 	 */
 	hasCookieFile(): boolean {
-		return existsSync(this.config.cookieFile!);
+		// Canonical cache present?
+		if (existsSync(this.config.cookieFile!)) return true;
+
+		// Drop folder has anything readable? (Sync would normalize it on the next trigger.)
+		try {
+			const dropDir = join(homedir(), ".pi-harness-runtime", "cookies");
+			if (existsSync(dropDir)) {
+				const entries = readdirSync(dropDir);
+				if (entries.length > 0) return true;
+				// One-level walk into subfolders.
+				for (const name of entries) {
+					try {
+						if (statSync(join(dropDir, name)).isDirectory()) {
+							const sub = readdirSync(join(dropDir, name));
+							if (sub.length > 0) return true;
+						}
+					} catch {
+						// ignore unreadable sub-entry
+					}
+				}
+			}
+		} catch {
+			// best-effort; treat as no
+		}
+
+		return false;
 	}
 
 	/**