tirtc-devtools-cli 0.2.5 → 0.3.1

package/README.md

@@ -65,13 +65,19 @@ 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` 会包含
 可用于后续抓取的 `log_id`。
 
+`device start` 与 `client start` 启动的 native role 默认 echo 收到的 command：
+收到任意 command 后，用同一个 command id 与同一 payload 原样回发。CLI 不新增
+额外控制命令或开关；`summary.json` 与 `--json` envelope 会包含 `command_echo`
+evidence，用于确认 command 收发面已被覆盖。
+
 打包入口：
 
 ```sh

package/USAGE.md

@@ -146,6 +146,10 @@ provided. That file is a local handoff artifact for CLI client, runtime sample
 smoke, and validation automation. The token in that bootstrap is intended for
 one client connection.
 
+`device start` starts a native role that echoes every received command with the
+same command id and payload. No extra CLI command or option is required.
+`summary.json` and the `--json` envelope include `command_echo` evidence.
+
 `bootstrap.json` is not a mobile SDK connection protocol. For phone debugging,
 use token/license QR today; a full session QR or deeplink is a separate product
 slice.
@@ -160,6 +164,11 @@ node products/cli/bin/tirtc-devtools-cli.js --json client start \
 
 Client writes `summary.json`, `events.jsonl`, runtime logs, and `render/first-video-frame.*` for `frame_dump`.
 
+The native client role also echoes every received command with the same command
+id and payload. `summary.json` and the `--json` envelope include `command_echo`
+evidence, so command receive and reply coverage is visible in normal CLI
+artifacts.
+
 `client start --bootstrap` is meant for the local computer-to-computer DevTools
 flow. Mobile clients should not be required to fetch a local JSON file from the
 developer machine.

package/dist/cli/src/index.js

@@ -141,6 +141,9 @@ device start succeeds once the device listener is ready. It keeps running withou
 the process is stopped or an explicit --duration-ms deadline is reached.
 Runtime lifecycle logs are written to stderr. With --json, the final envelope remains on stdout.
 
+The native device role echoes every received command with the same command id and payload.
+summary.json and the --json envelope include command_echo evidence.
+
 bootstrap.json is a local handoff artifact for client/sample/validation automation.
 It is only written when --client-token-json is provided.
 It is not a mobile SDK connection protocol.
@@ -171,6 +174,9 @@ Examples:
 
 bootstrap.json is expected to come from a local device start run.
 For mobile device debugging, use token/license QR or a future session QR/deeplink.
+
+The native client role echoes every received command with the same command id and payload.
+summary.json and the --json envelope include command_echo evidence.
 `)
     .action((commandOptions) => {
     runAndExit((0, role_driver_1.runClientStart)(commandOptions, getCliOptions()));

package/dist/cli/src/role_driver.js

@@ -167,7 +167,11 @@ function redactRequestValue(value) {
     }
     const result = {};
     for (const [key, child] of Object.entries(value)) {
-        if (key === 'license' || key === 'token' || key === 'client_token' || key === 'secret_key') {
+        if (key === 'license' ||
+            key === 'token' ||
+            key === 'client_token' ||
+            key === 'device_secret_key' ||
+            key === 'secret_key') {
             result[key] = '[REDACTED]';
         }
         else {
@@ -313,8 +317,8 @@ function buildDeviceRequest(roots, artifactRoot, options) {
         role: 'device',
         endpoint: deviceIdentity.endpoint,
         identity: {
-            license: deviceIdentity.deviceId + ',' + deviceIdentity.deviceSecretKey,
             device_id: deviceIdentity.deviceId,
+            device_secret_key: deviceIdentity.deviceSecretKey,
         },
         bootstrap,
         streams: {
@@ -553,6 +557,7 @@ async function runRole(role, commandOptions, options) {
             failed_stage: failedStage(summary),
             log_id: summary.log_upload?.log_id,
             log_upload: summary.log_upload,
+            command_echo: summary.command_echo,
         };
         if (summary.exit_code === 0 && summary.status === 'completed') {
             printEnvelope(options, 0, 'OK', data);

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.2.5",
+  "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;
 
 /**
@@ -101,7 +105,7 @@ typedef struct TirtcAudioOutputMetricsSnapshot {
  *
  * The snapshot is a caller-owned value copy. Zero-initialized fields mean the output has not yet
  * observed a matching runtime fact or only cached zero-state is available. This diagnostic API is
- * intended for UI/debug visibility and logs, not for playback control decisions.
+ * intended for UI/debug visibility and logs, not for output control decisions.
  */
 typedef struct TirtcAudioOutputDebugSnapshot {
   TirtcMediaCodec codec;

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;
@@ -289,17 +289,6 @@ typedef struct TirtcTransportConnCallbacks {
  */
 TirtcError tirtc_transport_init(void);
 
-/**
- * @brief Enable/disable transport debug mode.
- *
- * When enabled, transport backend sets verbose vendor SDK log level during runtime init
- * and applies it immediately if runtime is already initialized.
- *
- * @param enabled Non-zero to enable debug mode, zero to disable.
- * @return Operation status.
- */
-TirtcError tirtc_transport_enable_debug(uint8_t enabled);
-
 /**
  * @brief Uninitialize transport runtime.
  *

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

@@ -25,19 +25,13 @@ typedef struct TirtcInitOptions {
 
 } TirtcInitOptions;
 
-typedef enum TirtcMediaSendPolicy {
-
-  TIRTC_MEDIA_SEND_POLICY_ON_REQUEST = 0,
-
-  TIRTC_MEDIA_SEND_POLICY_AUTO_ON_CONNECTED = 1,
-} TirtcMediaSendPolicy;
-
 typedef struct TirtcConnServiceStartOptions {
-  const char* license;
+  const char* device_id;
 
-  uint32_t max_connections;
+  const char* device_secret_key;
 
-  TirtcMediaSendPolicy media_send_policy;
+  /** Set to 0 to leave accepted-connection capacity to the active backend. */
+  uint32_t max_connections;
 } TirtcConnServiceStartOptions;
 
 typedef struct TirtcConnConnectOptions {

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

@@ -20,8 +20,17 @@ typedef enum TirtcVideoAppleWindowSlot {
   TIRTC_VIDEO_APPLE_WINDOW_SLOT_RIGHT = 2,
 } TirtcVideoAppleWindowSlot;
 
+typedef enum TirtcVideoAppleCameraFacing {
+  TIRTC_VIDEO_APPLE_CAMERA_FACING_FRONT = 0,
+  TIRTC_VIDEO_APPLE_CAMERA_FACING_BACK = 1,
+} TirtcVideoAppleCameraFacing;
+
 typedef int (*TirtcVideoAppleOnPixelBufferFn)(void* pixel_buffer, void* user_data);
 
+typedef struct TirtcVideoAppleAvFoundationVinOptions {
+  TirtcVideoAppleCameraFacing camera_facing;
+} TirtcVideoAppleAvFoundationVinOptions;
+
 typedef struct TirtcVideoAppleCoreVideoVoutOptions {
   TirtcVideoAppleVoutTarget target;
   TirtcVideoAppleOnPixelBufferFn on_pixel_buffer;
@@ -35,6 +44,11 @@ typedef struct TirtcVideoAppleCoreVideoVoutOptions {
   uint32_t window_height;
 } TirtcVideoAppleCoreVideoVoutOptions;
 
+TirtcError tirtc_video_apple_create_avfoundation_vin(TirtcVideoVin** out_vin);
+TirtcError tirtc_video_apple_avfoundation_vin_set_options(
+    TirtcVideoVin* vin, const TirtcVideoAppleAvFoundationVinOptions* options);
+TirtcError tirtc_video_apple_avfoundation_vin_get_actual_facing(
+    TirtcVideoVin* vin, TirtcVideoAppleCameraFacing* out_camera_facing);
 TirtcError tirtc_video_apple_create_core_video_vout(TirtcVideoVout** out_vout);
 TirtcError tirtc_video_apple_core_video_vout_set_options(
     TirtcVideoVout* vout, const TirtcVideoAppleCoreVideoVoutOptions* options);

package/vendor/runtime/linux-x64/manifest.txt

@@ -1,9 +1,9 @@
 platform=linux-x64
 profile=full
-staged_at_utc=2026-05-05T13:45:31Z
+staged_at_utc=2026-05-09T08:58:54Z
 source_sdk=/Users/allenfeng/Development/Repositories/tirtc-nexus/tirtc-matrix/.build/sdk/linux-x64
 
-bfc096be1484ac2b1c2776ccabfa2a4c6a982e869abf875192ff06fad85e82ca  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,33 +13,33 @@ 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
-489f6c9caa3e4094566b660ef0a002a39c66c1956ef0a1bdb6eacca3798c849a  include/tirtc/transport.h
-bb9c1bf46f2ab51a9f7adb211276c8563b09e7968031c0c6abeebc0eddd66acb  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
 9930dce5e8e2b12a1ab28ee91f3fb46f6cf3487e515ea2b4ec0e00009bd5f070  include/tirtc/video_io_android.h
-005114b9213ec826e18d11eca4b9d65cce2ca0e7c781f03d85292365d9d5dfdd  include/tirtc/video_io_apple.h
+f22127424d5978ab0644209b6c25c24e19e320dd2fbda6634e6344597ff7e2be  include/tirtc/video_io_apple.h
 cae0bbeb884e5466a56da15182c78cc22baab6c743f349a58d3595f623333585  include/tirtc/video_io_harmony.h
 65b5d24fe3a6bc2a299a2220148a153ba4eb0955a49c1c3baabf1fdfed8aabdd  include/tirtc/video_io_windows.h
 8cd6b66bea14890a665cc317f8572429b2c3e4463773f8b77c1e4dc30a4a8747  include/tirtc/video_processing.h
 ceb7cdd45efae57e5bd53d4177cb20c4a0cb9917fcdd23127b050d69c8b919ac  lib/libTiRTC.a
 b1f4135025cb8e8520a14268d831b9998920a4239f84bb6b409d0e4909fd5bee  lib/libcrypto.a
 296ba0b5efa9d2ac49e3bf278c5d467b31436e73fbc608b736e974bcf9759bde  lib/libmatrix_runtime_audio.a
-88f9c545943e4ef80024baf3620e91817ec16a4fea60b0e8c7887a0a41dc9d1b  lib/libmatrix_runtime_facade.a
+8552aba878ffb4c242e4af589784fafbdd938291663af750aaa94d902cba72ce  lib/libmatrix_runtime_facade.a
 ec7bbf8e8744c6645a441a28e24e0645906152cc987d6fcca16af3c3badba940  lib/libmatrix_runtime_foundation_http.a
-4005e0f9ff88f2acc1639b79299c6089ba1b81d1a4fd52fe9d64c5e8603d488a  lib/libmatrix_runtime_foundation_logging.a
-8964ab2d93bf0fd4ee6666459ffec53cd35b07288fccc0d46e042e60b8466d4f  lib/libmatrix_runtime_media.a
-93dd81cfb9ed8aef29bfa3fb9d18aaed140ac25d00beeff1a0156a9333afa8a5  lib/libmatrix_runtime_transport.a
-ac7b85780c75b5d0c3abf1c5293181739a0fceeb2ad8fa930f98bd86bba5daa2  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;
 
 /**
@@ -101,7 +105,7 @@ typedef struct TirtcAudioOutputMetricsSnapshot {
  *
  * The snapshot is a caller-owned value copy. Zero-initialized fields mean the output has not yet
  * observed a matching runtime fact or only cached zero-state is available. This diagnostic API is
- * intended for UI/debug visibility and logs, not for playback control decisions.
+ * intended for UI/debug visibility and logs, not for output control decisions.
  */
 typedef struct TirtcAudioOutputDebugSnapshot {
   TirtcMediaCodec codec;

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;
@@ -289,17 +289,6 @@ typedef struct TirtcTransportConnCallbacks {
  */
 TirtcError tirtc_transport_init(void);
 
-/**
- * @brief Enable/disable transport debug mode.
- *
- * When enabled, transport backend sets verbose vendor SDK log level during runtime init
- * and applies it immediately if runtime is already initialized.
- *
- * @param enabled Non-zero to enable debug mode, zero to disable.
- * @return Operation status.
- */
-TirtcError tirtc_transport_enable_debug(uint8_t enabled);
-
 /**
  * @brief Uninitialize transport runtime.
  *

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

@@ -25,19 +25,13 @@ typedef struct TirtcInitOptions {
 
 } TirtcInitOptions;
 
-typedef enum TirtcMediaSendPolicy {
-
-  TIRTC_MEDIA_SEND_POLICY_ON_REQUEST = 0,
-
-  TIRTC_MEDIA_SEND_POLICY_AUTO_ON_CONNECTED = 1,
-} TirtcMediaSendPolicy;
-
 typedef struct TirtcConnServiceStartOptions {
-  const char* license;
+  const char* device_id;
 
-  uint32_t max_connections;
+  const char* device_secret_key;
 
-  TirtcMediaSendPolicy media_send_policy;
+  /** Set to 0 to leave accepted-connection capacity to the active backend. */
+  uint32_t max_connections;
 } TirtcConnServiceStartOptions;
 
 typedef struct TirtcConnConnectOptions {

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

@@ -20,8 +20,17 @@ typedef enum TirtcVideoAppleWindowSlot {
   TIRTC_VIDEO_APPLE_WINDOW_SLOT_RIGHT = 2,
 } TirtcVideoAppleWindowSlot;
 
+typedef enum TirtcVideoAppleCameraFacing {
+  TIRTC_VIDEO_APPLE_CAMERA_FACING_FRONT = 0,
+  TIRTC_VIDEO_APPLE_CAMERA_FACING_BACK = 1,
+} TirtcVideoAppleCameraFacing;
+
 typedef int (*TirtcVideoAppleOnPixelBufferFn)(void* pixel_buffer, void* user_data);
 
+typedef struct TirtcVideoAppleAvFoundationVinOptions {
+  TirtcVideoAppleCameraFacing camera_facing;
+} TirtcVideoAppleAvFoundationVinOptions;
+
 typedef struct TirtcVideoAppleCoreVideoVoutOptions {
   TirtcVideoAppleVoutTarget target;
   TirtcVideoAppleOnPixelBufferFn on_pixel_buffer;
@@ -35,6 +44,11 @@ typedef struct TirtcVideoAppleCoreVideoVoutOptions {
   uint32_t window_height;
 } TirtcVideoAppleCoreVideoVoutOptions;
 
+TirtcError tirtc_video_apple_create_avfoundation_vin(TirtcVideoVin** out_vin);
+TirtcError tirtc_video_apple_avfoundation_vin_set_options(
+    TirtcVideoVin* vin, const TirtcVideoAppleAvFoundationVinOptions* options);
+TirtcError tirtc_video_apple_avfoundation_vin_get_actual_facing(
+    TirtcVideoVin* vin, TirtcVideoAppleCameraFacing* out_camera_facing);
 TirtcError tirtc_video_apple_create_core_video_vout(TirtcVideoVout** out_vout);
 TirtcError tirtc_video_apple_core_video_vout_set_options(
     TirtcVideoVout* vout, const TirtcVideoAppleCoreVideoVoutOptions* options);

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

@@ -1,9 +1,9 @@
 platform=macos-arm64
 profile=full
-staged_at_utc=2026-05-05T13:43:48Z
+staged_at_utc=2026-05-09T08:57:10Z
 source_sdk=/Users/allenfeng/Development/Repositories/tirtc-nexus/tirtc-matrix/.build/sdk/macos-arm64
 
-bfc096be1484ac2b1c2776ccabfa2a4c6a982e869abf875192ff06fad85e82ca  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,21 +13,21 @@ 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
-489f6c9caa3e4094566b660ef0a002a39c66c1956ef0a1bdb6eacca3798c849a  include/tirtc/transport.h
-bb9c1bf46f2ab51a9f7adb211276c8563b09e7968031c0c6abeebc0eddd66acb  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
 9930dce5e8e2b12a1ab28ee91f3fb46f6cf3487e515ea2b4ec0e00009bd5f070  include/tirtc/video_io_android.h
-005114b9213ec826e18d11eca4b9d65cce2ca0e7c781f03d85292365d9d5dfdd  include/tirtc/video_io_apple.h
+f22127424d5978ab0644209b6c25c24e19e320dd2fbda6634e6344597ff7e2be  include/tirtc/video_io_apple.h
 cae0bbeb884e5466a56da15182c78cc22baab6c743f349a58d3595f623333585  include/tirtc/video_io_harmony.h
 65b5d24fe3a6bc2a299a2220148a153ba4eb0955a49c1c3baabf1fdfed8aabdd  include/tirtc/video_io_windows.h
 8cd6b66bea14890a665cc317f8572429b2c3e4463773f8b77c1e4dc30a4a8747  include/tirtc/video_processing.h
@@ -35,13 +35,13 @@ cae0bbeb884e5466a56da15182c78cc22baab6c743f349a58d3595f623333585  include/tirtc/
 8db86d6714264047e8fd4086ddd7315722d675749719e6175f89eb5a636b48a1  lib/libTiRTC.a
 b39daee6a3d39bf0ca20c45084601133c4198de8dca848dcff6dd9c70ae99016  lib/libcrypto.a
 c052857ef315e3d61db9c862cad10709a3a6b2487dc41799cbe4d74a805de875  lib/libcrypto.dylib
-8cf2dc6547ac1f3aa0d2866005af74c9ae6adf1f358d84cec119205bc1455a2a  lib/libmatrix_runtime_audio.a
-11f5e0e50838b9f521acc0eed761120c550be71b87d0a04f172a02a62e6ea6bd  lib/libmatrix_runtime_facade.a
-6ec439f590f1468763cdcc7ed6e4a5e24e9d169d37ecdb3d7d3449d633a01da3  lib/libmatrix_runtime_foundation_http.a
-8b49e1ae4eab6cdb74576e28e1df4c34986e65df044bbdf275b4f58daaddc52f  lib/libmatrix_runtime_foundation_logging.a
-8151ddd3e587a169050a733db09e216c347a5733e341da90ec234153cf432297  lib/libmatrix_runtime_media.a
-05efbdfd1051206fa407dc81f3da9c35e60cf9d21005d01f59a23da688d97b64  lib/libmatrix_runtime_transport.a
-2f2c455c0fbb4c0d2242586aee3eec6c59f9323b380edeac85f3af0d8b9fb5e4  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