docs(hooks): document exception property on AfterToolCallEvent

[charles-dyfis-net]

Description

Documents the exception property on AfterToolCallEvent, which provides access to the original exception when a tool raises an error. This enables hooks to distinguish between expected errors (which the model should retry) and unexpected errors (which should fail immediately).

Changes:

• Added exception to the AfterToolCallEvent properties list in the Event Properties section
• Added new "Exception Handling" subsection in Advanced Usage with a PropagateUnexpectedExceptions example hook

Related Issues

strands-agents/harness-sdk#1565

Type of Change

• Content update/revision

Checklist

• I have read the CONTRIBUTING document
• My changes follow the project's documentation style
• I have tested the documentation locally using mkdocs serve
• Links in the documentation are valid and working

---

By submitting this pull request, I confirm that you can use, modify, copy, and redistribute this contribution, under the terms of your choice.

[github-actions]

Documentation Preview Ready

Your documentation preview has been successfully deployed!

Preview URL: https://d3ehv1nix5p99z.cloudfront.net/pr-cms-482/docs/user-guide/quickstart/overview/

Updated at: 2026-03-20T13:58:45.351Z

[github-actions]

Assessment: Comment

Good documentation addition that clearly explains the exception property on AfterToolCallEvent and provides a practical example of selectively propagating unexpected exceptions.

Review Details

• Code Example: One minor issue - the Python example is missing the import statement that other HookProvider examples include
• Pattern Consistency: TypeScript placeholder and documentation structure follow established patterns

Thanks for adding this documentation! The exception handling use case is valuable for users implementing robust error handling in their agents.