pm-orchestrator-runner 1.0.0

package/dist/mediation/llm-mediation-layer.js

@@ -0,0 +1,315 @@
+"use strict";
+/**
+ * LLM Mediation Layer
+ *
+ * Sits ABOVE Runner Core to handle ALL user interaction and decision making.
+ * Runner Core returns structured signals (facts only), this layer:
+ * - Generates natural language questions to users
+ * - Interprets user responses
+ * - Normalizes responses into explicit tasks for Runner
+ *
+ * ARCHITECTURAL RULES:
+ * - Runner MUST NOT contain conversational phrasing logic
+ * - Runner MUST NOT contain file-name-specific logic
+ * - This layer is the ONLY component that asks questions
+ * - This layer decides how to phrase clarification questions
+ * - This layer decides follow-up actions based on user answers
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LLMMediationLayer = void 0;
+/**
+ * LLM Mediation Layer
+ *
+ * Handles all user interaction and decision making.
+ * Receives structured signals from Runner, generates natural language,
+ * interprets user responses, and normalizes them into explicit tasks.
+ */
+class LLMMediationLayer {
+    /**
+     * Process Runner signal and generate appropriate output
+     *
+     * @param signal - Structured signal from Runner Core
+     * @returns Mediation output (question to user or normalized task)
+     */
+    processRunnerSignal(signal) {
+        // If no clarification needed, pass through
+        if (!signal.clarification_needed) {
+            return {
+                needs_user_input: false,
+                status_message: this.generateStatusMessage(signal),
+            };
+        }
+        // Generate appropriate question based on clarification reason
+        switch (signal.clarification_reason) {
+            case 'target_file_exists':
+                return this.handleFileExistsCase(signal);
+            case 'target_file_ambiguous':
+                return this.handleFileAmbiguousCase(signal);
+            case 'target_action_ambiguous':
+                return this.handleActionAmbiguousCase(signal);
+            case 'missing_required_info':
+                return this.handleMissingInfoCase(signal);
+            default:
+                // Unknown reason - ask for general clarification
+                return {
+                    needs_user_input: true,
+                    question: 'タスクの詳細を教えてください。',
+                    suggested_responses: [],
+                };
+        }
+    }
+    /**
+     * Parse user response and determine response type
+     *
+     * @param userInput - Raw user input string
+     * @param context - Context from previous clarification
+     * @returns Parsed user response
+     */
+    parseUserResponse(userInput, context) {
+        const input = userInput.trim().toLowerCase();
+        // Check for cancel intent
+        if (this.isCancelIntent(input)) {
+            return { type: 'cancel', raw_input: userInput };
+        }
+        // Parse based on context
+        switch (context.clarification_reason) {
+            case 'target_file_exists':
+                return this.parseOverwriteResponse(userInput);
+            case 'target_file_ambiguous':
+                return this.parseFileSpecification(userInput);
+            case 'target_action_ambiguous':
+                return this.parseActionSpecification(userInput);
+            default:
+                return { type: 'unknown', raw_input: userInput };
+        }
+    }
+    /**
+     * Normalize user response into explicit task for Runner
+     *
+     * @param originalPrompt - Original user prompt
+     * @param signal - Runner signal that triggered clarification
+     * @param parsedResponse - Parsed user response
+     * @returns Normalized task or null if cancelled
+     */
+    normalizeToTask(originalPrompt, signal, parsedResponse) {
+        if (parsedResponse.type === 'cancel') {
+            return null;
+        }
+        const context = {
+            original_prompt: originalPrompt,
+            clarification_reason: signal.clarification_reason,
+            user_response: parsedResponse.raw_input,
+        };
+        switch (parsedResponse.type) {
+            case 'overwrite':
+                return {
+                    explicit_prompt: `${signal.target_file} を上書きして作成してください`,
+                    target_file: signal.target_file,
+                    action: 'overwrite',
+                    original_context: context,
+                };
+            case 'new_name':
+                const newFileName = parsedResponse.new_file_name || this.generateAlternativeName(signal.target_file);
+                return {
+                    explicit_prompt: `${newFileName} を新規作成してください`,
+                    target_file: newFileName,
+                    action: 'create_new',
+                    original_context: context,
+                };
+            case 'specify_file':
+                return {
+                    explicit_prompt: `${parsedResponse.new_file_name} を作成してください`,
+                    target_file: parsedResponse.new_file_name,
+                    action: 'create',
+                    original_context: context,
+                };
+            case 'specify_action':
+                return {
+                    explicit_prompt: parsedResponse.specified_action || originalPrompt,
+                    action: 'modify',
+                    original_context: context,
+                };
+            default:
+                // Unknown response - return original prompt with context
+                return {
+                    explicit_prompt: originalPrompt,
+                    action: 'create',
+                    original_context: context,
+                };
+        }
+    }
+    // ============================================================
+    // Private helper methods
+    // ============================================================
+    /**
+     * Handle case when target file already exists
+     */
+    handleFileExistsCase(signal) {
+        const fileName = signal.target_file || 'ファイル';
+        return {
+            needs_user_input: true,
+            question: `${fileName} は既に存在します。上書きしますか？それとも別名で新規作成しますか？（overwrite / new）`,
+            suggested_responses: ['overwrite', 'new', 'cancel'],
+        };
+    }
+    /**
+     * Handle case when target file is ambiguous
+     */
+    handleFileAmbiguousCase(signal) {
+        return {
+            needs_user_input: true,
+            question: '対象のファイル名またはパスを指定してください。',
+            suggested_responses: [],
+        };
+    }
+    /**
+     * Handle case when action is ambiguous
+     */
+    handleActionAmbiguousCase(signal) {
+        return {
+            needs_user_input: true,
+            question: 'どの機能/箇所を修正しますか？（例: コマンド名、エラー文、対象ファイル）',
+            suggested_responses: [],
+        };
+    }
+    /**
+     * Handle case when required info is missing
+     */
+    handleMissingInfoCase(signal) {
+        return {
+            needs_user_input: true,
+            question: 'タスクを実行するために必要な情報を教えてください。',
+            suggested_responses: [],
+        };
+    }
+    /**
+     * Generate status message for non-clarification cases
+     */
+    generateStatusMessage(signal) {
+        if (signal.execution_result) {
+            const result = signal.execution_result;
+            switch (result.status) {
+                case 'COMPLETE':
+                    const files = result.verified_files?.filter(f => f.exists).map(f => f.path) || [];
+                    return files.length > 0
+                        ? `完了しました。作成されたファイル: ${files.join(', ')}`
+                        : '完了しました。';
+                case 'INCOMPLETE':
+                    return 'タスクは部分的に完了しました。';
+                case 'NO_EVIDENCE':
+                    return 'タスクの完了を確認できませんでした。';
+                case 'ERROR':
+                    return 'エラーが発生しました。';
+            }
+        }
+        return 'タスクを処理中です。';
+    }
+    /**
+     * Check if input indicates cancel intent
+     */
+    isCancelIntent(input) {
+        const cancelPatterns = [
+            'cancel', 'キャンセル', '中止', 'やめる', 'やめて',
+            'abort', 'stop', '止める', '止めて', 'いいえ', 'no',
+        ];
+        return cancelPatterns.some(pattern => input.includes(pattern));
+    }
+    /**
+     * Parse response for overwrite/new decision
+     */
+    parseOverwriteResponse(input) {
+        const normalized = input.trim().toLowerCase();
+        // Check for overwrite intent
+        const overwritePatterns = [
+            'overwrite', '上書き', 'うわがき', 'replace', '置き換え',
+            'yes', 'はい', 'ok', 'おｋ',
+        ];
+        if (overwritePatterns.some(p => normalized.includes(p))) {
+            return { type: 'overwrite', raw_input: input };
+        }
+        // Check for new name intent
+        const newNamePatterns = [
+            'new', '新規', 'しんき', '別名', 'べつめい', '別の名前',
+            'different', 'another',
+        ];
+        if (newNamePatterns.some(p => normalized.includes(p))) {
+            // Try to extract new file name from input
+            const newFileName = this.extractFileName(input);
+            return {
+                type: 'new_name',
+                new_file_name: newFileName || undefined,
+                raw_input: input,
+            };
+        }
+        // Check if user provided a specific file name
+        const extractedFile = this.extractFileName(input);
+        if (extractedFile) {
+            return {
+                type: 'new_name',
+                new_file_name: extractedFile,
+                raw_input: input,
+            };
+        }
+        return { type: 'unknown', raw_input: input };
+    }
+    /**
+     * Parse response for file specification
+     */
+    parseFileSpecification(input) {
+        const fileName = this.extractFileName(input);
+        if (fileName) {
+            return {
+                type: 'specify_file',
+                new_file_name: fileName,
+                raw_input: input,
+            };
+        }
+        return { type: 'unknown', raw_input: input };
+    }
+    /**
+     * Parse response for action specification
+     */
+    parseActionSpecification(input) {
+        // If input is non-trivial, treat it as action specification
+        if (input.trim().length > 2) {
+            return {
+                type: 'specify_action',
+                specified_action: input.trim(),
+                raw_input: input,
+            };
+        }
+        return { type: 'unknown', raw_input: input };
+    }
+    /**
+     * Extract file name from user input
+     */
+    extractFileName(input) {
+        // Pattern for file paths with extensions
+        const extensions = 'ts|tsx|js|jsx|json|md|txt|yaml|yml|html|css|sh';
+        const filePattern = new RegExp(`(?:^|\\s)((?:[\\w.-]+\\/)*[\\w.-]+\\.(?:${extensions}))(?:\\s|$|を|に|の|で|と|は)`, 'i');
+        const match = input.match(filePattern);
+        if (match) {
+            return match[1];
+        }
+        return null;
+    }
+    /**
+     * Generate alternative file name
+     */
+    generateAlternativeName(originalFile) {
+        if (!originalFile) {
+            return 'new_file.txt';
+        }
+        const ext = originalFile.includes('.')
+            ? originalFile.substring(originalFile.lastIndexOf('.'))
+            : '';
+        const baseName = originalFile.includes('.')
+            ? originalFile.substring(0, originalFile.lastIndexOf('.'))
+            : originalFile;
+        // Add timestamp suffix
+        const timestamp = new Date().toISOString().replace(/[:.]/g, '-').substring(0, 19);
+        return `${baseName}_${timestamp}${ext}`;
+    }
+}
+exports.LLMMediationLayer = LLMMediationLayer;
+//# sourceMappingURL=llm-mediation-layer.js.map

package/dist/mediation/llm-mediation-layer.js.map

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

package/dist/mediation/llm-sentinel.d.ts

@@ -0,0 +1,107 @@
+/**
+ * LLM Sentinel - File-based Evidence Verification
+ *
+ * Sentinel that verifies LLM execution evidence before allowing
+ * COMPLETE status to be reported.
+ *
+ * ARCHITECTURAL RULES:
+ * - COMPLETE status requires verified evidence files
+ * - Sentinel checks evidence integrity (hash verification)
+ * - Sentinel checks evidence completeness (at least one success)
+ * - Fail-closed: Any verification failure = cannot assert COMPLETE
+ */
+import { LLMEvidenceManager, LLMEvidence, EvidenceStats } from './llm-evidence-manager';
+/**
+ * Sentinel verification result
+ */
+export interface SentinelVerificationResult {
+    /** Overall verification passed */
+    passed: boolean;
+    /** Timestamp of verification */
+    timestamp: string;
+    /** Evidence directory checked */
+    evidence_dir: string;
+    /** Number of evidence files found */
+    evidence_count: number;
+    /** Number of successful calls */
+    successful_calls: number;
+    /** Number of failed calls */
+    failed_calls: number;
+    /** Integrity check results */
+    integrity_checks: IntegrityCheckResult[];
+    /** Overall integrity passed */
+    integrity_passed: boolean;
+    /** Can assert COMPLETE status */
+    can_assert_complete: boolean;
+    /** Reason if verification failed */
+    failure_reason?: string;
+}
+/**
+ * Individual evidence integrity check result
+ */
+export interface IntegrityCheckResult {
+    call_id: string;
+    file_exists: boolean;
+    hash_valid: boolean;
+    passed: boolean;
+}
+/**
+ * LLM Sentinel for evidence verification
+ *
+ * Fail-closed behavior:
+ * - No evidence = FAIL
+ * - Evidence integrity failure = FAIL
+ * - All calls failed = FAIL
+ * - At least one successful call with valid evidence = PASS
+ */
+export declare class LLMSentinel {
+    private readonly evidenceManager;
+    constructor(evidenceDir: string);
+    /**
+     * Create sentinel from existing evidence manager
+     */
+    static fromEvidenceManager(manager: LLMEvidenceManager): LLMSentinel;
+    /**
+     * Verify all evidence and determine if COMPLETE can be asserted
+     *
+     * This is the main entry point for the fail-closed check.
+     */
+    verify(): SentinelVerificationResult;
+    /**
+     * Quick check if COMPLETE can be asserted
+     *
+     * This is a lightweight check that doesn't do full integrity verification.
+     */
+    canAssertComplete(): boolean;
+    /**
+     * Full verification with integrity checks
+     */
+    fullVerification(): SentinelVerificationResult;
+    /**
+     * Check integrity of a single evidence file
+     */
+    private checkIntegrity;
+    /**
+     * Get evidence statistics
+     */
+    getStats(): EvidenceStats;
+    /**
+     * Get detailed evidence list
+     */
+    getEvidenceDetails(): LLMEvidence[];
+    /**
+     * Generate verification report for logging
+     */
+    generateReport(): string;
+}
+/**
+ * Create sentinel for evidence directory
+ */
+export declare function createSentinel(evidenceDir: string): LLMSentinel;
+/**
+ * Verify evidence and return whether COMPLETE can be asserted
+ *
+ * Convenience function for fail-closed check.
+ */
+export declare function verifyLLMEvidence(evidenceDir: string): SentinelVerificationResult;
+//# sourceMappingURL=llm-sentinel.d.ts.map

package/dist/mediation/llm-sentinel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-sentinel.d.ts","sourceRoot":"","sources":["../../src/mediation/llm-sentinel.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,OAAO,EAAE,kBAAkB,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAExF;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,kCAAkC;IAClC,MAAM,EAAE,OAAO,CAAC;IAChB,gCAAgC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,iCAAiC;IACjC,YAAY,EAAE,MAAM,CAAC;IACrB,qCAAqC;IACrC,cAAc,EAAE,MAAM,CAAC;IACvB,iCAAiC;IACjC,gBAAgB,EAAE,MAAM,CAAC;IACzB,6BAA6B;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,8BAA8B;IAC9B,gBAAgB,EAAE,oBAAoB,EAAE,CAAC;IACzC,+BAA+B;IAC/B,gBAAgB,EAAE,OAAO,CAAC;IAC1B,iCAAiC;IACjC,mBAAmB,EAAE,OAAO,CAAC;IAC7B,oCAAoC;IACpC,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,OAAO,CAAC;IACrB,UAAU,EAAE,OAAO,CAAC;IACpB,MAAM,EAAE,OAAO,CAAC;CACjB;AAED;;;;;;;;GAQG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAqB;gBAEzC,WAAW,EAAE,MAAM;IAI/B;;OAEG;IACH,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,kBAAkB,GAAG,WAAW;IAMpE;;;;OAIG;IACH,MAAM,IAAI,0BAA0B;IA4DpC;;;;OAIG;IACH,iBAAiB,IAAI,OAAO;IAI5B;;OAEG;IACH,gBAAgB,IAAI,0BAA0B;IAI9C;;OAEG;IACH,OAAO,CAAC,cAAc;IAYtB;;OAEG;IACH,QAAQ,IAAI,aAAa;IAIzB;;OAEG;IACH,kBAAkB,IAAI,WAAW,EAAE;IAInC;;OAEG;IACH,cAAc,IAAI,MAAM;CAkCzB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,WAAW,CAE/D;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,0BAA0B,CAGjF"}

package/dist/mediation/llm-sentinel.js

@@ -0,0 +1,187 @@
+"use strict";
+/**
+ * LLM Sentinel - File-based Evidence Verification
+ *
+ * Sentinel that verifies LLM execution evidence before allowing
+ * COMPLETE status to be reported.
+ *
+ * ARCHITECTURAL RULES:
+ * - COMPLETE status requires verified evidence files
+ * - Sentinel checks evidence integrity (hash verification)
+ * - Sentinel checks evidence completeness (at least one success)
+ * - Fail-closed: Any verification failure = cannot assert COMPLETE
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LLMSentinel = void 0;
+exports.createSentinel = createSentinel;
+exports.verifyLLMEvidence = verifyLLMEvidence;
+const llm_evidence_manager_1 = require("./llm-evidence-manager");
+/**
+ * LLM Sentinel for evidence verification
+ *
+ * Fail-closed behavior:
+ * - No evidence = FAIL
+ * - Evidence integrity failure = FAIL
+ * - All calls failed = FAIL
+ * - At least one successful call with valid evidence = PASS
+ */
+class LLMSentinel {
+    evidenceManager;
+    constructor(evidenceDir) {
+        this.evidenceManager = new llm_evidence_manager_1.LLMEvidenceManager(evidenceDir);
+    }
+    /**
+     * Create sentinel from existing evidence manager
+     */
+    static fromEvidenceManager(manager) {
+        const sentinel = Object.create(LLMSentinel.prototype);
+        sentinel.evidenceManager = manager;
+        return sentinel;
+    }
+    /**
+     * Verify all evidence and determine if COMPLETE can be asserted
+     *
+     * This is the main entry point for the fail-closed check.
+     */
+    verify() {
+        const timestamp = new Date().toISOString();
+        const evidenceDir = this.evidenceManager.getEvidenceDir();
+        // Get all evidence
+        const allEvidence = this.evidenceManager.listEvidence();
+        // No evidence = fail-closed
+        if (allEvidence.length === 0) {
+            return {
+                passed: false,
+                timestamp,
+                evidence_dir: evidenceDir,
+                evidence_count: 0,
+                successful_calls: 0,
+                failed_calls: 0,
+                integrity_checks: [],
+                integrity_passed: true, // No files to check
+                can_assert_complete: false,
+                failure_reason: 'No LLM evidence found (fail-closed)',
+            };
+        }
+        // Check integrity of each evidence file
+        const integrityChecks = allEvidence.map(evidence => this.checkIntegrity(evidence));
+        const integrityPassed = integrityChecks.every(check => check.passed);
+        // Get statistics
+        const stats = this.evidenceManager.getStats();
+        // Determine if COMPLETE can be asserted
+        // Requires: at least one successful call + all integrity checks passed
+        const canAssertComplete = stats.successful_calls > 0 && integrityPassed;
+        // Determine failure reason if any
+        let failureReason;
+        if (!integrityPassed) {
+            const failedCallIds = integrityChecks
+                .filter(c => !c.passed)
+                .map(c => c.call_id)
+                .join(', ');
+            failureReason = 'Evidence integrity check failed for: ' + failedCallIds;
+        }
+        else if (stats.successful_calls === 0) {
+            failureReason = 'No successful LLM calls found (all calls failed)';
+        }
+        return {
+            passed: canAssertComplete,
+            timestamp,
+            evidence_dir: evidenceDir,
+            evidence_count: allEvidence.length,
+            successful_calls: stats.successful_calls,
+            failed_calls: stats.failed_calls,
+            integrity_checks: integrityChecks,
+            integrity_passed: integrityPassed,
+            can_assert_complete: canAssertComplete,
+            failure_reason: failureReason,
+        };
+    }
+    /**
+     * Quick check if COMPLETE can be asserted
+     *
+     * This is a lightweight check that doesn't do full integrity verification.
+     */
+    canAssertComplete() {
+        return this.evidenceManager.canAssertComplete();
+    }
+    /**
+     * Full verification with integrity checks
+     */
+    fullVerification() {
+        return this.verify();
+    }
+    /**
+     * Check integrity of a single evidence file
+     */
+    checkIntegrity(evidence) {
+        const fileExists = this.evidenceManager.hasEvidence(evidence.call_id);
+        const hashValid = fileExists && this.evidenceManager.verifyIntegrity(evidence.call_id);
+        return {
+            call_id: evidence.call_id,
+            file_exists: fileExists,
+            hash_valid: hashValid,
+            passed: fileExists && hashValid,
+        };
+    }
+    /**
+     * Get evidence statistics
+     */
+    getStats() {
+        return this.evidenceManager.getStats();
+    }
+    /**
+     * Get detailed evidence list
+     */
+    getEvidenceDetails() {
+        return this.evidenceManager.listEvidence();
+    }
+    /**
+     * Generate verification report for logging
+     */
+    generateReport() {
+        const result = this.verify();
+        const lines = [
+            '========================================',
+            'LLM Sentinel Verification Report',
+            '========================================',
+            'Timestamp: ' + result.timestamp,
+            'Evidence Directory: ' + result.evidence_dir,
+            'Evidence Count: ' + result.evidence_count,
+            'Successful Calls: ' + result.successful_calls,
+            'Failed Calls: ' + result.failed_calls,
+            'Integrity Passed: ' + result.integrity_passed,
+            'Can Assert COMPLETE: ' + result.can_assert_complete,
+            'Overall Result: ' + (result.passed ? 'PASS' : 'FAIL'),
+        ];
+        if (result.failure_reason) {
+            lines.push('Failure Reason: ' + result.failure_reason);
+        }
+        if (result.integrity_checks.length > 0) {
+            lines.push('');
+            lines.push('Integrity Check Details:');
+            for (const check of result.integrity_checks) {
+                const status = check.passed ? 'PASS' : 'FAIL';
+                lines.push('  - ' + check.call_id + ': ' + status + ' (file=' + check.file_exists + ', hash=' + check.hash_valid + ')');
+            }
+        }
+        lines.push('========================================');
+        return lines.join('\n');
+    }
+}
+exports.LLMSentinel = LLMSentinel;
+/**
+ * Create sentinel for evidence directory
+ */
+function createSentinel(evidenceDir) {
+    return new LLMSentinel(evidenceDir);
+}
+/**
+ * Verify evidence and return whether COMPLETE can be asserted
+ *
+ * Convenience function for fail-closed check.
+ */
+function verifyLLMEvidence(evidenceDir) {
+    const sentinel = new LLMSentinel(evidenceDir);
+    return sentinel.verify();
+}
+//# sourceMappingURL=llm-sentinel.js.map

package/dist/mediation/llm-sentinel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-sentinel.js","sourceRoot":"","sources":["../../src/mediation/llm-sentinel.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;GAWG;;;AA2NH,wCAEC;AAOD,8CAGC;AAnOD,iEAAwF;AAsCxF;;;;;;;;GAQG;AACH,MAAa,WAAW;IACL,eAAe,CAAqB;IAErD,YAAY,WAAmB;QAC7B,IAAI,CAAC,eAAe,GAAG,IAAI,yCAAkB,CAAC,WAAW,CAAC,CAAC;IAC7D,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,mBAAmB,CAAC,OAA2B;QACpD,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;QACtD,QAAQ,CAAC,eAAe,GAAG,OAAO,CAAC;QACnC,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;;;OAIG;IACH,MAAM;QACJ,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAC3C,MAAM,WAAW,GAAG,IAAI,CAAC,eAAe,CAAC,cAAc,EAAE,CAAC;QAE1D,mBAAmB;QACnB,MAAM,WAAW,GAAG,IAAI,CAAC,eAAe,CAAC,YAAY,EAAE,CAAC;QAExD,4BAA4B;QAC5B,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC7B,OAAO;gBACL,MAAM,EAAE,KAAK;gBACb,SAAS;gBACT,YAAY,EAAE,WAAW;gBACzB,cAAc,EAAE,CAAC;gBACjB,gBAAgB,EAAE,CAAC;gBACnB,YAAY,EAAE,CAAC;gBACf,gBAAgB,EAAE,EAAE;gBACpB,gBAAgB,EAAE,IAAI,EAAE,oBAAoB;gBAC5C,mBAAmB,EAAE,KAAK;gBAC1B,cAAc,EAAE,qCAAqC;aACtD,CAAC;QACJ,CAAC;QAED,wCAAwC;QACxC,MAAM,eAAe,GAAG,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAC;QACnF,MAAM,eAAe,GAAG,eAAe,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAErE,iBAAiB;QACjB,MAAM,KAAK,GAAG,IAAI,CAAC,eAAe,CAAC,QAAQ,EAAE,CAAC;QAE9C,wCAAwC;QACxC,uEAAuE;QACvE,MAAM,iBAAiB,GAAG,KAAK,CAAC,gBAAgB,GAAG,CAAC,IAAI,eAAe,CAAC;QAExE,kCAAkC;QAClC,IAAI,aAAiC,CAAC;QACtC,IAAI,CAAC,eAAe,EAAE,CAAC;YACrB,MAAM,aAAa,GAAG,eAAe;iBAClC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;iBACtB,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;iBACnB,IAAI,CAAC,IAAI,CAAC,CAAC;YACd,aAAa,GAAG,uCAAuC,GAAG,aAAa,CAAC;QAC1E,CAAC;aAAM,IAAI,KAAK,CAAC,gBAAgB,KAAK,CAAC,EAAE,CAAC;YACxC,aAAa,GAAG,kDAAkD,CAAC;QACrE,CAAC;QAED,OAAO;YACL,MAAM,EAAE,iBAAiB;YACzB,SAAS;YACT,YAAY,EAAE,WAAW;YACzB,cAAc,EAAE,WAAW,CAAC,MAAM;YAClC,gBAAgB,EAAE,KAAK,CAAC,gBAAgB;YACxC,YAAY,EAAE,KAAK,CAAC,YAAY;YAChC,gBAAgB,EAAE,eAAe;YACjC,gBAAgB,EAAE,eAAe;YACjC,mBAAmB,EAAE,iBAAiB;YACtC,cAAc,EAAE,aAAa;SAC9B,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACH,iBAAiB;QACf,OAAO,IAAI,CAAC,eAAe,CAAC,iBAAiB,EAAE,CAAC;IAClD,CAAC;IAED;;OAEG;IACH,gBAAgB;QACd,OAAO,IAAI,CAAC,MAAM,EAAE,CAAC;IACvB,CAAC;IAED;;OAEG;IACK,cAAc,CAAC,QAAqB;QAC1C,MAAM,UAAU,GAAG,IAAI,CAAC,eAAe,CAAC,WAAW,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QACtE,MAAM,SAAS,GAAG,UAAU,IAAI,IAAI,CAAC,eAAe,CAAC,eAAe,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QAEvF,OAAO;YACL,OAAO,EAAE,QAAQ,CAAC,OAAO;YACzB,WAAW,EAAE,UAAU;YACvB,UAAU,EAAE,SAAS;YACrB,MAAM,EAAE,UAAU,IAAI,SAAS;SAChC,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,OAAO,IAAI,CAAC,eAAe,CAAC,QAAQ,EAAE,CAAC;IACzC,CAAC;IAED;;OAEG;IACH,kBAAkB;QAChB,OAAO,IAAI,CAAC,eAAe,CAAC,YAAY,EAAE,CAAC;IAC7C,CAAC;IAED;;OAEG;IACH,cAAc;QACZ,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QAE7B,MAAM,KAAK,GAAG;YACZ,0CAA0C;YAC1C,kCAAkC;YAClC,0CAA0C;YAC1C,aAAa,GAAG,MAAM,CAAC,SAAS;YAChC,sBAAsB,GAAG,MAAM,CAAC,YAAY;YAC5C,kBAAkB,GAAG,MAAM,CAAC,cAAc;YAC1C,oBAAoB,GAAG,MAAM,CAAC,gBAAgB;YAC9C,gBAAgB,GAAG,MAAM,CAAC,YAAY;YACtC,oBAAoB,GAAG,MAAM,CAAC,gBAAgB;YAC9C,uBAAuB,GAAG,MAAM,CAAC,mBAAmB;YACpD,kBAAkB,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC;SACvD,CAAC;QAEF,IAAI,MAAM,CAAC,cAAc,EAAE,CAAC;YAC1B,KAAK,CAAC,IAAI,CAAC,kBAAkB,GAAG,MAAM,CAAC,cAAc,CAAC,CAAC;QACzD,CAAC;QAED,IAAI,MAAM,CAAC,gBAAgB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACf,KAAK,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;YACvC,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,gBAAgB,EAAE,CAAC;gBAC5C,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC;gBAC9C,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,OAAO,GAAG,IAAI,GAAG,MAAM,GAAG,SAAS,GAAG,KAAK,CAAC,WAAW,GAAG,SAAS,GAAG,KAAK,CAAC,UAAU,GAAG,GAAG,CAAC,CAAC;YAC1H,CAAC;QACH,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,0CAA0C,CAAC,CAAC;QAEvD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;CACF;AAnKD,kCAmKC;AAED;;GAEG;AACH,SAAgB,cAAc,CAAC,WAAmB;IAChD,OAAO,IAAI,WAAW,CAAC,WAAW,CAAC,CAAC;AACtC,CAAC;AAED;;;;GAIG;AACH,SAAgB,iBAAiB,CAAC,WAAmB;IACnD,MAAM,QAAQ,GAAG,IAAI,WAAW,CAAC,WAAW,CAAC,CAAC;IAC9C,OAAO,QAAQ,CAAC,MAAM,EAAE,CAAC;AAC3B,CAAC"}