tirtc-devtools-cli 0.1.1 → 0.2.0

package/README.md

@@ -6,8 +6,8 @@
 
 - `token issue` / `license qrcode`：本地联调的凭据与二维码工具。
 - `assets prepare`：把默认资产或任意 MP4 准备成 native role driver 使用的媒体资产。
-- `send start`：作为标准上行端启动 native DevTools driver，送出音视频，产出 `bootstrap.json` 与 execution evidence。
-- `receive start`：作为标准下行端消费本机 `bootstrap.json` 或显式 `remote/token`，产出 `frame_dump` 与 summary。
+- `device start`：作为标准上行 device 启动 native DevTools driver，送出音视频，按需产出本机 `bootstrap.json` 与 execution evidence。
+- `client start`：作为标准下行 client 消费本机 `bootstrap.json` 或显式 device/token，产出 `frame_dump` 与 summary。
 - CLI 负责参数、环境变量、token 签发、JSON envelope、artifact 摘要与打包定位；真实 TiRTC lifecycle 由 `products/devtools/driver/` 承接。
 
 ## 不负责什么
@@ -21,7 +21,7 @@
 ## 依赖方向
 
 - token/license 工具由 CLI 自己承接；仓库级 token helper 入口为 `./script/issue_devtools_token.sh`。
-- send/receive 通过本地 native driver executable 执行，默认查找 `.build/devtools-driver/bin/<platform>/devtools_driver_probe` 或 `vendor/devtools/driver/<platform>/devtools_driver_probe`。
+- device/client 通过本地 native driver executable 执行，默认查找 `.build/devtools-driver/bin/<platform>/devtools_driver_probe` 或 `vendor/devtools/driver/<platform>/devtools_driver_probe`。
 - runtime bundle 默认查找 `.build/products/runtime/<platform>` 或 `vendor/runtime/<platform>`。
 
 ## 常用命令
@@ -38,7 +38,7 @@ node products/cli/bin/tirtc-devtools-cli.js --help
 ./script/issue_devtools_token.sh --token-only
 ```
 
-真实 send/receive 闭环优先走：
+真实 device/client 闭环优先走：
 
 ```sh
 products/devtools/driver/script/run_capability_probe.sh
@@ -50,13 +50,13 @@ products/devtools/driver/script/run_capability_probe.sh
 node products/cli/bin/tirtc-devtools-cli.js --json assets prepare \
   --source ./movie.mp4 \
   --output-root .build/tirtc-assets
-node products/cli/bin/tirtc-devtools-cli.js --json send start \
+node products/cli/bin/tirtc-devtools-cli.js --json device start \
   --source .build/tirtc-assets/manifest.json \
   --video-codec h264 \
-  --artifact-root .build/devtools-cli/send-movie-h264
+  --artifact-root .build/devtools-cli/device-movie-h264
 ```
 
-`send start` 默认持续运行直到用户结束进程；需要自动化限时时再显式传
+`device start` 默认持续运行直到用户结束进程；需要自动化限时时再显式传
 `--duration-ms <ms>`。prepared asset 会按完整音视频轨循环，任一轨到达源文件末尾时
 audio/video 同步回到源头并保持 PTS 继续递增。
 

package/USAGE.md

@@ -15,8 +15,8 @@ node products/cli/bin/tirtc-devtools-cli.js --help
 
 ## Platform Support
 
-- `macos-arm64`: supported for token, assets prepare, send, receive, package smoke, and native send+receive qualification.
-- `linux-x64`: supported for token, assets prepare, send, receive, package smoke, and native driver packaging. Linux native send/receive runs through the packaged headless driver on Linux hosts or `linux/amd64` containers.
+- `macos-arm64`: supported for token, assets prepare, device, client, package smoke, and native device+client qualification.
+- `linux-x64`: supported for token, assets prepare, device, client, package smoke, and native driver packaging. Linux native device/client runs through the packaged headless driver on Linux hosts or `linux/amd64` containers.
 
 ## Token
 
@@ -71,7 +71,7 @@ node products/cli/bin/tirtc-devtools-cli.js --json assets prepare
 node products/cli/bin/tirtc-devtools-cli.js --json assets prepare --source runtime/assets/source.mp4
 ```
 
-Prepare any MP4 and use the returned `data.manifest_path` as `send start --source`:
+Prepare any MP4 and use the returned `data.manifest_path` as `device start --source`:
 
 ```sh
 node products/cli/bin/tirtc-devtools-cli.js --json assets prepare \
@@ -79,61 +79,78 @@ node products/cli/bin/tirtc-devtools-cli.js --json assets prepare \
   --output-root .build/tirtc-assets
 ```
 
-## Send
+## Device
 
-Required environment:
+Device startup requires:
 
 ```sh
 export TIRTC_DEVICE_ID="<DEVICE_ID>"
 export TIRTC_DEVICE_SECRET_KEY="<DEVICE_SECRET_KEY>"
+export TIRTC_ENDPOINT="<SERVICE_ENTRY>"
+```
+
+These can also be passed explicitly with `--device-id`, `--device-secret-key`,
+and `--endpoint`. Missing values fail during CLI preflight before the native
+driver starts.
+
+If the local `client start --bootstrap` flow is needed, issue a fresh client
+token first:
+
+```sh
 export TIRTC_ACCESS_KEY_ID="<ACCESS_KEY_ID>"
 export TIRTC_SECRET_KEY_ID="<SECRET_KEY_ID>"
 export TIRTC_APP_ID="<APP_ID>"
-export TIRTC_ENDPOINT="<SERVICE_ENTRY>"
 export TIRTC_OPEN_API_ENDPOINT="<OPENAPI_ENDPOINT>"
+
+node products/cli/bin/tirtc-devtools-cli.js --json token issue "$TIRTC_DEVICE_ID" \
+  --endpoint "$TIRTC_ENDPOINT" \
+  --openapi-endpoint "$TIRTC_OPEN_API_ENDPOINT" \
+  > .build/devtools-client-token.json
 ```
 
-Run one send role with the default prepared asset:
+Run one device with the default prepared asset:
 
 ```sh
-node products/cli/bin/tirtc-devtools-cli.js --json send start \
+node products/cli/bin/tirtc-devtools-cli.js --json device start \
   --video-codec h264 \
-  --artifact-root .build/devtools-cli/send-h264
+  --artifact-root .build/devtools-cli/device-h264
 ```
 
-Run one send role from a prepared MP4:
+Run one device from a prepared MP4 and write a local client bootstrap:
 
 ```sh
-node products/cli/bin/tirtc-devtools-cli.js --json send start \
+node products/cli/bin/tirtc-devtools-cli.js --json device start \
   --source .build/tirtc-assets/manifest.json \
   --video-codec h264 \
-  --artifact-root .build/devtools-cli/send-movie-h264
+  --client-token-json .build/devtools-client-token.json \
+  --artifact-root .build/devtools-cli/device-movie-h264
 ```
 
-By default `send start` keeps running until the process is stopped. Use
+By default `device start` keeps running until the process is stopped. Use
 `--duration-ms <ms>` only for bounded automation. Prepared assets loop over the
 full audio/video source cycle; when either track reaches the source end, both
 tracks restart from offset 0 while PTS keeps increasing.
 
-The send role writes `bootstrap.json`. That file is a local handoff artifact for
-CLI receive, runtime sample smoke, and validation automation. The token in that
-bootstrap is intended for one receive connection.
+`device start` writes `bootstrap.json` only when `--client-token-json` is
+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.
 
 `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.
 
-## Receive
+## Client
 
 ```sh
-node products/cli/bin/tirtc-devtools-cli.js --json receive start \
-  --bootstrap .build/devtools-cli/send-h264/bootstrap.json \
-  --artifact-root .build/devtools-cli/receive-h264
+node products/cli/bin/tirtc-devtools-cli.js --json client start \
+  --bootstrap .build/devtools-cli/device-h264/bootstrap.json \
+  --artifact-root .build/devtools-cli/client-h264
 ```
 
-Receive writes `summary.json`, `events.jsonl`, runtime logs, and `render/first-video-frame.*` for `frame_dump`.
+Client writes `summary.json`, `events.jsonl`, runtime logs, and `render/first-video-frame.*` for `frame_dump`.
 
-`receive start --bootstrap` is meant for the local computer-to-computer DevTools
+`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.
 
@@ -145,4 +162,4 @@ For the current macOS gate, use the native capability runner:
 products/devtools/driver/script/run_capability_probe.sh
 ```
 
-It runs H264, H265, and MJPEG send+receive with a fresh token per case.
+It runs H264, H265, and MJPEG device+client with a fresh token per case.

package/dist/cli/src/index.js

@@ -8,6 +8,7 @@ const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
 const embedded_paths_1 = require("./embedded_paths");
 const media_assets_1 = require("./media_assets");
+const progress_1 = require("./progress");
 const token_command_1 = require("./token_command");
 const role_driver_1 = require("./role_driver");
 function resolveCliVersion() {
@@ -69,12 +70,19 @@ function printError(error, options) {
     return 1;
 }
 async function runAssetsPrepare(commandOptions, options) {
+    const progress = new progress_1.ProgressIndicator();
+    progress.start('Preparing media assets');
     try {
         const result = await (0, media_assets_1.prepareMediaAssets)({
             source: commandOptions.source ?? 'runtime/assets/source.mp4',
             outputRoot: commandOptions.outputRoot ?? 'runtime/assets/.workspace',
             overwrite: false,
+        }, {
+            progress: (message) => {
+                progress.update(message);
+            },
         });
+        progress.succeed(result.cache_hit ? 'Media assets cache hit' : 'Prepared media assets');
         if (options.json) {
             console.log(JSON.stringify({ code: 0, message: 'OK', data: result }));
         }
@@ -84,6 +92,7 @@ async function runAssetsPrepare(commandOptions, options) {
         return 0;
     }
     catch (error) {
+        progress.fail('Media assets prepare failed');
         return printError(error, options);
     }
 }
@@ -97,48 +106,53 @@ program.name('tirtc-devtools-cli')
 const assets = program.command('assets').description('准备 DevTools driver 使用的媒体资产');
 assets.command('prepare')
     .description('准备默认 runtime assets 或把显式 source 写入 output root')
-    .option('--source <path>', '输入 MP4 路径；send start 使用输出的 manifest_path')
+    .option('--source <path>', '输入 MP4 路径；device start 使用输出的 manifest_path')
     .option('--output-root <dir>', 'prepared assets 输出根目录')
     .addHelpText('after', `
 Examples:
   $ tirtc-devtools-cli --json assets prepare --source ./movie.mp4 --output-root .build/tirtc-assets
-  $ tirtc-devtools-cli --json send start --source .build/tirtc-assets/manifest.json --video-codec h264
+  $ tirtc-devtools-cli --json device start --source .build/tirtc-assets/manifest.json --video-codec h264
 `)
     .action((commandOptions) => {
     runAndExit(runAssetsPrepare(commandOptions, getCliOptions()));
 });
-const send = program.command('send').description('作为标准上行端运行 native DevTools driver');
-send.command('start')
-    .description('启动 send role，产出 bootstrap.json 与 summary.json')
-    .option('--execution-id <id>', 'runtime validation execution id')
-    .option('--case-id <id>', 'runtime validation case id')
-    .option('--app-id <id>', 'runtime validation app id')
+const device = program.command('device').description('作为标准上行 device 运行 native DevTools driver');
+device.command('start')
+    .description('启动上行 device，读取 prepared asset 并送出音视频')
     .option('--artifact-root <dir>', 'artifact 输出目录')
-    .option('--remote-id <id>', 'server remote id；默认读取 TIRTC_DEVICE_ID')
+    .option('--device-id <id>', 'device id；不传时读取 TIRTC_DEVICE_ID')
+    .option('--device-secret-key <key>', 'device secret key；不传时读取 TIRTC_DEVICE_SECRET_KEY')
+    .option('--endpoint <url>', 'TiRTC endpoint；不传时读取 TIRTC_ENDPOINT')
     .option('--source <path>', 'prepared asset root、manifest_path 或 encoded track；MP4 先运行 assets prepare')
     .option('--video-codec <codec>', 'h264|h265|mjpeg', 'h264')
     .option('--duration-ms <ms>', '可选自动结束时长；默认持续运行直到用户结束进程')
     .option('--connect-timeout-ms <ms>', 'service ready / connect 最大等待')
     .option('--first-packet-timeout-ms <ms>', '首包最大等待')
-    .option('--bootstrap-token-json <path>', 'script/issue_devtools_token.sh --json 输出文件')
+    .option('--client-token-json <path>', 'token issue --json 输出文件；传入时写出本机 bootstrap.json')
     .addHelpText('after', `
 Examples:
   $ tirtc-devtools-cli --json assets prepare --source ./movie.mp4 --output-root .build/tirtc-assets
-  $ tirtc-devtools-cli --json send start --source .build/tirtc-assets/manifest.json --artifact-root .build/tirtc-send
+  $ tirtc-devtools-cli --json device start --source .build/tirtc-assets/manifest.json --artifact-root .build/tirtc-device
 
-bootstrap.json is a local handoff artifact for receive/sample/validation automation.
+device start requires device id, device secret key, and endpoint.
+Missing flags are read from TIRTC_DEVICE_ID, TIRTC_DEVICE_SECRET_KEY, and TIRTC_ENDPOINT.
+
+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.
 `)
     .action((commandOptions) => {
-    runAndExit((0, role_driver_1.runSendStart)(commandOptions, getCliOptions()));
+    runAndExit((0, role_driver_1.runDeviceStart)(commandOptions, getCliOptions()));
 });
-const receive = program.command('receive').description('作为标准下行端运行 native DevTools driver');
-receive.command('start')
-    .description('启动 receive role，消费 bootstrap 或显式 identity 并产出 frame_dump')
+const client = program.command('client').description('作为标准下行 client 运行 native DevTools driver');
+client.command('start')
+    .description('启动下行 client，消费 bootstrap 或显式 token 并产出 frame_dump')
     .option('--artifact-root <dir>', 'artifact 输出目录')
-    .option('--bootstrap <path>', 'send role 产出的 bootstrap.json')
-    .option('--remote-id <id>', '显式 remote id；优先于 bootstrap')
+    .option('--bootstrap <path>', 'device start 产出的 bootstrap.json')
+    .option('--target-device-id <id>', '目标 device id；优先于 bootstrap')
     .option('--token <token>', '显式 token；优先于 bootstrap')
+    .option('--endpoint <url>', 'TiRTC endpoint；优先于 bootstrap')
+    .option('--app-id <id>', 'client connect app id；不传时读取 bootstrap 或 TIRTC_APP_ID')
     .option('--audio-stream-id <id>', '音频 stream id')
     .option('--video-stream-id <id>', '视频 stream id')
     .option('--consumer <consumer>', 'packet_dump|frame_dump', 'frame_dump')
@@ -149,12 +163,12 @@ receive.command('start')
     .option('--first-output-timeout-ms <ms>', '首帧输出最大等待')
     .addHelpText('after', `
 Examples:
-  $ tirtc-devtools-cli --json receive start --bootstrap .build/tirtc-send/bootstrap.json
+  $ tirtc-devtools-cli --json client start --bootstrap .build/tirtc-device/bootstrap.json
 
-bootstrap.json is expected to come from a local send start run.
+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.
 `)
     .action((commandOptions) => {
-    runAndExit((0, role_driver_1.runReceiveStart)(commandOptions, getCliOptions()));
+    runAndExit((0, role_driver_1.runClientStart)(commandOptions, getCliOptions()));
 });
 program.parse(process.argv);

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

@@ -17,9 +17,11 @@ type ExecFileLike = (file: string, args: string[], options: {
     stdout?: string | Buffer;
     stderr?: string | Buffer;
 }>;
+type ProgressCallback = (message: string) => void;
 type PrepareMediaAssetsOptions = {
     repoRoot?: string;
     execFile?: ExecFileLike;
+    progress?: ProgressCallback;
 };
 export declare function prepareMediaAssets(request: PrepareMediaAssetsRequest, options?: PrepareMediaAssetsOptions): Promise<PrepareMediaAssetsResult>;
 export {};

package/dist/cli/src/media_assets.js

@@ -18,6 +18,9 @@ class PrepareMediaAssetsError extends Error {
         this.reasonCode = reasonCode;
     }
 }
+const prepareProgressPrefix = '[prepare_runtime_media_dataset] progress: ';
+const prepareErrorPrefix = '[prepare_runtime_media_dataset] error: ';
+const prepareExecMaxBuffer = 10 * 1024 * 1024;
 function resolveRepoRoot(fromDir) {
     const candidates = [
         path_1.default.resolve(fromDir, '../../..'),
@@ -44,9 +47,43 @@ function resolvePrepareScript(repoRoot) {
     }
     return path_1.default.join(repoRoot, 'runtime/script/prepare_runtime_media_dataset.sh');
 }
+function appendBounded(chunks, text, currentSize, maxSize) {
+    const nextSize = currentSize + Buffer.byteLength(text);
+    if (nextSize > maxSize) {
+        throw new Error('media assets prepare output exceeded buffer limit');
+    }
+    chunks.push(text);
+    return nextSize;
+}
+function emitProgressLine(line, progress) {
+    if (!progress || !line.startsWith(prepareProgressPrefix)) {
+        return;
+    }
+    const message = line.slice(prepareProgressPrefix.length).trim();
+    if (message.length > 0) {
+        progress(message);
+    }
+}
+function emitBufferedProgress(stderr, progress) {
+    if (!stderr || !progress) {
+        return;
+    }
+    String(stderr)
+        .split(/\r?\n/)
+        .forEach((line) => {
+        emitProgressLine(line, progress);
+    });
+}
+function stripProgressLines(message) {
+    const lines = message.split(/\r?\n/);
+    const nonProgressLines = lines.filter((line) => !line.startsWith(prepareProgressPrefix));
+    const cleaned = nonProgressLines.join('\n').trim();
+    return cleaned.length > 0 ? cleaned : message.trim();
+}
 function normalizeExecErrorMessage(message) {
-    const prefix = '[prepare_runtime_media_dataset] error: ';
-    const normalized = message.startsWith(prefix) ? message.slice(prefix.length).trim() : message;
+    const cleaned = stripProgressLines(message);
+    const errorLine = cleaned.split(/\r?\n/).find((line) => line.startsWith(prepareErrorPrefix));
+    const normalized = errorLine ? errorLine.slice(prepareErrorPrefix.length).trim() : cleaned;
     const reasonMatch = normalized.match(/^([a-z][a-z0-9_]*):\s*(.+)$/);
     if (reasonMatch) {
         return {
@@ -56,11 +93,14 @@ function normalizeExecErrorMessage(message) {
     }
     return { message: normalized };
 }
-function parseExecError(error) {
+function parseExecError(error, progress) {
     if (!error || typeof error !== 'object') {
         return normalizeExecErrorMessage(String(error));
     }
     const typed = error;
+    if (!typed.progressEmitted) {
+        emitBufferedProgress(typed.stderr, progress);
+    }
     const stderr = typeof typed.stderr === 'string' ? typed.stderr.trim() : typed.stderr?.toString('utf8').trim();
     if (stderr && stderr.length > 0) {
         return normalizeExecErrorMessage(stderr);
@@ -85,6 +125,74 @@ function assertPrepareRequest(request) {
         throw new Error('media assets prepare requires non-empty --output-dir when provided');
     }
 }
+function execPrepareWithProgress(file, args, options) {
+    return new Promise((resolve, reject) => {
+        const child = (0, child_process_1.spawn)(file, args, {
+            cwd: options.cwd,
+            env: options.env,
+            stdio: ['ignore', 'pipe', 'pipe'],
+        });
+        const stdoutChunks = [];
+        const stderrChunks = [];
+        let stdoutSize = 0;
+        let stderrSize = 0;
+        let stderrLineBuffer = '';
+        let settled = false;
+        function rejectOnce(error) {
+            if (settled) {
+                return;
+            }
+            settled = true;
+            child.kill();
+            reject(error);
+        }
+        child.stdout.on('data', (chunk) => {
+            try {
+                stdoutSize = appendBounded(stdoutChunks, chunk.toString('utf8'), stdoutSize, options.maxBuffer);
+            }
+            catch (error) {
+                rejectOnce(error instanceof Error ? error : new Error(String(error)));
+            }
+        });
+        child.stderr.on('data', (chunk) => {
+            const text = chunk.toString('utf8');
+            try {
+                stderrSize = appendBounded(stderrChunks, text, stderrSize, options.maxBuffer);
+            }
+            catch (error) {
+                rejectOnce(error instanceof Error ? error : new Error(String(error)));
+                return;
+            }
+            stderrLineBuffer += text;
+            const lines = stderrLineBuffer.split(/\r?\n/);
+            stderrLineBuffer = lines.pop() ?? '';
+            lines.forEach((line) => {
+                emitProgressLine(line, options.progress);
+            });
+        });
+        child.on('error', (error) => {
+            rejectOnce(error);
+        });
+        child.on('close', (code, signal) => {
+            if (settled) {
+                return;
+            }
+            settled = true;
+            if (stderrLineBuffer.length > 0) {
+                emitProgressLine(stderrLineBuffer, options.progress);
+            }
+            const stdout = stdoutChunks.join('');
+            const stderr = stderrChunks.join('');
+            if (code === 0) {
+                resolve({ stdout, stderr });
+                return;
+            }
+            const error = new Error(signal ? `process killed by signal ${signal}` : `process exited with code ${code}`);
+            Object.assign(error, { stdout, stderr, progressEmitted: true });
+            reject(error);
+        });
+    });
+}
 async function prepareMediaAssets(request, options = {}) {
     assertPrepareRequest(request);
     const repoRoot = options.repoRoot ? path_1.default.resolve(options.repoRoot) : resolveDefaultRepoRoot();
@@ -108,18 +216,28 @@ async function prepareMediaAssets(request, options = {}) {
     }
     let stdout = '';
     try {
-        const result = await execFile('bash', [scriptPath, ...args], {
+        const execOptions = {
             cwd: repoRoot,
             env: {
                 ...process.env,
                 TIRTC_ENSURE_FFMPEG_SCRIPT: ensureFfmpegScriptPath,
             },
-            maxBuffer: 10 * 1024 * 1024,
-        });
+            maxBuffer: prepareExecMaxBuffer,
+        };
+        const useStreamingProgress = options.progress && !options.execFile;
+        const result = useStreamingProgress
+            ? await execPrepareWithProgress('bash', [scriptPath, ...args], {
+                ...execOptions,
+                progress: options.progress,
+            })
+            : await execFile('bash', [scriptPath, ...args], execOptions);
+        if (!useStreamingProgress) {
+            emitBufferedProgress(result.stderr, options.progress);
+        }
         stdout = String(result.stdout ?? '').trim();
     }
     catch (error) {
-        const parsed = parseExecError(error);
+        const parsed = parseExecError(error, options.progress);
         throw new PrepareMediaAssetsError(parsed.message, parsed.reasonCode);
     }
     let parsed;

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

@@ -1,24 +1,25 @@
 export type CliOptions = {
     json?: boolean;
 };
-type SendCommandOptions = {
-    executionId?: string;
-    caseId?: string;
-    appId?: string;
+type DeviceCommandOptions = {
     artifactRoot?: string;
-    remoteId?: string;
+    deviceId?: string;
+    deviceSecretKey?: string;
+    endpoint?: string;
     source?: string;
     videoCodec?: string;
     durationMs?: string;
     connectTimeoutMs?: string;
     firstPacketTimeoutMs?: string;
-    bootstrapTokenJson?: string;
+    clientTokenJson?: string;
 };
-type ReceiveCommandOptions = {
+type ClientCommandOptions = {
     artifactRoot?: string;
     bootstrap?: string;
-    remoteId?: string;
+    targetDeviceId?: string;
     token?: string;
+    endpoint?: string;
+    appId?: string;
     audioStreamId?: string;
     videoStreamId?: string;
     consumer?: string;
@@ -28,6 +29,6 @@ type ReceiveCommandOptions = {
     firstPacketTimeoutMs?: string;
     firstOutputTimeoutMs?: string;
 };
-export declare function runSendStart(commandOptions: SendCommandOptions, options: CliOptions): Promise<number>;
-export declare function runReceiveStart(commandOptions: ReceiveCommandOptions, options: CliOptions): Promise<number>;
+export declare function runDeviceStart(commandOptions: DeviceCommandOptions, options: CliOptions): Promise<number>;
+export declare function runClientStart(commandOptions: ClientCommandOptions, options: CliOptions): Promise<number>;
 export {};

package/dist/cli/src/role_driver.js

@@ -3,15 +3,14 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.runSendStart = runSendStart;
-exports.runReceiveStart = runReceiveStart;
+exports.runDeviceStart = runDeviceStart;
+exports.runClientStart = runClientStart;
 const child_process_1 = __importDefault(require("child_process"));
 const crypto_1 = __importDefault(require("crypto"));
 const fs_1 = __importDefault(require("fs"));
 const os_1 = __importDefault(require("os"));
 const path_1 = __importDefault(require("path"));
 const embedded_paths_1 = require("./embedded_paths");
-const token_tool_1 = require("./token_tool");
 const defaultAudioStreamId = 10;
 const defaultVideoStreamId = 11;
 const defaultConnectTimeoutMs = 10000;
@@ -142,13 +141,6 @@ function parseOptionalPositiveInt(raw, name) {
     }
     return parsePositiveInt(raw, 1, name);
 }
-function requireEnv(name) {
-    const value = process.env[name]?.trim();
-    if (!value) {
-        throw rolePreflightError('missing_env', 'missing environment: ' + name);
-    }
-    return value;
-}
 function executionSuffix() {
     return new Date().toISOString().replace(/[-:.TZ]/g, '').slice(0, 14);
 }
@@ -211,10 +203,30 @@ function readTokenIssueJson(filePath) {
         appId: trimOptional(parsed.data?.payload?.app_id),
     };
 }
+function resolveDeviceIdentity(options) {
+    const deviceId = trimOptional(options.deviceId) ?? trimOptional(process.env.TIRTC_DEVICE_ID);
+    const deviceSecretKey = trimOptional(options.deviceSecretKey) ??
+        trimOptional(process.env.TIRTC_DEVICE_SECRET_KEY);
+    const endpoint = trimOptional(options.endpoint) ?? trimOptional(process.env.TIRTC_ENDPOINT);
+    const missing = [];
+    if (!deviceId) {
+        missing.push('device id (pass --device-id or set TIRTC_DEVICE_ID)');
+    }
+    if (!deviceSecretKey) {
+        missing.push('device secret key (pass --device-secret-key or set TIRTC_DEVICE_SECRET_KEY)');
+    }
+    if (!endpoint) {
+        missing.push('endpoint (pass --endpoint or set TIRTC_ENDPOINT)');
+    }
+    if (missing.length > 0 || !deviceId || !deviceSecretKey || !endpoint) {
+        throw rolePreflightError('missing_env', 'device start requires ' + missing.join(' and '));
+    }
+    return { deviceId, deviceSecretKey, endpoint };
+}
 function readBootstrap(bootstrapPath) {
     const resolved = path_1.default.resolve(bootstrapPath);
     const parsed = readJson(resolved);
-    if (parsed.schema_version !== 1 || !parsed.remote_id || !parsed.token) {
+    if (parsed.schema_version !== 1 || !(parsed.device_id || parsed.remote_id) || !parsed.token) {
         throw roleUsageError('bootstrap_invalid');
     }
     return parsed;
@@ -277,62 +289,27 @@ function printEnvelope(options, code, message, data) {
         }
     }
 }
-async function buildSendRequest(roots, artifactRoot, options) {
+function buildDeviceRequest(roots, artifactRoot, options) {
     const codec = codecOrDefault(options.videoCodec);
-    const executionId = trimOptional(options.executionId) ?? 'cli-send-' + codec + '-' + executionSuffix();
-    const caseId = trimOptional(options.caseId) ?? 'devtools-cli-send.' + codec;
-    let remoteId = trimOptional(options.remoteId);
-    let endpoint = trimOptional(process.env.TIRTC_ENDPOINT);
-    let appId = trimOptional(options.appId) ?? trimOptional(process.env.TIRTC_APP_ID);
-    let token;
-    try {
-        if (options.bootstrapTokenJson) {
-            const tokenIssue = readTokenIssueJson(options.bootstrapTokenJson);
-            token = tokenIssue.token;
-            remoteId = remoteId ?? tokenIssue.remoteId;
-            endpoint = tokenIssue.endpoint ?? endpoint;
-            appId = appId ?? tokenIssue.appId;
-        }
-        else {
-            remoteId = remoteId ?? requireEnv('TIRTC_DEVICE_ID');
-            appId = appId ?? requireEnv('TIRTC_APP_ID');
-            token = await (0, token_tool_1.issueToken)({
-                accessId: requireEnv('TIRTC_ACCESS_KEY_ID'),
-                secretKey: requireEnv('TIRTC_SECRET_KEY_ID'),
-                appId,
-                remoteId,
-                openapiEndpoint: process.env.TIRTC_OPEN_API_ENDPOINT || process.env.TIRTC_OPENAPI_ENDPOINT,
-                endpoint,
-            });
-        }
-    }
-    catch (error) {
-        if (error instanceof RoleCommandError) {
-            throw error;
-        }
-        const detail = error instanceof Error ? error.message : String(error);
-        throw rolePreflightError('token_issue_failed', detail);
-    }
-    remoteId = remoteId ?? requireEnv('TIRTC_DEVICE_ID');
-    endpoint = endpoint ?? requireEnv('TIRTC_ENDPOINT');
-    appId = appId ?? requireEnv('TIRTC_APP_ID');
-    if (!token) {
-        throw rolePreflightError('token_issue_invalid', 'missing client token');
-    }
+    const executionId = 'cli-device-' + codec + '-' + executionSuffix();
+    const caseId = 'devtools-cli-device.' + codec;
+    const deviceIdentity = resolveDeviceIdentity(options);
+    const tokenIssue = options.clientTokenJson ? readTokenIssueJson(options.clientTokenJson) : undefined;
+    const bootstrap = tokenIssue ? {
+        client_token: tokenIssue.token,
+        token_fingerprint: tokenFingerprint(tokenIssue.token),
+    } : undefined;
     return {
         schema_version: 1,
         execution_id: executionId,
         case_id: caseId,
-        role: 'send',
-        endpoint,
+        role: 'device',
+        endpoint: deviceIdentity.endpoint,
         identity: {
-            license: remoteId + ',' + requireEnv('TIRTC_DEVICE_SECRET_KEY'),
-            remote_id: remoteId,
-        },
-        bootstrap: {
-            client_token: token,
-            token_fingerprint: tokenFingerprint(token),
+            license: deviceIdentity.deviceId + ',' + deviceIdentity.deviceSecretKey,
+            device_id: deviceIdentity.deviceId,
         },
+        bootstrap,
         streams: {
             audio_stream_id: defaultAudioStreamId,
             video_stream_id: defaultVideoStreamId,
@@ -349,30 +326,49 @@ async function buildSendRequest(roots, artifactRoot, options) {
             first_output_timeout_ms: defaultFirstOutputTimeoutMs,
         },
         artifact: { root_dir: artifactRoot },
-        probe: { app_id: appId },
+        probe: { app_id: tokenIssue?.appId ?? '' },
     };
 }
-function buildReceiveRequest(roots, artifactRoot, options) {
+function buildClientRequest(roots, artifactRoot, options) {
     const bootstrap = options.bootstrap ? readBootstrap(options.bootstrap) : undefined;
-    const remoteId = options.remoteId?.trim() || bootstrap?.remote_id || process.env.TIRTC_REMOTE_ID?.trim() || process.env.TIRTC_DEVICE_ID?.trim();
+    const targetDeviceId = trimOptional(options.targetDeviceId) ??
+        trimOptional(bootstrap?.device_id) ??
+        trimOptional(bootstrap?.remote_id) ??
+        trimOptional(process.env.TIRTC_TARGET_DEVICE_ID);
     const token = options.token?.trim() || bootstrap?.token || process.env.TIRTC_TOKEN?.trim();
-    if (!remoteId) {
-        throw rolePreflightError('missing_env', 'missing remote id: pass --remote-id, --bootstrap, or TIRTC_REMOTE_ID');
+    const endpoint = trimOptional(options.endpoint) ??
+        trimOptional(bootstrap?.endpoint) ??
+        trimOptional(process.env.TIRTC_ENDPOINT);
+    const appId = trimOptional(options.appId) ??
+        trimOptional(bootstrap?.app_id) ??
+        trimOptional(process.env.TIRTC_APP_ID);
+    const missing = [];
+    if (!targetDeviceId) {
+        missing.push('target device id (pass --target-device-id, --bootstrap, or set TIRTC_TARGET_DEVICE_ID)');
     }
     if (!token) {
-        throw rolePreflightError('missing_env', 'missing token: pass --token, --bootstrap, or TIRTC_TOKEN');
+        missing.push('token (pass --token, --bootstrap, or set TIRTC_TOKEN)');
     }
-    const executionId = 'cli-receive-' + executionSuffix();
-    const identityOverride = Boolean(bootstrap && (options.remoteId || options.token));
+    if (!endpoint) {
+        missing.push('endpoint (pass --endpoint, --bootstrap, or set TIRTC_ENDPOINT)');
+    }
+    if (!appId) {
+        missing.push('app id (pass --app-id, --bootstrap, or set TIRTC_APP_ID)');
+    }
+    if (missing.length > 0 || !targetDeviceId || !token || !endpoint || !appId) {
+        throw rolePreflightError('missing_env', 'client start requires ' + missing.join(' and '));
+    }
+    const executionId = 'cli-client-' + executionSuffix();
+    const identityOverride = Boolean(bootstrap && (options.targetDeviceId || options.token));
     const videoCodec = codecOrDefault(bootstrap?.video_codec);
     return {
         schema_version: 1,
         execution_id: executionId,
-        case_id: 'devtools-cli-receive',
-        role: 'receive',
-        endpoint: process.env.TIRTC_ENDPOINT?.trim() || bootstrap?.endpoint || '',
+        case_id: 'devtools-cli-client',
+        role: 'client',
+        endpoint,
         identity: {
-            remote_id: remoteId,
+            device_id: targetDeviceId,
             token,
             bootstrap_path: options.bootstrap ? path_1.default.resolve(options.bootstrap) : undefined,
             bootstrap_id: bootstrap?.bootstrap_id,
@@ -397,7 +393,7 @@ function buildReceiveRequest(roots, artifactRoot, options) {
             first_output_timeout_ms: parsePositiveInt(options.firstOutputTimeoutMs, defaultFirstOutputTimeoutMs, '--first-output-timeout-ms'),
         },
         artifact: { root_dir: artifactRoot },
-        probe: { app_id: process.env.TIRTC_APP_ID?.trim() || bootstrap?.app_id || '' },
+        probe: { app_id: appId },
     };
 }
 function runDriver(request, artifactRoot, roots) {
@@ -460,15 +456,15 @@ async function runRole(role, commandOptions, options) {
     const artifactRoot = path_1.default.resolve(commandOptions.artifactRoot ?? defaultRoot);
     ensureDir(artifactRoot);
     try {
-        const request = role === 'send' ?
-            await buildSendRequest(roots, artifactRoot, commandOptions) :
-            buildReceiveRequest(roots, artifactRoot, commandOptions);
+        const request = role === 'device' ?
+            buildDeviceRequest(roots, artifactRoot, commandOptions) :
+            buildClientRequest(roots, artifactRoot, commandOptions);
         const summary = runDriver(request, artifactRoot, roots);
         const summaryPath = path_1.default.join(artifactRoot, 'summary.json');
         const data = {
             status: summary.status,
             exit_code: summary.exit_code,
-            role: summary.role,
+            role,
             execution_id: summary.execution_id,
             artifact_root: artifactRoot,
             summary_path: summaryPath,
@@ -497,9 +493,9 @@ async function runRole(role, commandOptions, options) {
         return normalized.exitCode;
     }
 }
-function runSendStart(commandOptions, options) {
-    return runRole('send', commandOptions, options);
+function runDeviceStart(commandOptions, options) {
+    return runRole('device', commandOptions, options);
 }
-function runReceiveStart(commandOptions, options) {
-    return runRole('receive', commandOptions, options);
+function runClientStart(commandOptions, options) {
+    return runRole('client', commandOptions, options);
 }

package/package.json

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

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

@@ -91,6 +91,28 @@ typedef enum TirtcError {
   TIRTC_ERROR_VIDEO_DECODER_INPUT_PENDING = 6081,
   TIRTC_ERROR_VIDEO_DECODER_OUTPUT_PENDING = 6082,
   TIRTC_ERROR_MEDIA_UPLINK_INPUT_MODE_MISMATCH = 6083,
+  TIRTC_ERROR_TRANSPORT_CONNECT_INVOCATION_FAILED = 6084,
+  TIRTC_ERROR_TRANSPORT_DISCONNECT_STATE_UNEXPECTED = 6085,
+  TIRTC_ERROR_HTTP_TRANSPORT_FAILED = 6086,
+  TIRTC_ERROR_LOG_UPLOAD_ENDPOINT_RESPONSE_INVALID = 6087,
+  TIRTC_ERROR_LOG_UPLOAD_TOKEN_RESPONSE_INVALID = 6088,
+  TIRTC_ERROR_TRANSPORT_BACKEND_UNKNOWN_STATUS = 6089,
+  TIRTC_ERROR_TRANSPORT_BACKEND_CONNECTION_OTHER_ERROR = 6090,
+  TIRTC_ERROR_FACADE_HANDLE_UNAVAILABLE = 6091,
+  TIRTC_ERROR_AUDIO_PROCESSING_STATE_INVALID = 6092,
+  TIRTC_ERROR_AUDIO_PROCESSING_CONFIGURATION_FAILED = 6093,
+  TIRTC_ERROR_AUDIO_PROCESSING_PROCESS_FAILED = 6094,
+  TIRTC_ERROR_VIDEO_ENCODER_STATE_INVALID = 6095,
+  TIRTC_ERROR_VIDEO_ENCODER_INPUT_REJECTED = 6096,
+  TIRTC_ERROR_VIDEO_ENCODER_OUTPUT_RETRIEVE_FAILED = 6097,
+  TIRTC_ERROR_VIDEO_ENCODER_OUTPUT_CONVERSION_FAILED = 6098,
+  TIRTC_ERROR_VIDEO_ENCODER_CONTROL_REQUEST_FAILED = 6099,
+  TIRTC_ERROR_VIDEO_DECODER_STATE_INVALID = 6100,
+  TIRTC_ERROR_VIDEO_DECODER_INPUT_REJECTED = 6101,
+  TIRTC_ERROR_VIDEO_DECODER_OUTPUT_RETRIEVE_FAILED = 6102,
+  TIRTC_ERROR_VIDEO_DECODER_OUTPUT_CONVERSION_FAILED = 6103,
+  TIRTC_ERROR_VIDEO_DECODER_OUTPUT_RELEASE_FAILED = 6104,
+  TIRTC_ERROR_TRANSPORT_BACKEND_NOT_INITIALIZED = 6105,
 } TirtcError;
 
 const char* tirtc_error_to_string(TirtcError error);

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

@@ -1,6 +1,6 @@
 platform=linux-x64
 profile=full
-staged_at_utc=2026-04-30T09:36:57Z
+staged_at_utc=2026-04-30T14:15:15Z
 source_sdk=/Users/allenfeng/Development/Repositories/tirtc-nexus/tirtc-matrix/.build/sdk/linux-x64
 
 bfc096be1484ac2b1c2776ccabfa2a4c6a982e869abf875192ff06fad85e82ca  include/tirtc/audio.h
@@ -14,7 +14,7 @@ c2e1f31dcc75be461c577d18b1cebe32774f212d51cb4dd2a5b5a9bfe62b693e  include/tirtc/
 21f60729117260a44af22c1af986ef17d22673b102b7b7a035f492d0665cce16  include/tirtc/audio_processing.h
 0ca7c3c630b1242f51a0fd8154097c0a332b4c816a5707090e4381719852998c  include/tirtc/audio_sample_rate.h
 58807ba56770f38f47aec995661cadf9d3c1d6ea7bfc940767f1ce67317c7546  include/tirtc/av.h
-0f3e2f454c35e8c2f79bdc93ed77f9f1622751e5a05defa8c9d4213ed8a797c5  include/tirtc/error.h
+b3e110ce04057d3be696b120d1abeaf6141711a1c63ca7f9bdf65ed5ec6e16d7  include/tirtc/error.h
 ae805545a9515edc9b94262e72ad2c7b7d649288166f4daeb450d8a55e82ae0b  include/tirtc/foundation/build_info.h
 7cf8b372a3d48d4de4a65a04c7f102281a7b42cebb9ec247853d3c53afb63b6a  include/tirtc/http.h
 70bbf93b84d9d1a85f376d9986de570c1f658319e1e5ab6d621f7a4d41033f5c  include/tirtc/logging.h
@@ -33,13 +33,13 @@ cae0bbeb884e5466a56da15182c78cc22baab6c743f349a58d3595f623333585  include/tirtc/
 8cd6b66bea14890a665cc317f8572429b2c3e4463773f8b77c1e4dc30a4a8747  include/tirtc/video_processing.h
 ceb7cdd45efae57e5bd53d4177cb20c4a0cb9917fcdd23127b050d69c8b919ac  lib/libTiRTC.a
 b1f4135025cb8e8520a14268d831b9998920a4239f84bb6b409d0e4909fd5bee  lib/libcrypto.a
-8e3aff3a400fe0971c61511947c0e69d06754002d970e21eaab2339ae38b4a42  lib/libmatrix_runtime_audio.a
-09696896a45a4fab199f0767979471c947b252fc8741a0e803624cdac6953b59  lib/libmatrix_runtime_facade.a
-2c8cc881eeeae679129360df5813dec17d0e33935f196d79cf79671dbd0c8581  lib/libmatrix_runtime_foundation_http.a
-e5aff9f5d9221b9cf08dd8a9144c6039d9dba7bdee3892af2d0e7f7d69633461  lib/libmatrix_runtime_foundation_logging.a
-fe6b5575ce5e80f81e07a7799a05d0a8ee5a338915a28ada86d9009eee952e96  lib/libmatrix_runtime_media.a
-86d9b41f84c6bcc13f8d23a1f9b46d97fe6769573758722f9f6c8d4a130306be  lib/libmatrix_runtime_transport.a
-6ac178f5cd371e9a5be1989dd1e8a3767291f4c4d9d30dcf12ecdd75a2081afa  lib/libmatrix_runtime_video.a
+296ba0b5efa9d2ac49e3bf278c5d467b31436e73fbc608b736e974bcf9759bde  lib/libmatrix_runtime_audio.a
+88f9c545943e4ef80024baf3620e91817ec16a4fea60b0e8c7887a0a41dc9d1b  lib/libmatrix_runtime_facade.a
+ec7bbf8e8744c6645a441a28e24e0645906152cc987d6fcca16af3c3badba940  lib/libmatrix_runtime_foundation_http.a
+4038af89ac4dc7e7c99ac9ace58ce063661ddb3134f71664b79221ade4adb8d1  lib/libmatrix_runtime_foundation_logging.a
+9c7108b70cb442dee02cfdb4f98891a8a099f15c379e9e48cf53d7b276f6e894  lib/libmatrix_runtime_media.a
+fc498c74804ef35dc3939a6368d9ae908b0e35578db32eb7902ad00107781295  lib/libmatrix_runtime_transport.a
+337d38891e264e76aeb61a4e25a3b0bad56ab26697948805e64dec920874093f  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/error.h

@@ -91,6 +91,28 @@ typedef enum TirtcError {
   TIRTC_ERROR_VIDEO_DECODER_INPUT_PENDING = 6081,
   TIRTC_ERROR_VIDEO_DECODER_OUTPUT_PENDING = 6082,
   TIRTC_ERROR_MEDIA_UPLINK_INPUT_MODE_MISMATCH = 6083,
+  TIRTC_ERROR_TRANSPORT_CONNECT_INVOCATION_FAILED = 6084,
+  TIRTC_ERROR_TRANSPORT_DISCONNECT_STATE_UNEXPECTED = 6085,
+  TIRTC_ERROR_HTTP_TRANSPORT_FAILED = 6086,
+  TIRTC_ERROR_LOG_UPLOAD_ENDPOINT_RESPONSE_INVALID = 6087,
+  TIRTC_ERROR_LOG_UPLOAD_TOKEN_RESPONSE_INVALID = 6088,
+  TIRTC_ERROR_TRANSPORT_BACKEND_UNKNOWN_STATUS = 6089,
+  TIRTC_ERROR_TRANSPORT_BACKEND_CONNECTION_OTHER_ERROR = 6090,
+  TIRTC_ERROR_FACADE_HANDLE_UNAVAILABLE = 6091,
+  TIRTC_ERROR_AUDIO_PROCESSING_STATE_INVALID = 6092,
+  TIRTC_ERROR_AUDIO_PROCESSING_CONFIGURATION_FAILED = 6093,
+  TIRTC_ERROR_AUDIO_PROCESSING_PROCESS_FAILED = 6094,
+  TIRTC_ERROR_VIDEO_ENCODER_STATE_INVALID = 6095,
+  TIRTC_ERROR_VIDEO_ENCODER_INPUT_REJECTED = 6096,
+  TIRTC_ERROR_VIDEO_ENCODER_OUTPUT_RETRIEVE_FAILED = 6097,
+  TIRTC_ERROR_VIDEO_ENCODER_OUTPUT_CONVERSION_FAILED = 6098,
+  TIRTC_ERROR_VIDEO_ENCODER_CONTROL_REQUEST_FAILED = 6099,
+  TIRTC_ERROR_VIDEO_DECODER_STATE_INVALID = 6100,
+  TIRTC_ERROR_VIDEO_DECODER_INPUT_REJECTED = 6101,
+  TIRTC_ERROR_VIDEO_DECODER_OUTPUT_RETRIEVE_FAILED = 6102,
+  TIRTC_ERROR_VIDEO_DECODER_OUTPUT_CONVERSION_FAILED = 6103,
+  TIRTC_ERROR_VIDEO_DECODER_OUTPUT_RELEASE_FAILED = 6104,
+  TIRTC_ERROR_TRANSPORT_BACKEND_NOT_INITIALIZED = 6105,
 } TirtcError;
 
 const char* tirtc_error_to_string(TirtcError error);

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

@@ -1,6 +1,6 @@
 platform=macos-arm64
 profile=full
-staged_at_utc=2026-04-30T09:35:10Z
+staged_at_utc=2026-04-30T14:13:34Z
 source_sdk=/Users/allenfeng/Development/Repositories/tirtc-nexus/tirtc-matrix/.build/sdk/macos-arm64
 
 bfc096be1484ac2b1c2776ccabfa2a4c6a982e869abf875192ff06fad85e82ca  include/tirtc/audio.h
@@ -14,7 +14,7 @@ c2e1f31dcc75be461c577d18b1cebe32774f212d51cb4dd2a5b5a9bfe62b693e  include/tirtc/
 21f60729117260a44af22c1af986ef17d22673b102b7b7a035f492d0665cce16  include/tirtc/audio_processing.h
 0ca7c3c630b1242f51a0fd8154097c0a332b4c816a5707090e4381719852998c  include/tirtc/audio_sample_rate.h
 58807ba56770f38f47aec995661cadf9d3c1d6ea7bfc940767f1ce67317c7546  include/tirtc/av.h
-0f3e2f454c35e8c2f79bdc93ed77f9f1622751e5a05defa8c9d4213ed8a797c5  include/tirtc/error.h
+b3e110ce04057d3be696b120d1abeaf6141711a1c63ca7f9bdf65ed5ec6e16d7  include/tirtc/error.h
 ae805545a9515edc9b94262e72ad2c7b7d649288166f4daeb450d8a55e82ae0b  include/tirtc/foundation/build_info.h
 7cf8b372a3d48d4de4a65a04c7f102281a7b42cebb9ec247853d3c53afb63b6a  include/tirtc/http.h
 70bbf93b84d9d1a85f376d9986de570c1f658319e1e5ab6d621f7a4d41033f5c  include/tirtc/logging.h
@@ -35,13 +35,13 @@ cae0bbeb884e5466a56da15182c78cc22baab6c743f349a58d3595f623333585  include/tirtc/
 8db86d6714264047e8fd4086ddd7315722d675749719e6175f89eb5a636b48a1  lib/libTiRTC.a
 b39daee6a3d39bf0ca20c45084601133c4198de8dca848dcff6dd9c70ae99016  lib/libcrypto.a
 c052857ef315e3d61db9c862cad10709a3a6b2487dc41799cbe4d74a805de875  lib/libcrypto.dylib
-8196040f7450f650ebdfcb15abe5b08c0b7e2dcb93c9c8cb557e2a831fd032ae  lib/libmatrix_runtime_audio.a
-24dad84f6d7f29841cd73ef069d44d5bccf9db234bfd3adeda0ee048d1448509  lib/libmatrix_runtime_facade.a
-12ccfbe34a6ed3496c9cbbdc9c58193daac90987b792eae3535743cfa76d0a67  lib/libmatrix_runtime_foundation_http.a
-caddced4a0d14c5256b1e53683e7655034ac57bbad0288b5a3d9451633470984  lib/libmatrix_runtime_foundation_logging.a
-6f0ec3bb2586ac965c67692e8e746a030512a4f3622d2a92e5892aa8267a2e05  lib/libmatrix_runtime_media.a
-31797ff96ad7a63a898e22b30c97be6cea5cd9f95bdd6354c6054666b1f96f37  lib/libmatrix_runtime_transport.a
-6de3cc7602dd1da437fcf803f72d81b08a82b061bc743dcae8b72d838dfaf284  lib/libmatrix_runtime_video.a
+9466d90d68de9ea40a5ef2c5ff393fe94f3ec22f410dcc9c1707253344971a17  lib/libmatrix_runtime_audio.a
+8bc2920d99c7cf575af169baeba9725951d56d3891e2ba4bf50d99023ac4608c  lib/libmatrix_runtime_facade.a
+3d3ef3d682052b7ab982b82597a3810e091ab4eb3a6b40177a88d60d0391d800  lib/libmatrix_runtime_foundation_http.a
+e329006b0f653f338c22addb307bd5fca56163e8f6ab6adf3d8ce2fa83c28523  lib/libmatrix_runtime_foundation_logging.a
+1e7e5b699d3625d4ba3b514b21d43ca3915d6a3f15997a74de93d86509d4e58f  lib/libmatrix_runtime_media.a
+7945859c05cbc4e55f95b1eee109e0f604d90ff3cbe69bb17e3932b6b094ad01  lib/libmatrix_runtime_transport.a
+b93f5eec5e4fe4278c161095c3b3445f71f78898f4b293efc2b7299d18c91253  lib/libmatrix_runtime_video.a
 c11c65d373a127028350c41fa58cd2d1223f2b5d70a84e13b115d90daaba25ca  lib/libssl.a
 ef1c1104bbdd2528ed7b958fb7252bd6249875f92300b0c9577d6c4bd6c0d88a  lib/libssl.dylib
 e14e846e43d64e240fa0e5745bf4e702b79d0f2442e7f768beb990610735c71b  lib/libtgrtc.dylib

package/vendor/runtime/script/prepare_runtime_media_dataset.sh

@@ -20,6 +20,10 @@ fail() {
   exit 1
 }
 
+progress() {
+  echo "[prepare_runtime_media_dataset] progress: $*" >&2
+}
+
 require_cmd() {
   command -v "$1" >/dev/null 2>&1 || fail "missing required command: $1"
 }
@@ -145,6 +149,7 @@ readonly k_audio_codec="g711a"
 readonly k_output_audio_format="pcm_s16"
 readonly k_output_video_format="rgba8888"
 
+progress "checking source media streams"
 AUDIO_STREAM_PRESENT="$(
   AUDIO_STREAM_JSON="$("$FFPROBE_BIN" -v error -select_streams a:0 \
     -show_entries stream=index -of json "$SOURCE_ABS")" \
@@ -230,6 +235,7 @@ fi
 MANIFEST_PATH="$ASSETS_DIR/manifest.json"
 
 if [[ -f "$MANIFEST_PATH" && "$OVERWRITE" -ne 1 ]]; then
+  progress "using cached prepared media assets"
   emit_result "$ASSETS_DIR" "$MANIFEST_PATH" true
   exit 0
 fi
@@ -274,6 +280,7 @@ else
   video_encode_args+=(-crf 18)
 fi
 
+progress "encoding h264 video track"
 "$FFMPEG_BIN" -hide_banner -loglevel error -y \
   -i "$SOURCE_ABS" \
   -an \
@@ -302,6 +309,7 @@ else
   video_h265_encode_args+=(-crf 23)
 fi
 
+progress "encoding h265 video track"
 "$FFMPEG_BIN" -hide_banner -loglevel error -y \
   -i "$SOURCE_ABS" \
   -an \
@@ -311,6 +319,7 @@ fi
 
 mjpeg_frame_dir="$ASSETS_DIR/video/mjpeg_frames"
 mkdir -p "$mjpeg_frame_dir"
+progress "extracting mjpeg video frames"
 "$FFMPEG_BIN" -hide_banner -loglevel error -y \
   -i "$SOURCE_ABS" \
   -vf "fps=1/${k_mjpeg_extract_interval_seconds},scale=${TARGET_VIDEO_WIDTH}:${TARGET_VIDEO_HEIGHT}:flags=lanczos" \
@@ -326,6 +335,7 @@ if ! find "$mjpeg_frame_dir" -type f -name 'frame_*.jpg' | grep -q .; then
     "$mjpeg_frame_dir/frame_000001.jpg"
 fi
 
+progress "encoding 8k g711a audio track"
 "$FFMPEG_BIN" -hide_banner -loglevel error -y \
   -i "$SOURCE_ABS" \
   -vn \
@@ -335,6 +345,7 @@ fi
   -f alaw \
   "$AUDIO_PATH"
 
+progress "encoding 16k g711a audio track"
  "$FFMPEG_BIN" -hide_banner -loglevel error -y \
   -i "$SOURCE_ABS" \
   -vn \
@@ -344,6 +355,7 @@ fi
   -f alaw \
   "$AUDIO_16K_PATH"
 
+progress "indexing h264 video packets"
 VIDEO_PACKET_INDEX_PATH="$VIDEO_H264_PACKET_INDEX_PATH" \
 VIDEO_PATH="$VIDEO_H264_PATH" \
 VIDEO_FPS="$k_video_fps" \
@@ -441,6 +453,7 @@ for (let index = 0; index < packetOffsets.length; index += 1) {
 fs.writeFileSync(outputPath, `${lines.join('\n')}\n`, 'utf8');
 NODE
 
+progress "indexing h265 video packets"
 VIDEO_PACKET_INDEX_PATH="$VIDEO_H265_PACKET_INDEX_PATH" \
 VIDEO_PATH="$VIDEO_H265_PATH" \
 VIDEO_FPS="$k_video_fps" \
@@ -538,6 +551,7 @@ for (let index = 0; index < packetOffsets.length; index += 1) {
 fs.writeFileSync(outputPath, `${lines.join('\n')}\n`, 'utf8');
 NODE
 
+progress "indexing mjpeg video packets"
 VIDEO_MJPEG_PATH="$VIDEO_MJPEG_PATH" \
 VIDEO_MJPEG_PACKET_INDEX_PATH="$VIDEO_MJPEG_PACKET_INDEX_PATH" \
 MJPEG_FRAME_DIR="$mjpeg_frame_dir" \
@@ -593,6 +607,7 @@ for (let index = 0; index < packetCount; index += 1) {
 fs.writeFileSync(indexPath, `${lines.join('\n')}\n`, 'utf8');
 NODE
 
+progress "indexing 8k g711a audio packets"
 AUDIO_BYTES="$(wc -c < "$AUDIO_PATH" | tr -d '[:space:]')"
 AUDIO_PACKET_BYTES=$((k_audio_sample_rate_hz * k_audio_packet_duration_ms / 1000))
 [[ "$AUDIO_PACKET_BYTES" -gt 0 ]] || fail "invalid audio packet bytes"
@@ -624,6 +639,7 @@ AUDIO_PACKET_COUNT=$((AUDIO_BYTES / AUDIO_PACKET_BYTES))
   done
 } > "$AUDIO_PACKET_INDEX_PATH"
 
+progress "indexing 16k g711a audio packets"
 AUDIO_16K_BYTES="$(wc -c < "$AUDIO_16K_PATH" | tr -d '[:space:]')"
 AUDIO_16K_PACKET_BYTES=$((k_audio_sample_rate_16k_hz * k_audio_packet_duration_ms / 1000))
 [[ "$AUDIO_16K_PACKET_BYTES" -gt 0 ]] || fail "invalid 16k audio packet bytes"
@@ -655,6 +671,7 @@ AUDIO_16K_PACKET_COUNT=$((AUDIO_16K_BYTES / AUDIO_16K_PACKET_BYTES))
   done
 } > "$AUDIO_16K_PACKET_INDEX_PATH"
 
+progress "writing prepared media manifest"
 cat > "$MANIFEST_PATH" <<JSON
 {
   "schema_version": ${k_schema_version},