Family Home Lab: portal, dsh (chat+plugins), transcriber, music/media tools, home dash

ai/README.md

@@ -0,0 +1,20 @@
+# AI Tools
+
+Unified entry point for the lab's AI/LLM services.
+
+| Service | URL | Role |
+|---|---|---|
+| OmniRoute dashboard | `http://192.168.20.13:20128` (`omniroute.home.lab`) | LLM gateway UI — all routing happens here |
+| DeepSeek Harness (dsh) | `https://dsh-<user>.lab.audasmedia.com.au` | Per-user assistant instances (built by the **dsh agent**, not us) |
+
+Category colour: sky `#62aef0` (chat) / sky for ai stack.
+
+## Integration contract (from plan.md §6)
+- dsh instances must be reachable at `dsh-{sam,jo,harry,finn}.lab.audasmedia.com.au` via Caddy subdomains (not subpaths).
+- Instances should be iframe-friendly (correct CSP / X-Frame-Options via Caddy) so the console can embed them inline.
+- Session handling stays inside dsh; the console only routes the entry point.
+- Optional one-time-token handoff from the console is to be designed with the dsh agent.
+
+## Console wiring
+- `portal/tools.py` exposes the dsh tool; `_dsh_for_user()` rewrites the URL per logged-in user.
+- Admin panel (Sam) manages user→instance mapping.