@mxf-dev/core 1.0.0

package/dist/protocols/mcp/tools/shell/ShellCommandParser.js

@@ -0,0 +1,521 @@
+/**
+ * Copyright 2024 Brad Anderson
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * ShellCommandParser — Recursive descent parser for shell command strings.
+ *
+ * Replaces regex-based command extraction in the security guard, properly
+ * handling compound commands, env prefixes, wrapper commands, quotes, and
+ * redirections. The parser is designed for the 90% case: it is better to
+ * extract too many commands (safe for security validation) than to miss any.
+ */
+import { Logger } from '../../../../utils/Logger.js';
+const logger = new Logger('info', 'ShellCommandParser', 'server');
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+/**
+ * Known wrapper commands and how many positional arguments each consumes
+ * before the real command appears.
+ *
+ * Special values:
+ *   -1 = variable args, handled by dedicated logic (sudo, env, nice)
+ */
+const WRAPPER_COMMANDS = {
+    timeout: 1, // timeout <duration> <cmd ...>
+    env: -1, // env [KEY=VAL ...] <cmd ...>
+    nice: -1, // nice [-n N] <cmd ...>
+    nohup: 0, // nohup <cmd ...>
+    sudo: -1, // sudo [-flags ...] <cmd ...>
+    command: 0, // command <cmd ...>
+    exec: 0, // exec <cmd ...>
+    time: 0, // time <cmd ...>
+    strace: -1, // strace [-flags ...] <cmd ...>
+    ltrace: -1, // ltrace [-flags ...] <cmd ...>
+};
+/**
+ * Regex matching a shell environment variable assignment token (FOO=bar).
+ * The value part may be quoted.
+ */
+const ENV_PREFIX_RE = /^([A-Za-z_][A-Za-z0-9_]*)=(.*)$/;
+// ---------------------------------------------------------------------------
+// Tokenizer
+// ---------------------------------------------------------------------------
+/**
+ * Tokenize a raw shell string into an array of tokens, respecting quoting
+ * rules and preserving operator tokens as discrete entries.
+ *
+ * Operator tokens emitted: &&  ||  ;  |  >  >>  <  2>  2>&1  2>>
+ *
+ * The tokenizer walks character-by-character, tracking single- and
+ * double-quote state. Backslash escapes are honoured inside double-quoted
+ * strings.
+ */
+function tokenize(input) {
+    const tokens = [];
+    let current = '';
+    let i = 0;
+    const len = input.length;
+    let inSingleQuote = false;
+    let inDoubleQuote = false;
+    /** Flush the accumulated `current` buffer as a token. */
+    const flush = () => {
+        if (current.length > 0) {
+            tokens.push(current);
+            current = '';
+        }
+    };
+    while (i < len) {
+        const ch = input[i];
+        // --- Inside single quotes: everything is literal until closing ' ---
+        if (inSingleQuote) {
+            if (ch === "'") {
+                inSingleQuote = false;
+            }
+            else {
+                current += ch;
+            }
+            i++;
+            continue;
+        }
+        // --- Inside double quotes: honour backslash escapes ---
+        if (inDoubleQuote) {
+            if (ch === '\\' && i + 1 < len) {
+                // Escaped character inside double quotes
+                current += input[i + 1];
+                i += 2;
+                continue;
+            }
+            if (ch === '"') {
+                inDoubleQuote = false;
+            }
+            else {
+                current += ch;
+            }
+            i++;
+            continue;
+        }
+        // --- Unquoted context ---
+        // Backslash escape in unquoted context
+        if (ch === '\\' && i + 1 < len) {
+            current += input[i + 1];
+            i += 2;
+            continue;
+        }
+        // Enter single quote
+        if (ch === "'") {
+            inSingleQuote = true;
+            // Add a zero-width marker so an empty quoted string produces a token
+            if (current.length === 0) {
+                current = '';
+            }
+            i++;
+            continue;
+        }
+        // Enter double quote
+        if (ch === '"') {
+            inDoubleQuote = true;
+            if (current.length === 0) {
+                current = '';
+            }
+            i++;
+            continue;
+        }
+        // Whitespace — flush token
+        if (ch === ' ' || ch === '\t') {
+            flush();
+            i++;
+            continue;
+        }
+        // Compound operators: &&, ||, ;
+        if (ch === '&' && i + 1 < len && input[i + 1] === '&') {
+            flush();
+            tokens.push('&&');
+            i += 2;
+            continue;
+        }
+        if (ch === '|' && i + 1 < len && input[i + 1] === '|') {
+            flush();
+            tokens.push('||');
+            i += 2;
+            continue;
+        }
+        if (ch === ';') {
+            flush();
+            tokens.push(';');
+            i++;
+            continue;
+        }
+        // Pipe (single |, already ruled out ||)
+        if (ch === '|') {
+            flush();
+            tokens.push('|');
+            i++;
+            continue;
+        }
+        // Redirections: 2>>&1 is not standard, but handle 2>&1, 2>>, 2>, >>, >
+        if (ch === '2' && i + 1 < len && input[i + 1] === '>') {
+            // Might be 2>&1 or 2>> or 2>
+            flush();
+            if (i + 2 < len && input[i + 2] === '&' && i + 3 < len && input[i + 3] === '1') {
+                tokens.push('2>&1');
+                i += 4;
+            }
+            else if (i + 2 < len && input[i + 2] === '>') {
+                tokens.push('2>>');
+                i += 3;
+            }
+            else {
+                tokens.push('2>');
+                i += 2;
+            }
+            continue;
+        }
+        // >> and >
+        if (ch === '>') {
+            flush();
+            if (i + 1 < len && input[i + 1] === '>') {
+                tokens.push('>>');
+                i += 2;
+            }
+            else {
+                tokens.push('>');
+                i++;
+            }
+            continue;
+        }
+        // < (input redirection)
+        if (ch === '<') {
+            flush();
+            tokens.push('<');
+            i++;
+            continue;
+        }
+        // Subshell detection: $( — we don't deeply parse, just flag
+        // Backtick — same treatment
+        // These are accumulated into the current token for now and
+        // detected in a later pass.
+        // Default: accumulate into current token
+        current += ch;
+        i++;
+    }
+    flush();
+    return tokens;
+}
+// ---------------------------------------------------------------------------
+// Compound splitting
+// ---------------------------------------------------------------------------
+/** Operator tokens that separate compound commands. */
+const COMPOUND_OPS = new Set(['&&', '||', ';']);
+/** Operator token for pipes. */
+const PIPE_OP = '|';
+/**
+ * Split a flat token list on compound operators (&&, ||, ;) into segments,
+ * each segment being the tokens of one pipeline.
+ */
+function splitOnCompoundOps(tokens) {
+    const segments = [];
+    let current = [];
+    for (const tok of tokens) {
+        if (COMPOUND_OPS.has(tok)) {
+            if (current.length > 0) {
+                segments.push(current);
+            }
+            current = [];
+        }
+        else {
+            current.push(tok);
+        }
+    }
+    if (current.length > 0) {
+        segments.push(current);
+    }
+    return segments;
+}
+/**
+ * Split a token list on pipe operators into individual simple command
+ * token lists.
+ */
+function splitOnPipes(tokens) {
+    const segments = [];
+    let current = [];
+    for (const tok of tokens) {
+        if (tok === PIPE_OP) {
+            if (current.length > 0) {
+                segments.push(current);
+            }
+            current = [];
+        }
+        else {
+            current.push(tok);
+        }
+    }
+    if (current.length > 0) {
+        segments.push(current);
+    }
+    return segments;
+}
+// ---------------------------------------------------------------------------
+// Redirection tokens
+// ---------------------------------------------------------------------------
+const REDIRECTION_TOKENS = new Set(['>', '>>', '<', '2>', '2>>', '2>&1']);
+// ---------------------------------------------------------------------------
+// Simple command parsing
+// ---------------------------------------------------------------------------
+/**
+ * Parse a single simple command (no pipes, no compound operators) from its
+ * token list, stripping env prefixes and wrapper commands to find the
+ * effective command name.
+ *
+ * Returns the effective command, env prefixes map, and wrapper commands list.
+ */
+function parseSimpleCommand(tokens) {
+    const envPrefixes = {};
+    const wrapperCommands = [];
+    let hasRedirections = false;
+    // Filter out redirection tokens and their targets from the working copy
+    const commandTokens = [];
+    let skipNext = false;
+    for (let idx = 0; idx < tokens.length; idx++) {
+        if (skipNext) {
+            skipNext = false;
+            continue;
+        }
+        const tok = tokens[idx];
+        if (REDIRECTION_TOKENS.has(tok)) {
+            hasRedirections = true;
+            // The token after a redirection operator is the filename — skip it
+            if (tok !== '2>&1') {
+                skipNext = true;
+            }
+            continue;
+        }
+        commandTokens.push(tok);
+    }
+    // Strip leading env var prefixes (FOO=bar)
+    let pos = 0;
+    while (pos < commandTokens.length) {
+        const match = ENV_PREFIX_RE.exec(commandTokens[pos]);
+        if (match) {
+            envPrefixes[match[1]] = match[2];
+            pos++;
+        }
+        else {
+            break;
+        }
+    }
+    // Strip wrapper commands
+    while (pos < commandTokens.length) {
+        const tok = commandTokens[pos];
+        const wrapperArgCount = WRAPPER_COMMANDS[tok];
+        if (wrapperArgCount === undefined) {
+            // Not a wrapper — this is the effective command
+            break;
+        }
+        wrapperCommands.push(tok);
+        pos++;
+        if (wrapperArgCount >= 0) {
+            // Skip the fixed number of arguments
+            pos += wrapperArgCount;
+        }
+        else {
+            // Variable-argument wrappers need special handling
+            switch (tok) {
+                case 'env':
+                    // env skips KEY=VALUE pairs, then the next non-KEY=VALUE token is the command
+                    while (pos < commandTokens.length && ENV_PREFIX_RE.test(commandTokens[pos])) {
+                        const envMatch = ENV_PREFIX_RE.exec(commandTokens[pos]);
+                        if (envMatch) {
+                            envPrefixes[envMatch[1]] = envMatch[2];
+                        }
+                        pos++;
+                    }
+                    break;
+                case 'nice':
+                    // nice optionally takes -n <priority>
+                    if (pos < commandTokens.length && commandTokens[pos] === '-n') {
+                        pos += 2; // skip -n and the priority value
+                    }
+                    break;
+                case 'sudo':
+                    // sudo: skip flags (tokens starting with -) but not the command
+                    while (pos < commandTokens.length && commandTokens[pos].startsWith('-')) {
+                        pos++;
+                    }
+                    break;
+                case 'strace':
+                case 'ltrace':
+                    // Skip flags (tokens starting with -) and their values
+                    // Flags that take a value: -e, -o, -p, -s, -f is standalone
+                    while (pos < commandTokens.length && commandTokens[pos].startsWith('-')) {
+                        const flag = commandTokens[pos];
+                        pos++;
+                        // These flags consume the next token as their argument
+                        if (['-e', '-o', '-p', '-s', '-S'].includes(flag) && pos < commandTokens.length) {
+                            pos++;
+                        }
+                    }
+                    break;
+                default:
+                    // Unknown variable-arg wrapper — just advance
+                    break;
+            }
+        }
+    }
+    const effectiveCommand = pos < commandTokens.length ? commandTokens[pos] : '';
+    return { effectiveCommand, envPrefixes, wrapperCommands, hasRedirections };
+}
+// ---------------------------------------------------------------------------
+// Subshell detection
+// ---------------------------------------------------------------------------
+/**
+ * Detect whether the raw command string contains subshell constructs
+ * ($(...) or backticks) outside of single-quoted regions.
+ */
+function detectSubshells(raw) {
+    let inSingleQuote = false;
+    let inDoubleQuote = false;
+    for (let i = 0; i < raw.length; i++) {
+        const ch = raw[i];
+        if (ch === '\\' && !inSingleQuote && i + 1 < raw.length) {
+            i++; // skip escaped char
+            continue;
+        }
+        if (ch === "'" && !inDoubleQuote) {
+            inSingleQuote = !inSingleQuote;
+            continue;
+        }
+        if (ch === '"' && !inSingleQuote) {
+            inDoubleQuote = !inDoubleQuote;
+            continue;
+        }
+        if (inSingleQuote) {
+            continue;
+        }
+        // $( outside single quotes
+        if (ch === '$' && i + 1 < raw.length && raw[i + 1] === '(') {
+            return true;
+        }
+        // Backtick outside single quotes
+        if (ch === '`') {
+            return true;
+        }
+    }
+    return false;
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Parse a shell command string into its structural components.
+ * Handles compound commands, env prefixes, wrappers, quotes, redirections.
+ * Falls back gracefully to simple string splitting for unparseable input.
+ *
+ * @param rawCommand - The raw shell command string to parse.
+ * @returns A `ParsedCommand` describing the structural breakdown.
+ */
+export function parseCommand(rawCommand) {
+    const trimmed = rawCommand.trim();
+    // Empty / whitespace-only input
+    if (trimmed.length === 0) {
+        return {
+            effectiveCommand: '',
+            allCommands: [],
+            hasRedirections: false,
+            hasPipes: false,
+            hasSubshells: false,
+            hasCompoundOperators: false,
+            envPrefixes: {},
+            wrapperCommands: [],
+        };
+    }
+    try {
+        const tokens = tokenize(trimmed);
+        // Detect compound operators and pipes at the token level
+        const hasCompoundOperators = tokens.some((t) => COMPOUND_OPS.has(t));
+        const hasPipes = tokens.some((t) => t === PIPE_OP);
+        const hasSubshells = detectSubshells(trimmed);
+        // Split into compound segments, then each segment into pipeline stages
+        const compoundSegments = splitOnCompoundOps(tokens);
+        const allCommands = [];
+        let mergedEnvPrefixes = {};
+        let mergedWrappers = [];
+        let mergedRedirections = false;
+        let firstEffective = '';
+        for (const segment of compoundSegments) {
+            const pipelineStages = splitOnPipes(segment);
+            for (const stage of pipelineStages) {
+                const parsed = parseSimpleCommand(stage);
+                if (parsed.effectiveCommand.length > 0) {
+                    allCommands.push(parsed.effectiveCommand);
+                }
+                if (parsed.hasRedirections) {
+                    mergedRedirections = true;
+                }
+                // Capture env prefixes and wrappers from the first command
+                if (firstEffective === '' && parsed.effectiveCommand.length > 0) {
+                    firstEffective = parsed.effectiveCommand;
+                    mergedEnvPrefixes = parsed.envPrefixes;
+                    mergedWrappers = parsed.wrapperCommands;
+                }
+            }
+        }
+        return {
+            effectiveCommand: firstEffective,
+            allCommands,
+            hasRedirections: mergedRedirections,
+            hasPipes,
+            hasSubshells,
+            hasCompoundOperators,
+            envPrefixes: mergedEnvPrefixes,
+            wrapperCommands: mergedWrappers,
+        };
+    }
+    catch (err) {
+        // Graceful fallback: never throw from the parser. Log a warning and
+        // fall back to naive whitespace splitting so the security guard still
+        // gets a command to check.
+        logger.warn(`ShellCommandParser: failed to parse command, falling back to simple split: ${err instanceof Error ? err.message : String(err)}`);
+        const fallbackParts = trimmed.split(/\s+/);
+        const fallbackCmd = fallbackParts[0] || '';
+        return {
+            effectiveCommand: fallbackCmd,
+            allCommands: fallbackCmd.length > 0 ? [fallbackCmd] : [],
+            hasRedirections: false,
+            hasPipes: false,
+            hasSubshells: false,
+            hasCompoundOperators: false,
+            envPrefixes: {},
+            wrapperCommands: [],
+        };
+    }
+}
+/**
+ * Extract all effective commands from a compound command string.
+ * This is the main entry point for security validation — every command
+ * returned must be checked against allowlists/blocklists.
+ *
+ * CRITICAL SECURITY: The old code did `command.split(' ')[0]` which only
+ * checks the first command. This function ensures ALL commands in
+ * `echo hello; rm -rf /` are extracted and validated.
+ *
+ * @param rawCommand - The raw shell command string.
+ * @returns An array of effective command names found in the input.
+ */
+export function extractEffectiveCommands(rawCommand) {
+    const parsed = parseCommand(rawCommand);
+    return parsed.allCommands;
+}
+//# sourceMappingURL=ShellCommandParser.js.map

package/dist/protocols/mcp/tools/shell/ShellCommandParser.js.map

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

package/dist/protocols/mcp/tools/shell/ShellExecuteHandler.d.ts

@@ -0,0 +1,112 @@
+/**
+ * Copyright 2024 Brad Anderson
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ * @author Brad Anderson <BradA1878@pm.me>
+ * @repository https://github.com/mxf-dev/mxf
+ * @documentation https://mxf-dev.github.io/mxf/
+ */
+import { AgentId, ChannelId } from '../../../../types/ChannelContext.js';
+/**
+ * Input for shell command execution.
+ * Matches the shell_execute MCP tool's input schema.
+ */
+export interface ShellExecuteInput {
+    /** Shell command to execute */
+    command: string;
+    /** Command arguments (shell-escaped and appended) */
+    args?: string[];
+    /** Working directory for command execution */
+    workingDirectory?: string;
+    /** Additional environment variables merged with process.env */
+    environment?: Record<string, string>;
+    /** Command timeout in milliseconds (default: 30000) */
+    timeout?: number;
+    /** Whether to capture and return stdout/stderr (default: true) */
+    captureOutput?: boolean;
+    /** Whitelist of allowed base commands (checked before execution) */
+    allowedCommands?: string[];
+    /** Human-readable description of the command's purpose */
+    description?: string;
+}
+/**
+ * Execution context identifying the agent, channel, and request.
+ */
+export interface ShellExecuteContext {
+    /** Agent executing the command */
+    agentId: AgentId;
+    /** Channel in which the command is being executed */
+    channelId: ChannelId;
+    /** Unique request identifier for event correlation */
+    requestId: string;
+}
+/**
+ * Enhanced result of shell command execution.
+ * All new fields are optional to maintain backward compatibility with
+ * consumers that only expect the original result shape.
+ */
+export interface ShellExecuteResult {
+    /** The full command string that was executed (including expanded args) */
+    command: string;
+    /** Human-readable description of the command's purpose */
+    description?: string;
+    /** Process exit code */
+    exitCode: number;
+    /** Semantic meaning of the exit code (e.g., "no matches found" for grep 1) */
+    exitCodeMeaning?: string;
+    /** Whether the exit code represents an actual error (semantic-aware) */
+    isError: boolean;
+    /** Captured stdout (undefined if captureOutput is false) */
+    stdout?: string;
+    /** Captured stderr (undefined if captureOutput is false) */
+    stderr?: string;
+    /** Command classification metadata */
+    classification?: {
+        /** Primary category (e.g., 'read', 'write', 'git', 'network') */
+        category: string;
+        /** Whether the command only reads data */
+        isReadOnly: boolean;
+        /** Whether the command produces no useful stdout on success */
+        isSilent: boolean;
+    };
+    /** Destructive command warnings (informational, does not block execution) */
+    warnings?: string[];
+    /** Execution time in milliseconds */
+    executionTime: number;
+    /** Timestamp when execution completed */
+    executedAt: number;
+    /** Whether stdout was truncated by the large output handler */
+    outputTruncated?: boolean;
+    /** MongoDB document ID if full output was persisted */
+    persistedOutputId?: string;
+    /** Total output size in bytes before any truncation */
+    totalOutputBytes?: number;
+    /** Total number of lines in original output */
+    totalOutputLines?: number;
+}
+/**
+ * Execute a shell command with enhanced semantics, classification, warnings,
+ * large output handling, and event emission.
+ *
+ * This function replaces the inline handler from InfrastructureTools.shellExecTool.
+ * It integrates with the Phase 1+2 modules (CommandSemantics, CommandClassification,
+ * DestructiveCommandWarnings, LargeOutputHandler) and emits shell execution lifecycle
+ * events via EventBus.
+ *
+ * @param input - Command and execution parameters
+ * @param context - Agent/channel/request context for events and security
+ * @returns Enhanced execution result with semantic exit codes and classification
+ */
+export declare function execute(input: ShellExecuteInput, context: ShellExecuteContext): Promise<ShellExecuteResult>;
+//# sourceMappingURL=ShellExecuteHandler.d.ts.map

package/dist/protocols/mcp/tools/shell/ShellExecuteHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ShellExecuteHandler.d.ts","sourceRoot":"","sources":["../../../../../src/protocols/mcp/tools/shell/ShellExecuteHandler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAiCH,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,qCAAqC,CAAC;AAezE;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAC9B,+BAA+B;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,qDAAqD;IACrD,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,8CAA8C;IAC9C,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,+DAA+D;IAC/D,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,uDAAuD;IACvD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kEAAkE;IAClE,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,oEAAoE;IACpE,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,0DAA0D;IAC1D,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAChC,kCAAkC;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,qDAAqD;IACrD,SAAS,EAAE,SAAS,CAAC;IACrB,sDAAsD;IACtD,SAAS,EAAE,MAAM,CAAC;CACrB;AAED;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IAC/B,0EAA0E;IAC1E,OAAO,EAAE,MAAM,CAAC;IAChB,0DAA0D;IAC1D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wBAAwB;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,8EAA8E;IAC9E,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,wEAAwE;IACxE,OAAO,EAAE,OAAO,CAAC;IACjB,4DAA4D;IAC5D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4DAA4D;IAC5D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sCAAsC;IACtC,cAAc,CAAC,EAAE;QACb,iEAAiE;QACjE,QAAQ,EAAE,MAAM,CAAC;QACjB,0CAA0C;QAC1C,UAAU,EAAE,OAAO,CAAC;QACpB,+DAA+D;QAC/D,QAAQ,EAAE,OAAO,CAAC;KACrB,CAAC;IACF,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,qCAAqC;IACrC,aAAa,EAAE,MAAM,CAAC;IACtB,yCAAyC;IACzC,UAAU,EAAE,MAAM,CAAC;IACnB,+DAA+D;IAC/D,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,uDAAuD;IACvD,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,uDAAuD;IACvD,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,+CAA+C;IAC/C,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAiFD;;;;;;;;;;;;GAYG;AACH,wBAAsB,OAAO,CACzB,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE,mBAAmB,GAC7B,OAAO,CAAC,kBAAkB,CAAC,CAoQ7B"}