agent-window 1.0.0

package/config/config.example.json

@@ -0,0 +1,70 @@
+{
+  "BOT_TOKEN": "your-discord-bot-token",
+  "CLAUDE_CODE_OAUTH_TOKEN": "your-claude-oauth-token",
+  "PROJECT_DIR": "/path/to/your/project",
+  "ALLOWED_CHANNELS": "channel-id-1,channel-id-2",
+
+  "_comment_backend": "=== Backend Configuration ===",
+  "backend": {
+    "type": "claude-code",
+    "configDir": "~/.claude"
+  },
+
+  "_comment_workspace": "=== Workspace Configuration ===",
+  "workspace": {
+    "containerName": "claude-discord-bot",
+    "dockerImage": "claude-sandbox",
+    "portMappings": ["5173:5173"]
+  },
+
+  "_comment_cli": "=== CLI Configuration ===",
+  "cli": {
+    "command": "claude",
+    "maxTurns": 50,
+    "taskTimeout": 3600000
+  },
+
+  "_comment_permissions": "=== Permission Configuration ===",
+  "permissions": {
+    "hookEnabled": true,
+    "pollInterval": 300,
+    "timeout": 120000
+  },
+
+  "_comment_docker": "=== Docker Configuration ===",
+  "docker": {
+    "checkTimeout": 5000,
+    "containerPaths": {
+      "workspace": "/workspace",
+      "configDir": "/home/claude/.claude",
+      "hookDir": "/permission-hook",
+      "pendingDir": "/pending-permissions",
+      "settingsFile": "/permission-hook/settings.json"
+    }
+  },
+
+  "_comment_ui": "=== UI Configuration ===",
+  "ui": {
+    "statusUpdateThrottle": 500,
+    "theme": {
+      "success": "0x9ece6a",
+      "error": "0xf7768e",
+      "info": "0x7aa2f7",
+      "warning": "0xf0ad4e"
+    }
+  },
+
+  "_comment_platform": "=== Platform Configuration (for multi-platform support) ===",
+  "platform": {
+    "type": "discord",
+    "messageMaxLength": 1900,
+    "retryDelay": 500,
+    "previewLengths": {
+      "command": 500,
+      "fileContent": 300,
+      "editPreview": 150,
+      "jsonInput": 400,
+      "response": 200
+    }
+  }
+}

package/docker-compose.yml

@@ -0,0 +1,31 @@
+# AgentBridge - Docker Compose
+#
+# Usage:
+#   docker-compose up -d      # Start in background
+#   docker-compose logs -f    # View logs
+#   docker-compose down       # Stop
+
+version: '3.8'
+
+services:
+  agent-bridge:
+    build:
+      context: .
+      dockerfile: Dockerfile
+    container_name: agent-bridge
+    restart: unless-stopped
+    volumes:
+      - ./config/config.json:/app/config/config.json:ro
+      - /var/run/docker.sock:/var/run/docker.sock
+      - ~/.claude:/root/.claude:ro
+      - ./hooks:/app/hooks:ro
+      - ./.pending-permissions:/app/.pending-permissions
+      - ${PROJECT_DIR:-./workspace}:/workspace
+    environment:
+      - NODE_ENV=production
+    networks:
+      - agent-bridge-network
+
+networks:
+  agent-bridge-network:
+    driver: bridge

package/docs/legacy/DEVELOPMENT.md

@@ -0,0 +1,174 @@
+# Discord CLI Bot - 开发文档
+
+## 项目定位
+
+一个将 **AI 编程助手 CLI 工具**（Claude Code、Codex、OpenCode 等）接入 **Discord** 的通用框架。让团队成员可以通过 Discord 频道与 AI 编程助手交互，支持代码审查、自动化任务、项目协作等场景。
+
+## 项目目标
+
+1. **多 CLI 支持**：统一接口适配多种 AI CLI 工具
+   - Claude Code（已实现）
+   - OpenAI Codex CLI（待实现）
+   - OpenCode（待实现）
+   - 未来可扩展其他 CLI/API
+
+2. **安全隔离**：Docker 沙箱执行，CLI 只能访问指定项目目录
+
+3. **权限控制**：危险操作需用户通过 Discord 按钮审批
+
+4. **多实例部署**：支持多个独立 bot 实例，可配置不同服务器/频道
+
+## 当前状态
+
+### 已完成
+- [x] Discord 消息交互（@mention 触发）
+- [x] Docker 沙箱隔离执行
+- [x] 权限审批系统（按钮 UI）
+- [x] Session 管理（频道绑定、恢复对话）
+- [x] 任务计时（排除权限等待时间）
+- [x] 自动重连 + pm2 托管
+- [x] Playwright 预装（支持浏览器自动化）
+- [x] 端口映射（dev server 可从宿主机访问）
+- [x] Bash 命令分类审批（安全命令自动通过）
+
+### 待实现
+- [ ] 多 CLI 后端抽象层
+- [ ] Codex CLI 适配器
+- [ ] OpenCode CLI 适配器
+- [ ] 多实例配置管理
+- [ ] API 后端支持（预留）
+
+## 架构设计
+
+### 目标架构
+
+```
+discord-cli-bot/
+├── core/                    # 核心模块（共享）
+│   ├── discord.js          # Discord 客户端、消息路由
+│   ├── permission.js       # 权限审批 UI 系统
+│   ├── session.js          # Session 管理
+│   └── status.js           # 状态显示、计时
+├── backends/               # CLI 后端适配器
+│   ├── base.js            # 抽象基类接口
+│   ├── claude-cli.js      # Claude Code 适配器
+│   ├── codex-cli.js       # Codex CLI 适配器
+│   └── opencode-cli.js    # OpenCode 适配器
+├── sandbox/               # Docker 沙箱
+│   ├── docker.js          # 容器管理
+│   └── Dockerfile         # 基础镜像
+├── hooks/                 # CLI 钩子
+│   └── hook.mjs           # PreToolUse 权限钩子
+├── config/                # 配置
+│   └── config.json        # 实例配置
+├── instances/             # 多实例配置（未来）
+│   ├── claude.json
+│   ├── codex.json
+│   └── opencode.json
+└── cli.js                 # 启动入口
+```
+
+### 后端适配器接口
+
+```javascript
+// backends/base.js
+class BaseBackend {
+  constructor(config) { }
+
+  // 启动 CLI 进程
+  async start(prompt, options) { }
+
+  // 解析 JSON 流事件
+  parseEvent(line) { }
+
+  // 恢复 session
+  async resume(sessionId, prompt) { }
+
+  // 获取 CLI 命令和参数
+  getCommand() { }
+  getArgs(options) { }
+}
+```
+
+### CLI JSON 流格式对比
+
+| 事件 | Claude Code | Codex CLI |
+|-----|-------------|-----------|
+| 开始 | `{"type":"system","subtype":"init"}` | `{"type":"thread.started"}` |
+| 消息 | `{"type":"assistant","message":{...}}` | `{"type":"item.completed","item":{"type":"agent_message"}}` |
+| 工具调用 | `{"type":"assistant","message":{"content":[{"type":"tool_use"}]}}` | `{"type":"item.started","item":{"type":"command_execution"}}` |
+| 结果 | `{"type":"result"}` | `{"type":"turn.completed"}` |
+| 恢复 | `--resume <id>` | `codex exec resume <id>` |
+
+## 配置说明
+
+### config/config.json
+
+```json
+{
+  "BOT_TOKEN": "Discord Bot Token",
+  "CLAUDE_CODE_OAUTH_TOKEN": "Claude OAuth Token（可选，也可用 API Key）",
+  "PROJECT_DIR": "要操作的项目目录绝对路径",
+  "ALLOWED_CHANNELS": "允许的频道ID，逗号分隔"
+}
+```
+
+### 环境变量（优先级低于配置文件）
+
+- `DISCORD_BOT_TOKEN`
+- `ANTHROPIC_API_KEY`
+
+## 开发指南
+
+### 添加新的 CLI 后端
+
+1. 在 `backends/` 创建适配器文件（如 `codex-cli.js`）
+2. 继承 `BaseBackend` 实现接口
+3. 处理 JSON 流事件映射
+4. 在配置中指定 `backend: "codex-cli"`
+
+### 权限钩子机制
+
+Claude Code 支持 PreToolUse Hook，用于拦截工具调用：
+
+```
+CLI 调用工具 → Hook 拦截 → 写入 .request.json →
+Bot 检测到请求 → 发送 Discord 按钮 →
+用户点击 → 写入 .response.json → Hook 读取 →
+CLI 继续执行
+```
+
+其他 CLI 如果不支持 Hook，需要用 `--auto-edit` 等模式或包装脚本。
+
+## 关键文件说明
+
+| 文件 | 说明 |
+|-----|-----|
+| `src/bot.js` | 主程序，包含 Discord 交互、权限处理、Docker 执行 |
+| `hooks/hook.mjs` | Claude PreToolUse 钩子，处理权限请求 |
+| `sandbox/Dockerfile` | Docker 镜像，预装 Playwright 和依赖 |
+| `config/config.json` | 实例配置（不提交到 git） |
+
+## 运行方式
+
+```bash
+# 开发模式
+node src/bot.js
+
+# 生产模式（pm2 托管）
+pm2 start src/bot.js --name discord-bot --exp-backoff-restart-delay=1000
+
+# 查看日志
+pm2 logs discord-bot
+
+# 重启
+pm2 restart discord-bot
+```
+
+## 相关资源
+
+- [Claude Code 文档](https://docs.anthropic.com/en/docs/claude-code)
+- [Codex CLI 文档](https://developers.openai.com/codex/cli/)
+- [Discord.js 文档](https://discord.js.org/)
+- [cmux - 多 CLI 并行工具](https://github.com/manaflow-ai/cmux)（架构参考）
+- [claude-code-discord](https://github.com/zebbern/claude-code-discord)（Discord 集成参考）

package/docs/legacy/HANDOVER.md

@@ -0,0 +1,149 @@
+# 交接说明 - Discord CLI Bot
+
+## 项目背景
+
+这是一个将 AI 编程助手 CLI（Claude Code、Codex、OpenCode 等）接入 Discord 的机器人框架。
+
+**原始需求**：用户希望通过 Discord 频道与 Claude Code 交互，实现：
+- 团队协作：多人可通过 Discord 与 AI 助手对话
+- 安全隔离：CLI 在 Docker 沙箱中执行，只能访问指定项目
+- 权限控制：危险操作（删除文件、执行命令等）需要用户通过 Discord 按钮审批
+- 无缝体验：支持对话恢复、任务计时、自动重连
+
+**迁移原因**：原本 bot 代码在 `cognitive-prototype` 项目的 `.claude/hooks/discord-bot/` 目录下，现在独立出来成为单独项目，便于：
+1. 独立版本管理
+2. 扩展支持其他 CLI（Codex、OpenCode）
+3. 多实例部署
+
+## 当前状态
+
+### 已完成功能
+- ✅ Discord 消息交互（@mention 触发）
+- ✅ Docker 沙箱隔离执行
+- ✅ 权限审批系统（Discord 按钮 UI）
+- ✅ Session 管理（频道绑定、对话恢复）
+- ✅ 任务计时（排除权限等待时间）
+- ✅ 网络断开自动重连 + pm2 崩溃重启
+- ✅ Playwright 预装（支持浏览器自动化测试）
+- ✅ 端口映射 5173（Vite dev server 可从宿主机访问）
+- ✅ Bash 命令智能审批（安全命令自动通过，危险命令需审批）
+
+### 待实现功能
+- ⬚ 多 CLI 后端抽象层
+- ⬚ Codex CLI 适配器
+- ⬚ OpenCode CLI 适配器
+- ⬚ 多实例配置管理
+
+## 立即需要做的事情
+
+**Bot 已停止，需要从新项目启动！**
+
+```bash
+# 1. 进入项目目录
+cd /Users/cyrus/Documents/project/discord-cli-bot
+
+# 2. 安装依赖
+npm install
+
+# 3. 构建 Docker 镜像（含 Playwright + 图形库依赖）
+cd sandbox && docker build -t claude-sandbox . && cd ..
+
+# 4. 启动 bot（pm2 托管，崩溃自动重启）
+pm2 start src/bot.js --name discord-bot --exp-backoff-restart-delay=1000
+
+# 5. 查看日志确认启动成功
+pm2 logs discord-bot --lines 20
+```
+
+## 配置文件
+
+配置已就绪：`config/config.json`
+
+```json
+{
+  "BOT_TOKEN": "Discord Bot Token",
+  "CLAUDE_CODE_OAUTH_TOKEN": "Claude OAuth Token",
+  "PROJECT_DIR": "/Users/cyrus/Documents/project/cognitive-prototype/interactive-prototype-cognitiveOS",
+  "ALLOWED_CHANNELS": "1462723721188868096"
+}
+```
+
+- `PROJECT_DIR`：Claude 可操作的项目目录（挂载到容器 /workspace）
+- `ALLOWED_CHANNELS`：允许触发 bot 的 Discord 频道 ID
+
+## 项目结构
+
+```
+discord-cli-bot/
+├── src/
+│   └── bot.js              # 主程序（Discord 交互、权限处理、Docker 执行）
+├── sandbox/
+│   └── Dockerfile          # Docker 镜像（node:20-slim + Playwright + 图形库）
+├── hooks/
+│   └── hook.mjs            # Claude PreToolUse 钩子（权限拦截）
+├── config/
+│   ├── config.json         # 实例配置（已配置，勿提交 git）
+│   └── config.example.json # 配置示例
+├── README.md               # 使用说明 + 踩坑记录
+├── DEVELOPMENT.md          # 开发文档 + 架构设计
+├── HANDOVER.md             # 本文档
+├── package.json
+└── .gitignore
+```
+
+## 关键技术点
+
+### 1. Docker 执行模式
+- 持久容器：`claude-discord-bot`，启动后保持运行
+- 每次请求通过 `docker exec` 执行 Claude CLI
+- 挂载：项目目录 → /workspace，~/.claude → /home/claude/.claude
+
+### 2. 权限审批流程
+```
+Claude 调用工具 → hooks/hook.mjs 拦截 →
+写入 .pending-permissions/xxx.request.json →
+Bot 检测到 → 发送 Discord 按钮卡片 →
+用户点击 Allow/Deny →
+写入 xxx.response.json → Hook 读取 →
+Claude 继续/中止
+```
+
+### 3. Session 恢复
+- Session 数据在 `/Users/cyrus/.claude`（挂载到容器）
+- 频道绑定在 `.discord-channel-sessions.json`
+- 用户发消息自动恢复上次对话
+
+## 常用命令
+
+```bash
+# 查看状态
+pm2 status
+
+# 查看日志
+pm2 logs discord-bot
+
+# 重启
+pm2 restart discord-bot
+
+# 停止
+pm2 stop discord-bot
+
+# 进入容器调试
+docker exec -it claude-discord-bot bash
+```
+
+## 相关文档
+
+- `README.md` - 8 个踩坑记录（Discord 按钮超时、Docker localhost、Playwright 依赖等）
+- `DEVELOPMENT.md` - 架构设计、后端适配器接口、CLI JSON 格式对比
+
+## Discord 使用方式
+
+```
+@bot <消息>           # 继续上次对话
+@bot -n <消息>        # 开始新对话
+@bot -r <id> <消息>   # 恢复指定 session
+@bot /sessions        # 查看历史 session
+@bot /status          # 查看 bot 状态
+@bot /help            # 帮助
+```

package/ecosystem.config.cjs

@@ -0,0 +1,26 @@
+/**
+ * PM2 Ecosystem Configuration for AgentBridge
+ *
+ * Start: pm2 start ecosystem.config.cjs
+ * Stop:  pm2 stop agent-bridge
+ * Logs:  pm2 logs agent-bridge
+ */
+
+module.exports = {
+  apps: [{
+    name: 'agent-bridge',
+    script: 'src/bot.js',
+    watch: false,
+    autorestart: true,
+    max_restarts: 10,
+    min_uptime: '10s',
+    max_memory_restart: '500M',
+    env: {
+      NODE_ENV: 'production'
+    },
+    kill_timeout: 5000,
+    wait_ready: false,
+    log_date_format: 'YYYY-MM-DD HH:mm:ss',
+    merge_logs: true,
+  }]
+};