keyboard-maestro-mcp 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Sarasvati Akari Lara
+
+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,211 @@
+# Keyboard Maestro MCP Server
+
+An MCP (Model Context Protocol) server that connects AI assistants like Claude to [Keyboard Maestro](https://www.keyboardmaestro.com/), enabling them to trigger macros and retrieve clipboard results from your Mac.
+
+## What It Does
+
+This MCP server lets AI assistants:
+- **Trigger macros** on one or multiple Macs
+- **Capture clipboard contents** (text and images) from macros
+- **Take screenshots** and analyze them
+- **Run OCR** and extract text
+- **Control multiple machines** from a single configuration
+
+When you run a macro that copies something to the clipboard (like a screenshot), the AI can retrieve and see that content directly.
+
+## Requirements
+
+- macOS with [Keyboard Maestro](https://www.keyboardmaestro.com/) 11+ installed
+- Keyboard Maestro Web Server enabled
+- Node.js 18+
+
+## Quick Start
+
+### 1. Add the MCP Server
+
+Add to your MCP client configuration:
+
+**Claude Desktop** (`~/Library/Application Support/Claude/claude_desktop_config.json`):
+```json
+{
+  "mcpServers": {
+    "keyboard-maestro": {
+      "command": "npx",
+      "args": ["-y", "keyboard-maestro-mcp"]
+    }
+  }
+}
+```
+
+**Claude Code** (`~/.claude/mcp.json`):
+```json
+{
+  "keyboard-maestro": {
+    "command": "npx",
+    "args": ["-y", "keyboard-maestro-mcp"]
+  }
+}
+```
+
+### 2. Run the Config Tool
+
+After adding the server and restarting your MCP client, ask the AI:
+
+```
+Open the Keyboard Maestro config tool
+```
+
+The config tool will guide you through:
+
+1. **Enable Web Server** - Instructions for Keyboard Maestro's Web Server settings
+2. **Add Machine(s)** - Enter connection details and test the connection
+3. **Update Config** - Automatically update your MCP config file (or copy JSON)
+4. **Install Macros** - Generate and import the required Keyboard Maestro macros
+
+## Configuration Reference
+
+### Environment Variables
+
+When machines are configured, the server uses these environment variables:
+
+| Variable | Description |
+|----------|-------------|
+| `KM_MACHINES` | JSON array of machine configurations |
+
+Or for a single machine:
+
+| Variable | Required | Default | Description |
+|----------|----------|---------|-------------|
+| `KM_HOST` | Yes | - | Hostname or IP address |
+| `KM_PORT` | No | 4490 | Web server port |
+| `KM_USERNAME` | Yes | - | Web server username |
+| `KM_PASSWORD` | Yes | - | Web server password |
+| `KM_SECURE` | No | false | Use HTTPS instead of HTTP |
+| `KM_NAME` | No | Host value | Friendly name for the machine |
+| `KM_OUTPUT_DIR` | Yes | - | Folder where clipboard files are saved |
+
+### Machine Configuration Object
+
+Each machine in `KM_MACHINES` supports:
+
+| Field | Required | Default | Description |
+|-------|----------|---------|-------------|
+| `name` | Yes | - | Friendly name for the machine |
+| `host` | Yes | - | Hostname or IP address |
+| `port` | No | 4490 | Web server HTTP port |
+| `username` | Yes | - | Web server username |
+| `password` | Yes | - | Web server password |
+| `secure` | No | false | Use HTTPS instead of HTTP |
+| `outputDir` | Yes | - | Folder where clipboard files are saved |
+
+> **Port Spacing:** Keyboard Maestro uses two consecutive ports (HTTP and HTTPS on port + 1). When configuring multiple machines, space ports by at least 2 (e.g., 4490, 4492, 4494).
+
+## Available Tools
+
+### interactive_config
+
+Visual configuration tool with interactive UI (for Claude Desktop and other MCP Apps-supporting clients). Provides:
+- Machine management (add, edit, remove, test)
+- MCP config file updates
+- Macro group generation and installation
+
+### config
+
+Text-based configuration tool (for Claude Code and other CLI clients).
+
+### list_machines
+
+List all configured Keyboard Maestro machines.
+
+### list_macros
+
+List available macros from a machine.
+
+### trigger_macro
+
+Trigger a macro by name or UUID.
+
+### trigger_macro_on_all
+
+Trigger a macro on all configured machines simultaneously.
+
+### get_clipboard_result
+
+Retrieve the current clipboard contents from a machine.
+
+### trigger_and_capture
+
+Trigger a macro and automatically capture the clipboard result.
+
+## Example Workflows
+
+### Screenshot Analysis
+
+```
+Take a screenshot of the active window and describe what you see
+```
+
+### OCR Text Extraction
+
+```
+Run OCR on my clipboard image and read the text
+```
+
+### Multi-Machine Control
+
+```
+Mute audio on all my machines
+```
+
+## Keyboard Maestro Setup
+
+The config tool will guide you, but here's a summary:
+
+### Enable Web Server
+
+1. Open **Keyboard Maestro**
+2. Go to **Keyboard Maestro → Preferences** (⌘,)
+3. Click the **Web Server** tab
+4. Check **Web Server Enabled**
+5. Set a **Username** and **Password**
+6. Note the **HTTP Port** (default: 4490)
+
+### Import Macros
+
+After generating macros with the config tool:
+
+1. Go to **File → Import → Import Macros Safely...**
+2. Select the downloaded `keyboard-maestro-mcp.kmmacros` file
+3. The "Keyboard Maestro MCP" group will appear
+
+## Security Considerations
+
+- Credentials are passed via environment variables
+- Use HTTPS (`secure: true`) when connecting over untrusted networks
+- The web server uses HTTP Basic Authentication
+- Consider firewall rules to restrict access to the web server port
+- Clipboard files are stored in your configured folder
+
+## Troubleshooting
+
+### "Connection refused" errors
+
+- Verify Keyboard Maestro's web server is enabled
+- Check the port number matches your configuration
+- Ensure no firewall is blocking the connection
+
+### Macros not appearing in list
+
+- The macro must be enabled
+- The macro group must be enabled
+- The macro must have a name
+
+### Clipboard capture returns nothing
+
+- Run the config tool to verify macros are installed
+- Check that `outputDir` points to the same folder configured in the macros
+- Ensure the folder exists and is writable
+
+## License
+
+MIT

package/dist/config-manager.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Configuration Manager for Keyboard Maestro MCP
+ * Handles machine configuration, testing, and MCP config file updates
+ */
+import { MachineConfig } from "./index.js";
+/**
+ * Known MCP config file locations
+ */
+export declare const CONFIG_PATHS: {
+    claudeDesktop: string;
+    claudeCode: string;
+};
+/**
+ * Test connection to a Keyboard Maestro machine
+ */
+export declare function testMachineConnection(config: {
+    host: string;
+    port: number;
+    username: string;
+    password: string;
+    secure?: boolean;
+}): Promise<{
+    success: boolean;
+    message: string;
+    macroCount?: number;
+    hasMacroGroup?: boolean;
+}>;
+/**
+ * Check if the Keyboard Maestro MCP macro group exists on a machine
+ */
+export declare function checkMacroGroupExists(machine: MachineConfig): Promise<{
+    exists: boolean;
+    hasClipboardMacro: boolean;
+    clipboardMacroUid?: string;
+}>;
+/**
+ * Read an MCP config file
+ */
+export declare function readMcpConfig(configPath: string): Promise<{
+    success: boolean;
+    config?: Record<string, unknown>;
+    error?: string;
+}>;
+/**
+ * Write an MCP config file
+ */
+export declare function writeMcpConfig(configPath: string, config: Record<string, unknown>): Promise<{
+    success: boolean;
+    error?: string;
+}>;
+/**
+ * Generate the MCP server configuration JSON for machines
+ */
+export declare function generateServerConfig(machines: Array<{
+    name: string;
+    host: string;
+    port: number;
+    username: string;
+    password: string;
+    secure?: boolean;
+    outputDir?: string;
+}>): Record<string, unknown>;
+/**
+ * Parse machines from KM_MACHINES environment variable or return empty array
+ */
+export declare function parseMachinesFromEnv(): MachineConfig[];
+/**
+ * Configuration state for the wizard
+ */
+export interface ConfigState {
+    mode: "setup" | "manage";
+    machines: Array<{
+        name: string;
+        host: string;
+        port: number;
+        username: string;
+        password: string;
+        secure: boolean;
+        outputDir?: string;
+        status?: "untested" | "connected" | "error";
+        errorMessage?: string;
+        hasMacroGroup?: boolean;
+    }>;
+    mcpConfigPath?: string;
+    macroStoragePath?: string;
+    needsMacroSetup: boolean;
+}
+/**
+ * Get the current configuration state
+ */
+export declare function getConfigState(): Promise<ConfigState>;
+//# sourceMappingURL=config-manager.d.ts.map

package/dist/config-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-manager.d.ts","sourceRoot":"","sources":["../src/config-manager.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,OAAO,EAAE,aAAa,EAA4B,MAAM,YAAY,CAAC;AAGrE;;GAEG;AACH,eAAO,MAAM,YAAY;;;CASxB,CAAC;AAEF;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,MAAM,EAAE;IAClD,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,GAAG,OAAO,CAAC;IACV,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB,CAAC,CAmCD;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC;IAC3E,MAAM,EAAE,OAAO,CAAC;IAChB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B,CAAC,CAwBD;AAED;;GAEG;AACH,wBAAsB,aAAa,CACjC,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAgBjF;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAY/C;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,KAAK,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC,GACD,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAmBzB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,aAAa,EAAE,CA8BtD;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,OAAO,GAAG,QAAQ,CAAC;IACzB,QAAQ,EAAE,KAAK,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,OAAO,CAAC;QAChB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,MAAM,CAAC,EAAE,UAAU,GAAG,WAAW,GAAG,OAAO,CAAC;QAC5C,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,aAAa,CAAC,EAAE,OAAO,CAAC;KACzB,CAAC,CAAC;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED;;GAEG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,WAAW,CAAC,CA2C3D"}

package/dist/config-manager.js

@@ -0,0 +1,209 @@
+/**
+ * Configuration Manager for Keyboard Maestro MCP
+ * Handles machine configuration, testing, and MCP config file updates
+ */
+import { readFile, writeFile, access } from "fs/promises";
+import { constants } from "fs";
+import { homedir } from "os";
+import { join } from "path";
+import { listMacros } from "./index.js";
+import { SAVE_CLIPBOARD_MACRO_UID, expandPath } from "./macros-template.js";
+/**
+ * Known MCP config file locations
+ */
+export const CONFIG_PATHS = {
+    claudeDesktop: join(homedir(), "Library", "Application Support", "Claude", "claude_desktop_config.json"),
+    claudeCode: join(homedir(), ".claude", "mcp.json"),
+};
+/**
+ * Test connection to a Keyboard Maestro machine
+ */
+export async function testMachineConnection(config) {
+    const machine = {
+        name: "test",
+        host: config.host,
+        port: config.port,
+        username: config.username,
+        password: config.password,
+        secure: config.secure ?? false,
+    };
+    try {
+        const result = await listMacros(machine);
+        if (result.success) {
+            // Check if the MCP macro group exists
+            const macroGroupCheck = await checkMacroGroupExists(machine);
+            return {
+                success: true,
+                message: `Connected successfully! Found ${result.macros?.length || 0} macros.`,
+                macroCount: result.macros?.length || 0,
+                hasMacroGroup: macroGroupCheck.exists && macroGroupCheck.hasClipboardMacro,
+            };
+        }
+        else {
+            return {
+                success: false,
+                message: result.message || "Connection failed",
+            };
+        }
+    }
+    catch (error) {
+        return {
+            success: false,
+            message: error instanceof Error ? error.message : "Unknown error",
+        };
+    }
+}
+/**
+ * Check if the Keyboard Maestro MCP macro group exists on a machine
+ */
+export async function checkMacroGroupExists(machine) {
+    try {
+        const result = await listMacros(machine);
+        if (!result.success || !result.macros) {
+            return { exists: false, hasClipboardMacro: false };
+        }
+        const mcpMacros = result.macros.filter((m) => m.group === "Keyboard Maestro MCP");
+        const clipboardMacro = mcpMacros.find((m) => m.name === "Save Clipboard to File");
+        return {
+            exists: mcpMacros.length > 0,
+            hasClipboardMacro: !!clipboardMacro,
+            clipboardMacroUid: clipboardMacro?.uid,
+        };
+    }
+    catch {
+        return { exists: false, hasClipboardMacro: false };
+    }
+}
+/**
+ * Read an MCP config file
+ */
+export async function readMcpConfig(configPath) {
+    try {
+        const expanded = expandPath(configPath);
+        await access(expanded, constants.R_OK);
+        const content = await readFile(expanded, "utf-8");
+        const config = JSON.parse(content);
+        return { success: true, config };
+    }
+    catch (error) {
+        if (error.code === "ENOENT") {
+            return { success: true, config: {} }; // File doesn't exist, start fresh
+        }
+        return {
+            success: false,
+            error: error instanceof Error ? error.message : "Failed to read config",
+        };
+    }
+}
+/**
+ * Write an MCP config file
+ */
+export async function writeMcpConfig(configPath, config) {
+    try {
+        const expanded = expandPath(configPath);
+        const content = JSON.stringify(config, null, 2);
+        await writeFile(expanded, content, "utf-8");
+        return { success: true };
+    }
+    catch (error) {
+        return {
+            success: false,
+            error: error instanceof Error ? error.message : "Failed to write config",
+        };
+    }
+}
+/**
+ * Generate the MCP server configuration JSON for machines
+ */
+export function generateServerConfig(machines) {
+    const machinesJson = machines.map((m) => ({
+        name: m.name,
+        host: m.host,
+        port: m.port,
+        username: m.username,
+        password: m.password,
+        secure: m.secure ?? false,
+        outputDir: m.outputDir,
+        saveClipboardMacroUid: SAVE_CLIPBOARD_MACRO_UID,
+    }));
+    return {
+        command: "npx",
+        args: ["-y", "keyboard-maestro-mcp"],
+        env: {
+            KM_MACHINES: JSON.stringify(machinesJson),
+        },
+    };
+}
+/**
+ * Parse machines from KM_MACHINES environment variable or return empty array
+ */
+export function parseMachinesFromEnv() {
+    const machinesEnv = process.env.KM_MACHINES;
+    if (!machinesEnv) {
+        // Check for single machine config
+        const host = process.env.KM_HOST;
+        const username = process.env.KM_USERNAME;
+        const password = process.env.KM_PASSWORD;
+        if (host && username && password) {
+            return [{
+                    name: process.env.KM_NAME || host,
+                    host,
+                    port: parseInt(process.env.KM_PORT || "4490", 10),
+                    username,
+                    password,
+                    secure: process.env.KM_SECURE === "true",
+                    outputDir: process.env.KM_OUTPUT_DIR,
+                    saveClipboardMacroUid: process.env.KM_SAVE_CLIPBOARD_MACRO_UID || SAVE_CLIPBOARD_MACRO_UID,
+                }];
+        }
+        return [];
+    }
+    try {
+        const parsed = JSON.parse(machinesEnv);
+        if (!Array.isArray(parsed))
+            return [];
+        return parsed;
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Get the current configuration state
+ */
+export async function getConfigState() {
+    const machines = parseMachinesFromEnv();
+    if (machines.length === 0) {
+        return {
+            mode: "setup",
+            machines: [],
+            needsMacroSetup: true,
+        };
+    }
+    // Check each machine's status and macro group
+    const machinesWithStatus = await Promise.all(machines.map(async (m) => {
+        const testResult = await testMachineConnection(m);
+        const macroCheck = testResult.success
+            ? await checkMacroGroupExists(m)
+            : { exists: false, hasClipboardMacro: false };
+        return {
+            name: m.name,
+            host: m.host,
+            port: m.port,
+            username: m.username,
+            password: m.password,
+            secure: m.secure ?? false,
+            outputDir: m.outputDir,
+            status: testResult.success ? "connected" : "error",
+            errorMessage: testResult.success ? undefined : testResult.message,
+            hasMacroGroup: macroCheck.hasClipboardMacro,
+        };
+    }));
+    const anyMissingMacros = machinesWithStatus.some((m) => m.status === "connected" && !m.hasMacroGroup);
+    return {
+        mode: "manage",
+        machines: machinesWithStatus,
+        needsMacroSetup: anyMissingMacros,
+    };
+}
+//# sourceMappingURL=config-manager.js.map

package/dist/config-manager.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,43 @@
+#!/usr/bin/env node
+export interface MachineConfig {
+    name: string;
+    host: string;
+    port: number;
+    username: string;
+    password: string;
+    secure?: boolean;
+    outputDir?: string;
+    saveClipboardMacroUid?: string;
+}
+export declare function getMachines(): MachineConfig[];
+export declare function getBaseUrl(machine: MachineConfig): string;
+export declare function getAuthHeader(machine: MachineConfig): string;
+export declare function findMachine(machines: MachineConfig[], name?: string): MachineConfig | undefined;
+export declare function decodeHtmlEntities(text: string): string;
+export declare function listMacros(machine: MachineConfig): Promise<{
+    success: boolean;
+    macros?: {
+        name: string;
+        uid?: string;
+        group?: string;
+    }[];
+    message?: string;
+}>;
+export declare function triggerMacro(machine: MachineConfig, macro: string, value?: string): Promise<{
+    success: boolean;
+    message: string;
+    result?: string;
+}>;
+export declare function fetchUrl(machine: MachineConfig, path: string): Promise<{
+    status: number;
+    headers: Record<string, string>;
+    body: string;
+}>;
+export declare function getClipboardResult(machine: MachineConfig): Promise<{
+    success: boolean;
+    message: string;
+    type?: "text" | "image";
+    content?: string;
+    filePath?: string;
+}>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAyCA,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC;AAGD,wBAAgB,WAAW,IAAI,aAAa,EAAE,CAgD7C;AAGD,wBAAgB,UAAU,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,CAIzD;AAGD,wBAAgB,aAAa,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,CAK5D;AAGD,wBAAgB,WAAW,CACzB,QAAQ,EAAE,aAAa,EAAE,EACzB,IAAI,CAAC,EAAE,MAAM,GACZ,aAAa,GAAG,SAAS,CAK3B;AAGD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CASvD;AAGD,wBAAsB,UAAU,CAC9B,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAwE5G;AAGD,wBAAsB,YAAY,CAChC,OAAO,EAAE,aAAa,EACtB,KAAK,EAAE,MAAM,EACb,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAiDjE;AAGD,wBAAsB,QAAQ,CAC5B,OAAO,EAAE,aAAa,EACtB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAqB5E;AAmBD,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC;IACT,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC,CAoFD"}