@slkiser/opencode-quota 2.17.0 → 3.0.0

package/README.md

@@ -6,10 +6,13 @@
 [![Node >=18](https://img.shields.io/badge/node-%3E%3D18-339933)](./package.json)
 
 
-`opencode-quota` gives you two things:
+`opencode-quota` adds usage quota and token visibility to OpenCode with zero context-window pollution.
 
-- Automatic quota toasts after assistant responses
-- Manual `/quota`, `/pricing_refresh`, and `/tokens_*` commands for deeper local reporting with zero context window pollution
+What you get:
+
+- popup quota toasts after assistant responses
+- TUI sidebar panel
+- manual `/quota`, `/quota_status`, and `/tokens_*` commands
 
 **Quota providers**: Anthropic (Claude), GitHub Copilot, OpenAI (Plus/Pro), Cursor, Qwen Code, Alibaba Coding Plan, MiniMax Coding Plan, Chutes AI, Firmware AI, Google Antigravity, Z.ai Coding Plan, NanoGPT, and OpenCode Go.
 
@@ -30,25 +33,85 @@
   </tr>
 </table>
 
-`/tokens_*` output is computed from local OpenCode session history. Quota rows use each provider's existing local auth plus deterministic local state or live provider quota endpoints, depending on the provider.
+## Start here
+
+OpenCode `>= 1.4.3` is required. 
+
+If you are coming back later:
+- see [Provider Setup At A Glance](#provider-setup-at-a-glance) for provider-specific setup needs
+- see [Commands](#commands) for the slash commands
+- see [Configuration Reference](#configuration-reference) when you want to customize behavior
+- see [Troubleshooting](#troubleshooting) if something does not appear or auto-detect correctly
+
+## Installation
+### Automatic setup (recommended)
+
+```sh
+npx @slkiser/opencode-quota init
+```
+
+The installer (append-only, preserves existing values) asks for:
+
+- **Scope**: `Project` or `Global` (`Project` is the usual default)
+- **Quota UI**: `Toast`, `Sidebar`, `Toast + Sidebar`, or `None (manual /quota and /tokens_* only)`
+- **Provider mode**: `Auto-detect` or `Manual select` (`Auto-detect` is the usual default)
+- **Layout style**: `classic` or `grouped` (`classic` is the usual default)
+- **Show session input/output tokens**: `Yes` or `No` (`Yes` is the usual default)
+
+All quota settings live in `opencode.json` or `opencode.jsonc`. `tui.json` or `tui.jsonc` is only for loading the sidebar plugin.
+
+
+### After install 
+
+1. Restart OpenCode.
+2. Run `/quota_status`.
+3. Run `/quota`.
+4. If you chose `Sidebar` or `Toast + Sidebar`, open the session sidebar and confirm the `Quota` panel appears.
+
+### Manual setup 
 
-## Quick Start
+You can install manually, but the installer is easier and safer.
 
-OpenCode `>= 1.2.0` is required. Add the plugin to your `opencode.json` or `opencode.jsonc`:
+1. Add the server plugin to `opencode.json` or `opencode.jsonc`:
 
 ```jsonc
 {
+  "$schema": "https://opencode.ai/config.json",
   "plugin": ["@slkiser/opencode-quota"]
 }
 ```
 
-Then:
+2. If you also want the sidebar, add the same package to a `tui.json` or `tui.jsonc` file that OpenCode loads (commonly the same folder):
+
+```jsonc
+{
+  "$schema": "https://opencode.ai/tui.json",
+  "plugin": ["@slkiser/opencode-quota"]
+}
+```
 
-1. Restart or reload OpenCode.
-2. Run `/quota_status` to confirm provider detection.
-3. Run `/quota` or `/tokens_today`.
+3. Optional settings still go in `opencode.json`, not `tui.json`.
 
-That is enough for most installs. Providers are auto-detected from your existing OpenCode setup, and most providers work from your existing OpenCode auth. If a provider needs anything extra, use the setup table below.
+Providers are auto-detected from your existing OpenCode setup by default, and most providers work from your existing OpenCode auth.
+
+<details>
+<summary><strong>Example: Sidebar only (turn off popup toasts)</strong></summary>
+
+Keep the `tui.json` or `tui.jsonc` entry above and disable toasts in `opencode.json` or `opencode.jsonc`:
+
+```jsonc
+{
+  "$schema": "https://opencode.ai/config.json",
+  "plugin": ["@slkiser/opencode-quota"],
+  "experimental": {
+    "quotaToast": {
+      "enableToast": false
+    }
+  }
+}
+```
+
+</details>
 
 <details>
 <summary><strong>Example: Turn off auto-detection and choose providers</strong></summary>
@@ -66,13 +129,13 @@ That is enough for most installs. Providers are auto-detected from your existing
 </details>
 
 <details>
-<summary><strong>Example: Grouped toast layout instead of the default classic toast</strong></summary>
+<summary><strong>Example: Grouped quota layout instead of the default classic layout</strong></summary>
 
 ```jsonc
 {
   "experimental": {
     "quotaToast": {
-      "toastStyle": "grouped"
+      "formatStyle": "grouped"
     }
   }
 }
@@ -80,7 +143,7 @@ That is enough for most installs. Providers are auto-detected from your existing
 
 </details>
 
-### Provider Setup At A Glance
+## Provider Setup At A Glance
 
 | Provider | Auto setup | Authentication | Quota |
 | --- | --- | --- | --- |
@@ -98,6 +161,7 @@ That is enough for most installs. Providers are auto-detected from your existing
 | **MiniMax Coding Plan** | Yes | OpenCode auth/global config/env | Remote API |
 | **OpenCode Go** | Needs [quick setup](#opencode-go-quick-setup) | Env/config auth | Dashboard scraping |
 
+
 <a id="anthropic-quick-setup"></a>
 <details>
 <summary><strong>Quick setup: Anthropic (Claude)</strong></summary>
@@ -157,7 +221,7 @@ For behavior details and troubleshooting, see [Cursor notes](#cursor-notes).
 <details>
 <summary><strong>Quick setup: Google Antigravity</strong></summary>
 
-Google quota support requires the `opencode-antigravity-auth` [plugin](https://github.com/NoeFabris/opencode-antigravity-auth):
+Google quota support requires the `opencode-antigravity-auth` [plugin](https://github.com/NoeFabris/opencode-antigravity-auth). `@slkiser/opencode-quota` does not install that companion plugin transitively, so install/configure it separately and then enable both plugins:
 
 ```jsonc
 {
@@ -221,7 +285,7 @@ Environment variables take precedence over the config file. Run `/quota_status`
 | Command | What it shows |
 | --- | --- |
 | `/quota` | Manual grouped quota report with a local call timestamp |
-| `/quota_status` | Concise diagnostics for config, provider availability, account detection, and pricing snapshot health |
+| `/quota_status` | Concise diagnostics for config, TUI setup, provider availability, account detection, and pricing snapshot health |
 | `/pricing_refresh` | Pull the local runtime pricing snapshot from `models.dev` on demand |
 | `/tokens_today` | Tokens used today (calendar day) |
 | `/tokens_daily` | Tokens used in the last 24 hours |
@@ -232,8 +296,6 @@ Environment variables take precedence over the config file. Run `/quota_status`
 | `/tokens_session_all` | Tokens used in the current session plus all descendant child/subagent sessions |
 | `/tokens_between` | Tokens used between two dates: `YYYY-MM-DD YYYY-MM-DD` |
 
-There is no `/token` command. The reporting commands are the `/tokens_*` family.
-Use `/tokens_session` for strict per-session accounting, and `/tokens_session_all` when you want the selected parent session plus every nested child session linked by `parent_id`.
 
 ## Provider-Specific Notes
 
@@ -460,9 +522,10 @@ Example user/global config (`~/.config/opencode/opencode.jsonc` on Linux/macOS):
 <details>
 <summary><strong>Google Antigravity</strong></summary>
 
-See [Google Antigravity quick setup](#google-antigravity-quick-setup). This companion auth flow does not use `auth.json`; it reads `antigravity-accounts.json` from the OpenCode runtime directories.
+See [Google Antigravity quick setup](#google-antigravity-quick-setup). This companion auth flow does not use `auth.json`; it reads `antigravity-accounts.json` from the OpenCode runtime directories. `@slkiser/opencode-quota` expects the companion plugin to be installed separately.
 
-- `/quota_status` includes a `google_antigravity` section with the selected accounts path, all present/candidate paths, account counts, valid refresh-token counts, and the Google token-cache path.
+- `/quota_status` includes a `google_antigravity` section with the selected accounts path, all present/candidate paths, account counts, valid refresh-token counts, companion package state/path, and the Google token-cache path.
+- If the companion plugin is missing or incompatible, `/quota_status` shows `companion_package_state` and `companion_error`.
 - If detection looks wrong, start with the `google_antigravity` section in `/quota_status`.
 
 </details>
@@ -523,36 +586,63 @@ OpenCode Go quota scrapes the OpenCode Go dashboard at `https://opencode.ai/work
 
 ## Configuration Reference
 
-All plugin settings live under `experimental.quotaToast`.
+All quota plugin settings live under `experimental.quotaToast` in `opencode.json` or `opencode.jsonc`. The sidebar install step is separate: add the package to `tui.json` or `tui.jsonc`, or choose `Sidebar` or `Toast + Sidebar` in `npx @slkiser/opencode-quota init`.
+
+When both are present, user/global config provides defaults. Project/workspace config may override display-oriented settings for that project, but user/global config remains authoritative for automatic/network-affecting settings such as `enabled`, `enabledProviders`, `minIntervalMs`, `pricingSnapshot.*`, `showOnIdle`, `showOnQuestion`, `showOnCompact`, and `showOnBothFail`. SDK config is only used when no config files are found.
+
+### Core/shared settings
+
+| Option | Default | Meaning |
+| --- | --- | --- |
+| `enabled` | `true` | Master switch for quota collection and handled slash commands. When `false`, `/quota`, `/quota_status`, `/pricing_refresh`, and `/tokens_*` are handled as no-ops. |
+| `enabledProviders` | `"auto"` | Auto-detect providers, or set an explicit provider list. |
+| `minIntervalMs` | `300000` | Minimum fetch interval between provider updates. |
+| `formatStyle` | `classic` | Shared quota-row style for popup toasts and the TUI sidebar: `classic` or `grouped`. Legacy `toastStyle` is still accepted on read for backward compatibility, but `formatStyle` is the canonical key. |
+| `onlyCurrentModel` | `false` | Filter quota rows to the current model/provider when that session selection can be resolved. |
+| `showSessionTokens` | `true` | Show the `Session input/output tokens` section in quota displays when session token data is available. Toasts and `/quota` show per-model input/output rows; the TUI sidebar shows a one-line total summary. |
+| `pricingSnapshot.source` | `"auto"` | Token pricing snapshot selection for `/tokens_*`: `auto`, `bundled`, or `runtime`. |
+| `pricingSnapshot.autoRefresh` | `7` | Refresh stale local pricing data after this many days. |
+
+
+### Toast settings
+
+| Option | Default | Meaning |
+| --- | --- | --- |
+| `enableToast` | `true` | Show popup toasts. Disabling this does not disable `/quota` or the TUI sidebar. |
+| `toastDurationMs` | `9000` | Toast duration in milliseconds. |
+| `showOnIdle` | `true` | Show a toast on the idle trigger. |
+| `showOnQuestion` | `true` | Show a toast after a question/assistant response. |
+| `showOnCompact` | `true` | Show a toast after session compaction. |
+| `showOnBothFail` | `true` | Show a fallback toast when providers attempted quota reads and all failed. |
+| `layout.maxWidth` | `50` | Toast formatting width target. Ignored by the TUI sidebar. |
+| `layout.narrowAt` | `42` | Toast compact-layout breakpoint. Ignored by the TUI sidebar. |
+| `layout.tinyAt` | `32` | Toast tiny-layout breakpoint. Ignored by the TUI sidebar. |
+| `debug` | `false` | Append toast debug context when troubleshooting. |
+
+### TUI sidebar setup
+
+If you want the `Quota` sidebar panel, you need **two files**:
+
+1. **`tui.json` or `tui.jsonc`**: add the plugin entry so OpenCode mounts the sidebar panel.
+2. **`opencode.json` or `opencode.jsonc`**: put all quota settings under `experimental.quotaToast`.
+
+**Important:** `experimental.quotaToast.*` settings do **not** go in `tui.json`. `tui.json` is only for loading the TUI plugin.
+
+| File | What goes there | Needed for sidebar? |
+| --- | --- | --- |
+| `tui.json` / `tui.jsonc` | `plugin: ["@slkiser/opencode-quota"]` | Yes |
+| `opencode.json` / `opencode.jsonc` | All `experimental.quotaToast.*` settings | Yes |
 
-Workspace-local config can still customize display/report behavior, but user/global config is authoritative for network-affecting settings such as `enabled`, `enabledProviders`, `minIntervalMs`, `pricingSnapshot`, `showOnIdle`, `showOnQuestion`, and `showOnCompact`.
+### Provider-specific settings
 
 | Option | Default | Meaning |
 | --- | --- | --- |
-| `enabled` | `true` | Master switch for the plugin. When `false`, `/quota`, `/quota_status`, `/pricing_refresh`, and `/tokens_*` are no-ops. |
-| `enableToast` | `true` | Show popup toasts |
-| `toastStyle` | `classic` | Toast layout: `classic` or `grouped` |
-| `enabledProviders` | `"auto"` | Auto-detect providers, or set an explicit provider list |
-| `anthropicBinaryPath` | `"claude"` | Command/path used for local Claude CLI probing; override this for custom installs or shim locations |
-| `minIntervalMs` | `300000` | Minimum fetch interval between provider updates |
-| `toastDurationMs` | `9000` | Toast duration in milliseconds |
-| `showOnIdle` | `true` | Show toast on idle trigger |
-| `showOnQuestion` | `true` | Show toast after a question/assistant response |
-| `showOnCompact` | `true` | Show toast after session compaction |
-| `showOnBothFail` | `true` | Show a fallback toast when providers attempt and all fail |
-| `onlyCurrentModel` | `false` | Filter to the current model when possible |
-| `showSessionTokens` | `true` | Append current-session token totals to toast output |
-| `layout.maxWidth` | `50` | Main formatting width target |
-| `layout.narrowAt` | `42` | Compact layout breakpoint |
-| `layout.tinyAt` | `32` | Tiny layout breakpoint |
-| `googleModels` | `["CLAUDE"]` | Google model keys: `CLAUDE`, `G3PRO`, `G3FLASH`, `G3IMAGE` |
-| `alibabaCodingPlanTier` | `"lite"` | Fallback Alibaba Coding Plan tier when auth does not include `tier` |
-| `cursorPlan` | `"none"` | Cursor included API budget preset: `none`, `pro`, `pro-plus`, `ultra` |
-| `cursorIncludedApiUsd` | unset | Override Cursor monthly included API budget in USD |
-| `cursorBillingCycleStartDay` | unset | Local billing-cycle anchor day `1..28`; when unset, Cursor usage resets on the local calendar month |
-| `pricingSnapshot.source` | `"auto"` | Token pricing snapshot selection: `auto`, `bundled`, or `runtime` |
-| `pricingSnapshot.autoRefresh` | `5` | Refresh stale local pricing data after this many days |
-| `debug` | `false` | Include debug context in toast output |
+| `anthropicBinaryPath` | `"claude"` | Command/path used for local Claude CLI probing; override this for custom installs or shim locations. |
+| `googleModels` | `["CLAUDE"]` | Google model keys to query: `CLAUDE`, `G3PRO`, `G3FLASH`, `G3IMAGE`. |
+| `alibabaCodingPlanTier` | `"lite"` | Fallback Alibaba Coding Plan tier when auth does not include `tier`. |
+| `cursorPlan` | `"none"` | Cursor included API budget preset: `none`, `pro`, `pro-plus`, `ultra`. |
+| `cursorIncludedApiUsd` | unset | Override Cursor monthly included API budget in USD. |
+| `cursorBillingCycleStartDay` | unset | Local billing-cycle anchor day `1..28`; when unset, Cursor usage resets on the local calendar month. |
 
 ## Token Pricing Snapshot
 

package/dist/bin/opencode-quota.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export declare function main(argv?: string[]): Promise<number>;
+//# sourceMappingURL=opencode-quota.d.ts.map

package/dist/bin/opencode-quota.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"opencode-quota.d.ts","sourceRoot":"","sources":["../../src/bin/opencode-quota.ts"],"names":[],"mappings":";AAmBA,wBAAsB,IAAI,CAAC,IAAI,WAAwB,GAAG,OAAO,CAAC,MAAM,CAAC,CAmBxE"}

package/dist/bin/opencode-quota.js

@@ -0,0 +1,37 @@
+#!/usr/bin/env node
+import { pathToFileURL } from "url";
+import { runInitInstaller } from "../lib/init-installer.js";
+const USAGE = [
+    "Usage:",
+    "  npx @slkiser/opencode-quota init",
+    "  npx @slkiser/opencode-quota --help",
+    "",
+    "Commands:",
+    "  init    Run the interactive quota installer",
+].join("\n");
+function printUsage() {
+    console.log(USAGE);
+}
+export async function main(argv = process.argv.slice(2)) {
+    const [command, ...rest] = argv;
+    if (!command) {
+        printUsage();
+        return 1;
+    }
+    if (command === "--help" || command === "-h" || command === "help") {
+        printUsage();
+        return 0;
+    }
+    if (command === "init" && rest.length === 0) {
+        return await runInitInstaller();
+    }
+    printUsage();
+    return 1;
+}
+const isDirectRun = process.argv[1] && import.meta.url === pathToFileURL(process.argv[1]).href;
+if (isDirectRun) {
+    void main().then((code) => {
+        process.exitCode = code;
+    });
+}
+//# sourceMappingURL=opencode-quota.js.map

package/dist/bin/opencode-quota.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"opencode-quota.js","sourceRoot":"","sources":["../../src/bin/opencode-quota.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AAEpC,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAE5D,MAAM,KAAK,GAAG;IACZ,QAAQ;IACR,oCAAoC;IACpC,sCAAsC;IACtC,EAAE;IACF,WAAW;IACX,+CAA+C;CAChD,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb,SAAS,UAAU;IACjB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;AACrB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IACrD,MAAM,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;IAEhC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,UAAU,EAAE,CAAC;QACb,OAAO,CAAC,CAAC;IACX,CAAC;IAED,IAAI,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,KAAK,MAAM,EAAE,CAAC;QACnE,UAAU,EAAE,CAAC;QACb,OAAO,CAAC,CAAC;IACX,CAAC;IAED,IAAI,OAAO,KAAK,MAAM,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5C,OAAO,MAAM,gBAAgB,EAAE,CAAC;IAClC,CAAC;IAED,UAAU,EAAE,CAAC;IACb,OAAO,CAAC,CAAC;AACX,CAAC;AAED,MAAM,WAAW,GACf,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,aAAa,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAE7E,IAAI,WAAW,EAAE,CAAC;IAChB,KAAK,IAAI,EAAE,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE;QACxB,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;IAC1B,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/lib/config-file-utils.d.ts

@@ -0,0 +1,18 @@
+export type ConfigFileKind = "opencode" | "tui";
+export type ConfigFileFormat = "json" | "jsonc";
+export interface EditableConfigPath {
+    path: string;
+    format: ConfigFileFormat;
+    existed: boolean;
+}
+export declare function dedupeNonEmptyStrings(items: string[]): string[];
+export declare function findGitWorktreeRoot(startDir: string): string | null;
+export declare function getConfigFileCandidatePaths(dir: string, kind: ConfigFileKind): string[];
+export declare function resolveEditableConfigPath(params: {
+    dir: string;
+    kind: ConfigFileKind;
+}): EditableConfigPath;
+export declare function getPluginSpecFromEntry(entry: unknown): string | null;
+export declare function extractPluginSpecsFromParsedConfig(parsed: unknown): string[];
+export declare function isQuotaPluginSpec(spec: string, kind: ConfigFileKind): boolean;
+//# sourceMappingURL=config-file-utils.d.ts.map

package/dist/lib/config-file-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-file-utils.d.ts","sourceRoot":"","sources":["../../src/lib/config-file-utils.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,cAAc,GAAG,UAAU,GAAG,KAAK,CAAC;AAChD,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,OAAO,CAAC;AAEhD,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,gBAAgB,CAAC;IACzB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAE/D;AAED,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAcnE;AAED,wBAAgB,2BAA2B,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,GAAG,MAAM,EAAE,CAEvF;AAED,wBAAgB,yBAAyB,CAAC,MAAM,EAAE;IAChD,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,cAAc,CAAC;CACtB,GAAG,kBAAkB,CAwBrB;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAcpE;AAED,wBAAgB,kCAAkC,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,EAAE,CAwB5E;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,GAAG,OAAO,CAc7E"}

package/dist/lib/config-file-utils.js

@@ -0,0 +1,88 @@
+import { existsSync } from "fs";
+import { dirname, join } from "path";
+export function dedupeNonEmptyStrings(items) {
+    return [...new Set(items.map((item) => item.trim()).filter(Boolean))];
+}
+export function findGitWorktreeRoot(startDir) {
+    let current = startDir;
+    while (true) {
+        if (existsSync(join(current, ".git"))) {
+            return current;
+        }
+        const parent = dirname(current);
+        if (parent === current) {
+            return null;
+        }
+        current = parent;
+    }
+}
+export function getConfigFileCandidatePaths(dir, kind) {
+    return [join(dir, `${kind}.json`), join(dir, `${kind}.jsonc`)];
+}
+export function resolveEditableConfigPath(params) {
+    const jsoncPath = join(params.dir, `${params.kind}.jsonc`);
+    if (existsSync(jsoncPath)) {
+        return {
+            path: jsoncPath,
+            format: "jsonc",
+            existed: true,
+        };
+    }
+    const jsonPath = join(params.dir, `${params.kind}.json`);
+    if (existsSync(jsonPath)) {
+        return {
+            path: jsonPath,
+            format: "json",
+            existed: true,
+        };
+    }
+    return {
+        path: jsonPath,
+        format: "json",
+        existed: false,
+    };
+}
+export function getPluginSpecFromEntry(entry) {
+    const spec = typeof entry === "string"
+        ? entry
+        : Array.isArray(entry) && typeof entry[0] === "string"
+            ? entry[0]
+            : null;
+    if (typeof spec !== "string") {
+        return null;
+    }
+    const trimmed = spec.trim();
+    return trimmed.length > 0 ? trimmed : null;
+}
+export function extractPluginSpecsFromParsedConfig(parsed) {
+    if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
+        return [];
+    }
+    const root = parsed;
+    const pluginEntries = [];
+    if (Array.isArray(root.plugin)) {
+        pluginEntries.push(...root.plugin);
+    }
+    if (root.tui && typeof root.tui === "object" && !Array.isArray(root.tui)) {
+        const tuiRoot = root.tui;
+        if (Array.isArray(tuiRoot.plugin)) {
+            pluginEntries.push(...tuiRoot.plugin);
+        }
+    }
+    return dedupeNonEmptyStrings(pluginEntries
+        .map((entry) => getPluginSpecFromEntry(entry))
+        .filter((entry) => typeof entry === "string"));
+}
+export function isQuotaPluginSpec(spec, kind) {
+    const normalized = spec.replace(/\\/g, "/").toLowerCase();
+    if (normalized.includes("@slkiser/opencode-quota")) {
+        return true;
+    }
+    if (normalized.includes("/opencode-quota") && !normalized.includes("/opencode-quota/dist/")) {
+        return true;
+    }
+    return kind === "tui"
+        ? normalized.includes("opencode-quota/dist/tui.tsx")
+        : normalized.includes("opencode-quota/dist/index.js");
+}
+//# sourceMappingURL=config-file-utils.js.map

package/dist/lib/config-file-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-file-utils.js","sourceRoot":"","sources":["../../src/lib/config-file-utils.ts"],"names":[],"mappings":"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"}

package/dist/lib/config.d.ts

@@ -1,23 +1,26 @@
 /**
  * Configuration loader for opencode-quota plugin.
  *
- * Security model:
- * - Config is loaded from opencode.json/opencode.jsonc files directly so we can
- *   enforce precedence for network-affecting fields.
- * - User/global config is authoritative for fields that control whether the
- *   plugin performs automatic network-backed quota fetches.
+ * Precedence model:
+ * - Global/user config provides defaults.
+ * - Project/workspace config may override display-oriented settings for the current project.
+ * - Global/user config remains authoritative for automatic/network-affecting settings.
  * - SDK config is used only as a fallback when no config files are found.
  */
 import type { QuotaToastConfig } from "./types.js";
 export interface LoadConfigMeta {
     source: "sdk" | "files" | "defaults";
     paths: string[];
+    networkSettingSources: Record<string, string>;
+}
+export interface LoadConfigOptions {
+    cwd?: string;
 }
 export declare function createLoadConfigMeta(): LoadConfigMeta;
 /**
  * Load plugin configuration from OpenCode config
  *
- * @param client - OpenCode SDK client
+ * @param client - Optional OpenCode SDK client fallback
  * @returns Merged configuration with defaults
  */
 export declare function loadConfig(client: {
@@ -30,5 +33,5 @@ export declare function loadConfig(client: {
             };
         }>;
     };
-}, meta?: LoadConfigMeta): Promise<QuotaToastConfig>;
+} | undefined, meta?: LoadConfigMeta, options?: LoadConfigOptions): Promise<QuotaToastConfig>;
 //# sourceMappingURL=config.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/lib/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAEV,gBAAgB,EAGjB,MAAM,YAAY,CAAC;AAWpB,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,KAAK,GAAG,OAAO,GAAG,UAAU,CAAC;IACrC,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,wBAAgB,oBAAoB,IAAI,cAAc,CAErD;AAsDD;;;;;GAKG;AACH,wBAAsB,UAAU,CAC9B,MAAM,EAAE;IACN,MAAM,EAAE;QACN,GAAG,EAAE,MAAM,OAAO,CAAC;YAAE,IAAI,CAAC,EAAE;gBAAE,YAAY,CAAC,EAAE;oBAAE,UAAU,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAA;iBAAE,CAAA;aAAE,CAAA;SAAE,CAAC,CAAC;KAC9F,CAAC;CACH,EACD,IAAI,CAAC,EAAE,cAAc,GACpB,OAAO,CAAC,gBAAgB,CAAC,CA2O3B"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/lib/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAEV,gBAAgB,EAGjB,MAAM,YAAY,CAAC;AAWpB,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,KAAK,GAAG,OAAO,GAAG,UAAU,CAAC;IACrC,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,qBAAqB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC/C;AAED,MAAM,WAAW,iBAAiB;IAChC,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,wBAAgB,oBAAoB,IAAI,cAAc,CAErD;AA0HD;;;;;GAKG;AACH,wBAAsB,UAAU,CAC9B,MAAM,EACF;IACE,MAAM,EAAE;QACN,GAAG,EAAE,MAAM,OAAO,CAAC;YACjB,IAAI,CAAC,EAAE;gBAAE,YAAY,CAAC,EAAE;oBAAE,UAAU,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAA;iBAAE,CAAA;aAAE,CAAC;SACtE,CAAC,CAAC;KACJ,CAAC;CACH,GACD,SAAS,EACb,IAAI,CAAC,EAAE,cAAc,EACrB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,gBAAgB,CAAC,CAgR3B"}