mcp-test-timebox 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 K.Kawanishi
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,192 @@
+# mcp-test-timebox
+
+テスト実行の「終わらない／戻ってこない」問題を防ぐ、タイムボックス付きテスト専用MCPサーバ。
+
+## 概要
+
+- **必ず結果を返す**: ハードタイムアウト・無出力タイムアウトにより、ハングしても必ずレスポンスを返却
+- **安全な実行**: 任意コマンド実行を禁止し、固定テンプレート（`flutter test`等）のみ許可
+- **成果物の保存**: 実行ごとに `raw.log` / `summary.md` / `summary.json` を生成
+
+## インストール
+
+### 前提条件
+
+- Node.js 18.0.0 以上
+- npm または yarn
+
+### インストール手順
+
+```bash
+# リポジトリをクローン
+git clone <repository-url>
+cd mcp-test-timebox
+
+# 依存関係をインストール
+npm install
+
+# ビルド
+npm run build
+```
+
+## 使用方法
+
+### MCPサーバとして起動
+
+```bash
+# stdio経由でMCPサーバを起動
+npm run start
+
+# または直接実行
+node dist/server.js
+```
+
+### run_test ツールのパラメータ
+
+| パラメータ | 型 | 必須 | 説明 |
+|-----------|-----|------|------|
+| `runner` | string | ✓ | テストランナー（現在は `flutter` のみ） |
+| `scope` | string | ✓ | 実行スコープ: `all`, `file`, `pattern` |
+| `target` | string | △ | `scope` が `file` または `pattern` の場合に必須 |
+| `timeout_ms` | number | ✓ | ハードタイムアウト（ミリ秒） |
+| `no_output_timeout_ms` | number | ✓ | 無出力タイムアウト（ミリ秒） |
+| `max_output_bytes` | number | ✓ | 要約対象の末尾バイト数 |
+| `report_dir` | string | - | レポート出力先（省略時は自動生成） |
+
+### 実行例
+
+```json
+{
+  "runner": "flutter",
+  "scope": "all",
+  "timeout_ms": 300000,
+  "no_output_timeout_ms": 60000,
+  "max_output_bytes": 102400
+}
+```
+
+```json
+{
+  "runner": "flutter",
+  "scope": "file",
+  "target": "test/widget_test.dart",
+  "timeout_ms": 300000,
+  "no_output_timeout_ms": 60000,
+  "max_output_bytes": 102400
+}
+```
+
+### レスポンス
+
+```json
+{
+  "status": "pass",
+  "exit_code": 0,
+  "duration_ms": 12345,
+  "report_dir": ".cache/mcp-test-timebox/reports/20260113-123456",
+  "artifacts": {
+    "raw_log": ".cache/mcp-test-timebox/reports/20260113-123456/raw.log",
+    "summary_md": ".cache/mcp-test-timebox/reports/20260113-123456/summary.md",
+    "summary_json": ".cache/mcp-test-timebox/reports/20260113-123456/summary.json"
+  },
+  "excerpt": "..."
+}
+```
+
+### ステータス一覧
+
+| ステータス | 説明 |
+|-----------|------|
+| `pass` | テスト成功（exit code 0） |
+| `fail` | テスト失敗（exit code ≠ 0） |
+| `timeout` | ハードタイムアウト超過 |
+| `no_output` | 無出力タイムアウト超過 |
+| `error` | バリデーションエラー等 |
+
+## MCP設定例
+
+### Kiro での設定
+
+`.kiro/settings/mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "mcp-test-timebox": {
+      "command": "node",
+      "args": ["/path/to/mcp-test-timebox/dist/server.js"],
+      "disabled": false,
+      "autoApprove": []
+    }
+  }
+}
+```
+
+### Claude Desktop での設定
+
+`claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "mcp-test-timebox": {
+      "command": "node",
+      "args": ["/path/to/mcp-test-timebox/dist/server.js"]
+    }
+  }
+}
+```
+
+## 開発
+
+### ビルド
+
+```bash
+npm run build
+```
+
+### テスト実行
+
+```bash
+# 全テスト実行
+npm run test
+
+# ウォッチモード
+npm run test:watch
+
+# カバレッジ付き
+npm run test:coverage
+```
+
+### 開発モード（ウォッチビルド）
+
+```bash
+npm run dev
+```
+
+## 成果物
+
+テスト実行ごとに以下のファイルが生成されます：
+
+```
+.cache/mcp-test-timebox/reports/<timestamp>/
+├── raw.log        # stdout/stderrの完全ログ（出力元を区別）
+├── summary.md     # 人間が読みやすい要約
+└── summary.json   # 機械処理用の構造化データ
+```
+
+### raw.log フォーマット
+
+```
+[2026-01-13T12:34:56.789Z] [stdout] Running "flutter test"...
+[2026-01-13T12:34:57.123Z] [stderr] Warning: some warning
+[2026-01-13T12:34:58.456Z] [stdout] ✓ Test passed
+```
+
+## ドキュメント
+
+- [MVP要件](docs/MVP.md) - プロジェクトのMVP仕様
+
+## ライセンス
+
+MIT License - 詳細は [LICENSE](LICENSE) を参照

package/dist/executor/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Executor モジュール
+ *
+ * プロセス実行とタイムアウト監視に関するコンポーネントをエクスポート
+ */
+export { TimeboxController, createTimeboxController, type ITimeboxController, type TimeoutType, type TimeoutCallback, } from './timebox-controller.js';
+export { ProcessExecutor, createProcessExecutor, type IProcessExecutor, type ProcessExecutorOptions, type ProcessResult, type ProcessStatus, type LogEntry, } from './process-executor.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/executor/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/executor/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,iBAAiB,EACjB,uBAAuB,EACvB,KAAK,kBAAkB,EACvB,KAAK,WAAW,EAChB,KAAK,eAAe,GACrB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,KAAK,gBAAgB,EACrB,KAAK,sBAAsB,EAC3B,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,QAAQ,GACd,MAAM,uBAAuB,CAAC"}

package/dist/executor/index.js

@@ -0,0 +1,8 @@
+/**
+ * Executor モジュール
+ *
+ * プロセス実行とタイムアウト監視に関するコンポーネントをエクスポート
+ */
+export { TimeboxController, createTimeboxController, } from './timebox-controller.js';
+export { ProcessExecutor, createProcessExecutor, } from './process-executor.js';
+//# sourceMappingURL=index.js.map

package/dist/executor/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/executor/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,iBAAiB,EACjB,uBAAuB,GAIxB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,eAAe,EACf,qBAAqB,GAMtB,MAAM,uBAAuB,CAAC"}

package/dist/executor/process-executor.d.ts

@@ -0,0 +1,93 @@
+/**
+ * ProcessExecutor - プロセス実行とタイムアウト監視コンポーネント
+ *
+ * 子プロセスを生成し、タイムアウト監視を行う。
+ * - stdinを即座に閉じる
+ * - tree-killでプロセスツリーごと終了
+ * - stdout/stderrをLogEntryとして収集
+ *
+ * Requirements:
+ * - 3.1: プロセス起動時にstdinを即座に閉じる
+ * - 3.2: timeout_ms で指定された時間が経過したらプロセスを強制終了
+ * - 3.3: no_output_timeout_ms で指定された時間、出力がなければ強制終了
+ * - 3.4: プロセスツリーごと終了する
+ * - 3.5: exit code 0 で pass、それ以外で fail を返す
+ */
+/**
+ * ログエントリ - stdout/stderrの出力を記録
+ */
+export interface LogEntry {
+    /** Unix timestamp (ms) */
+    timestamp: number;
+    /** 出力元ストリーム */
+    stream: 'stdout' | 'stderr';
+    /** 出力データ */
+    data: string;
+}
+/**
+ * プロセス実行結果のステータス
+ */
+export type ProcessStatus = 'pass' | 'fail' | 'timeout' | 'no_output' | 'error';
+/**
+ * プロセス実行結果
+ */
+export interface ProcessResult {
+    /** 実行ステータス */
+    status: ProcessStatus;
+    /** 終了コード（タイムアウト時はnull） */
+    exitCode: number | null;
+    /** 実行時間（ミリ秒） */
+    durationMs: number;
+    /** ログエントリ（stdout/stderr） */
+    logs: LogEntry[];
+    /** タイムアウトしたかどうか */
+    timedOut: boolean;
+    /** 無出力タイムアウトしたかどうか */
+    noOutput: boolean;
+}
+/**
+ * プロセス実行オプション
+ */
+export interface ProcessExecutorOptions {
+    /** 作業ディレクトリ */
+    cwd: string;
+    /** ハードタイムアウト（ミリ秒） */
+    timeoutMs: number;
+    /** 無出力タイムアウト（ミリ秒） */
+    noOutputTimeoutMs: number;
+}
+/**
+ * ProcessExecutorインターフェース
+ */
+export interface IProcessExecutor {
+    /**
+     * プロセスを実行し、タイムアウト監視を行う
+     *
+     * @param command - 実行するコマンド
+     * @param args - コマンド引数
+     * @param options - 実行オプション
+     * @returns プロセス実行結果
+     */
+    execute(command: string, args: string[], options: ProcessExecutorOptions): Promise<ProcessResult>;
+}
+/**
+ * ProcessExecutor - プロセス実行の実装
+ */
+export declare class ProcessExecutor implements IProcessExecutor {
+    /**
+     * プロセスを実行し、タイムアウト監視を行う
+     *
+     * @param command - 実行するコマンド
+     * @param args - コマンド引数
+     * @param options - 実行オプション
+     * @returns プロセス実行結果
+     */
+    execute(command: string, args: string[], options: ProcessExecutorOptions): Promise<ProcessResult>;
+}
+/**
+ * ProcessExecutorのファクトリ関数
+ *
+ * @returns 新しいProcessExecutorインスタンス
+ */
+export declare function createProcessExecutor(): IProcessExecutor;
+//# sourceMappingURL=process-executor.d.ts.map

package/dist/executor/process-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-executor.d.ts","sourceRoot":"","sources":["../../src/executor/process-executor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAMH;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,0BAA0B;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe;IACf,MAAM,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC5B,YAAY;IACZ,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,WAAW,GAAG,OAAO,CAAC;AAEhF;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,cAAc;IACd,MAAM,EAAE,aAAa,CAAC;IACtB,0BAA0B;IAC1B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,gBAAgB;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,4BAA4B;IAC5B,IAAI,EAAE,QAAQ,EAAE,CAAC;IACjB,mBAAmB;IACnB,QAAQ,EAAE,OAAO,CAAC;IAClB,sBAAsB;IACtB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,eAAe;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,qBAAqB;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,qBAAqB;IACrB,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAGD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;;;;OAOG;IACH,OAAO,CACL,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,aAAa,CAAC,CAAC;CAC3B;AAED;;GAEG;AACH,qBAAa,eAAgB,YAAW,gBAAgB;IACtD;;;;;;;OAOG;IACG,OAAO,CACX,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,aAAa,CAAC;CAwI1B;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,IAAI,gBAAgB,CAExD"}

package/dist/executor/process-executor.js

@@ -0,0 +1,161 @@
+/**
+ * ProcessExecutor - プロセス実行とタイムアウト監視コンポーネント
+ *
+ * 子プロセスを生成し、タイムアウト監視を行う。
+ * - stdinを即座に閉じる
+ * - tree-killでプロセスツリーごと終了
+ * - stdout/stderrをLogEntryとして収集
+ *
+ * Requirements:
+ * - 3.1: プロセス起動時にstdinを即座に閉じる
+ * - 3.2: timeout_ms で指定された時間が経過したらプロセスを強制終了
+ * - 3.3: no_output_timeout_ms で指定された時間、出力がなければ強制終了
+ * - 3.4: プロセスツリーごと終了する
+ * - 3.5: exit code 0 で pass、それ以外で fail を返す
+ */
+import { spawn } from 'node:child_process';
+import treeKill from 'tree-kill';
+import { createTimeboxController } from './timebox-controller.js';
+/**
+ * ProcessExecutor - プロセス実行の実装
+ */
+export class ProcessExecutor {
+    /**
+     * プロセスを実行し、タイムアウト監視を行う
+     *
+     * @param command - 実行するコマンド
+     * @param args - コマンド引数
+     * @param options - 実行オプション
+     * @returns プロセス実行結果
+     */
+    async execute(command, args, options) {
+        const startTime = Date.now();
+        const logs = [];
+        const timebox = createTimeboxController();
+        return new Promise((resolve) => {
+            let childProcess = null;
+            let resolved = false;
+            /**
+             * 結果を返す（一度だけ）
+             */
+            const finalize = (result) => {
+                if (resolved)
+                    return;
+                resolved = true;
+                timebox.clear();
+                resolve(result);
+            };
+            /**
+             * プロセスを強制終了する
+             */
+            const killProcess = (timeoutType) => {
+                if (childProcess && childProcess.pid) {
+                    // tree-killでプロセスツリーごと終了（Requirements 3.4）
+                    treeKill(childProcess.pid, 'SIGKILL', (err) => {
+                        if (err) {
+                            // エラーが発生してもログに記録するのみ
+                            console.error(`[ProcessExecutor] tree-kill error: ${err.message}`);
+                        }
+                    });
+                }
+                const durationMs = Date.now() - startTime;
+                const isNoOutput = timeoutType === 'no_output';
+                finalize({
+                    status: isNoOutput ? 'no_output' : 'timeout',
+                    exitCode: null,
+                    durationMs,
+                    logs,
+                    timedOut: !isNoOutput,
+                    noOutput: isNoOutput,
+                });
+            };
+            try {
+                // プロセスを起動
+                childProcess = spawn(command, args, {
+                    cwd: options.cwd,
+                    stdio: ['pipe', 'pipe', 'pipe'],
+                    // Windowsでは shell: true が必要な場合がある
+                    shell: process.platform === 'win32',
+                });
+                // stdinを即座に閉じる（Requirements 3.1）
+                if (childProcess.stdin) {
+                    childProcess.stdin.end();
+                }
+                // タイムアウト設定（Requirements 3.2, 3.3）
+                timebox.setHardTimeout(options.timeoutMs, killProcess);
+                timebox.setNoOutputTimeout(options.noOutputTimeoutMs, killProcess);
+                // stdout監視
+                if (childProcess.stdout) {
+                    childProcess.stdout.on('data', (data) => {
+                        const entry = {
+                            timestamp: Date.now(),
+                            stream: 'stdout',
+                            data: data.toString(),
+                        };
+                        logs.push(entry);
+                        timebox.notifyOutput();
+                    });
+                }
+                // stderr監視
+                if (childProcess.stderr) {
+                    childProcess.stderr.on('data', (data) => {
+                        const entry = {
+                            timestamp: Date.now(),
+                            stream: 'stderr',
+                            data: data.toString(),
+                        };
+                        logs.push(entry);
+                        timebox.notifyOutput();
+                    });
+                }
+                // プロセス終了時
+                childProcess.on('close', (code) => {
+                    const durationMs = Date.now() - startTime;
+                    // exit code に基づいてステータスを決定（Requirements 3.5）
+                    const status = code === 0 ? 'pass' : 'fail';
+                    finalize({
+                        status,
+                        exitCode: code,
+                        durationMs,
+                        logs,
+                        timedOut: false,
+                        noOutput: false,
+                    });
+                });
+                // プロセスエラー時
+                childProcess.on('error', (err) => {
+                    const durationMs = Date.now() - startTime;
+                    finalize({
+                        status: 'error',
+                        exitCode: null,
+                        durationMs,
+                        logs,
+                        timedOut: false,
+                        noOutput: false,
+                    });
+                });
+            }
+            catch (err) {
+                // spawn自体が失敗した場合
+                const durationMs = Date.now() - startTime;
+                finalize({
+                    status: 'error',
+                    exitCode: null,
+                    durationMs,
+                    logs,
+                    timedOut: false,
+                    noOutput: false,
+                });
+            }
+        });
+    }
+}
+/**
+ * ProcessExecutorのファクトリ関数
+ *
+ * @returns 新しいProcessExecutorインスタンス
+ */
+export function createProcessExecutor() {
+    return new ProcessExecutor();
+}
+//# sourceMappingURL=process-executor.js.map

package/dist/executor/process-executor.js.map

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

package/dist/executor/timebox-controller.d.ts

@@ -0,0 +1,109 @@
+/**
+ * TimeboxController - タイムアウト監視コンポーネント
+ *
+ * プロセス実行のタイムアウトを管理する。
+ * - ハードタイムアウト: 指定時間経過で強制終了
+ * - 無出力タイムアウト: 出力がない状態が続くと強制終了
+ *
+ * Requirements:
+ * - 3.2: timeout_ms で指定された時間が経過したらプロセスを強制終了
+ * - 3.3: no_output_timeout_ms で指定された時間、出力がなければ強制終了
+ */
+/**
+ * タイムアウトの種類
+ */
+export type TimeoutType = 'hard' | 'no_output';
+/**
+ * タイムアウト発生時のコールバック
+ */
+export type TimeoutCallback = (type: TimeoutType) => void;
+/**
+ * TimeboxControllerインターフェース
+ */
+export interface ITimeboxController {
+    /** ハードタイムアウトを設定 */
+    setHardTimeout(ms: number, onTimeout: TimeoutCallback): void;
+    /** 無出力タイムアウトを設定 */
+    setNoOutputTimeout(ms: number, onTimeout: TimeoutCallback): void;
+    /** 出力があったことを通知（無出力タイマーをリセット） */
+    notifyOutput(): void;
+    /** すべてのタイマーをクリア */
+    clear(): void;
+    /** タイムアウトが発生したかどうか */
+    isTimedOut(): boolean;
+    /** タイムアウトの種類を取得 */
+    getTimeoutType(): TimeoutType | null;
+}
+/**
+ * TimeboxController - タイムアウト監視の実装
+ *
+ * 2種類のタイムアウトを管理:
+ * 1. ハードタイムアウト: 設定後、指定時間で必ず発火
+ * 2. 無出力タイムアウト: 出力があるたびにリセットされる
+ */
+export declare class TimeboxController implements ITimeboxController {
+    /** ハードタイムアウトのタイマーID */
+    private hardTimeoutId;
+    /** 無出力タイムアウトのタイマーID */
+    private noOutputTimeoutId;
+    /** 無出力タイムアウトの設定値（リセット用） */
+    private noOutputTimeoutMs;
+    /** 無出力タイムアウトのコールバック（リセット用） */
+    private noOutputCallback;
+    /** タイムアウトが発生したかどうか */
+    private timedOut;
+    /** 発生したタイムアウトの種類 */
+    private timeoutType;
+    /**
+     * ハードタイムアウトを設定する
+     *
+     * 指定時間経過後、コールバックを呼び出す。
+     * 一度設定すると、clear()が呼ばれるまでリセットされない。
+     *
+     * @param ms - タイムアウト時間（ミリ秒）
+     * @param onTimeout - タイムアウト時のコールバック
+     */
+    setHardTimeout(ms: number, onTimeout: TimeoutCallback): void;
+    /**
+     * 無出力タイムアウトを設定する
+     *
+     * 指定時間、stdout/stderrに出力がない場合にコールバックを呼び出す。
+     * notifyOutput()が呼ばれるとタイマーがリセットされる。
+     *
+     * @param ms - タイムアウト時間（ミリ秒）
+     * @param onTimeout - タイムアウト時のコールバック
+     */
+    setNoOutputTimeout(ms: number, onTimeout: TimeoutCallback): void;
+    /**
+     * 出力があったことを通知する
+     *
+     * 無出力タイマーをリセットする。
+     * ハードタイムアウトには影響しない。
+     */
+    notifyOutput(): void;
+    /**
+     * すべてのタイマーをクリアする
+     *
+     * プロセス終了時や、タイムアウト発生時に呼び出す。
+     */
+    clear(): void;
+    /**
+     * タイムアウトが発生したかどうかを返す
+     */
+    isTimedOut(): boolean;
+    /**
+     * 発生したタイムアウトの種類を返す
+     */
+    getTimeoutType(): TimeoutType | null;
+    /**
+     * 無出力タイマーをリセットする（内部メソッド）
+     */
+    private resetNoOutputTimer;
+}
+/**
+ * TimeboxControllerのファクトリ関数
+ *
+ * @returns 新しいTimeboxControllerインスタンス
+ */
+export declare function createTimeboxController(): ITimeboxController;
+//# sourceMappingURL=timebox-controller.d.ts.map

package/dist/executor/timebox-controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timebox-controller.d.ts","sourceRoot":"","sources":["../../src/executor/timebox-controller.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,WAAW,CAAC;AAE/C;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,IAAI,EAAE,WAAW,KAAK,IAAI,CAAC;AAE1D;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,mBAAmB;IACnB,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,eAAe,GAAG,IAAI,CAAC;IAC7D,mBAAmB;IACnB,kBAAkB,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,eAAe,GAAG,IAAI,CAAC;IACjE,gCAAgC;IAChC,YAAY,IAAI,IAAI,CAAC;IACrB,mBAAmB;IACnB,KAAK,IAAI,IAAI,CAAC;IACd,sBAAsB;IACtB,UAAU,IAAI,OAAO,CAAC;IACtB,mBAAmB;IACnB,cAAc,IAAI,WAAW,GAAG,IAAI,CAAC;CACtC;AAED;;;;;;GAMG;AACH,qBAAa,iBAAkB,YAAW,kBAAkB;IAC1D,uBAAuB;IACvB,OAAO,CAAC,aAAa,CAA8C;IAEnE,uBAAuB;IACvB,OAAO,CAAC,iBAAiB,CAA8C;IAEvE,2BAA2B;IAC3B,OAAO,CAAC,iBAAiB,CAAuB;IAEhD,8BAA8B;IAC9B,OAAO,CAAC,gBAAgB,CAAgC;IAExD,sBAAsB;IACtB,OAAO,CAAC,QAAQ,CAAS;IAEzB,oBAAoB;IACpB,OAAO,CAAC,WAAW,CAA4B;IAE/C;;;;;;;;OAQG;IACH,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,eAAe,GAAG,IAAI;IAe5D;;;;;;;;OAQG;IACH,kBAAkB,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,eAAe,GAAG,IAAI;IAShE;;;;;OAKG;IACH,YAAY,IAAI,IAAI;IAOpB;;;;OAIG;IACH,KAAK,IAAI,IAAI;IAgBb;;OAEG;IACH,UAAU,IAAI,OAAO;IAIrB;;OAEG;IACH,cAAc,IAAI,WAAW,GAAG,IAAI;IAIpC;;OAEG;IACH,OAAO,CAAC,kBAAkB;CAiB3B;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,IAAI,kBAAkB,CAE5D"}