baibot-withmcp/src/controller/provider/mod.rs

use mxlink::MessageResponseType;

use crate::{agent::AgentProvider, entity::MessageContext, strings, Bot};

use super::ControllerType;

pub fn determine_controller(_text: &str) -> ControllerType {
    ControllerType::ProviderHelp
}

pub async fn handle_help(message_context: &MessageContext, bot: &Bot) -> anyhow::Result<()> {
    let can_create_global_agents = message_context.sender_can_manage_global_config();
    let can_create_room_local_agents = message_context.sender_can_manage_room_local_agents()?;

    let mut message = String::new();
    message.push_str(&format!("## {}", strings::help::provider::heading()));
    message.push_str("\n\n");
    message.push_str(&strings::help::provider::intro());
    message.push_str("\n\n");
    message.push_str(&strings::provider::providers_list_intro());
    message.push_str("\n\n");

    // How to choose
    message.push_str(&format!(
        "### {}",
        strings::provider::help_how_to_choose_heading()
    ));
    message.push_str("\n\n");
    message.push_str(&strings::provider::help_how_to_choose_description(
        bot.command_prefix(),
    ));
    message.push_str("\n\n");

    // How to use
    message.push_str(&format!(
        "### {}",
        strings::provider::help_how_to_use_heading()
    ));
    message.push_str("\n\n");
    message.push_str(&strings::provider::help_how_to_use_description(
        bot.command_prefix(),
    ));
    message.push_str("\n\n");

    for provider in AgentProvider::choices() {
        let provider_info = provider.info();

        message.push_str(&format!(
            "### {}",
            strings::provider::help_provider_heading(
                provider_info.name,
                &provider_info.homepage_url.as_ref().map(|s| s.to_string())
            )
        ));

        message.push_str("\n\n");

        message.push_str(&strings::provider::help_provider_details(
            provider.to_static_str(),
            &provider_info,
        ));

        // We always show a "Quick start" section (even to unprivileged users),
        // because we're talking about it in a previous message.
        message.push_str("- 🗲 Quick start:");
        if can_create_room_local_agents {
            message.push_str(&format!(
                "\n\t- create a room-local agent: `{command_prefix} agent create-room-local {provider_id} my-{provider_id}-agent`",
                command_prefix = bot.command_prefix(),
                provider_id = provider.to_static_str(),
            ));
        }
        if can_create_global_agents {
            message.push_str(&format!(
                "\n\t- create a global agent: `{command_prefix} agent create-global {provider_id} my-{provider_id}-agent`",
                command_prefix = bot.command_prefix(),
                provider_id = provider.to_static_str(),
            ));
        }
        if !can_create_room_local_agents && !can_create_global_agents {
            message.push_str(" ask an administrator to create an agent for you (you lack permissions to do so yourself)");
        }

        message.push_str("\n\n");
    }

    bot.messaging()
        .send_text_markdown_no_fail(
            message_context.room(),
            message,
            MessageResponseType::Reply(message_context.thread_info().root_event_id.clone()),
        )
        .await;

    Ok(())
}