Class JavaMethodToolResponse

java.lang.Object

uno.anahata.asi.agi.event.BasicPropertyChangeSource

uno.anahata.asi.agi.tool.spi.AbstractToolResponse<JavaMethodToolCall>

uno.anahata.asi.agi.tool.spi.java.JavaMethodToolResponse

All Implemented Interfaces:

PropertyChangeSource, Rebindable

public class JavaMethodToolResponse
extends AbstractToolResponse<JavaMethodToolCall>

A rich POJO that captures the complete and final outcome of a single tool call. This class now follows a deferred execution model and manages the thread-local context for Java tool execution.

Author:

anahata-gemini-pro-2.5

Field Summary

Fields

Modifier and Type	Field	Description
private static final ThreadLocal<JavaMethodToolResponse>	current	A thread-local storage for the currently executing Java tool response.
private Throwable	exception	The raw exception thrown during execution, for debugging and session serialization.
private AtomicBoolean	executing	Guard to ensure only one thread can execute this response at a time.

Fields inherited from class BasicPropertyChangeSource

propertyChangeSupport

Constructor Summary

Constructors

Constructor	Description
JavaMethodToolResponse(@NonNull JavaMethodToolCall call)	Constructs a new JavaMethodToolResponse for a specific call.

Method Summary

Modifier and Type	Method	Description
void	execute()	Executes the tool logic.
static JavaMethodToolResponse	getCurrent()	Gets the tool response associated with the current thread.
void	rebind()	Re-initializes the transient PropertyChangeSupport after deserialization.
static void	setCurrent(JavaMethodToolResponse response)	Sets the tool response for the current thread.
void	stop()	Stops the tool execution if it is currently running.

Methods inherited from class AbstractToolResponse

addAttachment, addError, addError, addLog, asText, clearLogs, decline, fail, fail, getAgi, getAttachments, getExecutedArgs, getTokenCount, getToolName, removeAttachment, removeLogsIf, resetTokenCount, setErrors, setExpanded, setResult, setStatus, setThread

Methods inherited from class BasicPropertyChangeSource

addPropertyChangeListener, addPropertyChangeListener, removePropertyChangeListener, removePropertyChangeListener

Methods inherited from class Object

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

Methods inherited from interface PropertyChangeSource

getPropertyChangeSupport

Field Details

current

private static final ThreadLocal<JavaMethodToolResponse> current

A thread-local storage for the currently executing Java tool response. This allows tool logic to access its own context without explicit parameter passing.

exception

private transient Throwable exception

The raw exception thrown during execution, for debugging and session serialization. Ignored during schema generation as it's an internal detail.

executing

private transient AtomicBoolean executing

Guard to ensure only one thread can execute this response at a time.

Constructor Details

JavaMethodToolResponse

public JavaMethodToolResponse(@NonNull
 @NonNull JavaMethodToolCall call)

Constructs a new JavaMethodToolResponse for a specific call.

Parameters:

call - The originating tool call.

Method Details

getCurrent

public static JavaMethodToolResponse getCurrent()

Gets the tool response associated with the current thread.

Returns:

The active tool response, or null if none is active.

setCurrent

public static void setCurrent(JavaMethodToolResponse response)

Sets the tool response for the current thread.

Parameters:

response - The response to set, or null to clear the context.

rebind

public void rebind()

Re-initializes the transient PropertyChangeSupport after deserialization.

Specified by:

rebind in interface Rebindable

Overrides:

rebind in class AbstractToolResponse<JavaMethodToolCall>

execute

public void execute()

Description copied from class: AbstractToolResponse

Executes the tool logic. This method is responsible for populating the status, result, errors, and executionTimeMillis fields.

Specified by:

execute in class AbstractToolResponse<JavaMethodToolCall>

stop

public void stop()

Description copied from class: AbstractToolResponse

Stops the tool execution if it is currently running.

Specified by:

stop in class AbstractToolResponse<JavaMethodToolCall>