Package com.tnsai.coordination.council

Class CouncilExecutor

java.lang.Object
com.tnsai.coordination.council.CouncilExecutor
public final class CouncilExecutor extends Object
Multi-model council deliberation executor.

Orchestrates a 3-stage pipeline inspired by Karpathy's llm-council:

  1. Stage 1 - Individual Responses: All members answer independently in parallel
  2. Stage 2 - Peer Review: Members evaluate anonymized responses and rank them
  3. Stage 3 - Chairman Synthesis: Chairman produces final answer using responses + rankings

Usage


 CouncilExecutor council = CouncilExecutor.builder()
     .members(List.of(gpt4, claude, gemini, grok))
     .chairman(gemini)
     .anonymize(true)
     .timeout(Duration.ofMinutes(5))
     .build();

 CouncilResult result = council.deliberate("How should we architect auth?");
 System.out.println(result.finalAnswer());
 result.topRanked().ifPresent(r ->
     System.out.println("Top ranked: " + r.llmName() + " (avg: " + r.averageRank() + ")"));
Since:
0.0.5
See Also:

  • Method Details

    • deliberate

      public CouncilResult deliberate(String question)
      Runs the 3-stage council deliberation.
      Parameters:
      question - the question to deliberate on
      Returns:
      the complete council result with all stages and aggregate ranking

    • builder

      public static CouncilExecutor.Builder builder()