@xpert-ai/plugin-community-wechat 0.1.0

package/README.md

@@ -0,0 +1,353 @@
+# Personal WeChat wx2.0 Plugin
+
+个人微信 wx2.0 插件用于对接具备 webhook 推送与文本发送接口的 wx2.0 HTTP 服务，将个人微信消息接入 Xpert Agent，并把 Agent 最终文本回复通过 wx2.0 发送回会话。
+
+## 功能概览
+
+- 接收 wx2.0 webhook 推送的个人微信消息。
+- 兼容两种入站格式：
+  - 全局 webhook：`webhook.allMessagePushUrl` / `AllMsgPushUrl`。
+  - 单账号回调：`POST /message/SetCallback?key=<uuid>`。
+- 将消息规范化后派发给绑定的 Xpert Agent。
+- 仅发送 Agent 最终文本回复到微信。
+- 支持 wx2.0 v2 发送接口：`POST /v1/message/sendtext`。
+- 可选回退旧发送接口：`POST /message/SendTextMessage?key=<uuid>`。
+- 提供 Personal WeChat Workbench，用于查看账号、会话、消息日志、配置和运行日志。
+- 提供 Agent middleware tools，用于 assistant 运行时发现 workbench，并辅助查询状态、回调配置、账号和日志。
+- 提供两个 Assistant Template：
+  - `wechat-personal-admin-assistant`：管理员模板，用于管理组织内所有个人微信集成。
+  - `wechat-personal-user-assistant`：使用者模板，用于接收微信消息并自动回复。
+
+## 消息闭环
+
+```text
+微信用户
+  -> wx2.0
+  -> Xpert webhook /api/wechat-personal/webhook/:integrationId
+  -> wechat_personal trigger
+  -> Xpert Agent
+  -> Agent final text
+  -> wx2.0 /v1/message/sendtext
+  -> 微信用户
+```
+
+首版只处理文本消息和文本回复，不发送图片、文件、语音，也不把流式 token 实时推送到微信。
+
+## 前置条件
+
+1. wx2.0 服务已启动，并且 Xpert 后端可以访问它的 HTTP 地址。
+2. Xpert 后端配置了可被 wx2.0 访问的 `API_BASE_URL`。
+3. 插件已安装并启用。
+4. 已创建或准备创建一个使用 `wechat-personal-admin-assistant` 或 `wechat-personal-user-assistant` 模板的 Agent。
+
+`API_BASE_URL` 很重要。它决定 wx2.0 收到消息后回调到哪里。
+
+```sh
+API_BASE_URL=https://your-xpert-api.example.com
+```
+
+本机调试时可以是：
+
+```sh
+API_BASE_URL=http://127.0.0.1:3000
+```
+
+如果 wx2.0 在 Docker 或另一台机器里，不能随便使用 `localhost`，因为 `localhost` 会指向 wx2.0 所在环境本身。
+
+## 创建个人微信集成
+
+在 Xpert 集成配置页选择提供商：
+
+```text
+个人微信 wx2.0
+```
+
+字段建议如下。
+
+| 字段 | 是否必填 | 建议值 | 说明 |
+| --- | --- | --- | --- |
+| wx2.0 服务地址 | 是 | `http://127.0.0.1:8058` | Xpert 后端主动调用 wx2.0 发消息的地址。生产环境请填写 Xpert 后端可访问的 wx2.0 地址。 |
+| API 版本前缀 | 否 | `/v1/` | 用于拼出发送接口 `{baseUrl}/{apiVersion}message/sendtext`。 |
+| 请求超时（毫秒） | 否 | `10000` | Xpert 调 wx2.0 的 HTTP 超时时间。 |
+| API Token | 否 | 留空 | 仅当 wx2.0 启用 token 校验时填写。插件会作为 `token` header 发送。 |
+| 首选语言 | 否 | `zh-Hans` | 用于默认提示和部分系统回复。 |
+| 回调密钥 | 否 | 留空或随机字符串 | 用于保护 Xpert webhook。填写后回调 URL 会带 `?secret=...`，也支持 `x-wechat-callback-secret` header。 |
+| 群聊触发方式 | 否 | `mention_or_keywords` | 控制群聊中哪些消息会交给 Agent。 |
+| 群聊关键词 | 否 | 如 `小助手`、`客服` | 群聊触发方式包含关键词时使用。 |
+| 忽略自己发出的消息 | 否 | 开启 | 避免自己或机器人发出的消息再次触发 Agent。 |
+| 失败时回退旧发送接口 | 否 | 开启 | `/v1/message/sendtext` 失败时尝试旧接口。 |
+
+最小可用配置：
+
+```text
+wx2.0 服务地址: http://127.0.0.1:8058
+API 版本前缀: /v1/
+请求超时: 10000
+首选语言: zh-Hans
+群聊触发方式: mention_or_keywords
+忽略自己发出的消息: 开启
+失败时回退旧发送接口: 开启
+```
+
+保存后，进入 Personal WeChat Workbench 的账号或配置页面，复制 Xpert webhook URL。
+
+格式类似：
+
+```text
+https://your-xpert-api.example.com/api/wechat-personal/webhook/<integrationId>
+```
+
+如果配置了回调密钥，格式类似：
+
+```text
+https://your-xpert-api.example.com/api/wechat-personal/webhook/<integrationId>?secret=<callbackSecret>
+```
+
+## 配置 wx2.0 回调
+
+wx2.0 需要把收到的微信消息推送给 Xpert webhook。推荐优先使用全局 webhook。
+
+### 方式一：全局 webhook（推荐）
+
+在 wx2.0 配置中设置：
+
+```text
+webhook.allMessagePushUrl = <Xpert webhook URL>
+```
+
+或：
+
+```text
+AllMsgPushUrl = <Xpert webhook URL>
+```
+
+这种方式适合多个账号统一推送。插件会从 payload 中读取 `uuid`、`contactid`、`content`、`sendusername`、`ownerwxid`、`msgtype`、`isself` 等字段。
+
+### 方式二：单账号 SetCallback
+
+如果希望按账号设置回调，可调用 wx2.0 的旧回调接口：
+
+```sh
+curl -X POST "http://127.0.0.1:8058/message/SetCallback?key=<uuid>" \
+  -H "Content-Type: application/json" \
+  -d '{"CallbackURL":"<Xpert webhook URL>","Enabled":true}'
+```
+
+其中：
+
+- `<uuid>` 是 wx2.0 中该微信账号的 key/uuid。
+- `<Xpert webhook URL>` 是保存集成后得到的 Xpert webhook URL。
+
+Workbench 中也提供生成 SetCallback curl 和注册回调的操作。
+
+## 配置 Assistant
+
+插件内置两个模板，按角色选择：
+
+```text
+wechat-personal-admin-assistant
+wechat-personal-user-assistant
+```
+
+### 管理员模板
+
+`wechat-personal-admin-assistant` 面向管理员。它不包含 `wechat_personal` trigger，不会接收或回复微信用户消息。
+
+它包含：
+
+- 一个主 Agent：负责排查和管理个人微信运行状态。
+- 一个 `WechatPersonalRuntimeMiddleware`：负责让前端发现 Personal WeChat Workbench，并提供运行时管理工具。
+
+管理员 Workbench 在没有绑定单一集成时，会展示当前组织内所有 `wechat_personal` 集成的运行数据，包括账号、会话、消息、日志、每个集成的 webhook URL 和 SetCallback curl。
+
+### 使用者模板
+
+`wechat-personal-user-assistant` 面向最终微信会话回复。它包含：
+
+- 一个主 Agent：负责生成自然微信回复。
+- 一个 `wechat_personal` trigger：负责接收个人微信消息并派发给 Agent。
+- 一个 `WechatPersonalRuntimeMiddleware`：负责让前端发现 Personal WeChat Workbench，并提供运行时管理工具。
+
+创建后需要确认两个节点都选择了同一个个人微信集成：
+
+1. `个人微信消息触发器`
+   - `integrationId`: 选择刚创建的个人微信集成。
+   - `sessionTimeoutSeconds`: 默认 `3600`。
+   - `summaryWindowSeconds`: 默认 `0`，表示收到消息立即派发。
+   - `groupTriggerMode`: 推荐 `mention_or_keywords`。
+   - `groupKeywords`: 按需配置。
+
+2. `Personal WeChat Runtime Tools`
+   - `integrationId`: 选择同一个个人微信集成。
+
+发布或启用 Assistant 后，插件会把该集成绑定到当前 Agent。
+
+## 群聊触发方式
+
+`groupTriggerMode` 支持：
+
+| 值 | 行为 |
+| --- | --- |
+| `mention_or_keywords` | 被 @ 或命中关键词时触发，推荐默认值。 |
+| `mentions` | 仅被 @ 时触发。 |
+| `keywords` | 仅命中关键词时触发。 |
+| `all` | 群聊所有文本消息都触发。谨慎使用。 |
+| `off` | 群聊不触发。 |
+
+群聊触发后，插件会尽量去掉明显的 `@xxx` 前缀，再把正文发给 Agent。
+
+## 会话策略
+
+插件使用如下 conversation key：
+
+```text
+integrationId:uuid:contactId:senderId
+```
+
+含义：
+
+- 私聊：通常 `senderId` 与 `contactId` 一致。
+- 群聊：按 `群 + 发言人` 拆分会话，避免多人共用同一个 Agent conversation。
+
+用户发送：
+
+```text
+/new
+```
+
+可以重置当前微信会话。也可以在 Workbench 或 middleware tool 中重置指定 conversation binding。
+
+## Workbench
+
+Personal WeChat Workbench 通常出现在集成详情页和 Agent workbench 中。
+
+主要页面：
+
+- 账号页：查看 wx2.0 账号、在线状态、最近回调、最近回复、错误；复制 webhook；生成 SetCallback curl；启停账号接入。
+- 会话页：查看私聊/群聊会话、绑定的 Agent conversationId，支持重置会话。
+- 消息页：查看入站/出站消息、状态、错误和 payload 摘要，支持重发最后一次 AI 回复。
+- 配置页：查看 wx2.0 baseUrl、apiVersion、token、群聊触发策略、session timeout 等配置摘要。
+- 日志页：查看 webhook、dispatch、Agent callback、wx2.0 sendtext 调用相关记录。
+
+## Agent middleware tools
+
+`WechatPersonalRuntimeMiddleware` 暴露以下 Agent middleware tools。它们主要用于运行时管理和诊断，不用于普通微信回复。
+
+| Tool | 用途 |
+| --- | --- |
+| `wechat_personal_get_runtime_status` | 查看回调地址、绑定 Agent、账号数、消息数、错误数等运行状态。 |
+| `wechat_personal_get_callback_config` | 获取 Xpert webhook URL 和 SetCallback curl 模板。 |
+| `wechat_personal_list_accounts` | 查询账号列表。 |
+| `wechat_personal_list_conversations` | 查询会话绑定列表。 |
+| `wechat_personal_search_message_logs` | 查询入站、出站、失败、跳过等消息日志。 |
+| `wechat_personal_reset_conversation` | 重置指定会话。 |
+| `wechat_personal_register_callback` | 为指定 wx2.0 账号调用 SetCallback。 |
+| `wechat_personal_set_account_enabled` | 启用或停用指定账号的入站处理。 |
+
+普通微信回复不需要调用这些 tools。Agent 产出的最终回答会由插件 callback processor 自动发送回微信。
+
+## 测试发送
+
+配置完成后，可以用 Xpert helper API 测试 Xpert -> wx2.0 发送链路：
+
+```sh
+curl -X POST "https://your-xpert-api.example.com/api/wechat-personal/<integrationId>/send-text" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "uuid": "<wx2-account-uuid>",
+    "contactId": "wxid_xxx",
+    "text": "这是一条来自 Xpert 的测试消息"
+  }'
+```
+
+如果发送失败，先检查：
+
+- `wx2.0 服务地址` 是否能从 Xpert 后端访问。
+- `apiVersion` 是否为 `/v1/`。
+- wx2.0 是否支持 `/v1/message/sendtext`。
+- 是否需要填写 `API Token`。
+- 是否开启了旧接口回退。
+
+## 常见排障
+
+### wx2.0 能收到微信消息，但 Xpert 没有反应
+
+检查：
+
+1. wx2.0 的全局 webhook 或 SetCallback 是否指向 Xpert webhook URL。
+2. `API_BASE_URL` 是否是 wx2.0 能访问的地址。
+3. 如果配置了 `callbackSecret`，wx2.0 回调 URL 是否带了正确的 `?secret=...`。
+4. Assistant 是否已启用或发布。
+5. `wechat_personal` trigger 是否选择了正确的 integrationId。
+6. Workbench 消息日志中是否显示 `skipped` 或 `failed`。
+
+### 私聊能触发，群聊不触发
+
+检查：
+
+1. `groupTriggerMode` 是否为 `mention_or_keywords`、`mentions`、`keywords` 或 `all`。
+2. 如果使用关键词触发，`groupKeywords` 是否配置了实际会出现的词。
+3. 群消息是否为空文本、图片、语音或其他暂不支持的媒体消息。
+
+### Agent 回复了，但微信没有收到
+
+检查：
+
+1. `wx2.0 服务地址` 是否正确。
+2. Xpert 后端是否能访问 wx2.0。
+3. wx2.0 `/v1/message/sendtext` 是否可用。
+4. 是否需要配置 `API Token`。
+5. Workbench 出站日志里的错误信息。
+6. `失败时回退旧发送接口` 是否开启。
+
+### 一直重复触发或自问自答
+
+开启：
+
+```text
+忽略自己发出的消息
+```
+
+并确认 wx2.0 payload 中 `isself` 字段能正确标识自发消息。
+
+### 回调返回 400 或 Invalid callback secret
+
+说明插件配置了 `回调密钥`，但 wx2.0 推送时没有提供正确密钥。
+
+解决方式二选一：
+
+```text
+<Xpert webhook URL>?secret=<callbackSecret>
+```
+
+或请求 header：
+
+```text
+x-wechat-callback-secret: <callbackSecret>
+```
+
+## 本地开发
+
+在 `community` workspace 下执行：
+
+```sh
+pnpm --filter @xpert-ai/plugin-community-wechat test
+pnpm --filter @xpert-ai/plugin-community-wechat typecheck
+pnpm --filter @xpert-ai/plugin-community-wechat build
+```
+
+插件主要入口：
+
+- provider key：`wechat_personal`
+- channel type：`wechat_personal`
+- trigger key：`wechat_personal`
+- view key：`wechat_personal_workbench`
+- assistant template keys：`wechat-personal-admin-assistant`, `wechat-personal-user-assistant`
+- middleware provider：`WechatPersonalRuntimeMiddleware`
+
+## 安全建议
+
+- 生产环境建议配置 `callbackSecret`。
+- 不要把 wx2.0 HTTP 服务直接暴露到公网，除非有额外鉴权和网络隔离。
+- 如果 wx2.0 启用 TokenAuth，请填写 `API Token`。
+- 不要在 Agent prompt 或用户可见消息里泄露 callback URL、token、integrationId 等内部配置。

package/dist/index.d.ts

@@ -0,0 +1,20 @@
+import { z } from 'zod';
+import type { XpertPlugin } from '@xpert-ai/plugin-sdk';
+declare const ConfigSchema: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+declare const plugin: XpertPlugin<z.infer<typeof ConfigSchema>>;
+export default plugin;
+export * from './lib/constants.js';
+export * from './lib/types.js';
+export * from './lib/entities/index.js';
+export * from './lib/handoff/index.js';
+export * from './lib/workflow/index.js';
+export * from './lib/conversation-user-key.js';
+export * from './lib/conversation.service.js';
+export * from './lib/wechat-personal-channel.strategy.js';
+export * from './lib/wechat-personal.client.js';
+export * from './lib/wechat-personal.controller.js';
+export * from './lib/wechat-personal-integration.strategy.js';
+export * from './lib/wechat-personal.middleware.js';
+export * from './lib/wechat-personal.plugin.js';
+export * from './lib/wechat-personal.templates.js';
+export * from './lib/views/wechat-personal-view.provider.js';

package/dist/index.js

@@ -0,0 +1,139 @@
+import { readFileSync } from 'fs';
+import { dirname, join } from 'path';
+import { fileURLToPath } from 'url';
+import { z } from 'zod';
+import { WECHAT_PERSONAL_FEATURE, WECHAT_PERSONAL_ICON, WECHAT_PERSONAL_MIDDLEWARE_NAME, WECHAT_PERSONAL_PLUGIN_NAME, WECHAT_PERSONAL_PROVIDER_KEY, WECHAT_PERSONAL_RUNTIME_FEATURE, WECHAT_PERSONAL_TEMPLATE_PROVIDER_KEY, WECHAT_PERSONAL_VIEW_KEY, WECHAT_PERSONAL_VIEW_PROVIDER_KEY } from './lib/constants.js';
+import { WECHAT_PERSONAL_PLUGIN_CONTEXT } from './lib/tokens.js';
+import { WechatPersonalPlugin } from './lib/wechat-personal.plugin.js';
+import { wechatPersonalTemplates } from './lib/wechat-personal.templates.js';
+const moduleDir = dirname(fileURLToPath(import.meta.url));
+const packageJson = JSON.parse(readFileSync(join(moduleDir, '../package.json'), 'utf8'));
+const ConfigSchema = z.object({});
+const plugin = {
+    meta: {
+        name: packageJson.name || WECHAT_PERSONAL_PLUGIN_NAME,
+        version: packageJson.version,
+        level: 'system',
+        targetApps: ['data-xpert'],
+        targetAppMeta: {
+            'data-xpert': {
+                types: ['integration', 'workbench-view', 'assistant-tool', 'assistant-template'],
+                capabilities: [
+                    WECHAT_PERSONAL_FEATURE,
+                    WECHAT_PERSONAL_RUNTIME_FEATURE,
+                    'wechat-personal-workbench',
+                    'wechat-personal-admin-assistant-template',
+                    'wechat-personal-user-assistant-template'
+                ],
+                marketplace: {
+                    contents: [
+                        {
+                            type: 'app',
+                            name: WECHAT_PERSONAL_PROVIDER_KEY,
+                            displayName: 'Personal WeChat',
+                            description: 'Bridge wx2.0 personal WeChat messages with Xpert agents.',
+                            icon: {
+                                type: 'svg',
+                                value: WECHAT_PERSONAL_ICON,
+                                color: '#16a34a'
+                            },
+                            operations: [
+                                {
+                                    name: 'receive-wechat-messages',
+                                    displayName: 'Receive personal WeChat messages',
+                                    description: 'Receive wx2.0 callbacks and dispatch normalized text messages to an Agent.',
+                                    access: 'read'
+                                },
+                                {
+                                    name: 'send-wechat-replies',
+                                    displayName: 'Send personal WeChat replies',
+                                    description: 'Send final Agent text replies through wx2.0 sendtext.',
+                                    access: 'write'
+                                },
+                                {
+                                    name: 'manage-wechat-runtime',
+                                    displayName: 'Manage WeChat runtime',
+                                    description: 'Review accounts, conversation bindings, message logs, callbacks, and configuration.',
+                                    access: 'write'
+                                }
+                            ]
+                        },
+                        {
+                            type: 'view',
+                            name: WECHAT_PERSONAL_VIEW_KEY,
+                            displayName: 'Personal WeChat Workbench',
+                            description: 'Workbench for wx2.0 accounts, conversations, message logs, and callback setup.'
+                        },
+                        {
+                            type: 'tool',
+                            name: WECHAT_PERSONAL_MIDDLEWARE_NAME,
+                            displayName: 'Personal WeChat Runtime Tools',
+                            description: 'Assistant middleware for Personal WeChat runtime discovery, callback setup, account management, conversations, and logs.'
+                        },
+                        {
+                            type: 'assistant-template',
+                            name: 'wechat-personal-admin-assistant',
+                            displayName: 'Personal WeChat Admin Assistant Template',
+                            description: 'Organization-level assistant template for managing Personal WeChat integrations, callbacks, accounts, conversations, and logs.'
+                        },
+                        {
+                            type: 'assistant-template',
+                            name: 'wechat-personal-user-assistant',
+                            displayName: 'Personal WeChat User Assistant Template',
+                            description: 'End-user assistant template with a Personal WeChat trigger and final-text reply behavior.'
+                        }
+                    ]
+                },
+                runtime: {
+                    integrationProviders: [WECHAT_PERSONAL_PROVIDER_KEY],
+                    channelProviders: [WECHAT_PERSONAL_PROVIDER_KEY],
+                    middlewareProviders: [WECHAT_PERSONAL_MIDDLEWARE_NAME],
+                    viewProviders: [WECHAT_PERSONAL_VIEW_PROVIDER_KEY],
+                    templateProviders: [WECHAT_PERSONAL_TEMPLATE_PROVIDER_KEY]
+                }
+            }
+        },
+        category: 'integration',
+        icon: {
+            type: 'svg',
+            value: WECHAT_PERSONAL_ICON,
+            color: '#16a34a'
+        },
+        displayName: 'Personal WeChat Plugin',
+        description: 'wx2.0 personal WeChat integration for webhook receiving, Agent dispatch, and sendtext replies.',
+        keywords: ['wechat', 'wx2.0', 'personal-wechat', 'integration', 'webhook', 'agent', 'remote-component'],
+        author: 'XpertAI Team'
+    },
+    config: {
+        schema: ConfigSchema
+    },
+    permissions: [
+        { type: 'integration', service: WECHAT_PERSONAL_PROVIDER_KEY, operations: ['read', 'write'] },
+        { type: 'handoff', operations: ['enqueue'] }
+    ],
+    templates: wechatPersonalTemplates,
+    register(ctx) {
+        return {
+            module: WechatPersonalPlugin,
+            global: true,
+            providers: [{ provide: WECHAT_PERSONAL_PLUGIN_CONTEXT, useValue: ctx }],
+            exports: []
+        };
+    }
+};
+export default plugin;
+export * from './lib/constants.js';
+export * from './lib/types.js';
+export * from './lib/entities/index.js';
+export * from './lib/handoff/index.js';
+export * from './lib/workflow/index.js';
+export * from './lib/conversation-user-key.js';
+export * from './lib/conversation.service.js';
+export * from './lib/wechat-personal-channel.strategy.js';
+export * from './lib/wechat-personal.client.js';
+export * from './lib/wechat-personal.controller.js';
+export * from './lib/wechat-personal-integration.strategy.js';
+export * from './lib/wechat-personal.middleware.js';
+export * from './lib/wechat-personal.plugin.js';
+export * from './lib/wechat-personal.templates.js';
+export * from './lib/views/wechat-personal-view.provider.js';

package/dist/lib/constants.d.ts

@@ -0,0 +1,23 @@
+export declare const WECHAT_PERSONAL_PLUGIN_NAME = "@xpert-ai/plugin-community-wechat";
+export declare const WECHAT_PERSONAL_PROVIDER_KEY = "wechat_personal";
+export declare const WECHAT_PERSONAL_CHANNEL_TYPE = "wechat_personal";
+export declare const WECHAT_PERSONAL_TRIGGER_KEY = "wechat_personal";
+export declare const WECHAT_PERSONAL_VIEW_PROVIDER_KEY = "wechat_personal_workbench_provider";
+export declare const WECHAT_PERSONAL_VIEW_KEY = "wechat_personal_workbench";
+export declare const WECHAT_PERSONAL_REMOTE_ENTRY_KEY = "wechat-personal-workbench";
+export declare const WECHAT_PERSONAL_TEMPLATE_PROVIDER_KEY = "wechatPersonalTemplates";
+export declare const WECHAT_PERSONAL_FEATURE = "wechat_personal_bridge";
+export declare const WECHAT_PERSONAL_RUNTIME_FEATURE = "wechat-personal-runtime";
+export declare const WECHAT_PERSONAL_WORKBENCH_FEATURE = "wechat-personal-workbench";
+export declare const WECHAT_PERSONAL_MIDDLEWARE_NAME = "WechatPersonalRuntimeMiddleware";
+export declare const WECHAT_PERSONAL_GET_RUNTIME_STATUS_TOOL_NAME = "wechat_personal_get_runtime_status";
+export declare const WECHAT_PERSONAL_GET_CALLBACK_CONFIG_TOOL_NAME = "wechat_personal_get_callback_config";
+export declare const WECHAT_PERSONAL_LIST_ACCOUNTS_TOOL_NAME = "wechat_personal_list_accounts";
+export declare const WECHAT_PERSONAL_LIST_CONVERSATIONS_TOOL_NAME = "wechat_personal_list_conversations";
+export declare const WECHAT_PERSONAL_SEARCH_MESSAGE_LOGS_TOOL_NAME = "wechat_personal_search_message_logs";
+export declare const WECHAT_PERSONAL_RESET_CONVERSATION_TOOL_NAME = "wechat_personal_reset_conversation";
+export declare const WECHAT_PERSONAL_REGISTER_CALLBACK_TOOL_NAME = "wechat_personal_register_callback";
+export declare const WECHAT_PERSONAL_SET_ACCOUNT_ENABLED_TOOL_NAME = "wechat_personal_set_account_enabled";
+export declare const AGENT_WORKBENCH_MAIN_SLOT = "agent.workbench.main";
+export declare const AGENT_WORKBENCH_FIXED_SLOT = "agent.workbench.fixed";
+export declare const WECHAT_PERSONAL_ICON = "<svg viewBox=\"0 0 24 24\" fill=\"none\" xmlns=\"http://www.w3.org/2000/svg\"><path d=\"M6.5 7.5C4.57 7.5 3 8.87 3 10.56c0 1 .55 1.89 1.41 2.45l-.37 1.43 1.6-.78c.28.05.57.08.86.08 1.93 0 3.5-1.37 3.5-3.06S8.43 7.5 6.5 7.5Z\" stroke=\"currentColor\" stroke-width=\"1.45\" stroke-linejoin=\"round\"/><path d=\"M13.4 5c4.2 0 7.6 2.82 7.6 6.3 0 1.94-1.06 3.68-2.72 4.83l.62 2.37-2.6-1.3c-.9.26-1.88.4-2.9.4-4.2 0-7.6-2.82-7.6-6.3S9.2 5 13.4 5Z\" stroke=\"currentColor\" stroke-width=\"1.45\" stroke-linejoin=\"round\"/><path d=\"M11 10.4h.01M15.8 10.4h.01\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\"/></svg>";

package/dist/lib/constants.js

@@ -0,0 +1,23 @@
+export const WECHAT_PERSONAL_PLUGIN_NAME = '@xpert-ai/plugin-community-wechat';
+export const WECHAT_PERSONAL_PROVIDER_KEY = 'wechat_personal';
+export const WECHAT_PERSONAL_CHANNEL_TYPE = 'wechat_personal';
+export const WECHAT_PERSONAL_TRIGGER_KEY = 'wechat_personal';
+export const WECHAT_PERSONAL_VIEW_PROVIDER_KEY = 'wechat_personal_workbench_provider';
+export const WECHAT_PERSONAL_VIEW_KEY = 'wechat_personal_workbench';
+export const WECHAT_PERSONAL_REMOTE_ENTRY_KEY = 'wechat-personal-workbench';
+export const WECHAT_PERSONAL_TEMPLATE_PROVIDER_KEY = 'wechatPersonalTemplates';
+export const WECHAT_PERSONAL_FEATURE = 'wechat_personal_bridge';
+export const WECHAT_PERSONAL_RUNTIME_FEATURE = 'wechat-personal-runtime';
+export const WECHAT_PERSONAL_WORKBENCH_FEATURE = 'wechat-personal-workbench';
+export const WECHAT_PERSONAL_MIDDLEWARE_NAME = 'WechatPersonalRuntimeMiddleware';
+export const WECHAT_PERSONAL_GET_RUNTIME_STATUS_TOOL_NAME = 'wechat_personal_get_runtime_status';
+export const WECHAT_PERSONAL_GET_CALLBACK_CONFIG_TOOL_NAME = 'wechat_personal_get_callback_config';
+export const WECHAT_PERSONAL_LIST_ACCOUNTS_TOOL_NAME = 'wechat_personal_list_accounts';
+export const WECHAT_PERSONAL_LIST_CONVERSATIONS_TOOL_NAME = 'wechat_personal_list_conversations';
+export const WECHAT_PERSONAL_SEARCH_MESSAGE_LOGS_TOOL_NAME = 'wechat_personal_search_message_logs';
+export const WECHAT_PERSONAL_RESET_CONVERSATION_TOOL_NAME = 'wechat_personal_reset_conversation';
+export const WECHAT_PERSONAL_REGISTER_CALLBACK_TOOL_NAME = 'wechat_personal_register_callback';
+export const WECHAT_PERSONAL_SET_ACCOUNT_ENABLED_TOOL_NAME = 'wechat_personal_set_account_enabled';
+export const AGENT_WORKBENCH_MAIN_SLOT = 'agent.workbench.main';
+export const AGENT_WORKBENCH_FIXED_SLOT = 'agent.workbench.fixed';
+export const WECHAT_PERSONAL_ICON = `<svg viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg"><path d="M6.5 7.5C4.57 7.5 3 8.87 3 10.56c0 1 .55 1.89 1.41 2.45l-.37 1.43 1.6-.78c.28.05.57.08.86.08 1.93 0 3.5-1.37 3.5-3.06S8.43 7.5 6.5 7.5Z" stroke="currentColor" stroke-width="1.45" stroke-linejoin="round"/><path d="M13.4 5c4.2 0 7.6 2.82 7.6 6.3 0 1.94-1.06 3.68-2.72 4.83l.62 2.37-2.6-1.3c-.9.26-1.88.4-2.9.4-4.2 0-7.6-2.82-7.6-6.3S9.2 5 13.4 5Z" stroke="currentColor" stroke-width="1.45" stroke-linejoin="round"/><path d="M11 10.4h.01M15.8 10.4h.01" stroke="currentColor" stroke-width="2" stroke-linecap="round"/></svg>`;

package/dist/lib/conversation-user-key.d.ts

@@ -0,0 +1,13 @@
+export declare function normalizeConversationKey(value: unknown): string | undefined;
+export declare function resolveWechatPersonalConversationUserKey(params: {
+    integrationId: string;
+    uuid: string;
+    contactId: string;
+    senderId?: string | null;
+}): string | undefined;
+export declare function parseWechatPersonalConversationUserKey(value: unknown): {
+    integrationId: string;
+    uuid: string;
+    contactId: string;
+    senderId: string;
+} | undefined;

package/dist/lib/conversation-user-key.js

@@ -0,0 +1,28 @@
+export function normalizeConversationKey(value) {
+    if (typeof value !== 'string') {
+        return undefined;
+    }
+    const text = value.trim();
+    return text || undefined;
+}
+export function resolveWechatPersonalConversationUserKey(params) {
+    const integrationId = normalizeConversationKey(params.integrationId);
+    const uuid = normalizeConversationKey(params.uuid);
+    const contactId = normalizeConversationKey(params.contactId);
+    const senderId = normalizeConversationKey(params.senderId) || contactId;
+    if (!integrationId || !uuid || !contactId || !senderId) {
+        return undefined;
+    }
+    return `${integrationId}:${uuid}:${contactId}:${senderId}`;
+}
+export function parseWechatPersonalConversationUserKey(value) {
+    const text = normalizeConversationKey(value);
+    if (!text) {
+        return undefined;
+    }
+    const [integrationId, uuid, contactId, senderId] = text.split(':');
+    if (!integrationId || !uuid || !contactId || !senderId) {
+        return undefined;
+    }
+    return { integrationId, uuid, contactId, senderId };
+}