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

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

@@ -0,0 +1,210 @@
+/**
+ * @fileoverview Sessions Grep Command
+ *
+ * 命令：roy sessions grep <query>
+ *
+ * 在所有会话消息中进行全文搜索，支持：
+ * - 多关键字搜索 (AND/OR/NOT)
+ * - 按会话过滤
+ * - 按时间范围过滤
+ * - 结果以 session 为单位聚合展示
+ * - --quiet 安静模式
+ */
+import { EnvironmentService } from "../../services/environment.service.js";
+import { OutputService } from "../../services/output.service.js";
+import chalk from "chalk";
+import { CliQuietModeService } from "../../services/quiet-mode.service.js";
+export const GrepCommand = {
+    command: "grep <query...>",
+    aliases: ["search"],
+    describe: "搜索会话消息（全文搜索）",
+    builder: (yargs) => yargs
+        .positional("query", {
+        describe: "搜索关键词（支持 AND/OR/NOT）",
+        type: "string",
+        demandOption: true,
+    })
+        .option("session", {
+        alias: "s",
+        type: "string",
+        description: "限制搜索特定会话 ID",
+    })
+        .option("limit", {
+        alias: "n",
+        type: "number",
+        default: 50,
+        description: "最大返回结果数",
+    })
+        .option("before", {
+        alias: "b",
+        type: "number",
+        description: "搜索此时间之前的消息（Unix timestamp 或天数）",
+    })
+        .option("after", {
+        alias: "a",
+        type: "number",
+        description: "搜索此时间之后的消息（Unix timestamp 或天数）",
+    })
+        .option("json", {
+        alias: "j",
+        type: "boolean",
+        default: false,
+        description: "JSON 格式输出",
+    })
+        .option("quiet", {
+        alias: "q",
+        type: "boolean",
+        default: false,
+        description: "简洁输出",
+    }),
+    async handler(args) {
+        // 强制类型转换以处理 yargs 的类型推断问题
+        const a = args;
+        // 在任何日志输出之前设置 quiet 模式
+        const isQuiet = a.quiet === true;
+        if (isQuiet) {
+            CliQuietModeService.getInstance().setQuiet(true);
+        }
+        const output = new OutputService();
+        output.configure({ quiet: isQuiet });
+        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 now = Date.now();
+            let beforeTime;
+            let afterTime;
+            if (a.before !== undefined) {
+                // 如果是小于 1e12，视为天数
+                beforeTime = a.before < 1e12
+                    ? now - a.before * 24 * 60 * 60 * 1000
+                    : a.before;
+            }
+            if (a.after !== undefined) {
+                afterTime = a.after < 1e12
+                    ? now - a.after * 24 * 60 * 60 * 1000
+                    : a.after;
+            }
+            // query 是 string[]，合并为字符串
+            const query = Array.isArray(a.query) ? a.query.join(" ") : a.query ?? "";
+            const searchOptions = {
+                query,
+                sessionId: a.session,
+                limit: a.limit,
+                beforeTime,
+                afterTime,
+            };
+            // 执行搜索
+            const results = await sessionComponent.searchMessages(searchOptions);
+            if (results.length === 0) {
+                if (!a.quiet) {
+                    output.log(chalk.yellow(`No results found for: ${query}`));
+                }
+                return;
+            }
+            if (a.json) {
+                // JSON 格式输出
+                output.json({
+                    query,
+                    totalMatches: results.reduce((sum, r) => sum + r.matches.length, 0),
+                    sessionCount: results.length,
+                    results: results.map((r) => ({
+                        sessionId: r.sessionId,
+                        sessionTitle: r.sessionTitle,
+                        messageCount: r.messageCount,
+                        matches: r.matches.map((m) => ({
+                            messageId: m.messageId,
+                            role: m.role,
+                            content: m.content,
+                            timestamp: new Date(m.timestamp).toISOString(),
+                            contextBefore: m.contextBefore,
+                            contextAfter: m.contextAfter,
+                        })),
+                    })),
+                });
+            }
+            else if (a.quiet) {
+                // 简洁输出：只显示匹配的消息
+                for (const result of results) {
+                    for (const match of result.matches) {
+                        const time = new Date(match.timestamp).toLocaleString("zh-CN");
+                        output.log(`${chalk.gray(result.sessionId)} ${chalk.blue(result.sessionTitle)} ${chalk.gray(time)}`);
+                        output.log(`  ${match.content}`);
+                        output.log("");
+                    }
+                }
+            }
+            else {
+                // 格式化输出：以 session 为单位聚合
+                let totalMatches = 0;
+                for (let ri = 0; ri < results.length; ri++) {
+                    const result = results[ri];
+                    totalMatches += result.matches.length;
+                    // Session 头部
+                    const time = new Date(result.updatedAt).toLocaleString("zh-CN");
+                    const titleStr = `─ ${result.sessionTitle} (${result.sessionId})`;
+                    output.log(chalk.bold(`\n┌${titleStr}${"─".repeat(Math.max(0, 50 - titleStr.length))}┐`));
+                    output.log(`│ ${chalk.gray(`Updated: ${time} | ${result.messageCount} messages | ${result.matches.length} matches`)}${" ".repeat(Math.max(0, 50 - 60))}│`);
+                    // 每条匹配的消息
+                    for (let i = 0; i < result.matches.length; i++) {
+                        const match = result.matches[i];
+                        const roleColor = match.role === "user" ? chalk.blue
+                            : match.role === "assistant" ? chalk.green
+                                : chalk.gray;
+                        const msgTime = new Date(match.timestamp).toLocaleTimeString("zh-CN", {
+                            hour: "2-digit",
+                            minute: "2-digit",
+                        });
+                        output.log(`├─ #${i + 1} ${roleColor(match.role.padEnd(10))} ${chalk.gray(msgTime)}`);
+                        output.log("│");
+                        // 消息内容（限制行数，过滤空行）
+                        const lines = match.content
+                            .split("\n")
+                            .map(line => line.trim()) // 去除每行首尾空白
+                            .filter(line => line.length > 0); // 过滤空行
+                        const maxLines = 5;
+                        const displayLines = lines.slice(0, maxLines);
+                        if (displayLines.length === 0) {
+                            output.log("│   " + chalk.gray("(empty content)"));
+                        }
+                        else {
+                            for (const line of displayLines) {
+                                const truncated = line.length > 76 ? line.slice(0, 73) + "..." : line;
+                                output.log(`│   ${chalk.gray(truncated)}`);
+                            }
+                        }
+                        if (lines.length > maxLines) {
+                            output.log("│   " + chalk.gray(`... (${lines.length - maxLines} more lines)`));
+                        }
+                        output.log("│");
+                    }
+                    // Session 底部
+                    output.log(`└${"─".repeat(52)}┘`);
+                }
+                // 统计信息
+                output.log(`\n${chalk.green("✓")} Found ${chalk.bold(totalMatches.toString())} matches in ${chalk.bold(results.length.toString())} sessions`);
+                output.log(chalk.gray(`Query: "${query}"`));
+            }
+        }
+        catch (error) {
+            output.error(`Search failed: ${error instanceof Error ? error.message : String(error)}`);
+            process.exit(1);
+        }
+        finally {
+            await envService.dispose();
+        }
+    },
+};
+//# sourceMappingURL=grep.js.map

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

@@ -0,0 +1,42 @@
+/**
+ * @fileoverview Sessions Command Entry
+ *
+ * 命令入口：roy sessions [action]
+ *
+ * 注意：--quiet / -q 选项现在由 cli.ts 的全局 middleware 统一处理
+ */
+import { CommandModule } from "yargs";
+/**
+ * Sessions Command
+ *
+ * 会话管理命令，提供以下子命令：
+ * - list: 列出所有会话
+ * - get: 获取会话详情
+ * - new: 创建新会话
+ * - rename: 更新会话标题
+ * - delete: 删除会话（支持批量删除、全量删除、按时间删除）
+ * - messages: 查看消息
+ * - grep: 全文搜索消息
+ * - compact: 压缩会话 (new)
+ * - checkpoints: 查看检查点 (new)
+ * - active: 活跃会话管理
+ * - add-message: 添加单条消息
+ * - mock: 插入模拟消息（用于测试）
+ *
+ * 删除命令使用示例：
+ *   roy sessions delete <id>                    # 删除单个会话
+ *   roy sessions delete <id1> <id2> <id3>       # 批量删除
+ *   roy sessions delete --all                    # 删除所有会话
+ *   roy sessions delete --all --keep-active     # 删除所有非活跃会话
+ *   roy sessions delete --older-than 30          # 删除30天前的会话
+ *   roy sessions delete --dry-run               # 预览模式
+ *
+ * 搜索命令使用示例：
+ *   roy sessions grep K8s deployment error       # 多关键字搜索
+ *   roy sessions grep "exact phrase"            # 精确短语
+ *   roy sessions grep --session <id> query      # 搜索指定会话
+ *   roy sessions grep --limit 10 query         # 限制结果数
+ *   roy sessions grep --json query              # JSON 输出
+ */
+export declare const SessionsCommand: CommandModule;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1,93 @@
+/**
+ * @fileoverview Sessions Command Entry
+ *
+ * 命令入口：roy sessions [action]
+ *
+ * 注意：--quiet / -q 选项现在由 cli.ts 的全局 middleware 统一处理
+ */
+import { ListCommand } from "./list.js";
+import { GetCommand } from "./get.js";
+import { NewCommand } from "./new.js";
+import { RenameCommand } from "./rename.js";
+import { DeleteCommand } from "./delete.js";
+import { MessagesCommand } from "./messages.js";
+import { CompactCommand } from "./compact.js";
+import { CheckpointsCommand } from "./checkpoints.js";
+import { ActiveCommand } from "./active.js";
+import { AddMessageCommand } from "./add-message.js";
+import { MockCommand } from "./mock.js";
+import { GrepCommand } from "./grep.js";
+/**
+ * Sessions Command
+ *
+ * 会话管理命令，提供以下子命令：
+ * - list: 列出所有会话
+ * - get: 获取会话详情
+ * - new: 创建新会话
+ * - rename: 更新会话标题
+ * - delete: 删除会话（支持批量删除、全量删除、按时间删除）
+ * - messages: 查看消息
+ * - grep: 全文搜索消息
+ * - compact: 压缩会话 (new)
+ * - checkpoints: 查看检查点 (new)
+ * - active: 活跃会话管理
+ * - add-message: 添加单条消息
+ * - mock: 插入模拟消息（用于测试）
+ *
+ * 删除命令使用示例：
+ *   roy sessions delete <id>                    # 删除单个会话
+ *   roy sessions delete <id1> <id2> <id3>       # 批量删除
+ *   roy sessions delete --all                    # 删除所有会话
+ *   roy sessions delete --all --keep-active     # 删除所有非活跃会话
+ *   roy sessions delete --older-than 30          # 删除30天前的会话
+ *   roy sessions delete --dry-run               # 预览模式
+ *
+ * 搜索命令使用示例：
+ *   roy sessions grep K8s deployment error       # 多关键字搜索
+ *   roy sessions grep "exact phrase"            # 精确短语
+ *   roy sessions grep --session <id> query      # 搜索指定会话
+ *   roy sessions grep --limit 10 query         # 限制结果数
+ *   roy sessions grep --json query              # JSON 输出
+ */
+export const SessionsCommand = {
+    command: "sessions",
+    describe: `会话管理 - 列出、创建、删除和管理会话
+  
+删除命令使用示例：
+  roy sessions delete <id>                    # 删除单个会话
+  roy sessions delete <id1> <id2> <id3>       # 批量删除
+  roy sessions delete --all                   # 删除所有会话
+  roy sessions delete --all --keep-active     # 删除所有非活跃会话
+  roy sessions delete --older-than 30         # 删除30天前的会话
+  roy sessions delete --dry-run               # 预览模式
+
+搜索命令使用示例：
+  roy sessions grep K8s deployment error       # 多关键字搜索
+  roy sessions grep "exact phrase"            # 精确短语
+  roy sessions grep --session <id> query      # 搜索指定会话
+  roy sessions grep --limit 10 query          # 限制结果数
+  roy sessions grep --json query              # JSON 输出`,
+    builder: (yargs) => {
+        // 注意：--quiet / -q 选项现在由 cli.ts 的全局 middleware 统一处理
+        return yargs
+            .command(ListCommand)
+            .command(GetCommand)
+            .command(NewCommand)
+            .command(RenameCommand)
+            .command(DeleteCommand)
+            .command(MessagesCommand)
+            .command(GrepCommand)
+            .command(CompactCommand)
+            .command(CheckpointsCommand)
+            .command(ActiveCommand)
+            .command(AddMessageCommand)
+            .command(MockCommand)
+            .demandCommand()
+            .help();
+    },
+    handler: () => {
+        // Default handler - shouldn't be reached if demandCommand is true
+        console.log("Use 'roy sessions --help' for usage information");
+    },
+};
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1,21 @@
+/**
+ * @fileoverview Sessions List Command
+ *
+ * 命令：roy sessions list
+ */
+import { CommandModule } from "yargs";
+interface ListOptions {
+    limit?: number;
+    offset?: number;
+    sort?: string;
+    order?: string;
+    json?: boolean;
+    quiet?: boolean;
+    id?: boolean;
+    config?: string;
+    type?: string;
+    status?: string;
+}
+export declare const ListCommand: CommandModule<object, ListOptions>;
+export {};
+//# sourceMappingURL=list.d.ts.map

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

@@ -0,0 +1,163 @@
+/**
+ * @fileoverview Sessions List Command
+ *
+ * 命令：roy sessions list
+ */
+import { EnvironmentService } from "../../services/environment.service.js";
+import { OutputService } from "../../services/output.service.js";
+import { CliQuietModeService } from "../../services/quiet-mode.service.js";
+import chalk from "chalk";
+export const ListCommand = {
+    command: "list [options]",
+    aliases: ["ls"],
+    describe: "列出所有会话",
+    builder: (yargs) => yargs
+        .option("limit", { alias: "n", type: "number", default: 20 })
+        .option("offset", { type: "number", default: 0 })
+        .option("sort", { type: "string", default: "updatedAt" })
+        .option("order", { type: "string", default: "desc" })
+        .option("json", { alias: "j", type: "boolean", default: false })
+        .option("quiet", { alias: "q", type: "boolean", default: false })
+        .option("id", { alias: "i", type: "boolean", default: false, description: "显示 Session ID" })
+        .option("type", { alias: "t", type: "string", description: "按 session 类型过滤 (如 workflow)" })
+        .option("status", { alias: "s", type: "string", description: "按状态过滤 (如 running, paused)" }),
+    async handler(args) {
+        const isQuiet = args.quiet === true;
+        if (isQuiet) {
+            CliQuietModeService.getInstance().setQuiet(true);
+        }
+        const output = new OutputService();
+        output.configure({ quiet: isQuiet });
+        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 listOptions = {
+                sort: { field: args.sort, order: args.order },
+                offset: args.offset,
+                limit: args.limit,
+            };
+            // Add metadata filter if type or status is specified
+            if (args.type || args.status) {
+                const metadataFilter = {};
+                if (args.type) {
+                    metadataFilter.type = args.type;
+                }
+                if (args.status) {
+                    metadataFilter.status = args.status;
+                }
+                listOptions.filter = {
+                    metadata: metadataFilter,
+                };
+            }
+            const sessions = await sessionComponent.list(listOptions);
+            const totalCount = await sessionComponent.getCount();
+            const activeSessionId = sessionComponent.getActiveSessionId();
+            if (args.json) {
+                output.json({
+                    sessions: sessions.map((s) => {
+                        const workflowMeta = s.metadata?.type === 'workflow'
+                            ? s.metadata
+                            : null;
+                        return {
+                            id: s.id,
+                            title: s.title,
+                            directory: s.directory,
+                            messageCount: s.messageCount,
+                            type: workflowMeta?.type || 'chat',
+                            status: workflowMeta?.status,
+                            workflowName: workflowMeta?.workflowName,
+                            hasCheckpoint: !!s.metadata?.checkpoints?.checkpoints?.length,
+                            lastCheckpointAt: s.metadata?.checkpoints?.latestCheckpointId,
+                            createdAt: new Date(s.createdAt).toISOString(),
+                            updatedAt: new Date(s.updatedAt).toISOString(),
+                            isActive: s.id === activeSessionId,
+                        };
+                    }),
+                    total: sessions.length,
+                    totalCount: totalCount,
+                });
+            }
+            else if (args.quiet || args.id) {
+                // 简洁输出：只显示 ID
+                sessions.forEach((s) => output.log(s.id));
+            }
+            else {
+                // 表格输出
+                const hasTypeFilter = !!args.type;
+                const hasStatusFilter = !!args.status;
+                const header = [
+                    chalk.bold("#"),
+                    chalk.bold("Title"),
+                    chalk.bold("ID"),
+                    hasTypeFilter || hasStatusFilter ? chalk.bold("Status") : null,
+                    chalk.bold("Msgs"),
+                    chalk.bold("CP"),
+                ].filter(Boolean).join(" │ ");
+                const rows = sessions.map((s, i) => {
+                    const marker = s.id === activeSessionId ? chalk.green("▶") : " ";
+                    const hasCp = (s.metadata?.checkpoints?.checkpoints?.length ?? 0) > 0;
+                    const title = s.title.length > 20 ? s.title.slice(0, 17) + "..." : s.title;
+                    // 显示完整的 Session ID
+                    const idStr = s.id;
+                    // Get workflow metadata if present
+                    const workflowMeta = s.metadata?.type === 'workflow'
+                        ? s.metadata
+                        : null;
+                    const typeStr = workflowMeta?.type || '';
+                    const statusStr = workflowMeta?.status || '';
+                    // Format status for display
+                    let statusDisplay = '';
+                    if (hasTypeFilter || hasStatusFilter) {
+                        if (workflowMeta) {
+                            statusDisplay = workflowMeta.status === 'running' ? chalk.green('running')
+                                : workflowMeta.status === 'paused' ? chalk.yellow('paused')
+                                    : workflowMeta.status === 'completed' ? chalk.gray('completed')
+                                        : workflowMeta.status === 'failed' ? chalk.red('failed')
+                                            : statusStr;
+                        }
+                    }
+                    const cells = [
+                        marker + " " + (args.offset + i + 1),
+                        title,
+                        chalk.gray(idStr),
+                    ];
+                    if (hasTypeFilter || hasStatusFilter) {
+                        cells.push(statusDisplay || chalk.gray('-'));
+                    }
+                    cells.push(s.messageCount.toString(), hasCp ? chalk.green("✓") : chalk.gray("-"));
+                    return cells.join(" │ ");
+                });
+                const showingInfo = totalCount > sessions.length
+                    ? `Showing ${sessions.length} of ${totalCount} sessions`
+                    : `${totalCount} sessions`;
+                output.log([
+                    `┌─ Sessions ${"─".repeat(50)}┐`,
+                    `│${header}│`,
+                    "├" + "─".repeat(header.length + 2) + "┤",
+                    ...rows.map((r) => `│${r}│`),
+                    "└" + "─".repeat(header.length + 2) + "┘",
+                    "",
+                    chalk.gray(showingInfo),
+                ].join("\n"));
+            }
+        }
+        catch (error) {
+            output.error(`Failed to list sessions: ${error instanceof Error ? error.message : String(error)}`);
+            process.exit(1);
+        }
+        finally {
+            await envService.dispose();
+        }
+    },
+};
+//# sourceMappingURL=list.js.map

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

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