evolcore 0.0.24 → 0.0.25

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)
@@ -36,41 +37,45 @@ export async function cmdAgent(args) {
         return;
     }
     if (!sub || isHelpFlag(sub) || (wantsHelp(args) && !commands.has(sub))) {
-        console.log(`用法: ec agent <command>
-
-Commands:
-  list                    列出所有 agent
-  show <aid>              查看 agent 详情（身份 + 配置 + 连接 + 会话 + 路径）
-  new [aid]               交互式创建 agent
-  new <aid> --non-interactive ...  非交互式创建
-  enable <aid>            启用 agent
-  disable <aid>           停用 agent
-  get <aid> <key>         读取单个配置字段（支持点路径）
+        console.log(`用法: ec agent <command>
+
+Commands:
+  list                    列出所有 agent
+  show <aid>              查看 agent 详情（身份 + 配置 + 连接 + 会话 + 路径）
+  new [aid]               交互式创建 agent
+  new <aid> --non-interactive ...  非交互式创建
+  enable <aid>            启用 agent
+  disable <aid>           停用 agent
+  get <aid> <key>         读取单个配置字段（支持点路径）
   set <aid> <key> <val>   修改单个配置字段（支持点路径）
-  rename <aid> <name>     修改 agent.md 中的显示名称
-  ready <aid>              标记 bootstrap 完成，进入 active 状态
-  reload [aid]            热重载配置（无参数=全量 resync）
-  delete <aid> [--purge]  删除 agent
-
-Options:
-  --format json           输出 JSON 格式
-  --help, -h              各子命令均支持，查看详细用法
-
-示例:
-  ec agent list
-  ec agent show mybot.agentid.pub
-  ec agent new mybot.agentid.pub
-  ec agent enable mybot.agentid.pub
-  ec agent get mybot.agentid.pub active_baseagent
+  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）
+  delete <aid> [--purge]  删除 agent
+
+Options:
+  --format json           输出 JSON 格式
+  --help, -h              各子命令均支持，查看详细用法
+
+示例:
+  ec agent list
+  ec agent show mybot.agentid.pub
+  ec agent new mybot.agentid.pub
+  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 rename mybot.agentid.pub "New Name"
-  ec agent ready mybot.agentid.pub
+  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,
@@ -132,8 +137,8 @@ Options:
     // --- list ---
     if (sub === 'list') {
         if (wantsHelp(args)) {
-            console.log(`用法: ec agent list [--format json]
-
+            console.log(`用法: ec agent list [--format json]
+
 列出所有 agent，显示名称、状态、渠道、项目、基座、最后活跃时间。`);
             return;
         }
@@ -203,26 +208,27 @@ Options:
     // --- new ---
     if (sub === 'new') {
         if (wantsHelp(args)) {
-            console.log(`用法: ec agent new [aid]                    交互式创建
-     ec agent new <aid> --non-interactive [选项]
-
-非交互模式选项:
-  --project <path>                    默认: 当前目录
-  --baseagent <claude|codex|gemini|ecagent>
-                                      默认: defaults 配置，否则检测本机可用基座
+            console.log(`用法: ec agent new [aid]                    交互式创建
+     ec agent new <aid> --non-interactive [选项]
+
+非交互模式选项:
+  --project <path>                    默认: 当前目录
+  --baseagent <claude|codex|gemini|ecagent>
+                                      默认: defaults 配置，否则检测本机可用基座
   --owner <aid>                       默认: daemon.json 第一个 owner
   --owners <json-array>               多个 Owner；与 --owner 互斥
   --handoff <context>                 当前任务的 Bootstrap 上下文
-  --name <display-name>               默认: package.json name，否则目录名
+  --name <display-name>               默认: package.json name，否则目录名
   --description <text>                默认: package.json description，否则使用 EvolCore 默认描述
-  --dry-run                           只预览最终参数，不注册 AID、不写文件
-  --force                             覆盖已有 config.json
-  --format json                       输出 JSON
-
-示例:
-  ec agent new mybot.agentid.pub
-  ec agent new mybot.agentid.pub --non-interactive
-  ec agent new mybot.agentid.pub --non-interactive --dry-run --format json
+  --tags <json-array>                 3 到 6 个标签，例如 '["coding","diagnostics","logs"]'
+  --dry-run                           只预览最终参数，不注册 AID、不写文件
+  --force                             覆盖已有 config.json
+  --format json                       输出 JSON
+
+示例:
+  ec agent new mybot.agentid.pub
+  ec agent new mybot.agentid.pub --non-interactive
+  ec agent new mybot.agentid.pub --non-interactive --dry-run --format json
   ec agent new mybot.agentid.pub --non-interactive --project ../project --baseagent claude`);
             return;
         }
@@ -259,6 +265,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 +286,7 @@ Options:
                 handoff: getArg('--handoff'),
                 name: getArg('--name'),
                 description: getArg('--description'),
+                tags,
                 force: args.includes('--force'),
             });
             const validationError = validateAgentCreatePlan(plan);
@@ -304,6 +324,7 @@ Options:
                 owners: plan.owners,
                 name: plan.name,
                 description: plan.description,
+                tags: plan.tags,
                 force: args.includes('--force'),
             });
             if (!result.ok) {
@@ -399,11 +420,11 @@ Options:
     // --- reload ---
     if (sub === 'reload') {
         if (wantsHelp(args)) {
-            console.log(`用法: ec agent reload [aid] [--force] [--format json]
-
-热重载 agent 配置。
-  无参数      全量 resync（扫磁盘，新增上线、删除下线、修改热更新）
-  <aid>       仅热重载指定 agent
+            console.log(`用法: ec agent reload [aid] [--force] [--format json]
+
+热重载 agent 配置。
+  无参数      全量 resync（扫磁盘，新增上线、删除下线、修改热更新）
+  <aid>       仅热重载指定 agent
   --force     中断目标 Agent 的运行中任务并清空排队任务后重载（仅与 <aid> 同用）`);
             return;
         }
@@ -435,9 +456,9 @@ Options:
     // --- enable ---
     if (sub === 'enable') {
         if (wantsHelp(args)) {
-            console.log(`用法: ec agent enable <aid> [--force] [--format json]
-
-启用 agent。若服务运行中会热重载，否则下次 ec start 时生效。
+            console.log(`用法: ec agent enable <aid> [--force] [--format json]
+
+启用 agent。若服务运行中会热重载，否则下次 ec start 时生效。
   --force     中断目标 Agent 的运行中任务并清空排队任务后重载`);
             return;
         }
@@ -467,9 +488,9 @@ Options:
     // --- disable ---
     if (sub === 'disable') {
         if (wantsHelp(args)) {
-            console.log(`用法: ec agent disable <aid> [--force] [--format json]
-
-停用 agent。若服务运行中会热重载离线，否则在配置中标记为禁用。
+            console.log(`用法: ec agent disable <aid> [--force] [--format json]
+
+停用 agent。若服务运行中会热重载离线，否则在配置中标记为禁用。
   --force     中断目标 Agent 的运行中任务并清空排队任务后重载`);
             return;
         }
@@ -497,16 +518,94 @@ Options:
         return;
     }
     // --- get ---
-    if (sub === 'get') {
+    if (sub === 'persona') {
         if (wantsHelp(args)) {
-            console.log(`用法: ec agent get <aid> <key> [--format json]
+            console.log(`用法: ec agent persona show [--format json]
+     ec agent persona --text <text> [--format json]
+     ec agent persona --file <path> [--format json]
 
-读取单个配置字段。key 支持点路径，如 "channels.aun.enabled"。
-托管任务通过 daemon 统一鉴权；无会话的本机 CLI 走控制面。
-
-示例:
-  ec agent get mybot.agentid.pub active_baseagent
-  ec agent get mybot.agentid.pub observable
+读取或设置当前 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]
+
+读取单个配置字段。key 支持点路径，如 "channels.aun.enabled"。
+托管任务通过 daemon 统一鉴权；无会话的本机 CLI 走控制面。
+
+示例:
+  ec agent get mybot.agentid.pub active_baseagent
+  ec agent get mybot.agentid.pub observable
   ec agent get mybot.agentid.pub channels.aun.enabled`);
             return;
         }
@@ -538,15 +637,15 @@ Options:
     // --- set ---
     if (sub === 'set') {
         if (wantsHelp(args)) {
-            console.log(`用法: ec agent set <aid> <key> <value> [--format json]
-
-修改单个配置字段。key 支持点路径。本机控制面会尝试热重载；托管任务如需重载须另行执行 agent reload。
-托管任务通过 daemon 统一鉴权；无会话的本机 CLI 走控制面。
-
-示例:
-  ec agent set mybot.agentid.pub active_baseagent codex
-  ec agent set mybot.agentid.pub observable true
-  ec agent set mybot.agentid.pub observable false
+            console.log(`用法: ec agent set <aid> <key> <value> [--format json]
+
+修改单个配置字段。key 支持点路径。本机控制面会尝试热重载；托管任务如需重载须另行执行 agent reload。
+托管任务通过 daemon 统一鉴权；无会话的本机 CLI 走控制面。
+
+示例:
+  ec agent set mybot.agentid.pub active_baseagent codex
+  ec agent set mybot.agentid.pub observable true
+  ec agent set mybot.agentid.pub observable false
   ec agent set mybot.agentid.pub channels.aun.enabled true`);
             return;
         }
@@ -578,8 +677,8 @@ Options:
     // --- ready ---
     if (sub === 'ready') {
         if (wantsHelp(args)) {
-            console.log(`用法: ec agent ready <aid> [--format json]
-
+            console.log(`用法: ec agent ready <aid> [--format json]
+
 标记 agent bootstrap 已完成，将 lifecycle 切换为 active。该命令允许 agent 在工具调用中自报完成。`);
             return;
         }
@@ -609,10 +708,10 @@ Options:
     // --- delete ---
     if (sub === 'delete') {
         if (wantsHelp(args)) {
-            console.log(`用法: ec agent delete <aid> [--purge] [--format json]
-
-删除 agent 的配置。
-  --purge   同时清除该 agent 的会话、消息、日志等运行时数据
+            console.log(`用法: ec agent delete <aid> [--purge] [--format json]
+
+删除 agent 的配置。
+  --purge   同时清除该 agent 的会话、消息、日志等运行时数据
   默认       仅删除 config.json，运行时数据保留`);
             return;
         }
@@ -643,8 +742,8 @@ Options:
     // --- show ---
     if (sub === 'show') {
         if (wantsHelp(args)) {
-            console.log(`用法: ec agent show <aid> [--format json]
-
+            console.log(`用法: ec agent show <aid> [--format json]
+
 查看 agent 详情：身份、配置、连接状态、会话路径等。`);
             return;
         }
@@ -673,8 +772,8 @@ Options:
     // --- rename ---
     if (sub === 'rename') {
         if (wantsHelp(args)) {
-            console.log(`用法: ec agent rename <aid> <name> [--format json]
-
+            console.log(`用法: ec agent rename <aid> <name> [--format json]
+
 修改本地 AIDs/<aid>/agent.md 中的 name 字段。`);
             return;
         }

package/dist/cli/agent-create.js

@@ -12,7 +12,27 @@ 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_TAG_MAX_COUNT, AGENT_TAG_MIN_COUNT, DEFAULT_AGENT_DESCRIPTION, validateAgentTags, } 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';
@@ -120,7 +140,7 @@ export function resolveAgentCreatePlan(options) {
     const description = options.description?.trim() || metadata.description || DEFAULT_AGENT_DESCRIPTION;
     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, 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',
@@ -134,6 +154,11 @@ 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('; ')}`;
+    }
     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,6 +330,14 @@ 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));
@@ -313,7 +346,7 @@ export async function agentCreateInteractive(opts = {}) {
         ensureAgentDirSkeleton(aid);
         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++) {
@@ -411,6 +444,11 @@ 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 (!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);
@@ -484,7 +522,7 @@ export async function agentCreateNonInteractive(opts, runtime = {}) {
     opts.onPhase?.('uploading_agentmd', 'begin');
     let agentmdUploaded = false;
     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, tags: opts.tags });
         const aunPath = process.env.AUN_HOME || defaultAunPath();
         let lastError;
         for (let attempt = 1; attempt <= 3; attempt++) {

package/dist/cli/agent.js

@@ -1,6 +1,6 @@
 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';
@@ -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) {
@@ -456,6 +457,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.
  *