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,34 +1,26 @@
1
1
  import fs from 'node:fs';
2
2
  import path from 'node:path';
3
3
  import { inspectAgent } from './inspect.mjs';
4
- import { assert, isRecord, inside, walkFiles, jsonBytes, sha256, atomicBytes, regularPath,
4
+ import { assert, isRecord, inside, walkFiles, jsonBytes, sha256, atomicBytes, regularPath, LIMITS,
5
5
  readJson, behaviorConfig, BASEAGENTS, PROFILE_FIELDS } from './shared/common.mjs';
6
6
  import { loadTemplate } from './shared/template.mjs';
7
- import { normalizeTeam, readTeamSchema } from './shared/template-contract.mjs';
8
- import { collectTemplateDirectory, buildTemplatePackage, excludedResource as excluded, readEventPacks } from './shared/template-package.mjs';
9
- import { resolveMemberParameters } from './shared/template-runtime.mjs';
7
+ import { normalizeTeam, readTeamSchema, contractDigest, selectionIndexSchema, validateContractSchema, SELECTION_INDEX_LIMITS, TEMPLATE_MODULES } from './shared/template-contract.mjs';
8
+ import { collectTemplateDirectory, buildTemplatePackage, inspectTemplatePackage, excludedResource as excluded, readEventPacks } from './shared/template-package.mjs';
9
+ import { resolveMemberParameters, partitionTeamMembers, MEMBER_KEY, renderValue, teamMemberVariables } from './shared/template-runtime.mjs';
10
+ import { readServicePacks } from './shared/service-packs.mjs';
11
+ import { normalizeTriggerDefinition, assertExplicitAunDeliveryRoutes } from '../../dist/trigger/validation.js';
10
12
 
11
13
  function entries(options) {
12
14
  assert(isRecord(options.members) && Object.keys(options.members).length, 'INVALID_ARGUMENT', 'Members required');
13
15
  const entries = Object.entries(options.members).sort(([a], [b]) => a.localeCompare(b));
14
- assert(entries.every(([key]) => /^[a-z0-9][a-z0-9_-]{0,31}$/.test(key)), 'INVALID_ARGUMENT', 'Invalid member key');
16
+ assert(entries.every(([key]) => MEMBER_KEY.test(key)), 'INVALID_ARGUMENT', 'Invalid member key');
15
17
  const aids = entries.filter(([, source]) => source.kind !== 'directory').map(([, source]) => source.agentAid);
16
18
  assert(new Set(aids).size === aids.length, 'INVALID_ARGUMENT', 'Agent sources must be distinct');
17
19
  return entries;
18
20
  }
19
21
  const runtimeNames = new Set(['AIDs', 'agents', 'data', 'logs', 'backups', 'eck', 'directory', 'sessions']);
20
- function projectFiles(source, warnings = []) {
21
- // Inventory describes choices, not the eventual package. Use the same filter
22
- // for its content snapshot; skipped files must never be read or selectable.
23
- return walkFiles(source.projectPath, relative => excluded(relative)
24
- || source.projectPath === source.home && runtimeNames.has(relative.split('/')[0]), {
25
- maxTotalBytes: Infinity,
26
- onOversizedFile: file => warnings.push({ code: 'FILE_TOO_LARGE', ...file,
27
- message: 'Skipped oversized project file: ' + file.path + ' (' + file.size + ' bytes; limit ' + file.limit + ' bytes)' }),
28
- });
29
- }
30
22
  function directory(source, key) {
31
- const { tpl, errors } = loadTemplate(source.path);
23
+ const { tpl, errors } = loadTemplate(source.path, { includeWorkspace: false });
32
24
  assert(!errors.length && tpl.team.agents.some(member => member.key === key), 'INVALID_ARGUMENT', errors.join('; ') || 'Directory member missing');
33
25
  return { tpl, member: tpl.team.agents.find(member => member.key === key) };
34
26
  }
@@ -39,7 +31,7 @@ function sourceSnapshot(selected) {
39
31
  regularPath(file); values.push([key, file, sha256(fs.readFileSync(file)), fs.statSync(file).mode & 0o777]);
40
32
  };
41
33
  if (source.kind === 'directory') {
42
- for (const relative of walkFiles(source.path)) add(inside(source.path, relative));
34
+ for (const relative of walkFiles(source.path, relative => relative === 'workspace')) add(inside(source.path, relative));
43
35
  } else {
44
36
  values.push([key, source.profile, source.profileVersion, source.effectiveConfig, source.skills]);
45
37
  add(path.join(source.agentDir, 'config.json'));
@@ -50,11 +42,13 @@ function sourceSnapshot(selected) {
50
42
  for (const pack of readEventPacks(path.join(source.agentDir, 'events'))) {
51
43
  for (const relative of pack.files) add(inside(pack.dir, relative));
52
44
  }
45
+ for (const pack of readServicePacks(path.join(source.agentDir, 'services'))) {
46
+ for (const relative of pack.files) add(inside(pack.dir, relative));
47
+ }
53
48
  for (const skill of source.skills ?? []) if (skill.type === 'local' && skill.enabled) {
54
49
  const root = inside(path.join(source.home, 'skills'), skill.name);
55
50
  for (const relative of walkFiles(root)) add(inside(root, relative));
56
51
  }
57
- for (const relative of projectFiles(source)) add(inside(source.projectPath, relative));
58
52
  }
59
53
  }
60
54
  return sha256(jsonBytes(values));
@@ -69,23 +63,115 @@ export async function inspectCollection(options) {
69
63
  members[key] = { ...resolveMemberParameters(member), profile: member.profile, resources: { baseagents: Object.keys(member.config.baseagents),
70
64
  triggers: walkFiles(path.join(source.path, 'agents', key, 'triggers')).filter(file => file.endsWith('/trigger.json')).map(file => file.split('/')[0]),
71
65
  events: readEventPacks(path.join(source.path, 'agents', key, 'events'), { template: true }).map(pack => pack.id),
72
- skills: Object.keys(member.skills ?? {}), files: fs.existsSync(path.join(source.path, 'workspace', key))
73
- ? fs.readdirSync(path.join(source.path, 'workspace', key)).sort() : [] },
66
+ services: readServicePacks(path.join(source.path, 'agents', key, 'services')).map(pack => pack.id),
67
+ skills: Object.keys(member.skills ?? {}) },
74
68
  defaultBaseagent: member.config.active_baseagent, platforms: platform, warnings: [] };
75
69
  platforms = platforms.filter(platformName => platform.includes(platformName));
76
70
  } else {
77
- const data = await inspectAgent(source);
71
+ const data = await inspectAgent({ ...source, listProjectFiles: false });
78
72
  const warnings = [];
79
73
  members[key] = { ...resolveMemberParameters({ key, config: source.effectiveConfig }), profile: source.profile, resources: { baseagents: data.baseagents.map(item => item.name),
80
74
  triggers: data.triggers.map(item => item.id), skills: data.skills.filter(item => item.type === 'local' && item.enabled).map(item => item.name),
81
- events: data.events.map(pack => pack.id),
82
- files: projectFiles(source, warnings) },
75
+ events: data.events.map(pack => pack.id), services: data.services.map(pack => pack.id) },
83
76
  defaultBaseagent: data.activeBaseagent, platforms: [process.platform], warnings };
84
77
  platforms = platforms.filter(platform => platform === process.platform);
85
78
  }
79
+ members[key].projectFiles = { ...(source.agentAid ? { sourceAid: source.agentAid } : {}), root: '.',
80
+ projectRevision: projectRevision(source, key) };
86
81
  }
87
82
  assert(snapshot === sourceSnapshot(selected), 'SOURCE_CHANGED', 'Source changed while generating inventory');
88
- return { inventoryDigest: 'sha256:' + sha256(jsonBytes({ snapshot, members, platforms })), members, platforms };
83
+ const data = { sourceDigest: 'sha256:' + snapshot, members, platforms };
84
+ return { inventoryDigest: 'sha256:' + sha256(jsonBytes(data)), ...data };
85
+ }
86
+
87
+ export function projectRevision(source, key) {
88
+ const root = path.resolve(source.kind === 'directory' ? path.join(source.path, 'workspace', key) : source.projectPath);
89
+ regularPath(root);
90
+ const stat = fs.statSync(root, { throwIfNoEntry: false });
91
+ return contractDigest({ root, aid: source.agentAid ?? null, identity: stat ? [stat.dev, stat.ino] : null });
92
+ }
93
+ export function validateSelectionIndex({ index, inspectionJobId, inventory }) {
94
+ const errors = validateContractSchema(index, selectionIndexSchema);
95
+ assert(!errors.length, 'INVALID_ARGUMENT', 'Invalid selection index: ' + errors.join('; '));
96
+ assert(index.inspectionJobId === inspectionJobId && index.inventoryDigest === inventory.inventoryDigest,
97
+ 'CONFLICT', 'Selection index belongs to another inspection');
98
+ assert(Object.keys(index.members).sort().join() === Object.keys(inventory.members).sort().join(), 'INVALID_ARGUMENT', 'Select every inspection member');
99
+ let count = 0;
100
+ for (const [key, selection] of Object.entries(index.members)) {
101
+ assert(selection.projectRevision === inventory.members[key].projectFiles.projectRevision, 'SOURCE_CHANGED', 'Project revision differs', { memberKey: key });
102
+ count += selection.entries.length;
103
+ assert(count <= SELECTION_INDEX_LIMITS.entries, 'INVALID_ARGUMENT', 'Selection index entry limit exceeded');
104
+ const names = new Set();
105
+ for (const entry of selection.entries) {
106
+ assert(entry.path === '.' && entry.type === 'directory' || inside('/selection', entry.path), 'INVALID_ARGUMENT', 'Invalid selection path');
107
+ assert(!excluded(entry.path), 'INVALID_ARGUMENT', 'Excluded project selection');
108
+ assert(!names.has(entry.path.toLowerCase()), 'INVALID_ARGUMENT', 'Duplicate project selection');
109
+ names.add(entry.path.toLowerCase());
110
+ }
111
+ for (const entry of selection.entries) {
112
+ const parts = entry.path.split('/');
113
+ assert(entry.path === '.' || !names.has('.'), 'INVALID_ARGUMENT', 'Overlapping project selections');
114
+ for (let i = 1; i < parts.length; i++) assert(!names.has(parts.slice(0, i).join('/').toLowerCase()), 'INVALID_ARGUMENT', 'Overlapping project selections');
115
+ }
116
+ }
117
+ return index.members;
118
+ }
119
+
120
+ function collectProjectFiles(projectPath, files, put, { home, filesOnly = false, memberKey, entries } = {}) {
121
+ const stats = { selected: files.length, copied: 0, skippedMissing: 0 };
122
+ const copied = new Set();
123
+ const entryTypes = entries ? new Map(entries.map(entry => [entry.path, entry.type])) : undefined;
124
+ const missing = () => { stats.skippedMissing++; };
125
+ for (const relative of files) {
126
+ const file = relative === '.' ? projectPath : inside(projectPath, relative);
127
+ assert(!excluded(relative), 'INVALID_ARGUMENT', 'Excluded project selection: ' + relative);
128
+ regularPath(file);
129
+ let stat;
130
+ try { stat = fs.lstatSync(file); }
131
+ catch (error) {
132
+ if (!['ENOENT', 'ENOTDIR'].includes(error.code)) throw error;
133
+ missing(); continue;
134
+ }
135
+ assert(stat.isFile() || stat.isDirectory() && !filesOnly, 'INVALID_ARGUMENT', 'Project selection type changed: ' + relative);
136
+ const expected = entryTypes?.get(relative);
137
+ assert(!expected || (expected === 'file' ? stat.isFile() : stat.isDirectory()), 'INVALID_ARGUMENT', 'Project selection type changed: ' + relative);
138
+ const prefix = relative === '.' ? '' : relative + '/';
139
+ const paths = stat.isDirectory() ? walkFiles(file, p => excluded(prefix + p)
140
+ || home && path.resolve(projectPath) === path.resolve(home) && runtimeNames.has((prefix + p).split('/')[0]), {
141
+ onMissingFile: missing,
142
+ }).map(p => prefix + p) : [relative];
143
+ for (const p of paths) {
144
+ if (copied.has(p)) continue;
145
+ const source = inside(projectPath, p);
146
+ if (home) {
147
+ const homeRelative = path.relative(home, source).split(path.sep);
148
+ assert(homeRelative[0] === '..' || !runtimeNames.has(homeRelative[0]),
149
+ 'INVALID_ARGUMENT', 'Runtime data is not a project artifact');
150
+ }
151
+ regularPath(source);
152
+ let descriptor; let bytes; let mode;
153
+ try {
154
+ descriptor = fs.openSync(source, fs.constants.O_RDONLY | (fs.constants.O_NOFOLLOW ?? 0));
155
+ const current = fs.fstatSync(descriptor);
156
+ assert(current.isFile(), 'INVALID_ARGUMENT', 'Regular project file required: ' + p);
157
+ assert(current.size <= LIMITS.file, 'PACKAGE_TOO_LARGE', 'Project file exceeds size limit: ' + p);
158
+ bytes = fs.readFileSync(descriptor); mode = current.mode & 0o777;
159
+ const after = fs.fstatSync(descriptor);
160
+ assert(current.size === after.size && current.mtimeMs === after.mtimeMs && current.ctimeMs === after.ctimeMs,
161
+ 'SOURCE_CHANGED', 'Project file changed while reading: ' + p);
162
+ assert(bytes.length <= LIMITS.file, 'PACKAGE_TOO_LARGE', 'Project file exceeds size limit: ' + p);
163
+ } catch (error) {
164
+ if (!['ENOENT', 'ENOTDIR'].includes(error.code)) throw error;
165
+ missing(); continue;
166
+ } finally { if (descriptor !== undefined) fs.closeSync(descriptor); }
167
+ // Destination write failures must never be mistaken for missing sources.
168
+ put(p, bytes, mode); copied.add(p); stats.copied++;
169
+ }
170
+ }
171
+ assert(!files.length || stats.copied > 0, 'PROJECT_FILES_EMPTY',
172
+ 'All selected project files are missing or empty; select project files again or choose no project files',
173
+ { memberKey, projectFiles: stats });
174
+ return stats;
89
175
  }
90
176
  export function validateCollectionSelection({ inventory, metadata, members }) {
91
177
  assert(isRecord(members) && Object.keys(members).sort().join() === Object.keys(inventory.members).sort().join(),
@@ -95,10 +181,11 @@ export function validateCollectionSelection({ inventory, metadata, members }) {
95
181
  assert(isRecord(member) && Object.keys(member).every(field => ['include', 'version', 'update'].includes(field))
96
182
  && isRecord(member.include), 'INVALID_ARGUMENT', 'Member include required');
97
183
  resolveMemberParameters({ ...member, key });
98
- for (const field of ['baseagents', 'triggers', 'skills', 'files', 'events']) {
99
- const selected = member.include[field] ?? (field === 'events' ? [] : undefined);
184
+ assert(!Object.hasOwn(member.include, 'files'), 'INVALID_ARGUMENT', 'include.files is retired; use selectionIndex');
185
+ for (const field of ['baseagents', 'triggers', 'skills', 'events', 'services']) {
186
+ const selected = member.include[field] ?? (['events', 'services'].includes(field) ? [] : undefined);
100
187
  assert(Array.isArray(selected) && new Set(selected).size === selected.length
101
- && selected.every(value => inventory.members[key].resources[field].includes(value)), 'INVALID_ARGUMENT', 'Selection is outside frozen inventory: ' + key + '.' + field);
188
+ && selected.every(value => (inventory.members[key].resources[field] ?? []).includes(value)), 'INVALID_ARGUMENT', 'Selection is outside frozen inventory: ' + key + '.' + field);
102
189
  }
103
190
  assert(member.include.baseagents.includes(inventory.members[key].defaultBaseagent), 'INVALID_ARGUMENT', 'Include the source default baseagent');
104
191
  }
@@ -111,6 +198,7 @@ function copyDirectoryMember(root, source, key, include) {
111
198
  const wanted = relative.startsWith('agents/' + key + '/personal/')
112
199
  || include.triggers.some(id => relative.startsWith('agents/' + key + '/triggers/' + id + '/'))
113
200
  || (include.events ?? []).some(id => relative.startsWith('agents/' + key + '/events/' + id + '/'))
201
+ || (include.services ?? []).some(id => relative.startsWith('agents/' + key + '/services/' + id + '/'))
114
202
  || include.files.some(file => relative === 'workspace/' + key + '/' + file || relative.startsWith('workspace/' + key + '/' + file + '/'))
115
203
  || include.skills.some(name => relative.startsWith('.evolcore/skills/' + name + '/'));
116
204
  if (wanted) {
@@ -121,47 +209,431 @@ function copyDirectoryMember(root, source, key, include) {
121
209
  return result;
122
210
  }
123
211
  export async function buildCollection(options) {
124
- const inventory = await inspectCollection(options);
125
- assert(inventory.inventoryDigest === options.inventoryDigest, 'SOURCE_CHANGED', 'Sources changed since inspect');
212
+ const inventory = options.inventory;
213
+ assert(isRecord(inventory) && /^sha256:[a-f0-9]{64}$/.test(inventory.sourceDigest ?? ''),
214
+ 'EXPIRED', 'Original collection inventory is required; inspect again');
215
+ const { inventoryDigest, ...inventoryData } = inventory;
216
+ assert(inventoryDigest === options.inventoryDigest && inventoryDigest === 'sha256:' + sha256(jsonBytes(inventoryData)),
217
+ 'CONFLICT', 'Original inventory digest does not match');
126
218
  validateCollectionSelection({ inventory, metadata: options.metadata, members: options.selections });
127
- const selected = entries(options); const members = {};
219
+ const projectSelections = validateSelectionIndex({ index: options.selectionIndex, inspectionJobId: options.inspectionJobId, inventory });
220
+ const selected = entries(options); const members = {}; const projectFiles = {};
221
+ assert('sha256:' + sourceSnapshot(selected) === inventory.sourceDigest, 'SOURCE_CHANGED', 'Sources changed since inspect');
128
222
  assert(!fs.existsSync(options.out), 'CONFLICT', 'Build output already exists');
129
223
  fs.mkdirSync(options.out, { recursive: true });
130
224
  const teamVariables = selected.filter(([, source]) => source.kind !== 'directory')
131
225
  .flatMap(([key, source]) => [[source.agentAid, '{{members.' + key + '.aid}}'], [source.projectPath, '{{members.' + key + '.project}}']]);
132
226
  try {
133
227
  for (const [key, source] of selected) {
134
- const include = options.selections[key].include;
135
- if (source.kind === 'directory') members[key] = { ...collectTemplateDirectory(source.path, key), include };
228
+ const projectRoot = source.kind === 'directory' ? path.join(source.path, 'workspace', key) : source.projectPath;
229
+ assert(!fs.existsSync(projectRoot) || projectRevision(source, key) === inventory.members[key].projectFiles.projectRevision,
230
+ 'SOURCE_CHANGED', 'Project root changed', { memberKey: key });
231
+ const projectEntries = projectSelections[key].entries;
232
+ const include = { ...options.selections[key].include, files: projectEntries.map(entry => entry.path) };
233
+ if (source.kind === 'directory') {
234
+ const collected = collectTemplateDirectory(source.path, key, { includeWorkspace: false });
235
+ projectFiles[key] = collectProjectFiles(path.join(source.path, 'workspace', key), include.files,
236
+ (p, bytes, mode) => collected.entries.set('workspace/' + key + '/' + p, { bytes, mode }), { memberKey: key, entries: projectEntries });
237
+ members[key] = { ...collected, include: { ...include, files: [...collected.entries.keys()]
238
+ .filter(name => name.startsWith('workspace/' + key + '/')).map(name => name.slice(('workspace/' + key + '/').length)) } };
239
+ }
136
240
  else {
137
241
  const root = path.join(options.out, 'collect', key); fs.mkdirSync(root, { recursive: true });
138
- const member = await collectAgent({ ...source, include, teamVariables }, key, root);
242
+ const projectFileStats = {};
243
+ const member = await collectAgent({ ...source, include, teamVariables, projectFileStats, projectEntries }, key, root);
244
+ projectFiles[key] = projectFileStats;
139
245
  const collected = new Map(walkFiles(root).map(relative => {
140
246
  const file = inside(root, relative);
141
247
  return [relative, { bytes: fs.readFileSync(file), mode: fs.statSync(file).mode & 0o777 }];
142
248
  }));
143
249
  // File selections in the inventory are complete relative files, shared with directory collection.
144
- members[key] = { member, entries: collected, include, excluded: [] };
250
+ members[key] = { member, entries: collected, include: { ...include, files: [...collected.keys()]
251
+ .filter(name => name.startsWith('workspace/' + key + '/')).map(name => name.slice(('workspace/' + key + '/').length)) }, excluded: [] };
145
252
  }
146
253
  }
147
254
  for (const [key, collected] of Object.entries(members)) {
148
255
  Object.assign(collected.member, resolveMemberParameters({ ...options.selections[key], key }));
149
256
  }
150
- const built = buildTemplatePackage({ metadata: options.metadata, members, publisher: selected[0][1].publisher, createdAt: options.createdAt ?? Date.now() });
151
- assert((await inspectCollection(options)).inventoryDigest === inventory.inventoryDigest, 'SOURCE_CHANGED', 'Sources changed during build');
257
+ if (selected.length === 1 && selected[0][1].kind !== 'directory') {
258
+ const [alias, source] = selected[0];
259
+ const sourceConfig = source.effectiveConfig ?? readJson(path.join(source.agentDir, 'config.json'));
260
+ const key = sourceConfig.update?.key ?? source.agentAid;
261
+ assert(typeof key === 'string' && /^[a-z0-9][a-z0-9-]*(\.[a-z0-9][a-z0-9-]*){2,}$/.test(key),
262
+ 'INVALID_ARGUMENT', 'Single Agent packaging requires its original AID key');
263
+ const collected = members[alias];
264
+ const declared = options.selections[alias].version;
265
+ assert(!declared || declared === options.metadata.version, 'VERSION_CONFLICT', 'Enter one matching author version');
266
+ collected.member.version = options.metadata.version;
267
+ if (collected.member.config) delete collected.member.config.version;
268
+ const rename = text => text.replaceAll('{{members.' + alias + '.', '{{members.' + key + '.');
269
+ collected.entries = new Map([...collected.entries].map(([name, entry]) => [name.replace('agents/' + alias + '/', 'agents/' + key + '/')
270
+ .replace('workspace/' + alias + '/', 'workspace/' + key + '/'), { ...entry, bytes: !entry.bytes.includes(0)
271
+ && Buffer.from(entry.bytes.toString('utf8')).equals(entry.bytes) ? Buffer.from(rename(entry.bytes.toString('utf8'))) : entry.bytes }]));
272
+ collected.member = JSON.parse(rename(JSON.stringify(collected.member)));
273
+ delete members[alias]; members[key] = collected;
274
+ if (options.assistantKey === alias) options.assistantKey = key;
275
+ }
276
+ if (selected.length === 1 && Object.keys(members)[0].includes('.')) {
277
+ const declared = options.selections[selected[0][0]].version;
278
+ assert(!declared || declared === options.metadata.version, 'VERSION_CONFLICT', 'Enter one matching author version');
279
+ const member = Object.values(members)[0].member; member.version = options.metadata.version;
280
+ if (member.config) delete member.config.version;
281
+ }
282
+ const built = buildTemplatePackage({ metadata: options.metadata, members, publisher: selected[0][1].publisher, createdAt: options.createdAt ?? Date.now(),
283
+ memberReferences: options.memberReferences, assistantKey: options.assistantKey });
284
+ assert('sha256:' + sourceSnapshot(selected) === inventory.sourceDigest, 'SOURCE_CHANGED', 'Sources changed during build');
285
+ fs.rmSync(path.join(options.out, 'collect'), { recursive: true, force: true });
152
286
  const checked = (await import('./shared/template-package.mjs')).inspectTemplatePackage(built.bytes);
287
+ const partition = partitionTeamMembers(checked.team);
153
288
  const file = path.join(options.out, built.filename); atomicBytes(file, built.bytes, 0o600);
154
289
  fs.rmSync(path.join(options.out, 'collect'), { recursive: true, force: true });
155
- return { file, metadata: { id: checked.metadata.id, name: checked.metadata.name, version: checked.metadata.version, description: checked.metadata.description, platforms: checked.metadata.compat.platforms }, members: Object.fromEntries(checked.team.agents.map(member => [member.key, member])), digest: built.digest, size: built.bytes.length,
156
- externalAids: built.metadata.externalAids ?? [], scan: built.scan, excluded: built.excluded };
290
+ return { file, metadata: { id: checked.metadata.id, name: checked.metadata.name, version: checked.metadata.version, description: checked.metadata.description, platforms: checked.metadata.compat.platforms }, members: Object.fromEntries(partition.inlineMembers.map(member => [member.key, member])), digest: built.digest, size: built.bytes.length,
291
+ memberReferences: { external: partition.externalContacts }, assistantKey: partition.assistantKey,
292
+ resources: checked.resources, externalAids: built.metadata.externalAids ?? [], scan: built.scan, excluded: built.excluded, projectFiles };
157
293
  } catch (error) { fs.rmSync(options.out, { recursive: true, force: true }); throw error; }
158
294
  }
159
295
 
296
+
297
+ /** Module collection reads only the selected resource family, never the live runtime state. */
298
+ function moduleSource(source, key) {
299
+ if (source.kind !== 'directory') return source;
300
+ const file = inside(source.path, 'team.json'); regularPath(file);
301
+ const normalized = normalizeTeam(readJson(file));
302
+ assert(!normalized.errors.length, 'INVALID_ARGUMENT', normalized.errors.join('; '));
303
+ const member = normalized.team.agents.find(item => item.key === key);
304
+ assert(member, 'INVALID_ARGUMENT', 'Directory member missing: ' + key);
305
+ return { ...source, agentDir: path.join(source.path, 'agents', key), projectPath: path.join(source.path, 'workspace', key),
306
+ effectiveConfig: member.config, profile: member.profile, skills: Object.entries(member.skills ?? {}).map(([name, state]) =>
307
+ ({ name, type: fs.existsSync(path.join(source.path, '.evolcore', 'skills', name)) ? 'local' : 'builtin', enabled: state.enabled })),
308
+ skillRoot: path.join(source.path, '.evolcore', 'skills'), platforms: normalized.team.host.platform,
309
+ parameters: resolveMemberParameters(member) };
310
+ }
311
+ function moduleInventory(module, source, key) {
312
+ source = moduleSource(source, key);
313
+ const resources = {}; const personal = path.join(source.agentDir, 'personal');
314
+ if (module === 'config') {
315
+ const config = source.effectiveConfig ?? readJson(path.join(source.agentDir, 'config.json'));
316
+ resources.baseagents = Object.keys(config.baseagents ?? {}).filter(name => name === config.active_baseagent);
317
+ return { resources, defaultBaseagent: config.active_baseagent };
318
+ }
319
+ if (module === 'profile') return { resources: { fields: [...PROFILE_FIELDS, 'type'],
320
+ welcome: fs.existsSync(path.join(personal, 'welcome.md')) } };
321
+ if (module === 'soul') {
322
+ const root = path.join(personal, 'soul'); regularPath(root);
323
+ resources.files = fs.existsSync(root) ? fs.readdirSync(root).filter(name => name.endsWith('.md') && name !== '00-GUIDE.md').sort() : [];
324
+ } else if (module === 'skill') {
325
+ resources.skills = (source.skills ?? []).filter(item => item.type === 'local' && item.enabled).map(item => item.name).sort();
326
+ } else if (module === 'trigger') {
327
+ const root = path.join(source.agentDir, 'triggers'); regularPath(root);
328
+ resources.triggers = fs.existsSync(root) ? fs.readdirSync(root, { withFileTypes: true })
329
+ .filter(item => item.isDirectory()).map(item => item.name).sort() : [];
330
+ } else if (module === 'event' || module === 'service') {
331
+ const root = path.join(source.agentDir, module === 'event' ? 'events' : 'services'); regularPath(root);
332
+ resources[module === 'event' ? 'events' : 'services'] = fs.existsSync(root) ? fs.readdirSync(root, { withFileTypes: true })
333
+ .filter(item => item.isDirectory() && !item.name.startsWith('.') && !item.name.startsWith('_')
334
+ && !fs.existsSync(path.join(root, item.name, '.archived'))).map(item => item.name).sort() : [];
335
+ } else if (module === 'project') return { resources, projectFiles: { ...(source.agentAid ? { sourceAid: source.agentAid } : {}),
336
+ root: '.', projectRevision: projectRevision(source, key) } };
337
+ return { resources };
338
+ }
339
+ export function inspectModule(options) {
340
+ assert(TEMPLATE_MODULES.includes(options.module), 'INVALID_ARGUMENT', 'Unknown module');
341
+ options.onProgress?.('inventory');
342
+ const members = {}; let platforms = ['linux', 'darwin', 'win32'];
343
+ for (const [key, source] of entries(options)) {
344
+ members[key] = moduleInventory(options.module, source, key);
345
+ platforms = platforms.filter(platform => (moduleSource(source, key).platforms ?? [process.platform]).includes(platform));
346
+ }
347
+ const data = { module: options.module, members, platforms };
348
+ return { ...data, inventoryDigest: contractDigest(data) };
349
+ }
350
+ function stableBytes(file, limit = LIMITS.file) {
351
+ regularPath(file);
352
+ const fd = fs.openSync(file, fs.constants.O_RDONLY | (fs.constants.O_NOFOLLOW ?? 0));
353
+ try {
354
+ const before = fs.fstatSync(fd);
355
+ assert(before.isFile() && before.size <= limit, 'PACKAGE_TOO_LARGE', 'Bounded regular resource required');
356
+ const bytes = fs.readFileSync(fd); const after = fs.fstatSync(fd); const actual = fs.lstatSync(file);
357
+ assert(bytes.length <= limit && before.size === after.size && before.mtimeMs === after.mtimeMs
358
+ && before.ctimeMs === after.ctimeMs && before.ino === actual.ino && before.dev === actual.dev
359
+ && !actual.isSymbolicLink(), 'SOURCE_CHANGED', 'Resource changed while reading: ' + file);
360
+ return { bytes, mode: before.mode & 0o777 };
361
+ } finally { fs.closeSync(fd); }
362
+ }
363
+ function copyModuleTree(root, put, prefix) {
364
+ const files = walkFiles(root, excluded);
365
+ const captured = files.map(relative => [relative, stableBytes(inside(root, relative))]);
366
+ for (const [relative, entry] of captured) put(prefix + relative, entry.bytes, entry.mode);
367
+ assert(JSON.stringify(files) === JSON.stringify(walkFiles(root, excluded)), 'SOURCE_CHANGED', 'Resource file set changed');
368
+ for (const [relative, entry] of captured) assert(sha256(stableBytes(inside(root, relative)).bytes) === sha256(entry.bytes),
369
+ 'SOURCE_CHANGED', 'Resource changed during collection: ' + relative);
370
+ }
371
+ export function collectModule(options) {
372
+ const inventory = options.inventory; const module = options.module;
373
+ assert(inventory?.module === module && inventory.inventoryDigest === options.inventoryDigest, 'CONFLICT', 'Module inventory differs');
374
+ assert(Object.keys(inventory.members).sort().join() === Object.keys(options.selections).sort().join(), 'INVALID_ARGUMENT', 'Complete module selection required');
375
+ if (module === 'project') options.onProgress?.('validating_selection');
376
+ const selected = entries(options); const index = module === 'project'
377
+ ? validateSelectionIndex({ index: options.selectionIndex, inventory, inspectionJobId: options.inspectionJobId }) : undefined;
378
+ assert(!fs.existsSync(options.out), 'CONFLICT', 'Module workspace already exists');
379
+ regularPath(options.out); fs.mkdirSync(options.out, { recursive: true, mode: 0o700 });
380
+ const teamVariables = selected.filter(([, source]) => source.agentAid)
381
+ .flatMap(([key, source]) => [[source.agentAid, '{{members.' + key + '.aid}}'], [source.projectPath, '{{members.' + key + '.project}}']]);
382
+ const result = { module, platforms: inventory.platforms, members: {}, projectFiles: {} };
383
+ let copiedBytes = 0; let copiedFiles = 0;
384
+ try {
385
+ options.onProgress?.('collecting');
386
+ for (const [key, original] of selected) {
387
+ const source = { ...moduleSource(original, key), teamVariables };
388
+ const chosen = options.selections[key].include;
389
+ for (const [kind, values] of Object.entries(chosen)) assert(Array.isArray(values)
390
+ && values.every(value => inventory.members[key].resources[kind]?.includes(value)), 'INVALID_ARGUMENT', 'Selection outside module inventory');
391
+ const root = path.join(options.out, key); const filesRoot = path.join(root, 'files');
392
+ const put = (relative, bytes, mode = 0o600) => {
393
+ assert(!excluded(relative), 'INVALID_ARGUMENT', 'Excluded module resource: ' + relative);
394
+ const buffer = Buffer.from(bytes);
395
+ copiedBytes += buffer.length; copiedFiles++;
396
+ assert(buffer.length <= LIMITS.file && copiedBytes <= LIMITS.total && copiedFiles <= LIMITS.entries,
397
+ 'PACKAGE_TOO_LARGE', 'Module resources exceed package bounds');
398
+ atomicBytes(inside(filesRoot, relative), !buffer.includes(0) && Buffer.from(buffer.toString('utf8')).equals(buffer)
399
+ ? Buffer.from(identityText(buffer.toString('utf8'), source)) : buffer, mode);
400
+ };
401
+ const copy = (file, relative) => { const entry = stableBytes(file); put(relative, entry.bytes, entry.mode); };
402
+ const member = {};
403
+ if (module === 'config') {
404
+ const config = source.effectiveConfig ?? readJson(path.join(source.agentDir, 'config.json'));
405
+ assert(chosen.baseagents.includes(config.active_baseagent), 'INVALID_ARGUMENT', 'Include the default baseagent');
406
+ const portable = behaviorConfig(config); portable.active_baseagent = config.active_baseagent; portable.baseagents = {};
407
+ for (const name of [config.active_baseagent]) {
408
+ const block = config.baseagents?.[name]; assert(block, 'SOURCE_CHANGED', 'Selected baseagent removed');
409
+ const ref = block.provider;
410
+ portable.baseagents[name] = { ...structuredClone(block), ...(typeof ref === 'string'
411
+ ? { provider: { id: ref, name: source.providers?.[ref]?.name ?? ref } } : {}) };
412
+ }
413
+ Object.assign(member, source.parameters ?? resolveMemberParameters({ config }), { config: identityValue(portable, source) });
414
+ } else if (module === 'profile') {
415
+ member.profile = identityValue(Object.fromEntries([...PROFILE_FIELDS, 'type'].filter(field => source.profile?.[field] !== undefined)
416
+ .map(field => [field, source.profile[field]])), source);
417
+ if (source.profile?.avatar !== undefined) member.profile.avatar = source.profile.avatar;
418
+ const welcome = path.join(source.agentDir, 'personal', 'welcome.md');
419
+ if (fs.existsSync(welcome)) copy(welcome, 'agents/' + key + '/personal/welcome.md');
420
+ } else if (module === 'soul') {
421
+ for (const name of chosen.files) copy(inside(path.join(source.agentDir, 'personal', 'soul'), name),
422
+ 'agents/' + key + '/personal/soul/' + name);
423
+ } else if (module === 'skill') {
424
+ member.skills = {};
425
+ for (const name of chosen.skills) {
426
+ copyModuleTree(inside(source.skillRoot ?? path.join(source.home, 'skills'), name), put, '.evolcore/skills/' + name + '/');
427
+ member.skills[name] = { enabled: true };
428
+ }
429
+ } else if (module === 'trigger') {
430
+ for (const id of chosen.triggers) {
431
+ const dir = inside(path.join(source.agentDir, 'triggers'), id);
432
+ const definitionBytes = stableBytes(path.join(dir, 'trigger.json')).bytes;
433
+ const def = JSON.parse(definitionBytes.toString('utf8'));
434
+ delete def.authorizedBy; delete def.operatorPeers;
435
+ put('agents/' + key + '/triggers/' + id + '/trigger.json', jsonBytes(identityValue(def, source)));
436
+ if (def.execution?.type === 'script') copy(inside(dir, def.execution.script.path),
437
+ 'agents/' + key + '/triggers/' + id + '/' + def.execution.script.path);
438
+ assert(stableBytes(path.join(dir, 'trigger.json')).bytes.equals(definitionBytes), 'SOURCE_CHANGED', 'Trigger definition changed during collection');
439
+ }
440
+ } else if (module === 'event' || module === 'service') {
441
+ const kind = module === 'event' ? 'events' : 'services';
442
+ for (const id of chosen[kind]) {
443
+ // Inventory/validation is limited to this selected pack, not its unselected neighbours.
444
+ const parent = path.join(source.agentDir, kind);
445
+ const reader = module === 'event' ? readEventPacks : readServicePacks;
446
+ const packs = reader(parent, { ids: [id] }); const pack = packs.find(item => item.id === id);
447
+ assert(pack, 'SOURCE_CHANGED', 'Selected pack removed: ' + id);
448
+ for (const relative of pack.files) copy(inside(pack.dir, relative), 'agents/' + key + '/' + kind + '/' + id + '/' + relative);
449
+ const after = reader(parent, { ids: [id] }).find(item => item.id === id);
450
+ assert(after && JSON.stringify(after.files) === JSON.stringify(pack.files), 'SOURCE_CHANGED', 'Pack changed while collecting');
451
+ for (const relative of pack.files) {
452
+ const expected = stableBytes(inside(pack.dir, relative)).bytes;
453
+ const rendered = !expected.includes(0) && Buffer.from(expected.toString('utf8')).equals(expected)
454
+ ? Buffer.from(identityText(expected.toString('utf8'), source)) : expected;
455
+ assert(fs.readFileSync(inside(filesRoot, 'agents/' + key + '/' + kind + '/' + id + '/' + relative)).equals(rendered),
456
+ 'SOURCE_CHANGED', 'Pack content changed while collecting');
457
+ }
458
+ }
459
+ } else if (module === 'project') {
460
+ assert(projectRevision(source, key) === inventory.members[key].projectFiles.projectRevision, 'SOURCE_CHANGED', 'Default project changed');
461
+ result.projectFiles[key] = collectProjectFiles(source.projectPath, index[key].entries.map(entry => entry.path),
462
+ (relative, bytes, mode) => put('workspace/' + key + '/' + relative, bytes, mode),
463
+ { home: source.home, memberKey: key, entries: index[key].entries });
464
+ }
465
+ atomicBytes(path.join(root, 'member.json'), jsonBytes(member), 0o600);
466
+ fs.mkdirSync(filesRoot, { recursive: true });
467
+ result.members[key] = { files: walkFiles(filesRoot), memberFile: key + '/member.json' };
468
+ }
469
+ options.onProgress?.('validating');
470
+ const captured = walkFiles(options.out).map(relative => [relative, sha256(stableBytes(inside(options.out, relative)).bytes)]);
471
+ return { ...result, workspace: options.out, digest: contractDigest(captured) };
472
+ } catch (error) { fs.rmSync(options.out, { recursive: true, force: true }); throw error; }
473
+ }
474
+ function parseModuleDeclaration(bytes, relative) {
475
+ let value;
476
+ try { value = JSON.parse(bytes.toString('utf8')); }
477
+ catch { throw Object.assign(new Error('Invalid JSON in module declaration: ' + relative), {
478
+ code: 'INVALID_ARGUMENT', details: { path: relative },
479
+ }); }
480
+ assert(isRecord(value), 'INVALID_ARGUMENT', 'Module declaration must be an object: ' + relative);
481
+ return value;
482
+ }
483
+ export function packModules(options) {
484
+ options.onProgress?.('assembling');
485
+ const receipt = path.join(options.out, 'result.json');
486
+ if (fs.existsSync(receipt)) {
487
+ const result = readJson(receipt);
488
+ inspectTemplatePackage(stableBytes(result.file, LIMITS.total).bytes, { digest: result.digest });
489
+ return result;
490
+ }
491
+ const snapshotFile = path.join(options.out, 'snapshot.json');
492
+ if (fs.existsSync(snapshotFile)) {
493
+ const frozen = readJson(snapshotFile);
494
+ return sealModuleSnapshot(options, frozen);
495
+ }
496
+ const members = {}; const snapshots = []; const globalFiles = new Map(); let totalBytes = 0;
497
+ const validationTargets = Object.fromEntries(Object.keys(options.members).map((key, index) => [key,
498
+ { aid: 'template-member-' + index + '.agentid.cn', projectPath: path.join(options.out, 'validation', key) }]));
499
+ const validationVars = teamMemberVariables(validationTargets, options.publisher?.aid ?? 'owner.agentid.cn', 'host.agentid.cn');
500
+ for (const [key, collections] of Object.entries(options.members)) {
501
+ const assembled = { member: { profile: {}, config: {}, skills: {} }, entries: new Map(),
502
+ include: { baseagents: [], skills: [], triggers: [], events: [], services: [], files: [] }, excluded: [] };
503
+ const singleton = new Set();
504
+ for (const collection of collections) {
505
+ assert(collection.platforms.some(platform => options.metadata.platforms.includes(platform))
506
+ && options.metadata.platforms.every(platform => collection.platforms.includes(platform)), 'INCOMPATIBLE', 'Module platform mismatch');
507
+ if (['config', 'profile'].includes(collection.module)) {
508
+ assert(!singleton.has(collection.module), 'CONFLICT', 'Duplicate singleton module'); singleton.add(collection.module);
509
+ }
510
+ const root = path.join(collection.workspace, collection.memberKey);
511
+ const data = stableBytes(path.join(root, 'member.json')); snapshots.push([path.join(root, 'member.json'), data]);
512
+ const member = parseModuleDeclaration(data.bytes, key + '/member.json');
513
+ const allowed = collection.module === 'config' ? ['config', 'version', 'update'] : collection.module === 'profile' ? ['profile']
514
+ : collection.module === 'skill' ? ['skills'] : [];
515
+ assert(isRecord(member) && Object.keys(member).every(field => allowed.includes(field)),
516
+ 'INVALID_ARGUMENT', 'Module contains foreign or invalid declaration');
517
+ for (const [field, value] of Object.entries(member)) {
518
+ if (['config', 'profile', 'skills'].includes(field)) assert(isRecord(value), 'INVALID_ARGUMENT', 'Module declaration must be an object: ' + field);
519
+ if (field === 'skills') {
520
+ for (const [name, state] of Object.entries(value)) {
521
+ assert(/^[a-z0-9][a-z0-9_-]{0,63}$/.test(name) && !['constructor', 'prototype', '__proto__'].includes(name),
522
+ 'INVALID_ARGUMENT', 'Invalid skill name');
523
+ const previous = assembled.member.skills[name];
524
+ assert(previous === undefined || JSON.stringify(previous) === JSON.stringify(state), 'CONFLICT', 'Skill declarations conflict');
525
+ assembled.member.skills[name] = state;
526
+ }
527
+ } else assembled.member[field] = value;
528
+ }
529
+ const filesRoot = path.join(root, 'files'); const paths = walkFiles(filesRoot);
530
+ const prefixes = { profile: 'agents/' + key + '/personal/welcome.md', soul: 'agents/' + key + '/personal/soul/',
531
+ skill: '.evolcore/skills/', trigger: 'agents/' + key + '/triggers/', event: 'agents/' + key + '/events/',
532
+ service: 'agents/' + key + '/services/', project: 'workspace/' + key + '/' };
533
+ for (const relative of paths) {
534
+ assert(!excluded(relative) && (collection.module === 'profile' ? relative === prefixes.profile
535
+ : prefixes[collection.module] && relative.startsWith(prefixes[collection.module])), 'INVALID_ARGUMENT', 'File outside module boundary: ' + relative);
536
+ if (collection.module === 'soul') assert(relative.endsWith('.md') && !relative.endsWith('/00-GUIDE.md'), 'INVALID_ARGUMENT', 'Invalid soul file');
537
+ const entry = stableBytes(inside(filesRoot, relative)); const previous = assembled.entries.get(relative);
538
+ if (!globalFiles.has(relative)) {
539
+ totalBytes += entry.bytes.length; globalFiles.set(relative, true);
540
+ assert(totalBytes <= LIMITS.total && globalFiles.size <= LIMITS.entries, 'PACKAGE_TOO_LARGE', 'Combined module resources exceed package bounds');
541
+ }
542
+ assert(!previous || previous.bytes.equals(entry.bytes) && previous.mode === entry.mode, 'CONFLICT', 'Conflicting module path: ' + relative);
543
+ assembled.entries.set(relative, entry); snapshots.push([inside(filesRoot, relative), entry]);
544
+ }
545
+ snapshots.push([filesRoot, paths]);
546
+ }
547
+ assert(singleton.has('config') && singleton.has('profile'), 'INVALID_ARGUMENT', 'Each installed member requires config and profile modules');
548
+ assembled.include.baseagents = Object.keys(assembled.member.config.baseagents ?? {});
549
+ assembled.include.skills = Object.keys(assembled.member.skills);
550
+ for (const relative of assembled.entries.keys()) {
551
+ if (relative.startsWith('workspace/' + key + '/')) assembled.include.files.push(relative.slice(('workspace/' + key + '/').length));
552
+ for (const kind of ['triggers', 'events', 'services']) if (relative.startsWith('agents/' + key + '/' + kind + '/')) {
553
+ const id = relative.split('/')[3]; if (!assembled.include[kind].includes(id)) assembled.include[kind].push(id);
554
+ }
555
+ }
556
+ assert(Object.keys(assembled.member.config).every(field => ['chatmode', 'memory', 'access', 'active_baseagent', 'baseagents'].includes(field)),
557
+ 'INVALID_ARGUMENT', 'Runtime or unmanaged configuration cannot enter a module');
558
+ delete assembled.member.config.access;
559
+ for (const block of Object.values(assembled.member.config.baseagents ?? {})) {
560
+ assert(isRecord(block) && Object.keys(block).every(field => ['provider', 'model', 'effort', 'params'].includes(field)),
561
+ 'INVALID_ARGUMENT', 'Unsupported baseagent configuration');
562
+ }
563
+ assert(Object.keys(assembled.member.profile).every(field => [...PROFILE_FIELDS, 'type'].includes(field)),
564
+ 'INVALID_ARGUMENT', 'Unsupported profile field');
565
+ for (const id of assembled.include.triggers) {
566
+ const prefix = 'agents/' + key + '/triggers/' + id + '/';
567
+ const definition = assembled.entries.get(prefix + 'trigger.json');
568
+ assert(definition, 'INVALID_ARGUMENT', 'Trigger definition missing: ' + id);
569
+ const def = parseModuleDeclaration(definition.bytes, prefix + 'trigger.json');
570
+ assert(def.id === id && !Object.hasOwn(def, 'authorizedBy') && !Object.hasOwn(def, 'operatorPeers'),
571
+ 'INVALID_ARGUMENT', 'Invalid portable Trigger declaration');
572
+ try {
573
+ const normalized = normalizeTriggerDefinition(renderValue(def, { ...validationVars[key], 'agent.aid': validationTargets[key].aid }));
574
+ assertExplicitAunDeliveryRoutes(normalized);
575
+ } catch (error) { throw Object.assign(new Error('Invalid Trigger ' + id + ': ' + error.message), { code: 'INVALID_ARGUMENT' }); }
576
+ const allowed = new Set(['trigger.json']);
577
+ if (def.execution?.type === 'script') {
578
+ const script = def.execution.script?.path; inside('/trigger', script);
579
+ assert(assembled.entries.has(prefix + script), 'INVALID_ARGUMENT', 'Trigger script missing'); allowed.add(script);
580
+ }
581
+ for (const relative of assembled.entries.keys()) if (relative.startsWith(prefix)) {
582
+ assert(allowed.has(relative.slice(prefix.length)), 'INVALID_ARGUMENT', 'Unsupported Trigger runtime or resource file');
583
+ }
584
+ }
585
+ members[key] = assembled;
586
+ }
587
+ const keys = Object.keys(members);
588
+ if (keys.length === 1) {
589
+ const alias = keys[0]; const key = options.originalKeys?.[alias] ?? alias;
590
+ if (alias !== key) {
591
+ const rename = text => text.replaceAll('{{members.' + alias + '.', '{{members.' + key + '.');
592
+ const value = members[alias]; value.member = JSON.parse(rename(JSON.stringify(value.member)));
593
+ value.entries = new Map([...value.entries].map(([relative, entry]) => [relative.replace('agents/' + alias + '/', 'agents/' + key + '/')
594
+ .replace('workspace/' + alias + '/', 'workspace/' + key + '/'), { ...entry, bytes: !entry.bytes.includes(0)
595
+ && Buffer.from(entry.bytes.toString('utf8')).equals(entry.bytes) ? Buffer.from(rename(entry.bytes.toString('utf8'))) : entry.bytes }]));
596
+ if (options.assistantKey === alias) options.assistantKey = key;
597
+ members[key] = value; delete members[alias];
598
+ }
599
+ if (key.includes('.')) {
600
+ // The explicit author version belongs to this new package, not the source installation.
601
+ members[key].member.version = options.metadata.version;
602
+ }
603
+ }
604
+ for (const [file, entry] of snapshots) {
605
+ if (Array.isArray(entry)) assert(JSON.stringify(walkFiles(file)) === JSON.stringify(entry), 'SOURCE_CHANGED', 'Workspace file set changed while packing');
606
+ else assert(stableBytes(file).bytes.equals(entry.bytes), 'SOURCE_CHANGED', 'Workspace changed while packing');
607
+ }
608
+ const frozen = { members: Object.fromEntries(Object.entries(members).map(([key, value]) => [key,
609
+ { ...value, entries: [...value.entries].map(([name, entry]) => [name, { mode: entry.mode, bytes: entry.bytes.toString('base64') }]) }])),
610
+ metadata: options.metadata, publisher: options.publisher, memberReferences: options.memberReferences,
611
+ assistantKey: options.assistantKey, createdAt: options.createdAt };
612
+ atomicBytes(snapshotFile, jsonBytes(frozen), 0o600);
613
+ return sealModuleSnapshot(options, frozen);
614
+ }
615
+ function sealModuleSnapshot(options, frozen) {
616
+ const members = Object.fromEntries(Object.entries(frozen.members).map(([key, value]) => [key, { ...value,
617
+ entries: new Map(value.entries.map(([name, entry]) => [name, { mode: entry.mode, bytes: Buffer.from(entry.bytes, 'base64') }])) }]));
618
+ const built = buildTemplatePackage({ ...frozen, members, onProgress: options.onProgress });
619
+ const checked = inspectTemplatePackage(built.bytes);
620
+ const partition = partitionTeamMembers(checked.team);
621
+ fs.mkdirSync(options.out, { recursive: true });
622
+ const file = path.join(options.out, built.filename); atomicBytes(file, built.bytes, 0o600);
623
+ const result = { file, digest: built.digest, size: built.bytes.length, metadata: { ...frozen.metadata },
624
+ members: Object.fromEntries(partition.inlineMembers.map(member => [member.key, member])),
625
+ memberReferences: { external: partition.externalContacts }, assistantKey: partition.assistantKey,
626
+ externalAids: built.metadata.externalAids, excluded: built.excluded };
627
+ atomicBytes(path.join(options.out, 'result.json'), jsonBytes(result), 0o600);
628
+ return result;
629
+ }
630
+
160
631
  export function identityText(text, options, reverse = false) {
161
632
  if (options.teamVariables && !reverse) {
162
633
  const mapping = new Map([...options.teamVariables, [options.ownerAid, '{{owner.aid}}'], [options.hostAid, '{{host.aid}}']].filter(([key]) => key));
163
634
  const pattern = [...mapping.keys()].sort((a, b) => b.length - a.length).map(key => key.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')).join('|');
164
- return pattern ? text.replace(new RegExp(pattern, 'g'), value => mapping.get(value)) : text;
635
+ return pattern ? text.split(/(\{\{[\s\S]*?\}\})/g).map(part => part.startsWith('{{') ? part
636
+ : part.replace(new RegExp(pattern, 'g'), value => mapping.get(value))).join('') : text;
165
637
  }
166
638
  const pairs = [[options.agentAid, '{{agent.aid}}'], [options.ownerAid, '{{owner.aid}}'], [options.hostAid, '{{host.aid}}']];
167
639
  if (options.projectPath) pairs.push([options.projectPath, '{{project.path}}']);
@@ -183,10 +655,10 @@ export function normalizeId(aid) {
183
655
  }
184
656
 
185
657
  export async function collectAgent(options, key, root) {
186
- const inventory = await inspectAgent(options);
658
+ const inventory = await inspectAgent({ ...options, listProjectFiles: false });
187
659
  const include = options.include;
188
660
  assert(isRecord(include), 'INVALID_ARGUMENT', 'include is required');
189
- const selected = options.include.baseagents.map(name => ({ name, default: name === inventory.activeBaseagent,
661
+ const selected = options.include.baseagents.filter(name => name === inventory.activeBaseagent).map(name => ({ name, default: true,
190
662
  model: inventory.baseagents.find(item => item.name === name)?.currentModel ?? undefined,
191
663
  effort: inventory.baseagents.find(item => item.name === name)?.currentEffort ?? undefined }));
192
664
  assert(selected.some(item => item.default), 'INVALID_ARGUMENT', 'The current default baseagent must be selected');
@@ -229,6 +701,17 @@ export async function collectAgent(options, key, root) {
229
701
  put(agentPrefix + '/events/' + pack.id + '/' + relative, bytes, fs.statSync(source).mode & 0o777);
230
702
  }
231
703
  }
704
+ const servicePacks = readServicePacks(path.join(options.agentDir, 'services'));
705
+ const services = include.services ?? [];
706
+ assert(Array.isArray(services) && services.every(id => servicePacks.some(pack => pack.id === id)), 'INVALID_ARGUMENT', 'Unknown service pack selection');
707
+ for (const pack of servicePacks.filter(pack => services.includes(pack.id))) {
708
+ for (const relative of pack.files) {
709
+ assert(!excluded(relative), 'INVALID_ARGUMENT', 'Excluded service pack resource: ' + relative);
710
+ const source = inside(pack.dir, relative);
711
+ const bytes = relative === 'pack.json' ? jsonBytes(identityValue(pack.definition, options)) : fs.readFileSync(source);
712
+ put(agentPrefix + '/services/' + pack.id + '/' + relative, bytes, fs.statSync(source).mode & 0o777);
713
+ }
714
+ }
232
715
  for (const name of inventory.profile.soul) put(agentPrefix + '/personal/soul/' + name,
233
716
  fs.readFileSync(inside(path.join(options.agentDir, 'personal', 'soul'), name)));
234
717
  if (inventory.profile.welcome) put(agentPrefix + '/personal/welcome.md', fs.readFileSync(path.join(options.agentDir, 'personal', 'welcome.md')));
@@ -250,7 +733,6 @@ export async function collectAgent(options, key, root) {
250
733
  assert(Array.isArray(skillNames) && skillNames.every(name => inventory.skills.some(s => s.name === name && s.type === 'local' && s.enabled)),
251
734
  'INVALID_ARGUMENT', 'Unknown or disabled local skill');
252
735
  const switches = {};
253
- for (const s of inventory.skills.filter(s => s.type === 'builtin')) switches[s.name] = { enabled: s.enabled };
254
736
  for (const name of skillNames) {
255
737
  switches[name] = { enabled: true };
256
738
  const dir = inside(path.join(options.home, 'skills'), name);
@@ -258,20 +740,10 @@ export async function collectAgent(options, key, root) {
258
740
  }
259
741
  const files = include.files ?? [];
260
742
  assert(Array.isArray(files), 'INVALID_ARGUMENT', 'Invalid files selection');
261
- const copied = new Set();
262
- for (const relative of files) {
263
- const absolute = path.resolve(inventory.project.path, relative);
264
- const homeRelative = path.relative(options.home, absolute).split(path.sep);
265
- assert(homeRelative[0] === '..' || !['AIDs', 'agents', 'data', 'logs', 'backups', 'eck', 'directory'].includes(homeRelative[0]),
266
- 'INVALID_ARGUMENT', 'Runtime data is not a project artifact');
267
- const file = inside(inventory.project.path, relative); regularPath(file);
268
- assert(!excluded(relative) && fs.existsSync(file), 'INVALID_ARGUMENT', 'Excluded or missing selection: ' + relative);
269
- const paths = fs.statSync(file).isDirectory() ? walkFiles(file, p => excluded(relative + '/' + p)).map(p => relative + '/' + p) : [relative];
270
- for (const p of paths) if (!excluded(p) && !copied.has(p)) {
271
- copied.add(p); const source = inside(inventory.project.path, p);
272
- put('workspace/' + key + '/' + p, fs.readFileSync(source), fs.statSync(source).mode & 0o777);
273
- }
274
- }
743
+ const stats = collectProjectFiles(inventory.project.path, files,
744
+ (p, bytes, mode) => put('workspace/' + key + '/' + p, bytes, mode),
745
+ { home: options.home, filesOnly: options.projectFilesOnly === true, memberKey: key, entries: options.projectEntries });
746
+ if (options.projectFileStats) Object.assign(options.projectFileStats, stats);
275
747
  const profile = Object.fromEntries([...PROFILE_FIELDS, 'type']
276
748
  .filter(field => options.profile?.[field] !== undefined).map(field => [field, options.profile[field]]));
277
749
  const renderedProfile = identityValue(profile, options);