Author a tool

"""A minimal fictional tool: a weather forecast lookup.

Registers one tool through the ``tai42_app`` handle. The function signature becomes
the input schema and the docstring becomes the description.
"""

from tai42_contract.app import tai42_app


@tai42_app.tools.tool
def get_forecast(city: str, days: int = 1) -> dict[str, object]:
    """Return a short weather forecast for a city.

    ``city`` names the place to look up; ``days`` is how many days ahead to
    report. The return value's shape becomes the tool's output schema.
    """
    return {
        "city": city,
        "days": days,
        "summary": "clear",
        "high_c": 21,
    }

tools:
  - title: weather
    module: your_package.tools.forecast