opencode-quotas 0.0.1

package/dist/src/providers/github.d.ts

@@ -0,0 +1,4 @@
+import { type IQuotaProvider, type QuotaData } from "../interfaces";
+export declare function parseGithubUsage(data: unknown, sku: string | null, apiWarning?: string | null): QuotaData[];
+export declare function createGithubProvider(): IQuotaProvider;
+//# sourceMappingURL=github.d.ts.map

package/dist/src/providers/github.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"github.d.ts","sourceRoot":"","sources":["../../../src/providers/github.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,cAAc,EAAE,KAAK,SAAS,EAAE,MAAM,eAAe,CAAC;AAsDpE,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAAE,CAoD3G;AAED,wBAAgB,oBAAoB,IAAI,cAAc,CAiDrD"}

package/dist/src/providers/github.js

@@ -0,0 +1,139 @@
+import { readFile } from "node:fs/promises";
+import { AUTH_FILE, getConfigDirectory } from "../utils/paths";
+import { join } from "node:path";
+const AUTH_PATH_LOCAL = AUTH_FILE();
+const AUTH_PATH_CONFIG = join(getConfigDirectory(), "auth.json");
+async function readAuthFile() {
+    for (const path of [AUTH_PATH_LOCAL, AUTH_PATH_CONFIG]) {
+        try {
+            const raw = await readFile(path, "utf8");
+            return JSON.parse(raw);
+        }
+        catch {
+            continue;
+        }
+    }
+    return null;
+}
+function parseTokenSku(token) {
+    const parts = token.split(";");
+    for (const part of parts) {
+        if (part.startsWith("sku=")) {
+            return part.split("=")[1];
+        }
+    }
+    return null;
+}
+function getNextMonthStart() {
+    const now = new Date();
+    const nextMonth = new Date(Date.UTC(now.getUTCFullYear(), now.getUTCMonth() + 1, 1, 0, 0, 0));
+    return nextMonth;
+}
+function formatTimeUntil(target) {
+    const diff = target.getTime() - Date.now();
+    if (diff <= 0)
+        return "soon";
+    const days = Math.floor(diff / (1000 * 60 * 60 * 24));
+    const hours = Math.floor((diff % (1000 * 60 * 60 * 24)) / (1000 * 60 * 60));
+    if (days > 0)
+        return `${days}d ${hours}h`;
+    return `${hours}h`;
+}
+export function parseGithubUsage(data, sku, apiWarning) {
+    // free_engaged_oss_quota is actually a "pro" equivalent for OSS maintainers
+    const isFreeLimited = sku?.includes("free") && !sku?.includes("oss");
+    const now = new Date();
+    const resetTime = getNextMonthStart();
+    const resetStr = `resets in ${formatTimeUntil(resetTime)}`;
+    let usedSuggestions = 0;
+    let limit = isFreeLimited ? 2000 : null;
+    let unit = "suggestions";
+    if (Array.isArray(data) && data.length > 0) {
+        const currentMonthUsage = data.filter((day) => {
+            if (!day || typeof day !== "object")
+                return false;
+            const dayRecord = day;
+            const dayValue = dayRecord["day"];
+            if (typeof dayValue !== "string")
+                return false;
+            const dayDate = new Date(dayValue);
+            return dayDate.getUTCMonth() === now.getUTCMonth() && dayDate.getUTCFullYear() === now.getUTCFullYear();
+        });
+        usedSuggestions = currentMonthUsage.reduce((acc, day) => {
+            if (!day || typeof day !== "object")
+                return acc;
+            const dayRecord = day;
+            const suggestions = typeof dayRecord["total_suggestions_count"] === "number" ? dayRecord["total_suggestions_count"] : 0;
+            const chat = typeof dayRecord["total_chat_count"] === "number" ? dayRecord["total_chat_count"] : 0;
+            return acc + suggestions + chat;
+        }, 0);
+    }
+    const infoParts = [];
+    if (isFreeLimited)
+        infoParts.push("Free Plan");
+    else if (sku)
+        infoParts.push("Pro Plan");
+    if (apiWarning) {
+        infoParts.push("Service Currently Unavailable (API Deprecated)");
+    }
+    return [
+        {
+            id: "github-copilot",
+            providerName: "GitHub Copilot",
+            used: usedSuggestions,
+            limit: limit,
+            unit: unit,
+            reset: resetStr,
+            window: "Monthly",
+            info: infoParts.join(" | "),
+        }
+    ];
+}
+export function createGithubProvider() {
+    return {
+        id: "github-copilot",
+        async fetchQuota() {
+            const auth = await readAuthFile();
+            if (!auth) {
+                throw new Error("Opencode auth.json not found");
+            }
+            const info = auth["github-copilot"] || auth["github"];
+            if (!info || !info.access) {
+                throw new Error("GitHub Copilot credentials missing");
+            }
+            const sku = parseTokenSku(info.access);
+            // Note: GitHub does not currently support a user-level Copilot usage
+            // endpoint for individual accounts. The legacy/beta endpoints were
+            // deprecated (and may return 404). We still attempt the call, but we
+            // surface failures as provider metadata so users can diagnose.
+            let data = null;
+            let apiWarning = null;
+            try {
+                const response = await fetch("https://api.github.com/user/copilot/usage", {
+                    headers: {
+                        Authorization: `Bearer ${info.access}`,
+                        "X-GitHub-Api-Version": "2022-11-28",
+                        Accept: "application/vnd.github+json",
+                    },
+                });
+                if (!response.ok) {
+                    if (response.status === 404) {
+                        apiWarning = "404";
+                    }
+                    else {
+                        const body = await response.text();
+                        apiWarning = `${response.status}: ${body.slice(0, 50)}`;
+                    }
+                }
+                else {
+                    data = (await response.json());
+                }
+            }
+            catch (error) {
+                apiWarning = "Request Failed";
+            }
+            return parseGithubUsage(data, sku, apiWarning);
+        },
+    };
+}
+//# sourceMappingURL=github.js.map

package/dist/src/providers/github.js.map

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

package/dist/src/quota-cache.d.ts

@@ -0,0 +1,26 @@
+import { type IQuotaProvider, type QuotaData, type IHistoryService } from "./interfaces";
+type CachedQuotas = {
+    data: QuotaData[];
+    fetchedAt: Date | null;
+    lastError: unknown;
+};
+type QuotaCacheOptions = {
+    refreshIntervalMs: number;
+    historyService?: IHistoryService;
+    debug?: boolean;
+};
+export declare class QuotaCache {
+    private readonly providers;
+    private readonly options;
+    private state;
+    private timer;
+    private inFlight;
+    constructor(providers: IQuotaProvider[], options?: Partial<QuotaCacheOptions>);
+    start(): void;
+    stop(): void;
+    getSnapshot(): CachedQuotas;
+    refresh(): Promise<void>;
+    private doRefresh;
+}
+export {};
+//# sourceMappingURL=quota-cache.d.ts.map

package/dist/src/quota-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quota-cache.d.ts","sourceRoot":"","sources":["../../src/quota-cache.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,cAAc,EAAE,KAAK,SAAS,EAAE,KAAK,eAAe,EAAE,MAAM,cAAc,CAAC;AAKzF,KAAK,YAAY,GAAG;IAChB,IAAI,EAAE,SAAS,EAAE,CAAC;IAClB,SAAS,EAAE,IAAI,GAAG,IAAI,CAAC;IACvB,SAAS,EAAE,OAAO,CAAC;CACtB,CAAC;AAEF,KAAK,iBAAiB,GAAG;IACrB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,cAAc,CAAC,EAAE,eAAe,CAAC;IACjC,KAAK,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAMF,qBAAa,UAAU;IACnB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAmB;IAC7C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoB;IAC5C,OAAO,CAAC,KAAK,CAAe;IAC5B,OAAO,CAAC,KAAK,CAAwC;IACrD,OAAO,CAAC,QAAQ,CAAuB;gBAEpB,SAAS,EAAE,cAAc,EAAE,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC;IAQ7E,KAAK,IAAI,IAAI;IAcb,IAAI,IAAI,IAAI;IAOZ,WAAW,IAAI,YAAY;IAIrB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;YAqBvB,SAAS;CA0E1B"}

package/dist/src/quota-cache.js

@@ -0,0 +1,107 @@
+import { validateQuotaData } from "./utils/validation";
+import { logger } from "./logger";
+const DEFAULT_OPTIONS = {
+    refreshIntervalMs: 60_000,
+};
+export class QuotaCache {
+    providers;
+    options;
+    state;
+    timer;
+    inFlight;
+    constructor(providers, options) {
+        this.providers = providers;
+        this.options = { ...DEFAULT_OPTIONS, ...(options ?? {}) };
+        this.state = { data: [], fetchedAt: null, lastError: null };
+        this.timer = null;
+        this.inFlight = null;
+    }
+    start() {
+        if (this.timer)
+            return;
+        // Kick off an initial refresh without blocking startup.
+        void this.refresh();
+        this.timer = setInterval(() => {
+            void this.refresh();
+        }, this.options.refreshIntervalMs);
+        // Avoid keeping the process alive just for quota polling.
+        this.timer.unref?.();
+    }
+    stop() {
+        if (this.timer) {
+            clearInterval(this.timer);
+            this.timer = null;
+        }
+    }
+    getSnapshot() {
+        return this.state;
+    }
+    async refresh() {
+        logger.debug("cache:refresh_start", {
+            providerCount: this.providers.length,
+            refreshIntervalMs: this.options.refreshIntervalMs,
+            inFlight: !!this.inFlight,
+        });
+        if (this.inFlight) {
+            logger.debug("cache:refresh_coalesced", { inFlight: true });
+            return this.inFlight;
+        }
+        const refreshPromise = this.doRefresh();
+        this.inFlight = refreshPromise;
+        return refreshPromise;
+    }
+    async doRefresh() {
+        try {
+            const results = await Promise.all(this.providers.map(async (p) => {
+                const startedAt = Date.now();
+                try {
+                    logger.debug("cache:provider_fetch_start", { id: p.id });
+                    const result = await p.fetchQuota();
+                    logger.debug("cache:provider_fetch_ok", {
+                        id: p.id,
+                        count: result.length,
+                        durationMs: Date.now() - startedAt,
+                    });
+                    return result;
+                }
+                catch (e) {
+                    logger.error("cache:provider_fetch_error", {
+                        id: p.id,
+                        durationMs: Date.now() - startedAt,
+                        error: e,
+                    });
+                    return [];
+                }
+            }));
+            // Validate and normalize provider responses before storing
+            const flattened = results.flat();
+            const validatedData = flattened
+                .map(d => validateQuotaData(d))
+                .filter((v) => v !== null);
+            this.state = {
+                data: validatedData,
+                fetchedAt: new Date(),
+                lastError: null,
+            };
+            logger.debug("cache:refresh_ok", {
+                totalCount: this.state.data.length,
+                fetchedAt: this.state.fetchedAt?.toISOString(),
+            });
+            if (this.options.historyService) {
+                void this.options.historyService.append(this.state.data);
+            }
+        }
+        catch (e) {
+            this.state = {
+                ...this.state,
+                lastError: e,
+            };
+            logger.error("cache:refresh_error", { error: e });
+        }
+        finally {
+            logger.debug("cache:refresh_end", { inFlightCleared: true });
+            this.inFlight = null;
+        }
+    }
+}
+//# sourceMappingURL=quota-cache.js.map

package/dist/src/quota-cache.js.map

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

package/dist/src/registry.d.ts

@@ -0,0 +1,3 @@
+import { type IQuotaRegistry } from "./interfaces";
+export declare function getQuotaRegistry(): IQuotaRegistry;
+//# sourceMappingURL=registry.d.ts.map

package/dist/src/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,cAAc,EAAuB,MAAM,cAAc,CAAC;AAuBxE,wBAAgB,gBAAgB,IAAI,cAAc,CAMjD"}

package/dist/src/registry.js

@@ -0,0 +1,23 @@
+const REGISTRY_KEY = "__OPENCODE_QUOTA_REGISTRY__";
+function createRegistry() {
+    const providers = [];
+    return {
+        register(provider) {
+            if (providers.some((p) => p.id === provider.id)) {
+                return;
+            }
+            providers.push(provider);
+        },
+        getAll() {
+            return [...providers];
+        },
+    };
+}
+export function getQuotaRegistry() {
+    const globalRef = globalThis;
+    if (!globalRef[REGISTRY_KEY]) {
+        globalRef[REGISTRY_KEY] = createRegistry();
+    }
+    return globalRef[REGISTRY_KEY];
+}
+//# sourceMappingURL=registry.js.map

package/dist/src/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/registry.ts"],"names":[],"mappings":"AAEA,MAAM,YAAY,GAAG,6BAA6B,CAAC;AAMnD,SAAS,cAAc;IACrB,MAAM,SAAS,GAAqB,EAAE,CAAC;IACvC,OAAO;QACL,QAAQ,CAAC,QAAwB;YAC/B,IAAI,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;gBAChD,OAAO;YACT,CAAC;YACD,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC3B,CAAC;QACD,MAAM;YACJ,OAAO,CAAC,GAAG,SAAS,CAAC,CAAC;QACxB,CAAC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,MAAM,SAAS,GAAG,UAA4B,CAAC;IAC/C,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,EAAE,CAAC;QAC7B,SAAS,CAAC,YAAY,CAAC,GAAG,cAAc,EAAE,CAAC;IAC7C,CAAC;IACD,OAAO,SAAS,CAAC,YAAY,CAAmB,CAAC;AACnD,CAAC"}

package/dist/src/services/aggregation-service.d.ts

@@ -0,0 +1,34 @@
+import { type QuotaData, type IPredictionEngine, type IAggregationService } from "../interfaces";
+/**
+ * Service for aggregating multiple quota sources into a single representative quota.
+ *
+ * Supports multiple aggregation strategies:
+ * - most_critical: Selects the quota with shortest predicted time-to-limit
+ * - max: Selects the quota with highest usage ratio
+ * - min: Selects the quota with lowest usage ratio
+ * - mean: Creates a synthetic quota with average usage ratio
+ * - median: Creates a synthetic quota with median usage ratio
+ */
+export declare class AggregationService implements IAggregationService {
+    private readonly predictionEngine;
+    constructor(predictionEngine: IPredictionEngine);
+    /**
+     * Aggregates quotas using the most critical (shortest time-to-limit) strategy.
+     * Falls back to max usage ratio if no predictions are available.
+     */
+    aggregateMostCritical(quotas: QuotaData[], windowMinutes?: number, shortWindowMinutes?: number): QuotaData | null;
+    /**
+     * Aggregates quotas by selecting the one with highest usage ratio.
+     */
+    aggregateMax(quotas: QuotaData[]): QuotaData;
+    /**
+     * Aggregates quotas by selecting the one with lowest usage ratio.
+     */
+    aggregateMin(quotas: QuotaData[]): QuotaData;
+    /**
+     * Aggregates quotas by averaging their usage ratios.
+     * Creates a synthetic quota with percentage-based representation.
+     */
+    aggregateAverage(quotas: QuotaData[], name: string, id: string, strategy: "mean" | "median"): QuotaData;
+}
+//# sourceMappingURL=aggregation-service.d.ts.map

package/dist/src/services/aggregation-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aggregation-service.d.ts","sourceRoot":"","sources":["../../../src/services/aggregation-service.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,KAAK,SAAS,EACd,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EAC3B,MAAM,eAAe,CAAC;AAGvB;;;;;;;;;GASG;AACH,qBAAa,kBAAmB,YAAW,mBAAmB;IAC1D,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAoB;gBAEzC,gBAAgB,EAAE,iBAAiB;IAI/C;;;OAGG;IACH,qBAAqB,CACjB,MAAM,EAAE,SAAS,EAAE,EACnB,aAAa,GAAE,MAAW,EAC1B,kBAAkB,CAAC,EAAE,MAAM,GAC5B,SAAS,GAAG,IAAI;IAgCnB;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,SAAS;IAQ5C;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,SAAS;IAQ5C;;;OAGG;IACH,gBAAgB,CACZ,MAAM,EAAE,SAAS,EAAE,EACnB,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,EACV,QAAQ,EAAE,MAAM,GAAG,QAAQ,GAC5B,SAAS;CAoBf"}

package/dist/src/services/aggregation-service.js

@@ -0,0 +1,89 @@
+import { formatDurationMs } from "../utils/time";
+/**
+ * Service for aggregating multiple quota sources into a single representative quota.
+ *
+ * Supports multiple aggregation strategies:
+ * - most_critical: Selects the quota with shortest predicted time-to-limit
+ * - max: Selects the quota with highest usage ratio
+ * - min: Selects the quota with lowest usage ratio
+ * - mean: Creates a synthetic quota with average usage ratio
+ * - median: Creates a synthetic quota with median usage ratio
+ */
+export class AggregationService {
+    predictionEngine;
+    constructor(predictionEngine) {
+        this.predictionEngine = predictionEngine;
+    }
+    /**
+     * Aggregates quotas using the most critical (shortest time-to-limit) strategy.
+     * Falls back to max usage ratio if no predictions are available.
+     */
+    aggregateMostCritical(quotas, windowMinutes = 60, shortWindowMinutes) {
+        if (quotas.length === 0)
+            return null;
+        let minTime = Infinity;
+        let representative = null;
+        for (const q of quotas) {
+            const time = this.predictionEngine.predictTimeToLimit(q.id, windowMinutes, shortWindowMinutes);
+            if (time < minTime) {
+                minTime = time;
+                representative = q;
+            }
+        }
+        // Fallback to max usage if no prediction is possible
+        if (!representative) {
+            return this.aggregateMax(quotas);
+        }
+        if (minTime !== Infinity) {
+            return {
+                ...representative,
+                predictedReset: `in ${formatDurationMs(minTime)} (predicted)`
+            };
+        }
+        return representative;
+    }
+    /**
+     * Aggregates quotas by selecting the one with highest usage ratio.
+     */
+    aggregateMax(quotas) {
+        return quotas.reduce((a, b) => {
+            const aRatio = a.limit ? a.used / a.limit : 0;
+            const bRatio = b.limit ? b.used / b.limit : 0;
+            return aRatio > bRatio ? a : b;
+        });
+    }
+    /**
+     * Aggregates quotas by selecting the one with lowest usage ratio.
+     */
+    aggregateMin(quotas) {
+        return quotas.reduce((a, b) => {
+            const aRatio = a.limit ? a.used / a.limit : 0;
+            const bRatio = b.limit ? b.used / b.limit : 0;
+            return aRatio < bRatio ? a : b;
+        });
+    }
+    /**
+     * Aggregates quotas by averaging their usage ratios.
+     * Creates a synthetic quota with percentage-based representation.
+     */
+    aggregateAverage(quotas, name, id, strategy) {
+        const ratios = quotas.map(q => q.limit ? q.used / q.limit : 0);
+        let avgRatio = 0;
+        if (strategy === "mean") {
+            avgRatio = ratios.reduce((a, b) => a + b, 0) / ratios.length;
+        }
+        else {
+            ratios.sort((a, b) => a - b);
+            avgRatio = ratios[Math.floor(ratios.length / 2)];
+        }
+        return {
+            id: id,
+            providerName: name,
+            used: Math.round(avgRatio * 100),
+            limit: 100,
+            unit: "%",
+            info: "Aggregated"
+        };
+    }
+}
+//# sourceMappingURL=aggregation-service.js.map

package/dist/src/services/aggregation-service.js.map

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

package/dist/src/services/config-loader.d.ts

@@ -0,0 +1,25 @@
+import { type QuotaConfig } from "../interfaces";
+/**
+ * Configuration loading and merging service.
+ * Handles reading config from disk and merging with defaults.
+ */
+export declare class ConfigLoader {
+    /**
+     * Creates a new configuration by merging defaults with initial config.
+     */
+    static createConfig(initialConfig?: Partial<QuotaConfig>): QuotaConfig;
+    /**
+     * Loads and merges user configuration from disk into the provided config.
+     * Returns the updated config.
+     */
+    static loadFromDisk(directory: string, config: QuotaConfig): Promise<QuotaConfig>;
+    /**
+     * Merges user configuration into the target config.
+     */
+    private static mergeUserConfig;
+    /**
+     * Validates and normalizes configuration values.
+     */
+    private static validateConfig;
+}
+//# sourceMappingURL=config-loader.d.ts.map

package/dist/src/services/config-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-loader.d.ts","sourceRoot":"","sources":["../../../src/services/config-loader.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,eAAe,CAAC;AAKjD;;;GAGG;AACH,qBAAa,YAAY;IACrB;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,WAAW;IAiBtE;;;OAGG;WACU,YAAY,CACrB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,WAAW,GACpB,OAAO,CAAC,WAAW,CAAC;IA8BvB;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,eAAe;IAkC9B;;OAEG;mBACkB,cAAc;CAatC"}

package/dist/src/services/config-loader.js

@@ -0,0 +1,105 @@
+import { readFile } from "node:fs/promises";
+import { join } from "node:path";
+import { DEFAULT_CONFIG } from "../defaults";
+import { logger } from "../logger";
+import { validatePollingInterval } from "../utils/validation";
+/**
+ * Configuration loading and merging service.
+ * Handles reading config from disk and merging with defaults.
+ */
+export class ConfigLoader {
+    /**
+     * Creates a new configuration by merging defaults with initial config.
+     */
+    static createConfig(initialConfig) {
+        const config = { ...DEFAULT_CONFIG, ...initialConfig };
+        // Deep clone specific nested objects to avoid mutation of the constant
+        if (DEFAULT_CONFIG.progressBar) {
+            config.progressBar = { ...DEFAULT_CONFIG.progressBar, ...initialConfig?.progressBar };
+        }
+        if (DEFAULT_CONFIG.aggregatedGroups) {
+            config.aggregatedGroups = [
+                ...DEFAULT_CONFIG.aggregatedGroups,
+                ...(initialConfig?.aggregatedGroups || [])
+            ];
+        }
+        return config;
+    }
+    /**
+     * Loads and merges user configuration from disk into the provided config.
+     * Returns the updated config.
+     */
+    static async loadFromDisk(directory, config) {
+        const result = { ...config };
+        try {
+            const envConfigPath = process.env.OPENCODE_QUOTAS_CONFIG_PATH;
+            const configPath = envConfigPath || join(directory, ".opencode", "quotas.json");
+            const rawConfig = await readFile(configPath, "utf-8");
+            const userConfig = JSON.parse(rawConfig);
+            ConfigLoader.mergeUserConfig(result, userConfig);
+            logger.debug("init:config_loaded", { configPath, debug: result.debug });
+        }
+        catch (e) {
+            // Ignore missing config or parse errors
+            logger.error("init:config_load_failed", { error: e });
+        }
+        // Validate and normalize config values
+        await ConfigLoader.validateConfig(result);
+        return result;
+    }
+    /**
+     * Merges user configuration into the target config.
+     */
+    static mergeUserConfig(target, userConfig) {
+        if (userConfig.debug !== undefined) {
+            target.debug = userConfig.debug;
+            logger.setDebug(!!target.debug);
+        }
+        if (userConfig.footer !== undefined) {
+            target.footer = userConfig.footer;
+        }
+        if (userConfig.progressBar) {
+            target.progressBar = { ...target.progressBar, ...userConfig.progressBar };
+        }
+        if (userConfig.table) {
+            target.table = { ...target.table, ...userConfig.table };
+        }
+        if (userConfig.disabled) {
+            target.disabled = userConfig.disabled;
+        }
+        if (userConfig.filterByCurrentModel !== undefined) {
+            target.filterByCurrentModel = userConfig.filterByCurrentModel;
+        }
+        if (userConfig.aggregatedGroups) {
+            target.aggregatedGroups = userConfig.aggregatedGroups;
+        }
+        if (userConfig.historyMaxAgeHours !== undefined) {
+            target.historyMaxAgeHours = userConfig.historyMaxAgeHours;
+        }
+        if (userConfig.predictionShortWindowMinutes !== undefined) {
+            target.predictionShortWindowMinutes = userConfig.predictionShortWindowMinutes;
+        }
+        if (userConfig.pollingInterval !== undefined) {
+            target.pollingInterval = userConfig.pollingInterval;
+        }
+    }
+    /**
+     * Validates and normalizes configuration values.
+     */
+    static async validateConfig(config) {
+        // Handle pollingInterval from user config
+        const validated = validatePollingInterval(config.pollingInterval);
+        if (validated === null) {
+            console.warn('[QuotaService] pollingInterval is invalid, using default');
+            config.pollingInterval = DEFAULT_CONFIG.pollingInterval;
+        }
+        else if (validated < 10_000) {
+            console.warn('[QuotaService] pollingInterval below 10s is not recommended');
+            config.pollingInterval = Math.max(validated, 1_000);
+        }
+        else {
+            config.pollingInterval = validated;
+        }
+    }
+}
+//# sourceMappingURL=config-loader.js.map

package/dist/src/services/config-loader.js.map

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

package/dist/src/services/history-service.d.ts

@@ -0,0 +1,15 @@
+import { type IHistoryService, type HistoryPoint, type QuotaData } from "../interfaces";
+export declare class HistoryService implements IHistoryService {
+    private historyPath;
+    private data;
+    private maxWindowMs;
+    private saveTimeout;
+    constructor(customPath?: string);
+    init(): Promise<void>;
+    append(snapshot: QuotaData[]): Promise<void>;
+    getHistory(quotaId: string, windowMs: number): HistoryPoint[];
+    setMaxAge(hours: number): void;
+    pruneAll(): Promise<void>;
+    private save;
+}
+//# sourceMappingURL=history-service.d.ts.map

package/dist/src/services/history-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"history-service.d.ts","sourceRoot":"","sources":["../../../src/services/history-service.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,eAAe,EAAE,KAAK,YAAY,EAAE,KAAK,SAAS,EAAE,MAAM,eAAe,CAAC;AAGxF,qBAAa,cAAe,YAAW,eAAe;IAClD,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,IAAI,CAAsC;IAClD,OAAO,CAAC,WAAW,CAA+B;IAClD,OAAO,CAAC,WAAW,CAA8C;gBAErD,UAAU,CAAC,EAAE,MAAM;IAIzB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAiBrB,MAAM,CAAC,QAAQ,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IA8BlD,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,YAAY,EAAE;IAO7D,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAIxB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAyB/B,OAAO,CAAC,IAAI;CAef"}