evolcore 0.0.1 → 0.0.2

package/dist/core/message/message-cache.js

@@ -0,0 +1,56 @@
+/**
+ * 消息缓存
+ * 用于缓存后台任务的关键事件（完成、错误）
+ */
+export class MessageCache {
+    cache = new Map();
+    /**
+     * 添加事件到缓存
+     */
+    addEvent(sessionId, event) {
+        if (!this.cache.has(sessionId)) {
+            this.cache.set(sessionId, []);
+        }
+        this.cache.get(sessionId).push(event);
+    }
+    /**
+     * 获取指定会话的所有缓存事件
+     */
+    getEvents(sessionId) {
+        return this.cache.get(sessionId) || [];
+    }
+    /**
+     * 获取指定会话的缓存事件数量
+     */
+    getCount(sessionId) {
+        return this.cache.get(sessionId)?.length || 0;
+    }
+    /**
+     * 检查指定会话是否有缓存事件
+     */
+    hasMessages(sessionId) {
+        return this.getCount(sessionId) > 0;
+    }
+    /**
+     * 清空指定会话的缓存事件
+     */
+    clearEvents(sessionId) {
+        this.cache.delete(sessionId);
+    }
+    /**
+     * 清理过期的缓存事件
+     * @param maxAge 最大保留时间（毫秒），默认 72 小时
+     */
+    cleanupExpired(maxAge = 72 * 60 * 60 * 1000) {
+        const now = Date.now();
+        for (const [sessionId, events] of this.cache.entries()) {
+            const filtered = events.filter(e => now - e.timestamp < maxAge);
+            if (filtered.length === 0) {
+                this.cache.delete(sessionId);
+            }
+            else {
+                this.cache.set(sessionId, filtered);
+            }
+        }
+    }
+}

package/dist/core/message/message-log.js

@@ -0,0 +1,339 @@
+import fs from 'fs';
+import path from 'path';
+import { appendJsonl, chatDirPath } from '../session/session-fs-store.js';
+import { logger } from '../../utils/logger.js';
+const TRANSIENT_PROTOCOL_TYPE_PREFIXES = [
+    'menu.',
+    'status.',
+    'event.',
+    'events.',
+    'task.status.',
+    'activity.',
+];
+const TRANSIENT_PROTOCOL_TYPES = new Set([
+    'status',
+    'event',
+    'events',
+    'task.status',
+    'activity',
+    'thought',
+    'handoff_state',
+    'handoff_result',
+]);
+const KNOWN_AUN_PAYLOAD_TYPES = new Set([
+    'text',
+    'quote',
+    'thought',
+    'voice',
+    'image',
+    'video',
+    'file',
+    'location',
+    'link',
+    'action_card',
+    'action_card_reply',
+    'merge',
+    'personal_card',
+    'status',
+    'event',
+    'json',
+    'tool_call',
+    'tool_result',
+    'custom',
+]);
+const PAYLOAD_SUMMARY_TEXT_LIMIT = 240;
+const PAYLOAD_SUMMARY_FIELD_LIMIT = 160;
+function truncatePayloadSummary(value, limit) {
+    const normalized = value.replace(/\s+/g, ' ').trim();
+    return normalized.length > limit ? `${normalized.slice(0, limit - 1)}…` : normalized;
+}
+function firstPayloadString(payload, keys) {
+    const value = firstPayloadContentString(payload, keys);
+    return value === undefined ? undefined : truncatePayloadSummary(value, PAYLOAD_SUMMARY_FIELD_LIMIT);
+}
+function firstPayloadContentString(payload, keys) {
+    for (const key of keys) {
+        const value = payload[key];
+        if (typeof value === 'string' && value.trim()) {
+            return value;
+        }
+    }
+    return undefined;
+}
+function payloadAttachmentFilename(payload) {
+    const direct = firstPayloadString(payload, ['filename', 'file_name', 'name']);
+    if (direct)
+        return direct;
+    const attachments = Array.isArray(payload.attachments) ? payload.attachments : [];
+    for (const attachment of attachments) {
+        if (!attachment || typeof attachment !== 'object' || Array.isArray(attachment))
+            continue;
+        const filename = firstPayloadString(attachment, ['filename', 'file_name', 'name']);
+        if (filename)
+            return filename;
+    }
+    return undefined;
+}
+function payloadArrayCount(payload, keys) {
+    for (const key of keys) {
+        const value = payload[key];
+        if (Array.isArray(value))
+            return value.length;
+    }
+    return undefined;
+}
+function compactPayloadSummary(summary) {
+    return Object.values(summary).some((value) => value !== undefined) ? summary : undefined;
+}
+function prefixedPayloadSummary(prefix, value) {
+    return value
+        ? `[${prefix}] ${truncatePayloadSummary(value, PAYLOAD_SUMMARY_TEXT_LIMIT)}`
+        : `[${prefix}]`;
+}
+export function classifyAunPayloadForLog(payload) {
+    if (!payload || typeof payload !== 'object' || Array.isArray(payload)) {
+        const content = typeof payload === 'string' ? payload : String(payload ?? '');
+        return { msgType: 'text', content };
+    }
+    const record = payload;
+    const rawType = typeof record.type === 'string' && record.type.trim()
+        ? record.type.trim()
+        : undefined;
+    if (!rawType) {
+        return {
+            msgType: 'text',
+            content: firstPayloadContentString(record, ['text', 'fallback_text', 'title']) ?? '[payload]',
+        };
+    }
+    const msgType = KNOWN_AUN_PAYLOAD_TYPES.has(rawType)
+        ? rawType
+        : 'custom';
+    const title = firstPayloadString(record, ['title', 'name']);
+    const text = firstPayloadString(record, ['text', 'fallback_text', 'description', 'body']);
+    const contentText = firstPayloadContentString(record, ['text', 'fallback_text', 'description', 'body']);
+    const filename = payloadAttachmentFilename(record);
+    const url = firstPayloadString(record, ['url', 'href']);
+    const kind = firstPayloadString(record, ['kind', 'event', 'status']);
+    const actionCount = payloadArrayCount(record, ['actions', 'buttons']);
+    const attachmentCount = payloadArrayCount(record, ['attachments']);
+    const payloadSummary = compactPayloadSummary({ title, text, filename, url, kind, actionCount, attachmentCount });
+    let content;
+    switch (msgType) {
+        case 'text':
+        case 'quote':
+        case 'thought':
+            content = contentText ?? `[${msgType}]`;
+            break;
+        case 'voice':
+            content = prefixedPayloadSummary('voice', firstPayloadContentString(record, ['transcript']) ?? filename ?? contentText);
+            break;
+        case 'image':
+            content = prefixedPayloadSummary('image', firstPayloadString(record, ['alt', 'title']) ?? filename ?? text);
+            break;
+        case 'video':
+            content = prefixedPayloadSummary('video', title ?? filename ?? text);
+            break;
+        case 'file':
+            content = prefixedPayloadSummary('file', filename ?? text);
+            break;
+        case 'location': {
+            const coordinates = typeof record.latitude === 'number' && typeof record.longitude === 'number'
+                ? `${record.latitude},${record.longitude}`
+                : typeof record.lat === 'number' && typeof record.lng === 'number'
+                    ? `${record.lat},${record.lng}`
+                    : undefined;
+            content = prefixedPayloadSummary('location', firstPayloadString(record, ['name', 'address']) ?? coordinates ?? text);
+            break;
+        }
+        case 'link':
+            content = prefixedPayloadSummary('link', title ?? url ?? text);
+            break;
+        case 'action_card':
+            content = prefixedPayloadSummary('card', title ?? text);
+            break;
+        case 'action_card_reply':
+            content = firstPayloadString(record, ['text', 'action_value', 'value', 'action_label', 'label']) ?? '[action_card_reply]';
+            break;
+        case 'merge':
+            content = prefixedPayloadSummary('merge', title ?? (Array.isArray(record.items) ? `${record.items.length} items` : text));
+            break;
+        case 'personal_card':
+            content = prefixedPayloadSummary('personal_card', title ?? firstPayloadString(record, ['aid', 'agent_id']) ?? text);
+            break;
+        case 'status':
+            content = prefixedPayloadSummary('status', firstPayloadString(record, ['status', 'text']) ?? kind);
+            break;
+        case 'event':
+            content = prefixedPayloadSummary('event', kind ?? title ?? text);
+            break;
+        case 'json':
+            content = prefixedPayloadSummary('json', kind ?? title ?? text);
+            break;
+        case 'tool_call':
+            content = prefixedPayloadSummary('tool_call', firstPayloadString(record, ['name', 'tool_name']) ?? text);
+            break;
+        case 'tool_result': {
+            const name = firstPayloadString(record, ['name', 'tool_name']);
+            const status = firstPayloadString(record, ['status', 'error']);
+            content = prefixedPayloadSummary('tool_result', [name, status].filter(Boolean).join(' '));
+            break;
+        }
+        case 'custom':
+            content = contentText ?? prefixedPayloadSummary(rawType === 'custom' ? 'custom' : `payload:${rawType}`);
+            break;
+        default:
+            content = text ?? `[${msgType}]`;
+    }
+    return {
+        msgType,
+        payloadType: rawType,
+        content,
+        payloadSummary,
+    };
+}
+const MESSAGE_LOG_FILE = 'messages.jsonl';
+// 入方向去重：最近 msgId 缓存（LRU 风格，最多 200 条）
+const recentMsgIds = new Set();
+const DEDUP_MAX = 200;
+function messageLogDedupKey(chatDir, msgId) {
+    return `${path.resolve(chatDir)}\u0000${msgId}`;
+}
+function hasDuplicate(chatDir, msgId) {
+    if (!msgId)
+        return false;
+    return recentMsgIds.has(messageLogDedupKey(chatDir, msgId));
+}
+function rememberMessageId(chatDir, msgId) {
+    if (!msgId)
+        return;
+    const dedupKey = messageLogDedupKey(chatDir, msgId);
+    if (recentMsgIds.has(dedupKey))
+        return;
+    if (recentMsgIds.size >= DEDUP_MAX) {
+        const first = recentMsgIds.values().next().value;
+        recentMsgIds.delete(first);
+    }
+    recentMsgIds.add(dedupKey);
+}
+function formatTimestampMs(epochMs) {
+    const d = new Date(epochMs);
+    const yyyy = d.getFullYear();
+    const mo = String(d.getMonth() + 1).padStart(2, '0');
+    const dd = String(d.getDate()).padStart(2, '0');
+    const hh = String(d.getHours()).padStart(2, '0');
+    const mi = String(d.getMinutes()).padStart(2, '0');
+    const ss = String(d.getSeconds()).padStart(2, '0');
+    const ms = String(d.getMilliseconds()).padStart(3, '0');
+    return `${yyyy}-${mo}-${dd} ${hh}:${mi}:${ss}.${ms}`;
+}
+export function messageLogPath(chatDir) {
+    return path.join(chatDir, MESSAGE_LOG_FILE);
+}
+export function resolveChatDir(sessionsDir, channelType, channelId, selfAID) {
+    return chatDirPath(sessionsDir, channelType, channelId, selfAID);
+}
+/** Append conversation history only. Protocol telemetry stays in its dedicated logs/stores. */
+export function appendMessageLog(chatDir, entry) {
+    if (isTransientProtocolMessage(entry))
+        return;
+    if (entry.dir === 'in' && hasDuplicate(chatDir, entry.msgId)) {
+        logger.debug(`[MessageLog] Duplicate msgId skipped: ${entry.msgId}`);
+        return;
+    }
+    try {
+        fs.mkdirSync(chatDir, { recursive: true });
+        appendJsonl(messageLogPath(chatDir), entry);
+        if (entry.dir === 'in')
+            rememberMessageId(chatDir, entry.msgId);
+    }
+    catch (e) {
+        logger.warn(`[MessageLog] Failed to write message log: ${e}`);
+    }
+}
+/** Strict conversation-history append used by handoff reply binding. */
+export function appendMessageLogStrict(chatDir, entry) {
+    if (isTransientProtocolMessage(entry))
+        return;
+    if (entry.dir === 'in' && hasDuplicate(chatDir, entry.msgId))
+        return;
+    fs.mkdirSync(chatDir, { recursive: true });
+    appendJsonl(messageLogPath(chatDir), entry);
+    if (entry.dir === 'in')
+        rememberMessageId(chatDir, entry.msgId);
+}
+export function buildInboundEntry(opts) {
+    const ts = opts.timestamp || Date.now();
+    const isCommandCapable = !opts.msgType || opts.msgType === 'text' || opts.msgType === 'quote' || opts.msgType === 'action_card_reply';
+    const isCommand = isCommandCapable && opts.content.startsWith('/');
+    return {
+        ts,
+        time: formatTimestampMs(ts),
+        sessionId: opts.sessionId,
+        threadId: opts.threadId ?? null,
+        dir: 'in',
+        from: opts.from,
+        to: opts.to,
+        chatType: opts.chatType,
+        groupId: opts.groupId ?? null,
+        msgId: opts.msgId ?? null,
+        msgType: isCommand ? 'command' : (opts.msgType ?? 'text'),
+        payloadType: opts.payloadType,
+        payloadSummary: opts.payloadSummary,
+        content: opts.content,
+        replyTo: opts.replyTo ?? null,
+        agent: null,
+        model: null,
+        permMode: opts.permMode ?? null,
+        cmdParsed: isCommand ? opts.content.split(/\s/)[0] : null,
+        durationMs: null,
+        encrypt: opts.encrypt,
+        chatmode: opts.chatmode,
+        peerName: opts.peerName,
+        peerType: opts.peerType,
+        source: opts.source,
+    };
+}
+export function buildOutboundEntry(opts) {
+    const ts = opts.timestamp || Date.now();
+    return {
+        ts,
+        time: formatTimestampMs(ts),
+        sessionId: opts.sessionId,
+        threadId: opts.threadId ?? null,
+        dir: 'out',
+        from: opts.from,
+        to: opts.to,
+        chatType: opts.chatType,
+        groupId: opts.groupId ?? null,
+        msgId: opts.msgId ?? null,
+        msgType: opts.msgType ?? 'text',
+        payloadType: opts.payloadType,
+        payloadSummary: opts.payloadSummary,
+        content: opts.content,
+        replyTo: opts.replyTo ?? null,
+        agent: opts.agent ?? null,
+        model: opts.model ?? null,
+        permMode: null,
+        cmdParsed: null,
+        durationMs: opts.durationMs ?? null,
+        numTurns: opts.numTurns ?? null,
+        usage: opts.usage ?? null,
+        encrypt: opts.encrypt,
+        chatmode: opts.chatmode,
+        peerType: opts.peerType,
+        source: opts.source ?? 'daemon',
+        handoff_trace: opts.handoff_trace,
+    };
+}
+export function isTransientProtocolType(value) {
+    const type = value?.trim().toLowerCase();
+    if (!type)
+        return false;
+    return TRANSIENT_PROTOCOL_TYPES.has(type)
+        || TRANSIENT_PROTOCOL_TYPE_PREFIXES.some(prefix => type.startsWith(prefix));
+}
+export function isTransientProtocolMessage(entry) {
+    if (!entry)
+        return false;
+    return isTransientProtocolType(entry.payloadType) || isTransientProtocolType(entry.msgType);
+}

package/dist/core/message/message-processor.js

@@ -0,0 +1,4 @@
+import { ResponseEngine } from './response-engine.js';
+export { ResponseEngine, ResponseEngine as MessageProcessorEngine };
+export const MessageProcessor = ResponseEngine;
+export * from './response-engine.js';