data class ToolErrorConfig(val maxRetryAttempts: Int = 3, val baseRetryDelayMs: Long = 1000, val maxRetryDelayMs: Long = 30000, val retryStrategy: RetryStrategy = RetryStrategy.EXPONENTIAL_JITTER, val retryOnResourceErrors: Boolean = true, val retryOnUnknownErrors: Boolean = false, val maxHistorySize: Int = 100, val circuitBreakerConfig: CircuitBreakerConfig = CircuitBreakerConfig())

Configuration for tool error handling behavior.

ToolErrorDecision

sealed class ToolErrorDecision

Represents a decision on how to handle a tool execution error.

ToolErrorHandler

class ToolErrorHandler(config: ToolErrorConfig = ToolErrorConfig())

Comprehensive error handling and recovery system for tool execution.

ToolErrorStats

data class ToolErrorStats(val toolName: String, val totalAttempts: Int, val recentFailures: Int, val circuitBreakerState: CircuitBreakerState, val lastErrorTime: Instant?)

Comprehensive statistics about tool execution errors and performance.

ToolExecutionAttempt

data class ToolExecutionAttempt(val toolCall: ToolCall, val error: Throwable, val attempt: Int, val timestamp: Instant)

Record of a single tool execution attempt.

ToolExecutionContext

data class ToolExecutionContext(val toolCall: ToolCall, val threadId: String? = null, val runId: String? = null, val metadata: Map<String, Any> = emptyMap())

Context provided to tool executors during execution.

ToolExecutionEvent

sealed class ToolExecutionEvent

Events emitted during tool execution lifecycle.

ToolExecutionException

class ToolExecutionException(message: String, cause: Throwable? = null, val toolName: String? = null, val toolCallId: String? = null) : Exception

Exception thrown when tool execution fails in an unrecoverable way.

ToolExecutionManager

class ToolExecutionManager(toolRegistry: ToolRegistry, responseHandler: ToolResponseHandler)

Manages the complete lifecycle of tool execution.

ToolExecutionResult

data class ToolExecutionResult(val success: Boolean, val result: JsonElement? = null, val message: String? = null)

Result of a tool execution.

ToolExecutionStats

data class ToolExecutionStats(val executionCount: Long = 0, val successCount: Long = 0, val failureCount: Long = 0, val totalExecutionTimeMs: Long = 0, val averageExecutionTimeMs: Double = 0.0)

Statistics about tool execution.

ToolExecutor

interface ToolExecutor

Interface for executing tools.

ToolNetworkException

open class ToolNetworkException(message: String, cause: Throwable? = null) : Exception

Exception thrown when tool execution fails due to network issues.

ToolNotFoundException

class ToolNotFoundException(toolName: String, message: String = "Tool '") : Exception

Exception thrown when a requested tool is not found in the registry.

ToolRegistry

interface ToolRegistry

Registry for managing tool executors.

ToolRegistryBuilder

class ToolRegistryBuilder

Builder for creating and configuring a ToolRegistry.

ToolResourceException

open class ToolResourceException(message: String, cause: Throwable? = null) : Exception

Exception thrown when tool execution fails due to resource constraints.

ToolResponseHandler

interface ToolResponseHandler

Interface for sending tool responses back to agents.

ToolTimeoutException

open class ToolTimeoutException(message: String, cause: Throwable? = null) : Exception

Exception thrown when tool execution times out.

ToolValidationException

open class ToolValidationException(message: String, cause: Throwable? = null) : Exception

Exception thrown when tool call validation fails.

ToolValidationResult

data class ToolValidationResult(val isValid: Boolean, val errors: List<String> = emptyList())

Result of tool call validation.

Functions

toolRegistry

fun toolRegistry(vararg executors: ToolExecutor): ToolRegistry

Creates a new ToolRegistry with the given executors.

fun toolRegistry(builder: ToolRegistryBuilder.() -> Unit): ToolRegistry

Creates a new ToolRegistry using a builder pattern.