agentstudio 0.3.1 → 0.3.3

package/services/askUserQuestion/slackNotificationChannel.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Slack Notification Channel
+ *
+ * 实现通过 Slack 消息向用户发送通知
+ * 使用 Slack Block Kit 创建交互式消息
+ */
+import type { NotificationChannel, UserInputRequest, ChannelType } from './notificationChannel.js';
+import { SlackClient } from '../slackClient.js';
+/**
+ * Slack 通知渠道实现
+ */
+export declare class SlackNotificationChannel implements NotificationChannel {
+    type: ChannelType;
+    channelId: string;
+    sessionId: string;
+    agentId: string;
+    createdAt: number;
+    private slackClient;
+    private slackChannelId;
+    private threadTs;
+    private active;
+    constructor(slackClient: SlackClient, slackChannelId: string, threadTs: string, sessionId: string, agentId: string);
+    isActive(): boolean;
+    sendAwaitingInput(request: UserInputRequest): Promise<boolean>;
+    close(): void;
+    /**
+     * 构建 Slack Block Kit 格式的问题消息
+     */
+    private buildQuestionBlocks;
+}
+/**
+ * 生成 Slack channel ID
+ */
+export declare function generateSlackChannelId(slackChannelId: string, threadTs: string): string;
+//# sourceMappingURL=slackNotificationChannel.d.ts.map

package/services/askUserQuestion/slackNotificationChannel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slackNotificationChannel.d.ts","sourceRoot":"","sources":["../../../src/services/askUserQuestion/slackNotificationChannel.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACnG,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD;;GAEG;AACH,qBAAa,wBAAyB,YAAW,mBAAmB;IAClE,IAAI,EAAE,WAAW,CAAW;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAElB,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,MAAM,CAAiB;gBAG7B,WAAW,EAAE,WAAW,EACxB,cAAc,EAAE,MAAM,EACtB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM;IAWjB,QAAQ,IAAI,OAAO;IAIb,iBAAiB,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,OAAO,CAAC;IAwBpE,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,OAAO,CAAC,mBAAmB;CAgE5B;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,cAAc,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEvF"}

package/services/askUserQuestion/slackNotificationChannel.js

@@ -0,0 +1,129 @@
+"use strict";
+/**
+ * Slack Notification Channel
+ *
+ * 实现通过 Slack 消息向用户发送通知
+ * 使用 Slack Block Kit 创建交互式消息
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SlackNotificationChannel = void 0;
+exports.generateSlackChannelId = generateSlackChannelId;
+/**
+ * Slack 通知渠道实现
+ */
+class SlackNotificationChannel {
+    type = 'slack';
+    channelId; // 格式: channel_id:thread_ts
+    sessionId;
+    agentId;
+    createdAt;
+    slackClient;
+    slackChannelId;
+    threadTs;
+    active = true;
+    constructor(slackClient, slackChannelId, threadTs, sessionId, agentId) {
+        this.slackClient = slackClient;
+        this.slackChannelId = slackChannelId;
+        this.threadTs = threadTs;
+        this.channelId = `slack_${slackChannelId}_${threadTs}`;
+        this.sessionId = sessionId;
+        this.agentId = agentId;
+        this.createdAt = Date.now();
+    }
+    isActive() {
+        return this.active;
+    }
+    async sendAwaitingInput(request) {
+        if (!this.isActive()) {
+            return false;
+        }
+        try {
+            // 构建 Slack Block Kit 消息
+            const blocks = this.buildQuestionBlocks(request);
+            await this.slackClient.postMessage({
+                channel: this.slackChannelId,
+                thread_ts: this.threadTs,
+                text: '🎤 AI 需要您的反馈来继续',
+                blocks,
+            });
+            console.log(`📤 [SlackChannel] Sent awaiting_user_input to channel: ${this.channelId}`);
+            return true;
+        }
+        catch (error) {
+            console.error(`❌ [SlackChannel] Failed to send message:`, error);
+            return false;
+        }
+    }
+    close() {
+        this.active = false;
+    }
+    /**
+     * 构建 Slack Block Kit 格式的问题消息
+     */
+    buildQuestionBlocks(request) {
+        const blocks = [
+            {
+                type: 'header',
+                text: {
+                    type: 'plain_text',
+                    text: '🎤 AI 需要您的反馈',
+                    emoji: true
+                }
+            },
+            {
+                type: 'section',
+                text: {
+                    type: 'mrkdwn',
+                    text: `请回答以下问题以继续。\n\n*提示*: 回复时请在消息开头加上问题编号，如 \`Q1: 选项A\``
+                }
+            },
+            {
+                type: 'divider'
+            }
+        ];
+        // 添加每个问题
+        request.questions.forEach((question, index) => {
+            // 问题标题
+            blocks.push({
+                type: 'section',
+                text: {
+                    type: 'mrkdwn',
+                    text: `*Q${index + 1}. ${question.question}*${question.multiSelect ? ' _(可多选)_' : ''}`
+                }
+            });
+            // 选项列表
+            const optionText = question.options
+                .map((opt, i) => `• *${opt.label}*: ${opt.description}`)
+                .join('\n');
+            blocks.push({
+                type: 'section',
+                text: {
+                    type: 'mrkdwn',
+                    text: optionText
+                }
+            });
+            blocks.push({
+                type: 'divider'
+            });
+        });
+        // 添加提示
+        blocks.push({
+            type: 'context',
+            elements: [
+                {
+                    type: 'mrkdwn',
+                    text: `📝 请直接回复此消息来提交您的答案 | Tool ID: \`${request.toolUseId}\``
+                }
+            ]
+        });
+        return blocks;
+    }
+}
+exports.SlackNotificationChannel = SlackNotificationChannel;
+/**
+ * 生成 Slack channel ID
+ */
+function generateSlackChannelId(slackChannelId, threadTs) {
+    return `slack_${slackChannelId}_${threadTs}`;
+}
+//# sourceMappingURL=slackNotificationChannel.js.map

package/services/askUserQuestion/slackNotificationChannel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slackNotificationChannel.js","sourceRoot":"","sources":["../../../src/services/askUserQuestion/slackNotificationChannel.ts"],"names":[],"mappings":"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"}

package/services/askUserQuestion/sseNotificationChannel.d.ts

@@ -0,0 +1,36 @@
+/**
+ * SSE Notification Channel
+ *
+ * 实现通过 Server-Sent Events 向 Web 浏览器发送通知
+ */
+import type { Response } from 'express';
+import type { NotificationChannel, UserInputRequest, ChannelType } from './notificationChannel.js';
+/**
+ * SSE 通知渠道实现
+ */
+export declare class SSENotificationChannel implements NotificationChannel {
+    type: ChannelType;
+    channelId: string;
+    sessionId: string;
+    agentId: string;
+    createdAt: number;
+    private res;
+    private closed;
+    private onCloseCallback?;
+    /**
+     * @param channelId - 渠道唯一标识
+     * @param sessionId - 关联的会话 ID
+     * @param agentId - 关联的 Agent ID
+     * @param res - Express Response 对象
+     * @param onClose - 可选的关闭回调，用于在连接关闭时注销渠道
+     */
+    constructor(channelId: string, sessionId: string, agentId: string, res: Response, onClose?: () => void);
+    isActive(): boolean;
+    sendAwaitingInput(request: UserInputRequest): Promise<boolean>;
+    close(): void;
+}
+/**
+ * 生成唯一的 SSE channel ID
+ */
+export declare function generateSSEChannelId(): string;
+//# sourceMappingURL=sseNotificationChannel.d.ts.map

package/services/askUserQuestion/sseNotificationChannel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sseNotificationChannel.d.ts","sourceRoot":"","sources":["../../../src/services/askUserQuestion/sseNotificationChannel.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACxC,OAAO,KAAK,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAEnG;;GAEG;AACH,qBAAa,sBAAuB,YAAW,mBAAmB;IAChE,IAAI,EAAE,WAAW,CAAS;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAElB,OAAO,CAAC,GAAG,CAAW;IACtB,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,eAAe,CAAC,CAAa;IAErC;;;;;;OAMG;gBAED,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,QAAQ,EACb,OAAO,CAAC,EAAE,MAAM,IAAI;IAyBtB,QAAQ,IAAI,OAAO;IAIb,iBAAiB,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,OAAO,CAAC;IAyBpE,KAAK,IAAI,IAAI;CAGd;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAE7C"}

package/services/askUserQuestion/sseNotificationChannel.js

@@ -0,0 +1,88 @@
+"use strict";
+/**
+ * SSE Notification Channel
+ *
+ * 实现通过 Server-Sent Events 向 Web 浏览器发送通知
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SSENotificationChannel = void 0;
+exports.generateSSEChannelId = generateSSEChannelId;
+/**
+ * SSE 通知渠道实现
+ */
+class SSENotificationChannel {
+    type = 'sse';
+    channelId;
+    sessionId;
+    agentId;
+    createdAt;
+    res;
+    closed = false;
+    onCloseCallback;
+    /**
+     * @param channelId - 渠道唯一标识
+     * @param sessionId - 关联的会话 ID
+     * @param agentId - 关联的 Agent ID
+     * @param res - Express Response 对象
+     * @param onClose - 可选的关闭回调，用于在连接关闭时注销渠道
+     */
+    constructor(channelId, sessionId, agentId, res, onClose) {
+        this.channelId = channelId;
+        this.sessionId = sessionId;
+        this.agentId = agentId;
+        this.res = res;
+        this.createdAt = Date.now();
+        this.onCloseCallback = onClose;
+        // 监听连接关闭
+        res.on('close', () => {
+            this.closed = true;
+            console.log(`📡 [SSEChannel] Connection closed: ${channelId}`);
+            // 调用关闭回调，用于注销渠道
+            if (this.onCloseCallback) {
+                try {
+                    this.onCloseCallback();
+                }
+                catch (error) {
+                    console.error(`❌ [SSEChannel] Error in onClose callback:`, error);
+                }
+            }
+        });
+    }
+    isActive() {
+        return !this.closed && !this.res.destroyed;
+    }
+    async sendAwaitingInput(request) {
+        if (!this.isActive()) {
+            return false;
+        }
+        try {
+            const event = {
+                type: 'awaiting_user_input',
+                toolUseId: request.toolUseId,
+                toolName: 'mcp__ask-user-question__ask_user_question',
+                toolInput: { questions: request.questions },
+                agentId: request.agentId,
+                sessionId: request.sessionId,
+                timestamp: Date.now(),
+            };
+            this.res.write(`data: ${JSON.stringify(event)}\n\n`);
+            console.log(`📤 [SSEChannel] Sent awaiting_user_input to channel: ${this.channelId}`);
+            return true;
+        }
+        catch (error) {
+            console.error(`❌ [SSEChannel] Failed to send event:`, error);
+            return false;
+        }
+    }
+    close() {
+        this.closed = true;
+    }
+}
+exports.SSENotificationChannel = SSENotificationChannel;
+/**
+ * 生成唯一的 SSE channel ID
+ */
+function generateSSEChannelId() {
+    return `sse_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;
+}
+//# sourceMappingURL=sseNotificationChannel.js.map

package/services/askUserQuestion/sseNotificationChannel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sseNotificationChannel.js","sourceRoot":"","sources":["../../../src/services/askUserQuestion/sseNotificationChannel.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AA6FH,oDAEC;AA1FD;;GAEG;AACH,MAAa,sBAAsB;IACjC,IAAI,GAAgB,KAAK,CAAC;IAC1B,SAAS,CAAS;IAClB,SAAS,CAAS;IAClB,OAAO,CAAS;IAChB,SAAS,CAAS;IAEV,GAAG,CAAW;IACd,MAAM,GAAY,KAAK,CAAC;IACxB,eAAe,CAAc;IAErC;;;;;;OAMG;IACH,YACE,SAAiB,EACjB,SAAiB,EACjB,OAAe,EACf,GAAa,EACb,OAAoB;QAEpB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACf,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC5B,IAAI,CAAC,eAAe,GAAG,OAAO,CAAC;QAE/B,SAAS;QACT,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;YACnB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;YACnB,OAAO,CAAC,GAAG,CAAC,sCAAsC,SAAS,EAAE,CAAC,CAAC;YAE/D,gBAAgB;YAChB,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;gBACzB,IAAI,CAAC;oBACH,IAAI,CAAC,eAAe,EAAE,CAAC;gBACzB,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,OAAO,CAAC,KAAK,CAAC,2CAA2C,EAAE,KAAK,CAAC,CAAC;gBACpE,CAAC;YACH,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAED,QAAQ;QACN,OAAO,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC;IAC7C,CAAC;IAED,KAAK,CAAC,iBAAiB,CAAC,OAAyB;QAC/C,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,CAAC;YACrB,OAAO,KAAK,CAAC;QACf,CAAC;QAED,IAAI,CAAC;YACH,MAAM,KAAK,GAAG;gBACZ,IAAI,EAAE,qBAAqB;gBAC3B,SAAS,EAAE,OAAO,CAAC,SAAS;gBAC5B,QAAQ,EAAE,2CAA2C;gBACrD,SAAS,EAAE,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE;gBAC3C,OAAO,EAAE,OAAO,CAAC,OAAO;gBACxB,SAAS,EAAE,OAAO,CAAC,SAAS;gBAC5B,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;aACtB,CAAC;YAEF,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YACrD,OAAO,CAAC,GAAG,CAAC,wDAAwD,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;YACtF,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,sCAAsC,EAAE,KAAK,CAAC,CAAC;YAC7D,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,KAAK;QACH,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;IACrB,CAAC;CACF;AAhFD,wDAgFC;AAED;;GAEG;AACH,SAAgB,oBAAoB;IAClC,OAAO,OAAO,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;AACxE,CAAC"}

package/services/askUserQuestion/userInputRegistry.d.ts

@@ -0,0 +1,107 @@
+/**
+ * User Input Registry
+ *
+ * 管理等待用户输入的工具调用，使用 Promise 机制实现真正的阻塞
+ *
+ * 新架构：
+ * - 使用 sessionId + toolUseId 标识请求
+ * - 不再持有通知回调，改为发出事件
+ * - 通知由 NotificationChannelManager 处理
+ *
+ * 流程：
+ * 1. MCP 工具调用 waitForUserInput，创建 pending entry
+ * 2. Registry 发出 'awaiting_input' 事件
+ * 3. NotificationChannelManager 监听事件，发送通知
+ * 4. 用户提交答案，调用 submitUserResponse
+ * 5. Registry resolve Promise，MCP 工具返回
+ */
+import { EventEmitter } from 'events';
+import type { UserInputRequest } from './notificationChannel.js';
+export type { UserInputRequest } from './notificationChannel.js';
+export interface PendingUserInput {
+    request: UserInputRequest;
+    resolve: (response: string) => void;
+    reject: (error: Error) => void;
+}
+declare class UserInputRegistry extends EventEmitter {
+    private pendingInputs;
+    private cleanupInterval;
+    private maxAgeMs;
+    /**
+     * 注册一个等待用户输入的请求
+     * 返回一个 Promise，在用户提交答案时 resolve
+     * 不设置超时，允许一直等待
+     *
+     * @param sessionId - 会话 ID
+     * @param agentId - Agent ID
+     * @param toolUseId - 工具调用 ID
+     * @param questions - 问题列表
+     */
+    waitForUserInput(sessionId: string, agentId: string, toolUseId: string, questions: UserInputRequest['questions']): Promise<string>;
+    /**
+     * 提交用户的答案
+     * 会 resolve 对应的 Promise，使 MCP 工具返回
+     */
+    submitUserResponse(toolUseId: string, response: string): boolean;
+    /**
+     * 取消等待用户输入
+     */
+    cancelUserInput(toolUseId: string, reason?: string): boolean;
+    /**
+     * 检查是否有等待中的输入
+     */
+    hasPendingInput(toolUseId: string): boolean;
+    /**
+     * 获取 pending input 的请求信息（用于验证）
+     */
+    getPendingInput(toolUseId: string): UserInputRequest | null;
+    /**
+     * 验证并提交用户响应
+     * 验证 sessionId 和 agentId 是否匹配，防止伪造响应
+     *
+     * @returns { success: boolean; error?: string }
+     */
+    validateAndSubmitUserResponse(toolUseId: string, response: string, sessionId?: string, agentId?: string): {
+        success: boolean;
+        error?: string;
+    };
+    /**
+     * 获取 session 的所有等待中的输入
+     */
+    getPendingInputsBySession(sessionId: string): UserInputRequest[];
+    /**
+     * 取消 session 的所有等待中的输入
+     */
+    cancelAllBySession(sessionId: string, reason?: string): number;
+    /**
+     * 获取统计信息
+     */
+    getStats(): {
+        totalPending: number;
+        oldestPendingAge: number | null;
+    };
+    /**
+     * 更新 session 的所有 pending inputs 的 sessionId
+     * 用于临时 sessionId 更新为真实 sessionId 的场景
+     */
+    updateSessionId(oldSessionId: string, newSessionId: string): number;
+    /**
+     * 启动定期清理任务
+     * 清理超过 maxAge 的过期 pending inputs
+     *
+     * @param intervalMs - 清理间隔（毫秒），默认 1 小时
+     * @param maxAgeMs - 最大存活时间（毫秒），默认 24 小时
+     */
+    startCleanupJob(intervalMs?: number, maxAgeMs?: number): void;
+    /**
+     * 停止定期清理任务
+     */
+    stopCleanupJob(): void;
+    /**
+     * 清理过期的 pending inputs
+     * @returns 清理的条目数量
+     */
+    cleanupExpiredInputs(): number;
+}
+export declare const userInputRegistry: UserInputRegistry;
+//# sourceMappingURL=userInputRegistry.d.ts.map

package/services/askUserQuestion/userInputRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"userInputRegistry.d.ts","sourceRoot":"","sources":["../../../src/services/askUserQuestion/userInputRegistry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAGjE,YAAY,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAEjE,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,gBAAgB,CAAC;IAC1B,OAAO,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,MAAM,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CAChC;AAMD,cAAM,iBAAkB,SAAQ,YAAY;IAC1C,OAAO,CAAC,aAAa,CAA4C;IACjE,OAAO,CAAC,eAAe,CAA+B;IACtD,OAAO,CAAC,QAAQ,CAA8B;IAE9C;;;;;;;;;OASG;IACG,gBAAgB,CACpB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,gBAAgB,CAAC,WAAW,CAAC,GACvC,OAAO,CAAC,MAAM,CAAC;IAyClB;;;OAGG;IACH,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO;IAahE;;OAEG;IACH,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO;IAY5D;;OAEG;IACH,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAI3C;;OAEG;IACH,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI;IAK3D;;;;;OAKG;IACH,6BAA6B,CAC3B,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,SAAS,CAAC,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,MAAM,GACf;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE;IA0BvC;;OAEG;IACH,yBAAyB,CAAC,SAAS,EAAE,MAAM,GAAG,gBAAgB,EAAE;IAUhE;;OAEG;IACH,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM;IAa9D;;OAEG;IACH,QAAQ,IAAI;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE;IAiBrE;;;OAGG;IACH,eAAe,CAAC,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM;IAcnE;;;;;;OAMG;IACH,eAAe,CAAC,UAAU,GAAE,MAAoC,EAAE,QAAQ,GAAE,MAA2B,GAAG,IAAI;IAe9G;;OAEG;IACH,cAAc,IAAI,IAAI;IAQtB;;;OAGG;IACH,oBAAoB,IAAI,MAAM;CAoB/B;AAGD,eAAO,MAAM,iBAAiB,mBAA0B,CAAC"}

package/services/askUserQuestion/userInputRegistry.js

@@ -0,0 +1,253 @@
+"use strict";
+/**
+ * User Input Registry
+ *
+ * 管理等待用户输入的工具调用，使用 Promise 机制实现真正的阻塞
+ *
+ * 新架构：
+ * - 使用 sessionId + toolUseId 标识请求
+ * - 不再持有通知回调，改为发出事件
+ * - 通知由 NotificationChannelManager 处理
+ *
+ * 流程：
+ * 1. MCP 工具调用 waitForUserInput，创建 pending entry
+ * 2. Registry 发出 'awaiting_input' 事件
+ * 3. NotificationChannelManager 监听事件，发送通知
+ * 4. 用户提交答案，调用 submitUserResponse
+ * 5. Registry resolve Promise，MCP 工具返回
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.userInputRegistry = void 0;
+const events_1 = require("events");
+// 配置常量
+const DEFAULT_MAX_AGE_MS = 24 * 60 * 60 * 1000; // 24 小时
+const DEFAULT_CLEANUP_INTERVAL_MS = 60 * 60 * 1000; // 1 小时
+class UserInputRegistry extends events_1.EventEmitter {
+    pendingInputs = new Map();
+    cleanupInterval = null;
+    maxAgeMs = DEFAULT_MAX_AGE_MS;
+    /**
+     * 注册一个等待用户输入的请求
+     * 返回一个 Promise，在用户提交答案时 resolve
+     * 不设置超时，允许一直等待
+     *
+     * @param sessionId - 会话 ID
+     * @param agentId - Agent ID
+     * @param toolUseId - 工具调用 ID
+     * @param questions - 问题列表
+     */
+    async waitForUserInput(sessionId, agentId, toolUseId, questions) {
+        // 检查是否已存在
+        if (this.pendingInputs.has(toolUseId)) {
+            throw new Error(`Duplicate tool use ID: ${toolUseId}`);
+        }
+        console.log(`📝 [UserInputRegistry] Registering pending input for tool: ${toolUseId}, session: ${sessionId}`);
+        // 创建请求对象
+        const request = {
+            toolUseId,
+            sessionId,
+            agentId,
+            questions,
+            createdAt: Date.now(),
+        };
+        return new Promise((resolve, reject) => {
+            // 注册 pending entry（不设置超时）
+            const entry = {
+                request,
+                resolve: (response) => {
+                    this.pendingInputs.delete(toolUseId);
+                    console.log(`✅ [UserInputRegistry] Resolved input for tool: ${toolUseId}`);
+                    resolve(response);
+                },
+                reject: (error) => {
+                    this.pendingInputs.delete(toolUseId);
+                    console.log(`❌ [UserInputRegistry] Rejected input for tool: ${toolUseId}`, error.message);
+                    reject(error);
+                },
+            };
+            this.pendingInputs.set(toolUseId, entry);
+            // 发出事件，通知 NotificationChannelManager 发送通知
+            console.log(`📡 [UserInputRegistry] Emitting awaiting_input event for tool: ${toolUseId}`);
+            this.emit('awaiting_input', request);
+        });
+    }
+    /**
+     * 提交用户的答案
+     * 会 resolve 对应的 Promise，使 MCP 工具返回
+     */
+    submitUserResponse(toolUseId, response) {
+        const entry = this.pendingInputs.get(toolUseId);
+        if (!entry) {
+            console.warn(`⚠️ [UserInputRegistry] No pending input found for tool: ${toolUseId}`);
+            return false;
+        }
+        console.log(`📤 [UserInputRegistry] Submitting user response for tool: ${toolUseId}`);
+        entry.resolve(response);
+        return true;
+    }
+    /**
+     * 取消等待用户输入
+     */
+    cancelUserInput(toolUseId, reason) {
+        const entry = this.pendingInputs.get(toolUseId);
+        if (!entry) {
+            return false;
+        }
+        console.log(`🚫 [UserInputRegistry] Cancelling input for tool: ${toolUseId}`);
+        entry.reject(new Error(reason || 'User input cancelled'));
+        return true;
+    }
+    /**
+     * 检查是否有等待中的输入
+     */
+    hasPendingInput(toolUseId) {
+        return this.pendingInputs.has(toolUseId);
+    }
+    /**
+     * 获取 pending input 的请求信息（用于验证）
+     */
+    getPendingInput(toolUseId) {
+        const entry = this.pendingInputs.get(toolUseId);
+        return entry ? entry.request : null;
+    }
+    /**
+     * 验证并提交用户响应
+     * 验证 sessionId 和 agentId 是否匹配，防止伪造响应
+     *
+     * @returns { success: boolean; error?: string }
+     */
+    validateAndSubmitUserResponse(toolUseId, response, sessionId, agentId) {
+        const entry = this.pendingInputs.get(toolUseId);
+        if (!entry) {
+            return { success: false, error: 'No pending input found for this tool use ID' };
+        }
+        // 验证 sessionId（如果提供）
+        if (sessionId && entry.request.sessionId !== sessionId) {
+            console.warn(`⚠️ [UserInputRegistry] Session ID mismatch for tool: ${toolUseId}`);
+            console.warn(`   Expected: ${entry.request.sessionId}, Got: ${sessionId}`);
+            return { success: false, error: 'Session ID mismatch' };
+        }
+        // 验证 agentId（如果提供）
+        if (agentId && entry.request.agentId !== agentId) {
+            console.warn(`⚠️ [UserInputRegistry] Agent ID mismatch for tool: ${toolUseId}`);
+            console.warn(`   Expected: ${entry.request.agentId}, Got: ${agentId}`);
+            return { success: false, error: 'Agent ID mismatch' };
+        }
+        console.log(`📤 [UserInputRegistry] Validated and submitting user response for tool: ${toolUseId}`);
+        entry.resolve(response);
+        return { success: true };
+    }
+    /**
+     * 获取 session 的所有等待中的输入
+     */
+    getPendingInputsBySession(sessionId) {
+        const results = [];
+        for (const entry of this.pendingInputs.values()) {
+            if (entry.request.sessionId === sessionId) {
+                results.push(entry.request);
+            }
+        }
+        return results;
+    }
+    /**
+     * 取消 session 的所有等待中的输入
+     */
+    cancelAllBySession(sessionId, reason) {
+        let count = 0;
+        for (const [toolUseId, entry] of this.pendingInputs.entries()) {
+            if (entry.request.sessionId === sessionId) {
+                entry.reject(new Error(reason || 'Session terminated'));
+                this.pendingInputs.delete(toolUseId);
+                count++;
+            }
+        }
+        console.log(`🚫 [UserInputRegistry] Cancelled ${count} pending inputs for session: ${sessionId}`);
+        return count;
+    }
+    /**
+     * 获取统计信息
+     */
+    getStats() {
+        const now = Date.now();
+        let oldestAge = null;
+        for (const entry of this.pendingInputs.values()) {
+            const age = now - entry.request.createdAt;
+            if (oldestAge === null || age > oldestAge) {
+                oldestAge = age;
+            }
+        }
+        return {
+            totalPending: this.pendingInputs.size,
+            oldestPendingAge: oldestAge
+        };
+    }
+    /**
+     * 更新 session 的所有 pending inputs 的 sessionId
+     * 用于临时 sessionId 更新为真实 sessionId 的场景
+     */
+    updateSessionId(oldSessionId, newSessionId) {
+        let count = 0;
+        for (const entry of this.pendingInputs.values()) {
+            if (entry.request.sessionId === oldSessionId) {
+                entry.request.sessionId = newSessionId;
+                count++;
+            }
+        }
+        if (count > 0) {
+            console.log(`📡 [UserInputRegistry] Updated ${count} pending inputs from session ${oldSessionId} to ${newSessionId}`);
+        }
+        return count;
+    }
+    /**
+     * 启动定期清理任务
+     * 清理超过 maxAge 的过期 pending inputs
+     *
+     * @param intervalMs - 清理间隔（毫秒），默认 1 小时
+     * @param maxAgeMs - 最大存活时间（毫秒），默认 24 小时
+     */
+    startCleanupJob(intervalMs = DEFAULT_CLEANUP_INTERVAL_MS, maxAgeMs = DEFAULT_MAX_AGE_MS) {
+        if (this.cleanupInterval) {
+            console.warn('⚠️ [UserInputRegistry] Cleanup job already running');
+            return;
+        }
+        this.maxAgeMs = maxAgeMs;
+        this.cleanupInterval = setInterval(() => {
+            this.cleanupExpiredInputs();
+        }, intervalMs);
+        console.log(`🧹 [UserInputRegistry] Started cleanup job: interval=${intervalMs}ms, maxAge=${maxAgeMs}ms`);
+    }
+    /**
+     * 停止定期清理任务
+     */
+    stopCleanupJob() {
+        if (this.cleanupInterval) {
+            clearInterval(this.cleanupInterval);
+            this.cleanupInterval = null;
+            console.log('🛑 [UserInputRegistry] Stopped cleanup job');
+        }
+    }
+    /**
+     * 清理过期的 pending inputs
+     * @returns 清理的条目数量
+     */
+    cleanupExpiredInputs() {
+        const now = Date.now();
+        let count = 0;
+        for (const [toolUseId, entry] of this.pendingInputs.entries()) {
+            const age = now - entry.request.createdAt;
+            if (age > this.maxAgeMs) {
+                entry.reject(new Error(`Request expired after ${Math.round(age / 1000 / 60)} minutes`));
+                this.pendingInputs.delete(toolUseId);
+                count++;
+                console.log(`🗑️ [UserInputRegistry] Cleaned up expired input: ${toolUseId} (age: ${Math.round(age / 1000 / 60)} minutes)`);
+            }
+        }
+        if (count > 0) {
+            console.log(`🧹 [UserInputRegistry] Cleanup completed: removed ${count} expired inputs`);
+        }
+        return count;
+    }
+}
+// 单例实例
+exports.userInputRegistry = new UserInputRegistry();
+//# sourceMappingURL=userInputRegistry.js.map