From 4149b6f578db358f248d81dc9ac127661e577258 Mon Sep 17 00:00:00 2001
From: Nick Sweeting <git@sweeting.me>
Date: Wed, 2 Sep 2026 22:37:53 -0700
Subject: [PATCH] Reload stale OpenCode frames after server recovery

---
 .../opencode/templates/opencode/agent.html    | 36 +++++++++++++++++++
 archivebox/tests/test_opencode_agent.py       |  2 ++
 2 files changed, 38 insertions(+)

diff --git a/archivebox/opencode/templates/opencode/agent.html b/archivebox/opencode/templates/opencode/agent.html
index 8a252295..d911ec57 100644
--- a/archivebox/opencode/templates/opencode/agent.html
+++ b/archivebox/opencode/templates/opencode/agent.html
@@ -206,6 +206,42 @@
                     });
                 })();
             </script>
+            <script>
+                (() => {
+                    const frame = document.querySelector(".opencode-agent-frame");
+                    if (!frame) return;
+
+                    let checking = false;
+                    let wasUnavailable = false;
+                    const check = async () => {
+                        if (checking) return;
+                        checking = true;
+                        try {
+                            const response = await fetch("/admin/agent/opencode/global/health", {
+                                cache: "no-store",
+                                credentials: "same-origin",
+                            });
+                            if (!response.ok) {
+                                wasUnavailable = true;
+                            } else if (wasUnavailable) {
+                                wasUnavailable = false;
+                                frame.contentWindow.location.reload();
+                            }
+                        } catch {
+                            wasUnavailable = true;
+                        } finally {
+                            checking = false;
+                        }
+                    };
+
+                    window.setInterval(check, 3000);
+                    window.addEventListener("online", check);
+                    document.addEventListener("visibilitychange", () => {
+                        if (!document.hidden) check();
+                    });
+                    check();
+                })();
+            </script>
         {% endif %}
     </div>
 {% endblock %}
diff --git a/archivebox/tests/test_opencode_agent.py b/archivebox/tests/test_opencode_agent.py
index b0ee9d2d..babd208d 100644
--- a/archivebox/tests/test_opencode_agent.py
+++ b/archivebox/tests/test_opencode_agent.py
@@ -186,6 +186,8 @@ def test_opencode_agent_superuser_gets_admin_wrapper(admin_client, live_opencode
     assert f'<iframe src="{session_path}"'.encode() in response.content
     assert b'id="header"' in response.content
     assert b'id="progress-monitor"' in response.content
+    assert b'fetch("/admin/agent/opencode/global/health"' in response.content
+    assert b"frame.contentWindow.location.reload()" in response.content
     assert response.headers["X-Frame-Options"] == "DENY"
     assert response.headers["Content-Security-Policy"] == "frame-ancestors 'none'"