@skillsmith/core 0.5.2 → 0.5.4

package/dist/src/sources/LocalFilesystemAdapter.js

@@ -1,20 +1,45 @@
 /**
- * Local Filesystem Source Adapter (SMI-591)
+ * Local Filesystem Source Adapter (SMI-591, SMI-4287, SMI-4319, SMI-4320)
  *
  * Scans local directories for SKILL.md files.
  * Useful for local development and testing.
+ *
+ * SMI-4287 hardening:
+ * - Symlink targets are resolved via `fs.realpath` and checked against the
+ *   adapter's `rootDir`. Targets outside root are skipped with a
+ *   `symlink-escape` warning (unless `allowSymlinksOutsideRoot` is `true`).
+ * - Permission (EACCES/EPERM), not-found (ENOENT), and loop (ELOOP) errors
+ *   are surfaced as `AdapterError` entries on `SourceSearchResult.warnings`
+ *   instead of throwing, so siblings continue to be scanned.
+ * - All `fs.*` calls route through the typed `safeFs` helpers; the historic
+ *   bare `try/catch` for EACCES in `scanDirectory` is removed.
+ *
+ * SMI-4319 hardening:
+ * - `runScan` allocates a fresh `visitedRealpaths: Set<string>` per
+ *   invocation so mutually-recursive / self-looping directory symlinks are
+ *   detected and skipped with a `loop` warning instead of silently wasting
+ *   `maxDepth` traversals.
+ *
+ * SMI-4320 hardening:
+ * - `resolveSkillPath` is now async and routes through `resolveSafeRealpath`
+ *   (byte-wise `startsWith(rootReal + sep)` on realpath outputs — no
+ *   platform lowercasing). Direct-access methods (`getRepository`,
+ *   `fetchSkillContent`, `skillExists`) inherit containment instead of
+ *   relying solely on lexical `validatePath`. This closes the scan-to-fetch
+ *   TOCTOU window where an indexed-then-swapped symlink previously escaped
+ *   containment. `allowSymlinksOutsideRoot` is honoured at every realpath
+ *   callsite. Residual TOCTOU between `resolveSkillPath` and the subsequent
+ *   `fs.readFile` is documented; closing it requires fd-based I/O and is
+ *   tracked as a separate follow-up.
  */
 import { BaseSourceAdapter } from './BaseSourceAdapter.js';
 import { createHash } from 'crypto';
-import { promises as fs } from 'fs';
-import { join, basename, dirname, relative, resolve } from 'path';
+import { basename, dirname, resolve, join } from 'path';
 import { createLogger } from '../utils/logger.js';
 import { validatePath, safePatternMatch } from '../validation/index.js';
+import { safeFs, resolveSafeRealpath } from './LocalFilesystemAdapter.helpers.js';
+import { scanDirectoryRecursive, } from './LocalFilesystemAdapter.scan.js';
 const log = createLogger('LocalFilesystemAdapter');
-/**
- * Default skill file names to search for
- */
-const SKILL_FILE_NAMES = ['SKILL.md', 'skill.md'];
 /**
  * Local Filesystem Source Adapter
  *
@@ -33,6 +58,9 @@ const SKILL_FILE_NAMES = ['SKILL.md', 'skill.md'];
  *
  * await adapter.initialize()
  * const result = await adapter.search({})
+ * for (const warning of result.warnings ?? []) {
+ *   console.warn(`[${warning.code}] ${warning.message}`)
+ * }
  * ```
  */
 export class LocalFilesystemAdapter extends BaseSourceAdapter {
@@ -40,140 +68,167 @@ export class LocalFilesystemAdapter extends BaseSourceAdapter {
     maxDepth;
     excludePatterns;
     followSymlinks;
+    allowSymlinksOutsideRoot;
     discoveredSkills = [];
+    /**
+     * Warnings accumulated during the most recent scan. Consumed and cleared
+     * by `search()` so each caller sees only the warnings from that call's
+     * underlying scan.
+     */
+    scanWarnings = [];
     constructor(config) {
         super(config);
         this.rootDir = config.rootDir;
         this.maxDepth = config.maxDepth ?? 5;
         this.excludePatterns = config.excludePatterns ?? ['node_modules', '.git', '.svn', 'dist'];
         this.followSymlinks = config.followSymlinks ?? false;
+        this.allowSymlinksOutsideRoot = config.allowSymlinksOutsideRoot ?? false;
     }
     /**
      * Initialize by scanning the filesystem
      */
     async doInitialize() {
-        await this.scanDirectory(this.rootDir, 0);
+        this.scanWarnings = [];
+        await this.runScan();
     }
     /**
-     * Check if root directory exists and is accessible
+     * Check if root directory exists and is accessible.
+     *
+     * SMI-4287: routes `fs.stat(rootDir)` through `safeFs` so the raw Node
+     * error is translated to a typed `AdapterError` message.
      */
     async doHealthCheck() {
-        try {
-            const stats = await fs.stat(this.rootDir);
-            return {
-                healthy: stats.isDirectory(),
-                error: stats.isDirectory() ? undefined : 'Root path is not a directory',
-            };
-        }
-        catch (error) {
+        const statResult = await safeFs.stat(this.rootDir);
+        if (!statResult.ok) {
             return {
                 healthy: false,
-                error: error instanceof Error ? error.message : 'Directory not accessible',
+                error: statResult.error.message,
             };
         }
+        return {
+            healthy: statResult.value.isDirectory(),
+            error: statResult.value.isDirectory() ? undefined : 'Root path is not a directory',
+        };
     }
     /**
-     * Search for skills in the scanned directories
+     * Search for skills in the scanned directories.
+     *
+     * SMI-4287: `warnings` collects non-fatal `AdapterError` entries from the
+     * scan (symlink escapes, permission denials, loops). An empty array is
+     * returned as `undefined` to keep the field strictly optional.
      */
     async search(options = {}) {
-        // Re-scan if needed
         if (this.discoveredSkills.length === 0) {
-            await this.scanDirectory(this.rootDir, 0);
+            this.scanWarnings = [];
+            await this.runScan();
         }
         let filtered = [...this.discoveredSkills];
-        // Filter by query (search in path/directory name)
         if (options.query) {
             const query = options.query.toLowerCase();
             filtered = filtered.filter((skill) => skill.relativePath.toLowerCase().includes(query) ||
                 skill.directory.toLowerCase().includes(query));
         }
-        // Apply limit
         const limit = options.limit ?? 100;
         const limitedResults = filtered.slice(0, limit);
-        // Convert to SourceRepository format
-        const repositories = await Promise.all(limitedResults.map((skill) => this.skillToRepository(skill)));
+        const repositoriesWithWarnings = await Promise.all(limitedResults.map((skill) => this.skillToRepository(skill)));
+        const repositories = repositoriesWithWarnings.map((r) => r.repo);
+        const repoWarnings = repositoriesWithWarnings.flatMap((r) => r.warnings);
+        const allWarnings = [...this.scanWarnings, ...repoWarnings];
         return {
             repositories,
             totalCount: filtered.length,
             hasMore: filtered.length > limit,
+            warnings: allWarnings.length > 0 ? allWarnings : undefined,
         };
     }
     /**
-     * Get repository info for a skill location
+     * Get repository info for a skill location.
+     *
+     * SMI-4287: `fs.stat` is routed through `safeFs`; permission errors are
+     * converted to typed Error messages instead of raw Node throws.
      */
     async getRepository(location) {
-        const skillPath = this.resolveSkillPath(location);
+        const skillPath = await this.resolveSkillPath(location);
         const skill = this.discoveredSkills.find((s) => s.path === skillPath);
         if (skill) {
-            return this.skillToRepository(skill);
+            const { repo } = await this.skillToRepository(skill);
+            return repo;
         }
-        // Try to get info even if not in discovered list
-        try {
-            const stats = await fs.stat(skillPath);
-            return {
-                id: this.generateId(skillPath),
-                name: basename(dirname(skillPath)),
-                url: `file://${skillPath}`,
-                description: null,
-                owner: 'local',
-                defaultBranch: 'main',
-                stars: 0,
-                forks: 0,
-                topics: ['local'],
-                updatedAt: stats.mtime.toISOString(),
-                createdAt: stats.ctime.toISOString(),
-                license: null,
-                metadata: {
-                    sourceType: 'local',
-                    path: skillPath,
-                },
-            };
-        }
-        catch (error) {
-            throw new Error(`Skill not found at ${skillPath}: ${error instanceof Error ? error.message : String(error)}`);
+        const statResult = await safeFs.stat(skillPath);
+        if (!statResult.ok) {
+            throw new Error(`Skill not found at ${skillPath}: ${statResult.error.message}`);
         }
+        const stats = statResult.value;
+        return {
+            id: this.generateId(skillPath),
+            name: basename(dirname(skillPath)),
+            url: `file://${skillPath}`,
+            description: null,
+            owner: 'local',
+            defaultBranch: 'main',
+            stars: 0,
+            forks: 0,
+            topics: ['local'],
+            updatedAt: stats.mtime.toISOString(),
+            createdAt: stats.ctime.toISOString(),
+            license: null,
+            metadata: {
+                sourceType: 'local',
+                path: skillPath,
+            },
+        };
     }
     /**
-     * Fetch skill content from local file
+     * Fetch skill content from local file.
+     *
+     * SMI-4287: both `fs.readFile` and `fs.stat` route through `safeFs`, so
+     * permission errors (EACCES/EPERM) raise typed Errors with path context
+     * instead of raw Node errors.
      */
     async fetchSkillContent(location) {
-        const skillPath = this.resolveSkillPath(location);
-        try {
-            const rawContent = await fs.readFile(skillPath, 'utf-8');
-            const stats = await fs.stat(skillPath);
-            const sha = this.generateSha(rawContent);
-            return {
-                rawContent,
-                sha,
-                location,
-                filePath: skillPath,
-                encoding: 'utf-8',
-                lastModified: stats.mtime.toISOString(),
-            };
+        const skillPath = await this.resolveSkillPath(location);
+        const contentResult = await safeFs.readFile(skillPath);
+        if (!contentResult.ok) {
+            throw new Error(`Failed to read skill file at ${skillPath}: ${contentResult.error.message}`);
         }
-        catch (error) {
-            throw new Error(`Failed to read skill file at ${skillPath}: ${error instanceof Error ? error.message : String(error)}`);
+        const statResult = await safeFs.stat(skillPath);
+        if (!statResult.ok) {
+            throw new Error(`Failed to stat skill file at ${skillPath}: ${statResult.error.message}`);
         }
+        const rawContent = contentResult.value;
+        const stats = statResult.value;
+        const sha = this.generateSha(rawContent);
+        return {
+            rawContent,
+            sha,
+            location,
+            filePath: skillPath,
+            encoding: 'utf-8',
+            lastModified: stats.mtime.toISOString(),
+        };
     }
     /**
      * Check if skill exists at location
      */
     async skillExists(location) {
-        const skillPath = this.resolveSkillPath(location);
-        try {
-            await fs.access(skillPath);
-            return true;
-        }
-        catch {
-            return false;
-        }
+        // SMI-720 contract: lexical path-traversal attempts throw
+        // `ValidationError('Path traversal detected: ...')` from `resolveSkillPath`
+        // — callers (and the SMI-720 test suite) rely on this. Only absence on
+        // disk should return `false`; traversal attempts surface as exceptions.
+        const skillPath = await this.resolveSkillPath(location);
+        const statResult = await safeFs.stat(skillPath);
+        return statResult.ok;
     }
     /**
-     * Rescan the filesystem for new skills
+     * Rescan the filesystem for new skills.
+     *
+     * Returns the count of discovered skills. Warnings from the rescan are
+     * available via the next call to `search()`.
      */
     async rescan() {
         this.discoveredSkills = [];
-        await this.scanDirectory(this.rootDir, 0);
+        this.scanWarnings = [];
+        await this.runScan();
         return this.discoveredSkills.length;
     }
     /**
@@ -183,59 +238,27 @@ export class LocalFilesystemAdapter extends BaseSourceAdapter {
         return this.discoveredSkills.length;
     }
     /**
-     * Scan a directory recursively for skill files
+     * Run the recursive scan starting at `rootDir`. Delegates to the extracted
+     * `scanDirectoryRecursive` helper (see `LocalFilesystemAdapter.scan.ts`).
+     *
+     * SMI-4319: allocates a fresh `visitedRealpaths` set per invocation so
+     * back-to-back scans don't share state. Sibling directories within a
+     * single scan share the set (they're in the same call tree), so
+     * cross-linked loops (A↔B) are caught even when the loop isn't on the
+     * descent path from `rootDir`.
      */
-    async scanDirectory(dirPath, depth) {
-        if (depth > this.maxDepth)
-            return;
-        try {
-            const entries = await fs.readdir(dirPath, { withFileTypes: true });
-            for (const entry of entries) {
-                const fullPath = join(dirPath, entry.name);
-                // Skip excluded patterns
-                if (this.isExcluded(entry.name))
-                    continue;
-                // Handle symlinks
-                let isDirectory = entry.isDirectory();
-                let isFile = entry.isFile();
-                if (entry.isSymbolicLink()) {
-                    if (!this.followSymlinks)
-                        continue;
-                    try {
-                        const stats = await fs.stat(fullPath);
-                        isDirectory = stats.isDirectory();
-                        isFile = stats.isFile();
-                    }
-                    catch {
-                        continue; // Skip broken symlinks
-                    }
-                }
-                // Check for skill files
-                if (isFile && SKILL_FILE_NAMES.includes(entry.name)) {
-                    const stats = await fs.stat(fullPath);
-                    this.discoveredSkills.push({
-                        path: fullPath,
-                        relativePath: relative(this.rootDir, fullPath),
-                        directory: dirname(fullPath),
-                        stats: {
-                            size: stats.size,
-                            mtime: stats.mtime,
-                            ctime: stats.ctime,
-                        },
-                    });
-                }
-                // Recurse into directories
-                if (isDirectory) {
-                    await this.scanDirectory(fullPath, depth + 1);
-                }
-            }
-        }
-        catch (error) {
-            // Ignore permission errors and continue scanning
-            if (error.code !== 'EACCES') {
-                log.warn(`Error scanning directory ${dirPath}: ${error}`);
-            }
-        }
+    async runScan() {
+        await scanDirectoryRecursive(this.rootDir, 0, {
+            rootDir: this.rootDir,
+            maxDepth: this.maxDepth,
+            followSymlinks: this.followSymlinks,
+            allowSymlinksOutsideRoot: this.allowSymlinksOutsideRoot,
+            isExcluded: (name) => this.isExcluded(name),
+            discovered: this.discoveredSkills,
+            warnings: this.scanWarnings,
+            visitedRealpaths: new Set(),
+            log,
+        });
     }
     /**
      * Check if a path/name should be excluded (SMI-722, SMI-726)
@@ -246,9 +269,22 @@ export class LocalFilesystemAdapter extends BaseSourceAdapter {
     }
     /**
      * Resolve a skill location to a full filesystem path
-     * Validates that the resolved path remains within rootDir to prevent path traversal attacks (SMI-720, SMI-726)
+     * (SMI-720, SMI-726, SMI-4287, SMI-4320).
+     *
+     * Two-stage containment: (1) lexical `validatePath` fast-fails
+     * `../`-style traversal (SMI-720 contract — callers assert the
+     * "Path traversal detected" message), then (2) `resolveSafeRealpath`
+     * enforces realpath byte-wise containment so symlinks can't escape
+     * `rootDir` even when the lexical path is clean. Honours the SMI-4287
+     * `allowSymlinksOutsideRoot` opt-in.
+     *
+     * Not-found behaviour: realpath ENOENT falls back to the lexically
+     * resolved path so downstream `stat` / `readFile` produce the canonical
+     * caller-visible error. TOCTOU caveat: the window between this resolve
+     * and the caller's subsequent read remains open; closing it requires
+     * fd-based I/O and is tracked separately.
      */
-    resolveSkillPath(location) {
+    async resolveSkillPath(location) {
         let resolvedPath;
         if (location.path?.startsWith('/')) {
             resolvedPath = location.path;
@@ -265,53 +301,76 @@ export class LocalFilesystemAdapter extends BaseSourceAdapter {
         else {
             throw new Error('Invalid location: must specify path or repo');
         }
-        // Use centralized path validation to prevent path traversal attacks
+        // Lexical fast-fail (SMI-720 contract — callers test for
+        // "Path traversal detected" on obvious traversal attempts).
         validatePath(resolvedPath, this.rootDir);
-        return resolve(resolvedPath);
+        const absolutePath = resolve(resolvedPath);
+        // SMI-4320: realpath-based containment. Honours SMI-4287 opt-in.
+        const realResult = await resolveSafeRealpath(absolutePath, this.rootDir, {
+            allowSymlinksOutsideRoot: this.allowSymlinksOutsideRoot,
+        });
+        if (realResult.ok) {
+            return realResult.value;
+        }
+        // `not-found` is expected for skillExists / fetchSkillContent on paths
+        // that the caller hasn't verified exist. Fall back to the lexically
+        // resolved path so downstream `stat` / `readFile` produce the canonical
+        // error message callers already depend on.
+        if (realResult.error.code === 'not-found') {
+            return absolutePath;
+        }
+        // `symlink-escape`, `loop`, `permission`, `io` all throw — the caller
+        // asked for a path that either escapes root or can't be validated.
+        throw new Error(`Path rejected by realpath containment: ${realResult.error.message}`);
     }
     /**
-     * Convert discovered skill to SourceRepository
+     * Convert discovered skill to SourceRepository.
+     *
+     * Returns both the repository and any warnings encountered while reading
+     * the file (typically permission errors on SKILL.md after discovery).
      */
     async skillToRepository(skill) {
         const dirName = basename(skill.directory);
-        // Try to extract metadata from the skill file
+        const warnings = [];
         let description = null;
         let name = dirName;
-        try {
-            const content = await fs.readFile(skill.path, 'utf-8');
-            // Try to extract name from frontmatter
+        const contentResult = await safeFs.readFile(skill.path);
+        if (contentResult.ok) {
+            const content = contentResult.value;
             const nameMatch = content.match(/^---[\s\S]*?name:\s*["']?([^"'\n]+)["']?/m);
             if (nameMatch) {
                 name = nameMatch[1].trim();
             }
-            // Try to extract description from frontmatter
             const descMatch = content.match(/^---[\s\S]*?description:\s*["']?([^"'\n]+)["']?/m);
             if (descMatch) {
                 description = descMatch[1].trim();
             }
         }
-        catch {
-            // Use defaults
+        else {
+            warnings.push(contentResult.error);
         }
         return {
-            id: this.generateId(skill.path),
-            name,
-            url: `file://${skill.path}`,
-            description,
-            owner: 'local',
-            defaultBranch: 'main',
-            stars: 0,
-            forks: 0,
-            topics: ['local'],
-            updatedAt: skill.stats.mtime.toISOString(),
-            createdAt: skill.stats.ctime.toISOString(),
-            license: null,
-            metadata: {
-                sourceType: 'local',
-                path: skill.path,
-                relativePath: skill.relativePath,
-                size: skill.stats.size,
+            repo: {
+                id: this.generateId(skill.path),
+                name,
+                url: `file://${skill.path}`,
+                description,
+                owner: 'local',
+                defaultBranch: 'main',
+                stars: 0,
+                forks: 0,
+                topics: ['local'],
+                updatedAt: skill.stats.mtime.toISOString(),
+                createdAt: skill.stats.ctime.toISOString(),
+                license: null,
+                metadata: {
+                    sourceType: 'local',
+                    path: skill.path,
+                    relativePath: skill.relativePath,
+                    size: skill.stats.size,
+                },
             },
+            warnings,
         };
     }
     /**

package/dist/src/sources/LocalFilesystemAdapter.js.map

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

package/dist/src/sources/LocalFilesystemAdapter.scan.d.ts

@@ -0,0 +1,78 @@
+/**
+ * LocalFilesystemAdapter scan loop (SMI-4287, SMI-4319)
+ *
+ * Extracted from `LocalFilesystemAdapter.ts` to keep the main adapter file
+ * under the 500-line governance ceiling. Pure function of its inputs — no
+ * shared instance state other than the `warnings` sink.
+ *
+ * SMI-4319: tracks visited directory realpaths in a per-scan `Set<string>`
+ * so mutually-recursive symlinks (A→B, B→A) are detected and skipped with a
+ * `loop` warning. Each `scanDirectoryRecursive` invocation checks the set
+ * BEFORE recursing; the set is keyed on the raw realpath (no
+ * `normaliseForFs`) so legitimate case-sensitive distinctions are preserved.
+ * Loop detection runs regardless of `allowSymlinksOutsideRoot` — loops are a
+ * correctness issue (infinite work), not a security issue.
+ */
+import type { AdapterError } from './types.js';
+import type { createLogger } from '../utils/logger.js';
+/**
+ * File names that identify a skill definition.
+ */
+export declare const SKILL_FILE_NAMES: string[];
+/**
+ * Shape shared with `LocalFilesystemAdapter.DiscoveredSkill`.
+ */
+export interface DiscoveredSkillRecord {
+    path: string;
+    relativePath: string;
+    directory: string;
+    stats: {
+        size: number;
+        mtime: Date;
+        ctime: Date;
+    };
+}
+/**
+ * Configuration consumed by the scan loop.
+ */
+export interface ScanDirectoryOptions {
+    /** Root directory (used for relative path calculations). */
+    rootDir: string;
+    /** Maximum recursion depth. */
+    maxDepth: number;
+    /** If false, symlinks are skipped entirely. */
+    followSymlinks: boolean;
+    /** If true, skip the symlink-containment check. */
+    allowSymlinksOutsideRoot: boolean;
+    /** Predicate for name-based exclusion. */
+    isExcluded: (name: string) => boolean;
+    /** Destination array for discovered skills (mutated in place). */
+    discovered: DiscoveredSkillRecord[];
+    /** Destination array for non-fatal errors (mutated in place). */
+    warnings: AdapterError[];
+    /**
+     * Visited directory realpaths for this scan (SMI-4319). Mutated in place.
+     * Keyed on the raw realpath string (no platform lowercasing). Must be a
+     * fresh `Set` per `runScan` invocation so back-to-back scans don't share
+     * state.
+     */
+    visitedRealpaths: Set<string>;
+    /** Logger instance from the parent adapter. */
+    log: ReturnType<typeof createLogger>;
+}
+/**
+ * Recursively scan `dirPath` for `SKILL.md` files, populating
+ * `options.discovered` and `options.warnings` in place.
+ *
+ * SMI-4287: all filesystem access routes through `safeFs`. Per-entry errors
+ * are recorded on `warnings` and the scan continues for siblings.
+ *
+ * SMI-4319: before descending, realpath `dirPath` and check
+ * `options.visitedRealpaths` for a prior visit. On hit, push a `loop` warning
+ * and return — prevents A↔B / self-loop directory symlinks from wasting
+ * `maxDepth` traversals and surfacing the same SKILL.md under multiple
+ * lexical paths. Realpath errors (permission, ENOENT, ELOOP on the dir
+ * itself) are recorded and the subtree is skipped.
+ */
+export declare function scanDirectoryRecursive(dirPath: string, depth: number, options: ScanDirectoryOptions): Promise<void>;
+//# sourceMappingURL=LocalFilesystemAdapter.scan.d.ts.map

package/dist/src/sources/LocalFilesystemAdapter.scan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LocalFilesystemAdapter.scan.d.ts","sourceRoot":"","sources":["../../../src/sources/LocalFilesystemAdapter.scan.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAC9C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAEtD;;GAEG;AACH,eAAO,MAAM,gBAAgB,UAA2B,CAAA;AAExD;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAA;IACZ,YAAY,EAAE,MAAM,CAAA;IACpB,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,EAAE;QACL,IAAI,EAAE,MAAM,CAAA;QACZ,KAAK,EAAE,IAAI,CAAA;QACX,KAAK,EAAE,IAAI,CAAA;KACZ,CAAA;CACF;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,4DAA4D;IAC5D,OAAO,EAAE,MAAM,CAAA;IACf,+BAA+B;IAC/B,QAAQ,EAAE,MAAM,CAAA;IAChB,+CAA+C;IAC/C,cAAc,EAAE,OAAO,CAAA;IACvB,mDAAmD;IACnD,wBAAwB,EAAE,OAAO,CAAA;IACjC,0CAA0C;IAC1C,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAA;IACrC,kEAAkE;IAClE,UAAU,EAAE,qBAAqB,EAAE,CAAA;IACnC,iEAAiE;IACjE,QAAQ,EAAE,YAAY,EAAE,CAAA;IACxB;;;;;OAKG;IACH,gBAAgB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;IAC7B,+CAA+C;IAC/C,GAAG,EAAE,UAAU,CAAC,OAAO,YAAY,CAAC,CAAA;CACrC;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,IAAI,CAAC,CAuFf"}