@xmanrui/dsh-im 0.6.0 → 0.7.1

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

@@ -3,9 +3,16 @@ import {
   splitWeixinText,
   weixinMessageId,
 } from './weixin-api.mjs';
+import {
+  harnessAnswerForQuestion,
+  harnessQuestionText,
+  validHarnessQuestion,
+} from '../shared/harness-question.mjs';
 import { runWorkspaceCommand } from '../shared/workspace-command.mjs';
 import { askInWorkspaceSession } from '../shared/workspace-session.mjs';
 
+const INTERACTION_RESOLVED_TEXT = '这个问题已在其他客户端处理，无需再次回答。';
+
 const HELP_TEXT = [
   '微信已连接 DeepSeek Harness。',
   '',
@@ -13,6 +20,8 @@ const HELP_TEXT = [
   '/new  开启一个全新会话',
   '/workspace 工作区绝对路径  切换工作区',
   '/workspacelist  列出工作区绝对路径',
+  '/sessionlist [工作区序号或绝对路径]  列出会话 ID 和标题',
+  '/session Session ID  将当前聊天绑定到指定会话',
   '/status  检查连接状态',
   '/help  显示本帮助',
 ].join('\n');
@@ -21,6 +30,16 @@ function conversationKey(userId) {
   return `p2p:${userId}`;
 }
 
+function nonEmptyString(value) {
+  return typeof value === 'string' && value.trim() ? value.trim() : null;
+}
+
+function canClaimInteractionReply(message, pending) {
+  return pending.questions[pending.index]
+    && nonEmptyString(message?.from_user_id) === pending.actor
+    && nonEmptyString(extractWeixinText(message));
+}
+
 export function createWeixinBridgeStatus() {
   return {
     messagesReceived: 0,
@@ -44,7 +63,11 @@ export class WeixinHarnessBridge {
   #logger;
   #replyTimeoutMs;
   #maxMessageChars;
+  #signal;
   #queues = new Map();
+  #pendingInteractions = new Map();
+  #interactionKeys = new Map();
+  #acceptedMessageIds = new Set();
 
   constructor({
     api,
@@ -57,6 +80,7 @@ export class WeixinHarnessBridge {
     logger = console,
     replyTimeoutMs = 600_000,
     maxMessageChars = 4_000,
+    signal,
   }) {
     if (!api || typeof api.sendText !== 'function') throw new TypeError('Weixin API is required');
     if (!baseUrl || !token || !ownerUserId) throw new TypeError('Weixin account credentials are required');
@@ -71,6 +95,7 @@ export class WeixinHarnessBridge {
     this.#logger = logger;
     this.#replyTimeoutMs = replyTimeoutMs;
     this.#maxMessageChars = maxMessageChars;
+    this.#signal = signal;
   }
 
   get status() {
@@ -78,31 +103,73 @@ export class WeixinHarnessBridge {
   }
 
   accept(message) {
-    const sender = typeof message?.from_user_id === 'string' ? message.from_user_id : '';
-    const previous = this.#queues.get(sender) ?? Promise.resolve();
+    if (this.#signal?.aborted) return Promise.resolve();
+    if (message?.message_type === 2) return Promise.resolve();
+    const messageId = weixinMessageId(message);
+    const sender = nonEmptyString(message?.from_user_id);
+    if (!messageId || !sender || this.#state.hasSeen(messageId)
+      || this.#acceptedMessageIds.has(messageId)) return Promise.resolve();
+    this.#acceptedMessageIds.add(messageId);
+    const key = conversationKey(sender);
+    const pending = this.#pendingInteractions.get(key);
+    if (pending?.submitting || pending?.claimedReplyMessageId) {
+      return this.#enqueueMessage(message, messageId, key);
+    }
+    if (pending) {
+      if (canClaimInteractionReply(message, pending)) {
+        pending.claimedReplyMessageId = messageId;
+      }
+      const previous = pending.queue ?? Promise.resolve();
+      const current = previous
+        .catch(() => undefined)
+        .then(() => this.#processInteractionReply(message, messageId, key, pending))
+        .catch((error) => this.#handleInteractionFailure(message, messageId, error))
+        .finally(() => {
+          this.#acceptedMessageIds.delete(messageId);
+          if (pending.claimedReplyMessageId === messageId) pending.claimedReplyMessageId = null;
+          if (pending.queue === current) pending.queue = null;
+        });
+      pending.queue = current;
+      return current;
+    }
+    return this.#enqueueMessage(message, messageId, key);
+  }
+
+  #enqueueMessage(message, messageId, key, {
+    releaseMessageId = true,
+    alreadyRecorded = false,
+  } = {}) {
+    const previous = this.#queues.get(key) ?? Promise.resolve();
     const current = previous
       .catch(() => undefined)
-      .then(() => this.#process(message))
+      .then(() => this.#process(message, key, { alreadyRecorded }))
       .finally(() => {
-        if (this.#queues.get(sender) === current) this.#queues.delete(sender);
+        if (releaseMessageId) this.#acceptedMessageIds.delete(messageId);
+        if (this.#queues.get(key) === current) this.#queues.delete(key);
       });
-    this.#queues.set(sender, current);
+    this.#queues.set(key, current);
     return current;
   }
 
   async waitForIdle() {
-    await Promise.allSettled([...this.#queues.values()]);
+    await Promise.allSettled([
+      ...this.#queues.values(),
+      ...[...this.#pendingInteractions.values()].flatMap((pending) => (
+        pending.queue ? [pending.queue] : []
+      )),
+    ]);
   }
 
-  async #process(message) {
-    if (message?.message_type === 2) return;
+  async #process(message, key, { alreadyRecorded = false } = {}) {
+    this.#signal?.throwIfAborted();
     const messageId = weixinMessageId(message);
-    const sender = typeof message?.from_user_id === 'string' ? message.from_user_id : '';
+    const sender = nonEmptyString(message?.from_user_id);
     if (!messageId || !sender) return;
-    if (this.#state.hasSeen(messageId)) return;
-
-    this.#status.messagesReceived += 1;
-    this.#status.lastMessageAt = new Date().toISOString();
+    if (!alreadyRecorded) {
+      if (this.#state.hasSeen(messageId)) return;
+      this.#status.messagesReceived += 1;
+      this.#status.lastMessageAt = new Date().toISOString();
+    }
     if (sender !== this.#ownerUserId) {
       this.#status.messagesRejected += 1;
       this.#status.lastRejectedAt = new Date().toISOString();
@@ -126,18 +193,18 @@ export class WeixinHarnessBridge {
         return;
       }
       if (command === '/status') {
-        await this.#harness.ensureRunning();
+        await this.#harness.ensureRunning({ signal: this.#signal });
         await this.#send(sender, '微信与 DeepSeek Harness 连接正常。', contextToken, runId);
         await this.#state.markSeen(messageId);
         return;
       }
       if (command === '/new') {
-        await this.#state.clearSession(conversationKey(sender));
+        await this.#state.clearSession(key);
         await this.#send(sender, '已开启新会话。请发送你的问题。', contextToken, runId);
         await this.#state.markSeen(messageId);
         return;
       }
-      const workspaceCommand = await runWorkspaceCommand(text, this.#harness);
+      const workspaceCommand = await runWorkspaceCommand(text, this.#harness, key);
       if (workspaceCommand) {
         for (const reply of workspaceCommand.messages ?? [workspaceCommand.message]) {
           await this.#send(sender, reply, contextToken, runId);
@@ -146,20 +213,37 @@ export class WeixinHarnessBridge {
         return;
       }
 
-      const key = conversationKey(sender);
-      const { answer } = await askInWorkspaceSession({
-        harness: this.#harness,
-        state: this.#state,
-        key,
-        text,
-        askOptions: { timeoutMs: this.#replyTimeoutMs },
-      });
+      let answer;
+      try {
+        ({ answer } = await askInWorkspaceSession({
+          harness: this.#harness,
+          state: this.#state,
+          key,
+          text,
+          createOptions: { signal: this.#signal },
+          existsOptions: { signal: this.#signal },
+          askOptions: {
+            timeoutMs: this.#replyTimeoutMs,
+            signal: this.#signal,
+            onInteraction: (interaction) => this.#handleInteraction(interaction, {
+              key,
+              actor: sender,
+              contextToken,
+              runId,
+            }),
+            onInteractionResolved: (resolution) => this.#handleInteractionResolved(resolution),
+          },
+        }));
+      } finally {
+        await this.#cancelPendingInteraction(key);
+      }
       await this.#send(sender, answer, contextToken, runId);
       await this.#state.markSeen(messageId);
       this.#status.messagesReplied += 1;
       this.#status.lastReplyAt = new Date().toISOString();
       this.#status.lastError = null;
     } catch (error) {
+      if (this.#signal?.aborted) return;
       this.#status.lastError = error?.message ?? String(error);
       this.#logger.error?.('[dsh-weixin] failed to process an inbound message:', error);
       try {
@@ -171,6 +255,304 @@ export class WeixinHarnessBridge {
     }
   }
 
+  async #processInteractionReply(message, messageId, key, expected) {
+    this.#signal?.throwIfAborted();
+    const current = this.#pendingInteractions.get(key);
+    const claimed = expected.claimedReplyMessageId === messageId;
+    if (!current || current !== expected || current.submitting) {
+      if (claimed && (!current || current !== expected)) {
+        return this.#discardResolvedInteractionReply(message, messageId);
+      }
+      return this.#enqueueMessage(message, messageId, key, { releaseMessageId: false });
+    }
+    if (this.#state.hasSeen(messageId)) return;
+    await this.#state.markSeen(messageId);
+    this.#status.messagesReceived += 1;
+    this.#status.lastMessageAt = new Date().toISOString();
+
+    const text = nonEmptyString(extractWeixinText(message));
+    const contextToken = nonEmptyString(message?.context_token) ?? undefined;
+    const runId = nonEmptyString(message?.run_id) ?? undefined;
+    if (!text) {
+      await this.#send(
+        expected.actor,
+        '请用文字回答当前问题。',
+        contextToken,
+        runId,
+      );
+      return;
+    }
+
+    const pending = this.#pendingInteractions.get(key);
+    if (!pending || pending !== expected || pending.submitting) {
+      if (claimed && (!pending || pending !== expected)) {
+        await this.#send(
+          expected.actor,
+          INTERACTION_RESOLVED_TEXT,
+          contextToken,
+          runId,
+        );
+        return;
+      }
+      return this.#enqueueMessage(message, messageId, key, {
+        releaseMessageId: false,
+        alreadyRecorded: true,
+      });
+    }
+    pending.contextToken = contextToken;
+    pending.runId = runId;
+    if (pending.needsPresentation) {
+      try {
+        await this.#presentInteraction(pending);
+      } catch {
+        this.#status.lastError = '微信交互问题发送失败。';
+        this.#logger.error?.('[dsh-weixin] failed to retry an interaction question');
+        pending.interaction.reconnect?.();
+        return;
+      }
+      const presentedPending = this.#pendingInteractions.get(key);
+      if (!presentedPending || presentedPending !== expected || presentedPending.submitting) {
+        if (claimed && (!presentedPending || presentedPending !== expected)) {
+          await this.#send(
+            expected.actor,
+            INTERACTION_RESOLVED_TEXT,
+            contextToken,
+            runId,
+          ).catch(() => undefined);
+          return;
+        }
+        return this.#enqueueMessage(message, messageId, key, {
+          releaseMessageId: false,
+          alreadyRecorded: true,
+        });
+      }
+    }
+
+    const question = pending.questions[pending.index];
+    if (!question) return;
+    pending.answers.push(harnessAnswerForQuestion(question, text));
+    pending.index += 1;
+    if (pending.index < pending.questions.length) {
+      if (pending.claimedReplyMessageId === messageId) {
+        pending.claimedReplyMessageId = null;
+      }
+      pending.needsPresentation = true;
+      try {
+        await this.#presentInteraction(pending);
+      } catch {
+        this.#status.lastError = '微信交互问题发送失败。';
+        this.#logger.error?.('[dsh-weixin] failed to send the next interaction question');
+        pending.interaction.reconnect?.();
+      }
+      return;
+    }
+
+    pending.submitting = true;
+    try {
+      await pending.interaction.respond({
+        ok: true,
+        value: {
+          sessionId: pending.sessionId,
+          answer: { answers: pending.answers },
+        },
+      });
+      this.#clearPendingInteraction(key, pending.interactionId);
+      this.#status.lastError = null;
+    } catch (error) {
+      if (this.#signal?.aborted) return;
+      if (error?.code === 'interaction-not-pending') {
+        this.#clearPendingInteraction(key, pending.interactionId);
+        await this.#send(
+          pending.actor,
+          INTERACTION_RESOLVED_TEXT,
+          pending.contextToken,
+          pending.runId,
+        ).catch(() => undefined);
+        return;
+      }
+      if (this.#pendingInteractions.get(key) !== pending) return;
+      pending.submitting = false;
+      pending.answers.pop();
+      pending.index -= 1;
+      this.#status.lastError = '回答提交失败。';
+      this.#logger.error?.('[dsh-weixin] failed to answer a Harness interaction');
+      await this.#send(
+        pending.actor,
+        '回答提交失败，请重新发送当前问题的答案。',
+        pending.contextToken,
+        pending.runId,
+      ).catch(() => undefined);
+    }
+  }
+
+  async #handleInteraction(interaction, {
+    key,
+    actor,
+    contextToken,
+    runId,
+  }) {
+    // Approval remains fail-closed until #5 adds an authenticated policy.
+    if (interaction?.kind !== 'question') return;
+    const questions = interaction?.payload?.questions;
+    const interactionId = typeof interaction?.interactionId === 'string'
+      ? interaction.interactionId
+      : interaction?.rpcId;
+    if (typeof interaction?.rpcId !== 'string'
+      || typeof interactionId !== 'string'
+      || typeof interaction.sessionId !== 'string'
+      || !Array.isArray(questions)
+      || questions.length === 0
+      || questions.some((question) => !validHarnessQuestion(question))) {
+      this.#logger.warn?.('[dsh-weixin] ignored an invalid Harness question interaction');
+      return;
+    }
+
+    if (interaction.recovered === true) {
+      await interaction.respond({
+        ok: false,
+        error: {
+          code: 'cancelled',
+          message: 'Weixin safely cancelled an interaction left by an earlier client.',
+          details: {},
+        },
+      });
+      await this.#send(
+        actor,
+        '检测到这个 Session 中遗留的待回答问题，已安全取消并继续处理你刚才的消息。',
+        contextToken,
+        runId,
+      ).catch(() => undefined);
+      return;
+    }
+
+    const existing = this.#pendingInteractions.get(key);
+    if (existing?.interactionId === interactionId) {
+      existing.interaction = interaction;
+      if (existing.needsPresentation) await this.#presentInteraction(existing);
+      return;
+    }
+    if (this.#interactionKeys.has(interactionId)) return;
+    if (existing) {
+      await interaction.respond({
+        ok: false,
+        error: {
+          code: 'cancelled',
+          message: 'Weixin is already handling another user interaction.',
+          details: {},
+        },
+      });
+      return;
+    }
+
+    const pending = {
+      kind: 'question',
+      interactionId,
+      sessionId: interaction.sessionId,
+      interaction,
+      actor,
+      questions,
+      answers: [],
+      index: 0,
+      contextToken,
+      runId,
+      queue: null,
+      claimedReplyMessageId: null,
+      presentationPromise: null,
+      submitting: false,
+      needsPresentation: true,
+    };
+    this.#pendingInteractions.set(key, pending);
+    this.#interactionKeys.set(interactionId, key);
+    await this.#presentInteraction(pending);
+  }
+
+  #handleInteractionResolved(resolution) {
+    const interactionId = resolution?.interactionId;
+    if (resolution?.kind !== 'question' || typeof interactionId !== 'string') return;
+    const key = this.#interactionKeys.get(interactionId);
+    if (!key) return;
+    this.#clearPendingInteraction(key, interactionId);
+  }
+
+  #presentInteraction(pending) {
+    if (!pending.needsPresentation) return Promise.resolve();
+    if (pending.presentationPromise) return pending.presentationPromise;
+    const question = pending.questions[pending.index];
+    if (!question) return Promise.resolve();
+    const presentation = this.#send(
+      pending.actor,
+      harnessQuestionText(question, pending.index, pending.questions.length),
+      pending.contextToken,
+      pending.runId,
+    ).then(() => {
+      pending.needsPresentation = false;
+    }).finally(() => {
+      if (pending.presentationPromise === presentation) pending.presentationPromise = null;
+    });
+    pending.presentationPromise = presentation;
+    return presentation;
+  }
+
+  async #discardResolvedInteractionReply(message, messageId) {
+    if (this.#state.hasSeen(messageId)) return;
+    await this.#state.markSeen(messageId);
+    this.#status.messagesReceived += 1;
+    this.#status.lastMessageAt = new Date().toISOString();
+    await this.#send(
+      nonEmptyString(message?.from_user_id),
+      INTERACTION_RESOLVED_TEXT,
+      nonEmptyString(message?.context_token) ?? undefined,
+      nonEmptyString(message?.run_id) ?? undefined,
+    ).catch(() => undefined);
+  }
+
+  #takePendingInteraction(key, interactionId) {
+    const pending = this.#pendingInteractions.get(key);
+    if (!pending
+      || (interactionId !== undefined && pending.interactionId !== interactionId)) return null;
+    this.#pendingInteractions.delete(key);
+    this.#interactionKeys.delete(pending.interactionId);
+    return pending;
+  }
+
+  #clearPendingInteraction(key, interactionId) {
+    return this.#takePendingInteraction(key, interactionId) !== null;
+  }
+
+  async #cancelPendingInteraction(key) {
+    const pending = this.#takePendingInteraction(key);
+    if (!pending || pending.kind !== 'question') return;
+    try {
+      await pending.interaction.respond({
+        ok: false,
+        error: {
+          code: 'cancelled',
+          message: 'The Weixin interaction ended before the user answered.',
+          details: {},
+        },
+      }, { signal: AbortSignal.timeout(5_000) });
+    } catch (error) {
+      if (error?.code !== 'interaction-not-pending') {
+        this.#logger.warn?.('[dsh-weixin] failed to cancel a pending Harness interaction');
+      }
+    }
+  }
+
+  async #handleInteractionFailure(message, messageId, error) {
+    if (this.#signal?.aborted) return;
+    this.#status.lastError = error?.message ?? String(error);
+    this.#logger.error?.('[dsh-weixin] failed to process an interaction reply:', error);
+    if (!this.#state.hasSeen(messageId)) {
+      await this.#state.markSeen(messageId).catch(() => undefined);
+    }
+    await this.#send(
+      nonEmptyString(message?.from_user_id),
+      '消息处理失败，请稍后重试。',
+      nonEmptyString(message?.context_token) ?? undefined,
+      nonEmptyString(message?.run_id) ?? undefined,
+    ).catch(() => undefined);
+  }
+
   async #send(toUserId, text, contextToken, runId) {
     for (const chunk of splitWeixinText(text, this.#maxMessageChars)) {
       await this.#api.sendText({

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

@@ -1,6 +1,26 @@
 import { WeixinApiError } from './weixin-api.mjs';
 import { createWeixinBridgeStatus, WeixinHarnessBridge } from './weixin-bridge.mjs';
 
+const DEFAULT_START_RETRY_DELAYS_MS = Object.freeze([250, 1_000, 3_000]);
+
+function startRetryDelays(value) {
+  if (value === undefined) return [...DEFAULT_START_RETRY_DELAYS_MS];
+  if (!Array.isArray(value)) throw new TypeError('startRetryDelaysMs must be an array');
+  return value.map((wait) => {
+    if (!Number.isFinite(wait) || wait < 0) {
+      throw new TypeError('startRetryDelaysMs must contain non-negative delays');
+    }
+    return wait;
+  });
+}
+
+function retryableStartError(error) {
+  if (!(error instanceof WeixinApiError)) return false;
+  if (error.code === 'network-error' || error.code === 'timeout') return true;
+  return error.code === 'http-error'
+    && (error.status === 408 || error.status === 425 || error.status === 429 || error.status >= 500);
+}
+
 function delay(ms, signal) {
   return new Promise((resolve, reject) => {
     if (signal?.aborted) {
@@ -42,6 +62,7 @@ export class WeixinRuntime {
   #logger;
   #replyTimeoutMs;
   #maxMessageChars;
+  #startRetryDelaysMs;
   #status = createWeixinRuntimeStatus();
   #bridge = null;
   #abortController = null;
@@ -57,6 +78,7 @@ export class WeixinRuntime {
     logger = console,
     replyTimeoutMs = 600_000,
     maxMessageChars = 4_000,
+    startRetryDelaysMs,
   }) {
     if (!api || !config || !token || !harness || !state) {
       throw new TypeError('WeixinRuntime requires API, account, token, Harness, and state');
@@ -69,6 +91,7 @@ export class WeixinRuntime {
     this.#logger = logger;
     this.#replyTimeoutMs = replyTimeoutMs;
     this.#maxMessageChars = maxMessageChars;
+    this.#startRetryDelaysMs = startRetryDelays(startRetryDelaysMs);
   }
 
   get status() {
@@ -92,10 +115,9 @@ export class WeixinRuntime {
     try {
       await this.#harness.ensureRunning();
       this.#status.harnessReachable = true;
-      await this.#api.notifyStart({
-        baseUrl: this.#config.baseUrl,
-        token: this.#token,
-      });
+      await this.#notifyStart();
+      this.#abortController = new AbortController();
+      const signal = this.#abortController.signal;
       this.#bridge = new WeixinHarnessBridge({
         api: this.#api,
         baseUrl: this.#config.baseUrl,
@@ -107,12 +129,11 @@ export class WeixinRuntime {
         logger: this.#logger,
         replyTimeoutMs: this.#replyTimeoutMs,
         maxMessageChars: this.#maxMessageChars,
+        signal,
       });
-      this.#abortController = new AbortController();
       this.#status.ready = true;
       this.#status.weixinConnectionState = 'connected';
       this.#status.lastCheckedAt = Date.now();
-      const signal = this.#abortController.signal;
       this.#monitor = this.#runMonitor(signal).catch((error) => {
         if (signal.aborted) return;
         this.#status.ready = false;
@@ -122,6 +143,9 @@ export class WeixinRuntime {
       });
       return this.status;
     } catch (error) {
+      this.#abortController?.abort();
+      this.#abortController = null;
+      this.#bridge = null;
       this.#status.ready = false;
       this.#status.weixinConnectionState = 'failed';
       this.#status.lastError = error?.message ?? String(error);
@@ -129,6 +153,25 @@ export class WeixinRuntime {
     }
   }
 
+  async #notifyStart() {
+    for (let attempt = 0; ; attempt += 1) {
+      try {
+        return await this.#api.notifyStart({
+          baseUrl: this.#config.baseUrl,
+          token: this.#token,
+        });
+      } catch (error) {
+        const wait = this.#startRetryDelaysMs[attempt];
+        if (wait === undefined || !retryableStartError(error)) throw error;
+        this.#logger.warn?.(
+          `[dsh-weixin] account ${this.#config.botId} start request failed; retrying in ${wait}ms:`,
+          error,
+        );
+        await delay(wait);
+      }
+    }
+  }
+
   async #runMonitor(signal) {
     let consecutiveFailures = 0;
     while (!signal.aborted) {
@@ -156,7 +199,13 @@ export class WeixinRuntime {
         this.#status.lastError = null;
 
         for (const message of response?.msgs ?? []) {
-          await this.#bridge.accept(message);
+          void this.#bridge.accept(message).catch((error) => {
+            if (signal.aborted) return;
+            this.#logger.error?.(
+              `[dsh-weixin] account ${this.#config.botId} message handling failed:`,
+              error,
+            );
+          });
         }
         if (typeof response?.get_updates_buf === 'string' && response.get_updates_buf) {
           await this.#state.setGetUpdatesBuf(response.get_updates_buf);

package/src/channels/whatsapp/harness-client.mjs

@@ -1,3 +1,11 @@
-import { HarnessClient } from '../weixin/harness-client.mjs';
+import { HarnessClient } from '../shared/harness-client.mjs';
 
-export class WhatsappHarnessClient extends HarnessClient {}
+export class WhatsappHarnessClient extends HarnessClient {
+  constructor(options) {
+    super({
+      ...options,
+      rpcIdPrefix: 'whatsapp',
+      logPrefix: 'dsh-whatsapp',
+    });
+  }
+}

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

@@ -256,6 +256,7 @@ export class WhatsappRuntime {
         status: this.#status,
         logger: this.#logger,
         replyTimeoutMs: this.#replyTimeoutMs,
+        signal: controller.signal,
       });
       const now = Date.now();
       this.#status.ready = true;