opencode-lark 0.1.1

package/README.zh-CN.md

@@ -0,0 +1,324 @@
+[English](README.md)
+
+# opencode-lark
+
+> 将飞书群聊与 opencode TUI session 打通，实现双向实时消息转发。
+
+![CI](https://github.com/guazi04/opencode-lark/actions/workflows/ci.yml/badge.svg)
+![npm](https://img.shields.io/npm/v/opencode-lark.svg)
+![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)
+
+---
+
+## 功能特性
+
+- **实时桥接** — 飞书消息即时出现在 opencode TUI，agent 回复以动态卡片形式推送回飞书。
+- **WebSocket 长连接** — 采用飞书 WebSocket 长连接模式，无需公网 IP，无需轮询。
+- **SSE 流式输出** — 订阅 opencode SSE 事件流，防抖处理卡片更新，避免触发频率限制。
+- **对话记忆** — SQLite 存储每个会话的对话历史，每次消息自动携带上下文。
+- **Session 自动发现** — 自动发现并绑定当前目录的最新 TUI session，重启后映射关系持久保存。
+- **优雅重连** — 启动时指数退避重连 opencode server，最多重试 10 次，无需手动等待 server 就绪。
+- **可扩展渠道层** — `ChannelPlugin` 接口设计，可扩展接入 Slack、Discord 等其他平台，无需修改核心逻辑。
+
+---
+
+## 架构概览
+
+```
+Feishu client
+    ↕  WebSocket
+Feishu Open Platform
+    ↕  WebSocket
+opencode-lark  (本项目)
+    ↕  HTTP API + SSE
+opencode server  (localhost:4096)
+    ↕  stdin/stdout
+opencode TUI
+```
+
+> `opencode serve` 运行 HTTP server，在另一个终端用 `opencode attach` 查看 TUI 会话。
+
+**入站（飞书 → TUI）：** 飞书通过 WebSocket 发送消息，opencode-lark 标准化处理后找到绑定的 session，拼接对话历史，POST 到 opencode API。TUI 即时收到消息。
+
+**出站（TUI → 飞书）：** opencode-lark 订阅 opencode SSE 流。agent 输出文字时，`TextDelta` 事件累积并触发防抖卡片更新。`SessionIdle` 到达后，最终卡片推送到飞书。
+
+---
+
+## 安装
+
+```bash
+# 全局安装
+npm install -g opencode-lark
+# 或
+bun add -g opencode-lark
+```
+
+或从源码运行：
+
+```bash
+git clone https://github.com/guazi04/opencode-lark.git
+cd opencode-lark
+bun install
+```
+
+---
+
+## 飞书应用配置
+
+本节介绍如何创建飞书企业自建应用并配置所需权限。
+
+### 1. 创建企业自建应用
+
+1. 打开[飞书开放平台](https://open.feishu.cn/app)
+2. 点击**创建应用** → **创建企业自建应用**
+3. 填写应用名称和描述后确认
+
+### 2. 开启机器人能力
+
+进入**应用功能 → 机器人**，开启机器人功能。
+
+### 3. 获取凭证
+
+进入**凭证与基础信息**找到：
+
+- **App ID** → 设为 `FEISHU_APP_ID`
+- **App Secret** → 设为 `FEISHU_APP_SECRET`
+
+步骤 6 配置 opencode-lark 时需要这些凭证。
+
+### 4. 配置权限
+
+进入**开发配置 → 权限管理**，开通以下权限：
+
+| 权限 | 权限标识 | 用途 | 必需 |
+|---|---|---|---|
+| 获取与发送单聊、群组消息 | `im:message` | 发送消息、更新卡片 | ✅ |
+| 获取用户发给机器人的单聊消息 | `im:message.p2p_msg:readonly` | 接收私聊消息 | ✅ |
+| 获取群组中所有消息 | `im:message.group_msg` | 接收群聊中的所有消息 | ✅ |
+| 获取群组中 @机器人的消息 | `im:message.group_at_msg:readonly` | 接收群聊中 @机器人的消息 | ✅ |
+| 获取与上传图片或文件资源 | `im:resource` | 处理消息附件 | ✅ |
+| 创建并发布卡片 | `cardkit:card:write` | 渲染交互式卡片（提问、权限审批） | ✅ |
+
+### 5. 发布应用
+
+进入**应用发布 → 版本管理与发布**，创建版本并提交审核。审核通过后，将机器人添加到工作区。
+
+> **注意**：测试阶段，应用管理员可直接使用，无需等待审核通过。
+
+### 6. 配置并启动 opencode-lark
+
+在配置事件订阅之前，需要先启动 opencode-lark，飞书才能检测到 WebSocket 连接。
+
+1. 克隆仓库并安装依赖：
+   ```bash
+   git clone https://github.com/guazi04/opencode-lark.git
+   cd opencode-lark
+   bun install
+   ```
+
+2. 配置凭证：
+   ```bash
+   cp .env.example .env
+   ```
+   打开 `.env`，填入步骤 3 获取的 `FEISHU_APP_ID` 和 `FEISHU_APP_SECRET`。
+
+3. 在一个终端启动 opencode server：
+   ```bash
+   OPENCODE_SERVER_PORT=4096 opencode serve
+   ```
+
+4. 在另一个终端启动 opencode-lark：
+   ```bash
+   bun run dev
+   ```
+   保持运行，然后继续下一步配置事件订阅。
+
+> **提示**：要在 TUI 中实时查看消息，打开第三个终端并 attach 到 session：
+> ```bash
+> opencode attach http://127.0.0.1:4096 --session {session_id}
+> ```
+> `session_id` 会在 opencode-lark 启动日志中显示（如 `Bound to TUI session: ... → ses_xxxxx`）。
+
+### 7. 订阅事件
+
+进入**开发配置 → 事件订阅**，操作如下：
+
+1. 选择**长连接**模式 — 无需公网 IP
+2. 添加以下事件：
+
+| 事件名称 | 事件标识 | 用途 | 必需 |
+|---|---|---|---|
+| 接收消息 | `im.message.receive_v1` | 接收用户消息 | ✅ |
+
+> ⚠️ **重要**：保存长连接模式前 opencode-lark 必须处于运行状态（步骤 6）。如果看到“应用未建立长连接”错误，请返回步骤 6 确认应用已启动。
+
+### 8. 订阅回调（交互式卡片）
+
+进入**开发配置 → 事件与回调 → 回调订阅** — 这是与上方“事件订阅”**独立的配置项**。
+
+1. 选择**长连接**模式
+2. 添加以下回调：
+
+| 回调名称 | 回调标识 | 用途 | 必需 |
+|---|---|---|---|
+| 卡片回传交互 | `card.action.trigger` | 接收卡片按钮点击（提问回答、权限审批） | ✅ |
+
+> ⚠️ **重要**：这是交互式卡片（提问和权限审批）正常工作的必要配置。未配置时，点击卡片按钮会报错 `200340`。
+>
+> 事件订阅和回调订阅是**两个独立的设置**，必须分别配置。
+
+### 故障排除
+
+| 现象 | 可能原因 | 解决方案 |
+|---|---|---|
+| 机器人收不到消息 | 未开启长连接或事件未订阅 | 检查事件订阅，确认选择长连接模式 |
+| 凭证错误 | `.env` 中凭证有误 | 从步骤 3 重新确认 App ID 和 App Secret |
+| 收到消息但无回复 | opencode server 未启动 | 确保先启动 opencode server：`OPENCODE_SERVER_PORT=4096 opencode serve` |
+| 卡片不实时更新 | 频率限制或防抖延迟 | 正常行为，防抖处理避免触发频率限制 |
+| 点击卡片按钮报错 `200340` | 回调订阅未配置 | 进入**回调订阅** → 选择长连接 → 添加 `card.action.trigger` |
+| 保存长连接模式时报“应用未建立长连接” | 应用未启动，飞书要求先建立连接 | 先完成步骤 6 启动 opencode-lark，再回飞书后台保存设置 |
+---
+
+## 快速开始
+
+如果已完成上述飞书应用配置，opencode-lark 应该已经在运行。直接跳到下方**发送测试消息**。
+
+否则按以下步骤操作：
+
+### 前置要求
+
+- **[Bun](https://bun.sh)**（必需运行时，本项目使用 `bun:sqlite`，仅 Bun 支持）
+- **[opencode](https://opencode.ai)** 已安装在本地
+- 已配置凭证和事件订阅的飞书开放平台应用（参见[飞书应用配置](#飞书应用配置)）
+
+### 步骤
+
+**1. 克隆、安装并配置**
+
+```bash
+git clone https://github.com/guazi04/opencode-lark.git
+cd opencode-lark
+bun install
+cp .env.example .env
+```
+
+打开 `.env` 填写 `FEISHU_APP_ID` 和 `FEISHU_APP_SECRET`。
+
+**2. 启动 opencode server**
+
+```bash
+OPENCODE_SERVER_PORT=4096 opencode serve
+```
+
+opencode server 在 4096 端口监听，端口被占用时自动递增。
+
+**3. 启动 opencode-lark**
+
+在第二个终端：
+
+```bash
+bun run dev
+```
+
+或通过全局安装运行：
+
+```bash
+opencode-lark
+```
+
+`dev` 模式带 `--watch`，代码修改后自动重启。
+
+**4. 发送测试消息**
+
+向飞书机器人发送任意消息。首次联系时自动发现最新 TUI session 并回复：
+
+> Connected to session: ses_xxxxx
+
+首次消息后飞书收到 session 绑定通知，之后双向消息互通。
+
+---
+
+## 配置说明
+
+### 环境变量
+
+| 变量 | 必需 | 默认值 | 说明 |
+|----------|----------|---------|-------------|
+| `FEISHU_APP_ID` | 是 | | 飞书应用 App ID |
+| `FEISHU_APP_SECRET` | 是 | | 飞书应用 App Secret |
+| `OPENCODE_SERVER_URL` | 否 | `http://localhost:4096` | opencode server 地址 |
+| `FEISHU_WEBHOOK_PORT` | 否 | `3001` | 卡片回调端口 |
+| `OPENCODE_CWD` | 否 | `process.cwd()` | 覆盖 session 发现目录 |
+| `FEISHU_VERIFICATION_TOKEN` | 否 | | 事件订阅验证 token |
+| `FEISHU_ENCRYPT_KEY` | 否 | | 事件加密密钥 |
+
+### JSONC 配置文件
+
+`opencode-lark.jsonc`（已加入 .gitignore，从 `opencode-lark.example.jsonc` 复制）：
+（同时支持 `opencode-feishu.jsonc` 以兼容旧版）
+
+```jsonc
+// opencode-lark.jsonc
+{
+  "feishu": {
+    "appId": "${FEISHU_APP_ID}",
+    "appSecret": "${FEISHU_APP_SECRET}",
+    "verificationToken": "${FEISHU_VERIFICATION_TOKEN}",
+    "webhookPort": 3001,
+    "encryptKey": "${FEISHU_ENCRYPT_KEY}"
+  },
+  // Default opencode agent name. This should match an agent configured in your opencode setup.
+  // Common values: "build", "claude", "code" — check your opencode config for available agents.
+  "defaultAgent": "build",
+  "dataDir": "./data",
+  "progress": {
+    "debounceMs": 500,
+    "maxDebounceMs": 3000
+  }
+}
+```
+
+支持 `${ENV_VAR}` 环境变量插值和 JSONC 注释。无配置文件时自动从 `.env` 构建默认配置。
+
+---
+
+## 项目结构
+
+```
+src/
+├── index.ts         # Entry point, 9-phase startup + graceful shutdown
+├── types.ts         # Shared type definitions
+├── channel/         # ChannelPlugin interface, ChannelManager, FeishuPlugin
+├── feishu/          # Feishu REST client, CardKit, WebSocket, message dedup
+├── handler/         # MessageHandler (inbound pipeline) + StreamingBridge (SSE → cards)
+├── session/         # TUI session discovery, thread→session mapping, progress cards
+├── streaming/       # EventProcessor (SSE parsing), SessionObserver, SubAgentTracker
+├── memory/          # SQLite-backed per-thread conversation history
+├── cron/            # CronService (scheduled jobs) + HeartbeatService
+└── utils/           # Config loader, logger, SQLite init, EventListenerMap
+```
+
+---
+
+## 开发
+
+```bash
+bun run dev          # 开发模式，代码变更自动重启
+bun run start        # 生产模式
+bun run test:run     # 运行全部测试
+bun run build        # 编译到 dist/
+```
+
+> 使用 `bun run test:run` 而非 `bun test`，后者会同时扫描 `src/` 和 `dist/` 下的测试文件。
+
+---
+
+## 参与贡献
+
+请参阅 [CONTRIBUTING.md](CONTRIBUTING.md) 了解提 issue、提 PR 和代码风格的规范。
+
+---
+
+## License
+
+[MIT](LICENSE) © 2026 opencode-lark contributors

package/bin/opencode-lark.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import '../dist/index.js';

package/dist/channel/base-plugin.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Abstract base class implementing common ChannelPlugin patterns.
+ * Provides default threading adapter and leaves required fields abstract.
+ */
+import type { ChannelPlugin, ChannelId, ChannelMeta, ChannelConfigAdapter, ChannelGatewayAdapter, ChannelMessagingAdapter, ChannelOutboundAdapter, ChannelStreamingAdapter, ChannelThreadingAdapter } from "./types.js";
+/**
+ * BaseChannelPlugin — abstract base for channel integrations.
+ *
+ * Subclasses MUST provide:
+ *   - id: ChannelId
+ *   - meta: ChannelMeta
+ *   - config: ChannelConfigAdapter
+ *
+ * Provides default implementations for:
+ *   - threading: resolveThread, mapSession, getSession
+ *
+ * Optional adapters (gateway, messaging, outbound, streaming)
+ * default to undefined — subclasses override as needed.
+ */
+export declare abstract class BaseChannelPlugin implements ChannelPlugin {
+    abstract id: ChannelId;
+    abstract meta: ChannelMeta;
+    abstract config: ChannelConfigAdapter;
+    gateway?: ChannelGatewayAdapter;
+    messaging?: ChannelMessagingAdapter;
+    outbound?: ChannelOutboundAdapter;
+    streaming?: ChannelStreamingAdapter;
+    private readonly _threadSessionMap;
+    threading: ChannelThreadingAdapter;
+}
+//# sourceMappingURL=base-plugin.d.ts.map

package/dist/channel/base-plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-plugin.d.ts","sourceRoot":"","sources":["../../src/channel/base-plugin.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EACV,aAAa,EACb,SAAS,EACT,WAAW,EACX,oBAAoB,EACpB,qBAAqB,EACrB,uBAAuB,EACvB,sBAAsB,EACtB,uBAAuB,EACvB,uBAAuB,EAGxB,MAAM,YAAY,CAAA;AAEnB;;;;;;;;;;;;;GAaG;AACH,8BAAsB,iBAAkB,YAAW,aAAa;IAC9D,QAAQ,CAAC,EAAE,EAAE,SAAS,CAAA;IACtB,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAA;IAC1B,QAAQ,CAAC,MAAM,EAAE,oBAAoB,CAAA;IAGrC,OAAO,CAAC,EAAE,qBAAqB,CAAA;IAC/B,SAAS,CAAC,EAAE,uBAAuB,CAAA;IACnC,QAAQ,CAAC,EAAE,sBAAsB,CAAA;IACjC,SAAS,CAAC,EAAE,uBAAuB,CAAA;IAGnC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAA+B;IAEjE,SAAS,EAAE,uBAAuB,CAejC;CACF"}

package/dist/channel/base-plugin.js

@@ -0,0 +1,42 @@
+/**
+ * Abstract base class implementing common ChannelPlugin patterns.
+ * Provides default threading adapter and leaves required fields abstract.
+ */
+/**
+ * BaseChannelPlugin — abstract base for channel integrations.
+ *
+ * Subclasses MUST provide:
+ *   - id: ChannelId
+ *   - meta: ChannelMeta
+ *   - config: ChannelConfigAdapter
+ *
+ * Provides default implementations for:
+ *   - threading: resolveThread, mapSession, getSession
+ *
+ * Optional adapters (gateway, messaging, outbound, streaming)
+ * default to undefined — subclasses override as needed.
+ */
+export class BaseChannelPlugin {
+    // Optional adapters — subclasses override as needed
+    gateway;
+    messaging;
+    outbound;
+    streaming;
+    // Default threading adapter backed by an internal Map
+    _threadSessionMap = new Map();
+    threading = {
+        resolveThread: (inbound) => {
+            if (inbound.threadId) {
+                return `${inbound.chatId}:${inbound.threadId}`;
+            }
+            return inbound.chatId;
+        },
+        mapSession: (threadKey, sessionId) => {
+            this._threadSessionMap.set(threadKey, sessionId);
+        },
+        getSession: (threadKey) => {
+            return this._threadSessionMap.get(threadKey) ?? null;
+        },
+    };
+}
+//# sourceMappingURL=base-plugin.js.map

package/dist/channel/base-plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-plugin.js","sourceRoot":"","sources":["../../src/channel/base-plugin.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAgBH;;;;;;;;;;;;;GAaG;AACH,MAAM,OAAgB,iBAAiB;IAKrC,oDAAoD;IACpD,OAAO,CAAwB;IAC/B,SAAS,CAA0B;IACnC,QAAQ,CAAyB;IACjC,SAAS,CAA0B;IAEnC,sDAAsD;IACrC,iBAAiB,GAAG,IAAI,GAAG,EAAqB,CAAA;IAEjE,SAAS,GAA4B;QACnC,aAAa,EAAE,CAAC,OAA0B,EAAa,EAAE;YACvD,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;gBACrB,OAAO,GAAG,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,QAAQ,EAAe,CAAA;YAC7D,CAAC;YACD,OAAO,OAAO,CAAC,MAAmB,CAAA;QACpC,CAAC;QAED,UAAU,EAAE,CAAC,SAAoB,EAAE,SAAiB,EAAQ,EAAE;YAC5D,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,SAAS,EAAE,SAAS,CAAC,CAAA;QAClD,CAAC;QAED,UAAU,EAAE,CAAC,SAAoB,EAAiB,EAAE;YAClD,OAAO,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,IAAI,CAAA;QACtD,CAAC;KACF,CAAA;CACF"}

package/dist/channel/feishu/feishu-plugin.d.ts

@@ -0,0 +1,36 @@
+/**
+ * FeishuPlugin — channel adapter wrapping existing Feishu modules.
+ * Extends BaseChannelPlugin and implements all 6 adapters.
+ */
+import { BaseChannelPlugin } from "../base-plugin.js";
+import type { ChannelId, ChannelMeta, ChannelConfigAdapter, ChannelGatewayAdapter, ChannelMessagingAdapter, ChannelOutboundAdapter, ChannelStreamingAdapter, ChannelThreadingAdapter } from "../types.js";
+import type { AppConfig } from "../../utils/config.js";
+import type { FeishuApiClient } from "../../feishu/api-client.js";
+import type { CardKitClient } from "../../feishu/cardkit-client.js";
+import type { Logger } from "../../utils/logger.js";
+import type { FeishuMessageEvent, FeishuCardAction } from "../../types.js";
+export interface FeishuPluginDeps {
+    appConfig: AppConfig;
+    feishuClient: FeishuApiClient;
+    cardkitClient: CardKitClient;
+    logger: Logger;
+    onMessage?: (event: FeishuMessageEvent) => Promise<void>;
+    onCardAction?: (action: FeishuCardAction) => Promise<void>;
+}
+export declare class FeishuPlugin extends BaseChannelPlugin {
+    id: ChannelId;
+    meta: ChannelMeta;
+    private readonly appConfig;
+    private readonly feishuClient;
+    private readonly cardkitClient;
+    private readonly logger;
+    config: ChannelConfigAdapter;
+    gateway: ChannelGatewayAdapter;
+    messaging: ChannelMessagingAdapter;
+    outbound: ChannelOutboundAdapter;
+    streaming: ChannelStreamingAdapter;
+    threading: ChannelThreadingAdapter;
+    private readonly _feishuThreadMap;
+    constructor(deps: FeishuPluginDeps);
+}
+//# sourceMappingURL=feishu-plugin.d.ts.map

package/dist/channel/feishu/feishu-plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feishu-plugin.d.ts","sourceRoot":"","sources":["../../../src/channel/feishu/feishu-plugin.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AACrD,OAAO,KAAK,EACV,SAAS,EACT,WAAW,EACX,oBAAoB,EACpB,qBAAqB,EACrB,uBAAuB,EACvB,sBAAsB,EACtB,uBAAuB,EACvB,uBAAuB,EAOxB,MAAM,aAAa,CAAA;AACpB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAA;AACtD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAA;AACjE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAA;AACnE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAA;AACnD,OAAO,KAAK,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AAO1E,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,SAAS,CAAA;IACpB,YAAY,EAAE,eAAe,CAAA;IAC7B,aAAa,EAAE,aAAa,CAAA;IAC5B,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACxD,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,gBAAgB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;CAC3D;AAID,qBAAa,YAAa,SAAQ,iBAAiB;IACxC,EAAE,EAAe,SAAS,CAAA;IAC1B,IAAI,EAAE,WAAW,CAIzB;IAED,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAW;IACrC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAiB;IAC9C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAe;IAC7C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAQ;IAItB,MAAM,EAAE,oBAAoB,CAAA;IAC5B,OAAO,EAAE,qBAAqB,CAAA;IAC9B,SAAS,EAAE,uBAAuB,CAAA;IAClC,QAAQ,EAAE,sBAAsB,CAAA;IAChC,SAAS,EAAE,uBAAuB,CAAA;IAClC,SAAS,EAAE,uBAAuB,CAAA;IAE3C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAA+B;gBAEpD,IAAI,EAAE,gBAAgB;CAmInC"}

package/dist/channel/feishu/feishu-plugin.js

@@ -0,0 +1,149 @@
+/**
+ * FeishuPlugin — channel adapter wrapping existing Feishu modules.
+ * Extends BaseChannelPlugin and implements all 6 adapters.
+ */
+import { BaseChannelPlugin } from "../base-plugin.js";
+import { buildResponseCard } from "../../feishu/card-builder.js";
+import { StreamingCardSession } from "../../streaming/streaming-card.js";
+import { createFeishuWSGateway } from "../../feishu/ws-client.js";
+// ── Plugin ──
+export class FeishuPlugin extends BaseChannelPlugin {
+    id = "feishu";
+    meta = {
+        id: "feishu",
+        label: "Feishu",
+        description: "\u98de\u4e66 channel integration",
+    };
+    appConfig;
+    feishuClient;
+    cardkitClient;
+    logger;
+    // ── Adapters ──
+    config;
+    gateway;
+    messaging;
+    outbound;
+    streaming;
+    threading;
+    _feishuThreadMap = new Map();
+    constructor(deps) {
+        super();
+        this.appConfig = deps.appConfig;
+        this.feishuClient = deps.feishuClient;
+        this.cardkitClient = deps.cardkitClient;
+        this.logger = deps.logger;
+        // 1. Config adapter
+        this.config = {
+            listAccountIds: () => ["default"],
+            resolveAccount: (_id) => this.appConfig,
+        };
+        // 2. Gateway adapter
+        this.gateway = {
+            startAccount: async (_accountId, _signal) => {
+                const gw = createFeishuWSGateway({
+                    appId: this.appConfig.feishu.appId,
+                    appSecret: this.appConfig.feishu.appSecret,
+                    onMessage: async (event) => {
+                        this.logger.info(`Gateway received message: ${event.message_id}`);
+                        if (deps.onMessage) {
+                            await deps.onMessage(event);
+                        }
+                    },
+                    onCardAction: deps.onCardAction,
+                });
+                gw.start();
+            },
+        };
+        // 3. Messaging adapter
+        this.messaging = {
+            normalizeInbound: (raw) => {
+                const event = raw;
+                let text;
+                try {
+                    const parsed = JSON.parse(event.message.content);
+                    text = parsed.text ?? "";
+                }
+                catch {
+                    text = event.message.content;
+                }
+                // Feishu-specific threadId logic:
+                // - p2p: no threadId
+                // - group with root_id: threadId = root_id
+                // - group without root_id: threadId = message_id
+                let threadId;
+                if (event.chat_type === "group") {
+                    threadId = event.root_id ?? event.message_id;
+                }
+                return {
+                    messageId: event.message_id,
+                    senderId: event.sender.sender_id.open_id,
+                    text,
+                    chatId: event.chat_id,
+                    threadId,
+                    timestamp: Date.now(),
+                };
+            },
+            formatOutbound: (msg) => {
+                return buildResponseCard(msg.text);
+            },
+        };
+        // 4. Outbound adapter
+        this.outbound = {
+            sendText: async (target, text) => {
+                await this.feishuClient.sendMessage(target.address, {
+                    msg_type: "text",
+                    content: JSON.stringify({ text }),
+                });
+            },
+            sendCard: async (target, card) => {
+                await this.feishuClient.sendMessage(target.address, {
+                    msg_type: "interactive",
+                    content: JSON.stringify(card),
+                });
+            },
+        };
+        // 5. Streaming adapter
+        this.streaming = {
+            createStreamingSession: (target) => {
+                const cardSession = new StreamingCardSession({
+                    cardkitClient: this.cardkitClient,
+                    feishuClient: this.feishuClient,
+                    chatId: target.address,
+                });
+                const sessionId = `feishu_stream_${Date.now()}`;
+                const session = {
+                    sessionId,
+                    target,
+                    pendingUpdates: [],
+                    createdAt: Date.now(),
+                    flush: async () => {
+                        // No-op: flush is handled by tool status cards
+                    },
+                };
+                return session;
+            },
+        };
+        // 6. Threading adapter (Feishu-specific override)
+        // Matches feishu_key logic from index.ts:
+        //   p2p → chatId
+        //   group with root_id → chatId:rootId
+        //   group without root_id → chatId:messageId
+        // The normalizeInbound above sets threadId for group chats,
+        // so resolveThread just uses the base pattern: chatId or chatId:threadId
+        this.threading = {
+            resolveThread: (inbound) => {
+                if (inbound.threadId) {
+                    return `${inbound.chatId}:${inbound.threadId}`;
+                }
+                return inbound.chatId;
+            },
+            mapSession: (threadKey, sessionId) => {
+                this._feishuThreadMap.set(threadKey, sessionId);
+            },
+            getSession: (threadKey) => {
+                return this._feishuThreadMap.get(threadKey) ?? null;
+            },
+        };
+    }
+}
+//# sourceMappingURL=feishu-plugin.js.map

package/dist/channel/feishu/feishu-plugin.js.map

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

package/dist/channel/feishu/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./feishu-plugin.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/channel/feishu/index.d.ts.map

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

package/dist/channel/feishu/index.js

@@ -0,0 +1,2 @@
+export * from "./feishu-plugin.js";
+//# sourceMappingURL=index.js.map

package/dist/channel/feishu/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/channel/feishu/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAA"}

package/dist/channel/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./types.js";
+export * from "./base-plugin.js";
+export * from "./manager.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/channel/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/channel/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAC1B,cAAc,kBAAkB,CAAA;AAChC,cAAc,cAAc,CAAA"}

package/dist/channel/index.js

@@ -0,0 +1,4 @@
+export * from "./types.js";
+export * from "./base-plugin.js";
+export * from "./manager.js";
+//# sourceMappingURL=index.js.map

package/dist/channel/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/channel/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAC1B,cAAc,kBAAkB,CAAA;AAChC,cAAc,cAAc,CAAA"}