@wundr.io/autogen-orchestrator 1.0.3 → 1.0.12

package/README.md

@@ -1,6 +1,8 @@
 # @wundr.io/autogen-orchestrator
 
-AutoGen-style conversational multi-agent orchestration for the Wundr platform. This package implements sophisticated patterns for coordinating multiple AI agents in group chat settings with configurable speaker selection, termination conditions, and nested chat support.
+AutoGen-style conversational multi-agent orchestration for the Wundr platform. This package
+implements sophisticated patterns for coordinating multiple AI agents in group chat settings with
+configurable speaker selection, termination conditions, and nested chat support.
 
 ## Table of Contents
 
@@ -45,11 +47,11 @@ const analyst = createParticipant(
   ['analysis', 'research', 'data']
 );
 
-const developer = createParticipant(
-  'Developer',
-  'You are a senior software developer.',
-  ['coding', 'architecture', 'debugging']
-);
+const developer = createParticipant('Developer', 'You are a senior software developer.', [
+  'coding',
+  'architecture',
+  'debugging',
+]);
 
 const reviewer = createParticipant(
   'Reviewer',
@@ -134,9 +136,9 @@ import { Message, MessageRole, ContentType } from '@wundr.io/autogen-orchestrato
 // Message structure
 interface Message {
   id: string;
-  role: MessageRole;        // 'system' | 'user' | 'assistant' | 'function'
+  role: MessageRole; // 'system' | 'user' | 'assistant' | 'function'
   content: string;
-  name: string;             // Sender name
+  name: string; // Sender name
   timestamp: Date;
   contentType?: ContentType; // 'text' | 'code' | 'image' | 'function_call' | 'function_result'
   functionCall?: FunctionCall;
@@ -158,8 +160,8 @@ interface ChatContext {
   currentSpeaker?: string;
   previousSpeaker?: string;
   startTime: Date;
-  state: Record<string, unknown>;  // Custom state storage
-  parentContext?: ChatContext;      // For nested chats
+  state: Record<string, unknown>; // Custom state storage
+  parentContext?: ChatContext; // For nested chats
 }
 ```
 
@@ -196,9 +198,9 @@ const chat = new GroupChatManager({
       { from: 'Specialist', to: ['Leader', 'Assistant'], weight: 0.5 },
     ],
     allowedTransitions: {
-      'Leader': ['Specialist', 'Assistant'],
-      'Specialist': ['Leader'],
-      'Assistant': ['Leader', 'Specialist'],
+      Leader: ['Specialist', 'Assistant'],
+      Specialist: ['Leader'],
+      Assistant: ['Leader', 'Specialist'],
     },
   },
 });
@@ -229,9 +231,7 @@ const chat = new GroupChatBuilder()
 Automatically chooses the best selection strategy:
 
 ```typescript
-const chat = new GroupChatBuilder()
-  .withSpeakerSelection('auto')
-  .build();
+const chat = new GroupChatBuilder().withSpeakerSelection('auto').build();
 
 // Strategy selection logic:
 // - Uses 'priority' if transition rules are configured
@@ -389,12 +389,7 @@ const selector = createSpeakerSelector('llm_selected');
 const manager = new SpeakerSelectionManager('round_robin');
 
 // Select next speaker
-const result = await manager.selectSpeaker(
-  participants,
-  messages,
-  context,
-  selectionConfig
-);
+const result = await manager.selectSpeaker(participants, messages, context, selectionConfig);
 
 console.log(result);
 // {
@@ -471,9 +466,9 @@ const config: SpeakerSelectionConfig = {
     },
   ],
   allowedTransitions: {
-    'Manager': ['Developer', 'Tester'],
-    'Developer': ['Tester', 'Manager'],
-    'Tester': ['Developer', 'Manager'],
+    Manager: ['Developer', 'Tester'],
+    Developer: ['Tester', 'Manager'],
+    Tester: ['Developer', 'Manager'],
   },
 };
 ```
@@ -706,10 +701,7 @@ Nested chats allow focused sub-discussions within a main conversation.
 ### Configuration
 
 ```typescript
-import {
-  NestedChatManager,
-  NestedChatConfigBuilder,
-} from '@wundr.io/autogen-orchestrator';
+import { NestedChatManager, NestedChatConfigBuilder } from '@wundr.io/autogen-orchestrator';
 
 // Using the builder
 const nestedConfig = new NestedChatConfigBuilder()
@@ -738,9 +730,7 @@ const chat = new GroupChatBuilder()
 
 ```typescript
 // Keyword trigger
-new NestedChatConfigBuilder()
-  .withKeywordTrigger(['review code', 'code review'])
-  .build();
+new NestedChatConfigBuilder().withKeywordTrigger(['review code', 'code review']).build();
 
 // Participant trigger
 new NestedChatConfigBuilder()
@@ -755,9 +745,7 @@ new NestedChatConfigBuilder()
   .build();
 
 // Manual trigger
-new NestedChatConfigBuilder()
-  .withManualTrigger('startNestedDiscussion')
-  .build();
+new NestedChatConfigBuilder().withManualTrigger('startNestedDiscussion').build();
 
 // Trigger manually via state
 chat.updateState('startNestedDiscussion', true);
@@ -771,9 +759,7 @@ chat.updateState('startNestedDiscussion', true);
 // 'reflection' - Structured reflection summary
 // 'custom' - Custom summary logic
 
-const config = new NestedChatConfigBuilder()
-  .withSummaryMethod('reflection')
-  .build();
+const config = new NestedChatConfigBuilder().withSummaryMethod('reflection').build();
 ```
 
 ### Nested Chat Events
@@ -799,7 +785,7 @@ import { TaskOrchestrator } from '@wundr.io/task-orchestrator';
 const taskOrchestrator = new TaskOrchestrator();
 
 // Create a chat for each complex task
-taskOrchestrator.on('task:complex', async (task) => {
+taskOrchestrator.on('task:complex', async task => {
   const chat = new GroupChatBuilder()
     .withName(`Task: ${task.name}`)
     .withParticipant(createParticipant('Planner', 'Plan the task execution'))
@@ -896,65 +882,65 @@ class AgentEventBridge extends EventEmitter {
 
 ### GroupChatManager
 
-| Method | Description |
-|--------|-------------|
-| `constructor(config: GroupChatConfig)` | Create a new chat manager |
-| `setResponseGenerator(generator: ResponseGenerator)` | Set the LLM response generator |
-| `start(options?: StartChatOptions)` | Start the conversation |
-| `pause()` | Pause the conversation |
-| `resume()` | Resume a paused conversation |
-| `stop(reason?: string)` | Stop the conversation |
-| `addMessage(options: CreateMessageOptions)` | Add a message |
-| `addParticipant(options: AddParticipantOptions)` | Add a participant |
-| `removeParticipant(name: string)` | Remove a participant |
-| `updateParticipantStatus(name: string, status: ParticipantStatus)` | Update participant status |
-| `addTerminationCondition(condition: TerminationCondition)` | Add termination condition |
-| `addNestedChatConfig(config: NestedChatConfig)` | Add nested chat configuration |
-| `getStatus()` | Get current chat status |
-| `getChatId()` | Get the chat ID |
-| `getMessages()` | Get all messages |
-| `getParticipants()` | Get all participants |
-| `getContext()` | Get current context |
-| `getMetrics()` | Get chat metrics |
-| `updateState(key: string, value: T)` | Update context state |
-| `getState<T>(key: string)` | Get context state value |
+| Method                                                             | Description                    |
+| ------------------------------------------------------------------ | ------------------------------ |
+| `constructor(config: GroupChatConfig)`                             | Create a new chat manager      |
+| `setResponseGenerator(generator: ResponseGenerator)`               | Set the LLM response generator |
+| `start(options?: StartChatOptions)`                                | Start the conversation         |
+| `pause()`                                                          | Pause the conversation         |
+| `resume()`                                                         | Resume a paused conversation   |
+| `stop(reason?: string)`                                            | Stop the conversation          |
+| `addMessage(options: CreateMessageOptions)`                        | Add a message                  |
+| `addParticipant(options: AddParticipantOptions)`                   | Add a participant              |
+| `removeParticipant(name: string)`                                  | Remove a participant           |
+| `updateParticipantStatus(name: string, status: ParticipantStatus)` | Update participant status      |
+| `addTerminationCondition(condition: TerminationCondition)`         | Add termination condition      |
+| `addNestedChatConfig(config: NestedChatConfig)`                    | Add nested chat configuration  |
+| `getStatus()`                                                      | Get current chat status        |
+| `getChatId()`                                                      | Get the chat ID                |
+| `getMessages()`                                                    | Get all messages               |
+| `getParticipants()`                                                | Get all participants           |
+| `getContext()`                                                     | Get current context            |
+| `getMetrics()`                                                     | Get chat metrics               |
+| `updateState(key: string, value: T)`                               | Update context state           |
+| `getState<T>(key: string)`                                         | Get context state value        |
 
 ### SpeakerSelectionManager
 
-| Method | Description |
-|--------|-------------|
-| `constructor(method?: SpeakerSelectionMethod)` | Create with initial method |
-| `selectSpeaker(participants, messages, context, config?)` | Select next speaker |
-| `setMethod(method: SpeakerSelectionMethod)` | Change selection method |
-| `getMethod()` | Get current method |
-| `getStrategy(method: SpeakerSelectionMethod)` | Get strategy instance |
+| Method                                                    | Description                |
+| --------------------------------------------------------- | -------------------------- |
+| `constructor(method?: SpeakerSelectionMethod)`            | Create with initial method |
+| `selectSpeaker(participants, messages, context, config?)` | Select next speaker        |
+| `setMethod(method: SpeakerSelectionMethod)`               | Change selection method    |
+| `getMethod()`                                             | Get current method         |
+| `getStrategy(method: SpeakerSelectionMethod)`             | Get strategy instance      |
 
 ### TerminationManager
 
-| Method | Description |
-|--------|-------------|
+| Method                                             | Description                    |
+| -------------------------------------------------- | ------------------------------ |
 | `constructor(conditions?: TerminationCondition[])` | Create with initial conditions |
-| `addCondition(condition: TerminationCondition)` | Add a condition |
-| `removeCondition(type: TerminationConditionType)` | Remove conditions by type |
-| `clearConditions()` | Clear all conditions |
-| `evaluate(messages, participants, context)` | Evaluate all conditions |
-| `getConditions()` | Get all conditions |
-| `hasCondition(type: TerminationConditionType)` | Check if type exists |
+| `addCondition(condition: TerminationCondition)`    | Add a condition                |
+| `removeCondition(type: TerminationConditionType)`  | Remove conditions by type      |
+| `clearConditions()`                                | Clear all conditions           |
+| `evaluate(messages, participants, context)`        | Evaluate all conditions        |
+| `getConditions()`                                  | Get all conditions             |
+| `hasCondition(type: TerminationConditionType)`     | Check if type exists           |
 
 ### NestedChatManager
 
-| Method | Description |
-|--------|-------------|
-| `constructor(configs?: NestedChatConfig[])` | Create with initial configs |
-| `addConfig(config: NestedChatConfig)` | Add configuration |
-| `removeConfig(configId: string)` | Remove configuration |
-| `checkTrigger(message, participants, context)` | Check for triggers |
-| `startNestedChat(config, parentChatId, parentMessageId, participants, context)` | Start nested chat |
-| `addMessage(nestedChatId: string, message: Message)` | Add message to nested chat |
-| `endNestedChat(nestedChatId, status?, reason?)` | End nested chat |
-| `getActiveChats()` | Get active nested chat IDs |
-| `getCompletedChats()` | Get completed results |
-| `hasActiveChats()` | Check for active chats |
+| Method                                                                          | Description                 |
+| ------------------------------------------------------------------------------- | --------------------------- |
+| `constructor(configs?: NestedChatConfig[])`                                     | Create with initial configs |
+| `addConfig(config: NestedChatConfig)`                                           | Add configuration           |
+| `removeConfig(configId: string)`                                                | Remove configuration        |
+| `checkTrigger(message, participants, context)`                                  | Check for triggers          |
+| `startNestedChat(config, parentChatId, parentMessageId, participants, context)` | Start nested chat           |
+| `addMessage(nestedChatId: string, message: Message)`                            | Add message to nested chat  |
+| `endNestedChat(nestedChatId, status?, reason?)`                                 | End nested chat             |
+| `getActiveChats()`                                                              | Get active nested chat IDs  |
+| `getCompletedChats()`                                                           | Get completed results       |
+| `hasActiveChats()`                                                              | Check for active chats      |
 
 ## Examples
 

package/package.json

@@ -1,10 +1,13 @@
 {
   "name": "@wundr.io/autogen-orchestrator",
-  "version": "1.0.3",
+  "version": "1.0.12",
   "description": "AutoGen-style conversational multi-agent orchestration for the Wundr platform",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
-  "files": ["dist", "src"],
+  "files": [
+    "dist",
+    "src"
+  ],
   "scripts": {
     "build": "tsc",
     "build:watch": "tsc --watch",
@@ -20,9 +23,9 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "zod": "^3.25.76",
+    "eventemitter3": "^5.0.1",
     "uuid": "^11.0.3",
-    "eventemitter3": "^5.0.1"
+    "zod": "^3.25.76"
   },
   "devDependencies": {
     "@types/node": "^20.9.0",
@@ -31,9 +34,9 @@
     "@typescript-eslint/parser": "^8.44.0",
     "eslint": "^8.57.1",
     "jest": "^29.7.0",
+    "prettier": "^3.3.3",
     "ts-jest": "^29.4.1",
-    "typescript": "^5.2.2",
-    "prettier": "^3.3.3"
+    "typescript": "^5.2.2"
   },
   "publishConfig": {
     "access": "public"

package/src/group-chat.ts

@@ -101,7 +101,7 @@ export class GroupChatManager extends EventEmitter<GroupChatEvents> {
     const validationResult = GroupChatConfigSchema.safeParse(config);
     if (!validationResult.success) {
       throw new Error(
-        `Invalid GroupChatConfig: ${validationResult.error.message}`,
+        `Invalid GroupChatConfig: ${validationResult.error.message}`
       );
     }
 
@@ -125,13 +125,13 @@ export class GroupChatManager extends EventEmitter<GroupChatEvents> {
 
     // Initialize managers
     this.speakerManager = new SpeakerSelectionManager(
-      config.speakerSelectionMethod,
+      config.speakerSelectionMethod
     );
     this.terminationManager = new TerminationManager(
-      config.terminationConditions || [],
+      config.terminationConditions || []
     );
     this.nestedChatManager = new NestedChatManager(
-      config.nestedChatConfigs || [],
+      config.nestedChatConfigs || []
     );
 
     // Initialize metrics
@@ -171,7 +171,7 @@ export class GroupChatManager extends EventEmitter<GroupChatEvents> {
           nestedChatId,
           result: nestedResult,
         });
-      },
+      }
     );
   }
 
@@ -232,7 +232,7 @@ export class GroupChatManager extends EventEmitter<GroupChatEvents> {
    * @returns Chat result
    */
   private async runConversationLoop(
-    options: StartChatOptions,
+    options: StartChatOptions
   ): Promise<ChatResult> {
     const maxRounds = this.config.maxRounds || 100;
     const maxMessages = this.config.maxMessages || 1000;
@@ -242,7 +242,7 @@ export class GroupChatManager extends EventEmitter<GroupChatEvents> {
       const terminationResult = await this.terminationManager.evaluate(
         this.messages,
         Array.from(this.participants.values()),
-        this.context,
+        this.context
       );
 
       if (terminationResult.shouldTerminate) {
@@ -253,14 +253,14 @@ export class GroupChatManager extends EventEmitter<GroupChatEvents> {
       if (this.context.currentRound >= maxRounds) {
         return this.endChat(
           'terminated',
-          `Maximum rounds reached: ${maxRounds}`,
+          `Maximum rounds reached: ${maxRounds}`
         );
       }
 
       if (this.messages.length >= maxMessages) {
         return this.endChat(
           'terminated',
-          `Maximum messages reached: ${maxMessages}`,
+          `Maximum messages reached: ${maxMessages}`
         );
       }
 
@@ -281,7 +281,7 @@ export class GroupChatManager extends EventEmitter<GroupChatEvents> {
           Array.from(this.participants.values()),
           this.messages,
           this.context,
-          this.config.speakerSelectionConfig,
+          this.config.speakerSelectionConfig
         );
 
         this.context.previousSpeaker = this.context.currentSpeaker;
@@ -335,7 +335,7 @@ export class GroupChatManager extends EventEmitter<GroupChatEvents> {
    * @returns Generated response content
    */
   private async generateResponse(
-    participant: ChatParticipant,
+    participant: ChatParticipant
   ): Promise<string | null> {
     const startTime = Date.now();
 
@@ -349,11 +349,12 @@ export class GroupChatManager extends EventEmitter<GroupChatEvents> {
         response = await this.responseGenerator(
           participant,
           this.messages,
-          this.context,
+          this.context
         );
       } else {
-        // Default placeholder response
-        response = this.generatePlaceholderResponse(participant);
+        throw new Error(
+          `No response generator configured. Call setResponseGenerator() with a real LLM integration before starting the chat.`
+        );
       }
 
       // Update metrics
@@ -371,28 +372,13 @@ export class GroupChatManager extends EventEmitter<GroupChatEvents> {
       const errorMessage =
         error instanceof Error ? error.message : String(error);
       console.error(
-        `Error generating response for ${participant.name}: ${errorMessage}`,
+        `Error generating response for ${participant.name}: ${errorMessage}`
       );
 
       return null;
     }
   }
 
-  /**
-   * Generate a placeholder response when no generator is set
-   * @param participant - Participant to generate for
-   * @returns Placeholder response
-   */
-  private generatePlaceholderResponse(participant: ChatParticipant): string {
-    const prompts = [
-      `[${participant.name}]: I acknowledge the message and am ready to contribute.`,
-      `[${participant.name}]: Based on my expertise in ${participant.capabilities.join(', ')}, I suggest we proceed.`,
-      `[${participant.name}]: Let me analyze this from my perspective.`,
-    ];
-
-    return prompts[Math.floor(Math.random() * prompts.length)]!;
-  }
-
   /**
    * Update metrics after a response
    * @param participantName - Name of the participant
@@ -402,7 +388,7 @@ export class GroupChatManager extends EventEmitter<GroupChatEvents> {
   private updateMetrics(
     participantName: string,
     latencyMs: number,
-    tokenEstimate: number,
+    tokenEstimate: number
   ): void {
     // Update per-participant metrics
     this.metrics.messagesPerParticipant[participantName] =
@@ -431,7 +417,7 @@ export class GroupChatManager extends EventEmitter<GroupChatEvents> {
     const triggeredConfig = this.nestedChatManager.checkTrigger(
       message,
       Array.from(this.participants.values()),
-      this.context,
+      this.context
     );
 
     if (triggeredConfig) {
@@ -446,14 +432,14 @@ export class GroupChatManager extends EventEmitter<GroupChatEvents> {
    */
   private async runNestedChat(
     config: NestedChatConfig,
-    triggerMessageId: string,
+    triggerMessageId: string
   ): Promise<void> {
     const nestedChatId = this.nestedChatManager.startNestedChat(
       config,
       this.chatId,
       triggerMessageId,
       Array.from(this.participants.values()),
-      this.context,
+      this.context
     );
 
     // Run nested chat rounds
@@ -475,19 +461,19 @@ export class GroupChatManager extends EventEmitter<GroupChatEvents> {
       const selectionResult = await this.speakerManager.selectSpeaker(
         nestedState.participants,
         nestedState.messages,
-        nestedContext,
+        nestedContext
       );
 
       // Generate response
       const participant = nestedState.participants.find(
-        p => p.name === selectionResult.speaker,
+        p => p.name === selectionResult.speaker
       );
 
       if (participant && this.responseGenerator) {
         const response = await this.responseGenerator(
           participant,
           nestedState.messages,
-          nestedContext,
+          nestedContext
         );
 
         if (response) {
@@ -510,7 +496,7 @@ export class GroupChatManager extends EventEmitter<GroupChatEvents> {
     const result = await this.nestedChatManager.endNestedChat(
       nestedChatId,
       'completed',
-      `Completed after ${round} rounds`,
+      `Completed after ${round} rounds`
     );
 
     this.nestedResults.push(result);
@@ -587,7 +573,7 @@ export class GroupChatManager extends EventEmitter<GroupChatEvents> {
   removeParticipant(name: string): void {
     this.participants.delete(name);
     this.context.activeParticipants = this.context.activeParticipants.filter(
-      n => n !== name,
+      n => n !== name
     );
   }
 
@@ -740,7 +726,7 @@ export class GroupChatManager extends EventEmitter<GroupChatEvents> {
     type: T,
     data: T extends keyof ChatEventDataMap
       ? ChatEventDataMap[T]
-      : Record<string, unknown>,
+      : Record<string, unknown>
   ): void {
     const event: ChatEvent<T> = {
       type,
@@ -808,7 +794,7 @@ export class GroupChatManager extends EventEmitter<GroupChatEvents> {
    */
   updateState<T extends string | number | boolean | object | null>(
     key: string,
-    value: T,
+    value: T
   ): void {
     this.context.state[key] = value;
   }
@@ -866,7 +852,7 @@ export class GroupChatBuilder {
    * @param method - Selection method
    */
   withSpeakerSelection(
-    method: GroupChatConfig['speakerSelectionMethod'],
+    method: GroupChatConfig['speakerSelectionMethod']
   ): this {
     this.config.speakerSelectionMethod = method;
     return this;
@@ -967,7 +953,7 @@ export class GroupChatBuilder {
 export function createParticipant(
   name: string,
   systemPrompt: string,
-  capabilities: string[] = [],
+  capabilities: string[] = []
 ): ChatParticipant {
   return {
     id: uuidv4(),