offrouter-core 0.2.0 → 0.2.2

package/dist/usage-file.js

@@ -0,0 +1,316 @@
+/**
+ * File-backed usage store for OffRouter.
+ *
+ * Wraps an in-memory provider-health/quota engine and adds JSON persistence for
+ * per-account quota usage so near-limit detection survives across CLI
+ * invocations and MCP server restarts.
+ *
+ * On-disk layout (`$OFFROUTER_HOME/state/usage.json`):
+ *   { version: 1, accounts: Record<`${providerId}:${accountId}`, PersistedAccount> }
+ *
+ * Safety guarantees mirror FileSecretStore:
+ *   - atomic write via temp file + rename
+ *   - chmod 0600 on POSIX after every write
+ *   - missing or corrupt file => graceful fallback to empty state (never throws)
+ *
+ * Provider health/quota math (sliding-window error budget, cooldown) stays
+ * in-memory and process-local; only account quota usage is persisted, which is
+ * what near-limit detection and quota reporting depend on across sessions.
+ */
+import { readFileSync } from "node:fs";
+import { chmod, mkdir, readFile, rename, unlink, writeFile, } from "node:fs/promises";
+import { dirname } from "node:path";
+import { randomBytes } from "node:crypto";
+import { computeAccountSnapshot, InMemoryUsageStore, } from "./usage.js";
+export { DEFAULT_NEAR_LIMIT_THRESHOLD } from "./usage.js";
+export { InMemoryUsageStore } from "./usage.js";
+const EMPTY_DOC = { version: 1, accounts: {} };
+function accountKey(providerId, accountId) {
+    return `${providerId}:${accountId}`;
+}
+/**
+ * Parse a persisted usage document leniently. A missing or corrupt file is
+ * treated as empty state rather than a hard failure so a bad write can never
+ * wedge the CLI.
+ */
+function parseUsageDocument(raw) {
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        // Corrupt JSON: fall back to empty instead of throwing.
+        return { ...EMPTY_DOC, accounts: {} };
+    }
+    if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
+        return { ...EMPTY_DOC, accounts: {} };
+    }
+    const record = parsed;
+    const accountsRaw = record.accounts;
+    if (typeof accountsRaw !== "object" ||
+        accountsRaw === null ||
+        Array.isArray(accountsRaw)) {
+        return { ...EMPTY_DOC, accounts: {} };
+    }
+    const accounts = {};
+    for (const [key, value] of Object.entries(accountsRaw)) {
+        if (typeof value !== "object" || value === null || Array.isArray(value)) {
+            continue;
+        }
+        const entry = value;
+        if (typeof entry.providerId !== "string" ||
+            typeof entry.accountId !== "string" ||
+            typeof entry.used !== "number") {
+            continue;
+        }
+        const doc = {
+            providerId: entry.providerId,
+            accountId: entry.accountId,
+            used: entry.used,
+            lastUpdated: typeof entry.lastUpdated === "string" ? entry.lastUpdated : "",
+        };
+        if (typeof entry.limit === "number") {
+            doc.limit = entry.limit;
+        }
+        accounts[key] = doc;
+    }
+    return { version: 1, accounts };
+}
+/**
+ * File-backed UsageStore. Persists per-account quota usage atomically and
+ * delegates provider health/quota logic to an in-memory engine.
+ */
+export class FileUsageStore {
+    filePath;
+    #fs;
+    #now;
+    #delegate;
+    /** In-memory mirror of persisted account docs, hydrated lazily. */
+    #accounts = null;
+    /** Serializes mutations so concurrent writes never interleave. */
+    #chain = Promise.resolve();
+    constructor(options) {
+        if (!options?.filePath || typeof options.filePath !== "string") {
+            throw new TypeError("FileUsageStore requires options.filePath");
+        }
+        this.filePath = options.filePath;
+        this.#now = options.now ?? (() => new Date());
+        this.#delegate =
+            options.delegate ?? new InMemoryUsageStore({ now: this.#now });
+        this.#fs = {
+            mkdir,
+            readFile,
+            rename,
+            unlink,
+            writeFile,
+            chmod,
+            ...options.fileSystem,
+        };
+    }
+    #exclusive(fn) {
+        const run = this.#chain.then(fn, fn);
+        this.#chain = run.then(() => undefined, () => undefined);
+        return run;
+    }
+    /** Load the file once into the in-memory account map. Never throws. */
+    async #load() {
+        if (this.#accounts) {
+            return this.#accounts;
+        }
+        let doc;
+        try {
+            const raw = await this.#fs.readFile(this.filePath, "utf8");
+            doc = parseUsageDocument(raw);
+        }
+        catch (err) {
+            if (err &&
+                typeof err === "object" &&
+                "code" in err &&
+                err.code === "ENOENT") {
+                doc = { ...EMPTY_DOC, accounts: {} };
+            }
+            else {
+                // Any read failure (including corruption surfaced as a throw) is
+                // treated as empty state so the CLI keeps working.
+                doc = { ...EMPTY_DOC, accounts: {} };
+            }
+        }
+        const map = new Map();
+        for (const [key, entry] of Object.entries(doc.accounts)) {
+            map.set(key, {
+                providerId: entry.providerId,
+                accountId: entry.accountId,
+                used: entry.used,
+                limit: entry.limit,
+                updatedAt: entry.lastUpdated,
+            });
+        }
+        this.#accounts = map;
+        return map;
+    }
+    /** Synchronous load for toJSON diagnostics; never throws. */
+    #loadKnownSync() {
+        if (this.#accounts) {
+            return this.#accounts;
+        }
+        let map = new Map();
+        try {
+            const raw = readFileSync(this.filePath, "utf8");
+            const doc = parseUsageDocument(raw);
+            map = new Map();
+            for (const [key, entry] of Object.entries(doc.accounts)) {
+                map.set(key, {
+                    providerId: entry.providerId,
+                    accountId: entry.accountId,
+                    used: entry.used,
+                    limit: entry.limit,
+                    updatedAt: entry.lastUpdated,
+                });
+            }
+        }
+        catch {
+            map = new Map();
+        }
+        return map;
+    }
+    async #persist(accounts) {
+        const persistedAccounts = {};
+        for (const [key, doc] of accounts) {
+            const snap = computeAccountSnapshot(doc);
+            const entry = {
+                providerId: doc.providerId,
+                accountId: doc.accountId,
+                used: doc.used,
+                lastUpdated: doc.updatedAt,
+                health: snap.health,
+                recentErrors: [],
+            };
+            if (doc.limit !== undefined) {
+                entry.limit = doc.limit;
+            }
+            persistedAccounts[key] = entry;
+        }
+        const payload = `${JSON.stringify({ version: 1, accounts: persistedAccounts }, null, 2)}\n`;
+        await this.#fs.mkdir(dirname(this.filePath), { recursive: true });
+        const tmp = `${this.filePath}.${randomBytes(8).toString("hex")}.tmp`;
+        try {
+            await this.#fs.writeFile(tmp, payload, {
+                encoding: "utf8",
+                mode: 0o600,
+            });
+            await this.#fs.chmod(tmp, 0o600);
+            await this.#fs.rename(tmp, this.filePath);
+            await this.#fs.chmod(this.filePath, 0o600);
+        }
+        catch (err) {
+            await this.#fs.unlink(tmp).catch((unlinkErr) => {
+                if (unlinkErr &&
+                    typeof unlinkErr === "object" &&
+                    "code" in unlinkErr &&
+                    unlinkErr.code === "ENOENT") {
+                    return;
+                }
+                throw unlinkErr;
+            });
+            throw err;
+        }
+    }
+    // ---- Provider health/quota: delegated to the in-memory engine ----
+    record(event) {
+        return this.#delegate.record(event);
+    }
+    getProvider(providerId) {
+        return this.#delegate.getProvider(providerId);
+    }
+    listProviders() {
+        return this.#delegate.listProviders();
+    }
+    setSubscriptionQuota(providerId, input) {
+        return this.#delegate.setSubscriptionQuota(providerId, input);
+    }
+    explainPaidFallback(providerId, options) {
+        return this.#delegate.explainPaidFallback(providerId, options);
+    }
+    // ---- Per-account quota usage: persisted ----
+    async recordUsage(providerId, accountId, input) {
+        return this.#exclusive(async () => {
+            const accounts = await this.#load();
+            const at = input.at ?? this.#now();
+            const key = accountKey(providerId, accountId);
+            let doc = accounts.get(key);
+            if (!doc) {
+                doc = {
+                    providerId,
+                    accountId,
+                    used: 0,
+                    updatedAt: at.toISOString(),
+                };
+                accounts.set(key, doc);
+            }
+            if (input.used !== undefined)
+                doc.used = input.used;
+            if (input.limit !== undefined)
+                doc.limit = input.limit;
+            doc.updatedAt = at.toISOString();
+            await this.#persist(accounts);
+            return computeAccountSnapshot(doc);
+        });
+    }
+    async isNearLimit(providerId, accountId, threshold) {
+        return this.#exclusive(async () => {
+            const accounts = await this.#load();
+            const doc = accounts.get(accountKey(providerId, accountId));
+            if (!doc)
+                return false;
+            return computeAccountSnapshot(doc, threshold).nearLimit;
+        });
+    }
+    async getNearLimitAccounts(threshold) {
+        return this.#exclusive(async () => {
+            const accounts = await this.#load();
+            const out = [];
+            for (const doc of accounts.values()) {
+                const snap = computeAccountSnapshot(doc, threshold);
+                if (snap.nearLimit)
+                    out.push(snap);
+            }
+            return out.sort((a, b) => {
+                if (a.providerId !== b.providerId)
+                    return a.providerId.localeCompare(b.providerId);
+                return a.accountId.localeCompare(b.accountId);
+            });
+        });
+    }
+    async getAccountUsage(providerId, accountId) {
+        return this.#exclusive(async () => {
+            const accounts = await this.#load();
+            const doc = accounts.get(accountKey(providerId, accountId));
+            if (!doc)
+                return undefined;
+            return computeAccountSnapshot(doc);
+        });
+    }
+    async listAccountUsage() {
+        return this.#exclusive(async () => {
+            const accounts = await this.#load();
+            const out = [];
+            for (const doc of accounts.values()) {
+                out.push(computeAccountSnapshot(doc));
+            }
+            return out.sort((a, b) => {
+                if (a.providerId !== b.providerId)
+                    return a.providerId.localeCompare(b.providerId);
+                return a.accountId.localeCompare(b.accountId);
+            });
+        });
+    }
+    toJSON() {
+        const accounts = this.#loadKnownSync();
+        return {
+            kind: "file-usage",
+            filePath: this.filePath,
+            accountCount: accounts.size,
+        };
+    }
+}
+//# sourceMappingURL=usage-file.js.map

package/dist/usage-file.js.map

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

package/dist/usage.d.ts

@@ -0,0 +1,235 @@
+/**
+ * Usage, quota, and provider-health store for OffRouter V1.
+ *
+ * Distinguishes subscription quota from API-key spend so doctor/status/route
+ * explain can say why paid fallback was or was not used.
+ *
+ * Provider health uses a small sliding-window error budget plus cooldown:
+ * - healthy: enough budget remaining, no active cooldown
+ * - degraded: elevated errors but still usable
+ * - dead: cooldown active after budget exhaustion / hard failures
+ *
+ * In-memory only for this task; SQLite is deferred until the interface stabilizes.
+ */
+import { type AuditStore, type InMemoryAuditStoreOptions } from "./audit.js";
+import type { AuthTier, ProviderHealth, SubscriptionStatus } from "./types.js";
+/** Canonical event classes that drive health / quota / spend counters. */
+export type UsageEventKind = "request_success" | "request_error" | "rate_limited" | "quota_exhausted" | "timeout" | "cancelled" | "auth_failure" | "subscription_quota_set" | "subscription_usage" | "api_key_spend";
+export interface SlidingWindowOptions {
+    /** Error-window length in ms. Default 60_000. */
+    windowMs?: number;
+    /** Errors inside the window that keep the provider healthy. Default 2. */
+    healthyMaxErrors?: number;
+    /** Errors inside the window before dead (above = dead). Default 5. */
+    deadMinErrors?: number;
+    /** Cooldown after death / hard failure before resurrectable. Default 30_000. */
+    cooldownMs?: number;
+}
+export interface ProviderUsageSnapshot {
+    providerId: string;
+    modelId?: string;
+    health: ProviderHealth;
+    /** Why health is at this level (short, audit-safe). */
+    healthReason?: string;
+    /** Errors counted in the sliding window. */
+    recentErrorCount: number;
+    /** Epoch ms when cooldown ends, if any. */
+    cooldownUntil?: number;
+    /** Configured / observed subscription unit quota (opaque units). */
+    subscriptionQuotaLimit?: number;
+    /** Subscription units consumed (opaque units). */
+    subscriptionQuotaUsed: number;
+    /** Remaining subscription units when limit known. */
+    subscriptionQuotaRemaining?: number;
+    subscriptionStatus?: SubscriptionStatus;
+    /** Cumulative paid API-key spend in USD (estimated). */
+    apiKeySpendUsd: number;
+    /** Total successful request count. */
+    successCount: number;
+    /** Total error count (all time in this process). */
+    errorCount: number;
+    lastErrorAt?: string;
+    lastErrorKind?: UsageEventKind;
+    lastSuccessAt?: string;
+    updatedAt: string;
+}
+export interface UsageEvent {
+    providerId: string;
+    modelId?: string;
+    authTier: AuthTier;
+    kind: UsageEventKind;
+    /**
+     * For subscription_usage / subscription_quota_set: opaque quota units.
+     * For api_key_spend: USD amount.
+     */
+    amount?: number;
+    /** Optional hard set of subscription limit when kind is subscription_quota_set. */
+    quotaLimit?: number;
+    subscriptionStatus?: SubscriptionStatus;
+    /** Override clock for tests. */
+    at?: Date;
+    /** Human-safe detail (already redacted by caller). */
+    detail?: string;
+}
+export interface RecordUsageResult {
+    snapshot: ProviderUsageSnapshot;
+    /**
+     * True when this event moved health from a usable state into dead/degraded,
+     * or when subscription became exhausted.
+     */
+    healthChanged: boolean;
+    previousHealth: ProviderHealth;
+}
+export declare const DEFAULT_NEAR_LIMIT_THRESHOLD = 0.2;
+/**
+ * Snapshot of usage for a specific account within a provider.
+ */
+export interface AccountUsageSnapshot {
+    providerId: string;
+    accountId: string;
+    used: number;
+    limit?: number;
+    remaining?: number;
+    percentRemaining?: number;
+    nearLimit: boolean;
+    subscriptionStatus: SubscriptionStatus;
+    /**
+     * Derived account health from quota usage: "dead" when exhausted,
+     * "degraded" when near-limit, otherwise "healthy". Useful for
+     * persisted stores that need a stable, restorable health signal.
+     */
+    health?: ProviderHealth;
+    updatedAt: string;
+}
+/**
+ * Minimal persisted document for a single account's quota usage.
+ * Shared between the in-memory and file-backed usage stores so snapshot
+ * math stays in one place.
+ */
+export interface AccountUsageDoc {
+    providerId: string;
+    accountId: string;
+    used: number;
+    limit?: number;
+    updatedAt: string;
+}
+/**
+ * Why paid API-key capacity was or was not selected given current usage state.
+ * Consumed by doctor / status / route explain surfaces.
+ */
+export interface PaidFallbackExplanation {
+    providerId: string;
+    recommendation: "prefer_subscription" | "allow_api_key_fallback" | "api_key_only" | "no_capacity";
+    reason: string;
+    subscriptionStatus?: SubscriptionStatus;
+    subscriptionQuotaRemaining?: number;
+    subscriptionHealth?: ProviderHealth;
+    apiKeySpendUsd: number;
+    usedPaidFallback: boolean;
+}
+export interface UsageStore {
+    /** Atomically apply a usage event and recompute health. */
+    record(event: UsageEvent): Promise<RecordUsageResult>;
+    getProvider(providerId: string): Promise<ProviderUsageSnapshot | undefined>;
+    listProviders(): Promise<ProviderUsageSnapshot[]>;
+    /**
+     * Set subscription quota limit/used for a provider without incrementing spend.
+     * Useful when adapters discover limit snapshots out of band.
+     */
+    setSubscriptionQuota(providerId: string, input: {
+        limit?: number;
+        used?: number;
+        status?: SubscriptionStatus;
+        modelId?: string;
+        at?: Date;
+    }): Promise<ProviderUsageSnapshot>;
+    /**
+     * Explain whether subscription capacity remains or paid fallback is justified.
+     */
+    explainPaidFallback(providerId: string, options?: {
+        hasApiKeyCandidate?: boolean;
+    }): Promise<PaidFallbackExplanation>;
+    /**
+     * Record usage for a specific account within a provider.
+     */
+    recordUsage(providerId: string, accountId: string, input: {
+        used?: number;
+        limit?: number;
+        at?: Date;
+    }): Promise<AccountUsageSnapshot>;
+    /**
+     * Check whether a specific account is near its quota limit.
+     */
+    isNearLimit(providerId: string, accountId: string, threshold?: number): Promise<boolean>;
+    /**
+     * Get all accounts whose usage is near their quota limit.
+     */
+    getNearLimitAccounts(threshold?: number): Promise<AccountUsageSnapshot[]>;
+    /**
+     * Get the usage snapshot for a specific account.
+     */
+    getAccountUsage(providerId: string, accountId: string): Promise<AccountUsageSnapshot | undefined>;
+    /**
+     * List all account usage snapshots.
+     */
+    listAccountUsage(): Promise<AccountUsageSnapshot[]>;
+    /**
+     * JSON-safe diagnostic view. No secrets.
+     */
+    toJSON(): Record<string, unknown>;
+}
+export interface InMemoryUsageStoreOptions extends SlidingWindowOptions {
+    now?: () => Date;
+}
+/**
+ * In-memory usage/health store.
+ * Mutations are serialized so concurrent updates never lose counters.
+ */
+export declare class InMemoryUsageStore implements UsageStore {
+    #private;
+    constructor(options?: InMemoryUsageStoreOptions);
+    record(event: UsageEvent): Promise<RecordUsageResult>;
+    getProvider(providerId: string): Promise<ProviderUsageSnapshot | undefined>;
+    listProviders(): Promise<ProviderUsageSnapshot[]>;
+    setSubscriptionQuota(providerId: string, input: {
+        limit?: number;
+        used?: number;
+        status?: SubscriptionStatus;
+        modelId?: string;
+        at?: Date;
+    }): Promise<ProviderUsageSnapshot>;
+    explainPaidFallback(providerId: string, options?: {
+        hasApiKeyCandidate?: boolean;
+    }): Promise<PaidFallbackExplanation>;
+    recordUsage(providerId: string, accountId: string, input: {
+        used?: number;
+        limit?: number;
+        at?: Date;
+    }): Promise<AccountUsageSnapshot>;
+    isNearLimit(providerId: string, accountId: string, threshold?: number): Promise<boolean>;
+    getNearLimitAccounts(threshold?: number): Promise<AccountUsageSnapshot[]>;
+    getAccountUsage(providerId: string, accountId: string): Promise<AccountUsageSnapshot | undefined>;
+    listAccountUsage(): Promise<AccountUsageSnapshot[]>;
+    toJSON(): Record<string, unknown>;
+}
+export declare function computeAccountSnapshot(doc: AccountUsageDoc, threshold?: number): AccountUsageSnapshot;
+/**
+ * Composite facade for callers that want one injectable "state" handle.
+ * Writes stay on the specialized stores; this is a thin convenience.
+ */
+export interface StateStore {
+    audit: AuditStore;
+    usage: UsageStore;
+}
+export declare class InMemoryStateStore implements StateStore {
+    readonly audit: AuditStore;
+    readonly usage: UsageStore;
+    constructor(options?: {
+        audit?: AuditStore;
+        usage?: UsageStore;
+        auditOptions?: InMemoryAuditStoreOptions;
+        usageOptions?: InMemoryUsageStoreOptions;
+    });
+    toJSON(): Record<string, unknown>;
+}
+//# sourceMappingURL=usage.d.ts.map

package/dist/usage.d.ts.map

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