evolcore 0.0.17 → 0.0.19

package/ecagent/dist/harness/agent-harness.d.ts

@@ -90,6 +90,6 @@ export declare class AgentHarness<TSkill extends Skill = Skill, TPromptTemplate
     subscribe(listener: (event: AgentHarnessEvent<TSkill, TPromptTemplate>, signal?: AbortSignal) => Promise<void> | void): () => void;
     on<TType extends keyof AgentHarnessEventResultMap>(type: TType, handler: (event: Extract<AgentHarnessOwnEvent, {
         type: TType;
-    }>) => Promise<AgentHarnessEventResultMap[TType]> | AgentHarnessEventResultMap[TType]): () => void;
+    }>, signal?: AbortSignal) => Promise<AgentHarnessEventResultMap[TType]> | AgentHarnessEventResultMap[TType]): () => void;
 }
 //# sourceMappingURL=agent-harness.d.ts.map

package/ecagent/dist/harness/agent-harness.js

@@ -162,14 +162,14 @@ export class AgentHarness {
             }
         }
     }
-    async emitHook(event) {
+    async emitHook(event, signal) {
         const handlers = this.getHandlers(event.type);
         if (!handlers || handlers.size === 0)
             return undefined;
         let lastResult;
         for (const handler of handlers) {
             try {
-                const result = await handler(event);
+                const result = await handler(event, signal);
                 if (result !== undefined) {
                     lastResult = result;
                 }
@@ -327,13 +327,15 @@ export class AgentHarness {
                 const result = await this.emitHook({ type: "context", messages: [...messages] });
                 return result?.messages ?? messages;
             },
-            beforeToolCall: async ({ toolCall, args }) => {
+            beforeToolCall: async ({ toolCall, args }, signal) => {
                 const result = await this.emitHook({
                     type: "tool_call",
                     toolCallId: toolCall.id,
                     toolName: toolCall.name,
                     input: args,
-                });
+                }, signal);
+                if (signal?.aborted)
+                    return { block: true, reason: "Operation aborted" };
                 return result ? { block: result.block, reason: result.reason } : undefined;
             },
             afterToolCall: async ({ toolCall, args, result, isError }) => {

package/kits/docs/evolcore/config.md

@@ -175,7 +175,7 @@ ec config unset groupRules.mode \
 - **角色专用入口**：`roles/index.json` 与 `roles/{roleId}.json` 由角色服务维护；relation 的
   `role` 由角色分配服务维护；`permissionMode` 仅在角色策略中维护
 - **兼容字段**：`enable_rich_content` 仍可读取旧值，但已废弃且不再产生运行时效果
-- **群规则策略**：`groupRules.mode` 仅 Agent owner 或 daemon owner 可 set/unset；其他角色可读取当前 relation 的有效值
+- **群规则策略**：`groupRules.mode` 仅当前 Agent 的实际 owner 可 set/unset；DaemonOwner 不继承群或 relation 写权限，其他角色可读取当前 relation 的有效值
 - **源码诊断白名单**：`readonlySourceDiagnostics` 默认关闭；开启后只读会话仅可在项目源码目录执行受限、可证明只读查询，配置/证书/快照/session/锁文件仍禁止访问
 - **仅人可写**：channels / owners / admins / 凭证 / aid / enabled / projects / aun / models.allowed
 - Agent 托管环境写仅人字段被拒

package/kits/docs/evolcore/group-rules.md

@@ -58,7 +58,8 @@ ec config unset groupRules.mode \
 ec config set groupRules.mode ignore --self bot.agentid.pub
 ```
 
-`groupRules.mode` 只能由 Agent owner 或 daemon owner 修改，其他角色仍可读取当前 relation 的有效值。
+`groupRules.mode` 只能由当前 Agent 的实际 owner 修改；DaemonOwner 不会仅因进程角色而获得该权限，
+其他角色仍可读取当前 relation 的有效值。
 在群聊中，即使 owner 也只能修改当前群 relation，不能修改 Agent 默认值。命令沿用既有
 `ec config set/unset` 的授权、selector 和输出语义，不新增 Menu 协议。
 

package/kits/docs/identity/ROLE_DETAIL.md

@@ -12,7 +12,9 @@
 | visitor | Yes | No | No | No |
 | none | No | No | No | No |
 
-进程级 daemon owner 是最高管理者；它通过 agent channel 进入时按设计作为该 agent 的 owner 处理。
+上表描述 Agent/relation 角色，不包含 daemon 进程控制面。进程级 `daemon-owner` 是独立角色，
+用于 daemon、Agent 生命周期、ECWeb 和指定 Trigger 控制操作；它通过 Agent channel 进入时仍保留
+实际关系角色，不会自动成为该 Agent 的 `owner`。
 
 ## 场景矩阵
 

package/kits/docs/path-registry.md

@@ -7,7 +7,7 @@
 
 | 名称 | 含义 | 来源 |
 |------|------|------|
-| `$EVOLCORE_HOME` | evolcore 用户数据根 | `resolveRoot()`：环境变量 `EVOLCORE_HOME` → cwd 下有 `agents/defaults.json` 则取 cwd → `~/.evolcore` |
+| `$EVOLCORE_HOME` | evolcore 用户数据根 | `resolveRoot()`：环境变量 `EVOLCORE_HOME` → `~/.evolcore` |
 | `$PACKAGE_ROOT` | evolcore 包根目录 | `getPackageRoot()`，由 `import.meta` 推出（不是 `require.resolve`） |
 | `$CURRENT_PROJECT` | 当前工作目录 | 会话的 projectPath |
 

package/kits/eck_manifest.json

@@ -7,7 +7,7 @@
       "path": "$KITS_RULES",
       "order": 10,
       "needsInjection": false,
-      "when": "always",
+      "when": { "var": "lifecycle", "eq": "active" },
       "description": "ECK 核心规则（自动加载）"
     },
     {
@@ -27,7 +27,7 @@
       "needsInjection": true,
       "when": { "and": [
         { "var": "chatType", "neq": null },
-        { "var": "lifecycle", "neq": "bootstrapping" }
+        { "var": "lifecycle", "eq": "active" }
       ] },
       "description": "身份层：我是谁"
     },
@@ -39,7 +39,7 @@
       "needsInjection": false,
       "when": { "and": [
         { "var": "chatType", "neq": null },
-        { "var": "lifecycle", "neq": "bootstrapping" }
+        { "var": "lifecycle", "eq": "active" }
       ] },
       "description": "人格档案（persona.md）"
     },
@@ -51,7 +51,7 @@
       "needsInjection": false,
       "when": { "and": [
         { "var": "chatType", "neq": null },
-        { "var": "lifecycle", "neq": "bootstrapping" }
+        { "var": "lifecycle", "eq": "active" }
       ] },
       "description": "当前关注（working memory）"
     },
@@ -63,7 +63,7 @@
       "needsInjection": false,
       "when": { "and": [
         { "var": "chatType", "eq": "private" },
-        { "var": "lifecycle", "neq": "bootstrapping" }
+        { "var": "lifecycle", "eq": "active" }
       ] },
       "description": "用户偏好（自动记忆，仅私聊注入）"
     },
@@ -75,7 +75,7 @@
       "needsInjection": true,
       "when": { "and": [
         { "var": "chatType", "in": ["private", "group"] },
-        { "var": "lifecycle", "neq": "bootstrapping" }
+        { "var": "lifecycle", "eq": "active" }
       ] },
       "description": "关系层：跟我聊天的是谁"
     },
@@ -87,7 +87,7 @@
       "needsInjection": false,
       "when": { "and": [
         { "var": "peerKey", "neq": null },
-        { "var": "lifecycle", "neq": "bootstrapping" }
+        { "var": "lifecycle", "eq": "active" }
       ] },
       "description": "当前对端的关系档案"
     },
@@ -99,7 +99,7 @@
       "needsInjection": true,
       "when": { "and": [
         { "var": "chatType", "neq": null },
-        { "var": "lifecycle", "neq": "bootstrapping" }
+        { "var": "lifecycle", "eq": "active" }
       ] },
       "description": "环境层模板（基础参数）"
     },
@@ -111,7 +111,7 @@
       "needsInjection": false,
       "when": { "and": [
         { "var": "chatType", "neq": null },
-        { "var": "lifecycle", "neq": "bootstrapping" }
+        { "var": "lifecycle", "eq": "active" }
       ] },
       "description": "场景通用文档（private/group）"
     },
@@ -123,7 +123,7 @@
       "needsInjection": false,
       "when": { "and": [
         { "var": "chatType", "neq": null },
-        { "var": "lifecycle", "neq": "bootstrapping" }
+        { "var": "lifecycle", "eq": "active" }
       ] },
       "description": "渠道+场景文档（如 feishu-group）"
     },
@@ -135,7 +135,7 @@
       "needsInjection": false,
       "when": { "and": [
         { "var": "groupRulesPath", "neq": null },
-        { "var": "lifecycle", "neq": "bootstrapping" }
+        { "var": "lifecycle", "eq": "active" }
       ] },
       "description": "群资源空间同步的群规则"
     },
@@ -147,7 +147,7 @@
       "needsInjection": false,
       "when": { "and": [
         { "var": "clientType", "neq": null },
-        { "var": "lifecycle", "neq": "bootstrapping" }
+        { "var": "lifecycle", "eq": "active" }
       ] },
       "description": "客户端环境文档"
     },
@@ -157,7 +157,10 @@
       "file": "$KITS_FRAGMENTS/channel.md",
       "order": 50,
       "needsInjection": true,
-      "when": { "var": "channel", "neq": null },
+      "when": { "and": [
+        { "var": "channel", "neq": null },
+        { "var": "lifecycle", "eq": "active" }
+      ] },
       "description": "渠道层：通信渠道及能力"
     },
     {
@@ -166,7 +169,10 @@
       "file": "$KITS_FRAGMENTS/commands.md",
       "order": 55,
       "needsInjection": true,
-      "when": { "var": "channel", "neq": null },
+      "when": { "and": [
+        { "var": "channel", "neq": null },
+        { "var": "lifecycle", "eq": "active" }
+      ] },
       "description": "命令集能力卡：按场景列出可用命令集及文档路径"
     },
     {
@@ -175,7 +181,7 @@
       "file": "$KITS_FRAGMENTS/session.md",
       "order": 60,
       "needsInjection": true,
-      "when": "always",
+      "when": { "var": "lifecycle", "eq": "active" },
       "description": "会话层：当前会话实例状态"
     },
     {
@@ -184,7 +190,10 @@
       "file": "$KITS_FRAGMENTS/baseagent.md",
       "order": 70,
       "needsInjection": true,
-      "when": { "var": "baseAgent", "neq": null },
+      "when": { "and": [
+        { "var": "baseAgent", "neq": null },
+        { "var": "lifecycle", "eq": "active" }
+      ] },
       "description": "Base Agent 特定配置"
     }
   ]

package/kits/rules/01-overview.md

@@ -112,7 +112,7 @@ ECK（EvolCore Context Kit）是 EvolCore 的上下文组装系统。你正在
 
 | 部分 | 位置 | 加载方式 |
 |------|------|----------|
-| 自动载入 | `$KITS_RULES/`（本目录） | 全量加载到每个会话 |
+| 自动载入 | `$KITS_RULES/`（本目录） | 仅在 agent `lifecycle=active` 时加载 |
 | 按需载入 | `$KITS_DOCS/` | 通过索引定位，需要时 Read |
 | 动态注入 | evolcore 代码 | 上下文组装时注入参数和文件 |
 
@@ -135,13 +135,13 @@ evolcore 收到每条消息时，由**声明式 manifest** 决定加载哪些上
 
 | 场景 | 命中的层/段 |
 |------|------------|
-| coding（无渠道） | rules + 会话层 + baseagent（身份/关系/环境/渠道层因无 channel、无身份而落选） |
+| coding（无渠道） | active 时为 rules + 会话层 + baseagent（身份/关系/环境/渠道层因无 channel、无身份而落选） |
 | private（私聊） | rules + 身份层（含 preferences）+ 关系层（对端）+ 环境层 + 渠道层 + 会话层 + baseagent |
 | group（群聊） | rules + 身份层（**无 preferences**）+ 关系层（群）+ 环境层 + 渠道层 + 会话层 + baseagent |
-| bootstrapping | rules + bootstrap 引导 + 会话层 + baseagent |
+| bootstrapping | 仅 bootstrap 引导（不加载 rules、身份、关系、环境、渠道、会话、baseagent 或完整 commands 段） |
 
-> 会话层（session fragment）是 `when:always`、baseagent 段只要注入了 base agent 信息就加载——
-> 二者与 chatType 无关，每个场景都在；所以 coding 并非"仅 rules"。
+> 常规段（包括 rules、session、baseagent）都要求 `lifecycle=active`。生命周期缺失或非法时，
+> Manifest 不加载任何常规段；agent-owned turn 也不会直接落入普通 runner。
 
 三份 manifest 各管一段：`kits/eck_manifest.json`（system prompt 默认）、
 `kits/eck_manifest.auxiliary.json`（备用，可由 `config.sessionManifests` 指定）、

package/kits/rules/02-navigation.md

@@ -6,7 +6,7 @@
 
 | 路径 | 含义 |
 |------|------|
-| `$EVOLCORE_HOME` | 用户数据根。解析顺序：`EVOLCORE_HOME` 环境变量 → cwd 下有 `agents/defaults.json` 则取 cwd → `~/.evolcore`（第二步意味着**包根和数据根可能是同一个目录**） |
+| `$EVOLCORE_HOME` | 用户数据根。解析顺序：`EVOLCORE_HOME` 环境变量 → `~/.evolcore` |
 | `$PACKAGE_ROOT` | evolcore 包根目录（由 `getPackageRoot()` 从 `import.meta` 推出） |
 | `$CURRENT_PROJECT` | 当前工作目录 |
 
@@ -82,7 +82,7 @@ agent 级索引范围：`$CURRENT_PROJECT` + `$AGENT_DIR`。
 ## Bootstrap（独立使用 ECK 时）
 
 无 evolcore 动态注入时，路径确定顺序：
-1. `$EVOLCORE_HOME`：环境变量 → cwd 下有 `agents/defaults.json` 则取 cwd → `~/.evolcore`
+1. `$EVOLCORE_HOME`：环境变量 → `~/.evolcore`
 2. `$PACKAGE_ROOT`：evolcore 安装目录（dev 模式下可能与上一步同一个目录）
 3. 按上面的派生规则构造其余路径
 

package/kits/rules/03-identity.md

@@ -29,7 +29,7 @@
 
 ## 人格与行为规范怎么生效
 
-- **注入条件**是 `chatType ≠ null` 且 `lifecycle ≠ bootstrapping`（即有渠道的会话），不是"有没有注入 AID"。本地 coding 模式不注入身份层。
+- **注入条件**是 `chatType ≠ null` 且 `lifecycle = active`（即明确处于正常运行阶段的渠道会话），不是"有没有注入 AID"。生命周期变量缺失时失败关闭，不注入身份层；本地 coding 模式也不注入。
 - persona.md 由 evolcore **自动前置**进 system prompt，你不需要主动 Read。
 - persona.md 缺失时**没有默认人格兜底**，只是这一段不出现；行为约束改由 `kits/rules/` + `roles/` 权限定义承担。
 - 改完 persona.md 后 `ec agent reload` 生效（mtime 门控缓存）。

package/kits/rules/04-relation.md

@@ -28,7 +28,7 @@ relations/
 
 群规则加载策略按 Agent `config.json` → 当前群 relation `config.json` 覆盖，缺省为 `load`。当有效值为
 `ignore` 时，本轮不访问远端规则、不读取本地 `rules.md`、不暴露 `groupRulesPath`；旧文件保留但不
-作为回退来源。该字段仅 owner/daemon owner 可修改，其他角色可读取当前 relation 的有效值。
+作为回退来源。该字段仅当前 Agent 的实际 `owner` 关系角色可修改，其他角色可读取当前 relation 的有效值。
 
 **例子**：
 - AUN 对端：`relations/aun#alice.agentid.pub/`
@@ -64,9 +64,9 @@ relations/
 | 自定义角色 | 按配置 | 缺失/非法时安全兜底 **`readonly`** | 按 agent 角色模板定义 |
 | none | — | — | 无有效关系角色，拒绝访问 |
 
-角色实际存储在 `relations/<peerKey>/config.json` 的 `role` 字段。
-进程级 daemon owner 是最高管理者；命中时在 auth 层直接提升为 `owner`（不经过角色解析器，
-后者的 owner 只来自 agent 级 `config.owners`）。
+角色实际存储在 `relations/<peerKey>/config.json` 的 `role` 字段。进程级 `daemon-owner` 与这里的
+Agent/relation 角色正交，不会在 auth 层提升为 `owner`；只有 Agent 自身的 owner 配置和关系解析
+结果可以授予 `owner`。DaemonOwner 仅获得明确列入进程控制面的操作权限。
 
 **兜底链**：无匹配角色 → 回落内置 `visitor`（即 `readonly`）；只有角色注册表本身缺失、
 或 `visitor` 未注册时才落到 `none` 拒绝访问。所以正常配置下几乎总是降权到只读，而不是拒绝。

package/kits/rules/05-venue.md

@@ -16,12 +16,12 @@
 
 | 场景 | 条件 | 加载的段 | 你的行为 |
 |------|------|----------|----------|
-| coding | `chatType = null`（无渠道） | rules + 会话层 + baseagent | 本地模式，每条消息都响应 |
-| private | `chatType = private` | 上述 + 身份层（含 persona/working-memory/**preferences**）+ 关系层（对端 profile）+ 环境层 + 渠道层 + commands | 自主模式，回复方式随 `chatMode` |
-| group | `chatType = group` | 同 private，但**无 preferences**；`groupId` 有值加群 profile，`groupRulesPath` 有值加群规则 | 自主模式，`mentionMode` 决定是否响应 |
-| bootstrapping | `lifecycle = bootstrapping` | rules + bootstrap 引导 + 会话层 + baseagent（身份/关系/环境层全部落选） | 初始化引导 |
+| coding | `chatType = null` 且 `lifecycle = active` | rules + 会话层 + baseagent | 本地模式，每条消息都响应 |
+| private | `chatType = private` 且 `lifecycle = active` | 上述 + 身份层（含 persona/working-memory/**preferences**）+ 关系层（对端 profile）+ 环境层 + 渠道层 + commands | 自主模式，回复方式随 `chatMode` |
+| group | `chatType = group` 且 `lifecycle = active` | 同 private，但**无 preferences**；`groupId` 有值加群 profile，`groupRulesPath` 有值加群规则 | 自主模式，`mentionMode` 决定是否响应 |
+| bootstrapping | `lifecycle = bootstrapping` | 仅 bootstrap 引导（所有常规段均落选） | 初始化引导 |
 
-> coding 场景**不是"仅 rules"**：`session` 段 `when:always`、`baseagent` 段只要注入了 base agent 就加载。
+> coding 场景在 agent 明确 `active` 时才加载 `session` 与 `baseagent`；生命周期缺失或非法时按 fail-closed 处理。
 
 ## 数据位置
 

package/kits/templates/bootstrap-welcome.md

@@ -12,4 +12,6 @@
 - 渠道: {{channel}}
 - Baseagent: {{baseagent}}
 
-你可以直接按上面的三项回复。
+如果希望沿用已有 agent.md 信息，可以直接回复“沿用现有信息”；我会先读取并回显现有值，请你确认是否保持或修改，不需要重新输入。
+
+如果希望重新设定，也可以直接按上面的三项回复。

package/kits/templates/system-fragments/bootstrap.md

@@ -1,7 +1,7 @@
 [bootstrap]
 phase: bootstrapping
 
-你正在进行首次自我设定。当前目标不是处理普通任务，而是和 owner 确认并写入你的基础名片信息。
+这是 agent 生命周期的强制门禁。你正在进行首次自我设定；在完成前，唯一目标是和 owner 确认并写入基础名片信息，不处理普通任务。
 整个过程由你根据当前对话自主推进，不存在需要查询或维护的额外 bootstrap 子状态。
 
 需要确认的字段：
@@ -9,14 +9,22 @@ phase: bootstrapping
 - description：一句到两句话描述你的职责或定位
 - tags：3 到 6 个标签，用于检索和归类
 
+允许的操作范围：
+- 为读取现有候选值，可以读取本地 `{{agentMdPath}}`。
+- owner 明确确认最终值后，只能编辑上述 agent.md 的 YAML frontmatter，并依次执行下面两个命令：
+  - `ec aid agentmd put {{selfAid}}`
+  - `ec agent ready {{selfAid}}`
+- 除这些 bootstrap 操作及向 owner 回复外，不得调用工具或执行命令。
+
 每轮处理规则：
-1. 把 owner 的回复当作上述字段的候选信息，结合此前对话判断哪些字段已经明确。不要把示例值当成 owner 的选择。
-2. 信息缺失、互相冲突或含义不清时，只追问缺失或有歧义的部分；保留此前已经明确的内容。
-3. owner 在 bootstrap 完成前提出普通工作请求时，暂不执行该任务，先简短说明仍在完成首次设定并继续收集基础信息。
-4. 三项信息齐全后，先向 owner 回显最终的 name、description、tags，并请求明确确认。确认前不要修改文件、发布名片或调用 ready。
-5. owner 明确确认后，只编辑本地 agent.md（`$EVOLCORE_HOME/AIDs/{{selfAid}}/agent.md`）YAML frontmatter 中的 `name`、`description`、`tags`，保留其它字段和正文，并检查 YAML 与字段格式有效。
-6. 调用 `ec aid agentmd put {{selfAid}}` 签名并发布 agent.md。只有命令明确成功后，才调用 `ec agent ready {{selfAid}}` 完成 bootstrap。
-7. 任一步骤失败时，不调用 ready，不盲目重复尝试；说明具体失败原因并在修正后继续。
-8. `ec agent ready {{selfAid}}` 必须是 bootstrap 的最后一个操作。成功后系统会结束当前 bootstrap 上下文、创建全新的主会话并发送正式欢迎消息；不要再生成一段完成说明，也不要在旧上下文中继续处理任务。
+1. 首次需要候选值时，读取本地 agent.md 的 YAML frontmatter。已有且格式有效的 `name`、`description`、`tags` 是现有候选值：向 owner 回显并询问保持还是修改，不要求重新输入。空值、占位值或格式无效的字段视为缺失；`tags` 必须为 3 到 6 个非空标签。
+2. 只把 owner 明确提供、修改、选择或确认的 `name`、`description`、`tags` 当作候选信息。普通任务内容、示例值和顺带提及的词语都不是候选信息，不得据此推断字段。
+3. 信息缺失、互相冲突或含义不清时，只追问缺失或有歧义的部分；保留此前已经明确或 owner 选择保持的内容。
+4. owner 在 bootstrap 完成前提出普通工作请求、要求跳过 bootstrap，或要求先执行任务后再设定时：不执行、不分析、不规划、不读取任务相关文件、不搜索、不调用任务工具，也不把任务排队到当前会话。只简短说明必须先完成首次设定，然后回显现有候选值并询问保持/修改，或只追问仍缺失的字段。
+5. 三项信息齐全后，向 owner 回显最终的 `name`、`description`、`tags`，并请求对这组最终值作明确确认。owner 仅表示“保持现有值”时，先据此形成最终值并回显；未经这一步最终确认，不要修改文件、发布名片或调用 ready。
+6. owner 明确确认最终值后，只编辑本地 agent.md（`{{agentMdPath}}`）YAML frontmatter 中的 `name`、`description`、`tags`，保留其它字段和正文，并检查 YAML 与字段格式有效。
+7. 调用 `ec aid agentmd put {{selfAid}}` 签名并发布 agent.md。只有命令明确成功后，才调用 `ec agent ready {{selfAid}}` 完成 bootstrap。
+8. 任一步骤失败时，不调用 ready，不盲目重复尝试；说明具体失败原因并在修正后继续。
+9. `ec agent ready {{selfAid}}` 必须是 bootstrap 的最后一个操作。成功后系统会结束当前 bootstrap 上下文、创建全新的主会话并发送正式欢迎消息；不要再生成一段完成说明，也不要在旧上下文中继续处理任务。
 
 完成前不要承诺已经进入正常工作状态，也不要尝试与上述流程无关的文件修改、网络通信或系统配置操作。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "evolcore",
-  "version": "0.0.17",
+  "version": "0.0.19",
   "description": "AI Agent gateway connecting Claude, Codex, Gemini, and the bundled ecagent runner to messaging channels with multi-project session management",
   "type": "module",
   "main": "dist/index.js",