Cannot process return type annotations for pydantic types

[vikigenius]

I did a follow up experiment on this issue #134

And changed the get_location tool to have a docstring

@agent_pydantic_output_tool.tool
def get_location(ctx: RunContext[None], place_name: str) -> Location:
    """Gets the lattitude and longitude of a location.
    
    Args:
        place_name: The name of the place to get location for.

    Returns:
        The location information.
    """
    return Location(latitude=36.53, longitude=-116.93)

This causes a warning.

WARNING:griffe:<module>:7: No type or annotation for returned value 1

Is this expected?

How are the docstrings and return type annotations used by pydantic in tool call results? Is it better to convert the return type into simpler types for tools?

[vikigenius]

@samuelcolvin I see that this could be related to this issue: mkdocstrings/griffe#293

It seems like the error is happening here in griffe

            # try to retrieve the annotation from the docstring parent
            annotation = _annotation_from_parent(docstring, gen_index=2, multiple=len(block) > 1, index=index)

And because parent is a signature object

this errors out

        annotation = docstring.parent.annotation  # type: ignore[union-attr]

[vikigenius]

Since the return type annotations and docstrings is not used at all, would the solution be to somehow disable this specific warning?

Alternatively I can just stop putting the returns statement in the docstring, but that does not seem ideal.

[samuelcolvin]

weird, yes because we're not using the return type we should find a way to mute this warning or even avoid parsing that part of the function completely.

[abo-mapp]

Could it be that the @wraps annotation is missing?
cf. https://chatgpt.com/share/e/6776b1cb-5978-8012-9b2b-6668eaecb34a