portacode 1.4.15.dev1__tar.gz → 1.4.15.dev3__tar.gz

{portacode-1.4.15.dev1 → portacode-1.4.15.dev3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: portacode
-Version: 1.4.15.dev1
+Version: 1.4.15.dev3
 Summary: Portacode CLI client and SDK
 Home-page: https://github.com/portacode/portacode
 Author: Meena Erian

{portacode-1.4.15.dev1 → portacode-1.4.15.dev3}/portacode/_version.py

@@ -28,7 +28,7 @@ version_tuple: VERSION_TUPLE
 commit_id: COMMIT_ID
 __commit_id__: COMMIT_ID
 
-__version__ = version = '1.4.15.dev1'
-__version_tuple__ = version_tuple = (1, 4, 15, 'dev1')
+__version__ = version = '1.4.15.dev3'
+__version_tuple__ = version_tuple = (1, 4, 15, 'dev3')
 
 __commit_id__ = commit_id = None

{portacode-1.4.15.dev1 → portacode-1.4.15.dev3}/portacode/connection/handlers/WEBSOCKET_PROTOCOL.md

@@ -420,12 +420,12 @@ Creates or updates a Cloudflare tunnel in front of a managed container. The cont
 
 *   `ctid` (string, required): Identifier of the container.
 *   `container_port` (integer, required): Port inside the container to expose through Cloudflare.
-*   `cloudflare_url` (string, required): Hostname (e.g., `app.example.com`) that the tunnel should serve.
+*   `cloudflare_url` (string, optional): Hostname (e.g., `app.example.com`) that the tunnel should serve. Leave blank to let Cloudflare create a quick tunnel (`*.cfargotunnel.com`) automatically.
 *   `protocol` (string, optional): One of `http`, `https`, or `tcp` (defaults to `http`).
 
 **Responses:**
 
-*   Emits a [`cloudflare_tunnel_created`](#cloudflare_tunnel_created-event) event with the tunnel metadata.
+*   Emits a [`cloudflare_tunnel_created`](#cloudflare_tunnel_created-event) event with the tunnel metadata, the refreshed infra snapshot, and the optional `device_id` so dashboards can refresh the CT list.
 *   Emits an [`error`](#error) event on failure.
 
 ### `update_cloudflare_tunnel`
@@ -436,12 +436,12 @@ Refreshes the tunnel configuration for an existing tunnel (different port, URL,
 
 *   `ctid` (string, required): Identifier of the container.
 *   `container_port` (integer, optional): New container port.
-*   `cloudflare_url` (string, optional): New hostname.
+*   `cloudflare_url` (string, optional): New hostname (leave blank to keep the current hostname or let Cloudflare assign a quick tunnel).
 *   `protocol` (string, optional): New protocol (`http`, `https`, or `tcp`).
 
 **Responses:**
 
-*   Emits a [`cloudflare_tunnel_updated`](#cloudflare_tunnel_updated-event) event with the refreshed tunnel metadata.
+*   Emits a [`cloudflare_tunnel_updated`](#cloudflare_tunnel_updated-event) event with the refreshed tunnel metadata, the refreshed infra snapshot, and the optional `device_id`.
 *   Emits an [`error`](#error) event on failure.
 
 ### `remove_cloudflare_tunnel`
@@ -454,7 +454,7 @@ Stops and removes any tunnel metadata associated with a container.
 
 **Responses:**
 
-*   Emits a [`cloudflare_tunnel_removed`](#cloudflare_tunnel_removed-event) event.
+*   Emits a [`cloudflare_tunnel_removed`](#cloudflare_tunnel_removed-event) event with the refreshed infra snapshot and optional `device_id`.
 *   Emits an [`error`](#error) event on failure.
 
 ### `proxmox_container_created`
@@ -1272,8 +1272,10 @@ Submitted after a successful `create_cloudflare_tunnel` action.
 *   `event` (string): `cloudflare_tunnel_created`.
 *   `ctid` (string): Container ID associated with the tunnel.
 *   `success` (boolean): True when the tunnel is running.
-*   `message` (string): Summary text.
-*   `tunnel` (object): Tunnel metadata matching the manager view.
+*   `device_id` (string, optional): Mirrors the `device_id` supplied with the command, letting dashboards refresh that device immediately.
+*   `message` (string): Summary text; when a hostname was assigned (including Quick Tunnel), the host is appended (e.g., `Created ... -> example.com`).
+*   `tunnel` (object): Tunnel metadata matching the manager view. When using Cloudflare Quick Tunnel (no hostname supplied), `tunnel.url` holds the autogenerated `*.cfargotunnel.com` hostname.
+*   `infra` (object): Snapshot produced by `get_infra_snapshot`, including the refreshed `managed_containers` list.
 
 ### `cloudflare_tunnel_updated`
 
@@ -1284,8 +1286,10 @@ Sent when `update_cloudflare_tunnel` completes.
 *   `event` (string): `cloudflare_tunnel_updated`.
 *   `ctid` (string): Container ID associated with the tunnel.
 *   `success` (boolean): True on success.
-*   `message` (string): Summary text.
+*   `device_id` (string, optional): Mirrors the command's `device_id`.
+*   `message` (string): Summary text; includes the new hostname when one was assigned or changed.
 *   `tunnel` (object): Updated tunnel metadata.
+*   `infra` (object): Snapshot produced by `get_infra_snapshot` so dashboards can refresh the managed container list.
 
 ### `cloudflare_tunnel_removed`
 
@@ -1296,7 +1300,10 @@ Sent after a tunnel has been removed from a container record.
 *   `event` (string): `cloudflare_tunnel_removed`.
 *   `ctid` (string): Container ID that no longer has a tunnel.
 *   `success` (boolean): True on success.
+*   `device_id` (string, optional): Mirrors the command's `device_id`.
 *   `message` (string): Summary text.
+*   `tunnel` (null): Always `null` to explicitly clear the stored tunnel metadata.
+*   `infra` (object): The refreshed snapshot so dashboards see the updated container list.
 
 ### <a name="clock_sync_response"></a>`clock_sync_response`
 

{portacode-1.4.15.dev1 → portacode-1.4.15.dev3}/portacode/connection/handlers/__init__.py

@@ -43,12 +43,15 @@ from .project_state_handlers import (
 )
 from .proxmox_infra import (
     ConfigureProxmoxInfraHandler,
+    CreateCloudflareTunnelHandler,
     CreateProxmoxContainerHandler,
     RevertProxmoxInfraHandler,
     StartPortacodeServiceHandler,
     StartProxmoxContainerHandler,
     StopProxmoxContainerHandler,
+    RemoveCloudflareTunnelHandler,
     RemoveProxmoxContainerHandler,
+    UpdateCloudflareTunnelHandler,
 )
 
 __all__ = [
@@ -62,6 +65,7 @@ __all__ = [
     "TerminalListHandler",
     "SystemInfoHandler",
     "ConfigureProxmoxInfraHandler",
+    "CreateCloudflareTunnelHandler",
     "CreateProxmoxContainerHandler",
     # File operation handlers (optional - register as needed)
     "FileReadHandler",
@@ -91,7 +95,9 @@ __all__ = [
     "StartPortacodeServiceHandler",
     "StartProxmoxContainerHandler",
     "StopProxmoxContainerHandler",
+    "RemoveCloudflareTunnelHandler",
     "RemoveProxmoxContainerHandler",
+    "UpdateCloudflareTunnelHandler",
     "UpdatePortacodeHandler",
     "RevertProxmoxInfraHandler",
 ] 

{portacode-1.4.15.dev1 → portacode-1.4.15.dev3}/portacode/connection/handlers/proxmox_infra.py

@@ -8,6 +8,8 @@ import logging
 import os
 import secrets
 import shlex
+import re
+import select
 import shutil
 import stat
 import subprocess
@@ -637,19 +639,19 @@ def _launch_container_tunnel(proxmox: Any, node: str, vmid: int, tunnel: Dict[st
     port = int(tunnel.get("container_port") or 0)
     if not port:
         raise ValueError("container_port is required to create a tunnel.")
-    hostname = tunnel.get("url")
-    if not hostname:
-        raise ValueError("cloudflare_url is required to expose the tunnel.")
+    requested_hostname = tunnel.get("url") or None
     protocol = (tunnel.get("protocol") or "http").lower()
     ip_address = _resolve_container_ip(proxmox, node, vmid)
     target_url = f"{protocol}://{ip_address}:{port}"
     name = tunnel.get("name") or _build_tunnel_name(vmid, port)
     _stop_cloudflare_process(name)
-    proc = _start_cloudflare_process(name, hostname, target_url)
+    proc, assigned_url = _start_cloudflare_process(name, target_url, hostname=requested_hostname)
+    if not assigned_url:
+        raise RuntimeError("Failed to determine Cloudflare hostname for the tunnel.")
     updated = {
         "name": name,
         "container_port": port,
-        "url": hostname,
+        "url": assigned_url,
         "protocol": protocol,
         "status": "running",
         "pid": proc.pid,
@@ -671,13 +673,14 @@ def _stop_container_tunnel(vmid: int) -> None:
         return
     name = tunnel.get("name") or _build_tunnel_name(vmid, int(tunnel.get("container_port") or 0))
     stopped = _stop_cloudflare_process(name)
-    if stopped or tunnel.get("status") != "stopped":
-        tunnel_update = {
-            **tunnel,
-            "status": "stopped",
-            "pid": None,
-            "last_updated": datetime.utcnow().isoformat() + "Z",
-        }
+    if not stopped and tunnel.get("status") == "stopped":
+        return
+    tunnel_update = {
+        **tunnel,
+        "status": "stopped",
+        "pid": None,
+        "last_updated": datetime.utcnow().isoformat() + "Z",
+    }
     _update_container_tunnel(vmid, tunnel_update)
 
 
@@ -827,25 +830,67 @@ def _get_cloudflared_binary() -> str:
     return binary
 
 
-def _start_cloudflare_process(name: str, hostname: str, target_url: str) -> subprocess.Popen:
+def _drain_stream(stream: Optional[Any]) -> None:
+    if stream is None:
+        return
+    try:
+        for _ in iter(stream.readline, ""):
+            continue
+    except Exception:
+        pass
+    finally:
+        try:
+            stream.close()
+        except Exception:
+            pass
+
+
+def _await_quick_tunnel_url(proc: subprocess.Popen, timeout: float = 15.0) -> Optional[str]:
+    if not proc.stdout:
+        return None
+    cf_re = re.compile(r"https://[A-Za-z0-9\-.]+\.cfargotunnel\.com")
+    deadline = time.time() + timeout
+    while time.time() < deadline:
+        ready, _, _ = select.select([proc.stdout], [], [], 1)
+        if not ready:
+            continue
+        line = proc.stdout.readline()
+        if not line:
+            continue
+        match = cf_re.search(line)
+        if match:
+            return match.group(0)
+    return None
+
+
+def _start_cloudflare_process(name: str, target_url: str, hostname: Optional[str] = None) -> Tuple[subprocess.Popen, Optional[str]]:
     binary = _get_cloudflared_binary()
     cmd = [
         binary,
         "tunnel",
-        "--hostname",
-        hostname,
         "--url",
         target_url,
         "--no-autoupdate",
     ]
+    if hostname:
+        cmd.extend(["--hostname", hostname])
+        stdout_target = subprocess.DEVNULL
+    else:
+        stdout_target = subprocess.PIPE
     proc = subprocess.Popen(
         cmd,
-        stdout=subprocess.DEVNULL,
-        stderr=subprocess.DEVNULL,
+        stdout=stdout_target,
+        stderr=subprocess.PIPE,
+        text=True,
     )
     with _CLOUDFLARE_TUNNELS_LOCK:
         _CLOUDFLARE_TUNNEL_PROCESSES[name] = proc
-    return proc
+    assigned_url = hostname
+    if not hostname:
+        assigned_url = _await_quick_tunnel_url(proc)
+        threading.Thread(target=_drain_stream, args=(proc.stdout,), daemon=True).start()
+    threading.Thread(target=_drain_stream, args=(proc.stderr,), daemon=True).start()
+    return proc, assigned_url
 
 
 def _stop_cloudflare_process(name: str) -> bool:
@@ -1884,8 +1929,7 @@ class CreateCloudflareTunnelHandler(SyncHandler):
         if container_port <= 0:
             raise ValueError("container_port is required and must be greater than zero.")
         hostname = (message.get("cloudflare_url") or message.get("hostname") or "").strip()
-        if not hostname:
-            raise ValueError("cloudflare_url is required.")
+        hostname = hostname or None
         protocol = (message.get("protocol") or "http").strip().lower()
         if protocol not in {"http", "https", "tcp"}:
             raise ValueError("protocol must be one of http, https, or tcp.")
@@ -1899,17 +1943,28 @@ class CreateCloudflareTunnelHandler(SyncHandler):
             raise RuntimeError("Container must be running to create a tunnel.")
         tunnel = {
             "container_port": container_port,
-            "url": hostname,
             "protocol": protocol,
         }
+        if hostname:
+            tunnel["url"] = hostname
         created = _launch_container_tunnel(proxmox, node, vmid, tunnel)
-        return {
+        infra = get_infra_snapshot()
+        host_url = created.get("url")
+        response_message = f"Created Cloudflare tunnel for container {vmid}."
+        if host_url:
+            response_message = f"{response_message[:-1]} -> {host_url}."
+        response = {
             "event": "cloudflare_tunnel_created",
             "ctid": str(vmid),
             "success": True,
-            "message": f"Created Cloudflare tunnel for container {vmid}.",
+            "message": response_message,
             "tunnel": created,
+            "infra": infra,
         }
+        device_id = message.get("device_id")
+        if device_id:
+            response["device_id"] = device_id
+        return response
 
 
 class UpdateCloudflareTunnelHandler(SyncHandler):
@@ -1934,24 +1989,34 @@ class UpdateCloudflareTunnelHandler(SyncHandler):
         if container_port <= 0:
             raise ValueError("container_port must be greater than zero.")
         hostname = (message.get("cloudflare_url") or tunnel.get("url") or "").strip()
-        if not hostname:
-            raise ValueError("cloudflare_url is required.")
+        hostname = hostname or None
         protocol = (message.get("protocol") or tunnel.get("protocol") or "http").strip().lower()
         if protocol not in {"http", "https", "tcp"}:
             raise ValueError("protocol must be one of http, https, or tcp.")
         updated_tunnel = {
             "container_port": container_port,
-            "url": hostname,
             "protocol": protocol,
         }
+        if hostname:
+            updated_tunnel["url"] = hostname
         result = _launch_container_tunnel(proxmox, node, vmid, updated_tunnel)
-        return {
+        infra = get_infra_snapshot()
+        host_url = result.get("url")
+        response_message = f"Updated Cloudflare tunnel for container {vmid}."
+        if host_url:
+            response_message = f"{response_message[:-1]} -> {host_url}."
+        response = {
             "event": "cloudflare_tunnel_updated",
             "ctid": str(vmid),
             "success": True,
-            "message": f"Updated Cloudflare tunnel for container {vmid}.",
+            "message": response_message,
             "tunnel": result,
+            "infra": infra,
         }
+        device_id = message.get("device_id")
+        if device_id:
+            response["device_id"] = device_id
+        return response
 
 
 class RemoveCloudflareTunnelHandler(SyncHandler):
@@ -1964,12 +2029,19 @@ class RemoveCloudflareTunnelHandler(SyncHandler):
     def execute(self, message: Dict[str, Any]) -> Dict[str, Any]:
         vmid = _parse_ctid(message)
         _remove_container_tunnel_state(vmid)
-        return {
+        infra = get_infra_snapshot()
+        response = {
             "event": "cloudflare_tunnel_removed",
             "ctid": str(vmid),
             "success": True,
             "message": f"Removed Cloudflare tunnel state for container {vmid}.",
+            "tunnel": None,
+            "infra": infra,
         }
+        device_id = message.get("device_id")
+        if device_id:
+            response["device_id"] = device_id
+        return response
 
 
 class ConfigureProxmoxInfraHandler(SyncHandler):

{portacode-1.4.15.dev1 → portacode-1.4.15.dev3}/portacode.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: portacode
-Version: 1.4.15.dev1
+Version: 1.4.15.dev3
 Summary: Portacode CLI client and SDK
 Home-page: https://github.com/portacode/portacode
 Author: Meena Erian