shennian 0.2.88 → 0.2.90

package/dist/src/channels/runtime.js

@@ -1,533 +1,5 @@
-// @arch docs/features/manager-agent.md
-// @test src/__tests__/manager-runtime.test.ts
-import crypto from 'node:crypto';
-import fs from 'node:fs';
-import path from 'node:path';
-import { ChannelConfigRegistry } from './registry.js';
-import { ChannelSecretRegistry } from './secret-registry.js';
-import { WeComChannelAdapter } from './wecom.js';
-import { WeChatRpaChannelAdapter } from './wechat-rpa.js';
-import { ExternalWebSocketChannelAdapter } from './websocket.js';
-import { splitExternalReplyText } from './reply-split.js';
-export class ChannelRuntime {
-    onExternalMessage;
-    createReplyTarget;
-    configs = new ChannelConfigRegistry();
-    secrets = new ChannelSecretRegistry();
-    adapters = new Map();
-    completedReplyKeys = new Map();
-    recentMessages = new Map();
-    constructor(onExternalMessage, createReplyTarget) {
-        this.onExternalMessage = onExternalMessage;
-        this.createReplyTarget = createReplyTarget;
-        const wecom = new WeComChannelAdapter((event) => this.ingest({ ...event, type: 'external.message' }));
-        this.adapters.set(wecom.type, wecom);
-        const websocket = new ExternalWebSocketChannelAdapter((event) => this.ingest({ ...event, type: 'external.message' }));
-        this.adapters.set(websocket.type, websocket);
-        const wechatRpa = new WeChatRpaChannelAdapter((event) => this.ingest(event));
-        this.adapters.set(wechatRpa.type, wechatRpa);
-    }
-    async start() {
-        for (const config of this.configs.list().filter((channel) => channel.enabled)) {
-            await this.adapters.get(config.type)?.connect(config).catch(() => { });
-        }
-    }
-    async stop() {
-        for (const config of this.configs.list()) {
-            await this.adapters.get(config.type)?.disconnect(config).catch(() => { });
-        }
-    }
-    ingest(event) {
-        const config = this.configs.get(event.channelId);
-        const sessionId = event.managerSessionId ?? config?.sessionId ?? config?.managerSessionId;
-        if (!sessionId)
-            throw new Error(`No session bound for channel ${event.channelId}`);
-        const replyTarget = event.replyTarget || this.createReplyTarget({
-            managerSessionId: sessionId,
-            channelId: event.channelId,
-            conversationId: event.conversationId,
-            messageId: event.messageId,
-        });
-        const normalized = { ...event, replyTarget };
-        this.onExternalMessage(sessionId, normalized);
-        this.recordRecentMessage(normalized);
-        return normalized;
-    }
-    async reply(input) {
-        const config = this.configs.get(input.channelId);
-        if (!config)
-            return { ok: false, error: `Unknown channel: ${input.channelId}` };
-        if ((config.sessionId ?? config.managerSessionId) !== input.managerSessionId) {
-            return { ok: false, error: 'Channel is not bound to this session' };
-        }
-        const adapter = this.adapters.get(config.type);
-        if (!adapter)
-            return { ok: false, error: `Unsupported channel type: ${config.type}` };
-        try {
-            const sends = planExternalReplySends(config.type, input);
-            if (!sends.length)
-                return { ok: false, error: 'Reply text or attachment is required' };
-            let pending = false;
-            for (const send of sends) {
-                const idempotencyKey = send.idempotencyKey;
-                if (idempotencyKey && this.isReplyCompleted(config, input.conversationId, idempotencyKey))
-                    continue;
-                const result = await adapter.send(config, {
-                    ...input,
-                    ...send,
-                });
-                if (result?.status === 'queued') {
-                    pending = true;
-                    continue;
-                }
-                if (result?.status === 'manual-review') {
-                    return { ok: false, error: result.reason || 'Reply requires manual review before retry' };
-                }
-                if (idempotencyKey)
-                    this.markReplyCompleted(config, input.conversationId, idempotencyKey);
-            }
-            return pending ? { ok: true, pending: true } : { ok: true };
-        }
-        catch (err) {
-            return { ok: false, error: err instanceof Error ? err.message : String(err) };
-        }
-    }
-    isReplyCompleted(config, conversationId, idempotencyKey) {
-        const set = this.loadReplyCompletionSet(config);
-        return set.has(replyCompletionKey(config.id, conversationId, idempotencyKey));
-    }
-    markReplyCompleted(config, conversationId, idempotencyKey) {
-        const set = this.loadReplyCompletionSet(config);
-        set.add(replyCompletionKey(config.id, conversationId, idempotencyKey));
-        try {
-            persistReplyCompletionSet(config.workDir, set);
-        }
-        catch {
-            // Some tests and diagnostic channels use virtual workDirs. In-memory idempotency
-            // still protects the current daemon; persistence resumes when workDir is writable.
-        }
-    }
-    loadReplyCompletionSet(config) {
-        const cacheKey = path.resolve(config.workDir);
-        const cached = this.completedReplyKeys.get(cacheKey);
-        if (cached)
-            return cached;
-        const set = readReplyCompletionSet(config.workDir);
-        this.completedReplyKeys.set(cacheKey, set);
-        return set;
-    }
-    async getDefaultReplyTarget(sessionId) {
-        const config = this.configs.list().find((channel) => (channel.sessionId ?? channel.managerSessionId) === sessionId && channel.enabled);
-        if (!config)
-            throw new Error('No enabled external channel is bound to this session');
-        const adapter = this.adapters.get(config.type);
-        if (!adapter?.defaultConversation)
-            throw new Error(`External channel ${config.type} has no default conversation`);
-        const conversation = await adapter.defaultConversation(config);
-        return {
-            channelId: config.id,
-            conversationId: conversation.conversationId,
-        };
-    }
-    getManagerChannel(managerSessionId, type, opts = {}) {
-        const configs = this.configs.list()
-            .filter((channel) => (channel.sessionId ?? channel.managerSessionId) === managerSessionId && channel.type === type);
-        const config = configs.find((channel) => channel.enabled) ?? configs.at(-1);
-        if (!config)
-            return null;
-        const secret = this.secrets.get(config.secretRef);
-        const adapterStatus = this.adapters.get(config.type)?.runtimeStatus?.(config) ?? {};
-        return {
-            id: config.id,
-            type: config.type,
-            name: config.name,
-            sessionId: config.sessionId ?? config.managerSessionId,
-            managerSessionId: config.managerSessionId,
-            workDir: config.workDir,
-            agentType: config.agentType,
-            agentSessionId: config.agentSessionId,
-            modelId: config.modelId,
-            enabled: config.enabled,
-            wsUrl: secret?.wsUrl ?? '',
-            token: opts.includeSecret ? secret?.token ?? '' : '',
-            tokenConfigured: Boolean(secret?.token),
-            canReply: Boolean(secret?.canReply),
-            systemPrompt: typeof secret?.systemPrompt === 'string' ? secret.systemPrompt : '',
-            ...wechatRpaViewFields(secret),
-            ...adapterStatus,
-        };
-    }
-    getChannelById(channelId, opts = {}) {
-        const config = this.configs.get(channelId);
-        if (!config)
-            return null;
-        const secret = this.secrets.get(config.secretRef);
-        const adapterStatus = this.adapters.get(config.type)?.runtimeStatus?.(config) ?? {};
-        return {
-            id: config.id,
-            type: config.type,
-            name: config.name,
-            sessionId: config.sessionId ?? config.managerSessionId,
-            managerSessionId: config.managerSessionId,
-            workDir: config.workDir,
-            agentType: config.agentType,
-            agentSessionId: config.agentSessionId,
-            modelId: config.modelId,
-            enabled: config.enabled,
-            wsUrl: secret?.wsUrl ?? '',
-            token: opts.includeSecret ? secret?.token ?? '' : '',
-            tokenConfigured: Boolean(secret?.token),
-            canReply: Boolean(secret?.canReply),
-            systemPrompt: typeof secret?.systemPrompt === 'string' ? secret.systemPrompt : '',
-            ...wechatRpaViewFields(secret),
-            ...adapterStatus,
-        };
-    }
-    getChannelStatusById(channelId) {
-        const config = this.configs.get(channelId);
-        if (!config)
-            return null;
-        const secret = this.secrets.get(config.secretRef);
-        const adapterStatus = this.adapters.get(config.type)?.runtimeStatus?.(config) ?? {};
-        return {
-            configured: true,
-            connected: isChannelSecretConfigured(config, secret),
-            type: config.type,
-            channelId: config.id,
-            name: config.name,
-            canReply: Boolean(secret?.canReply),
-            systemPrompt: typeof secret?.systemPrompt === 'string' ? secret.systemPrompt : '',
-            ...wechatRpaStatusFields(secret),
-            ...adapterStatus,
-        };
-    }
-    getManagerChannelStatus(managerSessionId) {
-        const config = this.configs.list().find((channel) => (channel.sessionId ?? channel.managerSessionId) === managerSessionId && channel.enabled);
-        if (!config)
-            return null;
-        const secret = this.secrets.get(config.secretRef);
-        const adapterStatus = this.adapters.get(config.type)?.runtimeStatus?.(config) ?? {};
-        return {
-            configured: true,
-            connected: isChannelSecretConfigured(config, secret),
-            type: config.type,
-            channelId: config.id,
-            name: config.name,
-            canReply: Boolean(secret?.canReply),
-            systemPrompt: typeof secret?.systemPrompt === 'string' ? secret.systemPrompt : '',
-            ...wechatRpaStatusFields(secret),
-            ...adapterStatus,
-        };
-    }
-    listManagerChannelStatuses() {
-        return this.configs.list()
-            .filter((channel) => channel.enabled)
-            .map((channel) => ({
-            managerSessionId: channel.sessionId ?? channel.managerSessionId,
-            status: this.getManagerChannelStatus(channel.sessionId ?? channel.managerSessionId),
-        }))
-            .filter((entry) => Boolean(entry.status));
-    }
-    listManagerExternalChannels(managerSessionId) {
-        return this.configs.list()
-            .filter((channel) => channel.enabled && (channel.sessionId ?? channel.managerSessionId) === managerSessionId)
-            .map((channel) => {
-            const secret = this.secrets.get(channel.secretRef);
-            const adapterStatus = this.adapters.get(channel.type)?.runtimeStatus?.(channel) ?? {};
-            return {
-                configured: true,
-                connected: isChannelSecretConfigured(channel, secret),
-                type: channel.type,
-                channelId: channel.id,
-                name: channel.name,
-                canReply: Boolean(secret?.canReply),
-                systemPrompt: typeof secret?.systemPrompt === 'string' ? secret.systemPrompt : '',
-                ...wechatRpaStatusFields(secret),
-                ...adapterStatus,
-            };
-        });
-    }
-    async syncManagerWeChatRpaChannel(managerSessionId) {
-        const config = this.configs.list()
-            .find((channel) => channel.enabled && channel.type === 'wechat-rpa' && (channel.sessionId ?? channel.managerSessionId) === managerSessionId);
-        if (!config)
-            throw new Error('No enabled WeChat RPA channel is bound to this session');
-        const adapter = this.adapters.get(config.type);
-        if (!adapter?.syncNow)
-            throw new Error('WeChat RPA channel does not support manual sync');
-        const recentSince = Date.now() - 2 * 60 * 1000;
-        const messages = mergeExternalMessages(await adapter.syncNow(config) ?? [], this.getRecentMessages(config.id, recentSince));
-        return {
-            channel: this.getManagerChannel(managerSessionId, 'wechat-rpa', { includeSecret: true }),
-            messages,
-        };
-    }
-    recordRecentMessage(event) {
-        const current = this.recentMessages.get(event.channelId) ?? [];
-        current.push(event);
-        this.recentMessages.set(event.channelId, current.slice(-50));
-    }
-    getRecentMessages(channelId, sinceMs) {
-        const messages = this.recentMessages.get(channelId) ?? [];
-        return messages.filter((event) => {
-            const receivedAt = Date.parse(event.receivedAt);
-            return !Number.isFinite(receivedAt) || receivedAt >= sinceMs;
-        });
-    }
-    async upsertManagerChannel(input) {
-        const previous = this.configs.get(input.id);
-        const allConfigs = this.configs.list();
-        const boundSessionId = input.sessionId || input.managerSessionId;
-        const nextConfig = {
-            id: input.id,
-            type: input.type,
-            name: input.name?.trim() || previous?.name || '外部消息通道',
-            sessionId: boundSessionId,
-            managerSessionId: boundSessionId,
-            workDir: input.workDir,
-            agentType: input.agentType || previous?.agentType,
-            agentSessionId: input.agentSessionId ?? previous?.agentSessionId ?? null,
-            modelId: input.modelId ?? previous?.modelId ?? null,
-            enabled: input.enabled,
-            secretRef: previous?.secretRef || `channel:${input.id}`,
-        };
-        const priorSecret = this.secrets.get(nextConfig.secretRef);
-        const wsUrl = input.wsUrl?.trim() || priorSecret?.wsUrl || '';
-        const token = input.token?.trim() || priorSecret?.token || '';
-        const canReply = input.canReply ?? priorSecret?.canReply ?? false;
-        const systemPrompt = input.systemPrompt ?? (typeof priorSecret?.systemPrompt === 'string' ? priorSecret.systemPrompt : '');
-        if (nextConfig.enabled && (!wsUrl || !token)) {
-            throw new Error('WebSocket 地址和 Token 必填');
-        }
-        const configs = allConfigs
-            .filter((channel) => channel.id !== nextConfig.id)
-            .map((channel) => (channel.sessionId ?? channel.managerSessionId) === boundSessionId && channel.type === input.type
-            ? { ...channel, enabled: false }
-            : channel);
-        configs.push(nextConfig);
-        this.configs.replaceAll(configs);
-        if (wsUrl || token) {
-            this.secrets.upsert(nextConfig.secretRef, {
-                type: 'websocket',
-                wsUrl,
-                token,
-                canReply,
-                systemPrompt,
-            });
-        }
-        const adapter = this.adapters.get(nextConfig.type);
-        for (const config of allConfigs) {
-            if ((config.sessionId ?? config.managerSessionId) === boundSessionId && config.type === input.type && config.enabled) {
-                await this.adapters.get(config.type)?.disconnect(config).catch(() => { });
-            }
-        }
-        if (nextConfig.enabled) {
-            void adapter?.connect(nextConfig).catch(() => { });
-        }
-        return this.getManagerChannel(boundSessionId, input.type, { includeSecret: true });
-    }
-    async upsertManagerWeChatRpaChannel(input) {
-        const previous = this.configs.get(input.id);
-        const allConfigs = this.configs.list();
-        const boundSessionId = input.sessionId || input.managerSessionId;
-        const groups = normalizeWeChatRpaGroups(input.groups);
-        if (input.enabled && !groups.length)
-            throw new Error('WeChat RPA 至少需要配置一个群');
-        if (input.enabled && groups.length > 1)
-            throw new Error('WeChat RPA 每个对话只能绑定一个群');
-        const nextConfig = {
-            id: input.id,
-            type: 'wechat-rpa',
-            name: input.name?.trim() || previous?.name || '本机微信 RPA',
-            sessionId: boundSessionId,
-            managerSessionId: boundSessionId,
-            workDir: input.workDir,
-            agentType: input.agentType || previous?.agentType,
-            agentSessionId: input.agentSessionId ?? previous?.agentSessionId ?? null,
-            modelId: input.modelId ?? previous?.modelId ?? null,
-            enabled: input.enabled,
-            secretRef: previous?.secretRef || `channel:${input.id}`,
-        };
-        const priorSecret = this.secrets.get(nextConfig.secretRef);
-        const source = input.source || (priorSecret?.source === 'macos-probe' || priorSecret?.source === 'fixture-jsonl' || priorSecret?.source === 'macos-flow' || priorSecret?.source === 'windows-visual-flow' || priorSecret?.source === 'wechat-rpa-lab' ? priorSecret.source : defaultWeChatRpaSource());
-        const configs = allConfigs
-            .filter((channel) => channel.id !== nextConfig.id)
-            .map((channel) => (channel.sessionId ?? channel.managerSessionId) === boundSessionId && channel.type === 'wechat-rpa'
-            ? { ...channel, enabled: false }
-            : channel);
-        configs.push(nextConfig);
-        this.configs.replaceAll(configs);
-        this.secrets.upsert(nextConfig.secretRef, {
-            type: 'wechat-rpa',
-            source,
-            groups,
-            pollIntervalMs: clampOptionalNumber(input.pollIntervalMs, priorSecret?.pollIntervalMs),
-            recentLimit: clampOptionalNumber(input.recentLimit, priorSecret?.recentLimit),
-            idleSeconds: clampOptionalNumber(input.idleSeconds, priorSecret?.idleSeconds),
-            forceForeground: input.forceForeground ?? Boolean(priorSecret?.forceForeground),
-            noRestore: input.noRestore ?? (priorSecret?.noRestore === undefined ? true : Boolean(priorSecret.noRestore)),
-            downloadAttachments: input.downloadAttachments ?? (priorSecret?.downloadAttachments === undefined ? true : Boolean(priorSecret.downloadAttachments)),
-            downloadAttachmentsDir: input.downloadAttachmentsDir?.trim() || stringOrUndefined(priorSecret?.downloadAttachmentsDir),
-            selfNickname: input.selfNickname?.trim() || stringOrUndefined(priorSecret?.selfNickname),
-            flowScriptPath: input.flowScriptPath?.trim() || stringOrUndefined(priorSecret?.flowScriptPath),
-            canReply: input.canReply ?? priorSecret?.canReply ?? false,
-            systemPrompt: input.systemPrompt ?? (typeof priorSecret?.systemPrompt === 'string' ? priorSecret.systemPrompt : ''),
-        });
-        const adapter = this.adapters.get(nextConfig.type);
-        for (const config of allConfigs) {
-            if ((config.sessionId ?? config.managerSessionId) === boundSessionId && config.type === 'wechat-rpa' && config.enabled) {
-                await this.adapters.get(config.type)?.disconnect(config).catch(() => { });
-            }
-        }
-        if (nextConfig.enabled) {
-            void adapter?.connect(nextConfig).catch(() => { });
-        }
-        return this.getManagerChannel(boundSessionId, 'wechat-rpa', { includeSecret: true });
-    }
-}
-function isChannelSecretConfigured(config, secret) {
-    if (!secret || secret.type !== config.type)
-        return false;
-    if (config.type === 'wechat-rpa')
-        return true;
-    if (config.type === 'websocket')
-        return Boolean(secret.wsUrl && secret.token);
-    if (config.type === 'wecom')
-        return Boolean(secret.token || secret.botId || secret.secret);
-    return Boolean(secret.token);
-}
-function wechatRpaViewFields(secret) {
-    if (!secret || secret.type !== 'wechat-rpa')
-        return {};
-    return {
-        wechatRpaSource: typeof secret.source === 'string' ? secret.source : '',
-        wechatRpaGroups: normalizeWeChatRpaGroups(Array.isArray(secret.groups) ? secret.groups : []),
-        pollIntervalMs: Number.isFinite(secret.pollIntervalMs) ? Number(secret.pollIntervalMs) : undefined,
-        recentLimit: Number.isFinite(secret.recentLimit) ? Number(secret.recentLimit) : undefined,
-        idleSeconds: Number.isFinite(secret.idleSeconds) ? Number(secret.idleSeconds) : undefined,
-        forceForeground: Boolean(secret.forceForeground),
-        noRestore: secret.noRestore === undefined ? undefined : Boolean(secret.noRestore),
-        downloadAttachments: secret.downloadAttachments === undefined ? true : Boolean(secret.downloadAttachments),
-        downloadAttachmentsDir: typeof secret.downloadAttachmentsDir === 'string' ? secret.downloadAttachmentsDir : '',
-        selfNickname: typeof secret.selfNickname === 'string' ? secret.selfNickname : '',
-    };
-}
-function wechatRpaStatusFields(secret) {
-    if (!secret || secret.type !== 'wechat-rpa')
-        return {};
-    return {
-        wechatRpaSource: typeof secret.source === 'string' ? secret.source : null,
-        wechatRpaGroups: normalizeWeChatRpaGroups(Array.isArray(secret.groups) ? secret.groups : []),
-        pollIntervalMs: Number.isFinite(secret.pollIntervalMs) ? Number(secret.pollIntervalMs) : null,
-        recentLimit: Number.isFinite(secret.recentLimit) ? Number(secret.recentLimit) : null,
-        idleSeconds: Number.isFinite(secret.idleSeconds) ? Number(secret.idleSeconds) : null,
-        forceForeground: Boolean(secret.forceForeground),
-        noRestore: secret.noRestore === undefined ? null : Boolean(secret.noRestore),
-        downloadAttachments: secret.downloadAttachments === undefined ? true : Boolean(secret.downloadAttachments),
-        downloadAttachmentsDir: typeof secret.downloadAttachmentsDir === 'string' ? secret.downloadAttachmentsDir : null,
-        selfNickname: typeof secret.selfNickname === 'string' ? secret.selfNickname : null,
-    };
-}
-function normalizeWeChatRpaGroups(groups) {
-    const seen = new Set();
-    const result = [];
-    for (const group of groups) {
-        const name = String(group?.name || '').replace(/\s+/g, ' ').trim();
-        if (!name || seen.has(name))
-            continue;
-        seen.add(name);
-        result.push({ name });
-    }
-    return result;
-}
-function defaultWeChatRpaSource() {
-    return 'wechat-rpa-lab';
-}
-export function planExternalReplySends(channelType, input) {
-    const parts = splitExternalReplyText(input.text);
-    if (!parts.length && !input.attachment)
-        return [];
-    if (channelType === 'wechat-rpa' && input.attachment && parts.length <= 1) {
-        return [{
-                text: parts[0] ?? '',
-                attachment: input.attachment,
-                idempotencyKey: input.idempotencyKey,
-            }];
-    }
-    const sends = parts.map((text, index) => ({
-        text,
-        attachment: undefined,
-        idempotencyKey: parts.length > 1 && input.idempotencyKey
-            ? `${input.idempotencyKey}:${index + 1}`
-            : input.idempotencyKey,
-    }));
-    if (input.attachment) {
-        sends.push({
-            text: '',
-            attachment: input.attachment,
-            idempotencyKey: parts.length && input.idempotencyKey
-                ? `${input.idempotencyKey}:attachment`
-                : input.idempotencyKey,
-        });
-    }
-    return sends;
-}
-function mergeExternalMessages(...groups) {
-    const seen = new Set();
-    const out = [];
-    for (const event of groups.flat()) {
-        const key = `${event.channelId}\n${event.conversationId}\n${event.messageId}`;
-        if (seen.has(key))
-            continue;
-        seen.add(key);
-        out.push(event);
-    }
-    return out;
-}
-function replyCompletionKey(channelId, conversationId, idempotencyKey) {
-    return crypto.createHash('sha256')
-        .update(`${channelId}\n${conversationId}\n${idempotencyKey}`)
-        .digest('hex')
-        .slice(0, 32);
-}
-function replyCompletionFile(workDir) {
-    return path.join(workDir, '.shennian', 'external-reply-idempotency.json');
-}
-function readReplyCompletionSet(workDir) {
-    try {
-        const parsed = JSON.parse(fs.readFileSync(replyCompletionFile(workDir), 'utf8'));
-        const rows = Array.isArray(parsed.completed) ? parsed.completed : [];
-        return new Set(rows
-            .map((row) => {
-            if (typeof row === 'string')
-                return row;
-            if (row && typeof row === 'object' && typeof row.key === 'string') {
-                return row.key;
-            }
-            return '';
-        })
-            .filter(Boolean));
-    }
-    catch {
-        return new Set();
-    }
-}
-function persistReplyCompletionSet(workDir, set) {
-    const filePath = replyCompletionFile(workDir);
-    fs.mkdirSync(path.dirname(filePath), { recursive: true });
-    const keys = Array.from(set).slice(-500);
-    fs.writeFileSync(filePath, JSON.stringify({
-        updatedAt: new Date().toISOString(),
-        completed: keys.map((key) => ({ key })),
-    }, null, 2));
-    set.clear();
-    for (const key of keys)
-        set.add(key);
-}
-function clampOptionalNumber(value, fallback) {
-    const number = Number(value ?? fallback);
-    return Number.isFinite(number) && number >= 0 ? number : undefined;
-}
-function stringOrUndefined(value) {
-    return typeof value === 'string' && value.trim() ? value.trim() : undefined;
-}
+import A from"node:crypto";import y from"node:fs";import g from"node:path";import{ChannelConfigRegistry as v}from"./registry.js";import{ChannelSecretRegistry as P}from"./secret-registry.js";import{WeComChannelAdapter as M}from"./wecom.js";import{WeChatRpaChannelAdapter as N}from"./wechat-rpa.js";import{ExternalWebSocketChannelAdapter as B}from"./websocket.js";import{splitExternalReplyText as D}from"./reply-split.js";class z{onExternalMessage;createReplyTarget;configs=new v;secrets=new P;adapters=new Map;completedReplyKeys=new Map;recentMessages=new Map;constructor(e,t){this.onExternalMessage=e,this.createReplyTarget=t;const n=new M(a=>this.ingest({...a,type:"external.message"}));this.adapters.set(n.type,n);const o=new B(a=>this.ingest({...a,type:"external.message"}));this.adapters.set(o.type,o);const r=new N(a=>this.ingest(a));this.adapters.set(r.type,r)}async start(){for(const e of this.configs.list().filter(t=>t.enabled))await this.adapters.get(e.type)?.connect(e).catch(()=>{})}async stop(){for(const e of this.configs.list())await this.adapters.get(e.type)?.disconnect(e).catch(()=>{})}ingest(e){const t=this.configs.get(e.channelId),n=e.managerSessionId??t?.sessionId??t?.managerSessionId;if(!n)throw new Error(`No session bound for channel ${e.channelId}`);const o=e.replyTarget||this.createReplyTarget({managerSessionId:n,channelId:e.channelId,conversationId:e.conversationId,messageId:e.messageId}),r={...e,replyTarget:o};return this.onExternalMessage(n,r),this.recordRecentMessage(r),r}async reply(e){const t=this.configs.get(e.channelId);if(!t)return{ok:!1,error:`Unknown channel: ${e.channelId}`};if((t.sessionId??t.managerSessionId)!==e.managerSessionId)return{ok:!1,error:"Channel is not bound to this session"};const n=this.adapters.get(t.type);if(!n)return{ok:!1,error:`Unsupported channel type: ${t.type}`};try{const o=E(t.type,e);if(!o.length)return{ok:!1,error:"Reply text or attachment is required"};let r=!1;for(const a of o){const i=a.idempotencyKey;if(i&&this.isReplyCompleted(t,e.conversationId,i))continue;const c=await n.send(t,{...e,...a});if(c?.status==="queued"){r=!0;continue}if(c?.status==="manual-review")return{ok:!1,error:c.reason||"Reply requires manual review before retry"};i&&this.markReplyCompleted(t,e.conversationId,i)}return r?{ok:!0,pending:!0}:{ok:!0}}catch(o){return{ok:!1,error:o instanceof Error?o.message:String(o)}}}isReplyCompleted(e,t,n){return this.loadReplyCompletionSet(e).has(k(e.id,t,n))}markReplyCompleted(e,t,n){const o=this.loadReplyCompletionSet(e);o.add(k(e.id,t,n));try{K(e.workDir,o)}catch{}}loadReplyCompletionSet(e){const t=g.resolve(e.workDir),n=this.completedReplyKeys.get(t);if(n)return n;const o=T(e.workDir);return this.completedReplyKeys.set(t,o),o}async getDefaultReplyTarget(e){const t=this.configs.list().find(r=>(r.sessionId??r.managerSessionId)===e&&r.enabled);if(!t)throw new Error("No enabled external channel is bound to this session");const n=this.adapters.get(t.type);if(!n?.defaultConversation)throw new Error(`External channel ${t.type} has no default conversation`);const o=await n.defaultConversation(t);return{channelId:t.id,conversationId:o.conversationId}}getManagerChannel(e,t,n={}){const o=this.configs.list().filter(c=>(c.sessionId??c.managerSessionId)===e&&c.type===t),r=o.find(c=>c.enabled)??o.at(-1);if(!r)return null;const a=this.secrets.get(r.secretRef),i=this.adapters.get(r.type)?.runtimeStatus?.(r)??{};return{id:r.id,type:r.type,name:r.name,sessionId:r.sessionId??r.managerSessionId,managerSessionId:r.managerSessionId,workDir:r.workDir,agentType:r.agentType,agentSessionId:r.agentSessionId,modelId:r.modelId,enabled:r.enabled,wsUrl:a?.wsUrl??"",token:n.includeSecret?a?.token??"":"",tokenConfigured:!!a?.token,canReply:!!a?.canReply,systemPrompt:typeof a?.systemPrompt=="string"?a.systemPrompt:"",...R(a),...i}}getChannelById(e,t={}){const n=this.configs.get(e);if(!n)return null;const o=this.secrets.get(n.secretRef),r=this.adapters.get(n.type)?.runtimeStatus?.(n)??{};return{id:n.id,type:n.type,name:n.name,sessionId:n.sessionId??n.managerSessionId,managerSessionId:n.managerSessionId,workDir:n.workDir,agentType:n.agentType,agentSessionId:n.agentSessionId,modelId:n.modelId,enabled:n.enabled,wsUrl:o?.wsUrl??"",token:t.includeSecret?o?.token??"":"",tokenConfigured:!!o?.token,canReply:!!o?.canReply,systemPrompt:typeof o?.systemPrompt=="string"?o.systemPrompt:"",...R(o),...r}}getChannelStatusById(e){const t=this.configs.get(e);if(!t)return null;const n=this.secrets.get(t.secretRef),o=this.adapters.get(t.type)?.runtimeStatus?.(t)??{};return{configured:!0,connected:h(t,n),type:t.type,channelId:t.id,name:t.name,canReply:!!n?.canReply,systemPrompt:typeof n?.systemPrompt=="string"?n.systemPrompt:"",...u(n),...o}}getManagerChannelStatus(e){const t=this.configs.list().find(r=>(r.sessionId??r.managerSessionId)===e&&r.enabled);if(!t)return null;const n=this.secrets.get(t.secretRef),o=this.adapters.get(t.type)?.runtimeStatus?.(t)??{};return{configured:!0,connected:h(t,n),type:t.type,channelId:t.id,name:t.name,canReply:!!n?.canReply,systemPrompt:typeof n?.systemPrompt=="string"?n.systemPrompt:"",...u(n),...o}}listManagerChannelStatuses(){return this.configs.list().filter(e=>e.enabled).map(e=>({managerSessionId:e.sessionId??e.managerSessionId,status:this.getManagerChannelStatus(e.sessionId??e.managerSessionId)})).filter(e=>!!e.status)}listManagerExternalChannels(e){return this.configs.list().filter(t=>t.enabled&&(t.sessionId??t.managerSessionId)===e).map(t=>{const n=this.secrets.get(t.secretRef),o=this.adapters.get(t.type)?.runtimeStatus?.(t)??{};return{configured:!0,connected:h(t,n),type:t.type,channelId:t.id,name:t.name,canReply:!!n?.canReply,systemPrompt:typeof n?.systemPrompt=="string"?n.systemPrompt:"",...u(n),...o}})}async syncManagerWeChatRpaChannel(e){const t=this.configs.list().find(a=>a.enabled&&a.type==="wechat-rpa"&&(a.sessionId??a.managerSessionId)===e);if(!t)throw new Error("No enabled WeChat RPA channel is bound to this session");const n=this.adapters.get(t.type);if(!n?.syncNow)throw new Error("WeChat RPA channel does not support manual sync");const o=Date.now()-120*1e3,r=F(await n.syncNow(t)??[],this.getRecentMessages(t.id,o));return{channel:this.getManagerChannel(e,"wechat-rpa",{includeSecret:!0}),messages:r}}recordRecentMessage(e){const t=this.recentMessages.get(e.channelId)??[];t.push(e),this.recentMessages.set(e.channelId,t.slice(-50))}getRecentMessages(e,t){return(this.recentMessages.get(e)??[]).filter(o=>{const r=Date.parse(o.receivedAt);return!Number.isFinite(r)||r>=t})}async upsertManagerChannel(e){const t=this.configs.get(e.id),n=this.configs.list(),o=e.sessionId||e.managerSessionId,r={id:e.id,type:e.type,name:e.name?.trim()||t?.name||"\u5916\u90E8\u6D88\u606F\u901A\u9053",sessionId:o,managerSessionId:o,workDir:e.workDir,agentType:e.agentType||t?.agentType,agentSessionId:e.agentSessionId??t?.agentSessionId??null,modelId:e.modelId??t?.modelId??null,enabled:e.enabled,secretRef:t?.secretRef||`channel:${e.id}`},a=this.secrets.get(r.secretRef),i=e.wsUrl?.trim()||a?.wsUrl||"",c=e.token?.trim()||a?.token||"",p=e.canReply??a?.canReply??!1,m=e.systemPrompt??(typeof a?.systemPrompt=="string"?a.systemPrompt:"");if(r.enabled&&(!i||!c))throw new Error("WebSocket \u5730\u5740\u548C Token \u5FC5\u586B");const f=n.filter(l=>l.id!==r.id).map(l=>(l.sessionId??l.managerSessionId)===o&&l.type===e.type?{...l,enabled:!1}:l);f.push(r),this.configs.replaceAll(f),(i||c)&&this.secrets.upsert(r.secretRef,{type:"websocket",wsUrl:i,token:c,canReply:p,systemPrompt:m});const d=this.adapters.get(r.type);for(const l of n)(l.sessionId??l.managerSessionId)===o&&l.type===e.type&&l.enabled&&await this.adapters.get(l.type)?.disconnect(l).catch(()=>{});return r.enabled&&d?.connect(r).catch(()=>{}),this.getManagerChannel(o,e.type,{includeSecret:!0})}async upsertManagerWeChatRpaChannel(e){const t=this.configs.get(e.id),n=this.configs.list(),o=e.sessionId||e.managerSessionId,r=w(e.groups);if(e.enabled&&!r.length)throw new Error("WeChat RPA \u81F3\u5C11\u9700\u8981\u914D\u7F6E\u4E00\u4E2A\u7FA4");if(e.enabled&&r.length>1)throw new Error("WeChat RPA \u6BCF\u4E2A\u5BF9\u8BDD\u53EA\u80FD\u7ED1\u5B9A\u4E00\u4E2A\u7FA4");const a={id:e.id,type:"wechat-rpa",name:e.name?.trim()||t?.name||"\u672C\u673A\u5FAE\u4FE1 RPA",sessionId:o,managerSessionId:o,workDir:e.workDir,agentType:e.agentType||t?.agentType,agentSessionId:e.agentSessionId??t?.agentSessionId??null,modelId:e.modelId??t?.modelId??null,enabled:e.enabled,secretRef:t?.secretRef||`channel:${e.id}`},i=this.secrets.get(a.secretRef),c=e.source||(i?.source==="macos-probe"||i?.source==="fixture-jsonl"||i?.source==="macos-flow"||i?.source==="windows-visual-flow"||i?.source==="wechat-rpa-lab"?i.source:x());if(e.enabled&&c==="windows-visual-flow")throw new Error("\u4E2A\u4EBA\u5FAE\u4FE1\u901A\u9053\u5F53\u524D\u4EC5\u652F\u6301 macOS");const p=e.privacyConsentAccepted??!!i?.privacyConsentAccepted;if(e.enabled&&!p)throw new Error("\u542F\u7528\u524D\u9700\u8981\u786E\u8BA4\u5FAE\u4FE1\u901A\u9053\u6570\u636E\u4E0E\u9690\u79C1\u6388\u6743");const m=n.filter(d=>d.id!==a.id).map(d=>(d.sessionId??d.managerSessionId)===o&&d.type==="wechat-rpa"?{...d,enabled:!1}:d);m.push(a),this.configs.replaceAll(m),this.secrets.upsert(a.secretRef,{type:"wechat-rpa",source:c,groups:r,pollIntervalMs:I(e.pollIntervalMs,i?.pollIntervalMs),recentLimit:I(e.recentLimit,i?.recentLimit),idleSeconds:I(e.idleSeconds,i?.idleSeconds),forceForeground:e.forceForeground??!!i?.forceForeground,noRestore:e.noRestore??(i?.noRestore===void 0?!0:!!i.noRestore),downloadAttachments:e.downloadAttachments??(i?.downloadAttachments===void 0?!0:!!i.downloadAttachments),downloadAttachmentsDir:e.downloadAttachmentsDir?.trim()||S(i?.downloadAttachmentsDir),selfNickname:e.selfNickname?.trim()||S(i?.selfNickname),privacyConsentAccepted:p,flowScriptPath:e.flowScriptPath?.trim()||S(i?.flowScriptPath),canReply:e.canReply??i?.canReply??!1,systemPrompt:e.systemPrompt??(typeof i?.systemPrompt=="string"?i.systemPrompt:"")});const f=this.adapters.get(a.type);for(const d of n)(d.sessionId??d.managerSessionId)===o&&d.type==="wechat-rpa"&&d.enabled&&await this.adapters.get(d.type)?.disconnect(d).catch(()=>{});return a.enabled&&f?.connect(a).catch(()=>{}),this.getManagerChannel(o,"wechat-rpa",{includeSecret:!0})}}function h(s,e){return!e||e.type!==s.type?!1:s.type==="wechat-rpa"?!0:s.type==="websocket"?!!(e.wsUrl&&e.token):s.type==="wecom"?!!(e.token||e.botId||e.secret):!!e.token}function R(s){return!s||s.type!=="wechat-rpa"?{}:{wechatRpaSource:typeof s.source=="string"?s.source:"",wechatRpaGroups:w(Array.isArray(s.groups)?s.groups:[]),pollIntervalMs:Number.isFinite(s.pollIntervalMs)?Number(s.pollIntervalMs):void 0,recentLimit:Number.isFinite(s.recentLimit)?Number(s.recentLimit):void 0,idleSeconds:Number.isFinite(s.idleSeconds)?Number(s.idleSeconds):void 0,forceForeground:!!s.forceForeground,noRestore:s.noRestore===void 0?void 0:!!s.noRestore,downloadAttachments:s.downloadAttachments===void 0?!0:!!s.downloadAttachments,downloadAttachmentsDir:typeof s.downloadAttachmentsDir=="string"?s.downloadAttachmentsDir:"",selfNickname:typeof s.selfNickname=="string"?s.selfNickname:"",wechatRpaPrivacyConsentAccepted:!!s.privacyConsentAccepted,wechatRpaServerDecisionAvailable:!0,wechatRpaPreflightChecks:b(s)}}function u(s){return!s||s.type!=="wechat-rpa"?{}:{wechatRpaSource:typeof s.source=="string"?s.source:null,wechatRpaGroups:w(Array.isArray(s.groups)?s.groups:[]),pollIntervalMs:Number.isFinite(s.pollIntervalMs)?Number(s.pollIntervalMs):null,recentLimit:Number.isFinite(s.recentLimit)?Number(s.recentLimit):null,idleSeconds:Number.isFinite(s.idleSeconds)?Number(s.idleSeconds):null,forceForeground:!!s.forceForeground,noRestore:s.noRestore===void 0?null:!!s.noRestore,downloadAttachments:s.downloadAttachments===void 0?!0:!!s.downloadAttachments,downloadAttachmentsDir:typeof s.downloadAttachmentsDir=="string"?s.downloadAttachmentsDir:null,selfNickname:typeof s.selfNickname=="string"?s.selfNickname:null,wechatRpaPrivacyConsentAccepted:!!s.privacyConsentAccepted,wechatRpaServerDecisionAvailable:!0,wechatRpaPreflightChecks:b(s)}}function w(s){const e=new Set,t=[];for(const n of s){const o=String(n?.name||"").replace(/\s+/g," ").trim();!o||e.has(o)||(e.add(o),t.push({name:o}))}return t}function x(){return"macos-flow"}function b(s){const e=[];return e.push({code:"mac_only",ok:s.source!=="windows-visual-flow",severity:"blocking",message:s.source==="windows-visual-flow"?"\u4E2A\u4EBA\u5FAE\u4FE1\u901A\u9053\u5F53\u524D\u4EC5\u652F\u6301 macOS\u3002":"\u5F53\u524D\u914D\u7F6E\u4F7F\u7528 macOS \u5FAE\u4FE1\u901A\u9053\u3002"}),e.push({code:"privacy_consent_required",ok:!!s.privacyConsentAccepted,severity:"blocking",message:s.privacyConsentAccepted?"\u5DF2\u786E\u8BA4\u5FAE\u4FE1\u901A\u9053\u6570\u636E\u4E0E\u9690\u79C1\u6388\u6743\u3002":"\u542F\u7528\u524D\u9700\u8981\u786E\u8BA4\u5FAE\u4FE1\u901A\u9053\u6570\u636E\u4E0E\u9690\u79C1\u6388\u6743\u3002"}),e.push({code:"server_decision_unavailable",ok:!0,severity:"blocking",message:"\u670D\u52A1\u7AEF\u5224\u65AD\u80FD\u529B\u53EF\u7528\u3002"}),e}function E(s,e){const t=D(e.text);if(!t.length&&!e.attachment)return[];if(s==="wechat-rpa"&&e.attachment&&t.length<=1)return[{text:t[0]??"",attachment:e.attachment,idempotencyKey:e.idempotencyKey}];const n=t.map((o,r)=>({text:o,attachment:void 0,idempotencyKey:t.length>1&&e.idempotencyKey?`${e.idempotencyKey}:${r+1}`:e.idempotencyKey}));return e.attachment&&n.push({text:"",attachment:e.attachment,idempotencyKey:t.length&&e.idempotencyKey?`${e.idempotencyKey}:attachment`:e.idempotencyKey}),n}function F(...s){const e=new Set,t=[];for(const n of s.flat()){const o=`${n.channelId}
+${n.conversationId}
+${n.messageId}`;e.has(o)||(e.add(o),t.push(n))}return t}function k(s,e,t){return A.createHash("sha256").update(`${s}
+${e}
+${t}`).digest("hex").slice(0,32)}function C(s){return g.join(s,".shennian","external-reply-idempotency.json")}function T(s){try{const e=JSON.parse(y.readFileSync(C(s),"utf8")),t=Array.isArray(e.completed)?e.completed:[];return new Set(t.map(n=>typeof n=="string"?n:n&&typeof n=="object"&&typeof n.key=="string"?n.key:"").filter(Boolean))}catch{return new Set}}function K(s,e){const t=C(s);y.mkdirSync(g.dirname(t),{recursive:!0});const n=Array.from(e).slice(-500);y.writeFileSync(t,JSON.stringify({updatedAt:new Date().toISOString(),completed:n.map(o=>({key:o}))},null,2)),e.clear();for(const o of n)e.add(o)}function I(s,e){const t=Number(s??e);return Number.isFinite(t)&&t>=0?t:void 0}function S(s){return typeof s=="string"&&s.trim()?s.trim():void 0}export{z as ChannelRuntime,E as planExternalReplySends};

package/dist/src/channels/secret-registry.d.ts

@@ -17,6 +17,7 @@ type ChannelSecretRecord = {
     downloadAttachments?: boolean;
     downloadAttachmentsDir?: string;
     selfNickname?: string;
+    privacyConsentAccepted?: boolean;
     idleSeconds?: number;
     recentLimit?: number;
     flowScriptPath?: string;

package/dist/src/channels/secret-registry.js

@@ -1,46 +1 @@
-// @arch docs/features/manager-agent.md
-// @test src/__tests__/manager-runtime.test.ts
-import fs from 'node:fs';
-import path from 'node:path';
-import { resolveShennianPath } from '../config/index.js';
-const SECRETS_PATH = resolveShennianPath('channels.secrets.json');
-function nowIso() {
-    return new Date().toISOString();
-}
-function emptySecrets() {
-    return { secrets: {} };
-}
-export class ChannelSecretRegistry {
-    load() {
-        try {
-            const parsed = JSON.parse(fs.readFileSync(SECRETS_PATH, 'utf-8'));
-            return { secrets: parsed.secrets ?? {} };
-        }
-        catch {
-            return emptySecrets();
-        }
-    }
-    save(file) {
-        fs.mkdirSync(path.dirname(SECRETS_PATH), { recursive: true });
-        fs.writeFileSync(SECRETS_PATH, JSON.stringify(file, null, 2), { mode: 0o600 });
-        try {
-            fs.chmodSync(SECRETS_PATH, 0o600);
-        }
-        catch {
-            // Best effort on filesystems that do not support POSIX modes.
-        }
-    }
-    get(secretRef) {
-        return this.load().secrets[secretRef];
-    }
-    upsert(secretRef, value) {
-        const file = this.load();
-        const record = {
-            ...value,
-            updatedAt: nowIso(),
-        };
-        file.secrets[secretRef] = record;
-        this.save(file);
-        return record;
-    }
-}
+import r from"node:fs";import o from"node:path";import{resolveShennianPath as a}from"../config/index.js";const t=a("channels.secrets.json");function i(){return new Date().toISOString()}function u(){return{secrets:{}}}class m{load(){try{return{secrets:JSON.parse(r.readFileSync(t,"utf-8")).secrets??{}}}catch{return u()}}save(e){r.mkdirSync(o.dirname(t),{recursive:!0}),r.writeFileSync(t,JSON.stringify(e,null,2),{mode:384});try{r.chmodSync(t,384)}catch{}}get(e){return this.load().secrets[e]}upsert(e,c){const s=this.load(),n={...c,updatedAt:i()};return s.secrets[e]=n,this.save(s),n}}export{m as ChannelSecretRegistry};