ReplanRequestedException

All Implemented Interfaces:

java.io.Serializable
```
public final class ReplanRequestedException
extends RuntimeException
                    
```
Exception thrown by a tool to signal that the tool loop should terminate and the agent should replan based on the updated blackboard state.
This enables tools to influence agent behavior at a higher level than just returning results. Use cases include:
- Chat routing: A routing tool classifies user intent and requests replan to switch to the appropriate handler action
- Discovery: A tool discovers that the current approach won't work and the agent should try a different plan
- State changes: A tool detects significant state changes that require the agent to reassess its goals
When caught by the tool loop:
- The loop terminates gracefully (no error)
- blackboardUpdater is made available for the caller to apply
- The caller (typically action executor) can trigger GOAP replanning
Example usage:
```
@LlmTool(description = "Routes user to appropriate handler")
fun routeUser(message: String): String {
    val intent = classifyIntent(message)
    throw ReplanRequestedException(
        reason = "Classified as $intent request",
        blackboardUpdater = { bb -> bb.addObject(intent) }
    )
}
```

Nested Class Summary

Nested Classes
Modifier and Type	Class	Description

Field Summary

Fields
Modifier and Type	Field	Description
`private final String`	`reason`
`private final BlackboardUpdater`	`blackboardUpdater`
`private final Throwable`	`cause`
`private final String`	`message`

Constructor Summary

Constructors
Constructor	Description
`ReplanRequestedException(String reason, BlackboardUpdater blackboardUpdater)`
`ReplanRequestedException(String reason)`

Enum Constant Summary

Enum Constants
Enum Constant	Description

Method Summary

Modifier and Type	Method	Description
`final String`	`getReason()`
`final BlackboardUpdater`	`getBlackboardUpdater()`

Methods inherited from class kotlin.Throwable
addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - ReplanRequestedException
```
ReplanRequestedException(String reason, BlackboardUpdater blackboardUpdater)
```
    Parameters:
    
    reason - Human-readable explanation of why replan is needed
    
    blackboardUpdater - Callback to update the blackboard before replanning
  - ReplanRequestedException
```
ReplanRequestedException(String reason)
```
    Parameters:
    
    reason - Human-readable explanation of why replan is needed
- Method Detail
  - getReason
```
 final String getReason()
```
  - getBlackboardUpdater
```
 final BlackboardUpdater getBlackboardUpdater()
```