Struct HostSessionConnector 

pub struct HostSessionConnector { /* private fields */ }

A one-shot host handoff factory, evaluated on the SDK worker’s LocalSet.

The platform host supplies this to shared toolkit bootstrap. It must verify host/app/workspace handoff authority before returning its two connections. This type neither authenticates a transport nor certifies a supplied grant. The actual brokers still enforce certified joins and live signing policy. No inherited service or app-local identity is used if the factory fails.

Consumed on both success and failure. There is no automatic reconnect. A host retry must create a fresh connector and repeat admission for the same durable identity and requested route; an old handoff must not be replayed.

Implementations

impl HostSessionConnector

pub fn new<F, Fut, C, I>(connect: F) -> HostSessionConnector

where F: FnOnce(RouteSpec) -> Fut + Send + 'static, Fut: Future<Output = Result<(C, I), NotAvailable>> + 'static, C: AsyncRead + AsyncWrite + 'static, I: AsyncRead + AsyncWrite + 'static,

Supply a factory for an owned collaboration stream and broker signer.

The factory runs only inside the SDK worker’s Tokio runtime/LocalSet and returns separate owned collaboration and identity transports. Only the factory and its captures cross threads; its future and streams may be !Send. It must authenticate both endpoints and enforce the requested route. Shared code frames and bounds every identity exchange async. Async setup is bounded by the existing shovel initialization timeout.

Merely returning metadata does not establish authentication. Do not use this constructor as a replacement for host transport/grant validation.