cua-computer 0.2.13__tar.gz → 0.3.1__tar.gz

{cua_computer-0.2.13 → cua_computer-0.3.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: cua-computer
-Version: 0.2.13
+Version: 0.3.1
 Summary: Computer-Use Interface (CUI) framework powering Cua
 Author-Email: TryCua <gh@trycua.com>
 Requires-Python: >=3.11
@@ -13,13 +13,13 @@ Requires-Dist: pydantic>=2.11.1
 Provides-Extra: lume
 Provides-Extra: lumier
 Provides-Extra: ui
-Requires-Dist: gradio<6.0.0,>=5.23.3; extra == "ui"
-Requires-Dist: python-dotenv<2.0.0,>=1.0.1; extra == "ui"
-Requires-Dist: datasets<4.0.0,>=3.6.0; extra == "ui"
+Requires-Dist: gradio>=5.23.3; extra == "ui"
+Requires-Dist: python-dotenv>=1.0.1; extra == "ui"
+Requires-Dist: datasets>=3.6.0; extra == "ui"
 Provides-Extra: all
-Requires-Dist: gradio<6.0.0,>=5.23.3; extra == "all"
-Requires-Dist: python-dotenv<2.0.0,>=1.0.1; extra == "all"
-Requires-Dist: datasets<4.0.0,>=3.6.0; extra == "all"
+Requires-Dist: gradio>=5.23.3; extra == "all"
+Requires-Dist: python-dotenv>=1.0.1; extra == "all"
+Requires-Dist: datasets>=3.6.0; extra == "all"
 Description-Content-Type: text/markdown
 
 <div align="center">

{cua_computer-0.2.13 → cua_computer-0.3.1}/computer/interface/base.py

@@ -3,8 +3,7 @@
 from abc import ABC, abstractmethod
 from typing import Optional, Dict, Any, Tuple, List
 from ..logger import Logger, LogLevel
-from .models import MouseButton
-
+from .models import MouseButton, CommandResult
 
 class BaseComputerInterface(ABC):
     """Base class for computer control interfaces."""
@@ -209,8 +208,14 @@ class BaseComputerInterface(ABC):
         pass
     
     @abstractmethod
-    async def read_bytes(self, path: str) -> bytes:
-        """Read file binary contents."""
+    async def read_bytes(self, path: str, offset: int = 0, length: Optional[int] = None) -> bytes:
+        """Read file binary contents with optional seeking support.
+        
+        Args:
+            path: Path to the file
+            offset: Byte offset to start reading from (default: 0)
+            length: Number of bytes to read (default: None for entire file)
+        """
         pass
     
     @abstractmethod
@@ -234,8 +239,36 @@ class BaseComputerInterface(ABC):
         pass
     
     @abstractmethod
-    async def run_command(self, command: str) -> Tuple[str, str]:
-        """Run shell command."""
+    async def get_file_size(self, path: str) -> int:
+        """Get the size of a file in bytes."""
+        pass
+    
+    @abstractmethod
+    async def run_command(self, command: str) -> CommandResult:
+        """Run shell command and return structured result.
+        
+        Executes a shell command using subprocess.run with shell=True and check=False.
+        The command is run in the target environment and captures both stdout and stderr.
+        
+        Args:
+            command (str): The shell command to execute
+            
+        Returns:
+            CommandResult: A structured result containing:
+                - stdout (str): Standard output from the command
+                - stderr (str): Standard error from the command  
+                - returncode (int): Exit code from the command (0 indicates success)
+                
+        Raises:
+            RuntimeError: If the command execution fails at the system level
+            
+        Example:
+            result = await interface.run_command("ls -la")
+            if result.returncode == 0:
+                print(f"Output: {result.stdout}")
+            else:
+                print(f"Error: {result.stderr}, Exit code: {result.returncode}")
+        """
         pass
 
     # Accessibility Actions