evolclaw 3.1.3 → 3.1.4

package/CHANGELOG.md

@@ -1,5 +1,22 @@
 # Changelog
 
+## v3.1.4 (2026-05-27)
+
+### New Features
+
+- **CLI help 系统重构 + ECK 注入** — 全新 help 子命令体系，ECK（EvolClaw Kit）注入机制重构，AID identity 管理命令
+- **Menu 协议五动词拆分** — menu 协议拆分为 list/query/options/update/action 五个动词，命令收敛至 baseagent/session
+
+### Improvements
+
+- **npm-ops 去 CLI 依赖** — checkLatestVersion 改用 HTTP fetch 直接查 registry API，去除对 npm CLI 的运行时依赖
+- **agent.md 适配 SDK 0.3.3** — 统一 aun_path 到 EVOLCLAW_HOME，适配最新 SDK 版本
+
+### Bug Fixes
+
+- **Session channelType 缺失修复** — 修复 channelType 缺失导致 chat dir 无法解析 + isBackgroundSession 同步化
+- **SessionManager 查询路径 NPE** — 修复缺失 channelType 时的空指针异常
+
 ## v3.1.3 (2026-05-26)
 
 ### New Features

package/assets/.env.template

@@ -0,0 +1,4 @@
+# AUN 环境变量
+# 取消注释并填入值即可生效（进程已有的同名变量不会被覆盖）
+
+# AUN_ENCRYPTION_SEED=your-seed-here

package/assets/config.json.template

@@ -0,0 +1,6 @@
+{
+  "$schema_version": 1,
+  "aun": {
+    "encryptionSeed": null
+  }
+}

package/dist/agents/kit-renderer.js

@@ -14,20 +14,24 @@ const PARAM_DESCRIPTIONS = {
     peerId: '对端在该渠道的原生 ID',
     peerKey: '对端跨渠道唯一标识（channel#urlEncode(peerId)）',
     peerName: '对端显示名',
-    peerRole: '对端角色',
+    peerRole: '对端角色（owner/admin/guest/anonymous）',
+    peerType: '对端类型（human/agent）',
     groupId: '群组 ID（群聊时）',
-    scene: '场景类型',
-    chatType: '聊天类型',
-    channel: '当前渠道',
-    venueUid: 'venue 唯一标识',
-    project: '当前项目目录名（由 CURRENT_PROJECT 派生）',
+    chatType: '聊天类型（private=私聊 / group=群聊 / null=本地开发）',
+    channel: '渠道类型（aun/feishu/wechat/dingtalk/qqbot/wecom）',
+    venueUid: '场所唯一标识（预留）',
+    capabilities: '当前渠道支持的能力列表',
+    project: '当前项目目录名',
+    sessionId: 'evolclaw 会话 ID',
     sessionName: '会话名称',
-    chatmode: '会话模式（interactive/proactive）',
+    sessionCreatedAt: '会话创建时间（ISO）',
+    threadId: '话题 ID（多话题路由时）',
+    chatMode: '会话模式（interactive=同步交互 / proactive=主动推送）',
     readonly: '是否只读模式',
-    canSendFile: '当前渠道是否支持发文件',
-    capabilities: '渠道能力列表',
-    baseAgent: '当前 base agent 规范值（claude/codex/gemini/hermes）',
-    baseAgentName: '当前 base agent 显示名',
+    baseAgent: 'base agent 规范值（claude/codex/gemini/hermes）',
+    baseAgentName: 'base agent 显示名',
+    baseAgentModel: 'base agent 使用的模型',
+    agentSessionId: 'base agent 会话 ID',
 };
 function buildPathMappings(vars) {
     const pkgRoot = getPackageRoot();
@@ -276,17 +280,27 @@ function isTruthy(val) {
 }
 // CHUNK_CONTINUE_6
 // ── Template rendering ──
+function resolveConditions(template, vars) {
+    // Find innermost {{?...}}...{{/}} block (no nested {{? inside) and resolve it.
+    // Repeat until no blocks remain.
+    const inner = /\{\{\?(\w+)(?:(!=|=)([^}]*))?\}\}([^]*?)\{\{\/\}\}/;
+    let result = template;
+    let prev;
+    do {
+        prev = result;
+        result = result.replace(inner, (_match, key, op, value, body) => {
+            if (op === '=')
+                return String(vars[key]) === value ? body : '';
+            if (op === '!=')
+                return String(vars[key]) !== value ? body : '';
+            return isTruthy(vars[key]) ? body : '';
+        });
+    } while (result !== prev);
+    return result;
+}
 function renderTemplate(template, vars) {
-    // Pass 1: conditional sections {{?key=value}}, {{?key!=value}}, {{?key}}...{{/}}
-    let result = template.replace(/\{\{\?(\w+)(!=|=)([^}]*)?\}\}([\s\S]*?)\{\{\/\}\}/g, (_match, key, op, value, body) => {
-        if (op === '!=')
-            return String(vars[key]) !== value ? body : '';
-        return String(vars[key]) === value ? body : '';
-    });
-    // Pass 1b: truthy-only {{?key}}...{{/}}
-    result = result.replace(/\{\{\?(\w+)\}\}([\s\S]*?)\{\{\/\}\}/g, (_match, key, body) => {
-        return isTruthy(vars[key]) ? body : '';
-    });
+    // Pass 1: resolve nested conditionals inside-out
+    let result = resolveConditions(template, vars);
     // Pass 2: variable substitution {{key}}
     result = result.replace(/\{\{(\w+)\}\}/g, (_match, key) => {
         const val = vars[key];

package/dist/aun/aid/agentmd.js

@@ -1,6 +1,6 @@
 import fs from 'fs';
 import path from 'path';
-import { getAunClient } from './client.js';
+import { getAunClient, createAunClient } from './client.js';
 import { agentMdPath, aidLocalDir, resolveRoot } from '../../paths.js';
 export function buildInitialAgentMd(opts) {
     const agentName = opts.aid.split('.')[0];
@@ -82,66 +82,37 @@ async function verifyContent(content, aid, certPem, client) {
  * Create a bare AUNClient (no createAid) for read-only operations.
  */
 async function createBareClient(aunPath) {
-    const p = aunPath ?? resolveRoot();
-    const { AUNClient } = await import('@agentunion/fastaun');
-    const caCertPath = path.join(p, 'CA', 'root', 'root.crt');
-    const clientOpts = { aun_path: p, debug: false };
-    if (fs.existsSync(caCertPath))
-        clientOpts.root_ca_path = caCertPath;
-    return new AUNClient(clientOpts);
+    return createAunClient({ aunPath });
 }
 export async function agentmdGet(aid, opts) {
     const aunPath = opts?.aunPath ?? resolveRoot();
-    const localPath = agentMdPath(aid);
-    // === Path A: local agent.md exists ===
-    if (fs.existsSync(localPath)) {
-        const content = fs.readFileSync(localPath, 'utf-8');
-        if (!opts?.withVerification)
-            return content;
-        // Verify local content
-        const client = opts?.client ?? await createBareClient(aunPath);
-        const ownClient = !opts?.client;
-        try {
-            const certPem = await obtainCertPem(aid, aunPath, client);
-            const verification = await verifyContent(content, aid, certPem, client);
-            if (verification.status !== 'invalid') {
-                return { content, verification };
-            }
-            // Fallback: local invalid → try remote
-            try {
-                const info = await client.fetchAgentMd(aid);
-                const remote = info.content;
-                if (remote) {
-                    const remoteVerification = await verifyContent(remote, aid, certPem, client);
-                    if (remoteVerification.status === 'verified') {
-                        fs.writeFileSync(localPath, remote, 'utf-8');
-                        return { content: remote, verification: remoteVerification };
-                    }
-                }
-            }
-            catch { /* remote fetch failed, return local invalid result */ }
-            return { content, verification };
-        }
-        finally {
-            if (ownClient)
-                try {
-                    await client.close();
-                }
-                catch { /* ignore */ }
-        }
-    }
-    // === Path B: no local agent.md → download from remote ===
     const client = opts?.client ?? await createBareClient(aunPath);
     const ownClient = !opts?.client;
+    const localPath = agentMdPath(aid);
     try {
-        const info = await client.fetchAgentMd(aid);
-        const raw = info.content;
-        if (!opts?.withVerification) {
-            return raw;
+        // Try SDK fetch (auto-saves locally + verifies signature)
+        let content;
+        let verification;
+        try {
+            const info = await client.fetchAgentMd(aid);
+            content = info.content;
+            const sig = info.signature ?? {};
+            const status = sig.status === 'verified' ? 'verified' : sig.status === 'unsigned' ? 'unsigned' : 'invalid';
+            verification = { status, ...(sig.reason ? { reason: String(sig.reason) } : {}) };
         }
-        const certPem = await obtainCertPem(aid, aunPath, client);
-        const verification = await verifyContent(raw, aid, certPem, client);
-        return { content: raw, verification };
+        catch (err) {
+            // Network failed — fall back to local file (verify signature via SDK if requested)
+            if (!fs.existsSync(localPath))
+                throw err;
+            content = fs.readFileSync(localPath, 'utf-8');
+            if (opts?.withVerification) {
+                const certPem = await obtainCertPem(aid, aunPath, client);
+                verification = await verifyContent(content, aid, certPem, client);
+            }
+        }
+        if (!opts?.withVerification)
+            return content;
+        return { content: content, verification: verification ?? { status: 'unsigned' } };
     }
     finally {
         if (ownClient)

package/dist/aun/aid/client.js

@@ -1,6 +1,5 @@
 import fs from 'fs';
 import path from 'path';
-import os from 'os';
 import { fileURLToPath } from 'url';
 import { execFileSync } from 'child_process';
 import { isWindows } from '../../utils/cross-platform.js';
@@ -25,7 +24,7 @@ export function suppressSdkLogs() {
         return; process.stderr.write(args.map(String).join(' ') + '\n'); };
 }
 // ==================== Constants ====================
-export const MIN_AUN_CORE_SDK = [0, 2, 17];
+export const MIN_AUN_CORE_SDK = [0, 3, 3];
 export const AUN_CORE_SDK_PKG = '@agentunion/fastaun';
 // ==================== SDK & Environment ====================
 function compareVersion(a, min) {
@@ -114,15 +113,31 @@ export async function downloadCaRoot(aunPath, gatewayUrl, indent = '') {
         return false;
     }
 }
-// ==================== AUNClient Factory ====================
-export async function getAunClient(aid, opts) {
-    const aunPath = opts?.aunPath ?? path.join(os.homedir(), '.aun');
+/**
+ * 统一构造 AUNClient：自动绑 root_ca_path + setAgentMdPath(aidsDir())。
+ * 不做 createAid / authenticate / connect，调用方按需续作。
+ *
+ * 所有 new AUNClient 调用都应走此工厂，避免 SDK 默认把 agent.md 写到
+ * {aun_path}/AgentMDs（默认目录）。
+ */
+export async function createAunClient(opts = {}) {
+    const { aunPath: defaultAunPath, aidsDir } = await import('../../paths.js');
+    const aunPath = opts.aunPath ?? defaultAunPath();
     const caCertPath = path.join(aunPath, 'CA', 'root', 'root.crt');
     const { AUNClient } = await import('@agentunion/fastaun');
-    const clientOpts = { aun_path: aunPath, debug: false };
+    const clientOpts = { aun_path: aunPath, debug: opts.debug ?? false };
     if (fs.existsSync(caCertPath))
         clientOpts.root_ca_path = caCertPath;
-    const client = new AUNClient(clientOpts);
+    if (opts.encryptionSeed)
+        clientOpts.encryption_seed = opts.encryptionSeed;
+    const client = opts.aunSdkLog !== undefined
+        ? new AUNClient(clientOpts, opts.aunSdkLog)
+        : new AUNClient(clientOpts);
+    client.setAgentMdPath(aidsDir());
+    return client;
+}
+export async function getAunClient(aid, opts) {
+    const client = await createAunClient({ aunPath: opts?.aunPath });
     await client.auth.createAid({ aid });
     return client;
 }