@copilotkit/pathfinder 1.1.0

package/dist/mcp/tools/bash-virtual-files.js

@@ -0,0 +1,65 @@
+export function generateIndexMd(fileTree) {
+    const paths = Object.keys(fileTree).sort();
+    const lines = [
+        `# INDEX`,
+        ``,
+        `${paths.length} files available in this virtual filesystem.`,
+        ``,
+    ];
+    if (paths.length === 0)
+        return lines.join('\n');
+    const tree = {};
+    for (const p of paths) {
+        const parts = p.split('/').filter(Boolean);
+        if (parts.length === 1) {
+            if (!tree['/'])
+                tree['/'] = [];
+            tree['/'].push(parts[0]);
+        }
+        else {
+            const dir = '/' + parts.slice(0, -1).join('/') + '/';
+            if (!tree[dir])
+                tree[dir] = [];
+            tree[dir].push(parts[parts.length - 1]);
+        }
+    }
+    const sortedDirs = Object.keys(tree).sort();
+    for (const dir of sortedDirs) {
+        lines.push(`## ${dir}`);
+        for (const file of tree[dir].sort()) {
+            lines.push(`- ${file}`);
+        }
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+export function generateSearchTipsMd(searchToolNames) {
+    const lines = [
+        `# SEARCH TIPS`,
+        ``,
+        `## Bash Commands`,
+        '- `find / -name "*.ts"` — discover files by pattern',
+        '- `grep -r "pattern" /` — search file contents',
+        '- `cat /path/to/file` — read a specific file',
+        '- `head -n 50 /path/to/file` — read first N lines',
+        '- `ls /path/` — list directory contents',
+        ``,
+    ];
+    if (searchToolNames.length > 0) {
+        lines.push(`## Semantic Search Tools`);
+        lines.push(`For broader, meaning-based search, use these companion tools:`);
+        lines.push(``);
+        for (const name of searchToolNames) {
+            lines.push(`- **${name}** — semantic vector search (finds related content even without exact keyword match)`);
+        }
+        lines.push(``);
+        lines.push(`**Tip:** Use grep for exact matches, search tools for conceptual queries.`);
+    }
+    lines.push(`## Workflow`);
+    lines.push('1. Start with `find` or `ls` to understand the directory structure');
+    lines.push('2. Use `grep -rl "keyword"` to locate files mentioning a topic');
+    lines.push('3. Use `cat` to read the full content of relevant files');
+    lines.push(`4. Read INDEX.md for a full file listing`);
+    return lines.join('\n');
+}
+//# sourceMappingURL=bash-virtual-files.js.map

package/dist/mcp/tools/bash-virtual-files.js.map

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

package/dist/mcp/tools/bash.d.ts

@@ -0,0 +1,25 @@
+import type { Bash } from 'just-bash';
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { BashToolConfig } from '../../types.js';
+import { BashSessionState } from './bash-session.js';
+import type { EmbeddingClient } from '../../indexing/embeddings.js';
+interface ExecResult {
+    stdout: string;
+    stderr: string;
+    exitCode: number;
+}
+export declare function formatBashResult(command: string, result: ExecResult): string;
+/** Extracts the target directory from a bare `cd <path>` command. */
+export declare function parseBareCD(command: string): string | null;
+export interface BashToolOptions {
+    sessionState?: BashSessionState;
+    /** Lazy resolver for session state — called on first tool invocation. */
+    getSessionState?: () => BashSessionState | undefined;
+    /** Embedding client for vector-backed grep. */
+    embeddingClient?: EmbeddingClient;
+    /** Names of search tools, used for grep-miss suggestions. */
+    searchToolNames?: string[];
+}
+export declare function registerBashTool(server: McpServer, toolConfig: BashToolConfig, bash: Bash, options?: BashToolOptions): void;
+export {};
+//# sourceMappingURL=bash.d.ts.map

package/dist/mcp/tools/bash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bash.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/bash.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAIrD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAEpE,UAAU,UAAU;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,MAAM,CAM5E;AAED,qEAAqE;AACrE,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAM1D;AAED,MAAM,WAAW,eAAe;IAC5B,YAAY,CAAC,EAAE,gBAAgB,CAAC;IAChC,yEAAyE;IACzE,eAAe,CAAC,EAAE,MAAM,gBAAgB,GAAG,SAAS,CAAC;IACrD,+CAA+C;IAC/C,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,6DAA6D;IAC7D,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;CAC9B;AAED,wBAAgB,gBAAgB,CAC5B,MAAM,EAAE,SAAS,EACjB,UAAU,EAAE,cAAc,EAC1B,IAAI,EAAE,IAAI,EACV,OAAO,CAAC,EAAE,eAAe,GAC1B,IAAI,CAuHN"}

package/dist/mcp/tools/bash.js

@@ -0,0 +1,140 @@
+import { z } from 'zod';
+import { BashSessionState } from './bash-session.js';
+import { parseGrepCommand, parseQmdCommand, vectorGrep } from './bash-grep.js';
+import { parseRelatedCommand, handleRelatedCommand, formatGrepMissSuggestion } from './bash-related.js';
+import { searchChunks, textSearchChunks } from '../../db/queries.js';
+export function formatBashResult(command, result) {
+    const parts = [`$ ${command}`];
+    if (result.stdout)
+        parts.push(result.stdout);
+    if (result.stderr)
+        parts.push(result.stderr);
+    if (result.exitCode !== 0)
+        parts.push(`[exit code ${result.exitCode}]`);
+    return parts.join('\n');
+}
+/** Extracts the target directory from a bare `cd <path>` command. */
+export function parseBareCD(command) {
+    const trimmed = command.trim();
+    const match = trimmed.match(/^cd\s+((?:[^\s;&|])+)\s*$/);
+    if (match)
+        return match[1];
+    if (trimmed === 'cd')
+        return '/';
+    return null;
+}
+export function registerBashTool(server, toolConfig, bash, options) {
+    const sessionEnabled = toolConfig.bash?.session_state === true;
+    // Session state can be provided directly or via a lazy resolver.
+    // The lazy resolver is useful when the session ID isn't known at registration time.
+    let resolvedSessionState;
+    function getSessionState() {
+        if (resolvedSessionState !== undefined)
+            return resolvedSessionState;
+        if (!sessionEnabled) {
+            resolvedSessionState = null;
+            return null;
+        }
+        if (options?.sessionState) {
+            resolvedSessionState = options.sessionState;
+            return resolvedSessionState;
+        }
+        if (options?.getSessionState) {
+            const state = options.getSessionState();
+            if (state) {
+                resolvedSessionState = state;
+                return state;
+            }
+            // Resolver returned undefined — not ready yet, try again next call
+            return null;
+        }
+        resolvedSessionState = new BashSessionState();
+        return resolvedSessionState;
+    }
+    const inputSchema = {
+        command: z.string().describe("Bash command to execute (e.g., find, grep, cat, head, ls)"),
+    };
+    server.tool(toolConfig.name, toolConfig.description, inputSchema, async ({ command }) => {
+        try {
+            const sessionState = getSessionState();
+            const cwd = sessionState?.getCwd() ?? '/';
+            // Handle bare `cd <path>` — update session CWD without exec
+            if (sessionState) {
+                const cdTarget = parseBareCD(command);
+                if (cdTarget !== null) {
+                    const resolved = sessionState.resolvePath(cdTarget);
+                    // Verify directory exists in virtual FS
+                    const check = await bash.exec(`test -d "${resolved}" && echo ok || echo fail`, { cwd: '/' });
+                    if (check.stdout.trim() !== 'ok') {
+                        return {
+                            content: [{ type: "text", text: formatBashResult(command, {
+                                        stdout: '',
+                                        stderr: `cd: ${cdTarget}: No such file or directory\n`,
+                                        exitCode: 1,
+                                    }) }],
+                        };
+                    }
+                    sessionState.setCwd(resolved);
+                    return {
+                        content: [{ type: "text", text: formatBashResult(command, { stdout: '', stderr: '', exitCode: 0 }) }],
+                    };
+                }
+            }
+            // Intercept `related <path>` command
+            if (options?.embeddingClient) {
+                const rel = parseRelatedCommand(command);
+                if (rel.isRelated) {
+                    const resolvedPath = sessionState ? sessionState.resolvePath(rel.path) : rel.path;
+                    // Try to get file content from bash instance
+                    const escaped = resolvedPath.replace(/\\/g, '\\\\').replace(/"/g, '\\"');
+                    const catResult = await bash.exec(`cat "${escaped}"`, { cwd: '/' });
+                    const fileContent = catResult.exitCode === 0 ? catResult.stdout : undefined;
+                    const relResult = await handleRelatedCommand(resolvedPath, fileContent, options.embeddingClient, (emb, lim) => searchChunks(emb, lim));
+                    return {
+                        content: [{ type: "text", text: formatBashResult(command, relResult) }],
+                    };
+                }
+            }
+            // Intercept `qmd` command for vector-backed semantic search
+            const grepStrategy = toolConfig.bash?.grep_strategy;
+            if (grepStrategy && grepStrategy !== 'memory' && options?.embeddingClient) {
+                const qmd = parseQmdCommand(command);
+                if (qmd.isQmd) {
+                    const qmdResult = await vectorGrep({
+                        pattern: qmd.query,
+                        sourceName: undefined, // search all sources
+                        embeddingClient: options.embeddingClient,
+                        searchChunksFn: searchChunks,
+                        textSearchFn: textSearchChunks,
+                    });
+                    return {
+                        content: [{ type: "text", text: formatBashResult(command, qmdResult) }],
+                    };
+                }
+            }
+            const result = await bash.exec(command, { cwd });
+            // Append grep-miss suggestion when grep returns no results
+            if (options?.searchToolNames && options.searchToolNames.length > 0) {
+                const parsed = parseGrepCommand(command);
+                if (parsed.isGrep && result.exitCode === 1 && !result.stdout.trim()) {
+                    const suggestion = formatGrepMissSuggestion(options.searchToolNames);
+                    return {
+                        content: [{ type: "text", text: formatBashResult(command, { ...result, stderr: (result.stderr || '') + suggestion }) }],
+                    };
+                }
+            }
+            return {
+                content: [{ type: "text", text: formatBashResult(command, result) }],
+            };
+        }
+        catch (error) {
+            const detail = error instanceof Error ? error.message : String(error);
+            console.error(`[${toolConfig.name}] Error: ${detail}`);
+            return {
+                content: [{ type: "text", text: `Error: ${detail}` }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=bash.js.map

package/dist/mcp/tools/bash.js.map

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

package/dist/mcp/tools/collect.d.ts

@@ -0,0 +1,13 @@
+import { z } from 'zod';
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { CollectToolConfig } from '../../types.js';
+/**
+ * Convert a YAML-defined schema (record of field definitions) into a Zod shape record.
+ */
+export declare function yamlSchemaToZod(schema: CollectToolConfig['schema']): Record<string, z.ZodTypeAny>;
+/**
+ * Register a collect tool on the MCP server.
+ * The tool validates inputs against the YAML-defined schema and writes to the DB.
+ */
+export declare function registerCollectTool(server: McpServer, toolConfig: CollectToolConfig): void;
+//# sourceMappingURL=collect.d.ts.map

package/dist/mcp/tools/collect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collect.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/collect.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAKxD;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,iBAAiB,CAAC,QAAQ,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,UAAU,CAAC,CAgCjG;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAC/B,MAAM,EAAE,SAAS,EACjB,UAAU,EAAE,iBAAiB,GAC9B,IAAI,CAuBN"}

package/dist/mcp/tools/collect.js

@@ -0,0 +1,56 @@
+import { z } from 'zod';
+import { insertCollectedData } from '../../db/queries.js';
+/**
+ * Convert a YAML-defined schema (record of field definitions) into a Zod shape record.
+ */
+export function yamlSchemaToZod(schema) {
+    const shape = {};
+    for (const [fieldName, field] of Object.entries(schema)) {
+        let fieldSchema;
+        switch (field.type) {
+            case 'string':
+                fieldSchema = z.string();
+                break;
+            case 'number':
+                fieldSchema = z.number();
+                break;
+            case 'enum':
+                fieldSchema = z.enum(field.values);
+                break;
+            default:
+                throw new Error(`Unsupported field type "${field.type}" for field "${fieldName}"`);
+        }
+        if (field.description) {
+            fieldSchema = fieldSchema.describe(field.description);
+        }
+        if (!field.required) {
+            fieldSchema = fieldSchema.optional();
+        }
+        shape[fieldName] = fieldSchema;
+    }
+    return shape;
+}
+/**
+ * Register a collect tool on the MCP server.
+ * The tool validates inputs against the YAML-defined schema and writes to the DB.
+ */
+export function registerCollectTool(server, toolConfig) {
+    const zodShape = yamlSchemaToZod(toolConfig.schema);
+    server.tool(toolConfig.name, toolConfig.description, zodShape, async (input) => {
+        try {
+            await insertCollectedData(toolConfig.name, input);
+            return {
+                content: [{ type: "text", text: toolConfig.response }],
+            };
+        }
+        catch (error) {
+            const detail = error instanceof Error ? error.message : String(error);
+            console.error(`[${toolConfig.name}] Error inserting collected data: ${detail}`);
+            return {
+                content: [{ type: "text", text: "Error: Failed to store data. Please try again later." }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=collect.js.map

package/dist/mcp/tools/collect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"collect.js","sourceRoot":"","sources":["../../../src/mcp/tools/collect.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAI1D;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,MAAmC;IAC/D,MAAM,KAAK,GAAiC,EAAE,CAAC;IAE/C,KAAK,MAAM,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAyB,EAAE,CAAC;QAC9E,IAAI,WAAyB,CAAC;QAE9B,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;YACjB,KAAK,QAAQ;gBACT,WAAW,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC;gBACzB,MAAM;YACV,KAAK,QAAQ;gBACT,WAAW,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC;gBACzB,MAAM;YACV,KAAK,MAAM;gBACP,WAAW,GAAG,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,MAA+B,CAAC,CAAC;gBAC5D,MAAM;YACV;gBACI,MAAM,IAAI,KAAK,CAAC,2BAA2B,KAAK,CAAC,IAAI,gBAAgB,SAAS,GAAG,CAAC,CAAC;QAC3F,CAAC;QAED,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC;YACpB,WAAW,GAAG,WAAW,CAAC,QAAQ,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;QAC1D,CAAC;QAED,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;YAClB,WAAW,GAAG,WAAW,CAAC,QAAQ,EAAE,CAAC;QACzC,CAAC;QAED,KAAK,CAAC,SAAS,CAAC,GAAG,WAAW,CAAC;IACnC,CAAC;IAED,OAAO,KAAK,CAAC;AACjB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAC/B,MAAiB,EACjB,UAA6B;IAE7B,MAAM,QAAQ,GAAG,eAAe,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;IAEpD,MAAM,CAAC,IAAI,CACP,UAAU,CAAC,IAAI,EACf,UAAU,CAAC,WAAW,EACtB,QAAQ,EACR,KAAK,EAAE,KAAK,EAAE,EAAE;QACZ,IAAI,CAAC;YACD,MAAM,mBAAmB,CAAC,UAAU,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;YAClD,OAAO;gBACH,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,UAAU,CAAC,QAAQ,EAAE,CAAC;aAClE,CAAC;QACN,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,MAAM,MAAM,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACtE,OAAO,CAAC,KAAK,CAAC,IAAI,UAAU,CAAC,IAAI,qCAAqC,MAAM,EAAE,CAAC,CAAC;YAChF,OAAO;gBACH,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,sDAAsD,EAAE,CAAC;gBAClG,OAAO,EAAE,IAAI;aAChB,CAAC;QACN,CAAC;IACL,CAAC,CACJ,CAAC;AACN,CAAC"}

package/dist/mcp/tools/search.d.ts

@@ -0,0 +1,5 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { EmbeddingClient } from '../../indexing/embeddings.js';
+import type { SearchToolConfig } from '../../types.js';
+export declare function registerSearchTool(server: McpServer, embeddingClient: EmbeddingClient, toolConfig: SearchToolConfig): void;
+//# sourceMappingURL=search.d.ts.map

package/dist/mcp/tools/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/search.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,KAAK,EAAE,gBAAgB,EAAe,MAAM,gBAAgB,CAAC;AA2CpE,wBAAgB,kBAAkB,CAC9B,MAAM,EAAE,SAAS,EACjB,eAAe,EAAE,eAAe,EAChC,UAAU,EAAE,gBAAgB,GAC7B,IAAI,CA8BN"}

package/dist/mcp/tools/search.js

@@ -0,0 +1,68 @@
+import { z } from 'zod';
+import { searchChunks } from '../../db/queries.js';
+function formatDocsResults(results) {
+    if (results.length === 0)
+        return "No results found.";
+    return results.map((r, i) => [
+        `SNIPPET ${i + 1}`,
+        `TITLE: ${r.title || r.file_path}`,
+        `SOURCE: ${r.source_url || r.file_path}`,
+        `CONTENT:`,
+        r.content,
+    ].join('\n')).join('\n\n---\n\n');
+}
+function formatCodeResults(results) {
+    if (results.length === 0)
+        return "No results found.";
+    return results.map((r, i) => [
+        `SNIPPET ${i + 1}`,
+        `REPOSITORY: ${r.repo_url}`,
+        `PATH: ${r.file_path}`,
+        `CONTENT:`,
+        r.content,
+    ].join('\n')).join('\n\n---\n\n');
+}
+function formatRawResults(results) {
+    if (results.length === 0)
+        return "No results found.";
+    return results.map((r, i) => [
+        `SNIPPET ${i + 1}`,
+        `SOURCE: ${r.source_url || r.file_path}`,
+        `CONTENT:`,
+        r.content,
+    ].join('\n')).join('\n\n---\n\n');
+}
+function formatResults(results, format) {
+    switch (format) {
+        case 'docs': return formatDocsResults(results);
+        case 'code': return formatCodeResults(results);
+        default: return formatRawResults(results);
+    }
+}
+export function registerSearchTool(server, embeddingClient, toolConfig) {
+    const inputSchema = {
+        query: z.string().describe("The search query"),
+        limit: z.number().min(1).max(toolConfig.max_limit)
+            .default(toolConfig.default_limit).optional()
+            .describe(`Maximum number of results (default: ${toolConfig.default_limit})`),
+    };
+    server.tool(toolConfig.name, toolConfig.description, inputSchema, async ({ query, limit }) => {
+        const effectiveLimit = limit ?? toolConfig.default_limit;
+        try {
+            const embedding = await embeddingClient.embed(query);
+            const results = await searchChunks(embedding, effectiveLimit, toolConfig.source);
+            return {
+                content: [{ type: "text", text: formatResults(results, toolConfig.result_format) }],
+            };
+        }
+        catch (error) {
+            const detail = error instanceof Error ? error.message : String(error);
+            console.error(`[${toolConfig.name}] Error: ${detail}`);
+            return {
+                content: [{ type: "text", text: "Error: Search failed. Please try again later." }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=search.js.map

package/dist/mcp/tools/search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../../../src/mcp/tools/search.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEnD,SAAS,iBAAiB,CAAC,OAAsB;IAC7C,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,mBAAmB,CAAC;IACrD,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QACzB,WAAW,CAAC,GAAG,CAAC,EAAE;QAClB,UAAU,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,SAAS,EAAE;QAClC,WAAW,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC,SAAS,EAAE;QACxC,UAAU;QACV,CAAC,CAAC,OAAO;KACZ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;AACtC,CAAC;AAED,SAAS,iBAAiB,CAAC,OAAsB;IAC7C,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,mBAAmB,CAAC;IACrD,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QACzB,WAAW,CAAC,GAAG,CAAC,EAAE;QAClB,eAAe,CAAC,CAAC,QAAQ,EAAE;QAC3B,SAAS,CAAC,CAAC,SAAS,EAAE;QACtB,UAAU;QACV,CAAC,CAAC,OAAO;KACZ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;AACtC,CAAC;AAED,SAAS,gBAAgB,CAAC,OAAsB;IAC5C,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,mBAAmB,CAAC;IACrD,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QACzB,WAAW,CAAC,GAAG,CAAC,EAAE;QAClB,WAAW,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC,SAAS,EAAE;QACxC,UAAU;QACV,CAAC,CAAC,OAAO;KACZ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;AACtC,CAAC;AAED,SAAS,aAAa,CAAC,OAAsB,EAAE,MAAc;IACzD,QAAQ,MAAM,EAAE,CAAC;QACb,KAAK,MAAM,CAAC,CAAC,OAAO,iBAAiB,CAAC,OAAO,CAAC,CAAC;QAC/C,KAAK,MAAM,CAAC,CAAC,OAAO,iBAAiB,CAAC,OAAO,CAAC,CAAC;QAC/C,OAAO,CAAC,CAAC,OAAO,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAC9C,CAAC;AACL,CAAC;AAED,MAAM,UAAU,kBAAkB,CAC9B,MAAiB,EACjB,eAAgC,EAChC,UAA4B;IAE5B,MAAM,WAAW,GAAG;QAChB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kBAAkB,CAAC;QAC9C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC;aAC7C,OAAO,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC,QAAQ,EAAE;aAC5C,QAAQ,CAAC,uCAAuC,UAAU,CAAC,aAAa,GAAG,CAAC;KACpF,CAAC;IAEF,MAAM,CAAC,IAAI,CACP,UAAU,CAAC,IAAI,EACf,UAAU,CAAC,WAAW,EACtB,WAAW,EACX,KAAK,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE;QACvB,MAAM,cAAc,GAAG,KAAK,IAAI,UAAU,CAAC,aAAa,CAAC;QACzD,IAAI,CAAC;YACD,MAAM,SAAS,GAAG,MAAM,eAAe,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YACrD,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,SAAS,EAAE,cAAc,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;YACjF,OAAO;gBACH,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,aAAa,CAAC,OAAO,EAAE,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;aAC/F,CAAC;QACN,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,MAAM,MAAM,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACtE,OAAO,CAAC,KAAK,CAAC,IAAI,UAAU,CAAC,IAAI,YAAY,MAAM,EAAE,CAAC,CAAC;YACvD,OAAO;gBACH,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,+CAA+C,EAAE,CAAC;gBAC3F,OAAO,EAAE,IAAI;aAChB,CAAC;QACN,CAAC;IACL,CAAC,CACJ,CAAC;AACN,CAAC"}