docs(P01): complete minimal-voice-loop phase

---ci--- phase: 1 milestone: v0.1 status: complete requirements: covered: [REQ-VOICE-01, REQ-VOICE-02, REQ-VOICE-03, REQ-VOICE-04, REQ-SCEN-01, REQ-STATE-01, REQ-LLM-01, REQ-LLM-02, REQ-DEBRIEF-01, REQ-ORCH-01, REQ-ORCH-02, REQ-SCEN-FMT-01, REQ-NFR-LAT-01, REQ-NFR-SAFE-01, REQ-NFR-COST-01] partial: [] ---/ci---
2026-08-01 13:28:42 +00:00
parent 415c8ac8a6
commit b77536aa5e
79 changed files with 8087 additions and 1 deletions
@@ -0,0 +1,36 @@
+"""Praxis service interfaces and adapter registry.
+
+Public API:
+    from server.services import TTSProvider, LLMProvider, Guardrail
+    from server.services import get_tts, get_llm, get_guardrail
+
+Adapters are resolved from env vars:
+    PRAXIS_TTS=cartesia|piper
+    OLLAMA_ROLEPLAY_MODEL / OLLAMA_DEBRIEF_MODEL
+"""
+
+from __future__ import annotations
+
+from server.services.base import (
+    Guardrail,
+    GuardrailContext,
+    GuardrailVerdict,
+    LLMProvider,
+    LLMStreamChunk,
+    TTSProvider,
+    TTSResult,
+)
+from server.services.registry import get_guardrail, get_llm, get_tts
+
+__all__ = [
+    "TTSProvider",
+    "TTSResult",
+    "LLMProvider",
+    "LLMStreamChunk",
+    "Guardrail",
+    "GuardrailVerdict",
+    "GuardrailContext",
+    "get_tts",
+    "get_llm",
+    "get_guardrail",
+]