evolcore 0.0.49 → 0.0.51

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (514) hide show
  1. package/CHANGELOG.md +103 -3
  2. package/bin/ec-build.mjs +60 -0
  3. package/bin/ecmsg.js +64 -57
  4. package/dist/ability/caller/authorization.js +21 -0
  5. package/dist/ability/caller/command.js +173 -0
  6. package/dist/ability/caller/contract.js +117 -0
  7. package/dist/ability/caller/credential-files.js +132 -0
  8. package/dist/ability/caller/daemon.js +183 -0
  9. package/dist/ability/caller/schema-view.js +157 -0
  10. package/dist/ability/caller/service.js +519 -0
  11. package/dist/ability/command-contract.js +5 -0
  12. package/dist/ability/daemon.js +5 -1
  13. package/dist/ability/interop-v1.js +156 -106
  14. package/dist/ability/management.js +1 -0
  15. package/dist/agent-template/jobs.js +79 -3
  16. package/dist/agent-template/runtime.js +459 -47
  17. package/dist/agent-template/service.js +1242 -198
  18. package/dist/agent-template/share.js +103 -0
  19. package/dist/agent-template/tool-runner.js +25 -0
  20. package/dist/agent-template/types.js +10 -2
  21. package/dist/agents/claude/availability.js +94 -0
  22. package/dist/agents/claude/capability-provider.js +154 -0
  23. package/dist/agents/claude/index.js +145 -0
  24. package/dist/agents/{claude-runner.js → claude/runner.js} +78 -166
  25. package/dist/agents/claude/session-file-adapter.js +246 -0
  26. package/dist/agents/codex/app-server-client.js +90 -10
  27. package/dist/agents/codex/availability.js +164 -0
  28. package/dist/agents/codex/capability-provider.js +138 -0
  29. package/dist/agents/codex/cli.js +38 -0
  30. package/dist/agents/codex/index.js +345 -0
  31. package/dist/agents/codex/mcp-elicitation.js +135 -0
  32. package/dist/agents/{codex-runner.js → codex/runner.js} +652 -383
  33. package/dist/agents/codex/session-file-adapter.js +834 -0
  34. package/dist/agents/dsh/availability.js +28 -0
  35. package/dist/agents/dsh/capability-provider.js +56 -0
  36. package/dist/agents/dsh/desktop-locations.ps1 +66 -0
  37. package/dist/agents/dsh/desktop-probe.cjs +37 -0
  38. package/dist/agents/dsh/index.js +98 -0
  39. package/dist/agents/dsh/installation.js +400 -0
  40. package/dist/agents/dsh/resources.js +755 -0
  41. package/dist/agents/dsh/runner.js +1183 -0
  42. package/dist/agents/dsh/runtime/README.md +243 -0
  43. package/dist/agents/dsh/runtime/authorization.js +23 -0
  44. package/dist/agents/dsh/runtime/bridge.js +837 -0
  45. package/dist/agents/dsh/runtime/config.js +271 -0
  46. package/dist/agents/dsh/runtime/entry.js +229 -0
  47. package/dist/agents/dsh/runtime/session-inspector.js +340 -0
  48. package/dist/agents/dsh/runtime/tool-policy.js +49 -0
  49. package/dist/agents/dsh/session-file-adapter.js +145 -0
  50. package/dist/agents/ecagent/index.js +215 -0
  51. package/dist/agents/{ecagent-runner.js → ecagent/runner.js} +592 -106
  52. package/dist/agents/ecagent/session-file-adapter.js +134 -0
  53. package/dist/agents/gemini/index.js +96 -0
  54. package/dist/agents/{gemini-runner.js → gemini/runner.js} +18 -23
  55. package/dist/{core/session/adapters/gemini-session-file-adapter.js → agents/gemini/session-file-adapter.js} +2 -2
  56. package/dist/aun/ability-device-routing.js +11 -17
  57. package/dist/aun/aid/agentmd.js +27 -1
  58. package/dist/aun/aid/control-aid.js +52 -32
  59. package/dist/aun/aid/managed-operation.js +6 -4
  60. package/dist/aun/group/invite-service.js +7 -37
  61. package/dist/aun/group/operations.js +6 -0
  62. package/dist/aun/menu/client.js +1 -1
  63. package/dist/aun/msg/history.js +1 -1
  64. package/dist/aun/msg/managed-operation.js +93 -21
  65. package/dist/aun/msg/mention-schema.js +1 -1
  66. package/dist/aun/msg/p2p.js +32 -4
  67. package/dist/aun/msg/upload.js +126 -3
  68. package/dist/aun/service-proxy.js +1 -1
  69. package/dist/aun/storage/index.js +242 -0
  70. package/dist/build-identity.json +1 -1
  71. package/dist/channels/aun.js +698 -213
  72. package/dist/channels/daemon.js +3 -2
  73. package/dist/channels/dingtalk.js +1 -1
  74. package/dist/channels/feishu.js +9 -9
  75. package/dist/channels/qqbot.js +1 -1
  76. package/dist/channels/wechat.js +2 -2
  77. package/dist/channels/wecom.js +1 -1
  78. package/dist/claude-gateway/agent-registration.js +389 -0
  79. package/dist/claude-gateway/binding.js +96 -0
  80. package/dist/claude-gateway/inbox.js +138 -0
  81. package/dist/claude-gateway/index.js +125 -0
  82. package/dist/claude-gateway/listing.js +330 -0
  83. package/dist/claude-gateway/router.js +328 -0
  84. package/dist/claude-gateway/sessions.js +128 -0
  85. package/dist/claude-gateway/terminal.js +250 -0
  86. package/dist/claude-gateway/transcript.js +272 -0
  87. package/dist/claude-gateway/types.js +14 -0
  88. package/dist/cli/ability-command.js +45 -0
  89. package/dist/cli/ability-output.js +182 -0
  90. package/dist/cli/agent-command.js +21 -2
  91. package/dist/cli/agent-create.js +197 -56
  92. package/dist/cli/agent-template.js +400 -27
  93. package/dist/cli/agent.js +105 -11
  94. package/dist/cli/aun-commands.js +237 -123
  95. package/dist/cli/bench.js +5 -2
  96. package/dist/cli/config.js +22 -6
  97. package/dist/cli/daemon-commands.js +283 -109
  98. package/dist/cli/data-command.js +1 -1
  99. package/dist/cli/debug-mode.js +9 -0
  100. package/dist/cli/directory.js +1 -2
  101. package/dist/cli/ecmsg-gateway.js +64 -26
  102. package/dist/cli/fs-command.js +67 -39
  103. package/dist/cli/index.js +45 -12
  104. package/dist/cli/init.js +161 -90
  105. package/dist/cli/managed-command-guard.js +3 -0
  106. package/dist/cli/menu-client.js +32 -7
  107. package/dist/cli/model.js +1 -1
  108. package/dist/cli/pay-command.js +30 -0
  109. package/dist/cli/provider-command.js +6 -2
  110. package/dist/cli/restart-monitor.js +4 -4
  111. package/dist/cli/services-command.js +35 -10
  112. package/dist/cli/skill-command.js +4 -4
  113. package/dist/cli/task-context.js +24 -14
  114. package/dist/cli/team-workspace-command.js +50 -52
  115. package/dist/cli/thread-command.js +81 -14
  116. package/dist/cli/trigger-command.js +47 -12
  117. package/dist/cli/watch-logs.js +2 -1
  118. package/dist/config/access-policy.js +16 -3
  119. package/dist/config/boot-log.js +3 -0
  120. package/dist/config/builtin-role-templates.js +1 -1
  121. package/dist/config/config-field-policy.js +26 -13
  122. package/dist/config/config-manager.js +113 -52
  123. package/dist/config/config-operation-service.js +22 -1
  124. package/dist/config/gateway-config.js +29 -44
  125. package/dist/config/invoke-ipc-service.js +1 -1
  126. package/dist/config/owner-config.js +5 -19
  127. package/dist/config/peer-book-store.js +2 -3
  128. package/dist/config/peer-book.js +2 -2
  129. package/dist/config/peer-role-resolver.js +3 -9
  130. package/dist/config/provider-identity-migration.js +24 -105
  131. package/dist/config/provider-ipc-service.js +13 -3
  132. package/dist/config/provider-local-sync.js +4 -1
  133. package/dist/config/provider-menu-request.js +21 -3
  134. package/dist/config/provider-templates.js +1 -1
  135. package/dist/config/providers-config.js +138 -31
  136. package/dist/config/providers-import.js +3 -3
  137. package/dist/config/providers-management.js +109 -118
  138. package/dist/config/resolved-config-op.js +1 -42
  139. package/dist/config/schema-migration.js +254 -15
  140. package/dist/config/schema-registry.js +53 -8
  141. package/dist/config-store.js +1343 -63
  142. package/dist/core/{agent-application-service.js → agent/agent-application-service.js} +228 -9
  143. package/dist/core/{agent-create-status.js → agent/agent-create-status.js} +112 -4
  144. package/dist/core/{agent-creation-claim.js → agent/agent-creation-claim.js} +3 -3
  145. package/dist/core/{agent-ipc-registration.js → agent/agent-ipc-registration.js} +119 -25
  146. package/dist/core/{agent-reload-coordinator.js → agent/agent-reload-coordinator.js} +65 -0
  147. package/dist/core/{agent-runtime.js → agent/agent-runtime.js} +249 -79
  148. package/dist/core/{evolagent-registry.js → agent/evolagent-registry.js} +23 -18
  149. package/dist/core/{evolagent.js → agent/evolagent.js} +11 -11
  150. package/dist/core/auth/agent-delegation.js +15 -8
  151. package/dist/core/auth/delegation-authorization.js +28 -0
  152. package/dist/core/auth/operation-authorizer.js +20 -2
  153. package/dist/core/auth/operation-catalog.js +80 -8
  154. package/dist/core/baseagent/baseagent-availability.js +197 -0
  155. package/dist/core/baseagent/baseagent-capability-adapter.js +288 -0
  156. package/dist/core/baseagent/baseagent-config-shared.js +56 -0
  157. package/dist/core/baseagent/baseagent-identity.js +68 -0
  158. package/dist/core/{baseagent-loader.js → baseagent/baseagent-loader.js} +89 -6
  159. package/dist/core/baseagent/baseagent-model-defaults.js +26 -0
  160. package/dist/core/baseagent/baseagent-plugin-descriptor.js +357 -0
  161. package/dist/core/baseagent/baseagent-plugin-loader.js +367 -0
  162. package/dist/core/baseagent/baseagent.js +157 -0
  163. package/dist/{agents → core/baseagent}/runner-types.js +36 -4
  164. package/dist/core/capability/capability-manager.js +91 -33
  165. package/dist/core/capability/providers/claude-capability-provider.js +2 -154
  166. package/dist/core/capability/providers/codex-capability-provider.js +2 -136
  167. package/dist/core/{channel-loader.js → channel/channel-loader.js} +226 -38
  168. package/dist/core/{channel-runtime.js → channel/channel-runtime.js} +21 -19
  169. package/dist/core/command/agent-control.js +80 -17
  170. package/dist/core/command/agent-template-menu.js +23 -10
  171. package/dist/core/command/agentmd-menu-request.js +19 -8
  172. package/dist/core/command/agentmd-menu.js +14 -5
  173. package/dist/core/command/cli-intent-parser.js +15 -0
  174. package/dist/core/command/command-handler.js +127 -57
  175. package/dist/core/command/context-policy-menu.js +122 -0
  176. package/dist/core/command/data-root-resolver.js +157 -20
  177. package/dist/core/command/memory-slash.js +6 -6
  178. package/dist/core/command/menu-catalog.js +95 -19
  179. package/dist/core/command/menu-file-path.js +70 -0
  180. package/dist/core/command/menu-handler.js +392 -93
  181. package/dist/core/command/menu-protocol.js +47 -8
  182. package/dist/core/command/menu-query-batch.js +9 -5
  183. package/dist/core/command/private-mention-menu.js +71 -0
  184. package/dist/core/command/provider-menu.js +7 -11
  185. package/dist/core/command/role-menu.js +1 -1
  186. package/dist/core/command/skill-slash.js +17 -5
  187. package/dist/core/command/slash-gate.js +2 -4
  188. package/dist/core/command/slash-handler.js +143 -121
  189. package/dist/core/command/team-workspace-bootstrap.js +2 -1
  190. package/dist/core/command/team-workspace-team.js +3 -3
  191. package/dist/core/command/topic-slash.js +16 -10
  192. package/dist/core/{daemon-bootstrap.js → daemon/daemon-bootstrap.js} +14 -18
  193. package/dist/core/{daemon-control.js → daemon/daemon-control.js} +48 -21
  194. package/dist/core/{daemon-lifecycle.js → daemon/daemon-lifecycle.js} +28 -20
  195. package/dist/core/{host-snapshot.js → daemon/host-snapshot.js} +10 -5
  196. package/dist/core/{ipc-registration.js → daemon/ipc-registration.js} +101 -37
  197. package/dist/core/{lifecycle-notice.js → daemon/lifecycle-notice.js} +4 -5
  198. package/dist/core/file-integrity/store.js +1 -1
  199. package/dist/core/handoff/ipc-registration.js +3 -3
  200. package/dist/core/handoff/runtime.js +2 -2
  201. package/dist/{agents → core/inference}/request-identity.js +2 -2
  202. package/dist/core/inference/text-inference.js +4 -4
  203. package/dist/core/{bootstrap-messages.js → initialization/bootstrap-messages.js} +10 -10
  204. package/dist/core/{bootstrap-service.js → initialization/bootstrap-service.js} +24 -23
  205. package/dist/core/initialization/service.js +57 -9
  206. package/dist/core/invoke/executors/media.js +1 -1
  207. package/dist/core/invoke/executors/text.js +1 -1
  208. package/dist/core/memory/consolidation-context.js +3 -2
  209. package/dist/core/memory/consolidation-trigger.js +9 -3
  210. package/dist/core/memory/consolidation.js +39 -68
  211. package/dist/core/memory/memory-admin.js +6 -6
  212. package/dist/core/memory/memory-writer.js +1 -1
  213. package/dist/core/memory/relation-idle-monitor.js +1 -1
  214. package/dist/core/message/aun-ipc-sender.js +204 -88
  215. package/dist/core/message/aun-request-registry.js +44 -5
  216. package/dist/core/message/auto-mention-gate.js +1 -1
  217. package/dist/core/message/contact-admission.js +1 -1
  218. package/dist/core/message/im-renderer.js +19 -0
  219. package/dist/core/{interaction-router.js → message/interaction-router.js} +131 -1
  220. package/dist/core/message/items-formatter.js +5 -5
  221. package/dist/core/message/message-admission.js +1 -1
  222. package/dist/core/message/message-bridge.js +239 -59
  223. package/dist/core/message/message-log.js +8 -0
  224. package/dist/core/message/message-queue.js +88 -7
  225. package/dist/core/message/message-utils.js +1 -1
  226. package/dist/core/message/peer-mode.js +16 -5
  227. package/dist/core/message/response-engine.js +351 -152
  228. package/dist/core/message/send-options.js +44 -7
  229. package/dist/core/message/send-routing.js +55 -115
  230. package/dist/core/message/stream-idle-monitor.js +1 -1
  231. package/dist/core/{data-migration.js → migration/data-migration.js} +29 -1
  232. package/dist/core/model/catalog-service.js +29 -8
  233. package/dist/core/model/model-capabilities.js +88 -0
  234. package/dist/core/model/model-catalog.js +18 -7
  235. package/dist/core/model/model-diagnostics.js +4 -4
  236. package/dist/core/ownership/owner-resolver.js +107 -101
  237. package/dist/core/{pack-auth.js → pack/pack-auth.js} +34 -3
  238. package/dist/core/{pack-install.js → pack/pack-install.js} +95 -17
  239. package/dist/core/permission/approval-gateway.js +9 -18
  240. package/dist/core/permission/ec-command-parser.js +242 -82
  241. package/dist/core/permission/managed-file.js +234 -0
  242. package/dist/core/permission/protected-paths.js +120 -9
  243. package/dist/core/permission/sandbox-runtime.js +267 -3
  244. package/dist/core/permission/services-path-acl.js +9 -2
  245. package/dist/core/permission/session-path-grants.js +1 -1
  246. package/dist/core/permission/shell-environment.js +15 -1
  247. package/dist/core/permission/tool-policy.js +21 -9
  248. package/dist/core/plugin/plugin-lifecycle.js +442 -0
  249. package/dist/core/session/adapters/claude-session-file-adapter.js +2 -242
  250. package/dist/core/session/adapters/codex-session-file-adapter.js +2 -562
  251. package/dist/core/session/adapters/ecagent-session-file-adapter.js +2 -134
  252. package/dist/core/{background-session → session/background}/session-cleanup.js +2 -2
  253. package/dist/core/{background-session → session/background}/types.js +1 -1
  254. package/dist/core/session/session-file-health.js +2 -272
  255. package/dist/core/session/session-idle-monitor.js +1 -1
  256. package/dist/core/session/session-manager.js +76 -12
  257. package/dist/core/session/session-mapper.js +16 -0
  258. package/dist/core/session/session-terminal.js +185 -0
  259. package/dist/core/session/session-title.js +8 -11
  260. package/dist/core/{system-session → session/system}/memory.js +43 -9
  261. package/dist/core/{system-session → session/system}/registry.js +1 -1
  262. package/dist/core/{system-session → session/system}/types.js +1 -1
  263. package/dist/core/skill/index-generator.js +3 -3
  264. package/dist/core/skill/switch-resolver.js +3 -0
  265. package/dist/core/task/task-activity-store.js +112 -0
  266. package/dist/core/task/task-recovery-service.js +2 -2
  267. package/dist/core/thread/command-parser.js +4 -1
  268. package/dist/core/thread/ipc-operation.js +6 -4
  269. package/dist/core/thread/thread-operation.js +27 -11
  270. package/dist/core/thread/thread-route.js +5 -3
  271. package/dist/core/thread/thread-service.js +307 -58
  272. package/dist/core/thread/topic-id.js +52 -2
  273. package/dist/core/thread/types.js +15 -1
  274. package/dist/directory/{owner-directory-admission.js → admission.js} +3 -3
  275. package/dist/directory/{owner-directory-cache.js → cache.js} +90 -8
  276. package/dist/directory/{owner-directory-markdown.js → markdown.js} +2 -2
  277. package/dist/directory/{owner-directory-query-operation.js → query-operation.js} +83 -9
  278. package/dist/directory/{owner-directory-search.js → search.js} +50 -2
  279. package/dist/directory/{owner-directory-store.js → store.js} +2 -2
  280. package/dist/eck/kit-renderer.js +3 -2
  281. package/dist/eck/manifest-engine.js +64 -2
  282. package/dist/eck/message-renderer.js +35 -0
  283. package/dist/ecweb/basic-settings-service.js +12 -10
  284. package/dist/{contracts → ecweb/contracts}/ecweb-service-protocol.js +2 -1
  285. package/dist/ecweb/dsh-native-service.js +413 -0
  286. package/dist/ecweb/providers-service.js +5 -3
  287. package/dist/ecweb/runtime/lifecycle.js +1 -1
  288. package/dist/ecweb/runtime/supervisor.js +1 -1
  289. package/dist/event-center/center-config.js +2 -2
  290. package/dist/event-center/dispatcher.js +1 -1
  291. package/dist/event-center/ipc-operation.js +12 -3
  292. package/dist/event-center/pack-loader.js +2 -2
  293. package/dist/event-center/registry.js +6 -6
  294. package/dist/event-center/runtime.js +2 -2
  295. package/dist/index.js +181 -77
  296. package/dist/ipc.js +161 -12
  297. package/dist/outputs/authorization.js +27 -0
  298. package/dist/outputs/events.js +10 -1
  299. package/dist/outputs/panel-cards.js +960 -0
  300. package/dist/paths.js +60 -1
  301. package/dist/pay/command.js +38 -0
  302. package/dist/pay/protocol.js +136 -0
  303. package/dist/pay/runtime.js +196 -0
  304. package/dist/pay/service.js +384 -0
  305. package/dist/pay/store.js +81 -0
  306. package/dist/response-system/engines/v1/proactive-flow.js +30 -3
  307. package/dist/services/dispatcher.js +25 -7
  308. package/dist/services/host/main.js +397 -0
  309. package/dist/services/host/protocol.js +125 -0
  310. package/dist/services/host/resident.js +347 -0
  311. package/dist/services/host-client.js +398 -0
  312. package/dist/services/host-deploy.js +180 -0
  313. package/dist/services/host-launch.js +117 -0
  314. package/dist/services/host-recycle.js +208 -0
  315. package/dist/services/host-runtime.js +841 -0
  316. package/dist/services/idempotency.js +44 -86
  317. package/dist/services/index-generator.js +4 -3
  318. package/dist/services/index.js +258 -36
  319. package/dist/services/ipc-operation.js +503 -78
  320. package/dist/services/pack-manager.js +2 -2
  321. package/dist/services/router.js +43 -3
  322. package/dist/services/script-runner.js +541 -100
  323. package/dist/services/service-payload.js +28 -1
  324. package/dist/services/validation.js +136 -5
  325. package/dist/stats/context-usage.js +110 -0
  326. package/dist/stats/model-resolver.js +103 -17
  327. package/dist/stats/query.js +5 -0
  328. package/dist/trigger/application-service.js +9 -6
  329. package/dist/trigger/authorization.js +36 -33
  330. package/dist/trigger/ipc-service.js +4 -4
  331. package/dist/trigger/local-files.js +8 -166
  332. package/dist/trigger/manager.js +2 -2
  333. package/dist/trigger/parser.js +48 -0
  334. package/dist/trigger/scheduler.js +35 -13
  335. package/dist/trigger/script-executor.js +21 -0
  336. package/dist/trigger/script-sandbox.js +77 -232
  337. package/dist/trigger/system-definitions.js +25 -0
  338. package/dist/trigger/validation.js +1 -1
  339. package/dist/utils/aid-bind.js +3 -0
  340. package/dist/utils/atomic-write.js +88 -1
  341. package/dist/utils/cross-platform.js +4 -42
  342. package/dist/utils/error-dict.json +22 -1
  343. package/dist/utils/error-utils.js +193 -6
  344. package/dist/utils/evolcore-version.js +2 -2
  345. package/dist/utils/host-info.js +74 -1
  346. package/dist/utils/logger.js +5 -3
  347. package/dist/utils/media-cache.js +284 -42
  348. package/dist/utils/restart-safety.js +14 -1
  349. package/dist/utils/startup-trace.js +20 -4
  350. package/dist/utils/system-memory.js +113 -25
  351. package/dist/utils/systemd-lifecycle.js +154 -0
  352. package/dist/utils/welcome.js +64 -20
  353. package/dist/utils/windows-shell-trust.js +7 -3
  354. package/ecagent/README.md +35 -0
  355. package/ecagent/dist/agent-loop.js +80 -30
  356. package/ecagent/dist/harness/env/nodejs.d.ts +16 -0
  357. package/ecagent/dist/harness/env/nodejs.js +49 -20
  358. package/ecagent/dist/harness/messages.js +3 -2
  359. package/ecagent/dist/harness/types.d.ts +1 -0
  360. package/ecagent/dist/runtime/types.d.ts +2 -0
  361. package/ecagent/dist/runtime/utils/validation.d.ts +7 -1
  362. package/ecagent/dist/runtime/utils/validation.js +42 -0
  363. package/ecagent/dist/types.d.ts +2 -0
  364. package/kits/docs/INDEX.md +3 -2
  365. package/kits/docs/aun/AUN/346/266/210/346/201/257/347/261/273/345/236/213/344/270/216/345/261/236/346/200/247.md +1 -0
  366. package/kits/docs/channels/aun.md +1 -1
  367. package/kits/docs/channels/feishu.md +1 -1
  368. package/kits/docs/evolcore/INDEX.md +13 -9
  369. package/kits/docs/evolcore/agent-create.md +2 -0
  370. package/kits/docs/evolcore/agent.md +133 -11
  371. package/kits/docs/evolcore/aid.md +39 -6
  372. package/kits/docs/evolcore/config.md +95 -1
  373. package/kits/docs/evolcore/ctl.md +2 -1
  374. package/kits/docs/evolcore/ec-capabilities.md +7 -10
  375. package/kits/docs/evolcore/ecweb-lifecycle.md +5 -1
  376. package/kits/docs/evolcore/event.md +1 -1
  377. package/kits/docs/evolcore/fs.md +49 -3
  378. package/kits/docs/evolcore/group.md +5 -4
  379. package/kits/docs/evolcore/memory-consolidation.md +1 -1
  380. package/kits/docs/evolcore/memory-tags.md +2 -0
  381. package/kits/docs/evolcore/menu-client.md +3 -3
  382. package/kits/docs/evolcore/menu-protocol.md +31 -2
  383. package/kits/docs/evolcore/model.md +12 -1
  384. package/kits/docs/evolcore/msg.md +96 -36
  385. package/kits/docs/evolcore/pay.md +22 -0
  386. package/kits/docs/evolcore/plugin.md +74 -0
  387. package/kits/docs/evolcore/provider.md +29 -2
  388. package/kits/docs/evolcore/rpc.md +2 -2
  389. package/kits/docs/evolcore/services.md +46 -18
  390. package/kits/docs/evolcore/skill.md +17 -1
  391. package/kits/docs/evolcore/stats.md +5 -0
  392. package/kits/docs/evolcore/storage.md +22 -0
  393. package/kits/docs/evolcore/thread-chain.md +20 -9
  394. package/kits/docs/evolcore/tool-authorization.md +14 -0
  395. package/kits/docs/evolcore/trigger.md +89 -13
  396. package/kits/docs/identity/AID_PROFILE_SPEC.md +1 -1
  397. package/kits/docs/venues/feishu-group.md +3 -2
  398. package/kits/docs/venues/feishu-private.md +3 -2
  399. package/kits/rules/01-overview.md +11 -32
  400. package/kits/rules/02-navigation.md +20 -6
  401. package/kits/rules/06-channel.md +20 -4
  402. package/kits/schemas/_meta.json +42 -5
  403. package/kits/schemas/agent-config.schema.21.json +974 -0
  404. package/kits/schemas/agent-config.schema.22.json +977 -0
  405. package/kits/schemas/agent-config.schema.23.json +974 -0
  406. package/kits/schemas/agent-config.schema.24.json +986 -0
  407. package/kits/schemas/agent-config.schema.25.json +986 -0
  408. package/kits/schemas/daemon.schema.10.json +373 -0
  409. package/kits/schemas/daemon.schema.11.json +487 -0
  410. package/kits/schemas/daemon.schema.12.json +505 -0
  411. package/kits/schemas/daemon.schema.9.json +12 -0
  412. package/kits/schemas/defaults.schema.7.json +472 -0
  413. package/kits/schemas/defaults.schema.8.json +484 -0
  414. package/kits/schemas/providers.schema.1.json +1 -1
  415. package/kits/schemas/providers.schema.2.json +1 -1
  416. package/kits/schemas/providers.schema.3.json +26 -4
  417. package/kits/schemas/relation-config.schema.13.json +289 -0
  418. package/kits/skills/.switches.json +17 -1
  419. package/kits/skills/ability/SKILL.md +395 -33
  420. package/kits/skills/ability/STRUCTURE.md +338 -0
  421. package/kits/skills/ability/references/cli.md +208 -0
  422. package/kits/skills/ability/references/development.md +107 -37
  423. package/kits/skills/ability/references/management.md +106 -46
  424. package/kits/skills/ability/references/runtime-protocol.md +65 -63
  425. package/kits/skills/agent-output-cards/SKILL.md +80 -37
  426. package/kits/skills/agent-output-cards/examples/html-surface.json +11 -0
  427. package/kits/skills/agent-output-cards/examples/meeting-followups.json +16 -0
  428. package/kits/skills/agent-output-cards/examples/meeting-latest.json +24 -0
  429. package/kits/skills/agent-output-cards/examples/project-metrics.json +16 -0
  430. package/kits/skills/agent-output-cards/examples/quick-links.json +18 -0
  431. package/kits/skills/agent-output-cards/examples/surface.html +8 -0
  432. package/kits/skills/agent-template-project/SKILL.md +51 -0
  433. package/kits/skills/agent-template-project/references/01-collect-and-pack.md +174 -0
  434. package/kits/skills/agent-template-project/references/02-upload-and-share.md +109 -0
  435. package/kits/skills/agent-template-project/references/03-download-and-install.md +189 -0
  436. package/kits/skills/agent-template-project/references/04-upgrade-and-recovery.md +74 -0
  437. package/kits/skills/agent-template-project/references/05-publish-to-platform.md +62 -0
  438. package/kits/skills/ec-group/SKILL.md +8 -6
  439. package/kits/skills/ec-group/TASK.md +186 -0
  440. package/kits/skills/ec-group/WORKLOG.md +180 -0
  441. package/kits/skills/ec-group-collaboration/SKILL.md +5 -5
  442. package/kits/skills/ec-identity/SKILL.md +9 -6
  443. package/kits/skills/ec-pay/SKILL.md +223 -0
  444. package/kits/skills/ec-provider/SKILL.md +6 -6
  445. package/kits/skills/{ec-service-proxy → ec-proxy}/SKILL.md +8 -5
  446. package/kits/skills/ec-service-call/SKILL.md +138 -0
  447. package/kits/skills/ec-service-pack/SKILL.md +277 -0
  448. package/kits/skills/ec-skill/SKILL.md +25 -9
  449. package/kits/skills/ec-skill/scripts/cli.mjs +7 -7
  450. package/kits/skills/ec-skill/scripts/skill.mjs +55 -41
  451. package/kits/skills/ec-skill/scripts/template/SKILL.md.tmpl +9 -0
  452. package/kits/skills/ec-trigger/SKILL.md +3 -3
  453. package/kits/skills/personal-assistant/SKILL.md +22 -22
  454. package/kits/skills/personal-assistant/references/03-data-flow-and-gaps.md +1 -1
  455. package/kits/skills/scrapling-article-fetch/SKILL.md +5 -5
  456. package/kits/skills/thread-ops/SKILL.md +19 -9
  457. package/kits/skills/wechat-article-media-download/SKILL.md +2 -2
  458. package/kits/skills/wechat-article-reader/SKILL.md +2 -2
  459. package/kits/templates/memory-consolidation/notes.md +2 -2
  460. package/kits/templates/memory-consolidation/workflow.md +46 -0
  461. package/kits/templates/system-fragments/channel.md +13 -4
  462. package/kits/templates/system-fragments/commands.md +5 -4
  463. package/kits/templates/system-fragments/personal-assistant.md +2 -2
  464. package/kits/templates/system-fragments/reply.md +15 -9
  465. package/kits/templates/system-fragments/session.md +2 -2
  466. package/kits/templates/system-fragments/thread.md +30 -127
  467. package/kits/templates/system-fragments/venue.md +16 -0
  468. package/package.json +7 -7
  469. package/scripts/agent-template/index.mjs +7 -1
  470. package/scripts/agent-template/inspect.mjs +99 -39
  471. package/scripts/agent-template/overlay.mjs +126 -2
  472. package/scripts/agent-template/shared/common.mjs +49 -5
  473. package/scripts/agent-template/shared/plan.mjs +4 -2
  474. package/scripts/agent-template/shared/service-packs.mjs +104 -0
  475. package/scripts/agent-template/shared/team-schema.json +468 -39
  476. package/scripts/agent-template/shared/template-contract.mjs +93 -51
  477. package/scripts/agent-template/shared/template-package.mjs +225 -44
  478. package/scripts/agent-template/shared/template-runtime.mjs +137 -15
  479. package/scripts/agent-template/shared/template.mjs +31 -8
  480. package/scripts/agent-template/team-pack.mjs +528 -56
  481. package/scripts/agent-template/team-preview.mjs +102 -9
  482. package/scripts/aid-batch/identity-batch.mjs +1 -1
  483. package/dist/agents/baseagent-availability.js +0 -152
  484. package/dist/agents/baseagent.js +0 -750
  485. package/dist/agents/codex/catalog.js +0 -80
  486. package/dist/agents/ecagent-plugin-lazy.js +0 -41
  487. package/dist/agents/tool-time-context.js +0 -55
  488. package/dist/core/legacy-rename.js +0 -41
  489. package/dist/core/plugin-lifecycle.js +0 -137
  490. package/dist/core/rate-window.js +0 -53
  491. package/dist/core/runner-reload-transaction.js +0 -60
  492. package/dist/core/runtime-lock.js +0 -90
  493. package/dist/core/soul.js +0 -66
  494. package/dist/core/system-session/grants.js +0 -40
  495. package/dist/directory/owner-directory-agentmd-sync.js +0 -89
  496. package/dist/directory/owner-directory-request-operation.js +0 -79
  497. package/dist/directory/owner-directory-text.js +0 -60
  498. package/kits/docs/aun/ABILITY_CALLING.md +0 -280
  499. package/kits/docs/evolcore/ability.md +0 -185
  500. package/kits/skills/ability/references/calling.md +0 -56
  501. package/kits/skills/ability/references/contract-checklist.md +0 -37
  502. package/kits/skills/ability/references/recovery.md +0 -27
  503. /package/dist/{core/capability/providers/gemini-capability-provider.js → agents/gemini/capability-provider.js} +0 -0
  504. /package/dist/core/{system-channels.js → channel/system-channels.js} +0 -0
  505. /package/dist/core/{daemon-file-cache.js → daemon/daemon-file-cache.js} +0 -0
  506. /package/dist/core/{event-bus.js → event/event-bus.js} +0 -0
  507. /package/dist/core/{event-catalog.js → event/event-catalog.js} +0 -0
  508. /package/dist/core/{pack-ledger.js → pack/pack-ledger.js} +0 -0
  509. /package/dist/directory/{owner-directory-identity.js → identity.js} +0 -0
  510. /package/dist/directory/{owner-directory-policy.js → policy.js} +0 -0
  511. /package/dist/directory/{owner-directory-remarks.js → remarks.js} +0 -0
  512. /package/dist/directory/{owner-directory-scope.js → scope.js} +0 -0
  513. /package/dist/{contracts → ecweb/contracts}/ecweb-instance.js +0 -0
  514. /package/kits/templates/{bootstrap-welcome.md → bootstrap-intro.md} +0 -0
@@ -1,8 +1,123 @@
1
1
  /** Shared, pure template binding/rendering. No home discovery or runtime writes. */
2
2
  export const BASEAGENTS = ['claude', 'codex', 'gemini', 'ecagent'];
3
3
  export const MEMBER_PARAMETER_FIELDS = ['version', 'update'];
4
+
5
+ export const MEMBER_RESOURCE_KINDS = ['triggers', 'events', 'services'];
6
+
7
+ /** Member switches override the initial state in the Agent's own resource definition. */
8
+ export function validateMemberResourceStates(team, paths) {
9
+ for (const member of team.agents ?? []) for (const kind of MEMBER_RESOURCE_KINDS) {
10
+ if (member[kind] === undefined) continue;
11
+ if (!record(member[kind])) fail(member.key + '.' + kind + ': object required');
12
+ for (const [id, state] of Object.entries(member[kind])) {
13
+ if (!id || ['.', '..'].includes(id) || /[/\\\u0000]/.test(id)
14
+ || !record(state) || Object.keys(state).length !== 1 || typeof state.enabled !== 'boolean') {
15
+ fail(member.key + '.' + kind + '.' + id + ': only boolean enabled is allowed');
16
+ }
17
+ const file = 'agents/' + member.key + '/' + kind + '/' + id + '/' + (kind === 'triggers' ? 'trigger' : 'pack') + '.json';
18
+ if (!paths.has(file)) fail('Member resource not found: ' + file);
19
+ }
20
+ }
21
+ }
22
+
23
+ export function applyMemberResourceState(member, relative, definition) {
24
+ const match = /^(triggers|events|services)\/([^/]+)\/(trigger|pack)\.json$/.exec(relative);
25
+ if (!match || match[3] !== (match[1] === 'triggers' ? 'trigger' : 'pack')) return definition;
26
+ const group = member?.[match[1]];
27
+ const state = group && Object.hasOwn(group, match[2]) ? group[match[2]] : undefined;
28
+ return state === undefined ? definition : { ...definition, enabled: state.enabled };
29
+ }
30
+
31
+ /** Materialize declarations for installers which already read trigger.json / pack.json. */
32
+ export function materializeMemberResourceStates(team, entries, prefix = 'template/') {
33
+ validateMemberResourceStates(team, new Set([...entries.keys()].filter(name => name.startsWith(prefix)).map(name => name.slice(prefix.length))));
34
+ for (const member of team.agents ?? []) for (const kind of MEMBER_RESOURCE_KINDS) {
35
+ for (const [id, state] of Object.entries(member[kind] ?? {})) {
36
+ const name = prefix + 'agents/' + member.key + '/' + kind + '/' + id + '/' + (kind === 'triggers' ? 'trigger' : 'pack') + '.json';
37
+ const entry = entries.get(name); const definition = JSON.parse(entry.bytes.toString('utf8'));
38
+ if (definition.enabled !== state.enabled) entries.set(name, { ...entry,
39
+ bytes: Buffer.from(JSON.stringify({ ...definition, enabled: state.enabled }, null, 2) + '\n') });
40
+ }
41
+ }
42
+ }
4
43
  const record = value => value !== null && typeof value === 'object' && !Array.isArray(value);
5
44
  const fail = message => { throw Object.assign(new Error(message), { code: 'INVALID_ARGUMENT' }); };
45
+ const AID = /^[a-z0-9][a-z0-9_-]*\.(?:[a-z0-9-]+\.)*[a-z0-9-]+$/;
46
+ // Agent access lists follow the runtime schema; contact references retain their own contract.
47
+ const ACCESS_AID = /^[a-zA-Z0-9](?:[a-zA-Z0-9-]*[a-zA-Z0-9])?(?:\.[a-zA-Z0-9](?:[a-zA-Z0-9-]*[a-zA-Z0-9])?){2,}$/;
48
+ export const MEMBER_KEY = /^(?:[a-z0-9][a-z0-9_-]{0,31}|[a-z0-9][a-z0-9-]*(?:\.[a-z0-9][a-z0-9-]*){2,})$/;
49
+ const ACCESS_AID_REFERENCE = new RegExp('^\\{\\{\\s*(?:(?:agent|owner|host)\\.aid|members\\.'
50
+ + MEMBER_KEY.source.slice(1, -1) + '\\.aid)\\s*\\}\\}$');
51
+
52
+ /** References are only accepted before rendering; persisted access always requires real AIDs. */
53
+ export function validateAccessDeclaration(access, { allowTemplateReferences = false } = {}) {
54
+ if (!record(access)) fail('access must be an object');
55
+ for (const [key, value] of Object.entries(access)) {
56
+ if (['allowInternalContacts', 'allowExternalContacts', 'allowAllContacts'].includes(key)) {
57
+ if (typeof value !== 'boolean') fail('access.' + key + ' must be boolean');
58
+ } else if (['allowedAids', 'deniedAids'].includes(key)) {
59
+ if (!Array.isArray(value) || value.some(aid => typeof aid !== 'string'
60
+ || !ACCESS_AID.test(aid) && !(allowTemplateReferences && ACCESS_AID_REFERENCE.test(aid)))
61
+ || new Set(value).size !== value.length) fail('access.' + key + ' must contain unique AIDs');
62
+ } else if (key === 'requestLimit') {
63
+ if (!record(value) || Object.keys(value).some(field => !['maxTimes', 'coolDown'].includes(field))) fail('access.requestLimit is invalid');
64
+ for (const [field, number] of Object.entries(value)) {
65
+ const maximum = field === 'maxTimes' ? 100000 : 86400;
66
+ if (!Number.isSafeInteger(number) || number < 1 || number > maximum) fail('access.requestLimit.' + field + ' is invalid');
67
+ }
68
+ } else if (key === 'contactAdmission') {
69
+ if (!['legacy', 'app-v1'].includes(value)) fail('access.contactAdmission is invalid');
70
+ } else fail('Unknown access field: ' + key);
71
+ }
72
+ return structuredClone(access);
73
+ }
74
+
75
+ /** One partition used by authors, identity generation and delivery consumers. Never mutates input. */
76
+ export function partitionTeamMembers(team) {
77
+ if (!record(team) || !Array.isArray(team.agents) || !team.agents.length) fail('Team agents required');
78
+ const inlineMembers = [], keys = new Set();
79
+ for (const member of team.agents) {
80
+ if (!record(member) || !MEMBER_KEY.test(member.key ?? '') || keys.has(member.key)) fail('Invalid or duplicate member key');
81
+ keys.add(member.key);
82
+ if (Object.hasOwn(member, 'optional') || Object.hasOwn(member, 'agentTemplateId')) fail('Optional members are no longer supported');
83
+ if (member.config?.access !== undefined) {
84
+ validateAccessDeclaration(member.config.access, { allowTemplateReferences: true });
85
+ }
86
+ inlineMembers.push(structuredClone(member));
87
+ }
88
+ const index = team.personal_assistant ?? 0;
89
+ if (!Number.isInteger(index) || index < 0 || index >= team.agents.length) fail('personal_assistant: index outside agents');
90
+ const assistantKey = team.agents[index].key;
91
+ if (team.external_contacts !== undefined && !Array.isArray(team.external_contacts)) fail('external_contacts must be an array');
92
+ const externalAids = new Set();
93
+ const externalContacts = (team.external_contacts ?? []).map(contact => {
94
+ if (!record(contact) || Object.keys(contact).some(key => !['aid', 'name'].includes(key))
95
+ || typeof contact.aid !== 'string' || !AID.test(contact.aid) || externalAids.has(contact.aid)
96
+ || contact.name !== undefined && (typeof contact.name !== 'string' || !contact.name.trim())) fail('Invalid or duplicate external contact');
97
+ externalAids.add(contact.aid);
98
+ return { aid: contact.aid, name: contact.name ?? contact.aid };
99
+ });
100
+ return { inlineMembers, externalContacts, assistantKey };
101
+ }
102
+
103
+ export function teamMemberReferences(team) {
104
+ const { externalContacts } = partitionTeamMembers(team);
105
+ return externalContacts.length ? { external: externalContacts } : undefined;
106
+ }
107
+
108
+ /** Keep external identity/ownership unknown until independently verified. */
109
+ export function createTeamContactEntries({ members, ownerAid, hostAid, externalContacts = [], selfAid, remote = false }) {
110
+ const owned = new Set([ownerAid, hostAid, ...members.map(member => member.aid)]);
111
+ if (externalContacts.some(contact => owned.has(contact.aid))) fail('External contact conflicts with a team identity');
112
+ const entries = members.filter(member => member.aid !== selfAid).map(member => ({
113
+ aid: member.aid, name: member.name, [remote ? 'owner_aid' : 'ownerAid']: ownerAid,
114
+ remark: '', type: 'agent', description: member.description ?? '', ownership_status: 'owned',
115
+ agent_md_signed_at: remote ? null : 0,
116
+ ...(remote ? {} : { exttype: '', baseagent: '' }),
117
+ }));
118
+ return entries.concat(externalContacts.map(contact => ({ aid: contact.aid, name: contact.name ?? contact.aid,
119
+ ownership_status: 'unknown', agent_md_signed_at: remote ? null : 0 })));
120
+ }
6
121
 
7
122
  /** Author declarations only; never generates versions or grants update authority. */
8
123
  export function resolveMemberParameters(member) {
@@ -16,9 +131,13 @@ export function resolveMemberParameters(member) {
16
131
  const value = declaration[field];
17
132
  const valid = field === 'version'
18
133
  ? typeof value === 'string' && /^(0|[1-9][0-9]*)\.(0|[1-9][0-9]*)\.(0|[1-9][0-9]*)$/.test(value)
19
- : record(value) && Object.keys(value).every(key => ['mode', 'publisher'].includes(key))
134
+ : record(value) && Object.keys(value).every(key => ['mode', 'publisher', 'key', 'registryAid'].includes(key))
20
135
  && ['auto', 'manual', 'disabled'].includes(value.mode);
21
136
  if (!valid) fail(prefix + field + ': invalid declaration');
137
+ if (field === 'update') for (const name of ['key', 'registryAid']) {
138
+ if (Object.hasOwn(value, name) && (typeof value[name] !== 'string'
139
+ || !/^[a-z0-9][a-z0-9-]*(\.[a-z0-9][a-z0-9-]*){2,}$/.test(value[name]))) fail(prefix + 'update.' + name + ': invalid AID');
140
+ }
22
141
  if (field === 'update' && Object.hasOwn(value, 'publisher')
23
142
  && (typeof value.publisher !== 'string' || !/^[a-zA-Z0-9]([a-zA-Z0-9-]*[a-zA-Z0-9])?(\.[a-zA-Z0-9]([a-zA-Z0-9-]*[a-zA-Z0-9])?){2,}$/.test(value.publisher))) {
24
143
  fail(prefix + 'update.publisher: invalid AID');
@@ -26,7 +145,7 @@ export function resolveMemberParameters(member) {
26
145
  }
27
146
  if (declarations.length === 2) {
28
147
  const equal = field === 'update'
29
- ? declarations[0][field].mode === declarations[1][field].mode && declarations[0][field].publisher === declarations[1][field].publisher
148
+ ? ['mode', 'publisher', 'key', 'registryAid'].every(key => declarations[0][field][key] === declarations[1][field][key])
30
149
  : declarations[0][field] === declarations[1][field];
31
150
  if (!equal) fail(prefix + field + ': conflicts with config.' + field);
32
151
  }
@@ -36,13 +155,14 @@ export function resolveMemberParameters(member) {
36
155
  }
37
156
 
38
157
  /** Connection credentials cannot be hidden in otherwise public nested configuration. */
39
- export function assertPublicTemplateConfig(config) {
158
+ export function assertPublicTemplateConfig(config, onFinding) {
40
159
  const visit = (value, location) => {
41
160
  if (Array.isArray(value)) { value.forEach((item, index) => visit(item, location + '[' + index + ']')); return; }
42
161
  if (!record(value)) return;
43
162
  for (const [key, item] of Object.entries(value)) {
44
163
  if (/^(?:api[-_]?key|access[-_]?token|refresh[-_]?token|token|password|secret|credentials|private[-_]?key|authorization|headers|query[-_]?params)$/i.test(key)) {
45
- throw Object.assign(new Error('Credential field in public template configuration: ' + location + '.' + key), { code: 'SCAN_BLOCKED' });
164
+ if (onFinding) onFinding({ location: location + '.' + key });
165
+ else throw Object.assign(new Error('Credential field in public template configuration: ' + location + '.' + key), { code: 'INVALID_ARGUMENT' });
46
166
  }
47
167
  visit(item, location + '.' + key);
48
168
  }
@@ -52,7 +172,7 @@ export function assertPublicTemplateConfig(config) {
52
172
 
53
173
  export function renderText(text, vars = {}, externalAids = {}) {
54
174
  let out = text;
55
- const interpolate = value => value.replace(/\{\{\s*([a-z]+\.[a-z]+|members\.[a-z0-9][a-z0-9_-]{0,31}\.(?:aid|project))\s*\}\}/g,
175
+ const interpolate = value => value.replace(/\{\{\s*([a-z]+\.[a-z]+|members\.[a-z0-9][a-z0-9_.-]*\.(?:aid|project))\s*\}\}/g,
56
176
  (token, key) => {
57
177
  if (key.startsWith('members.') && !Object.hasOwn(vars, key)) fail('Unknown team member reference: ' + key);
58
178
  return Object.hasOwn(vars, key) ? String(vars[key]) : token;
@@ -107,10 +227,10 @@ export function bindTemplateProviders(config, { providers = {}, defaults = {}, f
107
227
  const reference = block.provider ?? defaults.baseagents?.[name]?.provider;
108
228
  const ref = typeof reference === 'string' ? { id: reference } : reference;
109
229
  if (ref !== undefined && (!record(ref) || typeof ref.id !== 'string')) fail('Provider identity required: ' + name);
110
- if (select.provider !== undefined && (typeof select.provider !== 'string' || !select.provider)) fail('Invalid selected Provider: ' + name);
111
- if (select.model !== undefined && (typeof select.model !== 'string' || !select.model.trim())) fail('Invalid model: ' + name);
230
+ if (select.provider !== undefined && select.provider !== null && (typeof select.provider !== 'string' || !select.provider)) fail('Invalid selected Provider: ' + name);
231
+ if (select.model !== undefined && select.model !== null && (typeof select.model !== 'string' || !select.model.trim())) fail('Invalid model: ' + name);
112
232
  if (select.effort !== undefined && select.effort !== null && (typeof select.effort !== 'string' || !select.effort)) fail('Invalid effort: ' + name);
113
- const selected = select.provider ?? ref?.id ?? fallbackProviders[name];
233
+ const selected = Object.hasOwn(select, 'provider') ? select.provider : ref?.id ?? fallbackProviders[name];
114
234
  const usable = providerUsable(providers, selected, name);
115
235
  const model = select.model ?? block.model ?? defaults.baseagents?.[name]?.model;
116
236
  const effort = Object.hasOwn(select, 'effort') ? select.effort : block.effort;
@@ -122,14 +242,16 @@ export function bindTemplateProviders(config, { providers = {}, defaults = {}, f
122
242
  }
123
243
  refs.push({ baseagent: name, template: { ...(ref ?? {}), model: block.model, effort: block.effort },
124
244
  match: usable ? 'reused' : 'select', provider: usable ? selected : null });
125
- if (!usable && (!allowMissing || select.provider !== undefined)) {
245
+ if (!usable && !allowMissing) {
126
246
  throw Object.assign(new Error('Provider binding required or unsupported service: ' + name), { code: 'PROVIDER_NOT_FOUND', refs });
127
247
  }
128
248
  if (Object.hasOwn(blocks, name) || Object.hasOwn(selections, name)) {
129
249
  out.baseagents ??= {};
130
250
  const bound = { ...structuredClone(block) };
131
- if (selected !== undefined) bound.provider = selected;
132
- if (select.model !== undefined) bound.model = select.model;
251
+ if (selected === null) delete bound.provider;
252
+ else if (selected !== undefined) bound.provider = selected;
253
+ if (select.model === null) delete bound.model;
254
+ else if (select.model !== undefined) bound.model = select.model;
133
255
  if (select.effort === null) delete bound.effort;
134
256
  else if (select.effort !== undefined) bound.effort = select.effort;
135
257
  out.baseagents[name] = bound;
@@ -138,8 +260,6 @@ export function bindTemplateProviders(config, { providers = {}, defaults = {}, f
138
260
  return { config: out, refs };
139
261
  }
140
262
 
141
- export const MEMBER_KEY = /^[a-z0-9][a-z0-9_-]{0,31}$/;
142
-
143
263
  export function teamMemberVariables(members, ownerAid, hostAid) {
144
264
  if (!record(members) || !Object.keys(members).length) fail('Team members required');
145
265
  const variables = { 'owner.aid': ownerAid, 'host.aid': hostAid };
@@ -159,9 +279,11 @@ export function planMemberConfig({ member, vars, providers, defaults = {}, fallb
159
279
  if (!record(member) || !MEMBER_KEY.test(member.key) || !record(vars)) fail('Invalid member plan');
160
280
  if (!['create_prebuilt', 'create_on_host', 'overlay_existing'].includes(mode)) fail('Invalid member plan mode');
161
281
  const parameters = resolveMemberParameters(member);
162
- const rendered = renderValue(member, vars);
282
+ const portable = structuredClone(member);
283
+ if (record(portable.config)) delete portable.config.access;
284
+ const rendered = renderValue(portable, vars);
163
285
  if (mode !== 'create_prebuilt' && (!record(rendered.config) || Object.keys(rendered.config)
164
- .some(key => !['chatmode', 'memory', 'active_baseagent', 'baseagents', 'version', 'update'].includes(key)))) fail('Unsupported live-host member configuration');
286
+ .some(key => !['chatmode', 'memory', 'access', 'active_baseagent', 'baseagents', 'version', 'update'].includes(key)))) fail('Unsupported live-host member configuration');
165
287
  const binding = bindTemplateProviders({ ...rendered.config, ...parameters }, { providers, defaults, fallbackProviders, selections, allowMissing, modelCatalog });
166
288
  return { key: member.key, profile: rendered.profile, skills: rendered.skills ?? {}, config: binding.config, providers: binding.refs };
167
289
  }
@@ -20,6 +20,7 @@ import fs from 'node:fs';
20
20
  import path from 'node:path';
21
21
  import { createHash } from 'node:crypto';
22
22
  import { normalizeTeam, normalizeTeamSchema, validateContractSchema } from './template-contract.mjs';
23
+ import { partitionTeamMembers, validateMemberResourceStates } from './template-runtime.mjs';
23
24
 
24
25
  /** 由工具写入,模板里出现即视为错误。 */
25
26
  export const MANAGED_AGENT_FIELDS = ['aid', 'enabled', 'lifecycle', 'owner', 'owners', 'channels', 'projects'];
@@ -30,19 +31,20 @@ export const HOME_ALLOWED = ['providers.json', 'agents', 'skills', '.env'];
30
31
  const HOME_AGENTS_ALLOWED = ['defaults.json'];
31
32
 
32
33
  /** 每个 agent 目录里允许出现的条目。配置文件不在其中——它由工具生成。 */
33
- const AGENT_DIR_ALLOWED = ['personal', 'triggers', 'events'];
34
+ const AGENT_DIR_ALLOWED = ['personal', 'triggers', 'events', 'services'];
34
35
 
35
- const KEY_RE = /^[a-z0-9][a-z0-9_-]{0,31}$/;
36
+ const KEY_RE = /^(?:[a-z0-9][a-z0-9_-]{0,31}|[a-z0-9][a-z0-9-]*(?:\.[a-z0-9][a-z0-9-]*){2,})$/;
36
37
  const NAME_RE = /^[a-z0-9][a-z0-9._-]{0,63}$/;
37
38
 
38
39
  function readJson(file) {
39
40
  return JSON.parse(fs.readFileSync(file, 'utf8'));
40
41
  }
41
42
 
42
- function listRel(root) {
43
+ function listRel(root, includeWorkspace = true) {
43
44
  const out = [];
44
45
  const walk = (dir) => {
45
46
  for (const e of fs.readdirSync(dir, { withFileTypes: true })) {
47
+ if (!includeWorkspace && dir === root && e.name === 'workspace') continue;
46
48
  const abs = path.join(dir, e.name);
47
49
  if (e.isSymbolicLink()) throw new Error(`symlinks are not allowed in templates: ${path.relative(root, abs)}`);
48
50
  if (e.isDirectory()) walk(abs);
@@ -66,7 +68,7 @@ export function templateDigest(dir) {
66
68
  * 读取并做结构校验(不依赖 EvolCore)。返回 { tpl, errors }。
67
69
  * schema 是否与 EvolCore 一致由 prepare 阶段用 validateConfig 复核。
68
70
  */
69
- export function loadTemplate(dir) {
71
+ export function loadTemplate(dir, { includeWorkspace = true, contextMemberKeys = [] } = {}) {
70
72
  const root = path.resolve(dir);
71
73
  const errors = [];
72
74
  for (const f of ['team.json', 'team.schema.json']) {
@@ -86,13 +88,20 @@ export function loadTemplate(dir) {
86
88
  const version = team.version;
87
89
  if (typeof name !== 'string' || !NAME_RE.test(name)) errors.push(`team.json name must match ${NAME_RE}`);
88
90
  const keys = team.agents.map(agent => agent.key);
91
+ const partition = partitionTeamMembers(team);
92
+ const { inlineMembers, externalContacts, assistantKey } = partition;
93
+ const actualKeys = inlineMembers.map(member => member.key);
94
+ if (!Array.isArray(contextMemberKeys) || contextMemberKeys.some(key => typeof key !== 'string' || !KEY_RE.test(key))) errors.push('Invalid member reference context');
95
+ if (errors.length) return { errors };
96
+ const referenceKeys = new Set([...actualKeys, ...contextMemberKeys]);
89
97
  if (keys.length === 0 || !keys.every(k => typeof k === 'string' && KEY_RE.test(k))) {
90
98
  errors.push('team.json agents keys are required and must be path-safe');
91
99
  }
92
100
  if (!schema || schema.type !== 'object') errors.push('team.schema.json must be a JSON Schema object');
93
101
 
94
102
  let files;
95
- try { files = listRel(root); } catch (err) { return { errors: [err.message] }; }
103
+ try { files = listRel(root, includeWorkspace); } catch (err) { return { errors: [err.message] }; }
104
+ try { validateMemberResourceStates(team, new Set(files.map(file => file.split(path.sep).join('/')))); } catch (err) { errors.push(err.message); }
96
105
 
97
106
  // .evolcore/ 只允许白名单内的条目
98
107
  const homeFiles = files.filter(f => f.startsWith('.evolcore/')).map(f => f.slice('.evolcore/'.length));
@@ -115,7 +124,7 @@ export function loadTemplate(dir) {
115
124
  const agentDirs = fs.existsSync(path.join(root, 'agents'))
116
125
  ? fs.readdirSync(path.join(root, 'agents'), { withFileTypes: true }).filter(e => e.isDirectory()).map(e => e.name)
117
126
  : [];
118
- for (const d of agentDirs) if (!keys.includes(d)) errors.push(`agents/${d} has no matching key in team.json`);
127
+ for (const d of agentDirs) if (!actualKeys.includes(d)) errors.push(`agents/${d} has no actual member in team.json`);
119
128
  for (const key of keys) {
120
129
  const agentRoot = path.join(root, 'agents', key);
121
130
  if (!fs.existsSync(agentRoot)) continue;
@@ -129,13 +138,27 @@ export function loadTemplate(dir) {
129
138
  const wsDirs = fs.existsSync(path.join(root, 'workspace'))
130
139
  ? fs.readdirSync(path.join(root, 'workspace'), { withFileTypes: true }).filter(e => e.isDirectory()).map(e => e.name)
131
140
  : [];
132
- for (const d of wsDirs) if (!keys.includes(d)) errors.push(`workspace/${d} has no matching key in team.json`);
141
+ for (const d of wsDirs) if (!actualKeys.includes(d)) errors.push(`workspace/${d} has no actual member in team.json`);
142
+
143
+ const references = (text, source) => {
144
+ for (const match of text.matchAll(/\{\{\s*members\.([a-z0-9_.-]+)\.(aid|project)\s*\}\}/g)) {
145
+ if (!referenceKeys.has(match[1])) errors.push(`${source}: Unknown team member reference: members.${match[1]}.${match[2]}; reference requires an unbuilt member ${match[1]}`);
146
+ }
147
+ };
148
+ for (const member of inlineMembers) references(JSON.stringify(member), `agents.${member.key}`);
149
+ references(JSON.stringify(team.host), 'host');
150
+ for (const relative of files) {
151
+ const name = relative.split(path.sep).join('/');
152
+ if (['team.json', 'team.schema.json'].includes(name)) continue;
153
+ const bytes = fs.readFileSync(path.join(root, relative));
154
+ if (!bytes.includes(0) && Buffer.from(bytes.toString('utf8')).equals(bytes)) references(bytes.toString('utf8'), name);
155
+ }
133
156
 
134
157
  if (errors.length) return { errors };
135
158
  return {
136
159
  errors,
137
160
  tpl: {
138
- root, name, version, keys, files, team, schema, changes: normalized.changes,
161
+ root, name, version, keys, actualKeys, inlineMembers, externalContacts, assistantKey, partition, files, team, schema, changes: normalized.changes,
139
162
  label: `${name}@${version || templateDigest(root)}`,
140
163
  },
141
164
  };