openshell-shared 0.1.2__py3-none-any.whl

modules/shell/session.py

@@ -0,0 +1,339 @@
+# shell/session.py
+
+# =====================================================
+# LIBRARY IMPORTS
+# =====================================================
+
+import os
+import pty
+import fcntl
+import signal
+import struct
+import termios
+import asyncio
+import subprocess
+
+
+# =====================================================
+# SHELL SESSION
+# =====================================================
+
+class ShellSession:
+
+    def __init__(
+        self,
+        session_token: str
+    ):
+
+        self.session_token = (
+            session_token
+        )
+
+        self.process = None
+
+        self.master_fd = None
+        self.slave_fd = None
+
+        self._lock = asyncio.Lock()
+
+    # =================================================
+    # START
+    # =================================================
+
+    async def start(self):
+
+        if self.process is not None:
+            return
+
+        self.master_fd, self.slave_fd = (
+            pty.openpty()
+        )
+
+        self.process = subprocess.Popen(
+            [
+                "/bin/bash",
+                "-i"
+            ],
+            stdin=self.slave_fd,
+            stdout=self.slave_fd,
+            stderr=self.slave_fd,
+            start_new_session=True,
+            close_fds=True
+        )
+
+        os.set_blocking(
+            self.master_fd,
+            False
+        )
+
+    # =================================================
+    # WRITE
+    # =================================================
+
+    async def write(
+        self,
+        data: str
+    ):
+
+        async with self._lock:
+
+            if self.process is None:
+
+                await self.start()
+
+            if isinstance(
+                data,
+                str
+            ):
+
+                data = data.encode()
+
+            os.write(
+                self.master_fd,
+                data
+            )
+
+    # =================================================
+    # READ
+    # =================================================
+
+    async def read(
+        self,
+        max_bytes: int = 65536
+    ) -> str:
+
+        if self.process is None:
+            return ""
+
+        try:
+
+            data = os.read(
+                self.master_fd,
+                max_bytes
+            )
+
+            return data.decode(
+                errors="ignore"
+            )
+
+        except BlockingIOError:
+
+            return ""
+
+        except OSError:
+
+            return ""
+
+    # =================================================
+    # READ AVAILABLE
+    # =================================================
+
+    async def read_available(
+        self,
+        chunk_size: int = 65536
+    ) -> str:
+
+        output = []
+
+        while True:
+
+            try:
+
+                chunk = os.read(
+                    self.master_fd,
+                    chunk_size
+                )
+
+                if not chunk:
+                    break
+
+                output.append(
+                    chunk.decode(
+                        errors="ignore"
+                    )
+                )
+
+            except BlockingIOError:
+
+                break
+
+            except OSError:
+
+                break
+
+        return "".join(
+            output
+        )
+
+    # =================================================
+    # RESIZE
+    # =================================================
+
+    async def resize(
+        self,
+        rows: int,
+        cols: int
+    ):
+
+        if self.master_fd is None:
+            return
+
+        winsize = struct.pack(
+            "HHHH",
+            rows,
+            cols,
+            0,
+            0
+        )
+
+        fcntl.ioctl(
+            self.master_fd,
+            termios.TIOCSWINSZ,
+            winsize
+        )
+
+    # =================================================
+    # SIGNAL
+    # =================================================
+
+    async def signal(
+        self,
+        signal_name: str
+    ):
+
+        if self.process is None:
+            return
+
+        sig = getattr(
+            signal,
+            signal_name,
+            None
+        )
+
+        if sig is None:
+            return
+
+        try:
+
+            os.killpg(
+                self.process.pid,
+                sig
+            )
+
+        except Exception:
+
+            pass
+
+    # =================================================
+    # PID
+    # =================================================
+
+    @property
+    def pid(
+        self
+    ):
+
+        if self.process is None:
+            return None
+
+        return (
+            self.process.pid
+        )
+
+    # =================================================
+    # IS ALIVE
+    # =================================================
+
+    def is_alive(
+        self
+    ) -> bool:
+
+        if self.process is None:
+            return False
+
+        return (
+            self.process.poll()
+            is None
+        )
+
+    # =================================================
+    # RETURN CODE
+    # =================================================
+
+    def return_code(
+        self
+    ):
+
+        if self.process is None:
+            return None
+
+        return (
+            self.process.poll()
+        )
+
+    # =================================================
+    # CLOSE
+    # =================================================
+
+    async def close(self):
+
+        if self.process is None:
+            return
+
+        try:
+
+            os.killpg(
+                self.process.pid,
+                signal.SIGTERM
+            )
+
+        except Exception:
+
+            pass
+
+        try:
+
+            await asyncio.wait_for(
+                asyncio.to_thread(
+                    self.process.wait
+                ),
+                timeout=3
+            )
+
+        except asyncio.TimeoutError:
+
+            try:
+
+                os.killpg(
+                    self.process.pid,
+                    signal.SIGKILL
+                )
+
+            except Exception:
+
+                pass
+
+        try:
+
+            os.close(
+                self.master_fd
+            )
+
+        except Exception:
+
+            pass
+
+        try:
+
+            os.close(
+                self.slave_fd
+            )
+
+        except Exception:
+
+            pass
+
+        self.process = None
+
+        self.master_fd = None
+        self.slave_fd = None

modules/utils.py

@@ -0,0 +1,212 @@
+import asyncio
+import websockets
+
+from asyncdatapackage import AsyncDataPackage
+
+
+class WSStreamClient:
+    """
+    Convierte WebSocket en stream tipo TCP para AsyncDataPackage.
+    """
+
+    def __init__(self, host: str, port: int):
+
+        self._host = host
+        self._port = port
+
+        self._ws = None
+
+        self._buffer = bytearray()
+        self._recv_queue = asyncio.Queue()
+
+        self._reader_task = None
+        self._running = False
+
+    # =====================================================
+    # CONNECT
+    # =====================================================
+
+    async def connect(self):
+
+        uri = f"ws://{self._host}:{self._port}"
+
+        self._ws = await websockets.connect(
+            uri,
+            max_size=None,
+            ping_interval=None
+        )
+
+        self._running = True
+
+        self._reader_task = asyncio.create_task(
+            self._reader_loop()
+        )
+
+    # =====================================================
+    # READER LOOP (WS → STREAM BUFFER)
+    # =====================================================
+
+    async def _reader_loop(self):
+
+        try:
+            async for message in self._ws:
+
+                if isinstance(message, str):
+                    message = message.encode("utf-8")
+
+                self._buffer.extend(message)
+
+        except Exception:
+            self._running = False
+
+    # =====================================================
+    # WRITE (STREAM → WS)
+    # =====================================================
+
+    async def write(self, data: bytes) -> bool:
+
+        if not self._ws:
+            return False
+
+        try:
+            await self._ws.send(data)
+            return True
+        except Exception:
+            return False
+
+    # =====================================================
+    # READ (TCP-LIKE SEMANTICS)
+    # =====================================================
+
+    # =====================================================
+    # READ (TCP-LIKE SEMANTICS FIXED)
+    # =====================================================
+
+    async def read(self, amount: int) -> bytes:
+
+        # Bloquear solo si no hay absolutamente nada que leer
+        while len(self._buffer) == 0:
+            if not self._running:
+                return b""
+            await asyncio.sleep(0.001)
+
+        # Extraer hasta 'amount' bytes, o la longitud actual (lo que sea menor)
+        chunk_size = min(amount, len(self._buffer))
+        
+        result = bytes(self._buffer[:chunk_size])
+        del self._buffer[:chunk_size]
+
+        return result
+
+    # =====================================================
+    # CLOSE
+    # =====================================================
+
+    async def close(self):
+
+        self._running = False
+
+        if self._ws:
+            await self._ws.close()
+
+        if self._reader_task:
+            self._reader_task.cancel()
+
+            try:
+                await self._reader_task
+            except:
+                pass
+
+
+# =========================================================
+# COMMUNICATION HANDLER (DROP-IN COMPATIBLE)
+# =========================================================
+
+class CommunicationHandler:
+
+    def __init__(
+        self,
+        auth_token: str,
+        tunnel_token: str,
+        tunnel_port: int,
+        tunnel_host: str = "127.0.0.1"
+    ):
+        self.auth_token = auth_token
+        self.tunnel_token = tunnel_token
+
+        self.tunnel_host = tunnel_host
+        self.tunnel_port = tunnel_port
+
+        self._stream = None
+        self.datapackage = None
+
+    # =====================================================
+    # CONNECTION
+    # =====================================================
+
+    async def connect(self):
+
+        self._stream = WSStreamClient(
+            self.tunnel_host,
+            self.tunnel_port
+        )
+
+        await self._stream.connect()
+
+        async def write_fn(data: bytes):
+            return await self._stream.write(data)
+
+        async def read_fn():
+            # IMPORTANT: AsyncDataPackage expects chunk reads
+            return await self._stream.read(65536)
+
+        self.datapackage = AsyncDataPackage(
+            write_function=write_fn,
+            read_function=read_fn,
+            backpressure_mode="drop_oldest"
+        )
+
+        await self.datapackage.start()
+
+        await self._bind()
+
+    # =====================================================
+    # BIND
+    # =====================================================
+
+    async def _bind(self):
+
+        await self.datapackage.send_datapackage({
+            "auth_token": self.auth_token,
+            "tunnel_token": self.tunnel_token,
+            "packet_type": "CONTROL",
+            "packet_control": "BIND"
+        })
+
+    # =====================================================
+    # SEND
+    # =====================================================
+
+    async def send_datapackage(self, packet: dict):
+
+        await self.datapackage.send_datapackage(packet)
+
+    # =====================================================
+    # RECEIVE
+    # =====================================================
+
+    async def receive_datapackage(self):
+
+        return await self.datapackage.receive_datapackage()
+
+    # =====================================================
+    # CLOSE
+    # =====================================================
+
+    async def close(self):
+
+        if self.datapackage:
+            await self.datapackage.stop()
+
+        if self._stream:
+            await self._stream.close()

openshell_shared-0.1.2.dist-info/METADATA

@@ -0,0 +1,59 @@
+Metadata-Version: 2.4
+Name: openshell-shared
+Version: 0.1.2
+Summary: Shared library for OpenShell (OSAM/OSA/OSAC)
+Author: Daniel Pérez
+License: Proprietary
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+Requires-Dist: httpx
+Requires-Dist: cryptography
+Requires-Dist: websockets
+Requires-Dist: uuid6
+
+# OpenShell Shared
+
+Librería compartida usada por los componentes de OpenShell (OSAM, OSA, OSAC).
+
+Contiene:
+
+- **identity/** — Identidad lógica de las entidades (`EntityIdentity`, `Identification`) y su
+  persistencia (`store.py`).
+- **cryptography/** — Primitivas Ed25519 (`keys.py`, `signatures.py`), identidad criptográfica
+  (`identity.py`) y certificados (`certificate.py`). `encoding.py` y `utils.py` son módulos
+  reservados para trabajo futuro (actualmente sin implementación).
+- **protocols/negotiation/** — Protocolo de challenge-response (`challenge.py`) y sus modelos.
+- **domain/** — Modelo de dominio (`Domain`, `Membership`, `Permission`) y políticas de
+  autorización. `policies.py` es un stub pendiente de implementación real.
+- **standards/** — Enumeraciones y contratos compartidos entre componentes: tipos de entidad,
+  certificados, eventos, roles, permisos, passports y transportes.
+- **modules/shell/** — Implementación del subsistema de shell remoto (cliente, servidor, sesión
+  y protocolo de framing) usado por OSA y OSAC.
+- **api/manager/v1/** — SDK oficial async para consumir la API HTTP de OSAM (`OSAMClient`).
+  Todo el sistema (OSAC, OSA, herramientas internas) debe consumir OSAM exclusivamente a través
+  de este paquete; ningún otro componente debe importar `httpx`/`requests` directamente para
+  hablar con OSAM.
+
+## Notas de la fusión (v2.1.0)
+
+Esta versión unifica dos ramas que habían divergido:
+
+- Se conserva la estructura de empaquetado (`pyproject.toml`, layout `src`) y los módulos
+  `domain/` y `standards/`, introducidos en la rama de refactor v2.
+- Se restaura `modules/shell/` y se sustituye el cliente HTTP monolítico
+  (`api/manager/1/osam_client.py`) por el SDK modular (`api/manager/v1/`), que es la versión
+  vigente y más completa (excepciones tipadas, dataclasses, suite de tests con mock transport).
+
+### Deuda técnica pendiente identificada durante la fusión
+
+1. `domain/permissions.py` y `standards/permissions/types.py` definen dos enums `Permission`
+   distintos y no compatibles entre sí (`AGENT_READ/AGENT_EXECUTE/DOMAIN_ADMIN/PROXY_USE` vs.
+   `DOMAIN_READ/DOMAIN_WRITE/ENTITY_REGISTER/ENTITY_REVOKE/PROXY_USE`). No se han unificado
+   automáticamente porque implica una decisión de diseño (cuál es la fuente de verdad de
+   permisos). Requiere consolidación manual.
+2. `cryptography/encoding.py`, `cryptography/utils.py` y `domain/policies.py` son placeholders
+   vacíos o triviales (`Policy.evaluate` siempre retorna `True`). No implementan lógica real.
+3. El SDK (`api/manager/v1/`) no reexpone los helpers de alto nivel `full_connect` /
+   `open_and_link` que existían en el cliente monolítico anterior (composición de
+   autenticación + túnel + sesión en una sola llamada). Si se siguen usando, conviene
+   reimplementarlos como métodos de conveniencia sobre `OSAMClient`.

openshell_shared-0.1.2.dist-info/RECORD

@@ -0,0 +1,62 @@
+api/__init__.py,sha256=gxFxYhnSvtNu2Bvd3C1vrlOFkVKAJY5Vzk1qTB9IOVk,21
+api/manager/__init__.py,sha256=66EsLcAnZvOfbhmRKT3uY_LPJu3o_rHicCdkAVqpdEs,16
+api/manager/v1/__init__.py,sha256=JPUvoGHq3y47eYmUVNypTZtPixdE9P-lrMnYoK5aljU,1739
+api/manager/v1/authentication.py,sha256=KswoqDUhjiSLeZmnlprg0pfJNZfMK-kHYbAcE40LRdI,7034
+api/manager/v1/client.py,sha256=oIlq0FjUDj42eCzGp1_SHZ-mtK94KQ2Oi3r5g2aLdOk,3885
+api/manager/v1/domains.py,sha256=5v_mSFXRqbdRBshAlO0IN8oBfJsF2W2EVmoejuMYjfg,2048
+api/manager/v1/entities.py,sha256=W2_51oGBHejQO0_tDRmC3_0bfJTjQon72_FjBYtpFY8,3663
+api/manager/v1/exceptions.py,sha256=YqLAFrFHSgkedmFwwT9y-ay4QBOnHyYKAjORI2RGHIE,3627
+api/manager/v1/identity.py,sha256=P_H6FtvS6TiqBNOPG3slAJmmia7frAOcZo11PEdpodw,1669
+api/manager/v1/models.py,sha256=OZCHN9ozVGs46ZR71QDw-iQgdOMGPl7LqNpZG6KoRIs,12223
+api/manager/v1/passports.py,sha256=BOSFhP11d9fBsu9PAKnpOZkfhwUjDiS2f6XUp7SGnPY,4957
+api/manager/v1/sessions.py,sha256=hWi_cb1tejKAkZ0_9ecE2sCmZj7GJgUt9P-2xYziWKk,2435
+api/manager/v1/transport.py,sha256=fiRKiYMjT6dnViL-dB63HQFG2sIGgphxG86YHRvwTiQ,8452
+api/manager/v1/tunnels.py,sha256=Yn6YPwA6_GM0G5HbrJVounGLK7_oOtqHELRJBJDtsoA,4042
+cryptography/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+cryptography/certificate.py,sha256=GlacatBv26w2ltJ32vNzaJ68dffKntM6Y7o-NLSsn6U,9736
+cryptography/encoding.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+cryptography/identity.py,sha256=8ngNnn76CoRdgdctKSl6b2AGCp1P04O8v_MZ7KveyiU,3557
+cryptography/keys.py,sha256=QLdiIMLCvqmnw2zlQXnE5Me_8StJ_mSjo5KXe9JTWHA,8333
+cryptography/signatures.py,sha256=7jrpZjCYKzeGLckPg3wq8BoR9Sj2EKMPdKYzZijRLvg,1143
+cryptography/utils.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+domain/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+domain/domain.py,sha256=p4qh0Pee06IY9pmA_QyVovBlvhFJX1R8QjK_xebo2zY,1734
+domain/membership.py,sha256=X5BAiv2CKoIYZ095ZDGw5YJgBrhQsuIS40glTv8C30I,425
+domain/permissions.py,sha256=ppZZU_-vVuQQ9SujYAKbR4u0brP7OGeRz7_Oq2IO5Ks,222
+domain/policies.py,sha256=jkBzdWKjcwIa1UlrpzCZGhxDXOivX2QHLaj8y68TzqI,66
+identity/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+identity/identification.py,sha256=KQ5XpxDj9TrG-U116j_FC5cMn-0sB_FtSZVwA_QcFgQ,1495
+identity/store.py,sha256=s40UTbBenQYkPZnS7x8jkVzyg4OPQTLeEB3Hd32udVE,4317
+modules/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+modules/utils.py,sha256=c2R9RkuU1WQyFnXT8mNvD0qBtsBeeHJKrvNplcyvSXs,5515
+modules/shell/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+modules/shell/client.py,sha256=D2yAXwj6yr7CRa5PUKtrV8Rk3_6n8Q8AbP7_aJWDeGs,8094
+modules/shell/models.py,sha256=_a1c-xzai_B5UBhVa8zjfPMrM8hotCTNpje5x62Pgi4,1200
+modules/shell/protocol.py,sha256=JlhboJIOM9FQAyqZWKeS4Xbk8lcbUEdq7HOGowjq-ac,4619
+modules/shell/server.py,sha256=Pfm2JINcMZTyxy5uTE425o8ZM6Dtc_p8B67lc_-ktqM,11902
+modules/shell/session.py,sha256=g1VjO0UOii2zITkXHc222C3a_gF2XYFqiV9t30wpfSk,6226
+protocols/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+protocols/negotiation/challenge.py,sha256=OJN_S1aHuvAQkIWVp8QLtGBTD8CuSSgd4AfyFbVQOL8,4134
+protocols/negotiation/models.py,sha256=lNbRds5zyhWV6eEHmm6aFkSunmGPWTMIUKoFJYb04ro,363
+standards/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+standards/certificates/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+standards/certificates/status.py,sha256=wI_0WKo34l-jYyHfkI6EVVJ54iB0VZkcY-v6r7p6hL4,277
+standards/certificates/types.py,sha256=0EJ8-OrP1I_-YIxGl1rgpMDSIlsoGxT_80XxUy5-FYs,286
+standards/entities/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+standards/entities/types.py,sha256=rcCV5XaUskf8ZKeIJyZAj0rTfhrH5QDo-g-AQrB8Ax8,183
+standards/events/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+standards/events/types.py,sha256=OcZ8ibQv1dPOISM01wUSB7ckwYuxBDdCf0PwNm26WZM,348
+standards/events/schemas/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+standards/events/schemas/entity_registered.py,sha256=BMCvnv2WHJKff5Zd7vx9sUyrXbBOuiPjcfqkQS6dG2I,155
+standards/passports/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+standards/passports/types.py,sha256=NRTHSV6TdavW5mBklLvBg587LR2-3dmdrdnq_sY8uMk,88
+standards/permissions/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+standards/permissions/types.py,sha256=ktyRE1CDRMs9ISgsMMWer2-KDP4pcpvIvFuSckoT_3o,227
+standards/roles/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+standards/roles/types.py,sha256=ZDCUTGz7s3WslocydW9ZhSEA-LeVwr9mD-5iIp-dScM,172
+standards/transports/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+standards/transports/types.py,sha256=rkJhZlunaGCkND-bhYixg8wBFtrrd4nwOZUiKuw3tmk,397
+openshell_shared-0.1.2.dist-info/METADATA,sha256=IikTmxI49ECBLiFR6za92qc2ZbVLdXEYnTtA8yOHmB4,3210
+openshell_shared-0.1.2.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+openshell_shared-0.1.2.dist-info/top_level.txt,sha256=t4a8dGEQBmWWTub6GnION4QEEYGWGBChA8jUHIpeCw0,61
+openshell_shared-0.1.2.dist-info/RECORD,,

openshell_shared-0.1.2.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

openshell_shared-0.1.2.dist-info/top_level.txt

@@ -0,0 +1,7 @@
+api
+cryptography
+domain
+identity
+modules
+protocols
+standards