sshfwd 0.3.0

TUI-based SSH port forwarding manager with automatic port discovery
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74

pub mod local;

use std::path::Path;

use russh::client::Msg;
use russh::ChannelStream;
use tokio::io::{AsyncBufReadExt, BufReader, Lines};

use sshfwd_common::types::{AgentResponse, ScanResult};

use crate::error::DiscoveryError;
use crate::ssh::agent::AgentManager;
use crate::ssh::session::Session;

/// Events produced by the discovery stream.
#[derive(Debug)]
pub enum DiscoveryEvent {
    Scan(ScanResult),
    Warning(String),
    Error(DiscoveryError),
}

/// Active discovery session — reads agent stdout line by line.
pub struct DiscoveryStream {
    lines: Lines<BufReader<ChannelStream<Msg>>>,
    _session: Session, // Keep the SSH connection alive
}

impl DiscoveryStream {
    /// Deploy the agent and start the discovery stream.
    ///
    /// If `local_agent_path` is provided, uses that binary directly (development override).
    /// Otherwise, uses embedded or prebuilt binaries.
    pub async fn start(
        session: Session,
        local_agent_path: Option<&Path>,
    ) -> Result<Self, DiscoveryError> {
        let manager = AgentManager::new(session.clone());

        let stream = manager
            .deploy_and_spawn(local_agent_path)
            .await
            .map_err(DiscoveryError::Ssh)?;

        let reader = BufReader::new(stream);
        let lines = reader.lines();

        Ok(Self {
            lines,
            _session: session,
        })
    }

    /// Read the next event from the agent stream.
    /// Returns None when the stream is exhausted.
    pub async fn next_event(&mut self) -> Option<DiscoveryEvent> {
        match self.lines.next_line().await {
            Ok(Some(line)) => match serde_json::from_str::<AgentResponse>(&line) {
                Ok(AgentResponse::Ok(scan)) => Some(DiscoveryEvent::Scan(scan)),
                Ok(AgentResponse::Error(e)) => {
                    let msg = format!("agent error ({}): {}", e.kind, e.message);
                    Some(DiscoveryEvent::Warning(msg))
                }
                Err(e) => Some(DiscoveryEvent::Error(DiscoveryError::Parse(format!(
                    "{e}: {line}"
                )))),
            },
            Ok(None) => Some(DiscoveryEvent::Error(DiscoveryError::StreamEnded)),
            Err(e) => Some(DiscoveryEvent::Error(DiscoveryError::Parse(format!(
                "I/O error: {e}"
            )))),
        }
    }
}