Package com.tnsai.coordination.groups.hierarchy

Class DefaultHierarchy

java.lang.Object

com.tnsai.coordination.groups.DefaultAgentGroup

com.tnsai.coordination.groups.hierarchy.DefaultHierarchy

All Implemented Interfaces:

com.tnsai.agents.groups.AgentGroup, Hierarchy

public class DefaultHierarchy
extends DefaultAgentGroup
implements Hierarchy

Default implementation of Hierarchy.

Provides a tree-based organization structure with parent-child relationships, task delegation down the chain, and escalation up.

Constructor Summary

Constructors

Constructor	Description
DefaultHierarchy(String id, String name, String description, com.tnsai.agents.groups.GroupPolicy policy)	Creates a new DefaultHierarchy.

Method Summary

Modifier and Type	Method	Description
HierarchyResult	delegate(String task, int targetLevel)	Delegates a task down to a specific level in the hierarchy.
HierarchyResult	escalate(String task, String fromAgentId)	Escalates a task up from a given agent to their supervisor.
DelegationChain	getDelegationChain()	Returns the delegation chain history.
int	getLevel(String agentId)	Returns the depth level of an agent in the hierarchy.
List<com.tnsai.agents.Agent>	getReportingChain(String agentId)	Returns the full reporting chain from root to the given agent.
List<ReportingLine>	getReportingLines()	Returns all reporting lines in the hierarchy.
Optional<com.tnsai.agents.Agent>	getRoot()	Returns the root agent of the hierarchy.
List<com.tnsai.agents.Agent>	getSubordinates(String agentId)	Returns the direct subordinates of a given agent.
Optional<com.tnsai.agents.Agent>	getSupervisor(String agentId)	Returns the supervisor of a given agent.
void	setReportingLine(String parentId, String childId)	Sets a parent-child relationship.
void	setRoot(String agentId)	Sets the root agent of the hierarchy.
String	toString()

Methods inherited from class com.tnsai.coordination.groups.DefaultAgentGroup

addLifecycleListener, addMember, addMembershipListener, assignTask, broadcast, dissolve, electLeader, electLeader, findMembers, getDescription, getEventBus, getId, getLeader, getLifecycle, getMember, getMembers, getMembershipManager, getMetrics, getName, getPolicy, hasMember, notifyTaskComplete, notifyTaskFailed, removeLifecycleListener, removeMember, removeMembershipListener, scatter, scatter, scatterAsync, setPolicy, start, stop, stopNow

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface com.tnsai.agents.groups.AgentGroup

addLifecycleListener, addMember, addMembershipListener, assignTask, broadcast, broadcast, dissolve, electLeader, electLeader, findMembers, getDescription, getEventBus, getId, getLeader, getLifecycle, getMember, getMemberCount, getMembers, getMembershipManager, getMetrics, getName, getPolicy, hasMember, isActive, isDissolved, removeLifecycleListener, removeMember, removeMembershipListener, scatter, scatter, scatterAsync, setPolicy, start, stop, stopNow

Constructor Details

DefaultHierarchy

public DefaultHierarchy(String id,
 String name,
 String description,
 com.tnsai.agents.groups.GroupPolicy policy)

Creates a new DefaultHierarchy.

Parameters:

id - hierarchy ID

name - hierarchy name

description - hierarchy description

policy - group policy

Method Details

getRoot

public Optional<com.tnsai.agents.Agent> getRoot()

Description copied from interface: Hierarchy

Returns the root agent of the hierarchy.

Specified by:

getRoot in interface Hierarchy

Returns:

root agent

setRoot

public void setRoot(String agentId)

Sets the root agent of the hierarchy.

Parameters:

agentId - root agent ID

Throws:

IllegalArgumentException - if agent is not a member

getSupervisor

public Optional<com.tnsai.agents.Agent> getSupervisor(String agentId)

Description copied from interface: Hierarchy

Returns the supervisor of a given agent.

Specified by:

getSupervisor in interface Hierarchy

Parameters:

agentId - agent ID

Returns:

supervisor, or empty if agent is root or not found

getSubordinates

public List<com.tnsai.agents.Agent> getSubordinates(String agentId)

Description copied from interface: Hierarchy

Returns the direct subordinates of a given agent.

Specified by:

getSubordinates in interface Hierarchy

Parameters:

agentId - agent ID

Returns:

list of subordinate agents

getReportingChain

public List<com.tnsai.agents.Agent> getReportingChain(String agentId)

Description copied from interface: Hierarchy

Returns the full reporting chain from root to the given agent.

Specified by:

getReportingChain in interface Hierarchy

Parameters:

agentId - agent ID

Returns:

list of agents from root to the target (inclusive)

getReportingLines

public List<ReportingLine> getReportingLines()

Description copied from interface: Hierarchy

Returns all reporting lines in the hierarchy.

Specified by:

getReportingLines in interface Hierarchy

Returns:

list of reporting lines

getLevel

public int getLevel(String agentId)

Description copied from interface: Hierarchy

Returns the depth level of an agent in the hierarchy. Root is level 0.

Specified by:

getLevel in interface Hierarchy

Parameters:

agentId - agent ID

Returns:

level, or -1 if not found

setReportingLine

public void setReportingLine(String parentId,
 String childId)

Description copied from interface: Hierarchy

Sets a parent-child relationship.

Specified by:

setReportingLine in interface Hierarchy

Parameters:

parentId - parent agent ID

childId - child agent ID

delegate

public HierarchyResult delegate(String task,
 int targetLevel)

Description copied from interface: Hierarchy

Delegates a task down to a specific level in the hierarchy.

Specified by:

delegate in interface Hierarchy

Parameters:

task - task description

targetLevel - target hierarchy level (0=root)

Returns:

delegation result

escalate

public HierarchyResult escalate(String task,
 String fromAgentId)

Description copied from interface: Hierarchy

Escalates a task up from a given agent to their supervisor.

Specified by:

escalate in interface Hierarchy

Parameters:

task - task description

fromAgentId - agent escalating the task

Returns:

escalation result

getDelegationChain

public DelegationChain getDelegationChain()

Description copied from interface: Hierarchy

Returns the delegation chain history.

Specified by:

getDelegationChain in interface Hierarchy

Returns:

delegation chain

toString

public String toString()

Overrides:

toString in class DefaultAgentGroup