sessix-server 0.1.0

package/dist/notification/NotificationService.js

@@ -0,0 +1,177 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NotificationService = void 0;
+const node_path_1 = require("node:path");
+/**
+ * 通知服务
+ *
+ * 订阅 SessionManager 事件，根据事件类型构造通知内容，
+ * 并分发到所有已注册的通知渠道（Mac 本地通知、Expo Push 等）。
+ * 同时支持通过 ActivityPushChannel 更新 Live Activity。
+ */
+class NotificationService {
+    sessionManager;
+    expoChannel;
+    channelMap = new Map();
+    unsubscribe = null;
+    activityPushChannel = null;
+    /** YOLO 模式状态映射：sessionId -> isYoloMode */
+    yoloModeState = new Map();
+    constructor(sessionManager, expoChannel = null) {
+        this.sessionManager = sessionManager;
+        this.expoChannel = expoChannel;
+        this.unsubscribe = sessionManager.onEvent((event) => this.handleEvent(event));
+        if (expoChannel) {
+            this.channelMap.set('expo', { channel: expoChannel, enabled: true });
+        }
+    }
+    /** 添加通知渠道（id 唯一，可用于后续动态开关） */
+    addChannel(id, channel, enabled = true) {
+        this.channelMap.set(id, { channel, enabled });
+    }
+    /** 运行时切换指定渠道的启用状态 */
+    setChannelEnabled(id, enabled) {
+        const entry = this.channelMap.get(id);
+        if (entry)
+            entry.enabled = enabled;
+    }
+    /** 注册手机 push token（连接建立时由 WsBridge 调用） */
+    addPushToken(token) {
+        this.expoChannel?.addToken(token);
+    }
+    /** 移除手机 push token（断线时或手机主动注销时调用） */
+    removePushToken(token) {
+        this.expoChannel?.removeToken(token);
+    }
+    /** 设置 ActivityKit Push 渠道（可选，需要 APNs 认证配置） */
+    setActivityPushChannel(channel) {
+        this.activityPushChannel = channel;
+    }
+    /** 注册 ActivityKit push token（由手机端启动 Live Activity 后上报） */
+    addActivityPushToken(sessionId, token) {
+        this.activityPushChannel?.addToken(sessionId, token);
+    }
+    /** 移除 ActivityKit push token */
+    removeActivityPushToken(sessionId) {
+        this.activityPushChannel?.removeToken(sessionId);
+    }
+    /** 更新会话的 YOLO 模式状态 */
+    setYoloMode(sessionId, enabled) {
+        this.yoloModeState.set(sessionId, enabled);
+    }
+    /** 直接触发审批通知（由 ApprovalProxy 回调调用） */
+    notifyApproval(request) {
+        // YOLO 模式：客户端会自动批准，不发推送
+        if (this.yoloModeState.get(request.sessionId))
+            return;
+        const projectName = this.getProjectName(request.sessionId);
+        this.notify({
+            title: `需要授权 — ${projectName}`,
+            body: `${request.toolName}: ${request.description}`,
+            sound: 'Funk',
+            data: {
+                type: 'approval_request',
+                sessionId: request.sessionId,
+                requestId: request.id,
+            },
+        });
+        // 通过 APNs 更新 Live Activity（显示审批请求）
+        if (this.activityPushChannel?.hasToken(request.sessionId)) {
+            const dangerLevel = this.getDangerLevel(request.toolName);
+            const isYoloMode = this.getYoloMode(request.sessionId);
+            this.activityPushChannel.updateActivityWithAlert(request.sessionId, {
+                status: 'waitingApproval',
+                latestMessage: `${request.toolName}: ${request.description}`,
+                approvalInfo: {
+                    requestId: request.id,
+                    toolName: request.toolName,
+                    description: request.description.slice(0, 80),
+                    dangerLevel,
+                },
+                isYoloMode,
+                updatedAt: Date.now(),
+            }, {
+                title: `需要授权 — ${projectName}`,
+                body: `${request.toolName}: ${request.description}`,
+            });
+        }
+    }
+    /** 简单的工具危险等级判断 */
+    getDangerLevel(toolName) {
+        if (toolName === 'Bash')
+            return 'danger';
+        if (['Write', 'Edit', 'NotebookEdit'].includes(toolName))
+            return 'write';
+        return 'safe';
+    }
+    /** 清理资源 */
+    destroy() {
+        this.unsubscribe?.();
+        this.unsubscribe = null;
+        this.yoloModeState.clear();
+    }
+    // ============================================
+    // 内部方法
+    // ============================================
+    handleEvent(event) {
+        switch (event.type) {
+            case 'status_change': {
+                if (event.status === 'idle') {
+                    const projectName = this.getProjectName(event.sessionId);
+                    const isYoloMode = this.getYoloMode(event.sessionId);
+                    this.notify({
+                        title: `任务完成 — ${projectName}`,
+                        body: '已完成，等待下一步指令',
+                        sound: 'Glass',
+                        data: { type: 'task_complete', sessionId: event.sessionId },
+                    });
+                    // 通过 APNs 结束 Live Activity
+                    this.activityPushChannel?.endActivity(event.sessionId, {
+                        status: 'idle',
+                        latestMessage: '已完成，等待下一步指令',
+                        isYoloMode,
+                        updatedAt: Date.now(),
+                    });
+                }
+                else if (event.status === 'error') {
+                    const projectName = this.getProjectName(event.sessionId);
+                    const isYoloMode = this.getYoloMode(event.sessionId);
+                    this.notify({
+                        title: `出错了 — ${projectName}`,
+                        body: '执行出错，请查看详情',
+                        sound: 'Basso',
+                        data: { type: 'task_error', sessionId: event.sessionId },
+                    });
+                    // 通过 APNs 结束 Live Activity
+                    this.activityPushChannel?.endActivity(event.sessionId, {
+                        status: 'error',
+                        latestMessage: '执行出错，请查看详情',
+                        isYoloMode,
+                        updatedAt: Date.now(),
+                    });
+                }
+                break;
+            }
+            // 其他事件不发通知
+        }
+    }
+    notify(payload) {
+        for (const { channel, enabled } of this.channelMap.values()) {
+            if (!enabled)
+                continue;
+            channel.send(payload).catch((err) => {
+                console.error('[NotificationService] 通知发送失败:', err);
+            });
+        }
+    }
+    getProjectName(sessionId) {
+        const session = this.sessionManager.getActiveSessions().find((s) => s.id === sessionId);
+        return session ? (0, node_path_1.basename)(session.projectPath) : 'Unknown';
+    }
+    /** 获取会话的 YOLO 模式状态 */
+    getYoloMode(sessionId) {
+        return this.yoloModeState.get(sessionId) ?? false;
+    }
+}
+exports.NotificationService = NotificationService;
+//# sourceMappingURL=NotificationService.js.map

package/dist/notification/NotificationService.js.map

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

package/dist/providers/ExecutionProvider.d.ts

@@ -0,0 +1,60 @@
+import type { Session, ClaudeStreamEvent } from '@sessix/shared';
+/** 启动会话的选项 */
+export interface StartSessionOptions {
+    /** 项目的绝对路径 */
+    projectPath: string;
+    /** 发送给 Claude 的消息 */
+    message: string;
+    /** 恢复已有会话时传入该会话的 ID（使用 --resume） */
+    sessionId?: string;
+    /** true = --resume（恢复）；false = --session-id（新建但指定 ID）；默认跟随 sessionId 是否存在 */
+    resume?: boolean;
+    /** 使用的模型别名（haiku / sonnet / opus），不传则用 claude 默认 */
+    model?: string;
+}
+/**
+ * 执行提供者接口
+ *
+ * 所有控制 Claude CLI 进程的操作必须通过此接口，
+ * 当前实现为 ProcessProvider（直接 spawn 进程），
+ * 未来可替换为 DockerProvider 等其他实现。
+ */
+export interface ExecutionProvider {
+    /** 启动新会话或恢复已有会话 */
+    startSession(opts: StartSessionOptions): Promise<Session>;
+    /** 终止指定会话 */
+    killSession(sessionId: string): Promise<void>;
+    /** 向已有会话发送新消息（会重启进程并携带相同 session-id） */
+    sendMessage(sessionId: string, message: string): Promise<void>;
+    /** 订阅指定会话的 Claude 事件流，返回取消订阅函数 */
+    onEvent(sessionId: string, callback: (event: ClaudeStreamEvent) => void): () => void;
+    /** 获取当前所有活跃会话列表 */
+    getActiveSessions(): Session[];
+    /**
+     * 根据对话上下文生成下一步建议指令（一次性调用，不关联任何会话）
+     *
+     * @param context 最近的对话内容（格式化为纯文本）
+     * @returns 建议的指令文本
+     */
+    generateSuggestion(context: string): Promise<string>;
+    /**
+     * 向正在等待中的 AskUserQuestion 提供答案
+     *
+     * 通过 stdin 写入 tool_result 让 Claude 继续执行。
+     * @param sessionId 会话 ID
+     * @param toolUseId AskUserQuestion tool_use 块的 id
+     * @param answer 用户的答案文本
+     */
+    answerQuestion(sessionId: string, toolUseId: string, answer: string): Promise<void>;
+    /**
+     * 订阅指定会话的 AskUserQuestion 事件
+     *
+     * @returns 取消订阅函数
+     */
+    onQuestion(sessionId: string, callback: (data: {
+        toolUseId: string;
+        question: string;
+        options?: string[];
+    }) => void): () => void;
+}
+//# sourceMappingURL=ExecutionProvider.d.ts.map

package/dist/providers/ExecutionProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExecutionProvider.d.ts","sourceRoot":"","sources":["../../src/providers/ExecutionProvider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAMhE,cAAc;AACd,MAAM,WAAW,mBAAmB;IAClC,cAAc;IACd,WAAW,EAAE,MAAM,CAAA;IACnB,qBAAqB;IACrB,OAAO,EAAE,MAAM,CAAA;IACf,oCAAoC;IACpC,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,6EAA6E;IAC7E,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,oDAAoD;IACpD,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IAChC,mBAAmB;IACnB,YAAY,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IAEzD,aAAa;IACb,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAE7C,wCAAwC;IACxC,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAE9D,kCAAkC;IAClC,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,GAAG,MAAM,IAAI,CAAA;IAEpF,mBAAmB;IACnB,iBAAiB,IAAI,OAAO,EAAE,CAAA;IAE9B;;;;;OAKG;IACH,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IAEpD;;;;;;;OAOG;IACH,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAEnF;;;;OAIG;IACH,UAAU,CACR,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,CAAC,IAAI,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,KAAK,IAAI,GACpF,MAAM,IAAI,CAAA;CACd"}

package/dist/providers/ExecutionProvider.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=ExecutionProvider.js.map

package/dist/providers/ExecutionProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExecutionProvider.js","sourceRoot":"","sources":["../../src/providers/ExecutionProvider.ts"],"names":[],"mappings":""}

package/dist/providers/ProcessProvider.d.ts

@@ -0,0 +1,117 @@
+import type { Session, ClaudeStreamEvent } from '@sessix/shared';
+import type { ExecutionProvider, StartSessionOptions } from './ExecutionProvider.js';
+/**
+ * 基于 child_process.spawn 的 ExecutionProvider 实现
+ *
+ * 直接在本机通过 spawn 启动 `claude` CLI 进程，
+ * 从 stdout 逐行读取 NDJSON 格式的 stream-json 事件。
+ */
+export declare class ProcessProvider implements ExecutionProvider {
+    /** 活跃会话映射表：sessionId -> { session, process } */
+    private activeSessions;
+    /** 事件发射器，用于分发 Claude 事件流 */
+    private emitter;
+    /**
+     * 启动新会话或恢复已有会话
+     *
+     * 会 spawn 一个 `claude` CLI 进程，设置工作目录和环境变量，
+     * 并开始监听 stdout 的 NDJSON 输出。
+     */
+    startSession(opts: StartSessionOptions): Promise<Session>;
+    /**
+     * 终止指定会话
+     *
+     * kill 进程并从活跃映射中移除。
+     */
+    killSession(sessionId: string): Promise<void>;
+    /**
+     * 向已有会话发送新消息
+     *
+     * 快速路径：进程存活时直接写 stdin（毫秒级响应）。
+     * 慢速路径：进程已退出时 respawn 并 --resume。
+     */
+    sendMessage(sessionId: string, message: string): Promise<void>;
+    /**
+     * 订阅指定会话的 Claude 事件流
+     *
+     * @returns 取消订阅函数
+     */
+    onEvent(sessionId: string, callback: (event: ClaudeStreamEvent) => void): () => void;
+    /**
+     * 获取当前所有活跃会话列表
+     */
+    getActiveSessions(): Session[];
+    /**
+     * 启动 claude CLI 进程（持久模式，stdin 保持开放接收多条消息）
+     */
+    private spawnClaudeProcess;
+    /**
+     * 向持久进程的 stdin 写入一条用户消息（NDJSON 格式）
+     *
+     * 写入失败时合成 error result 事件，确保 SessionManager 能感知到失败。
+     */
+    private writeUserMessage;
+    /**
+     * 发出写入失败的合成错误事件
+     */
+    private emitWriteError;
+    /**
+     * 挂载 stdout 监听器，逐行解析 NDJSON
+     */
+    private attachStdoutListener;
+    /**
+     * 挂载 stderr 监听器，记录日志
+     */
+    private attachStderrListener;
+    /**
+     * 挂载进程退出监听器
+     *
+     * 当进程退出时发出合成的 result 事件，确保 SessionManager 能感知到退出。
+     * 正常退出时 Claude 会先通过 stdout 发送真实 result 事件，
+     * updateSessionStatus 会将 session.status 更新为 idle/error。
+     * 此时合成事件会重复触发，导致手机端出现两张总结卡。
+     * 修复：已收到真实 result（status 已为 idle/error）时跳过合成事件。
+     * 异常退出时（crash/OOM/killed）没有真实 result 事件，合成事件确保状态正确广播。
+     */
+    private attachExitListener;
+    /**
+     * 解析一行 NDJSON 文本为 ClaudeStreamEvent
+     */
+    private parseLine;
+    /**
+     * 根据 Claude 事件更新会话状态
+     */
+    private updateSessionStatus;
+    /**
+     * 根据对话上下文生成下一步建议指令
+     *
+     * 使用 --output-format text 做一次性调用，返回纯文本结果。
+     */
+    generateSuggestion(context: string): Promise<string>;
+    /**
+     * 向正在等待中的 AskUserQuestion 提供答案
+     *
+     * 将答案写入 Claude 进程的 stdin（作为 tool_result），
+     * Claude 收到后继续执行。
+     */
+    answerQuestion(sessionId: string, toolUseId: string, answer: string): Promise<void>;
+    /**
+     * 订阅指定会话的 AskUserQuestion 事件
+     *
+     * @returns 取消订阅函数
+     */
+    onQuestion(sessionId: string, callback: (data: {
+        toolUseId: string;
+        question: string;
+        options?: string[];
+    }) => void): () => void;
+    /**
+     * 生成事件名称
+     */
+    private getEventName;
+    /**
+     * 生成 AskUserQuestion 内部事件名称
+     */
+    private getQuestionEventName;
+}
+//# sourceMappingURL=ProcessProvider.d.ts.map

package/dist/providers/ProcessProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProcessProvider.d.ts","sourceRoot":"","sources":["../../src/providers/ProcessProvider.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,OAAO,EAAE,iBAAiB,EAAU,MAAM,gBAAgB,CAAA;AACxE,OAAO,KAAK,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAA;AA0CpF;;;;;GAKG;AACH,qBAAa,eAAgB,YAAW,iBAAiB;IACvD,gDAAgD;IAChD,OAAO,CAAC,cAAc,CAA6C;IAEnE,4BAA4B;IAC5B,OAAO,CAAC,OAAO,CAAmC;IAElD;;;;;OAKG;IACG,YAAY,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,OAAO,CAAC;IA+D/D;;;;OAIG;IACG,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiCnD;;;;;OAKG;IACG,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAgDpE;;;;OAIG;IACH,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,GAAG,MAAM,IAAI;IAUpF;;OAEG;IACH,iBAAiB,IAAI,OAAO,EAAE;IAQ9B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAuC1B;;;;OAIG;IACH,OAAO,CAAC,gBAAgB;IAwBxB;;OAEG;IACH,OAAO,CAAC,cAAc;IAatB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAgD5B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAW5B;;;;;;;;;OASG;IACH,OAAO,CAAC,kBAAkB;IA0C1B;;OAEG;IACH,OAAO,CAAC,SAAS;IAYjB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IA0B3B;;;;OAIG;IACG,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAgC1D;;;;;OAKG;IACG,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA2BzF;;;;OAIG;IACH,UAAU,CACR,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,CAAC,IAAI,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,KAAK,IAAI,GACpF,MAAM,IAAI;IAQb;;OAEG;IACH,OAAO,CAAC,YAAY;IAIpB;;OAEG;IACH,OAAO,CAAC,oBAAoB;CAG7B"}