orch/channels/

slack.rs

//! Slack channel — receives commands and streams agent output.
//!
//! Uses the Slack Web API with HTTP polling (conversations.history) to receive
//! messages and the chat.postMessage API to send responses.
//!
//! Configuration in `~/.orch/config.yml`:
//! ```yaml
//! channels:
//!   slack:
//!     bot_token: "xoxb-..."       # Bot User OAuth Token
//!     channel_id: "C1234567890"   # Channel to monitor and post to
//! ```
//!
//! The bot token requires the following OAuth scopes:
//! - `channels:history` / `groups:history` — read messages
//! - `chat:write` — post messages
//! - `channels:read` — health check

use super::{Channel, IncomingMessage, OutgoingMessage};
use anyhow::Context;
use async_trait::async_trait;
use chrono::{DateTime, Utc};
use reqwest::Client;
use serde::Deserialize;
use sha2::{Digest, Sha256};
use std::fmt;
use std::fmt::Debug;
use std::fmt::Formatter;
use std::fmt::Write as _;
use std::sync::Arc;
use std::time::Duration;
use tokio::sync::Mutex;
use tokio::sync::mpsc;
use tokio::sync::mpsc::Receiver;
use tokio::time;

pub struct SlackChannel {
    pub bot_token: String,
    pub client: Client,
    pub channel_id: Option<String>,
    /// Cursor tracking the latest message timestamp seen (Slack uses `ts` as cursor).
    pub last_ts: Arc<Mutex<Option<String>>>,
}

impl Debug for SlackChannel {
    fn fmt(&self, f: &mut Formatter<'_>) -> fmt::Result {
        f.debug_struct("SlackChannel")
            .field("channel_id", &self.channel_id)
            .finish_non_exhaustive()
    }
}

#[derive(Deserialize)]
struct SlackMessage {
    #[serde(rename = "type")]
    msg_type: Option<String>,
    ts: String,
    /// Absent for bot-posted messages; present for human users.
    user: Option<String>,
    /// Present for bot messages.
    bot_id: Option<String>,
    text: Option<String>,
}

#[derive(Deserialize)]
struct ResponseMetadata {
    next_cursor: Option<String>,
}

#[derive(Deserialize)]
struct ConversationsHistoryResponse {
    ok: bool,
    messages: Option<Vec<SlackMessage>>,
    error: Option<String>,
    has_more: Option<bool>,
    response_metadata: Option<ResponseMetadata>,
}

#[derive(Deserialize)]
struct PostMessageResponse {
    ok: bool,
    error: Option<String>,
}

#[derive(Deserialize)]
struct AuthTestResponse {
    ok: bool,
    error: Option<String>,
}

impl SlackChannel {
    pub fn new(bot_token: String, channel_id: Option<String>) -> anyhow::Result<Self> {
        let client = Client::builder()
            .timeout(Duration::from_secs(30))
            .build()
            .context("failed to build HTTP client")?;

        Ok(Self {
            bot_token,
            client,
            channel_id,
            last_ts: Arc::new(Mutex::new(None)),
        })
    }

    fn api_url(method: &str) -> String {
        format!("https://slack.com/api/{method}")
    }

    /// Fetch all messages newer than `oldest` from a channel, following pagination.
    ///
    /// `oldest` is the Slack `ts` of the last processed message (exclusive lower bound).
    /// Loops through pages until `has_more` is false or `next_cursor` is empty, so no
    /// messages are dropped regardless of how many arrived since the last poll.
    async fn get_messages(
        &self,
        channel_id: &str,
        oldest: Option<String>,
    ) -> anyhow::Result<Vec<SlackMessage>> {
        let mut all_messages: Vec<SlackMessage> = Vec::new();
        let mut cursor: Option<String> = None;

        loop {
            let mut params = vec![
                ("channel", channel_id.to_string()),
                ("limit", "200".to_string()),
            ];

            if let Some(ref ts) = oldest {
                params.push(("oldest", ts.clone()));
            }

            if let Some(ref c) = cursor {
                params.push(("cursor", c.clone()));
            }

            let response = self
                .client
                .get(Self::api_url("conversations.history"))
                .bearer_auth(&self.bot_token)
                .query(&params)
                .send()
                .await?;

            if !response.status().is_success() {
                let body = response.text().await.unwrap_or_default();
                anyhow::bail!("slack API HTTP error: {body}");
            }

            let result: ConversationsHistoryResponse = response.json().await?;

            if !result.ok {
                let err = result.error.as_deref().unwrap_or("unknown");
                anyhow::bail!("slack conversations.history error: {err}");
            }

            all_messages.extend(result.messages.unwrap_or_default());

            let has_more = result.has_more.unwrap_or(false);
            let next_cursor = result
                .response_metadata
                .and_then(|m| m.next_cursor)
                .filter(|c| !c.is_empty());

            if !has_more || next_cursor.is_none() {
                break;
            }

            cursor = next_cursor;
        }

        Ok(all_messages)
    }

    async fn send_message(&self, channel_id: &str, text: &str) -> anyhow::Result<()> {
        let response = self
            .client
            .post(Self::api_url("chat.postMessage"))
            .bearer_auth(&self.bot_token)
            .json(&serde_json::json!({
                "channel": channel_id,
                "text": text,
                "mrkdwn": true
            }))
            .send()
            .await?;

        if !response.status().is_success() {
            let body = response.text().await.unwrap_or_default();
            anyhow::bail!("slack API HTTP error: {body}");
        }

        let result: PostMessageResponse = response.json().await?;

        if !result.ok {
            let err = result.error.as_deref().unwrap_or("unknown");
            anyhow::bail!("slack chat.postMessage error: {err}");
        }

        Ok(())
    }
}

#[async_trait]
impl Channel for SlackChannel {
    fn name(&self) -> &'static str {
        "slack"
    }

    async fn start(&self) -> anyhow::Result<Receiver<IncomingMessage>> {
        let (tx, rx) = mpsc::channel(64);

        // If no channel_id configured we can't poll
        if self.channel_id.is_none() {
            tracing::warn!("slack channel_id not configured, skipping message polling");
            return Ok(rx);
        }

        let bot_token = self.bot_token.clone();
        let client = self.client.clone();
        let Some(channel_id) = self.channel_id.clone() else {
            // Defensive: is_none() early-return above should prevent reaching here
            tracing::error!("slack channel_id unexpectedly None after guard check");
            return Ok(rx);
        };
        let last_ts = Arc::clone(&self.last_ts);

        let token_fingerprint = {
            let mut hasher = Sha256::new();
            hasher.update(bot_token.as_bytes());
            let hash = hasher.finalize();
            let hex = hash[..8].iter().fold(String::new(), |mut out, b| {
                let _ = write!(out, "{b:02x}");
                out
            });
            format!("sha256:{hex}")
        };

        tracing::info!(
            token_fingerprint = %token_fingerprint,
            channel_id = %channel_id,
            "slack channel started"
        );

        tokio::spawn(async move {
            let polling_interval = Duration::from_secs(5);

            loop {
                time::sleep(polling_interval).await;

                let channel = SlackChannel {
                    bot_token: bot_token.clone(),
                    client: client.clone(),
                    channel_id: Some(channel_id.clone()),
                    last_ts: Arc::clone(&last_ts),
                };

                // Snapshot the cursor once so all pagination pages use the same lower bound.
                let oldest = last_ts.lock().await.clone();

                let messages = match channel.get_messages(&channel_id, oldest).await {
                    Ok(m) => m,
                    Err(e) => {
                        tracing::warn!(?e, "failed to get slack messages");
                        continue;
                    }
                };

                // Slack returns messages newest-first; reverse for chronological order
                let mut messages = messages;
                messages.reverse();

                for msg in messages {
                    // Skip non-message types (e.g. channel_join)
                    if msg.msg_type.as_deref() != Some("message") {
                        continue;
                    }

                    // Skip bot messages (including our own)
                    if msg.bot_id.is_some() {
                        continue;
                    }

                    let text = msg.text.clone().unwrap_or_default();
                    if text.is_empty() {
                        continue;
                    }

                    // Update last_ts to the maximum ts seen
                    {
                        let mut last = last_ts.lock().await;
                        if last.as_ref().is_none_or(|prev: &String| msg.ts > *prev) {
                            *last = Some(msg.ts.clone());
                        }
                    }

                    let author = msg.user.clone().unwrap_or_else(|| "unknown".to_string());

                    // Parse Slack ts (Unix seconds with decimal sub-second)
                    let timestamp = msg
                        .ts
                        .split('.')
                        .next()
                        .and_then(|s| s.parse::<i64>().ok())
                        .and_then(|secs| DateTime::from_timestamp(secs, 0))
                        .unwrap_or_else(Utc::now);

                    let incoming = IncomingMessage {
                        channel: "slack".to_string(),
                        id: msg.ts.clone(),
                        thread_id: channel_id.clone(),
                        author,
                        body: text,
                        timestamp,
                        metadata: serde_json::json!({ "channel_id": channel_id }),
                        topic_id: None,
                    };

                    if tx.send(incoming).await.is_err() {
                        tracing::debug!("slack channel receiver dropped");
                        return;
                    }
                }
            }
        });

        Ok(rx)
    }

    async fn send(&self, msg: &OutgoingMessage) -> anyhow::Result<()> {
        let channel_id = self
            .channel_id
            .as_ref()
            .ok_or_else(|| anyhow::anyhow!("slack channel_id not configured"))?;

        self.send_message(channel_id, &msg.body).await
    }

    async fn health_check(&self) -> anyhow::Result<()> {
        let response = self
            .client
            .get(Self::api_url("auth.test"))
            .bearer_auth(&self.bot_token)
            .send()
            .await?;

        if !response.status().is_success() {
            let body = response.text().await.unwrap_or_default();
            anyhow::bail!("slack health check HTTP error: {body}");
        }

        let result: AuthTestResponse = response.json().await?;

        if !result.ok {
            let err = result.error.as_deref().unwrap_or("unknown");
            anyhow::bail!("slack auth.test failed: {err}");
        }

        tracing::info!("slack bot health check passed");
        Ok(())
    }
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn slack_channel_name() {
        let ch = SlackChannel::new("xoxb-test".to_string(), None).unwrap();
        assert_eq!(ch.name(), "slack");
    }

    #[test]
    fn slack_api_url() {
        assert_eq!(
            SlackChannel::api_url("auth.test"),
            "https://slack.com/api/auth.test"
        );
        assert_eq!(
            SlackChannel::api_url("chat.postMessage"),
            "https://slack.com/api/chat.postMessage"
        );
    }

    #[test]
    fn slack_ts_comparison_is_lexicographic() {
        // Slack ts values are strings like "1700000000.123456"
        // Lexicographic comparison works because the integer part is the same width
        let older = "1700000000.000100".to_string();
        let newer = "1700000001.000000".to_string();
        assert!(newer > older);
    }

    #[test]
    fn conversations_history_response_deserializes_pagination_fields() {
        // Response with more pages available
        let json = r#"{
            "ok": true,
            "messages": [{"type": "message", "ts": "1700000001.000000", "text": "hello"}],
            "has_more": true,
            "response_metadata": {"next_cursor": "bmV4dF90czoxNzAwMDAwMDAxLjAwMDAwMA=="}
        }"#;
        let resp: ConversationsHistoryResponse = serde_json::from_str(json).unwrap();
        assert!(resp.ok);
        assert_eq!(resp.has_more, Some(true));
        let meta = resp.response_metadata.unwrap();
        assert_eq!(
            meta.next_cursor.as_deref(),
            Some("bmV4dF90czoxNzAwMDAwMDAxLjAwMDAwMA==")
        );
    }

    #[test]
    fn conversations_history_response_last_page_has_no_cursor() {
        // Final page: has_more=false, empty next_cursor
        let json = r#"{
            "ok": true,
            "messages": [{"type": "message", "ts": "1700000002.000000", "text": "last"}],
            "has_more": false,
            "response_metadata": {"next_cursor": ""}
        }"#;
        let resp: ConversationsHistoryResponse = serde_json::from_str(json).unwrap();
        assert_eq!(resp.has_more, Some(false));
        let next = resp
            .response_metadata
            .and_then(|m| m.next_cursor)
            .filter(|c| !c.is_empty());
        assert!(
            next.is_none(),
            "empty next_cursor should be treated as no more pages"
        );
    }

    #[test]
    fn conversations_history_response_missing_pagination_fields() {
        // Older API responses may omit has_more and response_metadata entirely
        let json = r#"{"ok": true, "messages": []}"#;
        let resp: ConversationsHistoryResponse = serde_json::from_str(json).unwrap();
        assert_eq!(resp.has_more, None);
        assert!(resp.response_metadata.is_none());
        // has_more defaults to false — no pagination loop
        assert!(!resp.has_more.unwrap_or(false));
    }
}