shennian 0.2.89 → 0.2.90

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

@@ -1,1028 +1,6 @@
-// @arch docs/features/wechat-rpa-channel.md
-// @test src/__tests__/wechat-rpa-normalizer.test.ts
-// @test src/__tests__/wechat-rpa-health.test.ts
-import crypto from 'node:crypto';
-import fs from 'node:fs';
-import path from 'node:path';
-import { fileURLToPath, pathToFileURL } from 'node:url';
-import { ChannelSecretRegistry } from './secret-registry.js';
-import { resolveShennianPath } from '../config/index.js';
-import { probeMacWeChat, observedMessageFromProbe } from './wechat-rpa/macos.js';
-import { runMacWeChatRpaFlow } from './wechat-rpa/macos-flow.js';
-import { normalizeWeChatRpaMessage, WeChatRpaDeduper, weChatRpaConversationId, } from './wechat-rpa/normalizer.js';
-const DEFAULT_POLL_INTERVAL_MS = 5_000;
-const DEFAULT_RECENT_LIMIT = 5;
-const LAB_SCROLL_READ_RECENT_LIMIT = 8;
-const MAX_OUTBOUND_ATTACHMENT_BYTES = Number(process.env.SHENNIAN_WECHAT_RPA_OUTBOUND_ATTACHMENT_MAX_BYTES || 20 * 1024 * 1024);
-const INTERRUPTION_COOLDOWN_THRESHOLD = Number(process.env.SHENNIAN_WECHAT_RPA_INTERRUPTION_COOLDOWN_THRESHOLD || 3);
-const INTERRUPTION_COOLDOWN_MS = Number(process.env.SHENNIAN_WECHAT_RPA_INTERRUPTION_COOLDOWN_MS || 5 * 60 * 1000);
-const MAX_RECENT_TASK_SUMMARIES = 10;
-export function selectWeChatRpaLabReadKind(recentLimit) {
-    return clampNumber(recentLimit, DEFAULT_RECENT_LIMIT, 1, 50) >= LAB_SCROLL_READ_RECENT_LIMIT ? 'scroll-read' : 'read-latest';
-}
-export class WeChatRpaChannelAdapter {
-    onMessage;
-    type = 'wechat-rpa';
-    secrets = new ChannelSecretRegistry();
-    connections = new Map();
-    constructor(onMessage) {
-        this.onMessage = onMessage;
-    }
-    async connect(config) {
-        if (!config.enabled)
-            return;
-        const secret = this.readSecret(config);
-        const conn = this.ensureConnection(config);
-        conn.stopped = false;
-        conn.config = config;
-        hydratePendingReplyState(conn, config);
-        hydrateMessageState(conn, config);
-        this.seedConfiguredConversations(conn, secret);
-        if (conn.timer)
-            return;
-        await this.enqueueOperation(conn, () => this.pollOnce(conn, this.readSecret(conn.config)));
-        conn.timer = setInterval(() => {
-            void this.enqueueOperation(conn, () => this.pollOnce(conn, this.readSecret(conn.config))).catch(() => { });
-        }, clampPollInterval(secret.pollIntervalMs));
-        conn.timer.unref();
-    }
-    async disconnect(config) {
-        const conn = this.connections.get(config.id);
-        if (!conn)
-            return;
-        conn.stopped = true;
-        if (conn.timer)
-            clearInterval(conn.timer);
-        this.connections.delete(config.id);
-    }
-    async syncNow(config) {
-        if (!config.enabled)
-            throw new Error('WeChat RPA channel is disabled');
-        const secret = this.readSecret(config);
-        const conn = this.ensureConnection(config);
-        conn.stopped = false;
-        conn.config = config;
-        hydratePendingReplyState(conn, config);
-        hydrateMessageState(conn, config);
-        this.seedConfiguredConversations(conn, secret);
-        return this.enqueueOperation(conn, () => this.pollOnce(conn, this.readSecret(conn.config)));
-    }
-    async send(config, reply) {
-        const secret = this.readSecret(config);
-        if (secret.canReply === false)
-            throw new Error('WeChat RPA channel does not allow replies');
-        if (!isFlowSource(secret.source)) {
-            throw new Error('WeChat RPA reply requires source=macos-flow, windows-visual-flow, or wechat-rpa-lab');
-        }
-        const conn = this.ensureConnection(config);
-        conn.config = config;
-        hydratePendingReplyState(conn, config);
-        hydrateMessageState(conn, config);
-        this.seedConfiguredConversations(conn, secret);
-        const conversationName = this.resolveConversationName(config, secret, reply.conversationId);
-        if (!conversationName)
-            throw new Error(`Unknown WeChat RPA conversation: ${reply.conversationId}`);
-        const pendingKey = pendingReplyKey(config, reply);
-        if (conn.completedPendingReplyKeys.has(pendingKey))
-            return { status: 'sent' };
-        const manualReview = conn.manualReviewReplies.get(pendingKey);
-        if (manualReview)
-            return { status: 'manual-review', reason: manualReview.reason };
-        const attachmentPath = reply.attachment
-            ? await materializeWeChatRpaOutboundAttachment(config.workDir, reply.attachment)
-            : undefined;
-        const text = reply.text.trim();
-        if (!text && !attachmentPath)
-            throw new Error('Reply text or attachment is required');
-        if (isInterruptionCooldownActive(conn, secret)) {
-            const reason = 'WeChat RPA is cooling down after repeated user activity';
-            conn.runtimeState = 'cooldown';
-            enqueuePendingReply(conn, {
-                key: pendingKey,
-                conversationId: reply.conversationId,
-                conversationName,
-                text,
-                attachmentPath,
-                reason,
-            });
-            return { status: 'queued', reason };
-        }
-        let flow;
-        try {
-            conn.runtimeState = 'syncing';
-            flow = await this.enqueueOperation(conn, () => {
-                conn.lastRunAt = new Date().toISOString();
-                return runSendFlow(config, secret, conversationName, text, attachmentPath, pendingKey);
-            });
-        }
-        catch (error) {
-            conn.lastError = error instanceof Error ? error.message : String(error);
-            addTaskSummary(conn, {
-                status: classifyWeChatRpaFailure(conn.lastError),
-                runId: conn.lastRunId ?? null,
-                summary: conn.lastError,
-            });
-            throw error;
-        }
-        recordTraceRuntime(conn, flow);
-        const partial = applyPartialSendProgress(flow, { text, attachmentPath });
-        if (partial.status === 'queued') {
-            const reason = partial.reason;
-            enqueuePendingReply(conn, {
-                key: pendingKey,
-                conversationId: reply.conversationId,
-                conversationName,
-                text: partial.text,
-                attachmentPath: partial.attachmentPath,
-                reason,
-                skipText: partial.skipText,
-            });
-            conn.lastError = reason;
-            return { status: 'queued', reason };
-        }
-        if (flow.interrupted) {
-            const reason = flow.error || 'WeChat RPA send was interrupted by user activity';
-            noteInterruption(conn, flow, reason);
-            enqueuePendingReply(conn, {
-                key: pendingKey,
-                conversationId: reply.conversationId,
-                conversationName,
-                text: partial.text,
-                attachmentPath,
-                reason,
-                skipText: partial.skipText,
-            });
-            return { status: 'queued', reason };
-        }
-        if (!flow.ok) {
-            const reason = flow.error || 'WeChat RPA send validator failed; manual review required before retry';
-            noteManualReview(conn, pendingKey, reason);
-            return { status: 'manual-review', reason };
-        }
-        addTaskSummary(conn, {
-            status: 'sent',
-            runId: conn.lastRunId ?? null,
-            summary: flow.rpaTraceSummary || `sent ${conversationName}`,
-        });
-        noteSuccessfulRun(conn);
-        conn.lastError = null;
-        return { status: 'sent' };
-    }
-    async health(config) {
-        const secret = this.readSecret(config);
-        if ((secret.source ?? 'macos-probe') === 'fixture-jsonl') {
-            return secret.fixturePath && fs.existsSync(secret.fixturePath)
-                ? { ok: true }
-                : { ok: false, message: 'WeChat RPA fixture file is missing' };
-        }
-        if (secret.source === 'macos-flow') {
-            if (process.platform !== 'darwin')
-                return { ok: false, message: 'WeChat RPA macOS flow requires macOS' };
-            if (!configuredGroups(secret).length)
-                return { ok: false, message: 'WeChat RPA macOS flow requires at least one group' };
-        }
-        if (secret.source === 'wechat-rpa-lab') {
-            if (process.platform !== 'darwin')
-                return { ok: false, message: 'WeChat RPA Lab source requires macOS for live runs' };
-            if (!configuredGroups(secret).length)
-                return { ok: false, message: 'WeChat RPA Lab source requires at least one group' };
-            try {
-                resolveWeChatRpaLabIndex(config.workDir);
-            }
-            catch (error) {
-                return { ok: false, message: error instanceof Error ? error.message : String(error) };
-            }
-            return { ok: true, message: 'WeChat RPA Lab source configured' };
-        }
-        if (secret.source === 'windows-visual-flow') {
-            return windowsVisualFlowHealth(secret, process.platform);
-        }
-        const probe = await probeMacWeChat();
-        return probe.ok
-            ? { ok: true, message: probe.wechatRunning ? 'WeChat detected' : 'WeChat is not running' }
-            : { ok: false, message: probe.message };
-    }
-    async defaultConversation(config) {
-        const secret = this.readSecret(config);
-        const first = configuredGroups(secret)[0];
-        if (!first)
-            throw new Error('WeChat RPA channel has no configured groups');
-        return { conversationId: weChatRpaConversationId(first), conversationName: first };
-    }
-    runtimeStatus(config) {
-        const conn = this.connections.get(config.id);
-        if (!conn)
-            return {};
-        return {
-            wechatRpaRuntimeState: conn.runtimeState,
-            wechatRpaLastRunAt: conn.lastRunAt ?? null,
-            wechatRpaLastMessageAt: conn.lastMessageAt ?? null,
-            wechatRpaLastInterruptedAt: conn.lastInterruptedAt ?? null,
-            wechatRpaPendingReplyCount: conn.pendingReplies.size,
-            wechatRpaLastError: conn.lastError ?? null,
-            wechatRpaLastRunId: conn.lastRunId ?? null,
-            wechatRpaLastTracePath: conn.lastTracePath ?? null,
-            wechatRpaLastTraceSummary: conn.lastTraceSummary ?? null,
-            wechatRpaRecentTaskSummaries: conn.recentTaskSummaries,
-        };
-    }
-    ensureConnection(config) {
-        let conn = this.connections.get(config.id);
-        if (!conn) {
-            conn = {
-                config,
-                timer: null,
-                deduper: new WeChatRpaDeduper(),
-                stopped: false,
-                conversations: new Map(),
-                pendingReplies: new Map(),
-                manualReviewReplies: new Map(),
-                completedPendingReplyKeys: new Set(),
-                pendingStatePath: undefined,
-                messageStatePath: undefined,
-                operation: Promise.resolve(),
-                recentTaskSummaries: [],
-                runtimeState: 'idle_waiting',
-                consecutiveInterruptions: 0,
-            };
-            this.connections.set(config.id, conn);
-        }
-        return conn;
-    }
-    enqueueOperation(conn, operation) {
-        const run = conn.operation.then(operation, operation);
-        conn.operation = run.then(() => undefined, () => undefined);
-        return run;
-    }
-    readSecret(config) {
-        const secret = this.secrets.get(config.secretRef);
-        if (!secret || secret.type !== 'wechat-rpa') {
-            throw new Error('WeChat RPA channel is not configured on this daemon');
-        }
-        return secret;
-    }
-    async pollOnce(conn, secret) {
-        if (conn.stopped)
-            return [];
-        const emitted = [];
-        conn.lastRunAt = new Date().toISOString();
-        try {
-            if (isInterruptionCooldownActive(conn, secret)) {
-                conn.runtimeState = 'cooldown';
-                return [];
-            }
-            const pendingInterrupted = await this.drainPendingReplies(conn, secret);
-            if (pendingInterrupted)
-                return [];
-            let interrupted = false;
-            conn.runtimeState = 'syncing';
-            const observed = await this.readObservedMessages(conn.config, secret, (flow) => {
-                recordTraceRuntime(conn, flow);
-                if (!flow.interrupted)
-                    return;
-                interrupted = true;
-                noteInterruption(conn, flow, flow.error || 'WeChat RPA poll was interrupted by user activity');
-            });
-            conn.lastError = null;
-            for (const item of observed) {
-                const message = normalizeWeChatRpaMessage(item, { selfNicknames: wechatRpaSelfNicknames(secret) });
-                if (!message || !conn.deduper.accept(message.messageId))
-                    continue;
-                persistMessageState(conn);
-                conn.conversations.set(message.conversationId, message.conversationName);
-                conn.lastMessageAt = message.receivedAt;
-                const event = {
-                    type: 'external.message',
-                    managerSessionId: conn.config.managerSessionId,
-                    channelId: conn.config.id,
-                    channelType: 'wechat-rpa',
-                    conversationId: message.conversationId,
-                    conversationName: message.conversationName,
-                    messageId: message.messageId,
-                    sender: message.sender,
-                    text: message.text,
-                    attachments: message.attachments,
-                    receivedAt: message.receivedAt,
-                    isMentioned: message.isMentioned,
-                    replyTarget: '',
-                    rawRef: message.rawRef,
-                };
-                emitted.push(this.onMessage?.(event) ?? event);
-                addTaskSummary(conn, {
-                    status: 'received',
-                    runId: conn.lastRunId ?? null,
-                    summary: `received ${message.conversationName}${message.sender.name ? ` from ${message.sender.name}` : ''}: ${clipSummary(message.text || message.attachments[0]?.name || 'attachment')}`,
-                });
-            }
-            if (!interrupted)
-                noteSuccessfulRun(conn);
-            return emitted;
-        }
-        catch (error) {
-            conn.lastError = error instanceof Error ? error.message : String(error);
-            addTaskSummary(conn, {
-                status: classifyWeChatRpaFailure(conn.lastError),
-                runId: conn.lastRunId ?? null,
-                summary: conn.lastError,
-            });
-            throw error;
-        }
-    }
-    async drainPendingReplies(conn, secret) {
-        if (!conn.pendingReplies.size)
-            return false;
-        for (const pending of Array.from(conn.pendingReplies.values())) {
-            conn.runtimeState = 'retrying';
-            pending.attempts += 1;
-            pending.lastAttemptAt = new Date().toISOString();
-            persistPendingReplyState(conn);
-            const flow = await runSendFlow(conn.config, secret, pending.conversationName, pending.skipText ? '' : pending.text, pending.attachmentPath, pending.key);
-            recordTraceRuntime(conn, flow);
-            const partial = applyPartialSendProgress(flow, {
-                text: pending.skipText ? '' : pending.text,
-                attachmentPath: pending.attachmentPath,
-            });
-            if (partial.status === 'queued') {
-                pending.text = partial.text;
-                pending.attachmentPath = partial.attachmentPath;
-                pending.skipText = partial.skipText;
-                pending.lastInterruptedReason = partial.reason;
-                conn.lastError = partial.reason;
-                persistPendingReplyState(conn);
-                return true;
-            }
-            if (flow.interrupted) {
-                const reason = flow.error || 'WeChat RPA pending send was interrupted by user activity';
-                pending.text = partial.text;
-                pending.attachmentPath = partial.attachmentPath;
-                pending.skipText = partial.skipText;
-                pending.lastInterruptedReason = reason;
-                noteInterruption(conn, flow, reason);
-                persistPendingReplyState(conn);
-                return true;
-            }
-            if (!flow.ok) {
-                const reason = flow.error || 'WeChat RPA pending send validator failed; manual review required before retry';
-                conn.pendingReplies.delete(pending.key);
-                noteManualReview(conn, pending.key, reason);
-                persistPendingReplyState(conn);
-                return true;
-            }
-            conn.pendingReplies.delete(pending.key);
-            conn.completedPendingReplyKeys.add(pending.key);
-            persistPendingReplyState(conn);
-            conn.lastError = null;
-            addTaskSummary(conn, {
-                status: 'sent',
-                runId: conn.lastRunId ?? null,
-                summary: flow.rpaTraceSummary || `sent ${pending.conversationName}`,
-            });
-            noteSuccessfulRun(conn);
-        }
-        return false;
-    }
-    async readObservedMessages(config, secret, onFlow) {
-        if (secret.source === 'fixture-jsonl') {
-            return readFixtureMessages(secret.fixturePath);
-        }
-        if (secret.source === 'macos-flow') {
-            return readMacFlowMessages(config, secret, onFlow);
-        }
-        if (secret.source === 'wechat-rpa-lab') {
-            return readLabMessages(config, secret, onFlow);
-        }
-        if (secret.source === 'windows-visual-flow') {
-            return readWindowsVisualFlowMessages(config, secret, onFlow);
-        }
-        const probe = await probeMacWeChat();
-        const message = observedMessageFromProbe(probe);
-        return message ? [message] : [];
-    }
-    seedConfiguredConversations(conn, secret) {
-        for (const name of configuredGroups(secret)) {
-            conn.conversations.set(weChatRpaConversationId(name), name);
-        }
-    }
-    resolveConversationName(config, secret, conversationId) {
-        const conn = this.connections.get(config.id);
-        const cached = conn?.conversations.get(conversationId);
-        if (cached)
-            return cached;
-        return configuredGroups(secret).find((name) => weChatRpaConversationId(name) === conversationId) ?? null;
-    }
-}
-function clampPollInterval(value) {
-    if (!Number.isFinite(value))
-        return DEFAULT_POLL_INTERVAL_MS;
-    return Math.min(60_000, Math.max(1_000, Number(value)));
-}
-function configuredGroups(secret) {
-    return Array.isArray(secret.groups)
-        ? secret.groups.map((group) => String(group?.name || '').trim()).filter(Boolean)
-        : [];
-}
-function wechatRpaSelfNicknames(secret) {
-    return String(secret.selfNickname || '')
-        .split(/[,\n，、]/)
-        .map((item) => item.trim())
-        .filter(Boolean);
-}
-function isWeChatRpaTextMentioned(text, aliases) {
-    if (!aliases.length)
-        return false;
-    return aliases.some((alias) => {
-        const escaped = alias.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
-        return new RegExp(`@\\s*${escaped}(?=$|\\s|[，。！？,.!?:：；;、)])`).test(text);
-    });
-}
-export function windowsVisualFlowHealth(secret, platform = process.platform) {
-    if (platform !== 'win32')
-        return { ok: false, message: 'WeChat RPA Windows visual flow requires Windows' };
-    void secret;
-    return { ok: false, message: 'WeChat RPA Windows visual flow is archived; redesign Windows support before enabling it' };
-}
-async function readLabMessages(config, secret, onFlow) {
-    const api = await importWeChatRpaLabApi(config.workDir);
-    const result = [];
-    for (const name of configuredGroups(secret)) {
-        const flow = await runLabReadFlow(api, config, secret, name);
-        onFlow?.(flow);
-        if (!flow.ok || flow.interrupted)
-            continue;
-        for (const message of flow.newMessages ?? []) {
-            const observed = flowMessageToObservedMessage(name, message, secret);
-            if (observed)
-                result.push(observed);
-        }
-    }
-    return result;
-}
-async function runLabReadFlow(api, config, secret, groupName) {
-    const kind = selectWeChatRpaLabReadKind(secret.recentLimit);
-    const task = {
-        kind,
-        requestId: `wechat-rpa:${groupName}:read:${Date.now()}`,
-        targetGroup: groupName,
-        policy: secret.forceForeground ? 'work' : 'polite',
-        limit: clampNumber(secret.recentLimit, DEFAULT_RECENT_LIMIT, 1, 50),
-        attachmentsDir: resolveWeChatRpaInboundAttachmentDir(config, secret),
-    };
-    const result = await api.runWechatRpaReadLatest(task);
-    const structuredMessages = Array.isArray(result.data?.structuredMessages) ? result.data.structuredMessages : [];
-    const latestMessages = result.validation?.deterministic?.latestMessages ?? [];
-    const flowMessages = structuredMessages.length
-        ? structuredMessages.map((message, index) => structuredMessageToFlowMessage(message, result.runId || 'lab-read', index))
-        : latestMessages.map((text, index) => ({
-            id: `${result.runId || 'lab-read'}:${index}`,
-            text,
-            confidence: 0.8,
-        }));
-    return {
-        ok: Boolean(result.ok),
-        groupName,
-        interrupted: result.status === 'interrupted',
-        reason: result.status,
-        rpaRunId: result.runId,
-        rpaTraceSummary: `${kind} ${result.status || (result.ok ? 'success' : 'failed')} ${groupName}`,
-        recentMessages: flowMessages,
-        newMessages: flowMessages,
-        screenshotPath: result.tracePath,
-        error: labResultError(result),
-    };
-}
-function structuredMessageToFlowMessage(message, runId, index) {
-    return {
-        id: `${runId}:${message.index ?? index}`,
-        text: String(message.text || message.card?.title || '').trim(),
-        confidence: typeof message.confidence === 'number' ? message.confidence : 0.75,
-        senderName: typeof message.senderName === 'string' ? message.senderName : null,
-        attachments: structuredAttachments(message),
-    };
-}
-function structuredAttachments(message) {
-    const kind = String(message.kind || '');
-    if (!['image', 'file', 'video-file', 'video-card', 'link-card', 'official-account-card', 'mini-program-card'].includes(kind))
-        return [];
-    const localPath = typeof message.localPath === 'string' ? message.localPath : undefined;
-    const attachmentType = kind === 'video-file' || kind === 'video-card' ? 'video' : kind === 'link-card' || kind === 'official-account-card' || kind === 'mini-program-card' ? 'file' : kind;
-    return [{
-            type: attachmentType,
-            localPath,
-            availability: localPath ? 'edge-local' : 'metadata-only',
-        }];
-}
-async function runLabSendFlow(config, secret, conversationName, text, attachmentPath, dedupeKey) {
-    const api = await importWeChatRpaLabApi(config.workDir);
-    const tasks = planWeChatRpaLabSendTasks({
-        groupName: conversationName,
-        text,
-        attachmentPath,
-        dedupeKey,
-        requestId: dedupeKey,
-        policy: 'work',
-    });
-    const results = [];
-    for (const task of tasks) {
-        const result = await api.runWechatRpaTask(task);
-        results.push(result);
-        if (!result.ok)
-            break;
-    }
-    const textResult = results.find((result) => result.kind === 'send-text');
-    const attachmentResult = results.find((result) => result.kind === 'send-image' || result.kind === 'send-video' || result.kind === 'send-file');
-    const ok = tasks.length > 0 && results.length === tasks.length && results.every((result) => result.ok);
-    const interrupted = results.some((result) => result.status === 'interrupted');
-    return {
-        ok,
-        groupName: conversationName,
-        interrupted,
-        reason: results.at(-1)?.status,
-        rpaRunId: results.at(-1)?.runId,
-        rpaTraceSummary: `send ${ok ? 'success' : results.at(-1)?.status || 'failed'} ${conversationName} (${results.length}/${tasks.length})`,
-        sentReply: Boolean(text),
-        sentReplyObserved: text ? Boolean(textResult?.ok) : false,
-        sentAttachment: Boolean(attachmentPath),
-        sentAttachmentObserved: attachmentPath ? Boolean(attachmentResult?.ok) : false,
-        postSendScreenshotPath: results.at(-1)?.tracePath,
-        error: ok ? undefined : labResultError(results.at(-1)),
-    };
-}
-export function planWeChatRpaLabSendTasks(input) {
-    const tasks = [];
-    const text = String(input.text || '').trim();
-    const policy = input.policy || 'work';
-    if (text) {
-        tasks.push({
-            kind: 'send-text',
-            requestId: input.requestId ? `${input.requestId}:text` : undefined,
-            targetGroup: input.groupName,
-            policy,
-            text,
-            ...(input.dedupeKey ? { dedupeKey: `${input.dedupeKey}:text` } : {}),
-        });
-    }
-    if (input.attachmentPath) {
-        const kind = weChatRpaLabTaskKindForAttachment(input.attachmentPath);
-        tasks.push({
-            kind,
-            requestId: input.requestId ? `${input.requestId}:attachment` : undefined,
-            targetGroup: input.groupName,
-            policy,
-            filePath: input.attachmentPath,
-            ...(input.dedupeKey ? { dedupeKey: `${input.dedupeKey}:attachment` } : {}),
-        });
-    }
-    return tasks;
-}
-export function weChatRpaLabTaskKindForAttachment(filePath) {
-    const ext = path.extname(filePath).toLowerCase();
-    if (['.png', '.jpg', '.jpeg', '.gif', '.webp', '.heic'].includes(ext))
-        return 'send-image';
-    if (['.mp4', '.mov', '.avi', '.mkv'].includes(ext))
-        return 'send-video';
-    return 'send-file';
-}
-async function importWeChatRpaLabApi(workDir) {
-    const modulePath = resolveWeChatRpaLabIndex(workDir);
-    return await import(pathToFileURL(modulePath).href);
-}
-function resolveWeChatRpaLabIndex(workDir) {
-    const moduleDir = path.dirname(fileURLToPath(import.meta.url));
-    const candidates = [
-        process.env.SHENNIAN_WECHAT_RPA_LAB_INDEX,
-        path.resolve(moduleDir, '../../../../scripts/wechat-rpa-lab/index.mjs'),
-        workDir ? path.join(workDir, 'scripts/wechat-rpa-lab/index.mjs') : '',
-        path.resolve(process.cwd(), 'scripts/wechat-rpa-lab/index.mjs'),
-    ].filter(Boolean);
-    const found = candidates.find((candidate) => fs.existsSync(candidate));
-    if (!found) {
-        throw new Error('WeChat RPA Lab API is missing; set SHENNIAN_WECHAT_RPA_LAB_INDEX or run from the repository root');
-    }
-    return path.resolve(found);
-}
-function labResultError(result) {
-    if (!result)
-        return 'WeChat RPA Lab did not return a result';
-    if (typeof result.error === 'string')
-        return result.error;
-    return result.error?.message || (result.ok ? undefined : `WeChat RPA Lab task ${result.kind || '<unknown>'} ${result.status || 'failed'}`);
-}
-async function readMacFlowMessages(config, secret, onFlow) {
-    const result = [];
-    for (const name of configuredGroups(secret)) {
-        const flow = await runMacWeChatRpaFlow({
-            groupName: name,
-            scriptPath: secret.flowScriptPath,
-            workDir: config.workDir,
-            forceForeground: Boolean(secret.forceForeground),
-            noRestore: secret.noRestore !== false,
-            idleSeconds: clampNumber(secret.idleSeconds, 15, 0, 3600),
-            recentLimit: clampNumber(secret.recentLimit, DEFAULT_RECENT_LIMIT, 0, 50),
-            downloadAttachmentsDir: resolveWeChatRpaInboundAttachmentDir(config, secret),
-        });
-        onFlow?.(flow);
-        if (flow.interrupted)
-            continue;
-        for (const message of flow.newMessages ?? []) {
-            const observed = flowMessageToObservedMessage(name, message, secret);
-            if (observed)
-                result.push(observed);
-        }
-    }
-    return result;
-}
-async function readWindowsVisualFlowMessages(config, secret, onFlow) {
-    void config;
-    const groupName = configuredGroups(secret)[0] || '<unbound>';
-    onFlow?.({
-        ok: false,
-        groupName,
-        interrupted: true,
-        reason: 'windows-visual-flow-archived',
-        newMessages: [],
-        recentMessages: [],
-        error: 'WeChat RPA Windows visual flow is archived; redesign Windows support before enabling it',
-    });
-    return [];
-}
-function flowMessageToObservedMessage(conversationName, message, secret) {
-    const text = String(message.text || '').trim();
-    const attachments = Array.isArray(message.attachments) ? message.attachments : [];
-    if (!text && attachments.length === 0)
-        return null;
-    const senderName = typeof message.senderName === 'string' ? message.senderName.trim() : '';
-    const observedAt = String(message.observedAt || message.timestampIso || '').trim() || new Date().toISOString();
-    return {
-        conversationName,
-        senderName: senderName || null,
-        text,
-        attachments: annotateWeChatRpaInboundAttachments(attachments),
-        observedAt,
-        isMentioned: message.isMentioned === true || isWeChatRpaTextMentioned(text, wechatRpaSelfNicknames(secret)),
-        rawId: String(message.id || `${conversationName}:${senderName}:${text}:${observedAt}`),
-    };
-}
-async function runSendFlow(config, secret, conversationName, text, attachmentPath, dedupeKey) {
-    if (secret.source === 'windows-visual-flow') {
-        void config;
-        void text;
-        void attachmentPath;
-        void dedupeKey;
-        return {
-            ok: false,
-            groupName: conversationName,
-            interrupted: true,
-            reason: 'windows-visual-flow-archived',
-            newMessages: [],
-            recentMessages: [],
-            error: 'WeChat RPA Windows visual flow is archived; redesign Windows support before enabling it',
-        };
-    }
-    if (secret.source === 'wechat-rpa-lab') {
-        return runLabSendFlow(config, secret, conversationName, text, attachmentPath, dedupeKey);
-    }
-    return runMacWeChatRpaFlow({
-        groupName: conversationName,
-        replyText: text || undefined,
-        attachmentPath,
-        scriptPath: secret.flowScriptPath,
-        workDir: config.workDir,
-        forceForeground: Boolean(secret.forceForeground),
-        noRestore: secret.noRestore !== false,
-        idleSeconds: clampNumber(secret.idleSeconds, 15, 0, 3600),
-        recentLimit: clampNumber(secret.recentLimit, DEFAULT_RECENT_LIMIT, 0, 50),
-        downloadAttachmentsDir: resolveWeChatRpaInboundAttachmentDir(config, secret),
-    });
-}
-function isFlowSource(source) {
-    return source === 'macos-flow' || source === 'wechat-rpa-lab';
-}
-function applyPartialSendProgress(flow, input) {
-    if (input.text && input.attachmentPath && flow.sentReplyObserved && !flow.sentAttachmentObserved) {
-        return {
-            status: flow.interrupted ? 'continue' : 'queued',
-            text: '',
-            attachmentPath: input.attachmentPath,
-            skipText: true,
-            reason: flow.error || 'WeChat RPA sent the text but did not confirm the attachment; queued attachment-only retry',
-        };
-    }
-    return {
-        status: 'continue',
-        text: input.text,
-        attachmentPath: input.attachmentPath,
-        reason: flow.error || '',
-    };
-}
-function pendingReplyKey(config, reply) {
-    if (reply.idempotencyKey)
-        return reply.idempotencyKey;
-    return crypto.createHash('sha256')
-        .update(`${config.id}\n${reply.conversationId}\n${reply.text}\n${reply.attachment?.name || ''}\n${reply.attachment?.size || 0}`)
-        .digest('hex')
-        .slice(0, 24);
-}
-function enqueuePendingReply(conn, input) {
-    const existing = conn.pendingReplies.get(input.key);
-    conn.pendingReplies.set(input.key, {
-        key: input.key,
-        conversationId: input.conversationId,
-        conversationName: input.conversationName,
-        text: input.text,
-        attachmentPath: input.attachmentPath,
-        skipText: input.skipText,
-        queuedAt: existing?.queuedAt ?? new Date().toISOString(),
-        attempts: existing?.attempts ?? 0,
-        lastAttemptAt: existing?.lastAttemptAt,
-        lastInterruptedReason: input.reason,
-    });
-    persistPendingReplyState(conn);
-}
-function noteManualReview(conn, key, reason) {
-    conn.manualReviewReplies.set(key, {
-        key,
-        reason,
-        createdAt: conn.manualReviewReplies.get(key)?.createdAt ?? new Date().toISOString(),
-    });
-    conn.lastError = reason;
-    addTaskSummary(conn, {
-        status: 'failed',
-        runId: conn.lastRunId ?? null,
-        summary: `manual review required: ${reason}`,
-    });
-    persistPendingReplyState(conn);
-}
-function hydratePendingReplyState(conn, config) {
-    const filePath = pendingReplyStatePath(config);
-    if (conn.pendingStatePath === filePath)
-        return;
-    conn.pendingStatePath = filePath;
-    const store = readPendingReplyStore(filePath);
-    for (const pending of store.pending ?? []) {
-        if (!isPendingReplyRecord(pending))
-            continue;
-        if (!conn.pendingReplies.has(pending.key))
-            conn.pendingReplies.set(pending.key, pending);
-    }
-    for (const item of store.manualReview ?? []) {
-        if (!isManualReviewRecord(item))
-            continue;
-        if (!conn.manualReviewReplies.has(item.key))
-            conn.manualReviewReplies.set(item.key, item);
-    }
-    for (const key of store.completedKeys ?? []) {
-        if (typeof key === 'string' && key)
-            conn.completedPendingReplyKeys.add(key);
-    }
-}
-function persistPendingReplyState(conn) {
-    if (!conn.pendingStatePath)
-        return;
-    const completedKeys = Array.from(conn.completedPendingReplyKeys).slice(-500);
-    const pending = Array.from(conn.pendingReplies.values()).slice(0, 500);
-    const manualReview = Array.from(conn.manualReviewReplies.values()).slice(-500);
-    try {
-        fs.mkdirSync(path.dirname(conn.pendingStatePath), { recursive: true });
-        fs.writeFileSync(conn.pendingStatePath, JSON.stringify({ version: 1, pending, manualReview, completedKeys }, null, 2));
-    }
-    catch {
-        // Runtime state is best-effort; the in-memory queue still protects the current daemon.
-    }
-}
-function readPendingReplyStore(filePath) {
-    try {
-        const parsed = JSON.parse(fs.readFileSync(filePath, 'utf8'));
-        return parsed && parsed.version === 1 ? parsed : { version: 1, pending: [], completedKeys: [] };
-    }
-    catch {
-        return { version: 1, pending: [], completedKeys: [] };
-    }
-}
-function isPendingReplyRecord(value) {
-    if (!value || typeof value !== 'object')
-        return false;
-    const record = value;
-    return typeof record.key === 'string'
-        && typeof record.conversationId === 'string'
-        && typeof record.conversationName === 'string'
-        && typeof record.text === 'string'
-        && typeof record.queuedAt === 'string'
-        && typeof record.attempts === 'number'
-        && Number.isFinite(record.attempts)
-        && (record.attachmentPath === undefined || typeof record.attachmentPath === 'string')
-        && (record.skipText === undefined || typeof record.skipText === 'boolean');
-}
-function isManualReviewRecord(value) {
-    if (!value || typeof value !== 'object')
-        return false;
-    const record = value;
-    return typeof record.key === 'string'
-        && typeof record.reason === 'string'
-        && typeof record.createdAt === 'string';
-}
-function pendingReplyStatePath(config) {
-    const id = crypto.createHash('sha256').update(config.id).digest('hex').slice(0, 16);
-    return path.join(config.workDir, '.shennian', 'wechat-rpa-pending-replies', `${id}.json`);
-}
-function hydrateMessageState(conn, config) {
-    const filePath = messageStatePath(config);
-    if (conn.messageStatePath === filePath)
-        return;
-    conn.messageStatePath = filePath;
-    const store = readMessageSeenStore(filePath);
-    conn.deduper = new WeChatRpaDeduper((store.messageIds ?? []).filter((id) => typeof id === 'string' && id.length > 0));
-}
-function persistMessageState(conn) {
-    if (!conn.messageStatePath)
-        return;
-    try {
-        fs.mkdirSync(path.dirname(conn.messageStatePath), { recursive: true });
-        fs.writeFileSync(conn.messageStatePath, JSON.stringify({ version: 1, messageIds: conn.deduper.snapshot() }, null, 2));
-    }
-    catch {
-        // Best-effort only; in-memory dedupe still protects the current daemon.
-    }
-}
-function readMessageSeenStore(filePath) {
-    try {
-        const parsed = JSON.parse(fs.readFileSync(filePath, 'utf8'));
-        return parsed && parsed.version === 1 ? parsed : { version: 1, messageIds: [] };
-    }
-    catch {
-        return { version: 1, messageIds: [] };
-    }
-}
-function messageStatePath(config) {
-    const id = crypto.createHash('sha256').update(config.id).digest('hex').slice(0, 16);
-    return path.join(config.workDir, '.shennian', 'wechat-rpa-seen-messages', `${id}.json`);
-}
-function noteInterruption(conn, flow, reason) {
-    conn.lastInterruptedAt = new Date().toISOString();
-    conn.lastError = null;
-    conn.consecutiveInterruptions += 1;
-    conn.runtimeState = 'interrupted';
-    if (shouldEnterInterruptionCooldown(conn)) {
-        conn.interruptionCooldownUntil = Date.now() + INTERRUPTION_COOLDOWN_MS;
-        conn.runtimeState = 'cooldown';
-    }
-    addTaskSummary(conn, {
-        status: 'interrupted',
-        runId: flow.rpaRunId || conn.lastRunId || null,
-        summary: reason,
-    });
-    void reason;
-}
-function noteSuccessfulRun(conn) {
-    conn.consecutiveInterruptions = 0;
-    conn.interruptionCooldownUntil = undefined;
-    conn.runtimeState = 'idle_waiting';
-}
-function recordTraceRuntime(conn, flow) {
-    const tracePath = flow.postSendScreenshotPath || flow.screenshotPath;
-    if (flow.rpaRunId)
-        conn.lastRunId = flow.rpaRunId;
-    if (tracePath)
-        conn.lastTracePath = tracePath;
-    conn.lastTraceSummary = flow.rpaTraceSummary || [
-        flow.groupName ? `group=${flow.groupName}` : '',
-        flow.ok === false ? 'failed' : flow.interrupted ? 'interrupted' : 'ok',
-        flow.reason ? `reason=${flow.reason}` : '',
-    ].filter(Boolean).join(' ');
-}
-function addTaskSummary(conn, summary) {
-    const runId = summary.runId || conn.lastRunId || `local:${Date.now().toString(36)}`;
-    conn.lastRunId = runId;
-    conn.recentTaskSummaries.unshift({
-        at: new Date().toISOString(),
-        status: summary.status,
-        runId,
-        summary: clipSummary(summary.summary),
-    });
-    conn.recentTaskSummaries = conn.recentTaskSummaries.slice(0, MAX_RECENT_TASK_SUMMARIES);
-}
-function classifyWeChatRpaFailure(message) {
-    const value = String(message || '').toLowerCase();
-    return /permission|accessibility|screen recording|automation|window|foreground|target group|refusing|requires|安全|权限|窗口|目标群/.test(value)
-        ? 'blocked'
-        : 'failed';
-}
-function clipSummary(value) {
-    return String(value || '').replace(/\s+/g, ' ').trim().slice(0, 180);
-}
-function isInterruptionCooldownActive(conn, secret) {
-    if (secret.forceForeground)
-        return false;
-    const until = conn.interruptionCooldownUntil;
-    if (!until)
-        return false;
-    if (Date.now() < until)
-        return true;
-    conn.interruptionCooldownUntil = undefined;
-    conn.consecutiveInterruptions = 0;
-    return false;
-}
-function shouldEnterInterruptionCooldown(conn) {
-    if (!Number.isFinite(INTERRUPTION_COOLDOWN_THRESHOLD) || INTERRUPTION_COOLDOWN_THRESHOLD <= 0)
-        return false;
-    if (!Number.isFinite(INTERRUPTION_COOLDOWN_MS) || INTERRUPTION_COOLDOWN_MS <= 0)
-        return false;
-    return conn.consecutiveInterruptions >= INTERRUPTION_COOLDOWN_THRESHOLD;
-}
-function readFixtureMessages(filePath) {
-    if (!filePath || !fs.existsSync(filePath))
-        return [];
-    return fs.readFileSync(filePath, 'utf-8')
-        .split('\n')
-        .map((line) => line.trim())
-        .filter(Boolean)
-        .map((line) => {
-        try {
-            return JSON.parse(line);
-        }
-        catch {
-            return null;
-        }
-    })
-        .filter((item) => Boolean(item));
-}
-export async function materializeWeChatRpaOutboundAttachment(workDir, attachment) {
-    if (attachment.localPath) {
-        if (!fs.existsSync(attachment.localPath))
-            throw new Error(`WeChat RPA local attachment does not exist: ${attachment.localPath}`);
-        return attachment.localPath;
-    }
-    if (attachment.url) {
-        return downloadOutboundAttachment(workDir, attachment);
-    }
-    throw new Error('WeChat RPA attachment requires localPath or url; dataBase64 is not accepted over Manager IPC');
-}
-async function downloadOutboundAttachment(workDir, attachment) {
-    if (!attachment.url || !/^https?:\/\//i.test(attachment.url))
-        throw new Error('WeChat RPA attachment url must be http(s)');
-    if (Number.isFinite(attachment.size) && attachment.size > MAX_OUTBOUND_ATTACHMENT_BYTES) {
-        throw new Error(`WeChat RPA cross-machine attachment is too large: ${attachment.size} bytes. Max: ${MAX_OUTBOUND_ATTACHMENT_BYTES} bytes.`);
-    }
-    const response = await fetch(attachment.url);
-    if (!response.ok)
-        throw new Error(`WeChat RPA attachment url download failed: ${response.status}`);
-    const contentLength = Number(response.headers.get('content-length') || attachment.size || 0);
-    if (contentLength > MAX_OUTBOUND_ATTACHMENT_BYTES) {
-        throw new Error(`WeChat RPA cross-machine attachment is too large: ${contentLength} bytes. Max: ${MAX_OUTBOUND_ATTACHMENT_BYTES} bytes.`);
-    }
-    const buffer = Buffer.from(await response.arrayBuffer());
-    return writeOutboundAttachmentBuffer(workDir, attachment, buffer);
-}
-function writeOutboundAttachmentBuffer(workDir, attachment, buffer) {
-    if (!buffer.byteLength)
-        throw new Error('WeChat RPA attachment is empty');
-    if (buffer.byteLength > MAX_OUTBOUND_ATTACHMENT_BYTES) {
-        throw new Error(`WeChat RPA cross-machine attachment is too large: ${buffer.byteLength} bytes. Max: ${MAX_OUTBOUND_ATTACHMENT_BYTES} bytes.`);
-    }
-    const dir = path.join(workDir, '.uploads', 'wechat-rpa', 'outbound');
-    fs.mkdirSync(dir, { recursive: true });
-    const safe = safeFileName(attachment.name || 'attachment');
-    const hash = crypto.createHash('sha256').update(buffer).digest('hex').slice(0, 12);
-    const ext = path.extname(safe);
-    const stem = ext ? safe.slice(0, -ext.length) : safe;
-    const filePath = path.join(dir, `${stem}-${hash}${ext}`);
-    if (!fs.existsSync(filePath))
-        fs.writeFileSync(filePath, buffer);
-    return filePath;
-}
-function safeFileName(name) {
-    return path.basename(name || 'attachment')
-        .normalize('NFKC')
-        .replace(/[<>:"/\\|?*\x00-\x1F]/g, '_')
-        .replace(/\s+/g, ' ')
-        .replace(/^[ ._]+|[ ._]+$/g, '')
-        || 'attachment';
-}
-export function resolveWeChatRpaInboundAttachmentDir(config, secret) {
-    if (secret.downloadAttachments === false)
-        return undefined;
-    const explicitDir = secret.downloadAttachmentsDir?.trim();
-    if (explicitDir)
-        return path.resolve(explicitDir);
-    const channelKey = crypto.createHash('sha256').update(config.id).digest('hex').slice(0, 16);
-    return resolveShennianPath('wechat-rpa', 'attachments', 'inbound', channelKey);
-}
-export function annotateWeChatRpaInboundAttachments(attachments) {
-    if (!Array.isArray(attachments))
-        return [];
-    const machineId = process.env.SHENNIAN_MACHINE_ID?.trim();
-    return attachments.map((attachment) => {
-        if (!attachment?.localPath)
-            return attachment;
-        return {
-            ...attachment,
-            availability: attachment.availability || 'edge-local',
-            ...(attachment.machineId || !machineId ? {} : { machineId }),
-        };
-    });
-}
-function clampNumber(value, fallback, min, max) {
-    const number = Number(value);
-    if (!Number.isFinite(number))
-        return fallback;
-    return Math.min(max, Math.max(min, number));
-}
+import S from"node:crypto";import h from"node:fs";import p from"node:path";import{fileURLToPath as X,pathToFileURL as G}from"node:url";import{ChannelSecretRegistry as V}from"./secret-registry.js";import{resolveShennianPath as Y}from"../config/index.js";import{probeMacWeChat as O,observedMessageFromProbe as Q}from"./wechat-rpa/macos.js";import{runMacWeChatRpaFlow as $}from"./wechat-rpa/macos-flow.js";import{normalizeWeChatRpaMessage as Z,WeChatRpaDeduper as L,weChatRpaConversationId as I}from"./wechat-rpa/normalizer.js";const ee=5e3,P=5,te=8,R=Number(process.env.SHENNIAN_WECHAT_RPA_OUTBOUND_ATTACHMENT_MAX_BYTES||20*1024*1024),A=Number(process.env.SHENNIAN_WECHAT_RPA_INTERRUPTION_COOLDOWN_THRESHOLD||3),k=Number(process.env.SHENNIAN_WECHAT_RPA_INTERRUPTION_COOLDOWN_MS||300*1e3),re=10;function ne(t){return v(t,P,1,50)>=te?"scroll-read":"read-latest"}class Be{onMessage;type="wechat-rpa";secrets=new V;connections=new Map;constructor(e){this.onMessage=e}async connect(e){if(!e.enabled)return;const r=this.readSecret(e),n=this.ensureConnection(e);n.stopped=!1,n.config=e,C(n,e),x(n,e),this.seedConfiguredConversations(n,r),!n.timer&&(await this.enqueueOperation(n,()=>this.pollOnce(n,this.readSecret(n.config))),n.timer=setInterval(()=>{this.enqueueOperation(n,()=>this.pollOnce(n,this.readSecret(n.config))).catch(()=>{})},ae(r.pollIntervalMs)),n.timer.unref())}async disconnect(e){const r=this.connections.get(e.id);r&&(r.stopped=!0,r.timer&&clearInterval(r.timer),this.connections.delete(e.id))}async syncNow(e){if(!e.enabled)throw new Error("WeChat RPA channel is disabled");const r=this.readSecret(e),n=this.ensureConnection(e);return n.stopped=!1,n.config=e,C(n,e),x(n,e),this.seedConfiguredConversations(n,r),this.enqueueOperation(n,()=>this.pollOnce(n,this.readSecret(n.config)))}async send(e,r){const n=this.readSecret(e);if(n.canReply===!1)throw new Error("WeChat RPA channel does not allow replies");if(!ge(n.source))throw new Error("WeChat RPA reply requires source=macos-flow, windows-visual-flow, or wechat-rpa-lab");const a=this.ensureConnection(e);a.config=e,C(a,e),x(a,e),this.seedConfiguredConversations(a,n);const o=this.resolveConversationName(e,n,r.conversationId);if(!o)throw new Error(`Unknown WeChat RPA conversation: ${r.conversationId}`);const i=we(e,r);if(a.completedPendingReplyKeys.has(i))return{status:"sent"};const u=a.manualReviewReplies.get(i);if(u)return{status:"manual-review",reason:u.reason};const s=r.attachment?await Ce(e.workDir,r.attachment):void 0,m=r.text.trim();if(!m&&!s)throw new Error("Reply text or attachment is required");if(J(a,n)){const d="WeChat RPA is cooling down after repeated user activity";return a.runtimeState="cooldown",b(a,{key:i,conversationId:r.conversationId,conversationName:o,text:m,attachmentPath:s,reason:d}),{status:"queued",reason:d}}let c;try{a.runtimeState="syncing",c=await this.enqueueOperation(a,()=>(a.lastRunAt=new Date().toISOString(),H(e,n,o,m,s,i)))}catch(d){throw a.lastError=d instanceof Error?d.message:String(d),y(a,{status:j(a.lastError),runId:a.lastRunId??null,summary:a.lastError}),d}E(a,c);const l=K(c,{text:m,attachmentPath:s});if(l.status==="queued"){const d=l.reason;return b(a,{key:i,conversationId:r.conversationId,conversationName:o,text:l.text,attachmentPath:l.attachmentPath,reason:d,skipText:l.skipText}),a.lastError=d,{status:"queued",reason:d}}if(c.interrupted){const d=c.error||"WeChat RPA send was interrupted by user activity";return N(a,c,d),b(a,{key:i,conversationId:r.conversationId,conversationName:o,text:l.text,attachmentPath:s,reason:d,skipText:l.skipText}),{status:"queued",reason:d}}if(!c.ok){const d=c.error||"WeChat RPA send validator failed; manual review required before retry";return U(a,i,d),{status:"manual-review",reason:d}}return y(a,{status:"sent",runId:a.lastRunId??null,summary:c.rpaTraceSummary||`sent ${o}`}),T(a),a.lastError=null,{status:"sent"}}async health(e){const r=this.readSecret(e);if((r.source??"macos-probe")==="fixture-jsonl")return r.fixturePath&&h.existsSync(r.fixturePath)?{ok:!0}:{ok:!1,message:"WeChat RPA fixture file is missing"};if(r.source==="macos-flow"){if(process.platform!=="darwin")return{ok:!1,message:"WeChat RPA macOS flow requires macOS"};if(!g(r).length)return{ok:!1,message:"WeChat RPA macOS flow requires at least one group"}}if(r.source==="wechat-rpa-lab"){if(process.platform!=="darwin")return{ok:!1,message:"WeChat RPA Lab source requires macOS for live runs"};if(!g(r).length)return{ok:!1,message:"WeChat RPA Lab source requires at least one group"};try{q(e.workDir)}catch(a){return{ok:!1,message:a instanceof Error?a.message:String(a)}}return{ok:!0,message:"WeChat RPA Lab source configured"}}if(r.source==="windows-visual-flow")return ie(r,process.platform);const n=await O();return n.ok?{ok:!0,message:n.wechatRunning?"WeChat detected":"WeChat is not running"}:{ok:!1,message:n.message}}async defaultConversation(e){const r=this.readSecret(e),n=g(r)[0];if(!n)throw new Error("WeChat RPA channel has no configured groups");return{conversationId:I(n),conversationName:n}}runtimeStatus(e){const r=this.connections.get(e.id);return r?{wechatRpaRuntimeState:r.runtimeState,wechatRpaLastRunAt:r.lastRunAt??null,wechatRpaLastMessageAt:r.lastMessageAt??null,wechatRpaLastInterruptedAt:r.lastInterruptedAt??null,wechatRpaPendingReplyCount:r.pendingReplies.size,wechatRpaLastError:r.lastError??null,wechatRpaLastRunId:r.lastRunId??null,wechatRpaLastTracePath:r.lastTracePath??null,wechatRpaLastTraceSummary:r.lastTraceSummary??null,wechatRpaRecentTaskSummaries:r.recentTaskSummaries}:{}}ensureConnection(e){let r=this.connections.get(e.id);return r||(r={config:e,timer:null,deduper:new L,stopped:!1,conversations:new Map,pendingReplies:new Map,manualReviewReplies:new Map,completedPendingReplyKeys:new Set,pendingStatePath:void 0,messageStatePath:void 0,operation:Promise.resolve(),recentTaskSummaries:[],runtimeState:"idle_waiting",consecutiveInterruptions:0},this.connections.set(e.id,r)),r}enqueueOperation(e,r){const n=e.operation.then(r,r);return e.operation=n.then(()=>{},()=>{}),n}readSecret(e){const r=this.secrets.get(e.secretRef);if(!r||r.type!=="wechat-rpa")throw new Error("WeChat RPA channel is not configured on this daemon");return r}async pollOnce(e,r){if(e.stopped)return[];const n=[];e.lastRunAt=new Date().toISOString();try{if(J(e,r))return e.runtimeState="cooldown",[];if(await this.drainPendingReplies(e,r))return[];let o=!1;e.runtimeState="syncing";const i=await this.readObservedMessages(e.config,r,u=>{E(e,u),u.interrupted&&(o=!0,N(e,u,u.error||"WeChat RPA poll was interrupted by user activity"))});e.lastError=null;for(const u of i){const s=Z(u,{selfNicknames:_(r)});if(!s||!e.deduper.accept(s.messageId))continue;Pe(e),e.conversations.set(s.conversationId,s.conversationName),e.lastMessageAt=s.receivedAt;const m={type:"external.message",managerSessionId:e.config.managerSessionId,channelId:e.config.id,channelType:"wechat-rpa",conversationId:s.conversationId,conversationName:s.conversationName,messageId:s.messageId,sender:s.sender,text:s.text,attachments:s.attachments,receivedAt:s.receivedAt,isMentioned:s.isMentioned,replyTarget:"",rawRef:s.rawRef};n.push(this.onMessage?.(m)??m),y(e,{status:"received",runId:e.lastRunId??null,summary:`received ${s.conversationName}${s.sender.name?` from ${s.sender.name}`:""}: ${z(s.text||s.attachments[0]?.name||"attachment")}`})}return o||T(e),n}catch(a){throw e.lastError=a instanceof Error?a.message:String(a),y(e,{status:j(e.lastError),runId:e.lastRunId??null,summary:e.lastError}),a}}async drainPendingReplies(e,r){if(!e.pendingReplies.size)return!1;for(const n of Array.from(e.pendingReplies.values())){e.runtimeState="retrying",n.attempts+=1,n.lastAttemptAt=new Date().toISOString(),w(e);const a=await H(e.config,r,n.conversationName,n.skipText?"":n.text,n.attachmentPath,n.key);E(e,a);const o=K(a,{text:n.skipText?"":n.text,attachmentPath:n.attachmentPath});if(o.status==="queued")return n.text=o.text,n.attachmentPath=o.attachmentPath,n.skipText=o.skipText,n.lastInterruptedReason=o.reason,e.lastError=o.reason,w(e),!0;if(a.interrupted){const i=a.error||"WeChat RPA pending send was interrupted by user activity";return n.text=o.text,n.attachmentPath=o.attachmentPath,n.skipText=o.skipText,n.lastInterruptedReason=i,N(e,a,i),w(e),!0}if(!a.ok){const i=a.error||"WeChat RPA pending send validator failed; manual review required before retry";return e.pendingReplies.delete(n.key),U(e,n.key,i),w(e),!0}e.pendingReplies.delete(n.key),e.completedPendingReplyKeys.add(n.key),w(e),e.lastError=null,y(e,{status:"sent",runId:e.lastRunId??null,summary:a.rpaTraceSummary||`sent ${n.conversationName}`}),T(e)}return!1}async readObservedMessages(e,r,n){if(r.source==="fixture-jsonl")return be(r.fixturePath);if(r.source==="macos-flow")return me(e,r,n);if(r.source==="wechat-rpa-lab")return oe(e,r,n);if(r.source==="windows-visual-flow")return fe(e,r,n);const a=await O(),o=Q(a);return o?[o]:[]}seedConfiguredConversations(e,r){for(const n of g(r))e.conversations.set(I(n),n)}resolveConversationName(e,r,n){const o=this.connections.get(e.id)?.conversations.get(n);return o||(g(r).find(i=>I(i)===n)??null)}}function ae(t){return Number.isFinite(t)?Math.min(6e4,Math.max(1e3,Number(t))):ee}function g(t){return Array.isArray(t.groups)?t.groups.map(e=>String(e?.name||"").trim()).filter(Boolean):[]}function _(t){return String(t.selfNickname||"").split(/[,\n，、]/).map(e=>e.trim()).filter(Boolean)}function se(t,e){return e.length?e.some(r=>{const n=r.replace(/[.*+?^${}()|[\]\\]/g,"\\$&");return new RegExp(`@\\s*${n}(?=$|\\s|[\uFF0C\u3002\uFF01\uFF1F,.!?:\uFF1A\uFF1B;\u3001)])`).test(t)}):!1}function ie(t,e=process.platform){return e!=="win32"?{ok:!1,message:"WeChat RPA Windows visual flow requires Windows"}:{ok:!1,message:"WeChat RPA Windows visual flow is archived; redesign Windows support before enabling it"}}async function oe(t,e,r){const n=await D(t.workDir),a=[];for(const o of g(e)){const i=await ue(n,t,e,o);if(r?.(i),!(!i.ok||i.interrupted))for(const u of i.newMessages??[]){const s=B(o,u,e);s&&a.push(s)}}return a}async function ue(t,e,r,n){const a=ne(r.recentLimit),o={kind:a,requestId:`wechat-rpa:${n}:read:${Date.now()}`,targetGroup:n,policy:r.forceForeground?"work":"polite",limit:v(r.recentLimit,P,1,50),attachmentsDir:M(e,r)},i=await t.runWechatRpaReadLatest(o),u=Array.isArray(i.data?.structuredMessages)?i.data.structuredMessages:[],s=i.validation?.deterministic?.latestMessages??[],m=u.length?u.map((c,l)=>de(c,i.runId||"lab-read",l)):s.map((c,l)=>({id:`${i.runId||"lab-read"}:${l}`,text:c,confidence:.8}));return{ok:!!i.ok,groupName:n,interrupted:i.status==="interrupted",reason:i.status,rpaRunId:i.runId,rpaTraceSummary:`${a} ${i.status||(i.ok?"success":"failed")} ${n}`,recentMessages:m,newMessages:m,screenshotPath:i.tracePath,error:F(i)}}function de(t,e,r){return{id:`${e}:${t.index??r}`,text:String(t.text||t.card?.title||"").trim(),confidence:typeof t.confidence=="number"?t.confidence:.75,senderName:typeof t.senderName=="string"?t.senderName:null,attachments:ce(t)}}function ce(t){const e=String(t.kind||"");if(!["image","file","video-file","video-card","link-card","official-account-card","mini-program-card"].includes(e))return[];const r=typeof t.localPath=="string"?t.localPath:void 0;return[{type:e==="video-file"||e==="video-card"?"video":e==="link-card"||e==="official-account-card"||e==="mini-program-card"?"file":e,localPath:r,availability:r?"edge-local":"metadata-only"}]}async function le(t,e,r,n,a,o){const i=await D(t.workDir),u=pe({groupName:r,text:n,attachmentPath:a,dedupeKey:o,requestId:o,policy:"work"}),s=[];for(const f of u){const W=await i.runWechatRpaTask(f);if(s.push(W),!W.ok)break}const m=s.find(f=>f.kind==="send-text"),c=s.find(f=>f.kind==="send-image"||f.kind==="send-video"||f.kind==="send-file"),l=u.length>0&&s.length===u.length&&s.every(f=>f.ok),d=s.some(f=>f.status==="interrupted");return{ok:l,groupName:r,interrupted:d,reason:s.at(-1)?.status,rpaRunId:s.at(-1)?.runId,rpaTraceSummary:`send ${l?"success":s.at(-1)?.status||"failed"} ${r} (${s.length}/${u.length})`,sentReply:!!n,sentReplyObserved:n?!!m?.ok:!1,sentAttachment:!!a,sentAttachmentObserved:a?!!c?.ok:!1,postSendScreenshotPath:s.at(-1)?.tracePath,error:l?void 0:F(s.at(-1))}}function pe(t){const e=[],r=String(t.text||"").trim(),n=t.policy||"work";if(r&&e.push({kind:"send-text",requestId:t.requestId?`${t.requestId}:text`:void 0,targetGroup:t.groupName,policy:n,text:r,...t.dedupeKey?{dedupeKey:`${t.dedupeKey}:text`}:{}}),t.attachmentPath){const a=he(t.attachmentPath);e.push({kind:a,requestId:t.requestId?`${t.requestId}:attachment`:void 0,targetGroup:t.groupName,policy:n,filePath:t.attachmentPath,...t.dedupeKey?{dedupeKey:`${t.dedupeKey}:attachment`}:{}})}return e}function he(t){const e=p.extname(t).toLowerCase();return[".png",".jpg",".jpeg",".gif",".webp",".heic"].includes(e)?"send-image":[".mp4",".mov",".avi",".mkv"].includes(e)?"send-video":"send-file"}async function D(t){const e=q(t);return await import(G(e).href)}function q(t){const e=p.dirname(X(import.meta.url)),n=[process.env.SHENNIAN_WECHAT_RPA_LAB_INDEX,p.resolve(e,"../../../../scripts/wechat-rpa-lab/index.mjs"),t?p.join(t,"scripts/wechat-rpa-lab/index.mjs"):"",p.resolve(process.cwd(),"scripts/wechat-rpa-lab/index.mjs")].filter(Boolean).find(a=>h.existsSync(a));if(!n)throw new Error("WeChat RPA Lab API is missing; set SHENNIAN_WECHAT_RPA_LAB_INDEX or run from the repository root");return p.resolve(n)}function F(t){return t?typeof t.error=="string"?t.error:t.error?.message||(t.ok?void 0:`WeChat RPA Lab task ${t.kind||"<unknown>"} ${t.status||"failed"}`):"WeChat RPA Lab did not return a result"}async function me(t,e,r){const n=[];for(const a of g(e)){const o=await $({groupName:a,scriptPath:e.flowScriptPath,workDir:t.workDir,forceForeground:!!e.forceForeground,noRestore:e.noRestore!==!1,idleSeconds:v(e.idleSeconds,15,0,3600),recentLimit:v(e.recentLimit,P,0,50),downloadAttachmentsDir:M(t,e)});if(r?.(o),!o.interrupted)for(const i of o.newMessages??[]){const u=B(a,i,e);u&&n.push(u)}}return n}async function fe(t,e,r){const n=g(e)[0]||"<unbound>";return r?.({ok:!1,groupName:n,interrupted:!0,reason:"windows-visual-flow-archived",newMessages:[],recentMessages:[],error:"WeChat RPA Windows visual flow is archived; redesign Windows support before enabling it"}),[]}function B(t,e,r){const n=String(e.text||"").trim(),a=Array.isArray(e.attachments)?e.attachments:[];if(!n&&a.length===0)return null;const o=typeof e.senderName=="string"?e.senderName.trim():"",i=String(e.observedAt||e.timestampIso||"").trim()||new Date().toISOString();return{conversationName:t,senderName:o||null,text:n,attachments:Ee(a),observedAt:i,isMentioned:e.isMentioned===!0||se(n,_(r)),rawId:String(e.id||`${t}:${o}:${n}:${i}`)}}async function H(t,e,r,n,a,o){return e.source==="windows-visual-flow"?{ok:!1,groupName:r,interrupted:!0,reason:"windows-visual-flow-archived",newMessages:[],recentMessages:[],error:"WeChat RPA Windows visual flow is archived; redesign Windows support before enabling it"}:e.source==="wechat-rpa-lab"?le(t,e,r,n,a,o):$({groupName:r,replyText:n||void 0,attachmentPath:a,scriptPath:e.flowScriptPath,workDir:t.workDir,forceForeground:!!e.forceForeground,noRestore:e.noRestore!==!1,idleSeconds:v(e.idleSeconds,15,0,3600),recentLimit:v(e.recentLimit,P,0,50),downloadAttachmentsDir:M(t,e)})}function ge(t){return t==="macos-flow"||t==="wechat-rpa-lab"}function K(t,e){return e.text&&e.attachmentPath&&t.sentReplyObserved&&!t.sentAttachmentObserved?{status:t.interrupted?"continue":"queued",text:"",attachmentPath:e.attachmentPath,skipText:!0,reason:t.error||"WeChat RPA sent the text but did not confirm the attachment; queued attachment-only retry"}:{status:"continue",text:e.text,attachmentPath:e.attachmentPath,reason:t.error||""}}function we(t,e){return e.idempotencyKey?e.idempotencyKey:S.createHash("sha256").update(`${t.id}
+${e.conversationId}
+${e.text}
+${e.attachment?.name||""}
+${e.attachment?.size||0}`).digest("hex").slice(0,24)}function b(t,e){const r=t.pendingReplies.get(e.key);t.pendingReplies.set(e.key,{key:e.key,conversationId:e.conversationId,conversationName:e.conversationName,text:e.text,attachmentPath:e.attachmentPath,skipText:e.skipText,queuedAt:r?.queuedAt??new Date().toISOString(),attempts:r?.attempts??0,lastAttemptAt:r?.lastAttemptAt,lastInterruptedReason:e.reason}),w(t)}function U(t,e,r){t.manualReviewReplies.set(e,{key:e,reason:r,createdAt:t.manualReviewReplies.get(e)?.createdAt??new Date().toISOString()}),t.lastError=r,y(t,{status:"failed",runId:t.lastRunId??null,summary:`manual review required: ${r}`}),w(t)}function C(t,e){const r=Se(e);if(t.pendingStatePath===r)return;t.pendingStatePath=r;const n=ye(r);for(const a of n.pending??[])Re(a)&&(t.pendingReplies.has(a.key)||t.pendingReplies.set(a.key,a));for(const a of n.manualReview??[])ve(a)&&(t.manualReviewReplies.has(a.key)||t.manualReviewReplies.set(a.key,a));for(const a of n.completedKeys??[])typeof a=="string"&&a&&t.completedPendingReplyKeys.add(a)}function w(t){if(!t.pendingStatePath)return;const e=Array.from(t.completedPendingReplyKeys).slice(-500),r=Array.from(t.pendingReplies.values()).slice(0,500),n=Array.from(t.manualReviewReplies.values()).slice(-500);try{h.mkdirSync(p.dirname(t.pendingStatePath),{recursive:!0}),h.writeFileSync(t.pendingStatePath,JSON.stringify({version:1,pending:r,manualReview:n,completedKeys:e},null,2))}catch{}}function ye(t){try{const e=JSON.parse(h.readFileSync(t,"utf8"));return e&&e.version===1?e:{version:1,pending:[],completedKeys:[]}}catch{return{version:1,pending:[],completedKeys:[]}}}function Re(t){if(!t||typeof t!="object")return!1;const e=t;return typeof e.key=="string"&&typeof e.conversationId=="string"&&typeof e.conversationName=="string"&&typeof e.text=="string"&&typeof e.queuedAt=="string"&&typeof e.attempts=="number"&&Number.isFinite(e.attempts)&&(e.attachmentPath===void 0||typeof e.attachmentPath=="string")&&(e.skipText===void 0||typeof e.skipText=="boolean")}function ve(t){if(!t||typeof t!="object")return!1;const e=t;return typeof e.key=="string"&&typeof e.reason=="string"&&typeof e.createdAt=="string"}function Se(t){const e=S.createHash("sha256").update(t.id).digest("hex").slice(0,16);return p.join(t.workDir,".shennian","wechat-rpa-pending-replies",`${e}.json`)}function x(t,e){const r=Ae(e);if(t.messageStatePath===r)return;t.messageStatePath=r;const n=Ie(r);t.deduper=new L((n.messageIds??[]).filter(a=>typeof a=="string"&&a.length>0))}function Pe(t){if(t.messageStatePath)try{h.mkdirSync(p.dirname(t.messageStatePath),{recursive:!0}),h.writeFileSync(t.messageStatePath,JSON.stringify({version:1,messageIds:t.deduper.snapshot()},null,2))}catch{}}function Ie(t){try{const e=JSON.parse(h.readFileSync(t,"utf8"));return e&&e.version===1?e:{version:1,messageIds:[]}}catch{return{version:1,messageIds:[]}}}function Ae(t){const e=S.createHash("sha256").update(t.id).digest("hex").slice(0,16);return p.join(t.workDir,".shennian","wechat-rpa-seen-messages",`${e}.json`)}function N(t,e,r){t.lastInterruptedAt=new Date().toISOString(),t.lastError=null,t.consecutiveInterruptions+=1,t.runtimeState="interrupted",ke(t)&&(t.interruptionCooldownUntil=Date.now()+k,t.runtimeState="cooldown"),y(t,{status:"interrupted",runId:e.rpaRunId||t.lastRunId||null,summary:r})}function T(t){t.consecutiveInterruptions=0,t.interruptionCooldownUntil=void 0,t.runtimeState="idle_waiting"}function E(t,e){const r=e.postSendScreenshotPath||e.screenshotPath;e.rpaRunId&&(t.lastRunId=e.rpaRunId),r&&(t.lastTracePath=r),t.lastTraceSummary=e.rpaTraceSummary||[e.groupName?`group=${e.groupName}`:"",e.ok===!1?"failed":e.interrupted?"interrupted":"ok",e.reason?`reason=${e.reason}`:""].filter(Boolean).join(" ")}function y(t,e){const r=e.runId||t.lastRunId||`local:${Date.now().toString(36)}`;t.lastRunId=r,t.recentTaskSummaries.unshift({at:new Date().toISOString(),status:e.status,runId:r,summary:z(e.summary)}),t.recentTaskSummaries=t.recentTaskSummaries.slice(0,re)}function j(t){const e=String(t||"").toLowerCase();return/permission|accessibility|screen recording|automation|window|foreground|target group|refusing|requires|安全|权限|窗口|目标群/.test(e)?"blocked":"failed"}function z(t){return String(t||"").replace(/\s+/g," ").trim().slice(0,180)}function J(t,e){if(e.forceForeground)return!1;const r=t.interruptionCooldownUntil;return r?Date.now()<r?!0:(t.interruptionCooldownUntil=void 0,t.consecutiveInterruptions=0,!1):!1}function ke(t){return!Number.isFinite(A)||A<=0||!Number.isFinite(k)||k<=0?!1:t.consecutiveInterruptions>=A}function be(t){return!t||!h.existsSync(t)?[]:h.readFileSync(t,"utf-8").split(`
+`).map(e=>e.trim()).filter(Boolean).map(e=>{try{return JSON.parse(e)}catch{return null}}).filter(e=>!!e)}async function Ce(t,e){if(e.localPath){if(!h.existsSync(e.localPath))throw new Error(`WeChat RPA local attachment does not exist: ${e.localPath}`);return e.localPath}if(e.url)return xe(t,e);throw new Error("WeChat RPA attachment requires localPath or url; dataBase64 is not accepted over Manager IPC")}async function xe(t,e){if(!e.url||!/^https?:\/\//i.test(e.url))throw new Error("WeChat RPA attachment url must be http(s)");if(Number.isFinite(e.size)&&e.size>R)throw new Error(`WeChat RPA cross-machine attachment is too large: ${e.size} bytes. Max: ${R} bytes.`);const r=await fetch(e.url);if(!r.ok)throw new Error(`WeChat RPA attachment url download failed: ${r.status}`);const n=Number(r.headers.get("content-length")||e.size||0);if(n>R)throw new Error(`WeChat RPA cross-machine attachment is too large: ${n} bytes. Max: ${R} bytes.`);const a=Buffer.from(await r.arrayBuffer());return Ne(t,e,a)}function Ne(t,e,r){if(!r.byteLength)throw new Error("WeChat RPA attachment is empty");if(r.byteLength>R)throw new Error(`WeChat RPA cross-machine attachment is too large: ${r.byteLength} bytes. Max: ${R} bytes.`);const n=p.join(t,".uploads","wechat-rpa","outbound");h.mkdirSync(n,{recursive:!0});const a=Te(e.name||"attachment"),o=S.createHash("sha256").update(r).digest("hex").slice(0,12),i=p.extname(a),u=i?a.slice(0,-i.length):a,s=p.join(n,`${u}-${o}${i}`);return h.existsSync(s)||h.writeFileSync(s,r),s}function Te(t){return p.basename(t||"attachment").normalize("NFKC").replace(/[<>:"/\\|?*\x00-\x1F]/g,"_").replace(/\s+/g," ").replace(/^[ ._]+|[ ._]+$/g,"")||"attachment"}function M(t,e){if(e.downloadAttachments===!1)return;const r=e.downloadAttachmentsDir?.trim();if(r)return p.resolve(r);const n=S.createHash("sha256").update(t.id).digest("hex").slice(0,16);return Y("wechat-rpa","attachments","inbound",n)}function Ee(t){if(!Array.isArray(t))return[];const e=process.env.SHENNIAN_MACHINE_ID?.trim();return t.map(r=>r?.localPath?{...r,availability:r.availability||"edge-local",...r.machineId||!e?{}:{machineId:e}}:r)}function v(t,e,r,n){const a=Number(t);return Number.isFinite(a)?Math.min(n,Math.max(r,a)):e}export{Be as WeChatRpaChannelAdapter,Ee as annotateWeChatRpaInboundAttachments,Ce as materializeWeChatRpaOutboundAttachment,pe as planWeChatRpaLabSendTasks,M as resolveWeChatRpaInboundAttachmentDir,ne as selectWeChatRpaLabReadKind,he as weChatRpaLabTaskKindForAttachment,ie as windowsVisualFlowHealth};