botmux 1.0.0

package/.env.example

@@ -0,0 +1,24 @@
+# Lark (Feishu) App Credentials — required
+LARK_APP_ID=
+LARK_APP_SECRET=
+
+# Session data directory (default: ./data)
+# SESSION_DATA_DIR=
+
+# Daemon settings
+# CLI_ID=claude-code              # CLI adapter: claude-code, aiden, coco, codex
+# WORKING_DIR=~                   # Default working directory
+
+# Access control (comma-separated email prefixes or Lark open_ids, empty = allow all)
+# ALLOWED_USERS=alice,bob
+# LARK_EMAIL_DOMAIN=example.com       # Default email domain for ALLOWED_USERS prefixes
+
+# Project scanning directory for /repo command (default: parent of WORKING_DIR)
+# PROJECT_SCAN_DIR=
+
+# Web terminal settings
+# WEB_HOST=0.0.0.0                # HTTP server bind address
+# WEB_EXTERNAL_HOST=               # External hostname/IP for terminal URLs (default: auto-detect LAN IP)
+
+# Debug logging
+# DEBUG=1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 botmux contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.en.md

@@ -0,0 +1,267 @@
+# botmux
+
+[中文](README.md) | English
+
+Bridge between Lark (Feishu) topic groups and AI coding CLIs. The daemon listens for Lark messages and automatically spawns an independent CLI process (supporting Claude Code, Aiden, CoCo, Codex) for each new topic thread, with live streaming cards and a web-based terminal.
+
+## Features
+
+- **One topic = one AI coding session** — each Lark thread gets its own isolated CLI process
+- **Multi-CLI support** — adapter architecture supports Claude Code, Aiden, CoCo, Codex, and is extensible
+- **Live streaming cards** — real-time terminal output rendered in Feishu cards with markdown support, per-turn card lifecycle
+- **Web terminal (xterm.js)** — full PTY output in the browser with optional write access via on-demand DM link
+- **Session persistence** — sessions survive daemon restarts and resume automatically
+- **Scheduled tasks** — cron-based recurring prompts with natural language scheduling (Chinese supported)
+- **Project management** — interactive repo selector, per-session working directory
+- **MCP integration** — CLI can reply to Lark threads, read message history, and add reactions via MCP tools
+- **Access control** — allowlist for users, token-based write access for terminals, button restrictions on cards
+
+## Architecture
+
+```
+Lark WebSocket Events
+    |
+Daemon (daemon.ts → core/ modules)
+    |-- im/lark/event-dispatcher: Lark event routing
+    |-- im/lark/card-handler: card interaction handling
+    |-- core/worker-pool: worker process pool management
+    |-- core/command-handler: slash command processing
+    |-- core/session-manager: session lifecycle
+    |-- core/scheduler: cron task scheduling
+    |
+Worker (worker.ts) -- forked child process per session
+    |-- adapters/cli/*: CLI adapters (Claude Code / Aiden / CoCo / Codex)
+    |-- adapters/backend/pty-backend: pseudo-terminal management (node-pty)
+    |-- utils/idle-detector: idle detection (quiescence + spinner + completion marker)
+    |-- HTTP + WebSocket server: serves xterm.js web terminal
+    |-- Headless xterm: captures screen for streaming cards
+    |-- IPC: communicates with daemon
+    |
+AI Coding CLI (interactive TTY mode)
+    |-- MCP Server (stdio): send_to_thread, get_thread_messages, react_to_message
+    |
+Lark API
+    |-- Replies, reactions, card updates, DMs
+```
+
+## Prerequisites
+
+- **Node.js** >= 20
+- **AI coding CLI** installed and authenticated (`claude`, `aiden`, `coco`, or `codex` in PATH)
+- **Lark app** with Bot and Message permissions (WebSocket event subscription)
+
+## Installation
+
+```bash
+npm install -g botmux
+```
+
+## Quick Start
+
+```bash
+# 1. Interactive setup — creates ~/.botmux/.env
+botmux setup
+
+# 2. Start the daemon
+botmux start
+```
+
+The `setup` command will guide you through:
+- Creating a Lark app (with required permissions listed)
+- Entering App ID, App Secret, Chat ID
+- Optional: Claude model, working directory, access control
+
+## CLI Commands
+
+| Command | Description |
+|---------|-------------|
+| `botmux setup` | Interactive first-time configuration |
+| `botmux start` | Start daemon (PM2 managed) |
+| `botmux stop` | Stop daemon |
+| `botmux restart` | Restart daemon (auto-restores active sessions) |
+| `botmux logs` | View daemon logs (`--lines N` for more) |
+| `botmux status` | Show daemon status |
+| `botmux upgrade` | Upgrade to latest version |
+
+## Configuration
+
+Configuration is stored at `~/.botmux/.env`. Run `botmux setup` to create it interactively, or edit manually:
+
+### Required
+
+| Variable | Description |
+|----------|-------------|
+| `LARK_APP_ID` | Lark app ID |
+| `LARK_APP_SECRET` | Lark app secret |
+
+### Optional
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `CLI_ID` | `claude-code` | CLI adapter (`claude-code`, `aiden`, `coco`, `codex`) |
+| `CLI_PATH` | _(auto-detect by CLI_ID)_ | CLI binary path override |
+| `BACKEND_TYPE` | `pty` | Session backend (`pty`, `tmux`) |
+| `WORKING_DIR` | `~` | Default working directory |
+| `ALLOWED_USERS` | _(empty = allow all)_ | Comma-separated email prefixes or Lark open_ids |
+| `PROJECT_SCAN_DIR` | _(parent of CWD)_ | Directory to scan for git repos |
+| `WEB_HOST` | `0.0.0.0` | HTTP server bind address |
+| `WEB_EXTERNAL_HOST` | _(auto-detect LAN IP)_ | External hostname/IP for terminal URLs |
+| `SESSION_DATA_DIR` | `~/.botmux/data` | Where sessions and queues are stored |
+| `DEBUG` | _(unset)_ | Set to `1` for debug logging |
+
+## File Locations
+
+| Path | Description |
+|------|-------------|
+| `~/.botmux/.env` | Configuration |
+| `~/.botmux/data/` | Session data, message queues |
+| `~/.botmux/logs/` | Daemon logs |
+
+## Usage
+
+### Workflow
+
+1. Send a message in your Lark topic group to create a new thread
+2. The bot shows a repo selection card — pick a project or click "Start directly"
+3. Claude Code spawns in the selected directory
+4. A live streaming card appears in the thread, showing real-time terminal output with markdown rendering
+5. Each reply creates a new streaming card for that turn; previous cards freeze at their last state
+6. Click "🔑 Get Write Link" on the card to receive a write-enabled terminal URL via DM
+7. Claude replies in the thread via MCP tools
+
+### Slash Commands
+
+| Command | Description |
+|---------|-------------|
+| `/repo` | Show project selector card |
+| `/repo <N>` | Switch to Nth project from last scan |
+| `/cd <path>` | Change working directory |
+| `/status` | Show session info (uptime, terminal URL, etc.) |
+| `/cost` | Show token usage and estimated cost |
+| `/restart` | Restart Claude process |
+| `/close` | Close session and terminate Claude |
+| `/clear` | Clear context (new session, same thread) |
+| `/schedule` | Manage scheduled tasks |
+| `/help` | Show available commands |
+
+### Scheduled Tasks
+
+Create recurring tasks with natural language:
+
+```
+/schedule every day at 17:50 check AI news
+/schedule weekdays at 9:00 run health check
+/schedule every Monday at 10:00 generate weekly report
+```
+
+Manage tasks:
+
+```
+/schedule list
+/schedule remove <id>
+/schedule enable <id>
+/schedule disable <id>
+/schedule run <id>
+```
+
+### Streaming Cards
+
+Each conversation turn gets a live-updating Feishu card that shows:
+
+- Real-time terminal output (rendered via headless xterm + Feishu Card v2 markdown)
+- Status indicator: 🟡 Starting → 🔵 Working → 🟢 Idle
+- Action buttons: Open Terminal, Get Write Link, Restart Claude, Close Session
+
+The card content is captured from a headless xterm terminal that filters out TUI chrome (logo, status bar, prompts, box-drawing characters) and shows only Claude's actual work output.
+
+### Web Terminal
+
+Each session exposes a web terminal at `http://<WEB_EXTERNAL_HOST>:<port>`.
+
+- **Read-only link** — shown on the streaming card in the group thread
+- **Write-enabled link** — sent via DM on demand (click "🔑 Get Write Link" on the card)
+
+Features: xterm.js with fit/unicode11/web-links addons, TokyoNight theme, scrollback buffer, mobile-friendly viewport.
+
+## MCP Tools
+
+Claude Code has access to three MCP tools for interacting with Lark:
+
+| Tool | Description |
+|------|-------------|
+| `send_to_thread` | Send a message (text or rich post) to the Lark thread |
+| `get_thread_messages` | Retrieve message history from the thread |
+| `react_to_message` | Add or remove emoji reactions on messages |
+
+## Development
+
+```bash
+git clone <repo-url>
+cd botmux
+pnpm install
+pnpm build
+
+# Run directly (no PM2)
+pnpm daemon
+
+# Or with PM2
+pnpm daemon:start
+pnpm daemon:logs
+```
+
+## Project Structure
+
+```
+src/
+  cli.ts                    # CLI entry point (setup/start/stop/restart/logs)
+  daemon.ts                 # Daemon orchestrator (~400 lines, wires modules together)
+  worker.ts                 # Worker process: uses adapters to manage CLI + PTY
+  config.ts                 # Configuration from environment variables
+  server.ts                 # MCP server setup
+  types.ts                  # IPC message types
+  adapters/
+    cli/
+      types.ts              # CliAdapter interface, CliId type
+      registry.ts           # Adapter factory + resolveCommand
+      claude-code.ts        # Claude Code adapter
+      aiden.ts              # Aiden adapter
+      coco.ts               # CoCo adapter
+      codex.ts              # Codex adapter
+    backend/
+      types.ts              # SessionBackend interface
+      pty-backend.ts        # node-pty backend
+      tmux-backend.ts       # tmux backend (stub)
+  core/
+    types.ts                # DaemonSession core type
+    worker-pool.ts          # Worker process pool management
+    command-handler.ts      # Slash command processing
+    session-manager.ts      # Session lifecycle + path resolution
+    cost-calculator.ts      # Token usage & cost estimation
+    scheduler.ts            # Cron scheduling with natural language parsing
+  im/
+    types.ts                # ImAdapter interface definitions (multi-IM abstraction)
+    lark/
+      client.ts             # Lark API wrapper
+      event-dispatcher.ts   # Lark WebSocket event routing
+      card-handler.ts       # Lark card interaction handling
+      card-builder.ts       # Lark interactive card builders
+      message-parser.ts     # Lark event message parsing
+  tools/
+    index.ts                # MCP tool registry
+    send-to-thread.ts       # MCP tool: send message
+    get-thread-messages.ts  # MCP tool: read messages
+    react-to-message.ts     # MCP tool: emoji reactions
+  services/
+    session-store.ts        # Session persistence (JSON)
+    schedule-store.ts       # Scheduled task persistence
+    message-queue.ts        # Per-thread JSONL message queue
+    project-scanner.ts      # Git repo/worktree discovery
+  utils/
+    idle-detector.ts        # CLI idle detection (quiescence + spinner + completion marker)
+    terminal-renderer.ts    # Headless xterm renderer for screen capture & TUI filtering
+    logger.ts               # Logging utility
+```
+
+## License
+
+[MIT](LICENSE)

package/README.md

@@ -0,0 +1,267 @@
+# botmux
+
+中文 | [English](README.en.md)
+
+飞书话题群与 AI 编程 CLI 的桥接工具。Daemon 监听飞书消息，为每个新话题自动启动一个独立的 CLI 进程（支持 Claude Code、Aiden、CoCo、Codex），提供实时流式卡片和 Web 终端。
+
+## 功能特性
+
+- **一个话题 = 一个 AI 编程会话** — 每个飞书话题线程对应一个独立的 CLI 进程
+- **多 CLI 支持** — 通过适配器架构支持 Claude Code、Aiden、CoCo、Codex，可扩展
+- **实时流式卡片** — 终端输出实时渲染到飞书卡片中，支持 Markdown 格式，每轮对话独立卡片
+- **Web 终端 (xterm.js)** — 浏览器查看完整 PTY 输出，按需获取可操作链接
+- **会话持久化** — 会话在 Daemon 重启后自动恢复
+- **定时任务** — 基于 Cron 的周期性任务，支持中文自然语言配置
+- **项目管理** — 交互式仓库选择器，每个会话独立工作目录
+- **MCP 集成** — CLI 可通过 MCP 工具回复飞书话题、读取消息历史、添加表情回应
+- **权限控制** — 用户白名单、终端 Token 写入权限、卡片按钮操作限制
+
+## 架构
+
+```
+飞书 WebSocket 事件
+    |
+Daemon (daemon.ts → core/ 模块)
+    |-- im/lark/event-dispatcher: 飞书事件路由
+    |-- im/lark/card-handler: 卡片交互处理
+    |-- core/worker-pool: Worker 进程池管理
+    |-- core/command-handler: 斜杠命令处理
+    |-- core/session-manager: 会话生命周期
+    |-- core/scheduler: 定时任务调度
+    |
+Worker (worker.ts) -- 每个会话 fork 一个子进程
+    |-- adapters/cli/*: CLI 适配器 (Claude Code / Aiden / CoCo / Codex)
+    |-- adapters/backend/pty-backend: 伪终端管理 (node-pty)
+    |-- utils/idle-detector: 空闲检测（静默 + Spinner + 完成标记）
+    |-- HTTP + WebSocket: 提供 xterm.js Web 终端
+    |-- Headless xterm: 捕获屏幕内容用于流式卡片
+    |-- IPC: 与 Daemon 通信
+    |
+AI 编程 CLI (交互式 TTY 模式)
+    |-- MCP Server (stdio): send_to_thread, get_thread_messages, react_to_message
+    |
+飞书 API
+    |-- 回复消息、表情回应、卡片更新、私聊
+```
+
+## 前置要求
+
+- **Node.js** >= 20
+- **AI 编程 CLI** 已安装并完成认证（`claude`、`aiden`、`coco` 或 `codex` 在 PATH 中）
+- **飞书应用** 具备机器人和消息权限（WebSocket 事件订阅）
+
+## 安装
+
+```bash
+npm install -g botmux
+```
+
+## 快速开始
+
+```bash
+# 1. 交互式配置 — 创建 ~/.botmux/.env
+botmux setup
+
+# 2. 启动 daemon
+botmux start
+```
+
+`setup` 命令会引导你完成：
+- 创建飞书应用（列出所需权限）
+- 输入 App ID、App Secret、Chat ID
+- 可选：Claude 模型、工作目录、权限控制
+
+## CLI 命令
+
+| 命令 | 说明 |
+|------|------|
+| `botmux setup` | 交互式首次配置 |
+| `botmux start` | 启动 daemon（PM2 管理） |
+| `botmux stop` | 停止 daemon |
+| `botmux restart` | 重启 daemon（自动恢复活跃会话） |
+| `botmux logs` | 查看日志（`--lines N`） |
+| `botmux status` | 查看 daemon 状态 |
+| `botmux upgrade` | 升级到最新版本 |
+
+## 配置
+
+配置文件位于 `~/.botmux/.env`。运行 `botmux setup` 交互式创建，或手动编辑：
+
+### 必填
+
+| 变量 | 说明 |
+|------|------|
+| `LARK_APP_ID` | 飞书应用 App ID |
+| `LARK_APP_SECRET` | 飞书应用 App Secret |
+
+### 可选
+
+| 变量 | 默认值 | 说明 |
+|------|--------|------|
+| `CLI_ID` | `claude-code` | CLI 适配器（`claude-code`、`aiden`、`coco`、`codex`） |
+| `CLI_PATH` | _(按 CLI_ID 自动检测)_ | CLI 可执行文件路径覆盖 |
+| `BACKEND_TYPE` | `pty` | 会话后端（`pty`、`tmux`） |
+| `WORKING_DIR` | `~` | 默认工作目录 |
+| `ALLOWED_USERS` | _(空 = 不限制)_ | 允许的用户，邮箱前缀或 open_id，逗号分隔 |
+| `PROJECT_SCAN_DIR` | _(工作目录的上级)_ | 扫描 Git 仓库的目录 |
+| `WEB_HOST` | `0.0.0.0` | HTTP 服务绑定地址 |
+| `WEB_EXTERNAL_HOST` | _(自动检测局域网 IP)_ | 终端链接中的外部主机名/IP |
+| `SESSION_DATA_DIR` | `~/.botmux/data` | 会话和队列的存储目录 |
+| `DEBUG` | _(未设置)_ | 设为 `1` 启用调试日志 |
+
+## 文件位置
+
+| 路径 | 说明 |
+|------|------|
+| `~/.botmux/.env` | 配置文件 |
+| `~/.botmux/data/` | 会话数据、消息队列 |
+| `~/.botmux/logs/` | Daemon 日志 |
+
+## 使用
+
+### 使用流程
+
+1. 在飞书话题群中发送消息创建新话题
+2. 机器人弹出仓库选择卡片 — 选择项目或点击「直接开启会话」
+3. Claude Code 在所选目录下启动
+4. 话题中出现实时流式卡片，展示终端输出并支持 Markdown 渲染
+5. 每次回复创建新的流式卡片，上一轮卡片冻结在最后状态
+6. 点击卡片上的「🔑 获取操作链接」通过私聊获取可写终端链接
+7. Claude 通过 MCP 工具在话题中回复
+
+### 斜杠命令
+
+| 命令 | 说明 |
+|------|------|
+| `/repo` | 显示项目选择卡片 |
+| `/repo <N>` | 切换到上次扫描的第 N 个项目 |
+| `/cd <路径>` | 切换工作目录 |
+| `/status` | 查看会话信息（运行时间、终端地址等） |
+| `/cost` | 查看 Token 用量和费用估算 |
+| `/restart` | 重启 Claude 进程 |
+| `/close` | 关闭会话并终止 Claude |
+| `/clear` | 清除上下文（新会话，同一话题） |
+| `/schedule` | 管理定时任务 |
+| `/help` | 显示可用命令 |
+
+### 定时任务
+
+用自然语言创建周期性任务：
+
+```
+/schedule 每日17:50 帮我看看AI圈有什么新闻
+/schedule 工作日每天9:00 检查服务状态
+/schedule 每周一10:00 生成周报
+```
+
+管理任务：
+
+```
+/schedule list
+/schedule remove <id>
+/schedule enable <id>
+/schedule disable <id>
+/schedule run <id>
+```
+
+### 流式卡片
+
+每轮对话会生成一个实时更新的飞书卡片，展示：
+
+- 实时终端输出（通过 headless xterm 捕获 + 飞书卡片 v2 Markdown 渲染）
+- 状态指示：🟡 启动中 → 🔵 工作中 → 🟢 就绪
+- 操作按钮：打开终端、获取操作链接、重启 Claude、关闭会话
+
+卡片内容由 headless xterm 终端捕获，自动过滤 TUI 装饰（Logo、状态栏、提示符、框线字符），仅展示 Claude 的实际工作输出。
+
+### Web 终端
+
+每个会话提供一个 Web 终端，地址为 `http://<WEB_EXTERNAL_HOST>:<端口>`。
+
+- **只读链接** — 展示在群话题的流式卡片上
+- **可操作链接** — 按需获取（点击卡片上的「🔑 获取操作链接」通过私聊发送）
+
+特性：xterm.js + fit/unicode11/web-links 插件、TokyoNight 主题、滚动缓冲区、移动端适配。
+
+## MCP 工具
+
+Claude Code 可使用三个 MCP 工具与飞书交互：
+
+| 工具 | 说明 |
+|------|------|
+| `send_to_thread` | 向飞书话题发送消息（纯文本或富文本） |
+| `get_thread_messages` | 获取话题的消息历史 |
+| `react_to_message` | 添加或移除消息的表情回应 |
+
+## 开发
+
+```bash
+git clone <repo-url>
+cd botmux
+pnpm install
+pnpm build
+
+# 直接运行（不经 PM2）
+pnpm daemon
+
+# 或使用 PM2
+pnpm daemon:start
+pnpm daemon:logs
+```
+
+## 项目结构
+
+```
+src/
+  cli.ts                    # CLI 入口（setup/start/stop/restart/logs）
+  daemon.ts                 # Daemon 编排入口（~400 行，调用各模块）
+  worker.ts                 # Worker 进程：使用适配器管理 CLI + PTY
+  config.ts                 # 环境变量配置
+  server.ts                 # MCP Server
+  types.ts                  # IPC 消息类型
+  adapters/
+    cli/
+      types.ts              # CliAdapter 接口、CliId 类型
+      registry.ts           # 适配器工厂 + resolveCommand
+      claude-code.ts        # Claude Code 适配器
+      aiden.ts              # Aiden 适配器
+      coco.ts               # CoCo 适配器
+      codex.ts              # Codex 适配器
+    backend/
+      types.ts              # SessionBackend 接口
+      pty-backend.ts        # node-pty 后端
+      tmux-backend.ts       # tmux 后端（stub）
+  core/
+    types.ts                # DaemonSession 核心类型
+    worker-pool.ts          # Worker 进程池管理
+    command-handler.ts      # 斜杠命令处理
+    session-manager.ts      # 会话生命周期 + 路径解析
+    cost-calculator.ts      # Token 用量 & 费用估算
+    scheduler.ts            # 定时任务调度（自然语言解析）
+  im/
+    types.ts                # ImAdapter 接口定义（多 IM 抽象）
+    lark/
+      client.ts             # 飞书 API 封装
+      event-dispatcher.ts   # 飞书 WebSocket 事件路由
+      card-handler.ts       # 飞书卡片交互处理
+      card-builder.ts       # 飞书交互卡片构建
+      message-parser.ts     # 飞书事件消息解析
+  tools/
+    index.ts                # MCP 工具注册表
+    send-to-thread.ts       # MCP 工具：发送消息
+    get-thread-messages.ts  # MCP 工具：读取消息
+    react-to-message.ts     # MCP 工具：表情回应
+  services/
+    session-store.ts        # 会话持久化 (JSON)
+    schedule-store.ts       # 定时任务持久化
+    message-queue.ts        # 话题消息队列 (JSONL)
+    project-scanner.ts      # Git 仓库/Worktree 扫描
+  utils/
+    idle-detector.ts        # CLI 空闲检测（静默 + Spinner + 完成标记）
+    terminal-renderer.ts    # Headless xterm 渲染器（屏幕捕获 & TUI 过滤）
+    logger.ts               # 日志工具
+```
+
+## 许可证
+
+[MIT](LICENSE)

package/dist/adapters/backend/pty-backend.d.ts

@@ -0,0 +1,13 @@
+import type { SessionBackend, SpawnOpts } from './types.js';
+export declare class PtyBackend implements SessionBackend {
+    private process;
+    spawn(bin: string, args: string[], opts: SpawnOpts): void;
+    write(data: string): void;
+    resize(cols: number, rows: number): void;
+    /** Must be called AFTER spawn(). Callbacks registered before spawn are silently lost. */
+    onData(cb: (data: string) => void): void;
+    /** Must be called AFTER spawn(). Callbacks registered before spawn are silently lost. */
+    onExit(cb: (code: number | null, signal: string | null) => void): void;
+    kill(): void;
+}
+//# sourceMappingURL=pty-backend.d.ts.map

package/dist/adapters/backend/pty-backend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pty-backend.d.ts","sourceRoot":"","sources":["../../../src/adapters/backend/pty-backend.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5D,qBAAa,UAAW,YAAW,cAAc;IAC/C,OAAO,CAAC,OAAO,CAAyB;IAExC,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,GAAG,IAAI;IAUzD,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAIzB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAIxC,yFAAyF;IACzF,MAAM,CAAC,EAAE,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI;IAIxC,yFAAyF;IACzF,MAAM,CAAC,EAAE,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,GAAG,IAAI;IAMtE,IAAI,IAAI,IAAI;CAMb"}

package/dist/adapters/backend/pty-backend.js

@@ -0,0 +1,39 @@
+import * as pty from 'node-pty';
+export class PtyBackend {
+    process = null;
+    spawn(bin, args, opts) {
+        this.process = pty.spawn(bin, args, {
+            name: 'xterm-256color',
+            cols: opts.cols,
+            rows: opts.rows,
+            cwd: opts.cwd,
+            env: opts.env,
+        });
+    }
+    write(data) {
+        this.process?.write(data);
+    }
+    resize(cols, rows) {
+        this.process?.resize(cols, rows);
+    }
+    /** Must be called AFTER spawn(). Callbacks registered before spawn are silently lost. */
+    onData(cb) {
+        this.process?.onData(cb);
+    }
+    /** Must be called AFTER spawn(). Callbacks registered before spawn are silently lost. */
+    onExit(cb) {
+        this.process?.onExit(({ exitCode, signal }) => {
+            cb(exitCode, signal !== undefined ? String(signal) : null);
+        });
+    }
+    kill() {
+        if (this.process) {
+            try {
+                this.process.kill();
+            }
+            catch { /* already dead */ }
+            this.process = null;
+        }
+    }
+}
+//# sourceMappingURL=pty-backend.js.map

package/dist/adapters/backend/pty-backend.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pty-backend.js","sourceRoot":"","sources":["../../../src/adapters/backend/pty-backend.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,UAAU,CAAC;AAGhC,MAAM,OAAO,UAAU;IACb,OAAO,GAAoB,IAAI,CAAC;IAExC,KAAK,CAAC,GAAW,EAAE,IAAc,EAAE,IAAe;QAChD,IAAI,CAAC,OAAO,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE;YAClC,IAAI,EAAE,gBAAgB;YACtB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,GAAG,EAAE,IAAI,CAAC,GAAG;SACd,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,IAAY;QAChB,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IAED,MAAM,CAAC,IAAY,EAAE,IAAY;QAC/B,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACnC,CAAC;IAED,yFAAyF;IACzF,MAAM,CAAC,EAA0B;QAC/B,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;IAC3B,CAAC;IAED,yFAAyF;IACzF,MAAM,CAAC,EAAwD;QAC7D,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE;YAC5C,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAC7D,CAAC,CAAC,CAAC;IACL,CAAC;IAED,IAAI;QACF,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,IAAI,CAAC;gBAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;YAAC,CAAC;YAAC,MAAM,CAAC,CAAC,kBAAkB,CAAC,CAAC;YACzD,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACtB,CAAC;IACH,CAAC;CACF"}

package/dist/adapters/backend/tmux-backend.d.ts

@@ -0,0 +1,20 @@
+import type { SessionBackend, SpawnOpts } from './types.js';
+/**
+ * TmuxBackend — experimental session backend using tmux.
+ * Enables: physical `tmux attach`, web terminal, and IM all on same session.
+ * TODO: Full implementation.
+ */
+export declare class TmuxBackend implements SessionBackend {
+    private sessionName;
+    spawn(bin: string, args: string[], opts: SpawnOpts): void;
+    write(data: string): void;
+    resize(_cols: number, _rows: number): void;
+    onData(_cb: (data: string) => void): void;
+    onExit(_cb: (code: number | null, signal: string | null) => void): void;
+    kill(): void;
+    getAttachInfo(): {
+        type: "tmux";
+        sessionName: string;
+    };
+}
+//# sourceMappingURL=tmux-backend.d.ts.map

package/dist/adapters/backend/tmux-backend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tmux-backend.d.ts","sourceRoot":"","sources":["../../../src/adapters/backend/tmux-backend.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5D;;;;GAIG;AACH,qBAAa,WAAY,YAAW,cAAc;IAChD,OAAO,CAAC,WAAW,CAAM;IAEzB,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,GAAG,IAAI;IAIzD,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAIzB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAI1C,MAAM,CAAC,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI;IAIzC,MAAM,CAAC,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,GAAG,IAAI;IAIvE,IAAI,IAAI,IAAI;IAIZ,aAAa;;;;CAGd"}