tirtc-devtools-cli 0.1.1 → 0.1.2

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);
     }
 }

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/package.json

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

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-30T09:51:52Z
 source_sdk=/Users/allenfeng/Development/Repositories/tirtc-nexus/tirtc-matrix/.build/sdk/linux-x64
 
 bfc096be1484ac2b1c2776ccabfa2a4c6a982e869abf875192ff06fad85e82ca  include/tirtc/audio.h
@@ -36,7 +36,7 @@ b1f4135025cb8e8520a14268d831b9998920a4239f84bb6b409d0e4909fd5bee  lib/libcrypto.
 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
+4623c3c72a263f0397e554435e4998551c274b5b40f98f331902a8c0c8a29e3e  lib/libmatrix_runtime_foundation_logging.a
 fe6b5575ce5e80f81e07a7799a05d0a8ee5a338915a28ada86d9009eee952e96  lib/libmatrix_runtime_media.a
 86d9b41f84c6bcc13f8d23a1f9b46d97fe6769573758722f9f6c8d4a130306be  lib/libmatrix_runtime_transport.a
 6ac178f5cd371e9a5be1989dd1e8a3767291f4c4d9d30dcf12ecdd75a2081afa  lib/libmatrix_runtime_video.a

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-30T09:50:11Z
 source_sdk=/Users/allenfeng/Development/Repositories/tirtc-nexus/tirtc-matrix/.build/sdk/macos-arm64
 
 bfc096be1484ac2b1c2776ccabfa2a4c6a982e869abf875192ff06fad85e82ca  include/tirtc/audio.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
+d6f03b56a9de8db6b283acbdd9fc2805d23d672f4cb88749f55a627443b2519f  lib/libmatrix_runtime_audio.a
+7524498dba92087ba33853290db0cfaa0ec79b50ffdf22c8e35b0484c24af7cc  lib/libmatrix_runtime_facade.a
+05687add5f3f27adea62568b9d42be52659a494500cce0245d601da566aa45e3  lib/libmatrix_runtime_foundation_http.a
+89af61f8a48b2c7cfa9c80de8b9a708bca4ac2b1b4b2929d1d932a5c4d422501  lib/libmatrix_runtime_foundation_logging.a
+6a61357646112e1427db956ba87766838b51bdd7d8aec43ec07c2aba20570ee7  lib/libmatrix_runtime_media.a
+cc39fbeacd2c8cd6b508cd3300bf8fd5b6a93f6d2d19b160b65ed03deca777c4  lib/libmatrix_runtime_transport.a
+7ab317069e6bdeb3d24d215cd7bb6f298ea47cf1cff43ac36460aaab7effbd8d  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},