Skip to content

Use Claude Code, Codex, VSCode, Pi, and OpenCode (and 6 other harnesses) for free (1.3B+ free tokens) from your terminal, app, IDE, or phone, and now from the browser with native browser sessions (multi-harness + multi-model) like OpenClaw (voice supported + ToS friendly)

Python
6.8 KB
Raw Blame
"""Tests for the Agnes AI OpenAI-chat provider profile."""

from typing import Any
from unittest.mock import patch

import httpx
import pytest
from openai import AsyncOpenAI

from free_claude_code.application.errors import InvalidRequestError
from free_claude_code.application.model_metadata import ProviderModelInfo
from free_claude_code.config.constants import ANTHROPIC_DEFAULT_MAX_OUTPUT_TOKENS
from free_claude_code.config.provider_catalog import AGNES_DEFAULT_BASE
from free_claude_code.core.anthropic.models import MessagesRequest
from free_claude_code.core.reasoning import ReasoningPolicy
from free_claude_code.providers.openai_chat import OpenAIChatProvider
from tests.providers.support import (
    REASONING_OFF,
    REASONING_ON,
    immediate_admission,
    make_provider_config,
    profiled_provider,
    reasoning_for,
)


@pytest.fixture
def agnes_provider() -> OpenAIChatProvider:
    return profiled_provider(
        "agnes",
        make_provider_config(
            api_key="test-agnes-key",
            base_url=AGNES_DEFAULT_BASE,
        ),
        admission=immediate_admission(provider_name="agnes"),
    )


def _request(**overrides: Any) -> MessagesRequest:
    payload: dict[str, Any] = {
        "model": "agnes-2.0-flash",
        "messages": [{"role": "user", "content": "Hello"}],
    }
    payload.update(overrides)
    return MessagesRequest.model_validate(payload)


def test_init_uses_documented_endpoint(
    agnes_provider: OpenAIChatProvider,
) -> None:
    assert agnes_provider._api_key == "test-agnes-key"
    assert agnes_provider._base_url == AGNES_DEFAULT_BASE
    assert agnes_provider._provider_name == "AGNES"


def test_build_request_body_preserves_common_chat_tools_and_images(
    agnes_provider: OpenAIChatProvider,
) -> None:
    request = _request(
        system="Be concise.",
        messages=[
            {
                "role": "user",
                "content": [
                    {"type": "text", "text": "Inspect this image."},
                    {
                        "type": "image",
                        "source": {
                            "type": "base64",
                            "media_type": "image/png",
                            "data": "aW1hZ2U=",
                        },
                    },
                ],
            }
        ],
        tools=[
            {
                "name": "inspect_image",
                "description": "Inspect an image",
                "input_schema": {
                    "type": "object",
                    "properties": {"detail": {"type": "string"}},
                },
            }
        ],
    )

    body = agnes_provider._chat._build_request_body(
        request,
        reasoning=reasoning_for(request),
    )

    assert body["model"] == "agnes-2.0-flash"
    assert body["max_tokens"] == ANTHROPIC_DEFAULT_MAX_OUTPUT_TOKENS
    assert body["messages"][0] == {"role": "system", "content": "Be concise."}
    assert body["messages"][1]["content"] == [
        {"type": "text", "text": "Inspect this image."},
        {
            "type": "image_url",
            "image_url": {"url": "data:image/png;base64,aW1hZ2U="},
        },
    ]
    assert body["tools"][0]["function"]["name"] == "inspect_image"


@pytest.mark.parametrize(
    ("reasoning", "enabled"),
    [(REASONING_OFF, False), (REASONING_ON, True)],
)
def test_build_request_body_encodes_documented_thinking_control(
    agnes_provider: OpenAIChatProvider,
    reasoning: ReasoningPolicy,
    enabled: bool,
) -> None:
    request = _request()

    body = agnes_provider._chat._build_request_body(request, reasoning=reasoning)

    assert body["extra_body"] == {"chat_template_kwargs": {"enable_thinking": enabled}}


def test_build_request_body_omits_thinking_control_for_provider_default(
    agnes_provider: OpenAIChatProvider,
) -> None:
    request = _request()

    body = agnes_provider._chat._build_request_body(
        request,
        reasoning=ReasoningPolicy.provider_default(),
    )

    assert "extra_body" not in body


def test_build_request_body_replays_reasoning_in_content_not_undocumented_field(
    agnes_provider: OpenAIChatProvider,
) -> None:
    request = _request(
        messages=[
            {"role": "user", "content": "Solve it."},
            {
                "role": "assistant",
                "content": [
                    {"type": "thinking", "thinking": "Work through it."},
                    {"type": "text", "text": "The answer is 42."},
                ],
            },
            {"role": "user", "content": "Continue."},
        ]
    )

    body = agnes_provider._chat._build_request_body(
        request,
        reasoning=reasoning_for(request),
    )

    assistant = body["messages"][1]
    assert assistant == {
        "role": "assistant",
        "content": "<think>\nWork through it.\n</think>\n\nThe answer is 42.",
    }


@pytest.mark.parametrize("field", ["reasoning", "reasoning_effort"])
def test_build_request_body_rejects_caller_reasoning_override(
    agnes_provider: OpenAIChatProvider,
    field: str,
) -> None:
    request = _request(extra_body={field: "caller-owned"})

    with pytest.raises(InvalidRequestError, match="must not override reasoning"):
        agnes_provider._chat._build_request_body(request, reasoning=REASONING_ON)


@pytest.mark.asyncio
async def test_model_catalog_uses_documented_endpoint_and_auth() -> None:
    requests: list[httpx.Request] = []

    def handler(request: httpx.Request) -> httpx.Response:
        requests.append(request)
        return httpx.Response(
            200,
            json={
                "object": "list",
                "data": [
                    {
                        "id": "agnes-2.0-flash",
                        "object": "model",
                        "created": 0,
                        "owned_by": "agnes-ai",
                    }
                ],
            },
        )

    http_client = httpx.AsyncClient(transport=httpx.MockTransport(handler))

    def build_client(*args: Any, **kwargs: Any) -> AsyncOpenAI:
        kwargs["http_client"] = http_client
        return AsyncOpenAI(*args, **kwargs)

    with patch(
        "free_claude_code.providers.openai_chat.client.AsyncOpenAI",
        side_effect=build_client,
    ):
        provider = profiled_provider(
            "agnes",
            make_provider_config(
                api_key="wire-agnes-key",
                base_url=AGNES_DEFAULT_BASE,
            ),
            admission=immediate_admission(provider_name="agnes"),
        )
    try:
        model_infos = await provider.list_model_infos()
    finally:
        await provider.cleanup()

    assert model_infos == frozenset({ProviderModelInfo("agnes-2.0-flash")})
    assert len(requests) == 1
    assert str(requests[0].url) == "https://apihub.agnes-ai.com/v1/models"
    assert requests[0].headers["authorization"] == "Bearer wire-agnes-key"