@wundr.io/autogen-orchestrator 1.0.3

package/dist/speaker-selection.d.ts

@@ -0,0 +1,195 @@
+/**
+ * Speaker Selection Strategies for AutoGen-style Group Chat
+ *
+ * Implements various strategies for selecting the next speaker in a
+ * multi-agent conversation, including round-robin, LLM-selected, and priority-based.
+ */
+import type { ChatParticipant, Message, ChatContext, SpeakerSelectionConfig, SpeakerSelectionResult, SpeakerSelectionStrategy, SpeakerSelectionMethod } from './types';
+/**
+ * Factory function to create speaker selection strategies
+ * @param method - The speaker selection method to use
+ * @returns The appropriate speaker selection strategy
+ */
+export declare function createSpeakerSelector(method: SpeakerSelectionMethod): SpeakerSelectionStrategy;
+/**
+ * Round-robin speaker selection - cycles through participants in order
+ */
+export declare class RoundRobinSelector implements SpeakerSelectionStrategy {
+    private currentIndex;
+    /**
+     * Select the next speaker using round-robin ordering
+     * @param participants - Available participants
+     * @param messages - Message history
+     * @param context - Current chat context
+     * @param _config - Optional configuration (unused)
+     * @returns Speaker selection result
+     */
+    selectSpeaker(participants: ChatParticipant[], messages: Message[], _context: ChatContext, _config?: SpeakerSelectionConfig): Promise<SpeakerSelectionResult>;
+    /**
+     * Reset the round-robin index
+     */
+    reset(): void;
+}
+/**
+ * Random speaker selection - randomly selects from available participants
+ */
+export declare class RandomSelector implements SpeakerSelectionStrategy {
+    /**
+     * Select the next speaker randomly
+     * @param participants - Available participants
+     * @param messages - Message history
+     * @param context - Current chat context
+     * @param config - Optional configuration
+     * @returns Speaker selection result
+     */
+    selectSpeaker(participants: ChatParticipant[], messages: Message[], context: ChatContext, config?: SpeakerSelectionConfig): Promise<SpeakerSelectionResult>;
+    /**
+     * Perform weighted random selection
+     * @param participants - Participants to select from
+     * @param weights - Weight for each participant
+     * @returns Selected participant
+     */
+    private weightedSelection;
+}
+/**
+ * LLM-based speaker selection - uses an LLM to determine the best next speaker
+ */
+export declare class LLMSelector implements SpeakerSelectionStrategy {
+    /**
+     * Select the next speaker using LLM reasoning
+     * @param participants - Available participants
+     * @param messages - Message history
+     * @param context - Current chat context
+     * @param config - Configuration including LLM settings
+     * @returns Speaker selection result
+     */
+    selectSpeaker(participants: ChatParticipant[], messages: Message[], context: ChatContext, config?: SpeakerSelectionConfig): Promise<SpeakerSelectionResult>;
+    /**
+     * Build the prompt for LLM speaker selection
+     * @param participants - Available participants
+     * @param messages - Message history
+     * @param context - Chat context
+     * @param config - Selection configuration
+     * @returns Formatted prompt string
+     */
+    private buildSelectionPrompt;
+    /**
+     * Simulate LLM selection (placeholder for actual LLM call)
+     * @param prompt - Selection prompt
+     * @param participants - Available participants
+     * @param messages - Message history
+     * @returns Selected participant name
+     */
+    private simulateLLMSelection;
+    /**
+     * Find the participant most relevant to the given content
+     * @param content - Message content to analyze
+     * @param participants - Available participants
+     * @returns Most relevant participant or null
+     */
+    private findMostRelevantParticipant;
+}
+/**
+ * Priority-based speaker selection - selects based on configured priority order
+ */
+export declare class PrioritySelector implements SpeakerSelectionStrategy {
+    /**
+     * Select the next speaker based on priority order
+     * @param participants - Available participants
+     * @param messages - Message history
+     * @param context - Current chat context
+     * @param config - Configuration with priority order
+     * @returns Speaker selection result
+     */
+    selectSpeaker(participants: ChatParticipant[], messages: Message[], context: ChatContext, config?: SpeakerSelectionConfig): Promise<SpeakerSelectionResult>;
+    /**
+     * Apply transition rules to determine next speaker
+     * @param fromSpeaker - Current speaker name
+     * @param rules - Transition rules
+     * @param participants - Available participants
+     * @returns Next speaker or null
+     */
+    private applyTransitionRules;
+}
+/**
+ * Manual speaker selection - expects explicit selection from context
+ */
+export declare class ManualSelector implements SpeakerSelectionStrategy {
+    /**
+     * Select the next speaker from manual specification
+     * @param participants - Available participants
+     * @param messages - Message history
+     * @param context - Current chat context with manual selection
+     * @returns Speaker selection result
+     */
+    selectSpeaker(participants: ChatParticipant[], _messages: Message[], context: ChatContext): Promise<SpeakerSelectionResult>;
+}
+/**
+ * Auto speaker selection - intelligently chooses selection strategy based on context
+ */
+export declare class AutoSelector implements SpeakerSelectionStrategy {
+    private roundRobin;
+    private llm;
+    private priority;
+    /**
+     * Automatically select the best strategy and next speaker
+     * @param participants - Available participants
+     * @param messages - Message history
+     * @param context - Current chat context
+     * @param config - Selection configuration
+     * @returns Speaker selection result
+     */
+    selectSpeaker(participants: ChatParticipant[], messages: Message[], context: ChatContext, config?: SpeakerSelectionConfig): Promise<SpeakerSelectionResult>;
+    /**
+     * Determine the best selection strategy for current context
+     * @param participants - Active participants
+     * @param messages - Message history
+     * @param context - Chat context
+     * @param config - Selection configuration
+     * @returns Strategy name to use
+     */
+    private determineStrategy;
+}
+/**
+ * Speaker selection manager that wraps all strategies
+ */
+export declare class SpeakerSelectionManager {
+    private strategies;
+    private currentStrategy;
+    private method;
+    /**
+     * Create a new speaker selection manager
+     * @param method - Initial selection method
+     */
+    constructor(method?: SpeakerSelectionMethod);
+    /**
+     * Initialize all available strategies
+     */
+    private initializeStrategies;
+    /**
+     * Select the next speaker using the current strategy
+     * @param participants - Available participants
+     * @param messages - Message history
+     * @param context - Chat context
+     * @param config - Selection configuration
+     * @returns Speaker selection result
+     */
+    selectSpeaker(participants: ChatParticipant[], messages: Message[], context: ChatContext, config?: SpeakerSelectionConfig): Promise<SpeakerSelectionResult>;
+    /**
+     * Change the selection method
+     * @param method - New selection method
+     */
+    setMethod(method: SpeakerSelectionMethod): void;
+    /**
+     * Get the current selection method
+     * @returns Current method
+     */
+    getMethod(): SpeakerSelectionMethod;
+    /**
+     * Get a specific strategy instance
+     * @param method - Selection method
+     * @returns Strategy instance
+     */
+    getStrategy(method: SpeakerSelectionMethod): SpeakerSelectionStrategy;
+}
+//# sourceMappingURL=speaker-selection.d.ts.map

package/dist/speaker-selection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"speaker-selection.d.ts","sourceRoot":"","sources":["../src/speaker-selection.ts"],"names":[],"mappings":"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"}