@iflow-mcp/jkheadley-instar 0.26.2

package/dist/monitoring/QuotaManager.js

@@ -0,0 +1,575 @@
+/**
+ * QuotaManager — Orchestration hub for all quota management components.
+ *
+ * Owns: QuotaCollector, QuotaTracker, SessionMigrator, QuotaNotifier,
+ *       AccountSwitcher, SessionCredentialManager.
+ *
+ * Drives the adaptive polling loop, auto-triggers migration on threshold
+ * crossings, and emits unified events for downstream consumers (Telegram,
+ * dashboards, admin UI).
+ *
+ * Phase 4 of INSTAR_QUOTA_MIGRATION_SPEC.
+ */
+import { EventEmitter } from 'node:events';
+import { SessionCredentialManager } from './SessionCredentialManager.js';
+import { DegradationReporter } from './DegradationReporter.js';
+const MAX_NOTIFICATION_RETRIES = 3;
+const NOTIFICATION_BACKOFF_BASE_MS = 5000;
+// ── QuotaManager class ───────────────────────────────────────────────
+export class QuotaManager extends EventEmitter {
+    tracker;
+    collector;
+    switcher;
+    migrator;
+    notifier;
+    credentialManager;
+    config;
+    pollingTimer = null;
+    running = false;
+    lastCollectionAt = null;
+    nextCollectionAt = null;
+    pendingNotifications = [];
+    notificationRetryTimer = null;
+    sendNotification = null;
+    // References set via setSessionManager / setScheduler
+    sessionManager = null;
+    scheduler = null;
+    constructor(config, components) {
+        super();
+        this.config = {
+            adaptivePolling: true,
+            autoMigrate: true,
+            jsonlCanTriggerMigration: false,
+            ...config,
+        };
+        this.tracker = components.tracker;
+        this.collector = components.collector ?? null;
+        this.switcher = components.switcher ?? null;
+        this.migrator = components.migrator ?? null;
+        this.notifier = components.notifier;
+        this.credentialManager = components.credentialManager ?? new SessionCredentialManager();
+        // Forward collector events
+        if (this.collector) {
+            this.collector.on('token_expired', (ev) => this.emit('token_expired', ev));
+            this.collector.on('token_expiring', (ev) => this.emit('token_expiring', ev));
+            this.collector.on('jsonl_parse_error', (ev) => this.emit('jsonl_parse_error', ev));
+        }
+        // Forward migrator events
+        if (this.migrator) {
+            this.migrator.on('migration_started', (ev) => {
+                this.emit('migration_started', {
+                    type: 'started',
+                    sourceAccount: ev.reason,
+                    targetAccount: ev.targetAccount,
+                    sessionsAffected: 0,
+                    timestamp: new Date().toISOString(),
+                });
+                this.enqueueNotification(`🔄 Migration started: switching from ${ev.sourceAccount} to ${ev.targetAccount}`);
+            });
+            this.migrator.on('migration_complete', (ev) => {
+                this.emit('migration_complete', {
+                    type: 'complete',
+                    sourceAccount: ev.previousAccount ?? 'unknown',
+                    targetAccount: ev.newAccount ?? undefined,
+                    sessionsAffected: ev.sessionsRestarted?.length ?? 0,
+                    duration: ev.durationMs,
+                    timestamp: ev.completedAt,
+                });
+                this.enqueueNotification(`✅ Migration complete: switched to ${ev.newAccount}. ` +
+                    `${ev.sessionsRestarted?.length ?? 0} sessions restarted in ${Math.round((ev.durationMs ?? 0) / 1000)}s.`);
+            });
+            this.migrator.on('migration_failed', (ev) => {
+                this.emit('migration_failed', {
+                    type: 'failed',
+                    sourceAccount: ev.previousAccount ?? 'unknown',
+                    sessionsAffected: ev.sessionsHalted?.length ?? 0,
+                    error: ev.error,
+                    duration: ev.durationMs,
+                    timestamp: ev.completedAt,
+                });
+                this.enqueueNotification(`❌ Migration failed: ${ev.error ?? 'unknown error'}`);
+            });
+            this.migrator.on('migration_partial', (ev) => {
+                this.emit('migration_partial', {
+                    type: 'partial',
+                    sourceAccount: ev.previousAccount ?? 'unknown',
+                    targetAccount: ev.newAccount ?? undefined,
+                    sessionsAffected: ev.sessionsRestarted?.length ?? 0,
+                    duration: ev.durationMs,
+                    timestamp: ev.completedAt,
+                });
+                this.enqueueNotification(`⚠️ Migration partial: ${ev.sessionsRestarted?.length ?? 0}/${ev.sessionsHalted?.length ?? 0} sessions restarted.`);
+            });
+            this.migrator.on('migration_no_target', (ev) => {
+                this.emit('migration_no_target', {
+                    type: 'no_target',
+                    sourceAccount: ev.sourceAccount ?? 'unknown',
+                    sessionsAffected: 0,
+                    timestamp: new Date().toISOString(),
+                });
+                this.enqueueNotification(`⚠️ Quota migration triggered but no alternative account available. ` +
+                    `Enforcement will activate at 90% 5-hour rate.`);
+            });
+            this.migrator.on('enforced_pause', (ev) => {
+                this.enqueueNotification(`⚠️ [QUOTA ENFORCEMENT] PAUSE WARNING\n` +
+                    `5-hour rate: ${ev.fiveHourPercent}% — no alternative accounts.\n` +
+                    `Sent graceful shutdown to ${ev.sessionsSignaled} session(s). Scheduler paused.\n` +
+                    `If quota reaches 95%, all sessions will be killed.`);
+            });
+            this.migrator.on('enforced_kill', (ev) => {
+                this.enqueueNotification(`🚨 [QUOTA ENFORCEMENT] EMERGENCY STOP\n` +
+                    `5-hour rate: ${ev.fiveHourPercent}% — no alternative accounts.\n` +
+                    `Killed ${ev.sessionsKilled.length} session(s): ${ev.sessionsKilled.join(', ') || 'none'}.\n` +
+                    `Scheduler paused. Manual intervention required.`);
+            });
+        }
+    }
+    // ── Dependency wiring ────────────────────────────────────────────
+    /**
+     * Set the SessionManager for wiring migrator deps.
+     */
+    setSessionManager(sm) {
+        this.sessionManager = sm;
+        this.wireMigratorDeps();
+    }
+    /**
+     * Set the JobScheduler for spawn gating and migration respawns.
+     * Also replaces scheduler.canRunJob with quota-aware version.
+     */
+    setScheduler(sched) {
+        this.scheduler = sched;
+        // Replace canRunJob with quota-aware gate
+        sched.canRunJob = (priority) => this.canSpawnSession(priority).allowed;
+        this.wireMigratorDeps();
+    }
+    /**
+     * Set the notification send function (e.g., Telegram relay).
+     */
+    setNotificationSender(fn) {
+        this.sendNotification = fn;
+    }
+    /**
+     * Wire migrator deps once both sessionManager and scheduler are available.
+     */
+    wireMigratorDeps() {
+        if (!this.migrator || !this.sessionManager || !this.scheduler || !this.switcher) {
+            return;
+        }
+        const sm = this.sessionManager;
+        const sched = this.scheduler;
+        const switcher = this.switcher;
+        this.migrator.setDeps({
+            listRunningSessions: () => sm.listRunningSessions().map(s => ({
+                id: s.id,
+                tmuxSession: s.tmuxSession,
+                jobSlug: s.jobSlug,
+                name: s.name,
+            })),
+            sendKey: (tmuxSession, key) => sm.sendKey(tmuxSession, key),
+            killSession: (sessionId) => sm.killSession(sessionId),
+            isSessionAlive: (tmuxSession) => sm.isSessionAlive(tmuxSession),
+            pauseScheduler: () => sched.pause(),
+            resumeScheduler: () => sched.resume(),
+            respawnJob: async (slug) => {
+                // Resume scheduler momentarily to allow the trigger
+                sched.resume();
+                const result = sched.triggerJob(slug, 'migration-respawn');
+                if (result === 'skipped') {
+                    console.log(`[QuotaManager] Respawn ${slug} skipped (quota/gate check failed)`);
+                }
+            },
+            getAccountStatuses: () => switcher.getAccountStatuses(),
+            switchAccount: (email) => switcher.switchAccount(email),
+        });
+        // Recover from any in-progress migration that was interrupted
+        this.migrator.completeRecovery().catch(err => {
+            console.error('[QuotaManager] Migration recovery failed:', err);
+        });
+    }
+    // ── Polling loop ─────────────────────────────────────────────────
+    /**
+     * Start the adaptive polling loop. Collector drives the interval.
+     */
+    start() {
+        if (this.running)
+            return;
+        this.running = true;
+        // Start notification retry processor
+        this.notificationRetryTimer = setInterval(() => this.processNotificationRetries(), 10000);
+        if (this.collector && this.config.adaptivePolling) {
+            // Kick off the first collection immediately
+            this.scheduleNextCollection(0);
+            console.log('[QuotaManager] Started adaptive polling loop');
+        }
+        else {
+            // No collector — fall back to periodic tracker reads
+            this.scheduleTrackerPoll();
+            console.log('[QuotaManager] Started (tracker-only mode, no collector)');
+        }
+        this.emit('started');
+    }
+    /**
+     * Stop polling and clean up.
+     */
+    stop() {
+        if (!this.running)
+            return;
+        this.running = false;
+        if (this.pollingTimer) {
+            clearTimeout(this.pollingTimer);
+            this.pollingTimer = null;
+        }
+        if (this.notificationRetryTimer) {
+            clearInterval(this.notificationRetryTimer);
+            this.notificationRetryTimer = null;
+        }
+        this.nextCollectionAt = null;
+        this.emit('stopped');
+        console.log('[QuotaManager] Stopped');
+    }
+    /**
+     * Force an immediate collection + migration check + notification check.
+     */
+    async refresh() {
+        if (this.collector) {
+            return this.runCollectionCycle();
+        }
+        // No collector — just refresh from tracker's file
+        const state = this.tracker.getState();
+        if (state) {
+            await this.postCollectionChecks(state, 'oauth', 'authoritative');
+        }
+        return null;
+    }
+    // ── Spawn gating ────────────────────────────────────────────────
+    /**
+     * Check if a session can be spawned at a given priority.
+     * Considers both quota thresholds and migration state.
+     *
+     * Order matters: check quota thresholds FIRST, then migration state.
+     * A stale migration state (e.g., from a crash) should not block jobs
+     * when quota is healthy. Migration is a quota-saving measure — if
+     * quota is fine, migration concerns are irrelevant.
+     */
+    canSpawnSession(priority) {
+        // Check quota thresholds first
+        const trackerResult = this.tracker.shouldSpawnSession(priority);
+        if (!trackerResult.allowed) {
+            return trackerResult;
+        }
+        // During migration, block only if there's actual quota pressure.
+        // This prevents stale migration state (from crashes) from permanently
+        // blocking all jobs when quota is healthy.
+        if (this.migrator?.isMigrating()) {
+            const state = this.tracker.getState();
+            const weeklyPressure = state != null && state.usagePercent >= 50;
+            const fiveHourPressure = state != null &&
+                typeof state.fiveHourPercent === 'number' &&
+                state.fiveHourPercent >= 50;
+            if (weeklyPressure || fiveHourPressure) {
+                return { allowed: false, reason: 'Migration in progress — session spawning blocked' };
+            }
+            // Quota is healthy despite "migrating" state — allow spawn
+        }
+        return trackerResult;
+    }
+    // ── Internal: collection cycle ───────────────────────────────────
+    scheduleNextCollection(delayMs) {
+        if (!this.running)
+            return;
+        if (this.pollingTimer) {
+            clearTimeout(this.pollingTimer);
+        }
+        this.nextCollectionAt = new Date(Date.now() + delayMs);
+        this.pollingTimer = setTimeout(async () => {
+            try {
+                await this.runCollectionCycle();
+            }
+            catch (err) {
+                DegradationReporter.getInstance().report({
+                    feature: 'QuotaManager.scheduleNextCollection',
+                    primary: 'Run periodic quota collection cycle',
+                    fallback: 'Collection skipped, will retry at next interval',
+                    reason: `Collection cycle error: ${err instanceof Error ? err.message : String(err)}`,
+                    impact: 'Quota data may be stale until next successful collection',
+                });
+                console.error('[QuotaManager] Collection cycle error:', err);
+            }
+            // Schedule next based on adaptive interval
+            if (this.running && this.collector) {
+                const nextInterval = this.collector.getPollingIntervalMs();
+                this.scheduleNextCollection(nextInterval);
+            }
+        }, delayMs);
+    }
+    /**
+     * Fallback: when no collector, poll the tracker file every 5 minutes.
+     */
+    scheduleTrackerPoll() {
+        if (!this.running)
+            return;
+        const TRACKER_POLL_MS = 5 * 60 * 1000;
+        this.nextCollectionAt = new Date(Date.now() + TRACKER_POLL_MS);
+        this.pollingTimer = setTimeout(async () => {
+            try {
+                const state = this.tracker.getState();
+                if (state) {
+                    await this.postCollectionChecks(state, 'oauth', 'authoritative');
+                }
+            }
+            catch (err) {
+                DegradationReporter.getInstance().report({
+                    feature: 'QuotaManager.scheduleTrackerPoll',
+                    primary: 'Poll quota tracker for state updates',
+                    fallback: 'Tracker poll skipped, will retry at next interval',
+                    reason: `Tracker poll error: ${err instanceof Error ? err.message : String(err)}`,
+                    impact: 'Threshold notifications and migration checks delayed',
+                });
+                console.error('[QuotaManager] Tracker poll error:', err);
+            }
+            this.scheduleTrackerPoll();
+        }, TRACKER_POLL_MS);
+    }
+    async runCollectionCycle() {
+        if (!this.collector)
+            return null;
+        const result = await this.collector.collect();
+        this.lastCollectionAt = new Date();
+        if (result.success && result.state) {
+            await this.postCollectionChecks(result.state, result.dataSource, result.dataConfidence);
+        }
+        else if (result.errors.length > 0) {
+            console.warn('[QuotaManager] Collection errors:', result.errors.join('; '));
+        }
+        return result;
+    }
+    async postCollectionChecks(state, dataSource, dataConfidence) {
+        // 1. Notify on threshold crossings
+        try {
+            await this.notifier.checkAndNotify(state);
+        }
+        catch (err) {
+            DegradationReporter.getInstance().report({
+                feature: 'QuotaManager.postCollectionChecks.notify',
+                primary: 'Check quota thresholds and send notifications',
+                fallback: 'Notifications skipped for this collection cycle',
+                reason: `Notification check failed: ${err instanceof Error ? err.message : String(err)}`,
+                impact: 'User may not receive quota threshold alerts',
+            });
+            console.error('[QuotaManager] Notification check failed:', err);
+        }
+        // 2. Emit threshold events for subscribers
+        this.emitThresholdEvents(state, dataSource);
+        // 3. Auto-migrate if enabled and thresholds warrant it
+        if (this.config.autoMigrate && this.migrator && !this.migrator.isMigrating()) {
+            // Don't trigger migration from JSONL estimates unless explicitly allowed
+            if (dataConfidence === 'estimated' && !this.config.jsonlCanTriggerMigration) {
+                return;
+            }
+            try {
+                const migrated = await this.migrator.checkAndMigrate({
+                    percentUsed: state.usagePercent,
+                    fiveHourPercent: state.fiveHourPercent ?? undefined,
+                    activeAccountEmail: state.accounts?.find(a => a.isActive)?.email ?? null,
+                });
+                if (migrated) {
+                    console.log('[QuotaManager] Migration triggered after collection');
+                }
+            }
+            catch (err) {
+                DegradationReporter.getInstance().report({
+                    feature: 'QuotaManager.postCollectionChecks.migrate',
+                    primary: 'Check if account migration is needed based on quota thresholds',
+                    fallback: 'Migration check skipped, will retry at next collection',
+                    reason: `Migration check failed: ${err instanceof Error ? err.message : String(err)}`,
+                    impact: 'Auto-migration may be delayed if quota thresholds are breached',
+                });
+                console.error('[QuotaManager] Migration check failed:', err);
+            }
+        }
+    }
+    emitThresholdEvents(state, dataSource) {
+        const account = state.accounts?.find(a => a.isActive)?.email ?? 'unknown';
+        const ts = new Date().toISOString();
+        // Weekly thresholds: 70 (warning), 85 (critical), 95 (limit)
+        const weekly = state.usagePercent;
+        if (weekly >= 95) {
+            this.emit('threshold_crossed', {
+                level: 'limit', metric: 'weekly', value: weekly,
+                threshold: 95, account, dataSource, timestamp: ts,
+            });
+        }
+        else if (weekly >= 85) {
+            this.emit('threshold_crossed', {
+                level: 'critical', metric: 'weekly', value: weekly,
+                threshold: 85, account, dataSource, timestamp: ts,
+            });
+        }
+        else if (weekly >= 70) {
+            this.emit('threshold_crossed', {
+                level: 'warning', metric: 'weekly', value: weekly,
+                threshold: 70, account, dataSource, timestamp: ts,
+            });
+        }
+        // 5-hour thresholds: 80 (warning), 95 (limit)
+        const fiveHour = state.fiveHourPercent;
+        if (typeof fiveHour === 'number' && isFinite(fiveHour)) {
+            if (fiveHour >= 95) {
+                this.emit('threshold_crossed', {
+                    level: 'limit', metric: 'fiveHour', value: fiveHour,
+                    threshold: 95, account, dataSource, timestamp: ts,
+                });
+            }
+            else if (fiveHour >= 80) {
+                this.emit('threshold_crossed', {
+                    level: 'warning', metric: 'fiveHour', value: fiveHour,
+                    threshold: 80, account, dataSource, timestamp: ts,
+                });
+            }
+        }
+    }
+    // ── Notification retry queue ───────────────────────────────────
+    enqueueNotification(message) {
+        // Try immediate send
+        if (this.sendNotification) {
+            this.sendNotification(message).catch(() => {
+                this.pendingNotifications.push({
+                    message,
+                    retries: 0,
+                    nextRetryAt: Date.now() + NOTIFICATION_BACKOFF_BASE_MS,
+                    createdAt: Date.now(),
+                });
+            });
+        }
+        else {
+            console.log(`[QuotaManager] No notification sender, logging: ${message}`);
+        }
+    }
+    async processNotificationRetries() {
+        if (!this.sendNotification || this.pendingNotifications.length === 0)
+            return;
+        const now = Date.now();
+        const remaining = [];
+        for (const notif of this.pendingNotifications) {
+            if (now < notif.nextRetryAt) {
+                remaining.push(notif);
+                continue;
+            }
+            try {
+                await this.sendNotification(notif.message);
+                // Success — drop from queue
+            }
+            catch {
+                notif.retries++;
+                if (notif.retries < MAX_NOTIFICATION_RETRIES) {
+                    notif.nextRetryAt = now + NOTIFICATION_BACKOFF_BASE_MS * Math.pow(2, notif.retries);
+                    remaining.push(notif);
+                }
+                else {
+                    console.error(`[QuotaManager] Notification delivery failed after ${MAX_NOTIFICATION_RETRIES} retries: ${notif.message}`);
+                    this.emit('notification_delivery_failed', { message: notif.message });
+                }
+            }
+        }
+        this.pendingNotifications = remaining;
+    }
+    // ── Status / API ─────────────────────────────────────────────────
+    /**
+     * Get polling status for the /quota/polling endpoint.
+     */
+    getPollingStatus() {
+        const pollingState = this.collector?.getPollingState();
+        const budget = this.collector?.getBudgetStatus();
+        const lastDuration = this.collector?.getLastCollectionDurationMs() ?? 0;
+        return {
+            running: this.running,
+            currentIntervalMs: this.collector?.getPollingIntervalMs() ?? 0,
+            nextCollectionAt: this.nextCollectionAt?.toISOString() ?? null,
+            lastCollectionAt: this.lastCollectionAt?.toISOString() ?? null,
+            lastCollectionDurationMs: lastDuration,
+            requestBudget: budget
+                ? {
+                    used: budget.used,
+                    limit: budget.limit,
+                    remaining: budget.remaining,
+                    windowResetsAt: new Date(budget.resetsAt).toISOString(),
+                }
+                : { used: 0, limit: 0, remaining: 0, windowResetsAt: new Date().toISOString() },
+            hysteresisState: pollingState
+                ? {
+                    consecutiveBelowThreshold: pollingState.consecutiveBelowThreshold,
+                    currentTier: pollingState.currentTier,
+                }
+                : { consecutiveBelowThreshold: 0, currentTier: 'unknown' },
+        };
+    }
+    /**
+     * Get migration status for the /quota/migration endpoint.
+     */
+    getMigrationStatus() {
+        if (!this.migrator) {
+            return {
+                status: 'not_configured',
+                currentMigration: null,
+                history: [],
+                config: { enabled: false, fiveHourThreshold: 0, weeklyThreshold: 0, cooldownMinutes: 0 },
+                cooldownUntil: null,
+            };
+        }
+        const status = this.migrator.getMigrationStatus();
+        const thresholds = this.migrator.getThresholds();
+        // Derive cooldownUntil from last migration completion + cooldown threshold
+        let cooldownUntil = null;
+        if (status.lastMigration?.completedAt) {
+            const expiresAt = new Date(status.lastMigration.completedAt).getTime() + thresholds.cooldownMs;
+            if (expiresAt > Date.now()) {
+                cooldownUntil = new Date(expiresAt).toISOString();
+            }
+        }
+        return {
+            status: status.state,
+            currentMigration: status.inProgress ? status.lastMigration : null,
+            history: status.history,
+            config: {
+                enabled: true,
+                fiveHourThreshold: thresholds.fiveHourPercent,
+                weeklyThreshold: thresholds.weeklyPercent,
+                cooldownMinutes: Math.round(thresholds.cooldownMs / 60000),
+            },
+            cooldownUntil,
+        };
+    }
+    /**
+     * Manually trigger a migration (for the POST /quota/migration/trigger endpoint).
+     */
+    async triggerMigration(options) {
+        if (!this.migrator) {
+            return { triggered: false, reason: 'Migration not configured (no SessionMigrator)' };
+        }
+        if (this.migrator.isMigrating()) {
+            return { triggered: false, reason: 'Migration already in progress' };
+        }
+        const state = this.tracker.getState();
+        if (!state) {
+            return { triggered: false, reason: 'No quota data available' };
+        }
+        try {
+            const triggered = await this.migrator.checkAndMigrate({
+                percentUsed: state.usagePercent,
+                fiveHourPercent: state.fiveHourPercent ?? undefined,
+                activeAccountEmail: state.accounts?.find(a => a.isActive)?.email ?? null,
+            });
+            return {
+                triggered,
+                reason: triggered ? 'Migration started' : 'Thresholds not met or in cooldown',
+            };
+        }
+        catch (err) {
+            return {
+                triggered: false,
+                reason: `Migration error: ${err instanceof Error ? err.message : String(err)}`,
+            };
+        }
+    }
+}
+//# sourceMappingURL=QuotaManager.js.map

package/dist/monitoring/QuotaManager.js.map

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

package/dist/monitoring/QuotaNotifier.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Quota Notifier — sends alerts when quota thresholds are crossed.
+ *
+ * Handles both weekly and 5-hour rate limit notifications independently.
+ * Deduplicates notifications so the same threshold doesn't spam.
+ * Persists state to survive server restarts.
+ *
+ * Ported from Dawn's dawn-server equivalent for general Instar use.
+ */
+import type { QuotaState } from '../core/types.js';
+type SendFn = (topicId: number, text: string) => Promise<void>;
+export declare class QuotaNotifier {
+    private state;
+    private statePath;
+    private sendToTopic;
+    private alertTopicId;
+    constructor(stateDir: string);
+    /**
+     * Configure the notification target.
+     */
+    configure(sendFn: SendFn, alertTopicId: number | null): void;
+    /**
+     * Check quota state and send notifications if thresholds are crossed.
+     */
+    checkAndNotify(quotaState: QuotaState): Promise<void>;
+    /**
+     * Send an ad-hoc alert (e.g., from session death detection).
+     */
+    sendAlert(message: string): Promise<void>;
+    private checkWeeklyThreshold;
+    private checkFiveHourThreshold;
+    private send;
+    private recordNotification;
+    private loadState;
+    private saveState;
+}
+export {};
+//# sourceMappingURL=QuotaNotifier.d.ts.map

package/dist/monitoring/QuotaNotifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"QuotaNotifier.d.ts","sourceRoot":"","sources":["../../src/monitoring/QuotaNotifier.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAyBnD,KAAK,MAAM,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAE/D,qBAAa,aAAa;IACxB,OAAO,CAAC,KAAK,CAAoB;IACjC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,WAAW,CAAuB;IAC1C,OAAO,CAAC,YAAY,CAAuB;gBAE/B,QAAQ,EAAE,MAAM;IAK5B;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAK5D;;OAEG;IACG,cAAc,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAU3D;;OAEG;IACG,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;YAIjC,oBAAoB;YAyBpB,sBAAsB;YAuBtB,IAAI;IAYlB,OAAO,CAAC,kBAAkB;IAa1B,OAAO,CAAC,SAAS;IASjB,OAAO,CAAC,SAAS;CASlB"}