@diskd-ai/email-mcp 0.3.0

package/dist/services/notifier.service.js

@@ -0,0 +1,319 @@
+/**
+ * NotifierService — multi-channel notification dispatcher.
+ *
+ * Routes email alerts to the appropriate channels based on urgency:
+ * - Desktop notifications (native OS commands — zero npm deps)
+ * - Sound alerts (via OS notification sound)
+ * - MCP log level escalation (urgent→alert, high→warning, …)
+ * - Webhook dispatch (HTTP POST to Slack/Discord/ntfy.sh/etc.)
+ *
+ * All channels are opt-in and disabled by default.
+ */
+import { execFile } from 'node:child_process';
+import { mcpLog } from '../logging.js';
+import { validateWebhookUrl } from '../safety/validation.js';
+// ---------------------------------------------------------------------------
+// Priority ordering for threshold comparison
+// ---------------------------------------------------------------------------
+const URGENCY_ORDER = {
+    urgent: 4,
+    high: 3,
+    normal: 2,
+    low: 1,
+};
+const MCP_LOG_LEVEL_MAP = {
+    urgent: 'alert',
+    high: 'warning',
+    normal: 'info',
+    low: 'debug',
+};
+// ---------------------------------------------------------------------------
+// Text sanitization — prevent command injection in OS notifications
+// ---------------------------------------------------------------------------
+function sanitizeForShell(text) {
+    return text
+        .replace(/[\\"'`$]/g, '')
+        .replace(/[\n\r\t]/g, ' ')
+        .replace(/[^\x20-\x7E\u00A0-\uFFFF]/g, '')
+        .slice(0, 200);
+}
+// ---------------------------------------------------------------------------
+// NotifierService
+// ---------------------------------------------------------------------------
+export default class NotifierService {
+    config;
+    desktopCount = 0;
+    desktopResetTimer = null;
+    static MAX_DESKTOP_PER_MIN = 5;
+    constructor(config) {
+        this.config = config;
+        // Reset desktop rate counter every 60s
+        this.desktopResetTimer = setInterval(() => {
+            this.desktopCount = 0;
+        }, 60_000);
+    }
+    stop() {
+        if (this.desktopResetTimer) {
+            clearInterval(this.desktopResetTimer);
+            this.desktopResetTimer = null;
+        }
+    }
+    /** Returns the current alerts configuration. */
+    getConfig() {
+        return { ...this.config };
+    }
+    /** Updates alert configuration at runtime (partial merge). */
+    updateConfig(partial) {
+        this.config = { ...this.config, ...partial };
+        return this.getConfig();
+    }
+    // -------------------------------------------------------------------------
+    // Platform diagnostics — check if notification tools are available
+    // -------------------------------------------------------------------------
+    static async checkPlatformSupport() {
+        const { platform } = process;
+        const issues = [];
+        const instructions = [];
+        if (platform === 'darwin') {
+            const osascriptOk = await NotifierService.commandExists('osascript');
+            const afplayOk = await NotifierService.commandExists('afplay');
+            if (!osascriptOk)
+                issues.push('osascript not found (should be built-in on macOS)');
+            instructions.push('1. Open System Settings → Notifications & Focus', '2. Find your terminal app (Terminal, iTerm2, VS Code, Cursor, etc.)', '3. Enable "Allow Notifications" and choose "Banners" or "Alerts"', '4. Ensure "Do Not Disturb" / Focus mode is not active', '5. If using an MCP client, the notification appears from the terminal running the server');
+            return {
+                platform: 'macOS',
+                supported: osascriptOk,
+                desktopTool: { name: 'osascript', available: osascriptOk },
+                soundTool: { name: 'afplay', available: afplayOk },
+                issues,
+                setupInstructions: instructions,
+            };
+        }
+        if (platform === 'linux') {
+            const notifySendOk = await NotifierService.commandExists('notify-send');
+            const paplayOk = await NotifierService.commandExists('paplay');
+            if (!notifySendOk) {
+                issues.push('notify-send not found');
+                instructions.push('Install libnotify:', '  Ubuntu/Debian: sudo apt install libnotify-bin', '  Fedora:        sudo dnf install libnotify', '  Arch:          sudo pacman -S libnotify');
+            }
+            if (!paplayOk) {
+                issues.push('paplay not found (needed for sound alerts)');
+                instructions.push('Install PulseAudio utils for sound:', '  Ubuntu/Debian: sudo apt install pulseaudio-utils', '  Fedora:        sudo dnf install pulseaudio-utils');
+            }
+            instructions.push('Note: Desktop notifications require a running display server (X11/Wayland).', 'They will not work in headless/SSH sessions.');
+            return {
+                platform: 'Linux',
+                supported: notifySendOk,
+                desktopTool: { name: 'notify-send', available: notifySendOk },
+                soundTool: { name: 'paplay', available: paplayOk },
+                issues,
+                setupInstructions: instructions,
+            };
+        }
+        if (platform === 'win32') {
+            const psOk = await NotifierService.commandExists('powershell');
+            if (!psOk)
+                issues.push('PowerShell not found');
+            instructions.push('1. Open Settings → System → Notifications', '2. Ensure "Notifications" is turned on', '3. Ensure "Focus Assist" is set to allow notifications', '4. If using Windows Terminal, ensure its notifications are enabled');
+            return {
+                platform: 'Windows',
+                supported: psOk,
+                desktopTool: { name: 'powershell', available: psOk },
+                soundTool: { name: 'powershell', available: psOk },
+                issues,
+                setupInstructions: instructions,
+            };
+        }
+        return {
+            platform,
+            supported: false,
+            desktopTool: { name: 'unknown', available: false },
+            soundTool: { name: 'unknown', available: false },
+            issues: [`Unsupported platform: ${platform}. Desktop notifications are not available.`],
+            setupInstructions: ['Desktop notifications are only supported on macOS, Linux, and Windows.'],
+        };
+    }
+    /** Test if a command-line tool exists on the system. */
+    static async commandExists(cmd) {
+        const bin = process.platform === 'win32' ? 'where' : 'which';
+        return new Promise((resolve) => {
+            execFile(bin, [cmd], { timeout: 3000 }, (err) => {
+                resolve(!err);
+            });
+        });
+    }
+    /** Send a test notification to verify platform setup. */
+    async sendTestNotification(withSound = false) {
+        const diag = await NotifierService.checkPlatformSupport();
+        if (!diag.supported) {
+            return {
+                success: false,
+                message: `Desktop notifications not supported: ${diag.issues.join('; ')}`,
+            };
+        }
+        // Temporarily force desktop + sound for the test
+        const origDesktop = this.config.desktop;
+        const origSound = this.config.sound;
+        this.config.desktop = true;
+        this.config.sound = withSound;
+        try {
+            const testPayload = {
+                account: 'test',
+                sender: { name: 'Email MCP', address: 'test@email-mcp' },
+                subject: 'If you see this, notifications work!',
+                priority: 'urgent',
+            };
+            await this.sendDesktopNotification(testPayload);
+            return {
+                success: true,
+                message: withSound
+                    ? 'Test notification sent with sound. Check your notification center.'
+                    : 'Test notification sent. Check your notification center.',
+            };
+        }
+        catch (err) {
+            const errMsg = err instanceof Error ? err.message : String(err);
+            return {
+                success: false,
+                message: `Notification failed: ${errMsg}. Check platform setup instructions.`,
+            };
+        }
+        finally {
+            this.config.desktop = origDesktop;
+            this.config.sound = origSound;
+        }
+    }
+    // -------------------------------------------------------------------------
+    // Main dispatch — routes alert to channels based on urgency + config
+    // -------------------------------------------------------------------------
+    async alert(payload, forceDesktop = false) {
+        const meetsThreshold = URGENCY_ORDER[payload.priority] >= URGENCY_ORDER[this.config.urgencyThreshold];
+        // 1. MCP log — always, with appropriate level
+        const logLevel = MCP_LOG_LEVEL_MAP[payload.priority];
+        const icon = payload.priority === 'urgent' ? '🚨' : '📧';
+        const logMsg = `${icon} [${payload.priority.toUpperCase()}] ${payload.sender.name ?? payload.sender.address}: "${payload.subject}"${payload.labels?.length ? ` [${payload.labels.join(', ')}]` : ''}${payload.ruleName ? ` (rule: ${payload.ruleName})` : ''}`;
+        await mcpLog(logLevel, 'notifier', logMsg);
+        // 2. Desktop notification — if enabled + meets threshold (or forced by rule)
+        if (this.config.desktop && (meetsThreshold || forceDesktop)) {
+            await this.sendDesktopNotification(payload);
+        }
+        // 3. Webhook — if configured + meets webhook event filter
+        if (this.config.webhookUrl && this.config.webhookEvents.includes(payload.priority)) {
+            this.sendWebhook(payload).catch(() => { });
+        }
+    }
+    // -------------------------------------------------------------------------
+    // Desktop notification — native OS commands, zero npm deps
+    // -------------------------------------------------------------------------
+    async sendDesktopNotification(payload) {
+        if (this.desktopCount >= NotifierService.MAX_DESKTOP_PER_MIN)
+            return;
+        this.desktopCount += 1;
+        const title = sanitizeForShell(`📧 Email MCP — ${payload.priority === 'urgent' ? 'Urgent' : 'Important'}`);
+        const senderDisplay = sanitizeForShell(payload.sender.name ?? payload.sender.address);
+        const subject = sanitizeForShell(payload.subject);
+        const body = `From: ${senderDisplay}\n${subject}`;
+        const playSound = this.config.sound && payload.priority === 'urgent';
+        const { platform } = process;
+        try {
+            if (platform === 'darwin') {
+                await NotifierService.execDarwin(title, body, playSound);
+            }
+            else if (platform === 'linux') {
+                await NotifierService.execLinux(title, body, playSound);
+            }
+            else if (platform === 'win32') {
+                await NotifierService.execWindows(title, body);
+            }
+        }
+        catch {
+            // Desktop notification failure is non-fatal — silently degrade to MCP log only
+        }
+    }
+    static async execDarwin(title, body, sound) {
+        const soundClause = sound ? ' sound name "Glass"' : '';
+        const script = `display notification "${body}" with title "${title}"${soundClause}`;
+        await NotifierService.execCommand('osascript', ['-e', script]);
+    }
+    static async execLinux(title, body, sound) {
+        const urgency = sound ? 'critical' : 'normal';
+        await NotifierService.execCommand('notify-send', ['-u', urgency, title, body]);
+        if (sound) {
+            try {
+                await NotifierService.execCommand('paplay', [
+                    '/usr/share/sounds/freedesktop/stereo/message-new-instant.oga',
+                ]);
+            }
+            catch {
+                // Sound playback failure is non-fatal
+            }
+        }
+    }
+    static async execWindows(title, body) {
+        const ps = `[System.Reflection.Assembly]::LoadWithPartialName('System.Windows.Forms'); ` +
+            `$n = New-Object System.Windows.Forms.NotifyIcon; ` +
+            `$n.Icon = [System.Drawing.SystemIcons]::Information; ` +
+            `$n.Visible = $true; ` +
+            `$n.ShowBalloonTip(5000, '${title}', '${body}', 'Info')`;
+        await NotifierService.execCommand('powershell', ['-Command', ps]);
+    }
+    static async execCommand(bin, args) {
+        return new Promise((resolve, reject) => {
+            execFile(bin, args, { timeout: 5000 }, (err) => {
+                if (err)
+                    reject(err);
+                else
+                    resolve();
+            });
+        });
+    }
+    // -------------------------------------------------------------------------
+    // Webhook dispatch — HTTP POST with JSON payload
+    // -------------------------------------------------------------------------
+    async sendWebhook(payload) {
+        if (!this.config.webhookUrl)
+            return;
+        try {
+            validateWebhookUrl(this.config.webhookUrl);
+        }
+        catch (err) {
+            await mcpLog('warning', 'notifier', `Invalid webhook URL: ${err instanceof Error ? err.message : String(err)}`);
+            return;
+        }
+        const body = JSON.stringify({
+            event: `email.${payload.priority}`,
+            account: payload.account,
+            uid: payload.uid ?? null,
+            folder: payload.folder ?? null,
+            sender: payload.sender,
+            subject: payload.subject,
+            hasAttachments: payload.hasAttachments ?? false,
+            priority: payload.priority,
+            labels: payload.labels ?? [],
+            rule: payload.ruleName ?? null,
+            timestamp: new Date().toISOString(),
+        });
+        const controller = new AbortController();
+        const timeout = setTimeout(() => {
+            controller.abort();
+        }, 5000);
+        try {
+            const resp = await fetch(this.config.webhookUrl, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body,
+                signal: controller.signal,
+            });
+            if (!resp.ok) {
+                await mcpLog('warning', 'notifier', `Webhook returned ${resp.status}`);
+            }
+        }
+        catch {
+            await mcpLog('debug', 'notifier', 'Webhook dispatch failed (non-fatal)');
+        }
+        finally {
+            clearTimeout(timeout);
+        }
+    }
+}
+//# sourceMappingURL=notifier.service.js.map

package/dist/services/notifier.service.js.map

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

package/dist/services/oauth.service.d.ts

@@ -0,0 +1,47 @@
+/**
+ * OAuth2 token management service.
+ *
+ * Handles token refresh and caching for Google and Microsoft OAuth2/XOAUTH2.
+ * Uses native fetch (Node 22+) — no external HTTP dependencies.
+ */
+import type { OAuth2Config } from '../types/index.js';
+interface ProviderEndpoints {
+    tokenUrl: string;
+    authUrl: string;
+    scopes: string[];
+}
+export default class OAuthService {
+    /**
+     * Get a valid access token, refreshing if expired.
+     */
+    getAccessToken(oauth2: OAuth2Config): Promise<string>;
+    /**
+     * Check if the cached access token is expired or missing.
+     */
+    static isTokenExpired(oauth2: OAuth2Config): boolean;
+    /**
+     * Exchange refresh token for a new access token.
+     */
+    static refreshAccessToken(oauth2: OAuth2Config): Promise<{
+        accessToken: string;
+        expiresIn: number;
+    }>;
+    /**
+     * Get provider endpoints for token exchange and authorization.
+     */
+    static getProviderEndpoints(oauth2: OAuth2Config): ProviderEndpoints;
+    /**
+     * Generate an OAuth2 authorization URL for the CLI setup wizard.
+     */
+    static generateAuthUrl(oauth2: OAuth2Config, redirectUri: string): string;
+    /**
+     * Exchange an authorization code for tokens (initial setup).
+     */
+    static exchangeCode(oauth2: OAuth2Config, code: string, redirectUri: string): Promise<{
+        accessToken: string;
+        refreshToken: string;
+        expiresIn: number;
+    }>;
+}
+export {};
+//# sourceMappingURL=oauth.service.d.ts.map

package/dist/services/oauth.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"oauth.service.d.ts","sourceRoot":"","sources":["../../src/services/oauth.service.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAMtD,UAAU,iBAAiB;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAsBD,MAAM,CAAC,OAAO,OAAO,YAAY;IAC/B;;OAEG;IAEG,cAAc,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC;IAgB3D;;OAEG;IACH,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO;IAKpD;;OAEG;WACU,kBAAkB,CAC7B,MAAM,EAAE,YAAY,GACnB,OAAO,CAAC;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IAgCtD;;OAEG;IACH,MAAM,CAAC,oBAAoB,CAAC,MAAM,EAAE,YAAY,GAAG,iBAAiB;IAmBpE;;OAEG;IACH,MAAM,CAAC,eAAe,CAAC,MAAM,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM;IAazE;;OAEG;WACU,YAAY,CACvB,MAAM,EAAE,YAAY,EACpB,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;CAkC7E"}

package/dist/services/oauth.service.js

@@ -0,0 +1,140 @@
+/**
+ * OAuth2 token management service.
+ *
+ * Handles token refresh and caching for Google and Microsoft OAuth2/XOAUTH2.
+ * Uses native fetch (Node 22+) — no external HTTP dependencies.
+ */
+const PROVIDER_ENDPOINTS = {
+    google: {
+        tokenUrl: 'https://oauth2.googleapis.com/token',
+        authUrl: 'https://accounts.google.com/o/oauth2/v2/auth',
+        scopes: ['https://mail.google.com/'],
+    },
+    microsoft: {
+        tokenUrl: 'https://login.microsoftonline.com/common/oauth2/v2.0/token',
+        authUrl: 'https://login.microsoftonline.com/common/oauth2/v2.0/authorize',
+        scopes: [
+            'https://outlook.office.com/IMAP.AccessAsUser.All',
+            'https://outlook.office.com/SMTP.Send',
+            'offline_access',
+        ],
+    },
+};
+/** 5-minute safety buffer before token expiry */
+const TOKEN_EXPIRY_BUFFER_MS = 5 * 60 * 1000;
+export default class OAuthService {
+    /**
+     * Get a valid access token, refreshing if expired.
+     */
+    // eslint-disable-next-line class-methods-use-this
+    async getAccessToken(oauth2) {
+        if (!OAuthService.isTokenExpired(oauth2) && oauth2.accessToken) {
+            return oauth2.accessToken;
+        }
+        const result = await OAuthService.refreshAccessToken(oauth2);
+        // Cache on the config object (in-memory only)
+        Object.assign(oauth2, {
+            accessToken: result.accessToken,
+            tokenExpiry: Date.now() + result.expiresIn * 1000,
+        });
+        return result.accessToken;
+    }
+    /**
+     * Check if the cached access token is expired or missing.
+     */
+    static isTokenExpired(oauth2) {
+        if (!oauth2.accessToken || !oauth2.tokenExpiry)
+            return true;
+        return Date.now() >= oauth2.tokenExpiry - TOKEN_EXPIRY_BUFFER_MS;
+    }
+    /**
+     * Exchange refresh token for a new access token.
+     */
+    static async refreshAccessToken(oauth2) {
+        const endpoints = OAuthService.getProviderEndpoints(oauth2);
+        const body = new URLSearchParams({
+            grant_type: 'refresh_token',
+            client_id: oauth2.clientId,
+            client_secret: oauth2.clientSecret,
+            refresh_token: oauth2.refreshToken,
+        });
+        const response = await fetch(endpoints.tokenUrl, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
+            body: body.toString(),
+        });
+        if (!response.ok) {
+            const text = await response.text();
+            throw new Error(`OAuth2 token refresh failed (${response.status}): ${text}`);
+        }
+        const data = (await response.json());
+        return {
+            accessToken: data.access_token,
+            expiresIn: data.expires_in,
+        };
+    }
+    /**
+     * Get provider endpoints for token exchange and authorization.
+     */
+    static getProviderEndpoints(oauth2) {
+        if (oauth2.provider === 'custom') {
+            if (!oauth2.tokenUrl || !oauth2.authUrl) {
+                throw new Error('Custom OAuth2 provider requires tokenUrl and authUrl');
+            }
+            return {
+                tokenUrl: oauth2.tokenUrl,
+                authUrl: oauth2.authUrl,
+                scopes: oauth2.scopes ?? [],
+            };
+        }
+        const endpoints = PROVIDER_ENDPOINTS[oauth2.provider];
+        if (!endpoints) {
+            throw new Error(`Unknown OAuth2 provider: ${oauth2.provider}`);
+        }
+        return endpoints;
+    }
+    /**
+     * Generate an OAuth2 authorization URL for the CLI setup wizard.
+     */
+    static generateAuthUrl(oauth2, redirectUri) {
+        const endpoints = OAuthService.getProviderEndpoints(oauth2);
+        const params = new URLSearchParams({
+            client_id: oauth2.clientId,
+            redirect_uri: redirectUri,
+            response_type: 'code',
+            scope: endpoints.scopes.join(' '),
+            access_type: 'offline',
+            prompt: 'consent',
+        });
+        return `${endpoints.authUrl}?${params.toString()}`;
+    }
+    /**
+     * Exchange an authorization code for tokens (initial setup).
+     */
+    static async exchangeCode(oauth2, code, redirectUri) {
+        const endpoints = OAuthService.getProviderEndpoints(oauth2);
+        const body = new URLSearchParams({
+            grant_type: 'authorization_code',
+            client_id: oauth2.clientId,
+            client_secret: oauth2.clientSecret,
+            code,
+            redirect_uri: redirectUri,
+        });
+        const response = await fetch(endpoints.tokenUrl, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
+            body: body.toString(),
+        });
+        if (!response.ok) {
+            const text = await response.text();
+            throw new Error(`OAuth2 code exchange failed (${response.status}): ${text}`);
+        }
+        const data = (await response.json());
+        return {
+            accessToken: data.access_token,
+            refreshToken: data.refresh_token,
+            expiresIn: data.expires_in,
+        };
+    }
+}
+//# sourceMappingURL=oauth.service.js.map

package/dist/services/oauth.service.js.map

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

package/dist/services/presets.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Built-in hook presets — ready-to-use AI triage profiles.
+ *
+ * Each preset provides a system prompt template, suggested labels,
+ * and a description. Users select a preset in config.toml and can
+ * append their own `custom_instructions` for personalisation.
+ */
+export interface HookPreset {
+    /** Unique identifier used in config (e.g. "inbox-zero"). */
+    id: string;
+    /** Human-readable name. */
+    name: string;
+    /** Short description shown in `list_presets`. */
+    description: string;
+    /** System prompt template.  `{{LABELS}}` and `{{CUSTOM}}` are replaced at runtime. */
+    systemPrompt: string;
+    /** Labels the AI is encouraged to use when triaging. */
+    suggestedLabels: string[];
+}
+export declare const DEFAULT_PRESET_ID = "priority-focus";
+/** Get a preset by id. Returns undefined for unknown ids. */
+export declare function getPreset(id: string): HookPreset | undefined;
+/** List all available presets. */
+export declare function listPresets(): HookPreset[];
+/**
+ * Build the final system prompt for AI triage by combining:
+ * 1. The preset's system prompt template
+ * 2. The preset's suggested labels
+ * 3. The user's custom instructions (if any)
+ * 4. OR the user's full system_prompt override (if preset = "custom")
+ */
+export declare function buildSystemPrompt(presetId: string, options?: {
+    customInstructions?: string;
+    systemPrompt?: string;
+}): string;
+//# sourceMappingURL=presets.d.ts.map

package/dist/services/presets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"presets.d.ts","sourceRoot":"","sources":["../../src/services/presets.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,MAAM,WAAW,UAAU;IACzB,4DAA4D;IAC5D,EAAE,EAAE,MAAM,CAAC;IACX,2BAA2B;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,iDAAiD;IACjD,WAAW,EAAE,MAAM,CAAC;IACpB,sFAAsF;IACtF,YAAY,EAAE,MAAM,CAAC;IACrB,wDAAwD;IACxD,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAyID,eAAO,MAAM,iBAAiB,mBAAmB,CAAC;AAElD,6DAA6D;AAC7D,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAE5D;AAED,kCAAkC;AAClC,wBAAgB,WAAW,IAAI,UAAU,EAAE,CAE1C;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE;IAAE,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAO,GACnE,MAAM,CAiCR"}