@qodalis/mcp-cli 0.1.0 → 0.2.0

package/dist/src/dev/docs.js

@@ -0,0 +1,275 @@
+import { readFileSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+/**
+ * The plugin-development guide (`llms-full.txt`): plain markdown with a
+ * `# Qodalis CLI plugin development` title, `## ` sections and `### ` topics,
+ * each topic self-contained and starting with a one-line summary.
+ */
+export const DOCS_TITLE = '# Qodalis CLI plugin development';
+/** How long fetched docs are reused before they are fetched again. */
+export const DOCS_TTL_MS = 60 * 60_000;
+/** After a failed download the URL is tried again after this long. */
+export const DOCS_RETRY_MS = 5 * 60_000;
+const FETCH_TIMEOUT_MS = 10_000;
+export const slugify = (text) => text
+    .toLowerCase()
+    .replace(/[`'"]/g, '')
+    .replace(/[^a-z0-9]+/g, '-')
+    .replace(/^-+|-+$/g, '') || 'untitled';
+const FENCE = /^\s*(```|~~~)/;
+/** First prose line of a block: skips blank lines, code fences, tables and nested headings. */
+const firstProseLine = (lines) => {
+    let inFence = false;
+    for (const line of lines) {
+        if (FENCE.test(line)) {
+            inFence = !inFence;
+            continue;
+        }
+        const trimmed = line.trim();
+        if (inFence || !trimmed || trimmed.startsWith('#') || trimmed.startsWith('|')) {
+            continue;
+        }
+        return trimmed.replace(/^[-*>]\s+/, '');
+    }
+    return '';
+};
+/** Splits the guide into `## ` sections and `### ` topics; headings inside code fences are ignored. */
+export const parseDocs = (markdown, source = 'inline') => {
+    const lines = markdown.replace(/\r\n/g, '\n').split('\n');
+    const sections = [];
+    let section;
+    let topic;
+    const closed = [];
+    let inFence = false;
+    for (const line of lines) {
+        if (FENCE.test(line)) {
+            inFence = !inFence;
+        }
+        const h2 = !inFence && /^##\s+(.+?)\s*#*\s*$/.exec(line);
+        const h3 = !inFence && !h2 && /^###\s+(.+?)\s*#*\s*$/.exec(line);
+        if (h2 && !line.startsWith('###')) {
+            if (section) {
+                closed.push(section);
+            }
+            section = { lines: [line], title: h2[1], topics: [] };
+            topic = undefined;
+            continue;
+        }
+        if (h3 && section) {
+            topic = { lines: [line], section: section.title, title: h3[1] };
+            section.topics.push(topic);
+            section.lines.push(line);
+            continue;
+        }
+        section?.lines.push(line);
+        topic?.lines.push(line);
+    }
+    if (section) {
+        closed.push(section);
+    }
+    const sectionSlugs = new Set();
+    for (const open of closed) {
+        let slug = slugify(open.title);
+        for (let n = 2; sectionSlugs.has(slug); n++) {
+            slug = `${slugify(open.title)}-${n}`;
+        }
+        sectionSlugs.add(slug);
+        const topicSlugs = new Set();
+        const topics = open.topics.map((t) => {
+            let topicSlug = slugify(t.title);
+            for (let n = 2; topicSlugs.has(topicSlug); n++) {
+                topicSlug = `${slugify(t.title)}-${n}`;
+            }
+            topicSlugs.add(topicSlug);
+            return {
+                content: t.lines.join('\n').trim(),
+                section: open.title,
+                summary: firstProseLine(t.lines.slice(1)),
+                title: t.title,
+                uri: `${slug}/${topicSlug}`,
+            };
+        });
+        sections.push({ content: open.lines.join('\n').trim(), slug, title: open.title, topics });
+    }
+    return { sections, source, topics: sections.flatMap((s) => s.topics) };
+};
+const STOP_WORDS = new Set('a an and are as at be by can do does for from how i in is it my of on or the to use using what when with'.split(' '));
+/** Lower-case search terms; `ICliModule`, `read-line` and `readLine` all stay searchable. */
+export const searchTerms = (query) => [
+    ...new Set(query
+        .toLowerCase()
+        .split(/[^a-z0-9_.@/-]+/)
+        .map((term) => term.replace(/^[-./]+|[-./]+$/g, ''))
+        .filter((term) => term.length > 1 && !STOP_WORDS.has(term))),
+];
+const countOccurrences = (haystack, needle) => {
+    let count = 0;
+    for (let i = haystack.indexOf(needle); i !== -1; i = haystack.indexOf(needle, i + needle.length)) {
+        count++;
+    }
+    return count;
+};
+/** A ~200-character line around the first body match. */
+const excerptFor = (topic, terms) => {
+    const lines = topic.content.split('\n').slice(1);
+    const line = lines.find((l) => terms.some((t) => l.toLowerCase().includes(t)) && l.trim()) ?? '';
+    const trimmed = line.trim();
+    if (trimmed.length <= 200) {
+        return trimmed;
+    }
+    const at = Math.max(0, Math.min(...terms.map((t) => trimmed.toLowerCase().indexOf(t)).filter((i) => i >= 0)) - 60);
+    return `${at > 0 ? '…' : ''}${trimmed.slice(at, at + 200)}…`;
+};
+/**
+ * Keyword ranking over topics: a term in the title weighs most, then the summary and
+ * the section name, then occurrences in the body (capped); every matched term and an
+ * exact phrase match add a bonus, so topics covering the whole query come first.
+ */
+export const searchDocs = (docs, query, limit = 5) => {
+    const terms = searchTerms(query);
+    if (terms.length === 0) {
+        return [];
+    }
+    const phrase = query.trim().toLowerCase();
+    const hits = [];
+    for (const topic of docs.topics) {
+        const title = topic.title.toLowerCase();
+        const summary = topic.summary.toLowerCase();
+        const section = topic.section.toLowerCase();
+        const body = topic.content.toLowerCase();
+        let score = 0;
+        let matched = 0;
+        for (const term of terms) {
+            const inBody = countOccurrences(body, term);
+            if (inBody === 0) {
+                continue;
+            }
+            matched++;
+            score += title.includes(term) ? 10 : 0;
+            score += summary.includes(term) ? 4 : 0;
+            score += section.includes(term) ? 2 : 0;
+            score += Math.min(inBody, 6);
+        }
+        if (matched === 0) {
+            continue;
+        }
+        score += (matched - 1) * 5;
+        score += phrase.length > 3 && body.includes(phrase) ? 8 : 0;
+        hits.push({ excerpt: excerptFor(topic, terms), score, topic });
+    }
+    return hits
+        .sort((a, b) => b.score - a.score || a.topic.uri.localeCompare(b.topic.uri))
+        .slice(0, Math.max(1, limit));
+};
+const normalize = (text) => text.toLowerCase().replace(/[`*_]/g, '').replace(/\s+/g, ' ').trim();
+/**
+ * A topic by heading (case-insensitive), `Section › Topic`, `Section/Topic` or its
+ * resource path; a whole `## ` section by its heading; else a unique partial match.
+ */
+export const readDocs = (docs, query) => {
+    const wanted = normalize(query.replace(/^qcli-docs:\/\//, ''));
+    if (!wanted) {
+        return { kind: 'not-found' };
+    }
+    const byUri = docs.topics.find((t) => t.uri === wanted);
+    if (byUri) {
+        return { kind: 'topics', topics: [byUri] };
+    }
+    const qualified = /^(.+?)\s*(?:›|>|\/|::)\s*(.+)$/.exec(wanted);
+    if (qualified) {
+        const [, sectionName, topicName] = qualified;
+        const found = docs.topics.filter((t) => (normalize(t.section) === sectionName || slugify(t.section) === sectionName) &&
+            (normalize(t.title) === topicName || slugify(t.title) === topicName));
+        if (found.length > 0) {
+            return { kind: 'topics', topics: found };
+        }
+    }
+    const exact = docs.topics.filter((t) => normalize(t.title) === wanted);
+    if (exact.length > 0) {
+        return { kind: 'topics', topics: exact };
+    }
+    const section = docs.sections.find((s) => normalize(s.title) === wanted || s.slug === wanted);
+    if (section) {
+        return { kind: 'section', section };
+    }
+    const partial = docs.topics.filter((t) => normalize(t.title).includes(wanted));
+    if (partial.length === 1) {
+        return { kind: 'topics', topics: partial };
+    }
+    return { kind: 'not-found' };
+};
+/** `Section › Topic` lines, grouped by section, for "not found" answers. */
+export const listTopics = (docs) => docs.sections
+    .map((s) => `## ${s.title}\n${s.topics.map((t) => `- ${t.title}${t.summary ? `: ${t.summary}` : ''}`).join('\n')}`)
+    .join('\n\n');
+/** The `docs/llms-full.txt` bundled with the package (one or two levels above this file). */
+export const readBundledDocs = () => {
+    for (const candidate of ['../../docs/llms-full.txt', '../../../docs/llms-full.txt']) {
+        try {
+            return readFileSync(fileURLToPath(new URL(candidate, import.meta.url)), 'utf8');
+        }
+        catch {
+            // try the next location
+        }
+    }
+    throw new Error('The bundled docs snapshot (docs/llms-full.txt) is missing.');
+};
+/**
+ * The guide from `url` (cached for {@link DOCS_TTL_MS}), falling back to the last good
+ * download and then to the bundled snapshot, so the tools work offline and before the
+ * site publishes the file. A response that is not the guide (an HTML page) is ignored.
+ */
+export class DocsSource {
+    options;
+    cached;
+    downloaded;
+    loading;
+    snapshotDocs;
+    constructor(options) {
+        this.options = options;
+    }
+    async get() {
+        const now = (this.options.now ?? Date.now)();
+        if (this.cached && now < this.cached.expires) {
+            return this.cached.docs;
+        }
+        this.loading ??= this.load(now).finally(() => (this.loading = undefined));
+        return this.loading;
+    }
+    async load(now) {
+        const { url } = this.options;
+        try {
+            const response = await (this.options.fetch ?? fetch)(url, {
+                headers: { accept: 'text/plain, text/markdown;q=0.9, */*;q=0.1' },
+                signal: AbortSignal.timeout(FETCH_TIMEOUT_MS),
+            });
+            if (!response.ok) {
+                throw new Error(`HTTP ${response.status}`);
+            }
+            const text = await response.text();
+            if (!text.trimStart().startsWith(DOCS_TITLE)) {
+                throw new Error(`not the plugin-development guide (expected "${DOCS_TITLE}")`);
+            }
+            this.downloaded = parseDocs(text, url);
+            this.cached = {
+                docs: this.downloaded,
+                expires: now + (this.options.ttlMs ?? DOCS_TTL_MS),
+            };
+            return this.downloaded;
+        }
+        catch (error) {
+            const reason = error instanceof Error ? error.message : String(error);
+            let docs = this.downloaded;
+            if (docs) {
+                this.options.log?.(`docs: ${url} failed (${reason}); reusing the last download`);
+            }
+            else {
+                this.options.log?.(`docs: ${url} failed (${reason}); using the bundled snapshot`);
+                docs = this.snapshotDocs ??= parseDocs((this.options.snapshot ?? readBundledDocs)(), 'bundled snapshot');
+            }
+            this.cached = { docs, expires: now + DOCS_RETRY_MS };
+            return docs;
+        }
+    }
+}
+//# sourceMappingURL=docs.js.map

package/dist/src/dev/docs.js.map

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

package/dist/src/dev/prompts.d.ts

@@ -0,0 +1,11 @@
+import type { GetPromptResult, Prompt } from '@modelcontextprotocol/server';
+/** MCP prompts that walk an assistant through plugin work with the `qcli_*` tools. */
+export declare const PROMPTS: Prompt[];
+export declare class PromptError extends Error {
+}
+export type PromptContext = {
+    /** qcli_scaffold_plugin is available (not read-only, not filtered out) */
+    canScaffold: boolean;
+};
+export declare const getPrompt: (name: string, args: Record<string, string> | undefined, ctx: PromptContext) => GetPromptResult;
+//# sourceMappingURL=prompts.d.ts.map

package/dist/src/dev/prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../../src/dev/prompts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAC;AAE5E,sFAAsF;AACtF,eAAO,MAAM,OAAO,EAAE,MAAM,EAqC3B,CAAC;AAEF,qBAAa,WAAY,SAAQ,KAAK;CAAG;AA+CzC,MAAM,MAAM,aAAa,GAAG;IACxB,0EAA0E;IAC1E,WAAW,EAAE,OAAO,CAAC;CACxB,CAAC;AAoEF,eAAO,MAAM,SAAS,GAClB,MAAM,MAAM,EACZ,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,EACxC,KAAK,aAAa,KACnB,eASF,CAAC"}

package/dist/src/dev/prompts.js

@@ -0,0 +1,141 @@
+/** MCP prompts that walk an assistant through plugin work with the `qcli_*` tools. */
+export const PROMPTS = [
+    {
+        arguments: [
+            {
+                description: 'Plugin name: lowercase letters, digits and hyphens (e.g. "weather")',
+                name: 'name',
+                required: true,
+            },
+            {
+                description: 'One-line description of the plugin',
+                name: 'description',
+                required: true,
+            },
+        ],
+        description: 'Create a Qodalis web CLI plugin (a command for the browser terminal): scaffold, implement, test and register it.',
+        name: 'create-web-plugin',
+        title: 'Create a web CLI plugin',
+    },
+    {
+        arguments: [
+            {
+                description: 'Server language: node, dotnet or python',
+                name: 'language',
+                required: true,
+            },
+            {
+                description: 'Command name as typed in the terminal (e.g. "weather")',
+                name: 'command',
+                required: true,
+            },
+        ],
+        description: 'Add a command to a Qodalis CLI server (Node, .NET or Python) that the web terminal runs remotely.',
+        name: 'create-server-command',
+        title: 'Create a server command',
+    },
+];
+export class PromptError extends Error {
+}
+const SERVER_LANGUAGES = {
+    dotnet: {
+        base: 'CliCommandProcessor (Qodalis.Cli) implementing ICliCommandProcessor from Qodalis.Cli.Abstractions',
+        handler: 'HandleAsync(CliProcessCommand command, CancellationToken cancellationToken)',
+        docs: '.NET',
+        label: '.NET',
+        register: 'register it in Program.cs: `builder.Services.AddCli(cli => cli.AddProcessor<YourProcessor>())` (or group several in a module with `cli.AddModule(...)`)',
+        test: '`dotnet build` and `dotnet test`',
+    },
+    node: {
+        base: 'CliCommandProcessor from @qodalis/cli-server-abstractions',
+        handler: 'handleAsync(command: CliProcessCommand, signal?: AbortSignal): Promise<string>',
+        docs: 'Node',
+        label: 'Node.js',
+        register: 'register it with the builder returned by createCliServer(): `builder.addProcessor(new YourProcessor())` (or `builder.addModule(...)`)',
+        test: '`npm run build` and `npm test` (vitest)',
+    },
+    python: {
+        base: 'CliCommandProcessor from qodalis_cli_server_abstractions',
+        handler: 'async def handle_async(self, command: CliProcessCommand, cancellation_event: asyncio.Event | None = None) -> str',
+        docs: 'Python',
+        label: 'Python',
+        register: 'register it with the builder of create_cli_server(): `builder.add_processor(YourProcessor())` (or `builder.add_module(...)`)',
+        test: '`pytest`',
+    },
+};
+const required = (args, name) => {
+    const value = args?.[name]?.trim();
+    if (!value) {
+        throw new PromptError(`Missing required argument "${name}".`);
+    }
+    return value;
+};
+const message = (text) => ({
+    messages: [{ content: { text, type: 'text' }, role: 'user' }],
+});
+const webPlugin = (args, ctx) => {
+    const name = required(args, 'name');
+    const description = required(args, 'description');
+    const scaffold = ctx.canScaffold
+        ? `Call \`qcli_scaffold_plugin\` with { "name": "${name}", "description": "${description}" } (add "directory" if the plugin should not go in the current project). Inside a web-cli checkout it creates packages/plugins/${name}; elsewhere a standalone qodalis-cli-${name} project. Read the files it reports.`
+        : `qcli_scaffold_plugin is not available in this session (read-only or filtered). Ask the user to run \`npx -y @qodalis/create-cli-plugin@latest --name ${name} --description "${description}"\` and continue once it has created the project.`;
+    return {
+        description: `Create the "${name}" web CLI plugin`,
+        ...message([
+            `Create a Qodalis web CLI plugin named "${name}": ${description}.`,
+            '',
+            'Work through these steps, using the qcli_* tools rather than guessing APIs:',
+            '',
+            '1. Learn the plugin model: `qcli_docs_read` with "Recipe: a complete web plugin end to end", then `qcli_docs_search` for anything specific to this plugin (parameters, input reader, writer API, state store, services, translations). `qcli_docs_read` with "Web plugins" returns the whole section.',
+            '2. Look up the exact contracts with `qcli_api`: ICliCommandProcessor, CliProcessCommand, ICliExecutionContext, ICliModule, and ICliInputReader if the command asks the user anything. Use the "Related declarations" it lists to go deeper. Do not invent members that are not in the declarations.',
+            `3. ${scaffold}`,
+            `4. Implement the command in src/lib/processors/: set command, description and parameters; do the work in processCommand(command, context), writing output through context.writer; use sub-processors (\`processors\`) for sub-commands; honour context.signal for long work. Keep "${name}" as the command name unless the user says otherwise.`,
+            '5. Export everything through the module (ICliModule) in the public API, with a version and translations if the docs recommend them.',
+            '6. Write tests next to the scaffolded ones (src/tests/*.spec.ts) covering the main paths and invalid input.',
+            '7. Build and run the tests (the scaffold result lists the commands), fix every failure, then show the user how to register the module in a host app (`modules` input/prop, or engine.registerModule()).',
+            '',
+            'Finish with a short summary: files changed, how to use the command, and anything left to decide.',
+        ].join('\n')),
+    };
+};
+const serverCommand = (args) => {
+    const language = required(args, 'language')
+        .toLowerCase()
+        .replace(/^\.?net$|^c#$|^csharp$/, 'dotnet');
+    const command = required(args, 'command');
+    if (!(language in SERVER_LANGUAGES)) {
+        throw new PromptError(`Unknown language "${language}": use node, dotnet or python.`);
+    }
+    if (!/^[a-z][a-z0-9-]*$/.test(command)) {
+        throw new PromptError(`Invalid command "${command}": lowercase letters, digits and hyphens, starting with a letter.`);
+    }
+    const lang = SERVER_LANGUAGES[language];
+    return {
+        description: `Add the "${command}" command to a ${lang.label} Qodalis CLI server`,
+        ...message([
+            `Add a "${command}" command to the ${lang.label} Qodalis CLI server in this project. The web terminal discovers server commands and runs them remotely.`,
+            '',
+            'Steps (use the qcli_* tools instead of guessing APIs):',
+            '',
+            `1. Read the guide: \`qcli_docs_read\` with "${lang.docs}: minimal server processor" and "${lang.docs}: parameters, sub-commands and modules" (and "Recipe: a server command used from the browser terminal"); \`qcli_docs_search\` "${lang.docs} structured output", "${lang.docs} permissions" or "${lang.docs} testing" when you need them. If a topic is not found, \`qcli_docs_read\` lists the available ones.`,
+            '2. Find where the server is configured in this project (the createCliServer / AddCli / create_cli_server call) and how existing processors are organised; follow the same layout and naming.',
+            `3. Create a processor class deriving from ${lang.base}: set command = "${command}", a description, parameters (name, type, required, description) and the version; implement ${lang.handler}. Use sub-processors for sub-commands.`,
+            `4. ${lang.register.charAt(0).toUpperCase()}${lang.register.slice(1)}.`,
+            `5. Add tests for the processor alongside the existing ones and run ${lang.test}; fix every failure.`,
+            '6. If a server is running with MCP enabled and this session is connected to it (QCLI_URL), the new command appears as a tool after a restart: call it to verify. Otherwise tell the user how to start the server and run the command in the web terminal.',
+            '',
+            'Finish with a short summary: files changed and how to use the command.',
+        ].join('\n')),
+    };
+};
+export const getPrompt = (name, args, ctx) => {
+    switch (name) {
+        case 'create-web-plugin':
+            return webPlugin(args, ctx);
+        case 'create-server-command':
+            return serverCommand(args);
+        default:
+            throw new PromptError(`Unknown prompt: ${name}`);
+    }
+};
+//# sourceMappingURL=prompts.js.map

package/dist/src/dev/prompts.js.map

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

package/dist/src/dev/scaffold.d.ts

@@ -0,0 +1,55 @@
+/**
+ * `qcli_scaffold_plugin`: runs `@qodalis/create-cli-plugin` non-interactively. Inside a
+ * web-cli checkout it creates `packages/plugins/<name>`; anywhere else a standalone
+ * `qodalis-cli-<name>` project (and installs its dependencies).
+ */
+export declare const SCAFFOLD_PACKAGE = "@qodalis/create-cli-plugin@latest";
+export declare const SCAFFOLD_TIMEOUT_MS: number;
+export type ScaffoldArgs = {
+    description?: string | undefined;
+    directory?: string | undefined;
+    name: string;
+    processorName?: string | undefined;
+};
+export type ScaffoldPlan = {
+    /** Arguments after `npx` */
+    args: string[];
+    cwd: string;
+    monorepo: string | undefined;
+    name: string;
+    processorName: string;
+    /** Where create-cli-plugin will put the plugin */
+    target: string;
+};
+export declare class ScaffoldError extends Error {
+    constructor(message: string);
+}
+/** The web-cli monorepo root above `dir` (same rule as create-cli-plugin), if any. */
+export declare const detectMonorepo: (dir: string) => string | undefined;
+/** Validates the arguments and works out where the plugin goes; throws {@link ScaffoldError}. */
+export declare const planScaffold: (input: ScaffoldArgs, cwd?: string) => ScaffoldPlan;
+export type RunResult = {
+    code: number | null;
+    output: string;
+    timedOut: boolean;
+};
+export type Runner = (command: string, args: string[], options: {
+    cwd: string;
+    signal?: AbortSignal | undefined;
+    timeoutMs: number;
+}) => Promise<RunResult>;
+/** Runs a command without a TTY, stdin closed, capturing stdout and stderr together. */
+export declare const runCommand: Runner;
+/** Files under `dir`, relative, without node_modules / dist / .git. */
+export declare const listFiles: (dir: string, limit?: number) => string[];
+export type ScaffoldResult = {
+    isError: boolean;
+    text: string;
+};
+/** Runs create-cli-plugin for a validated plan and describes what it created. */
+export declare const scaffoldPlugin: (plan: ScaffoldPlan, options?: {
+    runner?: Runner;
+    signal?: AbortSignal | undefined;
+    timeoutMs?: number;
+}) => Promise<ScaffoldResult>;
+//# sourceMappingURL=scaffold.d.ts.map

package/dist/src/dev/scaffold.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold.d.ts","sourceRoot":"","sources":["../../../src/dev/scaffold.ts"],"names":[],"mappings":"AAIA;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,sCAAsC,CAAC;AACpE,eAAO,MAAM,mBAAmB,QAAa,CAAC;AAG9C,MAAM,MAAM,YAAY,GAAG;IACvB,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACtC,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACvB,4BAA4B;IAC5B,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,kDAAkD;IAClD,MAAM,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,qBAAa,aAAc,SAAQ,KAAK;gBACxB,OAAO,EAAE,MAAM;CAI9B;AAQD,sFAAsF;AACtF,eAAO,MAAM,cAAc,GAAI,KAAK,MAAM,KAAG,MAAM,GAAG,SAiBrD,CAAC;AAEF,iGAAiG;AACjG,eAAO,MAAM,YAAY,GAAI,OAAO,YAAY,EAAE,YAAmB,KAAG,YA8CvE,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG;IAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,CAAC;AACnF,MAAM,MAAM,MAAM,GAAG,CACjB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,KAC5E,OAAO,CAAC,SAAS,CAAC,CAAC;AAExB,wFAAwF;AACxF,eAAO,MAAM,UAAU,EAAE,MAyDnB,CAAC;AAEP,uEAAuE;AACvE,eAAO,MAAM,SAAS,GAAI,KAAK,MAAM,EAAE,cAAW,KAAG,MAAM,EAsB1D,CAAC;AASF,MAAM,MAAM,cAAc,GAAG;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAEhE,iFAAiF;AACjF,eAAO,MAAM,cAAc,GACvB,MAAM,YAAY,EAClB,UAAS;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,KACxF,OAAO,CAAC,cAAc,CAgDxB,CAAC"}