zevairouter 1.0.65 → 1.0.66

package/cli/app/cli/app/cli/app/cli/app/cli/app/cli/app/cli/app/cli/app/cli/app/cli/app/cli/app/cli/app/cli/app/cli/app/cli/app/cli/app/cli/app/cli/app/cli/app/cli/app/cli/app/cli/app/cli/app/cli/app/cli/app/cli/app/cli/app/cli/app/cli/app/cli/app/cli/app/cli/app/cli/app/src/lib/terminal/ptyBridge.py

@@ -0,0 +1,163 @@
+#!/usr/bin/env python3
+"""
+Minimal PTY bridge for ZevaiRouter web terminal.
+
+stdin  -> PTY master (keystrokes)
+stdout <- PTY master (shell output), raw binary
+stderr  = control / errors (utf-8 text lines)
+
+Optional control on a side channel is not needed: resize arrives as
+OSC-like escape on stdin:  \\x1b]9999;<cols>;<rows>\\x07
+"""
+from __future__ import annotations
+
+import errno
+import fcntl
+import os
+import select
+import signal
+import struct
+import sys
+import termios
+
+
+def set_winsize(fd: int, rows: int, cols: int) -> None:
+    try:
+        packed = struct.pack("HHHH", max(5, rows), max(20, cols), 0, 0)
+        fcntl.ioctl(fd, termios.TIOCSWINSZ, packed)
+    except Exception:
+        pass
+
+
+def main() -> int:
+    cols = int(sys.argv[1]) if len(sys.argv) > 1 else 120
+    rows = int(sys.argv[2]) if len(sys.argv) > 2 else 40
+    shell = os.environ.get("SHELL") or ("/bin/bash" if os.path.exists("/bin/bash") else "/bin/sh")
+    cwd = os.path.expanduser("~")
+
+    pid, master = pty_fork = _fork_pty()
+    if pid == 0:
+        # child
+        try:
+            os.chdir(cwd)
+        except Exception:
+            pass
+        os.environ.setdefault("TERM", "xterm-256color")
+        os.environ.setdefault("COLORTERM", "truecolor")
+        os.environ.setdefault("FORCE_COLOR", "1")
+        try:
+            os.execv(shell, [shell, "-il"])
+        except Exception:
+            os.execv("/bin/sh", ["/bin/sh", "-i"])
+        return 1
+
+    set_winsize(master, rows, cols)
+
+    # Non-blocking master + stdin
+    for fd in (master, sys.stdin.fileno()):
+        fl = fcntl.fcntl(fd, fcntl.F_GETFL)
+        fcntl.fcntl(fd, fcntl.F_SETFL, fl | os.O_NONBLOCK)
+
+    # Binary stdout
+    stdout = sys.stdout.buffer
+    stdin = sys.stdin.buffer
+
+    resize_buf = b""
+
+    def handle_resize_escape(chunk: bytes) -> bytes:
+        """Strip and apply embedded resize escapes, return remaining bytes."""
+        nonlocal resize_buf
+        data = resize_buf + chunk
+        out = bytearray()
+        i = 0
+        while i < len(data):
+            # ESC ] 9999 ; cols ; rows BEL
+            if data[i] == 0x1B and data[i : i + 6] == b"\x1b]9999;":
+                end = data.find(b"\x07", i + 6)
+                if end < 0:
+                    resize_buf = data[i:]
+                    return bytes(out)
+                payload = data[i + 6 : end].decode("ascii", "ignore")
+                try:
+                    c_s, r_s = payload.split(";", 1)
+                    set_winsize(master, int(r_s), int(c_s))
+                except Exception:
+                    pass
+                i = end + 1
+                resize_buf = b""
+                continue
+            out.append(data[i])
+            i += 1
+        resize_buf = b""
+        return bytes(out)
+
+    alive = True
+
+    def on_chld(signum, frame):  # noqa: ARG001
+        nonlocal alive
+        alive = False
+
+    signal.signal(signal.SIGCHLD, on_chld)
+
+    try:
+        while alive:
+            try:
+                r, _, _ = select.select([master, sys.stdin.fileno()], [], [], 0.25)
+            except InterruptedError:
+                continue
+
+            if master in r:
+                try:
+                    data = os.read(master, 8192)
+                except OSError as e:
+                    if e.errno in (errno.EIO, errno.EAGAIN, errno.EWOULDBLOCK):
+                        data = b""
+                    else:
+                        break
+                if not data:
+                    # EIO often means child exited
+                    if not alive:
+                        break
+                else:
+                    stdout.write(data)
+                    stdout.flush()
+
+            if sys.stdin.fileno() in r:
+                try:
+                    data = stdin.read(8192)
+                except Exception:
+                    data = b""
+                if data is None:
+                    data = b""
+                if data == b"" and not alive:
+                    break
+                if data:
+                    cleaned = handle_resize_escape(data)
+                    if cleaned:
+                        try:
+                            os.write(master, cleaned)
+                        except OSError:
+                            break
+    finally:
+        try:
+            os.close(master)
+        except Exception:
+            pass
+        try:
+            os.waitpid(pid, 0)
+        except Exception:
+            pass
+    return 0
+
+
+def _fork_pty():
+    import pty
+
+    return pty.fork()
+
+
+if __name__ == "__main__":
+    try:
+        raise SystemExit(main())
+    except KeyboardInterrupt:
+        raise SystemExit(0)

package/cli/app/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zevairouter",
-  "version": "1.0.65",
+  "version": "1.0.66",
   "description": "Self-hosted AI router: many providers, one OpenAI-compatible /v1 endpoint and dashboard",
   "bin": {
     "zevai": "./cli/cli.js"

package/cli/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zevairouter-cli",
-  "version": "1.0.65",
+  "version": "1.0.66",
   "description": "ZevaiRouter CLI - Start and manage ZevaiRouter server",
   "bin": {
     "zevai": "./cli.js"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zevairouter",
-  "version": "1.0.65",
+  "version": "1.0.66",
   "description": "Self-hosted AI router: many providers, one OpenAI-compatible /v1 endpoint and dashboard",
   "bin": {
     "zevai": "./cli/cli.js"

package/src/lib/oauth/services/codebuddyCnPhoneAutomation.js

@@ -183,6 +183,8 @@ export async function runCodeBuddyCnPhoneRegistration({
     }
 
     let phoneFrame = null;
+    /** @type {{ code: string, detail: string }[]} */
+    const navFailures = [];
     for (let navAttempt = 1; navAttempt <= NAV_MAX_ATTEMPTS; navAttempt++) {
       throwIfCancelled();
       try {
@@ -212,13 +214,23 @@ export async function runCodeBuddyCnPhoneRegistration({
         if (!spaReady) {
           const bodyText = await page.locator("body").innerText().catch(() => "");
           const htmlLen = await page.evaluate(() => document.documentElement?.outerHTML?.length || 0).catch(() => 0);
+          const pageUrl = page.url();
           reportStep(
             "cn_spa_not_ready",
-            `SPA not ready after ${SPA_TIMEOUT_MS / 1000}s (url=${page.url()}, body=${String(bodyText).slice(0, 80)}, html=${htmlLen})`,
+            `SPA not ready after ${SPA_TIMEOUT_MS / 1000}s (url=${pageUrl}, body=${String(bodyText).slice(0, 80)}, html=${htmlLen})`,
           );
-          // If the page is completely empty, proxy likely blackholed the response
+          // Empty / tiny body → proxy blackhole or blocked response
           if (!bodyText && htmlLen < 200) {
             reportStep("cn_proxy_empty_page", "Empty page body — proxy may be blocking codebuddy.cn");
+            navFailures.push({
+              code: "proxy_empty",
+              detail: `empty page via ${targetUrl} (html=${htmlLen})`,
+            });
+          } else {
+            navFailures.push({
+              code: "spa_timeout",
+              detail: `SPA not ready url=${pageUrl} html=${htmlLen}`,
+            });
           }
           continue;
         }
@@ -250,23 +262,38 @@ export async function runCodeBuddyCnPhoneRegistration({
             break;
           }
           reportStep("cn_iframe_empty", "Iframe found but #phoneNumber not visible yet");
+          navFailures.push({
+            code: "iframe_empty",
+            detail: "phone iframe attached but #phoneNumber not visible",
+          });
           phoneFrame = null;
         } else {
           reportStep("cn_iframe_missing", `No #phone-iframe (attempt ${navAttempt}/${NAV_MAX_ATTEMPTS})`);
+          navFailures.push({
+            code: "iframe_missing",
+            detail: "SPA loaded but #phone-iframe never appeared",
+          });
         }
       } catch (navErr) {
         if (navErr?.code === "JOB_CANCELLED") throw navErr;
+        const errMsg = String(navErr?.message || navErr || "");
         reportStep(
           "cn_nav_retry",
-          `Navigation attempt ${navAttempt}/${NAV_MAX_ATTEMPTS} failed: ${String(navErr.message || navErr).slice(0, 120)}`,
+          `Navigation attempt ${navAttempt}/${NAV_MAX_ATTEMPTS} failed: ${errMsg.slice(0, 120)}`,
         );
+        const isTimeout = /timeout|exceeded|ETIMEDOUT|net::ERR/i.test(errMsg);
+        const isProxyNet = /ERR_PROXY|ERR_TUNNEL|ERR_CONNECTION|NS_ERROR_PROXY|proxy/i.test(errMsg);
+        navFailures.push({
+          code: isProxyNet ? "proxy_network" : isTimeout ? "nav_timeout" : "nav_error",
+          detail: errMsg.slice(0, 160),
+        });
       }
     }
 
     if (!phoneFrame) {
       return {
         status: "failed",
-        error: `Could not load CodeBuddy CN phone form after ${NAV_MAX_ATTEMPTS} attempts (proxy/SPA)`,
+        error: buildPhoneFormLoadError(navFailures, NAV_MAX_ATTEMPTS),
       };
     }
 
@@ -588,6 +615,51 @@ export async function runCodeBuddyCnPhoneRegistration({
  * Get the phone iframe's Frame object from the page.
  * The iframe id is #phone-iframe, src contains /auth/realms/copilot/.
  */
+/**
+ * Turn collected nav failure codes into an actionable user-facing error.
+ * Avoid the opaque "proxy/SPA" string so beginners know what to fix.
+ */
+function buildPhoneFormLoadError(navFailures = [], attempts = NAV_MAX_ATTEMPTS) {
+  const codes = navFailures.map((f) => f.code);
+  const last = navFailures[navFailures.length - 1];
+  const tip =
+    "Fix: use a live residential CN proxy (proxyPoolMode=single), concurrency 1, then retry. 5sim is not charged until the form loads.";
+
+  if (codes.includes("proxy_empty") || codes.includes("proxy_network")) {
+    return (
+      `CodeBuddy CN login page empty/blocked via proxy after ${attempts} attempts ` +
+      `(${last?.detail || "proxy blackhole"}). ${tip}`
+    );
+  }
+  if (codes.includes("nav_timeout")) {
+    return (
+      `CodeBuddy CN navigation timed out after ${attempts} attempts ` +
+      `(${last?.detail || "goto timeout"}). Proxy is too slow or dead. ${tip}`
+    );
+  }
+  if (codes.includes("spa_timeout")) {
+    return (
+      `CodeBuddy CN SPA did not boot after ${attempts} attempts ` +
+      `(${last?.detail || "no login UI"}). Proxy/CDN may be filtering JS. ${tip}`
+    );
+  }
+  if (codes.includes("iframe_missing") || codes.includes("iframe_empty")) {
+    return (
+      `CodeBuddy CN page opened but phone form iframe never appeared after ${attempts} attempts ` +
+      `(${last?.detail || "no #phone-iframe"}). Site layout change or half-loaded SPA — retry with another CN exit IP. ${tip}`
+    );
+  }
+  if (codes.includes("nav_error") && last?.detail) {
+    return (
+      `CodeBuddy CN phone form failed after ${attempts} attempts: ${last.detail}. ${tip}`
+    );
+  }
+  return (
+    `Could not load CodeBuddy CN phone form after ${attempts} attempts ` +
+    `(${last?.code || "unknown"}: ${last?.detail || "proxy/SPA"}). ${tip}`
+  );
+}
+
 async function getPhoneFrame(page) {
   // Prefer locator contentFrame (waits for attach) over scanning frames too early
   try {