"""
Copyright (C) 2026 Stefy Lanza <stefy@nexlab.net>

AISBF - AI Service Broker Framework || AI Should Be Free

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program.  If not, see <https://www.gnu.org/licenses/>.
"""

import pytest

from aisbf.studio import (
    StudioCapabilityResult,
    build_catalog_entry,
    derive_aggregate_capabilities,
    infer_model_capabilities,
    merge_capabilities,
    stamp_inferred_capabilities,
)


def test_infer_model_capabilities_prefers_explicit_capabilities():
    result = infer_model_capabilities(
        model_name="gpt-4o",
        provider_type="openai",
        explicit_capabilities=["chat", "vision"],
        architecture={"input_modalities": ["text", "image"], "output_modalities": ["text"]},
    )

    assert isinstance(result, StudioCapabilityResult)
    assert result.capabilities == ["chat", "vision"]
    assert result.source == "explicit"
    assert result.unknown is False


def test_infer_model_capabilities_uses_name_and_architecture_heuristics_when_explicit_missing():
    result = infer_model_capabilities(
        model_name="whisper-large-v3",
        provider_type="openai",
        explicit_capabilities=None,
        architecture={"input_modalities": ["audio"], "output_modalities": ["text"]},
    )

    assert "audio_input" in result.capabilities
    assert "transcription" in result.capabilities
    assert result.source in {"provider_metadata", "heuristic"}


def test_merge_capabilities_keeps_explicit_values_and_reports_partial_support():
    merged = merge_capabilities(
        base_capabilities=["chat", "vision", "image_generation"],
        override_capabilities=["chat", "vision"],
        support_mode="intersection",
    )

    assert merged.capabilities == ["chat", "vision"]
    assert merged.partial_capabilities == ["image_generation"]


def test_build_catalog_entry_normalizes_provider_model_payload():
    entry = build_catalog_entry(
        scope="user",
        owner_id=5,
        kind="provider_model",
        source_id="openai",
        target_id="gpt-4o",
        label="GPT-4o",
        description="General multimodal model",
        capabilities=["chat", "vision"],
        availability_state="ready",
        availability_reason=None,
        metadata={"context_length": 128000},
    )

    assert entry["id"] == "provider/openai/gpt-4o"
    assert entry["kind"] == "provider_model"
    assert entry["owner_scope"] == "user"
    assert entry["owner_id"] == 5
    assert entry["capabilities"] == ["chat", "vision"]
    assert entry["metadata"]["context_length"] == 128000


def test_infer_model_capabilities_restores_code_model_families():
    result = infer_model_capabilities(
        model_name="deepseek-coder-33b-instruct",
        provider_type="openai",
    )

    assert "code_generation" in result.capabilities
    assert "code_completion" in result.capabilities


def test_infer_model_capabilities_does_not_treat_video_understanding_models_as_generation():
    result = infer_model_capabilities(
        model_name="video-llama-2",
        provider_type="openai",
    )

    assert "video_understanding" in result.capabilities
    assert "video_generation" not in result.capabilities


@pytest.mark.parametrize("model_name", ["dalle-3", "runway-gen3"])
def test_infer_model_capabilities_does_not_fallback_to_chat_for_media_models(model_name):
    result = infer_model_capabilities(
        model_name=model_name,
        provider_type="openai",
    )

    assert "chat" not in result.capabilities


def test_stamp_inferred_capabilities_persists_inferred_metadata_for_model_dict():
    stamped = stamp_inferred_capabilities(
        {
            "name": "whisper-large-v3",
            "architecture": {"input_modalities": ["audio"], "output_modalities": ["text"]},
        },
        provider_type="openai",
    )

    assert stamped["studio_capabilities"] == ["audio_input", "transcription"]
    assert stamped["studio_capability_source"] in {"provider_metadata", "heuristic"}
    assert stamped["studio_capability_unknown"] is False
    assert "capabilities" not in stamped


def test_stamp_inferred_capabilities_preserves_existing_legacy_capabilities():
    stamped = stamp_inferred_capabilities(
        {
            "name": "whisper-large-v3",
            "capabilities": ["legacy-audio"],
            "architecture": {"input_modalities": ["audio"], "output_modalities": ["text"]},
        },
        provider_type="openai",
    )

    assert stamped["capabilities"] == ["legacy-audio"]
    assert stamped["studio_capabilities"] == ["legacy-audio"]


def test_build_catalog_entry_uses_persisted_studio_capability_metadata_when_available():
    entry = build_catalog_entry(
        scope="admin",
        owner_id=None,
        kind="provider_model",
        source_id="openai",
        target_id="whisper-large-v3",
        label="Whisper Large V3",
        description=None,
        capabilities=["audio_input", "transcription"],
        availability_state="ready",
        availability_reason=None,
        metadata={
            "provider_type": "openai",
            "capability_source": "heuristic",
            "capability_notes": [],
            "studio_capabilities": ["audio_input", "transcription"],
            "studio_capability_source": "heuristic",
            "studio_capability_unknown": False,
        },
    )

    assert entry["metadata"]["studio_capabilities"] == ["audio_input", "transcription"]
    assert entry["metadata"]["studio_capability_source"] == "heuristic"
    assert entry["metadata"]["studio_capability_unknown"] is False


def test_build_catalog_entry_prefers_persisted_studio_capabilities_over_legacy_capabilities():
    entry = build_catalog_entry(
        scope="admin",
        owner_id=None,
        kind="provider_model",
        source_id="openai",
        target_id="whisper-large-v3",
        label="Whisper Large V3",
        description=None,
        capabilities=["chat"],
        availability_state="ready",
        availability_reason=None,
        metadata={
            "studio_capabilities": ["audio_input", "transcription"],
            "studio_capability_source": "heuristic",
            "studio_capability_unknown": False,
        },
    )

    assert entry["capabilities"] == ["audio_input", "transcription"]


def test_build_catalog_entry_uses_aggregate_capabilities_for_rotation_without_explicit_capabilities():
    entry = build_catalog_entry(
        scope="admin",
        owner_id=None,
        kind="rotation",
        source_id="creative-rotation",
        target_id="creative-rotation",
        label="Creative Rotation",
        description=None,
        capabilities=None,
        availability_state="ready",
        availability_reason=None,
        metadata={
            "aggregate_capabilities": ["chat", "vision"],
            "aggregate_partial_capabilities": ["image_generation"],
            "aggregate_capability_source": "derived",
        },
    )

    assert entry["capabilities"] == ["chat", "vision"]
    assert entry["partial_capabilities"] == ["image_generation"]
    assert entry["metadata"]["aggregate_capability_source"] == "derived"


def test_build_catalog_entry_preserves_explicit_capabilities_when_aggregate_capabilities_exist():
    entry = build_catalog_entry(
        scope="admin",
        owner_id=None,
        kind="autoselect",
        source_id="balanced-autoselect",
        target_id="balanced-autoselect",
        label="Balanced Autoselect",
        description=None,
        capabilities=["chat"],
        availability_state="ready",
        availability_reason=None,
        metadata={
            "aggregate_capabilities": ["chat", "vision"],
            "aggregate_partial_capabilities": ["image_generation"],
            "aggregate_capability_source": "derived",
        },
    )

    assert entry["capabilities"] == ["chat"]
    assert entry["partial_capabilities"] == []


def test_merge_capabilities_reports_partial_support_for_rotation_intersection():
    merged = merge_capabilities(
        base_capabilities=["chat", "vision", "image_generation"],
        override_capabilities=["chat", "vision", "tool_use"],
        support_mode="intersection",
    )

    assert merged.capabilities == ["chat", "vision"]
    assert merged.partial_capabilities == ["image_generation"]


def test_derive_aggregate_capabilities_marks_missing_member_capabilities_as_uncertain():
    derived = derive_aggregate_capabilities([
        ["chat", "vision"],
        None,
    ])

    assert derived.capabilities == []
    assert derived.partial_capabilities == ["chat", "vision"]
