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
@@ -0,0 +1,442 @@
1
+ import fs from 'node:fs';
2
+ import path from 'node:path';
3
+ import { createRequire } from 'node:module';
4
+ import { fileURLToPath, pathToFileURL } from 'node:url';
5
+ import { loadSchema } from '../../config/schema-registry.js';
6
+ import { resolvePaths } from '../../paths.js';
7
+ export const PLUGIN_HOST_API_VERSION = '1.0.0';
8
+ const runtimePlugins = new Map();
9
+ const requirePluginDependency = createRequire(import.meta.url);
10
+ export function validateRuntimePluginDescriptor(value, kind) {
11
+ const errors = [];
12
+ if (value.kind !== kind)
13
+ errors.push('Plugin kind does not match entrypoint');
14
+ if (value.apiVersion !== 1)
15
+ errors.push('Unsupported plugin apiVersion; Host supports 1');
16
+ if (typeof value.name !== 'string' || !/^[a-z][a-z0-9-]{0,31}$/.test(value.name)
17
+ || ['aun', 'daemon', '__proto__', 'constructor', 'prototype'].includes(value.name))
18
+ errors.push('Invalid or reserved plugin name');
19
+ const semver = requirePluginDependency('semver');
20
+ if (typeof value.version !== 'string' || !semver.valid(value.version))
21
+ errors.push('Plugin version must be semver');
22
+ if (typeof value.hostApi !== 'string' || !semver.satisfies(PLUGIN_HOST_API_VERSION, value.hostApi)) {
23
+ errors.push('Plugin hostApi is incompatible with ' + PLUGIN_HOST_API_VERSION);
24
+ }
25
+ if (typeof value.displayName !== 'string' || !value.displayName.trim())
26
+ errors.push('Plugin displayName is required');
27
+ if (!value.configSchema || typeof value.configSchema !== 'object' || Array.isArray(value.configSchema))
28
+ errors.push('Plugin configSchema is required');
29
+ return errors;
30
+ }
31
+ export function recordRuntimePlugin(value) {
32
+ const key = value.kind + ':' + value.name;
33
+ runtimePlugins.set(key, value);
34
+ return () => { if (runtimePlugins.get(key) === value)
35
+ runtimePlugins.delete(key); };
36
+ }
37
+ export function listRuntimePlugins() {
38
+ return [...runtimePlugins.values()].map(value => structuredClone(value));
39
+ }
40
+ export function updateRuntimePlugin(kind, name, state, reason) {
41
+ const key = kind + ':' + name;
42
+ const previous = runtimePlugins.get(key);
43
+ if (previous)
44
+ Object.assign(previous, { state, reason });
45
+ }
46
+ export function recordPluginWarnings(kind, name, warnings) {
47
+ const item = runtimePlugins.get(kind + ':' + name);
48
+ if (item)
49
+ item.warnings = [...new Set([...(item.warnings ?? []), ...warnings])];
50
+ }
51
+ /** Both families use the executing tree and prefer a lightweight descriptor entry. */
52
+ export function packagePluginEntries(packageRoot, family, callerUrl) {
53
+ const source = path.extname(fileURLToPath(callerUrl)) === '.ts';
54
+ const preferred = path.join(packageRoot, source ? 'src' : 'dist', family);
55
+ const root = fs.existsSync(preferred) ? preferred : path.join(packageRoot, 'dist', family);
56
+ if (!fs.existsSync(root))
57
+ return [];
58
+ return fs.readdirSync(root, { withFileTypes: true }).filter(entry => entry.isDirectory()
59
+ && /^[a-z][a-z0-9-]{0,31}$/.test(entry.name)).sort((a, b) => a.name.localeCompare(b.name)).flatMap(entry => {
60
+ const candidates = source ? ['descriptor.ts', 'descriptor.js', 'index.ts', 'index.js'] : ['descriptor.js', 'index.js'];
61
+ const file = candidates.map(name => path.join(root, entry.name, name)).find(file => {
62
+ try {
63
+ return fs.lstatSync(file).isFile();
64
+ }
65
+ catch {
66
+ return false;
67
+ }
68
+ });
69
+ return file ? [{ name: entry.name, url: pathToFileURL(file).href }] : [];
70
+ });
71
+ }
72
+ export async function runtimePluginEnabled(kind, name, legacy = true) {
73
+ if (kind === 'baseagent')
74
+ return baseagentDeclarations()[name]?.enabled === true;
75
+ const { read, ConfigTarget } = await import('../../config/config-manager.js');
76
+ const value = read(ConfigTarget.Process, undefined, { cache: false })?.plugins?.[kind + ':' + name]?.enabled;
77
+ return value === undefined ? legacy : value === true;
78
+ }
79
+ export async function runtimeBaseagentForceLoad(name) {
80
+ const { read, ConfigTarget } = await import('../../config/config-manager.js');
81
+ return read(ConfigTarget.Process, undefined, { cache: false })?.plugins?.['baseagent:' + name]?.force === true;
82
+ }
83
+ /** Only explicit daemon declarations identify baseagents. The template is for first initialization only. */
84
+ export function baseagentDeclarations() {
85
+ let plugins;
86
+ try {
87
+ const config = JSON.parse(fs.readFileSync(resolvePaths().daemonConfig, 'utf8'));
88
+ plugins = config.plugins ?? {};
89
+ }
90
+ catch (error) {
91
+ if (error.code !== 'ENOENT')
92
+ throw error;
93
+ plugins = loadSchema('daemon').raw.properties.plugins.default ?? {};
94
+ }
95
+ return Object.fromEntries(Object.entries(plugins)
96
+ .filter(([key]) => /^baseagent:[a-z][a-z0-9-]{0,31}$/.test(key))
97
+ .map(([key, value]) => [key.slice('baseagent:'.length), value]));
98
+ }
99
+ /** Resolve exactly one declared entry in the executing tree, without scanning or fallback. */
100
+ export function baseagentPluginEntry(packageRoot, name, callerUrl) {
101
+ if (!/^[a-z][a-z0-9-]{0,31}$/.test(name))
102
+ throw new Error('Invalid baseagent name');
103
+ const source = path.extname(fileURLToPath(callerUrl)) === '.ts';
104
+ return pathToFileURL(path.join(packageRoot, source ? 'src' : 'dist', 'agents', name, source ? 'index.ts' : 'index.js')).href;
105
+ }
106
+ export async function pluginInventory() {
107
+ const { read, ConfigTarget } = await import('../../config/config-manager.js');
108
+ const config = read(ConfigTarget.Process, undefined, { cache: false });
109
+ const runtime = listRuntimePlugins();
110
+ const pending = Object.entries(baseagentDeclarations())
111
+ .filter(([name]) => !runtime.some(item => item.kind === 'baseagent' && item.name === name))
112
+ .map(([name, declaration]) => ({ kind: 'baseagent', name, displayName: name, apiVersion: 0,
113
+ version: '0.0.0', hostApi: 'unknown', state: declaration.enabled ? 'discovered' : 'disabled' }));
114
+ return { hostApiVersion: PLUGIN_HOST_API_VERSION, items: [...runtime, ...pending].map(item => {
115
+ const enabled = config?.plugins?.[item.kind + ':' + item.name]?.enabled
116
+ ?? (item.kind === 'baseagent' ? baseagentDeclarations()[item.name]?.enabled === true : true);
117
+ const force = item.kind === 'baseagent' && config?.plugins?.['baseagent:' + item.name]?.force === true;
118
+ const forced = item.force === true;
119
+ return { ...item, enabled, force, forced,
120
+ restartRequired: pending.includes(item) || enabled !== (item.state !== 'disabled') || force !== forced };
121
+ }) };
122
+ }
123
+ export async function setRuntimePluginEnabled(kind, name, enabled, force, dshSetup, principalId) {
124
+ if (!['channel', 'baseagent'].includes(kind) || typeof enabled !== 'boolean'
125
+ || ['aun', 'daemon', '__proto__', 'constructor', 'prototype'].includes(name)
126
+ || !/^[a-z][a-z0-9-]{0,31}$/.test(name)
127
+ || (force !== undefined && typeof force !== 'boolean') || (force && kind !== 'baseagent')) {
128
+ throw new Error('Unknown plugin or invalid enabled/force value');
129
+ }
130
+ if (!runtimePlugins.has(kind + ':' + name) && !Object.hasOwn(baseagentDeclarations(), name)) {
131
+ const installation = kind === 'baseagent' && enabled
132
+ ? (await (await import('../baseagent/baseagent-plugin-loader.js')).scanBaseagentInstallations())
133
+ .find(item => item.id === name && item.installed) : undefined;
134
+ if (!installation)
135
+ throw new Error('Unknown plugin or invalid enabled/force value');
136
+ }
137
+ else if (kind === 'channel' && !runtimePlugins.has(kind + ':' + name)) {
138
+ throw new Error('Unknown plugin or invalid enabled/force value');
139
+ }
140
+ if (dshSetup !== undefined && !(kind === 'baseagent' && name === 'dsh' && enabled)) {
141
+ throw new Error('DSH setup requires enable baseagent dsh');
142
+ }
143
+ if (kind === 'baseagent' && name === 'dsh' && enabled) {
144
+ const { configureDshHost } = await import('../../agents/dsh/installation.js');
145
+ await configureDshHost(dshSetup, principalId);
146
+ }
147
+ const { mutateConfig, ConfigTarget } = await import('../../config/config-manager.js');
148
+ mutateConfig(ConfigTarget.Process, undefined, config => {
149
+ const previous = config.plugins?.[kind + ':' + name];
150
+ config.plugins = { ...config.plugins, [kind + ':' + name]: {
151
+ ...previous, enabled, ...(kind === 'baseagent' ? { force: force ?? previous?.force ?? false } : {}),
152
+ } };
153
+ });
154
+ return { ...await pluginInventory(), restartRequired: true };
155
+ }
156
+ export function parsePluginCommand(argv) {
157
+ if (!Array.isArray(argv) || argv[0] !== 'plugin' || argv.some(value => typeof value !== 'string'))
158
+ throw new Error('Invalid plugin argv');
159
+ const tail = argv.slice(1);
160
+ const formatIndex = tail.indexOf('--format');
161
+ if (formatIndex !== -1) {
162
+ if (tail[formatIndex + 1] !== 'json')
163
+ throw new Error('Only --format json is supported');
164
+ tail.splice(formatIndex, 2);
165
+ }
166
+ const forceIndex = tail.indexOf('--force');
167
+ const force = forceIndex !== -1;
168
+ if (force)
169
+ tail.splice(forceIndex, 1);
170
+ const dshSetup = {};
171
+ for (const [flag, key] of [['--dsh-mode', 'runtimeMode'], ['--dsh-installation', 'installationId'],
172
+ ['--dsh-home', 'homePath'], ['--dsh-profile', 'profilePath']]) {
173
+ const index = tail.indexOf(flag);
174
+ if (index === -1)
175
+ continue;
176
+ if (!tail[index + 1] || tail[index + 1].startsWith('--'))
177
+ throw new Error('Missing value for ' + flag);
178
+ Object.assign(dshSetup, { [key]: tail[index + 1] });
179
+ tail.splice(index, 2);
180
+ }
181
+ const [action = 'list', kind, name] = tail;
182
+ if (!['list', 'show', 'doctor', 'enable', 'disable'].includes(action)
183
+ || (action === 'list' ? tail.length > 1 : tail.length !== 3)
184
+ || (kind !== undefined && !['channel', 'baseagent'].includes(kind))
185
+ || (name !== undefined && !/^[a-z][a-z0-9-]{0,31}$/.test(name))
186
+ || (force && (action !== 'enable' || kind !== 'baseagent'))) {
187
+ throw new Error('Use plugin list or <show|doctor|enable|disable> <channel|baseagent> <name>; --force requires enable baseagent');
188
+ }
189
+ if (Object.keys(dshSetup).length && !(action === 'enable' && kind === 'baseagent' && name === 'dsh')) {
190
+ throw new Error('DSH setup requires enable baseagent dsh');
191
+ }
192
+ if (dshSetup.runtimeMode !== undefined && dshSetup.runtimeMode !== 'native-shared')
193
+ throw new Error('DSH_HOST_SETUP_INVALID');
194
+ return { action, kind, name, ...(force ? { force: true } : {}), ...(Object.keys(dshSetup).length ? { dshSetup } : {}) };
195
+ }
196
+ export async function executePluginCommand(argv, principalId) {
197
+ try {
198
+ const command = parsePluginCommand(argv);
199
+ const inventory = await pluginInventory();
200
+ if (command.action === 'list')
201
+ return { ok: true, data: inventory };
202
+ if (command.action === 'enable' || command.action === 'disable') {
203
+ return { ok: true, data: await setRuntimePluginEnabled(command.kind, command.name, command.action === 'enable', command.force, command.dshSetup, principalId) };
204
+ }
205
+ const item = inventory.items.find(item => item.kind === command.kind && item.name === command.name);
206
+ if (command.action === 'doctor' && command.kind === 'baseagent' && command.name === 'dsh') {
207
+ const { discoverDshDesktopInstallations } = await import('../../agents/dsh/installation.js');
208
+ const { read, ConfigTarget } = await import('../../config/config-manager.js');
209
+ const config = read(ConfigTarget.Defaults, undefined, { cache: false })?.baseagents?.dsh ?? {};
210
+ const installations = discoverDshDesktopInstallations();
211
+ const { getBaseagentPluginDescriptor } = await import('../baseagent/baseagent-plugin-descriptor.js');
212
+ const probe = getBaseagentPluginDescriptor('dsh')?.probe() ?? {
213
+ available: installations.installations.some(entry => entry.compatible) && !installations.failures.length,
214
+ reason: item?.reason,
215
+ };
216
+ return { ok: true, data: { ...item, hostApiVersion: inventory.hostApiVersion,
217
+ installations, probe,
218
+ hostSelection: { runtimeMode: config.runtimeMode, nativeResourceId: config.nativeResourceId,
219
+ nativeRegistrationRevision: config.nativeRegistrationRevision } } };
220
+ }
221
+ if (!item)
222
+ return { ok: false, code: 'NOT_FOUND', error: 'Plugin not found' };
223
+ if (command.action === 'doctor') {
224
+ let probe;
225
+ if (command.kind === 'channel') {
226
+ const channels = await import('../channel/channel-loader.js');
227
+ const descriptor = channels.getChannelPluginDescriptor(command.name);
228
+ probe = descriptor ? channels.probeChannelPlugin(descriptor) : { available: false, reason: 'Descriptor unavailable' };
229
+ }
230
+ else {
231
+ const { getBaseagentPluginDescriptor } = await import('../baseagent/baseagent-plugin-descriptor.js');
232
+ const descriptor = getBaseagentPluginDescriptor(command.name);
233
+ try {
234
+ probe = descriptor?.probe() ?? { available: false, reason: item.reason?.detail ?? 'Descriptor admission failed' };
235
+ }
236
+ catch (error) {
237
+ probe = { available: false, reason: String(error) };
238
+ }
239
+ }
240
+ return { ok: true, data: { ...item, probe, hostApiVersion: inventory.hostApiVersion } };
241
+ }
242
+ return { ok: true, data: { hostApiVersion: inventory.hostApiVersion, ...item } };
243
+ }
244
+ catch (error) {
245
+ return { ok: false, code: 'INVALID_ARGUMENT', error: error instanceof Error ? error.message : String(error) };
246
+ }
247
+ }
248
+ export function validatePluginMenuRequest(request) {
249
+ const args = request.args;
250
+ const writing = request.type === 'menu.update';
251
+ if (!['menu.query', 'menu.update'].includes(request.type) || !args || Array.isArray(args) || args.scope !== 'process'
252
+ || (request.name !== undefined && request.name !== 'plugins') || (request.cmd !== undefined && request.cmd !== '/plugins')
253
+ || Object.keys(args).some(key => !['scope', 'kind', 'name', 'context', 'view', 'force', 'dshSetup'].includes(key))
254
+ || (args.dshSetup !== undefined && (!writing || request.value !== true || args.kind !== 'baseagent' || args.name !== 'dsh'
255
+ || !args.dshSetup || typeof args.dshSetup !== 'object' || Array.isArray(args.dshSetup)
256
+ || Object.keys(args.dshSetup).some(key => !['runtimeMode', 'installationId', 'homePath', 'profilePath'].includes(key))
257
+ || (args.dshSetup.runtimeMode !== undefined && args.dshSetup.runtimeMode !== 'native-shared')
258
+ || ['installationId', 'homePath', 'profilePath'].some(key => args.dshSetup[key] !== undefined
259
+ && (typeof args.dshSetup[key] !== 'string' || !args.dshSetup[key] || args.dshSetup[key].length > 4096))))
260
+ || (args.context !== undefined && (args.context?.kind !== 'process' || Object.keys(args.context).length !== 1))
261
+ || (args.kind !== undefined && !['channel', 'baseagent'].includes(args.kind))
262
+ || (args.name !== undefined && (typeof args.name !== 'string' || !/^[a-z][a-z0-9-]{0,31}$/.test(args.name)))
263
+ || (args.view !== undefined && (writing || args.view !== 'doctor' || !args.kind || !args.name))
264
+ || (args.force !== undefined && (!writing || typeof args.force !== 'boolean'
265
+ || args.kind !== 'baseagent'))
266
+ || (writing && (typeof request.value !== 'boolean' || !args.kind || !args.name))) {
267
+ return { code: 'INVALID_ARGUMENT', message: 'Use process scope, valid kind/name and a boolean value for updates' };
268
+ }
269
+ return null;
270
+ }
271
+ /** Menu authorization stays at the existing process-control boundary. */
272
+ export async function executePluginMenu(request, subject, source) {
273
+ const args = request.args ?? {};
274
+ const invalid = validatePluginMenuRequest(request);
275
+ if (invalid)
276
+ return { error: invalid.message, code: invalid.code };
277
+ if (!subject?.fromControlChannel || !subject.isDaemonOwner || subject.processRole === 'daemon-service') {
278
+ return { error: 'Plugin management requires DaemonOwner control context', code: 'FORBIDDEN' };
279
+ }
280
+ const writing = request.type === 'menu.update';
281
+ if (writing && !subject.ecwebManagement && subject.menuEncrypted !== true)
282
+ return { error: 'Encrypted Control Menu required', code: 'FORBIDDEN' };
283
+ const { authorizeFreshOperation } = await import('../auth/auth-gateway.js');
284
+ const decision = await authorizeFreshOperation({ source, subject,
285
+ intent: { operation: writing ? 'plugin.update' : 'plugin.list', scope: 'process', source, args } });
286
+ if (!decision.allow)
287
+ return { error: 'Plugin operation not permitted', code: 'FORBIDDEN' };
288
+ try {
289
+ if (writing)
290
+ return { data: await setRuntimePluginEnabled(args.kind, args.name, request.value, args.force, args.dshSetup, subject.principalId) };
291
+ if (args.view === 'doctor') {
292
+ const result = await executePluginCommand(['plugin', 'doctor', args.kind, args.name]);
293
+ return result.ok ? { data: result.data } : { error: result.error, code: result.code };
294
+ }
295
+ const inventory = await pluginInventory();
296
+ return { data: { ...inventory, items: inventory.items.filter(item => (!args.kind || item.kind === args.kind) && (!args.name || item.name === args.name)) } };
297
+ }
298
+ catch (error) {
299
+ return { error: error instanceof Error ? error.message : String(error), code: 'INVALID_ARGUMENT' };
300
+ }
301
+ }
302
+ export function pluginRuntimeReason(code, stage, message, error) {
303
+ return { code, stage, message,
304
+ ...(error === undefined ? {} : { detail: error instanceof Error ? error.message : String(error) }) };
305
+ }
306
+ export class PluginHandle {
307
+ owner;
308
+ teardown;
309
+ resources = new Map();
310
+ pending = new Map();
311
+ intervals = new Map();
312
+ timeouts = new Map();
313
+ controller = new AbortController();
314
+ disposal;
315
+ currentState = 'active';
316
+ constructor(owner, teardown) {
317
+ this.owner = owner;
318
+ this.teardown = teardown;
319
+ }
320
+ get state() { return this.currentState; }
321
+ get signal() { return this.controller.signal; }
322
+ get resourceCount() { return this.resources.size + this.pending.size; }
323
+ assertActive() {
324
+ if (this.currentState !== 'active')
325
+ throw new Error(`Plugin ${this.owner} is ${this.currentState}`);
326
+ }
327
+ defer(disposer, label = 'resource') {
328
+ this.assertActive();
329
+ let disposal;
330
+ const release = () => {
331
+ if (disposal)
332
+ return disposal;
333
+ this.resources.delete(release);
334
+ let resolve;
335
+ let reject;
336
+ disposal = new Promise((done, fail) => { resolve = done; reject = fail; });
337
+ const pending = disposal;
338
+ this.pending.set(pending, label);
339
+ pending.then(() => this.pending.delete(pending), () => this.pending.delete(pending));
340
+ try {
341
+ Promise.resolve(disposer()).then(resolve, reject);
342
+ }
343
+ catch (error) {
344
+ reject(error);
345
+ }
346
+ return disposal;
347
+ };
348
+ this.resources.set(release, label);
349
+ return release;
350
+ }
351
+ subscribe(eventBus, eventType, handler) {
352
+ return this.listen(eventBus, eventType, handler);
353
+ }
354
+ listen(emitter, event, listener) {
355
+ this.assertActive();
356
+ const ownedListener = (...args) => {
357
+ if (this.currentState === 'active')
358
+ listener(...args);
359
+ };
360
+ emitter.on(event, ownedListener);
361
+ return this.defer(() => { emitter.off(event, ownedListener); }, `event:${String(event)}`);
362
+ }
363
+ setInterval(callback, delayMs) {
364
+ this.assertActive();
365
+ const timer = setInterval(() => {
366
+ if (this.currentState === 'active')
367
+ callback();
368
+ }, delayMs);
369
+ const release = this.defer(() => {
370
+ globalThis.clearInterval(timer);
371
+ this.intervals.delete(timer);
372
+ }, 'interval');
373
+ this.intervals.set(timer, release);
374
+ return timer;
375
+ }
376
+ clearInterval(timer) {
377
+ const release = this.intervals.get(timer);
378
+ if (release)
379
+ return Promise.resolve(release());
380
+ globalThis.clearInterval(timer);
381
+ return Promise.resolve();
382
+ }
383
+ clearTimeout(timer) {
384
+ const release = this.timeouts.get(timer);
385
+ if (release)
386
+ return Promise.resolve(release());
387
+ globalThis.clearTimeout(timer);
388
+ return Promise.resolve();
389
+ }
390
+ setTimeout(callback, delayMs) {
391
+ this.assertActive();
392
+ const timer = setTimeout(() => {
393
+ this.resources.delete(release);
394
+ this.timeouts.delete(timer);
395
+ if (this.currentState === 'active')
396
+ callback();
397
+ }, delayMs);
398
+ const release = this.defer(() => {
399
+ globalThis.clearTimeout(timer);
400
+ this.timeouts.delete(timer);
401
+ }, 'timeout');
402
+ this.timeouts.set(timer, release);
403
+ return timer;
404
+ }
405
+ /**
406
+ * `options.teardownBudgetMs` 只给进程退出路径用,透传给 teardown(目前只有 AUN 渠道
407
+ * 的 `client.close()` 关心):daemon 反正马上 `exit(0)`,等不满的网络握手没有意义。
408
+ */
409
+ dispose(options = {}) {
410
+ if (this.disposal)
411
+ return this.disposal;
412
+ this.currentState = 'disposing';
413
+ const resources = [...this.resources].reverse();
414
+ const pending = [...this.pending];
415
+ this.disposal = Promise.resolve().then(async () => {
416
+ const errors = [];
417
+ const cleanup = async (operation, label) => {
418
+ try {
419
+ await (typeof operation === 'function' ? operation() : operation);
420
+ }
421
+ catch (cause) {
422
+ errors.push(new Error(`Plugin ${this.owner}: ${label}`, { cause }));
423
+ }
424
+ };
425
+ await Promise.all([
426
+ ...resources.map(([release, label]) => cleanup(release, label)),
427
+ ...pending.map(([operation, label]) => cleanup(operation, label)),
428
+ ]);
429
+ try {
430
+ await this.teardown?.(options.teardownBudgetMs);
431
+ }
432
+ catch (cause) {
433
+ errors.push(new Error(`Plugin ${this.owner}: teardown`, { cause }));
434
+ }
435
+ this.currentState = 'disposed';
436
+ if (errors.length)
437
+ throw new AggregateError(errors, `Plugin ${this.owner} cleanup failed`);
438
+ });
439
+ this.controller.abort();
440
+ return this.disposal;
441
+ }
442
+ }