Duck Council

Instructions

Implementation Reference

• src/tools/duck-council.ts:7-107 (handler)

  Main handler for the duck_council tool. Gathers responses from all configured providers (ducks), formats them into a panel discussion, and returns the result. Uses duckCouncil() or compareDucksWithProgress() depending on whether a ProgressReporter is provided.

  export async function duckCouncilTool(
    providerManager: ProviderManager,
    args: Record<string, unknown>,
    progress?: ProgressReporter
  ) {
    const { prompt, model, images } = args as {
      prompt?: string;
      model?: string;
      images?: ImageInput[];
    };
  
    if (!prompt) {
      throw new Error('Prompt is required for the duck council');
    }
  
    logger.info('Convening the duck council...');
  
    // Get all available ducks
    const allProviders = providerManager.getProviderNames();
  
    if (allProviders.length === 0) {
      throw new Error('No ducks available for the council!');
    }
  
    const content = buildContent(prompt, images);
  
    // Get responses from all ducks, reporting progress as each completes
    const responses = progress
      ? await providerManager.compareDucksWithProgress(
          content,
          undefined,
          { model },
          (providerName, completed, total) => {
            void progress.report(
              completed,
              total,
              `${providerName} responded (${completed}/${total})`
            );
          }
        )
      : await providerManager.duckCouncil(content, { model });
  
    // Build council response with a panel discussion format
    let response = `${duckArt.panel}\n\n`;
    response += `🎙️ **Duck Council Topic:** "${prompt}"\n`;
    response += `👥 **${allProviders.length} ducks in attendance**\n\n`;
    response += `═══════════════════════════════════════\n\n`;
  
    // Present each duck's perspective
    for (let i = 0; i < responses.length; i++) {
      const duckResponse = responses[i];
      const duckNumber = i + 1;
  
      response += `**Duck #${duckNumber}: ${duckResponse.nickname}**\n`;
      response += `─────────────────────────────────────\n`;
  
      if (duckResponse.content.startsWith('Error:')) {
        response += `🦆💬 *[Duck had to leave early: ${duckResponse.content}]*\n`;
      } else {
        response += `🦆💬 "${duckResponse.content}"\n`;
  
        // Add metadata in a subtle way
        response += `\n`;
        response += `*[${duckResponse.model}`;
        if (duckResponse.latency > 0) {
          response += ` • ${duckResponse.latency}ms`;
        }
        if (duckResponse.usage) {
          response += ` • ${duckResponse.usage.total_tokens} tokens`;
        }
        response += `]*\n`;
      }
  
      response += `\n`;
    }
  
    // Add council summary
    const successCount = responses.filter((r) => !r.content.startsWith('Error:')).length;
    response += `═══════════════════════════════════════\n`;
    response += `🏛️ **Council Summary**\n`;
    response += `• ${successCount}/${responses.length} ducks provided their wisdom\n`;
  
    if (successCount === responses.length) {
      response += `• ${getRandomDuckMessage('success')}\n`;
    } else if (successCount > 0) {
      response += `• Partial council - some ducks were unavailable\n`;
    } else {
      response += `• ${getRandomDuckMessage('error')}\n`;
    }
  
    logger.info(`Duck council completed: ${successCount}/${responses.length} responses`);
  
    return {
      content: [
        {
          type: 'text',
          text: response,
        },
      ],
    };
  }

• src/providers/manager.ts:250-255 (helper)

  Base duckCouncil() method in ProviderManager - delegates to compareDucks() which queries all providers in parallel.

  async duckCouncil(
    prompt: MessageContent,
    options?: Partial<ChatOptions>
  ): Promise<DuckResponse[]> {
    return this.compareDucks(prompt, undefined, options);
  }