tirtc-devtools-cli 0.0.9 → 0.0.11

package/dist/{devtools/cli → cli}/src/config.js

@@ -29,7 +29,7 @@ function resolveConfigOutputPath(outputPath) {
 function renderTomlConfigTemplate() {
     return [
         '# TiRTC DevTool CLI 配置模板（TOML）',
-        '# 建议把真实凭据只保留在本地，不要提交到仓库。',
+        '# client token 通过命令行 --token 显式提供，不写入配置文件。',
         '',
         '[server]',
         '# 可留空，走 runtime/core/transport 默认 service_entry',
@@ -40,37 +40,13 @@ function renderTomlConfigTemplate() {
         'video_stream_id = 11',
         'audio_stream_id = 10',
         '',
-        '[connection]',
-        '# 作为客户端 connection connect 默认 service_entry（可留空）',
-        'service_entry = ""',
-        'peer_id = ""',
-        'token = ""',
-        '',
-        '[connection.auto_token]',
-        '# 留空则使用 runtime/core/credential 默认 openapi entry',
-        '# openapi_entry = ""',
-        '# access/secret/local 三元组用于自动签发 token',
-        '# access_id = ""',
-        '# secret_key = ""',
-        '# local_id = ""',
-        '# 可选 TTL（秒）',
-        '# user_ttl_seconds = 86400',
-        '# channel_ttl_seconds = 300',
-        '',
-        '[logging]',
-        '# session 日志根目录；每个 session 会写到 <root_dir>/<session_id>/',
-        'root_dir = "./.tmp/tirtc-devtools-cli/logging"',
-        '# 是否镜像 Host 控制台日志到当前终端',
-        'console_mirror = true',
-        '# verbose|debug|info|warn|error|fatal（预留）',
-        'level = "info"',
-        '',
-        '[debug.connect_bootstrap]',
-        'access_id = ""',
-        'secret_key = ""',
-        'peer_id = ""',
-        '# 可留空，走 runtime/core/transport 默认 service_entry',
+        '[client]',
+        '# client start 正式路径读取这里的最小连接事实',
         'service_entry = ""',
+        'peer_id = "peer-123"',
+        'audio_stream_id = 10',
+        'video_stream_id = 11',
+        'consumer = "web_preview"',
         '',
     ].join('\n');
 }

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

@@ -0,0 +1,3 @@
+export declare function resolveCliStateRootDir(): string;
+export declare function resolveCliLogRootDir(): string;
+export declare function resolveCliPreparedAssetsRoot(): string;

package/dist/cli/src/default_paths.js

@@ -0,0 +1,23 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveCliStateRootDir = resolveCliStateRootDir;
+exports.resolveCliLogRootDir = resolveCliLogRootDir;
+exports.resolveCliPreparedAssetsRoot = resolveCliPreparedAssetsRoot;
+const os_1 = __importDefault(require("os"));
+const path_1 = __importDefault(require("path"));
+function resolveCliStateRootDir() {
+    const explicit = process.env.TIRTC_DEVTOOL_STATE_DIR;
+    if (explicit && explicit.trim().length > 0) {
+        return explicit.trim();
+    }
+    return path_1.default.join(os_1.default.homedir(), '.tirtc-devtools-cli');
+}
+function resolveCliLogRootDir() {
+    return path_1.default.join(resolveCliStateRootDir(), 'logging');
+}
+function resolveCliPreparedAssetsRoot() {
+    return path_1.default.join(resolveCliStateRootDir(), 'prepared-assets');
+}

package/dist/{devtools/cli → cli}/src/embedded_paths.d.ts

@@ -1,4 +1,5 @@
 export declare function resolveCliPackageRoot(fromDir: string): string;
+export declare function resolveWorkspaceRepoRoot(fromDir: string): string | undefined;
 export declare function resolveEmbeddedRoot(fromDir: string): string | undefined;
 export declare function resolveEmbeddedAppServerRoot(fromDir: string): string | undefined;
 export declare function resolveEmbeddedHostBinary(fromDir: string): string | undefined;

package/dist/{devtools/cli → cli}/src/embedded_paths.js

@@ -4,6 +4,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.resolveCliPackageRoot = resolveCliPackageRoot;
+exports.resolveWorkspaceRepoRoot = resolveWorkspaceRepoRoot;
 exports.resolveEmbeddedRoot = resolveEmbeddedRoot;
 exports.resolveEmbeddedAppServerRoot = resolveEmbeddedAppServerRoot;
 exports.resolveEmbeddedHostBinary = resolveEmbeddedHostBinary;
@@ -15,6 +16,11 @@ const path_1 = __importDefault(require("path"));
 function pathExists(filePath) {
     return fs_1.default.existsSync(filePath);
 }
+function isWorkspaceRepoRoot(candidate) {
+    return pathExists(path_1.default.join(candidate, 'products/cli/package.json')) &&
+        pathExists(path_1.default.join(candidate, 'products/app-server/package.json')) &&
+        pathExists(path_1.default.join(candidate, 'runtime/script/prepare_runtime_media_dataset.sh'));
+}
 function resolveCliPackageRoot(fromDir) {
     const candidates = [
         path_1.default.resolve(fromDir, '..'),
@@ -22,7 +28,7 @@ function resolveCliPackageRoot(fromDir) {
         path_1.default.resolve(fromDir, '../../..'),
         path_1.default.resolve(fromDir, '../../../..'),
         path_1.default.resolve(process.cwd()),
-        path_1.default.resolve(process.cwd(), 'devtools/cli'),
+        path_1.default.resolve(process.cwd(), 'products/cli'),
     ];
     for (const candidate of candidates) {
         if (pathExists(path_1.default.join(candidate, 'package.json')) && pathExists(path_1.default.join(candidate, 'bin/tirtc-devtools-cli.js'))) {
@@ -31,7 +37,18 @@ function resolveCliPackageRoot(fromDir) {
     }
     return candidates[0];
 }
+function resolveWorkspaceRepoRoot(fromDir) {
+    const packageRoot = resolveCliPackageRoot(fromDir);
+    const repoRoot = path_1.default.resolve(packageRoot, '../..');
+    if (isWorkspaceRepoRoot(repoRoot)) {
+        return repoRoot;
+    }
+    return undefined;
+}
 function resolveEmbeddedRoot(fromDir) {
+    if (resolveWorkspaceRepoRoot(fromDir)) {
+        return undefined;
+    }
     const packageRoot = resolveCliPackageRoot(fromDir);
     const embeddedRoot = path_1.default.join(packageRoot, 'vendor');
     if (pathExists(path_1.default.join(embeddedRoot, 'app-server')) || pathExists(path_1.default.join(embeddedRoot, 'runtime'))) {

package/dist/{devtools/cli → cli}/src/facade.d.ts

@@ -20,69 +20,24 @@ export declare const CliConfigSchema: z.ZodObject<{
         video_stream_id?: number | undefined;
         audio_stream_id?: number | undefined;
     }>>;
-    connection: z.ZodOptional<z.ZodObject<{
+    client: z.ZodOptional<z.ZodObject<{
         service_entry: z.ZodOptional<z.ZodString>;
         peer_id: z.ZodOptional<z.ZodString>;
-        token: z.ZodOptional<z.ZodString>;
-        auto_token: z.ZodOptional<z.ZodObject<{
-            openapi_entry: z.ZodOptional<z.ZodString>;
-            access_id: z.ZodOptional<z.ZodString>;
-            secret_key: z.ZodOptional<z.ZodString>;
-            local_id: z.ZodOptional<z.ZodString>;
-            user_ttl_seconds: z.ZodOptional<z.ZodNumber>;
-            channel_ttl_seconds: z.ZodOptional<z.ZodNumber>;
-        }, "strip", z.ZodTypeAny, {
-            openapi_entry?: string | undefined;
-            access_id?: string | undefined;
-            secret_key?: string | undefined;
-            local_id?: string | undefined;
-            user_ttl_seconds?: number | undefined;
-            channel_ttl_seconds?: number | undefined;
-        }, {
-            openapi_entry?: string | undefined;
-            access_id?: string | undefined;
-            secret_key?: string | undefined;
-            local_id?: string | undefined;
-            user_ttl_seconds?: number | undefined;
-            channel_ttl_seconds?: number | undefined;
-        }>>;
+        audio_stream_id: z.ZodOptional<z.ZodNumber>;
+        video_stream_id: z.ZodOptional<z.ZodNumber>;
+        consumer: z.ZodOptional<z.ZodEnum<["web_preview"]>>;
     }, "strip", z.ZodTypeAny, {
         service_entry?: string | undefined;
+        video_stream_id?: number | undefined;
+        audio_stream_id?: number | undefined;
         peer_id?: string | undefined;
-        token?: string | undefined;
-        auto_token?: {
-            openapi_entry?: string | undefined;
-            access_id?: string | undefined;
-            secret_key?: string | undefined;
-            local_id?: string | undefined;
-            user_ttl_seconds?: number | undefined;
-            channel_ttl_seconds?: number | undefined;
-        } | undefined;
+        consumer?: "web_preview" | undefined;
     }, {
         service_entry?: string | undefined;
+        video_stream_id?: number | undefined;
+        audio_stream_id?: number | undefined;
         peer_id?: string | undefined;
-        token?: string | undefined;
-        auto_token?: {
-            openapi_entry?: string | undefined;
-            access_id?: string | undefined;
-            secret_key?: string | undefined;
-            local_id?: string | undefined;
-            user_ttl_seconds?: number | undefined;
-            channel_ttl_seconds?: number | undefined;
-        } | undefined;
-    }>>;
-    logging: z.ZodOptional<z.ZodObject<{
-        root_dir: z.ZodOptional<z.ZodString>;
-        console_mirror: z.ZodOptional<z.ZodBoolean>;
-        level: z.ZodOptional<z.ZodEnum<["verbose", "debug", "info", "warn", "error", "fatal"]>>;
-    }, "strip", z.ZodTypeAny, {
-        root_dir?: string | undefined;
-        console_mirror?: boolean | undefined;
-        level?: "verbose" | "debug" | "info" | "warn" | "error" | "fatal" | undefined;
-    }, {
-        root_dir?: string | undefined;
-        console_mirror?: boolean | undefined;
-        level?: "verbose" | "debug" | "info" | "warn" | "error" | "fatal" | undefined;
+        consumer?: "web_preview" | undefined;
     }>>;
     debug: z.ZodOptional<z.ZodObject<{
         connect_bootstrap: z.ZodOptional<z.ZodObject<{
@@ -137,69 +92,24 @@ export declare const CliConfigSchema: z.ZodObject<{
         video_stream_id?: number | undefined;
         audio_stream_id?: number | undefined;
     }>>;
-    connection: z.ZodOptional<z.ZodObject<{
+    client: z.ZodOptional<z.ZodObject<{
         service_entry: z.ZodOptional<z.ZodString>;
         peer_id: z.ZodOptional<z.ZodString>;
-        token: z.ZodOptional<z.ZodString>;
-        auto_token: z.ZodOptional<z.ZodObject<{
-            openapi_entry: z.ZodOptional<z.ZodString>;
-            access_id: z.ZodOptional<z.ZodString>;
-            secret_key: z.ZodOptional<z.ZodString>;
-            local_id: z.ZodOptional<z.ZodString>;
-            user_ttl_seconds: z.ZodOptional<z.ZodNumber>;
-            channel_ttl_seconds: z.ZodOptional<z.ZodNumber>;
-        }, "strip", z.ZodTypeAny, {
-            openapi_entry?: string | undefined;
-            access_id?: string | undefined;
-            secret_key?: string | undefined;
-            local_id?: string | undefined;
-            user_ttl_seconds?: number | undefined;
-            channel_ttl_seconds?: number | undefined;
-        }, {
-            openapi_entry?: string | undefined;
-            access_id?: string | undefined;
-            secret_key?: string | undefined;
-            local_id?: string | undefined;
-            user_ttl_seconds?: number | undefined;
-            channel_ttl_seconds?: number | undefined;
-        }>>;
+        audio_stream_id: z.ZodOptional<z.ZodNumber>;
+        video_stream_id: z.ZodOptional<z.ZodNumber>;
+        consumer: z.ZodOptional<z.ZodEnum<["web_preview"]>>;
     }, "strip", z.ZodTypeAny, {
         service_entry?: string | undefined;
+        video_stream_id?: number | undefined;
+        audio_stream_id?: number | undefined;
         peer_id?: string | undefined;
-        token?: string | undefined;
-        auto_token?: {
-            openapi_entry?: string | undefined;
-            access_id?: string | undefined;
-            secret_key?: string | undefined;
-            local_id?: string | undefined;
-            user_ttl_seconds?: number | undefined;
-            channel_ttl_seconds?: number | undefined;
-        } | undefined;
+        consumer?: "web_preview" | undefined;
     }, {
         service_entry?: string | undefined;
+        video_stream_id?: number | undefined;
+        audio_stream_id?: number | undefined;
         peer_id?: string | undefined;
-        token?: string | undefined;
-        auto_token?: {
-            openapi_entry?: string | undefined;
-            access_id?: string | undefined;
-            secret_key?: string | undefined;
-            local_id?: string | undefined;
-            user_ttl_seconds?: number | undefined;
-            channel_ttl_seconds?: number | undefined;
-        } | undefined;
-    }>>;
-    logging: z.ZodOptional<z.ZodObject<{
-        root_dir: z.ZodOptional<z.ZodString>;
-        console_mirror: z.ZodOptional<z.ZodBoolean>;
-        level: z.ZodOptional<z.ZodEnum<["verbose", "debug", "info", "warn", "error", "fatal"]>>;
-    }, "strip", z.ZodTypeAny, {
-        root_dir?: string | undefined;
-        console_mirror?: boolean | undefined;
-        level?: "verbose" | "debug" | "info" | "warn" | "error" | "fatal" | undefined;
-    }, {
-        root_dir?: string | undefined;
-        console_mirror?: boolean | undefined;
-        level?: "verbose" | "debug" | "info" | "warn" | "error" | "fatal" | undefined;
+        consumer?: "web_preview" | undefined;
     }>>;
     debug: z.ZodOptional<z.ZodObject<{
         connect_bootstrap: z.ZodOptional<z.ZodObject<{
@@ -254,69 +164,24 @@ export declare const CliConfigSchema: z.ZodObject<{
         video_stream_id?: number | undefined;
         audio_stream_id?: number | undefined;
     }>>;
-    connection: z.ZodOptional<z.ZodObject<{
+    client: z.ZodOptional<z.ZodObject<{
         service_entry: z.ZodOptional<z.ZodString>;
         peer_id: z.ZodOptional<z.ZodString>;
-        token: z.ZodOptional<z.ZodString>;
-        auto_token: z.ZodOptional<z.ZodObject<{
-            openapi_entry: z.ZodOptional<z.ZodString>;
-            access_id: z.ZodOptional<z.ZodString>;
-            secret_key: z.ZodOptional<z.ZodString>;
-            local_id: z.ZodOptional<z.ZodString>;
-            user_ttl_seconds: z.ZodOptional<z.ZodNumber>;
-            channel_ttl_seconds: z.ZodOptional<z.ZodNumber>;
-        }, "strip", z.ZodTypeAny, {
-            openapi_entry?: string | undefined;
-            access_id?: string | undefined;
-            secret_key?: string | undefined;
-            local_id?: string | undefined;
-            user_ttl_seconds?: number | undefined;
-            channel_ttl_seconds?: number | undefined;
-        }, {
-            openapi_entry?: string | undefined;
-            access_id?: string | undefined;
-            secret_key?: string | undefined;
-            local_id?: string | undefined;
-            user_ttl_seconds?: number | undefined;
-            channel_ttl_seconds?: number | undefined;
-        }>>;
+        audio_stream_id: z.ZodOptional<z.ZodNumber>;
+        video_stream_id: z.ZodOptional<z.ZodNumber>;
+        consumer: z.ZodOptional<z.ZodEnum<["web_preview"]>>;
     }, "strip", z.ZodTypeAny, {
         service_entry?: string | undefined;
+        video_stream_id?: number | undefined;
+        audio_stream_id?: number | undefined;
         peer_id?: string | undefined;
-        token?: string | undefined;
-        auto_token?: {
-            openapi_entry?: string | undefined;
-            access_id?: string | undefined;
-            secret_key?: string | undefined;
-            local_id?: string | undefined;
-            user_ttl_seconds?: number | undefined;
-            channel_ttl_seconds?: number | undefined;
-        } | undefined;
+        consumer?: "web_preview" | undefined;
     }, {
         service_entry?: string | undefined;
+        video_stream_id?: number | undefined;
+        audio_stream_id?: number | undefined;
         peer_id?: string | undefined;
-        token?: string | undefined;
-        auto_token?: {
-            openapi_entry?: string | undefined;
-            access_id?: string | undefined;
-            secret_key?: string | undefined;
-            local_id?: string | undefined;
-            user_ttl_seconds?: number | undefined;
-            channel_ttl_seconds?: number | undefined;
-        } | undefined;
-    }>>;
-    logging: z.ZodOptional<z.ZodObject<{
-        root_dir: z.ZodOptional<z.ZodString>;
-        console_mirror: z.ZodOptional<z.ZodBoolean>;
-        level: z.ZodOptional<z.ZodEnum<["verbose", "debug", "info", "warn", "error", "fatal"]>>;
-    }, "strip", z.ZodTypeAny, {
-        root_dir?: string | undefined;
-        console_mirror?: boolean | undefined;
-        level?: "verbose" | "debug" | "info" | "warn" | "error" | "fatal" | undefined;
-    }, {
-        root_dir?: string | undefined;
-        console_mirror?: boolean | undefined;
-        level?: "verbose" | "debug" | "info" | "warn" | "error" | "fatal" | undefined;
+        consumer?: "web_preview" | undefined;
     }>>;
     debug: z.ZodOptional<z.ZodObject<{
         connect_bootstrap: z.ZodOptional<z.ZodObject<{
@@ -379,82 +244,23 @@ export declare const ServiceStartParamsSchema: z.ZodObject<{
 export declare const ConnectionConnectParamsSchema: z.ZodEffects<z.ZodObject<{
     serviceEntry: z.ZodOptional<z.ZodString>;
     peerId: z.ZodString;
-    token: z.ZodOptional<z.ZodString>;
-    tokenMode: z.ZodOptional<z.ZodEnum<["manual", "auto"]>>;
-    autoToken: z.ZodOptional<z.ZodObject<{
-        openapiEntry: z.ZodOptional<z.ZodString>;
-        accessId: z.ZodString;
-        secretKey: z.ZodString;
-        localId: z.ZodOptional<z.ZodString>;
-        userTtlSeconds: z.ZodOptional<z.ZodNumber>;
-        channelTtlSeconds: z.ZodOptional<z.ZodNumber>;
-    }, "strip", z.ZodTypeAny, {
-        accessId: string;
-        secretKey: string;
-        openapiEntry?: string | undefined;
-        localId?: string | undefined;
-        userTtlSeconds?: number | undefined;
-        channelTtlSeconds?: number | undefined;
-    }, {
-        accessId: string;
-        secretKey: string;
-        openapiEntry?: string | undefined;
-        localId?: string | undefined;
-        userTtlSeconds?: number | undefined;
-        channelTtlSeconds?: number | undefined;
-    }>>;
+    token: z.ZodString;
 }, "strip", z.ZodTypeAny, {
     peerId: string;
-    token?: string | undefined;
+    token: string;
     serviceEntry?: string | undefined;
-    tokenMode?: "manual" | "auto" | undefined;
-    autoToken?: {
-        accessId: string;
-        secretKey: string;
-        openapiEntry?: string | undefined;
-        localId?: string | undefined;
-        userTtlSeconds?: number | undefined;
-        channelTtlSeconds?: number | undefined;
-    } | undefined;
 }, {
     peerId: string;
-    token?: string | undefined;
+    token: string;
     serviceEntry?: string | undefined;
-    tokenMode?: "manual" | "auto" | undefined;
-    autoToken?: {
-        accessId: string;
-        secretKey: string;
-        openapiEntry?: string | undefined;
-        localId?: string | undefined;
-        userTtlSeconds?: number | undefined;
-        channelTtlSeconds?: number | undefined;
-    } | undefined;
 }>, {
     peerId: string;
-    token?: string | undefined;
+    token: string;
     serviceEntry?: string | undefined;
-    tokenMode?: "manual" | "auto" | undefined;
-    autoToken?: {
-        accessId: string;
-        secretKey: string;
-        openapiEntry?: string | undefined;
-        localId?: string | undefined;
-        userTtlSeconds?: number | undefined;
-        channelTtlSeconds?: number | undefined;
-    } | undefined;
 }, {
     peerId: string;
-    token?: string | undefined;
+    token: string;
     serviceEntry?: string | undefined;
-    tokenMode?: "manual" | "auto" | undefined;
-    autoToken?: {
-        accessId: string;
-        secretKey: string;
-        openapiEntry?: string | undefined;
-        localId?: string | undefined;
-        userTtlSeconds?: number | undefined;
-        channelTtlSeconds?: number | undefined;
-    } | undefined;
 }>;
 export declare const StreamSendStartParamsSchema: z.ZodObject<{
     streamId: z.ZodString;
@@ -498,16 +304,16 @@ export declare const OutputAttachParamsSchema: z.ZodObject<{
     targetPath: z.ZodOptional<z.ZodString>;
     maxFiles: z.ZodOptional<z.ZodNumber>;
 }, "strip", z.ZodTypeAny, {
-    streamId: string;
     consumer: string;
+    streamId: string;
     mediaView: string;
     format: string;
     delivery: string;
     targetPath?: string | undefined;
     maxFiles?: number | undefined;
 }, {
-    streamId: string;
     consumer: string;
+    streamId: string;
     mediaView: string;
     format: string;
     delivery: string;
@@ -523,32 +329,32 @@ export declare const OutputAttachCliParamsSchema: z.ZodEffects<z.ZodObject<{
     targetPath: z.ZodOptional<z.ZodString>;
     maxFiles: z.ZodOptional<z.ZodNumber>;
 }, "strip", z.ZodTypeAny, {
-    streamId: number;
     consumer: "web_preview" | "file_sink";
+    streamId: number;
     mediaView: "encoded" | "encoded_packet";
     format: "h264" | "g711a" | "jpeg" | "pcm" | "mp4";
     delivery: "artifact_path" | "file";
     targetPath?: string | undefined;
     maxFiles?: number | undefined;
 }, {
-    streamId: number;
     consumer: "web_preview" | "file_sink";
+    streamId: number;
     mediaView: "encoded" | "encoded_packet";
     format: "h264" | "g711a" | "jpeg" | "pcm" | "mp4";
     delivery: "artifact_path" | "file";
     targetPath?: string | undefined;
     maxFiles?: number | undefined;
 }>, {
-    streamId: number;
     consumer: "web_preview" | "file_sink";
+    streamId: number;
     mediaView: "encoded" | "encoded_packet";
     format: "h264" | "g711a" | "jpeg" | "pcm" | "mp4";
     delivery: "artifact_path" | "file";
     targetPath?: string | undefined;
     maxFiles?: number | undefined;
 }, {
-    streamId: number;
     consumer: "web_preview" | "file_sink";
+    streamId: number;
     mediaView: "encoded" | "encoded_packet";
     format: "h264" | "g711a" | "jpeg" | "pcm" | "mp4";
     delivery: "artifact_path" | "file";

package/dist/{devtools/cli → cli}/src/facade.js

@@ -11,23 +11,12 @@ exports.CliConfigSchema = zod_1.z.object({
         video_stream_id: zod_1.z.number().int().nonnegative().optional(),
         audio_stream_id: zod_1.z.number().int().nonnegative().optional(),
     }).optional(),
-    connection: zod_1.z.object({
+    client: zod_1.z.object({
         service_entry: zod_1.z.string().optional(),
         peer_id: zod_1.z.string().optional(),
-        token: zod_1.z.string().optional(),
-        auto_token: zod_1.z.object({
-            openapi_entry: zod_1.z.string().optional(),
-            access_id: zod_1.z.string().optional(),
-            secret_key: zod_1.z.string().optional(),
-            local_id: zod_1.z.string().optional(),
-            user_ttl_seconds: zod_1.z.number().int().positive().optional(),
-            channel_ttl_seconds: zod_1.z.number().int().positive().optional(),
-        }).optional(),
-    }).optional(),
-    logging: zod_1.z.object({
-        root_dir: zod_1.z.string().optional(),
-        console_mirror: zod_1.z.boolean().optional(),
-        level: zod_1.z.enum(['verbose', 'debug', 'info', 'warn', 'error', 'fatal']).optional(),
+        audio_stream_id: zod_1.z.number().int().nonnegative().optional(),
+        video_stream_id: zod_1.z.number().int().nonnegative().optional(),
+        consumer: zod_1.z.enum(['web_preview']).optional(),
     }).optional(),
     debug: zod_1.z.object({
         connect_bootstrap: zod_1.z.object({
@@ -48,6 +37,7 @@ exports.CommandToHostMethodMapping = {
     'host stop': 'host/shutdown',
     'service start': 'service/start',
     'service stop': 'service/stop',
+    'client start': 'connection/connect',
     'connection show': 'connection/get',
     'connection connect': 'connection/connect',
     'connection disconnect': 'connection/disconnect',
@@ -89,18 +79,9 @@ exports.ServiceStartParamsSchema = zod_1.z.object({
 exports.ConnectionConnectParamsSchema = zod_1.z.object({
     serviceEntry: zod_1.z.string().optional(),
     peerId: zod_1.z.string(),
-    token: zod_1.z.string().optional(),
-    tokenMode: zod_1.z.enum(['manual', 'auto']).optional(),
-    autoToken: zod_1.z.object({
-        openapiEntry: zod_1.z.string().optional(),
-        accessId: zod_1.z.string(),
-        secretKey: zod_1.z.string(),
-        localId: zod_1.z.string().optional(),
-        userTtlSeconds: zod_1.z.number().int().positive().optional(),
-        channelTtlSeconds: zod_1.z.number().int().positive().optional(),
-    }).optional(),
-}).refine((value) => Boolean(value.token) || Boolean(value.autoToken), {
-    message: 'token or autoToken is required',
+    token: zod_1.z.string().min(1),
+}).refine((value) => value.token.trim().length > 0, {
+    message: 'token is required',
 });
 exports.StreamSendStartParamsSchema = zod_1.z.object({
     streamId: zod_1.z.string(),

package/dist/cli/src/guide.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.printQuickstartGuide = printQuickstartGuide;
+function printQuickstartGuide() {
+    const lines = [
+        'TiRTC CLI 新手快速入口（service start -> client start 本地预览）',
+        '',
+        '前置条件：',
+        '1) 已构建最新 CLI：',
+        '   npm --prefix products/app-server run build',
+        '   npm --prefix products/cli run build',
+        '2) 准备一份 TOML 配置：',
+        '   [server] service_entry = "" license = "<LICENSE>" mp4_path = "./.refers/simple.mp4" video_stream_id = 11 audio_stream_id = 10',
+        '   [client] service_entry = "" peer_id = "<PEER_ID>" audio_stream_id = 10 video_stream_id = 11 consumer = "web_preview"',
+        '',
+        '步骤 1：启动服务（自动创建 session）',
+        '  node products/cli/bin/tirtc-devtools-cli.js --config ./server.toml service start',
+        '  # 记下输出里的 sessionId，后续观测命令显式带 --session',
+        '',
+        '步骤 2：CLI 会自动 prepare MP4 并绑定音视频 stream，不再需要手工 prepare assets_dir',
+        '  # service start 成功后会自动 prepare 并按 AUTO_ON_CONNECTED 进入待发流语义',
+        '',
+        '步骤 3：显式签发 client token（可本地执行，也可由外部系统提供）',
+        '  export TIRTC_CONN_ACCESS_ID="<ACCESS_ID>"',
+        '  export TIRTC_CONN_SECRET_KEY="<SECRET_KEY>"',
+        '  node products/cli/bin/tirtc-devtools-cli.js --json token issue "<PEER_ID>" --service-entry "<SERVICE_ENTRY>"',
+        '',
+        '步骤 4：启动 client 本地 web preview',
+        '  node products/cli/bin/tirtc-devtools-cli.js --config ./client.toml client start --token "<TOKEN>"',
+        '  # 返回结果里的 autoApplied.preview.url 就是浏览器预览入口',
+        '',
+        '步骤 5：打开返回的 preview.url，并让页面触发 /preview/start',
+        '  # Host 会在收到 preview/start 后激活对应 receive worker',
+        '',
+        '步骤 6：服务端观测',
+        '  node products/cli/bin/tirtc-devtools-cli.js --session <SESSION_ID> events tail',
+        '  node products/cli/bin/tirtc-devtools-cli.js --session <SESSION_ID> report show',
+        '',
+        '补充：',
+        '- client start 是正式入口；connection connect / stream receive start / output attach 保留为 expert path',
+        '- debug bootstrap qrcode 仅生成连接信息二维码，不签发 token',
+        '- 机器可读输出：在命令后追加 --json',
+        '- 查看全部命令：node products/cli/bin/tirtc-devtools-cli.js --help',
+        '- 查看单命令说明：node products/cli/bin/tirtc-devtools-cli.js <command> --help',
+    ];
+    console.log(lines.join('\n'));
+}