From 3c0cfe08b7205cd493bfd540b9d172f327a8aa42 Mon Sep 17 00:00:00 2001
From: jwbron <8340608+jwbron@users.noreply.github.com>
Date: Wed, 22 Apr 2026 23:11:20 +0000
Subject: [PATCH 1/2] docs: document gateway session idle timeout config

---
 docs/guides/deployment.md | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/docs/guides/deployment.md b/docs/guides/deployment.md
index 27e78cb7df..50c8f56e98 100644
--- a/docs/guides/deployment.md
+++ b/docs/guides/deployment.md
@@ -408,6 +408,20 @@ The orchestrator now waits for the gateway to become healthy before creating a p
 3. Check NetworkPolicies: `kubectl get networkpolicies -n egg-agents`
 4. Test connectivity from agent namespace: `kubectl run -n egg-agents test --rm -it --image=busybox -- wget -qO- http://gateway.egg-system:9848/api/v1/health`
 
+### Session expired before agent finished
+
+The gateway auto-prunes sessions that have been idle (no requests from the container) for more than 60 minutes. If an agent is killed or its pipeline is cancelled, its session is cleaned up automatically within the next prune cycle rather than lingering until its 24-hour TTL.
+
+If legitimate long-running agents are losing their sessions, tune the idle threshold on the gateway:
+
+```yaml
+# In your gateway Deployment
+- name: EGG_SESSION_IDLE_TIMEOUT_MINUTES
+  value: "120"  # default: 60
+- name: EGG_SESSION_CLEANUP_INTERVAL_MINUTES
+  value: "15"   # default: 15, minimum: 1
+```
+
 ### Git operations fail
 
 1. Verify GITHUB_USER_TOKEN is set

From 1b9dbae7ac045b8432f7e83748628a654d47cd15 Mon Sep 17 00:00:00 2001
From: "egg-reviewer[bot]"
 <261018737+egg-reviewer[bot]@users.noreply.github.com>
Date: Wed, 22 Apr 2026 23:23:11 +0000
Subject: [PATCH 2/2] docs: add minimum value comment for
 EGG_SESSION_IDLE_TIMEOUT_MINUTES

---
 docs/guides/deployment.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/guides/deployment.md b/docs/guides/deployment.md
index 50c8f56e98..17888047c7 100644
--- a/docs/guides/deployment.md
+++ b/docs/guides/deployment.md
@@ -417,7 +417,7 @@ If legitimate long-running agents are losing their sessions, tune the idle thres
 ```yaml
 # In your gateway Deployment
 - name: EGG_SESSION_IDLE_TIMEOUT_MINUTES
-  value: "120"  # default: 60
+  value: "120"  # default: 60, minimum: 5
 - name: EGG_SESSION_CLEANUP_INTERVAL_MINUTES
   value: "15"   # default: 15, minimum: 1
 ```