evolcore 0.0.50 → 0.0.51

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (448) hide show
  1. package/CHANGELOG.md +39 -2
  2. package/bin/ec-build.mjs +60 -0
  3. package/bin/ecmsg.js +65 -63
  4. package/dist/ability/caller/command.js +24 -15
  5. package/dist/ability/caller/contract.js +24 -9
  6. package/dist/ability/caller/credential-files.js +132 -0
  7. package/dist/ability/caller/daemon.js +32 -7
  8. package/dist/ability/caller/schema-view.js +157 -0
  9. package/dist/ability/caller/service.js +202 -63
  10. package/dist/ability/interop-v1.js +156 -113
  11. package/dist/agent-template/jobs.js +14 -110
  12. package/dist/agent-template/runtime.js +331 -193
  13. package/dist/agent-template/service.js +1029 -1104
  14. package/dist/agent-template/share.js +103 -0
  15. package/dist/agent-template/tool-runner.js +25 -0
  16. package/dist/agent-template/types.js +10 -3
  17. package/dist/agents/claude/availability.js +94 -0
  18. package/dist/agents/claude/capability-provider.js +154 -0
  19. package/dist/agents/claude/index.js +145 -0
  20. package/dist/agents/{claude-runner.js → claude/runner.js} +74 -158
  21. package/dist/agents/claude/session-file-adapter.js +246 -0
  22. package/dist/agents/codex/app-server-client.js +90 -10
  23. package/dist/agents/codex/availability.js +164 -0
  24. package/dist/agents/codex/capability-provider.js +138 -0
  25. package/dist/agents/codex/cli.js +38 -0
  26. package/dist/agents/codex/index.js +345 -0
  27. package/dist/agents/codex/mcp-elicitation.js +135 -0
  28. package/dist/agents/{codex-runner.js → codex/runner.js} +648 -382
  29. package/dist/agents/codex/session-file-adapter.js +834 -0
  30. package/dist/agents/dsh/availability.js +28 -0
  31. package/dist/agents/dsh/capability-provider.js +56 -0
  32. package/dist/agents/dsh/desktop-locations.ps1 +66 -0
  33. package/dist/agents/dsh/desktop-probe.cjs +37 -0
  34. package/dist/agents/dsh/index.js +98 -0
  35. package/dist/agents/dsh/installation.js +400 -0
  36. package/dist/agents/dsh/resources.js +755 -0
  37. package/dist/agents/dsh/runner.js +1183 -0
  38. package/dist/agents/dsh/runtime/README.md +243 -0
  39. package/dist/agents/dsh/runtime/authorization.js +23 -0
  40. package/dist/agents/dsh/runtime/bridge.js +837 -0
  41. package/dist/agents/dsh/runtime/config.js +271 -0
  42. package/dist/agents/dsh/runtime/entry.js +229 -0
  43. package/dist/agents/dsh/runtime/session-inspector.js +340 -0
  44. package/dist/agents/dsh/runtime/tool-policy.js +49 -0
  45. package/dist/agents/dsh/session-file-adapter.js +145 -0
  46. package/dist/agents/ecagent/index.js +215 -0
  47. package/dist/agents/{ecagent-runner.js → ecagent/runner.js} +592 -106
  48. package/dist/agents/ecagent/session-file-adapter.js +134 -0
  49. package/dist/agents/gemini/index.js +55 -10
  50. package/dist/agents/gemini/{gemini-runner.js → runner.js} +4 -9
  51. package/dist/aun/ability-device-routing.js +11 -17
  52. package/dist/aun/aid/agentmd.js +27 -1
  53. package/dist/aun/aid/managed-operation.js +6 -4
  54. package/dist/aun/group/invite-service.js +1 -1
  55. package/dist/aun/menu/client.js +1 -1
  56. package/dist/aun/msg/history.js +1 -1
  57. package/dist/aun/msg/managed-operation.js +93 -21
  58. package/dist/aun/msg/p2p.js +6 -6
  59. package/dist/aun/service-proxy.js +1 -1
  60. package/dist/aun/storage/index.js +242 -0
  61. package/dist/build-identity.json +1 -1
  62. package/dist/channels/aun.js +180 -43
  63. package/dist/channels/daemon.js +3 -2
  64. package/dist/channels/dingtalk.js +1 -1
  65. package/dist/channels/feishu.js +9 -9
  66. package/dist/channels/qqbot.js +1 -1
  67. package/dist/channels/wechat.js +2 -2
  68. package/dist/channels/wecom.js +1 -1
  69. package/dist/{agents/claude-gateway → claude-gateway}/agent-registration.js +13 -13
  70. package/dist/{agents/claude-gateway → claude-gateway}/binding.js +3 -3
  71. package/dist/{agents/claude-gateway → claude-gateway}/inbox.js +1 -1
  72. package/dist/{agents/claude-gateway → claude-gateway}/index.js +2 -2
  73. package/dist/{agents/claude-gateway → claude-gateway}/listing.js +3 -3
  74. package/dist/{agents/claude-gateway → claude-gateway}/router.js +4 -4
  75. package/dist/{agents/claude-gateway → claude-gateway}/sessions.js +2 -2
  76. package/dist/{agents/claude-gateway → claude-gateway}/terminal.js +1 -1
  77. package/dist/{agents/claude-gateway → claude-gateway}/transcript.js +1 -1
  78. package/dist/cli/ability-command.js +8 -5
  79. package/dist/cli/ability-output.js +182 -0
  80. package/dist/cli/agent-command.js +1 -1
  81. package/dist/cli/agent-create.js +123 -42
  82. package/dist/cli/agent-template.js +400 -29
  83. package/dist/cli/agent.js +14 -11
  84. package/dist/cli/aun-commands.js +167 -111
  85. package/dist/cli/daemon-commands.js +38 -8
  86. package/dist/cli/data-command.js +1 -1
  87. package/dist/cli/debug-mode.js +9 -0
  88. package/dist/cli/directory.js +1 -2
  89. package/dist/cli/ecmsg-gateway.js +55 -19
  90. package/dist/cli/fs-command.js +67 -39
  91. package/dist/cli/index.js +25 -11
  92. package/dist/cli/init.js +124 -29
  93. package/dist/cli/managed-command-guard.js +2 -0
  94. package/dist/cli/model.js +1 -1
  95. package/dist/cli/restart-monitor.js +2 -2
  96. package/dist/cli/services-command.js +24 -1
  97. package/dist/cli/skill-command.js +4 -4
  98. package/dist/cli/task-context.js +24 -14
  99. package/dist/cli/team-workspace-command.js +50 -52
  100. package/dist/cli/thread-command.js +3 -2
  101. package/dist/cli/trigger-command.js +47 -12
  102. package/dist/cli/watch-logs.js +2 -1
  103. package/dist/config/boot-log.js +3 -0
  104. package/dist/config/builtin-role-templates.js +1 -1
  105. package/dist/config/config-field-policy.js +10 -6
  106. package/dist/config/config-manager.js +33 -12
  107. package/dist/config/gateway-config.js +21 -37
  108. package/dist/config/invoke-ipc-service.js +1 -1
  109. package/dist/config/owner-config.js +5 -3
  110. package/dist/config/peer-book-store.js +2 -3
  111. package/dist/config/peer-book.js +2 -2
  112. package/dist/config/peer-role-resolver.js +2 -2
  113. package/dist/config/provider-identity-migration.js +24 -105
  114. package/dist/config/provider-ipc-service.js +13 -3
  115. package/dist/config/provider-local-sync.js +4 -1
  116. package/dist/config/provider-menu-request.js +21 -3
  117. package/dist/config/provider-templates.js +1 -1
  118. package/dist/config/providers-config.js +39 -15
  119. package/dist/config/providers-import.js +3 -3
  120. package/dist/config/providers-management.js +74 -99
  121. package/dist/config/schema-migration.js +177 -11
  122. package/dist/config/schema-registry.js +1 -1
  123. package/dist/config-store.js +38 -50
  124. package/dist/core/{agent-application-service.js → agent/agent-application-service.js} +9 -9
  125. package/dist/core/{agent-create-status.js → agent/agent-create-status.js} +112 -4
  126. package/dist/core/{agent-creation-claim.js → agent/agent-creation-claim.js} +3 -3
  127. package/dist/core/{agent-ipc-registration.js → agent/agent-ipc-registration.js} +102 -25
  128. package/dist/core/{agent-reload-coordinator.js → agent/agent-reload-coordinator.js} +61 -1
  129. package/dist/core/{agent-runtime.js → agent/agent-runtime.js} +53 -27
  130. package/dist/core/{evolagent-registry.js → agent/evolagent-registry.js} +12 -12
  131. package/dist/core/{evolagent.js → agent/evolagent.js} +11 -11
  132. package/dist/core/auth/agent-delegation.js +1 -8
  133. package/dist/core/auth/delegation-authorization.js +28 -0
  134. package/dist/core/auth/operation-authorizer.js +7 -4
  135. package/dist/core/auth/operation-catalog.js +34 -5
  136. package/dist/core/baseagent/baseagent-availability.js +197 -0
  137. package/dist/core/baseagent/baseagent-capability-adapter.js +288 -0
  138. package/dist/core/baseagent/baseagent-config-shared.js +56 -0
  139. package/dist/core/baseagent/baseagent-identity.js +68 -0
  140. package/dist/core/{baseagent-loader.js → baseagent/baseagent-loader.js} +62 -6
  141. package/dist/core/baseagent/baseagent-model-defaults.js +26 -0
  142. package/dist/{agents → core/baseagent}/baseagent-plugin-descriptor.js +107 -24
  143. package/dist/core/baseagent/baseagent-plugin-loader.js +367 -0
  144. package/dist/core/baseagent/baseagent.js +157 -0
  145. package/dist/{agents → core/baseagent}/runner-types.js +36 -4
  146. package/dist/core/capability/capability-manager.js +79 -30
  147. package/dist/core/capability/providers/claude-capability-provider.js +2 -154
  148. package/dist/core/capability/providers/codex-capability-provider.js +2 -136
  149. package/dist/core/{channel-loader.js → channel/channel-loader.js} +226 -38
  150. package/dist/core/{channel-runtime.js → channel/channel-runtime.js} +18 -18
  151. package/dist/core/command/agent-control.js +60 -15
  152. package/dist/core/command/agent-template-menu.js +21 -9
  153. package/dist/core/command/agentmd-menu-request.js +19 -8
  154. package/dist/core/command/agentmd-menu.js +14 -5
  155. package/dist/core/command/command-handler.js +127 -57
  156. package/dist/core/command/context-policy-menu.js +122 -0
  157. package/dist/core/command/data-root-resolver.js +157 -20
  158. package/dist/core/command/memory-slash.js +6 -6
  159. package/dist/core/command/menu-catalog.js +80 -20
  160. package/dist/core/command/menu-handler.js +305 -25
  161. package/dist/core/command/menu-protocol.js +42 -8
  162. package/dist/core/command/menu-query-batch.js +9 -5
  163. package/dist/core/command/provider-menu.js +7 -11
  164. package/dist/core/command/role-menu.js +1 -1
  165. package/dist/core/command/skill-slash.js +17 -5
  166. package/dist/core/command/slash-gate.js +2 -4
  167. package/dist/core/command/slash-handler.js +127 -96
  168. package/dist/core/command/team-workspace-team.js +3 -3
  169. package/dist/core/command/topic-slash.js +10 -10
  170. package/dist/core/{daemon-bootstrap.js → daemon/daemon-bootstrap.js} +14 -14
  171. package/dist/core/{daemon-control.js → daemon/daemon-control.js} +46 -20
  172. package/dist/core/{daemon-lifecycle.js → daemon/daemon-lifecycle.js} +15 -15
  173. package/dist/core/{host-snapshot.js → daemon/host-snapshot.js} +3 -3
  174. package/dist/core/{ipc-registration.js → daemon/ipc-registration.js} +98 -38
  175. package/dist/core/{lifecycle-notice.js → daemon/lifecycle-notice.js} +4 -5
  176. package/dist/core/file-integrity/store.js +1 -1
  177. package/dist/core/handoff/ipc-registration.js +3 -3
  178. package/dist/core/handoff/runtime.js +1 -1
  179. package/dist/{agents → core/inference}/request-identity.js +2 -2
  180. package/dist/core/inference/text-inference.js +4 -4
  181. package/dist/core/{bootstrap-messages.js → initialization/bootstrap-messages.js} +10 -10
  182. package/dist/core/{bootstrap-service.js → initialization/bootstrap-service.js} +24 -23
  183. package/dist/core/initialization/service.js +54 -9
  184. package/dist/core/invoke/executors/media.js +1 -1
  185. package/dist/core/invoke/executors/text.js +1 -1
  186. package/dist/core/memory/consolidation-context.js +1 -1
  187. package/dist/core/memory/consolidation-trigger.js +9 -3
  188. package/dist/core/memory/consolidation.js +4 -4
  189. package/dist/core/memory/memory-admin.js +6 -6
  190. package/dist/core/memory/memory-writer.js +1 -1
  191. package/dist/core/memory/relation-idle-monitor.js +1 -1
  192. package/dist/core/message/aun-ipc-sender.js +114 -75
  193. package/dist/core/message/aun-request-registry.js +13 -5
  194. package/dist/core/message/auto-mention-gate.js +1 -1
  195. package/dist/core/message/contact-admission.js +1 -1
  196. package/dist/core/message/im-renderer.js +19 -0
  197. package/dist/core/{interaction-router.js → message/interaction-router.js} +4 -4
  198. package/dist/core/message/items-formatter.js +5 -5
  199. package/dist/core/message/message-admission.js +1 -1
  200. package/dist/core/message/message-bridge.js +135 -54
  201. package/dist/core/message/message-queue.js +83 -4
  202. package/dist/core/message/message-utils.js +1 -1
  203. package/dist/core/message/peer-mode.js +1 -1
  204. package/dist/core/message/response-engine.js +347 -163
  205. package/dist/core/message/send-options.js +9 -6
  206. package/dist/core/message/send-routing.js +45 -109
  207. package/dist/core/message/stream-idle-monitor.js +1 -1
  208. package/dist/core/{data-migration.js → migration/data-migration.js} +29 -1
  209. package/dist/core/model/catalog-service.js +29 -8
  210. package/dist/core/model/model-capabilities.js +88 -0
  211. package/dist/core/model/model-catalog.js +14 -3
  212. package/dist/core/model/model-diagnostics.js +4 -4
  213. package/dist/core/ownership/owner-resolver.js +95 -15
  214. package/dist/core/{pack-auth.js → pack/pack-auth.js} +30 -3
  215. package/dist/core/{pack-install.js → pack/pack-install.js} +95 -17
  216. package/dist/core/permission/approval-gateway.js +9 -18
  217. package/dist/core/permission/ec-command-parser.js +70 -34
  218. package/dist/core/permission/managed-file.js +234 -0
  219. package/dist/core/permission/protected-paths.js +56 -0
  220. package/dist/core/permission/sandbox-runtime.js +267 -3
  221. package/dist/core/permission/session-path-grants.js +1 -1
  222. package/dist/core/permission/shell-environment.js +15 -1
  223. package/dist/core/plugin/plugin-lifecycle.js +442 -0
  224. package/dist/core/session/adapters/claude-session-file-adapter.js +2 -246
  225. package/dist/core/session/adapters/codex-session-file-adapter.js +2 -566
  226. package/dist/core/session/adapters/ecagent-session-file-adapter.js +2 -134
  227. package/dist/core/{background-session → session/background}/session-cleanup.js +2 -2
  228. package/dist/core/{background-session → session/background}/types.js +1 -1
  229. package/dist/core/session/session-file-health.js +2 -272
  230. package/dist/core/session/session-idle-monitor.js +1 -1
  231. package/dist/core/session/session-manager.js +29 -2
  232. package/dist/core/session/session-terminal.js +185 -0
  233. package/dist/core/session/session-title.js +8 -11
  234. package/dist/core/{system-session → session/system}/memory.js +43 -9
  235. package/dist/core/{system-session → session/system}/registry.js +1 -1
  236. package/dist/core/{system-session → session/system}/types.js +1 -1
  237. package/dist/core/skill/index-generator.js +1 -0
  238. package/dist/core/task/task-activity-store.js +112 -0
  239. package/dist/core/task/task-recovery-service.js +2 -2
  240. package/dist/core/thread/ipc-operation.js +2 -2
  241. package/dist/core/thread/thread-operation.js +2 -1
  242. package/dist/core/thread/thread-route.js +5 -3
  243. package/dist/core/thread/thread-service.js +14 -4
  244. package/dist/directory/{owner-directory-admission.js → admission.js} +3 -3
  245. package/dist/directory/{owner-directory-cache.js → cache.js} +90 -8
  246. package/dist/directory/{owner-directory-markdown.js → markdown.js} +2 -2
  247. package/dist/directory/{owner-directory-query-operation.js → query-operation.js} +83 -9
  248. package/dist/directory/{owner-directory-search.js → search.js} +50 -2
  249. package/dist/directory/{owner-directory-store.js → store.js} +2 -2
  250. package/dist/eck/kit-renderer.js +1 -1
  251. package/dist/eck/manifest-engine.js +64 -2
  252. package/dist/eck/message-renderer.js +35 -0
  253. package/dist/ecweb/basic-settings-service.js +9 -3
  254. package/dist/{contracts → ecweb/contracts}/ecweb-service-protocol.js +2 -1
  255. package/dist/ecweb/dsh-native-service.js +413 -0
  256. package/dist/ecweb/providers-service.js +1 -1
  257. package/dist/ecweb/runtime/lifecycle.js +1 -1
  258. package/dist/ecweb/runtime/supervisor.js +1 -1
  259. package/dist/event-center/center-config.js +2 -2
  260. package/dist/event-center/dispatcher.js +1 -1
  261. package/dist/event-center/ipc-operation.js +12 -3
  262. package/dist/event-center/pack-loader.js +2 -2
  263. package/dist/event-center/registry.js +6 -6
  264. package/dist/event-center/runtime.js +2 -2
  265. package/dist/index.js +71 -42
  266. package/dist/ipc.js +103 -10
  267. package/dist/outputs/authorization.js +27 -0
  268. package/dist/outputs/events.js +10 -1
  269. package/dist/outputs/panel-cards.js +960 -0
  270. package/dist/paths.js +12 -0
  271. package/dist/pay/command.js +1 -1
  272. package/dist/pay/runtime.js +18 -10
  273. package/dist/response-system/engines/v1/proactive-flow.js +1 -1
  274. package/dist/services/dispatcher.js +2 -2
  275. package/dist/services/host/main.js +10 -1
  276. package/dist/services/host/protocol.js +9 -2
  277. package/dist/services/host/resident.js +37 -0
  278. package/dist/services/host-client.js +12 -0
  279. package/dist/services/host-recycle.js +8 -3
  280. package/dist/services/host-runtime.js +54 -15
  281. package/dist/services/index.js +83 -19
  282. package/dist/services/ipc-operation.js +303 -38
  283. package/dist/services/pack-manager.js +2 -2
  284. package/dist/services/router.js +43 -3
  285. package/dist/services/script-runner.js +34 -25
  286. package/dist/services/service-payload.js +28 -1
  287. package/dist/services/validation.js +28 -2
  288. package/dist/stats/context-usage.js +110 -0
  289. package/dist/stats/model-resolver.js +103 -17
  290. package/dist/stats/query.js +5 -0
  291. package/dist/trigger/application-service.js +3 -2
  292. package/dist/trigger/authorization.js +36 -33
  293. package/dist/trigger/ipc-service.js +4 -4
  294. package/dist/trigger/local-files.js +8 -176
  295. package/dist/trigger/manager.js +2 -2
  296. package/dist/trigger/parser.js +48 -0
  297. package/dist/trigger/scheduler.js +14 -2
  298. package/dist/trigger/script-executor.js +21 -0
  299. package/dist/trigger/script-sandbox.js +57 -243
  300. package/dist/trigger/system-definitions.js +25 -0
  301. package/dist/trigger/validation.js +1 -1
  302. package/dist/utils/atomic-write.js +88 -1
  303. package/dist/utils/cross-platform.js +4 -42
  304. package/dist/utils/error-dict.json +22 -1
  305. package/dist/utils/error-utils.js +193 -6
  306. package/dist/utils/evolcore-version.js +2 -2
  307. package/dist/utils/host-info.js +1 -1
  308. package/dist/utils/logger.js +3 -1
  309. package/dist/utils/media-cache.js +99 -4
  310. package/dist/utils/startup-trace.js +20 -4
  311. package/dist/utils/welcome.js +64 -20
  312. package/ecagent/README.md +35 -0
  313. package/ecagent/dist/agent-loop.js +80 -30
  314. package/ecagent/dist/harness/env/nodejs.d.ts +16 -0
  315. package/ecagent/dist/harness/env/nodejs.js +49 -20
  316. package/ecagent/dist/harness/messages.js +3 -2
  317. package/ecagent/dist/harness/types.d.ts +1 -0
  318. package/ecagent/dist/runtime/types.d.ts +2 -0
  319. package/ecagent/dist/runtime/utils/validation.d.ts +7 -1
  320. package/ecagent/dist/runtime/utils/validation.js +42 -0
  321. package/ecagent/dist/types.d.ts +2 -0
  322. package/kits/docs/INDEX.md +1 -1
  323. package/kits/docs/channels/feishu.md +1 -1
  324. package/kits/docs/evolcore/INDEX.md +10 -7
  325. package/kits/docs/evolcore/agent-create.md +2 -0
  326. package/kits/docs/evolcore/agent.md +100 -13
  327. package/kits/docs/evolcore/aid.md +19 -3
  328. package/kits/docs/evolcore/config.md +94 -0
  329. package/kits/docs/evolcore/ctl.md +2 -1
  330. package/kits/docs/evolcore/ec-capabilities.md +7 -10
  331. package/kits/docs/evolcore/ecweb-lifecycle.md +5 -1
  332. package/kits/docs/evolcore/event.md +1 -1
  333. package/kits/docs/evolcore/fs.md +49 -3
  334. package/kits/docs/evolcore/group.md +3 -3
  335. package/kits/docs/evolcore/memory-consolidation.md +1 -1
  336. package/kits/docs/evolcore/menu-protocol.md +24 -2
  337. package/kits/docs/evolcore/model.md +9 -1
  338. package/kits/docs/evolcore/msg.md +30 -28
  339. package/kits/docs/evolcore/pay.md +8 -20
  340. package/kits/docs/evolcore/plugin.md +74 -0
  341. package/kits/docs/evolcore/provider.md +8 -2
  342. package/kits/docs/evolcore/rpc.md +2 -2
  343. package/kits/docs/evolcore/skill.md +17 -1
  344. package/kits/docs/evolcore/stats.md +5 -0
  345. package/kits/docs/evolcore/storage.md +22 -0
  346. package/kits/docs/evolcore/thread-chain.md +19 -10
  347. package/kits/docs/evolcore/tool-authorization.md +4 -0
  348. package/kits/docs/evolcore/trigger.md +89 -13
  349. package/kits/docs/identity/AID_PROFILE_SPEC.md +1 -1
  350. package/kits/docs/venues/feishu-group.md +3 -2
  351. package/kits/docs/venues/feishu-private.md +3 -2
  352. package/kits/rules/02-navigation.md +20 -13
  353. package/kits/rules/06-channel.md +18 -2
  354. package/kits/schemas/_meta.json +8 -4
  355. package/kits/schemas/agent-config.schema.23.json +19 -3
  356. package/kits/schemas/agent-config.schema.24.json +986 -0
  357. package/kits/schemas/agent-config.schema.25.json +986 -0
  358. package/kits/schemas/daemon.schema.11.json +487 -0
  359. package/kits/schemas/daemon.schema.12.json +505 -0
  360. package/kits/schemas/defaults.schema.8.json +484 -0
  361. package/kits/schemas/providers.schema.1.json +1 -1
  362. package/kits/schemas/providers.schema.2.json +1 -1
  363. package/kits/schemas/providers.schema.3.json +8 -2
  364. package/kits/skills/.switches.json +4 -0
  365. package/kits/skills/ability/SKILL.md +194 -27
  366. package/kits/skills/ability/STRUCTURE.md +5 -0
  367. package/kits/skills/agent-output-cards/SKILL.md +90 -54
  368. package/kits/skills/agent-output-cards/examples/html-surface.json +11 -0
  369. package/kits/skills/agent-output-cards/examples/meeting-followups.json +16 -0
  370. package/kits/skills/agent-output-cards/examples/meeting-latest.json +24 -0
  371. package/kits/skills/agent-output-cards/examples/project-metrics.json +16 -0
  372. package/kits/skills/agent-output-cards/examples/quick-links.json +18 -0
  373. package/kits/skills/agent-output-cards/examples/surface.html +8 -0
  374. package/kits/skills/agent-template-project/SKILL.md +51 -0
  375. package/kits/skills/agent-template-project/references/01-collect-and-pack.md +174 -0
  376. package/kits/skills/agent-template-project/references/02-upload-and-share.md +109 -0
  377. package/kits/skills/agent-template-project/references/03-download-and-install.md +189 -0
  378. package/kits/skills/agent-template-project/references/04-upgrade-and-recovery.md +74 -0
  379. package/kits/skills/agent-template-project/references/05-publish-to-platform.md +62 -0
  380. package/kits/skills/ec-group/SKILL.md +3 -3
  381. package/kits/skills/ec-group-collaboration/SKILL.md +4 -4
  382. package/kits/skills/ec-identity/SKILL.md +9 -6
  383. package/kits/skills/ec-pay/SKILL.md +163 -41
  384. package/kits/skills/ec-provider/SKILL.md +5 -5
  385. package/kits/skills/ec-service-call/SKILL.md +3 -0
  386. package/kits/skills/ec-skill/SKILL.md +25 -9
  387. package/kits/skills/ec-skill/scripts/cli.mjs +7 -7
  388. package/kits/skills/ec-skill/scripts/skill.mjs +55 -41
  389. package/kits/skills/ec-skill/scripts/template/SKILL.md.tmpl +9 -0
  390. package/kits/skills/ec-trigger/SKILL.md +2 -2
  391. package/kits/skills/personal-assistant/SKILL.md +22 -22
  392. package/kits/skills/personal-assistant/references/03-data-flow-and-gaps.md +1 -1
  393. package/kits/skills/scrapling-article-fetch/SKILL.md +5 -5
  394. package/kits/skills/thread-ops/SKILL.md +19 -9
  395. package/kits/skills/wechat-article-media-download/SKILL.md +2 -2
  396. package/kits/skills/wechat-article-reader/SKILL.md +2 -2
  397. package/kits/templates/system-fragments/commands.md +1 -1
  398. package/kits/templates/system-fragments/personal-assistant.md +2 -2
  399. package/kits/templates/system-fragments/reply.md +14 -9
  400. package/kits/templates/system-fragments/session.md +1 -1
  401. package/kits/templates/system-fragments/thread.md +10 -5
  402. package/package.json +6 -5
  403. package/scripts/agent-template/index.mjs +7 -1
  404. package/scripts/agent-template/inspect.mjs +81 -35
  405. package/scripts/agent-template/overlay.mjs +110 -4
  406. package/scripts/agent-template/shared/common.mjs +36 -4
  407. package/scripts/agent-template/shared/plan.mjs +4 -2
  408. package/scripts/agent-template/shared/service-packs.mjs +104 -0
  409. package/scripts/agent-template/shared/team-schema.json +467 -54
  410. package/scripts/agent-template/shared/template-contract.mjs +70 -68
  411. package/scripts/agent-template/shared/template-package.mjs +153 -36
  412. package/scripts/agent-template/shared/template-runtime.mjs +76 -64
  413. package/scripts/agent-template/shared/template.mjs +11 -46
  414. package/scripts/agent-template/team-pack.mjs +451 -35
  415. package/scripts/agent-template/team-preview.mjs +75 -226
  416. package/scripts/aid-batch/identity-batch.mjs +1 -1
  417. package/dist/agents/baseagent-availability.js +0 -176
  418. package/dist/agents/baseagent-capability-adapter.js +0 -102
  419. package/dist/agents/baseagent-plugin-loader.js +0 -145
  420. package/dist/agents/baseagent.js +0 -816
  421. package/dist/agents/codex/catalog.js +0 -80
  422. package/dist/agents/ecagent-plugin-lazy.js +0 -41
  423. package/dist/agents/tool-time-context.js +0 -55
  424. package/dist/core/legacy-rename.js +0 -41
  425. package/dist/core/plugin-lifecycle.js +0 -137
  426. package/dist/core/rate-window.js +0 -53
  427. package/dist/core/runner-reload-transaction.js +0 -60
  428. package/dist/core/runtime-lock.js +0 -90
  429. package/dist/core/soul.js +0 -66
  430. package/dist/core/system-session/grants.js +0 -40
  431. package/dist/directory/owner-directory-agentmd-sync.js +0 -89
  432. package/dist/directory/owner-directory-request-operation.js +0 -79
  433. package/dist/directory/owner-directory-text.js +0 -60
  434. package/kits/skills/ec-pay/references/pay-cli.md +0 -110
  435. /package/dist/agents/gemini/{gemini-capability-provider.js → capability-provider.js} +0 -0
  436. /package/dist/agents/gemini/{gemini-session-file-adapter.js → session-file-adapter.js} +0 -0
  437. /package/dist/{agents/claude-gateway → claude-gateway}/types.js +0 -0
  438. /package/dist/core/{system-channels.js → channel/system-channels.js} +0 -0
  439. /package/dist/core/{daemon-file-cache.js → daemon/daemon-file-cache.js} +0 -0
  440. /package/dist/core/{event-bus.js → event/event-bus.js} +0 -0
  441. /package/dist/core/{event-catalog.js → event/event-catalog.js} +0 -0
  442. /package/dist/core/{pack-ledger.js → pack/pack-ledger.js} +0 -0
  443. /package/dist/directory/{owner-directory-identity.js → identity.js} +0 -0
  444. /package/dist/directory/{owner-directory-policy.js → policy.js} +0 -0
  445. /package/dist/directory/{owner-directory-remarks.js → remarks.js} +0 -0
  446. /package/dist/directory/{owner-directory-scope.js → scope.js} +0 -0
  447. /package/dist/{contracts → ecweb/contracts}/ecweb-instance.js +0 -0
  448. /package/kits/templates/{bootstrap-welcome.md → bootstrap-intro.md} +0 -0
@@ -0,0 +1,197 @@
1
+ import { normalizeBaseagent } from './baseagent-identity.js';
2
+ import { probeClaudeAvailability, probeClaudeAvailabilityAsync } from '../../agents/claude/availability.js';
3
+ import { getCodexAppServerAvailability, getCodexAppServerAvailabilityAsync } from '../../agents/codex/availability.js';
4
+ import { isGeminiCliAvailable, isGeminiCliAvailableAsync } from '../../agents/gemini/index.js';
5
+ import { baseagentDeclarations, listRuntimePlugins } from '../plugin/plugin-lifecycle.js';
6
+ import { getBaseagentPluginDescriptor, getBaseagentPluginStatuses } from './baseagent-plugin-descriptor.js';
7
+ import { BaseagentCapabilityAdapter } from './baseagent-capability-adapter.js';
8
+ export { resolveBundledClaudeExecutable, probeBundledClaudeVersion, probeBundledClaudeVersionAsync } from '../../agents/claude/availability.js';
9
+ export * from '../../agents/codex/availability.js';
10
+ export const BASEAGENT_CANDIDATES = ['claude', 'codex', 'gemini', 'ecagent'];
11
+ export const AUTO_BASEAGENT_CANDIDATES = ['claude', 'codex', 'gemini'];
12
+ /**
13
+ * Single source of truth for init and ECWeb base-agent probing.
14
+ * Claude/Gemini require an executable; Codex additionally requires a supported
15
+ * CLI with app-server; ecagent is bundled with EvolCore.
16
+ */
17
+ export function detectAvailableBaseagents(codexAvailability) {
18
+ return detectBaseagentDetails(codexAvailability).filter(item => item.detected).map(item => item.id);
19
+ }
20
+ export function detectBaseagentDetails(codexAvailability) {
21
+ const enabled = probeableBaseagents();
22
+ codexAvailability ??= enabled.has('codex') ? getCodexAppServerAvailability() : { available: false };
23
+ const claude = enabled.has('claude') ? probeClaudeAvailability() : { available: false };
24
+ const gemini = enabled.has('gemini') && isGeminiCliAvailable();
25
+ return baseagentDetails(codexAvailability, claude, gemini);
26
+ }
27
+ export async function detectBaseagentDetailsAsync() {
28
+ const enabled = probeableBaseagents();
29
+ const [codex, claude, gemini] = await Promise.all([
30
+ enabled.has('codex') ? getCodexAppServerAvailabilityAsync() : Promise.resolve({ available: false }),
31
+ enabled.has('claude') ? probeClaudeAvailabilityAsync() : Promise.resolve({ available: false }),
32
+ enabled.has('gemini') ? isGeminiCliAvailableAsync() : Promise.resolve(false),
33
+ ]);
34
+ return baseagentDetails(codex, claude, gemini);
35
+ }
36
+ function probeableBaseagents() {
37
+ const statuses = new Map(getBaseagentPluginStatuses().map(item => [item.baseagent, item]));
38
+ return new Set(Object.entries(baseagentDeclarations()).filter(([name, flag]) => flag?.enabled === true
39
+ && getBaseagentPluginDescriptor(name) && statuses.get(name)?.enabled
40
+ && statuses.get(name)?.status !== 'failed' && statuses.get(name)?.reason?.code !== 'ENVIRONMENT_UNSUPPORTED')
41
+ .map(([name]) => name));
42
+ }
43
+ /** Native dependency probes also back the package descriptors. */
44
+ export function probeBuiltinBaseagent(name) {
45
+ return name === 'codex' ? getCodexAppServerAvailability() : probeClaudeAvailability();
46
+ }
47
+ function baseagentDetails(codexAvailability, claude, gemini) {
48
+ const plugins = new Map(getBaseagentPluginStatuses().map(status => [status.baseagent, status]));
49
+ const native = new Map([
50
+ ['claude', claude],
51
+ ['codex', codexAvailability], ['gemini', { available: gemini, reason: '未检测到 Gemini CLI' }],
52
+ ]);
53
+ return Object.entries(baseagentDeclarations()).map(([id, declaration]) => {
54
+ const status = plugins.get(id);
55
+ const descriptor = getBaseagentPluginDescriptor(id);
56
+ if (declaration?.enabled !== true || !status?.enabled || !descriptor
57
+ || status.status === 'failed' || status.reason?.code === 'ENVIRONMENT_UNSUPPORTED') {
58
+ return { id, detected: false, detectionSource: [], reason: declaration?.enabled !== true
59
+ ? '基座已在 daemon 配置中禁用' : status?.reason?.detail ?? status?.reason?.message ?? '基座尚未通过入口准入,请重启宿主' };
60
+ }
61
+ try {
62
+ const probe = native.get(id) ?? descriptor.probe();
63
+ return { id, detected: probe.available, detectionSource: probe.available ? ['plugin probe'] : [],
64
+ version: probe.version, reason: probe.available ? undefined : probe.reason ?? '基座依赖不可用' };
65
+ }
66
+ catch (error) {
67
+ return { id, detected: false, detectionSource: [], reason: String(error) };
68
+ }
69
+ });
70
+ }
71
+ /** Currently loaded runners only; configured on-demand choices are provided separately. */
72
+ export function loadedBaseagentIds(keys, owner) {
73
+ const result = new Set();
74
+ for (const key of keys) {
75
+ if (owner !== undefined && !key.startsWith(`${owner}::`))
76
+ continue;
77
+ const separator = key.indexOf('::');
78
+ result.add(separator < 0 ? key : key.slice(separator + 2));
79
+ }
80
+ return [...result];
81
+ }
82
+ function canonical(value) {
83
+ if (typeof value !== 'string')
84
+ return null;
85
+ const id = normalizeBaseagent(value).canonical;
86
+ return id === 'unknown' ? null : id;
87
+ }
88
+ function record(value) {
89
+ return value && typeof value === 'object' && !Array.isArray(value) ? value : {};
90
+ }
91
+ function text(value) {
92
+ return typeof value === 'string' && value.trim() ? value : null;
93
+ }
94
+ /** Safe public projection: credentials and arbitrary backend settings never leave this boundary. */
95
+ export function buildBaseagentSnapshot(config, detections, loaded, installations = [], contexts = {}) {
96
+ const blocks = new Map();
97
+ for (const [name, value] of Object.entries(record(config.baseagents))) {
98
+ const id = canonical(name) ?? name;
99
+ blocks.set(id, record(value));
100
+ }
101
+ const active = canonical(config.active_baseagent) ?? text(config.active_baseagent);
102
+ const probes = new Map((detections ?? []).map(item => [String(item.id), item]));
103
+ const inventory = new Map(installations.map(item => [item.id, item]));
104
+ const loadedIds = loaded === undefined ? null : new Set(loaded);
105
+ const declarations = baseagentDeclarations();
106
+ const plugins = new Map(getBaseagentPluginStatuses().map(status => [status.baseagent, status]));
107
+ const runtimePlugins = new Map(listRuntimePlugins().filter(item => item.kind === 'baseagent').map(item => [item.name, item]));
108
+ const ids = new Set([
109
+ ...blocks.keys(),
110
+ ...(detections ?? []).map(item => item.id),
111
+ ...(loaded ?? []),
112
+ ...(active ? [active] : []),
113
+ ...plugins.keys(),
114
+ ...installations.filter(item => item.installed).map(item => item.id),
115
+ ]);
116
+ return {
117
+ active,
118
+ baseagents: [...ids].map(id => {
119
+ const descriptor = getBaseagentPluginDescriptor(id);
120
+ const capabilities = descriptor && new BaseagentCapabilityAdapter(descriptor);
121
+ const status = plugins.get(id) ?? (declarations[id] ? {
122
+ baseagent: id, discovered: true, enabled: declarations[id].enabled === true,
123
+ registered: false, status: declarations[id].enabled ? 'discovered' : 'disabled',
124
+ } : undefined);
125
+ const installation = inventory.get(id);
126
+ const force = declarations[id]?.force === true;
127
+ const forced = runtimePlugins.get(id)?.force === true;
128
+ const capabilityContext = { ...contexts[id],
129
+ modelChecked: true,
130
+ requireImplementationCheck: true,
131
+ backendVersion: installation?.version ?? probes.get(id)?.version ?? contexts[id]?.backendVersion,
132
+ ...(declarations[id]?.enabled === false ? { enabled: false } : {}),
133
+ ...(!declarations[id] || installation?.compatible === false
134
+ || (declarations[id]?.enabled === true && ((status && status.status !== 'loaded')
135
+ || probes.get(id)?.detected === false))
136
+ ? { runtime: { available: false, reason: installation?.reason || status?.reason?.message
137
+ || probes.get(id)?.reason || (!declarations[id] ? '基座未在 daemon 配置中声明' : '基座尚未通过运行准入,请检查配置或重启宿主') } }
138
+ : {}),
139
+ };
140
+ return {
141
+ id,
142
+ label: installation?.label ?? normalizeBaseagent(id).displayName,
143
+ configured: blocks.has(id),
144
+ detected: detections === null ? null : probes.get(id)?.detected === true,
145
+ declared: Object.hasOwn(declarations, id),
146
+ ...(installation ? { installation: { installed: installation.installed, compatible: installation.compatible,
147
+ version: installation.version, installationPath: installation.installationPath, reason: installation.reason } } : {}),
148
+ loaded: loadedIds?.has(id) ?? null,
149
+ active: id === active,
150
+ model: text(blocks.get(id)?.model),
151
+ effort: text(blocks.get(id)?.effort ?? blocks.get(id)?.reasoning),
152
+ version: installation?.version ?? probes.get(id)?.version ?? null,
153
+ detectionSource: probes.get(id)?.detectionSource ?? [],
154
+ ...(!declarations[id] ? { reason: '基座未在 daemon 配置中声明' }
155
+ : probes.get(id)?.reason ? { reason: probes.get(id).reason } : {}),
156
+ ...(status ? { plugin: { ...status, force, forced,
157
+ warnings: runtimePlugins.get(id)?.warnings,
158
+ restartRequired: !runtimePlugins.has(id) || (declarations[id]?.enabled === true) !== status.enabled || force !== forced } } : {}),
159
+ ...(capabilities ? { capabilities: capabilities.listStatuses(capabilityContext) } : {}),
160
+ };
161
+ }),
162
+ };
163
+ }
164
+ /** Shared defaults/Agent inventory for menu, slash and local history readers. */
165
+ export async function getBaseagentSnapshot(options = {}) {
166
+ let config = options.config;
167
+ if (config === undefined) {
168
+ const { read, ConfigTarget } = await import('../../config/config-manager.js');
169
+ config = read(ConfigTarget.Defaults, undefined, { cache: false }) ?? {};
170
+ }
171
+ const contexts = {};
172
+ const { peekRunnerCatalog, resolveCatalogModel } = await import('../model/model-catalog.js');
173
+ for (const [name, block] of Object.entries(record(config?.baseagents))) {
174
+ const id = canonical(name) ?? name;
175
+ const model = text(record(block).model);
176
+ const context = { runner: options.runners?.[id], modelChecked: true };
177
+ if (model) {
178
+ context.model = { id: model };
179
+ try {
180
+ const catalog = peekRunnerCatalog(id, text(config?.aid) ?? undefined, {});
181
+ const entry = catalog.models.find(item => item.id === resolveCatalogModel(catalog, model));
182
+ if (entry)
183
+ context.model = { id: model, imageIn: entry.imageIn, reasoningLevels: entry.reasoningLevels };
184
+ }
185
+ catch { /* A missing/unreadable catalog remains explicit unknown modality metadata. */ }
186
+ }
187
+ contexts[id] = context;
188
+ }
189
+ for (const [id, runner] of Object.entries(options.runners ?? {})) {
190
+ (contexts[id] ??= { modelChecked: true }).runner = runner;
191
+ }
192
+ if (options.probe === false)
193
+ return buildBaseagentSnapshot(config ?? {}, null, options.loaded, [], contexts);
194
+ const { scanBaseagentInstallations } = await import('./baseagent-plugin-loader.js');
195
+ const [detections, installations] = await Promise.all([detectBaseagentDetailsAsync(), scanBaseagentInstallations()]);
196
+ return buildBaseagentSnapshot(config ?? {}, detections, options.loaded, installations, contexts);
197
+ }
@@ -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
+ }