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

package/dist/cli/src/commands/shared/event-handler.js

@@ -1,167 +0,0 @@
-/**
- * @fileoverview Event Handler
- *
- * 管理环境事件的订阅、队列和处理
- */
-import { EventMessageFormatter } from "./event-message-formatter.js";
-/**
- * 事件处理器
- *
- * 订阅环境事件，格式化后通过队列管理，agent 空闲时触发处理
- */
-export class EventHandler {
-    env;
-    eventTypes;
-    onEvent;
-    formatter;
-    isIdle;
-    idleCheckInterval;
-    queue = [];
-    isProcessing = false;
-    isStopped = false;
-    unsubscribe = null;
-    constructor(options) {
-        this.env = options.env;
-        this.eventTypes = options.eventTypes;
-        this.onEvent = options.onEvent;
-        this.formatter = options.formatter ?? new EventMessageFormatter();
-        this.isIdle = options.isIdle ?? (() => true); // 默认认为总是空闲
-        this.idleCheckInterval = options.idleCheckInterval ?? 100;
-    }
-    /**
-     * 启动事件处理
-     * @returns 取消订阅函数
-     */
-    start() {
-        this.isStopped = false;
-        // 使用 subscribeAll 接收所有事件，然后在 handler 中过滤类型
-        // 因为 subscribeTo 不支持通配符模式
-        this.unsubscribe = this.env.subscribeAll((event) => {
-            // 检查事件类型是否匹配
-            if (this.matchesEventType(event.type)) {
-                this.handleEvent(event);
-            }
-        });
-        return () => this.stop();
-    }
-    /**
-     * 检查事件类型是否匹配
-     */
-    matchesEventType(eventType) {
-        for (const pattern of this.eventTypes) {
-            if (this.matchPattern(eventType, pattern)) {
-                return true;
-            }
-        }
-        return false;
-    }
-    /**
-     * 通配符模式匹配
-     * 支持:
-     * - "task.*" 匹配 "task.started", "task.completed" 等
-     * - "task.started" 精确匹配
-     */
-    matchPattern(eventType, pattern) {
-        if (pattern === "*")
-            return true;
-        if (pattern.endsWith(".*")) {
-            const prefix = pattern.slice(0, -2);
-            return eventType === prefix || eventType.startsWith(prefix + ".");
-        }
-        return eventType === pattern;
-    }
-    /**
-     * 停止事件处理
-     */
-    stop() {
-        this.isStopped = true;
-        if (this.unsubscribe) {
-            this.unsubscribe();
-            this.unsubscribe = null;
-        }
-        // 清空队列
-        this.queue = [];
-        this.isProcessing = false;
-    }
-    /**
-     * 处理收到的事件
-     */
-    handleEvent(event) {
-        // 如果已停止，忽略事件
-        if (this.isStopped) {
-            return;
-        }
-        // 格式化事件为用户消息
-        const message = this.formatter.format(event);
-        // 加入队列
-        this.enqueue(message);
-    }
-    /**
-     * 将消息加入队列
-     */
-    enqueue(message) {
-        // 如果已停止，忽略
-        if (this.isStopped) {
-            return;
-        }
-        this.queue.push(message);
-        // 如果没有在处理，触发处理
-        if (!this.isProcessing) {
-            this.processQueue();
-        }
-    }
-    /**
-     * 获取队列长度
-     */
-    getQueueLength() {
-        return this.queue.length;
-    }
-    /**
-     * 检查队列是否为空
-     */
-    isQueueEmpty() {
-        return this.queue.length === 0;
-    }
-    /**
-     * 处理队列中的消息（使用 while 循环避免递归栈溢出）
-     */
-    async processQueue() {
-        this.isProcessing = true;
-        while (!this.isStopped && this.queue.length > 0) {
-            // 等待 agent 空闲
-            await this.waitForIdle();
-            // 如果已停止，退出循环
-            if (this.isStopped) {
-                break;
-            }
-            // 取出队首消息
-            const message = this.queue.shift();
-            if (!message) {
-                break;
-            }
-            try {
-                // 触发事件处理
-                await this.onEvent(message);
-            }
-            catch (error) {
-                console.error(`[EventHandler] 处理事件失败:`, error);
-            }
-        }
-        this.isProcessing = false;
-    }
-    /**
-     * 等待 agent 空闲
-     */
-    async waitForIdle() {
-        while (!this.isStopped && !this.isIdle()) {
-            await this.sleep(this.idleCheckInterval);
-        }
-    }
-    /**
-     * 睡眠工具函数
-     */
-    sleep(ms) {
-        return new Promise(resolve => setTimeout(resolve, ms));
-    }
-}
-//# sourceMappingURL=event-handler.js.map

package/dist/cli/src/commands/shared/event-message-formatter.d.ts

@@ -1,150 +0,0 @@
-/**
- * @fileoverview Event Message Formatter
- *
- * 将 EnvEvent 格式化为用户可读的消息
- */
-import type { EnvEvent } from "@ai-setting/roy-agent-core";
-/**
- * 任务事件类型
- */
-export declare const TaskEventTypes: {
-    readonly TASK_STARTED: "task.started";
-    readonly TASK_PROGRESS: "task.progress";
-    readonly TASK_COMPLETED: "task.completed";
-    readonly TASK_FAILED: "task.failed";
-    readonly TASK_TIMEOUT: "task.timeout";
-    readonly TASK_STOPPED: "task.stopped";
-};
-/**
- * EventSource 事件类型
- */
-export declare const EventSourceEventTypes: {
-    readonly EVENT_SOURCE_STARTED: "event-source.started";
-    readonly EVENT_SOURCE_STOPPED: "event-source.stopped";
-    readonly EVENT_SOURCE_EVENT_PREFIX: "event-source.event.";
-};
-/**
- * 事件元信息接口
- */
-export interface EventMetadata {
-    eventType?: string;
-    appId?: string;
-    chatId?: string;
-    chatType?: string;
-    messageId?: string;
-    messageType?: string;
-    senderId?: string;
-    tenantKey?: string;
-    [key: string]: unknown;
-}
-/**
- * 推荐动作接口
- */
-export interface RecommendedAction {
-    action: string;
-    replyTo?: {
-        appId?: string;
-        chatId?: string;
-        messageId?: string;
-    };
-    rawCommand?: string;
-}
-/**
- * EventSource 事件负载接口
- */
-export interface EventSourceEventPayload {
-    sourceId: string;
-    sourceType: string;
-    rawEvent: unknown;
-    message: string;
-    metadata: EventMetadata;
-    recommendedAction?: RecommendedAction;
-    timestamp: number;
-}
-/**
- * 任务事件负载接口
- */
-export interface TaskEventPayload {
-    taskId: string;
-    subSessionId: string;
-    parentSessionId: string;
-    description: string;
-    subagentType: string;
-    status?: string;
-    progress?: number;
-    progressMessage?: string;
-    result?: string;
-    error?: string;
-    executionTimeMs?: number;
-    associatedTaskId?: number;
-}
-/**
- * 格式化选项
- */
-export interface EventMessageFormatterOptions {
-    /** 消息前缀 */
-    prefix?: string;
-    /** 是否显示详细时间 */
-    showTimestamp?: boolean;
-}
-/**
- * 事件消息格式化器
- *
- * 将 EnvEvent 转换为用户可读的文本消息
- */
-export declare class EventMessageFormatter {
-    private prefix;
-    private showTimestamp;
-    constructor(options?: EventMessageFormatterOptions);
-    /**
-     * 格式化事件为用户消息
-     */
-    format(event: EnvEvent): string;
-    /**
-     * 格式化任务开始事件
-     */
-    private formatTaskStarted;
-    /**
-     * 格式化任务进度事件
-     */
-    private formatTaskProgress;
-    /**
-     * 格式化任务完成事件
-     */
-    private formatTaskCompleted;
-    /**
-     * 格式化任务失败事件
-     */
-    private formatTaskFailed;
-    /**
-     * 格式化任务超时事件
-     */
-    private formatTaskTimeout;
-    /**
-     * 格式化任务停止事件
-     */
-    private formatTaskStopped;
-    /**
-     * 格式化通用事件
-     */
-    private formatGeneric;
-    /**
-     * 格式化事件源启动事件
-     */
-    private formatEventSourceStarted;
-    /**
-     * 格式化事件源停止事件
-     */
-    private formatEventSourceStopped;
-    /**
-     * 格式化事件源收到的事件（如飞书消息）
-     *
-     * 泛化处理：直接序列化事件为可读文本，不依赖特定字段
-     */
-    private formatEventSourceEvent;
-    /**
-     * 格式化时长
-     */
-    private formatDuration;
-}
-//# sourceMappingURL=event-message-formatter.d.ts.map

package/dist/cli/src/commands/shared/event-message-formatter.js

@@ -1,198 +0,0 @@
-/**
- * @fileoverview Event Message Formatter
- *
- * 将 EnvEvent 格式化为用户可读的消息
- */
-// ============================================================================
-// Event Type Mapping
-// ============================================================================
-/**
- * 任务事件类型
- */
-export const TaskEventTypes = {
-    TASK_STARTED: "task.started",
-    TASK_PROGRESS: "task.progress",
-    TASK_COMPLETED: "task.completed",
-    TASK_FAILED: "task.failed",
-    TASK_TIMEOUT: "task.timeout",
-    TASK_STOPPED: "task.stopped",
-};
-/**
- * EventSource 事件类型
- */
-export const EventSourceEventTypes = {
-    EVENT_SOURCE_STARTED: "event-source.started",
-    EVENT_SOURCE_STOPPED: "event-source.stopped",
-    EVENT_SOURCE_EVENT_PREFIX: "event-source.event.",
-};
-// ============================================================================
-// EventMessageFormatter
-// ============================================================================
-/**
- * 事件消息格式化器
- *
- * 将 EnvEvent 转换为用户可读的文本消息
- */
-export class EventMessageFormatter {
-    prefix;
-    showTimestamp;
-    constructor(options = {}) {
-        this.prefix = options.prefix ?? "[通知]";
-        this.showTimestamp = options.showTimestamp ?? false;
-    }
-    /**
-     * 格式化事件为用户消息
-     */
-    format(event) {
-        const { type, payload } = event;
-        // 根据事件类型格式化
-        switch (type) {
-            case TaskEventTypes.TASK_STARTED:
-                return this.formatTaskStarted(payload);
-            case TaskEventTypes.TASK_PROGRESS:
-                return this.formatTaskProgress(payload);
-            case TaskEventTypes.TASK_COMPLETED:
-                return this.formatTaskCompleted(payload);
-            case TaskEventTypes.TASK_FAILED:
-                return this.formatTaskFailed(payload);
-            case TaskEventTypes.TASK_TIMEOUT:
-                return this.formatTaskTimeout(payload);
-            case TaskEventTypes.TASK_STOPPED:
-                return this.formatTaskStopped(payload);
-            case EventSourceEventTypes.EVENT_SOURCE_STARTED:
-                return this.formatEventSourceStarted(payload);
-            case EventSourceEventTypes.EVENT_SOURCE_STOPPED:
-                return this.formatEventSourceStopped(payload);
-            default:
-                // 处理 event-source.event.* 类型的事件
-                if (type.startsWith(EventSourceEventTypes.EVENT_SOURCE_EVENT_PREFIX)) {
-                    return this.formatEventSourceEvent(event);
-                }
-                return this.formatGeneric(event);
-        }
-    }
-    /**
-     * 格式化任务开始事件
-     */
-    formatTaskStarted(payload) {
-        const desc = payload.description || "未命名任务";
-        return `${this.prefix} 📢 后台任务「${desc}」已启动`;
-    }
-    /**
-     * 格式化任务进度事件
-     */
-    formatTaskProgress(payload) {
-        const desc = payload.description || "未命名任务";
-        const progress = payload.progress !== undefined ? `${payload.progress}%` : "";
-        const message = payload.progressMessage || "";
-        let result = `${this.prefix} 🔄 后台任务「${desc}」进度更新`;
-        if (progress)
-            result += `: ${progress}`;
-        if (message)
-            result += ` - ${message}`;
-        return result;
-    }
-    /**
-     * 格式化任务完成事件
-     */
-    formatTaskCompleted(payload) {
-        const desc = payload.description || "未命名任务";
-        const result = payload.result;
-        const time = payload.executionTimeMs ? `(${this.formatDuration(payload.executionTimeMs)})` : "";
-        let message = `${this.prefix} ✅ 后台任务「${desc}」已完成 ${time}`;
-        if (result) {
-            // 截断过长结果
-            const truncatedResult = result.length > 100
-                ? result.substring(0, 100) + "..."
-                : result;
-            message += `\n结果: ${truncatedResult}`;
-        }
-        return message;
-    }
-    /**
-     * 格式化任务失败事件
-     */
-    formatTaskFailed(payload) {
-        const desc = payload.description || "未命名任务";
-        const error = payload.error || "未知错误";
-        const time = payload.executionTimeMs ? `(${this.formatDuration(payload.executionTimeMs)})` : "";
-        let message = `${this.prefix} ❌ 后台任务「${desc}」失败 ${time}`;
-        if (error) {
-            // 截断过长错误信息
-            const truncatedError = error.length > 100
-                ? error.substring(0, 100) + "..."
-                : error;
-            message += `\n错误: ${truncatedError}`;
-        }
-        return message;
-    }
-    /**
-     * 格式化任务超时事件
-     */
-    formatTaskTimeout(payload) {
-        const desc = payload.description || "未命名任务";
-        const time = payload.executionTimeMs ? `(${this.formatDuration(payload.executionTimeMs)})` : "";
-        return `${this.prefix} ⏱️ 后台任务「${desc}」超时 ${time}`;
-    }
-    /**
-     * 格式化任务停止事件
-     */
-    formatTaskStopped(payload) {
-        const desc = payload.description || "未命名任务";
-        const time = payload.executionTimeMs ? `(${this.formatDuration(payload.executionTimeMs)})` : "";
-        return `${this.prefix} 🛑 后台任务「${desc}」已停止 ${time}`;
-    }
-    /**
-     * 格式化通用事件
-     */
-    formatGeneric(event) {
-        return `${this.prefix} 收到事件: ${event.type}`;
-    }
-    // ============================================================================
-    // EventSource 事件格式化
-    // ============================================================================
-    /**
-     * 格式化事件源启动事件
-     */
-    formatEventSourceStarted(payload) {
-        return `${this.prefix} 📡 事件源「${payload.sourceId}」(类型: ${payload.sourceType}) 已启动`;
-    }
-    /**
-     * 格式化事件源停止事件
-     */
-    formatEventSourceStopped(payload) {
-        return `${this.prefix} 📡 事件源「${payload.sourceId}」(类型: ${payload.sourceType}) 已停止`;
-    }
-    /**
-     * 格式化事件源收到的事件（如飞书消息）
-     *
-     * 泛化处理：直接序列化事件为可读文本，不依赖特定字段
-     */
-    formatEventSourceEvent(event) {
-        const payload = event.payload;
-        const sourceType = payload?.sourceType || "unknown";
-        const message = payload?.message || "";
-        // 直接使用 EventSourceComponent 格式化好的 message
-        if (message) {
-            return `[${sourceType}] ${message}`;
-        }
-        // 如果没有预格式化的 message，整个事件序列化
-        return `[${sourceType}] ${JSON.stringify(payload, null, 2)}`;
-    }
-    // ============================================================================
-    // 辅助方法
-    // ============================================================================
-    /**
-     * 格式化时长
-     */
-    formatDuration(ms) {
-        if (ms < 1000)
-            return `${ms}ms`;
-        if (ms < 60000)
-            return `${(ms / 1000).toFixed(1)}秒`;
-        const minutes = Math.floor(ms / 60000);
-        const seconds = Math.floor((ms % 60000) / 1000);
-        return `${minutes}分${seconds}秒`;
-    }
-}
-//# sourceMappingURL=event-message-formatter.js.map

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

@@ -1,10 +0,0 @@
-/**
- * @fileoverview Shared modules for CLI commands
- *
- * 导出共享模块供 act、interactive 等命令复用
- */
-export { SessionManager } from "./session-manager";
-export type { SessionInitResult, SessionManagerOptions } from "./session-manager";
-export { QueryExecutor } from "./query-executor";
-export type { QueryExecutorOptions, StreamOptions } from "./query-executor";
-//# sourceMappingURL=index.d.ts.map

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

@@ -1,8 +0,0 @@
-/**
- * @fileoverview Shared modules for CLI commands
- *
- * 导出共享模块供 act、interactive 等命令复用
- */
-export { SessionManager } from "./session-manager.js";
-export { QueryExecutor } from "./query-executor.js";
-//# sourceMappingURL=index.js.map

package/dist/cli/src/commands/shared/query-executor.d.ts

@@ -1,81 +0,0 @@
-/**
- * @fileoverview Query Executor - 查询执行共享逻辑
- *
- * 从 act.ts 抽取的查询执行逻辑，供 interactive 复用
- *
- * 功能：
- * - 初始化 SummaryAgent
- * - 订阅 LLM/上下文事件
- * - 流式输出
- * - ContextHandler 执行
- * - 支持 abort 流式输出
- */
-import { OutputService } from "../../services/output.service";
-import type { BaseEnvironment, SessionComponent, LLMComponent, PromptComponent } from "@ai-setting/roy-agent-core";
-export interface QueryExecutorOptions {
-    env: BaseEnvironment;
-    sessionComponent: SessionComponent;
-    output: OutputService;
-    quiet: boolean;
-}
-export interface StreamOptions {
-    showReasoning: boolean;
-    showToolCalls: boolean;
-    showToolResults: boolean;
-}
-/**
- * QueryExecutor - 查询执行器
- *
- * 封装查询执行的完整流程
- */
-export declare class QueryExecutor {
-    private env;
-    private sessionComponent;
-    private output;
-    private quiet;
-    private streamService;
-    private unsubscribe;
-    private streamOptions;
-    private _pendingContextConfig;
-    constructor(options: QueryExecutorOptions);
-    /**
-     * 初始化 SummaryAgent（用于 compact）
-     */
-    initSummaryAgent(llmComponent: LLMComponent, promptComponent: PromptComponent): void;
-    /**
-     * 初始化流式输出配置（设置 context window 信息）
-     */
-    initStreamOutput(llmComponent: LLMComponent | null, providerId?: string): void;
-    /**
-     * 订阅事件（用于流式输出）
-     */
-    subscribeToEvents(options: StreamOptions): void;
-    /**
-     * 处理事件
-     */
-    protected handleEvent(event: any): void;
-    /**
-     * 执行查询
-     */
-    execute(message: string, sessionId: string, streamOptions?: Partial<StreamOptions>, traceId?: string): Promise<string>;
-    /**
-     * 清理资源
-     */
-    dispose(): void;
-    /**
-     * 获取流式输出服务的完整文本
-     */
-    getFullText(): string;
-    /**
-     * 手动压缩会话上下文
-     *
-     * 复用 ContextHandlerService.compactSession 逻辑
-     */
-    compact(sessionId: string): Promise<{
-        success: boolean;
-        checkpoint?: any;
-        deletedMessageCount?: number;
-        error?: string;
-    }>;
-}
-//# sourceMappingURL=query-executor.d.ts.map