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
@@ -1,19 +1,26 @@
1
1
  import fs from 'node:fs';
2
2
  import path from 'node:path';
3
3
  import { inspectPackage } from './inspect.mjs';
4
- import { assert, isRecord, unpack, jsonBytes, atomicBytes, sha256, regularPath } from './shared/common.mjs';
4
+ import { assert, isRecord, unpack, jsonBytes, atomicBytes, sha256, regularPath, snapshot, PROFILE_FIELDS } from './shared/common.mjs';
5
5
  import { inspectTemplatePackage } from './shared/template-package.mjs';
6
+ import { partitionTeamMembers } from './shared/template-runtime.mjs';
7
+
6
8
 
7
9
  export function readPackage(options) {
8
10
  const checked = inspectTemplatePackage(fs.readFileSync(options.archivePath), { digest: options.digest });
9
- return { metadata: { id: checked.metadata.id, name: checked.metadata.name, version: checked.metadata.version, description: checked.metadata.description, platforms: checked.metadata.compat.platforms }, members: Object.fromEntries(checked.team.agents.map(member => [member.key, member])), digest: checked.digest,
10
- size: fs.statSync(options.archivePath).size, externalAids: checked.metadata.externalAids ?? [], scan: { findings: [] }, excluded: [] };
11
+ const { inlineMembers, externalContacts, assistantKey } = partitionTeamMembers(checked.team);
12
+ return { metadata: { id: checked.metadata.id, name: checked.metadata.name, version: checked.metadata.version, description: checked.metadata.description, platforms: checked.metadata.compat.platforms }, members: Object.fromEntries(inlineMembers.map(member => [member.key, member])), digest: checked.digest,
13
+ memberReferences: { external: externalContacts }, assistantKey, publisher: checked.metadata.publisher,
14
+ size: fs.statSync(options.archivePath).size, resources: checked.resources, externalAids: checked.metadata.externalAids ?? [], scan: { findings: [] }, excluded: [] };
11
15
  }
12
16
  export async function previewInstallation(options) {
13
17
  const bytes = fs.readFileSync(options.archivePath);
14
18
  const checked = inspectTemplatePackage(bytes, { digest: options.digest });
15
- assert(checked.team.host.platform.includes(process.platform), 'INCOMPATIBLE', 'Template does not support this platform');
16
- const keys = checked.team.agents.map(member => member.key);
19
+ const warnings = checked.team.host.platform.includes(process.platform) ? [] : [{ code: 'PLATFORM_MISMATCH',
20
+ message: `模板声明支持 ${checked.team.host.platform.join(', ')},当前主机为 ${process.platform};安装后请验证功能。` }];
21
+ const allKeys = partitionTeamMembers(checked.team).inlineMembers.map(member => member.key);
22
+ assert(!options.sourceMemberKey || allKeys.includes(options.sourceMemberKey), 'INTEGRITY_FAILED', 'Original source member is absent');
23
+ const keys = options.sourceMemberKey ? [options.sourceMemberKey] : allKeys;
17
24
  assert(isRecord(options.members) && keys.sort().join() === Object.keys(options.members).sort().join(), 'INVALID_ARGUMENT', 'Map every template member');
18
25
  const root = path.join(options.out, 'package'); assert(!fs.existsSync(root), 'CONFLICT', 'Preview exists');
19
26
  unpack(bytes, root); const targets = {};
@@ -28,18 +35,104 @@ export async function previewInstallation(options) {
28
35
  };
29
36
  }
30
37
  const data = await inspectPackage({ packageDir: root, targets, members: options.selections,
38
+ sourceMemberKey: options.sourceMemberKey,
39
+ affectedAids: options.update?.otherAgents,
31
40
  packageRoot: options.packageRoot, out: options.out, digest: checked.digest,
32
41
  planMode: options.installMode === 'create' ? 'create_on_host' : 'overlay_existing' });
33
42
  const plan = JSON.parse(fs.readFileSync(data.planFile, 'utf8'));
43
+ if (!options.update && plan.members.length === 1 && keys[0].includes('.')
44
+ && (options.installMode === 'create' || !Object.hasOwn(options.targets[keys[0]].targetConfig, 'update'))) {
45
+ const write = plan.writes.find(write => write.path === path.join(options.home, 'agents', plan.members[0].targetAid, 'config.json'));
46
+ const config = JSON.parse(Buffer.from(write.content, 'base64'));
47
+ config.version = checked.metadata.version;
48
+ config.update = { mode: 'manual', ...config.update, key: keys[0] };
49
+ if (options.registryAid) config.update.registryAid = options.registryAid;
50
+ else delete config.update.registryAid;
51
+ write.content = jsonBytes(config).toString('base64');
52
+ atomicBytes(data.planFile, jsonBytes(plan), 0o600);
53
+ }
54
+ const update = options.update ? planAgentUpdate(plan, options.update) : undefined;
55
+ if (update) atomicBytes(data.planFile, jsonBytes(plan), 0o600);
34
56
  const configs = {};
35
57
  for (const member of plan.members) {
36
58
  const write = plan.writes.find(item => item.path === path.join(options.home, 'agents', member.targetAid, 'config.json'));
37
59
  assert(write, 'CONFLICT', 'Missing member configuration');
38
60
  configs[member.key] = JSON.parse(Buffer.from(write.content, 'base64').toString('utf8'));
39
61
  }
40
- atomicBytes(path.join(options.out, 'source.ectpl'), bytes, 0o600);
41
- return { ...data, configs, profiles: Object.fromEntries(plan.members.map(member => [member.key, member.profile])),
42
- metadata: { id: checked.metadata.id, name: checked.metadata.name, version: checked.metadata.version, platforms: checked.metadata.compat.platforms }, digest: checked.digest, ignored: [], sourceDigest: sha256(bytes) };
62
+ return { ...data, warnings: [...warnings, ...(data.warnings ?? [])], configs, profiles: Object.fromEntries(plan.members.map(member => [member.key, member.profile])),
63
+ memberReferences: { external: partitionTeamMembers(checked.team).externalContacts },
64
+ assistantKey: partitionTeamMembers(checked.team).assistantKey,
65
+ metadata: { id: checked.metadata.id, name: checked.metadata.name, version: checked.metadata.version, platforms: checked.metadata.compat.platforms },
66
+ ...(update ? { update } : {}), digest: checked.digest, ignored: [], sourceDigest: sha256(bytes) };
67
+ }
68
+
69
+ /** Apply the exact release by default. The old installed MANIFEST only identifies retired files and retained backups. */
70
+ export function planAgentUpdate(plan, input) {
71
+ assert(plan.members?.length === 1, 'INVALID_ARGUMENT', 'A single target is required');
72
+ const member = plan.members[0]; const agentDir = path.join(plan.home, 'agents', member.targetAid);
73
+ const configFile = path.join(agentDir, 'config.json'); const lockFile = path.join(agentDir, 'template.lock.json');
74
+ const original = JSON.parse(fs.readFileSync(configFile, 'utf8'));
75
+ const configWrite = plan.writes.find(write => write.path === configFile);
76
+ const config = JSON.parse(Buffer.from(configWrite.content, 'base64'));
77
+ // Policy/source and local credentials remain local. Version is committed only after installation verification.
78
+ for (const field of ['update', 'team', 'aid', 'owner', 'owners', 'host', 'channels', 'projects', 'enabled', 'lifecycle', 'initialization']) {
79
+ if (Object.hasOwn(original, field)) config[field] = original[field]; else delete config[field];
80
+ }
81
+ config.version = original.version;
82
+ configWrite.content = jsonBytes(config).toString('base64');
83
+ const location = file => {
84
+ for (const [scope, root] of [['agent', agentDir], ['workspace', member.projectPath], ['shared', path.join(plan.home, 'skills')]]) {
85
+ const relative = path.relative(root, file);
86
+ if (relative && relative !== '..' && !relative.startsWith('..' + path.sep) && !path.isAbsolute(relative)) return scope + '/' + relative.split(path.sep).join('/');
87
+ }
88
+ throw Object.assign(new Error('Unexpected managed file'), { code: 'SHARED_RESOURCE_CONFLICT' });
89
+ };
90
+ const resolve = relative => {
91
+ const [scope, ...parts] = relative.split('/'); const roots = { agent: agentDir, workspace: member.projectPath, shared: path.join(plan.home, 'skills') };
92
+ assert(roots[scope] && parts.length && parts.every(part => part && part !== '.' && part !== '..' && !/[\\:\0]/.test(part)), 'INVALID_ARGUMENT', 'Invalid installed file path');
93
+ return path.join(roots[scope], ...parts);
94
+ };
95
+ let oldFiles = null;
96
+ if (Array.isArray(input.manifest) && input.manifest.every(entry => typeof entry.path === 'string'
97
+ && /^[a-f0-9]{64}$/.test(entry.sha256) && Number.isSafeInteger(entry.size) && entry.size >= 0)
98
+ && new Set(input.manifest.map(entry => entry.path)).size === input.manifest.length) {
99
+ try { input.manifest.forEach(entry => resolve(entry.path)); oldFiles = new Map(input.manifest.map(entry => [entry.path, entry])); } catch { oldFiles = null; }
100
+ }
101
+ const desired = new Map(); const writes = [];
102
+ const switchesFile = path.join(agentDir, 'skills', '.switches.json');
103
+ const oldSkills = oldFiles?.get('agent/skills/.switches.json')?.skills;
104
+ if (Array.isArray(oldSkills) && oldSkills.every(name => typeof name === 'string')) {
105
+ let write = plan.writes.find(write => write.path === switchesFile);
106
+ const switches = write ? JSON.parse(Buffer.from(write.content, 'base64'))
107
+ : fs.existsSync(switchesFile) ? JSON.parse(fs.readFileSync(switchesFile, 'utf8')) : {};
108
+ for (const name of oldSkills) if (!Object.hasOwn(member.managedSkills ?? {}, name)) switches[name] = { enabled: false };
109
+ if (!write) { write = { path: switchesFile, mode: 0o600, expected: snapshot(switchesFile) }; plan.writes.push(write); }
110
+ write.content = jsonBytes(switches).toString('base64');
111
+ }
112
+ for (const write of plan.writes) {
113
+ if (write.path === lockFile) continue;
114
+ const relative = location(write.path);
115
+ if (relative.startsWith('shared/') && input.otherAgents?.length && !write.remove
116
+ && snapshot(write.path)?.sha256 !== sha256(Buffer.from(write.content, 'base64'))) {
117
+ throw Object.assign(new Error('Shared resources are used by other Agents'), { code: 'SHARED_RESOURCE_CONFLICT', data: { path: relative, affectedAids: input.otherAgents } });
118
+ }
119
+ if (write.remove && !oldFiles?.has(relative)) continue;
120
+ desired.set(relative, write); writes.push(write);
121
+ }
122
+ const retainedShared = [];
123
+ if (oldFiles) for (const [relative] of oldFiles) {
124
+ if (desired.has(relative) || relative === 'agent/config.json' || relative === 'agent/skills/.switches.json') continue;
125
+ if (relative.startsWith('shared/') && input.otherAgents?.length) { retainedShared.push(relative); continue; }
126
+ // Only portable resource roots can be retired. User data and runtime metadata never enter this set.
127
+ if (!/^(?:workspace\/|shared\/|agent\/(?:personal\/(?:soul\/|welcome\.md$)|triggers\/|events\/|services\/))/.test(relative)) continue;
128
+ const file = resolve(relative); const expected = snapshot(file);
129
+ if (expected) writes.push({ path: file, remove: true, expected });
130
+ }
131
+ plan.writes = writes;
132
+ plan.installationManifest = { key: input.key, version: input.version, digest: input.digest,
133
+ previousValid: oldFiles !== null, oldFiles: oldFiles ? [...oldFiles.values()] : null };
134
+ return { manifestValid: oldFiles !== null, removed: writes.filter(write => write.remove).length, retainedShared,
135
+ managedPaths: [...desired.keys()], changes: [], conflicts: [], requiredApprovals: [], unresolved: [] };
43
136
  }
44
137
 
45
138
  export async function applyInstallationPlan(options) {
@@ -70,7 +163,7 @@ export async function applyInstallationPlan(options) {
70
163
  fs.renameSync(options.backupDir, options.backupDir + '-restored-' + Date.now());
71
164
  }
72
165
  for (const write of plan.writes) {
73
- if (!write.path.includes(path.sep + 'agents' + path.sep)) continue;
166
+ if (!write.path.startsWith(path.join(plan.home, 'agents') + path.sep)) continue;
74
167
  const member = plan.members.find(value => write.path.startsWith(path.join(plan.home, 'agents', value.targetAid) + path.sep));
75
168
  assert(member, 'INVALID_ARGUMENT', 'Unexpected Agent write');
76
169
  const expected = options.baselines?.[member.key]?.[write.path];
@@ -55,7 +55,7 @@ export async function prepareAidBatch({ subjects, context, transport, checkpoint
55
55
  for (const method of ['authorize', 'register', 'connect', 'bind', 'consensus', 'close']) if (typeof transport?.[method] !== 'function') fail('INVALID_ARGUMENT', 'Missing identity transport: ' + method);
56
56
  const aids = new Set(), keys = new Set();
57
57
  for (const s of subjects) {
58
- if (!record(s) || !/^[a-z0-9][a-z0-9_-]{0,31}$/.test(s.key ?? '') || !aidPattern.test(s.aid ?? '')
58
+ if (!record(s) || !(/^[a-z0-9][a-z0-9_-]{0,31}$/.test(s.key ?? '') || aidPattern.test(s.key ?? '')) || !aidPattern.test(s.aid ?? '')
59
59
  || s.relationVersion !== undefined && (!Number.isSafeInteger(s.relationVersion) || s.relationVersion < 1)
60
60
  || !['agent', 'host'].includes(s.type) || aids.has(s.aid) || keys.has(s.key) || s.aid === context.ownerAid
61
61
  || context.mode === 'members' && (s.type !== 'agent' || s.aid === context.hostAid)
@@ -1,152 +0,0 @@
1
- import { normalizeBaseagent } from './baseagent.js';
2
- import { commandExists, commandExistsAsync } from '../utils/cross-platform.js';
3
- import { getCodexAppServerAvailability, getCodexAppServerAvailabilityAsync } from './codex-runner.js';
4
- import { probeBundledClaudeVersion, probeBundledClaudeVersionAsync, resolveBundledClaudeExecutable } from './claude-runner.js';
5
- /**
6
- * Claude 的检测判据就是执行判据:会话只会在 Windows 上跑内置的、与 SDK 锁定版本
7
- * 配套的 claude.exe。PATH 里的全局 claude 执行层从不使用,因此不能作为可用判据——
8
- * 那个假阳性正是「检测说可用、会话全失败」持续 21 小时没被发现的成因。
9
- */
10
- function claudeExecutable() {
11
- if (process.platform === 'win32')
12
- return resolveBundledClaudeExecutable();
13
- // 非 Windows 平台由 SDK 自己解析平台包,此处沿用命令探测。
14
- return commandExists('claude') ? 'claude' : undefined;
15
- }
16
- export const BASEAGENT_CANDIDATES = ['claude', 'codex', 'gemini', 'ecagent'];
17
- export const AUTO_BASEAGENT_CANDIDATES = ['claude', 'codex', 'gemini'];
18
- /**
19
- * Single source of truth for init and ECWeb base-agent probing.
20
- * Claude/Gemini require an executable; Codex additionally requires a supported
21
- * CLI with app-server; ecagent is bundled with EvolCore.
22
- */
23
- export function detectAvailableBaseagents(codexAvailability = getCodexAppServerAvailability()) {
24
- return BASEAGENT_CANDIDATES.filter((baseagent) => {
25
- if (baseagent === 'ecagent')
26
- return true;
27
- if (baseagent === 'codex')
28
- return codexAvailability.available;
29
- if (baseagent === 'claude')
30
- return claudeExecutable() !== undefined;
31
- return commandExists(baseagent);
32
- });
33
- }
34
- export function detectBaseagentDetails(codexAvailability = getCodexAppServerAvailability()) {
35
- const claude = claudeExecutable();
36
- const claudeVersion = claude ? probeBundledClaudeVersion() : undefined;
37
- const gemini = commandExists('gemini');
38
- return baseagentDetails(codexAvailability, claude, claudeVersion, gemini);
39
- }
40
- export async function detectBaseagentDetailsAsync() {
41
- const [codex, claude, gemini] = await Promise.all([
42
- getCodexAppServerAvailabilityAsync(),
43
- (process.platform === 'win32'
44
- ? Promise.resolve(resolveBundledClaudeExecutable())
45
- : commandExistsAsync('claude').then(found => found ? 'claude' : undefined))
46
- .then(async (executable) => ({ executable,
47
- version: executable ? await probeBundledClaudeVersionAsync() : undefined })),
48
- commandExistsAsync('gemini'),
49
- ]);
50
- return baseagentDetails(codex, claude.executable, claude.version, gemini);
51
- }
52
- function baseagentDetails(codexAvailability, claude, claudeVersion, gemini) {
53
- return [
54
- {
55
- id: 'claude',
56
- detected: claude !== undefined,
57
- detectionSource: claude ? [process.platform === 'win32' ? 'bundled SDK binary' : 'PATH'] : [],
58
- reason: claude
59
- ? undefined
60
- : process.platform === 'win32'
61
- ? '未找到内置 claude.exe(@anthropic-ai/claude-agent-sdk-win32-x64)。请重新安装 SDK 的平台包。'
62
- : '未检测到 Claude CLI。',
63
- version: claudeVersion,
64
- },
65
- {
66
- id: 'codex',
67
- detected: codexAvailability.available,
68
- detectionSource: codexAvailability.available ? ['Codex CLI app-server'] : [],
69
- reason: codexAvailability.available ? undefined : codexAvailability.reason,
70
- version: codexAvailability.version,
71
- },
72
- {
73
- id: 'gemini',
74
- detected: gemini,
75
- detectionSource: gemini ? ['PATH'] : [],
76
- reason: gemini ? undefined : '未检测到 Gemini CLI。',
77
- },
78
- {
79
- id: 'ecagent',
80
- detected: true,
81
- detectionSource: ['内置'],
82
- },
83
- ];
84
- }
85
- /** Currently loaded runners only; configured on-demand choices are provided separately. */
86
- export function loadedBaseagentIds(keys, owner) {
87
- const result = new Set();
88
- for (const key of keys) {
89
- if (owner !== undefined && !key.startsWith(`${owner}::`))
90
- continue;
91
- const separator = key.indexOf('::');
92
- result.add(separator < 0 ? key : key.slice(separator + 2));
93
- }
94
- return [...result];
95
- }
96
- function canonical(value) {
97
- if (typeof value !== 'string')
98
- return null;
99
- const id = normalizeBaseagent(value).canonical;
100
- return id === 'unknown' ? null : id;
101
- }
102
- function record(value) {
103
- return value && typeof value === 'object' && !Array.isArray(value) ? value : {};
104
- }
105
- function text(value) {
106
- return typeof value === 'string' && value.trim() ? value : null;
107
- }
108
- /** Safe public projection: credentials and arbitrary backend settings never leave this boundary. */
109
- export function buildBaseagentSnapshot(config, detections, loaded) {
110
- const blocks = new Map();
111
- for (const [name, value] of Object.entries(record(config.baseagents))) {
112
- const id = canonical(name);
113
- if (id)
114
- blocks.set(id, record(value));
115
- }
116
- const active = canonical(config.active_baseagent);
117
- const probes = new Map((detections ?? []).map(item => [String(item.id), item]));
118
- const loadedIds = loaded === undefined ? null : new Set(loaded);
119
- const ids = new Set([
120
- ...blocks.keys(),
121
- ...(detections ?? []).filter(item => item.detected).map(item => item.id),
122
- ...(loaded ?? []),
123
- ...(active ? [active] : []),
124
- ]);
125
- return {
126
- active,
127
- baseagents: [...ids].map(id => ({
128
- id,
129
- label: normalizeBaseagent(id).displayName,
130
- configured: blocks.has(id),
131
- detected: detections === null ? null : probes.get(id)?.detected === true,
132
- loaded: loadedIds?.has(id) ?? null,
133
- active: id === active,
134
- model: text(blocks.get(id)?.model),
135
- effort: text(blocks.get(id)?.effort ?? blocks.get(id)?.reasoning),
136
- version: probes.get(id)?.version ?? null,
137
- detectionSource: probes.get(id)?.detectionSource ?? [],
138
- })),
139
- };
140
- }
141
- /** Shared defaults/Agent inventory for menu, slash and local history readers. */
142
- export async function getBaseagentSnapshot(options = {}) {
143
- let config = options.config;
144
- if (config === undefined) {
145
- const { read, ConfigTarget } = await import('../config/config-manager.js');
146
- config = read(ConfigTarget.Defaults, undefined, { cache: false }) ?? {};
147
- }
148
- const detections = options.probe === false
149
- ? null
150
- : await detectBaseagentDetailsAsync();
151
- return buildBaseagentSnapshot(config ?? {}, detections, options.loaded);
152
- }