@lansenger-pm/openclaw-lansenger-channel 3.2.2 → 3.2.4

package/README.fr.md

@@ -33,41 +33,43 @@ Connecte OpenClaw à Lansenger — une plateforme de messagerie d'entreprise —
 
 **Stratégie par défaut** : utiliser `formatText` en priorité pour les réponses Markdown. Revenir à `text` pour les pièces jointes. Les deux types supportent @mention via le paramètre `reminder` — inclure « @姓名 » dans le texte pour les mentions.
 
-## Outils de l'agent
-
-| Outil | Description |
-|-------|-------------|
-| `lansenger_send_text` | Envoyer un message text ou formatText (Markdown par défaut) |
-| `lansenger_send_file` | Envoyer fichier/image/vidéo/audio (workspace ou chemin externe) |
-| `lansenger_send_image_url` | Envoyer une image par URL |
-| `lansenger_send_link_card` | Envoyer une carte de prévisualisation de lien |
-| `lansenger_send_app_card` | Envoyer une carte interactive/approbation |
-| `lansenger_send_app_articles` | Envoyer une carte multi-articles |
-| `lansenger_update_dynamic_card` | Mettre à jour le statut d'une carte dynamique |
-| `lansenger_revoke_message` | Révoquer un message précédemment envoyé |
-| `lansenger_query_groups` | Interroger les groupes disponibles |
+## Outils de l'agent & CLI
+
+Les messages peuvent être envoyés via les **outils de l'agent**, les **commandes CLI**, ou les deux :
+
+| Méthode | Installation | Utilisation |
+|---------|-------------|-------------|
+| Outils agent | `openclaw plugins install @lansenger-pm/openclaw-lansenger-tools` | `lansenger_send_file`, `lansenger_send_text`, etc. |
+| Commandes CLI | `pip install lansenger-cli` | `lansenger message send-file`, `lansenger message send-text`, etc. |
+
+> ⚠️ **Les outils agent nécessitent le plugin `lansenger-tools`** — installation séparée. Les commandes CLI nécessitent `lansenger-cli` (Python). Sans aucun des deux, seules les réponses Markdown normales fonctionnent.
 
 ## Installation et Configuration
 
-### Flux recommandé en 4 étapes
+### Installation recommandée
 
 ```bash
-# 1. Installer le plugin
+# 1. Installer le plugin de canal
 openclaw plugins install @lansenger-pm/openclaw-lansenger-channel
 
-# 2. Activer le plugin (si non auto-activé)
+# 2. Installer le plugin outils OU le CLI (au moins un est nécessaire pour les messages)
+#    Option A : Plugin outils agent OpenClaw
+openclaw plugins install @lansenger-pm/openclaw-lansenger-tools
+#    Option B : CLI Python (fonctionne via bash)
+pip install lansenger-cli
+
+# 3. Activer les plugins (si non auto-activés)
 openclaw config set plugins.entries.lansenger.enabled true
+openclaw config set plugins.entries.lansenger-tools.enabled true  # si Option A
 
-# 3. Configurer le canal (assistant interactif)
+# 4. Configurer le canal (assistant interactif)
 openclaw channels add
-#   OU ajout rapide (crée une config vide, puis lancez l'assistant ci-dessus) :
-#   openclaw channels add --channel lansenger
 
-# 4. Redémarrer la passerelle
+# 5. Redémarrer la passerelle
 openclaw gateway restart
 ```
 
-Les métadonnées `openclaw.install` dans `package.json` (`npmSpec`, `localPath`, `defaultChoice`) permettent l'**installation à la demande** : si un utilisateur sélectionne Lansenger dans l'assistant `openclaw channels add` avant que le plugin soit installé, OpenClaw peut l'installer automatiquement.
+Les `peerDependencies` de `package.json` avertiront lors de npm install si le plugin tools est absent. L'assistant de configuration vous rappelle également de l'installer.
 
 > **Passerelle personnalisée** : pour les déploiements entreprise (ex. 奇安信), configurez `apiGatewayUrl` dans `openclaw.json` ou via les variables d'environnement après la configuration — voir [Configuration optionnelle](#configuration-optionnelle).
 
@@ -303,6 +305,7 @@ Le plugin supporte les cartes d'approbation :
 - **reminder** — champ optionnel dans formatText ; recommandé dans les chats de groupe. Inclure « @姓名 » dans le texte pour les mentions.
 - **Média** — les balises `<media>` fonctionnent pour les fichiers du workspace ; pour les chemins externes, utilisez `lansenger_send_file`.
 - **openclaw skill/message lansenger** — ces commandes CLI n'existent PAS ; utilisez les outils de l'agent.
+- **Plugin outils** — les outils agent (`lansenger_send_*`) nécessitent le plugin `@lansenger-pm/openclaw-lansenger-tools` installé séparément. Les commandes CLI (`lansenger message send-*`) nécessitent `pip install lansenger-cli`. Installez au moins l'un des deux.
 
 ## Développement
 
@@ -336,7 +339,7 @@ openclaw-lansenger-channel/
 │   └── runtime.ts      # Runtime passerelle (méthodes, handler entrant)
 ├── skills/
 │   └── lansenger-messaging/
-│       └── SKILL.md    # Stratégie de messagerie de l'agent
+│       └── SKILL.md    # Stratégie de messagerie (outils + CLI)
 ├── dist/               # JavaScript compilé
 ├── index.ts            # Point d'entrée du plugin
 ├── setup-entry.ts      # Point d'entrée de l'assistant de configuration

package/README.md

@@ -31,7 +31,16 @@ Lansenger (蓝信) channel plugin for OpenClaw — WebSocket inbound, HTTP API o
 
 **Default strategy**: Use `formatText` first for Markdown replies. Fall back to `text` for attachments. Both `formatText` and `text` support @mention via `reminder` param — include "@姓名" in text content when mentioning.
 
-## Agent Tools
+## Agent Tools & CLI
+
+Messages can be sent via **agent tools**, **CLI commands**, or both:
+
+| Method | How to install | Usage |
+|--------|---------------|-------|
+| Agent tools | `openclaw plugins install @lansenger-pm/openclaw-lansenger-tools` | `lansenger_send_file`, `lansenger_send_text`, etc. |
+| CLI commands | `pip install lansenger-cli` | `lansenger message send-file`, `lansenger message send-text`, etc. |
+
+> ⚠️ **Agent tools require the `lansenger-tools` plugin** — install separately. CLI commands require `lansenger-cli` (Python). Without either, only normal Markdown replies work.
 
 | Tool | Description |
 |------|-------------|
@@ -45,27 +54,34 @@ Lansenger (蓝信) channel plugin for OpenClaw — WebSocket inbound, HTTP API o
 | `lansenger_revoke_message` | Revoke a previously sent message |
 | `lansenger_query_groups` | Query available groups |
 
+Tools are also available via CLI: `lansenger message send-text`, `lansenger message send-file`, etc.
+
 ## Installation & Configuration
 
-### Recommended 4-step flow
+### Recommended setup
 
 ```bash
-# 1. Install the plugin
+# 1. Install the channel plugin
 openclaw plugins install @lansenger-pm/openclaw-lansenger-channel
 
-# 2. Enable the plugin (if not auto-enabled)
+# 2. Install the tools plugin OR the CLI (at least one is needed for messaging)
+#    Option A: OpenClaw agent tools plugin
+openclaw plugins install @lansenger-pm/openclaw-lansenger-tools
+#    Option B: Python CLI (works via bash)
+pip install lansenger-cli
+
+# 3. Enable the plugins (if not auto-enabled)
 openclaw config set plugins.entries.lansenger.enabled true
+openclaw config set plugins.entries.lansenger-tools.enabled true  # if using Option A
 
-# 3. Configure the channel (interactive wizard)
+# 4. Configure the channel (interactive wizard)
 openclaw channels add
-#   OR quick add (creates empty config, then run wizard above):
-#   openclaw channels add --channel lansenger
 
-# 4. Restart the gateway
+# 5. Restart the gateway
 openclaw gateway restart
 ```
 
-The `openclaw.install` metadata in `package.json` (`npmSpec`, `localPath`, `defaultChoice`) enables **install-on-demand**: if a user selects Lansenger in the `openclaw channels add` wizard before the plugin is installed, OpenClaw can automatically install it using this metadata.
+The `package.json` `peerDependencies` will warn during npm install if the tools plugin is missing. The setup wizard also reminds you to install it.
 
 > **Custom gateway**: For enterprise deployments (e.g. 奇安信), set `apiGatewayUrl` in `openclaw.json` or environment after configuration — see [Optional Configuration](#optional-configuration).
 
@@ -295,6 +311,7 @@ The plugin supports approval workflow cards:
 - **reminder** — optional in formatText; recommended in group chat. Include "@姓名" in text when mentioning.
 - **Media** — `<media>` tags work for workspace files; for external paths use `lansenger_send_file`.
 - **openclaw skill/message lansenger** — these CLI commands do NOT exist; use agent tools instead.
+- **Tools plugin** — agent tools (`lansenger_send_*`) require `@lansenger-pm/openclaw-lansenger-tools` plugin installed separately. CLI commands (`lansenger message send-*`) require `pip install lansenger-cli`. Install at least one.
 
 ## Development
 
@@ -328,7 +345,7 @@ openclaw-lansenger-channel/
 │   └── runtime.ts      # Gateway runtime (methods, inbound handler)
 ├── skills/
 │   └── lansenger-messaging/
-│       └── SKILL.md    # Agent messaging strategy
+│       └── SKILL.md    # Agent messaging strategy (tools + CLI)
 ├── dist/               # Compiled JavaScript
 ├── index.ts            # Plugin entry point
 ├── setup-entry.ts      # Setup wizard entry

package/README.zhHans.md

@@ -33,7 +33,16 @@
 
 **默认策略**：优先使用 `formatText` 发送 Markdown 回复。附件使用 `text` 回退。两种类型均支持 @mention（通过 `reminder` 参数）—提及用户时在文本中包含"@姓名"。
 
-## 代理工具
+## 代理工具 & CLI
+
+消息可以通过**代理工具**、**CLI 命令**或两者发送：
+
+| 方式 | 安装方法 | 使用 |
+|------|----------|------|
+| 代理工具 | `openclaw plugins install @lansenger-pm/openclaw-lansenger-tools` | `lansenger_send_file`、`lansenger_send_text` 等 |
+| CLI 命令 | `pip install lansenger-cli` | `lansenger message send-file`、`lansenger message send-text` 等 |
+
+> ⚠️ **代理工具需要 `lansenger-tools` 插件** — 需单独安装。CLI 命令需要 `lansenger-cli`（Python）。两者均未安装时，代理只能通过普通 Markdown 文本回复。
 
 | 工具 | 说明 |
 |------|------|
@@ -47,27 +56,34 @@
 | `lansenger_revoke_message` | 撤回已发送的消息 |
 | `lansenger_query_groups` | 查询可用群组 |
 
+工具也可通过 CLI 使用：`lansenger message send-text`、`lansenger message send-file` 等。
+
 ## 安装与配置
 
-### 推荐 4 步流程
+### 推荐安装流程
 
 ```bash
-# 1. 安装插件
+# 1. 安装频道插件
 openclaw plugins install @lansenger-pm/openclaw-lansenger-channel
 
-# 2. 启用插件（如未自动启用）
+# 2. 安装工具插件或 CLI（至少需要一个来发送消息）
+#    方案 A：OpenClaw 代理工具插件
+openclaw plugins install @lansenger-pm/openclaw-lansenger-tools
+#    方案 B：Python CLI（通过 bash 调用）
+pip install lansenger-cli
+
+# 3. 启用插件（如未自动启用）
 openclaw config set plugins.entries.lansenger.enabled true
+openclaw config set plugins.entries.lansenger-tools.enabled true  # 使用方案 A 时
 
-# 3. 配置频道（交互式向导）
+# 4. 配置频道（交互式向导）
 openclaw channels add
-#   或者快速添加（创建空配置，再运行上面的向导）：
-#   openclaw channels add --channel lansenger
 
-# 4. 重启网关
+# 5. 重启网关
 openclaw gateway restart
 ```
 
-`package.json` 中的 `openclaw.install` 元数据（`npmSpec`、`localPath`、`defaultChoice`）支持**按需安装**：如果用户在 `openclaw channels add` 向导中选择 Lansenger 但插件未安装，OpenClaw 可自动安装该插件。
+`package.json` 的 `peerDependencies` 在 npm install 时会警告缺失 tools 插件。设置向导也会提醒安装。
 
 > **自定义网关**：企业私有化部署（如奇安信）需在配置后通过 `openclaw.json` 或环境变量设置 `apiGatewayUrl` — 见[可选配置](#可选配置)。
 
@@ -303,6 +319,7 @@ openclaw channels status --probe
 - **reminder** — formatText 中可选字段；群聊中建议使用。提及用户时在文本中包含"@姓名"。
 - **媒体标签** — `<media>` 标签适用于工作区文件；外部路径请使用 `lansenger_send_file`。
 - **openclaw skill/message lansenger** — 这些 CLI 命令不存在；请使用代理工具。
+- **工具插件** — 代理工具（`lansenger_send_*`）需要单独安装 `@lansenger-pm/openclaw-lansenger-tools` 插件。CLI 命令（`lansenger message send-*`）需要 `pip install lansenger-cli`。至少安装其中一个。
 
 ## 开发
 
@@ -336,7 +353,7 @@ openclaw-lansenger-channel/
 │   └── runtime.ts      # 网关运行时（方法、入站处理器）
 ├── skills/
 │   └── lansenger-messaging/
-│       └── SKILL.md    # 代理消息策略
+│       └── SKILL.md    # 代理消息策略（工具 + CLI）
 ├── dist/               # 编译后的 JavaScript
 ├── index.ts            # 插件入口
 ├── setup-entry.ts      # 设置向导入口

package/README.zhHant.md

@@ -33,41 +33,43 @@
 
 **預設策略**：優先使用 `formatText` 傳送 Markdown 回覆。附件使用 `text` 回退。兩種類型均支援 @mention（透過 `reminder` 參數）—提及使用者時在文字中包含「@姓名」。
 
-## 代理工具
-
-| 工具 | 說明 |
-|------|------|
-| `lansenger_send_text` | 傳送文字或 formatText 訊息（預設 Markdown） |
-| `lansenger_send_file` | 傳送檔案/圖片/影片/語音（工作區或外部路徑） |
-| `lansenger_send_image_url` | 透過 URL 傳送圖片 |
-| `lansenger_send_link_card` | 傳送富連結預覽卡片 |
-| `lansenger_send_app_card` | 傳送互動/審批卡片 |
-| `lansenger_send_app_articles` | 傳送多文章卡片 |
-| `lansenger_update_dynamic_card` | 原地更新動態卡片狀態 |
-| `lansenger_revoke_message` | 撤回已傳送的訊息 |
-| `lansenger_query_groups` | 查詢可用群組 |
+## 代理工具 & CLI
+
+訊息可以透過**代理工具**、**CLI 命令**或兩者傳送：
+
+| 方式 | 安裝方法 | 使用 |
+|------|----------|------|
+| 代理工具 | `openclaw plugins install @lansenger-pm/openclaw-lansenger-tools` | `lansenger_send_file`、`lansenger_send_text` 等 |
+| CLI 命令 | `pip install lansenger-cli` | `lansenger message send-file`、`lansenger message send-text` 等 |
+
+> ⚠️ **代理工具需要 `lansenger-tools` 插件** — 需單獨安裝。CLI 命令需要 `lansenger-cli`（Python）。兩者均未安裝時，代理只能透過普通 Markdown 文字回覆。
 
 ## 安裝與設定
 
-### 建議 4 步流程
+### 建議安裝流程
 
 ```bash
-# 1. 安裝插件
+# 1. 安裝頻道插件
 openclaw plugins install @lansenger-pm/openclaw-lansenger-channel
 
-# 2. 啟用插件（如未自動啟用）
+# 2. 安裝工具插件或 CLI（至少需要一個來傳送訊息）
+#    方案 A：OpenClaw 代理工具插件
+openclaw plugins install @lansenger-pm/openclaw-lansenger-tools
+#    方案 B：Python CLI（透過 bash 呼叫）
+pip install lansenger-cli
+
+# 3. 啟用插件（如未自動啟用）
 openclaw config set plugins.entries.lansenger.enabled true
+openclaw config set plugins.entries.lansenger-tools.enabled true  # 使用方案 A 時
 
-# 3. 配置頻道（互動式精靈）
+# 4. 配置頻道（互動式精靈）
 openclaw channels add
-#   或快速新增（建立空設定，再執行上面的精靈）：
-#   openclaw channels add --channel lansenger
 
-# 4. 重啟閘道
+# 5. 重啟閘道
 openclaw gateway restart
 ```
 
-`package.json` 中的 `openclaw.install` 元資料（`npmSpec`、`localPath`、`defaultChoice`）支援**按需安裝**：如果使用者在 `openclaw channels add` 精靈中選擇 Lansenger 但插件未安裝，OpenClaw 可自動安裝該插件。
+`package.json` 的 `peerDependencies` 在 npm install 時會警告缺少 tools 插件。設定精靈也會提醒安裝。
 
 > **自訂閘道**：企業私有化部署（如奇安信）需在設定後透過 `openclaw.json` 或環境變數設定 `apiGatewayUrl` — 見[可選設定](#可選設定)。
 
@@ -303,6 +305,7 @@ openclaw channels status --probe
 - **reminder**——formatText 中可選欄位；群組聊天中建議使用。提及使用者時在文字中包含「@姓名」。
 - **媒體標籤**——`<media>` 標籤適用於工作區檔案；外部路徑請使用 `lansenger_send_file`。
 - **openclaw skill/message lansenger**——這些 CLI 命令不存在；請使用代理工具。
+- **工具插件**——代理工具（`lansenger_send_*`）需要單獨安裝 `@lansenger-pm/openclaw-lansenger-tools` 插件。CLI 命令（`lansenger message send-*`）需要 `pip install lansenger-cli`。至少安裝其中一個。
 
 ## 開發
 
@@ -336,7 +339,7 @@ openclaw-lansenger-channel/
 │   └── runtime.ts      # 閘道運行時（方法、入站處理器）
 ├── skills/
 │   └── lansenger-messaging/
-│       └── SKILL.md    # 代理訊息策略
+│       └── SKILL.md    # 代理訊息策略（工具 + CLI）
 ├── dist/               # 編譯後的 JavaScript
 ├── index.ts            # 插件入口
 ├── setup-entry.ts      # 設定精靈入口

package/README.zhHantHK.md

@@ -33,41 +33,43 @@
 
 **預設策略**：優先使用 `formatText` 發送 Markdown 回覆。附件使用 `text` 回退。兩種類型均支援 @mention（透過 `reminder` 參數）—提及使用者時在文字中包含「@姓名」。
 
-## 代理工具
-
-| 工具 | 說明 |
-|------|------|
-| `lansenger_send_text` | 發送文字或 formatText 訊息（預設 Markdown） |
-| `lansenger_send_file` | 發送檔案/圖片/影片/語音（工作區或外部路徑） |
-| `lansenger_send_image_url` | 透過 URL 發送圖片 |
-| `lansenger_send_link_card` | 發送富連結預覽卡片 |
-| `lansenger_send_app_card` | 發送互動/審批卡片 |
-| `lansenger_send_app_articles` | 發送多文章卡片 |
-| `lansenger_update_dynamic_card` | 原地更新動態卡片狀態 |
-| `lansenger_revoke_message` | 撤回已發送的訊息 |
-| `lansenger_query_groups` | 查詢可用群組 |
+## 代理工具 & CLI
+
+訊息可以透過**代理工具**、**CLI 命令**或兩者發送：
+
+| 方式 | 安裝方法 | 使用 |
+|------|----------|------|
+| 代理工具 | `openclaw plugins install @lansenger-pm/openclaw-lansenger-tools` | `lansenger_send_file`、`lansenger_send_text` 等 |
+| CLI 命令 | `pip install lansenger-cli` | `lansenger message send-file`、`lansenger message send-text` 等 |
+
+> ⚠️ **代理工具需要 `lansenger-tools` 插件** — 需單獨安裝。CLI 命令需要 `lansenger-cli`（Python）。兩者均未安裝時，代理只能透過普通 Markdown 文字回覆。
 
 ## 安裝與設定
 
-### 建議 4 步流程
+### 建議安裝流程
 
 ```bash
-# 1. 安裝插件
+# 1. 安裝頻道插件
 openclaw plugins install @lansenger-pm/openclaw-lansenger-channel
 
-# 2. 啟用插件（如未自動啟用）
+# 2. 安裝工具插件或 CLI（至少需要一個來發送訊息）
+#    方案 A：OpenClaw 代理工具插件
+openclaw plugins install @lansenger-pm/openclaw-lansenger-tools
+#    方案 B：Python CLI（透過 bash 呼叫）
+pip install lansenger-cli
+
+# 3. 啟用插件（如未自動啟用）
 openclaw config set plugins.entries.lansenger.enabled true
+openclaw config set plugins.entries.lansenger-tools.enabled true  # 使用方案 A 時
 
-# 3. 配置頻道（互動式精靈）
+# 4. 配置頻道（互動式精靈）
 openclaw channels add
-#   或快速新增（建立空設定，再執行上面的精靈）：
-#   openclaw channels add --channel lansenger
 
-# 4. 重啟網關
+# 5. 重啟網關
 openclaw gateway restart
 ```
 
-`package.json` 中的 `openclaw.install` 元資料（`npmSpec`、`localPath`、`defaultChoice`）支援**按需安裝**：如果使用者在 `openclaw channels add` 精靈中選擇 Lansenger 但插件未安裝，OpenClaw 可自動安裝該插件。
+`package.json` 的 `peerDependencies` 在 npm install 時會警告缺少 tools 插件。設定精靈也會提醒安裝。
 
 > **自訂閘道**：企業私有化部署（如奇安信）需在設定後透過 `openclaw.json` 或環境變數設定 `apiGatewayUrl` — 見[可選設定](#可選設定)。
 
@@ -305,6 +307,7 @@ openclaw channels status --probe
 - **reminder** — formatText 中可選欄位；群組聊天中建議使用。提及使用者時在文字中包含「@姓名」。
 - **媒體標籤** — `<media>` 標籤適用於工作區檔案；外部路徑請使用 `lansenger_send_file`。
 - **openclaw skill/message lansenger** — 這些 CLI 命令不存在；請使用代理工具。
+- **工具插件** — 代理工具（`lansenger_send_*`）需要單獨安裝 `@lansenger-pm/openclaw-lansenger-tools` 插件。CLI 命令（`lansenger message send-*`）需要 `pip install lansenger-cli`。至少安裝其中一個。
 
 ## 開發
 
@@ -338,7 +341,7 @@ openclaw-lansenger-channel/
 │   └── runtime.ts      # 網關運行時（方法、入站處理器）
 ├── skills/
 │   └── lansenger-messaging/
-│       └── SKILL.md    # 代理訊息策略
+│       └── SKILL.md    # 代理訊息策略（工具 + CLI）
 ├── dist/               # 編譯後的 JavaScript
 ├── index.ts            # 插件入口
 ├── setup-entry.ts      # 設定精靈入口

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+import { defineChannelPluginEntry } from "openclaw/plugin-sdk/channel-core";
+import type { ChannelConfigSchema } from "openclaw/plugin-sdk/channel-core";
+export { resolveAccount, makeClient } from "./src/channel.js";
+export type { ResolvedAccount } from "./src/channel.js";
+export { getRunningClient, getRunningAccount, getLastInboundChatId } from "./src/runtime.js";
+export { LansengerClient } from "./src/client.js";
+export type { ChannelConfigSchema } from "openclaw/plugin-sdk/channel-core";
+declare const entry: ReturnType<typeof defineChannelPluginEntry> & {
+    configSchema?: ChannelConfigSchema;
+};
+export default entry;

package/dist/setup-entry.d.ts

@@ -0,0 +1,8 @@
+declare const _default: {
+    plugin: import("openclaw/plugin-sdk/channel-core").ChannelPlugin<import("./index.js").ResolvedAccount, {
+        ok: boolean;
+        appId?: string;
+        error?: string;
+    }>;
+};
+export default _default;

package/dist/src/channel.d.ts

@@ -0,0 +1,23 @@
+import type { OpenClawConfig, ChannelPlugin } from "openclaw/plugin-sdk/channel-core";
+import { LansengerClient } from "./client.js";
+import type { ClientLogger } from "./client.js";
+type LansengerProbeResult = {
+    ok: boolean;
+    appId?: string;
+    error?: string;
+};
+type ResolvedAccount = {
+    accountId: string | null;
+    appId: string;
+    appSecret: string;
+    apiGatewayUrl: string;
+    allowFrom: string[];
+    dmPolicy: string | undefined;
+    homeChannel: string | undefined;
+    enabled: boolean;
+};
+declare function resolveAccount(cfg: OpenClawConfig, accountId?: string | null): ResolvedAccount;
+declare function makeClient(account: ResolvedAccount, logger?: ClientLogger): LansengerClient;
+export declare const lansengerPlugin: ChannelPlugin<ResolvedAccount, LansengerProbeResult>;
+export { resolveAccount, makeClient };
+export type { ResolvedAccount };

package/dist/src/channel.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/client.d.ts

@@ -0,0 +1,208 @@
+export type ClientLogger = {
+    info: (message: string) => void;
+    error: (message: string) => void;
+};
+declare const DEFAULT_API_GATEWAY_URL = "https://open.e.lanxin.cn/open/apigw";
+declare const MAX_MESSAGE_LENGTH = 4000;
+export type ApiResult = {
+    success: boolean;
+    messageId?: string | undefined;
+    error?: string | undefined;
+    rawResponse?: unknown;
+};
+export declare function mediaTypeFromPath(filePath: string): number;
+export declare class LansengerClient {
+    private appId;
+    private appSecret;
+    private apiGatewayUrl;
+    private appToken;
+    private tokenExpiry;
+    private ws;
+    private wsTask;
+    private running;
+    private backoffIdx;
+    private heartbeatTimer;
+    private pongTimeoutTimer;
+    private lastPongAt;
+    private messageHandler;
+    private log;
+    private chatTypeMap;
+    private userLangMap;
+    constructor(config: {
+        appId: string;
+        appSecret: string;
+        apiGatewayUrl?: string;
+        logger?: ClientLogger;
+    });
+    setMessageHandler(handler: (event: InboundEvent) => Promise<void>): void;
+    isWsAlive(): boolean;
+    getAppToken(): Promise<string | null>;
+    sendText(chatId: string, content: string, reminder?: ReminderParams): Promise<ApiResult>;
+    sendFormatText(chatId: string, content: string, reminder?: ReminderParams): Promise<ApiResult>;
+    sendTextWithMedia(chatId: string, content: string, mediaType: number, mediaIds: string[], reminder?: ReminderParams): Promise<ApiResult>;
+    uploadMedia(filePath: string, mediaType?: number): Promise<{
+        mediaId: string;
+    } | {
+        error: string;
+    }>;
+    sendFile(chatId: string, filePath: string, caption?: string, mediaType?: number): Promise<ApiResult>;
+    sendImageUrl(chatId: string, imageUrl: string, caption?: string): Promise<ApiResult>;
+    revokeMessage(messageIds: string[], chatType?: string, senderId?: string): Promise<ApiResult>;
+    sendLinkCard(chatId: string, title: string, link: string, options?: LinkCardOptions): Promise<ApiResult>;
+    sendI18nAppCard(chatId: string, cardData: I18nAppCardData): Promise<ApiResult>;
+    sendAppCard(chatId: string, cardData: AppCardData): Promise<ApiResult>;
+    sendAppArticles(chatId: string, articles: AppArticle[], options?: ArticleCardOptions): Promise<ApiResult>;
+    updateCardStatus(messageId: string, status: "pending" | "approved" | "denied", lang?: "zh" | "en"): Promise<ApiResult>;
+    updateDynamicCard(msgId: string, headStatusInfo?: Record<string, string>, links?: Array<{
+        title: string;
+        url: string;
+    }>, isLastUpdate?: boolean): Promise<ApiResult>;
+    queryGroups(pageOffset?: number, pageSize?: number): Promise<{
+        totalGroupIds: number;
+        groupIds: string[];
+    } | {
+        error: string;
+    }>;
+    detectLang(text: string): "zh" | "en";
+    cacheUserLang(userId: string, text: string): void;
+    getUserLang(userId: string): "zh" | "en";
+    cacheChatType(chatId: string, chatType: "group" | "dm"): void;
+    getChatType(chatId: string): "group" | "dm" | undefined;
+    isGroupChat(chatId: string): boolean;
+    downloadMedia(mediaId: string): Promise<{
+        bytes: Buffer;
+        ext?: string;
+    } | null>;
+    saveMediaToTemp(mediaBytes: Buffer, mediaKind?: string, suggestedExt?: string): Promise<string | null>;
+    processRawMessage(raw: string): Promise<InboundEvent[]>;
+    connect(): Promise<boolean>;
+    disconnect(): Promise<void>;
+    private getWsUrl;
+    private runWs;
+    private startHeartbeat;
+    private clearPongTimeout;
+    private stopHeartbeat;
+    private msgTarget;
+    private extractText;
+    private downloadAllMedia;
+    private postJson;
+}
+export type ReminderParams = {
+    all?: boolean;
+    userIds?: string[];
+};
+export type LinkCardOptions = {
+    description?: string;
+    iconLink?: string;
+    pcLink?: string;
+    fromName?: string;
+    fromIconLink?: string;
+};
+export type AppCardField = {
+    key: string;
+    value: string;
+};
+export type AppCardLink = {
+    title: string;
+    url: string;
+};
+export type AppCardButton = {
+    title: string;
+    action: string;
+};
+export type HeadStatusInfo = {
+    iconLink?: string;
+    description: string;
+    colour?: string;
+};
+export type AppCardData = {
+    headTitle?: string;
+    headIconId?: string;
+    headIconUrl?: string;
+    isDynamic?: boolean;
+    headStatusInfo?: HeadStatusInfo;
+    bodyTitle: string;
+    bodySubTitle?: string;
+    bodyContent?: string;
+    signature?: string;
+    staffId?: string;
+    fields?: AppCardField[];
+    links?: AppCardLink[];
+    buttons?: AppCardButton[];
+    cardLink?: string;
+    pcCardLink?: string;
+    padCardLink?: string;
+};
+export type AppCardOptions = {
+    isDynamic?: boolean;
+    cover?: string;
+    link?: string;
+    pcLink?: string;
+    actionLink?: string;
+    actionText?: string;
+};
+export type AppArticle = {
+    title: string;
+    summary?: string;
+    imgUrl: string;
+    url: string;
+    pcUrl?: string;
+    padUrl?: string;
+};
+export type ArticleCardOptions = {
+    sourceName?: string;
+    sourceIcon?: string;
+};
+export type InboundEvent = {
+    messageId: string;
+    text: string;
+    chatId: string;
+    chatName?: string;
+    isGroup: boolean;
+    senderId: string;
+    userName: string;
+    rawMessage: Record<string, any>;
+    msgType: string;
+    mediaPaths?: string[];
+};
+export type LansengerApiResponse = {
+    errCode: number;
+    errMsg?: string;
+    data?: {
+        appToken?: string;
+        expiresIn?: number;
+        wsEndpoint?: string;
+        msgId?: string;
+        mediaId?: string;
+    };
+};
+export type LansengerWsMessage = {
+    events?: Array<{
+        data: Record<string, any>;
+    }>;
+};
+export type I18nObj = {
+    zhHans: string;
+    zhHant: string;
+    zhHantHK: string;
+    en: string;
+    fr: string;
+};
+export type I18nAppCardData = {
+    i18nHeadTitle: I18nObj;
+    headIconId?: string;
+    i18nBodyTitle?: I18nObj;
+    i18nBodySubTitle?: I18nObj;
+    i18nBodyContent?: I18nObj;
+    i18nSignature?: I18nObj;
+    i18nFields?: Array<{
+        i18nKey: I18nObj;
+        i18nValue: I18nObj;
+        timestamp: number;
+    }>;
+    i18nLinks?: Array<unknown>;
+    cardLink?: string;
+    pcCardLink?: string;
+};
+export declare function buildI18n(zhHans: string, zhHant: string, zhHantHK: string, en: string, fr: string): I18nObj;
+export { DEFAULT_API_GATEWAY_URL, MAX_MESSAGE_LENGTH };

package/dist/src/client.test.d.ts

@@ -0,0 +1 @@
+export {};