evolcore 0.0.24 → 0.0.26

package/dist/cli/agent-command.js

@@ -1,6 +1,7 @@
 import path from 'path';
 import { getArgValue, isHelpFlag, wantsHelp } from './help.js';
 import { isHostChinese } from '../utils/locale.js';
+import { readTaskRuntimeContextFromEnv } from './task-context.js';
 function formatTimeAgo(ms) {
     const sec = Math.floor(ms / 1000);
     if (sec < 60)
@@ -25,7 +26,7 @@ function formatBytes(bytes) {
 export async function cmdAgent(args) {
     const sub = args[0];
     const formatJson = getArgValue(args, '--format') === 'json';
-    const commands = new Set(['list', 'show', 'new', 'enable', 'disable', 'get', 'set', 'rename', 'ready', 'reload', 'delete']);
+    const commands = new Set(['list', 'show', 'new', 'enable', 'disable', 'get', 'set', 'persona', 'rename', 'ready', 'reload', 'delete']);
     if (sub === 'create') {
         const error = { ok: false, code: 'INVALID_COMMAND', error: '`ec agent create` is not a command; use `ec agent new`.' };
         if (formatJson)
@@ -47,6 +48,9 @@ Commands:
   disable <aid>           停用 agent
   get <aid> <key>         读取单个配置字段（支持点路径）
   set <aid> <key> <val>   修改单个配置字段（支持点路径）
+  persona show            查看当前 Agent 的 persona.md
+  persona --text <text>   用文本设置当前 Agent 的 persona.md
+  persona --file <path>   用 .md/.txt 文件设置当前 Agent 的 persona.md
   rename <aid> <name>     修改 agent.md 中的显示名称
   ready <aid>              标记 bootstrap 完成，进入 active 状态
   reload [aid]            热重载配置（无参数=全量 resync）
@@ -63,14 +67,15 @@ Options:
   ec agent enable mybot.agentid.pub
   ec agent get mybot.agentid.pub active_baseagent
   ec agent set mybot.agentid.pub active_baseagent codex
+  ec agent persona --text "你是一名严谨的诊断工程师。"
   ec agent rename mybot.agentid.pub "New Name"
   ec agent ready mybot.agentid.pub
   ec agent delete mybot.agentid.pub --purge`);
         return;
     }
-    const { agentList, agentShow, agentCreateInteractive, agentCreateNonInteractive, agentReload, agentEnable, agentDisable, agentGet, agentSet, agentRename, agentDelete, agentReady, runManagedAgentOperation, } = await import('./agent.js');
-    const { parseAgentOwnerArgs, resolveAgentCreatePlan, validateAgentCreatePlan } = await import('./agent-create.js');
-    if (process.env.EVOLCORE_SESSION_ID && !wantsHelp(args) && !new Set(['get', 'set', 'ready']).has(sub)) {
+    const { agentList, agentShow, agentCreateInteractive, agentCreateNonInteractive, agentReload, agentEnable, agentDisable, agentGet, agentSet, agentPersona, agentRename, agentDelete, agentReady, runManagedAgentOperation, } = await import('./agent.js');
+    const { parseAgentOwnerArgs, parseAgentTags, resolveAgentCreatePlan, validateAgentCreatePlan } = await import('./agent-create.js');
+    if (process.env.EVOLCORE_SESSION_ID && !wantsHelp(args) && !new Set(['get', 'set', 'persona', 'ready']).has(sub)) {
         if (sub === 'new' && !args.includes('--non-interactive')) {
             const error = {
                 ok: false,
@@ -215,6 +220,8 @@ Options:
   --handoff <context>                 当前任务的 Bootstrap 上下文
   --name <display-name>               默认: package.json name，否则目录名
   --description <text>                默认: package.json description，否则使用 EvolCore 默认描述
+  --type <type>                       主体类型: human|agent|group|service|device|org（默认 agent）
+  --tags <json-array>                 3 到 6 个标签，例如 '["coding","diagnostics","logs"]'
   --dry-run                           只预览最终参数，不注册 AID、不写文件
   --force                             覆盖已有 config.json
   --format json                       输出 JSON
@@ -259,6 +266,19 @@ Options:
                 process.exitCode = 1;
                 return;
             }
+            let tags;
+            try {
+                tags = parseAgentTags(getArg('--tags'));
+            }
+            catch (error) {
+                const result = { ok: false, error: error instanceof Error ? error.message : String(error) };
+                if (formatJson)
+                    console.log(JSON.stringify(result));
+                else
+                    console.error(`❌ ${result.error}`);
+                process.exitCode = 1;
+                return;
+            }
             const plan = resolveAgentCreatePlan({
                 aid: name,
                 project: getArg('--project'),
@@ -267,6 +287,8 @@ Options:
                 handoff: getArg('--handoff'),
                 name: getArg('--name'),
                 description: getArg('--description'),
+                type: getArg('--type'),
+                tags,
                 force: args.includes('--force'),
             });
             const validationError = validateAgentCreatePlan(plan);
@@ -304,6 +326,8 @@ Options:
                 owners: plan.owners,
                 name: plan.name,
                 description: plan.description,
+                type: plan.type,
+                tags: plan.tags,
                 force: args.includes('--force'),
             });
             if (!result.ok) {
@@ -330,6 +354,15 @@ Options:
                     : result.hotLoadError
                         ? `  ✗ 热重载失败：${result.hotLoadError}`
                         : '  ⚠ 服务未运行，下次 ec start 时生效');
+                if (result.ownerContactsSynced?.length) {
+                    console.log(`  ✓ 已同步 Owner 联系人: ${result.ownerContactsSynced.join(', ')}`);
+                }
+                if (result.ownerContactsSkipped?.length) {
+                    console.log(`  ⚠ 无本地联系人簿，跳过 Owner: ${result.ownerContactsSkipped.join(', ')}`);
+                }
+                if (result.ownerContactSyncErrors?.length) {
+                    console.log(`  ⚠ Owner 联系人同步失败: ${result.ownerContactSyncErrors.join('; ')}`);
+                }
                 if (result.ownerBoundAid) {
                     console.log(`  ✓ agent owner 已绑定: ${result.ownerBoundAid}`);
                 }
@@ -364,6 +397,15 @@ Options:
                     : result.hotLoadError
                         ? `  ✗ 热重载失败：${result.hotLoadError}`
                         : '  ⚠ 服务未运行，下次 ec start 时生效');
+                if (result.ownerContactsSynced?.length) {
+                    console.log(`  ✓ 已同步 Owner 联系人: ${result.ownerContactsSynced.join(', ')}`);
+                }
+                if (result.ownerContactsSkipped?.length) {
+                    console.log(`  ⚠ 无本地联系人簿，跳过 Owner: ${result.ownerContactsSkipped.join(', ')}`);
+                }
+                if (result.ownerContactSyncErrors?.length) {
+                    console.log(`  ⚠ Owner 联系人同步失败: ${result.ownerContactSyncErrors.join('; ')}`);
+                }
                 if (result.ownerBoundAid) {
                     console.log(`  ✓ agent owner 已绑定: ${result.ownerBoundAid}`);
                 }
@@ -497,6 +539,84 @@ Options:
         return;
     }
     // --- get ---
+    if (sub === 'persona') {
+        if (wantsHelp(args)) {
+            console.log(`用法: ec agent persona show [--format json]
+     ec agent persona --text <text> [--format json]
+     ec agent persona --file <path> [--format json]
+
+读取或设置当前 Agent 的 persona.md。--file 只接受 .md/.txt 文本文件。`);
+            return;
+        }
+        const formatSuffix = args.length >= 3
+            && args.at(-2) === '--format'
+            && args.at(-1) === 'json';
+        const commandArgs = formatSuffix ? args.slice(0, -2) : args;
+        const personaArgs = commandArgs.slice(1);
+        const invalid = (error) => {
+            const result = { ok: false, code: 'INVALID_ARGS', error };
+            if (formatJson)
+                console.log(JSON.stringify(result));
+            else
+                console.error(`❌ ${result.error}`);
+            process.exitCode = 1;
+            return;
+        };
+        if (!formatSuffix && args.includes('--format')) {
+            invalid('persona 仅支持末尾的 --format json');
+            return;
+        }
+        let text;
+        let file;
+        if (personaArgs.length === 1 && personaArgs[0] === 'show') {
+            // show is the only read form; no payload is accepted.
+        }
+        else if (personaArgs.length === 2 && personaArgs[0] === '--text') {
+            text = personaArgs[1];
+            if (text === undefined) {
+                invalid('persona --text 缺少参数');
+                return;
+            }
+        }
+        else if (personaArgs.length === 2 && personaArgs[0] === '--file') {
+            file = personaArgs[1];
+            if (!file || file.startsWith('-')) {
+                invalid('persona --file 缺少有效路径');
+                return;
+            }
+        }
+        else {
+            invalid('用法: ec agent persona show | --text <text> | --file <path>');
+            return;
+        }
+        const taskAid = process.env.EVOLCORE_SESSION_ID ? (readTaskRuntimeContextFromEnv()?.selfAid || '') : '';
+        const aid = taskAid || process.env.EVOLCORE_SELF_AID || '';
+        if (!aid) {
+            const result = { ok: false, code: 'INVALID_ARGS', error: '无法确定当前 Agent AID' };
+            if (formatJson)
+                console.log(JSON.stringify(result));
+            else
+                console.error(`❌ ${result.error}`);
+            process.exitCode = 1;
+            return;
+        }
+        const result = await agentPersona(aid, { text, file });
+        if (!result.ok) {
+            if (formatJson)
+                console.log(JSON.stringify(result));
+            else
+                console.error(`❌ ${result.error}`);
+            process.exitCode = 1;
+            return;
+        }
+        if (formatJson)
+            console.log(JSON.stringify(result, null, 2));
+        else if (result.saved)
+            console.log(`✓ ${aid} persona.md 已保存`);
+        else
+            console.log(result.content ?? '(persona.md 不存在)');
+        return;
+    }
     if (sub === 'get') {
         if (wantsHelp(args)) {
             console.log(`用法: ec agent get <aid> <key> [--format json]
@@ -720,7 +840,7 @@ Options:
     printAgentShowHuman(result);
 }
 function printAgentShowHuman(result) {
-    console.log(`${result.aid} (${result.status})\n`);
+    console.log(`${result.aid} (${result.status}, lifecycle=${result.lifecycle || 'unknown'})\n`);
     if (result.identity.name || result.identity.description) {
         console.log('  Identity');
         if (result.identity.name)

package/dist/cli/agent-create.js

@@ -7,12 +7,33 @@ import { ConfigTarget, write as cfgWrite, ensureFile as cfgEnsure, read as cfgRe
 import { ipcQuery } from '../ipc.js';
 import { CONFIG_SCHEMA_VERSION } from '../types.js';
 import { ensureInitialRoleRegistry } from '../config/role-service.js';
+import { addContact } from '../config/contact-request-service.js';
 import { getCodexAppServerAvailability } from '../agents/codex-runner.js';
 import { resolveEcagentConfig } from '../agents/baseagent.js';
 import { AUTO_BASEAGENT_CANDIDATES, BASEAGENT_CANDIDATES, detectAvailableBaseagents, } from '../agents/baseagent-availability.js';
 import { agentProjectRootFromDefaults, deriveAgentProjectPath } from '../utils/project-path.js';
 import { isValidAid } from '../aun/aid/validation.js';
-import { DEFAULT_AGENT_DESCRIPTION } from '../aun/aid/agentmd.js';
+import { AGENT_DESCRIPTION_MAX_LENGTH, AGENT_TAG_MAX_COUNT, AGENT_TAG_MIN_COUNT, DEFAULT_AGENT_DESCRIPTION, DEFAULT_AGENT_TYPE, normalizeAgentType, validateAgentTags, validateAgentType, } from '../aun/aid/agentmd.js';
+export function parseAgentTags(raw) {
+    if (raw === undefined)
+        return undefined;
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        throw new Error('--tags must be a JSON array of 3 to 6 valid tags');
+    }
+    if (!Array.isArray(parsed))
+        throw new Error('--tags must be a JSON array of 3 to 6 valid tags');
+    const tags = parsed.map(value => typeof value === 'string' ? value.trim() : value);
+    const tagErrors = validateAgentTags(tags, { minCount: AGENT_TAG_MIN_COUNT, maxCount: AGENT_TAG_MAX_COUNT });
+    if (tagErrors.length > 0)
+        throw new Error(`--tags ${tagErrors.join('; ')}`);
+    // Duplicate labels are harmless at the wire level, but should not consume
+    // the advertised 3-6 tag budget or produce duplicate frontmatter entries.
+    return [...new Set(tags)];
+}
 export function validateAgentOwnerOptions(options) {
     if (options.owner !== undefined && options.owners !== undefined) {
         return 'Options --owner and --owners are mutually exclusive';
@@ -69,6 +90,42 @@ function withStaticOwners(config, ownersInput) {
 function withStaticOwner(config, owner) {
     return withStaticOwners(config, owner ? [owner] : undefined);
 }
+/**
+ * An Agent owner must be able to receive the new Agent's Bootstrap reply.
+ * Contact admission is per local Agent, so materialize the new AID in each
+ * locally managed owner's contact book immediately after creation. Human or
+ * remote owners have no local contact book and are reported as skipped.
+ */
+export async function syncOwnerContactsAfterCreate(createdAid, owners) {
+    const synced = [];
+    const skipped = [];
+    const errors = [];
+    for (const ownerAid of [...new Set((owners ?? []).map(value => value.trim()).filter(Boolean))]) {
+        if (ownerAid === createdAid)
+            continue;
+        const ownerConfig = path.join(resolvePaths().agentsDir, ownerAid, 'config.json');
+        if (!fs.existsSync(ownerConfig)) {
+            skipped.push(ownerAid);
+            continue;
+        }
+        try {
+            await addContact({
+                selfAid: ownerAid,
+                primaryId: createdAid,
+                actorId: 'agent-create-owner-sync',
+            });
+            synced.push(ownerAid);
+        }
+        catch (error) {
+            errors.push(`${ownerAid}: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    return {
+        ...(synced.length > 0 ? { ownerContactsSynced: synced } : {}),
+        ...(skipped.length > 0 ? { ownerContactsSkipped: skipped } : {}),
+        ...(errors.length > 0 ? { ownerContactSyncErrors: errors } : {}),
+    };
+}
 function pickDefaultBaseagent(available) {
     return AUTO_BASEAGENT_CANDIDATES.find(candidate => available.includes(candidate)) ?? null;
 }
@@ -117,13 +174,25 @@ export function resolveAgentCreatePlan(options) {
     const owner = options.owner?.trim() || (owners === undefined ? daemon.owners?.[0] : undefined);
     const ownerSource = owners !== undefined || options.owner?.trim() ? 'argument' : owner ? 'daemon' : 'none';
     const name = options.name?.trim() || metadata.name || projectSlug(project);
-    const description = options.description?.trim() || metadata.description || DEFAULT_AGENT_DESCRIPTION;
+    // description 是可选字段：用户显式传入的必须合规（超长会在校验阶段被拒）；
+    // 从 package.json 推导出来的超长值直接弃用、回落默认短描述——用户没设过它，
+    // 不该因此让创建命令失败。
+    const explicitDescription = options.description?.trim();
+    const packageDescription = metadata.description
+        && Array.from(metadata.description).length <= AGENT_DESCRIPTION_MAX_LENGTH
+        ? metadata.description
+        : undefined;
+    const description = explicitDescription || packageDescription || DEFAULT_AGENT_DESCRIPTION;
+    // 大小写不敏感：能识别就收敛成小写；无法识别时保留原值，交给 validateAgentCreatePlan 报错。
+    const requestedType = options.type?.trim();
+    const type = requestedType ? (normalizeAgentType(requestedType) ?? requestedType) : DEFAULT_AGENT_TYPE;
     const configExists = isValidAid(aid) && fs.existsSync(path.join(resolvePaths().agentsDir, aid, 'config.json'));
     return {
-        aid, project, baseagent, owner, owners, handoff: options.handoff, name, description,
+        aid, project, baseagent, owner, owners, handoff: options.handoff, name, description, type, tags: options.tags,
         force: options.force === true, configExists, baseagentSource, ownerSource,
         nameSource: options.name?.trim() ? 'argument' : metadata.name ? 'package' : 'directory',
-        descriptionSource: options.description?.trim() ? 'argument' : metadata.description ? 'package' : 'default',
+        descriptionSource: explicitDescription ? 'argument' : packageDescription ? 'package' : 'default',
+        typeSource: options.type?.trim() ? 'argument' : 'default',
     };
 }
 export function validateAgentCreatePlan(plan) {
@@ -134,6 +203,21 @@ export function validateAgentCreatePlan(plan) {
         return `Invalid AID "${plan.aid}": must be a valid multi-level domain (e.g. mybot.agentid.pub)`;
     if (plan.configExists && !plan.force)
         return `Agent "${plan.aid}" already exists (use --force to overwrite)`;
+    if (plan.tags !== undefined) {
+        const tagErrors = validateAgentTags(plan.tags, { minCount: AGENT_TAG_MIN_COUNT, maxCount: AGENT_TAG_MAX_COUNT });
+        if (tagErrors.length > 0)
+            return `Invalid tags: ${tagErrors.join('; ')}`;
+    }
+    const typeError = validateAgentType(plan.type);
+    if (typeError)
+        return `Invalid --type: ${typeError}`;
+    // 只有显式传入的 --description 才会超限（package.json 的超长值在 resolve 阶段
+    // 已被弃用）。必须在这里就拒绝：否则 plan 通过、直到 agentmdPut 上传才失败，
+    // 而那处是 warn 级不中断创建，最终留下一张 SDK 兜底名片（--type/--name 全部丢失）。
+    const descriptionLength = Array.from(plan.description).length;
+    if (descriptionLength > AGENT_DESCRIPTION_MAX_LENGTH) {
+        return `Invalid --description: ${descriptionLength} characters exceeds the agent.md limit of ${AGENT_DESCRIPTION_MAX_LENGTH}. Pass a shorter --description.`;
+    }
     if (!plan.baseagent)
         return 'No usable baseagent detected. Pass --baseagent or configure a baseagent in agents/defaults.json.';
     if (!BASEAGENT_CANDIDATES.includes(plan.baseagent)) {
@@ -305,15 +389,25 @@ export async function agentCreateInteractive(opts = {}) {
         const defaultName = aid.split('.')[0];
         const agentName = (await ask(`Display name [${defaultName}]: `)).trim() || defaultName;
         const agentDescription = (await ask('Description (optional): ')).trim() || '';
+        const tagInput = (await ask('Tags (3-6, comma separated; optional): ')).trim();
+        let agentTags;
+        if (tagInput) {
+            agentTags = [...new Set(tagInput.split(/[,，\s]+/).map(tag => tag.trim()).filter(Boolean))];
+            const tagErrors = validateAgentTags(agentTags, { minCount: AGENT_TAG_MIN_COUNT, maxCount: AGENT_TAG_MAX_COUNT });
+            if (tagErrors.length > 0)
+                return { ok: false, error: `Invalid tags: ${tagErrors.join('; ')}` };
+        }
         if (ownRl)
             rl.close();
         saveAgent(withStaticOwner({ $schema_version: CONFIG_SCHEMA_VERSION, aid, enabled: true, lifecycle: 'created', channels: [], projects: { defaultPath: projectPath } }, owner));
         ensureInitialRoleRegistry(aid);
         saveInitialBehavior(aid, baseagent);
         ensureAgentDirSkeleton(aid);
+        if (owner)
+            await syncOwnerContactsAfterCreate(aid, [owner]);
         let agentmdUploaded = false;
         try {
-            const content = buildInitialAgentMd({ aid, name: agentName, description: agentDescription });
+            const content = buildInitialAgentMd({ aid, name: agentName, description: agentDescription, tags: agentTags });
             const aunPath = process.env.AUN_HOME || defaultAunPath();
             let lastError;
             for (let attempt = 1; attempt <= 3; attempt++) {
@@ -366,7 +460,21 @@ export async function agentCreateInteractive(opts = {}) {
                 ownerBoundAid = await promptAgentOwnerManually(aid);
             }
         }
-        return { ok: true, aid, configPath: toPosix(path.join(agentDirPath, 'config.json')), aidCreated, agentmdUploaded, hotLoaded, hotLoadError, ownerBoundAid, ownerBindSkipped, ownerBindInterrupted };
+        const finalOwnerAid = owner ?? ownerBoundAid;
+        const ownerContactSync = await syncOwnerContactsAfterCreate(aid, finalOwnerAid ? [finalOwnerAid] : undefined);
+        return {
+            ok: true,
+            aid,
+            configPath: toPosix(path.join(agentDirPath, 'config.json')),
+            aidCreated,
+            agentmdUploaded,
+            hotLoaded,
+            hotLoadError,
+            ownerBoundAid,
+            ownerBindSkipped,
+            ownerBindInterrupted,
+            ...ownerContactSync,
+        };
     }
     finally {
         if (ownRl) {
@@ -411,6 +519,22 @@ export async function agentCreateNonInteractive(opts, runtime = {}) {
     const ownerError = validateAgentOwnerOptions(opts);
     if (ownerError)
         return failValidating(ownerError);
+    if (opts.tags !== undefined) {
+        const tagErrors = validateAgentTags(opts.tags, { minCount: AGENT_TAG_MIN_COUNT, maxCount: AGENT_TAG_MAX_COUNT });
+        if (tagErrors.length > 0)
+            return failValidating(`Invalid tags: ${tagErrors.join('; ')}`);
+    }
+    if (opts.type !== undefined) {
+        const typeError = validateAgentType(opts.type);
+        if (typeError)
+            return failValidating(`Invalid --type: ${typeError}`);
+    }
+    if (opts.description !== undefined) {
+        const descriptionLength = Array.from(opts.description).length;
+        if (descriptionLength > AGENT_DESCRIPTION_MAX_LENGTH) {
+            return failValidating(`Invalid description: ${descriptionLength} characters exceeds the agent.md limit of ${AGENT_DESCRIPTION_MAX_LENGTH}. Pass a shorter --description.`);
+        }
+    }
     if (!isValidAid(opts.aid))
         return failValidating(`Invalid AID "${opts.aid}": must be a valid multi-level domain (e.g. mybot.agentid.pub)`);
     const agentDirPath = path.join(p.agentsDir, opts.aid);
@@ -480,11 +604,13 @@ export async function agentCreateNonInteractive(opts, runtime = {}) {
     ensureInitialRoleRegistry(opts.aid);
     saveInitialBehavior(opts.aid, baseagent);
     ensureAgentDirSkeleton(opts.aid);
+    const ownerContactSync = await syncOwnerContactsAfterCreate(opts.aid, opts.owners ?? (opts.owner ? [opts.owner] : undefined));
     opts.onPhase?.('config_saved', 'done');
     opts.onPhase?.('uploading_agentmd', 'begin');
     let agentmdUploaded = false;
+    let agentmdError;
     try {
-        const content = buildInitialAgentMd({ aid: opts.aid, name: opts.name, description: opts.description });
+        const content = buildInitialAgentMd({ aid: opts.aid, name: opts.name, description: opts.description, type: opts.type, tags: opts.tags });
         const aunPath = process.env.AUN_HOME || defaultAunPath();
         let lastError;
         for (let attempt = 1; attempt <= 3; attempt++) {
@@ -500,12 +626,15 @@ export async function agentCreateNonInteractive(opts, runtime = {}) {
                 lastError = e;
             }
         }
-        if (!agentmdUploaded)
-            opts.onPhase?.('uploading_agentmd', 'warn', `upload failed: ${lastError?.message || lastError}`);
+        if (!agentmdUploaded) {
+            agentmdError = `upload failed: ${lastError?.message || lastError}`;
+            opts.onPhase?.('uploading_agentmd', 'warn', agentmdError);
+        }
         await new Promise(r => setTimeout(r, 0));
     }
     catch (e) {
-        opts.onPhase?.('uploading_agentmd', 'warn', `generation failed: ${e?.message || e}`);
+        agentmdError = `generation failed: ${e?.message || e}`;
+        opts.onPhase?.('uploading_agentmd', 'warn', agentmdError);
     }
     let hotLoaded = false;
     let hotLoadError;
@@ -534,5 +663,16 @@ export async function agentCreateNonInteractive(opts, runtime = {}) {
         hotLoadError = error instanceof Error ? error.message : String(error);
         opts.onPhase?.('hot_loading', 'warn', hotLoadError);
     }
-    return { ok: true, aid: opts.aid, ownerAid: (opts.owners ?? (opts.owner ? [opts.owner] : undefined))?.[0], configPath: toPosix(path.join(agentDirPath, 'config.json')), aidCreated, agentmdUploaded, hotLoaded, hotLoadError };
+    return {
+        ok: true,
+        aid: opts.aid,
+        ownerAid: (opts.owners ?? (opts.owner ? [opts.owner] : undefined))?.[0],
+        configPath: toPosix(path.join(agentDirPath, 'config.json')),
+        aidCreated,
+        agentmdUploaded,
+        agentmdError,
+        hotLoaded,
+        hotLoadError,
+        ...ownerContactSync,
+    };
 }

package/dist/cli/agent.js

@@ -1,10 +1,10 @@
 import fs from 'fs';
 import path from 'path';
-import { resolvePaths, agentMdPath as getAgentMdPathFromPaths, aunPath as defaultAunPath } from '../paths.js';
+import { resolvePaths, agentMdPath as getAgentMdPathFromPaths, agentPersonalDir, aunPath as defaultAunPath } from '../paths.js';
 import { loadDefaults, loadAllAgents, loadAgent, saveAgent, ensureAgentDirSkeleton } from '../config-store.js';
 import { initConfigManager } from '../config/config-manager.js';
 import { resolveConfigCommand } from '../config/resolved-config-op.js';
-import { executeResolvedConfigCommand } from '../config/config-operation-service.js';
+import { executeResolvedConfigCommandAsync } from '../config/config-operation-service.js';
 import { ipcQuery, IpcTransportError } from '../ipc.js';
 import { CONFIG_SCHEMA_VERSION } from '../types.js';
 import { ensureInitialRoleRegistry } from '../config/role-service.js';
@@ -12,6 +12,7 @@ import { agentProjectRootFromDefaults, deriveAgentProjectPath } from '../utils/p
 import { isValidChannelName } from '../core/channel-loader.js';
 import { AGENT_DELEGATION_TOKEN_ENV } from '../core/auth/agent-delegation.js';
 import { readTaskRuntimeContextFromEnv } from './task-context.js';
+import { isHClassPath, isLClassPath, isSameOrDescendant } from '../core/permission/protected-paths.js';
 export { agentCreateInteractive, agentCreateNonInteractive, parseAgentOwnerArgs, resolveAgentCreatePlan, validateAgentCreatePlan, validateAgentOwnerOptions, } from './agent-create.js';
 /** Route agent lifecycle commands from a managed task through daemon IPC. */
 export async function runManagedAgentOperation(argv) {
@@ -182,6 +183,7 @@ export async function agentShow(aid) {
         ok: true,
         aid,
         status: agentInfo.status || 'unknown',
+        lifecycle: loadAgent(aid)?.lifecycle ?? null,
         identity,
         config: {
             baseagent: agentInfo.baseagent || null,
@@ -389,12 +391,22 @@ async function runManagedAgentConfig(args, options) {
         return { managed: true, error: { ok: false, code: 'DAEMON_UNAVAILABLE', error: 'Unable to connect to the evolcore daemon' } };
     }
 }
-function executeLocalAgentConfig(args) {
+async function executeLocalAgentConfig(args) {
     initConfigManager();
     const resolved = resolveConfigCommand(['config', ...args]);
     if (!resolved.ok)
         return { ok: false, code: resolved.code, error: resolved.reason };
-    return executeResolvedConfigCommand(resolved.command);
+    return executeResolvedConfigCommandAsync(resolved.command, {
+        role: 'owner',
+        roleContext: {
+            self: resolved.command.self || '',
+            actorRole: 'owner',
+            actorRoleSource: 'local-cli',
+            isDaemonOwner: false,
+            fromControlChannel: false,
+            aunAvailable: true,
+        },
+    });
 }
 export async function agentGet(aid, key, options = {}) {
     const managed = await runManagedAgentConfig(['get', key, '--self', aid], options);
@@ -411,7 +423,7 @@ export async function agentGet(aid, key, options = {}) {
         return { ok: false, error: `Agent "${aid}" not found` };
     }
     try {
-        const result = executeLocalAgentConfig(['get', key, '--self', aid]);
+        const result = await executeLocalAgentConfig(['get', key, '--self', aid]);
         return result.ok && result.subcommand === 'get'
             ? { ok: true, aid, key, value: result.value }
             : { ok: false, code: result.ok ? 'UNEXPECTED_RESULT' : result.code, error: result.ok ? 'config get returned an unexpected result' : result.error };
@@ -437,7 +449,7 @@ export async function agentSet(aid, key, rawValue, options = {}) {
     }
     let value;
     try {
-        const result = executeLocalAgentConfig(['set', key, rawValue, '--self', aid]);
+        const result = await executeLocalAgentConfig(['set', key, rawValue, '--self', aid]);
         if (!result.ok)
             return { ok: false, code: result.code, error: result.error };
         if (result.subcommand !== 'set')
@@ -456,6 +468,107 @@ export async function agentSet(aid, key, rawValue, options = {}) {
     catch { }
     return { ok: true, aid, key, value, reloaded };
 }
+export const AGENT_PERSONA_MAX_BYTES = 64 * 1024;
+function validatePersonaContent(content) {
+    if (content.includes('\0'))
+        return 'persona 只能包含文本内容';
+    if (Buffer.byteLength(content, 'utf8') > AGENT_PERSONA_MAX_BYTES) {
+        return `persona 不能超过 ${AGENT_PERSONA_MAX_BYTES} bytes`;
+    }
+    return null;
+}
+function readPersonaSource(file) {
+    const resolved = path.resolve(file);
+    if (!/\.(?:md|txt)$/i.test(resolved)) {
+        return { ok: false, code: 'INVALID_ARGS', error: '--file 只接受 .md 或 .txt 文本文件' };
+    }
+    try {
+        const stat = fs.statSync(resolved);
+        if (!stat.isFile())
+            return { ok: false, code: 'INVALID_ARGS', error: `--file 必须指向普通文件: ${resolved}` };
+        const content = fs.readFileSync(resolved, 'utf8');
+        const error = validatePersonaContent(content);
+        return error ? { ok: false, code: 'INVALID_ARGS', error } : { ok: true, content };
+    }
+    catch (e) {
+        return { ok: false, code: 'READ_FAILED', error: `无法读取 --file: ${e?.message || e}` };
+    }
+}
+/** Read or replace the current Agent's personal/persona.md. */
+export async function agentPersona(aid, options = {}) {
+    if (options.text !== undefined && options.file !== undefined)
+        return { ok: false, code: 'INVALID_ARGS', error: '--text 与 --file 不能同时使用' };
+    const managedSession = !!process.env.EVOLCORE_SESSION_ID && !options.trustedLocal;
+    let text = options.text;
+    if (options.file !== undefined) {
+        if (managedSession) {
+            const resolved = path.resolve(options.file);
+            const projectRoot = path.resolve(process.cwd());
+            const tempRoot = process.env.TMPDIR?.trim() && path.isAbsolute(process.env.TMPDIR)
+                ? path.resolve(process.env.TMPDIR)
+                : undefined;
+            const allowed = isSameOrDescendant(resolved, projectRoot)
+                || (!!tempRoot && isSameOrDescendant(resolved, tempRoot));
+            if (!allowed || isHClassPath(resolved) || isLClassPath(resolved)) {
+                return { ok: false, code: 'INVALID_ARGS', error: '--file 必须位于当前项目或会话 $TMPDIR，且不能读取 EvolCore 受保护路径' };
+            }
+            try {
+                const stat = fs.lstatSync(resolved);
+                if (stat.isSymbolicLink() || !stat.isFile()) {
+                    return { ok: false, code: 'INVALID_ARGS', error: '--file 必须指向当前项目或会话 $TMPDIR 内的普通文件' };
+                }
+                const realPath = fs.realpathSync(resolved);
+                const realProjectRoot = fs.realpathSync(projectRoot);
+                const realTempRoot = tempRoot ? fs.realpathSync(tempRoot) : undefined;
+                const realAllowed = isSameOrDescendant(realPath, realProjectRoot)
+                    || (!!realTempRoot && isSameOrDescendant(realPath, realTempRoot));
+                if (!realAllowed || isHClassPath(realPath) || isLClassPath(realPath)) {
+                    return { ok: false, code: 'INVALID_ARGS', error: '--file 解析后越出允许目录或命中 EvolCore 受保护路径' };
+                }
+            }
+            catch (e) {
+                return { ok: false, code: 'READ_FAILED', error: `无法校验 --file: ${e?.message || e}` };
+            }
+        }
+        const source = readPersonaSource(options.file);
+        if (!source.ok)
+            return source;
+        text = source.content;
+    }
+    if (text !== undefined) {
+        const error = validatePersonaContent(text);
+        if (error)
+            return { ok: false, code: 'INVALID_ARGS', error };
+    }
+    const managedArgs = options.text !== undefined
+        ? ['persona', '--text', text]
+        : options.file !== undefined
+            ? ['persona', '--text', text]
+            : ['persona', 'show'];
+    if (managedSession) {
+        const managed = await runManagedAgentOperation(managedArgs);
+        if (!managed.ok)
+            return managed;
+        return { ok: true, aid, content: managed.content ?? null, ...(managed.path ? { path: managed.path } : {}), ...(managed.saved ? { saved: true } : {}) };
+    }
+    const personaPath = path.join(agentPersonalDir(aid), 'persona.md');
+    if (text === undefined) {
+        try {
+            return { ok: true, aid, content: fs.existsSync(personaPath) ? fs.readFileSync(personaPath, 'utf8') : null, path: personaPath };
+        }
+        catch (e) {
+            return { ok: false, code: 'READ_FAILED', error: e?.message || String(e) };
+        }
+    }
+    try {
+        fs.mkdirSync(path.dirname(personaPath), { recursive: true });
+        fs.writeFileSync(personaPath, text, 'utf8');
+        return { ok: true, aid, content: text, path: personaPath, saved: true };
+    }
+    catch (e) {
+        return { ok: false, code: 'WRITE_FAILED', error: e?.message || String(e) };
+    }
+}
 /**
  * Add or overwrite a channel instance on a per-agent config.
  *