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

package/dist/cli/src/commands/plugin.d.ts

@@ -0,0 +1,112 @@
+/**
+ * Plugin Module
+ *
+ * Provides plugin registry and hook integration for coder enhancements.
+ */
+import type { Tool, ToolResult } from "@ai-setting/roy-agent-core";
+/**
+ * Tool hook context - passed to plugin hooks
+ */
+export interface ToolHookContext {
+    tool?: Tool;
+    args?: Record<string, unknown>;
+    result?: ToolResult;
+}
+/**
+ * Tool hook points
+ */
+export declare const ToolHookPoints: {
+    readonly AFTER_EXECUTE: "tool.after-execute";
+    readonly BEFORE_EXECUTE: "tool.before-execute";
+};
+/**
+ * Base plugin interface
+ */
+export interface BasePlugin {
+    name: string;
+    description?: string;
+    version?: string;
+}
+/**
+ * Tool plugin interface - hooks into tool execution
+ */
+export interface ToolPlugin extends BasePlugin {
+    getHookPoint(): (typeof ToolHookPoints)[keyof typeof ToolHookPoints];
+    shouldHandle?(context: ToolHookContext): boolean;
+    onAfterExecute?(context: ToolHookContext): void | Promise<void>;
+    onBeforeExecute?(context: ToolHookContext): void | Promise<void>;
+}
+/**
+ * Plugin config from CLI
+ */
+export interface PluginConfig {
+    name: string;
+    config?: string;
+}
+/**
+ * Parsed plugin arguments
+ */
+export interface PluginArgs {
+    plugins: (string | PluginConfig)[];
+    fileTypes: string[];
+}
+/**
+ * Built-in plugin registry
+ */
+export declare const BUILTIN_PLUGINS: {
+    readonly lsp: "LSP code intelligence (diagnostics, completions)";
+    readonly "code-check": "External command code checking (linter + type check)";
+    readonly reminder: "Max iterations reminder for ReAct loop";
+};
+/**
+ * Plugin registry for managing registered plugins
+ */
+export declare class PluginRegistry {
+    private plugins;
+    /**
+     * Register a plugin
+     */
+    register(plugin: ToolPlugin): void;
+    /**
+     * Unregister a plugin
+     */
+    unregister(name: string): boolean;
+    /**
+     * Get a plugin by name
+     */
+    get(name: string): ToolPlugin | undefined;
+    /**
+     * Get all registered plugins
+     */
+    getAll(): ToolPlugin[];
+    /**
+     * Get plugins for a specific hook point
+     */
+    getByHookPoint(hookPoint: string): ToolPlugin[];
+    /**
+     * Check if plugin is registered
+     */
+    has(name: string): boolean;
+    /**
+     * Clear all plugins
+     */
+    clear(): void;
+}
+/**
+ * Parse plugin CLI arguments
+ *
+ * Formats:
+ * - plugin-name (e.g., "lsp", "linter")
+ * - plugin-name:config (e.g., "lsp:typescript", "linter:/path/to/eslintrc.json")
+ * - /path/to/plugin.js (custom plugin)
+ */
+export declare function parseArgs(args: string[]): PluginArgs;
+/**
+ * Execute a plugin hook
+ */
+export declare function executePlugin(plugin: ToolPlugin, context: ToolHookContext): Promise<void>;
+/**
+ * Get the help message for plugin command
+ */
+export declare function getPluginHelp(): string;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/cli/src/commands/plugin.js

@@ -0,0 +1,186 @@
+/**
+ * Plugin Module
+ *
+ * Provides plugin registry and hook integration for coder enhancements.
+ */
+/**
+ * Tool hook points
+ */
+export const ToolHookPoints = {
+    AFTER_EXECUTE: "tool.after-execute",
+    BEFORE_EXECUTE: "tool.before-execute",
+};
+// ============================================================================
+// Built-in Plugins
+// ============================================================================
+/**
+ * Built-in plugin registry
+ */
+export const BUILTIN_PLUGINS = {
+    lsp: "LSP code intelligence (diagnostics, completions)",
+    "code-check": "External command code checking (linter + type check)",
+    reminder: "Max iterations reminder for ReAct loop",
+};
+/**
+ * File type mappings for built-in plugins
+ */
+const FILE_TYPE_MAP = {
+    typescript: [".ts", ".tsx"],
+    javascript: [".js", ".jsx", ".mjs"],
+    python: [".py"],
+    rust: [".rs"],
+    go: [".go"],
+    java: [".java"],
+    csharp: [".cs"],
+};
+// ============================================================================
+// Plugin Manager
+// ============================================================================
+/**
+ * Plugin registry for managing registered plugins
+ */
+export class PluginRegistry {
+    plugins = new Map();
+    /**
+     * Register a plugin
+     */
+    register(plugin) {
+        if (this.plugins.has(plugin.name)) {
+            throw new Error(`Plugin '${plugin.name}' already registered`);
+        }
+        this.plugins.set(plugin.name, plugin);
+    }
+    /**
+     * Unregister a plugin
+     */
+    unregister(name) {
+        return this.plugins.delete(name);
+    }
+    /**
+     * Get a plugin by name
+     */
+    get(name) {
+        return this.plugins.get(name);
+    }
+    /**
+     * Get all registered plugins
+     */
+    getAll() {
+        return Array.from(this.plugins.values());
+    }
+    /**
+     * Get plugins for a specific hook point
+     */
+    getByHookPoint(hookPoint) {
+        return this.getAll().filter((p) => p.getHookPoint() === hookPoint);
+    }
+    /**
+     * Check if plugin is registered
+     */
+    has(name) {
+        return this.plugins.has(name);
+    }
+    /**
+     * Clear all plugins
+     */
+    clear() {
+        this.plugins.clear();
+    }
+}
+// ============================================================================
+// CLI Argument Parsing
+// ============================================================================
+/**
+ * Parse plugin CLI arguments
+ *
+ * Formats:
+ * - plugin-name (e.g., "lsp", "linter")
+ * - plugin-name:config (e.g., "lsp:typescript", "linter:/path/to/eslintrc.json")
+ * - /path/to/plugin.js (custom plugin)
+ */
+export function parseArgs(args) {
+    const plugins = [];
+    const fileTypes = new Set();
+    for (const arg of args) {
+        if (arg.startsWith("/") || arg.startsWith(".")) {
+            // It's a file path
+            plugins.push(arg);
+            // Extract file type from path
+            const ext = arg.match(/\.[^.]+$/)?.[0];
+            if (ext) {
+                fileTypes.add(ext);
+            }
+        }
+        else if (arg.includes(":")) {
+            // It's a plugin with config
+            const [name, config] = arg.split(":", 2);
+            plugins.push({ name, config: config || "" });
+            // Extract file types from config
+            if (FILE_TYPE_MAP[config]) {
+                FILE_TYPE_MAP[config].forEach((t) => fileTypes.add(t));
+            }
+            else {
+                // Try to extract extension from config
+                const ext = config.match(/\.[^.]+$/)?.[0];
+                if (ext) {
+                    fileTypes.add(ext);
+                }
+            }
+        }
+        else {
+            // It's just a plugin name
+            plugins.push(arg);
+        }
+    }
+    return {
+        plugins,
+        fileTypes: Array.from(fileTypes),
+    };
+}
+// ============================================================================
+// Plugin Execution
+// ============================================================================
+/**
+ * Execute a plugin hook
+ */
+export async function executePlugin(plugin, context) {
+    // Check if plugin should handle this context
+    if (plugin.shouldHandle && !plugin.shouldHandle(context)) {
+        return;
+    }
+    // Execute the appropriate hook
+    const hookPoint = plugin.getHookPoint();
+    if (hookPoint === ToolHookPoints.AFTER_EXECUTE && plugin.onAfterExecute) {
+        await plugin.onAfterExecute(context);
+    }
+    else if (hookPoint === ToolHookPoints.BEFORE_EXECUTE &&
+        plugin.onBeforeExecute) {
+        await plugin.onBeforeExecute(context);
+    }
+}
+// ============================================================================
+// Help
+// ============================================================================
+/**
+ * Get the help message for plugin command
+ */
+export function getPluginHelp() {
+    const lines = [
+        "",
+        "  --plugin <plugins>   Enable coder plugin",
+        "",
+        "  Built-in plugins:",
+    ];
+    for (const [name, desc] of Object.entries(BUILTIN_PLUGINS)) {
+        lines.push(`    ${name.padEnd(12)} ${desc}`);
+    }
+    lines.push("", "  Plugin formats:", "    --plugin lsp                    # Enable LSP");
+    lines.push("    --plugin lsp:typescript          # LSP for TypeScript");
+    lines.push("    --plugin lsp:python              # LSP for Python");
+    lines.push("    --plugin code-check             # Enable external command checking");
+    lines.push("    --plugin reminder               # Enable iteration reminder");
+    lines.push("    --plugin /path/to/plugin.js          # Custom plugin");
+    lines.push("    --plugin lsp code-check reminder    # Multiple plugins");
+    return lines.join("\n");
+}
+//# sourceMappingURL=plugin.js.map

package/dist/cli/src/commands/sessions/active.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @fileoverview Sessions Active Command
+ *
+ * 命令：roy sessions active [options]
+ */
+import { CommandModule } from "yargs";
+interface ActiveOptions {
+    clear?: boolean;
+    json?: boolean;
+    config?: string;
+}
+export declare const ActiveCommand: CommandModule<object, ActiveOptions>;
+export {};
+//# sourceMappingURL=active.d.ts.map

package/dist/cli/src/commands/sessions/active.js

@@ -0,0 +1,79 @@
+/**
+ * @fileoverview Sessions Active Command
+ *
+ * 命令：roy sessions active [options]
+ */
+import { EnvironmentService } from "../../services/environment.service.js";
+import { OutputService } from "../../services/output.service.js";
+import chalk from "chalk";
+export const ActiveCommand = {
+    command: "active",
+    aliases: ["current"],
+    describe: "查看/设置当前活跃会话",
+    builder: (yargs) => yargs
+        .option("clear", { type: "boolean", default: false })
+        .option("json", { alias: "j", type: "boolean", default: false }),
+    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 create environment");
+                process.exit(1);
+            }
+            const sessionComponent = env.getComponent("session");
+            if (!sessionComponent) {
+                output.error("SessionComponent not available");
+                process.exit(1);
+            }
+            const activeId = sessionComponent.getActiveSessionId();
+            if (args.clear) {
+                // 清除活跃会话
+                // 注意：需要通过内部机制清除，暂时不支持
+                output.log("Active session cleared");
+                return;
+            }
+            if (!activeId) {
+                output.log(chalk.gray("No active session set"));
+                return;
+            }
+            const session = await sessionComponent.get(activeId);
+            if (args.json) {
+                output.json({
+                    activeSessionId: activeId,
+                    session: session ? {
+                        id: session.id,
+                        title: session.title,
+                        directory: session.directory,
+                        messageCount: session.messageCount,
+                        createdAt: new Date(session.createdAt).toISOString(),
+                        updatedAt: new Date(session.updatedAt).toISOString(),
+                    } : null,
+                });
+            }
+            else {
+                if (!session) {
+                    output.log(chalk.gray("Active session not found: " + activeId));
+                    return;
+                }
+                output.log(chalk.bold.green("┌─ Active Session ─────────────────────────────────┐"));
+                output.log(`│ ID:          ${session.id}`);
+                output.log(`│ Title:       ${session.title}`);
+                output.log(`│ Directory:   ${session.directory}`);
+                output.log(`│ Messages:    ${session.messageCount}`);
+                output.log(`│ Updated:     ${new Date(session.updatedAt).toLocaleString("zh-CN")}`);
+                output.log("└" + "─".repeat(51) + "┘");
+            }
+        }
+        catch (error) {
+            output.error(`Failed to get active session: ${error instanceof Error ? error.message : String(error)}`);
+            process.exit(1);
+        }
+        finally {
+            await envService.dispose();
+        }
+    },
+};
+//# sourceMappingURL=active.js.map

package/dist/cli/src/commands/sessions/add-message.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @fileoverview Sessions Add Message Command
+ *
+ * 命令：roy sessions add-message <session-id> <role> <content>
+ */
+import { CommandModule } from "yargs";
+export declare const AddMessageCommand: CommandModule<object, object>;
+//# sourceMappingURL=add-message.d.ts.map

package/dist/cli/src/commands/sessions/add-message.js

@@ -0,0 +1,78 @@
+/**
+ * @fileoverview Sessions Add Message Command
+ *
+ * 命令：roy sessions add-message <session-id> <role> <content>
+ */
+import { EnvironmentService } from "../../services/environment.service.js";
+import { OutputService } from "../../services/output.service.js";
+export const AddMessageCommand = {
+    command: "add-message <session-id> <role> <content>",
+    aliases: ["add"],
+    describe: "添加消息到会话 [test]",
+    builder: (yargs) => yargs
+        .positional("session-id", {
+        describe: "会话 ID",
+        type: "string",
+        demandOption: true,
+    })
+        .positional("role", {
+        describe: "消息角色",
+        type: "string",
+        choices: ["user", "assistant", "system", "tool"],
+        demandOption: true,
+    })
+        .positional("content", {
+        describe: "消息内容",
+        type: "string",
+        demandOption: true,
+    })
+        .option("json", { alias: "j", type: "boolean", default: false }),
+    async handler(args) {
+        const a = args;
+        const output = new OutputService();
+        const envService = new EnvironmentService(output);
+        try {
+            await envService.create({ configPath: a.config });
+            const env = envService.getEnvironment();
+            if (!env) {
+                output.error("Failed to create environment");
+                process.exit(1);
+            }
+            const sessionComponent = env.getComponent("session");
+            if (!sessionComponent) {
+                output.error("SessionComponent not available");
+                process.exit(1);
+            }
+            // 检查会话是否存在
+            const session = await sessionComponent.get(a.sessionId);
+            if (!session) {
+                output.error(`Session not found: ${a.sessionId}`);
+                process.exit(1);
+            }
+            // 添加消息
+            const messageId = await sessionComponent.addMessage(a.sessionId, {
+                role: a.role,
+                content: a.content,
+            });
+            if (a.json) {
+                output.json({
+                    success: true,
+                    messageId,
+                    sessionId: a.sessionId,
+                    role: a.role,
+                    contentLength: a.content.length,
+                });
+            }
+            else {
+                output.success(`Message added to session ${a.sessionId}`);
+                output.log(`Message ID: ${messageId}`);
+                output.log(`Role: ${a.role}`);
+                output.log(`Content: ${a.content.substring(0, 100)}${a.content.length > 100 ? "..." : ""}`);
+            }
+        }
+        finally {
+            await envService.dispose();
+        }
+    },
+};
+//# sourceMappingURL=add-message.js.map

package/dist/cli/src/commands/sessions/checkpoints.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @fileoverview Sessions Checkpoints Command
+ *
+ * 命令：roy sessions checkpoints <session-id>
+ */
+import { CommandModule } from "yargs";
+export declare const CheckpointsCommand: CommandModule<object, object>;
+//# sourceMappingURL=checkpoints.d.ts.map

package/dist/cli/src/commands/sessions/checkpoints.js

@@ -0,0 +1,133 @@
+/**
+ * @fileoverview Sessions Checkpoints Command
+ *
+ * 命令：roy sessions checkpoints <session-id>
+ */
+import { EnvironmentService } from "../../services/environment.service.js";
+import { OutputService } from "../../services/output.service.js";
+import chalk from "chalk";
+export const CheckpointsCommand = {
+    command: "checkpoints <session-id>",
+    aliases: ["cps"],
+    describe: "查看会话检查点列表 [new]",
+    builder: (yargs) => yargs
+        .positional("session-id", {
+        describe: "会话 ID",
+        type: "string",
+        demandOption: true,
+    })
+        .option("detail", { alias: "d", type: "boolean", default: false })
+        .option("json", { alias: "j", type: "boolean", default: false }),
+    async handler(args) {
+        const a = args;
+        const output = new OutputService();
+        const envService = new EnvironmentService(output);
+        try {
+            await envService.create({ configPath: a.config });
+            const env = envService.getEnvironment();
+            if (!env) {
+                output.error("Failed to create environment");
+                process.exit(1);
+            }
+            const sessionComponent = env.getComponent("session");
+            if (!sessionComponent) {
+                output.error("SessionComponent not available");
+                process.exit(1);
+            }
+            const session = await sessionComponent.get(a.sessionId);
+            if (!session) {
+                output.error(`Session not found: ${a.sessionId}`);
+                process.exit(1);
+            }
+            const checkpoints = await sessionComponent.getCheckpoints(a.sessionId);
+            if (checkpoints.length === 0) {
+                output.log(chalk.gray("No checkpoints for this session"));
+                return;
+            }
+            if (a.json) {
+                output.json({
+                    sessionId: a.sessionId,
+                    checkpoints: checkpoints.map((cp) => ({
+                        id: cp.id,
+                        title: cp.title,
+                        type: cp.type,
+                        messageIndex: cp.messageIndex,
+                        processKeyPoints: cp.processKeyPoints,
+                        currentState: cp.currentState,
+                        nextSteps: cp.nextSteps,
+                        userIntents: cp.userIntents, // Include user intents
+                        messageCountBefore: cp.messageCountBefore,
+                        createdAt: new Date(cp.createdAt).toISOString(),
+                    })),
+                    total: checkpoints.length,
+                });
+                return;
+            }
+            if (a.detail) {
+                // 详细模式
+                checkpoints.reverse().forEach((cp, i) => {
+                    const isLatest = i === 0;
+                    output.log(chalk.bold(`┌─ Checkpoint: ${cp.title} ${isLatest ? chalk.green("✓") : ""} ──────` + "─".repeat(Math.max(0, 30 - cp.title.length)) + "┐"));
+                    output.log(`│ ID:            ${cp.id}`);
+                    output.log(`│ Type:          ${cp.type}`);
+                    output.log(`│ Message Index: ${cp.messageIndex} (${cp.messageCountBefore} messages)`);
+                    output.log(`│ Created:       ${new Date(cp.createdAt).toLocaleString("zh-CN")}`);
+                    output.log("├─ Process Key Points ─────────────────────────────────┤");
+                    cp.processKeyPoints.forEach((p, j) => {
+                        output.log(`│ ${j + 1}. ${p}`);
+                    });
+                    output.log("├─ Current State ─────────────────────────────────────┤");
+                    output.log("│ " + cp.currentState);
+                    if (cp.nextSteps?.length) {
+                        output.log("├─ Next Steps ───────────────────────────────────────┤");
+                        cp.nextSteps.forEach((s, j) => {
+                            output.log(`│ ${j + 1}. ${s}`);
+                        });
+                    }
+                    if (cp.userIntents?.length) {
+                        output.log("├─ User Intents ─────────────────────────────────────┤");
+                        cp.userIntents.forEach((intent, j) => {
+                            output.log(`│ ${j + 1}. ${intent}`);
+                        });
+                    }
+                    output.log("└" + "─".repeat(51) + "┘");
+                    output.log("");
+                });
+            }
+            else {
+                // 简洁模式
+                const header = [
+                    chalk.bold("#"),
+                    chalk.bold("Title"),
+                    chalk.bold("Type"),
+                    chalk.bold("Messages"),
+                    chalk.bold("Created"),
+                ].join(" │ ");
+                output.log(`┌─ Checkpoints (${checkpoints.length}) ${"─".repeat(40)}┐`);
+                output.log(`│${header}│`);
+                output.log("├" + "─".repeat(header.length + 2) + "┤");
+                checkpoints.reverse().forEach((cp, i) => {
+                    const isLatest = i === 0;
+                    const marker = isLatest ? chalk.green("✓ ") : "  ";
+                    const title = cp.title.length > 25 ? cp.title.slice(0, 22) + "..." : cp.title;
+                    const created = new Date(cp.createdAt).toLocaleString("zh-CN", {
+                        month: "2-digit",
+                        day: "2-digit",
+                        hour: "2-digit",
+                        minute: "2-digit",
+                    });
+                    output.log(`│${marker}${i + 1}  ${title.padEnd(25)} │ ${cp.type.padEnd(5)} │ ${cp.messageCountBefore.toString().padStart(8)} │ ${chalk.gray(created)}│`);
+                });
+                output.log("└" + "─".repeat(header.length + 2) + "┘");
+            }
+        }
+        catch (error) {
+            output.error(`Failed to get checkpoints: ${error instanceof Error ? error.message : String(error)}`);
+            process.exit(1);
+        }
+        finally {
+            await envService.dispose();
+        }
+    },
+};
+//# sourceMappingURL=checkpoints.js.map

package/dist/cli/src/commands/sessions/compact.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @fileoverview Sessions Compact Command
+ *
+ * 命令：roy sessions compact <session-id>
+ *
+ * 压缩会话，生成 checkpoint
+ *
+ * 特性：
+ * 1. 如果未指定 --scenario 参数，自动调用 generateCompactHint 生成场景化提示
+ * 2. 输出生成的 hint prompt（用于告知用户生成了什么指导）
+ * 3. 输出最终的 checkpoint
+ * 4. 复用自动触发 compact 的两阶段逻辑
+ */
+import { CommandModule } from "yargs";
+export declare const CompactCommand: CommandModule<object, object>;
+//# sourceMappingURL=compact.d.ts.map