@relayplane/proxy 1.9.18 → 1.9.21

package/dist/agent-policy.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Agent-Aware Routing Policy
+ *
+ * Manages loading, caching, and resolving routing policies from ~/.relayplane/policy.yaml.
+ * Policies allow per-agent and per-task model overrides.
+ */
+export interface TaskPolicy {
+    preferred: string;
+    neverDowngrade?: boolean;
+    escalateTo?: string;
+    escalateOn?: Array<'complexity_high' | 'rate_limit' | 'error'>;
+}
+export interface AgentPolicy {
+    fingerprint?: string;
+    preferred: string;
+    escalateTo?: string;
+    escalateOn?: Array<'complexity_high' | 'rate_limit' | 'error'>;
+    fallback?: string;
+    neverDowngrade?: boolean;
+    budgetPerDay?: number;
+    tasks?: Record<string, TaskPolicy>;
+}
+export interface RoutingPolicy {
+    version: number;
+    agents?: Record<string, AgentPolicy>;
+    tasks?: Record<string, TaskPolicy>;
+}
+export type ResolvedBy = 'agent_task_override' | 'task_rule' | 'agent_rule' | 'complexity_routing' | 'default_routing' | 'passthrough';
+export interface PolicyResolution {
+    model: string;
+    resolvedBy: ResolvedBy;
+    neverDowngrade: boolean;
+    reason: string;
+    candidateModel?: string;
+}
+export declare const POLICY_FILE: string;
+/** Reset cache — for testing only */
+export declare function _resetPolicyCache(): void;
+/**
+ * Load routing policy from ~/.relayplane/policy.yaml with 5-second TTL cache.
+ * Returns empty policy { version: 1 } if file is missing or invalid.
+ */
+export declare function loadPolicy(): RoutingPolicy;
+/**
+ * Resolve which model to use for a request, given the loaded policy.
+ *
+ * Resolution priority:
+ * 1. agent.tasks[taskType] override (agent_task_override)
+ * 2. policy.tasks[taskType] rule (task_rule)
+ * 3. agent-level rule (agent_rule)
+ * 4. pass-through: use candidateModel (complexity_routing)
+ */
+export declare function resolvePolicy(policy: RoutingPolicy, agentFingerprint: string | undefined, agentName: string | undefined, taskType: string, complexity: 'simple' | 'moderate' | 'complex', candidateModel: string): PolicyResolution;
+//# sourceMappingURL=agent-policy.d.ts.map

package/dist/agent-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-policy.d.ts","sourceRoot":"","sources":["../src/agent-policy.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AASH,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,KAAK,CAAC,iBAAiB,GAAG,YAAY,GAAG,OAAO,CAAC,CAAC;CAChE;AAED,MAAM,WAAW,WAAW;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,KAAK,CAAC,iBAAiB,GAAG,YAAY,GAAG,OAAO,CAAC,CAAC;IAC/D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;CACpC;AAED,MAAM,MAAM,UAAU,GAClB,qBAAqB,GACrB,WAAW,GACX,YAAY,GACZ,oBAAoB,GACpB,iBAAiB,GACjB,aAAa,CAAC;AAElB,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,UAAU,CAAC;IACvB,cAAc,EAAE,OAAO,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAKD,eAAO,MAAM,WAAW,QAAuC,CAAC;AAUhE,qCAAqC;AACrC,wBAAgB,iBAAiB,IAAI,IAAI,CAExC;AAED;;;GAGG;AACH,wBAAgB,UAAU,IAAI,aAAa,CA6B1C;AAID;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,aAAa,EACrB,gBAAgB,EAAE,MAAM,GAAG,SAAS,EACpC,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,QAAQ,GAAG,UAAU,GAAG,SAAS,EAC7C,cAAc,EAAE,MAAM,GACrB,gBAAgB,CAoElB"}

package/dist/agent-policy.js

@@ -0,0 +1,183 @@
+"use strict";
+/**
+ * Agent-Aware Routing Policy
+ *
+ * Manages loading, caching, and resolving routing policies from ~/.relayplane/policy.yaml.
+ * Policies allow per-agent and per-task model overrides.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.POLICY_FILE = void 0;
+exports._resetPolicyCache = _resetPolicyCache;
+exports.loadPolicy = loadPolicy;
+exports.resolvePolicy = resolvePolicy;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const os = __importStar(require("node:os"));
+const js_yaml_1 = require("js-yaml");
+// ─── File Loading ─────────────────────────────────────────────────────────────
+const POLICY_DIR = path.join(os.homedir(), '.relayplane');
+exports.POLICY_FILE = path.join(POLICY_DIR, 'policy.yaml');
+const CACHE_TTL_MS = 5000;
+let _cache = null;
+/** Reset cache — for testing only */
+function _resetPolicyCache() {
+    _cache = null;
+}
+/**
+ * Load routing policy from ~/.relayplane/policy.yaml with 5-second TTL cache.
+ * Returns empty policy { version: 1 } if file is missing or invalid.
+ */
+function loadPolicy() {
+    const now = Date.now();
+    if (_cache && now - _cache.loadedAt < CACHE_TTL_MS) {
+        return _cache.policy;
+    }
+    if (!fs.existsSync(exports.POLICY_FILE)) {
+        _cache = { policy: { version: 1 }, loadedAt: now };
+        return _cache.policy;
+    }
+    try {
+        const raw = fs.readFileSync(exports.POLICY_FILE, 'utf-8');
+        const parsed = (0, js_yaml_1.load)(raw);
+        if (!parsed || typeof parsed !== 'object' || parsed.version !== 1) {
+            if (parsed && typeof parsed === 'object' && parsed.version !== 1) {
+                console.warn(`[RelayPlane] policy.yaml: unsupported version ${parsed.version}, expected 1`);
+            }
+            _cache = { policy: { version: 1 }, loadedAt: now };
+            return _cache.policy;
+        }
+        _cache = { policy: parsed, loadedAt: now };
+        return parsed;
+    }
+    catch (e) {
+        const msg = e instanceof Error ? e.message : String(e);
+        console.warn(`[RelayPlane] policy.yaml parse error: ${msg}`);
+        _cache = { policy: { version: 1 }, loadedAt: now };
+        return { version: 1 };
+    }
+}
+// ─── Resolution ───────────────────────────────────────────────────────────────
+/**
+ * Resolve which model to use for a request, given the loaded policy.
+ *
+ * Resolution priority:
+ * 1. agent.tasks[taskType] override (agent_task_override)
+ * 2. policy.tasks[taskType] rule (task_rule)
+ * 3. agent-level rule (agent_rule)
+ * 4. pass-through: use candidateModel (complexity_routing)
+ */
+function resolvePolicy(policy, agentFingerprint, agentName, taskType, complexity, candidateModel) {
+    const emptyPolicy = !policy.agents && !policy.tasks;
+    // Find matching agent entry
+    let matchedAgentName = null;
+    let matchedAgent = null;
+    if (policy.agents) {
+        for (const [name, agent] of Object.entries(policy.agents)) {
+            if (agent.fingerprint && agentFingerprint && agent.fingerprint === agentFingerprint) {
+                matchedAgentName = name;
+                matchedAgent = agent;
+                break;
+            }
+        }
+        // Match by name if fingerprint didn't match
+        if (!matchedAgent && agentName && policy.agents[agentName]) {
+            matchedAgentName = agentName;
+            matchedAgent = policy.agents[agentName];
+        }
+    }
+    // 1. Agent task override
+    if (matchedAgent && matchedAgent.tasks && matchedAgent.tasks[taskType]) {
+        const rule = matchedAgent.tasks[taskType];
+        const model = resolveEscalation(rule, complexity) ?? rule.preferred;
+        return {
+            model,
+            resolvedBy: 'agent_task_override',
+            neverDowngrade: rule.neverDowngrade === true,
+            reason: `Agent "${matchedAgentName}" task override for "${taskType}": ${model}`,
+            candidateModel,
+        };
+    }
+    // 2. Global task rule
+    if (policy.tasks && policy.tasks[taskType]) {
+        const rule = policy.tasks[taskType];
+        const model = resolveEscalation(rule, complexity) ?? rule.preferred;
+        return {
+            model,
+            resolvedBy: 'task_rule',
+            neverDowngrade: rule.neverDowngrade === true,
+            reason: `Task rule for "${taskType}": ${model}`,
+            candidateModel,
+        };
+    }
+    // 3. Agent-level rule
+    if (matchedAgent) {
+        const model = resolveAgentEscalation(matchedAgent, complexity) ?? matchedAgent.preferred;
+        return {
+            model,
+            resolvedBy: 'agent_rule',
+            neverDowngrade: matchedAgent.neverDowngrade === true,
+            reason: `Agent rule for "${matchedAgentName}": ${model}`,
+            candidateModel,
+        };
+    }
+    // 4. Pass-through
+    return {
+        model: candidateModel,
+        resolvedBy: emptyPolicy ? 'default_routing' : 'complexity_routing',
+        neverDowngrade: false,
+        reason: 'No policy rule matched; using complexity routing',
+        candidateModel,
+    };
+}
+function resolveEscalation(rule, complexity) {
+    if (rule.escalateTo &&
+        rule.escalateOn &&
+        rule.escalateOn.includes('complexity_high') &&
+        complexity === 'complex') {
+        return rule.escalateTo;
+    }
+    return null;
+}
+function resolveAgentEscalation(agent, complexity) {
+    if (agent.escalateTo &&
+        agent.escalateOn &&
+        agent.escalateOn.includes('complexity_high') &&
+        complexity === 'complex') {
+        return agent.escalateTo;
+    }
+    return null;
+}
+//# sourceMappingURL=agent-policy.js.map

package/dist/agent-policy.js.map

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

package/dist/budget.d.ts

@@ -6,6 +6,16 @@
  *
  * @packageDocumentation
  */
+/** Per-million token pricing for known Claude models (USD). */
+export declare const MODEL_PRICING: Record<string, {
+    inputPer1M: number;
+    outputPer1M: number;
+}>;
+/**
+ * Estimate cost in USD for a completed request given token counts.
+ * Returns 0 if the model is not in MODEL_PRICING.
+ */
+export declare function estimateCostFromTokens(model: string, inputTokens: number, outputTokens: number): number;
 export interface BudgetConfig {
     enabled: boolean;
     /** Daily spend limit in USD (default: 50) */
@@ -26,6 +36,17 @@ export interface BudgetConfig {
     sessionCapUsd: number;
     /** Model downgrade ladder — when a session exceeds 80% of its cap, downgrade to the next rung */
     modelLadder: string[];
+    /**
+     * Simple daily cap in USD used by BudgetTracker.
+     * When set, all requests are blocked once this amount is reached today.
+     * null / undefined = unlimited.
+     */
+    dailyCapUSD?: number;
+    /**
+     * Warning threshold as a fraction of dailyCapUSD (0–1). Default: 0.8.
+     * When daily spend / dailyCapUSD >= warningThreshold, a warning header is added.
+     */
+    warningThreshold?: number;
 }
 export interface SessionBudgetRecord {
     sessionId: string;
@@ -134,4 +155,64 @@ export declare class BudgetManager {
 }
 export declare function getBudgetManager(config?: Partial<BudgetConfig>): BudgetManager;
 export declare function resetBudgetManager(): void;
+export interface BudgetCapConfig {
+    /** Daily spend cap in USD. Undefined / null = unlimited (no enforcement). */
+    dailyCapUSD?: number;
+    /** Warning threshold as a fraction of the cap (0–1). Default: 0.8 */
+    warningThreshold?: number;
+}
+export interface DailySpendRecord {
+    date: string;
+    totalSpend: number;
+    byModel: Record<string, number>;
+}
+export interface BudgetCapCheckResult {
+    allowed: boolean;
+    warn: boolean;
+    spent: number;
+    cap: number | null;
+    warningThreshold: number;
+}
+export declare class BudgetTracker {
+    private dailyCapUSD;
+    private warningThreshold;
+    private db;
+    private _initialized;
+    private dailySpend;
+    private cachedDay;
+    private pendingWrites;
+    private flushTimer;
+    constructor(config?: BudgetCapConfig);
+    /** Initialize SQLite storage. Safe to call multiple times. */
+    init(): void;
+    /** Update cap / threshold at runtime (e.g. on config reload). */
+    updateConfig(config: BudgetCapConfig): void;
+    /**
+     * Pre-request check. Always <5ms — reads in-memory cache only.
+     * Call `init()` before first use.
+     */
+    check(): BudgetCapCheckResult;
+    /**
+     * Record actual spend after a request completes.
+     * Updates in-memory cache immediately; SQLite write is async.
+     */
+    record(amount: number, model: string): void;
+    /**
+     * Return daily spend history for the last `days` calendar days.
+     * Requires SQLite; falls back to today's in-memory total only.
+     */
+    getHistory(days?: number): DailySpendRecord[];
+    /** Today's total spend (USD). */
+    getDailySpend(): number;
+    /** Configured daily cap (null = unlimited). */
+    getCap(): number | null;
+    /** Flush pending writes and close SQLite. */
+    close(): void;
+    private _ensureDay;
+    private _refreshDay;
+    private _scheduleFlush;
+    private _flushPendingWrites;
+}
+export declare function getBudgetTracker(config?: BudgetCapConfig): BudgetTracker;
+export declare function resetBudgetTracker(): void;
 //# sourceMappingURL=budget.d.ts.map

package/dist/budget.d.ts.map

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

package/dist/budget.js

@@ -41,14 +41,41 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.BudgetManager = exports.DEFAULT_BUDGET_CONFIG = void 0;
+exports.BudgetTracker = exports.BudgetManager = exports.DEFAULT_BUDGET_CONFIG = exports.MODEL_PRICING = void 0;
+exports.estimateCostFromTokens = estimateCostFromTokens;
 exports.getDailyWindow = getDailyWindow;
 exports.getHourlyWindow = getHourlyWindow;
 exports.getBudgetManager = getBudgetManager;
 exports.resetBudgetManager = resetBudgetManager;
+exports.getBudgetTracker = getBudgetTracker;
+exports.resetBudgetTracker = resetBudgetTracker;
 const path = __importStar(require("node:path"));
 const os = __importStar(require("node:os"));
 const fs = __importStar(require("node:fs"));
+// ─── Model Pricing Constants ──────────────────────────────────────────
+/** Per-million token pricing for known Claude models (USD). */
+exports.MODEL_PRICING = {
+    'claude-opus-4-6': { inputPer1M: 5.00, outputPer1M: 25.00 },
+    'claude-opus-4-5': { inputPer1M: 5.00, outputPer1M: 25.00 },
+    'claude-sonnet-4-6': { inputPer1M: 3.00, outputPer1M: 15.00 },
+    'claude-sonnet-4-5': { inputPer1M: 3.00, outputPer1M: 15.00 },
+    'claude-haiku-4-5': { inputPer1M: 0.80, outputPer1M: 4.00 },
+    'claude-haiku-4-5-20251001': { inputPer1M: 0.80, outputPer1M: 4.00 },
+    'claude-3-5-sonnet-20241022': { inputPer1M: 3.00, outputPer1M: 15.00 },
+    'claude-3-5-haiku-20241022': { inputPer1M: 0.80, outputPer1M: 4.00 },
+    'claude-3-opus-20240229': { inputPer1M: 15.00, outputPer1M: 75.00 },
+};
+/**
+ * Estimate cost in USD for a completed request given token counts.
+ * Returns 0 if the model is not in MODEL_PRICING.
+ */
+function estimateCostFromTokens(model, inputTokens, outputTokens) {
+    const pricing = exports.MODEL_PRICING[model];
+    if (!pricing)
+        return 0;
+    return (inputTokens / 1_000_000) * pricing.inputPer1M
+        + (outputTokens / 1_000_000) * pricing.outputPer1M;
+}
 // ─── Defaults ────────────────────────────────────────────────────────
 exports.DEFAULT_BUDGET_CONFIG = {
     enabled: false,
@@ -526,4 +553,200 @@ function resetBudgetManager() {
         _instance = null;
     }
 }
+class BudgetTracker {
+    dailyCapUSD;
+    warningThreshold;
+    db = null;
+    _initialized = false;
+    // In-memory daily spend cache
+    dailySpend = 0;
+    cachedDay = '';
+    // Pending async writes
+    pendingWrites = [];
+    flushTimer = null;
+    constructor(config) {
+        this.dailyCapUSD = config?.dailyCapUSD ?? null;
+        this.warningThreshold = config?.warningThreshold ?? 0.8;
+    }
+    /** Initialize SQLite storage. Safe to call multiple times. */
+    init() {
+        if (this._initialized)
+            return;
+        this._initialized = true;
+        if (this.dailyCapUSD === null)
+            return; // unlimited — no persistence needed
+        const budgetDir = path.join(os.homedir(), '.relayplane');
+        fs.mkdirSync(budgetDir, { recursive: true });
+        try {
+            const dbPath = path.join(budgetDir, 'budget.db');
+            this.db = openDatabase(dbPath);
+            this.db.exec(`
+        CREATE TABLE IF NOT EXISTS daily_cap_log (
+          id INTEGER PRIMARY KEY AUTOINCREMENT,
+          amount REAL NOT NULL,
+          model TEXT NOT NULL,
+          daily_window TEXT NOT NULL,
+          timestamp INTEGER NOT NULL
+        );
+        CREATE INDEX IF NOT EXISTS idx_dcl_daily_window ON daily_cap_log(daily_window);
+      `);
+            this._refreshDay();
+        }
+        catch (err) {
+            console.warn('[RelayPlane BudgetTracker] SQLite unavailable, memory-only mode:', err.message);
+            this.db = null;
+        }
+    }
+    /** Update cap / threshold at runtime (e.g. on config reload). */
+    updateConfig(config) {
+        if ('dailyCapUSD' in config) {
+            const newCap = config.dailyCapUSD ?? null;
+            if (newCap !== this.dailyCapUSD) {
+                this.dailyCapUSD = newCap;
+                // If cap just became active and DB not open yet, re-init
+                if (newCap !== null && !this.db && this._initialized) {
+                    this._initialized = false;
+                    this.init();
+                }
+            }
+        }
+        if (config.warningThreshold !== undefined) {
+            this.warningThreshold = config.warningThreshold;
+        }
+    }
+    /**
+     * Pre-request check. Always <5ms — reads in-memory cache only.
+     * Call `init()` before first use.
+     */
+    check() {
+        if (this.dailyCapUSD === null) {
+            return { allowed: true, warn: false, spent: 0, cap: null, warningThreshold: this.warningThreshold };
+        }
+        this._ensureDay();
+        const cap = this.dailyCapUSD;
+        const spent = this.dailySpend;
+        const allowed = spent < cap;
+        const warn = allowed && cap > 0 && (spent / cap) >= this.warningThreshold;
+        return { allowed, warn, spent, cap, warningThreshold: this.warningThreshold };
+    }
+    /**
+     * Record actual spend after a request completes.
+     * Updates in-memory cache immediately; SQLite write is async.
+     */
+    record(amount, model) {
+        if (this.dailyCapUSD === null || amount <= 0)
+            return;
+        this._ensureDay();
+        this.dailySpend += amount;
+        this.pendingWrites.push({ amount, model, dailyWindow: this.cachedDay, timestamp: Date.now() });
+        this._scheduleFlush();
+    }
+    /**
+     * Return daily spend history for the last `days` calendar days.
+     * Requires SQLite; falls back to today's in-memory total only.
+     */
+    getHistory(days = 30) {
+        const cutoff = new Date();
+        cutoff.setDate(cutoff.getDate() - days);
+        const cutoffStr = cutoff.toISOString().slice(0, 10);
+        if (this.db) {
+            const rows = this.db.prepare(`
+        SELECT daily_window, model, SUM(amount) as total
+        FROM daily_cap_log
+        WHERE daily_window >= ?
+        GROUP BY daily_window, model
+        ORDER BY daily_window DESC
+      `).all(cutoffStr);
+            const byDate = new Map();
+            for (const row of rows) {
+                if (!byDate.has(row.daily_window)) {
+                    byDate.set(row.daily_window, { date: row.daily_window, totalSpend: 0, byModel: {} });
+                }
+                const rec = byDate.get(row.daily_window);
+                rec.byModel[row.model] = (rec.byModel[row.model] ?? 0) + row.total;
+                rec.totalSpend += row.total;
+            }
+            return Array.from(byDate.values()).sort((a, b) => b.date.localeCompare(a.date));
+        }
+        // Memory-only fallback
+        if (this.dailySpend > 0 && this.cachedDay >= cutoffStr) {
+            return [{ date: this.cachedDay, totalSpend: this.dailySpend, byModel: {} }];
+        }
+        return [];
+    }
+    /** Today's total spend (USD). */
+    getDailySpend() {
+        this._ensureDay();
+        return this.dailySpend;
+    }
+    /** Configured daily cap (null = unlimited). */
+    getCap() {
+        return this.dailyCapUSD;
+    }
+    /** Flush pending writes and close SQLite. */
+    close() {
+        this._flushPendingWrites();
+        if (this.flushTimer) {
+            clearTimeout(this.flushTimer);
+            this.flushTimer = null;
+        }
+        if (this.db) {
+            this.db.close();
+            this.db = null;
+        }
+    }
+    // ─── Private ──────────────────────────────────────────────────────
+    _ensureDay() {
+        const today = getDailyWindow();
+        if (today !== this.cachedDay) {
+            this.cachedDay = today;
+            this.dailySpend = 0;
+            if (this.db) {
+                const row = this.db.prepare('SELECT COALESCE(SUM(amount), 0) as total FROM daily_cap_log WHERE daily_window = ?').get(today);
+                this.dailySpend = row?.total ?? 0;
+            }
+        }
+    }
+    _refreshDay() {
+        this.cachedDay = '';
+        this._ensureDay();
+    }
+    _scheduleFlush() {
+        if (this.flushTimer)
+            return;
+        this.flushTimer = setTimeout(() => {
+            this.flushTimer = null;
+            this._flushPendingWrites();
+        }, 1000);
+    }
+    _flushPendingWrites() {
+        if (!this.db || this.pendingWrites.length === 0)
+            return;
+        const writes = this.pendingWrites.splice(0);
+        try {
+            const stmt = this.db.prepare('INSERT INTO daily_cap_log (amount, model, daily_window, timestamp) VALUES (?, ?, ?, ?)');
+            for (const w of writes) {
+                stmt.run(w.amount, w.model, w.dailyWindow, w.timestamp);
+            }
+        }
+        catch (err) {
+            console.warn('[RelayPlane BudgetTracker] SQLite flush failed:', err.message);
+        }
+    }
+}
+exports.BudgetTracker = BudgetTracker;
+// ─── BudgetTracker Singleton ─────────────────────────────────────────
+let _trackerInstance = null;
+function getBudgetTracker(config) {
+    if (!_trackerInstance) {
+        _trackerInstance = new BudgetTracker(config);
+    }
+    return _trackerInstance;
+}
+function resetBudgetTracker() {
+    if (_trackerInstance) {
+        _trackerInstance.close();
+        _trackerInstance = null;
+    }
+}
 //# sourceMappingURL=budget.js.map