realtimex-deeptutor 0.5.0.post7__py3-none-any.whl → 0.5.0.post9__py3-none-any.whl

{realtimex_deeptutor-0.5.0.post7.dist-info → realtimex_deeptutor-0.5.0.post9.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: realtimex-deeptutor
-Version: 0.5.0.post7
+Version: 0.5.0.post9
 Summary: RealTimeX DeepTutor - Intelligent learning companion with multi-agent collaboration and LightRAG
 License: Apache-2.0
 Requires-Python: >=3.10

{realtimex_deeptutor-0.5.0.post7.dist-info → realtimex_deeptutor-0.5.0.post9.dist-info}/RECORD

@@ -1,5 +1,5 @@
 realtimex_deeptutor/__init__.py,sha256=sSfuCLjJa6BnayszcU4azNl_sr1OzuKgLP10BAtdoh8,1567
-realtimex_deeptutor-0.5.0.post7.dist-info/licenses/LICENSE,sha256=hIahDEOTzuHCU5J2nd07LWwkLW7Hko4UFO__ffsvB-8,34523
+realtimex_deeptutor-0.5.0.post9.dist-info/licenses/LICENSE,sha256=hIahDEOTzuHCU5J2nd07LWwkLW7Hko4UFO__ffsvB-8,34523
 scripts/__init__.py,sha256=mxMsCbci-Qon3qWU1JIi93-tYlHAy0NIUbDRmAPVcg0,54
 scripts/audit_prompts.py,sha256=Ltuk7tvsjpKhiobVbYq1volgVFKiVLgSTaE_Is4MGaM,5651
 scripts/check_install.py,sha256=GbApEcDLJ6r0QmYrCVHAFCOK4wolpSLwL3eBRmmD3og,13929
@@ -7,7 +7,7 @@ scripts/generate_roster.py,sha256=COsJ12bvZ5W9TI-wAvKpknKBgHr9uQTvJ_JCz2gVMVo,12
 scripts/install_all.py,sha256=u-A3eLhk1ua_KCjz8WZMkrVNJN6QdYs7NhGOcsm-Mks,23875
 scripts/migrate_kb.py,sha256=uyJgplkJag35rT2RrwSiT37__gpB4TiA0xh5uVcWIa4,19667
 scripts/start.py,sha256=EYbyjryor0DN_WcxQMSkKWCboM9UjMkv61fWhLyv63I,30300
-scripts/start_web.py,sha256=P7YCnJgjva58hjs5F4ogtrlVS1wDLFqWoUfoHZ9vREE,32197
+scripts/start_web.py,sha256=JyFWfDps1P6ErhW8746YC-adODrvQQYQqlNkgLX39pU,35252
 scripts/sync_prompts_from_en.py,sha256=TkBSFilYSwnwo0a3cgRnJ84i02zByAIW12N3ePzBwE8,4677
 src/__init__.py,sha256=UNw3C20mbskiQF3rK3HhjglrG8snhfuiVthc5UsoHX0,1046
 src/agents/__init__.py,sha256=IPhP4RZnCH2kcUDBkdKHO_ciVdyWnuHUCG2flG5Ydcw,885
@@ -289,8 +289,8 @@ src/utils/error_utils.py,sha256=ME_9q-DlmxFl-Xvv3ETPZE_iP705x6MXiuAREgWYsjM,2262
 src/utils/json_parser.py,sha256=M_KfrsrNvQPSiFvpKHQV79Aj85_MEcLVc6hnKzvTV58,3243
 src/utils/realtimex.py,sha256=vs7fAEnJJ4zpAyyBn-7vUmGWiiQvpTWQCRgax1MLTDw,9769
 src/utils/network/circuit_breaker.py,sha256=BtjogK5R3tG8fuJniS5-PJKZMtwD5P2SkP2JFiQ9sRA,2722
-realtimex_deeptutor-0.5.0.post7.dist-info/METADATA,sha256=-pKSs_xYVcVXMMkGETtdGsa7Yabv1jvUCSk_JH1GTMU,58304
-realtimex_deeptutor-0.5.0.post7.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-realtimex_deeptutor-0.5.0.post7.dist-info/entry_points.txt,sha256=slNAzwRLUpqiMtDRZBQIkXbU2vGMHL_om6-o19gYdh8,134
-realtimex_deeptutor-0.5.0.post7.dist-info/top_level.txt,sha256=zUAd6V7jDYhdL7bvg2S38YCM-gVhvd36WqkjxrT-02I,32
-realtimex_deeptutor-0.5.0.post7.dist-info/RECORD,,
+realtimex_deeptutor-0.5.0.post9.dist-info/METADATA,sha256=H48RMbu9fdvqmkRVyDTK5ODo3vmyyDeIow4MpIoSExg,58304
+realtimex_deeptutor-0.5.0.post9.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+realtimex_deeptutor-0.5.0.post9.dist-info/entry_points.txt,sha256=slNAzwRLUpqiMtDRZBQIkXbU2vGMHL_om6-o19gYdh8,134
+realtimex_deeptutor-0.5.0.post9.dist-info/top_level.txt,sha256=zUAd6V7jDYhdL7bvg2S38YCM-gVhvd36WqkjxrT-02I,32
+realtimex_deeptutor-0.5.0.post9.dist-info/RECORD,,

scripts/start_web.py

@@ -143,6 +143,103 @@ else:
         return False
 
 
+def find_pid_by_port(port: int) -> int | None:
+    """
+    Find PID using a port with multiple fallback methods.
+    Returns PID or None if not found.
+    """
+    if os.name == "nt":
+        # Windows: use netstat
+        try:
+            result = subprocess.run(
+                ["netstat", "-ano"],
+                capture_output=True,
+                text=True,
+                timeout=5,
+            )
+            for line in result.stdout.splitlines():
+                if f":{port}" in line and "LISTENING" in line:
+                    parts = line.split()
+                    if parts:
+                        try:
+                            return int(parts[-1])
+                        except ValueError:
+                            pass
+        except Exception:
+            pass
+        return None
+
+    # Unix: Try strategies in order: lsof -> ss -> netstat
+
+    # Strategy 1: lsof (standard)
+    try:
+        result = subprocess.run(
+            ["lsof", "-ti", f":{port}"],
+            capture_output=True,
+            text=True,
+            timeout=5,
+        )
+        if result.returncode == 0 and result.stdout.strip():
+            try:
+                # May return multiple PIDs, take the first one
+                return int(result.stdout.strip().split()[0])
+            except (ValueError, IndexError):
+                pass
+    except FileNotFoundError:
+        pass  # lsof not installed
+    except Exception:
+        pass
+
+    # Strategy 2: ss (modern Linux)
+    try:
+        # ss -lptn 'sport = :8001'
+        result = subprocess.run(
+            ["ss", "-lptn", f"sport = :{port}"],
+            capture_output=True,
+            text=True,
+            timeout=5,
+        )
+        if result.returncode == 0:
+            # Output format: Users:(("python",pid=1234,fd=3))
+            output = result.stdout
+            if f":{port}" in output and "pid=" in output:
+                import re
+
+                match = re.search(r"pid=(\d+)", output)
+                if match:
+                    return int(match.group(1))
+    except FileNotFoundError:
+        pass  # ss not installed
+    except Exception:
+        pass
+
+    # Strategy 3: netstat (legacy Unix)
+    try:
+        # netstat -nlp | grep :8001
+        p1 = subprocess.Popen(
+            ["netstat", "-nlp"], stdout=subprocess.PIPE, stderr=subprocess.DEVNULL
+        )
+        p2 = subprocess.Popen(
+            ["grep", f":{port}"], stdin=p1.stdout, stdout=subprocess.PIPE, text=True
+        )
+        if p1.stdout:
+            p1.stdout.close()
+        output, _ = p2.communicate(timeout=5)
+
+        if output:
+            # Expected: tcp 0 0 0.0.0.0:8001 0.0.0.0:* LISTEN 1234/python
+            parts = output.split()
+            for part in parts:
+                if "/" in part and part.split("/")[0].isdigit():
+                    return int(part.split("/")[0])
+    except FileNotFoundError:
+        pass
+    except Exception:
+        pass
+
+    return None
+
+
 def check_port_in_use(port: int) -> tuple[bool, int | None]:
     """
     Check if a port is in use and return the PID of the process using it.
@@ -177,42 +274,7 @@ def check_port_in_use(port: int) -> tuple[bool, int | None]:
             pass
 
     # Port is in use (connection succeeded), try to find the PID
-    pid = None
-    try:
-        if os.name == "nt":
-            # Windows: use netstat
-            result = subprocess.run(
-                ["netstat", "-ano"],
-                capture_output=True,
-                text=True,
-                timeout=5,
-            )
-            for line in result.stdout.splitlines():
-                if f":{port}" in line and "LISTENING" in line:
-                    parts = line.split()
-                    if parts:
-                        try:
-                            pid = int(parts[-1])
-                            break
-                        except ValueError:
-                            pass
-        else:
-            # Unix: use lsof
-            result = subprocess.run(
-                ["lsof", "-ti", f":{port}"],
-                capture_output=True,
-                text=True,
-                timeout=5,
-            )
-            if result.returncode == 0 and result.stdout.strip():
-                # May return multiple PIDs, take the first one
-                try:
-                    pid = int(result.stdout.strip().split()[0])
-                except (ValueError, IndexError):
-                    pass
-    except Exception:
-        pass
-
+    pid = find_pid_by_port(port)
     return True, pid
 
 
@@ -233,7 +295,11 @@ def kill_process_on_port(port: int, force: bool = False) -> bool:
 
     if pid is None:
         print_flush(f"⚠️  Port {port} is in use but couldn't identify the process")
-        return False
+        # Retry detection once with slightly longer delay just in case
+        time.sleep(1)
+        _, pid = check_port_in_use(port)
+        if pid is None:
+            return False
 
     print_flush(f"   Stopping process {pid} on port {port}...")
 
@@ -241,21 +307,35 @@ def kill_process_on_port(port: int, force: bool = False) -> bool:
         if os.name == "nt":
             subprocess.run(["taskkill", "/F", "/PID", str(pid)], check=True, capture_output=True)
         else:
-            sig = signal.SIGKILL if force else signal.SIGTERM
-            os.kill(pid, sig)
+            # Try to kill the process group first (handles child processes)
+            try:
+                pgid = os.getpgid(pid)
+                sig = signal.SIGKILL if force else signal.SIGTERM
+                os.killpg(pgid, sig)
+            except (ProcessLookupError, PermissionError):
+                # Fallbck to simple kill if PGID fails
+                sig = signal.SIGKILL if force else signal.SIGTERM
+                os.kill(pid, sig)
+
             # Wait a moment for process to terminate
             time.sleep(0.5)
             # Check if still running, force kill if needed
             if not force:
                 try:
                     os.kill(pid, 0)  # Check if process exists
-                    os.kill(pid, signal.SIGKILL)
+                    # If still alive, Force Kill
+                    print_flush(f"   Process {pid} still alive, force killing...")
+                    try:
+                        pgid = os.getpgid(pid)
+                        os.killpg(pgid, signal.SIGKILL)
+                    except:
+                        os.kill(pid, signal.SIGKILL)
                     time.sleep(0.3)
                 except ProcessLookupError:
                     pass  # Process already terminated
 
         # Verify port is now free
-        time.sleep(0.3)
+        time.sleep(0.5)
         in_use, _ = check_port_in_use(port)
         if not in_use:
             print_flush(f"✅ Port {port} is now free")
@@ -731,6 +811,15 @@ def _start_frontend_npx(frontend_port, backend_port):
 
     npx_cmd = npx_path or "npx"
 
+    # Ensure the directory containing npx (and node) is in PATH
+    # This is critical for bundled environments where node might not be in system PATH
+    if npx_path:
+        npx_dir = os.path.dirname(os.path.abspath(npx_path))
+        current_path = env.get("PATH", "")
+        # Prepend to PATH to ensure our bundled node is found first
+        env["PATH"] = f"{npx_dir}{os.pathsep}{current_path}"
+        print_flush(f"📌 Added to PATH: {npx_dir}")
+
     # Process group configuration
     popen_kwargs = {
         "shell": False,