APP-14871: Report WebRTC connection metadata after dialing

Port of the Go SDK's WebRTC dial telemetry (goutils#583) for the
Python/C++ SDKs. After a WebRTC dial finishes — success or failure —
the client best-effort reports to the signaling server it dialed
through: the furthest dial stage reached, the gRPC failure code, the
dial duration, how the dial was signaled (cloud vs local), the
selected ICE candidate pair per side (host/stun/relay + relay
address), and the SDK type/version.

Proto stubs generated from the goutils PR branch; regenerate with
`make buf` once goutils#583 lands on the BSR.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

Author: danielbotros

src/gen/proto.rpc.webrtc.v1.rs

@@ -375,4 +375,210 @@ pub struct OptionalWebRtcConfigResponse {
     #[prost(message, optional, tag="1")]
     pub config: ::core::option::Option<WebRtcConfig>,
 }
+/// ConnectionCandidate describes the selected ICE candidate for one side of a WebRTC connection.
+#[allow(clippy::derive_partial_eq_without_eq)]
+#[derive(Clone, PartialEq, ::prost::Message)]
+pub struct ConnectionCandidate {
+    #[prost(enumeration="IceCandidateType", tag="1")]
+    pub r#type: i32,
+    /// relay_address is the relay server address of this candidate; set only when type is
+    /// RELAY, so the signaling server can classify the provider by matching against known
+    /// coturn addresses.
+    #[prost(string, tag="2")]
+    pub relay_address: ::prost::alloc::string::String,
+}
+/// ReportConnectionMetadataRequest reports metadata about a WebRTC dial, per side: local is the
+/// dialing SDK and remote is the robot.
+#[allow(clippy::derive_partial_eq_without_eq)]
+#[derive(Clone, PartialEq, ::prost::Message)]
+pub struct ReportConnectionMetadataRequest {
+    #[prost(message, optional, tag="1")]
+    pub local: ::core::option::Option<ConnectionCandidate>,
+    #[prost(message, optional, tag="2")]
+    pub remote: ::core::option::Option<ConnectionCandidate>,
+    #[prost(enumeration="SdkType", tag="3")]
+    pub sdk_type: i32,
+    /// reached_stage is the furthest dial checkpoint reached. READY indicates success; any earlier
+    /// value is where a failed dial stopped.
+    #[prost(enumeration="DialStage", tag="4")]
+    pub reached_stage: i32,
+    /// duration_ms is the wall-clock time from dial start to connection ready or to the failure.
+    #[prost(uint32, tag="5")]
+    pub duration_ms: u32,
+    /// signaling_path is how the dial was signaled (cloud / local / mDNS); reported regardless of outcome.
+    #[prost(enumeration="ConnectionSignalingPath", tag="6")]
+    pub signaling_path: i32,
+    /// failure_code is the gRPC status code of a failed dial
+    #[prost(int32, tag="7")]
+    pub failure_code: i32,
+    /// sdk_version is the version of the dialing SDK (e.g. a semver or git tag).
+    #[prost(string, tag="8")]
+    pub sdk_version: ::prost::alloc::string::String,
+}
+/// ReportConnectionMetadataResponse is empty.
+#[allow(clippy::derive_partial_eq_without_eq)]
+#[derive(Clone, PartialEq, ::prost::Message)]
+pub struct ReportConnectionMetadataResponse {
+}
+/// ICECandidateType represents the type of ICE candidate selected for a WebRTC connection.
+/// The signaling server further classifies RELAY by relay server specific provider from the address.
+#[derive(Clone, Copy, Debug, PartialEq, Eq, Hash, PartialOrd, Ord, ::prost::Enumeration)]
+#[repr(i32)]
+pub enum IceCandidateType {
+    Unspecified = 0,
+    /// ICE_CANDIDATE_TYPE_HOST indicates a direct connection was established.
+    Host = 1,
+    /// ICE_CANDIDATE_TYPE_STUN indicates a STUN-assisted connection was established.
+    Stun = 2,
+    /// ICE_CANDIDATE_TYPE_RELAY indicates a TURN relay candidate was selected.
+    Relay = 3,
+}
+impl IceCandidateType {
+    /// String value of the enum field names used in the ProtoBuf definition.
+    ///
+    /// The values are not transformed in any way and thus are considered stable
+    /// (if the ProtoBuf definition does not change) and safe for programmatic use.
+    pub fn as_str_name(&self) -> &'static str {
+        match self {
+            IceCandidateType::Unspecified => "ICE_CANDIDATE_TYPE_UNSPECIFIED",
+            IceCandidateType::Host => "ICE_CANDIDATE_TYPE_HOST",
+            IceCandidateType::Stun => "ICE_CANDIDATE_TYPE_STUN",
+            IceCandidateType::Relay => "ICE_CANDIDATE_TYPE_RELAY",
+        }
+    }
+    /// Creates an enum from field names used in the ProtoBuf definition.
+    pub fn from_str_name(value: &str) -> ::core::option::Option<Self> {
+        match value {
+            "ICE_CANDIDATE_TYPE_UNSPECIFIED" => Some(Self::Unspecified),
+            "ICE_CANDIDATE_TYPE_HOST" => Some(Self::Host),
+            "ICE_CANDIDATE_TYPE_STUN" => Some(Self::Stun),
+            "ICE_CANDIDATE_TYPE_RELAY" => Some(Self::Relay),
+            _ => None,
+        }
+    }
+}
+/// SDKType represents the Viam SDK used to establish the connection.
+#[derive(Clone, Copy, Debug, PartialEq, Eq, Hash, PartialOrd, Ord, ::prost::Enumeration)]
+#[repr(i32)]
+pub enum SdkType {
+    Unspecified = 0,
+    Go = 1,
+    Typescript = 2,
+    PythonCpp = 3,
+}
+impl SdkType {
+    /// String value of the enum field names used in the ProtoBuf definition.
+    ///
+    /// The values are not transformed in any way and thus are considered stable
+    /// (if the ProtoBuf definition does not change) and safe for programmatic use.
+    pub fn as_str_name(&self) -> &'static str {
+        match self {
+            SdkType::Unspecified => "SDK_TYPE_UNSPECIFIED",
+            SdkType::Go => "SDK_TYPE_GO",
+            SdkType::Typescript => "SDK_TYPE_TYPESCRIPT",
+            SdkType::PythonCpp => "SDK_TYPE_PYTHON_CPP",
+        }
+    }
+    /// Creates an enum from field names used in the ProtoBuf definition.
+    pub fn from_str_name(value: &str) -> ::core::option::Option<Self> {
+        match value {
+            "SDK_TYPE_UNSPECIFIED" => Some(Self::Unspecified),
+            "SDK_TYPE_GO" => Some(Self::Go),
+            "SDK_TYPE_TYPESCRIPT" => Some(Self::Typescript),
+            "SDK_TYPE_PYTHON_CPP" => Some(Self::PythonCpp),
+            _ => None,
+        }
+    }
+}
+/// DialStage is the furthest checkpoint a WebRTC dial reached. READY means the dial succeeded; any
+/// earlier value is the stage at which a failed dial stopped.
+#[derive(Clone, Copy, Debug, PartialEq, Eq, Hash, PartialOrd, Ord, ::prost::Enumeration)]
+#[repr(i32)]
+pub enum DialStage {
+    Unspecified = 0,
+    /// DIAL_STAGE_SIGNALING_CONNECTED: the signaling channel was established.
+    SignalingConnected = 1,
+    /// DIAL_STAGE_CONFIG_FETCHED: ICE/TURN configuration was fetched from the signaling server.
+    ConfigFetched = 2,
+    /// DIAL_STAGE_OFFER_SENT: the SDP offer was sent to the signaling server (the Call was accepted).
+    OfferSent = 3,
+    /// DIAL_STAGE_ANSWER_RECEIVED: the answerer's SDP answer was received and applied.
+    AnswerReceived = 4,
+    /// DIAL_STAGE_ICE_CONNECTED: ICE connectivity was established (a candidate pair connected).
+    IceConnected = 5,
+    /// DIAL_STAGE_DTLS_CONNECTED: the DTLS handshake completed (peer connection connected) but the
+    /// data channel is not yet open.
+    DtlsConnected = 6,
+    /// DIAL_STAGE_READY: the connection is fully ready (data channel open). This is success.
+    Ready = 7,
+}
+impl DialStage {
+    /// String value of the enum field names used in the ProtoBuf definition.
+    ///
+    /// The values are not transformed in any way and thus are considered stable
+    /// (if the ProtoBuf definition does not change) and safe for programmatic use.
+    pub fn as_str_name(&self) -> &'static str {
+        match self {
+            DialStage::Unspecified => "DIAL_STAGE_UNSPECIFIED",
+            DialStage::SignalingConnected => "DIAL_STAGE_SIGNALING_CONNECTED",
+            DialStage::ConfigFetched => "DIAL_STAGE_CONFIG_FETCHED",
+            DialStage::OfferSent => "DIAL_STAGE_OFFER_SENT",
+            DialStage::AnswerReceived => "DIAL_STAGE_ANSWER_RECEIVED",
+            DialStage::IceConnected => "DIAL_STAGE_ICE_CONNECTED",
+            DialStage::DtlsConnected => "DIAL_STAGE_DTLS_CONNECTED",
+            DialStage::Ready => "DIAL_STAGE_READY",
+        }
+    }
+    /// Creates an enum from field names used in the ProtoBuf definition.
+    pub fn from_str_name(value: &str) -> ::core::option::Option<Self> {
+        match value {
+            "DIAL_STAGE_UNSPECIFIED" => Some(Self::Unspecified),
+            "DIAL_STAGE_SIGNALING_CONNECTED" => Some(Self::SignalingConnected),
+            "DIAL_STAGE_CONFIG_FETCHED" => Some(Self::ConfigFetched),
+            "DIAL_STAGE_OFFER_SENT" => Some(Self::OfferSent),
+            "DIAL_STAGE_ANSWER_RECEIVED" => Some(Self::AnswerReceived),
+            "DIAL_STAGE_ICE_CONNECTED" => Some(Self::IceConnected),
+            "DIAL_STAGE_DTLS_CONNECTED" => Some(Self::DtlsConnected),
+            "DIAL_STAGE_READY" => Some(Self::Ready),
+            _ => None,
+        }
+    }
+}
+/// ConnectionSignalingPath is how a WebRTC dial was signaled, derived from the signaling address.
+#[derive(Clone, Copy, Debug, PartialEq, Eq, Hash, PartialOrd, Ord, ::prost::Enumeration)]
+#[repr(i32)]
+pub enum ConnectionSignalingPath {
+    Unspecified = 0,
+    /// CONNECTION_SIGNALING_PATH_CLOUD_SIGNALED: signaled through app's signaling server.
+    CloudSignaled = 1,
+    /// CONNECTION_SIGNALING_PATH_MDNS_LOCAL: signaled over an mDNS-discovered local-network path.
+    MdnsLocal = 2,
+    /// CONNECTION_SIGNALING_PATH_LOCAL: signaled through a loopback/private-address signaling server
+    /// (e.g. a machine's own signaling server) without mDNS discovery.
+    Local = 3,
+}
+impl ConnectionSignalingPath {
+    /// String value of the enum field names used in the ProtoBuf definition.
+    ///
+    /// The values are not transformed in any way and thus are considered stable
+    /// (if the ProtoBuf definition does not change) and safe for programmatic use.
+    pub fn as_str_name(&self) -> &'static str {
+        match self {
+            ConnectionSignalingPath::Unspecified => "CONNECTION_SIGNALING_PATH_UNSPECIFIED",
+            ConnectionSignalingPath::CloudSignaled => "CONNECTION_SIGNALING_PATH_CLOUD_SIGNALED",
+            ConnectionSignalingPath::MdnsLocal => "CONNECTION_SIGNALING_PATH_MDNS_LOCAL",
+            ConnectionSignalingPath::Local => "CONNECTION_SIGNALING_PATH_LOCAL",
+        }
+    }
+    /// Creates an enum from field names used in the ProtoBuf definition.
+    pub fn from_str_name(value: &str) -> ::core::option::Option<Self> {
+        match value {
+            "CONNECTION_SIGNALING_PATH_UNSPECIFIED" => Some(Self::Unspecified),
+            "CONNECTION_SIGNALING_PATH_CLOUD_SIGNALED" => Some(Self::CloudSignaled),
+            "CONNECTION_SIGNALING_PATH_MDNS_LOCAL" => Some(Self::MdnsLocal),
+            "CONNECTION_SIGNALING_PATH_LOCAL" => Some(Self::Local),
+            _ => None,
+        }
+    }
+}
 // @@protoc_insertion_point(module)

src/gen/proto.rpc.webrtc.v1.tonic.rs

@@ -193,6 +193,36 @@ pub mod signaling_service_client {
                 );
             self.inner.unary(req, path, codec).await
         }
+        pub async fn report_connection_metadata(
+            &mut self,
+            request: impl tonic::IntoRequest<super::ReportConnectionMetadataRequest>,
+        ) -> std::result::Result<
+            tonic::Response<super::ReportConnectionMetadataResponse>,
+            tonic::Status,
+        > {
+            self.inner
+                .ready()
+                .await
+                .map_err(|e| {
+                    tonic::Status::new(
+                        tonic::Code::Unknown,
+                        format!("Service was not ready: {}", e.into()),
+                    )
+                })?;
+            let codec = tonic::codec::ProstCodec::default();
+            let path = http::uri::PathAndQuery::from_static(
+                "/proto.rpc.webrtc.v1.SignalingService/ReportConnectionMetadata",
+            );
+            let mut req = request.into_request();
+            req.extensions_mut()
+                .insert(
+                    GrpcMethod::new(
+                        "proto.rpc.webrtc.v1.SignalingService",
+                        "ReportConnectionMetadata",
+                    ),
+                );
+            self.inner.unary(req, path, codec).await
+        }
     }
 }
 /// Generated server implementations.
@@ -236,6 +266,13 @@ pub mod signaling_service_server {
             tonic::Response<super::OptionalWebRtcConfigResponse>,
             tonic::Status,
         >;
+        async fn report_connection_metadata(
+            &self,
+            request: tonic::Request<super::ReportConnectionMetadataRequest>,
+        ) -> std::result::Result<
+            tonic::Response<super::ReportConnectionMetadataResponse>,
+            tonic::Status,
+        >;
     }
     #[derive(Debug)]
     pub struct SignalingServiceServer<T: SignalingService> {
@@ -498,6 +535,54 @@ pub mod signaling_service_server {
                     };
                     Box::pin(fut)
                 }
+                "/proto.rpc.webrtc.v1.SignalingService/ReportConnectionMetadata" => {
+                    #[allow(non_camel_case_types)]
+                    struct ReportConnectionMetadataSvc<T: SignalingService>(pub Arc<T>);
+                    impl<
+                        T: SignalingService,
+                    > tonic::server::UnaryService<super::ReportConnectionMetadataRequest>
+                    for ReportConnectionMetadataSvc<T> {
+                        type Response = super::ReportConnectionMetadataResponse;
+                        type Future = BoxFuture<
+                            tonic::Response<Self::Response>,
+                            tonic::Status,
+                        >;
+                        fn call(
+                            &mut self,
+                            request: tonic::Request<
+                                super::ReportConnectionMetadataRequest,
+                            >,
+                        ) -> Self::Future {
+                            let inner = Arc::clone(&self.0);
+                            let fut = async move {
+                                (*inner).report_connection_metadata(request).await
+                            };
+                            Box::pin(fut)
+                        }
+                    }
+                    let accept_compression_encodings = self.accept_compression_encodings;
+                    let send_compression_encodings = self.send_compression_encodings;
+                    let max_decoding_message_size = self.max_decoding_message_size;
+                    let max_encoding_message_size = self.max_encoding_message_size;
+                    let inner = self.inner.clone();
+                    let fut = async move {
+                        let inner = inner.0;
+                        let method = ReportConnectionMetadataSvc(inner);
+                        let codec = tonic::codec::ProstCodec::default();
+                        let mut grpc = tonic::server::Grpc::new(codec)
+                            .apply_compression_config(
+                                accept_compression_encodings,
+                                send_compression_encodings,
+                            )
+                            .apply_max_message_size_config(
+                                max_decoding_message_size,
+                                max_encoding_message_size,
+                            );
+                        let res = grpc.unary(method, req).await;
+                        Ok(res)
+                    };
+                    Box::pin(fut)
+                }
                 _ => {
                     Box::pin(async move {
                         Ok(