From c11d9254a21f3ad84d5916798cc74ebe5c401de7 Mon Sep 17 00:00:00 2001
From: Charley Wu <akunzai@gmail.com>
Date: Mon, 27 Jul 2026 23:01:51 +0800
Subject: [PATCH] fix: prevent statusline example script from hanging on
 blocked stdin

The example script read stdin unbounded (jq reading directly from the
live pipe). During auth/OAuth refresh or resume-conversation warm-up,
the CLI's statusline runner can hold stdin open without writing or
closing it, so the script hangs until the runner's ~5-10s hard kill
(signal: killed), and enough consecutive kills auto-disables the
custom statusline.

Read stdin with a short timeout up front, close it immediately after
(exec 0</dev/null) so nothing later can block on it, and default to
"{}" when no input arrived in time so the rest of the script still
renders a degraded status line instead of crashing on empty read.

Closes #698
---
 examples/statusline/statusline.sh | 34 ++++++++++++++++++++++++++++++-
 1 file changed, 33 insertions(+), 1 deletion(-)

diff --git a/examples/statusline/statusline.sh b/examples/statusline/statusline.sh
index 390fea1ee..f25ac2cd2 100755
--- a/examples/statusline/statusline.sh
+++ b/examples/statusline/statusline.sh
@@ -1,6 +1,38 @@
 #!/bin/bash
 set -euo pipefail
 
+# ─── stdin timeout guard ──────────────────────────────────────────────────────
+# The CLI's statusline runner hard-kills this script (~5-10s) if it never
+# returns. During auth/OAuth refresh or resume-conversation warm-up, stdin can
+# be held open by the runner without being written to or closed, so an
+# unbounded `jq`/`cat` read on stdin hangs until SIGKILL — and enough
+# consecutive kills auto-disables the custom statusline. Read stdin with a
+# short timeout up front and close it immediately after, so the rest of the
+# script never blocks on it.
+run_with_timeout() {
+  local t="$1"
+  shift
+  if command -v timeout >/dev/null 2>&1; then
+    timeout --foreground "$t" "$@"
+  else
+    "$@" <&0 &
+    local pid=$!
+    ( sleep "$t"; kill "$pid" 2>/dev/null || true ) &
+    local killer=$!
+    wait "$pid" 2>/dev/null
+    local res=$?
+    kill "$killer" 2>/dev/null || true
+    wait "$killer" 2>/dev/null || true
+    return $res
+  fi
+}
+
+JSON_INPUT=$(run_with_timeout 0.25 cat 2>/dev/null || true)
+exec 0</dev/null
+if [ -z "$JSON_INPUT" ]; then
+  JSON_INPUT="{}"
+fi
+
 # ─── ANSI Helpers (Standard 16-color palette only) ───────────────────────────
 R="\033[0m"         # Reset
 B="\033[1m"         # Bold
@@ -43,7 +75,7 @@ NUM_COLOR="${FG_BRIGHT_WHITE}${B}"
   read -r MODEL
   read -r COLS
 } <<< "$(
-  jq -r '
+  printf '%s' "$JSON_INPUT" | jq -r '
     (.agent_state // "idle"),
     (.context_window.used_percentage // 0),
     (.vcs.branch // ""),