@possumtech/rummy 0.5.0 → 2.0.1

package/.env.example

@@ -17,13 +17,17 @@ RUMMY_MMAP_MB=0
 
 # Agent Loop Limits
 RUMMY_MAX_TURNS=99
-RUMMY_MAX_COMMANDS=15
-RUMMY_MAX_UNKNOWN_WARNINGS=3
+# Hard cap on commands per turn — high by design. The real cost
+# ceiling is the Token Budget; per-tool rate limits (e.g.
+# RUMMY_WEB_SEARCH_MAX) bound the expensive tools individually.
+RUMMY_MAX_COMMANDS=99
+# Per-turn cap on <search>. Refusals strike via 429.
+RUMMY_WEB_SEARCH_MAX=1
 RUMMY_MAX_STALLS=3
+RUMMY_MAX_STRIKES=3
 RUMMY_MIN_CYCLES=3
 RUMMY_MAX_CYCLE_PERIOD=4
 RUMMY_MAX_UPDATE_REPEATS=3
-RUMMY_MAX_PATH_STAGNATION=5
 
 # Hygiene
 # Days to keep completed/aborted runs before purging
@@ -32,6 +36,16 @@ RUMMY_RETENTION_DAYS=31
 # Timeouts (ms)
 RUMMY_RPC_TIMEOUT=30000
 RUMMY_FETCH_TIMEOUT=300000
+# Test harness — how long AuditClient waits for a single ask/act to reach
+# terminal status. Sized for full-context ingest on large-window models.
+RUMMY_TEST_RUN_TIMEOUT=3600000
+
+# LLM retry policy: time-bounded exponential backoff with full jitter.
+# DEADLINE is total wall-clock budget for an LLM call across all retries.
+# MAX_BACKOFF caps each inter-attempt sleep so a long deadline doesn't
+# yield 10-minute waits between attempts.
+RUMMY_LLM_DEADLINE_MS=600000
+RUMMY_LLM_MAX_BACKOFF_MS=30000
 
 # Debug
 # RUMMY_DEBUG=true
@@ -55,6 +69,17 @@ RUMMY_TOKEN_DIVISOR=2
 # LLM temperature (0 = deterministic, 0.7 = creative). Client can override per-request.
 RUMMY_TEMPERATURE=0.5
 
+# Run Attribute Defaults
+# Per-run attributes (passed in the run-creation set call) trump these.
+# Strict "1" enables; unset / "0" / "" disables. Useful in profile env
+# files (e.g. .env.tbench) layered via --env-file-if-exists.
+#
+# RUMMY_YOLO=1            # auto-accept every proposal (headless / CI / bench)
+# RUMMY_NO_INTERACTION=1  # exclude <ask_user> from the tool list
+# RUMMY_NO_WEB=1          # exclude <search> from the tool list
+# RUMMY_NO_PROPOSALS=1    # exclude <ask_user>/<env>/<sh>
+# RUMMY_NO_REPO=1         # skip rummy.repo scanning (file scan + overview)
+
 # Provider Configuration
 OPENROUTER_BASE_URL=https://openrouter.ai/api/v1
 # OPENROUTER_API_KEY=
@@ -71,15 +96,27 @@ RUMMY_X_TITLE=RUMMY
 # XAI_API_KEY=""
 
 # Model Aliases (Optional)
-# RUMMY_MODEL_g420="x.ai/grok-4.20-reasoning-latest"
-# RUMMY_MODEL_grok="x.ai/grok-4-1-fast-reasoning-latest"
+# First path segment picks the provider plugin; the rest is the
+# provider's own model identifier. OpenRouter is tri-level because
+# its API expects publisher/model; direct providers are bi-level.
+# RUMMY_MODEL_g420="xai/grok-4.20-reasoning-latest"
+# RUMMY_MODEL_grok="xai/grok-4-1-fast-reasoning-latest"
+# RUMMY_MODEL_opus="openrouter/anthropic/claude-opus-4.6"
+# RUMMY_MODEL_gpro="openrouter/google/gemini-3.1-pro-preview"
+# RUMMY_MODEL_gemma="openai/gemma-4-26B-A4B-it-UD-Q3_K_XL.gguf"
+# RUMMY_MODEL_qwen="ollama/qwen:7b"
 
 # Necessary for automated testing
 # RUMMY_TEST_MODEL=grok
 
 # Web Search
+
+# RUMMY_SEARCH="searxng"
 # RUMMY_SEARXNG_URL="http://127.0.0.1:8888"
 
+# RUMMY_SEARCH="brave"
+# BRAVE_API_KEY=""
+
 # External plugins: npm i -g <package>, then uncomment
 # RUMMY_PLUGIN_WEB="@possumtech/rummy.web"
 # RUMMY_PLUGIN_REPO="@possumtech/rummy.repo"