evolcore 0.0.25 → 0.0.27

package/dist/channels/daemon.js

@@ -1,3 +1,4 @@
+import { ExecutionTimeoutError } from '../utils/error-utils.js';
 import { normalizeExecutionMode } from '../trigger/validation.js';
 import { resolvePeerRoleDetail } from '../config/peer-role-resolver.js';
 const DEFAULT_WATCHDOG_MS = 11 * 60 * 1000;
@@ -349,7 +350,7 @@ export class DaemonChannel {
             watchdogMs: this.watchdogMs,
         }))
             return;
-        this.cancelDeliveryInBackground(slot);
+        this.cancelDeliveryInBackground(slot, new ExecutionTimeoutError('daemon_watchdog_timeout', this.watchdogMs));
         this.settleTerminal(runId, slot);
     }
     resetWatchdog(runId, slot) {
@@ -373,20 +374,23 @@ export class DaemonChannel {
             totalExecutionMs,
         }))
             return;
-        this.cancelDeliveryInBackground(slot);
+        this.cancelDeliveryInBackground(slot, new ExecutionTimeoutError('daemon_total_execution_timeout', totalExecutionMs));
         this.settleTerminal(runId, slot);
     }
-    cancelDeliveryInBackground(slot) {
-        const cancellation = this.cancelDelivery(slot.messageId);
+    cancelDeliveryInBackground(slot, timeout) {
+        const cancellation = this.cancelDelivery(slot.messageId, timeout);
         slot.cancellationBarrier = cancellation;
         void cancellation.then(() => undefined, () => undefined);
     }
-    async cancelDelivery(messageId) {
+    async cancelDelivery(messageId, timeout) {
         const queue = this.messageQueue;
         if (queue.cancel?.(messageId))
             return;
         if (queue.cancelActiveAndWait) {
-            await queue.cancelActiveAndWait(messageId);
+            if (timeout)
+                await queue.cancelActiveAndWait(messageId, undefined, timeout);
+            else
+                await queue.cancelActiveAndWait(messageId);
             return;
         }
         queue.cancelActive?.(messageId);

package/dist/cli/agent-command.js

@@ -1,7 +1,23 @@
 import path from 'path';
+import { MAIN_CLI_BIN, SELF_AID_ENV, SESSION_ID_ENV } from '../product.js';
 import { getArgValue, isHelpFlag, wantsHelp } from './help.js';
 import { isHostChinese } from '../utils/locale.js';
 import { readTaskRuntimeContextFromEnv } from './task-context.js';
+import { parseAgentWelcomeArgs } from './agent-create.js';
+function printBootstrapDeliveries(result) {
+    for (const delivery of result?.deliveries ?? []) {
+        if (delivery.status === 'sent')
+            console.log(`  ${delivery.owner}: 消息已被网关接受 (${delivery.messageId})`);
+        else if (delivery.status === 'queued')
+            console.log(`  ${delivery.owner}: 消息已入队，等待重试 (${delivery.outboxId})`);
+        else if (delivery.status === 'failed')
+            console.error(`  ${delivery.owner}: 消息发送失败 [${delivery.code ?? 'unknown'}] ${delivery.error}`);
+        else
+            console.log(`  ${delivery.owner}: 没有消息投递记录`);
+    }
+    if (result?.error)
+        console.error(`  消息状态异常: ${result.error}`);
+}
 function formatTimeAgo(ms) {
     const sec = Math.floor(ms / 1000);
     if (sec < 60)
@@ -26,7 +42,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', 'persona', 'rename', 'ready', 'reload', 'delete']);
+    const commands = new Set(['list', 'show', 'new', 'initialize', 'enable', 'disable', 'get', 'set', 'persona', 'welcome', '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)
@@ -37,46 +53,79 @@ 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 ...  非交互式创建
+  new <aid> --initialize ...       创建并激活（隐含非交互）
+  initialize <aid> --resume        恢复一次性初始化
+  enable <aid>            启用 agent
+  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）
-  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
+  welcome show            查看已确认的 Bootstrap welcome 文案
+  welcome --text <text>  保存 Owner 已确认的 Bootstrap welcome 文案
+  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 persona --text "你是一名严谨的诊断工程师。"
-  ec agent rename mybot.agentid.pub "New Name"
-  ec agent ready mybot.agentid.pub
+  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, agentPersona, agentRename, agentDelete, agentReady, runManagedAgentOperation, } = await import('./agent.js');
+    if ((sub === 'new' && args.includes('--initialize')) || sub === 'initialize') {
+        if (wantsHelp(args)) {
+            console.log('ec agent new <aid> --initialize --name <name> --description <text> --tags <json> [--owner <aid> | --owners <json>] [--persona-file <path> | --persona-text <text>] [--wait 0..300] [--dry-run] [--format json]\nec agent initialize <aid> --resume [--wait 0..300] [--format json]\n--initialize implies --non-interactive; waits for activation (default 60 seconds).');
+            return;
+        }
+        try {
+            const { runInitializationCommand } = await import('./agent-create.js');
+            const result = await runInitializationCommand(args);
+            if (formatJson)
+                console.log(JSON.stringify(result, null, 2));
+            else if (result.dryRun)
+                console.log(JSON.stringify(result, null, 2));
+            else if (result.ok)
+                console.log(`✓ ${result.aid} initialized (active)`);
+            else
+                console.error(`[${result.code}] ${result.error ?? result.phase ?? 'Initialization failed'}`);
+            if (!result.ok)
+                process.exitCode = result.code === 'INITIALIZE_PENDING' ? 2 : 1;
+        }
+        catch (error) {
+            const result = { ok: false, code: 'INVALID_ARGS', 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 { agentList, agentShow, agentCreateInteractive, agentCreateNonInteractive, agentReload, agentEnable, agentDisable, agentGet, agentSet, agentPersona, agentWelcome, 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')) {
+    if (process.env.EVOLCORE_SESSION_ID && !wantsHelp(args) && !new Set(['get', 'set', 'persona', 'welcome', 'ready']).has(sub)) {
+        if (sub === 'new' && !args.includes('--non-interactive') && !args.includes('--initialize')) {
             const error = {
                 ok: false,
                 code: 'MANAGED_NON_INTERACTIVE_REQUIRED',
@@ -137,8 +186,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;
         }
@@ -208,27 +257,31 @@ 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 [选项]
+
+非交互模式选项:
+  --initialize                       使用显式名片直接完成初始化（隐含 --non-interactive）
+  --persona-file <path>               初始化人格 .md/.txt（或 --persona-text <text>）
+  --wait <seconds>                   初始化等待 0–300 秒，默认 60
+  --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 默认描述
+  --type <type>                       主体类型: human|agent|group|service|device|org|host（默认 agent）
   --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
+  --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;
         }
@@ -286,6 +339,7 @@ Options:
                 handoff: getArg('--handoff'),
                 name: getArg('--name'),
                 description: getArg('--description'),
+                type: getArg('--type'),
                 tags,
                 force: args.includes('--force'),
             });
@@ -324,6 +378,7 @@ Options:
                 owners: plan.owners,
                 name: plan.name,
                 description: plan.description,
+                type: plan.type,
                 tags: plan.tags,
                 force: args.includes('--force'),
             });
@@ -351,6 +406,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}`);
                 }
@@ -385,6 +449,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}`);
                 }
@@ -420,11 +493,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;
         }
@@ -456,9 +529,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;
         }
@@ -488,9 +561,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;
         }
@@ -596,16 +669,65 @@ Options:
             console.log(result.content ?? '(persona.md 不存在)');
         return;
     }
+    if (sub === 'welcome') {
+        if (args.length === 2 && isHelpFlag(args[1])) {
+            console.log(`用法: ${MAIN_CLI_BIN} agent welcome show [--format json]
+     ${MAIN_CLI_BIN} agent welcome --text <text> [--format json]
+
+读取或保存当前 Agent 在 Bootstrap 中经 Owner 确认的 welcome 文案。文案固定保存到 personal/welcome.md。`);
+            return;
+        }
+        let text;
+        try {
+            ({ text } = parseAgentWelcomeArgs(args.slice(1)));
+        }
+        catch (error) {
+            const result = { ok: false, code: 'INVALID_ARGS', error: error.message };
+            if (formatJson)
+                console.log(JSON.stringify(result));
+            else
+                console.error(`❌ ${result.error}`);
+            process.exitCode = 1;
+            return;
+        }
+        const taskAid = process.env[SESSION_ID_ENV] ? (readTaskRuntimeContextFromEnv()?.selfAid || '') : '';
+        const aid = taskAid || process.env[SELF_AID_ENV] || '';
+        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 agentWelcome(aid, { text });
+        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} welcome.md 已保存`);
+        else
+            console.log(result.content ?? '(welcome.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
+            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;
         }
@@ -637,15 +759,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;
         }
@@ -677,8 +799,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;
         }
@@ -701,17 +823,18 @@ Options:
             console.log(JSON.stringify(result, null, 2));
         }
         else {
-            console.log(`✓ ${aid} lifecycle=active${result.reloaded ? ' (runtime updated)' : ' (daemon offline or not updated)'}`);
+            console.log(`✓ ${aid} lifecycle=active${result.reloaded ? ' (runtime updated)' : ''}`);
+            printBootstrapDeliveries(result.welcome);
         }
         return;
     }
     // --- 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;
         }
@@ -742,8 +865,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;
         }
@@ -772,8 +895,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;
         }
@@ -819,7 +942,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)