evolcore 0.0.23 → 0.0.25

package/dist/channels/wecom.js

@@ -1461,7 +1461,8 @@ export class WecomChannelPlugin {
                         return;
                     case 'status.started':
                     case 'status.queued':
-                    case 'status.progress': return;
+                    case 'status.progress':
+                    case 'status.notice': return;
                     case 'status.requires_action':
                         await channel.sendMessage(channelId, '等待 owner 审批', envelope.replyContext);
                         return;

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,40 +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');
-    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,
@@ -131,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;
         }
@@ -202,27 +208,39 @@ 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
-  --name <display-name>               默认: package.json name，否则目录名
+  --owners <json-array>               多个 Owner；与 --owner 互斥
+  --handoff <context>                 当前任务的 Bootstrap 上下文
+  --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;
         }
+        if (args.includes('--handoff')) {
+            const result = { ok: false, code: 'MANAGED_ONLY', error: '--handoff requires a managed Agent task' };
+            if (formatJson)
+                console.log(JSON.stringify(result));
+            else
+                console.error(result.error);
+            process.exitCode = 1;
+            return;
+        }
         const name = args[1];
         const nonInteractive = args.includes('--non-interactive');
         if (nonInteractive) {
@@ -234,14 +252,41 @@ Options:
                 const idx = args.indexOf(flag);
                 return idx !== -1 && idx + 1 < args.length ? args[idx + 1] : undefined;
             };
-            const { resolveAgentCreatePlan, validateAgentCreatePlan } = await import('./agent.js');
+            let ownerOptions;
+            try {
+                ownerOptions = parseAgentOwnerArgs(args);
+            }
+            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;
+            }
+            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'),
                 baseagent: getArg('--baseagent'),
-                owner: getArg('--owner'),
+                ...ownerOptions,
+                handoff: getArg('--handoff'),
                 name: getArg('--name'),
                 description: getArg('--description'),
+                tags,
                 force: args.includes('--force'),
             });
             const validationError = validateAgentCreatePlan(plan);
@@ -263,7 +308,7 @@ Options:
                     console.log(`  AID: ${plan.aid}`);
                     console.log(`  Project: ${plan.project}`);
                     console.log(`  Baseagent: ${plan.baseagent} (${plan.baseagentSource})`);
-                    console.log(`  Owner: ${plan.owner || '未设置'} (${plan.ownerSource})`);
+                    console.log(`  Owner: ${plan.owners?.join(', ') || plan.owner || '未设置'} (${plan.ownerSource})`);
                     console.log(`  Name: ${plan.name} (${plan.nameSource})`);
                     if (plan.description)
                         console.log(`  Description: ${plan.description} (${plan.descriptionSource})`);
@@ -276,8 +321,10 @@ Options:
                 baseagent: plan.baseagent,
                 project: plan.project,
                 owner: plan.owner,
+                owners: plan.owners,
                 name: plan.name,
                 description: plan.description,
+                tags: plan.tags,
                 force: args.includes('--force'),
             });
             if (!result.ok) {
@@ -373,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;
         }
@@ -409,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;
         }
@@ -441,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;
         }
@@ -471,16 +518,94 @@ Options:
         return;
     }
     // --- get ---
-    if (sub === 'get') {
+    if (sub === 'persona') {
         if (wantsHelp(args)) {
-            console.log(`用法: ec agent get <aid> <key> [--format json]
-
-读取单个配置字段。key 支持点路径，如 "channels.aun.enabled"。
-托管任务通过 daemon 统一鉴权；无会话的本机 CLI 走控制面。
+            console.log(`用法: ec agent persona show [--format json]
+     ec agent persona --text <text> [--format json]
+     ec agent persona --file <path> [--format json]
 
-示例:
-  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;
         }
@@ -512,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;
         }
@@ -552,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;
         }
@@ -583,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;
         }
@@ -617,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;
         }
@@ -647,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;
         }