AIToolApproval 0.4.0 API

```
public final class AIToolApproval

                    
```
What a tool call asks the person it waits for before it runs, such as "Share your location?", and how they answered.
The agent's backend writes it on the call's ai_tool_call step, which waits with status awaiting_approval, and holds the call until the person answers. Allowed, the call goes on (a client tool then awaits the device); declined, it is cancelled and never runs.

Nested Class Summary

Nested Classes
Modifier and Type	Class	Description
`public final class`	`AIToolApproval.Decision`	How the person answered. An open set: compare against the decisions you know.

Field Summary

Fields
Modifier and Type	Field	Description
`private final String`	`title`
`private final String`	`message`
`private final String`	`reason`
`private final String`	`allowTitle`
`private final String`	`declineTitle`
`private final AIToolApproval.Decision`	`decision`

Constructor Summary

Constructors
Constructor	Description
`AIToolApproval(String title, String message, String reason, String allowTitle, String declineTitle, AIToolApproval.Decision decision)`

Method Summary

Modifier and Type	Method	Description
`final String`	`getTitle()`
`final String`	`getMessage()`
`final String`	`getReason()`
`final String`	`getAllowTitle()`
`final String`	`getDeclineTitle()`
`final AIToolApproval.Decision`	`getDecision()`

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - AIToolApproval
```
AIToolApproval(String title, String message, String reason, String allowTitle, String declineTitle, AIToolApproval.Decision decision)
```
    Parameters:
    
    title - The question, such as "Share your location?".
    
    message - What allowing it shares or does, such as "Only your city is shared.
    
    reason - The agent's own words for why it wants the call, such as "to check the local weather".
    
    allowTitle - The label of the button that allows the call, or null when the agent sent none.
    
    declineTitle - The label of the button that declines it, or null when the agent sent none.
    
    decision - How the person answered, once they did.
- Method Detail
  - getTitle
```
 final String getTitle()
```
  - getMessage
```
 final String getMessage()
```
  - getReason
```
 final String getReason()
```
  - getAllowTitle
```
 final String getAllowTitle()
```
  - getDeclineTitle
```
 final String getDeclineTitle()
```
  - getDecision
```
 final AIToolApproval.Decision getDecision()
```