@beyona/pi-zai-usage 0.3.2

package/CHANGELOG.md

@@ -0,0 +1,177 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [0.3.2] - 2026-06-19
+
+### Fixed
+
+- upgrade usage lib for custom warning values
+
+## [0.3.1] - 2026-06-17
+
+### Fixed
+
+- use correct format for colored values
+
+## [0.3.0] - 2026-06-17
+
+### Added
+
+- use warning colors for high quota usage
+
+### Changed
+
+- **deps-ci**: bump codecov/codecov-action from 6 to 7 (#42)
+- **deps**: update dependencies
+- **deps**: update dependencies (#39)
+- **deps**: update dependencies (#40)
+- **deps-dev**: update dependencies (#41)
+- **deps**: update dependencies (#43)
+- **deps**: update dependencies (#44)
+- **deps**: update dependencies (#45)
+
+## [0.2.2] - 2026-05-30
+
+### Changed
+
+- use @alexanderfortin/pi-usage-lib shared library (#38)
+
+### Fixed
+
+- fix ts type issue
+
+## [0.2.1] - 2026-05-29
+
+### Changed
+
+- **deps**: update dependencies (#34)
+- **deps**: update dependencies (#35)
+
+### Fixed
+
+- add UTC default timezone to support sbx sandboxes
+
+## [0.2.0] - 2026-05-26
+
+### Added
+
+- show error codes in footer instead of raw console errors
+
+### Changed
+
+- **deps**: update dependencies (#32)
+- **deps**: update dependencies (#33)
+
+## [0.1.14] - 2026-05-18
+
+### Fixed
+
+- remove pinned dependency version
+
+## [0.1.13] - 2026-05-18
+
+### Fixed
+
+- handle empty/malformed API responses from Pi v0.75.0 fetch changes
+
+## [0.1.12] - 2026-05-08
+
+### Fixed
+
+- **deps**: update namespace to @earendil-works
+
+## [0.1.11] - 2026-05-04
+
+### Fixed
+
+- **deps**: bump dependencies
+
+## [0.1.10] - 2026-04-26
+
+### Fixed
+
+- **deps**: update dependencies to latest versions (#10)
+
+## [0.1.9] - 2026-04-14
+
+### Changed
+
+- **deps**: bump @mariozechner/pi-coding-agent (#1)
+- **deps**: update Pi and other deps
+
+### Fixed
+
+- bump release
+
+## [0.1.8] - 2026-04-09
+
+### Fixed
+
+- correct CHANGELOG format and semantic release configuration
+
+## [0.1.7] - 2026-04-09
+
+### Fixed
+
+- add semantic release automated workflow
+
+## [0.1.6] - 2026-04-04
+
+### Changed
+
+- Manual version bump for NPM publishing
+
+## [0.1.3] - 2026-04-04
+
+### Changed
+
+- remove redundant cleanup for turn_end
+- reduce duplication in set status logic
+- fix readme
+
+## [0.1.2] - 2026-04-03
+
+### Changed
+
+- update README with install instructions
+- cleanup release docs
+
+## [0.1.1] - 2026-04-03
+
+### Added
+
+- Usage tool for checking Z.ai API token usage quota
+- Auto footer display when using Z.ai models
+- Smart caching (30-second cache to avoid excessive API calls)
+- Temporal-based datetime formatting
+- Time tracking (reset time and remaining time display)
+
+### Changed
+
+- Enabled full OIDC publishing (no NPM_TOKEN required)
+
+[unreleased]: https://github.com/shaftoe/pi-zai-usage/compare/v0.3.2...HEAD
+[0.3.2]: https://github.com/shaftoe/pi-zai-usage/compare/v0.3.1...v0.3.2
+[0.3.1]: https://github.com/shaftoe/pi-zai-usage/compare/v0.3.0...v0.3.1
+[0.3.0]: https://github.com/shaftoe/pi-zai-usage/compare/v0.2.2...v0.3.0
+[0.2.2]: https://github.com/shaftoe/pi-zai-usage/compare/v0.2.1...v0.2.2
+[0.2.1]: https://github.com/shaftoe/pi-zai-usage/compare/v0.2.0...v0.2.1
+[0.2.0]: https://github.com/shaftoe/pi-zai-usage/compare/v0.1.14...v0.2.0
+[0.1.14]: https://github.com/shaftoe/pi-zai-usage/compare/v0.1.13...v0.1.14
+[0.1.13]: https://github.com/shaftoe/pi-zai-usage/compare/v0.1.12...v0.1.13
+[0.1.12]: https://github.com/shaftoe/pi-zai-usage/compare/v0.1.11...v0.1.12
+[0.1.11]: https://github.com/shaftoe/pi-zai-usage/compare/v0.1.10...v0.1.11
+[0.1.10]: https://github.com/shaftoe/pi-zai-usage/compare/v0.1.9...v0.1.10
+[0.1.9]: https://github.com/shaftoe/pi-zai-usage/compare/v0.1.8...v0.1.9
+[0.1.8]: https://github.com/shaftoe/pi-zai-usage/compare/v0.1.7...v0.1.8
+[0.1.7]: https://github.com/shaftoe/pi-zai-usage/compare/v0.1.6...v0.1.7
+[0.1.6]: https://github.com/shaftoe/pi-zai-usage/compare/v0.1.3...v0.1.6
+[0.1.3]: https://github.com/shaftoe/pi-zai-usage/compare/v0.1.2...v0.1.3
+[0.1.2]: https://github.com/shaftoe/pi-zai-usage/compare/v0.1.1...v0.1.2
+[0.1.1]: https://github.com/shaftoe/pi-zai-usage/releases/tag/v0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Alexander Fortin
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,100 @@
+# Pi coding agent Z.ai Usage Extension
+
+
+
+A [Pi coding agent](https://pi.dev/) extension that monitors [Z.ai subscription](https://z.ai/subscribe) API token usage quota and automatically displays usage in the footer when using the Z.ai provider.
+
+![screenshot](./screenshot.png)
+
+## Features
+
+- **Auto Footer Display**: Automatically shows usage in the footer when using Z.ai models
+- **Smart Caching**: Caches usage data for 30 seconds to avoid excessive API calls
+- **Time Tracking**: Displays remaining time until quota reset
+
+## Install
+
+```bash
+pi install npm:@beyona/pi-zai-usage
+```
+
+or if you prefer to build and keep a source checkout locally, clone your fork and run:
+
+```bash
+# Install dependencies
+bun install
+
+# Build the extension
+bun run build
+
+# Install the extension
+pi install ./
+```
+
+## Development
+
+This project uses modern TypeScript development tooling:
+
+- **Bun** - Fast package manager and runtime
+- **TypeScript 6** - Static type checking with strict mode enabled
+- **Biome** - Ultra-fast linter and formatter
+
+```bash
+# Type check
+bun run typecheck
+
+# Lint code
+bun run lint
+
+# Auto-fix lint issues
+bun run lint:fix
+
+# Format code
+bun run format
+
+# Run all checks
+bun run check
+
+# Watch mode for development
+bun run dev
+```
+
+## Usage
+
+### Automatic Footer Display
+
+When using a Z.ai model (e.g., `glm-4.7`, `glm-5`, `glm-5-flash`), the extension automatically displays the usage in the footer (between brackets the time left for the quota to be reset):
+
+```
+Z.ai: 45% (2h 15m 30s)
+```
+
+The footer updates after each AI turn and on model selection changes.
+
+## Configuration
+
+No configuration needed. The extension automatically:
+- Uses cached data for 30 seconds to avoid excessive API calls
+- Shows/updates status only when Z.ai models are active
+- Clears status when switching to non-Z.ai models
+
+## API
+
+The extension uses the Z.ai API endpoint: `https://api.z.ai/api/monitor/usage/quota/limit`
+
+Make sure you're logged in to Z.ai via Pi (`/login for Z.ai`).
+
+## Releasing
+
+This project uses automated publishing to NPM via GitHub Actions. The workflow will:
+- Run all CI checks
+- Build the package
+- Publish to NPM with provenance (signed) via [trusted publishing](https://docs.npmjs.com/trusted-publishers)
+
+## Redistribution notes
+
+This fork vendors the helper code formerly provided by `@alexanderfortin/pi-usage-lib` so the published `@beyona/pi-zai-usage` package has no runtime dependency on that package. The vendored helper code and original extension are MIT-licensed by Alexander Fortin.
+
+## License
+
+MIT

package/dist/api.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Z.ai Usage Checker - Pi Extension
+ * Provider-specific API interaction using shared library primitives
+ */
+import type { ModelRegistry } from "@earendil-works/pi-coding-agent";
+import { UsageError } from "./usage-lib";
+export interface ZaiUsageResponse {
+    data: {
+        limits: Array<{
+            type: string;
+            percentage: number;
+            nextResetTime?: number;
+        }>;
+    };
+}
+export interface ZaiApiError {
+    code: number;
+    msg: string;
+    success: boolean;
+}
+export interface ZaiUsageData {
+    percentage: number;
+    resetTime?: string;
+    timeRemaining?: string;
+}
+/**
+ * Fetch Z.ai usage from the API
+ *
+ * Uses shared library primitives (buildAuthHeaders, safeFetch, safeParseJson)
+ * for sandbox-aware auth, error handling, and JSON parsing.
+ */
+export declare function getZaiUsage(modelRegistry: Pick<ModelRegistry, "getApiKeyForProvider">): Promise<ZaiUsageData>;
+export { UsageError };
+//# sourceMappingURL=api.d.ts.map

package/dist/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAA;AACpE,OAAO,EAML,UAAU,EACX,MAAM,aAAa,CAAA;AAIpB,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE;QACJ,MAAM,EAAE,KAAK,CAAC;YACZ,IAAI,EAAE,MAAM,CAAA;YACZ,UAAU,EAAE,MAAM,CAAA;YAClB,aAAa,CAAC,EAAE,MAAM,CAAA;SACvB,CAAC,CAAA;KACH,CAAA;CACF;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,EAAE,MAAM,CAAA;IACX,OAAO,EAAE,OAAO,CAAA;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAID;;;;;GAKG;AACH,wBAAsB,WAAW,CAC/B,aAAa,EAAE,IAAI,CAAC,aAAa,EAAE,sBAAsB,CAAC,GACzD,OAAO,CAAC,YAAY,CAAC,CA+BvB;AAGD,OAAO,EAAE,UAAU,EAAE,CAAA"}

package/dist/api.js

@@ -0,0 +1,39 @@
+/**
+ * Z.ai Usage Checker - Pi Extension
+ * Provider-specific API interaction using shared library primitives
+ */
+import { buildAuthHeaders, formatInstantFromEpochMs, formatTimeRemainingFromEpochMs, safeFetch, safeParseJson, UsageError, } from "./usage-lib";
+const ZAI_USAGE_API_URL = "https://api.z.ai/api/monitor/usage/quota/limit";
+/**
+ * Fetch Z.ai usage from the API
+ *
+ * Uses shared library primitives (buildAuthHeaders, safeFetch, safeParseJson)
+ * for sandbox-aware auth, error handling, and JSON parsing.
+ */
+export async function getZaiUsage(modelRegistry) {
+    const headers = await buildAuthHeaders(modelRegistry, "zai");
+    const response = await safeFetch(ZAI_USAGE_API_URL, { headers });
+    const parsed = await safeParseJson(response);
+    // Z.ai API can return HTTP 200 with an error body
+    // e.g. {"code":401,"msg":"token expired or incorrect","success":false}
+    const apiError = parsed;
+    if (typeof apiError.success === "boolean" && !apiError.success && apiError.msg) {
+        throw new UsageError(`Z.ai API error: ${apiError.msg}`, `api${apiError.code ?? "unknown"}`);
+    }
+    const data = parsed;
+    const tokensLimit = data.data?.limits?.find((limit) => limit.type === "TOKENS_LIMIT");
+    if (!tokensLimit) {
+        throw new UsageError("TOKENS_LIMIT not found in API response", "nolimit");
+    }
+    const result = {
+        percentage: tokensLimit.percentage,
+    };
+    if (tokensLimit.nextResetTime) {
+        result.resetTime = formatInstantFromEpochMs(tokensLimit.nextResetTime);
+        result.timeRemaining = formatTimeRemainingFromEpochMs(tokensLimit.nextResetTime);
+    }
+    return result;
+}
+// Re-export UsageError for consumers that need it
+export { UsageError };
+//# sourceMappingURL=api.js.map

package/dist/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EACL,gBAAgB,EAChB,wBAAwB,EACxB,8BAA8B,EAC9B,SAAS,EACT,aAAa,EACb,UAAU,GACX,MAAM,aAAa,CAAA;AA0BpB,MAAM,iBAAiB,GAAG,gDAAgD,CAAA;AAE1E;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,aAA0D;IAE1D,MAAM,OAAO,GAAG,MAAM,gBAAgB,CAAC,aAAa,EAAE,KAAK,CAAC,CAAA;IAE5D,MAAM,QAAQ,GAAG,MAAM,SAAS,CAAC,iBAAiB,EAAE,EAAE,OAAO,EAAE,CAAC,CAAA;IAEhE,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,QAAQ,CAAC,CAAA;IAE5C,kDAAkD;IAClD,uEAAuE;IACvE,MAAM,QAAQ,GAAG,MAAqB,CAAA;IACtC,IAAI,OAAO,QAAQ,CAAC,OAAO,KAAK,SAAS,IAAI,CAAC,QAAQ,CAAC,OAAO,IAAI,QAAQ,CAAC,GAAG,EAAE,CAAC;QAC/E,MAAM,IAAI,UAAU,CAAC,mBAAmB,QAAQ,CAAC,GAAG,EAAE,EAAE,MAAM,QAAQ,CAAC,IAAI,IAAI,SAAS,EAAE,CAAC,CAAA;IAC7F,CAAC;IAED,MAAM,IAAI,GAAG,MAA0B,CAAA;IACvC,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,cAAc,CAAC,CAAA;IAErF,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,MAAM,IAAI,UAAU,CAAC,wCAAwC,EAAE,SAAS,CAAC,CAAA;IAC3E,CAAC;IAED,MAAM,MAAM,GAAiB;QAC3B,UAAU,EAAE,WAAW,CAAC,UAAU;KACnC,CAAA;IAED,IAAI,WAAW,CAAC,aAAa,EAAE,CAAC;QAC9B,MAAM,CAAC,SAAS,GAAG,wBAAwB,CAAC,WAAW,CAAC,aAAa,CAAC,CAAA;QACtE,MAAM,CAAC,aAAa,GAAG,8BAA8B,CAAC,WAAW,CAAC,aAAa,CAAC,CAAA;IAClF,CAAC;IAED,OAAO,MAAM,CAAA;AACf,CAAC;AAED,kDAAkD;AAClD,OAAO,EAAE,UAAU,EAAE,CAAA"}

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Z.ai Usage Checker - Pi Extension
+ *
+ * Uses createUsageExtension from the shared library to handle all
+ * event registration, provider matching, caching, and footer lifecycle.
+ */
+import { type ZaiUsageData } from "./api";
+import { createUsageExtension, type Theme } from "./usage-lib";
+/** Render Z.ai usage data into a themed footer string */
+export declare function renderZaiStatus(data: ZaiUsageData, theme: Theme): string;
+declare const extension: ReturnType<typeof createUsageExtension<ZaiUsageData>>;
+export default extension;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAe,KAAK,YAAY,EAAE,MAAM,OAAO,CAAA;AACtD,OAAO,EAAsB,oBAAoB,EAAE,KAAK,KAAK,EAAE,MAAM,aAAa,CAAA;AAElF,yDAAyD;AACzD,wBAAgB,eAAe,CAAC,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,KAAK,GAAG,MAAM,CAOxE;AAED,QAAA,MAAM,SAAS,EAAE,UAAU,CAAC,OAAO,oBAAoB,CAAC,YAAY,CAAC,CAOjE,CAAA;AAEJ,eAAe,SAAS,CAAA"}

package/dist/index.js

@@ -0,0 +1,26 @@
+/**
+ * Z.ai Usage Checker - Pi Extension
+ *
+ * Uses createUsageExtension from the shared library to handle all
+ * event registration, provider matching, caching, and footer lifecycle.
+ */
+import { getZaiUsage } from "./api";
+import { colorForPercentage, createUsageExtension } from "./usage-lib";
+/** Render Z.ai usage data into a themed footer string */
+export function renderZaiStatus(data, theme) {
+    const displayPercentage = Math.round(data.percentage * 10) / 10;
+    let status = `${theme.fg("muted", "Z.ai:")}${colorForPercentage(displayPercentage, theme)(`${displayPercentage}%`)}`;
+    if (data.resetTime && data.timeRemaining) {
+        status += ` ${theme.fg("dim", `(${data.timeRemaining})`)}`;
+    }
+    return status;
+}
+const extension = createUsageExtension({
+    providerPrefix: "zai",
+    statusKey: "zai-usage",
+    label: "Z.ai",
+    fetchUsage: getZaiUsage,
+    renderStatus: renderZaiStatus,
+});
+export default extension;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,WAAW,EAAqB,MAAM,OAAO,CAAA;AACtD,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAc,MAAM,aAAa,CAAA;AAElF,yDAAyD;AACzD,MAAM,UAAU,eAAe,CAAC,IAAkB,EAAE,KAAY;IAC9D,MAAM,iBAAiB,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,GAAG,EAAE,CAAC,GAAG,EAAE,CAAA;IAC/D,IAAI,MAAM,GAAG,GAAG,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,GAAG,kBAAkB,CAAC,iBAAiB,EAAE,KAAK,CAAC,CAAC,GAAG,iBAAiB,GAAG,CAAC,EAAE,CAAA;IACpH,IAAI,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;QACzC,MAAM,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,IAAI,IAAI,CAAC,aAAa,GAAG,CAAC,EAAE,CAAA;IAC5D,CAAC;IACD,OAAO,MAAM,CAAA;AACf,CAAC;AAED,MAAM,SAAS,GACb,oBAAoB,CAAe;IACjC,cAAc,EAAE,KAAK;IACrB,SAAS,EAAE,WAAW;IACtB,KAAK,EAAE,MAAM;IACb,UAAU,EAAE,WAAW;IACvB,YAAY,EAAE,eAAe;CAC9B,CAAC,CAAA;AAEJ,eAAe,SAAS,CAAA"}

package/dist/usage-lib/api.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Vendored from @alexanderfortin/pi-usage-lib (MIT).
+ * API utilities: sandbox-aware auth, safe fetch, structured errors.
+ */
+import type { ModelRegistry } from "@earendil-works/pi-coding-agent";
+/** Error thrown by API interactions; carries a short code for footer display */
+export declare class UsageError extends Error {
+    readonly code: string;
+    readonly name = "UsageError";
+    constructor(message: string, code: string);
+}
+/**
+ * Build authenticated headers using a 3-way sandbox-aware strategy:
+ *
+ * 1. Real key present → send "Authorization: Bearer <key>"
+ * 2. Key is "proxy-managed" sentinel → don't set auth (sandbox proxy handles it)
+ * 3. No key → don't set auth (API returns 401, shown as error)
+ *
+ * Also sets Accept-Encoding: identity to work around Pi v0.75.0's
+ * undici EnvHttpProxyAgent gzip decompression issue.
+ */
+export declare function buildAuthHeaders(modelRegistry: Pick<ModelRegistry, "getApiKeyForProvider">, providerName: string, extra?: Record<string, string>): Promise<Record<string, string>>;
+/**
+ * Fetch with error wrapping:
+ * - Network errors (DNS, timeout, proxy) → UsageError("fetch")
+ * - HTTP errors (4xx, 5xx) → UsageError("http{status}")
+ */
+export declare function safeFetch(url: string, init?: RequestInit): Promise<Response>;
+/**
+ * Parse JSON with error handling:
+ * - Empty/malformed body → UsageError("badjson")
+ */
+export declare function safeParseJson<T = unknown>(response: Response): Promise<T>;
+//# sourceMappingURL=api.d.ts.map

package/dist/usage-lib/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../src/usage-lib/api.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAA;AAQpE,gFAAgF;AAChF,qBAAa,UAAW,SAAQ,KAAK;aAIjB,IAAI,EAAE,MAAM;IAH9B,SAAkB,IAAI,gBAAe;gBAEnC,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,MAAM;CAI/B;AAED;;;;;;;;;GASG;AACH,wBAAsB,gBAAgB,CACpC,aAAa,EAAE,IAAI,CAAC,aAAa,EAAE,sBAAsB,CAAC,EAC1D,YAAY,EAAE,MAAM,EACpB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC7B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAajC;AAED;;;;GAIG;AACH,wBAAsB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,QAAQ,CAAC,CAclF;AAED;;;GAGG;AACH,wBAAsB,aAAa,CAAC,CAAC,GAAG,OAAO,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,CAAC,CAAC,CAO/E"}

package/dist/usage-lib/api.js

@@ -0,0 +1,74 @@
+/**
+ * Vendored from @alexanderfortin/pi-usage-lib (MIT).
+ * API utilities: sandbox-aware auth, safe fetch, structured errors.
+ */
+/** Sentinel value injected by Docker Sandbox proxy when an env var is
+ * proxy-managed (listed under environment.proxyManaged in spec.yaml).
+ * When the API key reads as this value, the proxy will inject the real
+ * Authorization header, so we should not set it ourselves. */
+const PROXY_MANAGED_SENTINEL = "proxy-managed";
+/** Error thrown by API interactions; carries a short code for footer display */
+export class UsageError extends Error {
+    code;
+    name = "UsageError";
+    constructor(message, code) {
+        super(message);
+        this.code = code;
+    }
+}
+/**
+ * Build authenticated headers using a 3-way sandbox-aware strategy:
+ *
+ * 1. Real key present → send "Authorization: Bearer <key>"
+ * 2. Key is "proxy-managed" sentinel → don't set auth (sandbox proxy handles it)
+ * 3. No key → don't set auth (API returns 401, shown as error)
+ *
+ * Also sets Accept-Encoding: identity to work around Pi v0.75.0's
+ * undici EnvHttpProxyAgent gzip decompression issue.
+ */
+export async function buildAuthHeaders(modelRegistry, providerName, extra) {
+    const apiKey = await modelRegistry.getApiKeyForProvider(providerName);
+    const headers = {
+        // Prevent gzip encoding: Pi v0.75.0 routes fetch() through undici's
+        // EnvHttpProxyAgent which fails to decompress gzip responses, causing
+        // response.json() to see garbled bytes and throw SyntaxError.
+        "Accept-Encoding": "identity",
+        ...extra,
+    };
+    if (apiKey && apiKey !== PROXY_MANAGED_SENTINEL) {
+        headers.Authorization = `Bearer ${apiKey}`;
+    }
+    return headers;
+}
+/**
+ * Fetch with error wrapping:
+ * - Network errors (DNS, timeout, proxy) → UsageError("fetch")
+ * - HTTP errors (4xx, 5xx) → UsageError("http{status}")
+ */
+export async function safeFetch(url, init) {
+    let response;
+    try {
+        response = await fetch(url, init);
+    }
+    catch (e) {
+        throw new UsageError(`Network error: ${e instanceof Error ? e.message : String(e)}`, "fetch");
+    }
+    if (!response.ok) {
+        throw new UsageError(`API request failed with status ${response.status}`, `http${response.status}`);
+    }
+    return response;
+}
+/**
+ * Parse JSON with error handling:
+ * - Empty/malformed body → UsageError("badjson")
+ */
+export async function safeParseJson(response) {
+    try {
+        return (await response.json());
+    }
+    catch (e) {
+        const message = e instanceof SyntaxError ? "empty or malformed response" : String(e);
+        throw new UsageError(`API returned invalid JSON (${message})`, "badjson");
+    }
+}
+//# sourceMappingURL=api.js.map

package/dist/usage-lib/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../../src/usage-lib/api.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH;;;8DAG8D;AAC9D,MAAM,sBAAsB,GAAG,eAAe,CAAA;AAE9C,gFAAgF;AAChF,MAAM,OAAO,UAAW,SAAQ,KAAK;IAIjB;IAHA,IAAI,GAAG,YAAY,CAAA;IACrC,YACE,OAAe,EACC,IAAY;QAE5B,KAAK,CAAC,OAAO,CAAC,CAAA;QAFE,SAAI,GAAJ,IAAI,CAAQ;IAG9B,CAAC;CACF;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,aAA0D,EAC1D,YAAoB,EACpB,KAA8B;IAE9B,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,oBAAoB,CAAC,YAAY,CAAC,CAAA;IACrE,MAAM,OAAO,GAA2B;QACtC,oEAAoE;QACpE,sEAAsE;QACtE,8DAA8D;QAC9D,iBAAiB,EAAE,UAAU;QAC7B,GAAG,KAAK;KACT,CAAA;IACD,IAAI,MAAM,IAAI,MAAM,KAAK,sBAAsB,EAAE,CAAC;QAChD,OAAO,CAAC,aAAa,GAAG,UAAU,MAAM,EAAE,CAAA;IAC5C,CAAC;IACD,OAAO,OAAO,CAAA;AAChB,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,GAAW,EAAE,IAAkB;IAC7D,IAAI,QAAkB,CAAA;IACtB,IAAI,CAAC;QACH,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;IACnC,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,IAAI,UAAU,CAAC,kBAAkB,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,OAAO,CAAC,CAAA;IAC/F,CAAC;IACD,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,UAAU,CAClB,kCAAkC,QAAQ,CAAC,MAAM,EAAE,EACnD,OAAO,QAAQ,CAAC,MAAM,EAAE,CACzB,CAAA;IACH,CAAC;IACD,OAAO,QAAQ,CAAA;AACjB,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAc,QAAkB;IACjE,IAAI,CAAC;QACH,OAAO,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAM,CAAA;IACrC,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,OAAO,GAAG,CAAC,YAAY,WAAW,CAAC,CAAC,CAAC,6BAA6B,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAA;QACpF,MAAM,IAAI,UAAU,CAAC,8BAA8B,OAAO,GAAG,EAAE,SAAS,CAAC,CAAA;IAC3E,CAAC;AACH,CAAC"}

package/dist/usage-lib/cache.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Vendored from @alexanderfortin/pi-usage-lib (MIT).
+ * Generic usage cache with themed footer rendering.
+ */
+import type { ExtensionContext } from "@earendil-works/pi-coding-agent";
+import type { FetchUsageFn, RenderErrorFn, RenderStatusFn } from "./types";
+/** Generic cache for usage data with cooldown and themed footer rendering */
+export declare class UsageCache<TData> {
+    private readonly statusKey;
+    private readonly fetchUsage;
+    private readonly renderStatus;
+    private readonly cooldownMs;
+    private lastData;
+    private lastFetchTime;
+    private readonly renderError;
+    constructor(statusKey: string, label: string, fetchUsage: FetchUsageFn<TData>, renderStatus: RenderStatusFn<TData>, renderError: RenderErrorFn | undefined, cooldownMs?: number);
+    /** Update footer status from API or cache */
+    updateStatus(ctx: ExtensionContext): Promise<void>;
+    /** Clear footer status */
+    clear(ctx: ExtensionContext): void;
+}
+//# sourceMappingURL=cache.d.ts.map

package/dist/usage-lib/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/usage-lib/cache.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAA;AAGvE,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,cAAc,EAAS,MAAM,SAAS,CAAA;AAUjF,6EAA6E;AAC7E,qBAAa,UAAU,CAAC,KAAK;IAMzB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAE1B,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,YAAY;IAE7B,OAAO,CAAC,QAAQ,CAAC,UAAU;IAV7B,OAAO,CAAC,QAAQ,CAAqB;IACrC,OAAO,CAAC,aAAa,CAAI;IACzB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAe;gBAGxB,SAAS,EAAE,MAAM,EAClC,KAAK,EAAE,MAAM,EACI,UAAU,EAAE,YAAY,CAAC,KAAK,CAAC,EAC/B,YAAY,EAAE,cAAc,CAAC,KAAK,CAAC,EACpD,WAAW,EAAE,aAAa,GAAG,SAAS,EACrB,UAAU,SAAS;IAMtC,6CAA6C;IACvC,YAAY,CAAC,GAAG,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAsBxD,0BAA0B;IAC1B,KAAK,CAAC,GAAG,EAAE,gBAAgB,GAAG,IAAI;CAGnC"}

package/dist/usage-lib/cache.js

@@ -0,0 +1,56 @@
+/**
+ * Vendored from @alexanderfortin/pi-usage-lib (MIT).
+ * Generic usage cache with themed footer rendering.
+ */
+import { Temporal } from "temporal-polyfill";
+import { UsageError } from "./api";
+/** Build the default error renderer for a given label */
+function defaultRenderError(label) {
+    return (error, theme) => {
+        const code = error instanceof UsageError ? error.code : "fetch";
+        return theme.fg("muted", `${label}:`) + theme.fg("error", `<err:${code}>`);
+    };
+}
+/** Generic cache for usage data with cooldown and themed footer rendering */
+export class UsageCache {
+    statusKey;
+    fetchUsage;
+    renderStatus;
+    cooldownMs;
+    lastData = null;
+    lastFetchTime = 0;
+    renderError;
+    constructor(statusKey, label, fetchUsage, renderStatus, renderError, cooldownMs = 30_000) {
+        this.statusKey = statusKey;
+        this.fetchUsage = fetchUsage;
+        this.renderStatus = renderStatus;
+        this.cooldownMs = cooldownMs;
+        // Use default error rendering
+        this.renderError = renderError ?? defaultRenderError(label);
+    }
+    /** Update footer status from API or cache */
+    async updateStatus(ctx) {
+        try {
+            const now = Temporal.Now.instant().epochMilliseconds;
+            // Use cached data if still fresh
+            if (this.lastData && now - this.lastFetchTime < this.cooldownMs) {
+                ctx.ui.setStatus(this.statusKey, this.renderStatus(this.lastData, ctx.ui.theme));
+                return;
+            }
+            const data = await this.fetchUsage(ctx.modelRegistry);
+            this.lastData = data;
+            this.lastFetchTime = now;
+            ctx.ui.setStatus(this.statusKey, this.renderStatus(data, ctx.ui.theme));
+        }
+        catch (error) {
+            // Show error code in footer (no console.error)
+            const rendered = this.renderError(error, ctx.ui.theme);
+            ctx.ui.setStatus(this.statusKey, rendered); // undefined → clears
+        }
+    }
+    /** Clear footer status */
+    clear(ctx) {
+        ctx.ui.setStatus(this.statusKey, undefined);
+    }
+}
+//# sourceMappingURL=cache.js.map

package/dist/usage-lib/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../src/usage-lib/cache.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,OAAO,CAAA;AAGlC,yDAAyD;AACzD,SAAS,kBAAkB,CAAC,KAAa;IACvC,OAAO,CAAC,KAAc,EAAE,KAAY,EAAU,EAAE;QAC9C,MAAM,IAAI,GAAG,KAAK,YAAY,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAA;QAC/D,OAAO,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,KAAK,GAAG,CAAC,GAAG,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,QAAQ,IAAI,GAAG,CAAC,CAAA;IAC5E,CAAC,CAAA;AACH,CAAC;AAED,6EAA6E;AAC7E,MAAM,OAAO,UAAU;IAMF;IAEA;IACA;IAEA;IAVX,QAAQ,GAAiB,IAAI,CAAA;IAC7B,aAAa,GAAG,CAAC,CAAA;IACR,WAAW,CAAe;IAE3C,YACmB,SAAiB,EAClC,KAAa,EACI,UAA+B,EAC/B,YAAmC,EACpD,WAAsC,EACrB,aAAa,MAAM;QALnB,cAAS,GAAT,SAAS,CAAQ;QAEjB,eAAU,GAAV,UAAU,CAAqB;QAC/B,iBAAY,GAAZ,YAAY,CAAuB;QAEnC,eAAU,GAAV,UAAU,CAAS;QAEpC,8BAA8B;QAC9B,IAAI,CAAC,WAAW,GAAG,WAAW,IAAI,kBAAkB,CAAC,KAAK,CAAC,CAAA;IAC7D,CAAC;IAED,6CAA6C;IAC7C,KAAK,CAAC,YAAY,CAAC,GAAqB;QACtC,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,iBAAiB,CAAA;YAEpD,iCAAiC;YACjC,IAAI,IAAI,CAAC,QAAQ,IAAI,GAAG,GAAG,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;gBAChE,GAAG,CAAC,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAA;gBAChF,OAAM;YACR,CAAC;YAED,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,aAAa,CAAC,CAAA;YACrD,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAA;YACpB,IAAI,CAAC,aAAa,GAAG,GAAG,CAAA;YAExB,GAAG,CAAC,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAA;QACzE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,+CAA+C;YAC/C,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC,CAAA;YACtD,GAAG,CAAC,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAA,CAAC,qBAAqB;QAClE,CAAC;IACH,CAAC;IAED,0BAA0B;IAC1B,KAAK,CAAC,GAAqB;QACzB,GAAG,CAAC,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,SAAS,EAAE,SAAS,CAAC,CAAA;IAC7C,CAAC;CACF"}

package/dist/usage-lib/color.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Vendored from @alexanderfortin/pi-usage-lib (MIT).
+ * Color threshold helpers for usage display.
+ */
+import type { ColorThresholds, Theme } from "./types";
+/**
+ * Get the appropriate TUI color function for a percentage-based usage value.
+ *
+ * - accent (default) when percentage ≤ warning threshold
+ * - warning when percentage > warning threshold
+ * - error when percentage ≥ critical threshold
+ */
+export declare function colorForPercentage(percentage: number, theme: Theme, thresholds?: ColorThresholds): (text: string) => string;
+/**
+ * Get the appropriate TUI color function for a credit / monetary balance value.
+ *
+ * - accent (default) when credit ≥ warning threshold
+ * - warning when credit < warning threshold
+ * - error when credit ≤ critical threshold
+ */
+export declare function colorForCredit(credit: number, theme: Theme, thresholds?: ColorThresholds): (text: string) => string;
+/** Default color thresholds — re-exported for convenience. */
+export { DEFAULT_COLOR_THRESHOLDS } from "./config";
+//# sourceMappingURL=color.d.ts.map

package/dist/usage-lib/color.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"color.d.ts","sourceRoot":"","sources":["../../src/usage-lib/color.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AAErD;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,KAAK,EACZ,UAAU,CAAC,EAAE,eAAe,GAC3B,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAK1B;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,KAAK,EACZ,UAAU,CAAC,EAAE,eAAe,GAC3B,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAK1B;AAED,8DAA8D;AAC9D,OAAO,EAAE,wBAAwB,EAAE,MAAM,UAAU,CAAA"}

package/dist/usage-lib/color.js

@@ -0,0 +1,38 @@
+/**
+ * Vendored from @alexanderfortin/pi-usage-lib (MIT).
+ * Color threshold helpers for usage display.
+ */
+import { loadColorThresholds } from "./config";
+/**
+ * Get the appropriate TUI color function for a percentage-based usage value.
+ *
+ * - accent (default) when percentage ≤ warning threshold
+ * - warning when percentage > warning threshold
+ * - error when percentage ≥ critical threshold
+ */
+export function colorForPercentage(percentage, theme, thresholds) {
+    const t = thresholds ?? loadColorThresholds();
+    if (percentage >= t.percentage.critical)
+        return (s) => theme.fg("error", s);
+    if (percentage > t.percentage.warning)
+        return (s) => theme.fg("warning", s);
+    return (s) => theme.fg("accent", s);
+}
+/**
+ * Get the appropriate TUI color function for a credit / monetary balance value.
+ *
+ * - accent (default) when credit ≥ warning threshold
+ * - warning when credit < warning threshold
+ * - error when credit ≤ critical threshold
+ */
+export function colorForCredit(credit, theme, thresholds) {
+    const t = thresholds ?? loadColorThresholds();
+    if (credit <= t.credit.critical)
+        return (s) => theme.fg("error", s);
+    if (credit < t.credit.warning)
+        return (s) => theme.fg("warning", s);
+    return (s) => theme.fg("accent", s);
+}
+/** Default color thresholds — re-exported for convenience. */
+export { DEFAULT_COLOR_THRESHOLDS } from "./config";
+//# sourceMappingURL=color.js.map

package/dist/usage-lib/color.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"color.js","sourceRoot":"","sources":["../../src/usage-lib/color.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAA;AAG9C;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAChC,UAAkB,EAClB,KAAY,EACZ,UAA4B;IAE5B,MAAM,CAAC,GAAG,UAAU,IAAI,mBAAmB,EAAE,CAAA;IAC7C,IAAI,UAAU,IAAI,CAAC,CAAC,UAAU,CAAC,QAAQ;QAAE,OAAO,CAAC,CAAS,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC,CAAA;IACnF,IAAI,UAAU,GAAG,CAAC,CAAC,UAAU,CAAC,OAAO;QAAE,OAAO,CAAC,CAAS,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,CAAC,CAAA;IACnF,OAAO,CAAC,CAAS,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAA;AAC7C,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAC5B,MAAc,EACd,KAAY,EACZ,UAA4B;IAE5B,MAAM,CAAC,GAAG,UAAU,IAAI,mBAAmB,EAAE,CAAA;IAC7C,IAAI,MAAM,IAAI,CAAC,CAAC,MAAM,CAAC,QAAQ;QAAE,OAAO,CAAC,CAAS,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC,CAAA;IAC3E,IAAI,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO;QAAE,OAAO,CAAC,CAAS,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,CAAC,CAAA;IAC3E,OAAO,CAAC,CAAS,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAA;AAC7C,CAAC;AAED,8DAA8D;AAC9D,OAAO,EAAE,wBAAwB,EAAE,MAAM,UAAU,CAAA"}

package/dist/usage-lib/config.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Vendored from @alexanderfortin/pi-usage-lib (MIT).
+ * User configuration management for color thresholds.
+ */
+import type { ColorThresholds } from "./types";
+/** Default color thresholds used when no user overrides are present. */
+export declare const DEFAULT_COLOR_THRESHOLDS: ColorThresholds;
+/** Filename for user-managed settings, relative to the home directory. */
+export declare const SETTINGS_RELATIVE_PATH = ".pi/agent/usage-lib.json";
+/** Resolve the absolute path to the user settings file. */
+export declare function getSettingsFilePath(): string;
+/**
+ * Merge a *partial* set of user-provided thresholds into the defaults.
+ *
+ * Only known, numeric keys are applied — everything else (unknown keys,
+ * non-numeric values) is ignored so a malformed file cannot break rendering.
+ */
+export declare function mergeThresholds(defaults: ColorThresholds, overrides: unknown): ColorThresholds;
+/**
+ * Load color thresholds from `~/.pi/agent/usage-lib.json`, merged with defaults.
+ *
+ * The file is read **once** per process and cached — subsequent calls return
+ * the cached object without touching the filesystem.
+ *
+ * Returns the built-in defaults if the file is missing, unreadable, or
+ * contains invalid JSON.
+ */
+export declare function loadColorThresholds(): ColorThresholds;
+/**
+ * Reset the internal cache so the next `loadColorThresholds()` call re-reads
+ * the settings file. Primarily useful for testing.
+ */
+export declare function resetThresholdsCache(): void;
+//# sourceMappingURL=config.d.ts.map

package/dist/usage-lib/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/usage-lib/config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAE9C,wEAAwE;AACxE,eAAO,MAAM,wBAAwB,EAAE,eAG7B,CAAA;AAEV,0EAA0E;AAC1E,eAAO,MAAM,sBAAsB,6BAA6B,CAAA;AAEhE,2DAA2D;AAC3D,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,eAAe,EAAE,SAAS,EAAE,OAAO,GAAG,eAAe,CAe9F;AASD;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,IAAI,eAAe,CAwBrD;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI,IAAI,CAE3C"}

package/dist/usage-lib/config.js

@@ -0,0 +1,86 @@
+/**
+ * Vendored from @alexanderfortin/pi-usage-lib (MIT).
+ * User configuration management for color thresholds.
+ */
+import { readFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+/** Default color thresholds used when no user overrides are present. */
+export const DEFAULT_COLOR_THRESHOLDS = {
+    percentage: { warning: 80, critical: 90 },
+    credit: { warning: 5, critical: 1 },
+};
+/** Filename for user-managed settings, relative to the home directory. */
+export const SETTINGS_RELATIVE_PATH = ".pi/agent/usage-lib.json";
+/** Resolve the absolute path to the user settings file. */
+export function getSettingsFilePath() {
+    return join(homedir(), SETTINGS_RELATIVE_PATH);
+}
+/**
+ * Merge a *partial* set of user-provided thresholds into the defaults.
+ *
+ * Only known, numeric keys are applied — everything else (unknown keys,
+ * non-numeric values) is ignored so a malformed file cannot break rendering.
+ */
+export function mergeThresholds(defaults, overrides) {
+    const o = (overrides ?? {});
+    const pct = o.percentage;
+    const credit = o.credit;
+    return {
+        percentage: {
+            warning: pickNumber(pct?.warning, defaults.percentage.warning),
+            critical: pickNumber(pct?.critical, defaults.percentage.critical),
+        },
+        credit: {
+            warning: pickNumber(credit?.warning, defaults.credit.warning),
+            critical: pickNumber(credit?.critical, defaults.credit.critical),
+        },
+    };
+}
+/** Return the value if it is a finite number, otherwise the fallback. */
+function pickNumber(value, fallback) {
+    return typeof value === "number" && Number.isFinite(value) ? value : fallback;
+}
+let cachedThresholds = null;
+/**
+ * Load color thresholds from `~/.pi/agent/usage-lib.json`, merged with defaults.
+ *
+ * The file is read **once** per process and cached — subsequent calls return
+ * the cached object without touching the filesystem.
+ *
+ * Returns the built-in defaults if the file is missing, unreadable, or
+ * contains invalid JSON.
+ */
+export function loadColorThresholds() {
+    if (cachedThresholds)
+        return cachedThresholds;
+    let fileContent;
+    try {
+        fileContent = readFileSync(getSettingsFilePath(), "utf-8");
+    }
+    catch {
+        // File missing or unreadable — use defaults
+        cachedThresholds = { ...DEFAULT_COLOR_THRESHOLDS };
+        return cachedThresholds;
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(fileContent);
+    }
+    catch {
+        // Invalid JSON — use defaults
+        cachedThresholds = { ...DEFAULT_COLOR_THRESHOLDS };
+        return cachedThresholds;
+    }
+    const thresholds = parsed?.thresholds;
+    cachedThresholds = mergeThresholds(DEFAULT_COLOR_THRESHOLDS, thresholds);
+    return cachedThresholds;
+}
+/**
+ * Reset the internal cache so the next `loadColorThresholds()` call re-reads
+ * the settings file. Primarily useful for testing.
+ */
+export function resetThresholdsCache() {
+    cachedThresholds = null;
+}
+//# sourceMappingURL=config.js.map

package/dist/usage-lib/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/usage-lib/config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAGhC,wEAAwE;AACxE,MAAM,CAAC,MAAM,wBAAwB,GAAoB;IACvD,UAAU,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE;IACzC,MAAM,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE;CAC3B,CAAA;AAEV,0EAA0E;AAC1E,MAAM,CAAC,MAAM,sBAAsB,GAAG,0BAA0B,CAAA;AAEhE,2DAA2D;AAC3D,MAAM,UAAU,mBAAmB;IACjC,OAAO,IAAI,CAAC,OAAO,EAAE,EAAE,sBAAsB,CAAC,CAAA;AAChD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,QAAyB,EAAE,SAAkB;IAC3E,MAAM,CAAC,GAAG,CAAC,SAAS,IAAI,EAAE,CAA4B,CAAA;IACtD,MAAM,GAAG,GAAG,CAAC,CAAC,UAAiD,CAAA;IAC/D,MAAM,MAAM,GAAG,CAAC,CAAC,MAA6C,CAAA;IAE9D,OAAO;QACL,UAAU,EAAE;YACV,OAAO,EAAE,UAAU,CAAC,GAAG,EAAE,OAAO,EAAE,QAAQ,CAAC,UAAU,CAAC,OAAO,CAAC;YAC9D,QAAQ,EAAE,UAAU,CAAC,GAAG,EAAE,QAAQ,EAAE,QAAQ,CAAC,UAAU,CAAC,QAAQ,CAAC;SAClE;QACD,MAAM,EAAE;YACN,OAAO,EAAE,UAAU,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC;YAC7D,QAAQ,EAAE,UAAU,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC;SACjE;KACF,CAAA;AACH,CAAC;AAED,yEAAyE;AACzE,SAAS,UAAU,CAAC,KAAc,EAAE,QAAgB;IAClD,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAA;AAC/E,CAAC;AAED,IAAI,gBAAgB,GAA2B,IAAI,CAAA;AAEnD;;;;;;;;GAQG;AACH,MAAM,UAAU,mBAAmB;IACjC,IAAI,gBAAgB;QAAE,OAAO,gBAAgB,CAAA;IAE7C,IAAI,WAAmB,CAAA;IACvB,IAAI,CAAC;QACH,WAAW,GAAG,YAAY,CAAC,mBAAmB,EAAE,EAAE,OAAO,CAAC,CAAA;IAC5D,CAAC;IAAC,MAAM,CAAC;QACP,4CAA4C;QAC5C,gBAAgB,GAAG,EAAE,GAAG,wBAAwB,EAAE,CAAA;QAClD,OAAO,gBAAgB,CAAA;IACzB,CAAC;IAED,IAAI,MAAe,CAAA;IACnB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAA;IAClC,CAAC;IAAC,MAAM,CAAC;QACP,8BAA8B;QAC9B,gBAAgB,GAAG,EAAE,GAAG,wBAAwB,EAAE,CAAA;QAClD,OAAO,gBAAgB,CAAA;IACzB,CAAC;IAED,MAAM,UAAU,GAAI,MAAyC,EAAE,UAAU,CAAA;IACzE,gBAAgB,GAAG,eAAe,CAAC,wBAAwB,EAAE,UAAU,CAAC,CAAA;IACxE,OAAO,gBAAgB,CAAA;AACzB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB;IAClC,gBAAgB,GAAG,IAAI,CAAA;AACzB,CAAC"}

package/dist/usage-lib/datetime.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Vendored from @alexanderfortin/pi-usage-lib (MIT).
+ * Date/time formatting utilities using Temporal.
+ */
+/**
+ * Format an instant (epoch milliseconds) as a localized date/time string
+ */
+export declare function formatInstantFromEpochMs(ms: number): string;
+/**
+ * Format the remaining time from an instant (epoch milliseconds) to now
+ */
+export declare function formatTimeRemainingFromEpochMs(ms: number): string;
+//# sourceMappingURL=datetime.d.ts.map

package/dist/usage-lib/datetime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"datetime.d.ts","sourceRoot":"","sources":["../../src/usage-lib/datetime.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAa3D;AAED;;GAEG;AACH,wBAAgB,8BAA8B,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAuBjE"}

package/dist/usage-lib/datetime.js

@@ -0,0 +1,46 @@
+/**
+ * Vendored from @alexanderfortin/pi-usage-lib (MIT).
+ * Date/time formatting utilities using Temporal.
+ */
+import { Temporal } from "temporal-polyfill";
+/**
+ * Format an instant (epoch milliseconds) as a localized date/time string
+ */
+export function formatInstantFromEpochMs(ms) {
+    const instant = Temporal.Instant.fromEpochMilliseconds(ms);
+    const zonedDateTime = instant.toZonedDateTimeISO(Temporal.Now.timeZoneId() ?? "UTC");
+    return zonedDateTime.toLocaleString(undefined, {
+        weekday: "short",
+        day: "2-digit",
+        month: "short",
+        year: "numeric",
+        hour: "2-digit",
+        minute: "2-digit",
+        second: "2-digit",
+        timeZoneName: "short",
+    });
+}
+/**
+ * Format the remaining time from an instant (epoch milliseconds) to now
+ */
+export function formatTimeRemainingFromEpochMs(ms) {
+    const now = Temporal.Now.instant();
+    const target = Temporal.Instant.fromEpochMilliseconds(ms);
+    // If the target time is in the past, return zero
+    if (target.epochMilliseconds < now.epochMilliseconds) {
+        return "0h 0m 0s";
+    }
+    const duration = target.since(now);
+    const totalSeconds = Math.round(Math.abs(duration.seconds));
+    const hours = Math.floor(totalSeconds / 3600);
+    const minutes = Math.floor((totalSeconds % 3600) / 60);
+    const seconds = totalSeconds % 60;
+    if (hours > 0) {
+        return `${hours}h ${minutes}m ${seconds}s`;
+    }
+    if (minutes > 0) {
+        return `${minutes}m ${seconds}s`;
+    }
+    return `${seconds}s`;
+}
+//# sourceMappingURL=datetime.js.map

package/dist/usage-lib/datetime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"datetime.js","sourceRoot":"","sources":["../../src/usage-lib/datetime.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAE5C;;GAEG;AACH,MAAM,UAAU,wBAAwB,CAAC,EAAU;IACjD,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,qBAAqB,CAAC,EAAE,CAAC,CAAA;IAC1D,MAAM,aAAa,GAAG,OAAO,CAAC,kBAAkB,CAAC,QAAQ,CAAC,GAAG,CAAC,UAAU,EAAE,IAAI,KAAK,CAAC,CAAA;IACpF,OAAO,aAAa,CAAC,cAAc,CAAC,SAAS,EAAE;QAC7C,OAAO,EAAE,OAAO;QAChB,GAAG,EAAE,SAAS;QACd,KAAK,EAAE,OAAO;QACd,IAAI,EAAE,SAAS;QACf,IAAI,EAAE,SAAS;QACf,MAAM,EAAE,SAAS;QACjB,MAAM,EAAE,SAAS;QACjB,YAAY,EAAE,OAAO;KACtB,CAAC,CAAA;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,8BAA8B,CAAC,EAAU;IACvD,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,CAAC,OAAO,EAAE,CAAA;IAClC,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,CAAC,qBAAqB,CAAC,EAAE,CAAC,CAAA;IAEzD,iDAAiD;IACjD,IAAI,MAAM,CAAC,iBAAiB,GAAG,GAAG,CAAC,iBAAiB,EAAE,CAAC;QACrD,OAAO,UAAU,CAAA;IACnB,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;IAElC,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAA;IAC3D,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,GAAG,IAAI,CAAC,CAAA;IAC7C,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,YAAY,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,CAAA;IACtD,MAAM,OAAO,GAAG,YAAY,GAAG,EAAE,CAAA;IAEjC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QACd,OAAO,GAAG,KAAK,KAAK,OAAO,KAAK,OAAO,GAAG,CAAA;IAC5C,CAAC;IACD,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;QAChB,OAAO,GAAG,OAAO,KAAK,OAAO,GAAG,CAAA;IAClC,CAAC;IACD,OAAO,GAAG,OAAO,GAAG,CAAA;AACtB,CAAC"}

package/dist/usage-lib/extension.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Vendored from @alexanderfortin/pi-usage-lib (MIT).
+ * Factory for usage-monitoring Pi extensions.
+ */
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+import type { UsageExtensionConfig } from "./types";
+/**
+ * Create a Pi usage extension from a configuration object.
+ *
+ * Handles all boilerplate: event registration, provider matching,
+ * cache management, and footer lifecycle.
+ */
+export declare function createUsageExtension<TData>(config: UsageExtensionConfig<TData>): (pi: ExtensionAPI) => void;
+//# sourceMappingURL=extension.d.ts.map

package/dist/usage-lib/extension.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension.d.ts","sourceRoot":"","sources":["../../src/usage-lib/extension.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAoB,MAAM,iCAAiC,CAAA;AAErF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAA;AAYnD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,EAAE,oBAAoB,CAAC,KAAK,CAAC,IAGnD,IAAI,YAAY,UAsC3C"}

package/dist/usage-lib/extension.js

@@ -0,0 +1,51 @@
+/**
+ * Vendored from @alexanderfortin/pi-usage-lib (MIT).
+ * Factory for usage-monitoring Pi extensions.
+ */
+import { UsageCache } from "./cache";
+/** Check if a provider name matches the given prefix (case-insensitive) */
+function isProviderMatch(provider, prefix) {
+    return provider?.toLowerCase().startsWith(prefix) ?? false;
+}
+/** Check if the current model's provider matches the given prefix */
+function isCurrentProvider(ctx, prefix) {
+    return isProviderMatch(ctx.model?.provider, prefix);
+}
+/**
+ * Create a Pi usage extension from a configuration object.
+ *
+ * Handles all boilerplate: event registration, provider matching,
+ * cache management, and footer lifecycle.
+ */
+export function createUsageExtension(config) {
+    const { providerPrefix, statusKey, label, cooldownMs = 30_000 } = config;
+    return function extension(pi) {
+        const cache = new UsageCache(statusKey, label, config.fetchUsage, config.renderStatus, config.renderError, cooldownMs);
+        // Show footer at session start (only when using matching model)
+        pi.on("session_start", async (_event, ctx) => {
+            if (isCurrentProvider(ctx, providerPrefix)) {
+                await cache.updateStatus(ctx);
+            }
+        });
+        // Update footer on model select
+        pi.on("model_select", async (event, ctx) => {
+            if (isProviderMatch(event.model.provider, providerPrefix)) {
+                await cache.updateStatus(ctx);
+            }
+            else {
+                cache.clear(ctx);
+            }
+        });
+        // Update footer after each turn
+        pi.on("turn_end", async (_event, ctx) => {
+            if (isCurrentProvider(ctx, providerPrefix)) {
+                await cache.updateStatus(ctx);
+            }
+        });
+        // Clear footer on session shutdown
+        pi.on("session_shutdown", async (_event, ctx) => {
+            cache.clear(ctx);
+        });
+    };
+}
+//# sourceMappingURL=extension.js.map

package/dist/usage-lib/extension.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension.js","sourceRoot":"","sources":["../../src/usage-lib/extension.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AAGpC,2EAA2E;AAC3E,SAAS,eAAe,CAAC,QAA4B,EAAE,MAAc;IACnE,OAAO,QAAQ,EAAE,WAAW,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,KAAK,CAAA;AAC5D,CAAC;AAED,qEAAqE;AACrE,SAAS,iBAAiB,CAAC,GAAqB,EAAE,MAAc;IAC9D,OAAO,eAAe,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAA;AACrD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAQ,MAAmC;IAC7E,MAAM,EAAE,cAAc,EAAE,SAAS,EAAE,KAAK,EAAE,UAAU,GAAG,MAAM,EAAE,GAAG,MAAM,CAAA;IAExE,OAAO,SAAS,SAAS,CAAC,EAAgB;QACxC,MAAM,KAAK,GAAG,IAAI,UAAU,CAC1B,SAAS,EACT,KAAK,EACL,MAAM,CAAC,UAAU,EACjB,MAAM,CAAC,YAAY,EACnB,MAAM,CAAC,WAAW,EAClB,UAAU,CACX,CAAA;QAED,gEAAgE;QAChE,EAAE,CAAC,EAAE,CAAC,eAAe,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE;YAC3C,IAAI,iBAAiB,CAAC,GAAG,EAAE,cAAc,CAAC,EAAE,CAAC;gBAC3C,MAAM,KAAK,CAAC,YAAY,CAAC,GAAG,CAAC,CAAA;YAC/B,CAAC;QACH,CAAC,CAAC,CAAA;QAEF,gCAAgC;QAChC,EAAE,CAAC,EAAE,CAAC,cAAc,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YACzC,IAAI,eAAe,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,EAAE,cAAc,CAAC,EAAE,CAAC;gBAC1D,MAAM,KAAK,CAAC,YAAY,CAAC,GAAG,CAAC,CAAA;YAC/B,CAAC;iBAAM,CAAC;gBACN,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;YAClB,CAAC;QACH,CAAC,CAAC,CAAA;QAEF,gCAAgC;QAChC,EAAE,CAAC,EAAE,CAAC,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE;YACtC,IAAI,iBAAiB,CAAC,GAAG,EAAE,cAAc,CAAC,EAAE,CAAC;gBAC3C,MAAM,KAAK,CAAC,YAAY,CAAC,GAAG,CAAC,CAAA;YAC/B,CAAC;QACH,CAAC,CAAC,CAAA;QAEF,mCAAmC;QACnC,EAAE,CAAC,EAAE,CAAC,kBAAkB,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE;YAC9C,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;QAClB,CAAC,CAAC,CAAA;IACJ,CAAC,CAAA;AACH,CAAC"}

package/dist/usage-lib/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Vendored usage helper public API.
+ *
+ * Source adapted from @alexanderfortin/pi-usage-lib under the MIT license so
+ * @beyona/pi-zai-usage can be redistributed without that runtime dependency.
+ */
+export { buildAuthHeaders, safeFetch, safeParseJson, UsageError } from "./api";
+export { UsageCache } from "./cache";
+export { colorForCredit, colorForPercentage } from "./color";
+export { DEFAULT_COLOR_THRESHOLDS, getSettingsFilePath, loadColorThresholds, mergeThresholds, resetThresholdsCache, } from "./config";
+export { formatInstantFromEpochMs, formatTimeRemainingFromEpochMs } from "./datetime";
+export { createUsageExtension } from "./extension";
+export type { ColorThresholds, FetchUsageFn, RenderErrorFn, RenderStatusFn, Theme, UsageExtensionConfig, } from "./types";
+//# sourceMappingURL=index.d.ts.map

package/dist/usage-lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/usage-lib/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,OAAO,CAAA;AAC9E,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AACpC,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAA;AAC5D,OAAO,EACL,wBAAwB,EACxB,mBAAmB,EACnB,mBAAmB,EACnB,eAAe,EACf,oBAAoB,GACrB,MAAM,UAAU,CAAA;AACjB,OAAO,EAAE,wBAAwB,EAAE,8BAA8B,EAAE,MAAM,YAAY,CAAA;AACrF,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AAElD,YAAY,EACV,eAAe,EACf,YAAY,EACZ,aAAa,EACb,cAAc,EACd,KAAK,EACL,oBAAoB,GACrB,MAAM,SAAS,CAAA"}

package/dist/usage-lib/index.js

@@ -0,0 +1,13 @@
+/**
+ * Vendored usage helper public API.
+ *
+ * Source adapted from @alexanderfortin/pi-usage-lib under the MIT license so
+ * @beyona/pi-zai-usage can be redistributed without that runtime dependency.
+ */
+export { buildAuthHeaders, safeFetch, safeParseJson, UsageError } from "./api";
+export { UsageCache } from "./cache";
+export { colorForCredit, colorForPercentage } from "./color";
+export { DEFAULT_COLOR_THRESHOLDS, getSettingsFilePath, loadColorThresholds, mergeThresholds, resetThresholdsCache, } from "./config";
+export { formatInstantFromEpochMs, formatTimeRemainingFromEpochMs } from "./datetime";
+export { createUsageExtension } from "./extension";
+//# sourceMappingURL=index.js.map

package/dist/usage-lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/usage-lib/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,OAAO,CAAA;AAC9E,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AACpC,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAA;AAC5D,OAAO,EACL,wBAAwB,EACxB,mBAAmB,EACnB,mBAAmB,EACnB,eAAe,EACf,oBAAoB,GACrB,MAAM,UAAU,CAAA;AACjB,OAAO,EAAE,wBAAwB,EAAE,8BAA8B,EAAE,MAAM,YAAY,CAAA;AACrF,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA"}

package/dist/usage-lib/types.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Vendored from @alexanderfortin/pi-usage-lib (MIT).
+ * Shared public API types for usage monitoring helpers.
+ */
+import type { ExtensionContext, ModelRegistry } from "@earendil-works/pi-coding-agent";
+/** Theme helper — matches ctx.ui.theme */
+export type Theme = ExtensionContext["ui"]["theme"];
+/**
+ * Color thresholds for usage display.
+ *
+ * Users can override any subset of these values via the
+ * `~/.pi/agent/usage-lib.json` settings file.
+ */
+export interface ColorThresholds {
+    /** Percentage-based usage thresholds (0–100) */
+    percentage: {
+        /** Above this % → **warning** color (default: 80) */
+        warning: number;
+        /** At or above this % → **critical** color (default: 90) */
+        critical: number;
+    };
+    /** Credit / monetary balance thresholds (in USD) */
+    credit: {
+        /** Below this → **warning** color (default: 5) */
+        warning: number;
+        /** At or below this → **critical** color (default: 1) */
+        critical: number;
+    };
+}
+/** Fetch function signature */
+export type FetchUsageFn<TData> = (modelRegistry: Pick<ModelRegistry, "getApiKeyForProvider">) => Promise<TData>;
+/** Render usage data into a themed footer string */
+export type RenderStatusFn<TData> = (data: TData, theme: Theme) => string;
+/** Render an error into a themed footer string. Return undefined to clear the footer. */
+export type RenderErrorFn = (error: unknown, theme: Theme) => string | undefined;
+/** Configuration to define a usage extension */
+export interface UsageExtensionConfig<TData> {
+    /** Provider name prefix for matching (e.g. "zai", "deepseek") */
+    providerPrefix: string;
+    /** Status key for ctx.ui.setStatus() (e.g. "zai-usage") */
+    statusKey: string;
+    /** Display label for footer prefix (e.g. "MyProvider") */
+    label: string;
+    /** Cache cooldown in ms (default: 30_000) */
+    cooldownMs?: number;
+    /** Fetch usage data from the provider API */
+    fetchUsage: FetchUsageFn<TData>;
+    /** Render usage data into a themed footer string */
+    renderStatus: RenderStatusFn<TData>;
+    /**
+     * Render an error into a themed footer string.
+     * Default: shows themed `<err:code>` using UsageError.code,
+     * falling back to "fetch" for unknown errors.
+     * Return undefined to clear the footer instead.
+     */
+    renderError?: RenderErrorFn;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/usage-lib/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/usage-lib/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAA;AAEtF,0CAA0C;AAC1C,MAAM,MAAM,KAAK,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,CAAA;AAEnD;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,gDAAgD;IAChD,UAAU,EAAE;QACV,qDAAqD;QACrD,OAAO,EAAE,MAAM,CAAA;QACf,4DAA4D;QAC5D,QAAQ,EAAE,MAAM,CAAA;KACjB,CAAA;IACD,oDAAoD;IACpD,MAAM,EAAE;QACN,kDAAkD;QAClD,OAAO,EAAE,MAAM,CAAA;QACf,yDAAyD;QACzD,QAAQ,EAAE,MAAM,CAAA;KACjB,CAAA;CACF;AAED,+BAA+B;AAC/B,MAAM,MAAM,YAAY,CAAC,KAAK,IAAI,CAChC,aAAa,EAAE,IAAI,CAAC,aAAa,EAAE,sBAAsB,CAAC,KACvD,OAAO,CAAC,KAAK,CAAC,CAAA;AAEnB,oDAAoD;AACpD,MAAM,MAAM,cAAc,CAAC,KAAK,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,KAAK,MAAM,CAAA;AAEzE,yFAAyF;AACzF,MAAM,MAAM,aAAa,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,KAAK,MAAM,GAAG,SAAS,CAAA;AAEhF,gDAAgD;AAChD,MAAM,WAAW,oBAAoB,CAAC,KAAK;IACzC,iEAAiE;IACjE,cAAc,EAAE,MAAM,CAAA;IAEtB,2DAA2D;IAC3D,SAAS,EAAE,MAAM,CAAA;IAEjB,0DAA0D;IAC1D,KAAK,EAAE,MAAM,CAAA;IAEb,6CAA6C;IAC7C,UAAU,CAAC,EAAE,MAAM,CAAA;IAEnB,6CAA6C;IAC7C,UAAU,EAAE,YAAY,CAAC,KAAK,CAAC,CAAA;IAE/B,oDAAoD;IACpD,YAAY,EAAE,cAAc,CAAC,KAAK,CAAC,CAAA;IAEnC;;;;;OAKG;IACH,WAAW,CAAC,EAAE,aAAa,CAAA;CAC5B"}

package/dist/usage-lib/types.js

@@ -0,0 +1,6 @@
+/**
+ * Vendored from @alexanderfortin/pi-usage-lib (MIT).
+ * Shared public API types for usage monitoring helpers.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/usage-lib/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/usage-lib/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/package.json

@@ -0,0 +1,75 @@
+{
+  "name": "@beyona/pi-zai-usage",
+  "version": "0.3.2",
+  "description": "Pi extension for monitoring Z.ai API token usage quota",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "dev": "bun --watch src/index.ts",
+    "build": "bun run typecheck && bun run build:tsc",
+    "build:tsc": "tsc",
+    "typecheck": "tsc --noEmit --project tsconfig.test.json",
+    "lint": "biome check src/ tests/",
+    "lint:fix": "biome check --write src/ tests/",
+    "format": "biome format --write src/",
+    "check": "bun run typecheck && bun run lint",
+    "test": "bun test",
+    "test:coverage": "bun test --coverage --coverage-reporter=lcov",
+    "release": "semantic-release",
+    "release:dry-run": "semantic-release --dry-run"
+  },
+  "dependencies": {
+    "temporal-polyfill": "^1.0.1"
+  },
+  "devDependencies": {
+    "@alexanderfortin/semantic-release-keep-a-changelog": "^0.4.4",
+    "@biomejs/biome": "^2.5.1",
+    "@semantic-release/commit-analyzer": "^13.0.1",
+    "@semantic-release/exec": "^7.1.0",
+    "@semantic-release/git": "^10.0.1",
+    "@semantic-release/github": "^12.0.8",
+    "@semantic-release/npm": "^13.1.5",
+    "@types/bun": "^1.3.14",
+    "semantic-release": "^25.0.5",
+    "typescript": "^6.0.3"
+  },
+  "peerDependencies": {
+    "@earendil-works/pi-coding-agent": "^0.80.2",
+    "@earendil-works/pi-tui": "^0.80.2"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "package.json",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "keywords": [
+    "pi-package",
+    "pi-extension",
+    "zai",
+    "Z.ai",
+    "usage-monitoring",
+    "api-quota"
+  ],
+  "pi": {
+    "extensions": [
+      "./dist/index.js"
+    ]
+  },
+  "author": "Alexander Fortin",
+  "contributors": [
+    "beyona"
+  ],
+  "license": "MIT"
+}