webtap-tool 0.2.3__py3-none-any.whl → 0.3.0__py3-none-any.whl

webtap/__init__.py

@@ -9,14 +9,9 @@ PUBLIC API:
   - main: Entry point function for CLI
 """
 
-import atexit
 import sys
-import logging
 
 from webtap.app import app
-from webtap.api import start_api_server
-
-logger = logging.getLogger(__name__)
 
 
 def main():
@@ -27,13 +22,9 @@ def main():
     - MCP mode (with --mcp flag) for Model Context Protocol server
     - REPL mode (default) for interactive shell
 
-    In REPL and MCP modes, the API server is started for Chrome extension
-    integration. The API server runs in background to handle extension requests.
+    The API server for Chrome extension communication must be started
+    explicitly using the server('start') command.
     """
-    # Start API server for Chrome extension (except in CLI mode)
-    if "--cli" not in sys.argv:
-        _start_api_server_safely()
-
     if "--mcp" in sys.argv:
         app.mcp.run()
     elif "--cli" in sys.argv:
@@ -45,20 +36,4 @@ def main():
         app.run(title="WebTap - Chrome DevTools Protocol REPL")
 
 
-def _start_api_server_safely():
-    """Start API server with error handling and cleanup registration."""
-    try:
-        thread = start_api_server(app.state)
-        if thread and app.state:
-            app.state.api_thread = thread
-            logger.info("API server started on port 8765")
-
-            # Register cleanup to shut down API server on exit
-            atexit.register(lambda: app.state.cleanup() if app.state else None)
-        else:
-            logger.info("Port 8765 in use by another instance")
-    except Exception as e:
-        logger.warning(f"Failed to start API server: {e}")
-
-
 __all__ = ["app", "main"]

webtap/api.py

@@ -199,21 +199,6 @@ async def disable_all_filters() -> Dict[str, Any]:
     return {"enabled": [], "total": 0}
 
 
-@api.post("/release")
-async def release_port() -> Dict[str, Any]:
-    """Release API port for another WebTap instance."""
-    logger.info("Releasing API port for another instance")
-
-    # Schedule graceful shutdown after response
-    def shutdown():
-        # Just set the flag to stop uvicorn, don't kill the whole process
-        global _shutdown_requested
-        _shutdown_requested = True
-
-    threading.Timer(0.5, shutdown).start()
-    return {"message": "Releasing port 8765"}
-
-
 # Flag to signal shutdown
 _shutdown_requested = False
 

webtap/app.py

@@ -84,6 +84,7 @@ else:
     from webtap.commands import inspect  # noqa: E402, F401
     from webtap.commands import fetch  # noqa: E402, F401
     from webtap.commands import body  # noqa: E402, F401
+    from webtap.commands import server  # noqa: E402, F401
     from webtap.commands import setup  # noqa: E402, F401
     from webtap.commands import launch  # noqa: E402, F401
 

webtap/commands/server.py

@@ -0,0 +1,162 @@
+"""API server management command.
+
+PUBLIC API:
+  - server: Manage API server (status/start/stop/restart)
+"""
+
+import socket
+import time
+import logging
+
+from webtap.app import app
+from webtap.api import start_api_server
+
+logger = logging.getLogger(__name__)
+
+# Fixed port for API server
+API_PORT = 8765
+
+
+def _check_port() -> bool:
+    """Check if API port is in use."""
+    with socket.socket() as s:
+        try:
+            s.bind(("127.0.0.1", API_PORT))
+            return False  # Port is free
+        except OSError:
+            return True  # Port is in use
+
+
+def _stop_server(state) -> tuple[bool, str]:
+    """Stop the server if this instance owns it."""
+    if not state.api_thread or not state.api_thread.is_alive():
+        return False, "Not running"
+
+    import webtap.api
+
+    webtap.api._shutdown_requested = True
+    state.api_thread.join(timeout=2.0)
+    state.api_thread = None
+
+    return True, "Server stopped"
+
+
+def _start_server(state) -> tuple[bool, str]:
+    """Start the server on port 8765."""
+    # Check if already running
+    if state.api_thread and state.api_thread.is_alive():
+        return True, f"Already running on port {API_PORT}"
+
+    # Check if port is in use
+    if _check_port():
+        return False, f"Port {API_PORT} already in use by another process"
+
+    # Start the server
+    thread = start_api_server(state, port=API_PORT)
+    if thread:
+        state.api_thread = thread
+
+        # Register cleanup
+        import atexit
+
+        atexit.register(lambda: state.cleanup() if state else None)
+
+        return True, f"Server started on port {API_PORT}"
+    else:
+        return False, "Failed to start server"
+
+
+@app.command(
+    display="markdown",
+    fastmcp={
+        "type": "prompt",
+        "arg_descriptions": {"action": "Server action: status (default), start, stop, or restart"},
+    },
+)
+def server(state, action: str = None) -> dict:  # pyright: ignore[reportArgumentType]
+    """API server status and management information.
+
+    Returns current server state and available actions.
+    """
+    if action is None:
+        action = "status"
+
+    action = action.lower()
+    owns_server = bool(state.api_thread and state.api_thread.is_alive())
+
+    # Build markdown elements based on action
+    elements = []
+
+    if action == "status" or action not in ["start", "stop", "restart"]:
+        # Status information
+        elements.append({"type": "heading", "content": "API Server Status", "level": 2})
+
+        if owns_server:
+            elements.append({"type": "text", "content": "**Status:** Running"})
+            elements.append({"type": "text", "content": f"**Port:** {API_PORT}"})
+            elements.append({"type": "text", "content": f"**URL:** http://127.0.0.1:{API_PORT}"})
+            elements.append({"type": "text", "content": f"**Health:** http://127.0.0.1:{API_PORT}/health"})
+            elements.append({"type": "text", "content": "**Extension:** Ready to connect"})
+        else:
+            port_in_use = _check_port()
+            if port_in_use:
+                elements.append({"type": "alert", "message": "Port 8765 in use by another process", "level": "warning"})
+                elements.append({"type": "text", "content": "Cannot start server until port is free"})
+            else:
+                elements.append({"type": "text", "content": "**Status:** Not running"})
+                elements.append({"type": "text", "content": f"**Port:** {API_PORT} (available)"})
+                elements.append({"type": "text", "content": "Use `server('start')` to start the API server"})
+
+        # Available actions
+        elements.append({"type": "heading", "content": "Available Actions", "level": 3})
+        actions = [
+            "`server('start')` - Start the API server",
+            "`server('stop')` - Stop the API server",
+            "`server('restart')` - Restart the API server",
+            "`server('status')` or `server()` - Show this status",
+        ]
+        elements.append({"type": "list", "items": actions})
+
+    elif action == "start":
+        if owns_server:
+            elements.append({"type": "alert", "message": f"Server already running on port {API_PORT}", "level": "info"})
+        else:
+            success, message = _start_server(state)
+            if success:
+                elements.append({"type": "alert", "message": message, "level": "success"})
+                elements.append({"type": "text", "content": f"**URL:** http://127.0.0.1:{API_PORT}"})
+                elements.append({"type": "text", "content": f"**Health:** http://127.0.0.1:{API_PORT}/health"})
+                elements.append({"type": "text", "content": "Chrome extension can now connect"})
+            else:
+                elements.append({"type": "alert", "message": message, "level": "error"})
+
+    elif action == "stop":
+        if not owns_server:
+            elements.append({"type": "text", "content": "Server not running"})
+        else:
+            success, message = _stop_server(state)
+            if success:
+                elements.append({"type": "alert", "message": message, "level": "success"})
+            else:
+                elements.append({"type": "alert", "message": message, "level": "error"})
+
+    elif action == "restart":
+        if owns_server:
+            success, msg = _stop_server(state)
+            if not success:
+                elements.append({"type": "alert", "message": f"Failed to stop: {msg}", "level": "error"})
+                return {"elements": elements}
+            time.sleep(0.5)
+
+        success, msg = _start_server(state)
+        if success:
+            elements.append({"type": "alert", "message": "Server restarted", "level": "success"})
+            elements.append({"type": "text", "content": f"**Port:** {API_PORT}"})
+            elements.append({"type": "text", "content": f"**URL:** http://127.0.0.1:{API_PORT}"})
+        else:
+            elements.append({"type": "alert", "message": f"Failed to restart: {msg}", "level": "error"})
+
+    return {"elements": elements}
+
+
+__all__ = ["server"]

{webtap_tool-0.2.3.dist-info → webtap_tool-0.3.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: webtap-tool
-Version: 0.2.3
+Version: 0.3.0
 Summary: Terminal-based web page inspector for AI debugging sessions
 Author-email: Fredrik Angelsen <fredrikangelsen@gmail.com>
 Classifier: Development Status :: 3 - Alpha

{webtap_tool-0.2.3.dist-info → webtap_tool-0.3.0.dist-info}/RECORD

@@ -1,7 +1,7 @@
 webtap/VISION.md,sha256=kfoJfEPVc4chOrD9tNMDmYBY9rX9KB-286oZj70ALCE,7681
-webtap/__init__.py,sha256=6sTctXhLKByd8TnKJ99Y4o6xv7AbbPJ37S6YMNsQGBM,1970
-webtap/api.py,sha256=mfAqxQfu2lF91jiI6kHQnpmwtwq0Hh9UtuV8ApENXe0,8504
-webtap/app.py,sha256=M6-tCT6uvR5aMMYYUymYrXhq4PaUlHVYTv7MDN_svdQ,3246
+webtap/__init__.py,sha256=DFWJGmqZfX8_h4csLA5pKPR4SkaHBMlUgU-WQIE96Gw,1092
+webtap/api.py,sha256=QLfwO_21uSyxBCsqei45c5Uyg7OVfaVopmBncx9ZRfw,8018
+webtap/app.py,sha256=OC8-767GtQ_hAOxUNqD6Yu3JYLNB3ZXdzKn-A1S_RJI,3305
 webtap/filters.py,sha256=nphF2bFRbFtS2ue-CbV1uzKpuK3IYBbwjLeLhMDdLEk,11034
 webtap/cdp/README.md,sha256=0TS0V_dRgRAzBqhddpXWD4S0YVi5wI4JgFJSll_KUBE,5660
 webtap/cdp/__init__.py,sha256=c6NFG0XJnAa5GTe9MLr9mDZcLZqoTQN7A1cvvOfLcgY,453
@@ -28,6 +28,7 @@ webtap/commands/javascript.py,sha256=QpQdqqoQwwTyz1lpibZ92XKOL89scu_ndgSjkhaYuDk
 webtap/commands/launch.py,sha256=iZDLundKlxKRLKf3Vz5at42-tp2f-Uj5wZf7fbhBfA0,2202
 webtap/commands/navigation.py,sha256=Mapawp2AZTJQaws2uwlTgMUhqz7HlVTLxiZ06n_MQc0,6071
 webtap/commands/network.py,sha256=hwZshGGdVsJ_9MFjOKJXT07I990JjZInw2LLnKXLQ5Y,2910
+webtap/commands/server.py,sha256=LSs3l3Pb_vwmWRnYH-sA9JUPxBTQtRedjFQ4KvDaZK0,6032
 webtap/commands/setup.py,sha256=dov1LaN50nAEMNIuBLSK7mcnwhfn9rtqdTopBm1-PhA,9648
 webtap/services/README.md,sha256=rala_jtnNgSiQ1lFLM7x_UQ4SJZDceAm7dpkQMRTYaI,2346
 webtap/services/__init__.py,sha256=IjFqu0Ak6D-r18aokcQMtenDV3fbelvfjTCejGv6CZ0,570
@@ -42,7 +43,7 @@ webtap/services/setup/desktop.py,sha256=fXwQa201W-s2mengm_dJZ9BigJopVrO9YFUQcW_T
 webtap/services/setup/extension.py,sha256=OvTLuSi5u-kBAkqWAzfYt5lTNZrduXoCMZhFCuMisew,3318
 webtap/services/setup/filters.py,sha256=lAPSLMH_KZQO-7bRkmURwzforx7C3SDrKEw2ZogN-Lo,3220
 webtap/services/setup/platform.py,sha256=7yn-7LQFffgerWzWRtOG-yNEsR36ICThYUAu_N2FAso,4532
-webtap_tool-0.2.3.dist-info/METADATA,sha256=L0HI4R6Po66JFoxkNp7yo9RKLpj1vPKzxOYqF4o6ohI,17588
-webtap_tool-0.2.3.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-webtap_tool-0.2.3.dist-info/entry_points.txt,sha256=iFe575I0CIb1MbfPt0oX2VYyY5gSU_dA551PKVR83TU,39
-webtap_tool-0.2.3.dist-info/RECORD,,
+webtap_tool-0.3.0.dist-info/METADATA,sha256=jm3l2rpT1TBdGU8AU7NJYV7RgwpfzITuPyjh4Zb1_pk,17588
+webtap_tool-0.3.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+webtap_tool-0.3.0.dist-info/entry_points.txt,sha256=iFe575I0CIb1MbfPt0oX2VYyY5gSU_dA551PKVR83TU,39
+webtap_tool-0.3.0.dist-info/RECORD,,