@cvtoolman/huawei-lts-cli 1.0.2 → 2.0.0

package/dist/cli/index.js

@@ -1,20 +1,80 @@
 #!/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");
+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 --st 2024-01-01T00:00:00Z --et 2024-01-02T00:00:00Z
+  $ lts-cli groups                   List log groups
+  $ 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
@@ -27,7 +87,19 @@ Environment variables:
 `);
 program.addCommand((0, init_1.createInitCommand)());
 program.addCommand((0, query_1.createQueryCommand)());
+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')
@@ -42,7 +114,7 @@ _lts_cli_completion() {
   local cur="\${words[cword]}"
 
   if (( cword == 1 )); then
-    COMPREPLY=( $(compgen -W "query config init completion" -- "\$cur") )
+    COMPREPLY=( $(compgen -W "query trace context groups streams fields config init completion" -- "\$cur") )
     return
   fi
 
@@ -50,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
@@ -83,6 +171,11 @@ _lts_cli() {
   local -a commands
   commands=(
     'query:Query LTS logs'
+    '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'
@@ -109,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 \\
@@ -137,7 +252,7 @@ compdef _lts_cli lts-cli`);
 Register-ArgumentCompleter -CommandName lts-cli -ScriptBlock {
   param(\$wordToComplete, \$commandAst, \$cursorPosition)
 
-  \$commands = @('query', 'config', 'init', 'completion')
+  \$commands = @('query', 'trace', 'context', 'groups', 'streams', 'fields', 'config', 'init', 'completion')
 
   \$args = \$commandAst.ToString() -split '\\s+'
   if (\$args.Count -le 1) {
@@ -146,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/profile.js

@@ -0,0 +1,108 @@
+"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 });
+exports.getProfilePath = getProfilePath;
+exports.profileExists = profileExists;
+exports.writeProfileSkeleton = writeProfileSkeleton;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const store_1 = require("./store");
+/**
+ * `profile.md` 是给人写、给 AI 读的业务词表。CLI 从不读它。
+ *
+ * 分界线：`config.json` 存 CLI 的行为（凭证、traceField、默认 group/stream）；
+ * `profile.md` 存 API 拿不到的东西（业务词 → 日志里的值、命名约定、黑话）。
+ * 字段清单、日志组/流 ID 一律不进 profile —— 那是第二份会过期的真相，
+ * 用 `lts-cli groups` / `streams` / `fields` 现查。
+ */
+function getProfilePath() {
+    return path.join((0, store_1.getConfigDir)(), 'profile.md');
+}
+function profileExists() {
+    return fs.existsSync(getProfilePath());
+}
+const SKELETON = `# LTS 业务词表（本机私有）
+
+> 这份文件给人改、给 AI 读。\`lts-cli\` 本身**不读**它——CLI 的行为配置在 \`~/.lts-cli/config.json\`。
+>
+> 只写 API 拿不到的东西：业务词怎么落到日志里的值、团队自己的命名约定、黑话。
+> **不要**把日志组/日志流 ID、字段清单写进来——用 \`lts-cli groups\` / \`lts-cli streams\` /
+> \`lts-cli fields\` 现查。抄进文档的那一刻它就开始过期。
+
+## 1. 业务称呼 → 日志里的取值
+
+查日志前先在这里翻译，避免每次重新猜应用名。
+
+| 业务称呼 | 日志中的取值 | 说明 |
+| --- | --- | --- |
+| 订单服务 | （填字段值和值） | 例如 appName 或 service_name 的取值 |
+
+## 2. 字段含义
+
+只写「这个字段在我们这里表示什么」。类型、是否大小写敏感、分词符请用 \`lts-cli fields\` 查。
+
+| 字段 | 含义 |
+| --- | --- |
+| （字段名） | （说明） |
+
+## 3. 命名约定与分词陷阱
+
+- 哪些值含连字符/下划线，必须加双引号才会被当成一个词
+- 值的大小写约定（全大写？小写？）
+- 哪些字段看起来该有索引、实际上没建（没建索引的字段只能全文检索命中）
+
+## 4. 团队黑话
+
+| 说法 | 实际指什么 |
+| --- | --- |
+| （黑话） | （含义） |
+
+## 5. 常用排查入口
+
+| 想查什么 | 建议命令 |
+| --- | --- |
+| 某个 ID 的完整链路 | \`lts-cli trace <id>\` |
+| 某业务最近的报错 | \`lts-cli query --last 1h -q '(字段):(值)'\` |
+| 先看清楚这条流有什么字段 | \`lts-cli fields\` |
+`;
+function writeProfileSkeleton() {
+    const target = getProfilePath();
+    if (fs.existsSync(target)) {
+        return { path: target, created: false };
+    }
+    fs.mkdirSync(path.dirname(target), { recursive: true, mode: 0o700 });
+    fs.writeFileSync(target, SKELETON, { encoding: 'utf-8', mode: 0o600 });
+    return { path: target, created: true };
+}

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

@@ -1,15 +1,80 @@
 "use strict";
 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");
 const region_1 = require("@huaweicloud/huaweicloud-sdk-core/region/region");
 const ListLogsRequest_1 = require("@huaweicloud/huaweicloud-sdk-lts/v2/model/ListLogsRequest");
 const QueryLtsLogParams_1 = require("@huaweicloud/huaweicloud-sdk-lts/v2/model/QueryLtsLogParams");
+const ListLogContextRequest_1 = require("@huaweicloud/huaweicloud-sdk-lts/v2/model/ListLogContextRequest");
+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));
 }
+const DURATION_REGEX = /^(\d+)([mhd])$/;
+const DURATION_UNIT_MS = {
+    m: 60 * 1000,
+    h: 60 * 60 * 1000,
+    d: 24 * 60 * 60 * 1000,
+};
+/** 解析相对时间范围（如 30m/2h/1d），返回 [startMs, endMs] */
+function resolveTimeRange(params) {
+    if (params.last) {
+        const match = DURATION_REGEX.exec(params.last.trim());
+        if (!match) {
+            throw new Error(`Invalid --last duration: "${params.last}". Expected format like 30m, 2h, 1d, 7d.`);
+        }
+        const amount = parseInt(match[1], 10);
+        const endMs = Date.now();
+        return { startMs: endMs - amount * DURATION_UNIT_MS[match[2]], endMs };
+    }
+    if (!params.startTime || !params.endTime) {
+        throw new Error('Time range required: provide --last (e.g. --last 2h) or both --start-time and --end-time.');
+    }
+    const startMs = new Date(params.startTime).getTime();
+    const endMs = new Date(params.endTime).getTime();
+    if (Number.isNaN(startMs) || Number.isNaN(endMs)) {
+        throw new Error(`Invalid time format. Use ISO 8601 (e.g. 2024-01-01T00:00:00Z).`);
+    }
+    return { startMs, endMs };
+}
+/**
+ * 解析查询表达式（对齐控制台管道语法）：
+ * - "搜索语句 | 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();
+    if (trimmed.includes('|')) {
+        const idx = trimmed.indexOf('|');
+        const searchPart = trimmed.slice(0, idx).trim();
+        const sqlPart = trimmed.slice(idx + 1).trim();
+        return {
+            keywords: searchPart && searchPart !== '*' ? searchPart : undefined,
+            query: sqlPart || undefined,
+            isAnalysisQuery: sqlPart.length > 0,
+        };
+    }
+    if (/^select\s/i.test(trimmed)) {
+        return { query: trimmed, isAnalysisQuery: true };
+    }
+    return { keywords: trimmed, isAnalysisQuery: false };
+}
+/** 服务端默认在命中词上包裹 <HighLightTag>，输出前剥离 */
+function stripHighlightTags(value) {
+    return value.replace(/<\/?HighLightTag>/g, '');
+}
 class LTSClient {
     client;
     config;
@@ -30,32 +95,127 @@ class LTSClient {
         this.client = builder.build();
     }
     async queryLogs(params) {
+        const { startMs, endMs } = resolveTimeRange(params);
         const queryParams = new QueryLtsLogParams_1.QueryLtsLogParams()
-            .withStartTime(new Date(params.startTime).getTime().toString())
-            .withEndTime(new Date(params.endTime).getTime().toString())
-            .withLimit(params.limit ?? 100);
-        // 优先使用 query 参数（支持SQL和结构化查询）
+            .withStartTime(startMs.toString())
+            .withEndTime(endMs.toString())
+            .withLimit(Number.isFinite(params.limit) ? params.limit : 100);
         if (params.query) {
-            queryParams.withQuery(params.query);
-        }
-        else if (params.keyword) {
-            // 向后兼容：简单关键词搜索
-            queryParams.withKeywords(params.keyword);
+            const parsed = parseQueryExpression(params.query);
+            if (parsed.keywords) {
+                queryParams.withKeywords(parsed.keywords);
+            }
+            if (parsed.query) {
+                queryParams.withQuery(parsed.query);
+            }
+            if (parsed.isAnalysisQuery) {
+                queryParams.withIsAnalysisQuery(true);
+            }
         }
         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 对象，没有 line_num，无法游标翻页）
+        if (Array.isArray(raw.analysisLogs)) {
+            const logs = raw.analysisLogs.map((row) => ({
+                lineNum: '',
+                content: JSON.stringify(row),
+                labels: {},
+            }));
+            return { logs, total: logs.length, isQueryComplete: raw.isQueryComplete };
+        }
         const logs = (response.logs || []).map((log) => ({
-            logTime: 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 行），对应控制台的“查看上下文” */
+    async queryContext(params) {
+        const body = new ListLogContextRequestBody_1.ListLogContextRequestBody()
+            .withLineNum(params.lineNum)
+            .withTime(params.time)
+            .withBackwardsSize(params.before ?? 20)
+            .withForwardsSize(params.after ?? 20);
+        const request = new ListLogContextRequest_1.ListLogContextRequest(params.groupId, params.streamId, 'application/json')
+            .withBody(body);
+        const response = await this.retryRequest(() => this.client.listLogContext(request));
+        const logs = (response.logs || []).map((log) => ({
+            lineNum: log.line_num ?? log.lineNum ?? '',
             content: log.content ?? '',
             labels: log.labels ?? {},
         }));
         return {
             logs,
-            total: response.count ?? logs.length,
+            // SDK 实际返回纯对象，字段为 snake_case
+            total: response.total_count ?? response.totalCount ?? logs.length,
+        };
+    }
+    /** 列出全部日志组 */
+    async listGroups() {
+        const request = new ListLogGroupsRequest_1.ListLogGroupsRequest();
+        const response = await this.retryRequest(() => this.client.listLogGroups(request));
+        // SDK 实际返回纯对象，字段为 snake_case（log_groups）
+        const groups = (response.log_groups ?? []);
+        return groups.map((g) => ({
+            id: g.log_group_id ?? '',
+            name: g.log_group_name ?? '',
+        }));
+    }
+    /** 列出日志流，可按日志组名称过滤（API 使用组名而非组 ID） */
+    async listStreams(groupName) {
+        const request = new ListLogStreamsRequest_1.ListLogStreamsRequest('application/json');
+        if (groupName) {
+            request.withLogGroupName(groupName);
+        }
+        const response = await this.retryRequest(() => this.client.listLogStreams(request));
+        // SDK 实际返回纯对象，字段为 snake_case（log_streams）
+        const streams = (response.log_streams ?? []);
+        return streams.map((s) => ({
+            id: s.log_stream_id ?? '',
+            name: s.log_stream_name ?? '',
+            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) {

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