shennian 0.2.88 → 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.d.ts

@@ -0,0 +1,10 @@
+import type { WeChatChannelObservedMessage } from './client.js';
+export declare function normalizeWeChatAnchorText(value: unknown): string;
+export declare function weChatAnchorText(message: WeChatChannelObservedMessage): string;
+export declare function weChatTextSimilarity(left: unknown, right: unknown): number;
+export declare function isLikelySameWeChatMessage(previous: WeChatChannelObservedMessage, current: WeChatChannelObservedMessage, threshold?: number): boolean;
+export declare function filterNewWeChatMessagesByAnchor(input: {
+    previous: WeChatChannelObservedMessage[];
+    current: WeChatChannelObservedMessage[];
+    threshold?: number;
+}): WeChatChannelObservedMessage[];

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

@@ -0,0 +1 @@
+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.d.ts

@@ -0,0 +1,74 @@
+import type { WeChatChannelRuntime, WeChatChannelBindingConfig } from './runtime.js';
+export type WeChatChannelApiClientOptions = {
+    serverUrl?: string;
+    machineToken?: string;
+    fetchImpl?: typeof fetch;
+};
+export type WeChatChannelObservedMessage = {
+    stableMessageKey: string;
+    senderRole: 'self' | 'contact' | 'system' | 'unknown';
+    senderName?: string | null;
+    kind: string;
+    normalizedText?: string | null;
+    anchorText?: string | null;
+    anchorMetadata?: unknown;
+    neighborContext?: unknown;
+    textExcerpt?: string | null;
+    bbox?: unknown;
+    mediaMetadata?: unknown;
+    isBaseline?: boolean;
+    deliveryStatus?: string;
+    observedAt?: string;
+    visualBlocks?: Array<{
+        blockId: string;
+        blockKind: string;
+        bbox?: unknown;
+        model: string;
+        dims: number;
+        vectorBase64: string;
+    }>;
+};
+export type WeChatChannelApiClient = ReturnType<typeof createWeChatChannelApiClient>;
+export type WeChatChannelObserveInput = {
+    screenshots: Array<{
+        captureIndex?: number;
+        mimeType: string;
+        dataBase64: string;
+        width: number;
+        height: number;
+    }>;
+    edgeOcrBlocks?: unknown[];
+    visibleConversationFingerprints?: unknown[];
+    localLedgerTailAnchors?: unknown[];
+};
+export type WeChatChannelObserveResponse = {
+    ok: true;
+    observedMessages?: WeChatChannelObservedMessage[];
+    diff?: unknown;
+    reasonCode?: string;
+};
+export type WeChatChannelOutboundStatusInput = {
+    replyId: string;
+    idempotencyKey: string;
+    status: string;
+    replyBaseRevision?: number;
+    sentAt?: string;
+    confirmedAt?: string;
+    failureCode?: string;
+    lastErrorSummary?: string;
+};
+export declare function createWeChatChannelApiClient(options?: WeChatChannelApiClientOptions): {
+    getRuntimePolicy: () => Promise<unknown>;
+    upsertRuntime: (runtime: WeChatChannelRuntime, binding?: WeChatChannelBindingConfig) => Promise<unknown>;
+    observe: (runtime: WeChatChannelRuntime, binding: WeChatChannelBindingConfig, input: WeChatChannelObserveInput) => Promise<WeChatChannelObserveResponse>;
+    ingest: (runtime: WeChatChannelRuntime, binding: WeChatChannelBindingConfig, input: {
+        idempotencyKey: string;
+        messages: WeChatChannelObservedMessage[];
+    }) => Promise<unknown>;
+    reportOutboundStatus: (runtime: WeChatChannelRuntime, binding: WeChatChannelBindingConfig, input: WeChatChannelOutboundStatusInput) => Promise<unknown>;
+    reportRunStatus: (runtime: WeChatChannelRuntime, binding: WeChatChannelBindingConfig, input: {
+        status: string;
+        reasonCode?: string;
+        traceId?: string;
+    }) => Promise<unknown>;
+};

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

@@ -0,0 +1 @@
+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.d.ts

@@ -0,0 +1,15 @@
+export type WeChatChannelCooldownState = {
+    consecutiveInterruptions: number;
+    cooldownUntil?: string | null;
+    manualReviewReason?: string | null;
+};
+export declare const WECHAT_CHANNEL_INTERRUPTION_COOLDOWN_THRESHOLD = 3;
+export declare const WECHAT_CHANNEL_INTERRUPTION_COOLDOWN_MS: number;
+export declare function isWeChatChannelCooldownActive(state: WeChatChannelCooldownState | undefined, now?: Date): boolean;
+export declare function noteWeChatChannelInterruption(input: {
+    state?: WeChatChannelCooldownState;
+    reason?: string;
+    now?: Date;
+}): WeChatChannelCooldownState;
+export declare function noteWeChatChannelStableRun(state?: WeChatChannelCooldownState): WeChatChannelCooldownState;
+export declare function clearExpiredWeChatChannelCooldown(state: WeChatChannelCooldownState, now?: Date): WeChatChannelCooldownState;

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

@@ -0,0 +1 @@
+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};

package/dist/src/channels/wechat-channel/fingerprint.d.ts

@@ -0,0 +1,28 @@
+export type WeChatConversationListFingerprint = {
+    conversationId?: string | null;
+    title?: string | null;
+    preview?: string | null;
+    timeText?: string | null;
+    unreadText?: string | null;
+    fingerprint?: string | null;
+    bbox?: unknown;
+};
+export type WeChatConversationFingerprintTarget = {
+    bindingId: string;
+    conversationDisplayName: string;
+    lastConversationFingerprint?: string | null;
+    lastPreview?: string | null;
+};
+export type WeChatConversationFingerprintMatch = {
+    bindingId: string;
+    item: WeChatConversationListFingerprint;
+    score: number;
+    reason: 'fingerprint' | 'title-preview' | 'title' | 'none';
+};
+export declare function buildWeChatConversationFingerprint(input: WeChatConversationListFingerprint): string;
+export declare function matchWeChatConversationFingerprints(input: {
+    visibleItems: WeChatConversationListFingerprint[];
+    targets: WeChatConversationFingerprintTarget[];
+    minScore?: number;
+}): WeChatConversationFingerprintMatch[];
+export declare function scoreConversationFingerprint(target: WeChatConversationFingerprintTarget, item: WeChatConversationListFingerprint): WeChatConversationFingerprintMatch;

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

@@ -0,0 +1 @@
+function a(n){return[n.title,n.preview,n.timeText,n.unreadText].map(r=>l(r)).filter(Boolean).join("|")}function p(n){const r=n.minScore??.72,t=n.visibleItems.map(o=>({...o,fingerprint:o.fingerprint||a(o)})),i=[];for(const o of n.targets){let e=null;for(const s of t){const c=d(o,s);(!e||c.score>e.score)&&(e=c)}if(e&&e.score>=r&&e.reason!=="none"){i.push(e);const s=t.findIndex(c=>c===e.item);s>=0&&t.splice(s,1)}}return i}function d(n,r){const t=r.fingerprint||a(r);if(n.lastConversationFingerprint&&t&&n.lastConversationFingerprint===t)return{bindingId:n.bindingId,item:r,score:1,reason:"fingerprint"};const i=f(n.conversationDisplayName,r.title),o=n.lastPreview?f(n.lastPreview,r.preview):0;return i>=.8&&o>=.55?{bindingId:n.bindingId,item:r,score:i*.7+o*.3,reason:"title-preview"}:i>=.88?{bindingId:n.bindingId,item:r,score:i*.86,reason:"title"}:{bindingId:n.bindingId,item:r,score:i*.5+o*.2,reason:"none"}}function l(n){return typeof n=="string"?n.trim().replace(/\s+/g," ").toLowerCase():""}function f(n,r){const t=l(n),i=l(r);return!t||!i?0:t===i?1:1-g(t,i)/Math.max(t.length,i.length)}function g(n,r){const t=Array.from({length:r.length+1},(o,e)=>e),i=Array.from({length:r.length+1},()=>0);for(let o=1;o<=n.length;o+=1){i[0]=o;for(let e=1;e<=r.length;e+=1)i[e]=Math.min(t[e]+1,i[e-1]+1,t[e-1]+(n[o-1]===r[e-1]?0:1));for(let e=0;e<=r.length;e+=1)t[e]=i[e]}return t[r.length]}export{a as buildWeChatConversationFingerprint,p as matchWeChatConversationFingerprints,d as scoreConversationFingerprint};

package/dist/src/channels/wechat-channel/helper-assets.d.ts

@@ -0,0 +1,37 @@
+export declare const WECHAT_CHANNEL_HELPER_VERSION = "0.1.1";
+export type WeChatChannelHelperAssetManifest = {
+    schemaVersion: 1;
+    helperVersion: string;
+    protocolVersion: number;
+    platforms: Record<string, {
+        executable: string;
+        sha256: string | null;
+        signed: boolean;
+        notarized: boolean;
+        signing?: {
+            authority?: string | null;
+            teamIdentifier?: string | null;
+            hardenedRuntime?: boolean;
+        };
+        notarization?: {
+            status?: string;
+            id?: string;
+        };
+    }>;
+};
+export type WeChatChannelHelperAssetResolution = {
+    ok: true;
+    helperPath: string;
+    version: string;
+    manifest: WeChatChannelHelperAssetManifest;
+    warning?: string;
+} | {
+    ok: false;
+    reasonCode: 'unsupported_platform' | 'manifest_missing' | 'helper_missing' | 'integrity_mismatch';
+    message: string;
+};
+export declare function resolveWeChatChannelHelperAsset(input?: {
+    platform?: NodeJS.Platform | string;
+    baseDir?: string;
+    verifyIntegrity?: boolean;
+}): WeChatChannelHelperAssetResolution;

package/dist/src/channels/wechat-channel/helper-assets.js

@@ -0,0 +1 @@
+import o from"node:fs";import a from"node:path";import f from"node:crypto";import{fileURLToPath as m}from"node:url";const _="0.1.1",c=a.dirname(m(import.meta.url));function v(s={}){if((s.platform??process.platform)!=="darwin")return{ok:!1,reasonCode:"unsupported_platform",message:"WeChat channel helper is only available on macOS in the first version"};const i=s.baseDir??h(),l=a.join(i,"manifest.json"),n=p(l);if(!n)return{ok:!1,reasonCode:"manifest_missing",message:`WeChat channel helper manifest is missing: ${l}`};const e=n.platforms.darwin,r=e?a.join(i,e.executable):"";return!e||!r||!o.existsSync(r)?{ok:!1,reasonCode:"helper_missing",message:`WeChat channel helper executable is missing: ${r||i}`}:s.verifyIntegrity!==!1&&e.sha256&&f.createHash("sha256").update(o.readFileSync(r)).digest("hex")!==e.sha256?{ok:!1,reasonCode:"integrity_mismatch",message:`WeChat channel helper integrity mismatch: ${r}`}:{ok:!0,helperPath:r,version:n.helperVersion,manifest:n,warning:e.signed&&e.notarized?void 0:"helper_not_signed_or_notarized"}}function h(){return a.resolve(c,"../../../assets/wechat-channel/macos")}function p(s){try{const t=JSON.parse(o.readFileSync(s,"utf8"));return t.schemaVersion!==1||typeof t.helperVersion!="string"||!t.platforms?.darwin?null:t}catch{return null}}export{_ as WECHAT_CHANNEL_HELPER_VERSION,v as resolveWeChatChannelHelperAsset};

package/dist/src/channels/wechat-channel/helper-client.d.ts

@@ -0,0 +1,25 @@
+import { type WeChatChannelHelperCommandName, type WeChatChannelHelperHealthResult, type WeChatChannelHelperReady, type WeChatChannelHelperResponse, type WeChatChannelHelperWarmupSnapshot } from './helper-protocol.js';
+export type WeChatChannelHelperClientOptions = {
+    helperPath: string;
+    expectedHelperVersion: string;
+    args?: string[];
+    cwd?: string;
+};
+export declare class WeChatChannelHelperClient {
+    private options;
+    private child;
+    private lines;
+    private readyState;
+    private warmupState;
+    private pending;
+    constructor(options: WeChatChannelHelperClientOptions);
+    start(): Promise<WeChatChannelHelperReady>;
+    request<T = unknown>(command: WeChatChannelHelperCommandName, params?: Record<string, unknown>, traceId?: string): Promise<WeChatChannelHelperResponse<T>>;
+    healthCheck(traceId?: string): Promise<WeChatChannelHelperResponse<WeChatChannelHelperHealthResult>>;
+    getReadyState(): WeChatChannelHelperReady | null;
+    getWarmupState(): WeChatChannelHelperWarmupSnapshot | null;
+    stop(): Promise<void>;
+    private handleLine;
+    private captureWarmupSnapshot;
+    private rejectAllPending;
+}

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

@@ -0,0 +1,3 @@
+import{spawn as c}from"node:child_process";import{randomUUID as d}from"node:crypto";import{createInterface as u}from"node:readline";import{createWeChatChannelHelperHello as m,extractWeChatChannelHelperWarmupSnapshot as f,timeoutForWeChatChannelHelperCommand as y,validateWeChatChannelHelperReady as S}from"./helper-protocol.js";class k{options;child=null;lines=null;readyState=null;warmupState=null;pending=new Map;constructor(e){this.options=e}async start(){if(this.child)throw new Error("WeChat channel helper is already started");const e=c(this.options.helperPath,this.options.args??[],{cwd:this.options.cwd,stdio:["pipe","pipe","pipe"]});this.child=e,this.lines=u({input:e.stdout}),this.lines.on("line",r=>this.handleLine(r)),e.once("exit",()=>this.rejectAllPending(new Error("WeChat channel helper process exited")));const t=new Promise((r,s)=>{const l=setTimeout(()=>s(new Error("WeChat channel helper handshake timed out")),2e3),o=h=>{let n;try{n=JSON.parse(h)}catch{clearTimeout(l),this.lines?.off("line",o),s(new Error("WeChat channel helper sent invalid handshake JSON"));return}if(!w(n))return;clearTimeout(l),this.lines?.off("line",o);const a=S(n,this.options.expectedHelperVersion);a.ok?(this.readyState=n,this.captureWarmupSnapshot(n),r(n)):s(new Error(`${a.errorCode}: ${a.errorSummary}`))};this.lines?.on("line",o)});return e.stdin.write(`${JSON.stringify(m(this.options.expectedHelperVersion))}
+`),t}async request(e,t,r){if(!this.child)throw new Error("WeChat channel helper is not started");const s=d(),l=y(e),o=new Promise((n,a)=>{const p=setTimeout(()=>{this.pending.delete(s),a(new Error(`helper_command_timeout: ${e}`))},l);this.pending.set(s,{resolve:n,reject:a,timer:p})});this.child.stdin.write(`${JSON.stringify({id:s,command:e,params:t,traceId:r})}
+`);const h=await o;return this.captureWarmupSnapshot(h),this.captureWarmupSnapshot(h.result),h}async healthCheck(e){return this.request("health.check",{},e)}getReadyState(){return this.readyState?{...this.readyState,capabilities:[...this.readyState.capabilities]}:null}getWarmupState(){return this.warmupState?{warmState:this.warmupState.warmState,metrics:this.warmupState.metrics?{...this.warmupState.metrics}:void 0}:null}async stop(){const e=this.child;this.child=null,this.readyState=null,this.lines?.close(),this.lines=null,this.rejectAllPending(new Error("WeChat channel helper stopped")),!(!e||e.killed)&&e.kill("SIGTERM")}handleLine(e){let t;try{t=JSON.parse(e)}catch{return}if(!g(t))return;const r=this.pending.get(t.id);r&&(clearTimeout(r.timer),this.pending.delete(t.id),r.resolve(t))}captureWarmupSnapshot(e){const t=f(e);t&&(this.warmupState=t)}rejectAllPending(e){for(const[t,r]of this.pending)clearTimeout(r.timer),r.reject(e),this.pending.delete(t)}}function w(i){if(!i||typeof i!="object")return!1;const e=i;return e.type==="ready"&&typeof e.helperVersion=="string"&&typeof e.protocolVersion=="number"&&Array.isArray(e.capabilities)&&typeof e.pid=="number"}function g(i){if(!i||typeof i!="object")return!1;const e=i;return typeof e.id=="string"&&typeof e.ok=="boolean"&&typeof e.latencyMs=="number"}export{k as WeChatChannelHelperClient};