Update agent

Wireframes/Desktop/MeetVault-Desktop-Demo/speech-engine/README.md

@@ -0,0 +1,66 @@
+# MeetVault Local Speech Engine
+
+This process is **local**, not the future MeetVault backend. It provides the demo's real-time Whisper + diart functionality.
+
+## Recommended environment
+
+Use Python **3.10 or 3.11**. `diart`/PyTorch/pyannote compatibility is much better there than on very new Python releases.
+
+```bash
+python -m venv .venv
+# Windows
+.venv\Scripts\activate
+# Linux/macOS
+source .venv/bin/activate
+
+pip install -r requirements.txt
+```
+
+For diart, install the native audio dependencies required by your OS and authenticate with Hugging Face if the pyannote models are gated in your environment. Follow the current diart/pyannote model instructions and accept their model terms before starting real mode.
+
+## Run real mode
+
+```bash
+python server.py
+```
+
+The desktop application connects to:
+
+```text
+ws://127.0.0.1:8765/ws/live
+```
+
+## Run mock mode
+
+Mock mode requires only the FastAPI stack and is intended to validate UI behavior:
+
+```bash
+python server.py --mock
+```
+
+You can also choose **Mock demo** under MeetVault Settings → Local speech engine.
+
+## Audio protocol
+
+- mono
+- signed int16 little-endian PCM
+- 16 kHz
+- binary WebSocket frames
+
+The first WebSocket message is JSON configuration. The engine replies with JSON events such as:
+
+```json
+{
+  "type": "final",
+  "segment": {
+    "id": "uuid",
+    "speakerId": "speaker_1",
+    "start": 12.1,
+    "end": 15.4,
+    "text": "We should deploy tomorrow.",
+    "final": true
+  }
+}
+```
+
+Speaker names such as `Alice` are **not** generated by the engine. The engine produces stable session labels (`speaker_1`, `speaker_2`, ...), and the MeetVault UI lets the user rename those labels live.