Platform and Observability
GET /healthandGET /activereport service status, protocol version, runtime, and whether tracing is enabled.- Server logs use
sage.log/v1JSON lines by default. Configure level, format, and optional directory withSAGE_SERVER_LOG_*. - Request correlation uses
X-Request-ID; JSON responses also includerequest_id. - Optional Jaeger integration uses
SAGE_SERVER_JAEGER_*; it is not required to run chat. - Session state is authoritative. Diagnostic files and log retention must not be used to reconstruct a second message ledger.
Server v2 uses MySQL for application inventory and Session persistence, and Session events for AG-UI replay. Desktop uses its own local data root and catalog. Neither host uses the legacy desktop-update API.