sessix-server 0.1.0

package/dist/hooks/HookInstaller.js

@@ -0,0 +1,215 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HookInstaller = void 0;
+const promises_1 = require("node:fs/promises");
+const node_path_1 = require("node:path");
+const node_os_1 = require("node:os");
+/** Sessix hook 脚本存放目录 */
+const SESSIX_HOOKS_DIR = (0, node_path_1.join)((0, node_os_1.homedir)(), '.sessix', 'hooks');
+/** Hook 脚本文件路径 */
+const HOOK_SCRIPT_PATH = (0, node_path_1.join)(SESSIX_HOOKS_DIR, 'approval-hook.sh');
+/** Claude Code settings.json 路径 */
+const CLAUDE_SETTINGS_PATH = (0, node_path_1.join)((0, node_os_1.homedir)(), '.claude', 'settings.json');
+/** hook 脚本命令（使用 ~ 前缀，Claude Code 会展开） */
+const HOOK_COMMAND = '~/.sessix/hooks/approval-hook.sh';
+/**
+ * approval-hook.sh 脚本模板
+ *
+ * 仅在 Sessix 管理的会话中激活（检查 SESSIX_SESSION_ID 环境变量）。
+ * 将 hook payload 发送到 Sessix HTTP 审批端点，等待用户决定。
+ * 通过 exit code 向 Claude Code 报告批准结果：
+ * - exit 0: 批准（用户同意或服务器超时自动批准）
+ * - exit 1: 拒绝（用户明确拒绝）
+ */
+const HOOK_SCRIPT_TEMPLATE = `#!/bin/bash
+# Sessix Approval Hook
+# 仅在 Sessix 管理的会话中激活
+
+if [ -z "$SESSIX_SESSION_ID" ]; then
+  exit 0
+fi
+
+# 从 stdin 读取 hook payload
+PAYLOAD=$(cat)
+
+# 获取项目路径（当前工作目录）
+PROJECT_PATH="$PWD"
+
+# 发送审批请求到 Sessix 服务器（长轮询，超时时间 > 300s）
+RESPONSE=$(curl -s -X POST "http://localhost:3746/hook/approval" \\
+  -H "Content-Type: application/json" \\
+  -d "{\\"sessionId\\": \\"$SESSIX_SESSION_ID\\", \\"projectPath\\": \\"$PROJECT_PATH\\", \\"payload\\": $PAYLOAD}" \\
+  --max-time 330 \\
+  2>/dev/null)
+
+if [ $? -ne 0 ] || [ -z "$RESPONSE" ]; then
+  # 如果 Sessix 服务器不可用，默认放行（exit 0 = 批准）
+  exit 0
+fi
+
+# 解析服务器响应
+DECISION=\$(echo "$RESPONSE" | grep -o '\\"decision\\":\\"[^"]*\\"' | cut -d'"' -f4)
+
+if [ "$DECISION" = "allow" ]; then
+  # 用户批准或服务器超时自动批准
+  exit 0
+elif [ "$DECISION" = "deny" ]; then
+  # 用户明确拒绝
+  exit 1
+else
+  # 未知响应，默认放行
+  exit 0
+fi
+`;
+/**
+ * Hook 安装器
+ *
+ * 负责将 Sessix 的审批 hook 脚本安装到 Claude Code 中：
+ * 1. 创建 ~/.sessix/hooks/ 目录并写入 approval-hook.sh
+ * 2. 在 ~/.claude/settings.json 中注册 PreToolUse hook
+ */
+class HookInstaller {
+    /**
+     * 安装 hook
+     *
+     * 1. 创建 ~/.sessix/hooks/ 目录
+     * 2. 写入 approval-hook.sh 脚本
+     * 3. 赋予执行权限
+     * 4. 更新 Claude Code settings.json 添加 hook 配置
+     */
+    async install() {
+        // 1. 创建 hooks 目录
+        await (0, promises_1.mkdir)(SESSIX_HOOKS_DIR, { recursive: true });
+        // 2. 写入 hook 脚本
+        await (0, promises_1.writeFile)(HOOK_SCRIPT_PATH, HOOK_SCRIPT_TEMPLATE, 'utf-8');
+        // 3. 添加执行权限
+        await (0, promises_1.chmod)(HOOK_SCRIPT_PATH, 0o755);
+        // 4. 更新 Claude Code settings.json
+        await this.addHookToSettings();
+        console.log('[HookInstaller] Hook 安装完成');
+    }
+    /**
+     * 卸载 hook
+     *
+     * 从 Claude Code settings.json 中移除 Sessix hook 配置。
+     * 注意：不删除 hook 脚本文件（保持幂等性，避免误删）。
+     */
+    async uninstall() {
+        await this.removeHookFromSettings();
+        console.log('[HookInstaller] Hook 已卸载');
+    }
+    /**
+     * 检查 hook 是否已安装
+     * 脚本文件和 settings.json 配置必须同时存在才算已安装
+     */
+    async isInstalled() {
+        // 检查脚本文件是否存在
+        let scriptExists = false;
+        try {
+            await (0, promises_1.access)(HOOK_SCRIPT_PATH);
+            scriptExists = true;
+        }
+        catch {
+            // 脚本不存在
+        }
+        // 检查 settings.json 中是否有 Sessix hook 配置
+        const settings = await this.readClaudeSettings();
+        const configExists = this.hasHookConfig(settings);
+        // 两者都存在才算已安装
+        return scriptExists && configExists;
+    }
+    // ============================================
+    // 内部方法
+    // ============================================
+    /**
+     * 向 Claude Code settings.json 添加 Sessix hook 配置
+     */
+    async addHookToSettings() {
+        let settings = await this.readClaudeSettings();
+        // 如果已经存在，跳过
+        if (this.hasHookConfig(settings)) {
+            console.log('[HookInstaller] Hook 配置已存在，跳过');
+            return;
+        }
+        // 确保 hooks 和 PreToolUse 结构存在
+        if (!settings.hooks) {
+            settings.hooks = {};
+        }
+        if (!settings.hooks.PreToolUse) {
+            settings.hooks.PreToolUse = [];
+        }
+        // 添加 Sessix hook 配置
+        settings.hooks.PreToolUse.push({
+            matcher: '',
+            hooks: [
+                {
+                    type: 'command',
+                    command: HOOK_COMMAND,
+                },
+            ],
+        });
+        await this.writeClaudeSettings(settings);
+    }
+    /**
+     * 从 Claude Code settings.json 移除 Sessix hook 配置
+     */
+    async removeHookFromSettings() {
+        let settings = await this.readClaudeSettings();
+        if (!settings.hooks?.PreToolUse) {
+            return;
+        }
+        // 过滤掉包含 Sessix hook 命令的条目
+        settings.hooks.PreToolUse = settings.hooks.PreToolUse.filter((entry) => !this.isSessionHookEntry(entry));
+        // 如果 PreToolUse 为空，删除它
+        if (settings.hooks.PreToolUse.length === 0) {
+            delete settings.hooks.PreToolUse;
+        }
+        // 如果 hooks 为空，删除它
+        if (Object.keys(settings.hooks).length === 0) {
+            delete settings.hooks;
+        }
+        await this.writeClaudeSettings(settings);
+    }
+    /**
+     * 读取 Claude Code settings.json
+     */
+    async readClaudeSettings() {
+        try {
+            const content = await (0, promises_1.readFile)(CLAUDE_SETTINGS_PATH, 'utf-8');
+            return JSON.parse(content);
+        }
+        catch {
+            // 文件不存在或解析失败，返回空对象
+            return {};
+        }
+    }
+    /**
+     * 写入 Claude Code settings.json
+     */
+    async writeClaudeSettings(settings) {
+        // 确保 .claude 目录存在
+        await (0, promises_1.mkdir)((0, node_path_1.join)((0, node_os_1.homedir)(), '.claude'), { recursive: true });
+        await (0, promises_1.writeFile)(CLAUDE_SETTINGS_PATH, JSON.stringify(settings, null, 2) + '\n', 'utf-8');
+    }
+    /**
+     * 检查 settings 中是否已包含 Sessix hook 配置
+     */
+    hasHookConfig(settings) {
+        const preToolUse = settings?.hooks?.PreToolUse;
+        if (!Array.isArray(preToolUse)) {
+            return false;
+        }
+        return preToolUse.some((entry) => this.isSessionHookEntry(entry));
+    }
+    /**
+     * 判断一个 hook 条目是否是 Sessix 的
+     */
+    isSessionHookEntry(entry) {
+        if (!entry?.hooks || !Array.isArray(entry.hooks)) {
+            return false;
+        }
+        return entry.hooks.some((hook) => hook.type === 'command' && hook.command === HOOK_COMMAND);
+    }
+}
+exports.HookInstaller = HookInstaller;
+//# sourceMappingURL=HookInstaller.js.map

package/dist/hooks/HookInstaller.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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