Package com.tnsai.coordination.auction

Class Auction

java.lang.Object

com.tnsai.coordination.auction.Auction

public final class Auction
extends Object

Multi-agent auction mechanism supporting various auction types.

Supported auction types:

• Auction.Type.ENGLISH - Ascending price, agents outbid each other
• Auction.Type.DUTCH - Descending price, first to accept wins
• Auction.Type.SEALED_BID - Single sealed bid, highest wins at bid price
• Auction.Type.VICKREY - Single sealed bid, highest wins at second-highest price

Example usage:

 AuctionResult result = Auction.builder()
     .type(Auction.Type.VICKREY)
     .task("Translate document to French")
     .bidders(List.of(agent1, agent2, agent3))
     .bidStrategy((agent, task, price, round, prev) -> {
         // Parse agent's bid from LLM response
         String response = agent.chat("Bid on: " + task + " (current: " + price + ")");
         return Double.parseDouble(response.trim());
     })
     .build()
     .execute();
 

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	Auction.Builder
static enum	Auction.Type	Supported auction types.

Method Summary

Modifier and Type	Method	Description
static Auction.Builder	builder()
AuctionResult	execute()	Executes the auction synchronously.
CompletableFuture<AuctionResult>	executeAsync()	Executes the auction asynchronously.

Methods inherited from class java.lang.Object

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

Method Details

execute

public AuctionResult execute()

Executes the auction synchronously.

executeAsync

public CompletableFuture<AuctionResult> executeAsync()

Executes the auction asynchronously.

builder

public static Auction.Builder builder()