shennian 0.2.89 → 0.2.90

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

@@ -1,84 +1 @@
-// @arch docs/features/wechat-rpa-productization-plan.md
-// @test src/__tests__/wechat-channel-runner.test.ts
-import path from 'node:path';
-import { createWeChatChannelApiClient, } from './client.js';
-import { WeChatChannelHelperClient } from './helper-client.js';
-import { resolveWeChatChannelHelperAsset, WECHAT_CHANNEL_HELPER_VERSION } from './helper-assets.js';
-import { observeWeChatChannelBindingViaHelper } from './observer.js';
-import { WeChatChannelScheduler } from './scheduler.js';
-import { loadWeChatChannelLedger } from './ledger.js';
-export class WeChatChannelProductRunner {
-    options;
-    scheduler;
-    helper;
-    helperStarted = false;
-    constructor(options) {
-        this.options = options;
-        const api = options.api ?? createWeChatChannelApiClient();
-        this.helper = options.helper ?? createHelperClient(options.helperClientOptions);
-        this.scheduler = new WeChatChannelScheduler({
-            runtime: options.runtime,
-            workDir: options.workDir,
-            api,
-            ledgerPath: options.ledgerPath,
-            outboundLedgerPath: options.outboundLedgerPath,
-            onInboundMessages: options.onInboundMessages,
-            observeBinding: (binding) => observeWeChatChannelBindingViaHelper({
-                runtime: options.runtime,
-                binding,
-                helper: this.helper,
-                api,
-                localLedgerTailAnchors: buildLocalLedgerTailAnchors(options.ledgerPath ?? defaultLedgerPath(options.workDir, options.runtime.runtimeId), options.runtime.runtimeId, binding.bindingId),
-            }),
-        });
-    }
-    async start() {
-        await this.ensureHelperStarted();
-        await this.scheduler.start();
-    }
-    async tick() {
-        await this.ensureHelperStarted();
-        return this.scheduler.tick();
-    }
-    async stop() {
-        this.scheduler.stop();
-        if (this.helperStarted && this.helper.stop)
-            await this.helper.stop();
-        this.helperStarted = false;
-    }
-    async ensureHelperStarted() {
-        if (this.helperStarted)
-            return;
-        if (this.helper.start)
-            await this.helper.start();
-        this.helperStarted = true;
-    }
-}
-export function createWeChatChannelProductRunner(options) {
-    return new WeChatChannelProductRunner(options);
-}
-export function buildLocalLedgerTailAnchors(ledgerPath, runtimeId, bindingId, limit = 3) {
-    const ledger = loadWeChatChannelLedger(ledgerPath, runtimeId);
-    const recent = ledger.bindings[bindingId]?.recent ?? [];
-    return recent.slice(-limit).map((message) => ({
-        stableMessageKey: message.stableMessageKey,
-        senderRole: message.senderRole,
-        kind: message.kind,
-        anchorText: message.anchorText ?? message.normalizedText ?? message.textExcerpt ?? null,
-        anchorMetadata: message.anchorMetadata ?? null,
-    }));
-}
-function createHelperClient(options) {
-    if (options)
-        return new WeChatChannelHelperClient(options);
-    const resolved = resolveWeChatChannelHelperAsset();
-    if (!resolved.ok)
-        throw new Error(`${resolved.reasonCode}: ${resolved.message}`);
-    return new WeChatChannelHelperClient({
-        helperPath: resolved.helperPath,
-        expectedHelperVersion: resolved.version || WECHAT_CHANNEL_HELPER_VERSION,
-    });
-}
-function defaultLedgerPath(workDir, runtimeId) {
-    return path.join(workDir, 'wechat-channel', `${runtimeId}.ledger.json`);
-}
+import i from"node:path";import{createWeChatChannelApiClient as o}from"./client.js";import{WeChatChannelHelperClient as h}from"./helper-client.js";import{resolveWeChatChannelHelperAsset as s,WECHAT_CHANNEL_HELPER_VERSION as d}from"./helper-assets.js";import{ensureHelperPreflight as u,focusWeChatWindow as c,observeWeChatChannelBindingViaHelper as p,openConversationInVisibleList as C}from"./observer.js";import{WeChatChannelScheduler as w}from"./scheduler.js";import{loadWeChatChannelLedger as f}from"./ledger.js";import{WeChatChannelOutboundSender as m}from"./outbound-sender.js";class b{options;scheduler;helper;helperStarted=!1;constructor(e){this.options=e;const a=e.api??o();this.helper=e.helper??H(e.helperClientOptions),this.scheduler=new w({runtime:e.runtime,workDir:e.workDir,api:a,ledgerPath:e.ledgerPath,outboundLedgerPath:e.outboundLedgerPath,onInboundMessages:e.onInboundMessages,outboundSender:new m({helper:this.helper,openConversation:async t=>{await u(this.helper);const l=await c(this.helper);return C({helper:this.helper,window:l,binding:{bindingId:`outbound:${t}`,sessionId:"outbound",conversationDisplayName:t,enabled:!0,allowReply:!0,downloadMedia:!0}})}}),observeBinding:t=>p({runtime:e.runtime,binding:t,helper:this.helper,api:a,localLedgerTailAnchors:g(e.ledgerPath??P(e.workDir,e.runtime.runtimeId),e.runtime.runtimeId,t.bindingId)})})}async start(){await this.ensureHelperStarted(),await this.scheduler.start()}async tick(){return await this.ensureHelperStarted(),this.scheduler.tick()}async stop(){this.scheduler.stop(),this.helperStarted&&this.helper.stop&&await this.helper.stop(),this.helperStarted=!1}async ensureHelperStarted(){this.helperStarted||(this.helper.start&&await this.helper.start(),this.helperStarted=!0)}}function M(r){return new b(r)}function g(r,e,a,t=3){return(f(r,e).bindings[a]?.recent??[]).slice(-t).map(n=>({stableMessageKey:n.stableMessageKey,senderRole:n.senderRole,kind:n.kind,anchorText:n.anchorText??n.normalizedText??n.textExcerpt??null,anchorMetadata:n.anchorMetadata??null}))}function H(r){if(r)return new h(r);const e=s();if(!e.ok)throw new Error(`${e.reasonCode}: ${e.message}`);return new h({helperPath:e.helperPath,expectedHelperVersion:e.version||d})}function P(r,e){return i.join(r,"wechat-channel",`${e}.ledger.json`)}export{b as WeChatChannelProductRunner,g as buildLocalLedgerTailAnchors,M as createWeChatChannelProductRunner};

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

@@ -1,66 +1 @@
-// @arch docs/features/wechat-rpa-productization-plan.md
-// @arch docs/features/wechat-rpa-helper-runtime.md
-// @test src/__tests__/wechat-channel-runtime.test.ts
-export const WECHAT_CHANNEL_RUNTIME_KIND = 'wechat_channel';
-export const WECHAT_CHANNEL_RUNTIME_VERSION = 1;
-export const WECHAT_CHANNEL_RECENT_MESSAGE_WINDOW = 20;
-export const WECHAT_CHANNEL_DEFAULT_POLL_INTERVAL_MS = 5 * 60 * 1000;
-export const WECHAT_CHANNEL_MIN_POLL_INTERVAL_MS = 60 * 1000;
-export const WECHAT_CHANNEL_MAX_POLL_INTERVAL_MS = 10 * 60 * 1000;
-export function defaultWeChatChannelRuntimePolicy(pollIntervalMs) {
-    return {
-        kind: WECHAT_CHANNEL_RUNTIME_KIND,
-        runtimeVersion: WECHAT_CHANNEL_RUNTIME_VERSION,
-        platform: 'darwin',
-        pollIntervalMs: normalizeWeChatChannelPollIntervalMs(pollIntervalMs),
-        minPollIntervalMs: WECHAT_CHANNEL_MIN_POLL_INTERVAL_MS,
-        maxPollIntervalMs: WECHAT_CHANNEL_MAX_POLL_INTERVAL_MS,
-        recentMessageWindow: WECHAT_CHANNEL_RECENT_MESSAGE_WINDOW,
-        requiresServerDecision: true,
-        requiresMacHelper: true,
-        productRuntimeUsesLabFacade: false,
-    };
-}
-export function normalizeWeChatChannelPollIntervalMs(value) {
-    if (!Number.isFinite(value))
-        return WECHAT_CHANNEL_DEFAULT_POLL_INTERVAL_MS;
-    return Math.min(WECHAT_CHANNEL_MAX_POLL_INTERVAL_MS, Math.max(WECHAT_CHANNEL_MIN_POLL_INTERVAL_MS, Number(value)));
-}
-export function createWeChatChannelRuntime(config) {
-    const runtimeId = normalizeRequiredString(config.runtimeId, 'runtimeId');
-    const machineId = normalizeRequiredString(config.machineId, 'machineId');
-    const pollIntervalMs = normalizeWeChatChannelPollIntervalMs(config.pollIntervalMs);
-    return {
-        kind: WECHAT_CHANNEL_RUNTIME_KIND,
-        runtimeId,
-        machineId,
-        foregroundPolicy: config.foregroundPolicy === 'work' ? 'work' : 'polite',
-        policy: defaultWeChatChannelRuntimePolicy(pollIntervalMs),
-        bindings: normalizeBindings(config.bindings ?? []),
-    };
-}
-function normalizeBindings(bindings) {
-    const seen = new Set();
-    const result = [];
-    for (const binding of bindings) {
-        const bindingId = normalizeRequiredString(binding.bindingId, 'bindingId');
-        if (seen.has(bindingId))
-            continue;
-        seen.add(bindingId);
-        result.push({
-            bindingId,
-            sessionId: normalizeRequiredString(binding.sessionId, 'sessionId'),
-            conversationDisplayName: normalizeRequiredString(binding.conversationDisplayName, 'conversationDisplayName'),
-            enabled: binding.enabled !== false,
-            allowReply: binding.allowReply !== false,
-            downloadMedia: binding.downloadMedia !== false,
-        });
-    }
-    return result;
-}
-function normalizeRequiredString(value, field) {
-    const normalized = String(value || '').trim();
-    if (!normalized)
-        throw new Error(`WeChat channel ${field} is required`);
-    return normalized;
-}
+const a="wechat_channel",N=1,E=20,d=3e5,A=6e4,L=6e5;function s(e){return{kind:a,runtimeVersion:1,platform:"darwin",pollIntervalMs:_(e),minPollIntervalMs:6e4,maxPollIntervalMs:6e5,recentMessageWindow:20,requiresServerDecision:!0,requiresMacHelper:!0,productRuntimeUsesLabFacade:!1}}function _(e){return Number.isFinite(e)?Math.min(6e5,Math.max(6e4,Number(e))):3e5}function I(e){const t=o(e.runtimeId,"runtimeId"),r=o(e.machineId,"machineId"),n=_(e.pollIntervalMs);return{kind:a,runtimeId:t,machineId:r,foregroundPolicy:e.foregroundPolicy==="work"?"work":"polite",policy:s(n),bindings:l(e.bindings??[])}}function l(e){const t=new Set,r=[];for(const n of e){const i=o(n.bindingId,"bindingId");t.has(i)||(t.add(i),r.push({bindingId:i,sessionId:o(n.sessionId,"sessionId"),conversationDisplayName:o(n.conversationDisplayName,"conversationDisplayName"),enabled:n.enabled!==!1,allowReply:n.allowReply!==!1,downloadMedia:n.downloadMedia!==!1}))}return r}function o(e,t){const r=String(e||"").trim();if(!r)throw new Error(`WeChat channel ${t} is required`);return r}export{d as WECHAT_CHANNEL_DEFAULT_POLL_INTERVAL_MS,L as WECHAT_CHANNEL_MAX_POLL_INTERVAL_MS,A as WECHAT_CHANNEL_MIN_POLL_INTERVAL_MS,E as WECHAT_CHANNEL_RECENT_MESSAGE_WINDOW,a as WECHAT_CHANNEL_RUNTIME_KIND,N as WECHAT_CHANNEL_RUNTIME_VERSION,I as createWeChatChannelRuntime,s as defaultWeChatChannelRuntimePolicy,_ as normalizeWeChatChannelPollIntervalMs};

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

@@ -1,11 +1,13 @@
 import type { WeChatChannelRuntime, WeChatChannelBindingConfig } from './runtime.js';
 import type { WeChatChannelApiClient, WeChatChannelObservedMessage } from './client.js';
+import { type WeChatChannelOutboundSender } from './outbound-sender.js';
 export type WeChatChannelSchedulerOptions = {
     runtime: WeChatChannelRuntime;
     workDir: string;
     api: Pick<WeChatChannelApiClient, 'upsertRuntime' | 'ingest' | 'reportRunStatus'> & Partial<Pick<WeChatChannelApiClient, 'reportOutboundStatus'>>;
     observeBinding: (binding: WeChatChannelBindingConfig) => Promise<WeChatChannelObservedMessage[]>;
     onInboundMessages?: (binding: WeChatChannelBindingConfig, messages: WeChatChannelObservedMessage[]) => Promise<void> | void;
+    outboundSender?: WeChatChannelOutboundSender;
     ledgerPath?: string;
     outboundLedgerPath?: string;
 };
@@ -13,6 +15,9 @@ export type WeChatChannelSchedulerTickResult = {
     bindingId: string;
     observedCount: number;
     newInboundCount: number;
+    outboundSentCount: number;
+    staleOutboundCount: number;
+    failedOutboundCount: number;
     confirmedEchoCount: number;
     manualReviewCount: number;
     revision: number;

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

@@ -1,152 +1 @@
-// @arch docs/features/wechat-rpa-productization-plan.md
-// @test src/__tests__/wechat-channel-scheduler.test.ts
-import path from 'node:path';
-import { loadWeChatChannelLedger, markWeChatChannelBindingDisabled, saveWeChatChannelLedger, updateWeChatChannelBindingLedger, } from './ledger.js';
-import { classifyWeChatOutboundEchoes, loadWeChatChannelOutboundLedger, saveWeChatChannelOutboundLedger, } from './outbound-ledger.js';
-import { clearExpiredWeChatChannelCooldown, isWeChatChannelCooldownActive, noteWeChatChannelInterruption, noteWeChatChannelStableRun, } from './cooldown.js';
-export class WeChatChannelScheduler {
-    options;
-    timer = null;
-    running = false;
-    constructor(options) {
-        this.options = options;
-    }
-    async start() {
-        if (this.timer)
-            return;
-        await this.tick();
-        this.timer = setInterval(() => {
-            void this.tick().catch(() => { });
-        }, this.options.runtime.policy.pollIntervalMs);
-        this.timer.unref();
-    }
-    stop() {
-        if (!this.timer)
-            return;
-        clearInterval(this.timer);
-        this.timer = null;
-    }
-    async tick() {
-        if (this.running)
-            return;
-        this.running = true;
-        try {
-            const ledgerPath = this.options.ledgerPath || defaultLedgerPath(this.options.workDir, this.options.runtime.runtimeId);
-            const outboundLedgerPath = this.options.outboundLedgerPath || defaultOutboundLedgerPath(this.options.workDir, this.options.runtime.runtimeId);
-            const ledger = loadWeChatChannelLedger(ledgerPath, this.options.runtime.runtimeId);
-            const outboundLedger = loadWeChatChannelOutboundLedger(outboundLedgerPath, this.options.runtime.runtimeId);
-            const results = [];
-            for (const binding of this.options.runtime.bindings.filter((item) => !item.enabled)) {
-                if (!ledger.bindings[binding.bindingId]?.disabledSince) {
-                    markWeChatChannelBindingDisabled({ ledger, bindingId: binding.bindingId });
-                }
-            }
-            for (const binding of this.options.runtime.bindings.filter((item) => item.enabled)) {
-                await this.options.api.upsertRuntime(this.options.runtime, binding);
-                const existingBinding = ledger.bindings[binding.bindingId];
-                if (existingBinding?.cooldown) {
-                    existingBinding.cooldown = clearExpiredWeChatChannelCooldown(existingBinding.cooldown);
-                    if (isWeChatChannelCooldownActive(existingBinding.cooldown)) {
-                        await this.options.api.reportRunStatus(this.options.runtime, binding, {
-                            status: 'cooldown',
-                            reasonCode: existingBinding.cooldown.manualReviewReason || 'user_interruption_cooldown',
-                        });
-                        results.push({
-                            bindingId: binding.bindingId,
-                            observedCount: 0,
-                            newInboundCount: 0,
-                            confirmedEchoCount: 0,
-                            manualReviewCount: 0,
-                            revision: existingBinding.revision,
-                        });
-                        continue;
-                    }
-                }
-                const observedMessages = await this.options.observeBinding(binding);
-                const echoes = classifyWeChatOutboundEchoes({
-                    ledger: outboundLedger,
-                    bindingId: binding.bindingId,
-                    messages: observedMessages,
-                });
-                const state = updateWeChatChannelBindingLedger({
-                    ledger,
-                    bindingId: binding.bindingId,
-                    observedMessages,
-                });
-                state.binding.cooldown = noteWeChatChannelStableRun(state.binding.cooldown);
-                await this.options.api.ingest(this.options.runtime, binding, {
-                    idempotencyKey: `${binding.bindingId}:${state.binding.revision}:${lastMessageKey(state.binding.recent)}`,
-                    messages: state.binding.recent,
-                });
-                if (state.newMessages.length > 0)
-                    await this.options.onInboundMessages?.(binding, state.newMessages);
-                await this.reportOutboundProjections(binding, [...echoes.confirmedRecords, ...echoes.manualReviewRecords]);
-                await this.options.api.reportRunStatus(this.options.runtime, binding, {
-                    status: runStatusForTick(state.newMessages.length, echoes.confirmedRecords, echoes.manualReviewRecords),
-                });
-                results.push({
-                    bindingId: binding.bindingId,
-                    observedCount: observedMessages.length,
-                    newInboundCount: state.newMessages.length,
-                    confirmedEchoCount: echoes.confirmedRecords.length,
-                    manualReviewCount: echoes.manualReviewRecords.length,
-                    revision: state.binding.revision,
-                });
-            }
-            saveWeChatChannelLedger(ledgerPath, ledger);
-            saveWeChatChannelOutboundLedger(outboundLedgerPath, outboundLedger);
-            return results;
-        }
-        finally {
-            this.running = false;
-        }
-    }
-    noteInterruption(bindingId, reason, now = new Date()) {
-        const ledgerPath = this.options.ledgerPath || defaultLedgerPath(this.options.workDir, this.options.runtime.runtimeId);
-        const ledger = loadWeChatChannelLedger(ledgerPath, this.options.runtime.runtimeId);
-        const existing = ledger.bindings[bindingId] ?? {
-            bindingId,
-            baselineEstablished: false,
-            revision: 0,
-            recent: [],
-            pendingSendKeys: [],
-        };
-        existing.cooldown = noteWeChatChannelInterruption({ state: existing.cooldown, reason, now });
-        ledger.bindings[bindingId] = existing;
-        saveWeChatChannelLedger(ledgerPath, ledger);
-    }
-    async reportOutboundProjections(binding, records) {
-        if (!this.options.api.reportOutboundStatus)
-            return;
-        for (const record of records) {
-            await this.options.api.reportOutboundStatus(this.options.runtime, binding, {
-                replyId: record.replyId,
-                idempotencyKey: record.idempotencyKey,
-                status: record.sendStatus,
-                replyBaseRevision: record.replyBaseRevision,
-                sentAt: record.sentAt,
-                confirmedAt: record.confirmedAt,
-                failureCode: record.failureCode,
-                lastErrorSummary: record.lastErrorSummary,
-            });
-        }
-    }
-}
-function defaultLedgerPath(workDir, runtimeId) {
-    return path.join(workDir, 'wechat-channel', `${runtimeId}.ledger.json`);
-}
-function defaultOutboundLedgerPath(workDir, runtimeId) {
-    return path.join(workDir, 'wechat-channel', `${runtimeId}.outbound-ledger.json`);
-}
-function lastMessageKey(messages) {
-    return messages.at(-1)?.stableMessageKey || 'empty';
-}
-function runStatusForTick(newMessageCount, confirmedRecords, manualReviewRecords) {
-    if (manualReviewRecords.length > 0)
-        return 'manual_review';
-    if (newMessageCount > 0)
-        return 'new_messages_ingested';
-    if (confirmedRecords.length > 0)
-        return 'outbound_echo_confirmed';
-    return 'baseline_or_no_change';
-}
+import c from"node:path";import{loadWeChatChannelLedger as g,markWeChatChannelBindingDisabled as m,saveWeChatChannelLedger as b,updateWeChatChannelBindingLedger as f}from"./ledger.js";import{classifyWeChatOutboundEchoes as w,loadWeChatChannelOutboundLedger as C,saveWeChatChannelOutboundLedger as R}from"./outbound-ledger.js";import{clearExpiredWeChatChannelCooldown as I,isWeChatChannelCooldownActive as v,noteWeChatChannelInterruption as y,noteWeChatChannelStableRun as S}from"./cooldown.js";import{sendQueuedWeChatOutboundRecords as _}from"./outbound-sender.js";class B{options;timer=null;running=!1;constructor(t){this.options=t}async start(){this.timer||(await this.tick(),this.timer=setInterval(()=>{this.tick().catch(()=>{})},this.options.runtime.policy.pollIntervalMs),this.timer.unref())}stop(){this.timer&&(clearInterval(this.timer),this.timer=null)}async tick(){if(!this.running){this.running=!0;try{const t=this.options.ledgerPath||p(this.options.workDir,this.options.runtime.runtimeId),a=this.options.outboundLedgerPath||O(this.options.workDir,this.options.runtime.runtimeId),e=g(t,this.options.runtime.runtimeId),u=C(a,this.options.runtime.runtimeId),s=[];for(const n of this.options.runtime.bindings.filter(o=>!o.enabled))e.bindings[n.bindingId]?.disabledSince||m({ledger:e,bindingId:n.bindingId});for(const n of this.options.runtime.bindings.filter(o=>o.enabled)){await this.options.api.upsertRuntime(this.options.runtime,n);const o=e.bindings[n.bindingId];if(o?.cooldown&&(o.cooldown=I(o.cooldown),v(o.cooldown))){await this.options.api.reportRunStatus(this.options.runtime,n,{status:"cooldown",reasonCode:o.cooldown.manualReviewReason||"user_interruption_cooldown"}),s.push({bindingId:n.bindingId,observedCount:0,newInboundCount:0,outboundSentCount:0,staleOutboundCount:0,failedOutboundCount:0,confirmedEchoCount:0,manualReviewCount:0,revision:o.revision});continue}const h=await this.options.observeBinding(n),l=w({ledger:u,bindingId:n.bindingId,messages:h}),i=f({ledger:e,bindingId:n.bindingId,observedMessages:h}),r=this.options.outboundSender?await _({ledger:u,bindingId:n.bindingId,currentLastInboundRevision:i.binding.revision,sender:this.options.outboundSender}):{sentRecords:[],staleRecords:[],failedRecords:[]};i.binding.cooldown=S(i.binding.cooldown),await this.options.api.ingest(this.options.runtime,n,{idempotencyKey:`${n.bindingId}:${i.binding.revision}:${W(i.binding.recent)}`,messages:i.binding.recent}),i.newMessages.length>0&&await this.options.onInboundMessages?.(n,i.newMessages),await this.reportOutboundProjections(n,[...l.confirmedRecords,...l.manualReviewRecords,...r.sentRecords,...r.staleRecords,...r.failedRecords]),await this.options.api.reportRunStatus(this.options.runtime,n,{status:L(i.newMessages.length,l.confirmedRecords,l.manualReviewRecords,r.sentRecords,r.staleRecords,r.failedRecords)}),s.push({bindingId:n.bindingId,observedCount:h.length,newInboundCount:i.newMessages.length,outboundSentCount:r.sentRecords.length,staleOutboundCount:r.staleRecords.length,failedOutboundCount:r.failedRecords.length,confirmedEchoCount:l.confirmedRecords.length,manualReviewCount:l.manualReviewRecords.length,revision:i.binding.revision})}return b(t,e),R(a,u),s}finally{this.running=!1}}}noteInterruption(t,a,e=new Date){const u=this.options.ledgerPath||p(this.options.workDir,this.options.runtime.runtimeId),s=g(u,this.options.runtime.runtimeId),n=s.bindings[t]??{bindingId:t,baselineEstablished:!1,revision:0,recent:[],pendingSendKeys:[]};n.cooldown=y({state:n.cooldown,reason:a,now:e}),s.bindings[t]=n,b(u,s)}async reportOutboundProjections(t,a){if(this.options.api.reportOutboundStatus)for(const e of a)await this.options.api.reportOutboundStatus(this.options.runtime,t,{replyId:e.replyId,idempotencyKey:e.idempotencyKey,status:e.sendStatus,replyBaseRevision:e.replyBaseRevision,sentAt:e.sentAt,confirmedAt:e.confirmedAt,failureCode:e.failureCode,lastErrorSummary:e.lastErrorSummary})}}function p(d,t){return c.join(d,"wechat-channel",`${t}.ledger.json`)}function O(d,t){return c.join(d,"wechat-channel",`${t}.outbound-ledger.json`)}function W(d){return d.at(-1)?.stableMessageKey||"empty"}function L(d,t,a,e=[],u=[],s=[]){return a.length>0?"manual_review":s.length>0?"outbound_send_failed":u.length>0?"outbound_stale":d>0?"new_messages_ingested":e.length>0?"outbound_sent_unconfirmed":t.length>0?"outbound_echo_confirmed":"baseline_or_no_change"}export{B as WeChatChannelScheduler};

package/dist/src/channels/wechat-rpa/macos-flow.js

@@ -1,96 +1 @@
-// @arch docs/features/wechat-rpa-channel.md
-// @test src/__tests__/wechat-rpa-normalizer.test.ts
-import fs from 'node:fs';
-import path from 'node:path';
-import { execFile } from 'node:child_process';
-import { promisify } from 'node:util';
-const execFileAsync = promisify(execFile);
-export async function runMacWeChatRpaFlow(options) {
-    if (process.platform !== 'darwin') {
-        throw new Error('WeChat RPA macOS flow can only run on macOS');
-    }
-    const scriptPath = resolveFlowScriptPath(options.scriptPath, options.workDir);
-    const args = [
-        scriptPath,
-        '--group',
-        options.groupName,
-        '--idle-seconds',
-        String(Number.isFinite(options.idleSeconds) ? options.idleSeconds : 15),
-    ];
-    if (options.forceForeground)
-        args.push('--force');
-    if (options.noRestore)
-        args.push('--no-restore');
-    if (options.replyText)
-        args.push('--reply-text', options.replyText);
-    if (options.attachmentPath)
-        args.push('--attachment-path', options.attachmentPath);
-    if (options.downloadAttachmentsDir)
-        args.push('--download-attachments-dir', options.downloadAttachmentsDir);
-    if (Number.isFinite(options.recentLimit) && Number(options.recentLimit) > 0) {
-        args.push('--recent-limit', String(options.recentLimit));
-    }
-    let stdout = '';
-    let stderr = '';
-    try {
-        const result = await execFileAsync(process.execPath, args, {
-            cwd: options.workDir || process.cwd(),
-            timeout: options.timeoutMs ?? 120_000,
-            maxBuffer: 20 * 1024 * 1024,
-        });
-        stdout = result.stdout;
-        stderr = result.stderr;
-    }
-    catch (error) {
-        const execError = error;
-        stdout = execError.stdout || '';
-        stderr = execError.stderr || '';
-        const parsed = parseFlowStdout(stdout);
-        if (parsed?.interrupted)
-            return parsed;
-        if (parsed && hasPartialSendProgress(parsed))
-            return parsed;
-        throw new Error(stderr.trim() || stdout.slice(0, 1_000) || execError.message || 'WeChat RPA flow failed');
-    }
-    try {
-        const parsed = JSON.parse(stdout);
-        if (parsed.interrupted)
-            return parsed;
-        if (!parsed.ok && hasSendAttempt(parsed))
-            return parsed;
-        if (!parsed.ok)
-            throw new Error(parsed.error || 'WeChat RPA flow failed');
-        return parsed;
-    }
-    catch (error) {
-        const detail = stderr.trim() || stdout.slice(0, 1_000);
-        throw new Error(detail || (error instanceof Error ? error.message : String(error)));
-    }
-}
-function parseFlowStdout(stdout) {
-    try {
-        return JSON.parse(stdout);
-    }
-    catch {
-        return null;
-    }
-}
-function hasPartialSendProgress(result) {
-    return Boolean(result.sentReplyObserved || result.sentAttachmentObserved);
-}
-function hasSendAttempt(result) {
-    return Boolean(result.sentReply || result.sentAttachment || result.sentReplyObserved || result.sentAttachmentObserved);
-}
-function resolveFlowScriptPath(scriptPath, workDir) {
-    const candidates = [
-        scriptPath,
-        process.env.SHENNIAN_WECHAT_RPA_FLOW_SCRIPT,
-        workDir ? path.join(workDir, 'scripts/wechat-rpa-flow.mjs') : '',
-        path.resolve(process.cwd(), 'scripts/wechat-rpa-flow.mjs'),
-    ].filter(Boolean);
-    const found = candidates.find((candidate) => fs.existsSync(candidate));
-    if (!found) {
-        throw new Error('WeChat RPA flow script is missing; set SHENNIAN_WECHAT_RPA_FLOW_SCRIPT or channel flowScriptPath');
-    }
-    return path.resolve(found);
-}
+import d from"node:fs";import i from"node:path";import{execFile as h}from"node:child_process";import{promisify as f}from"node:util";const l=f(h);async function R(e){if(process.platform!=="darwin")throw new Error("WeChat RPA macOS flow can only run on macOS");const n=[p(e.scriptPath,e.workDir),"--group",e.groupName,"--idle-seconds",String(Number.isFinite(e.idleSeconds)?e.idleSeconds:15)];e.forceForeground&&n.push("--force"),e.noRestore&&n.push("--no-restore"),e.replyText&&n.push("--reply-text",e.replyText),e.attachmentPath&&n.push("--attachment-path",e.attachmentPath),e.downloadAttachmentsDir&&n.push("--download-attachments-dir",e.downloadAttachmentsDir),Number.isFinite(e.recentLimit)&&Number(e.recentLimit)>0&&n.push("--recent-limit",String(e.recentLimit));let t="",s="";try{const r=await l(process.execPath,n,{cwd:e.workDir||process.cwd(),timeout:e.timeoutMs??12e4,maxBuffer:20971520});t=r.stdout,s=r.stderr}catch(r){const a=r;t=a.stdout||"",s=a.stderr||"";const c=m(t);if(c?.interrupted||c&&u(c))return c;throw new Error(s.trim()||t.slice(0,1e3)||a.message||"WeChat RPA flow failed")}try{const r=JSON.parse(t);if(r.interrupted||!r.ok&&w(r))return r;if(!r.ok)throw new Error(r.error||"WeChat RPA flow failed");return r}catch(r){const a=s.trim()||t.slice(0,1e3);throw new Error(a||(r instanceof Error?r.message:String(r)))}}function m(e){try{return JSON.parse(e)}catch{return null}}function u(e){return!!(e.sentReplyObserved||e.sentAttachmentObserved)}function w(e){return!!(e.sentReply||e.sentAttachment||e.sentReplyObserved||e.sentAttachmentObserved)}function p(e,o){const t=[e,process.env.SHENNIAN_WECHAT_RPA_FLOW_SCRIPT,o?i.join(o,"scripts/wechat-rpa-flow.mjs"):"",i.resolve(process.cwd(),"scripts/wechat-rpa-flow.mjs")].filter(Boolean).find(s=>d.existsSync(s));if(!t)throw new Error("WeChat RPA flow script is missing; set SHENNIAN_WECHAT_RPA_FLOW_SCRIPT or channel flowScriptPath");return i.resolve(t)}export{R as runMacWeChatRpaFlow};

package/dist/src/channels/wechat-rpa/macos.js

@@ -1,9 +1,4 @@
-// @arch docs/features/wechat-rpa-channel.md
-// @test src/__tests__/wechat-rpa-normalizer.test.ts
-import { execFile } from 'node:child_process';
-import { promisify } from 'node:util';
-const execFileAsync = promisify(execFile);
-const WECHAT_PROBE_SCRIPT = `
+import{execFile as r}from"node:child_process";import{promisify as s}from"node:util";const i=s(r),a=`
 tell application "System Events"
   set isRunning to exists process "WeChat"
   if isRunning is false then
@@ -17,47 +12,10 @@ tell application "System Events"
         set titleText to name of window 1
       end try
     end if
-    return (isFront as text) & "\n" & titleText
+    return (isFront as text) & "
+" & titleText
   end tell
 end tell
-`;
-export async function probeMacWeChat() {
-    if (process.platform !== 'darwin') {
-        return { ok: false, platform: process.platform, wechatRunning: false, frontmost: false, message: 'macOS only' };
-    }
-    try {
-        const { stdout } = await execFileAsync('osascript', ['-e', WECHAT_PROBE_SCRIPT], { timeout: 5_000 });
-        const output = stdout.trim();
-        if (output === 'not_running') {
-            return { ok: true, platform: process.platform, wechatRunning: false, frontmost: false };
-        }
-        const [frontmostText, ...titleParts] = output.split('\n');
-        return {
-            ok: true,
-            platform: process.platform,
-            wechatRunning: true,
-            frontmost: frontmostText === 'true',
-            windowTitle: titleParts.join('\n').trim() || undefined,
-        };
-    }
-    catch (err) {
-        return {
-            ok: false,
-            platform: process.platform,
-            wechatRunning: false,
-            frontmost: false,
-            message: err instanceof Error ? err.message : String(err),
-        };
-    }
-}
-export function observedMessageFromProbe(result) {
-    if (!result.ok || !result.wechatRunning || !result.windowTitle)
-        return null;
-    return {
-        conversationName: result.windowTitle,
-        senderName: 'WeChat RPA',
-        text: `[微信窗口可见性探测] WeChat ${result.frontmost ? '位于前台' : '未位于前台'}，当前窗口：${result.windowTitle}`,
-        observedAt: new Date().toISOString(),
-        rawId: `probe:${result.windowTitle}:${result.frontmost}`,
-    };
-}
+`;async function m(){if(process.platform!=="darwin")return{ok:!1,platform:process.platform,wechatRunning:!1,frontmost:!1,message:"macOS only"};try{const{stdout:t}=await i("osascript",["-e",a],{timeout:5e3}),e=t.trim();if(e==="not_running")return{ok:!0,platform:process.platform,wechatRunning:!1,frontmost:!1};const[n,...o]=e.split(`
+`);return{ok:!0,platform:process.platform,wechatRunning:!0,frontmost:n==="true",windowTitle:o.join(`
+`).trim()||void 0}}catch(t){return{ok:!1,platform:process.platform,wechatRunning:!1,frontmost:!1,message:t instanceof Error?t.message:String(t)}}}function c(t){return!t.ok||!t.wechatRunning||!t.windowTitle?null:{conversationName:t.windowTitle,senderName:"WeChat RPA",text:`[\u5FAE\u4FE1\u7A97\u53E3\u53EF\u89C1\u6027\u63A2\u6D4B] WeChat ${t.frontmost?"\u4F4D\u4E8E\u524D\u53F0":"\u672A\u4F4D\u4E8E\u524D\u53F0"}\uFF0C\u5F53\u524D\u7A97\u53E3\uFF1A${t.windowTitle}`,observedAt:new Date().toISOString(),rawId:`probe:${t.windowTitle}:${t.frontmost}`}}export{c as observedMessageFromProbe,m as probeMacWeChat};

package/dist/src/channels/wechat-rpa/normalizer.js

@@ -1,127 +1,7 @@
-// @arch docs/features/wechat-rpa-channel.md
-// @test src/__tests__/wechat-rpa-normalizer.test.ts
-import { createHash } from 'node:crypto';
-const MAX_DEDUP_KEYS = 500;
-export class WeChatRpaDeduper {
-    seen = new Set();
-    queue = [];
-    constructor(initialMessageIds = []) {
-        for (const id of initialMessageIds) {
-            if (!id || this.seen.has(id))
-                continue;
-            this.seen.add(id);
-            this.queue.push(id);
-        }
-        this.trim();
-    }
-    accept(messageId) {
-        if (this.seen.has(messageId))
-            return false;
-        this.seen.add(messageId);
-        this.queue.push(messageId);
-        this.trim();
-        return true;
-    }
-    snapshot() {
-        return [...this.queue];
-    }
-    trim() {
-        while (this.queue.length > MAX_DEDUP_KEYS) {
-            const old = this.queue.shift();
-            if (old)
-                this.seen.delete(old);
-        }
-    }
-}
-export function normalizeWeChatRpaMessage(input, options = {}) {
-    const conversationName = cleanText(input.conversationName);
-    const text = cleanText(input.text);
-    const attachments = normalizeAttachments(input.attachments);
-    if (!conversationName || (!text && attachments.length === 0))
-        return null;
-    const senderName = cleanText(input.senderName || '') || null;
-    const receivedAt = normalizeIso(input.observedAt);
-    const conversationId = weChatRpaConversationId(conversationName);
-    const senderId = stableId('wechat-sender', senderName || 'unknown');
-    const rawRef = cleanText(input.rawId || '') || null;
-    const isMentioned = input.isMentioned === true || isMentionedByText(text, options.selfNicknames);
-    const messageId = rawRef
-        ? stableId('wechat-message', `${conversationName}\n${rawRef}`)
-        : stableId('wechat-message', `${conversationName}\n${senderName || ''}\n${text}\n${attachments.map((item) => item.name || item.url || item.type).join('\n')}\n${receivedAt}`);
-    return {
-        conversationId,
-        conversationName,
-        messageId,
-        sender: { id: senderId, name: senderName },
-        text,
-        attachments,
-        receivedAt,
-        isMentioned,
-        rawRef,
-    };
-}
-export function weChatRpaConversationId(conversationName) {
-    return stableId('wechat-conversation', cleanText(conversationName));
-}
-function cleanText(value) {
-    return value.replace(/\s+/g, ' ').trim();
-}
-function normalizeAttachments(value) {
-    if (!Array.isArray(value))
-        return [];
-    return value
-        .map((item) => {
-        const url = item?.url ? cleanText(item.url) : '';
-        const localPath = item?.localPath ? cleanText(item.localPath) : '';
-        const availability = normalizeAvailability(item?.availability, { url, localPath });
-        return {
-            type: cleanText(String(item?.type || 'file')) || 'file',
-            ...(item?.name ? { name: cleanText(item.name) } : {}),
-            ...(url ? { url } : {}),
-            ...(item?.mimeType ? { mimeType: cleanText(item.mimeType) } : {}),
-            ...(Number.isFinite(item?.size) && Number(item.size) > 0 ? { size: Number(item.size) } : {}),
-            ...(localPath ? { localPath } : {}),
-            ...(item?.thumbnailPath ? { thumbnailPath: cleanText(item.thumbnailPath) } : {}),
-            ...(item?.hash ? { hash: cleanText(item.hash) } : {}),
-            ...(availability ? { availability } : {}),
-            ...(item?.machineId ? { machineId: cleanText(item.machineId) } : {}),
-            ...(item?.expiresAt ? { expiresAt: cleanText(item.expiresAt) } : {}),
-            ...(item?.providerError ? { providerError: cleanText(item.providerError) } : {}),
-        };
-    })
-        .filter((item) => item.type);
-}
-function normalizeAvailability(value, sources) {
-    if (value === 'edge-local'
-        || value === 'server-url'
-        || value === 'pending-download'
-        || value === 'metadata-only'
-        || value === 'unavailable-large') {
-        return value;
-    }
-    if (sources.localPath)
-        return 'edge-local';
-    if (sources.url)
-        return 'server-url';
-    return 'metadata-only';
-}
-function normalizeIso(value) {
-    if (!value)
-        return new Date().toISOString();
-    const date = new Date(value);
-    return Number.isNaN(date.getTime()) ? new Date().toISOString() : date.toISOString();
-}
-function stableId(prefix, value) {
-    return `${prefix}:${createHash('sha256').update(value).digest('hex').slice(0, 24)}`;
-}
-function isMentionedByText(text, selfNicknames) {
-    const aliases = Array.isArray(selfNicknames)
-        ? selfNicknames.map((item) => cleanText(item)).filter(Boolean)
-        : [];
-    if (!aliases.length)
-        return false;
-    return aliases.some((alias) => {
-        const escaped = alias.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
-        return new RegExp(`@\\s*${escaped}(?=$|\\s|[，。！？,.!?:：；;、)])`).test(text);
-    });
-}
+import{createHash as m}from"node:crypto";const g=500;class I{seen=new Set;queue=[];constructor(e=[]){for(const t of e)!t||this.seen.has(t)||(this.seen.add(t),this.queue.push(t));this.trim()}accept(e){return this.seen.has(e)?!1:(this.seen.add(e),this.queue.push(e),this.trim(),!0)}snapshot(){return[...this.queue]}trim(){for(;this.queue.length>g;){const e=this.queue.shift();e&&this.seen.delete(e)}}}function N(n,e={}){const t=r(n.conversationName),a=r(n.text),s=w(n.attachments);if(!t||!a&&s.length===0)return null;const i=r(n.senderName||"")||null,h=$(n.observedAt),u=y(t),d=o("wechat-sender",i||"unknown"),c=r(n.rawId||"")||null,f=n.isMentioned===!0||x(a,e.selfNicknames),p=c?o("wechat-message",`${t}
+${c}`):o("wechat-message",`${t}
+${i||""}
+${a}
+${s.map(l=>l.name||l.url||l.type).join(`
+`)}
+${h}`);return{conversationId:u,conversationName:t,messageId:p,sender:{id:d,name:i},text:a,attachments:s,receivedAt:h,isMentioned:f,rawRef:c}}function y(n){return o("wechat-conversation",r(n))}function r(n){return n.replace(/\s+/g," ").trim()}function w(n){return Array.isArray(n)?n.map(e=>{const t=e?.url?r(e.url):"",a=e?.localPath?r(e.localPath):"",s=b(e?.availability,{url:t,localPath:a});return{type:r(String(e?.type||"file"))||"file",...e?.name?{name:r(e.name)}:{},...t?{url:t}:{},...e?.mimeType?{mimeType:r(e.mimeType)}:{},...Number.isFinite(e?.size)&&Number(e.size)>0?{size:Number(e.size)}:{},...a?{localPath:a}:{},...e?.thumbnailPath?{thumbnailPath:r(e.thumbnailPath)}:{},...e?.hash?{hash:r(e.hash)}:{},...s?{availability:s}:{},...e?.machineId?{machineId:r(e.machineId)}:{},...e?.expiresAt?{expiresAt:r(e.expiresAt)}:{},...e?.providerError?{providerError:r(e.providerError)}:{}}}).filter(e=>e.type):[]}function b(n,e){return n==="edge-local"||n==="server-url"||n==="pending-download"||n==="metadata-only"||n==="unavailable-large"?n:e.localPath?"edge-local":e.url?"server-url":"metadata-only"}function $(n){if(!n)return new Date().toISOString();const e=new Date(n);return Number.isNaN(e.getTime())?new Date().toISOString():e.toISOString()}function o(n,e){return`${n}:${m("sha256").update(e).digest("hex").slice(0,24)}`}function x(n,e){const t=Array.isArray(e)?e.map(a=>r(a)).filter(Boolean):[];return t.length?t.some(a=>{const s=a.replace(/[.*+?^${}()|[\]\\]/g,"\\$&");return new RegExp(`@\\s*${s}(?=$|\\s|[\uFF0C\u3002\uFF01\uFF1F,.!?:\uFF1A\uFF1B;\u3001)])`).test(n)}):!1}export{I as WeChatRpaDeduper,N as normalizeWeChatRpaMessage,y as weChatRpaConversationId};