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
@@ -5,17 +5,29 @@
5
5
  * own runner so that runtime state (model/effort/permissionMode/credentials)
6
6
  * is fully isolated.
7
7
  */
8
- import { logger } from '../utils/logger.js';
9
- import { PluginHandle } from './plugin-lifecycle.js';
10
- import { getCcAgentAid } from '../agents/claude-gateway/agent-registration.js';
11
- import { validateBaseagentPluginConfigs } from '../agents/baseagent-plugin-descriptor.js';
8
+ import { logger } from '../../utils/logger.js';
9
+ import { PluginHandle, pluginRuntimeReason, recordPluginWarnings } from '../plugin/plugin-lifecycle.js';
10
+ import { getCcAgentAid } from '../../claude-gateway/agent-registration.js';
11
+ import { getBaseagentPluginDescriptor, isBaseagentPluginForced, validateBaseagentPluginConfigs } from './baseagent-plugin-descriptor.js';
12
+ import { restrictDeclaredRunnerCapabilities, validateRequiredBaseagentRunner } from './baseagent-capability-adapter.js';
12
13
  /** Agent Loader — produces one runner per (EvolAgent × baseagent). */
13
14
  export class AgentLoader {
14
15
  plugins = new Map();
15
16
  creationSlots = new Map();
17
+ /** The selected backend may rely entirely on native/descriptor defaults. */
18
+ withSelectedConfiguration(agent) {
19
+ const name = agent.config.active_baseagent ?? agent.baseagent;
20
+ if (!name || Object.hasOwn(agent.config.baseagents ?? {}, name))
21
+ return agent;
22
+ // A temporary view preserves identity and getters without modifying stored
23
+ // or shared effective configuration just to supply an empty settings block.
24
+ return Object.create(agent, { config: { value: { ...agent.config,
25
+ baseagents: { ...agent.config.baseagents, [name]: {} } } } });
26
+ }
16
27
  enabledBaseagents(agent) {
17
28
  if (agent.aid === getCcAgentAid())
18
29
  return [];
30
+ agent = this.withSelectedConfiguration(agent);
19
31
  return [...this.plugins].filter(([, plugin]) => {
20
32
  try {
21
33
  return plugin.isEnabled(agent);
@@ -107,12 +119,21 @@ export class AgentLoader {
107
119
  async createForAgent(agent, callbacks, creationErrors, selectPlugin = () => true, onCreating) {
108
120
  if (agent.aid === getCcAgentAid())
109
121
  return [];
122
+ agent = this.withSelectedConfiguration(agent);
110
123
  const instances = [];
124
+ if (agent.baseagent && selectPlugin(agent.baseagent) && !this.plugins.has(agent.baseagent)) {
125
+ const message = '所选基座未声明、已禁用或未通过准入:' + agent.baseagent;
126
+ creationErrors?.push({ evolagentName: agent.name, baseagent: agent.baseagent, message,
127
+ reason: pluginRuntimeReason('BASEAGENT_UNAVAILABLE', 'create', message) });
128
+ logger.error(message);
129
+ }
111
130
  for (const [pluginName, plugin] of this.plugins) {
112
131
  if (!selectPlugin(pluginName))
113
132
  continue;
114
133
  try {
115
134
  if (!plugin.isEnabled(agent)) {
135
+ if (pluginName === agent.baseagent)
136
+ throw new Error('所选基座的运行配置不可用:' + pluginName);
116
137
  logger.debug(`Plugin '${pluginName}' disabled for agent '${agent.name}', skipping`);
117
138
  continue;
118
139
  }
@@ -122,7 +143,8 @@ export class AgentLoader {
122
143
  }
123
144
  catch (error) {
124
145
  const message = error instanceof Error ? error.message : String(error);
125
- creationErrors?.push({ evolagentName: agent.name, baseagent: pluginName, message });
146
+ creationErrors?.push({ evolagentName: agent.name, baseagent: pluginName, message,
147
+ reason: pluginRuntimeReason('INVALID_CONFIG', 'configuration', '基座启用检查失败', error) });
126
148
  logger.error(`Cannot enable plugin ${pluginName} for ${agent.name}:`, error);
127
149
  continue;
128
150
  }
@@ -139,7 +161,40 @@ export class AgentLoader {
139
161
  continue;
140
162
  }
141
163
  teardown = instance.agent.dispose?.bind(instance.agent);
164
+ if (getBaseagentPluginDescriptor(pluginName)) {
165
+ const errors = validateRequiredBaseagentRunner(instance.agent, pluginName);
166
+ const force = isBaseagentPluginForced(pluginName);
167
+ const runnable = instance.agent.name === pluginName
168
+ && typeof instance.agent.runQuery === 'function' && typeof instance.agent.dispose === 'function';
169
+ if (errors.length && (!force || !runnable)) {
170
+ throw Object.assign(new Error(errors.join('; ')), { code: 'BASEAGENT_REQUIREMENTS_UNMET' });
171
+ }
172
+ if (errors.length) {
173
+ logger.warn(`Force-loading runner ${pluginName} with unmet B requirements:`, errors);
174
+ recordPluginWarnings('baseagent', pluginName, errors);
175
+ }
176
+ else {
177
+ instance.agent.capabilities = { ...instance.agent.capabilities, compact: true };
178
+ }
179
+ }
142
180
  instance.agent.dispose = () => lifecycle.dispose();
181
+ instance.agent = restrictDeclaredRunnerCapabilities(pluginName, instance.agent, async (overrides) => {
182
+ const { peekRunnerCatalog, resolveCatalogModel } = await import('../model/model-catalog.js');
183
+ const { resolveEffective } = await import('../../config/config-manager.js');
184
+ try {
185
+ const config = resolveEffective({ self: agent.aid }, { cache: true });
186
+ const model = overrides?.model ?? config.baseagents?.[pluginName]?.model;
187
+ const catalog = overrides?.provider
188
+ ? peekRunnerCatalog(pluginName, undefined, { providerId: overrides.provider })
189
+ : peekRunnerCatalog(pluginName, agent.aid, {});
190
+ const entry = model ? catalog.models.find(item => item.id === resolveCatalogModel(catalog, model)) : undefined;
191
+ return { modelChecked: true, ...(model ? { model: { id: model,
192
+ imageIn: entry?.imageIn, reasoningLevels: entry?.reasoningLevels } } : {}) };
193
+ }
194
+ catch {
195
+ return { modelChecked: true };
196
+ }
197
+ });
143
198
  instance.lifecycle = lifecycle;
144
199
  instances.push(instance);
145
200
  logger.info(`✓ Runner created: agent=${instance.evolagentName} baseagent=${instance.baseagent}`);
@@ -152,7 +207,8 @@ export class AgentLoader {
152
207
  logger.warn(`[AgentLoader] Cleanup failed for ${lifecycle.owner}:`, disposeError);
153
208
  }
154
209
  const message = error instanceof Error ? error.message : String(error);
155
- creationErrors?.push({ evolagentName: agent.name, baseagent: pluginName, message });
210
+ creationErrors?.push({ evolagentName: agent.name, baseagent: pluginName, message,
211
+ reason: pluginRuntimeReason('CREATE_FAILED', 'create', '基座实例创建失败', error) });
156
212
  logger.error(`✗ Failed to create runner for agent='${agent.name}' baseagent='${pluginName}':`, error);
157
213
  }
158
214
  }
@@ -0,0 +1,26 @@
1
+ import { createHash } from 'node:crypto';
2
+ // Runtime prefill only. Hash the connection so credentials are never used as map keys.
3
+ const models = new Map();
4
+ const pending = new Map();
5
+ export function defaultModelKey(baseagent, connection) {
6
+ return createHash('sha256').update(JSON.stringify({ baseagent, connection })).digest('hex');
7
+ }
8
+ export function getRuntimeBaseagentModelDefault(key) {
9
+ return models.get(key);
10
+ }
11
+ export function clearRuntimeBaseagentModelDefaults() {
12
+ models.clear();
13
+ }
14
+ export function discoverRuntimeBaseagentModelDefault(key, load) {
15
+ const existing = pending.get(key);
16
+ if (existing)
17
+ return existing;
18
+ const discovery = load().then(model => {
19
+ if (models.size >= 128)
20
+ models.delete(models.keys().next().value);
21
+ models.set(key, model);
22
+ return model;
23
+ }).finally(() => pending.delete(key));
24
+ pending.set(key, discovery);
25
+ return discovery;
26
+ }
@@ -2,21 +2,44 @@
2
2
  * Baseagent 插件描述符类型定义与校验函数
3
3
  *
4
4
  * 插件接入协议:
5
- * - 一个目录即一个插件(src/agents/<name>/index.ts 存在即被发现)
5
+ * - daemon.json.plugins 的 baseagent:<name> 是唯一声明入口
6
6
  * - 自描述:通过 descriptor 声明身份、能力、环境支持
7
- * - 无中央清单:启动期扫描,自动发现与注册
7
+ * - 运行固定入口:只注册声明对应的 src/dist/agents/<name>/index.ts/js
8
+ * - 安装扫描:可独立读取随包轻量描述符及依赖,不自动注册运行时
8
9
  * - 环境匹配:未实测环境不启用
9
10
  * - 失败隔离:单个插件失败不影响其他插件和 daemon 启动
10
11
  */
11
12
  import { createRequire } from 'node:module';
13
+ import { recordRuntimePlugin, updateRuntimePlugin, validateRuntimePluginDescriptor } from '../plugin/plugin-lifecycle.js';
14
+ const pluginStatuses = new Map();
15
+ export function recordBaseagentPluginStatus(status) {
16
+ pluginStatuses.set(status.baseagent, status);
17
+ updateRuntimePlugin('baseagent', status.baseagent, status.status === 'loaded' ? 'registered' : status.status, status.reason);
18
+ }
19
+ export function getBaseagentPluginStatuses() {
20
+ return [...pluginStatuses.values()].map(status => ({ ...status,
21
+ ...(status.reason ? { reason: { ...status.reason } } : {}) }));
22
+ }
12
23
  // ============================================================================
13
24
  // 常量
14
25
  // ============================================================================
15
- /** B 类能力 ID 列表(B01–B14,必须全部声明) */
26
+ /** Host-owned levels; stable IDs are not renamed when a requirement is promoted. */
16
27
  export const REQUIRED_B_CAPABILITIES = [
17
28
  'B01', 'B02', 'B03', 'B04', 'B05', 'B06', 'B07',
18
- 'B08', 'B09', 'B10', 'B11', 'B12', 'B13', 'B14',
29
+ 'B08', 'B09', 'B10', 'B11', 'B13', 'B14',
30
+ 'C03', 'C05', 'C18', 'C19',
19
31
  ];
32
+ export function baseagentCapabilityLevel(id) {
33
+ if (id === 'C06')
34
+ return undefined; // Retired: /new preserves the old backend history.
35
+ if (REQUIRED_B_CAPABILITIES.includes(id))
36
+ return 'B';
37
+ if (id === 'B12' || id === 'X07' || /^C(?:0[1-9]|1\d|2[0-7])$/.test(id))
38
+ return 'C';
39
+ if (/^X(?:0[1-9]|1\d|20)$/.test(id))
40
+ return 'X';
41
+ return undefined;
42
+ }
20
43
  /** 插件名称格式正则(小写字母开头,可含数字和连字符,1-32 字符) */
21
44
  export const PLUGIN_NAME_PATTERN = /^[a-z][a-z0-9-]{0,31}$/;
22
45
  /**
@@ -28,12 +51,21 @@ export const PLUGIN_NAME_PATTERN = /^[a-z][a-z0-9-]{0,31}$/;
28
51
  * @param builtinAliases 内置 baseagent 别名集合
29
52
  * @returns 校验结果
30
53
  */
31
- export function validatePluginDescriptor(descriptor, dirname, builtinNames, builtinAliases, currentOS = process.platform) {
54
+ export function validatePluginDescriptor(descriptor, dirname, builtinNames, builtinAliases, currentOS = process.platform, options = {}) {
32
55
  const errors = [];
56
+ const warnings = [];
33
57
  if (!isRecord(descriptor)) {
34
58
  return { valid: false, errors: ['Descriptor must be an object'] };
35
59
  }
36
60
  const d = descriptor;
61
+ if (d.apiVersion !== undefined || d.load !== undefined) {
62
+ errors.push(...validateRuntimePluginDescriptor(d, 'baseagent'));
63
+ if (d.executionContract !== 'host-runner-1')
64
+ errors.push('Unsupported executionContract; current Host implements host-runner-1, not candidate v2');
65
+ if (typeof d.load !== 'function' && typeof d.createRunner !== 'function') {
66
+ errors.push('Versioned baseagent requires load() or a Host runner factory');
67
+ }
68
+ }
37
69
  // === 1. 基础字段校验 ===
38
70
  if (!d.name || typeof d.name !== 'string') {
39
71
  errors.push('Missing or invalid field: name');
@@ -89,11 +121,15 @@ export function validatePluginDescriptor(descriptor, dirname, builtinNames, buil
89
121
  }
90
122
  }
91
123
  }
124
+ for (const key of ['usesNativeModelSelection']) {
125
+ if (d[key] !== undefined && typeof d[key] !== 'function')
126
+ errors.push(`${key} must be a function`);
127
+ }
92
128
  if (d.defaultModel !== undefined && (typeof d.defaultModel !== 'string' || !d.defaultModel.trim())) {
93
129
  errors.push('defaultModel must be a non-empty string');
94
130
  }
95
- if (d.probe !== undefined && typeof d.probe !== 'function')
96
- errors.push('probe must be a function');
131
+ if (typeof d.probe !== 'function')
132
+ errors.push('B02: probe must be a function');
97
133
  // === 2. 环境声明校验 ===
98
134
  if (!Array.isArray(d.environments) || d.environments.length === 0) {
99
135
  errors.push('environments must be non-empty array');
@@ -134,8 +170,15 @@ export function validatePluginDescriptor(descriptor, dirname, builtinNames, buil
134
170
  if (declaredIds.has(card.id))
135
171
  errors.push(`Duplicate capability ID: ${card.id}`);
136
172
  declaredIds.add(card.id);
173
+ if (card.id === 'C06') {
174
+ errors.push('Capability C06 has been removed; use a new session instead');
175
+ continue;
176
+ }
177
+ const level = baseagentCapabilityLevel(card.id);
178
+ // Legacy positive B records may be read, but are never optional switches.
179
+ const legacyLevel = (REQUIRED_B_CAPABILITIES.includes(card.id) || card.id === 'B12') && card.level === card.id[0];
137
180
  if (!['B', 'C', 'X'].includes(card.level)
138
- || (!card.id.startsWith('EXT-') && card.level !== card.id[0])) {
181
+ || (!card.id.startsWith('EXT-') && (level === undefined || (card.level !== level && !legacyLevel)))) {
139
182
  errors.push(`Capability ${card.id}: level does not match ID`);
140
183
  }
141
184
  if (!['native', 'adapted', 'host-only', 'unsupported'].includes(card.implementation)) {
@@ -158,13 +201,24 @@ export function validatePluginDescriptor(descriptor, dirname, builtinNames, buil
158
201
  || !['verified', 'unverified'].includes(card.verification)) {
159
202
  errors.push(`Capability ${card.id}: availability and verification are required`);
160
203
  }
204
+ if (card.evidence !== undefined) {
205
+ if (!Array.isArray(card.evidence))
206
+ errors.push(`Capability ${card.id}: evidence must be an array`);
207
+ else
208
+ for (const evidence of card.evidence) {
209
+ if (!isRecord(evidence) || !['unit', 'fixture', 'live'].includes(evidence.kind)
210
+ || !['linux', 'darwin', 'win32'].includes(evidence.os)
211
+ || ['pluginVersion', 'backendVersion', 'reference']
212
+ .some(key => typeof evidence[key] !== 'string' || !evidence[key].trim())
213
+ || typeof evidence.at !== 'string' || !/^\d{4}-\d\d-\d\dT/.test(evidence.at)
214
+ || !Number.isFinite(Date.parse(evidence.at))) {
215
+ errors.push(`Capability ${card.id}: evidence requires kind, OS, versions, ISO timestamp and reference`);
216
+ }
217
+ }
218
+ }
161
219
  }
162
- // B 类能力完整性检查
163
- const missingBCapabilities = REQUIRED_B_CAPABILITIES.filter((id) => !declaredIds.has(id));
164
- if (missingBCapabilities.length > 0) {
165
- errors.push(`Missing required B capabilities: ${missingBCapabilities.join(', ')}`);
166
- }
167
- // 能力一致性检查:当前环境下 B 类能力不能有 unknown + available + unverified 组合
220
+ // B is the required interface contract, not a declaration checklist. Retain
221
+ // legacy negative evidence so deleting a supported flag is not a migration.
168
222
  for (const cap of d.declaredCapabilities) {
169
223
  if (!isRecord(cap))
170
224
  continue;
@@ -172,23 +226,25 @@ export function validatePluginDescriptor(descriptor, dirname, builtinNames, buil
172
226
  const envOverride = cap.environments?.[currentOS];
173
227
  const actualAvailability = envOverride?.availability ?? cap.availability;
174
228
  const actualVerification = envOverride?.verification ?? cap.verification;
229
+ const capabilityErrors = options.force && REQUIRED_B_CAPABILITIES.includes(cap.id) ? warnings : errors;
175
230
  if (cap.implementation === 'unsupported' && actualAvailability === 'available') {
176
231
  errors.push(`Capability ${cap.id}: unsupported implementation cannot be available`);
177
232
  }
178
233
  // 不允许:available + unverified
179
234
  if (actualAvailability === 'available' && actualVerification === 'unverified') {
180
- errors.push(`Capability ${cap.id}: available but unverified on ${currentOS} ` +
235
+ capabilityErrors.push(`Capability ${cap.id}: available but unverified on ${currentOS} ` +
181
236
  `(must run probe script first)`);
182
237
  }
183
- // 不允许:unknown availability for B capabilities
184
- if (cap.id?.startsWith('B') && actualAvailability === 'unknown') {
185
- errors.push(`Capability ${cap.id}: unknown availability on ${currentOS}`);
238
+ if (REQUIRED_B_CAPABILITIES.includes(cap.id)
239
+ && (actualAvailability !== 'available' || actualVerification !== 'verified' || cap.implementation === 'unsupported')) {
240
+ capabilityErrors.push(`Required capability ${cap.id}: unavailable or unverified on ${currentOS}; `
241
+ + (options.force ? 'forced loading requested' : 'plugin cannot be admitted'));
186
242
  }
187
243
  }
188
244
  }
189
245
  // === 4. 工厂函数校验 ===
190
- if (typeof d.createRunner !== 'function') {
191
- errors.push('createRunner must be a function');
246
+ if (d.load !== undefined ? typeof d.load !== 'function' : typeof d.createRunner !== 'function') {
247
+ errors.push('load or createRunner must be a function');
192
248
  }
193
249
  if (d.createSessionAdapter !== undefined && typeof d.createSessionAdapter !== 'function') {
194
250
  errors.push('createSessionAdapter must be a function or undefined');
@@ -199,6 +255,7 @@ export function validatePluginDescriptor(descriptor, dirname, builtinNames, buil
199
255
  return {
200
256
  valid: errors.length === 0,
201
257
  errors,
258
+ ...(warnings.length ? { warnings } : {}),
202
259
  };
203
260
  }
204
261
  /**
@@ -235,10 +292,13 @@ function compileConfigSchema(schema) {
235
292
  }
236
293
  const descriptors = new Map();
237
294
  /** Metadata is available before Agent configs are loaded; registration does not start a runner. */
238
- export function registerBaseagentPluginDescriptor(descriptor) {
295
+ export function registerBaseagentPluginDescriptor(descriptor, options = {}) {
239
296
  const previous = descriptors.get(descriptor.name);
240
- const entry = { descriptor, validate: compileConfigSchema(descriptor.configSchema) };
297
+ const entry = { descriptor, validate: compileConfigSchema(descriptor.configSchema), force: options.force === true };
241
298
  descriptors.set(descriptor.name, entry);
299
+ const undoMetadata = recordRuntimePlugin({ kind: 'baseagent', name: descriptor.name, displayName: descriptor.displayName,
300
+ apiVersion: descriptor.apiVersion ?? 0, version: descriptor.version ?? '0.0.0', hostApi: descriptor.hostApi ?? 'legacy',
301
+ state: 'discovered', force: entry.force, warnings: [...(options.warnings ?? [])] });
242
302
  return () => {
243
303
  if (descriptors.get(descriptor.name) !== entry)
244
304
  return;
@@ -246,16 +306,24 @@ export function registerBaseagentPluginDescriptor(descriptor) {
246
306
  descriptors.set(descriptor.name, previous);
247
307
  else
248
308
  descriptors.delete(descriptor.name);
309
+ undoMetadata();
249
310
  };
250
311
  }
251
312
  export function getBaseagentPluginDescriptor(name) {
252
313
  return descriptors.get(name)?.descriptor;
253
314
  }
315
+ /** Applied deployment policy; editing daemon config takes effect after restart. */
316
+ export function isBaseagentPluginForced(name) {
317
+ return descriptors.get(name)?.force === true;
318
+ }
254
319
  export function validateBaseagentPluginConfigs(blocks, defaults = false) {
255
320
  if (!isRecord(blocks))
256
321
  return [];
257
322
  const errors = [];
258
323
  for (const [name, raw] of Object.entries(blocks)) {
324
+ if (defaults && isRecord(raw) && Object.hasOwn(raw, 'enabled')) {
325
+ errors.push(`/baseagents/${name}/enabled: use daemon.plugins[baseagent:${name}].enabled`);
326
+ }
259
327
  const entry = descriptors.get(name);
260
328
  if (!entry)
261
329
  continue;
@@ -265,10 +333,25 @@ export function validateBaseagentPluginConfigs(blocks, defaults = false) {
265
333
  errors.push(`/baseagents/${name}/${field}: use providers.json`);
266
334
  }
267
335
  }
268
- const value = defaults && isRecord(raw) ? Object.fromEntries(Object.entries(raw).filter(([k]) => k !== 'enabled')) : raw;
269
- if (!entry.validate(value)) {
336
+ if (!entry.validate(raw)) {
270
337
  errors.push(...(entry.validate.errors ?? []).map(error => `/baseagents/${name}${error.instancePath} ${error.message}`));
271
338
  }
272
339
  }
273
340
  return errors;
274
341
  }
342
+ /** Reuse existing Host plugins while deferring their runtime modules until first use. */
343
+ export function lazyAgentPlugin(name, load) {
344
+ let pending;
345
+ return {
346
+ name,
347
+ isEnabled: agent => !!agent.config.baseagents?.[name],
348
+ createAgent: async (agent, callbacks, lifecycle) => {
349
+ const plugin = await (pending ??= load());
350
+ if (plugin.name !== name)
351
+ throw new Error('Runner factory identity mismatch: ' + name);
352
+ if (!plugin.isEnabled(agent))
353
+ throw new Error('Baseagent configuration is not usable: ' + name);
354
+ return plugin.createAgent(agent, callbacks, lifecycle);
355
+ },
356
+ };
357
+ }