From 3de77166e363e7424c1df4bcca64e2e84c2b2b4b Mon Sep 17 00:00:00 2001 From: Brandon Bennett Date: Sun, 9 Aug 2026 18:17:27 -0700 Subject: [PATCH] docs: sync env vars with .env.example and ENVIRONMENT.md (docs gate fix) --- .env.example | 4 ++++ docs/reference/ENVIRONMENT.md | 5 ++++- 2 files changed, 8 insertions(+), 1 deletion(-) diff --git a/.env.example b/.env.example index 80e1ee5bb2..35e1ef0c0c 100644 --- a/.env.example +++ b/.env.example @@ -358,6 +358,10 @@ ALLOW_API_KEY_REVEAL=false # per lane so the wait cannot amplify the heap (#4380). Over-budget waits 503 immediately. # Default 4194304 (4 MB). # OMNIROUTE_CHAT_ADMISSION_MAX_QUEUED_BYTES=4194304 +# Per-connection virtual admission lanes (#9654): idle-lane eviction TTL. Default 60000 (60s). +# OMNIROUTE_CHAT_VIRTUAL_TTL_MS=60000 +# Per-connection virtual admission lanes (#9654): max concurrent sessions (lanes). Default 64. +# OMNIROUTE_CHAT_VIRTUAL_MAX_SESSIONS=64 # Hard cap (bytes) for a non-streaming upstream response buffered fully into memory # (#5152). Past this the upstream reader is cancelled and the request fails fast diff --git a/docs/reference/ENVIRONMENT.md b/docs/reference/ENVIRONMENT.md index 3f319dde03..4a3aa5e092 100644 --- a/docs/reference/ENVIRONMENT.md +++ b/docs/reference/ENVIRONMENT.md @@ -1398,7 +1398,10 @@ These settings were introduced after the previous environment-contract snapshot. | Variable | Default | Source File | Description | | --- | --- | --- | --- | -| `OMNIROUTE_CHAT_ADMISSION_QUEUE_MS` | `5000` | `src/shared/middleware/chatBodyAdmission.ts` | Maximum wait for a heavyweight chat admission slot before a retryable `503`; `0` restores immediate rejection. | +| `OMNIROUTE_CHAT_ADMISSION_QUEUE_MS` | `2000` | `src/shared/middleware/chatBodyAdmission.ts` | Maximum wait for a heavyweight chat admission slot before a retryable `503`; a short bounded wait serializes agent bursts instead of an instant `503`. `0` restores immediate rejection. | +| `OMNIROUTE_CHAT_ADMISSION_MAX_QUEUED_BYTES` | `4194304` (4 MB) | `src/shared/middleware/chatBodyAdmission.ts` | Queued-bytes budget for the admission wait (#9654): bounds total buffered body bytes parked per lane so the wait cannot amplify the heap (#4380). Over-budget waits receive a retryable `503` immediately. | +| `OMNIROUTE_CHAT_VIRTUAL_TTL_MS` | `60000` (60 s) | `src/shared/middleware/chatBodyAdmission.ts` | Per-connection virtual admission lanes (#9654): idle-lane eviction TTL. | +| `OMNIROUTE_CHAT_VIRTUAL_MAX_SESSIONS` | `64` | `src/shared/middleware/chatBodyAdmission.ts` | Per-connection virtual admission lanes (#9654): max concurrent sessions (lanes). | | `OMNIROUTE_RUNNOW_TIMEOUT_MS` | `30000` | `src/app/api/jobs/[id]/run-now/route.ts` | Bounds how long a run-now call waits for an in-flight job before starting the queued run. | | `CHAT_LOG_MAX_BODY_KB` | `1024` | `src/lib/logEnv.ts` | Maximum request or response body size before log summarization, in KiB. | | `ADOBE_FIREFLY_BROWSER_REFRESH` | enabled | `open-sse/services/adobeFireflySession.ts` | Keeps IMS and browser-risk state fresh through account-scoped Chrome CDP sessions; set `0` to disable. |