ars-backend/app/Services/Tool/Tools/BashTool.php

<?php

namespace App\Services\Tool\Tools;

use App\Services\Tool\Tool;

class BashTool implements Tool
{

    public function name(): string
    {
        return 'bash';
    }

    public function description(): string
    {
        return 'Execute bash commands';
    }

    /**
     * @inheritDoc
     */
    public function parameters(): array
    {
        return [
            'type' => 'object',
            'properties' => [
                'directory' => [
                    'type' => 'string',
                    'description' => 'The directory to list',
                    'default' => '.',
                ],
                'file' => [
                    'type' => 'string',
                    'description' => 'The file to read',
                ],
                'command' => [
                    'type' => 'string',
                    'description' => 'The command to execute',
                ],
                'user_confirmation_message' => [
                    'type' => 'string',
                    'description' => ' A message describing the purpose of this command, shown to the user for approval before execution ',
                ]
            ],
            'required' => [],
        ];
    }

    /**
     * @inheritDoc
     */
    public function execute(array $arguments): array|string
    {
        return [
            'output' => shell_exec($arguments['command']),
        ];
    }
}