# onToolError

open suspend fun onToolError(context: ToolContext, tool: BaseTool, args: Map<String, Any>, error: Throwable): CallbackChoice<Unit, Map<String, Any>>

Callback executed when an error occurs during a tool invocation.

Provides an opportunity to handle tool errors gracefully, potentially providing alternative responses or recovery mechanisms.

#### Return

A CallbackChoice where returning CallbackChoice.Break with a custom map intercepts the error and resolves execution using that fallback value. Returning CallbackChoice.Continue with Unit permits the error to be propagated naturally.

#### Parameters

context

The context for the current tool execution.

tool

The tool instance that encountered an error.

args

The arguments that were passed to the tool.

error

The exception that was raised.