opencode-copilot-usage-detector 0.1.0

package/dist/tools.js

@@ -0,0 +1,300 @@
+import { tool } from "@opencode-ai/plugin/tool";
+import { getDaily, getCurrentRPM } from "./aggregator.js";
+import { readObservations, readEstimates, getDataDir, readConfig } from "./persistence.js";
+import { getBudgetStatus, computeEstimates } from "./estimator.js";
+import { pollPremiumRequests, getCachedPremiumRequests, getApiStatus, formatPremiumRequestStatus } from "./github-api.js";
+function formatTokens(n) {
+    if (n >= 1_000_000)
+        return `${(n / 1_000_000).toFixed(1)}M`;
+    if (n >= 1_000)
+        return `${(n / 1_000).toFixed(0)}K`;
+    return String(n);
+}
+export function formatStatus() {
+    const d = getDaily();
+    const rpm = getCurrentRPM();
+    const config = readConfig();
+    const status = getBudgetStatus(d.totalTokens, d.totalRequests, d.totalCost, d.byModel, d.limitHits.length, config.known_preview_models, config.known_stable_models, config.premium_request_multipliers);
+    // Premium requests from GitHub API
+    const pr = getCachedPremiumRequests();
+    const lines = [
+        `## Copilot Budget Status — ${d.date}`,
+        "",
+    ];
+    if (pr) {
+        lines.push("### Monthly Premium Requests");
+        lines.push("");
+        lines.push(formatPremiumRequestStatus(pr));
+        lines.push(`*Last updated: ${pr.fetchedAt}*`);
+        lines.push("");
+    }
+    else {
+        const apiSt = getApiStatus();
+        if (apiSt.authMethod === "none" && apiSt.lastError) {
+            lines.push(`*Premium request API: ${apiSt.lastError}*`);
+            lines.push("");
+        }
+    }
+    lines.push(`**Total tokens today:** ${formatTokens(d.totalTokens)}`, `**Total requests today:** ${d.totalRequests}`, `**Total cost today:** $${d.totalCost.toFixed(4)}`, `**Current RPM:** ${rpm} req/min (peak: ${d.peakRPM})`, "");
+    // Estimates
+    if (status.estimatedTokenLimit) {
+        const confStr = Math.round(status.confidence * 100);
+        lines.push(`**Estimated daily token limit:** ~${formatTokens(status.estimatedTokenLimit)} (${confStr}% confidence)`);
+        if (status.percentage !== null) {
+            lines.push(`**Usage:** ~${status.percentage}%`);
+        }
+        lines.push(`**Limit type:** ${status.activeLimitType}`);
+        lines.push("");
+    }
+    else {
+        lines.push("**Estimated daily limit:** Still learning (no limit hits observed yet)");
+        lines.push("");
+    }
+    if (status.estimatedRequestLimit) {
+        lines.push(`**Estimated daily request limit:** ~${status.estimatedRequestLimit}`);
+        lines.push("");
+    }
+    // Model breakdown
+    const models = Object.entries(d.byModel);
+    if (models.length > 0) {
+        lines.push("### Model Breakdown");
+        lines.push("");
+        lines.push("| Model | Tokens | Requests | Category |");
+        lines.push("|-------|--------|----------|----------|");
+        let estimates = null;
+        try {
+            estimates = readEstimates();
+        }
+        catch { /* */ }
+        for (const [model, usage] of models.sort((a, b) => b[1].tokens - a[1].tokens)) {
+            const cat = estimates?.models?.[model]?.category ?? "unknown";
+            lines.push(`| ${model} | ${formatTokens(usage.tokens)} | ${usage.requests} | ${cat} |`);
+        }
+        lines.push("");
+    }
+    // Preview warnings
+    if (status.previewWarnings) {
+        lines.push("### Preview Model Warnings");
+        lines.push("");
+        lines.push(status.previewWarnings);
+        lines.push("");
+    }
+    // Blocked models
+    if (d.blockedModels.length > 0) {
+        const uniqueBlocked = [...new Set(d.blockedModels.map((b) => b.model))];
+        lines.push(`### Blocked Models: ${uniqueBlocked.length}`);
+        lines.push("");
+        for (const model of uniqueBlocked) {
+            const first = d.blockedModels.find((b) => b.model === model);
+            lines.push(`- **${model}** — not available on your plan (status: ${first.statusCode ?? "?"})`);
+        }
+        lines.push("");
+    }
+    // Limit hits
+    if (d.limitHits.length > 0) {
+        lines.push(`### Limit Hits Today: ${d.limitHits.length}`);
+        lines.push("");
+        for (const hit of d.limitHits) {
+            lines.push(`- **${hit.ts.split("T")[1]?.split(".")[0] ?? hit.ts}** — ${hit.model} (class: ${hit.class}, tokens: ${formatTokens(hit.tokensAtHit)}, requests: ${hit.requestsAtHit}, RPM: ${hit.rpmAtHit})`);
+        }
+        lines.push("");
+    }
+    // Insights
+    if (status.insights) {
+        lines.push("### Insights");
+        lines.push("");
+        lines.push(status.insights);
+        lines.push("");
+    }
+    lines.push(`*Data dir: ${getDataDir()}*`);
+    return lines.join("\n");
+}
+export function formatHistory(days) {
+    const dayEnds = readObservations({ type: "day_end" });
+    const recent = dayEnds.slice(-days);
+    if (recent.length === 0) {
+        return "No history yet. Keep using OpenCode and data will accumulate.";
+    }
+    const lines = [
+        `## Usage History (last ${days} days)`,
+        "",
+        "| Date | Tokens | Requests | Limit Hit |",
+        "|------|--------|----------|-----------|",
+    ];
+    for (const e of recent) {
+        if (e.type !== "day_end")
+            continue;
+        const date = e.ts.split("T")[0];
+        lines.push(`| ${date} | ${formatTokens(e.day_cumulative_tokens)} | ${e.day_cumulative_requests} | ${e.limit_hit ? "Yes" : "No"} |`);
+    }
+    return lines.join("\n");
+}
+export function formatErrors() {
+    const limitHits = readObservations({ type: "limit_hit" });
+    const reclassifications = readObservations({ type: "reclassify" });
+    const errorLogs = readObservations({ type: "error_logged" });
+    if (limitHits.length === 0 && errorLogs.length === 0) {
+        return "No errors logged yet.";
+    }
+    const reclassMap = new Map();
+    for (const r of reclassifications) {
+        if (r.type === "reclassify") {
+            reclassMap.set(r.ref_ts, r.new_class);
+        }
+    }
+    const lines = [];
+    // Rate limit events
+    if (limitHits.length > 0) {
+        const recent = limitHits.slice(-20);
+        lines.push(`## Rate Limit Events (${recent.length} of ${limitHits.length} total)`);
+        lines.push("");
+        for (const e of recent) {
+            if (e.type !== "limit_hit")
+                continue;
+            const finalClass = reclassMap.get(e.ts) ?? e.class;
+            lines.push(`### ${e.ts}`);
+            lines.push(`- **Model:** ${e.model}`);
+            lines.push(`- **Class:** ${e.class}${finalClass !== e.class ? ` -> ${finalClass}` : ""}`);
+            lines.push(`- **Status:** ${e.status_code ?? "unknown"}`);
+            lines.push(`- **Message:** ${e.error_message}`);
+            lines.push(`- **Retryable:** ${e.is_retryable}`);
+            lines.push(`- **Day totals at hit:** ${formatTokens(e.day_cumulative_tokens)} tokens, ${e.day_cumulative_requests} requests, ${e.requests_last_minute} RPM`);
+            if (e.response_headers) {
+                const rateLimitHeaders = Object.entries(e.response_headers)
+                    .filter(([k]) => k.toLowerCase().includes("rate") || k.toLowerCase().includes("retry"));
+                if (rateLimitHeaders.length > 0) {
+                    lines.push(`- **Rate-limit headers:**`);
+                    for (const [k, v] of rateLimitHeaders) {
+                        lines.push(`  - ${k}: ${v}`);
+                    }
+                }
+            }
+            lines.push("");
+        }
+    }
+    // Blocked model events
+    const blockedLogs = readObservations({ type: "model_blocked" });
+    if (blockedLogs.length > 0) {
+        const recent = blockedLogs.slice(-10);
+        lines.push(`## Blocked Models (${recent.length} of ${blockedLogs.length} total)`);
+        lines.push("");
+        for (const e of recent) {
+            if (e.type !== "model_blocked")
+                continue;
+            lines.push(`- **${e.ts}** — ${e.model}: ${e.error_message} (status: ${e.status_code ?? "?"})`);
+        }
+        lines.push("");
+    }
+    // Other logged errors
+    if (errorLogs.length > 0) {
+        const recent = errorLogs.slice(-10);
+        lines.push(`## Other Errors (${recent.length} of ${errorLogs.length} total)`);
+        lines.push("");
+        for (const e of recent) {
+            if (e.type !== "error_logged")
+                continue;
+            lines.push(`- **${e.ts}** — ${e.error_name}: ${e.error_message} (model: ${e.model}, status: ${e.status_code ?? "?"})`);
+        }
+        lines.push("");
+    }
+    return lines.join("\n");
+}
+export function formatInsights() {
+    const config = readConfig();
+    const estimates = computeEstimates(config.known_preview_models, config.known_stable_models, config.premium_request_multipliers);
+    const lines = [
+        "## Copilot Budget Insights",
+        "",
+        `**Data since:** ${estimates.dataSince.split("T")[0]}`,
+        `**Days observed:** ${estimates.totalDaysObserved}`,
+        `**Days with limit hit:** ${estimates.daysWithLimitHit}`,
+        "",
+    ];
+    // Global budget
+    const te = estimates.globalDailyBudget.tokenEstimate;
+    if (te.dataPoints > 0) {
+        lines.push("### Global Daily Budget");
+        lines.push(`- Token estimate: ~${formatTokens(te.value)} (+/- ${formatTokens(te.stdDev)})`);
+        lines.push(`- Confidence: ${Math.round(te.confidence * 100)}% (${te.dataPoints} data points)`);
+        lines.push(`- Active limit type: ${estimates.globalDailyBudget.activeLimitType}`);
+        lines.push("");
+    }
+    // Request frequency
+    if (estimates.requestFrequency.burstLimitEstimate) {
+        const be = estimates.requestFrequency.burstLimitEstimate;
+        lines.push("### Burst (RPM) Limit");
+        lines.push(`- Estimated: ~${Math.round(be.value)} req/min`);
+        lines.push(`- Confidence: ${Math.round(be.confidence * 100)}% (${be.dataPoints} data points)`);
+        lines.push("");
+    }
+    // Per-model estimates
+    const modelEntries = Object.entries(estimates.models);
+    if (modelEntries.length > 0) {
+        lines.push("### Model Categories");
+        lines.push("");
+        lines.push("| Model | Category | Source | Confidence | Own Limit | Errors |");
+        lines.push("|-------|----------|--------|------------|-----------|--------|");
+        for (const [model, est] of modelEntries) {
+            const ownLimit = est.ownLimit ? `~${formatTokens(est.ownLimit.value)}` : "-";
+            lines.push(`| ${model} | ${est.category} | ${est.categorySource} | ${Math.round(est.categoryConfidence * 100)}% | ${ownLimit} | ${est.totalErrors} |`);
+        }
+        lines.push("");
+    }
+    // Temporal patterns
+    if (estimates.temporalPatterns.typicalLimitTime) {
+        lines.push("### Temporal Patterns");
+        lines.push(`- Typical limit time: ${estimates.temporalPatterns.typicalLimitTime}`);
+        if (estimates.temporalPatterns.typicalLimitTimeStdDevMinutes) {
+            lines.push(`- Std dev: +/- ${Math.round(estimates.temporalPatterns.typicalLimitTimeStdDevMinutes)} min`);
+        }
+        lines.push(`- Reset type: ${estimates.temporalPatterns.resetHypothesis.type}`);
+        if (estimates.temporalPatterns.resetHypothesis.estimatedResetTime) {
+            lines.push(`- Estimated reset: ${estimates.temporalPatterns.resetHypothesis.estimatedResetTime}`);
+        }
+        lines.push("");
+    }
+    // Multiplier hypothesis
+    if (estimates.multiplierHypothesis.rawTokens.observations > 0) {
+        lines.push("### Multiplier Hypothesis");
+        lines.push(`- Active: ${estimates.multiplierHypothesis.activeHypothesis}`);
+        lines.push(`- Raw tokens fit: ${estimates.multiplierHypothesis.rawTokens.fitScore.toFixed(3)}`);
+        lines.push(`- Weighted tokens fit: ${estimates.multiplierHypothesis.weightedTokens.fitScore.toFixed(3)}`);
+        lines.push("");
+    }
+    // Insights
+    if (estimates.insights.length > 0) {
+        lines.push("### Generated Insights");
+        lines.push("");
+        for (const insight of estimates.insights) {
+            lines.push(`- **[${insight.type}]** ${insight.text} (${Math.round(insight.confidence * 100)}% confidence, ${insight.dataPoints} data points)`);
+        }
+        lines.push("");
+    }
+    return lines.join("\n");
+}
+export const budgetTool = tool({
+    description: "Check your GitHub Copilot token budget status, view usage history, get insights, and review errors. Actions: 'status' (current usage + estimates), 'history' (daily breakdown), 'insights' (learned patterns + estimates), 'errors' (rate limit + error log), 'recompute' (force recompute estimates).",
+    args: {
+        action: tool.schema.enum(["status", "history", "insights", "errors", "recompute"]),
+    },
+    async execute(args) {
+        switch (args.action) {
+            case "status":
+                return formatStatus();
+            case "history":
+                return formatHistory(14);
+            case "insights":
+                return formatInsights();
+            case "errors":
+                return formatErrors();
+            case "recompute": {
+                const config = readConfig();
+                computeEstimates(config.known_preview_models, config.known_stable_models, config.premium_request_multipliers);
+                return "Estimates recomputed from observations. Run `/budget insights` to see results.";
+            }
+            default:
+                return `Unknown action: ${args.action}`;
+        }
+    },
+});
+//# sourceMappingURL=tools.js.map

package/dist/tools.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,184 @@
+export interface UsageEvent {
+    ts: string;
+    type: "usage";
+    session: string;
+    model: string;
+    provider: string;
+    input_tokens: number;
+    output_tokens: number;
+    reasoning_tokens: number;
+    cache_read: number;
+    cache_write: number;
+    cost: number;
+    day_cumulative_tokens: number;
+    day_cumulative_requests: number;
+    requests_last_minute: number;
+    request_ok: true;
+}
+export interface LimitHitEvent {
+    ts: string;
+    type: "limit_hit";
+    session: string;
+    model: string;
+    provider: string;
+    day_cumulative_tokens: number;
+    day_cumulative_requests: number;
+    requests_last_minute: number;
+    error_name: string;
+    error_message: string;
+    error_raw: string;
+    status_code: number | undefined;
+    is_retryable: boolean;
+    response_headers: Record<string, string> | undefined;
+    response_body: string | undefined;
+    class: LimitClass;
+}
+export interface ReclassifyEvent {
+    ts: string;
+    type: "reclassify";
+    ref_ts: string;
+    old_class: LimitClass;
+    new_class: LimitClass;
+    reason: string;
+    evidence: Record<string, unknown>;
+}
+export interface RecoveryEvent {
+    ts: string;
+    type: "recovery";
+    model: string;
+    day_cumulative_tokens: number;
+    minutes_since_limit: number;
+}
+export interface ModelFallbackEvent {
+    ts: string;
+    type: "model_fallback";
+    requested: string;
+    received: string;
+    day_cumulative_tokens: number;
+}
+export interface DayEndEvent {
+    ts: string;
+    type: "day_end";
+    day_cumulative_tokens: number;
+    day_cumulative_requests: number;
+    limit_hit: boolean;
+    limit_hit_at_tokens: number | null;
+    limit_hit_at_requests: number | null;
+    models_used: Record<string, {
+        tokens: number;
+        requests: number;
+    }>;
+}
+export interface ModelBlockedEvent {
+    ts: string;
+    type: "model_blocked";
+    session: string;
+    model: string;
+    provider: string;
+    error_name: string;
+    error_message: string;
+    error_raw: string;
+    status_code: number | undefined;
+    is_retryable: boolean;
+    day_cumulative_tokens: number;
+    day_cumulative_requests: number;
+}
+export interface ErrorLoggedEvent {
+    ts: string;
+    type: "error_logged";
+    session: string;
+    model: string;
+    provider: string;
+    error_name: string;
+    error_message: string;
+    error_raw: string;
+    status_code: number | undefined;
+    is_retryable: boolean;
+}
+export type ObservationEvent = UsageEvent | LimitHitEvent | ReclassifyEvent | RecoveryEvent | ModelFallbackEvent | DayEndEvent | ModelBlockedEvent | ErrorLoggedEvent;
+export type LimitClass = "unknown" | "hard_daily_limit" | "preview_limit" | "burst_rpm_limit" | "unknown_recovery" | "model_blocked";
+export interface ModelUsage {
+    tokens: number;
+    requests: number;
+}
+export interface DailyState {
+    date: string;
+    totalTokens: number;
+    totalRequests: number;
+    totalCost: number;
+    byModel: Record<string, ModelUsage>;
+    requestTimestamps: number[];
+    peakRPM: number;
+    limitHits: Array<{
+        ts: string;
+        model: string;
+        class: LimitClass;
+        tokensAtHit: number;
+        requestsAtHit: number;
+        rpmAtHit: number;
+    }>;
+    blockedModels: Array<{
+        ts: string;
+        model: string;
+        errorMessage: string;
+        statusCode: number | undefined;
+    }>;
+    notifiedThresholds: Set<number>;
+    lastLimitHitTs: number | null;
+    inLimitState: boolean;
+}
+export interface SessionState {
+    id: string;
+    tokensThisSession: number;
+    requestsThisSession: number;
+    currentModel: string | null;
+    currentProvider: string | null;
+    notifiedThresholds: Set<number>;
+}
+export interface PluginConfig {
+    debug: boolean;
+    copilot_plan: string;
+    known_preview_models: string[];
+    known_stable_models: string[];
+    notification_thresholds: number[];
+    premium_request_multipliers: Record<string, number>;
+    monthly_premium_allowance: number;
+    timezone: string;
+    quiet_mode: boolean;
+}
+export interface PremiumRequestEntry {
+    date: string;
+    product: string;
+    sku: string;
+    quantity: number;
+    unitType: string;
+    pricePerUnit: number;
+    grossAmount: number;
+    discountAmount: number;
+    netAmount: number;
+    organizationName: string;
+    repositorySlug: string | null;
+}
+export interface BillingUsageResponse {
+    usageItems: PremiumRequestEntry[];
+    [key: string]: unknown;
+}
+export interface PremiumRequestSummary {
+    totalPremiumRequests: number;
+    byModel: Record<string, number>;
+    byProduct: Record<string, number>;
+    monthlyAllowance: number;
+    remaining: number;
+    percentUsed: number;
+    fetchedAt: string;
+}
+export type ApiAuthMethod = "copilot_token" | "gh_cli" | "none";
+export interface ApiStatus {
+    authMethod: ApiAuthMethod;
+    username: string | null;
+    lastFetch: number;
+    lastError: string | null;
+    premiumRequests: PremiumRequestSummary | null;
+}
+export declare const DEFAULT_CONFIG: PluginConfig;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,15 @@
+// ============================================================
+// Observation events (written to observations.jsonl)
+// ============================================================
+export const DEFAULT_CONFIG = {
+    debug: false,
+    copilot_plan: "pro",
+    known_preview_models: [],
+    known_stable_models: [],
+    notification_thresholds: [60, 80, 95],
+    premium_request_multipliers: {},
+    monthly_premium_allowance: 1000,
+    timezone: "Europe/Berlin",
+    quiet_mode: false,
+};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,qDAAqD;AACrD,+DAA+D;AAkO/D,MAAM,CAAC,MAAM,cAAc,GAAiB;IAC1C,KAAK,EAAE,KAAK;IACZ,YAAY,EAAE,KAAK;IACnB,oBAAoB,EAAE,EAAE;IACxB,mBAAmB,EAAE,EAAE;IACvB,uBAAuB,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC;IACrC,2BAA2B,EAAE,EAAE;IAC/B,yBAAyB,EAAE,IAAI;IAC/B,QAAQ,EAAE,eAAe;IACzB,UAAU,EAAE,KAAK;CAClB,CAAA"}

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "opencode-copilot-usage-detector",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "OpenCode plugin that tracks GitHub Copilot token usage, learns rate limits empirically, and proactively informs the user",
+  "main": "./dist/copilot-budget.js",
+  "types": "./dist/copilot-budget.d.ts",
+  "files": [
+    "dist/",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "clean": "rm -rf dist",
+    "typecheck": "tsc --noEmit",
+    "test": "node --import tsx --test tests/**/*.test.ts",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "opencode",
+    "opencode-plugin",
+    "plugin",
+    "copilot",
+    "budget",
+    "rate-limit",
+    "token-tracking"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/moodl/opencode-copilot-usage-detector.git"
+  },
+  "author": "moodl",
+  "license": "MIT",
+  "peerDependencies": {
+    "@opencode-ai/plugin": ">=1.2.0"
+  },
+  "devDependencies": {
+    "@opencode-ai/plugin": "^1.2.27",
+    "@opencode-ai/sdk": "^1.2.27",
+    "@types/node": "^22.0.0",
+    "tsx": "^4.21.0",
+    "typescript": "^5.8.0"
+  }
+}