@jungjaehoon/mama-os 0.1.1

package/dist/scheduler/job-lock.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Job Lock for preventing concurrent execution
+ *
+ * Simple in-memory lock mechanism for single-process environments.
+ * For multi-process scenarios, use a distributed lock (Redis, etc.)
+ */
+/**
+ * Lock information
+ */
+export interface LockInfo {
+    /** Job ID */
+    jobId: string;
+    /** When lock was acquired */
+    acquiredAt: Date;
+    /** Lock timeout in ms (0 = no timeout) */
+    timeout: number;
+}
+export declare class JobLock {
+    private locks;
+    private readonly defaultTimeout;
+    /**
+     * Create a new JobLock instance
+     *
+     * @param defaultTimeout - Default lock timeout in ms (0 = no timeout)
+     */
+    constructor(defaultTimeout?: number);
+    /**
+     * Attempt to acquire a lock for a job
+     *
+     * @param jobId - Job identifier
+     * @param timeout - Lock timeout in ms (overrides default)
+     * @returns true if lock acquired, false if already locked
+     */
+    acquire(jobId: string, timeout?: number): boolean;
+    /**
+     * Release a lock for a job
+     *
+     * @param jobId - Job identifier
+     * @returns true if lock was released, false if not locked
+     */
+    release(jobId: string): boolean;
+    /**
+     * Check if a job is currently locked
+     *
+     * Also handles timeout expiration.
+     *
+     * @param jobId - Job identifier
+     * @returns true if locked, false otherwise
+     */
+    isLocked(jobId: string): boolean;
+    /**
+     * Get lock information for a job
+     *
+     * @param jobId - Job identifier
+     * @returns Lock info or null if not locked
+     */
+    getLockInfo(jobId: string): LockInfo | null;
+    /**
+     * Get all currently held locks
+     *
+     * @returns Array of lock info
+     */
+    getAllLocks(): LockInfo[];
+    /**
+     * Release all locks
+     */
+    releaseAll(): void;
+    /**
+     * Get the number of currently held locks
+     */
+    get size(): number;
+    /**
+     * Execute a function with a lock
+     *
+     * Automatically acquires and releases lock around the function.
+     *
+     * @param jobId - Job identifier
+     * @param fn - Function to execute
+     * @param timeout - Lock timeout in ms
+     * @returns Result of the function
+     * @throws Error if lock cannot be acquired
+     */
+    withLock<T>(jobId: string, fn: () => Promise<T>, timeout?: number): Promise<T>;
+}
+//# sourceMappingURL=job-lock.d.ts.map

package/dist/scheduler/job-lock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"job-lock.d.ts","sourceRoot":"","sources":["../../src/scheduler/job-lock.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,aAAa;IACb,KAAK,EAAE,MAAM,CAAC;IACd,6BAA6B;IAC7B,UAAU,EAAE,IAAI,CAAC;IACjB,0CAA0C;IAC1C,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,OAAO;IAClB,OAAO,CAAC,KAAK,CAAoC;IACjD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IAExC;;;;OAIG;gBACS,cAAc,SAAI;IAI9B;;;;;;OAMG;IACH,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO;IAgBjD;;;;;OAKG;IACH,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAI/B;;;;;;;OAOG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAoBhC;;;;;OAKG;IACH,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI;IAO3C;;;;OAIG;IACH,WAAW,IAAI,QAAQ,EAAE;IAazB;;OAEG;IACH,UAAU,IAAI,IAAI;IAIlB;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;;;;;;;;;OAUG;IACG,QAAQ,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;CAWrF"}

package/dist/scheduler/job-lock.js

@@ -0,0 +1,137 @@
+"use strict";
+/**
+ * Job Lock for preventing concurrent execution
+ *
+ * Simple in-memory lock mechanism for single-process environments.
+ * For multi-process scenarios, use a distributed lock (Redis, etc.)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JobLock = void 0;
+class JobLock {
+    locks = new Map();
+    defaultTimeout;
+    /**
+     * Create a new JobLock instance
+     *
+     * @param defaultTimeout - Default lock timeout in ms (0 = no timeout)
+     */
+    constructor(defaultTimeout = 0) {
+        this.defaultTimeout = defaultTimeout;
+    }
+    /**
+     * Attempt to acquire a lock for a job
+     *
+     * @param jobId - Job identifier
+     * @param timeout - Lock timeout in ms (overrides default)
+     * @returns true if lock acquired, false if already locked
+     */
+    acquire(jobId, timeout) {
+        // Check if already locked
+        if (this.isLocked(jobId)) {
+            return false;
+        }
+        // Acquire lock
+        this.locks.set(jobId, {
+            jobId,
+            acquiredAt: new Date(),
+            timeout: timeout ?? this.defaultTimeout,
+        });
+        return true;
+    }
+    /**
+     * Release a lock for a job
+     *
+     * @param jobId - Job identifier
+     * @returns true if lock was released, false if not locked
+     */
+    release(jobId) {
+        return this.locks.delete(jobId);
+    }
+    /**
+     * Check if a job is currently locked
+     *
+     * Also handles timeout expiration.
+     *
+     * @param jobId - Job identifier
+     * @returns true if locked, false otherwise
+     */
+    isLocked(jobId) {
+        const lock = this.locks.get(jobId);
+        if (!lock) {
+            return false;
+        }
+        // Check for timeout expiration
+        if (lock.timeout > 0) {
+            const elapsed = Date.now() - lock.acquiredAt.getTime();
+            if (elapsed >= lock.timeout) {
+                // Lock expired, release it
+                this.locks.delete(jobId);
+                return false;
+            }
+        }
+        return true;
+    }
+    /**
+     * Get lock information for a job
+     *
+     * @param jobId - Job identifier
+     * @returns Lock info or null if not locked
+     */
+    getLockInfo(jobId) {
+        if (!this.isLocked(jobId)) {
+            return null;
+        }
+        return this.locks.get(jobId) ?? null;
+    }
+    /**
+     * Get all currently held locks
+     *
+     * @returns Array of lock info
+     */
+    getAllLocks() {
+        // Filter out expired locks
+        const activeLocks = [];
+        for (const [jobId, lock] of this.locks) {
+            if (this.isLocked(jobId)) {
+                activeLocks.push(lock);
+            }
+        }
+        return activeLocks;
+    }
+    /**
+     * Release all locks
+     */
+    releaseAll() {
+        this.locks.clear();
+    }
+    /**
+     * Get the number of currently held locks
+     */
+    get size() {
+        return this.getAllLocks().length;
+    }
+    /**
+     * Execute a function with a lock
+     *
+     * Automatically acquires and releases lock around the function.
+     *
+     * @param jobId - Job identifier
+     * @param fn - Function to execute
+     * @param timeout - Lock timeout in ms
+     * @returns Result of the function
+     * @throws Error if lock cannot be acquired
+     */
+    async withLock(jobId, fn, timeout) {
+        if (!this.acquire(jobId, timeout)) {
+            throw new Error(`Failed to acquire lock for job: ${jobId}`);
+        }
+        try {
+            return await fn();
+        }
+        finally {
+            this.release(jobId);
+        }
+    }
+}
+exports.JobLock = JobLock;
+//# sourceMappingURL=job-lock.js.map

package/dist/scheduler/job-lock.js.map

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

package/dist/scheduler/recovery.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Schedule recovery module
+ *
+ * Recovers enabled schedules from the database on server startup
+ * and registers them with the scheduler.
+ */
+import { CronScheduler } from './cron-scheduler.js';
+import { ScheduleStore } from './schedule-store.js';
+/**
+ * Recovery result information
+ */
+export interface RecoveryResult {
+    /** Number of schedules recovered */
+    recovered: number;
+    /** Number of schedules that failed to recover */
+    failed: number;
+    /** Details of recovered schedules */
+    schedules: Array<{
+        id: string;
+        name: string;
+        cronExpr: string;
+        success: boolean;
+        error?: string;
+    }>;
+}
+/**
+ * Recovery options
+ */
+export interface RecoveryOptions {
+    /** Whether to log recovery progress */
+    verbose?: boolean;
+    /** Logger function (defaults to console.log) */
+    logger?: (message: string) => void;
+}
+/**
+ * Recover enabled schedules from the database and register with scheduler
+ *
+ * @param scheduler - The CronScheduler instance
+ * @param store - The ScheduleStore instance
+ * @param options - Recovery options
+ * @returns Recovery result with details
+ */
+export declare function recoverSchedules(scheduler: CronScheduler, store: ScheduleStore, options?: RecoveryOptions): RecoveryResult;
+/**
+ * Sync scheduler state with database
+ *
+ * Updates next_run times in the database based on scheduler state.
+ * Call this after recovery to ensure database reflects current scheduler state.
+ *
+ * @param scheduler - The CronScheduler instance
+ * @param store - The ScheduleStore instance
+ */
+export declare function syncSchedulerState(scheduler: CronScheduler, store: ScheduleStore): void;
+/**
+ * Create a schedule store event handler that persists changes to database
+ *
+ * @param store - The ScheduleStore instance
+ * @returns Event handler function for scheduler events
+ */
+export declare function createPersistenceHandler(store: ScheduleStore): {
+    /**
+     * Handle job started event
+     */
+    onJobStarted(jobId: string): string;
+    /**
+     * Handle job completed event
+     */
+    onJobCompleted(logId: string, success: boolean, output?: string, error?: string): void;
+    /**
+     * Handle job state change (enabled/disabled)
+     */
+    onJobStateChanged(jobId: string, enabled: boolean): void;
+    /**
+     * Handle next run time update
+     */
+    onNextRunUpdated(jobId: string, nextRun: Date | undefined): void;
+};
+//# sourceMappingURL=recovery.d.ts.map

package/dist/scheduler/recovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recovery.d.ts","sourceRoot":"","sources":["../../src/scheduler/recovery.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,oCAAoC;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,iDAAiD;IACjD,MAAM,EAAE,MAAM,CAAC;IACf,qCAAqC;IACrC,SAAS,EAAE,KAAK,CAAC;QACf,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,OAAO,CAAC;QACjB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC,CAAC;CACJ;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,uCAAuC;IACvC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,gDAAgD;IAChD,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACpC;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,aAAa,EACxB,KAAK,EAAE,aAAa,EACpB,OAAO,GAAE,eAAoB,GAC5B,cAAc,CA0DhB;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,aAAa,EAAE,KAAK,EAAE,aAAa,GAAG,IAAI,CAUvF;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,aAAa;IAEzD;;OAEG;wBACiB,MAAM,GAAG,MAAM;IAInC;;OAEG;0BACmB,MAAM,WAAW,OAAO,WAAW,MAAM,UAAU,MAAM,GAAG,IAAI;IAItF;;OAEG;6BACsB,MAAM,WAAW,OAAO,GAAG,IAAI;IAIxD;;OAEG;4BACqB,MAAM,WAAW,IAAI,GAAG,SAAS,GAAG,IAAI;EAMnE"}

package/dist/scheduler/recovery.js

@@ -0,0 +1,124 @@
+"use strict";
+/**
+ * Schedule recovery module
+ *
+ * Recovers enabled schedules from the database on server startup
+ * and registers them with the scheduler.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.recoverSchedules = recoverSchedules;
+exports.syncSchedulerState = syncSchedulerState;
+exports.createPersistenceHandler = createPersistenceHandler;
+/**
+ * Recover enabled schedules from the database and register with scheduler
+ *
+ * @param scheduler - The CronScheduler instance
+ * @param store - The ScheduleStore instance
+ * @param options - Recovery options
+ * @returns Recovery result with details
+ */
+function recoverSchedules(scheduler, store, options = {}) {
+    const { verbose = false, logger = console.log } = options;
+    const result = {
+        recovered: 0,
+        failed: 0,
+        schedules: [],
+    };
+    // Get all enabled schedules from database
+    const enabledJobs = store.listEnabledJobs();
+    if (verbose) {
+        logger(`Found ${enabledJobs.length} enabled schedules to recover`);
+    }
+    for (const job of enabledJobs) {
+        const scheduleResult = {
+            id: job.id,
+            name: job.name,
+            cronExpr: job.cron_expr,
+            success: false,
+            error: undefined,
+        };
+        try {
+            // Register the job with the scheduler
+            scheduler.addJob({
+                id: job.id,
+                name: job.name,
+                cronExpr: job.cron_expr,
+                prompt: job.prompt,
+                enabled: true,
+            });
+            scheduleResult.success = true;
+            result.recovered++;
+            if (verbose) {
+                logger(`  ✓ Recovered: ${job.name} (${job.cron_expr})`);
+            }
+        }
+        catch (error) {
+            scheduleResult.error = error instanceof Error ? error.message : String(error);
+            result.failed++;
+            if (verbose) {
+                logger(`  ✗ Failed: ${job.name} - ${scheduleResult.error}`);
+            }
+        }
+        result.schedules.push(scheduleResult);
+    }
+    if (verbose) {
+        logger(`Recovery complete: ${result.recovered} recovered, ${result.failed} failed`);
+    }
+    return result;
+}
+/**
+ * Sync scheduler state with database
+ *
+ * Updates next_run times in the database based on scheduler state.
+ * Call this after recovery to ensure database reflects current scheduler state.
+ *
+ * @param scheduler - The CronScheduler instance
+ * @param store - The ScheduleStore instance
+ */
+function syncSchedulerState(scheduler, store) {
+    const jobs = scheduler.listJobs();
+    for (const job of jobs) {
+        if (job.nextRun) {
+            store.updateJob(job.id, {
+                next_run: job.nextRun.getTime(),
+            });
+        }
+    }
+}
+/**
+ * Create a schedule store event handler that persists changes to database
+ *
+ * @param store - The ScheduleStore instance
+ * @returns Event handler function for scheduler events
+ */
+function createPersistenceHandler(store) {
+    return {
+        /**
+         * Handle job started event
+         */
+        onJobStarted(jobId) {
+            return store.logStart(jobId);
+        },
+        /**
+         * Handle job completed event
+         */
+        onJobCompleted(logId, success, output, error) {
+            store.logFinish(logId, success ? 'success' : 'failed', output, error);
+        },
+        /**
+         * Handle job state change (enabled/disabled)
+         */
+        onJobStateChanged(jobId, enabled) {
+            store.updateJob(jobId, { enabled });
+        },
+        /**
+         * Handle next run time update
+         */
+        onNextRunUpdated(jobId, nextRun) {
+            store.updateJob(jobId, {
+                next_run: nextRun ? nextRun.getTime() : null,
+            });
+        },
+    };
+}
+//# sourceMappingURL=recovery.js.map

package/dist/scheduler/recovery.js.map

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

package/dist/scheduler/schedule-store.d.ts

@@ -0,0 +1,112 @@
+/**
+ * Schedule persistence store using SQLite
+ *
+ * Stores cron job definitions and execution logs in SQLite database.
+ * Supports server restart recovery and execution history tracking.
+ */
+import Database from 'better-sqlite3';
+/**
+ * Persisted schedule (cron job) definition
+ */
+export interface Schedule {
+    id: string;
+    name: string;
+    cron_expr: string;
+    prompt: string;
+    enabled: boolean;
+    last_run: number | null;
+    next_run: number | null;
+    created_at: number;
+}
+/**
+ * Schedule execution log entry
+ */
+export interface ScheduleLog {
+    id: string;
+    schedule_id: string;
+    started_at: number;
+    finished_at: number | null;
+    status: 'running' | 'success' | 'failed';
+    output: string | null;
+    error: string | null;
+}
+/**
+ * Input for creating a new schedule
+ */
+export type CreateScheduleInput = Omit<Schedule, 'id' | 'created_at' | 'last_run'>;
+/**
+ * Input for updating a schedule
+ */
+export type UpdateScheduleInput = Partial<Omit<Schedule, 'id' | 'created_at'>>;
+/**
+ * SQLite-backed store for schedules and execution logs
+ */
+export declare class ScheduleStore {
+    private db;
+    constructor(db: Database.Database);
+    /**
+     * Run database migration to create tables
+     */
+    private runMigration;
+    /**
+     * Create a new schedule
+     */
+    createJob(input: CreateScheduleInput): string;
+    /**
+     * Get a schedule by ID
+     */
+    getJob(id: string): Schedule | null;
+    /**
+     * List all schedules
+     */
+    listJobs(): Schedule[];
+    /**
+     * List only enabled schedules
+     */
+    listEnabledJobs(): Schedule[];
+    /**
+     * Update a schedule
+     */
+    updateJob(id: string, updates: UpdateScheduleInput): boolean;
+    /**
+     * Delete a schedule (cascade deletes logs)
+     */
+    deleteJob(id: string): boolean;
+    /**
+     * Log the start of a schedule execution
+     */
+    logStart(scheduleId: string): string;
+    /**
+     * Log the finish of a schedule execution
+     */
+    logFinish(logId: string, status: 'success' | 'failed', output?: string, error?: string): boolean;
+    /**
+     * Get execution logs for a schedule
+     */
+    getLogs(scheduleId: string, limit?: number, offset?: number): ScheduleLog[];
+    /**
+     * Get the last execution for a schedule
+     */
+    getLastExecution(scheduleId: string): ScheduleLog | null;
+    /**
+     * Get the last execution across all schedules (for heartbeat status)
+     */
+    getLastExecutionGlobal(): ScheduleLog | null;
+    /**
+     * Get a specific log entry by ID
+     */
+    getLog(logId: string): ScheduleLog | null;
+    /**
+     * Convert database row to Schedule object
+     */
+    private rowToSchedule;
+    /**
+     * Convert database row to ScheduleLog object
+     */
+    private rowToLog;
+    /**
+     * Close the database connection
+     */
+    close(): void;
+}
+//# sourceMappingURL=schedule-store.d.ts.map

package/dist/scheduler/schedule-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedule-store.d.ts","sourceRoot":"","sources":["../../src/scheduler/schedule-store.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAOtC;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAC;IACzC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,IAAI,CAAC,QAAQ,EAAE,IAAI,GAAG,YAAY,GAAG,UAAU,CAAC,CAAC;AAEnF;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,GAAG,YAAY,CAAC,CAAC,CAAC;AA+B/E;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,EAAE,CAAoB;gBAElB,EAAE,EAAE,QAAQ,CAAC,QAAQ;IAKjC;;OAEG;IACH,OAAO,CAAC,YAAY;IAuCpB;;OAEG;IACH,SAAS,CAAC,KAAK,EAAE,mBAAmB,GAAG,MAAM;IAU7C;;OAEG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI;IAMnC;;OAEG;IACH,QAAQ,IAAI,QAAQ,EAAE;IAMtB;;OAEG;IACH,eAAe,IAAI,QAAQ,EAAE;IAQ7B;;OAEG;IACH,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,mBAAmB,GAAG,OAAO;IAqC5D;;OAEG;IACH,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAU9B;;OAEG;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM;IAgBpC;;OAEG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,GAAG,QAAQ,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO;IAUhG;;OAEG;IACH,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,SAAK,EAAE,MAAM,SAAI,GAAG,WAAW,EAAE;IAWlE;;OAEG;IACH,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI;IAWxD;;OAEG;IACH,sBAAsB,IAAI,WAAW,GAAG,IAAI;IAU5C;;OAEG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI;IAUzC;;OAEG;IACH,OAAO,CAAC,aAAa;IAarB;;OAEG;IACH,OAAO,CAAC,QAAQ;IAYhB;;OAEG;IACH,KAAK,IAAI,IAAI;CAGd"}