agentic-qe 2.7.1 → 2.7.2

package/dist/persistence/migrations/index.d.ts

@@ -0,0 +1,110 @@
+/**
+ * Database Migration System
+ *
+ * Manages schema migrations for the Agentic QE database.
+ * Migrations are versioned and tracked to ensure consistency
+ * across all installations.
+ *
+ * @module persistence/migrations
+ */
+import Database from 'better-sqlite3';
+export interface Migration {
+    version: number;
+    name: string;
+    description: string;
+    up: (db: Database.Database) => void;
+    down?: (db: Database.Database) => void;
+}
+export interface MigrationResult {
+    version: number;
+    name: string;
+    success: boolean;
+    error?: string;
+    duration: number;
+}
+export interface MigrationStatus {
+    currentVersion: number;
+    latestVersion: number;
+    pendingMigrations: number;
+    appliedMigrations: Array<{
+        version: number;
+        name: string;
+        applied_at: string;
+    }>;
+}
+/**
+ * Migration Runner
+ *
+ * Handles running database migrations in order with version tracking.
+ */
+export declare class MigrationRunner {
+    private db;
+    private migrations;
+    constructor(db: Database.Database);
+    /**
+     * Ensure the migrations tracking table exists
+     */
+    private ensureMigrationTable;
+    /**
+     * Register a migration
+     */
+    register(migration: Migration): void;
+    /**
+     * Register multiple migrations
+     */
+    registerAll(migrations: Migration[]): void;
+    /**
+     * Get current schema version
+     */
+    getCurrentVersion(): number;
+    /**
+     * Get latest available migration version
+     */
+    getLatestVersion(): number;
+    /**
+     * Get pending migrations
+     */
+    getPendingMigrations(): Migration[];
+    /**
+     * Get migration status
+     */
+    getStatus(): MigrationStatus;
+    /**
+     * Run all pending migrations
+     */
+    runAll(): MigrationResult[];
+    /**
+     * Run a single migration
+     */
+    runOne(migration: Migration): MigrationResult;
+    /**
+     * Rollback the last migration
+     */
+    rollbackLast(): MigrationResult | null;
+    /**
+     * Check if a specific table exists
+     */
+    tableExists(tableName: string): boolean;
+    /**
+     * Check if a column exists in a table
+     */
+    columnExists(tableName: string, columnName: string): boolean;
+    /**
+     * Safe add column - only adds if it doesn't exist
+     */
+    safeAddColumn(tableName: string, columnName: string, columnDef: string): void;
+    /**
+     * Safe create table - creates if doesn't exist
+     */
+    safeCreateTable(sql: string): void;
+}
+/**
+ * Get default database path
+ */
+export declare function getDefaultDbPath(): string;
+/**
+ * Run migrations on a database
+ */
+export declare function runMigrations(dbPath?: string, verbose?: boolean): Promise<MigrationResult[]>;
+export { MigrationRunner as default };
+//# sourceMappingURL=index.d.ts.map

package/dist/persistence/migrations/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/persistence/migrations/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAItC,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,EAAE,EAAE,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,KAAK,IAAI,CAAC;IACpC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,KAAK,IAAI,CAAC;CACxC;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,iBAAiB,EAAE,KAAK,CAAC;QACvB,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC,CAAC;CACJ;AAED;;;;GAIG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,EAAE,CAAoB;IAC9B,OAAO,CAAC,UAAU,CAAmB;gBAEzB,EAAE,EAAE,QAAQ,CAAC,QAAQ;IAKjC;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAc5B;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI;IAKpC;;OAEG;IACH,WAAW,CAAC,UAAU,EAAE,SAAS,EAAE,GAAG,IAAI;IAI1C;;OAEG;IACH,iBAAiB,IAAI,MAAM;IAQ3B;;OAEG;IACH,gBAAgB,IAAI,MAAM;IAK1B;;OAEG;IACH,oBAAoB,IAAI,SAAS,EAAE;IAKnC;;OAEG;IACH,SAAS,IAAI,eAAe;IAiB5B;;OAEG;IACH,MAAM,IAAI,eAAe,EAAE;IAgB3B;;OAEG;IACH,MAAM,CAAC,SAAS,EAAE,SAAS,GAAG,eAAe;IAmD7C;;OAEG;IACH,YAAY,IAAI,eAAe,GAAG,IAAI;IAyCtC;;OAEG;IACH,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAOvC;;OAEG;IACH,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO;IAS5D;;OAEG;IACH,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAM7E;;OAEG;IACH,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;CAGnC;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAED;;GAEG;AACH,wBAAsB,aAAa,CACjC,MAAM,GAAE,MAA2B,EACnC,OAAO,GAAE,OAAe,GACvB,OAAO,CAAC,eAAe,EAAE,CAAC,CAiC5B;AAED,OAAO,EAAE,eAAe,IAAI,OAAO,EAAE,CAAC"}

package/dist/persistence/migrations/index.js

@@ -0,0 +1,303 @@
+"use strict";
+/**
+ * Database Migration System
+ *
+ * Manages schema migrations for the Agentic QE database.
+ * Migrations are versioned and tracked to ensure consistency
+ * across all installations.
+ *
+ * @module persistence/migrations
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = exports.MigrationRunner = void 0;
+exports.getDefaultDbPath = getDefaultDbPath;
+exports.runMigrations = runMigrations;
+const better_sqlite3_1 = __importDefault(require("better-sqlite3"));
+const path = __importStar(require("path"));
+/**
+ * Migration Runner
+ *
+ * Handles running database migrations in order with version tracking.
+ */
+class MigrationRunner {
+    constructor(db) {
+        this.migrations = [];
+        this.db = db;
+        this.ensureMigrationTable();
+    }
+    /**
+     * Ensure the migrations tracking table exists
+     */
+    ensureMigrationTable() {
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS schema_migrations (
+        version INTEGER PRIMARY KEY,
+        name TEXT NOT NULL,
+        description TEXT,
+        applied_at TEXT NOT NULL,
+        checksum TEXT
+      );
+
+      CREATE INDEX IF NOT EXISTS idx_migrations_version ON schema_migrations(version);
+    `);
+    }
+    /**
+     * Register a migration
+     */
+    register(migration) {
+        this.migrations.push(migration);
+        this.migrations.sort((a, b) => a.version - b.version);
+    }
+    /**
+     * Register multiple migrations
+     */
+    registerAll(migrations) {
+        migrations.forEach(m => this.register(m));
+    }
+    /**
+     * Get current schema version
+     */
+    getCurrentVersion() {
+        const row = this.db.prepare('SELECT MAX(version) as version FROM schema_migrations').get();
+        return row?.version ?? 0;
+    }
+    /**
+     * Get latest available migration version
+     */
+    getLatestVersion() {
+        if (this.migrations.length === 0)
+            return 0;
+        return Math.max(...this.migrations.map(m => m.version));
+    }
+    /**
+     * Get pending migrations
+     */
+    getPendingMigrations() {
+        const currentVersion = this.getCurrentVersion();
+        return this.migrations.filter(m => m.version > currentVersion);
+    }
+    /**
+     * Get migration status
+     */
+    getStatus() {
+        const currentVersion = this.getCurrentVersion();
+        const latestVersion = this.getLatestVersion();
+        const pending = this.getPendingMigrations();
+        const applied = this.db.prepare('SELECT version, name, applied_at FROM schema_migrations ORDER BY version').all();
+        return {
+            currentVersion,
+            latestVersion,
+            pendingMigrations: pending.length,
+            appliedMigrations: applied
+        };
+    }
+    /**
+     * Run all pending migrations
+     */
+    runAll() {
+        const results = [];
+        const pending = this.getPendingMigrations();
+        for (const migration of pending) {
+            const result = this.runOne(migration);
+            results.push(result);
+            if (!result.success) {
+                break; // Stop on first failure
+            }
+        }
+        return results;
+    }
+    /**
+     * Run a single migration
+     */
+    runOne(migration) {
+        const startTime = Date.now();
+        try {
+            // Check if already applied
+            const existing = this.db.prepare('SELECT version FROM schema_migrations WHERE version = ?').get(migration.version);
+            if (existing) {
+                return {
+                    version: migration.version,
+                    name: migration.name,
+                    success: true,
+                    duration: 0
+                };
+            }
+            // Run migration in transaction
+            this.db.transaction(() => {
+                migration.up(this.db);
+                // Record migration
+                this.db.prepare(`
+          INSERT INTO schema_migrations (version, name, description, applied_at)
+          VALUES (?, ?, ?, ?)
+        `).run(migration.version, migration.name, migration.description, new Date().toISOString());
+            })();
+            return {
+                version: migration.version,
+                name: migration.name,
+                success: true,
+                duration: Date.now() - startTime
+            };
+        }
+        catch (error) {
+            return {
+                version: migration.version,
+                name: migration.name,
+                success: false,
+                error: error instanceof Error ? error.message : String(error),
+                duration: Date.now() - startTime
+            };
+        }
+    }
+    /**
+     * Rollback the last migration
+     */
+    rollbackLast() {
+        const currentVersion = this.getCurrentVersion();
+        if (currentVersion === 0)
+            return null;
+        const migration = this.migrations.find(m => m.version === currentVersion);
+        if (!migration || !migration.down) {
+            return {
+                version: currentVersion,
+                name: migration?.name ?? 'unknown',
+                success: false,
+                error: 'Migration does not support rollback',
+                duration: 0
+            };
+        }
+        const startTime = Date.now();
+        try {
+            this.db.transaction(() => {
+                migration.down(this.db);
+                this.db.prepare('DELETE FROM schema_migrations WHERE version = ?')
+                    .run(currentVersion);
+            })();
+            return {
+                version: currentVersion,
+                name: migration.name,
+                success: true,
+                duration: Date.now() - startTime
+            };
+        }
+        catch (error) {
+            return {
+                version: currentVersion,
+                name: migration.name,
+                success: false,
+                error: error instanceof Error ? error.message : String(error),
+                duration: Date.now() - startTime
+            };
+        }
+    }
+    /**
+     * Check if a specific table exists
+     */
+    tableExists(tableName) {
+        const row = this.db.prepare("SELECT name FROM sqlite_master WHERE type='table' AND name=?").get(tableName);
+        return !!row;
+    }
+    /**
+     * Check if a column exists in a table
+     */
+    columnExists(tableName, columnName) {
+        try {
+            const columns = this.db.prepare(`PRAGMA table_info(${tableName})`).all();
+            return columns.some(c => c.name === columnName);
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Safe add column - only adds if it doesn't exist
+     */
+    safeAddColumn(tableName, columnName, columnDef) {
+        if (!this.columnExists(tableName, columnName)) {
+            this.db.exec(`ALTER TABLE ${tableName} ADD COLUMN ${columnName} ${columnDef}`);
+        }
+    }
+    /**
+     * Safe create table - creates if doesn't exist
+     */
+    safeCreateTable(sql) {
+        this.db.exec(sql);
+    }
+}
+exports.MigrationRunner = MigrationRunner;
+exports.default = MigrationRunner;
+/**
+ * Get default database path
+ */
+function getDefaultDbPath() {
+    return path.join(process.cwd(), '.agentic-qe', 'memory.db');
+}
+/**
+ * Run migrations on a database
+ */
+async function runMigrations(dbPath = getDefaultDbPath(), verbose = false) {
+    const db = new better_sqlite3_1.default(dbPath);
+    try {
+        const runner = new MigrationRunner(db);
+        // Register all migrations
+        const { allMigrations } = await Promise.resolve().then(() => __importStar(require('./all-migrations')));
+        runner.registerAll(allMigrations);
+        if (verbose) {
+            const status = runner.getStatus();
+            console.log(`Current version: ${status.currentVersion}`);
+            console.log(`Latest version: ${status.latestVersion}`);
+            console.log(`Pending migrations: ${status.pendingMigrations}`);
+        }
+        const results = runner.runAll();
+        if (verbose) {
+            for (const result of results) {
+                if (result.success) {
+                    console.log(`✓ Migration ${result.version}: ${result.name} (${result.duration}ms)`);
+                }
+                else {
+                    console.log(`✗ Migration ${result.version}: ${result.name} - ${result.error}`);
+                }
+            }
+        }
+        return results;
+    }
+    finally {
+        db.close();
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/persistence/migrations/index.js.map

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

package/dist/planning/GOAPPlanner.d.ts

@@ -0,0 +1,128 @@
+/**
+ * GOAP Planner - A* Search Algorithm for Goal-Oriented Action Planning
+ *
+ * Implements optimal plan finding using A* search with:
+ * - Precondition checking
+ * - Effect application
+ * - Heuristic calculation
+ * - Plan reconstruction
+ *
+ * @module planning/GOAPPlanner
+ * @version 1.0.0
+ */
+import Database from 'better-sqlite3';
+import { WorldState, StateConditions, GOAPAction, GOAPPlan, PlanConstraints } from './types';
+/**
+ * GOAP Planner using A* search algorithm
+ */
+export declare class GOAPPlanner {
+    private actionLibrary;
+    private db;
+    private logger;
+    private actionsLoaded;
+    constructor(db: Database.Database);
+    /**
+     * Load action library from database (merges with programmatic actions)
+     */
+    loadActionsFromDatabase(): Promise<void>;
+    /**
+     * Add actions programmatically (for testing or bootstrap)
+     */
+    addActions(actions: GOAPAction[]): void;
+    /**
+     * Clear action library
+     */
+    clearActions(): void;
+    /**
+     * Get current action library
+     */
+    getActionLibrary(): GOAPAction[];
+    /**
+     * Ensure GOAP schema exists (creates missing tables)
+     */
+    ensureSchema(): void;
+    /**
+     * Seed actions to database (upsert - won't duplicate)
+     * Call this with allActions to persist the action library
+     */
+    seedActions(actions: GOAPAction[]): number;
+    /**
+     * Get action count from database
+     */
+    getActionCountFromDatabase(): number;
+    /**
+     * A* search to find optimal plan from current to goal state
+     */
+    findPlan(currentState: WorldState, goalConditions: StateConditions, constraints?: PlanConstraints): Promise<GOAPPlan | null>;
+    /**
+     * Calculate heuristic distance to goal (admissible)
+     */
+    private calculateHeuristic;
+    /**
+     * Check if goal conditions are met
+     */
+    goalMet(state: WorldState, goal: StateConditions): boolean;
+    /**
+     * Check if all conditions are satisfied
+     */
+    conditionsMet(state: WorldState, conditions: StateConditions): boolean;
+    /**
+     * Check a single condition
+     */
+    private checkCondition;
+    /**
+     * Check if action preconditions are met
+     */
+    preconditionsMet(state: WorldState, preconditions: StateConditions): boolean;
+    /**
+     * Get actions whose preconditions are satisfied
+     */
+    private getApplicableActions;
+    /**
+     * Calculate effective action cost
+     */
+    private getActionCost;
+    /**
+     * Apply action effects to state
+     */
+    applyAction(state: WorldState, action: GOAPAction): WorldState;
+    /**
+     * Apply a single effect to state
+     */
+    private applyEffect;
+    /**
+     * Get value from nested state using dot notation
+     */
+    getStateValue(state: WorldState, key: string): any;
+    /**
+     * Set value in nested state using dot notation
+     */
+    private setStateValue;
+    /**
+     * Create hash of state for deduplication
+     */
+    private stateHash;
+    /**
+     * Deep clone world state
+     */
+    private cloneState;
+    /**
+     * Reconstruct plan from goal node
+     */
+    private reconstructPlan;
+    /**
+     * Persist plan to database
+     */
+    persistPlan(plan: GOAPPlan, initialState: WorldState, goalId?: string): Promise<void>;
+    /**
+     * Update action success rate based on execution outcome
+     */
+    updateActionSuccessRate(actionId: string, success: boolean): Promise<void>;
+    /**
+     * Find alternative plans (for presenting options)
+     */
+    findAlternativePlans(currentState: WorldState, goalConditions: StateConditions, constraints?: PlanConstraints, maxAlternatives?: number): Promise<GOAPPlan[]>;
+}
+export declare function getSharedGOAPPlanner(db: Database.Database): GOAPPlanner;
+export declare function resetSharedGOAPPlanner(): void;
+//# sourceMappingURL=GOAPPlanner.d.ts.map

package/dist/planning/GOAPPlanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GOAPPlanner.d.ts","sourceRoot":"","sources":["../../src/planning/GOAPPlanner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAEtC,OAAO,EACL,UAAU,EACV,eAAe,EAIf,UAAU,EACV,QAAQ,EACR,eAAe,EAIhB,MAAM,SAAS,CAAC;AAEjB;;GAEG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,aAAa,CAAoB;IACzC,OAAO,CAAC,EAAE,CAAoB;IAC9B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,aAAa,CAAS;gBAElB,EAAE,EAAE,QAAQ,CAAC,QAAQ;IAKjC;;OAEG;IACG,uBAAuB,IAAI,OAAO,CAAC,IAAI,CAAC;IAmC9C;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,IAAI;IAIvC;;OAEG;IACH,YAAY,IAAI,IAAI;IAKpB;;OAEG;IACH,gBAAgB,IAAI,UAAU,EAAE;IAIhC;;OAEG;IACH,YAAY,IAAI,IAAI;IA+BpB;;;OAGG;IACH,WAAW,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,MAAM;IA6C1C;;OAEG;IACH,0BAA0B,IAAI,MAAM;IAKpC;;OAEG;IACG,QAAQ,CACZ,YAAY,EAAE,UAAU,EACxB,cAAc,EAAE,eAAe,EAC/B,WAAW,CAAC,EAAE,eAAe,GAC5B,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;IA2G3B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IA4D1B;;OAEG;IACH,OAAO,CAAC,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,eAAe,GAAG,OAAO;IAI1D;;OAEG;IACH,aAAa,CAAC,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,eAAe,GAAG,OAAO;IAStE;;OAEG;IACH,OAAO,CAAC,cAAc;IAiDtB;;OAEG;IACH,gBAAgB,CAAC,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,eAAe,GAAG,OAAO;IAI5E;;OAEG;IACH,OAAO,CAAC,oBAAoB;IA+B5B;;OAEG;IACH,OAAO,CAAC,aAAa;IAkBrB;;OAEG;IACH,WAAW,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,GAAG,UAAU;IAU9D;;OAEG;IACH,OAAO,CAAC,WAAW;IAsDnB;;OAEG;IACH,aAAa,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,GAAG,GAAG;IAclD;;OAEG;IACH,OAAO,CAAC,aAAa;IAerB;;OAEG;IACH,OAAO,CAAC,SAAS;IAsBjB;;OAEG;IACH,OAAO,CAAC,UAAU;IAIlB;;OAEG;IACH,OAAO,CAAC,eAAe;IAuBvB;;OAEG;IACG,WAAW,CAAC,IAAI,EAAE,QAAQ,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAuB3F;;OAEG;IACG,uBAAuB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IA4BhF;;OAEG;IACG,oBAAoB,CACxB,YAAY,EAAE,UAAU,EACxB,cAAc,EAAE,eAAe,EAC/B,WAAW,CAAC,EAAE,eAAe,EAC7B,eAAe,SAAI,GAClB,OAAO,CAAC,QAAQ,EAAE,CAAC;CAuBvB;AAOD,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,WAAW,CAKvE;AAED,wBAAgB,sBAAsB,IAAI,IAAI,CAE7C"}