opencode-copilot-usage-detector 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,20 @@
+# Changelog
+
+## 0.1.0 (2026-03-21)
+
+Initial release.
+
+### Features
+- Token and request tracking per day/model with RPM monitoring
+- 5-stage rate-limit classifier (burst, preview, daily)
+- Adaptive limit estimator with confidence scoring and 14-day decay
+- System prompt injection with budget status on every LLM turn
+- `/budget` slash command (status, history, insights, errors, recompute)
+- GitHub billing API integration for premium request tracking
+- Preview model auto-detection
+- Temporal pattern analysis and insight generation
+- Model fallback detection
+- Configurable threshold notifications (60%, 80%, 95%)
+- Timezone-aware day boundaries
+- JSONL auto-rotation (50MB / 90 days)
+- Debug event logging mode

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 moodl
+
+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,336 @@
+# opencode-copilot-usage-detector
+
+> **Experimental** — This plugin is in early development. Features may change, data formats may evolve, and there will be rough edges. Use at your own risk and please [report issues](https://github.com/moodl/opencode-copilot-usage-detector/issues).
+
+An [OpenCode](https://opencode.ai) plugin that tracks GitHub Copilot token usage across sessions, empirically learns rate limits, and proactively informs you before you hit them.
+
+## The Problem
+
+GitHub Copilot doesn't publish concrete token/request limits for the coding assistant. There are multiple opaque limit tiers:
+
+- **Monthly premium requests** with model-specific multipliers
+- **Short-term burst limits** per time window
+- **Preview model limits** that are separate and stricter
+
+This plugin learns these limits from your own usage patterns and warns you as you approach them.
+
+## Features
+
+- **Token & request tracking** — Per-day, per-model usage with RPM monitoring
+- **Adaptive limit learning** — Weighted averages with exponential recency decay and confidence scoring
+- **Multi-dimensional hypothesis tracking** — Learns whether limits are token-based, request-based, or RPM-based
+- **Preview model detection** — Automatically identifies models with separate, stricter limits
+- **Rate-limit classification** — 5-stage classifier distinguishing burst, preview, and daily limits
+- **System prompt injection** — Budget status in every LLM context (zero tool-call overhead)
+- **Threshold notifications** — Configurable alerts at 60%, 80%, 95% of estimated limits
+- **Temporal patterns** — Learns what time of day you typically hit limits and how model choice affects runway
+- **Model fallback detection** — Detects when Copilot silently downgrades your model
+- **GitHub billing API integration** — Fetches real premium request usage when auth is available
+- **Full error catalog** — Logs all API errors for pattern analysis
+
+## Requirements
+
+- [OpenCode](https://opencode.ai) v1.2.0 or later
+- Node.js 18+
+- GitHub Copilot subscription
+
+## Installation
+
+### 1. Install the package
+
+```bash
+cd ~/.config/opencode
+npm install git+https://github.com/moodl/opencode-copilot-usage-detector.git
+```
+
+### 2. Register the plugin
+
+Add it to your `~/.config/opencode/opencode.json`:
+
+```json
+{
+  "plugin": ["opencode-copilot-usage-detector"]
+}
+```
+
+If you already have other plugins, add it to the existing array:
+
+```json
+{
+  "plugin": ["@tarquinen/opencode-dcp@latest", "opencode-copilot-usage-detector"]
+}
+```
+
+### 3. Restart OpenCode
+
+The plugin loads automatically on startup. Use `/budget` to verify it's working.
+
+### Updating
+
+```bash
+cd ~/.config/opencode
+npm install git+https://github.com/moodl/opencode-copilot-usage-detector.git
+```
+
+Then restart OpenCode.
+
+## Usage
+
+The plugin works automatically -- no action needed. It:
+
+1. Tracks every LLM request via event hooks
+2. Injects budget status into the system prompt
+3. Notifies you in chat when approaching estimated limits
+4. Logs everything to `~/.config/copilot-budget/observations.jsonl`
+
+### `/budget` Command
+
+| Command | Description |
+|---------|-------------|
+| `/budget` or `/budget status` | Current usage, estimates, and model breakdown |
+| `/budget history` | Daily token usage for the last 14 days |
+| `/budget insights` | Learned patterns, limit estimates, temporal analysis |
+| `/budget errors` | Rate limit events and error catalog |
+| `/budget recompute` | Force recompute all estimates from observations |
+
+### Example: `/budget status`
+
+```
+## Copilot Budget Status — 2026-03-21
+
+### Monthly Premium Requests
+Premium requests this month: 147 / 300 (49% used, 153 remaining)
+  claude-opus-4.5: 89 requests
+  gpt-5.4-mini: 58 requests
+*Last updated: 2026-03-21T14:30:00Z*
+
+**Total tokens today:** 1.8M
+**Total requests today:** 67
+**Total cost today:** $0.0000
+**Current RPM:** 3 req/min (peak: 7)
+
+**Estimated daily token limit:** ~2.9M (82% confidence)
+**Usage:** ~63%
+**Limit type:** tokens
+
+### Model Breakdown
+
+| Model            | Tokens | Requests | Category |
+|------------------|--------|----------|----------|
+| claude-opus-4.5  | 1.4M   | 42       | stable   |
+| gpt-5.4-mini     | 422K   | 25       | stable   |
+```
+
+### Example: System Prompt Injection
+
+Every LLM response automatically sees this context (no tool call needed):
+
+```xml
+<copilot-budget>
+Premium requests this month: 147 / 300 (49% used, 153 remaining)
+Daily token usage: 1.8M tokens (67 requests)
+Estimated daily limit: ~2.9M tokens (confidence: 82%)
+Usage percentage: ~63%
+Cost today: $0.0000
+Current rate: 3 req/min (peak: 7)
+
+Model breakdown:
+  claude-opus-4.5: 1.4M tokens / 42 requests (stable)
+  gpt-5.4-mini: 422K tokens / 25 requests (stable)
+</copilot-budget>
+```
+
+### Example: Threshold Notification
+
+When approaching a learned limit, you'll see a chat message like:
+
+```
+⚡ 80% of daily Copilot budget used (2.3M / ~2.9M est.)
+```
+
+### Example: Rate Limit Alert
+
+```
+🔴 Rate limited! Day total: 2.8M tokens, 142 requests
+   Model: claude-opus-4.5 | Status: 429 | Class: hard_daily_limit
+   Run `/budget errors` for details.
+```
+
+### Example: `/budget insights`
+
+After accumulating data over several days:
+
+```
+## Copilot Budget Insights
+
+**Data since:** 2026-03-01
+**Days observed:** 21
+**Days with limit hit:** 8
+
+### Global Daily Budget
+- Token estimate: ~2.9M (+/- 210K)
+- Confidence: 82% (8 data points)
+- Active limit type: tokens
+
+### Model Categories
+
+| Model            | Category | Source | Confidence | Own Limit | Errors |
+|------------------|----------|--------|------------|-----------|--------|
+| claude-opus-4.5  | stable   | auto   | 95%        | -         | 5      |
+| claude-opus-4.6  | preview  | auto   | 88%        | ~400K     | 4      |
+| gpt-5.4-mini     | stable   | auto   | 90%        | -         | 1      |
+
+### Temporal Patterns
+- Typical limit time: 16:30
+- Std dev: +/- 75 min
+- Reset type: daily_fixed
+- Estimated reset: 00:00
+
+### Generated Insights
+- **[model_impact]** claude-opus-4.5-heavy days hit limits ~2.1h earlier
+  than mixed days (75% confidence, 8 data points)
+- **[preview_detection]** claude-opus-4.6 has separate preview limit
+  (~400K tokens) (88% confidence, 4 data points)
+```
+
+## Configuration
+
+Optionally create `~/.config/copilot-budget/config.json`:
+
+```json
+{
+  "debug": false,
+  "copilot_plan": "pro",
+  "known_preview_models": [],
+  "known_stable_models": [],
+  "notification_thresholds": [60, 80, 95],
+  "premium_request_multipliers": {
+    "claude-opus-4.5": 3.0,
+    "claude-sonnet-4.5": 1.0,
+    "gpt-5.4-mini": 0.33
+  },
+  "monthly_premium_allowance": 1000,
+  "timezone": "Europe/Berlin",
+  "quiet_mode": false
+}
+```
+
+All fields are optional -- sensible defaults are used.
+
+| Field | Description | Default |
+|-------|-------------|---------|
+| `debug` | Log all events to `debug-events.jsonl` | `false` |
+| `copilot_plan` | Your Copilot plan (`free`, `pro`, `pro+`, `business`, `enterprise`) | `"pro"` |
+| `known_preview_models` | Models to always treat as preview | `[]` |
+| `known_stable_models` | Models to always treat as stable | `[]` |
+| `notification_thresholds` | Percentage thresholds for chat warnings | `[60, 80, 95]` |
+| `premium_request_multipliers` | Model cost multipliers for weighted tracking | `{}` |
+| `monthly_premium_allowance` | Override monthly premium request allowance | `1000` |
+| `timezone` | Timezone for day boundaries (e.g., `Europe/Berlin`, `America/New_York`) | `"UTC"` |
+| `quiet_mode` | Suppress threshold notifications | `false` |
+
+## Data Storage
+
+All data is stored locally in `~/.config/copilot-budget/`:
+
+| File | Description |
+|------|-------------|
+| `observations.jsonl` | Append-only event log (source of truth) |
+| `estimates.json` | Derived limit model (can be deleted and regenerated) |
+| `config.json` | User configuration |
+| `debug-events.jsonl` | Debug event log (only when `debug: true`) |
+
+The JSONL file auto-rotates at 50MB or when entries are older than 90 days. No data is sent anywhere -- everything stays on your machine.
+
+## How It Learns
+
+1. **Aggregation** -- Every LLM response's token counts are recorded per model per day
+2. **Error detection** -- API errors (especially HTTP 429) are captured with full context including response headers
+3. **Classification** -- A 5-stage classifier determines if an error is a burst limit, preview limit, or daily limit
+4. **Estimation** -- Weighted averages with 14-day half-life produce limit estimates with confidence scores
+5. **Insight generation** -- After accumulating data, the system identifies patterns (e.g., "opus-heavy days hit limits 2h earlier")
+
+## Architecture
+
+```
+Plugin Entry (copilot-budget.ts)
++-- Config Hook (registers /budget command)
++-- Command Handler (/budget subcommands)
++-- Event Handler (message.updated, session.error)
++-- chat.params Hook (per-session model/provider capture)
++-- System Prompt Injection
++-- Session Compaction Context
++-- Budget Tool (for LLM tool-calling)
+
+Aggregator (aggregator.ts)
++-- Token + Request counting (per-session, per-model)
++-- RPM tracking (sliding window)
++-- Day rollover + recovery detection
++-- Startup recovery from JSONL
+
+Classifier (classifier.ts)
++-- Stage 1: Error message pattern matching
++-- Stage 2: Cross-model correlation
++-- Stage 3: Cancel-rate analysis
++-- Stage 4: Global budget comparison
++-- Stage 5: Recovery-time classification
++-- Delayed reclassification (10-min timer)
+
+Estimator (estimator.ts)
++-- Global daily budget (weighted average)
++-- Per-model estimates
++-- Limit dimension hypotheses (tokens/requests/RPM)
++-- Model category detection (stable/preview)
++-- Temporal pattern analysis
++-- Multiplier hypothesis tracking
++-- Insight generation
+
+GitHub API (github-api.ts)
++-- Premium request usage from billing API
++-- Multi-strategy auth (Copilot token, gh CLI, fallback)
++-- Periodic polling (15-min interval)
+
+Persistence (persistence.ts)
++-- JSONL append + filtered read
++-- Atomic rotation (size/age)
++-- Estimates read/write
++-- Config management
+```
+
+## Development
+
+```bash
+git clone https://github.com/moodl/opencode-copilot-usage-detector.git
+cd opencode-copilot-usage-detector
+npm install
+npm run build
+npm test
+```
+
+After code changes:
+
+```bash
+npm run build
+cd ~/.config/opencode
+npm install /path/to/opencode-copilot-usage-detector
+# Restart OpenCode
+```
+
+## Disclaimer
+
+This project is **not affiliated with, endorsed by, or associated with GitHub, Microsoft, or OpenCode** in any way. It is an independent, community-built tool.
+
+- This plugin observes your local usage patterns and API error responses. It does **not** access any private or undocumented APIs beyond the public GitHub billing endpoints (which require explicit user authorization).
+- Rate limit estimates are **empirical approximations**, not official figures. GitHub may change limits at any time without notice.
+- The authors assume **no responsibility** for any consequences of using this plugin, including but not limited to: account restrictions, incorrect estimates, missed rate limits, or any impact on your GitHub Copilot service.
+- All data collected by this plugin is stored **locally on your machine** and is never transmitted to any external service.
+
+## License
+
+[MIT](LICENSE) -- see [LICENSE](LICENSE) for full text.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND. See the license for the complete terms.
+
+## Contributing
+
+Contributions are welcome! Please open an issue first to discuss what you'd like to change.

package/dist/aggregator.d.ts

@@ -0,0 +1,40 @@
+import type { DailyState, SessionState } from "./types.js";
+export declare function setTimezone(tz: string): void;
+export declare function getCurrentRPM(): number;
+export declare function recoverFromJSONL(): void;
+export interface AssistantTokens {
+    total: number;
+    input: number;
+    output: number;
+    reasoning: number;
+    cache: {
+        read: number;
+        write: number;
+    };
+}
+export interface IncomingMessage {
+    messageId: string;
+    sessionId: string;
+    modelId: string;
+    providerId: string;
+    tokens: AssistantTokens;
+    cost: number;
+    finished: boolean;
+}
+export declare function processAssistantMessage(msg: IncomingMessage): void;
+export interface IncomingError {
+    sessionId: string | undefined;
+    errorName: string;
+    errorMessage: string;
+    errorRaw: string;
+    statusCode: number | undefined;
+    isRetryable: boolean;
+    responseHeaders: Record<string, string> | undefined;
+    responseBody: string | undefined;
+}
+export declare function processErrorEvent(err: IncomingError, lastRequestedModel: string | null, lastRequestedProvider: string | null): string;
+export declare function getDaily(): DailyState;
+export declare function getSession(id: string): SessionState;
+/** Reset all module-level state. For testing only. */
+export declare function resetState(): void;
+//# sourceMappingURL=aggregator.d.ts.map

package/dist/aggregator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aggregator.d.ts","sourceRoot":"","sources":["../src/aggregator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAc,YAAY,EAAc,MAAM,YAAY,CAAA;AAoBlF,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAE5C;AA6CD,wBAAgB,aAAa,IAAI,MAAM,CAGtC;AAoCD,wBAAgB,gBAAgB,IAAI,IAAI,CA8CvC;AAMD,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAA;CACvC;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,MAAM,CAAA;IACf,UAAU,EAAE,MAAM,CAAA;IAClB,MAAM,EAAE,eAAe,CAAA;IACvB,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,OAAO,CAAA;CAClB;AAED,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,eAAe,GAAG,IAAI,CA6DlE;AAMD,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,GAAG,SAAS,CAAA;IAC7B,SAAS,EAAE,MAAM,CAAA;IACjB,YAAY,EAAE,MAAM,CAAA;IACpB,QAAQ,EAAE,MAAM,CAAA;IAChB,UAAU,EAAE,MAAM,GAAG,SAAS,CAAA;IAC9B,WAAW,EAAE,OAAO,CAAA;IACpB,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAA;IACnD,YAAY,EAAE,MAAM,GAAG,SAAS,CAAA;CACjC;AAED,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,aAAa,EAClB,kBAAkB,EAAE,MAAM,GAAG,IAAI,EACjC,qBAAqB,EAAE,MAAM,GAAG,IAAI,GACnC,MAAM,CAsCR;AAMD,wBAAgB,QAAQ,IAAI,UAAU,CAGrC;AAED,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,YAAY,CAcnD;AAED,sDAAsD;AACtD,wBAAgB,UAAU,IAAI,IAAI,CAIjC"}

package/dist/aggregator.js

@@ -0,0 +1,254 @@
+import { appendObservation, readTodayObservations } from "./persistence.js";
+// ============================================================
+// Globals
+// ============================================================
+let daily = createEmptyDay();
+const sessions = new Map();
+// Track the last processed message ID to avoid double-counting.
+// message.updated fires multiple times for the same message as parts stream in.
+const processedMessages = new Set();
+// ============================================================
+// Helpers
+// ============================================================
+let configuredTimezone = "UTC";
+export function setTimezone(tz) {
+    configuredTimezone = tz;
+}
+function todayString() {
+    try {
+        // 'sv' locale gives YYYY-MM-DD format on full-ICU Node.js builds
+        const result = new Date().toLocaleDateString("sv", { timeZone: configuredTimezone });
+        // Validate output is actually YYYY-MM-DD (silent fallback on minimal-ICU builds)
+        if (/^\d{4}-\d{2}-\d{2}$/.test(result))
+            return result;
+    }
+    catch {
+        // Timezone not supported or locale unavailable
+    }
+    return new Date().toISOString().split("T")[0];
+}
+function createEmptyDay() {
+    return {
+        date: todayString(),
+        totalTokens: 0,
+        totalRequests: 0,
+        totalCost: 0,
+        byModel: {},
+        requestTimestamps: [],
+        peakRPM: 0,
+        limitHits: [],
+        blockedModels: [],
+        notifiedThresholds: new Set(),
+        lastLimitHitTs: null,
+        inLimitState: false,
+    };
+}
+function ensureModel(model) {
+    if (!daily.byModel[model]) {
+        daily.byModel[model] = { tokens: 0, requests: 0 };
+    }
+    return daily.byModel[model];
+}
+function pruneRpmWindow() {
+    const now = Date.now();
+    daily.requestTimestamps = daily.requestTimestamps.filter((ts) => now - ts < 60_000);
+}
+export function getCurrentRPM() {
+    pruneRpmWindow();
+    return daily.requestTimestamps.length;
+}
+// ============================================================
+// Day rollover
+// ============================================================
+function checkDayRollover() {
+    const today = todayString();
+    if (daily.date !== today) {
+        // Write day_end event for previous day
+        const dayEnd = {
+            ts: daily.date + "T23:59:59",
+            type: "day_end",
+            day_cumulative_tokens: daily.totalTokens,
+            day_cumulative_requests: daily.totalRequests,
+            limit_hit: daily.limitHits.length > 0,
+            limit_hit_at_tokens: daily.limitHits.length > 0
+                ? daily.limitHits[0].tokensAtHit
+                : null,
+            limit_hit_at_requests: daily.limitHits.length > 0
+                ? daily.limitHits[0].requestsAtHit
+                : null,
+            models_used: { ...daily.byModel },
+        };
+        appendObservation(dayEnd);
+        // Reset for new day
+        daily = createEmptyDay();
+        processedMessages.clear();
+    }
+}
+// ============================================================
+// Startup recovery
+// ============================================================
+export function recoverFromJSONL() {
+    const today = todayString();
+    const events = readTodayObservations(today);
+    daily = createEmptyDay();
+    processedMessages.clear();
+    for (const event of events) {
+        if (event.type === "usage") {
+            const tokens = event.input_tokens +
+                event.output_tokens +
+                event.reasoning_tokens +
+                event.cache_read +
+                event.cache_write;
+            daily.totalTokens += tokens;
+            daily.totalRequests += 1;
+            daily.totalCost += event.cost;
+            const m = ensureModel(event.model);
+            m.tokens += tokens;
+            m.requests += 1;
+        }
+        if (event.type === "limit_hit") {
+            daily.limitHits.push({
+                ts: event.ts,
+                model: event.model,
+                class: event.class,
+                tokensAtHit: event.day_cumulative_tokens,
+                requestsAtHit: event.day_cumulative_requests,
+                rpmAtHit: event.requests_last_minute,
+            });
+            daily.inLimitState = true;
+            daily.lastLimitHitTs = new Date(event.ts).getTime();
+        }
+        if (event.type === "model_blocked") {
+            daily.blockedModels.push({
+                ts: event.ts,
+                model: event.model,
+                errorMessage: event.error_message,
+                statusCode: event.status_code,
+            });
+        }
+        if (event.type === "recovery") {
+            daily.inLimitState = false;
+        }
+    }
+}
+export function processAssistantMessage(msg) {
+    checkDayRollover();
+    // Only process finished messages, and only once
+    if (!msg.finished)
+        return;
+    if (processedMessages.has(msg.messageId))
+        return;
+    processedMessages.add(msg.messageId);
+    // Skip zero-token messages (e.g. empty responses)
+    const totalTokens = msg.tokens.input + msg.tokens.output + msg.tokens.reasoning +
+        msg.tokens.cache.read + msg.tokens.cache.write;
+    if (totalTokens === 0)
+        return;
+    // Update daily state
+    daily.totalTokens += totalTokens;
+    daily.totalRequests += 1;
+    daily.totalCost += msg.cost;
+    const m = ensureModel(msg.modelId);
+    m.tokens += totalTokens;
+    m.requests += 1;
+    // RPM tracking
+    daily.requestTimestamps.push(Date.now());
+    pruneRpmWindow();
+    daily.peakRPM = Math.max(daily.peakRPM, daily.requestTimestamps.length);
+    // If we were in a limit state and now got a successful response, that's a recovery
+    if (daily.inLimitState) {
+        const minutesSinceLimit = daily.lastLimitHitTs
+            ? (Date.now() - daily.lastLimitHitTs) / 60_000
+            : 0;
+        appendObservation({
+            ts: new Date().toISOString(),
+            type: "recovery",
+            model: msg.modelId,
+            day_cumulative_tokens: daily.totalTokens,
+            minutes_since_limit: Math.round(minutesSinceLimit),
+        });
+        daily.inLimitState = false;
+    }
+    // Write observation
+    const event = {
+        ts: new Date().toISOString(),
+        type: "usage",
+        session: msg.sessionId,
+        model: msg.modelId,
+        provider: msg.providerId,
+        input_tokens: msg.tokens.input,
+        output_tokens: msg.tokens.output,
+        reasoning_tokens: msg.tokens.reasoning,
+        cache_read: msg.tokens.cache.read,
+        cache_write: msg.tokens.cache.write,
+        cost: msg.cost,
+        day_cumulative_tokens: daily.totalTokens,
+        day_cumulative_requests: daily.totalRequests,
+        requests_last_minute: getCurrentRPM(),
+        request_ok: true,
+    };
+    appendObservation(event);
+}
+export function processErrorEvent(err, lastRequestedModel, lastRequestedProvider) {
+    checkDayRollover();
+    const rpm = getCurrentRPM();
+    const ts = new Date().toISOString();
+    appendObservation({
+        ts,
+        type: "limit_hit",
+        session: err.sessionId ?? "unknown",
+        model: lastRequestedModel ?? "unknown",
+        provider: lastRequestedProvider ?? "unknown",
+        day_cumulative_tokens: daily.totalTokens,
+        day_cumulative_requests: daily.totalRequests,
+        requests_last_minute: rpm,
+        error_name: err.errorName,
+        error_message: err.errorMessage,
+        error_raw: err.errorRaw,
+        status_code: err.statusCode,
+        is_retryable: err.isRetryable,
+        response_headers: err.responseHeaders,
+        response_body: err.responseBody,
+        class: "unknown",
+    });
+    daily.limitHits.push({
+        ts,
+        model: lastRequestedModel ?? "unknown",
+        class: "unknown",
+        tokensAtHit: daily.totalTokens,
+        requestsAtHit: daily.totalRequests,
+        rpmAtHit: rpm,
+    });
+    daily.inLimitState = true;
+    daily.lastLimitHitTs = Date.now();
+    return ts;
+}
+// ============================================================
+// Getters for other modules
+// ============================================================
+export function getDaily() {
+    checkDayRollover();
+    return daily;
+}
+export function getSession(id) {
+    let s = sessions.get(id);
+    if (!s) {
+        s = {
+            id,
+            tokensThisSession: 0,
+            requestsThisSession: 0,
+            currentModel: null,
+            currentProvider: null,
+            notifiedThresholds: new Set(),
+        };
+        sessions.set(id, s);
+    }
+    return s;
+}
+/** Reset all module-level state. For testing only. */
+export function resetState() {
+    daily = createEmptyDay();
+    sessions.clear();
+    processedMessages.clear();
+}
+//# sourceMappingURL=aggregator.js.map

package/dist/aggregator.js.map

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