shennian 0.2.89 → 0.2.90

package/dist/src/channels/websocket.js

@@ -1,378 +1,8 @@
-// @arch docs/features/external-websocket-channel.md
-// @test src/__tests__/manager-runtime.test.ts
-import { randomUUID } from 'node:crypto';
-import WebSocket from 'ws';
-import { ChannelSecretRegistry } from './secret-registry.js';
-const RECONNECT_BACKOFF_MS = [2_000, 5_000, 10_000, 30_000];
-const HEARTBEAT_MS = 30_000;
-const SEND_TIMEOUT_MS = 15_000;
-export class ExternalWebSocketChannelAdapter {
-    onMessage;
-    type = 'websocket';
-    secrets = new ChannelSecretRegistry();
-    connections = new Map();
-    constructor(onMessage) {
-        this.onMessage = onMessage;
-    }
-    async connect(config) {
-        if (!config.enabled)
-            return;
-        const conn = this.ensureConnection(config);
-        if (conn.connecting)
-            return conn.connecting;
-        conn.stopped = false;
-        conn.config = config;
-        conn.connecting = this.openConnection(conn).finally(() => {
-            conn.connecting = null;
-        });
-        return conn.connecting;
-    }
-    async disconnect(config) {
-        const conn = this.connections.get(config.id);
-        if (!conn)
-            return;
-        conn.stopped = true;
-        if (conn.reconnectTimer)
-            clearTimeout(conn.reconnectTimer);
-        if (conn.pingTimer)
-            clearInterval(conn.pingTimer);
-        conn.reconnectTimer = null;
-        conn.pingTimer = null;
-        for (const pending of conn.pendingAcks.values()) {
-            clearTimeout(pending.timer);
-            pending.reject(new Error('External websocket adapter disconnected'));
-        }
-        conn.pendingAcks.clear();
-        const socket = conn.socket;
-        conn.socket = null;
-        if (socket)
-            await new Promise((resolve) => {
-                socket.once('close', () => resolve());
-                socket.close();
-                setTimeout(resolve, 500);
-            });
-        this.connections.delete(config.id);
-    }
-    async send(config, reply) {
-        const conn = this.ensureConnection(config);
-        const secret = this.readSecret(config);
-        if (secret.canReply === false) {
-            throw new Error('External websocket channel does not allow replies');
-        }
-        await this.connect(config);
-        const requestId = reply.idempotencyKey || `send_${randomUUID()}`;
-        await this.sendAwaitAck(conn, requestId, {
-            type: 'message.send',
-            requestId,
-            conversationId: reply.conversationId,
-            contentType: 'text',
-            text: reply.text,
-            replyToMessageId: reply.messageId ?? undefined,
-        });
-    }
-    async health(config) {
-        const secret = this.readSecret(config);
-        if (!secret.wsUrl || !secret.token) {
-            return { ok: false, message: 'External websocket requires local wsUrl and token' };
-        }
-        const conn = this.connections.get(config.id);
-        return conn?.socket?.readyState === WebSocket.OPEN
-            ? { ok: true }
-            : { ok: false, message: 'External websocket disconnected' };
-    }
-    async defaultConversation(config) {
-        const secret = this.readSecret(config);
-        const url = new URL(secret.wsUrl);
-        url.protocol = url.protocol === 'wss:' ? 'https:' : 'http:';
-        url.pathname = url.pathname.replace(/\/ws\/?$/, '/subscription/self');
-        url.search = '';
-        const response = await fetch(url, {
-            headers: {
-                Authorization: `Bearer ${secret.token}`,
-            },
-        });
-        const data = await response.json().catch(() => null);
-        if (!response.ok || !data?.ok) {
-            throw new Error(data?.error || `External websocket metadata failed: ${response.status}`);
-        }
-        if (data.subscription?.allowSend === false) {
-            throw new Error('External websocket subscription does not allow send');
-        }
-        const conversationId = String(data.subscription?.defaultConversationId || '').trim();
-        if (!conversationId) {
-            throw new Error('External websocket subscription has no single default conversation');
-        }
-        return {
-            conversationId,
-            conversationName: String(data.subscription?.defaultConversationName || '').trim() || undefined,
-        };
-    }
-    ensureConnection(config) {
-        let conn = this.connections.get(config.id);
-        if (!conn) {
-            conn = {
-                config,
-                socket: null,
-                connecting: null,
-                stopped: false,
-                reconnectAttempt: 0,
-                reconnectTimer: null,
-                pingTimer: null,
-                dedup: new Set(),
-                dedupQueue: [],
-                seenBatchMessageKeys: new Set(),
-                seenBatchMessageQueue: [],
-                pendingAcks: new Map(),
-            };
-            this.connections.set(config.id, conn);
-        }
-        conn.config = config;
-        return conn;
-    }
-    readSecret(config) {
-        const secret = this.secrets.get(config.secretRef);
-        if (!secret || secret.type !== 'websocket' || !secret.wsUrl || !secret.token) {
-            throw new Error('External websocket channel is not configured on this daemon');
-        }
-        return secret;
-    }
-    async openConnection(conn) {
-        const secret = this.readSecret(conn.config);
-        const wsUrl = secret.wsUrl;
-        const socket = new WebSocket(wsUrl, {
-            headers: {
-                Authorization: `Bearer ${secret.token}`,
-            },
-        });
-        conn.socket = socket;
-        await new Promise((resolve, reject) => {
-            const cleanup = () => {
-                socket.off('open', handleOpen);
-                socket.off('error', handleError);
-            };
-            const handleOpen = () => {
-                cleanup();
-                resolve();
-            };
-            const handleError = (error) => {
-                cleanup();
-                reject(error);
-            };
-            socket.once('open', handleOpen);
-            socket.once('error', handleError);
-        });
-        socket.on('message', (data) => {
-            const payload = this.parsePayload(data.toString());
-            if (!payload)
-                return;
-            this.handlePayload(conn, payload);
-        });
-        socket.on('close', () => this.scheduleReconnect(conn));
-        socket.on('error', () => this.scheduleReconnect(conn));
-        conn.reconnectAttempt = 0;
-        if (conn.pingTimer)
-            clearInterval(conn.pingTimer);
-        conn.pingTimer = setInterval(() => {
-            void this.sendJson(conn, { type: 'ping', timestamp: new Date().toISOString() }).catch(() => { });
-        }, HEARTBEAT_MS);
-        conn.pingTimer.unref();
-    }
-    scheduleReconnect(conn) {
-        if (conn.stopped)
-            return;
-        if (conn.reconnectTimer || conn.connecting)
-            return;
-        const delay = RECONNECT_BACKOFF_MS[Math.min(conn.reconnectAttempt, RECONNECT_BACKOFF_MS.length - 1)];
-        conn.reconnectAttempt += 1;
-        conn.reconnectTimer = setTimeout(() => {
-            conn.reconnectTimer = null;
-            void this.connect(conn.config).catch(() => { });
-        }, delay);
-        conn.reconnectTimer.unref();
-    }
-    async sendJson(conn, payload) {
-        if (!conn.socket || conn.socket.readyState !== WebSocket.OPEN) {
-            throw new Error('External websocket is not connected');
-        }
-        conn.socket.send(JSON.stringify(payload));
-    }
-    async sendAwaitAck(conn, requestId, payload) {
-        await new Promise((resolve, reject) => {
-            const timer = setTimeout(() => {
-                conn.pendingAcks.delete(requestId);
-                reject(new Error('External websocket send timed out'));
-            }, SEND_TIMEOUT_MS);
-            timer.unref();
-            conn.pendingAcks.set(requestId, { resolve, reject, timer });
-            void this.sendJson(conn, payload).catch((error) => {
-                clearTimeout(timer);
-                conn.pendingAcks.delete(requestId);
-                reject(error instanceof Error ? error : new Error(String(error)));
-            });
-        });
-    }
-    handlePayload(conn, payload) {
-        const type = String(payload.type || '');
-        if (type === 'ack' || type === 'error') {
-            const requestId = String(payload.requestId || '');
-            const pending = requestId ? conn.pendingAcks.get(requestId) : undefined;
-            if (!pending)
-                return;
-            clearTimeout(pending.timer);
-            conn.pendingAcks.delete(requestId);
-            if (type === 'ack' && payload.ok !== false)
-                pending.resolve();
-            else
-                pending.reject(new Error(String(payload.error || 'External websocket send failed')));
-            return;
-        }
-        if (type === 'hello' || type === 'pong')
-            return;
-        if (type !== 'message.inbound' && type !== 'message.inbound.batch')
-            return;
-        const messageId = String(payload.messageId || payload.batchId || payload.id || '');
-        if (!messageId || this.isDuplicate(conn, messageId))
-            return;
-        const attachments = this.normalizeAttachments(payload);
-        const text = this.buildVisibleText(conn, payload, attachments);
-        const conversationId = String(payload.conversationId || '').trim();
-        if (Array.isArray(payload.messages) && !text)
-            return;
-        if ((!text && attachments.length === 0) || !conversationId)
-            return;
-        this.onMessage?.({
-            managerSessionId: conn.config.managerSessionId,
-            channelId: conn.config.id,
-            channelType: 'websocket',
-            conversationId,
-            messageId,
-            sender: {
-                id: String(payload.senderId || 'unknown'),
-                name: typeof payload.senderName === 'string' ? payload.senderName : null,
-            },
-            text,
-            attachments,
-            receivedAt: typeof payload.endedAt === 'string' ? payload.endedAt : new Date().toISOString(),
-            replyTarget: '',
-        });
-    }
-    buildVisibleText(conn, payload, attachments) {
-        const text = String(payload.text || '').trim();
-        if (text)
-            return text;
-        if (Array.isArray(payload.messages)) {
-            return payload.messages
-                .map((item, index) => {
-                if (!item || typeof item !== 'object')
-                    return '';
-                const message = item;
-                const messageKey = this.batchMessageKey(message, payload);
-                if (messageKey && this.hasSeenBatchMessage(conn, messageKey))
-                    return '';
-                const isGroupMessage = String(message.conversationType || payload.conversationType || '') === 'group';
-                const sender = String(message.senderName || (isGroupMessage ? '群友' : message.senderExternalId || message.senderId || 'unknown'));
-                const time = this.formatMessageTime(message.timestampIso || message.timestamp);
-                const messageText = String(message.text || '').trim();
-                const messageAttachments = this.normalizeAttachments(message);
-                const attachmentText = messageAttachments.map((attachment) => this.formatAttachment(attachment)).join(' ');
-                const content = [messageText, attachmentText].filter(Boolean).join(' ').trim() || `[${String(message.contentType || 'message')}]`;
-                if (messageKey)
-                    this.rememberBatchMessage(conn, messageKey);
-                return `${index + 1}. ${time} ${sender}: ${content}`;
-            })
-                .filter(Boolean)
-                .join('\n')
-                .trim();
-        }
-        return attachments.map((attachment) => this.formatAttachment(attachment)).join('\n');
-    }
-    batchMessageKey(message, payload) {
-        const explicitId = String(message.messageId || message.msgid || message.id || message.rawId || '').trim();
-        if (explicitId)
-            return `id:${explicitId}`;
-        const sender = String(message.senderExternalId || message.senderId || message.senderName || '').trim();
-        const timestamp = String(message.timestampIso || message.timestamp || message.receivedAt || '').trim();
-        const text = String(message.text || '').trim();
-        const contentType = String(message.contentType || '').trim();
-        const conversationId = String(message.conversationId || payload.conversationId || '').trim();
-        const attachmentKey = this.normalizeAttachments(message)
-            .map((attachment) => [attachment.type, attachment.name || '', attachment.url || '', attachment.size ?? ''].join(':'))
-            .join('|');
-        return `content:${conversationId}\n${sender}\n${timestamp}\n${contentType}\n${text}\n${attachmentKey}`;
-    }
-    hasSeenBatchMessage(conn, key) {
-        return conn.seenBatchMessageKeys.has(key);
-    }
-    rememberBatchMessage(conn, key) {
-        if (conn.seenBatchMessageKeys.has(key))
-            return;
-        conn.seenBatchMessageKeys.add(key);
-        conn.seenBatchMessageQueue.push(key);
-        while (conn.seenBatchMessageQueue.length > 2_000) {
-            const removed = conn.seenBatchMessageQueue.shift();
-            if (removed)
-                conn.seenBatchMessageKeys.delete(removed);
-        }
-    }
-    normalizeAttachments(payload) {
-        const direct = Array.isArray(payload.attachments) ? payload.attachments : [];
-        const nested = Array.isArray(payload.messages)
-            ? payload.messages.flatMap((item) => {
-                if (!item || typeof item !== 'object')
-                    return [];
-                const message = item;
-                return Array.isArray(message.attachments) ? message.attachments : [];
-            })
-            : [];
-        return [...direct, ...nested]
-            .filter((item) => Boolean(item) && typeof item === 'object')
-            .map((item) => ({
-            type: String(item.type || 'file'),
-            name: typeof item.name === 'string' ? item.name : undefined,
-            url: typeof item.url === 'string' ? item.url : undefined,
-            mimeType: typeof item.mimeType === 'string' ? item.mimeType : undefined,
-            size: typeof item.size === 'number' ? item.size : undefined,
-        }));
-    }
-    formatAttachment(attachment) {
-        const label = attachment.name ? `${attachment.type}: ${attachment.name}` : attachment.type;
-        return attachment.url ? `[${label} ${attachment.url}]` : `[${label}]`;
-    }
-    formatMessageTime(value) {
-        const date = typeof value === 'number'
-            ? new Date(value < 10_000_000_000 ? value * 1000 : value)
-            : new Date(String(value || ''));
-        if (Number.isNaN(date.getTime()))
-            return String(value || '');
-        return new Intl.DateTimeFormat('zh-CN', {
-            timeZone: 'Asia/Shanghai',
-            month: '2-digit',
-            day: '2-digit',
-            hour: '2-digit',
-            minute: '2-digit',
-            second: '2-digit',
-            hour12: false,
-        }).format(date).replace(/\//g, '-');
-    }
-    isDuplicate(conn, messageId) {
-        if (conn.dedup.has(messageId))
-            return true;
-        conn.dedup.add(messageId);
-        conn.dedupQueue.push(messageId);
-        if (conn.dedupQueue.length > 1_000) {
-            const removed = conn.dedupQueue.shift();
-            if (removed)
-                conn.dedup.delete(removed);
-        }
-        return false;
-    }
-    parsePayload(raw) {
-        try {
-            const parsed = JSON.parse(raw);
-            return parsed && typeof parsed === 'object' ? parsed : null;
-        }
-        catch {
-            return null;
-        }
-    }
-}
+import{randomUUID as w}from"node:crypto";import u from"ws";import{ChannelSecretRegistry as S}from"./secret-registry.js";const l=[2e3,5e3,1e4,3e4],y=3e4,k=15e3;class M{onMessage;type="websocket";secrets=new S;connections=new Map;constructor(e){this.onMessage=e}async connect(e){if(!e.enabled)return;const t=this.ensureConnection(e);return t.connecting||(t.stopped=!1,t.config=e,t.connecting=this.openConnection(t).finally(()=>{t.connecting=null})),t.connecting}async disconnect(e){const t=this.connections.get(e.id);if(!t)return;t.stopped=!0,t.reconnectTimer&&clearTimeout(t.reconnectTimer),t.pingTimer&&clearInterval(t.pingTimer),t.reconnectTimer=null,t.pingTimer=null;for(const n of t.pendingAcks.values())clearTimeout(n.timer),n.reject(new Error("External websocket adapter disconnected"));t.pendingAcks.clear();const s=t.socket;t.socket=null,s&&await new Promise(n=>{s.once("close",()=>n()),s.close(),setTimeout(n,500)}),this.connections.delete(e.id)}async send(e,t){const s=this.ensureConnection(e);if(this.readSecret(e).canReply===!1)throw new Error("External websocket channel does not allow replies");await this.connect(e);const r=t.idempotencyKey||`send_${w()}`;await this.sendAwaitAck(s,r,{type:"message.send",requestId:r,conversationId:t.conversationId,contentType:"text",text:t.text,replyToMessageId:t.messageId??void 0})}async health(e){const t=this.readSecret(e);return!t.wsUrl||!t.token?{ok:!1,message:"External websocket requires local wsUrl and token"}:this.connections.get(e.id)?.socket?.readyState===u.OPEN?{ok:!0}:{ok:!1,message:"External websocket disconnected"}}async defaultConversation(e){const t=this.readSecret(e),s=new URL(t.wsUrl);s.protocol=s.protocol==="wss:"?"https:":"http:",s.pathname=s.pathname.replace(/\/ws\/?$/,"/subscription/self"),s.search="";const n=await fetch(s,{headers:{Authorization:`Bearer ${t.token}`}}),r=await n.json().catch(()=>null);if(!n.ok||!r?.ok)throw new Error(r?.error||`External websocket metadata failed: ${n.status}`);if(r.subscription?.allowSend===!1)throw new Error("External websocket subscription does not allow send");const o=String(r.subscription?.defaultConversationId||"").trim();if(!o)throw new Error("External websocket subscription has no single default conversation");return{conversationId:o,conversationName:String(r.subscription?.defaultConversationName||"").trim()||void 0}}ensureConnection(e){let t=this.connections.get(e.id);return t||(t={config:e,socket:null,connecting:null,stopped:!1,reconnectAttempt:0,reconnectTimer:null,pingTimer:null,dedup:new Set,dedupQueue:[],seenBatchMessageKeys:new Set,seenBatchMessageQueue:[],pendingAcks:new Map},this.connections.set(e.id,t)),t.config=e,t}readSecret(e){const t=this.secrets.get(e.secretRef);if(!t||t.type!=="websocket"||!t.wsUrl||!t.token)throw new Error("External websocket channel is not configured on this daemon");return t}async openConnection(e){const t=this.readSecret(e.config),s=t.wsUrl,n=new u(s,{headers:{Authorization:`Bearer ${t.token}`}});e.socket=n,await new Promise((r,o)=>{const i=()=>{n.off("open",c),n.off("error",a)},c=()=>{i(),r()},a=d=>{i(),o(d)};n.once("open",c),n.once("error",a)}),n.on("message",r=>{const o=this.parsePayload(r.toString());o&&this.handlePayload(e,o)}),n.on("close",()=>this.scheduleReconnect(e)),n.on("error",()=>this.scheduleReconnect(e)),e.reconnectAttempt=0,e.pingTimer&&clearInterval(e.pingTimer),e.pingTimer=setInterval(()=>{this.sendJson(e,{type:"ping",timestamp:new Date().toISOString()}).catch(()=>{})},y),e.pingTimer.unref()}scheduleReconnect(e){if(e.stopped||e.reconnectTimer||e.connecting)return;const t=l[Math.min(e.reconnectAttempt,l.length-1)];e.reconnectAttempt+=1,e.reconnectTimer=setTimeout(()=>{e.reconnectTimer=null,this.connect(e.config).catch(()=>{})},t),e.reconnectTimer.unref()}async sendJson(e,t){if(!e.socket||e.socket.readyState!==u.OPEN)throw new Error("External websocket is not connected");e.socket.send(JSON.stringify(t))}async sendAwaitAck(e,t,s){await new Promise((n,r)=>{const o=setTimeout(()=>{e.pendingAcks.delete(t),r(new Error("External websocket send timed out"))},k);o.unref(),e.pendingAcks.set(t,{resolve:n,reject:r,timer:o}),this.sendJson(e,s).catch(i=>{clearTimeout(o),e.pendingAcks.delete(t),r(i instanceof Error?i:new Error(String(i)))})})}handlePayload(e,t){const s=String(t.type||"");if(s==="ack"||s==="error"){const c=String(t.requestId||""),a=c?e.pendingAcks.get(c):void 0;if(!a)return;clearTimeout(a.timer),e.pendingAcks.delete(c),s==="ack"&&t.ok!==!1?a.resolve():a.reject(new Error(String(t.error||"External websocket send failed")));return}if(s==="hello"||s==="pong"||s!=="message.inbound"&&s!=="message.inbound.batch")return;const n=String(t.messageId||t.batchId||t.id||"");if(!n||this.isDuplicate(e,n))return;const r=this.normalizeAttachments(t),o=this.buildVisibleText(e,t,r),i=String(t.conversationId||"").trim();Array.isArray(t.messages)&&!o||!o&&r.length===0||!i||this.onMessage?.({managerSessionId:e.config.managerSessionId,channelId:e.config.id,channelType:"websocket",conversationId:i,messageId:n,sender:{id:String(t.senderId||"unknown"),name:typeof t.senderName=="string"?t.senderName:null},text:o,attachments:r,receivedAt:typeof t.endedAt=="string"?t.endedAt:new Date().toISOString(),replyTarget:""})}buildVisibleText(e,t,s){const n=String(t.text||"").trim();return n||(Array.isArray(t.messages)?t.messages.map((r,o)=>{if(!r||typeof r!="object")return"";const i=r,c=this.batchMessageKey(i,t);if(c&&this.hasSeenBatchMessage(e,c))return"";const a=String(i.conversationType||t.conversationType||"")==="group",d=String(i.senderName||(a?"\u7FA4\u53CB":i.senderExternalId||i.senderId||"unknown")),m=this.formatMessageTime(i.timestampIso||i.timestamp),h=String(i.text||"").trim(),g=this.normalizeAttachments(i).map(f=>this.formatAttachment(f)).join(" "),p=[h,g].filter(Boolean).join(" ").trim()||`[${String(i.contentType||"message")}]`;return c&&this.rememberBatchMessage(e,c),`${o+1}. ${m} ${d}: ${p}`}).filter(Boolean).join(`
+`).trim():s.map(r=>this.formatAttachment(r)).join(`
+`))}batchMessageKey(e,t){const s=String(e.messageId||e.msgid||e.id||e.rawId||"").trim();if(s)return`id:${s}`;const n=String(e.senderExternalId||e.senderId||e.senderName||"").trim(),r=String(e.timestampIso||e.timestamp||e.receivedAt||"").trim(),o=String(e.text||"").trim(),i=String(e.contentType||"").trim(),c=String(e.conversationId||t.conversationId||"").trim(),a=this.normalizeAttachments(e).map(d=>[d.type,d.name||"",d.url||"",d.size??""].join(":")).join("|");return`content:${c}
+${n}
+${r}
+${i}
+${o}
+${a}`}hasSeenBatchMessage(e,t){return e.seenBatchMessageKeys.has(t)}rememberBatchMessage(e,t){if(!e.seenBatchMessageKeys.has(t))for(e.seenBatchMessageKeys.add(t),e.seenBatchMessageQueue.push(t);e.seenBatchMessageQueue.length>2e3;){const s=e.seenBatchMessageQueue.shift();s&&e.seenBatchMessageKeys.delete(s)}}normalizeAttachments(e){const t=Array.isArray(e.attachments)?e.attachments:[],s=Array.isArray(e.messages)?e.messages.flatMap(n=>{if(!n||typeof n!="object")return[];const r=n;return Array.isArray(r.attachments)?r.attachments:[]}):[];return[...t,...s].filter(n=>!!n&&typeof n=="object").map(n=>({type:String(n.type||"file"),name:typeof n.name=="string"?n.name:void 0,url:typeof n.url=="string"?n.url:void 0,mimeType:typeof n.mimeType=="string"?n.mimeType:void 0,size:typeof n.size=="number"?n.size:void 0}))}formatAttachment(e){const t=e.name?`${e.type}: ${e.name}`:e.type;return e.url?`[${t} ${e.url}]`:`[${t}]`}formatMessageTime(e){const t=typeof e=="number"?new Date(e<1e10?e*1e3:e):new Date(String(e||""));return Number.isNaN(t.getTime())?String(e||""):new Intl.DateTimeFormat("zh-CN",{timeZone:"Asia/Shanghai",month:"2-digit",day:"2-digit",hour:"2-digit",minute:"2-digit",second:"2-digit",hour12:!1}).format(t).replace(/\//g,"-")}isDuplicate(e,t){if(e.dedup.has(t))return!0;if(e.dedup.add(t),e.dedupQueue.push(t),e.dedupQueue.length>1e3){const s=e.dedupQueue.shift();s&&e.dedup.delete(s)}return!1}parsePayload(e){try{const t=JSON.parse(e);return t&&typeof t=="object"?t:null}catch{return null}}}export{M as ExternalWebSocketChannelAdapter};

package/dist/src/channels/wechat-channel/anchor.js

@@ -1,65 +1 @@
-// @arch docs/features/wechat-rpa-productization-plan.md
-// @test src/__tests__/wechat-channel-anchor.test.ts
-export function normalizeWeChatAnchorText(value) {
-    if (typeof value !== 'string')
-        return '';
-    return value
-        .normalize('NFKC')
-        .replace(/\s+/g, ' ')
-        .trim()
-        .toLowerCase();
-}
-export function weChatAnchorText(message) {
-    return normalizeWeChatAnchorText(message.anchorText || message.normalizedText || message.textExcerpt || '');
-}
-export function weChatTextSimilarity(left, right) {
-    const a = normalizeWeChatAnchorText(left);
-    const b = normalizeWeChatAnchorText(right);
-    if (!a || !b)
-        return 0;
-    if (a === b)
-        return 1;
-    const distance = levenshtein(a, b);
-    return 1 - distance / Math.max(a.length, b.length);
-}
-export function isLikelySameWeChatMessage(previous, current, threshold = 0.86) {
-    if (previous.stableMessageKey && previous.stableMessageKey === current.stableMessageKey)
-        return true;
-    if (previous.senderRole !== current.senderRole)
-        return false;
-    if (previous.kind !== current.kind)
-        return false;
-    const previousAnchor = weChatAnchorText(previous);
-    const currentAnchor = weChatAnchorText(current);
-    if (!previousAnchor || !currentAnchor)
-        return false;
-    return weChatTextSimilarity(previousAnchor, currentAnchor) >= threshold;
-}
-export function filterNewWeChatMessagesByAnchor(input) {
-    const consumed = new Set();
-    const result = [];
-    for (const current of input.current) {
-        const index = input.previous.findIndex((previous, previousIndex) => {
-            return !consumed.has(previousIndex) && isLikelySameWeChatMessage(previous, current, input.threshold);
-        });
-        if (index >= 0) {
-            consumed.add(index);
-            continue;
-        }
-        result.push(current);
-    }
-    return result;
-}
-function levenshtein(a, b) {
-    const prev = Array.from({ length: b.length + 1 }, (_, index) => index);
-    const curr = Array.from({ length: b.length + 1 }, () => 0);
-    for (let i = 1; i <= a.length; i += 1) {
-        curr[0] = i;
-        for (let j = 1; j <= b.length; j += 1) {
-            curr[j] = Math.min(prev[j] + 1, curr[j - 1] + 1, prev[j - 1] + (a[i - 1] === b[j - 1] ? 0 : 1));
-        }
-        for (let j = 0; j <= b.length; j += 1)
-            prev[j] = curr[j];
-    }
-    return prev[b.length];
-}
+function i(e){return typeof e!="string"?"":e.normalize("NFKC").replace(/\s+/g," ").trim().toLowerCase()}function a(e){return i(e.anchorText||e.normalizedText||e.textExcerpt||"")}function l(e,t){const o=i(e),r=i(t);return!o||!r?0:o===r?1:1-f(o,r)/Math.max(o.length,r.length)}function h(e,t,o=.86){if(e.stableMessageKey&&e.stableMessageKey===t.stableMessageKey)return!0;if(e.senderRole!==t.senderRole||e.kind!==t.kind)return!1;const r=a(e),s=a(t);return!r||!s?!1:l(r,s)>=o}function u(e){const t=new Set,o=[];for(const r of e.current){const s=e.previous.findIndex((n,c)=>!t.has(c)&&h(n,r,e.threshold));if(s>=0){t.add(s);continue}o.push(r)}return o}function f(e,t){const o=Array.from({length:t.length+1},(s,n)=>n),r=Array.from({length:t.length+1},()=>0);for(let s=1;s<=e.length;s+=1){r[0]=s;for(let n=1;n<=t.length;n+=1)r[n]=Math.min(o[n]+1,r[n-1]+1,o[n-1]+(e[s-1]===t[n-1]?0:1));for(let n=0;n<=t.length;n+=1)o[n]=r[n]}return o[t.length]}export{u as filterNewWeChatMessagesByAnchor,h as isLikelySameWeChatMessage,i as normalizeWeChatAnchorText,a as weChatAnchorText,l as weChatTextSimilarity};

package/dist/src/channels/wechat-channel/client.js

@@ -1,96 +1 @@
-// @arch docs/features/wechat-rpa-productization-plan.md
-// @test src/__tests__/wechat-channel-client.test.ts
-import { SERVERS } from '../../region.js';
-import { loadConfig } from '../../config/index.js';
-export function createWeChatChannelApiClient(options = {}) {
-    const config = loadConfig();
-    const serverUrl = normalizeServerUrl(options.serverUrl || config.serverUrl || SERVERS.cn.url);
-    const machineToken = options.machineToken || config.machineToken;
-    const fetchImpl = options.fetchImpl || fetch;
-    if (!machineToken)
-        throw new Error('WeChat channel requires a paired machine token');
-    async function request(path, body) {
-        const response = await fetchImpl(`${serverUrl}/api/channels/wechat${path}`, {
-            method: body === undefined ? 'GET' : 'POST',
-            headers: {
-                authorization: `Bearer ${machineToken}`,
-                ...(body === undefined ? {} : { 'content-type': 'application/json' }),
-            },
-            body: body === undefined ? undefined : JSON.stringify(body),
-        });
-        const text = await response.text();
-        const payload = text ? JSON.parse(text) : null;
-        if (!response.ok || payload?.ok === false) {
-            const reason = payload?.reasonCode || response.statusText || 'request_failed';
-            throw new Error(`WeChat channel API ${path} failed: ${reason}`);
-        }
-        return payload;
-    }
-    return {
-        getRuntimePolicy: () => request('/runtime-policy'),
-        upsertRuntime: (runtime, binding) => request('/runtime', {
-            runtimeId: runtime.runtimeId,
-            machineId: runtime.machineId,
-            pollIntervalSeconds: Math.round(runtime.policy.pollIntervalMs / 1000),
-            foregroundPolicy: runtime.foregroundPolicy,
-            clientRuntimeVersion: String(runtime.policy.runtimeVersion),
-            ...(binding ? bindingPayload(binding) : {}),
-        }),
-        observe: (runtime, binding, input) => request('/observe', {
-            runtimeId: runtime.runtimeId,
-            bindingId: binding.bindingId,
-            sessionId: binding.sessionId,
-            machineId: runtime.machineId,
-            conversationName: binding.conversationDisplayName,
-            schemaVersion: runtime.policy.runtimeVersion,
-            screenshots: input.screenshots,
-            edgeOcrBlocks: input.edgeOcrBlocks ?? [],
-            visibleConversationFingerprints: input.visibleConversationFingerprints ?? [],
-            localLedgerTailAnchors: input.localLedgerTailAnchors ?? [],
-        }),
-        ingest: (runtime, binding, input) => request('/ingest', {
-            runtimeId: runtime.runtimeId,
-            idempotencyKey: input.idempotencyKey,
-            bindingId: binding.bindingId,
-            sessionId: binding.sessionId,
-            machineId: runtime.machineId,
-            messages: input.messages,
-        }),
-        reportOutboundStatus: (runtime, binding, input) => request('/outbound-status', {
-            runtimeId: runtime.runtimeId,
-            replyId: input.replyId,
-            idempotencyKey: input.idempotencyKey,
-            bindingId: binding.bindingId,
-            sessionId: binding.sessionId,
-            machineId: runtime.machineId,
-            status: input.status,
-            replyBaseRevision: input.replyBaseRevision,
-            sentAt: input.sentAt,
-            confirmedAt: input.confirmedAt,
-            failureCode: input.failureCode,
-            lastErrorSummary: input.lastErrorSummary,
-        }),
-        reportRunStatus: (runtime, binding, input) => request('/run-status', {
-            runtimeId: runtime.runtimeId,
-            bindingId: binding.bindingId,
-            sessionId: binding.sessionId,
-            machineId: runtime.machineId,
-            status: input.status,
-            reasonCode: input.reasonCode,
-            traceId: input.traceId,
-        }),
-    };
-}
-function bindingPayload(binding) {
-    return {
-        bindingId: binding.bindingId,
-        sessionId: binding.sessionId,
-        conversationName: binding.conversationDisplayName,
-        enabled: binding.enabled,
-        allowReply: binding.allowReply,
-        downloadMedia: binding.downloadMedia,
-    };
-}
-function normalizeServerUrl(url) {
-    return url.replace(/\/+$/, '');
-}
+import{SERVERS as m}from"../../region.js";import{loadConfig as u}from"../../config/index.js";function v(o={}){const t=u(),c=y(o.serverUrl||t.serverUrl||m.cn.url),i=o.machineToken||t.machineToken,l=o.fetchImpl||fetch;if(!i)throw new Error("WeChat channel requires a paired machine token");async function r(n,s){const e=await l(`${c}/api/channels/wechat${n}`,{method:s===void 0?"GET":"POST",headers:{authorization:`Bearer ${i}`,...s===void 0?{}:{"content-type":"application/json"}},body:s===void 0?void 0:JSON.stringify(s)}),d=await e.text(),a=d?JSON.parse(d):null;if(!e.ok||a?.ok===!1){const I=a?.reasonCode||e.statusText||"request_failed";throw new Error(`WeChat channel API ${n} failed: ${I}`)}return a}return{getRuntimePolicy:()=>r("/runtime-policy"),upsertRuntime:(n,s)=>r("/runtime",{runtimeId:n.runtimeId,machineId:n.machineId,pollIntervalSeconds:Math.round(n.policy.pollIntervalMs/1e3),foregroundPolicy:n.foregroundPolicy,clientRuntimeVersion:String(n.policy.runtimeVersion),...s?h(s):{}}),observe:(n,s,e)=>r("/observe",{runtimeId:n.runtimeId,bindingId:s.bindingId,sessionId:s.sessionId,machineId:n.machineId,conversationName:s.conversationDisplayName,schemaVersion:n.policy.runtimeVersion,screenshots:e.screenshots,edgeOcrBlocks:e.edgeOcrBlocks??[],visibleConversationFingerprints:e.visibleConversationFingerprints??[],localLedgerTailAnchors:e.localLedgerTailAnchors??[]}),ingest:(n,s,e)=>r("/ingest",{runtimeId:n.runtimeId,idempotencyKey:e.idempotencyKey,bindingId:s.bindingId,sessionId:s.sessionId,machineId:n.machineId,messages:e.messages}),reportOutboundStatus:(n,s,e)=>r("/outbound-status",{runtimeId:n.runtimeId,replyId:e.replyId,idempotencyKey:e.idempotencyKey,bindingId:s.bindingId,sessionId:s.sessionId,machineId:n.machineId,status:e.status,replyBaseRevision:e.replyBaseRevision,sentAt:e.sentAt,confirmedAt:e.confirmedAt,failureCode:e.failureCode,lastErrorSummary:e.lastErrorSummary}),reportRunStatus:(n,s,e)=>r("/run-status",{runtimeId:n.runtimeId,bindingId:s.bindingId,sessionId:s.sessionId,machineId:n.machineId,status:e.status,reasonCode:e.reasonCode,traceId:e.traceId})}}function h(o){return{bindingId:o.bindingId,sessionId:o.sessionId,conversationName:o.conversationDisplayName,enabled:o.enabled,allowReply:o.allowReply,downloadMedia:o.downloadMedia}}function y(o){return o.replace(/\/+$/,"")}export{v as createWeChatChannelApiClient};

package/dist/src/channels/wechat-channel/cooldown.js

@@ -1,38 +1 @@
-// @arch docs/features/wechat-rpa-productization-plan.md
-// @arch docs/features/wechat-rpa-outbound-ledger.md
-// @test src/__tests__/wechat-channel-cooldown.test.ts
-export const WECHAT_CHANNEL_INTERRUPTION_COOLDOWN_THRESHOLD = 3;
-export const WECHAT_CHANNEL_INTERRUPTION_COOLDOWN_MS = 5 * 60 * 1000;
-export function isWeChatChannelCooldownActive(state, now = new Date()) {
-    if (!state?.cooldownUntil)
-        return false;
-    const until = new Date(state.cooldownUntil).getTime();
-    return Number.isFinite(until) && until > now.getTime();
-}
-export function noteWeChatChannelInterruption(input) {
-    const now = input.now ?? new Date();
-    const previous = input.state ?? { consecutiveInterruptions: 0 };
-    const consecutiveInterruptions = previous.consecutiveInterruptions + 1;
-    const next = {
-        consecutiveInterruptions,
-        cooldownUntil: previous.cooldownUntil ?? null,
-        manualReviewReason: previous.manualReviewReason ?? null,
-    };
-    if (consecutiveInterruptions >= WECHAT_CHANNEL_INTERRUPTION_COOLDOWN_THRESHOLD) {
-        next.cooldownUntil = new Date(now.getTime() + WECHAT_CHANNEL_INTERRUPTION_COOLDOWN_MS).toISOString();
-        next.manualReviewReason = input.reason || 'user_interruption_cooldown';
-    }
-    return next;
-}
-export function noteWeChatChannelStableRun(state) {
-    return {
-        consecutiveInterruptions: 0,
-        cooldownUntil: state?.cooldownUntil ?? null,
-        manualReviewReason: state?.manualReviewReason ?? null,
-    };
-}
-export function clearExpiredWeChatChannelCooldown(state, now = new Date()) {
-    if (isWeChatChannelCooldownActive(state, now))
-        return state;
-    return { ...state, cooldownUntil: null };
-}
+const r=3,u=3e5;function i(n,o=new Date){if(!n?.cooldownUntil)return!1;const e=new Date(n.cooldownUntil).getTime();return Number.isFinite(e)&&e>o.getTime()}function c(n){const o=n.now??new Date,e=n.state??{consecutiveInterruptions:0},l=e.consecutiveInterruptions+1,t={consecutiveInterruptions:l,cooldownUntil:e.cooldownUntil??null,manualReviewReason:e.manualReviewReason??null};return l>=3&&(t.cooldownUntil=new Date(o.getTime()+3e5).toISOString(),t.manualReviewReason=n.reason||"user_interruption_cooldown"),t}function a(n){return{consecutiveInterruptions:0,cooldownUntil:n?.cooldownUntil??null,manualReviewReason:n?.manualReviewReason??null}}function s(n,o=new Date){return i(n,o)?n:{...n,cooldownUntil:null}}export{u as WECHAT_CHANNEL_INTERRUPTION_COOLDOWN_MS,r as WECHAT_CHANNEL_INTERRUPTION_COOLDOWN_THRESHOLD,s as clearExpiredWeChatChannelCooldown,i as isWeChatChannelCooldownActive,c as noteWeChatChannelInterruption,a as noteWeChatChannelStableRun};