team-telnyx · baloeng · Apr 28, 2026 · Apr 28, 2026 · Apr 28, 2026 · Apr 28, 2026
diff --git a/Makefile.am b/Makefile.am
@@ -263,6 +263,7 @@ library_include_HEADERS = \
 	src/include/switch.h \
 	src/include/switch_apr.h \
 	src/include/switch_buffer.h \
+	src/include/switch_bundle.h \
 	src/include/switch_caller.h \
 	src/include/switch_channel.h \
 	src/include/switch_console.h \
@@ -323,6 +324,7 @@ libfreeswitch_la_SOURCES = \
 	src/switch_apr.c \
 	src/switch_apr_queue.c \
 	src/switch_buffer.c \
+	src/switch_bundle.c \
 	src/switch_caller.c \
 	src/switch_channel.c \
 	src/switch_console.c \

diff --git a/docs/TEL-6738-BUNDLE-v2-design.md b/docs/TEL-6738-BUNDLE-v2-design.md
diff --git a/src/include/switch.h b/src/include/switch.h
@@ -131,6 +131,7 @@
 #include "switch_resample.h"
 #include "switch_ivr.h"
 #include "switch_rtp.h"
+#include "switch_bundle.h"
 #include "switch_log.h"
 #include "switch_xml.h"
 #include "switch_xml_config.h"

diff --git a/src/include/switch_bundle.h b/src/include/switch_bundle.h
@@ -0,0 +1,86 @@
+#ifndef SWITCH_BUNDLE_H
+#define SWITCH_BUNDLE_H
+
+#include <switch.h>
+
+SWITCH_BEGIN_EXTERN_C
+
+#define SWITCH_BUNDLE_MAX_MLINES 8
+#define SWITCH_BUNDLE_MAX_MIDS 8
+#define SWITCH_BUNDLE_MAX_MID_LEN 31
+#define SWITCH_BUNDLE_MAX_PAYLOADS 32
+#define SWITCH_BUNDLE_REJECT_REASON_LEN 128
+
+typedef enum {
+	SWITCH_BUNDLE_POLICY_OFF = 0,
+	SWITCH_BUNDLE_POLICY_AUTO,
+	SWITCH_BUNDLE_POLICY_FORCE
+} switch_bundle_policy_t;
+
+typedef enum {
+	SWITCH_BUNDLE_STATE_NONE = 0,
+	SWITCH_BUNDLE_STATE_OFFERED,
+	SWITCH_BUNDLE_STATE_ACCEPTED,
+	SWITCH_BUNDLE_STATE_REJECTED
+} switch_bundle_state_t;
+
+typedef enum {
+	SWITCH_BUNDLE_DEMUX_NONE = 0,
+	SWITCH_BUNDLE_DEMUX_MID,
+	SWITCH_BUNDLE_DEMUX_SSRC,
+	SWITCH_BUNDLE_DEMUX_PAYLOAD_TYPE
+} switch_bundle_demux_t;
+
+typedef struct switch_bundle_mline_s {
+	int mline_index;
+	switch_media_type_t media_type;
+	char mid[SWITCH_BUNDLE_MAX_MID_LEN + 1];
+	uint8_t in_bundle_group;
+	uint8_t bundle_tag;
+	uint8_t bundle_only;
+	uint8_t rtcp_mux;
+	uint8_t rtcp_mux_only;
+	uint8_t rejected;
+	uint8_t zero_port;
+	uint8_t local_mid_ext_id;
+	uint8_t remote_mid_ext_id;
+	switch_payload_t payloads[SWITCH_BUNDLE_MAX_PAYLOADS];
+	uint32_t payload_count;
+	uint32_t local_ssrc;
+	uint32_t remote_ssrc;
+} switch_bundle_mline_t;
+
+typedef struct switch_bundle_group_s {
+	switch_bundle_policy_t policy;
+	switch_bundle_state_t state;
+	uint32_t generation;
+	char offered_mids[SWITCH_BUNDLE_MAX_MIDS][SWITCH_BUNDLE_MAX_MID_LEN + 1];
+	uint32_t offered_mid_count;
+	int bundle_tag_mline_index;
+	char bundle_tag_mid[SWITCH_BUNDLE_MAX_MID_LEN + 1];
+	switch_bundle_mline_t mlines[SWITCH_BUNDLE_MAX_MLINES];
+	uint32_t mline_count;
+	char reject_reason[SWITCH_BUNDLE_REJECT_REASON_LEN];
+} switch_bundle_group_t;
+
+SWITCH_DECLARE(switch_bundle_policy_t) switch_bundle_policy_parse(const char *value, switch_bundle_policy_t dft);
+SWITCH_DECLARE(const char *) switch_bundle_policy_str(switch_bundle_policy_t policy);
+SWITCH_DECLARE(const char *) switch_bundle_state_str(switch_bundle_state_t state);
+SWITCH_DECLARE(void) switch_bundle_group_init(switch_bundle_group_t *group, switch_bundle_policy_t policy);
+SWITCH_DECLARE(void) switch_bundle_group_reset(switch_bundle_group_t *group);
+SWITCH_DECLARE(switch_status_t) switch_bundle_group_set_offered_mids(switch_bundle_group_t *group, const char *value);
+SWITCH_DECLARE(switch_bundle_mline_t *) switch_bundle_group_add_mline(switch_bundle_group_t *group, int mline_index, switch_media_type_t media_type, const char *mid, switch_port_t port, switch_bool_t rtcp_mux, switch_bool_t bundle_only, switch_bool_t rtcp_mux_only);
+SWITCH_DECLARE(switch_bundle_mline_t *) switch_bundle_group_find_mline_by_mid(switch_bundle_group_t *group, const char *mid);
+SWITCH_DECLARE(switch_bundle_mline_t *) switch_bundle_group_find_mline_by_index(switch_bundle_group_t *group, int mline_index);
+SWITCH_DECLARE(switch_status_t) switch_bundle_mline_set_remote_mid_ext(switch_bundle_mline_t *mline, uint8_t ext_id);
+SWITCH_DECLARE(switch_status_t) switch_bundle_mline_set_local_mid_ext(switch_bundle_mline_t *mline, uint8_t ext_id);
+SWITCH_DECLARE(switch_status_t) switch_bundle_mline_add_payload_type(switch_bundle_mline_t *mline, switch_payload_t pt);
+SWITCH_DECLARE(switch_status_t) switch_bundle_group_learn_remote_ssrc(switch_bundle_group_t *group, switch_bundle_mline_t *mline, uint32_t ssrc);
+SWITCH_DECLARE(switch_bool_t) switch_bundle_group_payload_type_unique(switch_bundle_group_t *group, switch_payload_t pt, switch_bundle_mline_t **mline_out);
+SWITCH_DECLARE(switch_bundle_mline_t *) switch_bundle_group_demux_rtp(switch_bundle_group_t *group, const char *mid, uint32_t ssrc, switch_payload_t pt, switch_bundle_demux_t *method);
+SWITCH_DECLARE(switch_status_t) switch_bundle_group_validate(switch_bundle_group_t *group);
+SWITCH_DECLARE(const char *) switch_bundle_group_reject_reason(const switch_bundle_group_t *group);
+
+SWITCH_END_EXTERN_C
+
+#endif
diff --git a/src/include/switch_core_media.h b/src/include/switch_core_media.h
@@ -429,6 +429,11 @@ SWITCH_DECLARE(switch_status_t) switch_core_media_unlock_video_file(switch_core_
 SWITCH_DECLARE(switch_status_t) switch_core_media_set_video_file(switch_core_session_t *session, switch_file_handle_t *fh, switch_rw_t rw);
 SWITCH_DECLARE(switch_file_handle_t *) switch_core_media_get_video_file(switch_core_session_t *session, switch_rw_t rw);
 SWITCH_DECLARE(switch_bool_t) switch_core_session_in_video_thread(switch_core_session_t *session);
+/* TEL-6738: Returns SWITCH_TRUE when this session's video engine shares the BUNDLE
+ * transport with audio (bundled_with_audio) and that shared audio RTP session is ready.
+ * Used by writers/bridge to bypass video-specific gates (e.g. CF_VIDEO_READY) on
+ * a BUNDLE leg whose underlying transport (ICE+DTLS) is already up via audio. */
+SWITCH_DECLARE(switch_bool_t) switch_core_media_video_is_bundled(switch_core_session_t *session);
 SWITCH_DECLARE(switch_bool_t) switch_core_media_check_dtls(switch_core_session_t *session, switch_media_type_t type);
 SWITCH_DECLARE(switch_status_t) switch_core_media_set_outgoing_bitrate(switch_core_session_t *session, switch_media_type_t type, uint32_t bitrate);
 SWITCH_DECLARE(uint32_t) switch_core_media_get_orig_bitrate(switch_core_session_t *session, switch_media_type_t type);

diff --git a/src/include/switch_rtp.h b/src/include/switch_rtp.h
@@ -87,14 +87,17 @@ struct switch_rtp_crypto_key {
 };
 typedef struct switch_rtp_crypto_key switch_rtp_crypto_key_t;
 
+typedef struct switch_rtp_write_state switch_rtp_write_state_t;
+
 typedef enum {
 	IPR_RTP,
 	IPR_RTCP
 } ice_proto_t;
 
 typedef struct ext_mid_s {
-	uint8_t ext_id;   /* negotiated extmap ID for MID (1-14 for 1-byte header) */
-	char mid[17];     /* MID string (max 16 bytes for 1-byte hdr format) */
+	uint8_t ext_id;      /* negotiated extmap ID for MID (1-14 for 1-byte header) */
+	char local_mid[17];  /* MID string to write (max 16 bytes for 1-byte hdr format) */
+	char remote_mid[17]; /* MID string read from the current packet (max 16 bytes for 1-byte hdr format) */
 	uint8_t enabled;
 } ext_mid_t;
 
@@ -562,6 +565,8 @@ SWITCH_DECLARE(switch_jb_t *) switch_rtp_get_jitter_buffer(switch_rtp_t *rtp_ses
   \param flags the flags to set
 */
 SWITCH_DECLARE(void) switch_rtp_set_flag(switch_rtp_t *rtp_session, switch_rtp_flag_t flag);
+SWITCH_DECLARE(void) switch_rtp_set_bundle_has_video(switch_rtp_t *rtp_session, switch_bool_t enabled);
+SWITCH_DECLARE(void) switch_rtp_set_bundle_video_ssrcs(switch_rtp_t *rtp_session, uint32_t local_ssrc, uint32_t remote_ssrc);
 SWITCH_DECLARE(void) switch_rtp_set_flags(switch_rtp_t *rtp_session, switch_rtp_flag_t flags[SWITCH_RTP_FLAG_INVALID]);
 SWITCH_DECLARE(void) switch_rtp_clear_flags(switch_rtp_t *rtp_session, switch_rtp_flag_t flags[SWITCH_RTP_FLAG_INVALID]);
 
@@ -744,8 +749,16 @@ SWITCH_DECLARE(switch_status_t) switch_rtp_offer_audio_level_extension(switch_co
   \param rtp_session the RTP session to write to
   \param frame the frame to write
   \return the number of bytes written
+  \note switch_rtp_write_frame_ex_state can use write_state to isolate
+  seq/timestamp/write-tracking state from rtp_session while sharing the
+  session socket/security context.
 */
 SWITCH_DECLARE(int) switch_rtp_write_frame(switch_rtp_t *rtp_session, switch_frame_t *frame);
+SWITCH_DECLARE(int) switch_rtp_write_frame_ex(switch_rtp_t *rtp_session, switch_frame_t *frame, uint32_t ssrc, uint8_t mid_ext_id, const char *mid);
+SWITCH_DECLARE(int) switch_rtp_write_frame_ex_state(switch_rtp_t *rtp_session, switch_frame_t *frame, switch_rtp_write_state_t *write_state,
+										   uint32_t ssrc, uint8_t mid_ext_id, const char *mid, switch_bool_t force_video, switch_payload_t payload_override);
+SWITCH_DECLARE(switch_status_t) switch_rtp_write_state_create(switch_rtp_write_state_t **write_state, switch_memory_pool_t *pool);
+SWITCH_DECLARE(void) switch_rtp_write_state_reset(switch_rtp_write_state_t *write_state);
 
 /*!
   \brief Write data with a specified payload and sequence number to a given RTP session
@@ -826,7 +839,11 @@ SWITCH_DECLARE(switch_time_t) switch_rtp_session_set_dtls_checks_started(switch_
 SWITCH_DECLARE(switch_sockaddr_t*) switch_rtp_session_get_remote_addr(switch_rtp_t *rtp_session);
 SWITCH_DECLARE(switch_sockaddr_t*) switch_rtp_session_get_rtcp_remote_addr(switch_rtp_t *rtp_session);
 SWITCH_DECLARE(char *) switch_rtp_session_get_type(switch_rtp_t *rtp_session);
+/* Enables MID receive parsing for ext_id and clears any configured local MID, so outbound MID insertion is disabled until switch_rtp_enable_mid() is called. */
+SWITCH_DECLARE(switch_status_t) switch_rtp_enable_mid_receive(switch_rtp_t *rtp_session, uint8_t ext_id);
 SWITCH_DECLARE(switch_status_t) switch_rtp_enable_mid(switch_rtp_t *rtp_session, uint8_t ext_id, const char *mid);
+/* Returns the session-owned MID parsed from the current returned RTP packet, or NULL when that packet did not carry MID. The returned pointer is overwritten by the next RTP read and must not be retained across reads or threads. */
+SWITCH_DECLARE(const char *) switch_rtp_get_received_mid(switch_rtp_t *rtp_session);
 
 
 /* Trickle ICE extensions */

diff --git a/src/include/switch_types.h b/src/include/switch_types.h
@@ -886,6 +886,7 @@ typedef enum {
 	SWITCH_RTP_FLAG_ICE_NO_RESPONSE_IGNORED,
 	SWITCH_RTP_FLAG_ICE_FAILED,
 	SWITCH_RTP_FLAG_IGNORE_RTP_DURING_DTMF,
+	SWITCH_RTP_FLAG_BUNDLE_ACCEPT_ANY_PT,
 	SWITCH_RTP_FLAG_INVALID
 } switch_rtp_flag_t;
 
@@ -2056,7 +2057,8 @@ typedef enum {
 	SWITCH_IO_FLAG_NOBLOCK = (1 << 0),
 	SWITCH_IO_FLAG_SINGLE_READ = (1 << 1),
 	SWITCH_IO_FLAG_FORCE = (1 << 2),
-	SWITCH_IO_FLAG_QUEUED = (1 << 3)
+	SWITCH_IO_FLAG_QUEUED = (1 << 3),
+	SWITCH_IO_FLAG_BUNDLE_DRAIN = (1 << 4)
 } switch_io_flag_enum_t;
 typedef uint32_t switch_io_flag_t;
 

diff --git a/src/include/switch_utils.h b/src/include/switch_utils.h
@@ -1495,6 +1495,7 @@ SWITCH_DECLARE(switch_status_t) switch_frame_buffer_push(switch_frame_buffer_t *
 SWITCH_DECLARE(switch_status_t) switch_frame_buffer_trypush(switch_frame_buffer_t *fb, void *ptr);
 SWITCH_DECLARE(switch_status_t) switch_frame_buffer_pop(switch_frame_buffer_t *fb, void **ptr);
 SWITCH_DECLARE(switch_status_t) switch_frame_buffer_trypop(switch_frame_buffer_t *fb, void **ptr);
+SWITCH_DECLARE(switch_status_t) switch_frame_buffer_pop_timeout(switch_frame_buffer_t *fb, void **ptr, switch_interval_time_t timeout);
 SWITCH_DECLARE(int) switch_frame_buffer_size(switch_frame_buffer_t *fb);
 
 typedef struct {