@xmanrui/dsh-im 4.0.1 → 4.1.0

package/src/channels/wecom/wecom-bridge.mjs

@@ -66,14 +66,14 @@ function helpText() {
     t('/history [数量]  查看最近历史消息（默认 3 条，最多 5 条）'),
     t('/workspace 工作区绝对路径  切换工作区'),
     t('/workspacelist  列出工作区绝对路径'),
-    t('/sessionlist [工作区序号或绝对路径]  列出会话 ID 和标题'),
+    t('/sessionlist 或 /sessions [工作区序号或绝对路径]  列出会话 ID 和标题'),
     t('/session Session ID 或当前工作区序号  将当前聊天绑定到指定会话'),
     t('/models  按序号列出所有可用模型'),
     t('/reasoninglist 或 /reasonings  按序号列出当前模型可用推理等级'),
     t('/reasoning [序号、等级ID或 --default]  查看或切换当前推理等级'),
     t('/model [序号或完整模型ID] [推理等级ID]  查看或切换当前会话模型'),
     t('示例：先发 /models，再发 /model 2 [推理等级ID]'),
-    t('/presetlist  按序号列出可用 Agent Preset'),
+    t('/presetlist 或 /presets  按序号列出可用 Agent Preset'),
     t('/preset [序号或完整ID]  查看或设置当前机器人 Agent Preset'),
     t('纯数字 ID：/preset id:<ID>'),
     t('/preset --default  跟随 Host 默认'),

package/src/channels/wecom/wecom-controller.mjs

@@ -257,6 +257,20 @@ export class WecomController {
     });
   }
 
+  async sendProactiveText(botId, target, text, options = {}) {
+    const config = this.#configStore.get(botId);
+    if (!config) throw new Error('Unknown Enterprise WeChat bot');
+    return this.#withBotTransition(botId, async () => {
+      const runtime = this.#runtimes.get(botId);
+      if (!runtime?.status?.ready || typeof runtime.sendProactiveText !== 'function') {
+        const error = new Error(t('企业微信连接当前离线'));
+        error.code = 'bot-not-connected';
+        throw error;
+      }
+      return runtime.sendProactiveText(target, text, options);
+    });
+  }
+
   async deleteBot(botId) {
     const config = this.#configStore.get(botId);
     if (!config) throw new Error('Unknown Enterprise WeChat bot');

package/src/channels/wecom/wecom-runtime.mjs

@@ -220,6 +220,27 @@ export class WecomRuntime {
     });
   }
 
+  async sendProactiveText(target, text, { signal } = {}) {
+    const chatId = typeof target?.route?.chatId === 'string'
+      ? target.route.chatId.trim() : '';
+    if ((target?.kind !== 'user' && target?.kind !== 'group') || !chatId) {
+      const error = new TypeError('Invalid Enterprise WeChat proactive delivery target');
+      error.code = 'invalid-target';
+      throw error;
+    }
+    if (!this.#status.ready || !this.#client) {
+      const error = new Error('Enterprise WeChat runtime is not connected');
+      error.code = 'bot-not-connected';
+      throw error;
+    }
+    signal?.throwIfAborted();
+    await this.#client.sendMessage(chatId, {
+      msgtype: 'markdown',
+      markdown: { content: text },
+    });
+    return { sent: true };
+  }
+
   async #stopActive() {
     const client = this.#client;
     const bridge = this.#bridge;

package/src/channels/weixin/weixin-bridge.mjs

@@ -73,14 +73,14 @@ const HELP_TEXT = () => [
   t('/history [数量]  查看最近历史消息（默认 3 条，最多 5 条）'),
   t('/workspace 工作区绝对路径  切换工作区'),
   t('/workspacelist  列出工作区绝对路径'),
-  t('/sessionlist [工作区序号或绝对路径]  列出会话 ID 和标题'),
+  t('/sessionlist 或 /sessions [工作区序号或绝对路径]  列出会话 ID 和标题'),
   t('/session Session ID 或当前工作区序号  将当前聊天绑定到指定会话'),
   t('/models  按序号列出所有可用模型'),
   t('/reasoninglist 或 /reasonings  按序号列出当前模型可用推理等级'),
   t('/reasoning [序号、等级ID或 --default]  查看或切换当前推理等级'),
   t('/model [序号或完整模型ID] [推理等级ID]  查看或切换当前会话模型'),
   t('示例：先发 /models，再发 /model 2 [推理等级ID]'),
-  t('/presetlist  按序号列出可用 Agent Preset'),
+  t('/presetlist 或 /presets  按序号列出可用 Agent Preset'),
   t('/preset [序号或完整ID]  查看或设置当前机器人 Agent Preset'),
   t('纯数字 ID：/preset id:<ID>'),
   t('/preset --default  跟随 Host 默认'),

package/src/channels/weixin/weixin-controller.mjs

@@ -299,6 +299,20 @@ export class WeixinController {
     });
   }
 
+  async sendProactiveText(botId, target, text, options = {}) {
+    const config = this.#configStore.get(botId);
+    if (!config) throw new Error('Unknown Weixin account');
+    return this.#withBotTransition(botId, async () => {
+      const runtime = this.#runtimes.get(botId);
+      if (!runtime?.status?.ready || typeof runtime.sendProactiveText !== 'function') {
+        const error = new Error(t('微信连接当前离线'));
+        error.code = 'bot-not-connected';
+        throw error;
+      }
+      return runtime.sendProactiveText(target, text, options);
+    });
+  }
+
   async deleteBot(botId) {
     const config = this.#configStore.get(botId);
     if (!config) throw new Error('Unknown Weixin account');

package/src/channels/weixin/weixin-runtime.mjs

@@ -329,4 +329,28 @@ export class WeixinRuntime {
     });
     return { sent: true };
   }
+
+  async sendProactiveText(target, text, { signal } = {}) {
+    const toUserId = typeof target?.route?.toUserId === 'string'
+      ? target.route.toUserId.trim() : '';
+    if (target?.kind !== 'user' || !toUserId) {
+      const error = new TypeError('Invalid Weixin proactive delivery target');
+      error.code = 'invalid-target';
+      throw error;
+    }
+    if (!this.#status.ready || !this.#abortController) {
+      const error = new Error('Weixin runtime is not connected');
+      error.code = 'bot-not-connected';
+      throw error;
+    }
+    signal?.throwIfAborted();
+    await this.#api.sendText({
+      baseUrl: this.#config.baseUrl,
+      token: this.#token,
+      toUserId,
+      text,
+      signal: signal ?? this.#abortController.signal,
+    });
+    return { sent: true };
+  }
 }

package/src/channels/whatsapp/whatsapp-controller.mjs

@@ -224,6 +224,20 @@ export class WhatsappController {
     });
   }
 
+  async sendProactiveText(botId, target, text, options = {}) {
+    const config = this.#configStore.get(botId);
+    if (!config) throw new Error('Unknown WhatsApp bot');
+    return this.#withBotTransition(botId, async () => {
+      const runtime = this.#runtimes.get(botId);
+      if (!runtime?.status?.ready || typeof runtime.sendProactiveText !== 'function') {
+        const error = new Error(t('WhatsApp机器人尚未连接'));
+        error.code = 'bot-not-connected';
+        throw error;
+      }
+      return runtime.sendProactiveText(target, text, options);
+    });
+  }
+
   async setAccessPolicy(botId, value) {
     if (this.#closed) throw new Error('WhatsApp controller is closed');
     const accessPolicy = normalizeWhatsappAccessPolicy(value);

package/src/channels/whatsapp/whatsapp-runtime.mjs

@@ -719,6 +719,25 @@ export class WhatsappRuntime {
     return { sent: true };
   }
 
+  async sendProactiveText(target, text, { signal } = {}) {
+    const jid = typeof target?.route?.jid === 'string' ? target.route.jid.trim() : '';
+    const validUser = target?.kind === 'user'
+      && /^[^@\s]+@(s\.whatsapp\.net|lid)$/.test(jid);
+    const validGroup = target?.kind === 'group' && /^[^@\s]+@g\.us$/.test(jid);
+    if (!validUser && !validGroup) {
+      const error = new TypeError('Invalid WhatsApp proactive delivery target');
+      error.code = 'invalid-target';
+      throw error;
+    }
+    if (!this.#status.ready || !this.#client) {
+      const error = new Error(t('WhatsApp机器人尚未连接'));
+      error.code = 'bot-not-connected';
+      throw error;
+    }
+    signal?.throwIfAborted();
+    return this.#client.sendText({ jid }, text);
+  }
+
   async stop() {
     const session = this.#session;
     const client = this.#client;