Abstract typed tool that supports Human-in-the-Loop (HITL) interactions.

Before executing the main tool logic, this tool checks if human input is required via createAwaitable. If an Awaitable is returned, the tool throws AwaitableResponseException to pause execution and wait for user response.

Example usage:

data class DeleteRequest(val path: String, val force: Boolean = false)
data class DeleteResult(val deleted: Boolean, val path: String)

class ConfirmingDeleteTool : AwaitableTypedTool<DeleteRequest, DeleteResult, DeleteRequest>(
    name = "delete_file",
    description = "Delete a file with confirmation",
    inputType = DeleteRequest::class.java,
    outputType = DeleteResult::class.java,
) {
    override fun createAwaitable(input: DeleteRequest): Awaitable<DeleteRequest, *>? {
        // Only confirm for non-force deletes
        return if (!input.force) {
            ConfirmationRequest(input, "Delete ${input.path}?")
        } else null
    }

    override fun execute(input: DeleteRequest): DeleteResult {
        val success = Files.deleteIfExists(Path.of(input.path))
        return DeleteResult(deleted = success, path = input.path)
    }
}