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,288 @@
1
+ /**
2
+ * Baseagent 能力适配器
3
+ *
4
+ * 提供运行时能力查询接口,用于:
5
+ * - Host 判断某个能力是否可用(如决定是否降级、拦截工具)
6
+ * - 汇总声明、实现、配置、模型与平台事实,不启动基座或在线探测
7
+ */
8
+ import { getBaseagentPluginDescriptor } from './baseagent-plugin-descriptor.js';
9
+ import { baseagentCapabilityLevel } from './baseagent-plugin-descriptor.js';
10
+ /** Builtins retain their existing checks; directory plugins opt into C/X features. */
11
+ export function declaredBaseagentCapabilityAvailable(baseagent, id) {
12
+ const descriptor = getBaseagentPluginDescriptor(baseagent);
13
+ if (!descriptor || baseagentCapabilityLevel(id) === 'B')
14
+ return undefined;
15
+ return new BaseagentCapabilityAdapter(descriptor).isAvailable(id);
16
+ }
17
+ /** Structural admission is necessary; behavioral B requirements still need adapter acceptance tests. */
18
+ export function validateRequiredBaseagentRunner(runner, name) {
19
+ if (!runner || typeof runner !== 'object')
20
+ return ['B03: runner must be an object'];
21
+ const value = runner;
22
+ const errors = [];
23
+ if (value.name !== name)
24
+ errors.push('B01: runner identity does not match plugin');
25
+ for (const [id, methods] of [
26
+ ['B03', ['runQuery', 'dispose']], ['B07', ['interrupt']],
27
+ ['B09', ['registerStream', 'cleanupStream', 'hasActiveStream', 'closeSession']],
28
+ ['B11', ['setPermissionContext', 'setSendPrompt', 'setMode', 'getMode']],
29
+ ['C03', ['updateSessionId']], ['C05', ['compact', 'compactSession']],
30
+ ]) {
31
+ for (const method of methods)
32
+ if (typeof value[method] !== 'function')
33
+ errors.push(`${id}: missing ${method}`);
34
+ }
35
+ if (value.capabilities?.compact === false)
36
+ errors.push('C05: compression is required for admission');
37
+ return errors;
38
+ }
39
+ /** Shared precedence for runtime gates, inventory and extension settings. Keep every cause. */
40
+ export function resolveCapabilityState(reasons) {
41
+ const order = [
42
+ 'undeclared', 'unsupported', 'unavailable', 'disabled', 'unverified', 'conditional',
43
+ ];
44
+ const status = order.find(value => reasons.some(reason => reason.status === value)) ?? 'available';
45
+ return { status, usable: status === 'available' || status === 'conditional', reasons };
46
+ }
47
+ const CAPABILITY_METHODS = {
48
+ C04: ['getSessionMessages'], C07: ['forkSession'], C10: ['getModelCatalog', 'listModels'],
49
+ X02: ['forkSessionAt'], X03: ['rewindFiles'], X04: ['rollbackSessionTurns'],
50
+ X05: ['setSessionName', 'updateSessionMetadata'], X07: ['injectUserMessage'],
51
+ };
52
+ /** Optional capabilities require both a declaration and an implementation; Host policy still applies. */
53
+ export function restrictDeclaredRunnerCapabilities(baseagent, runner, context) {
54
+ const descriptor = getBaseagentPluginDescriptor(baseagent);
55
+ if (!descriptor)
56
+ return runner; // Builtins retain their existing contract.
57
+ const adapter = new BaseagentCapabilityAdapter(descriptor);
58
+ const available = (id) => adapter.getStatus(id, { runner }).usable;
59
+ const capabilities = { ...runner.capabilities };
60
+ const hidden = new Set();
61
+ for (const [property, id] of [
62
+ ['fork', 'C07'], ['forkAtTurn', 'X02'], ['forkAtMessage', 'X02'], ['askUserQuestion', 'C25'],
63
+ ]) {
64
+ if (!available(id)) {
65
+ capabilities[property] = false;
66
+ }
67
+ }
68
+ if (!available('C07') || !available('C04')) {
69
+ capabilities.forkAtTurn = false;
70
+ capabilities.forkAtMessage = false;
71
+ hidden.add('forkSessionAt');
72
+ }
73
+ if (!available('X03')) {
74
+ capabilities.fileRewind = 'unsupported';
75
+ }
76
+ // Hide unsupported optional methods so existing guards and menus agree.
77
+ for (const [id, methods] of [
78
+ ['C04', ['getSessionMessages']], ['C07', ['forkSession']], ['X02', ['forkSessionAt']],
79
+ ['X03', ['rewindFiles']], ['X04', ['rollbackSessionTurns']],
80
+ ['X05', ['setSessionName', 'updateSessionMetadata']], ['X07', ['injectUserMessage']],
81
+ ['C25', ['steerAsyncQuestionAnswer']], ['C10', ['getModelCatalog', 'listModels']],
82
+ ]) {
83
+ if (available(id))
84
+ continue;
85
+ for (const method of methods)
86
+ hidden.add(method);
87
+ }
88
+ const methods = new Map();
89
+ if (runner.runQuery) {
90
+ methods.set('runQuery', async (...args) => {
91
+ const explicitEffort = args[7]?.effort !== undefined && args[7].effortMode !== 'model_default';
92
+ const evaluation = { ...(args[4]?.length || explicitEffort ? await context?.(args[7]) : {}), runner };
93
+ if (args[7]?.model && evaluation.model?.id !== args[7].model)
94
+ delete evaluation.model;
95
+ if (args[4]?.length)
96
+ assertDeclaredBaseagentCapability(baseagent, 'C26', evaluation);
97
+ if (explicitEffort) {
98
+ assertDeclaredBaseagentCapability(baseagent, 'C11', evaluation);
99
+ }
100
+ return runner.runQuery(...args);
101
+ });
102
+ }
103
+ // Limit Host entrypoints without removing methods the adapter may internally
104
+ // need for required operations (e.g. compaction reading its own history).
105
+ return new Proxy(runner, {
106
+ get(target, property) {
107
+ if (property === 'capabilities')
108
+ return capabilities;
109
+ if (typeof property === 'string' && hidden.has(property))
110
+ return undefined;
111
+ if (methods.has(property))
112
+ return methods.get(property);
113
+ const value = Reflect.get(target, property, target);
114
+ if (typeof value !== 'function')
115
+ return value;
116
+ const bound = value.bind(target);
117
+ methods.set(property, bound);
118
+ return bound;
119
+ },
120
+ });
121
+ }
122
+ export function assertDeclaredBaseagentCapability(baseagent, id, context = {}) {
123
+ const descriptor = getBaseagentPluginDescriptor(baseagent);
124
+ if (!descriptor || baseagentCapabilityLevel(id) === 'B')
125
+ return;
126
+ const state = new BaseagentCapabilityAdapter(descriptor).getStatus(id, context);
127
+ if (state.usable)
128
+ return;
129
+ const reason = state.reasons.map(item => item.message).join('; ');
130
+ throw Object.assign(new Error(`Baseagent ${baseagent} does not support ${id}${reason ? ': ' + reason : ''}`), { code: 'BASEAGENT_CAPABILITY_UNSUPPORTED', capability: id,
131
+ capabilityStatus: state.status, capabilityReasons: state.reasons });
132
+ }
133
+ /**
134
+ * Baseagent 能力适配器
135
+ *
136
+ * 根据插件的能力声明和当前运行环境,提供能力查询接口
137
+ */
138
+ export class BaseagentCapabilityAdapter {
139
+ descriptor;
140
+ envKey;
141
+ capabilityMap;
142
+ /**
143
+ * @param descriptor 插件描述符
144
+ * @param envKey 环境键(默认为 process.platform)
145
+ */
146
+ constructor(descriptor, envKey) {
147
+ this.descriptor = descriptor;
148
+ this.envKey = envKey ?? process.platform;
149
+ // 构建能力 ID → 声明的映射
150
+ this.capabilityMap = new Map();
151
+ for (const cap of descriptor.declaredCapabilities.filter(item => item.id !== 'C06' && baseagentCapabilityLevel(item.id) !== 'B')) {
152
+ this.capabilityMap.set(cap.id, cap);
153
+ }
154
+ }
155
+ /**
156
+ * 查询能力是否可用
157
+ *
158
+ * @param id 选配能力 ID(如 C07、X02);B 类由必需接口约束
159
+ * @returns 当前环境下该能力是否可用
160
+ */
161
+ isAvailable(id) {
162
+ return this.getStatus(id).usable;
163
+ }
164
+ /**
165
+ * 获取能力的实现方式
166
+ *
167
+ * @param id 能力 ID
168
+ * @returns 实现方式(native/adapted/host-only/unsupported),未声明返回 null
169
+ */
170
+ getImplementation(id) {
171
+ const cap = this.capabilityMap.get(id);
172
+ return cap?.implementation ?? null;
173
+ }
174
+ /**
175
+ * 获取能力的完整信息
176
+ *
177
+ * @param id 能力 ID
178
+ * @returns 能力信息对象,未声明返回 null
179
+ */
180
+ getCapability(id, context = {}) {
181
+ return this.capabilityMap.has(id) ? this.getStatus(id, context) : null;
182
+ }
183
+ getStatus(id, context = {}) {
184
+ const cap = this.capabilityMap.get(id);
185
+ const envOverride = cap?.environments?.[this.envKey];
186
+ const environment = this.descriptor.environments.find(item => item.os === this.envKey);
187
+ const availability = envOverride?.availability ?? cap?.availability ?? 'unavailable';
188
+ const verification = envOverride?.verification ?? cap?.verification ?? 'unverified';
189
+ const notes = envOverride?.notes ?? cap?.notes;
190
+ const reasons = [];
191
+ const add = (code, source, status, message) => reasons.push({ code, source, status, message });
192
+ if (!cap)
193
+ add('NOT_DECLARED', 'declaration', 'undeclared', `基座 ${this.descriptor.name} 未声明 ${id}`);
194
+ else {
195
+ if (cap.implementation === 'unsupported') {
196
+ add('NOT_IMPLEMENTED', 'implementation', 'unsupported', notes || `${id} 尚未实现`);
197
+ }
198
+ if (!environment)
199
+ add('OS_NOT_VERIFIED', 'environment', 'unverified', `基座未验证 ${this.envKey} 平台`);
200
+ if (availability === 'unavailable')
201
+ add('DECLARED_UNAVAILABLE', 'declaration', 'unavailable', notes || `${id} 在当前平台不可用`);
202
+ if (availability === 'unknown' || verification !== 'verified') {
203
+ add('CAPABILITY_NOT_VERIFIED', 'declaration', 'unverified', notes || `${id} 在当前平台尚未验证`);
204
+ }
205
+ const runner = context.runner;
206
+ const methods = CAPABILITY_METHODS[id];
207
+ if (context.requireImplementationCheck && !runner) {
208
+ add('IMPLEMENTATION_UNCHECKED', 'implementation', 'conditional', 'Runner 尚未创建,实现接口将在加载后确认');
209
+ }
210
+ if (runner && methods && !methods.some(method => typeof runner[method] === 'function')) {
211
+ add('METHOD_MISSING', 'implementation', 'unavailable', `${id} 缺少运行接口:${methods.join(' / ')}`);
212
+ }
213
+ const flags = runner?.capabilities;
214
+ if ((id === 'C07' && flags?.fork !== true)
215
+ || (id === 'X02' && flags?.forkAtTurn !== true && flags?.forkAtMessage !== true)
216
+ || (id === 'X03' && (!flags?.fileRewind || flags.fileRewind === 'unsupported'))) {
217
+ if (runner)
218
+ add('RUNNER_DISABLED', 'implementation', 'unavailable', `当前 Runner 未开放 ${id}`);
219
+ }
220
+ if (runner && id === 'C25' && flags?.askUserQuestion !== true) {
221
+ add('QUESTION_DISABLED', 'configuration', 'disabled', '当前 Runner 未启用结构化提问;请检查基座功能开关和交互入口');
222
+ }
223
+ if (id === 'X02') {
224
+ for (const prerequisite of ['C04', 'C07']) {
225
+ if (!this.getStatus(prerequisite, { runner: context.runner }).usable) {
226
+ add('DEPENDENCY_UNAVAILABLE', 'implementation', 'unavailable', `${id} 依赖 ${prerequisite}`);
227
+ }
228
+ }
229
+ }
230
+ if (context.modelChecked && (id === 'C26' || id === 'C11')) {
231
+ const model = context.model;
232
+ if (id === 'C26' && model?.imageIn === false) {
233
+ add('MODEL_IMAGE_UNSUPPORTED', 'model', 'unsupported', `模型 ${model.id} 明确不支持图片输入`);
234
+ }
235
+ else if (id === 'C11' && model?.reasoningLevels?.length === 0) {
236
+ add('MODEL_EFFORT_UNSUPPORTED', 'model', 'unsupported', `模型 ${model.id} 没有可配置的推理档位`);
237
+ }
238
+ else if (!model || (id === 'C26' ? model.imageIn === undefined : model.reasoningLevels === undefined)) {
239
+ add('MODEL_CAPABILITY_UNKNOWN', 'model', 'conditional', '模型能力元数据缺失,执行时由基座和模型校验');
240
+ }
241
+ }
242
+ if (cap.conditions)
243
+ add('CONDITIONS_APPLY', 'declaration', 'conditional', cap.conditions);
244
+ }
245
+ if (context.runtime?.available === false) {
246
+ add('RUNTIME_UNAVAILABLE', 'runtime', 'unavailable', context.runtime.reason || '基座未通过当前运行环境准入');
247
+ }
248
+ if (context.enabled === false)
249
+ add('CONFIG_DISABLED', 'configuration', 'disabled', '能力已在当前配置中关闭');
250
+ return {
251
+ id, level: baseagentCapabilityLevel(id) ?? cap?.level ?? 'C', declared: !!cap,
252
+ implementation: cap?.implementation ?? 'unsupported',
253
+ availability: environment ? availability : 'unavailable',
254
+ verification: environment ? verification : 'unverified', notes,
255
+ ...(cap?.conditions ? { conditions: cap.conditions } : {}),
256
+ ...resolveCapabilityState(reasons), environment: this.envKey,
257
+ implementationChecked: !!context.runner && (!!CAPABILITY_METHODS[id] || id === 'C25'),
258
+ ...(environment ? { declarationEvidence: { pluginVersion: this.descriptor.version ?? 'unknown',
259
+ os: environment.os, ...environment.probedWith } } : {}),
260
+ testEvidence: (cap?.evidence ?? []).filter(item => item.os === this.envKey
261
+ && item.pluginVersion === this.descriptor.version
262
+ && (!context.backendVersion || item.backendVersion === context.backendVersion)),
263
+ };
264
+ }
265
+ listStatuses(context = {}) {
266
+ const ids = ['B12', ...Array.from({ length: 27 }, (_, index) => `C${String(index + 1).padStart(2, '0')}`),
267
+ ...Array.from({ length: 20 }, (_, index) => `X${String(index + 1).padStart(2, '0')}`)];
268
+ return [...new Set([...ids, ...this.capabilityMap.keys()])]
269
+ .filter(id => id.startsWith('EXT-') || (baseagentCapabilityLevel(id) && baseagentCapabilityLevel(id) !== 'B'))
270
+ .map(id => this.getStatus(id, context));
271
+ }
272
+ /**
273
+ * 列举所有已声明的能力 ID
274
+ *
275
+ * @returns 能力 ID 列表
276
+ */
277
+ listCapabilities() {
278
+ return Array.from(this.capabilityMap.keys());
279
+ }
280
+ /**
281
+ * 获取当前环境键
282
+ *
283
+ * @returns 环境键(如 'linux', 'darwin', 'win32')
284
+ */
285
+ getCurrentEnvironment() {
286
+ return this.envKey;
287
+ }
288
+ }
@@ -0,0 +1,56 @@
1
+ export function nonEmptyString(value) {
2
+ return typeof value === 'string' && value.trim() ? value.trim() : undefined;
3
+ }
4
+ export class NativeConnectionIncompleteError extends Error {
5
+ #connection;
6
+ constructor(message, connection) {
7
+ super(message);
8
+ this.#connection = connection;
9
+ }
10
+ get connection() { return this.#connection; }
11
+ }
12
+ export function directInferenceValue(...values) {
13
+ for (const value of values) {
14
+ const normalized = value?.trim();
15
+ const lower = normalized?.toLowerCase();
16
+ if (normalized && !lower?.includes('your-') && !lower?.includes('placeholder'))
17
+ return normalized;
18
+ }
19
+ return undefined;
20
+ }
21
+ export function directInferencePair(apiKey, baseUrl) {
22
+ const normalizedApiKey = directInferenceValue(apiKey);
23
+ const normalizedBaseUrl = directInferenceValue(baseUrl);
24
+ if (!normalizedApiKey || !normalizedBaseUrl)
25
+ return undefined;
26
+ return { apiKey: normalizedApiKey, baseUrl: normalizedBaseUrl };
27
+ }
28
+ const HTTP_HEADER_NAME = /^[!#$%&'*+.^_`|~0-9A-Za-z-]+$/;
29
+ export function normalizeStringMap(value, field) {
30
+ if (value === undefined || value === null)
31
+ return undefined;
32
+ if (typeof value !== 'object' || Array.isArray(value)) {
33
+ throw new Error(`${field} must be an object with string values`);
34
+ }
35
+ const entries = [];
36
+ for (const [key, item] of Object.entries(value)) {
37
+ if (!key)
38
+ throw new Error(`${field} names cannot be empty`);
39
+ if (typeof item !== 'string')
40
+ throw new Error(`${field}.${key} must be a string`);
41
+ if (field === 'headers') {
42
+ if (!HTTP_HEADER_NAME.test(key))
43
+ throw new Error(`Invalid HTTP header name: ${key}`);
44
+ if (/[\0\r\n]/.test(item))
45
+ throw new Error(`HTTP header ${key} cannot contain NUL or line breaks`);
46
+ }
47
+ entries.push([key, item]);
48
+ }
49
+ return entries.length > 0 ? Object.fromEntries(entries) : undefined;
50
+ }
51
+ export function normalizeRequestMetadata(value) {
52
+ return {
53
+ headers: normalizeStringMap(value?.headers, 'headers'),
54
+ queryParams: normalizeStringMap(value?.queryParams, 'queryParams'),
55
+ };
56
+ }
@@ -0,0 +1,68 @@
1
+ // ── baseagent 别名归一 ─────────────────────────────────────────────────
2
+ import { baseagentDeclarations } from '../plugin/plugin-lifecycle.js';
3
+ /** 内置 baseagent canonical 名称集合;外部插件不得与这些名称冲突。 */
4
+ export const BUILTIN_BASEAGENT_NAMES = new Set(['claude', 'codex', 'gemini', 'ecagent']);
5
+ const BASEAGENT_ALIASES = {
6
+ claude: { canonical: 'claude', displayName: 'Claude Code' },
7
+ cc: { canonical: 'claude', displayName: 'Claude Code' },
8
+ 'claude-code': { canonical: 'claude', displayName: 'Claude Code' },
9
+ 'claude code': { canonical: 'claude', displayName: 'Claude Code' },
10
+ claudecode: { canonical: 'claude', displayName: 'Claude Code' },
11
+ codex: { canonical: 'codex', displayName: 'Codex' },
12
+ 'codex-cli': { canonical: 'codex', displayName: 'Codex' },
13
+ 'codex cli': { canonical: 'codex', displayName: 'Codex' },
14
+ gemini: { canonical: 'gemini', displayName: 'Gemini CLI' },
15
+ 'gemini-cli': { canonical: 'gemini', displayName: 'Gemini CLI' },
16
+ 'gemini cli': { canonical: 'gemini', displayName: 'Gemini CLI' },
17
+ geminicli: { canonical: 'gemini', displayName: 'Gemini CLI' },
18
+ ecagent: { canonical: 'ecagent', displayName: 'ecagent' },
19
+ 'ec-agent': { canonical: 'ecagent', displayName: 'ecagent' },
20
+ };
21
+ export function normalizeBaseagent(input) {
22
+ const key = String(input || '').trim().toLowerCase().replace(/_/g, '-');
23
+ return BASEAGENT_ALIASES[key] || { canonical: 'unknown', displayName: input ? String(input) : 'Unknown' };
24
+ }
25
+ export function isSupportedBaseagent(input) {
26
+ const key = String(input || '').trim().toLowerCase();
27
+ return Object.hasOwn(baseagentDeclarations(), key);
28
+ }
29
+ export function listSupportedBaseagents() {
30
+ return Object.keys(baseagentDeclarations());
31
+ }
32
+ export function reservedBaseagentAliases(ownName) {
33
+ return new Set(Object.entries(BASEAGENT_ALIASES)
34
+ .filter(([, value]) => value.canonical !== ownName).map(([alias]) => alias));
35
+ }
36
+ /**
37
+ * 为已声明基座注册别名;原内置基座也通过同一入口加载。
38
+ * 身份展示由这里维护,部署识别以 daemon 声明为准。
39
+ *
40
+ * @param canonicalName - 插件的 canonical name(如 'myagent')
41
+ * @param displayName - 对外展示名(如 'My Agent')
42
+ * @param aliases - 应归一到 canonicalName 的所有别名(含 canonicalName 本身)
43
+ */
44
+ export function registerExternalBaseagentAliases(canonicalName, displayName, aliases) {
45
+ const keys = [...new Set([canonicalName, ...aliases].map(alias => alias.trim().toLowerCase().replace(/_/g, '-')))];
46
+ for (const key of keys) {
47
+ const owner = Object.hasOwn(BASEAGENT_ALIASES, key) ? BASEAGENT_ALIASES[key] : undefined;
48
+ if (!key || key === '__proto__' || key === 'constructor' || key === 'prototype'
49
+ || (owner && owner.canonical !== canonicalName)) {
50
+ throw new Error(`Baseagent alias '${key}' is invalid or already owned by '${owner?.canonical}'`);
51
+ }
52
+ }
53
+ const previous = new Map(keys.map(key => [key,
54
+ Object.hasOwn(BASEAGENT_ALIASES, key) ? BASEAGENT_ALIASES[key] : undefined]));
55
+ const normalized = { canonical: canonicalName, displayName };
56
+ for (const key of keys)
57
+ BASEAGENT_ALIASES[key] = normalized;
58
+ return () => {
59
+ for (const [key, oldValue] of previous) {
60
+ if (BASEAGENT_ALIASES[key] !== normalized)
61
+ continue;
62
+ if (oldValue)
63
+ BASEAGENT_ALIASES[key] = oldValue;
64
+ else
65
+ delete BASEAGENT_ALIASES[key];
66
+ }
67
+ };
68
+ }
@@ -5,14 +5,38 @@
5
5
  * own runner so that runtime state (model/effort/permissionMode/credentials)
6
6
  * is fully isolated.
7
7
  */
8
- import { logger } from '../utils/logger.js';
9
- import { PluginHandle } from './plugin-lifecycle.js';
8
+ import { logger } from '../../utils/logger.js';
9
+ import { PluginHandle, pluginRuntimeReason, recordPluginWarnings } from '../plugin/plugin-lifecycle.js';
10
+ import { getCcAgentAid } from '../../claude-gateway/agent-registration.js';
11
+ import { getBaseagentPluginDescriptor, isBaseagentPluginForced, validateBaseagentPluginConfigs } from './baseagent-plugin-descriptor.js';
12
+ import { restrictDeclaredRunnerCapabilities, validateRequiredBaseagentRunner } from './baseagent-capability-adapter.js';
10
13
  /** Agent Loader — produces one runner per (EvolAgent × baseagent). */
11
14
  export class AgentLoader {
12
15
  plugins = new Map();
13
16
  creationSlots = new Map();
17
+ /** The selected backend may rely entirely on native/descriptor defaults. */
18
+ withSelectedConfiguration(agent) {
19
+ const name = agent.config.active_baseagent ?? agent.baseagent;
20
+ if (!name || Object.hasOwn(agent.config.baseagents ?? {}, name))
21
+ return agent;
22
+ // A temporary view preserves identity and getters without modifying stored
23
+ // or shared effective configuration just to supply an empty settings block.
24
+ return Object.create(agent, { config: { value: { ...agent.config,
25
+ baseagents: { ...agent.config.baseagents, [name]: {} } } } });
26
+ }
14
27
  enabledBaseagents(agent) {
15
- return [...this.plugins].filter(([, plugin]) => plugin.isEnabled(agent)).map(([name]) => name);
28
+ if (agent.aid === getCcAgentAid())
29
+ return [];
30
+ agent = this.withSelectedConfiguration(agent);
31
+ return [...this.plugins].filter(([, plugin]) => {
32
+ try {
33
+ return plugin.isEnabled(agent);
34
+ }
35
+ catch (error) {
36
+ logger.warn(`Cannot probe plugin ${plugin.name}:`, error);
37
+ return false;
38
+ }
39
+ }).map(([name]) => name);
16
40
  }
17
41
  async withCreationSlot(backend, create) {
18
42
  let slots = this.creationSlots.get(backend);
@@ -39,6 +63,8 @@ export class AgentLoader {
39
63
  }
40
64
  this.plugins.set(plugin.name, plugin);
41
65
  logger.debug(`Registered agent plugin: ${plugin.name}`);
66
+ return () => { if (this.plugins.get(plugin.name) === plugin)
67
+ this.plugins.delete(plugin.name); };
42
68
  }
43
69
  /**
44
70
  * Create each Agent's selected backend. Other backends are created on demand.
@@ -91,12 +117,35 @@ export class AgentLoader {
91
117
  }
92
118
  /** Create runners for one EvolAgent, used by runtime hot-load. */
93
119
  async createForAgent(agent, callbacks, creationErrors, selectPlugin = () => true, onCreating) {
120
+ if (agent.aid === getCcAgentAid())
121
+ return [];
122
+ agent = this.withSelectedConfiguration(agent);
94
123
  const instances = [];
124
+ if (agent.baseagent && selectPlugin(agent.baseagent) && !this.plugins.has(agent.baseagent)) {
125
+ const message = '所选基座未声明、已禁用或未通过准入:' + agent.baseagent;
126
+ creationErrors?.push({ evolagentName: agent.name, baseagent: agent.baseagent, message,
127
+ reason: pluginRuntimeReason('BASEAGENT_UNAVAILABLE', 'create', message) });
128
+ logger.error(message);
129
+ }
95
130
  for (const [pluginName, plugin] of this.plugins) {
96
131
  if (!selectPlugin(pluginName))
97
132
  continue;
98
- if (!plugin.isEnabled(agent)) {
99
- logger.debug(`Plugin '${pluginName}' disabled for agent '${agent.name}', skipping`);
133
+ try {
134
+ if (!plugin.isEnabled(agent)) {
135
+ if (pluginName === agent.baseagent)
136
+ throw new Error('所选基座的运行配置不可用:' + pluginName);
137
+ logger.debug(`Plugin '${pluginName}' disabled for agent '${agent.name}', skipping`);
138
+ continue;
139
+ }
140
+ const errors = validateBaseagentPluginConfigs({ [pluginName]: agent.config.baseagents?.[pluginName] });
141
+ if (errors.length)
142
+ throw new Error(errors.join('; '));
143
+ }
144
+ catch (error) {
145
+ const message = error instanceof Error ? error.message : String(error);
146
+ creationErrors?.push({ evolagentName: agent.name, baseagent: pluginName, message,
147
+ reason: pluginRuntimeReason('INVALID_CONFIG', 'configuration', '基座启用检查失败', error) });
148
+ logger.error(`Cannot enable plugin ${pluginName} for ${agent.name}:`, error);
100
149
  continue;
101
150
  }
102
151
  let teardown;
@@ -112,7 +161,40 @@ export class AgentLoader {
112
161
  continue;
113
162
  }
114
163
  teardown = instance.agent.dispose?.bind(instance.agent);
164
+ if (getBaseagentPluginDescriptor(pluginName)) {
165
+ const errors = validateRequiredBaseagentRunner(instance.agent, pluginName);
166
+ const force = isBaseagentPluginForced(pluginName);
167
+ const runnable = instance.agent.name === pluginName
168
+ && typeof instance.agent.runQuery === 'function' && typeof instance.agent.dispose === 'function';
169
+ if (errors.length && (!force || !runnable)) {
170
+ throw Object.assign(new Error(errors.join('; ')), { code: 'BASEAGENT_REQUIREMENTS_UNMET' });
171
+ }
172
+ if (errors.length) {
173
+ logger.warn(`Force-loading runner ${pluginName} with unmet B requirements:`, errors);
174
+ recordPluginWarnings('baseagent', pluginName, errors);
175
+ }
176
+ else {
177
+ instance.agent.capabilities = { ...instance.agent.capabilities, compact: true };
178
+ }
179
+ }
115
180
  instance.agent.dispose = () => lifecycle.dispose();
181
+ instance.agent = restrictDeclaredRunnerCapabilities(pluginName, instance.agent, async (overrides) => {
182
+ const { peekRunnerCatalog, resolveCatalogModel } = await import('../model/model-catalog.js');
183
+ const { resolveEffective } = await import('../../config/config-manager.js');
184
+ try {
185
+ const config = resolveEffective({ self: agent.aid }, { cache: true });
186
+ const model = overrides?.model ?? config.baseagents?.[pluginName]?.model;
187
+ const catalog = overrides?.provider
188
+ ? peekRunnerCatalog(pluginName, undefined, { providerId: overrides.provider })
189
+ : peekRunnerCatalog(pluginName, agent.aid, {});
190
+ const entry = model ? catalog.models.find(item => item.id === resolveCatalogModel(catalog, model)) : undefined;
191
+ return { modelChecked: true, ...(model ? { model: { id: model,
192
+ imageIn: entry?.imageIn, reasoningLevels: entry?.reasoningLevels } } : {}) };
193
+ }
194
+ catch {
195
+ return { modelChecked: true };
196
+ }
197
+ });
116
198
  instance.lifecycle = lifecycle;
117
199
  instances.push(instance);
118
200
  logger.info(`✓ Runner created: agent=${instance.evolagentName} baseagent=${instance.baseagent}`);
@@ -125,7 +207,8 @@ export class AgentLoader {
125
207
  logger.warn(`[AgentLoader] Cleanup failed for ${lifecycle.owner}:`, disposeError);
126
208
  }
127
209
  const message = error instanceof Error ? error.message : String(error);
128
- creationErrors?.push({ evolagentName: agent.name, baseagent: pluginName, message });
210
+ creationErrors?.push({ evolagentName: agent.name, baseagent: pluginName, message,
211
+ reason: pluginRuntimeReason('CREATE_FAILED', 'create', '基座实例创建失败', error) });
129
212
  logger.error(`✗ Failed to create runner for agent='${agent.name}' baseagent='${pluginName}':`, error);
130
213
  }
131
214
  }
@@ -0,0 +1,26 @@
1
+ import { createHash } from 'node:crypto';
2
+ // Runtime prefill only. Hash the connection so credentials are never used as map keys.
3
+ const models = new Map();
4
+ const pending = new Map();
5
+ export function defaultModelKey(baseagent, connection) {
6
+ return createHash('sha256').update(JSON.stringify({ baseagent, connection })).digest('hex');
7
+ }
8
+ export function getRuntimeBaseagentModelDefault(key) {
9
+ return models.get(key);
10
+ }
11
+ export function clearRuntimeBaseagentModelDefaults() {
12
+ models.clear();
13
+ }
14
+ export function discoverRuntimeBaseagentModelDefault(key, load) {
15
+ const existing = pending.get(key);
16
+ if (existing)
17
+ return existing;
18
+ const discovery = load().then(model => {
19
+ if (models.size >= 128)
20
+ models.delete(models.keys().next().value);
21
+ models.set(key, model);
22
+ return model;
23
+ }).finally(() => pending.delete(key));
24
+ pending.set(key, discovery);
25
+ return discovery;
26
+ }