tirtc-devtools-cli 0.3.0 → 0.3.1

package/README.md

@@ -65,8 +65,9 @@ prepared asset 会按完整音视频轨循环，任一轨到达源文件末尾
 `device start` 的启动成功条件是 device listener 已就绪；客户端是否已经扫码连接不属于
 device 启动失败条件。没有 client 时命令会继续常驻，直到用户结束进程或显式
 `--duration-ms` 到期，summary 中 `media_send` 会保持未开始或标记为跳过。有 client
-连接时 driver 会为该连接送流；client 断开后，device 继续等待下一次连接，并为新连接
-重新挂载音视频输入和从源资产开头送出新的音视频包。同一时刻最多接受一个 client。
+连接时 driver 会把该连接挂到共享音视频输入上；client 断开后，device 会清理该连接，
+并继续接受新的连接。若旧连接的断开回调尚未到达，新连接也会立即挂载并收到同一组
+音视频输入的数据。
 
 native role 失败时，`reason_code` 与 `failed_stage` 仍是主失败事实；`log_upload`
 只说明失败现场日志是否已上传。上传成功时，CLI JSON 与 `summary.json` 会包含

package/dist/cli/src/role_live_log.js

@@ -83,7 +83,7 @@ function startRoleLiveLog(options) {
     let processedLineCount = 0;
     let stopped = false;
     const log = (message) => {
-        emit('[device] ' + message);
+        emit(new Date().toISOString() + ' [device] ' + message);
     };
     const media = nestedRecord(request, 'media');
     const codec = payloadString(nestedRecord(media, 'video'), 'codec') ??
@@ -145,6 +145,15 @@ function startRoleLiveLog(options) {
                 log('client connected session=' + (session ?? 'unknown'));
                 break;
             }
+            case 'connection.state.changed': {
+                const parts = ['connection state changed'];
+                appendField(parts, 'session', sessionIndex(payload));
+                appendField(parts, 'state', payloadString(payload, 'state'));
+                appendField(parts, 'state_code', payloadNumber(payload, 'state_code'));
+                appendField(parts, 'error', payloadNumber(payload, 'error'));
+                log(parts.join(' '));
+                break;
+            }
             case 'connection.session.start': {
                 const session = sessionIndex(payload);
                 if (session !== undefined) {
@@ -219,6 +228,9 @@ function startRoleLiveLog(options) {
                 appendField(parts, 'session', session);
                 appendField(parts, 'first_audio', payloadBoolean(payload, 'sent_first_audio'));
                 appendField(parts, 'first_video', payloadBoolean(payload, 'sent_first_video'));
+                appendField(parts, 'exit_reason', payloadString(payload, 'exit_reason'));
+                appendField(parts, 'submit_error_track', payloadString(payload, 'submit_error_track'));
+                appendField(parts, 'submit_error_status', payloadNumber(payload, 'submit_error_status'));
                 appendField(parts, 'elapsed', elapsed === undefined ? undefined : formatDurationMs(elapsed));
                 log(parts.join(' '));
                 break;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tirtc-devtools-cli",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "private": false,
   "main": "dist/cli/src/index.js",
   "types": "dist/cli/src/index.d.ts",

package/vendor/runtime/linux-x64/include/tirtc/audio.h

@@ -94,6 +94,10 @@ typedef struct TirtcPendingDurationMetrics {
 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;
 } TirtcAudioOutputMetricsSnapshot;
 
 /**

package/vendor/runtime/linux-x64/include/tirtc/av.h

@@ -46,6 +46,11 @@ 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;
 } TirtcVideoOutputMetricsSnapshot;
 
 /**
@@ -53,8 +58,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/linux-x64/include/tirtc/media_downlink.h

@@ -69,6 +69,10 @@ typedef struct TirtcMediaDownlinkPendingMetricsSnapshot {
 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;
 } TirtcMediaDownlinkAudioMetricsSnapshot;
 
 typedef struct TirtcMediaDownlinkVideoStartupMetricsSnapshot {
@@ -84,6 +88,11 @@ 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;
 } TirtcMediaDownlinkVideoMetricsSnapshot;
 
 /**

package/vendor/runtime/linux-x64/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/linux-x64/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/linux-x64/manifest.txt

@@ -1,9 +1,9 @@
 platform=linux-x64
 profile=full
-staged_at_utc=2026-05-07T08:43:43Z
+staged_at_utc=2026-05-09T08:58:54Z
 source_sdk=/Users/allenfeng/Development/Repositories/tirtc-nexus/tirtc-matrix/.build/sdk/linux-x64
 
-59ba10e0b7cc679d625d3e8c536e3e234b3173091b9859956252fe3dd631b774  include/tirtc/audio.h
+92ac54ea714e5a7da536d3d63b955a9e30faf9560ebe670034a79f3ea69c21cb  include/tirtc/audio.h
 6d972ccfe150a3b4f2d7f18fa92b3ade9210c1c8bb754d061ac6b7997b59e2cb  include/tirtc/audio_codec.h
 7bacbdb2d8bb10d6444036a8fef42f2a8e3ea34dfc38e165ee678d61f189db41  include/tirtc/audio_frame.h
 fb8ea35263167c33487bd3aa503c26ed2dfbf97877f7bda92c10065cd5c97c13  include/tirtc/audio_io.h
@@ -13,16 +13,16 @@ c2e1f31dcc75be461c577d18b1cebe32774f212d51cb4dd2a5b5a9bfe62b693e  include/tirtc/
 51cbc911fe9f9834046f0e0a1a7cdd814a8e194a615894a8b4d11f9e5f095610  include/tirtc/audio_io_windows.h
 21f60729117260a44af22c1af986ef17d22673b102b7b7a035f492d0665cce16  include/tirtc/audio_processing.h
 0ca7c3c630b1242f51a0fd8154097c0a332b4c816a5707090e4381719852998c  include/tirtc/audio_sample_rate.h
-58807ba56770f38f47aec995661cadf9d3c1d6ea7bfc940767f1ce67317c7546  include/tirtc/av.h
+f40ce007241e4aa6ef2e2bcd589060636ef0e9859a9102c8b955d348f4f7eabc  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
+43c0ac9173b6259a1b1379eac780f4892a0a72572801ac9eb8516c0bdb4913c3  include/tirtc/media_downlink.h
 e64191a39004165cdcd11b2ca824af34d4bfe02f7ec3c3101fa9291f56488c30  include/tirtc/media_uplink.h
-93b85272f8fa606e048e40c0bd353440a46459180afcdaddd15b9a028dc26173  include/tirtc/transport.h
-b932f3e930057843751e66d6b4eb9d8440ecdfd6634fd941abbe260eccfa056c  include/tirtc/trp.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
@@ -34,12 +34,12 @@ cae0bbeb884e5466a56da15182c78cc22baab6c743f349a58d3595f623333585  include/tirtc/
 ceb7cdd45efae57e5bd53d4177cb20c4a0cb9917fcdd23127b050d69c8b919ac  lib/libTiRTC.a
 b1f4135025cb8e8520a14268d831b9998920a4239f84bb6b409d0e4909fd5bee  lib/libcrypto.a
 296ba0b5efa9d2ac49e3bf278c5d467b31436e73fbc608b736e974bcf9759bde  lib/libmatrix_runtime_audio.a
-695c398eabef4f4227f1e7d7c8a46f3854b66e90d981d2580b664bf244977417  lib/libmatrix_runtime_facade.a
+8552aba878ffb4c242e4af589784fafbdd938291663af750aaa94d902cba72ce  lib/libmatrix_runtime_facade.a
 ec7bbf8e8744c6645a441a28e24e0645906152cc987d6fcca16af3c3badba940  lib/libmatrix_runtime_foundation_http.a
-e41012346b8200eb6a722afc2e916f6365d32698768e1d176874a23add644b2c  lib/libmatrix_runtime_foundation_logging.a
-357a15ebff6afcf0c97073d19624434e62454ed463212d0d0298af2f370a7742  lib/libmatrix_runtime_media.a
-41baae4526a1798e154c0e158a9539adc417d06e0e8193adab0c1a85cf784501  lib/libmatrix_runtime_transport.a
-59476bb5dc78b9c89cb0663fe4490ad260625332fdc68cd83a3d52abf0f31b10  lib/libmatrix_runtime_video.a
+b4f225727bf9c829c3329054112ab56477f1cc5729be1eb4952a85b649ba0a8a  lib/libmatrix_runtime_foundation_logging.a
+031927b01cee74366cf2662559c2ddfe8476531c4af7c549f311503d4da6f424  lib/libmatrix_runtime_media.a
+4942f5c742a6013e35708f6dd1e5b8ca702454990f1785e82d734aaea6ab114d  lib/libmatrix_runtime_transport.a
+774e8ae6c5e96ff5976bf440bc259044157c51e0b1dab0e77e5e087b7d059f01  lib/libmatrix_runtime_video.a
 511d521f7972df3993e5976d6e2dbcad7a6fbce9be15071274d0cbd9d51157f5  lib/libssl.a
 a67ec9034848ef24a1b17671e444daa62a8f9e6b8319a1e932593908720ff2a1  lib/libwebrtc_apm.a
 700e455255897e3cffab13ca593a6e4d9d11383ae609215cbbd6043a63d47161  lib/libxlog.a

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

@@ -94,6 +94,10 @@ typedef struct TirtcPendingDurationMetrics {
 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;
 } TirtcAudioOutputMetricsSnapshot;
 
 /**

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

@@ -46,6 +46,11 @@ 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;
 } TirtcVideoOutputMetricsSnapshot;
 
 /**
@@ -53,8 +58,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_downlink.h

@@ -69,6 +69,10 @@ typedef struct TirtcMediaDownlinkPendingMetricsSnapshot {
 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;
 } TirtcMediaDownlinkAudioMetricsSnapshot;
 
 typedef struct TirtcMediaDownlinkVideoStartupMetricsSnapshot {
@@ -84,6 +88,11 @@ 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;
 } TirtcMediaDownlinkVideoMetricsSnapshot;
 
 /**

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,9 +1,9 @@
 platform=macos-arm64
 profile=full
-staged_at_utc=2026-05-07T08:41:46Z
+staged_at_utc=2026-05-09T08:57:10Z
 source_sdk=/Users/allenfeng/Development/Repositories/tirtc-nexus/tirtc-matrix/.build/sdk/macos-arm64
 
-59ba10e0b7cc679d625d3e8c536e3e234b3173091b9859956252fe3dd631b774  include/tirtc/audio.h
+92ac54ea714e5a7da536d3d63b955a9e30faf9560ebe670034a79f3ea69c21cb  include/tirtc/audio.h
 6d972ccfe150a3b4f2d7f18fa92b3ade9210c1c8bb754d061ac6b7997b59e2cb  include/tirtc/audio_codec.h
 7bacbdb2d8bb10d6444036a8fef42f2a8e3ea34dfc38e165ee678d61f189db41  include/tirtc/audio_frame.h
 fb8ea35263167c33487bd3aa503c26ed2dfbf97877f7bda92c10065cd5c97c13  include/tirtc/audio_io.h
@@ -13,16 +13,16 @@ c2e1f31dcc75be461c577d18b1cebe32774f212d51cb4dd2a5b5a9bfe62b693e  include/tirtc/
 51cbc911fe9f9834046f0e0a1a7cdd814a8e194a615894a8b4d11f9e5f095610  include/tirtc/audio_io_windows.h
 21f60729117260a44af22c1af986ef17d22673b102b7b7a035f492d0665cce16  include/tirtc/audio_processing.h
 0ca7c3c630b1242f51a0fd8154097c0a332b4c816a5707090e4381719852998c  include/tirtc/audio_sample_rate.h
-58807ba56770f38f47aec995661cadf9d3c1d6ea7bfc940767f1ce67317c7546  include/tirtc/av.h
+f40ce007241e4aa6ef2e2bcd589060636ef0e9859a9102c8b955d348f4f7eabc  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
+43c0ac9173b6259a1b1379eac780f4892a0a72572801ac9eb8516c0bdb4913c3  include/tirtc/media_downlink.h
 e64191a39004165cdcd11b2ca824af34d4bfe02f7ec3c3101fa9291f56488c30  include/tirtc/media_uplink.h
-93b85272f8fa606e048e40c0bd353440a46459180afcdaddd15b9a028dc26173  include/tirtc/transport.h
-b932f3e930057843751e66d6b4eb9d8440ecdfd6634fd941abbe260eccfa056c  include/tirtc/trp.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
@@ -35,13 +35,13 @@ cae0bbeb884e5466a56da15182c78cc22baab6c743f349a58d3595f623333585  include/tirtc/
 8db86d6714264047e8fd4086ddd7315722d675749719e6175f89eb5a636b48a1  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
+e2cc6ebe4b3efd602dd454c32cf5a56f7cecddff52ba51a09307434a102a3134  lib/libmatrix_runtime_audio.a
+86952647a2ee67457e5e0129270bbcc130bc1c3055674bd1256996e63d1d396d  lib/libmatrix_runtime_facade.a
+88c8067852e3a334f6d7b741d36ffe4d5dc5a639b50a5566178485f2e3a62d51  lib/libmatrix_runtime_foundation_http.a
+5928ccfe2717594f66aba6b43d3b3d394634d2d742d5a79ccd86d17ab56adf6c  lib/libmatrix_runtime_foundation_logging.a
+a1a7c04dff1601fee215bf71b99a1b2725b74171b7182ab807b4f40ba96a5554  lib/libmatrix_runtime_media.a
+8adcf9d35a21d86392336389e361d6c75554ba1cdd6afde74e9e748adff34b77  lib/libmatrix_runtime_transport.a
+9e8db21a0c02d407799a9acc80042af2de38bc2b9509914df6d0bd63cae1a945  lib/libmatrix_runtime_video.a
 c11c65d373a127028350c41fa58cd2d1223f2b5d70a84e13b115d90daaba25ca  lib/libssl.a
 ef1c1104bbdd2528ed7b958fb7252bd6249875f92300b0c9577d6c4bd6c0d88a  lib/libssl.dylib
 e14e846e43d64e240fa0e5745bf4e702b79d0f2442e7f768beb990610735c71b  lib/libtgrtc.dylib