Function run_fastled_web_compiler

mcp_server.py:2503–2817

Run FastLED web compiler with playwright console.log capture.

(
    arguments: dict[str, Any], project_root: Path
)

async def run_fastled_web_compiler(
    arguments: dict[str, Any], project_root: Path
) -> CallToolResult:
    """Run FastLED web compiler with playwright console.log capture."""

    # Check if this is a background agent and refuse to run
    import os

    if (
        os.environ.get("FASTLED_CI_NO_INTERACTIVE") == "true"
        or os.environ.get("CI") == "true"
    ):
        return CallToolResult(
            content=[
                TextContent(
                    type="text",
                    text="🚫 FastLED Web Compiler is disabled for background agents. This tool is only available for foreground agents with interactive environments.",
                )
            ],
            isError=True,
        )

    example_path = arguments.get("example_path", "examples/Audio")
    capture_duration = arguments.get("capture_duration", 30)
    headless = arguments.get("headless", False)
    port = arguments.get("port", 0)
    docker_check = arguments.get("docker_check", True)
    save_screenshot = arguments.get("save_screenshot", True)

    # Check prerequisites
    result_text = "🌐 FastLED Web Compiler with Console.log Capture\n"
    result_text += "=" * 50 + "\n\n"

    # Check if fastled command is available
    if not shutil.which("fastled"):
        return CallToolResult(
            content=[
                TextContent(
                    type="text",
                    text="[ERROR] FastLED command not found. Please install with: pip install fastled",
                )
            ],
            isError=True,
        )

    result_text += "[OK] FastLED command found\n"

    # Check if Docker is available (optional)
    docker_available = shutil.which("docker") is not None
    if docker_check:
        if docker_available:
            result_text += "[OK] Docker available (faster compilation)\n"
        else:
            result_text += "⚠️  Docker not available (slower compilation)\n"

    # Check if playwright is available
    try:
        from playwright.async_api import async_playwright