@juanibiapina/pi-powerbar 0.11.0 → 0.11.2

package/node_modules/@marckrenn/pi-sub-core/CHANGELOG.md

@@ -0,0 +1,154 @@
+# @marckrenn/pi-sub-core
+
+## 1.5.0
+
+### Minor Changes
+
+- [#56](https://github.com/marckrenn/pi-sub/pull/56) [`864cc1b`](https://github.com/marckrenn/pi-sub/commit/864cc1bbc91897d934c0545a29f508862231963c) - Prioritize usage windows that match the active model before emitting `sub-core:update-current`, so compact status clients show the correct quota windows (including Codex Spark and Antigravity model-specific windows).
+
+  Also make settings list navigation compatible with both old and new `@mariozechner/pi-tui` keybinding APIs, preventing crashes in submenus on older Pi runtimes where `getEditorKeybindings()` is unavailable.
+
+  Thanks [@dnouri](https://github.com/dnouri) for [#54](https://github.com/marckrenn/pi-sub/pull/54).
+
+### Patch Changes
+
+- Updated dependencies [[`864cc1b`](https://github.com/marckrenn/pi-sub/commit/864cc1bbc91897d934c0545a29f508862231963c)]:
+  - @marckrenn/pi-sub-shared@1.5.0
+
+## 1.4.0
+
+### Minor Changes
+
+- [#51](https://github.com/marckrenn/pi-sub/pull/51) [`477ee48`](https://github.com/marckrenn/pi-sub/commit/477ee480ae1a3841808f1e46b0541e11adcf0651) Thanks [@marckrenn](https://github.com/marckrenn)! - Align `sub-bar`, `sub-core`, and `sub-shared` to `1.4.0` in lockstep.
+
+  No functional changes in this bump; this release normalizes package versions after the previous publish.
+
+### Patch Changes
+
+- Updated dependencies [[`477ee48`](https://github.com/marckrenn/pi-sub/commit/477ee480ae1a3841808f1e46b0541e11adcf0651)]:
+  - @marckrenn/pi-sub-shared@1.4.0
+
+## 1.3.1
+
+### Patch Changes
+
+- Updated dependencies []:
+  - @marckrenn/pi-sub-shared@1.3.1
+
+## 1.3.0
+
+### Minor Changes
+
+- [#42](https://github.com/marckrenn/pi-sub/pull/42) [`8bf29f3`](https://github.com/marckrenn/pi-sub/commit/8bf29f34c8f9418284cf30631a3325799c3e0f48) Thanks [@marckrenn](https://github.com/marckrenn)! - - Added an optional `showContextBar` setting (default: off), as introduced in [#10](https://github.com/marckrenn/pi-sub/pull/10) by [@pasky](https://github.com/pasky), to render the current context usage as an optional leftmost `Ctx` bar in sub-bar usage output.
+  - Support for Codex Spark usage (auto-selected for `gpt-5.3-codex-spark`), including model-specific window labeling behavior.
+  - OpenAI Status provider now surfaces the Codex-specific status endpoint instead of the generic status summary when available.
+  - [`80b49b1`](https://github.com/marckrenn/pi-sub/commit/80b49b16c20c942135764bcf6c4cd0516e868ce2) Fixed API key auth format handling for the z.ai provider.
+
+### Patch Changes
+
+- Updated dependencies [[`8bf29f3`](https://github.com/marckrenn/pi-sub/commit/8bf29f34c8f9418284cf30631a3325799c3e0f48)]:
+  - @marckrenn/pi-sub-shared@1.3.0
+
+## 1.2.0
+
+### Patch Changes
+
+- Fixed tool registration execute signature order for compatibility with the latest Pi tool API.
+
+### Updated dependencies:
+
+- @marckrenn/pi-sub-shared@1.2.0
+
+## 1.1.0
+
+### Patch Changes
+
+- [`7ce2a92`](https://github.com/marckrenn/pi-sub/commit/7ce2a92b15e766fd85a4b7eb85d6fc5c5aa32dca) Thanks [@marckrenn](https://github.com/marckrenn)! - Support providing credentials via environment variables for the usage providers (Anthropic, Copilot, Gemini, Antigravity, Codex, z.ai).
+
+- Updated dependencies []:
+  - @marckrenn/pi-sub-shared@1.1.0
+
+## 1.0.6
+
+### Patch Changes
+
+- Watch `~/.pi/agent/pi-sub-core-settings.json` for changes and hot-reload settings (with `fs.watch` + polling fallback).
+
+- Updated dependencies []:
+  - @marckrenn/pi-sub-shared@1.0.6
+
+## 1.0.5
+
+### Patch Changes
+
+- [#35](https://github.com/marckrenn/pi-sub/pull/35) [`59e2b45`](https://github.com/marckrenn/pi-sub/commit/59e2b456e0e5c41479dccedcef93f9175cc4aa55) Thanks [@marckrenn](https://github.com/marckrenn)! - Improve startup responsiveness by deferring refreshes and watchers, skipping headless UI work, and unref-ing long-lived timers so pi CLI commands exit cleanly.
+
+- Updated dependencies [[`59e2b45`](https://github.com/marckrenn/pi-sub/commit/59e2b456e0e5c41479dccedcef93f9175cc4aa55)]:
+  - @marckrenn/pi-sub-shared@1.0.5
+
+## 1.0.4
+
+### Patch Changes
+
+- [#30](https://github.com/marckrenn/pi-sub/pull/30) [`af0828a`](https://github.com/marckrenn/pi-sub/commit/af0828a8d2e529497a1acff95e388a0a3eabb90e) Thanks [@marckrenn](https://github.com/marckrenn)! - Store the shared cache and lock files in the agent directory so all sub-core instances share a single cache.
+
+- [#22](https://github.com/marckrenn/pi-sub/pull/22) [`3e5a026`](https://github.com/marckrenn/pi-sub/commit/3e5a026ea3dc113561ff32466a8aa03b91c6d876) Thanks [@marckrenn](https://github.com/marckrenn)! - Store sub-core and sub-bar settings in agent-level JSON files so updates no longer overwrite user configuration. Legacy extension `settings.json` files are migrated into the new files and removed after a successful migration.
+
+  Manual migration (if you want to do it yourself before updating):
+
+  ```
+  cp ~/.pi/agent/extensions/sub-core/settings.json ~/.pi/agent/pi-sub-core-settings.json
+  cp ~/.pi/agent/extensions/sub-bar/settings.json ~/.pi/agent/pi-sub-bar-settings.json
+  ```
+
+  Existing users should move legacy settings from the extension folders to:
+  - `~/.pi/agent/pi-sub-core-settings.json`
+  - `~/.pi/agent/pi-sub-bar-settings.json`
+
+- [`a6c0d33`](https://github.com/marckrenn/pi-sub/commit/a6c0d33c8d19d2876a4a8a1a0a69302a3c63f5e8) Thanks [@marckrenn](https://github.com/marckrenn)! - Move the shared cache/lock files under `~/.pi/agent/cache/sub-core` so all clients share a single cache directory.
+
+- [`7da1e08`](https://github.com/marckrenn/pi-sub/commit/7da1e082e634f4e4dee2560b4d490527d1543ade) Thanks [@marckrenn](https://github.com/marckrenn)! - Add a minimum refresh interval setting to cap refresh frequency even when refresh is triggered every turn.
+
+- [`1f5e451`](https://github.com/marckrenn/pi-sub/commit/1f5e45173b9868b0d6645ae35a084142a0ac56a5) Thanks [@marckrenn](https://github.com/marckrenn)! - Gate tool registration behind `tools.usageTool` and `tools.allUsageTool` (default off) in sub-core settings.
+
+- [`35eb185`](https://github.com/marckrenn/pi-sub/commit/35eb18590f369db4cda931b8e11099d0f3ddb4ec) Thanks [@marckrenn](https://github.com/marckrenn)! - Add usage tool aliases `get_current_usage` and `get_all_usage`.
+
+- Updated dependencies [[`7da1e08`](https://github.com/marckrenn/pi-sub/commit/7da1e082e634f4e4dee2560b4d490527d1543ade)]:
+  - @marckrenn/pi-sub-shared@1.0.4
+
+## 1.0.3
+
+### Patch Changes
+
+- [`6fa2736`](https://github.com/marckrenn/pi-sub/commit/6fa27363573f34c38a372a6d7b8b74e756716724) Thanks [@marckrenn](https://github.com/marckrenn)! - Update extension tool execute signature order for compatibility with latest Pi API.
+
+- Updated dependencies [[`6fa2736`](https://github.com/marckrenn/pi-sub/commit/6fa27363573f34c38a372a6d7b8b74e756716724)]:
+  - @marckrenn/pi-sub-shared@1.0.3
+
+## 1.0.2
+
+### Patch Changes
+
+- [#3](https://github.com/marckrenn/pi-sub/pull/3) [`4ceb5ad`](https://github.com/marckrenn/pi-sub/commit/4ceb5ad133166237652d197ba9296ad1589a813c) Thanks [@marckrenn](https://github.com/marckrenn)! - Bundle sub-core with sub-bar, refresh Antigravity quotas + settings, and update UI copy/controls.
+
+- Updated dependencies [[`4ceb5ad`](https://github.com/marckrenn/pi-sub/commit/4ceb5ad133166237652d197ba9296ad1589a813c)]:
+  - @marckrenn/pi-sub-shared@1.0.2
+
+## 1.0.1
+
+### Patch Changes
+
+- Align repo version with npm publish.
+- Updated dependencies:
+  - @marckrenn/pi-sub-shared@1.0.1
+
+## 1.0.0
+
+### Major Changes
+
+- [`9bedd80`](https://github.com/marckrenn/pi-sub/commit/9bedd80b0037b723e70f0376019fff59a617e7cb) Thanks [@marckrenn](https://github.com/marckrenn)! - Initial 1.0.0 release.
+
+### Patch Changes
+
+- Updated dependencies [[`9bedd80`](https://github.com/marckrenn/pi-sub/commit/9bedd80b0037b723e70f0376019fff59a617e7cb)]:
+  - @marckrenn/pi-sub-shared@1.0.0

package/node_modules/@marckrenn/pi-sub-core/README.md

@@ -0,0 +1,178 @@
+# sub-core
+
+Shared usage data core for pi extensions. Sub-core owns fetching, caching, provider selection, and emits usage updates via `pi.events` for the wider `sub-*` ecosystem (UI and non-UI clients).
+
+## Overview
+
+- Fetches usage + status data from providers
+- Deduplicates requests via shared cache/lock
+- Emits updates for display-focused extensions (e.g. `sub-bar`) and non-UI tooling extensions
+- Supports Antigravity usage via auth.json (`google-antigravity`)
+
+## Installation
+
+Install via the pi package manager (recommended):
+
+```bash
+pi install npm:@marckrenn/pi-sub-core
+```
+
+Use `-l` to install into project settings instead of global:
+
+```bash
+pi install -l npm:@marckrenn/pi-sub-core
+```
+
+For a UI, also install a display extension like `sub-bar` from the same repo (see the root README for the full setup).
+
+Manual install (local development):
+
+```bash
+git clone https://github.com/marckrenn/pi-sub.git
+ln -s /path/to/pi-sub/packages/sub-core ~/.pi/agent/extensions/sub-core
+```
+
+Alternative (no symlink): add it to `~/.pi/agent/settings.json`:
+
+```json
+{
+  "extensions": ["/path/to/pi-sub/packages/sub-core/index.ts"]
+}
+```
+
+## Tool Access
+
+Tool registration is gated by `tools` in `~/.pi/agent/pi-sub-core-settings.json`.
+By default, both tools are **off**. To enable them, set:
+
+```json
+{
+  "tools": {
+    "usageTool": true,
+    "allUsageTool": true
+  }
+}
+```
+
+Then run `/reload` (tool registration only happens on load). You can also toggle these in `/sub-core:settings` → Tool Settings.
+
+When enabled, `sub-core` registers tools to expose usage snapshots to Pi:
+
+- `sub_get_usage` / `get_current_usage` – refreshes usage (forced by default) and returns `{ provider, usage }`.
+- `sub_get_all_usage` / `get_all_usage` – refreshes and returns all enabled provider entries (auto-enabled providers require credentials).
+
+## Settings
+
+Use `sub-core:settings` to configure shared provider settings plus **Usage Refresh Settings** and **Status Refresh Settings**. Provider enablement supports `auto` (default), `on`, and `off` — `auto` enables a provider only when credentials are detected.
+
+Usage refresh controls cache/usage updates, while status refresh controls incident polling (you can keep status on a slower interval). The Minimum Refresh Interval caps how often refresh triggers can fetch new data even if you refresh every turn.
+
+Antigravity usage requires an OAuth token in `~/.pi/agent/auth.json` under the `google-antigravity` key.
+
+Anthropic extra usage formatting is controlled in Provider Settings (currency symbol + decimal separator).
+
+Settings are stored in `~/.pi/agent/pi-sub-core-settings.json` (migrated from the legacy extension `settings.json` when present; the legacy file is removed after a successful migration).
+
+**Settings migrations:** settings are merged with defaults on load, but renames/removals are not migrated automatically. When adding new settings or changing schema, update the defaults/merge logic and provide a migration (or instruct users to reset `pi-sub-core-settings.json`).
+
+## Cache
+
+Sub-core stores a shared cache and lock file:
+
+- `~/.pi/agent/cache/sub-core/cache.json`
+- `~/.pi/agent/cache/sub-core/cache.lock`
+
+Legacy cache files next to the extension entry or in the agent root are migrated to the cache directory and removed on first run.
+
+## Security notes
+
+- Keep `~/.pi/agent/auth.json` readable only by your user (e.g. `chmod 600 ~/.pi/agent/auth.json`).
+- Avoid logging token-bearing headers or auth config when troubleshooting provider calls.
+
+## Provider comparison
+
+| Provider | Usage Data | Status Page | Notes |
+|----------|-----------|-------------|-------|
+| Anthropic (Claude) | 5h/Week windows, extra usage | ✅ | Extra usage on/off state |
+| GitHub Copilot | Monthly quota, requests | ✅ | Request multiplier support |
+| Google Gemini | Pro/Flash quotas | ✅ | Aggregated by model family |
+| Antigravity | Model quotas | ✅ | Sandbox Cloud Code Assist quotas (tested) |
+| OpenAI Codex | Primary/secondary windows | ✅ | Credits not yet supported (PRs welcome!) |
+| AWS Kiro | Credits | - | Credits not yet supported (PRs welcome!) |
+| z.ai | Tokens/monthly limits | - | API quota limits |
+
+## Development
+
+### Packaging notes (pi install compatibility)
+
+Pi packages use a `pi` field in `package.json` plus the `pi-package` keyword for discoverability. This repo already declares `pi.extensions`, so you can install via:
+
+```bash
+pi install npm:@marckrenn/pi-sub-core
+```
+
+Manual paths/symlinks still work for local development as documented above.
+
+### Tested providers
+
+Tested so far: Anthropic (Claude), OpenAI Codex, GitHub Copilot. Other providers are implemented but not yet verified in production.
+
+### Adding a Provider
+
+You need to update both **sub-core** (fetch layer) and **sub-bar** (display layer).
+
+### Feature placement (core vs UI)
+
+- **sub-core**: fetching, caching, provider detection/selection, status polling, tools/events, and shared settings.
+- **sub-bar**: formatting, widget layout, UI-only toggles, and display-specific behavior.
+- **sub-shared**: shared types/constants for anything referenced by both layers.
+
+See the root README “Developer guide” for the decision checklist and examples.
+
+#### sub-core (fetch + status)
+1. Add provider name to `src/types.ts` (`PROVIDERS`, `ProviderName`).
+2. Implement fetcher in `src/providers/impl/<provider>.ts`.
+3. Register provider in `src/providers/registry.ts`.
+4. Add detection + status config in `src/providers/metadata.ts`.
+5. Add provider settings defaults in `src/settings-types.ts`.
+
+#### sub-bar (display + UI)
+1. Add provider name to `src/types.ts`.
+2. Add display rules + labels in `src/providers/metadata.ts`.
+3. Add window visibility in `src/providers/windows.ts`.
+4. Add extras in `src/providers/extras.ts` (if needed).
+5. Add settings UI + defaults in `src/providers/settings.ts` and `src/settings-types.ts`.
+
+### Events (public contract)
+
+Sub-core uses `pi.events` as an in-process pub/sub bus. Any `sub-*` extension can subscribe to updates (UI or headless). Sub-core is the source of truth for provider selection and refresh behavior; clients observe state and optionally request changes.
+
+#### Broadcasts
+- `sub-core:ready` → `{ state, settings }` (first load)
+- `sub-core:update-current` → `{ state }` (cache hit or fresh fetch)
+- `sub-core:update-all` → `{ state }` (cached entries + current provider)
+- `sub-core:settings:updated` → `{ settings }`
+
+`update-current` state is `{ provider, usage }`.
+`update-all` state is `{ provider, entries }`, where entries are cached provider snapshots.
+
+#### Requests (pull current state)
+- `sub-core:request` → `{ reply, includeSettings? }`
+- `sub-core:request` → `{ type: "entries", reply, force? }` (bulk usage entries)
+
+The `reply` callback receives `{ state }` or `{ entries }` immediately if available.
+
+#### Actions (mutate core state)
+- `sub-core:settings:patch` → `{ patch }` (updates refresh interval/provider settings and persists)
+- `sub-core:action` → `{ type: "refresh" | "cycleProvider", force? }`
+
+After an action, sub-core emits `sub-core:update-current` with the new state.
+
+## Credits
+
+- Hannes Januschka ([barts](https://github.com/hjanuschka/shitty-extensions?tab=readme-ov-file#usage-barts), [@hjanuschka](https://x.com/hjanuschka))
+- Peter Steinberger ([CodexBar](https://github.com/steipete/CodexBar), [@steipete](https://x.com/steipete))
+
+## Status
+
+Active. Used by `sub-bar` for display.