opencode-quotas 0.0.1 → 0.0.2-beta

package/README.md

@@ -45,7 +45,7 @@ Add `opencode-quotas` to your OpenCode configuration file (typically `~/.opencod
 
 ## Usage
 
-Once installed and registered, a live quota summary is automatically appended to every assistant message footer in OpenCode. No further action is required.
+Once installed and registered, a live quota summary is automatically appended to the final assistant response footer in OpenCode. The plugin waits for the session to go idle before injecting to avoid duplicate footers during multi-step runs.
 
 ### CLI Mode (Optional)
 
@@ -67,9 +67,9 @@ opencode-quotas --provider google --model antigravity-gemini-3-flash
 | :--- | :--- | :--- | :--- |
 | **Antigravity** | `ag-raw-*` | `ag-flash`, `ag-pro`, `ag-premium` | Raw model quotas aggregated by pattern into Flash, Pro, and Premium tiers. |
 | **Codex** | `codex-primary`, `codex-secondary` | `codex-smart` | Rate limits aggregated using most-critical strategy. |
-| **GitHub Copilot** | — | — | ⚠️ Not yet implemented. |
+| **GitHub Copilot** | — | — | ⚠️ Experimental (requires `enableExperimentalGithub: true` in config, disabled by default) |
 
-> **Note**: Quota IDs are used in configuration options like `disabled` and `modelMapping`.
+> **Note**: Quota IDs are used in configuration options like `disabled`.
 
 ## Column Reference
 
@@ -91,11 +91,11 @@ All configuration is done via `.opencode/quotas.json` in your project root. Sett
 
 ### Model Filtering
 
-By default, `filterByCurrentModel` is enabled, showing only quotas relevant to the active model.
+By default, `filterByCurrentModel` is disabled (false). Enable it to show only quotas relevant to the active model.
 
 ```json
 {
-  "filterByCurrentModel": true
+  "filterByCurrentModel": false
 }
 ```
 
@@ -117,22 +117,6 @@ ST    QUOTA NAME          USED   UTILIZATION            RESET   ETTL
 OK    Antigravity Flash    20%   ████░░░░░░░░░░░░░░░░   28m     13m
 ```
 
-### Explicit Model Mapping
-
-For precise control, map model IDs directly to quota IDs:
-
-```json
-{
-  "modelMapping": {
-    "google/antigravity-gemini-3-flash": ["ag-flash"],
-    "google/antigravity-gemini-3-pro": ["ag-pro"],
-    "github-copilot/gpt-4o": ["codex-smart"]
-  }
-}
-```
-
-> **Note**: Model IDs must match the format from `opencode models` (e.g., `provider/model-name`).
-
 ### Hide Specific Quotas
 
 Permanently hide quotas you don't care about:
@@ -312,16 +296,20 @@ See [schemas/quotas.schema.json](schemas/quotas.schema.json) for the complete JS
 | Option | Type | Default | Description |
 | :--- | :--- | :--- | :--- |
 | `footer` | boolean | `true` | Show quotas in chat footer |
-| `filterByCurrentModel` | boolean | `true` | Filter quotas by active model |
-| `modelMapping` | object | (see defaults) | Explicit model-to-quota mappings |
+| `showFooterTitle` | boolean | `true` | Show plugin title/header in footer |
+| `filterByCurrentModel` | boolean | `false` | Filter quotas by active model |
 | `disabled` | string[] | `[]` | Quota IDs to hide |
-| `progressBar.color` | boolean | `true` | Enable ANSI colors |
+| `showUnaggregated` | boolean | `true` | Show quotas that don't match any aggregation group |
+| `progressBar.color` | boolean | `false` | Enable ANSI colors (set `true` for colored terminal output) |
 | `progressBar.width` | number | `20` | Progress bar character width |
 | `progressBar.show` | string | `"used"` | `"used"` or `"available"` |
 | `table.columns` | string[] | (auto) | Columns to display |
 | `table.header` | boolean | `true` | Show column headers |
 | `aggregatedGroups` | array | (see defaults) | Quota aggregation with patterns or sources |
+| `historyMaxAgeHours` | number | `24` | Max history age in hours |
 | `pollingInterval` | number | `60000` | Refresh interval in ms |
+| `predictionWindowMinutes` | number | `60` | Time window for regression analysis (minutes) |
+| `predictionShortWindowMinutes` | number | `5` | Short time window for spike detection (minutes) |
 | `debug` | boolean | `false` | Enable debug logging |
 
 ## Security
@@ -335,6 +323,7 @@ Built with **Bun** for speed.
 ```bash
 bun install        # Install dependencies
 bun test           # Run tests
+OPENCODE_QUOTAS_E2E=1 bun test tests/integration/injection-e2e.test.ts  # Run E2E injection test
 npm run build      # Build for production
 bun run opencode-quotas  # Run CLI in dev mode
 ```

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env bun
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,42 @@
+#!/usr/bin/env bun
+import { QuotaService } from "./services/quota-service";
+import { HistoryService } from "./services/history-service";
+import { renderQuotaTable } from "./ui/quota-table";
+async function main() {
+    if (process.argv.includes("--no-color")) {
+        process.env.OPENCODE_QUOTAS_NO_COLOR = "1";
+    }
+    const historyService = new HistoryService();
+    await historyService.init();
+    const quotaService = new QuotaService();
+    await quotaService.init(process.cwd(), historyService);
+    const config = quotaService.getConfig();
+    // Parse arguments for provider and model filtering
+    let providerId;
+    let modelId;
+    const providerIdx = process.argv.indexOf("--provider");
+    if (providerIdx !== -1 && providerIdx + 1 < process.argv.length) {
+        providerId = process.argv[providerIdx + 1];
+    }
+    const modelIdx = process.argv.indexOf("--model");
+    if (modelIdx !== -1 && modelIdx + 1 < process.argv.length) {
+        modelId = process.argv[modelIdx + 1];
+    }
+    const filteredResults = await quotaService.getQuotas({ providerId, modelId });
+    if (filteredResults.length === 0) {
+        console.log("No active quotas found.");
+        return;
+    }
+    console.log(""); // Empty line
+    console.log("📊 OpenCode Quotas");
+    console.log("------------------");
+    renderQuotaTable(filteredResults, {
+        progressBarConfig: config.progressBar,
+        tableConfig: config.table,
+    }).forEach((row) => {
+        console.log(row.line);
+    });
+    console.log(""); // Empty line
+}
+main().catch(console.error);
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEpD,KAAK,UAAU,IAAI;IACf,IAAI,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC;QACtC,OAAO,CAAC,GAAG,CAAC,wBAAwB,GAAG,GAAG,CAAC;IAC/C,CAAC;IAED,MAAM,cAAc,GAAG,IAAI,cAAc,EAAE,CAAC;IAC5C,MAAM,cAAc,CAAC,IAAI,EAAE,CAAC;IAE5B,MAAM,YAAY,GAAG,IAAI,YAAY,EAAE,CAAC;IACxC,MAAM,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,cAAc,CAAC,CAAC;IAEvD,MAAM,MAAM,GAAG,YAAY,CAAC,SAAS,EAAE,CAAC;IAExC,mDAAmD;IACnD,IAAI,UAA8B,CAAC;IACnC,IAAI,OAA2B,CAAC;IAEhC,MAAM,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IACvD,IAAI,WAAW,KAAK,CAAC,CAAC,IAAI,WAAW,GAAG,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;QAC9D,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC;IAC/C,CAAC;IAED,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IACjD,IAAI,QAAQ,KAAK,CAAC,CAAC,IAAI,QAAQ,GAAG,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;QACxD,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC;IACzC,CAAC;IAED,MAAM,eAAe,GAAG,MAAM,YAAY,CAAC,SAAS,CAAC,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC,CAAC;IAE9E,IAAI,eAAe,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/B,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC;QACvC,OAAO;IACX,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,aAAa;IAC9B,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;IAClC,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;IAElC,gBAAgB,CAAC,eAAe,EAAE;QAC9B,iBAAiB,EAAE,MAAM,CAAC,WAAW;QACrC,WAAW,EAAE,MAAM,CAAC,KAAK;KAC5B,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE;QACf,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC,CAAC,CAAC;IACH,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,aAAa;AAClC,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC"}

package/dist/constants.d.ts

@@ -0,0 +1,9 @@
+export declare const PLUGIN_FOOTER_SIGNATURE = "_Opencode Quotas";
+export declare const REASONING_PATTERNS: RegExp[];
+export declare const DEBUG_LOG_FILENAME = "quotas-debug.log";
+export declare const SKIP_REASONS: {
+    REASONING: string;
+    SUBAGENT: string;
+    FOOTER_PRESENT: string;
+};
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,uBAAuB,qBAAqB,CAAC;AAG1D,eAAO,MAAM,kBAAkB,UAI9B,CAAC;AAGF,eAAO,MAAM,kBAAkB,qBAAqB,CAAC;AAErD,eAAO,MAAM,YAAY;;;;CAIxB,CAAC"}

package/dist/constants.js

@@ -0,0 +1,15 @@
+export const PLUGIN_FOOTER_SIGNATURE = "_Opencode Quotas";
+// Heuristic patterns for detecting reasoning/thinking blocks
+export const REASONING_PATTERNS = [
+    /^<thinking>/i,
+    /^<antThinking>/i,
+    /^(Thinking|Reasoning|Analysis):\s*(\n|$)/i
+];
+// File paths
+export const DEBUG_LOG_FILENAME = "quotas-debug.log";
+export const SKIP_REASONS = {
+    REASONING: "skip:reasoning",
+    SUBAGENT: "skip:subagent",
+    FOOTER_PRESENT: "skip:footer_present",
+};
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,uBAAuB,GAAG,kBAAkB,CAAC;AAE1D,6DAA6D;AAC7D,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAC9B,cAAc;IACd,iBAAiB;IACjB,2CAA2C;CAC9C,CAAC;AAEF,aAAa;AACb,MAAM,CAAC,MAAM,kBAAkB,GAAG,kBAAkB,CAAC;AAErD,MAAM,CAAC,MAAM,YAAY,GAAG;IACxB,SAAS,EAAE,gBAAgB;IAC3B,QAAQ,EAAE,eAAe;IACzB,cAAc,EAAE,qBAAqB;CACxC,CAAC"}

package/dist/defaults.d.ts

@@ -0,0 +1,3 @@
+import { type QuotaConfig } from "./interfaces";
+export declare const DEFAULT_CONFIG: QuotaConfig;
+//# sourceMappingURL=defaults.d.ts.map

package/dist/defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../src/defaults.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AAGhD,eAAO,MAAM,cAAc,EAAE,WAoD5B,CAAC"}

package/dist/defaults.js

@@ -0,0 +1,55 @@
+// Default configuration for quota rendering and grouping
+export const DEFAULT_CONFIG = {
+    displayMode: "simple",
+    footer: true,
+    showFooterTitle: true,
+    debug: false,
+    enableExperimentalGithub: false, // Set to true to enable experimental GitHub Copilot support
+    progressBar: {
+        color: false,
+        gradients: [
+            { threshold: 0.5, color: "green" },
+            { threshold: 0.8, color: "yellow" },
+            { threshold: 1.0, color: "red" },
+        ],
+    },
+    table: {
+        header: true,
+    },
+    filterByCurrentModel: false,
+    showUnaggregated: false,
+    predictionShortWindowMinutes: 5,
+    predictionWindowMinutes: 60,
+    aggregatedGroups: [
+        {
+            id: "ag-flash",
+            name: "Antigravity Flash",
+            patterns: ["flash", "-flash", "gemini-.*-flash"],
+            providerId: "antigravity",
+            strategy: "most_critical",
+        },
+        {
+            id: "ag-pro",
+            name: "Antigravity Pro",
+            patterns: ["pro", "gemini.*pro", "gemini-1.5-pro"],
+            providerId: "antigravity",
+            strategy: "most_critical",
+        },
+        {
+            id: "ag-premium",
+            name: "Antigravity Premium",
+            patterns: ["claude", "gpt", "o1"],
+            providerId: "antigravity",
+            strategy: "most_critical",
+        },
+        {
+            id: "codex-smart",
+            name: "Codex Usage",
+            sources: ["codex-primary", "codex-secondary"],
+            strategy: "most_critical",
+        },
+    ],
+    historyMaxAgeHours: 24,
+    pollingInterval: 60_000,
+};
+//# sourceMappingURL=defaults.js.map

package/dist/defaults.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.js","sourceRoot":"","sources":["../src/defaults.ts"],"names":[],"mappings":"AAEA,yDAAyD;AACzD,MAAM,CAAC,MAAM,cAAc,GAAgB;IACvC,WAAW,EAAE,QAAQ;IACrB,MAAM,EAAE,IAAI;IACZ,eAAe,EAAE,IAAI;IACrB,KAAK,EAAE,KAAK;IACZ,wBAAwB,EAAE,KAAK,EAAE,4DAA4D;IAC7F,WAAW,EAAE;QACT,KAAK,EAAE,KAAK;QACZ,SAAS,EAAE;YACP,EAAE,SAAS,EAAE,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE;YAClC,EAAE,SAAS,EAAE,GAAG,EAAE,KAAK,EAAE,QAAQ,EAAE;YACnC,EAAE,SAAS,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE;SACnC;KACJ;IACD,KAAK,EAAE;QACH,MAAM,EAAE,IAAI;KACf;IACD,oBAAoB,EAAE,KAAK;IAC3B,gBAAgB,EAAE,KAAK;IACvB,4BAA4B,EAAE,CAAC;IAC/B,uBAAuB,EAAE,EAAE;IAC3B,gBAAgB,EAAE;QACd;YACI,EAAE,EAAE,UAAU;YACd,IAAI,EAAE,mBAAmB;YACzB,QAAQ,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,iBAAiB,CAAC;YAChD,UAAU,EAAE,aAAa;YACzB,QAAQ,EAAE,eAAe;SAC5B;QACD;YACI,EAAE,EAAE,QAAQ;YACZ,IAAI,EAAE,iBAAiB;YACvB,QAAQ,EAAE,CAAC,KAAK,EAAE,aAAa,EAAE,gBAAgB,CAAC;YAClD,UAAU,EAAE,aAAa;YACzB,QAAQ,EAAE,eAAe;SAC5B;QACD;YACI,EAAE,EAAE,YAAY;YAChB,IAAI,EAAE,qBAAqB;YAC3B,QAAQ,EAAE,CAAC,QAAQ,EAAE,KAAK,EAAE,IAAI,CAAC;YACjC,UAAU,EAAE,aAAa;YACzB,QAAQ,EAAE,eAAe;SAC5B;QACD;YACI,EAAE,EAAE,aAAa;YACjB,IAAI,EAAE,aAAa;YACnB,OAAO,EAAE,CAAC,eAAe,EAAE,iBAAiB,CAAC;YAC7C,QAAQ,EAAE,eAAe;SAC5B;KACJ;IACD,kBAAkB,EAAE,EAAE;IACtB,eAAe,EAAE,MAAM;CAC1B,CAAC"}

package/dist/index.d.ts

@@ -1,3 +1,7 @@
-import { QuotaHubPlugin } from "./src/index";
+import { type Plugin } from "@opencode-ai/plugin";
+/**
+ * QuotaHub Plugin for OpenCode.ai
+ */
+export declare const QuotaHubPlugin: Plugin;
 export default QuotaHubPlugin;
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,eAAe,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,MAAM,EAAc,MAAM,qBAAqB,CAAC;AAgD9D;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,MAgjB5B,CAAC;AAEF,eAAe,cAAc,CAAC"}