Merge pull request 'humhub: Direktnachrichten senden (mail-send)' (#8) from feat/humhub-mail into main

Reviewed-on: #8

plugins/humhub/skills/humhub/SKILL.md

@@ -91,6 +91,32 @@ Beide nehmen wie `fetch` eine **Content-ID** oder Perma-URL (nicht die Post-/
 Wiki-Seiten-ID) und lösen das Zielobjekt selbst auf — funktioniert für Posts
 und Wiki-Seiten.
 
+### Direktnachrichten
+
+```bash
+./humhub.py mail-send  <empfaenger> "<betreff>" [datei|-]
+./humhub.py mail-send  https://humhub.inmedias.it/u/serge/ "Betreff" entwurf.md
+./humhub.py mail-send  jan.stobbe,26 "Betreff" -
+./humhub.py mail-reply <konversations-id> [datei|-]
+```
+
+Empfänger sind Benutzername, Profil-URL oder numerische ID; mehrere mit Komma.
+
+`mail-reply` hängt einen Beitrag an eine bestehende Konversation
+(`POST /mail/<id>/entry`). Die ID steht in der URL der Konversation:
+`…/mail/mail/index?id=35`.
+
+**Slug ≠ Benutzername.** Zur Profil-URL `/u/serge/` gehört der Benutzername
+`Serge`, und `get-by-username` unterscheidet Groß-/Kleinschreibung. Wer den
+Slug einsetzt, bekommt sonst `User not found!`. `mail-send` fängt das ab: erst
+`get-by-username`, dann ein Durchlauf der Benutzerliste, der Benutzername und
+Slug ohne Rücksicht auf Groß-/Kleinschreibung vergleicht.
+
+Zum Lesen von Konversationen gibt es bewusst keinen Befehl — Nachrichten
+anderer gehören nicht ungefragt in einen Modellkontext. Auch `mail-reply`
+holt den Verlauf nicht ab, sondern prüft nur, ob die Konversation erreichbar
+ist.
+
 Inhalte (Markdown) aus Datei oder `-` (stdin) übergeben — nicht als langes
 Shell-Argument (Sonderzeichen). `container_id` akzeptiert eine numerische
 Container-ID, einen **Space-Slug** oder eine **Space-URL** (`resolve_container`

plugins/humhub/skills/humhub/humhub.py

@@ -348,6 +348,76 @@ def cmd_comment_create(args: argparse.Namespace) -> None:
     print(f"Perma: https://humhub.inmedias.it/content/perma?id={content_id}")
 
 
+# ── Mail (Direktnachrichten) ─────────────────────────────────────────────────
+
+def resolve_user(session: requests.Session, value: str) -> int:
+    """Resolve a user ID, username, or profile URL (…/u/<slug>/) to a user ID.
+
+    Slug und Benutzername sind nicht dasselbe: zu https://…/u/serge/ gehört der
+    Benutzername "Serge". `get-by-username` kennt nur den Benutzernamen und
+    unterscheidet Groß-/Kleinschreibung — deshalb der Fallback über die
+    Benutzerliste, der auch den Slug vergleicht.
+    """
+    value = value.strip()
+    if value.isdigit():
+        return int(value)
+    name = value
+    if "/" in value:
+        teile = [t for t in urlparse(value).path.split("/") if t]
+        if teile:
+            name = teile[-1]
+
+    r = session.get(f"{BASE_URL}/user/get-by-username",
+                    params={"username": name})
+    if r.ok:
+        return int(r.json()["id"])
+
+    page = 1
+    while True:
+        data = api_get(session, f"/user?limit=50&page={page}")
+        results = data.get("results", [])
+        for u in results:
+            username = (u.get("account") or {}).get("username", "")
+            slug_teile = [t for t in urlparse(u.get("url", "")).path.split("/") if t]
+            slug = slug_teile[-1] if slug_teile else ""
+            if name.lower() in (username.lower(), slug.lower()):
+                return int(u["id"])
+        if len(results) < 50:
+            break
+        page += 1
+    sys.exit(f"Error: Benutzer {value!r} nicht gefunden")
+
+
+def cmd_mail_send(args: argparse.Namespace) -> None:
+    session, _ = get_session()
+    ids = [resolve_user(session, teil) for teil in args.to.split(",") if teil.strip()]
+    if not ids:
+        sys.exit("Error: kein Empfänger angegeben")
+    message = read_file(args.file)
+    data = api_post(session, "/mail", {
+        "title": args.title,
+        "message": message,
+        "recipient": ids,
+    })
+    empfaenger = ", ".join(str(i) for i in ids)
+    print(f"Nachricht gesendet (Konversation {data.get('id')}) an Benutzer {empfaenger}")
+
+
+def cmd_mail_reply(args: argparse.Namespace) -> None:
+    """Antwortet in einer bestehenden Konversation.
+
+    Bewusst ohne Lesebefehl: der Text der Konversation wird nicht abgerufen,
+    nur ihre Erreichbarkeit geprueft.
+    """
+    session, _ = get_session()
+    message = read_file(args.file)
+    r = session.get(f"{BASE_URL}/mail/{args.id}")
+    if not r.ok:
+        sys.exit(f"Error {r.status_code}: Konversation {args.id} nicht erreichbar")
+    data = api_post(session, f"/mail/{args.id}/entry", {"message": message})
+    print(f"Antwort geschrieben (Eintrag {data.get('id')}) in Konversation {args.id}")
+
+
 # ── Fetch (perma-/content-id-agnostisch) ─────────────────────────────────────
 
 def parse_content_ref(ref: str) -> int:
@@ -513,6 +583,19 @@ def main() -> None:
     p.add_argument("file", help="Markdown-Datei oder '-' für stdin")
     p.set_defaults(func=cmd_comment_create)
 
+    # mail-send
+    p = sub.add_parser("mail-send", help="Direktnachricht an Benutzer senden")
+    p.add_argument("to", help="Benutzername, Profil-URL oder ID; mehrere mit Komma")
+    p.add_argument("title", help="Betreff")
+    p.add_argument("file", help="Markdown-Datei oder '-' für stdin")
+    p.set_defaults(func=cmd_mail_send)
+
+    # mail-reply
+    p = sub.add_parser("mail-reply", help="In einer bestehenden Konversation antworten")
+    p.add_argument("id", type=int, help="Konversations-ID (aus /mail/mail/index?id=NN)")
+    p.add_argument("file", help="Markdown-Datei oder '-' für stdin")
+    p.set_defaults(func=cmd_mail_reply)
+
     # post-update
     p = sub.add_parser("post-update", help="Post aktualisieren")
     p.add_argument("id", type=int, help="Post-ID")