postvak 0.3.0

A fast, simple mail client with automatic mailbox rules
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80

//! `postvak mcp`: the agent surface over MCP on stdio, limited by scopes set in the host's config.
mod backend;
pub mod install;
#[cfg(test)]
mod junk_sweep;
#[cfg(test)]
mod tests;
mod tools;

use std::collections::BTreeSet;

use anyhow::{Result, bail};
use rmcp::ServiceExt;

pub use backend::Backend;
pub use tools::Server;

use crate::config::Config;
use crate::paths::Paths;

#[derive(Clone, Copy, Debug, PartialEq, Eq, PartialOrd, Ord)]
pub enum Scope {
    MailModify,
    Read,
    ReadBodies,
    RulesPropose,
    RulesWrite,
}

impl Scope {
    pub const ALL: [Scope; 5] = [
        Scope::Read,
        Scope::ReadBodies,
        Scope::RulesPropose,
        Scope::RulesWrite,
        Scope::MailModify,
    ];

    pub fn as_str(self) -> &'static str {
        match self {
            Scope::MailModify => "mail:modify",
            Scope::Read => "read",
            Scope::ReadBodies => "read:bodies",
            Scope::RulesPropose => "rules:propose",
            Scope::RulesWrite => "rules:write",
        }
    }
}

/// A comma-separated scope list; an unknown scope, or none at all, names the valid ones.
pub fn parse_scopes(list: &str) -> Result<BTreeSet<Scope>> {
    let valid = || Scope::ALL.map(Scope::as_str).join(", ");
    let mut scopes = BTreeSet::new();
    for word in list.split(',').map(str::trim).filter(|w| !w.is_empty()) {
        match Scope::ALL.into_iter().find(|s| s.as_str() == word) {
            Some(scope) => scopes.insert(scope),
            None => bail!("unknown scope '{word}'; valid scopes: {}", valid()),
        };
    }
    if scopes.is_empty() {
        bail!("no scopes given; valid scopes: {}", valid());
    }
    Ok(scopes)
}

/// Serves on stdin and stdout until the host closes the pipe.
pub fn run(config: &Config, paths: &Paths, scopes: &str, accounts: &[String]) -> Result<()> {
    let server = Server::new(
        Backend::new(config, paths, accounts)?,
        parse_scopes(scopes)?,
    );
    let runtime = tokio::runtime::Builder::new_current_thread()
        .enable_all()
        .build()?;
    runtime.block_on(async {
        let running = server.serve(rmcp::transport::stdio()).await?;
        running.waiting().await?;
        Ok(())
    })
}