Struct TransportSession 

pub struct TransportSession {
    pub session_id: String,
    pub tool: CliTool,
    /* private fields */
}

Thin dispatch router for spawning any of the 4 supported PIPE-mode CLI agents.

All four CLIs (Claude Code, Codex, Gemini, OpenCode) use the Pipe transport. PTY-mode sessions use PtySession directly — there is no PTY routing through TransportSession.

Fields

session_id: String

Gate4agent-assigned session ID (not the CLI-native session ID).

tool: CliTool

The CLI tool that was spawned.

Implementations

impl TransportSession

pub async fn spawn( tool: CliTool, working_dir: &Path, prompt: &str, options: SpawnOptions, ) -> Result<Self, AgentError>

Spawn a new pipe session for the given tool and deliver the initial prompt.

All four CliTool variants use the Pipe transport. PTY mode is not dispatched here — use PtySession::spawn directly.

Errors

• AgentError::Spawn — the child process failed to start

pub fn subscribe(&self) -> Receiver<AgentEvent>

Subscribe to all future AgentEvent values from this session.

Events emitted before this call are not replayed. Subscribe before awaiting spawn if you need the Started event.

pub fn session_id(&self) -> &str

Gate4agent-assigned session ID (not the CLI-native session ID).

pub async fn send_prompt(&self, prompt: &str) -> Result<(), AgentError>

Send a follow-up prompt via stdin (for CLIs that support multi-turn pipe mode).

Currently only Claude Code supports multi-turn pipe sessions. For other CLIs this will write to stdin but may have no effect.

pub async fn kill(&self) -> Result<(), AgentError>

Kill the underlying process.