@ai-setting/roy-agent-cli 1.3.18 → 1.3.22

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

@@ -1,112 +0,0 @@
-/**
- * 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

@@ -1,186 +0,0 @@
-/**
- * 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

@@ -1,14 +0,0 @@
-/**
- * @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

@@ -1,79 +0,0 @@
-/**
- * @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

@@ -1,8 +0,0 @@
-/**
- * @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

@@ -1,78 +0,0 @@
-/**
- * @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

@@ -1,8 +0,0 @@
-/**
- * @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

@@ -1,133 +0,0 @@
-/**
- * @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

@@ -1,16 +0,0 @@
-/**
- * @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