evolcore 0.0.19 → 0.0.21

package/dist/utils/project-path.js

@@ -53,8 +53,7 @@ export function defaultProjectsRoot(evolcoreRoot, options = {}) {
 export function agentProjectRootFromDefaults(defaults, evolcoreRoot, options = {}) {
     const platform = options.platform ?? process.platform;
     const pathImpl = pathForPlatform(platform);
-    const configuredRoot = defaults?.projects?.rootPath
-        || (defaults?.projects?.defaultPath && pathImpl.dirname(defaults.projects.defaultPath))
+    const configuredRoot = defaults?.projects?.defaultPath
         || defaultProjectsRoot(evolcoreRoot, options);
     return sanitizeProjectRoot(configuredRoot, options);
 }

package/dist/utils/stats.js

@@ -59,19 +59,11 @@ export class StatsCollector {
     recordEvent(record) {
         this.events.push(record);
     }
-    /**
-     * 获取统计快照。可选 agentName 过滤：未传则全局；传入则只统计该 agent。
-     * 自动裁剪 >1h 的事件。
-     */
-    getSnapshot(agentName) {
-        const now = Date.now();
+    trimExpiredEvents(now) {
         const cutoff = now - this.HOUR_MS;
-        // 裁剪过期事件
         this.events = this.events.filter(e => e.timestamp >= cutoff);
-        // 聚合统计（可按 agent 过滤）
-        const filtered = agentName === undefined
-            ? this.events
-            : this.events.filter(e => (e.agentName ?? '<unknown>') === agentName);
+    }
+    buildSnapshot(events, recentErrors, now) {
         let received = 0;
         let sent = 0;
         let completed = 0;
@@ -82,7 +74,7 @@ export class StatsCollector {
         let interrupts = 0;
         let totalDuration = 0;
         let durationCount = 0;
-        for (const event of filtered) {
+        for (const event of events) {
             switch (event.type) {
                 case 'received':
                     received++;
@@ -114,10 +106,6 @@ export class StatsCollector {
                     break;
             }
         }
-        // 最近错误：按 agent 过滤（与上面一致），取前 20 条
-        const recentErrors = (agentName === undefined
-            ? this.recentErrors
-            : this.recentErrors.filter(e => (e.agentName ?? '<unknown>') === agentName)).slice(0, 20);
         return {
             uptimeMs: now - this.startTime,
             lastHour: {
@@ -129,11 +117,57 @@ export class StatsCollector {
                 toolErrors,
                 toolErrorsByName,
                 interrupts,
-                avgResponseMs: durationCount > 0 ? totalDuration / durationCount : 0
+                avgResponseMs: durationCount > 0 ? totalDuration / durationCount : 0,
             },
-            recentErrors,
+            recentErrors: recentErrors.slice(0, 20),
         };
     }
+    /**
+     * 获取统计快照。可选 agentName 过滤：未传则全局；传入则只统计该 agent。
+     * 自动裁剪 >1h 的事件。
+     */
+    getSnapshot(agentName) {
+        const now = Date.now();
+        this.trimExpiredEvents(now);
+        // 聚合统计（可按 agent 过滤）
+        const filtered = agentName === undefined
+            ? this.events
+            : this.events.filter(e => (e.agentName ?? '<unknown>') === agentName);
+        // 最近错误：按 agent 过滤（与上面一致），取前 20 条
+        const recentErrors = (agentName === undefined
+            ? this.recentErrors
+            : this.recentErrors.filter(e => (e.agentName ?? '<unknown>') === agentName));
+        return this.buildSnapshot(filtered, recentErrors, now);
+    }
+    /**
+     * 一次扫描生成多个 Agent 的统计快照。用于高频 IPC 看板，避免对每个
+     * Agent 都重新过滤最近一小时的全部事件。
+     */
+    getSnapshots(agentNames) {
+        const now = Date.now();
+        this.trimExpiredEvents(now);
+        const buckets = new Map();
+        const recentErrorBuckets = new Map();
+        for (const agentName of new Set(agentNames)) {
+            buckets.set(agentName, []);
+            recentErrorBuckets.set(agentName, []);
+        }
+        for (const event of this.events) {
+            const bucket = buckets.get(event.agentName ?? '<unknown>');
+            if (bucket)
+                bucket.push(event);
+        }
+        for (const error of this.recentErrors) {
+            const bucket = recentErrorBuckets.get(error.agentName ?? '<unknown>');
+            if (bucket)
+                bucket.push(error);
+        }
+        const snapshots = new Map();
+        for (const [agentName, events] of buckets) {
+            snapshots.set(agentName, this.buildSnapshot(events, recentErrorBuckets.get(agentName) ?? [], now));
+        }
+        return snapshots;
+    }
 }
 export class AidStatsCollector {
     entries = new Map();

package/dist/utils/welcome.js

@@ -10,7 +10,7 @@
 import fs from 'fs';
 import { channelStatePath } from '../paths.js';
 import { loadAgent, saveAgent } from '../config-store.js';
-import { withLifecycleForWrite } from '../config/lifecycle.js';
+import { resolveAgentLifecycle, withLifecycleForWrite } from '../config/lifecycle.js';
 import { logger } from './logger.js';
 // ============================================================================
 // 欢迎消息生成
@@ -166,7 +166,7 @@ export class FirstInteractionWelcomeManager {
         // 懒加载并缓存 initialized 状态（避免每条消息都读取磁盘）
         if (this.initializedCache === null) {
             const agentConfig = loadAgent(this.agentAid);
-            this.initializedCache = agentConfig?.lifecycle === 'active';
+            this.initializedCache = !!agentConfig && resolveAgentLifecycle(agentConfig) === 'active';
         }
         // Agent 已初始化 → 所有用户都不需要欢迎消息
         if (this.initializedCache) {

package/kits/docs/INDEX.md

@@ -25,7 +25,7 @@
 | 文档 | 路径 | 说明 |
 |------|------|------|
 | 命令集目录 | `evolcore/INDEX.md` | msg/group/agent/aid/storage/ctl/rpc/bench 全集索引 |
-| 联系人命令 | `evolcore/contact.md` | Contact Book 拉黑与托管会话权限边界 |
+| 联系人命令 | `evolcore/contact.md` | Contact Book 添加申请、拉黑与托管会话权限边界 |
 
 ## 身份
 

package/kits/docs/evolcore/INDEX.md

@@ -35,7 +35,7 @@
 | `ec fs` | AUN 文件系统统一入口 | 上传/下载/看文件/列目录/删文件/配额/群空间 | 任意有渠道场景 | `fs.md` |
 | `ec storage` | 文件存储底层调试入口 | storage 调试/旧命令/底层上传下载 | 任意有渠道场景 | `storage.md` |
 | `ec agent` | EvolAgent 生命周期 | 创建/启停/热重载/改配置 | 管理员（owner/admin） | `agent.md` |
-| `ec contact` | Contact Book 与访问控制 | 拉黑/解除拉黑/查拉黑 | 读 owner/admin；写仅 owner | `contact.md` |
+| `ec contact` | Contact Book 与访问控制 | 申请添加、拉黑/解除拉黑、查拉黑 | Agent 当前私聊可申请添加；管理写操作按角色限制 | `contact.md` |
 | `ec rpc` | 底层 AUN RPC（逃生通道） | 直接调协议方法 | 高级/兜底 | `rpc.md` |
 
 ## 会话自管理类（不连 AUN，操作当前会话）

package/kits/docs/evolcore/contact.md

@@ -6,6 +6,7 @@
 ## 命令
 
 ```bash
+ec contact add <aid> --self <agent-aid>
 ec contact block <aid> --self <agent-aid>
 ec contact unblock <aid> --self <agent-aid>
 ec contact list --blocked --self <agent-aid>
@@ -16,9 +17,13 @@ ec contact list --blocked --self <agent-aid>
 ## 约束
 
 - `<aid>` 和 `--self` 必须是合法 AID。
+- Agent 托管会话中的 `add` 只能针对当前 AUN 私聊对端；它创建/更新 `pending`，并向本 Agent Owner 发送审核卡片。
+- `add` 复用 `/request` 的联系人申请额度、过期和请求版本校验；已有 `pending`/`declined` 条目会重新走申请流程。
+- Owner 在审核卡片点击“通过”后才变为 active；`blocked` 必须先执行 `unblock`。
+- 直接从本机终端执行 `add` 属于本地管理操作，会直接创建或恢复 active 联系人；Connect `action=add` 同样是管理端直接操作。
 - 写入 Agent Owner 时，系统会自动创建该 Owner 的 active 联系人记录。
 - `block/unblock` 只接受已存在的联系人；不存在时返回 `NOT_FOUND`。
-- `block/unblock` 只改变本 Agent 的入站接收策略，不代表对端也拉黑了本 Agent。
+- `block/unblock` 至少改变本 Agent 的入站接收策略；托管任务的普通私聊 `ec msg send` 对 blocked 目标也会在 daemon 侧被拒绝。非托管 AUN CLI 发送不读取本地联系人簿。不代表对端也拉黑了本 Agent。
 - Agent owner 不能被拉黑。
 - `list --blocked` 只列出当前 blocked contact，并返回 `contactRevision`。
 
@@ -31,6 +36,7 @@ ec contact list --blocked --self <agent-aid>
 | 操作 | owner | admin | 普通角色 |
 |---|---:|---:|---:|
 | `list --blocked` | 允许 | 允许 | 拒绝 |
+| Agent 会话 `add` 当前私聊对端 | 允许 | 允许 | 由当前关系授权，受 AUN 私聊和申请限制 |
 | `block` / `unblock` | 允许 | 拒绝 | 拒绝 |
 
 缺少、伪造、撤销或跨会话 delegation token 时失败关闭。托管调用的 `--self` 必须等于当前任务所属 Agent。

package/kits/docs/evolcore/msg.md

@@ -48,6 +48,20 @@ ec msg send <from> <to> --payload '<json>'
 - `--text <说>` — 附件说明文字（仅 `--file`）
 - `--transcript <text>` — 语音转写（仅 `--as voice`）
 
+托管 Agent 通过 daemon 发送时，若发送方使用 `policyMode: contacts`，私聊普通出站只允许 Owner 或实际 `active` 联系人。无条目、`pending`、`declined` 会拒绝发送并提示：
+
+```bash
+ec contact add <target-aid> --self <self-aid>
+```
+
+该命令在托管会话中会创建/更新联系人申请并给 Owner 发送审核卡片；`blocked` 目标必须先执行：
+
+```bash
+ec contact unblock <target-aid> --self <self-aid>
+```
+
+非托管环境的 `ec msg send` 是独立 AUN CLI 发送，不读取或要求 `agents/<aid>/config.json`，因此不会触发这套 Agent 联系人准入判断。
+
 在 EvolCore 会话内，发送还会经过当前 session 的 self/peer/role 鉴权。`visitor` 或 `member`
 默认只允许回复当前对端；从一个 agent 会话转发给第三个 agent 属于 relay 操作，可能因
 `ownPeerOnly` 被拒绝。没有成功 JSON 回执（含 `message_id`/`status`）不得声称已发送。
@@ -113,6 +127,8 @@ ec msg history <self-aid> <target-aid> \
 
 历史查询读取本地 `messages.jsonl`，不调用 `message.pull`，不会读取或推进网络收件箱游标。
 
+托管任务限制：只能使用当前 self AID，并且只能读取当前 AUN 私聊对端；群聊、非 AUN 渠道和其他对端都会被拒绝。托管任务不支持 `--channel`、`--channel-name`、`--aun-path` 或 `--app`，仅可使用 `--session`、`--limit`、`--before`、`--after`、`--direction` 和 `--format`。
+
 - 不传 `--session`：等价于 `--session latest`。
 - `--session latest`：使用该 AID 对 `active.json` 中的最新激活会话；找不到时直接报错。
 - `--session all`：包含该 AID 对全部本地历史以及没有会话标识的旧记录。

package/kits/rules/01-overview.md

@@ -140,7 +140,7 @@ evolcore 收到每条消息时，由**声明式 manifest** 决定加载哪些上
 | group（群聊） | rules + 身份层（**无 preferences**）+ 关系层（群）+ 环境层 + 渠道层 + 会话层 + baseagent |
 | bootstrapping | 仅 bootstrap 引导（不加载 rules、身份、关系、环境、渠道、会话、baseagent 或完整 commands 段） |
 
-> 常规段（包括 rules、session、baseagent）都要求 `lifecycle=active`。生命周期缺失或非法时，
+> 常规段（包括 rules、session、baseagent）都要求 `lifecycle=active`。生命周期缺失按 `active` 处理；非法时，
 > Manifest 不加载任何常规段；agent-owned turn 也不会直接落入普通 runner。
 
 三份 manifest 各管一段：`kits/eck_manifest.json`（system prompt 默认）、

package/kits/rules/03-identity.md

@@ -29,7 +29,7 @@
 
 ## 人格与行为规范怎么生效
 
-- **注入条件**是 `chatType ≠ null` 且 `lifecycle = active`（即明确处于正常运行阶段的渠道会话），不是"有没有注入 AID"。生命周期变量缺失时失败关闭，不注入身份层；本地 coding 模式也不注入。
+- **注入条件**是 `chatType ≠ null` 且 `lifecycle = active`（即处于正常运行阶段的渠道会话），不是"有没有注入 AID"。生命周期变量缺失时按 `active` 处理；非法生命周期仍失败关闭。本地 coding 模式也不注入。
 - persona.md 由 evolcore **自动前置**进 system prompt，你不需要主动 Read。
 - persona.md 缺失时**没有默认人格兜底**，只是这一段不出现；行为约束改由 `kits/rules/` + `roles/` 权限定义承担。
 - 改完 persona.md 后 `ec agent reload` 生效（mtime 门控缓存）。

package/kits/rules/05-venue.md

@@ -21,7 +21,7 @@
 | group | `chatType = group` 且 `lifecycle = active` | 同 private，但**无 preferences**；`groupId` 有值加群 profile，`groupRulesPath` 有值加群规则 | 自主模式，`mentionMode` 决定是否响应 |
 | bootstrapping | `lifecycle = bootstrapping` | 仅 bootstrap 引导（所有常规段均落选） | 初始化引导 |
 
-> coding 场景在 agent 明确 `active` 时才加载 `session` 与 `baseagent`；生命周期缺失或非法时按 fail-closed 处理。
+> coding 场景在 agent `active` 时加载 `session` 与 `baseagent`；生命周期缺失按 `active` 处理，非法时按 fail-closed 处理。
 
 ## 数据位置
 

package/kits/schemas/_meta.json

@@ -1,11 +1,11 @@
 {
   "schemas": {
-    "daemon":          { "currentVersion": 4 },
-    "defaults":        { "currentVersion": 4 },
-    "agent-config":    { "currentVersion": 10 },
+    "daemon":          { "currentVersion": 6 },
+    "defaults":        { "currentVersion": 5 },
+    "agent-config":    { "currentVersion": 11 },
     "relation-config": { "currentVersion": 8 },
     "contact-book":    { "currentVersion": 3 },
-    "single-session":  { "currentVersion": 2 },
+    "single-session":  { "currentVersion": 3 },
     "role-registry":   { "currentVersion": 1 },
     "role-config":     { "currentVersion": 1 }
   },
@@ -33,6 +33,7 @@
     { "schema": "agent-config",    "version": 7, "date": "2026-07-27", "description": "remove Session Renew effort; auxiliary inference is response-mode owned" },
     { "schema": "relation-config", "version": 6, "date": "2026-07-27", "description": "remove relation Session Renew effort; auxiliary inference is response-mode owned" },
     { "schema": "single-session",  "version": 2, "date": "2026-07-27", "description": "add optional baseagent-aware auxiliaryModel and auxiliaryEffort without factory defaults" },
+    { "schema": "single-session",  "version": 3, "date": "2026-08-31", "description": "move Session Renew auxiliary model and effort from mode buckets into baseagent settings" },
     { "schema": "daemon",          "version": 3, "date": "2026-07-29", "description": "make daemon.json the exclusive source for all process debug settings" },
     { "schema": "daemon",          "version": 4, "date": "2026-08-04", "description": "add configurable default AID domain for generated identities" },
     { "schema": "defaults",        "version": 3, "date": "2026-07-29", "description": "remove debug from the Agent configuration inheritance chain" },
@@ -42,6 +43,10 @@
     { "schema": "contact-book",    "version": 3, "date": "2026-07-29", "description": "add versioned contact requests and declined status" },
     { "schema": "defaults",        "version": 4, "date": "2026-08-02", "description": "add defaults-only fallback model chain" },
     { "schema": "agent-config",    "version": 10, "date": "2026-08-02", "description": "reject Agent-level fallback model chain" },
-    { "schema": "relation-config", "version": 8, "date": "2026-08-02", "description": "reject relation-level fallback model chain" }
+    { "schema": "relation-config", "version": 8, "date": "2026-08-02", "description": "reject relation-level fallback model chain" },
+    { "schema": "daemon",          "version": 5, "date": "2026-08-27", "description": "remove EvolCore AUN gateway override" },
+    { "schema": "daemon",          "version": 6, "date": "2026-09-01", "description": "unify local service lifecycle and AUN proxy settings under services[]" },
+    { "schema": "defaults",        "version": 5, "date": "2026-08-27", "description": "remove EvolCore AUN gateway override" },
+    { "schema": "agent-config",    "version": 11, "date": "2026-08-27", "description": "remove EvolCore AUN gateway override" }
   ]
 }

package/kits/schemas/agent-config.schema.10.json

@@ -61,13 +61,14 @@
     },
     "lifecycle": {
       "type": "string",
+      "default": "active",
       "enum": [
         "created",
         "bootstrapping",
         "active"
       ],
       "x-merge": "scalar",
-      "description": "agent 生命周期状态",
+      "description": "agent 生命周期状态；缺失时按 active 处理",
       "x-enumDescriptions": {
         "created": "已创建，尚未进入引导流程",
         "bootstrapping": "引导中（初始化配置/身份）",