conatus 0.1.0

package/dist/runtime/notification-dispatcher.js

@@ -0,0 +1,444 @@
+import * as https from "node:https";
+import * as http from "node:http";
+import { URL } from "node:url";
+import nodemailer from "nodemailer";
+import { NotificationConfigSchema } from "../types/notification.js";
+// ─── Helpers ───
+/** Perform an HTTP/HTTPS POST with a JSON body. Returns the response status code. */
+function httpPost(urlStr, body, extraHeaders) {
+    return new Promise((resolve, reject) => {
+        let parsed;
+        try {
+            parsed = new URL(urlStr);
+        }
+        catch (err) {
+            reject(new Error(`Invalid URL: ${urlStr}`));
+            return;
+        }
+        const payload = JSON.stringify(body);
+        const isHttps = parsed.protocol === "https:";
+        const lib = isHttps ? https : http;
+        const options = {
+            hostname: parsed.hostname,
+            port: parsed.port
+                ? parseInt(parsed.port, 10)
+                : isHttps
+                    ? 443
+                    : 80,
+            path: parsed.pathname + parsed.search,
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                "Content-Length": Buffer.byteLength(payload),
+                ...extraHeaders,
+            },
+        };
+        const req = lib.request(options, (res) => {
+            let data = "";
+            res.on("data", (chunk) => {
+                data += chunk.toString();
+            });
+            res.on("end", () => {
+                resolve({ statusCode: res.statusCode ?? 0, body: data });
+            });
+        });
+        req.on("error", (err) => reject(err));
+        req.setTimeout(10_000, () => {
+            req.destroy(new Error("HTTP request timeout"));
+        });
+        req.write(payload);
+        req.end();
+    });
+}
+/** Truncate long strings for Slack blocks. */
+function truncate(str, maxLen) {
+    if (str.length <= maxLen)
+        return str;
+    return str.slice(0, maxLen - 3) + "...";
+}
+/** Escape user-controlled strings before embedding in HTML to prevent XSS. */
+function escapeHtml(s) {
+    return s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
+}
+function formatReportForSlack(report, format) {
+    const goalLabel = report.goal_id ? `Goal: ${report.goal_id}` : "(no goal)";
+    const fallbackText = `[${report.report_type}] ${report.title}`;
+    if (format === "compact") {
+        const blocks = [
+            {
+                type: "section",
+                text: {
+                    type: "mrkdwn",
+                    text: `*${truncate(report.title, 150)}*\n${goalLabel} | _${report.report_type}_`,
+                },
+            },
+        ];
+        return { blocks, text: fallbackText };
+    }
+    // full format
+    const blocks = [
+        {
+            type: "header",
+            text: {
+                type: "plain_text",
+                text: truncate(report.title, 150),
+                emoji: false,
+            },
+        },
+        {
+            type: "section",
+            text: {
+                type: "mrkdwn",
+                text: `*Type*: ${report.report_type} | *${goalLabel}*`,
+            },
+        },
+        { type: "divider" },
+        {
+            type: "section",
+            text: {
+                type: "mrkdwn",
+                // Slack mrkdwn max text block is 3000 chars
+                text: truncate(report.content, 2900),
+            },
+        },
+        {
+            type: "section",
+            text: {
+                type: "mrkdwn",
+                text: `_Generated at ${report.generated_at}_`,
+            },
+        },
+    ];
+    return { blocks, text: fallbackText };
+}
+// ─── Webhook formatting ───
+function formatReportForWebhook(report) {
+    return {
+        id: report.id,
+        report_type: report.report_type,
+        goal_id: report.goal_id,
+        title: report.title,
+        content: report.content,
+        verbosity: report.verbosity,
+        generated_at: report.generated_at,
+    };
+}
+// ─── Individual notifiers ───
+async function sendSlack(channel, report) {
+    const payload = formatReportForSlack(report, channel.format);
+    try {
+        const response = await httpPost(channel.webhook_url, payload);
+        if (response.statusCode === 200) {
+            return {
+                channel_type: "slack",
+                success: true,
+                delivered_at: new Date().toISOString(),
+                suppressed: false,
+            };
+        }
+        return {
+            channel_type: "slack",
+            success: false,
+            error: `Slack webhook returned HTTP ${response.statusCode}: ${truncate(response.body, 200)}`,
+            suppressed: false,
+        };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return {
+            channel_type: "slack",
+            success: false,
+            error: `Slack webhook error: ${message}`,
+            suppressed: false,
+        };
+    }
+}
+/** Build a simple HTML body for a report. */
+function buildEmailHtml(report) {
+    const rows = [
+        ["ID", escapeHtml(report.id)],
+        ["Type", escapeHtml(report.report_type)],
+        ["Goal", escapeHtml(report.goal_id ?? "(none)")],
+        ["Generated", escapeHtml(report.generated_at)],
+    ]
+        .map(([k, v]) => `<tr><th style="text-align:left;padding:4px 8px;background:#f5f5f5">${k}</th>` +
+        `<td style="padding:4px 8px">${v}</td></tr>`)
+        .join("\n");
+    return `<!DOCTYPE html>
+<html>
+<head><meta charset="utf-8"></head>
+<body style="font-family:sans-serif;color:#333">
+<h2>${escapeHtml(report.title)}</h2>
+<table border="0" cellpadding="0" cellspacing="4" style="border-collapse:collapse">
+${rows}
+</table>
+<hr>
+<pre style="white-space:pre-wrap;background:#fafafa;padding:12px;border-radius:4px">${escapeHtml(report.content)}</pre>
+</body>
+</html>`;
+}
+async function sendEmail(channel, report) {
+    try {
+        const transport = nodemailer.createTransport({
+            host: channel.smtp.host,
+            port: channel.smtp.port,
+            secure: channel.smtp.secure,
+            auth: {
+                user: channel.smtp.auth.user,
+                pass: channel.smtp.auth.pass,
+            },
+        });
+        await transport.sendMail({
+            from: channel.smtp.auth.user,
+            to: channel.address,
+            subject: report.title,
+            text: `${report.title}\n\n${report.content}`,
+            html: buildEmailHtml(report),
+        });
+        return {
+            channel_type: "email",
+            success: true,
+            delivered_at: new Date().toISOString(),
+            suppressed: false,
+        };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return {
+            channel_type: "email",
+            success: false,
+            error: `Email send error: ${message}`,
+            suppressed: false,
+        };
+    }
+}
+async function sendWebhook(channel, report) {
+    const payload = formatReportForWebhook(report);
+    try {
+        const response = await httpPost(channel.url, payload, channel.headers);
+        if (response.statusCode >= 200 && response.statusCode < 300) {
+            return {
+                channel_type: "webhook",
+                success: true,
+                delivered_at: new Date().toISOString(),
+                suppressed: false,
+            };
+        }
+        return {
+            channel_type: "webhook",
+            success: false,
+            error: `Webhook returned HTTP ${response.statusCode}: ${truncate(response.body, 200)}`,
+            suppressed: false,
+        };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return {
+            channel_type: "webhook",
+            success: false,
+            error: `Webhook error: ${message}`,
+            suppressed: false,
+        };
+    }
+}
+// ─── Report type → NotificationEventType mapping ───
+/**
+ * Map an internal report_type string to the closest NotificationEventType
+ * for routing to INotifier plugins. Returns null when no mapping applies.
+ */
+function reportTypeToEventType(reportType) {
+    switch (reportType) {
+        case "goal_completion":
+            return "goal_complete";
+        case "urgent_alert":
+            return "approval_needed";
+        case "stall_escalation":
+            return "stall_detected";
+        case "strategy_change":
+            return "goal_progress";
+        case "capability_escalation":
+            return "task_blocked";
+        case "progress_update":
+            return "goal_progress";
+        default:
+            return null;
+    }
+}
+// ─── NotificationDispatcher ───
+export class NotificationDispatcher {
+    config;
+    /** reportType -> timestamp of last successful send */
+    lastSent = new Map();
+    notifierRegistry;
+    logger;
+    constructor(config, notifierRegistry, logger) {
+        this.config = NotificationConfigSchema.parse(config ?? {});
+        this.notifierRegistry = notifierRegistry;
+        this.logger = logger;
+    }
+    /** Replace or set the NotifierRegistry after construction. */
+    setNotifierRegistry(registry) {
+        this.notifierRegistry = registry;
+    }
+    /** Dispatch report to all configured channels */
+    async dispatch(report) {
+        const results = [];
+        const channels = this.getChannelsForReport(report);
+        for (const channel of channels) {
+            // Check DND
+            if (this.isDND(report.report_type)) {
+                results.push({
+                    channel_type: channel.type,
+                    success: false,
+                    suppressed: true,
+                    suppression_reason: "dnd",
+                });
+                continue;
+            }
+            // Check cooldown
+            if (this.isCooldown(report.report_type)) {
+                results.push({
+                    channel_type: channel.type,
+                    success: false,
+                    suppressed: true,
+                    suppression_reason: "cooldown",
+                });
+                continue;
+            }
+            // Check if this channel accepts this report type
+            if (!this.channelAcceptsReportType(channel, report.report_type)) {
+                results.push({
+                    channel_type: channel.type,
+                    success: false,
+                    suppressed: true,
+                    suppression_reason: "filtered",
+                });
+                continue;
+            }
+            // Send
+            const result = await this.sendToChannel(channel, report);
+            results.push(result);
+            if (result.success) {
+                this.lastSent.set(report.report_type, Date.now());
+            }
+        }
+        // Route to NotifierRegistry plugins (additive, failures don't affect core dispatch)
+        await this.dispatchToPluginNotifiers(report);
+        return results;
+    }
+    /**
+     * Route the report to all matching INotifier plugins registered in the
+     * NotifierRegistry. Plugin failures are logged but never propagated.
+     */
+    async dispatchToPluginNotifiers(report) {
+        if (!this.notifierRegistry)
+            return;
+        const eventType = reportTypeToEventType(report.report_type);
+        if (eventType === null)
+            return;
+        const notifiers = this.notifierRegistry.findForEvent(eventType);
+        if (notifiers.length === 0)
+            return;
+        const event = {
+            type: eventType,
+            goal_id: report.goal_id ?? "",
+            timestamp: report.generated_at,
+            summary: report.title,
+            details: {
+                report_id: report.id,
+                report_type: report.report_type,
+                content: report.content,
+                verbosity: report.verbosity,
+            },
+            severity: this.resolveSeverity(report.report_type),
+        };
+        const settlements = await Promise.allSettled(notifiers.map((n) => n.notify(event)));
+        for (let i = 0; i < settlements.length; i++) {
+            const result = settlements[i];
+            if (result.status === "rejected") {
+                const notifierName = notifiers[i].name;
+                const reason = result.reason instanceof Error ? result.reason.message : String(result.reason);
+                this.logger?.error(`[NotificationDispatcher] plugin notifier "${notifierName}" failed: ${reason}`);
+            }
+        }
+    }
+    /** Derive a severity level from the report type. */
+    resolveSeverity(reportType) {
+        if (reportType === "urgent_alert")
+            return "critical";
+        if (reportType === "stall_escalation" || reportType === "capability_escalation")
+            return "warning";
+        return "info";
+    }
+    // ─── Private helpers ───
+    /**
+     * Return the channels applicable to this report. Per-goal overrides take
+     * priority over the global channel list.
+     */
+    getChannelsForReport(report) {
+        if (report.goal_id) {
+            const override = this.config.goal_overrides.find((o) => o.goal_id === report.goal_id);
+            if (override?.channels && override.channels.length > 0) {
+                return override.channels;
+            }
+        }
+        return this.config.channels;
+    }
+    /**
+     * Return the cooldown minutes for a report type, applying per-goal overrides
+     * when present (we use global cooldown here since no report context; callers
+     * that need per-goal cooldown should subclass or extend).
+     */
+    getCooldownMinutes(reportType) {
+        const cooldown = this.config.cooldown;
+        return cooldown[reportType] ?? 0;
+    }
+    /** Check if currently in DND hours for the given report type. */
+    isDND(reportType) {
+        const dnd = this.config.do_not_disturb;
+        if (!dnd.enabled)
+            return false;
+        // Exceptions bypass DND (urgent_alert, approval_request by default)
+        if (dnd.exceptions.includes(reportType))
+            return false;
+        const now = new Date();
+        const hour = now.getHours();
+        // Handle overnight DND (e.g., 22:00–07:00)
+        if (dnd.start_hour > dnd.end_hour) {
+            return hour >= dnd.start_hour || hour < dnd.end_hour;
+        }
+        return hour >= dnd.start_hour && hour < dnd.end_hour;
+    }
+    /** Check cooldown: true if we should suppress due to recent send. */
+    isCooldown(reportType) {
+        const cooldownMinutes = this.getCooldownMinutes(reportType);
+        if (cooldownMinutes <= 0)
+            return false;
+        const lastSent = this.lastSent.get(reportType);
+        if (lastSent === undefined)
+            return false;
+        const elapsedMs = Date.now() - lastSent;
+        return elapsedMs < cooldownMinutes * 60 * 1000;
+    }
+    /**
+     * Return true if the channel should receive this report type.
+     * An empty report_types array means "accept all."
+     */
+    channelAcceptsReportType(channel, reportType) {
+        if (channel.report_types.length === 0)
+            return true;
+        return channel.report_types.includes(reportType);
+    }
+    /** Dispatch to the correct sender based on channel type. */
+    async sendToChannel(channel, report) {
+        switch (channel.type) {
+            case "slack":
+                return sendSlack(channel, report);
+            case "email":
+                return sendEmail(channel, report);
+            case "webhook":
+                return sendWebhook(channel, report);
+        }
+    }
+}
+//# sourceMappingURL=notification-dispatcher.js.map

package/dist/runtime/notification-dispatcher.js.map

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

package/dist/runtime/notifier-registry.d.ts

@@ -0,0 +1,26 @@
+import type { INotifier, NotificationEventType } from "../types/plugin.js";
+/**
+ * Registry for INotifier plugin instances.
+ * Stores notifiers by name and allows lookup by supported event type.
+ * Thread-safety note: MVP runs single-threaded; no locking required.
+ */
+export declare class NotifierRegistry {
+    private notifiers;
+    /**
+     * Register a notifier under the given name.
+     * If a notifier with the same name already exists, it is replaced.
+     */
+    register(name: string, notifier: INotifier): void;
+    /**
+     * Return all registered notifiers that support the given event type.
+     * Returns an empty array when no notifiers match.
+     */
+    findForEvent(eventType: NotificationEventType): INotifier[];
+    /** Return the number of registered notifiers. */
+    get size(): number;
+    /** Check if a notifier with the given name is registered. */
+    has(name: string): boolean;
+    /** Return all registered notifier names. */
+    names(): string[];
+}
+//# sourceMappingURL=notifier-registry.d.ts.map

package/dist/runtime/notifier-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notifier-registry.d.ts","sourceRoot":"","sources":["../../src/runtime/notifier-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAI3E;;;;GAIG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,SAAS,CAAqC;IAEtD;;;OAGG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,GAAG,IAAI;IAIjD;;;OAGG;IACH,YAAY,CAAC,SAAS,EAAE,qBAAqB,GAAG,SAAS,EAAE;IAM3D,iDAAiD;IACjD,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,6DAA6D;IAC7D,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B,4CAA4C;IAC5C,KAAK,IAAI,MAAM,EAAE;CAGlB"}

package/dist/runtime/notifier-registry.js

@@ -0,0 +1,36 @@
+// ─── NotifierRegistry ───
+/**
+ * Registry for INotifier plugin instances.
+ * Stores notifiers by name and allows lookup by supported event type.
+ * Thread-safety note: MVP runs single-threaded; no locking required.
+ */
+export class NotifierRegistry {
+    notifiers = new Map();
+    /**
+     * Register a notifier under the given name.
+     * If a notifier with the same name already exists, it is replaced.
+     */
+    register(name, notifier) {
+        this.notifiers.set(name, notifier);
+    }
+    /**
+     * Return all registered notifiers that support the given event type.
+     * Returns an empty array when no notifiers match.
+     */
+    findForEvent(eventType) {
+        return Array.from(this.notifiers.values()).filter((n) => n.supports(eventType));
+    }
+    /** Return the number of registered notifiers. */
+    get size() {
+        return this.notifiers.size;
+    }
+    /** Check if a notifier with the given name is registered. */
+    has(name) {
+        return this.notifiers.has(name);
+    }
+    /** Return all registered notifier names. */
+    names() {
+        return Array.from(this.notifiers.keys());
+    }
+}
+//# sourceMappingURL=notifier-registry.js.map

package/dist/runtime/notifier-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notifier-registry.js","sourceRoot":"","sources":["../../src/runtime/notifier-registry.ts"],"names":[],"mappings":"AAEA,2BAA2B;AAE3B;;;;GAIG;AACH,MAAM,OAAO,gBAAgB;IACnB,SAAS,GAA2B,IAAI,GAAG,EAAE,CAAC;IAEtD;;;OAGG;IACH,QAAQ,CAAC,IAAY,EAAE,QAAmB;QACxC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IACrC,CAAC;IAED;;;OAGG;IACH,YAAY,CAAC,SAAgC;QAC3C,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CACtD,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,CACtB,CAAC;IACJ,CAAC;IAED,iDAAiD;IACjD,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;IAC7B,CAAC;IAED,6DAA6D;IAC7D,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAClC,CAAC;IAED,4CAA4C;IAC5C,KAAK;QACH,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC;IAC3C,CAAC;CACF"}

package/dist/runtime/pid-manager.d.ts

@@ -0,0 +1,18 @@
+export declare class PIDManager {
+    private pidPath;
+    constructor(baseDir: string, pidFile?: string);
+    /** Write current process PID to file (atomic write) */
+    writePID(): Promise<void>;
+    /** Read PID from file. Returns null if file doesn't exist or is invalid */
+    readPID(): Promise<{
+        pid: number;
+        started_at: string;
+    } | null>;
+    /** Check if a process with the stored PID is actually running */
+    isRunning(): Promise<boolean>;
+    /** Remove PID file */
+    cleanup(): Promise<void>;
+    /** Get the PID file path */
+    getPath(): string;
+}
+//# sourceMappingURL=pid-manager.d.ts.map

package/dist/runtime/pid-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pid-manager.d.ts","sourceRoot":"","sources":["../../src/runtime/pid-manager.ts"],"names":[],"mappings":"AAIA,qBAAa,UAAU;IACrB,OAAO,CAAC,OAAO,CAAS;gBAEZ,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,MAAsB;IAI5D,uDAAuD;IACjD,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAU/B,2EAA2E;IACrE,OAAO,IAAI,OAAO,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAWpE,iEAAiE;IAC3D,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC;IAanC,sBAAsB;IAChB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ9B,4BAA4B;IAC5B,OAAO,IAAI,MAAM;CAGlB"}

package/dist/runtime/pid-manager.js

@@ -0,0 +1,61 @@
+import * as fsp from "node:fs/promises";
+import * as path from "node:path";
+import { writeJsonFile } from "../utils/json-io.js";
+export class PIDManager {
+    pidPath;
+    constructor(baseDir, pidFile = "conatus.pid") {
+        this.pidPath = path.join(baseDir, pidFile);
+    }
+    /** Write current process PID to file (atomic write) */
+    async writePID() {
+        const info = {
+            pid: process.pid,
+            started_at: new Date().toISOString(),
+        };
+        const tmpPath = this.pidPath + ".tmp";
+        await writeJsonFile(tmpPath, info);
+        await fsp.rename(tmpPath, this.pidPath);
+    }
+    /** Read PID from file. Returns null if file doesn't exist or is invalid */
+    async readPID() {
+        try {
+            const content = await fsp.readFile(this.pidPath, "utf-8");
+            const data = JSON.parse(content);
+            if (typeof data.pid !== "number")
+                return null;
+            return data;
+        }
+        catch {
+            return null;
+        }
+    }
+    /** Check if a process with the stored PID is actually running */
+    async isRunning() {
+        const info = await this.readPID();
+        if (!info)
+            return false;
+        try {
+            // signal 0 doesn't kill, just checks if process exists
+            process.kill(info.pid, 0);
+            return true;
+        }
+        catch {
+            // Process doesn't exist - stale PID file
+            return false;
+        }
+    }
+    /** Remove PID file */
+    async cleanup() {
+        try {
+            await fsp.unlink(this.pidPath);
+        }
+        catch {
+            // Ignore cleanup errors (file may not exist)
+        }
+    }
+    /** Get the PID file path */
+    getPath() {
+        return this.pidPath;
+    }
+}
+//# sourceMappingURL=pid-manager.js.map

package/dist/runtime/pid-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pid-manager.js","sourceRoot":"","sources":["../../src/runtime/pid-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,kBAAkB,CAAC;AACxC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,MAAM,OAAO,UAAU;IACb,OAAO,CAAS;IAExB,YAAY,OAAe,EAAE,UAAkB,aAAa;QAC1D,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC7C,CAAC;IAED,uDAAuD;IACvD,KAAK,CAAC,QAAQ;QACZ,MAAM,IAAI,GAAG;YACX,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACrC,CAAC;QACF,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;QACtC,MAAM,aAAa,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QACnC,MAAM,GAAG,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IAC1C,CAAC;IAED,2EAA2E;IAC3E,KAAK,CAAC,OAAO;QACX,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAC1D,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAwC,CAAC;YACxE,IAAI,OAAO,IAAI,CAAC,GAAG,KAAK,QAAQ;gBAAE,OAAO,IAAI,CAAC;YAC9C,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,iEAAiE;IACjE,KAAK,CAAC,SAAS;QACb,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;QAClC,IAAI,CAAC,IAAI;YAAE,OAAO,KAAK,CAAC;QACxB,IAAI,CAAC;YACH,uDAAuD;YACvD,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;YAC1B,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,MAAM,CAAC;YACP,yCAAyC;YACzC,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,sBAAsB;IACtB,KAAK,CAAC,OAAO;QACX,IAAI,CAAC;YACH,MAAM,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACjC,CAAC;QAAC,MAAM,CAAC;YACP,6CAA6C;QAC/C,CAAC;IACH,CAAC;IAED,4BAA4B;IAC5B,OAAO;QACL,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;CACF"}