@loom-framework/core 0.1.0-alpha.17 → 0.1.0-alpha.171

package/dist/backend/notifications/notification-storage.js

@@ -0,0 +1,160 @@
+/**
+ * Independent notification storage
+ * Following UserStore/TokenStore pattern — NOT using DataAdapter.
+ */
+import { promises as fs } from 'fs';
+import path from 'path';
+import { generateId } from '../../utils/id.js';
+export class NotificationStorage {
+    notifications = new Map();
+    paths;
+    defaultUserId;
+    filePath;
+    dirty = false;
+    constructor(paths, defaultUserId = 'admin') {
+        this.paths = paths;
+        this.defaultUserId = defaultUserId;
+        this.filePath = path.join(paths.forUser(defaultUserId).notifications, 'items.json');
+    }
+    async initialize() {
+        await fs.mkdir(path.dirname(this.filePath), { recursive: true });
+        try {
+            const data = await fs.readFile(this.filePath, 'utf-8');
+            const items = JSON.parse(data);
+            for (const n of items)
+                this.notifications.set(n.id, n);
+        }
+        catch { /* File doesn't exist yet */ }
+        await this.prune();
+    }
+    async persist() {
+        if (!this.dirty)
+            return;
+        const data = Array.from(this.notifications.values());
+        await fs.writeFile(this.filePath, JSON.stringify(data, null, 2), 'utf-8');
+        this.dirty = false;
+    }
+    async create(input) {
+        const notification = {
+            ...input,
+            id: generateId('ntf'),
+            read: false,
+            createdAt: new Date().toISOString(),
+        };
+        this.notifications.set(notification.id, notification);
+        this.dirty = true;
+        await this.persist();
+        return notification;
+    }
+    async createBatch(inputs) {
+        const results = [];
+        for (const input of inputs) {
+            const notification = {
+                ...input,
+                id: generateId('ntf'),
+                read: false,
+                createdAt: new Date().toISOString(),
+            };
+            this.notifications.set(notification.id, notification);
+            results.push(notification);
+        }
+        this.dirty = true;
+        await this.persist();
+        return results;
+    }
+    async list(userId, options) {
+        let items = Array.from(this.notifications.values())
+            .filter(n => n.userId === userId);
+        const unreadCount = items.filter(n => !n.read).length;
+        if (options?.unreadOnly)
+            items = items.filter(n => !n.read);
+        items.sort((a, b) => new Date(b.createdAt).getTime() - new Date(a.createdAt).getTime());
+        const total = items.length;
+        const offset = options?.offset ?? 0;
+        const limit = options?.limit ?? 20;
+        return { items: items.slice(offset, offset + limit), total, unreadCount };
+    }
+    async get(userId, id) {
+        const n = this.notifications.get(id);
+        if (!n || n.userId !== userId)
+            return null;
+        return n;
+    }
+    async markRead(userId, id) {
+        const n = this.notifications.get(id);
+        if (!n || n.userId !== userId)
+            return false;
+        n.read = true;
+        this.dirty = true;
+        await this.persist();
+        return true;
+    }
+    async markAllRead(userId) {
+        let count = 0;
+        for (const n of this.notifications.values()) {
+            if (n.userId === userId && !n.read) {
+                n.read = true;
+                count++;
+            }
+        }
+        if (count > 0) {
+            this.dirty = true;
+            await this.persist();
+        }
+        return count;
+    }
+    async delete(userId, id) {
+        const n = this.notifications.get(id);
+        if (!n || n.userId !== userId)
+            return false;
+        this.notifications.delete(id);
+        this.dirty = true;
+        await this.persist();
+        return true;
+    }
+    async clear(userId) {
+        let count = 0;
+        for (const [id, n] of this.notifications) {
+            if (n.userId === userId) {
+                this.notifications.delete(id);
+                count++;
+            }
+        }
+        if (count > 0) {
+            this.dirty = true;
+            await this.persist();
+        }
+        return count;
+    }
+    async getUnreadCount(userId) {
+        return Array.from(this.notifications.values())
+            .filter(n => n.userId === userId && !n.read).length;
+    }
+    async prune(maxAgeDays = 30, maxItems = 500) {
+        const cutoff = Date.now() - maxAgeDays * 24 * 60 * 60 * 1000;
+        let removed = 0;
+        for (const [id, n] of this.notifications) {
+            if (new Date(n.createdAt).getTime() < cutoff) {
+                this.notifications.delete(id);
+                removed++;
+            }
+        }
+        if (this.notifications.size > maxItems) {
+            const sorted = Array.from(this.notifications.values())
+                .sort((a, b) => new Date(b.createdAt).getTime() - new Date(a.createdAt).getTime());
+            const toKeep = new Set(sorted.slice(0, maxItems).map(n => n.id));
+            for (const [id] of this.notifications) {
+                if (!toKeep.has(id)) {
+                    this.notifications.delete(id);
+                    removed++;
+                }
+            }
+        }
+        if (removed > 0) {
+            this.dirty = true;
+            await this.persist();
+        }
+        return removed;
+    }
+}
+//# sourceMappingURL=notification-storage.js.map

package/dist/backend/notifications/notification-storage.js.map

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

package/dist/backend/observe/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Observability module - AI interaction logging and metrics
+ */
+export { AIInteractionLogger } from './logger.js';
+export type { AIInteractionLog, LogFilter } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/backend/observe/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/backend/observe/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,YAAY,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC"}

package/dist/backend/observe/index.js

@@ -0,0 +1,5 @@
+/**
+ * Observability module - AI interaction logging and metrics
+ */
+export { AIInteractionLogger } from './logger.js';
+//# sourceMappingURL=index.js.map

package/dist/backend/observe/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/backend/observe/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC"}

package/dist/backend/observe/logger.d.ts

@@ -0,0 +1,26 @@
+/**
+ * AIInteractionLogger
+ *
+ * Records each AI interaction to .loom/logs/ as JSON files.
+ * Each interaction is stored as a separate file: .loom/logs/{messageId}.json
+ */
+import type { AIInteractionLog, LogFilter } from './types.js';
+import type { LoomPaths } from '../loom-paths.js';
+export declare class AIInteractionLogger {
+    private paths;
+    private defaultUserId;
+    constructor(paths: LoomPaths, defaultUserId?: string);
+    /**
+     * Ensure logs directory exists
+     */
+    initialize(): Promise<void>;
+    /**
+     * Record an AI interaction log
+     */
+    log(entry: AIInteractionLog): Promise<void>;
+    /**
+     * Read all logs, optionally filtered
+     */
+    readLogs(filter?: LogFilter): Promise<AIInteractionLog[]>;
+}
+//# sourceMappingURL=logger.d.ts.map

package/dist/backend/observe/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../src/backend/observe/logger.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE9D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAElD,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,KAAK,CAAY;IACzB,OAAO,CAAC,aAAa,CAAS;gBAElB,KAAK,EAAE,SAAS,EAAE,aAAa,SAAU;IAKrD;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAIjC;;OAEG;IACG,GAAG,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAOjD;;OAEG;IACG,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;CAiChE"}

package/dist/backend/observe/logger.js

@@ -0,0 +1,68 @@
+/**
+ * AIInteractionLogger
+ *
+ * Records each AI interaction to .loom/logs/ as JSON files.
+ * Each interaction is stored as a separate file: .loom/logs/{messageId}.json
+ */
+import { promises as fs } from 'fs';
+import path from 'path';
+import { parseDuration } from '../../utils/duration.js';
+export class AIInteractionLogger {
+    paths;
+    defaultUserId;
+    constructor(paths, defaultUserId = 'admin') {
+        this.paths = paths;
+        this.defaultUserId = defaultUserId;
+    }
+    /**
+     * Ensure logs directory exists
+     */
+    async initialize() {
+        await fs.mkdir(this.paths.forUser(this.defaultUserId).logs, { recursive: true });
+    }
+    /**
+     * Record an AI interaction log
+     */
+    async log(entry) {
+        const logsDir = this.paths.forUser(this.defaultUserId).logs;
+        await fs.mkdir(logsDir, { recursive: true });
+        const filePath = path.join(logsDir, `${entry.messageId}.json`);
+        await fs.writeFile(filePath, JSON.stringify(entry, null, 2), 'utf-8');
+    }
+    /**
+     * Read all logs, optionally filtered
+     */
+    async readLogs(filter) {
+        const logsDir = this.paths.forUser(this.defaultUserId).logs;
+        try {
+            const files = await fs.readdir(logsDir);
+            const logs = [];
+            for (const file of files) {
+                if (!file.endsWith('.json'))
+                    continue;
+                try {
+                    const content = await fs.readFile(path.join(logsDir, file), 'utf-8');
+                    const entry = JSON.parse(content);
+                    if (filter?.session && entry.sessionId !== filter.session)
+                        continue;
+                    if (filter?.last) {
+                        const cutoff = Date.now() - parseDuration(filter.last);
+                        if (new Date(entry.timestamp).getTime() < cutoff)
+                            continue;
+                    }
+                    logs.push(entry);
+                }
+                catch {
+                    // Skip malformed files
+                }
+            }
+            // Sort by timestamp descending (most recent first)
+            logs.sort((a, b) => new Date(b.timestamp).getTime() - new Date(a.timestamp).getTime());
+            return logs;
+        }
+        catch {
+            return [];
+        }
+    }
+}
+//# sourceMappingURL=logger.js.map

package/dist/backend/observe/logger.js.map

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

package/dist/backend/observe/types.d.ts

@@ -0,0 +1,26 @@
+/**
+ * AI Interaction Log Types
+ *
+ * Defines the structure for observability logging of AI interactions.
+ */
+export interface AIInteractionLog {
+    sessionId: string;
+    messageId: string;
+    timestamp: string;
+    prompt: string;
+    response: string;
+    duration: number;
+    usage?: {
+        inputTokens: number;
+        outputTokens: number;
+    };
+    mcpCalls: string[];
+    cliCalls: string[];
+    error?: string;
+}
+export interface LogFilter {
+    session?: string;
+    /** Duration string like '1h', '30m', '7d' */
+    last?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/backend/observe/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/backend/observe/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE;QACN,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,SAAS;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6CAA6C;IAC7C,IAAI,CAAC,EAAE,MAAM,CAAC;CACf"}

package/dist/backend/observe/types.js

@@ -0,0 +1,7 @@
+/**
+ * AI Interaction Log Types
+ *
+ * Defines the structure for observability logging of AI interactions.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/backend/observe/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/backend/observe/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/backend/process/engine.d.ts

@@ -0,0 +1,113 @@
+/**
+ * ProcessEngine - Core orchestration engine
+ *
+ * Manages process definitions, triggers, concurrent execution, AI calls, and logging.
+ */
+import type { AIEngine } from '../../types/ai.js';
+import type { AuthConfig } from '../../types/auth.js';
+import type { ProcessesConfig, ProcessDefinition, ProcessStatus, ProcessQueueEntry, ProcessLogEntry, ProcessMetricsAggregate } from '../../types/process.js';
+import { ProcessLogger } from './logger.js';
+import type { ProcessMetricSnapshot, ProcessMetricsViewConfig } from '../../types/process.js';
+import { UserStore } from '../auth/user-store.js';
+import type { EventBus } from '../events/event-bus.js';
+import type { EventRegistry } from '../events/event-registry.js';
+import type { SessionManager } from '../ai/session-manager.js';
+import type { LoomPaths } from '../loom-paths.js';
+export interface ProcessEngineOptions {
+    config: ProcessesConfig;
+    engine: AIEngine;
+    sessionManager: SessionManager;
+    paths: LoomPaths;
+    defaultUserId?: string;
+    eventBus?: EventBus;
+    eventRegistry?: EventRegistry;
+    authConfig?: AuthConfig;
+    userStore?: UserStore;
+    serverUrl?: string;
+}
+export declare class ProcessEngine {
+    private registry;
+    private triggerManager;
+    private queue;
+    private logger;
+    private metricsStore;
+    private engine;
+    private sessionManager;
+    private config;
+    private paths;
+    private defaultUserId;
+    private eventBus?;
+    private eventRegistry?;
+    private authConfig?;
+    private userStore?;
+    private serverUrl?;
+    private isShutdown;
+    constructor(options: ProcessEngineOptions);
+    initialize(): Promise<void>;
+    private registerEventPatterns;
+    addProcess(def: Omit<ProcessDefinition, 'createdAt' | 'updatedAt' | 'paused'>): Promise<ProcessDefinition>;
+    removeProcess(name: string): Promise<boolean>;
+    pauseProcess(name: string): Promise<void>;
+    resumeProcess(name: string): Promise<void>;
+    updateProcess(name: string, updates: Partial<Pick<ProcessDefinition, 'description' | 'cron' | 'cronTimezone' | 'onEvent' | 'eventFilter' | 'eventDebounceMs' | 'prompt' | 'paused' | 'metricsConfig'>>): Promise<ProcessDefinition | undefined>;
+    runProcess(name: string, triggerType: 'cron' | 'event' | 'manual', eventPayload?: Record<string, unknown>): Promise<string>;
+    /** Build AI prompt from process definition */
+    buildProcessPrompt(definition: ProcessDefinition, runId: string, triggerType: 'cron' | 'event' | 'manual', eventPayload?: Record<string, unknown>): Promise<{
+        prompt: string;
+        files?: Array<{
+            name: string;
+            path: string;
+        }>;
+    }>;
+    /** Build the execution instruction telling the model to execute the process */
+    private buildExecutionInstruction;
+    /** Build the Metrics Protocol injection for processes with ## Metrics section */
+    private buildMetricsProtocol;
+    /**
+     * Consume AsyncGenerator<AIChunk> until completion or error.
+     * Timeout is handled by engine.call() internally.
+     * Returns claudeSessionId, usage, and contentBlocks for session persistence.
+     */
+    private consumeAIStream;
+    private tryExecuteNext;
+    private executeEntry;
+    getQueueStatus(): {
+        queued: number;
+        running: number;
+        maxConcurrent: number;
+        entries: ProcessQueueEntry[];
+    };
+    getProcessStatus(name: string): ProcessStatus;
+    listProcesses(options?: {
+        status?: 'active' | 'paused';
+    }): Promise<ProcessDefinition[]>;
+    getProcess(name: string): Promise<ProcessDefinition | undefined>;
+    getRunning(): ProcessQueueEntry[];
+    getLogger(): ProcessLogger;
+    getLogs(processName: string, options?: {
+        limit?: number;
+        offset?: number;
+        from?: string;
+        to?: string;
+    }): Promise<ProcessLogEntry[]>;
+    getLogCount(processName: string, options?: {
+        from?: string;
+        to?: string;
+    }): Promise<number>;
+    getLog(processName: string, runId: string): Promise<ProcessLogEntry | null>;
+    getMetrics(processName: string): Promise<ProcessMetricsAggregate[]>;
+    reportMetric(processName: string, snapshot: Omit<ProcessMetricSnapshot, 'timestamp'> & {
+        timestamp?: string;
+    }): Promise<void>;
+    getMetricSnapshots(processName: string, options?: {
+        metricName?: string;
+        from?: string;
+        to?: string;
+        limit?: number;
+    }): Promise<ProcessMetricSnapshot[]>;
+    getMetricsViewConfig(processName: string): Promise<ProcessMetricsViewConfig | null>;
+    setMetricsViewConfig(processName: string, config: ProcessMetricsViewConfig): Promise<void>;
+    deleteMetricsViewConfig(processName: string): Promise<void>;
+    shutdown(): Promise<void>;
+}
+//# sourceMappingURL=engine.d.ts.map

package/dist/backend/process/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../../src/backend/process/engine.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,QAAQ,EAAmC,MAAM,mBAAmB,CAAC;AAEnF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,KAAK,EACV,eAAe,EACf,iBAAiB,EACjB,aAAa,EACb,iBAAiB,EACjB,eAAe,EACf,uBAAuB,EACxB,MAAM,wBAAwB,CAAC;AAMhC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,OAAO,KAAK,EAAE,qBAAqB,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAC9F,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAElD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,KAAK,EAAE,cAAc,EAAgC,MAAM,0BAA0B,CAAC;AAE7F,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAIlD,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,eAAe,CAAC;IACxB,MAAM,EAAE,QAAQ,CAAC;IACjB,cAAc,EAAE,cAAc,CAAC;IAC/B,KAAK,EAAE,SAAS,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAkB;IAClC,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,KAAK,CAAiB;IAC9B,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,YAAY,CAAsB;IAC1C,OAAO,CAAC,MAAM,CAAW;IACzB,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,KAAK,CAAY;IACzB,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,CAAW;IAC5B,OAAO,CAAC,aAAa,CAAC,CAAgB;IACtC,OAAO,CAAC,UAAU,CAAC,CAAa;IAChC,OAAO,CAAC,SAAS,CAAC,CAAY;IAC9B,OAAO,CAAC,SAAS,CAAC,CAAS;IAC3B,OAAO,CAAC,UAAU,CAAS;gBAEf,OAAO,EAAE,oBAAoB;IAuBnC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IA4BjC,OAAO,CAAC,qBAAqB;IAOvB,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC,iBAAiB,EAAE,WAAW,GAAG,WAAW,GAAG,QAAQ,CAAC,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAmC1G,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAc7C,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAUzC,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAc1C,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,iBAAiB,EAAE,aAAa,GAAG,MAAM,GAAG,cAAc,GAAG,SAAS,GAAG,aAAa,GAAG,iBAAiB,GAAG,QAAQ,GAAG,QAAQ,GAAG,eAAe,CAAC,CAAC,GAAG,OAAO,CAAC,iBAAiB,GAAG,SAAS,CAAC;IAyB/O,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,EAAE,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;IAuBjI,8CAA8C;IACxC,kBAAkB,CACtB,UAAU,EAAE,iBAAiB,EAC7B,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,EACxC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACrC,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE,CAAC;IAiE7E,+EAA+E;IAC/E,OAAO,CAAC,yBAAyB;IAcjC,iFAAiF;IACjF,OAAO,CAAC,oBAAoB;IA8B5B;;;;OAIG;YACW,eAAe;IAmD7B,OAAO,CAAC,cAAc;YAYR,YAAY;IAyK1B,cAAc,IAAI;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,iBAAiB,EAAE,CAAA;KAAE;IAI1G,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa;IAe7C,aAAa,CAAC,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAA;KAAE,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAIvF,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,SAAS,CAAC;IAIhE,UAAU,IAAI,iBAAiB,EAAE;IAIjC,SAAS,IAAI,aAAa;IAIpB,OAAO,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,EAAE,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAInI,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,EAAE,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAI3F,MAAM,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAI3E,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,uBAAuB,EAAE,CAAC;IAMnE,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,CAAC,qBAAqB,EAAE,WAAW,CAAC,GAAG;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ7H,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,EAAE,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,qBAAqB,EAAE,CAAC;IAIxJ,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,wBAAwB,GAAG,IAAI,CAAC;IAInF,oBAAoB,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,wBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC;IAI1F,uBAAuB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI3D,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CA8BhC"}