docs(adobe-firefly): document renewal controls

.env.example

@@ -1593,6 +1593,19 @@ APP_LOG_TO_FILE=true
 # NANOBANANA_POLL_TIMEOUT_MS=120000    # Max wait for job completion (default: 120s)
 # NANOBANANA_POLL_INTERVAL_MS=2500     # Poll frequency (default: 2.5s)
 
+# ── Adobe Firefly (Image / Video Generation) ──
+# Optional absolute path to a system Chrome or Edge executable used for interactive sign-in
+# and off-screen risk-session renewal. Auto-detected when unset.
+# OMNIROUTE_LOGIN_BROWSER_PATH=
+# Browser renewal and durable session cache are enabled by default; set either to 0 to opt out.
+# ADOBE_FIREFLY_BROWSER_REFRESH=1
+# ADOBE_FIREFLY_SESSION_DISK=1
+# Minimum gap between generate submissions and extra gap after every third success (ms).
+# ADOBE_FIREFLY_MIN_SUBMIT_GAP_MS=12000
+# ADOBE_FIREFLY_BATCH_EXTRA_GAP_MS=15000
+# Base backoff after a transient 408 response (ms); five attempts maximum.
+# ADOBE_FIREFLY_SUBMIT_BASE_DELAY_MS=8000
+
 # ── Microsoft Designer Web (Image Generation) ──
 # Polling config for the microsoft-designer-web submit-then-poll image job.
 # Used by: open-sse/handlers/imageGeneration/providers/designerWeb.ts

docs/reference/ENVIRONMENT.md

@@ -449,6 +449,12 @@ detection above).
 | `PROVIDER_LIMITS_SYNC_SPACING_MS`               | `1500`                                              | `src/lib/usage/providerLimits.ts`                           | Gap (ms) between consecutive OAuth quota fetches in a bulk sync; OAuth connections are fetched one at a time to avoid bursting an upstream. `0` opts out (concurrent).  |
 | `OMNIROUTE_QUOTA_FETCH_MIN_INTERVAL_MS`         | `250`                                               | `open-sse/services/quotaFetchThrottle.ts`                   | Min interval (ms) between consecutive upstream quota fetches on the per-request preflight/monitor path; spaces concurrent network calls so many accounts on one IP don't burst the upstream. Wired into the Codex (`/wham/usage`), DeepSeek, Bailian (both fetch sites), OpenCode, and Crof quota fetchers (#6009, #6911). The generic `usage.ts::getUsageForProvider` dispatch path (github/glm/minimax/nanogpt/xai/etc.) is not yet covered — tracked separately. Cache hits unaffected. `0` disables; clamped `0..5000`.        |
 | `PROVIDER_LIMITS_POST_USAGE_REFRESH_DELAY_MS`   | `5000`                                              | `src/lib/usage/providerLimits.ts`                           | Delay (ms) before refreshing provider limits after a real usage event, giving the upstream quota API time to register consumption.                                      |
+| `OMNIROUTE_LOGIN_BROWSER_PATH`                  | auto-detect                                         | `open-sse/services/adobeFireflyBrowserLogin.ts`             | Absolute path to a system Chrome or Edge executable used for interactive Adobe Firefly sign-in and off-screen renewal.                                                  |
+| `ADOBE_FIREFLY_BROWSER_REFRESH`                 | enabled                                             | `open-sse/services/adobeFireflySession.ts`                  | Keeps IMS and browser-risk state fresh with account-scoped Chrome CDP sessions. Set to `0` to disable browser renewal.                                                   |
+| `ADOBE_FIREFLY_SESSION_DISK`                    | enabled                                             | `open-sse/services/adobeFireflySession.ts`                  | Persists repaired Adobe sessions under `DATA_DIR` across process restarts. Set to `0` to keep sessions memory-only.                                                      |
+| `ADOBE_FIREFLY_MIN_SUBMIT_GAP_MS`               | `12000`                                             | `open-sse/services/adobeFireflySession.ts`                  | Minimum spacing in milliseconds between Adobe Firefly generate submissions; `0` disables spacing.                                                                      |
+| `ADOBE_FIREFLY_BATCH_EXTRA_GAP_MS`              | `15000`                                             | `open-sse/services/adobeFireflySession.ts`                  | Extra quiet period in milliseconds after every third successful Adobe submission.                                                                                       |
+| `ADOBE_FIREFLY_SUBMIT_BASE_DELAY_MS`            | `8000`                                              | `open-sse/services/adobeFireflyClient.ts`                   | Base backoff in milliseconds after transient Adobe 408 responses; combined with submit spacing across at most five attempts.                                            |
 | `OMNIROUTE_DISABLE_BACKGROUND_SERVICES`         | `false`                                             | `src/instrumentation-node.ts`                               | Disable all background services (sync, pricing, model refresh). Useful for CI/test.                                                                                     |
 | `OMNIROUTE_ENABLE_RUNTIME_BACKGROUND_TASKS`     | _(unset)_                                           | `src/lib/config/runtimeSettings.ts`                         | Force background tasks on under automated test detection. Set `1` to override the test heuristic.                                                                       |
 | `OMNIROUTE_BUDGET_RESET_JOB_INTERVAL_MS`        | `600000`                                            | `src/lib/jobs/budgetResetJob.ts`                            | Budget reset check cadence (ms). Floor `10000`.                                                                                                                         |