"""Attach all FastAPI routers for the MCP server."""

from fastapi import FastAPI

from . import (
    agents, frontend_integration, health, metrics, monitoring, tools, websocket,
    auth, user, channel, admin, providers, billing_admin, sessions,
    quota_management, pricing_management,  # 阶段一：配额管理和定价管理
    resource_monitoring, event_management,  # 阶段二：资源监控和事件管理
    trace_management, audit_management,  # 阶段三：追踪和审计管理
    provider_health_management,  # 阶段四：供应商健康检查管理
    platform_agent_quota,  # 平台 Agent 配额管理
    billing_webhook,  # LiteLLM Token计费webhook
    external_tools,  # 外部数据工具管理
    paypal,  # PayPal 支付集成
    resources, resource_grants,  # Heicode P1：资源绑定与授权
    heicode_proxy,  # Heicode P4：NewAPI 用户视角元数据透传
    agnet_stub,  # Heicode P5：Agnet 平台本地 stub（12 个 /api/agnet/* 端点）
    heicode_tasks,  # Heicode 任务编排（5 个 /api/user/tasks/* 端点）
    heicode_events,  # Heicode §7.8.3：SSE 单通道 + Approval REST
)


def register_routes(app: FastAPI) -> None:
    for router in (
        health.router,
        auth.router,
        user.router,
        channel.router,
        admin.router,
        providers.router,
        billing_admin.router,  # 计费与资源管理路由
        billing_webhook.router,  # LiteLLM Token计费webhook
        quota_management.router,  # 配额管理路由
        pricing_management.router,  # 定价管理路由
        resource_monitoring.router,  # 资源监控路由
        event_management.router,  # 事件管理路由
        trace_management.router,  # 追踪管理路由
        audit_management.router,  # 审计管理路由
        provider_health_management.router,  # 供应商健康检查管理路由
        frontend_integration.router,
        agents.router,
        sessions.router,  # 会话管理路由
        tools.router,
        external_tools.router,  # 外部数据工具管理路由
        external_tools.toolkit_router,  # 外部数据工具集管理路由
        monitoring.router,
        metrics.router,
        websocket.router,
        # 平台 Agent 配额管理路由
        platform_agent_quota.channel_router,  # 渠道平台 Agent 配额管理
        platform_agent_quota.admin_router,  # 管理员平台 Agent 配额管理
        platform_agent_quota.user_router,  # 用户平台 Agent 配额管理
        # PayPal 支付路由
        paypal.router,  # PayPal 用户支付路由（需要认证）
        paypal.webhook_router,  # PayPal Webhook 回调路由（无需认证，在 whitelist 路径下）
        # Heicode P1: 资源绑定与授权
        resources.router,
        resource_grants.router,
        # Heicode P4: NewAPI 元数据透传
        heicode_proxy.router,
        # Heicode P5: Agnet 平台本地 stub
        agnet_stub.router,
        # Heicode 任务编排
        heicode_tasks.router,
        # Heicode §7.8.3 SSE + Approval
        heicode_events.router,
    ):
        app.include_router(router)