Tool enhancements

[guillaq]

ref https://linear.app/workflowai/issue/WOR-3531/feedback-on-tool-sdk

[linear]

WOR-3531 Feedback on TOOL SDK

• avoid throwing an exception when a partial output is available -> WOR-3554
• document async tools
• allow the agent decorator to take the same parameters as the run function to provide defaults (not a priority)
• fix and test tool introspection
• add mention about minItems / maxItems and other extra json schemas in the README
• sanitize schemas: treat optional and nullable fields the same

images: list[Image] | None = None

images: list[Image] = []

• add doc about accessing a run metadata and cost
• Add import for models to the readme from workflowai import Model
• add full example for having a python script that runs. Maybe a CLI tool with a reply using typer in the examples
• add documentation about reply