pulseed 0.0.1 → 0.1.0

package/dist/runtime/notification-dispatcher.js

@@ -0,0 +1,196 @@
+import { NotificationConfigSchema } from "../types/notification.js";
+import { sendSlack } from "./channels/slack-channel.js";
+import { sendEmail } from "./channels/email-channel.js";
+import { sendWebhook } from "./channels/webhook-channel.js";
+// ─── 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;
+    }
+    /** 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;
+    }
+    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;IAcnC,sBAAsB;IAChB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ9B,4BAA4B;IAC5B,OAAO,IAAI,MAAM;CAGlB"}

package/dist/runtime/pid-manager.js

@@ -0,0 +1,62 @@
+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 = "pulseed.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 - clean up stale PID file
+            await this.cleanup();
+            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,kDAAkD;YAClD,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;YACrB,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"}

package/dist/runtime/plugin-loader.d.ts

@@ -0,0 +1,78 @@
+import type { Logger } from "./logger.js";
+import { type PluginManifest, type PluginState, type PluginType } from "../types/plugin.js";
+import type { AdapterRegistry } from "../execution/adapter-layer.js";
+import type { DataSourceRegistry } from "../observation/data-source-adapter.js";
+import type { NotifierRegistry } from "./notifier-registry.js";
+/**
+ * Discovers, loads, validates, and registers plugins from ~/.pulseed/plugins/.
+ *
+ * Design principles:
+ *  - Plugin load failures never crash PulSeed. Every error is caught, logged,
+ *    and returned as an error-state PluginState.
+ *  - Supports both plugin.yaml and plugin.json manifest formats.
+ *  - Routes each plugin to the correct registry based on manifest.type.
+ */
+export declare class PluginLoader {
+    private adapterRegistry;
+    private dataSourceRegistry;
+    private notifierRegistry;
+    private pluginsDir;
+    private pluginStates;
+    private readonly logger?;
+    constructor(adapterRegistry: AdapterRegistry, dataSourceRegistry: DataSourceRegistry, notifierRegistry: NotifierRegistry, pluginsDir?: string, logger?: Logger);
+    /**
+     * Discover all plugin directories and attempt to load each one.
+     * Returns a PluginState for every candidate directory (success or error).
+     */
+    loadAll(): Promise<PluginState[]>;
+    /**
+     * Load a single plugin from the given directory.
+     * Throws on any failure (caller catches and converts to error state).
+     */
+    loadOne(pluginDir: string): Promise<PluginState>;
+    /**
+     * Scan pluginsDir for subdirectories that contain plugin.yaml or plugin.json.
+     */
+    discoverPluginDirs(): Promise<string[]>;
+    /**
+     * Read and parse the plugin manifest (plugin.yaml or plugin.json).
+     * Validates against PluginManifestSchema.
+     */
+    loadManifest(pluginDir: string): Promise<PluginManifest>;
+    /**
+     * Check that the plugin implementation exports all required methods for its type.
+     */
+    validateInterface(type: PluginType, impl: unknown): void;
+    /**
+     * Register the plugin implementation in the appropriate registry.
+     */
+    registerPlugin(manifest: PluginManifest, impl: unknown, _pluginDir: string): Promise<void>;
+    buildSuccessState(manifest: PluginManifest): PluginState;
+    buildIncompatibleState(manifest: PluginManifest, pulseedVersion: string, range: string): PluginState;
+    buildErrorState(pluginDir: string, reason: unknown): PluginState;
+    /**
+     * Return the PluginState for a given plugin name, or null if not found.
+     */
+    getPluginState(pluginName: string): PluginState | null;
+    /**
+     * Update the in-memory plugin state and persist to disk.
+     */
+    updatePluginState(pluginName: string, updates: Partial<Pick<PluginState, "trust_score" | "usage_count" | "success_count" | "failure_count">>): Promise<void>;
+    private hasManifestFile;
+}
+export declare function parseSemver(version: string): {
+    major: number;
+    minor: number;
+    patch: number;
+};
+export declare function compareSemver(a: {
+    major: number;
+    minor: number;
+    patch: number;
+}, b: {
+    major: number;
+    minor: number;
+    patch: number;
+}): -1 | 0 | 1;
+export declare function satisfiesRange(version: string, min?: string, max?: string): boolean;
+//# sourceMappingURL=plugin-loader.d.ts.map

package/dist/runtime/plugin-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-loader.d.ts","sourceRoot":"","sources":["../../src/runtime/plugin-loader.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAGL,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,KAAK,UAAU,EAEhB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,eAAe,EAAY,MAAM,+BAA+B,CAAC;AAC/E,OAAO,KAAK,EAAE,kBAAkB,EAAsB,MAAM,uCAAuC,CAAC;AACpG,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAI/D;;;;;;;;GAQG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,kBAAkB,CAAqB;IAC/C,OAAO,CAAC,gBAAgB,CAAmB;IAC3C,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,YAAY,CAAuC;IAC3D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAS;gBAG/B,eAAe,EAAE,eAAe,EAChC,kBAAkB,EAAE,kBAAkB,EACtC,gBAAgB,EAAE,gBAAgB,EAClC,UAAU,CAAC,EAAE,MAAM,EACnB,MAAM,CAAC,EAAE,MAAM;IASjB;;;OAGG;IACG,OAAO,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAiBvC;;;OAGG;IACG,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAoDtD;;OAEG;IACG,kBAAkB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IA4B7C;;;OAGG;IACG,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IA4C9D;;OAEG;IACH,iBAAiB,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI;IAiBxD;;OAEG;IACG,cAAc,CAClB,QAAQ,EAAE,cAAc,EACxB,IAAI,EAAE,OAAO,EACb,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC;IAgBhB,iBAAiB,CAAC,QAAQ,EAAE,cAAc,GAAG,WAAW;IAexD,sBAAsB,CAAC,QAAQ,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,WAAW;IAgBpG,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,WAAW;IA6BhE;;OAEG;IACH,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI;IAItD;;OAEG;IACG,iBAAiB,CACrB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,aAAa,GAAG,aAAa,GAAG,eAAe,GAAG,eAAe,CAAC,CAAC,GACrG,OAAO,CAAC,IAAI,CAAC;YAeF,eAAe;CAW9B;AAyBD,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAI5F;AAED,wBAAgB,aAAa,CAC3B,CAAC,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EAClD,CAAC,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACjD,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAKZ;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAKnF"}