fix: detect rate-limit error, auto-retry once after 30s with friendly message

app.js

@@ -107,8 +107,10 @@ function broadcast(payload) {
   }
 }
 
+let retryTimer = null;
+
 function startShellular() {
-  if (shellularProc) return;
+  if (shellularProc || retryTimer) return;
 
   broadcast({ type: 'status', status: 'starting' });
 
@@ -117,8 +119,12 @@ function startShellular() {
     stdio: ['ignore', 'pipe', 'pipe'],
   });
 
+  // Accumulate stdout/stderr so we can detect the error type on exit
+  let procOutput = '';
+
   const handleData = (chunk) => {
     const text = stripAnsi(chunk.toString());
+    procOutput   += text;
     outputBuffer += text;
     broadcast({ type: 'output', text });
   };
@@ -135,17 +141,43 @@ function startShellular() {
   });
 
   shellularProc.on('exit', (code, signal) => {
-    const text = `\n[shellular exited — code=${code ?? '?'}, signal=${signal ?? 'none'}]\n`;
-    outputBuffer += text;
-    broadcast({ type: 'output', text });
     shellularProc = null;
-    broadcast({ type: 'status', status: 'stopped' });
+
+    // Detect rate-limit / registration failure (exit code 1, no signal)
+    const isRegError = code === 1 && !signal &&
+      (procOutput.includes('invalid_union') || procOutput.includes('Too many requests') ||
+       procOutput.includes('host registration'));
+
+    if (isRegError) {
+      const WAIT = 30;
+      const msg = `\n⚠ Registration rate-limited by shellular API.\n` +
+                  `  Retrying automatically in ${WAIT}s — please wait…\n`;
+      outputBuffer += msg;
+      broadcast({ type: 'output', text: msg });
+      broadcast({ type: 'status', status: 'retrying' });
+
+      retryTimer = setTimeout(() => {
+        retryTimer = null;
+        const msg2 = '\n[Retrying registration…]\n';
+        outputBuffer += msg2;
+        broadcast({ type: 'output', text: msg2 });
+        startShellular();
+      }, WAIT * 1000);
+    } else {
+      const text = code !== 0
+        ? `\n[shellular exited — code=${code ?? '?'}, signal=${signal ?? 'none'}]\n`
+        : '\n[shellular disconnected]\n';
+      outputBuffer += text;
+      broadcast({ type: 'output', text });
+      broadcast({ type: 'status', status: 'stopped' });
+    }
   });
 
   broadcast({ type: 'status', status: 'running' });
 }
 
 function stopShellular() {
+  if (retryTimer) { clearTimeout(retryTimer); retryTimer = null; }
   if (!shellularProc) return;
   shellularProc.kill('SIGTERM');
   shellularProc = null;

public/app.js

@@ -184,9 +184,20 @@ function handleEvent(payload) {
 function updateStatus(status) {
   shellStatus = status;
 
-  const labels = { running: 'Running', starting: 'Starting', stopped: 'Stopped', error: 'Error' };
+  const labels = {
+    running:  'Running',
+    starting: 'Starting',
+    retrying: 'Retrying…',
+    stopped:  'Stopped',
+    error:    'Error',
+  };
   statusBadge.textContent = labels[status] || status;
-  statusBadge.className = `badge badge-${status}`;
+  statusBadge.className   = `badge badge-${status}`;
+
+  if (status === 'retrying') {
+    if (!qrRendered) setQrState('loading');
+    return; // keep showing the spinner while we wait
+  }
 
   if (status === 'stopped' || status === 'error') {
     if (!qrRendered) {

public/style.css

@@ -242,6 +242,7 @@ html, body {
 }
 .badge-running  { background: rgba(74,222,128,.15); color: var(--success); }
 .badge-starting { background: rgba(250,204,21,.15);  color: var(--warning); }
+.badge-retrying { background: rgba(250,204,21,.15);  color: var(--warning); }
 .badge-stopped  { background: rgba(255,95,109,.12); color: var(--error); }
 .badge-error    { background: rgba(255,95,109,.12); color: var(--error); }