@xmanrui/dsh-im 4.22.0 → 4.24.0

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

@@ -15,6 +15,8 @@ import {
   imageFileSourcesFromContent,
   isModelImageRejection,
 } from './image-prompt.mjs';
+import { imageInputLimits } from './image-input-policy.mjs';
+import { inboundImagesAsFiles, imageContentFromStaged, isImageAdmissionRejection, IMAGE_HOST_LIMIT_FALLBACK_PROMPT } from './image-input.mjs';
 import { imSourceGuidance } from './im-source-guidance.mjs';
 import { outboundArtifactRegistry } from './semantic/artifact.mjs';
 import { t } from './i18n.mjs';
@@ -354,10 +356,23 @@ export function textFromHarnessContent(content) {
     .trim();
 }
 
+/** Join only reasoning blocks from one Harness message payload. */
+export function reasoningFromHarnessContent(content) {
+  return (Array.isArray(content) ? content : [])
+    .filter((part) => part?.type === 'reasoning' && typeof part.text === 'string')
+    .map((part) => part.text)
+    .join('\n')
+    .trim();
+}
+
 function assistantMessageText(event) {
   return textFromHarnessContent(event?.data?.message?.content);
 }
 
+function assistantReasoningText(event) {
+  return reasoningFromHarnessContent(event?.data?.message?.content);
+}
+
 /** Aggregate assistant text in stable step/index order for one Harness Turn. */
 export class AssistantTextAccumulator {
   #steps = new Map();
@@ -413,6 +428,29 @@ function toolResultErrorText(error) {
   return null;
 }
 
+/** Join the visible text carried by a Harness tool result. */
+function toolResultText(data) {
+  const blocks = Array.isArray(data?.message?.content) ? data.message.content : [];
+  const nested = blocks.flatMap((block) => (
+    Array.isArray(block?.content) ? block.content : [block]
+  ));
+  const text = nested
+    .filter((block) => block?.type === 'text' && typeof block.text === 'string')
+    .map((block) => block.text)
+    .join('');
+  return text || nonEmptyText(data?.text) || toolResultErrorText(data?.error) || '';
+}
+
+function toolResultCallId(data) {
+  const blocks = Array.isArray(data?.message?.content) ? data.message.content : [];
+  return blocks
+    .map((block) => nonEmptyText(block?.toolCallId))
+    .find(Boolean)
+    ?? nonEmptyText(data?.message?.source?.callId)
+    ?? nonEmptyText(data?.callId)
+    ?? nonEmptyText(data?.subCallId);
+}
+
 function consumeInteractionOwnership(ownership, entries) {
   const ordered = [...entries]
     .map((entry) => entry?.event ?? entry)
@@ -503,10 +541,18 @@ export class HarnessReplyTracker {
   #reason = null;
   #toolNames = new Map();
   #lastToolName = null;
+  #transientSeqs = new Set();
+  #pendingReasoning = new Map();
+  #pendingReasoningChars = 0;
+  #reasoning = false;
 
-  constructor({ promptRpcId, afterSeq = -1 }) {
+  constructor({ promptRpcId, afterSeq = -1, reasoning = false }) {
     this.#promptRpcId = promptRpcId;
     this.#lastSeq = afterSeq;
+    // Reasoning updates are opt-in per consumer: only channels that surface
+    // thinking traces (Telegram thinking mode) subscribe; every other channel
+    // keeps its pre-thinking-traces update stream untouched.
+    this.#reasoning = reasoning === true;
   }
 
   get finished() {
@@ -540,7 +586,35 @@ export class HarnessReplyTracker {
     pushUpdate({ type: 'text', text });
   }
 
-  consumeAll(entries) {
+  #bufferReasoning(event) {
+    const text = event.data?.chunk?.text;
+    if (typeof text !== 'string' || !text || text.length > 65536
+      || this.#pendingReasoning.has(event.seq)) return;
+    this.#pendingReasoning.set(event.seq, event);
+    this.#pendingReasoningChars += text.length;
+    while (this.#pendingReasoning.size > 256 || this.#pendingReasoningChars > 65536) {
+      const [seq, oldest] = this.#pendingReasoning.entries().next().value;
+      this.#pendingReasoning.delete(seq);
+      this.#pendingReasoningChars -= oldest.data.chunk.text.length;
+    }
+  }
+
+  #takePendingReasoning() {
+    const events = [...this.#pendingReasoning.values()];
+    this.#pendingReasoning.clear();
+    this.#pendingReasoningChars = 0;
+    return events;
+  }
+
+  #emitReasoning(event, pushUpdate) {
+    const text = event.data?.chunk?.text;
+    if (event.data?.turn !== this.#targetTurn || this.#transientSeqs.has(event.seq)
+      || typeof text !== 'string' || !text) return;
+    this.#transientSeqs.add(event.seq);
+    pushUpdate({ type: 'reasoning', turn: this.#targetTurn, text });
+  }
+
+  consumeAll(entries, { live = false, fromMux = false } = {}) {
     const updates = [];
     // 同一批轮询内的 text 帧只保留最新累积，其余事件逐帧透出，
     // 让消费方能按顺序看到每个工具调用与结果。
@@ -554,20 +628,53 @@ export class HarnessReplyTracker {
       }
       updates.push(update);
     };
-    const ordered = [...entries]
+    const ordered = [...(fromMux ? [] : this.#takePendingReasoning()), ...entries]
       .map((entry) => entry?.event ?? entry)
       .filter(Boolean)
       .sort((left, right) => (left.seq ?? -1) - (right.seq ?? -1));
 
     for (const event of ordered) {
+      if (this.#finished) break;
       const seq = event.seq ?? -1;
+      const isReasoning = event.type === 'assistant/chunk'
+        && event.data?.chunk?.type === 'reasoning-delta';
+      // The mux is lossy across reconnects. Only history may advance the
+      // durable cursor or finish the reply; the mux supplements reasoning.
+      if (fromMux && !isReasoning) continue;
+      if (isReasoning) {
+        if (!live || !Number.isFinite(seq)) continue;
+        if (this.#targetTurn === null) this.#bufferReasoning(event);
+        else this.#emitReasoning(event, pushUpdate);
+        continue;
+      }
+      if (this.#targetTurn === null) {
+        if (seq <= this.#lastSeq) continue;
+        if (event.type === 'turn/start') {
+          this.#openTurn = event.data?.turn ?? null;
+          continue;
+        }
+        if (event.type === 'user/message' && event.data?.source?.rpcId === this.#promptRpcId) {
+          this.#lastSeq = seq;
+          this.#targetTurn = event.data?.turn ?? this.#openTurn;
+          if (live && this.#targetTurn !== null) {
+            pushUpdate({ type: 'turn-start', turn: this.#targetTurn });
+            // Only earlier fragments flush here. Later steps remain in the
+            // sorted batch, interleaved with their tool calls and results.
+            for (const pending of this.#takePendingReasoning()) {
+              this.#emitReasoning(pending, pushUpdate);
+            }
+          }
+        }
+        continue;
+      }
       if (seq <= this.#lastSeq) continue;
       this.#lastSeq = seq;
 
       if (event.type === 'turn/start') this.#openTurn = event.data?.turn ?? null;
 
       if (event.type === 'user/message' && event.data?.source?.rpcId === this.#promptRpcId) {
-        this.#targetTurn = this.#openTurn;
+        this.#targetTurn = event.data?.turn ?? this.#openTurn;
+        if (live) pushUpdate({ type: 'turn-start', turn: this.#targetTurn });
         continue;
       }
       if (this.#targetTurn === null) continue;
@@ -577,6 +684,13 @@ export class HarnessReplyTracker {
         this.#finished = true;
         this.#reason = event.data?.reason ?? null;
         this.#openTurn = null;
+        if (live) {
+          pushUpdate({
+            type: 'turn-end',
+            turn: this.#targetTurn,
+            reason: this.#reason,
+          });
+        }
         continue;
       }
       if (event.data?.turn !== this.#targetTurn) continue;
@@ -595,7 +709,22 @@ export class HarnessReplyTracker {
         this.#assistantText.setCanonical(step, text);
         // canonical 定稿且非空时按 step 透出，供分步推送消费方使用；
         // 先于 commitText 透出，保持 text 更新作为批次末尾的既有语义。
-        if (text) pushUpdate({ type: 'assistant-message', step, text });
+        if (text) {
+          pushUpdate({
+            type: 'assistant-message',
+            step,
+            text,
+            ...(live ? { turn: this.#targetTurn } : {}),
+          });
+        }
+        // Thinking-trace channels consume this as the 💭 line that precedes the
+        // tool call it explains; only consumers that explicitly subscribed
+        // (reasoning: true) see these updates, so default-mode channels keep
+        // their pre-thinking-traces progress stream.
+        if (this.#reasoning) {
+          const reasoning = assistantReasoningText(event);
+          if (reasoning) pushUpdate({ type: 'reasoning', step, text: reasoning });
+        }
         this.#commitText(this.#assistantText.text, pushUpdate);
         continue;
       }
@@ -618,20 +747,38 @@ export class HarnessReplyTracker {
             }
           }
         }
-        pushUpdate({ type: 'tool', name, ...(argsText ? { arguments: argsText } : {}), ...(callId ? { callId } : {}) });
+        pushUpdate({
+          type: 'tool',
+          name,
+          ...(argsText ? { arguments: argsText } : {}),
+          ...(callId ? { callId } : {}),
+          ...(live ? { turn: this.#targetTurn } : {}),
+        });
       } else if (event.type === 'tool/result') {
-        const callId = nonEmptyText(event.data?.message?.source?.callId)
-          ?? nonEmptyText(event.data?.callId)
-          ?? nonEmptyText(event.data?.subCallId);
+        const callId = toolResultCallId(event.data);
         const toolName = (callId ? this.#toolNames.get(callId) : null)
           ?? this.#lastToolName;
         const error = toolResultErrorText(event.data?.error);
-        pushUpdate({
-          type: 'status',
-          text: t('正在整理结果…'),
-          ...(toolName ? { toolName } : {}),
-          ...(error ? { error } : {}),
-        });
+        if (live) {
+          const providerErrorCode = event.data?.error?.code;
+          pushUpdate({
+            type: 'tool-result',
+            turn: this.#targetTurn,
+            ...(callId ? { callId } : {}),
+            ...(toolName ? { toolName } : {}),
+            text: toolResultText(event.data),
+            ...(providerErrorCode !== undefined && providerErrorCode !== null
+              ? { errorCode: String(providerErrorCode) }
+              : {}),
+          });
+        } else {
+          pushUpdate({
+            type: 'status',
+            text: t('正在整理结果…'),
+            ...(toolName ? { toolName } : {}),
+            ...(error ? { error } : {}),
+          });
+        }
       }
     }
     return updates;
@@ -642,6 +789,19 @@ export class HarnessReplyTracker {
   }
 }
 
+/**
+ * Progress updates an ask() consumer actually receives. latest 模式只投递一条
+ * 最新进展；assistant-message 是分步推送专用更新，且 canonical 去重后可能成为
+ * 批次唯一变化，绝不能冒充进度投给全部渠道。reasoning 同为思考留痕渠道专用，
+ * 默认模式下不得冒充进度（钉钉、企微等会展示其 text）。
+ */
+export function visibleProgressUpdates(updates, progressMode) {
+  if (progressMode === 'all') return updates;
+  return updates
+    .filter((update) => update.type !== 'assistant-message' && update.type !== 'reasoning')
+    .slice(-1);
+}
+
 export class HarnessRpcError extends Error {
   constructor(method, error) {
     super(`${method}: ${error?.message ?? 'unknown Harness RPC error'}`);
@@ -706,7 +866,6 @@ function harnessTurnError(reason) {
     return new HarnessTurnError('turn-interrupted', { reason });
   }
   if (kind === 'aborted') return new HarnessTurnError('turn-aborted', { reason });
-  if (kind === 'completed') return new HarnessTurnError('model-empty-response', { reason });
   return new HarnessTurnError('harness-turn-failed', { reason });
 }
 
@@ -732,6 +891,7 @@ export class HarnessClient {
   #controlExecutor;
   #sessionMaintenanceExecutor;
   #fileIngressExecutor;
+  #imageInputPolicy;
   #managedProcess = null;
   #interactionRegistry;
   #interactionOwnerships;
@@ -756,6 +916,7 @@ export class HarnessClient {
     controlExecutor,
     sessionMaintenanceExecutor,
     fileIngressExecutor,
+    imageInputPolicy = () => undefined,
   }) {
     if (typeof createWebSocket !== 'function') {
       throw new TypeError('createWebSocket must be a function');
@@ -807,6 +968,7 @@ export class HarnessClient {
     this.#controlExecutor = controlExecutor;
     this.#sessionMaintenanceExecutor = sessionMaintenanceExecutor;
     this.#fileIngressExecutor = fileIngressExecutor;
+    this.#imageInputPolicy = imageInputPolicy;
     this.#interactionRegistry = interactionRegistry(this.#baseUrl?.origin ?? interactionScope);
     this.#interactionOwnerships = this.#interactionRegistry.ownerships;
     this.#interactionClaims = this.#interactionRegistry.claims;
@@ -1142,6 +1304,7 @@ export class HarnessClient {
     signal,
     onInteraction,
     onResolved,
+    onSessionEvent,
     onOpen,
     ownership,
   } = {}) {
@@ -1155,6 +1318,9 @@ export class HarnessClient {
     if (onResolved !== undefined && typeof onResolved !== 'function') {
       throw new TypeError('onResolved must be a function');
     }
+    if (onSessionEvent !== undefined && typeof onSessionEvent !== 'function') {
+      throw new TypeError('onSessionEvent must be a function');
+    }
     if (onOpen !== undefined && typeof onOpen !== 'function') {
       throw new TypeError('onOpen must be a function');
     }
@@ -1165,6 +1331,7 @@ export class HarnessClient {
           signal,
           onInteraction,
           onResolved,
+          onSessionEvent,
           onOpen,
           ownership,
         });
@@ -1436,12 +1603,21 @@ export class HarnessClient {
     });
   }
 
+  async getImageInputLimits() {
+    return imageInputLimits(await this.#imageInputPolicy());
+  }
+
   async ask(sessionId, prompt, options = {}) {
     if (typeof options === 'number') options = { timeoutMs: options };
     const timeoutMs = options.timeoutMs ?? 600_000;
     const signal = options.signal;
     const onUpdate = typeof options.onUpdate === 'function' ? options.onUpdate : null;
-    const progressMode = options.progressMode === 'all' ? 'all' : 'latest';
+    const progressMode = options.progressMode === 'live'
+      ? 'live'
+      : options.progressMode === 'all' ? 'all' : 'latest';
+    // Reasoning updates only exist for consumers that opt in (thinking-trace
+    // mode); default ask() consumers keep the pre-thinking-traces stream.
+    const reasoning = options.reasoning === true;
     const onArtifact = typeof options.onArtifact === 'function' ? options.onArtifact : null;
     const onInteraction = typeof options.onInteraction === 'function'
       ? options.onInteraction
@@ -1451,6 +1627,7 @@ export class HarnessClient {
       : undefined;
     const control = normalizeControl(options.control);
     const inboundFiles = Array.isArray(options.files) ? options.files.filter(Boolean) : [];
+    const inboundImages = Array.isArray(options.images) ? options.images.filter(Boolean) : [];
     await this.ensureRunning({ signal });
     const before = await this.rpc(
       'session.history',
@@ -1461,8 +1638,39 @@ export class HarnessClient {
     const baselineSeq = Math.max(-1, ...(before.events ?? []).map(({ event }) => event.seq ?? -1));
     const promptRpcId = `${this.#rpcIdPrefix}-${randomUUID()}`;
     const releasePromptInputOrigin = registerImInputOrigin(this.#interactionRegistry, promptRpcId);
-    const tracker = new HarnessReplyTracker({ promptRpcId, afterSeq: baselineSeq });
+    const tracker = new HarnessReplyTracker({ promptRpcId, afterSeq: baselineSeq, reasoning });
+    let lastProgressAt = Date.now();
+    let lastPollSeq = tracker.lastSeq;
+    let progressTail = Promise.resolve();
+    const consumeProgress = (entries, { fromMux = false } = {}) => {
+      const updates = tracker.consumeAll(entries, {
+        live: progressMode === 'live',
+        fromMux,
+      });
+      const seqAdvanced = tracker.lastSeq > lastPollSeq;
+      lastPollSeq = tracker.lastSeq;
+      if (seqAdvanced) lastProgressAt = Date.now();
+      if (!onUpdate) return progressTail;
+      const visibleUpdates = progressMode === 'all' || progressMode === 'live'
+        ? updates
+        : updates
+            .filter((update) => update.type !== 'assistant-message' && update.type !== 'reasoning')
+            .slice(-1);
+      for (const update of visibleUpdates) {
+        progressTail = progressTail
+          .then(() => onUpdate(update))
+          .catch((error) => {
+            console.warn(
+              '[dsh-im] ignored a progress update failure:',
+              this.#logPrefix,
+              error.message,
+            );
+          });
+      }
+      return progressTail;
+    };
     const interactionController = onInteraction || onInteractionResolved
+      || (progressMode === 'live' && onUpdate)
       ? new AbortController()
       : null;
     const interactionSignal = interactionController
@@ -1493,6 +1701,7 @@ export class HarnessClient {
     let interactionTask = null;
     let artifactsDelivered = false;
     let deliveredArtifactCount = 0;
+    let artifactHandoffError = null;
     const stagedBatches = [];
     let promptAccepted = false;
     let turnFinished = false;
@@ -1508,6 +1717,7 @@ export class HarnessClient {
           await onArtifact(artifact);
           deliveredArtifactCount += 1;
         } catch (error) {
+          artifactHandoffError ??= error;
           outboundArtifactRegistry.release(artifact);
           console.warn('[dsh-im] ignored an artifact handoff failure:', this.#logPrefix, error.message);
         }
@@ -1530,6 +1740,26 @@ export class HarnessClient {
         stagedBatches.push(staged);
         prompt = appendInboundFilesToPrompt(prompt, staged);
       }
+      if (inboundImages.length > 0) {
+        const limits = await this.getImageInputLimits();
+        const sources = inboundImagesAsFiles(inboundImages, limits);
+        let staged;
+        try {
+          staged = await this.#stageWorkspaceFiles(sessionId, sources, signal);
+        } catch (error) {
+          // Ingress wraps loader errors; retain the original image diagnostic.
+          if (signal?.aborted) throw signal.reason ?? error;
+          if (error?.cause?.name === 'ImagePromptError') throw error.cause;
+          throw error;
+        }
+        stagedBatches.push(staged);
+        const images = await imageContentFromStaged(staged, limits, { signal });
+        const originalContent = typeof basePrompt === 'string'
+          ? [{ type: 'text', text: basePrompt }] : basePrompt;
+        prompt = appendInboundFilesToPrompt([...originalContent, ...images], {
+          files: stagedBatches.flatMap((batch) => batch.files),
+        });
+      }
       if (interactionSignal) {
         let markOpen;
         const opened = new Promise((resolve) => { markOpen = resolve; });
@@ -1537,6 +1767,9 @@ export class HarnessClient {
           signal: interactionSignal,
           onInteraction,
           onResolved: onInteractionResolved,
+          onSessionEvent: progressMode === 'live'
+            ? (event) => { consumeProgress([event], { fromMux: true }); }
+            : undefined,
           onOpen: markOpen,
           ownership,
         });
@@ -1577,29 +1810,32 @@ export class HarnessClient {
         // Session workspace and named in a text manifest — then retry once
         // with a text-only prompt. The retry reuses promptRpcId so reply
         // tracking, control and interaction ownership stay bound to this ask.
-        const imageSources = isModelImageRejection(error)
-          ? imageFileSourcesFromContent(content)
-          : [];
-        if (imageSources.length === 0) throw error;
-        let stagedImages;
-        try {
-          stagedImages = await this.#stageWorkspaceFiles(sessionId, imageSources, signal);
-        } catch (stagingError) {
-          if (signal?.aborted) throw signal.reason ?? stagingError;
-          console.warn(
-            '[dsh-im] unable to restage rejected images as workspace files:',
-            this.#logPrefix,
-            stagingError?.message ?? String(stagingError),
-          );
-          throw error;
+        const originalsStaged = inboundImages.length > 0 && isImageAdmissionRejection(error)
+          && content.some((part) => part.type === 'image');
+        const imageSources = !originalsStaged && isModelImageRejection(error)
+          ? imageFileSourcesFromContent(content) : [];
+        if (!originalsStaged && imageSources.length === 0) throw error;
+        if (!originalsStaged) {
+          let stagedImages;
+          try {
+            stagedImages = await this.#stageWorkspaceFiles(sessionId, imageSources, signal);
+          } catch (stagingError) {
+            if (signal?.aborted) throw signal.reason ?? stagingError;
+            console.warn(
+              '[dsh-im] unable to restage rejected images as workspace files:',
+              this.#logPrefix,
+              stagingError?.message ?? String(stagingError),
+            );
+            throw error;
+          }
+          stagedBatches.push(stagedImages);
         }
-        stagedBatches.push(stagedImages);
         const baseContent = typeof basePrompt === 'string'
           ? [{ type: 'text', text: basePrompt }]
           : basePrompt;
         const fallbackPrompt = appendInboundFilesToPrompt([
           ...contentWithoutImages(baseContent),
-          { type: 'text', text: t(IMAGE_FILE_FALLBACK_PROMPT) },
+          { type: 'text', text: t(isModelImageRejection(error) ? IMAGE_FILE_FALLBACK_PROMPT : IMAGE_HOST_LIMIT_FALLBACK_PROMPT) },
         ], { files: stagedBatches.flatMap((batch) => batch?.files ?? []) });
         await sendPrompt(fallbackPrompt);
       }
@@ -1611,8 +1847,6 @@ export class HarnessClient {
         // confirm the Session is still running before renewing the wait.
         // Interaction ownership is intentionally not a liveness signal: it stays
         // active until turn/end and can therefore outlive a stalled turn.
-        let lastProgressAt = Date.now();
-        let lastPollSeq = tracker.lastSeq;
         while (true) {
           await sleep(300, signal);
           const history = await this.rpc(
@@ -1626,24 +1860,7 @@ export class HarnessClient {
             this.#consumeInteractionOwnerships(sessionId, history.events ?? []);
             if (!wasActive && ownership.active) ownership.reconnect?.();
           }
-          const updates = tracker.consumeAll(history.events ?? []);
-          const seqAdvanced = tracker.lastSeq > lastPollSeq;
-          lastPollSeq = tracker.lastSeq;
-          if (seqAdvanced) lastProgressAt = Date.now();
-          if (onUpdate) {
-            // latest 模式只投递一条最新进展；assistant-message 是分步推送专用更新，
-            // 且 canonical 去重后可能成为批次唯一变化，绝不能冒充进度投给全部渠道。
-            const visibleUpdates = progressMode === 'all'
-              ? updates
-              : updates.filter((update) => update.type !== 'assistant-message').slice(-1);
-            for (const update of visibleUpdates) {
-              try {
-                await onUpdate(update);
-              } catch (error) {
-                console.warn('[dsh-im] ignored a progress update failure:', this.#logPrefix, error.message);
-              }
-            }
-          }
+          await consumeProgress(history.events ?? []);
           if (tracker.finished) {
             turnFinished = true;
             if (!ownership?.stopRequested && !harnessTurnSucceeded(tracker.reason)) {
@@ -1659,6 +1876,12 @@ export class HarnessClient {
             }
             if (artifactCount > 0) return '';
             if (ownership?.stopRequested) throw turnStoppedError();
+            if (artifactHandoffError) throw artifactHandoffError;
+            // A completed turn can do all its work through tools without text.
+            // Missing end reasons retain the existing empty-reply failure.
+            if (tracker.reason != null && harnessTurnSucceeded(tracker.reason)) {
+              return t('本轮处理已结束，没有文本回复。');
+            }
             throw harnessTurnError(tracker.reason);
           }
 
@@ -1681,6 +1904,11 @@ export class HarnessClient {
           throw timeoutError;
         }
       } catch (error) {
+        if (error instanceof HarnessTurnError) {
+          error.details ??= {
+            sessionId, promptRpcId, baselineSeq, turn: tracker.turn, lastSeq: tracker.lastSeq,
+          };
+        }
         // Once cancellation was accepted, transport/poll failures and timeouts
         // describe the convergence of that stop, not an unrelated ask failure.
         if (!ownership?.stopRequested) throw error;
@@ -1716,6 +1944,7 @@ export class HarnessClient {
     signal,
     onInteraction,
     onResolved,
+    onSessionEvent,
     onOpen,
     ownership,
   }) {
@@ -1755,8 +1984,9 @@ export class HarnessClient {
     };
     const processEnvelope = (envelope) => {
       const payload = envelope.payload;
-      if (ownership && payload.type === 'session/event') {
-        this.#consumeInteractionOwnerships(sessionId, [payload.event]);
+      if (payload.type === 'session/event') {
+        if (ownership) this.#consumeInteractionOwnerships(sessionId, [payload.event]);
+        dispatch(onSessionEvent, payload.event);
         return;
       }
       if (payload.type === 'question/requested' || payload.type === 'approval/requested') {

package/src/channels/shared/i18n-en/diagnostics.mjs

@@ -0,0 +1,55 @@
+export default Object.freeze({
+  "DSH 版本": "DSH version",
+  "依赖版本": "Dependency versions",
+  "代理已配置": "Proxy configured",
+  "原因链已截断": "Cause chain truncated",
+  "请在 macOS 系统设置中授予 DSH 完全磁盘访问权限，以读取 Messages 数据库。": "Grant DSH Full Disk Access in macOS System Settings to read the Messages database.",
+  "请在 macOS 系统设置中允许 DSH 自动控制 Messages。": "Allow DSH to control Messages in macOS System Settings.",
+  "先在 macOS 系统设置中授予 Messages 权限。": "Grant Messages permissions in macOS System Settings first.",
+
+  "加载渠道配置": "Load channel configuration",
+  "激活账号": "Activate account",
+  "启动连接": "Start connection",
+  "监测连接与消息": "Monitor connection and messages",
+  "停止连接": "Stop connection",
+  "服务返回码": "Provider code",
+  "验证凭据": "Verify credentials",
+  "检查权限": "Check permissions",
+  "加载渠道组件": "Load channel component",
+  "执行渠道操作": "Perform channel operation",
+  "接收消息": "Receive message",
+  "发送消息": "Send message",
+  "发送测试消息": "Send test message",
+  "暂未识别": "Unknown",
+  "操作已取消。": "The operation was cancelled.",
+  "本地会话状态清理失败，请查看诊断详情。": "Local session state cleanup failed. See the diagnostic details.",
+  "账号已移除，但本地状态清理失败。": "The account was removed, but local state cleanup failed.",
+  "账号已移除，但登录凭据清理失败。": "The account was removed, but credential cleanup failed.",
+  "连接已移除，但登录凭据清理失败。": "The connection was removed, but credential cleanup failed.",
+
+  "操作失败，请查看原因和诊断详情。": "The operation failed. See the cause and diagnostic details.",
+  "检测到多个底层原因，请展开诊断详情逐项检查。": "Multiple underlying causes were detected. Expand the diagnostic details to inspect them.",
+  "服务域名解析失败，请检查运行 DSH 的机器的 DNS 和网络设置。": "Service DNS resolution failed. Check DNS and network settings on the machine running DSH.",
+  "目标拒绝连接，请检查服务地址、端口和访问限制。": "The connection was refused. Check the service address, port, and access restrictions.",
+  "连接已中断，请检查网络和目标服务状态。": "The connection was interrupted. Check the network and target service.",
+  "目标网络不可达，请检查运行 DSH 的机器的网络出口和访问限制。": "The target network is unreachable. Check network routing and access restrictions on the machine running DSH.",
+  "TLS 或证书校验失败，请检查系统时间、证书链和网络设置。": "TLS or certificate validation failed. Check the system clock, certificate chain, and network settings.",
+  "请求超时，请检查目标服务和网络；诊断详情中可查看已知的耗时。": "The request timed out. Check the service and network; available timings are in the diagnostic details.",
+  "代理连接或认证失败，请检查 DSH 进程使用的代理配置。": "Proxy connection or authentication failed. Check the proxy configuration used by the DSH process.",
+  "服务认证失败，请检查账号和授权信息。": "Service authentication failed. Check the account and credentials.",
+  "操作权限不足，请检查对应资源的访问权限。": "Permission was denied. Check access to the affected resource.",
+  "所需文件或本地工具不存在，请检查安装和配置。": "A required file or local tool is missing. Check installation and configuration.",
+  "服务正在限流，请稍后重试。": "The service is rate limiting requests. Try again later.",
+  "服务拒绝了请求，请检查凭据、权限或访问限制；HTTP 状态本身不能确认登录失效。": "The service rejected the request. Check credentials, permissions, or access restrictions; the HTTP status alone does not prove that the login expired.",
+  "目标服务暂时异常，请稍后重试。": "The target service is temporarily unavailable. Try again later.",
+  "目标服务返回了 HTTP 错误，请查看诊断详情。": "The target service returned an HTTP error. See the diagnostic details.",
+  "数据格式无效，请按失败阶段检查服务响应或本地配置。": "The data format is invalid. Check the service response or local configuration indicated by the failing stage.",
+  "暂未识别具体原因，请复制诊断信息，并查看相同参考号的 DSH 日志。": "The underlying cause is unknown. Copy the diagnostics and find the matching reference in the DSH logs.",
+  "多个原因": "Multiple causes",
+  "服务域名": "Service host",
+  "请求耗时（毫秒）": "Request duration (ms)",
+  "超时阈值（毫秒）": "Timeout (ms)",
+  "Node 版本": "Node version",
+  "运行平台": "Platform",
+  "无法访问 DSH 管理接口，请检查 DSH 连接或重新登录后重试。": "Cannot access the DSH management API. Check the DSH connection or sign in again."
+});

package/src/channels/shared/i18n-en/email.mjs

@@ -0,0 +1,25 @@
+/** English projections for host-side Email channel text. */
+export default Object.freeze({
+  '邮箱': 'Email',
+  '邮箱地址格式不正确': 'The email address format is invalid',
+  '邮箱地址与应用密码均为必填': 'Both the email address and the app password are required',
+  '请选择邮箱服务商或填写 IMAP/SMTP 服务器地址':
+    'Choose a mail provider or fill in the IMAP/SMTP server addresses',
+  '必须至少配置一个允许发件人':
+    'At least one allowed sender must be configured',
+  '邮箱连接失败，请检查地址、应用密码与服务器设置':
+    'Could not connect to the mailbox; check the address, app password, and server settings',
+  '未找到该邮箱配置': 'No mailbox configuration was found',
+  '邮箱凭据已丢失，请重新绑定':
+    'The mailbox credential is missing; please bind the mailbox again',
+  '邮箱尚未连接': 'The mailbox is not connected yet',
+  '邮箱通道连接正常。': 'The Email channel is connected.',
+  '邮箱通道运行正常': 'The Email channel is running normally',
+  '邮箱通道尚未连接': 'The Email channel is not connected yet',
+  '邮箱访问策略同步失败，请重试': 'Failed to sync the mailbox access policy; please retry',
+  '当前环境不支持会话绑定': 'Session binding is not supported in this environment',
+  '该接入方式不需要扫码授权': 'This access method does not use QR authorization',
+  '授权信息缺失，请重新扫码授权': 'The authorization is missing; please scan again',
+  '扫码授权尚未开始': 'QR authorization has not been started',
+  '扫码授权已超时，请重新发起': 'QR authorization timed out; please start it again',
+});