Add list_clients WebSocket command to external API.

Lets API clients discover slave IDs and stream/notify flags before configuring per-slave accel or tap.

Co-authored-by: Cursor <cursoragent@cursor.com>

goTool/api_stream.go

@@ -92,6 +92,29 @@ type TapStreamStatusMessage struct {
 	Error      string `json:"error,omitempty"`
 }
 
+// APIClientInfo is one registered slave (or slot) from CLIENT_INFO.
+type APIClientInfo struct {
+	ID              uint32 `json:"id"`
+	MAC             string `json:"mac"`
+	Version         uint32 `json:"version"`
+	Available       bool   `json:"available"`
+	Used            bool   `json:"used"`
+	LastPing        uint32 `json:"last_ping"`
+	LastSuccessPing uint32 `json:"last_success_ping"`
+	AccelStream     bool   `json:"accel_stream"`
+	TapNotifySingle bool   `json:"tap_notify_single"`
+	TapNotifyDouble bool   `json:"tap_notify_double"`
+	TapNotifyTriple bool   `json:"tap_notify_triple"`
+}
+
+// ClientListMessage is the reply to list_clients.
+type ClientListMessage struct {
+	Type    string          `json:"type"` // "client_list"
+	Success bool            `json:"success"`
+	Clients []APIClientInfo `json:"clients,omitempty"`
+	Error   string          `json:"error,omitempty"`
+}
+
 // TapNotifyStatusMessage is the reply to set_tap_notify / get_tap_notify (slave).
 type TapNotifyStatusMessage struct {
 	Type          string `json:"type"` // "tap_notify_status"
@@ -191,6 +214,7 @@ func (h *accelStreamHub) register(conn *websocket.Conn, portName string) *wsSubs
 		TapDisplayMinMs: apiTapDisplayMinMs,
 		Note:            "set_tap_notify configures slave S/D/T only; set_tap_stream enables tap polling/push",
 		Commands: []string{
+			"list_clients",
 			"set_stream", "get_stream", "set_accel_stream", "get_accel_stream",
 			"set_tap_stream", "get_tap_stream", "set_tap_notify", "get_tap_notify",
 			"set_led_ring", "get_battery",
@@ -584,6 +608,30 @@ func writeTapStreamStatus(conn *websocket.Conn, msg TapStreamStatusMessage) {
 	_ = conn.WriteMessage(websocket.TextMessage, data)
 }
 
+func clientInfoToAPI(c *pb.ClientInfo) APIClientInfo {
+	return APIClientInfo{
+		ID:              c.GetId(),
+		MAC:             formatMAC(c.GetMac()),
+		Version:         c.GetVersion(),
+		Available:       c.GetAvailable(),
+		Used:            c.GetUsed(),
+		LastPing:        c.GetLastPing(),
+		LastSuccessPing: c.GetLastSuccessPing(),
+		AccelStream:     c.GetAccelStreamEnabled(),
+		TapNotifySingle: c.GetTapNotifySingle(),
+		TapNotifyDouble: c.GetTapNotifyDouble(),
+		TapNotifyTriple: c.GetTapNotifyTriple(),
+	}
+}
+
+func writeClientList(conn *websocket.Conn, msg ClientListMessage) {
+	data, err := json.Marshal(msg)
+	if err != nil {
+		return
+	}
+	_ = conn.WriteMessage(websocket.TextMessage, data)
+}
+
 func writeTapNotifyStatus(conn *websocket.Conn, out tapNotifyAPIResponse) {
 	msg := TapNotifyStatusMessage{
 		Type:          "tap_notify_status",
@@ -640,6 +688,25 @@ func handleAccelWSCommand(conn *websocket.Conn, sub *wsSubscriber, data []byte,
 	}
 
 	switch cmd.Type {
+	case "list_clients":
+		clients, err := link.listClientsPoll()
+		if err != nil {
+			writeClientList(conn, ClientListMessage{
+				Type:  "client_list",
+				Error: err.Error(),
+			})
+			return
+		}
+		out := make([]APIClientInfo, 0, len(clients))
+		for _, c := range clients {
+			out = append(out, clientInfoToAPI(c))
+		}
+		writeClientList(conn, ClientListMessage{
+			Type:    "client_list",
+			Success: true,
+			Clients: out,
+		})
+
 	case "set_stream":
 		if cmd.Enable == nil {
 			writeStreamStatus(conn, StreamStatusMessage{
@@ -791,7 +858,7 @@ func handleAccelWSCommand(conn *websocket.Conn, sub *wsSubscriber, data []byte,
 	default:
 		writeStreamStatus(conn, StreamStatusMessage{
 			Type: "stream_status",
-			Error: "unknown type (set_stream, get_stream, set_accel_stream, get_accel_stream, set_tap_stream, get_tap_stream, set_tap_notify, get_tap_notify, set_led_ring, get_battery)",
+			Error: "unknown type (list_clients, set_stream, get_stream, set_accel_stream, get_accel_stream, set_tap_stream, get_tap_stream, set_tap_notify, get_tap_notify, set_led_ring, get_battery)",
 		})
 	}
 }