reflectt-node 0.1.0

package/dist/noise-budget.d.ts

@@ -0,0 +1,136 @@
+export interface NoiseBudgetConfig {
+    /** Enable noise budget enforcement (default: true) */
+    enabled: boolean;
+    /** Canary mode — log only, don't suppress (default: true for first 24h) */
+    canaryMode: boolean;
+    /** Rolling window size in ms (default: 24h) */
+    windowMs: number;
+    /** Per-channel budget: max ratio of control-plane messages (0-1, default: 0.30) */
+    channelBudgets: Record<string, number>;
+    /** Default budget for channels without explicit config */
+    defaultBudget: number;
+    /** Duplicate suppression window in ms (default: 10 min) */
+    dedupWindowMs: number;
+    /** Digest batch interval in ms (default: 30 min) */
+    digestIntervalMs: number;
+    /** Categories that bypass all budget enforcement */
+    bypassCategories: string[];
+    /** Maximum digest queue size before force-flush */
+    maxDigestQueueSize: number;
+}
+export interface MessageRecord {
+    id: string;
+    channel: string;
+    from: string;
+    contentHash: string;
+    category: string;
+    isControlPlane: boolean;
+    timestamp: number;
+    suppressed: boolean;
+    suppressReason?: string;
+}
+export interface ChannelBudgetState {
+    channel: string;
+    totalMessages: number;
+    controlPlaneMessages: number;
+    contentMessages: number;
+    currentRatio: number;
+    budgetLimit: number;
+    overBudget: boolean;
+    suppressedCount: number;
+    digestedCount: number;
+}
+export interface NoiseBudgetSnapshot {
+    timestamp: number;
+    windowMs: number;
+    canaryMode: boolean;
+    channels: Record<string, ChannelBudgetState>;
+    totalSuppressed: number;
+    totalDigested: number;
+    dedupHits: number;
+    digestQueueSize: number;
+}
+export interface DigestEntry {
+    from: string;
+    content: string;
+    category: string;
+    channel: string;
+    originalTimestamp: number;
+    taskId?: string | null;
+}
+export interface SuppressionResult {
+    allowed: boolean;
+    reason?: string;
+    /** If message was queued for digest instead of suppressed */
+    digested?: boolean;
+}
+export declare class NoiseBudgetManager {
+    private config;
+    private messageLog;
+    private dedupCache;
+    private digestQueue;
+    private digestTimer;
+    private suppressionLog;
+    private totalDedupHits;
+    private totalDigested;
+    private onDigestFlush;
+    constructor(config?: Partial<NoiseBudgetConfig>);
+    /**
+     * Check if a message should be allowed through, suppressed, or digested.
+     * Called from routeMessage() BEFORE sending.
+     */
+    checkMessage(opts: {
+        from: string;
+        content: string;
+        channel: string;
+        category?: string;
+        severity?: string;
+        taskId?: string | null;
+    }): SuppressionResult;
+    private recordMessage;
+    /**
+     * Record a content message (non-routed, direct agent/human message).
+     * Called to track the denominator accurately.
+     */
+    recordContentMessage(channel: string, from: string): void;
+    getChannelBudgetState(channel: string): ChannelBudgetState;
+    private startDigestTimer;
+    flushDigestQueue(): Promise<DigestEntry[]>;
+    /**
+     * Register a handler that sends digest messages.
+     * Called by server startup to wire digest → chat.
+     */
+    setDigestFlushHandler(handler: (channel: string, entries: DigestEntry[]) => Promise<void>): void;
+    getSnapshot(): NoiseBudgetSnapshot;
+    /**
+     * Get canary metrics for rollback evaluation.
+     * Returns signals for the three rollback triggers from spec.
+     */
+    getCanaryMetrics(): {
+        snapshot: NoiseBudgetSnapshot;
+        rollbackSignals: {
+            /** SLA miss increase > 5pp vs baseline? (placeholder — needs SLA data) */
+            slaMissIncrease: number | null;
+            /** P95 first-response increase > 20%? (placeholder — needs response data) */
+            p95ResponseIncrease: number | null;
+            /** Critical reminder misses count */
+            criticalReminderMisses: number;
+            /** Whether any rollback trigger is tripped */
+            rollbackTriggered: boolean;
+        };
+    };
+    private logSuppression;
+    getSuppressionLog(options?: {
+        limit?: number;
+        since?: number;
+    }): typeof this.suppressionLog;
+    getConfig(): Readonly<NoiseBudgetConfig>;
+    updateConfig(updates: Partial<NoiseBudgetConfig>): void;
+    /** Exit canary mode — start enforcing suppression */
+    activateEnforcement(): void;
+    private hashContent;
+    /** Stop timers for clean shutdown */
+    stop(): void;
+}
+export declare const noiseBudgetManager: NoiseBudgetManager;
+//# sourceMappingURL=noise-budget.d.ts.map

package/dist/noise-budget.d.ts.map

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

package/dist/noise-budget.js

@@ -0,0 +1,340 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (c) Reflectt AI
+/**
+ * Noise Budget — Control-Plane Message Rate Limiter
+ *
+ * P0-1 implementation for task-1771341488434-778v3hg36
+ *
+ * Tracks control-plane vs content messages per channel (rolling 24h window).
+ * Enforces per-channel budgets with duplicate suppression and digest batching.
+ *
+ * Denominator definition (per spec):
+ *   - Includes: human + agent content messages in #general
+ *   - Excludes: bot acks, reactions, join/leave, system edit/delete events
+ *
+ * Three enforcement mechanisms:
+ *   1. Duplicate suppression — dedup identical messages within a window
+ *   2. Digest batching — queue low-priority messages into periodic digests
+ *   3. Per-channel budget — hard cap on control-plane ratio per channel
+ */
+import { createHash } from 'crypto';
+// Control-plane message categories (system-generated enforcement/automation)
+const CONTROL_PLANE_CATEGORIES = new Set([
+    'watchdog-alert',
+    'status-update',
+    'digest',
+    'system-info',
+    'continuity-loop',
+    'mention-rescue',
+]);
+// Categories that are never control-plane (always count as content)
+const CONTENT_CATEGORIES = new Set([
+    'ship-notice',
+    'review-request',
+    'blocker',
+    'escalation',
+]);
+// ── Default Config ─────────────────────────────────────────────────────────
+const DEFAULT_CONFIG = {
+    enabled: true,
+    canaryMode: true, // Start in canary mode — log only
+    windowMs: 24 * 60 * 60 * 1000, // 24 hours
+    channelBudgets: {
+        general: 0.30, // 30% max control-plane in #general (target from spec)
+    },
+    defaultBudget: 0.50, // More lenient for other channels
+    dedupWindowMs: 10 * 60 * 1000, // 10 minutes
+    digestIntervalMs: 30 * 60 * 1000, // 30 minutes
+    bypassCategories: ['escalation', 'blocker', 'critical'],
+    maxDigestQueueSize: 50,
+};
+// ── Noise Budget Manager ───────────────────────────────────────────────────
+export class NoiseBudgetManager {
+    config;
+    messageLog = [];
+    dedupCache = new Map(); // hash -> timestamp
+    digestQueue = [];
+    digestTimer = null;
+    suppressionLog = [];
+    totalDedupHits = 0;
+    totalDigested = 0;
+    onDigestFlush = null;
+    constructor(config) {
+        this.config = { ...DEFAULT_CONFIG, ...config };
+        if (this.config.enabled) {
+            this.startDigestTimer();
+        }
+    }
+    // ── Core: Pre-send Check ───────────────────────────────────────────────
+    /**
+     * Check if a message should be allowed through, suppressed, or digested.
+     * Called from routeMessage() BEFORE sending.
+     */
+    checkMessage(opts) {
+        if (!this.config.enabled) {
+            return { allowed: true };
+        }
+        const category = opts.category || 'system-info';
+        const severity = opts.severity || 'info';
+        // 1. Bypass categories always pass
+        if (this.config.bypassCategories.includes(category) || severity === 'critical') {
+            this.recordMessage(opts.channel, opts.from, opts.content, category, false, false);
+            return { allowed: true };
+        }
+        const isControlPlane = CONTROL_PLANE_CATEGORIES.has(category);
+        const contentHash = this.hashContent(opts.from, opts.content, opts.channel);
+        // 2. Duplicate suppression
+        const lastSeen = this.dedupCache.get(contentHash);
+        const now = Date.now();
+        if (lastSeen && (now - lastSeen) < this.config.dedupWindowMs) {
+            this.totalDedupHits++;
+            this.logSuppression(opts.channel, opts.from, 'duplicate', category, opts.content);
+            this.recordMessage(opts.channel, opts.from, opts.content, category, isControlPlane, true, 'duplicate');
+            if (this.config.canaryMode) {
+                // Canary: log but don't suppress
+                return { allowed: true, reason: 'canary-would-suppress-duplicate' };
+            }
+            return { allowed: false, reason: 'duplicate-suppressed' };
+        }
+        // Update dedup cache
+        this.dedupCache.set(contentHash, now);
+        // 3. Per-channel budget check (only for control-plane messages)
+        if (isControlPlane) {
+            const budgetState = this.getChannelBudgetState(opts.channel);
+            if (budgetState.overBudget) {
+                // Queue for digest instead of sending directly
+                this.digestQueue.push({
+                    from: opts.from,
+                    content: opts.content,
+                    category,
+                    channel: opts.channel,
+                    originalTimestamp: now,
+                    taskId: opts.taskId,
+                });
+                if (this.digestQueue.length >= this.config.maxDigestQueueSize) {
+                    this.flushDigestQueue().catch(() => { });
+                }
+                this.logSuppression(opts.channel, opts.from, 'over-budget-digested', category, opts.content);
+                this.recordMessage(opts.channel, opts.from, opts.content, category, true, true, 'over-budget');
+                if (this.config.canaryMode) {
+                    return { allowed: true, reason: 'canary-would-digest-over-budget' };
+                }
+                return { allowed: false, digested: true, reason: 'over-budget-queued-for-digest' };
+            }
+        }
+        // 4. Allow through
+        this.recordMessage(opts.channel, opts.from, opts.content, category, isControlPlane, false);
+        return { allowed: true };
+    }
+    // ── Message Recording ──────────────────────────────────────────────────
+    recordMessage(channel, from, content, category, isControlPlane, suppressed, suppressReason) {
+        const now = Date.now();
+        this.messageLog.push({
+            id: `nb-${now}-${Math.random().toString(36).substr(2, 6)}`,
+            channel,
+            from,
+            contentHash: this.hashContent(from, content, channel),
+            category,
+            isControlPlane,
+            timestamp: now,
+            suppressed,
+            suppressReason,
+        });
+        // Prune old entries outside window
+        const cutoff = now - this.config.windowMs;
+        this.messageLog = this.messageLog.filter(r => r.timestamp >= cutoff);
+        // Prune old dedup cache entries
+        for (const [hash, ts] of this.dedupCache) {
+            if (now - ts > this.config.dedupWindowMs) {
+                this.dedupCache.delete(hash);
+            }
+        }
+    }
+    /**
+     * Record a content message (non-routed, direct agent/human message).
+     * Called to track the denominator accurately.
+     */
+    recordContentMessage(channel, from) {
+        const now = Date.now();
+        this.messageLog.push({
+            id: `nb-content-${now}-${Math.random().toString(36).substr(2, 6)}`,
+            channel,
+            from,
+            contentHash: '',
+            category: 'content',
+            isControlPlane: false,
+            timestamp: now,
+            suppressed: false,
+        });
+        // Prune
+        const cutoff = now - this.config.windowMs;
+        this.messageLog = this.messageLog.filter(r => r.timestamp >= cutoff);
+    }
+    // ── Budget State ───────────────────────────────────────────────────────
+    getChannelBudgetState(channel) {
+        const now = Date.now();
+        const cutoff = now - this.config.windowMs;
+        const channelMessages = this.messageLog.filter(r => r.channel === channel && r.timestamp >= cutoff && !r.suppressed);
+        const controlPlane = channelMessages.filter(r => r.isControlPlane).length;
+        const content = channelMessages.filter(r => !r.isControlPlane).length;
+        const total = channelMessages.length;
+        const ratio = total > 0 ? controlPlane / total : 0;
+        const budgetLimit = this.config.channelBudgets[channel] ?? this.config.defaultBudget;
+        const suppressedInWindow = this.messageLog.filter(r => r.channel === channel && r.timestamp >= cutoff && r.suppressed);
+        const digestedInWindow = suppressedInWindow.filter(r => r.suppressReason === 'over-budget');
+        return {
+            channel,
+            totalMessages: total,
+            controlPlaneMessages: controlPlane,
+            contentMessages: content,
+            currentRatio: Math.round(ratio * 1000) / 1000,
+            budgetLimit,
+            overBudget: ratio >= budgetLimit && total >= 10, // Need min 10 messages before enforcing
+            suppressedCount: suppressedInWindow.length,
+            digestedCount: digestedInWindow.length,
+        };
+    }
+    // ── Digest Batching ────────────────────────────────────────────────────
+    startDigestTimer() {
+        if (this.digestTimer)
+            return;
+        this.digestTimer = setInterval(() => {
+            this.flushDigestQueue().catch(err => {
+                console.error('[NoiseBudget] Digest flush error:', err);
+            });
+        }, this.config.digestIntervalMs);
+    }
+    async flushDigestQueue() {
+        if (this.digestQueue.length === 0)
+            return [];
+        const entries = [...this.digestQueue];
+        this.digestQueue = [];
+        this.totalDigested += entries.length;
+        // Group by channel
+        const byChannel = new Map();
+        for (const entry of entries) {
+            const list = byChannel.get(entry.channel) || [];
+            list.push(entry);
+            byChannel.set(entry.channel, list);
+        }
+        // Call flush handler for each channel
+        if (this.onDigestFlush) {
+            for (const [channel, channelEntries] of byChannel) {
+                try {
+                    await this.onDigestFlush(channel, channelEntries);
+                }
+                catch (err) {
+                    console.error(`[NoiseBudget] Digest flush failed for ${channel}:`, err);
+                }
+            }
+        }
+        return entries;
+    }
+    /**
+     * Register a handler that sends digest messages.
+     * Called by server startup to wire digest → chat.
+     */
+    setDigestFlushHandler(handler) {
+        this.onDigestFlush = handler;
+    }
+    // ── Snapshot / Canary Metrics ──────────────────────────────────────────
+    getSnapshot() {
+        const channels = {};
+        const allChannels = new Set(this.messageLog.map(r => r.channel));
+        for (const channel of allChannels) {
+            channels[channel] = this.getChannelBudgetState(channel);
+        }
+        return {
+            timestamp: Date.now(),
+            windowMs: this.config.windowMs,
+            canaryMode: this.config.canaryMode,
+            channels,
+            totalSuppressed: this.suppressionLog.length,
+            totalDigested: this.totalDigested,
+            dedupHits: this.totalDedupHits,
+            digestQueueSize: this.digestQueue.length,
+        };
+    }
+    /**
+     * Get canary metrics for rollback evaluation.
+     * Returns signals for the three rollback triggers from spec.
+     */
+    getCanaryMetrics() {
+        const snapshot = this.getSnapshot();
+        // Critical reminder misses = messages suppressed with category containing 'escalation' or critical
+        // (These should never be suppressed due to bypass, but track anyway)
+        const criticalMisses = this.suppressionLog.filter(s => s.category === 'escalation' || s.category === 'critical').length;
+        return {
+            snapshot,
+            rollbackSignals: {
+                slaMissIncrease: null, // TODO: Wire to SLA tracker
+                p95ResponseIncrease: null, // TODO: Wire to response time tracker
+                criticalReminderMisses: criticalMisses,
+                rollbackTriggered: criticalMisses >= 3,
+            },
+        };
+    }
+    // ── Suppression Log ────────────────────────────────────────────────────
+    logSuppression(channel, from, reason, category, content) {
+        this.suppressionLog.push({
+            timestamp: Date.now(),
+            channel,
+            from,
+            reason,
+            category,
+            contentPreview: content.substring(0, 100),
+        });
+        // Keep last 500 entries
+        if (this.suppressionLog.length > 500) {
+            this.suppressionLog.splice(0, this.suppressionLog.length - 500);
+        }
+        console.log(`[NoiseBudget] Suppressed: channel=${channel} from=${from} reason=${reason} category=${category}`);
+    }
+    getSuppressionLog(options) {
+        let log = this.suppressionLog;
+        if (options?.since) {
+            log = log.filter(e => e.timestamp >= options.since);
+        }
+        log = log.slice().sort((a, b) => b.timestamp - a.timestamp);
+        if (options?.limit) {
+            log = log.slice(0, options.limit);
+        }
+        return log;
+    }
+    // ── Config ─────────────────────────────────────────────────────────────
+    getConfig() {
+        return { ...this.config };
+    }
+    updateConfig(updates) {
+        this.config = { ...this.config, ...updates };
+        if (this.config.enabled && !this.digestTimer) {
+            this.startDigestTimer();
+        }
+        if (!this.config.enabled && this.digestTimer) {
+            clearInterval(this.digestTimer);
+            this.digestTimer = null;
+        }
+        console.log('[NoiseBudget] Config updated:', JSON.stringify(updates));
+    }
+    /** Exit canary mode — start enforcing suppression */
+    activateEnforcement() {
+        this.config.canaryMode = false;
+        console.log('[NoiseBudget] Canary mode OFF — enforcement active');
+    }
+    // ── Helpers ────────────────────────────────────────────────────────────
+    hashContent(from, content, channel) {
+        // Normalize: trim, lowercase, remove timestamps/IDs that change
+        const normalized = `${from}:${channel}:${content.trim().toLowerCase().replace(/\b(msg-|task-|tcomment-)\S+/g, '').replace(/\d{13,}/g, '')}`;
+        return createHash('sha256').update(normalized).digest('hex').substring(0, 16);
+    }
+    /** Stop timers for clean shutdown */
+    stop() {
+        if (this.digestTimer) {
+            clearInterval(this.digestTimer);
+            this.digestTimer = null;
+        }
+    }
+}
+// ── Singleton ──────────────────────────────────────────────────────────────
+export const noiseBudgetManager = new NoiseBudgetManager();
+//# sourceMappingURL=noise-budget.js.map

package/dist/noise-budget.js.map

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

package/dist/notifications.d.ts

@@ -0,0 +1,67 @@
+export type DeliveryMethod = 'inbox' | 'mention' | 'both' | 'none';
+export type NotificationPriority = 'all' | 'P1' | 'P2' | 'P3' | 'P4';
+export interface NotificationPreferences {
+    agent: string;
+    enabled: boolean;
+    deliveryMethod: DeliveryMethod;
+    priorityThreshold: NotificationPriority;
+    quietHours: {
+        enabled: boolean;
+        startHour: number;
+        endHour: number;
+        timezone: string;
+    };
+    eventFilters: {
+        taskAssigned: boolean;
+        taskCompleted: boolean;
+        reviewRequested: boolean;
+        reviewApproved: boolean;
+        mentionInChat: boolean;
+        taskComment: boolean;
+        statusChange: boolean;
+        webhookFailure: boolean;
+    };
+    channelSubscriptions: string[];
+    mutedUntil: number | null;
+    updatedAt: number;
+}
+export interface NotificationEvent {
+    type: keyof NotificationPreferences['eventFilters'];
+    agent: string;
+    priority?: string;
+    channel?: string;
+    message: string;
+    metadata?: Record<string, unknown>;
+}
+export interface NotificationRouteResult {
+    shouldNotify: boolean;
+    reason: string;
+    deliveryMethod: DeliveryMethod;
+}
+export declare class NotificationManager {
+    private initialized;
+    init(): void;
+    /** Get preferences for an agent (returns defaults if none configured) */
+    getPreferences(agent: string): NotificationPreferences;
+    /** Get preferences for all agents */
+    getAllPreferences(): NotificationPreferences[];
+    /** Update preferences for an agent (partial update) */
+    updatePreferences(agent: string, patch: Partial<Omit<NotificationPreferences, 'agent' | 'updatedAt'>>): NotificationPreferences;
+    /** Delete preferences for an agent (resets to defaults) */
+    resetPreferences(agent: string): void;
+    /** Mute notifications for an agent until a given time */
+    mute(agent: string, untilMs: number): NotificationPreferences;
+    /** Unmute notifications for an agent */
+    unmute(agent: string): NotificationPreferences;
+    /**
+     * Route a notification event through an agent's preferences.
+     * Returns whether to notify and via which method.
+     */
+    shouldNotify(event: NotificationEvent): NotificationRouteResult;
+    private ensureInit;
+    private isQuietHours;
+    private meetsPriorityThreshold;
+    private rowToPrefs;
+}
+export declare function getNotificationManager(): NotificationManager;
+//# sourceMappingURL=notifications.d.ts.map

package/dist/notifications.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notifications.d.ts","sourceRoot":"","sources":["../src/notifications.ts"],"names":[],"mappings":"AAoBA,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,GAAG,MAAM,CAAA;AAClE,MAAM,MAAM,oBAAoB,GAAG,KAAK,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAA;AAEpE,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,OAAO,CAAA;IAChB,cAAc,EAAE,cAAc,CAAA;IAC9B,iBAAiB,EAAE,oBAAoB,CAAA;IACvC,UAAU,EAAE;QACV,OAAO,EAAE,OAAO,CAAA;QAChB,SAAS,EAAE,MAAM,CAAA;QACjB,OAAO,EAAE,MAAM,CAAA;QACf,QAAQ,EAAE,MAAM,CAAA;KACjB,CAAA;IACD,YAAY,EAAE;QACZ,YAAY,EAAE,OAAO,CAAA;QACrB,aAAa,EAAE,OAAO,CAAA;QACtB,eAAe,EAAE,OAAO,CAAA;QACxB,cAAc,EAAE,OAAO,CAAA;QACvB,aAAa,EAAE,OAAO,CAAA;QACtB,WAAW,EAAE,OAAO,CAAA;QACpB,YAAY,EAAE,OAAO,CAAA;QACrB,cAAc,EAAE,OAAO,CAAA;KACxB,CAAA;IACD,oBAAoB,EAAE,MAAM,EAAE,CAAA;IAC9B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,uBAAuB,CAAC,cAAc,CAAC,CAAA;IACnD,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACnC;AAED,MAAM,WAAW,uBAAuB;IACtC,YAAY,EAAE,OAAO,CAAA;IACrB,MAAM,EAAE,MAAM,CAAA;IACd,cAAc,EAAE,cAAc,CAAA;CAC/B;AAiDD,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,WAAW,CAAQ;IAE3B,IAAI,IAAI,IAAI;IAOZ,yEAAyE;IACzE,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,uBAAuB;IActD,qCAAqC;IACrC,iBAAiB,IAAI,uBAAuB,EAAE;IAU9C,uDAAuD;IACvD,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,uBAAuB,EAAE,OAAO,GAAG,WAAW,CAAC,CAAC,GAAG,uBAAuB;IA0D/H,2DAA2D;IAC3D,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAMrC,yDAAyD;IACzD,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,uBAAuB;IAI7D,wCAAwC;IACxC,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,uBAAuB;IAI9C;;;OAGG;IACH,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,uBAAuB;IA4C/D,OAAO,CAAC,UAAU;IAIlB,OAAO,CAAC,YAAY;IAuBpB,OAAO,CAAC,sBAAsB;IAW9B,OAAO,CAAC,UAAU;CA4BnB;AAuBD,wBAAgB,sBAAsB,IAAI,mBAAmB,CAK5D"}