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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: codicent-cli
-Version: 0.8.0
+Version: 0.8.2
 Summary: Command-line interface for the Codicent API
 Home-page: https://github.com/izaxon/codicent-cli
 Author: Johan Isaksson
@@ -28,6 +28,9 @@ Requires-Dist: codicent-py
 Requires-Dist: prompt_toolkit
 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.0 → 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,8 +131,15 @@ 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
 
+UPDATE:
+    update              Check if a newer version is available on PyPI
+        --install       Also upgrade immediately via pip
+
 ENVIRONMENT:
     CODICENT_TOKEN     Your Codicent API token (fallback if no cached auth)
 
@@ -123,9 +147,11 @@ For more information, visit: https://github.com/izaxon/codicent-cli
 """
     print(help_text.strip())
 
+CURRENT_VERSION = "0.8.1"
+
 def show_version():
     """Display version information."""
-    print("Codicent CLI v0.8.0")
+    print(f"Codicent CLI v{CURRENT_VERSION}")
 
 def validate_input(question):
     """Validate user input."""
@@ -200,6 +226,54 @@ def main():
                     console.print("[dim]Run 'codicent auth' to authenticate[/dim]")
                     return 1
     
+    # Handle update command
+    if len(sys.argv) > 1 and sys.argv[1] == "update":
+        do_install = "--install" in sys.argv
+        try:
+            resp = requests.get(
+                "https://pypi.org/pypi/codicent-cli/json",
+                timeout=10,
+            )
+            resp.raise_for_status()
+            latest = resp.json()["info"]["version"]
+        except Exception as e:
+            console.print(f"[red]❌ Could not check PyPI: {e}[/red]")
+            return 1
+
+        from packaging.version import Version
+
+        # Detect whether we're running inside a pipx-managed environment
+        is_pipx = "pipx" in sys.executable.replace("\\", "/")
+
+        if Version(latest) > Version(CURRENT_VERSION):
+            console.print(
+                f"[yellow]⬆ New version available:[/yellow] "
+                f"[bold]{latest}[/bold] (you have {CURRENT_VERSION})"
+            )
+            if do_install:
+                if is_pipx:
+                    console.print("[dim]Running pipx upgrade codicent-cli...[/dim]")
+                    result = subprocess.run(
+                        ["pipx", "upgrade", "codicent-cli"],
+                        capture_output=False,
+                    )
+                else:
+                    console.print("[dim]Running pip install --upgrade codicent-cli...[/dim]")
+                    result = subprocess.run(
+                        [sys.executable, "-m", "pip", "install", "--upgrade", "codicent-cli"],
+                        capture_output=False,
+                    )
+                return result.returncode
+            else:
+                upgrade_cmd = "pipx upgrade codicent-cli" if is_pipx else "pip install --upgrade codicent-cli"
+                console.print(
+                    f"[dim]Run [bold]codicent update --install[/bold] to upgrade, "
+                    f"or [bold]{upgrade_cmd}[/bold][/dim]"
+                )
+        else:
+            console.print(f"[green]✅ Already up to date (v{CURRENT_VERSION})[/green]")
+        return 0
+
     # Handle upload command
     if len(sys.argv) > 1 and sys.argv[1] == "upload":
         if len(sys.argv) < 3:
@@ -499,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:
@@ -727,7 +832,7 @@ def main():
 
         header = Text()
         header.append("Codicent CLI", style="bold bright_cyan")
-        header.append(" v0.8.0\n", style="bright_cyan")
+        header.append(f" v{CURRENT_VERSION}\n", style="bright_cyan")
         header.append("Type your questions or use Ctrl+C to exit.\n", style="dim")
         header.append("\n")
         header.append("Tip: ", style="bold dim")

{codicent_cli-0.8.0 → 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.0
+Version: 0.8.2
 Summary: Command-line interface for the Codicent API
 Home-page: https://github.com/izaxon/codicent-cli
 Author: Johan Isaksson
@@ -28,6 +28,9 @@ Requires-Dist: codicent-py
 Requires-Dist: prompt_toolkit
 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.0 → 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.0 → codicent_cli-0.8.2}/codicent_cli.egg-info/requires.txt

@@ -3,3 +3,6 @@ codicent-py
 prompt_toolkit
 requests
 pyyaml
+packaging
+pyte
+websocket-client

{codicent_cli-0.8.0 → 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.0 → codicent_cli-0.8.2}/setup.py

@@ -9,7 +9,7 @@ except FileNotFoundError:
 
 setup(
     name='codicent-cli',
-    version='0.8.0',
+    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',
@@ -45,6 +45,9 @@ setup(
         'prompt_toolkit',
         'requests',
         '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()