A2aAgentServer

def __init__(
    self,
    agent: "ConversableAgent",
    *,
    url: str | None = "http://localhost:8000",
    agent_card: CardSettings | None = None,
    card_modifier: Callable[["AgentCard"], "AgentCard"] | None = None,
    extended_agent_card: CardSettings | None = None,
    extended_card_modifier: Callable[["AgentCard", "ServerCallContext"], "AgentCard"] | None = None,
) -> None:
    """Initialize the A2aAgentServer.

    Args:
        agent: The Autogen ConversableAgent to serve.
        url: The base URL for the A2A server.
        agent_card: Configuration for the base agent card.
        card_modifier: Function to modify the base agent card.
        extended_agent_card: Configuration for the extended agent card.
        extended_card_modifier: Function to modify the extended agent card.
    """
    self.agent = agent

    if not agent_card:
        agent_card = CardSettings()

    if agent_card.url and url != "http://localhost:8000":
        warnings.warn(
            (
                "You can't use `agent_card.url` and `url` options in the same time. "
                f"`agent_card.url` has a higher priority, so `{agent_card.url}` will be used."
            ),
            RuntimeWarning,
            stacklevel=2,
        )

    self.card = AgentCard.model_validate({
        # use agent options by default
        "name": agent.name,
        "description": agent.description,
        "url": url,
        "supports_authenticated_extended_card": extended_agent_card is not None,
        # exclude name and description if not provided
        **agent_card.model_dump(exclude_none=True),
    })

    self.extended_agent_card: AgentCard | None = None
    if extended_agent_card:
        if extended_agent_card.url and url != "http://localhost:8000":
            warnings.warn(
                (
                    "You can't use `extended_agent_card.url` and `url` options in the same time. "
                    f"`agent_card.url` has a higher priority, so `{extended_agent_card.url}` will be used."
                ),
                RuntimeWarning,
                stacklevel=2,
            )

        self.extended_agent_card = AgentCard.model_validate({
            "name": agent.name,
            "description": agent.description,
            "url": url,
            **extended_agent_card.model_dump(exclude_none=True),
        })

    # Auto-add A2UI extension to card if wrapping an A2UIAgent.
    # Declares the extension URI and supportedCatalogIds in the agent card
    # so clients know what A2UI version and catalogs this agent supports.
    try:
        from autogen.agents.experimental.a2ui import A2UIAgent
        from autogen.agents.experimental.a2ui.a2a_helpers import A2UI_EXTENSION_URI

        if isinstance(agent, A2UIAgent):
            existing_extensions = list(self.card.capabilities.extensions or [])
            if not any(e.uri == A2UI_EXTENSION_URI for e in existing_extensions):
                # Build params with supportedCatalogIds per A2UI extension spec
                params: dict[str, Any] = {
                    "supportedCatalogIds": [agent.catalog_id],
                }
                existing_extensions.append(
                    AgentExtension(
                        uri=A2UI_EXTENSION_URI,
                        description="Provides agent-driven UI using the A2UI v0.9 JSON format.",
                        params=params,
                    )
                )
                self.card.capabilities.extensions = existing_extensions
    except (ImportError, NameError):
        pass

    self.card_modifier = card_modifier
    self.extended_card_modifier = extended_card_modifier
    self.middlewares: list[tuple[BaseHTTPMiddleware, dict[str, Any]]] = []