evolcore 0.0.20 → 0.0.22

package/CHANGELOG.md

@@ -3,6 +3,71 @@
 本文件记录 EvolCore 的重要变更。EvolClaw 版本线的历史记录已归档至
 [`docs/_archive/CHANGELOG-evolclaw.md`](docs/_archive/CHANGELOG-evolclaw.md)。
 
+## 0.0.22 (2026-09-05)
+
+### 话题续接与触发任务
+
+- 完善话题 `/renew` 的并发屏障、后端身份校验和辅助模型配置迁移，避免续接期间旧任务或旧后端结果串入新话题。
+- 完善 Fullaccess Trigger 的持久授权、批准状态、CLI 参数和调度运行时，统一 daemon-owner 身份与审计关联。
+
+### Bootstrap、会话与消息队列
+
+- 增强 Agent 创建规划、Bootstrap 完成鉴权和欢迎消息投递，补齐生命周期门禁、事件记录与失败恢复。
+- 完善消息队列、会话恢复、跨会话 Handoff 和响应引擎的状态收敛，降低重启、续接与并发操作造成的消息丢失或重复处理。
+
+### 服务配置与消息管理
+
+- 统一本机服务和 AUN Service Proxy 的配置读取、schema 与旧版迁移，并贯通 Agent 启动和 IPC 管理链路。
+- 完善 `ec msg history` 按渠道实例和原生对端 ID 查询历史的参数传递、权限校验与结果处理。
+
+### AUN 投递、联系人与观察者
+
+- 完善 Outbox 投递状态、消息回执、永久失败诊断和路由变更保护，避免迟到结果误删已调整路由的待发消息。
+- 强化联系人申请、Owner 审核以及托管私聊入站/出站准入，补齐拒绝原因与审计信息。
+- 修复 Observer 消息转发的异步时序，并按群成员关系过滤重复通知。
+
+### Codex 权限与跨平台安全
+
+- 强化 Codex Shell 命令解析、委派校验、工具摘要和受保护路径策略，明确受管运行身份与权限决策证据。
+- 修复 Windows Codex managed hook 的动态 IPC 校验与安装配置，统一 proactive hook 可用性检查并保持 H-class/L-class 保护边界。
+- 修正 Codex Windows 文件系统 glob 规则，改善受管临时目录和锁目录的跨平台匹配。
+- 统一 BaseAgent 请求地址和身份请求头传递，完善 Codex 会话启动、重连与错误诊断。
+- 完善 Codex 子代理的上下文继承、权限传递和任务生命周期收敛，并贯通工具调用标识与授权审计。
+- 为受信任的 root Fullaccess Claude 会话显式设置沙箱标记，并限制复杂 PowerShell carrier 的摘要解包范围。
+
+### Windows IPC 与运行稳定性
+
+- 统一 Windows IPC 端点路径规范和跨进程命名管道连接，修复实例 socket 路径在不同运行入口间不一致的问题。
+- 修复 Windows 配置与联系人数据的锁竞争，支持安全识别并回收损坏或遗留锁文件。
+- 强化 Windows Shell 签名信任校验，在允许受信任命令执行的同时收紧受管命令边界。
+
+### Trigger 与监控收敛
+
+- 确保 daemon Trigger 在错误已经渲染后仍发送明确终态，并传播中断生命周期元数据、统一中断结果分类。
+- EC Web Monitor 按订阅生命周期启停进程树采样，避免无订阅时持续采集。
+
+## 0.0.21 (2026-09-03)
+
+### 话题与权限控制
+
+- 新增话题 `/renew`，支持在空闲状态下安全续接话题后端会话，并强化并发操作与异常恢复处理。
+- 新增 `/fa`、`/fullaccess` 和持久 Fullaccess Trigger，统一 daemon-owner 授权、可信运行身份与审计记录。
+
+### 服务与消息管理
+
+- 统一本机服务和 AUN Service Proxy 的配置与旧版迁移，支持按实例配置本机服务及代理。
+- `ec msg history` 支持按完整渠道实例和原生对端 ID 查询已落盘的非 AUN 私聊历史。
+
+### AUN 投递与联系人
+
+- 完善 AUN Outbox 投递与回执处理，覆盖排队、重试、过期和永久失败等状态。
+- 新增联系人申请与 Owner 审核流程，并将联系人策略应用到托管私聊的入站和出站准入。
+
+### 安全与运行兼容
+
+- 加固 Codex Shell 载体解析、受管权限校验和受保护路径沙箱边界，并将受保护路径策略归入权限模块。
+- 统一 BaseAgent 请求地址和身份请求头处理，升级 AUN SDK 至 0.5.10，并兼容 Node.js 22.16.0。
+
 ## 0.0.20 (2026-08-28)
 
 ### AUN 网关与投递可靠性

package/README.md

@@ -78,7 +78,7 @@ ResponseEngine.processMessage()
 ### 环境要求
 
 - **操作系统**：macOS / Linux / Windows
-- **Node.js** >= 22.19.0（依赖 `node:sqlite`）
+- **Node.js** >= 22.16.0（依赖 `node:sqlite`，并与 AUN SDK 要求保持一致）
 - **Claude Code** >= 2.1.32（`npm install -g @anthropic-ai/claude-code`）
 
 ### 1. 安装
@@ -143,7 +143,7 @@ ec init aun
 ```
 
 交互式引导完成以下配置：
-- 环境检查（Node.js >= 22、claude CLI、SDK 版本）
+- 环境检查（Node.js >= 22.16.0、claude CLI、SDK 版本）
 - 渠道选择（飞书 / 微信 / 钉钉 / QQ 频道 / 企业微信 / AUN）并扫码登录
 - 默认项目路径
 - 模型选择（sonnet/opus/haiku）
@@ -177,8 +177,8 @@ ec init aun
 - `model`：配置文件 → `~/.claude/settings.json` → 默认 `sonnet`
 - `effort`：配置文件 → `~/.claude/settings.json` → SDK 默认值（`auto`）
 
-Claude/Codex 兼容网关需要额外请求头或查询参数时，可以直接在 EvolCore 的
-`baseagents` 配置中设置，不需要修改 Claude/Codex 的全局配置文件：
+Claude、Codex 或 EC Agent 兼容网关需要额外请求头或查询参数时，可以直接在 EvolCore 的
+`baseagents` 配置中设置，不需要修改各 base agent 的全局配置文件：
 
 ```json
 {
@@ -200,6 +200,15 @@ Claude/Codex 兼容网关需要额外请求头或查询参数时，可以直接
       "queryParams": {
         "source": "evolcore"
       }
+    },
+    "ecagent": {
+      "baseUrl": "https://example.com/ecagent/v1",
+      "headers": {
+        "X-Tenant-Id": "${TENANT_ID}"
+      },
+      "queryParams": {
+        "source": "evolcore"
+      }
     }
   }
 }
@@ -207,9 +216,48 @@ Claude/Codex 兼容网关需要额外请求头或查询参数时，可以直接
 
 `${VAR}` 会按 EvolCore 的环境变量规则展开。Claude 通过 `ANTHROPIC_CUSTOM_HEADERS`
 传递 Header；Codex app-server 启动时由 EvolCore 注入 `env_http_headers` 和
-`query_params`，所以不需要手改 `~/.codex/config.toml`。`queryParams` 不应放置密钥等敏感信息。
+`query_params`；EC Agent 主推理、模型列表和辅助推理直接在请求 URL 上追加参数。
+因此不需要手改 Claude/Codex 的全局配置文件。`queryParams` 不应放置密钥等敏感信息。
+
+完整设计、运行链路和排障说明见：[Baseagent 自定义请求元数据技术文档](docs/baseagent-request-metadata.md)。
+
+### Baseagent 模型与备用链
+
+Session Renew 的辅助模型配置与主模型、推理强度放在同一个
+`baseagents.<baseagent>` 块中，与 `responseMode` 正交。主模型故障备用链
+`fallbackModels` 只在 `agents/defaults.json` 中配置：
+
+```jsonc
+{
+  "baseagents": {
+    "claude": {
+      "model": "claude-opus",
+      "effort": "medium",
+      "auxiliaryModel": "claude-haiku-4-5-20251001",
+      "auxiliaryEffort": "low",
+      "fallbackModels": [
+        { "model": "claude-sonnet-4-5", "effort": "medium" },
+        { "model": "claude-haiku-4-5", "effort": "low" }
+      ]
+    },
+    "codex": {
+      "model": "gpt-5.6",
+      "effort": "high",
+      "auxiliaryModel": "gpt-5.6-sol",
+      "auxiliaryEffort": "medium",
+      "fallbackModels": [
+        { "model": "gpt-5.4", "effort": "medium" }
+      ]
+    }
+  }
+}
+```
+
+`auxiliaryEffort` 必须与同一 baseagent 块中的 `auxiliaryModel` 一起配置；未配置辅助模型时，
+Session Renew 按 `session_renew.fallback_action` 处理。`fallbackModels` 不会被辅助推理使用。
 
-完整设计、运行链路和排障说明见：[Claude/Codex 自定义请求元数据技术文档](docs/baseagent-request-metadata.md)。
+升级旧版本时，daemon 启动前会自动把模式桶中的辅助字段迁移到对应的 baseagent 块并创建备份。
+迁移逻辑集中在 `src/config/schema-migration.ts`，运行时不会回退读取旧字段。
 
 ### 3. 运行
 
@@ -269,10 +317,11 @@ evolcore/
 │   │   │   ├── session-fs-store.ts # 文件系统存储原语
 │   │   │   └── session-manager.ts  # 会话管理（多项目支持）
 │   │   ├── auth/                   # 授权审计与 Trigger 鉴权
+│   │   ├── permission/             # 权限策略与沙箱边界
+│   │   │   └── protected-paths.ts  # 受保护路径分级
 │   │   ├── evolagent.ts            # EvolAgent 实体
 │   │   ├── evolagent-registry.ts   # Agent 注册表（扫描/路由/热重载）
-│   │   ├── interaction-router.ts   # 卡片交互回调路由
-│   │   └── protected-paths.ts      # 受保护路径分级
+│   │   └── interaction-router.ts   # 卡片交互回调路由
 │   ├── channels/
 │   │   ├── feishu.ts               # 飞书 WebSocket 渠道
 │   │   ├── wechat.ts               # 微信 ClawBot 渠道
@@ -380,7 +429,7 @@ v3.2 新增进程级身份标识。启动时自动生成 `ec+5位数字.agentid.
 
 ## 技术栈
 
-- **运行时**：Node.js >= 22 + TypeScript（ES modules）
+- **运行时**：Node.js >= 22.16.0 + TypeScript（ES modules）
 - **AI 后端**：@anthropic-ai/claude-agent-sdk 0.3.220（固定版本）、Codex CLI app-server、Gemini CLI
 - **消息渠道**：飞书（@larksuiteoapi/node-sdk）、微信（ClawBot ilink API）、钉钉（dingtalk-stream）、QQ频道（pure-qqbot）、企业微信（AI Bot API）、AUN 网络
 - **数据存储**：文件系统（per-chat 目录） + JSONL（CLI 共用）

package/bin/codex-managed-hook.mjs

@@ -80,6 +80,9 @@ async function main() {
     threadId: input.session_id,
     toolName: input.tool_name,
     toolInput: input.tool_input ?? null,
+    ...(typeof (input.tool_use_id ?? input.toolUseId ?? input.item_id ?? input.itemId) === 'string'
+      ? { callId: input.tool_use_id ?? input.toolUseId ?? input.item_id ?? input.itemId }
+      : {}),
   });
   if (!result) {
     deny('EvolCore policy service is unavailable.');

package/bin/install-codex-managed-hooks.mjs

@@ -231,7 +231,9 @@ function main() {
   content = setTomlKey(content, 'features', 'hooks', 'true');
   content = setTomlKey(content, 'hooks', 'windows_managed_dir', tomlString(path.resolve(targetDirectory)));
   if (!content.endsWith('\n')) content += '\n';
-  const command = `${windowsCommandArg(nodePath)} ${windowsCommandArg(hookPath)}`;
+  // Windows hook command must include %EVOLCORE_INSTANCE_SOCKET% so Codex
+  // expands it at runtime with the per-daemon socket path
+  const command = `${windowsCommandArg(nodePath)} ${windowsCommandArg(hookPath)} %EVOLCORE_INSTANCE_SOCKET%`;
   content += [
     markerStart,
     '[[hooks.PreToolUse]]',

package/dist/agents/baseagent.js

@@ -28,12 +28,16 @@ const BASEAGENT_ALIASES = {
     geminicli: { canonical: 'gemini', displayName: 'Gemini CLI' },
     ecagent: { canonical: 'ecagent', displayName: 'ecagent' },
     'ec-agent': { canonical: 'ecagent', displayName: 'ecagent' },
-    hermes: { canonical: 'hermes', displayName: 'Hermes' },
 };
+const SUPPORTED_BASEAGENTS = new Set(['claude', 'codex', 'gemini', 'ecagent']);
 export function normalizeBaseagent(input) {
     const key = String(input || '').trim().toLowerCase().replace(/_/g, '-');
     return BASEAGENT_ALIASES[key] || { canonical: 'unknown', displayName: input ? String(input) : 'Unknown' };
 }
+export function isSupportedBaseagent(input) {
+    const key = String(input || '').trim().toLowerCase();
+    return SUPPORTED_BASEAGENTS.has(key);
+}
 function directInferencePair(apiKey, baseUrl) {
     const normalizedApiKey = directInferenceValue(apiKey);
     const normalizedBaseUrl = directInferenceValue(baseUrl);
@@ -232,7 +236,7 @@ export function resolveOpenaiDirectConfig(override) {
         }
         : undefined;
 }
-export function resolveOpenaiConfig(config, override) {
+export function resolveOpenaiConfig(config, override, runtime) {
     const codexSettings = loadCodexSettings();
     const isPlaceholder = (v) => !v || v.includes('your-') || v.includes('placeholder');
     const overrideApiKey = isPlaceholder(override?.apiKey) ? undefined : override?.apiKey;
@@ -279,8 +283,8 @@ export function resolveOpenaiConfig(config, override) {
         effort,
         enableRequestUserInput,
         approvalsReviewer,
-        evolcoreAgentAid: override?.evolcoreAgentAid ?? config.agents?.codex?.evolcoreAgentAid,
-        evolcoreAgentConfig: override?.evolcoreAgentConfig ?? config.agents?.codex?.evolcoreAgentConfig,
+        agentAid: runtime?.agentAid,
+        agentConfig: runtime?.agentConfig,
     };
 }
 export function resolveGoogleConfig(config, override) {
@@ -328,18 +332,18 @@ export function resolveEcagentConfig(config, override) {
         || DEFAULT_ECAGENT_BASE_URL;
     const model = override?.model || configured?.model || DEFAULT_ECAGENT_MODEL;
     const headers = normalizeStringMap(override?.headers ?? configured?.headers, 'headers');
+    const queryParams = normalizeStringMap(override?.queryParams ?? configured?.queryParams, 'queryParams');
     const effort = override?.effort ?? configured?.effort;
     const numberOr = (value, fallback) => (typeof value === 'number' && Number.isFinite(value) && value >= 0 ? value : fallback);
     return {
         apiKey,
         baseUrl,
         headers,
+        queryParams,
         model,
         effort,
         timeoutMs: numberOr(override?.timeoutMs ?? configured?.timeoutMs, DEFAULT_ECAGENT_TIMEOUT_MS),
         maxRetries: numberOr(override?.maxRetries ?? configured?.maxRetries, DEFAULT_ECAGENT_MAX_RETRIES),
         maxRetryDelayMs: numberOr(override?.maxRetryDelayMs ?? configured?.maxRetryDelayMs, DEFAULT_ECAGENT_MAX_RETRY_DELAY_MS),
-        evolcoreAgentAid: configured?.evolcoreAgentAid,
-        evolcoreAgentConfig: configured?.evolcoreAgentConfig,
     };
 }