evolcore 0.0.50 → 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 (448) hide show
  1. package/CHANGELOG.md +39 -2
  2. package/bin/ec-build.mjs +60 -0
  3. package/bin/ecmsg.js +65 -63
  4. package/dist/ability/caller/command.js +24 -15
  5. package/dist/ability/caller/contract.js +24 -9
  6. package/dist/ability/caller/credential-files.js +132 -0
  7. package/dist/ability/caller/daemon.js +32 -7
  8. package/dist/ability/caller/schema-view.js +157 -0
  9. package/dist/ability/caller/service.js +202 -63
  10. package/dist/ability/interop-v1.js +156 -113
  11. package/dist/agent-template/jobs.js +14 -110
  12. package/dist/agent-template/runtime.js +331 -193
  13. package/dist/agent-template/service.js +1029 -1104
  14. package/dist/agent-template/share.js +103 -0
  15. package/dist/agent-template/tool-runner.js +25 -0
  16. package/dist/agent-template/types.js +10 -3
  17. package/dist/agents/claude/availability.js +94 -0
  18. package/dist/agents/claude/capability-provider.js +154 -0
  19. package/dist/agents/claude/index.js +145 -0
  20. package/dist/agents/{claude-runner.js → claude/runner.js} +74 -158
  21. package/dist/agents/claude/session-file-adapter.js +246 -0
  22. package/dist/agents/codex/app-server-client.js +90 -10
  23. package/dist/agents/codex/availability.js +164 -0
  24. package/dist/agents/codex/capability-provider.js +138 -0
  25. package/dist/agents/codex/cli.js +38 -0
  26. package/dist/agents/codex/index.js +345 -0
  27. package/dist/agents/codex/mcp-elicitation.js +135 -0
  28. package/dist/agents/{codex-runner.js → codex/runner.js} +648 -382
  29. package/dist/agents/codex/session-file-adapter.js +834 -0
  30. package/dist/agents/dsh/availability.js +28 -0
  31. package/dist/agents/dsh/capability-provider.js +56 -0
  32. package/dist/agents/dsh/desktop-locations.ps1 +66 -0
  33. package/dist/agents/dsh/desktop-probe.cjs +37 -0
  34. package/dist/agents/dsh/index.js +98 -0
  35. package/dist/agents/dsh/installation.js +400 -0
  36. package/dist/agents/dsh/resources.js +755 -0
  37. package/dist/agents/dsh/runner.js +1183 -0
  38. package/dist/agents/dsh/runtime/README.md +243 -0
  39. package/dist/agents/dsh/runtime/authorization.js +23 -0
  40. package/dist/agents/dsh/runtime/bridge.js +837 -0
  41. package/dist/agents/dsh/runtime/config.js +271 -0
  42. package/dist/agents/dsh/runtime/entry.js +229 -0
  43. package/dist/agents/dsh/runtime/session-inspector.js +340 -0
  44. package/dist/agents/dsh/runtime/tool-policy.js +49 -0
  45. package/dist/agents/dsh/session-file-adapter.js +145 -0
  46. package/dist/agents/ecagent/index.js +215 -0
  47. package/dist/agents/{ecagent-runner.js → ecagent/runner.js} +592 -106
  48. package/dist/agents/ecagent/session-file-adapter.js +134 -0
  49. package/dist/agents/gemini/index.js +55 -10
  50. package/dist/agents/gemini/{gemini-runner.js → runner.js} +4 -9
  51. package/dist/aun/ability-device-routing.js +11 -17
  52. package/dist/aun/aid/agentmd.js +27 -1
  53. package/dist/aun/aid/managed-operation.js +6 -4
  54. package/dist/aun/group/invite-service.js +1 -1
  55. package/dist/aun/menu/client.js +1 -1
  56. package/dist/aun/msg/history.js +1 -1
  57. package/dist/aun/msg/managed-operation.js +93 -21
  58. package/dist/aun/msg/p2p.js +6 -6
  59. package/dist/aun/service-proxy.js +1 -1
  60. package/dist/aun/storage/index.js +242 -0
  61. package/dist/build-identity.json +1 -1
  62. package/dist/channels/aun.js +180 -43
  63. package/dist/channels/daemon.js +3 -2
  64. package/dist/channels/dingtalk.js +1 -1
  65. package/dist/channels/feishu.js +9 -9
  66. package/dist/channels/qqbot.js +1 -1
  67. package/dist/channels/wechat.js +2 -2
  68. package/dist/channels/wecom.js +1 -1
  69. package/dist/{agents/claude-gateway → claude-gateway}/agent-registration.js +13 -13
  70. package/dist/{agents/claude-gateway → claude-gateway}/binding.js +3 -3
  71. package/dist/{agents/claude-gateway → claude-gateway}/inbox.js +1 -1
  72. package/dist/{agents/claude-gateway → claude-gateway}/index.js +2 -2
  73. package/dist/{agents/claude-gateway → claude-gateway}/listing.js +3 -3
  74. package/dist/{agents/claude-gateway → claude-gateway}/router.js +4 -4
  75. package/dist/{agents/claude-gateway → claude-gateway}/sessions.js +2 -2
  76. package/dist/{agents/claude-gateway → claude-gateway}/terminal.js +1 -1
  77. package/dist/{agents/claude-gateway → claude-gateway}/transcript.js +1 -1
  78. package/dist/cli/ability-command.js +8 -5
  79. package/dist/cli/ability-output.js +182 -0
  80. package/dist/cli/agent-command.js +1 -1
  81. package/dist/cli/agent-create.js +123 -42
  82. package/dist/cli/agent-template.js +400 -29
  83. package/dist/cli/agent.js +14 -11
  84. package/dist/cli/aun-commands.js +167 -111
  85. package/dist/cli/daemon-commands.js +38 -8
  86. package/dist/cli/data-command.js +1 -1
  87. package/dist/cli/debug-mode.js +9 -0
  88. package/dist/cli/directory.js +1 -2
  89. package/dist/cli/ecmsg-gateway.js +55 -19
  90. package/dist/cli/fs-command.js +67 -39
  91. package/dist/cli/index.js +25 -11
  92. package/dist/cli/init.js +124 -29
  93. package/dist/cli/managed-command-guard.js +2 -0
  94. package/dist/cli/model.js +1 -1
  95. package/dist/cli/restart-monitor.js +2 -2
  96. package/dist/cli/services-command.js +24 -1
  97. package/dist/cli/skill-command.js +4 -4
  98. package/dist/cli/task-context.js +24 -14
  99. package/dist/cli/team-workspace-command.js +50 -52
  100. package/dist/cli/thread-command.js +3 -2
  101. package/dist/cli/trigger-command.js +47 -12
  102. package/dist/cli/watch-logs.js +2 -1
  103. package/dist/config/boot-log.js +3 -0
  104. package/dist/config/builtin-role-templates.js +1 -1
  105. package/dist/config/config-field-policy.js +10 -6
  106. package/dist/config/config-manager.js +33 -12
  107. package/dist/config/gateway-config.js +21 -37
  108. package/dist/config/invoke-ipc-service.js +1 -1
  109. package/dist/config/owner-config.js +5 -3
  110. package/dist/config/peer-book-store.js +2 -3
  111. package/dist/config/peer-book.js +2 -2
  112. package/dist/config/peer-role-resolver.js +2 -2
  113. package/dist/config/provider-identity-migration.js +24 -105
  114. package/dist/config/provider-ipc-service.js +13 -3
  115. package/dist/config/provider-local-sync.js +4 -1
  116. package/dist/config/provider-menu-request.js +21 -3
  117. package/dist/config/provider-templates.js +1 -1
  118. package/dist/config/providers-config.js +39 -15
  119. package/dist/config/providers-import.js +3 -3
  120. package/dist/config/providers-management.js +74 -99
  121. package/dist/config/schema-migration.js +177 -11
  122. package/dist/config/schema-registry.js +1 -1
  123. package/dist/config-store.js +38 -50
  124. package/dist/core/{agent-application-service.js → agent/agent-application-service.js} +9 -9
  125. package/dist/core/{agent-create-status.js → agent/agent-create-status.js} +112 -4
  126. package/dist/core/{agent-creation-claim.js → agent/agent-creation-claim.js} +3 -3
  127. package/dist/core/{agent-ipc-registration.js → agent/agent-ipc-registration.js} +102 -25
  128. package/dist/core/{agent-reload-coordinator.js → agent/agent-reload-coordinator.js} +61 -1
  129. package/dist/core/{agent-runtime.js → agent/agent-runtime.js} +53 -27
  130. package/dist/core/{evolagent-registry.js → agent/evolagent-registry.js} +12 -12
  131. package/dist/core/{evolagent.js → agent/evolagent.js} +11 -11
  132. package/dist/core/auth/agent-delegation.js +1 -8
  133. package/dist/core/auth/delegation-authorization.js +28 -0
  134. package/dist/core/auth/operation-authorizer.js +7 -4
  135. package/dist/core/auth/operation-catalog.js +34 -5
  136. package/dist/core/baseagent/baseagent-availability.js +197 -0
  137. package/dist/core/baseagent/baseagent-capability-adapter.js +288 -0
  138. package/dist/core/baseagent/baseagent-config-shared.js +56 -0
  139. package/dist/core/baseagent/baseagent-identity.js +68 -0
  140. package/dist/core/{baseagent-loader.js → baseagent/baseagent-loader.js} +62 -6
  141. package/dist/core/baseagent/baseagent-model-defaults.js +26 -0
  142. package/dist/{agents → core/baseagent}/baseagent-plugin-descriptor.js +107 -24
  143. package/dist/core/baseagent/baseagent-plugin-loader.js +367 -0
  144. package/dist/core/baseagent/baseagent.js +157 -0
  145. package/dist/{agents → core/baseagent}/runner-types.js +36 -4
  146. package/dist/core/capability/capability-manager.js +79 -30
  147. package/dist/core/capability/providers/claude-capability-provider.js +2 -154
  148. package/dist/core/capability/providers/codex-capability-provider.js +2 -136
  149. package/dist/core/{channel-loader.js → channel/channel-loader.js} +226 -38
  150. package/dist/core/{channel-runtime.js → channel/channel-runtime.js} +18 -18
  151. package/dist/core/command/agent-control.js +60 -15
  152. package/dist/core/command/agent-template-menu.js +21 -9
  153. package/dist/core/command/agentmd-menu-request.js +19 -8
  154. package/dist/core/command/agentmd-menu.js +14 -5
  155. package/dist/core/command/command-handler.js +127 -57
  156. package/dist/core/command/context-policy-menu.js +122 -0
  157. package/dist/core/command/data-root-resolver.js +157 -20
  158. package/dist/core/command/memory-slash.js +6 -6
  159. package/dist/core/command/menu-catalog.js +80 -20
  160. package/dist/core/command/menu-handler.js +305 -25
  161. package/dist/core/command/menu-protocol.js +42 -8
  162. package/dist/core/command/menu-query-batch.js +9 -5
  163. package/dist/core/command/provider-menu.js +7 -11
  164. package/dist/core/command/role-menu.js +1 -1
  165. package/dist/core/command/skill-slash.js +17 -5
  166. package/dist/core/command/slash-gate.js +2 -4
  167. package/dist/core/command/slash-handler.js +127 -96
  168. package/dist/core/command/team-workspace-team.js +3 -3
  169. package/dist/core/command/topic-slash.js +10 -10
  170. package/dist/core/{daemon-bootstrap.js → daemon/daemon-bootstrap.js} +14 -14
  171. package/dist/core/{daemon-control.js → daemon/daemon-control.js} +46 -20
  172. package/dist/core/{daemon-lifecycle.js → daemon/daemon-lifecycle.js} +15 -15
  173. package/dist/core/{host-snapshot.js → daemon/host-snapshot.js} +3 -3
  174. package/dist/core/{ipc-registration.js → daemon/ipc-registration.js} +98 -38
  175. package/dist/core/{lifecycle-notice.js → daemon/lifecycle-notice.js} +4 -5
  176. package/dist/core/file-integrity/store.js +1 -1
  177. package/dist/core/handoff/ipc-registration.js +3 -3
  178. package/dist/core/handoff/runtime.js +1 -1
  179. package/dist/{agents → core/inference}/request-identity.js +2 -2
  180. package/dist/core/inference/text-inference.js +4 -4
  181. package/dist/core/{bootstrap-messages.js → initialization/bootstrap-messages.js} +10 -10
  182. package/dist/core/{bootstrap-service.js → initialization/bootstrap-service.js} +24 -23
  183. package/dist/core/initialization/service.js +54 -9
  184. package/dist/core/invoke/executors/media.js +1 -1
  185. package/dist/core/invoke/executors/text.js +1 -1
  186. package/dist/core/memory/consolidation-context.js +1 -1
  187. package/dist/core/memory/consolidation-trigger.js +9 -3
  188. package/dist/core/memory/consolidation.js +4 -4
  189. package/dist/core/memory/memory-admin.js +6 -6
  190. package/dist/core/memory/memory-writer.js +1 -1
  191. package/dist/core/memory/relation-idle-monitor.js +1 -1
  192. package/dist/core/message/aun-ipc-sender.js +114 -75
  193. package/dist/core/message/aun-request-registry.js +13 -5
  194. package/dist/core/message/auto-mention-gate.js +1 -1
  195. package/dist/core/message/contact-admission.js +1 -1
  196. package/dist/core/message/im-renderer.js +19 -0
  197. package/dist/core/{interaction-router.js → message/interaction-router.js} +4 -4
  198. package/dist/core/message/items-formatter.js +5 -5
  199. package/dist/core/message/message-admission.js +1 -1
  200. package/dist/core/message/message-bridge.js +135 -54
  201. package/dist/core/message/message-queue.js +83 -4
  202. package/dist/core/message/message-utils.js +1 -1
  203. package/dist/core/message/peer-mode.js +1 -1
  204. package/dist/core/message/response-engine.js +347 -163
  205. package/dist/core/message/send-options.js +9 -6
  206. package/dist/core/message/send-routing.js +45 -109
  207. package/dist/core/message/stream-idle-monitor.js +1 -1
  208. package/dist/core/{data-migration.js → migration/data-migration.js} +29 -1
  209. package/dist/core/model/catalog-service.js +29 -8
  210. package/dist/core/model/model-capabilities.js +88 -0
  211. package/dist/core/model/model-catalog.js +14 -3
  212. package/dist/core/model/model-diagnostics.js +4 -4
  213. package/dist/core/ownership/owner-resolver.js +95 -15
  214. package/dist/core/{pack-auth.js → pack/pack-auth.js} +30 -3
  215. package/dist/core/{pack-install.js → pack/pack-install.js} +95 -17
  216. package/dist/core/permission/approval-gateway.js +9 -18
  217. package/dist/core/permission/ec-command-parser.js +70 -34
  218. package/dist/core/permission/managed-file.js +234 -0
  219. package/dist/core/permission/protected-paths.js +56 -0
  220. package/dist/core/permission/sandbox-runtime.js +267 -3
  221. package/dist/core/permission/session-path-grants.js +1 -1
  222. package/dist/core/permission/shell-environment.js +15 -1
  223. package/dist/core/plugin/plugin-lifecycle.js +442 -0
  224. package/dist/core/session/adapters/claude-session-file-adapter.js +2 -246
  225. package/dist/core/session/adapters/codex-session-file-adapter.js +2 -566
  226. package/dist/core/session/adapters/ecagent-session-file-adapter.js +2 -134
  227. package/dist/core/{background-session → session/background}/session-cleanup.js +2 -2
  228. package/dist/core/{background-session → session/background}/types.js +1 -1
  229. package/dist/core/session/session-file-health.js +2 -272
  230. package/dist/core/session/session-idle-monitor.js +1 -1
  231. package/dist/core/session/session-manager.js +29 -2
  232. package/dist/core/session/session-terminal.js +185 -0
  233. package/dist/core/session/session-title.js +8 -11
  234. package/dist/core/{system-session → session/system}/memory.js +43 -9
  235. package/dist/core/{system-session → session/system}/registry.js +1 -1
  236. package/dist/core/{system-session → session/system}/types.js +1 -1
  237. package/dist/core/skill/index-generator.js +1 -0
  238. package/dist/core/task/task-activity-store.js +112 -0
  239. package/dist/core/task/task-recovery-service.js +2 -2
  240. package/dist/core/thread/ipc-operation.js +2 -2
  241. package/dist/core/thread/thread-operation.js +2 -1
  242. package/dist/core/thread/thread-route.js +5 -3
  243. package/dist/core/thread/thread-service.js +14 -4
  244. package/dist/directory/{owner-directory-admission.js → admission.js} +3 -3
  245. package/dist/directory/{owner-directory-cache.js → cache.js} +90 -8
  246. package/dist/directory/{owner-directory-markdown.js → markdown.js} +2 -2
  247. package/dist/directory/{owner-directory-query-operation.js → query-operation.js} +83 -9
  248. package/dist/directory/{owner-directory-search.js → search.js} +50 -2
  249. package/dist/directory/{owner-directory-store.js → store.js} +2 -2
  250. package/dist/eck/kit-renderer.js +1 -1
  251. package/dist/eck/manifest-engine.js +64 -2
  252. package/dist/eck/message-renderer.js +35 -0
  253. package/dist/ecweb/basic-settings-service.js +9 -3
  254. package/dist/{contracts → ecweb/contracts}/ecweb-service-protocol.js +2 -1
  255. package/dist/ecweb/dsh-native-service.js +413 -0
  256. package/dist/ecweb/providers-service.js +1 -1
  257. package/dist/ecweb/runtime/lifecycle.js +1 -1
  258. package/dist/ecweb/runtime/supervisor.js +1 -1
  259. package/dist/event-center/center-config.js +2 -2
  260. package/dist/event-center/dispatcher.js +1 -1
  261. package/dist/event-center/ipc-operation.js +12 -3
  262. package/dist/event-center/pack-loader.js +2 -2
  263. package/dist/event-center/registry.js +6 -6
  264. package/dist/event-center/runtime.js +2 -2
  265. package/dist/index.js +71 -42
  266. package/dist/ipc.js +103 -10
  267. package/dist/outputs/authorization.js +27 -0
  268. package/dist/outputs/events.js +10 -1
  269. package/dist/outputs/panel-cards.js +960 -0
  270. package/dist/paths.js +12 -0
  271. package/dist/pay/command.js +1 -1
  272. package/dist/pay/runtime.js +18 -10
  273. package/dist/response-system/engines/v1/proactive-flow.js +1 -1
  274. package/dist/services/dispatcher.js +2 -2
  275. package/dist/services/host/main.js +10 -1
  276. package/dist/services/host/protocol.js +9 -2
  277. package/dist/services/host/resident.js +37 -0
  278. package/dist/services/host-client.js +12 -0
  279. package/dist/services/host-recycle.js +8 -3
  280. package/dist/services/host-runtime.js +54 -15
  281. package/dist/services/index.js +83 -19
  282. package/dist/services/ipc-operation.js +303 -38
  283. package/dist/services/pack-manager.js +2 -2
  284. package/dist/services/router.js +43 -3
  285. package/dist/services/script-runner.js +34 -25
  286. package/dist/services/service-payload.js +28 -1
  287. package/dist/services/validation.js +28 -2
  288. package/dist/stats/context-usage.js +110 -0
  289. package/dist/stats/model-resolver.js +103 -17
  290. package/dist/stats/query.js +5 -0
  291. package/dist/trigger/application-service.js +3 -2
  292. package/dist/trigger/authorization.js +36 -33
  293. package/dist/trigger/ipc-service.js +4 -4
  294. package/dist/trigger/local-files.js +8 -176
  295. package/dist/trigger/manager.js +2 -2
  296. package/dist/trigger/parser.js +48 -0
  297. package/dist/trigger/scheduler.js +14 -2
  298. package/dist/trigger/script-executor.js +21 -0
  299. package/dist/trigger/script-sandbox.js +57 -243
  300. package/dist/trigger/system-definitions.js +25 -0
  301. package/dist/trigger/validation.js +1 -1
  302. package/dist/utils/atomic-write.js +88 -1
  303. package/dist/utils/cross-platform.js +4 -42
  304. package/dist/utils/error-dict.json +22 -1
  305. package/dist/utils/error-utils.js +193 -6
  306. package/dist/utils/evolcore-version.js +2 -2
  307. package/dist/utils/host-info.js +1 -1
  308. package/dist/utils/logger.js +3 -1
  309. package/dist/utils/media-cache.js +99 -4
  310. package/dist/utils/startup-trace.js +20 -4
  311. package/dist/utils/welcome.js +64 -20
  312. package/ecagent/README.md +35 -0
  313. package/ecagent/dist/agent-loop.js +80 -30
  314. package/ecagent/dist/harness/env/nodejs.d.ts +16 -0
  315. package/ecagent/dist/harness/env/nodejs.js +49 -20
  316. package/ecagent/dist/harness/messages.js +3 -2
  317. package/ecagent/dist/harness/types.d.ts +1 -0
  318. package/ecagent/dist/runtime/types.d.ts +2 -0
  319. package/ecagent/dist/runtime/utils/validation.d.ts +7 -1
  320. package/ecagent/dist/runtime/utils/validation.js +42 -0
  321. package/ecagent/dist/types.d.ts +2 -0
  322. package/kits/docs/INDEX.md +1 -1
  323. package/kits/docs/channels/feishu.md +1 -1
  324. package/kits/docs/evolcore/INDEX.md +10 -7
  325. package/kits/docs/evolcore/agent-create.md +2 -0
  326. package/kits/docs/evolcore/agent.md +100 -13
  327. package/kits/docs/evolcore/aid.md +19 -3
  328. package/kits/docs/evolcore/config.md +94 -0
  329. package/kits/docs/evolcore/ctl.md +2 -1
  330. package/kits/docs/evolcore/ec-capabilities.md +7 -10
  331. package/kits/docs/evolcore/ecweb-lifecycle.md +5 -1
  332. package/kits/docs/evolcore/event.md +1 -1
  333. package/kits/docs/evolcore/fs.md +49 -3
  334. package/kits/docs/evolcore/group.md +3 -3
  335. package/kits/docs/evolcore/memory-consolidation.md +1 -1
  336. package/kits/docs/evolcore/menu-protocol.md +24 -2
  337. package/kits/docs/evolcore/model.md +9 -1
  338. package/kits/docs/evolcore/msg.md +30 -28
  339. package/kits/docs/evolcore/pay.md +8 -20
  340. package/kits/docs/evolcore/plugin.md +74 -0
  341. package/kits/docs/evolcore/provider.md +8 -2
  342. package/kits/docs/evolcore/rpc.md +2 -2
  343. package/kits/docs/evolcore/skill.md +17 -1
  344. package/kits/docs/evolcore/stats.md +5 -0
  345. package/kits/docs/evolcore/storage.md +22 -0
  346. package/kits/docs/evolcore/thread-chain.md +19 -10
  347. package/kits/docs/evolcore/tool-authorization.md +4 -0
  348. package/kits/docs/evolcore/trigger.md +89 -13
  349. package/kits/docs/identity/AID_PROFILE_SPEC.md +1 -1
  350. package/kits/docs/venues/feishu-group.md +3 -2
  351. package/kits/docs/venues/feishu-private.md +3 -2
  352. package/kits/rules/02-navigation.md +20 -13
  353. package/kits/rules/06-channel.md +18 -2
  354. package/kits/schemas/_meta.json +8 -4
  355. package/kits/schemas/agent-config.schema.23.json +19 -3
  356. package/kits/schemas/agent-config.schema.24.json +986 -0
  357. package/kits/schemas/agent-config.schema.25.json +986 -0
  358. package/kits/schemas/daemon.schema.11.json +487 -0
  359. package/kits/schemas/daemon.schema.12.json +505 -0
  360. package/kits/schemas/defaults.schema.8.json +484 -0
  361. package/kits/schemas/providers.schema.1.json +1 -1
  362. package/kits/schemas/providers.schema.2.json +1 -1
  363. package/kits/schemas/providers.schema.3.json +8 -2
  364. package/kits/skills/.switches.json +4 -0
  365. package/kits/skills/ability/SKILL.md +194 -27
  366. package/kits/skills/ability/STRUCTURE.md +5 -0
  367. package/kits/skills/agent-output-cards/SKILL.md +90 -54
  368. package/kits/skills/agent-output-cards/examples/html-surface.json +11 -0
  369. package/kits/skills/agent-output-cards/examples/meeting-followups.json +16 -0
  370. package/kits/skills/agent-output-cards/examples/meeting-latest.json +24 -0
  371. package/kits/skills/agent-output-cards/examples/project-metrics.json +16 -0
  372. package/kits/skills/agent-output-cards/examples/quick-links.json +18 -0
  373. package/kits/skills/agent-output-cards/examples/surface.html +8 -0
  374. package/kits/skills/agent-template-project/SKILL.md +51 -0
  375. package/kits/skills/agent-template-project/references/01-collect-and-pack.md +174 -0
  376. package/kits/skills/agent-template-project/references/02-upload-and-share.md +109 -0
  377. package/kits/skills/agent-template-project/references/03-download-and-install.md +189 -0
  378. package/kits/skills/agent-template-project/references/04-upgrade-and-recovery.md +74 -0
  379. package/kits/skills/agent-template-project/references/05-publish-to-platform.md +62 -0
  380. package/kits/skills/ec-group/SKILL.md +3 -3
  381. package/kits/skills/ec-group-collaboration/SKILL.md +4 -4
  382. package/kits/skills/ec-identity/SKILL.md +9 -6
  383. package/kits/skills/ec-pay/SKILL.md +163 -41
  384. package/kits/skills/ec-provider/SKILL.md +5 -5
  385. package/kits/skills/ec-service-call/SKILL.md +3 -0
  386. package/kits/skills/ec-skill/SKILL.md +25 -9
  387. package/kits/skills/ec-skill/scripts/cli.mjs +7 -7
  388. package/kits/skills/ec-skill/scripts/skill.mjs +55 -41
  389. package/kits/skills/ec-skill/scripts/template/SKILL.md.tmpl +9 -0
  390. package/kits/skills/ec-trigger/SKILL.md +2 -2
  391. package/kits/skills/personal-assistant/SKILL.md +22 -22
  392. package/kits/skills/personal-assistant/references/03-data-flow-and-gaps.md +1 -1
  393. package/kits/skills/scrapling-article-fetch/SKILL.md +5 -5
  394. package/kits/skills/thread-ops/SKILL.md +19 -9
  395. package/kits/skills/wechat-article-media-download/SKILL.md +2 -2
  396. package/kits/skills/wechat-article-reader/SKILL.md +2 -2
  397. package/kits/templates/system-fragments/commands.md +1 -1
  398. package/kits/templates/system-fragments/personal-assistant.md +2 -2
  399. package/kits/templates/system-fragments/reply.md +14 -9
  400. package/kits/templates/system-fragments/session.md +1 -1
  401. package/kits/templates/system-fragments/thread.md +10 -5
  402. package/package.json +6 -5
  403. package/scripts/agent-template/index.mjs +7 -1
  404. package/scripts/agent-template/inspect.mjs +81 -35
  405. package/scripts/agent-template/overlay.mjs +110 -4
  406. package/scripts/agent-template/shared/common.mjs +36 -4
  407. package/scripts/agent-template/shared/plan.mjs +4 -2
  408. package/scripts/agent-template/shared/service-packs.mjs +104 -0
  409. package/scripts/agent-template/shared/team-schema.json +467 -54
  410. package/scripts/agent-template/shared/template-contract.mjs +70 -68
  411. package/scripts/agent-template/shared/template-package.mjs +153 -36
  412. package/scripts/agent-template/shared/template-runtime.mjs +76 -64
  413. package/scripts/agent-template/shared/template.mjs +11 -46
  414. package/scripts/agent-template/team-pack.mjs +451 -35
  415. package/scripts/agent-template/team-preview.mjs +75 -226
  416. package/scripts/aid-batch/identity-batch.mjs +1 -1
  417. package/dist/agents/baseagent-availability.js +0 -176
  418. package/dist/agents/baseagent-capability-adapter.js +0 -102
  419. package/dist/agents/baseagent-plugin-loader.js +0 -145
  420. package/dist/agents/baseagent.js +0 -816
  421. package/dist/agents/codex/catalog.js +0 -80
  422. package/dist/agents/ecagent-plugin-lazy.js +0 -41
  423. package/dist/agents/tool-time-context.js +0 -55
  424. package/dist/core/legacy-rename.js +0 -41
  425. package/dist/core/plugin-lifecycle.js +0 -137
  426. package/dist/core/rate-window.js +0 -53
  427. package/dist/core/runner-reload-transaction.js +0 -60
  428. package/dist/core/runtime-lock.js +0 -90
  429. package/dist/core/soul.js +0 -66
  430. package/dist/core/system-session/grants.js +0 -40
  431. package/dist/directory/owner-directory-agentmd-sync.js +0 -89
  432. package/dist/directory/owner-directory-request-operation.js +0 -79
  433. package/dist/directory/owner-directory-text.js +0 -60
  434. package/kits/skills/ec-pay/references/pay-cli.md +0 -110
  435. /package/dist/agents/gemini/{gemini-capability-provider.js → capability-provider.js} +0 -0
  436. /package/dist/agents/gemini/{gemini-session-file-adapter.js → session-file-adapter.js} +0 -0
  437. /package/dist/{agents/claude-gateway → claude-gateway}/types.js +0 -0
  438. /package/dist/core/{system-channels.js → channel/system-channels.js} +0 -0
  439. /package/dist/core/{daemon-file-cache.js → daemon/daemon-file-cache.js} +0 -0
  440. /package/dist/core/{event-bus.js → event/event-bus.js} +0 -0
  441. /package/dist/core/{event-catalog.js → event/event-catalog.js} +0 -0
  442. /package/dist/core/{pack-ledger.js → pack/pack-ledger.js} +0 -0
  443. /package/dist/directory/{owner-directory-identity.js → identity.js} +0 -0
  444. /package/dist/directory/{owner-directory-policy.js → policy.js} +0 -0
  445. /package/dist/directory/{owner-directory-remarks.js → remarks.js} +0 -0
  446. /package/dist/directory/{owner-directory-scope.js → scope.js} +0 -0
  447. /package/dist/{contracts → ecweb/contracts}/ecweb-instance.js +0 -0
  448. /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
+ }