@massa-ai/core 1.2.1

package/dist/tools/index_project.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Index Project Tool
+ *
+ * Indexes an entire project for optimized contextual search (ASYNC).
+ * Creates embeddings and FTS5 indexes for all relevant files.
+ *
+ * Returns a jobId immediately and processes indexing in background.
+ * Use get_index_status(jobId) to check progress.
+ *
+ * Now powered by the 4-stage ETL Pipeline:
+ *   discover → parse → resolve → load
+ */
+import { IToolHandler } from "@massa-ai/shared";
+import { ToolResponse } from "@massa-ai/shared";
+type CanonicalizePath = (projectPath: string) => Promise<string>;
+export declare function canonicalizeProjectRoot(projectPath: string, canonicalize?: CanonicalizePath): Promise<string>;
+export declare function assertProjectRootReuse(options: {
+    projectId: string;
+    canonicalProjectPath: string;
+    storedProjectPath?: string | null;
+    forceReindex: boolean;
+    canonicalize?: CanonicalizePath;
+}): Promise<void>;
+export declare class IndexProjectTool implements IToolHandler {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            projectPath: {
+                type: string;
+                description: string;
+            };
+            projectId: {
+                type: string;
+                description: string;
+            };
+            forceReindex: {
+                type: string;
+                description: string;
+                default: boolean;
+            };
+            warmCache: {
+                type: string;
+                description: string;
+                default: boolean;
+            };
+            warmupQueries: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
+            include_tests: {
+                type: string;
+                description: string;
+                default: boolean;
+            };
+        };
+        required: string[];
+    };
+    private contextualSearch;
+    constructor();
+    handle(params: unknown): Promise<ToolResponse>;
+    /**
+     * Executa indexação em background usando o ETL Pipeline de 4 estágios.
+     *
+     * O pipeline substitui o monobloco contextualSearch.indexProject() anterior:
+     *   discover → parse → resolve → load
+     *
+     * Mantém compatibilidade: warmCache continua funcionando via contextualSearch.
+     */
+    private executeIndexing;
+}
+export {};
+//# sourceMappingURL=index_project.d.ts.map

package/dist/tools/index_project.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index_project.d.ts","sourceRoot":"","sources":["../../src/tools/index_project.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAuBhD,KAAK,gBAAgB,GAAG,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;AAEjE,wBAAsB,uBAAuB,CAC3C,WAAW,EAAE,MAAM,EACnB,YAAY,GAAE,gBAA2B,GACxC,OAAO,CAAC,MAAM,CAAC,CAEjB;AAED,wBAAsB,sBAAsB,CAAC,OAAO,EAAE;IACpD,SAAS,EAAE,MAAM,CAAC;IAClB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,YAAY,EAAE,OAAO,CAAC;IACtB,YAAY,CAAC,EAAE,gBAAgB,CAAC;CACjC,GAAG,OAAO,CAAC,IAAI,CAAC,CAgBhB;AAED,qBAAa,gBAAiB,YAAW,YAAY;IACnD,IAAI,SAAmB;IACvB,WAAW,SACuE;IAClF,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAmCT;IAEF,OAAO,CAAC,gBAAgB,CAAsB;;IAMxC,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,YAAY,CAAC;IAiIpD;;;;;;;OAOG;YACW,eAAe;CAkG9B"}

package/dist/tools/index_project.js

@@ -0,0 +1,259 @@
+/**
+ * Index Project Tool
+ *
+ * Indexes an entire project for optimized contextual search (ASYNC).
+ * Creates embeddings and FTS5 indexes for all relevant files.
+ *
+ * Returns a jobId immediately and processes indexing in background.
+ * Use get_index_status(jobId) to check progress.
+ *
+ * Now powered by the 4-stage ETL Pipeline:
+ *   discover → parse → resolve → load
+ */
+import { ContextualSearchRLM } from "../services/search/contextual-search-rlm.js";
+import { logger } from "@massa-ai/shared";
+import { indexJobTracker } from "../services/jobs/index-job-tracker.js";
+import { EtlPipeline } from "../services/etl/pipeline.js";
+import { workspaceManager } from "../services/workspace/workspace-manager.js";
+import { realpath } from "node:fs/promises";
+import path from "path";
+import { assertParserReadyForIndexing } from "../services/structural/parser-readiness.js";
+import { ManagedRunRepositoryPg } from "../data/managed-runs/managed-run-repository-pg.js";
+export async function canonicalizeProjectRoot(projectPath, canonicalize = realpath) {
+    return canonicalize(path.resolve(projectPath));
+}
+export async function assertProjectRootReuse(options) {
+    if (!options.storedProjectPath || options.forceReindex)
+        return;
+    const canonicalize = options.canonicalize ?? realpath;
+    let storedCanonical;
+    try {
+        storedCanonical = await canonicalize(path.resolve(options.storedProjectPath));
+    }
+    catch {
+        storedCanonical = path.resolve(options.storedProjectPath);
+    }
+    if (storedCanonical !== options.canonicalProjectPath) {
+        throw new Error(`Project ID "${options.projectId}" already indexes canonical root ` +
+            `"${storedCanonical}", not "${options.canonicalProjectPath}"; ` +
+            "use forceReindex only after verifying ownership of the existing project");
+    }
+}
+export class IndexProjectTool {
+    name = "index_project";
+    description = "Index a project directory for contextual code search with semantic embeddings";
+    inputSchema = {
+        type: "object",
+        properties: {
+            projectPath: {
+                type: "string",
+                description: "Absolute path to the project directory to index",
+            },
+            projectId: {
+                type: "string",
+                description: "Unique identifier for the project (defaults to directory name)",
+            },
+            forceReindex: {
+                type: "boolean",
+                description: "Force reindex even if project already exists",
+                default: false,
+            },
+            warmCache: {
+                type: "boolean",
+                description: "Pre-cache common queries after indexing for faster initial searches",
+                default: false,
+            },
+            warmupQueries: {
+                type: "array",
+                items: { type: "string" },
+                description: "Custom queries to pre-cache (uses defaults if not provided)",
+            },
+            include_tests: {
+                type: "boolean",
+                description: "Index test/benchmark files too so typed edges from .test.ts files are captured (default false)",
+                default: false,
+            },
+        },
+        required: ["projectPath"],
+    };
+    contextualSearch;
+    constructor() {
+        this.contextualSearch = new ContextualSearchRLM();
+    }
+    async handle(params) {
+        const { projectPath, projectId, forceReindex = false, warmCache = false, warmupQueries, include_tests = false, } = params;
+        try {
+            // Do not create or return an accepted job while native parsing is down.
+            await assertParserReadyForIndexing();
+            const canonicalProjectPath = await canonicalizeProjectRoot(projectPath);
+            // Gera projectId se não fornecido
+            const finalProjectId = projectId || path.basename(canonicalProjectPath) || "default";
+            const existing = await workspaceManager.getWorkspace(finalProjectId);
+            await assertProjectRootReuse({
+                projectId: finalProjectId,
+                canonicalProjectPath,
+                storedProjectPath: existing?.project_path,
+                forceReindex,
+            });
+            // Cria job de indexação
+            const job = indexJobTracker.createJob(finalProjectId, canonicalProjectPath);
+            logger.info("Indexing job created", {
+                jobId: job.jobId,
+                projectPath: canonicalProjectPath,
+                projectId: finalProjectId,
+            });
+            // ── Wave 5 FR-09: acquire a managed_runs lease synchronously so the
+            // MCP/HTTP caller gets 202 (acquired) or 409 busy BEFORE the long ETL
+            // runs in the background. The lease is passed into the pipeline, which
+            // owns heartbeat/complete/abort. eventId is derived from the job id so
+            // a retry of the same job is idempotent at the lease layer (a
+            // completed/aborted row's event_id is not reused because the partial
+            // UNIQUE only covers active rows).
+            const eventId = `index:${job.jobId}`;
+            const managedRunRepo = ManagedRunRepositoryPg.getInstance();
+            let lease;
+            try {
+                const beginOutcome = await managedRunRepo.begin({
+                    projectId: finalProjectId,
+                    runKind: "indexing",
+                    eventId,
+                });
+                if (beginOutcome.status === "busy") {
+                    // 409: another live indexer holds this project. Surface the active
+                    // runId so the caller can poll get_index_status.
+                    indexJobTracker.setResult(job.jobId, { filesIndexed: 0, chunksIndexed: 0, errors: 0, duration: 0 }, `indexing_busy:${beginOutcome.activeRunId}`);
+                    return {
+                        success: false,
+                        error: `indexing_busy:${beginOutcome.activeRunId}`,
+                        data: {
+                            jobId: job.jobId,
+                            projectId: finalProjectId,
+                            status: "busy",
+                            activeRunId: beginOutcome.activeRunId,
+                            leaseExpiresAt: beginOutcome.leaseExpiresAt,
+                            message: "Another indexing run is active for this project. Poll get_index_status(activeRunId).",
+                        },
+                    };
+                }
+                lease = beginOutcome.lease;
+            }
+            catch (beginError) {
+                logger.error("managed_runs begin failed", beginError, { jobId: job.jobId, projectId: finalProjectId });
+                // Fail loud — a lease failure is a 500, not a silent retry. The caller
+                // can retry; the lease table is the source of truth.
+                indexJobTracker.setResult(job.jobId, { filesIndexed: 0, chunksIndexed: 0, errors: 1, duration: 0 }, `managed_runs_begin_failed:${beginError.message}`);
+                return {
+                    success: false,
+                    error: `Failed to acquire indexing lease: ${beginError.message}`,
+                };
+            }
+            // Executa indexação em background (não await)
+            this.executeIndexing(job.jobId, finalProjectId, canonicalProjectPath, forceReindex, warmCache, warmupQueries, include_tests, lease).catch((error) => {
+                logger.error("Background indexing failed", error, {
+                    jobId: job.jobId,
+                });
+            });
+            // Return immediately with jobId
+            return {
+                success: true,
+                data: {
+                    jobId: job.jobId,
+                    projectId: finalProjectId,
+                    projectPath: canonicalProjectPath,
+                    status: "started",
+                    runId: lease.runId,
+                    message: "Indexing started in background. Use get_index_status(jobId) to check progress.",
+                },
+            };
+        }
+        catch (error) {
+            logger.error("Failed to start indexing job", error, {
+                projectPath,
+                projectId,
+            });
+            return {
+                success: false,
+                error: `Failed to start indexing: ${error.message}`,
+            };
+        }
+    }
+    /**
+     * Executa indexação em background usando o ETL Pipeline de 4 estágios.
+     *
+     * O pipeline substitui o monobloco contextualSearch.indexProject() anterior:
+     *   discover → parse → resolve → load
+     *
+     * Mantém compatibilidade: warmCache continua funcionando via contextualSearch.
+     */
+    async executeIndexing(jobId, projectId, projectPath, forceReindex, warmCache, warmupQueries, include_tests = false, managedRunLease) {
+        const startTime = Date.now();
+        try {
+            indexJobTracker.updateStatus(jobId, "running");
+            logger.info("Starting project indexing via ETL Pipeline", {
+                jobId,
+                projectPath,
+                projectId,
+                forceReindex,
+                warmCache,
+                include_tests,
+            });
+            // ETL Pipeline: discover → parse → resolve → load
+            // EventBus integration handles progress updates and WorkspaceManager status
+            const etlResult = await EtlPipeline.getInstance().run({
+                projectId,
+                projectPath,
+                jobId,
+                forceReindex,
+                include_tests,
+                managedRunLease,
+            });
+            const duration = Date.now() - startTime;
+            logger.info("ETL Pipeline completed", {
+                jobId,
+                projectId,
+                duration,
+                filesIndexed: etlResult.filesIndexed,
+                filesSkipped: etlResult.filesSkipped,
+                chunksIndexed: etlResult.chunksIndexed,
+                symbolsIndexed: etlResult.symbolsIndexed,
+                errors: etlResult.errors,
+                stageTimings: etlResult.stageTimings,
+            });
+            // Warmup semantic search cache if requested (unchanged from before)
+            if (warmCache) {
+                logger.info("Starting cache warmup", { jobId, projectId });
+                const warmupStats = await this.contextualSearch.warmupCache(projectId, projectPath, warmupQueries);
+                logger.info("Cache warmup completed", { jobId, projectId, ...warmupStats });
+            }
+            // Mark job complete. Emit 100% progress immediately before the terminal
+            // transition so any poller that reads progress atomically with status sees
+            // a consistent completed+100% shape (the pipeline also emits this; this is
+            // belt-and-suspenders in case the pipeline path changes).
+            indexJobTracker.updateProgress(jobId, etlResult.filesIndexed, etlResult.filesIndexed);
+            await indexJobTracker.setResultAndFlush(jobId, {
+                filesIndexed: etlResult.filesIndexed,
+                chunksIndexed: etlResult.chunksIndexed,
+                errors: etlResult.errors,
+                duration,
+                activatedGraphGenerationId: etlResult.activatedGraphGenerationId,
+                parserDiagnostics: etlResult.parserDiagnostics,
+            });
+        }
+        catch (error) {
+            const duration = Date.now() - startTime;
+            logger.error("Project indexing failed", error, {
+                jobId,
+                projectPath,
+                projectId,
+                duration,
+            });
+            indexJobTracker.setResult(jobId, {
+                filesIndexed: 0,
+                chunksIndexed: 0,
+                errors: 1,
+                duration,
+            }, error.message);
+        }
+    }
+}
+//# sourceMappingURL=index_project.js.map

package/dist/tools/index_project.js.map

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

package/dist/tools/list_checkpoints.d.ts

@@ -0,0 +1,59 @@
+/**
+ * List Checkpoints Tool
+ *
+ * MCP tool for listing saved task checkpoints.
+ * Supports filtering by task, project, type, and expiry.
+ *
+ * Thin layer — delegates to CheckpointManager service.
+ */
+import { IToolHandler, ToolResponse } from "@massa-ai/shared";
+export declare class ListCheckpointsTool implements IToolHandler {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            taskId: {
+                type: string;
+                description: string;
+            };
+            projectId: {
+                type: string;
+                description: string;
+            };
+            checkpointType: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            includeExpired: {
+                type: string;
+                description: string;
+                default: boolean;
+            };
+            limit: {
+                type: string;
+                description: string;
+                default: number;
+            };
+            format: {
+                type: string;
+                enum: string[];
+                description: string;
+                default: string;
+            };
+            fields: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
+        };
+        required: never[];
+    };
+    private checkpointManager;
+    constructor();
+    handle(params: unknown): Promise<ToolResponse>;
+}
+//# sourceMappingURL=list_checkpoints.d.ts.map

package/dist/tools/list_checkpoints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list_checkpoints.d.ts","sourceRoot":"","sources":["../../src/tools/list_checkpoints.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,YAAY,EAAE,YAAY,EAAkB,MAAM,kBAAkB,CAAC;AAe9E,qBAAa,mBAAoB,YAAW,YAAY;IACtD,IAAI,SAAsB;IAC1B,WAAW,SAG2B;IACtC,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAwCT;IAEF,OAAO,CAAC,iBAAiB,CAAoB;;IAMvC,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,YAAY,CAAC;CA6DrD"}

package/dist/tools/list_checkpoints.js

@@ -0,0 +1,110 @@
+/**
+ * List Checkpoints Tool
+ *
+ * MCP tool for listing saved task checkpoints.
+ * Supports filtering by task, project, type, and expiry.
+ *
+ * Thin layer — delegates to CheckpointManager service.
+ */
+import { logger } from "@massa-ai/shared";
+import { CheckpointManager } from "../services/checkpoint/checkpoint-manager.js";
+import { serializeToolResponse } from "./serialize.js";
+export class ListCheckpointsTool {
+    name = "list_checkpoints";
+    description = "List saved task checkpoints (versioned TASK state). Filter by task ID, " +
+        "project, or type. These are task-progress snapshots, not session-continuity " +
+        "snapshots (see compact_snapshot).";
+    inputSchema = {
+        type: "object",
+        properties: {
+            taskId: {
+                type: "string",
+                description: "Filter by task ID",
+            },
+            projectId: {
+                type: "string",
+                description: "Filter by project ID",
+            },
+            checkpointType: {
+                type: "string",
+                enum: ["auto", "manual", "milestone"],
+                description: "Filter by checkpoint type",
+            },
+            includeExpired: {
+                type: "boolean",
+                description: "Include expired checkpoints",
+                default: false,
+            },
+            limit: {
+                type: "number",
+                description: "Max results to return",
+                default: 10,
+            },
+            format: {
+                type: "string",
+                enum: ["json", "toon"],
+                description: "Output format",
+                default: "toon",
+            },
+            fields: {
+                type: "array",
+                items: { type: "string" },
+                description: "Projection — keep only these keys (dotted paths supported, e.g. ['nodes.symbol']). Absent/empty → full data.",
+            },
+        },
+        required: [],
+    };
+    checkpointManager;
+    constructor() {
+        this.checkpointManager = CheckpointManager.getInstance();
+    }
+    async handle(params) {
+        const { taskId, projectId, checkpointType, includeExpired = false, limit = 10, format = "toon", fields, } = params;
+        try {
+            const checkpoints = this.checkpointManager.listCheckpoints({
+                taskId,
+                projectId,
+                checkpointType: checkpointType,
+                includeExpired,
+                limit,
+            });
+            const stats = this.checkpointManager.getStats();
+            const items = checkpoints.map((cp) => ({
+                id: cp.id,
+                taskId: cp.taskId,
+                description: cp.state.description,
+                status: cp.state.status,
+                progress: `${cp.state.progress.percentage}%`,
+                currentStep: cp.state.progress.currentStep,
+                type: cp.checkpointType,
+                agentId: cp.agentId,
+                createdAt: cp.createdAt,
+                expiresAt: cp.expiresAt,
+                memoriesCount: cp.memoryIds.length,
+                filesCount: cp.fileChanges.length,
+            }));
+            logger.info("Checkpoint tool: listed", {
+                count: items.length,
+                taskId,
+                projectId,
+            });
+            const responseData = {
+                checkpoints: items,
+                total: stats.totalCheckpoints,
+                stats: {
+                    byType: stats.byType,
+                    totalSizeBytes: stats.totalSizeBytes,
+                },
+            };
+            return serializeToolResponse(responseData, { format, fields });
+        }
+        catch (error) {
+            logger.error("Failed to list checkpoints", error);
+            return {
+                success: false,
+                error: `Failed to list checkpoints: ${error.message}`,
+            };
+        }
+    }
+}
+//# sourceMappingURL=list_checkpoints.js.map

package/dist/tools/list_checkpoints.js.map

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

package/dist/tools/list_projects.d.ts

@@ -0,0 +1,24 @@
+/**
+ * List Projects Tool (list_projects)
+ *
+ * Lists all indexed workspaces with their status and statistics.
+ * Data sourced from WorkspaceManager (PostgreSQL workspaces table).
+ */
+import { IToolHandler, ToolResponse } from "@massa-ai/shared";
+export declare class ListProjectsTool implements IToolHandler {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            status: {
+                type: string;
+                enum: string[];
+                description: string;
+                default: string;
+            };
+        };
+    };
+    handle(params: unknown): Promise<ToolResponse>;
+}
+//# sourceMappingURL=list_projects.d.ts.map

package/dist/tools/list_projects.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list_projects.d.ts","sourceRoot":"","sources":["../../src/tools/list_projects.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAS9D,qBAAa,gBAAiB,YAAW,YAAY;IACnD,IAAI,SAAmB;IACvB,WAAW,SAC0H;IAErI,WAAW;;;;;;;;;;MAUT;IAEI,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,YAAY,CAAC;CAuCrD"}

package/dist/tools/list_projects.js

@@ -0,0 +1,58 @@
+/**
+ * List Projects Tool (list_projects)
+ *
+ * Lists all indexed workspaces with their status and statistics.
+ * Data sourced from WorkspaceManager (PostgreSQL workspaces table).
+ */
+import { workspaceManager } from "../services/workspace/workspace-manager.js";
+import { validateEnum } from "./enum-validation.js";
+export class ListProjectsTool {
+    name = "list_projects";
+    description = "List all indexed projects with their status (pending/indexing/indexed/error), file counts, symbol counts, and last indexed time.";
+    inputSchema = {
+        type: "object",
+        properties: {
+            status: {
+                type: "string",
+                enum: ["pending", "indexing", "indexed", "error", "all"],
+                description: "Filter by workspace status. Defaults to 'all'.",
+                default: "all",
+            },
+        },
+    };
+    async handle(params) {
+        const status = validateEnum("status", (params ?? {}).status ?? "all", ["pending", "indexing", "indexed", "error", "all"]);
+        try {
+            const workspaces = await workspaceManager.listWorkspaces(status);
+            return {
+                success: true,
+                data: {
+                    workspaces: workspaces.map((w) => ({
+                        projectId: w.project_id,
+                        projectPath: w.project_path,
+                        displayName: w.display_name,
+                        status: w.status,
+                        lastIndexedAt: w.last_indexed_at
+                            ? new Date(w.last_indexed_at).toISOString()
+                            : null,
+                        lastError: w.last_error,
+                        filesCount: w.files_count,
+                        chunksCount: w.chunks_count,
+                        symbolsCount: w.symbols_count,
+                        createdAt: new Date(w.created_at).toISOString(),
+                        updatedAt: new Date(w.updated_at).toISOString(),
+                    })),
+                    total: workspaces.length,
+                    filter: status,
+                },
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: `Failed to list projects: ${error.message}`,
+            };
+        }
+    }
+}
+//# sourceMappingURL=list_projects.js.map

package/dist/tools/list_projects.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list_projects.js","sourceRoot":"","sources":["../../src/tools/list_projects.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,gBAAgB,EAAE,MAAM,4CAA4C,CAAC;AAE9E,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAMpD,MAAM,OAAO,gBAAgB;IAC3B,IAAI,GAAG,eAAe,CAAC;IACvB,WAAW,GACT,kIAAkI,CAAC;IAErI,WAAW,GAAG;QACZ,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,CAAC,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,CAAC;gBACxD,WAAW,EAAE,gDAAgD;gBAC7D,OAAO,EAAE,KAAK;aACf;SACF;KACF,CAAC;IAEF,KAAK,CAAC,MAAM,CAAC,MAAe;QAC1B,MAAM,MAAM,GAAG,YAAY,CACzB,QAAQ,EACP,CAAC,MAAM,IAAI,EAAE,CAAwB,CAAC,MAAM,IAAI,KAAK,EACtD,CAAC,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,CAAU,CAC5D,CAAC;QAEF,IAAI,CAAC;YACH,MAAM,UAAU,GAAG,MAAM,gBAAgB,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;YAEjE,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,IAAI,EAAE;oBACJ,UAAU,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;wBACjC,SAAS,EAAE,CAAC,CAAC,UAAU;wBACvB,WAAW,EAAE,CAAC,CAAC,YAAY;wBAC3B,WAAW,EAAE,CAAC,CAAC,YAAY;wBAC3B,MAAM,EAAE,CAAC,CAAC,MAAM;wBAChB,aAAa,EAAE,CAAC,CAAC,eAAe;4BAC9B,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,WAAW,EAAE;4BAC3C,CAAC,CAAC,IAAI;wBACR,SAAS,EAAE,CAAC,CAAC,UAAU;wBACvB,UAAU,EAAE,CAAC,CAAC,WAAW;wBACzB,WAAW,EAAE,CAAC,CAAC,YAAY;wBAC3B,YAAY,EAAE,CAAC,CAAC,aAAa;wBAC7B,SAAS,EAAE,IAAI,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,WAAW,EAAE;wBAC/C,SAAS,EAAE,IAAI,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,WAAW,EAAE;qBAChD,CAAC,CAAC;oBACH,KAAK,EAAE,UAAU,CAAC,MAAM;oBACxB,MAAM,EAAE,MAAM;iBACf;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,4BAA6B,KAAe,CAAC,OAAO,EAAE;aAC9D,CAAC;QACJ,CAAC;IACH,CAAC;CACF"}