@rezti/dsh-rez-wechat 0.1.21 → 0.1.23

package/lib/web-shim.d.ts

@@ -74,6 +74,8 @@ export declare function ensureWechatInboxAgents(cwd: string): void;
 export declare function sessionStorePath(env?: NodeJS.ProcessEnv, home?: string): string;
 export declare function loadSessionStore(path: string): SessionStore;
 export declare function saveSessionStore(path: string, store: SessionStore): void;
+/** Drop the sticky session pointer for one room/chat key (WeCom restart / stuck recovery). */
+export declare function clearSessionStoreKey(path: string, key: string): void;
 /** dsh 0.1.5+ wire endpoint is `namespace/method` (slash), not `namespace.method`. */
 export declare function normalizeRpcEndpoint(method: string): string;
 /**
@@ -104,6 +106,19 @@ export declare function parseChoice(userText: string, questions: PendingQuestion
     label: string;
 } | undefined;
 export declare function historyEvents(body: unknown): unknown[];
+/** Durable seq, or seq0 for batched frames like text-chunks. Missing → -1. */
+export declare function eventSeq(event: unknown): number;
+export declare function historyCursor(events: unknown[]): number;
+/**
+ * True when a turn that started *after* beforeSeq has ended.
+ * Events without seq are always included (unit fixtures / legacy history).
+ */
+export declare function turnSettledAfter(events: unknown[], beforeSeq: number): boolean;
+/**
+ * Visible assistant text for WeChat.
+ * Web UI streams via text-chunks; final assistant/message is often tool-only.
+ * Prefer longer streamed chunks when they supersede a short mid-turn message.
+ */
 export declare function lastAssistantText(events: unknown[]): string;
 export declare function turnIsIdle(events: unknown[]): boolean;
 export declare function pickWechatModel(models: unknown, env?: NodeJS.ProcessEnv): ModelRef | undefined;
@@ -130,4 +145,7 @@ export declare function runHeadlessViaWeb(opts: {
     env?: NodeJS.ProcessEnv;
     rpc?: RpcFn;
     timeoutMs?: number;
+    signal?: AbortSignal;
+    /** Personal WeChat restores via suite unarchive HTTP; WeCom must not. Default true. */
+    sidebarUnarchive?: boolean;
 }): Promise<string>;

package/lib/web-shim.js

@@ -269,6 +269,14 @@ export function saveSessionStore(path, store) {
     mkdirSync(dirname(path), { recursive: true });
     writeFileSync(path, JSON.stringify(store, null, 2), 'utf8');
 }
+/** Drop the sticky session pointer for one room/chat key (WeCom restart / stuck recovery). */
+export function clearSessionStoreKey(path, key) {
+    const store = loadSessionStore(path);
+    if (store.sessions[key] === undefined)
+        return;
+    delete store.sessions[key];
+    saveSessionStore(path, store);
+}
 /** dsh 0.1.5+ wire endpoint is `namespace/method` (slash), not `namespace.method`. */
 export function normalizeRpcEndpoint(method) {
     if (method.includes('/'))
@@ -725,24 +733,105 @@ export function historyEvents(body) {
                         : []);
     return raw.map(unwrapHistoryItem);
 }
+/** Durable seq, or seq0 for batched frames like text-chunks. Missing → -1. */
+export function eventSeq(event) {
+    if (typeof event !== 'object' || event === null)
+        return -1;
+    const rec = event;
+    if (typeof rec.seq === 'number' && Number.isFinite(rec.seq))
+        return rec.seq;
+    if (typeof rec.seq0 === 'number' && Number.isFinite(rec.seq0))
+        return rec.seq0;
+    return -1;
+}
+export function historyCursor(events) {
+    let max = -1;
+    for (const event of events) {
+        const seq = eventSeq(event);
+        if (seq > max)
+            max = seq;
+    }
+    return max;
+}
+/**
+ * True when a turn that started *after* beforeSeq has ended.
+ * Events without seq are always included (unit fixtures / legacy history).
+ */
+export function turnSettledAfter(events, beforeSeq) {
+    let open = 0;
+    let sawStart = false;
+    for (const event of events) {
+        if (typeof event !== 'object' || event === null)
+            continue;
+        const seq = eventSeq(event);
+        if (seq >= 0 && seq <= beforeSeq)
+            continue;
+        const type = event.type;
+        if (type === 'turn/start') {
+            open += 1;
+            sawStart = true;
+        }
+        if (type === 'turn/end')
+            open = Math.max(0, open - 1);
+    }
+    return sawStart && open === 0;
+}
+function textsFromChunkEvent(rec) {
+    const data = typeof rec.data === 'object' && rec.data !== null ? rec.data : rec;
+    const texts = data.texts;
+    if (!Array.isArray(texts))
+        return '';
+    return texts.map(part => typeof part === 'string' ? part : '').join('');
+}
+/**
+ * Visible assistant text for WeChat.
+ * Web UI streams via text-chunks; final assistant/message is often tool-only.
+ * Prefer longer streamed chunks when they supersede a short mid-turn message.
+ */
 export function lastAssistantText(events) {
-    let text = '';
+    let lastUserSeq = -1;
+    for (const event of events) {
+        if (typeof event !== 'object' || event === null)
+            continue;
+        const rec = event;
+        const type = typeof rec.type === 'string' ? rec.type : '';
+        const role = typeof rec.role === 'string' ? rec.role : '';
+        if (type === 'user/message' || role === 'user') {
+            lastUserSeq = Math.max(lastUserSeq, eventSeq(rec));
+        }
+    }
+    let fromMessage = '';
+    const chunkParts = [];
     for (const event of events) {
         if (typeof event !== 'object' || event === null)
             continue;
         const rec = event;
         const type = typeof rec.type === 'string' ? rec.type : '';
+        const seq = eventSeq(rec);
+        const afterUser = lastUserSeq < 0 || seq < 0 || seq > lastUserSeq;
+        if (afterUser && type === 'text-chunks') {
+            const piece = textsFromChunkEvent(rec);
+            if (piece !== '')
+                chunkParts.push(piece);
+            continue;
+        }
         const role = typeof rec.role === 'string' ? rec.role : '';
         const isAssistant = type === 'assistant/message' || role === 'assistant';
-        if (!isAssistant)
+        if (!isAssistant || !afterUser)
             continue;
         const data = typeof rec.data === 'object' && rec.data !== null ? rec.data : rec;
         const message = typeof data.message === 'object' && data.message !== null ? data.message : data;
-        const chunk = flattenVisibleText(message.content ?? data.content ?? rec.content) || (typeof rec.text === 'string' ? stripThinkTags(rec.text) : '');
+        const chunk = flattenVisibleText(message.content ?? data.content ?? rec.content)
+            || (typeof rec.text === 'string' ? stripThinkTags(rec.text) : '');
         if (chunk.trim() !== '')
-            text = chunk;
+            fromMessage = chunk;
     }
-    return text.trim();
+    const fromChunks = chunkParts.join('');
+    const msg = fromMessage.trim();
+    const chunks = fromChunks.trim();
+    if (chunks.length > msg.length)
+        return chunks;
+    return msg || chunks;
 }
 export function turnIsIdle(events) {
     let open = 0;
@@ -975,7 +1064,8 @@ async function fetchSessionHistory(rpc, sessionId, maxMessages = 40) {
             method: 'session/page',
             params: {
                 address: { kind: 'session', sessionId },
-                throughSeq: Number.MAX_SAFE_INTEGER,
+                // Official tip-of-log sentinel. MAX_SAFE_INTEGER is "past cursor" and always 400s.
+                throughSeq: -1,
                 maxMessages,
             },
         },
@@ -1115,11 +1205,15 @@ function composeWechatReply(events, ignorePending) {
     }
     return { text: visible, pendingQuestions };
 }
-async function waitForAssistant(rpc, sessionId, beforeText, timeoutMs, ignorePending, stuckText = STUCK_ACK) {
+async function waitForAssistant(rpc, sessionId, beforeText, beforeSeq, timeoutMs, ignorePending, stuckText = STUCK_ACK, signal) {
     const deadline = Date.now() + timeoutMs;
     let last = { text: '', pendingQuestions: [] };
     let idleOnce = false;
+    const emptyDone = '（本轮无文字回复，请到网页查看）';
     while (Date.now() < deadline) {
+        if (signal?.aborted === true) {
+            throw new Error('本轮已被新消息打断（可发「重启对话」或再问一句）');
+        }
         let events = [];
         try {
             events = await fetchSessionHistory(rpc, sessionId, 40);
@@ -1136,6 +1230,18 @@ async function waitForAssistant(rpc, sessionId, beforeText, timeoutMs, ignorePen
             return { text: stuckText, pendingQuestions: [] };
         if (composed.text !== '')
             last = composed;
+        const cursorAware = beforeSeq >= 0 || events.some(event => eventSeq(event) >= 0);
+        if (cursorAware && turnSettledAfter(events, beforeSeq)) {
+            if (composed.text !== '' && composed.text !== beforeText)
+                return composed;
+            // Turn finished but no new usable text (tool-only / filtered monologue).
+            return {
+                text: composed.text !== '' && composed.text === beforeText
+                    ? '（本轮已完成，但没有新的文字回复；请到网页查看）'
+                    : emptyDone,
+                pendingQuestions: composed.pendingQuestions,
+            };
+        }
         const idle = turnIsIdle(events);
         if (idle)
             idleOnce = true;
@@ -1160,6 +1266,8 @@ export async function runHeadlessViaWeb(opts) {
     const customRpc = opts.rpc !== undefined;
     const rpc = opts.rpc ?? ((method, params) => postRpc(webBaseUrl(env), method, params));
     const timeoutMs = opts.timeoutMs ?? Number(env.DSH_BRIDGE_TIMEOUT_MS ?? 10 * 60 * 1000);
+    const signal = opts.signal;
+    const sidebarUnarchive = opts.sidebarUnarchive !== false && !customRpc;
     const workspaceId = await ensureWorkspace(rpc, workspace);
     const folder = basename(workspace) || WECHAT_WORKSPACE_NAME;
     const restart = isRestartCommand(text);
@@ -1171,6 +1279,7 @@ export async function runHeadlessViaWeb(opts) {
     // the user asked to restart or the old session is already gone.
     if (restart) {
         sessionId = undefined;
+        clearSessionStoreKey(storeFile, key);
     }
     else if (sessionId !== undefined) {
         const alive = await sessionAlive(rpc, sessionId);
@@ -1180,24 +1289,29 @@ export async function runHeadlessViaWeb(opts) {
     if (sessionId === undefined) {
         sessionId = await createSession(rpc, workspace, workspaceId);
         await maybeSelectModel(rpc, sessionId, env);
-        await ensureSessionVisible(rpc, sessionId, env, workspaceId, !customRpc);
+        await ensureSessionVisible(rpc, sessionId, env, workspaceId, sidebarUnarchive);
         if (previousId !== undefined && previousId !== sessionId) {
             await abortSessionTurn(rpc, previousId);
             await archiveSession(rpc, previousId);
         }
     }
     else {
-        await ensureSessionVisible(rpc, sessionId, env, workspaceId, !customRpc);
+        await ensureSessionVisible(rpc, sessionId, env, workspaceId, sidebarUnarchive);
     }
+    if (signal?.aborted === true)
+        throw new Error('本轮已被新消息打断');
     const promptText = restart ? RESTART_SEED : text;
     let before = '';
+    let beforeSeq = -1;
     let events = [];
     try {
         events = await fetchSessionHistory(rpc, sessionId, 40);
         before = usableAssistantText(lastAssistantText(events));
+        beforeSeq = historyCursor(events);
     }
     catch {
         before = '';
+        beforeSeq = -1;
     }
     const pending = extractPendingQuestions(events);
     const questions = pending.length > 0
@@ -1223,13 +1337,20 @@ export async function runHeadlessViaWeb(opts) {
         }
         await rpc('session/prompt', promptPayload(sessionId, promptText));
     }
-    const reply = await waitForAssistant(rpc, sessionId, before, timeoutMs, questions, stuckAck(folder));
-    store.sessions[key] = {
-        sessionId,
-        updatedAt: Date.now(),
-        ...(reply.pendingQuestions.length > 0 ? { pendingQuestions: reply.pendingQuestions } : {}),
-    };
-    saveSessionStore(storeFile, store);
+    const reply = await waitForAssistant(rpc, sessionId, before, beforeSeq, timeoutMs, questions, stuckAck(folder), signal);
+    // Stuck / approval-blocked sessions poison the sticky pointer — drop it so
+    // the next WeCom/WeChat turn opens a fresh web session instead of hanging.
+    if (reply.text === stuckAck(folder)) {
+        clearSessionStoreKey(storeFile, key);
+    }
+    else {
+        store.sessions[key] = {
+            sessionId,
+            updatedAt: Date.now(),
+            ...(reply.pendingQuestions.length > 0 ? { pendingQuestions: reply.pendingQuestions } : {}),
+        };
+        saveSessionStore(storeFile, store);
+    }
     if (restart && (reply.text === stuckAck(folder) || reply.text === ''))
         return restartAck(folder);
     return reply.text;

package/lib/wecom-channel.d.ts

@@ -4,6 +4,9 @@
  */
 import { type WecomBotPublic, type WecomBotRecord } from './wecom-store.js';
 export declare const WECOM_NON_TEXT_HINT = "\u8BF7\u53D1\u6587\u5B57\u3002\u56FE\u7247\u548C\u6587\u4EF6\u8BF7\u8D70\u7F51\u9875\u7AEF\u6216 Nextcloud\u3002";
+/** WeCom stream payload soft limit; oversize finish frames are dropped by the SDK. */
+export declare const WECOM_REPLY_MAX_CHARS = 20000;
+export declare function clipWecomReply(text: string): string;
 export type WecomBindingPhase = 'idle' | 'connecting' | 'authenticated' | 'error';
 export interface WecomBindingStatus {
     room: string;
@@ -32,7 +35,9 @@ export type WecomClientFactory = (opts: {
     botId: string;
     secret: string;
 }) => WecomWsClient | Promise<WecomWsClient>;
-export type WecomRunTurn = (room: string, text: string) => Promise<string>;
+export type WecomRunTurn = (room: string, text: string, signal?: AbortSignal) => Promise<string>;
+/** Cap how long one WeCom turn can block the per-room queue (stuck Kimi / approval). */
+export declare const WECOM_TURN_TIMEOUT_MS = 90000;
 export declare function extractWecomText(frame: unknown): string;
 export declare function wecomMsgid(frame: unknown): string;
 export declare function createOfficialWecomClient(opts: {
@@ -62,6 +67,11 @@ export declare class WecomChannel {
     private dropBindings;
     private bind;
     private enqueue;
+    /**
+     * Abort the in-flight turn as soon as a new text arrives (before the serial
+     * queue reaches it). Otherwise「重启对话」waits behind a hung「正在处理…」.
+     */
+    private enqueueText;
     private rememberMsgid;
     private handleText;
     private handleNonText;

package/lib/wecom-channel.js

@@ -4,9 +4,18 @@
  */
 import { join } from 'node:path';
 import { dshHome } from '@rezti/dsh-rez-sso';
-import { runHeadlessViaWeb } from './web-shim.js';
+import { clearSessionStoreKey, isRestartCommand, runHeadlessViaWeb, } from './web-shim.js';
 import { loadWecomChannels, publicWecomBots, saveWecomChannels, applyWecomBotPatch, WECOM_BINDABLE_ROOMS, } from './wecom-store.js';
 export const WECOM_NON_TEXT_HINT = '请发文字。图片和文件请走网页端或 Nextcloud。';
+/** WeCom stream payload soft limit; oversize finish frames are dropped by the SDK. */
+export const WECOM_REPLY_MAX_CHARS = 20_000;
+export function clipWecomReply(text) {
+    if (text.length <= WECOM_REPLY_MAX_CHARS)
+        return text;
+    return `${text.slice(0, WECOM_REPLY_MAX_CHARS - 16)}\n…(已截断)`;
+}
+/** Cap how long one WeCom turn can block the per-room queue (stuck Kimi / approval). */
+export const WECOM_TURN_TIMEOUT_MS = 90_000;
 const MAX_SEEN_MSGIDS = 200;
 export function extractWecomText(frame) {
     if (typeof frame !== 'object' || frame === null)
@@ -85,13 +94,16 @@ export async function createOfficialWecomClient(opts) {
         logger: quietLogger,
     });
 }
-async function defaultRunTurn(room, text) {
+async function defaultRunTurn(room, text, signal) {
     const home = dshHome();
     // Pass the user text as-is. Session stickiness is per-room in web-sessions.json;
     // do not wrap WeCom turns in 桥接上下文 just to reuse a dialog.
     return runHeadlessViaWeb({
         task: text,
         cwd: room,
+        ...(signal !== undefined ? { signal } : {}),
+        timeoutMs: WECOM_TURN_TIMEOUT_MS,
+        sidebarUnarchive: false,
         env: {
             ...process.env,
             REZ_WECHAT_WORKSPACE: join(home, 'workspaces', room),
@@ -192,11 +204,11 @@ export class WecomChannel {
                 const why = error instanceof Error ? error.message : String(error);
                 row.hint = `「${bot.room}」连接失败：${why}`;
             });
-            client.on('message.text', (frame) => { this.enqueue(row, () => this.handleText(row, frame)); });
-            client.on('message.mixed', (frame) => { this.enqueue(row, () => this.handleText(row, frame)); });
+            client.on('message.text', (frame) => { this.enqueueText(row, frame); });
+            client.on('message.mixed', (frame) => { this.enqueueText(row, frame); });
             client.on('message.image', (frame) => { this.enqueue(row, () => this.handleNonText(row, frame)); });
             client.on('message.file', (frame) => { this.enqueue(row, () => this.handleNonText(row, frame)); });
-            client.on('message.voice', (frame) => { this.enqueue(row, () => this.handleText(row, frame)); });
+            client.on('message.voice', (frame) => { this.enqueueText(row, frame); });
             client.on('message.video', (frame) => { this.enqueue(row, () => this.handleNonText(row, frame)); });
             client.on('event.enter_chat', (frame) => {
                 this.enqueue(row, async () => {
@@ -219,6 +231,20 @@ export class WecomChannel {
             console.error(`[wecom] ${row.bot.room}: ${why}`);
         });
     }
+    /**
+     * Abort the in-flight turn as soon as a new text arrives (before the serial
+     * queue reaches it). Otherwise「重启对话」waits behind a hung「正在处理…」.
+     */
+    enqueueText(row, frame) {
+        const text = extractWecomText(frame);
+        if (text.length > 0) {
+            row.turnAbort?.abort();
+            if (isRestartCommand(text)) {
+                clearSessionStoreKey(join(this.home, 'dsh-rez-wecom', row.bot.room, 'web-sessions.json'), row.bot.room);
+            }
+        }
+        this.enqueue(row, () => this.handleText(row, frame));
+    }
     rememberMsgid(row, frame) {
         const id = wecomMsgid(frame);
         if (id.length === 0)
@@ -239,14 +265,58 @@ export class WecomChannel {
             await row.client.replyStream(frame, streamId, WECOM_NON_TEXT_HINT, true);
             return;
         }
+        const turnAbort = new AbortController();
+        row.turnAbort = turnAbort;
+        const timeout = AbortSignal.timeout(WECOM_TURN_TIMEOUT_MS);
+        const signal = AbortSignal.any([turnAbort.signal, timeout]);
+        let finished = false;
+        const finish = async (content) => {
+            if (finished)
+                return;
+            finished = true;
+            await row.client.replyStream(frame, streamId, clipWecomReply(content), true);
+        };
         try {
             await row.client.replyStream(frame, streamId, '正在处理…', false);
-            const reply = await this.runTurn(row.bot.room, text);
-            await row.client.replyStream(frame, streamId, reply.length > 0 ? reply : '（空回复）', true);
+            const reply = await this.runTurn(row.bot.room, text, signal);
+            if (turnAbort.signal.aborted) {
+                await finish('已取消（收到新消息）');
+                return;
+            }
+            await finish(reply.length > 0 ? reply : '（空回复）');
         }
         catch (error) {
             const why = error instanceof Error ? error.message : String(error);
-            await row.client.replyStream(frame, streamId, `处理失败：${why}`, true);
+            const superseded = turnAbort.signal.aborted && !timeout.aborted;
+            if (superseded) {
+                try {
+                    await finish('已取消（收到新消息）');
+                }
+                catch { /* WS may already be closed */ }
+                return;
+            }
+            const timedOut = timeout.aborted || /aborted|timeout|TimeoutError|打断/i.test(why);
+            const message = timedOut
+                ? '处理超时。请发「重启对话」再试，或到网页左侧该房间看是否在等批准。'
+                : `处理失败：${why}`;
+            try {
+                await finish(message);
+            }
+            catch {
+                /* WS may already be closed */
+            }
+            // Poisoned sticky session: force the next turn to mint a fresh web session.
+            clearSessionStoreKey(join(this.home, 'dsh-rez-wecom', row.bot.room, 'web-sessions.json'), row.bot.room);
+        }
+        finally {
+            if (!finished) {
+                try {
+                    await finish('（回复中断，请再发一句或「重启对话」）');
+                }
+                catch { /* WS may already be closed */ }
+            }
+            if (row.turnAbort === turnAbort)
+                delete row.turnAbort;
         }
     }
     async handleNonText(row, frame) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rezti/dsh-rez-wechat",
-  "version": "0.1.21",
+  "version": "0.1.23",
   "description": "ReZ-TI WeChat/WeCom bridges. Personal WeChat is QClaw/ClawBot scan-and-chat via dsh-wechat-bridge; WeCom AI bots use the official @wecom/aibot-node-sdk (BotID + Secret) bound per Harness room.",
   "type": "module",
   "engines": {