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,345 @@
1
+ /** Codex deployment metadata; native session and provider behavior stay in the existing runner. */
2
+ import { loadSchema } from '../../config/schema-registry.js';
3
+ import { getCodexAppServerAvailability } from './availability.js';
4
+ import { lazyAgentPlugin } from '../../core/baseagent/baseagent-plugin-descriptor.js';
5
+ import { CodexSessionFileAdapter } from './session-file-adapter.js';
6
+ import { CodexCapabilityProvider } from './capability-provider.js';
7
+ import fs from 'fs';
8
+ import path from 'path';
9
+ import os from 'os';
10
+ import { parse as parseToml } from 'smol-toml';
11
+ import { providerModelEnabled, resolveProviderService, resolveProviderServiceForBaseagent } from '../../config/providers.js';
12
+ import { directInferencePair, nonEmptyString, normalizeRequestMetadata, normalizeStringMap, NativeConnectionIncompleteError, } from '../../core/baseagent/baseagent-config-shared.js';
13
+ import { defaultModelKey, getRuntimeBaseagentModelDefault, } from '../../core/baseagent/baseagent-model-defaults.js';
14
+ export default {
15
+ kind: 'baseagent', apiVersion: 1, version: '1.0.0', hostApi: '^1.0.0', executionContract: 'host-runner-1',
16
+ name: 'codex', displayName: 'Codex', aliases: ['codex-cli', 'codex cli'],
17
+ configSchema: loadSchema('agent-config').raw.properties.baseagents.properties.codex,
18
+ probe: getCodexAppServerAvailability,
19
+ environments: ['linux', 'darwin', 'win32'].map(os => ({ os, probedWith: { cli: 'Existing Host adapter; live platform acceptance remains separate', at: '2026-11-18T00:00:00Z' } })),
20
+ declaredCapabilities: [...['B12', 'C04', 'C07', 'C10', 'C11', 'C25', 'C26', 'X01', 'X02', 'X03', 'X04', 'X05', 'X07'].map(id => ({
21
+ id, level: id.startsWith('X') && id !== 'X07' ? 'X' : 'C',
22
+ implementation: 'adapted', availability: 'available', verification: 'verified',
23
+ })), { id: 'C12', level: 'C', implementation: 'unsupported',
24
+ availability: 'unavailable', verification: 'verified',
25
+ notes: 'Current app-server turn/start and compact interfaces expose none of maxOutputTokens, temperature, topP or stop. Every supplied inference parameter is rejected before startup; effort remains C11.' }],
26
+ createRunner: () => lazyAgentPlugin('codex', async () => new (await import('./runner.js')).CodexAgentPlugin()),
27
+ createSessionAdapter: () => new CodexSessionFileAdapter(),
28
+ createCapabilityProvider: () => new CodexCapabilityProvider(),
29
+ };
30
+ export const DEFAULT_CODEX_MODEL = 'gpt-6.1-terra';
31
+ async function cliModels() {
32
+ const { resolveCodexLaunchCommand } = await import('./cli.js');
33
+ const { execFile } = await import('node:child_process');
34
+ const { parseModelList } = await import('../../core/model/catalog-service.js');
35
+ const launch = resolveCodexLaunchCommand(['debug', 'models']);
36
+ if (!launch)
37
+ return null;
38
+ return new Promise(resolve => {
39
+ execFile(launch.command, launch.args, {
40
+ timeout: 3000,
41
+ windowsHide: true,
42
+ windowsVerbatimArguments: launch.windowsVerbatimArguments,
43
+ maxBuffer: 16 * 1024 * 1024,
44
+ encoding: 'utf8',
45
+ }, (error, stdout) => {
46
+ try {
47
+ if (error)
48
+ return resolve(null);
49
+ const json = JSON.parse(stdout);
50
+ if (!Array.isArray(json?.models))
51
+ return resolve(null);
52
+ resolve(parseModelList(json.models.filter((model) => model.visibility === 'list'))
53
+ .map(model => ({ ...model, verification: 'unverified' })));
54
+ }
55
+ catch {
56
+ resolve(null);
57
+ }
58
+ });
59
+ });
60
+ }
61
+ /** A catalog-only client uses the same transport configuration as inference. */
62
+ export async function codexNativeCatalog(context, options = {}) {
63
+ if (context.baseagent !== 'codex')
64
+ return null;
65
+ const { CodexAppServerClient } = await import('./app-server-client.js');
66
+ const { catalogHash, parseModelList } = await import('../../core/model/catalog-service.js');
67
+ const client = new CodexAppServerClient({
68
+ apiKey: context.apiKey ?? '', authType: context.authType, baseUrl: context.baseUrl,
69
+ provider: context.providerId ? `evolcore_registry_${catalogHash(context.providerId).slice(0, 20)}` : context.provider,
70
+ isolatedProvider: context.providerId !== undefined,
71
+ headers: context.headers, queryParams: context.queryParams,
72
+ });
73
+ let timer;
74
+ let expired = false;
75
+ try {
76
+ return await Promise.race([
77
+ (async () => {
78
+ const models = [];
79
+ const seen = new Set();
80
+ let cursor;
81
+ do {
82
+ const page = await client.modelList(false, cursor);
83
+ if (expired)
84
+ throw new Error('Model catalog timeout');
85
+ if (!Array.isArray(page.data))
86
+ throw new Error('Invalid native model list');
87
+ models.push(...parseModelList(page.data.filter(model => !model.hidden && model.enabled !== false)));
88
+ cursor = page.nextCursor || undefined;
89
+ if (cursor && (seen.has(cursor) || seen.size >= 100))
90
+ throw new Error('Invalid native model pagination');
91
+ if (cursor)
92
+ seen.add(cursor);
93
+ } while (cursor);
94
+ return [...new Map(models.map(model => [model.id, model])).values()];
95
+ })(),
96
+ new Promise((_, reject) => { timer = setTimeout(() => { expired = true; reject(new Error('Model catalog timeout')); }, 5000); }),
97
+ ]);
98
+ }
99
+ catch {
100
+ if (options.allowCliFallback === false)
101
+ return null;
102
+ // The host CLI catalog has no guarantee of matching this Agent connection.
103
+ // It is useful metadata/suggestions and always remains unverified.
104
+ return await cliModels();
105
+ }
106
+ finally {
107
+ if (timer)
108
+ clearTimeout(timer);
109
+ await client.close();
110
+ }
111
+ }
112
+ function recordValue(value) {
113
+ return value && typeof value === 'object' && !Array.isArray(value)
114
+ ? value
115
+ : undefined;
116
+ }
117
+ function resolveCodexConfigHome(options = {}) {
118
+ const configuredHome = options.codexHome || process.env.CODEX_HOME?.trim();
119
+ if (configuredHome)
120
+ return path.resolve(configuredHome);
121
+ const home = options.home ? path.resolve(options.home) : os.homedir();
122
+ return path.join(home, '.codex');
123
+ }
124
+ function readCodexConfig(file) {
125
+ try {
126
+ return recordValue(parseToml(fs.readFileSync(file, 'utf8')));
127
+ }
128
+ catch {
129
+ return undefined;
130
+ }
131
+ }
132
+ export function loadCodexSettings() {
133
+ const codexHome = resolveCodexConfigHome();
134
+ const authPath = path.join(codexHome, 'auth.json');
135
+ const configPath = path.join(codexHome, 'config.toml');
136
+ let authJsonApiKey;
137
+ try {
138
+ if (fs.existsSync(authPath)) {
139
+ const auth = JSON.parse(fs.readFileSync(authPath, 'utf-8'));
140
+ authJsonApiKey = nonEmptyString(auth?.OPENAI_API_KEY);
141
+ }
142
+ }
143
+ catch {
144
+ // A corrupt auth.json must not prevent the provider config from loading.
145
+ }
146
+ const parsed = readCodexConfig(configPath);
147
+ const model = nonEmptyString(parsed?.model);
148
+ const effort = nonEmptyString(parsed?.model_reasoning_effort);
149
+ const provider = nonEmptyString(parsed?.model_provider);
150
+ const providers = recordValue(parsed?.model_providers);
151
+ const selectedProvider = provider ? recordValue(providers?.[provider]) : undefined;
152
+ const baseUrl = nonEmptyString(selectedProvider?.base_url);
153
+ const bearerToken = nonEmptyString(selectedProvider?.experimental_bearer_token);
154
+ const requiresOpenaiAuth = typeof selectedProvider?.requires_openai_auth === 'boolean'
155
+ ? selectedProvider.requires_openai_auth : undefined;
156
+ // Codex applies a provider's explicit bearer token before auth.json. Keep
157
+ // that precedence so EvolCore and the app-server select the same identity.
158
+ if (bearerToken) {
159
+ return {
160
+ apiKey: bearerToken,
161
+ authType: 'bearerToken',
162
+ authSource: 'config.toml',
163
+ baseUrl,
164
+ model,
165
+ effort,
166
+ provider,
167
+ requiresOpenaiAuth,
168
+ };
169
+ }
170
+ if (authJsonApiKey) {
171
+ return {
172
+ apiKey: authJsonApiKey,
173
+ authType: 'apiKey',
174
+ authSource: 'auth.json',
175
+ baseUrl,
176
+ model,
177
+ effort,
178
+ provider,
179
+ requiresOpenaiAuth,
180
+ };
181
+ }
182
+ return { baseUrl, model, effort, provider, requiresOpenaiAuth };
183
+ }
184
+ export function resolveCodexLegacyModelSelection(options = {}) {
185
+ const file = path.join(resolveCodexConfigHome(options), 'config.toml');
186
+ const parsed = readCodexConfig(file);
187
+ const model = nonEmptyString(parsed?.model);
188
+ const effort = nonEmptyString(parsed?.model_reasoning_effort);
189
+ return { model: model ?? DEFAULT_CODEX_MODEL,
190
+ ...(model ? { modelPath: file } : {}),
191
+ ...(effort ? { effort, effortPath: file } : {}) };
192
+ }
193
+ export function codexDefaultModelKey(configured) {
194
+ const connection = configured?.provider !== undefined
195
+ ? resolveProviderServiceForBaseagent(configured.provider, 'codex')
196
+ : {
197
+ apiKey: configured?.apiKey, baseUrl: configured?.baseUrl,
198
+ headers: configured?.headers, queryParams: configured?.queryParams,
199
+ settings: loadCodexSettings(),
200
+ codexHome: process.env.CODEX_HOME || path.join(os.homedir(), '.codex'),
201
+ openaiApiKey: process.env.OPENAI_API_KEY, codexApiKey: process.env.CODEX_API_KEY,
202
+ openaiBaseUrl: process.env.OPENAI_BASE_URL,
203
+ };
204
+ return defaultModelKey('codex', connection);
205
+ }
206
+ export async function discoverCodexDefaultModel(configured) {
207
+ const override = configured;
208
+ const connection = resolveOpenaiConfig({ agents: { codex: override } }, override);
209
+ const provider = connection.providerId ? resolveProviderServiceForBaseagent(connection.providerId, 'codex') : undefined;
210
+ const models = provider?.modelPolicy === 'manual'
211
+ ? (await (await import('../../core/model/model-catalog.js')).getProviderCatalog(provider.providerId, 'codex')).models
212
+ : await codexNativeCatalog({ ...connection, scope: '<runtime-default>', baseagent: 'codex' }, { allowCliFallback: false });
213
+ return models?.find(item => (item.verification === 'listed' || provider?.modelPolicy === 'manual')
214
+ && /^gpt.*terra/iu.test(item.id) && providerModelEnabled(item.id, provider?.modelOverrides, provider?.modelPolicy)
215
+ && item.supportsTools !== false)?.id;
216
+ }
217
+ /**
218
+ * Resolve a complete credential/endpoint pair for direct OpenAI HTTP calls.
219
+ * auth.json and config.toml together form the Codex SDK source; fields are
220
+ * never combined with a partial Agent or process-environment configuration.
221
+ */
222
+ export function resolveOpenaiDirectConfig(override) {
223
+ if (override?.provider !== undefined) {
224
+ const provider = resolveProviderService(override.provider, 'codex');
225
+ if (!provider.apiKey)
226
+ throw new Error(`Provider ${provider.providerId} has no API key`);
227
+ return { ...provider, apiKey: provider.apiKey };
228
+ }
229
+ const explicit = directInferencePair(override?.apiKey, override?.baseUrl);
230
+ if (explicit) {
231
+ return {
232
+ ...explicit,
233
+ ...normalizeRequestMetadata(override),
234
+ };
235
+ }
236
+ const settings = loadCodexSettings();
237
+ const configuredBearer = settings.authType === 'bearerToken'
238
+ ? directInferencePair(settings.apiKey, settings.baseUrl)
239
+ : undefined;
240
+ if (configuredBearer) {
241
+ return {
242
+ ...configuredBearer,
243
+ ...normalizeRequestMetadata(override),
244
+ };
245
+ }
246
+ const environment = directInferencePair(process.env.OPENAI_API_KEY || process.env.CODEX_API_KEY, process.env.OPENAI_BASE_URL);
247
+ if (environment) {
248
+ return {
249
+ ...environment,
250
+ ...normalizeRequestMetadata(override),
251
+ };
252
+ }
253
+ const settingsResolved = directInferencePair(settings.apiKey, settings.baseUrl);
254
+ return settingsResolved
255
+ ? {
256
+ ...settingsResolved,
257
+ ...normalizeRequestMetadata(override),
258
+ }
259
+ : undefined;
260
+ }
261
+ export function resolveOpenaiConfig(config, override, runtime) {
262
+ const codexSettings = loadCodexSettings();
263
+ const providerId = override?.provider ?? config.agents?.codex?.provider;
264
+ if (providerId !== undefined) {
265
+ const provider = resolveProviderService(providerId, 'codex');
266
+ if (!provider.apiKey)
267
+ throw new Error(`Provider ${providerId} has no API key`);
268
+ return {
269
+ apiKey: provider.apiKey,
270
+ authType: 'apiKey',
271
+ authSource: 'agent-config',
272
+ baseUrl: provider.baseUrl,
273
+ provider: provider.providerId,
274
+ providerId: provider.providerId,
275
+ headers: provider.headers,
276
+ queryParams: provider.queryParams,
277
+ model: override?.model || config.agents?.codex?.model || codexSettings.model
278
+ || getRuntimeBaseagentModelDefault(codexDefaultModelKey({ ...config.agents?.codex, ...override })) || '',
279
+ effort: override?.effort || override?.reasoning || config.agents?.codex?.effort || codexSettings.effort || undefined,
280
+ enableRequestUserInput: override?.enableRequestUserInput ?? config.agents?.codex?.enableRequestUserInput ?? true,
281
+ agentAid: runtime?.agentAid,
282
+ agentConfig: runtime?.agentConfig,
283
+ };
284
+ }
285
+ const isPlaceholder = (v) => !v || v.includes('your-') || v.includes('placeholder');
286
+ const overrideApiKey = isPlaceholder(override?.apiKey) ? undefined : override?.apiKey;
287
+ const environmentApiKey = [process.env.OPENAI_API_KEY, process.env.CODEX_API_KEY]
288
+ .map(value => isPlaceholder(value) ? undefined : value)
289
+ .find((value) => !!value);
290
+ const configuredBearer = codexSettings.authType === 'bearerToken' ? codexSettings.apiKey : undefined;
291
+ const storedApiKey = codexSettings.authType === 'apiKey' ? codexSettings.apiKey : undefined;
292
+ // A selected provider's explicit token is authoritative for that provider.
293
+ // OPENAI_API_KEY is not used by Codex when the provider declares its own
294
+ // bearer token, so choosing it here would make EvolCore and app-server use
295
+ // different credentials.
296
+ const credential = overrideApiKey
297
+ ? { apiKey: overrideApiKey, authType: 'apiKey', authSource: 'agent-config' }
298
+ : configuredBearer
299
+ ? { apiKey: configuredBearer, authType: 'bearerToken', authSource: 'config.toml' }
300
+ : environmentApiKey
301
+ ? { apiKey: environmentApiKey, authType: 'apiKey', authSource: 'environment' }
302
+ : storedApiKey
303
+ ? { apiKey: storedApiKey, authType: 'apiKey', authSource: 'auth.json' }
304
+ : undefined;
305
+ const apiKey = credential?.apiKey;
306
+ const authType = credential?.authType;
307
+ const authSource = credential?.authSource;
308
+ const isPlaceholderUrl = (v) => !v || v.includes('api.openai.com');
309
+ const overrideBaseUrl = isPlaceholderUrl(override?.baseUrl) ? undefined : override?.baseUrl;
310
+ const baseUrl = overrideBaseUrl
311
+ || process.env.OPENAI_BASE_URL
312
+ || codexSettings.baseUrl
313
+ || undefined;
314
+ const headers = normalizeStringMap(override?.headers, 'headers');
315
+ const queryParams = normalizeStringMap(override?.queryParams, 'queryParams');
316
+ if (!apiKey)
317
+ throw new NativeConnectionIncompleteError('No Codex credential found. Select a Provider via baseagents.codex.provider, or set env OPENAI_API_KEY / CODEX_API_KEY.', { baseUrl, headers, queryParams });
318
+ const model = override?.model
319
+ || config.agents?.codex?.model
320
+ || codexSettings.model
321
+ || getRuntimeBaseagentModelDefault(codexDefaultModelKey({ ...config.agents?.codex, ...override })) || '';
322
+ const effort = override?.effort
323
+ || override?.reasoning
324
+ || config.agents?.codex?.effort
325
+ || config.agents?.codex?.reasoning
326
+ || codexSettings.effort
327
+ || undefined;
328
+ const enableRequestUserInput = override?.enableRequestUserInput
329
+ ?? config.agents?.codex?.enableRequestUserInput
330
+ ?? true;
331
+ return {
332
+ apiKey,
333
+ authType,
334
+ authSource,
335
+ baseUrl,
336
+ provider: codexSettings.provider,
337
+ headers,
338
+ queryParams,
339
+ model,
340
+ effort,
341
+ enableRequestUserInput,
342
+ agentAid: runtime?.agentAid,
343
+ agentConfig: runtime?.agentConfig,
344
+ };
345
+ }
@@ -0,0 +1,135 @@
1
+ import { randomUUID } from 'node:crypto';
2
+ import { renderActionAsText } from '../../core/message/interaction-router.js';
3
+ import { buildEnvelope, isInteractionSendAccepted, sendInteractionPayload } from '../../core/message/message-utils.js';
4
+ export function cancelledMcpElicitation() {
5
+ return { action: 'cancel', content: null, _meta: null };
6
+ }
7
+ /** Bridge empty MCP confirmation forms, including Codex's form-mode aliases. */
8
+ export function parseMcpConfirmation(params) {
9
+ if (params.mode !== undefined && !['form', 'openai/form', 'openaiForm'].includes(params.mode))
10
+ return undefined;
11
+ const schema = params.requestedSchema;
12
+ if (typeof params.message !== 'string' || !params.message.trim()
13
+ || !schema || schema.type !== 'object' || !schema.properties
14
+ || typeof schema.properties !== 'object' || Array.isArray(schema.properties)
15
+ || Object.keys(schema.properties).length !== 0
16
+ || (schema.required !== undefined && (!Array.isArray(schema.required) || schema.required.length !== 0)))
17
+ return undefined;
18
+ return { message: params.message };
19
+ }
20
+ /** Register before sending: a fast card reply must never race handler registration. */
21
+ export async function collectMcpConfirmation(input) {
22
+ const { context, signal, isCurrent } = input;
23
+ const router = context.interactionRouter;
24
+ const channelKey = context.adapter?.channelKey ?? context.channel;
25
+ const sendPrompt = context.sendPrompt;
26
+ if (!router || !context.userId || !channelKey || !context.channelId
27
+ || (!context.adapter && !sendPrompt) || signal.aborted || !isCurrent())
28
+ return cancelledMcpElicitation();
29
+ const id = `codex-elicitation-${randomUUID()}`;
30
+ const ttl = context.approvalRouting?.approvalTtlMs;
31
+ const timeoutMs = typeof ttl === 'number' && Number.isFinite(ttl) && ttl > 0
32
+ ? Math.min(ttl, 20 * 60_000) : 20 * 60_000;
33
+ const interaction = {
34
+ type: 'interaction', id, sessionId: input.sessionKey,
35
+ channelId: context.channelId, initiatorId: context.userId,
36
+ kind: {
37
+ kind: 'action', title: 'MCP 请求确认',
38
+ body: `${input.message}\n\n来源:${input.server}`,
39
+ bodyFormat: 'plain',
40
+ buttons: [
41
+ { key: 'accept', label: '确认', style: 'primary' },
42
+ { key: 'decline', label: '拒绝', style: 'danger' },
43
+ { key: 'cancel', label: '取消', style: 'default' },
44
+ ],
45
+ allowCustomInput: false,
46
+ },
47
+ fallback: { command: 'ask', buttonArgMap: { accept: '1', decline: '2', cancel: '3' }, acceptFreeText: false },
48
+ };
49
+ let settled = false;
50
+ let finish;
51
+ const result = new Promise(resolve => { finish = value => { settled = true; resolve(value); }; });
52
+ const cancel = () => { void router.cancel(id, 'task_cancelled'); };
53
+ router.register(id, input.sessionKey, async (action) => {
54
+ if (settled)
55
+ return false;
56
+ const decision = new Map([
57
+ ['1', 'accept'], ['2', 'decline'], ['3', 'cancel'],
58
+ ['accept', 'accept'], ['decline', 'decline'], ['cancel', 'cancel'],
59
+ ]).get(action);
60
+ if (!decision)
61
+ return false;
62
+ if (signal.aborted || !isCurrent()) {
63
+ finish(cancelledMcpElicitation());
64
+ return true;
65
+ }
66
+ try {
67
+ await context.revalidateExecutionIdentity?.();
68
+ // Authorization and task identity may change during revalidation.
69
+ if (settled || signal.aborted || !isCurrent()) {
70
+ if (!settled)
71
+ finish(cancelledMcpElicitation());
72
+ return true;
73
+ }
74
+ finish(decision === 'accept'
75
+ ? { action: 'accept', content: {}, _meta: null }
76
+ : { action: decision, content: null, _meta: null });
77
+ }
78
+ catch {
79
+ finish(cancelledMcpElicitation());
80
+ }
81
+ return true;
82
+ }, {
83
+ initiatorId: context.userId, initiatorChannelKey: channelKey,
84
+ fallbackCommand: 'ask', retainOnRejected: true, timeoutMs,
85
+ onCancel: async (reason) => {
86
+ if (!settled)
87
+ finish(cancelledMcpElicitation());
88
+ try {
89
+ await context.adapter?.invalidateInteraction?.(id, reason);
90
+ }
91
+ catch { /* router already rejects stale replies */ }
92
+ },
93
+ });
94
+ signal.addEventListener('abort', cancel, { once: true });
95
+ try {
96
+ if (signal.aborted || !isCurrent()) {
97
+ await router.cancel(id, 'task_cancelled');
98
+ }
99
+ else {
100
+ // Also settle if cancellation/timeout happens while a channel send is pending.
101
+ const delivery = (async () => {
102
+ try {
103
+ await context.flushPending?.();
104
+ if (settled || signal.aborted || !isCurrent()) {
105
+ await router.cancel(id, 'task_cancelled');
106
+ return;
107
+ }
108
+ let sent = false;
109
+ if (context.adapter) {
110
+ const receipt = await sendInteractionPayload(context.adapter, buildEnvelope({
111
+ taskId: context.taskId, channel: channelKey, channelId: context.channelId,
112
+ agentName: context.agentName, chatmode: context.chatmode, replyContext: context.replyContext,
113
+ }), interaction, undefined, context.replyContext);
114
+ sent = isInteractionSendAccepted(receipt);
115
+ }
116
+ if (!sent && !settled && sendPrompt) {
117
+ await sendPrompt(renderActionAsText(interaction));
118
+ sent = true;
119
+ }
120
+ if (!sent && !settled)
121
+ await router.cancel(id, 'delivery_failed');
122
+ }
123
+ catch {
124
+ await router.cancel(id, 'delivery_failed');
125
+ }
126
+ })();
127
+ await Promise.race([delivery, result]);
128
+ }
129
+ return await result;
130
+ }
131
+ finally {
132
+ signal.removeEventListener('abort', cancel);
133
+ await router.cancel(id, 'settled');
134
+ }
135
+ }