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
@@ -5,9 +5,11 @@
5
5
  * Plugins are responsible for creating channel instances only.
6
6
  * The main service (index.ts) handles registration and message flow wiring.
7
7
  */
8
- import { logger } from '../utils/logger.js';
9
- import { assertAgentAidAvailable } from '../config/config-manager.js';
10
- import { PluginHandle } from './plugin-lifecycle.js';
8
+ import { createRequire } from 'node:module';
9
+ import { logger } from '../../utils/logger.js';
10
+ import { assertAgentAidAvailable } from '../../config/config-manager.js';
11
+ import { PluginHandle, pluginRuntimeReason, packagePluginEntries, recordRuntimePlugin, runtimePluginEnabled, updateRuntimePlugin, validateRuntimePluginDescriptor } from '../plugin/plugin-lifecycle.js';
12
+ import { getPackageRoot } from '../../paths.js';
11
13
  /**
12
14
  * 进程退出时给 AUN 渠道的 WebSocket 关闭握手留的时间。
13
15
  *
@@ -16,6 +18,124 @@ import { PluginHandle } from './plugin-lifecycle.js';
16
18
  * 等不到就直接放手。
17
19
  */
18
20
  const CLOSE_HANDSHAKE_BUDGET_MS = 100;
21
+ function channelDescriptor(name, displayName, requiredConfig, dependencies, load, properties = {}) {
22
+ return { kind: 'channel', apiVersion: 1, version: '1.0.0', hostApi: '^1.0.0', name, displayName, requiredConfig, dependencies, load, configSchema: {
23
+ type: 'object', required: ['type', 'name'],
24
+ // Missing credentials and unknown historical fields remain storable.
25
+ properties: {
26
+ type: { const: name }, name: { type: 'string', minLength: 1 }, enabled: { type: 'boolean' },
27
+ showActivities: { enum: ['all', 'text', 'none'] },
28
+ ...Object.fromEntries(requiredConfig.map(field => [field, { type: 'string' }])), ...properties,
29
+ },
30
+ } };
31
+ }
32
+ const CHANNEL_DESCRIPTORS = [
33
+ channelDescriptor('feishu', '飞书', ['appId', 'appSecret'], ['@larksuiteoapi/node-sdk'], async () => new (await import('../../channels/feishu.js')).FeishuChannelPlugin()),
34
+ channelDescriptor('wechat', '微信', ['token'], [], async () => new (await import('../../channels/wechat.js')).WechatChannelPlugin(), { baseUrl: { type: 'string' } }),
35
+ channelDescriptor('dingtalk', '钉钉', ['clientId', 'clientSecret'], ['dingtalk-stream'], async () => new (await import('../../channels/dingtalk.js')).DingtalkChannelPlugin(), {
36
+ requireMention: { type: 'boolean' }, freeResponseChats: { type: 'array', items: { type: 'string' } },
37
+ cardTemplateId: { type: 'string' },
38
+ }),
39
+ channelDescriptor('qqbot', 'QQ机器人', ['appId', 'clientSecret'], ['pure-qqbot'], async () => new (await import('../../channels/qqbot.js')).QQBotChannelPlugin()),
40
+ channelDescriptor('wecom', '企业微信', ['botId', 'secret'], ['@wecom/aibot-node-sdk'], async () => new (await import('../../channels/wecom.js')).WecomChannelPlugin()),
41
+ ];
42
+ const requireChannelDependency = createRequire(import.meta.url);
43
+ const channelValidators = new Map();
44
+ const channelDescriptors = new Map(CHANNEL_DESCRIPTORS.map(item => [item.name, item]));
45
+ for (const descriptor of CHANNEL_DESCRIPTORS)
46
+ recordChannelMetadata(descriptor);
47
+ function recordChannelMetadata(descriptor) {
48
+ recordRuntimePlugin({ kind: 'channel', name: descriptor.name, displayName: descriptor.displayName,
49
+ apiVersion: descriptor.apiVersion ?? 0, version: descriptor.version ?? '0.0.0',
50
+ hostApi: descriptor.hostApi ?? 'legacy', state: 'discovered' });
51
+ }
52
+ export async function discoverChannelPlugins() {
53
+ for (const entry of packagePluginEntries(getPackageRoot(), 'channels', import.meta.url)) {
54
+ try {
55
+ const descriptor = (await import(entry.url)).default;
56
+ const errors = validateRuntimePluginDescriptor(descriptor, 'channel');
57
+ if (descriptor?.name !== entry.name)
58
+ errors.push('Channel name does not match its directory');
59
+ if (typeof descriptor?.load !== 'function' || !Array.isArray(descriptor?.dependencies)
60
+ || !Array.isArray(descriptor?.requiredConfig))
61
+ errors.push('Channel requires load, dependencies and requiredConfig');
62
+ else if ([...descriptor.dependencies, ...descriptor.requiredConfig].some(value => typeof value !== 'string' || !value.trim())) {
63
+ errors.push('Channel dependencies and requiredConfig must contain nonempty strings');
64
+ }
65
+ if (errors.length)
66
+ throw new Error(errors.join('; '));
67
+ if (CHANNEL_DESCRIPTORS.some(item => item.name === descriptor.name))
68
+ throw new Error('Cannot replace bundled channel');
69
+ const Ajv = requireChannelDependency('ajv');
70
+ const validate = new Ajv({ strict: false, allErrors: true }).compile(descriptor.configSchema);
71
+ channelDescriptors.set(descriptor.name, descriptor);
72
+ channelValidators.set(descriptor.name, validate);
73
+ recordChannelMetadata(descriptor);
74
+ }
75
+ catch (error) {
76
+ recordRuntimePlugin({ kind: 'channel', name: entry.name, displayName: entry.name, apiVersion: 0,
77
+ version: '0.0.0', hostApi: 'unknown', state: 'failed',
78
+ reason: pluginRuntimeReason('INVALID_DESCRIPTOR', 'discovery', '渠道描述加载失败', error) });
79
+ logger.warn('[ChannelPlugins] Cannot discover ' + entry.name, error);
80
+ }
81
+ }
82
+ }
83
+ export function listChannelPluginDescriptors() { return [...channelDescriptors.values()]; }
84
+ export function getChannelPluginDescriptor(type) {
85
+ return channelDescriptors.get(type);
86
+ }
87
+ export function probeChannelPlugin(descriptor, resolveDependency = requireChannelDependency.resolve) {
88
+ try {
89
+ for (const dependency of descriptor.dependencies)
90
+ resolveDependency(dependency);
91
+ return { available: true };
92
+ }
93
+ catch (error) {
94
+ return { available: false, reason: pluginRuntimeReason('DEPENDENCY_MISSING', 'probe', '渠道依赖未安装', error) };
95
+ }
96
+ }
97
+ /** Validate specified fields at every config boundary; require credentials only at creation. */
98
+ export function validateChannelConfigs(channels, ready = false) {
99
+ if (!Array.isArray(channels))
100
+ return ['channels must be an array'];
101
+ const errors = [];
102
+ const names = new Set();
103
+ for (const [index, channel] of channels.entries()) {
104
+ const prefix = `channels[${index}]`;
105
+ if (!channel || typeof channel !== 'object' || Array.isArray(channel)) {
106
+ errors.push(`${prefix} must be an object`);
107
+ continue;
108
+ }
109
+ if (channel.type === 'aun')
110
+ continue; // Implicit Host core channel; legacy entries are ignored.
111
+ const descriptor = getChannelPluginDescriptor(channel.type);
112
+ if (!descriptor) {
113
+ errors.push(`${prefix}.type "${channel.type}" not supported`);
114
+ continue;
115
+ }
116
+ if (!isValidChannelName(channel.name))
117
+ errors.push(`${prefix}.name invalid (empty or contains '#')`);
118
+ const key = `${channel.type}#${channel.name}`;
119
+ if (names.has(key))
120
+ errors.push(`${prefix}: duplicate name "${channel.name}" within type "${channel.type}"`);
121
+ names.add(key);
122
+ let validate = channelValidators.get(descriptor.name);
123
+ if (!validate) {
124
+ const Ajv = requireChannelDependency('ajv');
125
+ validate = new Ajv({ strict: false, allErrors: true }).compile(descriptor.configSchema);
126
+ channelValidators.set(descriptor.name, validate);
127
+ }
128
+ if (!validate(channel))
129
+ errors.push(...(validate.errors ?? []).map(error => `${prefix}${error.instancePath} ${error.message}`));
130
+ if (ready) {
131
+ for (const field of descriptor.requiredConfig) {
132
+ if (typeof channel[field] !== 'string' || !channel[field].trim())
133
+ errors.push(`${prefix}/${field} is required`);
134
+ }
135
+ }
136
+ }
137
+ return errors;
138
+ }
19
139
  function isMissingChannelDependency(error) {
20
140
  const code = error?.code;
21
141
  return code === 'ERR_MODULE_NOT_FOUND' || code === 'MODULE_NOT_FOUND';
@@ -50,6 +170,7 @@ export class ChannelLoader {
50
170
  return this.connectionAdmission ? this.connectionAdmission(instance) : instance.connect();
51
171
  }
52
172
  plugins = new Map();
173
+ providerDescriptors = new Map();
53
174
  providerStatuses = new Map();
54
175
  instanceStatuses = new Map();
55
176
  contactBindRegistry = new ContactBindRegistry();
@@ -57,31 +178,49 @@ export class ChannelLoader {
57
178
  this.processDebug = processDebug;
58
179
  this.aunDefaultEncrypt = aunDefaultEncrypt;
59
180
  }
60
- register(plugin) {
181
+ register(plugin, descriptor) {
61
182
  if (this.plugins.has(plugin.name)) {
62
183
  throw new Error(`Channel plugin '${plugin.name}' already registered`);
63
184
  }
64
- if (plugin.contactBind)
65
- this.contactBindRegistry.register(plugin.name, plugin.contactBind);
185
+ const undoContactBind = plugin.contactBind && this.contactBindRegistry.register(plugin.name, plugin.contactBind);
66
186
  this.plugins.set(plugin.name, plugin);
67
- this.providerStatuses.set(plugin.name, { channelType: plugin.name, status: 'loaded' });
187
+ if (descriptor)
188
+ this.providerDescriptors.set(plugin.name, descriptor);
189
+ this.providerStatuses.set(plugin.name, { channelType: plugin.name, status: 'loaded',
190
+ discovered: true, ...(descriptor ? { dependencyAvailable: true, displayName: descriptor.displayName } : {}) });
191
+ updateRuntimePlugin('channel', plugin.name, 'registered');
68
192
  logger.debug(`Registered channel plugin: ${plugin.name}`);
193
+ return () => {
194
+ if (this.plugins.get(plugin.name) !== plugin)
195
+ return;
196
+ undoContactBind?.();
197
+ this.plugins.delete(plugin.name);
198
+ this.providerDescriptors.delete(plugin.name);
199
+ this.providerStatuses.delete(plugin.name);
200
+ };
69
201
  }
70
202
  /** Look up a registered plugin by channel type (used by reload hooks). */
71
203
  getPlugin(type) {
72
204
  return this.plugins.get(type);
73
205
  }
74
- recordProviderFailure(channelType, error) {
206
+ recordProviderDisabled(channelType) {
207
+ const reason = pluginRuntimeReason('CONFIG_DISABLED', 'configuration', '渠道插件部署已禁用');
208
+ this.providerStatuses.set(channelType, { channelType, status: 'unavailable', discovered: true,
209
+ displayName: getChannelPluginDescriptor(channelType)?.displayName, reason });
210
+ updateRuntimePlugin('channel', channelType, 'disabled', reason);
211
+ }
212
+ recordProviderFailure(channelType, error, stage = 'load') {
75
213
  if (this.plugins.has(channelType))
76
214
  throw new Error(`Channel plugin '${channelType}' already registered`);
77
- const missing = isMissingChannelDependency(error);
215
+ const missing = stage === 'probe' || isMissingChannelDependency(error);
78
216
  this.providerStatuses.set(channelType, {
79
217
  channelType,
80
218
  status: missing ? 'unavailable' : 'failed',
81
- reason: missing
82
- ? { code: 'DEPENDENCY_MISSING', message: '渠道实现或依赖未安装' }
83
- : { code: 'LOAD_FAILED', message: '渠道实现加载失败' },
219
+ discovered: true, dependencyAvailable: !missing,
220
+ displayName: getChannelPluginDescriptor(channelType)?.displayName,
221
+ reason: pluginRuntimeReason(missing ? 'DEPENDENCY_MISSING' : 'LOAD_FAILED', stage, missing ? '渠道实现或依赖未安装' : '渠道实现加载失败', error),
84
222
  });
223
+ updateRuntimePlugin('channel', channelType, missing ? 'unavailable' : 'failed', pluginRuntimeReason(missing ? 'DEPENDENCY_MISSING' : 'LOAD_FAILED', stage, '渠道加载失败', error));
85
224
  logger.warn(`[ChannelLoader] Failed to load '${channelType}':`, error);
86
225
  }
87
226
  getSnapshot(agents) {
@@ -101,12 +240,12 @@ export class ChannelLoader {
101
240
  const snapshot = {
102
241
  agentAid: config.agentAid, channelName: config.channelName, channelType: config.channelType,
103
242
  status: config.enabled ? 'disconnected' : 'disabled',
104
- ...(!config.enabled ? { reason: { code: 'CONFIG_DISABLED', message: '配置已禁用' } } : {}),
243
+ ...(!config.enabled ? { reason: pluginRuntimeReason('CONFIG_DISABLED', 'configuration', '配置已禁用') } : {}),
105
244
  };
106
245
  if (config.enabled && !this.plugins.has(config.channelType)) {
107
246
  const provider = this.providerStatuses.get(config.channelType);
108
247
  snapshot.status = provider?.status === 'failed' ? 'failed' : 'unavailable';
109
- snapshot.reason = provider?.reason ?? { code: 'PROVIDER_NOT_FOUND', message: '渠道实现未注册' };
248
+ snapshot.reason = provider?.reason ?? pluginRuntimeReason('PROVIDER_NOT_FOUND', 'register', '渠道实现未注册');
110
249
  }
111
250
  return { snapshot, runtime: undefined };
112
251
  }) : [...this.instanceStatuses.values()];
@@ -123,9 +262,9 @@ export class ChannelLoader {
123
262
  current.status = 'disconnected';
124
263
  }
125
264
  }
126
- catch {
265
+ catch (error) {
127
266
  current.status = 'failed';
128
- current.reason = { code: 'STATUS_FAILED', message: '渠道状态读取失败' };
267
+ current.reason = pluginRuntimeReason('STATUS_FAILED', 'status', '渠道状态读取失败', error);
129
268
  }
130
269
  }
131
270
  return current;
@@ -212,23 +351,31 @@ export class ChannelLoader {
212
351
  this.instanceStatuses.set(key, entry);
213
352
  if (inst.enabled === false) {
214
353
  snapshot.status = 'disabled';
215
- snapshot.reason = { code: 'CONFIG_DISABLED', message: '渠道配置已禁用' };
354
+ snapshot.reason = pluginRuntimeReason('CONFIG_DISABLED', 'configuration', '渠道配置已禁用');
216
355
  return null;
217
356
  }
218
357
  const plugin = this.plugins.get(inst.type);
219
358
  if (!plugin) {
220
359
  const provider = this.providerStatuses.get(inst.type);
221
360
  snapshot.status = provider?.status === 'failed' ? 'failed' : 'unavailable';
222
- snapshot.reason = provider?.reason ?? { code: 'PROVIDER_NOT_FOUND', message: '渠道实现未注册' };
361
+ snapshot.reason = provider?.reason ?? pluginRuntimeReason('PROVIDER_NOT_FOUND', 'register', '渠道实现未注册');
223
362
  return null;
224
363
  }
364
+ if (this.providerDescriptors.has(inst.type)) {
365
+ const configErrors = validateChannelConfigs([{ ...inst, name: tryParseChannelKey(inst.name)?.name ?? inst.name }], true);
366
+ if (configErrors.length) {
367
+ snapshot.status = 'unavailable';
368
+ snapshot.reason = pluginRuntimeReason('INVALID_CONFIG', 'configuration', '渠道配置不完整或无效', configErrors.join('; '));
369
+ return null;
370
+ }
371
+ }
225
372
  let teardown;
226
373
  const lifecycle = new PluginHandle(`${ctx.agentName}::${inst.name}`, (budgetMs) => teardown?.(budgetMs));
227
374
  try {
228
375
  const runtime = await plugin.createInstance(inst, { ...ctx, lifecycle });
229
376
  if (!runtime) {
230
377
  snapshot.status = 'unavailable';
231
- snapshot.reason = { code: 'INVALID_CONFIG', message: '渠道配置不完整或无效' };
378
+ snapshot.reason = pluginRuntimeReason('INVALID_CONFIG', 'configuration', '渠道配置不完整或无效');
232
379
  await lifecycle.dispose();
233
380
  return null;
234
381
  }
@@ -243,7 +390,7 @@ export class ChannelLoader {
243
390
  }
244
391
  return lifecycle.dispose({ teardownBudgetMs: clientCloseBudgetMs }).catch(error => {
245
392
  snapshot.status = 'failed';
246
- snapshot.reason = { code: 'DISCONNECT_FAILED', message: '渠道资源清理失败' };
393
+ snapshot.reason = pluginRuntimeReason('DISCONNECT_FAILED', 'disconnect', '渠道资源清理失败', error);
247
394
  throw error;
248
395
  }).finally(() => { entry.runtime = undefined; });
249
396
  };
@@ -258,9 +405,7 @@ export class ChannelLoader {
258
405
  if (!lifecycle.signal.aborted) {
259
406
  const missing = isMissingChannelDependency(error);
260
407
  snapshot.status = missing ? 'unavailable' : 'failed';
261
- snapshot.reason = missing
262
- ? { code: 'DEPENDENCY_MISSING', message: '渠道依赖未安装' }
263
- : { code: 'CONNECT_FAILED', message: '渠道连接失败' };
408
+ snapshot.reason = pluginRuntimeReason(missing ? 'DEPENDENCY_MISSING' : 'CONNECT_FAILED', 'connect', missing ? '渠道依赖未安装' : '渠道连接失败', error);
264
409
  if (inst.type !== 'aun') {
265
410
  try {
266
411
  await lifecycle.dispose();
@@ -279,9 +424,7 @@ export class ChannelLoader {
279
424
  catch (error) {
280
425
  const missing = isMissingChannelDependency(error);
281
426
  snapshot.status = missing ? 'unavailable' : 'failed';
282
- snapshot.reason = missing
283
- ? { code: 'DEPENDENCY_MISSING', message: '渠道依赖未安装' }
284
- : { code: 'CREATE_FAILED', message: '渠道实例创建失败' };
427
+ snapshot.reason = pluginRuntimeReason(missing ? 'DEPENDENCY_MISSING' : 'CREATE_FAILED', 'create', missing ? '渠道依赖未安装' : '渠道实例创建失败', error);
285
428
  try {
286
429
  await lifecycle.dispose();
287
430
  }
@@ -592,21 +735,64 @@ export function buildReloadHooks(deps) {
592
735
  },
593
736
  };
594
737
  }
595
- export async function registerBuiltinChannelPlugins(channelLoader) {
596
- channelLoader.register(new (await import('../channels/aun.js')).AUNChannelPlugin());
597
- const providers = [
598
- ['feishu', async () => new (await import('../channels/feishu.js')).FeishuChannelPlugin()],
599
- ['wechat', async () => new (await import('../channels/wechat.js')).WechatChannelPlugin()],
600
- ['dingtalk', async () => new (await import('../channels/dingtalk.js')).DingtalkChannelPlugin()],
601
- ['qqbot', async () => new (await import('../channels/qqbot.js')).QQBotChannelPlugin()],
602
- ['wecom', async () => new (await import('../channels/wecom.js')).WecomChannelPlugin()],
603
- ];
604
- for (const [channelType, load] of providers) {
738
+ export async function registerBuiltinChannelPlugins(channelLoader, lifecycle) {
739
+ const undoAun = channelLoader.register(new (await import('../../channels/aun.js')).AUNChannelPlugin());
740
+ lifecycle?.defer(undoAun, 'AUN registration');
741
+ for (const descriptor of listChannelPluginDescriptors()) {
742
+ if (!await runtimePluginEnabled('channel', descriptor.name)) {
743
+ channelLoader.recordProviderDisabled(descriptor.name);
744
+ continue;
745
+ }
746
+ const probe = probeChannelPlugin(descriptor);
747
+ if (!probe.available) {
748
+ channelLoader.recordProviderFailure(descriptor.name, probe.reason?.detail, 'probe');
749
+ continue;
750
+ }
605
751
  try {
606
- channelLoader.register(await load());
752
+ let implementation;
753
+ let releaseContactBind;
754
+ const plugin = { name: descriptor.name, createInstance: async (config, context) => {
755
+ const module = await (implementation ??= descriptor.load().catch(error => {
756
+ updateRuntimePlugin('channel', descriptor.name, 'failed', pluginRuntimeReason('LOAD_FAILED', 'load', '渠道运行实现加载失败', error));
757
+ throw error;
758
+ }));
759
+ if ('createInstance' in module) {
760
+ if (module.contactBind && !channelLoader.contactBindRegistry.get(descriptor.name)) {
761
+ releaseContactBind = channelLoader.contactBindRegistry.register(descriptor.name, module.contactBind);
762
+ }
763
+ return module.createInstance(config, context);
764
+ }
765
+ const scope = context.lifecycle;
766
+ const runtime = await module.createChannel(Object.freeze({ ...config }), Object.freeze({ apiVersion: 1,
767
+ aid: context.agentName, projectPath: context.defaultProjectPath, lifecycle: scope, signal: scope.signal }));
768
+ if (!runtime)
769
+ return null;
770
+ if (runtime.adapter?.channelName !== config.name || typeof runtime.adapter.send !== 'function'
771
+ || ['connect', 'disconnect', 'onMessage'].some(key => typeof runtime[key] !== 'function')) {
772
+ if (typeof runtime.disconnect === 'function')
773
+ await runtime.disconnect();
774
+ throw new Error('Channel factory returned an invalid identity or interface');
775
+ }
776
+ return {
777
+ channelType: descriptor.name, adapter: runtime.adapter, channel: runtime.channel,
778
+ policy: runtime.policy, options: runtime.options,
779
+ connect: runtime.connect.bind(runtime), disconnect: runtime.disconnect.bind(runtime),
780
+ registerBridge: bridge => bridge.register(runtime.adapter.channelName, handler => runtime.onMessage(async (message) => {
781
+ if (!scope.signal.aborted)
782
+ await handler({ ...message, channel: runtime.adapter.channelName,
783
+ channelType: descriptor.name, selfAID: context.agentName });
784
+ }), async (channelId, text, replyContext) => {
785
+ const { buildEnvelope } = await import('../message/message-utils.js');
786
+ await runtime.adapter.send(buildEnvelope({ taskId: 'channel-command', channel: runtime.adapter.channelName,
787
+ channelId, agentName: context.agentName, replyContext }), { kind: 'command.result', text });
788
+ }, runtime.adapter, descriptor.name),
789
+ };
790
+ } };
791
+ const undo = channelLoader.register(plugin, descriptor);
792
+ lifecycle?.defer(() => { undo(); releaseContactBind?.(); }, `channel:${descriptor.name}`);
607
793
  }
608
794
  catch (error) {
609
- channelLoader.recordProviderFailure(channelType, error);
795
+ channelLoader.recordProviderFailure(descriptor.name, error);
610
796
  }
611
797
  }
612
798
  }
@@ -620,6 +806,8 @@ export class ContactBindRegistry {
620
806
  throw new Error(`Contact-bind provider '${normalizedType}' already registered`);
621
807
  }
622
808
  this.providers.set(normalizedType, provider);
809
+ return () => { if (this.providers.get(normalizedType) === provider)
810
+ this.providers.delete(normalizedType); };
623
811
  }
624
812
  get(channelType) {
625
813
  return this.providers.get(channelType.trim().toLowerCase());
@@ -1,22 +1,22 @@
1
1
  import path from 'path';
2
- import { getOwners } from './ownership/owner-resolver.js';
2
+ import { getOwners } from '../ownership/owner-resolver.js';
3
3
  import fs from 'fs';
4
- import { removeRestartRequest } from '../utils/restart-safety.js';
4
+ import { readRestartRequest, removeRestartRequest } from '../../utils/restart-safety.js';
5
5
  import { tryParseChannelKey } from './channel-loader.js';
6
- import { agentMdPath } from '../paths.js';
7
- import { registerAdapterInteractions } from './interaction-router.js';
8
- import { resolvePeerDisplayLabel } from '../config/peer-book.js';
9
- import { sanitizeMenuLogValue } from './command/menu-protocol.js';
10
- import { appendMessageLog, buildOutboundEntry } from './message/message-log.js';
6
+ import { agentMdPath } from '../../paths.js';
7
+ import { registerAdapterInteractions } from '../message/interaction-router.js';
8
+ import { resolvePeerDisplayLabel } from '../../config/peer-book.js';
9
+ import { sanitizeMenuLogValue } from '../command/menu-protocol.js';
10
+ import { appendMessageLog, buildOutboundEntry } from '../message/message-log.js';
11
11
  import crypto from 'crypto';
12
- import { buildEnvelope } from './message/message-utils.js';
13
- import { normalizeMessageSource, outboundPayloadToLogText, resolvePersistedRestartDelivery, sendSystemPayload, shouldCountSentPayload, summarizeOutboundPayload, tagErrorPayloadWithEvolcoreVersion, } from './message/outbound.js';
14
- import { getFirstStaticAgentOwner } from '../config/peer-role-resolver.js';
15
- import { isManagementRole } from '../config/builtin-roles.js';
16
- import { pendingInterruptHints } from './message/pending-hints.js';
17
- import { logger } from '../utils/logger.js';
18
- import { sessionLocalTopicId } from './thread/topic-id.js';
19
- import { StartupTaskQueue } from './daemon-lifecycle.js';
12
+ import { buildEnvelope } from '../message/message-utils.js';
13
+ import { normalizeMessageSource, outboundPayloadToLogText, resolvePersistedRestartDelivery, sendSystemPayload, shouldCountSentPayload, summarizeOutboundPayload, tagErrorPayloadWithEvolcoreVersion, } from '../message/outbound.js';
14
+ import { getFirstStaticAgentOwner } from '../../config/peer-role-resolver.js';
15
+ import { isManagementRole } from '../../config/builtin-roles.js';
16
+ import { pendingInterruptHints } from '../message/pending-hints.js';
17
+ import { logger } from '../../utils/logger.js';
18
+ import { sessionLocalTopicId } from '../thread/topic-id.js';
19
+ import { StartupTaskQueue } from '../daemon/daemon-lifecycle.js';
20
20
  export function createAgentStorageClientResolver(channelInstances) {
21
21
  return (channelKey, targetAid) => {
22
22
  const instance = channelInstances.find(candidate => candidate.channelType === 'aun'
@@ -270,7 +270,7 @@ export function createChannelStartupNotifications({ channelInstances, agentRegis
270
270
  }
271
271
  catch { }
272
272
  const projectDir = path.basename(agent.projectPath);
273
- const text = `✓ ${agentName} 已上线 | 工作目录: ${projectDir}`;
273
+ const text = `${agentName} 已上线 | 工作目录: ${projectDir}`;
274
274
  const envelope = buildEnvelope({
275
275
  taskId: `system-online-${crypto.randomBytes(5).toString('hex')}`,
276
276
  channel: adapter.channelName,
@@ -300,7 +300,9 @@ export function createChannelStartupNotifications({ channelInstances, agentRegis
300
300
  pendingRestartNoticeInFlight = (async () => {
301
301
  if (pendingRestartNoticeSent || !fs.existsSync(pendingFile))
302
302
  return;
303
- const pending = JSON.parse(fs.readFileSync(pendingFile, 'utf-8'));
303
+ const pending = readRestartRequest(pendingFile) ?? JSON.parse(fs.readFileSync(pendingFile, 'utf-8'));
304
+ if (pending.status === 'failed' || pending.status === 'timeout')
305
+ return;
304
306
  if (pending.requestId && pending.requesterPid) {
305
307
  if (pending.requesterPid === process.pid)
306
308
  return;
@@ -365,10 +367,10 @@ export function createChannelStartupNotifications({ channelInstances, agentRegis
365
367
  }
366
368
  : pending.outcome === 'upgraded'
367
369
  ? {
368
- text: `✅ 服务重启成功!${pending.outcomeReason ? `${pending.outcomeReason}` : ''}`,
370
+ text: `服务重启成功${pending.outcomeReason ? `:${pending.outcomeReason}` : ''}`,
369
371
  subtype: 'restarted-upgraded',
370
372
  }
371
- : { text: '✅ 服务重启成功!', subtype: 'restarted' };
373
+ : { text: '服务重启成功', subtype: 'restarted' };
372
374
  await sendSystemPayload(adapter, envelope, {
373
375
  kind: 'system.notice',
374
376
  text: restartNotice.text,