Class Terminals

java.lang.Object

uno.anahata.asi.agi.tool.ToolContext

uno.anahata.asi.agi.tool.AnahataToolkit

uno.anahata.asi.intellij.tools.terminal.Terminals

All Implemented Interfaces:

ContextProvider, PropertyChangeSource, Rebindable

public class Terminals
extends AnahataToolkit

A toolkit for opening, driving and closing IntelliJ terminal tabs.

This is the IntelliJ port of the NetBeans NbTerminal. Where NetBeans crawls the dlight terminal container and reflects into a private Term.fireChars, IntelliJ offers first-class APIs: TerminalToolWindowManager.createLocalShellWidget(String, String) to open a shell and ShellTerminalWidget.executeCommand(String) to run a command. Opened widgets are tracked by identity id in a transient map so subsequent calls can address them; the map is rebuilt on session activation (terminals do not survive a restart).

Author:

anahata

Field Summary

Fields

Modifier and Type	Field	Description
private Map<Long, org.jetbrains.plugins.terminal.ShellTerminalWidget>	widgets	Identity-keyed registry of terminals opened by this toolkit.

Fields inherited from class AnahataToolkit

childrenProviders, propertyChangeSupport

Fields inherited from class ToolContext

toolkit

Constructor Summary

Constructors

Constructor	Description
Terminals()	Constructs the Terminals toolkit (instantiated reflectively via its public no-arg constructor).

Method Summary

Modifier and Type	Method	Description
String	closeTerminal(long terminalId)	Closes a tracked terminal tab.
private com.intellij.openapi.project.Project	firstOpenProject()	Returns the first open project, which hosts newly created terminals.
long	openLocalTerminal(String title, String workingDirectory)	Opens a new local terminal tab and returns its tracking id.
void	rebind()	Rebinds the toolkit after deserialization.
String	typeCommand(long terminalId, String command)	Types a command into a tracked terminal and executes it.

Methods inherited from class AnahataToolkit

getChildrenProviders, getDescription, getId, getName, getParentProvider, getPropertyChangeSupport, initialize, isEffectivelyProviding, postActivate

Methods inherited from class ToolContext

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

Methods inherited from class Object

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

Methods inherited from interface ContextProvider

getAgi, getContextPosition, getFlattenedHierarchy, getFullyQualifiedId, getHeader, getIconId, getInstructionsTokenCount, getRagTokenCount, getSystemInstructions, isProviding, populateMessage, setParentProvider, setProviding

Field Details

widgets

private transient Map<Long, org.jetbrains.plugins.terminal.ShellTerminalWidget> widgets

Identity-keyed registry of terminals opened by this toolkit. Transient: terminals are live UI resources that do not survive serialization.

Constructor Details

Terminals

public Terminals()

Constructs the Terminals toolkit (instantiated reflectively via its public no-arg constructor).

Method Details

rebind

public void rebind()

Rebinds the toolkit after deserialization.

This method is called by the framework during session activation to restore transient state, reconnect listeners, or refresh cached project instances. It ensures the propertyChangeSupport is re-initialized.

Re-initializes the transient terminal registry after deserialization.

Specified by:

rebind in interface Rebindable

Overrides:

rebind in class AnahataToolkit

openLocalTerminal

public long openLocalTerminal(String title,
 String workingDirectory)
                       throws AgiToolException

Opens a new local terminal tab and returns its tracking id.

Parameters:

title - the tab title, or null for the default.

workingDirectory - the initial working directory, or null for the default.

Returns:

the identity id used to address this terminal in later calls.

Throws:

AgiToolException - if no project is open.

typeCommand

public String typeCommand(long terminalId,
 String command)
                   throws AgiToolException

Types a command into a tracked terminal and executes it.

Parameters:

terminalId - the id returned by openLocalTerminal(String, String).

command - the command line to execute.

Returns:

a confirmation message.

Throws:

AgiToolException - if the terminal id is unknown or the command cannot be written.

closeTerminal

public String closeTerminal(long terminalId)
                     throws AgiToolException

Closes a tracked terminal tab.

Parameters:

terminalId - the id returned by openLocalTerminal(String, String).

Returns:

a confirmation message.

Throws:

AgiToolException - if the terminal id is unknown.

firstOpenProject

private com.intellij.openapi.project.Project firstOpenProject()
                                                       throws AgiToolException

Returns the first open project, which hosts newly created terminals.

Returns:

the first open project.

Throws:

AgiToolException - if no project is open.