Interface ConflictResolutionStrategy

Functional Interface:

This is a functional interface and can therefore be used as the assignment target for a lambda expression or method reference.

@FunctionalInterface
public interface ConflictResolutionStrategy

Strategy for resolving conflicts when multiple agents can fire simultaneously on the blackboard. The strategy receives the current scope state and all candidate agents that are ready to fire, and returns which one should be activated.

Field Summary

Fields

Modifier and Type	Field	Description
static final ConflictResolutionStrategy	DECLARATION_ORDER	Selects the first candidate, preserving the declaration order used in the subAgents method.

Method Summary

Modifier and Type	Method	Description
static ConflictResolutionStrategy	agentOfType(Class<?> agentType)	Returns a strategy that unconditionally selects the candidate matching agentType, or null if no candidate of that type is present.
static ConflictResolutionStrategy	agentOfType(Class<?> agentType, Predicate<AgenticScope> condition)	Returns a strategy that selects the candidate matching agentType only when condition is satisfied, or null otherwise.
static ConflictResolutionStrategy	agentWithName(String agentName)	Returns a strategy that unconditionally selects the candidate matching agentName, or null if no candidate with that name is present.
static ConflictResolutionStrategy	agentWithName(String agentName, Predicate<AgenticScope> condition)	Returns a strategy that selects the candidate matching agentName only when condition is satisfied, or null otherwise.
static ConflictResolutionStrategy	declarationOrder()	Returns a strategy that selects the first candidate in declaration order.
default ConflictResolutionStrategy	or(ConflictResolutionStrategy other)	Chains this strategy with a fallback: if this strategy returns null, the other strategy is applied instead.
AgentInstance	resolve(AgenticScope scope, List<AgentInstance> candidates)
static ConflictResolutionStrategy	selectAgent(Predicate<AgentInstance> agentFilter)	Returns a strategy that unconditionally selects the first candidate matching agentFilter, or null if no candidate matches.
static ConflictResolutionStrategy	selectAgent(Predicate<AgentInstance> agentFilter, Predicate<AgenticScope> condition)	Returns a strategy that selects the first candidate matching agentFilter only when condition is satisfied, or null otherwise.

Field Details

DECLARATION_ORDER

static final ConflictResolutionStrategy DECLARATION_ORDER

Selects the first candidate, preserving the declaration order used in the subAgents method.

Method Details

resolve

AgentInstance resolve(AgenticScope scope,
 List<AgentInstance> candidates)

declarationOrder

static ConflictResolutionStrategy declarationOrder()

Returns a strategy that selects the first candidate in declaration order. This is the default strategy used by BlackboardPlanner if no strategy is provided.

agentOfType

static ConflictResolutionStrategy agentOfType(Class<?> agentType,
 Predicate<AgenticScope> condition)

Returns a strategy that selects the candidate matching agentType only when condition is satisfied, or null otherwise. Intended to be chained with or(ConflictResolutionStrategy).

agentOfType

static ConflictResolutionStrategy agentOfType(Class<?> agentType)

Returns a strategy that unconditionally selects the candidate matching agentType, or null if no candidate of that type is present.

agentWithName

static ConflictResolutionStrategy agentWithName(String agentName,
 Predicate<AgenticScope> condition)

Returns a strategy that selects the candidate matching agentName only when condition is satisfied, or null otherwise. Intended to be chained with or(ConflictResolutionStrategy).

agentWithName

static ConflictResolutionStrategy agentWithName(String agentName)

Returns a strategy that unconditionally selects the candidate matching agentName, or null if no candidate with that name is present.

selectAgent

static ConflictResolutionStrategy selectAgent(Predicate<AgentInstance> agentFilter,
 Predicate<AgenticScope> condition)

Returns a strategy that selects the first candidate matching agentFilter only when condition is satisfied, or null otherwise. Intended to be chained with or(ConflictResolutionStrategy).

selectAgent

static ConflictResolutionStrategy selectAgent(Predicate<AgentInstance> agentFilter)

Returns a strategy that unconditionally selects the first candidate matching agentFilter, or null if no candidate matches.

or

default ConflictResolutionStrategy or(ConflictResolutionStrategy other)

Chains this strategy with a fallback: if this strategy returns null, the other strategy is applied instead.