Add Python Executor

[danilowhk]

Overview

This PR adds a secure Python code execution capability to the FLASH toolkit, implementing a sandboxed Python environment that enhances the toolkit's computational abilities. Using Pyodide (Python compiled to WebAssembly), this tool enables AI agents to safely execute Python code for data analysis, visualization, and computation while maintaining strong security boundaries.

New Features

Python Code Execution Tool

Core Functionality:

• Securely execute arbitrary Python code in a WebAssembly sandbox
• Install Python packages on-demand for extended functionality
• Generate and return matplotlib visualizations
• Capture stdout, stderr, and execution results

Security Features:

• Complete isolation from the host system via WebAssembly sandbox
• Configurable execution timeouts to prevent infinite loops
• Memory usage limits to prevent resource exhaustion
• No file system or network access by default

Execution Options:

• Timeout controls (default: 5 seconds)
• Memory limit settings (default: 512MB)
• Package installation for extended functionality
• Plot generation and capture capabilities

Implementation Details

• Uses Pyodide to run Python in a WebAssembly sandbox
• Implements Promise.race pattern for timeout enforcement
• Provides consistent, well-formatted output with markdown sections
• Dynamically imports dependencies to support various runtime environments

Testing

• Unit tests for code execution
• Error handling verification
• Memory and timeout constraint testing
• Package installation tests

This powerful but secure Python execution environment opens up new possibilities for computational and analytical tasks within the FLASH framework.