portacode 0.3.1.dev0__tar.gz → 0.3.3.dev0__tar.gz

{portacode-0.3.1.dev0 → portacode-0.3.3.dev0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: portacode
-Version: 0.3.1.dev0
+Version: 0.3.3.dev0
 Summary: Portacode CLI client and SDK
 Home-page: https://github.com/portacode/portacode
 Author: Meena Erian
@@ -80,8 +80,11 @@ portacode connect
 
 ### Server Administration
 ```bash
-# Install as a service for persistent connection
-portacode service install
+# For a persistent connection, install system-wide first
+sudo pip install portacode --system
+
+# Then install as a service
+sudo portacode service install
 
 # Your server is now accessible 24/7 from the web dashboard
 ```
@@ -112,23 +115,29 @@ portacode connect
 # Run connection in background
 portacode connect --detach
 
+# Check version
+portacode --version
+
 # Get help
 portacode --help
 ```
 
 ### Service Management
 ```bash
+# For system services, install package system-wide first
+sudo pip install portacode --system
+
 # Install persistent service (auto-start on boot)
-portacode service install
+sudo portacode service install
 
 # Check service status
-portacode service status
+sudo portacode service status
 
 # Stop the service
-portacode service stop
+sudo portacode service stop
 
 # Remove the service
-portacode service uninstall
+sudo portacode service uninstall
 ```
 
 ## 🌐 Web Dashboard
@@ -164,7 +173,16 @@ Access your connected devices at [https://remote.portacode.com](https://remote.p
 portacode connect
 
 # View service logs
-portacode service status --verbose
+sudo portacode service status --verbose
+```
+
+### Service Installation Issues
+```bash
+# If service commands fail, ensure system-wide installation
+sudo pip install portacode --system
+
+# Then try service installation again
+sudo portacode service install
 ```
 
 ### Clipboard Issues (Linux)

{portacode-0.3.1.dev0 → portacode-0.3.3.dev0}/README.md

@@ -55,8 +55,11 @@ portacode connect
 
 ### Server Administration
 ```bash
-# Install as a service for persistent connection
-portacode service install
+# For a persistent connection, install system-wide first
+sudo pip install portacode --system
+
+# Then install as a service
+sudo portacode service install
 
 # Your server is now accessible 24/7 from the web dashboard
 ```
@@ -87,23 +90,29 @@ portacode connect
 # Run connection in background
 portacode connect --detach
 
+# Check version
+portacode --version
+
 # Get help
 portacode --help
 ```
 
 ### Service Management
 ```bash
+# For system services, install package system-wide first
+sudo pip install portacode --system
+
 # Install persistent service (auto-start on boot)
-portacode service install
+sudo portacode service install
 
 # Check service status
-portacode service status
+sudo portacode service status
 
 # Stop the service
-portacode service stop
+sudo portacode service stop
 
 # Remove the service
-portacode service uninstall
+sudo portacode service uninstall
 ```
 
 ## 🌐 Web Dashboard
@@ -139,7 +148,16 @@ Access your connected devices at [https://remote.portacode.com](https://remote.p
 portacode connect
 
 # View service logs
-portacode service status --verbose
+sudo portacode service status --verbose
+```
+
+### Service Installation Issues
+```bash
+# If service commands fail, ensure system-wide installation
+sudo pip install portacode --system
+
+# Then try service installation again
+sudo portacode service install
 ```
 
 ### Clipboard Issues (Linux)

{portacode-0.3.1.dev0 → portacode-0.3.3.dev0}/portacode/_version.py

@@ -17,5 +17,5 @@ __version__: str
 __version_tuple__: VERSION_TUPLE
 version_tuple: VERSION_TUPLE
 
-__version__ = version = '0.3.1.dev'
-__version_tuple__ = version_tuple = (0, 3, 1, 'dev0')
+__version__ = version = '0.3.3.dev'
+__version_tuple__ = version_tuple = (0, 3, 3, 'dev0')

{portacode-0.3.1.dev0 → portacode-0.3.3.dev0}/portacode/cli.py

@@ -11,6 +11,7 @@ import json
 import click
 import pyperclip
 
+from . import __version__
 from .data import get_pid_file, is_process_running
 from .keypair import get_or_create_keypair, fingerprint_public_key
 from .connection.client import ConnectionManager, run_until_interrupt
@@ -20,6 +21,7 @@ GATEWAY_ENV = "PORTACODE_GATEWAY"
 
 
 @click.group()
+@click.version_option(__version__, "-v", "--version", message="Portacode %(version)s")
 def cli() -> None:
     """Portacode command-line interface."""
 
@@ -289,6 +291,7 @@ def service_install() -> None:  # noqa: D401
     click.echo(f"Installing Portacode system service…")
     if os.geteuid() != 0:
         click.echo(click.style("[sudo] You may be prompted for your password to install the system service.", fg="yellow"))
+        click.echo(click.style("💡 For persistent connection, install system-wide: sudo pip install portacode --system", fg="bright_black"))
     try:
         mgr.install()
         st = mgr.status()
@@ -300,6 +303,8 @@ def service_install() -> None:  # noqa: D401
                 click.echo(f"Inspect log: {mgr.log_path}")
     except Exception as exc:
         click.echo(click.style(f"Failed: {exc}", fg="red"))
+        if "No module named" in str(exc) or "command not found" in str(exc):
+            click.echo(click.style("💡 Try installing system-wide: sudo pip install portacode --system", fg="bright_cyan"))
 
 
 @service.command("uninstall")

{portacode-0.3.1.dev0 → portacode-0.3.3.dev0}/portacode/connection/handlers/session.py

@@ -10,6 +10,14 @@ from pathlib import Path
 from typing import Any, Dict, Optional, List, TYPE_CHECKING
 from collections import deque
 
+# Terminal control imports (only available on Unix)
+try:
+    import termios
+    import tty
+    _HAS_TERMIOS = True
+except ImportError:
+    _HAS_TERMIOS = False
+
 if TYPE_CHECKING:
     from ..multiplex import Channel
 
@@ -21,6 +29,15 @@ _IS_WINDOWS = sys.platform.startswith("win")
 _DEFAULT_ENV = {
     "TERM": "xterm-256color",
     "LANG": "C.UTF-8",
+    # Add additional terminal environment variables for better compatibility
+    "COLUMNS": "80",
+    "LINES": "24",
+    "PS1": r'\u@\h:\w\$ ',  # Standard bash prompt
+    "HISTSIZE": "1000",
+    "HISTFILESIZE": "2000",
+    # Ensure proper terminal behavior
+    "DEBIAN_FRONTEND": "noninteractive",  # Prevent interactive prompts
+    "TERM_PROGRAM": "portacode",
 }
 
 
@@ -29,6 +46,12 @@ def _build_child_env() -> Dict[str, str]:
     env = os.environ.copy()
     for k, v in _DEFAULT_ENV.items():
         env.setdefault(k, v)
+    
+    # Ensure SSH_TTY is not set when using pipes to avoid shell confusion
+    if "SSH_TTY" in env:
+        logger.debug("Removing SSH_TTY from environment to prevent shell confusion")
+        del env["SSH_TTY"]
+    
     return env
 
 
@@ -190,9 +213,21 @@ class SessionManager:
         channel_id = self._allocate_channel_id()
         channel = self.mux.get_channel(channel_id)
 
-        # Choose shell
+        # Choose shell - prefer bash over sh for better compatibility
         if shell is None:
-            shell = os.getenv("SHELL") if not _IS_WINDOWS else os.getenv("COMSPEC", "cmd.exe")
+            if not _IS_WINDOWS:
+                # Try to use bash if available, fallback to default shell
+                shell = os.getenv("SHELL")
+                if shell is None or shell == "/bin/sh":
+                    # Try to find bash
+                    for bash_path in ["/bin/bash", "/usr/bin/bash", "/usr/local/bin/bash"]:
+                        if os.path.exists(bash_path):
+                            shell = bash_path
+                            break
+                    else:
+                        shell = "/bin/sh"
+            else:
+                shell = os.getenv("COMSPEC", "cmd.exe")
 
         logger.info("Launching terminal %s using shell=%s on channel=%s", term_id, shell, channel_id)
 
@@ -207,9 +242,30 @@ class SessionManager:
             session = WindowsTerminalSession(term_id, pty_proc, channel)
         else:
             # Unix: try real PTY for proper TTY semantics
+            pty_success = False
             try:
                 import pty
+                
+                logger.debug("Attempting to allocate PTY for terminal %s", term_id)
                 master_fd, slave_fd = pty.openpty()
+                
+                # Set terminal attributes for better compatibility
+                if _HAS_TERMIOS:
+                    try:
+                        # Get current terminal settings
+                        attrs = termios.tcgetattr(slave_fd)
+                        # Enable canonical mode and echo
+                        attrs[3] |= termios.ICANON | termios.ECHO | termios.ECHOE | termios.ECHOK
+                        # Set input and output modes
+                        attrs[0] |= termios.ICRNL  # Map CR to NL on input
+                        attrs[1] |= termios.OPOST | termios.ONLCR  # Map NL to CR-NL on output
+                        termios.tcsetattr(slave_fd, termios.TCSANOW, attrs)
+                        logger.debug("Successfully configured terminal attributes")
+                    except Exception as e:
+                        logger.warning("Failed to configure terminal attributes: %s", e)
+                else:
+                    logger.debug("termios not available, skipping terminal attribute configuration")
+                
                 proc = await asyncio.create_subprocess_exec(
                     shell,
                     stdin=slave_fd,
@@ -219,6 +275,10 @@ class SessionManager:
                     cwd=cwd,
                     env=_build_child_env(),
                 )
+                
+                # Close slave_fd in parent process
+                os.close(slave_fd)
+                
                 # Wrap master_fd into a StreamReader
                 loop = asyncio.get_running_loop()
                 reader = asyncio.StreamReader()
@@ -230,16 +290,49 @@ class SessionManager:
                     lambda: asyncio.Protocol(), os.fdopen(master_fd, "wb", buffering=0)
                 )
                 proc.stdin = asyncio.StreamWriter(writer_transport, writer_protocol, reader, loop)
-            except Exception:
-                logger.warning("Failed to allocate PTY, falling back to pipes")
+                
+                pty_success = True
+                logger.info("Successfully allocated PTY for terminal %s", term_id)
+                
+            except Exception as e:
+                logger.warning("Failed to allocate PTY for terminal %s: %s", term_id, e)
+                
+                # Enhanced fallback with proper shell invocation
+                logger.info("Using enhanced pipe fallback for terminal %s", term_id)
+                
+                # Create enhanced environment for pipe mode
+                pipe_env = _build_child_env()
+                pipe_env["TERM"] = "dumb"  # Use dumb terminal for pipes
+                pipe_env["PS1"] = "$ "  # Simple prompt for pipes
+                
+                # Use shell with explicit interactive and login flags
+                shell_args = [shell]
+                if shell.endswith("bash"):
+                    shell_args.extend(["-i", "-l"])  # Interactive and login shell
+                elif shell.endswith("sh"):
+                    shell_args.extend(["-i"])  # Interactive shell
+                
                 proc = await asyncio.create_subprocess_exec(
-                    shell,
+                    *shell_args,
                     stdin=asyncio.subprocess.PIPE,
                     stdout=asyncio.subprocess.PIPE,
                     stderr=asyncio.subprocess.STDOUT,
                     cwd=cwd,
-                    env=_build_child_env(),
+                    env=pipe_env,
                 )
+                
+                # Send initial command to set up better terminal behavior
+                if proc.stdin:
+                    initial_setup = (
+                        "stty -echo 2>/dev/null || true\n"  # Disable echo to prevent double output
+                        "set +o posix 2>/dev/null || true\n"  # Disable POSIX mode if possible
+                        "PS1='$ '\n"  # Set simple prompt
+                        "export PS1\n"
+                        "clear 2>/dev/null || echo 'Terminal ready'\n"
+                    )
+                    proc.stdin.write(initial_setup.encode())
+                    await proc.stdin.drain()
+                
             session = TerminalSession(term_id, proc, channel)
 
         self._sessions[term_id] = session
@@ -251,6 +344,7 @@ class SessionManager:
             "pid": session.proc.pid,
             "shell": shell,
             "cwd": cwd,
+            "pty_mode": pty_success if not _IS_WINDOWS else True,
         }
 
     def get_session(self, terminal_id: str) -> Optional[TerminalSession]:

portacode-0.3.3.dev0/portacode/connection/handlers/system_handlers.py

@@ -0,0 +1,132 @@
+"""System command handlers."""
+
+import logging
+import os
+import platform
+from pathlib import Path
+from typing import Any, Dict
+
+import psutil
+
+from .base import SyncHandler
+
+logger = logging.getLogger(__name__)
+
+
+def _get_os_info() -> Dict[str, Any]:
+    """Get operating system information with robust error handling."""
+    try:
+        system = platform.system()
+        logger.debug("Detected system: %s", system)
+        
+        if system == "Linux":
+            os_type = "Linux"
+            default_shell = os.environ.get('SHELL', '/bin/bash')
+            default_cwd = os.path.expanduser('~')
+            
+            # Try to get more specific Linux distribution info
+            try:
+                import distro
+                os_version = f"{distro.name()} {distro.version()}"
+                logger.debug("Using distro package for OS version: %s", os_version)
+            except ImportError:
+                logger.debug("distro package not available, trying /etc/os-release")
+                # Fallback to basic platform info
+                try:
+                    with open('/etc/os-release', 'r') as f:
+                        for line in f:
+                            if line.startswith('PRETTY_NAME='):
+                                os_version = line.split('=')[1].strip().strip('"')
+                                logger.debug("Found OS version from /etc/os-release: %s", os_version)
+                                break
+                        else:
+                            os_version = f"{system} {platform.release()}"
+                            logger.debug("Using platform.release() for OS version: %s", os_version)
+                except FileNotFoundError:
+                    os_version = f"{system} {platform.release()}"
+                    logger.debug("Using platform.release() fallback for OS version: %s", os_version)
+                    
+        elif system == "Darwin":  # macOS
+            os_type = "macOS"
+            os_version = f"macOS {platform.mac_ver()[0]}"
+            default_shell = os.environ.get('SHELL', '/bin/bash')
+            default_cwd = os.path.expanduser('~')
+            
+        elif system == "Windows":
+            os_type = "Windows"
+            os_version = f"{platform.system()} {platform.release()}"
+            default_shell = os.environ.get('COMSPEC', 'cmd.exe')
+            default_cwd = os.path.expanduser('~')
+            
+        else:
+            os_type = system
+            os_version = f"{system} {platform.release()}"
+            default_shell = "/bin/sh"  # Safe fallback
+            default_cwd = os.path.expanduser('~')
+        
+        result = {
+            "os_type": os_type,
+            "os_version": os_version,
+            "architecture": platform.machine(),
+            "default_shell": default_shell,
+            "default_cwd": default_cwd,
+        }
+        
+        logger.debug("Successfully collected OS info: %s", result)
+        return result
+        
+    except Exception as e:
+        logger.error("Failed to collect OS info: %s", e, exc_info=True)
+        # Return minimal fallback info instead of failing completely
+        return {
+            "os_type": "Unknown",
+            "os_version": "Unknown",
+            "architecture": platform.machine() if hasattr(platform, 'machine') else "Unknown",
+            "default_shell": "/bin/bash",  # Safe fallback
+            "default_cwd": os.path.expanduser('~') if hasattr(os.path, 'expanduser') else "",
+        }
+
+
+class SystemInfoHandler(SyncHandler):
+    """Handler for getting system information."""
+    
+    @property
+    def command_name(self) -> str:
+        return "system_info"
+    
+    def execute(self, message: Dict[str, Any]) -> Dict[str, Any]:
+        """Get system information including OS details."""
+        logger.debug("Collecting system information...")
+        
+        # Collect basic system metrics
+        info = {}
+        
+        try:
+            info["cpu_percent"] = psutil.cpu_percent(interval=0.1)
+            logger.debug("CPU usage: %s%%", info["cpu_percent"])
+        except Exception as e:
+            logger.warning("Failed to get CPU info: %s", e)
+            info["cpu_percent"] = 0.0
+            
+        try:
+            info["memory"] = psutil.virtual_memory()._asdict()
+            logger.debug("Memory usage: %s%%", info["memory"].get("percent", "N/A"))
+        except Exception as e:
+            logger.warning("Failed to get memory info: %s", e)
+            info["memory"] = {"percent": 0.0}
+            
+        try:
+            info["disk"] = psutil.disk_usage(str(Path.home()))._asdict()
+            logger.debug("Disk usage: %s%%", info["disk"].get("percent", "N/A"))
+        except Exception as e:
+            logger.warning("Failed to get disk info: %s", e)
+            info["disk"] = {"percent": 0.0}
+        
+        # Add OS information - this is critical for proper shell detection
+        info["os_info"] = _get_os_info()
+        logger.info("System info collected successfully with OS info: %s", info.get("os_info", {}).get("os_type", "Unknown"))
+        
+        return {
+            "event": "system_info",
+            "info": info,
+        } 

{portacode-0.3.1.dev0 → portacode-0.3.3.dev0}/portacode.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: portacode
-Version: 0.3.1.dev0
+Version: 0.3.3.dev0
 Summary: Portacode CLI client and SDK
 Home-page: https://github.com/portacode/portacode
 Author: Meena Erian
@@ -80,8 +80,11 @@ portacode connect
 
 ### Server Administration
 ```bash
-# Install as a service for persistent connection
-portacode service install
+# For a persistent connection, install system-wide first
+sudo pip install portacode --system
+
+# Then install as a service
+sudo portacode service install
 
 # Your server is now accessible 24/7 from the web dashboard
 ```
@@ -112,23 +115,29 @@ portacode connect
 # Run connection in background
 portacode connect --detach
 
+# Check version
+portacode --version
+
 # Get help
 portacode --help
 ```
 
 ### Service Management
 ```bash
+# For system services, install package system-wide first
+sudo pip install portacode --system
+
 # Install persistent service (auto-start on boot)
-portacode service install
+sudo portacode service install
 
 # Check service status
-portacode service status
+sudo portacode service status
 
 # Stop the service
-portacode service stop
+sudo portacode service stop
 
 # Remove the service
-portacode service uninstall
+sudo portacode service uninstall
 ```
 
 ## 🌐 Web Dashboard
@@ -164,7 +173,16 @@ Access your connected devices at [https://remote.portacode.com](https://remote.p
 portacode connect
 
 # View service logs
-portacode service status --verbose
+sudo portacode service status --verbose
+```
+
+### Service Installation Issues
+```bash
+# If service commands fail, ensure system-wide installation
+sudo pip install portacode --system
+
+# Then try service installation again
+sudo portacode service install
 ```
 
 ### Clipboard Issues (Linux)

portacode-0.3.1.dev0/portacode/connection/handlers/system_handlers.py

@@ -1,32 +0,0 @@
-"""System command handlers."""
-
-import logging
-from pathlib import Path
-from typing import Any, Dict
-
-import psutil
-
-from .base import SyncHandler
-
-logger = logging.getLogger(__name__)
-
-
-class SystemInfoHandler(SyncHandler):
-    """Handler for getting system information."""
-    
-    @property
-    def command_name(self) -> str:
-        return "system_info"
-    
-    def execute(self, message: Dict[str, Any]) -> Dict[str, Any]:
-        """Get system information."""
-        info = {
-            "cpu_percent": psutil.cpu_percent(interval=0.1),
-            "memory": psutil.virtual_memory()._asdict(),
-            "disk": psutil.disk_usage(str(Path.home()))._asdict(),
-        }
-        
-        return {
-            "event": "system_info",
-            "info": info,
-        }