evolcore 0.0.50 → 0.0.51

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (448) hide show
  1. package/CHANGELOG.md +39 -2
  2. package/bin/ec-build.mjs +60 -0
  3. package/bin/ecmsg.js +65 -63
  4. package/dist/ability/caller/command.js +24 -15
  5. package/dist/ability/caller/contract.js +24 -9
  6. package/dist/ability/caller/credential-files.js +132 -0
  7. package/dist/ability/caller/daemon.js +32 -7
  8. package/dist/ability/caller/schema-view.js +157 -0
  9. package/dist/ability/caller/service.js +202 -63
  10. package/dist/ability/interop-v1.js +156 -113
  11. package/dist/agent-template/jobs.js +14 -110
  12. package/dist/agent-template/runtime.js +331 -193
  13. package/dist/agent-template/service.js +1029 -1104
  14. package/dist/agent-template/share.js +103 -0
  15. package/dist/agent-template/tool-runner.js +25 -0
  16. package/dist/agent-template/types.js +10 -3
  17. package/dist/agents/claude/availability.js +94 -0
  18. package/dist/agents/claude/capability-provider.js +154 -0
  19. package/dist/agents/claude/index.js +145 -0
  20. package/dist/agents/{claude-runner.js → claude/runner.js} +74 -158
  21. package/dist/agents/claude/session-file-adapter.js +246 -0
  22. package/dist/agents/codex/app-server-client.js +90 -10
  23. package/dist/agents/codex/availability.js +164 -0
  24. package/dist/agents/codex/capability-provider.js +138 -0
  25. package/dist/agents/codex/cli.js +38 -0
  26. package/dist/agents/codex/index.js +345 -0
  27. package/dist/agents/codex/mcp-elicitation.js +135 -0
  28. package/dist/agents/{codex-runner.js → codex/runner.js} +648 -382
  29. package/dist/agents/codex/session-file-adapter.js +834 -0
  30. package/dist/agents/dsh/availability.js +28 -0
  31. package/dist/agents/dsh/capability-provider.js +56 -0
  32. package/dist/agents/dsh/desktop-locations.ps1 +66 -0
  33. package/dist/agents/dsh/desktop-probe.cjs +37 -0
  34. package/dist/agents/dsh/index.js +98 -0
  35. package/dist/agents/dsh/installation.js +400 -0
  36. package/dist/agents/dsh/resources.js +755 -0
  37. package/dist/agents/dsh/runner.js +1183 -0
  38. package/dist/agents/dsh/runtime/README.md +243 -0
  39. package/dist/agents/dsh/runtime/authorization.js +23 -0
  40. package/dist/agents/dsh/runtime/bridge.js +837 -0
  41. package/dist/agents/dsh/runtime/config.js +271 -0
  42. package/dist/agents/dsh/runtime/entry.js +229 -0
  43. package/dist/agents/dsh/runtime/session-inspector.js +340 -0
  44. package/dist/agents/dsh/runtime/tool-policy.js +49 -0
  45. package/dist/agents/dsh/session-file-adapter.js +145 -0
  46. package/dist/agents/ecagent/index.js +215 -0
  47. package/dist/agents/{ecagent-runner.js → ecagent/runner.js} +592 -106
  48. package/dist/agents/ecagent/session-file-adapter.js +134 -0
  49. package/dist/agents/gemini/index.js +55 -10
  50. package/dist/agents/gemini/{gemini-runner.js → runner.js} +4 -9
  51. package/dist/aun/ability-device-routing.js +11 -17
  52. package/dist/aun/aid/agentmd.js +27 -1
  53. package/dist/aun/aid/managed-operation.js +6 -4
  54. package/dist/aun/group/invite-service.js +1 -1
  55. package/dist/aun/menu/client.js +1 -1
  56. package/dist/aun/msg/history.js +1 -1
  57. package/dist/aun/msg/managed-operation.js +93 -21
  58. package/dist/aun/msg/p2p.js +6 -6
  59. package/dist/aun/service-proxy.js +1 -1
  60. package/dist/aun/storage/index.js +242 -0
  61. package/dist/build-identity.json +1 -1
  62. package/dist/channels/aun.js +180 -43
  63. package/dist/channels/daemon.js +3 -2
  64. package/dist/channels/dingtalk.js +1 -1
  65. package/dist/channels/feishu.js +9 -9
  66. package/dist/channels/qqbot.js +1 -1
  67. package/dist/channels/wechat.js +2 -2
  68. package/dist/channels/wecom.js +1 -1
  69. package/dist/{agents/claude-gateway → claude-gateway}/agent-registration.js +13 -13
  70. package/dist/{agents/claude-gateway → claude-gateway}/binding.js +3 -3
  71. package/dist/{agents/claude-gateway → claude-gateway}/inbox.js +1 -1
  72. package/dist/{agents/claude-gateway → claude-gateway}/index.js +2 -2
  73. package/dist/{agents/claude-gateway → claude-gateway}/listing.js +3 -3
  74. package/dist/{agents/claude-gateway → claude-gateway}/router.js +4 -4
  75. package/dist/{agents/claude-gateway → claude-gateway}/sessions.js +2 -2
  76. package/dist/{agents/claude-gateway → claude-gateway}/terminal.js +1 -1
  77. package/dist/{agents/claude-gateway → claude-gateway}/transcript.js +1 -1
  78. package/dist/cli/ability-command.js +8 -5
  79. package/dist/cli/ability-output.js +182 -0
  80. package/dist/cli/agent-command.js +1 -1
  81. package/dist/cli/agent-create.js +123 -42
  82. package/dist/cli/agent-template.js +400 -29
  83. package/dist/cli/agent.js +14 -11
  84. package/dist/cli/aun-commands.js +167 -111
  85. package/dist/cli/daemon-commands.js +38 -8
  86. package/dist/cli/data-command.js +1 -1
  87. package/dist/cli/debug-mode.js +9 -0
  88. package/dist/cli/directory.js +1 -2
  89. package/dist/cli/ecmsg-gateway.js +55 -19
  90. package/dist/cli/fs-command.js +67 -39
  91. package/dist/cli/index.js +25 -11
  92. package/dist/cli/init.js +124 -29
  93. package/dist/cli/managed-command-guard.js +2 -0
  94. package/dist/cli/model.js +1 -1
  95. package/dist/cli/restart-monitor.js +2 -2
  96. package/dist/cli/services-command.js +24 -1
  97. package/dist/cli/skill-command.js +4 -4
  98. package/dist/cli/task-context.js +24 -14
  99. package/dist/cli/team-workspace-command.js +50 -52
  100. package/dist/cli/thread-command.js +3 -2
  101. package/dist/cli/trigger-command.js +47 -12
  102. package/dist/cli/watch-logs.js +2 -1
  103. package/dist/config/boot-log.js +3 -0
  104. package/dist/config/builtin-role-templates.js +1 -1
  105. package/dist/config/config-field-policy.js +10 -6
  106. package/dist/config/config-manager.js +33 -12
  107. package/dist/config/gateway-config.js +21 -37
  108. package/dist/config/invoke-ipc-service.js +1 -1
  109. package/dist/config/owner-config.js +5 -3
  110. package/dist/config/peer-book-store.js +2 -3
  111. package/dist/config/peer-book.js +2 -2
  112. package/dist/config/peer-role-resolver.js +2 -2
  113. package/dist/config/provider-identity-migration.js +24 -105
  114. package/dist/config/provider-ipc-service.js +13 -3
  115. package/dist/config/provider-local-sync.js +4 -1
  116. package/dist/config/provider-menu-request.js +21 -3
  117. package/dist/config/provider-templates.js +1 -1
  118. package/dist/config/providers-config.js +39 -15
  119. package/dist/config/providers-import.js +3 -3
  120. package/dist/config/providers-management.js +74 -99
  121. package/dist/config/schema-migration.js +177 -11
  122. package/dist/config/schema-registry.js +1 -1
  123. package/dist/config-store.js +38 -50
  124. package/dist/core/{agent-application-service.js → agent/agent-application-service.js} +9 -9
  125. package/dist/core/{agent-create-status.js → agent/agent-create-status.js} +112 -4
  126. package/dist/core/{agent-creation-claim.js → agent/agent-creation-claim.js} +3 -3
  127. package/dist/core/{agent-ipc-registration.js → agent/agent-ipc-registration.js} +102 -25
  128. package/dist/core/{agent-reload-coordinator.js → agent/agent-reload-coordinator.js} +61 -1
  129. package/dist/core/{agent-runtime.js → agent/agent-runtime.js} +53 -27
  130. package/dist/core/{evolagent-registry.js → agent/evolagent-registry.js} +12 -12
  131. package/dist/core/{evolagent.js → agent/evolagent.js} +11 -11
  132. package/dist/core/auth/agent-delegation.js +1 -8
  133. package/dist/core/auth/delegation-authorization.js +28 -0
  134. package/dist/core/auth/operation-authorizer.js +7 -4
  135. package/dist/core/auth/operation-catalog.js +34 -5
  136. package/dist/core/baseagent/baseagent-availability.js +197 -0
  137. package/dist/core/baseagent/baseagent-capability-adapter.js +288 -0
  138. package/dist/core/baseagent/baseagent-config-shared.js +56 -0
  139. package/dist/core/baseagent/baseagent-identity.js +68 -0
  140. package/dist/core/{baseagent-loader.js → baseagent/baseagent-loader.js} +62 -6
  141. package/dist/core/baseagent/baseagent-model-defaults.js +26 -0
  142. package/dist/{agents → core/baseagent}/baseagent-plugin-descriptor.js +107 -24
  143. package/dist/core/baseagent/baseagent-plugin-loader.js +367 -0
  144. package/dist/core/baseagent/baseagent.js +157 -0
  145. package/dist/{agents → core/baseagent}/runner-types.js +36 -4
  146. package/dist/core/capability/capability-manager.js +79 -30
  147. package/dist/core/capability/providers/claude-capability-provider.js +2 -154
  148. package/dist/core/capability/providers/codex-capability-provider.js +2 -136
  149. package/dist/core/{channel-loader.js → channel/channel-loader.js} +226 -38
  150. package/dist/core/{channel-runtime.js → channel/channel-runtime.js} +18 -18
  151. package/dist/core/command/agent-control.js +60 -15
  152. package/dist/core/command/agent-template-menu.js +21 -9
  153. package/dist/core/command/agentmd-menu-request.js +19 -8
  154. package/dist/core/command/agentmd-menu.js +14 -5
  155. package/dist/core/command/command-handler.js +127 -57
  156. package/dist/core/command/context-policy-menu.js +122 -0
  157. package/dist/core/command/data-root-resolver.js +157 -20
  158. package/dist/core/command/memory-slash.js +6 -6
  159. package/dist/core/command/menu-catalog.js +80 -20
  160. package/dist/core/command/menu-handler.js +305 -25
  161. package/dist/core/command/menu-protocol.js +42 -8
  162. package/dist/core/command/menu-query-batch.js +9 -5
  163. package/dist/core/command/provider-menu.js +7 -11
  164. package/dist/core/command/role-menu.js +1 -1
  165. package/dist/core/command/skill-slash.js +17 -5
  166. package/dist/core/command/slash-gate.js +2 -4
  167. package/dist/core/command/slash-handler.js +127 -96
  168. package/dist/core/command/team-workspace-team.js +3 -3
  169. package/dist/core/command/topic-slash.js +10 -10
  170. package/dist/core/{daemon-bootstrap.js → daemon/daemon-bootstrap.js} +14 -14
  171. package/dist/core/{daemon-control.js → daemon/daemon-control.js} +46 -20
  172. package/dist/core/{daemon-lifecycle.js → daemon/daemon-lifecycle.js} +15 -15
  173. package/dist/core/{host-snapshot.js → daemon/host-snapshot.js} +3 -3
  174. package/dist/core/{ipc-registration.js → daemon/ipc-registration.js} +98 -38
  175. package/dist/core/{lifecycle-notice.js → daemon/lifecycle-notice.js} +4 -5
  176. package/dist/core/file-integrity/store.js +1 -1
  177. package/dist/core/handoff/ipc-registration.js +3 -3
  178. package/dist/core/handoff/runtime.js +1 -1
  179. package/dist/{agents → core/inference}/request-identity.js +2 -2
  180. package/dist/core/inference/text-inference.js +4 -4
  181. package/dist/core/{bootstrap-messages.js → initialization/bootstrap-messages.js} +10 -10
  182. package/dist/core/{bootstrap-service.js → initialization/bootstrap-service.js} +24 -23
  183. package/dist/core/initialization/service.js +54 -9
  184. package/dist/core/invoke/executors/media.js +1 -1
  185. package/dist/core/invoke/executors/text.js +1 -1
  186. package/dist/core/memory/consolidation-context.js +1 -1
  187. package/dist/core/memory/consolidation-trigger.js +9 -3
  188. package/dist/core/memory/consolidation.js +4 -4
  189. package/dist/core/memory/memory-admin.js +6 -6
  190. package/dist/core/memory/memory-writer.js +1 -1
  191. package/dist/core/memory/relation-idle-monitor.js +1 -1
  192. package/dist/core/message/aun-ipc-sender.js +114 -75
  193. package/dist/core/message/aun-request-registry.js +13 -5
  194. package/dist/core/message/auto-mention-gate.js +1 -1
  195. package/dist/core/message/contact-admission.js +1 -1
  196. package/dist/core/message/im-renderer.js +19 -0
  197. package/dist/core/{interaction-router.js → message/interaction-router.js} +4 -4
  198. package/dist/core/message/items-formatter.js +5 -5
  199. package/dist/core/message/message-admission.js +1 -1
  200. package/dist/core/message/message-bridge.js +135 -54
  201. package/dist/core/message/message-queue.js +83 -4
  202. package/dist/core/message/message-utils.js +1 -1
  203. package/dist/core/message/peer-mode.js +1 -1
  204. package/dist/core/message/response-engine.js +347 -163
  205. package/dist/core/message/send-options.js +9 -6
  206. package/dist/core/message/send-routing.js +45 -109
  207. package/dist/core/message/stream-idle-monitor.js +1 -1
  208. package/dist/core/{data-migration.js → migration/data-migration.js} +29 -1
  209. package/dist/core/model/catalog-service.js +29 -8
  210. package/dist/core/model/model-capabilities.js +88 -0
  211. package/dist/core/model/model-catalog.js +14 -3
  212. package/dist/core/model/model-diagnostics.js +4 -4
  213. package/dist/core/ownership/owner-resolver.js +95 -15
  214. package/dist/core/{pack-auth.js → pack/pack-auth.js} +30 -3
  215. package/dist/core/{pack-install.js → pack/pack-install.js} +95 -17
  216. package/dist/core/permission/approval-gateway.js +9 -18
  217. package/dist/core/permission/ec-command-parser.js +70 -34
  218. package/dist/core/permission/managed-file.js +234 -0
  219. package/dist/core/permission/protected-paths.js +56 -0
  220. package/dist/core/permission/sandbox-runtime.js +267 -3
  221. package/dist/core/permission/session-path-grants.js +1 -1
  222. package/dist/core/permission/shell-environment.js +15 -1
  223. package/dist/core/plugin/plugin-lifecycle.js +442 -0
  224. package/dist/core/session/adapters/claude-session-file-adapter.js +2 -246
  225. package/dist/core/session/adapters/codex-session-file-adapter.js +2 -566
  226. package/dist/core/session/adapters/ecagent-session-file-adapter.js +2 -134
  227. package/dist/core/{background-session → session/background}/session-cleanup.js +2 -2
  228. package/dist/core/{background-session → session/background}/types.js +1 -1
  229. package/dist/core/session/session-file-health.js +2 -272
  230. package/dist/core/session/session-idle-monitor.js +1 -1
  231. package/dist/core/session/session-manager.js +29 -2
  232. package/dist/core/session/session-terminal.js +185 -0
  233. package/dist/core/session/session-title.js +8 -11
  234. package/dist/core/{system-session → session/system}/memory.js +43 -9
  235. package/dist/core/{system-session → session/system}/registry.js +1 -1
  236. package/dist/core/{system-session → session/system}/types.js +1 -1
  237. package/dist/core/skill/index-generator.js +1 -0
  238. package/dist/core/task/task-activity-store.js +112 -0
  239. package/dist/core/task/task-recovery-service.js +2 -2
  240. package/dist/core/thread/ipc-operation.js +2 -2
  241. package/dist/core/thread/thread-operation.js +2 -1
  242. package/dist/core/thread/thread-route.js +5 -3
  243. package/dist/core/thread/thread-service.js +14 -4
  244. package/dist/directory/{owner-directory-admission.js → admission.js} +3 -3
  245. package/dist/directory/{owner-directory-cache.js → cache.js} +90 -8
  246. package/dist/directory/{owner-directory-markdown.js → markdown.js} +2 -2
  247. package/dist/directory/{owner-directory-query-operation.js → query-operation.js} +83 -9
  248. package/dist/directory/{owner-directory-search.js → search.js} +50 -2
  249. package/dist/directory/{owner-directory-store.js → store.js} +2 -2
  250. package/dist/eck/kit-renderer.js +1 -1
  251. package/dist/eck/manifest-engine.js +64 -2
  252. package/dist/eck/message-renderer.js +35 -0
  253. package/dist/ecweb/basic-settings-service.js +9 -3
  254. package/dist/{contracts → ecweb/contracts}/ecweb-service-protocol.js +2 -1
  255. package/dist/ecweb/dsh-native-service.js +413 -0
  256. package/dist/ecweb/providers-service.js +1 -1
  257. package/dist/ecweb/runtime/lifecycle.js +1 -1
  258. package/dist/ecweb/runtime/supervisor.js +1 -1
  259. package/dist/event-center/center-config.js +2 -2
  260. package/dist/event-center/dispatcher.js +1 -1
  261. package/dist/event-center/ipc-operation.js +12 -3
  262. package/dist/event-center/pack-loader.js +2 -2
  263. package/dist/event-center/registry.js +6 -6
  264. package/dist/event-center/runtime.js +2 -2
  265. package/dist/index.js +71 -42
  266. package/dist/ipc.js +103 -10
  267. package/dist/outputs/authorization.js +27 -0
  268. package/dist/outputs/events.js +10 -1
  269. package/dist/outputs/panel-cards.js +960 -0
  270. package/dist/paths.js +12 -0
  271. package/dist/pay/command.js +1 -1
  272. package/dist/pay/runtime.js +18 -10
  273. package/dist/response-system/engines/v1/proactive-flow.js +1 -1
  274. package/dist/services/dispatcher.js +2 -2
  275. package/dist/services/host/main.js +10 -1
  276. package/dist/services/host/protocol.js +9 -2
  277. package/dist/services/host/resident.js +37 -0
  278. package/dist/services/host-client.js +12 -0
  279. package/dist/services/host-recycle.js +8 -3
  280. package/dist/services/host-runtime.js +54 -15
  281. package/dist/services/index.js +83 -19
  282. package/dist/services/ipc-operation.js +303 -38
  283. package/dist/services/pack-manager.js +2 -2
  284. package/dist/services/router.js +43 -3
  285. package/dist/services/script-runner.js +34 -25
  286. package/dist/services/service-payload.js +28 -1
  287. package/dist/services/validation.js +28 -2
  288. package/dist/stats/context-usage.js +110 -0
  289. package/dist/stats/model-resolver.js +103 -17
  290. package/dist/stats/query.js +5 -0
  291. package/dist/trigger/application-service.js +3 -2
  292. package/dist/trigger/authorization.js +36 -33
  293. package/dist/trigger/ipc-service.js +4 -4
  294. package/dist/trigger/local-files.js +8 -176
  295. package/dist/trigger/manager.js +2 -2
  296. package/dist/trigger/parser.js +48 -0
  297. package/dist/trigger/scheduler.js +14 -2
  298. package/dist/trigger/script-executor.js +21 -0
  299. package/dist/trigger/script-sandbox.js +57 -243
  300. package/dist/trigger/system-definitions.js +25 -0
  301. package/dist/trigger/validation.js +1 -1
  302. package/dist/utils/atomic-write.js +88 -1
  303. package/dist/utils/cross-platform.js +4 -42
  304. package/dist/utils/error-dict.json +22 -1
  305. package/dist/utils/error-utils.js +193 -6
  306. package/dist/utils/evolcore-version.js +2 -2
  307. package/dist/utils/host-info.js +1 -1
  308. package/dist/utils/logger.js +3 -1
  309. package/dist/utils/media-cache.js +99 -4
  310. package/dist/utils/startup-trace.js +20 -4
  311. package/dist/utils/welcome.js +64 -20
  312. package/ecagent/README.md +35 -0
  313. package/ecagent/dist/agent-loop.js +80 -30
  314. package/ecagent/dist/harness/env/nodejs.d.ts +16 -0
  315. package/ecagent/dist/harness/env/nodejs.js +49 -20
  316. package/ecagent/dist/harness/messages.js +3 -2
  317. package/ecagent/dist/harness/types.d.ts +1 -0
  318. package/ecagent/dist/runtime/types.d.ts +2 -0
  319. package/ecagent/dist/runtime/utils/validation.d.ts +7 -1
  320. package/ecagent/dist/runtime/utils/validation.js +42 -0
  321. package/ecagent/dist/types.d.ts +2 -0
  322. package/kits/docs/INDEX.md +1 -1
  323. package/kits/docs/channels/feishu.md +1 -1
  324. package/kits/docs/evolcore/INDEX.md +10 -7
  325. package/kits/docs/evolcore/agent-create.md +2 -0
  326. package/kits/docs/evolcore/agent.md +100 -13
  327. package/kits/docs/evolcore/aid.md +19 -3
  328. package/kits/docs/evolcore/config.md +94 -0
  329. package/kits/docs/evolcore/ctl.md +2 -1
  330. package/kits/docs/evolcore/ec-capabilities.md +7 -10
  331. package/kits/docs/evolcore/ecweb-lifecycle.md +5 -1
  332. package/kits/docs/evolcore/event.md +1 -1
  333. package/kits/docs/evolcore/fs.md +49 -3
  334. package/kits/docs/evolcore/group.md +3 -3
  335. package/kits/docs/evolcore/memory-consolidation.md +1 -1
  336. package/kits/docs/evolcore/menu-protocol.md +24 -2
  337. package/kits/docs/evolcore/model.md +9 -1
  338. package/kits/docs/evolcore/msg.md +30 -28
  339. package/kits/docs/evolcore/pay.md +8 -20
  340. package/kits/docs/evolcore/plugin.md +74 -0
  341. package/kits/docs/evolcore/provider.md +8 -2
  342. package/kits/docs/evolcore/rpc.md +2 -2
  343. package/kits/docs/evolcore/skill.md +17 -1
  344. package/kits/docs/evolcore/stats.md +5 -0
  345. package/kits/docs/evolcore/storage.md +22 -0
  346. package/kits/docs/evolcore/thread-chain.md +19 -10
  347. package/kits/docs/evolcore/tool-authorization.md +4 -0
  348. package/kits/docs/evolcore/trigger.md +89 -13
  349. package/kits/docs/identity/AID_PROFILE_SPEC.md +1 -1
  350. package/kits/docs/venues/feishu-group.md +3 -2
  351. package/kits/docs/venues/feishu-private.md +3 -2
  352. package/kits/rules/02-navigation.md +20 -13
  353. package/kits/rules/06-channel.md +18 -2
  354. package/kits/schemas/_meta.json +8 -4
  355. package/kits/schemas/agent-config.schema.23.json +19 -3
  356. package/kits/schemas/agent-config.schema.24.json +986 -0
  357. package/kits/schemas/agent-config.schema.25.json +986 -0
  358. package/kits/schemas/daemon.schema.11.json +487 -0
  359. package/kits/schemas/daemon.schema.12.json +505 -0
  360. package/kits/schemas/defaults.schema.8.json +484 -0
  361. package/kits/schemas/providers.schema.1.json +1 -1
  362. package/kits/schemas/providers.schema.2.json +1 -1
  363. package/kits/schemas/providers.schema.3.json +8 -2
  364. package/kits/skills/.switches.json +4 -0
  365. package/kits/skills/ability/SKILL.md +194 -27
  366. package/kits/skills/ability/STRUCTURE.md +5 -0
  367. package/kits/skills/agent-output-cards/SKILL.md +90 -54
  368. package/kits/skills/agent-output-cards/examples/html-surface.json +11 -0
  369. package/kits/skills/agent-output-cards/examples/meeting-followups.json +16 -0
  370. package/kits/skills/agent-output-cards/examples/meeting-latest.json +24 -0
  371. package/kits/skills/agent-output-cards/examples/project-metrics.json +16 -0
  372. package/kits/skills/agent-output-cards/examples/quick-links.json +18 -0
  373. package/kits/skills/agent-output-cards/examples/surface.html +8 -0
  374. package/kits/skills/agent-template-project/SKILL.md +51 -0
  375. package/kits/skills/agent-template-project/references/01-collect-and-pack.md +174 -0
  376. package/kits/skills/agent-template-project/references/02-upload-and-share.md +109 -0
  377. package/kits/skills/agent-template-project/references/03-download-and-install.md +189 -0
  378. package/kits/skills/agent-template-project/references/04-upgrade-and-recovery.md +74 -0
  379. package/kits/skills/agent-template-project/references/05-publish-to-platform.md +62 -0
  380. package/kits/skills/ec-group/SKILL.md +3 -3
  381. package/kits/skills/ec-group-collaboration/SKILL.md +4 -4
  382. package/kits/skills/ec-identity/SKILL.md +9 -6
  383. package/kits/skills/ec-pay/SKILL.md +163 -41
  384. package/kits/skills/ec-provider/SKILL.md +5 -5
  385. package/kits/skills/ec-service-call/SKILL.md +3 -0
  386. package/kits/skills/ec-skill/SKILL.md +25 -9
  387. package/kits/skills/ec-skill/scripts/cli.mjs +7 -7
  388. package/kits/skills/ec-skill/scripts/skill.mjs +55 -41
  389. package/kits/skills/ec-skill/scripts/template/SKILL.md.tmpl +9 -0
  390. package/kits/skills/ec-trigger/SKILL.md +2 -2
  391. package/kits/skills/personal-assistant/SKILL.md +22 -22
  392. package/kits/skills/personal-assistant/references/03-data-flow-and-gaps.md +1 -1
  393. package/kits/skills/scrapling-article-fetch/SKILL.md +5 -5
  394. package/kits/skills/thread-ops/SKILL.md +19 -9
  395. package/kits/skills/wechat-article-media-download/SKILL.md +2 -2
  396. package/kits/skills/wechat-article-reader/SKILL.md +2 -2
  397. package/kits/templates/system-fragments/commands.md +1 -1
  398. package/kits/templates/system-fragments/personal-assistant.md +2 -2
  399. package/kits/templates/system-fragments/reply.md +14 -9
  400. package/kits/templates/system-fragments/session.md +1 -1
  401. package/kits/templates/system-fragments/thread.md +10 -5
  402. package/package.json +6 -5
  403. package/scripts/agent-template/index.mjs +7 -1
  404. package/scripts/agent-template/inspect.mjs +81 -35
  405. package/scripts/agent-template/overlay.mjs +110 -4
  406. package/scripts/agent-template/shared/common.mjs +36 -4
  407. package/scripts/agent-template/shared/plan.mjs +4 -2
  408. package/scripts/agent-template/shared/service-packs.mjs +104 -0
  409. package/scripts/agent-template/shared/team-schema.json +467 -54
  410. package/scripts/agent-template/shared/template-contract.mjs +70 -68
  411. package/scripts/agent-template/shared/template-package.mjs +153 -36
  412. package/scripts/agent-template/shared/template-runtime.mjs +76 -64
  413. package/scripts/agent-template/shared/template.mjs +11 -46
  414. package/scripts/agent-template/team-pack.mjs +451 -35
  415. package/scripts/agent-template/team-preview.mjs +75 -226
  416. package/scripts/aid-batch/identity-batch.mjs +1 -1
  417. package/dist/agents/baseagent-availability.js +0 -176
  418. package/dist/agents/baseagent-capability-adapter.js +0 -102
  419. package/dist/agents/baseagent-plugin-loader.js +0 -145
  420. package/dist/agents/baseagent.js +0 -816
  421. package/dist/agents/codex/catalog.js +0 -80
  422. package/dist/agents/ecagent-plugin-lazy.js +0 -41
  423. package/dist/agents/tool-time-context.js +0 -55
  424. package/dist/core/legacy-rename.js +0 -41
  425. package/dist/core/plugin-lifecycle.js +0 -137
  426. package/dist/core/rate-window.js +0 -53
  427. package/dist/core/runner-reload-transaction.js +0 -60
  428. package/dist/core/runtime-lock.js +0 -90
  429. package/dist/core/soul.js +0 -66
  430. package/dist/core/system-session/grants.js +0 -40
  431. package/dist/directory/owner-directory-agentmd-sync.js +0 -89
  432. package/dist/directory/owner-directory-request-operation.js +0 -79
  433. package/dist/directory/owner-directory-text.js +0 -60
  434. package/kits/skills/ec-pay/references/pay-cli.md +0 -110
  435. /package/dist/agents/gemini/{gemini-capability-provider.js → capability-provider.js} +0 -0
  436. /package/dist/agents/gemini/{gemini-session-file-adapter.js → session-file-adapter.js} +0 -0
  437. /package/dist/{agents/claude-gateway → claude-gateway}/types.js +0 -0
  438. /package/dist/core/{system-channels.js → channel/system-channels.js} +0 -0
  439. /package/dist/core/{daemon-file-cache.js → daemon/daemon-file-cache.js} +0 -0
  440. /package/dist/core/{event-bus.js → event/event-bus.js} +0 -0
  441. /package/dist/core/{event-catalog.js → event/event-catalog.js} +0 -0
  442. /package/dist/core/{pack-ledger.js → pack/pack-ledger.js} +0 -0
  443. /package/dist/directory/{owner-directory-identity.js → identity.js} +0 -0
  444. /package/dist/directory/{owner-directory-policy.js → policy.js} +0 -0
  445. /package/dist/directory/{owner-directory-remarks.js → remarks.js} +0 -0
  446. /package/dist/directory/{owner-directory-scope.js → scope.js} +0 -0
  447. /package/dist/{contracts → ecweb/contracts}/ecweb-instance.js +0 -0
  448. /package/kits/templates/{bootstrap-welcome.md → bootstrap-intro.md} +0 -0
@@ -6,18 +6,25 @@ import { gzipSync, gunzipSync } from 'node:zlib';
6
6
  import { loadTemplate } from './template.mjs';
7
7
  import { resolveTemplateAidDomain } from './template-contract.mjs';
8
8
  import { AID_PATTERN, normalizeTeam, normalizeTeamSchema, validateContractSchema, readTeamSchema, packageSchema, contractDigest, canonicalJson, validateBuildSelection } from './template-contract.mjs';
9
- import { BASEAGENTS, assertPublicTemplateConfig, resolveMemberParameters, partitionTeamMembers, validateAccessDeclaration } from './template-runtime.mjs';
9
+ import { BASEAGENTS, assertPublicTemplateConfig, resolveMemberParameters, partitionTeamMembers,
10
+ MEMBER_RESOURCE_KINDS, validateMemberResourceStates, materializeMemberResourceStates } from './template-runtime.mjs';
10
11
 
11
12
  export const PACKAGE_LIMITS = { file: 20 * 1024 * 1024, total: 200 * 1024 * 1024, entries: 20000 };
12
13
  const record = value => value !== null && typeof value === 'object' && !Array.isArray(value);
13
14
  const json = value => Buffer.from(JSON.stringify(value, null, 2) + '\n');
14
15
  let eventPackRuntime;
16
+ let servicePackRuntime;
15
17
  const eventValidator = new URL('../../../dist/event-center/validation.js', import.meta.url);
16
- const eventInstaller = new URL('../../../dist/core/pack-install.js', import.meta.url);
18
+ const eventInstaller = new URL('../../../dist/core/pack/pack-install.js', import.meta.url);
17
19
  if (fs.existsSync(eventValidator) && fs.existsSync(eventInstaller)) {
18
20
  const [validation, installation] = await Promise.all([import(eventValidator.href), import(eventInstaller.href)]);
19
21
  configureTemplateEventPacks({ validatePackJson: validation.validatePackJson, runtimeEntries: installation.PACK_RUNTIME_ENTRIES });
20
22
  }
23
+ const serviceHelper = new URL('./service-packs.mjs', import.meta.url);
24
+ const serviceValidator = new URL('../../../dist/services/validation.js', import.meta.url);
25
+ if (fs.existsSync(serviceHelper) && fs.existsSync(serviceValidator) && fs.existsSync(eventInstaller)) {
26
+ servicePackRuntime = await import(serviceHelper.href);
27
+ }
21
28
 
22
29
  /** Standalone consumers inject the real Core validator only when consuming event packs. */
23
30
  export function configureTemplateEventPacks({ validatePackJson, runtimeEntries }) {
@@ -29,7 +36,76 @@ function requireEventPackRuntime() {
29
36
  check(eventPackRuntime, 'Core event-pack validator unavailable; configureTemplateEventPacks with the installed Core runtime', 'EVENT_VALIDATOR_UNAVAILABLE');
30
37
  return eventPackRuntime;
31
38
  }
39
+ function requireServicePackRuntime() {
40
+ check(servicePackRuntime, 'Core service-pack validator unavailable; use the installed Core runtime', 'SERVICE_VALIDATOR_UNAVAILABLE');
41
+ return servicePackRuntime;
42
+ }
43
+ export async function configureTemplateServicePacks(runtime) {
44
+ const helpers = await import(serviceHelper.href);
45
+ helpers.configureServicePackRuntime(runtime);
46
+ servicePackRuntime = helpers;
47
+ }
48
+ function portableServiceFile(relative) {
49
+ return relative.startsWith('services/') && requireServicePackRuntime().portableServiceFile(relative);
50
+ }
32
51
  export const packageDigest = bytes => 'sha256:' + createHash('sha256').update(bytes).digest('hex');
52
+ /** The same bounded credential check applies to directory export and edited module copies. */
53
+ function assertPortableText(name, bytes) {
54
+ if (bytes.includes(0) || !Buffer.from(bytes.toString('utf8')).equals(bytes)) return;
55
+ const lines = bytes.toString('utf8').split('\n');
56
+ for (let index = 0; index < lines.length; index++) {
57
+ if (/(?:sk-[A-Za-z0-9_-]{16,}|ghp_[A-Za-z0-9]{20,}|AKIA[A-Z0-9]{16}|-----BEGIN .*PRIVATE KEY|(?:API_KEY|TOKEN|SECRET|PASSWORD)\s*=\s*(?!\$\{)\S{8,})/i.test(lines[index])) {
58
+ throw Object.assign(new Error('Credential content in portable resource: ' + name), {
59
+ code: 'SENSITIVE_CONTENT', details: { path: name, line: index + 1 },
60
+ });
61
+ }
62
+ }
63
+ }
64
+ /** Compare only the installed release's original package with the exact target, never local files. */
65
+ export function summarizeAgentUpgrade(fromBytes, toBytes, { key, fromVersion } = {}) {
66
+ const target = inspectTemplatePackage(toBytes);
67
+ check(target.team.agents.length === 1 && target.team.agents[0].key === key, 'Exact single Agent key required');
68
+ const base = { key, fromVersion: fromVersion ?? null, toVersion: target.metadata.version };
69
+ const unavailable = reason => ({ ...base, available: false, reason, components: null, soul: null, workspace: null });
70
+ if (!fromBytes) return unavailable('PREVIOUS_PACKAGE_UNAVAILABLE');
71
+ let previous;
72
+ try { previous = inspectTemplatePackage(fromBytes); }
73
+ catch { return unavailable('PREVIOUS_PACKAGE_INVALID'); }
74
+ if (previous.team.agents.length !== 1 || previous.team.agents[0].key !== key
75
+ || fromVersion && previous.metadata.version !== fromVersion) return unavailable('PREVIOUS_PACKAGE_MISMATCH');
76
+ const inventory = checked => {
77
+ const components = { triggers: new Map(), skills: new Map(), events: new Map(), services: new Map() };
78
+ const workspace = new Map(); const soul = [];
79
+ for (const [name, entry] of checked.entries) {
80
+ const relative = name.replace(/^template\//, '');
81
+ if (relative.startsWith('workspace/' + key + '/')) workspace.set(relative, packageDigest(entry.bytes));
82
+ if (relative.startsWith('agents/' + key + '/personal/soul/') && relative.endsWith('.md')) soul.push(entry.bytes.toString('utf8'));
83
+ const parts = relative.split('/');
84
+ const group = parts[0] === '.evolcore' && parts[1] === 'skills' ? ['skills', parts[2]]
85
+ : parts[0] === 'agents' && parts[1] === key && ['triggers', 'events', 'services'].includes(parts[2]) ? [parts[2], parts[3]] : null;
86
+ if (group) {
87
+ const list = components[group[0]].get(group[1]) ?? [];
88
+ list.push([relative, packageDigest(entry.bytes), entry.mode]); components[group[0]].set(group[1], list);
89
+ }
90
+ }
91
+ for (const kind of Object.keys(components)) for (const [id, files] of components[kind]) {
92
+ components[kind].set(id, contractDigest(files.sort((a, b) => a[0].localeCompare(b[0]))));
93
+ }
94
+ for (const [name, config] of Object.entries(checked.team.agents[0].skills ?? {})) {
95
+ components.skills.set(name, contractDigest([components.skills.get(name) ?? null, config]));
96
+ }
97
+ return { components, workspace, characters: [...soul.join('').replace(/\s/gu, '')].length };
98
+ };
99
+ const before = inventory(previous); const after = inventory(target);
100
+ const compare = (old, next) => ({ added: [...next.keys()].filter(key => !old.has(key)).sort(),
101
+ updated: [...next.keys()].filter(key => old.has(key) && old.get(key) !== next.get(key)).sort(),
102
+ removed: [...old.keys()].filter(key => !next.has(key)).sort() });
103
+ const workspace = compare(before.workspace, after.workspace);
104
+ return { ...base, fromVersion: previous.metadata.version, available: true,
105
+ components: Object.fromEntries(Object.keys(before.components).map(kind => [kind, compare(before.components[kind], after.components[kind])])),
106
+ soul: { fromCharacters: before.characters, toCharacters: after.characters, delta: after.characters - before.characters },
107
+ workspace: Object.fromEntries(Object.entries(workspace).map(([kind, files]) => [kind, files.length])) };
108
+ }
33
109
  function check(value, message, code = 'INVALID_ARGUMENT') {
34
110
  if (!value) throw Object.assign(new Error(message), { code });
35
111
  }
@@ -49,8 +125,7 @@ export function regularAncestors(file) {
49
125
  }
50
126
  }
51
127
  export function excludedResource(name) {
52
- if (name === 'prebuild-members.json') return true;
53
- return name.split('/').some(part => ['.git', 'node_modules', '.claude'].includes(part)
128
+ return name.split('/').some(part => ['.git', 'node_modules', '.claude', '.template-work'].includes(part)
54
129
  || /^\.env/.test(part) || /\.(?:pem|key|db(?:[-.].*)?)$/i.test(part));
55
130
  }
56
131
 
@@ -130,7 +205,8 @@ function extractExternalAids(text, name) {
130
205
 
131
206
  /** Ordered USTAR+gzip, compatible with EvolCore archive(). */
132
207
  export function encodePackageEntries(entries) {
133
- check(entries instanceof Map && entries.size && entries.size <= PACKAGE_LIMITS.entries, 'Invalid package entries');
208
+ check(entries instanceof Map && entries.size, 'Invalid package entries');
209
+ check(entries.size <= PACKAGE_LIMITS.entries, 'Package entry limit exceeded', 'PACKAGE_TOO_LARGE');
134
210
  const blocks = []; let total = 0;
135
211
  for (const [name, entry] of [...entries].sort(([a], [b]) => a.localeCompare(b))) {
136
212
  packagePath(name);
@@ -192,7 +268,7 @@ function portableFile(name, keys) {
192
268
  return group === 'workspace' && !excludedResource(relative)
193
269
  || group === 'agents' && (relative.startsWith('personal/soul/') && relative.endsWith('.md') && !relative.endsWith('/00-GUIDE.md')
194
270
  || relative === 'personal/welcome.md' || relative.startsWith('triggers/') && !excludedResource(relative)
195
- || isPortableEventPackFile(relative) && !excludedResource(relative));
271
+ || (isPortableEventPackFile(relative) || portableServiceFile(relative)) && !excludedResource(relative));
196
272
  }
197
273
 
198
274
  /** Validate all bytes before extracting; never trusts a MANIFEST path for filesystem access. */
@@ -220,8 +296,15 @@ export function inspectTemplatePackage(bytes, { digest } = {}) {
220
296
  check(!errors.length, errors.join('; '));
221
297
  const keys = partitionTeamMembers(team).inlineMembers.map(agent => agent.key);
222
298
  for (const { path: name } of manifest) check(portableFile(name, keys), 'Unsupported portable resource: ' + name);
223
- validateEventPackEntries(new Map([...entries].filter(([name]) => name.startsWith('template/'))
224
- .map(([name, entry]) => [name.slice('template/'.length), entry])), keys);
299
+ const templateEntries = new Map([...entries].filter(([name]) => name.startsWith('template/'))
300
+ .map(([name, entry]) => [name.slice('template/'.length), entry]));
301
+ validateMemberResourceStates(team, new Set(templateEntries.keys()));
302
+ const applied = new Map(templateEntries); materializeMemberResourceStates(team, applied, '');
303
+ for (const [name, entry] of applied) check(entry.bytes.equals(templateEntries.get(name).bytes), 'Member resource enabled mismatch: ' + name);
304
+ validateEventPackEntries(templateEntries, keys);
305
+ if ([...templateEntries.keys()].some(name => /^agents\/[^/]+\/services\//.test(name))) {
306
+ requireServicePackRuntime().validateServiceEntries(templateEntries, keys);
307
+ }
225
308
  return { metadata, team, schema, entries, digest: actual, changes: normalized.changes,
226
309
  resources: manifest.map(({ path: name, size }) => ({ path: name, size })) };
227
310
  }
@@ -231,8 +314,6 @@ export function collectTemplateDirectory(templateDir, memberKey, { includeWorksp
231
314
  regularAncestors(templateDir);
232
315
  const { tpl, errors } = loadTemplate(templateDir, { includeWorkspace });
233
316
  check(!errors.length, errors.join('; '));
234
- const declaredMember = tpl.team.agents.find(agent => agent.key === memberKey);
235
- check(declaredMember?.optional !== true, 'Optional member is an ID reference, not a collectable Agent: ' + memberKey);
236
317
  check(tpl.actualKeys.includes(memberKey), 'Unknown actual directory member: ' + memberKey);
237
318
  const excluded = [];
238
319
  const readOptional = relative => {
@@ -247,9 +328,10 @@ export function collectTemplateDirectory(templateDir, memberKey, { includeWorksp
247
328
  baseagents: { ...defaults.baseagents, ...member.config?.baseagents } };
248
329
  const config = {};
249
330
  for (const name of ['chatmode', 'memory']) if (source[name] !== undefined) config[name] = source[name];
250
- if (Object.hasOwn(member.config ?? {}, 'access')) config.access = validateAccessDeclaration(member.config.access);
251
331
  config.active_baseagent = source.active_baseagent ?? 'claude'; config.baseagents = {};
252
- for (const [name, sourceBlock] of Object.entries(source.baseagents)) {
332
+ for (const name of [config.active_baseagent]) {
333
+ const sourceBlock = source.baseagents[name];
334
+ check(record(sourceBlock), 'Default baseagent must have a binding: ' + memberKey);
253
335
  const block = { ...defaults.baseagents?.[name], ...sourceBlock };
254
336
  check(BASEAGENTS.includes(name) && record(block), 'Invalid baseagent block');
255
337
  const ref = typeof block.provider === 'string' ? { id: block.provider, name: providers[block.provider]?.name ?? block.provider } : block.provider;
@@ -271,11 +353,12 @@ export function collectTemplateDirectory(templateDir, memberKey, { includeWorksp
271
353
  if (!portableFile(name, [memberKey])) { excluded.push(name); continue; }
272
354
  entries.set(name, { bytes, mode: stat.mode & 0o777 });
273
355
  }
274
- const resources = { baseagents: Object.keys(config.baseagents).sort(), triggers: [], events: [], skills: [], files: [] };
356
+ const resources = { baseagents: Object.keys(config.baseagents).sort(), triggers: [], events: [], services: [], skills: [], files: [] };
275
357
  for (const name of entries.keys()) {
276
358
  if (name.startsWith('workspace/' + memberKey + '/')) resources.files.push(name.slice(('workspace/' + memberKey + '/').length));
277
359
  if (name.startsWith('agents/' + memberKey + '/triggers/')) resources.triggers.push(name.split('/')[3]);
278
360
  if (name.startsWith('agents/' + memberKey + '/events/')) resources.events.push(name.split('/')[3]);
361
+ if (name.startsWith('agents/' + memberKey + '/services/')) resources.services.push(name.split('/')[3]);
279
362
  if (name.startsWith('.evolcore/skills/')) resources.skills.push(name.split('/')[2]);
280
363
  }
281
364
  resources.skills.push(...Object.keys(member.skills ?? {}));
@@ -285,27 +368,47 @@ export function collectTemplateDirectory(templateDir, memberKey, { includeWorksp
285
368
  defaultBaseagent: config.active_baseagent, warnings: [] };
286
369
  }
287
370
 
371
+ /** File inventories are derived from package entries, not portable member declarations. */
372
+ function excludeResourceInventories(team, excluded) {
373
+ if (Object.hasOwn(team, 'resources')) {
374
+ delete team.resources;
375
+ excluded.push('resources');
376
+ }
377
+ for (const member of team.agents) if (Object.hasOwn(member, 'resources')) {
378
+ delete member.resources;
379
+ excluded.push('agents/' + member.key + '/resources');
380
+ }
381
+ }
382
+
288
383
  /** One pure package planner for both runtime-agent and directory collection adapters. */
289
384
  export function buildTemplatePackage({ metadata, members, externalAids = [], publisher, createdAt, evolcoreRange = '>=0.0.43-test.8',
290
- memberReferences: references = { optional: [], external: [] }, externalContacts, assistantKey }) {
385
+ memberReferences: references = { external: [] }, externalContacts, assistantKey, onProgress }) {
386
+ onProgress?.('validating');
291
387
  const team = { $schema_version: 1, id: metadata.id, title: metadata.name, version: metadata.version,
292
388
  ...(metadata.description !== undefined ? { description: metadata.description } : {}), host: { platform: structuredClone(metadata.platforms) }, agents: [] };
293
389
  const entries = new Map(); const excluded = []; const external = new Set(externalAids);
294
390
  for (const [key, collected] of Object.entries(members)) {
295
391
  const { member, include } = collected;
296
392
  check(record(member) && record(include), 'Collected member and selection required');
297
- if (member.optional === true) {
298
- check(collected.entries instanceof Map && collected.entries.size === 0, 'Optional references cannot carry executable resources');
299
- team.agents.push({ ...structuredClone(member), key });
300
- continue;
301
- }
302
393
  check(include.baseagents.includes(member.config?.active_baseagent), 'Default baseagent is required: ' + key);
303
394
  const chosen = structuredClone(member);
304
395
  Object.assign(chosen, resolveMemberParameters(chosen));
396
+ if (Object.keys(members).length === 1 && /^[a-z0-9][a-z0-9-]*(\.[a-z0-9][a-z0-9-]*){2,}$/.test(key)) {
397
+ check(!chosen.version || chosen.version === metadata.version, 'Single Agent author version conflicts with package version', 'VERSION_CONFLICT');
398
+ check(typeof publisher?.aid === 'string' && new RegExp(AID_PATTERN).test(publisher.aid), 'Single Agent package publisher required');
399
+ chosen.version = metadata.version;
400
+ }
401
+ if (Object.hasOwn(chosen.config, 'access')) {
402
+ delete chosen.config.access; excluded.push('agents/' + key + '/config/access');
403
+ }
305
404
  assertPublicTemplateConfig(chosen.config);
306
405
  for (const field of ['version', 'update']) delete chosen.config[field];
307
- chosen.config.baseagents = Object.fromEntries(Object.entries(chosen.config.baseagents).filter(([name]) => include.baseagents.includes(name)));
406
+ chosen.config.baseagents = Object.fromEntries(Object.entries(chosen.config.baseagents)
407
+ .filter(([name]) => name === chosen.config.active_baseagent));
308
408
  chosen.skills = Object.fromEntries(Object.entries(chosen.skills ?? {}).filter(([name]) => include.skills.includes(name)));
409
+ for (const kind of MEMBER_RESOURCE_KINDS) if (chosen[kind] !== undefined) {
410
+ chosen[kind] = Object.fromEntries(Object.entries(chosen[kind]).filter(([id]) => (include[kind] ?? []).includes(id)));
411
+ }
309
412
  team.agents.push({ ...chosen, key });
310
413
  excluded.push(...(collected.excluded ?? []));
311
414
  for (const [name, entry] of collected.entries) {
@@ -314,15 +417,15 @@ export function buildTemplatePackage({ metadata, members, externalAids = [], pub
314
417
  const selected = name.startsWith('workspace/') ? include.files.includes(name.slice(('workspace/' + key + '/').length))
315
418
  : name.startsWith('.evolcore/skills/') ? include.skills.includes(name.split('/')[2])
316
419
  : name.startsWith('agents/' + key + '/triggers/') ? include.triggers.includes(name.split('/')[3])
317
- : name.startsWith('agents/' + key + '/events/') ? (include.events ?? []).includes(name.split('/')[3]) : true;
420
+ : name.startsWith('agents/' + key + '/events/') ? (include.events ?? []).includes(name.split('/')[3])
421
+ : name.startsWith('agents/' + key + '/services/') ? (include.services ?? []).includes(name.split('/')[3]) : true;
318
422
  if (!selected) { excluded.push(name); continue; }
319
423
  const target = 'template/' + name;
320
424
  if (entries.has(target)) check(entries.get(target).bytes.equals(entry.bytes) && entries.get(target).mode === entry.mode, 'Conflicting shared resource', 'SOURCE_CHANGED');
321
425
  entries.set(target, { bytes: Buffer.from(entry.bytes), mode: entry.mode });
322
426
  }
323
427
  }
324
- check(record(references) && Array.isArray(references.optional) && Array.isArray(references.external), 'Invalid member references');
325
- team.agents.push(...structuredClone(references.optional));
428
+ check(record(references) && Object.keys(references).every(key => key === 'external') && Array.isArray(references.external), 'Invalid external contact references');
326
429
  if (references.external.length) team.external_contacts = structuredClone(references.external);
327
430
  if (externalContacts !== undefined) {
328
431
  check(Array.isArray(externalContacts), 'externalContacts must be an array');
@@ -333,25 +436,35 @@ export function buildTemplatePackage({ metadata, members, externalAids = [], pub
333
436
  team.personal_assistant = team.agents.findIndex(member => member.key === assistantKey);
334
437
  check(team.personal_assistant >= 0, 'Unknown personal assistant key');
335
438
  }
439
+ excludeResourceInventories(team, excluded);
336
440
  const normalized = normalizeTeam(team);
337
441
  check(!normalized.errors.length, normalized.errors.join('; '));
338
442
  entries.set('template/team.json', { bytes: json(team), mode: 0o644 });
339
443
  entries.set('template/team.schema.json', { bytes: json(readTeamSchema()), mode: 0o644 });
444
+ let collectedBytes = 0; const collectedNames = new Set();
445
+ check(entries.size + 2 <= PACKAGE_LIMITS.entries, 'Package entry limit exceeded', 'PACKAGE_TOO_LARGE');
446
+ for (const [name, entry] of entries) {
447
+ collectedBytes += entry.bytes.length;
448
+ check(entry.bytes.length <= PACKAGE_LIMITS.file && collectedBytes <= PACKAGE_LIMITS.total, 'Package size limit exceeded', 'PACKAGE_TOO_LARGE');
449
+ check(!collectedNames.has(name.toLowerCase()), 'Duplicate package paths', 'INTEGRITY_FAILED'); collectedNames.add(name.toLowerCase());
450
+ check(Buffer.byteLength(name) <= 100 || [...name.matchAll(/\//g)].some(match =>
451
+ Buffer.byteLength(name.slice(match.index + 1)) <= 100 && Buffer.byteLength(name.slice(0, match.index)) <= 155), 'Archive path too long');
452
+ }
340
453
  let memberReferences = false;
341
454
  for (const [name, entry] of entries) {
455
+ assertPortableText(name, entry.bytes);
342
456
  if (entry.bytes.includes(0) || !Buffer.from(entry.bytes.toString('utf8')).equals(entry.bytes)) continue;
343
457
  for (const line of entry.bytes.toString('utf8').split('\n')) {
344
458
  memberReferences ||= /\{\{\s*members\./.test(line);
345
- check(!/(?:sk-[A-Za-z0-9_-]{16,}|ghp_[A-Za-z0-9]{20,}|AKIA[A-Z0-9]{16}|-----BEGIN .*PRIVATE KEY|(?:API_KEY|TOKEN|SECRET|PASSWORD)\s*=\s*(?!\$\{)\S{8,})/i.test(line),
346
- 'Credential content in portable resource: ' + name, 'SCAN_BLOCKED');
347
459
  }
348
460
  for (const aid of extractExternalAids(entry.bytes.toString('utf8'), name)) external.add(aid);
349
461
  }
462
+ for (const member of team.agents) external.delete(member.key);
350
463
  if (memberReferences && evolcoreRange === '>=0.0.43-test.8') evolcoreRange = '>=0.0.43-test.8 <0.0.43 || >=0.0.44';
351
464
  const templateFeatures = [
352
465
  ...(memberReferences ? ['member-references-v1'] : []),
353
- ...(team.agents.some(member => member.optional) || team.external_contacts?.length ? ['optional-members-v1'] : []),
354
466
  ...([...entries.keys()].some(name => /^template\/agents\/[^/]+\/events\//.test(name)) ? ['event-packs-v1'] : []),
467
+ ...([...entries.keys()].some(name => /^template\/agents\/[^/]+\/services\//.test(name)) ? ['service-packs-v1'] : []),
355
468
  ];
356
469
  const info = { $schema_version: 1, id: metadata.id, name: metadata.name, version: metadata.version,
357
470
  ...(publisher !== undefined ? { publisher: structuredClone(publisher) } : {}), ...(createdAt !== undefined ? { createdAt } : {}),
@@ -360,15 +473,18 @@ export function buildTemplatePackage({ metadata, members, externalAids = [], pub
360
473
  ...(templateFeatures.length ? { templateFeatures } : {}),
361
474
  baseagents: [...new Set(team.agents.flatMap(member => Object.keys(member.config?.baseagents ?? {})))].sort() },
362
475
  externalAids: [...external].sort() };
476
+ materializeMemberResourceStates(team, entries);
363
477
  const manifest = [...entries].map(([name, entry]) => ({ path: name.slice('template/'.length), size: entry.bytes.length, sha256: packageDigest(entry.bytes).slice(7) }));
364
478
  entries.set('PACKAGE.json', { bytes: json(info), mode: 0o644 });
365
479
  entries.set('MANIFEST.json', { bytes: json(manifest), mode: 0o644 });
480
+ onProgress?.('sealing');
366
481
  const bytes = encodePackageEntries(entries);
367
482
  inspectTemplatePackage(bytes);
368
483
  return { bytes, metadata: info, digest: packageDigest(bytes), excluded: [...new Set(excluded)].sort(),
369
484
  scan: { findings: [] }, filename: metadata.id + '-' + metadata.version + '.ectpl' };
370
485
  }
371
486
 
487
+
372
488
  /** Export behavior/resources only; credentials and host infrastructure never enter the share package. */
373
489
  export function exportTemplatePackage(templateDir, { publisher, createdAt = Date.now(), evolcoreRange = '>=0.0.43' } = {}) {
374
490
  regularAncestors(templateDir);
@@ -384,15 +500,15 @@ export function exportTemplatePackage(templateDir, { publisher, createdAt = Date
384
500
  if (team.host.config !== undefined) { delete team.host.config; excluded.push('host.config'); }
385
501
  if (team.host.name !== undefined) { delete team.host.name; excluded.push('host.name'); }
386
502
  for (const agent of team.agents) {
387
- if (agent.optional === true) continue;
388
503
  Object.assign(agent, resolveMemberParameters(agent));
389
504
  const source = { ...structuredClone(defaults), ...agent.config,
390
505
  baseagents: { ...defaults.baseagents, ...agent.config?.baseagents } };
391
506
  const config = {};
392
507
  for (const name of ['chatmode', 'memory']) if (source[name] !== undefined) config[name] = source[name];
393
- if (Object.hasOwn(agent.config ?? {}, 'access')) config.access = validateAccessDeclaration(agent.config.access);
394
508
  config.active_baseagent = source.active_baseagent ?? 'claude'; config.baseagents = {};
395
- for (const [name, sourceBlock] of Object.entries(source.baseagents)) {
509
+ for (const name of [config.active_baseagent]) {
510
+ const sourceBlock = source.baseagents[name];
511
+ check(record(sourceBlock), 'Default baseagent must have a binding: ' + agent.key);
396
512
  const block = { ...defaults.baseagents?.[name], ...sourceBlock };
397
513
  check(BASEAGENTS.includes(name) && record(block), 'Invalid baseagent block');
398
514
  const ref = typeof block.provider === 'string' ? { id: block.provider, name: providers[block.provider]?.name ?? block.provider } : block.provider;
@@ -407,6 +523,7 @@ export function exportTemplatePackage(templateDir, { publisher, createdAt = Date
407
523
  assertPublicTemplateConfig(config);
408
524
  }
409
525
  // The directory's custom constraints belong to its authoring form. Portable fields use the common schema.
526
+ excludeResourceInventories(team, excluded);
410
527
  const normalized = normalizeTeam(team);
411
528
  check(!normalized.errors.length, normalized.errors.join('; '));
412
529
  const entries = new Map();
@@ -422,27 +539,28 @@ export function exportTemplatePackage(templateDir, { publisher, createdAt = Date
422
539
  const external = new Set();
423
540
  let memberReferences = false;
424
541
  for (const [name, entry] of entries) {
542
+ assertPortableText(name, entry.bytes);
425
543
  if (entry.bytes.includes(0) || !Buffer.from(entry.bytes.toString('utf8')).equals(entry.bytes)) continue;
426
544
  for (const line of entry.bytes.toString('utf8').split('\n')) {
427
545
  memberReferences ||= /\{\{\s*members\./.test(line);
428
- check(!/(?:sk-[A-Za-z0-9_-]{16,}|ghp_[A-Za-z0-9]{20,}|AKIA[A-Z0-9]{16}|-----BEGIN .*PRIVATE KEY|(?:API_KEY|TOKEN|SECRET|PASSWORD)\s*=\s*(?!\$\{)\S{8,})/i.test(line),
429
- 'Credential content in portable resource: ' + name, 'SENSITIVE_CONTENT');
430
546
  }
431
547
  for (const aid of extractExternalAids(entry.bytes.toString('utf8'), name)) external.add(aid);
432
548
  }
433
549
  // Older readers normalize test builds to the final version. The upper bound
550
+ for (const member of team.agents) external.delete(member.key);
434
551
  // makes those readers reject member references instead of leaving old AIDs.
435
552
  if (memberReferences && evolcoreRange === '>=0.0.43') evolcoreRange = '>=0.0.43-test.8 <0.0.43 || >=0.0.44';
436
553
  const templateFeatures = [
437
554
  ...(memberReferences ? ['member-references-v1'] : []),
438
- ...(team.agents.some(member => member.optional) || team.external_contacts?.length ? ['optional-members-v1'] : []),
439
555
  ...([...entries.keys()].some(name => /^template\/agents\/[^/]+\/events\//.test(name)) ? ['event-packs-v1'] : []),
556
+ ...([...entries.keys()].some(name => /^template\/agents\/[^/]+\/services\//.test(name)) ? ['service-packs-v1'] : []),
440
557
  ];
441
558
  const metadata = { $schema_version: 1, id: team.id, name: team.title ?? team.id, version: team.version,
442
559
  ...(team.description !== undefined ? { description: team.description } : {}), ...(publisher ? { publisher } : {}), createdAt,
443
560
  compat: { platforms: team.host.platform, evolcore: evolcoreRange,
444
561
  ...(templateFeatures.length ? { templateFeatures } : {}),
445
562
  baseagents: [...new Set(team.agents.flatMap(agent => Object.keys(agent.config?.baseagents ?? {})))] }, externalAids: [...external].sort() };
563
+ materializeMemberResourceStates(team, entries);
446
564
  const manifest = [...entries].map(([name, entry]) => ({ path: name.slice('template/'.length), size: entry.bytes.length, sha256: packageDigest(entry.bytes).slice(7) }));
447
565
  entries.set('PACKAGE.json', { bytes: json(metadata), mode: 0o644 });
448
566
  entries.set('MANIFEST.json', { bytes: json(manifest), mode: 0o644 });
@@ -500,7 +618,6 @@ export function attachBuildEnvironment(templateDir, sourceDir) {
500
618
  if (base.tpl.team.host.name !== undefined) team.host.name = base.tpl.team.host.name;
501
619
  team.host.config = structuredClone(base.tpl.team.host.config ?? {});
502
620
  team.host.config.aun = { ...team.host.config.aun, defaultAidDomain: resolveTemplateAidDomain(base.tpl.team) };
503
- delete team.issuer;
504
621
  for (const name of ['providers.json', 'agents/defaults.json', '.env']) {
505
622
  const source = path.join(base.tpl.root, '.evolcore', ...name.split('/'));
506
623
  if (!fs.existsSync(source)) continue;
@@ -520,7 +637,7 @@ export function templateProviderSummary(templateDir) {
520
637
  }
521
638
 
522
639
  const EVENT_PACK_NAME_PATTERN = /^[a-z0-9][a-z0-9_-]{0,63}$/;
523
- const TEMPLATE_EVENT_BUS_PATTERN = /^\{\{\s*(?:members\.[a-z0-9][a-z0-9_-]{0,31}\.aid|(?:agent|owner|host)\.aid)\s*\}\}$/;
640
+ const TEMPLATE_EVENT_BUS_PATTERN = /^\{\{\s*(?:members\.[a-z0-9][a-z0-9_.-]*\.aid|(?:agent|owner|host)\.aid)\s*\}\}$/;
524
641
 
525
642
  /** Share package definitions/assets, never runtime state, logs, backups or caches. */
526
643
  export function isPortableEventPackResource(relative) {
@@ -572,11 +689,11 @@ function eventPackFiles(root) {
572
689
  }
573
690
 
574
691
  /** Read-only inventory: loading must not create logs or migrate source files. */
575
- export function readEventPacks(eventsDir, { template = false } = {}) {
692
+ export function readEventPacks(eventsDir, { template = false, ids } = {}) {
576
693
  if (!fs.existsSync(eventsDir)) return [];
577
694
  regularAncestors(eventsDir);
578
695
  return fs.readdirSync(eventsDir, { withFileTypes: true }).sort((a, b) => a.name.localeCompare(b.name))
579
- .filter(entry => !entry.name.startsWith('.') && !entry.name.startsWith('_'))
696
+ .filter(entry => !entry.name.startsWith('.') && !entry.name.startsWith('_') && (!ids || ids.includes(entry.name)))
580
697
  .flatMap(entry => {
581
698
  check(!entry.isSymbolicLink(), 'Symbolic event pack: ' + entry.name);
582
699
  if (!entry.isDirectory()) return [];