Struct PairingManager 

pub struct PairingManager {
    pub agent_id: String,
    /* private fields */
}

Manages one-time pairing codes for secure client registration

Fields

agent_id: String

Stable agent identity included in every pairing response.

Implementations

impl PairingManager

pub fn new_with_cf( agent_id: String, websocket_url: String, auth_token: String, cert_fingerprint: Option<String>, client_id: Option<String>, client_secret: Option<String>, cwd: String, ) -> Self

Create a new PairingManager including Cloudflare service token credentials.

agent_id is a stable UUID that will be included in the pairing response so mobile clients can deduplicate connections across transports.

pub fn with_tailscale_path(self) -> Self

Mark this manager as using Tailscale transport (emits /pair/tailscale in QR URL)

pub fn with_relay_url(self, url: String) -> Self

Set the push relay URL to include in the pairing response. Only set when push is fully configured (url + client_id both non-empty).

pub fn get_code(&self) -> &str

Get the current pairing code

pub fn get_pairing_url(&self, base_url: &str) -> String

Get the pairing URL (for QR code)

pub fn is_expired(&self) -> bool

Check if the code has expired

pub fn is_used(&self) -> bool

Check if the code has been used

pub fn seconds_remaining(&self) -> u64

Get remaining seconds until expiration

pub fn validate(&self, code: &str) -> Result<PairingResponse, PairingError>

Validate a pairing code and return connection details if valid

pub fn get_cert_fingerprint(&self) -> Option<&str>

Get the certificate fingerprint (if available)