@pellux/goodvibes-sdk 0.18.3 → 0.18.11

package/dist/platform/tools/analyze/schema.js

@@ -0,0 +1,118 @@
+/**
+ * JSON Schema for the analyze tool's input.
+ * A mode router for code analysis: impact, dependencies, dead code,
+ * security, coverage, surface, preview, diff, and bundle.
+ */
+export const analyzeSchema = {
+    name: 'analyze',
+    description: 'Multi-mode code analysis tool. Modes: impact (change blast radius), ' +
+        'dependencies (import graph / circular detection), dead_code (unreferenced exports), ' +
+        'security (hardcoded secrets/env audit), coverage (lcov parse), ' +
+        'surface (public API exports), preview (diff without writing), ' +
+        'diff (git ref diff), bundle (stats.json parse), ' +
+        'breaking (API breaking changes between refs), semantic_diff (LLM-powered diff summary), ' +
+        'upgrade (npm registry version check), permissions (dangerous pattern scan), ' +
+        'env_audit (.env file key comparison), test_find (locate test files for source files).',
+    sideEffects: ['read_fs', 'network'],
+    concurrency: 'parallel',
+    supportsProgress: true,
+    parameters: {
+        type: 'object',
+        required: ['mode'],
+        properties: {
+            mode: {
+                type: 'string',
+                enum: [
+                    'impact',
+                    'dependencies',
+                    'dead_code',
+                    'security',
+                    'coverage',
+                    'bundle',
+                    'preview',
+                    'diff',
+                    'surface',
+                    'breaking',
+                    'semantic_diff',
+                    'upgrade',
+                    'permissions',
+                    'env_audit',
+                    'test_find',
+                ],
+                description: 'Analysis mode to run.',
+            },
+            files: {
+                type: 'array',
+                items: { type: 'string' },
+                description: 'Target files or directories for analysis.',
+            },
+            projectRoot: {
+                type: 'string',
+                description: 'Project root directory. Defaults to current working directory.',
+            },
+            // mode: impact
+            changes: {
+                type: 'string',
+                description: 'Description of planned changes (mode: impact).',
+            },
+            // mode: dependencies
+            submode: {
+                type: 'string',
+                enum: ['analyze', 'circular', 'upgrade'],
+                description: 'Sub-mode for dependencies analysis. Default: analyze.',
+            },
+            // mode: security
+            securityScope: {
+                type: 'string',
+                enum: ['secrets', 'permissions', 'env', 'all'],
+                description: 'Security check scope (mode: security). Default: all.',
+            },
+            // mode: diff
+            before: {
+                type: 'string',
+                description: 'Git ref or file path for before state (mode: diff).',
+            },
+            after: {
+                type: 'string',
+                description: 'Git ref or file path for after state (mode: diff).',
+            },
+            // mode: preview
+            find: {
+                type: 'string',
+                description: 'String to find (mode: preview). Used with replace.',
+            },
+            replace: {
+                type: 'string',
+                description: 'Replacement string (mode: preview).',
+            },
+            // mode: upgrade
+            packages: {
+                type: 'array',
+                items: { type: 'string' },
+                description: 'Package names to check (mode: upgrade). Defaults to all packages in package.json.',
+            },
+            // mode: surface
+            include: {
+                type: 'array',
+                items: { type: 'string' },
+                description: 'Sections to include in surface output: deps, security, tests, api.',
+            },
+            output: {
+                type: 'object',
+                description: 'Output options.',
+                properties: {
+                    format: {
+                        type: 'string',
+                        enum: ['summary', 'detailed', 'json'],
+                        description: 'Output format. Default: json.',
+                    },
+                    max_tokens: {
+                        type: 'integer',
+                        minimum: 0,
+                        description: 'Approximate token budget for the response.',
+                    },
+                },
+            },
+        },
+    },
+};

package/dist/platform/tools/analyze/shared.d.ts

@@ -0,0 +1,37 @@
+import type { AnalyzeInput, JsonObject, DiffStatFile } from './types.js';
+export declare const BINARY_CHECK_BYTES = 8192;
+export declare const MAX_SCAN_FILES = 500;
+export declare const MAX_SCAN_MS = 5000;
+export declare const ANALYZE_SUMMARY_SAMPLE_LIMIT = 5;
+export declare function isBinary(filePath: string): Promise<boolean>;
+export declare function collectTextFiles(dirPath: string, limit?: number, deadline?: number): Promise<string[]>;
+export declare function escapeRegex(s: string): string;
+export declare function validatePath(inputPath: string, root: string): string | {
+    error: string;
+};
+export declare function readTextFile(filePath: string): Promise<string | null>;
+export declare function collectInputFiles(inputFiles: string[] | undefined, projectRoot: string, options?: {
+    expandDirectories?: boolean;
+    limit?: number;
+    deadline?: number;
+}): Promise<string[]>;
+export declare function sampleArray<T>(value: unknown, limit?: number): T[];
+export declare function summarizeAnalyzeResult(mode: AnalyzeInput['mode'], result: Record<string, unknown>): Record<string, unknown>;
+export declare function applyAnalyzeTokenBudget(output: string, maxTokens: number | undefined): string;
+export declare function readJsonFile<T extends JsonObject = JsonObject>(filePath: string): Promise<T | null>;
+export declare function resolveScanRoot(input: AnalyzeInput, projectRoot: string): string;
+export declare function collectExistingPaths(projectRoot: string, names: string[]): string[];
+export declare function loadDependencyVersions(pkgJson: JsonObject): Record<string, string>;
+export declare function parseDiffStats(statOutput: string): DiffStatFile[];
+export declare function findEntryPoint(targetDir: string, candidates: string[]): string | null;
+export declare function validateGitRefs(before: string, after: string): {
+    error: string;
+    before: string;
+    after: string;
+} | null;
+export declare function truncateDiffAtBoundary(diff: string, maxChars: number): string;
+export declare function parseSemver(version: string): [number, number, number];
+export declare function isBreakingUpgrade(current: string, latest: string): boolean;
+export declare function parseEnvKeys(content: string): Set<string>;
+export declare function testCandidates(sourceFile: string, projectRoot: string): string[];
+//# sourceMappingURL=shared.d.ts.map

package/dist/platform/tools/analyze/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../../../src/platform/tools/analyze/shared.ts"],"names":[],"mappings":"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"}

package/dist/platform/tools/analyze/shared.js

@@ -0,0 +1,337 @@
+import { existsSync } from 'node:fs';
+import { stat } from 'node:fs/promises';
+import { dirname, join, relative, resolve } from 'node:path';
+import { walkDir } from '../../utils/walk-dir.js';
+import { summarizeError } from '../../utils/error-display.js';
+export const BINARY_CHECK_BYTES = 8192;
+export const MAX_SCAN_FILES = 500;
+export const MAX_SCAN_MS = 5000;
+export const ANALYZE_SUMMARY_SAMPLE_LIMIT = 5;
+export async function isBinary(filePath) {
+    try {
+        const file = Bun.file(filePath);
+        if (file.size === 0)
+            return false;
+        const chunk = await file.slice(0, BINARY_CHECK_BYTES).arrayBuffer();
+        const bytes = new Uint8Array(chunk);
+        for (const byte of bytes) {
+            if (byte === 0)
+                return true;
+        }
+        return false;
+    }
+    catch {
+        return true;
+    }
+}
+export async function collectTextFiles(dirPath, limit = MAX_SCAN_FILES, deadline) {
+    const files = [];
+    for await (const filePath of walkDir(dirPath)) {
+        if (files.length >= limit)
+            break;
+        if (deadline && Date.now() > deadline)
+            break;
+        if (!(await isBinary(filePath))) {
+            files.push(filePath);
+        }
+    }
+    return files;
+}
+export function escapeRegex(s) {
+    return s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+export function validatePath(inputPath, root) {
+    try {
+        const resolved = resolve(root, inputPath);
+        const rel = relative(root, resolved);
+        if (rel.startsWith('..') || rel.includes('/..')) {
+            return { error: `Path '${inputPath}' is outside the project root` };
+        }
+        return resolved;
+    }
+    catch (err) {
+        return { error: summarizeError(err) };
+    }
+}
+export async function readTextFile(filePath) {
+    try {
+        return await Bun.file(filePath).text();
+    }
+    catch {
+        return null;
+    }
+}
+export async function collectInputFiles(inputFiles, projectRoot, options = {}) {
+    const expandDirectories = options.expandDirectories ?? false;
+    const limit = options.limit ?? MAX_SCAN_FILES;
+    const deadline = options.deadline;
+    if (!inputFiles || inputFiles.length === 0) {
+        return collectTextFiles(projectRoot, limit, deadline);
+    }
+    const files = [];
+    for (const inputFile of inputFiles) {
+        if (files.length >= limit)
+            break;
+        if (deadline && Date.now() > deadline)
+            break;
+        const resolved = resolve(projectRoot, inputFile);
+        try {
+            const info = await stat(resolved);
+            if (info.isDirectory()) {
+                if (expandDirectories) {
+                    const remaining = limit - files.length;
+                    const collected = await collectTextFiles(resolved, remaining, deadline);
+                    files.push(...collected);
+                }
+                continue;
+            }
+            files.push(resolved);
+        }
+        catch {
+            // Skip missing or unreadable paths.
+        }
+    }
+    return files;
+}
+export function sampleArray(value, limit = ANALYZE_SUMMARY_SAMPLE_LIMIT) {
+    return Array.isArray(value) ? value.slice(0, limit) : [];
+}
+export function summarizeAnalyzeResult(mode, result) {
+    switch (mode) {
+        case 'dependencies':
+            return {
+                mode,
+                has_cycles: result.has_cycles ?? false,
+                fileCount: result.graph && typeof result.graph === 'object' ? Object.keys(result.graph).length : 0,
+                cycleCount: Array.isArray(result.cycles) ? result.cycles.length : 0,
+                cycles: sampleArray(result.cycles),
+            };
+        case 'dead_code':
+            return {
+                mode,
+                total_exports: result.total_exports ?? 0,
+                dead_export_count: Array.isArray(result.dead_exports) ? result.dead_exports.length : 0,
+                dead_exports: sampleArray(result.dead_exports).map((entry) => ({
+                    name: entry.name ?? null,
+                    file: entry.file ?? null,
+                })),
+            };
+        case 'security': {
+            const secrets = result.secrets ?? {};
+            const env = result.env ?? {};
+            const permissions = result.permissions ?? {};
+            return {
+                mode,
+                secretFindingCount: Array.isArray(secrets.findings) ? secrets.findings.length : 0,
+                envFileCount: Array.isArray(env.files_found) ? env.files_found.length : 0,
+                permissionFindingCount: Array.isArray(permissions.findings) ? permissions.findings.length : 0,
+                topSecretFindings: sampleArray(secrets.findings).map((finding) => ({
+                    pattern: finding.pattern ?? null,
+                    file: finding.file ?? null,
+                    line: finding.line ?? null,
+                })),
+            };
+        }
+        case 'surface':
+            return {
+                mode,
+                fileCount: Array.isArray(result.surface) ? result.surface.length : 0,
+                total_exports: result.total_exports ?? 0,
+                surface: sampleArray(result.surface).map((entry) => ({
+                    file: entry.file ?? null,
+                    exportCount: Array.isArray(entry.exports) ? entry.exports.length : 0,
+                    exports: sampleArray(entry.exports).map((exp) => exp.name ?? null),
+                })),
+            };
+        case 'impact':
+            return {
+                mode,
+                summary: result.summary ?? null,
+                changed_files: sampleArray(result.changed_files),
+                affected: sampleArray(result.affected).map((entry) => ({
+                    file: entry.file ?? null,
+                    reason: entry.reason ?? null,
+                })),
+            };
+        case 'diff':
+        case 'semantic_diff':
+            return {
+                mode,
+                summary: result.summary ?? null,
+                risk: result.risk ?? null,
+                impact: sampleArray(result.impact),
+                changed_files: sampleArray(result.changed_files),
+            };
+        case 'coverage':
+            return {
+                mode,
+                source: result.source ?? null,
+                line_pct: result.line_pct ?? null,
+                branch_pct: result.branch_pct ?? null,
+                function_pct: result.function_pct ?? null,
+                statement_pct: result.statement_pct ?? null,
+            };
+        case 'bundle':
+            return {
+                mode,
+                source: result.source ?? null,
+                assetCount: Array.isArray(result.assets) ? result.assets.length : 0,
+                chunkCount: Array.isArray(result.chunks) ? result.chunks.length : 0,
+                assets: sampleArray(result.assets).map((asset) => ({
+                    name: asset.name ?? null,
+                    size: asset.size ?? null,
+                })),
+            };
+        case 'upgrade':
+            return {
+                mode,
+                packageCount: Array.isArray(result.packages) ? result.packages.length : 0,
+                outdated: sampleArray(result.packages).filter((pkg) => pkg.current !== pkg.latest).map((pkg) => ({
+                    name: pkg.name ?? null,
+                    current: pkg.current ?? null,
+                    latest: pkg.latest ?? null,
+                })),
+            };
+        case 'permissions':
+        case 'env_audit':
+        case 'test_find':
+        case 'preview':
+        case 'breaking':
+            return {
+                mode,
+                summary: result.summary ?? null,
+                count: result.count ?? null,
+                findings: sampleArray(result.findings),
+            };
+        default:
+            return result;
+    }
+}
+export function applyAnalyzeTokenBudget(output, maxTokens) {
+    if (typeof maxTokens !== 'number' || maxTokens <= 0)
+        return output;
+    const maxChars = Math.max(32, maxTokens * 4);
+    if (output.length <= maxChars)
+        return output;
+    return `${output.slice(0, maxChars - 1)}…`;
+}
+export async function readJsonFile(filePath) {
+    try {
+        return (await Bun.file(filePath).json());
+    }
+    catch {
+        return null;
+    }
+}
+export function resolveScanRoot(input, projectRoot) {
+    return input.files && input.files.length > 0 ? resolve(projectRoot, input.files[0]) : projectRoot;
+}
+export function collectExistingPaths(projectRoot, names) {
+    const found = [];
+    for (const name of names) {
+        const candidate = join(projectRoot, name);
+        if (existsSync(candidate)) {
+            found.push(name);
+        }
+    }
+    return found;
+}
+export function loadDependencyVersions(pkgJson) {
+    return {
+        ...(pkgJson.dependencies ?? {}),
+        ...(pkgJson.devDependencies ?? {}),
+    };
+}
+export function parseDiffStats(statOutput) {
+    const files = [];
+    for (const line of statOutput.trim().split('\n')) {
+        const m = line.match(/^\s*(.+?)\s+\|\s+(\d+)\s+([+\-]+)?/);
+        if (!m)
+            continue;
+        const plusMinus = m[3] ?? '';
+        files.push({
+            file: m[1].trim(),
+            insertions: (plusMinus.match(/\+/g) ?? []).length,
+            deletions: (plusMinus.match(/-/g) ?? []).length,
+        });
+    }
+    return files;
+}
+export function findEntryPoint(targetDir, candidates) {
+    for (const name of candidates) {
+        const candidate = join(targetDir, name);
+        if (existsSync(candidate)) {
+            return candidate;
+        }
+    }
+    return null;
+}
+export function validateGitRefs(before, after) {
+    const safeRefPattern = /^[a-zA-Z0-9_.\-~/^@{}:]+$/;
+    if (!safeRefPattern.test(before) || !safeRefPattern.test(after)) {
+        return { error: 'Invalid git ref format', before, after };
+    }
+    return null;
+}
+export function truncateDiffAtBoundary(diff, maxChars) {
+    if (diff.length <= maxChars)
+        return diff;
+    const window = diff.slice(0, maxChars);
+    const fileIdx = window.lastIndexOf('\ndiff --git');
+    const hunkIdx = window.lastIndexOf('\n@@');
+    const cutAt = fileIdx >= 0 ? fileIdx : hunkIdx >= 0 ? hunkIdx : maxChars;
+    const omitted = diff.length - cutAt;
+    return diff.slice(0, cutAt) + `\n[...truncated, ${omitted} additional bytes omitted]`;
+}
+export function parseSemver(version) {
+    const clean = version.replace(/^[^0-9]*/, '');
+    const parts = clean.split('.').map((p) => parseInt(p, 10) || 0);
+    return [parts[0] ?? 0, parts[1] ?? 0, parts[2] ?? 0];
+}
+export function isBreakingUpgrade(current, latest) {
+    const [currentMajor] = parseSemver(current);
+    const [latestMajor] = parseSemver(latest);
+    if (currentMajor === 0 && latestMajor === 0) {
+        const [, currentMinor] = parseSemver(current);
+        const [, latestMinor] = parseSemver(latest);
+        return latestMinor > currentMinor;
+    }
+    return latestMajor > currentMajor;
+}
+export function parseEnvKeys(content) {
+    const keys = new Set();
+    for (const line of content.split('\n')) {
+        const trimmed = line.trim();
+        if (!trimmed || trimmed.startsWith('#'))
+            continue;
+        const eqIdx = trimmed.indexOf('=');
+        if (eqIdx > 0) {
+            keys.add(trimmed.slice(0, eqIdx).trim());
+        }
+    }
+    return keys;
+}
+export function testCandidates(sourceFile, projectRoot) {
+    const rel = relative(projectRoot, resolve(projectRoot, sourceFile));
+    const candidates = [];
+    const noExt = rel.replace(/\.[^.]+$/, '');
+    const basename = noExt.split('/').pop() ?? noExt;
+    const dir = noExt.split('/').slice(0, -1).join('/');
+    const extensions = ['.test.ts', '.test.tsx', '.test.js', '.spec.ts', '.spec.tsx', '.spec.js'];
+    for (const ext of extensions) {
+        candidates.push(join(projectRoot, noExt + ext));
+        if (dir) {
+            candidates.push(join(projectRoot, dir, '__tests__', basename + ext));
+        }
+        else {
+            candidates.push(join(projectRoot, '__tests__', basename + ext));
+        }
+        candidates.push(join(projectRoot, 'test', noExt.replace('src/', '') + ext));
+        candidates.push(join(projectRoot, 'test', basename + ext));
+        if (rel.startsWith('src/')) {
+            const withoutSrc = rel.replace(/^src\//, '').replace(/\.[^.]+$/, '');
+            candidates.push(join(projectRoot, 'src', 'test', withoutSrc + ext));
+        }
+    }
+    return [...new Set(candidates)];
+}

package/dist/platform/tools/analyze/types.d.ts

@@ -0,0 +1,36 @@
+export interface AnalyzeInput {
+    mode: 'impact' | 'dependencies' | 'dead_code' | 'security' | 'coverage' | 'bundle' | 'preview' | 'diff' | 'surface' | 'breaking' | 'semantic_diff' | 'upgrade' | 'permissions' | 'env_audit' | 'test_find';
+    files?: string[];
+    projectRoot?: string;
+    changes?: string;
+    submode?: 'analyze' | 'circular' | 'upgrade';
+    securityScope?: 'secrets' | 'permissions' | 'env' | 'all';
+    before?: string;
+    after?: string;
+    find?: string;
+    replace?: string;
+    include?: string[];
+    packages?: string[];
+    output?: {
+        format?: 'summary' | 'detailed' | 'json';
+        max_tokens?: number;
+    };
+}
+export type ExportedSymbol = {
+    name: string;
+    file: string;
+    line: number;
+    kind?: string;
+};
+export type JsonObject = Record<string, unknown>;
+export type DiffStatFile = {
+    file: string;
+    insertions: number;
+    deletions: number;
+};
+export type SemanticDiffSummary = {
+    summary: string;
+    impact: string[];
+    risk: 'low' | 'medium' | 'high';
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/platform/tools/analyze/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/platform/tools/analyze/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IAC3B,IAAI,EACA,QAAQ,GACR,cAAc,GACd,WAAW,GACX,UAAU,GACV,UAAU,GACV,QAAQ,GACR,SAAS,GACT,MAAM,GACN,SAAS,GACT,UAAU,GACV,eAAe,GACf,SAAS,GACT,aAAa,GACb,WAAW,GACX,WAAW,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,SAAS,GAAG,UAAU,GAAG,SAAS,CAAC;IAC7C,aAAa,CAAC,EAAE,SAAS,GAAG,aAAa,GAAG,KAAK,GAAG,KAAK,CAAC;IAC1D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,MAAM,CAAC,EAAE;QACP,MAAM,CAAC,EAAE,SAAS,GAAG,UAAU,GAAG,MAAM,CAAC;QACzC,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC;CACH;AAED,MAAM,MAAM,cAAc,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAEzF,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEjD,MAAM,MAAM,YAAY,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC;AAEnF,MAAM,MAAM,mBAAmB,GAAG;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,IAAI,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;CACjC,CAAC"}

package/dist/platform/tools/analyze/types.js

@@ -0,0 +1 @@
+export {};

package/dist/platform/tools/auto-repair.d.ts

@@ -0,0 +1,21 @@
+import type { ToolDefinition } from '../types/tools.js';
+/** Result of a tool call repair attempt. */
+export interface RepairResult {
+    repaired: boolean;
+    original: Record<string, unknown>;
+    fixed: Record<string, unknown>;
+    /** Human-readable list of what was fixed. */
+    repairs: string[];
+}
+/**
+ * Attempt to repair a malformed tool call by inferring missing/wrong params.
+ *
+ * Returns repaired arguments and a log of what was fixed.
+ * If no repairs are needed (or repair is impossible), returns the original unchanged
+ * with repaired=false.
+ *
+ * Design: never throws — always returns a result. Premium models that send
+ * correct calls pass through unchanged (zero overhead).
+ */
+export declare function repairToolCall(toolName: string, args: Record<string, unknown>, schema: ToolDefinition): RepairResult;
+//# sourceMappingURL=auto-repair.d.ts.map

package/dist/platform/tools/auto-repair.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto-repair.d.ts","sourceRoot":"","sources":["../../../src/platform/tools/auto-repair.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAIxD,4CAA4C;AAC5C,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,6CAA6C;IAC7C,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,MAAM,EAAE,cAAc,GACrB,YAAY,CAiHd"}