<?php
if (!defined('ABSPATH')) {
    exit;
}

/**
 * AnswerRails_API_Router - Thin orchestration between the chat pipeline and
 * the active AI provider.
 *
 * As of the Phase 1 provider abstraction (see
 * docs/design/PROVIDER_ABSTRACTION_PHASE1_DESIGN.md), all vendor-specific
 * behaviour — endpoint selection, request adaptation, HTTP execution,
 * response extraction, health-based endpoint fallback — lives in the
 * provider implementations (includes/providers/). This class delegates chat
 * execution to the active provider; route_request keeps its public
 * signature, so callers are unchanged.
 *
 * This class carries no health accessors: admin health reads go direct to
 * AnswerRails_API_Health_Monitor::get_dashboard_snapshot() (#139).
 */
class AnswerRails_API_Router {

    /**
     * Execute a chat turn via the active provider.
     *
     * @return array|WP_Error See AnswerRails_Provider_Interface::execute_chat().
     */
    public function route_request(string $model, array $messages, array $attachments = [], array $options = []) {
        return AnswerRails_Provider_Factory::create()->execute_chat($model, $messages, $attachments, $options);
    }
}