Package com.tnsai.coordination.groups.coalition

Enum Class CoalitionFormation

java.lang.Object

java.lang.Enum<CoalitionFormation>

com.tnsai.coordination.groups.coalition.CoalitionFormation

All Implemented Interfaces:

Serializable, Comparable<CoalitionFormation>, Constable

public enum CoalitionFormation
extends Enum<CoalitionFormation>

Strategy for forming coalitions.

CoalitionFormation determines how agents are selected or recruited for participation in a coalition.

Formation Types

• VOLUNTARY - Agents choose to participate
• CAPABILITY_BASED - Selection by required capabilities
• REPUTATION_BASED - Selection by past performance
• AUCTION - Agents bid for participation
• RANDOM - Random selection from pool

Nested Class Summary

Nested classes/interfaces inherited from class java.lang.Enum

Enum.EnumDesc<E extends Enum<E>>

Enum Constant Summary

Enum Constants

Enum Constant	Description
AUCTION	Auction-based formation.
CAPABILITY_BASED	Capability-based formation.
INVITATION	Invitation-based formation.
MERIT_BASED	Merit-based formation.
RANDOM	Random formation.
REPUTATION_BASED	Reputation-based formation.
VOLUNTARY	Voluntary formation.

Method Summary

Modifier and Type	Method	Description
String	getDescription()	Gets formation description.
boolean	requiresSelection()	Checks if this formation requires active selection.
List<com.tnsai.agents.Agent>	selectMembers(List<com.tnsai.agents.Agent> candidates, String goal, int minMembers, int maxMembers)	Selects agents for coalition based on formation strategy.
static CoalitionFormation	valueOf(String name)	Returns the enum constant of this class with the specified name.
static CoalitionFormation[]	values()	Returns an array containing the constants of this enum class, in the order they are declared.

Methods inherited from class java.lang.Enum

compareTo, describeConstable, equals, getDeclaringClass, hashCode, name, ordinal, toString, valueOf

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Enum Constant Details

VOLUNTARY

public static final CoalitionFormation VOLUNTARY

Voluntary formation.

Agents are presented with the goal and decide whether to participate. Coalition forms if minimum threshold is met.

CAPABILITY_BASED

public static final CoalitionFormation CAPABILITY_BASED

Capability-based formation.

Agents are selected based on their capabilities matching the goal requirements.

REPUTATION_BASED

public static final CoalitionFormation REPUTATION_BASED

Reputation-based formation.

Agents with higher reputation/past success are preferred for coalition membership.

AUCTION

public static final CoalitionFormation AUCTION

Auction-based formation.

Agents bid for participation rights. Highest bidders (or lowest asking price) are selected.

RANDOM

public static final CoalitionFormation RANDOM

Random formation.

Agents are randomly selected from available pool. Simple but fair approach.

INVITATION

public static final CoalitionFormation INVITATION

Invitation-based formation.

Specific agents are invited by a coordinator. Invited agents can accept or decline.

MERIT_BASED

public static final CoalitionFormation MERIT_BASED

Merit-based formation.

Combines capability and reputation scores for optimal team composition.

Method Details

values

public static CoalitionFormation[] values()

Returns an array containing the constants of this enum class, in the order they are declared.

Returns:

an array containing the constants of this enum class, in the order they are declared

valueOf

public static CoalitionFormation valueOf(String name)

Returns the enum constant of this class with the specified name. The string must match exactly an identifier used to declare an enum constant in this class. (Extraneous whitespace characters are not permitted.)

Parameters:

name - the name of the enum constant to be returned.

Returns:

the enum constant with the specified name

Throws:

IllegalArgumentException - if this enum class has no constant with the specified name

NullPointerException - if the argument is null

getDescription

public String getDescription()

Gets formation description.

Returns:

description

requiresSelection

public boolean requiresSelection()

Checks if this formation requires active selection.

Returns:

true if selection-based

selectMembers

public List<com.tnsai.agents.Agent> selectMembers(List<com.tnsai.agents.Agent> candidates,
 String goal,
 int minMembers,
 int maxMembers)

Selects agents for coalition based on formation strategy.

Parameters:

candidates - available agents

goal - coalition goal

minMembers - minimum required

maxMembers - maximum allowed

Returns:

selected agents