tmux.Session.Attach

Attach attaches the caller's terminal to this session's stable identifier and blocks until detach or context cancellation. It validates the receiver's stable SessionID, retains but never closes caller-supplied streams, and returns CommandError for a completed nonzero exit. Cancellation does not prove attachment or detachment did not occur.