Skip to content

πŸš€ The fast, Pythonic way to build MCP servers and clients.

32.0 KB
Raw Blame
import base64
import os
from typing import Annotated, Any, cast

import pytest
from mcp_types import BlobResourceContents, TextResourceContents
from pydantic import Field

from fastmcp import Client, FastMCP
from fastmcp.utilities.types import (
    Audio,
    File,
    Image,
    create_function_without_params,
    get_cached_typeadapter,
    is_class_member_of_type,
    issubclass_safe,
    replace_type,
)


class BaseClass:
    pass


class ChildClass(BaseClass):
    pass


class OtherClass:
    pass


class TestIsClassMemberOfType:
    def test_basic_subclass_check(self):
        """Test that a subclass is recognized as a member of the base class."""
        assert is_class_member_of_type(ChildClass, BaseClass)

    def test_self_is_member(self):
        """Test that a class is a member of itself."""
        assert is_class_member_of_type(BaseClass, BaseClass)

    def test_unrelated_class_is_not_member(self):
        """Test that an unrelated class is not a member of the base class."""
        assert not is_class_member_of_type(OtherClass, BaseClass)

    def test_typing_union_with_member_is_member(self):
        """Test that Union type with a member class is detected as a member."""
        union_type1: Any = ChildClass | OtherClass
        union_type2: Any = OtherClass | ChildClass

        assert is_class_member_of_type(union_type1, BaseClass)
        assert is_class_member_of_type(union_type2, BaseClass)

    def test_typing_union_without_member_is_not_member(self):
        """Test that Union type without any member class is not a member."""
        union_type: Any = OtherClass | str
        assert not is_class_member_of_type(union_type, BaseClass)

    def test_pipe_union_with_member_is_member(self):
        """Test that pipe syntax union with a member class is detected as a member."""
        union_pipe1: Any = ChildClass | OtherClass
        union_pipe2: Any = OtherClass | ChildClass

        assert is_class_member_of_type(union_pipe1, BaseClass)
        assert is_class_member_of_type(union_pipe2, BaseClass)

    def test_pipe_union_without_member_is_not_member(self):
        """Test that pipe syntax union without any member class is not a member."""
        union_pipe: Any = OtherClass | str
        assert not is_class_member_of_type(union_pipe, BaseClass)

    def test_annotated_member_is_member(self):
        """Test that Annotated with a member class is detected as a member."""
        annotated1: Any = Annotated[ChildClass, "metadata"]
        annotated2: Any = Annotated[BaseClass, "metadata"]

        assert is_class_member_of_type(annotated1, BaseClass)
        assert is_class_member_of_type(annotated2, BaseClass)

    def test_annotated_non_member_is_not_member(self):
        """Test that Annotated with a non-member class is not a member."""
        annotated: Any = Annotated[OtherClass, "metadata"]
        assert not is_class_member_of_type(annotated, BaseClass)

    def test_annotated_with_union_member_is_member(self):
        """Test that Annotated with a Union containing a member class is a member."""
        # Test with both Union styles
        annotated1: Any = Annotated[ChildClass | OtherClass, "metadata"]
        annotated2: Any = Annotated[ChildClass | OtherClass, "metadata"]

        assert is_class_member_of_type(annotated1, BaseClass)
        assert is_class_member_of_type(annotated2, BaseClass)

    def test_nested_annotated_with_member_is_member(self):
        """Test that nested Annotated with a member class is a member."""
        annotated: Any = Annotated[Annotated[ChildClass, "inner"], "outer"]
        assert is_class_member_of_type(annotated, BaseClass)

    def test_none_is_not_member(self):
        """Test that None is not a member of any class."""
        assert not is_class_member_of_type(None, BaseClass)

    def test_generic_type_is_not_member(self):
        """Test that generic types are not members based on their parameter types."""
        list_type: Any = list[ChildClass]
        assert not is_class_member_of_type(list_type, BaseClass)


class TestIsSubclassSafe:
    def test_child_is_subclass_of_parent(self):
        """Test that a child class is recognized as a subclass of its parent."""
        assert issubclass_safe(ChildClass, BaseClass)

    def test_class_is_subclass_of_itself(self):
        """Test that a class is a subclass of itself."""
        assert issubclass_safe(BaseClass, BaseClass)

    def test_unrelated_class_is_not_subclass(self):
        """Test that an unrelated class is not a subclass."""
        assert not issubclass_safe(OtherClass, BaseClass)

    def test_none_type_handled_safely(self):
        """Test that None type is handled safely without raising TypeError."""
        assert not issubclass_safe(cast(Any, None), BaseClass)


class TestImage:
    def test_image_initialization_with_path(self):
        """Test image initialization with a path."""
        # Mock test - we're not actually going to read a file
        image = Image(path="test.png")
        assert image.path is not None
        assert image.data is None
        assert image._mime_type == "image/png"

    def test_image_path_expansion_with_tilde(self):
        """Test that ~ is expanded to the user's home directory."""
        image = Image(path="~/test.png")
        assert image.path is not None
        assert not str(image.path).startswith("~")
        assert str(image.path).startswith(os.path.expanduser("~"))

    def test_image_path_expansion_with_env_var(self, monkeypatch, tmp_path):
        """Test that environment variables are expanded."""
        test_dir = tmp_path / "test_path"
        test_dir.mkdir()
        monkeypatch.setenv("TEST_PATH", str(test_dir))
        image = Image(path="$TEST_PATH/test.png")
        assert image.path is not None
        assert not str(image.path).startswith("$TEST_PATH")
        expected_path = test_dir / "test.png"
        assert image.path == expected_path

    def test_image_initialization_with_data(self):
        """Test image initialization with data."""
        image = Image(data=b"test")
        assert image.path is None
        assert image.data == b"test"
        assert image._mime_type == "image/png"  # Default for raw data

    def test_image_initialization_with_format(self):
        """Test image initialization with a specific format."""
        image = Image(data=b"test", format="jpeg")
        assert image._mime_type == "image/jpeg"

    @pytest.mark.parametrize(
        "fmt,mime_type",
        [
            ("jpg", "image/jpeg"),
            ("JPG", "image/jpeg"),
            ("svg", "image/svg+xml"),
            ("tif", "image/tiff"),
            ("png", "image/png"),
            ("avif", "image/avif"),
        ],
    )
    def test_mime_type_from_format(self, fmt, mime_type):
        """Format aliases map to the same MIME type as the matching file extension."""
        image = Image(data=b"test", format=fmt)
        assert image._mime_type == mime_type
        assert image.to_image_content().mime_type == mime_type

    def test_missing_data_and_path_raises_error(self):
        """Test that error is raised when neither path nor data is provided."""
        with pytest.raises(ValueError, match="Either path or data must be provided"):
            Image()

    def test_both_data_and_path_raises_error(self):
        """Test that error is raised when both path and data are provided."""
        with pytest.raises(
            ValueError, match="Only one of path or data can be provided"
        ):
            Image(path="test.png", data=b"test")

    @pytest.mark.parametrize(
        "extension,mime_type",
        [
            (".png", "image/png"),
            (".jpg", "image/jpeg"),
            (".jpeg", "image/jpeg"),
            (".gif", "image/gif"),
            (".webp", "image/webp"),
            (".unknown", "application/octet-stream"),
        ],
    )
    def test_get_mime_type_from_path(self, tmp_path, extension, mime_type):
        """Test MIME type detection from file extension."""
        path = tmp_path / f"test{extension}"
        path.write_bytes(b"fake image data")
        img = Image(path=path)
        assert img._mime_type == mime_type

    def test_to_image_content(self, tmp_path, monkeypatch):
        """Test conversion to ImageContent."""
        # Test with path
        img_path = tmp_path / "test.png"
        test_data = b"fake image data"
        img_path.write_bytes(test_data)

        img = Image(path=img_path)
        content = img.to_image_content()

        assert content.type == "image"
        assert content.mime_type == "image/png"
        assert content.data == base64.b64encode(test_data).decode()

        # Test with data
        img = Image(data=test_data, format="jpeg")
        content = img.to_image_content()

        assert content.type == "image"
        assert content.mime_type == "image/jpeg"
        assert content.data == base64.b64encode(test_data).decode()

    def test_to_image_content_error(self, monkeypatch):
        """Test error case in to_image_content."""
        # Create an Image with neither path nor data (shouldn't happen due to __init__ checks,
        # but testing the method's own error handling)
        img = Image(data=b"test")
        monkeypatch.setattr(img, "path", None)
        monkeypatch.setattr(img, "data", None)

        with pytest.raises(ValueError, match="No image data available"):
            img.to_image_content()

    @pytest.mark.parametrize(
        "mime_type,fname,expected_mime",
        [
            (None, "test.png", "image/png"),
            ("image/jpeg", "test.unknown", "image/jpeg"),
        ],
    )
    def test_to_data_uri(self, tmp_path, mime_type, fname, expected_mime):
        """Test conversion to data URI."""
        img_path = tmp_path / fname
        test_data = b"fake image data"
        img_path.write_bytes(test_data)

        img = Image(path=img_path)
        data_uri = img.to_data_uri(mime_type=mime_type)

        expected_data_uri = (
            f"data:{expected_mime};base64,{base64.b64encode(test_data).decode()}"
        )
        assert data_uri == expected_data_uri


class TestAudio:
    def test_audio_initialization_with_path(self):
        """Test audio initialization with a path."""
        # Mock test - we're not actually going to read a file
        audio = Audio(path="test.wav")
        assert audio.path is not None
        assert audio.data is None
        assert audio._mime_type == "audio/wav"

    def test_audio_path_expansion_with_tilde(self):
        """Test that ~ is expanded to the user's home directory."""
        audio = Audio(path="~/test.wav")
        assert audio.path is not None
        assert not str(audio.path).startswith("~")
        assert str(audio.path).startswith(os.path.expanduser("~"))

    def test_audio_path_expansion_with_env_var(self, monkeypatch, tmp_path):
        """Test that environment variables are expanded."""
        test_dir = tmp_path / "test_audio_path"
        test_dir.mkdir()
        monkeypatch.setenv("TEST_AUDIO_PATH", str(test_dir))
        audio = Audio(path="$TEST_AUDIO_PATH/test.wav")
        assert audio.path is not None
        assert not str(audio.path).startswith("$TEST_AUDIO_PATH")
        expected_path = test_dir / "test.wav"
        assert audio.path == expected_path

    def test_audio_initialization_with_data(self):
        """Test audio initialization with data."""
        audio = Audio(data=b"test")
        assert audio.path is None
        assert audio.data == b"test"
        assert audio._mime_type == "audio/wav"  # Default for raw data

    def test_mime_type_from_format(self):
        """Test MIME type normalization from audio format."""

        expected = {
            "wav": "audio/wav",
            "mp3": "audio/mpeg",
            "ogg": "audio/ogg",
            "m4a": "audio/mp4",
            "flac": "audio/flac",
        }

        for fmt, mime in expected.items():
            audio = Audio(data=b"test", format=fmt)
            assert audio._mime_type == mime

    def test_audio_initialization_with_format(self):
        """Test audio initialization with a specific format."""
        audio = Audio(data=b"test", format="mp3")
        assert audio._mime_type == "audio/mpeg"

    def test_missing_data_and_path_raises_error(self):
        """Test that error is raised when neither path nor data is provided."""
        with pytest.raises(ValueError, match="Either path or data must be provided"):
            Audio()

    def test_both_data_and_path_raises_error(self):
        """Test that error is raised when both path and data are provided."""
        with pytest.raises(
            ValueError, match="Only one of path or data can be provided"
        ):
            Audio(path="test.wav", data=b"test")

    def test_get_mime_type_from_path(self, tmp_path):
        """Test MIME type detection from file extension."""
        extensions = {
            ".wav": "audio/wav",
            ".mp3": "audio/mpeg",
            ".ogg": "audio/ogg",
            ".m4a": "audio/mp4",
            ".flac": "audio/flac",
            ".unknown": "application/octet-stream",
        }

        for ext, mime in extensions.items():
            path = tmp_path / f"test{ext}"
            path.write_bytes(b"fake audio data")
            audio = Audio(path=path)
            assert audio._mime_type == mime

    @pytest.mark.parametrize(
        "extension,mime_type",
        [
            ("opus", "audio/ogg"),
            ("aac", "audio/aac"),
            ("webm", "audio/webm"),
            ("aiff", "audio/aiff"),
            ("aif", "audio/aiff"),
        ],
    )
    @pytest.mark.parametrize("uppercase", [False, True])
    async def test_path_and_format_agree_on_mime_type(
        self, tmp_path, extension, mime_type, uppercase
    ):
        """A file extension maps to the same MIME type as the matching format."""
        if uppercase:
            extension = extension.upper()
        path = tmp_path / f"test.{extension}"
        path.write_bytes(b"fake audio data")

        from_path = Audio(path=path)
        from_format = Audio(data=b"test", format=extension)

        assert from_path._mime_type == mime_type
        assert from_format._mime_type == mime_type
        assert from_path.to_audio_content().mime_type == mime_type

        server = FastMCP()

        @server.tool
        def audio() -> Audio:
            return from_path

        async with Client(server) as client:
            result = await client.call_tool("audio")

        assert result.content[0].type == "audio"
        assert result.content[0].mime_type == mime_type
        assert base64.b64decode(result.content[0].data) == path.read_bytes()

    def test_to_audio_content(self, tmp_path, monkeypatch):
        """Test conversion to AudioContent."""
        # Test with path
        audio_path = tmp_path / "test.wav"
        test_data = b"fake audio data"
        audio_path.write_bytes(test_data)

        audio = Audio(path=audio_path)
        content = audio.to_audio_content()

        assert content.type == "audio"
        assert content.mime_type == "audio/wav"
        assert content.data == base64.b64encode(test_data).decode()

        # Test with data
        audio = Audio(data=test_data, format="mp3")
        content = audio.to_audio_content()

        assert content.type == "audio"
        assert content.mime_type == "audio/mpeg"
        assert content.data == base64.b64encode(test_data).decode()

    def test_to_audio_content_error(self, monkeypatch):
        """Test error case in to_audio_content."""
        # Create an Audio with neither path nor data (shouldn't happen due to __init__ checks,
        # but testing the method's own error handling)
        audio = Audio(data=b"test")
        monkeypatch.setattr(audio, "path", None)
        monkeypatch.setattr(audio, "data", None)

        with pytest.raises(ValueError, match="No audio data available"):
            audio.to_audio_content()

    def test_to_audio_content_with_override_mime_type(self, tmp_path):
        """Test conversion to AudioContent with override MIME type."""
        audio_path = tmp_path / "test.wav"
        test_data = b"fake audio data"
        audio_path.write_bytes(test_data)

        audio = Audio(path=audio_path)
        content = audio.to_audio_content(mime_type="audio/custom")

        assert content.type == "audio"
        assert content.mime_type == "audio/custom"
        assert content.data == base64.b64encode(test_data).decode()


class TestFile:
    def test_file_initialization_with_path(self):
        """Test file initialization with a path."""
        # Mock test - we're not actually going to read a file
        file = File(path="test.txt")
        assert file.path is not None
        assert file.data is None
        assert file._mime_type == "text/plain"

    def test_file_path_expansion_with_tilde(self):
        """Test that ~ is expanded to the user's home directory."""
        file = File(path="~/test.txt")
        assert file.path is not None
        assert not str(file.path).startswith("~")
        assert str(file.path).startswith(os.path.expanduser("~"))

    def test_file_path_expansion_with_env_var(self, monkeypatch, tmp_path):
        """Test that environment variables are expanded."""
        test_dir = tmp_path / "test_file_path"
        test_dir.mkdir()
        monkeypatch.setenv("TEST_FILE_PATH", str(test_dir))
        file = File(path="$TEST_FILE_PATH/test.txt")
        assert file.path is not None
        assert not str(file.path).startswith("$TEST_FILE_PATH")
        expected_path = test_dir / "test.txt"
        assert file.path == expected_path

    def test_file_initialization_with_data(self):
        """Test initialization with data and format."""
        test_data = b"test data"
        file = File(data=test_data, format="octet-stream")
        assert file.data == test_data
        # The format parameter should set the MIME type
        assert file._mime_type == "application/octet-stream"
        assert file._name is None
        assert file.annotations is None

    def test_file_initialization_with_format(self):
        """Test file initialization with a specific format."""
        file = File(data=b"test", format="pdf")
        assert file._mime_type == "application/pdf"

    @pytest.mark.parametrize(
        ("fmt", "mime_type"),
        [
            ("csv", "text/csv"),
            ("HTML", "text/html"),
            ("htm", "text/html"),
            ("md", "text/markdown"),
            ("markdown", "text/markdown"),
            ("txt", "text/plain"),
            ("pdf", "application/pdf"),
        ],
    )
    def test_mime_type_from_format(self, fmt, mime_type):
        """Text format aliases map to their canonical text/* MIME types."""
        file = File(data=b"a,b", format=fmt)
        assert file._mime_type == mime_type

    def test_text_format_is_sent_as_text(self):
        """A text/* format is embedded as text, not a base64 blob."""
        file = File(data=b"a,b\n1,2\n", format="csv")
        resource = file.to_resource_content().resource
        assert isinstance(resource, TextResourceContents)
        assert resource.mime_type == "text/csv"
        assert resource.text == "a,b\n1,2\n"

    def test_file_initialization_with_name(self):
        """Test file initialization with a custom name."""
        file = File(data=b"test", name="custom")
        assert file._name == "custom"

    def test_missing_data_and_path_raises_error(self):
        """Test that error is raised when neither path nor data is provided."""
        with pytest.raises(ValueError, match="Either path or data must be provided"):
            File()

    def test_both_data_and_path_raises_error(self):
        """Test that error is raised when both path and data are provided."""
        with pytest.raises(
            ValueError, match="Only one of path or data can be provided"
        ):
            File(path="test.txt", data=b"test")

    def test_get_mime_type_from_path(self, tmp_path):
        """Test MIME type detection from file extension."""
        file_path = tmp_path / "test.txt"
        file_path.write_text(
            "test content"
        )  # Need to write content for MIME type detection
        file = File(path=file_path)
        # The MIME type should be detected from the .txt extension
        assert file._mime_type == "text/plain"

    def test_to_resource_content_with_path(self, tmp_path):
        """Test conversion to ResourceContent with path."""
        file_path = tmp_path / "test.txt"
        test_data = b"test file data"
        file_path.write_bytes(test_data)

        file = File(path=file_path)
        resource = file.to_resource_content()

        assert resource.type == "resource"
        assert resource.resource.mime_type == "text/plain"
        # Convert both to strings for comparison
        assert str(resource.resource.uri) == file_path.resolve().as_uri()
        if isinstance(resource.resource, BlobResourceContents):
            assert resource.resource.blob == base64.b64encode(test_data).decode()

    def test_to_resource_content_with_data(self):
        """Test conversion to ResourceContent with data."""
        test_data = b"test file data"
        file = File(data=test_data, format="pdf")
        resource = file.to_resource_content()

        assert resource.type == "resource"
        assert resource.resource.mime_type == "application/pdf"
        # Convert URI to string for comparison
        assert str(resource.resource.uri) == "file:///resource.pdf"
        if isinstance(resource.resource, BlobResourceContents):
            assert resource.resource.blob == base64.b64encode(test_data).decode()

    def test_to_resource_content_with_data_and_name_without_extension(self):
        """Test data-backed File URI with a custom name that needs an extension."""
        file = File(data=b"test file data", format="pdf", name="report")
        resource = file.to_resource_content()

        assert resource.resource.mime_type == "application/pdf"
        assert str(resource.resource.uri) == "file:///report.pdf"

    def test_to_resource_content_with_data_preserves_name_extension(self):
        """Test data-backed File URI preserves a custom name with an extension."""
        file = File(data=b"test file data", format="pdf", name="report.pdf")
        resource = file.to_resource_content()

        assert resource.resource.mime_type == "application/pdf"
        assert str(resource.resource.uri) == "file:///report.pdf"

    @pytest.mark.parametrize(
        ("kwargs", "expected_uri"),
        [
            (dict(format="txt"), "file:///resource.txt"),
            (dict(format="md"), "file:///resource.md"),
            (dict(format="md", name="README"), "file:///README.md"),
            (dict(format="TXT"), "file:///resource.txt"),
        ],
    )
    def test_to_resource_content_extension_follows_format(self, kwargs, expected_uri):
        """The URI extension comes from `format`, not the MIME subtype."""
        file = File(data=b"hello", **kwargs)
        resource = file.to_resource_content()

        assert str(resource.resource.uri) == expected_uri

    @pytest.mark.parametrize(
        ("name", "expected_uri"),
        [
            ("report#draft.pdf", "file:///report%23draft.pdf"),
            ("report?draft.pdf", "file:///report%3Fdraft.pdf"),
            ("report%20draft.pdf", "file:///report%2520draft.pdf"),
            ("report#draft", "file:///report%23draft.pdf"),
            ("report draft.pdf", "file:///report%20draft.pdf"),
            ("rΓ©sumΓ©.pdf", "file:///r%C3%A9sum%C3%A9.pdf"),
            ("reports/report.pdf", "file:///reports/report.pdf"),
        ],
    )
    def test_to_resource_content_encodes_name(self, name: str, expected_uri: str):
        file = File(data=b"report data", format="pdf", name=name)

        resource = file.to_resource_content()

        assert resource.resource.uri == expected_uri

    def test_to_resource_content_with_text_data(self):
        """Test conversion to ResourceContent with text data (TextResourceContents)."""
        test_data = b"hello world"
        file = File(data=test_data, format="plain")
        resource = file.to_resource_content()
        assert resource.type == "resource"
        # Should be TextResourceContents for text/plain
        assert isinstance(resource.resource, TextResourceContents)
        assert resource.resource.mime_type == "text/plain"
        assert resource.resource.text == "hello world"

    def test_to_resource_content_error(self, monkeypatch):
        """Test error case in to_resource_content."""
        file = File(data=b"test")
        monkeypatch.setattr(file, "path", None)
        monkeypatch.setattr(file, "data", None)

        with pytest.raises(ValueError, match="No resource data available"):
            file.to_resource_content()

    def test_to_resource_content_with_override_mime_type(self, tmp_path):
        """Test conversion to ResourceContent with override MIME type."""
        file_path = tmp_path / "test.txt"
        test_data = b"test file data"
        file_path.write_bytes(test_data)

        file = File(path=file_path)
        resource = file.to_resource_content(mime_type="application/custom")

        assert resource.resource.mime_type == "application/custom"


class TestReplaceType:
    @pytest.mark.parametrize(
        "input,type_map,expected",
        [
            (int, {}, int),
            (int, {int: str}, str),
            (int, {int: int}, int),
            (int, {int: float, bool: str}, float),
            (bool, {int: float, bool: str}, str),
            (int, {int: list[int]}, list[int]),
            (list[int], {int: str}, list[str]),
            (list[int], {int: list[str]}, list[list[str]]),
            (
                list[int],
                {int: float, list[int]: bool},
                bool,
            ),  # list[int] will match before int
            (list[int | bool], {int: str}, list[str | bool]),
            (list[list[int]], {int: str}, list[list[str]]),
        ],
    )
    def test_replace_type(self, input, type_map, expected):
        """Test replacing a type with another type."""
        assert replace_type(input, type_map) == expected


class TestCreateFunctionWithoutParams:
    """Test create_function_without_params properly removes parameters from both annotations and signature."""

    def test_removes_params_from_both_annotations_and_signature(self):
        """Test that excluded parameters are removed from __annotations__ AND __signature__."""
        import inspect

        def original_func(ctx: str, query: str, limit: int = 10) -> list[str]:
            return []

        new_func = create_function_without_params(original_func, ["ctx"])

        # Verify removal from annotations
        assert "ctx" not in new_func.__annotations__
        assert "query" in new_func.__annotations__
        assert "limit" in new_func.__annotations__

        # Verify removal from signature (regression test for #2562)
        sig = inspect.signature(new_func)
        assert "ctx" not in sig.parameters
        assert "query" in sig.parameters
        assert "limit" in sig.parameters

    def test_preserves_return_annotation_in_signature(self):
        """Test that return annotation is preserved in both annotations and signature."""
        import inspect

        def original_func(ctx: str, value: int) -> dict[str, int]:
            return {}

        new_func = create_function_without_params(original_func, ["ctx"])

        sig = inspect.signature(new_func)
        assert sig.return_annotation == dict[str, int]
        assert new_func.__annotations__["return"] == dict[str, int]

    def test_pydantic_typeadapter_compatibility(self):
        """Test that modified function works with Pydantic TypeAdapter (regression test for #2562)."""
        from pydantic import BaseModel

        class Result(BaseModel):
            name: str

        def tool_function(ctx: str, search_query: str, limit: int = 10) -> list[Result]:
            return []

        # Remove context parameter (what FastMCP does internally)
        new_func = create_function_without_params(tool_function, ["ctx"])

        # This raised KeyError: 'ctx' before the fix
        adapter = get_cached_typeadapter(new_func)
        schema = adapter.json_schema()

        # Verify schema excludes the removed parameter
        assert "properties" in schema
        assert "ctx" not in schema["properties"]
        assert "search_query" in schema["properties"]
        assert "limit" in schema["properties"]

    def test_multiple_excluded_parameters(self):
        """Test excluding multiple parameters simultaneously."""
        import inspect

        def func(ctx: str, session: int, query: str, limit: int = 5) -> str:
            return ""

        new_func = create_function_without_params(func, ["ctx", "session"])

        sig = inspect.signature(new_func)

        # Both excluded params should be removed
        assert "ctx" not in sig.parameters
        assert "session" not in sig.parameters
        assert "ctx" not in new_func.__annotations__
        assert "session" not in new_func.__annotations__

        # Non-excluded params should remain
        assert "query" in sig.parameters
        assert "limit" in sig.parameters


class TestAnnotationStringDescriptions:
    """Test the new functionality for string descriptions in Annotated types."""

    def test_get_cached_typeadapter_with_string_descriptions(self):
        """Test TypeAdapter creation with string descriptions."""

        def func(name: Annotated[str, "The user's name"]) -> str:
            return f"Hello {name}"

        adapter = get_cached_typeadapter(func)
        schema = adapter.json_schema()

        # Should have description in schema
        assert "properties" in schema
        assert "name" in schema["properties"]
        assert schema["properties"]["name"]["description"] == "The user's name"

    def test_multiple_string_annotations(self):
        """Test function with multiple string-annotated parameters."""

        def func(
            name: Annotated[str, "User's name"],
            email: Annotated[str, "User's email"],
            age: int,
        ) -> str:
            return f"{name} ({email}) is {age}"

        adapter = get_cached_typeadapter(func)
        schema = adapter.json_schema()

        # Both annotated parameters should have descriptions
        assert schema["properties"]["name"]["description"] == "User's name"
        assert schema["properties"]["email"]["description"] == "User's email"
        # Non-annotated parameter should not have description
        assert "description" not in schema["properties"]["age"]

    def test_annotated_with_more_than_string_unchanged(self):
        """Test that Annotated with more than just a string is unchanged."""

        def func(name: Annotated[str, "desc", "extra"]) -> str:
            return f"Hello {name}"

        adapter = get_cached_typeadapter(func)
        schema = adapter.json_schema()

        # Should not have description since it's not exactly length 2
        assert "description" not in schema["properties"]["name"]

    def test_annotated_with_non_string_unchanged(self):
        """Test that Annotated with non-string second arg is unchanged."""

        def func(name: Annotated[str, 42]) -> str:
            return f"Hello {name}"

        adapter = get_cached_typeadapter(func)
        schema = adapter.json_schema()

        # Should not have description since second arg is not string
        assert "description" not in schema["properties"]["name"]

    def test_existing_field_unchanged(self):
        """Test that existing Field annotations are unchanged."""

        def func(name: Annotated[str, Field(description="Field desc")]) -> str:
            return f"Hello {name}"

        adapter = get_cached_typeadapter(func)
        schema = adapter.json_schema()

        # Should keep the Field description
        assert schema["properties"]["name"]["description"] == "Field desc"

    def test_kwonly_defaults_preserved_when_annotations_are_processed(self):
        """Keyword-only defaults should survive function cloning during annotation processing."""

        def func(*, limit: Annotated[int, "Maximum number of results"] = 5) -> int:
            return limit

        adapter = get_cached_typeadapter(func)
        schema = adapter.json_schema()

        assert "required" not in schema
        assert schema["properties"]["limit"]["default"] == 5
        assert (
            schema["properties"]["limit"]["description"] == "Maximum number of results"
        )

        validated = adapter.validate_python({})
        assert validated == 5