Improve application responsiveness and background processing

docs/native-hosts.md

@@ -443,3 +443,23 @@ check can install the release once the batch has drained. When a heartbeat
 advertises cancellation support, delivery resumes with cancellation cleanup
 first. This controller-side hold also recovers cancellations already waiting
 on older agents. Hosts without automatic updates need the current installer.
+
+## Responsive observations (agent 1.4.0)
+
+Agent 1.4.0 separates read-only inspections, file/log reads, and the exact RCON
+commands `status`, `getstatus`, and `version` from the serial mutation queue.
+Two bounded read lanes can run during runtime or library downloads. Instance
+mutations exclude reads of that instance; credential rotation and host cleanup
+wait for active reads. Both lanes retain durable operation IDs, generation checks,
+and the updater activity lock. Older agents continue using the combined queue.
+
+Agents long-poll `GET /api/agent/operations?lane=read|write&wait=20`; requests
+without those parameters retain immediate combined delivery. The controller wakes
+pending polls when work is queued and rechecks authentication after waiting.
+Long polls release the updater lock; execution reacquires it and rechecks update
+state before accepting work.
+
+Browser game-folder uploads transfer up to three files concurrently. Chunks of
+one file remain serial and checksum-verified. Publication waits for admitted file
+transfers and prevents subsequent writes; pause/resume still uses acknowledged
+per-file offsets. Host downloads retain their existing bounded concurrency.