agent-first-mail 0.1.0

Give your AI agent a mailbox it can actually work in — your mail pulled down into plain files it reads, triages, drafts, and files entirely on your machine, with nothing sent or changed on the real mailbox until you confirm.
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

use clap::Subcommand;

#[derive(Subcommand, Debug)]
pub enum MessageAction {
    /// Show the full local message metadata, body text, and attachment metadata.
    Show {
        /// Message id, for example message_inbox_607146690_22.
        message_id: String,
    },
    /// File this message into a direct-message archive category and queue eligible IMAP moves.
    Archive {
        /// Message id, for example message_inbox_607146690_22.
        message_id: String,
        /// Direct-message archive category ref: aYYYYMMDDNNN or aYYYYMMDDNNN-any-suffix.
        archive_ref: String,
        /// Human/agent-authored summary for this archive entry.
        #[arg(long)]
        summary: String,
        /// Why this disposition is correct; required by default.
        #[arg(long)]
        reason: Option<String>,
    },
    /// Mark junk/phishing/malware/suspicious mail locally, show it under spam/, and queue a Junk move.
    Spam {
        /// Message id, for example message_inbox_607146690_22.
        message_id: String,
        /// Why this disposition is correct; required by default.
        #[arg(long)]
        reason: Option<String>,
    },
    /// Undo a local spam mark before queued remote effects are pushed.
    Unspam {
        /// Message id, for example message_inbox_607146690_22.
        message_id: String,
        /// Why this spam mark should be undone; required by default.
        #[arg(long)]
        reason: Option<String>,
    },
    /// Explicitly discard this message locally, show it under trash/, and queue a Trash move.
    Trash {
        /// Message id, for example message_inbox_607146690_22.
        message_id: String,
        /// Why this disposition is correct; required by default.
        #[arg(long)]
        reason: Option<String>,
    },
    /// Undo a local trash mark before queued remote effects are pushed.
    Untrash {
        /// Message id, for example message_inbox_607146690_22.
        message_id: String,
        /// Why this trash mark should be undone; required by default.
        #[arg(long)]
        reason: Option<String>,
    },
    /// Restore a directly archived message to triage.
    Unarchive {
        /// Message id, for example message_inbox_607146690_22.
        message_id: String,
        /// Why this archive should be undone; required by default.
        #[arg(long)]
        reason: Option<String>,
    },
    /// Fetch an attachment for this message.
    Attachment {
        #[command(subcommand)]
        action: MessageAttachmentAction,
    },
}

#[derive(Subcommand, Debug)]
pub enum MessageAttachmentAction {
    /// Fetch one attachment by MIME part id, or all attachments when omitted.
    Fetch {
        /// Message id, for example message_inbox_607146690_22.
        message_id: String,
        part_id: Option<String>,
    },
}