@cvtoolman/huawei-lts-cli 1.0.3 → 2.1.0

package/dist/cli/commands/query.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.createQueryCommand = createQueryCommand;
 const commander_1 = require("commander");
 const client_1 = require("../../lts/client");
+const pagination_1 = require("../../lts/pagination");
 const output_1 = require("../../output");
 const common_1 = require("./common");
 // commander 的处理函数会收到 (value, previous)，直接传 parseInt 会把 previous 当作进制
@@ -19,21 +20,18 @@ function createQueryCommand() {
         .option('--st <startTime>', 'Alias for --start-time')
         .option('--et <endTime>', 'Alias for --end-time')
         .option('--last <duration>', 'Relative time range: 30m, 2h, 1d, 7d (mutually exclusive with --st/--et)')
-        .option('-k, --keyword <keyword>', 'Simple keyword search (legacy, use --query for advanced queries)')
-        .option('-q, --query <query>', 'Advanced query expression. Supports:\n' +
+        .option('-q, --query <query>', 'Query expression. Supports:\n' +
         '  - Field queries: content:error AND appName:myapp\n' +
         '  - Comparison: time>60 AND region:r\n' +
-        '  - SQL syntax: SELECT * FROM log WHERE content LIKE \'%error%\'\n' +
+        '  - Pipeline analysis: error | SELECT count(*) AS c\n' +
         '  - Logical operators: AND, OR, NOT (must be surrounded by spaces)')
-        .option('--app <appName>', 'Filter by appName field (e.g. --app acerp-gateway), merged with -q via AND')
+        .option('--app <appName>', 'Filter by appName field, merged with -q via AND')
         .option('--content <keyword>', 'Filter by log content (content:<keyword>), merged with -q via AND')
         .option('--request-id <id>', 'Filter by REQUEST_ID field; output in chronological order')
-        .option('-l, --limit <limit>', 'Limit number of results', parseIntOption, 100)
-        .option('-o, --offset <offset>', 'Offset for pagination', parseIntOption, 0)
+        .option('-l, --limit <limit>', 'Page size (also the cap for --all)', parseIntOption, 100)
         .option('-r, --reverse', 'Reverse order (newest first)')
         .option('-f, --format <format>', 'Output format: json, table, pretty', 'pretty')
-        .option('--all', 'Fetch all pages (up to 10000 logs; default is single page)')
-        .option('--no-paginate', '(deprecated) Single page is the default; kept for compatibility')
+        .option('--all', 'Follow the cursor to the end (up to 10000 logs; default is a single page)')
         .action(async (options) => {
         const config = (0, common_1.loadCheckedConfig)();
         const { groupId, streamId } = (0, common_1.resolveGroupStream)(options, config);
@@ -47,45 +45,28 @@ function createQueryCommand() {
             groupId,
             streamId,
             ...timeParams,
-            keyword: options.keyword,
             query,
             limit: options.limit,
-            offset: options.offset,
             reverse,
         };
         try {
             if (!options.all) {
                 // 默认单页查询，结果量由 --limit 控制
                 const result = await client.queryLogs(params);
+                (0, common_1.warnIfIncomplete)(result);
                 console.log((0, output_1.formatOutput)(result, format));
             }
             else {
-                // --all：自动翻页拉取全部日志，上限 10000 条防止失控
-                const MAX_LOGS = 10000;
-                const allLogs = [];
-                let offset = options.offset || 0;
-                const limit = options.limit || 100;
-                let hasMore = true;
-                while (hasMore && allLogs.length < MAX_LOGS) {
-                    const pageParams = {
-                        ...params,
-                        offset,
-                        limit,
-                    };
-                    const result = await client.queryLogs(pageParams);
-                    allLogs.push(...result.logs);
-                    if (result.logs.length < limit) {
-                        hasMore = false;
-                    }
-                    else {
-                        offset += limit;
-                    }
+                // --all：沿游标读到末尾，上限 10000 条防止失控
+                const result = await (0, pagination_1.fetchAllPages)((p) => client.queryLogs(p), params, {
+                    max: 10000,
+                    pageSize: options.limit,
+                });
+                (0, common_1.warnIfIncomplete)(result);
+                if (result.truncated) {
+                    console.error(`Warning: stopped at the ${result.logs.length}-log cap; more logs matched. Narrow the time range or add a filter.`);
                 }
-                const result = {
-                    logs: allLogs,
-                    total: allLogs.length,
-                };
-                console.log((0, output_1.formatOutput)(result, format));
+                console.log((0, output_1.formatOutput)({ logs: result.logs, total: result.total }, format));
             }
         }
         catch (error) {

package/dist/cli/commands/streams.js

@@ -64,7 +64,7 @@ function createGroupsCommand() {
 function createStreamsCommand() {
     const cmd = new commander_1.Command('streams');
     cmd.description('List LTS log streams, optionally filtered by log group name')
-        .option('-g, --group <name>', 'Filter by log group NAME (e.g. acerp)')
+        .option('--group <name>', 'Filter by log group NAME (the API filters by name, not ID)')
         .option('-f, --format <format>', 'Output format: json, pretty', 'pretty')
         .action(async (options) => {
         const config = (0, common_1.loadCheckedConfig)();

package/dist/cli/commands/trace.js

@@ -7,15 +7,25 @@ exports.createTraceCommand = createTraceCommand;
 const commander_1 = require("commander");
 const chalk_1 = __importDefault(require("chalk"));
 const client_1 = require("../../lts/client");
+const pagination_1 = require("../../lts/pagination");
 const output_1 = require("../../output");
+const config_1 = require("../../config");
 const common_1 = require("./common");
+/**
+ * 默认按全文索引检索，而不是 REQUEST_ID。
+ *
+ * 理由：`REQUEST_ID` 是某类应用的字段命名约定，不是 LTS 的通用概念。新用户的日志流
+ * 里往往没有这个字段，写死它会让 `trace` 在正确的用法下返回空。全文检索总能命中，
+ * 而用到专用字段的人可以在 config 里设一次 `traceField`。
+ */
+const DEFAULT_TRACE_FIELD = 'content';
 function createTraceCommand() {
     const cmd = new commander_1.Command('trace');
-    cmd.description('Trace a request by REQUEST_ID — fetch the full request chain in chronological order')
-        .argument('<requestId>', 'REQUEST_ID value to trace')
+    cmd.description('Trace a request by ID — fetch the full request chain in chronological order')
+        .argument('<requestId>', 'Value to trace (request ID, trace ID, or any search text)')
         .option('-g, --group-id <groupId>', 'Log group ID (can also be set via config)')
         .option('-s, --stream-id <streamId>', 'Log stream ID (can also be set via config)')
-        .option('--field <name>', 'Field to match: REQUEST_ID (default), trace_id, or content (full-text fallback)', 'REQUEST_ID')
+        .option('--field <name>', `Field to match. Defaults to config.traceField, then "${DEFAULT_TRACE_FIELD}"`)
         .option('--last <duration>', 'Relative time range: 30m, 2h, 1d, 7d (default: 24h)')
         .option('--start-time <startTime>', 'Start time (ISO 8601)')
         .option('--end-time <endTime>', 'End time (ISO 8601)')
@@ -28,7 +38,7 @@ function createTraceCommand() {
         const { groupId, streamId } = (0, common_1.resolveGroupStream)(options, config);
         const timeParams = (0, common_1.resolveTimeParams)(options, '24h');
         const format = (0, common_1.resolveFormat)(options.format);
-        const field = options.field;
+        const field = options.field || (0, config_1.getConfig)('traceField') || DEFAULT_TRACE_FIELD;
         // 值加双引号：含连字符的 UUID 不加引号会被分词导致匹配不到
         const query = `${field}:"${requestId}"`;
         const client = new client_1.LTSClient(config);
@@ -40,24 +50,18 @@ function createTraceCommand() {
             reverse: false, // 链路按时间正序
         };
         try {
-            // Auto-pagination up to --limit
-            const pageSize = Math.min(options.limit || 200, 500);
             const maxTotal = options.limit || 200;
-            const allLogs = [];
-            let offset = 0;
-            let hasMore = true;
-            while (hasMore && allLogs.length < maxTotal) {
-                const result = await client.queryLogs({ ...params, offset, limit: pageSize });
-                allLogs.push(...result.logs);
-                if (result.logs.length < pageSize) {
-                    hasMore = false;
-                }
-                else {
-                    offset += pageSize;
-                }
+            // 每页不超过 500：再大 LTS 会开始截断，且首屏延迟明显变差
+            const pageSize = Math.min(maxTotal, 500);
+            const result = await (0, pagination_1.fetchAllPages)((p) => client.queryLogs(p), params, {
+                max: maxTotal,
+                pageSize,
+            });
+            (0, common_1.warnIfIncomplete)(result);
+            if (result.truncated) {
+                console.error(`Warning: stopped at --limit ${maxTotal}; the chain may continue. Re-run with a larger --limit.`);
             }
-            const result = { logs: allLogs.slice(0, maxTotal), total: allLogs.length };
-            let output = (0, output_1.formatOutput)(result, format);
+            let output = (0, output_1.formatOutput)({ logs: result.logs, total: result.total }, format);
             // pretty 格式下高亮 requestId，便于肉眼定位
             if (format === 'pretty' && result.logs.length > 0) {
                 output = output.split(requestId).join(chalk_1.default.yellow.bold(requestId));

package/dist/cli/index.js

@@ -1,6 +1,41 @@
 #!/usr/bin/env node
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 Object.defineProperty(exports, "__esModule", { value: true });
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
 const commander_1 = require("commander");
 const query_1 = require("./commands/query");
 const trace_1 = require("./commands/trace");
@@ -8,20 +43,38 @@ const context_1 = require("./commands/context");
 const streams_1 = require("./commands/streams");
 const config_1 = require("./commands/config");
 const init_1 = require("./commands/init");
+const fields_1 = require("./commands/fields");
+/**
+ * Read the version from package.json at runtime.
+ *
+ * A hard-coded version string drifts silently from package.json — `lts-cli --version`
+ * then reports a build that was never published. Resolved relative to __dirname so it
+ * works both from src/ (tsx) and dist/ (published package).
+ */
+function readVersion() {
+    try {
+        const pkgPath = path.resolve(__dirname, '..', '..', 'package.json');
+        return JSON.parse(fs.readFileSync(pkgPath, 'utf-8')).version ?? '0.0.0';
+    }
+    catch {
+        return '0.0.0';
+    }
+}
 const program = new commander_1.Command();
 program
     .name('lts-cli')
     .description('Huawei Cloud LTS (Log Tank Service) CLI — query logs from the terminal')
-    .version('1.0.0')
+    .version(readVersion())
     .addHelpText('after', `
 Examples:
   $ lts-cli init                     Setup credentials interactively
   $ lts-cli init --from-url <url>    Import region/groupId/streamId from a console URL
   $ lts-cli config --list            Show current configuration
-  $ lts-cli query --last 2h --app acerp-gateway --content "error"
-  $ lts-cli trace <requestId>        Fetch full request chain by REQUEST_ID
   $ lts-cli groups                   List log groups
-  $ lts-cli streams                  List log streams
+  $ lts-cli streams                  List log streams in a group
+  $ lts-cli fields                   Show the index config of a log stream
+  $ lts-cli query --last 2h -q 'level:error' --all
+  $ lts-cli trace <requestId>        Fetch the full request chain
 
 Environment variables:
   LTS_AK           Access Key
@@ -38,7 +91,15 @@ program.addCommand((0, trace_1.createTraceCommand)());
 program.addCommand((0, context_1.createContextCommand)());
 program.addCommand((0, streams_1.createGroupsCommand)());
 program.addCommand((0, streams_1.createStreamsCommand)());
+program.addCommand((0, fields_1.createFieldsCommand)());
 program.addCommand((0, config_1.createConfigCommand)());
+/**
+ * 补全列表手写在下面，和命令定义分居两处，很容易漏更新。
+ * 改任何命令的选项时请同步这三段。
+ */
+const QUERY_OPTS = '-g --group-id -s --stream-id --start-time --end-time --st --et --last -q --query --app --content --request-id -l --limit -r --reverse -f --format --all';
+const TRACE_OPTS = '-g --group-id -s --stream-id --field --last --start-time --end-time --st --et -l --limit -f --format';
+const VALUE_OPTS = '-g --group-id -s --stream-id -f --format';
 // Shell completion support
 const completionCmd = new commander_1.Command('completion')
     .description('Generate shell completion script')
@@ -53,7 +114,7 @@ _lts_cli_completion() {
   local cur="\${words[cword]}"
 
   if (( cword == 1 )); then
-    COMPREPLY=( $(compgen -W "query trace context groups streams config init completion" -- "\$cur") )
+    COMPREPLY=( $(compgen -W "query trace context groups streams fields config init completion" -- "\$cur") )
     return
   fi
 
@@ -61,16 +122,32 @@ _lts_cli_completion() {
   case "\$cmd" in
     query)
       case "\$prev" in
-        -g|--group-id|-s|--stream-id|-k|--keyword|-l|--limit|-o|--offset|-f|--format)
+        -g|--group-id|-s|--stream-id|-q|--query|--app|--content|--request-id|-l|--limit|-f|--format)
+          COMPREPLY=()
+          return
+          ;;
+        *)
+          COMPREPLY=( $(compgen -W "${QUERY_OPTS}" -- "\$cur") )
+          return
+          ;;
+      esac
+      ;;
+    trace)
+      case "\$prev" in
+        -g|--group-id|-s|--stream-id|--field|--last|-l|--limit|-f|--format)
           COMPREPLY=()
           return
           ;;
         *)
-          COMPREPLY=( $(compgen -W "-g --group-id -s --stream-id --start-time --end-time --st --et -k --keyword -l --limit -o --offset -r --reverse -f --format --no-paginate" -- "\$cur") )
+          COMPREPLY=( $(compgen -W "${TRACE_OPTS}" -- "\$cur") )
           return
           ;;
       esac
       ;;
+    fields)
+      COMPREPLY=( $(compgen -W "${VALUE_OPTS}" -- "\$cur") )
+      return
+      ;;
     config)
       COMPREPLY=( $(compgen -W "--set --get --list --unset" -- "\$cur") )
       return
@@ -94,10 +171,11 @@ _lts_cli() {
   local -a commands
   commands=(
     'query:Query LTS logs'
-    'trace:Trace request chain by REQUEST_ID'
+    'trace:Trace a request by ID'
     'context:View logs before/after a log entry'
     'groups:List log groups'
     'streams:List log streams'
+    'fields:Show the index config of a log stream'
     'config:Manage configuration'
     'init:Interactive setup wizard'
     'completion:Generate shell completion script'
@@ -124,12 +202,34 @@ _lts_cli() {
             '--end-time[End time (ISO 8601)]:time:' \\
             '--st[Alias for --start-time]:time:' \\
             '--et[Alias for --end-time]:time:' \\
-            '-k[Search keyword]:keyword:' \\
-            '-l[Limit]:number:' \\
-            '-o[Offset]:number:' \\
+            '--last[Relative range: 30m, 2h, 1d, 7d]:duration:' \\
+            '-q[Query expression]:query:' \\
+            '--app[Filter by appName]:appName:' \\
+            '--content[Filter by content]:keyword:' \\
+            '--request-id[Filter by REQUEST_ID]:id:' \\
+            '-l[Page size]:number:' \\
             '-r[Reverse order]' \\
             '-f[Output format]:format:(json table pretty)' \\
-            '--no-paginate[Disable pagination]'
+            '--all[Follow the cursor to the end]'
+          ;;
+        trace)
+          _arguments \\
+            '-g[Log group ID]:group ID:' \\
+            '-s[Log stream ID]:stream ID:' \\
+            '--field[Field to match]:field:' \\
+            '--last[Relative range: 30m, 2h, 1d, 7d]:duration:' \\
+            '--start-time[Start time (ISO 8601)]:time:' \\
+            '--end-time[End time (ISO 8601)]:time:' \\
+            '--st[Alias for --start-time]:time:' \\
+            '--et[Alias for --end-time]:time:' \\
+            '-l[Max logs]:number:' \\
+            '-f[Output format]:format:(json table pretty)'
+          ;;
+        fields|groups|streams)
+          _arguments \\
+            '-g[Log group ID]:group ID:' \\
+            '-s[Log stream ID]:stream ID:' \\
+            '-f[Output format]:format:(json table pretty)'
           ;;
         config)
           _arguments \\
@@ -152,7 +252,7 @@ compdef _lts_cli lts-cli`);
 Register-ArgumentCompleter -CommandName lts-cli -ScriptBlock {
   param(\$wordToComplete, \$commandAst, \$cursorPosition)
 
-  \$commands = @('query', 'trace', 'context', 'groups', 'streams', 'config', 'init', 'completion')
+  \$commands = @('query', 'trace', 'context', 'groups', 'streams', 'fields', 'config', 'init', 'completion')
 
   \$args = \$commandAst.ToString() -split '\\s+'
   if (\$args.Count -le 1) {
@@ -161,7 +261,15 @@ Register-ArgumentCompleter -CommandName lts-cli -ScriptBlock {
 
   switch (\$args[1]) {
     'query' {
-      \$opts = @('-g', '-s', '--start-time', '--end-time', '--st', '--et', '-k', '-l', '-o', '-r', '-f', '--no-paginate')
+      \$opts = @('-g', '-s', '--start-time', '--end-time', '--st', '--et', '--last', '-q', '--app', '--content', '--request-id', '-l', '-r', '-f', '--all')
+      return \$opts | Where-Object { \$_ -like "\$wordToComplete*" }
+    }
+    'trace' {
+      \$opts = @('-g', '-s', '--field', '--last', '--start-time', '--end-time', '--st', '--et', '-l', '-f')
+      return \$opts | Where-Object { \$_ -like "\$wordToComplete*" }
+    }
+    'fields' {
+      \$opts = @('-g', '-s', '-f')
       return \$opts | Where-Object { \$_ -like "\$wordToComplete*" }
     }
     'config' {

package/dist/config/store.js

@@ -36,6 +36,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.readConfigFile = readConfigFile;
 exports.writeConfigFile = writeConfigFile;
 exports.getConfigFilePath = getConfigFilePath;
+exports.getConfigDir = getConfigDir;
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
 const os = __importStar(require("os"));
@@ -43,7 +44,7 @@ const CONFIG_DIR = path.join(os.homedir(), '.lts-cli');
 const CONFIG_FILE = path.join(CONFIG_DIR, 'config.json');
 function ensureDir(dir) {
     if (!fs.existsSync(dir)) {
-        fs.mkdirSync(dir, { recursive: true });
+        fs.mkdirSync(dir, { recursive: true, mode: 0o700 });
     }
 }
 function readConfigFile() {
@@ -60,8 +61,12 @@ function readConfigFile() {
 }
 function writeConfigFile(config) {
     ensureDir(CONFIG_DIR);
-    fs.writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2), 'utf-8');
+    // 配置里是明文 AK/SK：目录 0700、文件 0600，别让同机器上的其他账号读到
+    fs.writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2), { encoding: 'utf-8', mode: 0o600 });
 }
 function getConfigFilePath() {
     return CONFIG_FILE;
 }
+function getConfigDir() {
+    return CONFIG_DIR;
+}

package/dist/lts/client.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.LTSClient = void 0;
 exports.resolveTimeRange = resolveTimeRange;
+exports.parseQueryExpression = parseQueryExpression;
 const LtsClient_1 = require("@huaweicloud/huaweicloud-sdk-lts/v2/LtsClient");
 const ClientBuilder_1 = require("@huaweicloud/huaweicloud-sdk-core/ClientBuilder");
 const BasicCredentials_1 = require("@huaweicloud/huaweicloud-sdk-core/auth/BasicCredentials");
@@ -12,6 +13,8 @@ const ListLogContextRequest_1 = require("@huaweicloud/huaweicloud-sdk-lts/v2/mod
 const ListLogContextRequestBody_1 = require("@huaweicloud/huaweicloud-sdk-lts/v2/model/ListLogContextRequestBody");
 const ListLogGroupsRequest_1 = require("@huaweicloud/huaweicloud-sdk-lts/v2/model/ListLogGroupsRequest");
 const ListLogStreamsRequest_1 = require("@huaweicloud/huaweicloud-sdk-lts/v2/model/ListLogStreamsRequest");
+const ListLogStreamIndexRequest_1 = require("@huaweicloud/huaweicloud-sdk-lts/v2/model/ListLogStreamIndexRequest");
+const pagination_1 = require("./pagination");
 function sleep(ms) {
     return new Promise((resolve) => setTimeout(resolve, ms));
 }
@@ -47,6 +50,9 @@ function resolveTimeRange(params) {
  * - "搜索语句 | SELECT ..." → keywords=搜索语句, query=SQL, is_analysis_query=true
  * - 裸 "SELECT ..."         → query=SQL, is_analysis_query=true
  * - 其他（field:value 等）  → keywords=搜索语句
+ *
+ * 导出仅为测试：这一段决定了用户写的字符串怎么落到 keywords/query 两个字段上，
+ * 拆错了就会静默返回全量日志。
  */
 function parseQueryExpression(expr) {
     const trimmed = expr.trim();
@@ -94,7 +100,6 @@ class LTSClient {
             .withStartTime(startMs.toString())
             .withEndTime(endMs.toString())
             .withLimit(Number.isFinite(params.limit) ? params.limit : 100);
-        // 优先使用 query 参数（支持SQL和结构化查询）
         if (params.query) {
             const parsed = parseQueryExpression(params.query);
             if (parsed.keywords) {
@@ -107,34 +112,37 @@ class LTSClient {
                 queryParams.withIsAnalysisQuery(true);
             }
         }
-        else if (params.keyword) {
-            // 向后兼容：简单关键词搜索
-            queryParams.withKeywords(params.keyword);
-        }
         if (params.reverse !== undefined) {
             queryParams.withIsDesc(params.reverse);
         }
+        // 游标翻页：首屏不带游标，后续页把上一页末条的 line_num 当作续读起点
+        if (params.lineNum) {
+            queryParams.withLineNum(params.lineNum);
+            queryParams.withSearchType(params.searchType ?? (0, pagination_1.cursorDirection)(params.reverse));
+        }
         const request = new ListLogsRequest_1.ListLogsRequest(params.groupId, params.streamId, 'application/json')
             .withBody(queryParams);
         const response = await this.retryRequest(() => this.client.listLogs(request));
         const raw = response;
-        // SQL 分析查询：结果在 analysisLogs 中（行为 JSON 对象）
+        // SQL 分析查询：结果在 analysisLogs 中（行为 JSON 对象，没有 line_num，无法游标翻页）
         if (Array.isArray(raw.analysisLogs)) {
             const logs = raw.analysisLogs.map((row) => ({
-                logTime: '',
+                lineNum: '',
                 content: JSON.stringify(row),
                 labels: {},
             }));
-            return { logs, total: logs.length };
+            return { logs, total: logs.length, isQueryComplete: raw.isQueryComplete };
         }
         const logs = (response.logs || []).map((log) => ({
-            logTime: log.line_num ?? log.lineNum ?? '',
+            lineNum: log.line_num ?? log.lineNum ?? '',
             content: stripHighlightTags(log.content ?? ''),
             labels: Object.fromEntries(Object.entries(log.labels ?? {}).map(([k, v]) => [k, stripHighlightTags(v)])),
         }));
         return {
             logs,
             total: response.count ?? logs.length,
+            // 服务端报告结果被截断时必须传出去，否则 AI 会拿着残缺数据下结论
+            isQueryComplete: raw.isQueryComplete,
         };
     }
     /** 查询某条日志的上下文（前后各 N 行），对应控制台的“查看上下文” */
@@ -148,7 +156,7 @@ class LTSClient {
             .withBody(body);
         const response = await this.retryRequest(() => this.client.listLogContext(request));
         const logs = (response.logs || []).map((log) => ({
-            logTime: log.line_num ?? log.lineNum ?? '',
+            lineNum: log.line_num ?? log.lineNum ?? '',
             content: log.content ?? '',
             labels: log.labels ?? {},
         }));
@@ -184,6 +192,32 @@ class LTSClient {
             groupId: s.log_group_id,
         }));
     }
+    /** 读取日志流的索引配置（全文索引 + 字段索引），供 `fields` 命令与 AI 运行时发现 */
+    async getStreamIndex(groupId, streamId) {
+        const request = new ListLogStreamIndexRequest_1.ListLogStreamIndexRequest(groupId, streamId, 'application/json');
+        const response = await this.retryRequest(() => this.client.listLogStreamIndex(request));
+        const raw = response;
+        // SDK 在不同版本下可能给出 class 实例（camelCase）或纯对象（snake_case），两者都认
+        const fullText = raw.fullTextIndex ?? raw.full_text_index ?? {};
+        const fields = (raw.fields ?? []);
+        return {
+            streamId: raw.logStreamId ?? raw.log_stream_id ?? streamId,
+            fullText: {
+                enabled: fullText.enable === true,
+                caseSensitive: fullText.caseSensitive ?? fullText.case_sensitive,
+                includeChinese: fullText.includeChinese ?? fullText.include_chinese,
+                tokenizer: fullText.tokenizer,
+            },
+            fields: fields.map((f) => ({
+                name: f.fieldName ?? f.field_name ?? '',
+                type: f.fieldType ?? f.field_type ?? '',
+                caseSensitive: f.caseSensitive ?? f.case_sensitive,
+                includeChinese: f.includeChinese ?? f.include_chinese,
+                tokenizer: f.tokenizer,
+                quickAnalysis: f.quickAnalysis ?? f.quick_analysis,
+            })),
+        };
+    }
     async retryRequest(fn, maxRetries = 3) {
         let lastError;
         for (let attempt = 0; attempt <= maxRetries; attempt++) {

package/dist/lts/pagination.js

@@ -0,0 +1,56 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cursorDirection = cursorDirection;
+exports.nextCursor = nextCursor;
+exports.fetchAllPages = fetchAllPages;
+/** 倒序（新到旧）→ 往更早读；正序 → 往更晚读。 */
+function cursorDirection(reverse) {
+    return reverse ? 'backwards' : 'forwards';
+}
+/** 游标取本页最后一条的 line_num；拿不到就返回 undefined（调用方据此停止）。 */
+function nextCursor(logs) {
+    if (logs.length === 0)
+        return undefined;
+    const last = logs[logs.length - 1].lineNum;
+    return last ? last : undefined;
+}
+async function fetchAllPages(fetchPage, params, options = {}) {
+    const max = options.max ?? 10000;
+    const pageSize = options.pageSize ?? params.limit ?? 100;
+    const direction = cursorDirection(params.reverse);
+    const collected = [];
+    let cursor;
+    let isQueryComplete;
+    let truncated = false;
+    while (collected.length < max) {
+        const page = await fetchPage({
+            ...params,
+            limit: pageSize,
+            lineNum: cursor,
+            searchType: cursor ? direction : undefined,
+        });
+        if (page.isQueryComplete === false) {
+            isQueryComplete = false;
+        }
+        else if (isQueryComplete === undefined && page.isQueryComplete === true) {
+            isQueryComplete = true;
+        }
+        if (page.logs.length === 0)
+            break;
+        const next = nextCursor(page.logs);
+        // 服务端把同一段原样又给了一遍：整页丢弃并停止。
+        // 先判游标再入账，否则重放的一页会被当成新数据拼进结果。
+        if (cursor !== undefined && next === cursor)
+            break;
+        collected.push(...page.logs);
+        // 不满一页 = 没有更多了；拿不到游标则无法继续翻页
+        if (page.logs.length < pageSize || !next)
+            break;
+        cursor = next;
+        if (collected.length >= max) {
+            truncated = true;
+        }
+    }
+    const logs = collected.slice(0, max);
+    return { logs, total: logs.length, isQueryComplete, truncated };
+}

package/dist/output/index.js

@@ -27,7 +27,7 @@ function formatPretty(data) {
     lines.push(chalk_1.default.bold.green(`Found ${data.total} logs:`));
     lines.push('');
     for (const log of data.logs) {
-        lines.push(chalk_1.default.cyan(`[${log.logTime}]`));
+        lines.push(chalk_1.default.cyan(`[${log.lineNum}]`));
         lines.push(chalk_1.default.white(log.content));
         if (Object.keys(log.labels).length > 0) {
             const labels = Object.entries(log.labels)

package/dist/output/table.js

@@ -10,7 +10,7 @@ function formatTable(data) {
         return 'No logs found.';
     }
     const table = new cli_table3_1.default({
-        head: ['Time', 'Content', 'Labels'],
+        head: ['Line', 'Content', 'Labels'],
         colWidths: [25, 50, 30],
         wordWrap: true,
     });
@@ -18,7 +18,7 @@ function formatTable(data) {
         const labelsStr = Object.entries(log.labels)
             .map(([k, v]) => `${k}=${v}`)
             .join(', ');
-        table.push([log.logTime, log.content, labelsStr]);
+        table.push([log.lineNum, log.content, labelsStr]);
     }
     return table.toString();
 }