Embabel Agent Documentation/com.embabel.agent.api.tool/ReplanningTool

ReplanningTool

class ReplanningTool constructor(val delegate: Tool, reason: String, blackboardUpdater: ReplanningToolBlackboardUpdater = ReplanningToolBlackboardUpdater { bb, content -> bb.addObject(content) }) : 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.

Parameters

delegate

The tool to wrap

reason

Human-readable explanation of why replan is needed

blackboardUpdater

Callback to update the blackboard before replanning. Receives the result content and can add objects to the blackboard. Defaults to adding the result content as a string.

Constructors

ReplanningTool

constructor(delegate: Tool, reason: String, blackboardUpdater: ReplanningToolBlackboardUpdater = ReplanningToolBlackboardUpdater { bb, content -> bb.addObject(content) })