evolclaw 2.8.2 → 3.0.0

package/dist/ipc.js

@@ -9,6 +9,8 @@ export class IpcServer {
     commandExecutor;
     server = null;
     agentRegistry;
+    aunAidProvider;
+    aunAidStatsProvider;
     constructor(socketPath, getStatus, commandExecutor) {
         this.socketPath = socketPath;
         this.getStatus = getStatus;
@@ -18,6 +20,14 @@ export class IpcServer {
     setAgentRegistry(registry) {
         this.agentRegistry = registry;
     }
+    /** Inject AUN AID state aggregator for aun-aids IPC handler */
+    setAunAidProvider(provider) {
+        this.aunAidProvider = provider;
+    }
+    /** Inject AUN AID stats provider for aun-aid-stats IPC handler */
+    setAunAidStatsProvider(provider) {
+        this.aunAidStatsProvider = provider;
+    }
     start() {
         // Remove stale socket file (Unix only — named pipes auto-cleanup on process exit)
         if (!isNamedPipe(this.socketPath)) {
@@ -79,6 +89,14 @@ export class IpcServer {
                 return this.getStatus();
             case 'ping':
                 return { pong: true, pid: process.pid };
+            case 'aun-aids': {
+                const aids = this.aunAidProvider ? this.aunAidProvider() : [];
+                return { ok: true, aids };
+            }
+            case 'aun-aid-stats': {
+                const stats = this.aunAidStatsProvider ? this.aunAidStatsProvider() : [];
+                return { ok: true, stats };
+            }
             case 'ctl': {
                 if (!this.commandExecutor)
                     return { ok: false, error: 'ctl not configured' };
@@ -129,6 +147,37 @@ export class IpcServer {
                     return { ok: false, error: e?.message || String(e) };
                 }
             }
+            case 'evolagent.load': {
+                if (!this.agentRegistry)
+                    return { ok: false, error: 'EvolAgentRegistry not available' };
+                const aid = cmd.aid;
+                if (!aid || typeof aid !== 'string')
+                    return { ok: false, error: 'missing aid' };
+                const hotLoad = globalThis.__evolclaw_hotLoadAgent;
+                if (!hotLoad)
+                    return { ok: false, error: 'Hot-load handler not initialized' };
+                try {
+                    await hotLoad(aid);
+                    return { ok: true, result: `Agent "${aid}" loaded and online` };
+                }
+                catch (e) {
+                    return { ok: false, error: e?.message || String(e) };
+                }
+            }
+            case 'evolagent.resync': {
+                if (!this.agentRegistry)
+                    return { ok: false, error: 'EvolAgentRegistry not available' };
+                const resync = globalThis.__evolclaw_resyncAgents;
+                if (!resync)
+                    return { ok: false, error: 'Resync handler not initialized' };
+                try {
+                    const results = await resync();
+                    return { ok: true, results };
+                }
+                catch (e) {
+                    return { ok: false, error: e?.message || String(e) };
+                }
+            }
             default:
                 return { error: `unknown command: ${cmd.type}` };
         }

package/dist/paths.js

@@ -10,7 +10,7 @@ export function resolveRoot() {
     if (process.env.EVOLCLAW_HOME) {
         _root = process.env.EVOLCLAW_HOME;
     }
-    else if (fs.existsSync(path.join(process.cwd(), 'data', 'evolclaw.json'))) {
+    else if (fs.existsSync(path.join(process.cwd(), 'agents', 'defaults.json'))) {
         _root = process.cwd();
     }
     else {
@@ -26,31 +26,104 @@ export function resolvePaths() {
     const root = resolveRoot();
     return {
         root,
-        config: path.join(root, 'data', 'evolclaw.json'),
-        configSample: path.join(root, 'data', 'evolclaw.sample.json'),
-        db: path.join(root, 'data', 'sessions.db'),
-        pid: path.join(root, 'logs', 'evolclaw.pid'),
+        sessionsDir: path.join(root, 'data', 'sessions'),
+        instanceDir: path.join(root, 'data', 'instance'),
+        outboxDir: path.join(root, 'data', 'outbox'),
         dataDir: path.join(root, 'data'),
         logs: path.join(root, 'logs'),
         agentsDir: path.join(root, 'agents'),
         lineStats: path.join(root, 'logs', 'line-stats.log'),
-        readySignal: path.join(root, 'logs', 'ready.signal'),
+        readySignal: path.join(root, 'data', 'instance', 'ready.signal'),
         selfHealLog: path.join(root, 'logs', 'self-heal.md'),
-        socket: resolveSocketPath(root),
+        socket: resolveInstanceSocketPath(root),
+        // ── 新结构（evolclaw-home-directory.md）────────────────
+        defaultsConfig: path.join(root, 'agents', 'defaults.json'),
+        kitsDir: path.join(root, 'kits'),
+        kitsAunDir: path.join(root, 'kits', 'aun'),
+        kitsChannelsDir: path.join(root, 'kits', 'channels'),
+        kitsEvolclawDir: path.join(root, 'kits', 'evolclaw'),
+        kitsTemplatesDir: path.join(root, 'kits', 'templates'),
+        instanceReadySignal: path.join(root, 'data', 'instance', 'ready.signal'),
+        instanceSocket: resolveInstanceSocketPath(root),
     };
 }
-function resolveSocketPath(root) {
+// ── per-agent 路径（参数化，不进 resolvePaths() 的固定 map）──
+export function agentDir(aid) {
+    return path.join(resolveRoot(), 'agents', aid);
+}
+export function agentConfig(aid) {
+    return path.join(agentDir(aid), 'config.json');
+}
+export function agentPersonalDir(aid) {
+    return path.join(agentDir(aid), 'personal');
+}
+export function agentIdentitiesDir(aid) {
+    return path.join(agentDir(aid), 'identities');
+}
+export function agentVenuesDir(aid) {
+    return path.join(agentDir(aid), 'venues');
+}
+export function agentSessionsDir(aid) {
+    return path.join(agentDir(aid), 'sessions');
+}
+export function agentDataDir(aid) {
+    return path.join(agentDir(aid), 'data');
+}
+export function agentDataCacheDir(aid) {
+    return path.join(agentDataDir(aid), 'cache');
+}
+export function agentTriggersDir(aid) {
+    return path.join(resolveRoot(), 'data', 'triggers', aid);
+}
+function resolveInstanceSocketPath(root) {
     if (isWindows) {
         const hash = crypto.createHash('sha1').update(root).digest('hex').slice(0, 12);
         return `\\\\.\\pipe\\evolclaw-${hash}`;
     }
-    return path.join(root, 'logs', 'evolclaw.sock');
+    return path.join(root, 'data', 'instance', 'evolclaw.sock');
 }
 export function ensureDataDirs() {
     const p = resolvePaths();
     fs.mkdirSync(p.dataDir, { recursive: true });
     fs.mkdirSync(p.logs, { recursive: true });
     fs.mkdirSync(p.agentsDir, { recursive: true });
+    fs.mkdirSync(p.sessionsDir, { recursive: true });
+    fs.mkdirSync(p.instanceDir, { recursive: true });
+    fs.mkdirSync(p.outboxDir, { recursive: true });
+    fs.mkdirSync(p.kitsDir, { recursive: true });
+}
+/**
+ * 首次启动或升级时，把包内 kits/ 复制到 EVOLCLAW_HOME/kits/。
+ * 策略：如果目标 kits/ 为空或包版本更新，整体覆盖。
+ */
+export function syncKitsFromPackage() {
+    const p = resolvePaths();
+    const srcKits = path.join(getPackageRoot(), 'kits');
+    if (!fs.existsSync(srcKits))
+        return;
+    const destKits = p.kitsDir;
+    // 包内自用场景：EVOLCLAW_HOME 等于包根（开发仓 / 用户家目录恰好是安装目录），
+    // src === dest 会让 cpSync 抛 ERR_FS_CP_EINVAL。直接跳过同步。
+    if (path.resolve(srcKits) === path.resolve(destKits))
+        return;
+    // 用 .kits-version 文件跟踪已安装的版本
+    const versionFile = path.join(destKits, '.kits-version');
+    const pkgJsonPath = path.join(getPackageRoot(), 'package.json');
+    let pkgVersion = '0.0.0';
+    try {
+        pkgVersion = JSON.parse(fs.readFileSync(pkgJsonPath, 'utf-8')).version || '0.0.0';
+    }
+    catch { }
+    let installedVersion = '';
+    try {
+        installedVersion = fs.readFileSync(versionFile, 'utf-8').trim();
+    }
+    catch { }
+    if (installedVersion === pkgVersion)
+        return;
+    // 递归复制（覆盖）
+    fs.cpSync(srcKits, destKits, { recursive: true, force: true });
+    fs.writeFileSync(versionFile, pkgVersion, 'utf-8');
 }
 export function getPackageRoot() {
     // import.meta.dirname is available in Node.js 21.2+ and always returns

package/dist/types.js

@@ -3,5 +3,11 @@
 // Array form: `name` is required to distinguish instances.
 /** Default permission mode applied to new sessions. Change here to affect all roles. */
 export const DEFAULT_PERMISSION_MODE = 'bypass';
-/** Reserved agent name used for DefaultAgent (no agent.json file). */
-export const DEFAULT_AGENT_NAME = '[default]';
+/** Placeholder agent name for legacy code paths that haven't been migrated. */
+export const DEFAULT_AGENT_NAME = '<unknown>';
+// ── 新结构：defaults.json + per-agent config.json（evolclaw-home-directory.md）──
+//
+// 旧 Config / EvolAgentConfig 保留至阶段 3 退场。新结构的承载是
+// DefaultsConfig（agents/defaults.json）+ AgentConfig（agents/<aid>/config.json），
+// 由 ConfigStore 加载并算 effective merged 值。
+export const CONFIG_SCHEMA_VERSION = 1;

package/dist/utils/atomic-write.js

@@ -0,0 +1,79 @@
+/**
+ * Atomic write via dual rename.
+ *
+ * 写入流程（写 foo.json）：
+ *   1. 把当前 foo.json 改名为 foo.json_   （保留旧版作为热备）
+ *   2. 把新内容写到 foo.json__            （写入完成才有完整内容）
+ *   3. 把 foo.json__ rename 为 foo.json   （原子切换）
+ *   foo.json_ 留到下次写入时被覆盖。
+ *
+ * 读取时按以下顺序探测，自动恢复中途崩溃的状态：
+ *   - foo.json__ 存在 → 上次写入未完成，丢弃
+ *   - foo.json    存在 → 直接读
+ *   - foo.json_   存在 → rename 步骤崩溃，rename 回 foo.json 再读
+ *   - 都不存在 → null
+ */
+import fs from 'fs';
+import path from 'path';
+const HOT = '_'; // foo.json_   旧版热备
+const TMP = '__'; // foo.json__  写入中
+/**
+ * 原子写入 JSON 文件（双 rename）。dirname 不存在时会自动创建。
+ *
+ * @param filePath 目标文件
+ * @param content 完整内容（不含末尾换行也可，由调用方控制）
+ */
+export function atomicWrite(filePath, content) {
+    fs.mkdirSync(path.dirname(filePath), { recursive: true });
+    const hot = filePath + HOT;
+    const tmp = filePath + TMP;
+    // 步骤 1：当前文件 → hot（保留旧版作热备）
+    if (fs.existsSync(filePath)) {
+        if (fs.existsSync(hot))
+            fs.unlinkSync(hot);
+        fs.renameSync(filePath, hot);
+    }
+    // 步骤 2：写到 tmp
+    fs.writeFileSync(tmp, content, 'utf-8');
+    // 步骤 3：tmp → 目标（原子）
+    fs.renameSync(tmp, filePath);
+}
+export function atomicWriteJson(filePath, value) {
+    atomicWrite(filePath, JSON.stringify(value, null, 2) + '\n');
+}
+/**
+ * 原子读取——自动按状态恢复。文件不存在时返回 null。
+ *
+ * 调用方拿到 null 应当作"文件不存在"处理；解析失败抛错。
+ */
+export function atomicRead(filePath) {
+    const hot = filePath + HOT;
+    const tmp = filePath + TMP;
+    // 中途崩溃残留 → 丢弃
+    if (fs.existsSync(tmp)) {
+        try {
+            fs.unlinkSync(tmp);
+        }
+        catch { /* best effort */ }
+    }
+    if (fs.existsSync(filePath)) {
+        return fs.readFileSync(filePath, 'utf-8');
+    }
+    // rename 步骤崩溃 → 把 hot 移回正式名
+    if (fs.existsSync(hot)) {
+        fs.renameSync(hot, filePath);
+        return fs.readFileSync(filePath, 'utf-8');
+    }
+    return null;
+}
+export function atomicReadJson(filePath) {
+    const text = atomicRead(filePath);
+    if (text === null)
+        return null;
+    return JSON.parse(text);
+}
+export function ensureDir(dirPath) {
+    if (!fs.existsSync(dirPath)) {
+        fs.mkdirSync(dirPath, { recursive: true });
+    }
+}

package/dist/utils/channel-helpers.js

@@ -0,0 +1,46 @@
+/**
+ * Channel 配置归一化工具——给 ChannelLoader 时代的 channel adapter 用。
+ *
+ * 旧结构里 `Config.channels.<type>` 可以是 single object 或 array；这些工具
+ * 用来抹平这种差异。新结构（agents/<aid>/config.json）的 channels 已经统一为
+ * 列表形态，这些工具仍被 ChannelLoader 调用方使用——index.ts 把新结构翻成旧
+ * dict 形态喂给 ChannelLoader，所以 normalizeChannelInstances 仍然有用武之地。
+ *
+ * 当 ChannelLoader 重写为直接吃 ChannelInstance[] 后，本文件可删。
+ */
+export const channelTypes = ['feishu', 'wechat', 'aun', 'dingtalk', 'qqbot', 'wecom'];
+/**
+ * 把 channel 配置（单对象 / 数组 / undefined）归一为带 name 的数组。
+ */
+export function normalizeChannelInstances(cfg, defaultName) {
+    if (cfg === undefined || cfg === null)
+        return [];
+    if (Array.isArray(cfg)) {
+        return cfg.map((item, i) => ({
+            ...item,
+            name: item.name ?? (cfg.length === 1 ? defaultName : `${defaultName}-${i + 1}`),
+        }));
+    }
+    return [{ ...cfg, name: cfg.name ?? defaultName }];
+}
+/**
+ * 从 globalConfig.channels 字典里按实例名找 showActivities，找不到回退到全局。
+ */
+export function getChannelShowActivities(config, instanceName) {
+    for (const type of channelTypes) {
+        const raw = config.channels?.[type];
+        if (raw === undefined)
+            continue;
+        if (Array.isArray(raw)) {
+            const inst = raw.find((item) => item.name === instanceName);
+            if (inst)
+                return inst.showActivities ?? config.showActivities ?? 'all';
+        }
+        else {
+            const effectiveName = raw.name ?? type;
+            if (effectiveName === instanceName)
+                return raw.showActivities ?? config.showActivities ?? 'all';
+        }
+    }
+    return config.showActivities ?? 'all';
+}

package/dist/utils/cross-platform.js

@@ -106,24 +106,6 @@ function formatUptime(totalSeconds) {
         parts.push(`${seconds}s`);
     return parts.join(' ');
 }
-/**
- * Read a specific environment variable from a running process.
- * Returns undefined if the process doesn't exist or the variable is not set.
- * Linux: reads /proc/<pid>/environ; Windows: not supported (returns undefined).
- */
-export function getProcessEnv(pid, varName) {
-    if (isWindows)
-        return undefined;
-    try {
-        const environ = fs.readFileSync(`/proc/${pid}/environ`, 'utf-8');
-        const prefix = `${varName}=`;
-        const entry = environ.split('\0').find(e => e.startsWith(prefix));
-        return entry ? entry.slice(prefix.length) : undefined;
-    }
-    catch {
-        return undefined;
-    }
-}
 /**
  * Cross-platform command existence check.
  */