Support structured content results from custom tools

[astrobot-houston]

Originally proposed by @chroxify in #161. Their description is reproduced verbatim below.

All community-submitted pull requests are automatically converted to issues (bugs) & discussions (feature requests, enhancements) where they can be triaged and prioritized. Once prioritized, a PR implementation is created automatically.

Allows custom tools to return either the existing string result or a native AgentToolResult, preserving text/image content blocks instead of forcing all custom tool output into text

---

Original implementation from #161 by @chroxify