evolcore 0.0.50 → 0.0.51

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 (448) hide show
  1. package/CHANGELOG.md +39 -2
  2. package/bin/ec-build.mjs +60 -0
  3. package/bin/ecmsg.js +65 -63
  4. package/dist/ability/caller/command.js +24 -15
  5. package/dist/ability/caller/contract.js +24 -9
  6. package/dist/ability/caller/credential-files.js +132 -0
  7. package/dist/ability/caller/daemon.js +32 -7
  8. package/dist/ability/caller/schema-view.js +157 -0
  9. package/dist/ability/caller/service.js +202 -63
  10. package/dist/ability/interop-v1.js +156 -113
  11. package/dist/agent-template/jobs.js +14 -110
  12. package/dist/agent-template/runtime.js +331 -193
  13. package/dist/agent-template/service.js +1029 -1104
  14. package/dist/agent-template/share.js +103 -0
  15. package/dist/agent-template/tool-runner.js +25 -0
  16. package/dist/agent-template/types.js +10 -3
  17. package/dist/agents/claude/availability.js +94 -0
  18. package/dist/agents/claude/capability-provider.js +154 -0
  19. package/dist/agents/claude/index.js +145 -0
  20. package/dist/agents/{claude-runner.js → claude/runner.js} +74 -158
  21. package/dist/agents/claude/session-file-adapter.js +246 -0
  22. package/dist/agents/codex/app-server-client.js +90 -10
  23. package/dist/agents/codex/availability.js +164 -0
  24. package/dist/agents/codex/capability-provider.js +138 -0
  25. package/dist/agents/codex/cli.js +38 -0
  26. package/dist/agents/codex/index.js +345 -0
  27. package/dist/agents/codex/mcp-elicitation.js +135 -0
  28. package/dist/agents/{codex-runner.js → codex/runner.js} +648 -382
  29. package/dist/agents/codex/session-file-adapter.js +834 -0
  30. package/dist/agents/dsh/availability.js +28 -0
  31. package/dist/agents/dsh/capability-provider.js +56 -0
  32. package/dist/agents/dsh/desktop-locations.ps1 +66 -0
  33. package/dist/agents/dsh/desktop-probe.cjs +37 -0
  34. package/dist/agents/dsh/index.js +98 -0
  35. package/dist/agents/dsh/installation.js +400 -0
  36. package/dist/agents/dsh/resources.js +755 -0
  37. package/dist/agents/dsh/runner.js +1183 -0
  38. package/dist/agents/dsh/runtime/README.md +243 -0
  39. package/dist/agents/dsh/runtime/authorization.js +23 -0
  40. package/dist/agents/dsh/runtime/bridge.js +837 -0
  41. package/dist/agents/dsh/runtime/config.js +271 -0
  42. package/dist/agents/dsh/runtime/entry.js +229 -0
  43. package/dist/agents/dsh/runtime/session-inspector.js +340 -0
  44. package/dist/agents/dsh/runtime/tool-policy.js +49 -0
  45. package/dist/agents/dsh/session-file-adapter.js +145 -0
  46. package/dist/agents/ecagent/index.js +215 -0
  47. package/dist/agents/{ecagent-runner.js → ecagent/runner.js} +592 -106
  48. package/dist/agents/ecagent/session-file-adapter.js +134 -0
  49. package/dist/agents/gemini/index.js +55 -10
  50. package/dist/agents/gemini/{gemini-runner.js → runner.js} +4 -9
  51. package/dist/aun/ability-device-routing.js +11 -17
  52. package/dist/aun/aid/agentmd.js +27 -1
  53. package/dist/aun/aid/managed-operation.js +6 -4
  54. package/dist/aun/group/invite-service.js +1 -1
  55. package/dist/aun/menu/client.js +1 -1
  56. package/dist/aun/msg/history.js +1 -1
  57. package/dist/aun/msg/managed-operation.js +93 -21
  58. package/dist/aun/msg/p2p.js +6 -6
  59. package/dist/aun/service-proxy.js +1 -1
  60. package/dist/aun/storage/index.js +242 -0
  61. package/dist/build-identity.json +1 -1
  62. package/dist/channels/aun.js +180 -43
  63. package/dist/channels/daemon.js +3 -2
  64. package/dist/channels/dingtalk.js +1 -1
  65. package/dist/channels/feishu.js +9 -9
  66. package/dist/channels/qqbot.js +1 -1
  67. package/dist/channels/wechat.js +2 -2
  68. package/dist/channels/wecom.js +1 -1
  69. package/dist/{agents/claude-gateway → claude-gateway}/agent-registration.js +13 -13
  70. package/dist/{agents/claude-gateway → claude-gateway}/binding.js +3 -3
  71. package/dist/{agents/claude-gateway → claude-gateway}/inbox.js +1 -1
  72. package/dist/{agents/claude-gateway → claude-gateway}/index.js +2 -2
  73. package/dist/{agents/claude-gateway → claude-gateway}/listing.js +3 -3
  74. package/dist/{agents/claude-gateway → claude-gateway}/router.js +4 -4
  75. package/dist/{agents/claude-gateway → claude-gateway}/sessions.js +2 -2
  76. package/dist/{agents/claude-gateway → claude-gateway}/terminal.js +1 -1
  77. package/dist/{agents/claude-gateway → claude-gateway}/transcript.js +1 -1
  78. package/dist/cli/ability-command.js +8 -5
  79. package/dist/cli/ability-output.js +182 -0
  80. package/dist/cli/agent-command.js +1 -1
  81. package/dist/cli/agent-create.js +123 -42
  82. package/dist/cli/agent-template.js +400 -29
  83. package/dist/cli/agent.js +14 -11
  84. package/dist/cli/aun-commands.js +167 -111
  85. package/dist/cli/daemon-commands.js +38 -8
  86. package/dist/cli/data-command.js +1 -1
  87. package/dist/cli/debug-mode.js +9 -0
  88. package/dist/cli/directory.js +1 -2
  89. package/dist/cli/ecmsg-gateway.js +55 -19
  90. package/dist/cli/fs-command.js +67 -39
  91. package/dist/cli/index.js +25 -11
  92. package/dist/cli/init.js +124 -29
  93. package/dist/cli/managed-command-guard.js +2 -0
  94. package/dist/cli/model.js +1 -1
  95. package/dist/cli/restart-monitor.js +2 -2
  96. package/dist/cli/services-command.js +24 -1
  97. package/dist/cli/skill-command.js +4 -4
  98. package/dist/cli/task-context.js +24 -14
  99. package/dist/cli/team-workspace-command.js +50 -52
  100. package/dist/cli/thread-command.js +3 -2
  101. package/dist/cli/trigger-command.js +47 -12
  102. package/dist/cli/watch-logs.js +2 -1
  103. package/dist/config/boot-log.js +3 -0
  104. package/dist/config/builtin-role-templates.js +1 -1
  105. package/dist/config/config-field-policy.js +10 -6
  106. package/dist/config/config-manager.js +33 -12
  107. package/dist/config/gateway-config.js +21 -37
  108. package/dist/config/invoke-ipc-service.js +1 -1
  109. package/dist/config/owner-config.js +5 -3
  110. package/dist/config/peer-book-store.js +2 -3
  111. package/dist/config/peer-book.js +2 -2
  112. package/dist/config/peer-role-resolver.js +2 -2
  113. package/dist/config/provider-identity-migration.js +24 -105
  114. package/dist/config/provider-ipc-service.js +13 -3
  115. package/dist/config/provider-local-sync.js +4 -1
  116. package/dist/config/provider-menu-request.js +21 -3
  117. package/dist/config/provider-templates.js +1 -1
  118. package/dist/config/providers-config.js +39 -15
  119. package/dist/config/providers-import.js +3 -3
  120. package/dist/config/providers-management.js +74 -99
  121. package/dist/config/schema-migration.js +177 -11
  122. package/dist/config/schema-registry.js +1 -1
  123. package/dist/config-store.js +38 -50
  124. package/dist/core/{agent-application-service.js → agent/agent-application-service.js} +9 -9
  125. package/dist/core/{agent-create-status.js → agent/agent-create-status.js} +112 -4
  126. package/dist/core/{agent-creation-claim.js → agent/agent-creation-claim.js} +3 -3
  127. package/dist/core/{agent-ipc-registration.js → agent/agent-ipc-registration.js} +102 -25
  128. package/dist/core/{agent-reload-coordinator.js → agent/agent-reload-coordinator.js} +61 -1
  129. package/dist/core/{agent-runtime.js → agent/agent-runtime.js} +53 -27
  130. package/dist/core/{evolagent-registry.js → agent/evolagent-registry.js} +12 -12
  131. package/dist/core/{evolagent.js → agent/evolagent.js} +11 -11
  132. package/dist/core/auth/agent-delegation.js +1 -8
  133. package/dist/core/auth/delegation-authorization.js +28 -0
  134. package/dist/core/auth/operation-authorizer.js +7 -4
  135. package/dist/core/auth/operation-catalog.js +34 -5
  136. package/dist/core/baseagent/baseagent-availability.js +197 -0
  137. package/dist/core/baseagent/baseagent-capability-adapter.js +288 -0
  138. package/dist/core/baseagent/baseagent-config-shared.js +56 -0
  139. package/dist/core/baseagent/baseagent-identity.js +68 -0
  140. package/dist/core/{baseagent-loader.js → baseagent/baseagent-loader.js} +62 -6
  141. package/dist/core/baseagent/baseagent-model-defaults.js +26 -0
  142. package/dist/{agents → core/baseagent}/baseagent-plugin-descriptor.js +107 -24
  143. package/dist/core/baseagent/baseagent-plugin-loader.js +367 -0
  144. package/dist/core/baseagent/baseagent.js +157 -0
  145. package/dist/{agents → core/baseagent}/runner-types.js +36 -4
  146. package/dist/core/capability/capability-manager.js +79 -30
  147. package/dist/core/capability/providers/claude-capability-provider.js +2 -154
  148. package/dist/core/capability/providers/codex-capability-provider.js +2 -136
  149. package/dist/core/{channel-loader.js → channel/channel-loader.js} +226 -38
  150. package/dist/core/{channel-runtime.js → channel/channel-runtime.js} +18 -18
  151. package/dist/core/command/agent-control.js +60 -15
  152. package/dist/core/command/agent-template-menu.js +21 -9
  153. package/dist/core/command/agentmd-menu-request.js +19 -8
  154. package/dist/core/command/agentmd-menu.js +14 -5
  155. package/dist/core/command/command-handler.js +127 -57
  156. package/dist/core/command/context-policy-menu.js +122 -0
  157. package/dist/core/command/data-root-resolver.js +157 -20
  158. package/dist/core/command/memory-slash.js +6 -6
  159. package/dist/core/command/menu-catalog.js +80 -20
  160. package/dist/core/command/menu-handler.js +305 -25
  161. package/dist/core/command/menu-protocol.js +42 -8
  162. package/dist/core/command/menu-query-batch.js +9 -5
  163. package/dist/core/command/provider-menu.js +7 -11
  164. package/dist/core/command/role-menu.js +1 -1
  165. package/dist/core/command/skill-slash.js +17 -5
  166. package/dist/core/command/slash-gate.js +2 -4
  167. package/dist/core/command/slash-handler.js +127 -96
  168. package/dist/core/command/team-workspace-team.js +3 -3
  169. package/dist/core/command/topic-slash.js +10 -10
  170. package/dist/core/{daemon-bootstrap.js → daemon/daemon-bootstrap.js} +14 -14
  171. package/dist/core/{daemon-control.js → daemon/daemon-control.js} +46 -20
  172. package/dist/core/{daemon-lifecycle.js → daemon/daemon-lifecycle.js} +15 -15
  173. package/dist/core/{host-snapshot.js → daemon/host-snapshot.js} +3 -3
  174. package/dist/core/{ipc-registration.js → daemon/ipc-registration.js} +98 -38
  175. package/dist/core/{lifecycle-notice.js → daemon/lifecycle-notice.js} +4 -5
  176. package/dist/core/file-integrity/store.js +1 -1
  177. package/dist/core/handoff/ipc-registration.js +3 -3
  178. package/dist/core/handoff/runtime.js +1 -1
  179. package/dist/{agents → core/inference}/request-identity.js +2 -2
  180. package/dist/core/inference/text-inference.js +4 -4
  181. package/dist/core/{bootstrap-messages.js → initialization/bootstrap-messages.js} +10 -10
  182. package/dist/core/{bootstrap-service.js → initialization/bootstrap-service.js} +24 -23
  183. package/dist/core/initialization/service.js +54 -9
  184. package/dist/core/invoke/executors/media.js +1 -1
  185. package/dist/core/invoke/executors/text.js +1 -1
  186. package/dist/core/memory/consolidation-context.js +1 -1
  187. package/dist/core/memory/consolidation-trigger.js +9 -3
  188. package/dist/core/memory/consolidation.js +4 -4
  189. package/dist/core/memory/memory-admin.js +6 -6
  190. package/dist/core/memory/memory-writer.js +1 -1
  191. package/dist/core/memory/relation-idle-monitor.js +1 -1
  192. package/dist/core/message/aun-ipc-sender.js +114 -75
  193. package/dist/core/message/aun-request-registry.js +13 -5
  194. package/dist/core/message/auto-mention-gate.js +1 -1
  195. package/dist/core/message/contact-admission.js +1 -1
  196. package/dist/core/message/im-renderer.js +19 -0
  197. package/dist/core/{interaction-router.js → message/interaction-router.js} +4 -4
  198. package/dist/core/message/items-formatter.js +5 -5
  199. package/dist/core/message/message-admission.js +1 -1
  200. package/dist/core/message/message-bridge.js +135 -54
  201. package/dist/core/message/message-queue.js +83 -4
  202. package/dist/core/message/message-utils.js +1 -1
  203. package/dist/core/message/peer-mode.js +1 -1
  204. package/dist/core/message/response-engine.js +347 -163
  205. package/dist/core/message/send-options.js +9 -6
  206. package/dist/core/message/send-routing.js +45 -109
  207. package/dist/core/message/stream-idle-monitor.js +1 -1
  208. package/dist/core/{data-migration.js → migration/data-migration.js} +29 -1
  209. package/dist/core/model/catalog-service.js +29 -8
  210. package/dist/core/model/model-capabilities.js +88 -0
  211. package/dist/core/model/model-catalog.js +14 -3
  212. package/dist/core/model/model-diagnostics.js +4 -4
  213. package/dist/core/ownership/owner-resolver.js +95 -15
  214. package/dist/core/{pack-auth.js → pack/pack-auth.js} +30 -3
  215. package/dist/core/{pack-install.js → pack/pack-install.js} +95 -17
  216. package/dist/core/permission/approval-gateway.js +9 -18
  217. package/dist/core/permission/ec-command-parser.js +70 -34
  218. package/dist/core/permission/managed-file.js +234 -0
  219. package/dist/core/permission/protected-paths.js +56 -0
  220. package/dist/core/permission/sandbox-runtime.js +267 -3
  221. package/dist/core/permission/session-path-grants.js +1 -1
  222. package/dist/core/permission/shell-environment.js +15 -1
  223. package/dist/core/plugin/plugin-lifecycle.js +442 -0
  224. package/dist/core/session/adapters/claude-session-file-adapter.js +2 -246
  225. package/dist/core/session/adapters/codex-session-file-adapter.js +2 -566
  226. package/dist/core/session/adapters/ecagent-session-file-adapter.js +2 -134
  227. package/dist/core/{background-session → session/background}/session-cleanup.js +2 -2
  228. package/dist/core/{background-session → session/background}/types.js +1 -1
  229. package/dist/core/session/session-file-health.js +2 -272
  230. package/dist/core/session/session-idle-monitor.js +1 -1
  231. package/dist/core/session/session-manager.js +29 -2
  232. package/dist/core/session/session-terminal.js +185 -0
  233. package/dist/core/session/session-title.js +8 -11
  234. package/dist/core/{system-session → session/system}/memory.js +43 -9
  235. package/dist/core/{system-session → session/system}/registry.js +1 -1
  236. package/dist/core/{system-session → session/system}/types.js +1 -1
  237. package/dist/core/skill/index-generator.js +1 -0
  238. package/dist/core/task/task-activity-store.js +112 -0
  239. package/dist/core/task/task-recovery-service.js +2 -2
  240. package/dist/core/thread/ipc-operation.js +2 -2
  241. package/dist/core/thread/thread-operation.js +2 -1
  242. package/dist/core/thread/thread-route.js +5 -3
  243. package/dist/core/thread/thread-service.js +14 -4
  244. package/dist/directory/{owner-directory-admission.js → admission.js} +3 -3
  245. package/dist/directory/{owner-directory-cache.js → cache.js} +90 -8
  246. package/dist/directory/{owner-directory-markdown.js → markdown.js} +2 -2
  247. package/dist/directory/{owner-directory-query-operation.js → query-operation.js} +83 -9
  248. package/dist/directory/{owner-directory-search.js → search.js} +50 -2
  249. package/dist/directory/{owner-directory-store.js → store.js} +2 -2
  250. package/dist/eck/kit-renderer.js +1 -1
  251. package/dist/eck/manifest-engine.js +64 -2
  252. package/dist/eck/message-renderer.js +35 -0
  253. package/dist/ecweb/basic-settings-service.js +9 -3
  254. package/dist/{contracts → ecweb/contracts}/ecweb-service-protocol.js +2 -1
  255. package/dist/ecweb/dsh-native-service.js +413 -0
  256. package/dist/ecweb/providers-service.js +1 -1
  257. package/dist/ecweb/runtime/lifecycle.js +1 -1
  258. package/dist/ecweb/runtime/supervisor.js +1 -1
  259. package/dist/event-center/center-config.js +2 -2
  260. package/dist/event-center/dispatcher.js +1 -1
  261. package/dist/event-center/ipc-operation.js +12 -3
  262. package/dist/event-center/pack-loader.js +2 -2
  263. package/dist/event-center/registry.js +6 -6
  264. package/dist/event-center/runtime.js +2 -2
  265. package/dist/index.js +71 -42
  266. package/dist/ipc.js +103 -10
  267. package/dist/outputs/authorization.js +27 -0
  268. package/dist/outputs/events.js +10 -1
  269. package/dist/outputs/panel-cards.js +960 -0
  270. package/dist/paths.js +12 -0
  271. package/dist/pay/command.js +1 -1
  272. package/dist/pay/runtime.js +18 -10
  273. package/dist/response-system/engines/v1/proactive-flow.js +1 -1
  274. package/dist/services/dispatcher.js +2 -2
  275. package/dist/services/host/main.js +10 -1
  276. package/dist/services/host/protocol.js +9 -2
  277. package/dist/services/host/resident.js +37 -0
  278. package/dist/services/host-client.js +12 -0
  279. package/dist/services/host-recycle.js +8 -3
  280. package/dist/services/host-runtime.js +54 -15
  281. package/dist/services/index.js +83 -19
  282. package/dist/services/ipc-operation.js +303 -38
  283. package/dist/services/pack-manager.js +2 -2
  284. package/dist/services/router.js +43 -3
  285. package/dist/services/script-runner.js +34 -25
  286. package/dist/services/service-payload.js +28 -1
  287. package/dist/services/validation.js +28 -2
  288. package/dist/stats/context-usage.js +110 -0
  289. package/dist/stats/model-resolver.js +103 -17
  290. package/dist/stats/query.js +5 -0
  291. package/dist/trigger/application-service.js +3 -2
  292. package/dist/trigger/authorization.js +36 -33
  293. package/dist/trigger/ipc-service.js +4 -4
  294. package/dist/trigger/local-files.js +8 -176
  295. package/dist/trigger/manager.js +2 -2
  296. package/dist/trigger/parser.js +48 -0
  297. package/dist/trigger/scheduler.js +14 -2
  298. package/dist/trigger/script-executor.js +21 -0
  299. package/dist/trigger/script-sandbox.js +57 -243
  300. package/dist/trigger/system-definitions.js +25 -0
  301. package/dist/trigger/validation.js +1 -1
  302. package/dist/utils/atomic-write.js +88 -1
  303. package/dist/utils/cross-platform.js +4 -42
  304. package/dist/utils/error-dict.json +22 -1
  305. package/dist/utils/error-utils.js +193 -6
  306. package/dist/utils/evolcore-version.js +2 -2
  307. package/dist/utils/host-info.js +1 -1
  308. package/dist/utils/logger.js +3 -1
  309. package/dist/utils/media-cache.js +99 -4
  310. package/dist/utils/startup-trace.js +20 -4
  311. package/dist/utils/welcome.js +64 -20
  312. package/ecagent/README.md +35 -0
  313. package/ecagent/dist/agent-loop.js +80 -30
  314. package/ecagent/dist/harness/env/nodejs.d.ts +16 -0
  315. package/ecagent/dist/harness/env/nodejs.js +49 -20
  316. package/ecagent/dist/harness/messages.js +3 -2
  317. package/ecagent/dist/harness/types.d.ts +1 -0
  318. package/ecagent/dist/runtime/types.d.ts +2 -0
  319. package/ecagent/dist/runtime/utils/validation.d.ts +7 -1
  320. package/ecagent/dist/runtime/utils/validation.js +42 -0
  321. package/ecagent/dist/types.d.ts +2 -0
  322. package/kits/docs/INDEX.md +1 -1
  323. package/kits/docs/channels/feishu.md +1 -1
  324. package/kits/docs/evolcore/INDEX.md +10 -7
  325. package/kits/docs/evolcore/agent-create.md +2 -0
  326. package/kits/docs/evolcore/agent.md +100 -13
  327. package/kits/docs/evolcore/aid.md +19 -3
  328. package/kits/docs/evolcore/config.md +94 -0
  329. package/kits/docs/evolcore/ctl.md +2 -1
  330. package/kits/docs/evolcore/ec-capabilities.md +7 -10
  331. package/kits/docs/evolcore/ecweb-lifecycle.md +5 -1
  332. package/kits/docs/evolcore/event.md +1 -1
  333. package/kits/docs/evolcore/fs.md +49 -3
  334. package/kits/docs/evolcore/group.md +3 -3
  335. package/kits/docs/evolcore/memory-consolidation.md +1 -1
  336. package/kits/docs/evolcore/menu-protocol.md +24 -2
  337. package/kits/docs/evolcore/model.md +9 -1
  338. package/kits/docs/evolcore/msg.md +30 -28
  339. package/kits/docs/evolcore/pay.md +8 -20
  340. package/kits/docs/evolcore/plugin.md +74 -0
  341. package/kits/docs/evolcore/provider.md +8 -2
  342. package/kits/docs/evolcore/rpc.md +2 -2
  343. package/kits/docs/evolcore/skill.md +17 -1
  344. package/kits/docs/evolcore/stats.md +5 -0
  345. package/kits/docs/evolcore/storage.md +22 -0
  346. package/kits/docs/evolcore/thread-chain.md +19 -10
  347. package/kits/docs/evolcore/tool-authorization.md +4 -0
  348. package/kits/docs/evolcore/trigger.md +89 -13
  349. package/kits/docs/identity/AID_PROFILE_SPEC.md +1 -1
  350. package/kits/docs/venues/feishu-group.md +3 -2
  351. package/kits/docs/venues/feishu-private.md +3 -2
  352. package/kits/rules/02-navigation.md +20 -13
  353. package/kits/rules/06-channel.md +18 -2
  354. package/kits/schemas/_meta.json +8 -4
  355. package/kits/schemas/agent-config.schema.23.json +19 -3
  356. package/kits/schemas/agent-config.schema.24.json +986 -0
  357. package/kits/schemas/agent-config.schema.25.json +986 -0
  358. package/kits/schemas/daemon.schema.11.json +487 -0
  359. package/kits/schemas/daemon.schema.12.json +505 -0
  360. package/kits/schemas/defaults.schema.8.json +484 -0
  361. package/kits/schemas/providers.schema.1.json +1 -1
  362. package/kits/schemas/providers.schema.2.json +1 -1
  363. package/kits/schemas/providers.schema.3.json +8 -2
  364. package/kits/skills/.switches.json +4 -0
  365. package/kits/skills/ability/SKILL.md +194 -27
  366. package/kits/skills/ability/STRUCTURE.md +5 -0
  367. package/kits/skills/agent-output-cards/SKILL.md +90 -54
  368. package/kits/skills/agent-output-cards/examples/html-surface.json +11 -0
  369. package/kits/skills/agent-output-cards/examples/meeting-followups.json +16 -0
  370. package/kits/skills/agent-output-cards/examples/meeting-latest.json +24 -0
  371. package/kits/skills/agent-output-cards/examples/project-metrics.json +16 -0
  372. package/kits/skills/agent-output-cards/examples/quick-links.json +18 -0
  373. package/kits/skills/agent-output-cards/examples/surface.html +8 -0
  374. package/kits/skills/agent-template-project/SKILL.md +51 -0
  375. package/kits/skills/agent-template-project/references/01-collect-and-pack.md +174 -0
  376. package/kits/skills/agent-template-project/references/02-upload-and-share.md +109 -0
  377. package/kits/skills/agent-template-project/references/03-download-and-install.md +189 -0
  378. package/kits/skills/agent-template-project/references/04-upgrade-and-recovery.md +74 -0
  379. package/kits/skills/agent-template-project/references/05-publish-to-platform.md +62 -0
  380. package/kits/skills/ec-group/SKILL.md +3 -3
  381. package/kits/skills/ec-group-collaboration/SKILL.md +4 -4
  382. package/kits/skills/ec-identity/SKILL.md +9 -6
  383. package/kits/skills/ec-pay/SKILL.md +163 -41
  384. package/kits/skills/ec-provider/SKILL.md +5 -5
  385. package/kits/skills/ec-service-call/SKILL.md +3 -0
  386. package/kits/skills/ec-skill/SKILL.md +25 -9
  387. package/kits/skills/ec-skill/scripts/cli.mjs +7 -7
  388. package/kits/skills/ec-skill/scripts/skill.mjs +55 -41
  389. package/kits/skills/ec-skill/scripts/template/SKILL.md.tmpl +9 -0
  390. package/kits/skills/ec-trigger/SKILL.md +2 -2
  391. package/kits/skills/personal-assistant/SKILL.md +22 -22
  392. package/kits/skills/personal-assistant/references/03-data-flow-and-gaps.md +1 -1
  393. package/kits/skills/scrapling-article-fetch/SKILL.md +5 -5
  394. package/kits/skills/thread-ops/SKILL.md +19 -9
  395. package/kits/skills/wechat-article-media-download/SKILL.md +2 -2
  396. package/kits/skills/wechat-article-reader/SKILL.md +2 -2
  397. package/kits/templates/system-fragments/commands.md +1 -1
  398. package/kits/templates/system-fragments/personal-assistant.md +2 -2
  399. package/kits/templates/system-fragments/reply.md +14 -9
  400. package/kits/templates/system-fragments/session.md +1 -1
  401. package/kits/templates/system-fragments/thread.md +10 -5
  402. package/package.json +6 -5
  403. package/scripts/agent-template/index.mjs +7 -1
  404. package/scripts/agent-template/inspect.mjs +81 -35
  405. package/scripts/agent-template/overlay.mjs +110 -4
  406. package/scripts/agent-template/shared/common.mjs +36 -4
  407. package/scripts/agent-template/shared/plan.mjs +4 -2
  408. package/scripts/agent-template/shared/service-packs.mjs +104 -0
  409. package/scripts/agent-template/shared/team-schema.json +467 -54
  410. package/scripts/agent-template/shared/template-contract.mjs +70 -68
  411. package/scripts/agent-template/shared/template-package.mjs +153 -36
  412. package/scripts/agent-template/shared/template-runtime.mjs +76 -64
  413. package/scripts/agent-template/shared/template.mjs +11 -46
  414. package/scripts/agent-template/team-pack.mjs +451 -35
  415. package/scripts/agent-template/team-preview.mjs +75 -226
  416. package/scripts/aid-batch/identity-batch.mjs +1 -1
  417. package/dist/agents/baseagent-availability.js +0 -176
  418. package/dist/agents/baseagent-capability-adapter.js +0 -102
  419. package/dist/agents/baseagent-plugin-loader.js +0 -145
  420. package/dist/agents/baseagent.js +0 -816
  421. package/dist/agents/codex/catalog.js +0 -80
  422. package/dist/agents/ecagent-plugin-lazy.js +0 -41
  423. package/dist/agents/tool-time-context.js +0 -55
  424. package/dist/core/legacy-rename.js +0 -41
  425. package/dist/core/plugin-lifecycle.js +0 -137
  426. package/dist/core/rate-window.js +0 -53
  427. package/dist/core/runner-reload-transaction.js +0 -60
  428. package/dist/core/runtime-lock.js +0 -90
  429. package/dist/core/soul.js +0 -66
  430. package/dist/core/system-session/grants.js +0 -40
  431. package/dist/directory/owner-directory-agentmd-sync.js +0 -89
  432. package/dist/directory/owner-directory-request-operation.js +0 -79
  433. package/dist/directory/owner-directory-text.js +0 -60
  434. package/kits/skills/ec-pay/references/pay-cli.md +0 -110
  435. /package/dist/agents/gemini/{gemini-capability-provider.js → capability-provider.js} +0 -0
  436. /package/dist/agents/gemini/{gemini-session-file-adapter.js → session-file-adapter.js} +0 -0
  437. /package/dist/{agents/claude-gateway → claude-gateway}/types.js +0 -0
  438. /package/dist/core/{system-channels.js → channel/system-channels.js} +0 -0
  439. /package/dist/core/{daemon-file-cache.js → daemon/daemon-file-cache.js} +0 -0
  440. /package/dist/core/{event-bus.js → event/event-bus.js} +0 -0
  441. /package/dist/core/{event-catalog.js → event/event-catalog.js} +0 -0
  442. /package/dist/core/{pack-ledger.js → pack/pack-ledger.js} +0 -0
  443. /package/dist/directory/{owner-directory-identity.js → identity.js} +0 -0
  444. /package/dist/directory/{owner-directory-policy.js → policy.js} +0 -0
  445. /package/dist/directory/{owner-directory-remarks.js → remarks.js} +0 -0
  446. /package/dist/directory/{owner-directory-scope.js → scope.js} +0 -0
  447. /package/dist/{contracts → ecweb/contracts}/ecweb-instance.js +0 -0
  448. /package/kits/templates/{bootstrap-welcome.md → bootstrap-intro.md} +0 -0
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "evolcore",
3
- "version": "0.0.50",
3
+ "version": "0.0.51",
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",
@@ -46,12 +46,13 @@
46
46
  ],
47
47
  "scripts": {
48
48
  "postinstall": "node bin/install-codex-managed-hooks.mjs",
49
- "predev": "npm run build:ecagent",
49
+ "predev": "npm run build:core",
50
50
  "dev": "tsx watch src/index.ts",
51
51
  "build:ecagent": "npm --prefix ecagent run build",
52
52
  "build": "node -e \"import('./bin/ec-build.mjs').then(m => m.build())\"",
53
+ "prebuild:core": "node -e \"import('./bin/ec-build.mjs').then(m => m.cleanDshRuntimeOutput())\"",
53
54
  "build:core": "npm run build:ecagent && tsc && node -e \"const f='dist/cli/index.js',c=require('fs').readFileSync(f,'utf8');if(!c.startsWith('#!'))require('fs').writeFileSync(f,'#!/usr/bin/env node\\n'+c)\" && node -e \"try{require('child_process').execFileSync('chmod',['+x','dist/cli/index.js'])}catch{}\" && node -e \"for(const f of ['error-dict.json','model-prices.jsonl'])require('fs').copyFileSync('src/utils/'+f,'dist/utils/'+f)\"",
54
- "postbuild:core": "node -e \"import('./bin/ec-build.mjs').then(m => m.writeBuildIdentity())\"",
55
+ "postbuild:core": "node -e \"import('./bin/ec-build.mjs').then(async m => { await m.cleanMovedCoreModules(); await m.copyDshAssets(); await m.writeBuildIdentity(); })\"",
55
56
  "start": "node dist/index.js",
56
57
  "test": "npm run build && vitest run",
57
58
  "test:watch": "vitest",
@@ -64,7 +65,7 @@
64
65
  "prepublishOnly": "npm test"
65
66
  },
66
67
  "dependencies": {
67
- "@agentunion/fastaun": "0.5.38",
68
+ "@agentunion/fastaun": "^0.5.42",
68
69
  "@anthropic-ai/claude-agent-sdk": "0.3.300",
69
70
  "@modelcontextprotocol/sdk": "^1.32.2",
70
71
  "ajv": "^8.20.0",
@@ -72,7 +73,7 @@
72
73
  "chokidar": "^5.0.0",
73
74
  "cron-parser": "^5.5.0",
74
75
  "dotenv": "^17.4.2",
75
- "ec-web": "0.0.50",
76
+ "ec-web": "0.0.51",
76
77
  "ignore": "7.0.5",
77
78
  "image-type": "^6.0.0",
78
79
  "jsqr": "^1.4.0",
@@ -6,7 +6,7 @@ import { parseArgs, readJson } from './shared/common.mjs';
6
6
  export async function cli(argv) {
7
7
  const command = argv[0];
8
8
  if (!command || argv.includes('--help')) {
9
- console.log('Agent template: inspect | build | read-package | preview | apply-installation | verify-installation | overlay --options-file <JSON>');
9
+ console.log('Agent template worker: inspect-module | collect-module | pack-modules | read-package | preview | apply-installation | verify-installation | overlay --options-file <JSON>');
10
10
  return 0;
11
11
  }
12
12
  const args = parseArgs(argv.slice(1), { values: ['options-file', 'agent-dir', 'template', 'out', 'aid', 'owner', 'host', 'providers', 'workspace', 'backup'] });
@@ -20,6 +20,10 @@ export async function cli(argv) {
20
20
  inspect: ['./team-pack.mjs', 'inspectCollection'],
21
21
  build: ['./team-pack.mjs', 'buildCollection'],
22
22
  'validate-selection': ['./team-pack.mjs', 'validateCollectionSelection'],
23
+ 'validate-selection-index': ['./team-pack.mjs', 'validateSelectionIndex'],
24
+ 'inspect-module': ['./team-pack.mjs', 'inspectModule'],
25
+ 'collect-module': ['./team-pack.mjs', 'collectModule'],
26
+ 'pack-modules': ['./team-pack.mjs', 'packModules'],
23
27
  'read-package': ['./team-preview.mjs', 'readPackage'],
24
28
  preview: ['./team-preview.mjs', 'previewInstallation'],
25
29
  'apply-installation': ['./team-preview.mjs', 'applyInstallationPlan'],
@@ -30,6 +34,7 @@ export async function cli(argv) {
30
34
  const entry = commands[command];
31
35
  if (!entry) throw Object.assign(new Error('Unknown template command: ' + command), { code: 'INVALID_ARGUMENT' });
32
36
  const mod = await import(new URL(entry[0], import.meta.url).href);
37
+ options.onProgress = phase => console.log(JSON.stringify({ type: 'progress', phase }));
33
38
  const result = await mod[entry[1]](options);
34
39
  console.log(JSON.stringify({ type: 'result', ok: true, data: result }));
35
40
  return 0;
@@ -39,6 +44,7 @@ if (isMainScript(import.meta.url)) {
39
44
  try { process.exitCode = await cli(process.argv.slice(2)); }
40
45
  catch (error) {
41
46
  console.log(JSON.stringify({ type: 'result', ok: false, code: error.code || 'TOOL_FAILED', message: error.message,
47
+ ...(error.details === undefined ? {} : { details: error.details }),
42
48
  ...(error.data === undefined ? {} : { data: error.data }) }));
43
49
  process.exitCode = error.code === 'INVALID_ARGUMENT' || error.name === 'UsageError' ? 2 : 1;
44
50
  }
@@ -1,16 +1,15 @@
1
1
  import fs from 'node:fs';
2
2
  import path from 'node:path';
3
3
  import { fileURLToPath } from 'node:url';
4
- import { createHash } from 'node:crypto';
5
4
  import { readJson, jsonBytes, assert, sha256, walkFiles, inside, unpack, behaviorConfig, mergeObjects,
6
- snapshot, BASEAGENTS, PROFILE_FIELDS, isRecord, regularPath, atomicBytes } from './shared/common.mjs';
5
+ snapshot, BASEAGENTS, PROFILE_FIELDS, isRecord, regularPath, atomicBytes, resourceDigest } from './shared/common.mjs';
7
6
  import { loadTemplate, MANAGED_AGENT_FIELDS, templateDigest } from './shared/template.mjs';
8
7
  import { loadEvolcore } from './shared/evolcore.mjs';
9
8
  import { validateAgainstSchema, buildAgentTriggers, resolveProviderRefs } from './shared/plan.mjs';
10
9
  import { excludedResource as excluded, isPortableEventPackFile, isPortableEventPackResource, readEventPacks, validateEventPack } from './shared/template-package.mjs';
11
10
  import { normalizeTeam } from './shared/template-contract.mjs';
12
- import { renderValue as renderTemplateValue, renderResource, bindTemplateProviders, teamMemberVariables, planMemberConfig, resolveMemberParameters, mergeMemberDefaults } from './shared/template-runtime.mjs';
13
- import { DEFAULT_ACCESS_POLICY } from '../../dist/config/access-policy.js';
11
+ import { renderValue as renderTemplateValue, renderResource, bindTemplateProviders, teamMemberVariables, planMemberConfig, resolveMemberParameters } from './shared/template-runtime.mjs';
12
+ import { portableServiceFile, portableServiceResource, readServicePacks, validateServicePack } from './shared/service-packs.mjs';
14
13
 
15
14
  export async function inspectAgent(options) {
16
15
  const config = options.effectiveConfig ?? readJson(path.join(options.agentDir, 'config.json'));
@@ -28,6 +27,7 @@ export async function inspectAgent(options) {
28
27
  activeBaseagent: config.active_baseagent,
29
28
  baseagents: BASEAGENTS.filter(name => config.baseagents?.[name]).map(name => ({ name, currentModel: config.baseagents[name].model ?? null,
30
29
  currentEffort: config.baseagents[name].effort ?? null, provider: config.baseagents[name].provider ?? null })),
30
+ services: readServicePacks(path.join(options.agentDir, 'services')).map(pack => ({ id: pack.id, name: pack.definition.name, enabled: pack.definition.enabled !== false })),
31
31
  triggers, events: readEventPacks(path.join(options.agentDir, 'events')).map(pack => ({ id: pack.id, name: pack.definition.name, enabled: pack.definition.enabled !== false })), skills: options.skills ?? [],
32
32
  project: { path: project, files: options.listProjectFiles !== false && fs.existsSync(project)
33
33
  ? fs.readdirSync(project).filter(f => !excluded(f)).sort() : [] } };
@@ -59,7 +59,7 @@ export async function inspectPackage(options) {
59
59
  assert(bytes.length === entry.size && sha256(bytes) === entry.sha256, 'INTEGRITY_FAILED', 'Manifest checksum mismatch: ' + entry.path);
60
60
  }
61
61
  assert(walkFiles(root).length === files.length + 2, 'INTEGRITY_FAILED', 'Unexpected package entries');
62
- const { tpl, errors } = loadTemplate(templateDir, { contextMemberKeys: Object.keys(options.contextMembers ?? {}) });
62
+ const { tpl, errors } = loadTemplate(templateDir);
63
63
  assert(!errors.length, 'INVALID_ARGUMENT', errors.join('; '));
64
64
  const contract = normalizeTeam(tpl.team, { packageInfo: pkg });
65
65
  assert(!contract.errors.length, 'INTEGRITY_FAILED', contract.errors.join('; '));
@@ -73,14 +73,14 @@ export async function inspectPackage(options) {
73
73
  || file.startsWith('.evolcore/skills/') || allKeys.some(key => file.startsWith('workspace/' + key + '/')
74
74
  || file.startsWith('agents/' + key + '/personal/soul/') && file.endsWith('.md') && !file.endsWith('/00-GUIDE.md')
75
75
  || file === 'agents/' + key + '/personal/welcome.md' || file.startsWith('agents/' + key + '/triggers/')
76
- || file.startsWith('agents/' + key + '/') && isPortableEventPackFile(file.slice(('agents/' + key + '/').length))),
76
+ || file.startsWith('agents/' + key + '/') && (isPortableEventPackFile(file.slice(('agents/' + key + '/').length)) || portableServiceFile(file.slice(('agents/' + key + '/').length)))),
77
77
  'INVALID_ARGUMENT', 'Unsupported template resource: ' + file);
78
78
  assert(!options.sourceMemberKey || allKeys.includes(options.sourceMemberKey), 'INTEGRITY_FAILED', 'Original source member is absent');
79
79
  const keys = options.sourceMemberKey ? [options.sourceMemberKey] : allKeys;
80
80
  const platforms = tpl.team.host.platform;
81
81
  if (platforms !== undefined) assert(Array.isArray(platforms) && platforms.length
82
- && platforms.every(p => ['linux', 'darwin', 'win32'].includes(p)) && platforms.includes(process.platform),
83
- 'INCOMPATIBLE', 'Template host.platform must support this host');
82
+ && platforms.every(p => ['linux', 'darwin', 'win32'].includes(p)),
83
+ 'INCOMPATIBLE', 'Invalid template host.platform');
84
84
  if (!options.targets) {
85
85
  assert(keys.length === 1, 'INVALID_ARGUMENT', 'Provide targets mapping for every template member');
86
86
  return inspectMember(options, { pkg, tpl, templateDir, files, key: keys[0] });
@@ -92,8 +92,8 @@ export async function inspectPackage(options) {
92
92
  && new Set(contexts.map(c => c.targetAid)).size === contexts.length,
93
93
  'INVALID_ARGUMENT', 'Members must map to distinct Agents on the same host');
94
94
  assert(Object.keys(options.members ?? {}).every(key => keys.includes(key)), 'INVALID_ARGUMENT', 'Unknown member selection');
95
- const writes = new Map(); const members = []; const plans = [];
96
- const memberVars = teamMemberVariables({ ...options.contextMembers, ...Object.fromEntries(keys.map(key => [key,
95
+ const writes = new Map(); const members = []; const plans = []; const skillSnapshots = {};
96
+ const memberVars = teamMemberVariables({ ...Object.fromEntries(keys.map(key => [key,
97
97
  { aid: options.targets[key].targetAid, projectPath: options.targets[key].projectPath ?? options.targets[key].targetConfig?.projects?.defaultPath }])) },
98
98
  contexts[0].ownerAid, contexts[0].hostAid);
99
99
  for (const key of keys) {
@@ -101,10 +101,15 @@ export async function inspectPackage(options) {
101
101
  const out = inside(options.out ?? path.dirname(root), 'members/' + key);
102
102
  const data = await inspectMember({ ...options.targets[key], out, packageRoot: options.packageRoot, digest: options.digest,
103
103
  pullId: options.pullId, planMode: options.planMode, singleMember: !!options.sourceMemberKey, affectedAids: options.affectedAids,
104
- memberVars: memberVars[key], selections: selection.providers ?? {}, externalAids: selection.externalAids ?? {} },
105
- { pkg, tpl, templateDir, key, memberDefaults: options.memberDefaults?.[key], files: files.filter(f => !f.startsWith('agents/') && !f.startsWith('workspace/')
104
+ memberVars: memberVars[key], selections: selection.providers ?? {}, externalAids: selection.externalAids ?? {},
105
+ skillResolutions: selection.skillResolutions ?? {} },
106
+ { pkg, tpl, templateDir, key, files: files.filter(f => !f.startsWith('agents/') && !f.startsWith('workspace/')
106
107
  || f.startsWith('agents/' + key + '/') || f.startsWith('workspace/' + key + '/')) });
107
108
  const plan = readJson(data.planFile);
109
+ for (const [dir, digest] of Object.entries(plan.skillSnapshots ?? {})) {
110
+ assert(!Object.hasOwn(skillSnapshots, dir) || skillSnapshots[dir] === digest, 'CONFLICT', 'Shared skill changed during preview');
111
+ skillSnapshots[dir] = digest;
112
+ }
108
113
  for (const write of plan.writes) {
109
114
  const previous = writes.get(write.path);
110
115
  assert(!previous || JSON.stringify(previous) === JSON.stringify(write), 'CONFLICT', 'Members write different shared content: ' + write.path);
@@ -118,12 +123,12 @@ export async function inspectPackage(options) {
118
123
  }
119
124
  const planFile = path.join(options.out ?? path.dirname(root), 'plan.json');
120
125
  atomicBytes(planFile, jsonBytes({ version: 1, home: contexts[0].home, templateDir,
121
- templateDigest: templateDigest(templateDir), package: pkg, writes: [...writes.values()], members: plans }));
126
+ templateDigest: templateDigest(templateDir), package: pkg, writes: [...writes.values()], members: plans, skillSnapshots }));
122
127
  return { pullId: options.pullId, template: members[0].template, compatible: true, incompatible: [],
123
128
  members, externalAids: pkg.externalAids ?? [], planFile };
124
129
  }
125
130
 
126
- async function inspectMember(options, { pkg, tpl, templateDir, files, key, memberDefaults }) {
131
+ async function inspectMember(options, { pkg, tpl, templateDir, files, key }) {
127
132
  const root = path.dirname(templateDir);
128
133
  const targets = options.targetConfig;
129
134
  assert(targets?.aid === options.targetAid, 'INVALID_ARGUMENT', 'Target configuration required');
@@ -131,7 +136,7 @@ async function inspectMember(options, { pkg, tpl, templateDir, files, key, membe
131
136
  assert(typeof project === 'string' && path.isAbsolute(project), 'INVALID_ARGUMENT', 'Target default project required');
132
137
  const vars = options.memberVars ?? teamMemberVariables({ [key]: { aid: options.targetAid, projectPath: project } }, options.ownerAid, options.hostAid)[key];
133
138
  const renderValue = value => renderTemplateValue(value, vars, options.externalAids ?? {});
134
- const originalMember = mergeMemberDefaults(memberDefaults ?? {}, tpl.team.agents.find(member => member.key === key));
139
+ const originalMember = tpl.team.agents.find(member => member.key === key);
135
140
  const parameters = resolveMemberParameters(originalMember);
136
141
  const spec = { ...renderValue(originalMember), ...parameters };
137
142
  if (isRecord(spec.config)) for (const field of ['version', 'update']) delete spec.config[field];
@@ -139,7 +144,7 @@ async function inspectMember(options, { pkg, tpl, templateDir, files, key, membe
139
144
  || file.startsWith('.evolcore/skills/') || file.startsWith('workspace/' + key + '/')
140
145
  || file.startsWith('agents/' + key + '/personal/soul/') && file.endsWith('.md') && !file.endsWith('/00-GUIDE.md')
141
146
  || file === 'agents/' + key + '/personal/welcome.md' || file.startsWith('agents/' + key + '/triggers/')
142
- || file.startsWith('agents/' + key + '/') && isPortableEventPackFile(file.slice(('agents/' + key + '/').length)),
147
+ || file.startsWith('agents/' + key + '/') && (isPortableEventPackFile(file.slice(('agents/' + key + '/').length)) || portableServiceFile(file.slice(('agents/' + key + '/').length))),
143
148
  'INVALID_ARGUMENT', 'Unsupported template resource: ' + file);
144
149
  assert(isRecord(spec.config) && !MANAGED_AGENT_FIELDS.some(f => f in spec.config)
145
150
  && Object.keys(spec.config).every(f => ['chatmode', 'memory', 'access', 'active_baseagent', 'baseagents', 'version', 'update'].includes(f)),
@@ -153,13 +158,13 @@ async function inspectMember(options, { pkg, tpl, templateDir, files, key, membe
153
158
  finally { /* Modules remain loaded; scratch is cleaned after validation below. */ }
154
159
  try {
155
160
  const { default: semver } = await import('semver');
156
- assert(Array.isArray(pkg.compat?.platforms) && pkg.compat.platforms.includes(process.platform)
161
+ assert(Array.isArray(pkg.compat?.platforms)
157
162
  && semver.validRange(pkg.compat.evolcore)
158
163
  && (semver.satisfies(ec.version, pkg.compat.evolcore, { includePrerelease: true })
159
164
  || !pkg.compat.templateFeatures?.length && semver.satisfies(ec.version.replace(/-test\.\d+$/, ''), pkg.compat.evolcore, { includePrerelease: true }))
160
165
  && (pkg.compat.templateFeatures === undefined || Array.isArray(pkg.compat.templateFeatures)
161
- && pkg.compat.templateFeatures.every(feature => ['member-references-v1', 'event-packs-v1', 'optional-members-v1'].includes(feature))),
162
- 'INCOMPATIBLE', 'Platform or EvolCore version is incompatible', { incompatible: ['platform/version'] });
166
+ && pkg.compat.templateFeatures.every(feature => ['member-references-v1', 'event-packs-v1', 'service-packs-v1'].includes(feature))),
167
+ 'INCOMPATIBLE', 'EvolCore version or template features are incompatible', { incompatible: ['version/features'] });
163
168
  const selections = options.selections ?? {};
164
169
  for (const [name, block] of Object.entries(spec.config.baseagents ?? {})) {
165
170
  assert(BASEAGENTS.includes(name) && isRecord(block) && Object.keys(block).every(f => ['provider', 'model', 'effort', 'params'].includes(f)),
@@ -173,13 +178,17 @@ async function inspectMember(options, { pkg, tpl, templateDir, files, key, membe
173
178
  assert(resolved.baseagents?.[resolved.active_baseagent], 'INVALID_ARGUMENT', 'Default baseagent must be selected');
174
179
  assert(Object.keys(selections).every(name => resolved.baseagents?.[name]), 'INVALID_ARGUMENT', 'Unknown baseagent selection');
175
180
  const config = mergeObjects(targets, resolveProviderRefs(resolved));
176
- if (config.access !== undefined) {
177
- config.access.requestLimit = { ...DEFAULT_ACCESS_POLICY.requestLimit, ...config.access.requestLimit };
178
- }
179
181
  for (const field of ['version', 'update']) if (Object.hasOwn(parameters, field)) {
180
182
  config[field] = structuredClone(parameters[field]);
181
183
  }
182
- for (const [name, select] of Object.entries(selections)) if (select.effort === null) delete config.baseagents[name].effort;
184
+ if (options.planMode === 'overlay_existing' && Object.hasOwn(targets, 'update')) {
185
+ config.update = structuredClone(targets.update);
186
+ }
187
+ for (const [name, select] of Object.entries(selections)) {
188
+ if (select.provider === null) delete config.baseagents[name].provider;
189
+ if (select.model === null) delete config.baseagents[name].model;
190
+ if (select.effort === null) delete config.baseagents[name].effort;
191
+ }
183
192
  const configErrors = ec.validate('Agent', config);
184
193
  assert(!configErrors.length, 'INVALID_ARGUMENT', configErrors.join('; '));
185
194
  const agentDir = path.join(options.home, 'agents', options.targetAid);
@@ -191,24 +200,39 @@ async function inspectMember(options, { pkg, tpl, templateDir, files, key, membe
191
200
  publisherAid: pkg.publisher?.aid, digest: options.digest, installedAt: Date.now() }));
192
201
  const render = (bytes, relative = '') => renderResource(bytes, vars, options.externalAids ?? {}, { json: relative.endsWith('.json') });
193
202
  const preview = { profile: { fields: PROFILE_FIELDS.filter(f => spec.profile?.[f] !== undefined), preserve: ['aid', 'type', 'owner'] },
194
- soul: { add: [], overwrite: [] }, triggers: { add: [], overwrite: [] }, events: { add: [], overwrite: [] }, skills: [], files: { add: 0, overwrite: 0 },
203
+ soul: { add: [], overwrite: [] }, triggers: { add: [], overwrite: [] }, events: { add: [], overwrite: [] }, services: { add: [], overwrite: [] }, skills: [], files: { add: 0, overwrite: 0 },
195
204
  project: { path: project, changeDefault: false }, config: Object.keys(resolved) };
196
- const skillMapping = {};
205
+ const skillMapping = {}; const skillSnapshots = {};
197
206
  const localNames = [...new Set(files.filter(f => f.startsWith('.evolcore/skills/')).map(f => f.split('/')[2]))]
198
- .filter(name => !options.singleMember || Object.hasOwn(spec.skills ?? {}, name));
207
+ .filter(name => Object.hasOwn(spec.skills ?? {}, name));
208
+ assert(Object.keys(options.skillResolutions ?? {}).every(name => localNames.includes(name)), 'INVALID_ARGUMENT', 'Unknown skill resolution');
199
209
  for (const name of localNames) {
200
210
  const source = inside(path.join(templateDir, '.evolcore', 'skills'), name);
201
- const hash = createHash('sha256');
202
- for (const p of walkFiles(source)) hash.update(p).update('\0').update(render(fs.readFileSync(inside(source, p)), p)).update('\0');
203
- const desiredDigest = hash.digest('hex').slice(0, 12);
211
+ const desiredDigest = resourceDigest(source, render);
204
212
  let destName = name;
205
213
  const original = inside(path.join(options.home, 'skills'), name);
206
- if (fs.existsSync(original) && templateDigest(original) !== desiredDigest) destName += '--' + pkg.id;
214
+ if (!options.singleMember && fs.existsSync(original) && resourceDigest(original) !== desiredDigest) destName += '--' + pkg.id;
207
215
  const dest = inside(path.join(options.home, 'skills'), destName);
208
- if (fs.existsSync(dest)) assert(templateDigest(dest) === desiredDigest, options.singleMember ? 'SHARED_RESOURCE_CONFLICT' : 'CONFLICT',
209
- 'Skill name conflicts: ' + destName, options.singleMember ? { path: dest, affectedAids: options.affectedAids ?? [] } : undefined);
216
+ const currentDigest = fs.existsSync(dest) ? resourceDigest(dest) : null;
217
+ skillSnapshots[dest] = currentDigest;
210
218
  skillMapping[name] = destName;
211
- preview.skills.push({ name, installAs: destName });
219
+ if (currentDigest && currentDigest !== desiredDigest && !options.singleMember) {
220
+ // Single-Agent updates validate shared resources against their installation manifest.
221
+ const choice = options.skillResolutions?.[name];
222
+ const resolution = choice?.currentDigest === currentDigest && choice?.incomingDigest === desiredDigest
223
+ && ['overwrite', 'skip'].includes(choice.action) ? choice.action : null;
224
+ preview.skills.push({ name, installAs: destName,
225
+ conflict: { currentDigest, incomingDigest: desiredDigest, resolution } });
226
+ if (resolution !== 'overwrite') continue;
227
+ const incoming = new Set(walkFiles(source));
228
+ for (const relative of walkFiles(dest)) if (!incoming.has(relative)) {
229
+ const target = inside(dest, relative);
230
+ writes.push({ path: target, remove: true, expected: snapshot(target) });
231
+ }
232
+ } else {
233
+ preview.skills.push({ name, installAs: destName });
234
+ if (currentDigest === desiredDigest) continue;
235
+ }
212
236
  for (const p of walkFiles(source)) add(inside(dest, p), render(fs.readFileSync(inside(source, p)), p),
213
237
  fs.statSync(inside(source, p)).mode & 0o111 ? 0o755 : 0o644);
214
238
  }
@@ -243,9 +267,30 @@ async function inspectMember(options, { pkg, tpl, templateDir, files, key, membe
243
267
  add(center, jsonBytes({ v: 1, enabled: true, authMode: 'allowlist',
244
268
  admission: { coupling: 'on', rematerializeMs: 300_000 }, rules: {}, rateLimit: { perMinute: 60, perHour: 600 } }));
245
269
  }
270
+ const servicePacks = readServicePacks(path.join(templateDir, 'agents', key, 'services'));
271
+ for (const pack of servicePacks) {
272
+ const dir = inside(path.join(agentDir, 'services'), pack.id);
273
+ const definition = renderValue(pack.definition);
274
+ definition.enabled = false;
275
+ validateServicePack(definition, pack.files, { location: 'services/' + pack.id });
276
+ add(path.join(dir, 'pack.json'), jsonBytes(definition));
277
+ preview.services[fs.existsSync(path.join(dir, 'pack.json')) ? 'overwrite' : 'add'].push(pack.id);
278
+ for (const relative of pack.files.filter(file => file !== 'pack.json')) {
279
+ add(inside(dir, relative), render(fs.readFileSync(inside(pack.dir, relative)), relative),
280
+ fs.statSync(inside(pack.dir, relative)).mode & 0o111 ? 0o755 : 0o644);
281
+ }
282
+ for (const relative of walkFiles(dir, file => !portableServiceResource(file))) {
283
+ if (!pack.files.includes(relative)) {
284
+ const target = inside(dir, relative);
285
+ writes.push({ path: target, remove: true, expected: snapshot(target) });
286
+ }
287
+ }
288
+ const archived = path.join(dir, '.archived');
289
+ if (fs.existsSync(archived)) writes.push({ path: archived, remove: true, expected: snapshot(archived) });
290
+ }
246
291
  const failures = []; const allowedTriggerFiles = new Set();
247
292
  const triggers = buildAgentTriggers({ templateRoot: templateDir, key, aid: options.targetAid, vars, ec,
248
- rec: { check: (name, ok, detail) => { if (!ok) failures.push(name + ': ' + String(detail)); } } });
293
+ rec: { check: (name, ok, detail) => { if (!ok) failures.push(name + ': ' + (typeof detail === 'string' ? detail : JSON.stringify(detail))); } } });
249
294
  assert(!failures.length, 'INVALID_ARGUMENT', failures.join('; '));
250
295
  const triggerNames = new Set();
251
296
  for (const { id, definition } of triggers) {
@@ -283,7 +328,7 @@ async function inspectMember(options, { pkg, tpl, templateDir, files, key, membe
283
328
  }
284
329
  }
285
330
  const plan = { version: 1, targetAid: options.targetAid, home: options.home, projectPath: project,
286
- templateDir, templateDigest: templateDigest(templateDir), package: pkg, writes,
331
+ templateDir, templateDigest: templateDigest(templateDir), package: pkg, writes, skillSnapshots,
287
332
  managedConfig: { ...resolveProviderRefs(resolved), ...parameters },
288
333
  managedSkills: Object.fromEntries(Object.entries(spec.skills ?? {}).map(([name, value]) => [skillMapping[name] ?? name, { enabled: value.enabled === true }])),
289
334
  profile: spec.profile,
@@ -294,6 +339,7 @@ async function inspectMember(options, { pkg, tpl, templateDir, files, key, membe
294
339
  compatible: true, incompatible: [], currentConfig: { baseagents: Object.entries((options.effectiveConfig ?? targets).baseagents ?? {}).map(([name, b]) => ({ name, ...b })),
295
340
  soul: fs.existsSync(path.join(agentDir, 'personal', 'soul')) ? fs.readdirSync(path.join(agentDir, 'personal', 'soul')) : [],
296
341
  triggers: fs.existsSync(path.join(agentDir, 'triggers')) ? fs.readdirSync(path.join(agentDir, 'triggers')) : [],
342
+ services: servicePacks.filter(pack => fs.existsSync(path.join(agentDir, 'services', pack.id, 'pack.json'))).map(pack => pack.id),
297
343
  events: eventPacks.filter(pack => fs.existsSync(path.join(agentDir, 'events', pack.id, 'pack.json'))).map(pack => pack.id) },
298
344
  providers: refs, preview, externalAids: pkg.externalAids ?? [], planFile };
299
345
  } finally { fs.rmSync(scratch, { recursive: true, force: true }); }
@@ -1,16 +1,95 @@
1
1
  import fs from 'node:fs';
2
2
  import path from 'node:path';
3
- import { assert, snapshot, equalSnapshot, readJson, jsonBytes, atomicBytes, regularPath, sha256 } from './shared/common.mjs';
3
+ import { assert, snapshot, equalSnapshot, readJson, jsonBytes, atomicBytes, regularPath, sha256, resourceDigest } from './shared/common.mjs';
4
4
  import { templateDigest } from './shared/template.mjs';
5
5
 
6
+ function desiredSnapshot(write) {
7
+ // Windows chmod implements the read-only flag, not POSIX group/execute bits.
8
+ return write.remove ? null : { sha256: sha256(Buffer.from(write.content, 'base64')),
9
+ mode: process.platform === 'win32' ? (write.mode & 0o200 ? 0o666 : 0o444) : write.mode };
10
+ }
11
+
6
12
  export function verifyPlan(plan) {
7
13
  assert(templateDigest(plan.templateDir) === plan.templateDigest, 'CONFLICT', 'Cached template changed');
14
+ for (const [dir, digest] of Object.entries(plan.skillSnapshots ?? {})) {
15
+ assert((fs.existsSync(dir) ? resourceDigest(dir) : null) === digest, 'CONFLICT', 'Shared skill changed: ' + dir);
16
+ }
8
17
  for (const [file, expected] of Object.entries(plan.observed ?? {})) {
9
18
  assert(equalSnapshot(snapshot(file), expected), 'CONFLICT', 'Observed target changed: ' + file);
10
19
  }
11
20
  for (const write of plan.writes) assert(equalSnapshot(snapshot(write.path), write.expected), 'CONFLICT', 'Target changed: ' + write.path);
12
21
  }
13
22
 
23
+ function managedLocation(plan, file) {
24
+ const member = plan.members[0];
25
+ for (const [scope, root] of [['agent', path.join(plan.home, 'agents', member.targetAid)], ['workspace', member.projectPath], ['shared', path.join(plan.home, 'skills')]]) {
26
+ const relative = path.relative(root, file);
27
+ if (relative && relative !== '..' && !relative.startsWith('..' + path.sep) && !path.isAbsolute(relative)) return scope + '/' + relative.split(path.sep).join('/');
28
+ }
29
+ throw Object.assign(new Error('Unexpected installation resource'), { code: 'INVALID_ARGUMENT' });
30
+ }
31
+
32
+ function stageInstallation(plan) {
33
+ if (!plan.commitInstallation) return;
34
+ const member = plan.members[0]; const agentDir = path.join(plan.home, 'agents', member.targetAid);
35
+ const configPath = path.join(agentDir, 'config.json');
36
+ const config = plan.writes.find(write => write.path === configPath);
37
+ const finalConfig = JSON.parse(Buffer.from(config.content, 'base64'));
38
+ finalConfig.version = plan.commitInstallation.release.version;
39
+ plan.finalConfig = { path: configPath, content: jsonBytes(finalConfig).toString('base64'), mode: config.mode };
40
+ const manifest = plan.writes.filter(write => !write.remove).map(write => {
41
+ const bytes = Buffer.from(write.path === configPath ? plan.finalConfig.content : write.content, 'base64');
42
+ return { path: managedLocation(plan, write.path), sha256: sha256(bytes), size: bytes.length, mode: write.mode,
43
+ ...(write.path === path.join(agentDir, 'skills', '.switches.json') ? { skills: Object.keys(member.managedSkills ?? {}) } : {}) };
44
+ }).sort((a, b) => a.path.localeCompare(b.path));
45
+ const bytes = jsonBytes(manifest);
46
+ const installation = { ...plan.commitInstallation, manifestDigest: 'sha256:' + sha256(bytes) };
47
+ const lockPath = path.join(agentDir, 'template.lock.json');
48
+ let previous = null;
49
+ if (fs.existsSync(lockPath)) {
50
+ try { const old = readJson(lockPath); previous = old.schemaVersion === 2 ? old.installation : old.installation ?? old; } catch { /* Invalid old records are backed up without granting cleanup authority. */ }
51
+ }
52
+ for (const [file, content] of [[path.join(agentDir, 'template.manifest.json'), bytes],
53
+ [lockPath, jsonBytes({ schemaVersion: 2, installation: previous, pending: { jobId: installation.committedJobId, installation } })]]) {
54
+ plan.writes.push({ path: file, content: content.toString('base64'), mode: 0o600, expected: snapshot(file) });
55
+ }
56
+ }
57
+
58
+ function finalizeInstallation(plan, backupDir) {
59
+ const file = path.join(backupDir, 'journal.json'); const journal = readJson(file);
60
+ assert(journal.applied && !journal.restored, 'INSTALL_BROKEN', 'Installation is not ready to commit');
61
+ const write = plan.finalConfig;
62
+ const entry = journal.entries.find(entry => entry.path === write.path);
63
+ const desired = { sha256: sha256(Buffer.from(write.content, 'base64')), mode: write.mode };
64
+ assert(entry && (equalSnapshot(snapshot(write.path), entry.desired) || equalSnapshot(snapshot(write.path), desired)), 'CONFLICT', 'Configuration changed before version commit');
65
+ entry.intermediate = [...(entry.intermediate ?? []), entry.desired]; entry.desired = desired;
66
+ atomicBytes(file, jsonBytes(journal), 0o600);
67
+ atomicBytes(write.path, Buffer.from(write.content, 'base64'), write.mode);
68
+ return { finalized: true };
69
+ }
70
+
71
+ function cleanupUpgrade(plan, backupDir) {
72
+ const file = path.join(backupDir, 'journal.json'); const journal = readJson(file);
73
+ if (journal.cleanup) return journal.cleanup;
74
+ const old = plan.installationManifest;
75
+ const known = old?.previousValid ? new Map(old.oldFiles.map(entry => [entry.path, entry])) : null;
76
+ const retained = []; let cleaned = 0;
77
+ for (const entry of journal.entries.filter(entry => entry.existed)) {
78
+ const backup = path.join(backupDir, entry.backup);
79
+ if (!fs.existsSync(backup)) continue;
80
+ const relative = managedLocation(plan, entry.path); const expected = known?.get(relative);
81
+ const bytes = fs.readFileSync(backup);
82
+ if (expected && bytes.length === expected.size && sha256(bytes) === expected.sha256
83
+ && (expected.mode === undefined || expected.mode === entry.mode)) {
84
+ fs.rmSync(backup); cleaned++;
85
+ } else retained.push({ path: entry.path, backup, reason: !known ? 'PREVIOUS_MANIFEST_UNAVAILABLE'
86
+ : !expected ? 'UNREGISTERED' : 'LOCALLY_MODIFIED' });
87
+ }
88
+ const cleanup = { backupDir, cleaned, retained, retainedAll: known === null };
89
+ atomicBytes(file, jsonBytes({ ...journal, cleanup }), 0o600);
90
+ return cleanup;
91
+ }
92
+
14
93
  export function restore(backupDir) {
15
94
  const file = path.join(backupDir, 'journal.json');
16
95
  const journal = readJson(file);
@@ -19,7 +98,8 @@ export function restore(backupDir) {
19
98
  if (!Object.hasOwn(entry, 'desired')) continue; // Legacy journals retain their original recovery behavior.
20
99
  const current = snapshot(entry.path);
21
100
  const original = entry.existed ? { sha256: sha256(fs.readFileSync(path.join(backupDir, entry.backup))), mode: entry.mode } : null;
22
- assert(equalSnapshot(current, original) || equalSnapshot(current, entry.desired),
101
+ assert(equalSnapshot(current, original) || equalSnapshot(current, entry.desired)
102
+ || entry.intermediate?.some(value => equalSnapshot(current, value)),
23
103
  'INSTALL_BROKEN', 'Independent change prevents safe restore: ' + entry.path);
24
104
  }
25
105
  for (const entry of [...journal.entries].reverse()) {
@@ -37,15 +117,41 @@ export function restore(backupDir) {
37
117
  export async function overlay(options) {
38
118
  if (options.operation === 'restore') return restore(options.backupDir);
39
119
  const plan = options.plan ?? readJson(options.planFile);
120
+ if (['prepare-installation-record', 'record-installation'].includes(options.operation)) {
121
+ const member = plan.members[0]; const dir = path.join(plan.home, 'agents', member.targetAid);
122
+ const prepare = () => {
123
+ const config = readJson(path.join(dir, 'config.json'));
124
+ const manifest = plan.writes.filter(write => !write.remove && !['template.lock.json', 'template.manifest.json'].includes(path.basename(write.path)))
125
+ .map(write => { const bytes = fs.readFileSync(write.path); return { path: managedLocation(plan, write.path), size: bytes.length,
126
+ sha256: sha256(bytes), mode: fs.statSync(write.path).mode & 0o777,
127
+ ...(managedLocation(plan, write.path) === 'agent/skills/.switches.json' ? { skills: Object.keys(plan.members[0].managedSkills ?? {}) } : {}) }; });
128
+ const installation = { ...options.installation, manifestDigest: 'sha256:' + sha256(jsonBytes(manifest)) };
129
+ assert(config.version === installation.release.version && config.update?.key === installation.source.key, 'CONFLICT', 'New installation identity changed');
130
+ return { manifest, installation };
131
+ };
132
+ const prepared = options.prepared ?? prepare();
133
+ if (options.operation === 'prepare-installation-record') return prepared;
134
+ if (options.prepared) assert(sha256(jsonBytes(prepare())) === sha256(jsonBytes(prepared)),
135
+ 'CONFLICT', 'Installed resources changed before installation registration');
136
+ const { installation, manifest } = prepared; const bytes = jsonBytes(manifest);
137
+ atomicBytes(path.join(dir, 'template.manifest.json'), bytes, 0o600);
138
+ atomicBytes(path.join(dir, 'template.lock.json'), jsonBytes({ schemaVersion: 2, installation: null,
139
+ pending: { jobId: installation.committedJobId, installation } }), 0o600);
140
+ return { recorded: true };
141
+ }
142
+ if (options.operation === 'cleanup-upgrade') return cleanupUpgrade(plan, options.backupDir);
143
+ if (options.operation === 'finalize-upgrade') return finalizeInstallation(plan, options.backupDir);
40
144
  if (options.operation === 'verify-applied') {
41
145
  for (const write of plan.writes) {
42
- const expected = write.remove ? null : { sha256: sha256(Buffer.from(write.content, 'base64')), mode: write.mode };
146
+ const expected = desiredSnapshot(write);
43
147
  assert(equalSnapshot(snapshot(write.path), expected), 'INTEGRITY_FAILED', 'Applied resource differs: ' + write.path);
44
148
  }
45
149
  return { verified: true };
46
150
  }
47
151
  verifyPlan(plan);
48
152
  if (options.operation === 'verify') return { valid: true };
153
+ stageInstallation(plan);
154
+ if (options.planFile) atomicBytes(options.planFile, jsonBytes(plan), 0o600);
49
155
  const backupDir = options.backupDir;
50
156
  const file = path.join(backupDir, 'journal.json');
51
157
  const journal = { version: 1, targetAid: plan.targetAid,
@@ -60,7 +166,7 @@ export async function overlay(options) {
60
166
  regularPath(write.path);
61
167
  const existing = snapshot(write.path);
62
168
  const entry = { path: write.path, existed: existing !== null, mode: existing?.mode ?? write.mode, backup: i + '.bin',
63
- desired: write.remove ? null : { sha256: sha256(Buffer.from(write.content, 'base64')), mode: write.mode } };
169
+ desired: desiredSnapshot(write) };
64
170
  if (existing) atomicBytes(path.join(backupDir, entry.backup), fs.readFileSync(write.path), 0o600);
65
171
  journal.entries.push(entry);
66
172
  let dir = path.dirname(write.path); const missing = [];
@@ -12,7 +12,7 @@ const parentPid = process.ppid;
12
12
 
13
13
  export const LIMITS = { file: 20 * 1024 * 1024, total: 200 * 1024 * 1024, entries: 20000 };
14
14
  export const BASEAGENTS = ['claude', 'codex', 'gemini', 'ecagent'];
15
- export const CONFIG_FIELDS = ['chatmode', 'memory', 'access'];
15
+ export const CONFIG_FIELDS = ['chatmode', 'memory'];
16
16
  export const PROFILE_FIELDS = ['name', 'description', 'avatar', 'tags', 'exttype'];
17
17
 
18
18
  export function assert(value, code, message, data) {
@@ -48,7 +48,7 @@ export function regularPath(target) {
48
48
  }
49
49
  }
50
50
 
51
- export function walkFiles(root, exclude = () => false, { maxTotalBytes = LIMITS.total, onOversizedFile, onMissingFile } = {}) {
51
+ export function walkFiles(root, exclude = () => false, { maxTotalBytes = LIMITS.total, onOversizedFile, onMissingFile, onSymbolicLink } = {}) {
52
52
  if (!fs.existsSync(root)) return [];
53
53
  regularPath(root);
54
54
  const files = [];
@@ -64,8 +64,14 @@ export function walkFiles(root, exclude = () => false, { maxTotalBytes = LIMITS.
64
64
  for (const e of entries.sort((a, b) => a.name.localeCompare(b.name))) {
65
65
  const file = path.join(dir, e.name);
66
66
  if (exclude(posix(path.relative(root, file)))) continue;
67
+ if (e.isSymbolicLink() && onSymbolicLink) {
68
+ assert(count < LIMITS.entries, 'PACKAGE_TOO_LARGE', 'Too many package files', { kind: 'entry-limit', limit: LIMITS.entries });
69
+ count++;
70
+ onSymbolicLink(posix(path.relative(root, file)));
71
+ continue;
72
+ }
67
73
  assert(!e.isSymbolicLink() && (e.isFile() || e.isDirectory()), 'INVALID_ARGUMENT', 'Only regular files/directories: ' + file);
68
- assert(count < LIMITS.entries, 'PACKAGE_TOO_LARGE', 'Too many package files');
74
+ assert(count < LIMITS.entries, 'PACKAGE_TOO_LARGE', 'Too many package files', { kind: 'entry-limit', limit: LIMITS.entries });
69
75
  if (e.isDirectory()) visit(file);
70
76
  else {
71
77
  count++;
@@ -90,6 +96,15 @@ export function walkFiles(root, exclude = () => false, { maxTotalBytes = LIMITS.
90
96
  return files.sort();
91
97
  }
92
98
 
99
+ // Portable paths and one ordering on both sides, including nested files on Windows.
100
+ export function resourceDigest(root, render = bytes => bytes) {
101
+ const hash = createHash('sha256');
102
+ for (const relative of walkFiles(root)) {
103
+ hash.update(relative).update('\0').update(render(fs.readFileSync(inside(root, relative)), relative)).update('\0');
104
+ }
105
+ return 'sha256:' + hash.digest('hex');
106
+ }
107
+
93
108
  export function atomicBytes(file, bytes, mode = 0o644) {
94
109
  assert(isProcessRunning(parentPid), 'TASK_INTERRUPTED', 'Template coordinator exited');
95
110
  regularPath(file);
@@ -112,7 +127,24 @@ export function snapshot(file) {
112
127
  } catch (error) { if (error.code === 'ENOENT') return null; throw error; }
113
128
  }
114
129
 
115
- export function equalSnapshot(a, b) { return JSON.stringify(a) === JSON.stringify(b); }
130
+ /**
131
+ * 比较两份快照。内容哈希始终比较;mode 只在支持 POSIX 权限的平台上比较。
132
+ *
133
+ * 为什么:Windows 上 `fs.chmod` 对普通文件基本不生效(实测写入 0o600/0o644/0o777
134
+ * 读回都是 0o666),而 plan/journal 里记录的是**期望** mode。若把 mode 纳入比较,
135
+ * 「安装后校验」与「恢复前校验」在 Windows 上必然判成不一致,restore 会以
136
+ * "Independent change prevents safe restore" 拒绝回滚——这不是真的冲突。
137
+ * 同仓 `team-preview.mjs` 的 verifyInstallationPlan 已有 `process.platform !== 'win32'`
138
+ * 的同类判断,这里与之保持一致。
139
+ */
140
+ export function equalSnapshot(a, b) {
141
+ const normalize = value => value === null || value === undefined
142
+ ? value
143
+ : { sha256: value.sha256 };
144
+ const left = process.platform === 'win32' ? normalize(a) : a;
145
+ const right = process.platform === 'win32' ? normalize(b) : b;
146
+ return JSON.stringify(left) === JSON.stringify(right);
147
+ }
116
148
 
117
149
  export function mergeObjects(existing, overlay) {
118
150
  const out = structuredClone(existing);
@@ -5,7 +5,7 @@
5
5
  */
6
6
  import fs from 'node:fs';
7
7
  import path from 'node:path';
8
- import { renderText, renderValue } from './template-runtime.mjs';
8
+ import { renderText, renderValue, MEMBER_KEY, applyMemberResourceState } from './template-runtime.mjs';
9
9
  import { validateContractSchema } from './template-contract.mjs';
10
10
 
11
11
  /**
@@ -77,7 +77,8 @@ export function checkAgentProvider({ config, defaults = {}, providers = {}, base
77
77
  * @param {{ templateRoot: string, key: string, aid: string, vars: Record<string, string>, ec: any, rec: any }} opts
78
78
  * @returns {Array<{ id: string, definition: object }>}
79
79
  */
80
- export function buildAgentTriggers({ templateRoot, key, aid, vars, ec, rec }) {
80
+ export function buildAgentTriggers({ templateRoot, key, aid, vars, ec, rec, member }) {
81
+ if (!MEMBER_KEY.test(key)) throw new Error('Invalid source member key');
81
82
  const triggersDir = path.join(templateRoot, 'agents', key, 'triggers');
82
83
  if (!fs.existsSync(triggersDir)) return [];
83
84
  const agentVars = { ...vars, 'agent.aid': aid };
@@ -88,6 +89,7 @@ export function buildAgentTriggers({ templateRoot, key, aid, vars, ec, rec }) {
88
89
  let rendered;
89
90
  try { rendered = renderValue(JSON.parse(fs.readFileSync(file, 'utf8')), agentVars); } catch (err) { rec.check(`trigger[${key}/${id}]`, false, err.message); continue; }
90
91
  try {
92
+ rendered = applyMemberResourceState(member, 'triggers/' + id + '/trigger.json', rendered);
91
93
  const def = ec.validateTrigger(rendered);
92
94
  rec.check(`trigger[${key}/${id}]`, def.agentAid === aid && def.id === id, { agentAid: def.agentAid, id: def.id });
93
95
  triggers.push({ id, definition: rendered });