Class DesktopToolContext

java.lang.Object

uno.anahata.asi.agi.tool.ToolContext

uno.anahata.asi.swing.toolkit.DesktopToolContext

Direct Known Subclasses:

DesktopAgiTool

public class DesktopToolContext
extends ToolContext

An advanced execution context that bridges the gap between background tool execution and the Swing Event Dispatch Thread (EDT) or the JavaFX Application Thread.

This class provides the critical infrastructure for Context Propagation. Since the AI toolchain relies on ThreadLocal state for logging and attachments, moving execution to the EDT would normally break these links. DesktopToolContext solves this by capturing the state and re-applying it within the EDT task scope.

Author:

anahata

Field Summary

Fields inherited from class ToolContext

toolkit

Modifier and Type	Field	Description
protected JavaObjectToolkit	toolkit	The toolkit instance that owns this context.

Constructor Summary

Constructors

Constructor	Description
DesktopToolContext()

Method Summary

Modifier and Type	Method	Description
AgiPanel	getAgiPanel()	Convenience method to get the AgiPanel for this Agi from the java tool.
void	runInEdt(Runnable runnable)	Executes a task on the EDT in a non-blocking manner while maintaining full context awareness.
void	runInEdtAndWait(Runnable runnable)	Executes a task on the EDT and blocks the current thread until the task is complete, maintaining full context awareness throughout.

Methods inherited from class ToolContext

addAttachment, addAttachment, addAttachment, addAttachment, error, error, error, getAgi, getApplicationMap, getAsiContainer, getAsiContainerMap, getCall, getExecutorService, getModelId, getModelMessage, getResourceManager, getResponse, getSessionMap, getThreadSafeLogger, getTool, getToolContext, getToolkit, getToolManager, getTurnMap, isToolExecution, log, peekResponse, runAsync

Modifier and Type	Method	Description
void	addAttachment(byte[] data, String mimeType)	Attaches a binary blob to the current tool's response.
void	addAttachment(byte[] data, String mimeType, Path sourcePath)	Attaches a binary blob to the current tool's response with source file path traceability.
void	addAttachment(File file)	Convenience method to attach a file to the current tool's response.
void	addAttachment(Path path)	Convenience method to attach a file from a Path to the current tool's response.
void	error(String message)	Adds an error message to the current tool's response.
void	error(String message, Throwable t)	Adds an error message and exception stack trace to the current tool's response.
void	error(Throwable t)	Adds an exceptions stack trace to the current tool's response.
Agi	getAgi()	Convenience method to get the parent agi container for the current execution.
Map	getApplicationMap()	Gets a static, application-scoped map for sharing objects across all containers in the current JVM.
AbstractAsiContainer	getAsiContainer()	Gets the current ASI container hosting this Agi container is running.
Map	getAsiContainerMap()	Gets a map for sharing objects across all sessions within the current ASI container.
JavaMethodToolCall	getCall()	Convenience method to get the current tool call that initiated this execution.
ExecutorService	getExecutorService()	Convenience method to get the executor service for the current agi session.
String	getModelId()	The id of model that is executing the tool.
AbstractModelMessage	getModelMessage()	The id of model that is executing the tool.
ResourceManager	getResourceManager()	Convenience method to get the application's ResourceManager.
JavaMethodToolResponse	getResponse()	Gets the current tool response from the thread-local context.
Map	getSessionMap()	Gets a shared map for storing state across turns within the current agi session.
Consumer<String>	getThreadSafeLogger()	Gets a thread-safe logging consumer that automatically propagates the current tool execution context whenever a message is logged.
JavaMethodTool	getTool()	Convenience method to get the metadata for the tool currently being executed.
ToolContext	getToolContext()	Returns a thread-safe snapshot of this context.
<T> T	getToolkit(Class<T> toolkitClass)	Retrieves the singleton instance of a registered toolkit class.
ToolManager	getToolManager()	Convenience method to get the application's global ToolManager.
Map	getTurnMap()	Gets a shared map for storing state across turns within the current agi session.
boolean	isToolExecution()	Checks if the current thread or this context instance is associated with an active tool execution.
void	log(String message)	Adds a standard log message to the current tool's response.
protected JavaMethodToolResponse	peekResponse()	Internal helper to retrieve the response if it exists, without throwing an exception.
void	runAsync(String taskName, Runnable task)	Executes a task asynchronously in the session's executor service, automatically propagating the current tool execution context to the background thread.

Methods inherited from class Object

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

Constructor Details

DesktopToolContext

public DesktopToolContext()

Method Details

getAgiPanel

@Internal(value="Gets the Swing AgiPanel for this Agi",
          requiresCapturedToolContext=false)
public AgiPanel getAgiPanel()

Convenience method to get the AgiPanel for this Agi from the java tool.

Returns:

the AgiPanel for the current Agi.

runInEdt

@Internal(value="Executes a task on the Swing EDT with automatic context propagation",
          requiresCapturedToolContext=false)
public void runInEdt(Runnable runnable)

Executes a task on the EDT in a non-blocking manner while maintaining full context awareness.

This is the preferred way for tools to perform UI updates without freezing the AI execution thread.

Parameters:

runnable - The UI-bound task to execute.

runInEdtAndWait

@Internal(value="Executes a task on the Swing EDT blocking until complete with automatic context propagation",
          requiresCapturedToolContext=false)
public void runInEdtAndWait(Runnable runnable)
                     throws InterruptedException,
InvocationTargetException

Executes a task on the EDT and blocks the current thread until the task is complete, maintaining full context awareness throughout.

Use this method when subsequent tool logic depends on the UI having reached a specific state (e.g., waiting for a dialog to close or a component to render).

Parameters:

runnable - The UI-bound task to execute.

Throws:

InterruptedException - if the background thread is interrupted during wait.

InvocationTargetException - if the EDT task throws an unhandled exception.