@caoruhua/open-claude-remote 0.1.0 → 0.1.3

package/dist/backend/src/deps/prompt.js

@@ -0,0 +1,128 @@
+/**
+ * 交互式确认模块
+ */
+import * as readline from 'node:readline';
+import { DEPENDENCIES } from './types.js';
+/**
+ * 显示安装确认提示
+ * @returns true 表示用户确认安装，false 表示取消
+ */
+export async function promptInstall(options) {
+    const dep = DEPENDENCIES[options.name];
+    // 无 TTY 时自动确认（CI 环境）
+    if (!process.stdin.isTTY) {
+        return true;
+    }
+    // 构建提示内容
+    const lines = [
+        `${dep.displayName} is required but not installed.`,
+        '',
+        'Install method:',
+    ];
+    for (const cmd of options.installCommands) {
+        lines.push(`  ${cmd.command} ${cmd.args.join(' ')}`);
+    }
+    lines.push('');
+    lines.push(`Press Enter to install, or Ctrl+C to cancel:`);
+    // 计算边框宽度
+    const maxLineLength = Math.max(...lines.map((l) => l.length));
+    const boxWidth = maxLineLength + 4;
+    const border = '─'.repeat(boxWidth);
+    // 输出提示框
+    process.stderr.write(`\n┌${border}┐\n`);
+    for (const line of lines) {
+        process.stderr.write(`│ ${line.padEnd(boxWidth - 2)} │\n`);
+    }
+    process.stderr.write(`└${border}┘\n`);
+    // 等待用户按 Enter 或 Ctrl+C
+    return new Promise((resolve) => {
+        const rl = readline.createInterface({
+            input: process.stdin,
+            output: process.stderr,
+        });
+        // 处理 Ctrl+C (SIGINT)
+        const handleSigint = () => {
+            rl.close();
+            process.stderr.write('\nInstallation cancelled.\n');
+            resolve(false);
+        };
+        process.once('SIGINT', handleSigint);
+        rl.question('', () => {
+            process.off('SIGINT', handleSigint);
+            rl.close();
+            resolve(true); // Enter 继续安装
+        });
+        // 处理 readline 关闭事件（用户按 Ctrl+D 等）
+        rl.on('close', () => {
+            process.off('SIGINT', handleSigint);
+            // readline closed without question callback (e.g. Ctrl+D / EOF)
+            resolve(false);
+        });
+    });
+}
+/**
+ * 显示安装失败提示，提供手动安装帮助
+ */
+export function showManualInstallHelp(name, helpUrl) {
+    const dep = DEPENDENCIES[name];
+    process.stderr.write(`\n[ERROR] Cannot auto-install ${dep.displayName} on this system.\n`);
+    process.stderr.write(`Please install manually: ${helpUrl}\n`);
+}
+/**
+ * 显示安装开始信息
+ */
+export function showInstallStart(name) {
+    const dep = DEPENDENCIES[name];
+    process.stderr.write(`\n[Installing ${dep.displayName}...]\n`);
+}
+/**
+ * 显示命令执行信息
+ */
+export function showCommand(cmd, args) {
+    process.stderr.write(`> ${cmd} ${args.join(' ')}\n`);
+}
+/**
+ * 显示步骤成功
+ */
+export function showStepSuccess(message = 'Done') {
+    process.stderr.write(`  ✓ ${message}\n`);
+}
+/**
+ * 显示步骤失败
+ */
+export function showStepFailure(message = 'Failed') {
+    process.stderr.write(`  ✗ ${message}\n`);
+}
+/**
+ * 显示检测状态
+ */
+export function showCheckStatus(name, installed, version) {
+    const dep = DEPENDENCIES[name];
+    if (installed) {
+        process.stderr.write(`  ✓ ${dep.displayName} ${version ?? 'installed'}\n`);
+    }
+    else {
+        process.stderr.write(`  ✗ ${dep.displayName} not found\n`);
+    }
+}
+/**
+ * 显示依赖检测开始
+ */
+export function showCheckStart() {
+    process.stderr.write('Checking dependencies...\n');
+}
+/**
+ * 显示所有依赖就绪
+ */
+export function showAllReady() {
+    process.stderr.write('\nAll dependencies ready. Starting server...\n\n');
+}
+/**
+ * 显示依赖安装失败
+ */
+export function showInstallFailed(failed) {
+    process.stderr.write('\n[ERROR] Failed to install required dependencies.\n');
+    process.stderr.write('Please install manually and try again.\n');
+    process.stderr.write(`Missing: ${failed.join(', ')}\n`);
+}
+//# sourceMappingURL=prompt.js.map

package/dist/backend/src/deps/prompt.js.map

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

package/dist/backend/src/deps/types.d.ts

@@ -0,0 +1,40 @@
+/**
+ * 依赖检测与安装模块 - 类型定义
+ */
+export type DependencyName = 'node' | 'pnpm' | 'claude';
+export interface InstallCommand {
+    command: string;
+    args: string[];
+    description?: string;
+    timeout?: number;
+}
+export interface DependencyInfo {
+    name: DependencyName;
+    displayName: string;
+    checkCommand: string;
+    checkArgs: string[];
+    versionRegex: RegExp;
+    minVersion?: string;
+    installCommands?: InstallCommand[];
+    helpUrl: string;
+}
+export interface CheckResult {
+    installed: boolean;
+    version?: string;
+}
+export interface InstallResult {
+    success: boolean;
+    version?: string;
+    error?: Error;
+}
+export interface EnsureDepsResult {
+    allInstalled: boolean;
+    installed: DependencyName[];
+    failed: DependencyName[];
+}
+export declare const DEPENDENCIES: Record<DependencyName, DependencyInfo>;
+/**
+ * 解析版本字符串的主版本号
+ */
+export declare function parseMajorVersion(version: string): number;
+//# sourceMappingURL=types.d.ts.map

package/dist/backend/src/deps/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../backend/src/deps/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,CAAC;AAExD,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,cAAc,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,cAAc,EAAE,CAAC;IACnC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,KAAK,CAAC;CACf;AAED,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE,OAAO,CAAC;IACtB,SAAS,EAAE,cAAc,EAAE,CAAC;IAC5B,MAAM,EAAE,cAAc,EAAE,CAAC;CAC1B;AAED,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,cAAc,EAAE,cAAc,CA0C/D,CAAC;AAEF;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAGzD"}

package/dist/backend/src/deps/types.js

@@ -0,0 +1,54 @@
+/**
+ * 依赖检测与安装模块 - 类型定义
+ */
+export const DEPENDENCIES = {
+    node: {
+        name: 'node',
+        displayName: 'Node.js',
+        checkCommand: 'node',
+        checkArgs: ['--version'],
+        versionRegex: /^v?(\d+\.\d+\.\d+)/,
+        minVersion: '20',
+        helpUrl: 'https://nodejs.org/',
+    },
+    pnpm: {
+        name: 'pnpm',
+        displayName: 'pnpm',
+        checkCommand: 'pnpm',
+        checkArgs: ['--version'],
+        versionRegex: /^(\d+\.\d+\.\d+)/m,
+        minVersion: '9', // required for node-linker=hoisted default
+        installCommands: [
+            { command: 'corepack', args: ['enable'], timeout: 10000 },
+            {
+                command: 'corepack',
+                args: ['prepare', 'pnpm@latest', '--activate'],
+                timeout: 60000,
+            },
+        ],
+        helpUrl: 'https://pnpm.io/installation',
+    },
+    claude: {
+        name: 'claude',
+        displayName: 'Claude CLI',
+        checkCommand: 'claude',
+        checkArgs: ['--version'],
+        versionRegex: /^(\d+\.\d+\.\d+)/m,
+        installCommands: [
+            {
+                command: 'pnpm',
+                args: ['add', '-g', '@anthropic-ai/claude-code'],
+                timeout: 180000,
+            },
+        ],
+        helpUrl: 'https://docs.anthropic.com/en/docs/claude-code',
+    },
+};
+/**
+ * 解析版本字符串的主版本号
+ */
+export function parseMajorVersion(version) {
+    const match = version.match(/^v?(\d+)/);
+    return match ? parseInt(match[1], 10) : 0;
+}
+//# sourceMappingURL=types.js.map

package/dist/backend/src/deps/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../backend/src/deps/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAuCH,MAAM,CAAC,MAAM,YAAY,GAA2C;IAClE,IAAI,EAAE;QACJ,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,SAAS;QACtB,YAAY,EAAE,MAAM;QACpB,SAAS,EAAE,CAAC,WAAW,CAAC;QACxB,YAAY,EAAE,oBAAoB;QAClC,UAAU,EAAE,IAAI;QAChB,OAAO,EAAE,qBAAqB;KAC/B;IACD,IAAI,EAAE;QACJ,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,MAAM;QACnB,YAAY,EAAE,MAAM;QACpB,SAAS,EAAE,CAAC,WAAW,CAAC;QACxB,YAAY,EAAE,mBAAmB;QACjC,UAAU,EAAE,GAAG,EAAE,2CAA2C;QAC5D,eAAe,EAAE;YACf,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,QAAQ,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE;YACzD;gBACE,OAAO,EAAE,UAAU;gBACnB,IAAI,EAAE,CAAC,SAAS,EAAE,aAAa,EAAE,YAAY,CAAC;gBAC9C,OAAO,EAAE,KAAK;aACf;SACF;QACD,OAAO,EAAE,8BAA8B;KACxC;IACD,MAAM,EAAE;QACN,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,YAAY;QACzB,YAAY,EAAE,QAAQ;QACtB,SAAS,EAAE,CAAC,WAAW,CAAC;QACxB,YAAY,EAAE,mBAAmB;QACjC,eAAe,EAAE;YACf;gBACE,OAAO,EAAE,MAAM;gBACf,IAAI,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,2BAA2B,CAAC;gBAChD,OAAO,EAAE,MAAM;aAChB;SACF;QACD,OAAO,EAAE,gDAAgD;KAC1D;CACF,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAe;IAC/C,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IACxC,OAAO,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAC5C,CAAC"}

package/dist/backend/src/hooks/hook-receiver.d.ts

@@ -0,0 +1,39 @@
+import { EventEmitter } from 'node:events';
+import { type HookPayload, type HookNotification, type TaskCompletedData } from './hook-types.js';
+/**
+ * Structured result from processHook.
+ */
+export interface HookResult {
+    type: 'notification' | 'action' | 'ignored';
+    notification?: HookNotification;
+    action?: {
+        type: 'task_completed';
+        data: TaskCompletedData;
+    };
+}
+/**
+ * Receives and parses Hook HTTP POST from Claude Code.
+ * Emits 'notification' events for user attention events.
+ * Emits 'task_completed' events when Claude finishes responding.
+ */
+export declare class HookReceiver extends EventEmitter {
+    /**
+     * Process an incoming hook payload.
+     */
+    processHook(payload: HookPayload): HookResult;
+    /**
+     * 处理通知事件
+     */
+    private handleNotification;
+    /**
+     * 处理任务完成事件
+     * 不发送通知，而是触发 task_completed 事件以便 SessionController 更新状态
+     */
+    private handleStop;
+    /**
+     * 从消息中提取工具名
+     * Pattern: "Claude needs your permission to use <ToolName>"
+     */
+    private extractToolFromMessage;
+}
+//# sourceMappingURL=hook-receiver.d.ts.map

package/dist/backend/src/hooks/hook-receiver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-receiver.d.ts","sourceRoot":"","sources":["../../../../backend/src/hooks/hook-receiver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,EACL,KAAK,WAAW,EAGhB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EAIvB,MAAM,iBAAiB,CAAC;AAEzB;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,cAAc,GAAG,QAAQ,GAAG,SAAS,CAAC;IAC5C,YAAY,CAAC,EAAE,gBAAgB,CAAC;IAChC,MAAM,CAAC,EAAE;QACP,IAAI,EAAE,gBAAgB,CAAC;QACvB,IAAI,EAAE,iBAAiB,CAAC;KACzB,CAAC;CACH;AAeD;;;;GAIG;AACH,qBAAa,YAAa,SAAQ,YAAY;IAC5C;;OAEG;IACH,WAAW,CAAC,OAAO,EAAE,WAAW,GAAG,UAAU;IAsB7C;;OAEG;IACH,OAAO,CAAC,kBAAkB;IA+C1B;;;OAGG;IACH,OAAO,CAAC,UAAU;IAUlB;;;OAGG;IACH,OAAO,CAAC,sBAAsB;CAK/B"}

package/dist/backend/src/hooks/hook-receiver.js

@@ -0,0 +1,96 @@
+import { EventEmitter } from 'node:events';
+import { logger } from '../logger/logger.js';
+import { HookEventType, } from './hook-types.js';
+// 需要发送所有渠道通知的事件类型
+const ALL_CHANNELS = ['websocket', 'push', 'dingtalk', 'wechat_work'];
+// 需要处理的 Notification 类型
+const INTERACTIVE_NOTIFICATION_TYPES = [
+    'permission_prompt',
+    'idle_prompt',
+    'elicitation_dialog',
+];
+// Pattern: "Claude needs your permission to use <ToolName>"
+const PERMISSION_TOOL_RE = /permission to use (\S+)$/;
+/**
+ * Receives and parses Hook HTTP POST from Claude Code.
+ * Emits 'notification' events for user attention events.
+ * Emits 'task_completed' events when Claude finishes responding.
+ */
+export class HookReceiver extends EventEmitter {
+    /**
+     * Process an incoming hook payload.
+     */
+    processHook(payload) {
+        logger.info({ eventName: payload.hook_event_name }, 'Hook received');
+        switch (payload.hook_event_name) {
+            case 'Notification':
+                return this.handleNotification(payload);
+            case 'Stop':
+                return this.handleStop(payload);
+            default:
+                logger.debug({ eventName: payload.hook_event_name }, 'Hook event type not handled');
+                return { type: 'ignored' };
+        }
+    }
+    /**
+     * 处理通知事件
+     */
+    handleNotification(payload) {
+        const { notification_type, message, title } = payload;
+        // 仅处理需要用户交互的通知类型
+        if (!INTERACTIVE_NOTIFICATION_TYPES.includes(notification_type)) {
+            logger.debug({ notificationType: notification_type }, 'Non-interactive notification ignored');
+            return { type: 'ignored' };
+        }
+        // 从消息中提取工具名
+        const toolName = this.extractToolFromMessage(message) || 'claude';
+        // 根据通知类型生成标题
+        let notificationTitle;
+        switch (notification_type) {
+            case 'permission_prompt':
+                notificationTitle = title || 'Approval Required';
+                break;
+            case 'idle_prompt':
+                notificationTitle = title || 'Claude Waiting for Input';
+                break;
+            case 'elicitation_dialog':
+                notificationTitle = title || 'Waiting for Your Response';
+                break;
+            default:
+                notificationTitle = title || 'Claude Notification';
+        }
+        const notification = {
+            eventType: HookEventType.NOTIFICATION,
+            channels: ALL_CHANNELS,
+            tool: toolName,
+            title: notificationTitle,
+            message,
+        };
+        logger.info({ tool: toolName, notificationType: notification_type }, 'Notification event processed');
+        this.emit('notification', notification);
+        return { type: 'notification', notification };
+    }
+    /**
+     * 处理任务完成事件
+     * 不发送通知，而是触发 task_completed 事件以便 SessionController 更新状态
+     */
+    handleStop(payload) {
+        const data = {
+            lastMessage: payload.last_assistant_message,
+        };
+        logger.info('Stop event received, emitting task_completed');
+        this.emit('task_completed', data);
+        return { type: 'ignored' };
+    }
+    /**
+     * 从消息中提取工具名
+     * Pattern: "Claude needs your permission to use <ToolName>"
+     */
+    extractToolFromMessage(message) {
+        if (!message)
+            return null;
+        const match = PERMISSION_TOOL_RE.exec(message);
+        return match ? match[1] : null;
+    }
+}
+//# sourceMappingURL=hook-receiver.js.map

package/dist/backend/src/hooks/hook-receiver.js.map

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

package/dist/backend/src/hooks/hook-types.d.ts

@@ -0,0 +1,165 @@
+/**
+ * Claude Code Hook Payload 类型定义
+ * 参考: https://code.claude.com/docs/en/hooks
+ */
+export type HookEventName = 'SessionStart' | 'UserPromptSubmit' | 'PreToolUse' | 'PostToolUse' | 'PostToolUseFailure' | 'Notification' | 'SubagentStart' | 'SubagentStop' | 'Stop' | 'PreCompact';
+/**
+ * Notification 事件的通知类型
+ * - permission_prompt: 需要权限审批
+ * - idle_prompt: Claude 空闲等待输入
+ * - auth_success: 认证成功
+ * - elicitation_dialog: 用户问题对话框
+ */
+export type NotificationType = 'permission_prompt' | 'idle_prompt' | 'auth_success' | 'elicitation_dialog';
+export interface BaseHookPayload {
+    /** 当前会话标识 */
+    session_id?: string;
+    /** 会话 JSON 文件路径 */
+    transcript_path?: string;
+    /** hook 调用时的工作目录 */
+    cwd?: string;
+    /** 当前权限模式 */
+    permission_mode?: string;
+    /** 事件名称 */
+    hook_event_name: HookEventName;
+    /** 允许其他字段 */
+    [key: string]: unknown;
+}
+/** SessionStart: 会话开始或恢复 */
+export interface SessionStartPayload extends BaseHookPayload {
+    hook_event_name: 'SessionStart';
+    /** 会话启动方式 */
+    source?: 'startup' | 'resume' | 'clear' | 'compact';
+    /** 模型标识 */
+    model?: string;
+    /** agent 类型（如果以 --agent 启动） */
+    agent_type?: string;
+}
+/** UserPromptSubmit: 用户提交 prompt */
+export interface UserPromptSubmitPayload extends BaseHookPayload {
+    hook_event_name: 'UserPromptSubmit';
+    /** 用户提交的文本 */
+    prompt: string;
+}
+/** PreToolUse: 工具调用前 */
+export interface PreToolUsePayload extends BaseHookPayload {
+    hook_event_name: 'PreToolUse';
+    /** 工具名称 */
+    tool_name: string;
+    /** 工具输入参数 */
+    tool_input: Record<string, unknown>;
+    /** 工具调用 ID */
+    tool_use_id: string;
+}
+/** PostToolUse: 工具调用成功 */
+export interface PostToolUsePayload extends BaseHookPayload {
+    hook_event_name: 'PostToolUse';
+    /** 工具名称 */
+    tool_name: string;
+    /** 工具输入参数 */
+    tool_input: Record<string, unknown>;
+    /** 工具响应结果 */
+    tool_response: unknown;
+    /** 工具调用 ID */
+    tool_use_id: string;
+}
+/** PostToolUseFailure: 工具调用失败 */
+export interface PostToolUseFailurePayload extends BaseHookPayload {
+    hook_event_name: 'PostToolUseFailure';
+    /** 工具名称 */
+    tool_name: string;
+    /** 工具输入参数 */
+    tool_input: Record<string, unknown>;
+    /** 错误描述 */
+    error: string;
+    /** 是否为用户中断 */
+    is_interrupt?: boolean;
+    /** 工具调用 ID */
+    tool_use_id?: string;
+}
+/** Notification: 通知事件 */
+export interface NotificationPayload extends BaseHookPayload {
+    hook_event_name: 'Notification';
+    /** 通知消息 */
+    message: string;
+    /** 通知标题 */
+    title?: string;
+    /** 通知类型 */
+    notification_type: NotificationType;
+}
+/** SubagentStart: 子 agent 启动 */
+export interface SubagentStartPayload extends BaseHookPayload {
+    hook_event_name: 'SubagentStart';
+    /** 子 agent 唯一标识 */
+    agent_id: string;
+    /** agent 类型名称 */
+    agent_type: string;
+}
+/** SubagentStop: 子 agent 结束 */
+export interface SubagentStopPayload extends BaseHookPayload {
+    hook_event_name: 'SubagentStop';
+    /** 是否已有 stop hook 激活 */
+    stop_hook_active?: boolean;
+    /** 子 agent 唯一标识 */
+    agent_id: string;
+    /** agent 类型名称 */
+    agent_type: string;
+    /** 子 agent 的 transcript 路径 */
+    agent_transcript_path?: string;
+    /** 最后一条 assistant 消息 */
+    last_assistant_message?: string;
+}
+/** Stop: 主 agent 响应完成 */
+export interface StopPayload extends BaseHookPayload {
+    hook_event_name: 'Stop';
+    /** 是否已有 stop hook 激活 */
+    stop_hook_active: boolean;
+    /** 最后一条 assistant 消息 */
+    last_assistant_message?: string;
+}
+/** PreCompact: 压缩前 */
+export interface PreCompactPayload extends BaseHookPayload {
+    hook_event_name: 'PreCompact';
+    /** 触发方式 */
+    trigger: 'manual' | 'auto';
+    /** 自定义指令 */
+    custom_instructions?: string;
+}
+export type HookPayload = SessionStartPayload | UserPromptSubmitPayload | PreToolUsePayload | PostToolUsePayload | PostToolUseFailurePayload | NotificationPayload | SubagentStartPayload | SubagentStopPayload | StopPayload | PreCompactPayload;
+/**
+ * 通知事件类型（用于 HookNotification）
+ */
+export declare enum HookEventType {
+    /** 通知事件（permission_prompt, idle_prompt, elicitation_dialog 等） */
+    NOTIFICATION = "notification"
+}
+/**
+ * 通知渠道类型
+ */
+export type NotificationChannel = 'websocket' | 'push' | 'dingtalk' | 'wechat_work';
+/**
+ * 扩展的通知结构
+ * 用于 HookReceiver 向 SessionController 传递通知信息
+ */
+export interface HookNotification {
+    /** 事件类型 */
+    eventType: HookEventType;
+    /** 发送渠道列表 */
+    channels: NotificationChannel[];
+    /** 相关工具名称 */
+    tool: string;
+    /** 通知标题 */
+    title: string;
+    /** 通知消息 */
+    message: string;
+    /** 额外详情 */
+    detail?: string;
+}
+/**
+ * 任务完成事件数据
+ */
+export interface TaskCompletedData {
+    /** 最后一条消息 */
+    lastMessage?: string;
+}
+//# sourceMappingURL=hook-types.d.ts.map

package/dist/backend/src/hooks/hook-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-types.d.ts","sourceRoot":"","sources":["../../../../backend/src/hooks/hook-types.ts"],"names":[],"mappings":"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"}

package/dist/backend/src/hooks/hook-types.js

@@ -0,0 +1,16 @@
+/**
+ * Claude Code Hook Payload 类型定义
+ * 参考: https://code.claude.com/docs/en/hooks
+ */
+// ==============================
+// 通知相关类型
+// ==============================
+/**
+ * 通知事件类型（用于 HookNotification）
+ */
+export var HookEventType;
+(function (HookEventType) {
+    /** 通知事件（permission_prompt, idle_prompt, elicitation_dialog 等） */
+    HookEventType["NOTIFICATION"] = "notification";
+})(HookEventType || (HookEventType = {}));
+//# sourceMappingURL=hook-types.js.map

package/dist/backend/src/hooks/hook-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-types.js","sourceRoot":"","sources":["../../../../backend/src/hooks/hook-types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAwLH,iCAAiC;AACjC,SAAS;AACT,iCAAiC;AAEjC;;GAEG;AACH,MAAM,CAAN,IAAY,aAGX;AAHD,WAAY,aAAa;IACvB,iEAAiE;IACjE,8CAA6B,CAAA;AAC/B,CAAC,EAHW,aAAa,KAAb,aAAa,QAGxB"}

package/dist/backend/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../backend/src/index.ts"],"names":[],"mappings":"AASA,OAAO,EAAmI,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAmBjL,wBAAsB,WAAW,CAAC,YAAY,GAAE,YAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAoWhF"}