shellCall.js

// ===================================================================
// Handler Function: shellCall
// Shell command wrapper for executing system commands
// Uses configurable shell and parameters array
// ===================================================================

// Import shared functions
const shared = require('sharedFunctions');

function taskLog(message) {
    console.log(message);
    stdOut.push(message);
}

/**
 * Execute a shell command with optional parameters
 * @param {Object} params - Command parameters
 * @param {string} params.command - Shell command to execute (required)
 * @param {Array<string>} [params.parameters=[]] - Array of command parameters (optional)
 * @param {string} [params.shell="/bin/bash"] - Shell interpreter path (/bin/sh or /bin/bash) (optional, default /bin/bash)
 */

function shellCall(params) {
    var command = params.command || "";
    var parameters = params.parameters || [];
    var shell = params.shell || "/bin/bash";
    var shellValidation;
    
    taskLog("=== Shell Call Task ===");
    taskLog("Command: " + command);
    taskLog("Parameters: " + JSON.stringify(parameters));
    taskLog("Shell: " + shell);

    // Validate input parameters
    if (!command) {
        return shared.setErrorResult("Missing required parameter: command", {
            operation: "shellCall"
        });
    }
    
    if (shell.length === 0) {
        shell = "/bin/bash";
    }

    shellValidation = shared.validateFilePath(shell, "shell", { absolute: true });
    if (!shellValidation.ok) {
        return shared.setErrorResult(shellValidation.message, {
            operation: "shellCall"
        });
    }

    shell = shellValidation.value;

    var isCustomShell = false;
    
    // Build shell script based on function parameters
    // Parameter 3 : string : shell (/bin/sh /bin/bash)
    //  -> Optional -> default /bin/bash This is used at #! first line
    
    // Check if shell parameter differs from default - treat as custom shell
    var shellScript = "#!/usr/bin/env bash\n";
    if (shell === "/bin/bash") {
        shellScript += "#!/bin/bash -e\n";
        isCustomShell = true;
    } 
    
    // Build command with parameters based on function parameters
    shellScript += 'set -euo pipefail\n';
    shellScript += "cd \"$(dirname \"$0\")\" || exit 1\n";

    if (parameters && parameters.length > 0) {
        taskLog("[Script] Building command with parameters...");
        
        var paramString = "";
        for (var i = 0; i < parameters.length; i++) {
            var arg = parameters[i];
            if (arg != null) {
                var argStr = String(arg);
                // cleanup JSON escapings
                var escapedArg = argStr
                    .replace(/"/g, '\\"')
                    .replace(/\$/g, '\\$')
                    .replace(/`/g, '\\`');
                paramString += " \"" + escapedArg + "\"";
            } else {
                paramString += " \"\"";
            }
        }
        shellScript += command + paramString + '\n';
    } else {
        // Single command without additional parameters
        shellScript += command + '\n';
    }

    taskLog("[Script] Run: " + shellScript);
    
    var success = MCPStudio.shell(shellScript);

    if (success) {
        MCPStudio.setToolResult(JSON.stringify({
            text: "[Script] Command executed successfully\n" + 
               (stdOut && stdOut.length > 0 ? stdOut.join("\n") : "") +  
               (stdErr && stdErr.length > 0 ? "\nErrors and Warnings:\n" + stdErr.join("\n") : ""),
            metadata: {
                path: ".",
                command: command,
                shell: shell,
                parameters: parameters,
                operation: "shellCall",
                success: true,
                stdout: stdOut,
                stderr: stdErr,
            }
        }));
        taskLog("[Script] Command successful!");
    } else {
        MCPStudio.setToolResult(JSON.stringify({
            text: "[Script] Command failed.\n" + 
               (stdOut && stdOut.length > 0 ? stdOut.join("\n") : "") +  
               (stdErr && stdErr.length > 0 ? "\nErrors and Warnings:\n" + stdErr.join("\n") : ""),
            metadata: {
                path: ".",
                command: command,
                shell: shell,
                parameters: parameters,
                operation: "shellCall",
                success: false,
                stdout: stdOut,
                stderr: stdErr,
            }
        }));
        taskLog("[Script] Command failed!" + 
               (stdOut && stdOut.length > 0 ? stdOut.join("\n") : "") +  
               (stdErr && stdErr.length > 0 ? "\nErrors and Warnings:\n" + stdErr.join("\n") : ""));
    }

    return null; // Result already set via MCPStudio.setToolResult
}

module.exports = {
    shellCall
};