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

package/dist/cli/src/services/output.service.js

@@ -0,0 +1,104 @@
+/**
+ * @fileoverview Output Service
+ *
+ * 统一的输出格式化服务（非交互式）
+ */
+import chalk from "chalk";
+/**
+ * OutputService - CLI 输出服务
+ *
+ * 提供统一的格式化输出：
+ * - 普通消息
+ * - 成功/警告/错误消息
+ * - JSON 输出
+ */
+export class OutputService {
+    quiet = false;
+    jsonOutput = false;
+    noColor = false;
+    /**
+     * 配置输出选项
+     */
+    configure(options) {
+        this.quiet = options.quiet ?? this.quiet;
+        this.jsonOutput = options.jsonOutput ?? this.jsonOutput;
+        this.noColor = options.noColor ?? this.noColor;
+    }
+    /**
+     * 获取配置状态
+     */
+    isQuiet() {
+        return this.quiet;
+    }
+    isJsonOutput() {
+        return this.jsonOutput;
+    }
+    isNoColor() {
+        return this.noColor;
+    }
+    /**
+     * 输出普通消息
+     */
+    info(message) {
+        if (!this.quiet) {
+            console.log(message);
+        }
+    }
+    /**
+     * 输出日志消息（不添加前缀）
+     */
+    log(message) {
+        console.log(message ?? "");
+    }
+    /**
+     * 输出成功消息
+     */
+    success(message) {
+        if (!this.quiet) {
+            console.log(chalk.green("✓ ") + message);
+        }
+    }
+    /**
+     * 输出警告消息
+     */
+    warn(message) {
+        if (!this.quiet) {
+            console.warn(chalk.yellow("⚠ ") + message);
+        }
+    }
+    /**
+     * 输出错误消息
+     *
+     * 注意：错误消息即使在安静模式下也会输出
+     */
+    error(message) {
+        console.error(chalk.red("✗ ") + message);
+    }
+    /**
+     * 输出错误消息（详细版）
+     */
+    errorDetailed(message, details) {
+        console.error(chalk.red("✗ ") + message);
+        if (details && !this.quiet) {
+            console.error(JSON.stringify(details, null, 2));
+        }
+    }
+    /**
+     * 格式化并输出 JSON
+     */
+    printJson(data, pretty = true) {
+        if (pretty) {
+            console.log(JSON.stringify(data, null, 2));
+        }
+        else {
+            console.log(JSON.stringify(data));
+        }
+    }
+    /**
+     * 输出 JSON（别名方法）
+     */
+    json(data) {
+        this.printJson(data);
+    }
+}
+//# sourceMappingURL=output.service.js.map

package/dist/cli/src/services/quiet-mode.service.d.ts

@@ -0,0 +1,58 @@
+/**
+ * @fileoverview CLI Quiet Mode Service
+ *
+ * 统一管理 CLI 的 quiet 模式状态
+ *
+ * 设计目标：
+ * 1. 单例模式 - 全局共享状态
+ * 2. 与 LogTraceComponent 集成 - 通过 ConfigComponent 配置
+ * 3. 支持命令行参数和配置文件双重控制
+ *
+ * 使用方式：
+ * ```typescript
+ * // 1. 从命令行参数设置
+ * const service = CliQuietModeService.getInstance();
+ * service.setQuietFromArgv(argv);
+ *
+ * // 2. 在命令中使用
+ * if (service.isQuiet()) {
+ *   setQuietMode(true);
+ * }
+ *
+ * // 3. 重置状态（新命令开始时）
+ * service.reset();
+ * ```
+ */
+export declare class CliQuietModeService {
+    private static instance;
+    private constructor();
+    /**
+     * 获取单例实例
+     */
+    static getInstance(): CliQuietModeService;
+    /**
+     * 设置 quiet 模式
+     *
+     * 内部调用 core 的 setQuietMode，同步到 LogTraceComponent
+     */
+    setQuiet(value: boolean): void;
+    /**
+     * 从命令行参数设置 quiet 模式
+     *
+     * @param argv - yargs 解析后的参数对象
+     *
+     * 注意：只在 quiet 为 true 时设置，避免覆盖配置文件中的设置
+     */
+    setQuietFromArgv(argv: Record<string, unknown>): void;
+    /**
+     * 获取当前 quiet 模式状态
+     */
+    isQuiet(): boolean;
+    /**
+     * 重置 quiet 模式为 false
+     *
+     * 用于新命令开始时清理状态
+     */
+    reset(): void;
+}
+//# sourceMappingURL=quiet-mode.service.d.ts.map

package/dist/cli/src/services/quiet-mode.service.js

@@ -0,0 +1,74 @@
+/**
+ * @fileoverview CLI Quiet Mode Service
+ *
+ * 统一管理 CLI 的 quiet 模式状态
+ *
+ * 设计目标：
+ * 1. 单例模式 - 全局共享状态
+ * 2. 与 LogTraceComponent 集成 - 通过 ConfigComponent 配置
+ * 3. 支持命令行参数和配置文件双重控制
+ *
+ * 使用方式：
+ * ```typescript
+ * // 1. 从命令行参数设置
+ * const service = CliQuietModeService.getInstance();
+ * service.setQuietFromArgv(argv);
+ *
+ * // 2. 在命令中使用
+ * if (service.isQuiet()) {
+ *   setQuietMode(true);
+ * }
+ *
+ * // 3. 重置状态（新命令开始时）
+ * service.reset();
+ * ```
+ */
+import { setQuietMode as setCoreQuietMode, isQuietMode as isCoreQuietMode } from "@ai-setting/roy-agent-core";
+export class CliQuietModeService {
+    static instance;
+    constructor() { }
+    /**
+     * 获取单例实例
+     */
+    static getInstance() {
+        if (!CliQuietModeService.instance) {
+            CliQuietModeService.instance = new CliQuietModeService();
+        }
+        return CliQuietModeService.instance;
+    }
+    /**
+     * 设置 quiet 模式
+     *
+     * 内部调用 core 的 setQuietMode，同步到 LogTraceComponent
+     */
+    setQuiet(value) {
+        setCoreQuietMode(value);
+    }
+    /**
+     * 从命令行参数设置 quiet 模式
+     *
+     * @param argv - yargs 解析后的参数对象
+     *
+     * 注意：只在 quiet 为 true 时设置，避免覆盖配置文件中的设置
+     */
+    setQuietFromArgv(argv) {
+        if (argv.quiet === true) {
+            this.setQuiet(true);
+        }
+    }
+    /**
+     * 获取当前 quiet 模式状态
+     */
+    isQuiet() {
+        return isCoreQuietMode();
+    }
+    /**
+     * 重置 quiet 模式为 false
+     *
+     * 用于新命令开始时清理状态
+     */
+    reset() {
+        setCoreQuietMode(false);
+    }
+}
+//# sourceMappingURL=quiet-mode.service.js.map

package/dist/cli/src/services/stream-output.service.d.ts

@@ -0,0 +1,116 @@
+/**
+ * @fileoverview Stream Output Service
+ *
+ * 处理 LLM 流式事件并输出到控制台
+ */
+import type { EnvEvent } from "@ai-setting/roy-agent-core";
+export declare const COLORS: {
+    readonly userInput: import("chalk").ChalkInstance;
+    readonly userInputPrefix: string;
+    readonly assistant: import("chalk").ChalkInstance;
+    readonly system: import("chalk").ChalkInstance;
+    readonly reasoning: import("chalk").ChalkInstance;
+    readonly toolCall: import("chalk").ChalkInstance;
+    readonly toolResult: import("chalk").ChalkInstance;
+    readonly error: import("chalk").ChalkInstance;
+    readonly progress: import("chalk").ChalkInstance;
+};
+export type AbortSignal = {
+    aborted: boolean;
+};
+/**
+ * 全局 abort 信号（用于流式输出中断）
+ */
+export declare const streamAbortSignal: AbortSignal;
+/**
+ * 重置 abort 信号
+ */
+export declare function resetStreamAbort(): void;
+/**
+ * 请求 abort 流式输出
+ */
+export declare function abortStream(): void;
+/**
+ * Usage 信息接口
+ */
+export interface UsageInfo {
+    /** 模型名称 */
+    model: string;
+    /** Provider ID */
+    providerId?: string;
+    /** Prompt tokens */
+    promptTokens?: number;
+    /** Completion tokens */
+    completionTokens?: number;
+    /** Total tokens */
+    totalTokens?: number;
+}
+export interface StreamOutputOptions {
+    /** 显示推理/思考过程 */
+    showReasoning?: boolean;
+    /** 显示工具调用 */
+    showToolCalls?: boolean;
+    /** 显示工具结果 */
+    showToolResults?: boolean;
+}
+/**
+ * 流式输出服务
+ *
+ * 订阅 Environment 的 LLM 事件，流式输出文本到 stdout
+ */
+export declare class StreamOutputService {
+    private fullText;
+    private options;
+    private usageInfo?;
+    private contextWindow?;
+    private contextThreshold?;
+    private isFirstText;
+    private reasoningStarted;
+    private thinkingPrinted;
+    constructor(options?: StreamOutputOptions);
+    /**
+     * 设置上下文窗口信息
+     */
+    setContextInfo(window: number, threshold: number): void;
+    /**
+     * 检查是否已 abort
+     */
+    private checkAbort;
+    /**
+     * 处理环境事件
+     */
+    handleEvent(event: EnvEvent): void;
+    /**
+     * 处理开始事件
+     */
+    private handleStart;
+    /**
+     * 处理文本事件
+     */
+    private handleText;
+    /**
+     * 处理思考过程事件
+     */
+    private handleReasoning;
+    /**
+     * 处理工具调用事件
+     */
+    private handleToolCall;
+    /**
+     * 处理完成事件
+     */
+    private handleCompleted;
+    /**
+     * 获取完整文本
+     */
+    getFullText(): string;
+    /**
+     * 获取 usage 信息
+     */
+    getUsageInfo(): UsageInfo | undefined;
+    /**
+     * 重置状态
+     */
+    reset(): void;
+}
+//# sourceMappingURL=stream-output.service.d.ts.map

package/dist/cli/src/services/stream-output.service.js

@@ -0,0 +1,242 @@
+/**
+ * @fileoverview Stream Output Service
+ *
+ * 处理 LLM 流式事件并输出到控制台
+ */
+import chalk from "chalk";
+import { createLogger } from "@ai-setting/roy-agent-core";
+// 创建 logger
+const logger = createLogger("stream-output");
+// ============ ANSI 颜色定义 ============
+export const COLORS = {
+    // 用户输入颜色 (cyan)
+    userInput: chalk.cyan,
+    userInputPrefix: chalk.cyan("❯"),
+    // Assistant 输出颜色 (green)
+    assistant: chalk.green,
+    // 系统消息颜色 (yellow)
+    system: chalk.yellow,
+    // 思考过程颜色 (dim gray)
+    reasoning: chalk.dim.gray,
+    // 工具调用颜色 (magenta)
+    toolCall: chalk.magenta,
+    // 工具结果颜色 (blue)
+    toolResult: chalk.blue,
+    // 错误颜色 (red)
+    error: chalk.red,
+    // 进度/思考中颜色 (dim)
+    progress: chalk.dim,
+};
+/**
+ * 全局 abort 信号（用于流式输出中断）
+ */
+export const streamAbortSignal = {
+    aborted: false,
+};
+/**
+ * 重置 abort 信号
+ */
+export function resetStreamAbort() {
+    streamAbortSignal.aborted = false;
+}
+/**
+ * 请求 abort 流式输出
+ */
+export function abortStream() {
+    streamAbortSignal.aborted = true;
+}
+/**
+ * 流式输出服务
+ *
+ * 订阅 Environment 的 LLM 事件，流式输出文本到 stdout
+ */
+export class StreamOutputService {
+    fullText = "";
+    options;
+    usageInfo;
+    contextWindow;
+    contextThreshold;
+    isFirstText = true; // 用于控制换行
+    reasoningStarted = false; // 思考过程是否已开始
+    thinkingPrinted = false; // "[thinking...]" 是否已打印
+    constructor(options = {}) {
+        this.options = options;
+    }
+    /**
+     * 设置上下文窗口信息
+     */
+    setContextInfo(window, threshold) {
+        this.contextWindow = window;
+        this.contextThreshold = threshold;
+    }
+    /**
+     * 检查是否已 abort
+     */
+    checkAbort() {
+        if (streamAbortSignal.aborted) {
+            // 输出 abort 提示
+            console.log(`\n${COLORS.system("[已中断]")}\n`);
+            return true;
+        }
+        return false;
+    }
+    /**
+     * 处理环境事件
+     */
+    handleEvent(event) {
+        // 检查 abort 信号
+        if (this.checkAbort()) {
+            return;
+        }
+        const { type, payload } = event;
+        switch (type) {
+            case "llm.start":
+                this.handleStart(payload);
+                break;
+            case "llm.text":
+                this.handleText(payload);
+                break;
+            case "llm.reasoning":
+                this.handleReasoning(payload);
+                break;
+            case "llm.tool_call":
+                this.handleToolCall(payload);
+                break;
+            case "llm.completed":
+                this.handleCompleted(payload);
+                break;
+        }
+    }
+    /**
+     * 处理开始事件
+     */
+    handleStart(payload) {
+        if (payload.metadata?.model) {
+            // 可选：显示模型信息
+            // process.stderr.write(`\n[Using model: ${payload.metadata.model}]\n`);
+        }
+    }
+    /**
+     * 处理文本事件
+     */
+    handleText(payload) {
+        // 清除 "[thinking...]" 如果已打印
+        if (!this.thinkingPrinted) {
+            this.thinkingPrinted = true;
+            // 移动光标到行首，清除 "[thinking...]" 并换行
+            process.stdout.write("\r" + " ".repeat(20) + "\r");
+        }
+        const text = payload.delta ?? payload.content ?? "";
+        if (!text)
+            return;
+        // 如果是第一个文本块，先换行
+        if (this.isFirstText) {
+            process.stdout.write("\n");
+            this.isFirstText = false;
+        }
+        // 使用 assistant 颜色输出
+        process.stdout.write(COLORS.assistant(text));
+        this.fullText += text;
+    }
+    /**
+     * 处理思考过程事件
+     */
+    handleReasoning(payload) {
+        if (!this.options.showReasoning)
+            return;
+        const content = payload.content ?? "";
+        if (!content)
+            return;
+        // 如果是开始思考，先换行并显示标题
+        if (!this.reasoningStarted) {
+            this.reasoningStarted = true;
+            process.stdout.write("\n\n" + COLORS.reasoning("┌─ 思考过程 ─") + "\n");
+        }
+        process.stdout.write(COLORS.reasoning(content));
+    }
+    /**
+     * 处理工具调用事件
+     */
+    handleToolCall(payload) {
+        if (!this.options.showToolCalls)
+            return;
+        const toolCall = payload.toolCall;
+        if (toolCall?.name) {
+            process.stdout.write("\n" + COLORS.toolCall(`🔧 [Tool] ${toolCall.name}`) + "\n");
+        }
+    }
+    /**
+     * 处理完成事件
+     */
+    handleCompleted(payload) {
+        // 完成时输出换行
+        process.stdout.write("\n");
+        // 如果有思考过程，关闭思考框
+        if (this.reasoningStarted) {
+            process.stdout.write(COLORS.reasoning("└" + "─".repeat(20) + "\n"));
+            this.reasoningStarted = false;
+        }
+        // 提取 usage 信息
+        const metadata = payload.metadata;
+        if (metadata?.model || metadata?.usage) {
+            let modelName = metadata.model || "";
+            let providerId;
+            // 解析 model 名称（格式：provider/model 或 model）
+            if (modelName.includes("/")) {
+                const parts = modelName.split("/");
+                providerId = parts[0];
+                modelName = parts[parts.length - 1];
+            }
+            this.usageInfo = {
+                model: modelName,
+                providerId,
+                promptTokens: metadata.usage?.promptTokens,
+                completionTokens: metadata.usage?.completionTokens,
+                totalTokens: metadata.usage?.totalTokens,
+            };
+            // 打印 usage 日志
+            const logData = {
+                promptTokens: this.usageInfo.promptTokens,
+                completionTokens: this.usageInfo.completionTokens,
+                totalTokens: this.usageInfo.totalTokens,
+            };
+            // 添加 context 信息（如果已设置）
+            if (this.contextWindow !== undefined) {
+                logData.contextWindow = this.contextWindow;
+                if (this.contextThreshold !== undefined) {
+                    logData.contextThreshold = this.contextThreshold;
+                    // 计算使用率
+                    if (this.usageInfo.totalTokens && this.contextWindow) {
+                        const usageRate = (this.usageInfo.totalTokens / this.contextWindow * 100).toFixed(1);
+                        logData.usageRate = `${usageRate}%`;
+                    }
+                }
+            }
+            logger.info(`[LLM] ${modelName}`, logData);
+        }
+    }
+    /**
+     * 获取完整文本
+     */
+    getFullText() {
+        return this.fullText;
+    }
+    /**
+     * 获取 usage 信息
+     */
+    getUsageInfo() {
+        return this.usageInfo;
+    }
+    /**
+     * 重置状态
+     */
+    reset() {
+        this.fullText = "";
+        this.usageInfo = undefined;
+        this.isFirstText = true;
+        this.reasoningStarted = false;
+        this.thinkingPrinted = false;
+        // 保留 contextInfo，因为它是配置信息，不需要每次重置
+    }
+}
+//# sourceMappingURL=stream-output.service.js.map

package/dist/cli/src/util/which.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @fileoverview which 命令实现
+ *
+ * 在 PATH 中查找可执行文件
+ */
+/**
+ * 在 PATH 中查找可执行文件
+ *
+ * @param command 命令名称
+ * @returns 命令的完整路径，如果找不到返回 null
+ */
+export declare function which(command: string): string | null;
+//# sourceMappingURL=which.d.ts.map

package/dist/cli/src/util/which.js

@@ -0,0 +1,50 @@
+/**
+ * @fileoverview which 命令实现
+ *
+ * 在 PATH 中查找可执行文件
+ */
+import { execSync } from "child_process";
+import path from "path";
+import fs from "fs";
+/**
+ * 在 PATH 中查找可执行文件
+ *
+ * @param command 命令名称
+ * @returns 命令的完整路径，如果找不到返回 null
+ */
+export function which(command) {
+    // 如果是绝对路径，直接检查是否存在
+    if (path.isAbsolute(command)) {
+        return fs.existsSync(command) ? command : null;
+    }
+    // 获取 PATH 环境变量
+    const PATH = process.env.PATH ?? "";
+    const pathSeparator = process.platform === "win32" ? ";" : ":";
+    const paths = PATH.split(pathSeparator);
+    // Windows 下还要检查 PATHEXT
+    const extensions = process.platform === "win32"
+        ? (process.env.PATHEXT ?? ".COM;.EXE;.BAT;.CMD").split(";")
+        : [""];
+    for (const dir of paths) {
+        for (const ext of extensions) {
+            const fullPath = path.join(dir, command + ext);
+            if (fs.existsSync(fullPath)) {
+                return fullPath;
+            }
+        }
+    }
+    // 尝试使用系统 which 命令（仅在非 Windows 平台）
+    // Windows 没有原生的 which 命令，需要使用 PowerShell 的 Get-Command 或手动遍历
+    if (process.platform !== "win32") {
+        try {
+            const result = execSync(`which ${command}`, { encoding: "utf-8" });
+            const trimmed = result.trim();
+            return trimmed || null;
+        }
+        catch {
+            // fall through to return null
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=which.js.map

package/dist/coder-harness/src/index.d.ts

@@ -0,0 +1,32 @@
+/**
+ * @roy-agent/coder - Coder Harness
+ *
+ * Programming-focused Environment for roy-agent.
+ *
+ * Core Philosophy:
+ * - Core (@ai-setting/roy-agent-core) is scenario-agnostic
+ * - Coder Harness (@roy-agent/coder) extends core with programming-specific capabilities
+ *
+ * Instead of re-implementing tools, Coder Harness uses the Plugin mechanism
+ * to add programming features via Hooks.
+ */
+export { BaseEnvironment } from "@ai-setting/roy-agent-core";
+export type { Environment } from "@ai-setting/roy-agent-core";
+export type { Component } from "@ai-setting/roy-agent-core";
+export { LSPClient, createLSPClient } from "./lsp/client";
+export { LSPServer, LSPServerRegistry } from "./lsp/server";
+export { LSPManager, createGlobalLSPManager, globalLSPManager } from "./lsp/manager";
+export type { HealthCheckResult, ConnectionStats } from "./lsp/manager";
+export { getServerId, getLanguageId, isSupported, getExtensionsByServer, LANGUAGE_EXTENSIONS, SERVER_BY_EXTENSION, } from "./lsp/language-map";
+export { LSPPlugin, createLSPPlugin } from "./plugins/lsp-plugin";
+export type { LSPQueryResult, LSPPluginConfig } from "./plugins/lsp-plugin";
+export { PluginHookAdapter, createPluginHookAdapter, } from "./plugins/plugin-hook-adapter";
+export type { AfterToolHookData, BuiltInPluginsConfig, } from "./plugins/plugin-hook-adapter";
+export { ReminderPlugin, createReminderPlugin, } from "./plugins/reminder-plugin";
+export type { ReminderPluginConfig, } from "./plugins/reminder-plugin";
+export type { Diagnostic, Range, Position, LintResult, LinterPluginConfig, LSPServerInfo, LSPManagerConfig, } from "./types/linter";
+export { DiagnosticSeverity } from "./types/linter";
+export type { TypeCheckPluginConfig, TypeCheckManagerConfig, TypeCheckIssue, TypeCheckResult, TypeCheckEngine, } from "./types/linter";
+export { LSPDependencyInstaller, LSP_PACKAGES, createInstaller, LSPConfig, LSPConfigLoader, getDefaultLSPConfig, createLSPConfigLoader, } from "./lsp-deps/index";
+export type { LSPPackage, InstallOptions, InstallTarget, LSPConfigOptions, } from "./lsp-deps/index";
+//# sourceMappingURL=index.d.ts.map