.env.example

# Copy to `.env.local` for local dev (gitignored). Suggested dev overrides: DEBUG_LOG=1, LAUNCH_MODE=standard.
APP_URL=http://localhost:5173
APP_NAME=Web-Agent
VITE_WEBAGENT_LAUNCH_MODE=transit_only_proxy
# Sandbox runtime: nodebox (default) | linuxontab (experimental v86 Alpine backend)
# VITE_WEBAGENT_RUNTIME=linuxontab
# VITE_LINUXONTAB_ASSET_BASE=https://linuxontab.com/shell/
# VITE_LINUXONTAB_ISO=alpine.iso
# VITE_LINUXONTAB_MEM_MB=2048
# VITE_LINUXONTAB_RELAY_URL=wisps://linuxontab-net.fly.dev/wisp
VITE_WEBAGENT_DEBUG_LOG=0
VITE_WEBAGENT_DEBUG_LOG_DIR=debug-logs
WEBAGENT_DEBUG_PROXY=0

# Ephemeral reasoning preview in UI + Telegram while the agent is thinking (0 = off).
WEBAGENT_REASONING_PREVIEW=1
# OpenCode Big Pickle uses interleaved reasoning_content; preview is off by default (1 = on).
# WEBAGENT_OPENCODE_REASONING_PREVIEW=0

# Max UTF-8 bytes per write_file call (default 16 MiB, cap 32 MiB).
# WEBAGENT_WRITE_FILE_MAX_BYTES=16777216

# Tool loop guardrails — deterministic per-turn loop detection (Hermes-style, warn-first).
# Warnings append guidance to tool results; hard stops are opt-in.
VITE_WEBAGENT_TOOL_LOOP_GUARDRAILS_WARNINGS=1
VITE_WEBAGENT_TOOL_LOOP_GUARDRAILS_HARD_STOP=0
VITE_WEBAGENT_TOOL_LOOP_EXACT_FAILURE_WARN_AFTER=2
VITE_WEBAGENT_TOOL_LOOP_EXACT_FAILURE_BLOCK_AFTER=5
VITE_WEBAGENT_TOOL_LOOP_SAME_TOOL_FAILURE_WARN_AFTER=3
VITE_WEBAGENT_TOOL_LOOP_SAME_TOOL_FAILURE_HALT_AFTER=8
VITE_WEBAGENT_TOOL_LOOP_NO_PROGRESS_WARN_AFTER=2
VITE_WEBAGENT_TOOL_LOOP_NO_PROGRESS_BLOCK_AFTER=5

# Optional on the host when using Caddy reverse_proxy to the JSON sidecar (see railpack.json):
# WEBAGENT_CORS_PROXY_HOST=127.0.0.1
# WEBAGENT_CORS_PROXY_PORT=8799
# Used by `npm run test:browser` (loaded via playwright.config.ts from `.env` / `.env.local`)
TESTING_OPENROUTER_API_KEY=
# Optional: live Directus skill install + CRUD E2E (`tests/skill-directus-crud.spec.ts`)
TESTING_DIRECTUS_URL=https://hub.aratech.ae
TESTING_DIRECTUS_TOKEN=