tirtc-devtools-cli 0.0.12 → 0.0.13

package/USAGE.md

@@ -100,8 +100,9 @@ $ node ... token issue --help
 Usage: tirtc-devtools-cli token issue [options] <remote_id>
 
 Options:
-  --access-id <accessId>
-  --secret-key <secretKey>
+  --access-key-id <accessKeyId>
+  --secret-key-id <secretKeyId>
+  --app-id <appId>
   --openapi-endpoint <url>
   --endpoint <entry>
   --qr-error-correction-level <level>
@@ -258,8 +259,9 @@ CLI 仍会在本地收紧最小组合矩阵：
 命令形态：
 
 ```bash
-export TIRTC_CONN_ACCESS_ID="<ACCESS_ID>"
-export TIRTC_CONN_SECRET_KEY="<SECRET_KEY>"
+export TIRTC_ACCESS_KEY_ID="<ACCESS_KEY_ID>"
+export TIRTC_SECRET_KEY_ID="<SECRET_KEY_ID>"
+export TIRTC_APP_ID="<APP_ID>"
 node products/cli/bin/tirtc-devtools-cli.js --json token issue <REMOTE_ID>
 ```
 
@@ -274,10 +276,11 @@ node products/cli/bin/tirtc-devtools-cli.js --json token issue <REMOTE_ID> \
 当前 CLI 合同：
 
 - 位置参数改为 `<remote_id>`。
+- `app_id` 必填；可通过 `--app-id` 或 `TIRTC_APP_ID` 提供。
 - `--endpoint` 取代旧 `--service-entry`。
 - `--openapi-endpoint` 取代旧 `--openapi-entry`。
 - 不再接收 `local_id`。
-- 显式传入的 `endpoint` / `openapi_endpoint` 会透传给 C 层签发路径，并同时进入二维码 payload。
+- 显式传入的 `endpoint` / `openapi_endpoint` 会透传给 C 层签发路径；其中 `app_id` / `endpoint` / `openapi_endpoint` 会进入二维码 payload。
 - 若未显式传入 `endpoint` / `openapi_endpoint`，则 payload 中不再补默认字段。
 
 `--json` 输出保持外层 envelope 不变：
@@ -288,12 +291,13 @@ node products/cli/bin/tirtc-devtools-cli.js --json token issue <REMOTE_ID> \
   "message": "OK",
   "data": {
     "payload": {
+      "app_id": "AD_testapp",
       "remote_id": "TESTFENGJUN4",
       "token": "<TOKEN>",
       "endpoint": "http://ep-test-tirtc.tange365.com",
       "openapi_endpoint": "http://api-test-tirtc.tange365.com"
     },
-    "payloadJson": "{\"remote_id\":\"TESTFENGJUN4\",\"token\":\"<TOKEN>\",\"endpoint\":\"http://ep-test-tirtc.tange365.com\",\"openapi_endpoint\":\"http://api-test-tirtc.tange365.com\"}",
+    "payloadJson": "{\"app_id\":\"AD_testapp\",\"remote_id\":\"TESTFENGJUN4\",\"token\":\"<TOKEN>\",\"endpoint\":\"http://ep-test-tirtc.tange365.com\",\"openapi_endpoint\":\"http://api-test-tirtc.tange365.com\"}",
     "token": "<TOKEN>",
     "qrCodePngPath": "/absolute/path/to/token-*.png"
   }
@@ -302,7 +306,7 @@ node products/cli/bin/tirtc-devtools-cli.js --json token issue <REMOTE_ID> \
 
 说明：
 
-- payload 只保留 `remote_id`、`token`、可选 `endpoint`、可选 `openapi_endpoint`。
+- payload 只保留 `app_id`、`remote_id`、`token`、可选 `endpoint`、可选 `openapi_endpoint`。
 - 已删除字段不再出现：`version`、`type`、`local_id`、`peer_id`、`openapi_entry`、`service_entry`、`user_ttl_seconds`、`channel_ttl_seconds`、`generated_at`。
 
 ### license qrcode

package/dist/cli/src/guide.js

@@ -21,8 +21,9 @@ function printQuickstartGuide() {
         '  # service start 成功后会自动 prepare 并按 AUTO_ON_CONNECTED 进入待发流语义',
         '',
         '步骤 3：显式签发 client token（可本地执行，也可由外部系统提供）',
-        '  export TIRTC_CONN_ACCESS_ID="<ACCESS_ID>"',
-        '  export TIRTC_CONN_SECRET_KEY="<SECRET_KEY>"',
+        '  export TIRTC_ACCESS_KEY_ID="<ACCESS_KEY_ID>"',
+        '  export TIRTC_SECRET_KEY_ID="<SECRET_KEY_ID>"',
+        '  export TIRTC_APP_ID="<APP_ID>"',
         '  node products/cli/bin/tirtc-devtools-cli.js --json token issue "<REMOTE_ID>" --endpoint "<ENDPOINT>"',
         '',
         '步骤 4：启动 client 本地 web preview',

package/dist/cli/src/index.js

@@ -11,7 +11,7 @@ const media_assets_1 = require("./media_assets");
 const token_command_1 = require("./token_command");
 const transport_1 = require("./transport");
 const progress_1 = require("./progress");
-const CLI_VERSION = '0.0.12';
+const CLI_VERSION = '0.0.13';
 const HOST_VERSION = '1.0.0';
 const PROTOCOL_VERSION = '1.0.0';
 if (process.argv.includes('--version') || process.argv.includes('-V')) {

package/dist/cli/src/token_command.js

@@ -3,8 +3,9 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.registerTokenCommands = registerTokenCommands;
 const facade_1 = require("./facade");
 const token_tool_1 = require("./token_tool");
-const kTokenIssueAccessIdEnvVar = 'TIRTC_CONN_ACCESS_ID';
-const kTokenIssueSecretKeyEnvVar = 'TIRTC_CONN_SECRET_KEY';
+const kTokenIssueAccessKeyIdEnvVar = 'TIRTC_ACCESS_KEY_ID';
+const kTokenIssueSecretKeyIdEnvVar = 'TIRTC_SECRET_KEY_ID';
+const kTokenIssueAppIdEnvVar = 'TIRTC_APP_ID';
 function normalizeTokenCommandError(error) {
     if (error instanceof Error) {
         return {
@@ -45,7 +46,16 @@ function printTokenCommandError(error, options) {
 }
 async function runTokenIssue(params, options) {
     try {
-        const result = await (0, token_tool_1.issueTokenWithQrcode)(params);
+        const result = await (0, token_tool_1.issueTokenWithQrcode)({
+            accessId: params.accessKeyId,
+            secretKey: params.secretKeyId,
+            appId: params.appId,
+            remoteId: params.remoteId,
+            openapiEndpoint: params.openapiEndpoint,
+            endpoint: params.endpoint,
+            qrErrorCorrectionLevel: params.qrErrorCorrectionLevel,
+            asciiMaxColumns: params.asciiMaxColumns,
+        });
         if (options.json) {
             console.log(JSON.stringify({
                 code: 0,
@@ -90,7 +100,7 @@ async function runLicenseQrcode(params, options) {
         return printTokenCommandError(error, options);
     }
 }
-function resolveTokenIssueCredential(explicitValue, envVarName, optionName) {
+function resolveRequiredTokenIssueValue(explicitValue, fieldName, envVarName, optionName) {
     const normalizedExplicit = explicitValue?.trim();
     if (normalizedExplicit) {
         return normalizedExplicit;
@@ -99,7 +109,7 @@ function resolveTokenIssueCredential(explicitValue, envVarName, optionName) {
     if (normalizedEnv) {
         return normalizedEnv;
     }
-    throw new Error('missing credential: set environment variable ' + envVarName +
+    throw new Error('missing required ' + fieldName + ': set environment variable ' + envVarName +
         ' or pass ' + optionName + ' explicitly');
 }
 async function runTokenIssueFromCli(remoteId, commandOptions, options) {
@@ -124,11 +134,13 @@ async function runTokenIssueFromCli(remoteId, commandOptions, options) {
         return normalized;
     };
     try {
-        const accessId = resolveTokenIssueCredential(commandOptions.accessId, kTokenIssueAccessIdEnvVar, '--access-id');
-        const secretKey = resolveTokenIssueCredential(commandOptions.secretKey, kTokenIssueSecretKeyEnvVar, '--secret-key');
+        const accessKeyId = resolveRequiredTokenIssueValue(commandOptions.accessKeyId, 'access_key_id', kTokenIssueAccessKeyIdEnvVar, '--access-key-id');
+        const secretKeyId = resolveRequiredTokenIssueValue(commandOptions.secretKeyId, 'secret_key_id', kTokenIssueSecretKeyIdEnvVar, '--secret-key-id');
+        const appId = resolveRequiredTokenIssueValue(commandOptions.appId, 'app_id', kTokenIssueAppIdEnvVar, '--app-id');
         return await runTokenIssue({
-            accessId,
-            secretKey,
+            accessKeyId,
+            secretKeyId,
+            appId,
             remoteId,
             openapiEndpoint: commandOptions.openapiEndpoint,
             endpoint: commandOptions.endpoint,
@@ -181,9 +193,10 @@ async function runLicenseQrcodeFromCli(license, commandOptions, options) {
 function registerTokenCommands(program, getCliOptions, runAndExit) {
     const token = program.command('token').description('Token 工具：签发 token，并输出可直接使用的 JSON 与本地二维码 PNG');
     token.command('issue <remote_id>')
-        .description('默认从环境变量读取 access/secret，并基于 remote_id 签发 token')
-        .option('--access-id <accessId>', '显式 access id；不传时读取 ' + kTokenIssueAccessIdEnvVar)
-        .option('--secret-key <secretKey>', '显式 secret key；不传时读取 ' + kTokenIssueSecretKeyEnvVar)
+        .description('默认从环境变量读取 access_key_id / secret_key_id / app_id，并基于 remote_id 签发 token')
+        .option('--access-key-id <accessKeyId>', '显式 access_key_id；不传时读取 ' + kTokenIssueAccessKeyIdEnvVar)
+        .option('--secret-key-id <secretKeyId>', '显式 secret_key_id；不传时读取 ' + kTokenIssueSecretKeyIdEnvVar)
+        .option('--app-id <appId>', '必填 app_id；不传时读取 ' + kTokenIssueAppIdEnvVar)
         .option('--openapi-endpoint <url>', '可选 openapi endpoint；传了就透传到底层签发')
         .option('--endpoint <entry>', '可选 endpoint；传了就写入 payload 与二维码')
         .option('--qr-error-correction-level <level>', '二维码纠错级别：L/M/Q/H；默认 M')

package/dist/cli/src/token_tool.d.ts

@@ -1,6 +1,7 @@
 export type TokenIssueInput = {
     accessId: string;
     secretKey: string;
+    appId: string;
     remoteId: string;
     openapiEndpoint?: string;
     endpoint?: string;
@@ -8,6 +9,7 @@ export type TokenIssueInput = {
     asciiMaxColumns?: number;
 };
 export type IssuedTokenPayload = {
+    app_id: string;
     remote_id: string;
     token: string;
     endpoint?: string;

package/dist/cli/src/token_tool.js

@@ -214,6 +214,62 @@ function buildIssueTokenHelperSource() {
         '}',
     ].join('\n');
 }
+function parseIssueTokenFailure(message) {
+    const matched = message.match(/issue token failed error=(\d+) http_status=(\d+)/i);
+    if (!matched) {
+        return {};
+    }
+    const errorCode = Number.parseInt(matched[1] ?? '', 10);
+    const httpStatus = Number.parseInt(matched[2] ?? '', 10);
+    return {
+        errorCode: Number.isNaN(errorCode) ? undefined : errorCode,
+        httpStatus: Number.isNaN(httpStatus) ? undefined : httpStatus,
+    };
+}
+function isNodeStackNoise(line) {
+    return line.startsWith('[eval]:') ||
+        line.startsWith('at [eval]') ||
+        line.startsWith('at runScriptInThisContext') ||
+        line.startsWith('at node:internal/') ||
+        line.startsWith('Node.js v');
+}
+function sanitizeIssueTokenFailureText(message) {
+    const lines = message
+        .split(/\r?\n/)
+        .map((line) => line.trim())
+        .filter((line) => line.length > 0 && !isNodeStackNoise(line));
+    const collapsed = lines.join(' | ');
+    if (collapsed.length === 0) {
+        return 'token issuing failed';
+    }
+    return collapsed;
+}
+function formatIssueTokenFailureMessage(message) {
+    const parsed = parseIssueTokenFailure(message);
+    const detail = sanitizeIssueTokenFailureText(message);
+    if (parsed.httpStatus === 200 && parsed.errorCode === 3) {
+        return [
+            'token issuing failed: remote service rejected the request.',
+            'Check whether remote_id, access_key_id, secret_key_id, and openapi-endpoint are correct.',
+            'detail: error=3 http_status=200',
+        ].join(' ');
+    }
+    if (parsed.httpStatus !== undefined || parsed.errorCode !== undefined) {
+        const detailParts = [];
+        if (parsed.errorCode !== undefined) {
+            detailParts.push('error=' + parsed.errorCode);
+        }
+        if (parsed.httpStatus !== undefined) {
+            detailParts.push('http_status=' + parsed.httpStatus);
+        }
+        return [
+            'token issuing failed: remote authentication request was not accepted.',
+            'Check whether remote_id, access_key_id, secret_key_id, and openapi-endpoint are correct.',
+            'detail: ' + detailParts.join(' '),
+        ].join(' ');
+    }
+    return 'token issuing failed: ' + detail;
+}
 function issueTokenViaSubprocess(addonPath, input) {
     const result = childProcess.spawnSync(process.execPath, ['-e', buildIssueTokenHelperSource()], {
         encoding: 'utf8',
@@ -229,7 +285,7 @@ function issueTokenViaSubprocess(addonPath, input) {
     }
     if (result.status !== 0) {
         const details = String(result.stderr || result.stdout || 'issue token subprocess failed').trim();
-        throw new Error(details || 'issue token subprocess failed');
+        throw new Error(formatIssueTokenFailureMessage(details || 'issue token subprocess failed'));
     }
     return normalizeIssuedToken(String(result.stdout || ''));
 }
@@ -295,11 +351,12 @@ async function issueToken(input) {
     }
     catch (error) {
         const message = error instanceof Error ? error.message : String(error);
-        throw new Error('issue token failed: ' + message);
+        throw new Error(message);
     }
 }
 function buildIssuedTokenPayload(input, token) {
     const payload = {
+        app_id: input.appId.trim(),
         remote_id: input.remoteId,
         token,
     };
@@ -381,6 +438,7 @@ async function buildLicenseQrcode(input) {
 function formatTokenIssueConsoleOutput(output) {
     const summaryLines = [
         'Issued Token Summary:',
+        '  app_id: ' + output.payload.app_id,
         '  remote_id: ' + output.payload.remote_id,
         '  endpoint: ' + (output.payload.endpoint ?? '(omitted)'),
         '  openapi_endpoint: ' + (output.payload.openapi_endpoint ?? '(omitted)'),

package/package.json

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

package/vendor/app-server/bin/runtime/linux-x64/include/tirtc/error.h

@@ -7,25 +7,44 @@ extern "C" {
 
 typedef enum TirtcError {
   TIRTC_ERROR_OK = 0,
-  TIRTC_ERROR_INVALID_ARGUMENT = 1,
-  TIRTC_ERROR_NOT_INITIALIZED = 2,
-  TIRTC_ERROR_INTERNAL = 3,
-  TIRTC_ERROR_NOT_READY = 4,
-  TIRTC_ERROR_UNSUPPORTED_LOOP_POLICY = 5,
-  TIRTC_ERROR_SOURCE_HASH_MISMATCH = 6,
-  TIRTC_ERROR_STOPPED = 7,
-  TIRTC_ERROR_DESTROYED = 8,
-  TIRTC_ERROR_TRANSPORT_INVALID_LICENSE = 9,
-  TIRTC_ERROR_TRANSPORT_TIMEOUT = 10,
-  TIRTC_ERROR_TRANSPORT_BUSY = 11,
-  TIRTC_ERROR_TRANSPORT_CONNECTION_TIMEOUT_CLOSED = 12,
-  TIRTC_ERROR_TRANSPORT_REMOTE_CLOSED = 13,
-  TIRTC_ERROR_TRANSPORT_CONNECTION_OTHER_ERROR = 14,
-  TIRTC_ERROR_TRANSPORT_TOKEN_EXPIRED = 15,
-  TIRTC_ERROR_DUMP_ROOT_UNAVAILABLE = 16,
-  TIRTC_ERROR_DUMP_ALREADY_ACTIVE = 17,
+  TIRTC_ERROR_INVALID_ARGUMENT = 6000,
+  TIRTC_ERROR_NOT_INITIALIZED = 6001,
+  TIRTC_ERROR_INTERNAL = 6002,
+  TIRTC_ERROR_NOT_READY = 6003,
+  TIRTC_ERROR_UNSUPPORTED_LOOP_POLICY = 6004,
+  TIRTC_ERROR_SOURCE_HASH_MISMATCH = 6005,
+  TIRTC_ERROR_ALREADY_STOPPED = 6006,
+  TIRTC_ERROR_STOPPED = TIRTC_ERROR_ALREADY_STOPPED,
+  TIRTC_ERROR_ALREADY_DESTROYED = 6007,
+  TIRTC_ERROR_DESTROYED = TIRTC_ERROR_ALREADY_DESTROYED,
+  TIRTC_ERROR_TRANSPORT_INVALID_LICENSE = 6008,
+  TIRTC_ERROR_TRANSPORT_TIMEOUT = 6009,
+  TIRTC_ERROR_TRANSPORT_BUSY = 6010,
+  TIRTC_ERROR_TRANSPORT_CONNECTION_TIMEOUT_CLOSED = 6011,
+  TIRTC_ERROR_TRANSPORT_REMOTE_CLOSED = 6012,
+  TIRTC_ERROR_TRANSPORT_CONNECTION_OTHER_ERROR = 6013,
+  TIRTC_ERROR_TRANSPORT_TOKEN_EXPIRED = 6014,
+  TIRTC_ERROR_DUMP_ROOT_UNAVAILABLE = 6015,
+  TIRTC_ERROR_DUMP_ALREADY_ACTIVE = 6016,
+  TIRTC_ERROR_TRANSPORT_RESOURCE_EXHAUSTED = 6017,
+  TIRTC_ERROR_TRANSPORT_SERVER_ERROR = 6018,
+  TIRTC_ERROR_TRANSPORT_BACKEND_INTERNAL_ERROR = 6019,
+  TIRTC_ERROR_TRANSPORT_NO_SECRET_KEY = 6020,
+  TIRTC_ERROR_TRANSPORT_UNEXPECTED_RESPONSE = 6021,
+  TIRTC_ERROR_ALREADY_INITIALIZED = 6022,
+  TIRTC_ERROR_INVALID_THREAD = 6023,
+  TIRTC_ERROR_PERMISSION_DENIED = 6024,
+  TIRTC_ERROR_ALREADY_BOUND = 6025,
+  TIRTC_ERROR_IN_USE = 6026,
+  TIRTC_ERROR_NOT_STARTED = 6027,
+  TIRTC_ERROR_NOT_CONNECTED = 6028,
+  TIRTC_ERROR_NOT_BOUND = 6029,
+  TIRTC_ERROR_NOT_CONFIGURED = 6030,
+  TIRTC_ERROR_NOT_OPEN = 6031,
 } TirtcError;
 
+const char* tirtc_error_to_string(TirtcError error);
+
 #ifdef __cplusplus
 }
 #endif

package/vendor/app-server/bin/runtime/linux-x64/manifest.txt

@@ -1,4 +1,4 @@
 platform=linux-x64
 profile=credential
-staged_at_utc=2026-04-21T13:44:44Z
+staged_at_utc=2026-04-23T07:10:15Z
 source_sdk=/workspace/.build/sdk/linux-x64

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

@@ -55,6 +55,30 @@ typedef struct TirtcAudioOutputOptions {
   int noise_reduction_level;
 } TirtcAudioOutputOptions;
 
+typedef struct TirtcOutputStutterMetrics {
+  int session_started;
+  uint64_t session_duration_ms;
+  uint64_t session_stutter_total_ms;
+  uint32_t session_stutter_count;
+  uint64_t session_stutter_peak_ms;
+  double session_stutter_ratio;
+  uint32_t recent_window_duration_ms;
+  uint64_t recent_window_stutter_total_ms;
+  uint32_t recent_window_stutter_count;
+  uint64_t recent_window_stutter_peak_ms;
+  double recent_window_stutter_ratio;
+} TirtcOutputStutterMetrics;
+
+typedef struct TirtcPendingDurationMetrics {
+  uint64_t undecoded_duration_ms;
+  uint64_t decoded_duration_ms;
+} TirtcPendingDurationMetrics;
+
+typedef struct TirtcAudioOutputMetricsSnapshot {
+  TirtcOutputStutterMetrics stutter;
+  TirtcPendingDurationMetrics pending;
+} TirtcAudioOutputMetricsSnapshot;
+
 /**
  * Audio input observer.
  *
@@ -128,6 +152,9 @@ TirtcError tirtc_audio_output_start_raw_dump(TirtcAudioOutput* output);
 
 TirtcError tirtc_audio_output_stop_raw_dump(TirtcAudioOutput* output);
 
+TirtcError tirtc_metrics_audio_output_get_snapshot(TirtcAudioOutput* output,
+                                                   TirtcAudioOutputMetricsSnapshot* out_snapshot);
+
 #ifdef __cplusplus
 }
 #endif

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

@@ -26,6 +26,25 @@ typedef enum TirtcVideoOutputState {
   TIRTC_VIDEO_OUTPUT_STATE_FAILED = 3,
 } TirtcVideoOutputState;
 
+typedef struct TirtcVideoOutputStartupMetrics {
+  int has_connect_start;
+  int has_connected;
+  int has_first_video_input;
+  int has_first_video_decoded;
+  int has_first_video_rendered;
+  uint64_t connect_start_monotonic_ms;
+  uint64_t connected_monotonic_ms;
+  uint64_t first_video_input_monotonic_ms;
+  uint64_t first_video_decoded_monotonic_ms;
+  uint64_t first_video_rendered_monotonic_ms;
+} TirtcVideoOutputStartupMetrics;
+
+typedef struct TirtcVideoOutputMetricsSnapshot {
+  TirtcVideoOutputStartupMetrics startup;
+  TirtcOutputStutterMetrics stutter;
+  TirtcPendingDurationMetrics pending;
+} TirtcVideoOutputMetricsSnapshot;
+
 typedef struct TirtcVideoInputOptions {
   TirtcMediaCodec codec;
 
@@ -127,6 +146,9 @@ TirtcError tirtc_video_output_start_raw_dump(TirtcVideoOutput* output);
 
 TirtcError tirtc_video_output_stop_raw_dump(TirtcVideoOutput* output);
 
+TirtcError tirtc_metrics_video_output_get_snapshot(TirtcVideoOutput* output,
+                                                   TirtcVideoOutputMetricsSnapshot* out_snapshot);
+
 #ifdef __cplusplus
 }
 #endif

package/vendor/app-server/bin/runtime/macos-arm64/include/tirtc/error.h

@@ -7,25 +7,44 @@ extern "C" {
 
 typedef enum TirtcError {
   TIRTC_ERROR_OK = 0,
-  TIRTC_ERROR_INVALID_ARGUMENT = 1,
-  TIRTC_ERROR_NOT_INITIALIZED = 2,
-  TIRTC_ERROR_INTERNAL = 3,
-  TIRTC_ERROR_NOT_READY = 4,
-  TIRTC_ERROR_UNSUPPORTED_LOOP_POLICY = 5,
-  TIRTC_ERROR_SOURCE_HASH_MISMATCH = 6,
-  TIRTC_ERROR_STOPPED = 7,
-  TIRTC_ERROR_DESTROYED = 8,
-  TIRTC_ERROR_TRANSPORT_INVALID_LICENSE = 9,
-  TIRTC_ERROR_TRANSPORT_TIMEOUT = 10,
-  TIRTC_ERROR_TRANSPORT_BUSY = 11,
-  TIRTC_ERROR_TRANSPORT_CONNECTION_TIMEOUT_CLOSED = 12,
-  TIRTC_ERROR_TRANSPORT_REMOTE_CLOSED = 13,
-  TIRTC_ERROR_TRANSPORT_CONNECTION_OTHER_ERROR = 14,
-  TIRTC_ERROR_TRANSPORT_TOKEN_EXPIRED = 15,
-  TIRTC_ERROR_DUMP_ROOT_UNAVAILABLE = 16,
-  TIRTC_ERROR_DUMP_ALREADY_ACTIVE = 17,
+  TIRTC_ERROR_INVALID_ARGUMENT = 6000,
+  TIRTC_ERROR_NOT_INITIALIZED = 6001,
+  TIRTC_ERROR_INTERNAL = 6002,
+  TIRTC_ERROR_NOT_READY = 6003,
+  TIRTC_ERROR_UNSUPPORTED_LOOP_POLICY = 6004,
+  TIRTC_ERROR_SOURCE_HASH_MISMATCH = 6005,
+  TIRTC_ERROR_ALREADY_STOPPED = 6006,
+  TIRTC_ERROR_STOPPED = TIRTC_ERROR_ALREADY_STOPPED,
+  TIRTC_ERROR_ALREADY_DESTROYED = 6007,
+  TIRTC_ERROR_DESTROYED = TIRTC_ERROR_ALREADY_DESTROYED,
+  TIRTC_ERROR_TRANSPORT_INVALID_LICENSE = 6008,
+  TIRTC_ERROR_TRANSPORT_TIMEOUT = 6009,
+  TIRTC_ERROR_TRANSPORT_BUSY = 6010,
+  TIRTC_ERROR_TRANSPORT_CONNECTION_TIMEOUT_CLOSED = 6011,
+  TIRTC_ERROR_TRANSPORT_REMOTE_CLOSED = 6012,
+  TIRTC_ERROR_TRANSPORT_CONNECTION_OTHER_ERROR = 6013,
+  TIRTC_ERROR_TRANSPORT_TOKEN_EXPIRED = 6014,
+  TIRTC_ERROR_DUMP_ROOT_UNAVAILABLE = 6015,
+  TIRTC_ERROR_DUMP_ALREADY_ACTIVE = 6016,
+  TIRTC_ERROR_TRANSPORT_RESOURCE_EXHAUSTED = 6017,
+  TIRTC_ERROR_TRANSPORT_SERVER_ERROR = 6018,
+  TIRTC_ERROR_TRANSPORT_BACKEND_INTERNAL_ERROR = 6019,
+  TIRTC_ERROR_TRANSPORT_NO_SECRET_KEY = 6020,
+  TIRTC_ERROR_TRANSPORT_UNEXPECTED_RESPONSE = 6021,
+  TIRTC_ERROR_ALREADY_INITIALIZED = 6022,
+  TIRTC_ERROR_INVALID_THREAD = 6023,
+  TIRTC_ERROR_PERMISSION_DENIED = 6024,
+  TIRTC_ERROR_ALREADY_BOUND = 6025,
+  TIRTC_ERROR_IN_USE = 6026,
+  TIRTC_ERROR_NOT_STARTED = 6027,
+  TIRTC_ERROR_NOT_CONNECTED = 6028,
+  TIRTC_ERROR_NOT_BOUND = 6029,
+  TIRTC_ERROR_NOT_CONFIGURED = 6030,
+  TIRTC_ERROR_NOT_OPEN = 6031,
 } TirtcError;
 
+const char* tirtc_error_to_string(TirtcError error);
+
 #ifdef __cplusplus
 }
 #endif

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

@@ -43,6 +43,45 @@ typedef struct TirtcMediaDownlinkVideoObserver {
                                  void* user_data);
 } TirtcMediaDownlinkVideoObserver;
 
+typedef struct TirtcMediaDownlinkStutterMetricsSnapshot {
+  int session_started;
+  uint64_t session_duration_ms;
+  uint64_t session_stutter_total_ms;
+  uint32_t session_stutter_count;
+  uint64_t session_stutter_peak_ms;
+  double session_stutter_ratio;
+  uint32_t recent_window_duration_ms;
+  uint64_t recent_window_stutter_total_ms;
+  uint32_t recent_window_stutter_count;
+  uint64_t recent_window_stutter_peak_ms;
+  double recent_window_stutter_ratio;
+} TirtcMediaDownlinkStutterMetricsSnapshot;
+
+typedef struct TirtcMediaDownlinkPendingMetricsSnapshot {
+  uint64_t undecoded_pending_duration_ms;
+  uint64_t decoded_pending_duration_ms;
+} TirtcMediaDownlinkPendingMetricsSnapshot;
+
+typedef struct TirtcMediaDownlinkAudioMetricsSnapshot {
+  TirtcMediaDownlinkStutterMetricsSnapshot stutter;
+  TirtcMediaDownlinkPendingMetricsSnapshot pending;
+} TirtcMediaDownlinkAudioMetricsSnapshot;
+
+typedef struct TirtcMediaDownlinkVideoStartupMetricsSnapshot {
+  int has_first_video_input;
+  int has_first_video_decoded;
+  int has_first_video_rendered;
+  uint64_t first_video_input_monotonic_ms;
+  uint64_t first_video_decoded_monotonic_ms;
+  uint64_t first_video_rendered_monotonic_ms;
+} TirtcMediaDownlinkVideoStartupMetricsSnapshot;
+
+typedef struct TirtcMediaDownlinkVideoMetricsSnapshot {
+  TirtcMediaDownlinkVideoStartupMetricsSnapshot startup;
+  TirtcMediaDownlinkStutterMetricsSnapshot stutter;
+  TirtcMediaDownlinkPendingMetricsSnapshot pending;
+} TirtcMediaDownlinkVideoMetricsSnapshot;
+
 TirtcError tirtc_media_downlink_audio_create(TirtcMediaDownlinkAudio** out_downlink);
 void tirtc_media_downlink_audio_retain(TirtcMediaDownlinkAudio* downlink);
 void tirtc_media_downlink_audio_release(TirtcMediaDownlinkAudio* downlink);
@@ -94,6 +133,14 @@ TirtcError tirtc_media_downlink_video_start_raw_dump(TirtcMediaDownlinkVideo* do
                                                      const char* prefix);
 TirtcError tirtc_media_downlink_video_stop_raw_dump(TirtcMediaDownlinkVideo* downlink);
 
+TirtcError tirtc_media_downlink_audio_get_metrics_snapshot(
+    TirtcMediaDownlinkAudio* downlink, TirtcMediaDownlinkAudioMetricsSnapshot* out_snapshot);
+void tirtc_media_downlink_audio_reset_metrics_session(TirtcMediaDownlinkAudio* downlink);
+
+TirtcError tirtc_media_downlink_video_get_metrics_snapshot(
+    TirtcMediaDownlinkVideo* downlink, TirtcMediaDownlinkVideoMetricsSnapshot* out_snapshot);
+void tirtc_media_downlink_video_reset_metrics_session(TirtcMediaDownlinkVideo* downlink);
+
 #ifdef __cplusplus
 }
 #endif

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

@@ -81,6 +81,13 @@ typedef struct TirtcConnCommand {
   size_t length;
 } TirtcConnCommand;
 
+typedef struct TirtcConnMetricsSnapshot {
+  int has_connect_start;
+  int has_connected;
+  uint64_t connect_start_monotonic_ms;
+  uint64_t connected_monotonic_ms;
+} TirtcConnMetricsSnapshot;
+
 /** Heap-owned byte payload allocated by facade callback dispatch. */
 typedef struct TirtcOwnedBytes {
   /** Payload buffer allocated by facade, or `NULL` for zero-length payloads. */
@@ -168,6 +175,9 @@ void tirtc_owned_string_release(TirtcOwnedString* owned);
 
 TirtcError tirtc_conn_send_command(TirtcConn* connection, const TirtcConnCommand* command);
 
+TirtcError tirtc_metrics_conn_get_snapshot(TirtcConn* connection,
+                                           TirtcConnMetricsSnapshot* out_snapshot);
+
 #ifdef __cplusplus
 }
 #endif

package/vendor/app-server/bin/runtime/macos-arm64/manifest.txt

@@ -1,9 +1,9 @@
 platform=macos-arm64
 profile=credential
-staged_at_utc=2026-04-21T13:44:23Z
+staged_at_utc=2026-04-23T07:09:53Z
 source_sdk=/Users/allenfeng/Development/Repositories/tirtc-nexus/tirtc-matrix/.build/sdk/macos-arm64
 
-bfea7c19fdc3f25680946a575db9b3e60e8cd2b3fe1ddde8c7c93b57a6a3902c  include/tirtc/audio.h
+959ad21722979cf6a26ab90aaa32102d2496cc4bf7eed33c29da5c752d0c9893  include/tirtc/audio.h
 6d972ccfe150a3b4f2d7f18fa92b3ade9210c1c8bb754d061ac6b7997b59e2cb  include/tirtc/audio_codec.h
 7bacbdb2d8bb10d6444036a8fef42f2a8e3ea34dfc38e165ee678d61f189db41  include/tirtc/audio_frame.h
 84f1bbe67efa15ab3b2d995d661025aac43e2fe547a14a012a24d89cfe3cb859  include/tirtc/audio_io.h
@@ -13,20 +13,20 @@ c2e1f31dcc75be461c577d18b1cebe32774f212d51cb4dd2a5b5a9bfe62b693e  include/tirtc/
 51cbc911fe9f9834046f0e0a1a7cdd814a8e194a615894a8b4d11f9e5f095610  include/tirtc/audio_io_windows.h
 21f60729117260a44af22c1af986ef17d22673b102b7b7a035f492d0665cce16  include/tirtc/audio_processing.h
 0ca7c3c630b1242f51a0fd8154097c0a332b4c816a5707090e4381719852998c  include/tirtc/audio_sample_rate.h
-339508d784d3114dd3cbf14ad90dd6345d633ec647ca0f9bb8942eb1b83533b2  include/tirtc/av.h
+42a84eb93594b9e30d98ebd2eaf829b023a0f45433cd487a523c171f0dd4ced1  include/tirtc/av.h
 4198c95c48ae579d1c782635b00fa5c9009d0c56ba466e6e3873e8298faae029  include/tirtc/credential.h
-d29f24fc665d01ab45f993c06c09fccca2bd5c844250ddbdc3c9d8d0c8548803  include/tirtc/error.h
+fbab0b33a735aedd07284a4f1f839bd3a6613707830a18487cad5596dd47d529  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
-3fa1d5fe3c3c2644d134e13678cbf5562440a2c5d4a652dc24bf9f124731509a  include/tirtc/media_downlink.h
+b541637a57758af98f87700ec3e929edcaa064ca7604ab45dd292ea5ad48f647  include/tirtc/media_downlink.h
 21ef53b4d120aab600168c4082e7622c791ab4929fb20b3fb31f73ed01eee02a  include/tirtc/media_fixture_av_sync.h
 037d9a581cef71afe9233456b1f4ef866c3739150532f3c30a67d361e8af9eef  include/tirtc/media_fixture_source.h
 a4f8ab44c1a20ad37f250363a403a9d4d007e61ddb2426c7966dbc05f6a04b4f  include/tirtc/media_live_source.h
 1b3be6954e547f91a047866438bff1820c8406afaf91cef68ddee29a6ac70234  include/tirtc/media_uplink.h
 26b831c7b8bd69b7699017427f3243cd22393c90c9518a820f5eb87eb3792483  include/tirtc/transport.h
-185183a736774cdf737504c091e4648d7f476c16abf18ee8c8ac0da2eb9a5c79  include/tirtc/trp.h
+f664c51d7df17b50f27f64d489c74d0647624b5cce1493b3df90bb6b508bf0ca  include/tirtc/trp.h
 dff5b0a0ac4a40ad17c93e1e56b3c416371c81ab365e287ea8cd6ce37ccbed3b  include/tirtc/video_codec.h
 e51379666c199588cc33279ccf52248035d1cae3d1d468b1615ebf29f0b39c9c  include/tirtc/video_frame.h
 d920afad955b9f206b02b19ca152315190fa84ab6f24e895a5b24c3ab9ffd701  include/tirtc/video_io.h
@@ -39,14 +39,14 @@ cae0bbeb884e5466a56da15182c78cc22baab6c743f349a58d3595f623333585  include/tirtc/
 8db86d6714264047e8fd4086ddd7315722d675749719e6175f89eb5a636b48a1  lib/libTiRTC.a
 b39daee6a3d39bf0ca20c45084601133c4198de8dca848dcff6dd9c70ae99016  lib/libcrypto.a
 c052857ef315e3d61db9c862cad10709a3a6b2487dc41799cbe4d74a805de875  lib/libcrypto.dylib
-a3cbd2372889b96346fb211846de94edb5ec7f5d15af02a150c3c24efb999187  lib/libmatrix_runtime_audio.a
-012cf0bd9aaa49fe42a43de19edddb01b654df741a0f5782568c52f0d3c8dfbb  lib/libmatrix_runtime_credential.a
-75554a31b1c99be83d22f168de91584f19dc9ee69a13fe8b62d5dfdab6baf016  lib/libmatrix_runtime_facade.a
-a5235f14059d7807968353b32cefcddbebec2cc5808912898078a6c6cf9bdd50  lib/libmatrix_runtime_foundation_http.a
-dcb14497951c566352cf4b14a7b870872069824d6a2a067bfe5b421fc6500216  lib/libmatrix_runtime_foundation_logging.a
-1b1b7980f498b603132bf11dce7d24f60bdc8a11d6a0ac916c4454dde4ebbc3f  lib/libmatrix_runtime_media.a
-6d6bf7d07cc35df568582218193487235452ef47dd736f36d7de3c95ac1bde18  lib/libmatrix_runtime_transport.a
-0abee197077a906f6af3f5e05c72bcfe5b874478b65ad454b3013ab9df398af1  lib/libmatrix_runtime_video.a
+797a8b58938be816650925cbec1a947e5765464625326a1a57ac66c9328b64f4  lib/libmatrix_runtime_audio.a
+b822f5666456bbc62d17dfc3585a75c9bbfda07f3f768c74e3fed457f945422e  lib/libmatrix_runtime_credential.a
+d42e207ee2f1ab2233a30cfd0294ef8bb467c1d9c7c21a01f74d4422aab32c1d  lib/libmatrix_runtime_facade.a
+8c4f3e214392b4542cee913221ab27f75618da4e4caecb22874cb7cc06659ace  lib/libmatrix_runtime_foundation_http.a
+0672955c878a537a94d9ffd7089add8fe226bcecb2fd192929a28f69a8915f0e  lib/libmatrix_runtime_foundation_logging.a
+fea63056a3c41fa9055cd537dc9e7b0203d8411a3084f63d9b6623349eff1ec6  lib/libmatrix_runtime_media.a
+d5fffd76c16881c68d984284c8bb6872d5df71ec7e3f2c345ee8cf7dd7aa5d35  lib/libmatrix_runtime_transport.a
+f2b3fcca7d07c10fec6bd01ba18adabedd3e68489a7ef5786bf8d2bb85148d25  lib/libmatrix_runtime_video.a
 c11c65d373a127028350c41fa58cd2d1223f2b5d70a84e13b115d90daaba25ca  lib/libssl.a
 ef1c1104bbdd2528ed7b958fb7252bd6249875f92300b0c9577d6c4bd6c0d88a  lib/libssl.dylib
 e14e846e43d64e240fa0e5745bf4e702b79d0f2442e7f768beb990610735c71b  lib/libtgrtc.dylib

package/vendor/app-server/dist/host/native/RuntimeCredentialTokenIssuer.d.ts

@@ -1,11 +1,8 @@
 export type AutoTokenIssueOptions = {
-    openapiEntry?: string;
+    openapiEndpoint?: string;
     accessId: string;
     secretKey: string;
-    localId: string;
-    peerId: string;
-    userTtlSeconds?: number;
-    channelTtlSeconds?: number;
+    remoteId: string;
 };
 type RuntimeCredentialTokenIssuerOptions = {
     repoRoot: string;

package/vendor/app-server/dist/host/native/RuntimeCredentialTokenIssuer.js

@@ -95,13 +95,10 @@ class RuntimeCredentialTokenIssuer {
         let token;
         try {
             token = binding.issueToken({
-                openapiEntry: options.openapiEntry,
+                openapiEndpoint: options.openapiEndpoint,
                 accessId: options.accessId,
                 secretKey: options.secretKey,
-                localId: options.localId,
-                peerId: options.peerId,
-                userTtlSeconds: options.userTtlSeconds,
-                channelTtlSeconds: options.channelTtlSeconds,
+                remoteId: options.remoteId,
             });
         }
         catch (error) {