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,22 +1,24 @@
1
1
  import { createHash } from 'node:crypto';
2
2
  import { readFileSync } from 'node:fs';
3
- import { BaseagentRunnerUnavailableError } from '../agents/runner-types.js';
4
- import { buildReloadHooks } from './channel-loader.js';
5
- import { AgentReloadBusyError, AgentReloadCoordinator } from './agent-reload-coordinator.js';
3
+ import { BaseagentRunnerUnavailableError } from '../baseagent/runner-types.js';
4
+ import { buildReloadHooks } from '../channel/channel-loader.js';
5
+ import { AgentReloadBusyError, AgentReloadCoordinator, createRunnerReloadTransaction, disposeAgentInstances } from './agent-reload-coordinator.js';
6
6
  import { detectDuplicates } from './evolagent-registry.js';
7
- import { createRunnerReloadTransaction, disposeAgentInstances } from './runner-reload-transaction.js';
8
- import { ConfigTarget, assertAgentAidAvailable, read as readConfig } from '../config/config-manager.js';
9
- import { invalidateKitCache } from '../eck/kit-renderer.js';
10
- import { logger } from '../utils/logger.js';
7
+ import { ConfigTarget, assertAgentAidAvailable, read as readConfig } from '../../config/config-manager.js';
8
+ import { invalidateKitCache } from '../../eck/kit-renderer.js';
9
+ import { logger } from '../../utils/logger.js';
11
10
  import fs from 'fs';
11
+ import { agentProjectChangeGate } from '../../config-store.js';
12
12
  import path from 'path';
13
- import { resolvePaths } from '../paths.js';
14
- import { ownerResolver } from './ownership/owner-resolver.js';
15
- import { AgentInitializationService, InitializationStateError, initializationErrorCode, readInitialization } from '../cli/agent-create.js';
16
- import { getAidStore, loadClient } from '../aun/aid/store.js';
17
- import { isValidAid } from '../aun/aid/validation.js';
18
- import { readPreparedTemplateIdentity } from '../agent-template/runtime.js';
13
+ import { resolvePaths } from '../../paths.js';
14
+ import { ownerResolver } from '../ownership/owner-resolver.js';
15
+ import { AgentInitializationService, InitializationStateError, initializationErrorCode, readInitialization } from '../../cli/agent-create.js';
16
+ import { getAidStore, loadClient } from '../../aun/aid/store.js';
17
+ import { isValidAid } from '../../aun/aid/validation.js';
18
+ import { readPreparedTemplateIdentity } from '../../agent-template/runtime.js';
19
19
  import { readAgentCreationClaim } from './agent-creation-claim.js';
20
+ import { getCcAgentAid } from '../../claude-gateway/agent-registration.js';
21
+ import { sendAgentCreationOwnershipCard } from './agent-create-status.js';
20
22
  export function loadStartupAgentRegistry(agentRegistry) {
21
23
  agentRegistry.loadAll();
22
24
  const agentInfos = agentRegistry.list();
@@ -44,9 +46,9 @@ export function loadStartupAgentRegistry(agentRegistry) {
44
46
  const owners = duplicate.agents.map(owner => `${owner.aid}(${owner.channelName})`).join(', ');
45
47
  logger.warn(`⚠ Duplicate channel credential: ${duplicate.fingerprint} claimed by ${owners}.`);
46
48
  }
47
- const primaryAgent = agentRegistry.runnableAgents()[0];
49
+ const primaryAgent = agentRegistry.runnableAgents().find(agent => agent.aid !== getCcAgentAid());
48
50
  const runtimeStatus = { state: primaryAgent ? 'starting' : 'empty' };
49
- if (!primaryAgent && agentInfos.length > 0) {
51
+ if (!primaryAgent && agentInfos.some(agent => agent.aid !== getCcAgentAid())) {
50
52
  runtimeStatus.state = 'error';
51
53
  runtimeStatus.error = 'No runnable self-agent (all are error/disabled).';
52
54
  logger.warn(`[startup] ${runtimeStatus.error} Control Plane will remain available.`);
@@ -74,7 +76,7 @@ export function createOnDemandAgentRunners(deps) {
74
76
  await deps.coordinator.runRunnerOperation(aid, async () => {
75
77
  assertRunning();
76
78
  const agent = deps.agentRegistry.get(aid);
77
- const available = agent && agent.config.enabled !== false && agent.status !== 'disabled' && agent.status !== 'stopped'
79
+ const available = agent && !agentProjectChangeGate(aid) && agent.config.enabled !== false && agent.status !== 'disabled' && agent.status !== 'stopped'
78
80
  ? deps.agentLoader.enabledBaseagents(agent) : [];
79
81
  if (!agent || !available.includes(baseagent)) {
80
82
  throw new BaseagentRunnerUnavailableError(aid, baseagent, available);
@@ -165,7 +167,7 @@ export async function createStartupAgentRunners({ agentRegistry, agentLoader, se
165
167
  throw error;
166
168
  }
167
169
  activeSettled.add(agent.aid);
168
- if (!instances.some(instance => instance.baseagent === agent.baseagent)) {
170
+ if (agent.aid !== getCcAgentAid() && !instances.some(instance => instance.baseagent === agent.baseagent)) {
169
171
  agent.status = 'error';
170
172
  agent.error = creationErrors.filter(error => error.evolagentName === agent.name)
171
173
  .map(({ baseagent, message }) => `${baseagent}: ${message}`).join('; ')
@@ -189,9 +191,9 @@ export async function createStartupAgentRunners({ agentRegistry, agentLoader, se
189
191
  throw error;
190
192
  }
191
193
  await activeReady(agent, instances, timing);
192
- if (primaryAgent?.aid === agent.aid
194
+ if (agent.aid !== getCcAgentAid() && (primaryAgent?.aid === agent.aid
193
195
  ? !instances.some(instance => instance.baseagent === primaryBaseagent)
194
- : !instances.some(instance => instance.baseagent === agent.baseagent)) {
196
+ : !instances.some(instance => instance.baseagent === agent.baseagent))) {
195
197
  const errors = creationErrors.filter(error => error.evolagentName === agent.name);
196
198
  agent.status = 'error';
197
199
  agent.error = errors.length > 0
@@ -234,7 +236,7 @@ export async function createStartupAgentRunners({ agentRegistry, agentLoader, se
234
236
  }
235
237
  export async function completeStartupAgentRuntime(agentRegistry, current) {
236
238
  try {
237
- const { watchAgentSkills } = await import('./skill/startup.js');
239
+ const { watchAgentSkills } = await import('../skill/startup.js');
238
240
  for (const agent of agentRegistry.allAgents()) {
239
241
  if (agent.status === 'running')
240
242
  watchAgentSkills(agent.aid);
@@ -416,6 +418,7 @@ export function createAgentInitializationRuntime({ agentRegistry, agentMap, chan
416
418
  const isConnected = (aid) => channelInstances.some(instance => instance.channelType === 'aun'
417
419
  && instance.channel.getAidState?.()?.aid === aid
418
420
  && instance.channel.getAidState?.()?.status === 'connected');
421
+ const ownerObservers = new Map();
419
422
  return new AgentInitializationService({
420
423
  preparedIdentity: (aid, ownerAid) => {
421
424
  return readAgentCreationClaim(aid)?.teamJobId ? readPreparedTemplateIdentity(aid, ownerAid) : undefined;
@@ -425,12 +428,12 @@ export function createAgentInitializationRuntime({ agentRegistry, agentMap, chan
425
428
  assertAgentAidAvailable(aid);
426
429
  const claim = (await import('./agent-creation-claim.js')).readAgentCreationClaim(aid);
427
430
  if (claim?.teamJobId) {
428
- const { readPreparedTemplateIdentity } = await import('../agent-template/runtime.js');
431
+ const { readPreparedTemplateIdentity } = await import('../../agent-template/runtime.js');
429
432
  readPreparedTemplateIdentity(aid, ownerAid);
430
433
  return;
431
434
  }
432
- const { aidCreateIdentityOnly } = await import('../aun/aid/identity.js');
433
- const { assertAgentIdentityReusable } = await import('../aun/aid/agentmd.js');
435
+ const { aidCreateIdentityOnly } = await import('../../aun/aid/identity.js');
436
+ const { assertAgentIdentityReusable } = await import('../../aun/aid/agentmd.js');
434
437
  const created = await aidCreateIdentityOnly(aid, { type: 'agent' });
435
438
  try {
436
439
  if (created.alreadyExisted)
@@ -448,7 +451,7 @@ export function createAgentInitializationRuntime({ agentRegistry, agentMap, chan
448
451
  bindOwner: async (aid, ownerAid) => {
449
452
  const claim = (await import('./agent-creation-claim.js')).readAgentCreationClaim(aid);
450
453
  if (claim?.teamJobId) {
451
- const { readPreparedTemplateIdentity } = await import('../agent-template/runtime.js');
454
+ const { readPreparedTemplateIdentity } = await import('../../agent-template/runtime.js');
452
455
  return readPreparedTemplateIdentity(aid, ownerAid).bindingTask;
453
456
  }
454
457
  // Initialization happens before the new Agent is hot-loaded. Use a
@@ -458,6 +461,19 @@ export function createAgentInitializationRuntime({ agentRegistry, agentMap, chan
458
461
  // persist its operation ID beside the creation receipt.
459
462
  return bindInitializationOwner(aid, ownerAid);
460
463
  },
464
+ notifyOwnershipBinding: async ({ creationId, binding, origin }) => {
465
+ const instance = channelInstances.find(candidate => candidate.channelType === 'aun'
466
+ && candidate.adapter.channelKey.startsWith(`aun#${origin.creatorAid}#`));
467
+ if (!instance) {
468
+ return {
469
+ status: 'failed',
470
+ operationId: `agent-owner-bind:${creationId}:${binding.operationId}`,
471
+ code: 'ORIGIN_CHANNEL_UNAVAILABLE',
472
+ error: 'Original Creator AUN channel is unavailable',
473
+ };
474
+ }
475
+ return sendAgentCreationOwnershipCard({ adapter: instance.adapter, creationId, binding, origin });
476
+ },
461
477
  ownerBindActive: (aid, ownerAid) => {
462
478
  const record = readInitialization(aid);
463
479
  if (record?.plan.ownerAid === ownerAid && record.ownerBindSubmitted === true)
@@ -468,16 +484,25 @@ export function createAgentInitializationRuntime({ agentRegistry, agentMap, chan
468
484
  },
469
485
  checkOwner: (aid, ownerAid) => isConnected(aid)
470
486
  ? checkInitializationOwner(aid, ownerAid, readInitialization(aid)?.mode === 'one_shot' ? 1 : undefined)
471
- : checkBootstrapInitializationOwner(aid, ownerAid),
487
+ : ownerObservers.get(aid)?.check(ownerAid) ?? checkBootstrapInitializationOwner(aid, ownerAid),
488
+ watchOwner: (aid, onChange) => {
489
+ const observer = createInitializationOwnerObserver(aid, onChange);
490
+ ownerObservers.set(aid, observer);
491
+ return async () => {
492
+ if (ownerObservers.get(aid) === observer)
493
+ ownerObservers.delete(aid);
494
+ await observer.close();
495
+ };
496
+ },
472
497
  publish: async (aid, content, ownerAid) => {
473
- const { agentmdPut, agentmdPutInitializationProfile } = await import('../aun/aid/agentmd.js');
498
+ const { agentmdPut, agentmdPutInitializationProfile } = await import('../../aun/aid/agentmd.js');
474
499
  if (ownerAid)
475
500
  await agentmdPutInitializationProfile(content, { aid, ownerAid });
476
501
  else
477
502
  await agentmdPut(content, { aid });
478
503
  },
479
504
  fetch: async (aid) => {
480
- const { agentmdGet } = await import('../aun/aid/agentmd.js');
505
+ const { agentmdGet } = await import('../../aun/aid/agentmd.js');
481
506
  const card = await agentmdGet(aid, { withVerification: true, remoteOnly: true });
482
507
  return { content: card.content, verified: card.verification.status === 'verified' };
483
508
  },
@@ -524,7 +549,7 @@ export function recoverIncompleteAgentInitializations(service, agentsDir = resol
524
549
  }
525
550
  }
526
551
  }
527
- export function createAgentRuntimeOperations({ agentRegistry, agentLoader, sessionManager, agentMap, permissionGateway, processor, channelLoader, channelInstances, registerChannelInstance, markChannelConnected, aidStatsCollector, handoffRuntime, triggerSchedulers, ensureTriggerSchedulerStarted, startTriggerScheduler, reloadCoordinator, unregisterRuntimeChannel, messageQueue, setAgentRuntimeState, setAgentRuntimeError, }) {
552
+ export function createAgentRuntimeOperations({ agentRegistry, agentLoader, sessionManager, agentMap, permissionGateway, processor, channelLoader, channelInstances, registerChannelInstance, setAgentChannels, markChannelConnected, aidStatsCollector, handoffRuntime, triggerSchedulers, ensureTriggerSchedulerStarted, startTriggerScheduler, reloadCoordinator, unregisterRuntimeChannel, messageQueue, setAgentRuntimeState, setAgentRuntimeError, }) {
528
553
  const hotLoad = async (aid) => {
529
554
  assertAgentAidAvailable(aid);
530
555
  handoffRuntime.pauseAgent(aid);
@@ -574,6 +599,9 @@ export function createAgentRuntimeOperations({ agentRegistry, agentLoader, sessi
574
599
  agent.channels.set(instance.adapter.channelKey, instance.adapter);
575
600
  channelInstances.push(instance);
576
601
  }
602
+ // 与启动路径(index.ts 的 channelInstancesByAgent.set)对齐:热加载也必须登记
603
+ // 这批实例,否则事件中心/启动门/状态快照按 aid 查渠道时永远查不到。
604
+ setAgentChannels?.(aid, instances);
577
605
  agent.status = 'running';
578
606
  await channelLoader.connectAll(instances, { onConnected: markChannelConnected });
579
607
  await handoffRuntime.recover([aid], { discardExpired: false });
@@ -614,13 +642,15 @@ export function createAgentRuntimeOperations({ agentRegistry, agentLoader, sessi
614
642
  unregisterRuntimeChannel(channelName);
615
643
  }
616
644
  runtimeAgent.channels?.clear();
645
+ // 与上面的登记对称:卸载后按 aid 查渠道必须查不到,否则会拿到已断开的实例。
646
+ setAgentChannels?.(aid, undefined);
617
647
  for (const [key, runner] of agentMap) {
618
648
  if (!key.startsWith(`${aid}::`))
619
649
  continue;
620
650
  await runner.dispose?.();
621
651
  agentMap.delete(key);
622
652
  }
623
- const { globalSkillWatcher } = await import('./skill/global-watcher.js');
653
+ const { globalSkillWatcher } = await import('../skill/global-watcher.js');
624
654
  await globalSkillWatcher.unwatchAgent(aid);
625
655
  agentRegistry.remove(aid);
626
656
  messageQueue.clearByAgent(runtimeAgent.name);
@@ -646,7 +676,7 @@ export function createAgentRuntimeOperations({ agentRegistry, agentLoader, sessi
646
676
  return resyncInFlight;
647
677
  const operation = (async () => {
648
678
  invalidateKitCache();
649
- const { loadAllAgents: scanAgents } = await import('../config-store.js');
679
+ const { loadAllAgents: scanAgents } = await import('../../config-store.js');
650
680
  const { agents: diskAgents } = scanAgents();
651
681
  const results = [];
652
682
  for (const [aid] of [...agentRegistry.agents.entries()]) {
@@ -738,6 +768,24 @@ const AUDITED_WORKFLOW_SHA256 = {
738
768
  '0.5.35': '55b6d41331b4dfc6b377be9f4ff28d322af5e06fc4539c5d0120cb15419623f6',
739
769
  // 0.5.36 retains the audited workflow; installed SDK preflight and execute boundaries were revalidated.
740
770
  '0.5.36': '55b6d41331b4dfc6b377be9f4ff28d322af5e06fc4539c5d0120cb15419623f6',
771
+ // 0.5.37 ships byte-identical workflow bytes and dependencies (errors/ownership-v21) plus an
772
+ // unchanged injection block in client.js; the only ownership-related delta records the
773
+ // X-AUN-Owner-MD-SHA256 header after a completed agent.md download, leaving read/execute
774
+ // ordering untouched.
775
+ '0.5.37': '55b6d41331b4dfc6b377be9f4ff28d322af5e06fc4539c5d0120cb15419623f6',
776
+ // 0.5.38 changes exactly one thing: the `yaml` import moves from a static import to a lazy
777
+ // createRequire call inside parseOwnershipMessage, so the module no longer loads yaml at import
778
+ // time. No read/verify/execute ordering moved; start()/capture() still only read and verify, and
779
+ // every persist and notification still happens inside execute().
780
+ '0.5.38': '56d834587a3211a36e20a2574357b172f1d223b48b4d393b7b83989e2955d55d',
781
+ // 0.5.41 removes the release workflow and passes transfer state into owner declaration. The
782
+ // audited bind path keeps the same boundary: start()/capture() only read and verify, while all
783
+ // persistence and notifications remain inside execute().
784
+ '0.5.41': '1d1594477bfaf220042fcdaf696605a36c79ff9ec9f3141d40c3e5c10c5ca58f',
785
+ // 0.5.42 keeps byte-identical workflow bytes (same SHA-256 as 0.5.41); the release changes
786
+ // consensus caching and identity invalidation outside this artifact, so the audited
787
+ // read/verify/execute boundary is unchanged.
788
+ '0.5.42': '1d1594477bfaf220042fcdaf696605a36c79ff9ec9f3141d40c3e5c10c5ca58f',
741
789
  };
742
790
  export function initializationBindPreflightFailure(error) {
743
791
  if (!(error instanceof Error) || error.code !== 'ECONNRESET')
@@ -758,49 +806,167 @@ export function initializationBindPreflightFailure(error) {
758
806
  }
759
807
  }
760
808
  /** Initial binding precedes the daemon channel; use an independent short slot. */
761
- async function withInitializationClient(aid, action) {
809
+ async function openInitializationClient(aid, subscribe) {
762
810
  let store;
763
811
  let client;
764
- let actionStarted = false;
812
+ const close = async () => {
813
+ // A close failure must not discard an exact task already returned by bind.
814
+ try {
815
+ await client?.close();
816
+ }
817
+ catch { /* preserve operation result */ }
818
+ try {
819
+ store?.close();
820
+ }
821
+ catch { /* preserve operation result */ }
822
+ };
765
823
  try {
766
824
  store = await getAidStore({ slotId: 'evolcore-initialization' });
767
825
  client = await loadClient(store, aid);
768
826
  if (client.currentAid?.aid !== aid || !client.currentAid.isCertValid() || !client.currentAid.isPrivateKeyValid()) {
769
827
  throw Object.assign(new Error('Initialization identity is unavailable'), { code: 'INITIALIZE_IDENTITY_UNAVAILABLE' });
770
828
  }
829
+ subscribe?.(client);
771
830
  await client.connect({ connection_kind: 'short', short_ttl_ms: 120_000,
772
831
  background_sync: false, auto_reconnect: false, connect_timeout: 10, call_timeout: 30 });
773
- // An entered bind can have remote effects. Its adapter may only mark an
774
- // audited read-only preflight as not started; all other failures stay unknown.
775
- actionStarted = true;
776
- return await action(client, store);
832
+ return { client, store, close };
777
833
  }
778
834
  catch (error) {
779
- if (!actionStarted) {
780
- const original = error instanceof Error ? error : new Error(String(error));
781
- throw Object.assign(new Error(original.message), {
782
- code: 'INITIALIZE_BIND_NOT_STARTED',
783
- cause: error,
784
- causeCode: error?.code,
785
- });
786
- }
787
- throw error;
835
+ await close();
836
+ const original = error instanceof Error ? error : new Error(String(error));
837
+ throw Object.assign(new Error(original.message), {
838
+ code: 'INITIALIZE_BIND_NOT_STARTED', cause: error,
839
+ causeCode: error?.code,
840
+ });
841
+ }
842
+ }
843
+ async function withInitializationClient(aid, action) {
844
+ const connection = await openInitializationClient(aid);
845
+ try {
846
+ return await action(connection.client, connection.store);
788
847
  }
789
848
  finally {
790
- // A close failure must not discard the exact task already returned by bind.
791
- try {
792
- await client?.close();
793
- }
794
- catch { /* preserve operation result */ }
795
- try {
796
- store?.close();
797
- }
798
- catch { /* preserve operation result */ }
849
+ await connection.close();
799
850
  }
800
851
  }
852
+ /** Keep an event-capable short connection until hot-load, rebuilding it after loss or expiry. */
853
+ export function createInitializationOwnerObserver(aid, onChange) {
854
+ let current;
855
+ let stopped = false;
856
+ let retiring = Promise.resolve();
857
+ const retire = (entry) => {
858
+ if (entry.closed)
859
+ return retiring;
860
+ entry.closed = true;
861
+ if (current === entry)
862
+ current = undefined;
863
+ clearTimeout(entry.timer);
864
+ for (const subscription of entry.subscriptions)
865
+ subscription.unsubscribe();
866
+ const closing = entry.ready.then(connection => connection.close(), () => { });
867
+ retiring = Promise.allSettled([retiring, closing]).then(() => { });
868
+ return retiring;
869
+ };
870
+ const connection = () => {
871
+ if (stopped)
872
+ throw new Error('Initialization Owner observer is closed');
873
+ if (current)
874
+ return current;
875
+ const previousRetirement = retiring;
876
+ const entry = {
877
+ closed: false, subscriptions: [],
878
+ ready: Promise.resolve().then(async () => {
879
+ await previousRetirement;
880
+ if (stopped || entry.closed)
881
+ throw new Error('Initialization Owner observer is closed');
882
+ const opened = await openInitializationClient(aid, client => {
883
+ if (stopped || entry.closed)
884
+ throw new Error('Initialization Owner observer is closed');
885
+ const changed = () => {
886
+ if (!stopped && !entry.closed && current === entry)
887
+ onChange();
888
+ };
889
+ for (const event of ['ownership.request', 'ownership.pending', 'ownership.progress', 'ownership.completed',
890
+ 'ownership.rejected', 'ownership.stopped', 'ownership.error', 'ownership.action_required']) {
891
+ entry.subscriptions.push(client.on(event, payload => {
892
+ if (payload && typeof payload === 'object' && 'sub_aid' in payload && payload.sub_aid === aid)
893
+ changed();
894
+ }));
895
+ }
896
+ entry.subscriptions.push(client.on('agentmd.changed', payload => { if (payload === aid)
897
+ changed(); }));
898
+ entry.subscriptions.push(client.on('agent_md_changed', payload => {
899
+ if (payload && typeof payload === 'object' && 'aid' in payload && payload.aid === aid)
900
+ changed();
901
+ }));
902
+ entry.subscriptions.push(client.on('storage.object_changed', payload => {
903
+ if (payload && typeof payload === 'object' && 'owner_aid' in payload && payload.owner_aid === aid
904
+ && 'object_key' in payload && typeof payload.object_key === 'string'
905
+ && payload.object_key.replace(/^\/+/, '') === 'agent.md')
906
+ changed();
907
+ }));
908
+ for (const event of ['state_change', 'connection.state']) {
909
+ entry.subscriptions.push(client.on(event, payload => {
910
+ if (stopped || entry.closed || current !== entry)
911
+ return;
912
+ const state = typeof payload === 'string' ? payload
913
+ : payload && typeof payload === 'object'
914
+ ? ('state' in payload ? payload.state : 'status' in payload ? payload.status : undefined) : undefined;
915
+ if (entry.timer && typeof state === 'string' && state !== 'ready' && state !== 'connected') {
916
+ void retire(entry);
917
+ if (!stopped)
918
+ onChange();
919
+ }
920
+ }));
921
+ }
922
+ });
923
+ if (!entry.closed) {
924
+ // Renew before the gateway's 120-second short-session TTL.
925
+ entry.timer = setTimeout(() => {
926
+ if (stopped || entry.closed || current !== entry)
927
+ return;
928
+ void retire(entry);
929
+ if (!stopped)
930
+ onChange();
931
+ }, 110_000);
932
+ entry.timer.unref?.();
933
+ }
934
+ return opened;
935
+ }),
936
+ };
937
+ current = entry;
938
+ // Setup can finish after cancellation, or fail before the worker starts its check.
939
+ void entry.ready.catch(() => { void retire(entry); });
940
+ return entry;
941
+ };
942
+ connection();
943
+ return {
944
+ check: async (ownerAid) => {
945
+ let entry;
946
+ try {
947
+ entry = connection();
948
+ const { client } = await entry.ready;
949
+ if (stopped || entry.closed)
950
+ throw new Error('Initialization Owner observer is closed');
951
+ return await readBootstrapInitializationOwner(client, aid, ownerAid);
952
+ }
953
+ catch (error) {
954
+ if (entry)
955
+ await retire(entry);
956
+ return unavailableInitializationOwner(error);
957
+ }
958
+ },
959
+ close: async () => {
960
+ stopped = true;
961
+ if (current)
962
+ await retire(current);
963
+ await retiring;
964
+ },
965
+ };
966
+ }
801
967
  export async function bindInitializationOwner(aid, ownerAid) {
802
968
  return withInitializationClient(aid, async (client, store) => {
803
- const { assertHumanAgentOwner } = await import('../aun/aid/agentmd.js');
969
+ const { assertHumanAgentOwner } = await import('../../aun/aid/agentmd.js');
804
970
  await assertHumanAgentOwner(ownerAid, { store });
805
971
  try {
806
972
  return await client.bindOwneraid(ownerAid);
@@ -819,37 +985,41 @@ export async function bindInitializationOwner(aid, ownerAid) {
819
985
  /** Ordinary creation is retryable; reuse a matching relation without rebinding. */
820
986
  export async function bindAgentCreationOwner(aid, ownerAid) {
821
987
  return withInitializationClient(aid, async (client) => {
822
- const { aidEnsureOwnerBinding } = await import('../aun/aid/identity.js');
988
+ const { aidEnsureOwnerBinding } = await import('../../aun/aid/identity.js');
823
989
  return aidEnsureOwnerBinding(client, aid, ownerAid);
824
990
  });
825
991
  }
826
992
  /** Each bootstrap observation has a new SDK client and no cached consensus. */
827
993
  export async function checkBootstrapInitializationOwner(aid, ownerAid) {
828
994
  try {
829
- return await withInitializationClient(aid, async (client) => {
830
- const view = await client.checkOwnershipConsensus(aid, true);
831
- const checkedAt = Date.now();
832
- const details = {
833
- ...(['consensus', 'released', 'unbound', 'single_sided', 'invalid', 'unavailable', 'not_applicable'].includes(view.status)
834
- ? { consensusStatus: view.status } : {}),
835
- ...(Number.isSafeInteger(view.relation_version) && view.relation_version >= 0 ? { relationVersion: view.relation_version } : {}),
836
- ...(['locked', 'unlocked'].includes(view.lock) ? { lock: view.lock } : {}),
837
- ...(view.code ? { code: initializationErrorCode(view, 'INITIALIZE_OWNER_CHECK_FAILED') } : {}),
838
- ...(typeof view.retryable === 'boolean' ? { retryable: view.retryable } : {}),
839
- };
840
- if (view.status === 'consensus' && view.sub_aid === aid && view.lock === 'locked'
841
- && view.relation_version === 1 && typeof view.owner_aid === 'string' && isValidAid(view.owner_aid) && view.owner_aid !== aid) {
842
- return { status: view.owner_aid === ownerAid ? 'confirmed' : 'conflict', ownerAid: view.owner_aid, checkedAt, ...details };
843
- }
844
- return { status: 'pending', checkedAt, ...details };
845
- });
995
+ return await withInitializationClient(aid, client => readBootstrapInitializationOwner(client, aid, ownerAid));
846
996
  }
847
997
  catch (error) {
848
- // An unavailable observation never confirms a relation or replays bind.
849
- const codeSource = error?.code === 'INITIALIZE_BIND_NOT_STARTED'
850
- ? { code: error.causeCode }
851
- : error;
852
- return { status: 'pending', consensusStatus: 'unavailable',
853
- code: initializationErrorCode(codeSource, 'INITIALIZE_OWNER_CHECK_FAILED'), retryable: true };
998
+ return unavailableInitializationOwner(error);
999
+ }
1000
+ }
1001
+ async function readBootstrapInitializationOwner(client, aid, ownerAid) {
1002
+ const view = await client.checkOwnershipConsensus(aid, true);
1003
+ const checkedAt = Date.now();
1004
+ const details = {
1005
+ ...(['consensus', 'released', 'unbound', 'single_sided', 'invalid', 'unavailable', 'not_applicable'].includes(view.status)
1006
+ ? { consensusStatus: view.status } : {}),
1007
+ ...(Number.isSafeInteger(view.relation_version) && view.relation_version >= 0 ? { relationVersion: view.relation_version } : {}),
1008
+ ...(['locked', 'unlocked'].includes(view.lock) ? { lock: view.lock } : {}),
1009
+ ...(view.code ? { code: initializationErrorCode(view, 'INITIALIZE_OWNER_CHECK_FAILED') } : {}),
1010
+ ...(typeof view.retryable === 'boolean' ? { retryable: view.retryable } : {}),
1011
+ };
1012
+ if (view.status === 'consensus' && view.sub_aid === aid && view.lock === 'locked'
1013
+ && view.relation_version === 1 && typeof view.owner_aid === 'string' && isValidAid(view.owner_aid) && view.owner_aid !== aid) {
1014
+ return { status: view.owner_aid === ownerAid ? 'confirmed' : 'conflict', ownerAid: view.owner_aid, checkedAt, ...details };
854
1015
  }
1016
+ return { status: 'pending', checkedAt, ...details };
1017
+ }
1018
+ function unavailableInitializationOwner(error) {
1019
+ // An unavailable observation never confirms a relation or replays bind.
1020
+ const codeSource = error?.code === 'INITIALIZE_BIND_NOT_STARTED'
1021
+ ? { code: error.causeCode }
1022
+ : error;
1023
+ return { status: 'pending', consensusStatus: 'unavailable',
1024
+ code: initializationErrorCode(codeSource, 'INITIALIZE_OWNER_CHECK_FAILED'), retryable: true };
855
1025
  }
@@ -1,17 +1,16 @@
1
1
  import fs from 'fs';
2
2
  import path from 'path';
3
3
  import { EvolAgent } from './evolagent.js';
4
- import { logger } from '../utils/logger.js';
5
- import { aidLocalDir } from '../paths.js';
6
- import { readSoulContent } from './soul.js';
7
- import { invalidateAgentDisplayName, resolveAgentDisplayName } from '../aun/aid/agentmd.js';
8
- import { loadAllAgents, ensureAgentDirSkeleton, loadAgent, validateAgentConfig, } from '../config-store.js';
9
- import { ConfigTarget, assertAgentAidAvailable, read as readConfig, resolveEffective } from '../config/config-manager.js';
10
- import { ensureInitialRoleRegistry } from '../config/role-service.js';
11
- import { resolveAgentLifecycle } from '../config/lifecycle.js';
12
- import { getOwners, getPrimaryOwner, ownerResolver } from './ownership/owner-resolver.js';
13
- import { configuredOwnerList } from '../config/owner-config.js';
14
- import { assertTemplateInstallationReady } from '../agent-template/jobs.js';
4
+ import { logger } from '../../utils/logger.js';
5
+ import { aidLocalDir } from '../../paths.js';
6
+ import { readSoulContent } from '../../eck/manifest-engine.js';
7
+ import { invalidateAgentDisplayName, resolveAgentDisplayName } from '../../aun/aid/agentmd.js';
8
+ import { loadAllAgents, ensureAgentDirSkeleton, loadAgent, agentProjectChangeGate, assertAgentProjectChangeReady, validateAgentConfig, } from '../../config-store.js';
9
+ import { ConfigTarget, assertAgentAidAvailable, read as readConfig, resolveEffective } from '../../config/config-manager.js';
10
+ import { ensureInitialRoleRegistry } from '../../config/role-service.js';
11
+ import { resolveAgentLifecycle } from '../../config/lifecycle.js';
12
+ import { getOwners, getPrimaryOwner, ownerResolver } from '../ownership/owner-resolver.js';
13
+ import { assertTemplateInstallationReady } from '../../agent-template/jobs.js';
15
14
  // ── Channel Fingerprint ───────────────────────────────────────────────────
16
15
  // 用于检测多 agent 之间复用同一外部凭证的冲突(appId、aid、token 等)。
17
16
  // 格式:{type}:{primaryKey}
@@ -96,7 +95,6 @@ export class EvolAgentRegistry {
96
95
  for (const expandedRaw of rawAgents) {
97
96
  try {
98
97
  const raw = readConfig(ConfigTarget.Agent, { self: expandedRaw.aid }, { cache: true }) ?? expandedRaw;
99
- ownerResolver.setAgentConfiguredOwners(expandedRaw.aid, configuredOwnerList(raw));
100
98
  const precheck = precheckAgentConfig(expandedRaw.aid, raw);
101
99
  if (precheck) {
102
100
  this.registerErrorAgent(raw, `${precheck.code}: ${precheck.detail}`);
@@ -106,6 +104,13 @@ export class EvolAgentRegistry {
106
104
  // still reload through ConfigManager's normal atomic reader.
107
105
  const merged = resolveEffective({ self: expandedRaw.aid }, { cache: true });
108
106
  const agent = new EvolAgent(raw, merged);
107
+ const projectGate = agentProjectChangeGate(agent.aid);
108
+ if (projectGate) {
109
+ agent.status = projectGate.state === 'recovery' ? 'error' : 'stopped';
110
+ if (projectGate.state === 'recovery')
111
+ agent.error = 'PROJECT_RECOVERY_REQUIRED';
112
+ this.manuallyStopped.add(agent.aid);
113
+ }
109
114
  ensureAgentDirSkeleton(expandedRaw.aid);
110
115
  ensureInitialRoleRegistry(expandedRaw.aid);
111
116
  this.agents.set(agent.aid, agent);
@@ -116,7 +121,6 @@ export class EvolAgentRegistry {
116
121
  }
117
122
  for (const { agent: expandedRaw, reason } of invalidAgents) {
118
123
  const raw = readConfig(ConfigTarget.Agent, { self: expandedRaw.aid }, { cache: true }) ?? expandedRaw;
119
- ownerResolver.setAgentConfiguredOwners(expandedRaw.aid, configuredOwnerList(raw));
120
124
  this.registerErrorAgent(raw, reason);
121
125
  }
122
126
  this.detectAndFlagConflicts();
@@ -242,12 +246,13 @@ export class EvolAgentRegistry {
242
246
  this.personalNameCache.delete(aid);
243
247
  }
244
248
  runnableAgents() {
245
- return this.allAgents().filter(a => a.status === 'stopped');
249
+ return this.allAgents().filter(a => a.status === 'stopped' && !agentProjectChangeGate(a.aid));
246
250
  }
247
251
  getSkipped() {
248
252
  return [...this.skipped];
249
253
  }
250
254
  loadNewAgent(aid) {
255
+ assertAgentProjectChangeReady(aid);
251
256
  assertAgentAidAvailable(aid);
252
257
  if (this.agents.has(aid)) {
253
258
  logger.info(`[EvolAgentRegistry] agent ${aid} already loaded, skipping`);
@@ -288,7 +293,6 @@ export class EvolAgentRegistry {
288
293
  return this.registerErrorAgent(expandedRaw, `${precheck.code}: ${precheck.detail}`);
289
294
  }
290
295
  const raw = readConfig(ConfigTarget.Agent, { self: aid }, { cache: true }) ?? expandedRaw;
291
- ownerResolver.setAgentConfiguredOwners(aid, configuredOwnerList(raw));
292
296
  const merged = resolveEffective({ self: aid }, {});
293
297
  const agent = new EvolAgent(raw, merged);
294
298
  ensureAgentDirSkeleton(aid);
@@ -305,6 +309,7 @@ export class EvolAgentRegistry {
305
309
  if (!oldAgent)
306
310
  throw new Error(`Agent "${aidOrName}" not found`);
307
311
  assertTemplateInstallationReady(oldAgent.aid, options.recoveryJobId);
312
+ assertAgentProjectChangeReady(oldAgent.aid);
308
313
  await hooks.beforeAgentOperation?.(oldAgent.aid);
309
314
  const expandedRaw = loadAgent(oldAgent.aid);
310
315
  if (!expandedRaw)
@@ -316,7 +321,6 @@ export class EvolAgentRegistry {
316
321
  if (precheck)
317
322
  throw new Error(`Precheck failed: ${precheck.detail}`);
318
323
  const raw = readConfig(ConfigTarget.Agent, { self: oldAgent.aid }, { cache: true }) ?? expandedRaw;
319
- ownerResolver.setAgentConfiguredOwners(oldAgent.aid, configuredOwnerList(raw));
320
324
  const merged = resolveEffective({ self: raw.aid }, {});
321
325
  if (oldAgent.status === 'disabled' && raw.enabled === false
322
326
  || (options.preserveStopped && oldAgent.status === 'stopped' || options.restoreStopped) && raw.enabled !== false) {
@@ -573,11 +577,12 @@ export class EvolAgentRegistry {
573
577
  this.channelIndex.clear();
574
578
  this.buildChannelIndex();
575
579
  // 注销该 Agent 的技能目录监控
576
- const { globalSkillWatcher } = await import('./skill/global-watcher.js');
580
+ const { globalSkillWatcher } = await import('../skill/global-watcher.js');
577
581
  await globalSkillWatcher.unwatchAgent(agent.aid);
578
582
  logger.info(`[Registry] Stopped agent ${aidOrName}`);
579
583
  }
580
584
  async startAgent(aidOrName, hooks) {
585
+ assertAgentProjectChangeReady(aidOrName);
581
586
  assertAgentAidAvailable(aidOrName);
582
587
  assertTemplateInstallationReady(aidOrName);
583
588
  const agent = this.agents.get(aidOrName);
@@ -598,7 +603,7 @@ export class EvolAgentRegistry {
598
603
  this.channelIndex.clear();
599
604
  this.buildChannelIndex();
600
605
  // 注册该 Agent 的技能目录监控
601
- const { watchAgentSkills } = await import('./skill/startup.js');
606
+ const { watchAgentSkills } = await import('../skill/startup.js');
602
607
  watchAgentSkills(agent.aid);
603
608
  logger.info(`[Registry] Started agent ${aidOrName}`);
604
609
  }