evolcore 0.0.49 → 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 (514) hide show
  1. package/CHANGELOG.md +103 -3
  2. package/bin/ec-build.mjs +60 -0
  3. package/bin/ecmsg.js +64 -57
  4. package/dist/ability/caller/authorization.js +21 -0
  5. package/dist/ability/caller/command.js +173 -0
  6. package/dist/ability/caller/contract.js +117 -0
  7. package/dist/ability/caller/credential-files.js +132 -0
  8. package/dist/ability/caller/daemon.js +183 -0
  9. package/dist/ability/caller/schema-view.js +157 -0
  10. package/dist/ability/caller/service.js +519 -0
  11. package/dist/ability/command-contract.js +5 -0
  12. package/dist/ability/daemon.js +5 -1
  13. package/dist/ability/interop-v1.js +156 -106
  14. package/dist/ability/management.js +1 -0
  15. package/dist/agent-template/jobs.js +79 -3
  16. package/dist/agent-template/runtime.js +459 -47
  17. package/dist/agent-template/service.js +1242 -198
  18. package/dist/agent-template/share.js +103 -0
  19. package/dist/agent-template/tool-runner.js +25 -0
  20. package/dist/agent-template/types.js +10 -2
  21. package/dist/agents/claude/availability.js +94 -0
  22. package/dist/agents/claude/capability-provider.js +154 -0
  23. package/dist/agents/claude/index.js +145 -0
  24. package/dist/agents/{claude-runner.js → claude/runner.js} +78 -166
  25. package/dist/agents/claude/session-file-adapter.js +246 -0
  26. package/dist/agents/codex/app-server-client.js +90 -10
  27. package/dist/agents/codex/availability.js +164 -0
  28. package/dist/agents/codex/capability-provider.js +138 -0
  29. package/dist/agents/codex/cli.js +38 -0
  30. package/dist/agents/codex/index.js +345 -0
  31. package/dist/agents/codex/mcp-elicitation.js +135 -0
  32. package/dist/agents/{codex-runner.js → codex/runner.js} +652 -383
  33. package/dist/agents/codex/session-file-adapter.js +834 -0
  34. package/dist/agents/dsh/availability.js +28 -0
  35. package/dist/agents/dsh/capability-provider.js +56 -0
  36. package/dist/agents/dsh/desktop-locations.ps1 +66 -0
  37. package/dist/agents/dsh/desktop-probe.cjs +37 -0
  38. package/dist/agents/dsh/index.js +98 -0
  39. package/dist/agents/dsh/installation.js +400 -0
  40. package/dist/agents/dsh/resources.js +755 -0
  41. package/dist/agents/dsh/runner.js +1183 -0
  42. package/dist/agents/dsh/runtime/README.md +243 -0
  43. package/dist/agents/dsh/runtime/authorization.js +23 -0
  44. package/dist/agents/dsh/runtime/bridge.js +837 -0
  45. package/dist/agents/dsh/runtime/config.js +271 -0
  46. package/dist/agents/dsh/runtime/entry.js +229 -0
  47. package/dist/agents/dsh/runtime/session-inspector.js +340 -0
  48. package/dist/agents/dsh/runtime/tool-policy.js +49 -0
  49. package/dist/agents/dsh/session-file-adapter.js +145 -0
  50. package/dist/agents/ecagent/index.js +215 -0
  51. package/dist/agents/{ecagent-runner.js → ecagent/runner.js} +592 -106
  52. package/dist/agents/ecagent/session-file-adapter.js +134 -0
  53. package/dist/agents/gemini/index.js +96 -0
  54. package/dist/agents/{gemini-runner.js → gemini/runner.js} +18 -23
  55. package/dist/{core/session/adapters/gemini-session-file-adapter.js → agents/gemini/session-file-adapter.js} +2 -2
  56. package/dist/aun/ability-device-routing.js +11 -17
  57. package/dist/aun/aid/agentmd.js +27 -1
  58. package/dist/aun/aid/control-aid.js +52 -32
  59. package/dist/aun/aid/managed-operation.js +6 -4
  60. package/dist/aun/group/invite-service.js +7 -37
  61. package/dist/aun/group/operations.js +6 -0
  62. package/dist/aun/menu/client.js +1 -1
  63. package/dist/aun/msg/history.js +1 -1
  64. package/dist/aun/msg/managed-operation.js +93 -21
  65. package/dist/aun/msg/mention-schema.js +1 -1
  66. package/dist/aun/msg/p2p.js +32 -4
  67. package/dist/aun/msg/upload.js +126 -3
  68. package/dist/aun/service-proxy.js +1 -1
  69. package/dist/aun/storage/index.js +242 -0
  70. package/dist/build-identity.json +1 -1
  71. package/dist/channels/aun.js +698 -213
  72. package/dist/channels/daemon.js +3 -2
  73. package/dist/channels/dingtalk.js +1 -1
  74. package/dist/channels/feishu.js +9 -9
  75. package/dist/channels/qqbot.js +1 -1
  76. package/dist/channels/wechat.js +2 -2
  77. package/dist/channels/wecom.js +1 -1
  78. package/dist/claude-gateway/agent-registration.js +389 -0
  79. package/dist/claude-gateway/binding.js +96 -0
  80. package/dist/claude-gateway/inbox.js +138 -0
  81. package/dist/claude-gateway/index.js +125 -0
  82. package/dist/claude-gateway/listing.js +330 -0
  83. package/dist/claude-gateway/router.js +328 -0
  84. package/dist/claude-gateway/sessions.js +128 -0
  85. package/dist/claude-gateway/terminal.js +250 -0
  86. package/dist/claude-gateway/transcript.js +272 -0
  87. package/dist/claude-gateway/types.js +14 -0
  88. package/dist/cli/ability-command.js +45 -0
  89. package/dist/cli/ability-output.js +182 -0
  90. package/dist/cli/agent-command.js +21 -2
  91. package/dist/cli/agent-create.js +197 -56
  92. package/dist/cli/agent-template.js +400 -27
  93. package/dist/cli/agent.js +105 -11
  94. package/dist/cli/aun-commands.js +237 -123
  95. package/dist/cli/bench.js +5 -2
  96. package/dist/cli/config.js +22 -6
  97. package/dist/cli/daemon-commands.js +283 -109
  98. package/dist/cli/data-command.js +1 -1
  99. package/dist/cli/debug-mode.js +9 -0
  100. package/dist/cli/directory.js +1 -2
  101. package/dist/cli/ecmsg-gateway.js +64 -26
  102. package/dist/cli/fs-command.js +67 -39
  103. package/dist/cli/index.js +45 -12
  104. package/dist/cli/init.js +161 -90
  105. package/dist/cli/managed-command-guard.js +3 -0
  106. package/dist/cli/menu-client.js +32 -7
  107. package/dist/cli/model.js +1 -1
  108. package/dist/cli/pay-command.js +30 -0
  109. package/dist/cli/provider-command.js +6 -2
  110. package/dist/cli/restart-monitor.js +4 -4
  111. package/dist/cli/services-command.js +35 -10
  112. package/dist/cli/skill-command.js +4 -4
  113. package/dist/cli/task-context.js +24 -14
  114. package/dist/cli/team-workspace-command.js +50 -52
  115. package/dist/cli/thread-command.js +81 -14
  116. package/dist/cli/trigger-command.js +47 -12
  117. package/dist/cli/watch-logs.js +2 -1
  118. package/dist/config/access-policy.js +16 -3
  119. package/dist/config/boot-log.js +3 -0
  120. package/dist/config/builtin-role-templates.js +1 -1
  121. package/dist/config/config-field-policy.js +26 -13
  122. package/dist/config/config-manager.js +113 -52
  123. package/dist/config/config-operation-service.js +22 -1
  124. package/dist/config/gateway-config.js +29 -44
  125. package/dist/config/invoke-ipc-service.js +1 -1
  126. package/dist/config/owner-config.js +5 -19
  127. package/dist/config/peer-book-store.js +2 -3
  128. package/dist/config/peer-book.js +2 -2
  129. package/dist/config/peer-role-resolver.js +3 -9
  130. package/dist/config/provider-identity-migration.js +24 -105
  131. package/dist/config/provider-ipc-service.js +13 -3
  132. package/dist/config/provider-local-sync.js +4 -1
  133. package/dist/config/provider-menu-request.js +21 -3
  134. package/dist/config/provider-templates.js +1 -1
  135. package/dist/config/providers-config.js +138 -31
  136. package/dist/config/providers-import.js +3 -3
  137. package/dist/config/providers-management.js +109 -118
  138. package/dist/config/resolved-config-op.js +1 -42
  139. package/dist/config/schema-migration.js +254 -15
  140. package/dist/config/schema-registry.js +53 -8
  141. package/dist/config-store.js +1343 -63
  142. package/dist/core/{agent-application-service.js → agent/agent-application-service.js} +228 -9
  143. package/dist/core/{agent-create-status.js → agent/agent-create-status.js} +112 -4
  144. package/dist/core/{agent-creation-claim.js → agent/agent-creation-claim.js} +3 -3
  145. package/dist/core/{agent-ipc-registration.js → agent/agent-ipc-registration.js} +119 -25
  146. package/dist/core/{agent-reload-coordinator.js → agent/agent-reload-coordinator.js} +65 -0
  147. package/dist/core/{agent-runtime.js → agent/agent-runtime.js} +249 -79
  148. package/dist/core/{evolagent-registry.js → agent/evolagent-registry.js} +23 -18
  149. package/dist/core/{evolagent.js → agent/evolagent.js} +11 -11
  150. package/dist/core/auth/agent-delegation.js +15 -8
  151. package/dist/core/auth/delegation-authorization.js +28 -0
  152. package/dist/core/auth/operation-authorizer.js +20 -2
  153. package/dist/core/auth/operation-catalog.js +80 -8
  154. package/dist/core/baseagent/baseagent-availability.js +197 -0
  155. package/dist/core/baseagent/baseagent-capability-adapter.js +288 -0
  156. package/dist/core/baseagent/baseagent-config-shared.js +56 -0
  157. package/dist/core/baseagent/baseagent-identity.js +68 -0
  158. package/dist/core/{baseagent-loader.js → baseagent/baseagent-loader.js} +89 -6
  159. package/dist/core/baseagent/baseagent-model-defaults.js +26 -0
  160. package/dist/core/baseagent/baseagent-plugin-descriptor.js +357 -0
  161. package/dist/core/baseagent/baseagent-plugin-loader.js +367 -0
  162. package/dist/core/baseagent/baseagent.js +157 -0
  163. package/dist/{agents → core/baseagent}/runner-types.js +36 -4
  164. package/dist/core/capability/capability-manager.js +91 -33
  165. package/dist/core/capability/providers/claude-capability-provider.js +2 -154
  166. package/dist/core/capability/providers/codex-capability-provider.js +2 -136
  167. package/dist/core/{channel-loader.js → channel/channel-loader.js} +226 -38
  168. package/dist/core/{channel-runtime.js → channel/channel-runtime.js} +21 -19
  169. package/dist/core/command/agent-control.js +80 -17
  170. package/dist/core/command/agent-template-menu.js +23 -10
  171. package/dist/core/command/agentmd-menu-request.js +19 -8
  172. package/dist/core/command/agentmd-menu.js +14 -5
  173. package/dist/core/command/cli-intent-parser.js +15 -0
  174. package/dist/core/command/command-handler.js +127 -57
  175. package/dist/core/command/context-policy-menu.js +122 -0
  176. package/dist/core/command/data-root-resolver.js +157 -20
  177. package/dist/core/command/memory-slash.js +6 -6
  178. package/dist/core/command/menu-catalog.js +95 -19
  179. package/dist/core/command/menu-file-path.js +70 -0
  180. package/dist/core/command/menu-handler.js +392 -93
  181. package/dist/core/command/menu-protocol.js +47 -8
  182. package/dist/core/command/menu-query-batch.js +9 -5
  183. package/dist/core/command/private-mention-menu.js +71 -0
  184. package/dist/core/command/provider-menu.js +7 -11
  185. package/dist/core/command/role-menu.js +1 -1
  186. package/dist/core/command/skill-slash.js +17 -5
  187. package/dist/core/command/slash-gate.js +2 -4
  188. package/dist/core/command/slash-handler.js +143 -121
  189. package/dist/core/command/team-workspace-bootstrap.js +2 -1
  190. package/dist/core/command/team-workspace-team.js +3 -3
  191. package/dist/core/command/topic-slash.js +16 -10
  192. package/dist/core/{daemon-bootstrap.js → daemon/daemon-bootstrap.js} +14 -18
  193. package/dist/core/{daemon-control.js → daemon/daemon-control.js} +48 -21
  194. package/dist/core/{daemon-lifecycle.js → daemon/daemon-lifecycle.js} +28 -20
  195. package/dist/core/{host-snapshot.js → daemon/host-snapshot.js} +10 -5
  196. package/dist/core/{ipc-registration.js → daemon/ipc-registration.js} +101 -37
  197. package/dist/core/{lifecycle-notice.js → daemon/lifecycle-notice.js} +4 -5
  198. package/dist/core/file-integrity/store.js +1 -1
  199. package/dist/core/handoff/ipc-registration.js +3 -3
  200. package/dist/core/handoff/runtime.js +2 -2
  201. package/dist/{agents → core/inference}/request-identity.js +2 -2
  202. package/dist/core/inference/text-inference.js +4 -4
  203. package/dist/core/{bootstrap-messages.js → initialization/bootstrap-messages.js} +10 -10
  204. package/dist/core/{bootstrap-service.js → initialization/bootstrap-service.js} +24 -23
  205. package/dist/core/initialization/service.js +57 -9
  206. package/dist/core/invoke/executors/media.js +1 -1
  207. package/dist/core/invoke/executors/text.js +1 -1
  208. package/dist/core/memory/consolidation-context.js +3 -2
  209. package/dist/core/memory/consolidation-trigger.js +9 -3
  210. package/dist/core/memory/consolidation.js +39 -68
  211. package/dist/core/memory/memory-admin.js +6 -6
  212. package/dist/core/memory/memory-writer.js +1 -1
  213. package/dist/core/memory/relation-idle-monitor.js +1 -1
  214. package/dist/core/message/aun-ipc-sender.js +204 -88
  215. package/dist/core/message/aun-request-registry.js +44 -5
  216. package/dist/core/message/auto-mention-gate.js +1 -1
  217. package/dist/core/message/contact-admission.js +1 -1
  218. package/dist/core/message/im-renderer.js +19 -0
  219. package/dist/core/{interaction-router.js → message/interaction-router.js} +131 -1
  220. package/dist/core/message/items-formatter.js +5 -5
  221. package/dist/core/message/message-admission.js +1 -1
  222. package/dist/core/message/message-bridge.js +239 -59
  223. package/dist/core/message/message-log.js +8 -0
  224. package/dist/core/message/message-queue.js +88 -7
  225. package/dist/core/message/message-utils.js +1 -1
  226. package/dist/core/message/peer-mode.js +16 -5
  227. package/dist/core/message/response-engine.js +351 -152
  228. package/dist/core/message/send-options.js +44 -7
  229. package/dist/core/message/send-routing.js +55 -115
  230. package/dist/core/message/stream-idle-monitor.js +1 -1
  231. package/dist/core/{data-migration.js → migration/data-migration.js} +29 -1
  232. package/dist/core/model/catalog-service.js +29 -8
  233. package/dist/core/model/model-capabilities.js +88 -0
  234. package/dist/core/model/model-catalog.js +18 -7
  235. package/dist/core/model/model-diagnostics.js +4 -4
  236. package/dist/core/ownership/owner-resolver.js +107 -101
  237. package/dist/core/{pack-auth.js → pack/pack-auth.js} +34 -3
  238. package/dist/core/{pack-install.js → pack/pack-install.js} +95 -17
  239. package/dist/core/permission/approval-gateway.js +9 -18
  240. package/dist/core/permission/ec-command-parser.js +242 -82
  241. package/dist/core/permission/managed-file.js +234 -0
  242. package/dist/core/permission/protected-paths.js +120 -9
  243. package/dist/core/permission/sandbox-runtime.js +267 -3
  244. package/dist/core/permission/services-path-acl.js +9 -2
  245. package/dist/core/permission/session-path-grants.js +1 -1
  246. package/dist/core/permission/shell-environment.js +15 -1
  247. package/dist/core/permission/tool-policy.js +21 -9
  248. package/dist/core/plugin/plugin-lifecycle.js +442 -0
  249. package/dist/core/session/adapters/claude-session-file-adapter.js +2 -242
  250. package/dist/core/session/adapters/codex-session-file-adapter.js +2 -562
  251. package/dist/core/session/adapters/ecagent-session-file-adapter.js +2 -134
  252. package/dist/core/{background-session → session/background}/session-cleanup.js +2 -2
  253. package/dist/core/{background-session → session/background}/types.js +1 -1
  254. package/dist/core/session/session-file-health.js +2 -272
  255. package/dist/core/session/session-idle-monitor.js +1 -1
  256. package/dist/core/session/session-manager.js +76 -12
  257. package/dist/core/session/session-mapper.js +16 -0
  258. package/dist/core/session/session-terminal.js +185 -0
  259. package/dist/core/session/session-title.js +8 -11
  260. package/dist/core/{system-session → session/system}/memory.js +43 -9
  261. package/dist/core/{system-session → session/system}/registry.js +1 -1
  262. package/dist/core/{system-session → session/system}/types.js +1 -1
  263. package/dist/core/skill/index-generator.js +3 -3
  264. package/dist/core/skill/switch-resolver.js +3 -0
  265. package/dist/core/task/task-activity-store.js +112 -0
  266. package/dist/core/task/task-recovery-service.js +2 -2
  267. package/dist/core/thread/command-parser.js +4 -1
  268. package/dist/core/thread/ipc-operation.js +6 -4
  269. package/dist/core/thread/thread-operation.js +27 -11
  270. package/dist/core/thread/thread-route.js +5 -3
  271. package/dist/core/thread/thread-service.js +307 -58
  272. package/dist/core/thread/topic-id.js +52 -2
  273. package/dist/core/thread/types.js +15 -1
  274. package/dist/directory/{owner-directory-admission.js → admission.js} +3 -3
  275. package/dist/directory/{owner-directory-cache.js → cache.js} +90 -8
  276. package/dist/directory/{owner-directory-markdown.js → markdown.js} +2 -2
  277. package/dist/directory/{owner-directory-query-operation.js → query-operation.js} +83 -9
  278. package/dist/directory/{owner-directory-search.js → search.js} +50 -2
  279. package/dist/directory/{owner-directory-store.js → store.js} +2 -2
  280. package/dist/eck/kit-renderer.js +3 -2
  281. package/dist/eck/manifest-engine.js +64 -2
  282. package/dist/eck/message-renderer.js +35 -0
  283. package/dist/ecweb/basic-settings-service.js +12 -10
  284. package/dist/{contracts → ecweb/contracts}/ecweb-service-protocol.js +2 -1
  285. package/dist/ecweb/dsh-native-service.js +413 -0
  286. package/dist/ecweb/providers-service.js +5 -3
  287. package/dist/ecweb/runtime/lifecycle.js +1 -1
  288. package/dist/ecweb/runtime/supervisor.js +1 -1
  289. package/dist/event-center/center-config.js +2 -2
  290. package/dist/event-center/dispatcher.js +1 -1
  291. package/dist/event-center/ipc-operation.js +12 -3
  292. package/dist/event-center/pack-loader.js +2 -2
  293. package/dist/event-center/registry.js +6 -6
  294. package/dist/event-center/runtime.js +2 -2
  295. package/dist/index.js +181 -77
  296. package/dist/ipc.js +161 -12
  297. package/dist/outputs/authorization.js +27 -0
  298. package/dist/outputs/events.js +10 -1
  299. package/dist/outputs/panel-cards.js +960 -0
  300. package/dist/paths.js +60 -1
  301. package/dist/pay/command.js +38 -0
  302. package/dist/pay/protocol.js +136 -0
  303. package/dist/pay/runtime.js +196 -0
  304. package/dist/pay/service.js +384 -0
  305. package/dist/pay/store.js +81 -0
  306. package/dist/response-system/engines/v1/proactive-flow.js +30 -3
  307. package/dist/services/dispatcher.js +25 -7
  308. package/dist/services/host/main.js +397 -0
  309. package/dist/services/host/protocol.js +125 -0
  310. package/dist/services/host/resident.js +347 -0
  311. package/dist/services/host-client.js +398 -0
  312. package/dist/services/host-deploy.js +180 -0
  313. package/dist/services/host-launch.js +117 -0
  314. package/dist/services/host-recycle.js +208 -0
  315. package/dist/services/host-runtime.js +841 -0
  316. package/dist/services/idempotency.js +44 -86
  317. package/dist/services/index-generator.js +4 -3
  318. package/dist/services/index.js +258 -36
  319. package/dist/services/ipc-operation.js +503 -78
  320. package/dist/services/pack-manager.js +2 -2
  321. package/dist/services/router.js +43 -3
  322. package/dist/services/script-runner.js +541 -100
  323. package/dist/services/service-payload.js +28 -1
  324. package/dist/services/validation.js +136 -5
  325. package/dist/stats/context-usage.js +110 -0
  326. package/dist/stats/model-resolver.js +103 -17
  327. package/dist/stats/query.js +5 -0
  328. package/dist/trigger/application-service.js +9 -6
  329. package/dist/trigger/authorization.js +36 -33
  330. package/dist/trigger/ipc-service.js +4 -4
  331. package/dist/trigger/local-files.js +8 -166
  332. package/dist/trigger/manager.js +2 -2
  333. package/dist/trigger/parser.js +48 -0
  334. package/dist/trigger/scheduler.js +35 -13
  335. package/dist/trigger/script-executor.js +21 -0
  336. package/dist/trigger/script-sandbox.js +77 -232
  337. package/dist/trigger/system-definitions.js +25 -0
  338. package/dist/trigger/validation.js +1 -1
  339. package/dist/utils/aid-bind.js +3 -0
  340. package/dist/utils/atomic-write.js +88 -1
  341. package/dist/utils/cross-platform.js +4 -42
  342. package/dist/utils/error-dict.json +22 -1
  343. package/dist/utils/error-utils.js +193 -6
  344. package/dist/utils/evolcore-version.js +2 -2
  345. package/dist/utils/host-info.js +74 -1
  346. package/dist/utils/logger.js +5 -3
  347. package/dist/utils/media-cache.js +284 -42
  348. package/dist/utils/restart-safety.js +14 -1
  349. package/dist/utils/startup-trace.js +20 -4
  350. package/dist/utils/system-memory.js +113 -25
  351. package/dist/utils/systemd-lifecycle.js +154 -0
  352. package/dist/utils/welcome.js +64 -20
  353. package/dist/utils/windows-shell-trust.js +7 -3
  354. package/ecagent/README.md +35 -0
  355. package/ecagent/dist/agent-loop.js +80 -30
  356. package/ecagent/dist/harness/env/nodejs.d.ts +16 -0
  357. package/ecagent/dist/harness/env/nodejs.js +49 -20
  358. package/ecagent/dist/harness/messages.js +3 -2
  359. package/ecagent/dist/harness/types.d.ts +1 -0
  360. package/ecagent/dist/runtime/types.d.ts +2 -0
  361. package/ecagent/dist/runtime/utils/validation.d.ts +7 -1
  362. package/ecagent/dist/runtime/utils/validation.js +42 -0
  363. package/ecagent/dist/types.d.ts +2 -0
  364. package/kits/docs/INDEX.md +3 -2
  365. package/kits/docs/aun/AUN/346/266/210/346/201/257/347/261/273/345/236/213/344/270/216/345/261/236/346/200/247.md +1 -0
  366. package/kits/docs/channels/aun.md +1 -1
  367. package/kits/docs/channels/feishu.md +1 -1
  368. package/kits/docs/evolcore/INDEX.md +13 -9
  369. package/kits/docs/evolcore/agent-create.md +2 -0
  370. package/kits/docs/evolcore/agent.md +133 -11
  371. package/kits/docs/evolcore/aid.md +39 -6
  372. package/kits/docs/evolcore/config.md +95 -1
  373. package/kits/docs/evolcore/ctl.md +2 -1
  374. package/kits/docs/evolcore/ec-capabilities.md +7 -10
  375. package/kits/docs/evolcore/ecweb-lifecycle.md +5 -1
  376. package/kits/docs/evolcore/event.md +1 -1
  377. package/kits/docs/evolcore/fs.md +49 -3
  378. package/kits/docs/evolcore/group.md +5 -4
  379. package/kits/docs/evolcore/memory-consolidation.md +1 -1
  380. package/kits/docs/evolcore/memory-tags.md +2 -0
  381. package/kits/docs/evolcore/menu-client.md +3 -3
  382. package/kits/docs/evolcore/menu-protocol.md +31 -2
  383. package/kits/docs/evolcore/model.md +12 -1
  384. package/kits/docs/evolcore/msg.md +96 -36
  385. package/kits/docs/evolcore/pay.md +22 -0
  386. package/kits/docs/evolcore/plugin.md +74 -0
  387. package/kits/docs/evolcore/provider.md +29 -2
  388. package/kits/docs/evolcore/rpc.md +2 -2
  389. package/kits/docs/evolcore/services.md +46 -18
  390. package/kits/docs/evolcore/skill.md +17 -1
  391. package/kits/docs/evolcore/stats.md +5 -0
  392. package/kits/docs/evolcore/storage.md +22 -0
  393. package/kits/docs/evolcore/thread-chain.md +20 -9
  394. package/kits/docs/evolcore/tool-authorization.md +14 -0
  395. package/kits/docs/evolcore/trigger.md +89 -13
  396. package/kits/docs/identity/AID_PROFILE_SPEC.md +1 -1
  397. package/kits/docs/venues/feishu-group.md +3 -2
  398. package/kits/docs/venues/feishu-private.md +3 -2
  399. package/kits/rules/01-overview.md +11 -32
  400. package/kits/rules/02-navigation.md +20 -6
  401. package/kits/rules/06-channel.md +20 -4
  402. package/kits/schemas/_meta.json +42 -5
  403. package/kits/schemas/agent-config.schema.21.json +974 -0
  404. package/kits/schemas/agent-config.schema.22.json +977 -0
  405. package/kits/schemas/agent-config.schema.23.json +974 -0
  406. package/kits/schemas/agent-config.schema.24.json +986 -0
  407. package/kits/schemas/agent-config.schema.25.json +986 -0
  408. package/kits/schemas/daemon.schema.10.json +373 -0
  409. package/kits/schemas/daemon.schema.11.json +487 -0
  410. package/kits/schemas/daemon.schema.12.json +505 -0
  411. package/kits/schemas/daemon.schema.9.json +12 -0
  412. package/kits/schemas/defaults.schema.7.json +472 -0
  413. package/kits/schemas/defaults.schema.8.json +484 -0
  414. package/kits/schemas/providers.schema.1.json +1 -1
  415. package/kits/schemas/providers.schema.2.json +1 -1
  416. package/kits/schemas/providers.schema.3.json +26 -4
  417. package/kits/schemas/relation-config.schema.13.json +289 -0
  418. package/kits/skills/.switches.json +17 -1
  419. package/kits/skills/ability/SKILL.md +395 -33
  420. package/kits/skills/ability/STRUCTURE.md +338 -0
  421. package/kits/skills/ability/references/cli.md +208 -0
  422. package/kits/skills/ability/references/development.md +107 -37
  423. package/kits/skills/ability/references/management.md +106 -46
  424. package/kits/skills/ability/references/runtime-protocol.md +65 -63
  425. package/kits/skills/agent-output-cards/SKILL.md +80 -37
  426. package/kits/skills/agent-output-cards/examples/html-surface.json +11 -0
  427. package/kits/skills/agent-output-cards/examples/meeting-followups.json +16 -0
  428. package/kits/skills/agent-output-cards/examples/meeting-latest.json +24 -0
  429. package/kits/skills/agent-output-cards/examples/project-metrics.json +16 -0
  430. package/kits/skills/agent-output-cards/examples/quick-links.json +18 -0
  431. package/kits/skills/agent-output-cards/examples/surface.html +8 -0
  432. package/kits/skills/agent-template-project/SKILL.md +51 -0
  433. package/kits/skills/agent-template-project/references/01-collect-and-pack.md +174 -0
  434. package/kits/skills/agent-template-project/references/02-upload-and-share.md +109 -0
  435. package/kits/skills/agent-template-project/references/03-download-and-install.md +189 -0
  436. package/kits/skills/agent-template-project/references/04-upgrade-and-recovery.md +74 -0
  437. package/kits/skills/agent-template-project/references/05-publish-to-platform.md +62 -0
  438. package/kits/skills/ec-group/SKILL.md +8 -6
  439. package/kits/skills/ec-group/TASK.md +186 -0
  440. package/kits/skills/ec-group/WORKLOG.md +180 -0
  441. package/kits/skills/ec-group-collaboration/SKILL.md +5 -5
  442. package/kits/skills/ec-identity/SKILL.md +9 -6
  443. package/kits/skills/ec-pay/SKILL.md +223 -0
  444. package/kits/skills/ec-provider/SKILL.md +6 -6
  445. package/kits/skills/{ec-service-proxy → ec-proxy}/SKILL.md +8 -5
  446. package/kits/skills/ec-service-call/SKILL.md +138 -0
  447. package/kits/skills/ec-service-pack/SKILL.md +277 -0
  448. package/kits/skills/ec-skill/SKILL.md +25 -9
  449. package/kits/skills/ec-skill/scripts/cli.mjs +7 -7
  450. package/kits/skills/ec-skill/scripts/skill.mjs +55 -41
  451. package/kits/skills/ec-skill/scripts/template/SKILL.md.tmpl +9 -0
  452. package/kits/skills/ec-trigger/SKILL.md +3 -3
  453. package/kits/skills/personal-assistant/SKILL.md +22 -22
  454. package/kits/skills/personal-assistant/references/03-data-flow-and-gaps.md +1 -1
  455. package/kits/skills/scrapling-article-fetch/SKILL.md +5 -5
  456. package/kits/skills/thread-ops/SKILL.md +19 -9
  457. package/kits/skills/wechat-article-media-download/SKILL.md +2 -2
  458. package/kits/skills/wechat-article-reader/SKILL.md +2 -2
  459. package/kits/templates/memory-consolidation/notes.md +2 -2
  460. package/kits/templates/memory-consolidation/workflow.md +46 -0
  461. package/kits/templates/system-fragments/channel.md +13 -4
  462. package/kits/templates/system-fragments/commands.md +5 -4
  463. package/kits/templates/system-fragments/personal-assistant.md +2 -2
  464. package/kits/templates/system-fragments/reply.md +15 -9
  465. package/kits/templates/system-fragments/session.md +2 -2
  466. package/kits/templates/system-fragments/thread.md +30 -127
  467. package/kits/templates/system-fragments/venue.md +16 -0
  468. package/package.json +7 -7
  469. package/scripts/agent-template/index.mjs +7 -1
  470. package/scripts/agent-template/inspect.mjs +99 -39
  471. package/scripts/agent-template/overlay.mjs +126 -2
  472. package/scripts/agent-template/shared/common.mjs +49 -5
  473. package/scripts/agent-template/shared/plan.mjs +4 -2
  474. package/scripts/agent-template/shared/service-packs.mjs +104 -0
  475. package/scripts/agent-template/shared/team-schema.json +468 -39
  476. package/scripts/agent-template/shared/template-contract.mjs +93 -51
  477. package/scripts/agent-template/shared/template-package.mjs +225 -44
  478. package/scripts/agent-template/shared/template-runtime.mjs +137 -15
  479. package/scripts/agent-template/shared/template.mjs +31 -8
  480. package/scripts/agent-template/team-pack.mjs +528 -56
  481. package/scripts/agent-template/team-preview.mjs +102 -9
  482. package/scripts/aid-batch/identity-batch.mjs +1 -1
  483. package/dist/agents/baseagent-availability.js +0 -152
  484. package/dist/agents/baseagent.js +0 -750
  485. package/dist/agents/codex/catalog.js +0 -80
  486. package/dist/agents/ecagent-plugin-lazy.js +0 -41
  487. package/dist/agents/tool-time-context.js +0 -55
  488. package/dist/core/legacy-rename.js +0 -41
  489. package/dist/core/plugin-lifecycle.js +0 -137
  490. package/dist/core/rate-window.js +0 -53
  491. package/dist/core/runner-reload-transaction.js +0 -60
  492. package/dist/core/runtime-lock.js +0 -90
  493. package/dist/core/soul.js +0 -66
  494. package/dist/core/system-session/grants.js +0 -40
  495. package/dist/directory/owner-directory-agentmd-sync.js +0 -89
  496. package/dist/directory/owner-directory-request-operation.js +0 -79
  497. package/dist/directory/owner-directory-text.js +0 -60
  498. package/kits/docs/aun/ABILITY_CALLING.md +0 -280
  499. package/kits/docs/evolcore/ability.md +0 -185
  500. package/kits/skills/ability/references/calling.md +0 -56
  501. package/kits/skills/ability/references/contract-checklist.md +0 -37
  502. package/kits/skills/ability/references/recovery.md +0 -27
  503. /package/dist/{core/capability/providers/gemini-capability-provider.js → agents/gemini/capability-provider.js} +0 -0
  504. /package/dist/core/{system-channels.js → channel/system-channels.js} +0 -0
  505. /package/dist/core/{daemon-file-cache.js → daemon/daemon-file-cache.js} +0 -0
  506. /package/dist/core/{event-bus.js → event/event-bus.js} +0 -0
  507. /package/dist/core/{event-catalog.js → event/event-catalog.js} +0 -0
  508. /package/dist/core/{pack-ledger.js → pack/pack-ledger.js} +0 -0
  509. /package/dist/directory/{owner-directory-identity.js → identity.js} +0 -0
  510. /package/dist/directory/{owner-directory-policy.js → policy.js} +0 -0
  511. /package/dist/directory/{owner-directory-remarks.js → remarks.js} +0 -0
  512. /package/dist/directory/{owner-directory-scope.js → scope.js} +0 -0
  513. /package/dist/{contracts → ecweb/contracts}/ecweb-instance.js +0 -0
  514. /package/kits/templates/{bootstrap-welcome.md → bootstrap-intro.md} +0 -0
@@ -1,15 +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
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';
13
13
 
14
14
  export async function inspectAgent(options) {
15
15
  const config = options.effectiveConfig ?? readJson(path.join(options.agentDir, 'config.json'));
@@ -27,8 +27,10 @@ export async function inspectAgent(options) {
27
27
  activeBaseagent: config.active_baseagent,
28
28
  baseagents: BASEAGENTS.filter(name => config.baseagents?.[name]).map(name => ({ name, currentModel: config.baseagents[name].model ?? null,
29
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 })),
30
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 ?? [],
31
- project: { path: project, files: fs.existsSync(project) ? fs.readdirSync(project).filter(f => !excluded(f)).sort() : [] } };
32
+ project: { path: project, files: options.listProjectFiles !== false && fs.existsSync(project)
33
+ ? fs.readdirSync(project).filter(f => !excluded(f)).sort() : [] } };
32
34
  }
33
35
 
34
36
  export async function inspectPackage(options) {
@@ -65,40 +67,49 @@ export async function inspectPackage(options) {
65
67
  'INVALID_ARGUMENT', 'Matching template metadata and unique member keys required');
66
68
  const schemaErrors = validateAgainstSchema(tpl.team, tpl.schema);
67
69
  assert(!schemaErrors.length, 'INVALID_ARGUMENT', schemaErrors.join('; '));
70
+ const allKeys = tpl.actualKeys;
68
71
  // Check the complete package before selecting member resources. No member may hide unsupported files.
69
72
  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 + '/')
73
+ || file.startsWith('.evolcore/skills/') || allKeys.some(key => file.startsWith('workspace/' + key + '/')
71
74
  || file.startsWith('agents/' + key + '/personal/soul/') && file.endsWith('.md') && !file.endsWith('/00-GUIDE.md')
72
75
  || file === 'agents/' + key + '/personal/welcome.md' || file.startsWith('agents/' + key + '/triggers/')
73
- || 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)))),
74
77
  'INVALID_ARGUMENT', 'Unsupported template resource: ' + file);
78
+ assert(!options.sourceMemberKey || allKeys.includes(options.sourceMemberKey), 'INTEGRITY_FAILED', 'Original source member is absent');
79
+ const keys = options.sourceMemberKey ? [options.sourceMemberKey] : allKeys;
75
80
  const platforms = tpl.team.host.platform;
76
81
  if (platforms !== undefined) assert(Array.isArray(platforms) && platforms.length
77
- && platforms.every(p => ['linux', 'darwin', 'win32'].includes(p)) && platforms.includes(process.platform),
78
- 'INCOMPATIBLE', 'Template host.platform must support this host');
82
+ && platforms.every(p => ['linux', 'darwin', 'win32'].includes(p)),
83
+ 'INCOMPATIBLE', 'Invalid template host.platform');
79
84
  if (!options.targets) {
80
- assert(tpl.keys.length === 1, 'INVALID_ARGUMENT', 'Provide targets mapping for every template member');
81
- return inspectMember(options, { pkg, tpl, templateDir, files, key: tpl.keys[0] });
85
+ assert(keys.length === 1, 'INVALID_ARGUMENT', 'Provide targets mapping for every template member');
86
+ return inspectMember(options, { pkg, tpl, templateDir, files, key: keys[0] });
82
87
  }
83
- assert(isRecord(options.targets) && tpl.keys.length === Object.keys(options.targets).length
84
- && tpl.keys.every(key => Object.hasOwn(options.targets, key)), 'INVALID_ARGUMENT', 'Map every template member exactly once');
85
- const contexts = tpl.keys.map(key => options.targets[key]);
88
+ assert(isRecord(options.targets) && keys.length === Object.keys(options.targets).length
89
+ && keys.every(key => Object.hasOwn(options.targets, key)), 'INVALID_ARGUMENT', 'Map every template member exactly once');
90
+ const contexts = keys.map(key => options.targets[key]);
86
91
  assert(contexts.every(c => isRecord(c) && typeof c.targetAid === 'string' && c.home === contexts[0].home)
87
92
  && new Set(contexts.map(c => c.targetAid)).size === contexts.length,
88
93
  'INVALID_ARGUMENT', 'Members must map to distinct Agents on the same host');
89
- assert(Object.keys(options.members ?? {}).every(key => tpl.keys.includes(key)), 'INVALID_ARGUMENT', 'Unknown member selection');
90
- const writes = new Map(); const members = []; const plans = [];
91
- const memberVars = teamMemberVariables(Object.fromEntries(tpl.keys.map(key => [key,
92
- { aid: options.targets[key].targetAid, projectPath: options.targets[key].projectPath ?? options.targets[key].targetConfig?.projects?.defaultPath }])),
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 = []; const skillSnapshots = {};
96
+ const memberVars = teamMemberVariables({ ...Object.fromEntries(keys.map(key => [key,
97
+ { aid: options.targets[key].targetAid, projectPath: options.targets[key].projectPath ?? options.targets[key].targetConfig?.projects?.defaultPath }])) },
93
98
  contexts[0].ownerAid, contexts[0].hostAid);
94
- for (const key of tpl.keys) {
99
+ for (const key of keys) {
95
100
  const selection = options.members?.[key] ?? {};
96
101
  const out = inside(options.out ?? path.dirname(root), 'members/' + key);
97
102
  const data = await inspectMember({ ...options.targets[key], out, packageRoot: options.packageRoot, digest: options.digest,
98
- pullId: options.pullId, planMode: options.planMode, memberVars: memberVars[key], selections: selection.providers ?? {}, externalAids: selection.externalAids ?? {} },
99
- { pkg, tpl, templateDir, key, files: files.filter(f => !f.startsWith('agents/') && !f.startsWith('workspace/')
103
+ pullId: options.pullId, planMode: options.planMode, singleMember: !!options.sourceMemberKey, affectedAids: options.affectedAids,
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/')
100
107
  || f.startsWith('agents/' + key + '/') || f.startsWith('workspace/' + key + '/')) });
101
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
+ }
102
113
  for (const write of plan.writes) {
103
114
  const previous = writes.get(write.path);
104
115
  assert(!previous || JSON.stringify(previous) === JSON.stringify(write), 'CONFLICT', 'Members write different shared content: ' + write.path);
@@ -107,11 +118,12 @@ export async function inspectPackage(options) {
107
118
  const { planFile: _planFile, ...preview } = data;
108
119
  members.push({ key, targetAid: plan.targetAid, ...preview });
109
120
  plans.push({ key, targetAid: plan.targetAid, projectPath: plan.projectPath, profile: plan.profile,
110
- originalProfile: plan.originalProfile, profileVersion: plan.profileVersion, providers: plan.providers });
121
+ originalProfile: plan.originalProfile, profileVersion: plan.profileVersion, providers: plan.providers,
122
+ managedConfig: plan.managedConfig, managedSkills: plan.managedSkills });
111
123
  }
112
124
  const planFile = path.join(options.out ?? path.dirname(root), 'plan.json');
113
125
  atomicBytes(planFile, jsonBytes({ version: 1, home: contexts[0].home, templateDir,
114
- templateDigest: templateDigest(templateDir), package: pkg, writes: [...writes.values()], members: plans }));
126
+ templateDigest: templateDigest(templateDir), package: pkg, writes: [...writes.values()], members: plans, skillSnapshots }));
115
127
  return { pullId: options.pullId, template: members[0].template, compatible: true, incompatible: [],
116
128
  members, externalAids: pkg.externalAids ?? [], planFile };
117
129
  }
@@ -132,10 +144,10 @@ async function inspectMember(options, { pkg, tpl, templateDir, files, key }) {
132
144
  || file.startsWith('.evolcore/skills/') || file.startsWith('workspace/' + key + '/')
133
145
  || file.startsWith('agents/' + key + '/personal/soul/') && file.endsWith('.md') && !file.endsWith('/00-GUIDE.md')
134
146
  || file === 'agents/' + key + '/personal/welcome.md' || file.startsWith('agents/' + key + '/triggers/')
135
- || 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))),
136
148
  'INVALID_ARGUMENT', 'Unsupported template resource: ' + file);
137
149
  assert(isRecord(spec.config) && !MANAGED_AGENT_FIELDS.some(f => f in spec.config)
138
- && Object.keys(spec.config).every(f => ['chatmode', 'memory', 'active_baseagent', 'baseagents', 'version', 'update'].includes(f)),
150
+ && Object.keys(spec.config).every(f => ['chatmode', 'memory', 'access', 'active_baseagent', 'baseagents', 'version', 'update'].includes(f)),
139
151
  'INVALID_ARGUMENT', 'Unsupported template configuration');
140
152
  const packageRoot = options.packageRoot ?? path.resolve(path.dirname(fileURLToPath(import.meta.url)), '../..');
141
153
  const temp = process.env.TMPDIR;
@@ -146,13 +158,13 @@ async function inspectMember(options, { pkg, tpl, templateDir, files, key }) {
146
158
  finally { /* Modules remain loaded; scratch is cleaned after validation below. */ }
147
159
  try {
148
160
  const { default: semver } = await import('semver');
149
- assert(Array.isArray(pkg.compat?.platforms) && pkg.compat.platforms.includes(process.platform)
161
+ assert(Array.isArray(pkg.compat?.platforms)
150
162
  && semver.validRange(pkg.compat.evolcore)
151
163
  && (semver.satisfies(ec.version, pkg.compat.evolcore, { includePrerelease: true })
152
164
  || !pkg.compat.templateFeatures?.length && semver.satisfies(ec.version.replace(/-test\.\d+$/, ''), pkg.compat.evolcore, { includePrerelease: true }))
153
165
  && (pkg.compat.templateFeatures === undefined || Array.isArray(pkg.compat.templateFeatures)
154
- && pkg.compat.templateFeatures.every(feature => ['member-references-v1', 'event-packs-v1'].includes(feature))),
155
- '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'] });
156
168
  const selections = options.selections ?? {};
157
169
  for (const [name, block] of Object.entries(spec.config.baseagents ?? {})) {
158
170
  assert(BASEAGENTS.includes(name) && isRecord(block) && Object.keys(block).every(f => ['provider', 'model', 'effort', 'params'].includes(f)),
@@ -169,7 +181,14 @@ async function inspectMember(options, { pkg, tpl, templateDir, files, key }) {
169
181
  for (const field of ['version', 'update']) if (Object.hasOwn(parameters, field)) {
170
182
  config[field] = structuredClone(parameters[field]);
171
183
  }
172
- 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
+ }
173
192
  const configErrors = ec.validate('Agent', config);
174
193
  assert(!configErrors.length, 'INVALID_ARGUMENT', configErrors.join('; '));
175
194
  const agentDir = path.join(options.home, 'agents', options.targetAid);
@@ -181,29 +200,46 @@ async function inspectMember(options, { pkg, tpl, templateDir, files, key }) {
181
200
  publisherAid: pkg.publisher?.aid, digest: options.digest, installedAt: Date.now() }));
182
201
  const render = (bytes, relative = '') => renderResource(bytes, vars, options.externalAids ?? {}, { json: relative.endsWith('.json') });
183
202
  const preview = { profile: { fields: PROFILE_FIELDS.filter(f => spec.profile?.[f] !== undefined), preserve: ['aid', 'type', 'owner'] },
184
- 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 },
185
204
  project: { path: project, changeDefault: false }, config: Object.keys(resolved) };
186
- const skillMapping = {};
187
- const localNames = [...new Set(files.filter(f => f.startsWith('.evolcore/skills/')).map(f => f.split('/')[2]))];
205
+ const skillMapping = {}; const skillSnapshots = {};
206
+ const localNames = [...new Set(files.filter(f => f.startsWith('.evolcore/skills/')).map(f => f.split('/')[2]))]
207
+ .filter(name => Object.hasOwn(spec.skills ?? {}, name));
208
+ assert(Object.keys(options.skillResolutions ?? {}).every(name => localNames.includes(name)), 'INVALID_ARGUMENT', 'Unknown skill resolution');
188
209
  for (const name of localNames) {
189
210
  const source = inside(path.join(templateDir, '.evolcore', 'skills'), name);
190
- const hash = createHash('sha256');
191
- for (const p of walkFiles(source)) hash.update(p).update('\0').update(render(fs.readFileSync(inside(source, p)), p)).update('\0');
192
- const desiredDigest = hash.digest('hex').slice(0, 12);
211
+ const desiredDigest = resourceDigest(source, render);
193
212
  let destName = name;
194
213
  const original = inside(path.join(options.home, 'skills'), name);
195
- if (fs.existsSync(original) && templateDigest(original) !== desiredDigest) destName += '--' + pkg.id;
214
+ if (!options.singleMember && fs.existsSync(original) && resourceDigest(original) !== desiredDigest) destName += '--' + pkg.id;
196
215
  const dest = inside(path.join(options.home, 'skills'), destName);
197
- if (fs.existsSync(dest)) assert(templateDigest(dest) === desiredDigest, 'CONFLICT', 'Skill name conflicts: ' + destName);
216
+ const currentDigest = fs.existsSync(dest) ? resourceDigest(dest) : null;
217
+ skillSnapshots[dest] = currentDigest;
198
218
  skillMapping[name] = destName;
199
- 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
+ }
200
236
  for (const p of walkFiles(source)) add(inside(dest, p), render(fs.readFileSync(inside(source, p)), p),
201
237
  fs.statSync(inside(source, p)).mode & 0o111 ? 0o755 : 0o644);
202
238
  }
203
239
  const switchesFile = path.join(agentDir, 'skills', '.switches.json');
204
240
  const switches = fs.existsSync(switchesFile) ? readJson(switchesFile) : {};
205
241
  for (const [name, value] of Object.entries(spec.skills ?? {})) switches[skillMapping[name] ?? name] = { enabled: value.enabled === true };
206
- add(switchesFile, jsonBytes(switches));
242
+ if (Object.keys(spec.skills ?? {}).length) add(switchesFile, jsonBytes(switches));
207
243
  const eventPacks = readEventPacks(path.join(templateDir, 'agents', key, 'events'), { template: true });
208
244
  for (const pack of eventPacks) {
209
245
  const dir = inside(path.join(agentDir, 'events'), pack.id);
@@ -231,9 +267,30 @@ async function inspectMember(options, { pkg, tpl, templateDir, files, key }) {
231
267
  add(center, jsonBytes({ v: 1, enabled: true, authMode: 'allowlist',
232
268
  admission: { coupling: 'on', rematerializeMs: 300_000 }, rules: {}, rateLimit: { perMinute: 60, perHour: 600 } }));
233
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
+ }
234
291
  const failures = []; const allowedTriggerFiles = new Set();
235
292
  const triggers = buildAgentTriggers({ templateRoot: templateDir, key, aid: options.targetAid, vars, ec,
236
- 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))); } } });
237
294
  assert(!failures.length, 'INVALID_ARGUMENT', failures.join('; '));
238
295
  const triggerNames = new Set();
239
296
  for (const { id, definition } of triggers) {
@@ -271,7 +328,9 @@ async function inspectMember(options, { pkg, tpl, templateDir, files, key }) {
271
328
  }
272
329
  }
273
330
  const plan = { version: 1, targetAid: options.targetAid, home: options.home, projectPath: project,
274
- templateDir, templateDigest: templateDigest(templateDir), package: pkg, writes,
331
+ templateDir, templateDigest: templateDigest(templateDir), package: pkg, writes, skillSnapshots,
332
+ managedConfig: { ...resolveProviderRefs(resolved), ...parameters },
333
+ managedSkills: Object.fromEntries(Object.entries(spec.skills ?? {}).map(([name, value]) => [skillMapping[name] ?? name, { enabled: value.enabled === true }])),
275
334
  profile: spec.profile,
276
335
  originalProfile: options.profile, profileVersion: options.profileVersion, providers: refs };
277
336
  const planFile = path.join(options.out ?? path.dirname(root), 'plan.json');
@@ -280,6 +339,7 @@ async function inspectMember(options, { pkg, tpl, templateDir, files, key }) {
280
339
  compatible: true, incompatible: [], currentConfig: { baseagents: Object.entries((options.effectiveConfig ?? targets).baseagents ?? {}).map(([name, b]) => ({ name, ...b })),
281
340
  soul: fs.existsSync(path.join(agentDir, 'personal', 'soul')) ? fs.readdirSync(path.join(agentDir, 'personal', 'soul')) : [],
282
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),
283
343
  events: eventPacks.filter(pack => fs.existsSync(path.join(agentDir, 'events', pack.id, 'pack.json'))).map(pack => pack.id) },
284
344
  providers: refs, preview, externalAids: pkg.externalAids ?? [], planFile };
285
345
  } finally { fs.rmSync(scratch, { recursive: true, force: true }); }
@@ -1,17 +1,107 @@
1
1
  import fs from 'node:fs';
2
2
  import path from 'node:path';
3
- import { assert, snapshot, equalSnapshot, readJson, jsonBytes, atomicBytes, regularPath } 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
+ }
17
+ for (const [file, expected] of Object.entries(plan.observed ?? {})) {
18
+ assert(equalSnapshot(snapshot(file), expected), 'CONFLICT', 'Observed target changed: ' + file);
19
+ }
8
20
  for (const write of plan.writes) assert(equalSnapshot(snapshot(write.path), write.expected), 'CONFLICT', 'Target changed: ' + write.path);
9
21
  }
10
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
+
11
93
  export function restore(backupDir) {
12
94
  const file = path.join(backupDir, 'journal.json');
13
95
  const journal = readJson(file);
14
96
  assert(journal.version === 1 && Array.isArray(journal.entries), 'INSTALL_BROKEN', 'Invalid restore journal');
97
+ for (const entry of journal.entries) {
98
+ if (!Object.hasOwn(entry, 'desired')) continue; // Legacy journals retain their original recovery behavior.
99
+ const current = snapshot(entry.path);
100
+ const original = entry.existed ? { sha256: sha256(fs.readFileSync(path.join(backupDir, entry.backup))), mode: entry.mode } : null;
101
+ assert(equalSnapshot(current, original) || equalSnapshot(current, entry.desired)
102
+ || entry.intermediate?.some(value => equalSnapshot(current, value)),
103
+ 'INSTALL_BROKEN', 'Independent change prevents safe restore: ' + entry.path);
104
+ }
15
105
  for (const entry of [...journal.entries].reverse()) {
16
106
  regularPath(entry.path);
17
107
  if (entry.existed) atomicBytes(entry.path, fs.readFileSync(path.join(backupDir, entry.backup)), entry.mode);
@@ -27,8 +117,41 @@ export function restore(backupDir) {
27
117
  export async function overlay(options) {
28
118
  if (options.operation === 'restore') return restore(options.backupDir);
29
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);
144
+ if (options.operation === 'verify-applied') {
145
+ for (const write of plan.writes) {
146
+ const expected = desiredSnapshot(write);
147
+ assert(equalSnapshot(snapshot(write.path), expected), 'INTEGRITY_FAILED', 'Applied resource differs: ' + write.path);
148
+ }
149
+ return { verified: true };
150
+ }
30
151
  verifyPlan(plan);
31
152
  if (options.operation === 'verify') return { valid: true };
153
+ stageInstallation(plan);
154
+ if (options.planFile) atomicBytes(options.planFile, jsonBytes(plan), 0o600);
32
155
  const backupDir = options.backupDir;
33
156
  const file = path.join(backupDir, 'journal.json');
34
157
  const journal = { version: 1, targetAid: plan.targetAid,
@@ -42,7 +165,8 @@ export async function overlay(options) {
42
165
  for (const [i, write] of plan.writes.entries()) {
43
166
  regularPath(write.path);
44
167
  const existing = snapshot(write.path);
45
- const entry = { path: write.path, existed: existing !== null, mode: existing?.mode ?? write.mode, backup: i + '.bin' };
168
+ const entry = { path: write.path, existed: existing !== null, mode: existing?.mode ?? write.mode, backup: i + '.bin',
169
+ desired: desiredSnapshot(write) };
46
170
  if (existing) atomicBytes(path.join(backupDir, entry.backup), fs.readFileSync(write.path), 0o600);
47
171
  journal.entries.push(entry);
48
172
  let dir = path.dirname(write.path); const missing = [];
@@ -48,22 +48,40 @@ export function regularPath(target) {
48
48
  }
49
49
  }
50
50
 
51
- export function walkFiles(root, exclude = () => false, { maxTotalBytes = LIMITS.total, onOversizedFile } = {}) {
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 = [];
55
55
  let total = 0;
56
56
  let count = 0;
57
57
  const visit = (dir) => {
58
- for (const e of fs.readdirSync(dir, { withFileTypes: true }).sort((a, b) => a.name.localeCompare(b.name))) {
58
+ let entries;
59
+ try { regularPath(dir); entries = fs.readdirSync(dir, { withFileTypes: true }); }
60
+ catch (error) {
61
+ if (!onMissingFile || !['ENOENT', 'ENOTDIR'].includes(error.code)) throw error;
62
+ onMissingFile(posix(path.relative(root, dir))); return;
63
+ }
64
+ for (const e of entries.sort((a, b) => a.name.localeCompare(b.name))) {
59
65
  const file = path.join(dir, e.name);
60
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
+ }
61
73
  assert(!e.isSymbolicLink() && (e.isFile() || e.isDirectory()), 'INVALID_ARGUMENT', 'Only regular files/directories: ' + file);
62
- 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 });
63
75
  if (e.isDirectory()) visit(file);
64
76
  else {
65
77
  count++;
66
- const stat = fs.statSync(file);
78
+ let stat;
79
+ try { stat = fs.lstatSync(file); }
80
+ catch (error) {
81
+ if (!onMissingFile || !['ENOENT', 'ENOTDIR'].includes(error.code)) throw error;
82
+ onMissingFile(posix(path.relative(root, file))); continue;
83
+ }
84
+ assert(stat.isFile(), 'INVALID_ARGUMENT', 'Only regular files: ' + file);
67
85
  if (stat.size > LIMITS.file && onOversizedFile) {
68
86
  onOversizedFile({ path: posix(path.relative(root, file)), size: stat.size, limit: LIMITS.file });
69
87
  continue;
@@ -78,6 +96,15 @@ export function walkFiles(root, exclude = () => false, { maxTotalBytes = LIMITS.
78
96
  return files.sort();
79
97
  }
80
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
+
81
108
  export function atomicBytes(file, bytes, mode = 0o644) {
82
109
  assert(isProcessRunning(parentPid), 'TASK_INTERRUPTED', 'Template coordinator exited');
83
110
  regularPath(file);
@@ -100,7 +127,24 @@ export function snapshot(file) {
100
127
  } catch (error) { if (error.code === 'ENOENT') return null; throw error; }
101
128
  }
102
129
 
103
- 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
+ }
104
148
 
105
149
  export function mergeObjects(existing, overlay) {
106
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 });