tirtc-devtools-cli 0.0.10 → 0.0.12

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

@@ -1,8 +1,9 @@
 platform=macos-arm64
-staged_at_utc=2026-04-10T04:27:48Z
+profile=credential
+staged_at_utc=2026-04-21T13:44:23Z
 source_sdk=/Users/allenfeng/Development/Repositories/tirtc-nexus/tirtc-matrix/.build/sdk/macos-arm64
 
-dcca0b7ab8055d84e5bcfab7f1dde56df9037c40ddb99e9ca924ef2e867d8309  include/tirtc/audio.h
+bfea7c19fdc3f25680946a575db9b3e60e8cd2b3fe1ddde8c7c93b57a6a3902c  include/tirtc/audio.h
 6d972ccfe150a3b4f2d7f18fa92b3ade9210c1c8bb754d061ac6b7997b59e2cb  include/tirtc/audio_codec.h
 7bacbdb2d8bb10d6444036a8fef42f2a8e3ea34dfc38e165ee678d61f189db41  include/tirtc/audio_frame.h
 84f1bbe67efa15ab3b2d995d661025aac43e2fe547a14a012a24d89cfe3cb859  include/tirtc/audio_io.h
@@ -12,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
-59b7df33fdc2ad92b3142299ffab832443179ef895784ad51a2f6544c5b02766  include/tirtc/av.h
+339508d784d3114dd3cbf14ad90dd6345d633ec647ca0f9bb8942eb1b83533b2  include/tirtc/av.h
 4198c95c48ae579d1c782635b00fa5c9009d0c56ba466e6e3873e8298faae029  include/tirtc/credential.h
-78625b8d9f1f29bf2f35a89a8ad8a3f68f3f6ff75455d4682f5514c6c0ad7738  include/tirtc/error.h
+d29f24fc665d01ab45f993c06c09fccca2bd5c844250ddbdc3c9d8d0c8548803  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
-71eab7553274dee4cc6ea3cbaf345a9858e2bf73fe7e928a1a23851d431f3b4d  include/tirtc/media_downlink.h
+3fa1d5fe3c3c2644d134e13678cbf5562440a2c5d4a652dc24bf9f124731509a  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
-97ab19361d22a723af589ebae8bb08b5a7ccd8ca3aff0b85aa9ffd577252b6fc  include/tirtc/transport.h
-137729c534213cb161c0853a8d4d38fcdc397c41a7fd8c813fbe0e80083ec931  include/tirtc/trp.h
+26b831c7b8bd69b7699017427f3243cd22393c90c9518a820f5eb87eb3792483  include/tirtc/transport.h
+185183a736774cdf737504c091e4648d7f476c16abf18ee8c8ac0da2eb9a5c79  include/tirtc/trp.h
 dff5b0a0ac4a40ad17c93e1e56b3c416371c81ab365e287ea8cd6ce37ccbed3b  include/tirtc/video_codec.h
 e51379666c199588cc33279ccf52248035d1cae3d1d468b1615ebf29f0b39c9c  include/tirtc/video_frame.h
 d920afad955b9f206b02b19ca152315190fa84ab6f24e895a5b24c3ab9ffd701  include/tirtc/video_io.h
@@ -34,17 +35,20 @@ d920afad955b9f206b02b19ca152315190fa84ab6f24e895a5b24c3ab9ffd701  include/tirtc/
 cae0bbeb884e5466a56da15182c78cc22baab6c743f349a58d3595f623333585  include/tirtc/video_io_harmony.h
 65b5d24fe3a6bc2a299a2220148a153ba4eb0955a49c1c3baabf1fdfed8aabdd  include/tirtc/video_io_windows.h
 8cd6b66bea14890a665cc317f8572429b2c3e4463773f8b77c1e4dc30a4a8747  include/tirtc/video_processing.h
+5052a464a34508f117fec46aa6b836871014229d4290d7d8caac862e0165ae8f  lib/libTGTRP.a
+8db86d6714264047e8fd4086ddd7315722d675749719e6175f89eb5a636b48a1  lib/libTiRTC.a
 b39daee6a3d39bf0ca20c45084601133c4198de8dca848dcff6dd9c70ae99016  lib/libcrypto.a
 c052857ef315e3d61db9c862cad10709a3a6b2487dc41799cbe4d74a805de875  lib/libcrypto.dylib
-17545a8539f86995500b7fcaee3d1f1e5684e8f11e6094558aee46c6a9cc74a8  lib/libmatrix_runtime_audio.a
-bf00c3fcccbfc29696a2ee4ff6ff55e510672a2337af6c975c83d295a970a85f  lib/libmatrix_runtime_credential.a
-33ce400a5dfd7a234a4391bc5dd531a9a0401f6d27252246898797d8d0dcf4ed  lib/libmatrix_runtime_facade.a
-525c15bd4e23642c1e9939b8114828ec47d7381fb6cf30cb9c66be3181b9c70c  lib/libmatrix_runtime_foundation_http.a
-d7cf5cd5723bbfcd3bef9191570870413303b0b67c8644c9a5bf30e194fdd487  lib/libmatrix_runtime_foundation_logging.a
-fefdbe0acc0dc73dd0b48fb0cd927875c5e43674e163c7ba33f57e59d2f0b178  lib/libmatrix_runtime_media.a
-9361b2a4784b3068a8796033fa36f1969297bbcd4ae59f96da1725e0a27fb481  lib/libmatrix_runtime_transport.a
-7e6f54cf23ad2a59f08e274e63fc25ae74f9f9b687dff08f73091789d647a94c  lib/libmatrix_runtime_video.a
+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
 c11c65d373a127028350c41fa58cd2d1223f2b5d70a84e13b115d90daaba25ca  lib/libssl.a
 ef1c1104bbdd2528ed7b958fb7252bd6249875f92300b0c9577d6c4bd6c0d88a  lib/libssl.dylib
+e14e846e43d64e240fa0e5745bf4e702b79d0f2442e7f768beb990610735c71b  lib/libtgrtc.dylib
 dc3e0e6ded26e90fd59c166933a5289d57f4cf25fbe6246b6b83c86fe898e63d  lib/libwebrtc_apm.a
 6b1b182cb43ad0b81b19d10f4762b137ee7571a527d0b500f31a227e5e162cb1  lib/libxlog.a

package/vendor/app-server/dist/host/HostCommandCoordinator.d.ts

@@ -0,0 +1,19 @@
+import { CommandPendingConnectionSummary, HostState } from './HostState';
+import { RuntimeAdapter } from './RuntimeAdapter';
+import { CommandReplyParams, CommandSendParams } from './HostProtocol';
+type WriteEvent = (family: string, kind: string, payload: Record<string, unknown>) => void;
+type NoteIncomingConnection = (payload: Record<string, unknown>) => void;
+export declare class HostCommandCoordinator {
+    private readonly state;
+    private readonly runtimeAdapter;
+    private readonly writeEvent;
+    private readonly snapshotPendingConnectionSummary;
+    private readonly noteIncomingConnection;
+    constructor(state: HostState, runtimeAdapter: RuntimeAdapter, writeEvent: WriteEvent, snapshotPendingConnectionSummary: () => CommandPendingConnectionSummary, noteIncomingConnection: NoteIncomingConnection);
+    handleInboundRemoteCommandRequest(payload: Record<string, unknown>): void;
+    clearPendingRemoteCommands(reason: string): void;
+    handleCommandSend(params: CommandSendParams, nextSequenceNumber: number): Promise<unknown>;
+    handleCommandReply(params: CommandReplyParams): Promise<unknown>;
+    handleCommandPendingList(): Promise<unknown>;
+}
+export {};

package/vendor/app-server/dist/host/HostCommandCoordinator.js

@@ -0,0 +1,196 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HostCommandCoordinator = void 0;
+const HostProtocol_1 = require("./HostProtocol");
+function normalizeCommandPayload(payload) {
+    if (typeof payload === 'string') {
+        return {
+            payloadEncoding: 'utf8',
+            payload,
+        };
+    }
+    if (payload instanceof Uint8Array) {
+        return {
+            payloadEncoding: 'base64',
+            payload: Buffer.from(payload).toString('base64'),
+        };
+    }
+    if (Array.isArray(payload) && payload.every((value) => typeof value === 'number')) {
+        return {
+            payloadEncoding: 'base64',
+            payload: Buffer.from(payload).toString('base64'),
+        };
+    }
+    if (typeof payload === 'object' && payload !== null && 'type' in payload && payload.type === 'Buffer') {
+        const data = payload.data;
+        if (Array.isArray(data) && data.every((value) => typeof value === 'number')) {
+            return {
+                payloadEncoding: 'base64',
+                payload: Buffer.from(data).toString('base64'),
+            };
+        }
+    }
+    return {
+        payloadEncoding: 'utf8',
+        payload: '',
+    };
+}
+class HostCommandCoordinator {
+    state;
+    runtimeAdapter;
+    writeEvent;
+    snapshotPendingConnectionSummary;
+    noteIncomingConnection;
+    constructor(state, runtimeAdapter, writeEvent, snapshotPendingConnectionSummary, noteIncomingConnection) {
+        this.state = state;
+        this.runtimeAdapter = runtimeAdapter;
+        this.writeEvent = writeEvent;
+        this.snapshotPendingConnectionSummary = snapshotPendingConnectionSummary;
+        this.noteIncomingConnection = noteIncomingConnection;
+    }
+    handleInboundRemoteCommandRequest(payload) {
+        const remoteRequestId = Number(payload.remoteRequestId);
+        const commandId = Number(payload.commandId);
+        if (!Number.isInteger(remoteRequestId) || remoteRequestId <= 0 || !Number.isInteger(commandId)) {
+            return;
+        }
+        this.noteIncomingConnection(payload);
+        const normalizedPayload = normalizeCommandPayload(payload.payload);
+        const entry = {
+            remoteRequestId,
+            commandId,
+            payloadEncoding: normalizedPayload.payloadEncoding,
+            payload: normalizedPayload.payload,
+            receivedAt: new Date().toISOString(),
+            connection: this.snapshotPendingConnectionSummary(),
+        };
+        this.state.pendingRemoteCommands.set(remoteRequestId, entry);
+        this.writeEvent('command', 'command.remote.requested', {
+            ...entry,
+        });
+    }
+    clearPendingRemoteCommands(reason) {
+        if (this.state.pendingRemoteCommands.size === 0) {
+            return;
+        }
+        const clearedAt = new Date().toISOString();
+        for (const entry of this.state.pendingRemoteCommands.values()) {
+            this.writeEvent('command', 'command.remote.cleared', {
+                remoteRequestId: entry.remoteRequestId,
+                commandId: entry.commandId,
+                payloadEncoding: entry.payloadEncoding,
+                payload: entry.payload,
+                receivedAt: entry.receivedAt,
+                connection: entry.connection,
+                reason,
+                clearedAt,
+            });
+        }
+        this.state.pendingRemoteCommands.clear();
+    }
+    async handleCommandSend(params, nextSequenceNumber) {
+        const response = await this.runtimeAdapter.sendCommand(params.commandId, params.payloadEncoding, params.payload, params.timeoutMs);
+        return {
+            sequenceNumber: nextSequenceNumber,
+            commandId: params.commandId,
+            acceptedAt: new Date().toISOString(),
+            response,
+        };
+    }
+    async handleCommandReply(params) {
+        const requestedAt = new Date().toISOString();
+        this.writeEvent('command', 'reply.requested', {
+            remoteRequestId: params.remoteRequestId,
+            commandId: params.commandId,
+            payloadEncoding: params.payloadEncoding,
+            payloadLength: params.payload.length,
+            pendingCount: this.state.pendingRemoteCommands.size,
+            connectionState: this.state.connection.state,
+            at: requestedAt,
+        });
+        const entry = this.state.pendingRemoteCommands.get(params.remoteRequestId);
+        if (!entry) {
+            this.writeEvent('command', 'reply.rejected', {
+                remoteRequestId: params.remoteRequestId,
+                commandId: params.commandId,
+                reason: 'remote_request_not_pending',
+                pendingCount: this.state.pendingRemoteCommands.size,
+                connectionState: this.state.connection.state,
+                at: new Date().toISOString(),
+            });
+            throw new HostProtocol_1.HostProtocolError('invalid_request', `remoteRequestId ${params.remoteRequestId} is not pending`, false);
+        }
+        if (entry.commandId !== params.commandId) {
+            this.writeEvent('command', 'reply.rejected', {
+                remoteRequestId: params.remoteRequestId,
+                commandId: params.commandId,
+                expectedCommandId: entry.commandId,
+                reason: 'command_id_mismatch',
+                pendingCount: this.state.pendingRemoteCommands.size,
+                connectionState: this.state.connection.state,
+                at: new Date().toISOString(),
+            });
+            throw new HostProtocol_1.HostProtocolError('invalid_request', 'commandId does not match pending entry', false);
+        }
+        if (this.state.connection.state !== 'connected') {
+            this.writeEvent('command', 'reply.rejected', {
+                remoteRequestId: params.remoteRequestId,
+                commandId: params.commandId,
+                reason: 'connection_not_ready',
+                pendingCount: this.state.pendingRemoteCommands.size,
+                connectionState: this.state.connection.state,
+                at: new Date().toISOString(),
+            });
+            throw new HostProtocol_1.HostProtocolError('connection_not_ready', 'connection is not established', true);
+        }
+        try {
+            await this.runtimeAdapter.replyRemoteCommand(params.remoteRequestId, params.commandId, params.payloadEncoding, params.payload);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            this.writeEvent('command', 'reply.failed', {
+                remoteRequestId: params.remoteRequestId,
+                commandId: params.commandId,
+                reason: 'runtime_adapter_error',
+                message,
+                pendingCount: this.state.pendingRemoteCommands.size,
+                connectionState: this.state.connection.state,
+                at: new Date().toISOString(),
+            });
+            throw error;
+        }
+        this.state.pendingRemoteCommands.delete(params.remoteRequestId);
+        const repliedAt = new Date().toISOString();
+        this.writeEvent('command', 'command.remote.replied', {
+            remoteRequestId: params.remoteRequestId,
+            commandId: params.commandId,
+            payloadEncoding: entry.payloadEncoding,
+            payload: entry.payload,
+            receivedAt: entry.receivedAt,
+            connection: entry.connection,
+            repliedAt,
+        });
+        return {
+            remoteRequestId: params.remoteRequestId,
+            commandId: params.commandId,
+            repliedAt,
+        };
+    }
+    async handleCommandPendingList() {
+        const items = Array.from(this.state.pendingRemoteCommands.values())
+            .sort((left, right) => left.receivedAt.localeCompare(right.receivedAt));
+        const listedAt = new Date().toISOString();
+        this.writeEvent('command', 'pending.listed', {
+            count: items.length,
+            remoteRequestIds: items.map((item) => item.remoteRequestId),
+            commandIds: items.map((item) => item.commandId),
+            connectionState: this.state.connection.state,
+            listedAt,
+        });
+        return {
+            items,
+            listedAt,
+        };
+    }
+}
+exports.HostCommandCoordinator = HostCommandCoordinator;

package/vendor/app-server/dist/host/HostProtocol.d.ts

@@ -24,20 +24,10 @@ export type ServiceStartParams = {
     timeoutMs: number;
     bootstrapSendStreams?: StreamSendStartParams[];
 };
-export type ConnectionAutoTokenConfig = {
-    openapiEntry?: string;
-    accessId: string;
-    secretKey: string;
-    localId?: string;
-    userTtlSeconds?: number;
-    channelTtlSeconds?: number;
-};
 export type ConnectionConnectParams = {
     serviceEntry?: string;
     peerId: string;
-    token?: string;
-    tokenMode?: 'manual' | 'auto';
-    autoToken?: ConnectionAutoTokenConfig;
+    token: string;
     timeoutMs: number;
 };
 export type StreamSendStartParams = {

package/vendor/app-server/dist/host/HostProtocol.js

@@ -89,16 +89,6 @@ function getOptionalNumber(params, key) {
     }
     return value;
 }
-function getOptionalBoolean(params, key) {
-    const value = params[key];
-    if (value === undefined) {
-        return undefined;
-    }
-    if (typeof value !== 'boolean') {
-        throw new HostProtocolError('invalid_request', `Invalid ${key}`, false);
-    }
-    return value;
-}
 function getRecord(params, key) {
     const value = params[key];
     if (!isRecord(value)) {
@@ -144,38 +134,14 @@ function parseServiceStartParams(params) {
     };
 }
 function parseConnectionConnectParams(params) {
-    const token = getOptionalString(params, 'token');
-    const rawTokenMode = getOptionalString(params, 'tokenMode');
-    const tokenMode = rawTokenMode === undefined ? undefined : (() => {
-        if (rawTokenMode !== 'manual' && rawTokenMode !== 'auto') {
-            throw new HostProtocolError('invalid_request', 'Invalid tokenMode', false);
-        }
-        return rawTokenMode;
-    })();
-    const autoTokenRaw = params.autoToken;
-    let autoToken;
-    if (autoTokenRaw !== undefined) {
-        if (!isRecord(autoTokenRaw)) {
-            throw new HostProtocolError('invalid_request', 'Invalid autoToken', false);
-        }
-        autoToken = {
-            openapiEntry: getOptionalString(autoTokenRaw, 'openapiEntry'),
-            accessId: getString(autoTokenRaw, 'accessId'),
-            secretKey: getString(autoTokenRaw, 'secretKey'),
-            localId: getOptionalString(autoTokenRaw, 'localId'),
-            userTtlSeconds: getOptionalNumber(autoTokenRaw, 'userTtlSeconds'),
-            channelTtlSeconds: getOptionalNumber(autoTokenRaw, 'channelTtlSeconds'),
-        };
-    }
-    if (!token && !autoToken) {
-        throw new HostProtocolError('invalid_request', 'connection/connect requires token or autoToken', false);
+    const token = getString(params, 'token').trim();
+    if (token.length === 0) {
+        throw new HostProtocolError('invalid_request', 'connection/connect requires non-empty token', false);
     }
     return {
         serviceEntry: getOptionalString(params, 'serviceEntry'),
         peerId: getString(params, 'peerId'),
         token,
-        tokenMode,
-        autoToken,
         timeoutMs: getNumber(params, 'timeoutMs'),
     };
 }

package/vendor/app-server/dist/host/HostServer.d.ts

@@ -4,11 +4,11 @@ export declare class HostServer {
     private state;
     private artifactManager;
     private runtimeAdapter;
+    private commandCoordinator;
     private isInitialized;
     private eventCounter;
     private commandSequence;
     private tokenTool;
-    private runtimeCredentialTokenIssuer;
     private eventSinks;
     constructor(artifactManager: ArtifactManager, runtimeAdapter: RuntimeAdapter, hostEndpoint?: string);
     handleMessage(message: string): Promise<string | undefined>;
@@ -19,8 +19,6 @@ export declare class HostServer {
     appendHostLog(line: string): void;
     private handleRuntimeEvent;
     private snapshotPendingConnectionSummary;
-    private handleInboundRemoteCommandRequest;
-    private clearPendingRemoteCommands;
     private noteIncomingConnection;
     private handleIncomingConnectionDisconnected;
     private maybeAutoStartStreamFromRemoteDemand;
@@ -31,7 +29,6 @@ export declare class HostServer {
     private handleServiceStart;
     private handleServiceStop;
     private handleConnectionGet;
-    private resolveConnectionToken;
     private handleConnectionConnect;
     private startDeferredSendStreamsOnConnected;
     private activatePendingStreamsOnConnected;