synapse-mcp 1.0.0 → 1.0.2

package/dist/tools/handlers/scout-simple.js

@@ -0,0 +1,286 @@
+import { DEFAULT_COMMAND_TIMEOUT, DEFAULT_MAX_FILE_SIZE } from "../../constants.js";
+import { scoutSimpleUnionSchema } from "../../schemas/scout/simple.js";
+import { escapeShellArg } from "../../utils/path-security.js";
+import { createExhaustiveError, formatResponse, getHostConfigOrThrow, initializeHandler, validateInput, } from "./base-handler.js";
+/**
+ * Valid sort options for 'ps' command.
+ * SECURITY NOTE: These values are passed directly to `ps --sort -${sort}`.
+ * The Zod schema (scoutPsSchema) validates against z.enum(['cpu', 'mem', 'pid', 'time']),
+ * but we maintain this const array as defense-in-depth in case the enum is extended
+ * with values that could be interpreted differently by the shell or ps command.
+ * Any new sort options MUST be alphanumeric and safe for shell arguments.
+ */
+const VALID_PS_SORTS = ["cpu", "mem", "pid", "time"];
+/**
+ * Parse target string in format 'hostname:/path'.
+ *
+ * @param target - Target string to parse
+ * @returns Object with host and path components
+ * @throws {Error} When target format is invalid
+ */
+function parseTarget(target) {
+    const colonIndex = target.indexOf(":");
+    if (colonIndex === -1) {
+        throw new Error(`Invalid target format: ${target}. Expected hostname:/path`);
+    }
+    return {
+        host: target.slice(0, colonIndex),
+        path: target.slice(colonIndex + 1),
+    };
+}
+/**
+ * Handle all Scout simple actions for SSH file and process operations.
+ *
+ * Supports 9 actions: nodes, peek, exec, find, delta, emit, beam, ps, df.
+ * These actions operate directly without subactions.
+ *
+ * @param input - Validated Scout input with simple action
+ * @param container - Service container with SSH and file services
+ * @returns Formatted response string (markdown or JSON)
+ * @throws {Error} When host not found, target invalid, or operation fails
+ *
+ * @example
+ * ```typescript
+ * const result = await handleScoutSimpleAction(
+ *   { action: 'peek', target: 'host1:/etc/hosts' },
+ *   container
+ * );
+ * ```
+ */
+export async function handleScoutSimpleAction(input, container) {
+    // Validate at handler boundary
+    const validated = validateInput(input, scoutSimpleUnionSchema, "scout-simple");
+    const { hosts, format } = await initializeHandler(validated, container, (c) => c.getSSHService());
+    const sshService = container.getSSHService();
+    const fileService = container.getFileService();
+    // Use shared utility for host lookup
+    const findHost = (name) => getHostConfigOrThrow(hosts, name);
+    switch (validated.action) {
+        case "nodes": {
+            // List all configured SSH hosts
+            const hostList = hosts.map((h) => ({
+                name: h.name,
+                host: h.host,
+                protocol: h.protocol,
+                port: h.port,
+            }));
+            return formatResponse(hostList, format, (data) => {
+                const lines = ["## Configured Hosts", ""];
+                for (const h of data) {
+                    lines.push(`- **${h.name}**: ${h.host} (${h.protocol}:${h.port})`);
+                }
+                return lines.join("\n");
+            });
+        }
+        case "peek": {
+            const { host: hostName, path } = parseTarget(validated.target);
+            const hostConfig = findHost(hostName);
+            if (validated.tree) {
+                // Show directory tree
+                const treeOutput = await fileService.treeDirectory(hostConfig, path, validated.depth ?? 3);
+                return formatResponse({ host: hostName, path, tree: treeOutput }, format, (data) => `## Tree - ${data.host}:${data.path}\n\n\`\`\`\n${data.tree}\n\`\`\``);
+            }
+            // Try reading as file first
+            try {
+                const result = await fileService.readFile(hostConfig, path, DEFAULT_MAX_FILE_SIZE);
+                const fileData = {
+                    host: hostName,
+                    path,
+                    content: result.content,
+                    size: result.size,
+                    truncated: result.truncated,
+                };
+                return formatResponse(fileData, format, (data) => {
+                    const truncNote = data.truncated ? `\n\n*Truncated (showing ${data.size} bytes)*` : "";
+                    return `## ${data.host}:${data.path}\n\n\`\`\`\n${data.content}\n\`\`\`${truncNote}`;
+                });
+            }
+            catch (err) {
+                // If file read fails, try listing as directory
+                if (err instanceof Error && err.message.toLowerCase().includes("directory")) {
+                    const listing = await fileService.listDirectory(hostConfig, path, false);
+                    return formatResponse({ host: hostName, path, listing }, format, (data) => `## Directory - ${data.host}:${data.path}\n\n\`\`\`\n${data.listing}\n\`\`\``);
+                }
+                throw err;
+            }
+        }
+        case "exec": {
+            const { host: hostName, path } = parseTarget(validated.target);
+            const hostConfig = findHost(hostName);
+            const result = await fileService.executeCommand(hostConfig, path, validated.command, validated.timeout);
+            const execData = {
+                host: hostName,
+                path,
+                command: validated.command,
+                stdout: result.stdout,
+                exitCode: result.exitCode,
+            };
+            return formatResponse(execData, format, (data) => {
+                const exitNote = data.exitCode !== 0 ? `\n\n*Exit code: ${data.exitCode}*` : "";
+                return `## Command Output - ${data.host}:${data.path}\n\n\`\`\`\n${data.stdout}\n\`\`\`${exitNote}`;
+            });
+        }
+        case "find": {
+            const { host: hostName, path } = parseTarget(validated.target);
+            const hostConfig = findHost(hostName);
+            const results = await fileService.findFiles(hostConfig, path, validated.pattern, {
+                maxDepth: validated.depth,
+                limit: validated.limit,
+            });
+            const files = results.trim().split("\n").filter(Boolean);
+            const findData = { host: hostName, path, pattern: validated.pattern, files };
+            return formatResponse(findData, format, (data) => `## Find Results - ${data.host}:${data.path}\n\nPattern: \`${data.pattern}\`\n\n\`\`\`\n${results}\n\`\`\``);
+        }
+        case "delta": {
+            // Source is always a remote file
+            const { host: sourceHostName, path: sourcePath } = parseTarget(validated.source);
+            const sourceHost = findHost(sourceHostName);
+            if (validated.content !== undefined) {
+                // Compare file against provided content
+                const fileResult = await fileService.readFile(sourceHost, sourcePath, DEFAULT_MAX_FILE_SIZE);
+                if (fileResult.content === validated.content) {
+                    return formatResponse({ identical: true, source: validated.source }, format, () => "Files are identical");
+                }
+                return formatResponse({
+                    identical: false,
+                    source: validated.source,
+                    sourceContent: fileResult.content,
+                    providedContent: validated.content,
+                }, format, (data) => `## File Comparison\n\nFiles differ between ${data.source} and provided content`);
+            }
+            if (validated.target) {
+                // Compare two remote files
+                const { host: targetHostName, path: targetPath } = parseTarget(validated.target);
+                const targetHost = findHost(targetHostName);
+                const diff = await fileService.diffFiles(sourceHost, sourcePath, targetHost, targetPath, 3);
+                const diffData = {
+                    source: validated.source,
+                    target: validated.target,
+                    diff,
+                };
+                return formatResponse(diffData, format, (data) => {
+                    if (!data.diff || data.diff.trim() === "") {
+                        return "Files are identical";
+                    }
+                    return `## Diff\n\n\`\`\`diff\n${data.diff}\n\`\`\``;
+                });
+            }
+            throw new Error("delta requires either target or content parameter");
+        }
+        case "emit": {
+            if (!validated.command) {
+                throw new Error("emit requires a command parameter");
+            }
+            const command = validated.command;
+            const timeout = validated.timeout ?? DEFAULT_COMMAND_TIMEOUT;
+            // Execute command on all targets in parallel
+            const results = await Promise.all(validated.targets.map(async (target) => {
+                const { host: hostName, path } = parseTarget(target);
+                const hostConfig = findHost(hostName);
+                try {
+                    const result = await fileService.executeCommand(hostConfig, path, command, timeout);
+                    return {
+                        host: hostName,
+                        path,
+                        stdout: result.stdout,
+                        exitCode: result.exitCode,
+                        error: undefined,
+                    };
+                }
+                catch (err) {
+                    return {
+                        host: hostName,
+                        path,
+                        stdout: "",
+                        exitCode: -1,
+                        error: err instanceof Error ? err.message : "Unknown error",
+                    };
+                }
+            }));
+            return formatResponse(results, format, (data) => {
+                const lines = [
+                    "## Multi-Host Command Results",
+                    "",
+                    `Command: \`${validated.command}\``,
+                    "",
+                ];
+                for (const r of data) {
+                    lines.push(`### ${r.host}:${r.path}`);
+                    if (r.error) {
+                        lines.push(`\n**Error:** ${r.error}\n`);
+                    }
+                    else {
+                        lines.push(`\n\`\`\`\n${r.stdout}\n\`\`\`\n`);
+                        if (r.exitCode !== 0) {
+                            lines.push(`*Exit code: ${r.exitCode}*\n`);
+                        }
+                    }
+                }
+                return lines.join("\n");
+            });
+        }
+        case "beam": {
+            const { host: sourceHostName, path: sourcePath } = parseTarget(validated.source);
+            const { host: destHostName, path: destPath } = parseTarget(validated.destination);
+            const sourceHost = findHost(sourceHostName);
+            const destHost = findHost(destHostName);
+            const result = await fileService.transferFile(sourceHost, sourcePath, destHost, destPath);
+            const beamData = {
+                source: validated.source,
+                destination: validated.destination,
+                bytesTransferred: result.bytesTransferred,
+                warning: result.warning,
+            };
+            return formatResponse(beamData, format, (data) => {
+                const warningNote = data.warning ? `\n\n**Warning:** ${data.warning}` : "";
+                return `## File Transfer Complete\n\n- **From:** ${data.source}\n- **To:** ${data.destination}\n- **Bytes:** ${data.bytesTransferred}${warningNote}`;
+            });
+        }
+        case "ps": {
+            const hostConfig = findHost(validated.host);
+            // Build ps command with options
+            // SECURITY: Defense-in-depth validation - sort is already validated by Zod enum in scoutPsSchema,
+            // but we verify here to guard against schema changes that might introduce unsafe values.
+            const sortValue = validated.sort || "cpu";
+            if (!VALID_PS_SORTS.includes(sortValue)) {
+                throw new Error(`Invalid sort option: ${sortValue}. Must be one of: ${VALID_PS_SORTS.join(", ")}`);
+            }
+            const args = ["aux", "--sort", `-${sortValue}`];
+            let output = await sshService.executeSSHCommand(hostConfig, "ps", args);
+            // Apply filters
+            const grepFilter = validated.grep;
+            const userFilter = validated.user;
+            const lines = output.split("\n");
+            const header = lines[0] || "";
+            let filtered = lines.slice(1);
+            if (userFilter) {
+                filtered = filtered.filter((line) => line.startsWith(userFilter));
+            }
+            if (grepFilter) {
+                filtered = filtered.filter((line) => line.includes(grepFilter));
+            }
+            if (validated.limit) {
+                filtered = filtered.slice(0, validated.limit);
+            }
+            output = [header, ...filtered].join("\n");
+            return formatResponse({ host: validated.host, processes: output }, format, (data) => `## Processes - ${data.host}\n\n\`\`\`\n${data.processes}\n\`\`\``);
+        }
+        case "df": {
+            const hostConfig = findHost(validated.host);
+            const args = [];
+            if (validated.human_readable !== false) {
+                args.push("-h");
+            }
+            if (validated.path) {
+                // SECURITY: Path is already validated by safePathSchema in scoutDfSchema,
+                // but we escape it here as defense-in-depth against any schema bypass.
+                args.push(escapeShellArg(validated.path));
+            }
+            const output = await sshService.executeSSHCommand(hostConfig, "df", args);
+            return formatResponse({ host: validated.host, diskUsage: output }, format, (data) => `## Disk Usage - ${data.host}\n\n\`\`\`\n${data.diskUsage}\n\`\`\``);
+        }
+        default:
+            throw createExhaustiveError(validated, "scout action");
+    }
+}
+//# sourceMappingURL=scout-simple.js.map

package/dist/tools/handlers/scout-simple.js.map

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

package/dist/tools/handlers/scout-zfs.d.ts

@@ -0,0 +1,23 @@
+import type { ScoutInput } from "../../schemas/scout/index.js";
+import type { ServiceContainer } from "../../services/container.js";
+/**
+ * Handle all Scout ZFS subactions for ZFS filesystem operations.
+ *
+ * Supports 3 subactions: pools, datasets, snapshots.
+ * Requires specific host for ZFS operations.
+ *
+ * @param input - Validated Scout input with zfs action
+ * @param container - Service container with SSH service
+ * @returns Formatted response string (markdown or JSON)
+ * @throws {Error} When host not found or ZFS operation fails
+ *
+ * @example
+ * ```typescript
+ * const result = await handleZfsAction(
+ *   { action: 'zfs', subaction: 'pools', host: 'host1' },
+ *   container
+ * );
+ * ```
+ */
+export declare function handleZfsAction(input: ScoutInput, container: ServiceContainer): Promise<string>;
+//# sourceMappingURL=scout-zfs.d.ts.map

package/dist/tools/handlers/scout-zfs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scout-zfs.d.ts","sourceRoot":"","sources":["../../../src/tools/handlers/scout-zfs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAG/D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAUpE;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,eAAe,CACnC,KAAK,EAAE,UAAU,EACjB,SAAS,EAAE,gBAAgB,GAC1B,OAAO,CAAC,MAAM,CAAC,CA0FjB"}

package/dist/tools/handlers/scout-zfs.js

@@ -0,0 +1,82 @@
+import { scoutZfsSchema } from "../../schemas/scout/zfs.js";
+import { assertValidAction, createExhaustiveError, formatResponse, getHostConfigOrThrow, initializeHandler, validateInput, } from "./base-handler.js";
+/**
+ * Handle all Scout ZFS subactions for ZFS filesystem operations.
+ *
+ * Supports 3 subactions: pools, datasets, snapshots.
+ * Requires specific host for ZFS operations.
+ *
+ * @param input - Validated Scout input with zfs action
+ * @param container - Service container with SSH service
+ * @returns Formatted response string (markdown or JSON)
+ * @throws {Error} When host not found or ZFS operation fails
+ *
+ * @example
+ * ```typescript
+ * const result = await handleZfsAction(
+ *   { action: 'zfs', subaction: 'pools', host: 'host1' },
+ *   container
+ * );
+ * ```
+ */
+export async function handleZfsAction(input, container) {
+    assertValidAction(input, "zfs", "zfs");
+    // Validate pool/dataset inputs at the handler boundary before SSH execution.
+    const validated = validateInput(input, scoutZfsSchema, "scout-zfs");
+    const { hosts, format } = await initializeHandler(validated, container, (c) => c.getSSHService());
+    const sshService = container.getSSHService();
+    // Find the target host
+    const hostConfig = getHostConfigOrThrow(hosts, validated.host);
+    switch (validated.subaction) {
+        case "pools": {
+            const { pool } = validated;
+            // Build zpool list command
+            const args = ["list"];
+            if (pool) {
+                args.push(pool);
+            }
+            const output = await sshService.executeSSHCommand(hostConfig, "zpool", args);
+            return formatResponse({ host: validated.host, subaction: "pools", output: output.trim() }, format, (data) => `## ZFS Pools - ${data.host}\n\n\`\`\`\n${data.output}\n\`\`\``);
+        }
+        case "datasets": {
+            const { pool, type, recursive } = validated;
+            // Build zfs list command
+            const args = ["list"];
+            if (type) {
+                args.push("-t", type);
+            }
+            if (recursive || pool) {
+                args.push("-r");
+            }
+            if (pool) {
+                args.push(pool);
+            }
+            const output = await sshService.executeSSHCommand(hostConfig, "zfs", args);
+            return formatResponse({ host: validated.host, subaction: "datasets", output: output.trim() }, format, (data) => `## ZFS Datasets - ${data.host}\n\n\`\`\`\n${data.output}\n\`\`\``);
+        }
+        case "snapshots": {
+            const { pool, dataset, limit } = validated;
+            // Build zfs list command for snapshots
+            const args = ["list", "-t", "snapshot"];
+            // If dataset is specified, list recursively under that dataset
+            if (dataset) {
+                args.push("-r", dataset);
+            }
+            else if (pool) {
+                args.push("-r", pool);
+            }
+            let output = await sshService.executeSSHCommand(hostConfig, "zfs", args);
+            // Apply limit if specified
+            if (limit !== undefined) {
+                const lines = output.split("\n");
+                const header = lines[0] || "";
+                const snapshotLines = lines.slice(1, limit + 1);
+                output = [header, ...snapshotLines].join("\n");
+            }
+            return formatResponse({ host: validated.host, subaction: "snapshots", output: output.trim() }, format, (data) => `## ZFS Snapshots - ${data.host}\n\n\`\`\`\n${data.output}\n\`\`\``);
+        }
+        default:
+            throw createExhaustiveError(validated, "zfs subaction");
+    }
+}
+//# sourceMappingURL=scout-zfs.js.map

package/dist/tools/handlers/scout-zfs.js.map

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

package/dist/tools/index.d.ts

@@ -1,7 +1,37 @@
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import type { ServiceContainer } from "../services/container.js";
 /**
- * Register Flux and Scout tools with the MCP server
+ * Register all tools with the MCP server using the ToolRegistry pattern
+ *
+ * Uses the registry pattern to enable plugin-style tool additions without
+ * modifying this file. To add a new tool:
+ *
+ * 1. Create a ToolDefinition (see src/tools/registry.ts)
+ * 2. Import your tool definition here
+ * 3. Call registry.register(YourTool)
+ *
+ * @param server - MCP server instance
+ * @param container - Service container for dependency injection
+ *
+ * @example
+ * ```typescript
+ * // Add custom tool
+ * import { MyCustomTool } from "./definitions/my-custom-tool.js";
+ *
+ * export function registerTools(server: McpServer, container?: ServiceContainer) {
+ *   if (!container) {
+ *     throw new Error("ServiceContainer is required for tool registration");
+ *   }
+ *
+ *   const registry = new ToolRegistry(container);
+ *   registry.register(FluxTool);
+ *   registry.register(ScoutTool);
+ *   registry.register(MyCustomTool);  // Add your tool here
+ *   registry.registerAll(server);
+ * }
+ * ```
  */
 export declare function registerTools(server: McpServer, container?: ServiceContainer): void;
+export { FluxTool, ScoutTool } from "./definitions/index.js";
+export { type ToolDefinition, ToolRegistry } from "./registry.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAMjE;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,CAAC,EAAE,gBAAgB,GAAG,IAAI,CA4CnF"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAIjE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAcnF;AAED,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAE7D,OAAO,EAAE,KAAK,cAAc,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC"}

package/dist/tools/index.js

@@ -1,43 +1,49 @@
-import { handleFluxTool } from './flux.js';
-import { handleScoutTool } from './scout.js';
-import { FluxSchema } from '../schemas/flux/index.js';
-import { ScoutSchema } from '../schemas/scout/index.js';
+import { FluxTool, ScoutTool } from "./definitions/index.js";
+import { ToolRegistry } from "./registry.js";
 /**
- * Register Flux and Scout tools with the MCP server
+ * Register all tools with the MCP server using the ToolRegistry pattern
+ *
+ * Uses the registry pattern to enable plugin-style tool additions without
+ * modifying this file. To add a new tool:
+ *
+ * 1. Create a ToolDefinition (see src/tools/registry.ts)
+ * 2. Import your tool definition here
+ * 3. Call registry.register(YourTool)
+ *
+ * @param server - MCP server instance
+ * @param container - Service container for dependency injection
+ *
+ * @example
+ * ```typescript
+ * // Add custom tool
+ * import { MyCustomTool } from "./definitions/my-custom-tool.js";
+ *
+ * export function registerTools(server: McpServer, container?: ServiceContainer) {
+ *   if (!container) {
+ *     throw new Error("ServiceContainer is required for tool registration");
+ *   }
+ *
+ *   const registry = new ToolRegistry(container);
+ *   registry.register(FluxTool);
+ *   registry.register(ScoutTool);
+ *   registry.register(MyCustomTool);  // Add your tool here
+ *   registry.registerAll(server);
+ * }
+ * ```
  */
 export function registerTools(server, container) {
     if (!container) {
         throw new Error("ServiceContainer is required for tool registration");
     }
-    // Register Flux tool using MCP SDK 1.25.1 API
-    server.registerTool('flux', {
-        title: 'Flux Tool',
-        description: 'Docker infrastructure management - container, compose, docker, and host operations',
-        inputSchema: FluxSchema,
-        annotations: {
-            readOnlyHint: false,
-            destructiveHint: false,
-            idempotentHint: false,
-            openWorldHint: true
-        }
-    }, async (params) => {
-        const result = await handleFluxTool(params, container);
-        return { content: [{ type: 'text', text: result }] };
-    });
-    // Register Scout tool using MCP SDK 1.25.1 API
-    server.registerTool('scout', {
-        title: 'Scout Tool',
-        description: 'SSH remote operations - file, process, and system inspection',
-        inputSchema: ScoutSchema,
-        annotations: {
-            readOnlyHint: true,
-            destructiveHint: false,
-            idempotentHint: true,
-            openWorldHint: true
-        }
-    }, async (params) => {
-        const result = await handleScoutTool(params, container);
-        return { content: [{ type: 'text', text: result }] };
-    });
+    // Create registry with service container
+    const registry = new ToolRegistry(container);
+    // Register built-in tools
+    registry.register(FluxTool);
+    registry.register(ScoutTool);
+    // Register all tools with MCP server
+    registry.registerAll(server);
 }
+export { FluxTool, ScoutTool } from "./definitions/index.js";
+// Export registry and definitions for external use
+export { ToolRegistry } from "./registry.js";
 //# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAExD;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,MAAiB,EAAE,SAA4B;IAC3E,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;IACxE,CAAC;IAED,8CAA8C;IAC9C,MAAM,CAAC,YAAY,CACjB,MAAM,EACN;QACE,KAAK,EAAE,WAAW;QAClB,WAAW,EAAE,oFAAoF;QACjG,WAAW,EAAE,UAAU;QACvB,WAAW,EAAE;YACX,YAAY,EAAE,KAAK;YACnB,eAAe,EAAE,KAAK;YACtB,cAAc,EAAE,KAAK;YACrB,aAAa,EAAE,IAAI;SACpB;KACF,EACD,KAAK,EAAE,MAAe,EAAE,EAAE;QACxB,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;QACvD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;IACvD,CAAC,CACF,CAAC;IAEF,+CAA+C;IAC/C,MAAM,CAAC,YAAY,CACjB,OAAO,EACP;QACE,KAAK,EAAE,YAAY;QACnB,WAAW,EAAE,8DAA8D;QAC3E,WAAW,EAAE,WAAW;QACxB,WAAW,EAAE;YACX,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,KAAK;YACtB,cAAc,EAAE,IAAI;YACpB,aAAa,EAAE,IAAI;SACpB;KACF,EACD,KAAK,EAAE,MAAe,EAAE,EAAE;QACxB,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;QACxD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;IACvD,CAAC,CACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,UAAU,aAAa,CAAC,MAAiB,EAAE,SAA4B;IAC3E,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;IACxE,CAAC;IAED,yCAAyC;IACzC,MAAM,QAAQ,GAAG,IAAI,YAAY,CAAC,SAAS,CAAC,CAAC;IAE7C,0BAA0B;IAC1B,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAC5B,QAAQ,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;IAE7B,qCAAqC;IACrC,QAAQ,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;AAC/B,CAAC;AAED,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAC7D,mDAAmD;AACnD,OAAO,EAAuB,YAAY,EAAE,MAAM,eAAe,CAAC"}