Skip to content

startup_errors

Shared formatting for orchestrator startup failures surfaced by interfaces.

format_startup_error_message(exc)

Convert orchestrator startup failures into concise user-facing text.

Source code in src/mada/interfaces/startup_errors.py 
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
def format_startup_error_message(exc: BaseException) -> str:
    """
    Convert orchestrator startup failures into concise user-facing text.
    """
    details = str(exc).strip() or exc.__class__.__name__
    lowered = details.lower()

    if "connect" in lowered or "connection" in lowered or "cancellederror" in lowered:
        return (
            "MADA could not connect to one or more MCP servers. "
            "Check the MCP server processes and the URLs/commands in your config. "
            f"Details: {details}"
        )

    return f"MADA failed to initialize the configured agent team. Details: {details}"