Query Processing Quick Reference

Last Verified: February 2026

---

Primary endpoints

• Edge relay ingest: POST /edge/message (recommended)
• Edge relay WebSocket: GET /edge/ws?edge_agent_id=... (real-time commands)
• Legacy relay ingest: POST /orchestrator/message
• Health: GET /health

---

Core code pointers

• Main orchestrator: app/orchestrator/message_handler.py
• Unified routing decision: app/orchestrator/smart_message_router.py
• Tool/web search routing: app/orchestrator/smart_router.py
• Memory service selection: app/memory/__init__.py
• Edge ingest + WS correlation: app/api/edge_routes.py

---

Auth summary

• /edge/* endpoints: Authorization: Bearer <edge_token> (app/edge/auth.py)
• /orchestrator/message (legacy): Authorization: Bearer <RELAY_WEBHOOK_SECRET> (if configured)
• Web dashboard endpoints: cookie sessions + CSRF (/auth/session, /auth/csrf-token)

---

Debugging tips

• Request correlation header: X-Request-ID (echoed back by middleware in app/main.py)
• WebSocket protocol reference: docs/architecture/WEBSOCKET_PROTOCOL.md