evolcore 0.0.41-test.0 → 0.0.41-test.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (177) hide show
  1. package/CHANGELOG.md +49 -0
  2. package/dist/agents/baseagent-availability.js +1 -1
  3. package/dist/agents/baseagent.js +20 -43
  4. package/dist/agents/claude-runner.js +177 -92
  5. package/dist/agents/codex-runner.js +84 -28
  6. package/dist/agents/ecagent-runner.js +1 -1
  7. package/dist/agents/gemini-runner.js +1 -1
  8. package/dist/aun/group/fs-download.js +39 -0
  9. package/dist/aun/group/identity.js +36 -21
  10. package/dist/aun/group/operations.js +5 -0
  11. package/dist/aun/msg/managed-operation.js +68 -7
  12. package/dist/aun/msg/p2p.js +5 -0
  13. package/dist/aun/service-proxy.js +36 -12
  14. package/dist/channels/aun.js +334 -20
  15. package/dist/channels/daemon.js +15 -1
  16. package/dist/cli/aun-commands.js +4 -20
  17. package/dist/cli/daemon-commands.js +678 -697
  18. package/dist/cli/fs-command.js +64 -2
  19. package/dist/cli/index.js +48 -4
  20. package/dist/cli/managed-command-guard.js +4 -0
  21. package/dist/cli/model.js +40 -40
  22. package/dist/cli/proxy-command.js +92 -0
  23. package/dist/cli/role.js +85 -0
  24. package/dist/config/access-policy.js +7 -2
  25. package/dist/config/boot-log.js +38 -1
  26. package/dist/config/config-field-policy.js +5 -32
  27. package/dist/config/config-manager.js +46 -39
  28. package/dist/config/config-operation-service.js +5 -19
  29. package/dist/config/contact-book-store.js +47 -21
  30. package/dist/config/contact-book.js +18 -12
  31. package/dist/config/contact-operation-service.js +3 -4
  32. package/dist/config/contact-request-service.js +11 -0
  33. package/dist/config/daemon-services.js +11 -0
  34. package/dist/config/gateway-config.js +88 -594
  35. package/dist/config/peer-role-resolver.js +13 -11
  36. package/dist/config/providers-config.js +12 -7
  37. package/dist/config/providers-import.js +3 -21
  38. package/dist/config/resolved-config-op.js +3 -0
  39. package/dist/config/role-command-service.js +166 -0
  40. package/dist/config/role-request-service.js +193 -0
  41. package/dist/config/schema-migration.js +686 -25
  42. package/dist/config-store.js +79 -3
  43. package/dist/contracts/ecweb-instance.js +41 -0
  44. package/dist/contracts/ecweb-service-protocol.js +3 -1
  45. package/dist/core/agent-runtime.js +1 -1
  46. package/dist/core/auth/agent-delegation.js +2 -1
  47. package/dist/core/auth/auth-gateway.js +1 -1
  48. package/dist/core/auth/authorization-audit.js +17 -6
  49. package/dist/core/auth/delegation-authorization.js +3 -1
  50. package/dist/core/auth/operation-authorizer.js +15 -0
  51. package/dist/core/auth/operation-catalog.js +31 -6
  52. package/dist/core/command/agent-control.js +3 -7
  53. package/dist/core/command/agent-storage-menu.js +5 -3
  54. package/dist/core/command/cli-intent-parser.js +2 -1
  55. package/dist/core/command/command-handler.js +48 -99
  56. package/dist/core/command/connect-menu.js +11 -3
  57. package/dist/core/command/data-root-resolver.js +5 -4
  58. package/dist/core/command/memory-slash.js +16 -8
  59. package/dist/core/command/menu-catalog.js +5 -6
  60. package/dist/core/command/menu-handler.js +49 -62
  61. package/dist/core/command/role-menu.js +147 -30
  62. package/dist/core/command/slash-handler.js +123 -254
  63. package/dist/core/daemon-control.js +8 -14
  64. package/dist/core/evolagent-registry.js +4 -4
  65. package/dist/core/evolagent.js +2 -2
  66. package/dist/core/inference/text-inference.js +31 -40
  67. package/dist/core/ipc-registration.js +6 -2
  68. package/dist/core/memory/consolidation-context.js +51 -5
  69. package/dist/core/memory/consolidation-ops-records.js +1 -1
  70. package/dist/core/memory/consolidation-trigger.js +189 -189
  71. package/dist/core/memory/consolidation.js +316 -29
  72. package/dist/core/memory/forget-log.js +96 -0
  73. package/dist/core/memory/index-manager.js +27 -5
  74. package/dist/core/memory/memory-admin.js +45 -5
  75. package/dist/core/memory/memory-writer.js +163 -18
  76. package/dist/core/memory/relation-idle-monitor.js +119 -58
  77. package/dist/core/memory/relation-sweep.js +44 -39
  78. package/dist/core/message/aun-ipc-sender.js +8 -2
  79. package/dist/core/message/im-renderer.js +7 -4
  80. package/dist/core/message/message-admission.js +89 -4
  81. package/dist/core/message/message-bridge.js +31 -18
  82. package/dist/core/message/response-engine.js +77 -8
  83. package/dist/core/model/catalog-service.js +4 -2
  84. package/dist/core/model/config-scope.js +24 -64
  85. package/dist/core/model/field-scope.js +1 -1
  86. package/dist/core/model/model-catalog.js +30 -41
  87. package/dist/core/model/model-diagnostics.js +4 -3
  88. package/dist/core/model/model-fallback.js +10 -7
  89. package/dist/core/model/model-permission.js +3 -2
  90. package/dist/core/ownership/owner-resolver.js +23 -21
  91. package/dist/core/permission/ec-command-parser.js +30 -2
  92. package/dist/core/permission/sandbox-runtime.js +18 -1
  93. package/dist/core/permission/tool-policy.js +14 -3
  94. package/dist/core/relation/peer-identity.js +64 -1
  95. package/dist/core/role/runtime-policy.js +72 -13
  96. package/dist/core/session/session-capsule.js +1 -1
  97. package/dist/core/session/session-idle-monitor.js +1 -1
  98. package/dist/core/session/session-manager.js +20 -0
  99. package/dist/core/session/session-renew.js +3 -3
  100. package/dist/core/skill/index-generator.js +15 -5
  101. package/dist/core/system-session/memory.js +6 -1
  102. package/dist/core/thread/thread-service.js +19 -6
  103. package/dist/directory/owner-directory-admission.js +95 -0
  104. package/dist/directory/owner-directory-authorization.js +309 -0
  105. package/dist/directory/owner-directory-cache.js +635 -0
  106. package/dist/eck/kit-renderer.js +2 -2
  107. package/dist/ecweb/basic-settings-service.js +33 -40
  108. package/dist/ecweb/message-context-service.js +110 -0
  109. package/dist/index.js +76 -14
  110. package/dist/ipc.js +170 -12
  111. package/dist/paths.js +4 -0
  112. package/dist/proxy/command.js +122 -0
  113. package/dist/proxy/ipc-service.js +68 -0
  114. package/dist/proxy/manager.js +485 -0
  115. package/dist/proxy/service-supervisor.js +603 -0
  116. package/dist/response-system/engines/v1/proactive-flow.js +16 -6
  117. package/dist/utils/cross-platform.js +14 -0
  118. package/dist/utils/ecweb-supervisor.js +258 -83
  119. package/dist/utils/error-utils.js +2 -2
  120. package/dist/utils/logger.js +24 -5
  121. package/dist/utils/package-version-info.js +4 -2
  122. package/kits/docs/channels/aun.md +9 -0
  123. package/kits/docs/evolcore/agent.md +1 -1
  124. package/kits/docs/evolcore/config.md +17 -6
  125. package/kits/docs/evolcore/contact.md +3 -0
  126. package/kits/docs/evolcore/fs.md +11 -0
  127. package/kits/docs/evolcore/memory-architecture.md +2 -2
  128. package/kits/docs/evolcore/memory-consolidation.md +32 -8
  129. package/kits/docs/evolcore/memory.md +1 -1
  130. package/kits/docs/evolcore/menu-protocol.md +4 -0
  131. package/kits/docs/evolcore/model.md +23 -20
  132. package/kits/docs/evolcore/msg.md +4 -7
  133. package/kits/migrations/migrate-contact-book-v2.mjs +30 -11
  134. package/kits/schemas/_meta.json +37 -4
  135. package/kits/schemas/agent-config.schema.13.json +8 -3
  136. package/kits/schemas/agent-config.schema.16.json +891 -0
  137. package/kits/schemas/daemon.schema.9.json +366 -0
  138. package/kits/schemas/defaults.schema.5.json +406 -127
  139. package/kits/schemas/relation-config.schema.11.json +260 -0
  140. package/kits/schemas/role-config.schema.1.json +7 -7
  141. package/kits/skills/.switches.json +3 -7
  142. package/kits/skills/ec-service-proxy/SKILL.md +118 -0
  143. package/kits/skills/ec-trigger/SKILL.md +13 -5
  144. package/kits/skills/personal-assistant/SKILL.md +176 -0
  145. package/kits/skills/personal-assistant/references/01-workspace-spec.md +333 -0
  146. package/kits/skills/personal-assistant/references/02-bootstrap.md +205 -0
  147. package/kits/skills/personal-assistant/references/03-data-flow-and-gaps.md +177 -0
  148. package/kits/skills/personal-assistant/references/04-frontend-contract.md +439 -0
  149. package/kits/skills/personal-assistant/references/05-directory-reference.md +292 -0
  150. package/kits/skills/personal-assistant/references/06-render-config.md +350 -0
  151. package/kits/skills/personal-assistant/schema/workspace.schema.json +85 -0
  152. package/kits/skills/personal-assistant/schema/workspace.v1.json +66 -0
  153. package/kits/skills/personal-assistant/scripts/archive.mjs +154 -0
  154. package/kits/skills/personal-assistant/scripts/check.mjs +114 -0
  155. package/kits/skills/personal-assistant/scripts/index-rebuild.mjs +252 -0
  156. package/kits/skills/personal-assistant/scripts/ingest.mjs +344 -0
  157. package/kits/skills/personal-assistant/scripts/init.mjs +270 -0
  158. package/kits/skills/personal-assistant/scripts/lib/apply.mjs +92 -0
  159. package/kits/skills/personal-assistant/scripts/lib/schema.mjs +96 -0
  160. package/kits/skills/personal-assistant/scripts/lib/time.mjs +28 -0
  161. package/kits/skills/personal-assistant/scripts/migrate.mjs +172 -0
  162. package/kits/skills/personal-assistant/scripts/search.mjs +172 -0
  163. package/kits/skills/personal-assistant/scripts/verify.mjs +196 -0
  164. package/kits/skills/personal-assistant/templates/INDEX.md.tpl +24 -0
  165. package/kits/skills/personal-assistant/templates/README.md.tpl +108 -0
  166. package/kits/skills/personal-assistant/triggers/ingest-daily.json +23 -0
  167. package/kits/skills/personal-assistant/triggers/memory-consolidate.json +23 -0
  168. package/kits/skills/personal-assistant/triggers/report-daily.json +23 -0
  169. package/kits/skills/personal-assistant/triggers/report-weekly.json +23 -0
  170. package/kits/templates/memory-consolidation/forget.md +19 -6
  171. package/kits/templates/memory-consolidation/notes.md +1 -1
  172. package/kits/templates/memory-consolidation/profile.md +2 -2
  173. package/kits/templates/memory-consolidation/promote.md +20 -3
  174. package/kits/templates/roles/member.json +8 -1
  175. package/kits/templates/system-fragments/baseagent.md +2 -2
  176. package/kits/templates/system-fragments/memory.md +4 -4
  177. package/package.json +6 -2
@@ -152,18 +152,29 @@ defaults → agent/config → relation/config
152
152
 
153
153
  ConfigManager 只合并上述物理层并返回物理来源。角色策略不进入配置合并链:`permissionMode` 和 `baseagents.*.model` 由消费方按当前角色单独应用。
154
154
 
155
+ ### 模型默认与 Agent 覆盖
156
+
157
+ 模型选择(`model`、`provider`、`effort`、`fallback`)在 `agents/defaults.json` 提供全局默认,
158
+ 也可在 `agents/<aid>/config.json` 的 `baseagents.<baseagent>` 逐字段覆盖,按上面的覆盖链生效:
159
+
160
+ - `provider` 指 `~/.evolcore/providers.json` 里的服务商 id。网关连接信息(`baseUrl`、`apiKey`、
161
+ `headers`、`queryParams`)只存在于 providers.json,Agent 级不再承载,也不做 `${VAR}` 展开。
162
+ - `fallback` 降级链每一级都必须同时给出 `provider`、`model`、`effort`:降级可能换用不同服务商的不同模型。
163
+ - relation 层不承载 `baseagents`、`active_baseagent`、`model`、`models` 或 `Services`;这些字段在关系层会被剥离。
164
+ - `Services.<用途>`(如 `Services.decision`)也在 defaults 提供全局默认,Agent 可逐字段覆盖。
165
+ - Agent 级未设置模型时,若 defaults 也未设置,该 Agent 才没有模型可用。
166
+ - 只有当前 Agent 的 owner / admin(或 DaemonOwner)可以写模型参数。
167
+
155
168
  ### Codex 用户提问
156
169
 
157
- `baseagents.codex.enableRequestUserInput` 已纳入 defaults → agent → relation 覆盖链,默认 `true`。
170
+ `baseagents.codex.enableRequestUserInput` 走 defaults → agent 覆盖,默认 `true`;relation 层不承载 `baseagents`。
158
171
  它控制 Codex **Default 模式的阻塞式 `request_user_input`**,对应 App Server 的
159
172
  `item/tool/requestUserInput` 请求和 `default_mode_request_user_input` feature。
160
173
  新 turn 会把有效值写入原 Codex thread 的配置;不需要另建线程。
161
174
 
162
175
  ```bash
163
176
  ec config get baseagents.codex.enableRequestUserInput --self bot.agentid.pub
164
- ec config set baseagents.codex.enableRequestUserInput true --self bot.agentid.pub
165
- ec config set baseagents.codex.enableRequestUserInput false \
166
- --self bot.agentid.pub --peer aun#alice.agentid.pub
177
+ ec config set baseagents.codex.enableRequestUserInput false --self bot.agentid.pub
167
178
  ```
168
179
 
169
180
  该字段不是权限审批或 `request_user_input_async` 的关闭开关。`agentMessage.questions`
@@ -237,14 +248,14 @@ peerKey 会规范化;读取不存在的关系仍按已有规则回落到上级
237
248
  Menu 批量请求遇到真实权限拒绝仍整体拒绝并停止执行,不会把权限错误降级为兼容缺项。
238
249
 
239
250
  **写权限**(API 层判定):
240
- - **通用可写字段**:active_baseagent / baseagents / chatmode / show_activities / flush_delay / debounce / render
251
+ - **通用可写字段**:active_baseagent / baseagents / chatmode / show_activities / flush_delay / debounce / render(`active_baseagent`、`baseagents` 只在 Agent 级可写,见“模型参数只在 Agent 级”)
241
252
  - **角色专用入口**:`roles/index.json` 与 `roles/{roleId}.json` 由角色服务维护;relation 的
242
253
  `role` 由角色分配服务维护;`permissionMode` 仅在角色策略中维护
243
254
  - **兼容字段**:`enable_rich_content` 仍可读取旧值,但已废弃且不再产生运行时效果
244
255
  - **群规则策略**:`groupRules.mode` 仅当前 Agent 的实际 owner 可 set/unset;DaemonOwner 不继承群或 relation 写权限,其他角色可读取当前 relation 的有效值
245
256
  - **Agent fullaccess 策略**:Agent 配置中的 `fullaccess.enabled` 缺失时关闭。Menu 写入要求请求者同时是目标 Agent Owner 与 daemon Owner。私聊中的 `/fa`、`/fa on`、`/fa off` 管理当前 EC 会话;主会话写 Agent 配置,话题会话写 session metadata。`/fa <任务信息>` / `/fullaccess <任务信息>` 执行一次性 fullaccess 任务,不改变会话开关;群聊拒绝。每次 Runner 执行仍复核相应 Owner 授权、会话绑定和 fullaccess 能力;CLI 和托管任务不能直接 set/unset Agent fullaccess。Fullaccess Trigger 使用独立的持久授权链。
246
257
  - **源码诊断白名单**:`readonlySourceDiagnostics` 默认关闭;开启后只读会话仅可在项目源码目录执行受限、可证明只读查询,配置/证书/快照/session/锁文件仍禁止访问
247
- - **仅人可写**:channels / owners / admins / 凭证 / aid / enabled / projects / aun / models.allowed
258
+ - **仅人可写**:channels / owners / admins / 凭证 / aid / enabled / projects / aun
248
259
  - Agent 托管环境写仅人字段被拒
249
260
 
250
261
  **操作权限**:
@@ -22,6 +22,9 @@ ec contact block-request <aid> --request-id <id> [--self <agent-aid>]
22
22
  ## 约束
23
23
 
24
24
  - `<aid>` 和 `--self` 必须是合法 AID。
25
+ - 新增或恢复 active 联系人前,必须确认对端为 `private`:依据明确的关系类型或验签名片;缺少证据时先查验名片,
26
+ 未验证、未知、群类型或证据冲突都会拒绝。数字开头的 AID 适用相同规则。
27
+ - 删除角色关系或撤销 Owner 后,既有联系人元数据和拉黑状态仍保留;缺少类型证据的旧条目不能据此授予权限。
25
28
  - Agent 托管会话中的 `add` 只能针对当前 AUN 私聊对端;它创建/更新 `pending`,并向本 Agent Owner 发送审核卡片。
26
29
  - `add` 复用 `/request` 的联系人申请额度、过期和请求版本校验;已有 `pending`/`declined` 条目会重新走申请流程。
27
30
  - Owner 在审核卡片点击“通过”后才变为 active;`blocked` 必须先执行 `unblock`。
@@ -51,6 +51,7 @@ ec fs umount <AID>:<path> # 卸载挂载点
51
51
  - `--content-type <mime>`:上传时指定 MIME
52
52
  - `--public`:上传后公开可读(personal storage)
53
53
  - `--max-bytes <n>`:`cat` 单次读取预算,默认及最高 128 KiB(131072 字节);托管和非托管一致,超限报 `FS_CAT_TOO_LARGE`,不返回截断正文
54
+ - `--authoritative`:仅用于个人空间 `cat`。经当前认证连接完整读取 `storage.get_object`,逐对象核验身份、路径、版本、大小、Base64 和 SHA-256;不走普通下载票据,不与 `--token` 混用
54
55
  - `--head-bytes <n>`:`cat` 二进制头部字节数,默认 256
55
56
  - `--visibility public|private`:`chmod` 可见性
56
57
  - `--allow-roles <roles>`:`chmod` 角色约束,写法固定为单引号包住、逗号分隔,如 `--allow-roles 'owner,admin'`
@@ -110,6 +111,16 @@ ec fs cat <current-peer-aid>:/ability/index.json
110
111
 
111
112
  这个跨 AID 入口仅限 `cat`、仅限当前私聊关系,不允许 `ls/stat/find`、写操作或切换到其他对端;
112
113
  后端 public/ACL 鉴权仍是最终依据。`cat` 单次读取最多 128 KiB,可用 `--max-bytes` 调低预算。
114
+
115
+ 已取得名录持续访问授权时可直接读取固定入口,不用每次先查询能力状态或申请权限:
116
+
117
+ ```bash
118
+ ec fs cat <current-peer-aid>:/data/directories/v1/contacts/manifest.json --authoritative --max-bytes 24576
119
+ ec fs cat <current-peer-aid>:/data/directories/v1/agents/manifest.json --authoritative --max-bytes 24576
120
+ ```
121
+
122
+ 后续索引和页面沿清单引用读取,仍使用 `--authoritative`。明确未授权、过期、撤销或需要扩大范围时,
123
+ 向同一数据所有者的 `directory/access` 申请;网络超时只重试读取。该选项继续受当前托管身份、对端与路径边界约束,不能用于群空间。
113
124
  个人存储内联读取携带预算加一字节的探测范围;HTTP 下载逐块计数,超限立即中止,
114
125
  单次 HTTP 读取最多等待 30 秒。文件大小元数据不能替代实际读取校验;非文本内容只返回有界摘要。
115
126
  需要更大文件时使用 `ec fs cp` 下载,不将大文件直接塞入会话上下文。
@@ -27,8 +27,8 @@ relation 是所有记忆的唯一出生地,agent 级和 owner 级都由它升
27
27
  |------|------|
28
28
  | 上下文压缩前 | 自动。反馈回压缩时的会话和话题 |
29
29
  | renew / 新会话创建时 | 自动。反馈回发起时的会话和话题 |
30
- | 关系空闲 / 兜底 | 自动,**主路径**。一个关系空闲 `idleHours`(默认 1 小时)或最早未整理入站满 `maxUnconsolidatedHours`(默认 8 小时),对该关系依次跑 notes → generalize → promote → profile → forget;**不反馈** |
31
- | 定时检查 | 自动。只管 agent 层 / owner 层 forget,外加 pending 堆积兜底(转成该关系的整理链);**不反馈** |
30
+ | 关系空闲 / 兜底 | 自动,**主路径**,管内容驱动的 notes → generalize → promote。一个关系最后一次活动(入站、写 note)后空闲 `idleHours`(默认 1 小时),跑候选攒够 `minBatchItems`(默认 3)条的步骤;最早一次未整理活动满 `maxUnconsolidatedHours`(默认 8 小时),有 1 条候选就跑;**不反馈** |
31
+ | 定时检查 | 自动,每小时,管时间驱动的整理:逐关系检查画像到期(profile)与关系层超期(forget),外加 agent 层 / owner 层 forget;**不反馈** |
32
32
  | 手动 | `ec memory consolidate [--mode ...]`。反馈回当前会话的当前话题 |
33
33
 
34
34
  **整理一律以关系为单位**,一个会话只处理一个关系;群聊按群算一个关系。所有触发路径都收口到统一入口 `launchConsolidation()`,它负责完整生命周期:启动前把 `pending/` 移入 `processing/` 加锁、序列化上下文、直接创建整理会话、会话结束后收尾(归档 note、写 checkpoint、定稿重建索引、反馈)。
@@ -38,8 +38,14 @@
38
38
  **统一入口 `launchConsolidation()`**:所有触发路径——关系整理链、手动调用、定时检查、上下文压缩、renew / `/new`——都收口到这一个函数。它负责整理的完整生命周期:启动前把 `pending/` 加锁移入 `processing/`,序列化上下文文件,**直接创建整理会话**,会话结束后通过 `onConsolidationComplete` 处理收尾(归位、checkpoint、定稿索引、反馈)。
39
39
 
40
40
  **整理一律以关系为单位**,一个会话只处理一个关系。触发方:
41
- - **关系整理链**(主路径):每个关系一个计时器。最后一条入站后空闲 `idleHours`(默认 1 小时),或最早一条未整理入站满 `maxUnconsolidatedHours`(默认 8 小时),对该关系依次跑 notes → generalize → promote(仅 owner 关系)→ profile → forget,每步收尾后再判定下一步,没有候选就跳过。触发来源 `relation-idle`,**不反馈**。只计真实入站(含群里未被 @ 的消息;owner 插话不算)。
42
- - **定时检查**:evolcore trigger 的 `script` 模式每小时执行,只管不属于任何关系的部分——agent 层、owner 层的 forget;外加兜底,pending 堆积超过 `backlogHours` 的关系转成该关系的整理链。
41
+ - **关系整理链**(主路径,内容驱动):每个关系一个计时器,对该关系依次跑 notes → generalize → promote(仅 owner 关系),每步收尾后再判定下一步。
42
+ - 空闲到期:最后一次活动后 `idleHours`(默认 1 小时)没有新活动。只跑候选攒够 `minBatchItems`(默认 3)条的步骤,不够的推迟。
43
+ - 兜底到期:最早一次未整理的活动满 `maxUnconsolidatedHours`(默认 8 小时),持续聊天也会到期。有 1 条候选就跑。
44
+ - 候选:notes 数 pending 里的 note,generalize 数本关系 `to-generalize`,promote 数本关系 **与 agent 层**的 `to-promote`。
45
+ - 活动:真实入站(含群里未被 @ 的消息;owner 插话不算)、往该关系写 note、群链按发言人写入该关系。
46
+ - 触发来源 `relation-idle`,**不反馈**。
47
+ - **定时检查**(时间驱动):evolcore trigger 的 `script` 模式每小时执行,逐关系检查画像到期(profile:还没有画像且已有记忆,或画像生成后有新建记忆且画像满 `profileRegenDays`;距上次尝试不满 `profileRegenDays` 不再拉起)和关系层超期记忆(forget),外加 agent 层、owner 层的 forget。agent 层有 `to-promote` 时也在这里按 owner 关系兜底拉起 promote(标签不是 generalize 打的,或泛化收尾时还没有 owner 关系目录)。一个会话只处理一个关系或一层,同样的整理已在排队或在跑时跳过。
48
+ - **泛化收尾跨层触发**:generalize 会话成功收尾时,若 agent 层有 `to-promote`,立即按 owner 关系拉起 promote(排在本 agent 的串行队列里,槽位一空就跑)。本次 generalize 若就是 owner 关系整理链的一步则跳过——链的下一步就是 promote。agent 级记忆不挂任何关系,关系整理链等不到它的空闲,这是它的主路径;agent 层标签不攒批,有 1 条就跑。触发来源 `relation-idle`,不反馈。
43
49
  - **手动 / compact / renew / `/new`**:直接对当前关系调用 `launchConsolidation()`。
44
50
 
45
51
  **并发与排队**:同一 agent 同时只能有一个整理会话在跑;全局最多 5 个 agent 并发。超出的请求排队,前一个结束后自动启动下一个。
@@ -52,7 +58,7 @@
52
58
  |---|---|---|---|---|
53
59
  | `notes` | 当前关系的 `pending/` + 会话历史 | relation 正式记忆 | 值不值得长期留下 | 否 |
54
60
  | `generalize` | 关系级里带 `to-generalize` 的记忆 | agent 正式记忆 | **普遍性**:换成别的对端也成立 | 否 |
55
- | `promote` | 关系级里带 `to-promote` 的记忆 | owner 正式记忆 | **权威性**:owner 定下、对所有 agent 有效 | **是** |
61
+ | `promote` | 关系级与 agent 层带 `to-promote` 的记忆 | owner 正式记忆 | **权威性**:owner 定下、对所有 agent 有效 | **是** |
56
62
  | `profile` | 该关系索引里的全部记忆 | 一条带 `profile` 标签的 relation 记忆 | 归纳对端这个主体 | 否 |
57
63
  | `forget` | mtime 超过 `forgetAfterDays` 的记忆 | 无新结论,只做续期 / 合并 / 归档 | 这条还成立吗 | 否 |
58
64
 
@@ -79,6 +85,7 @@ ec memory create --scope <relation|agent|owner> --slug <slug> --desc '一句话
79
85
  - **目标 slug 已存在且未在 `--replaces` 里列出 → 拒绝**,报错回传已有文件路径。这是防止漏用 `--replaces` 导致静默覆盖的闸门。
80
86
  - **正文上限 10KB**,超出报 `MEMORY_TOO_LARGE`。这不是技术限制,而是记忆的性质决定的:一条记忆应当是**一句话能说清的结论**。内容确实那么多时,拆成多条分别 `create`,或把细节留在归档文件里、记忆只记结论。
81
87
  - `--reason` 写进批次目录的 `ops.jsonl` 操作流水,不进记忆正文。结论属于记忆,判断依据属于过程记录。
88
+ - forget 模式下 `update` / `archive` / `create --replaces` 必须带 `--reason`(≤80 字,针对这一条记忆),`update` 只能 `--touch`,`archive` 一次一条;理由另记入遗忘日志(见第八节)。
82
89
 
83
90
  ### 跨层路径
84
91
 
@@ -140,7 +147,8 @@ daemon 按整理会话的模式校验 `--scope`:
140
147
  **其他写入限制**:
141
148
 
142
149
  - **整理一律以关系为单位:带前缀的路径里 peerKey 必须是本次会话所属关系**,所有模式都一样。整理会话的可读根只含当前关系的 `consolidated/`,允许写别的关系等于对读不到的目录做归档,绕过 grants 边界。没有所属关系的会话(owner 层 / agent 层 forget)不接受带前缀的路径。
143
- - 唯一的例外是群聊 notes 的 `--peer`:按发言人把记忆写进发言人自己的关系。被写入的关系在群的整理链结束后会各补一轮整理。
150
+ - 保留前缀 `agent/` 指本 agent 的 `personal/memory/consolidated/`(`agent/consolidated/x.md`)。它不是关系名,不受"必须是所属关系"限制;promote 从 agent 层取候选时用它寻址。
151
+ - 唯一的例外是群聊 notes 的 `--peer`:按发言人把记忆写进发言人自己的关系。被写入的关系在群的整理链结束后各记一次活动,按它自己的空闲 / 兜底计时整理。
144
152
  - `profile` 标签的记忆,一个关系只能有一条。重新生成必须用 `--replaces` 指定旧的那条。
145
153
  - `to-promote` 只能打在对端是 owner 的关系上。群聊关系额外检查发言人身份,owner 本人说的话可以打。
146
154
  - 全局总开关是 `memory.enableRelation`。它关闭时,五种模式和手动调用全部拒绝。
@@ -156,7 +164,7 @@ daemon 按整理会话的模式校验 `--scope`:
156
164
  **`notes` 模式**的输入是:
157
165
 
158
166
  - `pending/` 里的全部 note
159
- - 会话历史(整理会话带了该关系的路由时生成话题快照:`compress` / `session-new` / `manual`,以及关系整理链 `relation-idle`;没有路由的补漏整理没有会话历史,只能凭 note 本身判断)
167
+ - 会话历史(整理会话带了该关系的路由时生成话题快照:`compress` / `session-new` / `manual`,以及关系整理链 `relation-idle`、定时检查拉起的关系级 profile / forget;该关系没有入站记录、拿不到路由时没有会话历史,只能凭 note 本身判断)
160
168
  - 现有的 `MEMORY.md` 索引(查重用)
161
169
 
162
170
  **`launchConsolidation()` 在拉起整理会话之前会把 `pending/` 整体 rename 到 `processing/`**,相当于加锁声明认领。整理过程中主会话新写的 note 落在 `pending/`,不会被这次整理误伤,也不会被误删。
@@ -186,7 +194,11 @@ daemon 按整理会话的模式校验 `--scope`:
186
194
  - 往 `ops.jsonl` 追加一行 `summary`(created / updated / archived / errors 计数)。
187
195
  - 导出整理会话历史到 `history.jsonl`。
188
196
 
189
- 索引 `MEMORY.md` 在每次 `create` / `update` / `archive` 后已即时重建,收尾不再重复。
197
+ 整理会话里的 `create` / `update` / `archive` 只写文件、追加 `ops.jsonl`,**不重建索引**。收尾时按 `ops.jsonl` 里出现过的层逐层 `rebuildIndex`(`collectAffectedScopes`),失败回撤之后也重建一次,把索引对齐到磁盘现状。只有 `ec memory demote` 会在写完后即时重建源层与目标层。
198
+
199
+ **失败 / 中断的回撤**:按 `ops.jsonl` 倒序撤掉成功的写操作(create 删文件并还原被归档的旧文件;archive 从 `archive/` 移回;update 恢复 tags、`updatedAt`、mtime),每一步都过完整性台账。撤掉的如果是遗忘日志里记过的操作,同一份日志会补一行「撤销…」(来源 `rollback:<批次目录名>`)。
200
+
201
+ > daemon 中途退出时收尾不会执行,这批日志就没有对应的「撤销」行。下一轮遗忘看到同一批记忆时照常按内容重新判断,日志只如实记录发生过什么,不做自动对账。
190
202
 
191
203
  上一批的 `processing/` 还在时(会话未结束,或 daemon 中途重启丢了收尾),新一轮 notes 整理不迁移 `pending/`,避免两批混在一起。
192
204
 
@@ -234,9 +246,21 @@ daemon 按整理会话的模式校验 `--scope`:
234
246
  ├── processing/ # 整理中快照
235
247
  ├── consolidated/ # 正式记忆(已登记完整性台账),文件名即 <slug>.md
236
248
  └── archive/
237
- └── notes/ # 整理完成的 pending 原件
249
+ ├── consolidated/ # 归档的正式记忆
250
+ ├── notes/ # 整理完成的 pending 原件
251
+ └── FORGET-LOG.md # 遗忘日志(审计记录,不是记忆,不进索引)
238
252
  ```
239
253
 
254
+ **遗忘日志** `archive/FORGET-LOG.md`:遗忘机制每动一条记忆,就在该记忆所在层追加一行,记时间、动作、记忆、理由、来源。只追加,不随整理批次目录清理。
255
+
256
+ | 动作 | 何时写 | 来源列 |
257
+ |---|---|---|
258
+ | `续期` / `归档` / `合并归档→<新slug>` | forget 会话的 `update --touch` / `archive` / `create --replaces` | 批次目录名 |
259
+ | `撤销续期` / `撤销归档` / `撤销合并` | forget 会话失败,回撤上面的操作 | `rollback:<批次目录名>` |
260
+ | `手动归档` / `恢复` | `/memory archive` / `/memory restore` | `slash:<发起人 AID>` |
261
+
262
+ 其他模式 `--replaces` 产生的归档、长期记忆的推迟审查都不写。整理会话读不到这份日志,每次审查按记忆内容重新判断。
263
+
240
264
  **索引**:每个作用域一份,上限 `memory.indexMaxBytes`(默认 5KB)。重建时**逐份过完整性台账**:被带外修改的先恢复到最后登记的版本再进索引,被改动且无法恢复的跳过、不移动文件。筛选顺序:
241
265
 
242
266
  1. `important`、`urgent`、`profile` 必进,**永不淘汰**
@@ -254,7 +278,7 @@ daemon 按整理会话的模式校验 `--scope`:
254
278
 
255
279
  没进索引的文件仍留在磁盘上,可以搜到;只有 `archive` 才让它下线。
256
280
 
257
- **整理批次**:`$EVOLCORE_HOME/memory/consolidation-batches/`,每次整理建一个批次目录,命名为 `YYYYMMDDTHHmmss-<selfAid>-<mode>/`,目录内含 `context.md`(任务书)、`ops.jsonl`(操作流水)、`threads/`(话题快照)。不自动清理,由人工维护。详细结构见 `memory-consolidation-batches.md`。
281
+ **整理批次**:`$EVOLCORE_HOME/memory/consolidation-batches/`,每次整理建一个批次目录,命名为 `YYYYMMDDTHHmmss-<selfAid>-<mode>/`,目录内含 `context.md`(任务书)、`ops.jsonl`(操作流水)、`threads/`(话题快照)。每次拉起整理时程序只保留最新的 10 个批次目录(所有 agent、所有模式共用这 10 个名额),更早的整个删掉。遗忘日志不在批次目录里,不受清理影响。详细结构见 `memory-consolidation-batches.md`。
258
282
 
259
283
  ---
260
284
 
@@ -73,7 +73,7 @@ ec memory consolidate [--mode <notes|generalize|promote|profile|forget>]
73
73
  | `generalize` | 关系级 → agent 级 | 对端说「不管跟谁聊你都要记得这个」 |
74
74
  | `promote` | 关系级 → owner 级 | owner 说「让我所有 Agent 都记住这个」 |
75
75
  | `profile` | 生成/重建当前对端画像 | owner 说「重新生成一下画像」 |
76
- | `forget` | 评估超期记忆续期或归档 | 一般不手动:关系层由关系整理链发起,agent / owner 层由定时检查发起 |
76
+ | `forget` | 评估超期记忆续期或归档 | 一般不手动:关系层、agent 层、owner 层都由定时检查发起 |
77
77
 
78
78
  **命令是异步的**:`launchConsolidation()` 在拿到整理会话的 base agent 会话 ID 后命令即退出,不等整理会话完成。输出示例:
79
79
 
@@ -122,6 +122,10 @@ Menu Protocol 是 EvolCore 在 AUN `message.send` 之上建立的**应用层协
122
122
  }
123
123
  ```
124
124
 
125
+ `/model` 与 `/effort` 的更新只写当前 Agent 的 Agent 级配置(`baseagents.<baseagent>.model` / `effort`),
126
+ 只有当前 Agent 的 owner / admin 可以执行;`args.scope` 被忽略,没有关系级模型。关系菜单不再提供模型与推理强度项,
127
+ 对应设置项为 Agent 菜单的 `model.agent` / `effort.agent`。查询返回 Agent 级配置经角色约束后的值;Agent 级未配置时 `model` 为 `null`。
128
+
125
129
  `name="session"` 且 `args.resource="loop"` 时,`value` 必须是 JSON boolean:
126
130
  `true` 开启当前可信主话题或话题的一次闲置触发,`false` 关闭;开启时可在
127
131
  `args.idleSeconds` 指定 30–86400 的整数,省略时使用 300 秒。目标由当前关系和可信
@@ -1,54 +1,57 @@
1
1
  # ec model - 模型管理命令集
2
2
 
3
- 按作用域查看或设置 agent 使用的模型与推理强度。`ec model` 修改持久化配置,对该作用域内所有会话的下一条消息生效;`ec ctl model` 只操作当前运行会话。
3
+ 查看或设置 agent 使用的模型与推理强度。模型参数只在 Agent 级配置:`agents/<aid>/config.json` 的 `baseagents.<baseagent>.model` / `effort`。关系级配置和 `agents/defaults.json` 都不承载模型参数;Agent 级未设置模型时,该 Agent 没有模型可用,收到消息会回复“未配置模型”提示,不回落任何默认模型。
4
+
5
+ `ec model` 修改 Agent 级持久化配置,对该 Agent 所有会话的下一条消息生效。
4
6
 
5
7
  ## 命令
6
8
 
7
9
  ```bash
8
- # 列出可用模型并显示当前生效模型
10
+ # 列出可用模型并显示当前 Agent 级模型
9
11
  ec model list [--self <aid>] [--peer <peer>] [--role <role>]
10
12
 
11
- # 显示生效模型、推理强度和配置来源
13
+ # 显示 Agent 级模型(经角色约束)、推理强度和配置来源
12
14
  ec model current [--self <aid>] [--peer <peer>] [--role <role>]
13
15
 
14
16
  # 查看单个模型详情
15
17
  ec model info <model-id> [--self <aid>]
16
18
 
17
- # 设置模型,可同时设置推理强度;本机终端写操作需要 --self
18
- ec model use <model-id> --self <aid> [--peer <peer>] [--effort <level>]
19
+ # 设置 Agent 级模型,可同时设置推理强度
20
+ ec model use <model-id> --self <aid> [--effort <level>]
19
21
 
20
- # 设置推理强度:low | medium | high | xhigh | max | auto
21
- ec model effort <level> --self <aid> [--peer <peer>]
22
+ # 设置 Agent 级推理强度:low | medium | high | xhigh | max | auto
23
+ ec model effort <level> --self <aid>
22
24
 
23
- # 清除当前作用域的模型和推理强度,回落到上一级
24
- ec model reset --self <aid> [--peer <peer>]
25
+ # 清除 Agent 级模型和推理强度;清除后该 Agent 无模型可用
26
+ ec model reset --self <aid>
25
27
 
26
- # 诊断网关连通性、模型目录和模型可用性
28
+ # 诊断网关连通性、模型目录和 Agent 级模型可用性
27
29
  ec model check [--self <aid>]
28
30
  ```
29
31
 
30
32
  ## 作用域
31
33
 
32
- | 参数 | 作用域 | 配置位置 |
33
- |------|--------|----------|
34
- | 无 | 只读 catalog/defaults | 不允许写入 |
35
- | `--self <aid>` | agent | `agents/<aid>/config.json` |
36
- | `--self <aid> --role <role>` | 角色策略预览 | 只读;写入由角色策略编辑器管理 |
37
- | `--self <aid> --peer <peer>` | 关系 | `agents/<aid>/relations/<peerKey>/config.json` |
34
+ | 参数 | 用途 | 配置位置 |
35
+ |------|------|----------|
36
+ | 无 | 只读 catalog | 不允许写入 |
37
+ | `--self <aid>` | Agent 级读写 | `agents/<aid>/config.json` |
38
+ | `--self <aid> --role <role>` | 按角色策略预览有效模型 | 只读;角色策略由角色策略编辑器管理 |
39
+ | `--self <aid> --peer <peer>` | 按该对端的关系角色预览有效模型 | 只读;`use` / `effort` / `reset` 带 `--peer` 直接拒绝(`MODEL_AGENT_ONLY`) |
38
40
 
39
- 生效优先级为关系、角色、agent、defaults。`--peer` 可使用 `channelType#channelId`;裸 AID 按 `aun#<aid>` 处理。
41
+ 角色策略只约束 Agent 级模型(模型白名单、固定模型),不提供模型:Agent 级未设置模型时,角色策略不会补出一个模型。`--peer` 使用 `channelType#channelId`;裸 AID 按 `aun#<aid>` 处理。
40
42
 
41
- 在 EvolCore 托管会话中,所有 `ec model` 子命令都通过 daemon 的 `ec ctl` 路径作用于已认证的当前会话,不能指定 `--self`、`--peer` 或 `--role`;上表的显式作用域仅适用于宿主终端。需要读取或修改持久化模型配置时,使用 `ec config`,由 daemon 按实际角色和目标范围鉴权。本机终端不具备隐式当前会话语义。
43
+ 在 EvolCore 托管会话中,所有 `ec model` 子命令都通过 daemon 的 `ec ctl` 路径作用于已认证的当前会话,不能指定 `--self`、`--peer` 或 `--role`;上表的显式参数只用于宿主终端。需要读取或修改持久化模型配置时,使用 `ec config`,由 daemon 按实际角色和目标范围鉴权。本机终端不具备隐式当前会话语义。
42
44
 
43
45
  帮助查询不选择目标或执行操作,`ec model list --self <aid> --help` 等形式仍可查看帮助。
44
46
 
45
47
  ## 输出与权限
46
48
 
47
49
  - 所有子命令支持 `--format json`。
48
- - 从聊天菜单或 agent 工具调用时,命令会在执行前经过 operation 鉴权;关系目标默认限制为当前 agent 和当前关系。
50
+ - 从聊天菜单、slash 命令或 agent 工具调用时,命令会在执行前经过 operation 鉴权。
51
+ - `use`、`effort`、`reset` 只能写 Agent 级,且只有当前 Agent 的 owner / admin(或 DaemonOwner)可以执行;这是代码级上限,角色文件授予 `model.*` 也不能让其他角色写入。member、visitor 只能查看。
49
52
  - 本地终端直接运行时不伪造远端角色。显式传入 `--role` 可检查该角色的模型可见性和有效模型。
50
53
  - `use`、`effort`、`reset` 不直接修改角色策略;传入 role 写作用域会返回 `ROLE_POLICY_MANAGED`。
51
- - `check` 会连接已配置的模型网关并发送最小探测请求;未配置自定义网关时跳过 API 探测。
54
+ - `check` 会连接已配置的模型网关并发送最小探测请求;未配置自定义网关时跳过 API 探测。Agent 级未配置模型时,“配置模型”一步标记为失败。
52
55
 
53
56
  ## 模型参数与执行窗口
54
57
 
@@ -80,18 +80,15 @@ Windows 或包含复杂 JSON 时优先使用 `--payload-file`。临时文件先
80
80
 
81
81
  托管会话中的附件源文件必须位于当前项目目录或当前会话 `$TMPDIR` 内;符号链接、硬链接、路径穿越和受保护路径会被拒绝。
82
82
 
83
- 托管 Agent 通过 daemon 发送时,若发送方使用 `policyMode: contacts`,私聊普通出站只允许 Owner 或实际 `active` 联系人。无条目、`pending`、`declined` 会拒绝发送并提示:
84
-
85
- ```bash
86
- ec contact add <target-aid> --self <self-aid>
87
- ```
88
-
89
- 该命令在托管会话中会创建/更新联系人申请并给 Owner 发送审核卡片;`blocked` 目标必须先执行:
83
+ 托管会话主动执行 `ec msg send` 时,系统会先校验目标关系权限,再将无条目、`pending` 或
84
+ `declined` 的私聊目标加入本 Agent 联系人簿并设为 `active`,然后继续发送。`blocked` 目标仍会拒绝发送,必须先执行:
90
85
 
91
86
  ```bash
92
87
  ec contact unblock <target-aid> --self <self-aid>
93
88
  ```
94
89
 
90
+ `ec group send` 走群关系权限,不使用私聊联系人准入;群 AID 不写入 Contact Book。
91
+
95
92
  非托管环境的 `ec msg send` 是独立 AUN CLI 发送,不读取或要求 `agents/<aid>/config.json`,因此不会触发这套 Agent 联系人准入判断。
96
93
 
97
94
  在 EvolCore 会话内,发送会经过当前 session 的 self/peer/role 鉴权。`visitor` 或 `member` 默认只允许回复当前对端;要联系当前对端以外的对象,必须通过话题路由:先 `ec thread list <对方AID>` 选话题(没有就 `ec thread create`),再用 `ec msg send '<text>' --thread <threadId> --check-every <时长>` 发送;from/to 由话题推断,无需手写。不带 `--thread` 直接改目标会被拒绝。`--check-every` 到期后,系统会向**目标话题**投递一条【跨话题复查】通知(不新建会话),由目标话题侧的 agent 在自己的上下文里决定结束、调整周期或继续。完整话题路由操作序列见 `[thread]` 段。没有成功 JSON 回执(含 `message_id`/`status`)不得声称已发送。
@@ -3,9 +3,13 @@ import os from 'os';
3
3
  import path from 'path';
4
4
  import crypto from 'crypto';
5
5
  import { fileURLToPath } from 'url';
6
+ import { createRequire } from 'node:module';
6
7
  import Ajv from 'ajv';
7
8
 
8
9
  const SCRIPT_DIR = path.dirname(fileURLToPath(import.meta.url));
10
+ const requireCore = createRequire(import.meta.url);
11
+ // Use the same pure policy as the daemon. Published packages always include dist.
12
+ const { resolveAunTargetKind, verifiedPeerType } = requireCore('../../dist/aun/group/identity.js');
9
13
  const SCHEMA_DIR = path.resolve(SCRIPT_DIR, '..', 'schemas');
10
14
  const AGENT_LOCK_NAME = '.contact-book-mutation.lock';
11
15
  const RECEIPT_NAME = 'contact-book-v2-relation-role-authority.json';
@@ -44,14 +48,6 @@ function isValidAid(name) {
44
48
  return labels.length >= 3 && labels.every(label => /^[a-zA-Z0-9](?:[a-zA-Z0-9-]*[a-zA-Z0-9])?$/.test(label));
45
49
  }
46
50
 
47
- function isExplicitGroupId(value) {
48
- const id = String(value || '').trim();
49
- return (id.startsWith('group.') && id.includes('/'))
50
- || /^\d+\.[a-z0-9.-]+$/i.test(id)
51
- || /^grp_[a-z0-9_-]+$/i.test(id)
52
- || /^g-[a-z0-9_-]+(?:[.@][a-z0-9.-]+)?$/i.test(id);
53
- }
54
-
55
51
  function readJson(file) {
56
52
  const text = fs.readFileSync(file, 'utf8');
57
53
  return { value: JSON.parse(text), text };
@@ -395,18 +391,37 @@ function planAgentMigration(home, aid, validators, changes, summary, backupRoles
395
391
  if (!isRecord(rawContacts)) throw new Error(`${contactFile}: contacts must be an object`);
396
392
  const contacts = {};
397
393
  const aliasOwners = new Map();
394
+ const resolvePeerKind = (peerAid, subjectType) => {
395
+ const peerKey = canonicalPeerKey('aun', peerAid);
396
+ const identityFile = path.join(relationsDir, peerKey, 'peer-identity.json');
397
+ const identity = fs.existsSync(identityFile) ? readJson(identityFile).value : undefined;
398
+ return resolveAunTargetKind({
399
+ targetKind: relations.get(peerKey)?.value.targetKind,
400
+ routeKind: subjectType === 'group' ? 'group' : subjectType === 'principal' ? 'private' : undefined,
401
+ verifiedType: verifiedPeerType(peerAid, identity),
402
+ });
403
+ };
398
404
 
399
405
  for (const [primaryId, rawEntry] of Object.entries(rawContacts)) {
400
406
  if (!isValidAid(primaryId)) throw new Error(`${contactFile}: invalid contact primary AID ${JSON.stringify(primaryId)}`);
401
407
  if (!isRecord(rawEntry)) throw new Error(`${contactFile}: contact ${primaryId} must be an object`);
402
408
  const unknown = Object.keys(rawEntry).filter(key => !CONTACT_KEYS.has(key));
403
409
  if (unknown.length) throw new Error(`${contactFile}: contact ${primaryId} has unsupported fields ${unknown.join(', ')}`);
404
- const subjectType = rawEntry.subjectType ?? (isExplicitGroupId(primaryId) ? 'group' : 'principal');
405
- if (subjectType !== 'principal' && subjectType !== 'group') {
406
- throw new Error(`${contactFile}: contact ${primaryId} has invalid subjectType ${JSON.stringify(subjectType)}`);
410
+ if (rawEntry.subjectType !== undefined && rawEntry.subjectType !== 'principal' && rawEntry.subjectType !== 'group') {
411
+ throw new Error(`${contactFile}: contact ${primaryId} has invalid subjectType ${JSON.stringify(rawEntry.subjectType)}`);
407
412
  }
413
+ const kind = resolvePeerKind(primaryId, rawEntry.subjectType);
414
+ if (kind.reason !== 'missing' && kind.kind === 'unknown') {
415
+ throw new Error(`${contactFile}: contact ${primaryId} type is unknown (${kind.reason}); explicit type evidence is required`);
416
+ }
417
+ if (kind.kind === 'unknown' && rawEntry.role !== undefined) {
418
+ throw new Error(`${contactFile}: contact ${primaryId} has a role but its type is unknown; explicit type evidence is required`);
419
+ }
420
+ const subjectType = kind.kind === 'group' ? 'group' : kind.kind === 'private' ? 'principal' : undefined;
421
+ if (kind.kind === 'private') ensureRelation('aun', primaryId, 'private');
408
422
  const contactRole = roleValue(rawEntry.role, roleIds, contactFile, `contact ${primaryId} role`);
409
423
  if (contactRole) {
424
+ if (!subjectType) throw new Error(`${contactFile}: contact ${primaryId} role has no type evidence`);
410
425
  const targetKind = subjectType === 'group' ? 'group' : 'private';
411
426
  const relation = ensureRelation('aun', primaryId, targetKind);
412
427
  if (relation.value.role === undefined) {
@@ -467,6 +482,10 @@ function planAgentMigration(home, aid, validators, changes, summary, backupRoles
467
482
  const admin = String(rawAdmin || '').trim();
468
483
  if (!isValidAid(admin)) throw new Error(`${agentFile}: invalid admin AID ${JSON.stringify(rawAdmin)}`);
469
484
  if (owners.has(admin)) continue;
485
+ const kind = resolvePeerKind(admin);
486
+ if (kind.kind !== 'private') {
487
+ throw new Error(`${agentFile}: admin ${admin} requires private type evidence (${kind.reason}); roles do not establish peer type`);
488
+ }
470
489
  const relation = ensureRelation('aun', admin, 'private');
471
490
  if (relation.value.role !== 'admin') summary.adminsMigrated += 1;
472
491
  relation.value.role = 'admin';
@@ -4,16 +4,31 @@
4
4
  "currentVersion": 1
5
5
  },
6
6
  "daemon": {
7
- "currentVersion": 8
7
+ "currentVersion": 9
8
8
  },
9
9
  "defaults": {
10
- "currentVersion": 5
10
+ "currentVersion": 5,
11
+ "history": []
11
12
  },
12
13
  "agent-config": {
13
- "currentVersion": 13
14
+ "currentVersion": 16,
15
+ "history": [
16
+ {
17
+ "version": 16,
18
+ "date": "2026-10-27",
19
+ "description": "合并 v15 模型与 Provider 配置调整,并增加 Owner 通讯录和 Owner Agent 名录的入站联系开关;旧配置直接迁移到 v16"
20
+ }
21
+ ]
14
22
  },
15
23
  "relation-config": {
16
- "currentVersion": 9
24
+ "currentVersion": 11,
25
+ "history": [
26
+ {
27
+ "version": 11,
28
+ "date": "2026-10-27",
29
+ "description": "删除 baseagents/active_baseagent/model/models;关系级不承载模型参数;新增 sessionFullAccess,跨 EC session 保留主会话 /fa 开关"
30
+ }
31
+ ]
17
32
  },
18
33
  "contact-book": {
19
34
  "currentVersion": 3
@@ -29,12 +44,24 @@
29
44
  }
30
45
  },
31
46
  "history": [
47
+ {
48
+ "schema": "agent-config",
49
+ "version": 16,
50
+ "date": "2026-10-27",
51
+ "description": "合并 v15 模型与 Provider 配置调整,增加 Owner 名录入站联系开关;旧配置直接迁移到 v16,保留既有 access 配置"
52
+ },
32
53
  {
33
54
  "schema": "providers",
34
55
  "version": 1,
35
56
  "date": "2026-10-20",
36
57
  "description": "global providers managed by ConfigManager"
37
58
  },
59
+ {
60
+ "schema": "daemon",
61
+ "version": 9,
62
+ "date": "2026-10-29",
63
+ "description": "add managed service runtime and health monitoring configuration for ServiceProxy"
64
+ },
38
65
  {
39
66
  "schema": "daemon",
40
67
  "version": 8,
@@ -298,6 +325,12 @@
298
325
  "version": 10,
299
326
  "date": "2026-10-03",
300
327
  "description": "[已撤销] add relation-level memory.verifySignature gate (AND-merged with agent level)"
328
+ },
329
+ {
330
+ "schema": "relation-config",
331
+ "version": 11,
332
+ "date": "2026-10-27",
333
+ "description": "remove relation-level model parameters (baseagents/active_baseagent/model/models); models are Agent-level only; persist main-session fullaccess controls independently of EC session replacement"
301
334
  }
302
335
  ]
303
336
  }
@@ -618,11 +618,16 @@
618
618
  },
619
619
  "idleHours": {
620
620
  "type": "number",
621
- "description": "关系空闲时长(小时):一个关系最后一条入站后这么久没有新入站,触发该关系的整理链。默认 1。"
621
+ "description": "关系空闲时长(小时):一个关系最后一次活动(入站、写 note)后这么久没有新活动,触发该关系的整理链,只跑候选攒够 minBatchItems 的步骤。默认 1。"
622
622
  },
623
623
  "maxUnconsolidatedHours": {
624
624
  "type": "number",
625
- "description": "关系兜底整理时长(小时):一个关系最早一条未整理的入站满这么久,即使仍在聊也触发整理链。默认 8。"
625
+ "description": "关系兜底整理时长(小时):一个关系最早一次未整理的活动满这么久,即使仍在聊也触发整理链,有 1 条候选就跑。默认 8。"
626
+ },
627
+ "minBatchItems": {
628
+ "type": "number",
629
+ "minimum": 1,
630
+ "description": "空闲到期时一步至少攒够多少条候选才跑(note 条数 / to-generalize 条数 / to-promote 条数),不够的留给兜底。默认 3。"
626
631
  },
627
632
  "checkIntervalHours": {
628
633
  "type": "number",
@@ -630,7 +635,7 @@
630
635
  },
631
636
  "backlogHours": {
632
637
  "type": "number",
633
- "description": "pending 堆积多久(小时)算需要补漏整理。默认 24。"
638
+ "description": "已废弃,不再生效(pending 由关系空闲 / 兜底计时覆盖)。保留只为旧配置文件仍能通过校验。"
634
639
  },
635
640
  "indexMaxBytes": {
636
641
  "type": "number",