@gaunt-sloth/agent 0.1.8 → 2.0.0-alpha.1

package/dist/resolvers.js

@@ -0,0 +1,140 @@
+/**
+ * @packageDocumentation
+ * Resolver implementations for the AgentResolvers pattern.
+ *
+ * Provides `resolveTools` / `cleanupTools` that wire up built-in tools
+ * (filesystem, dev, custom), MCP servers, and A2A agents.
+ *
+ * Provides `resolveMiddleware` / `cleanupMiddleware` that delegate to the
+ * agent middleware registry.
+ */
+import { debugLog } from '@gaunt-sloth/core/utils/debugUtils.js';
+import { displayInfo } from '@gaunt-sloth/core/utils/consoleUtils.js';
+import { createA2AAgentTool } from '#src/tools/A2AAgentTool.js';
+import { prepareMcpTools } from '#src/utils/mcpUtils.js';
+import { createAuthProviderAndAuthenticate } from '#src/mcp/OAuthClientProviderImpl.js';
+import { MultiServerMCPClient } from '@langchain/mcp-adapters';
+/**
+ * Create a full set of resolvers for the GthLangChainAgent.
+ *
+ * Each call returns a fresh set of resolvers with their own MCP client
+ * instance, avoiding shared module-level state and race conditions.
+ */
+export function createResolvers() {
+    let mcpClientInstance = null;
+    const resolveTools = async (config, command) => {
+        const tools = [];
+        // 1. Get built-in tools (filesystem, devTools, customTools, etc.)
+        try {
+            const { getDefaultTools } = await import('#src/builtInToolsConfig.js');
+            const defaultTools = await getDefaultTools(config, command);
+            debugLog(`Default tools loaded: ${defaultTools.length}`);
+            tools.push(...defaultTools);
+        }
+        catch (error) {
+            debugLog(`Built-in tools not available: ${error}`);
+        }
+        // 2. Get MCP tools
+        try {
+            mcpClientInstance = await getMcpClient(config);
+            if (mcpClientInstance) {
+                const rawMcpTools = await mcpClientInstance.getTools();
+                // Use a simple status callback for prepareMcpTools
+                const statusCallback = (level, message) => {
+                    displayInfo(message);
+                };
+                const mcpTools = prepareMcpTools(statusCallback, config, rawMcpTools) ?? [];
+                debugLog(`MCP tools loaded: ${mcpTools.length}`);
+                tools.push(...mcpTools);
+            }
+        }
+        catch (error) {
+            debugLog(`MCP tools error: ${error}`);
+        }
+        // 3. Get A2A tools
+        const a2aTools = getA2ATools(config);
+        debugLog(`A2A tools loaded: ${a2aTools.length}`);
+        tools.push(...a2aTools);
+        return tools;
+    };
+    const cleanupTools = async () => {
+        if (mcpClientInstance) {
+            try {
+                await mcpClientInstance.close();
+            }
+            catch {
+                // Ignore cleanup errors
+            }
+            mcpClientInstance = null;
+        }
+    };
+    const resolveMiddleware = async (
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    middleware, config
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    ) => {
+        try {
+            const { resolveMiddleware: resolve } = await import('#src/middleware/registry.js');
+            return await resolve(middleware, config);
+        }
+        catch (error) {
+            debugLog(`Middleware resolution error: ${error}`);
+            return [];
+        }
+    };
+    const cleanupMiddleware = async () => {
+        // No cleanup needed for middleware currently
+    };
+    return {
+        resolveTools,
+        cleanupTools,
+        resolveMiddleware,
+        cleanupMiddleware,
+    };
+}
+// --- Private helpers ---
+async function getMcpClient(config) {
+    debugLog('Setting up MCP client...');
+    const rawMcpServers = { ...(config.mcpServers || {}) };
+    debugLog(`MCP servers count: ${Object.keys(rawMcpServers).length}`);
+    const mcpServers = {};
+    for (const serverName of Object.keys(rawMcpServers)) {
+        const server = rawMcpServers[serverName];
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        if (server.url && server && server.authProvider === 'OAuth') {
+            displayInfo(`Starting OAuth for ${server.url}`);
+            const authProvider = await createAuthProviderAndAuthenticate(server);
+            mcpServers[serverName] = {
+                ...server,
+                authProvider,
+            };
+        }
+        else {
+            mcpServers[serverName] = server;
+        }
+    }
+    if (Object.keys(mcpServers).length > 0) {
+        debugLog('Creating MultiServerMCPClient...');
+        return new MultiServerMCPClient({
+            throwOnLoadError: true,
+            prefixToolNameWithServerName: true,
+            additionalToolNamePrefix: 'mcp',
+            mcpServers: mcpServers,
+        });
+    }
+    else {
+        debugLog('No MCP servers configured');
+        return null;
+    }
+}
+function getA2ATools(config) {
+    debugLog('Setting up A2A tools...');
+    const a2aAgents = (config.a2aAgents || {});
+    const tools = [];
+    for (const [agentId, agentConfig] of Object.entries(a2aAgents)) {
+        debugLog(`Adding A2A agent tool: ${agentId}`);
+        tools.push(createA2AAgentTool(agentConfig));
+    }
+    return tools;
+}
+//# sourceMappingURL=resolvers.js.map

package/dist/resolvers.js.map

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

package/dist/tools/A2AAgentTool.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @module A2AAgentTool
+ * LangChain tool for interacting with A2A protocol agents.
+ * @experimental A2A support is experimental and may change.
+ */
+import { DynamicStructuredTool } from '@langchain/core/tools';
+import { z } from 'zod';
+/**
+ * Creates a LangChain tool for communicating with an A2A agent.
+ * The tool will be named `a2a_agent_<agentId>`.
+ * @param config - A2A agent configuration
+ * @returns A DynamicStructuredTool for the agent
+ * @experimental
+ */
+export declare const createA2AAgentTool: (config: {
+    agentId: string;
+    agentUrl: string;
+}) => DynamicStructuredTool<z.ZodObject<{
+    message: z.ZodString;
+}, z.core.$strip>, {
+    message: string;
+}, {
+    message: string;
+}, string, unknown, `a2a_agent_${string}`>;

package/dist/tools/A2AAgentTool.js

@@ -0,0 +1,37 @@
+/**
+ * @module A2AAgentTool
+ * LangChain tool for interacting with A2A protocol agents.
+ * @experimental A2A support is experimental and may change.
+ */
+import { DynamicStructuredTool } from '@langchain/core/tools';
+import { z } from 'zod';
+import { A2AClientWrapper } from '#src/modules/a2a/A2AClientWrapper.js';
+import { debugLog } from '@gaunt-sloth/core/utils/debugUtils.js';
+/**
+ * Creates a LangChain tool for communicating with an A2A agent.
+ * The tool will be named `a2a_agent_<agentId>`.
+ * @param config - A2A agent configuration
+ * @returns A DynamicStructuredTool for the agent
+ * @experimental
+ */
+export const createA2AAgentTool = (config) => {
+    const client = new A2AClientWrapper(config);
+    return new DynamicStructuredTool({
+        name: `a2a_agent_${config.agentId}`,
+        description: `Interact with the external A2A agent '${config.agentId}'. Use this tool to delegate tasks or ask questions to the external agent.`,
+        schema: z.object({
+            message: z.string().describe('The message or task description to send to the agent.'),
+        }),
+        func: async ({ message }) => {
+            debugLog(`Tool a2a_agent_${config.agentId} called with message: ${message}`);
+            try {
+                const response = await client.sendMessage(message);
+                return response;
+            }
+            catch (error) {
+                return `Error communicating with agent: ${error.message}`;
+            }
+        },
+    });
+};
+//# sourceMappingURL=A2AAgentTool.js.map

package/dist/tools/A2AAgentTool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"A2AAgentTool.js","sourceRoot":"","sources":["../../src/tools/A2AAgentTool.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AACxE,OAAO,EAAE,QAAQ,EAAE,MAAM,uCAAuC,CAAC;AAEjE;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,MAA6C,EAAE,EAAE;IAClF,MAAM,MAAM,GAAG,IAAI,gBAAgB,CAAC,MAAM,CAAC,CAAC;IAE5C,OAAO,IAAI,qBAAqB,CAAC;QAC/B,IAAI,EAAE,aAAa,MAAM,CAAC,OAAO,EAAE;QACnC,WAAW,EAAE,yCAAyC,MAAM,CAAC,OAAO,4EAA4E;QAChJ,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;YACf,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,uDAAuD,CAAC;SACtF,CAAC;QACF,IAAI,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE;YAC1B,QAAQ,CAAC,kBAAkB,MAAM,CAAC,OAAO,yBAAyB,OAAO,EAAE,CAAC,CAAC;YAC7E,IAAI,CAAC;gBACH,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;gBACnD,OAAO,QAAQ,CAAC;YAClB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,mCAAoC,KAAe,CAAC,OAAO,EAAE,CAAC;YACvE,CAAC;QACH,CAAC;KACF,CAAC,CAAC;AACL,CAAC,CAAC"}

package/dist/tools/GthCustomToolkit.d.ts

@@ -0,0 +1,41 @@
+/**
+ * @module GthCustomToolkit
+ * Toolkit for user-defined custom shell commands.
+ * Provides secure execution of shell commands with parameter validation.
+ */
+import { BaseToolkit, StructuredToolInterface } from '@langchain/core/tools';
+import { CustomToolsConfig, CustomCommandParameter, ValidationCheck } from '@gaunt-sloth/core/config.js';
+export default class GthCustomToolkit extends BaseToolkit {
+    tools: StructuredToolInterface[];
+    private customTools;
+    constructor(customTools?: CustomToolsConfig);
+    /**
+     * Validate parameter value to prevent security issues.
+     * Checks can be selectively skipped via the `allow` list.
+     */
+    validateParameterValue(paramValue: string, paramName: string, allow?: ValidationCheck[]): string;
+    /**
+     * Build a custom command with parameter interpolation
+     */
+    buildCustomCommand(commandTemplate: string, parameters: Record<string, string>, parameterConfig?: Record<string, CustomCommandParameter>): string;
+    /**
+     * Prompt the user to confirm execution of a command that failed validation.
+     * Returns true if the user confirms, false otherwise.
+     */
+    promptUserForValidationOverride(command: string, toolName: string, validationError: string): Promise<boolean>;
+    private executeCommand;
+    /**
+     * Create a Zod schema for a custom command's parameters
+     */
+    private createCustomCommandSchema;
+    /**
+     * Build command without validation (for display in the user prompt).
+     * Simply interpolates parameters into the template without security checks.
+     */
+    private buildCommandForDisplay;
+    /**
+     * Create a tool for a custom command
+     */
+    private createCustomCommandTool;
+    private createTools;
+}

package/dist/tools/GthCustomToolkit.js

@@ -0,0 +1,289 @@
+/**
+ * @module GthCustomToolkit
+ * Toolkit for user-defined custom shell commands.
+ * Provides secure execution of shell commands with parameter validation.
+ */
+import { BaseToolkit, tool } from '@langchain/core/tools';
+import { z } from 'zod';
+import { spawn } from 'child_process';
+import path from 'node:path';
+import { displayInfo, displayError, displayWarning } from '@gaunt-sloth/core/utils/consoleUtils.js';
+import { createInterface, stdin, stdout } from '@gaunt-sloth/core/utils/systemUtils.js';
+// Helper function to create a tool with execute type
+function createCustomTool(fn, config) {
+    const toolInstance = tool(fn, config);
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    toolInstance.gthCustomType = 'execute';
+    return toolInstance;
+}
+export default class GthCustomToolkit extends BaseToolkit {
+    tools;
+    customTools;
+    constructor(customTools = {}) {
+        super();
+        this.customTools = customTools;
+        this.tools = this.createTools();
+    }
+    /**
+     * Validate parameter value to prevent security issues.
+     * Checks can be selectively skipped via the `allow` list.
+     */
+    validateParameterValue(paramValue, paramName, allow = []) {
+        const allowSet = new Set(allow);
+        // Check for absolute paths
+        if (!allowSet.has('absolute-paths') && path.isAbsolute(paramValue)) {
+            throw new Error(`Absolute paths are not allowed for parameter '${paramName}'`);
+        }
+        // Check for directory traversal attempts
+        if (!allowSet.has('directory-traversal') &&
+            (paramValue.includes('..') || paramValue.includes('\\..\\') || paramValue.includes('/../'))) {
+            throw new Error(`Directory traversal attempts are not allowed in parameter '${paramName}'`);
+        }
+        // Check for pipe attempts and other shell injection
+        if (!allowSet.has('shell-injection') &&
+            (paramValue.includes('|') ||
+                paramValue.includes('&') ||
+                paramValue.includes(';') ||
+                paramValue.includes('`') ||
+                paramValue.includes("'") ||
+                paramValue.includes('$') ||
+                paramValue.includes('$(') ||
+                paramValue.includes('\n') ||
+                paramValue.includes('\r'))) {
+            throw new Error(`Shell injection attempts are not allowed in parameter '${paramName}'.` +
+                'Disallowed symbols pipe, ampersand, semicolon, backtick, single quote, dollar sign, command substitution, newline, carriage return');
+        }
+        // Check for null bytes
+        if (!allowSet.has('null-bytes') && paramValue.includes('\0')) {
+            throw new Error(`Null bytes are not allowed in parameter '${paramName}'`);
+        }
+        // Normalize the path to remove any redundant separators
+        // Skip normalization when absolute paths are allowed, since normalize
+        // would strip the leading separator context on some values
+        if (allowSet.has('absolute-paths')) {
+            // Still do the post-normalization traversal check when traversal is not allowed
+            if (!allowSet.has('directory-traversal')) {
+                const normalizedValue = path.normalize(paramValue);
+                if (normalizedValue.includes('..')) {
+                    throw new Error(`Directory traversal attempts are not allowed in parameter '${paramName}'`);
+                }
+            }
+            return paramValue;
+        }
+        const normalizedValue = path.normalize(paramValue);
+        // Double-check after normalization
+        if (!allowSet.has('directory-traversal') && normalizedValue.includes('..')) {
+            throw new Error(`Directory traversal attempts are not allowed in parameter '${paramName}'`);
+        }
+        return normalizedValue;
+    }
+    /**
+     * Build a custom command with parameter interpolation
+     */
+    buildCustomCommand(commandTemplate, parameters, parameterConfig) {
+        let command = commandTemplate;
+        const paramNames = Object.keys(parameters);
+        // Check if all provided parameters have placeholders or should be appended
+        const hasPlaceholders = paramNames.some((name) => command.includes(`\${${name}}`));
+        if (hasPlaceholders) {
+            // Replace all placeholders with validated parameter values
+            for (const [name, value] of Object.entries(parameters)) {
+                const allow = parameterConfig?.[name]?.allow || [];
+                const validatedValue = this.validateParameterValue(value, name, allow);
+                const placeholder = '${' + name + '}';
+                command = command.replace(new RegExp(placeholder.replace(/[.*+?^${}()|[\]\\]/g, '\\$&'), 'g'), validatedValue);
+            }
+        }
+        else if (paramNames.length > 0 && parameterConfig) {
+            // Append parameters in the order defined in the config
+            const orderedParams = Object.keys(parameterConfig);
+            const appendValues = [];
+            for (const name of orderedParams) {
+                if (parameters[name] !== undefined) {
+                    const allow = parameterConfig[name]?.allow || [];
+                    const validatedValue = this.validateParameterValue(parameters[name], name, allow);
+                    appendValues.push(validatedValue);
+                }
+            }
+            if (appendValues.length > 0) {
+                command = `${command} ${appendValues.join(' ')}`;
+            }
+        }
+        return command;
+    }
+    /**
+     * Prompt the user to confirm execution of a command that failed validation.
+     * Returns true if the user confirms, false otherwise.
+     */
+    async promptUserForValidationOverride(command, toolName, validationError) {
+        displayWarning(`\n⚠️  Validation failed for tool '${toolName}': ${validationError}`);
+        displayWarning(`The agent is trying to execute: ${command}`);
+        displayWarning('You can add "allow" to this tool\'s configuration in .gsloth.config.json to skip this check (permanent). ' +
+            'Available values: "absolute-paths", "directory-traversal", "shell-injection", "null-bytes"');
+        // The agent stream may have stdin in raw mode for Escape/Q interruption.
+        // Readline needs canonical line mode for y/N to be delivered after Enter.
+        const shouldRestoreRawMode = stdin.isTTY && stdin.isRaw;
+        if (shouldRestoreRawMode) {
+            stdin.setRawMode(false);
+        }
+        // Write prompt manually to avoid double-echo when readline echoes input
+        stdout.write('Do you want to allow this execution (one-time)? (y/N): ');
+        const rl = createInterface({ input: stdin });
+        try {
+            const answer = await rl.question('');
+            return answer.trim().toLowerCase() === 'y' || answer.trim().toLowerCase() === 'yes';
+        }
+        finally {
+            rl.close();
+            if (shouldRestoreRawMode) {
+                stdin.setRawMode(true);
+            }
+        }
+    }
+    async executeCommand(command, toolName, timeoutSeconds) {
+        displayInfo(`\n🔧 Executing ${toolName}: ${command}`);
+        return new Promise((resolve, reject) => {
+            const child = spawn(command, {
+                shell: true,
+            });
+            let output = '';
+            let timedOut = false;
+            let timer;
+            if (timeoutSeconds !== undefined && timeoutSeconds > 0) {
+                timer = setTimeout(() => {
+                    timedOut = true;
+                    child.kill();
+                }, timeoutSeconds * 1000);
+            }
+            // Capture output if available (when stdio is not 'inherit')
+            if (child.stdout) {
+                child.stdout.on('data', (data) => {
+                    const chunk = data.toString();
+                    stdout.write(chunk);
+                    output += chunk;
+                });
+            }
+            if (child.stderr) {
+                child.stderr.on('data', (data) => {
+                    const chunk = data.toString();
+                    stdout.write(chunk);
+                    output += chunk;
+                });
+            }
+            child.on('close', (code) => {
+                if (timer)
+                    clearTimeout(timer);
+                if (timedOut) {
+                    resolve(`Executing '${command}'...\n\n` +
+                        `<COMMAND_OUTPUT>\n` +
+                        output +
+                        `</COMMAND_OUTPUT>\n` +
+                        `\n\nCommand '${command}' timed out after ${timeoutSeconds} seconds`);
+                }
+                else if (code === 0) {
+                    resolve(`Executing '${command}'...\n\n` +
+                        `<COMMAND_OUTPUT>\n` +
+                        output +
+                        `</COMMAND_OUTPUT>\n` +
+                        `\n\nCommand '${command}' completed successfully`);
+                }
+                else {
+                    resolve(`Executing '${command}'...\n\n` +
+                        `<COMMAND_OUTPUT>\n` +
+                        output +
+                        `</COMMAND_OUTPUT>\n` +
+                        `\n\nCommand '${command}' exited with code ${code}`);
+                }
+            });
+            child.on('error', (error) => {
+                if (timer)
+                    clearTimeout(timer);
+                const errorMsg = `Failed to execute command '${command}': ${error.message}`;
+                displayError(errorMsg);
+                reject(new Error(errorMsg));
+            });
+        });
+    }
+    /**
+     * Create a Zod schema for a custom command's parameters
+     */
+    createCustomCommandSchema(config
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    ) {
+        if (!config.parameters || Object.keys(config.parameters).length === 0) {
+            return z.object({});
+        }
+        const shape = {};
+        for (const [paramName, paramConfig] of Object.entries(config.parameters)) {
+            shape[paramName] = z.string().describe(paramConfig.description);
+        }
+        return z.object(shape);
+    }
+    /**
+     * Build command without validation (for display in the user prompt).
+     * Simply interpolates parameters into the template without security checks.
+     */
+    buildCommandForDisplay(commandTemplate, parameters, parameterConfig) {
+        let command = commandTemplate;
+        const paramNames = Object.keys(parameters);
+        const hasPlaceholders = paramNames.some((name) => command.includes(`\${${name}}`));
+        if (hasPlaceholders) {
+            for (const [name, value] of Object.entries(parameters)) {
+                const placeholder = '${' + name + '}';
+                command = command.replace(new RegExp(placeholder.replace(/[.*+?^${}()|[\]\\]/g, '\\$&'), 'g'), value);
+            }
+        }
+        else if (paramNames.length > 0 && parameterConfig) {
+            const orderedParams = Object.keys(parameterConfig);
+            const appendValues = [];
+            for (const name of orderedParams) {
+                if (parameters[name] !== undefined) {
+                    appendValues.push(parameters[name]);
+                }
+            }
+            if (appendValues.length > 0) {
+                command = `${command} ${appendValues.join(' ')}`;
+            }
+        }
+        return command;
+    }
+    /**
+     * Create a tool for a custom command
+     */
+    createCustomCommandTool(name, config) {
+        const schema = this.createCustomCommandSchema(config);
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const toolFn = async (args) => {
+            // All parameters are strings, safe to cast
+            const stringArgs = args;
+            try {
+                const command = this.buildCustomCommand(config.command, stringArgs, config.parameters);
+                return await this.executeCommand(command, name, config.timeout);
+            }
+            catch (validationError) {
+                // If validation fails, prompt the user for confirmation
+                const errorMessage = validationError instanceof Error ? validationError.message : String(validationError);
+                const displayCommand = this.buildCommandForDisplay(config.command, stringArgs, config.parameters);
+                const userConfirmed = await this.promptUserForValidationOverride(displayCommand, name, errorMessage);
+                if (userConfirmed) {
+                    return await this.executeCommand(displayCommand, name);
+                }
+                throw new Error(`Execution of '${name}' was rejected by user. Validation error: ${errorMessage}`);
+            }
+        };
+        return createCustomTool(toolFn, {
+            name,
+            description: config.description + `\nThe configured command is [${config.command}].`,
+            schema,
+        });
+    }
+    createTools() {
+        const tools = [];
+        // Create tools for custom commands
+        for (const [name, config] of Object.entries(this.customTools)) {
+            tools.push(this.createCustomCommandTool(name, config));
+        }
+        return tools;
+    }
+}
+//# sourceMappingURL=GthCustomToolkit.js.map

package/dist/tools/GthCustomToolkit.js.map

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

package/dist/tools/GthDevToolkit.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @module GthDevToolkit
+ */
+import { BaseToolkit, StructuredToolInterface } from '@langchain/core/tools';
+import { GthDevToolsConfig } from '@gaunt-sloth/core/config.js';
+export default class GthDevToolkit extends BaseToolkit {
+    tools: StructuredToolInterface[];
+    private commands;
+    constructor(commands?: GthDevToolsConfig);
+    /**
+     * Get tools filtered by operation type
+     */
+    getFilteredTools(allowedOperations: 'execute'[]): StructuredToolInterface[];
+    /**
+     * Validate parameter value to prevent security issues
+     */
+    validateParameterValue(paramValue: string, paramName: string): string;
+    /**
+     * Build the command for running a single test file
+     */
+    private buildSingleTestCommand;
+    private executeCommand;
+    private createTools;
+}