tirtc-devtools-cli 0.3.0 → 0.3.2

package/vendor/runtime/macos-arm64/include/tirtc/audio.h

@@ -42,7 +42,11 @@ typedef enum TirtcAudioOutputState {
 } TirtcAudioOutputState;
 
 typedef struct TirtcAudioInputOptions {
-  TirtcAudioSampleRate sample_rate;
+  TirtcMediaCodec codec;
+
+  uint32_t sample_rate_hz;
+
+  uint32_t channels;
 
   TirtcAudioAecMode aec_mode;
 
@@ -61,9 +65,27 @@ typedef struct TirtcAudioInputOptions {
 typedef struct TirtcAudioEncodedInputOptions {
   TirtcMediaCodec codec;
 
-  TirtcAudioSampleRate sample_rate;
+  uint32_t sample_rate_hz;
+
+  uint32_t channels;
 } TirtcAudioEncodedInputOptions;
 
+typedef struct TirtcAudioEncodedInputFrame {
+  TirtcMediaCodec codec;
+
+  uint32_t sample_rate_hz;
+
+  uint32_t channels;
+
+  uint32_t samples_per_channel;
+
+  int64_t pts_us;
+
+  const void* data;
+
+  size_t data_bytes;
+} TirtcAudioEncodedInputFrame;
+
 typedef struct TirtcAudioOutputOptions {
   uint32_t volume_percent;
 
@@ -91,9 +113,30 @@ typedef struct TirtcPendingDurationMetrics {
   uint64_t decoded_duration_ms;
 } TirtcPendingDurationMetrics;
 
+typedef struct TirtcOutputLatencyStageMetrics {
+  uint64_t latest_ms;
+  uint64_t average_ms;
+  uint64_t peak_ms;
+  uint64_t sample_count;
+  uint64_t unavailable_count;
+} TirtcOutputLatencyStageMetrics;
+
+typedef struct TirtcOutputLocalLatencyMetrics {
+  uint32_t window_duration_ms;
+  TirtcOutputLatencyStageMetrics total;
+  TirtcOutputLatencyStageMetrics buffer;
+  TirtcOutputLatencyStageMetrics decode_or_ready;
+  TirtcOutputLatencyStageMetrics output;
+} TirtcOutputLocalLatencyMetrics;
+
 typedef struct TirtcAudioOutputMetricsSnapshot {
   TirtcOutputStutterMetrics stutter;
   TirtcPendingDurationMetrics pending;
+  double input_bitrate_kbps;
+  double input_packet_rate;
+  double render_callback_rate;
+  uint32_t rate_window_duration_ms;
+  TirtcOutputLocalLatencyMetrics local_latency;
 } TirtcAudioOutputMetricsSnapshot;
 
 /**
@@ -105,6 +148,10 @@ typedef struct TirtcAudioOutputMetricsSnapshot {
  */
 typedef struct TirtcAudioOutputDebugSnapshot {
   TirtcMediaCodec codec;
+
+  uint32_t sample_rate_hz;
+
+  uint32_t channels;
 } TirtcAudioOutputDebugSnapshot;
 
 /**
@@ -191,7 +238,7 @@ TirtcError tirtc_audio_encoded_input_attach(TirtcAudioEncodedInput* input, Tirtc
 TirtcError tirtc_audio_encoded_input_detach(TirtcAudioEncodedInput* input, TirtcConn* connection);
 
 TirtcError tirtc_audio_encoded_input_submit_frame(TirtcAudioEncodedInput* input,
-                                                  const TirtcAudioEncodedFrame* frame);
+                                                  const TirtcAudioEncodedInputFrame* frame);
 
 void tirtc_audio_encoded_input_destroy(TirtcAudioEncodedInput* input);
 

package/vendor/runtime/macos-arm64/include/tirtc/audio_codec.h

@@ -16,6 +16,12 @@ TirtcError tirtc_audio_g711a_encode(const TirtcAudioPcmFrame* pcm_frame, void* o
 TirtcError tirtc_audio_g711a_decode(const TirtcAudioEncodedFrame* in_frame, void* out_buffer,
                                     size_t out_buffer_capacity, TirtcAudioPcmFrame* out_frame);
 
+TirtcError tirtc_audio_aac_encode(const TirtcAudioPcmFrame* pcm_frame, void* out_buffer,
+                                  size_t out_buffer_capacity, TirtcAudioEncodedFrame* out_frame);
+
+TirtcError tirtc_audio_aac_decode(const TirtcAudioEncodedFrame* in_frame, void* out_buffer,
+                                  size_t out_buffer_capacity, TirtcAudioPcmFrame* out_frame);
+
 #ifdef __cplusplus
 }
 #endif

package/vendor/runtime/macos-arm64/include/tirtc/audio_format.h

@@ -0,0 +1,20 @@
+#ifndef TIRTC_MEDIA_CONTRACT_AUDIO_FORMAT_H_
+#define TIRTC_MEDIA_CONTRACT_AUDIO_FORMAT_H_
+
+#include <stdint.h>
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+typedef struct TirtcAudioFormat {
+  uint32_t sample_rate_hz;
+  uint32_t channels;
+  uint32_t bits_per_sample;
+} TirtcAudioFormat;
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif  // TIRTC_MEDIA_CONTRACT_AUDIO_FORMAT_H_

package/vendor/runtime/macos-arm64/include/tirtc/audio_frame.h

@@ -4,7 +4,7 @@
 #include <stddef.h>
 #include <stdint.h>
 
-#include "tirtc/audio_sample_rate.h"
+#include "tirtc/audio_format.h"
 #include "tirtc/media_codec.h"
 
 #ifdef __cplusplus
@@ -12,17 +12,16 @@ extern "C" {
 #endif
 
 typedef struct TirtcAudioPcmFrame {
-  TirtcAudioSampleRate sample_rate;
+  TirtcAudioFormat format;
   uint32_t samples_per_channel;
   int64_t pts_us;
-  /* Mutable PCM payload for capture, processing, and render-fill paths. */
   void* data;
   size_t data_bytes;
 } TirtcAudioPcmFrame;
 
 typedef struct TirtcAudioEncodedFrame {
   TirtcMediaCodec codec;
-  TirtcAudioSampleRate sample_rate;
+  TirtcAudioFormat format;
   uint32_t samples_per_channel;
   int64_t pts_us;
   const void* data;

package/vendor/runtime/macos-arm64/include/tirtc/audio_io.h

@@ -14,8 +14,7 @@ typedef struct TirtcAudioAin TirtcAudioAin;
 typedef struct TirtcAudioAout TirtcAudioAout;
 
 typedef struct TirtcAudioIoConfig {
-  TirtcAudioSampleRate sample_rate;
-  /* AIN uses fixed 10 ms mono blocks; AOUT may use larger callback-sized multiples. */
+  TirtcAudioFormat format;
   uint32_t samples_per_buffer;
 } TirtcAudioIoConfig;
 
@@ -29,7 +28,7 @@ typedef void (*TirtcAudioAinOnFrameFn)(TirtcAudioAin* ain, const TirtcAudioPcmFr
                                        void* user_data);
 
 /*
- * AOUT pre-fills sample_rate, samples_per_channel, data, and data_bytes before
+ * AOUT pre-fills format, samples_per_channel, data, and data_bytes before
  * calling render. The callback contract expects a non-negative rendered PCM
  * byte count. Backends defensively clamp negative returns to zero and zero-fill
  * any remaining buffer space.

package/vendor/runtime/macos-arm64/include/tirtc/audio_processing.h

@@ -2,6 +2,7 @@
 #define TIRTC_AUDIO_PROCESSING_H_
 
 #include "tirtc/audio_frame.h"
+#include "tirtc/audio_sample_rate.h"
 #include "tirtc/error.h"
 
 #ifdef __cplusplus

package/vendor/runtime/macos-arm64/include/tirtc/av.h

@@ -46,6 +46,12 @@ typedef struct TirtcVideoOutputMetricsSnapshot {
   TirtcVideoOutputStartupMetrics startup;
   TirtcOutputStutterMetrics stutter;
   TirtcPendingDurationMetrics pending;
+  double input_bitrate_kbps;
+  double input_fps;
+  double decoded_fps;
+  double render_fps;
+  uint32_t rate_window_duration_ms;
+  TirtcOutputLocalLatencyMetrics local_latency;
 } TirtcVideoOutputMetricsSnapshot;
 
 /**
@@ -53,8 +59,7 @@ typedef struct TirtcVideoOutputMetricsSnapshot {
  *
  * The snapshot is a caller-owned value copy. `resolved_decoder_backend` is the runtime route that
  * has actually locked, so AUTO fallback reports the concrete backend family instead of the request.
- * Zero values mean no current fact or only cached zero-state is available. Additive changes require
- * a new V2 struct/function instead of extending this layout.
+ * Zero values mean no current fact or only cached zero-state is available.
  */
 typedef struct TirtcVideoOutputDebugSnapshot {
   TirtcMediaCodec codec;

package/vendor/runtime/macos-arm64/include/tirtc/media_codec.h

@@ -8,6 +8,7 @@ extern "C" {
 typedef enum TirtcMediaCodec {
   TIRTC_MEDIA_CODEC_NONE = 0,
   TIRTC_MEDIA_CODEC_AUDIO_G711A = 1,
+  TIRTC_MEDIA_CODEC_AUDIO_AAC = 2,
   /* Reserved shared identifiers; concrete video implementations live outside media-contract. */
   TIRTC_MEDIA_CODEC_VIDEO_H264 = 65,
   TIRTC_MEDIA_CODEC_VIDEO_H265 = 66,

package/vendor/runtime/macos-arm64/include/tirtc/media_downlink.h

@@ -66,9 +66,30 @@ typedef struct TirtcMediaDownlinkPendingMetricsSnapshot {
   uint64_t decoded_pending_duration_ms;
 } TirtcMediaDownlinkPendingMetricsSnapshot;
 
+typedef struct TirtcMediaDownlinkLatencyStageMetricsSnapshot {
+  uint64_t latest_ms;
+  uint64_t average_ms;
+  uint64_t peak_ms;
+  uint64_t sample_count;
+  uint64_t unavailable_count;
+} TirtcMediaDownlinkLatencyStageMetricsSnapshot;
+
+typedef struct TirtcMediaDownlinkLocalLatencyMetricsSnapshot {
+  uint32_t window_duration_ms;
+  TirtcMediaDownlinkLatencyStageMetricsSnapshot total;
+  TirtcMediaDownlinkLatencyStageMetricsSnapshot buffer;
+  TirtcMediaDownlinkLatencyStageMetricsSnapshot decode_or_ready;
+  TirtcMediaDownlinkLatencyStageMetricsSnapshot output;
+} TirtcMediaDownlinkLocalLatencyMetricsSnapshot;
+
 typedef struct TirtcMediaDownlinkAudioMetricsSnapshot {
   TirtcMediaDownlinkStutterMetricsSnapshot stutter;
   TirtcMediaDownlinkPendingMetricsSnapshot pending;
+  double input_bitrate_kbps;
+  double input_packet_rate;
+  double render_callback_rate;
+  uint32_t rate_window_duration_ms;
+  TirtcMediaDownlinkLocalLatencyMetricsSnapshot local_latency;
 } TirtcMediaDownlinkAudioMetricsSnapshot;
 
 typedef struct TirtcMediaDownlinkVideoStartupMetricsSnapshot {
@@ -84,6 +105,12 @@ typedef struct TirtcMediaDownlinkVideoMetricsSnapshot {
   TirtcMediaDownlinkVideoStartupMetricsSnapshot startup;
   TirtcMediaDownlinkStutterMetricsSnapshot stutter;
   TirtcMediaDownlinkPendingMetricsSnapshot pending;
+  double input_bitrate_kbps;
+  double input_fps;
+  double decoded_fps;
+  double render_fps;
+  uint32_t rate_window_duration_ms;
+  TirtcMediaDownlinkLocalLatencyMetricsSnapshot local_latency;
 } TirtcMediaDownlinkVideoMetricsSnapshot;
 
 /**
@@ -94,6 +121,7 @@ typedef struct TirtcMediaDownlinkVideoMetricsSnapshot {
  */
 typedef struct TirtcMediaDownlinkAudioDebugSnapshot {
   TirtcMediaCodec codec;
+  TirtcAudioFormat format;
 } TirtcMediaDownlinkAudioDebugSnapshot;
 
 /**

package/vendor/runtime/macos-arm64/include/tirtc/media_uplink.h

@@ -29,7 +29,8 @@ typedef enum TirtcMediaUplinkState {
 } TirtcMediaUplinkState;
 
 typedef struct TirtcMediaUplinkAudioOptions {
-  TirtcAudioSampleRate sample_rate;
+  TirtcMediaCodec codec;
+  TirtcAudioFormat format;
   TirtcAudioAecMode aec_mode;
   TirtcAudioAgcLevel agc_level;
   TirtcAudioAnsLevel ans_level;

package/vendor/runtime/macos-arm64/include/tirtc/transport.h

@@ -139,7 +139,7 @@ typedef struct TirtcTransportConnServiceOptions {
    * This is a service-level capacity contract. It applies to the listener as a
    * whole, not to any single connection and not to any individual stream.
    *
-   * The current public contract requires a non-zero value.
+   * Set to 0 to leave the listener capacity to the active transport backend.
    */
   uint32_t max_connections;
 } TirtcTransportConnServiceOptions;

package/vendor/runtime/macos-arm64/include/tirtc/trp.h

@@ -30,6 +30,7 @@ typedef struct TirtcConnServiceStartOptions {
 
   const char* device_secret_key;
 
+  /** Set to 0 to leave accepted-connection capacity to the active backend. */
   uint32_t max_connections;
 } TirtcConnServiceStartOptions;
 

package/vendor/runtime/macos-arm64/manifest.txt

@@ -1,28 +1,29 @@
 platform=macos-arm64
 profile=full
-staged_at_utc=2026-05-07T08:41:46Z
+staged_at_utc=2026-05-13T16:33:31Z
 source_sdk=/Users/allenfeng/Development/Repositories/tirtc-nexus/tirtc-matrix/.build/sdk/macos-arm64
 
-59ba10e0b7cc679d625d3e8c536e3e234b3173091b9859956252fe3dd631b774  include/tirtc/audio.h
-6d972ccfe150a3b4f2d7f18fa92b3ade9210c1c8bb754d061ac6b7997b59e2cb  include/tirtc/audio_codec.h
-7bacbdb2d8bb10d6444036a8fef42f2a8e3ea34dfc38e165ee678d61f189db41  include/tirtc/audio_frame.h
-fb8ea35263167c33487bd3aa503c26ed2dfbf97877f7bda92c10065cd5c97c13  include/tirtc/audio_io.h
+04c3139f26d53aa2fb0a586a21ffb481a001c01e0412cd3414a952c9a9d336ba  include/tirtc/audio.h
+ce7ccffa054250a2dab0e2128e4701a66c7168e50e8c470dcff3bf609ff0959c  include/tirtc/audio_codec.h
+0b463d8adfcf45acb3f95fe3e2d94b37a26aaf37d293eb2b18274ddcb161f767  include/tirtc/audio_format.h
+7cac5b8c0cef28526ee00800fa8b0d1e60897ab971a0801899cb0333c9189fde  include/tirtc/audio_frame.h
+6daadba731521c01a3cf11c5d8b2ef797238737c939e2da3045fc83ad89af04a  include/tirtc/audio_io.h
 c2e1f31dcc75be461c577d18b1cebe32774f212d51cb4dd2a5b5a9bfe62b693e  include/tirtc/audio_io_android.h
 878bb18220ac62304ec95807f31e83e050c8dac14811f873454f9b045028694a  include/tirtc/audio_io_apple.h
 0569eb1d043ee7fa8d45ca43143eca1a22e4c4bf1507ca7e045e010a3ecbc288  include/tirtc/audio_io_harmony.h
 51cbc911fe9f9834046f0e0a1a7cdd814a8e194a615894a8b4d11f9e5f095610  include/tirtc/audio_io_windows.h
-21f60729117260a44af22c1af986ef17d22673b102b7b7a035f492d0665cce16  include/tirtc/audio_processing.h
+5acfd19fdcd8c9d96e4aee7c6f1d33a9211c0a5b0c0ab56d96e1b4dee48f3aa9  include/tirtc/audio_processing.h
 0ca7c3c630b1242f51a0fd8154097c0a332b4c816a5707090e4381719852998c  include/tirtc/audio_sample_rate.h
-58807ba56770f38f47aec995661cadf9d3c1d6ea7bfc940767f1ce67317c7546  include/tirtc/av.h
+07ca1b210a6e334c1474f25446477681472154568ecf74557cb3dc9b3a730662  include/tirtc/av.h
 b3e110ce04057d3be696b120d1abeaf6141711a1c63ca7f9bdf65ed5ec6e16d7  include/tirtc/error.h
 ae805545a9515edc9b94262e72ad2c7b7d649288166f4daeb450d8a55e82ae0b  include/tirtc/foundation/build_info.h
 7cf8b372a3d48d4de4a65a04c7f102281a7b42cebb9ec247853d3c53afb63b6a  include/tirtc/http.h
 70bbf93b84d9d1a85f376d9986de570c1f658319e1e5ab6d621f7a4d41033f5c  include/tirtc/logging.h
-7e2f7f81afe37e22f5414d9db32438edd948ff775230c3a0a17ff9ac1a0b560e  include/tirtc/media_codec.h
-ca63fe4fa0c787f20923e264e116fa6d7cb8194a227c03be4e9843d0ce5a9864  include/tirtc/media_downlink.h
-e64191a39004165cdcd11b2ca824af34d4bfe02f7ec3c3101fa9291f56488c30  include/tirtc/media_uplink.h
-93b85272f8fa606e048e40c0bd353440a46459180afcdaddd15b9a028dc26173  include/tirtc/transport.h
-b932f3e930057843751e66d6b4eb9d8440ecdfd6634fd941abbe260eccfa056c  include/tirtc/trp.h
+1419ac3fb5237d1d820bd30a6845b98aab3553463eb64e73623b64c663665f16  include/tirtc/media_codec.h
+df11627da9bfbb87cb32582701f638d2a0ff5b6b77b49a3a3bab7509c62f0613  include/tirtc/media_downlink.h
+9376af63fde915753146969291f0fefe2da6df28f7aa6310f7787048165150dc  include/tirtc/media_uplink.h
+57be6941026e7dd173e8779b2bb868532d65e41f7917aad476a31ac25c1cd6c3  include/tirtc/transport.h
+fba7954919606e507b6a074440440903665217959699da89ca9dd206772c0ef0  include/tirtc/trp.h
 92b3db6e2cb02265ad5db01881edce9d4e095b1dadf449dce5d8bb5362957e33  include/tirtc/video_codec.h
 e51379666c199588cc33279ccf52248035d1cae3d1d468b1615ebf29f0b39c9c  include/tirtc/video_frame.h
 2a02645d82c58d433c7306a9f0bcd31d0f3e560b63822f7e80919761b81a6284  include/tirtc/video_io.h
@@ -32,16 +33,16 @@ cae0bbeb884e5466a56da15182c78cc22baab6c743f349a58d3595f623333585  include/tirtc/
 65b5d24fe3a6bc2a299a2220148a153ba4eb0955a49c1c3baabf1fdfed8aabdd  include/tirtc/video_io_windows.h
 8cd6b66bea14890a665cc317f8572429b2c3e4463773f8b77c1e4dc30a4a8747  include/tirtc/video_processing.h
 5052a464a34508f117fec46aa6b836871014229d4290d7d8caac862e0165ae8f  lib/libTGTRP.a
-8db86d6714264047e8fd4086ddd7315722d675749719e6175f89eb5a636b48a1  lib/libTiRTC.a
+41d64a3a9dd5cd4f51d45be501e8df2161a59847bb599b218ac55194673189f9  lib/libTiRTC.a
 b39daee6a3d39bf0ca20c45084601133c4198de8dca848dcff6dd9c70ae99016  lib/libcrypto.a
 c052857ef315e3d61db9c862cad10709a3a6b2487dc41799cbe4d74a805de875  lib/libcrypto.dylib
-accd2ae1d507620e79a137fb3251bda8e4fd6323053c520d43cd4b2e8ae6b845  lib/libmatrix_runtime_audio.a
-22063c50d962a70929ab890ce53c4b66dc166e6e4855b77346619d6547080f1e  lib/libmatrix_runtime_facade.a
-77f99950767a60f8b950acae0988ecc4c835a599f530ad1a158de32d2131f61d  lib/libmatrix_runtime_foundation_http.a
-182c56ff2263a8c5e392e1a49adc367a438cfda61d35b93db3861689fc03ca4c  lib/libmatrix_runtime_foundation_logging.a
-fc95129eabfb9cb46e17276cf1814e60d47f67991ea97128a32e6520b5b23674  lib/libmatrix_runtime_media.a
-1d9ef883017e5a489191b02744aa81a74d4bc7ea2f1379e7e0c593b1e23ac731  lib/libmatrix_runtime_transport.a
-339c27670947c3a546eedc1464f3d88998ba74434ce8ec0d0090f28bd0a140a3  lib/libmatrix_runtime_video.a
+ae1647af1a4e6393627cf43a85fbe31e623f3854471c72259d76bdade1e3b761  lib/libmatrix_runtime_audio.a
+1d38a3842c7978cb1fea5cad8ed7c423eb9e4a267c5d608ad91197dc6095c080  lib/libmatrix_runtime_facade.a
+dbe1b38d7a35e840bc1d87873fa4da038b887f54858c57c2f123da70d24b25ce  lib/libmatrix_runtime_foundation_http.a
+5ef6101d4e2f38911a2bace0da43f589a43257106a9bb771940e0452e73c0ea0  lib/libmatrix_runtime_foundation_logging.a
+a9ec001d09dbb0ce6074b25486cdb2f0441a701cdedf0c7041f902e6c928f02d  lib/libmatrix_runtime_media.a
+affb2fba91a51761ad79ff58805cfc96313376bf47867d12904b57360a340ed4  lib/libmatrix_runtime_transport.a
+7286f29400c06bdd72a4176ab23b7782ad07dd78bbc8f8026d3a5b0dbe626625  lib/libmatrix_runtime_video.a
 c11c65d373a127028350c41fa58cd2d1223f2b5d70a84e13b115d90daaba25ca  lib/libssl.a
 ef1c1104bbdd2528ed7b958fb7252bd6249875f92300b0c9577d6c4bd6c0d88a  lib/libssl.dylib
 e14e846e43d64e240fa0e5745bf4e702b79d0f2442e7f768beb990610735c71b  lib/libtgrtc.dylib