codicent-cli 0.8.1__tar.gz → 0.8.2__tar.gz

{codicent_cli-0.8.1 → codicent_cli-0.8.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: codicent-cli
-Version: 0.8.1
+Version: 0.8.2
 Summary: Command-line interface for the Codicent API
 Home-page: https://github.com/izaxon/codicent-cli
 Author: Johan Isaksson
@@ -30,6 +30,7 @@ Requires-Dist: requests
 Requires-Dist: pyyaml
 Requires-Dist: packaging
 Requires-Dist: pyte
+Requires-Dist: websocket-client
 Dynamic: author
 Dynamic: author-email
 Dynamic: classifier

{codicent_cli-0.8.1 → codicent_cli-0.8.2}/app.py

@@ -106,6 +106,23 @@ WRAP (AI CLI Remote Bridge):
         codicent wrap --poll-interval 5 codex
         codicent wrap --binary /usr/local/bin/claude claude --model claude-opus-4-5
 
+TERMINAL (Web Terminal Host):
+    terminal            Start a local shell and host it as a Codicent terminal session.
+                        Browser users can connect to it via the Codicent web UI.
+
+        [shell]         Shell to run (default: $SHELL or bash)
+
+    How it works:
+        1. Spawns the shell locally using a PTY
+        2. Connects to the Codicent server as a "terminal host" via WebSocket
+        3. Relays shell I/O to any browser that connects to the session
+        4. Session output is logged as #terminal-session in Codicent when done
+
+    Examples:
+        codicent terminal
+        codicent terminal bash
+        codicent terminal zsh
+
 EXAMPLES:
     codicent auth
     codicent "What is Python?"
@@ -114,6 +131,7 @@ EXAMPLES:
     codicent upload document.txt *.log
     codicent init --template koi-studio
     codicent wrap claude
+    codicent terminal
     codicent update
     codicent update --install
     echo "Help me debug this" | codicent
@@ -555,6 +573,37 @@ def main():
             project=wrap_project,
         )
 
+    # Handle terminal command
+    if len(sys.argv) > 1 and sys.argv[1] == "terminal":
+        from terminal import run_terminal_host
+
+        term_token = auth.get_cached_token()
+        if not term_token:
+            term_token = os.getenv("CODICENT_TOKEN")
+        if not term_token:
+            console.print("[red]❌ No authentication found.[/red]")
+            console.print("[dim]Run 'codicent auth' to authenticate, or set CODICENT_TOKEN[/dim]")
+            return 1
+
+        try:
+            term_payload = term_token.split(".")[1]
+            term_payload += '=' * (-len(term_payload) % 4)
+            term_jwt = json.loads(base64.urlsafe_b64decode(term_payload).decode('utf-8'))
+            term_project = term_jwt["project"]
+            term_base_url = term_jwt.get("baseUrl", "https://codicent.com/")
+        except Exception as e:
+            console.print(f"[red]❌ Failed to extract project from token: {e}[/red]")
+            return 1
+
+        shell_arg = sys.argv[2] if len(sys.argv) > 2 else None
+        run_terminal_host(
+            token=term_token,
+            base_url=term_base_url,
+            project=term_project,
+            shell=shell_arg,
+        )
+        return 0
+
     # Get authentication token
     token = auth.get_cached_token()
     if not token:

{codicent_cli-0.8.1 → codicent_cli-0.8.2}/codicent_cli.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: codicent-cli
-Version: 0.8.1
+Version: 0.8.2
 Summary: Command-line interface for the Codicent API
 Home-page: https://github.com/izaxon/codicent-cli
 Author: Johan Isaksson
@@ -30,6 +30,7 @@ Requires-Dist: requests
 Requires-Dist: pyyaml
 Requires-Dist: packaging
 Requires-Dist: pyte
+Requires-Dist: websocket-client
 Dynamic: author
 Dynamic: author-email
 Dynamic: classifier

{codicent_cli-0.8.1 → codicent_cli-0.8.2}/codicent_cli.egg-info/SOURCES.txt

@@ -3,6 +3,7 @@ README.md
 app.py
 auth.py
 setup.py
+terminal.py
 wrap.py
 codicent_cli.egg-info/PKG-INFO
 codicent_cli.egg-info/SOURCES.txt

{codicent_cli-0.8.1 → codicent_cli-0.8.2}/codicent_cli.egg-info/requires.txt

@@ -5,3 +5,4 @@ requests
 pyyaml
 packaging
 pyte
+websocket-client

{codicent_cli-0.8.1 → codicent_cli-0.8.2}/codicent_cli.egg-info/top_level.txt

@@ -1,4 +1,5 @@
 app
 auth
 templates
+terminal
 wrap

{codicent_cli-0.8.1 → codicent_cli-0.8.2}/setup.py

@@ -9,7 +9,7 @@ except FileNotFoundError:
 
 setup(
     name='codicent-cli',
-    version='0.8.1',
+    version='0.8.2',
     author='Johan Isaksson',
     author_email='johan@izaxon.com',
     description='Command-line interface for the Codicent API',
@@ -35,7 +35,7 @@ setup(
         'Programming Language :: Python :: 3.12',
     ],
     keywords='codicent cli api chat ai',
-    py_modules=['app', 'auth', 'wrap'],
+    py_modules=['app', 'auth', 'wrap', 'terminal'],
     packages=['templates'],
     package_data={'templates': ['*.json']},
     python_requires='>=3.6',
@@ -47,6 +47,7 @@ setup(
         'pyyaml',
         'packaging',
         'pyte',
+        'websocket-client',
     ],
     entry_points={
         'console_scripts': [

codicent_cli-0.8.2/terminal.py

@@ -0,0 +1,247 @@
+"""
+codicent terminal — web terminal host
+
+Spawns a local shell process and registers it as a terminal session on the
+Codicent server.  Browser users can then connect to it via the web UI.
+
+Usage:
+  codicent terminal [shell]   # shell defaults to $SHELL or bash
+
+The CLI tool:
+  1. Spawns the shell locally via PTY (or subprocess on Windows)
+  2. Connects to /terminal/host on the Codicent server via WebSocket
+  3. Relays PTY I/O <-> WebSocket in real time
+  4. Session output is logged to Codicent as #terminal-session when it ends
+"""
+
+import os
+import sys
+import threading
+import signal
+import uuid
+import logging
+
+try:
+    import websocket as websocket_client  # websocket-client library
+    _HAS_WS = True
+except ImportError:
+    _HAS_WS = False
+
+# PTY support (Linux/macOS/WSL); falls back to subprocess on Windows
+try:
+    import pty
+    import termios
+    import fcntl
+    import struct
+    _HAS_PTY = True
+except ImportError:
+    _HAS_PTY = False
+
+logger = logging.getLogger(__name__)
+
+
+def _get_terminal_size():
+    try:
+        import shutil
+        sz = shutil.get_terminal_size()
+        return sz.columns, sz.lines
+    except Exception:
+        return 80, 24
+
+
+def run_terminal_host(token: str, base_url: str, project: str, shell: str = None):
+    """Start a local shell and host it as a Codicent terminal session."""
+
+    if not _HAS_WS:
+        print("[error] websocket-client is required: pip install websocket-client", file=sys.stderr)
+        sys.exit(1)
+
+    shell = shell or os.environ.get("SHELL", "bash")
+    session_id = uuid.uuid4().hex
+
+    # Build WebSocket URL
+    ws_base = base_url.rstrip("/").replace("https://", "wss://").replace("http://", "ws://")
+    ws_url = (
+        f"{ws_base}/terminal/host"
+        f"?project={project}"
+        f"&command={os.path.basename(shell)}"
+        f"&sessionId={session_id}"
+        f"&access_token={token}"
+    )
+
+    print(f"[codicent terminal] project=@{project}  shell={shell}  session={session_id}")
+    print(f"[codicent terminal] Connecting to {base_url} ...")
+
+    stop_event = threading.Event()
+    ws_app = None
+
+    # ── PTY-based (POSIX) ─────────────────────────────────────────────
+    if _HAS_PTY:
+        cols, rows = _get_terminal_size()
+
+        # Fork a PTY
+        pid, fd = pty.fork()
+
+        if pid == 0:
+            # Child: exec the shell
+            env = os.environ.copy()
+            env["TERM"] = "xterm-256color"
+            os.execvpe(shell, [shell, "-i"], env)
+            sys.exit(1)
+
+        # Parent: relay PTY <-> WebSocket
+
+        def _set_pty_size(c, r):
+            try:
+                import struct, termios, fcntl
+                fcntl.ioctl(fd, termios.TIOCSWINSZ, struct.pack("HHHH", r, c, 0, 0))
+            except Exception:
+                pass
+
+        _set_pty_size(cols, rows)
+
+        def on_open(ws):
+            print("[codicent terminal] Connected. Shell is ready in the browser.")
+            # Send initial resize
+            import json
+            ws.send(json.dumps({"type": "resize", "cols": cols, "rows": rows}))
+
+        def on_message(ws, message):
+            # Incoming from browser: either resize JSON or raw stdin
+            try:
+                import json
+                obj = json.loads(message)
+                if obj.get("type") == "resize":
+                    _set_pty_size(obj.get("cols", 80), obj.get("rows", 24))
+                    return
+            except (ValueError, KeyError):
+                pass
+            # Write to PTY stdin
+            try:
+                os.write(fd, message.encode() if isinstance(message, str) else message)
+            except OSError:
+                ws.close()
+
+        def on_error(ws, error):
+            print(f"[codicent terminal] WebSocket error: {error}", file=sys.stderr)
+
+        def on_close(ws, code, reason):
+            print(f"[codicent terminal] Disconnected ({code}). Session ended.")
+            stop_event.set()
+
+        ws_app = websocket_client.WebSocketApp(
+            ws_url,
+            on_open=on_open,
+            on_message=on_message,
+            on_error=on_error,
+            on_close=on_close,
+        )
+
+        # Thread: read PTY output and forward to WebSocket
+        def _pty_reader():
+            import select as sel
+            while not stop_event.is_set():
+                try:
+                    r, _, _ = sel.select([fd], [], [], 0.05)
+                    if not r:
+                        continue
+                    data = os.read(fd, 4096)
+                    if not data:
+                        break
+                    if ws_app.sock and ws_app.sock.connected:
+                        ws_app.send(data.decode("utf-8", errors="replace"))
+                except OSError:
+                    break
+                except Exception as e:
+                    logger.debug(f"PTY reader: {e}")
+            stop_event.set()
+            if ws_app.sock:
+                ws_app.close()
+
+        t = threading.Thread(target=_pty_reader, daemon=True)
+        t.start()
+
+        def _sigchld_handler(signum, frame):
+            stop_event.set()
+
+        signal.signal(signal.SIGCHLD, _sigchld_handler)
+
+        ws_app.run_forever()
+
+        # Clean up child process
+        try:
+            os.kill(pid, signal.SIGTERM)
+        except ProcessLookupError:
+            pass
+
+    # ── Subprocess-based (Windows fallback) ──────────────────────────
+    else:
+        import subprocess
+        import queue
+
+        proc = subprocess.Popen(
+            [shell],
+            stdin=subprocess.PIPE,
+            stdout=subprocess.PIPE,
+            stderr=subprocess.STDOUT,
+        )
+
+        output_queue: queue.Queue = queue.Queue()
+
+        def _stdout_reader():
+            while True:
+                chunk = proc.stdout.read(4096)
+                if not chunk:
+                    break
+                output_queue.put(chunk.decode("utf-8", errors="replace"))
+            stop_event.set()
+
+        threading.Thread(target=_stdout_reader, daemon=True).start()
+
+        def on_open(ws):
+            print("[codicent terminal] Connected.")
+
+            # Thread: drain queue -> WebSocket
+            def _sender():
+                while not stop_event.is_set():
+                    try:
+                        text = output_queue.get(timeout=0.05)
+                        if ws.sock and ws.sock.connected:
+                            ws.send(text)
+                    except queue.Empty:
+                        continue
+                    except Exception:
+                        break
+
+            threading.Thread(target=_sender, daemon=True).start()
+
+        def on_message(ws, message):
+            try:
+                import json
+                obj = json.loads(message)
+                if obj.get("type") == "resize":
+                    return  # resize not applicable without PTY
+            except (ValueError, KeyError):
+                pass
+            try:
+                proc.stdin.write((message if isinstance(message, bytes) else message.encode()))
+                proc.stdin.flush()
+            except OSError:
+                ws.close()
+
+        def on_error(ws, error):
+            print(f"[codicent terminal] WebSocket error: {error}", file=sys.stderr)
+
+        def on_close(ws, code, reason):
+            print("[codicent terminal] Disconnected.")
+            stop_event.set()
+            proc.terminate()
+
+        ws_app = websocket_client.WebSocketApp(
+            ws_url,
+            on_open=on_open,
+            on_message=on_message,
+            on_error=on_error,
+            on_close=on_close,
+        )
+        ws_app.run_forever()