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,367 @@
1
+ /** Package-owned metadata discovery, followed by atomic runtime component registration. */
2
+ import fs from 'node:fs';
3
+ import path from 'node:path';
4
+ import { fileURLToPath } from 'node:url';
5
+ import { registerCapabilityProvider } from '../capability/capability-manager.js';
6
+ import { getPackageRoot } from '../../paths.js';
7
+ import { logger } from '../../utils/logger.js';
8
+ import { baseagentDeclarations, baseagentPluginEntry, recordRuntimePlugin, runtimeBaseagentForceLoad, pluginRuntimeReason } from '../plugin/plugin-lifecycle.js';
9
+ import { registerExternalBaseagentAliases, reservedBaseagentAliases, } from './baseagent-identity.js';
10
+ import { validatePluginDescriptor, isCurrentEnvironmentSupported, getTestedEnvironments, getBaseagentPluginDescriptor, registerBaseagentPluginDescriptor, recordBaseagentPluginStatus, getBaseagentPluginStatuses, isBaseagentPluginForced, } from './baseagent-plugin-descriptor.js';
11
+ /** Inventory only: inspect shipped metadata without declarations, admission or runtime registration. */
12
+ export async function scanBaseagentInstallations() {
13
+ const root = getPackageRoot();
14
+ const source = path.extname(fileURLToPath(import.meta.url)) === '.ts';
15
+ const directory = path.join(root, source ? 'src' : 'dist', 'agents');
16
+ let names;
17
+ try {
18
+ names = fs.readdirSync(directory, { withFileTypes: true });
19
+ }
20
+ catch (error) {
21
+ if (error.code === 'ENOENT')
22
+ return [];
23
+ throw error;
24
+ }
25
+ const entries = names
26
+ .filter(entry => entry.isDirectory() && /^[a-z][a-z0-9-]{0,31}$/.test(entry.name)
27
+ && fs.existsSync(path.join(directory, entry.name, source ? 'index.ts' : 'index.js')))
28
+ .sort((a, b) => a.name.localeCompare(b.name));
29
+ return Promise.all(entries.map(async (entry) => {
30
+ const result = { id: entry.name, label: entry.name, installed: false, compatible: false };
31
+ try {
32
+ const descriptor = getBaseagentPluginDescriptor(entry.name)
33
+ ?? (await import(baseagentPluginEntry(root, entry.name, import.meta.url))).default;
34
+ // Inspect structural metadata even when mandatory behavior has not been
35
+ // admitted. This does not apply force policy or publish a runtime entry.
36
+ const validation = validatePluginDescriptor(descriptor, entry.name, new Set(), reservedBaseagentAliases(entry.name), process.platform, { force: true });
37
+ if (!validation.valid)
38
+ throw new Error(validation.errors.join('; '));
39
+ result.label = descriptor.displayName;
40
+ const probe = descriptor.probe();
41
+ result.installed = probe.installed ?? (probe.available || !!probe.version);
42
+ result.compatible = (probe.compatible ?? probe.available) && isCurrentEnvironmentSupported(descriptor);
43
+ result.version = probe.version;
44
+ result.installationPath = probe.installationPath;
45
+ result.reason = !probe.available ? probe.reason ?? '基座依赖不可用'
46
+ : !result.compatible ? '基座尚未验证当前操作系统' : undefined;
47
+ }
48
+ catch (error) {
49
+ result.reason = error instanceof Error ? error.message : String(error);
50
+ }
51
+ return result;
52
+ }));
53
+ }
54
+ /** Discover metadata before loading Agent configs. This never calls component factories. */
55
+ export async function discoverBaseagentPlugins(options = {}) {
56
+ const packageRoot = getPackageRoot();
57
+ const descriptors = [];
58
+ const warn = (...args) => {
59
+ if (options.quiet)
60
+ logger.debug(...args);
61
+ else
62
+ logger.warn(...args);
63
+ };
64
+ let entries;
65
+ let flags;
66
+ try {
67
+ flags = baseagentDeclarations();
68
+ entries = Object.keys(flags).sort().map(name => ({ name, url: baseagentPluginEntry(packageRoot, name, import.meta.url) }));
69
+ }
70
+ catch (error) {
71
+ logger.error('[BaseagentPlugins] Cannot discover package plugins:', error);
72
+ return descriptors;
73
+ }
74
+ for (const entry of entries) {
75
+ const enabled = flags[entry.name]?.enabled;
76
+ const status = { baseagent: entry.name, discovered: true, enabled: enabled !== false, registered: false };
77
+ const force = flags[entry.name]?.force === true;
78
+ recordRuntimePlugin({ kind: 'baseagent', name: entry.name, displayName: entry.name, apiVersion: 0,
79
+ version: '0.0.0', hostApi: 'unknown', state: 'discovered', force });
80
+ if (typeof enabled !== 'boolean' || (flags[entry.name]?.force !== undefined && typeof flags[entry.name].force !== 'boolean')) {
81
+ recordBaseagentPluginStatus({ ...status, enabled: false, status: 'failed',
82
+ reason: pluginRuntimeReason('INVALID_CONFIG', 'configuration', '插件启用开关必须是布尔值') });
83
+ try {
84
+ const undo = registerExternalBaseagentAliases(entry.name, entry.name, []);
85
+ options.lifecycle?.defer(undo, `baseagent identity:${entry.name}`);
86
+ }
87
+ catch (error) {
88
+ logger.warn('[BaseagentPlugins] Cannot reserve disabled plugin identity:', error);
89
+ }
90
+ logger.warn('[BaseagentPlugins] Invalid enabled flag: ' + entry.name);
91
+ continue;
92
+ }
93
+ if (enabled === false) {
94
+ recordBaseagentPluginStatus({ ...status, status: 'disabled',
95
+ reason: pluginRuntimeReason('CONFIG_DISABLED', 'configuration', '基座插件已禁用') });
96
+ try {
97
+ const undo = registerExternalBaseagentAliases(entry.name, entry.name, []);
98
+ options.lifecycle?.defer(undo, `baseagent identity:${entry.name}`);
99
+ }
100
+ catch (error) {
101
+ logger.warn('[BaseagentPlugins] Cannot reserve disabled plugin identity:', error);
102
+ }
103
+ if (!options.quiet)
104
+ logger.info('Skipping disabled plugin: ' + entry.name);
105
+ continue;
106
+ }
107
+ let undoAliases;
108
+ let undoDescriptor;
109
+ try {
110
+ // Retain config identity even when this implementation cannot load here.
111
+ const undoIdentity = registerExternalBaseagentAliases(entry.name, entry.name, []);
112
+ options.lifecycle?.defer(() => {
113
+ undoDescriptor?.();
114
+ undoAliases?.();
115
+ undoIdentity();
116
+ }, `baseagent metadata:${entry.name}`);
117
+ const descriptor = (await import(entry.url)).default;
118
+ const validation = validatePluginDescriptor(descriptor, entry.name, new Set(), reservedBaseagentAliases(entry.name), process.platform, { force });
119
+ if (!validation.valid) {
120
+ recordBaseagentPluginStatus({ ...status, status: 'failed',
121
+ reason: pluginRuntimeReason('INVALID_DESCRIPTOR', 'discovery', '基座插件描述无效', entry.url + ': ' + validation.errors.join('; ')) });
122
+ warn('[BaseagentPlugins] ' + entry.name + ': validation failed (' + entry.url + ')', validation.errors);
123
+ continue;
124
+ }
125
+ if (!isCurrentEnvironmentSupported(descriptor)) {
126
+ recordBaseagentPluginStatus({ ...status, status: 'unavailable',
127
+ reason: pluginRuntimeReason('ENVIRONMENT_UNSUPPORTED', 'probe', '基座插件尚未验证当前操作系统') });
128
+ if (!options.quiet)
129
+ logger.info('Plugin ' + entry.name + ': environment not supported '
130
+ + '(current: ' + process.platform + ', tested: ' + getTestedEnvironments(descriptor) + ')');
131
+ continue;
132
+ }
133
+ undoAliases = registerExternalBaseagentAliases(descriptor.name, descriptor.displayName, descriptor.aliases);
134
+ if (validation.warnings?.length)
135
+ warn('[BaseagentPlugins] Force-loading ' + entry.name + ':', validation.warnings);
136
+ undoDescriptor = registerBaseagentPluginDescriptor(descriptor, { force, warnings: validation.warnings });
137
+ recordBaseagentPluginStatus({ ...status, status: 'discovered' });
138
+ descriptors.push(descriptor);
139
+ }
140
+ catch (error) {
141
+ undoAliases?.();
142
+ undoAliases = undefined;
143
+ recordBaseagentPluginStatus({ ...status, status: 'failed',
144
+ reason: pluginRuntimeReason('LOAD_FAILED', 'load', '基座插件发现失败', error) });
145
+ logger.error('[BaseagentPlugins] Cannot discover ' + entry.name + ' (' + entry.url + '):', error);
146
+ }
147
+ }
148
+ return descriptors;
149
+ }
150
+ /** All factories finish before anything is published. Metadata remains known if a runtime factory fails. */
151
+ export async function loadExternalBaseagentPlugins(agentLoader, sessionManager, descriptors, lifecycle) {
152
+ let loaded = 0;
153
+ for (const descriptor of descriptors ?? await discoverBaseagentPlugins({ lifecycle })) {
154
+ if (baseagentDeclarations()[descriptor.name]?.enabled !== true)
155
+ continue;
156
+ const undo = [];
157
+ let sessionAdapter;
158
+ try {
159
+ // Caller-supplied descriptors must pass the same admission as discovered ones.
160
+ const force = getBaseagentPluginDescriptor(descriptor.name)
161
+ ? isBaseagentPluginForced(descriptor.name) : await runtimeBaseagentForceLoad(descriptor.name);
162
+ const validation = validatePluginDescriptor(descriptor, descriptor.name, new Set(), reservedBaseagentAliases(descriptor.name), process.platform, { force });
163
+ if (!validation.valid)
164
+ throw new Error(validation.errors.join('; '));
165
+ if (!isCurrentEnvironmentSupported(descriptor))
166
+ throw new Error('Plugin environment is not supported');
167
+ if (!getBaseagentPluginDescriptor(descriptor.name)) {
168
+ const undoAliases = registerExternalBaseagentAliases(descriptor.name, descriptor.displayName, descriptor.aliases);
169
+ if (validation.warnings?.length)
170
+ logger.warn('[BaseagentPlugins] Force-loading ' + descriptor.name + ':', validation.warnings);
171
+ const undoDescriptor = registerBaseagentPluginDescriptor(descriptor, { force, warnings: validation.warnings });
172
+ lifecycle?.defer(() => { undoDescriptor(); undoAliases(); }, `baseagent metadata:${descriptor.name}`);
173
+ }
174
+ lifecycle?.assertActive();
175
+ if (descriptor.load) {
176
+ const stop = registerLazyBaseagent(descriptor, agentLoader, sessionManager, lifecycle);
177
+ lifecycle?.defer(stop, `baseagent lazy:${descriptor.name}`);
178
+ loaded++;
179
+ recordBaseagentPluginStatus({ baseagent: descriptor.name, status: 'loaded', discovered: true, enabled: true, registered: true });
180
+ continue;
181
+ }
182
+ const runner = descriptor.createRunner();
183
+ if (!runner || runner.name !== descriptor.name
184
+ || typeof runner.isEnabled !== 'function' || typeof runner.createAgent !== 'function') {
185
+ throw new Error('Runner factory returned an invalid identity or interface');
186
+ }
187
+ sessionAdapter = descriptor.createSessionAdapter?.();
188
+ if (descriptor.createSessionAdapter)
189
+ validateComponent(sessionAdapter, descriptor.name, ['checkExists', 'getFileInfo', 'readFirstMessage', 'readLastUserMessage', 'scanCliSessions']);
190
+ const provider = descriptor.createCapabilityProvider?.();
191
+ if (descriptor.createCapabilityProvider)
192
+ validateComponent(provider, descriptor.name, ['getSupport', 'discover']);
193
+ const keepUndo = (value) => { if (typeof value === 'function')
194
+ undo.push(value); };
195
+ keepUndo(agentLoader.register({
196
+ name: runner.name,
197
+ isEnabled: agent => runner.isEnabled(agent),
198
+ createAgent: async (agent, callbacks, scope) => {
199
+ const probe = descriptor.probe();
200
+ if (!probe.available) {
201
+ recordBaseagentPluginStatus({ baseagent: descriptor.name, status: 'unavailable', discovered: true,
202
+ enabled: true, registered: true, reason: pluginRuntimeReason('DEPENDENCY_MISSING', 'probe', '基座本地依赖不可用', probe.reason) });
203
+ throw new Error(probe.reason ?? 'Baseagent dependency unavailable');
204
+ }
205
+ const instance = await runner.createAgent(agent, callbacks, scope);
206
+ if (instance)
207
+ recordBaseagentPluginStatus({ baseagent: descriptor.name, status: 'loaded', discovered: true, enabled: true, registered: true });
208
+ return instance;
209
+ },
210
+ }));
211
+ if (sessionAdapter)
212
+ keepUndo(sessionManager.registerFileAdapter(sessionAdapter));
213
+ if (provider)
214
+ keepUndo(registerCapabilityProvider(provider));
215
+ lifecycle?.defer(async () => {
216
+ const errors = [];
217
+ for (const unregister of [...undo].reverse()) {
218
+ try {
219
+ unregister();
220
+ }
221
+ catch (error) {
222
+ errors.push(error);
223
+ }
224
+ }
225
+ try {
226
+ await sessionAdapter?.close?.();
227
+ }
228
+ catch (error) {
229
+ errors.push(error);
230
+ }
231
+ recordBaseagentPluginStatus({ baseagent: descriptor.name, status: 'discovered',
232
+ discovered: true, enabled: true, registered: false });
233
+ if (errors.length)
234
+ throw new AggregateError(errors, `Baseagent ${descriptor.name} registration cleanup failed`);
235
+ }, `baseagent components:${descriptor.name}`);
236
+ recordBaseagentPluginStatus({ baseagent: descriptor.name, status: 'loaded',
237
+ discovered: true, enabled: true, registered: true });
238
+ loaded++;
239
+ logger.info('Loaded baseagent plugin: ' + descriptor.name + ' (' + descriptor.displayName + ')');
240
+ }
241
+ catch (error) {
242
+ for (const rollback of undo.reverse()) {
243
+ try {
244
+ rollback();
245
+ }
246
+ catch (failure) {
247
+ logger.error('[BaseagentPlugins] Rollback failed:', failure);
248
+ }
249
+ }
250
+ try {
251
+ await sessionAdapter?.close?.();
252
+ }
253
+ catch (failure) {
254
+ logger.warn('[BaseagentPlugins] Cleanup failed:', failure);
255
+ }
256
+ if (!getBaseagentPluginStatuses().some(status => status.baseagent === descriptor.name && status.registered)) {
257
+ recordBaseagentPluginStatus({ baseagent: descriptor.name, status: 'failed', discovered: true, enabled: true,
258
+ registered: false, reason: pluginRuntimeReason('REGISTER_FAILED', 'register', '基座组件注册失败', error) });
259
+ }
260
+ logger.error('[BaseagentPlugins] Cannot register ' + descriptor.name + ':', error);
261
+ }
262
+ }
263
+ return loaded;
264
+ }
265
+ function registerLazyBaseagent(descriptor, agentLoader, sessionManager, lifecycle) {
266
+ let pending;
267
+ let adapter;
268
+ let stopped = false;
269
+ const undo = [];
270
+ const load = () => pending ??= (async () => {
271
+ const module = await descriptor.load();
272
+ if (stopped || lifecycle?.signal.aborted)
273
+ throw new Error('Plugin registration has been disposed');
274
+ if (typeof module.createAgent !== 'function')
275
+ throw new Error('Versioned plugin requires createAgent(context)');
276
+ try {
277
+ adapter = module.createSessionAdapter?.();
278
+ if (module.createSessionAdapter)
279
+ validateComponent(adapter, descriptor.name, ['checkExists', 'getFileInfo', 'readFirstMessage', 'readLastUserMessage', 'scanCliSessions']);
280
+ if (adapter) {
281
+ undo.push(sessionManager.registerFileAdapter(adapter));
282
+ }
283
+ const provider = module.createCapabilityProvider?.();
284
+ if (module.createCapabilityProvider)
285
+ validateComponent(provider, descriptor.name, ['getSupport', 'discover']);
286
+ if (provider) {
287
+ undo.push(registerCapabilityProvider(provider));
288
+ }
289
+ return module;
290
+ }
291
+ catch (error) {
292
+ for (const release of undo.splice(0).reverse()) {
293
+ try {
294
+ release();
295
+ }
296
+ catch (failure) {
297
+ logger.error('[BaseagentPlugins] Rollback failed:', failure);
298
+ }
299
+ }
300
+ try {
301
+ await adapter?.close?.();
302
+ }
303
+ catch (failure) {
304
+ logger.warn('[BaseagentPlugins] Cleanup failed:', failure);
305
+ }
306
+ adapter = undefined;
307
+ throw error;
308
+ }
309
+ })().catch(error => {
310
+ recordBaseagentPluginStatus({ baseagent: descriptor.name, status: 'failed', discovered: true, enabled: true,
311
+ registered: false, reason: pluginRuntimeReason('LOAD_FAILED', 'load', '基座运行实现加载失败', error) });
312
+ throw error;
313
+ });
314
+ const releaseRunner = agentLoader.register({ name: descriptor.name,
315
+ isEnabled: agent => !!agent.config.baseagents?.[descriptor.name] && !stopped,
316
+ createAgent: async (agent, callbacks, scope) => {
317
+ if (!scope)
318
+ throw new Error('Plugin creation requires a resource scope');
319
+ const probe = descriptor.probe();
320
+ if (!probe.available) {
321
+ recordBaseagentPluginStatus({ baseagent: descriptor.name, status: 'unavailable', discovered: true, enabled: true,
322
+ registered: true, reason: pluginRuntimeReason('DEPENDENCY_MISSING', 'probe', '基座本地依赖不可用', probe.reason) });
323
+ throw new Error(probe.reason ?? 'Baseagent dependency probe failed');
324
+ }
325
+ const module = await load();
326
+ scope.assertActive();
327
+ const { resolveProviderServiceForBaseagent } = await import('../../config/providers.js');
328
+ const runner = await module.createAgent(Object.freeze({ apiVersion: 1, aid: agent.aid,
329
+ projectPath: agent.projectPath, config: Object.freeze(structuredClone(agent.config.baseagents?.[descriptor.name] ?? {})),
330
+ lifecycle: scope, signal: scope.signal, onSessionIdUpdate: callbacks.onSessionIdUpdate,
331
+ resolveProvider: (id) => resolveProviderServiceForBaseagent(id, descriptor.name) }));
332
+ recordBaseagentPluginStatus({ baseagent: descriptor.name, status: 'loaded', discovered: true, enabled: true, registered: true });
333
+ return runner ? { evolagentName: agent.aid, baseagent: descriptor.name, agent: runner } : null;
334
+ } });
335
+ return async () => {
336
+ if (stopped)
337
+ return;
338
+ stopped = true;
339
+ releaseRunner();
340
+ try {
341
+ await pending;
342
+ }
343
+ catch { /* Failed loads already rolled back. */ }
344
+ const errors = [];
345
+ for (const release of undo.splice(0).reverse()) {
346
+ try {
347
+ release();
348
+ }
349
+ catch (error) {
350
+ errors.push(error);
351
+ }
352
+ }
353
+ try {
354
+ await adapter?.close?.();
355
+ }
356
+ catch (error) {
357
+ errors.push(error);
358
+ }
359
+ if (errors.length)
360
+ throw new AggregateError(errors, `Baseagent ${descriptor.name} cleanup failed`);
361
+ };
362
+ }
363
+ function validateComponent(value, name, methods) {
364
+ if (!value || value.baseagent !== name || methods.some(method => typeof value[method] !== 'function')) {
365
+ throw new Error('Component factory returned an invalid identity or interface: ' + name);
366
+ }
367
+ }
@@ -0,0 +1,157 @@
1
+ /** Shared model selection and repair dispatch, with compatibility exports for old import paths. */
2
+ import { errorQuestionRule } from '../../utils/error-utils.js';
3
+ import { getBaseagentPluginDescriptor } from './baseagent-plugin-descriptor.js';
4
+ import { normalizeBaseagent, BUILTIN_BASEAGENT_NAMES } from './baseagent-identity.js';
5
+ import { resolveAnthropicConfig, resolveClaudeLegacyModelSelection } from '../../agents/claude/index.js';
6
+ import { codexDefaultModelKey, discoverCodexDefaultModel, resolveOpenaiConfig, resolveCodexLegacyModelSelection } from '../../agents/codex/index.js';
7
+ import { resolveGeminiConnectionForRepair, DEFAULT_GEMINI_MODEL } from '../../agents/gemini/index.js';
8
+ import { discoverEcagentDefaultModel, ecagentDefaultModelKey, resolveEcagentConfig, DEFAULT_ECAGENT_MODEL } from '../../agents/ecagent/index.js';
9
+ import { NativeConnectionIncompleteError, nonEmptyString } from './baseagent-config-shared.js';
10
+ import { discoverRuntimeBaseagentModelDefault, getRuntimeBaseagentModelDefault } from './baseagent-model-defaults.js';
11
+ export * from './baseagent-identity.js';
12
+ export { clearRuntimeBaseagentModelDefaults } from './baseagent-model-defaults.js';
13
+ export { DEFAULT_CLAUDE_MODEL, resolveAnthropicConfig, resolveAnthropicDirectConfig } from '../../agents/claude/index.js';
14
+ export { DEFAULT_CODEX_MODEL, loadCodexSettings, resolveOpenaiConfig, resolveOpenaiDirectConfig } from '../../agents/codex/index.js';
15
+ export * from '../../agents/codex/cli.js';
16
+ export { DEFAULT_GEMINI_MODEL, resolveGoogleConfig } from '../../agents/gemini/index.js';
17
+ export { DEFAULT_ECAGENT_BASE_URL, DEFAULT_ECAGENT_MODEL, DEFAULT_ECAGENT_TIMEOUT_MS, DEFAULT_ECAGENT_MAX_RETRIES, DEFAULT_ECAGENT_MAX_RETRY_DELAY_MS, resolveEcagentConfig } from '../../agents/ecagent/index.js';
18
+ /** Only an explicitly declared native-selection mode may defer model discovery to its Runner. */
19
+ export function usesNativeModelSelection(baseagent, configured) {
20
+ const descriptor = getBaseagentPluginDescriptor(normalizeBaseagent(baseagent).canonical);
21
+ return descriptor?.usesNativeModelSelection?.((configured ?? {})) === true;
22
+ }
23
+ function defaultModelUnavailable(baseagent) {
24
+ const message = baseagent === 'ecagent'
25
+ ? 'ecagent 未配置模型,当前 Provider 目录中没有可用的 deepseek[*]flash;请配置 baseagents.ecagent.model'
26
+ : 'Codex 未配置模型,app-server 目录中没有可用的 gpt[*]terra;请配置 baseagents.codex.model 或 config.toml.model';
27
+ return Object.assign(new Error(message), {
28
+ code: baseagent === 'ecagent' ? 'ECAGENT_MODEL_UNAVAILABLE' : 'CODEX_MODEL_UNAVAILABLE',
29
+ });
30
+ }
31
+ function defaultModelConnectionKey(baseagent, configured) {
32
+ if (baseagent === 'codex')
33
+ return codexDefaultModelKey(configured);
34
+ if (baseagent === 'ecagent')
35
+ return ecagentDefaultModelKey(configured);
36
+ return undefined;
37
+ }
38
+ function discoveredDefaultModel(baseagent, configured) {
39
+ const key = defaultModelConnectionKey(baseagent, configured);
40
+ return key === undefined ? undefined : getRuntimeBaseagentModelDefault(key);
41
+ }
42
+ function resolveLocalBaseagentModelSelection(baseagent, options) {
43
+ switch (baseagent) {
44
+ case 'claude': return resolveClaudeLegacyModelSelection(options);
45
+ case 'codex': return resolveCodexLegacyModelSelection(options);
46
+ case 'gemini': return { model: DEFAULT_GEMINI_MODEL };
47
+ case 'ecagent': return { model: DEFAULT_ECAGENT_MODEL };
48
+ default: return undefined;
49
+ }
50
+ }
51
+ /** Read the historical runner selection for the one-time schema migration. */
52
+ export function resolveLegacyBaseagentModelSelection(baseagent, options = {}) {
53
+ const local = resolveLocalBaseagentModelSelection(normalizeBaseagent(baseagent).canonical, options);
54
+ if (!local)
55
+ return undefined;
56
+ return {
57
+ model: local.model,
58
+ ...(local.effort ? { effort: local.effort } : {}),
59
+ source: local.modelPath ?? local.effortPath ?? 'runner-default',
60
+ };
61
+ }
62
+ /** Resolve runtime model/effort without persisting fallback values. */
63
+ export function resolveBaseagentModelSelection(baseagent, configured, options = {}) {
64
+ const identity = normalizeBaseagent(baseagent).canonical;
65
+ if (!BUILTIN_BASEAGENT_NAMES.has(identity)) {
66
+ const descriptor = getBaseagentPluginDescriptor(identity);
67
+ if (!descriptor)
68
+ return undefined;
69
+ if (usesNativeModelSelection(identity, configured))
70
+ return undefined;
71
+ const configuredModel = nonEmptyString(configured?.model);
72
+ const model = configuredModel ?? descriptor.defaultModel;
73
+ if (!model)
74
+ return undefined;
75
+ const effort = nonEmptyString(configured?.effort);
76
+ return { model, modelSource: configuredModel ? 'configured' : 'runner',
77
+ ...(effort ? { effort, effortSource: 'configured' } : {}) };
78
+ }
79
+ const local = resolveLocalBaseagentModelSelection(identity, options);
80
+ if (!local)
81
+ return undefined;
82
+ const configuredModel = nonEmptyString(configured?.model);
83
+ const configuredEffort = nonEmptyString(configured?.effort)
84
+ ?? (identity === 'codex' ? nonEmptyString(configured?.reasoning) : undefined);
85
+ const effort = configuredEffort ?? local.effort;
86
+ // Historical constants remain confined to migration. Runtime defaults for
87
+ // these backends must come from the current connection's actual catalog.
88
+ const model = configuredModel ?? (identity === 'ecagent' || (identity === 'codex' && !local.modelPath)
89
+ ? discoveredDefaultModel(identity, configured)
90
+ : local.model);
91
+ if (!model)
92
+ return undefined;
93
+ return {
94
+ model,
95
+ ...(effort ? { effort } : {}),
96
+ modelSource: configuredModel ? 'configured' : local.modelPath ? 'cli' : 'runner',
97
+ ...(configuredEffort
98
+ ? { effortSource: 'configured' }
99
+ : local.effort ? { effortSource: 'cli' } : {}),
100
+ };
101
+ }
102
+ /** Resolve missing runtime defaults once per connection, sharing concurrent discovery. */
103
+ export async function resolveRuntimeBaseagentModelSelection(baseagent, configured) {
104
+ const selection = resolveBaseagentModelSelection(baseagent, configured);
105
+ if (selection)
106
+ return selection;
107
+ const canonical = normalizeBaseagent(baseagent).canonical;
108
+ if (canonical !== 'ecagent' && canonical !== 'codex')
109
+ return undefined;
110
+ const key = defaultModelConnectionKey(canonical, configured);
111
+ if (key === undefined)
112
+ throw defaultModelUnavailable(canonical);
113
+ await discoverRuntimeBaseagentModelDefault(key, async () => {
114
+ try {
115
+ const model = canonical === 'ecagent'
116
+ ? await discoverEcagentDefaultModel(configured)
117
+ : await discoverCodexDefaultModel(configured);
118
+ if (model)
119
+ return model;
120
+ }
121
+ catch (error) {
122
+ // Provider and app-server payloads may contain credentials or local paths.
123
+ const rule = errorQuestionRule(error);
124
+ if (rule)
125
+ throw Object.assign(new Error(rule.message ?? '模型连接需要补充信息'), {
126
+ code: rule.question?.fields.includes('baseUrl') ? 'PROVIDER_BASE_URL_MISSING' : 'PROVIDER_CREDENTIAL_INVALID',
127
+ });
128
+ }
129
+ throw defaultModelUnavailable(canonical);
130
+ });
131
+ const resolved = resolveBaseagentModelSelection(canonical, configured);
132
+ // A Provider may have changed while its catalog was in flight. Do not apply
133
+ // that older connection's model to the new configuration.
134
+ if (!resolved)
135
+ throw defaultModelUnavailable(canonical);
136
+ return resolved;
137
+ }
138
+ /** Resolve exactly the same native credential precedence as the runner, without model discovery. */
139
+ export function resolveNativeConnectionForRepair(baseagent, configured, runtime) {
140
+ const override = { ...configured, model: '<connection-repair>' };
141
+ try {
142
+ if (baseagent === 'claude')
143
+ return resolveAnthropicConfig({ agents: {} }, override, runtime);
144
+ if (baseagent === 'codex')
145
+ return resolveOpenaiConfig({ agents: {} }, override);
146
+ if (baseagent === 'ecagent')
147
+ return resolveEcagentConfig({ agents: {} }, override);
148
+ if (baseagent === 'gemini')
149
+ return resolveGeminiConnectionForRepair(override);
150
+ }
151
+ catch (error) {
152
+ if (error instanceof NativeConnectionIncompleteError)
153
+ return error.connection;
154
+ throw error;
155
+ }
156
+ return undefined;
157
+ }
@@ -1,4 +1,4 @@
1
- import { parseModelId, stripContextWindowSuffix } from '../core/model/context-window-suffix.js';
1
+ import { parseModelId, stripContextWindowSuffix } from '../model/context-window-suffix.js';
2
2
  export const BASEAGENT_RUNNER_UNAVAILABLE = 'BASEAGENT_RUNNER_UNAVAILABLE';
3
3
  export class BaseagentRunnerUnavailableError extends Error {
4
4
  evolagentName;
@@ -57,6 +57,41 @@ export function parseAsyncUserQuestions(value) {
57
57
  };
58
58
  });
59
59
  }
60
+ /** C12 controls exposed by the current bundled transports, independent of model effort. */
61
+ export const BASEAGENT_INFERENCE_PARAMETERS = {
62
+ claude: ['maxOutputTokens'],
63
+ codex: [],
64
+ dsh: ['maxOutputTokens', 'temperature', 'stop'],
65
+ ecagent: ['maxOutputTokens', 'temperature', 'topP', 'stop'],
66
+ };
67
+ /** Validate before accepting input. Never silently drop a supplied control. */
68
+ export function resolveRunInference(baseagent, value) {
69
+ const invalid = (parameter) => Object.assign(new Error(`BASEAGENT_INFERENCE_INVALID: ${baseagent} invalid inference parameter (C12): ${parameter}`), { code: 'BASEAGENT_INFERENCE_INVALID', capability: 'C12', parameter });
70
+ if (value === undefined)
71
+ return {};
72
+ if (!value || typeof value !== 'object' || Array.isArray(value)) {
73
+ throw invalid('inference (expected an object)');
74
+ }
75
+ const result = {};
76
+ for (const [key, item] of Object.entries(value)) {
77
+ if (item === undefined)
78
+ continue;
79
+ if (!BASEAGENT_INFERENCE_PARAMETERS[baseagent].includes(key)) {
80
+ throw Object.assign(new Error(`Baseagent ${baseagent} does not support C12 inference parameter: ${key}`), { code: 'BASEAGENT_CAPABILITY_UNSUPPORTED', capability: 'C12', parameter: key });
81
+ }
82
+ const maximum = baseagent === 'claude' ? 64000 : 256000;
83
+ const valid = key === 'maxOutputTokens'
84
+ ? typeof item === 'number' && Number.isSafeInteger(item) && item >= 1 && item <= maximum
85
+ : key === 'temperature' || key === 'topP'
86
+ ? typeof item === 'number' && Number.isFinite(item) && item >= 0 && item <= (key === 'topP' ? 1 : 2)
87
+ : key === 'stop' && Array.isArray(item) && item.length <= 16
88
+ && item.every(stop => typeof stop === 'string' && stop.length > 0 && stop.length <= 1024);
89
+ if (!valid)
90
+ throw invalid(key);
91
+ Object.assign(result, { [key]: Array.isArray(item) ? [...item] : item });
92
+ }
93
+ return result;
94
+ }
60
95
  export function hasTrustedFullAccessContext(context) {
61
96
  const authorization = context?.executionPermission;
62
97
  if (!authorization
@@ -116,9 +151,6 @@ export function hasPermissionController(agent) {
116
151
  export function hasCompact(agent) {
117
152
  return typeof agent.compact === 'function';
118
153
  }
119
- export function hasClearSession(agent) {
120
- return typeof agent.clearSession === 'function';
121
- }
122
154
  // ── Token usage helper functions ──
123
155
  export function numericToken(value) {
124
156
  return typeof value === 'number' && Number.isFinite(value) ? value : 0;