@ai-setting/roy-agent-cli 1.3.14 → 1.3.16

package/dist/cli/src/commands/config/list.js

@@ -0,0 +1,233 @@
+/**
+ * @fileoverview config list 子命令
+ *
+ * 原 show-config 功能的重构版本
+ */
+import chalk from "chalk";
+import { EnvironmentService } from "../../services/environment.service.js";
+import { OutputService } from "../../services/output.service.js";
+import { ConfigService } from "./config-service.js";
+import { SUPPORTED_COMPONENTS, COMPONENT_DESCRIPTIONS, resolveComponentName } from "./types.js";
+/**
+ * show-config 命令使用示例
+ */
+const USAGE_COMMANDS = [
+    { command: "roy config list", description: "显示帮助信息" },
+    { command: "roy config list tool", description: "查看 tool component 配置" },
+    { command: "roy config list session", description: "查看 session component 配置" },
+    { command: "roy config list all", description: "查看所有 components 概览" },
+    { command: "roy config list tool --json", description: "JSON 格式输出" },
+    { command: "roy config list tool --keys", description: "只显示配置键" },
+];
+/**
+ * ConfigListCommand - config list 子命令
+ */
+export const ConfigListCommand = {
+    command: "list [component]",
+    describe: "查看组件配置信息",
+    builder: (yargs) => yargs
+        .positional("component", {
+        type: "string",
+        describe: "Component 名称",
+    })
+        .option("json", {
+        type: "boolean",
+        describe: "JSON 格式输出",
+        alias: "j",
+    })
+        .option("keys", {
+        type: "boolean",
+        describe: "只显示配置键",
+        alias: "k",
+    })
+        .option("sources", {
+        type: "boolean",
+        describe: "只显示配置源",
+        alias: "s",
+    })
+        .option("config", {
+        type: "string",
+        describe: "配置文件路径",
+        alias: "c",
+    })
+        .example("roy config list", "显示帮助信息")
+        .example("roy config list tool", "查看 tool component 配置")
+        .example("roy config list session", "查看 session component 配置")
+        .example("roy config list all", "查看所有 components 概览")
+        .example("roy config list tool --json", "JSON 格式输出")
+        .example("roy config list tool --keys", "只显示配置键"),
+    async handler(args) {
+        const output = new OutputService();
+        const envService = new EnvironmentService(output);
+        try {
+            await envService.create({ configPath: args.config });
+            const env = envService.getEnvironment();
+            if (!env) {
+                output.error("Failed to get environment");
+                process.exit(1);
+            }
+            const configComponent = env.getComponent("config");
+            if (!configComponent) {
+                output.error("ConfigComponent not available");
+                process.exit(1);
+            }
+            const configService = new ConfigService(configComponent, output);
+            // 无参数时显示帮助
+            if (!args.component) {
+                showHelp(output);
+                return;
+            }
+            // all: 显示所有 components
+            if (args.component === "all") {
+                await showAllComponents(output, configService);
+                return;
+            }
+            // 解析 component 名称（处理别名）
+            const componentName = resolveComponentName(args.component);
+            // 验证 component
+            if (!SUPPORTED_COMPONENTS.includes(componentName)) {
+                output.error(`Unknown component: ${args.component}`);
+                output.log("");
+                output.log("Supported components:");
+                for (const comp of SUPPORTED_COMPONENTS) {
+                    output.log(`  ${chalk.cyan(comp.padEnd(15))} ${COMPONENT_DESCRIPTIONS[comp] || ""}`);
+                }
+                process.exit(1);
+            }
+            // 显示特定 component
+            await showComponentConfig(componentName, output, configService, {
+                json: args.json,
+                keys: args.keys,
+                sources: args.sources,
+            });
+        }
+        catch (error) {
+            output.error(`Failed to show config: ${error}`);
+            process.exit(1);
+        }
+        finally {
+            await envService.dispose();
+        }
+    },
+};
+/**
+ * 显示帮助信息
+ */
+function showHelp(output) {
+    output.log(chalk.bold.cyan("# roy config list"));
+    output.log("");
+    output.log("查看 roy-agent 组件配置信息");
+    output.log("");
+    output.log(chalk.bold("Usage:"));
+    output.log(`  ${chalk.cyan("roy config list [component] [options]")}`);
+    output.log("");
+    output.log(chalk.bold("Components:"));
+    for (const comp of SUPPORTED_COMPONENTS) {
+        output.log(`  ${chalk.cyan(comp.padEnd(15))} ${chalk.gray(COMPONENT_DESCRIPTIONS[comp] || "")}`);
+    }
+    output.log(`  ${chalk.cyan("all".padEnd(15))} 显示所有 components 概览`);
+    output.log("");
+    output.log(chalk.bold("Options:"));
+    output.log(`  ${chalk.cyan("-j, --json")}     JSON 格式输出`);
+    output.log(`  ${chalk.cyan("-k, --keys")}     只显示配置键`);
+    output.log(`  ${chalk.cyan("-s, --sources")}  只显示配置源`);
+    output.log("");
+    output.log(chalk.bold("Examples:"));
+    for (const { command, description } of USAGE_COMMANDS) {
+        output.log(`  ${chalk.cyan(command.padEnd(40))} ${chalk.gray(description)}`);
+    }
+}
+/**
+ * 显示所有 components 概览
+ */
+async function showAllComponents(output, configService) {
+    const components = [];
+    for (const compName of SUPPORTED_COMPONENTS) {
+        const config = configService.getComponentConfig(compName);
+        components.push({ name: compName, config });
+    }
+    output.log(chalk.bold.cyan("# All Components Overview"));
+    output.log("");
+    output.log(`  ${chalk.cyan("Component".padEnd(15))} ${chalk.cyan("Keys".padEnd(10))} ${chalk.gray("Description")}`);
+    output.log(`  ${chalk.gray("─".repeat(60))}`);
+    for (const comp of components) {
+        const keyCount = Object.keys(comp.config).length;
+        output.log(`  ${chalk.cyan(comp.name.padEnd(15))} ${keyCount.toString().padEnd(10)} ${chalk.gray(COMPONENT_DESCRIPTIONS[comp.name] || "")}`);
+    }
+}
+/**
+ * 显示特定 component 配置
+ */
+async function showComponentConfig(componentName, output, configService, options) {
+    const config = configService.getComponentConfig(componentName);
+    const filePath = configService.getComponentFilePath(componentName);
+    if (options.json) {
+        output.json({
+            name: componentName,
+            filePath,
+            config,
+        });
+        return;
+    }
+    output.log(chalk.bold.cyan(`# ${componentName} Component Configuration`));
+    output.log("");
+    // File Path
+    if (filePath) {
+        output.log(chalk.bold("File:"));
+        output.log(`  ${chalk.cyan(filePath)}`);
+        output.log("");
+    }
+    // Config Keys
+    if (!options.sources) {
+        output.log(chalk.bold("Configuration:"));
+        if (Object.keys(config).length === 0) {
+            output.log(`  ${chalk.gray("（无配置）")}`);
+        }
+        else {
+            const flatConfig = flattenConfig(config);
+            for (const [key, value] of flatConfig) {
+                const displayValue = formatValue(value);
+                output.log(`  ${chalk.cyan(key + ":")} ${displayValue}`);
+            }
+        }
+        output.log("");
+    }
+}
+/**
+ * 扁平化配置对象
+ */
+function flattenConfig(obj, prefix = "") {
+    const result = [];
+    if (typeof obj !== "object" || obj === null) {
+        if (prefix) {
+            result.push([prefix, obj]);
+        }
+        return result;
+    }
+    for (const [key, value] of Object.entries(obj)) {
+        const fullKey = prefix ? `${prefix}.${key}` : key;
+        if (typeof value === "object" && value !== null && !Array.isArray(value)) {
+            result.push(...flattenConfig(value, fullKey));
+        }
+        else {
+            result.push([fullKey, value]);
+        }
+    }
+    return result;
+}
+/**
+ * 格式化值显示
+ */
+function formatValue(value) {
+    if (value === undefined) {
+        return chalk.gray("undefined");
+    }
+    if (value === null) {
+        return chalk.gray("null");
+    }
+    if (typeof value === "object") {
+        return chalk.gray(JSON.stringify(value));
+    }
+    return String(value);
+}
+//# sourceMappingURL=list.js.map

package/dist/cli/src/commands/config/types.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @fileoverview config 子命令类型定义
+ */
+/**
+ * 所有支持的 Components 列表
+ */
+export declare const SUPPORTED_COMPONENTS: readonly ["tool", "task", "memory", "session", "skill", "commands", "eventsource", "mcp", "agent", "log-trace", "lsp"];
+export type SupportedComponent = typeof SUPPORTED_COMPONENTS[number];
+/**
+ * Component 别名映射（用户输入 -> 内部名称）
+ */
+export declare const COMPONENT_ALIASES: Record<string, string>;
+/**
+ * 获取组件的内部名称（处理别名）
+ */
+export declare function resolveComponentName(name: string): string;
+/**
+ * Component 描述映射
+ */
+export declare const COMPONENT_DESCRIPTIONS: Record<string, string>;
+//# sourceMappingURL=types.d.ts.map

package/dist/cli/src/commands/config/types.js

@@ -0,0 +1,49 @@
+/**
+ * @fileoverview config 子命令类型定义
+ */
+/**
+ * 所有支持的 Components 列表
+ */
+export const SUPPORTED_COMPONENTS = [
+    'tool',
+    'task',
+    'memory',
+    'session',
+    'skill',
+    'commands',
+    'eventsource',
+    'mcp',
+    'agent',
+    'log-trace',
+    'lsp',
+];
+/**
+ * Component 别名映射（用户输入 -> 内部名称）
+ */
+export const COMPONENT_ALIASES = {
+    session: 'session',
+    sessions: 'session',
+};
+/**
+ * 获取组件的内部名称（处理别名）
+ */
+export function resolveComponentName(name) {
+    return COMPONENT_ALIASES[name] ?? name;
+}
+/**
+ * Component 描述映射
+ */
+export const COMPONENT_DESCRIPTIONS = {
+    tool: 'Tool Component - 工具管理',
+    task: 'Task Component - 任务管理',
+    memory: 'Memory Component - 记忆管理',
+    session: 'Session Component - 会话管理',
+    skill: 'Skill Component - 技能管理',
+    commands: 'Commands Component - 命令管理',
+    eventsource: 'EventSource Component - 事件源管理',
+    mcp: 'MCP Component - MCP 服务器管理',
+    agent: 'Agent Component - Agent 配置和循环控制',
+    'log-trace': 'LogTrace Component - 日志和追踪管理',
+    lsp: 'LSP Component - 语言服务器协议管理',
+};
+//# sourceMappingURL=types.js.map

package/dist/cli/src/commands/debug/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @fileoverview Debug Commands Entry
+ *
+ * Command: roy debug [log|trace|span]
+ *
+ * 提供调试能力：
+ * - log: 查看日志文件（支持 --tail -n）
+ * - trace: 以 tree 方式查看 trace 的 spans
+ * - span: 通过 spanId 查询详细的 span 信息
+ */
+import type { CommandModule } from "yargs";
+/**
+ * Debug Command
+ */
+export declare const DebugCommand: CommandModule;
+export { LogCommand } from "./log";
+export { TraceCommand } from "./trace";
+export { SpanCommand } from "./span";
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/src/commands/debug/index.js

@@ -0,0 +1,34 @@
+/**
+ * @fileoverview Debug Commands Entry
+ *
+ * Command: roy debug [log|trace|span]
+ *
+ * 提供调试能力：
+ * - log: 查看日志文件（支持 --tail -n）
+ * - trace: 以 tree 方式查看 trace 的 spans
+ * - span: 通过 spanId 查询详细的 span 信息
+ */
+import { LogCommand } from "./log.js";
+import { TraceCommand } from "./trace.js";
+import { SpanCommand } from "./span.js";
+/**
+ * Debug Command
+ */
+export const DebugCommand = {
+    command: "debug",
+    describe: "调试工具 - 日志查看、trace 分析、span 查询",
+    builder: (yargs) => yargs
+        .command(LogCommand)
+        .command(TraceCommand)
+        .command(SpanCommand)
+        .demandCommand()
+        .help(),
+    handler: () => {
+        // Default handler - will show help
+    },
+};
+// Export subcommands for testing
+export { LogCommand } from "./log.js";
+export { TraceCommand } from "./trace.js";
+export { SpanCommand } from "./span.js";
+//# sourceMappingURL=index.js.map

package/dist/cli/src/commands/debug/log.d.ts

@@ -0,0 +1,29 @@
+/**
+ * @fileoverview Debug Log Command
+ *
+ * Command: roy debug log --tail -n <lines>
+ *
+ * 读取 log-trace component 日志配置对应的日志文件，显示尾部 n 行
+ */
+import type { CommandModule } from "yargs";
+interface LogOptions {
+    tail?: number;
+    file?: string;
+}
+export declare const LogCommand: CommandModule<object, LogOptions>;
+/**
+ * 读取文件尾部 n 行
+ */
+export declare function readTailLines(filePath: string, n: number): Promise<string[]>;
+/**
+ * 获取默认日志文件路径
+ *
+ * 使用 log-trace component 的配置：
+ * - log-trace.logging.dir: 日志目录
+ * - log-trace.logging.file: 日志文件名
+ *
+ * 默认: ~/.local/share/roy-agent/logs/app.log
+ */
+export declare function getDefaultLogFile(): string;
+export {};
+//# sourceMappingURL=log.d.ts.map

package/dist/cli/src/commands/debug/log.js

@@ -0,0 +1,102 @@
+/**
+ * @fileoverview Debug Log Command
+ *
+ * Command: roy debug log --tail -n <lines>
+ *
+ * 读取 log-trace component 日志配置对应的日志文件，显示尾部 n 行
+ */
+import * as fs from "fs";
+import * as path from "path";
+import * as readline from "readline";
+export const LogCommand = {
+    command: "log",
+    describe: "查看日志文件（支持 --tail -n 显示尾部行）",
+    builder: (yargs) => yargs
+        .option("tail", {
+        alias: "n",
+        type: "number",
+        description: "显示尾部 n 行（默认 50）",
+        default: 50,
+    })
+        .option("file", {
+        alias: "f",
+        type: "string",
+        description: "日志文件路径（可选，默认使用配置路径）",
+    }),
+    async handler(args) {
+        // 获取日志文件路径
+        const logFile = args.file || getDefaultLogFile();
+        if (!fs.existsSync(logFile)) {
+            console.error(`Log file not found: ${logFile}`);
+            process.exit(1);
+        }
+        try {
+            const lines = await readTailLines(logFile, args.tail || 50);
+            if (lines.length === 0) {
+                console.log("(empty log file)");
+                return;
+            }
+            // 逐行输出
+            for (const line of lines) {
+                console.log(line);
+            }
+        }
+        catch (error) {
+            console.error(`Failed to read log file: ${error}`);
+            process.exit(1);
+        }
+    },
+};
+/**
+ * 读取文件尾部 n 行
+ */
+export async function readTailLines(filePath, n) {
+    return new Promise((resolve, reject) => {
+        const lines = [];
+        const rl = readline.createInterface({
+            input: fs.createReadStream(filePath),
+            crlfDelay: Infinity,
+        });
+        rl.on("line", (line) => {
+            lines.push(line);
+            // 只保留尾部 n 行
+            if (lines.length > n) {
+                lines.shift();
+            }
+        });
+        rl.on("close", () => {
+            resolve(lines);
+        });
+        rl.on("error", (err) => {
+            reject(err);
+        });
+    });
+}
+/**
+ * 获取默认日志文件路径
+ *
+ * 使用 log-trace component 的配置：
+ * - log-trace.logging.dir: 日志目录
+ * - log-trace.logging.file: 日志文件名
+ *
+ * 默认: ~/.local/share/roy-agent/logs/app.log
+ */
+export function getDefaultLogFile() {
+    // 支持环境变量覆盖
+    if (process.env.LOG_TRACE_LOGGING_DIR) {
+        const dir = process.env.LOG_TRACE_LOGGING_DIR;
+        const file = process.env.LOG_TRACE_LOGGING_FILE || "app.log";
+        return path.join(dir, file);
+    }
+    // 支持直接指定文件路径
+    if (process.env.LOG_TRACE_LOGGING_FILE?.includes("/") || process.env.LOG_TRACE_LOGGING_FILE?.includes("\\")) {
+        return process.env.LOG_TRACE_LOGGING_FILE;
+    }
+    // 使用 XDG 标准路径
+    const home = process.env.HOME || process.env.USERPROFILE || "/tmp";
+    const dataHome = process.env.XDG_DATA_HOME || path.join(home, ".local", "share");
+    const logDir = path.join(dataHome, "roy-agent", "logs");
+    const logFile = process.env.LOG_TRACE_LOGGING_FILE || "app.log";
+    return path.join(logDir, logFile);
+}
+//# sourceMappingURL=log.js.map

package/dist/cli/src/commands/debug/span.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @fileoverview Debug Span Command
+ *
+ * Command: roy debug span <spanId>
+ *
+ * 通过 spanId 从 SQLite 中查询详细的 span 信息
+ */
+import type { CommandModule } from "yargs";
+import type { Span } from "@ai-setting/roy-agent-core";
+interface SpanOptions {
+    spanId?: string;
+    db?: string;
+}
+export declare const SpanCommand: CommandModule<object, SpanOptions>;
+/**
+ * 获取默认的 span 数据库路径
+ */
+export declare function getDefaultSpanDbPath(): string;
+/**
+ * 格式化 span 为详细输出
+ */
+export declare function formatSpanDetail(span: Span): string;
+export {};
+//# sourceMappingURL=span.d.ts.map