cmdop 0.1.26__tar.gz → 0.1.28__tar.gz

{cmdop-0.1.26 → cmdop-0.1.28}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cmdop
-Version: 0.1.26
+Version: 0.1.28
 Summary: Python SDK for CMDOP agent interaction
 Project-URL: Homepage, https://cmdop.com
 Project-URL: Documentation, https://cmdop.com
@@ -19,6 +19,7 @@ Classifier: Programming Language :: Python :: 3.12
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Typing :: Typed
 Requires-Python: >=3.10
+Requires-Dist: beautifulsoup4>=4.14.3
 Requires-Dist: grpcio>=1.60.0
 Requires-Dist: httpx>=0.27.0
 Requires-Dist: protobuf>=4.25.0
@@ -290,14 +291,31 @@ client.terminal.close(session.session_id)
 ## Files
 
 ```python
+# Local IPC - session_id not required
 client.files.list("/var/log")
 client.files.read("/etc/nginx/nginx.conf")
 client.files.write("/tmp/config.json", b'{"key": "value"}')
-client.files.delete("/tmp/old.txt")
-client.files.copy("/src", "/dst")
-client.files.move("/old", "/new")
-client.files.mkdir("/new/dir")
-client.files.info("/path")
+
+# Remote - session_id required
+session = client.terminal.get_active_session()
+client.files.set_session_id(session.session_id)  # Set once
+client.files.list("/var/log")
+client.files.read("/etc/nginx/nginx.conf")
+
+# Or pass session_id directly to each call
+client.files.list("/var/log", session_id=session.session_id)
+```
+
+**Files methods:**
+```python
+client.files.list("/path", include_hidden=True)  # List directory
+client.files.read("/path/file.txt")              # Read file
+client.files.write("/path/file.txt", b"data")    # Write file
+client.files.delete("/path", recursive=True)     # Delete file/dir
+client.files.copy("/src", "/dst")                # Copy
+client.files.move("/old", "/new")                # Move/rename
+client.files.mkdir("/new/dir")                   # Create directory
+client.files.info("/path")                       # Get file info
 ```
 
 ## SDKBaseModel

{cmdop-0.1.26 → cmdop-0.1.28}/README.md

@@ -252,14 +252,31 @@ client.terminal.close(session.session_id)
 ## Files
 
 ```python
+# Local IPC - session_id not required
 client.files.list("/var/log")
 client.files.read("/etc/nginx/nginx.conf")
 client.files.write("/tmp/config.json", b'{"key": "value"}')
-client.files.delete("/tmp/old.txt")
-client.files.copy("/src", "/dst")
-client.files.move("/old", "/new")
-client.files.mkdir("/new/dir")
-client.files.info("/path")
+
+# Remote - session_id required
+session = client.terminal.get_active_session()
+client.files.set_session_id(session.session_id)  # Set once
+client.files.list("/var/log")
+client.files.read("/etc/nginx/nginx.conf")
+
+# Or pass session_id directly to each call
+client.files.list("/var/log", session_id=session.session_id)
+```
+
+**Files methods:**
+```python
+client.files.list("/path", include_hidden=True)  # List directory
+client.files.read("/path/file.txt")              # Read file
+client.files.write("/path/file.txt", b"data")    # Write file
+client.files.delete("/path", recursive=True)     # Delete file/dir
+client.files.copy("/src", "/dst")                # Copy
+client.files.move("/old", "/new")                # Move/rename
+client.files.mkdir("/new/dir")                   # Create directory
+client.files.info("/path")                       # Get file info
 ```
 
 ## SDKBaseModel

{cmdop-0.1.26 → cmdop-0.1.28}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "cmdop"
-version = "0.1.26"
+version = "0.1.28"
 description = "Python SDK for CMDOP agent interaction"
 readme = "README.md"
 license = { text = "MIT" }
@@ -32,6 +32,7 @@ dependencies = [
     "toon-python>=0.1.2",
     # Logging
     "rich>=13.0.0",
+    "beautifulsoup4>=4.14.3",
 ]
 
 [project.optional-dependencies]

{cmdop-0.1.26 → cmdop-0.1.28}/src/cmdop/__init__.py

@@ -128,7 +128,7 @@ from cmdop.logging import (
     get_log_dir,
 )
 
-__version__ = "0.1.26"
+__version__ = "0.1.28"
 
 __all__ = [
     # Version

{cmdop-0.1.26 → cmdop-0.1.28}/src/cmdop/services/files.py

@@ -53,14 +53,47 @@ class FilesService(BaseService):
     Provides file system operations.
 
     Example:
+        >>> # Local IPC - session_id is optional
         >>> entries = client.files.list("/home/user")
-        >>> content = client.files.read("/etc/hosts")
-        >>> client.files.write("/tmp/test.txt", b"Hello")
+        >>>
+        >>> # Remote - set session_id first
+        >>> session = client.terminal.get_active_session()
+        >>> client.files.set_session_id(session.session_id)
+        >>> entries = client.files.list("/home/user")
+        >>>
+        >>> # Or pass session_id directly
+        >>> entries = client.files.list("/home/user", session_id=session.session_id)
     """
 
     def __init__(self, transport: BaseTransport) -> None:
         super().__init__(transport)
         self._stub: Any = None
+        self._session_id: str | None = None
+
+    def set_session_id(self, session_id: str) -> None:
+        """
+        Set session ID for file operations.
+
+        Required for remote connections. For local IPC, session_id is optional.
+
+        Args:
+            session_id: Session ID from terminal.get_active_session() or terminal.create()
+
+        Example:
+            >>> session = client.terminal.get_active_session()
+            >>> client.files.set_session_id(session.session_id)
+            >>> files = client.files.list("/tmp")
+        """
+        self._session_id = session_id
+
+    def _get_session_id(self, session_id: str | None = None) -> str:
+        """Get session ID from parameter or stored value."""
+        sid = session_id or self._session_id
+        if not sid:
+            # For local IPC, use empty string (server will handle)
+            # For remote, this will likely fail but let server return proper error
+            return ""
+        return sid
 
     @property
     def _get_stub(self) -> Any:
@@ -79,6 +112,7 @@ class FilesService(BaseService):
         include_hidden: bool = False,
         page_size: int = 100,
         page_token: str | None = None,
+        session_id: str | None = None,
     ) -> ListDirectoryResponse:
         """
         List directory contents.
@@ -88,6 +122,7 @@ class FilesService(BaseService):
             include_hidden: Include hidden files
             page_size: Number of entries per page
             page_token: Pagination token
+            session_id: Session ID (uses stored value if not provided)
 
         Returns:
             Directory listing response
@@ -97,6 +132,7 @@ class FilesService(BaseService):
         )
 
         request = FileListDirectoryRpcRequest(
+            session_id=self._get_session_id(session_id),
             path=path,
             page_size=page_size,
             include_hidden=include_hidden,
@@ -131,6 +167,7 @@ class FilesService(BaseService):
         path: str,
         offset: int = 0,
         limit: int = 0,
+        session_id: str | None = None,
     ) -> bytes:
         """
         Read file contents.
@@ -139,6 +176,7 @@ class FilesService(BaseService):
             path: File path to read
             offset: Byte offset to start reading
             limit: Maximum bytes to read (0 = entire file)
+            session_id: Session ID (uses stored value if not provided)
 
         Returns:
             File contents as bytes
@@ -146,6 +184,7 @@ class FilesService(BaseService):
         from cmdop._generated.file_rpc.file_crud_pb2 import FileReadRpcRequest
 
         request = FileReadRpcRequest(
+            session_id=self._get_session_id(session_id),
             path=path,
         )
 
@@ -158,6 +197,7 @@ class FilesService(BaseService):
         content: bytes | str,
         create_parents: bool = False,
         overwrite: bool = True,
+        session_id: str | None = None,
     ) -> None:
         """
         Write file contents.
@@ -167,6 +207,7 @@ class FilesService(BaseService):
             content: Content to write (bytes or string)
             create_parents: Create parent directories
             overwrite: Overwrite existing file
+            session_id: Session ID (uses stored value if not provided)
         """
         from cmdop._generated.file_rpc.file_crud_pb2 import FileWriteRpcRequest
 
@@ -174,6 +215,7 @@ class FilesService(BaseService):
             content = content.encode("utf-8")
 
         request = FileWriteRpcRequest(
+            session_id=self._get_session_id(session_id),
             path=path,
             content=content,
             create_parents=create_parents,
@@ -181,70 +223,95 @@ class FilesService(BaseService):
 
         self._call_sync(self._get_stub.FileWrite, request)
 
-    def delete(self, path: str, recursive: bool = False) -> None:
+    def delete(
+        self,
+        path: str,
+        recursive: bool = False,
+        session_id: str | None = None,
+    ) -> None:
         """
         Delete file or directory.
 
         Args:
             path: Path to delete
             recursive: Delete directory recursively
+            session_id: Session ID (uses stored value if not provided)
         """
         from cmdop._generated.file_rpc.file_crud_pb2 import FileDeleteRpcRequest
 
         request = FileDeleteRpcRequest(
+            session_id=self._get_session_id(session_id),
             path=path,
             recursive=recursive,
         )
 
         self._call_sync(self._get_stub.FileDelete, request)
 
-    def copy(self, source: str, destination: str) -> None:
+    def copy(
+        self,
+        source: str,
+        destination: str,
+        session_id: str | None = None,
+    ) -> None:
         """
         Copy file or directory.
 
         Args:
             source: Source path
             destination: Destination path
+            session_id: Session ID (uses stored value if not provided)
         """
         from cmdop._generated.file_rpc.file_crud_pb2 import FileCopyRpcRequest
 
         request = FileCopyRpcRequest(
+            session_id=self._get_session_id(session_id),
             source_path=source,
             destination_path=destination,
         )
 
         self._call_sync(self._get_stub.FileCopy, request)
 
-    def move(self, source: str, destination: str) -> None:
+    def move(
+        self,
+        source: str,
+        destination: str,
+        session_id: str | None = None,
+    ) -> None:
         """
         Move/rename file or directory.
 
         Args:
             source: Source path
             destination: Destination path
+            session_id: Session ID (uses stored value if not provided)
         """
         from cmdop._generated.file_rpc.file_crud_pb2 import FileMoveRpcRequest
 
         request = FileMoveRpcRequest(
+            session_id=self._get_session_id(session_id),
             source_path=source,
             destination_path=destination,
         )
 
         self._call_sync(self._get_stub.FileMove, request)
 
-    def info(self, path: str) -> FileInfo:
+    def info(self, path: str, session_id: str | None = None) -> FileInfo:
         """
         Get file information.
 
         Args:
             path: File path
+            session_id: Session ID (uses stored value if not provided)
 
         Returns:
             Detailed file information
         """
         from cmdop._generated.file_rpc.file_crud_pb2 import FileGetInfoRpcRequest
 
-        request = FileGetInfoRpcRequest(path=path)
+        request = FileGetInfoRpcRequest(
+            session_id=self._get_session_id(session_id),
+            path=path,
+        )
         response = self._call_sync(self._get_stub.FileGetInfo, request)
 
         entry = response.result.entry
@@ -256,19 +323,26 @@ class FilesService(BaseService):
             permissions=entry.permissions if hasattr(entry, "permissions") else None,
         )
 
-    def mkdir(self, path: str, create_parents: bool = True) -> None:
+    def mkdir(
+        self,
+        path: str,
+        create_parents: bool = True,
+        session_id: str | None = None,
+    ) -> None:
         """
         Create directory.
 
         Args:
             path: Directory path to create
             create_parents: Create parent directories
+            session_id: Session ID (uses stored value if not provided)
         """
         from cmdop._generated.file_rpc.file_crud_pb2 import (
             FileCreateDirectoryRpcRequest,
         )
 
         request = FileCreateDirectoryRpcRequest(
+            session_id=self._get_session_id(session_id),
             path=path,
             create_parents=create_parents,
         )
@@ -281,11 +355,36 @@ class AsyncFilesService(BaseService):
     Asynchronous files service.
 
     Provides async file system operations.
+
+    Example:
+        >>> # Remote - set session_id first
+        >>> session = await client.terminal.get_active_session()
+        >>> client.files.set_session_id(session.session_id)
+        >>> entries = await client.files.list("/home/user")
     """
 
     def __init__(self, transport: BaseTransport) -> None:
         super().__init__(transport)
         self._stub: Any = None
+        self._session_id: str | None = None
+
+    def set_session_id(self, session_id: str) -> None:
+        """
+        Set session ID for file operations.
+
+        Required for remote connections. For local IPC, session_id is optional.
+
+        Args:
+            session_id: Session ID from terminal.get_active_session() or terminal.create()
+        """
+        self._session_id = session_id
+
+    def _get_session_id(self, session_id: str | None = None) -> str:
+        """Get session ID from parameter or stored value."""
+        sid = session_id or self._session_id
+        if not sid:
+            return ""
+        return sid
 
     @property
     def _get_stub(self) -> Any:
@@ -304,6 +403,7 @@ class AsyncFilesService(BaseService):
         include_hidden: bool = False,
         page_size: int = 100,
         page_token: str | None = None,
+        session_id: str | None = None,
     ) -> ListDirectoryResponse:
         """List directory contents."""
         from cmdop._generated.file_rpc.directory_pb2 import (
@@ -311,6 +411,7 @@ class AsyncFilesService(BaseService):
         )
 
         request = FileListDirectoryRpcRequest(
+            session_id=self._get_session_id(session_id),
             path=path,
             page_size=page_size,
             include_hidden=include_hidden,
@@ -340,11 +441,20 @@ class AsyncFilesService(BaseService):
             total_count=response.result.total_count,
         )
 
-    async def read(self, path: str, offset: int = 0, limit: int = 0) -> bytes:
+    async def read(
+        self,
+        path: str,
+        offset: int = 0,
+        limit: int = 0,
+        session_id: str | None = None,
+    ) -> bytes:
         """Read file contents."""
         from cmdop._generated.file_rpc.file_crud_pb2 import FileReadRpcRequest
 
-        request = FileReadRpcRequest(path=path)
+        request = FileReadRpcRequest(
+            session_id=self._get_session_id(session_id),
+            path=path,
+        )
         response = await self._call_async(self._get_stub.FileRead, request)
         return response.result.content
 
@@ -354,6 +464,7 @@ class AsyncFilesService(BaseService):
         content: bytes | str,
         create_parents: bool = False,
         overwrite: bool = True,
+        session_id: str | None = None,
     ) -> None:
         """Write file contents."""
         from cmdop._generated.file_rpc.file_crud_pb2 import FileWriteRpcRequest
@@ -362,44 +473,69 @@ class AsyncFilesService(BaseService):
             content = content.encode("utf-8")
 
         request = FileWriteRpcRequest(
+            session_id=self._get_session_id(session_id),
             path=path,
             content=content,
             create_parents=create_parents,
         )
         await self._call_async(self._get_stub.FileWrite, request)
 
-    async def delete(self, path: str, recursive: bool = False) -> None:
+    async def delete(
+        self,
+        path: str,
+        recursive: bool = False,
+        session_id: str | None = None,
+    ) -> None:
         """Delete file or directory."""
         from cmdop._generated.file_rpc.file_crud_pb2 import FileDeleteRpcRequest
 
-        request = FileDeleteRpcRequest(path=path, recursive=recursive)
+        request = FileDeleteRpcRequest(
+            session_id=self._get_session_id(session_id),
+            path=path,
+            recursive=recursive,
+        )
         await self._call_async(self._get_stub.FileDelete, request)
 
-    async def copy(self, source: str, destination: str) -> None:
+    async def copy(
+        self,
+        source: str,
+        destination: str,
+        session_id: str | None = None,
+    ) -> None:
         """Copy file or directory."""
         from cmdop._generated.file_rpc.file_crud_pb2 import FileCopyRpcRequest
 
         request = FileCopyRpcRequest(
+            session_id=self._get_session_id(session_id),
             source_path=source,
             destination_path=destination,
         )
         await self._call_async(self._get_stub.FileCopy, request)
 
-    async def move(self, source: str, destination: str) -> None:
+    async def move(
+        self,
+        source: str,
+        destination: str,
+        session_id: str | None = None,
+    ) -> None:
         """Move/rename file or directory."""
         from cmdop._generated.file_rpc.file_crud_pb2 import FileMoveRpcRequest
 
         request = FileMoveRpcRequest(
+            session_id=self._get_session_id(session_id),
             source_path=source,
             destination_path=destination,
         )
         await self._call_async(self._get_stub.FileMove, request)
 
-    async def info(self, path: str) -> FileInfo:
+    async def info(self, path: str, session_id: str | None = None) -> FileInfo:
         """Get file information."""
         from cmdop._generated.file_rpc.file_crud_pb2 import FileGetInfoRpcRequest
 
-        request = FileGetInfoRpcRequest(path=path)
+        request = FileGetInfoRpcRequest(
+            session_id=self._get_session_id(session_id),
+            path=path,
+        )
         response = await self._call_async(self._get_stub.FileGetInfo, request)
 
         entry = response.result.entry
@@ -410,13 +546,19 @@ class AsyncFilesService(BaseService):
             modified_at=_parse_timestamp(entry.modified_at),
         )
 
-    async def mkdir(self, path: str, create_parents: bool = True) -> None:
+    async def mkdir(
+        self,
+        path: str,
+        create_parents: bool = True,
+        session_id: str | None = None,
+    ) -> None:
         """Create directory."""
         from cmdop._generated.file_rpc.file_crud_pb2 import (
             FileCreateDirectoryRpcRequest,
         )
 
         request = FileCreateDirectoryRpcRequest(
+            session_id=self._get_session_id(session_id),
             path=path,
             create_parents=create_parents,
         )