@diskd-ai/email-mcp 0.3.0

package/dist/safety/validation.js

@@ -0,0 +1,113 @@
+/** Input validation and sanitization utilities. */
+/**
+ * Validate and sanitize an IMAP mailbox name.
+ * Rejects names containing IMAP wildcard characters (`*`, `%`) or empty strings.
+ * @param name - The mailbox name to validate.
+ * @returns The trimmed mailbox name.
+ */
+export function sanitizeMailboxName(name) {
+    const trimmed = name.trim();
+    if (trimmed.length === 0) {
+        throw new Error('Mailbox name must not be empty');
+    }
+    if (trimmed.includes('*') || trimmed.includes('%')) {
+        throw new Error('Mailbox name must not contain IMAP wildcard characters (* or %)');
+    }
+    return trimmed;
+}
+/**
+ * Strip control characters from an IMAP search query.
+ * Removes ASCII 0-31 except tab (0x09) and newline (0x0A).
+ * @param query - The raw search query.
+ * @returns The sanitized query string.
+ */
+export function sanitizeSearchQuery(query) {
+    // biome-ignore lint/suspicious/noControlCharactersInRegex: intentional — sanitize control chars from user input
+    const cleaned = query.replace(/[\x00-\x08\x0B-\x1F]/g, '').trim(); // eslint-disable-line no-control-regex
+    if (cleaned.length === 0) {
+        throw new Error('Search query must not be empty after sanitization');
+    }
+    return cleaned;
+}
+/**
+ * Validate a webhook URL.
+ * Ensures the URL uses http(s) and does not point to a private or loopback address.
+ * @param url - The webhook URL to validate.
+ */
+export function validateWebhookUrl(url) {
+    let parsed;
+    try {
+        parsed = new URL(url);
+    }
+    catch {
+        throw new Error(`Invalid webhook URL: ${url}`);
+    }
+    if (parsed.protocol !== 'https:' && parsed.protocol !== 'http:') {
+        throw new Error(`Webhook URL must use http or https protocol, got ${parsed.protocol}`);
+    }
+    const hostname = parsed.hostname.toLowerCase();
+    // new URL('https://[::1]') stores hostname as '[::1]'
+    const bare = hostname.replace(/^\[|\]$/g, '');
+    if (bare === 'localhost' || bare === '::1' || bare === '0.0.0.0') {
+        throw new Error(`Webhook URL must not point to a loopback or private address: ${bare}`);
+    }
+    const ipv4Match = /^(\d{1,3})\.(\d{1,3})\.(\d{1,3})\.(\d{1,3})$/.exec(bare);
+    if (ipv4Match) {
+        const [, a, b] = ipv4Match.map(Number);
+        if (a === 127 || a === 10 || (a === 172 && b >= 16 && b <= 31) || (a === 192 && b === 168)) {
+            throw new Error(`Webhook URL must not point to a loopback or private address: ${bare}`);
+        }
+    }
+}
+/**
+ * Sanitize a value for use in a template.
+ * When `html` is true, HTML-special characters are escaped.
+ * @param value - The template variable value.
+ * @param html - Whether to apply HTML escaping.
+ * @returns The sanitized value.
+ */
+export function sanitizeTemplateVariable(value, html) {
+    if (!html) {
+        return value;
+    }
+    return value
+        .replace(/&/g, '&amp;')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;')
+        .replace(/'/g, '&#39;');
+}
+/**
+ * Validate an email label name.
+ * Rejects labels with control characters or that exceed 200 characters.
+ * @param name - The label name to validate.
+ * @returns The trimmed label name.
+ */
+export function validateLabelName(name) {
+    const trimmed = name.trim();
+    if (trimmed.length === 0) {
+        throw new Error('Label name must not be empty');
+    }
+    if (trimmed.length > 200) {
+        throw new Error('Label name must not exceed 200 characters');
+    }
+    /* eslint-disable no-control-regex */
+    // biome-ignore lint/suspicious/noControlCharactersInRegex: intentional — reject control chars in label names
+    if (/[\x00-\x1F]/.test(trimmed)) {
+        throw new Error('Label name must not contain control characters');
+    }
+    /* eslint-enable no-control-regex */
+    return trimmed;
+}
+/**
+ * Validate that an input string does not exceed a maximum length.
+ * @param input - The input string to check.
+ * @param maxLength - The maximum allowed length.
+ * @param fieldName - The field name for the error message.
+ */
+export function validateInputLength(input, maxLength, fieldName) {
+    if (input.length > maxLength) {
+        throw new Error(`${fieldName} exceeds maximum length of ${maxLength} characters`);
+    }
+}
+//# sourceMappingURL=validation.js.map

package/dist/safety/validation.js.map

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

package/dist/server.d.ts

@@ -0,0 +1,10 @@
+/**
+ * MCP Server factory.
+ *
+ * Creates and configures the McpServer instance with capabilities.
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare const PKG_NAME = "email-mcp";
+export declare const PKG_VERSION: string;
+export default function createServer(): McpServer;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAKpE,eAAO,MAAM,QAAQ,cAAc,CAAC;AACpC,eAAO,MAAM,WAAW,QAAc,CAAC;AAEvC,MAAM,CAAC,OAAO,UAAU,YAAY,IAAI,SAAS,CAehD"}

package/dist/server.js

@@ -0,0 +1,25 @@
+/**
+ * MCP Server factory.
+ *
+ * Creates and configures the McpServer instance with capabilities.
+ */
+import { createRequire } from 'node:module';
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+const esmRequire = createRequire(import.meta.url);
+const pkg = esmRequire('../package.json');
+export const PKG_NAME = 'email-mcp';
+export const PKG_VERSION = pkg.version;
+export default function createServer() {
+    return new McpServer({
+        name: PKG_NAME,
+        version: PKG_VERSION,
+    }, {
+        capabilities: {
+            tools: { listChanged: true },
+            prompts: { listChanged: true },
+            resources: { subscribe: true, listChanged: true },
+            logging: {},
+        },
+    });
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,GAAG,GAAG,UAAU,CAAC,iBAAiB,CAAwB,CAAC;AAEjE,MAAM,CAAC,MAAM,QAAQ,GAAG,WAAW,CAAC;AACpC,MAAM,CAAC,MAAM,WAAW,GAAG,GAAG,CAAC,OAAO,CAAC;AAEvC,MAAM,CAAC,OAAO,UAAU,YAAY;IAClC,OAAO,IAAI,SAAS,CAClB;QACE,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,WAAW;KACrB,EACD;QACE,YAAY,EAAE;YACZ,KAAK,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE;YAC5B,OAAO,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE;YAC9B,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE;YACjD,OAAO,EAAE,EAAE;SACZ;KACF,CACF,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,22 @@
+/**
+ * Calendar service — ICS/iCalendar parsing.
+ *
+ * Extracts structured calendar events from ICS content using node-ical.
+ */
+import type { CalendarEvent } from '../types/index.js';
+export default class CalendarService {
+    /**
+     * Parse ICS text content into structured CalendarEvent objects.
+     */
+    static parseIcs(content: string): CalendarEvent[];
+    /**
+     * Extract calendar events from raw email body parts.
+     * Accepts an array of ICS content strings (from inline text/calendar parts
+     * or downloaded .ics attachments).
+     */
+    extractFromParts(icsContents: string[]): CalendarEvent[];
+    private static parseOrganizer;
+    private static parseAttendees;
+    private static normalizeStatus;
+}
+//# sourceMappingURL=calendar.service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"calendar.service.d.ts","sourceRoot":"","sources":["../../src/services/calendar.service.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,aAAa,EAAgB,MAAM,mBAAmB,CAAC;AAIrE,MAAM,CAAC,OAAO,OAAO,eAAe;IAClC;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,EAAE;IA2CjD;;;;OAIG;IAEH,gBAAgB,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,aAAa,EAAE;IAsBxD,OAAO,CAAC,MAAM,CAAC,cAAc;IAiB7B,OAAO,CAAC,MAAM,CAAC,cAAc;IAoB7B,OAAO,CAAC,MAAM,CAAC,eAAe;CAQ/B"}

package/dist/services/calendar.service.js

@@ -0,0 +1,115 @@
+/**
+ * Calendar service — ICS/iCalendar parsing.
+ *
+ * Extracts structured calendar events from ICS content using node-ical.
+ */
+import ical from 'node-ical';
+export default class CalendarService {
+    /**
+     * Parse ICS text content into structured CalendarEvent objects.
+     */
+    static parseIcs(content) {
+        const parsed = ical.sync.parseICS(content);
+        const events = [];
+        // Extract the VCALENDAR METHOD if present
+        let calendarMethod;
+        Object.values(parsed).forEach((comp) => {
+            if (comp?.type === 'VCALENDAR') {
+                calendarMethod = comp.method;
+            }
+        });
+        Object.values(parsed).forEach((comp) => {
+            if (!comp || comp.type !== 'VEVENT')
+                return;
+            const event = comp;
+            const start = event.start;
+            const end = event.end;
+            const organizer = CalendarService.parseOrganizer(event.organizer);
+            const attendees = CalendarService.parseAttendees(event.attendee);
+            const rrule = event.rrule;
+            events.push({
+                uid: event.uid ?? '',
+                summary: event.summary ?? '(No title)',
+                description: event.description,
+                start: start ? start.toISOString() : '',
+                end: end ? end.toISOString() : '',
+                location: event.location,
+                organizer,
+                attendees,
+                status: CalendarService.normalizeStatus(event.status),
+                method: calendarMethod,
+                recurrence: rrule?.toString(),
+            });
+        });
+        // Sort by start time
+        events.sort((a, b) => a.start.localeCompare(b.start));
+        return events;
+    }
+    /**
+     * Extract calendar events from raw email body parts.
+     * Accepts an array of ICS content strings (from inline text/calendar parts
+     * or downloaded .ics attachments).
+     */
+    // eslint-disable-next-line class-methods-use-this
+    extractFromParts(icsContents) {
+        const allEvents = [];
+        const seenUids = new Set();
+        icsContents.forEach((content) => {
+            const events = CalendarService.parseIcs(content);
+            events.forEach((event) => {
+                if (!seenUids.has(event.uid)) {
+                    seenUids.add(event.uid);
+                    allEvents.push(event);
+                }
+            });
+        });
+        allEvents.sort((a, b) => a.start.localeCompare(b.start));
+        return allEvents;
+    }
+    // ---------------------------------------------------------------------------
+    // Private helpers
+    // ---------------------------------------------------------------------------
+    static parseOrganizer(organizer) {
+        if (!organizer)
+            return undefined;
+        if (typeof organizer === 'string') {
+            const email = organizer.replace(/^mailto:/i, '');
+            return { address: email };
+        }
+        const org = organizer;
+        const val = org.val ?? '';
+        const email = val.replace(/^mailto:/i, '');
+        return {
+            name: org.params?.CN,
+            address: email,
+        };
+    }
+    static parseAttendees(attendees) {
+        if (!attendees)
+            return [];
+        const list = Array.isArray(attendees) ? attendees : [attendees];
+        return list
+            .map((att) => {
+            if (typeof att === 'string') {
+                return { address: att.replace(/^mailto:/i, '') };
+            }
+            const a = att;
+            const val = a.val ?? '';
+            const email = val.replace(/^mailto:/i, '');
+            return {
+                name: a.params?.CN,
+                address: email,
+            };
+        })
+            .filter((a) => a.address);
+    }
+    static normalizeStatus(status) {
+        const upper = (status ?? 'CONFIRMED').toUpperCase();
+        if (upper === 'TENTATIVE')
+            return 'TENTATIVE';
+        if (upper === 'CANCELLED')
+            return 'CANCELLED';
+        return 'CONFIRMED';
+    }
+}
+//# sourceMappingURL=calendar.service.js.map

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

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

package/dist/services/event-bus.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Typed event bus for internal email events.
+ *
+ * Decouples the IMAP IDLE watcher from MCP notification hooks.
+ * Uses Node's built-in EventEmitter with typed event maps.
+ */
+import { EventEmitter } from 'node:events';
+import type { EmailMeta } from '../types/index.js';
+export interface NewEmailEvent {
+    account: string;
+    mailbox: string;
+    emails: EmailMeta[];
+}
+export interface ExpungeEvent {
+    account: string;
+    mailbox: string;
+    count: number;
+}
+interface EmailEventMap {
+    'email:new': [NewEmailEvent];
+    'email:expunge': [ExpungeEvent];
+}
+export declare class EmailEventBus extends EventEmitter<EmailEventMap> {
+}
+/** Singleton event bus shared across the application. */
+declare const eventBus: EmailEventBus;
+export default eventBus;
+//# sourceMappingURL=event-bus.d.ts.map

package/dist/services/event-bus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-bus.d.ts","sourceRoot":"","sources":["../../src/services/event-bus.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAMnD,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,SAAS,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAMD,UAAU,aAAa;IACrB,WAAW,EAAE,CAAC,aAAa,CAAC,CAAC;IAC7B,eAAe,EAAE,CAAC,YAAY,CAAC,CAAC;CACjC;AAMD,qBAAa,aAAc,SAAQ,YAAY,CAAC,aAAa,CAAC;CAAG;AAEjE,yDAAyD;AACzD,QAAA,MAAM,QAAQ,eAAsB,CAAC;AACrC,eAAe,QAAQ,CAAC"}

package/dist/services/event-bus.js

@@ -0,0 +1,16 @@
+/**
+ * Typed event bus for internal email events.
+ *
+ * Decouples the IMAP IDLE watcher from MCP notification hooks.
+ * Uses Node's built-in EventEmitter with typed event maps.
+ */
+import { EventEmitter } from 'node:events';
+// ---------------------------------------------------------------------------
+// Typed EventBus
+// ---------------------------------------------------------------------------
+export class EmailEventBus extends EventEmitter {
+}
+/** Singleton event bus shared across the application. */
+const eventBus = new EmailEventBus();
+export default eventBus;
+//# sourceMappingURL=event-bus.js.map

package/dist/services/event-bus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-bus.js","sourceRoot":"","sources":["../../src/services/event-bus.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AA4B3C,8EAA8E;AAC9E,iBAAiB;AACjB,8EAA8E;AAE9E,MAAM,OAAO,aAAc,SAAQ,YAA2B;CAAG;AAEjE,yDAAyD;AACzD,MAAM,QAAQ,GAAG,IAAI,aAAa,EAAE,CAAC;AACrC,eAAe,QAAQ,CAAC"}

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

@@ -0,0 +1,77 @@
+/**
+ * AI Hooks Service — intelligent email triage via MCP sampling.
+ *
+ * Listens for new email events on the event bus and:
+ * - Matches static rules FIRST (fast, free, deterministic)
+ * - Falls through to AI triage via `sampling/createMessage` if no rule matched
+ * - Uses preset system prompts + custom instructions for AI triage
+ * - Auto-applies labels and flags based on AI response
+ * - Falls back to logging if sampling is unavailable
+ */
+import type { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import type { EmailMeta, HookRule, HooksConfig } from '../types/index.js';
+import type ImapService from './imap.service.js';
+import NotifierService from './notifier.service.js';
+interface TriageResult {
+    priority?: 'urgent' | 'high' | 'normal' | 'low';
+    labels?: string[];
+    flag?: boolean;
+    action?: string;
+    addToCalendar?: boolean;
+}
+interface BatchEmail {
+    account: string;
+    mailbox: string;
+    meta: EmailMeta;
+}
+interface RuleMatchResult {
+    matched: true;
+    rule: HookRule;
+}
+interface RuleNoMatch {
+    matched: false;
+}
+type StaticMatchOutcome = RuleMatchResult | RuleNoMatch;
+export default class HooksService {
+    private config;
+    private imapService;
+    private lowLevelServer;
+    private samplingSupported;
+    private pendingEmails;
+    private batchTimer;
+    private rateCounter;
+    private rateResetTimer;
+    private readonly resolvedSystemPrompt;
+    private readonly notifier;
+    private readonly localCalendar;
+    private static readonly MAX_SAMPLING_PER_MIN;
+    constructor(config: HooksConfig, imapService: ImapService);
+    /** Returns the NotifierService instance for direct tool access. */
+    getNotifier(): NotifierService;
+    /** Returns the current hooks configuration. */
+    getHooksConfig(): HooksConfig;
+    /**
+     * Start listening for email events.
+     * Call after MCP server is connected so we can access the low-level server.
+     */
+    start(lowLevelServer: Server, clientCapabilities: {
+        sampling?: boolean;
+    }): void;
+    stop(): void;
+    private onNewEmail;
+    private flushBatch;
+    static matchStaticRules(email: BatchEmail, rules: HookRule[]): StaticMatchOutcome;
+    private static emailMatchesRule;
+    private applyStaticRule;
+    private sendResourceUpdates;
+    private notifyBatch;
+    private triageBatch;
+    private static formatEmailSummary;
+    private applyTriageResults;
+    private applySingleTriage;
+    private applyCalendarAction;
+    static parseTriageResponse(text: string, expectedCount: number): TriageResult[];
+    static sanitizeTriageResult(raw: unknown): TriageResult;
+}
+export {};
+//# sourceMappingURL=hooks.service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.service.d.ts","sourceRoot":"","sources":["../../src/services/hooks.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAExE,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAG1E,OAAO,KAAK,WAAW,MAAM,mBAAmB,CAAC;AAGjD,OAAO,eAAe,MAAM,uBAAuB,CAAC;AAQpD,UAAU,YAAY;IACpB,QAAQ,CAAC,EAAE,QAAQ,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IAChD,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,UAAU,UAAU;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,SAAS,CAAC;CACjB;AAED,UAAU,eAAe;IACvB,OAAO,EAAE,IAAI,CAAC;IACd,IAAI,EAAE,QAAQ,CAAC;CAChB;AAED,UAAU,WAAW;IACnB,OAAO,EAAE,KAAK,CAAC;CAChB;AAED,KAAK,kBAAkB,GAAG,eAAe,GAAG,WAAW,CAAC;AAgCxD,MAAM,CAAC,OAAO,OAAO,YAAY;IAC/B,OAAO,CAAC,MAAM,CAAc;IAE5B,OAAO,CAAC,WAAW,CAAc;IAEjC,OAAO,CAAC,cAAc,CAAuB;IAE7C,OAAO,CAAC,iBAAiB,CAAS;IAElC,OAAO,CAAC,aAAa,CAAoB;IAEzC,OAAO,CAAC,UAAU,CAA8C;IAEhE,OAAO,CAAC,WAAW,CAAK;IAExB,OAAO,CAAC,cAAc,CAA+C;IAErE,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAS;IAE9C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkB;IAE3C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAuB;IAErD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,oBAAoB,CAAM;gBAEtC,MAAM,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW;IAWzD,mEAAmE;IACnE,WAAW,IAAI,eAAe;IAI9B,+CAA+C;IAC/C,cAAc,IAAI,WAAW;IAI7B;;;OAGG;IACH,KAAK,CAAC,cAAc,EAAE,MAAM,EAAE,kBAAkB,EAAE;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI;IAwB/E,IAAI,IAAI,IAAI;IAkBZ,OAAO,CAAC,UAAU;YAaJ,UAAU;IAyCxB,MAAM,CAAC,gBAAgB,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,kBAAkB;IAKjF,OAAO,CAAC,MAAM,CAAC,gBAAgB;YA0BjB,eAAe;YA0Ef,mBAAmB;YAiBnB,WAAW;YAoBX,WAAW;IA4CzB,OAAO,CAAC,MAAM,CAAC,kBAAkB;YAkBnB,kBAAkB;YAKlB,iBAAiB;YAkEjB,mBAAmB;IAuGjC,MAAM,CAAC,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,YAAY,EAAE;IAiB/E,MAAM,CAAC,oBAAoB,CAAC,GAAG,EAAE,OAAO,GAAG,YAAY;CAexD"}