ReplanningTool

All Implemented Interfaces:

com.embabel.agent.api.tool.DelegatingTool , com.embabel.agent.api.tool.Tool , com.embabel.agent.api.tool.ToolInfo
```
public final class ReplanningTool
 implements DelegatingTool
                    
```
Tool decorator that executes the wrapped tool, adds its result to the blackboard, then throws ReplanRequestedException to terminate the tool loop and trigger replanning.
This enables patterns like:
- Chat routing: A routing tool classifies intent and triggers replan to switch handlers
- Discovery: A tool discovers information that requires a different plan
Note: This tool accesses AgentProcess via thread-local at call time, which is set by the decorator chain.

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
`ReplanningTool(Tool delegate, String reason, ReplanningToolBlackboardUpdater blackboardUpdater)`
`ReplanningTool(Tool delegate, String reason)`

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
  - ReplanningTool
```
ReplanningTool(Tool delegate, String reason, ReplanningToolBlackboardUpdater blackboardUpdater)
```
    Parameters:
    
    delegate - The tool to wrap
    
    reason - Human-readable explanation of why replan is needed
    
    blackboardUpdater - Callback to update the blackboard before replanning.
  - ReplanningTool
```
ReplanningTool(Tool delegate, String reason)
```
    Parameters:
    
    delegate - The tool to wrap
    
    reason - Human-readable explanation of why replan is needed
- 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