python-codex 0.2.1__py3-none-any.whl → 0.2.2__py3-none-any.whl

pycodex/interactive_session.py

@@ -18,6 +18,7 @@ import typing
 
 
 EXIT_COMMANDS = {"/exit", "/quit"}
+HELP_COMMAND = "/help"
 HISTORY_COMMAND = "/history"
 TITLE_COMMAND = "/title"
 MODEL_COMMAND = "/model"
@@ -27,7 +28,7 @@ COMPACT_COMMAND = "/compact"
 LINK_COMMAND = "/link"
 UNLINK_COMMAND = "/unlink"
 EXTRA_COMMANDS_LINE = (
-    "Extra commands: /history, /title, /model, /resume, /compact, /link, /unlink"
+    "Extra commands: /help, /history, /title, /model, /resume, /compact, /link, /unlink"
 )
 
 
@@ -232,6 +233,9 @@ async def run_interactive_session(
                 continue
             if prompt_text in EXIT_COMMANDS:
                 break
+            if prompt_text == HELP_COMMAND:
+                view.write_line(EXTRA_COMMANDS_LINE)
+                continue
             if prompt_text == HISTORY_COMMAND:
                 view.show_history()
                 continue

{python_codex-0.2.1.dist-info → python_codex-0.2.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: python-codex
-Version: 0.2.1
+Version: 0.2.2
 Summary: A minimal Python extraction of Codex's main agent loop
 License-File: LICENSE
 Requires-Python: >=3.6.2

{python_codex-0.2.1.dist-info → python_codex-0.2.2.dist-info}/RECORD

@@ -7,7 +7,7 @@ pycodex/context.py,sha256=Hwh3vU-qSvaleUDdOWuWiGyNmbULVAZmboxiu9iiHt8,26549
 pycodex/doctor.py,sha256=De3M4hRBJq8ZeqsUJgHz0vitqrH18YugrEnz7oHhTdQ,10572
 pycodex/feishu_card.py,sha256=De6pM--3MfhgGo-WcWfhm-fop5UtzjwKrZ4gI2Lls3w,26198
 pycodex/feishu_link.py,sha256=XGV93CIorcc03pNgBnXay9SkivnDL4i2GkLR5NjBjq0,15588
-pycodex/interactive_session.py,sha256=VmQ4xLk5b9QrI4LvgrdyhXTvIk0K65loKxh2XbfV2FA,15617
+pycodex/interactive_session.py,sha256=pcIC_GvQuqQSsjzcTTFB_crrS-XVufAGplJZxnHgy7I,15769
 pycodex/model.py,sha256=O5Gf35qCMAGrqvr_5d1ZQNk3vHmNRD5Uv-8k7-zbpXg,36679
 pycodex/portable.py,sha256=gxl2E2h5uZJbasMEPPs-nyALFPIvX79T2ZYsu6vXZrg,15656
 pycodex/portable_server.py,sha256=6I3pQkWj3e_SFlDXY2mGdCPns1w_3PSxByBV9wv5epI,7331
@@ -79,10 +79,10 @@ responses_server/tools/custom_adapter.py,sha256=LxO7ldydvR-GWachDz8GKC0Q8KGGFoFP
 responses_server/tools/web_search.py,sha256=pm4ZUiHUfxc0bGY1kEvt-BCzDrZIyP24xzPUcga2ul0,8908
 workspace_server/__init__.py,sha256=XbSU6aAeYBMsBTVi9Ug6ZW9sxcwefqPS7T_7wpt_VMo,462
 workspace_server/__main__.py,sha256=9SRp-Yw7ShGxc6DhSIXcDLKgGEdAVm3oBZ59rBOPjT0,62
-workspace_server/app.py,sha256=aDfUqIwyMsndavSTP47rfcBKIwgo37F8U_lkCgUfUc0,49260
-workspace_server/workspace.html,sha256=_vu0Zm6ifuwc5rPx0ZCv-OF9oAb6jo4y4JwtJio3Yq0,29432
-python_codex-0.2.1.dist-info/METADATA,sha256=w0Pmo56JuaxuqaEOrLRB2et6FHDkRUDo64D-oCUlijo,16812
-python_codex-0.2.1.dist-info/WHEEL,sha256=KGYbc1zXlYddvwxnNty23BeaKzh7YuoSIvIMO4jEhvw,87
-python_codex-0.2.1.dist-info/entry_points.txt,sha256=vkV2UWCtEKvQNMJuPNjt8HyBKiwp83JyqBatrBNGDp8,80
-python_codex-0.2.1.dist-info/licenses/LICENSE,sha256=0X8ifk312hYAORM4hlzg8wVSEXYKNmiPgWlB1YIy2Nw,10926
-python_codex-0.2.1.dist-info/RECORD,,
+workspace_server/app.py,sha256=yORhk3BcZZiO1x-QTh0wFi4BXvrS5fbYMgVfEgGBgq8,51270
+workspace_server/workspace.html,sha256=5cHWRXGFknkDDqrOtmiBeOI1HRQHbRmkrNFm8wZ4_JU,39202
+python_codex-0.2.2.dist-info/METADATA,sha256=GbrTS_Leh6VMxhYAImSrdaFzDblJbwW4Xj5FdCRfdfI,16812
+python_codex-0.2.2.dist-info/WHEEL,sha256=KGYbc1zXlYddvwxnNty23BeaKzh7YuoSIvIMO4jEhvw,87
+python_codex-0.2.2.dist-info/entry_points.txt,sha256=vkV2UWCtEKvQNMJuPNjt8HyBKiwp83JyqBatrBNGDp8,80
+python_codex-0.2.2.dist-info/licenses/LICENSE,sha256=0X8ifk312hYAORM4hlzg8wVSEXYKNmiPgWlB1YIy2Nw,10926
+python_codex-0.2.2.dist-info/RECORD,,

workspace_server/app.py

@@ -25,7 +25,12 @@ from pycodex.utils.session_persist import (
     load_resumed_session_path,
 )
 from pycodex.utils import uuid7_string
-from pycodex.utils.visualize import IDLE_LISTENING_STATUS, shorten_title, tool_summary
+from pycodex.utils.visualize import (
+    IDLE_LISTENING_STATUS,
+    percent_of_context_window_remaining,
+    shorten_title,
+    tool_summary,
+)
 import typing
 
 
@@ -180,6 +185,8 @@ class WebSessionView:
         self._title = ""
         self._spinner_status = ""
         self._stream_buffer = ""
+        self._context_window_tokens: "typing.Union[int, None]" = None
+        self._context_remaining_percent: "typing.Union[int, None]" = None
         self._closed = False
         self._server_loop: "typing.Union[asyncio.AbstractEventLoop, None]" = None
         self._worker_loop: "typing.Union[asyncio.AbstractEventLoop, None]" = None
@@ -347,7 +354,11 @@ class WebSessionView:
         self,
         context_window_tokens: "typing.Union[int, None]",
     ) -> None:
-        del context_window_tokens
+        with self._lock:
+            self._context_window_tokens = context_window_tokens
+            self._context_remaining_percent = (
+                100 if context_window_tokens is not None else None
+            )
 
     def subscribe(self) -> "asyncio.Queue":
         queue: "asyncio.Queue" = asyncio.Queue()
@@ -386,6 +397,7 @@ class WebSessionView:
                 "spinner": self._spinner_status,
                 "model": "pycodex",
                 "title": self._title,
+                "context_remaining_percent": self._context_remaining_percent,
                 "turns": [_public_turn(turn) for turn in self._turns[-80:]],
             }
 
@@ -396,6 +408,8 @@ class WebSessionView:
                 "spinner": self._spinner_status,
                 "title": self._title,
                 "turn_count": len(self._turns),
+                "last_assistant": _last_assistant_text(self._turns),
+                "context_remaining_percent": self._context_remaining_percent,
             }
 
     def _apply_runtime_event(self, event: "AgentEvent") -> None:
@@ -403,6 +417,9 @@ class WebSessionView:
         payload = getattr(event, "payload", {})
         if not isinstance(payload, dict):
             payload = {}
+        if kind == "token_count":
+            self._update_context_window(payload.get("usage"))
+            return
         turn_id = str(payload.get("turn_id") or getattr(event, "turn_id", "") or "")
         submission_id = str(payload.get("submission_id") or turn_id or "")
         turn = self._turns_by_submission_id.get(submission_id)
@@ -475,6 +492,22 @@ class WebSessionView:
             turn["status"] = "interrupted"
             self._stream_buffer = ""
 
+    def _update_context_window(self, usage: "object") -> None:
+        if self._context_window_tokens is None:
+            return
+        if not isinstance(usage, dict):
+            self._context_remaining_percent = None
+            return
+        try:
+            total_tokens = int(usage["total_tokens"])
+        except (KeyError, TypeError, ValueError):
+            self._context_remaining_percent = None
+            return
+        self._context_remaining_percent = percent_of_context_window_remaining(
+            total_tokens,
+            self._context_window_tokens,
+        )
+
     def _apply_spinner_event(
         self,
         kind: str,
@@ -974,6 +1007,10 @@ class WorkspaceSessionManager:
                     "running": bool(summary.get("running")),
                     "spinner": summary.get("spinner") or "",
                     "turn_count": summary.get("turn_count") or 0,
+                    "last_assistant": summary.get("last_assistant") or "",
+                    "context_remaining_percent": summary.get(
+                        "context_remaining_percent"
+                    ),
                 }
             )
         return result
@@ -1178,9 +1215,21 @@ def _session_summary(session) -> "typing.Dict[str, object]":
         "running": bool(snapshot.get("running")),
         "spinner": snapshot.get("spinner") or "",
         "turn_count": len(snapshot.get("turns") or []),
+        "last_assistant": _last_assistant_text(snapshot.get("turns") or []),
+        "context_remaining_percent": snapshot.get("context_remaining_percent"),
     }
 
 
+def _last_assistant_text(turns: "typing.Iterable[typing.Dict[str, object]]") -> str:
+    for turn in reversed(list(turns)):
+        if str(turn.get("kind") or "assistant") == "control":
+            continue
+        response = str(turn.get("response") or "").strip()
+        if response:
+            return response
+    return ""
+
+
 def _public_turn(turn: "typing.Dict[str, object]") -> "typing.Dict[str, object]":
     return typing.cast(
         "typing.Dict[str, object]",

workspace_server/workspace.html

@@ -136,6 +136,36 @@
       gap: var(--space-2);
       min-width: 0;
     }
+    .context-meter {
+      --context-remaining: 0%;
+      --context-meter-size: 22px;
+      position: relative;
+      display: inline-grid;
+      place-items: center;
+      width: var(--context-meter-size);
+      height: var(--context-meter-size);
+      border-radius: 999px;
+      background: conic-gradient(#4ca56f 0 var(--context-remaining), #cfd8d2 0 100%);
+      color: #335243;
+      font-family: ui-monospace, SFMono-Regular, Menlo, Consolas, monospace;
+      font-size: 9px;
+      line-height: 1;
+      flex: 0 0 auto;
+    }
+    .context-meter.hidden {
+      display: none;
+    }
+    .context-meter::before {
+      content: "";
+      position: absolute;
+      inset: 4px;
+      border-radius: 999px;
+      background: #fff;
+    }
+    .context-meter-value {
+      position: relative;
+      z-index: 1;
+    }
     .tabs {
       display: flex;
       align-items: center;
@@ -171,21 +201,27 @@
       background: #eef7f1;
       box-shadow: inset 0 -2px 0 var(--accent);
     }
-    .tab.running::before {
+    .tab-status {
+      position: relative;
+      display: inline-flex;
+      align-items: center;
+      justify-content: center;
+      width: 15px;
+      height: 15px;
+      border: 1px solid transparent;
+      border-radius: 999px;
+      background: transparent;
+      padding: 0;
+      flex: 0 0 auto;
+    }
+    .tab-status::before {
       content: "";
-      position: absolute;
-      left: 6px;
-      top: 50%;
       width: 5px;
       height: 5px;
-      margin-top: -2.5px;
       border-radius: 999px;
       background: var(--accent);
       animation: spinner-pulse 1.2s cubic-bezier(0.4, 0, 0.2, 1) infinite;
     }
-    .tab.running .tab-label {
-      padding-left: var(--space-4);
-    }
     .tab-label {
       min-width: 0;
       overflow: hidden;
@@ -352,9 +388,9 @@
       text-decoration: underline;
     }
     .composer {
+      position: relative;
       min-width: 0;
-      border-top: 1px solid var(--line);
-      padding: var(--space-4) var(--space-6) var(--space-5);
+      padding: var(--space-4);
       display: grid;
       gap: var(--space-3);
       align-content: end;
@@ -363,7 +399,6 @@
     textarea {
       min-width: 0;
       resize: vertical;
-      min-height: 40px;
       max-height: 35vh;
       width: 100%;
       border: 1px solid var(--line);
@@ -385,14 +420,27 @@
       justify-content: flex-end;
       align-items: center;
     }
-    .spinner {
+    .spinner-wrap {
       position: relative;
       display: inline-flex;
       align-items: center;
       justify-self: start;
       align-self: end;
       max-width: 100%;
-      min-height: 20px;
+    }
+    .prompt-row {
+      display: flex;
+      align-items: center;
+      gap: var(--space-2);
+      min-width: 0;
+    }
+    .spinner {
+      --spinner-pill-height: 22px;
+      position: relative;
+      display: inline-flex;
+      align-items: center;
+      max-width: 100%;
+      height: var(--spinner-pill-height);
       color: var(--muted);
       font-size: 12px;
       white-space: nowrap;
@@ -402,11 +450,22 @@
       border-radius: 999px;
       background: rgba(240, 250, 244, 0.96);
       border: 1px solid rgba(172, 216, 188, 0.9);
+      font: inherit;
+      font-size: 12px;
+      cursor: pointer;
     }
     .spinner:empty {
       display: none;
     }
-    .spinner:not(:empty) {
+    .spinner-wrap:not(:has(.spinner:not(:empty))) {
+      display: none;
+    }
+    .spinner:focus-visible {
+      border-color: #65b782;
+      box-shadow: 0 0 0 3px rgba(15, 143, 85, 0.13);
+      outline: 0;
+    }
+    .spinner-wrap:has(.spinner:not(:empty)) {
       margin-bottom: var(--space-1);
     }
     .spinner:not(:empty)::before {
@@ -421,6 +480,38 @@
       background: var(--accent);
       animation: spinner-pulse 1.2s cubic-bezier(0.4, 0, 0.2, 1) infinite;
     }
+    .spinner.notify-enabled {
+      color: #0b6b43;
+      background: #e6f4eb;
+      border-color: #4ca56f;
+      box-shadow:
+        inset 0 1px 2px rgba(9, 93, 55, 0.16),
+        inset 0 0 0 1px rgba(15, 143, 85, 0.1);
+    }
+    .toast {
+      position: absolute;
+      left: 0;
+      bottom: 100%;
+      z-index: 5;
+      width: max-content;
+      max-width: min(320px, calc(100vw - var(--space-6) * 2));
+      border: 1px solid #bfd6c8;
+      border-radius: var(--radius-sm);
+      background: #f6fbf8;
+      color: var(--ink);
+      box-shadow: 0 8px 20px rgba(25, 35, 31, 0.12);
+      padding: var(--space-4) var(--space-6);
+      font-size: 12px;
+      opacity: 0;
+      pointer-events: none;
+      transform: translateY(4px);
+      transition: opacity 120ms ease, transform 120ms ease;
+      margin-bottom: var(--space-3);
+    }
+    .toast.visible {
+      opacity: 1;
+      transform: translateY(0);
+    }
     @keyframes spinner-pulse {
       0%, 100% {
         opacity: 0.45;
@@ -445,11 +536,11 @@
     }
     @media (prefers-reduced-motion: reduce) {
       .entry.thinking,
-      .tab.running::before,
+      .tab-status::before,
       .spinner:not(:empty)::before {
         animation: none;
       }
-      .tab.running::before,
+      .tab-status::before,
       .spinner:not(:empty)::before {
         opacity: 0.8;
         transform: none;
@@ -485,8 +576,16 @@
       </div>
       <div id="log" class="log"></div>
       <form id="composer" class="composer">
-        <div id="spinner" class="spinner" role="status" aria-live="polite"></div>
-        <textarea id="prompt" placeholder="Ask pycodex or type /help..."></textarea>
+        <div class="spinner-wrap">
+          <div id="toast" class="toast" role="status" aria-live="polite"></div>
+          <button id="spinner" class="spinner" type="button" role="checkbox" aria-checked="false" aria-live="polite"></button>
+        </div>
+        <div class="prompt-row">
+          <div id="contextMeter" class="context-meter hidden" aria-hidden="true">
+            <span id="contextMeterValue" class="context-meter-value"></span>
+          </div>
+          <textarea id="prompt" rows="1" placeholder="Ask pycodex or type /help..."></textarea>
+        </div>
       </form>
     </section>
   </div>
@@ -495,21 +594,25 @@
   <script>
     const log = document.getElementById("log");
     const spinner = document.getElementById("spinner");
+    const toast = document.getElementById("toast");
     const prompt = document.getElementById("prompt");
     const form = document.getElementById("composer");
     const boardFrame = document.getElementById("boardFrame");
     const workspace = document.querySelector(".workspace");
     const splitter = document.getElementById("splitter");
     const tabsEl = document.getElementById("tabs");
+    const contextMeter = document.getElementById("contextMeter");
+    const contextMeterValue = document.getElementById("contextMeterValue");
     const newTabButton = document.getElementById("newTab");
     let pollTimer = null;
     let boardPollTimer = null;
     let pollInFlight = false;
     let boardPollInFlight = false;
-    let lastBoardSignature = "";
+    let lastBoardSignature = null;
     let lastRenderedSignature = "";
     let resizeStart = null;
     let spinnerText = "";
+    let toastTimer = null;
     let activeSessionId = "";
     let sessions = [];
     let isComposing = false;
@@ -627,9 +730,128 @@
       event.preventDefault();
     }
 
-    function setSpinner(text) {
-      spinnerText = String(text || "").trim();
+    function setSpinner(text, options = {}) {
+      const previousText = spinnerText;
+      const nextText = String(text || "").trim();
+      const wasRunning = Boolean(previousText);
+      const isRunning = Boolean(nextText);
+      spinnerText = nextText;
       spinner.textContent = spinnerText;
+      if (wasRunning && !isRunning && !options.suppressDoneNotification) {
+        const state = stateForSession(activeSessionId);
+        if (state.wasRunning) notifySessionDone(activeSessionId);
+      }
+      updateSpinnerNotifyUi();
+    }
+
+    function showToast(text) {
+      if (toastTimer) clearTimeout(toastTimer);
+      toast.textContent = text;
+      toast.classList.add("visible");
+      toastTimer = setTimeout(() => {
+        toastTimer = null;
+        toast.classList.remove("visible");
+      }, 1400);
+    }
+
+    function updateSpinnerNotifyUi() {
+      const state = stateForSession(activeSessionId);
+      const enabled = Boolean(spinnerText && state.notifyWhenDone);
+      spinner.classList.toggle("notify-enabled", enabled);
+      spinner.setAttribute("aria-checked", enabled ? "true" : "false");
+      if (!spinnerText) {
+        spinner.title = "Spinner is idle";
+      } else if (enabled) {
+        spinner.title = "Notify when done is on";
+      } else {
+        spinner.title = "Notify when done is off";
+      }
+    }
+
+    function notificationAvailable() {
+      return "Notification" in window;
+    }
+
+    function requestNotificationPermission() {
+      try {
+        const requestResult = Notification.requestPermission();
+        if (requestResult && typeof requestResult.then === "function") {
+          return requestResult;
+        }
+        return Promise.resolve(Notification.permission);
+      } catch (_error) {
+        return Promise.resolve(Notification.permission);
+      }
+    }
+
+    function notifySessionDone(sessionId, sessionSummary = null) {
+      if (!sessionId) return;
+      const state = stateForSession(sessionId);
+      if (!state.notifyWhenDone) return;
+      state.notifyWhenDone = false;
+      if (!notificationAvailable() || Notification.permission !== "granted") return;
+      const session = sessionSummary || sessionById(sessionId);
+      const title = (session && session.title) || "pycodex";
+      const lastAssistant = (session && session.last_assistant) || "Done.";
+      try {
+        new Notification(`session: ${title}`, {
+          body: lastAssistant,
+          tag: `pycodex-workspace-done-${sessionId}`,
+        });
+      } catch (_error) {
+        return;
+      }
+    }
+
+    function sessionById(sessionId) {
+      return sessions.find((session) => (session.id || "") === sessionId) || null;
+    }
+
+    function isSessionRunning(sessionId) {
+      if (sessionId === activeSessionId && spinnerText) return true;
+      const session = sessionById(sessionId);
+      if (session) return Boolean(session.running);
+      return false;
+    }
+
+    async function toggleSpinnerNotification() {
+      const sessionId = activeSessionId;
+      if (!sessionId || !isSessionRunning(sessionId)) {
+        showToast("notify-on-done unavailable");
+        return;
+      }
+      const state = stateForSession(sessionId);
+      if (state.notifyWhenDone) {
+        state.notifyWhenDone = false;
+        showToast("notify-on-done canceled");
+        updateSpinnerNotifyUi();
+        return;
+      }
+      if (!notificationAvailable()) {
+        showToast("browser notifications unavailable");
+        return;
+      }
+      if (Notification.permission === "denied") {
+        showToast("browser notifications blocked");
+        return;
+      }
+      state.notifyWhenDone = true;
+      showToast("notify-on-done enabled");
+      updateSpinnerNotifyUi();
+      if (Notification.permission !== "granted") {
+        const permission = await requestNotificationPermission();
+        if (permission !== "granted") {
+          state.notifyWhenDone = false;
+          showToast("notify-on-done canceled");
+          updateSpinnerNotifyUi();
+          return;
+        }
+      }
+      if (!isSessionRunning(sessionId)) {
+        state.notifyWhenDone = false;
+        showToast("notify-on-done canceled");
+      }
+      updateSpinnerNotifyUi();
     }
 
     function isNearBottom() {
@@ -642,16 +864,22 @@
 
     function resizePrompt() {
       prompt.style.height = "auto";
-      const minHeight = 40;
-      const maxHeight = Math.max(minHeight, Math.round(window.innerHeight * 0.35));
-      const nextHeight = Math.max(minHeight, Math.min(prompt.scrollHeight, maxHeight));
+      const borderHeight = prompt.offsetHeight - prompt.clientHeight;
+      const maxHeight = Math.round(window.innerHeight * 0.35);
+      const nextHeight = Math.min(prompt.scrollHeight + borderHeight, maxHeight);
       prompt.style.height = `${nextHeight}px`;
     }
 
     function stateForSession(sessionId) {
       const key = String(sessionId || "");
       if (!sessionState.has(key)) {
-        sessionState.set(key, {lastRenderedSignature: "", scrollTop: null, draft: ""});
+        sessionState.set(key, {
+          lastRenderedSignature: "",
+          scrollTop: null,
+          draft: "",
+          notifyWhenDone: false,
+          wasRunning: false,
+        });
       }
       return sessionState.get(key);
     }
@@ -667,11 +895,27 @@
     }
 
     function updateSessions(nextSessions) {
-      sessions = Array.isArray(nextSessions) ? nextSessions : sessions;
+      const incomingSessions = Array.isArray(nextSessions) ? nextSessions : sessions;
+      incomingSessions.forEach((session) => {
+        const sessionId = session.id || "";
+        if (!sessionId) return;
+        const state = stateForSession(sessionId);
+        const wasRunning = Boolean(state.wasRunning);
+        const isRunning = Boolean(session.running);
+        if (!wasRunning && isRunning) {
+          state.notifyWhenDone = false;
+        } else if (wasRunning && !isRunning) {
+          notifySessionDone(sessionId, session);
+        }
+        state.wasRunning = isRunning;
+      });
+      sessions = incomingSessions;
       if (!activeSessionId && sessions.length) {
         activeSessionId = sessions[0].id || "";
       }
       renderTabs();
+      updateContextMeter();
+      updateSpinnerNotifyUi();
     }
 
     function renderTabs() {
@@ -689,6 +933,13 @@
         if (session.running) tab.setAttribute("aria-busy", "true");
         tab.addEventListener("click", () => switchSession(sessionId));
 
+        if (session.running) {
+          const status = document.createElement("span");
+          status.className = "tab-status";
+          status.setAttribute("aria-hidden", "true");
+          tab.appendChild(status);
+        }
+
         const label = document.createElement("span");
         label.className = "tab-label";
         label.textContent = session.title || `Session ${index + 1}`;
@@ -710,6 +961,38 @@
       });
     }
 
+    function updateContextMeter(snapshot = null) {
+      let percent = null;
+      if (snapshot && snapshot.context_remaining_percent !== undefined) {
+        percent = snapshot.context_remaining_percent;
+      } else {
+        const session = sessionById(activeSessionId);
+        if (session && session.context_remaining_percent !== undefined) {
+          percent = session.context_remaining_percent;
+        }
+      }
+      if (percent === null || percent === undefined || percent === "") {
+        contextMeter.classList.add("hidden");
+        contextMeterValue.textContent = "";
+        return;
+      }
+      const value = Math.max(0, Math.min(100, Math.round(Number(percent))));
+      if (!Number.isFinite(value)) {
+        contextMeter.classList.add("hidden");
+        contextMeterValue.textContent = "";
+        return;
+      }
+      if (value >= 100) {
+        contextMeter.classList.remove("hidden");
+        contextMeter.style.setProperty("--context-remaining", `${value}%`);
+        contextMeterValue.textContent = "";
+        return;
+      }
+      contextMeter.classList.remove("hidden");
+      contextMeter.style.setProperty("--context-remaining", `${value}%`);
+      contextMeterValue.textContent = String(value);
+    }
+
     function messageSignature(snapshot) {
       const turns = (snapshot && snapshot.turns) || [];
       return JSON.stringify(
@@ -771,10 +1054,14 @@
         const response = await fetch(relativeUrl("api/board"));
         if (!response.ok) return;
         const payload = await response.json();
-        if (!payload.exists) return;
+        if (!payload.exists) {
+          lastBoardSignature = null;
+          return;
+        }
         const signature = `${payload.mtime_ns || ""}:${payload.size || ""}`;
-        if (!lastBoardSignature) {
+        if (lastBoardSignature === null) {
           lastBoardSignature = signature;
+          boardFrame.src = `board?t=${Date.now()}`;
           return;
         }
         if (signature !== lastBoardSignature) {
@@ -800,6 +1087,7 @@
       const signature = messageSignature(snapshot);
       if (signature === state.lastRenderedSignature) {
         setSpinner(snapshot.spinner || "");
+        updateContextMeter(snapshot);
         return;
       }
       state.lastRenderedSignature = signature;
@@ -814,6 +1102,7 @@
           turns.forEach((turn) => renderTurn(turn, shouldStick));
         }
         setSpinner(snapshot.spinner || "");
+        updateContextMeter(snapshot);
         if (restoreScrollTop !== null) {
           log.scrollTop = Math.min(
             restoreScrollTop,
@@ -889,7 +1178,7 @@
       suppressScrollSave = true;
       log.textContent = "";
       suppressScrollSave = false;
-      setSpinner("");
+      setSpinner("", {suppressDoneNotification: true});
       restoreScrollTop = state.scrollTop;
       await pollSession();
       renderTabs();
@@ -984,12 +1273,18 @@
     splitter.addEventListener("pointerup", endResize);
     splitter.addEventListener("pointercancel", endResize);
     splitter.addEventListener("dblclick", centerSplit);
+    spinner.addEventListener("click", toggleSpinnerNotification);
     newTabButton.addEventListener("click", createSession);
     window.addEventListener("resize", () => {
       const current = Number(window.localStorage.getItem("pycodex.workspace.chatWidth") || 0);
       if (current > 0) setChatWidth(current);
       resizePrompt();
     });
+    document.addEventListener("visibilitychange", () => {
+      if (document.visibilityState !== "visible") return;
+      pollSession();
+      pollBoard();
+    });
 
     loadChatWidth();
     resizePrompt();