[FEATURE] Explore helper methods to extract information from response objects

[lizradway]

Problem Statement

Add helper methods to extract information from response objects

Description:

• Currently, extracting tool use information from response objects requires navigating multiple layers
  deep into nested dictionaries, making the code verbose and harder to read.
• See [FEATURE] Tool Execution Content Not Visible in result.message - Design Question #1156 for example

Acceptance criteria:

• Design decisions documented and discussed with team
• Helper methods implemented for tool use extraction
• Documentation and examples provided
• Tests covering common use cases

Proposed Solution

No response

Use Case

See #1156 for example

Alternatives Solutions

• To be explored in design document exploration

Additional Context

No response