conatus 0.1.0

package/dist/runtime/event-server.js

@@ -0,0 +1,192 @@
+import * as fs from "node:fs";
+import * as fsp from "node:fs/promises";
+import * as path from "node:path";
+import * as http from "node:http";
+import { MotivaEventSchema } from "../types/drive.js";
+import { getEventsDir } from "../utils/paths.js";
+export class EventServer {
+    server = null;
+    driveSystem;
+    host;
+    port;
+    eventsDir;
+    fileWatcher = null;
+    logger;
+    constructor(driveSystem, config, logger) {
+        this.driveSystem = driveSystem;
+        this.host = config?.host ?? "127.0.0.1";
+        this.port = config?.port ?? 41700;
+        // Default events directory: ~/.conatus/events/
+        this.eventsDir = config?.eventsDir ?? getEventsDir();
+        this.logger = logger;
+    }
+    /** Start HTTP server */
+    async start() {
+        await fsp.mkdir(this.eventsDir, { recursive: true });
+        return new Promise((resolve, reject) => {
+            this.server = http.createServer((req, res) => this.handleRequest(req, res));
+            const server = this.server;
+            server.listen(this.port, this.host, () => {
+                // When port 0 is used, capture the OS-assigned port
+                const addr = server.address();
+                if (addr && typeof addr === "object") {
+                    this.port = addr.port;
+                }
+                resolve();
+            });
+            this.server.on("error", reject);
+        });
+    }
+    /** Stop HTTP server */
+    async stop() {
+        this.stopFileWatcher();
+        return new Promise((resolve) => {
+            if (!this.server) {
+                resolve();
+                return;
+            }
+            this.server.close(() => resolve());
+        });
+    }
+    /**
+     * Start watching the events directory for new `.json` files.
+     * When a file appears:
+     *   1. Read and parse it
+     *   2. Validate via MotivaEventSchema
+     *   3. Dispatch to DriveSystem (writeEvent)
+     *   4. Move to events/processed/ subdirectory
+     *   5. Log errors for malformed files but don't crash
+     *
+     * Creates the events directory if it doesn't exist.
+     */
+    startFileWatcher() {
+        if (this.fileWatcher)
+            return; // already watching
+        fs.mkdirSync(this.eventsDir, { recursive: true });
+        this.fileWatcher = fs.watch(this.eventsDir, (eventType, filename) => {
+            if ((eventType !== "rename" && eventType !== "change") || !filename)
+                return;
+            if (!filename.endsWith(".json") || filename.endsWith(".tmp"))
+                return;
+            const filePath = path.join(this.eventsDir, filename);
+            void this.processEventFile(filePath, filename).catch((err) => {
+                this.logger?.error(`EventServer: unhandled error processing event file "${filename}": ${String(err)}`);
+            });
+        });
+    }
+    /** Stop the file watcher and clean up the handle. */
+    stopFileWatcher() {
+        if (this.fileWatcher) {
+            this.fileWatcher.close();
+            this.fileWatcher = null;
+        }
+    }
+    /**
+     * Read, validate, dispatch, and move a single event file.
+     * Errors are logged but never propagated (caller must not crash).
+     */
+    async processEventFile(filePath, filename) {
+        try {
+            let stat;
+            try {
+                // Retry on ENOENT: on macOS, fs.watch fires 'rename' before the file
+                // is visible to fsp.stat, so retry up to 3 times with 20ms delay.
+                let lastErr;
+                for (let attempt = 0; attempt < 3; attempt++) {
+                    try {
+                        stat = await fsp.stat(filePath);
+                        break;
+                    }
+                    catch (err) {
+                        const code = err.code;
+                        if (code !== "ENOENT")
+                            throw err;
+                        lastErr = err;
+                        await new Promise((r) => setTimeout(r, 20));
+                    }
+                }
+                if (!stat) {
+                    // File never appeared — already removed
+                    void lastErr; // suppress unused warning
+                    return;
+                }
+            }
+            catch {
+                return; // non-ENOENT error — file already removed or inaccessible
+            }
+            if (!stat.isFile())
+                return;
+            const content = await fsp.readFile(filePath, "utf-8");
+            const raw = JSON.parse(content);
+            const event = MotivaEventSchema.parse(raw);
+            // Dispatch to DriveSystem
+            await this.driveSystem.writeEvent(event);
+            // Move to processed/
+            const processedDir = path.join(this.eventsDir, "processed");
+            await fsp.mkdir(processedDir, { recursive: true });
+            const dstPath = path.join(processedDir, filename);
+            await fsp.rename(filePath, dstPath);
+        }
+        catch (err) {
+            this.logger?.error(`EventServer: failed to process event file "${filename}": ${String(err)}`);
+            // Do not re-throw — watcher must keep running
+        }
+    }
+    /** Handle incoming HTTP request */
+    handleRequest(req, res) {
+        // Only accept POST /events
+        if (req.method !== "POST" || req.url !== "/events") {
+            res.writeHead(404, { "Content-Type": "application/json" });
+            res.end(JSON.stringify({ error: "Not found" }));
+            return;
+        }
+        const MAX_BODY_SIZE = 1_048_576; // 1 MB
+        let body = "";
+        let bytesReceived = 0;
+        req.on("data", (chunk) => {
+            bytesReceived += chunk.length;
+            if (bytesReceived > MAX_BODY_SIZE) {
+                res.writeHead(413, { "Content-Type": "application/json" });
+                res.end(JSON.stringify({ error: "Payload too large" }));
+                req.destroy();
+                return;
+            }
+            body += chunk;
+        });
+        req.on("end", () => {
+            try {
+                const data = JSON.parse(body);
+                const event = MotivaEventSchema.parse(data);
+                // Write event to file queue (DriveSystem will pick it up)
+                // Fire-and-forget: writeEvent is now async but HTTP handler responds immediately
+                void this.driveSystem.writeEvent(event).catch((err) => {
+                    this.logger?.error(`EventServer: writeEvent failed: ${String(err)}`);
+                });
+                res.writeHead(200, { "Content-Type": "application/json" });
+                res.end(JSON.stringify({ status: "accepted", event_type: event.type }));
+            }
+            catch (err) {
+                res.writeHead(400, { "Content-Type": "application/json" });
+                res.end(JSON.stringify({ error: "Invalid event", details: String(err) }));
+            }
+        });
+    }
+    /** Check if server is running */
+    isRunning() {
+        return this.server !== null && this.server.listening;
+    }
+    /** Check if file watcher is active */
+    isWatching() {
+        return this.fileWatcher !== null;
+    }
+    getPort() {
+        return this.port;
+    }
+    getHost() {
+        return this.host;
+    }
+    getEventsDir() {
+        return this.eventsDir;
+    }
+}
+//# sourceMappingURL=event-server.js.map

package/dist/runtime/event-server.js.map

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

package/dist/runtime/logger.d.ts

@@ -0,0 +1,57 @@
+export type LogLevel = "debug" | "info" | "warn" | "error";
+export interface LoggerConfig {
+    dir: string;
+    maxSizeMB?: number;
+    maxFiles?: number;
+    level?: LogLevel;
+    consoleOutput?: boolean;
+    rotateByDate?: boolean;
+}
+export declare class Logger {
+    private dir;
+    private maxSizeBytes;
+    private maxFiles;
+    private level;
+    private consoleOutput;
+    private rotateByDate;
+    private currentFile;
+    private lastWriteDate;
+    private stream;
+    private streamSize;
+    private hasCurrentData;
+    private hadDataOnLastDate;
+    private rotationQueue;
+    private rotationDone;
+    private streamErrored;
+    constructor(config: LoggerConfig);
+    debug(message: string, context?: Record<string, unknown>): void;
+    info(message: string, context?: Record<string, unknown>): void;
+    warn(message: string, context?: Record<string, unknown>): void;
+    error(message: string, context?: Record<string, unknown>): void;
+    setLevel(level: LogLevel): void;
+    /**
+     * Flush and close the underlying write stream.
+     * Waits for any in-flight rotation to complete first.
+     * Call during clean shutdown to ensure all buffered data is written to disk.
+     */
+    close(): Promise<void>;
+    private openStream;
+    private getStream;
+    private log;
+    private writeToFile;
+    private getCurrentDate;
+    /**
+     * Check if rotation is needed. Returns a descriptor of what rotation to perform,
+     * or null if no rotation is needed. Does NOT perform the rotation.
+     *
+     * Uses streamSize (bytes accounted by this Logger instance) rather than existsSync,
+     * because the stream buffer may not have been flushed to disk yet.
+     */
+    private checkRotation;
+    /**
+     * Flush the current stream to disk, perform the file rename, then resolve.
+     * Opens a fresh stream after rotation. Called only on rotation events (rare).
+     */
+    private flushAndRotate;
+}
+//# sourceMappingURL=logger.d.ts.map

package/dist/runtime/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/runtime/logger.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAS3D,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,qBAAa,MAAM;IACjB,OAAO,CAAC,GAAG,CAAS;IACpB,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,aAAa,CAAU;IAC/B,OAAO,CAAC,YAAY,CAAU;IAC9B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,aAAa,CAAuB;IAC5C,OAAO,CAAC,MAAM,CAA+B;IAE7C,OAAO,CAAC,UAAU,CAAK;IAEvB,OAAO,CAAC,cAAc,CAAS;IAE/B,OAAO,CAAC,iBAAiB,CAAS;IAElC,OAAO,CAAC,aAAa,CAAgB;IAErC,OAAO,CAAC,YAAY,CAA8B;IAElD,OAAO,CAAC,aAAa,CAAS;gBAElB,MAAM,EAAE,YAAY;IAuBhC,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI/D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI9D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI9D,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI/D,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;IAI/B;;;;OAIG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAiB5B,OAAO,CAAC,UAAU;IAalB,OAAO,CAAC,SAAS;IAQjB,OAAO,CAAC,GAAG;IAmBX,OAAO,CAAC,WAAW;IAuCnB,OAAO,CAAC,cAAc;IAItB;;;;;;OAMG;IACH,OAAO,CAAC,aAAa;IA8BrB;;;OAGG;IACH,OAAO,CAAC,cAAc;CAiDvB"}

package/dist/runtime/logger.js

@@ -0,0 +1,254 @@
+import * as fs from "node:fs";
+import * as fsp from "node:fs/promises";
+import * as path from "node:path";
+const LOG_LEVELS = {
+    debug: 0,
+    info: 1,
+    warn: 2,
+    error: 3,
+};
+export class Logger {
+    dir;
+    maxSizeBytes;
+    maxFiles;
+    level;
+    consoleOutput;
+    rotateByDate;
+    currentFile;
+    lastWriteDate = null;
+    stream = null;
+    // Bytes written to the current stream (in-memory + on-disk combined)
+    streamSize = 0;
+    // True if we have written at least one byte since the last rotation (or since startup)
+    hasCurrentData = false;
+    // True if any data was written under lastWriteDate (survives size rotations within the same day)
+    hadDataOnLastDate = false;
+    // Queue of lines buffered while rotation flush is in progress
+    rotationQueue = [];
+    // Promise that resolves once the current rotation + queue drain is complete
+    rotationDone = null;
+    // True once a stream error has occurred — stops reopening to prevent infinite loop
+    streamErrored = false;
+    constructor(config) {
+        this.dir = config.dir;
+        this.maxSizeBytes = (config.maxSizeMB ?? 10) * 1024 * 1024;
+        this.maxFiles = config.maxFiles ?? 5;
+        this.level = LOG_LEVELS[config.level ?? "info"];
+        this.consoleOutput = config.consoleOutput ?? true;
+        this.rotateByDate = config.rotateByDate ?? true;
+        this.currentFile = path.join(this.dir, "conatus.log");
+        // Ensure log directory exists (one-time init, sync is acceptable here)
+        fs.mkdirSync(this.dir, { recursive: true });
+        // Seed streamSize from existing file to avoid immediate re-rotation
+        // Done asynchronously to avoid blocking the constructor; streamSize stays 0 until resolved
+        fsp.stat(this.currentFile).then((stat) => {
+            this.streamSize = stat.size;
+            this.hasCurrentData = this.streamSize > 0;
+            this.hadDataOnLastDate = this.hasCurrentData;
+        }).catch(() => {
+            // File doesn't exist yet — streamSize stays 0, which is correct
+        });
+    }
+    debug(message, context) {
+        this.log("debug", message, context);
+    }
+    info(message, context) {
+        this.log("info", message, context);
+    }
+    warn(message, context) {
+        this.log("warn", message, context);
+    }
+    error(message, context) {
+        this.log("error", message, context);
+    }
+    setLevel(level) {
+        this.level = LOG_LEVELS[level];
+    }
+    /**
+     * Flush and close the underlying write stream.
+     * Waits for any in-flight rotation to complete first.
+     * Call during clean shutdown to ensure all buffered data is written to disk.
+     */
+    async close() {
+        // Loop: wait for rotations that may chain (rotation → queue drain → another rotation)
+        while (this.rotationDone) {
+            await this.rotationDone;
+        }
+        // Now close the current stream
+        if (!this.stream)
+            return;
+        const stream = this.stream;
+        return new Promise((resolve) => {
+            stream.end(() => {
+                this.stream = null;
+                resolve();
+            });
+        });
+    }
+    openStream() {
+        const stream = fs.createWriteStream(this.currentFile, { flags: "a" });
+        stream.on("error", (err) => {
+            if (!this.streamErrored) {
+                // Log first error via console.error so it's visible; suppress subsequent ones
+                console.error("[Logger] stream error — file logging disabled:", err.message);
+                this.streamErrored = true;
+            }
+            this.stream = null;
+        });
+        return stream;
+    }
+    getStream() {
+        if (this.streamErrored)
+            return null;
+        if (!this.stream) {
+            this.stream = this.openStream();
+        }
+        return this.stream;
+    }
+    log(level, message, context) {
+        if (LOG_LEVELS[level] < this.level)
+            return;
+        const timestamp = new Date().toISOString();
+        const contextStr = context ? " " + JSON.stringify(context) : "";
+        const line = `[${timestamp}] [${level.toUpperCase().padEnd(5)}] ${message}${contextStr}\n`;
+        // Console output
+        if (this.consoleOutput) {
+            const consoleFn = level === "error" ? console.error
+                : level === "warn" ? console.warn
+                    : console.log;
+            consoleFn(line.trimEnd());
+        }
+        // File output
+        this.writeToFile(line);
+    }
+    writeToFile(line) {
+        try {
+            // If rotation is in progress, queue the line and return
+            if (this.rotationDone) {
+                this.rotationQueue.push(line);
+                return;
+            }
+            // Check if rotation is needed before writing
+            const rotation = this.checkRotation();
+            if (rotation) {
+                // Queue this line; it will be written after rotation completes
+                this.rotationQueue.push(line);
+                this.rotationDone = this.flushAndRotate(rotation).then(() => {
+                    this.rotationDone = null;
+                    // Drain the queue (may trigger further rotations, which set rotationDone again)
+                    const queued = this.rotationQueue.splice(0);
+                    for (const qLine of queued) {
+                        this.writeToFile(qLine);
+                    }
+                });
+                return;
+            }
+            // Normal write — non-blocking via stream buffer
+            const stream = this.getStream();
+            if (!stream)
+                return; // stream errored previously — silently drop
+            stream.write(line, "utf-8");
+            const bytes = Buffer.byteLength(line, "utf-8");
+            this.streamSize += bytes;
+            this.hasCurrentData = true;
+            this.hadDataOnLastDate = true;
+        }
+        catch {
+            // Silently fail file writes (don't crash daemon for logging issues)
+        }
+    }
+    // Returns the current date as YYYY-MM-DD
+    getCurrentDate() {
+        return new Date().toISOString().slice(0, 10);
+    }
+    /**
+     * Check if rotation is needed. Returns a descriptor of what rotation to perform,
+     * or null if no rotation is needed. Does NOT perform the rotation.
+     *
+     * Uses streamSize (bytes accounted by this Logger instance) rather than existsSync,
+     * because the stream buffer may not have been flushed to disk yet.
+     */
+    checkRotation() {
+        // ── Date-based rotation ──────────────────────────────────────────────
+        if (this.rotateByDate) {
+            const today = this.getCurrentDate();
+            if (this.lastWriteDate === null) {
+                // First write: just record the date, no rotation
+                this.lastWriteDate = today;
+            }
+            else if (this.lastWriteDate !== today) {
+                const prevDate = this.lastWriteDate;
+                // Capture whether we had data on the previous date before resetting
+                const shouldRotate = this.hadDataOnLastDate;
+                this.lastWriteDate = today;
+                this.hadDataOnLastDate = false;
+                // Rotate only if data was written under the previous date
+                if (shouldRotate) {
+                    return { type: "date", date: prevDate };
+                }
+                return null;
+            }
+        }
+        // ── Size-based rotation ──────────────────────────────────────────────
+        // streamSize tracks both on-disk and in-buffer bytes, so no existsSync needed
+        if (this.streamSize >= this.maxSizeBytes) {
+            return { type: "size" };
+        }
+        return null;
+    }
+    /**
+     * Flush the current stream to disk, perform the file rename, then resolve.
+     * Opens a fresh stream after rotation. Called only on rotation events (rare).
+     */
+    flushAndRotate(rotation) {
+        const doRotate = async () => {
+            try {
+                if (rotation.type === "date") {
+                    const dest = path.join(this.dir, `conatus.${rotation.date}.log`);
+                    await fsp.rename(this.currentFile, dest).catch(() => {
+                        // File may not exist — ignore
+                    });
+                }
+                else {
+                    // Size-based: shift existing rotated files up, then rename current
+                    for (let i = this.maxFiles - 1; i >= 1; i--) {
+                        const older = path.join(this.dir, `conatus.${i + 1}.log`);
+                        const newer = path.join(this.dir, `conatus.${i}.log`);
+                        if (i === this.maxFiles - 1) {
+                            await fsp.unlink(older).catch(() => {
+                                // File may not exist — ignore
+                            });
+                        }
+                        await fsp.rename(newer, older).catch(() => {
+                            // File may not exist — ignore
+                        });
+                    }
+                    await fsp.rename(this.currentFile, path.join(this.dir, "conatus.1.log")).catch(() => {
+                        // File may not exist — ignore
+                    });
+                }
+            }
+            catch (err) {
+                console.error("[Logger] rotation error:", err instanceof Error ? err.message : err);
+            }
+            this.streamSize = 0;
+            this.hasCurrentData = false;
+            // Open fresh stream for the new log file
+            this.stream = this.openStream();
+        };
+        if (this.stream) {
+            // Flush buffered data to disk before renaming
+            const oldStream = this.stream;
+            this.stream = null;
+            return new Promise((resolve) => {
+                oldStream.end(() => {
+                    doRotate().then(resolve).catch(resolve);
+                });
+            });
+        }
+        else {
+            return doRotate();
+        }
+    }
+}
+//# sourceMappingURL=logger.js.map

package/dist/runtime/logger.js.map

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

package/dist/runtime/notification-dispatcher.d.ts

@@ -0,0 +1,49 @@
+import type { Logger } from "./logger.js";
+import type { Report } from "../types/report.js";
+import type { NotificationConfig, NotificationResult } from "../types/notification.js";
+import type { NotifierRegistry } from "./notifier-registry.js";
+export interface INotificationDispatcher {
+    dispatch(report: Report): Promise<NotificationResult[]>;
+}
+export declare class NotificationDispatcher implements INotificationDispatcher {
+    private config;
+    /** reportType -> timestamp of last successful send */
+    private lastSent;
+    private notifierRegistry?;
+    private readonly logger?;
+    constructor(config?: Partial<NotificationConfig>, notifierRegistry?: NotifierRegistry, logger?: Logger);
+    /** Replace or set the NotifierRegistry after construction. */
+    setNotifierRegistry(registry: NotifierRegistry): void;
+    /** Dispatch report to all configured channels */
+    dispatch(report: Report): Promise<NotificationResult[]>;
+    /**
+     * Route the report to all matching INotifier plugins registered in the
+     * NotifierRegistry. Plugin failures are logged but never propagated.
+     */
+    private dispatchToPluginNotifiers;
+    /** Derive a severity level from the report type. */
+    private resolveSeverity;
+    /**
+     * Return the channels applicable to this report. Per-goal overrides take
+     * priority over the global channel list.
+     */
+    private getChannelsForReport;
+    /**
+     * 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).
+     */
+    private getCooldownMinutes;
+    /** Check if currently in DND hours for the given report type. */
+    private isDND;
+    /** Check cooldown: true if we should suppress due to recent send. */
+    private isCooldown;
+    /**
+     * Return true if the channel should receive this report type.
+     * An empty report_types array means "accept all."
+     */
+    private channelAcceptsReportType;
+    /** Dispatch to the correct sender based on channel type. */
+    private sendToChannel;
+}
+//# sourceMappingURL=notification-dispatcher.d.ts.map

package/dist/runtime/notification-dispatcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification-dispatcher.d.ts","sourceRoot":"","sources":["../../src/runtime/notification-dispatcher.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,KAAK,EAEV,kBAAkB,EAClB,kBAAkB,EAInB,MAAM,0BAA0B,CAAC;AAGlC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAI/D,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAAC;CACzD;AAuTD,qBAAa,sBAAuB,YAAW,uBAAuB;IACpE,OAAO,CAAC,MAAM,CAAqB;IACnC,sDAAsD;IACtD,OAAO,CAAC,QAAQ,CAAkC;IAClD,OAAO,CAAC,gBAAgB,CAAC,CAAmB;IAC5C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAS;gBAErB,MAAM,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,EAAE,gBAAgB,CAAC,EAAE,gBAAgB,EAAE,MAAM,CAAC,EAAE,MAAM;IAMtG,8DAA8D;IAC9D,mBAAmB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,IAAI;IAIrD,iDAAiD;IAC3C,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAsD7D;;;OAGG;YACW,yBAAyB;IAqCvC,oDAAoD;IACpD,OAAO,CAAC,eAAe;IAQvB;;;OAGG;IACH,OAAO,CAAC,oBAAoB;IAY5B;;;;OAIG;IACH,OAAO,CAAC,kBAAkB;IAK1B,iEAAiE;IACjE,OAAO,CAAC,KAAK;IAiBb,qEAAqE;IACrE,OAAO,CAAC,UAAU;IAWlB;;;OAGG;IACH,OAAO,CAAC,wBAAwB;IAQhC,4DAA4D;YAC9C,aAAa;CAa5B"}