mail4agent_messenger_shell/
cmd.rs

1//! M5: rich agent commands over the client's local socket (mail/Slack-like).
2//! One JSON line `{"cmd":"rooms.list","as":"<nick>", ...}` in, one JSON line
3//! out. No crypto in the request or the answer: the shell encrypts, decrypts
4//! and tracks devices itself. A line without `cmd` is the legacy send request.
5
6use serde::{Deserialize, Serialize};
7use serde_json::{json, Value};
8
9use crate::{
10    mxid_localpart, CreateRoomKind, ItemContent, MessageKind, MessengerCommand, OpenedStore,
11    OutgoingMessage, RoomId, UserId,
12};
13
14/// One command request.
15#[derive(Debug, Clone, Default, Serialize, Deserialize)]
16pub struct CmdRequest {
17    /// Command name, e.g. `rooms.list`.
18    pub cmd: String,
19    /// Session nick that runs the command.
20    #[serde(rename = "as")]
21    pub as_nick: String,
22    /// Command arguments (command specific).
23    #[serde(default)]
24    pub args: Value,
25}
26
27/// The answer to one [`CmdRequest`].
28#[derive(Debug, Clone, Default, Serialize, Deserialize)]
29pub struct CmdReply {
30    /// Success flag.
31    pub ok: bool,
32    /// Why it failed. No secrets.
33    #[serde(default, skip_serializing_if = "Option::is_none")]
34    pub error: Option<String>,
35    /// Command result.
36    #[serde(default)]
37    pub data: Value,
38}
39
40impl CmdReply {
41    /// A failed reply.
42    pub fn failed(error: impl Into<String>) -> Self {
43        Self { ok: false, error: Some(error.into()), data: Value::Null }
44    }
45    fn ok(data: Value) -> Self {
46        Self { ok: true, error: None, data }
47    }
48}
49
50fn arg_str<'a>(args: &'a Value, key: &str) -> Option<&'a str> {
51    args.get(key).and_then(Value::as_str).map(str::trim).filter(|v| !v.is_empty())
52}
53
54impl OpenedStore {
55    /// Display title of a room: its name, or the other members for a DM/group.
56    fn room_title(&self, room_id: &RoomId) -> String {
57        let me = self.driver.core.user_id().clone();
58        let Some(state) = self.driver.core.room_state(room_id) else { return String::new() };
59        if let Some(name) = state.name.as_deref().filter(|n| !n.is_empty()) {
60            return name.to_string();
61        }
62        let others: Vec<String> = state
63            .members
64            .iter()
65            .filter(|(id, _)| **id != me)
66            .map(|(id, m)| m.displayname.clone().unwrap_or_else(|| mxid_localpart(id.as_str()).to_string()))
67            .collect();
68        others.join(", ")
69    }
70
71    /// Resolves `room` (id, `#name`, name, or a nick for a DM) to a joined room id.
72    fn resolve_room(&mut self, spec: &str, now_ms: i64) -> Result<RoomId, String> {
73        if spec.starts_with('!') {
74            return RoomId::parse(spec).map_err(|e| e.to_string());
75        }
76        let wanted = spec.trim_start_matches(['#', '@']).to_ascii_lowercase();
77        let ids: Vec<RoomId> = self.driver.core.room_ids().cloned().collect();
78        let by_name: Vec<RoomId> = ids
79            .iter()
80            .filter(|id| self.room_title(id).to_ascii_lowercase() == wanted)
81            .cloned()
82            .collect();
83        if by_name.len() == 1 {
84            return Ok(by_name[0].clone());
85        }
86        if by_name.len() > 1 {
87            return Err(format!("{spec} matches several rooms; use the room id"));
88        }
89        if spec.starts_with('#') {
90            return Err(format!("no room named {spec}"));
91        }
92        let id = self.ensure_dm(spec, now_ms).map_err(|e| format!("{spec}: {e}"))?;
93        RoomId::parse(&id).map_err(|e| e.to_string())
94    }
95
96    fn settle_cmd(&mut self, now_ms: i64) {
97        for i in 1..=6 {
98            let _ = self.drive(now_ms + i * 1_000, false);
99            std::thread::sleep(std::time::Duration::from_millis(200));
100        }
101    }
102
103    fn rows(&self, room_id: &RoomId, limit: usize) -> Vec<Value> {
104        let Some(timeline) = self.driver.core.timeline(room_id) else { return Vec::new() };
105        let mut out: Vec<Value> = timeline
106            .items()
107            .iter()
108            .filter_map(|item| {
109                let (kind, body) = match &item.content {
110                    ItemContent::Text(t) => ("text", t.body.clone()),
111                    ItemContent::Notice(t) => ("notice", t.body.clone()),
112                    ItemContent::Emote(t) => ("emote", t.body.clone()),
113                    ItemContent::Undecryptable { .. } => ("undecryptable", String::new()),
114                    _ => return None,
115                };
116                Some(json!({
117                    "event_id": item.event_id.as_ref().map(|e| e.as_str()),
118                    "from": mxid_localpart(item.sender.as_str()),
119                    "from_id": item.sender.as_str(),
120                    "ts": item.origin_server_ts,
121                    "kind": kind,
122                    "body": body,
123                    "reply_to": item.relations.reply_to.as_ref().map(|e| e.as_str()),
124                    "thread": item.relations.thread_root.as_ref().map(|e| e.as_str()),
125                    "state": crate::outcome_name(&item.send_state),
126                }))
127            })
128            .collect();
129        let skip = out.len().saturating_sub(limit);
130        out.drain(..skip);
131        out
132    }
133
134    fn send_into(&mut self, room: &RoomId, text: &str, reply_to: Option<&str>, now_ms: i64) -> CmdReply {
135        let reply_to = match reply_to {
136            Some(id) => match crate::EventId::parse(id) {
137                Ok(id) => Some(id),
138                Err(e) => return CmdReply::failed(format!("event id: {e}")),
139            },
140            None => None,
141        };
142        // Refuse here, not at the server: a send into a room this session is not in only earns a refusal
143        // that would be stored as a failed row.
144        let me = self.driver.core.user_id().as_str().to_string();
145        if !self.member_joined(room.as_str(), &me) {
146            return CmdReply::failed("this session has not joined that room (join it first)");
147        }
148        let before = self.texts().len();
149        if let Err(e) = self.dispatch(
150            MessengerCommand::SendMessage {
151                room_id: room.clone(),
152                message: OutgoingMessage { kind: MessageKind::Text, body: text.to_string(), reply_to, edit_of: None },
153                txn_id: None,
154            },
155            now_ms,
156        ) {
157            return CmdReply::failed(format!("send: {e}"));
158        }
159        let mut t = now_ms;
160        for _ in 0..30 {
161            t += 1_000;
162            let _ = self.drive(t, false);
163            std::thread::sleep(std::time::Duration::from_millis(200));
164            if let Some(row) = self.texts().into_iter().rev().find(|r| r.room_id == room.as_str() && r.body == text) {
165                if row.outcome == "sent" {
166                    return CmdReply::ok(json!({ "room": room.as_str(), "event_id": row.event_id }));
167                }
168                if row.outcome.starts_with("failed") {
169                    return CmdReply::failed(format!("send {}", row.outcome));
170                }
171            }
172        }
173        let _ = before;
174        CmdReply::failed("send not confirmed yet (queued)")
175    }
176
177    /// Runs one rich command for this session.
178    pub fn run_command(&mut self, req: &CmdRequest, now_ms: i64) -> CmdReply {
179        let a = &req.args;
180        match req.cmd.as_str() {
181            "rooms.list" => {
182                let rooms: Vec<Value> = self
183                    .rooms()
184                    .into_iter()
185                    .filter(|r| r.membership != "absent" && r.membership != "leave")
186                    .map(|r| {
187                        let id = RoomId::parse(&r.room_id).ok();
188                        let title = id.as_ref().map(|i| self.room_title(i)).unwrap_or_default();
189                        let last = id.as_ref().and_then(|i| self.rows(i, 1).into_iter().next());
190                        json!({ "room": r.room_id, "title": title, "membership": r.membership,
191                                "encrypted": r.encrypted, "last": last })
192                    })
193                    .collect();
194                CmdReply::ok(json!({ "rooms": rooms }))
195            }
196            "rooms.read" => {
197                let Some(spec) = arg_str(a, "room") else { return CmdReply::failed("room is required") };
198                let limit = a.get("limit").and_then(Value::as_u64).unwrap_or(20).min(200) as usize;
199                match self.resolve_room(spec, now_ms) {
200                    Ok(id) => CmdReply::ok(json!({ "room": id.as_str(), "title": self.room_title(&id), "messages": self.rows(&id, limit) })),
201                    Err(e) => CmdReply::failed(e),
202                }
203            }
204            "rooms.send" | "rooms.reply" => {
205                let (Some(spec), Some(text)) = (arg_str(a, "room"), arg_str(a, "text")) else {
206                    return CmdReply::failed("room and text are required");
207                };
208                let reply_to = if req.cmd == "rooms.reply" {
209                    match arg_str(a, "event") {
210                        Some(e) => Some(e),
211                        None => return CmdReply::failed("event is required for a reply"),
212                    }
213                } else {
214                    None
215                };
216                match self.resolve_room(spec, now_ms) {
217                    Ok(id) => self.send_into(&id, text, reply_to, now_ms),
218                    Err(e) => CmdReply::failed(e),
219                }
220            }
221            "rooms.join" | "rooms.leave" => {
222                let Some(spec) = arg_str(a, "room") else { return CmdReply::failed("room is required") };
223                let id = match self.resolve_room(spec, now_ms) {
224                    Ok(id) => id,
225                    Err(e) => return CmdReply::failed(e),
226                };
227                let command = if req.cmd == "rooms.join" {
228                    MessengerCommand::JoinRoom { room_id: id.clone() }
229                } else {
230                    MessengerCommand::LeaveRoom { room_id: id.clone() }
231                };
232                match self.dispatch(command, now_ms) {
233                    Ok(()) => {
234                        self.settle_cmd(now_ms);
235                        CmdReply::ok(json!({ "room": id.as_str() }))
236                    }
237                    Err(e) => CmdReply::failed(e.to_string()),
238                }
239            }
240            "rooms.create" => {
241                let Some(name) = arg_str(a, "name") else { return CmdReply::failed("name is required") };
242                let invite: Vec<UserId> = a
243                    .get("invite")
244                    .and_then(Value::as_array)
245                    .map(|v| v.iter().filter_map(Value::as_str).filter_map(|u| UserId::parse(u).ok()).collect())
246                    .unwrap_or_default();
247                let kind = match arg_str(a, "kind").unwrap_or("group") {
248                    "channel" => CreateRoomKind::Channel { name: name.to_string(), topic: arg_str(a, "topic").map(str::to_string) },
249                    "group" => CreateRoomKind::Group { name: name.to_string(), invite, members_can_invite: true },
250                    other => return CmdReply::failed(format!("kind must be channel or group, not {other}")),
251                };
252                match self.dispatch(MessengerCommand::CreateRoom { kind }, now_ms) {
253                    Ok(()) => {
254                        let mut found = None;
255                        for i in 1..=25 {
256                            let _ = self.drive(now_ms + i * 1_000, false);
257                            std::thread::sleep(std::time::Duration::from_millis(200));
258                            found = self.rooms().into_iter().find(|r| {
259                                r.membership == "join"
260                                    && RoomId::parse(&r.room_id).map(|i| self.room_title(&i) == name).unwrap_or(false)
261                            });
262                            if found.is_some() {
263                                break;
264                            }
265                        }
266                        CmdReply::ok(json!({ "room": found.map(|r| r.room_id) }))
267                    }
268                    Err(e) => CmdReply::failed(e.to_string()),
269                }
270            }
271            "rooms.invite" => {
272                let (Some(spec), Some(who)) = (arg_str(a, "room"), arg_str(a, "user")) else {
273                    return CmdReply::failed("room and user are required");
274                };
275                let id = match self.resolve_room(spec, now_ms) {
276                    Ok(id) => id,
277                    Err(e) => return CmdReply::failed(e),
278                };
279                let user = if who.starts_with('@') && who.contains(':') {
280                    who.to_string()
281                } else {
282                    match self.find_nick(who, now_ms) {
283                        Ok(found) => found.user_id,
284                        Err(e) => return CmdReply::failed(format!("{who}: {e}")),
285                    }
286                };
287                let Ok(user_id) = UserId::parse(&user) else { return CmdReply::failed("bad user id") };
288                match self.dispatch(MessengerCommand::Invite { room_id: id.clone(), user_id }, now_ms) {
289                    Ok(()) => {
290                        self.settle_cmd(now_ms);
291                        CmdReply::ok(json!({ "room": id.as_str() }))
292                    }
293                    Err(e) => CmdReply::failed(e.to_string()),
294                }
295            }
296            "mentions" => {
297                let limit = a.get("limit").and_then(Value::as_u64).unwrap_or(20).min(200) as usize;
298                let me = self.nick().unwrap_or("").to_ascii_lowercase();
299                let my_id = self.driver.core.user_id().as_str().to_string();
300                let ids: Vec<RoomId> = self.driver.core.room_ids().cloned().collect();
301                let mut hits = Vec::new();
302                for id in ids {
303                    for mut row in self.rows(&id, 200) {
304                        let body = row["body"].as_str().unwrap_or("").to_ascii_lowercase();
305                        let from_me = row["from_id"].as_str() == Some(my_id.as_str());
306                        if !from_me && !me.is_empty() && body.contains(&format!("@{me}")) {
307                            row["room"] = json!(id.as_str());
308                            hits.push(row);
309                        }
310                    }
311                }
312                hits.sort_by_key(|r| r["ts"].as_i64().unwrap_or(0));
313                let skip = hits.len().saturating_sub(limit);
314                hits.drain(..skip);
315                CmdReply::ok(json!({ "mentions": hits }))
316            }
317            "threads.read" => {
318                let (Some(spec), Some(root)) = (arg_str(a, "room"), arg_str(a, "event")) else {
319                    return CmdReply::failed("room and event are required");
320                };
321                match self.resolve_room(spec, now_ms) {
322                    Ok(id) => {
323                        let rows: Vec<Value> = self
324                            .rows(&id, 500)
325                            .into_iter()
326                            .filter(|r| r["event_id"].as_str() == Some(root) || r["thread"].as_str() == Some(root) || r["reply_to"].as_str() == Some(root))
327                            .collect();
328                        CmdReply::ok(json!({ "room": id.as_str(), "messages": rows }))
329                    }
330                    Err(e) => CmdReply::failed(e),
331                }
332            }
333            other => CmdReply::failed(format!("unknown command {other}")),
334        }
335    }
336}
mail4agent_messenger_shell/cmd.rs

mail4agent_messenger_shell/
cmd.rs
