hippox-drivers 0.3.3

🦛All indivisible atomic driver units in Hippox.
use crate::{DriverCallback, DriverContext};
use anyhow::Result;
use serde_json::{Value, json};
use std::collections::HashMap;

use crate::types::{Driver, DriverParameter};
use crate::{RequestConfig, DriverCategory, execute};

fn get_param_string(params: &HashMap<String, Value>, name: &str) -> Result<String> {
    params
        .get(name)
        .and_then(|v| v.as_str())
        .map(|s| s.to_string())
        .ok_or_else(|| anyhow::anyhow!("Missing parameter: {}", name))
}

fn get_param_bool(params: &HashMap<String, Value>, name: &str, default: bool) -> bool {
    params
        .get(name)
        .and_then(|v| v.as_bool())
        .unwrap_or(default)
}

#[derive(Debug)]
pub struct SendTelegramDriver;

#[async_trait::async_trait]
impl Driver for SendTelegramDriver {
    fn name(&self) -> &str {
        "send_telegram"
    }
    fn description(&self) -> &str {
        "Send a message via Telegram Bot"
    }
    fn usage_hint(&self) -> &str {
        "Use this skill when the user wants to send a Telegram message"
    }

    fn category(&self) -> DriverCategory {
        DriverCategory::SocialPlatform
    }

    fn parameters(&self) -> Vec<DriverParameter> {
        vec![
            DriverParameter {
                name: "bot_token".to_string(),
                param_type: "string".to_string(),
                description: "Telegram bot token".to_string(),
                required: true,
                default: None,
                example: Some(Value::String("123456:ABC-DEF1234".to_string())),
                enum_values: None,
            },
            DriverParameter {
                name: "chat_id".to_string(),
                param_type: "string".to_string(),
                description: "Telegram chat ID".to_string(),
                required: true,
                default: None,
                example: Some(Value::String("123456789".to_string())),
                enum_values: None,
            },
            DriverParameter {
                name: "text".to_string(),
                param_type: "string".to_string(),
                description: "Message text to send".to_string(),
                required: true,
                default: None,
                example: Some(Value::String("Hello from Hippo!".to_string())),
                enum_values: None,
            },
            DriverParameter {
                name: "parse_mode".to_string(),
                param_type: "string".to_string(),
                description: "Parse mode: 'HTML', 'MarkdownV2', or 'Markdown'".to_string(),
                required: false,
                default: Some(Value::String("HTML".to_string())),
                example: Some(Value::String("Markdown".to_string())),
                enum_values: Some(vec![
                    "HTML".to_string(),
                    "MarkdownV2".to_string(),
                    "Markdown".to_string(),
                ]),
            },
            DriverParameter {
                name: "disable_notification".to_string(),
                param_type: "boolean".to_string(),
                description: "Send silently".to_string(),
                required: false,
                default: Some(Value::Bool(false)),
                example: Some(Value::Bool(true)),
                enum_values: None,
            },
        ]
    }

    fn example_call(&self) -> Value {
        json!({ "action": "send_telegram", "parameters": { "bot_token": "123456:ABC", "chat_id": "123456789", "text": "Hello" } })
    }

    fn example_output(&self) -> String {
        "Telegram message sent successfully".to_string()
    }

    async fn execute(
        &self,
        parameters: &HashMap<String, Value>,
        callback: Option<&dyn DriverCallback>,
        context: Option<&DriverContext>,
    ) -> Result<String> {
        let bot_token = get_param_string(parameters, "bot_token")?;
        let chat_id = get_param_string(parameters, "chat_id")?;
        let text = get_param_string(parameters, "text")?;
        let parse_mode = parameters
            .get("parse_mode")
            .and_then(|v| v.as_str())
            .unwrap_or("HTML");
        let disable_notification = get_param_bool(parameters, "disable_notification", false);

        let url = format!("https://api.telegram.org/bot{}/sendMessage", bot_token);
        let mut body = HashMap::new();
        body.insert("chat_id".to_string(), json!(chat_id));
        body.insert("text".to_string(), json!(text));
        body.insert("parse_mode".to_string(), json!(parse_mode));
        body.insert(
            "disable_notification".to_string(),
            json!(disable_notification),
        );

        let http_config = RequestConfig {
            url,
            method: "POST".to_string(),
            headers: Some([("Content-Type".to_string(), "application/json".to_string())].into()),
            body: Some(serde_json::to_string(&body)?),
            timeout_secs: Some(30),
        };

        let response = execute(&http_config).await?;
        if response.is_success {
            Ok(format!(
                "Telegram message sent successfully to chat {}",
                chat_id
            ))
        } else {
            Err(anyhow::anyhow!(
                "Failed to send Telegram message: {}",
                response.body
            ))
        }
    }
}