feat(mac-worker): LaunchAgent für Dauerbetrieb auf dem Mac

- com.voiceagent.worker.plist.template — User-LaunchAgent mit RunAtLoad, KeepAlive(Crashed=true), ProcessType=Interactive für MLX/Metal-Zugriff - install-launchagent.sh — generiert plist mit Pfaden, lädt via launchctl, prüft Health-Endpoint; unterstützt install/uninstall/status - READMEs: Abschnitt "Worker als Dienst" mit Verwaltungs-Befehlen
2026-05-13 22:30:50 +00:00
parent 0bbb7bbacd
commit 955075e3fd
4 changed files with 205 additions and 2 deletions
@@ -0,0 +1,54 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+    <key>Label</key>
+    <string>com.voiceagent.worker</string>
+
+    <key>WorkingDirectory</key>
+    <string>__WORKDIR__</string>
+
+    <key>ProgramArguments</key>
+    <array>
+        <string>__WORKDIR__/.venv/bin/uvicorn</string>
+        <string>app.main:app</string>
+        <string>--host</string>
+        <string>0.0.0.0</string>
+        <string>--port</string>
+        <string>8080</string>
+    </array>
+
+    <key>EnvironmentVariables</key>
+    <dict>
+        <key>PATH</key>
+        <string>__WORKDIR__/.venv/bin:/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin</string>
+        <key>HOME</key>
+        <string>__HOME__</string>
+        <key>PYTHONUNBUFFERED</key>
+        <string>1</string>
+    </dict>
+
+    <key>RunAtLoad</key>
+    <true/>
+
+    <key>KeepAlive</key>
+    <dict>
+        <key>SuccessfulExit</key>
+        <false/>
+        <key>Crashed</key>
+        <true/>
+    </dict>
+
+    <key>ThrottleInterval</key>
+    <integer>10</integer>
+
+    <key>ProcessType</key>
+    <string>Interactive</string>
+
+    <key>StandardOutPath</key>
+    <string>__HOME__/Library/Logs/voice-agent-worker.out.log</string>
+
+    <key>StandardErrorPath</key>
+    <string>__HOME__/Library/Logs/voice-agent-worker.err.log</string>
+</dict>
+</plist>
@@ -0,0 +1,103 @@
+#!/usr/bin/env bash
+# Installiert den Voice-Agent Mac-Worker als LaunchAgent.
+# Idempotent — kann zum Update wiederholt laufen.
+#
+# Nutzung:
+#   ./install-launchagent.sh           # installieren / aktualisieren
+#   ./install-launchagent.sh uninstall # entfernen
+#   ./install-launchagent.sh status    # Status + letzte Logs
+set -euo pipefail
+
+LABEL="com.voiceagent.worker"
+PLIST_DST="$HOME/Library/LaunchAgents/${LABEL}.plist"
+LOG_DIR="$HOME/Library/Logs"
+
+# Verzeichnis dieses Skripts → Repo-Root/mac-worker
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+WORKDIR="$(cd "$SCRIPT_DIR/.." && pwd)"
+TEMPLATE="$SCRIPT_DIR/com.voiceagent.worker.plist.template"
+
+cmd="${1:-install}"
+
+uninstall() {
+    if [ -f "$PLIST_DST" ]; then
+        echo "[*] Stoppe und entlade LaunchAgent…"
+        launchctl unload "$PLIST_DST" 2>/dev/null || true
+        rm -f "$PLIST_DST"
+        echo "[✓] $PLIST_DST entfernt."
+    else
+        echo "[i] Kein LaunchAgent installiert ($PLIST_DST nicht vorhanden)."
+    fi
+}
+
+show_status() {
+    echo "── launchctl list | grep $LABEL ─────────────────────────"
+    launchctl list | grep "$LABEL" || echo "(nicht geladen)"
+    echo
+    echo "── Health-Check ─────────────────────────────────────────"
+    curl -fsS http://127.0.0.1:8080/health 2>/dev/null && echo || echo "(nicht erreichbar)"
+    echo
+    echo "── stderr.log (letzte 30 Zeilen) ────────────────────────"
+    tail -n 30 "$LOG_DIR/voice-agent-worker.err.log" 2>/dev/null || echo "(keine Logs)"
+}
+
+install_agent() {
+    # Vorbedingungen prüfen
+    if [ ! -x "$WORKDIR/.venv/bin/uvicorn" ]; then
+        echo "FEHLER: $WORKDIR/.venv/bin/uvicorn nicht gefunden." >&2
+        echo "Bitte zuerst die Python-Umgebung einrichten:" >&2
+        echo "  cd $WORKDIR && python3.11 -m venv .venv && source .venv/bin/activate && pip install -r requirements.txt" >&2
+        exit 1
+    fi
+
+    if [ ! -f "$WORKDIR/.env" ]; then
+        echo "WARNUNG: $WORKDIR/.env fehlt — kopiere aus .env.example."
+        cp "$WORKDIR/.env.example" "$WORKDIR/.env"
+    fi
+
+    mkdir -p "$LOG_DIR" "$HOME/Library/LaunchAgents"
+
+    echo "[1/4] Generiere plist mit WORKDIR=$WORKDIR"
+    sed \
+        -e "s|__WORKDIR__|$WORKDIR|g" \
+        -e "s|__HOME__|$HOME|g" \
+        "$TEMPLATE" > "$PLIST_DST"
+
+    echo "[2/4] Falls bereits geladen: vorher entladen"
+    launchctl unload "$PLIST_DST" 2>/dev/null || true
+
+    echo "[3/4] Lade LaunchAgent"
+    launchctl load -w "$PLIST_DST"
+
+    echo "[4/4] Warte 2 s und prüfe Health-Endpoint"
+    sleep 2
+    if curl -fsS http://127.0.0.1:8080/health >/dev/null; then
+        echo
+        echo "[✓] Voice-Agent Mac-Worker läuft."
+        curl -s http://127.0.0.1:8080/health | python3 -m json.tool 2>/dev/null || true
+    else
+        echo
+        echo "[!] Health-Check fehlgeschlagen. Logs:"
+        echo "    $LOG_DIR/voice-agent-worker.err.log"
+        echo "    $LOG_DIR/voice-agent-worker.out.log"
+        tail -n 20 "$LOG_DIR/voice-agent-worker.err.log" 2>/dev/null || true
+        exit 1
+    fi
+
+    echo
+    echo "── Verwaltung ───────────────────────────────────────────"
+    echo "  Stoppen / Starten:  launchctl unload|load -w $PLIST_DST"
+    echo "  Status:             $0 status"
+    echo "  Entfernen:          $0 uninstall"
+    echo "  Logs (live):        tail -f $LOG_DIR/voice-agent-worker.{out,err}.log"
+}
+
+case "$cmd" in
+    install)   install_agent ;;
+    uninstall) uninstall ;;
+    status)    show_status ;;
+    *)
+        echo "Nutzung: $0 [install|uninstall|status]" >&2
+        exit 1
+        ;;
+esac