Glossary
| Term | Meaning |
|---|---|
| Ada | The AI server GPU host (RTX 4000 Ada) running AO + CPAI (+ preferred speech sidecars) |
| Admin console | Always-on ops UI at :8781/admin (status, logs, restart, inject in dev) |
| AO | agentic-orchestration — the planner/brain |
AO Reach / ao_reach |
Dart client SDK for session overlays + MCP reverse tunnel |
| Ambient | Lowest attention state — wake armed, low-rate vision poll |
| Attention ladder | Ambient → Noticed → Engaged → Listening → Responding (+ Sleeping) |
| Bridge |
comstar-bridge Dart process — attention coordinator and network clients |
| CPAI | CodeProject.AI Server — YOLO detection + face recognition |
| Engaged | Known face session open; greeter may have spoken |
| Follow-up window | Post-speak.ended period where wake word is not required |
| Guest / stranger | Unrecognised face; restricted overlay |
| hello.speech | Reach WebSocket hello field advertising STT/TTS sidecar URLs |
| Kiosk | Chromium fullscreen page rendering the avatar |
| MCP | Model Context Protocol — tools the planner can call |
| Noticed | Person detected; identity not yet resolved |
| Overlay | Ephemeral session agents registered via Reach (client.*) |
| PCM | Raw audio samples (16 kHz mono s16le on the capture path) |
| Reach SpeechClient | Preferred STT/TTS HTTP client discovered from hello.speech
|
| SessionBridge | Reach session lifecycle wrapper in the COMSTAR bridge |
| Speech sidecar | OpenAI-compatible STT/TTS HTTP servers on Ada |
| Starburst | Default SVG emblem avatar (ComStar mark) |
| STT / TTS | Speech-to-text / text-to-speech |
| Triple gate | Three simultaneous conditions required for LAN WebSocket bind |
| turn_id | ULID correlating one listen→respond cycle across logs and spans |
| Tunnel MCP | Pi-local tool exposed to AO over Reach reverse tunnel |
| userid | CodeProject.AI face identity string → AO session header |
| VAD | Voice activity detection — ends utterance after silence |
| Wake word |
hey comstar openWakeWord model |
| X-Comstar-Lan-Token | Header for admin LAN auth on :8781/admin
|