@wundr.io/autogen-orchestrator 1.0.3

package/dist/group-chat.d.ts

@@ -0,0 +1,327 @@
+/**
+ * GroupChatManager - Core orchestration for AutoGen-style multi-agent conversations
+ *
+ * Implements conversational patterns for coordinating multiple AI agents in a
+ * group chat setting with configurable speaker selection and termination conditions.
+ */
+import { EventEmitter } from 'eventemitter3';
+import type { NestedChatResult } from './nested-chat';
+import type { Message, ChatParticipant, ChatContext, ChatResult, ChatStatus, ChatMetrics, ChatError, GroupChatConfig, TerminationCondition, NestedChatConfig, CreateMessageOptions, AddParticipantOptions, StartChatOptions, ParticipantStatus } from './types';
+/**
+ * Events emitted by the GroupChatManager
+ */
+export interface GroupChatEvents {
+    'chat:started': (data: {
+        chatId: string;
+        config: GroupChatConfig;
+    }) => void;
+    'chat:ended': (data: {
+        chatId: string;
+        result: ChatResult;
+    }) => void;
+    'chat:error': (data: {
+        chatId: string;
+        error: ChatError;
+    }) => void;
+    'message:sent': (data: {
+        chatId: string;
+        message: Message;
+    }) => void;
+    'message:received': (data: {
+        chatId: string;
+        message: Message;
+    }) => void;
+    'speaker:selected': (data: {
+        chatId: string;
+        speaker: string;
+        reason?: string;
+    }) => void;
+    'round:started': (data: {
+        chatId: string;
+        round: number;
+    }) => void;
+    'round:ended': (data: {
+        chatId: string;
+        round: number;
+    }) => void;
+    'termination:triggered': (data: {
+        chatId: string;
+        reason: string;
+    }) => void;
+    'nested:started': (data: {
+        chatId: string;
+        nestedChatId: string;
+    }) => void;
+    'nested:ended': (data: {
+        chatId: string;
+        nestedChatId: string;
+        result: NestedChatResult;
+    }) => void;
+}
+/**
+ * Response generator function type
+ * Used to generate responses for participants
+ */
+export type ResponseGenerator = (participant: ChatParticipant, messages: Message[], context: ChatContext) => Promise<string>;
+/**
+ * GroupChatManager - Orchestrates multi-agent conversations
+ */
+export declare class GroupChatManager extends EventEmitter<GroupChatEvents> {
+    private config;
+    private participants;
+    private messages;
+    private context;
+    private status;
+    private startTime?;
+    private endTime?;
+    private chatId;
+    private speakerManager;
+    private terminationManager;
+    private nestedChatManager;
+    private responseGenerator?;
+    private metrics;
+    private nestedResults;
+    /**
+     * Create a new GroupChatManager
+     * @param config - Group chat configuration
+     */
+    constructor(config: GroupChatConfig);
+    /**
+     * Setup event forwarding from nested chat manager
+     */
+    private setupNestedChatEvents;
+    /**
+     * Set the response generator function
+     * @param generator - Function to generate participant responses
+     */
+    setResponseGenerator(generator: ResponseGenerator): void;
+    /**
+     * Start the group chat
+     * @param options - Optional start options
+     * @returns Chat result when completed
+     */
+    start(options?: StartChatOptions): Promise<ChatResult>;
+    /**
+     * Run the main conversation loop
+     * @param options - Start options
+     * @returns Chat result
+     */
+    private runConversationLoop;
+    /**
+     * Generate a response for a participant
+     * @param participant - Participant to generate response for
+     * @returns Generated response content
+     */
+    private generateResponse;
+    /**
+     * Generate a placeholder response when no generator is set
+     * @param participant - Participant to generate for
+     * @returns Placeholder response
+     */
+    private generatePlaceholderResponse;
+    /**
+     * Update metrics after a response
+     * @param participantName - Name of the participant
+     * @param latencyMs - Response latency
+     * @param tokenEstimate - Estimated token count
+     */
+    private updateMetrics;
+    /**
+     * Check if a message triggers a nested chat
+     * @param message - Message to check
+     */
+    private checkNestedChatTriggers;
+    /**
+     * Run a nested chat session
+     * @param config - Nested chat configuration
+     * @param triggerMessageId - ID of the triggering message
+     */
+    private runNestedChat;
+    /**
+     * Add a message to the chat
+     * @param options - Message options
+     * @returns Created message
+     */
+    addMessage(options: CreateMessageOptions): Promise<Message>;
+    /**
+     * Add a participant to the chat
+     * @param options - Participant options
+     * @returns Created participant
+     */
+    addParticipant(options: AddParticipantOptions): ChatParticipant;
+    /**
+     * Remove a participant from the chat
+     * @param name - Participant name
+     */
+    removeParticipant(name: string): void;
+    /**
+     * Update a participant's status
+     * @param name - Participant name
+     * @param status - New status
+     */
+    updateParticipantStatus(name: string, status: ParticipantStatus): void;
+    /**
+     * Add a termination condition
+     * @param condition - Condition to add
+     */
+    addTerminationCondition(condition: TerminationCondition): void;
+    /**
+     * Add a nested chat configuration
+     * @param config - Nested chat config
+     */
+    addNestedChatConfig(config: NestedChatConfig): void;
+    /**
+     * Pause the chat
+     */
+    pause(): void;
+    /**
+     * Resume the chat
+     */
+    resume(): void;
+    /**
+     * Stop the chat
+     * @param reason - Reason for stopping
+     * @returns Chat result
+     */
+    stop(reason?: string): Promise<ChatResult>;
+    /**
+     * End the chat and produce a result
+     * @param status - Final status
+     * @param reason - Termination reason
+     * @returns Chat result
+     */
+    private endChat;
+    /**
+     * Handle an error during chat execution
+     * @param error - Error that occurred
+     * @returns Chat result with error
+     */
+    private handleError;
+    /**
+     * Generate a summary of the conversation
+     * @returns Summary string
+     */
+    private generateSummary;
+    /**
+     * Emit a chat event
+     * @param type - Event type
+     * @param data - Event data typed based on event type
+     */
+    private emitEvent;
+    /**
+     * Get the current chat status
+     * @returns Current status
+     */
+    getStatus(): ChatStatus;
+    /**
+     * Get the chat ID
+     * @returns Chat ID
+     */
+    getChatId(): string;
+    /**
+     * Get all messages
+     * @returns Message array
+     */
+    getMessages(): Message[];
+    /**
+     * Get all participants
+     * @returns Participant array
+     */
+    getParticipants(): ChatParticipant[];
+    /**
+     * Get the current context
+     * @returns Chat context
+     */
+    getContext(): ChatContext;
+    /**
+     * Get current metrics
+     * @returns Chat metrics
+     */
+    getMetrics(): ChatMetrics;
+    /**
+     * Update context state
+     * @param key - State key
+     * @param value - State value (typed for common use cases)
+     */
+    updateState<T extends string | number | boolean | object | null>(key: string, value: T): void;
+    /**
+     * Get context state value
+     * @param key - State key
+     * @returns State value
+     */
+    getState<T>(key: string): T | undefined;
+}
+/**
+ * Builder for creating GroupChatManager instances
+ */
+export declare class GroupChatBuilder {
+    private config;
+    /**
+     * Set the chat name
+     * @param name - Chat name
+     */
+    withName(name: string): this;
+    /**
+     * Set the chat description
+     * @param description - Chat description
+     */
+    withDescription(description: string): this;
+    /**
+     * Add a participant
+     * @param participant - Participant to add
+     */
+    withParticipant(participant: ChatParticipant): this;
+    /**
+     * Set the speaker selection method
+     * @param method - Selection method
+     */
+    withSpeakerSelection(method: GroupChatConfig['speakerSelectionMethod']): this;
+    /**
+     * Set maximum rounds
+     * @param maxRounds - Maximum rounds
+     */
+    withMaxRounds(maxRounds: number): this;
+    /**
+     * Set maximum messages
+     * @param maxMessages - Maximum messages
+     */
+    withMaxMessages(maxMessages: number): this;
+    /**
+     * Add a termination condition
+     * @param condition - Termination condition
+     */
+    withTerminationCondition(condition: TerminationCondition): this;
+    /**
+     * Enable nested chats
+     */
+    withNestedChats(): this;
+    /**
+     * Add a nested chat configuration
+     * @param config - Nested chat config
+     */
+    withNestedChatConfig(config: NestedChatConfig): this;
+    /**
+     * Set the admin name
+     * @param name - Admin name
+     */
+    withAdmin(name: string): this;
+    /**
+     * Set timeout
+     * @param timeoutMs - Timeout in milliseconds
+     */
+    withTimeout(timeoutMs: number): this;
+    /**
+     * Build the GroupChatManager
+     * @returns Configured GroupChatManager
+     */
+    build(): GroupChatManager;
+}
+/**
+ * Create a simple participant configuration
+ * @param name - Participant name
+ * @param systemPrompt - System prompt
+ * @param capabilities - Participant capabilities
+ * @returns Participant configuration
+ */
+export declare function createParticipant(name: string, systemPrompt: string, capabilities?: string[]): ChatParticipant;
+//# sourceMappingURL=group-chat.d.ts.map

package/dist/group-chat.d.ts.map

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