agentic-qe 1.3.5 → 1.3.6

package/dist/core/memory/dao/BlackboardDAO.js

@@ -0,0 +1,223 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BlackboardDAO = void 0;
+const BaseDAO_1 = require("./BaseDAO");
+/**
+ * BlackboardDAO - Data Access Object for blackboard pattern hints (Table 2b)
+ *
+ * Handles all database operations for the blackboard_hints table
+ * Implements the blackboard architectural pattern for agent coordination
+ */
+class BlackboardDAO extends BaseDAO_1.BaseDAO {
+    async createTable() {
+        await this.run(`
+      CREATE TABLE IF NOT EXISTS blackboard_hints (
+        id TEXT PRIMARY KEY,
+        topic TEXT NOT NULL,
+        message TEXT NOT NULL,
+        priority TEXT NOT NULL CHECK(priority IN ('low', 'medium', 'high', 'critical')),
+        agent_id TEXT NOT NULL,
+        metadata TEXT,
+        created_at INTEGER NOT NULL,
+        expires_at INTEGER,
+        consumed INTEGER DEFAULT 0
+      )
+    `);
+    }
+    async createIndexes() {
+        await this.run(`CREATE INDEX IF NOT EXISTS idx_hints_topic ON blackboard_hints(topic)`);
+        await this.run(`CREATE INDEX IF NOT EXISTS idx_hints_priority ON blackboard_hints(priority)`);
+        await this.run(`CREATE INDEX IF NOT EXISTS idx_hints_agent ON blackboard_hints(agent_id)`);
+        await this.run(`CREATE INDEX IF NOT EXISTS idx_hints_created ON blackboard_hints(created_at)`);
+        await this.run(`CREATE INDEX IF NOT EXISTS idx_hints_expires ON blackboard_hints(expires_at)`);
+        await this.run(`CREATE INDEX IF NOT EXISTS idx_hints_consumed ON blackboard_hints(consumed)`);
+    }
+    /**
+     * Post a hint to the blackboard
+     */
+    async post(hint) {
+        const id = hint.id || this.generateHintId();
+        const expiresAt = hint.expiresAt || null;
+        await this.run(`INSERT INTO blackboard_hints
+       (id, topic, message, priority, agent_id, metadata, created_at, expires_at, consumed)
+       VALUES (?, ?, ?, ?, ?, ?, ?, ?, 0)`, [
+            id,
+            hint.topic,
+            hint.message,
+            hint.priority,
+            hint.agentId,
+            hint.metadata ? JSON.stringify(hint.metadata) : null,
+            hint.createdAt,
+            expiresAt
+        ]);
+        return id;
+    }
+    /**
+     * Read hints from blackboard by topic
+     */
+    async findByTopic(topic, minPriority, limit = 50) {
+        const now = Date.now();
+        let query = `SELECT * FROM blackboard_hints
+                 WHERE topic = ?
+                 AND consumed = 0
+                 AND (expires_at IS NULL OR expires_at > ?)`;
+        const params = [topic, now];
+        if (minPriority) {
+            const priorityOrder = { low: 1, medium: 2, high: 3, critical: 4 };
+            const minPriorityValue = priorityOrder[minPriority];
+            query += ` AND (
+        (priority = 'critical' AND 4 >= ?) OR
+        (priority = 'high' AND 3 >= ?) OR
+        (priority = 'medium' AND 2 >= ?) OR
+        (priority = 'low' AND 1 >= ?)
+      )`;
+            params.push(minPriorityValue, minPriorityValue, minPriorityValue, minPriorityValue);
+        }
+        query += ` ORDER BY
+      CASE priority
+        WHEN 'critical' THEN 1
+        WHEN 'high' THEN 2
+        WHEN 'medium' THEN 3
+        WHEN 'low' THEN 4
+      END,
+      created_at ASC
+      LIMIT ?`;
+        params.push(limit);
+        const rows = await this.queryAll(query, params);
+        return rows.map(row => this.mapToHint(row));
+    }
+    /**
+     * Find hints by agent
+     */
+    async findByAgent(agentId, limit = 50) {
+        const now = Date.now();
+        const rows = await this.queryAll(`SELECT * FROM blackboard_hints
+       WHERE agent_id = ?
+       AND (expires_at IS NULL OR expires_at > ?)
+       ORDER BY created_at DESC
+       LIMIT ?`, [agentId, now, limit]);
+        return rows.map(row => this.mapToHint(row));
+    }
+    /**
+     * Find hints since a timestamp
+     */
+    async findSince(topic, since, limit = 50) {
+        const now = Date.now();
+        const rows = await this.queryAll(`SELECT * FROM blackboard_hints
+       WHERE topic = ?
+       AND created_at > ?
+       AND consumed = 0
+       AND (expires_at IS NULL OR expires_at > ?)
+       ORDER BY created_at ASC
+       LIMIT ?`, [topic, since, now, limit]);
+        return rows.map(row => this.mapToHint(row));
+    }
+    /**
+     * Mark hint as consumed
+     */
+    async markConsumed(id) {
+        await this.run(`UPDATE blackboard_hints SET consumed = 1 WHERE id = ?`, [id]);
+    }
+    /**
+     * Mark multiple hints as consumed
+     */
+    async markManyConsumed(ids) {
+        if (ids.length === 0)
+            return;
+        const placeholders = ids.map(() => '?').join(',');
+        await this.run(`UPDATE blackboard_hints SET consumed = 1 WHERE id IN (${placeholders})`, ids);
+    }
+    /**
+     * Delete a hint by ID
+     */
+    async deleteById(id) {
+        await this.run(`DELETE FROM blackboard_hints WHERE id = ?`, [id]);
+    }
+    /**
+     * Delete hints by topic
+     */
+    async deleteByTopic(topic) {
+        await this.run(`DELETE FROM blackboard_hints WHERE topic = ?`, [topic]);
+    }
+    /**
+     * Delete expired hints
+     */
+    async deleteExpired() {
+        const now = Date.now();
+        await this.run(`DELETE FROM blackboard_hints WHERE expires_at IS NOT NULL AND expires_at <= ?`, [now]);
+    }
+    /**
+     * Delete old consumed hints
+     */
+    async deleteConsumedOlderThan(timestamp) {
+        await this.run(`DELETE FROM blackboard_hints WHERE consumed = 1 AND created_at < ?`, [timestamp]);
+    }
+    /**
+     * Count total hints
+     */
+    async count() {
+        const result = await this.queryOne(`SELECT COUNT(*) as count FROM blackboard_hints`);
+        return result?.count || 0;
+    }
+    /**
+     * Count unconsumed hints by topic
+     */
+    async countByTopic(topic) {
+        const now = Date.now();
+        const result = await this.queryOne(`SELECT COUNT(*) as count FROM blackboard_hints
+       WHERE topic = ?
+       AND consumed = 0
+       AND (expires_at IS NULL OR expires_at > ?)`, [topic, now]);
+        return result?.count || 0;
+    }
+    /**
+     * Get hint statistics by priority
+     */
+    async getPriorityCounts() {
+        const rows = await this.queryAll(`SELECT priority, COUNT(*) as count FROM blackboard_hints
+       WHERE consumed = 0
+       GROUP BY priority`);
+        const counts = {};
+        rows.forEach(row => {
+            counts[row.priority] = row.count;
+        });
+        return counts;
+    }
+    /**
+     * Get hint statistics by topic
+     */
+    async getTopicCounts() {
+        const rows = await this.queryAll(`SELECT topic, COUNT(*) as count FROM blackboard_hints
+       WHERE consumed = 0
+       GROUP BY topic`);
+        const counts = {};
+        rows.forEach(row => {
+            counts[row.topic] = row.count;
+        });
+        return counts;
+    }
+    /**
+     * Generate a unique hint ID
+     */
+    generateHintId() {
+        return `hint_${Date.now()}_${Math.random().toString(36).substring(2, 15)}`;
+    }
+    /**
+     * Map database row to Hint object
+     */
+    mapToHint(row) {
+        return {
+            id: row.id,
+            topic: row.topic,
+            message: row.message,
+            priority: row.priority,
+            agentId: row.agent_id,
+            metadata: row.metadata ? JSON.parse(row.metadata) : undefined,
+            createdAt: row.created_at,
+            expiresAt: row.expires_at,
+            consumed: row.consumed === 1
+        };
+    }
+}
+exports.BlackboardDAO = BlackboardDAO;
+//# sourceMappingURL=BlackboardDAO.js.map

package/dist/core/memory/dao/BlackboardDAO.js.map

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

package/dist/core/memory/dao/EventDAO.d.ts

@@ -0,0 +1,83 @@
+import { BaseDAO } from './BaseDAO';
+/**
+ * Event interface for event streaming
+ */
+export interface Event {
+    id?: string;
+    type: string;
+    payload: any;
+    timestamp?: number;
+    source: string;
+    ttl?: number;
+}
+/**
+ * EventDAO - Data Access Object for event stream (Table 3)
+ *
+ * Handles all database operations for the events table
+ * Manages event streaming and coordination between agents
+ */
+export declare class EventDAO extends BaseDAO {
+    createTable(): Promise<void>;
+    createIndexes(): Promise<void>;
+    /**
+     * Insert a new event
+     */
+    insert(event: Event): Promise<string>;
+    /**
+     * Find an event by ID
+     */
+    findById(id: string): Promise<Event | null>;
+    /**
+     * Find events by type
+     */
+    findByType(type: string, limit?: number): Promise<Event[]>;
+    /**
+     * Find events by source agent
+     */
+    findBySource(source: string, limit?: number): Promise<Event[]>;
+    /**
+     * Find events since a timestamp
+     */
+    findSince(since: number, limit?: number): Promise<Event[]>;
+    /**
+     * Get unconsumed events
+     */
+    findUnconsumed(limit?: number): Promise<Event[]>;
+    /**
+     * Mark event as consumed
+     */
+    markConsumed(id: string): Promise<void>;
+    /**
+     * Delete an event by ID
+     */
+    deleteById(id: string): Promise<void>;
+    /**
+     * Delete events by type
+     */
+    deleteByType(type: string): Promise<void>;
+    /**
+     * Delete expired events
+     */
+    deleteExpired(): Promise<void>;
+    /**
+     * Delete old consumed events
+     */
+    deleteConsumedOlderThan(timestamp: number): Promise<void>;
+    /**
+     * Count total events
+     */
+    count(): Promise<number>;
+    /**
+     * Count events by type
+     */
+    countByType(type: string): Promise<number>;
+    /**
+     * Get event statistics by type
+     */
+    getTypeCounts(): Promise<Record<string, number>>;
+    /**
+     * Map database row to Event object
+     */
+    private mapToEvent;
+}
+//# sourceMappingURL=EventDAO.d.ts.map

package/dist/core/memory/dao/EventDAO.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventDAO.d.ts","sourceRoot":"","sources":["../../../../src/core/memory/dao/EventDAO.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC;;GAEG;AACH,MAAM,WAAW,KAAK;IACpB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,GAAG,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;;;;GAKG;AACH,qBAAa,QAAS,SAAQ,OAAO;IAC7B,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAc5B,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAQpC;;OAEG;IACG,MAAM,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC;IAqB3C;;OAEG;IACG,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC;IAQjD;;OAEG;IACG,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,GAAE,MAAY,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAarE;;OAEG;IACG,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,GAAE,MAAY,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAazE;;OAEG;IACG,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,GAAE,MAAY,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAarE;;OAEG;IACG,cAAc,CAAC,KAAK,GAAE,MAAY,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAa3D;;OAEG;IACG,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAO7C;;OAEG;IACG,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI3C;;OAEG;IACG,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI/C;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAQpC;;OAEG;IACG,uBAAuB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAO/D;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC;IAO9B;;OAEG;IACG,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAQhD;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAYtD;;OAEG;IACH,OAAO,CAAC,UAAU;CAUnB"}

package/dist/core/memory/dao/EventDAO.js

@@ -0,0 +1,177 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EventDAO = void 0;
+const BaseDAO_1 = require("./BaseDAO");
+const SecureRandom_1 = require("../../../utils/SecureRandom");
+/**
+ * EventDAO - Data Access Object for event stream (Table 3)
+ *
+ * Handles all database operations for the events table
+ * Manages event streaming and coordination between agents
+ */
+class EventDAO extends BaseDAO_1.BaseDAO {
+    async createTable() {
+        await this.run(`
+      CREATE TABLE IF NOT EXISTS events (
+        id TEXT PRIMARY KEY,
+        type TEXT NOT NULL,
+        payload TEXT NOT NULL,
+        timestamp INTEGER NOT NULL,
+        source TEXT NOT NULL,
+        expires_at INTEGER,
+        consumed INTEGER DEFAULT 0
+      )
+    `);
+    }
+    async createIndexes() {
+        await this.run(`CREATE INDEX IF NOT EXISTS idx_events_type ON events(type)`);
+        await this.run(`CREATE INDEX IF NOT EXISTS idx_events_timestamp ON events(timestamp)`);
+        await this.run(`CREATE INDEX IF NOT EXISTS idx_events_source ON events(source)`);
+        await this.run(`CREATE INDEX IF NOT EXISTS idx_events_expires ON events(expires_at)`);
+        await this.run(`CREATE INDEX IF NOT EXISTS idx_events_consumed ON events(consumed)`);
+    }
+    /**
+     * Insert a new event
+     */
+    async insert(event) {
+        const id = event.id || SecureRandom_1.SecureRandom.generateId();
+        const timestamp = event.timestamp || Date.now();
+        const expiresAt = event.ttl ? timestamp + (event.ttl * 1000) : null;
+        await this.run(`INSERT INTO events (id, type, payload, timestamp, source, expires_at, consumed)
+       VALUES (?, ?, ?, ?, ?, ?, 0)`, [
+            id,
+            event.type,
+            JSON.stringify(event.payload),
+            timestamp,
+            event.source,
+            expiresAt
+        ]);
+        return id;
+    }
+    /**
+     * Find an event by ID
+     */
+    async findById(id) {
+        const row = await this.queryOne(`SELECT * FROM events WHERE id = ?`, [id]);
+        return row ? this.mapToEvent(row) : null;
+    }
+    /**
+     * Find events by type
+     */
+    async findByType(type, limit = 100) {
+        const now = Date.now();
+        const rows = await this.queryAll(`SELECT * FROM events
+       WHERE type = ?
+       AND (expires_at IS NULL OR expires_at > ?)
+       ORDER BY timestamp DESC
+       LIMIT ?`, [type, now, limit]);
+        return rows.map(row => this.mapToEvent(row));
+    }
+    /**
+     * Find events by source agent
+     */
+    async findBySource(source, limit = 100) {
+        const now = Date.now();
+        const rows = await this.queryAll(`SELECT * FROM events
+       WHERE source = ?
+       AND (expires_at IS NULL OR expires_at > ?)
+       ORDER BY timestamp DESC
+       LIMIT ?`, [source, now, limit]);
+        return rows.map(row => this.mapToEvent(row));
+    }
+    /**
+     * Find events since a timestamp
+     */
+    async findSince(since, limit = 100) {
+        const now = Date.now();
+        const rows = await this.queryAll(`SELECT * FROM events
+       WHERE timestamp > ?
+       AND (expires_at IS NULL OR expires_at > ?)
+       ORDER BY timestamp ASC
+       LIMIT ?`, [since, now, limit]);
+        return rows.map(row => this.mapToEvent(row));
+    }
+    /**
+     * Get unconsumed events
+     */
+    async findUnconsumed(limit = 100) {
+        const now = Date.now();
+        const rows = await this.queryAll(`SELECT * FROM events
+       WHERE consumed = 0
+       AND (expires_at IS NULL OR expires_at > ?)
+       ORDER BY timestamp ASC
+       LIMIT ?`, [now, limit]);
+        return rows.map(row => this.mapToEvent(row));
+    }
+    /**
+     * Mark event as consumed
+     */
+    async markConsumed(id) {
+        await this.run(`UPDATE events SET consumed = 1 WHERE id = ?`, [id]);
+    }
+    /**
+     * Delete an event by ID
+     */
+    async deleteById(id) {
+        await this.run(`DELETE FROM events WHERE id = ?`, [id]);
+    }
+    /**
+     * Delete events by type
+     */
+    async deleteByType(type) {
+        await this.run(`DELETE FROM events WHERE type = ?`, [type]);
+    }
+    /**
+     * Delete expired events
+     */
+    async deleteExpired() {
+        const now = Date.now();
+        await this.run(`DELETE FROM events WHERE expires_at IS NOT NULL AND expires_at <= ?`, [now]);
+    }
+    /**
+     * Delete old consumed events
+     */
+    async deleteConsumedOlderThan(timestamp) {
+        await this.run(`DELETE FROM events WHERE consumed = 1 AND timestamp < ?`, [timestamp]);
+    }
+    /**
+     * Count total events
+     */
+    async count() {
+        const result = await this.queryOne(`SELECT COUNT(*) as count FROM events`);
+        return result?.count || 0;
+    }
+    /**
+     * Count events by type
+     */
+    async countByType(type) {
+        const result = await this.queryOne(`SELECT COUNT(*) as count FROM events WHERE type = ?`, [type]);
+        return result?.count || 0;
+    }
+    /**
+     * Get event statistics by type
+     */
+    async getTypeCounts() {
+        const rows = await this.queryAll(`SELECT type, COUNT(*) as count FROM events GROUP BY type`);
+        const counts = {};
+        rows.forEach(row => {
+            counts[row.type] = row.count;
+        });
+        return counts;
+    }
+    /**
+     * Map database row to Event object
+     */
+    mapToEvent(row) {
+        return {
+            id: row.id,
+            type: row.type,
+            payload: JSON.parse(row.payload),
+            timestamp: row.timestamp,
+            source: row.source,
+            ttl: row.expires_at ? (row.expires_at - row.timestamp) / 1000 : undefined
+        };
+    }
+}
+exports.EventDAO = EventDAO;
+//# sourceMappingURL=EventDAO.js.map

package/dist/core/memory/dao/EventDAO.js.map

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

package/dist/core/memory/dao/MemoryEntryDAO.d.ts

@@ -0,0 +1,57 @@
+import { BaseDAO } from './BaseDAO';
+import { MemoryEntry } from '../SwarmMemoryManager';
+/**
+ * MemoryEntryDAO - Data Access Object for core memory entries (Table 1)
+ *
+ * Handles all database operations for the memory_entries table
+ * Separates data access from business logic
+ */
+export declare class MemoryEntryDAO extends BaseDAO {
+    createTable(): Promise<void>;
+    createIndexes(): Promise<void>;
+    /**
+     * Insert or replace a memory entry
+     */
+    insert(entry: MemoryEntry): Promise<void>;
+    /**
+     * Find a memory entry by key and partition
+     */
+    findByKey(key: string, partition: string, includeExpired?: boolean): Promise<MemoryEntry | null>;
+    /**
+     * Find memory entries by pattern match on key
+     */
+    findByPattern(pattern: string, partition: string, includeExpired?: boolean): Promise<MemoryEntry[]>;
+    /**
+     * Delete a memory entry by key and partition
+     */
+    deleteByKey(key: string, partition: string): Promise<void>;
+    /**
+     * Delete all entries in a partition
+     */
+    deleteByPartition(partition: string): Promise<void>;
+    /**
+     * Delete all expired entries
+     */
+    deleteExpired(): Promise<void>;
+    /**
+     * Count total memory entries
+     */
+    count(): Promise<number>;
+    /**
+     * Get list of distinct partitions
+     */
+    getPartitions(): Promise<string[]>;
+    /**
+     * Get count of entries by access level
+     */
+    getAccessLevelCounts(): Promise<Record<string, number>>;
+    /**
+     * Find entries modified since a timestamp (for QUIC sync)
+     */
+    findModifiedSince(since: number, partition?: string): Promise<MemoryEntry[]>;
+    /**
+     * Map database row to MemoryEntry object
+     */
+    private mapToEntry;
+}
+//# sourceMappingURL=MemoryEntryDAO.d.ts.map

package/dist/core/memory/dao/MemoryEntryDAO.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MemoryEntryDAO.d.ts","sourceRoot":"","sources":["../../../../src/core/memory/dao/MemoryEntryDAO.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EACL,WAAW,EAGZ,MAAM,uBAAuB,CAAC;AAE/B;;;;;GAKG;AACH,qBAAa,cAAe,SAAQ,OAAO;IACnC,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAkB5B,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAOpC;;OAEG;IACG,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAoB/C;;OAEG;IACG,SAAS,CACb,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,MAAM,EACjB,cAAc,GAAE,OAAe,GAC9B,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAc9B;;OAEG;IACG,aAAa,CACjB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,cAAc,GAAE,OAAe,GAC9B,OAAO,CAAC,WAAW,EAAE,CAAC;IAczB;;OAEG;IACG,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOhE;;OAEG;IACG,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIzD;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAQpC;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC;IAO9B;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAOxC;;OAEG;IACG,oBAAoB,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAY7D;;OAEG;IACG,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAelF;;OAEG;IACH,OAAO,CAAC,UAAU;CAanB"}