Module agentforge4j.runtime

Package com.agentforge4j.runtime.tool

Class ToolInvocationCommandHandler

java.lang.Object

com.agentforge4j.runtime.tool.ToolInvocationCommandHandler

All Implemented Interfaces:

CommandHandler<ToolInvocationCommand>

public final class ToolInvocationCommandHandler
extends Object
implements CommandHandler<ToolInvocationCommand>

Dispatches a ToolInvocationCommand through the ToolExecutionService chokepoint. On an allowed, executed call it writes the result into context via the shared ToolResultApplier and continues; on approval-pending it suspends the run in WorkflowStatus.AWAITING_TOOL_APPROVAL; on a policy denial or a failure (after the service's retries) it suspends in WorkflowStatus.AWAITING_TOOL_DECISION for an operator continue/retry decision (the service has already persisted the pending row and audited the outcome).

Constructor Summary

Constructors

Constructor	Description
ToolInvocationCommandHandler(ToolExecutionService toolExecutionService, ToolResultApplier toolResultApplier, Clock clock)	Creates the handler over the execution chokepoint.

Method Summary

Modifier and Type	Method	Description
CommandApplicationResult	apply(ToolInvocationCommand cmd, CommandApplicationRequest request)	Applies state changes for llmCommand using request.
Class<ToolInvocationCommand>	getCommandClass()	Command type this handler applies; used as the map key in CommandApplier.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

ToolInvocationCommandHandler

public ToolInvocationCommandHandler(ToolExecutionService toolExecutionService,
 ToolResultApplier toolResultApplier,
 Clock clock)

Creates the handler over the execution chokepoint.

Parameters:

toolExecutionService - the execution chokepoint

toolResultApplier - shared result-to-state routine

clock - clock for the approval-suspend timestamp

Method Details

getCommandClass

public Class<ToolInvocationCommand> getCommandClass()

Description copied from interface: CommandHandler

Command type this handler applies; used as the map key in CommandApplier.

Specified by:

getCommandClass in interface CommandHandler<ToolInvocationCommand>

Returns:

non-null command class token

apply

public CommandApplicationResult apply(ToolInvocationCommand cmd,
 CommandApplicationRequest request)

Description copied from interface: CommandHandler

Applies state changes for llmCommand using request.

Specified by:

apply in interface CommandHandler<ToolInvocationCommand>

Parameters:

cmd - parsed command instance

request - mutable state bundle for the application pass

Returns:

control-flow signal after this command