evolcore 0.0.49 → 0.0.51

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (514) hide show
  1. package/CHANGELOG.md +103 -3
  2. package/bin/ec-build.mjs +60 -0
  3. package/bin/ecmsg.js +64 -57
  4. package/dist/ability/caller/authorization.js +21 -0
  5. package/dist/ability/caller/command.js +173 -0
  6. package/dist/ability/caller/contract.js +117 -0
  7. package/dist/ability/caller/credential-files.js +132 -0
  8. package/dist/ability/caller/daemon.js +183 -0
  9. package/dist/ability/caller/schema-view.js +157 -0
  10. package/dist/ability/caller/service.js +519 -0
  11. package/dist/ability/command-contract.js +5 -0
  12. package/dist/ability/daemon.js +5 -1
  13. package/dist/ability/interop-v1.js +156 -106
  14. package/dist/ability/management.js +1 -0
  15. package/dist/agent-template/jobs.js +79 -3
  16. package/dist/agent-template/runtime.js +459 -47
  17. package/dist/agent-template/service.js +1242 -198
  18. package/dist/agent-template/share.js +103 -0
  19. package/dist/agent-template/tool-runner.js +25 -0
  20. package/dist/agent-template/types.js +10 -2
  21. package/dist/agents/claude/availability.js +94 -0
  22. package/dist/agents/claude/capability-provider.js +154 -0
  23. package/dist/agents/claude/index.js +145 -0
  24. package/dist/agents/{claude-runner.js → claude/runner.js} +78 -166
  25. package/dist/agents/claude/session-file-adapter.js +246 -0
  26. package/dist/agents/codex/app-server-client.js +90 -10
  27. package/dist/agents/codex/availability.js +164 -0
  28. package/dist/agents/codex/capability-provider.js +138 -0
  29. package/dist/agents/codex/cli.js +38 -0
  30. package/dist/agents/codex/index.js +345 -0
  31. package/dist/agents/codex/mcp-elicitation.js +135 -0
  32. package/dist/agents/{codex-runner.js → codex/runner.js} +652 -383
  33. package/dist/agents/codex/session-file-adapter.js +834 -0
  34. package/dist/agents/dsh/availability.js +28 -0
  35. package/dist/agents/dsh/capability-provider.js +56 -0
  36. package/dist/agents/dsh/desktop-locations.ps1 +66 -0
  37. package/dist/agents/dsh/desktop-probe.cjs +37 -0
  38. package/dist/agents/dsh/index.js +98 -0
  39. package/dist/agents/dsh/installation.js +400 -0
  40. package/dist/agents/dsh/resources.js +755 -0
  41. package/dist/agents/dsh/runner.js +1183 -0
  42. package/dist/agents/dsh/runtime/README.md +243 -0
  43. package/dist/agents/dsh/runtime/authorization.js +23 -0
  44. package/dist/agents/dsh/runtime/bridge.js +837 -0
  45. package/dist/agents/dsh/runtime/config.js +271 -0
  46. package/dist/agents/dsh/runtime/entry.js +229 -0
  47. package/dist/agents/dsh/runtime/session-inspector.js +340 -0
  48. package/dist/agents/dsh/runtime/tool-policy.js +49 -0
  49. package/dist/agents/dsh/session-file-adapter.js +145 -0
  50. package/dist/agents/ecagent/index.js +215 -0
  51. package/dist/agents/{ecagent-runner.js → ecagent/runner.js} +592 -106
  52. package/dist/agents/ecagent/session-file-adapter.js +134 -0
  53. package/dist/agents/gemini/index.js +96 -0
  54. package/dist/agents/{gemini-runner.js → gemini/runner.js} +18 -23
  55. package/dist/{core/session/adapters/gemini-session-file-adapter.js → agents/gemini/session-file-adapter.js} +2 -2
  56. package/dist/aun/ability-device-routing.js +11 -17
  57. package/dist/aun/aid/agentmd.js +27 -1
  58. package/dist/aun/aid/control-aid.js +52 -32
  59. package/dist/aun/aid/managed-operation.js +6 -4
  60. package/dist/aun/group/invite-service.js +7 -37
  61. package/dist/aun/group/operations.js +6 -0
  62. package/dist/aun/menu/client.js +1 -1
  63. package/dist/aun/msg/history.js +1 -1
  64. package/dist/aun/msg/managed-operation.js +93 -21
  65. package/dist/aun/msg/mention-schema.js +1 -1
  66. package/dist/aun/msg/p2p.js +32 -4
  67. package/dist/aun/msg/upload.js +126 -3
  68. package/dist/aun/service-proxy.js +1 -1
  69. package/dist/aun/storage/index.js +242 -0
  70. package/dist/build-identity.json +1 -1
  71. package/dist/channels/aun.js +698 -213
  72. package/dist/channels/daemon.js +3 -2
  73. package/dist/channels/dingtalk.js +1 -1
  74. package/dist/channels/feishu.js +9 -9
  75. package/dist/channels/qqbot.js +1 -1
  76. package/dist/channels/wechat.js +2 -2
  77. package/dist/channels/wecom.js +1 -1
  78. package/dist/claude-gateway/agent-registration.js +389 -0
  79. package/dist/claude-gateway/binding.js +96 -0
  80. package/dist/claude-gateway/inbox.js +138 -0
  81. package/dist/claude-gateway/index.js +125 -0
  82. package/dist/claude-gateway/listing.js +330 -0
  83. package/dist/claude-gateway/router.js +328 -0
  84. package/dist/claude-gateway/sessions.js +128 -0
  85. package/dist/claude-gateway/terminal.js +250 -0
  86. package/dist/claude-gateway/transcript.js +272 -0
  87. package/dist/claude-gateway/types.js +14 -0
  88. package/dist/cli/ability-command.js +45 -0
  89. package/dist/cli/ability-output.js +182 -0
  90. package/dist/cli/agent-command.js +21 -2
  91. package/dist/cli/agent-create.js +197 -56
  92. package/dist/cli/agent-template.js +400 -27
  93. package/dist/cli/agent.js +105 -11
  94. package/dist/cli/aun-commands.js +237 -123
  95. package/dist/cli/bench.js +5 -2
  96. package/dist/cli/config.js +22 -6
  97. package/dist/cli/daemon-commands.js +283 -109
  98. package/dist/cli/data-command.js +1 -1
  99. package/dist/cli/debug-mode.js +9 -0
  100. package/dist/cli/directory.js +1 -2
  101. package/dist/cli/ecmsg-gateway.js +64 -26
  102. package/dist/cli/fs-command.js +67 -39
  103. package/dist/cli/index.js +45 -12
  104. package/dist/cli/init.js +161 -90
  105. package/dist/cli/managed-command-guard.js +3 -0
  106. package/dist/cli/menu-client.js +32 -7
  107. package/dist/cli/model.js +1 -1
  108. package/dist/cli/pay-command.js +30 -0
  109. package/dist/cli/provider-command.js +6 -2
  110. package/dist/cli/restart-monitor.js +4 -4
  111. package/dist/cli/services-command.js +35 -10
  112. package/dist/cli/skill-command.js +4 -4
  113. package/dist/cli/task-context.js +24 -14
  114. package/dist/cli/team-workspace-command.js +50 -52
  115. package/dist/cli/thread-command.js +81 -14
  116. package/dist/cli/trigger-command.js +47 -12
  117. package/dist/cli/watch-logs.js +2 -1
  118. package/dist/config/access-policy.js +16 -3
  119. package/dist/config/boot-log.js +3 -0
  120. package/dist/config/builtin-role-templates.js +1 -1
  121. package/dist/config/config-field-policy.js +26 -13
  122. package/dist/config/config-manager.js +113 -52
  123. package/dist/config/config-operation-service.js +22 -1
  124. package/dist/config/gateway-config.js +29 -44
  125. package/dist/config/invoke-ipc-service.js +1 -1
  126. package/dist/config/owner-config.js +5 -19
  127. package/dist/config/peer-book-store.js +2 -3
  128. package/dist/config/peer-book.js +2 -2
  129. package/dist/config/peer-role-resolver.js +3 -9
  130. package/dist/config/provider-identity-migration.js +24 -105
  131. package/dist/config/provider-ipc-service.js +13 -3
  132. package/dist/config/provider-local-sync.js +4 -1
  133. package/dist/config/provider-menu-request.js +21 -3
  134. package/dist/config/provider-templates.js +1 -1
  135. package/dist/config/providers-config.js +138 -31
  136. package/dist/config/providers-import.js +3 -3
  137. package/dist/config/providers-management.js +109 -118
  138. package/dist/config/resolved-config-op.js +1 -42
  139. package/dist/config/schema-migration.js +254 -15
  140. package/dist/config/schema-registry.js +53 -8
  141. package/dist/config-store.js +1343 -63
  142. package/dist/core/{agent-application-service.js → agent/agent-application-service.js} +228 -9
  143. package/dist/core/{agent-create-status.js → agent/agent-create-status.js} +112 -4
  144. package/dist/core/{agent-creation-claim.js → agent/agent-creation-claim.js} +3 -3
  145. package/dist/core/{agent-ipc-registration.js → agent/agent-ipc-registration.js} +119 -25
  146. package/dist/core/{agent-reload-coordinator.js → agent/agent-reload-coordinator.js} +65 -0
  147. package/dist/core/{agent-runtime.js → agent/agent-runtime.js} +249 -79
  148. package/dist/core/{evolagent-registry.js → agent/evolagent-registry.js} +23 -18
  149. package/dist/core/{evolagent.js → agent/evolagent.js} +11 -11
  150. package/dist/core/auth/agent-delegation.js +15 -8
  151. package/dist/core/auth/delegation-authorization.js +28 -0
  152. package/dist/core/auth/operation-authorizer.js +20 -2
  153. package/dist/core/auth/operation-catalog.js +80 -8
  154. package/dist/core/baseagent/baseagent-availability.js +197 -0
  155. package/dist/core/baseagent/baseagent-capability-adapter.js +288 -0
  156. package/dist/core/baseagent/baseagent-config-shared.js +56 -0
  157. package/dist/core/baseagent/baseagent-identity.js +68 -0
  158. package/dist/core/{baseagent-loader.js → baseagent/baseagent-loader.js} +89 -6
  159. package/dist/core/baseagent/baseagent-model-defaults.js +26 -0
  160. package/dist/core/baseagent/baseagent-plugin-descriptor.js +357 -0
  161. package/dist/core/baseagent/baseagent-plugin-loader.js +367 -0
  162. package/dist/core/baseagent/baseagent.js +157 -0
  163. package/dist/{agents → core/baseagent}/runner-types.js +36 -4
  164. package/dist/core/capability/capability-manager.js +91 -33
  165. package/dist/core/capability/providers/claude-capability-provider.js +2 -154
  166. package/dist/core/capability/providers/codex-capability-provider.js +2 -136
  167. package/dist/core/{channel-loader.js → channel/channel-loader.js} +226 -38
  168. package/dist/core/{channel-runtime.js → channel/channel-runtime.js} +21 -19
  169. package/dist/core/command/agent-control.js +80 -17
  170. package/dist/core/command/agent-template-menu.js +23 -10
  171. package/dist/core/command/agentmd-menu-request.js +19 -8
  172. package/dist/core/command/agentmd-menu.js +14 -5
  173. package/dist/core/command/cli-intent-parser.js +15 -0
  174. package/dist/core/command/command-handler.js +127 -57
  175. package/dist/core/command/context-policy-menu.js +122 -0
  176. package/dist/core/command/data-root-resolver.js +157 -20
  177. package/dist/core/command/memory-slash.js +6 -6
  178. package/dist/core/command/menu-catalog.js +95 -19
  179. package/dist/core/command/menu-file-path.js +70 -0
  180. package/dist/core/command/menu-handler.js +392 -93
  181. package/dist/core/command/menu-protocol.js +47 -8
  182. package/dist/core/command/menu-query-batch.js +9 -5
  183. package/dist/core/command/private-mention-menu.js +71 -0
  184. package/dist/core/command/provider-menu.js +7 -11
  185. package/dist/core/command/role-menu.js +1 -1
  186. package/dist/core/command/skill-slash.js +17 -5
  187. package/dist/core/command/slash-gate.js +2 -4
  188. package/dist/core/command/slash-handler.js +143 -121
  189. package/dist/core/command/team-workspace-bootstrap.js +2 -1
  190. package/dist/core/command/team-workspace-team.js +3 -3
  191. package/dist/core/command/topic-slash.js +16 -10
  192. package/dist/core/{daemon-bootstrap.js → daemon/daemon-bootstrap.js} +14 -18
  193. package/dist/core/{daemon-control.js → daemon/daemon-control.js} +48 -21
  194. package/dist/core/{daemon-lifecycle.js → daemon/daemon-lifecycle.js} +28 -20
  195. package/dist/core/{host-snapshot.js → daemon/host-snapshot.js} +10 -5
  196. package/dist/core/{ipc-registration.js → daemon/ipc-registration.js} +101 -37
  197. package/dist/core/{lifecycle-notice.js → daemon/lifecycle-notice.js} +4 -5
  198. package/dist/core/file-integrity/store.js +1 -1
  199. package/dist/core/handoff/ipc-registration.js +3 -3
  200. package/dist/core/handoff/runtime.js +2 -2
  201. package/dist/{agents → core/inference}/request-identity.js +2 -2
  202. package/dist/core/inference/text-inference.js +4 -4
  203. package/dist/core/{bootstrap-messages.js → initialization/bootstrap-messages.js} +10 -10
  204. package/dist/core/{bootstrap-service.js → initialization/bootstrap-service.js} +24 -23
  205. package/dist/core/initialization/service.js +57 -9
  206. package/dist/core/invoke/executors/media.js +1 -1
  207. package/dist/core/invoke/executors/text.js +1 -1
  208. package/dist/core/memory/consolidation-context.js +3 -2
  209. package/dist/core/memory/consolidation-trigger.js +9 -3
  210. package/dist/core/memory/consolidation.js +39 -68
  211. package/dist/core/memory/memory-admin.js +6 -6
  212. package/dist/core/memory/memory-writer.js +1 -1
  213. package/dist/core/memory/relation-idle-monitor.js +1 -1
  214. package/dist/core/message/aun-ipc-sender.js +204 -88
  215. package/dist/core/message/aun-request-registry.js +44 -5
  216. package/dist/core/message/auto-mention-gate.js +1 -1
  217. package/dist/core/message/contact-admission.js +1 -1
  218. package/dist/core/message/im-renderer.js +19 -0
  219. package/dist/core/{interaction-router.js → message/interaction-router.js} +131 -1
  220. package/dist/core/message/items-formatter.js +5 -5
  221. package/dist/core/message/message-admission.js +1 -1
  222. package/dist/core/message/message-bridge.js +239 -59
  223. package/dist/core/message/message-log.js +8 -0
  224. package/dist/core/message/message-queue.js +88 -7
  225. package/dist/core/message/message-utils.js +1 -1
  226. package/dist/core/message/peer-mode.js +16 -5
  227. package/dist/core/message/response-engine.js +351 -152
  228. package/dist/core/message/send-options.js +44 -7
  229. package/dist/core/message/send-routing.js +55 -115
  230. package/dist/core/message/stream-idle-monitor.js +1 -1
  231. package/dist/core/{data-migration.js → migration/data-migration.js} +29 -1
  232. package/dist/core/model/catalog-service.js +29 -8
  233. package/dist/core/model/model-capabilities.js +88 -0
  234. package/dist/core/model/model-catalog.js +18 -7
  235. package/dist/core/model/model-diagnostics.js +4 -4
  236. package/dist/core/ownership/owner-resolver.js +107 -101
  237. package/dist/core/{pack-auth.js → pack/pack-auth.js} +34 -3
  238. package/dist/core/{pack-install.js → pack/pack-install.js} +95 -17
  239. package/dist/core/permission/approval-gateway.js +9 -18
  240. package/dist/core/permission/ec-command-parser.js +242 -82
  241. package/dist/core/permission/managed-file.js +234 -0
  242. package/dist/core/permission/protected-paths.js +120 -9
  243. package/dist/core/permission/sandbox-runtime.js +267 -3
  244. package/dist/core/permission/services-path-acl.js +9 -2
  245. package/dist/core/permission/session-path-grants.js +1 -1
  246. package/dist/core/permission/shell-environment.js +15 -1
  247. package/dist/core/permission/tool-policy.js +21 -9
  248. package/dist/core/plugin/plugin-lifecycle.js +442 -0
  249. package/dist/core/session/adapters/claude-session-file-adapter.js +2 -242
  250. package/dist/core/session/adapters/codex-session-file-adapter.js +2 -562
  251. package/dist/core/session/adapters/ecagent-session-file-adapter.js +2 -134
  252. package/dist/core/{background-session → session/background}/session-cleanup.js +2 -2
  253. package/dist/core/{background-session → session/background}/types.js +1 -1
  254. package/dist/core/session/session-file-health.js +2 -272
  255. package/dist/core/session/session-idle-monitor.js +1 -1
  256. package/dist/core/session/session-manager.js +76 -12
  257. package/dist/core/session/session-mapper.js +16 -0
  258. package/dist/core/session/session-terminal.js +185 -0
  259. package/dist/core/session/session-title.js +8 -11
  260. package/dist/core/{system-session → session/system}/memory.js +43 -9
  261. package/dist/core/{system-session → session/system}/registry.js +1 -1
  262. package/dist/core/{system-session → session/system}/types.js +1 -1
  263. package/dist/core/skill/index-generator.js +3 -3
  264. package/dist/core/skill/switch-resolver.js +3 -0
  265. package/dist/core/task/task-activity-store.js +112 -0
  266. package/dist/core/task/task-recovery-service.js +2 -2
  267. package/dist/core/thread/command-parser.js +4 -1
  268. package/dist/core/thread/ipc-operation.js +6 -4
  269. package/dist/core/thread/thread-operation.js +27 -11
  270. package/dist/core/thread/thread-route.js +5 -3
  271. package/dist/core/thread/thread-service.js +307 -58
  272. package/dist/core/thread/topic-id.js +52 -2
  273. package/dist/core/thread/types.js +15 -1
  274. package/dist/directory/{owner-directory-admission.js → admission.js} +3 -3
  275. package/dist/directory/{owner-directory-cache.js → cache.js} +90 -8
  276. package/dist/directory/{owner-directory-markdown.js → markdown.js} +2 -2
  277. package/dist/directory/{owner-directory-query-operation.js → query-operation.js} +83 -9
  278. package/dist/directory/{owner-directory-search.js → search.js} +50 -2
  279. package/dist/directory/{owner-directory-store.js → store.js} +2 -2
  280. package/dist/eck/kit-renderer.js +3 -2
  281. package/dist/eck/manifest-engine.js +64 -2
  282. package/dist/eck/message-renderer.js +35 -0
  283. package/dist/ecweb/basic-settings-service.js +12 -10
  284. package/dist/{contracts → ecweb/contracts}/ecweb-service-protocol.js +2 -1
  285. package/dist/ecweb/dsh-native-service.js +413 -0
  286. package/dist/ecweb/providers-service.js +5 -3
  287. package/dist/ecweb/runtime/lifecycle.js +1 -1
  288. package/dist/ecweb/runtime/supervisor.js +1 -1
  289. package/dist/event-center/center-config.js +2 -2
  290. package/dist/event-center/dispatcher.js +1 -1
  291. package/dist/event-center/ipc-operation.js +12 -3
  292. package/dist/event-center/pack-loader.js +2 -2
  293. package/dist/event-center/registry.js +6 -6
  294. package/dist/event-center/runtime.js +2 -2
  295. package/dist/index.js +181 -77
  296. package/dist/ipc.js +161 -12
  297. package/dist/outputs/authorization.js +27 -0
  298. package/dist/outputs/events.js +10 -1
  299. package/dist/outputs/panel-cards.js +960 -0
  300. package/dist/paths.js +60 -1
  301. package/dist/pay/command.js +38 -0
  302. package/dist/pay/protocol.js +136 -0
  303. package/dist/pay/runtime.js +196 -0
  304. package/dist/pay/service.js +384 -0
  305. package/dist/pay/store.js +81 -0
  306. package/dist/response-system/engines/v1/proactive-flow.js +30 -3
  307. package/dist/services/dispatcher.js +25 -7
  308. package/dist/services/host/main.js +397 -0
  309. package/dist/services/host/protocol.js +125 -0
  310. package/dist/services/host/resident.js +347 -0
  311. package/dist/services/host-client.js +398 -0
  312. package/dist/services/host-deploy.js +180 -0
  313. package/dist/services/host-launch.js +117 -0
  314. package/dist/services/host-recycle.js +208 -0
  315. package/dist/services/host-runtime.js +841 -0
  316. package/dist/services/idempotency.js +44 -86
  317. package/dist/services/index-generator.js +4 -3
  318. package/dist/services/index.js +258 -36
  319. package/dist/services/ipc-operation.js +503 -78
  320. package/dist/services/pack-manager.js +2 -2
  321. package/dist/services/router.js +43 -3
  322. package/dist/services/script-runner.js +541 -100
  323. package/dist/services/service-payload.js +28 -1
  324. package/dist/services/validation.js +136 -5
  325. package/dist/stats/context-usage.js +110 -0
  326. package/dist/stats/model-resolver.js +103 -17
  327. package/dist/stats/query.js +5 -0
  328. package/dist/trigger/application-service.js +9 -6
  329. package/dist/trigger/authorization.js +36 -33
  330. package/dist/trigger/ipc-service.js +4 -4
  331. package/dist/trigger/local-files.js +8 -166
  332. package/dist/trigger/manager.js +2 -2
  333. package/dist/trigger/parser.js +48 -0
  334. package/dist/trigger/scheduler.js +35 -13
  335. package/dist/trigger/script-executor.js +21 -0
  336. package/dist/trigger/script-sandbox.js +77 -232
  337. package/dist/trigger/system-definitions.js +25 -0
  338. package/dist/trigger/validation.js +1 -1
  339. package/dist/utils/aid-bind.js +3 -0
  340. package/dist/utils/atomic-write.js +88 -1
  341. package/dist/utils/cross-platform.js +4 -42
  342. package/dist/utils/error-dict.json +22 -1
  343. package/dist/utils/error-utils.js +193 -6
  344. package/dist/utils/evolcore-version.js +2 -2
  345. package/dist/utils/host-info.js +74 -1
  346. package/dist/utils/logger.js +5 -3
  347. package/dist/utils/media-cache.js +284 -42
  348. package/dist/utils/restart-safety.js +14 -1
  349. package/dist/utils/startup-trace.js +20 -4
  350. package/dist/utils/system-memory.js +113 -25
  351. package/dist/utils/systemd-lifecycle.js +154 -0
  352. package/dist/utils/welcome.js +64 -20
  353. package/dist/utils/windows-shell-trust.js +7 -3
  354. package/ecagent/README.md +35 -0
  355. package/ecagent/dist/agent-loop.js +80 -30
  356. package/ecagent/dist/harness/env/nodejs.d.ts +16 -0
  357. package/ecagent/dist/harness/env/nodejs.js +49 -20
  358. package/ecagent/dist/harness/messages.js +3 -2
  359. package/ecagent/dist/harness/types.d.ts +1 -0
  360. package/ecagent/dist/runtime/types.d.ts +2 -0
  361. package/ecagent/dist/runtime/utils/validation.d.ts +7 -1
  362. package/ecagent/dist/runtime/utils/validation.js +42 -0
  363. package/ecagent/dist/types.d.ts +2 -0
  364. package/kits/docs/INDEX.md +3 -2
  365. package/kits/docs/aun/AUN/346/266/210/346/201/257/347/261/273/345/236/213/344/270/216/345/261/236/346/200/247.md +1 -0
  366. package/kits/docs/channels/aun.md +1 -1
  367. package/kits/docs/channels/feishu.md +1 -1
  368. package/kits/docs/evolcore/INDEX.md +13 -9
  369. package/kits/docs/evolcore/agent-create.md +2 -0
  370. package/kits/docs/evolcore/agent.md +133 -11
  371. package/kits/docs/evolcore/aid.md +39 -6
  372. package/kits/docs/evolcore/config.md +95 -1
  373. package/kits/docs/evolcore/ctl.md +2 -1
  374. package/kits/docs/evolcore/ec-capabilities.md +7 -10
  375. package/kits/docs/evolcore/ecweb-lifecycle.md +5 -1
  376. package/kits/docs/evolcore/event.md +1 -1
  377. package/kits/docs/evolcore/fs.md +49 -3
  378. package/kits/docs/evolcore/group.md +5 -4
  379. package/kits/docs/evolcore/memory-consolidation.md +1 -1
  380. package/kits/docs/evolcore/memory-tags.md +2 -0
  381. package/kits/docs/evolcore/menu-client.md +3 -3
  382. package/kits/docs/evolcore/menu-protocol.md +31 -2
  383. package/kits/docs/evolcore/model.md +12 -1
  384. package/kits/docs/evolcore/msg.md +96 -36
  385. package/kits/docs/evolcore/pay.md +22 -0
  386. package/kits/docs/evolcore/plugin.md +74 -0
  387. package/kits/docs/evolcore/provider.md +29 -2
  388. package/kits/docs/evolcore/rpc.md +2 -2
  389. package/kits/docs/evolcore/services.md +46 -18
  390. package/kits/docs/evolcore/skill.md +17 -1
  391. package/kits/docs/evolcore/stats.md +5 -0
  392. package/kits/docs/evolcore/storage.md +22 -0
  393. package/kits/docs/evolcore/thread-chain.md +20 -9
  394. package/kits/docs/evolcore/tool-authorization.md +14 -0
  395. package/kits/docs/evolcore/trigger.md +89 -13
  396. package/kits/docs/identity/AID_PROFILE_SPEC.md +1 -1
  397. package/kits/docs/venues/feishu-group.md +3 -2
  398. package/kits/docs/venues/feishu-private.md +3 -2
  399. package/kits/rules/01-overview.md +11 -32
  400. package/kits/rules/02-navigation.md +20 -6
  401. package/kits/rules/06-channel.md +20 -4
  402. package/kits/schemas/_meta.json +42 -5
  403. package/kits/schemas/agent-config.schema.21.json +974 -0
  404. package/kits/schemas/agent-config.schema.22.json +977 -0
  405. package/kits/schemas/agent-config.schema.23.json +974 -0
  406. package/kits/schemas/agent-config.schema.24.json +986 -0
  407. package/kits/schemas/agent-config.schema.25.json +986 -0
  408. package/kits/schemas/daemon.schema.10.json +373 -0
  409. package/kits/schemas/daemon.schema.11.json +487 -0
  410. package/kits/schemas/daemon.schema.12.json +505 -0
  411. package/kits/schemas/daemon.schema.9.json +12 -0
  412. package/kits/schemas/defaults.schema.7.json +472 -0
  413. package/kits/schemas/defaults.schema.8.json +484 -0
  414. package/kits/schemas/providers.schema.1.json +1 -1
  415. package/kits/schemas/providers.schema.2.json +1 -1
  416. package/kits/schemas/providers.schema.3.json +26 -4
  417. package/kits/schemas/relation-config.schema.13.json +289 -0
  418. package/kits/skills/.switches.json +17 -1
  419. package/kits/skills/ability/SKILL.md +395 -33
  420. package/kits/skills/ability/STRUCTURE.md +338 -0
  421. package/kits/skills/ability/references/cli.md +208 -0
  422. package/kits/skills/ability/references/development.md +107 -37
  423. package/kits/skills/ability/references/management.md +106 -46
  424. package/kits/skills/ability/references/runtime-protocol.md +65 -63
  425. package/kits/skills/agent-output-cards/SKILL.md +80 -37
  426. package/kits/skills/agent-output-cards/examples/html-surface.json +11 -0
  427. package/kits/skills/agent-output-cards/examples/meeting-followups.json +16 -0
  428. package/kits/skills/agent-output-cards/examples/meeting-latest.json +24 -0
  429. package/kits/skills/agent-output-cards/examples/project-metrics.json +16 -0
  430. package/kits/skills/agent-output-cards/examples/quick-links.json +18 -0
  431. package/kits/skills/agent-output-cards/examples/surface.html +8 -0
  432. package/kits/skills/agent-template-project/SKILL.md +51 -0
  433. package/kits/skills/agent-template-project/references/01-collect-and-pack.md +174 -0
  434. package/kits/skills/agent-template-project/references/02-upload-and-share.md +109 -0
  435. package/kits/skills/agent-template-project/references/03-download-and-install.md +189 -0
  436. package/kits/skills/agent-template-project/references/04-upgrade-and-recovery.md +74 -0
  437. package/kits/skills/agent-template-project/references/05-publish-to-platform.md +62 -0
  438. package/kits/skills/ec-group/SKILL.md +8 -6
  439. package/kits/skills/ec-group/TASK.md +186 -0
  440. package/kits/skills/ec-group/WORKLOG.md +180 -0
  441. package/kits/skills/ec-group-collaboration/SKILL.md +5 -5
  442. package/kits/skills/ec-identity/SKILL.md +9 -6
  443. package/kits/skills/ec-pay/SKILL.md +223 -0
  444. package/kits/skills/ec-provider/SKILL.md +6 -6
  445. package/kits/skills/{ec-service-proxy → ec-proxy}/SKILL.md +8 -5
  446. package/kits/skills/ec-service-call/SKILL.md +138 -0
  447. package/kits/skills/ec-service-pack/SKILL.md +277 -0
  448. package/kits/skills/ec-skill/SKILL.md +25 -9
  449. package/kits/skills/ec-skill/scripts/cli.mjs +7 -7
  450. package/kits/skills/ec-skill/scripts/skill.mjs +55 -41
  451. package/kits/skills/ec-skill/scripts/template/SKILL.md.tmpl +9 -0
  452. package/kits/skills/ec-trigger/SKILL.md +3 -3
  453. package/kits/skills/personal-assistant/SKILL.md +22 -22
  454. package/kits/skills/personal-assistant/references/03-data-flow-and-gaps.md +1 -1
  455. package/kits/skills/scrapling-article-fetch/SKILL.md +5 -5
  456. package/kits/skills/thread-ops/SKILL.md +19 -9
  457. package/kits/skills/wechat-article-media-download/SKILL.md +2 -2
  458. package/kits/skills/wechat-article-reader/SKILL.md +2 -2
  459. package/kits/templates/memory-consolidation/notes.md +2 -2
  460. package/kits/templates/memory-consolidation/workflow.md +46 -0
  461. package/kits/templates/system-fragments/channel.md +13 -4
  462. package/kits/templates/system-fragments/commands.md +5 -4
  463. package/kits/templates/system-fragments/personal-assistant.md +2 -2
  464. package/kits/templates/system-fragments/reply.md +15 -9
  465. package/kits/templates/system-fragments/session.md +2 -2
  466. package/kits/templates/system-fragments/thread.md +30 -127
  467. package/kits/templates/system-fragments/venue.md +16 -0
  468. package/package.json +7 -7
  469. package/scripts/agent-template/index.mjs +7 -1
  470. package/scripts/agent-template/inspect.mjs +99 -39
  471. package/scripts/agent-template/overlay.mjs +126 -2
  472. package/scripts/agent-template/shared/common.mjs +49 -5
  473. package/scripts/agent-template/shared/plan.mjs +4 -2
  474. package/scripts/agent-template/shared/service-packs.mjs +104 -0
  475. package/scripts/agent-template/shared/team-schema.json +468 -39
  476. package/scripts/agent-template/shared/template-contract.mjs +93 -51
  477. package/scripts/agent-template/shared/template-package.mjs +225 -44
  478. package/scripts/agent-template/shared/template-runtime.mjs +137 -15
  479. package/scripts/agent-template/shared/template.mjs +31 -8
  480. package/scripts/agent-template/team-pack.mjs +528 -56
  481. package/scripts/agent-template/team-preview.mjs +102 -9
  482. package/scripts/aid-batch/identity-batch.mjs +1 -1
  483. package/dist/agents/baseagent-availability.js +0 -152
  484. package/dist/agents/baseagent.js +0 -750
  485. package/dist/agents/codex/catalog.js +0 -80
  486. package/dist/agents/ecagent-plugin-lazy.js +0 -41
  487. package/dist/agents/tool-time-context.js +0 -55
  488. package/dist/core/legacy-rename.js +0 -41
  489. package/dist/core/plugin-lifecycle.js +0 -137
  490. package/dist/core/rate-window.js +0 -53
  491. package/dist/core/runner-reload-transaction.js +0 -60
  492. package/dist/core/runtime-lock.js +0 -90
  493. package/dist/core/soul.js +0 -66
  494. package/dist/core/system-session/grants.js +0 -40
  495. package/dist/directory/owner-directory-agentmd-sync.js +0 -89
  496. package/dist/directory/owner-directory-request-operation.js +0 -79
  497. package/dist/directory/owner-directory-text.js +0 -60
  498. package/kits/docs/aun/ABILITY_CALLING.md +0 -280
  499. package/kits/docs/evolcore/ability.md +0 -185
  500. package/kits/skills/ability/references/calling.md +0 -56
  501. package/kits/skills/ability/references/contract-checklist.md +0 -37
  502. package/kits/skills/ability/references/recovery.md +0 -27
  503. /package/dist/{core/capability/providers/gemini-capability-provider.js → agents/gemini/capability-provider.js} +0 -0
  504. /package/dist/core/{system-channels.js → channel/system-channels.js} +0 -0
  505. /package/dist/core/{daemon-file-cache.js → daemon/daemon-file-cache.js} +0 -0
  506. /package/dist/core/{event-bus.js → event/event-bus.js} +0 -0
  507. /package/dist/core/{event-catalog.js → event/event-catalog.js} +0 -0
  508. /package/dist/core/{pack-ledger.js → pack/pack-ledger.js} +0 -0
  509. /package/dist/directory/{owner-directory-identity.js → identity.js} +0 -0
  510. /package/dist/directory/{owner-directory-policy.js → policy.js} +0 -0
  511. /package/dist/directory/{owner-directory-remarks.js → remarks.js} +0 -0
  512. /package/dist/directory/{owner-directory-scope.js → scope.js} +0 -0
  513. /package/dist/{contracts → ecweb/contracts}/ecweb-instance.js +0 -0
  514. /package/kits/templates/{bootstrap-welcome.md → bootstrap-intro.md} +0 -0
@@ -0,0 +1,357 @@
1
+ /**
2
+ * Baseagent 插件描述符类型定义与校验函数
3
+ *
4
+ * 插件接入协议:
5
+ * - daemon.json.plugins 的 baseagent:<name> 是唯一声明入口
6
+ * - 自描述:通过 descriptor 声明身份、能力、环境支持
7
+ * - 运行固定入口:只注册声明对应的 src/dist/agents/<name>/index.ts/js
8
+ * - 安装扫描:可独立读取随包轻量描述符及依赖,不自动注册运行时
9
+ * - 环境匹配:未实测环境不启用
10
+ * - 失败隔离:单个插件失败不影响其他插件和 daemon 启动
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
+ }
23
+ // ============================================================================
24
+ // 常量
25
+ // ============================================================================
26
+ /** Host-owned levels; stable IDs are not renamed when a requirement is promoted. */
27
+ export const REQUIRED_B_CAPABILITIES = [
28
+ 'B01', 'B02', 'B03', 'B04', 'B05', 'B06', 'B07',
29
+ 'B08', 'B09', 'B10', 'B11', 'B13', 'B14',
30
+ 'C03', 'C05', 'C18', 'C19',
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
+ }
43
+ /** 插件名称格式正则(小写字母开头,可含数字和连字符,1-32 字符) */
44
+ export const PLUGIN_NAME_PATTERN = /^[a-z][a-z0-9-]{0,31}$/;
45
+ /**
46
+ * 校验插件描述符
47
+ *
48
+ * @param descriptor 插件描述符
49
+ * @param dirname 插件目录名
50
+ * @param builtinNames 内置 baseagent 名称集合
51
+ * @param builtinAliases 内置 baseagent 别名集合
52
+ * @returns 校验结果
53
+ */
54
+ export function validatePluginDescriptor(descriptor, dirname, builtinNames, builtinAliases, currentOS = process.platform, options = {}) {
55
+ const errors = [];
56
+ const warnings = [];
57
+ if (!isRecord(descriptor)) {
58
+ return { valid: false, errors: ['Descriptor must be an object'] };
59
+ }
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
+ }
69
+ // === 1. 基础字段校验 ===
70
+ if (!d.name || typeof d.name !== 'string') {
71
+ errors.push('Missing or invalid field: name');
72
+ }
73
+ else {
74
+ // 名称格式
75
+ if (!PLUGIN_NAME_PATTERN.test(d.name)) {
76
+ errors.push(`Invalid name format: ${d.name} (must match ${PLUGIN_NAME_PATTERN})`);
77
+ }
78
+ // 名称与目录名一致
79
+ if (d.name !== dirname) {
80
+ errors.push(`Name mismatch: descriptor.name="${d.name}" but directory="${dirname}"`);
81
+ }
82
+ // 与内置冲突
83
+ if (builtinNames.has(d.name)) {
84
+ errors.push(`Name conflicts with builtin baseagent: ${d.name}`);
85
+ }
86
+ }
87
+ if (typeof d.displayName !== 'string' || !d.displayName.trim()) {
88
+ errors.push('Missing or invalid field: displayName');
89
+ }
90
+ if (!Array.isArray(d.aliases)) {
91
+ errors.push('Missing or invalid field: aliases (must be array)');
92
+ }
93
+ else {
94
+ // 别名冲突检查
95
+ for (const alias of d.aliases) {
96
+ if (typeof alias !== 'string') {
97
+ errors.push(`Invalid alias: ${alias} (must be string)`);
98
+ continue;
99
+ }
100
+ const normalized = normalizeAlias(alias);
101
+ if (!normalized)
102
+ errors.push('Aliases must not be empty');
103
+ if (builtinNames.has(normalized) || builtinAliases.has(normalized)) {
104
+ errors.push(`Alias conflicts with builtin: ${alias}`);
105
+ }
106
+ }
107
+ }
108
+ if (!isRecord(d.configSchema)) {
109
+ errors.push('Missing or invalid field: configSchema');
110
+ }
111
+ else {
112
+ try {
113
+ compileConfigSchema(d.configSchema);
114
+ }
115
+ catch (error) {
116
+ errors.push(`Invalid configSchema: ${String(error)}`);
117
+ }
118
+ for (const field of ['apiKey', 'baseUrl', 'headers', 'queryParams']) {
119
+ if (isRecord(d.configSchema.properties) && Object.hasOwn(d.configSchema.properties, field)) {
120
+ errors.push(`configSchema.${field}: connection settings belong in providers.json`);
121
+ }
122
+ }
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
+ }
128
+ if (d.defaultModel !== undefined && (typeof d.defaultModel !== 'string' || !d.defaultModel.trim())) {
129
+ errors.push('defaultModel must be a non-empty string');
130
+ }
131
+ if (typeof d.probe !== 'function')
132
+ errors.push('B02: probe must be a function');
133
+ // === 2. 环境声明校验 ===
134
+ if (!Array.isArray(d.environments) || d.environments.length === 0) {
135
+ errors.push('environments must be non-empty array');
136
+ }
137
+ else {
138
+ for (const env of d.environments) {
139
+ if (!isRecord(env)) {
140
+ errors.push('Environment must be an object');
141
+ continue;
142
+ }
143
+ if (!env.os || !['linux', 'darwin', 'win32'].includes(env.os)) {
144
+ errors.push(`Invalid environment.os: ${env.os}`);
145
+ }
146
+ if (!isRecord(env.probedWith)) {
147
+ errors.push('environment.probedWith is required');
148
+ }
149
+ else if (typeof env.probedWith.at !== 'string'
150
+ || !/^\d{4}-\d\d-\d\dT/.test(env.probedWith.at) || !Number.isFinite(Date.parse(env.probedWith.at))) {
151
+ errors.push('environment.probedWith.at must be an ISO timestamp');
152
+ }
153
+ }
154
+ }
155
+ // === 3. 能力声明校验 ===
156
+ if (!Array.isArray(d.declaredCapabilities)) {
157
+ errors.push('declaredCapabilities must be array');
158
+ }
159
+ else {
160
+ const declaredIds = new Set();
161
+ for (const card of d.declaredCapabilities) {
162
+ if (!isRecord(card)) {
163
+ errors.push('Capability must be an object');
164
+ continue;
165
+ }
166
+ if (typeof card.id !== 'string' || !/^(?:[BCX]\d{2}|EXT-[a-z][a-z0-9-]*)$/.test(card.id)) {
167
+ errors.push('Invalid capability ID');
168
+ continue;
169
+ }
170
+ if (declaredIds.has(card.id))
171
+ errors.push(`Duplicate capability ID: ${card.id}`);
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];
180
+ if (!['B', 'C', 'X'].includes(card.level)
181
+ || (!card.id.startsWith('EXT-') && (level === undefined || (card.level !== level && !legacyLevel)))) {
182
+ errors.push(`Capability ${card.id}: level does not match ID`);
183
+ }
184
+ if (!['native', 'adapted', 'host-only', 'unsupported'].includes(card.implementation)) {
185
+ errors.push(`Capability ${card.id}: invalid implementation`);
186
+ }
187
+ for (const [environment, values] of Object.entries({ default: card, ...(card.environments ?? {}) })) {
188
+ if (!isRecord(values)) {
189
+ errors.push(`Capability ${card.id}: invalid environment override`);
190
+ continue;
191
+ }
192
+ if (values.availability !== undefined
193
+ && !['available', 'unavailable', 'unknown'].includes(values.availability)) {
194
+ errors.push(`Capability ${card.id}: invalid availability on ${environment}`);
195
+ }
196
+ if (values.verification !== undefined && !['verified', 'unverified'].includes(values.verification)) {
197
+ errors.push(`Capability ${card.id}: invalid verification on ${environment}`);
198
+ }
199
+ }
200
+ if (!['available', 'unavailable', 'unknown'].includes(card.availability)
201
+ || !['verified', 'unverified'].includes(card.verification)) {
202
+ errors.push(`Capability ${card.id}: availability and verification are required`);
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
+ }
219
+ }
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.
222
+ for (const cap of d.declaredCapabilities) {
223
+ if (!isRecord(cap))
224
+ continue;
225
+ // 解析当前环境的实际值
226
+ const envOverride = cap.environments?.[currentOS];
227
+ const actualAvailability = envOverride?.availability ?? cap.availability;
228
+ const actualVerification = envOverride?.verification ?? cap.verification;
229
+ const capabilityErrors = options.force && REQUIRED_B_CAPABILITIES.includes(cap.id) ? warnings : errors;
230
+ if (cap.implementation === 'unsupported' && actualAvailability === 'available') {
231
+ errors.push(`Capability ${cap.id}: unsupported implementation cannot be available`);
232
+ }
233
+ // 不允许:available + unverified
234
+ if (actualAvailability === 'available' && actualVerification === 'unverified') {
235
+ capabilityErrors.push(`Capability ${cap.id}: available but unverified on ${currentOS} ` +
236
+ `(must run probe script first)`);
237
+ }
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'));
242
+ }
243
+ }
244
+ }
245
+ // === 4. 工厂函数校验 ===
246
+ if (d.load !== undefined ? typeof d.load !== 'function' : typeof d.createRunner !== 'function') {
247
+ errors.push('load or createRunner must be a function');
248
+ }
249
+ if (d.createSessionAdapter !== undefined && typeof d.createSessionAdapter !== 'function') {
250
+ errors.push('createSessionAdapter must be a function or undefined');
251
+ }
252
+ if (d.createCapabilityProvider !== undefined && typeof d.createCapabilityProvider !== 'function') {
253
+ errors.push('createCapabilityProvider must be a function or undefined');
254
+ }
255
+ return {
256
+ valid: errors.length === 0,
257
+ errors,
258
+ ...(warnings.length ? { warnings } : {}),
259
+ };
260
+ }
261
+ /**
262
+ * 检查当前环境是否在插件的支持列表中
263
+ *
264
+ * @param descriptor 插件描述符
265
+ * @returns 是否支持当前环境
266
+ */
267
+ export function isCurrentEnvironmentSupported(descriptor) {
268
+ const currentOS = process.platform;
269
+ return descriptor.environments.some((env) => env.os === currentOS);
270
+ }
271
+ /**
272
+ * 获取已实测的操作系统列表(用于日志)
273
+ *
274
+ * @param descriptor 插件描述符
275
+ * @returns 操作系统列表字符串
276
+ */
277
+ export function getTestedEnvironments(descriptor) {
278
+ return descriptor.environments.map((env) => env.os).join(', ');
279
+ }
280
+ function isRecord(value) {
281
+ return !!value && typeof value === 'object' && !Array.isArray(value);
282
+ }
283
+ function normalizeAlias(value) {
284
+ return value.trim().toLowerCase().replace(/_/g, '-');
285
+ }
286
+ const requireDependency = createRequire(import.meta.url);
287
+ let schemaCompiler;
288
+ function compileConfigSchema(schema) {
289
+ const Constructor = requireDependency('ajv');
290
+ schemaCompiler ??= new Constructor({ strict: false, allErrors: true, useDefaults: false });
291
+ return schemaCompiler.compile(schema);
292
+ }
293
+ const descriptors = new Map();
294
+ /** Metadata is available before Agent configs are loaded; registration does not start a runner. */
295
+ export function registerBaseagentPluginDescriptor(descriptor, options = {}) {
296
+ const previous = descriptors.get(descriptor.name);
297
+ const entry = { descriptor, validate: compileConfigSchema(descriptor.configSchema), force: options.force === true };
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 ?? [])] });
302
+ return () => {
303
+ if (descriptors.get(descriptor.name) !== entry)
304
+ return;
305
+ if (previous)
306
+ descriptors.set(descriptor.name, previous);
307
+ else
308
+ descriptors.delete(descriptor.name);
309
+ undoMetadata();
310
+ };
311
+ }
312
+ export function getBaseagentPluginDescriptor(name) {
313
+ return descriptors.get(name)?.descriptor;
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
+ }
319
+ export function validateBaseagentPluginConfigs(blocks, defaults = false) {
320
+ if (!isRecord(blocks))
321
+ return [];
322
+ const errors = [];
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
+ }
327
+ const entry = descriptors.get(name);
328
+ if (!entry)
329
+ continue;
330
+ if (isRecord(raw)) {
331
+ for (const field of ['apiKey', 'baseUrl', 'headers', 'queryParams']) {
332
+ if (Object.hasOwn(raw, field))
333
+ errors.push(`/baseagents/${name}/${field}: use providers.json`);
334
+ }
335
+ }
336
+ if (!entry.validate(raw)) {
337
+ errors.push(...(entry.validate.errors ?? []).map(error => `/baseagents/${name}${error.instancePath} ${error.message}`));
338
+ }
339
+ }
340
+ return errors;
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
+ }