evolcore 0.0.43-test.6 → 0.0.43-test.8

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 (249) hide show
  1. package/CHANGELOG.md +95 -0
  2. package/bin/ecmsg.js +188 -58
  3. package/dist/agent-template/jobs.js +62 -0
  4. package/dist/agent-template/runtime.js +214 -0
  5. package/dist/agent-template/service.js +465 -0
  6. package/dist/agent-template/tool-runner.js +45 -0
  7. package/dist/agent-template/types.js +5 -0
  8. package/dist/agents/baseagent-availability.js +1 -1
  9. package/dist/agents/claude-runner.js +1 -1
  10. package/dist/agents/codex/app-server-client.js +22 -0
  11. package/dist/agents/codex-runner.js +69 -2
  12. package/dist/aun/aid/agentmd.js +56 -1
  13. package/dist/aun/aid/client.js +3 -1
  14. package/dist/aun/menu/client.js +3 -2
  15. package/dist/aun/msg/p2p.js +6 -1
  16. package/dist/channels/aun.js +277 -49
  17. package/dist/cli/agent-command.js +5 -0
  18. package/dist/cli/agent-create.js +7 -3
  19. package/dist/cli/agent-template.js +124 -0
  20. package/dist/cli/aun-commands.js +2 -2
  21. package/dist/cli/ctl-command.js +2 -1
  22. package/dist/cli/daemon-commands.js +11 -66
  23. package/dist/cli/daemon-lifecycle-client.js +61 -0
  24. package/dist/cli/ecmsg-gateway.js +35 -2
  25. package/dist/cli/events-command.js +109 -0
  26. package/dist/cli/index.js +60 -14
  27. package/dist/cli/invoke-command.js +182 -0
  28. package/dist/cli/managed-command-guard.js +6 -1
  29. package/dist/cli/net-check.js +1 -1
  30. package/dist/cli/restart-monitor.js +160 -83
  31. package/dist/cli/services-command.js +137 -0
  32. package/dist/cli/team-workspace-command.js +134 -0
  33. package/dist/cli/thread-command.js +103 -13
  34. package/dist/cli/watch-msg.js +1 -1
  35. package/dist/config/boot-log.js +8 -8
  36. package/dist/config/config-field-policy.js +2 -2
  37. package/dist/config/config-manager.js +0 -7
  38. package/dist/config/invoke-ipc-service.js +118 -0
  39. package/dist/config/schema-migration.js +45 -15
  40. package/dist/config-store.js +2 -1
  41. package/dist/core/agent-ipc-registration.js +25 -4
  42. package/dist/core/agent-reload-coordinator.js +6 -4
  43. package/dist/core/agent-runtime.js +106 -10
  44. package/dist/core/auth/delegation-authorization.js +66 -0
  45. package/dist/core/auth/operation-authorizer.js +2 -0
  46. package/dist/core/auth/operation-catalog.js +29 -0
  47. package/dist/core/baseagent-loader.js +60 -130
  48. package/dist/core/channel-loader.js +10 -1
  49. package/dist/core/channel-runtime.js +20 -12
  50. package/dist/core/command/agent-control.js +12 -2
  51. package/dist/core/command/agent-storage-menu.js +1 -1
  52. package/dist/core/command/agent-template-menu.js +147 -0
  53. package/dist/core/command/chatmode-config.js +2 -36
  54. package/dist/core/command/command-handler.js +80 -17
  55. package/dist/core/command/data-root-resolver.js +32 -23
  56. package/dist/core/command/eventcenter-menu.js +468 -0
  57. package/dist/core/command/menu-catalog.js +15 -0
  58. package/dist/core/command/menu-handler.js +216 -90
  59. package/dist/core/command/menu-protocol.js +71 -13
  60. package/dist/core/command/menu-query-batch.js +194 -0
  61. package/dist/core/command/slash-gate.js +1 -1
  62. package/dist/core/command/slash-handler.js +34 -42
  63. package/dist/core/command/team-workspace-bootstrap.js +350 -0
  64. package/dist/core/command/{pa-workspace-calendar.js → team-workspace-calendar.js} +7 -7
  65. package/dist/core/command/team-workspace-initializer.js +2 -0
  66. package/dist/core/command/{pa-workspace-items.js → team-workspace-items.js} +83 -68
  67. package/dist/core/command/team-workspace-job-store.js +88 -0
  68. package/dist/core/command/team-workspace-management-service.js +2 -0
  69. package/dist/core/command/team-workspace-management-store.js +96 -0
  70. package/dist/core/command/team-workspace-management.js +265 -0
  71. package/dist/core/command/team-workspace-members-menu.js +88 -0
  72. package/dist/core/command/team-workspace-store.js +612 -0
  73. package/dist/core/command/team-workspace-team.js +193 -0
  74. package/dist/core/daemon-control.js +22 -5
  75. package/dist/core/daemon-lifecycle.js +323 -191
  76. package/dist/core/handoff/runtime.js +45 -13
  77. package/dist/core/invoke/executors/index.js +13 -0
  78. package/dist/core/invoke/executors/media.js +283 -0
  79. package/dist/core/invoke/executors/text.js +198 -0
  80. package/dist/core/invoke/invoke-service.js +157 -0
  81. package/dist/core/invoke/style-router.js +48 -0
  82. package/dist/core/invoke/types.js +19 -0
  83. package/dist/core/ipc-registration.js +50 -7
  84. package/dist/core/legacy-rename.js +41 -0
  85. package/dist/core/memory/consolidation.js +7 -5
  86. package/dist/core/message/aun-ipc-sender.js +252 -17
  87. package/dist/core/message/im-renderer.js +116 -85
  88. package/dist/core/message/message-bridge.js +4 -0
  89. package/dist/core/message/message-queue.js +66 -15
  90. package/dist/core/message/message-utils.js +10 -2
  91. package/dist/core/message/peer-mode.js +7 -34
  92. package/dist/core/message/pending-hints.js +29 -5
  93. package/dist/core/message/response-engine.js +194 -61
  94. package/dist/core/message/send-options.js +7 -4
  95. package/dist/core/message/send-routing.js +50 -5
  96. package/dist/core/ownership/owner-resolver.js +7 -0
  97. package/dist/core/pack-auth.js +94 -0
  98. package/dist/core/pack-install.js +194 -0
  99. package/dist/core/permission/ec-command-parser.js +51 -17
  100. package/dist/core/permission/protected-paths.js +12 -2
  101. package/dist/core/permission/shell-environment.js +9 -0
  102. package/dist/core/rate-window.js +48 -0
  103. package/dist/core/relation/peer-identity.js +28 -0
  104. package/dist/core/session/session-file-health.js +243 -0
  105. package/dist/core/session/session-fs-store.js +67 -28
  106. package/dist/core/session/session-idle-monitor.js +59 -19
  107. package/dist/core/session/session-manager.js +13 -4
  108. package/dist/core/task/task-recovery-service.js +13 -2
  109. package/dist/core/thread/command-parser.js +9 -2
  110. package/dist/core/thread/thread-operation.js +21 -2
  111. package/dist/core/thread/thread-route.js +13 -2
  112. package/dist/core/thread/thread-service.js +52 -3
  113. package/dist/directory/owner-directory-admission.js +40 -53
  114. package/dist/directory/owner-directory-cache.js +89 -113
  115. package/dist/directory/owner-directory-query-operation.js +8 -10
  116. package/dist/eck/kit-renderer.js +7 -5
  117. package/dist/eck/message-renderer.js +2 -0
  118. package/dist/ecweb/basic-settings-service.js +1 -1
  119. package/dist/ecweb/message-context-service.js +0 -4
  120. package/dist/ecweb/runtime/lifecycle.js +6 -2
  121. package/dist/ecweb/runtime/supervisor.js +19 -4
  122. package/dist/event-center/admission-materializer.js +124 -0
  123. package/dist/event-center/bus-gate.js +154 -0
  124. package/dist/event-center/bus-host.js +307 -0
  125. package/dist/event-center/bus-resolver.js +120 -0
  126. package/dist/event-center/center-config.js +127 -0
  127. package/dist/event-center/daemon.js +44 -0
  128. package/dist/event-center/directory-source.js +55 -0
  129. package/dist/event-center/dispatcher.js +157 -0
  130. package/dist/event-center/event-log.js +110 -0
  131. package/dist/event-center/index-generator.js +73 -0
  132. package/dist/event-center/ipc-operation.js +423 -0
  133. package/dist/event-center/ledger.js +52 -0
  134. package/dist/event-center/pack-loader.js +207 -0
  135. package/dist/event-center/pack-manager.js +85 -0
  136. package/dist/event-center/registry.js +463 -0
  137. package/dist/event-center/runtime.js +837 -0
  138. package/dist/event-center/script-runner.js +356 -0
  139. package/dist/event-center/types.js +51 -0
  140. package/dist/event-center/validation.js +435 -0
  141. package/dist/index.js +424 -135
  142. package/dist/ipc.js +106 -12
  143. package/dist/paths.js +20 -0
  144. package/dist/product.js +14 -0
  145. package/dist/proxy/manager.js +5 -1
  146. package/dist/proxy/service-supervisor.js +13 -4
  147. package/dist/response-system/engines/v1/index.js +0 -1
  148. package/dist/response-system/engines/v1/proactive-flow.js +4 -2
  149. package/dist/response-system/modes/single-session/index.js +1 -1
  150. package/dist/services/dispatcher.js +100 -0
  151. package/dist/services/idempotency.js +90 -0
  152. package/dist/services/identity.js +52 -0
  153. package/dist/services/index-generator.js +70 -0
  154. package/dist/services/index.js +449 -0
  155. package/dist/services/ipc-operation.js +550 -0
  156. package/dist/services/ledger.js +52 -0
  157. package/dist/services/message-log.js +112 -0
  158. package/dist/services/pack-manager.js +215 -0
  159. package/dist/services/reply.js +55 -0
  160. package/dist/services/router.js +98 -0
  161. package/dist/services/script-runner.js +422 -0
  162. package/dist/services/service-payload.js +70 -0
  163. package/dist/services/types.js +18 -0
  164. package/dist/services/validation.js +297 -0
  165. package/dist/trigger/application-service.js +18 -0
  166. package/dist/trigger/event-source.js +1 -1
  167. package/dist/trigger/ipc-service.js +3 -1
  168. package/dist/trigger/scheduler.js +38 -0
  169. package/dist/trigger/script-sandbox.js +170 -24
  170. package/dist/utils/cross-platform.js +24 -10
  171. package/dist/utils/evolcore-version.js +69 -27
  172. package/dist/utils/instance-registry.js +19 -13
  173. package/dist/utils/npm-ops.js +2 -1
  174. package/dist/utils/package-version-info.js +6 -3
  175. package/dist/utils/process-introspect.js +45 -9
  176. package/dist/utils/startup-trace.js +74 -37
  177. package/dist/utils/windows-shell-trust.js +80 -6
  178. package/kits/docs/INDEX.md +2 -2
  179. package/kits/docs/aun/ABILITY_CALLING.md +9 -15
  180. package/kits/docs/context-assembly.md +1 -1
  181. package/kits/docs/evolcore/INDEX.md +3 -1
  182. package/kits/docs/evolcore/ability.md +4 -0
  183. package/kits/docs/evolcore/agent.md +22 -1
  184. package/kits/docs/evolcore/aid.md +1 -1
  185. package/kits/docs/evolcore/event-center.md +227 -0
  186. package/kits/docs/evolcore/file-navigation.md +10 -264
  187. package/kits/docs/evolcore/fs.md +5 -3
  188. package/kits/docs/evolcore/group.md +1 -1
  189. package/kits/docs/evolcore/memory-architecture.md +2 -0
  190. package/kits/docs/evolcore/menu-protocol.md +28 -1
  191. package/kits/docs/evolcore/msg.md +21 -9
  192. package/kits/docs/evolcore/provider.md +3 -1
  193. package/kits/docs/evolcore/response.md +5 -5
  194. package/kits/docs/evolcore/services.md +294 -0
  195. package/kits/docs/evolcore/task.md +2 -0
  196. package/kits/docs/evolcore/team-workspace.md +41 -0
  197. package/kits/docs/evolcore/thread-chain.md +15 -3
  198. package/kits/eck_manifest.json +26 -0
  199. package/kits/rules/02-navigation.md +10 -1
  200. package/kits/rules/06-channel.md +1 -0
  201. package/kits/schemas/_meta.json +17 -6
  202. package/kits/schemas/agent-config.schema.19.json +5 -7
  203. package/kits/schemas/agent-config.schema.20.json +936 -0
  204. package/kits/schemas/relation-config.schema.12.json +2 -3
  205. package/kits/schemas/role-config.schema.2.json +4 -4
  206. package/kits/skills/.switches.json +1 -5
  207. package/kits/skills/ability/SKILL.md +56 -0
  208. package/kits/skills/ability/references/calling.md +56 -0
  209. package/kits/skills/{ec-ability → ability}/references/contract-checklist.md +1 -1
  210. package/kits/skills/{ec-ability → ability}/references/development.md +9 -33
  211. package/kits/skills/{ec-ability → ability}/references/management.md +2 -2
  212. package/kits/skills/{ec-ability → ability}/references/recovery.md +1 -1
  213. package/kits/skills/{ec-ability → ability}/references/runtime-protocol.md +2 -0
  214. package/kits/skills/ec-agent-create/SKILL.md +0 -1
  215. package/kits/skills/ec-group/SKILL.md +5 -8
  216. package/kits/skills/ec-group-collaboration/SKILL.md +7 -7
  217. package/kits/skills/ec-service-proxy/SKILL.md +34 -5
  218. package/kits/skills/ec-trigger/SKILL.md +4 -4
  219. package/kits/skills/personal-assistant/SKILL.md +6 -6
  220. package/kits/skills/personal-assistant/references/02-bootstrap.md +4 -4
  221. package/kits/skills/personal-assistant/scripts/clean.mjs +4 -4
  222. package/kits/skills/personal-assistant/scripts/init.mjs +2 -2
  223. package/kits/skills/personal-assistant/scripts/pa.mjs +4 -4
  224. package/kits/skills/thread-ops/SKILL.md +10 -10
  225. package/kits/templates/message-fragments/item.md +1 -1
  226. package/kits/templates/system-fragments/channel.md +3 -3
  227. package/kits/templates/system-fragments/commands.md +5 -3
  228. package/kits/templates/system-fragments/reply.md +1 -5
  229. package/kits/templates/system-fragments/thread.md +13 -10
  230. package/package.json +5 -6
  231. package/scripts/agent-template/index.mjs +40 -0
  232. package/scripts/agent-template/inspect.mjs +240 -0
  233. package/scripts/agent-template/overlay.mjs +71 -0
  234. package/scripts/agent-template/pack.mjs +169 -0
  235. package/scripts/agent-template/shared/common.mjs +235 -0
  236. package/scripts/agent-template/shared/evolcore.mjs +75 -0
  237. package/scripts/agent-template/shared/plan.mjs +129 -0
  238. package/scripts/agent-template/shared/team-schema.json +70 -0
  239. package/scripts/agent-template/shared/template-contract.mjs +154 -0
  240. package/scripts/agent-template/shared/template-package.mjs +265 -0
  241. package/scripts/agent-template/shared/template-runtime.mjs +80 -0
  242. package/scripts/agent-template/shared/template.mjs +142 -0
  243. package/dist/cli/pa-workspace-command.js +0 -225
  244. package/dist/core/command/pa-workspace-store.js +0 -468
  245. package/dist/core/relation/pa-team.js +0 -132
  246. package/kits/docs/evolcore/pa-workspace.md +0 -51
  247. package/kits/skills/aid-ability/SKILL.md +0 -244
  248. package/kits/skills/ec-ability/SKILL.md +0 -67
  249. package/kits/skills/ec-ability/references/workflows.md +0 -15
@@ -300,7 +300,7 @@ function installTriggers(ws, selfAid) {
300
300
  ok.push(triggerIdOf(name));
301
301
  } catch (e) {
302
302
  const detail = String(e.stderr || e.message);
303
- // 已存在不是失败:说明之前装过(可能是别的会话或 Core 的 pa-workspace init)。
303
+ // 已存在不是失败:说明之前装过(可能是别的会话或 Team Workspace 初始化)。
304
304
  // 按幂等原则跳过,不重复创建,也不推翻它。
305
305
  if (/already exists/i.test(detail)) {
306
306
  skipped.push(triggerIdOf(name));
@@ -394,4 +394,4 @@ if (exitCode !== 0) console.log('⚠️ 部分完成,见上面失败项');
394
394
  else if (noop) console.log('✅ 已是最新,无需改动');
395
395
  else console.log('✅ 完成');
396
396
 
397
- process.exit(exitCode);
397
+ process.exit(exitCode);
@@ -86,9 +86,9 @@ function argValue(name) {
86
86
  }
87
87
 
88
88
  /**
89
- * Core 的 PA 工作区绑定。
89
+ * Core 的 Team Workspace 绑定。
90
90
  *
91
- * 少了它,App 里就没有「个人助理」入口,`ec pa-workspace navigation show` 报
91
+ * 少了它,App 里就没有工作区入口,`ec team navigation show` 报
92
92
  * NOT_CONFIGURED。绑定属于初始化的一部分,不是事后补的独立动作。
93
93
  */
94
94
  function coreBinding() {
@@ -100,7 +100,7 @@ function coreBinding() {
100
100
  }
101
101
 
102
102
  const statePath = join(process.env.EVOLCORE_HOME || join(homedir(), '.evolcore'),
103
- 'agents', self, 'data', 'pa-workspace-state.json');
103
+ 'agents', self, 'data', 'team-workspace-state.json');
104
104
 
105
105
  if (op === 'clean') {
106
106
  // 预览模式(没有 --yes)绝不能动登记:clean.mjs 预览时也返回 0,
@@ -135,7 +135,7 @@ function coreBinding() {
135
135
  }
136
136
  if (dryRun) return { ok: true, action: 'bind' };
137
137
  try {
138
- execFileSync('ec', ['pa-workspace', 'bind', '--workspace', workspace], {
138
+ execFileSync('ec', ['team', 'workspace', 'init', '--workspace', workspace], {
139
139
  stdio: 'pipe', encoding: 'utf8', shell: process.platform === 'win32',
140
140
  });
141
141
  return { ok: true, action: 'bound' };
@@ -30,7 +30,7 @@ license: MIT
30
30
 
31
31
  ### 四条反直觉的语义
32
32
 
33
- - **发出即结束**:`ecmsg send --thread T2` 返回后当前 turn 立刻终止,不阻塞等回复。
33
+ - **发出即结束**:`ec msg send --thread T2` 返回后当前 turn 立刻终止,不阻塞等回复。
34
34
  - **复查是唤醒信号,不是执行脚本**:到期只投递一条通知,不保证对端已回,不携带操作命令。
35
35
  - **决策权在自己**:要不要回、何时回、回什么,全自主。
36
36
  - **无"等齐"原语**:想等多方回复,就在各自 turn 里用 `ec thread history` 主动读另一话题。
@@ -61,10 +61,10 @@ license: MIT
61
61
  ```bash
62
62
  # 1. 找或建与 C 的话题
63
63
  ec thread list <C的AID>
64
- ec thread create <C的AID> --name '项目进度查询' # 没有合适话题时;返回 thread-… 形式的 threadId
64
+ ec thread create <C的AID> --name '项目进度查询' # 没有合适话题时;返回裸 threadId
65
65
 
66
- # 2. 发消息,--check-every 一步搞定复查(跨话题可自定义:5m / 30m / 2h / 1d,省略即 20m)
67
- ecmsg send '项目当前进度如何?' --thread <threadId> --check-every 5m
66
+ # 2. 发消息,--check-every 一步搞定复查(跨话题必填:5m / 30m / 2h / 1d)
67
+ ec msg send '项目当前进度如何?' --thread <裸threadId> --check-every 5m
68
68
 
69
69
  # 3. 本 turn 结束,不阻塞
70
70
  ```
@@ -78,7 +78,7 @@ ecmsg send '项目当前进度如何?' --thread <threadId> --check-every 5m
78
78
  你收到的是**普通消息**,不带话题链注入(上下文只注入在发送方的目标话题里)。处理完自行决定回不回:
79
79
 
80
80
  ```bash
81
- ecmsg send '进度 70%,预计下周完成' # 不带 --thread,发在当前话题
81
+ ec msg send '进度 70%,预计下周完成' # 不带 --thread,发在当前话题
82
82
  ```
83
83
 
84
84
  同话题追问也不带 `--thread`,同样不建复查。
@@ -104,7 +104,7 @@ ec thread history <来源话题id> --after <发送于的时间戳>
104
104
  ```bash
105
105
  ec trigger delete <trig_id> # 完成:删除,不留残留
106
106
  ec trigger update <trig_id> --every 30m # 放宽
107
- ecmsg send 'C 回复:进度 70%' --thread <来源threadId> --check-every 30m # 汇报(跨话题,省略即默认 20m)
107
+ ec msg send 'C 回复:进度 70%' --thread <来源threadId> --check-every 30m # 汇报(跨话题,复查必填)
108
108
  ```
109
109
 
110
110
  **关键点**:
@@ -117,10 +117,10 @@ ecmsg send 'C 回复:进度 70%' --thread <来源threadId> --check-every 30m
117
117
  ### D. 并发委托多方
118
118
 
119
119
  ```bash
120
- ecmsg send '技术评估' --thread <T2> --check-every 10m
121
- ecmsg send '产品评估' --thread <T3> --check-every 10m
120
+ ec msg send '技术评估' --thread <T2> --check-every 10m
121
+ ec msg send '产品评估' --thread <T3> --check-every 10m
122
122
  # 之后在每个先到的 turn 里,用 ec thread history 读另一话题,齐了再合并回 T1
123
- ecmsg send '综合评估:……' --thread <T1> --check-every 30m
123
+ ec msg send '综合评估:……' --thread <T1> --check-every 30m
124
124
  ```
125
125
 
126
126
  ### E. 查询与维护命令
@@ -178,7 +178,7 @@ ec thread summary show <threadId>
178
178
 
179
179
  **不要**:
180
180
  1. 发完阻塞等回复——turn 已结束,回复会触发新 turn。
181
- 2. 以为省略 `--check-every` 就不建复查——跨话题一律自动建复查(缺省 20m),不需要时用回执里的 `trigger_id` 执行 `ec trigger delete`。
181
+ 2. 漏掉 `--check-every`——跨话题不发复查,对端不回你永远不会知道。
182
182
  3. 托管会话里手写 `from/to`。
183
183
  4. 把复查通知当"强制回复"或执行脚本。
184
184
  5. 在复查 turn 里再 `--check-every`(会套娃)。
@@ -1,3 +1,3 @@
1
- ‹{{now}} · from:{{peerId}}{{?peerName}}({{peerName}}){{/}}{{?peerRole}} · role:{{peerRole}}{{/}}{{?chatType=group}} → 群:{{groupLabel}} · self:{{selfAid}}{{/}}{{?chatType=private}} → self:{{selfAid}}{{/}}{{?encrypted=true}} · 🔒密文{{/}}{{?encrypted=false}} · ✉️明文{{/}}{{?sameDevice}} · 📍同设备{{/}}{{?sameNetwork}} · 🌐同网络{{/}}{{?sameEgressIp}} · 🔀同出口IP{{/}}{{?mentionAids}} · @:{{mentionAids}}{{/}}›
1
+ ‹{{now}} · from:{{peerId}}{{?peerName}}({{peerName}}){{/}}{{?selfAddressed}} · 跨话题自派{{/}}{{?peerRole}} · role:{{peerRole}}{{/}}{{?chatType=group}} → 群:{{groupLabel}} · self:{{selfAid}}{{/}}{{?chatType=private}} → self:{{selfAid}}{{/}}{{?chatMode=proactive}} · chatMode:proactive{{/}}{{?chatMode=interactive}} · chatMode:interactive{{/}}{{?sameDevice}} · 📍同设备{{/}}{{?sameNetwork}} · 🌐同网络{{/}}{{?sameEgressIp}} · 🔀同出口IP{{/}}{{?mentionAids}} · @:{{mentionAids}}{{/}}›
2
2
  {{?lifecycle=bootstrapping}}(本轮只推进首次设定:按 Owner 这条回复更新名片和头像,然后完成激活;回复里的普通任务记为激活后待办,不在本轮执行。)
3
3
  {{/}}{{?isHandoff!=true}}{{content}}{{/}}
@@ -19,9 +19,9 @@ ecmsg send '<text>' [--file <path> --as image|video|voice|file] [--payload '<jso
19
19
  {{/}}
20
20
  {{?peerId}}
21
21
  ecmsg send '<text>' [--text-from-file <path>] [--encrypt yes|no|auto] [--file <path> --as image|video|voice|file] [--link <url> --title '<title>'] [--payload '<json>' --return none|required --timeout <duration> --format json]
22
- `ecmsg send` 在 proactive/paactive 下是正式回复;interactive 下普通回复直接输出,只在需要文件、链接或手动控制加密时才用。paactive 的普通模型文本由框架投影为 activity。
23
- 当用户想获取、读取、查询或汇总属于某个主体的数据时,无论主体通过“我/你”、姓名、关系称谓还是 AID 指代,都先依据当前关系层、明确 AID 或可靠身份/联系人信息确认主体是谁并解析到准确 AID;姓名不明或有歧义时才询问。必要时加载 `ec-identity` 解析姓名。随后加载内置技能 `aid-ability`,检查该主体 AID 是否发布了匹配的数据能力;数据类型和来源不设限。若数据由关联设备或服务提供,只能依据能力索引或可信身份信息确认对应 Provider AID,不得猜测。
24
- 用户要求发现或调用其他 AID 的能力时使用 `aid-ability`。用户要求给当前 Agent/主机添加、开发、安装、启用、发布、下架、升级或诊断本端插件时使用 `ec-ability`。仅出现 `ability` 等术语不足以判定要调用远端能力;按用户要做的事分流。若用户只询问远端调用流程/可行性或明确要求不要执行,只说明身份解析、能力发现与调用步骤,不读取索引、不调用能力。实际调用时不要猜测能力路径或参数:读取目标 AID 的能力索引,必要时执行在线发现,再按结构化契约构造原始 JSON。需要结果时使用 `ecmsg send --to <AID> --return required`;它会按 `--timeout`(默认 60s,最大 3600s)使用 AUN volatile 非持久消息。等待超时后用 `ec msg request get` 查询,不要自动重发。`message_id` 只表示传输 ACK,不表示能力执行完成。
22
+ `ecmsg send` 在 proactive 下是正式回复;interactive 下普通回复直接输出,只在需要文件、链接或手动控制加密时才用。
23
+ 当用户想获取、读取、查询或汇总属于某个主体的数据时,无论主体通过“我/你”、姓名、关系称谓还是 AID 指代,都先依据当前关系层、明确 AID 或可靠身份/联系人信息确认主体是谁并解析到准确 AID;姓名不明或有歧义时才询问。必要时加载 `ec-identity` 解析姓名。随后加载通用内置技能 `ability`(`ec skill load ability`),按其中的远端调用流程检查该主体 AID 是否发布了匹配的数据能力;数据类型和来源不设限。L1 能力索引使用 `ec fs cat <provider-aid>:/.well-known/ability/index.json` 读取。若数据由关联设备或服务提供,只能依据能力索引或可信身份信息确认对应 Provider AID,不得猜测。
24
+ 用户要求发现或调用其他 AID 的能力时使用通用技能 `ability`。用户要求给当前 Agent/主机添加、开发、安装、启用、发布、下架、升级或诊断本端插件时,也使用该技能中的 EvolCore 插件流程和 `ec ability` 命令。仅出现 `ability` 等术语不足以判定要调用远端能力;按用户要做的事分流。若用户只询问远端调用流程/可行性或明确要求不要执行,只说明身份解析、能力发现与调用步骤,不读取索引、不调用能力。实际调用时不要猜测能力路径或参数:读取目标 AID 的能力索引,必要时执行在线发现,再按结构化契约构造原始 JSON。需要结果时使用 `ecmsg send --to <AID> --return required`;它会按 `--timeout`(默认 60s,最大 3600s)使用 AUN volatile 非持久消息。等待超时后用 `ec msg request get` 查询,不要自动重发。`message_id` 只表示传输 ACK,不表示能力执行完成。
25
25
  {{/}}
26
26
  每次调用仍须遵守 `[reply]` 的单条命令及加密要求。
27
27
  {{/}}
@@ -12,10 +12,12 @@ ec response 响应模式管理(切换响应模式/列响应模式/看当前模
12
12
  ec stats Token 用量与费用统计(用量/费用/统计/预算/token/cost) $KITS_DOCS/evolcore/stats.md
13
13
  ec config 读配置/查字段/看生效值(get/show/list/effective/fields/history/diff/current/boots/validate);set/unset 权限由 API 层控制 $KITS_DOCS/evolcore/config.md
14
14
  ec trigger 定时与事件触发器管理(create/update/list/run/enable/disable/delete;set 仅为 create 兼容别名)。需要写操作的无人值守任务用 --permission bypass;单个 trigger 可用 --model/--effort 覆盖执行模型/强度 $KITS_DOCS/evolcore/trigger.md
15
+ ec events 事件中心运维(status/ledger/tail/doctor/reload/rules/pack/publish;事件是 TTL 内的在线通知,不落库不重放,不能丢的用普通消息) $KITS_DOCS/evolcore/event-center.md
16
+ ec services 服务路由运维与对端调用(status/types/ledger/tail/doctor/reload/enable/disable;describe/schema/call 调对端服务;服务调用是点对点、要结果、不丢) $KITS_DOCS/evolcore/services.md
15
17
  {{?channel=aun}}
16
18
  {{?chatType=private}}
17
19
  {{?peerRole=owner}}
18
- ec pa-workspace 个人助理工作区初始化与入口导航(init/bind/navigation show/navigation update;初始化会先运行 personal-assistant Skill,再登记工作区) $KITS_DOCS/evolcore/pa-workspace.md
20
+ ec team 初始化当前 Agent 的 Team Workspace、发布/删除/替换导航入口、管理团队成员 $KITS_DOCS/evolcore/team-workspace.md
19
21
  {{/}}
20
22
  {{/}}
21
23
  {{/}}
@@ -26,7 +28,7 @@ ec task 恢复暂停或异常中断的会话任务(resume <sessionId>;
26
28
  ec task 恢复暂停或异常中断的本 Agent 会话任务(resume <sessionId>;复用原 baseagent 会话,缺失时失败关闭) $KITS_DOCS/evolcore/task.md
27
29
  {{/}}
28
30
  ec skill 技能加载与管理(load 加载正文/path 查路径/list 列技能/info 详情/where 根目录/enable/disable/install/remove) $KITS_DOCS/evolcore/skill.md
29
- ec ability 按 AID 管理和开发能力插件(context/--self、dev 构建打包、发布下架、状态诊断与作业等待;写操作仍按目标授权) $KITS_DOCS/evolcore/ability.md
31
+ ec ability 按 AID 开发、管理与本地调用能力插件(dev 构建打包、context/--self、invoke、发布下架、状态诊断与作业等待;Ability 规范模型、任务分流及远端调用流程见 ability 技能;写操作仍按目标授权) $KITS_DOCS/evolcore/ability.md
30
32
  ec aid 身份/证书/名片/换头像(avatar --file/--url)/探测对端 $KITS_DOCS/evolcore/aid.md
31
33
  ec directory 联系人名录(list 列举+--filter 关键词过滤+分页/info 按名字或 AID 看详情/refresh 重算注入/blocked 拉黑总览/request 发加好友申请);备注直接读写 directory/remarks/<AID>.md 再 refresh $KITS_DOCS/evolcore/directory.md
32
34
  ec fs AUN 文件系统统一入口(ls/stat/cat/cp/mv/rm/mkdir/ln/chmod/setfacl/getfacl/token/find/df/mount/approve/reject/umount;个人/群空间同一入口;没有 ec group fs) $KITS_DOCS/evolcore/fs.md
@@ -35,7 +37,7 @@ ec storage 文件上传/下载/配额(底层调试入口,日常优先 ec fs
35
37
  ec thread 话题管理与话题链(peers 列对端 / list 列话题 / history 读历史 / show / summary / rename / label / status / delete / create)。peer 为对端裸 AID(如 alice.agentid.cn),不是 peerKey 那种 aun# 形态;本端身份自动注入,不写 --self。示例: ec thread peers → ec thread list <对端裸AID> → ec thread history <threadId> $KITS_DOCS/evolcore/thread-chain.md
36
38
  {{/}}
37
39
  {{?selfAid}}
38
- ec group 群管理(建群/查群/本地群历史/邀请/踢人/角色/封禁/屏蔽/成员状态/规则;发消息用 ecmsg,完整协作使用 ec-group-collaboration 技能) $KITS_DOCS/evolcore/group.md
40
+ ec group 群管理(建群/查群/本地群历史/邀请/踢人/角色/封禁/屏蔽/成员状态/规则;发送群消息用 ecmsg,完整协作使用 ec-group-collaboration 技能) $KITS_DOCS/evolcore/group.md
39
41
  {{/}}
40
42
  {{?peerRole=owner}}
41
43
  ec agent EvolAgent 生命周期与主机信息(创建/启停/热重载/改配置/查主机信息;创建流程使用 ec-agent-create 技能)。ec agent reload 仅对配置/soul/memory 生效,改源码无效 $KITS_DOCS/evolcore/agent.md
@@ -16,11 +16,9 @@ Bootstrap 只允许向当前 owner 提问、回显最终值、请求确认或说
16
16
  {{?chatMode=interactive}}
17
17
  interactive:直接输出文本就是回复,由框架自动投递。当前会话的普通文本回复无需调用发送命令;不要先手动发送同一正文,再输出“已发送”等重复说明。
18
18
  {{/}}
19
- {{?chatMode=paactive}}
20
- paactive:模型自动产生的普通文本由框架转为 activity 展示,不构成正式回复;需要正式回复时使用托管发送命令。工具、文件、图片、审批/提问卡片和 notify 沿用 interactive 行为。
21
- {{/}}
22
19
  {{?chatMode=proactive}}
23
20
  proactive:普通输出作为思考过程展示,不作为正式回复、不触发对端的消息接收。要正式回复,必须使用下面的托管发送命令。
21
+ 发送命令是你的发言通道,不是额外工具:proactive 下的 `ecmsg send` 等同 interactive 下的文本输出。任务里「不要调用工具」「不要执行任何操作」之类的约束只约束业务工具,不约束回复通道;但回不回复仍由你判断,沉默是允许的。
24
22
  首轮工具调用里要包含一次托管发送命令,说明当前情况和下一步意图。连续多轮没有成功发送时,框架只放行发送命令,其他工具会被拒绝。
25
23
  {{/}}
26
24
  {{?activePush}}
@@ -71,11 +69,9 @@ proactive:普通输出作为思考过程展示,不作为正式回复、不
71
69
  发送成功后继续本轮必要步骤,不重复发送同一正文或补发“已发送”回执。
72
70
  {{?chatMode!=interactive}}
73
71
  {{?chatMode!=proactive}}
74
- {{?chatMode!=paactive}}
75
72
  当前 chatMode 缺失或无效;说明运行时上下文不完整,不根据 peerType 或 chatType 猜测回复模式。
76
73
  {{/}}
77
74
  {{/}}
78
- {{/}}
79
75
 
80
76
  发送约束:
81
77
  - 只能使用当前会话的 delegated sender,经 daemon IPC 发送;保留托管环境,不另建 SDK 连接。不为绕过限制改写身份、对端或 thread 路由。
@@ -4,8 +4,9 @@
4
4
  话题摘要是**话题级**的进展快照:这条任务线做了什么、结果如何,供下次激活时快速恢复。
5
5
  对端的长期事实(偏好、角色、背景)不写这里,写记忆(见 `[memory]` 段)。
6
6
 
7
- `ec thread` 的 `<peer>` 参数是对端**裸 AID**(取 `peerId`,如 `alice.agentid.cn`),
8
- 不是 `aun#…` 形态的 peerKey;传 peerKey 会静默返回 0 条。
7
+ `ec thread` 的 `<peer>` 参数用对端裸 AID(取 `peerId`,如 `alice.agentid.cn`);
8
+ `aun#…` 形态的 peerKey 也会被归一成裸 AID 接受。空列表会说明成因(对端无往来 / 被过滤条件挡掉 /
9
+ 索引缺失),标识形态非法则直接报错退出。
9
10
 
10
11
  ## 标准工作流
11
12
 
@@ -14,29 +15,31 @@
14
15
  ec agent list
15
16
 
16
17
  # 2. 列出某 agent 有话题记录的所有对端
17
- ec thread peers --self <selfAid>
18
+ ec thread peers
18
19
 
19
20
  # 3. 列出与某对端的所有话题(默认10条/页,含消息统计和摘要)
20
- ec thread list <peer> --self <selfAid>
21
+ ec thread list <peer>
21
22
 
22
- # 4. 翻页(页脚自动给出完整翻页命令,含真实 peer 和 selfAid)
23
- ec thread list <peer> --self <selfAid> --page 2 --limit 10 --sort recent
23
+ # 4. 翻页(页脚自动给出完整翻页命令,含真实 peer)
24
+ ec thread list <peer> --page 2 --limit 10 --sort recent
24
25
 
25
26
  # 5. 查看某话题的历史消息
26
- ec thread history <peer>/<threadId> --self <selfAid> --limit 20
27
+ ec thread history <peer>/<threadId> --limit 20
27
28
 
28
29
  # 6. 查看话题摘要(写摘要见下文「话题摘要维护」)
29
- ec thread summary show <peer>/<threadId> --self <selfAid>
30
+ ec thread summary show <peer>/<threadId>
30
31
  ```
31
32
 
33
+ > 本端身份由运行时注入,托管会话一律不写 `--self`;`--self` 只用于宿主终端(见下方改名示例)。
34
+
32
35
  ## 跨话题发送(联系当前对端以外的对象)
33
36
 
34
37
  一个话题只有本端与对端两端。当前话题能直接回复的只有本话题的对端;要联系**其他**对象,必须换到与该对象的话题上发送:
35
38
 
36
39
  ```bash
37
40
  # 1. 选中目标话题(没有就新建)
38
- ec thread list <对方AID> --self <selfAid>
39
- ec thread create <对方AID> --name '问题跟踪' --self <selfAid> # 返回 threadId
41
+ ec thread list <对方AID>
42
+ ec thread create <对方AID> --name '问题跟踪' # 返回 threadId
40
43
 
41
44
  # 2. 带上话题发送;本端/对端由话题推断
42
45
  ecmsg send '<text>' --thread <threadId> --check-every 5m
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "evolcore",
3
- "version": "0.0.43-test.6",
3
+ "version": "0.0.43-test.8",
4
4
  "description": "AI Agent gateway connecting Claude, Codex, Gemini, and the bundled ecagent runner to messaging channels with multi-project session management",
5
5
  "type": "module",
6
6
  "main": "dist/index.js",
@@ -22,6 +22,7 @@
22
22
  "!dist/cli/mode.js",
23
23
  "!dist/core/file-integrity/write.js",
24
24
  "bin/",
25
+ "scripts/agent-template/",
25
26
  "!dist/experimental/",
26
27
  "!dist/ability/protocol-v2.js",
27
28
  "!skills/",
@@ -58,14 +59,11 @@
58
59
  "test:owner-directory-authorization": "npm run test:owner-directory-cache && npm run test:owner-directory-admission",
59
60
  "test:owner-directory-admission": "node --import tsx --test tests/owner-directory-admission.node.ts",
60
61
  "test:contact-admission": "node --import tsx --test tests/contact-admission.node.ts",
61
- "test:ownership-startup": "node --import tsx --test tests/ownership-startup.node.ts tests/ownership-refresh-memory.node.ts",
62
- "test:initialization-diagnostics": "node --import tsx --test tests/initialization-diagnostics.node.ts",
63
- "test:hooks": "vitest run tests/unit/codex-hook-diagnostics.test.ts",
64
62
  "verify:request-identity": "npm run build && node scripts/verify-request-identity.mjs",
65
63
  "prepublishOnly": "npm test"
66
64
  },
67
65
  "dependencies": {
68
- "@agentunion/fastaun": "^0.5.33",
66
+ "@agentunion/fastaun": "^0.5.34",
69
67
  "@anthropic-ai/claude-agent-sdk": "0.3.300",
70
68
  "@modelcontextprotocol/sdk": "^1.32.2",
71
69
  "ajv": "^8.20.0",
@@ -73,7 +71,7 @@
73
71
  "chokidar": "^5.0.0",
74
72
  "cron-parser": "^5.5.0",
75
73
  "dotenv": "^17.4.2",
76
- "ec-web": "0.0.43-test.6",
74
+ "ec-web": "0.0.43-test.8",
77
75
  "ignore": "7.0.5",
78
76
  "image-type": "^6.0.0",
79
77
  "partial-json": "0.1.7",
@@ -94,6 +92,7 @@
94
92
  "pure-qqbot": "^2.0.0"
95
93
  },
96
94
  "overrides": {
95
+ "@agentunion/fastaun": "$@agentunion/fastaun",
97
96
  "qs": "6.16.1",
98
97
  "smol-toml": "$smol-toml"
99
98
  },
@@ -0,0 +1,40 @@
1
+ import path from 'node:path';
2
+ import { fileURLToPath } from 'node:url';
3
+ import { isMainScript } from '../../dist/utils/cross-platform.js';
4
+ import { parseArgs, readJson } from './shared/common.mjs';
5
+
6
+ export async function cli(argv) {
7
+ const command = argv[0];
8
+ if (!command || argv.includes('--help')) {
9
+ console.log('Agent template: inspect-agent | pack | inspect-package | overlay --options-file <JSON>');
10
+ return 0;
11
+ }
12
+ const args = parseArgs(argv.slice(1), { values: ['options-file', 'agent-dir', 'template', 'out', 'aid', 'owner', 'host', 'providers', 'workspace', 'backup'] });
13
+ const options = { ...(args['options-file'] ? readJson(args['options-file']) : {}) };
14
+ const mapping = { 'agent-dir': 'agentDir', template: 'templateDir', out: 'out', aid: 'targetAid', owner: 'ownerAid', host: 'hostAid', workspace: 'projectPath', backup: 'backupDir' };
15
+ for (const [from, to] of Object.entries(mapping)) if (args[from]) options[to] = args[from];
16
+ if (args.providers) options.selections = JSON.parse(args.providers);
17
+ const packageRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..', '..');
18
+ options.packageRoot ??= packageRoot;
19
+ const commands = {
20
+ 'inspect-agent': ['./inspect.mjs', 'inspectAgent'],
21
+ pack: ['./pack.mjs', 'pack'],
22
+ 'inspect-package': ['./inspect.mjs', 'inspectPackage'],
23
+ overlay: ['./overlay.mjs', 'overlay'],
24
+ };
25
+ const entry = commands[command];
26
+ if (!entry) throw Object.assign(new Error('Unknown template command: ' + command), { code: 'INVALID_ARGUMENT' });
27
+ const mod = await import(new URL(entry[0], import.meta.url).href);
28
+ const result = await mod[entry[1]](options);
29
+ console.log(JSON.stringify({ type: 'result', ok: true, data: result }));
30
+ return 0;
31
+ }
32
+
33
+ if (isMainScript(import.meta.url)) {
34
+ try { process.exitCode = await cli(process.argv.slice(2)); }
35
+ catch (error) {
36
+ console.log(JSON.stringify({ type: 'result', ok: false, code: error.code || 'TOOL_FAILED', message: error.message,
37
+ ...(error.data === undefined ? {} : { data: error.data }) }));
38
+ process.exitCode = error.code === 'INVALID_ARGUMENT' || error.name === 'UsageError' ? 2 : 1;
39
+ }
40
+ }
@@ -0,0 +1,240 @@
1
+ import fs from 'node:fs';
2
+ import path from 'node:path';
3
+ import { fileURLToPath } from 'node:url';
4
+ import { createHash } from 'node:crypto';
5
+ import { readJson, jsonBytes, assert, sha256, walkFiles, inside, unpack, behaviorConfig, mergeObjects,
6
+ snapshot, BASEAGENTS, PROFILE_FIELDS, isRecord, regularPath, atomicBytes } from './shared/common.mjs';
7
+ import { loadTemplate, MANAGED_AGENT_FIELDS, templateDigest } from './shared/template.mjs';
8
+ import { loadEvolcore } from './shared/evolcore.mjs';
9
+ import { validateAgainstSchema, buildAgentTriggers, resolveProviderRefs } from './shared/plan.mjs';
10
+ import { excluded } from './pack.mjs';
11
+ import { normalizeTeam } from './shared/template-contract.mjs';
12
+ import { renderValue as renderTemplateValue, renderResource, bindTemplateProviders } from './shared/template-runtime.mjs';
13
+
14
+ export async function inspectAgent(options) {
15
+ const config = options.effectiveConfig ?? readJson(path.join(options.agentDir, 'config.json'));
16
+ const soul = path.join(options.agentDir, 'personal', 'soul');
17
+ const triggerRoot = path.join(options.agentDir, 'triggers');
18
+ const project = options.projectPath ?? config.projects?.defaultPath;
19
+ assert(typeof project === 'string' && path.isAbsolute(project), 'INVALID_ARGUMENT', 'Agent default project is required');
20
+ const triggers = fs.existsSync(triggerRoot) ? fs.readdirSync(triggerRoot, { withFileTypes: true }).filter(e => e.isDirectory()).map(e => {
21
+ const def = readJson(path.join(triggerRoot, e.name, 'trigger.json'));
22
+ return { id: def.id, name: def.name, enabled: def.enabled !== false };
23
+ }) : [];
24
+ return { aid: options.agentAid, name: options.profile?.name ?? '', description: options.profile?.description ?? '',
25
+ profile: { soul: fs.existsSync(soul) ? fs.readdirSync(soul).filter(f => f.endsWith('.md') && f !== '00-GUIDE.md').sort() : [],
26
+ welcome: fs.existsSync(path.join(options.agentDir, 'personal', 'welcome.md')), config: behaviorConfig(config) },
27
+ activeBaseagent: config.active_baseagent,
28
+ baseagents: BASEAGENTS.filter(name => config.baseagents?.[name]).map(name => ({ name, currentModel: config.baseagents[name].model ?? null,
29
+ currentEffort: config.baseagents[name].effort ?? null, provider: config.baseagents[name].provider ?? null })),
30
+ triggers, skills: options.skills ?? [],
31
+ project: { path: project, files: fs.existsSync(project) ? fs.readdirSync(project).filter(f => !excluded(f)).sort() : [] } };
32
+ }
33
+
34
+ export async function inspectPackage(options) {
35
+ let root = options.packageDir;
36
+ if (options.archivePath) {
37
+ root = path.join(options.out, 'unpacked');
38
+ assert(!fs.existsSync(root), 'CONFLICT', 'Package is already unpacked');
39
+ fs.mkdirSync(root, { recursive: true });
40
+ const bytes = fs.readFileSync(options.archivePath);
41
+ assert('sha256:' + sha256(bytes) === options.digest, 'INTEGRITY_FAILED', 'Package digest mismatch');
42
+ unpack(bytes, root);
43
+ }
44
+ assert(root && path.isAbsolute(root), 'INVALID_ARGUMENT', 'Package directory required');
45
+ const pkg = readJson(path.join(root, 'PACKAGE.json'));
46
+ assert(pkg.$schema_version === 1 && /^[a-z0-9][a-z0-9._-]{0,63}$/.test(pkg.id)
47
+ && /^\d+\.\d+\.\d+$/.test(pkg.version), 'INTEGRITY_FAILED', 'Invalid package metadata');
48
+ const manifest = readJson(path.join(root, 'MANIFEST.json'));
49
+ assert(Array.isArray(manifest), 'INTEGRITY_FAILED', 'Invalid manifest');
50
+ const templateDir = path.join(root, 'template');
51
+ const files = walkFiles(templateDir);
52
+ assert(manifest.length === files.length && new Set(manifest.map(f => f.path)).size === files.length,
53
+ 'INTEGRITY_FAILED', 'Manifest file set mismatch');
54
+ for (const entry of manifest) {
55
+ assert(files.includes(entry.path), 'INTEGRITY_FAILED', 'Unexpected manifest entry');
56
+ const bytes = fs.readFileSync(inside(templateDir, entry.path));
57
+ assert(bytes.length === entry.size && sha256(bytes) === entry.sha256, 'INTEGRITY_FAILED', 'Manifest checksum mismatch: ' + entry.path);
58
+ }
59
+ assert(walkFiles(root).length === files.length + 2, 'INTEGRITY_FAILED', 'Unexpected package entries');
60
+ const { tpl, errors } = loadTemplate(templateDir);
61
+ assert(!errors.length, 'INVALID_ARGUMENT', errors.join('; '));
62
+ const contract = normalizeTeam(tpl.team, { packageInfo: pkg });
63
+ assert(!contract.errors.length, 'INTEGRITY_FAILED', contract.errors.join('; '));
64
+ assert(tpl.keys.length > 0 && new Set(tpl.keys).size === tpl.keys.length && tpl.name === pkg.id && tpl.version === pkg.version,
65
+ 'INVALID_ARGUMENT', 'Matching template metadata and unique member keys required');
66
+ const schemaErrors = validateAgainstSchema(tpl.team, tpl.schema);
67
+ assert(!schemaErrors.length, 'INVALID_ARGUMENT', schemaErrors.join('; '));
68
+ // Check the complete package before selecting member resources. No member may hide unsupported files.
69
+ for (const file of files) assert(file === 'team.json' || file === 'team.schema.json'
70
+ || file.startsWith('.evolcore/skills/') || tpl.keys.some(key => file.startsWith('workspace/' + key + '/')
71
+ || file.startsWith('agents/' + key + '/personal/soul/') && file.endsWith('.md') && !file.endsWith('/00-GUIDE.md')
72
+ || file === 'agents/' + key + '/personal/welcome.md' || file.startsWith('agents/' + key + '/triggers/')),
73
+ 'INVALID_ARGUMENT', 'Unsupported template resource: ' + file);
74
+ const platforms = tpl.team.host?.platform;
75
+ if (platforms !== undefined) assert(Array.isArray(platforms) && platforms.length
76
+ && platforms.every(p => ['linux', 'darwin', 'win32'].includes(p)) && platforms.includes(process.platform),
77
+ 'INCOMPATIBLE', 'Template host.platform must support this host');
78
+ if (!options.targets) {
79
+ assert(tpl.keys.length === 1, 'INVALID_ARGUMENT', 'Provide targets mapping for every template member');
80
+ return inspectMember(options, { pkg, tpl, templateDir, files, key: tpl.keys[0] });
81
+ }
82
+ assert(isRecord(options.targets) && tpl.keys.length === Object.keys(options.targets).length
83
+ && tpl.keys.every(key => Object.hasOwn(options.targets, key)), 'INVALID_ARGUMENT', 'Map every template member exactly once');
84
+ const contexts = tpl.keys.map(key => options.targets[key]);
85
+ assert(contexts.every(c => isRecord(c) && typeof c.targetAid === 'string' && c.home === contexts[0].home)
86
+ && new Set(contexts.map(c => c.targetAid)).size === contexts.length,
87
+ 'INVALID_ARGUMENT', 'Members must map to distinct Agents on the same host');
88
+ assert(Object.keys(options.members ?? {}).every(key => tpl.keys.includes(key)), 'INVALID_ARGUMENT', 'Unknown member selection');
89
+ const writes = new Map(); const members = []; const plans = [];
90
+ for (const key of tpl.keys) {
91
+ const selection = options.members?.[key] ?? {};
92
+ const out = inside(options.out ?? path.dirname(root), 'members/' + key);
93
+ const data = await inspectMember({ ...options.targets[key], out, packageRoot: options.packageRoot, digest: options.digest,
94
+ pullId: options.pullId, selections: selection.providers ?? {}, externalAids: selection.externalAids ?? {} },
95
+ { pkg, tpl, templateDir, key, files: files.filter(f => !f.startsWith('agents/') && !f.startsWith('workspace/')
96
+ || f.startsWith('agents/' + key + '/') || f.startsWith('workspace/' + key + '/')) });
97
+ const plan = readJson(data.planFile);
98
+ for (const write of plan.writes) {
99
+ const previous = writes.get(write.path);
100
+ assert(!previous || JSON.stringify(previous) === JSON.stringify(write), 'CONFLICT', 'Members write different shared content: ' + write.path);
101
+ writes.set(write.path, write);
102
+ }
103
+ const { planFile: _planFile, ...preview } = data;
104
+ members.push({ key, targetAid: plan.targetAid, ...preview });
105
+ plans.push({ key, targetAid: plan.targetAid, projectPath: plan.projectPath, profile: plan.profile,
106
+ originalProfile: plan.originalProfile, profileVersion: plan.profileVersion, providers: plan.providers });
107
+ }
108
+ const planFile = path.join(options.out ?? path.dirname(root), 'plan.json');
109
+ atomicBytes(planFile, jsonBytes({ version: 1, home: contexts[0].home, templateDir,
110
+ templateDigest: templateDigest(templateDir), package: pkg, writes: [...writes.values()], members: plans }));
111
+ return { pullId: options.pullId, template: members[0].template, compatible: true, incompatible: [],
112
+ members, externalAids: pkg.externalAids ?? [], planFile };
113
+ }
114
+
115
+ async function inspectMember(options, { pkg, tpl, templateDir, files, key }) {
116
+ const root = path.dirname(templateDir);
117
+ const targets = options.targetConfig;
118
+ assert(targets?.aid === options.targetAid, 'INVALID_ARGUMENT', 'Target configuration required');
119
+ const project = options.projectPath ?? targets.projects?.defaultPath;
120
+ assert(typeof project === 'string' && path.isAbsolute(project), 'INVALID_ARGUMENT', 'Target default project required');
121
+ const vars = { 'agent.aid': options.targetAid, 'owner.aid': options.ownerAid, 'host.aid': options.hostAid, 'project.path': project };
122
+ const renderValue = value => renderTemplateValue(value, vars, options.externalAids ?? {});
123
+ const spec = renderValue(tpl.team.agents.find(agent => agent.key === key));
124
+ for (const file of files) assert(file === 'team.json' || file === 'team.schema.json'
125
+ || file.startsWith('.evolcore/skills/') || file.startsWith('workspace/' + key + '/')
126
+ || file.startsWith('agents/' + key + '/personal/soul/') && file.endsWith('.md') && !file.endsWith('/00-GUIDE.md')
127
+ || file === 'agents/' + key + '/personal/welcome.md' || file.startsWith('agents/' + key + '/triggers/'),
128
+ 'INVALID_ARGUMENT', 'Unsupported template resource: ' + file);
129
+ assert(isRecord(spec.config) && !MANAGED_AGENT_FIELDS.some(f => f in spec.config)
130
+ && Object.keys(spec.config).every(f => ['chatmode', 'memory', 'active_baseagent', 'baseagents'].includes(f)),
131
+ 'INVALID_ARGUMENT', 'Unsupported template configuration');
132
+ const packageRoot = options.packageRoot ?? path.resolve(path.dirname(fileURLToPath(import.meta.url)), '../..');
133
+ const temp = process.env.TMPDIR;
134
+ assert(temp && path.isAbsolute(temp), 'TEMP_UNAVAILABLE', 'Absolute TMPDIR required');
135
+ const scratch = fs.mkdtempSync(path.join(temp, 'template-validator-'));
136
+ let ec;
137
+ try { ec = await loadEvolcore(packageRoot, scratch); }
138
+ finally { /* Modules remain loaded; scratch is cleaned after validation below. */ }
139
+ try {
140
+ const { default: semver } = await import('semver');
141
+ assert(Array.isArray(pkg.compat?.platforms) && pkg.compat.platforms.includes(process.platform)
142
+ && semver.validRange(pkg.compat.evolcore) && semver.satisfies(ec.version.replace(/-test\.\d+$/, ''), pkg.compat.evolcore, { includePrerelease: true }),
143
+ 'INCOMPATIBLE', 'Platform or EvolCore version is incompatible', { incompatible: ['platform/version'] });
144
+ const selections = options.selections ?? {};
145
+ for (const [name, block] of Object.entries(spec.config.baseagents ?? {})) {
146
+ assert(BASEAGENTS.includes(name) && isRecord(block) && Object.keys(block).every(f => ['provider', 'model', 'effort', 'params'].includes(f)),
147
+ 'INVALID_ARGUMENT', 'Invalid baseagent block');
148
+ }
149
+ const { config: resolved, refs } = bindTemplateProviders(spec.config,
150
+ { providers: options.providers ?? {}, selections, allowMissing: true });
151
+ assert(resolved.baseagents?.[resolved.active_baseagent], 'INVALID_ARGUMENT', 'Default baseagent must be selected');
152
+ assert(Object.keys(selections).every(name => resolved.baseagents?.[name]), 'INVALID_ARGUMENT', 'Unknown baseagent selection');
153
+ const config = mergeObjects(targets, resolveProviderRefs(resolved));
154
+ for (const [name, select] of Object.entries(selections)) if (select.effort === null) delete config.baseagents[name].effort;
155
+ const configErrors = ec.validate('Agent', config);
156
+ assert(!configErrors.length, 'INVALID_ARGUMENT', configErrors.join('; '));
157
+ const agentDir = path.join(options.home, 'agents', options.targetAid);
158
+ const writes = [];
159
+ const add = (target, bytes, mode) => writes.push({ path: target, content: bytes.toString('base64'),
160
+ mode: mode ?? snapshot(target)?.mode ?? 0o644, expected: snapshot(target) });
161
+ add(path.join(agentDir, 'config.json'), jsonBytes(config));
162
+ add(path.join(agentDir, 'template.lock.json'), jsonBytes({ id: pkg.id, version: pkg.version,
163
+ publisherAid: pkg.publisher?.aid, digest: options.digest, installedAt: Date.now() }));
164
+ const render = (bytes, relative = '') => renderResource(bytes, vars, options.externalAids ?? {}, { json: relative.endsWith('.json') });
165
+ const preview = { profile: { fields: PROFILE_FIELDS.filter(f => spec.profile?.[f] !== undefined), preserve: ['aid', 'type', 'owner'] },
166
+ soul: { add: [], overwrite: [] }, triggers: { add: [], overwrite: [] }, skills: [], files: { add: 0, overwrite: 0 },
167
+ project: { path: project, changeDefault: false }, config: Object.keys(resolved) };
168
+ const skillMapping = {};
169
+ const localNames = [...new Set(files.filter(f => f.startsWith('.evolcore/skills/')).map(f => f.split('/')[2]))];
170
+ for (const name of localNames) {
171
+ const source = inside(path.join(templateDir, '.evolcore', 'skills'), name);
172
+ const hash = createHash('sha256');
173
+ for (const p of walkFiles(source)) hash.update(p).update('\0').update(render(fs.readFileSync(inside(source, p)), p)).update('\0');
174
+ const desiredDigest = hash.digest('hex').slice(0, 12);
175
+ let destName = name;
176
+ const original = inside(path.join(options.home, 'skills'), name);
177
+ if (fs.existsSync(original) && templateDigest(original) !== desiredDigest) destName += '--' + pkg.id;
178
+ const dest = inside(path.join(options.home, 'skills'), destName);
179
+ if (fs.existsSync(dest)) assert(templateDigest(dest) === desiredDigest, 'CONFLICT', 'Skill name conflicts: ' + destName);
180
+ skillMapping[name] = destName;
181
+ preview.skills.push({ name, installAs: destName });
182
+ for (const p of walkFiles(source)) add(inside(dest, p), render(fs.readFileSync(inside(source, p)), p),
183
+ fs.statSync(inside(source, p)).mode & 0o111 ? 0o755 : 0o644);
184
+ }
185
+ const switchesFile = path.join(agentDir, 'skills', '.switches.json');
186
+ const switches = fs.existsSync(switchesFile) ? readJson(switchesFile) : {};
187
+ for (const [name, value] of Object.entries(spec.skills ?? {})) switches[skillMapping[name] ?? name] = { enabled: value.enabled === true };
188
+ add(switchesFile, jsonBytes(switches));
189
+ const failures = []; const allowedTriggerFiles = new Set();
190
+ const triggers = buildAgentTriggers({ templateRoot: templateDir, key, aid: options.targetAid, vars, ec,
191
+ rec: { check: (name, ok, detail) => { if (!ok) failures.push(name + ': ' + String(detail)); } } });
192
+ assert(!failures.length, 'INVALID_ARGUMENT', failures.join('; '));
193
+ const triggerNames = new Set();
194
+ for (const { id, definition } of triggers) {
195
+ const dir = inside(path.join(agentDir, 'triggers'), id); triggerNames.add(id);
196
+ allowedTriggerFiles.add('agents/' + key + '/triggers/' + id + '/trigger.json');
197
+ const def = renderValue(definition);
198
+ def.enabled = false; delete def.authorizedBy; delete def.operatorPeers;
199
+ const normalized = ec.validateTrigger(def);
200
+ add(path.join(dir, 'trigger.json'), jsonBytes(normalized));
201
+ preview.triggers[fs.existsSync(path.join(dir, 'trigger.json')) ? 'overwrite' : 'add'].push(id);
202
+ if (def.execution.type === 'script') {
203
+ const rel = def.execution.script.path;
204
+ allowedTriggerFiles.add('agents/' + key + '/triggers/' + id + '/' + rel);
205
+ const source = inside(path.join(templateDir, 'agents', key, 'triggers', id), rel);
206
+ regularPath(source); add(inside(dir, rel), render(fs.readFileSync(source)), fs.statSync(source).mode & 0o111 ? 0o755 : 0o644);
207
+ }
208
+ const active = path.join(dir, 'active.json');
209
+ if (fs.existsSync(active)) writes.push({ path: active, remove: true, expected: snapshot(active) });
210
+ }
211
+ for (const file of files.filter(f => f.startsWith('agents/' + key + '/triggers/'))) {
212
+ assert(allowedTriggerFiles.has(file), 'INVALID_ARGUMENT', 'Unexpected Trigger file: ' + file);
213
+ }
214
+ for (const file of files) {
215
+ const prefix = 'agents/' + key + '/personal/';
216
+ if (file.startsWith(prefix)) {
217
+ const rel = file.slice(prefix.length); const target = inside(path.join(agentDir, 'personal'), rel);
218
+ add(target, render(fs.readFileSync(inside(templateDir, file)), file));
219
+ if (rel.startsWith('soul/')) preview.soul[fs.existsSync(target) ? 'overwrite' : 'add'].push(rel.slice(5));
220
+ } else if (file.startsWith('workspace/' + key + '/')) {
221
+ const rel = file.slice(('workspace/' + key + '/').length);
222
+ assert(!excluded(rel), 'INVALID_ARGUMENT', 'Excluded project file');
223
+ const target = inside(project, rel); add(target, render(fs.readFileSync(inside(templateDir, file)), file),
224
+ fs.statSync(inside(templateDir, file)).mode & 0o111 ? 0o755 : 0o644);
225
+ preview.files[fs.existsSync(target) ? 'overwrite' : 'add']++;
226
+ }
227
+ }
228
+ const plan = { version: 1, targetAid: options.targetAid, home: options.home, projectPath: project,
229
+ templateDir, templateDigest: templateDigest(templateDir), package: pkg, writes,
230
+ profile: spec.profile,
231
+ originalProfile: options.profile, profileVersion: options.profileVersion, providers: refs };
232
+ const planFile = path.join(options.out ?? path.dirname(root), 'plan.json');
233
+ atomicBytes(planFile, jsonBytes(plan));
234
+ return { pullId: options.pullId, template: { id: pkg.id, version: pkg.version, name: pkg.name, publisherAid: pkg.publisher?.aid },
235
+ compatible: true, incompatible: [], currentConfig: { baseagents: Object.entries((options.effectiveConfig ?? targets).baseagents ?? {}).map(([name, b]) => ({ name, ...b })),
236
+ soul: fs.existsSync(path.join(agentDir, 'personal', 'soul')) ? fs.readdirSync(path.join(agentDir, 'personal', 'soul')) : [],
237
+ triggers: fs.existsSync(path.join(agentDir, 'triggers')) ? fs.readdirSync(path.join(agentDir, 'triggers')) : [] },
238
+ providers: refs, preview, externalAids: pkg.externalAids ?? [], planFile };
239
+ } finally { fs.rmSync(scratch, { recursive: true, force: true }); }
240
+ }