@nimrobo/mcporter-remote 0.1.0

package/dist/cli/generate/tools.js

@@ -0,0 +1,304 @@
+export function buildToolMetadata(tool) {
+    const methodName = toProxyMethodName(tool.name);
+    const properties = extractOptions(tool);
+    return {
+        tool,
+        methodName,
+        options: properties,
+    };
+}
+export function buildEmbeddedSchemaMap(tools) {
+    const result = {};
+    for (const entry of tools) {
+        if (entry.tool.inputSchema && typeof entry.tool.inputSchema === 'object') {
+            result[entry.tool.name] = entry.tool.inputSchema;
+        }
+    }
+    return result;
+}
+export function extractOptions(tool) {
+    const schema = tool.inputSchema;
+    if (!schema || typeof schema !== 'object') {
+        return [];
+    }
+    const record = schema;
+    if (record.type !== 'object' || typeof record.properties !== 'object') {
+        return [];
+    }
+    // Flatten schema properties into Commander-friendly option descriptors.
+    const properties = record.properties;
+    const requiredList = Array.isArray(record.required) ? record.required : [];
+    return Object.entries(properties).map(([property, descriptor]) => {
+        const type = inferType(descriptor);
+        const arrayItemType = type === 'array' ? inferArrayItemType(descriptor) : undefined;
+        const enumValues = getEnumValues(descriptor);
+        const defaultValue = getDescriptorDefault(descriptor);
+        const formatInfo = getDescriptorFormatHint(descriptor);
+        const placeholder = buildPlaceholder(property, type, enumValues, formatInfo?.slug);
+        const exampleValue = buildExampleValue(property, type, enumValues, defaultValue);
+        return {
+            property,
+            cliName: toCliOption(property),
+            description: getDescriptorDescription(descriptor),
+            required: requiredList.includes(property),
+            type,
+            arrayItemType,
+            placeholder,
+            exampleValue,
+            enumValues,
+            defaultValue,
+            formatHint: formatInfo?.display,
+        };
+    });
+}
+export function getEnumValues(descriptor) {
+    if (!descriptor || typeof descriptor !== 'object') {
+        return undefined;
+    }
+    const record = descriptor;
+    if (Array.isArray(record.enum)) {
+        const values = record.enum.filter((entry) => typeof entry === 'string');
+        return values.length > 0 ? values : undefined;
+    }
+    if (record.type === 'array' && typeof record.items === 'object' && record.items !== null) {
+        const nested = record.items;
+        if (Array.isArray(nested.enum)) {
+            const values = nested.enum.filter((entry) => typeof entry === 'string');
+            return values.length > 0 ? values : undefined;
+        }
+    }
+    return undefined;
+}
+export function getDescriptorDefault(descriptor) {
+    if (!descriptor || typeof descriptor !== 'object') {
+        return undefined;
+    }
+    const record = descriptor;
+    if (record.default !== undefined) {
+        return record.default;
+    }
+    if (record.type === 'array' && typeof record.items === 'object' && record.items !== null) {
+        return Array.isArray(record.default) ? record.default : undefined;
+    }
+    return undefined;
+}
+export function buildPlaceholder(property, type, enumValues, formatSlug) {
+    const normalized = property.replace(/[A-Z]/g, (char) => `-${char.toLowerCase()}`).replace(/_/g, '-');
+    if (enumValues && enumValues.length > 0) {
+        return `<${normalized}:${enumValues.join('|')}>`;
+    }
+    switch (type) {
+        case 'number':
+            return `<${normalized}:number>`;
+        case 'boolean':
+            return `<${normalized}:true|false>`;
+        case 'array':
+            return `<${normalized}:value1,value2>`;
+        default:
+            if (formatSlug) {
+                return `<${normalized}:${formatSlug}>`;
+            }
+            return `<${normalized ?? 'value'}>`;
+    }
+}
+export function buildExampleValue(property, type, enumValues, defaultValue) {
+    if (enumValues && enumValues.length > 0) {
+        return enumValues[0];
+    }
+    if (defaultValue !== undefined) {
+        try {
+            return typeof defaultValue === 'string' ? defaultValue : JSON.stringify(defaultValue);
+        }
+        catch {
+            return undefined;
+        }
+    }
+    switch (type) {
+        case 'number':
+            return '1';
+        case 'boolean':
+            return 'true';
+        case 'array':
+            return 'value1,value2';
+        default:
+            if (property.toLowerCase().includes('path')) {
+                return '/path/to/file.md';
+            }
+            if (property.toLowerCase().includes('id')) {
+                return 'example-id';
+            }
+            return undefined;
+    }
+}
+export function pickExampleLiteral(option) {
+    if (option.enumValues && option.enumValues.length > 0) {
+        return JSON.stringify(option.enumValues[0]);
+    }
+    if (!option.exampleValue) {
+        return undefined;
+    }
+    if (option.type === 'array') {
+        const values = option.exampleValue
+            .split(',')
+            .map((entry) => entry.trim())
+            .filter(Boolean);
+        if (values.length === 0) {
+            return undefined;
+        }
+        return `[${values.map((entry) => JSON.stringify(entry)).join(', ')}]`;
+    }
+    if (option.type === 'number' || option.type === 'boolean') {
+        return option.exampleValue;
+    }
+    try {
+        const parsed = JSON.parse(option.exampleValue);
+        if (typeof parsed === 'number' || typeof parsed === 'boolean') {
+            return option.exampleValue;
+        }
+    }
+    catch {
+        // fall through to quoted string literal
+    }
+    return JSON.stringify(option.exampleValue);
+}
+export function buildFallbackLiteral(option) {
+    switch (option.type) {
+        case 'number':
+            return '1';
+        case 'boolean':
+            return 'true';
+        case 'array':
+            return '["value1"]';
+        default: {
+            if (option.property.toLowerCase().includes('id')) {
+                return JSON.stringify('example-id');
+            }
+            if (option.property.toLowerCase().includes('url')) {
+                return JSON.stringify('https://example.com');
+            }
+            return JSON.stringify('value');
+        }
+    }
+}
+export function inferType(descriptor) {
+    if (!descriptor || typeof descriptor !== 'object') {
+        return 'unknown';
+    }
+    const type = descriptor.type;
+    const resolveType = (value) => {
+        if (value === 'integer') {
+            return 'number';
+        }
+        if (value === 'string' || value === 'number' || value === 'boolean' || value === 'array') {
+            return value;
+        }
+        return undefined;
+    };
+    if (Array.isArray(type)) {
+        for (const entry of type) {
+            const resolved = resolveType(entry);
+            if (resolved) {
+                return resolved;
+            }
+        }
+        return 'unknown';
+    }
+    const resolved = resolveType(type);
+    if (resolved) {
+        return resolved;
+    }
+    return 'unknown';
+}
+export function inferArrayItemType(descriptor) {
+    if (!descriptor || typeof descriptor !== 'object') {
+        return 'unknown';
+    }
+    const record = descriptor;
+    if (record.type !== 'array' || !record.items || typeof record.items !== 'object') {
+        return 'unknown';
+    }
+    const items = record.items;
+    const itemType = items.type;
+    const resolveItemType = (value) => {
+        if (value === 'integer') {
+            return 'number';
+        }
+        if (value === 'string' || value === 'number' || value === 'boolean') {
+            return value;
+        }
+        return undefined;
+    };
+    if (Array.isArray(itemType)) {
+        for (const entry of itemType) {
+            const resolved = resolveItemType(entry);
+            if (resolved) {
+                return resolved;
+            }
+        }
+        return 'unknown';
+    }
+    const resolved = resolveItemType(itemType);
+    if (resolved) {
+        return resolved;
+    }
+    return 'unknown';
+}
+export function getDescriptorDescription(descriptor) {
+    if (typeof descriptor !== 'object' || descriptor === null) {
+        return undefined;
+    }
+    const record = descriptor;
+    return typeof record.description === 'string' ? record.description : undefined;
+}
+export function getDescriptorFormatHint(descriptor) {
+    if (typeof descriptor !== 'object' || descriptor === null) {
+        return undefined;
+    }
+    const record = descriptor;
+    const formatRaw = typeof record.format === 'string' ? record.format : undefined;
+    const description = typeof record.description === 'string' ? record.description : undefined;
+    const iso8601FromDescription = !formatRaw && description && /\biso[-\s]*8601\b/i.test(description) ? 'iso-8601' : undefined;
+    const isoFormatFromDescription = !formatRaw && !iso8601FromDescription && description && /\biso\s+format\b/i.test(description)
+        ? 'iso-8601'
+        : undefined;
+    const formatFromDescription = iso8601FromDescription ?? isoFormatFromDescription;
+    const slug = formatRaw ?? formatFromDescription;
+    if (!slug) {
+        return undefined;
+    }
+    let display;
+    switch (slug) {
+        case 'date-time':
+        case 'iso-8601':
+            display = 'ISO 8601';
+            break;
+        case 'uuid':
+            display = 'UUID';
+            break;
+        default:
+            display = slug.replace(/[_-]/g, ' ');
+            display = display.charAt(0).toUpperCase() + display.slice(1);
+            break;
+    }
+    return {
+        display: display.replace(/\b\w/g, (char) => char.toUpperCase()),
+        slug,
+    };
+}
+export function toProxyMethodName(toolName) {
+    return toolName
+        .replace(/[-_](\w)/g, (_, char) => char.toUpperCase())
+        .replace(/^(\w)/, (match) => match.toLowerCase());
+}
+export function toCliOption(property) {
+    return property.replace(/[A-Z]/g, (char) => `-${char.toLowerCase()}`).replace(/_/g, '-');
+}
+export const toolsTestHelpers = {
+    getEnumValues,
+    getDescriptorDefault,
+    buildPlaceholder,
+    buildExampleValue,
+    pickExampleLiteral,
+    buildFallbackLiteral,
+};
+//# sourceMappingURL=tools.js.map

package/dist/cli/generate/tools.js.map

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

package/dist/cli/generate/types.d.ts

@@ -0,0 +1,5 @@
+export type CommandInput = {
+    command: string;
+    args?: string[];
+} | string;
+//# sourceMappingURL=types.d.ts.map

package/dist/cli/generate/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/cli/generate/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG,MAAM,CAAC"}

package/dist/cli/generate/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/cli/generate/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/cli/generate/types.ts"],"names":[],"mappings":""}

package/dist/cli/generate-cli-runner.d.ts

@@ -0,0 +1,3 @@
+import type { FlagMap } from './flag-utils.js';
+export declare function handleGenerateCli(args: string[], globalFlags: FlagMap): Promise<void>;
+//# sourceMappingURL=generate-cli-runner.d.ts.map

package/dist/cli/generate-cli-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-cli-runner.d.ts","sourceRoot":"","sources":["../../src/cli/generate-cli-runner.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAQ/C,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,WAAW,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAwE3F"}

package/dist/cli/generate-cli-runner.js

@@ -0,0 +1,72 @@
+import { readCliMetadata } from '../cli-metadata.js';
+import { parseGenerateFlags } from './generate/flags.js';
+import { inferNameFromCommand } from './generate/name-utils.js';
+import { performGenerateFromArtifact, performGenerateFromRequest } from './generate/output.js';
+import { buildInlineServerDefinition } from './generate/server-utils.js';
+import { buildGenerateCliCommand, resolveGenerateRequestFromArtifact } from './generate/template-data.js';
+// handleGenerateCli parses flags and generates the requested standalone CLI.
+export async function handleGenerateCli(args, globalFlags) {
+    const parsed = parseGenerateFlags(args);
+    if (parsed.includeTools && parsed.excludeTools) {
+        throw new Error('--include-tools and --exclude-tools cannot be used together.');
+    }
+    if (parsed.includeTools && parsed.includeTools.length === 0) {
+        throw new Error('--include-tools requires at least one tool name.');
+    }
+    if (parsed.excludeTools && parsed.excludeTools.length === 0) {
+        throw new Error('--exclude-tools requires at least one tool name.');
+    }
+    if (parsed.from && (parsed.command || parsed.description || parsed.name)) {
+        throw new Error('--from cannot be combined with --command/--description/--name.');
+    }
+    if (parsed.dryRun && !parsed.from) {
+        throw new Error('--dry-run currently requires --from <artifact>.');
+    }
+    if (parsed.from) {
+        const metadata = await readCliMetadata(parsed.from);
+        const request = resolveGenerateRequestFromArtifact(parsed, metadata, globalFlags);
+        if (parsed.dryRun) {
+            const command = buildGenerateCliCommand({
+                serverRef: request.serverRef,
+                configPath: request.configPath,
+                rootDir: request.rootDir,
+                outputPath: request.outputPath,
+                bundle: request.bundle,
+                compile: request.compile,
+                runtime: request.runtime ?? 'node',
+                timeoutMs: request.timeoutMs ?? 30_000,
+                minify: request.minify ?? false,
+                includeTools: request.includeTools,
+                excludeTools: request.excludeTools,
+            }, metadata.server.definition, globalFlags);
+            console.log('Dry run — would execute:');
+            console.log(`  ${command}`);
+            return;
+        }
+        await performGenerateFromArtifact(metadata, request);
+        return;
+    }
+    const inferredName = parsed.name ?? (parsed.command ? inferNameFromCommand(parsed.command) : undefined);
+    const serverRef = parsed.server ??
+        (parsed.command && inferredName
+            ? JSON.stringify(buildInlineServerDefinition(inferredName, parsed.command, parsed.description))
+            : undefined);
+    if (!serverRef) {
+        throw new Error('Provide --server with a definition or a command we can infer a name from (use --name to override).');
+    }
+    await performGenerateFromRequest({
+        serverRef,
+        configPath: globalFlags['--config'],
+        rootDir: globalFlags['--root'],
+        outputPath: parsed.output,
+        runtime: parsed.runtime,
+        bundler: parsed.bundler,
+        bundle: parsed.bundle,
+        timeoutMs: parsed.timeout,
+        compile: parsed.compile,
+        minify: parsed.minify ?? false,
+        includeTools: parsed.includeTools,
+        excludeTools: parsed.excludeTools,
+    });
+}
+//# sourceMappingURL=generate-cli-runner.js.map

package/dist/cli/generate-cli-runner.js.map

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

package/dist/cli/help-output.d.ts

@@ -0,0 +1,6 @@
+export declare function printHelp(message?: string): void;
+export declare function isHelpToken(token: string): boolean;
+export declare function consumeHelpTokens(args: string[]): boolean;
+export declare function isVersionToken(token: string): boolean;
+export declare function printVersion(): Promise<void>;
+//# sourceMappingURL=help-output.d.ts.map

package/dist/cli/help-output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"help-output.d.ts","sourceRoot":"","sources":["../../src/cli/help-output.ts"],"names":[],"mappings":"AAeA,wBAAgB,SAAS,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CA2BhD;AAmID,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAElD;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAUzD;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAErD;AAED,wBAAsB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAElD"}

package/dist/cli/help-output.js

@@ -0,0 +1,186 @@
+import fsPromises from 'node:fs/promises';
+import { MCPORTER_VERSION } from '../runtime.js';
+import { boldText, dimText, extraDimText, supportsAnsiColor } from './terminal.js';
+export function printHelp(message) {
+    if (message) {
+        console.error(message);
+        console.error('');
+    }
+    const colorize = supportsAnsiColor;
+    const sections = buildCommandSections(colorize);
+    const globalFlags = formatGlobalFlags(colorize);
+    const quickStart = formatQuickStart(colorize);
+    const footer = formatHelpFooter(colorize);
+    const title = colorize
+        ? `${boldText('mcporter')} ${dimText('— Model Context Protocol CLI & generator')}`
+        : 'mcporter — Model Context Protocol CLI & generator';
+    const lines = [
+        title,
+        '',
+        'Usage: mcporter <command> [options]',
+        '',
+        ...sections,
+        '',
+        globalFlags,
+        '',
+        quickStart,
+        '',
+        footer,
+    ];
+    console.error(lines.join('\n'));
+}
+function buildCommandSections(colorize) {
+    const sections = [
+        {
+            title: 'Core commands',
+            entries: [
+                {
+                    name: 'list',
+                    summary: 'List configured servers (add --schema for tool docs)',
+                    usage: 'mcporter list [name] [--schema] [--json]',
+                },
+                {
+                    name: 'call',
+                    summary: 'Call a tool by selector (server.tool) or HTTP URL; key=value flags supported',
+                    usage: 'mcporter call <selector> [key=value ...]',
+                },
+                {
+                    name: 'auth',
+                    summary: 'Complete OAuth for a server without listing tools',
+                    usage: 'mcporter auth <server | url> [--reset]',
+                },
+            ],
+        },
+        {
+            title: 'Generator & tooling',
+            entries: [
+                {
+                    name: 'generate-cli',
+                    summary: 'Emit a standalone CLI (supports HTTP, stdio, and inline commands)',
+                    usage: 'mcporter generate-cli --server <name> | --command <ref> [options]',
+                },
+                {
+                    name: 'inspect-cli',
+                    summary: 'Show metadata and regen instructions for a generated CLI',
+                    usage: 'mcporter inspect-cli <path> [--json]',
+                },
+                {
+                    name: 'emit-ts',
+                    summary: 'Generate TypeScript client/types for a server',
+                    usage: 'mcporter emit-ts <server> --mode client|types [options]',
+                },
+            ],
+        },
+        {
+            title: 'Configuration',
+            entries: [
+                {
+                    name: 'config',
+                    summary: 'Inspect or edit config files (list, get, add, remove, import, login, logout)',
+                    usage: 'mcporter config <command> [options]',
+                },
+            ],
+        },
+        {
+            title: 'Daemon',
+            entries: [
+                {
+                    name: 'daemon',
+                    summary: 'Manage the keep-alive daemon (start | status | stop | restart)',
+                    usage: 'mcporter daemon <subcommand>',
+                },
+            ],
+        },
+    ];
+    return sections.flatMap((section) => formatCommandSection(section, colorize));
+}
+function formatCommandSection(section, colorize) {
+    const maxNameLength = Math.max(...section.entries.map((entry) => entry.name.length));
+    const header = colorize ? boldText(section.title) : section.title;
+    const lines = [header];
+    section.entries.forEach((entry) => {
+        const paddedName = entry.name.padEnd(maxNameLength);
+        const renderedName = colorize ? boldText(paddedName) : paddedName;
+        const summary = colorize ? dimText(entry.summary) : entry.summary;
+        lines.push(`  ${renderedName}  ${summary}`);
+        lines.push(`    ${extraDimText('usage:')} ${entry.usage}`);
+    });
+    return [...lines, ''];
+}
+function formatGlobalFlags(colorize) {
+    const title = colorize ? boldText('Global flags') : 'Global flags';
+    const entries = [
+        {
+            flag: '--config <path>',
+            summary: 'Path to mcporter.json (defaults to ./config/mcporter.json)',
+        },
+        {
+            flag: '--root <path>',
+            summary: 'Working directory for stdio servers',
+        },
+        {
+            flag: '--log-level <debug|info|warn|error>',
+            summary: 'Adjust CLI logging (defaults to warn)',
+        },
+        {
+            flag: '--oauth-timeout <ms>',
+            summary: 'Time to wait for browser-based OAuth before giving up (default 60000)',
+        },
+    ];
+    const formatted = entries.map((entry) => `  ${entry.flag.padEnd(34)}${entry.summary}`);
+    return [title, ...formatted].join('\n');
+}
+function formatQuickStart(colorize) {
+    const title = colorize ? boldText('Quick start') : 'Quick start';
+    const entries = [
+        ['mcporter list', 'show configured servers'],
+        ['mcporter list linear --schema', 'view Linear tool docs'],
+        ['mcporter call linear.list_issues limit:5', 'invoke a tool with key=value arguments'],
+        ['mcporter generate-cli --command https://host/mcp --compile ./my-cli', 'build a standalone CLI/binary'],
+    ];
+    const formatted = entries.map(([cmd, note]) => {
+        const comment = colorize ? dimText(`# ${note}`) : `# ${note}`;
+        return `  ${cmd}\n    ${comment}`;
+    });
+    return [title, ...formatted].join('\n');
+}
+function formatHelpFooter(colorize) {
+    const pointer = 'Run `mcporter <command> --help` for detailed flags.';
+    const autoLoad = 'mcporter auto-loads servers from ./config/mcporter.json and editor imports (Cursor, Claude, Codex, etc.).';
+    if (!colorize) {
+        return `${pointer}\n${autoLoad}`;
+    }
+    return `${dimText(pointer)}\n${extraDimText(autoLoad)}`;
+}
+export function isHelpToken(token) {
+    return token === '--help' || token === '-h' || token === 'help';
+}
+export function consumeHelpTokens(args) {
+    let found = false;
+    for (let index = args.length - 1; index >= 0; index -= 1) {
+        const token = args[index];
+        if (token && isHelpToken(token)) {
+            args.splice(index, 1);
+            found = true;
+        }
+    }
+    return found;
+}
+export function isVersionToken(token) {
+    return token === '--version' || token === '-v' || token === '-V';
+}
+export async function printVersion() {
+    console.log(await resolveCliVersion());
+}
+async function resolveCliVersion() {
+    try {
+        const packageJsonPath = new URL('../../package.json', import.meta.url);
+        const buffer = await fsPromises.readFile(packageJsonPath, 'utf8');
+        const pkg = JSON.parse(buffer);
+        return pkg.version ?? MCPORTER_VERSION;
+    }
+    catch {
+        return MCPORTER_VERSION;
+    }
+}
+//# sourceMappingURL=help-output.js.map

package/dist/cli/help-output.js.map

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

package/dist/cli/http-utils.d.ts

@@ -0,0 +1,9 @@
+export declare function normalizeHttpUrlCandidate(value?: string): string | undefined;
+export declare function looksLikeHttpUrl(value?: string): boolean;
+export declare function splitHttpToolSelector(input: string): {
+    baseUrl: string;
+    tool: string;
+} | null;
+export declare function normalizeHttpUrl(value: string | URL): string | undefined;
+export declare function extractHttpServerTarget(value: string): string | undefined;
+//# sourceMappingURL=http-utils.d.ts.map

package/dist/cli/http-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-utils.d.ts","sourceRoot":"","sources":["../../src/cli/http-utils.ts"],"names":[],"mappings":"AAEA,wBAAgB,yBAAyB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAmB5E;AAED,wBAAgB,gBAAgB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAExD;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAsC7F;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,GAAG,MAAM,GAAG,SAAS,CAYxE;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAOzE"}