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
@@ -1,19 +1,24 @@
1
1
  import { spawn } from 'child_process';
2
2
  import readline from 'readline';
3
3
  import { logger } from '../../utils/logger.js';
4
- import { buildHClassGuardCommand, collectSandboxGuardDiagnostics, createCodexSandboxAvailabilityError, inspectCodexSandboxAvailability, probeCodexSandboxAvailability, summarizeBubblewrapArgsForLog, summarizeSandboxGuardDiagnostics, } from '../../core/permission/sandbox-runtime.js';
5
- import { resolveCodexLaunchCommand } from '../baseagent.js';
6
- import { createHash } from 'crypto';
4
+ import { buildHClassGuardCommand, collectSandboxGuardDiagnostics, createCodexSandboxAvailabilityError, createSandboxInitializationError, inspectCodexSandboxAvailability, isWindowsCodexSandboxProvisioningFailure, probeCodexSandboxAvailability, summarizeBubblewrapArgsForLog, summarizeSandboxGuardDiagnostics, } from '../../core/permission/sandbox-runtime.js';
5
+ import { resolveCodexLaunchCommand } from './cli.js';
6
+ import { createHash, randomUUID } from 'crypto';
7
7
  import { sanitizeShellExecutionEnvironment } from '../../core/permission/shell-environment.js';
8
8
  import fs from 'fs';
9
9
  import path from 'path';
10
10
  import { ensureProcessManagedTempDir } from '../../cli/task-context.js';
11
11
  import { getPackageRoot, resolvePaths } from '../../paths.js';
12
12
  import { killProcessAsync } from '../../utils/cross-platform.js';
13
+ import { getExistingSelfAttachmentDirs } from '../../core/permission/protected-paths.js';
13
14
  import { isCurrentManagedHookLauncher } from './diagnostics.js';
14
15
  import { registerCodexAppServerProcess, unregisterCodexAppServerProcess, } from './app-server-registry.js';
15
16
  const BUILT_IN_CODEX_PROVIDER_IDS = new Set(['openai']);
16
17
  export const CODEX_THREAD_ACTIVE_WRITER = 'THREAD_ACTIVE_WRITER';
18
+ const LIFECYCLE_RPC_METHODS = new Set([
19
+ 'thread/start', 'thread/resume', 'thread/unsubscribe', 'thread/archive', 'thread/unarchive',
20
+ 'thread/read', 'thread/loaded/list', 'turn/start', 'turn/interrupt',
21
+ ]);
17
22
  function tomlProviderKey(value) {
18
23
  if (!value || /[\0\r\n]/.test(value)) {
19
24
  throw new Error(`Invalid Codex provider name: ${value}`);
@@ -58,6 +63,9 @@ function hasPermissionProfile(config) {
58
63
  }
59
64
  export class CodexAppServerClient {
60
65
  options;
66
+ diagnosticId = randomUUID();
67
+ closed = false;
68
+ closing = null;
61
69
  proc = null;
62
70
  pending = new Map();
63
71
  serverRequestReplays = new Map();
@@ -86,6 +94,16 @@ export class CodexAppServerClient {
86
94
  this.notificationHandlers.add(handler);
87
95
  return () => this.notificationHandlers.delete(handler);
88
96
  }
97
+ getDiagnosticContext() {
98
+ return { clientId: this.diagnosticId, pid: this.proc?.pid ?? null, agentAid: this.options.selfAid ?? null };
99
+ }
100
+ getStartupDiagnostics() {
101
+ return {
102
+ ...this.getDiagnosticContext(),
103
+ initialized: this.initialized,
104
+ pending: [...this.pending].map(([requestId, { method }]) => ({ requestId, method })),
105
+ };
106
+ }
89
107
  async threadStart(projectPath, options) {
90
108
  const effort = options?.effort ?? this.options.effort;
91
109
  const configUsesPermissionProfile = hasPermissionProfile(options?.config);
@@ -234,6 +252,9 @@ export class CodexAppServerClient {
234
252
  isRunning() {
235
253
  return this.proc !== null;
236
254
  }
255
+ isClosed() {
256
+ return this.closed;
257
+ }
237
258
  async threadLoadedList() {
238
259
  const data = new Set();
239
260
  const cursors = new Set();
@@ -430,9 +451,12 @@ export class CodexAppServerClient {
430
451
  : {}),
431
452
  });
432
453
  }
433
- async close() {
454
+ close() {
455
+ this.closed = true;
456
+ return this.closing ??= this.closeProcess();
457
+ }
458
+ async closeProcess() {
434
459
  const proc = this.proc;
435
- this.proc = null;
436
460
  this.initialized = false;
437
461
  this.initializing = null;
438
462
  for (const pending of this.pending.values()) {
@@ -475,12 +499,24 @@ export class CodexAppServerClient {
475
499
  proc.kill('SIGKILL');
476
500
  }
477
501
  catch { }
502
+ if (timeout)
503
+ clearTimeout(timeout);
504
+ await Promise.race([exit, new Promise(resolve => { timeout = setTimeout(resolve, 5_000); })]);
505
+ if (!exited) {
506
+ throw Object.assign(new Error('Codex app-server process exit could not be confirmed'), {
507
+ code: 'CODEX_PROCESS_EXIT_UNCONFIRMED',
508
+ });
509
+ }
478
510
  }
479
511
  }
480
512
  finally {
481
513
  clearTimeout(timeout);
482
514
  proc.off('exit', onExit);
483
- this.cleanupManagedHookRuntime();
515
+ if (exited) {
516
+ if (this.proc === proc)
517
+ this.proc = null;
518
+ this.cleanupManagedHookRuntime();
519
+ }
484
520
  }
485
521
  }
486
522
  async ensureStarted() {
@@ -551,6 +587,7 @@ export class CodexAppServerClient {
551
587
  const managedRequirements = this.ensureManagedHookRuntime();
552
588
  const guardedCommand = buildHClassGuardCommand(command, commandArgs, guardRoot, {
553
589
  managedCodexRequirements: managedRequirements,
590
+ readonlyPaths: getExistingSelfAttachmentDirs(guardRoot, { selfAid: this.options.selfAid }),
554
591
  protectEvolcoreFilesystem: this.options.protectEvolcoreFilesystem !== false,
555
592
  selfAid: this.options.selfAid,
556
593
  });
@@ -845,6 +882,25 @@ export class CodexAppServerClient {
845
882
  let timer;
846
883
  let requestId;
847
884
  let expired = false;
885
+ const startedAt = Date.now();
886
+ const trace = LIFECYCLE_RPC_METHODS.has(method);
887
+ // Only identifiers and timings are logged, never prompts, tool input,
888
+ // credentials, environment overrides or the complete RPC payload.
889
+ const logLifecycle = (phase, result, errorCode) => {
890
+ if (!trace)
891
+ return;
892
+ const response = result;
893
+ logger.info(`[CodexAppServer] lifecycle ${JSON.stringify({
894
+ phase, ...this.getDiagnosticContext(), method, requestId: requestId ?? null,
895
+ threadId: typeof params?.threadId === 'string' ? params.threadId : response?.thread?.id ?? null,
896
+ turnId: typeof params?.turnId === 'string' ? params.turnId : response?.turn?.id ?? null,
897
+ durationMs: Date.now() - startedAt, pendingRequests: this.pending.size,
898
+ ...(errorCode ? { errorCode } : {}),
899
+ })}`);
900
+ };
901
+ logLifecycle('begin');
902
+ const slowTimer = trace ? setTimeout(() => logLifecycle('slow'), 10_000) : undefined;
903
+ slowTimer?.unref?.();
848
904
  const operation = (async () => {
849
905
  await this.ensureReadyFor(method);
850
906
  if (expired)
@@ -865,6 +921,7 @@ export class CodexAppServerClient {
865
921
  params,
866
922
  stderrStartSequence: this.stderrSequence,
867
923
  });
924
+ logLifecycle('sent');
868
925
  proc.stdin.write(`${JSON.stringify(payload)}\n`, error => {
869
926
  if (!error)
870
927
  return;
@@ -873,10 +930,8 @@ export class CodexAppServerClient {
873
930
  });
874
931
  });
875
932
  })();
876
- if (deadline === undefined)
877
- return operation;
878
933
  try {
879
- return await Promise.race([
934
+ const result = await (deadline === undefined ? operation : Promise.race([
880
935
  operation,
881
936
  new Promise((_, reject) => {
882
937
  timer = setTimeout(() => {
@@ -885,11 +940,20 @@ export class CodexAppServerClient {
885
940
  }, deadline);
886
941
  timer.unref?.();
887
942
  }),
888
- ]);
943
+ ]));
944
+ logLifecycle('succeeded', result);
945
+ return result;
946
+ }
947
+ catch (error) {
948
+ const code = error?.code;
949
+ logLifecycle(expired ? 'deadline' : 'failed', undefined, typeof code === 'string' ? code : undefined);
950
+ throw error;
889
951
  }
890
952
  finally {
891
953
  if (timer)
892
954
  clearTimeout(timer);
955
+ if (slowTimer)
956
+ clearTimeout(slowTimer);
893
957
  if (requestId && expired) {
894
958
  const pending = this.pending.get(requestId);
895
959
  this.pending.delete(requestId);
@@ -924,6 +988,8 @@ export class CodexAppServerClient {
924
988
  this.proc.stdin.write(`${JSON.stringify(payload)}\n`);
925
989
  }
926
990
  async ensureReadyFor(method) {
991
+ if (this.closed)
992
+ throw Object.assign(new Error('Codex app-server client was retired'), { code: 'CODEX_APP_SERVER_RETIRED' });
927
993
  if (method === 'initialize') {
928
994
  if (!this.proc)
929
995
  this.startProcess();
@@ -968,6 +1034,11 @@ export class CodexAppServerClient {
968
1034
  .filter(line => !/could not find bubblewrap on PATH/i.test(line));
969
1035
  const stderr = stderrLines.length ? `\n${stderrLines.join('\n')}` : '';
970
1036
  const error = new Error(`${pending.method} failed: ${detail}${stderr}`);
1037
+ if ((pending.method === 'thread/start' || pending.method === 'thread/resume')
1038
+ && isWindowsCodexSandboxProvisioningFailure(detail)) {
1039
+ pending.reject(createSandboxInitializationError(new Error(`${pending.method} failed: ${detail}`)));
1040
+ return;
1041
+ }
971
1042
  if (/no rollout found for thread id/i.test(detail)) {
972
1043
  error.code = 'CODEX_ROLLOUT_NOT_FOUND';
973
1044
  }
@@ -1032,6 +1103,15 @@ export class CodexAppServerClient {
1032
1103
  });
1033
1104
  }
1034
1105
  emitNotification(notification) {
1106
+ if (['thread/started', 'turn/started', 'turn/completed', 'thread/closed'].includes(notification.method)) {
1107
+ const params = notification.params ?? {};
1108
+ logger.info(`[CodexAppServer] lifecycle ${JSON.stringify({
1109
+ phase: 'notification', ...this.getDiagnosticContext(), method: notification.method,
1110
+ threadId: params.threadId ?? params.thread_id ?? params.thread?.id ?? null,
1111
+ turnId: params.turn?.id ?? params.turnId ?? params.turn_id ?? null,
1112
+ status: params.turn?.status ?? null,
1113
+ })}`);
1114
+ }
1035
1115
  this.resolveSyntheticResponses(notification);
1036
1116
  for (const handler of this.notificationHandlers) {
1037
1117
  try {
@@ -0,0 +1,164 @@
1
+ import { logger } from '../../utils/logger.js';
2
+ import { compareVersions } from '../../utils/npm-ops.js';
3
+ import { probeCli, probeCliSync, CODEX_CLI_PROBE_TIMEOUT_MS, CODEX_CLI_PROBE_RETRY_TIMEOUT_MS } from '../../utils/cross-platform.js';
4
+ import { resolveCodexCliPath, resolveCodexPowerShellShimPath } from './cli.js';
5
+ // The permission bridge is version-locked to the audited approval schema and
6
+ // managed PreToolUse hook behavior used by proactive first-tool enforcement.
7
+ export const MIN_CODEX_CLI_VERSION = '0.144.1';
8
+ export function parseCodexCliVersion(output) {
9
+ const match = output.match(/\b(\d+\.\d+\.\d+(?:[-+][0-9A-Za-z.-]+)?)\b/);
10
+ return match?.[1] ?? null;
11
+ }
12
+ export function isCodexCliVersionSupported(version) {
13
+ return compareVersions(version, MIN_CODEX_CLI_VERSION) >= 0;
14
+ }
15
+ function compactCodexProbeText(value, maxLength = 600) {
16
+ if (Buffer.isBuffer(value))
17
+ value = value.toString('utf-8');
18
+ if (typeof value !== 'string')
19
+ return undefined;
20
+ const text = value.replace(/\s+/gu, ' ').trim();
21
+ return text.length <= maxLength ? text : `${text.slice(0, maxLength - 3).trimEnd()}...`;
22
+ }
23
+ function logCodexProbeFailure(args, startedAt, error, timeoutMs, launch) {
24
+ const detail = error;
25
+ logger.warn(`[CodexProbe] CLI probe failed: ${JSON.stringify({
26
+ command: ['codex', ...args],
27
+ resolvedPath: launch?.resolvedPath ?? null,
28
+ launcherKind: launch?.launcherKind ?? null,
29
+ launcherPath: launch?.launcherPath ?? null,
30
+ path: detail?.path ?? null,
31
+ spawnargs: detail?.spawnargs ?? null,
32
+ elapsedMs: Date.now() - startedAt,
33
+ timeoutMs,
34
+ code: detail?.code ?? null,
35
+ status: detail?.status ?? null,
36
+ signal: detail?.signal ?? null,
37
+ timedOut: detail?.code === 'ETIMEDOUT',
38
+ message: compactCodexProbeText(detail?.message ?? String(error)),
39
+ stdout: compactCodexProbeText(detail?.stdout),
40
+ stderr: compactCodexProbeText(detail?.stderr),
41
+ })}`);
42
+ }
43
+ function probeCodexCli(args, executable) {
44
+ return probeCliSync('codex', args, {
45
+ executable, onFailure: logCodexProbeFailure,
46
+ validateOutput: args[0] === '--version' ? output => parseCodexCliVersion(output) !== null : undefined,
47
+ });
48
+ }
49
+ export function getCodexCliVersion(executable) {
50
+ try {
51
+ return parseCodexCliVersion(probeCodexCli(['--version'], executable));
52
+ }
53
+ catch {
54
+ return null;
55
+ }
56
+ }
57
+ export function getCodexAppServerAvailability() {
58
+ const cliPath = resolveCodexCliPath();
59
+ if (!cliPath) {
60
+ const powershellShim = resolveCodexPowerShellShimPath();
61
+ return {
62
+ available: false,
63
+ reason: powershellShim
64
+ ? '检测到 codex.ps1,但当前 Windows 启动路径要求 codex.exe/codex.cmd/codex.bat;请重新安装 @openai/codex 以恢复 npm shim。'
65
+ : '未检测到 Codex CLI。',
66
+ };
67
+ }
68
+ const version = getCodexCliVersion(cliPath);
69
+ if (!version) {
70
+ return { available: false, reason: '无法读取 Codex CLI 版本。' };
71
+ }
72
+ if (!isCodexCliVersionSupported(version)) {
73
+ return {
74
+ available: false,
75
+ version,
76
+ reason: `Codex CLI ${version} 低于最低要求 ${MIN_CODEX_CLI_VERSION}。请升级 Codex CLI:npm install -g @openai/codex@latest`,
77
+ requiresUpgrade: true,
78
+ };
79
+ }
80
+ try {
81
+ probeCodexCli(['app-server', '--help'], cliPath);
82
+ return { available: true, version };
83
+ }
84
+ catch (error) {
85
+ if (error?.code === 'ETIMEDOUT') {
86
+ return { available: false, version, reason: `Codex CLI ${version} 的 app-server 探测超时,请稍后重试。` };
87
+ }
88
+ return { available: false, version, reason: `Codex CLI ${version} 的 app-server 探测失败,请检查 CLI 启动日志。` };
89
+ }
90
+ }
91
+ export function isCodexAppServerAvailable() {
92
+ return getCodexAppServerAvailability().available;
93
+ }
94
+ /**
95
+ * 启动期可用性探测结果缓存。
96
+ *
97
+ * 每次探测是一次完整的 Codex CLI 启动(Windows 上 0.3-0.45s)。启动时每个 codex
98
+ * agent 都会调一次(21 个 agent 就是 21 次进程启动),并行创建 runner 后会同时抢
99
+ * CPU,反而更慢。这里缓存整个探测的 Promise:并发调用共享同一轮探测,失败结果也
100
+ * 缓存,避免热加载反复重试。
101
+ *
102
+ * 用 TTL 而不是永久缓存:用户可能在 daemon 运行期间升级 Codex CLI,过期的失败结论
103
+ * 不应永久黏住。
104
+ */
105
+ const CODEX_AVAILABILITY_CACHE_TTL_MS = 60_000;
106
+ let codexAvailabilityCache = null;
107
+ /** 让测试与显式刷新(例如安装 Codex 后)能清掉缓存。 */
108
+ export function invalidateCodexAppServerAvailabilityCache() {
109
+ codexAvailabilityCache = null;
110
+ }
111
+ /** Daemon startup/hot reload use asynchronous probes; sync CLI callers share the cache. */
112
+ export async function getCodexAppServerAvailabilityAsync() {
113
+ const now = Date.now();
114
+ if (codexAvailabilityCache && now - codexAvailabilityCache.at < CODEX_AVAILABILITY_CACHE_TTL_MS) {
115
+ return codexAvailabilityCache.promise;
116
+ }
117
+ const promise = probeCodexAppServerAvailabilityAsync();
118
+ codexAvailabilityCache = { at: now, promise };
119
+ // 失败的 Promise 同样要能被后续调用复用,但不能产生未处理拒绝。
120
+ promise.catch(() => { });
121
+ return promise;
122
+ }
123
+ async function probeCodexAppServerAvailabilityAsync() {
124
+ const cliPath = resolveCodexCliPath();
125
+ const options = {
126
+ timeouts: [CODEX_CLI_PROBE_TIMEOUT_MS, CODEX_CLI_PROBE_RETRY_TIMEOUT_MS],
127
+ executable: cliPath ?? undefined,
128
+ onFailure: logCodexProbeFailure,
129
+ };
130
+ if (!cliPath) {
131
+ const powershellShim = resolveCodexPowerShellShimPath();
132
+ return {
133
+ available: false,
134
+ reason: powershellShim
135
+ ? '检测到 codex.ps1,但当前 Windows 启动路径要求 codex.exe/codex.cmd/codex.bat;请重新安装 @openai/codex 以恢复 npm shim。'
136
+ : '未检测到 Codex CLI。',
137
+ };
138
+ }
139
+ let version;
140
+ try {
141
+ // Each probe is a full Codex CLI launch (~0.3-0.45s on Windows). Run the
142
+ // app-server probe concurrently; its result is only consulted after the
143
+ // version gate passes, so the decision order is unchanged.
144
+ const appServerProbe = probeCli('codex', ['app-server', '--help'], options);
145
+ appServerProbe.catch(() => { });
146
+ version = parseCodexCliVersion(await probeCli('codex', ['--version'], {
147
+ ...options, validateOutput: output => parseCodexCliVersion(output) !== null,
148
+ })) ?? undefined;
149
+ if (!version)
150
+ return { available: false, reason: '无法读取 Codex CLI 版本。' };
151
+ if (!isCodexCliVersionSupported(version)) {
152
+ return { available: false, version, requiresUpgrade: true,
153
+ reason: `Codex CLI ${version} 低于最低要求 ${MIN_CODEX_CLI_VERSION}。请升级 Codex CLI:npm install -g @openai/codex@latest` };
154
+ }
155
+ await appServerProbe;
156
+ return { available: true, version };
157
+ }
158
+ catch (error) {
159
+ const detail = error;
160
+ return { available: false, version, reason: detail.code === 'ETIMEDOUT' || detail.killed
161
+ ? 'Codex CLI 探测超时,请稍后重试。'
162
+ : `Codex CLI 探测失败:${error instanceof Error ? error.message : String(error)}` };
163
+ }
164
+ }
@@ -0,0 +1,138 @@
1
+ import os from 'os';
2
+ import path from 'path';
3
+ import { execCodexCli } from './cli.js';
4
+ import { discoverSkillDirectories } from '../../core/capability/skill-discovery.js';
5
+ function discoverSkills(ctx, options) {
6
+ const roots = [
7
+ ...(options?.includeProjectSkills === false ? [] : [
8
+ { dir: path.join(ctx.projectPath, '.codex', 'skills'), source: 'project' },
9
+ ]),
10
+ { dir: path.join(os.homedir(), '.codex', 'skills'), source: 'user' },
11
+ { dir: path.join(os.homedir(), '.codex', 'skills', '.system'), source: 'system' },
12
+ ];
13
+ const seen = new Set();
14
+ const out = [];
15
+ for (const root of roots) {
16
+ for (const skill of discoverSkillDirectories(root.dir)) {
17
+ const { id } = skill;
18
+ if (seen.has(id))
19
+ continue;
20
+ seen.add(id);
21
+ out.push({ id, label: id, desc: skill.description, source: root.source });
22
+ }
23
+ }
24
+ return out;
25
+ }
26
+ async function runCodexJson(args) {
27
+ try {
28
+ const output = await execCodexCli(args, {
29
+ encoding: 'utf-8',
30
+ timeout: 3000,
31
+ });
32
+ return JSON.parse(output);
33
+ }
34
+ catch {
35
+ return null;
36
+ }
37
+ }
38
+ function describeMcpEntry(entry) {
39
+ const command = typeof entry.command === 'string' ? entry.command : undefined;
40
+ if (command)
41
+ return `stdio: ${path.basename(command)}`;
42
+ const rawUrl = typeof entry.url === 'string' ? entry.url : typeof entry.serverUrl === 'string' ? entry.serverUrl : undefined;
43
+ if (!rawUrl)
44
+ return undefined;
45
+ try {
46
+ const url = new URL(rawUrl);
47
+ return `remote: ${url.origin}${url.pathname}`;
48
+ }
49
+ catch {
50
+ return 'remote';
51
+ }
52
+ }
53
+ function normalizeMcpServerConfig(entry) {
54
+ if (!entry || typeof entry !== 'object')
55
+ return undefined;
56
+ const config = {};
57
+ for (const key of [
58
+ 'command',
59
+ 'args',
60
+ 'env',
61
+ 'cwd',
62
+ 'url',
63
+ 'serverUrl',
64
+ 'bearer_token_env_var',
65
+ 'bearerTokenEnvVar',
66
+ 'http_headers',
67
+ 'httpHeaders',
68
+ 'startup_timeout_sec',
69
+ 'startupTimeoutSec',
70
+ 'startup_timeout_ms',
71
+ 'startupTimeoutMs',
72
+ 'enabled_tools',
73
+ 'enabledTools',
74
+ 'disabled_tools',
75
+ 'disabledTools',
76
+ 'tools',
77
+ 'scope',
78
+ 'oauth',
79
+ 'oauth_resource',
80
+ 'oauthResource',
81
+ ]) {
82
+ if (entry[key] !== undefined)
83
+ config[key] = entry[key];
84
+ }
85
+ return Object.keys(config).length > 0 ? config : undefined;
86
+ }
87
+ async function discoverMcp() {
88
+ const parsed = await runCodexJson(['mcp', 'list', '--json']);
89
+ const list = Array.isArray(parsed) ? parsed : Array.isArray(parsed?.servers) ? parsed.servers : [];
90
+ return list.map((entry) => {
91
+ const id = String(entry.name ?? entry.id ?? '').trim();
92
+ if (!id)
93
+ return null;
94
+ return {
95
+ id,
96
+ label: String(entry.label ?? entry.name ?? id),
97
+ desc: describeMcpEntry(entry),
98
+ source: entry.source === 'project' ? 'project' : 'user',
99
+ status: String(entry.status ?? 'configured'),
100
+ runtimeEnabled: entry.enabled !== false,
101
+ data: normalizeMcpServerConfig(entry),
102
+ };
103
+ }).filter(Boolean);
104
+ }
105
+ async function discoverPlugins() {
106
+ const parsed = await runCodexJson(['plugin', 'list', '--json']);
107
+ const installed = Array.isArray(parsed) ? parsed : Array.isArray(parsed?.installed) ? parsed.installed : [];
108
+ return installed.map((entry) => {
109
+ const id = String(entry.id ?? entry.name ?? entry.pluginId ?? '').trim();
110
+ if (!id)
111
+ return null;
112
+ return {
113
+ id,
114
+ label: String(entry.name ?? entry.label ?? id),
115
+ desc: typeof entry.description === 'string' ? entry.description : undefined,
116
+ source: 'plugin',
117
+ status: entry.enabled === false ? 'disabled' : 'installed',
118
+ runtimeEnabled: entry.enabled !== false,
119
+ };
120
+ }).filter(Boolean);
121
+ }
122
+ export class CodexCapabilityProvider {
123
+ baseagent = 'codex';
124
+ getSupport(type) {
125
+ void type;
126
+ return {
127
+ mode: 'inherit',
128
+ canUpdate: true,
129
+ };
130
+ }
131
+ async discover(ctx, type, options) {
132
+ if (type === 'skill')
133
+ return discoverSkills(ctx, options);
134
+ if (type === 'mcp')
135
+ return discoverMcp();
136
+ return discoverPlugins();
137
+ }
138
+ }
@@ -0,0 +1,38 @@
1
+ import { execFile } from 'child_process';
2
+ import { requireTrustedWindowsCmdPathAsync } from '../../utils/windows-shell-trust.js';
3
+ import { buildCliLaunchCommand, isWindows, resolvePowerShellShimPath, resolveProbePath, } from '../../utils/cross-platform.js';
4
+ /** Resolve the installed Codex CLI entrypoint, including npm shims on Windows. */
5
+ export function resolveCodexCliPath() {
6
+ return resolveProbePath('codex');
7
+ }
8
+ /** Return a PS1-only Codex shim for installation diagnostics, never execution. */
9
+ export function resolveCodexPowerShellShimPath() {
10
+ return resolvePowerShellShimPath('codex');
11
+ }
12
+ export function resolveCodexLaunchCommand(args, options = {}) {
13
+ const windows = options.isWindows ?? isWindows;
14
+ const commandPath = options.commandPath !== undefined ? options.commandPath : resolveCodexCliPath();
15
+ if (!commandPath)
16
+ return null;
17
+ return buildCliLaunchCommand(commandPath, args, {
18
+ isWindows: windows,
19
+ comSpec: options.comSpec,
20
+ });
21
+ }
22
+ /** Execute a Codex CLI command without blocking the daemon, including shim trust checks. */
23
+ export async function execCodexCli(args, options) {
24
+ const commandPath = resolveCodexCliPath();
25
+ if (!commandPath)
26
+ throw new Error('Codex CLI not found');
27
+ const resolveWindowsCmd = isWindows && /\.(?:cmd|bat)$/i.test(commandPath)
28
+ ? await requireTrustedWindowsCmdPathAsync().then(cmd => () => cmd, error => () => { throw error; }) : undefined;
29
+ const launchCommand = buildCliLaunchCommand(commandPath, args, { resolveWindowsCmd });
30
+ return new Promise((resolve, reject) => {
31
+ const child = execFile(launchCommand.command, launchCommand.args, {
32
+ ...options,
33
+ windowsHide: isWindows,
34
+ windowsVerbatimArguments: launchCommand.windowsVerbatimArguments,
35
+ }, (error, stdout) => error ? reject(error) : resolve(stdout));
36
+ child.stdin?.end();
37
+ });
38
+ }