Skip to main content

Module surfaces

Module surfaces 

Source
Expand description

Cross-surface probes: SSH, box CLI, status-api, MCP (PC + box).

One report powers TUI tabs, horto-os-ui surfaces, and Desktop Connection.

Structsยง

ApiSurfaceProbe
Status-api HTTP (+ optional unit via SSH).
CliSurfaceProbe
Box CLI probe row.
McpHostProbe
MCP readiness on one host (PC or box): stdio runtime + HTTP.
SshSurfaceProbe
SSH reachability / key auth.
SurfaceProbeReport
Full surface probe for tip + box.

Constantsยง

DEFAULT_MCP_IMAGE ๐Ÿ”’
Default MCP image tag (matches docker/cursor-mcp-stdio.sh).
HTTP_TIMEOUT ๐Ÿ”’
MCP_HTTP_PORT ๐Ÿ”’
STATUS_API_PORT ๐Ÿ”’

Functionsยง

empty_dash ๐Ÿ”’
find_mcp_binary ๐Ÿ”’
find_mcp_docker ๐Ÿ”’
finish_http_get ๐Ÿ”’
format_mcp_host_line ๐Ÿ”’
format_surfaces_report
Human-readable multi-line report (CLI surfaces).
http_get_label
Minimal HTTP/1.0 GET label for probes (no extra HTTP crate).
local_api_token_path
Path to the local tip API token file (UI display only).
local_pgrep_mcp ๐Ÿ”’
mcp_image_name ๐Ÿ”’
probe_api_row ๐Ÿ”’
probe_api_surface
Probe status-api only.
probe_cli_row ๐Ÿ”’
probe_cli_surface
Probe box CLI only.
probe_mcp_box ๐Ÿ”’
probe_mcp_pc ๐Ÿ”’
probe_mcp_surface
Probe MCP PC + box only.
probe_ssh_access
BatchMode SSH true against the box (no password prompt).
probe_ssh_surface
Probe SSH only (BatchMode).
probe_surfaces
Probe all surfaces for a remote host, or loopback when embedded.
read_local_api_token
Read local tip bearer when present (hex only).
ssh_mcp_binary ๐Ÿ”’
ssh_mcp_docker ๐Ÿ”’
ssh_pgrep_mcp ๐Ÿ”’
ssh_systemctl_active ๐Ÿ”’
tcp_http_get ๐Ÿ”’