Skip to content

Your lightweight open-source personal agent.

56.9 KB
Raw Blame
from __future__ import annotations

import base64
from pathlib import Path
from typing import Any

import httpx
import pytest

from nanobot.providers.image_generation import (
    AIHubMixImageGenerationClient,
    CodexImageGenerationClient,
    CustomImageGenerationClient,
    GeminiImageGenerationClient,
    GeneratedImageResponse,
    ImageGenerationError,
    MiniMaxImageGenerationClient,
    ModelScopeImageGenerationClient,
    OllamaImageGenerationClient,
    OpenAIImageGenerationClient,
    OpenRouterImageGenerationClient,
    StepFunImageGenerationClient,
    ZhipuImageGenerationClient,
)

PNG_BYTES = (
    b"\x89PNG\r\n\x1a\n\x00\x00\x00\rIHDR\x00\x00\x00\x01"
    b"\x00\x00\x00\x01\x08\x04\x00\x00\x00\xb5\x1c\x0c\x02"
    b"\x00\x00\x00\x0bIDATx\xdacd\xfc\xff\x1f\x00\x03\x03"
    b"\x02\x00\xef\xbf\xa7\xdb\x00\x00\x00\x00IEND\xaeB`\x82"
)
PNG_DATA_URL = (
    "data:image/png;base64,"
    "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mP8/x8AAwMCAO+/p9sAAAAASUVORK5CYII="
)
JPEG_BYTES = b"\xff\xd8\xff\xe0" + b"0" * 12


class FakeResponse:
    def __init__(
        self,
        payload: dict[str, Any],
        status_code: int = 200,
        content: bytes = b"",
    ) -> None:
        self._payload = payload
        self.status_code = status_code
        self.text = str(payload)
        self.content = content
        self.request = httpx.Request("POST", "https://openrouter.ai/api/v1/chat/completions")

    def json(self) -> dict[str, Any]:
        return self._payload

    def raise_for_status(self) -> None:
        if self.status_code >= 400:
            response = httpx.Response(self.status_code, request=self.request, text=self.text)
            raise httpx.HTTPStatusError("failed", request=self.request, response=response)


class FakeClient:
    def __init__(self, response: FakeResponse) -> None:
        self.response = response
        self.get_response = response
        self.calls: list[dict[str, Any]] = []
        self.get_calls: list[dict[str, Any]] = []

    async def post(self, url: str, **kwargs: Any) -> FakeResponse:
        self.calls.append({"url": url, **kwargs})
        return self.response

    async def get(self, url: str, **kwargs: Any) -> FakeResponse:
        self.get_calls.append({"url": url, **kwargs})
        return self.get_response


@pytest.fixture(autouse=True)
def generated_image_downloads(monkeypatch) -> list[tuple[str, str | None]]:
    """Keep provider response parsing tests independent from outbound HTTP."""
    downloads: list[tuple[str, str | None]] = []

    async def download(url: str, *, proxy: str | None = None) -> str:
        downloads.append((url, proxy))
        return PNG_DATA_URL

    monkeypatch.setattr(
        "nanobot.providers.image_generation._download_image_data_url",
        download,
    )
    return downloads


@pytest.mark.asyncio
async def test_openrouter_image_generation_payload_and_response(tmp_path: Path) -> None:
    ref = tmp_path / "ref.png"
    ref.write_bytes(PNG_BYTES)
    fake = FakeClient(
        FakeResponse(
            {
                "choices": [
                    {
                        "message": {
                            "content": "done",
                            "images": [{"image_url": {"url": PNG_DATA_URL}}],
                        }
                    }
                ]
            }
        )
    )
    client = OpenRouterImageGenerationClient(
        api_key="sk-or-test",
        api_base="https://openrouter.ai/api/v1/",
        extra_headers={"X-Test": "1"},
        client=fake,  # type: ignore[arg-type]
    )

    response = await client.generate(
        prompt="make this blue",
        model="openai/gpt-5.4-image-2",
        reference_images=[str(ref)],
        aspect_ratio="16:9",
        image_size="2K",
    )

    assert isinstance(response, GeneratedImageResponse)
    assert response.images == [PNG_DATA_URL]
    assert response.content == "done"

    call = fake.calls[0]
    assert call["url"] == "https://openrouter.ai/api/v1/chat/completions"
    assert call["headers"]["Authorization"] == "Bearer sk-or-test"
    assert call["headers"]["X-Test"] == "1"
    body = call["json"]
    assert body["modalities"] == ["image", "text"]
    assert body["image_config"] == {"aspect_ratio": "16:9", "image_size": "2K"}
    assert body["messages"][0]["content"][0] == {"type": "text", "text": "make this blue"}
    assert body["messages"][0]["content"][1]["image_url"]["url"].startswith("data:image/png;base64,")


@pytest.mark.asyncio
async def test_openrouter_image_generation_requires_images() -> None:
    fake = FakeClient(FakeResponse({"choices": [{"message": {"content": "text only"}}]}))
    client = OpenRouterImageGenerationClient(api_key="sk-or-test", client=fake)  # type: ignore[arg-type]

    with pytest.raises(ImageGenerationError, match="returned no images"):
        await client.generate(prompt="draw", model="model")


@pytest.mark.asyncio
async def test_openrouter_image_generation_requires_api_key() -> None:
    client = OpenRouterImageGenerationClient(api_key=None)

    with pytest.raises(ImageGenerationError, match="API key"):
        await client.generate(prompt="draw", model="model")


@pytest.mark.asyncio
async def test_ollama_image_generation_payload_and_response() -> None:
    raw_b64 = PNG_DATA_URL.removeprefix("data:image/png;base64,")
    fake = FakeClient(FakeResponse({"image": raw_b64}))
    client = OllamaImageGenerationClient(
        api_key="ollama-test",
        api_base="http://localhost:11434/v1/",
        extra_headers={"X-Test": "1"},
        extra_body={"seed": 123},
        client=fake,  # type: ignore[arg-type]
    )

    response = await client.generate(
        prompt="a sunset",
        model="x/z-image-turbo",
        aspect_ratio="16:9",
        image_size="1K",
    )

    assert response.images == [PNG_DATA_URL]
    assert response.content == ""

    call = fake.calls[0]
    assert call["url"] == "http://localhost:11434/api/generate"
    assert call["headers"]["Authorization"] == "Bearer ollama-test"
    assert call["headers"]["X-Test"] == "1"
    body = call["json"]
    assert body["model"] == "x/z-image-turbo"
    assert body["prompt"] == "a sunset"
    assert body["width"] == 1024
    assert body["height"] == 576
    assert body["steps"] == 0
    assert body["stream"] is False
    assert body["seed"] == 123


@pytest.mark.asyncio
async def test_ollama_image_generation_rejects_reference_images() -> None:
    client = OllamaImageGenerationClient(api_key=None)

    with pytest.raises(ImageGenerationError, match="reference images"):
        await client.generate(
            prompt="edit this",
            model="x/z-image-turbo",
            reference_images=["ref.png"],
        )


@pytest.mark.asyncio
async def test_aihubmix_image_generation_payload_and_response() -> None:
    raw_b64 = PNG_DATA_URL.removeprefix("data:image/png;base64,")
    fake = FakeClient(FakeResponse({"output": {"b64_json": [{"bytesBase64": raw_b64}]}}))
    client = AIHubMixImageGenerationClient(
        api_key="sk-ahm-test",
        api_base="https://aihubmix.com/v1/",
        extra_headers={"APP-Code": "nanobot"},
        extra_body={"quality": "low"},
        client=fake,  # type: ignore[arg-type]
    )

    response = await client.generate(
        prompt="draw a logo",
        model="gpt-image-2-free",
        aspect_ratio="16:9",
        image_size="1K",
    )

    assert response.images == [PNG_DATA_URL]
    call = fake.calls[0]
    assert call["url"] == "https://aihubmix.com/v1/models/openai/gpt-image-2-free/predictions"
    assert call["headers"]["Authorization"] == "Bearer sk-ahm-test"
    assert call["headers"]["APP-Code"] == "nanobot"
    assert call["json"] == {
        "input": {
            "prompt": "draw a logo",
            "n": 1,
            "size": "1536x1024",
            "quality": "low",
        }
    }


@pytest.mark.asyncio
async def test_aihubmix_image_edit_payload_uses_reference_images(tmp_path: Path) -> None:
    raw_b64 = PNG_DATA_URL.removeprefix("data:image/png;base64,")
    fake = FakeClient(FakeResponse({"output": [{"b64_json": raw_b64}]}))
    ref = tmp_path / "ref.png"
    ref.write_bytes(PNG_BYTES)
    client = AIHubMixImageGenerationClient(
        api_key="sk-ahm-test",
        client=fake,  # type: ignore[arg-type]
    )

    response = await client.generate(
        prompt="edit this",
        model="gpt-image-2-free",
        reference_images=[str(ref)],
        aspect_ratio="1:1",
    )

    assert response.images == [PNG_DATA_URL]
    call = fake.calls[0]
    assert call["url"] == "https://aihubmix.com/v1/models/openai/gpt-image-2-free/predictions"
    assert call["json"]["input"]["prompt"] == "edit this"
    assert call["json"]["input"]["n"] == 1
    assert call["json"]["input"]["size"] == "1024x1024"
    assert call["json"]["input"]["image"].startswith("data:image/png;base64,")


@pytest.mark.asyncio
async def test_aihubmix_image_generation_downloads_url_response(
    generated_image_downloads: list[tuple[str, str | None]],
) -> None:
    fake = FakeClient(FakeResponse({"data": [{"url": "https://cdn.example/image.png"}]}))
    fake.get_response = FakeResponse({}, content=PNG_BYTES)
    proxy = "http://127.0.0.1:23458"
    client = AIHubMixImageGenerationClient(
        api_key="sk-ahm-test",
        proxy=proxy,
        client=fake,  # type: ignore[arg-type]
    )

    response = await client.generate(prompt="draw", model="gpt-image-2-free")

    assert response.images[0].startswith("data:image/png;base64,")
    assert generated_image_downloads == [("https://cdn.example/image.png", proxy)]


@pytest.mark.asyncio
async def test_aihubmix_base64_response_uses_detected_mime() -> None:
    raw_b64 = base64.b64encode(JPEG_BYTES).decode("ascii")
    fake = FakeClient(FakeResponse({"output": {"b64_json": raw_b64}}))
    client = AIHubMixImageGenerationClient(
        api_key="sk-ahm-test",
        client=fake,  # type: ignore[arg-type]
    )

    response = await client.generate(prompt="draw", model="gpt-image-2-free")

    assert response.images == [f"data:image/jpeg;base64,{raw_b64}"]


RAW_B64 = PNG_DATA_URL.removeprefix("data:image/png;base64,")


@pytest.mark.asyncio
async def test_gemini_imagen_payload_and_response() -> None:
    fake = FakeClient(
        FakeResponse({"predictions": [{"bytesBase64Encoded": RAW_B64, "mimeType": "image/png"}]})
    )
    client = GeminiImageGenerationClient(
        api_key="AIza-test",
        api_base="https://generativelanguage.googleapis.com/v1beta",
        client=fake,  # type: ignore[arg-type]
    )

    response = await client.generate(
        prompt="a sunset",
        model="imagen-4.0-generate-001",
        aspect_ratio="16:9",
    )

    assert response.images == [PNG_DATA_URL]
    assert response.content == ""
    call = fake.calls[0]
    assert call["url"].endswith(":predict")
    assert call["headers"]["x-goog-api-key"] == "AIza-test"
    assert "params" not in call
    body = call["json"]
    assert body["instances"] == [{"prompt": "a sunset"}]
    assert body["parameters"]["sampleCount"] == 1
    assert body["parameters"]["aspectRatio"] == "16:9"


@pytest.mark.asyncio
async def test_gemini_imagen_ignores_unsupported_aspect_ratio() -> None:
    fake = FakeClient(
        FakeResponse({"predictions": [{"bytesBase64Encoded": RAW_B64, "mimeType": "image/png"}]})
    )
    client = GeminiImageGenerationClient(api_key="AIza-test", client=fake)  # type: ignore[arg-type]

    await client.generate(prompt="a sunset", model="imagen-4.0-generate-001", aspect_ratio="2:3")

    body = fake.calls[0]["json"]
    assert "aspectRatio" not in body["parameters"]


@pytest.mark.asyncio
async def test_gemini_flash_payload_and_response() -> None:
    fake = FakeClient(
        FakeResponse(
            {
                "candidates": [
                    {
                        "content": {
                            "parts": [
                                {"text": "here is your image"},
                                {"inlineData": {"mimeType": "image/png", "data": RAW_B64}},
                            ]
                        }
                    }
                ]
            }
        )
    )
    client = GeminiImageGenerationClient(
        api_key="AIza-test",
        api_base="https://generativelanguage.googleapis.com/v1beta",
        client=fake,  # type: ignore[arg-type]
    )

    response = await client.generate(
        prompt="draw a cat",
        model="gemini-2.0-flash-preview-image-generation",
    )

    assert response.images == [PNG_DATA_URL]
    assert response.content == "here is your image"
    call = fake.calls[0]
    assert call["url"].endswith(":generateContent")
    assert call["headers"]["x-goog-api-key"] == "AIza-test"
    assert "params" not in call
    body = call["json"]
    assert body["generationConfig"]["responseModalities"] == ["TEXT", "IMAGE"]
    assert body["contents"][0]["parts"][-1] == {"text": "draw a cat"}


@pytest.mark.asyncio
async def test_gemini_flash_reference_images(tmp_path: Path) -> None:
    ref = tmp_path / "ref.png"
    ref.write_bytes(PNG_BYTES)
    fake = FakeClient(
        FakeResponse(
            {
                "candidates": [
                    {
                        "content": {
                            "parts": [{"inlineData": {"mimeType": "image/png", "data": RAW_B64}}]
                        }
                    }
                ]
            }
        )
    )
    client = GeminiImageGenerationClient(api_key="AIza-test", client=fake)  # type: ignore[arg-type]

    response = await client.generate(
        prompt="edit this",
        model="gemini-2.0-flash-preview-image-generation",
        reference_images=[str(ref)],
    )

    assert response.images == [PNG_DATA_URL]
    parts = fake.calls[0]["json"]["contents"][0]["parts"]
    assert parts[0]["inlineData"]["mimeType"] == "image/png"
    assert parts[0]["inlineData"]["data"].startswith("iVBOR")
    assert parts[1] == {"text": "edit this"}


def _gemini_flash_image_response() -> FakeResponse:
    return FakeResponse(
        {
            "candidates": [
                {"content": {"parts": [{"inlineData": {"mimeType": "image/png", "data": RAW_B64}}]}}
            ]
        }
    )


@pytest.mark.asyncio
async def test_gemini_flash_forwards_aspect_ratio_and_image_size() -> None:
    fake = FakeClient(_gemini_flash_image_response())
    client = GeminiImageGenerationClient(api_key="AIza-test", client=fake)  # type: ignore[arg-type]

    await client.generate(
        prompt="draw a cat",
        model="gemini-3-pro-image",
        aspect_ratio="16:9",
        image_size="2K",
    )

    image_config = fake.calls[0]["json"]["generationConfig"]["imageConfig"]
    assert image_config == {"aspectRatio": "16:9", "imageSize": "2K"}


@pytest.mark.asyncio
@pytest.mark.parametrize(
    "aspect_ratio, model",
    [
        pytest.param("4:3", "gemini-2.5-flash-image", id="5_drops_image_size"),
        pytest.param("16:9", "gemini-2.0-flash-preview-image-generation", id="0_drops_image_size"),
    ],
)
async def test_gemini_flash_omits_unsupported_image_size(aspect_ratio, model) -> None:
    fake = FakeClient(_gemini_flash_image_response())
    client = GeminiImageGenerationClient(api_key="AIza-test", client=fake)  # type: ignore[arg-type]

    await client.generate(
        prompt="draw a cat",
        model=model,
        aspect_ratio=aspect_ratio,
        image_size="1K",
    )

    image_config = fake.calls[0]["json"]["generationConfig"]["imageConfig"]
    assert image_config == {"aspectRatio": aspect_ratio}


@pytest.mark.parametrize(
    ("model", "aspect_ratio", "expected"),
    [
        ("gemini-3.1-flash-image", "1:8", {"aspectRatio": "1:8"}),
        ("gemini-3.1-flash-lite-image", "4:1", {"aspectRatio": "4:1"}),
        ("gemini-3-pro-image", "1:8", None),
        ("gemini-2.5-flash-image", "4:1", None),
    ],
)
@pytest.mark.asyncio
async def test_gemini_flash_scopes_extreme_aspect_ratios_by_model(
    model: str,
    aspect_ratio: str,
    expected: dict[str, str] | None,
) -> None:
    fake = FakeClient(_gemini_flash_image_response())
    client = GeminiImageGenerationClient(api_key="AIza-test", client=fake)  # type: ignore[arg-type]

    await client.generate(
        prompt="draw a cat",
        model=model,
        aspect_ratio=aspect_ratio,
    )

    image_config = fake.calls[0]["json"]["generationConfig"].get("imageConfig")
    assert image_config == expected


@pytest.mark.parametrize(
    ("model", "image_size", "expected"),
    [
        ("gemini-3-pro-image", "512", None),
        ("gemini-3-pro", "2K", None),
        ("gemini-3.1-flash-lite-image", "2K", None),
        ("gemini-3.1-flash-lite-image", "1K", {"imageSize": "1K"}),
        ("gemini-3.1-flash-image", "512", {"imageSize": "512"}),
    ],
)
@pytest.mark.asyncio
async def test_gemini_flash_scopes_image_size_by_model(
    model: str,
    image_size: str,
    expected: dict[str, str] | None,
) -> None:
    fake = FakeClient(_gemini_flash_image_response())
    client = GeminiImageGenerationClient(api_key="AIza-test", client=fake)  # type: ignore[arg-type]

    await client.generate(
        prompt="draw a cat",
        model=model,
        image_size=image_size,
    )

    image_config = fake.calls[0]["json"]["generationConfig"].get("imageConfig")
    assert image_config == expected


@pytest.mark.asyncio
async def test_gemini_flash_ignores_unsupported_hints() -> None:
    fake = FakeClient(_gemini_flash_image_response())
    client = GeminiImageGenerationClient(api_key="AIza-test", client=fake)  # type: ignore[arg-type]

    # 7:5 is not a documented ratio; 1:8 is only valid for 3.1 Flash, not Pro;
    # 1024x1024 is not a valid Gemini image-size token. All are dropped.
    await client.generate(
        prompt="draw a cat",
        model="gemini-3-pro-image",
        aspect_ratio="1:8",
        image_size="1024x1024",
    )

    assert "imageConfig" not in fake.calls[0]["json"]["generationConfig"]


@pytest.mark.asyncio
async def test_gemini_requires_api_key() -> None:
    client = GeminiImageGenerationClient(api_key=None)

    with pytest.raises(ImageGenerationError, match="API key"):
        await client.generate(prompt="draw", model="imagen-4.0-generate-001")


def test_gemini_image_client_uses_native_api_base_by_default() -> None:
    client = GeminiImageGenerationClient(api_key="AIza-test")
    assert client.api_base == "https://generativelanguage.googleapis.com/v1beta"


@pytest.mark.asyncio
async def test_gemini_no_images_raises() -> None:
    fake = FakeClient(FakeResponse({"candidates": [{"content": {"parts": [{"text": "sorry"}]}}]}))
    client = GeminiImageGenerationClient(api_key="AIza-test", client=fake)  # type: ignore[arg-type]

    with pytest.raises(ImageGenerationError, match="returned no images"):
        await client.generate(prompt="draw", model="gemini-2.0-flash-preview-image-generation")


@pytest.mark.asyncio
async def test_minimax_payload_and_response_with_reference_image(tmp_path: Path) -> None:
    ref = tmp_path / "ref.png"
    ref.write_bytes(PNG_BYTES)
    fake = FakeClient(FakeResponse({"data": {"image_base64": [RAW_B64]}}))
    client = MiniMaxImageGenerationClient(
        api_key="sk-mm-test",
        api_base="https://api.minimaxi.com/v1/",
        extra_headers={"X-Test": "1"},
        client=fake,  # type: ignore[arg-type]
    )

    response = await client.generate(
        prompt="draw a character",
        model="image-01",
        reference_images=[str(ref)],
        aspect_ratio="21:9",
    )

    assert response.images == [PNG_DATA_URL]
    call = fake.calls[0]
    assert call["url"] == "https://api.minimaxi.com/v1/image_generation"
    assert call["headers"]["Authorization"] == "Bearer sk-mm-test"
    assert call["headers"]["X-Test"] == "1"
    body = call["json"]
    assert body["model"] == "image-01"
    assert body["prompt"] == "draw a character"
    assert body["response_format"] == "base64"
    assert body["aspect_ratio"] == "21:9"
    assert body["subject_reference"][0]["type"] == "character"
    assert body["subject_reference"][0]["image_file"].startswith("data:image/png;base64,")


@pytest.mark.asyncio
async def test_minimax_base64_response_uses_detected_mime() -> None:
    raw_b64 = base64.b64encode(JPEG_BYTES).decode("ascii")
    fake = FakeClient(FakeResponse({"data": {"image_base64": [raw_b64]}}))
    client = MiniMaxImageGenerationClient(api_key="sk-mm-test", client=fake)  # type: ignore[arg-type]

    response = await client.generate(prompt="draw", model="image-01")

    assert response.images == [f"data:image/jpeg;base64,{raw_b64}"]


@pytest.mark.asyncio
async def test_stepfun_payload_and_response_with_aspect_ratio() -> None:
    fake = FakeClient(FakeResponse({"data": [{"b64_json": RAW_B64}]}))
    client = StepFunImageGenerationClient(
        api_key="sk-sf-test",
        api_base="https://api.stepfun.com/v1",
        extra_headers={"X-Test": "1"},
        client=fake,  # type: ignore[arg-type]
    )

    response = await client.generate(
        prompt="a cat on the moon",
        model="step-image-edit-2",
        aspect_ratio="16:9",
    )

    assert response.images == [PNG_DATA_URL]
    call = fake.calls[0]
    assert call["url"] == "https://api.stepfun.com/v1/images/generations"
    assert call["headers"]["Authorization"] == "Bearer sk-sf-test"
    assert call["headers"]["X-Test"] == "1"
    body = call["json"]
    assert body["model"] == "step-image-edit-2"
    assert body["prompt"] == "a cat on the moon"
    assert body["response_format"] == "b64_json"
    assert body["n"] == 1
    assert body["size"] == "1280x800"


@pytest.mark.asyncio
async def test_stepfun_default_size_when_no_aspect_ratio() -> None:
    fake = FakeClient(FakeResponse({"data": [{"b64_json": RAW_B64}]}))
    client = StepFunImageGenerationClient(
        api_key="sk-sf-test",
        api_base="https://api.stepfun.com/v1",
        client=fake,  # type: ignore[arg-type]
    )

    await client.generate(prompt="a dog", model="step-image-edit-2")

    body = fake.calls[0]["json"]
    assert body["size"] == "1024x1024"


@pytest.mark.asyncio
async def test_stepfun_uses_explicit_image_size() -> None:
    fake = FakeClient(FakeResponse({"data": [{"b64_json": RAW_B64}]}))
    client = StepFunImageGenerationClient(
        api_key="sk-sf-test",
        api_base="https://api.stepfun.com/v1",
        client=fake,  # type: ignore[arg-type]
    )

    await client.generate(
        prompt="a bird",
        model="step-image-edit-2",
        image_size="1024x1024",
    )

    body = fake.calls[0]["json"]
    assert body["size"] == "1024x1024"


@pytest.mark.asyncio
async def test_stepfun_style_reference_on_1x_model(tmp_path: Path) -> None:
    ref = tmp_path / "ref.png"
    ref.write_bytes(PNG_BYTES)
    fake = FakeClient(FakeResponse({"data": [{"b64_json": RAW_B64}]}))
    client = StepFunImageGenerationClient(
        api_key="sk-sf-test",
        api_base="https://api.stepfun.com/v1",
        client=fake,  # type: ignore[arg-type]
    )

    await client.generate(
        prompt="in this style",
        model="step-1x-medium",
        reference_images=[str(ref)],
    )

    body = fake.calls[0]["json"]
    assert "style_reference" in body
    assert body["style_reference"]["source_url"].startswith("data:image/png;base64,")


@pytest.mark.asyncio
async def test_stepfun_no_style_reference_on_non_1x_model() -> None:
    fake = FakeClient(FakeResponse({"data": [{"b64_json": RAW_B64}]}))
    client = StepFunImageGenerationClient(
        api_key="sk-sf-test",
        api_base="https://api.stepfun.com/v1",
        client=fake,  # type: ignore[arg-type]
    )

    await client.generate(
        prompt="a flower",
        model="step-image-edit-2",
        reference_images=["/tmp/ref.png"],
    )

    body = fake.calls[0]["json"]
    assert "style_reference" not in body


@pytest.mark.asyncio
async def test_stepfun_requires_api_key() -> None:
    client = StepFunImageGenerationClient(api_key=None)

    with pytest.raises(ImageGenerationError, match="API key"):
        await client.generate(prompt="draw", model="step-image-edit-2")


@pytest.mark.asyncio
async def test_stepfun_no_images_raises() -> None:
    fake = FakeClient(FakeResponse({"data": [{"text": "sorry"}]}))
    client = StepFunImageGenerationClient(api_key="sk-sf-test", client=fake)  # type: ignore[arg-type]

    with pytest.raises(ImageGenerationError, match="returned no images"):
        await client.generate(prompt="draw", model="step-image-edit-2")


@pytest.mark.asyncio
async def test_openai_payload_and_response() -> None:
    fake = FakeClient(FakeResponse({"data": [{"b64_json": RAW_B64}]}))
    client = OpenAIImageGenerationClient(
        api_key="sk-openai-test",
        api_base="https://api.openai.com/v1",
        extra_headers={"X-Test": "1"},
        client=fake,  # type: ignore[arg-type]
    )

    response = await client.generate(
        prompt="a cat on the moon",
        model="dall-e-3",
        aspect_ratio="16:9",
    )

    assert response.images == [PNG_DATA_URL]
    call = fake.calls[0]
    assert call["url"] == "https://api.openai.com/v1/images/generations"
    assert call["headers"]["Authorization"] == "Bearer sk-openai-test"
    assert call["headers"]["X-Test"] == "1"
    body = call["json"]
    assert body["model"] == "dall-e-3"
    assert body["prompt"] == "a cat on the moon"
    assert body["response_format"] == "b64_json"
    assert body["n"] == 1
    assert body["size"] == "1792x1024"


@pytest.mark.asyncio
async def test_openai_extra_body_null_drops_default_params_only() -> None:
    fake = FakeClient(FakeResponse({"data": [{"b64_json": RAW_B64}]}))
    client = OpenAIImageGenerationClient(
        api_key="sk-openai-test",
        extra_body={
            "response_format": None,
            "seed": 0,
            "safety_checker": False,
        },
        client=fake,  # type: ignore[arg-type]
    )

    await client.generate(prompt="draw", model="dall-e-3")

    body = fake.calls[0]["json"]
    assert "response_format" not in body
    assert body["n"] == 1
    assert body["seed"] == 0
    assert body["safety_checker"] is False


@pytest.mark.asyncio
async def test_openai_b64_json_response_uses_detected_mime() -> None:
    raw_b64 = base64.b64encode(JPEG_BYTES).decode("ascii")
    fake = FakeClient(FakeResponse({"data": [{"b64_json": raw_b64}]}))
    client = OpenAIImageGenerationClient(
        api_key="sk-openai-test",
        client=fake,  # type: ignore[arg-type]
    )

    response = await client.generate(prompt="draw", model="dall-e-3")

    assert response.images == [f"data:image/jpeg;base64,{raw_b64}"]


@pytest.mark.asyncio
async def test_openai_url_download_fallback(
    generated_image_downloads: list[tuple[str, str | None]],
) -> None:
    fake = FakeClient(FakeResponse({"data": [{"url": "https://cdn.example/image.png"}]}))
    fake.get_response = FakeResponse({}, content=PNG_BYTES)
    proxy = "http://127.0.0.1:23458"
    client = OpenAIImageGenerationClient(
        api_key="sk-openai-test",
        proxy=proxy,
        client=fake,  # type: ignore[arg-type]
    )

    response = await client.generate(prompt="draw", model="dall-e-3")

    assert response.images[0].startswith("data:image/png;base64,")
    assert generated_image_downloads == [("https://cdn.example/image.png", proxy)]


@pytest.mark.asyncio
async def test_openai_multiple_images() -> None:
    fake = FakeClient(FakeResponse({
        "data": [
            {"b64_json": RAW_B64},
            {"b64_json": RAW_B64},
        ]
    }))
    client = OpenAIImageGenerationClient(
        api_key="sk-openai-test",
        client=fake,  # type: ignore[arg-type]
    )

    response = await client.generate(prompt="draw", model="dall-e-3")

    assert len(response.images) == 2
    assert response.images == [PNG_DATA_URL, PNG_DATA_URL]


@pytest.mark.asyncio
@pytest.mark.parametrize(
    "expected_size, model, aspect_ratio",
    [
        pytest.param("1024x1024", "dall-e-3", "1:1", id="aspect_ratio_to_size"),
        pytest.param("1024x1024", "dall-e-2", "16:9", id="dalle2_uses_square_size_for_non_square_ratios"),
        pytest.param("1536x1024", "gpt-image-1", "16:9", id="gpt_image_uses_supported_landscape_size"),
    ],
)
async def test_openai_aspect_ratio_uses_model_supported_size(
    expected_size,
    model,
    aspect_ratio,
) -> None:
    fake = FakeClient(FakeResponse({"data": [{"b64_json": RAW_B64}]}))
    client = OpenAIImageGenerationClient(
        api_key="sk-openai-test",
        client=fake,  # type: ignore[arg-type]
    )

    await client.generate(prompt="draw", model=model, aspect_ratio=aspect_ratio)
    assert fake.calls[0]["json"]["size"] == expected_size


@pytest.mark.asyncio
async def test_openai_dalle3_uses_supported_orientation_sizes() -> None:
    fake = FakeClient(FakeResponse({"data": [{"b64_json": RAW_B64}]}))
    client = OpenAIImageGenerationClient(
        api_key="sk-openai-test",
        client=fake,  # type: ignore[arg-type]
    )

    await client.generate(prompt="draw", model="dall-e-3", aspect_ratio="3:4")
    await client.generate(prompt="draw", model="dall-e-3", aspect_ratio="4:3")

    assert fake.calls[0]["json"]["size"] == "1024x1792"
    assert fake.calls[1]["json"]["size"] == "1792x1024"


@pytest.mark.asyncio
async def test_openai_gpt_image_uses_supported_orientation_sizes() -> None:
    fake = FakeClient(FakeResponse({"data": [{"b64_json": RAW_B64}]}))
    client = OpenAIImageGenerationClient(
        api_key="sk-openai-test",
        client=fake,  # type: ignore[arg-type]
    )

    await client.generate(prompt="draw", model="gpt-image-1", aspect_ratio="3:4")
    await client.generate(prompt="draw", model="gpt-image-1", aspect_ratio="4:3")

    assert fake.calls[0]["json"]["size"] == "1024x1536"
    assert fake.calls[1]["json"]["size"] == "1536x1024"


@pytest.mark.asyncio
async def test_openai_reference_images_use_edits_endpoint(tmp_path: Path) -> None:
    ref = tmp_path / "ref.png"
    ref.write_bytes(PNG_BYTES)
    fake = FakeClient(FakeResponse({"data": [{"b64_json": RAW_B64}]}))
    client = OpenAIImageGenerationClient(
        api_key="sk-openai-test",
        api_base="https://api.openai.com/v1",
        extra_headers={"X-Test": "1"},
        client=fake,  # type: ignore[arg-type]
    )

    response = await client.generate(
        prompt="make a warmer version",
        model="gpt-image-1",
        reference_images=[str(ref)],
        aspect_ratio="16:9",
    )

    assert response.images == [PNG_DATA_URL]
    call = fake.calls[0]
    assert call["url"] == "https://api.openai.com/v1/images/edits"
    assert call["headers"]["Authorization"] == "Bearer sk-openai-test"
    assert call["headers"]["X-Test"] == "1"
    assert "Content-Type" not in call["headers"]
    assert "json" not in call
    assert call["data"]["model"] == "gpt-image-1"
    assert call["data"]["prompt"] == "make a warmer version"
    assert call["data"]["size"] == "1536x1024"
    assert len(call["files"]) == 1
    assert call["files"][0][0] == "image[]"
    assert call["files"][0][1][0] == "ref.png"
    assert call["files"][0][1][2] == "image/png"
    assert call["files"][0][1][1].closed is True


@pytest.mark.asyncio
async def test_openai_reference_images_expand_user_paths(
    tmp_path: Path,
    monkeypatch: pytest.MonkeyPatch,
) -> None:
    ref = tmp_path / "ref.png"
    ref.write_bytes(PNG_BYTES)
    monkeypatch.setenv("HOME", str(tmp_path))
    monkeypatch.setenv("USERPROFILE", str(tmp_path))
    fake = FakeClient(FakeResponse({"data": [{"b64_json": RAW_B64}]}))
    client = OpenAIImageGenerationClient(
        api_key="sk-openai-test",
        client=fake,  # type: ignore[arg-type]
    )

    await client.generate(
        prompt="use a home-relative reference",
        model="gpt-image-1",
        reference_images=["~/ref.png"],
    )

    call = fake.calls[0]
    assert call["url"] == "https://api.openai.com/v1/images/edits"
    assert call["files"][0][0] == "image[]"
    assert call["files"][0][1][0] == "ref.png"
    assert call["files"][0][1][2] == "image/png"
    assert call["files"][0][1][1].closed is True


@pytest.mark.asyncio
async def test_openai_reference_images_send_multiple_multipart_files(
    tmp_path: Path,
) -> None:
    first = tmp_path / "first.png"
    second = tmp_path / "second.png"
    first.write_bytes(PNG_BYTES)
    second.write_bytes(PNG_BYTES)
    fake = FakeClient(FakeResponse({"data": [{"b64_json": RAW_B64}]}))
    client = OpenAIImageGenerationClient(
        api_key="sk-openai-test",
        extra_body={
            "quality": "high",
            "seed": 0,
            "safety_checker": False,
            "metadata": {"ignored": True},
            "background": None,
        },
        client=fake,  # type: ignore[arg-type]
    )

    await client.generate(
        prompt="combine these references",
        model="openai/gpt-image-1",
        reference_images=[str(first), str(second)],
    )

    call = fake.calls[0]
    assert call["url"] == "https://api.openai.com/v1/images/edits"
    assert call["data"]["model"] == "gpt-image-1"
    assert call["data"]["prompt"] == "combine these references"
    assert call["data"]["quality"] == "high"
    assert call["data"]["seed"] == "0"
    assert call["data"]["safety_checker"] == "false"
    assert "metadata" not in call["data"]
    assert "background" not in call["data"]
    assert [item[0] for item in call["files"]] == ["image[]", "image[]"]
    assert [item[1][0] for item in call["files"]] == ["first.png", "second.png"]
    assert all(item[1][1].closed for item in call["files"])


@pytest.mark.asyncio
async def test_openai_gpt_image_without_reference_images_uses_generations_json() -> None:
    fake = FakeClient(FakeResponse({"data": [{"b64_json": RAW_B64}]}))
    client = OpenAIImageGenerationClient(
        api_key="sk-openai-test",
        client=fake,  # type: ignore[arg-type]
    )

    await client.generate(prompt="draw", model="gpt-image-1", aspect_ratio="16:9")

    call = fake.calls[0]
    assert call["url"] == "https://api.openai.com/v1/images/generations"
    assert call["headers"]["Content-Type"] == "application/json"
    assert call["json"]["model"] == "gpt-image-1"
    assert call["json"]["prompt"] == "draw"
    assert call["json"]["size"] == "1536x1024"
    assert "data" not in call
    assert "files" not in call


@pytest.mark.asyncio
async def test_openai_dalle_reference_images_raise_clear_error(tmp_path: Path) -> None:
    ref = tmp_path / "ref.png"
    ref.write_bytes(PNG_BYTES)
    client = OpenAIImageGenerationClient(api_key="sk-openai-test")

    with pytest.raises(ImageGenerationError, match="does not support reference images"):
        await client.generate(
            prompt="edit this",
            model="dall-e-3",
            reference_images=[str(ref)],
        )


@pytest.mark.asyncio
async def test_openai_default_size_when_no_aspect_ratio() -> None:
    fake = FakeClient(FakeResponse({"data": [{"b64_json": RAW_B64}]}))
    client = OpenAIImageGenerationClient(
        api_key="sk-openai-test",
        client=fake,  # type: ignore[arg-type]
    )

    await client.generate(prompt="draw", model="dall-e-3")

    body = fake.calls[0]["json"]
    assert body["size"] == "1024x1024"


@pytest.mark.asyncio
@pytest.mark.parametrize(
    "expected_size, image_size",
    [
        pytest.param("1792x1024", "1536x1024", id="ignores_explicit_size_unsupported_by_model_family"),
        pytest.param("1024x1024", "1024x1024", id="uses_explicit_image_size"),
    ],
)
async def test_openai_validates_explicit_size_for_model_family(expected_size, image_size) -> None:
    fake = FakeClient(FakeResponse({"data": [{"b64_json": RAW_B64}]}))
    client = OpenAIImageGenerationClient(
        api_key="sk-openai-test",
        client=fake,  # type: ignore[arg-type]
    )

    await client.generate(
        prompt="draw",
        model="dall-e-3",
        aspect_ratio="16:9",
        image_size=image_size,
    )

    body = fake.calls[0]["json"]
    assert body["size"] == expected_size


@pytest.mark.asyncio
async def test_openai_requires_api_key() -> None:
    client = OpenAIImageGenerationClient(api_key=None)

    with pytest.raises(ImageGenerationError, match="API key"):
        await client.generate(prompt="draw", model="dall-e-3")


@pytest.mark.asyncio
async def test_custom_generate_success() -> None:
    fake = FakeClient(FakeResponse({"data": [{"b64_json": RAW_B64}]}))
    client = CustomImageGenerationClient(
        api_key="sk-custom-test",
        api_base="https://custom.example/v1/",
        extra_headers={"X-Test": "1"},
        client=fake,  # type: ignore[arg-type]
    )

    response = await client.generate(
        prompt="a cat on the moon",
        model="custom-image-model",
        aspect_ratio="16:9",
    )

    assert isinstance(response, GeneratedImageResponse)
    assert response.images == [PNG_DATA_URL]
    assert response.content == ""
    call = fake.calls[0]
    assert call["url"] == "https://custom.example/v1/images/generations"
    assert call["headers"]["Authorization"] == "Bearer sk-custom-test"
    assert call["headers"]["X-Test"] == "1"
    body = call["json"]
    assert body["model"] == "custom-image-model"
    assert body["prompt"] == "a cat on the moon"
    assert body["response_format"] == "b64_json"
    assert body["n"] == 1
    assert body["size"] == "1536x1024"


@pytest.mark.asyncio
@pytest.mark.parametrize(
    "expected_size, image_size",
    [
        pytest.param("2K", "2K", id="preserves_provider_size_hint"),
        pytest.param("1024x1024", "1K", id="maps_one_k_to_openai_dimension"),
    ],
)
async def test_custom_generate_maps_size_hint(expected_size, image_size) -> None:
    fake = FakeClient(FakeResponse({"data": [{"b64_json": RAW_B64}]}))
    client = CustomImageGenerationClient(
        api_key="sk-custom-test",
        api_base="https://custom.example/v1",
        client=fake,  # type: ignore[arg-type]
    )

    await client.generate(
        prompt="a cat on the moon",
        model="custom-image-model",
        image_size=image_size,
    )

    assert fake.calls[0]["json"]["size"] == expected_size


@pytest.mark.asyncio
async def test_custom_generate_extra_body_can_override_defaults(
    generated_image_downloads: list[tuple[str, str | None]],
) -> None:
    fake = FakeClient(FakeResponse({"data": [{"url": "https://images.example/cat.png"}]}))
    fake.get_response = FakeResponse({}, content=PNG_BYTES)
    proxy = "http://127.0.0.1:23458"
    client = CustomImageGenerationClient(
        api_key="sk-custom-test",
        api_base="https://custom.example/v1",
        extra_body={"response_format": "url", "size": "2K"},
        proxy=proxy,
        client=fake,  # type: ignore[arg-type]
    )

    response = await client.generate(
        prompt="a cat on the moon",
        model="custom-image-model",
        image_size="1K",
    )

    assert response.images == [PNG_DATA_URL]
    assert generated_image_downloads == [("https://images.example/cat.png", proxy)]
    body = fake.calls[0]["json"]
    assert body["response_format"] == "url"
    assert body["size"] == "2K"


@pytest.mark.asyncio
async def test_custom_generate_without_api_key_omits_authorization() -> None:
    fake = FakeClient(FakeResponse({"data": [{"b64_json": RAW_B64}]}))
    client = CustomImageGenerationClient(
        api_key=None,
        api_base="http://localhost:7860/v1",
        client=fake,  # type: ignore[arg-type]
    )

    response = await client.generate(prompt="draw", model="custom-image-model")

    assert response.images == [PNG_DATA_URL]
    assert "Authorization" not in fake.calls[0]["headers"]


@pytest.mark.asyncio
async def test_custom_generate_requires_api_base() -> None:
    client = CustomImageGenerationClient(api_key="sk-custom-test")

    with pytest.raises(ImageGenerationError, match="providers.custom.apiBase"):
        await client.generate(prompt="draw", model="custom-image-model")


@pytest.mark.asyncio
async def test_custom_generate_http_error() -> None:
    fake = FakeClient(FakeResponse({"error": "bad request"}, status_code=400))
    client = CustomImageGenerationClient(
        api_key="sk-custom-test",
        api_base="https://custom.example/v1",
        client=fake,  # type: ignore[arg-type]
    )

    with pytest.raises(ImageGenerationError, match="HTTP 400"):
        await client.generate(prompt="draw", model="custom-image-model")


@pytest.fixture
def codex_oauth(monkeypatch):
    import sys
    from types import SimpleNamespace

    calls: list[dict[str, Any]] = []

    def get_token(**kwargs):
        calls.append(kwargs)
        return SimpleNamespace(account_id="acct-123", access="oauth-token")

    monkeypatch.setitem(sys.modules, "oauth_cli_kit", SimpleNamespace(get_token=get_token))
    return calls


@pytest.mark.asyncio
@pytest.mark.parametrize("base", [
    "https://chatgpt.com/backend-api",
    "https://chatgpt.com/backend-api/codex/",
])
async def test_codex_payload_and_response(codex_oauth, base: str) -> None:
    import json

    requests: list[httpx.Request] = []
    payload = {"created": 1778832973, "data": [{"b64_json": PNG_DATA_URL.split(",")[1]}]}

    def handle(request: httpx.Request) -> httpx.Response:
        requests.append(request)
        return httpx.Response(200, json=payload)

    async with httpx.AsyncClient(transport=httpx.MockTransport(handle)) as http:
        client = CodexImageGenerationClient(
            api_key=None, api_base=base, extra_headers={"X-Test": "1"}, client=http,
        )
        response = await client.generate(prompt="draw a cat", model=client.model_options[0])

    assert response.images == [PNG_DATA_URL]
    assert response.content == ""
    assert response.raw == payload
    request = requests[0]
    assert str(request.url) == "https://chatgpt.com/backend-api/codex/images/generations"
    assert request.headers["Authorization"] == "Bearer oauth-token"
    assert request.headers["chatgpt-account-id"] == "acct-123"
    assert request.headers["X-Test"] == "1"
    assert json.loads(request.content) == {
        "model": "gpt-image-2", "prompt": "draw a cat",
        "background": "opaque", "quality": "auto", "size": "auto",
    }


@pytest.mark.asyncio
async def test_codex_proxy_applies_to_oauth_and_http(monkeypatch, codex_oauth) -> None:
    proxy = "http://127.0.0.1:23458"
    captured: dict[str, Any] = {}

    class FakeAsyncClient:
        def __init__(self, **kwargs: Any) -> None:
            captured["client_kwargs"] = kwargs

        async def __aenter__(self):
            return self

        async def __aexit__(self, exc_type, exc, tb) -> None:
            return None

        async def post(self, url: str, **kwargs: Any) -> FakeResponse:
            captured["request"] = {"url": url, **kwargs}
            return FakeResponse({"data": [{"b64_json": PNG_DATA_URL.split(",")[1]}]})

    monkeypatch.setattr("nanobot.providers.image_generation.httpx.AsyncClient", FakeAsyncClient)
    client = CodexImageGenerationClient(api_key=None, proxy=proxy)
    response = await client.generate(prompt="draw", model="gpt-image-2")
    assert response.images == [PNG_DATA_URL]
    assert codex_oauth == [{"proxy": proxy}]
    assert captured["client_kwargs"]["proxy"] == proxy
    assert captured["client_kwargs"]["trust_env"] is False


@pytest.mark.asyncio
@pytest.mark.parametrize("prefix", ["openai-codex", "openai_codex"])
async def test_codex_edit_reference_images_and_options(codex_oauth, tmp_path, prefix) -> None:
    reference = tmp_path / "reference.png"
    reference.write_bytes(PNG_BYTES)
    fake = FakeClient(FakeResponse({"data": [{"b64_json": PNG_DATA_URL.split(",")[1]}]}))
    client = CodexImageGenerationClient(
        api_key=None, extra_body={"quality": "high", "background": None},
        client=fake,  # type: ignore[arg-type]
    )
    response = await client.generate(
        prompt="add a hat", model=f"{prefix}/gpt-image-2",
        reference_images=[str(reference)], aspect_ratio="16:9",
    )
    assert response.images == [PNG_DATA_URL]
    assert fake.calls[0]["url"] == "https://chatgpt.com/backend-api/codex/images/edits"
    assert fake.calls[0]["json"] == {
        "model": "gpt-image-2", "prompt": "add a hat", "quality": "high",
        "size": "1536x1024",
        "images": [{"image_url": "data:image/png;base64," + base64.b64encode(PNG_BYTES).decode()}],
    }


@pytest.mark.asyncio
async def test_codex_explicit_size(codex_oauth) -> None:
    fake = FakeClient(FakeResponse({"data": [{"b64_json": PNG_DATA_URL.split(",")[1]}]}))
    client = CodexImageGenerationClient(api_key=None, client=fake)  # type: ignore[arg-type]
    await client.generate(prompt="draw", model="gpt-image-2", image_size="2048x1152")
    assert fake.calls[0]["json"]["size"] == "2048x1152"


@pytest.mark.asyncio
async def test_codex_requires_oauth(monkeypatch) -> None:
    async def fake_to_thread(fn, *args, **kwargs):
        raise RuntimeError("no token")

    monkeypatch.setattr("asyncio.to_thread", fake_to_thread)
    client = CodexImageGenerationClient(api_key=None)
    with pytest.raises(ImageGenerationError, match="OAuth token"):
        await client.generate(prompt="draw", model="gpt-image-2")


@pytest.mark.asyncio
async def test_codex_no_images_raises(codex_oauth) -> None:
    fake = FakeClient(FakeResponse({"data": []}))
    client = CodexImageGenerationClient(api_key=None, client=fake)  # type: ignore[arg-type]
    with pytest.raises(ImageGenerationError, match="returned no images"):
        await client.generate(prompt="draw", model="gpt-image-2")


@pytest.mark.asyncio
async def test_codex_http_error(codex_oauth) -> None:
    fake = FakeClient(FakeResponse({"error": {"message": "image quota exceeded"}}, status_code=429))
    client = CodexImageGenerationClient(api_key=None, client=fake)  # type: ignore[arg-type]
    with pytest.raises(ImageGenerationError, match="HTTP 429.*image quota exceeded"):
        await client.generate(prompt="draw", model="gpt-image-2")


@pytest.mark.asyncio
async def test_openai_no_images_raises() -> None:
    fake = FakeClient(FakeResponse({"data": []}))
    client = OpenAIImageGenerationClient(
        api_key="sk-openai-test",
        client=fake,  # type: ignore[arg-type]
    )

    with pytest.raises(ImageGenerationError, match="returned no images"):
        await client.generate(prompt="draw", model="dall-e-3")


@pytest.mark.asyncio
async def test_zhipu_image_generation_payload_and_response() -> None:
    fake = FakeClient(FakeResponse({"data": [{"url": "https://cdn.example/image.png"}]}))
    fake.get_response = FakeResponse({}, content=PNG_BYTES)
    client = ZhipuImageGenerationClient(
        api_key="sk-zhipu-test",
        api_base="https://open.bigmodel.cn/api/paas/v4",
        extra_headers={"X-Test": "1"},
        extra_body={"watermark_enabled": False},
        client=fake,  # type: ignore[arg-type]
    )

    response = await client.generate(
        prompt="a sunset over the ocean",
        model="glm-image",
        aspect_ratio="16:9",
        image_size="2K",
    )

    assert response.images[0].startswith("data:image/png;base64,")
    call = fake.calls[0]
    assert call["url"] == "https://open.bigmodel.cn/api/paas/v4/images/generations"
    assert call["headers"]["Authorization"] == "Bearer sk-zhipu-test"
    assert call["headers"]["X-Test"] == "1"
    body = call["json"]
    assert body["model"] == "glm-image"
    assert body["prompt"] == "a sunset over the ocean"
    assert body["size"] == "1728x960"
    assert body["watermark_enabled"] is False


@pytest.mark.asyncio
async def test_zhipu_image_generation_with_explicit_size() -> None:
    fake = FakeClient(FakeResponse({"data": [{"url": "https://cdn.example/image.png"}]}))
    fake.get_response = FakeResponse({}, content=PNG_BYTES)
    client = ZhipuImageGenerationClient(
        api_key="sk-zhipu-test",
        client=fake,  # type: ignore[arg-type]
    )

    await client.generate(
        prompt="a cat",
        model="cogview-4",
        image_size="1024x1024",
    )

    body = fake.calls[0]["json"]
    assert body["size"] == "1024x1024"


@pytest.mark.asyncio
async def test_zhipu_image_generation_downloads_url_response(
    generated_image_downloads: list[tuple[str, str | None]],
) -> None:
    fake = FakeClient(FakeResponse({"data": [{"url": "https://cdn.example/image.png"}]}))
    fake.get_response = FakeResponse({}, content=PNG_BYTES)
    proxy = "http://127.0.0.1:23458"
    client = ZhipuImageGenerationClient(
        api_key="sk-zhipu-test",
        proxy=proxy,
        client=fake,  # type: ignore[arg-type]
    )

    response = await client.generate(prompt="draw", model="glm-image")

    assert response.images[0].startswith("data:image/png;base64,")
    assert generated_image_downloads == [("https://cdn.example/image.png", proxy)]


@pytest.mark.asyncio
async def test_zhipu_image_generation_requires_api_key() -> None:
    client = ZhipuImageGenerationClient(api_key=None)

    with pytest.raises(ImageGenerationError, match="API key"):
        await client.generate(prompt="draw", model="glm-image")


@pytest.mark.asyncio
async def test_zhipu_image_generation_no_images_raises() -> None:
    fake = FakeClient(FakeResponse({"data": [{"text": "sorry"}]}))
    client = ZhipuImageGenerationClient(api_key="sk-zhipu-test", client=fake)  # type: ignore[arg-type]

    with pytest.raises(ImageGenerationError, match="returned no images"):
        await client.generate(prompt="draw", model="glm-image")


@pytest.mark.asyncio
async def test_zhipu_image_generation_rejects_reference_images() -> None:
    client = ZhipuImageGenerationClient(api_key="sk-zhipu-test")

    with pytest.raises(ImageGenerationError, match="reference images"):
        await client.generate(
            prompt="edit this",
            model="glm-image",
            reference_images=["ref.png"],
        )


class ModelScopeFakeClient:
    """Fake httpx client for ModelScope async task pattern.

    Returns submit_response for POST, and serves poll_responses in sequence
    for GET /tasks/{id} calls. Image download GETs return PNG content.
    """

    def __init__(
        self,
        submit_response: FakeResponse,
        poll_responses: list[FakeResponse],
        download_content: bytes = PNG_BYTES,
    ) -> None:
        self.submit_response = submit_response
        self.poll_responses = poll_responses
        self.poll_idx = 0
        self.download_content = download_content
        self.calls: list[dict[str, Any]] = []
        self.get_calls: list[dict[str, Any]] = []

    async def post(self, url: str, **kwargs: Any) -> FakeResponse:
        self.calls.append({"url": url, **kwargs})
        return self.submit_response

    async def get(self, url: str, **kwargs: Any) -> FakeResponse:
        self.get_calls.append({"url": url, **kwargs})
        if "/tasks/" in url:
            idx = min(self.poll_idx, len(self.poll_responses) - 1)
            resp = self.poll_responses[idx]
            self.poll_idx += 1
            return resp
        return FakeResponse({}, content=self.download_content)


@pytest.fixture(autouse=True)
def _modelscope_fast_poll(monkeypatch) -> None:
    """Skip the real asyncio.sleep between ModelScope poll attempts."""
    monkeypatch.setattr(
        "nanobot.providers.image_generation._MODELSCOPE_POLL_INTERVAL_S", 0.0
    )


@pytest.mark.asyncio
async def test_modelscope_image_generation_submit_and_poll(
    generated_image_downloads: list[tuple[str, str | None]],
) -> None:
    submit = FakeResponse({"task_id": "abc123"})
    poll_responses = [
        FakeResponse({"task_status": "PENDING"}),
        FakeResponse({
            "task_status": "SUCCEED",
            "output_images": ["https://cdn.example/image.png"],
        }),
    ]
    fake = ModelScopeFakeClient(submit, poll_responses)
    proxy = "http://127.0.0.1:23458"
    client = ModelScopeImageGenerationClient(
        api_key="ms-token",
        api_base="https://api-inference.modelscope.cn/v1",
        proxy=proxy,
        client=fake,  # type: ignore[arg-type]
    )

    response = await client.generate(
        prompt="A golden cat",
        model="Qwen/Qwen-Image",
    )

    assert response.images[0].startswith("data:image/png;base64,")
    assert generated_image_downloads == [("https://cdn.example/image.png", proxy)]

    post_call = fake.calls[0]
    assert post_call["url"] == "https://api-inference.modelscope.cn/v1/images/generations"
    assert post_call["headers"]["Authorization"] == "Bearer ms-token"
    assert post_call["headers"]["X-ModelScope-Async-Mode"] == "true"
    body = post_call["json"]
    assert body["model"] == "Qwen/Qwen-Image"
    assert body["prompt"] == "A golden cat"

    assert "/tasks/abc123" in fake.get_calls[0]["url"]
    poll_headers = fake.get_calls[0]["headers"]
    assert poll_headers["X-ModelScope-Task-Type"] == "image_generation"


@pytest.mark.asyncio
async def test_modelscope_image_generation_with_size() -> None:
    submit = FakeResponse({"task_id": "t1"})
    poll = [FakeResponse({"task_status": "SUCCEED", "output_images": ["https://cdn/img.png"]})]
    fake = ModelScopeFakeClient(submit, poll)
    client = ModelScopeImageGenerationClient(
        api_key="ms-token",
        client=fake,  # type: ignore[arg-type]
    )

    await client.generate(
        prompt="test",
        model="Qwen/Qwen-Image-2512",
        image_size="768x1024",
    )

    body = fake.calls[0]["json"]
    assert body["size"] == "768x1024"


@pytest.mark.parametrize(
    ("aspect_ratio", "expected_size"),
    [
        ("1:1", "1328x1328"),
        ("16:9", "1664x928"),
        ("9:16", "928x1664"),
        ("3:4", "1140x1472"),
        ("4:3", "1472x1140"),
    ],
)
@pytest.mark.asyncio
async def test_modelscope_image_generation_aspect_ratio_mapping(
    aspect_ratio: str,
    expected_size: str,
) -> None:
    submit = FakeResponse({"task_id": "t1"})
    poll = [FakeResponse({"task_status": "SUCCEED", "output_images": ["https://cdn/img.png"]})]
    fake = ModelScopeFakeClient(submit, poll)
    client = ModelScopeImageGenerationClient(
        api_key="ms-token",
        client=fake,  # type: ignore[arg-type]
    )

    await client.generate(prompt="test", model="m", aspect_ratio=aspect_ratio)

    assert fake.calls[0]["json"]["size"] == expected_size


@pytest.mark.asyncio
async def test_modelscope_image_generation_task_failed() -> None:
    submit = FakeResponse({"task_id": "bad-task"})
    poll = [FakeResponse({"task_status": "FAILED", "errors": "oom"})]
    fake = ModelScopeFakeClient(submit, poll)
    client = ModelScopeImageGenerationClient(
        api_key="ms-token",
        client=fake,  # type: ignore[arg-type]
    )

    with pytest.raises(ImageGenerationError, match="task failed"):
        await client.generate(prompt="test", model="m")


@pytest.mark.asyncio
async def test_modelscope_image_generation_requires_api_key() -> None:
    client = ModelScopeImageGenerationClient(api_key=None)

    with pytest.raises(ImageGenerationError, match="API key"):
        await client.generate(prompt="draw", model="m")


@pytest.mark.asyncio
async def test_modelscope_image_generation_missing_task_id() -> None:
    submit = FakeResponse({"unexpected": "response"})
    fake = ModelScopeFakeClient(submit, [])
    client = ModelScopeImageGenerationClient(
        api_key="ms-token",
        client=fake,  # type: ignore[arg-type]
    )

    with pytest.raises(ImageGenerationError, match="task_id"):
        await client.generate(prompt="draw", model="m")


@pytest.mark.asyncio
async def test_modelscope_image_generation_with_reference_image() -> None:
    submit = FakeResponse({"task_id": "t1"})
    poll = [FakeResponse({"task_status": "SUCCEED", "output_images": ["https://cdn/img.png"]})]
    fake = ModelScopeFakeClient(submit, poll)
    client = ModelScopeImageGenerationClient(
        api_key="ms-token",
        client=fake,  # type: ignore[arg-type]
    )

    import tempfile
    with tempfile.NamedTemporaryFile(suffix=".png", delete=False) as f:
        f.write(PNG_BYTES)
        ref_path = f.name

    try:
        await client.generate(
            prompt="edit this image",
            model="Qwen/Qwen-Image-Edit",
            reference_images=[ref_path],
        )

        body = fake.calls[0]["json"]
        assert "image_url" in body
        assert body["image_url"].startswith("data:image/png;base64,")
    finally:
        Path(ref_path).unlink(missing_ok=True)


@pytest.mark.asyncio
async def test_modelscope_image_generation_extra_body_passthrough() -> None:
    submit = FakeResponse({"task_id": "t1"})
    poll = [FakeResponse({"task_status": "SUCCEED", "output_images": ["https://cdn/img.png"]})]
    fake = ModelScopeFakeClient(submit, poll)
    client = ModelScopeImageGenerationClient(
        api_key="ms-token",
        extra_body={"loras": "lora-repo-1", "seed": 42},
        client=fake,  # type: ignore[arg-type]
    )

    await client.generate(prompt="test", model="m")

    body = fake.calls[0]["json"]
    assert body["loras"] == "lora-repo-1"
    assert body["seed"] == 42


@pytest.mark.asyncio
async def test_modelscope_image_generation_poll_timeout(monkeypatch) -> None:
    monkeypatch.setattr(
        "nanobot.providers.image_generation._MODELSCOPE_POLL_MAX_ATTEMPTS", 3
    )
    submit = FakeResponse({"task_id": "t1"})
    poll = [FakeResponse({"task_status": "PENDING"})]
    fake = ModelScopeFakeClient(submit, poll)
    client = ModelScopeImageGenerationClient(
        api_key="ms-token",
        client=fake,  # type: ignore[arg-type]
    )

    with pytest.raises(ImageGenerationError, match="timed out"):
        await client.generate(prompt="test", model="m")

    assert len(fake.get_calls) == 3



def test_image_provider_http_client_kwargs_include_explicit_proxy() -> None:
    proxy = "http://127.0.0.1:23458"
    client = AIHubMixImageGenerationClient(
        api_key="sk-ahm-test",
        proxy=proxy,
    )

    assert client._http_client_kwargs() == {
        "timeout": client.timeout,
        "proxy": proxy,
        "trust_env": False,
    }