Package com.tnsai.coordination

Class MultiRoundContractNet

java.lang.Object

com.tnsai.coordination.MultiRoundContractNet

public class MultiRoundContractNet
extends Object

Multi-round Contract Net Protocol (CNP) implementation.

Extends the basic CNP with multi-round negotiation support:

1. Call for Proposals (CFP) broadcast
2. Collect initial proposals
3. If best proposal not acceptable, request counter-offers
4. Repeat up to maxRounds times
5. Accept best proposal

Usage Example

 MultiRoundContractNet cnp = MultiRoundContractNet.builder()
     .manager(managerAgent)
     .contractors(List.of(agent1, agent2, agent3))
     .proposalRequester((contractor, task, round, targetScore, timeout) ->
         messaging.requestProposal(contractor, task, timeout))  // required
     .maxRounds(3)
     .improvementThreshold(0.1)  // Expect 10% improvement each round
     .acceptanceThreshold(0.5)   // Accept if score < 0.5
     .build();

 NegotiationResult result = cnp.negotiate(task);
 

Since:

0.0.2

See Also:

• Contract
• Proposal

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	MultiRoundContractNet.Builder	Builder for MultiRoundContractNet.
static interface	MultiRoundContractNet.NegotiationListener	Listener for negotiation events.
static class	MultiRoundContractNet.NegotiationResult	Result of a negotiation round.
static class	MultiRoundContractNet.NegotiationTask	Represents a task to be negotiated.
static interface	MultiRoundContractNet.ProposalEvaluator	Strategy for evaluating proposals.
static interface	MultiRoundContractNet.ProposalRequester	Source of contractor proposals.

Method Summary

Modifier and Type	Method	Description
void	addListener(MultiRoundContractNet.NegotiationListener listener)	Adds a negotiation listener.
static MultiRoundContractNet.Builder	builder()	Creates a new builder.
double	getAcceptanceThreshold()
List<com.tnsai.agents.Agent>	getContractors()
double	getImprovementThreshold()
int	getMaxRounds()
MultiRoundContractNet.NegotiationResult	negotiate(MultiRoundContractNet.NegotiationTask task)	Negotiates a contract for the given task.
CompletableFuture<MultiRoundContractNet.NegotiationResult>	negotiateAsync(MultiRoundContractNet.NegotiationTask task)	Negotiates asynchronously.
void	removeListener(MultiRoundContractNet.NegotiationListener listener)	Removes a negotiation listener.

Methods inherited from class java.lang.Object

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

Method Details

negotiate

public MultiRoundContractNet.NegotiationResult negotiate(MultiRoundContractNet.NegotiationTask task)

Negotiates a contract for the given task.

Parameters:

task - the task to negotiate

Returns:

the negotiation result

negotiateAsync

public CompletableFuture<MultiRoundContractNet.NegotiationResult> negotiateAsync(MultiRoundContractNet.NegotiationTask task)

Negotiates asynchronously.

Parameters:

task - the task to negotiate

Returns:

future with the negotiation result

addListener

public void addListener(MultiRoundContractNet.NegotiationListener listener)

Adds a negotiation listener.

removeListener

public void removeListener(MultiRoundContractNet.NegotiationListener listener)

Removes a negotiation listener.

getMaxRounds

public int getMaxRounds()

getImprovementThreshold

public double getImprovementThreshold()

getAcceptanceThreshold

public double getAcceptanceThreshold()

getContractors

public List<com.tnsai.agents.Agent> getContractors()

builder

public static MultiRoundContractNet.Builder builder()

Creates a new builder.