Real-time communication protocol for the QNTX web interface.
| Path | Purpose |
|---|---|
/ws | Main WebSocket (graph updates, job status, logs) |
/lsp | ATS Language Server Protocol (completions, hover) |
All messages are JSON objects with a type field indicating the message type.
queryExecute an ATS query
| Field | Description |
|---|---|
| cursor | Cursor column position |
| filename | Source file name |
| line | Cursor line position |
| query | ATS query string |
job_updateAsync job status update
| Field | Description |
|---|---|
| job | Job object with status, progress, etc. |
| metadata | Additional metadata about the update |
daemon_statusPulse daemon status broadcast
| Field | Description |
|---|---|
| active_jobs | Number of active jobs |
| load_percent | Current load percentage |
| running | Whether daemon is running |
usage_updateAI usage statistics update
| Field | Description |
|---|---|
| requests | Number of requests |
| tokens | Total tokens used |
| total_cost | Total cost in USD |
llm_streamStreaming LLM response chunks
| Field | Description |
|---|---|
| content | Text content chunk |
| done | Whether streaming is complete |
| job_id | Associated job ID |
plugin_healthPlugin health status update
| Field | Description |
|---|---|
| healthy | Health status |
| name | Plugin name |
| state | Plugin state (running/paused) |
Full message type definitions are in Server Types.