agentwake 1.0.0

package/.cursor/hooks.json

@@ -0,0 +1,15 @@
+{
+  "version": 1,
+  "hooks": {
+    "beforeShellExecution": [
+      {
+        "command": "sh -lc 'CAROOT=\"$(mkcert -CAROOT 2>/dev/null)\"; EXTRA_CA=\"${NODE_EXTRA_CA_CERTS:-$CAROOT/rootCA.pem}\"; AGENTWAKE_GATEWAY_URL=\"${AGENTWAKE_GATEWAY_URL:-https://127.0.0.1:3199/hooks/cursor}\" NODE_EXTRA_CA_CERTS=\"$EXTRA_CA\" AGENTWAKE_CURSOR_APPROVAL_MODE=\"${AGENTWAKE_CURSOR_APPROVAL_MODE:-cursor-ask}\" AGENTWAKE_CURSOR_ENFORCE_ASK=\"${AGENTWAKE_CURSOR_ENFORCE_ASK:-0}\" node \"./scripts/cursor-hook-forwarder.mjs\"'"
+      }
+    ],
+    "afterShellExecution": [
+      {
+        "command": "sh -lc 'CAROOT=\"$(mkcert -CAROOT 2>/dev/null)\"; EXTRA_CA=\"${NODE_EXTRA_CA_CERTS:-$CAROOT/rootCA.pem}\"; AGENTWAKE_GATEWAY_URL=\"${AGENTWAKE_GATEWAY_URL:-https://127.0.0.1:3199/hooks/cursor}\" NODE_EXTRA_CA_CERTS=\"$EXTRA_CA\" AGENTWAKE_CURSOR_APPROVAL_MODE=\"${AGENTWAKE_CURSOR_APPROVAL_MODE:-cursor-ask}\" AGENTWAKE_CURSOR_ENFORCE_ASK=\"${AGENTWAKE_CURSOR_ENFORCE_ASK:-0}\" node \"./scripts/cursor-hook-forwarder.mjs\"'"
+      }
+    ]
+  }
+}

package/.env.example

@@ -0,0 +1,19 @@
+AGENTWAKE_HOST=0.0.0.0
+AGENTWAKE_PORT=3199
+AGENTWAKE_HTTPS_ENABLED=1
+AGENTWAKE_HTTPS_CERT_PATH=certs/dev-cert.pem
+AGENTWAKE_HTTPS_KEY_PATH=certs/dev-key.pem
+AGENTWAKE_CURSOR_HOOK_PATH=/hooks/cursor
+AGENTWAKE_CLAUDE_HOOK_PATH=/hooks/claude
+AGENTWAKE_QODER_LOG_PATH=/path/to/qoder.log
+AGENTWAKE_WS_PATH=/ws
+AGENTWAKE_DEDUPE_WINDOW_MS=10000
+AGENTWAKE_RATE_LIMIT_WINDOW_MS=10000
+AGENTWAKE_RATE_LIMIT_MAX_EVENTS=40
+AGENTWAKE_ALLOWED_HOOK_IPS=
+AGENTWAKE_VAPID_SUBJECT=mailto:agentwake@example.com
+AGENTWAKE_DESKTOP_MODE=notification
+AGENTWAKE_CURSOR_APPROVAL_MODE=cursor-ask
+AGENTWAKE_CURSOR_ENFORCE_ASK=0
+# AGENTWAKE_VAPID_PUBLIC_KEY=
+# AGENTWAKE_VAPID_PRIVATE_KEY=

package/README.md

@@ -0,0 +1,137 @@
+# AgentWake 🚀
+
+**AgentWake** 是一个跨编辑器（Cursor / Claude Code / Qoder）的终端授权提醒网关。  
+当你在使用 AI 辅助编程工具时，终端任务经常会进入“等待用户同意（Approval）”状态。AgentWake 会在桌面和移动端为你提供实时通知，让你无需时刻盯着屏幕，告别阻塞等待！
+
+---
+
+## 🌟 核心特性
+
+- **多编辑器支持**：原生支持监听 Cursor Hook、Claude Hook 以及 Qoder 日志中的授权等待信号。
+- **全平台桌面通知**：支持 macOS、Windows、Linux 的系统级弹窗提醒。
+- **移动端实时提醒**：内置移动端 Web 应用，支持 PWA 安装，通过 HTTPS + WebSocket 实现手机端毫秒级推送。
+- **智能防打扰**：内置去重和限流机制，避免消息重复轰炸。
+- **开箱即用**：提供极简的 CLI 命令行工具，一键初始化与启动。
+
+---
+
+## 🚀 快速开始
+
+### 环境要求
+
+- Node.js (推荐 v18+)
+- [mkcert](https://github.com/FiloSottile/mkcert) (用于生成本地 HTTPS 证书，移动端访问必备)
+
+### 安装与启动
+
+1. **全局安装 CLI**
+   ```bash
+   npm i -g agentwake
+   ```
+
+2. **初始化项目与证书**
+   ```bash
+   mkdir my-agentwake && cd my-agentwake
+   agentwake init
+   ```
+   *注意：初始化过程中会自动使用 mkcert 生成本地 HTTPS 证书。*
+
+3. **启动网关服务**
+   ```bash
+   agentwake start
+   ```
+
+启动后，网关默认运行在 `https://localhost:3199` (或者局域网 IP)。
+
+---
+
+## 🔌 编辑器接入指南
+
+### Cursor 接入
+
+AgentWake 已经内置了对 Cursor 工作流的支持：
+1. 确保在目标项目中执行过 `agentwake init`。
+2. 保持 `agentwake start` 运行。
+3. 当 Cursor 终端触发需要用户授权的命令时，你将立刻收到通知。
+
+### Qoder 接入
+
+AgentWake 会尝试自动发现 Qoder 的日志目录（如 macOS 下的 `~/Library/Application Support/Qoder/logs/.../agent.log`）。
+
+如果自动发现失败，你可以通过环境变量手动指定日志路径：
+```bash
+AGENTWAKE_QODER_LOG_PATH="/ABSOLUTE/PATH/TO/agent.log" agentwake start
+```
+
+---
+
+## 📱 移动端访问与证书信任（必读）
+
+为了在手机上接收实时通知，你必须让手机信任电脑上由 `mkcert` 生成的根证书。
+
+1. 找到根证书位置：
+   在电脑终端运行 `mkcert -CAROOT`，找到目录下的 `rootCA.pem` 文件。
+2. 安装到手机：
+   - **iOS**：将文件发送到手机，在“设置”中安装描述文件，并在“通用 -> 关于本机 -> 证书信任设置”中开启“完全信任”。
+   - **Android**：将文件发送到手机，在安全设置中“从存储设备安装” CA 证书（部分安卓系统可能需要将后缀改为 `.crt`）。
+3. Node.js TLS 兼容（如果遇到本地转发报错）：
+   ```bash
+   export NODE_EXTRA_CA_CERTS="$(mkcert -CAROOT)/rootCA.pem"
+   ```
+
+---
+
+## 🛠️ 面向开发者
+
+如果你想参与 AgentWake 的开发，请参考以下指南：
+
+### 技术栈
+- **后端**：Node.js + TypeScript + Express + WebSocket (`ws`) + Zod
+- **前端**：HTML/CSS/JS (PWA 支持)
+- **系统交互**：`node-notifier` (桌面通知)
+
+### 本地开发
+
+```bash
+# 1. 克隆代码并安装依赖
+git clone https://github.com/your-username/agentwake.git
+cd agentwake
+npm install
+
+# 2. 准备环境变量
+cp .env.example .env
+
+# 3. 初始化（生成本地证书等）
+npm run init
+
+# 4. 启动开发服务器
+npm run dev
+```
+
+### 核心目录结构
+- `src/adapters/`：各类编辑器（Cursor/Claude/Qoder）的输入信号适配器。
+- `src/gateway/`：核心网关，负责 Adapter 注册与事件路由。
+- `src/notifiers/`：通知分发器（桌面系统通知、移动端 WebSocket、PWA Push）。
+- `web/`：移动端 Web App 源码。
+
+---
+
+## ❓ 常见问题 (FAQ)
+
+**Q: 为什么手机端收不到通知？**  
+A: 请按顺序检查：
+1. 手机是否和电脑在同一局域网下。
+2. 手机浏览器是否显示“安全/受信任”的 HTTPS 连接（若显示不安全，请重新检查证书安装步骤）。
+3. 检查 Web 页面上的 WebSocket 连接状态是否显示为“已连接”。
+
+**Q: 能否自定义运行端口？**  
+A: 可以，通过 CLI 参数或环境变量修改：
+```bash
+agentwake start --port 4000
+# 或者使用环境变量
+AGENTWAKE_PORT=4000 agentwake start
+```
+
+---
+
+*AgentWake - 让 AI 编程更省心。*

package/dist/adapters/claude-hook-adapter.d.ts

@@ -0,0 +1,3 @@
+import type { GatewayAdapter } from "../gateway/adapter";
+export declare function createClaudeHookAdapter(): GatewayAdapter;
+//# sourceMappingURL=claude-hook-adapter.d.ts.map

package/dist/adapters/claude-hook-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-hook-adapter.d.ts","sourceRoot":"","sources":["../../src/adapters/claude-hook-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAOzD,wBAAgB,uBAAuB,IAAI,cAAc,CAoBxD"}

package/dist/adapters/claude-hook-adapter.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createClaudeHookAdapter = createClaudeHookAdapter;
+const hook_common_1 = require("./hook-common");
+function createClaudeHookAdapter() {
+    return {
+        id: "claude-hook-adapter",
+        start(context) {
+            context.app.post(context.config.claudeHookPath, async (req, res) => {
+                if (!(0, hook_common_1.validateHookSourceIp)(req, context.config.allowedHookIps)) {
+                    (0, hook_common_1.forbidden)(res);
+                    return;
+                }
+                const event = (0, hook_common_1.parseHookEvent)("claude-code", "claude-hook", req.body);
+                if (!event) {
+                    res.status(202).json({ ok: true, accepted: false, reason: "ignored" });
+                    return;
+                }
+                await context.emit(event);
+                res.status(200).json({ ok: true, accepted: true });
+            });
+        },
+    };
+}
+//# sourceMappingURL=claude-hook-adapter.js.map

package/dist/adapters/claude-hook-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-hook-adapter.js","sourceRoot":"","sources":["../../src/adapters/claude-hook-adapter.ts"],"names":[],"mappings":";;AAOA,0DAoBC;AA1BD,+CAIuB;AAEvB,SAAgB,uBAAuB;IACrC,OAAO;QACL,EAAE,EAAE,qBAAqB;QACzB,KAAK,CAAC,OAAO;YACX,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,cAAc,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE;gBACjE,IAAI,CAAC,IAAA,kCAAoB,EAAC,GAAG,EAAE,OAAO,CAAC,MAAM,CAAC,cAAc,CAAC,EAAE,CAAC;oBAC9D,IAAA,uBAAS,EAAC,GAAG,CAAC,CAAC;oBACf,OAAO;gBACT,CAAC;gBAED,MAAM,KAAK,GAAG,IAAA,4BAAc,EAAC,aAAa,EAAE,aAAa,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;gBACrE,IAAI,CAAC,KAAK,EAAE,CAAC;oBACX,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;oBACvE,OAAO;gBACT,CAAC;gBACD,MAAM,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBAC1B,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;YACrD,CAAC,CAAC,CAAC;QACL,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/adapters/cursor-hook-adapter.d.ts

@@ -0,0 +1,3 @@
+import type { GatewayAdapter } from "../gateway/adapter";
+export declare function createCursorHookAdapter(): GatewayAdapter;
+//# sourceMappingURL=cursor-hook-adapter.d.ts.map

package/dist/adapters/cursor-hook-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor-hook-adapter.d.ts","sourceRoot":"","sources":["../../src/adapters/cursor-hook-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAezD,wBAAgB,uBAAuB,IAAI,cAAc,CA0JxD"}

package/dist/adapters/cursor-hook-adapter.js

@@ -0,0 +1,144 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createCursorHookAdapter = createCursorHookAdapter;
+const hook_common_1 = require("./hook-common");
+const hook_common_2 = require("./hook-common");
+const cursor_terminal_hook_1 = require("./cursor-terminal-hook");
+const logger_1 = require("../utils/logger");
+function createCursorHookAdapter() {
+    const pendingSignals = new Map();
+    const REQUEST_NOTIFY_DELAY_MS = 1_000;
+    const WAIT_THRESHOLD_MS = 2_000;
+    return {
+        id: "cursor-hook-adapter",
+        start(context) {
+            const cleanupSignal = (key) => {
+                const pending = pendingSignals.get(key);
+                if (!pending) {
+                    return;
+                }
+                clearTimeout(pending.notifyTimer);
+                pendingSignals.delete(key);
+            };
+            const scheduleWaitingNotify = (key, signal) => {
+                cleanupSignal(key);
+                const requestedAtMs = Date.now();
+                const notifyTimer = setTimeout(() => {
+                    const pending = pendingSignals.get(key);
+                    if (!pending || pending.notified) {
+                        return;
+                    }
+                    const waitMs = Date.now() - pending.requestedAtMs;
+                    pending.notified = true;
+                    void context
+                        .emit((0, cursor_terminal_hook_1.createCursorApprovalEvent)({
+                        signal: pending.signal,
+                        reason: "time-gap-before-after",
+                        waitMs,
+                    }))
+                        .catch((error) => logger_1.logger.error("cursor delayed notify failed", { error: String(error) }));
+                }, REQUEST_NOTIFY_DELAY_MS);
+                pendingSignals.set(key, {
+                    signal,
+                    requestedAtMs,
+                    notifyTimer,
+                    notified: false,
+                });
+            };
+            context.app.post(context.config.cursorHookPath, async (req, res) => {
+                logger_1.logger.info("cursor hook incoming", {
+                    event: req.body?.hook_event_name,
+                    command: req.body?.command,
+                    permission: req.body?.permission,
+                    requiresApproval: req.body?.requiresApproval,
+                    ip: req.ip || req.socket.remoteAddress,
+                });
+                if (!(0, hook_common_1.validateHookSourceIp)(req, context.config.allowedHookIps)) {
+                    (0, hook_common_1.forbidden)(res);
+                    return;
+                }
+                const signal = (0, cursor_terminal_hook_1.parseCursorTerminalSignal)(req.body);
+                if (signal) {
+                    const key = (0, cursor_terminal_hook_1.resolveCursorSignalKey)(signal);
+                    if (signal.hookEvent === "beforeShellExecution") {
+                        if (signal.explicitApproval) {
+                            const event = (0, cursor_terminal_hook_1.createCursorApprovalEvent)({
+                                signal,
+                                reason: "explicit-hook-signal",
+                            });
+                            void context.emit(event).catch((error) => logger_1.logger.error("cursor notify emit failed", { error: String(error) }));
+                            logger_1.logger.info("cursor hook accepted", {
+                                dedupeKey: event.dedupeKey,
+                                title: event.title,
+                                level: event.level,
+                                reason: "explicit-hook-signal",
+                            });
+                            res.status(200).json({ ok: true, accepted: true });
+                            return;
+                        }
+                        scheduleWaitingNotify(key, signal);
+                        logger_1.logger.info("cursor hook pending approval watch", {
+                            key,
+                            command: signal.command,
+                            delayMs: REQUEST_NOTIFY_DELAY_MS,
+                        });
+                        res.status(202).json({ ok: true, accepted: false, reason: "pending-time-check" });
+                        return;
+                    }
+                    const pending = pendingSignals.get(key);
+                    if (pending) {
+                        const waitMs = Math.max(typeof signal.durationMs === "number" ? signal.durationMs : 0, Date.now() - pending.requestedAtMs);
+                        clearTimeout(pending.notifyTimer);
+                        pendingSignals.delete(key);
+                        if (!pending.notified && waitMs >= WAIT_THRESHOLD_MS) {
+                            const event = (0, cursor_terminal_hook_1.createCursorApprovalEvent)({
+                                signal: pending.signal,
+                                reason: "time-gap-after-shell",
+                                waitMs,
+                            });
+                            void context.emit(event).catch((error) => logger_1.logger.error("cursor notify emit failed", { error: String(error) }));
+                            logger_1.logger.info("cursor hook accepted", {
+                                dedupeKey: event.dedupeKey,
+                                title: event.title,
+                                level: event.level,
+                                reason: "time-gap-after-shell",
+                                waitMs,
+                            });
+                            res.status(200).json({ ok: true, accepted: true });
+                            return;
+                        }
+                        logger_1.logger.info("cursor hook resolved quickly", {
+                            key,
+                            waitMs,
+                        });
+                        res.status(202).json({ ok: true, accepted: false, reason: "resolved-quickly" });
+                        return;
+                    }
+                }
+                const event = (0, cursor_terminal_hook_1.parseCursorTerminalHookEvent)(req.body) ?? (0, hook_common_2.parseHookEvent)("cursor", "cursor-hook", req.body);
+                if (!event) {
+                    logger_1.logger.info("cursor hook ignored", {
+                        event: req.body?.hook_event_name,
+                        command: req.body?.command,
+                    });
+                    res.status(202).json({ ok: true, accepted: false, reason: "ignored" });
+                    return;
+                }
+                logger_1.logger.info("cursor hook accepted", {
+                    dedupeKey: event.dedupeKey,
+                    title: event.title,
+                    level: event.level,
+                });
+                await context.emit(event);
+                res.status(200).json({ ok: true, accepted: true });
+            });
+            return () => {
+                for (const pending of pendingSignals.values()) {
+                    clearTimeout(pending.notifyTimer);
+                }
+                pendingSignals.clear();
+            };
+        },
+    };
+}
+//# sourceMappingURL=cursor-hook-adapter.js.map

package/dist/adapters/cursor-hook-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor-hook-adapter.js","sourceRoot":"","sources":["../../src/adapters/cursor-hook-adapter.ts"],"names":[],"mappings":";;AAeA,0DA0JC;AAxKD,+CAGuB;AACvB,+CAA+C;AAC/C,iEAMgC;AAChC,4CAAyC;AAEzC,SAAgB,uBAAuB;IACrC,MAAM,cAAc,GAAG,IAAI,GAAG,EAG3B,CAAC;IACJ,MAAM,uBAAuB,GAAG,KAAK,CAAC;IACtC,MAAM,iBAAiB,GAAG,KAAK,CAAC;IAEhC,OAAO;QACL,EAAE,EAAE,qBAAqB;QACzB,KAAK,CAAC,OAAO;YACX,MAAM,aAAa,GAAG,CAAC,GAAW,EAAQ,EAAE;gBAC1C,MAAM,OAAO,GAAG,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;gBACxC,IAAI,CAAC,OAAO,EAAE,CAAC;oBACb,OAAO;gBACT,CAAC;gBACD,YAAY,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;gBAClC,cAAc,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC7B,CAAC,CAAC;YAEF,MAAM,qBAAqB,GAAG,CAAC,GAAW,EAAE,MAA4B,EAAQ,EAAE;gBAChF,aAAa,CAAC,GAAG,CAAC,CAAC;gBACnB,MAAM,aAAa,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;gBACjC,MAAM,WAAW,GAAG,UAAU,CAAC,GAAG,EAAE;oBAClC,MAAM,OAAO,GAAG,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;oBACxC,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;wBACjC,OAAO;oBACT,CAAC;oBACD,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,aAAa,CAAC;oBAClD,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;oBACxB,KAAK,OAAO;yBACT,IAAI,CACH,IAAA,gDAAyB,EAAC;wBACxB,MAAM,EAAE,OAAO,CAAC,MAAM;wBACtB,MAAM,EAAE,uBAAuB;wBAC/B,MAAM;qBACP,CAAC,CACH;yBACA,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,eAAM,CAAC,KAAK,CAAC,8BAA8B,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;gBAC9F,CAAC,EAAE,uBAAuB,CAAC,CAAC;gBAC5B,cAAc,CAAC,GAAG,CAAC,GAAG,EAAE;oBACtB,MAAM;oBACN,aAAa;oBACb,WAAW;oBACX,QAAQ,EAAE,KAAK;iBAChB,CAAC,CAAC;YACL,CAAC,CAAC;YAEF,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,cAAc,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE;gBACjE,eAAM,CAAC,IAAI,CAAC,sBAAsB,EAAE;oBAClC,KAAK,EAAE,GAAG,CAAC,IAAI,EAAE,eAAe;oBAChC,OAAO,EAAE,GAAG,CAAC,IAAI,EAAE,OAAO;oBAC1B,UAAU,EAAE,GAAG,CAAC,IAAI,EAAE,UAAU;oBAChC,gBAAgB,EAAE,GAAG,CAAC,IAAI,EAAE,gBAAgB;oBAC5C,EAAE,EAAE,GAAG,CAAC,EAAE,IAAI,GAAG,CAAC,MAAM,CAAC,aAAa;iBACvC,CAAC,CAAC;gBACH,IAAI,CAAC,IAAA,kCAAoB,EAAC,GAAG,EAAE,OAAO,CAAC,MAAM,CAAC,cAAc,CAAC,EAAE,CAAC;oBAC9D,IAAA,uBAAS,EAAC,GAAG,CAAC,CAAC;oBACf,OAAO;gBACT,CAAC;gBAED,MAAM,MAAM,GAAG,IAAA,gDAAyB,EAAC,GAAG,CAAC,IAAI,CAAC,CAAC;gBACnD,IAAI,MAAM,EAAE,CAAC;oBACX,MAAM,GAAG,GAAG,IAAA,6CAAsB,EAAC,MAAM,CAAC,CAAC;oBAC3C,IAAI,MAAM,CAAC,SAAS,KAAK,sBAAsB,EAAE,CAAC;wBAChD,IAAI,MAAM,CAAC,gBAAgB,EAAE,CAAC;4BAC5B,MAAM,KAAK,GAAG,IAAA,gDAAyB,EAAC;gCACtC,MAAM;gCACN,MAAM,EAAE,sBAAsB;6BAC/B,CAAC,CAAC;4BACH,KAAK,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CACvC,eAAM,CAAC,KAAK,CAAC,2BAA2B,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CACpE,CAAC;4BACF,eAAM,CAAC,IAAI,CAAC,sBAAsB,EAAE;gCAClC,SAAS,EAAE,KAAK,CAAC,SAAS;gCAC1B,KAAK,EAAE,KAAK,CAAC,KAAK;gCAClB,KAAK,EAAE,KAAK,CAAC,KAAK;gCAClB,MAAM,EAAE,sBAAsB;6BAC/B,CAAC,CAAC;4BACH,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;4BACnD,OAAO;wBACT,CAAC;wBACD,qBAAqB,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;wBACnC,eAAM,CAAC,IAAI,CAAC,oCAAoC,EAAE;4BAChD,GAAG;4BACH,OAAO,EAAE,MAAM,CAAC,OAAO;4BACvB,OAAO,EAAE,uBAAuB;yBACjC,CAAC,CAAC;wBACH,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,oBAAoB,EAAE,CAAC,CAAC;wBAClF,OAAO;oBACT,CAAC;oBAED,MAAM,OAAO,GAAG,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;oBACxC,IAAI,OAAO,EAAE,CAAC;wBACZ,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CACrB,OAAO,MAAM,CAAC,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,EAC7D,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,aAAa,CACnC,CAAC;wBACF,YAAY,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;wBAClC,cAAc,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;wBAC3B,IAAI,CAAC,OAAO,CAAC,QAAQ,IAAI,MAAM,IAAI,iBAAiB,EAAE,CAAC;4BACrD,MAAM,KAAK,GAAG,IAAA,gDAAyB,EAAC;gCACtC,MAAM,EAAE,OAAO,CAAC,MAAM;gCACtB,MAAM,EAAE,sBAAsB;gCAC9B,MAAM;6BACP,CAAC,CAAC;4BACH,KAAK,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CACvC,eAAM,CAAC,KAAK,CAAC,2BAA2B,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CACpE,CAAC;4BACF,eAAM,CAAC,IAAI,CAAC,sBAAsB,EAAE;gCAClC,SAAS,EAAE,KAAK,CAAC,SAAS;gCAC1B,KAAK,EAAE,KAAK,CAAC,KAAK;gCAClB,KAAK,EAAE,KAAK,CAAC,KAAK;gCAClB,MAAM,EAAE,sBAAsB;gCAC9B,MAAM;6BACP,CAAC,CAAC;4BACH,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;4BACnD,OAAO;wBACT,CAAC;wBACD,eAAM,CAAC,IAAI,CAAC,8BAA8B,EAAE;4BAC1C,GAAG;4BACH,MAAM;yBACP,CAAC,CAAC;wBACH,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,kBAAkB,EAAE,CAAC,CAAC;wBAChF,OAAO;oBACT,CAAC;gBACH,CAAC;gBAED,MAAM,KAAK,GAAG,IAAA,mDAA4B,EAAC,GAAG,CAAC,IAAI,CAAC,IAAI,IAAA,4BAAc,EAAC,QAAQ,EAAE,aAAa,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;gBAC1G,IAAI,CAAC,KAAK,EAAE,CAAC;oBACX,eAAM,CAAC,IAAI,CAAC,qBAAqB,EAAE;wBACjC,KAAK,EAAE,GAAG,CAAC,IAAI,EAAE,eAAe;wBAChC,OAAO,EAAE,GAAG,CAAC,IAAI,EAAE,OAAO;qBAC3B,CAAC,CAAC;oBACH,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;oBACvE,OAAO;gBACT,CAAC;gBACD,eAAM,CAAC,IAAI,CAAC,sBAAsB,EAAE;oBAClC,SAAS,EAAE,KAAK,CAAC,SAAS;oBAC1B,KAAK,EAAE,KAAK,CAAC,KAAK;oBAClB,KAAK,EAAE,KAAK,CAAC,KAAK;iBACnB,CAAC,CAAC;gBACH,MAAM,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBAC1B,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;YACrD,CAAC,CAAC,CAAC;YAEH,OAAO,GAAG,EAAE;gBACV,KAAK,MAAM,OAAO,IAAI,cAAc,CAAC,MAAM,EAAE,EAAE,CAAC;oBAC9C,YAAY,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;gBACpC,CAAC;gBACD,cAAc,CAAC,KAAK,EAAE,CAAC;YACzB,CAAC,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/adapters/cursor-terminal-hook.d.ts

@@ -0,0 +1,20 @@
+import { type NotifyEvent } from "../domain/notify-event";
+export type CursorTerminalSignal = {
+    hookEvent: "beforeShellExecution" | "afterShellExecution";
+    command: string;
+    cwd?: string;
+    conversationId?: string;
+    generationId?: string;
+    timestampMs: number;
+    explicitApproval: boolean;
+    durationMs?: number;
+};
+export declare function parseCursorTerminalSignal(body: unknown): CursorTerminalSignal | null;
+export declare function resolveCursorSignalKey(signal: CursorTerminalSignal): string;
+export declare function createCursorApprovalEvent(params: {
+    signal: CursorTerminalSignal;
+    reason?: string;
+    waitMs?: number;
+}): NotifyEvent;
+export declare function parseCursorTerminalHookEvent(body: unknown): NotifyEvent | null;
+//# sourceMappingURL=cursor-terminal-hook.d.ts.map

package/dist/adapters/cursor-terminal-hook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor-terminal-hook.d.ts","sourceRoot":"","sources":["../../src/adapters/cursor-terminal-hook.ts"],"names":[],"mappings":"AACA,OAAO,EAAqB,KAAK,WAAW,EAAE,MAAM,wBAAwB,CAAC;AA4B7E,MAAM,MAAM,oBAAoB,GAAG;IACjC,SAAS,EAAE,sBAAsB,GAAG,qBAAqB,CAAC;IAC1D,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AA2BF,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,OAAO,GAAG,oBAAoB,GAAG,IAAI,CAwBpF;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,oBAAoB,GAAG,MAAM,CAG3E;AAED,wBAAgB,yBAAyB,CAAC,MAAM,EAAE;IAChD,MAAM,EAAE,oBAAoB,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,WAAW,CA+Bd;AAED,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,OAAO,GAAG,WAAW,GAAG,IAAI,CAM9E"}

package/dist/adapters/cursor-terminal-hook.js

@@ -0,0 +1,120 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseCursorTerminalSignal = parseCursorTerminalSignal;
+exports.resolveCursorSignalKey = resolveCursorSignalKey;
+exports.createCursorApprovalEvent = createCursorApprovalEvent;
+exports.parseCursorTerminalHookEvent = parseCursorTerminalHookEvent;
+const zod_1 = require("zod");
+const notify_event_1 = require("../domain/notify-event");
+const approval_match_1 = require("../utils/approval-match");
+const cursorTerminalSchema = zod_1.z.object({
+    hook_event_name: zod_1.z.string().optional(),
+    conversation_id: zod_1.z.string().optional(),
+    generation_id: zod_1.z.string().optional(),
+    command: zod_1.z.string().optional(),
+    cwd: zod_1.z.string().optional(),
+    status: zod_1.z.string().optional(),
+    state: zod_1.z.string().optional(),
+    message: zod_1.z.string().optional(),
+    userMessage: zod_1.z.string().optional(),
+    agentMessage: zod_1.z.string().optional(),
+    reason: zod_1.z.string().optional(),
+    requiresApproval: zod_1.z.boolean().optional(),
+    approvalRequired: zod_1.z.boolean().optional(),
+    pendingApproval: zod_1.z.boolean().optional(),
+    permission: zod_1.z.string().optional(),
+    decision: zod_1.z.string().optional(),
+    continue: zod_1.z.boolean().optional(),
+    exit_code: zod_1.z.number().optional(),
+    duration: zod_1.z.number().optional(),
+    output: zod_1.z.string().optional(),
+    sandbox: zod_1.z.boolean().optional(),
+    workspace_roots: zod_1.z.array(zod_1.z.string()).optional(),
+});
+function compactBody(parts) {
+    return parts
+        .map((item) => item?.trim())
+        .filter((item) => Boolean(item))
+        .join("\n");
+}
+function resolveExplicitApproval(payload) {
+    return (payload.requiresApproval === true ||
+        payload.approvalRequired === true ||
+        payload.pendingApproval === true ||
+        payload.permission === "ask" ||
+        payload.decision === "ask" ||
+        payload.state === "awaiting_user_approval" ||
+        payload.state === "waiting_for_user_approval" ||
+        payload.status === "awaiting_user_approval" ||
+        payload.status === "waiting_for_user_approval" ||
+        (0, approval_match_1.isApprovalWaitingText)(payload.message ?? "") ||
+        (0, approval_match_1.isApprovalWaitingText)(payload.userMessage ?? "") ||
+        (0, approval_match_1.isApprovalWaitingText)(payload.agentMessage ?? "") ||
+        (0, approval_match_1.isApprovalWaitingText)(payload.reason ?? ""));
+}
+function parseCursorTerminalSignal(body) {
+    const parsed = cursorTerminalSchema.safeParse(body);
+    if (!parsed.success) {
+        return null;
+    }
+    const payload = parsed.data;
+    const hookEvent = payload.hook_event_name?.trim();
+    if (hookEvent !== "beforeShellExecution" && hookEvent !== "afterShellExecution") {
+        return null;
+    }
+    const command = payload.command?.trim();
+    if (!command) {
+        return null;
+    }
+    return {
+        hookEvent,
+        command,
+        ...(payload.cwd ? { cwd: payload.cwd } : {}),
+        ...(payload.conversation_id ? { conversationId: payload.conversation_id } : {}),
+        ...(payload.generation_id ? { generationId: payload.generation_id } : {}),
+        timestampMs: Date.now(),
+        explicitApproval: resolveExplicitApproval(payload),
+        ...(typeof payload.duration === "number" ? { durationMs: payload.duration } : {}),
+    };
+}
+function resolveCursorSignalKey(signal) {
+    const idPart = signal.generationId ?? signal.conversationId ?? "unknown";
+    return `${idPart}:${signal.command}`;
+}
+function createCursorApprovalEvent(params) {
+    const { signal } = params;
+    const waitSec = typeof params.waitMs === "number" && Number.isFinite(params.waitMs) ? params.waitMs / 1000 : undefined;
+    const waitToken = typeof waitSec === "number" ? `${waitSec.toFixed(1)}s` : undefined;
+    const bodyText = compactBody([
+        `命令: ${signal.command}`,
+        signal.cwd ? `目录: ${signal.cwd}` : undefined,
+        params.reason ? `原因: ${params.reason}` : undefined,
+        waitToken ? `等待时长: ${waitToken}` : undefined,
+    ]) || signal.command;
+    return (0, notify_event_1.createNotifyEvent)({
+        source: "cursor-hook",
+        editor: "cursor",
+        level: "warn",
+        title: "Cursor 终端等待用户同意",
+        body: bodyText,
+        dedupeKey: `cursor:approval:${resolveCursorSignalKey(signal)}`,
+        meta: {
+            hookEvent: signal.hookEvent,
+            command: signal.command,
+            cwd: signal.cwd,
+            conversationId: signal.conversationId,
+            generationId: signal.generationId,
+            reason: params.reason,
+            waitMs: params.waitMs,
+            explicitApproval: signal.explicitApproval,
+        },
+    });
+}
+function parseCursorTerminalHookEvent(body) {
+    const signal = parseCursorTerminalSignal(body);
+    if (!signal || signal.hookEvent !== "beforeShellExecution" || !signal.explicitApproval) {
+        return null;
+    }
+    return createCursorApprovalEvent({ signal, reason: "explicit-hook-signal" });
+}
+//# sourceMappingURL=cursor-terminal-hook.js.map

package/dist/adapters/cursor-terminal-hook.js.map

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

package/dist/adapters/hook-common.d.ts

@@ -0,0 +1,6 @@
+import type { Request, Response } from "express";
+import { type EditorKind, type NotifyEvent } from "../domain/notify-event";
+export declare function parseHookEvent(editor: EditorKind, source: string, body: unknown): NotifyEvent | null;
+export declare function validateHookSourceIp(req: Request, allowlist: string[]): boolean;
+export declare function forbidden(res: Response): void;
+//# sourceMappingURL=hook-common.d.ts.map

package/dist/adapters/hook-common.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-common.d.ts","sourceRoot":"","sources":["../../src/adapters/hook-common.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAEjD,OAAO,EAAqB,KAAK,UAAU,EAAE,KAAK,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAc9F,wBAAgB,cAAc,CAC5B,MAAM,EAAE,UAAU,EAClB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,OAAO,GACZ,WAAW,GAAG,IAAI,CAiCpB;AAED,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,OAAO,CAgB/E;AAED,wBAAgB,SAAS,CAAC,GAAG,EAAE,QAAQ,GAAG,IAAI,CAE7C"}

package/dist/adapters/hook-common.js

@@ -0,0 +1,69 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseHookEvent = parseHookEvent;
+exports.validateHookSourceIp = validateHookSourceIp;
+exports.forbidden = forbidden;
+const zod_1 = require("zod");
+const notify_event_1 = require("../domain/notify-event");
+const approval_match_1 = require("../utils/approval-match");
+const hookPayloadSchema = zod_1.z.object({
+    title: zod_1.z.string().optional(),
+    message: zod_1.z.string().optional(),
+    text: zod_1.z.string().optional(),
+    event: zod_1.z.string().optional(),
+    status: zod_1.z.string().optional(),
+    requiresApproval: zod_1.z.boolean().optional(),
+    idempotencyKey: zod_1.z.string().optional(),
+    meta: zod_1.z.record(zod_1.z.string(), zod_1.z.unknown()).optional(),
+});
+function parseHookEvent(editor, source, body) {
+    const parsed = hookPayloadSchema.safeParse(body);
+    if (!parsed.success) {
+        return null;
+    }
+    const payload = parsed.data;
+    const title = payload.title?.trim() || `${editor} waiting`;
+    const message = payload.message?.trim() || payload.text?.trim() || "";
+    const status = payload.status?.trim() ?? "";
+    const evt = payload.event?.trim() ?? "";
+    const requiresApproval = payload.requiresApproval === true;
+    const hit = requiresApproval ||
+        (0, approval_match_1.isApprovalWaitingText)(message) ||
+        (0, approval_match_1.isApprovalWaitingText)(status) ||
+        (0, approval_match_1.isApprovalWaitingText)(evt);
+    if (!hit) {
+        return null;
+    }
+    const bodyText = message || status || evt || "Agent is waiting for user approval.";
+    const idempotencyKey = payload.idempotencyKey?.trim();
+    const dedupeKey = idempotencyKey || `${source}:${title}:${bodyText}`;
+    return (0, notify_event_1.createNotifyEvent)({
+        source,
+        editor,
+        level: "warn",
+        title,
+        body: bodyText,
+        dedupeKey,
+        ...(payload.meta ? { meta: payload.meta } : {}),
+    });
+}
+function validateHookSourceIp(req, allowlist) {
+    if (allowlist.length === 0) {
+        return true;
+    }
+    const raw = req.ip ||
+        req.socket.remoteAddress ||
+        (Array.isArray(req.headers["x-forwarded-for"])
+            ? req.headers["x-forwarded-for"][0]
+            : req.headers["x-forwarded-for"]) ||
+        "";
+    if (!raw) {
+        return false;
+    }
+    const ip = String(raw).split(",")[0]?.trim() ?? "";
+    return allowlist.includes(ip);
+}
+function forbidden(res) {
+    res.status(403).json({ ok: false, error: "forbidden source ip" });
+}
+//# sourceMappingURL=hook-common.js.map

package/dist/adapters/hook-common.js.map

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

package/dist/adapters/qoder-log-adapter.d.ts

@@ -0,0 +1,19 @@
+import type { GatewayAdapter } from "../gateway/adapter";
+export type QoderLogSignal = {
+    type: "permission_requested";
+    toolCallId: string;
+    toolName: string;
+    logTimestampSec: number | undefined;
+} | {
+    type: "permission_resolved";
+    toolCallId: string;
+    outcome: "allow" | "reject" | "cancelled" | "unknown";
+    logTimestampSec: number | undefined;
+} | {
+    type: "agent_suspended";
+} | {
+    type: "agent_resumed";
+};
+export declare function parseQoderLogLine(line: string): QoderLogSignal | null;
+export declare function createQoderLogAdapter(): GatewayAdapter;
+//# sourceMappingURL=qoder-log-adapter.d.ts.map

package/dist/adapters/qoder-log-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"qoder-log-adapter.d.ts","sourceRoot":"","sources":["../../src/adapters/qoder-log-adapter.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAe,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAGtE,MAAM,MAAM,cAAc,GACtB;IACE,IAAI,EAAE,sBAAsB,CAAC;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,GAAG,SAAS,CAAC;CACrC,GACD;IACE,IAAI,EAAE,qBAAqB,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,OAAO,GAAG,QAAQ,GAAG,WAAW,GAAG,SAAS,CAAC;IACtD,eAAe,EAAE,MAAM,GAAG,SAAS,CAAC;CACrC,GACD;IACE,IAAI,EAAE,iBAAiB,CAAC;CACzB,GACD;IACE,IAAI,EAAE,eAAe,CAAC;CACvB,CAAC;AA2IN,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAyCrE;AAED,wBAAgB,qBAAqB,IAAI,cAAc,CA0KtD"}