yepanywhere 0.1.0

package/dist/indexes/SessionIndexService.js

@@ -0,0 +1,356 @@
+/**
+ * SessionIndexService caches session summaries to avoid re-parsing JSONL files.
+ * Uses mtime/size for cache invalidation - only re-parses when files change.
+ *
+ * State is persisted to JSON files for durability across server restarts.
+ * Each project's session directory gets its own index file.
+ */
+import * as fs from "node:fs/promises";
+import * as path from "node:path";
+import { DEFAULT_PROVIDER, } from "@yep-anywhere/shared";
+import { getLogger } from "../logging/logger.js";
+const logger = getLogger();
+const CURRENT_VERSION = 1;
+/**
+ * Claude-specific session index service.
+ *
+ * Caches session summaries for Claude Code JSONL files to avoid
+ * re-parsing on every request. Currently works with Claude's
+ * ~/.claude/projects/ directory structure.
+ */
+export class SessionIndexService {
+    dataDir;
+    projectsDir;
+    indexCache = new Map();
+    savePromises = new Map();
+    pendingSaves = new Set();
+    maxCacheSize;
+    constructor(options = {}) {
+        const home = process.env.HOME ?? process.env.USERPROFILE ?? ".";
+        this.dataDir =
+            options.dataDir ?? path.join(home, ".yep-anywhere", "indexes");
+        this.projectsDir =
+            options.projectsDir ?? path.join(home, ".claude", "projects");
+        this.maxCacheSize = options.maxCacheSize ?? 10000;
+    }
+    /**
+     * Evict oldest entries if cache exceeds max size.
+     * Simple FIFO eviction since Map maintains insertion order.
+     */
+    evictIfNeeded() {
+        while (this.indexCache.size > this.maxCacheSize) {
+            const firstKey = this.indexCache.keys().next().value;
+            if (firstKey) {
+                this.indexCache.delete(firstKey);
+                logger.debug(`[SessionIndexService] Evicted cache entry for ${firstKey} (cache size: ${this.indexCache.size})`);
+            }
+            else {
+                break;
+            }
+        }
+    }
+    /**
+     * Initialize the service by ensuring the data directory exists.
+     */
+    async initialize() {
+        await fs.mkdir(this.dataDir, { recursive: true });
+    }
+    /**
+     * Get the index file path for a session directory.
+     * Encodes the relative path from projectsDir with %2F for slashes.
+     */
+    getIndexPath(sessionDir) {
+        const relative = path.relative(this.projectsDir, sessionDir);
+        const encoded = relative.replace(/\//g, "%2F");
+        return path.join(this.dataDir, `${encoded}.json`);
+    }
+    /**
+     * Load index from disk or create a new one.
+     */
+    async loadIndex(sessionDir, projectId) {
+        const indexPath = this.getIndexPath(sessionDir);
+        const cacheKey = sessionDir;
+        // Check memory cache first
+        const cached = this.indexCache.get(cacheKey);
+        if (cached) {
+            /*
+            logger.debug(
+              `[SessionIndexService] Memory cache hit for project (${Object.keys(cached.sessions).length} sessions)`,
+            );
+            */
+            return cached;
+        }
+        /*
+        logger.debug(
+          `[SessionIndexService] Memory cache miss, loading from disk: ${indexPath}`,
+        );
+        */
+        try {
+            const content = await fs.readFile(indexPath, "utf-8");
+            const parsed = JSON.parse(content);
+            // Validate version and projectId
+            if (parsed.version === CURRENT_VERSION &&
+                parsed.projectId === projectId) {
+                this.indexCache.set(cacheKey, parsed);
+                this.evictIfNeeded();
+                return parsed;
+            }
+            // Version mismatch or different project - start fresh
+            const fresh = {
+                version: CURRENT_VERSION,
+                projectId,
+                sessions: {},
+            };
+            this.indexCache.set(cacheKey, fresh);
+            this.evictIfNeeded();
+            return fresh;
+        }
+        catch (error) {
+            // File doesn't exist or is invalid - start fresh
+            if (error.code !== "ENOENT") {
+                logger.warn({ err: error }, `[SessionIndexService] Failed to load index for ${sessionDir}, starting fresh`);
+            }
+            const fresh = {
+                version: CURRENT_VERSION,
+                projectId,
+                sessions: {},
+            };
+            this.indexCache.set(cacheKey, fresh);
+            this.evictIfNeeded();
+            return fresh;
+        }
+    }
+    /**
+     * Save index to disk with debouncing to prevent excessive writes.
+     */
+    async saveIndex(sessionDir) {
+        const cacheKey = sessionDir;
+        // If a save is in progress, mark that we need another save
+        if (this.savePromises.has(cacheKey)) {
+            this.pendingSaves.add(cacheKey);
+            return;
+        }
+        const promise = this.doSaveIndex(sessionDir);
+        this.savePromises.set(cacheKey, promise);
+        try {
+            await promise;
+        }
+        finally {
+            this.savePromises.delete(cacheKey);
+        }
+        // If another save was requested while we were saving, do it now
+        if (this.pendingSaves.has(cacheKey)) {
+            this.pendingSaves.delete(cacheKey);
+            await this.saveIndex(sessionDir);
+        }
+    }
+    async doSaveIndex(sessionDir) {
+        const index = this.indexCache.get(sessionDir);
+        if (!index)
+            return;
+        const indexPath = this.getIndexPath(sessionDir);
+        try {
+            // Ensure directory exists
+            await fs.mkdir(path.dirname(indexPath), { recursive: true });
+            const content = JSON.stringify(index, null, 2);
+            await fs.writeFile(indexPath, content, "utf-8");
+        }
+        catch (error) {
+            logger.error({ err: error }, `[SessionIndexService] Failed to save index for ${sessionDir}`);
+            throw error;
+        }
+    }
+    /**
+     * Get sessions using the cache, only re-parsing files that have changed.
+     * This is the main entry point for listing sessions with caching.
+     */
+    async getSessionsWithCache(sessionDir, projectId, reader) {
+        const index = await this.loadIndex(sessionDir, projectId);
+        const summaries = [];
+        const seenSessionIds = new Set();
+        let indexChanged = false;
+        try {
+            const files = await fs.readdir(sessionDir);
+            // Filter out agent-* files (internal subagent warmup sessions)
+            const jsonlFiles = files.filter((f) => f.endsWith(".jsonl") && !f.startsWith("agent-"));
+            for (const file of jsonlFiles) {
+                const sessionId = file.replace(".jsonl", "");
+                seenSessionIds.add(sessionId);
+                const cached = index.sessions[sessionId];
+                const filePath = path.join(sessionDir, file);
+                try {
+                    const stats = await fs.stat(filePath);
+                    const mtime = stats.mtimeMs;
+                    const size = stats.size;
+                    // Check if cache is valid
+                    if (cached &&
+                        cached.fileMtime === mtime &&
+                        cached.indexedBytes === size) {
+                        // Cache hit - skip if empty (no user/assistant messages)
+                        if (cached.isEmpty) {
+                            // Empty session - already cached, skip silently
+                            continue;
+                        }
+                        // Cache hit - reconstruct SessionSummary from cache
+                        /*
+                        logger.debug(
+                          `[SessionIndexService] Cache HIT for ${sessionId} (mtime=${mtime}, size=${size})`,
+                        );
+                        */
+                        summaries.push({
+                            id: sessionId,
+                            projectId,
+                            title: cached.title,
+                            fullTitle: cached.fullTitle,
+                            createdAt: cached.createdAt,
+                            updatedAt: cached.updatedAt,
+                            messageCount: cached.messageCount,
+                            status: { state: "idle" },
+                            contextUsage: cached.contextUsage,
+                            provider: cached.provider ?? DEFAULT_PROVIDER,
+                        });
+                    }
+                    else {
+                        // Cache miss - parse the file
+                        logger.debug(`[SessionIndexService] Cache MISS for ${sessionId}: cached=${!!cached}, mtime match=${cached?.fileMtime === mtime}, size match=${cached?.indexedBytes === size}`);
+                        const summary = await reader.getSessionSummary(sessionId, projectId);
+                        if (summary) {
+                            summaries.push(summary);
+                            // Update cache
+                            index.sessions[sessionId] = {
+                                title: summary.title,
+                                fullTitle: summary.fullTitle,
+                                createdAt: summary.createdAt,
+                                updatedAt: summary.updatedAt,
+                                messageCount: summary.messageCount,
+                                contextUsage: summary.contextUsage,
+                                indexedBytes: size,
+                                fileMtime: mtime,
+                                provider: summary.provider,
+                            };
+                            indexChanged = true;
+                        }
+                        else {
+                            // Empty session (no user/assistant messages) - cache it to avoid re-parsing
+                            index.sessions[sessionId] = {
+                                title: null,
+                                fullTitle: null,
+                                createdAt: new Date().toISOString(),
+                                updatedAt: new Date().toISOString(),
+                                messageCount: 0,
+                                indexedBytes: size,
+                                fileMtime: mtime,
+                                isEmpty: true,
+                                provider: DEFAULT_PROVIDER,
+                            };
+                            indexChanged = true;
+                        }
+                    }
+                }
+                catch {
+                    // File error - skip this session
+                }
+            }
+            // Remove deleted sessions from cache
+            for (const sessionId of Object.keys(index.sessions)) {
+                if (!seenSessionIds.has(sessionId)) {
+                    delete index.sessions[sessionId];
+                    indexChanged = true;
+                }
+            }
+            // Save index if it changed
+            if (indexChanged) {
+                await this.saveIndex(sessionDir);
+            }
+        }
+        catch {
+            // Directory doesn't exist or not readable
+            return [];
+        }
+        // Sort by updatedAt descending
+        summaries.sort((a, b) => new Date(b.updatedAt).getTime() - new Date(a.updatedAt).getTime());
+        return summaries;
+    }
+    /**
+     * Invalidate the cache for a specific session.
+     * Call this when you know a session file has been modified.
+     */
+    invalidateSession(sessionDir, sessionId) {
+        const index = this.indexCache.get(sessionDir);
+        if (index) {
+            delete index.sessions[sessionId];
+        }
+    }
+    /**
+     * Clear all cached data for a session directory.
+     */
+    clearCache(sessionDir) {
+        this.indexCache.delete(sessionDir);
+    }
+    /**
+     * Get the data directory for testing purposes.
+     */
+    getDataDir() {
+        return this.dataDir;
+    }
+    /**
+     * Get just the title for a single session, using cache when possible.
+     * More efficient than getSessionsWithCache when you only need one session.
+     */
+    async getSessionTitle(sessionDir, projectId, sessionId, reader) {
+        const index = await this.loadIndex(sessionDir, projectId);
+        const cached = index.sessions[sessionId];
+        const filePath = path.join(sessionDir, `${sessionId}.jsonl`);
+        try {
+            const stats = await fs.stat(filePath);
+            const mtime = stats.mtimeMs;
+            const size = stats.size;
+            // Check if cache is valid
+            if (cached &&
+                cached.fileMtime === mtime &&
+                cached.indexedBytes === size) {
+                // Return null for empty sessions
+                if (cached.isEmpty) {
+                    return null;
+                }
+                return cached.title;
+            }
+            // Cache miss - parse the file
+            const summary = await reader.getSessionSummary(sessionId, projectId);
+            if (summary) {
+                // Update cache
+                index.sessions[sessionId] = {
+                    title: summary.title,
+                    fullTitle: summary.fullTitle,
+                    createdAt: summary.createdAt,
+                    updatedAt: summary.updatedAt,
+                    messageCount: summary.messageCount,
+                    contextUsage: summary.contextUsage,
+                    indexedBytes: size,
+                    fileMtime: mtime,
+                    provider: summary.provider,
+                };
+                await this.saveIndex(sessionDir);
+                return summary.title;
+            }
+            // Empty session - cache it to avoid re-parsing
+            index.sessions[sessionId] = {
+                title: null,
+                fullTitle: null,
+                createdAt: new Date().toISOString(),
+                updatedAt: new Date().toISOString(),
+                messageCount: 0,
+                indexedBytes: size,
+                fileMtime: mtime,
+                isEmpty: true,
+                provider: DEFAULT_PROVIDER,
+            };
+            await this.saveIndex(sessionDir);
+        }
+        catch {
+            // File error - return null
+        }
+        return null;
+    }
+}
+//# sourceMappingURL=SessionIndexService.js.map

package/dist/indexes/SessionIndexService.js.map

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

package/dist/indexes/index.d.ts

@@ -0,0 +1,3 @@
+export { SessionIndexService, type CachedSessionSummary, type SessionIndexServiceOptions, type SessionIndexState, } from "./SessionIndexService.js";
+export type { ISessionIndexService } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/indexes/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/indexes/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,KAAK,oBAAoB,EACzB,KAAK,0BAA0B,EAC/B,KAAK,iBAAiB,GACvB,MAAM,0BAA0B,CAAC;AAElC,YAAY,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC"}

package/dist/indexes/index.js

@@ -0,0 +1,2 @@
+export { SessionIndexService, } from "./SessionIndexService.js";
+//# sourceMappingURL=index.js.map

package/dist/indexes/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/indexes/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,GAIpB,MAAM,0BAA0B,CAAC"}

package/dist/indexes/types.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Session index service interface for provider-agnostic session caching.
+ *
+ * Each provider may have different file formats and directory structures,
+ * but all index services implement this interface to provide consistent caching.
+ */
+import type { UrlProjectId } from "@yep-anywhere/shared";
+import type { ISessionReader } from "../sessions/types.js";
+import type { SessionSummary } from "../supervisor/types.js";
+/**
+ * Common interface for session index services across providers.
+ *
+ * Index services cache session summaries to avoid re-parsing files on every request.
+ * They use file mtime/size for cache invalidation.
+ */
+export interface ISessionIndexService {
+    /**
+     * Initialize the service (create directories, load state, etc.).
+     */
+    initialize(): Promise<void>;
+    /**
+     * Get sessions using the cache, only re-parsing files that have changed.
+     * This is the main entry point for listing sessions with caching.
+     *
+     * @param sessionDir - Directory containing session files
+     * @param projectId - The project ID
+     * @param reader - Session reader for parsing files on cache miss
+     */
+    getSessionsWithCache(sessionDir: string, projectId: UrlProjectId, reader: ISessionReader): Promise<SessionSummary[]>;
+    /**
+     * Get just the title for a single session, using cache when possible.
+     * More efficient than getSessionsWithCache when you only need one session.
+     *
+     * @param sessionDir - Directory containing session files
+     * @param projectId - The project ID
+     * @param sessionId - The session ID
+     * @param reader - Session reader for parsing files on cache miss
+     */
+    getSessionTitle(sessionDir: string, projectId: UrlProjectId, sessionId: string, reader: ISessionReader): Promise<string | null>;
+    /**
+     * Invalidate the cache for a specific session.
+     * Call this when you know a session file has been modified.
+     *
+     * @param sessionDir - Directory containing session files
+     * @param sessionId - The session ID to invalidate
+     */
+    invalidateSession(sessionDir: string, sessionId: string): void;
+    /**
+     * Clear all cached data for a session directory.
+     *
+     * @param sessionDir - Directory to clear cache for
+     */
+    clearCache(sessionDir: string): void;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/indexes/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/indexes/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAE7D;;;;;GAKG;AACH,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5B;;;;;;;OAOG;IACH,oBAAoB,CAClB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,YAAY,EACvB,MAAM,EAAE,cAAc,GACrB,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;IAE7B;;;;;;;;OAQG;IACH,eAAe,CACb,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,YAAY,EACvB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,cAAc,GACrB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAE1B;;;;;;OAMG;IACH,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAE/D;;;;OAIG;IACH,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CACtC"}

package/dist/indexes/types.js

@@ -0,0 +1,8 @@
+/**
+ * Session index service interface for provider-agnostic session caching.
+ *
+ * Each provider may have different file formats and directory structures,
+ * but all index services implement this interface to provide consistent caching.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/indexes/types.js.map

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

package/dist/logging/index.d.ts

@@ -0,0 +1,2 @@
+export { initLogger, getLogger, interceptConsole, restoreConsole, getLogFilePath, getLogDir, type LogConfig, } from "./logger.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/logging/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/logging/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,SAAS,EACT,gBAAgB,EAChB,cAAc,EACd,cAAc,EACd,SAAS,EACT,KAAK,SAAS,GACf,MAAM,aAAa,CAAC"}

package/dist/logging/index.js

@@ -0,0 +1,2 @@
+export { initLogger, getLogger, interceptConsole, restoreConsole, getLogFilePath, getLogDir, } from "./logger.js";
+//# sourceMappingURL=index.js.map

package/dist/logging/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/logging/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,SAAS,EACT,gBAAgB,EAChB,cAAc,EACd,cAAc,EACd,SAAS,GAEV,MAAM,aAAa,CAAC"}

package/dist/logging/logger.d.ts

@@ -0,0 +1,81 @@
+import pino from "pino";
+/**
+ * Valid log levels.
+ */
+export declare const LOG_LEVELS: readonly ["trace", "debug", "info", "warn", "error", "fatal", "silent"];
+export type LogLevel = (typeof LOG_LEVELS)[number];
+export interface LogConfig {
+    /** Directory for log files. Default: ~/.yep-anywhere/logs */
+    logDir: string;
+    /** Log filename. Default: server.log */
+    logFile: string;
+    /** Minimum log level for console. Default: info */
+    consoleLevel: LogLevel;
+    /** Minimum log level for file. Default: info (or LOG_FILE_LEVEL env var) */
+    fileLevel: LogLevel;
+    /** Also log to console. Default: true */
+    logToConsole: boolean;
+    /** Log to file. Default: true */
+    logToFile: boolean;
+    /** Use pretty printing for console. Default: true in dev */
+    prettyPrint: boolean;
+}
+/**
+ * Initialize the logger with the given configuration.
+ * This should be called once at server startup.
+ */
+export declare function initLogger(config?: Partial<LogConfig>): pino.Logger;
+/**
+ * Get the logger instance. Must call initLogger first.
+ */
+export declare function getLogger(): pino.Logger;
+/**
+ * Intercept console.log/error/warn/info and route through pino logger.
+ * Call this after initLogger() to capture all console output.
+ */
+export declare function interceptConsole(): void;
+/**
+ * Restore original console methods.
+ */
+export declare function restoreConsole(): void;
+/**
+ * Get the path to the current log file.
+ */
+export declare function getLogFilePath(config?: Partial<LogConfig>): string;
+/**
+ * Get the log directory path.
+ */
+export declare function getLogDir(config?: Partial<LogConfig>): string;
+/**
+ * Set log levels dynamically at runtime.
+ * Changes take effect immediately for new log calls.
+ *
+ * Note: Due to pino's multistream architecture, dynamic level changes
+ * work by updating the base logger level. Individual stream levels
+ * are set at initialization and filtered at the stream level.
+ *
+ * @param console - New console log level (optional)
+ * @param file - New file log level (optional)
+ */
+export declare function setLogLevels(options: {
+    console?: LogLevel;
+    file?: LogLevel;
+}): void;
+/**
+ * Get current log levels for both console and file.
+ */
+export declare function getLogLevels(): {
+    console: LogLevel;
+    file: LogLevel;
+};
+/**
+ * Set the log level dynamically at runtime (legacy, sets both).
+ * @deprecated Use setLogLevels({ console, file }) instead
+ */
+export declare function setLogLevel(level: LogLevel): void;
+/**
+ * Get the current base log level.
+ * @deprecated Use getLogLevels() instead
+ */
+export declare function getLogLevel(): LogLevel;
+//# sourceMappingURL=logger.d.ts.map

package/dist/logging/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/logging/logger.ts"],"names":[],"mappings":"AAGA,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB;;GAEG;AACH,eAAO,MAAM,UAAU,yEAQb,CAAC;AACX,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;AAEnD,MAAM,WAAW,SAAS;IACxB,6DAA6D;IAC7D,MAAM,EAAE,MAAM,CAAC;IACf,wCAAwC;IACxC,OAAO,EAAE,MAAM,CAAC;IAChB,mDAAmD;IACnD,YAAY,EAAE,QAAQ,CAAC;IACvB,4EAA4E;IAC5E,SAAS,EAAE,QAAQ,CAAC;IACpB,yCAAyC;IACzC,YAAY,EAAE,OAAO,CAAC;IACtB,iCAAiC;IACjC,SAAS,EAAE,OAAO,CAAC;IACnB,4DAA4D;IAC5D,WAAW,EAAE,OAAO,CAAC;CACtB;AA8BD;;;GAGG;AACH,wBAAgB,UAAU,CAAC,MAAM,GAAE,OAAO,CAAC,SAAS,CAAM,GAAG,IAAI,CAAC,MAAM,CAgEvE;AAkBD;;GAEG;AACH,wBAAgB,SAAS,IAAI,IAAI,CAAC,MAAM,CAMvC;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAqCvC;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,IAAI,CASrC;AAmBD;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,GAAE,OAAO,CAAC,SAAS,CAAM,GAAG,MAAM,CAGtE;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,MAAM,GAAE,OAAO,CAAC,SAAS,CAAM,GAAG,MAAM,CAGjE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE;IACpC,OAAO,CAAC,EAAE,QAAQ,CAAC;IACnB,IAAI,CAAC,EAAE,QAAQ,CAAC;CACjB,GAAG,IAAI,CAiBP;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI;IAAE,OAAO,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,QAAQ,CAAA;CAAE,CAKpE;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,CAEjD;AAED;;;GAGG;AACH,wBAAgB,WAAW,IAAI,QAAQ,CAGtC"}