@beeos-ai/cli 1.0.23 → 1.1.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@beeos-ai/cli",
-  "version": "1.0.23",
+  "version": "1.1.0",
   "type": "module",
   "description": "BeeOS CLI — run AI agents from your desktop",
   "bin": {

package/scripts/install.Tests.ps1

@@ -80,7 +80,13 @@ Describe "install.ps1 parse-time integrity" {
             "Invoke-BeeosCli",
             # P2-8: PSCore + RunAs auto-elevation helpers.
             "Test-IsAdministrator",
-            "Request-Elevation"
+            "Request-Elevation",
+            # Multi-OS install-link refactor Phase 2: TightVNC
+            # pre-check. install.sh has a parallel `test_vnc_server`
+            # function for Linux. Listed here so a future cleanup
+            # that drops the helper triggers a Pester failure
+            # before reaching customers.
+            "Test-VncServer"
         )
 
         foreach ($name in $expected) {

package/scripts/install.ps1

@@ -24,6 +24,11 @@
       $env:BEEOS_DASHBOARD_URL      Dashboard base (OAuth / bind redirect).
       $env:BEEOS_INSTALL_DRY_RUN=1  CI smoke-test escape hatch.
       $env:BEEOS_NO_TELEMETRY=1     Disable script-level telemetry POSTs.
+      $env:BEEOS_NO_DESKTOP=1       Skip TightVNC detection/install hint.
+                                     Forwarded to `beeos init` so the
+                                     CLI's desktop pipeline also stays
+                                     dormant (Phase 2 of the multi-OS
+                                     install-link refactor).
       $env:BEEOS_USE_NPX = "1"      Power-user throwaway install (beeos
                                      won't persist on PATH).
 
@@ -562,6 +567,47 @@ if (-not (Test-NodeVersion)) {
 $nodeVer = & node -v
 Write-BeeOk "Node.js $nodeVer detected"
 
+# ── TightVNC detection (Phase 2 of multi-OS install-link refactor) ────
+#
+# BeeOS desktop streaming on Windows uses TightVNC + the existing
+# vnc-bridge sidecar (same RFB pipeline as macOS / Linux). The CLI's
+# `DesktopPlatform.windows` adapter takes over once `beeos init` runs:
+# it generates a viewer password, writes the TightVNC registry config
+# under UAC, and starts/restarts `tvnserver`. This script's only job
+# at install time is the user-facing hint — pointing the user at
+# `winget install GlavSoft.TightVNC` so the cold-start has something
+# to configure on the next `beeos init`.
+#
+# Skipped entirely when:
+#   - $env:BEEOS_NO_DESKTOP = "1" (hint AND CLI desktop pipeline off)
+#   - the user opted into `-Device` mode (device-attach flow has its
+#     own VNC handling via `--vnc-host`).
+function Test-VncServer {
+    if ($env:BEEOS_NO_DESKTOP -eq "1") {
+        Write-BeeInfo "BEEOS_NO_DESKTOP=1 — skipping TightVNC detection."
+        return
+    }
+    if ($Device) {
+        # device-attach handles its own VNC story; the OpenClaw
+        # auto-desktop path is only taken by `beeos init`.
+        return
+    }
+    $svc = Get-Service tvnserver -ErrorAction SilentlyContinue
+    $reg = Test-Path "HKLM:\SOFTWARE\TightVNC\Server"
+    if ($svc -or $reg) {
+        Write-BeeOk "TightVNC detected — `beeos init` will configure it for desktop streaming."
+        return
+    }
+    Write-Host ""
+    Write-BeeInfo "Optional: BeeOS desktop streaming on Windows uses TightVNC."
+    Write-Host "  Install with:" -ForegroundColor White
+    Write-Host "    winget install GlavSoft.TightVNC --accept-package-agreements --accept-source-agreements --silent"
+    Write-Host ""
+    Write-Host "  Then re-run `beeos init`. Set $env:BEEOS_NO_DESKTOP = '1' to suppress this hint." -ForegroundColor DarkGray
+    Write-Host ""
+}
+Test-VncServer
+
 # Bootstrap is finished. Hand off to `Invoke-BeeosCli` which performs
 # `npm install -g @beeos-ai/cli` (idempotent — npm short-circuits when
 # the requested version is already on disk) and then runs the freshly

package/scripts/install.sh

@@ -43,6 +43,12 @@
 #   BEEOS_INSTALL_DRY_RUN=1  CI smoke-test escape hatch — return 0
 #                            from main() before any side effect.
 #   BEEOS_NO_TELEMETRY=1     Disable the script-level telemetry POSTs.
+#   BEEOS_NO_DESKTOP=1       Skip the TigerVNC pre-check (Linux) and
+#                            forwarded to `beeos init` so the CLI's
+#                            `getDesktopPipeline()` chokepoint also
+#                            short-circuits, suppressing every macOS /
+#                            Linux cold-start side effect. Mirrors
+#                            install.ps1's same-named env var.
 #   BEEOS_USE_NPX=1          Power-user throwaway install (beeos won't
 #                            persist on PATH).
 #
@@ -451,6 +457,56 @@ print_install_hints() {
   echo ""
 }
 
+# ── TigerVNC pre-check (Linux desktop streaming) ─────────────
+#
+# Mirrors install.ps1's `Test-VncServer`. BeeOS desktop streaming on
+# Linux uses TigerVNC + the `vnc-bridge` sidecar (same RFB pipeline
+# as macOS / Windows). The CLI's `LinuxDesktopPlatform` adapter takes
+# over once `beeos init` runs: it generates a viewer password,
+# writes `~/.vnc/passwd` via `tigervncpasswd -f`, mirrors plaintext
+# into `~/.beeos/vnc.password`, and starts `vncserver :1 -localhost
+# yes` if not already listening. This script's only job at install
+# time is the user-facing hint — pointing the user at the
+# distro-appropriate package so the cold-start has something to
+# configure on the next `beeos init`.
+#
+# Skipped entirely when:
+#   - $BEEOS_NO_DESKTOP = "1" (hint AND CLI desktop pipeline off)
+#   - the user invoked `--device` mode (device-attach handles its own
+#     VNC story via `--vnc-host`).
+#   - host is darwin (macOS Screen Sharing is built-in; the CLI's
+#     `MacosDesktopPlatform` cold-start handles enable + password
+#     generation, no install-time hint needed).
+#
+# Detection: command -v tigervncpasswd or vncpasswd. Both are part
+# of standard distro packages (tigervnc-standalone-server on
+# Debian/Ubuntu, tigervnc-server on Fedora/RHEL, tigervnc on Arch).
+test_vnc_server() {
+  if [[ "${BEEOS_NO_DESKTOP:-}" == "1" ]]; then
+    info "BEEOS_NO_DESKTOP=1 — skipping TigerVNC pre-check."
+    return 0
+  fi
+  if [[ "$MODE" == "device" ]]; then
+    return 0
+  fi
+  if [[ "$OS_KIND" != "linux" ]]; then
+    return 0
+  fi
+  if command -v tigervncpasswd &>/dev/null || command -v vncpasswd &>/dev/null; then
+    success "TigerVNC detected — \`beeos init\` will configure it for desktop streaming."
+    return 0
+  fi
+  echo ""
+  info "Optional: BeeOS desktop streaming on Linux uses TigerVNC."
+  echo "  Install with one of:"
+  echo "    Debian/Ubuntu:  sudo apt install tigervnc-standalone-server"
+  echo "    RHEL/Fedora:    sudo dnf install tigervnc-server"
+  echo "    Arch:           sudo pacman -S tigervnc"
+  echo ""
+  echo "  Then re-run \`beeos init\`. Set BEEOS_NO_DESKTOP=1 to suppress this hint."
+  echo ""
+}
+
 # ── Main ─────────────────────────────────────────────────────
 
 run_cli() {
@@ -559,6 +615,13 @@ main() {
 
   success "Node.js $(node -v) detected"
 
+  # Phase 3 of the multi-OS install-link refactor: TigerVNC pre-check
+  # for Linux. Parallels install.ps1's `Test-VncServer`. Silent
+  # success when the tool is on PATH; printable hint when missing.
+  # Skipped on darwin (macOS Screen Sharing is configured by the
+  # CLI's `MacosDesktopPlatform` cold-start) and in `--device` mode.
+  test_vnc_server
+
   # Bootstrap is finished. Hand off to `run_cli` which performs
   # `npm install -g @beeos-ai/cli` (idempotent — npm short-circuits
   # when the requested version is already on disk) and then `exec`s