evolcore 0.0.32 → 0.0.34

package/dist/channels/daemon.js

@@ -1,6 +1,8 @@
+import { appendExpireEntry, recordNextLaunchCleanup, cleanupPreviousByKind, runExpireCleanup, cleanupSessionRecord, } from '../core/background-session/session-cleanup.js';
 import { ExecutionTimeoutError } from '../utils/error-utils.js';
 import { normalizeExecutionMode } from '../trigger/validation.js';
 import { resolvePeerRoleDetail } from '../config/peer-role-resolver.js';
+import { assertSystemSessionLaunchable } from '../core/system-session/registry.js';
 const DEFAULT_WATCHDOG_MS = 11 * 60 * 1000;
 export class DaemonChannel {
     sessionManager;
@@ -17,6 +19,7 @@ export class DaemonChannel {
         thread: true,
     };
     pending = new Map();
+    bgPending = new Map();
     watchdogMs;
     totalExecutionMs;
     constructor(sessionManager, messageQueue, opts = {}) {
@@ -26,6 +29,8 @@ export class DaemonChannel {
         this.totalExecutionMs = normalizeTotalExecutionMs(opts.totalExecutionMs);
     }
     async converse(prompt, ctx) {
+        // 启动前跑一次 expire 扫描（成本低，只读少量小文件）
+        void runExpireCleanup(this.sessionManager).catch(() => { });
         const runId = ctx.runId;
         const pendingId = ctx.attemptId ?? runId;
         const messageId = pendingId;
@@ -41,6 +46,11 @@ export class DaemonChannel {
                 ? undefined
                 : setTimeout(() => this.totalExecutionTimeout(pendingId, remainingExecutionMs), remainingExecutionMs);
             totalExecutionTimer?.unref?.();
+            // trigger 清理策略：once → expire(3天)，其他 → expire(30天)
+            const isOnce = ctx.trigger.source?.type === 'once';
+            const triggerCleanupPolicy = isOnce
+                ? { mode: 'expire', ttlMs: 3 * 24 * 3600 * 1000 }
+                : { mode: 'expire', ttlMs: 30 * 24 * 3600 * 1000 };
             this.pending.set(pendingId, {
                 resolve,
                 startedAt,
@@ -52,6 +62,11 @@ export class DaemonChannel {
                 abortSignal: ctx.signal,
                 runId,
                 acc: { text: '', files: [], anomalies: [], toolCallCount: 0, seenToolCallIds: new Set() },
+                cleanupPolicy: triggerCleanupPolicy,
+                channelId: ctx.session.channelId,
+                agentAid: ctx.trigger.agentAid,
+                kind: `trigger:${ctx.trigger.id}`,
+                sessionId: ctx.session.id,
             });
         });
         const message = {
@@ -85,8 +100,13 @@ export class DaemonChannel {
                 originChannelKey: ctx.trigger.origin?.channelKey,
                 originChannelType: ctx.trigger.origin?.channelType
                     ?? (ctx.trigger.origin?.channelKey ? channelTypeFromKey(ctx.trigger.origin.channelKey) : undefined),
+                originChatType: ctx.trigger.origin?.delivery?.chatType,
+                originConversationId: ctx.trigger.origin?.delivery?.chatType === 'group'
+                    ? ctx.trigger.origin.channelId
+                    : ctx.trigger.origin?.peerId,
                 originControl: ctx.trigger.origin?.channelKey === 'daemon',
                 authorizedBy: ctx.trigger.authorizedBy,
+                labels: ctx.trigger.labels,
             },
         };
         const onAbort = () => {
@@ -128,6 +148,15 @@ export class DaemonChannel {
         return promise;
     }
     async send(envelope, payload) {
+        // bg-session 路径：优先查 bgPending
+        const bgRunId = this.bgRunIdFromEnvelope(envelope);
+        if (bgRunId) {
+            const bgSlot = this.bgPending.get(bgRunId);
+            if (bgSlot && !bgSlot.terminated) {
+                this.handleBgSessionPayload(bgRunId, bgSlot, payload);
+                return;
+            }
+        }
         const runId = this.runIdFromEnvelope(envelope);
         if (!runId)
             return;
@@ -225,6 +254,9 @@ export class DaemonChannel {
         // 记忆整理会话：把会话原型与整理模式写进 metadata，供渲染层选 manifest / 手册，
         // 供 ipc 侧校验写命令的 --scope。
         const { memoryMode, memoryScope, consolidationBatchDir, consolidationChatDir, consolidationMemoryDir } = trigger.execution;
+        // 系统会话：类型 / subtype / runner 校验不过直接拒绝（Gemini 不支持），不降级成普通会话
+        if (memoryMode)
+            assertSystemSessionLaunchable({ type: 'memory', subtype: memoryMode }, baseagent);
         // 反馈目标与触发方式（consolidation.ts 在 normalize 后补挂的字段）：
         // 收尾时据此投递反馈，并判断是否该反馈（定时触发不反馈）。
         const { feedbackOrigin, consolidationTriggeredBy } = trigger.execution;
@@ -232,7 +264,7 @@ export class DaemonChannel {
             channelKey: this.channelKey,
             peerId: `trigger:${trigger.id}`,
             peerName: trigger.name,
-            ...(memoryMode ? { sessionType: 'memory', memoryMode } : {}),
+            ...(memoryMode ? { systemSession: { type: 'memory', subtype: memoryMode }, sessionType: 'memory', memoryMode } : {}),
             ...(memoryScope ? { memoryScope } : {}),
             ...(consolidationBatchDir ? { consolidationBatchDir } : {}),
             ...(consolidationChatDir ? { consolidationChatDir } : {}),
@@ -270,6 +302,11 @@ export class DaemonChannel {
         const pendingId = metadata?.triggerAttemptId ?? metadata?.triggerRunId;
         return typeof pendingId === 'string' ? pendingId : undefined;
     }
+    bgRunIdFromEnvelope(envelope) {
+        const metadata = envelope.replyContext?.metadata;
+        const runId = metadata?.bgSessionRunId;
+        return typeof runId === 'string' ? runId : undefined;
+    }
     recordToolCall(slot, callId) {
         if (typeof callId !== 'string' || !callId) {
             slot.acc.toolCallCount += 1;
@@ -290,13 +327,14 @@ export class DaemonChannel {
             ?? (origin.channelKey ? channelTypeFromKey(origin.channelKey) : undefined);
         if (!channelType)
             return undefined;
+        const chatType = origin.delivery?.chatType ?? 'private';
         return resolvePeerRoleDetail({
             selfAid: trigger.agentAid,
             channelKey: origin.channelKey,
             channelType,
-            chatType: 'private',
+            chatType,
             actorId: origin.peerId,
-            conversationId: origin.peerId,
+            conversationId: chatType === 'group' ? origin.channelId : origin.peerId,
         }).effectiveRole ?? undefined;
     }
     finish(runId, status, metadata) {
@@ -346,6 +384,29 @@ export class DaemonChannel {
                 toolCallCount: Math.max(slot.acc.toolCallCount, completedToolCallCount),
             },
         });
+        // trigger 清理策略
+        const policy = slot.cleanupPolicy;
+        if (policy.mode === 'immediate') {
+            void cleanupSessionRecord({ sessionId: slot.sessionId, channelId: slot.channelId, agentAid: slot.agentAid }, this.sessionManager);
+        }
+        else if (policy.mode === 'on_next_launch') {
+            recordNextLaunchCleanup(slot.kind, {
+                channelId: slot.channelId,
+                sessionId: slot.sessionId,
+                agentAid: slot.agentAid,
+                recordedAt: Date.now(),
+            });
+        }
+        else if (policy.mode === 'expire') {
+            appendExpireEntry({
+                expireAt: Date.now() + policy.ttlMs,
+                sessionId: slot.sessionId,
+                channelId: slot.channelId,
+                kind: slot.kind,
+                agentAid: slot.agentAid,
+            });
+        }
+        // 'keep' 模式：不做任何处理
     }
     fail(runId, reason, text) {
         const slot = this.pending.get(runId);
@@ -412,6 +473,203 @@ export class DaemonChannel {
         }
         queue.cancelActive?.(messageId);
     }
+    // ── bg-session 生命周期 ──
+    handleBgSessionPayload(runId, slot, payload) {
+        if (slot.terminated)
+            return;
+        switch (payload.kind) {
+            case 'result.text':
+                if (payload.isFinal)
+                    slot.text = payload.text;
+                else
+                    slot.text += payload.text;
+                break;
+            case 'status.completed':
+                this.finishBgSession(runId, slot, 'completed');
+                break;
+            case 'result.error':
+                this.finishBgSession(runId, slot, 'error', payload.text ?? payload.reason ?? 'unknown error');
+                break;
+            case 'system.error':
+                this.finishBgSession(runId, slot, 'error', payload.text ?? payload.subtype ?? 'unknown error');
+                break;
+            case 'status.error':
+                this.finishBgSession(runId, slot, 'error', payload.metadata?.message ?? 'status error');
+                break;
+            case 'status.interrupted':
+                {
+                    const reason = typeof payload.metadata?.reason === 'string'
+                        ? payload.metadata.reason
+                        : 'interrupted';
+                    const outcome = slot.abortSignal?.aborted ? 'cancelled' : 'interrupted';
+                    this.finishBgSession(runId, slot, outcome, reason);
+                }
+                break;
+            case 'status.timeout':
+                this.finishBgSession(runId, slot, 'error', 'bg-session watchdog timeout');
+                break;
+            default:
+                break;
+        }
+    }
+    finishBgSession(runId, slot, outcome, error) {
+        if (slot.terminated)
+            return;
+        slot.terminated = true;
+        if (slot.watchdogTimer)
+            clearTimeout(slot.watchdogTimer);
+        if (slot.abortListener)
+            slot.abortSignal?.removeEventListener('abort', slot.abortListener);
+        this.bgPending.delete(runId);
+        // 会话结束后按清理策略处理
+        const policy = slot.cleanupPolicy;
+        if (policy.mode === 'immediate') {
+            void cleanupSessionRecord({ sessionId: slot.sessionId, channelId: slot.channelId, agentAid: slot.agentAid }, this.sessionManager);
+        }
+        else if (policy.mode === 'on_next_launch') {
+            recordNextLaunchCleanup(slot.kind, {
+                channelId: slot.channelId,
+                sessionId: slot.sessionId,
+                agentAid: slot.agentAid,
+                recordedAt: Date.now(),
+            });
+        }
+        else if (policy.mode === 'expire') {
+            appendExpireEntry({
+                expireAt: Date.now() + policy.ttlMs,
+                sessionId: slot.sessionId,
+                channelId: slot.channelId,
+                kind: slot.kind,
+                agentAid: slot.agentAid,
+            });
+        }
+        // 'keep' 模式：不做任何处理
+        slot.resolve({
+            sessionId: slot.sessionId,
+            outcome,
+            ...(slot.text ? { text: slot.text } : {}),
+            ...(error ? { error } : {}),
+        });
+    }
+    /**
+     * 拉起一个独立后台会话。会话创建、首条消息入队后即返回 handle；
+     * 会话结束由 handle.result 通知。实现 BackgroundSessionLauncher 接口。
+     * 详见 docs/background-session/background-session-launcher.md
+     */
+    async launchBackgroundSession(spec) {
+        const runId = `bg-${spec.kind}-${spec.instanceId}`;
+        const channelId = `bg:${spec.kind}:${spec.instanceId}`;
+        const cleanupPolicy = spec.cleanupPolicy ?? { mode: 'on_next_launch' };
+        // 启动前清理：on_next_launch 清理同 kind 历史，expire 扫描到期条目
+        if (cleanupPolicy.mode === 'on_next_launch') {
+            await cleanupPreviousByKind(spec.kind, this.sessionManager);
+        }
+        else if (cleanupPolicy.mode !== 'keep') {
+            // immediate 和 expire 模式都在启动时跑一次 expire 扫描
+            await runExpireCleanup(this.sessionManager);
+        }
+        const session = await this.sessionManager.getOrCreateSession(this.channelName, channelId, spec.projectPath, channelId, // threadId，每次独立，保证 by_run 语义
+        {
+            channelKey: this.channelKey,
+            peerId: `bg:${spec.kind}`,
+            peerName: spec.kind,
+            peerType: 'system',
+            ...(spec.metadata ?? {}),
+        }, spec.kind, undefined, 'private', spec.baseagent, spec.agentAid, this.channelName, 'system');
+        const promise = new Promise((resolve) => {
+            const slot = {
+                resolve,
+                sessionId: session.id,
+                channelId,
+                kind: spec.kind,
+                startedAt: Date.now(),
+                abortSignal: spec.signal,
+                text: '',
+                terminated: false,
+                cleanupPolicy,
+                agentAid: spec.agentAid,
+                runtimeDir: spec.runtimeDir,
+                watchdogTimer: setTimeout(() => {
+                    this.finishBgSession(runId, slot, 'error', 'bg-session watchdog timeout');
+                }, this.watchdogMs),
+            };
+            slot.watchdogTimer?.unref?.();
+            if (spec.signal) {
+                const onAbort = () => {
+                    void this.cancelDelivery(runId).catch(() => { });
+                };
+                slot.abortListener = onAbort;
+                spec.signal.addEventListener('abort', onAbort, { once: true });
+                if (spec.signal.aborted)
+                    onAbort();
+            }
+            this.bgPending.set(runId, slot);
+        });
+        const message = {
+            channel: this.channelName,
+            channelType: this.channelName,
+            channelId: session.channelId,
+            selfAID: spec.agentAid,
+            baseagent: spec.baseagent,
+            threadId: session.threadId || '',
+            chatType: 'private',
+            peerId: `bg:${spec.kind}`,
+            peerName: spec.kind,
+            peerType: 'system',
+            content: spec.prompt,
+            messageId: runId,
+            timestamp: Date.now(),
+            source: 'bg-session',
+            bgSessionMeta: {
+                kind: spec.kind,
+                runId,
+                instanceId: spec.instanceId,
+                boundSessionId: session.id,
+            },
+            replyContext: {
+                metadata: { bgSessionRunId: runId },
+            },
+        };
+        void this.messageQueue.enqueue?.(session.id, message, spec.projectPath, {
+            interruptible: false,
+            agentName: spec.agentAid,
+            sessionKeyField: session.sessionKey,
+            selfAID: spec.agentAid,
+        });
+        let settled = false;
+        void promise.then(() => { settled = true; });
+        const sessionId = session.id;
+        return {
+            sessionId,
+            result: promise,
+            waitForAgentSessionId: (opts) => this.waitForAgentSessionId(sessionId, () => settled, opts),
+        };
+    }
+    /**
+     * 轮询 session 记录，等 runner 写入 agentSessionId。
+     * 会话刚创建时只有 evolcore sessionId，agentSessionId 要等 runner 初始化并开始第一轮才写入。
+     * 会话结束后再读一次即停止，避免对已结束的会话空等到超时。
+     */
+    async waitForAgentSessionId(sessionId, isSettled, opts = {}) {
+        const deadline = Date.now() + (opts.timeoutMs ?? 10_000);
+        const interval = opts.intervalMs ?? 250;
+        while (true) {
+            const settledBeforeRead = isSettled();
+            try {
+                const id = (await this.sessionManager.getSessionById(sessionId))?.agentSessionId;
+                if (id)
+                    return id;
+            }
+            catch { /* 会话记录写到一半，下一轮再读 */ }
+            if (settledBeforeRead || Date.now() >= deadline)
+                return undefined;
+            await new Promise(r => setTimeout(r, interval));
+        }
+    }
+    /** 实现 BackgroundSessionLauncher 接口 */
+    launch(spec) {
+        return this.launchBackgroundSession(spec);
+    }
 }
 function isObject(value) {
     return !!value && typeof value === 'object' && !Array.isArray(value);

package/dist/cli/agent-command.js

@@ -41,6 +41,30 @@ function formatBytes(bytes) {
         return `${(bytes / 1024).toFixed(1)}KB`;
     return `${(bytes / 1024 / 1024).toFixed(1)}MB`;
 }
+/** 终端显示宽度：CJK 及全角字符占 2 列，ASCII/拉丁占 1 列 */
+function displayWidth(s) {
+    let w = 0;
+    for (const ch of s) {
+        const cp = ch.codePointAt(0);
+        if ((cp >= 0x1100 && cp <= 0x115F) ||
+            (cp >= 0x2E80 && cp <= 0x303E) ||
+            (cp >= 0x3040 && cp <= 0x33FF) ||
+            (cp >= 0x3400 && cp <= 0x9FFF) ||
+            (cp >= 0xAC00 && cp <= 0xD7AF) ||
+            (cp >= 0xF900 && cp <= 0xFAFF) ||
+            (cp >= 0xFF01 && cp <= 0xFF60) ||
+            (cp >= 0xFFE0 && cp <= 0xFFE6)) {
+            w += 2;
+        }
+        else {
+            w += 1;
+        }
+    }
+    return w;
+}
+function padEndDisplay(s, targetWidth) {
+    return s + ' '.repeat(Math.max(0, targetWidth - displayWidth(s)));
+}
 // ==================== Agent ====================
 export async function cmdAgent(args) {
     args = canonicalizeEvolcoreCommandArgv(['ec', 'agent', ...args]).slice(2);
@@ -78,8 +102,8 @@ Commands:
   persona show            查看当前 Agent 的 persona.md
   persona --text <text>   用文本设置当前 Agent 的 persona.md
   persona --file <path>   用 .md/.txt 文件设置当前 Agent 的 persona.md
-  welcome show            查看已确认的 Bootstrap welcome 文案
-  welcome --text <text>  保存 Owner 已确认的 Bootstrap welcome 文案
+  welcome show            查看 Agent 自主准备的 Bootstrap welcome 文案
+  welcome --text <text>  保存 Agent 自主准备的 Bootstrap welcome 文案
   rename <aid> <name>     修改 agent.md 中的显示名称
   ready <aid>              标记 bootstrap 完成，进入 active 状态
   reload [aid]            热重载配置（无参数=全量 resync）
@@ -220,25 +244,28 @@ Options:
         // 表头跟随系统语言
         const isChinese = isHostChinese();
         const headers = isChinese
-            ? { name: '名称', personal: 'Personal名', status: '状态', channels: '渠道', project: '项目', baseagent: '基座', lastActive: '最后活跃' }
-            : { name: 'NAME', personal: 'PERSONAL', status: 'STATUS', channels: 'CHANNELS', project: 'PROJECT', baseagent: 'BASEAGENT', lastActive: 'LAST ACTIVE' };
-        // 计算各列实际需要的宽度
-        let maxNameLen = headers.name.length;
-        let maxPersonalLen = headers.personal.length;
-        let maxStatusLen = headers.status.length;
-        let maxChannelsLen = headers.channels.length;
-        let maxProjectLen = headers.project.length;
-        let maxBaseagentLen = headers.baseagent.length;
+            ? { name: '名称', personal: 'Personal名', status: '状态', channels: '渠道', project: '项目', baseagent: '基座', model: '模型', lastActive: '最后活跃' }
+            : { name: 'NAME', personal: 'PERSONAL', status: 'STATUS', channels: 'CHANNELS', project: 'PROJECT', baseagent: 'BASEAGENT', model: 'MODEL', lastActive: 'LAST ACTIVE' };
+        // 计算各列实际需要的显示宽度（CJK 字符占 2 列）
+        let maxNameLen = displayWidth(headers.name);
+        let maxPersonalLen = displayWidth(headers.personal);
+        let maxStatusLen = displayWidth(headers.status);
+        let maxChannelsLen = displayWidth(headers.channels);
+        let maxProjectLen = displayWidth(headers.project);
+        let maxBaseagentLen = displayWidth(headers.baseagent);
+        let maxModelLen = displayWidth(headers.model);
         for (const info of result.agents) {
-            maxNameLen = Math.max(maxNameLen, info.name.length);
-            maxPersonalLen = Math.max(maxPersonalLen, (info.personalName || '—').length);
-            const displayedStatus = `${info.status || 'unknown'}${info.stale ? ' (stale)' : ''}`;
-            maxStatusLen = Math.max(maxStatusLen, displayedStatus.length);
+            maxNameLen = Math.max(maxNameLen, displayWidth(info.name));
+            maxPersonalLen = Math.max(maxPersonalLen, displayWidth(info.personalName || '—'));
+            const lcSuffix = info.lifecycle && info.lifecycle !== 'active' ? ` (${info.lifecycle})` : '';
+            const displayedStatus = `${info.status || 'unknown'}${info.stale ? ' (stale)' : ''}${lcSuffix}`;
+            maxStatusLen = Math.max(maxStatusLen, displayWidth(displayedStatus));
             const channelsStr = info.channels?.length > 0 ? info.channels.join(', ') : '—';
-            maxChannelsLen = Math.max(maxChannelsLen, channelsStr.length);
+            maxChannelsLen = Math.max(maxChannelsLen, displayWidth(channelsStr));
             const projectStr = info.projectPath ? path.basename(info.projectPath) : '—';
-            maxProjectLen = Math.max(maxProjectLen, projectStr.length);
-            maxBaseagentLen = Math.max(maxBaseagentLen, (info.baseagent || '—').length);
+            maxProjectLen = Math.max(maxProjectLen, displayWidth(projectStr));
+            maxBaseagentLen = Math.max(maxBaseagentLen, displayWidth(info.baseagent || '—'));
+            maxModelLen = Math.max(maxModelLen, displayWidth(info.model || '—'));
         }
         // 加 2 作为列间距
         const colName = maxNameLen + 2;
@@ -247,18 +274,25 @@ Options:
         const colChannels = maxChannelsLen + 1;
         const colProject = maxProjectLen + 2;
         const colBaseagent = maxBaseagentLen + 2;
-        console.log(headers.name.padEnd(colName) + headers.personal.padEnd(colPersonal) + headers.status.padEnd(colStatus) + headers.channels.padEnd(colChannels) +
-            headers.project.padEnd(colProject) + headers.baseagent.padEnd(colBaseagent) + headers.lastActive);
+        const colModel = maxModelLen + 2;
+        console.log(padEndDisplay(headers.name, colName) + padEndDisplay(headers.personal, colPersonal) +
+            padEndDisplay(headers.status, colStatus) + padEndDisplay(headers.channels, colChannels) +
+            padEndDisplay(headers.project, colProject) + padEndDisplay(headers.baseagent, colBaseagent) +
+            padEndDisplay(headers.model, colModel) + headers.lastActive);
         for (const info of result.agents) {
             const name = info.name;
             const personal = info.personalName || '—';
-            const status = `${info.status || 'unknown'}${info.stale ? ' (stale)' : ''}`;
+            const lcSuffix = info.lifecycle && info.lifecycle !== 'active' ? ` (${info.lifecycle})` : '';
+            const status = `${info.status || 'unknown'}${info.stale ? ' (stale)' : ''}${lcSuffix}`;
             const channels = info.channels?.length > 0 ? info.channels.join(', ') : '—';
             const project = info.projectPath ? path.basename(info.projectPath) : '—';
             const baseagent = info.baseagent || '—';
+            const model = info.model || '—';
             const lastActive = info.lastActivity ? formatTimeAgo(Date.now() - info.lastActivity) : '—';
-            console.log(name.padEnd(colName) + personal.padEnd(colPersonal) + status.padEnd(colStatus) + channels.padEnd(colChannels) +
-                project.padEnd(colProject) + baseagent.padEnd(colBaseagent) + lastActive);
+            console.log(padEndDisplay(name, colName) + padEndDisplay(personal, colPersonal) +
+                padEndDisplay(status, colStatus) + padEndDisplay(channels, colChannels) +
+                padEndDisplay(project, colProject) + padEndDisplay(baseagent, colBaseagent) +
+                padEndDisplay(model, colModel) + lastActive);
         }
         return;
     }
@@ -697,7 +731,7 @@ Options:
                 console.log(`用法: ${MAIN_CLI_BIN} agent welcome show [--format json]
      ${MAIN_CLI_BIN} agent welcome --text <text> [--format json]
 
-读取或保存当前 Agent 在 Bootstrap 中经 Owner 确认的 welcome 文案。文案固定保存到 personal/welcome.md。`);
+读取或保存当前 Agent 在 Bootstrap 中自主准备的 welcome 文案。文案固定保存到 personal/welcome.md。`);
                 return;
             }
             const result = { ok: false, code: 'INVALID_ARGS', error: error.message };

package/dist/cli/agent.js

@@ -553,7 +553,7 @@ export async function agentPersona(aid, options = {}) {
         return { ok: false, code: 'WRITE_FAILED', error: e?.message || String(e) };
     }
 }
-/** Read or replace the current Agent's confirmed Bootstrap welcome template. */
+/** Read or replace the current Agent's self-prepared Bootstrap welcome template. */
 export async function agentWelcome(aid, options = {}) {
     if (!isValidAid(aid))
         return { ok: false, code: 'INVALID_ARGS', error: 'Invalid Agent AID' };