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
@@ -6,15 +6,106 @@ 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 } from './template-runtime.mjs';
10
- import { validatePackJson } from '../../../dist/event-center/validation.js';
11
- import { PACK_RUNTIME_ENTRIES } from '../../../dist/core/pack-install.js';
12
- import { assert, inside, readJson, regularPath, sha256, walkFiles } from './common.mjs';
9
+ import { BASEAGENTS, assertPublicTemplateConfig, resolveMemberParameters, partitionTeamMembers,
10
+ MEMBER_RESOURCE_KINDS, validateMemberResourceStates, materializeMemberResourceStates } from './template-runtime.mjs';
13
11
 
14
12
  export const PACKAGE_LIMITS = { file: 20 * 1024 * 1024, total: 200 * 1024 * 1024, entries: 20000 };
15
13
  const record = value => value !== null && typeof value === 'object' && !Array.isArray(value);
16
14
  const json = value => Buffer.from(JSON.stringify(value, null, 2) + '\n');
15
+ let eventPackRuntime;
16
+ let servicePackRuntime;
17
+ const eventValidator = new URL('../../../dist/event-center/validation.js', import.meta.url);
18
+ const eventInstaller = new URL('../../../dist/core/pack/pack-install.js', import.meta.url);
19
+ if (fs.existsSync(eventValidator) && fs.existsSync(eventInstaller)) {
20
+ const [validation, installation] = await Promise.all([import(eventValidator.href), import(eventInstaller.href)]);
21
+ configureTemplateEventPacks({ validatePackJson: validation.validatePackJson, runtimeEntries: installation.PACK_RUNTIME_ENTRIES });
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
+ }
28
+
29
+ /** Standalone consumers inject the real Core validator only when consuming event packs. */
30
+ export function configureTemplateEventPacks({ validatePackJson, runtimeEntries }) {
31
+ check(typeof validatePackJson === 'function' && (runtimeEntries instanceof Set || Array.isArray(runtimeEntries))
32
+ && [...runtimeEntries].every(name => typeof name === 'string'), 'Real Core event-pack validation and runtime entries required');
33
+ eventPackRuntime = { validatePackJson, runtimeEntries: new Set(runtimeEntries) };
34
+ }
35
+ function requireEventPackRuntime() {
36
+ check(eventPackRuntime, 'Core event-pack validator unavailable; configureTemplateEventPacks with the installed Core runtime', 'EVENT_VALIDATOR_UNAVAILABLE');
37
+ return eventPackRuntime;
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
+ }
17
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
+ }
18
109
  function check(value, message, code = 'INVALID_ARGUMENT') {
19
110
  if (!value) throw Object.assign(new Error(message), { code });
20
111
  }
@@ -34,7 +125,7 @@ export function regularAncestors(file) {
34
125
  }
35
126
  }
36
127
  export function excludedResource(name) {
37
- 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)
38
129
  || /^\.env/.test(part) || /\.(?:pem|key|db(?:[-.].*)?)$/i.test(part));
39
130
  }
40
131
 
@@ -114,7 +205,8 @@ function extractExternalAids(text, name) {
114
205
 
115
206
  /** Ordered USTAR+gzip, compatible with EvolCore archive(). */
116
207
  export function encodePackageEntries(entries) {
117
- 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');
118
210
  const blocks = []; let total = 0;
119
211
  for (const [name, entry] of [...entries].sort(([a], [b]) => a.localeCompare(b))) {
120
212
  packagePath(name);
@@ -176,7 +268,7 @@ function portableFile(name, keys) {
176
268
  return group === 'workspace' && !excludedResource(relative)
177
269
  || group === 'agents' && (relative.startsWith('personal/soul/') && relative.endsWith('.md') && !relative.endsWith('/00-GUIDE.md')
178
270
  || relative === 'personal/welcome.md' || relative.startsWith('triggers/') && !excludedResource(relative)
179
- || isPortableEventPackFile(relative) && !excludedResource(relative));
271
+ || (isPortableEventPackFile(relative) || portableServiceFile(relative)) && !excludedResource(relative));
180
272
  }
181
273
 
182
274
  /** Validate all bytes before extracting; never trusts a MANIFEST path for filesystem access. */
@@ -202,20 +294,27 @@ export function inspectTemplatePackage(bytes, { digest } = {}) {
202
294
  const team = normalized.team; const schema = normalizeTeamSchema(read('template/team.schema.json'));
203
295
  const errors = validateContractSchema(team, schema);
204
296
  check(!errors.length, errors.join('; '));
205
- const keys = team.agents.map(agent => agent.key);
297
+ const keys = partitionTeamMembers(team).inlineMembers.map(agent => agent.key);
206
298
  for (const { path: name } of manifest) check(portableFile(name, keys), 'Unsupported portable resource: ' + name);
207
- validateEventPackEntries(new Map([...entries].filter(([name]) => name.startsWith('template/'))
208
- .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
+ }
209
308
  return { metadata, team, schema, entries, digest: actual, changes: normalized.changes,
210
309
  resources: manifest.map(({ path: name, size }) => ({ path: name, size })) };
211
310
  }
212
311
 
213
312
  /** Directory adapter: reads exactly one keyed member and snapshots all source bytes/permissions. */
214
- export function collectTemplateDirectory(templateDir, memberKey) {
313
+ export function collectTemplateDirectory(templateDir, memberKey, { includeWorkspace = true } = {}) {
215
314
  regularAncestors(templateDir);
216
- const { tpl, errors } = loadTemplate(templateDir);
315
+ const { tpl, errors } = loadTemplate(templateDir, { includeWorkspace });
217
316
  check(!errors.length, errors.join('; '));
218
- check(tpl.keys.includes(memberKey), 'Unknown directory member: ' + memberKey);
317
+ check(tpl.actualKeys.includes(memberKey), 'Unknown actual directory member: ' + memberKey);
219
318
  const excluded = [];
220
319
  const readOptional = relative => {
221
320
  const file = path.join(tpl.root, ...relative.split('/'));
@@ -230,7 +329,9 @@ export function collectTemplateDirectory(templateDir, memberKey) {
230
329
  const config = {};
231
330
  for (const name of ['chatmode', 'memory']) if (source[name] !== undefined) config[name] = source[name];
232
331
  config.active_baseagent = source.active_baseagent ?? 'claude'; config.baseagents = {};
233
- 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);
234
335
  const block = { ...defaults.baseagents?.[name], ...sourceBlock };
235
336
  check(BASEAGENTS.includes(name) && record(block), 'Invalid baseagent block');
236
337
  const ref = typeof block.provider === 'string' ? { id: block.provider, name: providers[block.provider]?.name ?? block.provider } : block.provider;
@@ -252,11 +353,12 @@ export function collectTemplateDirectory(templateDir, memberKey) {
252
353
  if (!portableFile(name, [memberKey])) { excluded.push(name); continue; }
253
354
  entries.set(name, { bytes, mode: stat.mode & 0o777 });
254
355
  }
255
- 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: [] };
256
357
  for (const name of entries.keys()) {
257
358
  if (name.startsWith('workspace/' + memberKey + '/')) resources.files.push(name.slice(('workspace/' + memberKey + '/').length));
258
359
  if (name.startsWith('agents/' + memberKey + '/triggers/')) resources.triggers.push(name.split('/')[3]);
259
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]);
260
362
  if (name.startsWith('.evolcore/skills/')) resources.skills.push(name.split('/')[2]);
261
363
  }
262
364
  resources.skills.push(...Object.keys(member.skills ?? {}));
@@ -266,9 +368,23 @@ export function collectTemplateDirectory(templateDir, memberKey) {
266
368
  defaultBaseagent: config.active_baseagent, warnings: [] };
267
369
  }
268
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
+
269
383
  /** One pure package planner for both runtime-agent and directory collection adapters. */
270
- export function buildTemplatePackage({ metadata, members, externalAids = [], publisher, createdAt, evolcoreRange = '>=0.0.43-test.8' }) {
271
- const team = { $schema_version: 1, id: metadata.id, name: metadata.id, title: metadata.name, version: metadata.version,
384
+ export function buildTemplatePackage({ metadata, members, externalAids = [], publisher, createdAt, evolcoreRange = '>=0.0.43-test.8',
385
+ memberReferences: references = { external: [] }, externalContacts, assistantKey, onProgress }) {
386
+ onProgress?.('validating');
387
+ const team = { $schema_version: 1, id: metadata.id, title: metadata.name, version: metadata.version,
272
388
  ...(metadata.description !== undefined ? { description: metadata.description } : {}), host: { platform: structuredClone(metadata.platforms) }, agents: [] };
273
389
  const entries = new Map(); const excluded = []; const external = new Set(externalAids);
274
390
  for (const [key, collected] of Object.entries(members)) {
@@ -277,10 +393,22 @@ export function buildTemplatePackage({ metadata, members, externalAids = [], pub
277
393
  check(include.baseagents.includes(member.config?.active_baseagent), 'Default baseagent is required: ' + key);
278
394
  const chosen = structuredClone(member);
279
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
+ }
280
404
  assertPublicTemplateConfig(chosen.config);
281
405
  for (const field of ['version', 'update']) delete chosen.config[field];
282
- 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));
283
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
+ }
284
412
  team.agents.push({ ...chosen, key });
285
413
  excluded.push(...(collected.excluded ?? []));
286
414
  for (const [name, entry] of collected.entries) {
@@ -289,48 +417,74 @@ export function buildTemplatePackage({ metadata, members, externalAids = [], pub
289
417
  const selected = name.startsWith('workspace/') ? include.files.includes(name.slice(('workspace/' + key + '/').length))
290
418
  : name.startsWith('.evolcore/skills/') ? include.skills.includes(name.split('/')[2])
291
419
  : name.startsWith('agents/' + key + '/triggers/') ? include.triggers.includes(name.split('/')[3])
292
- : 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;
293
422
  if (!selected) { excluded.push(name); continue; }
294
423
  const target = 'template/' + name;
295
424
  if (entries.has(target)) check(entries.get(target).bytes.equals(entry.bytes) && entries.get(target).mode === entry.mode, 'Conflicting shared resource', 'SOURCE_CHANGED');
296
425
  entries.set(target, { bytes: Buffer.from(entry.bytes), mode: entry.mode });
297
426
  }
298
427
  }
428
+ check(record(references) && Object.keys(references).every(key => key === 'external') && Array.isArray(references.external), 'Invalid external contact references');
429
+ if (references.external.length) team.external_contacts = structuredClone(references.external);
430
+ if (externalContacts !== undefined) {
431
+ check(Array.isArray(externalContacts), 'externalContacts must be an array');
432
+ check(!references.external.length || canonicalJson(references.external) === canonicalJson(externalContacts), 'Conflicting external contact declarations');
433
+ team.external_contacts = structuredClone(externalContacts);
434
+ }
435
+ if (assistantKey !== undefined) {
436
+ team.personal_assistant = team.agents.findIndex(member => member.key === assistantKey);
437
+ check(team.personal_assistant >= 0, 'Unknown personal assistant key');
438
+ }
439
+ excludeResourceInventories(team, excluded);
299
440
  const normalized = normalizeTeam(team);
300
441
  check(!normalized.errors.length, normalized.errors.join('; '));
301
442
  entries.set('template/team.json', { bytes: json(team), mode: 0o644 });
302
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
+ }
303
453
  let memberReferences = false;
304
454
  for (const [name, entry] of entries) {
455
+ assertPortableText(name, entry.bytes);
305
456
  if (entry.bytes.includes(0) || !Buffer.from(entry.bytes.toString('utf8')).equals(entry.bytes)) continue;
306
457
  for (const line of entry.bytes.toString('utf8').split('\n')) {
307
458
  memberReferences ||= /\{\{\s*members\./.test(line);
308
- 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),
309
- 'Credential content in portable resource: ' + name, 'SCAN_BLOCKED');
310
459
  }
311
460
  for (const aid of extractExternalAids(entry.bytes.toString('utf8'), name)) external.add(aid);
312
461
  }
462
+ for (const member of team.agents) external.delete(member.key);
313
463
  if (memberReferences && evolcoreRange === '>=0.0.43-test.8') evolcoreRange = '>=0.0.43-test.8 <0.0.43 || >=0.0.44';
314
464
  const templateFeatures = [
315
465
  ...(memberReferences ? ['member-references-v1'] : []),
316
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'] : []),
317
468
  ];
318
469
  const info = { $schema_version: 1, id: metadata.id, name: metadata.name, version: metadata.version,
319
470
  ...(publisher !== undefined ? { publisher: structuredClone(publisher) } : {}), ...(createdAt !== undefined ? { createdAt } : {}),
320
471
  ...(metadata.description !== undefined ? { description: metadata.description } : {}),
321
472
  compat: { platforms: structuredClone(metadata.platforms), evolcore: evolcoreRange,
322
473
  ...(templateFeatures.length ? { templateFeatures } : {}),
323
- baseagents: [...new Set(team.agents.flatMap(member => Object.keys(member.config.baseagents)))].sort() },
474
+ baseagents: [...new Set(team.agents.flatMap(member => Object.keys(member.config?.baseagents ?? {})))].sort() },
324
475
  externalAids: [...external].sort() };
476
+ materializeMemberResourceStates(team, entries);
325
477
  const manifest = [...entries].map(([name, entry]) => ({ path: name.slice('template/'.length), size: entry.bytes.length, sha256: packageDigest(entry.bytes).slice(7) }));
326
478
  entries.set('PACKAGE.json', { bytes: json(info), mode: 0o644 });
327
479
  entries.set('MANIFEST.json', { bytes: json(manifest), mode: 0o644 });
480
+ onProgress?.('sealing');
328
481
  const bytes = encodePackageEntries(entries);
329
482
  inspectTemplatePackage(bytes);
330
483
  return { bytes, metadata: info, digest: packageDigest(bytes), excluded: [...new Set(excluded)].sort(),
331
484
  scan: { findings: [] }, filename: metadata.id + '-' + metadata.version + '.ectpl' };
332
485
  }
333
486
 
487
+
334
488
  /** Export behavior/resources only; credentials and host infrastructure never enter the share package. */
335
489
  export function exportTemplatePackage(templateDir, { publisher, createdAt = Date.now(), evolcoreRange = '>=0.0.43' } = {}) {
336
490
  regularAncestors(templateDir);
@@ -344,6 +498,7 @@ export function exportTemplatePackage(templateDir, { publisher, createdAt = Date
344
498
  const defaults = readOptional('.evolcore/agents/defaults.json');
345
499
  const providers = readOptional('.evolcore/providers.json').providers ?? {};
346
500
  if (team.host.config !== undefined) { delete team.host.config; excluded.push('host.config'); }
501
+ if (team.host.name !== undefined) { delete team.host.name; excluded.push('host.name'); }
347
502
  for (const agent of team.agents) {
348
503
  Object.assign(agent, resolveMemberParameters(agent));
349
504
  const source = { ...structuredClone(defaults), ...agent.config,
@@ -351,7 +506,9 @@ export function exportTemplatePackage(templateDir, { publisher, createdAt = Date
351
506
  const config = {};
352
507
  for (const name of ['chatmode', 'memory']) if (source[name] !== undefined) config[name] = source[name];
353
508
  config.active_baseagent = source.active_baseagent ?? 'claude'; config.baseagents = {};
354
- 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);
355
512
  const block = { ...defaults.baseagents?.[name], ...sourceBlock };
356
513
  check(BASEAGENTS.includes(name) && record(block), 'Invalid baseagent block');
357
514
  const ref = typeof block.provider === 'string' ? { id: block.provider, name: providers[block.provider]?.name ?? block.provider } : block.provider;
@@ -366,13 +523,14 @@ export function exportTemplatePackage(templateDir, { publisher, createdAt = Date
366
523
  assertPublicTemplateConfig(config);
367
524
  }
368
525
  // The directory's custom constraints belong to its authoring form. Portable fields use the common schema.
526
+ excludeResourceInventories(team, excluded);
369
527
  const normalized = normalizeTeam(team);
370
528
  check(!normalized.errors.length, normalized.errors.join('; '));
371
529
  const entries = new Map();
372
530
  for (const relative of tpl.files) {
373
531
  const name = relative.split(path.sep).join('/');
374
532
  if (['team.json', 'team.schema.json'].includes(name)) continue;
375
- if (!portableFile(name, tpl.keys)) { excluded.push(name); continue; }
533
+ if (!portableFile(name, tpl.actualKeys)) { excluded.push(name); continue; }
376
534
  const file = path.join(tpl.root, relative);
377
535
  entries.set('template/' + name, { bytes: fs.readFileSync(file), mode: fs.statSync(file).mode & 0o777 });
378
536
  }
@@ -381,26 +539,28 @@ export function exportTemplatePackage(templateDir, { publisher, createdAt = Date
381
539
  const external = new Set();
382
540
  let memberReferences = false;
383
541
  for (const [name, entry] of entries) {
542
+ assertPortableText(name, entry.bytes);
384
543
  if (entry.bytes.includes(0) || !Buffer.from(entry.bytes.toString('utf8')).equals(entry.bytes)) continue;
385
544
  for (const line of entry.bytes.toString('utf8').split('\n')) {
386
545
  memberReferences ||= /\{\{\s*members\./.test(line);
387
- 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),
388
- 'Credential content in portable resource: ' + name, 'SENSITIVE_CONTENT');
389
546
  }
390
547
  for (const aid of extractExternalAids(entry.bytes.toString('utf8'), name)) external.add(aid);
391
548
  }
392
549
  // Older readers normalize test builds to the final version. The upper bound
550
+ for (const member of team.agents) external.delete(member.key);
393
551
  // makes those readers reject member references instead of leaving old AIDs.
394
552
  if (memberReferences && evolcoreRange === '>=0.0.43') evolcoreRange = '>=0.0.43-test.8 <0.0.43 || >=0.0.44';
395
553
  const templateFeatures = [
396
554
  ...(memberReferences ? ['member-references-v1'] : []),
397
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'] : []),
398
557
  ];
399
558
  const metadata = { $schema_version: 1, id: team.id, name: team.title ?? team.id, version: team.version,
400
559
  ...(team.description !== undefined ? { description: team.description } : {}), ...(publisher ? { publisher } : {}), createdAt,
401
560
  compat: { platforms: team.host.platform, evolcore: evolcoreRange,
402
561
  ...(templateFeatures.length ? { templateFeatures } : {}),
403
- baseagents: [...new Set(team.agents.flatMap(agent => Object.keys(agent.config.baseagents)))] }, externalAids: [...external].sort() };
562
+ baseagents: [...new Set(team.agents.flatMap(agent => Object.keys(agent.config?.baseagents ?? {})))] }, externalAids: [...external].sort() };
563
+ materializeMemberResourceStates(team, entries);
404
564
  const manifest = [...entries].map(([name, entry]) => ({ path: name.slice('template/'.length), size: entry.bytes.length, sha256: packageDigest(entry.bytes).slice(7) }));
405
565
  entries.set('PACKAGE.json', { bytes: json(metadata), mode: 0o644 });
406
566
  entries.set('MANIFEST.json', { bytes: json(manifest), mode: 0o644 });
@@ -454,9 +614,10 @@ export function attachBuildEnvironment(templateDir, sourceDir) {
454
614
  check(!base.errors.length, 'Invalid build environment: ' + base.errors.join('; '));
455
615
  const teamFile = path.join(templateDir, 'team.json');
456
616
  const team = JSON.parse(fs.readFileSync(teamFile, 'utf8'));
617
+ delete team.host.name;
618
+ if (base.tpl.team.host.name !== undefined) team.host.name = base.tpl.team.host.name;
457
619
  team.host.config = structuredClone(base.tpl.team.host.config ?? {});
458
620
  team.host.config.aun = { ...team.host.config.aun, defaultAidDomain: resolveTemplateAidDomain(base.tpl.team) };
459
- delete team.issuer;
460
621
  for (const name of ['providers.json', 'agents/defaults.json', '.env']) {
461
622
  const source = path.join(base.tpl.root, '.evolcore', ...name.split('/'));
462
623
  if (!fs.existsSync(source)) continue;
@@ -476,12 +637,13 @@ export function templateProviderSummary(templateDir) {
476
637
  }
477
638
 
478
639
  const EVENT_PACK_NAME_PATTERN = /^[a-z0-9][a-z0-9_-]{0,63}$/;
479
- 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*\}\}$/;
480
641
 
481
642
  /** Share package definitions/assets, never runtime state, logs, backups or caches. */
482
643
  export function isPortableEventPackResource(relative) {
644
+ const { runtimeEntries } = requireEventPackRuntime();
483
645
  return relative.split('/').every(part => part && part !== '..' && !part.startsWith('.')
484
- && !PACK_RUNTIME_ENTRIES.has(part) && !['node_modules', '__pycache__'].includes(part)
646
+ && !runtimeEntries.has(part) && !['node_modules', '__pycache__'].includes(part)
485
647
  && !part.endsWith('_') && !part.endsWith('~') && !/\.(?:bak|pyc)$/i.test(part));
486
648
  }
487
649
 
@@ -496,32 +658,51 @@ export function validateEventPack(raw, files, { template = false, location = 'ev
496
658
  const checked = structuredClone(raw);
497
659
  if (template && checked && typeof checked === 'object') {
498
660
  for (const kind of ['publish', 'subscribe']) if (Array.isArray(checked[kind])) {
499
- for (const entry of checked[kind]) if (entry && TEMPLATE_EVENT_BUS_PATTERN.test(entry.bus)) entry.bus = sha256(entry.bus).slice(0, 16) + '.agentid.cn';
661
+ for (const entry of checked[kind]) if (entry && TEMPLATE_EVENT_BUS_PATTERN.test(entry.bus)) entry.bus = packageDigest(entry.bus).slice(7, 23) + '.agentid.cn';
500
662
  }
501
663
  }
502
- const result = validatePackJson(checked);
503
- assert(result.ok, 'INVALID_ARGUMENT', location + '/pack.json: ' + result.errors.join('; '));
664
+ const result = requireEventPackRuntime().validatePackJson(checked);
665
+ check(result.ok, location + '/pack.json: ' + result.errors.join('; '));
504
666
  for (const entry of result.value.subscribe) {
505
- assert(files.includes(entry.handler.script), 'INVALID_ARGUMENT', location + ': missing handler ' + entry.handler.script);
667
+ check(files.includes(entry.handler.script), location + ': missing handler ' + entry.handler.script);
506
668
  }
507
669
  return raw;
508
670
  }
509
671
 
672
+ function eventPackFiles(root) {
673
+ const files = []; let total = 0;
674
+ const visit = (directory, prefix = '') => {
675
+ for (const entry of fs.readdirSync(directory, { withFileTypes: true }).sort((a, b) => a.name.localeCompare(b.name))) {
676
+ const relative = prefix + entry.name;
677
+ if (!isPortableEventPackResource(relative)) continue;
678
+ check(!entry.isSymbolicLink() && (entry.isFile() || entry.isDirectory()), 'Only regular event-pack files/directories: ' + relative);
679
+ const file = path.join(directory, entry.name);
680
+ if (entry.isDirectory()) visit(file, relative + '/');
681
+ else {
682
+ const size = fs.statSync(file).size; total += size;
683
+ check(files.length < PACKAGE_LIMITS.entries && size <= PACKAGE_LIMITS.file && total <= PACKAGE_LIMITS.total, 'Event-pack size limit exceeded', 'PACKAGE_TOO_LARGE');
684
+ files.push(relative);
685
+ }
686
+ }
687
+ };
688
+ visit(root); return files.sort();
689
+ }
690
+
510
691
  /** Read-only inventory: loading must not create logs or migrate source files. */
511
- export function readEventPacks(eventsDir, { template = false } = {}) {
692
+ export function readEventPacks(eventsDir, { template = false, ids } = {}) {
512
693
  if (!fs.existsSync(eventsDir)) return [];
513
- regularPath(eventsDir);
694
+ regularAncestors(eventsDir);
514
695
  return fs.readdirSync(eventsDir, { withFileTypes: true }).sort((a, b) => a.name.localeCompare(b.name))
515
- .filter(entry => !entry.name.startsWith('.') && !entry.name.startsWith('_'))
696
+ .filter(entry => !entry.name.startsWith('.') && !entry.name.startsWith('_') && (!ids || ids.includes(entry.name)))
516
697
  .flatMap(entry => {
517
- assert(!entry.isSymbolicLink(), 'INVALID_ARGUMENT', 'Symbolic event pack: ' + entry.name);
698
+ check(!entry.isSymbolicLink(), 'Symbolic event pack: ' + entry.name);
518
699
  if (!entry.isDirectory()) return [];
519
- const dir = inside(eventsDir, entry.name);
700
+ const dir = path.join(eventsDir, entry.name);
520
701
  if (fs.existsSync(path.join(dir, '.archived'))) return [];
521
- assert(EVENT_PACK_NAME_PATTERN.test(entry.name), 'INVALID_ARGUMENT', 'Invalid event pack name: ' + entry.name);
522
- const files = walkFiles(dir, relative => !isPortableEventPackResource(relative));
523
- assert(files.includes('pack.json'), 'INVALID_ARGUMENT', 'Event pack missing pack.json: ' + entry.name);
524
- const definition = validateEventPack(readJson(path.join(dir, 'pack.json')), files, { template, location: 'events/' + entry.name });
702
+ check(EVENT_PACK_NAME_PATTERN.test(entry.name), 'Invalid event pack name: ' + entry.name);
703
+ const files = eventPackFiles(dir);
704
+ check(files.includes('pack.json'), 'Event pack missing pack.json: ' + entry.name);
705
+ const definition = validateEventPack(JSON.parse(fs.readFileSync(path.join(dir, 'pack.json'), 'utf8')), files, { template, location: 'events/' + entry.name });
525
706
  return [{ id: entry.name, dir, files, definition }];
526
707
  });
527
708
  }
@@ -534,7 +715,7 @@ export function validateEventPackEntries(entries, keys) {
534
715
  for (const id of ids) {
535
716
  const packPrefix = prefix + id + '/';
536
717
  const entry = entries.get(packPrefix + 'pack.json');
537
- assert(entry, 'INVALID_ARGUMENT', 'Event pack missing pack.json: ' + prefix + id);
718
+ check(entry, 'Event pack missing pack.json: ' + prefix + id);
538
719
  const files = [...entries.keys()].filter(name => name.startsWith(packPrefix)).map(name => name.slice(packPrefix.length));
539
720
  validateEventPack(JSON.parse(entry.bytes.toString('utf8')), files, { template: true, location: prefix + id });
540
721
  }