ConditionalAwaitingTool

All Implemented Interfaces:

com.embabel.agent.api.tool.DelegatingTool , com.embabel.agent.api.tool.Tool , com.embabel.agent.api.tool.ToolInfo
```
public final class ConditionalAwaitingTool
 implements DelegatingTool
                    
```
Tool decorator that conditionally requires awaiting before execution.
The decider inspects the input context and returns either:
- An Awaitable to pause execution and wait for user input
- null to proceed with normal tool execution

Nested Class Summary

Nested Classes
Modifier and Type	Class	Description

Field Summary

Fields
Modifier and Type	Field	Description
`private final Tool.Definition`	`definition`
`private final Tool.Metadata`	`metadata`
`private final Tool`	`delegate`

Constructor Summary

Constructors
Constructor	Description
`ConditionalAwaitingTool(Tool delegate, AwaitDecider decider)`

Enum Constant Summary

Enum Constants
Enum Constant	Description

Method Summary

Modifier and Type	Method	Description
`Tool.Definition`	`getDefinition()`	Tool definition for LLM
`Tool.Metadata`	`getMetadata()`	Optional metadata
`Tool`	`getDelegate()`
`Tool.Result`	`call(String input)`	Execute the tool with JSON input.

Methods inherited from class com.embabel.agent.api.tool.Tool
withDescription, withName, withNote
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - ConditionalAwaitingTool
```
ConditionalAwaitingTool(Tool delegate, AwaitDecider decider)
```
    Parameters:
    
    delegate - The tool to wrap
    
    decider - Function that decides whether to await based on input context
- Method Detail
  - getDefinition
```
 Tool.Definition getDefinition()
```
    Tool definition for LLM
  - getMetadata
```
 Tool.Metadata getMetadata()
```
    Optional metadata
  - getDelegate
```
 Tool getDelegate()
```
  - call
```
 Tool.Result call(String input)
```
    Execute the tool with JSON input.
    
    Parameters:
    
    input - JSON string matching inputSchema
    
    Returns:
    
    Result to send back to LLM