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        let before = self.texts().len();
143        if let Err(e) = self.dispatch(
144            MessengerCommand::SendMessage {
145                room_id: room.clone(),
146                message: OutgoingMessage { kind: MessageKind::Text, body: text.to_string(), reply_to, edit_of: None },
147                txn_id: None,
148            },
149            now_ms,
150        ) {
151            return CmdReply::failed(format!("send: {e}"));
152        }
153        let mut t = now_ms;
154        for _ in 0..30 {
155            t += 1_000;
156            let _ = self.drive(t, false);
157            std::thread::sleep(std::time::Duration::from_millis(200));
158            if let Some(row) = self.texts().into_iter().rev().find(|r| r.room_id == room.as_str() && r.body == text) {
159                if row.outcome == "sent" {
160                    return CmdReply::ok(json!({ "room": room.as_str(), "event_id": row.event_id }));
161                }
162                if row.outcome.starts_with("failed") {
163                    return CmdReply::failed("send failed");
164                }
165            }
166        }
167        let _ = before;
168        CmdReply::failed("send not confirmed yet (queued)")
169    }
170
171    /// Runs one rich command for this session.
172    pub fn run_command(&mut self, req: &CmdRequest, now_ms: i64) -> CmdReply {
173        let a = &req.args;
174        match req.cmd.as_str() {
175            "rooms.list" => {
176                let rooms: Vec<Value> = self
177                    .rooms()
178                    .into_iter()
179                    .filter(|r| r.membership != "absent" && r.membership != "leave")
180                    .map(|r| {
181                        let id = RoomId::parse(&r.room_id).ok();
182                        let title = id.as_ref().map(|i| self.room_title(i)).unwrap_or_default();
183                        let last = id.as_ref().and_then(|i| self.rows(i, 1).into_iter().next());
184                        json!({ "room": r.room_id, "title": title, "membership": r.membership,
185                                "encrypted": r.encrypted, "last": last })
186                    })
187                    .collect();
188                CmdReply::ok(json!({ "rooms": rooms }))
189            }
190            "rooms.read" => {
191                let Some(spec) = arg_str(a, "room") else { return CmdReply::failed("room is required") };
192                let limit = a.get("limit").and_then(Value::as_u64).unwrap_or(20).min(200) as usize;
193                match self.resolve_room(spec, now_ms) {
194                    Ok(id) => CmdReply::ok(json!({ "room": id.as_str(), "title": self.room_title(&id), "messages": self.rows(&id, limit) })),
195                    Err(e) => CmdReply::failed(e),
196                }
197            }
198            "rooms.send" | "rooms.reply" => {
199                let (Some(spec), Some(text)) = (arg_str(a, "room"), arg_str(a, "text")) else {
200                    return CmdReply::failed("room and text are required");
201                };
202                let reply_to = if req.cmd == "rooms.reply" {
203                    match arg_str(a, "event") {
204                        Some(e) => Some(e),
205                        None => return CmdReply::failed("event is required for a reply"),
206                    }
207                } else {
208                    None
209                };
210                match self.resolve_room(spec, now_ms) {
211                    Ok(id) => self.send_into(&id, text, reply_to, now_ms),
212                    Err(e) => CmdReply::failed(e),
213                }
214            }
215            "rooms.join" | "rooms.leave" => {
216                let Some(spec) = arg_str(a, "room") else { return CmdReply::failed("room is required") };
217                let id = match self.resolve_room(spec, now_ms) {
218                    Ok(id) => id,
219                    Err(e) => return CmdReply::failed(e),
220                };
221                let command = if req.cmd == "rooms.join" {
222                    MessengerCommand::JoinRoom { room_id: id.clone() }
223                } else {
224                    MessengerCommand::LeaveRoom { room_id: id.clone() }
225                };
226                match self.dispatch(command, now_ms) {
227                    Ok(()) => {
228                        self.settle_cmd(now_ms);
229                        CmdReply::ok(json!({ "room": id.as_str() }))
230                    }
231                    Err(e) => CmdReply::failed(e.to_string()),
232                }
233            }
234            "rooms.create" => {
235                let Some(name) = arg_str(a, "name") else { return CmdReply::failed("name is required") };
236                let invite: Vec<UserId> = a
237                    .get("invite")
238                    .and_then(Value::as_array)
239                    .map(|v| v.iter().filter_map(Value::as_str).filter_map(|u| UserId::parse(u).ok()).collect())
240                    .unwrap_or_default();
241                let kind = match arg_str(a, "kind").unwrap_or("group") {
242                    "channel" => CreateRoomKind::Channel { name: name.to_string(), topic: arg_str(a, "topic").map(str::to_string) },
243                    "group" => CreateRoomKind::Group { name: name.to_string(), invite, members_can_invite: true },
244                    other => return CmdReply::failed(format!("kind must be channel or group, not {other}")),
245                };
246                match self.dispatch(MessengerCommand::CreateRoom { kind }, now_ms) {
247                    Ok(()) => {
248                        let mut found = None;
249                        for i in 1..=25 {
250                            let _ = self.drive(now_ms + i * 1_000, false);
251                            std::thread::sleep(std::time::Duration::from_millis(200));
252                            found = self.rooms().into_iter().find(|r| {
253                                r.membership == "join"
254                                    && RoomId::parse(&r.room_id).map(|i| self.room_title(&i) == name).unwrap_or(false)
255                            });
256                            if found.is_some() {
257                                break;
258                            }
259                        }
260                        CmdReply::ok(json!({ "room": found.map(|r| r.room_id) }))
261                    }
262                    Err(e) => CmdReply::failed(e.to_string()),
263                }
264            }
265            "rooms.invite" => {
266                let (Some(spec), Some(who)) = (arg_str(a, "room"), arg_str(a, "user")) else {
267                    return CmdReply::failed("room and user are required");
268                };
269                let id = match self.resolve_room(spec, now_ms) {
270                    Ok(id) => id,
271                    Err(e) => return CmdReply::failed(e),
272                };
273                let user = if who.starts_with('@') && who.contains(':') {
274                    who.to_string()
275                } else {
276                    match self.find_nick(who, now_ms) {
277                        Ok(found) => found.user_id,
278                        Err(e) => return CmdReply::failed(format!("{who}: {e}")),
279                    }
280                };
281                let Ok(user_id) = UserId::parse(&user) else { return CmdReply::failed("bad user id") };
282                match self.dispatch(MessengerCommand::Invite { room_id: id.clone(), user_id }, now_ms) {
283                    Ok(()) => {
284                        self.settle_cmd(now_ms);
285                        CmdReply::ok(json!({ "room": id.as_str() }))
286                    }
287                    Err(e) => CmdReply::failed(e.to_string()),
288                }
289            }
290            "mentions" => {
291                let limit = a.get("limit").and_then(Value::as_u64).unwrap_or(20).min(200) as usize;
292                let me = self.nick().unwrap_or("").to_ascii_lowercase();
293                let my_id = self.driver.core.user_id().as_str().to_string();
294                let ids: Vec<RoomId> = self.driver.core.room_ids().cloned().collect();
295                let mut hits = Vec::new();
296                for id in ids {
297                    for mut row in self.rows(&id, 200) {
298                        let body = row["body"].as_str().unwrap_or("").to_ascii_lowercase();
299                        let from_me = row["from_id"].as_str() == Some(my_id.as_str());
300                        if !from_me && !me.is_empty() && body.contains(&format!("@{me}")) {
301                            row["room"] = json!(id.as_str());
302                            hits.push(row);
303                        }
304                    }
305                }
306                hits.sort_by_key(|r| r["ts"].as_i64().unwrap_or(0));
307                let skip = hits.len().saturating_sub(limit);
308                hits.drain(..skip);
309                CmdReply::ok(json!({ "mentions": hits }))
310            }
311            "threads.read" => {
312                let (Some(spec), Some(root)) = (arg_str(a, "room"), arg_str(a, "event")) else {
313                    return CmdReply::failed("room and event are required");
314                };
315                match self.resolve_room(spec, now_ms) {
316                    Ok(id) => {
317                        let rows: Vec<Value> = self
318                            .rows(&id, 500)
319                            .into_iter()
320                            .filter(|r| r["event_id"].as_str() == Some(root) || r["thread"].as_str() == Some(root) || r["reply_to"].as_str() == Some(root))
321                            .collect();
322                        CmdReply::ok(json!({ "room": id.as_str(), "messages": rows }))
323                    }
324                    Err(e) => CmdReply::failed(e),
325                }
326            }
327            other => CmdReply::failed(format!("unknown command {other}")),
328        }
329    }
330}
mail4agent_messenger_shell/cmd.rs

mail4agent_messenger_shell/
cmd.rs
