sequenceDiagram
    actor User
    participant Bot as "Tux Bot (Discord)"
    participant RunCog as "Run Cog"
    participant GodboltAPI as "Godbolt API"
    participant WandboxAPI as "Wandbox API"

    User->>Bot: $run `lang\ncode` (or reply)
    Bot->>RunCog: process_run_command(context, code)
    activate RunCog
    RunCog->>RunCog: Add reaction to user's message
    RunCog->>RunCog: language = __get_language(code)
    RunCog->>RunCog: cleaned_code = __clean_code(code)

    alt Language not supported by Godbolt or Wandbox
        RunCog->>Bot: Send error embed ("No compiler found")
        Bot-->>User: Error Embed
    else Language supported
        %% Call self.execute to determine backend and run code
        RunCog->>RunCog: output = self.execute(map, language, cleaned_code, is_wandbox, options)
        activate RunCog
        alt is_wandbox (language in compiler_map_wandbox)
            RunCog->>WandboxAPI: HTTP POST (code, compiler, options)
            activate WandboxAPI
            WandboxAPI-->>RunCog: JSON Response (program_output, compiler_error)
            deactivate WandboxAPI
            RunCog->>RunCog: Process Wandbox response to get output string
        else Use Godbolt (language in compiler_map_godbolt)
            RunCog->>GodboltAPI: HTTP POST (code, compiler_id, options)
            activate GodboltAPI
            GodboltAPI-->>RunCog: Text Response
            deactivate GodboltAPI
            RunCog->>RunCog: Process Godbolt response to get output string
        end
        RunCog-->>RunCog: Return formatted_output or None
        deactivate RunCog

        alt Execution failed (output is None or error string)
            RunCog->>Bot: Send error embed ("Failed to get output from compiler")
            Bot-->>User: Error Embed
        else Execution successful
            RunCog->>RunCog: Clear reaction from user's message
            RunCog->>Bot: send_embedded_reply(context, output, language, is_wandbox)
            Bot-->>User: Success Embed (with output and Close button)
        end
    end
    deactivate RunCog

classDiagram
    direction LR

    class Run {
        <<Cog>>
        -bot: Tux
        -compiler_map_godbolt: dict
        -compiler_map_wandbox: dict
        +__init__(bot: Tux)
        -__remove_ansi(ansi: str) str
        -__remove_backticks(st: str) str
        -__clean_code(st: str) str
        -__get_language(st: str) str
        +execute(compiler_map: dict, lang: str, code: str, is_wandbox: bool, opts: str|None) str|None
        +send_embedded_reply(ctx: Context, output: str, lang: str, is_wandbox: bool) None
        +run(ctx: Context, code: str|None) None
        +languages(ctx: Context) None
    }

    class Wandbox {
        <<Wrapper Module>>
        -client: httpx.Client
        -url: str
        +getoutput(code: str, compiler: str, options: str|None) dict|None
    }

    class Godbolt {
        <<Wrapper Module>>
        +getoutput(code: str, compiler_id: str, options: str|None) str|None
    }

    class EmbedCreator {
        <<Utility>>
        +create_embed(...)
    }

    Run ..> Wandbox : uses
    Run ..> Godbolt : uses
    Run ..> EmbedCreator : uses