evolcore 0.0.49 → 0.0.51

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (514) hide show
  1. package/CHANGELOG.md +103 -3
  2. package/bin/ec-build.mjs +60 -0
  3. package/bin/ecmsg.js +64 -57
  4. package/dist/ability/caller/authorization.js +21 -0
  5. package/dist/ability/caller/command.js +173 -0
  6. package/dist/ability/caller/contract.js +117 -0
  7. package/dist/ability/caller/credential-files.js +132 -0
  8. package/dist/ability/caller/daemon.js +183 -0
  9. package/dist/ability/caller/schema-view.js +157 -0
  10. package/dist/ability/caller/service.js +519 -0
  11. package/dist/ability/command-contract.js +5 -0
  12. package/dist/ability/daemon.js +5 -1
  13. package/dist/ability/interop-v1.js +156 -106
  14. package/dist/ability/management.js +1 -0
  15. package/dist/agent-template/jobs.js +79 -3
  16. package/dist/agent-template/runtime.js +459 -47
  17. package/dist/agent-template/service.js +1242 -198
  18. package/dist/agent-template/share.js +103 -0
  19. package/dist/agent-template/tool-runner.js +25 -0
  20. package/dist/agent-template/types.js +10 -2
  21. package/dist/agents/claude/availability.js +94 -0
  22. package/dist/agents/claude/capability-provider.js +154 -0
  23. package/dist/agents/claude/index.js +145 -0
  24. package/dist/agents/{claude-runner.js → claude/runner.js} +78 -166
  25. package/dist/agents/claude/session-file-adapter.js +246 -0
  26. package/dist/agents/codex/app-server-client.js +90 -10
  27. package/dist/agents/codex/availability.js +164 -0
  28. package/dist/agents/codex/capability-provider.js +138 -0
  29. package/dist/agents/codex/cli.js +38 -0
  30. package/dist/agents/codex/index.js +345 -0
  31. package/dist/agents/codex/mcp-elicitation.js +135 -0
  32. package/dist/agents/{codex-runner.js → codex/runner.js} +652 -383
  33. package/dist/agents/codex/session-file-adapter.js +834 -0
  34. package/dist/agents/dsh/availability.js +28 -0
  35. package/dist/agents/dsh/capability-provider.js +56 -0
  36. package/dist/agents/dsh/desktop-locations.ps1 +66 -0
  37. package/dist/agents/dsh/desktop-probe.cjs +37 -0
  38. package/dist/agents/dsh/index.js +98 -0
  39. package/dist/agents/dsh/installation.js +400 -0
  40. package/dist/agents/dsh/resources.js +755 -0
  41. package/dist/agents/dsh/runner.js +1183 -0
  42. package/dist/agents/dsh/runtime/README.md +243 -0
  43. package/dist/agents/dsh/runtime/authorization.js +23 -0
  44. package/dist/agents/dsh/runtime/bridge.js +837 -0
  45. package/dist/agents/dsh/runtime/config.js +271 -0
  46. package/dist/agents/dsh/runtime/entry.js +229 -0
  47. package/dist/agents/dsh/runtime/session-inspector.js +340 -0
  48. package/dist/agents/dsh/runtime/tool-policy.js +49 -0
  49. package/dist/agents/dsh/session-file-adapter.js +145 -0
  50. package/dist/agents/ecagent/index.js +215 -0
  51. package/dist/agents/{ecagent-runner.js → ecagent/runner.js} +592 -106
  52. package/dist/agents/ecagent/session-file-adapter.js +134 -0
  53. package/dist/agents/gemini/index.js +96 -0
  54. package/dist/agents/{gemini-runner.js → gemini/runner.js} +18 -23
  55. package/dist/{core/session/adapters/gemini-session-file-adapter.js → agents/gemini/session-file-adapter.js} +2 -2
  56. package/dist/aun/ability-device-routing.js +11 -17
  57. package/dist/aun/aid/agentmd.js +27 -1
  58. package/dist/aun/aid/control-aid.js +52 -32
  59. package/dist/aun/aid/managed-operation.js +6 -4
  60. package/dist/aun/group/invite-service.js +7 -37
  61. package/dist/aun/group/operations.js +6 -0
  62. package/dist/aun/menu/client.js +1 -1
  63. package/dist/aun/msg/history.js +1 -1
  64. package/dist/aun/msg/managed-operation.js +93 -21
  65. package/dist/aun/msg/mention-schema.js +1 -1
  66. package/dist/aun/msg/p2p.js +32 -4
  67. package/dist/aun/msg/upload.js +126 -3
  68. package/dist/aun/service-proxy.js +1 -1
  69. package/dist/aun/storage/index.js +242 -0
  70. package/dist/build-identity.json +1 -1
  71. package/dist/channels/aun.js +698 -213
  72. package/dist/channels/daemon.js +3 -2
  73. package/dist/channels/dingtalk.js +1 -1
  74. package/dist/channels/feishu.js +9 -9
  75. package/dist/channels/qqbot.js +1 -1
  76. package/dist/channels/wechat.js +2 -2
  77. package/dist/channels/wecom.js +1 -1
  78. package/dist/claude-gateway/agent-registration.js +389 -0
  79. package/dist/claude-gateway/binding.js +96 -0
  80. package/dist/claude-gateway/inbox.js +138 -0
  81. package/dist/claude-gateway/index.js +125 -0
  82. package/dist/claude-gateway/listing.js +330 -0
  83. package/dist/claude-gateway/router.js +328 -0
  84. package/dist/claude-gateway/sessions.js +128 -0
  85. package/dist/claude-gateway/terminal.js +250 -0
  86. package/dist/claude-gateway/transcript.js +272 -0
  87. package/dist/claude-gateway/types.js +14 -0
  88. package/dist/cli/ability-command.js +45 -0
  89. package/dist/cli/ability-output.js +182 -0
  90. package/dist/cli/agent-command.js +21 -2
  91. package/dist/cli/agent-create.js +197 -56
  92. package/dist/cli/agent-template.js +400 -27
  93. package/dist/cli/agent.js +105 -11
  94. package/dist/cli/aun-commands.js +237 -123
  95. package/dist/cli/bench.js +5 -2
  96. package/dist/cli/config.js +22 -6
  97. package/dist/cli/daemon-commands.js +283 -109
  98. package/dist/cli/data-command.js +1 -1
  99. package/dist/cli/debug-mode.js +9 -0
  100. package/dist/cli/directory.js +1 -2
  101. package/dist/cli/ecmsg-gateway.js +64 -26
  102. package/dist/cli/fs-command.js +67 -39
  103. package/dist/cli/index.js +45 -12
  104. package/dist/cli/init.js +161 -90
  105. package/dist/cli/managed-command-guard.js +3 -0
  106. package/dist/cli/menu-client.js +32 -7
  107. package/dist/cli/model.js +1 -1
  108. package/dist/cli/pay-command.js +30 -0
  109. package/dist/cli/provider-command.js +6 -2
  110. package/dist/cli/restart-monitor.js +4 -4
  111. package/dist/cli/services-command.js +35 -10
  112. package/dist/cli/skill-command.js +4 -4
  113. package/dist/cli/task-context.js +24 -14
  114. package/dist/cli/team-workspace-command.js +50 -52
  115. package/dist/cli/thread-command.js +81 -14
  116. package/dist/cli/trigger-command.js +47 -12
  117. package/dist/cli/watch-logs.js +2 -1
  118. package/dist/config/access-policy.js +16 -3
  119. package/dist/config/boot-log.js +3 -0
  120. package/dist/config/builtin-role-templates.js +1 -1
  121. package/dist/config/config-field-policy.js +26 -13
  122. package/dist/config/config-manager.js +113 -52
  123. package/dist/config/config-operation-service.js +22 -1
  124. package/dist/config/gateway-config.js +29 -44
  125. package/dist/config/invoke-ipc-service.js +1 -1
  126. package/dist/config/owner-config.js +5 -19
  127. package/dist/config/peer-book-store.js +2 -3
  128. package/dist/config/peer-book.js +2 -2
  129. package/dist/config/peer-role-resolver.js +3 -9
  130. package/dist/config/provider-identity-migration.js +24 -105
  131. package/dist/config/provider-ipc-service.js +13 -3
  132. package/dist/config/provider-local-sync.js +4 -1
  133. package/dist/config/provider-menu-request.js +21 -3
  134. package/dist/config/provider-templates.js +1 -1
  135. package/dist/config/providers-config.js +138 -31
  136. package/dist/config/providers-import.js +3 -3
  137. package/dist/config/providers-management.js +109 -118
  138. package/dist/config/resolved-config-op.js +1 -42
  139. package/dist/config/schema-migration.js +254 -15
  140. package/dist/config/schema-registry.js +53 -8
  141. package/dist/config-store.js +1343 -63
  142. package/dist/core/{agent-application-service.js → agent/agent-application-service.js} +228 -9
  143. package/dist/core/{agent-create-status.js → agent/agent-create-status.js} +112 -4
  144. package/dist/core/{agent-creation-claim.js → agent/agent-creation-claim.js} +3 -3
  145. package/dist/core/{agent-ipc-registration.js → agent/agent-ipc-registration.js} +119 -25
  146. package/dist/core/{agent-reload-coordinator.js → agent/agent-reload-coordinator.js} +65 -0
  147. package/dist/core/{agent-runtime.js → agent/agent-runtime.js} +249 -79
  148. package/dist/core/{evolagent-registry.js → agent/evolagent-registry.js} +23 -18
  149. package/dist/core/{evolagent.js → agent/evolagent.js} +11 -11
  150. package/dist/core/auth/agent-delegation.js +15 -8
  151. package/dist/core/auth/delegation-authorization.js +28 -0
  152. package/dist/core/auth/operation-authorizer.js +20 -2
  153. package/dist/core/auth/operation-catalog.js +80 -8
  154. package/dist/core/baseagent/baseagent-availability.js +197 -0
  155. package/dist/core/baseagent/baseagent-capability-adapter.js +288 -0
  156. package/dist/core/baseagent/baseagent-config-shared.js +56 -0
  157. package/dist/core/baseagent/baseagent-identity.js +68 -0
  158. package/dist/core/{baseagent-loader.js → baseagent/baseagent-loader.js} +89 -6
  159. package/dist/core/baseagent/baseagent-model-defaults.js +26 -0
  160. package/dist/core/baseagent/baseagent-plugin-descriptor.js +357 -0
  161. package/dist/core/baseagent/baseagent-plugin-loader.js +367 -0
  162. package/dist/core/baseagent/baseagent.js +157 -0
  163. package/dist/{agents → core/baseagent}/runner-types.js +36 -4
  164. package/dist/core/capability/capability-manager.js +91 -33
  165. package/dist/core/capability/providers/claude-capability-provider.js +2 -154
  166. package/dist/core/capability/providers/codex-capability-provider.js +2 -136
  167. package/dist/core/{channel-loader.js → channel/channel-loader.js} +226 -38
  168. package/dist/core/{channel-runtime.js → channel/channel-runtime.js} +21 -19
  169. package/dist/core/command/agent-control.js +80 -17
  170. package/dist/core/command/agent-template-menu.js +23 -10
  171. package/dist/core/command/agentmd-menu-request.js +19 -8
  172. package/dist/core/command/agentmd-menu.js +14 -5
  173. package/dist/core/command/cli-intent-parser.js +15 -0
  174. package/dist/core/command/command-handler.js +127 -57
  175. package/dist/core/command/context-policy-menu.js +122 -0
  176. package/dist/core/command/data-root-resolver.js +157 -20
  177. package/dist/core/command/memory-slash.js +6 -6
  178. package/dist/core/command/menu-catalog.js +95 -19
  179. package/dist/core/command/menu-file-path.js +70 -0
  180. package/dist/core/command/menu-handler.js +392 -93
  181. package/dist/core/command/menu-protocol.js +47 -8
  182. package/dist/core/command/menu-query-batch.js +9 -5
  183. package/dist/core/command/private-mention-menu.js +71 -0
  184. package/dist/core/command/provider-menu.js +7 -11
  185. package/dist/core/command/role-menu.js +1 -1
  186. package/dist/core/command/skill-slash.js +17 -5
  187. package/dist/core/command/slash-gate.js +2 -4
  188. package/dist/core/command/slash-handler.js +143 -121
  189. package/dist/core/command/team-workspace-bootstrap.js +2 -1
  190. package/dist/core/command/team-workspace-team.js +3 -3
  191. package/dist/core/command/topic-slash.js +16 -10
  192. package/dist/core/{daemon-bootstrap.js → daemon/daemon-bootstrap.js} +14 -18
  193. package/dist/core/{daemon-control.js → daemon/daemon-control.js} +48 -21
  194. package/dist/core/{daemon-lifecycle.js → daemon/daemon-lifecycle.js} +28 -20
  195. package/dist/core/{host-snapshot.js → daemon/host-snapshot.js} +10 -5
  196. package/dist/core/{ipc-registration.js → daemon/ipc-registration.js} +101 -37
  197. package/dist/core/{lifecycle-notice.js → daemon/lifecycle-notice.js} +4 -5
  198. package/dist/core/file-integrity/store.js +1 -1
  199. package/dist/core/handoff/ipc-registration.js +3 -3
  200. package/dist/core/handoff/runtime.js +2 -2
  201. package/dist/{agents → core/inference}/request-identity.js +2 -2
  202. package/dist/core/inference/text-inference.js +4 -4
  203. package/dist/core/{bootstrap-messages.js → initialization/bootstrap-messages.js} +10 -10
  204. package/dist/core/{bootstrap-service.js → initialization/bootstrap-service.js} +24 -23
  205. package/dist/core/initialization/service.js +57 -9
  206. package/dist/core/invoke/executors/media.js +1 -1
  207. package/dist/core/invoke/executors/text.js +1 -1
  208. package/dist/core/memory/consolidation-context.js +3 -2
  209. package/dist/core/memory/consolidation-trigger.js +9 -3
  210. package/dist/core/memory/consolidation.js +39 -68
  211. package/dist/core/memory/memory-admin.js +6 -6
  212. package/dist/core/memory/memory-writer.js +1 -1
  213. package/dist/core/memory/relation-idle-monitor.js +1 -1
  214. package/dist/core/message/aun-ipc-sender.js +204 -88
  215. package/dist/core/message/aun-request-registry.js +44 -5
  216. package/dist/core/message/auto-mention-gate.js +1 -1
  217. package/dist/core/message/contact-admission.js +1 -1
  218. package/dist/core/message/im-renderer.js +19 -0
  219. package/dist/core/{interaction-router.js → message/interaction-router.js} +131 -1
  220. package/dist/core/message/items-formatter.js +5 -5
  221. package/dist/core/message/message-admission.js +1 -1
  222. package/dist/core/message/message-bridge.js +239 -59
  223. package/dist/core/message/message-log.js +8 -0
  224. package/dist/core/message/message-queue.js +88 -7
  225. package/dist/core/message/message-utils.js +1 -1
  226. package/dist/core/message/peer-mode.js +16 -5
  227. package/dist/core/message/response-engine.js +351 -152
  228. package/dist/core/message/send-options.js +44 -7
  229. package/dist/core/message/send-routing.js +55 -115
  230. package/dist/core/message/stream-idle-monitor.js +1 -1
  231. package/dist/core/{data-migration.js → migration/data-migration.js} +29 -1
  232. package/dist/core/model/catalog-service.js +29 -8
  233. package/dist/core/model/model-capabilities.js +88 -0
  234. package/dist/core/model/model-catalog.js +18 -7
  235. package/dist/core/model/model-diagnostics.js +4 -4
  236. package/dist/core/ownership/owner-resolver.js +107 -101
  237. package/dist/core/{pack-auth.js → pack/pack-auth.js} +34 -3
  238. package/dist/core/{pack-install.js → pack/pack-install.js} +95 -17
  239. package/dist/core/permission/approval-gateway.js +9 -18
  240. package/dist/core/permission/ec-command-parser.js +242 -82
  241. package/dist/core/permission/managed-file.js +234 -0
  242. package/dist/core/permission/protected-paths.js +120 -9
  243. package/dist/core/permission/sandbox-runtime.js +267 -3
  244. package/dist/core/permission/services-path-acl.js +9 -2
  245. package/dist/core/permission/session-path-grants.js +1 -1
  246. package/dist/core/permission/shell-environment.js +15 -1
  247. package/dist/core/permission/tool-policy.js +21 -9
  248. package/dist/core/plugin/plugin-lifecycle.js +442 -0
  249. package/dist/core/session/adapters/claude-session-file-adapter.js +2 -242
  250. package/dist/core/session/adapters/codex-session-file-adapter.js +2 -562
  251. package/dist/core/session/adapters/ecagent-session-file-adapter.js +2 -134
  252. package/dist/core/{background-session → session/background}/session-cleanup.js +2 -2
  253. package/dist/core/{background-session → session/background}/types.js +1 -1
  254. package/dist/core/session/session-file-health.js +2 -272
  255. package/dist/core/session/session-idle-monitor.js +1 -1
  256. package/dist/core/session/session-manager.js +76 -12
  257. package/dist/core/session/session-mapper.js +16 -0
  258. package/dist/core/session/session-terminal.js +185 -0
  259. package/dist/core/session/session-title.js +8 -11
  260. package/dist/core/{system-session → session/system}/memory.js +43 -9
  261. package/dist/core/{system-session → session/system}/registry.js +1 -1
  262. package/dist/core/{system-session → session/system}/types.js +1 -1
  263. package/dist/core/skill/index-generator.js +3 -3
  264. package/dist/core/skill/switch-resolver.js +3 -0
  265. package/dist/core/task/task-activity-store.js +112 -0
  266. package/dist/core/task/task-recovery-service.js +2 -2
  267. package/dist/core/thread/command-parser.js +4 -1
  268. package/dist/core/thread/ipc-operation.js +6 -4
  269. package/dist/core/thread/thread-operation.js +27 -11
  270. package/dist/core/thread/thread-route.js +5 -3
  271. package/dist/core/thread/thread-service.js +307 -58
  272. package/dist/core/thread/topic-id.js +52 -2
  273. package/dist/core/thread/types.js +15 -1
  274. package/dist/directory/{owner-directory-admission.js → admission.js} +3 -3
  275. package/dist/directory/{owner-directory-cache.js → cache.js} +90 -8
  276. package/dist/directory/{owner-directory-markdown.js → markdown.js} +2 -2
  277. package/dist/directory/{owner-directory-query-operation.js → query-operation.js} +83 -9
  278. package/dist/directory/{owner-directory-search.js → search.js} +50 -2
  279. package/dist/directory/{owner-directory-store.js → store.js} +2 -2
  280. package/dist/eck/kit-renderer.js +3 -2
  281. package/dist/eck/manifest-engine.js +64 -2
  282. package/dist/eck/message-renderer.js +35 -0
  283. package/dist/ecweb/basic-settings-service.js +12 -10
  284. package/dist/{contracts → ecweb/contracts}/ecweb-service-protocol.js +2 -1
  285. package/dist/ecweb/dsh-native-service.js +413 -0
  286. package/dist/ecweb/providers-service.js +5 -3
  287. package/dist/ecweb/runtime/lifecycle.js +1 -1
  288. package/dist/ecweb/runtime/supervisor.js +1 -1
  289. package/dist/event-center/center-config.js +2 -2
  290. package/dist/event-center/dispatcher.js +1 -1
  291. package/dist/event-center/ipc-operation.js +12 -3
  292. package/dist/event-center/pack-loader.js +2 -2
  293. package/dist/event-center/registry.js +6 -6
  294. package/dist/event-center/runtime.js +2 -2
  295. package/dist/index.js +181 -77
  296. package/dist/ipc.js +161 -12
  297. package/dist/outputs/authorization.js +27 -0
  298. package/dist/outputs/events.js +10 -1
  299. package/dist/outputs/panel-cards.js +960 -0
  300. package/dist/paths.js +60 -1
  301. package/dist/pay/command.js +38 -0
  302. package/dist/pay/protocol.js +136 -0
  303. package/dist/pay/runtime.js +196 -0
  304. package/dist/pay/service.js +384 -0
  305. package/dist/pay/store.js +81 -0
  306. package/dist/response-system/engines/v1/proactive-flow.js +30 -3
  307. package/dist/services/dispatcher.js +25 -7
  308. package/dist/services/host/main.js +397 -0
  309. package/dist/services/host/protocol.js +125 -0
  310. package/dist/services/host/resident.js +347 -0
  311. package/dist/services/host-client.js +398 -0
  312. package/dist/services/host-deploy.js +180 -0
  313. package/dist/services/host-launch.js +117 -0
  314. package/dist/services/host-recycle.js +208 -0
  315. package/dist/services/host-runtime.js +841 -0
  316. package/dist/services/idempotency.js +44 -86
  317. package/dist/services/index-generator.js +4 -3
  318. package/dist/services/index.js +258 -36
  319. package/dist/services/ipc-operation.js +503 -78
  320. package/dist/services/pack-manager.js +2 -2
  321. package/dist/services/router.js +43 -3
  322. package/dist/services/script-runner.js +541 -100
  323. package/dist/services/service-payload.js +28 -1
  324. package/dist/services/validation.js +136 -5
  325. package/dist/stats/context-usage.js +110 -0
  326. package/dist/stats/model-resolver.js +103 -17
  327. package/dist/stats/query.js +5 -0
  328. package/dist/trigger/application-service.js +9 -6
  329. package/dist/trigger/authorization.js +36 -33
  330. package/dist/trigger/ipc-service.js +4 -4
  331. package/dist/trigger/local-files.js +8 -166
  332. package/dist/trigger/manager.js +2 -2
  333. package/dist/trigger/parser.js +48 -0
  334. package/dist/trigger/scheduler.js +35 -13
  335. package/dist/trigger/script-executor.js +21 -0
  336. package/dist/trigger/script-sandbox.js +77 -232
  337. package/dist/trigger/system-definitions.js +25 -0
  338. package/dist/trigger/validation.js +1 -1
  339. package/dist/utils/aid-bind.js +3 -0
  340. package/dist/utils/atomic-write.js +88 -1
  341. package/dist/utils/cross-platform.js +4 -42
  342. package/dist/utils/error-dict.json +22 -1
  343. package/dist/utils/error-utils.js +193 -6
  344. package/dist/utils/evolcore-version.js +2 -2
  345. package/dist/utils/host-info.js +74 -1
  346. package/dist/utils/logger.js +5 -3
  347. package/dist/utils/media-cache.js +284 -42
  348. package/dist/utils/restart-safety.js +14 -1
  349. package/dist/utils/startup-trace.js +20 -4
  350. package/dist/utils/system-memory.js +113 -25
  351. package/dist/utils/systemd-lifecycle.js +154 -0
  352. package/dist/utils/welcome.js +64 -20
  353. package/dist/utils/windows-shell-trust.js +7 -3
  354. package/ecagent/README.md +35 -0
  355. package/ecagent/dist/agent-loop.js +80 -30
  356. package/ecagent/dist/harness/env/nodejs.d.ts +16 -0
  357. package/ecagent/dist/harness/env/nodejs.js +49 -20
  358. package/ecagent/dist/harness/messages.js +3 -2
  359. package/ecagent/dist/harness/types.d.ts +1 -0
  360. package/ecagent/dist/runtime/types.d.ts +2 -0
  361. package/ecagent/dist/runtime/utils/validation.d.ts +7 -1
  362. package/ecagent/dist/runtime/utils/validation.js +42 -0
  363. package/ecagent/dist/types.d.ts +2 -0
  364. package/kits/docs/INDEX.md +3 -2
  365. package/kits/docs/aun/AUN/346/266/210/346/201/257/347/261/273/345/236/213/344/270/216/345/261/236/346/200/247.md +1 -0
  366. package/kits/docs/channels/aun.md +1 -1
  367. package/kits/docs/channels/feishu.md +1 -1
  368. package/kits/docs/evolcore/INDEX.md +13 -9
  369. package/kits/docs/evolcore/agent-create.md +2 -0
  370. package/kits/docs/evolcore/agent.md +133 -11
  371. package/kits/docs/evolcore/aid.md +39 -6
  372. package/kits/docs/evolcore/config.md +95 -1
  373. package/kits/docs/evolcore/ctl.md +2 -1
  374. package/kits/docs/evolcore/ec-capabilities.md +7 -10
  375. package/kits/docs/evolcore/ecweb-lifecycle.md +5 -1
  376. package/kits/docs/evolcore/event.md +1 -1
  377. package/kits/docs/evolcore/fs.md +49 -3
  378. package/kits/docs/evolcore/group.md +5 -4
  379. package/kits/docs/evolcore/memory-consolidation.md +1 -1
  380. package/kits/docs/evolcore/memory-tags.md +2 -0
  381. package/kits/docs/evolcore/menu-client.md +3 -3
  382. package/kits/docs/evolcore/menu-protocol.md +31 -2
  383. package/kits/docs/evolcore/model.md +12 -1
  384. package/kits/docs/evolcore/msg.md +96 -36
  385. package/kits/docs/evolcore/pay.md +22 -0
  386. package/kits/docs/evolcore/plugin.md +74 -0
  387. package/kits/docs/evolcore/provider.md +29 -2
  388. package/kits/docs/evolcore/rpc.md +2 -2
  389. package/kits/docs/evolcore/services.md +46 -18
  390. package/kits/docs/evolcore/skill.md +17 -1
  391. package/kits/docs/evolcore/stats.md +5 -0
  392. package/kits/docs/evolcore/storage.md +22 -0
  393. package/kits/docs/evolcore/thread-chain.md +20 -9
  394. package/kits/docs/evolcore/tool-authorization.md +14 -0
  395. package/kits/docs/evolcore/trigger.md +89 -13
  396. package/kits/docs/identity/AID_PROFILE_SPEC.md +1 -1
  397. package/kits/docs/venues/feishu-group.md +3 -2
  398. package/kits/docs/venues/feishu-private.md +3 -2
  399. package/kits/rules/01-overview.md +11 -32
  400. package/kits/rules/02-navigation.md +20 -6
  401. package/kits/rules/06-channel.md +20 -4
  402. package/kits/schemas/_meta.json +42 -5
  403. package/kits/schemas/agent-config.schema.21.json +974 -0
  404. package/kits/schemas/agent-config.schema.22.json +977 -0
  405. package/kits/schemas/agent-config.schema.23.json +974 -0
  406. package/kits/schemas/agent-config.schema.24.json +986 -0
  407. package/kits/schemas/agent-config.schema.25.json +986 -0
  408. package/kits/schemas/daemon.schema.10.json +373 -0
  409. package/kits/schemas/daemon.schema.11.json +487 -0
  410. package/kits/schemas/daemon.schema.12.json +505 -0
  411. package/kits/schemas/daemon.schema.9.json +12 -0
  412. package/kits/schemas/defaults.schema.7.json +472 -0
  413. package/kits/schemas/defaults.schema.8.json +484 -0
  414. package/kits/schemas/providers.schema.1.json +1 -1
  415. package/kits/schemas/providers.schema.2.json +1 -1
  416. package/kits/schemas/providers.schema.3.json +26 -4
  417. package/kits/schemas/relation-config.schema.13.json +289 -0
  418. package/kits/skills/.switches.json +17 -1
  419. package/kits/skills/ability/SKILL.md +395 -33
  420. package/kits/skills/ability/STRUCTURE.md +338 -0
  421. package/kits/skills/ability/references/cli.md +208 -0
  422. package/kits/skills/ability/references/development.md +107 -37
  423. package/kits/skills/ability/references/management.md +106 -46
  424. package/kits/skills/ability/references/runtime-protocol.md +65 -63
  425. package/kits/skills/agent-output-cards/SKILL.md +80 -37
  426. package/kits/skills/agent-output-cards/examples/html-surface.json +11 -0
  427. package/kits/skills/agent-output-cards/examples/meeting-followups.json +16 -0
  428. package/kits/skills/agent-output-cards/examples/meeting-latest.json +24 -0
  429. package/kits/skills/agent-output-cards/examples/project-metrics.json +16 -0
  430. package/kits/skills/agent-output-cards/examples/quick-links.json +18 -0
  431. package/kits/skills/agent-output-cards/examples/surface.html +8 -0
  432. package/kits/skills/agent-template-project/SKILL.md +51 -0
  433. package/kits/skills/agent-template-project/references/01-collect-and-pack.md +174 -0
  434. package/kits/skills/agent-template-project/references/02-upload-and-share.md +109 -0
  435. package/kits/skills/agent-template-project/references/03-download-and-install.md +189 -0
  436. package/kits/skills/agent-template-project/references/04-upgrade-and-recovery.md +74 -0
  437. package/kits/skills/agent-template-project/references/05-publish-to-platform.md +62 -0
  438. package/kits/skills/ec-group/SKILL.md +8 -6
  439. package/kits/skills/ec-group/TASK.md +186 -0
  440. package/kits/skills/ec-group/WORKLOG.md +180 -0
  441. package/kits/skills/ec-group-collaboration/SKILL.md +5 -5
  442. package/kits/skills/ec-identity/SKILL.md +9 -6
  443. package/kits/skills/ec-pay/SKILL.md +223 -0
  444. package/kits/skills/ec-provider/SKILL.md +6 -6
  445. package/kits/skills/{ec-service-proxy → ec-proxy}/SKILL.md +8 -5
  446. package/kits/skills/ec-service-call/SKILL.md +138 -0
  447. package/kits/skills/ec-service-pack/SKILL.md +277 -0
  448. package/kits/skills/ec-skill/SKILL.md +25 -9
  449. package/kits/skills/ec-skill/scripts/cli.mjs +7 -7
  450. package/kits/skills/ec-skill/scripts/skill.mjs +55 -41
  451. package/kits/skills/ec-skill/scripts/template/SKILL.md.tmpl +9 -0
  452. package/kits/skills/ec-trigger/SKILL.md +3 -3
  453. package/kits/skills/personal-assistant/SKILL.md +22 -22
  454. package/kits/skills/personal-assistant/references/03-data-flow-and-gaps.md +1 -1
  455. package/kits/skills/scrapling-article-fetch/SKILL.md +5 -5
  456. package/kits/skills/thread-ops/SKILL.md +19 -9
  457. package/kits/skills/wechat-article-media-download/SKILL.md +2 -2
  458. package/kits/skills/wechat-article-reader/SKILL.md +2 -2
  459. package/kits/templates/memory-consolidation/notes.md +2 -2
  460. package/kits/templates/memory-consolidation/workflow.md +46 -0
  461. package/kits/templates/system-fragments/channel.md +13 -4
  462. package/kits/templates/system-fragments/commands.md +5 -4
  463. package/kits/templates/system-fragments/personal-assistant.md +2 -2
  464. package/kits/templates/system-fragments/reply.md +15 -9
  465. package/kits/templates/system-fragments/session.md +2 -2
  466. package/kits/templates/system-fragments/thread.md +30 -127
  467. package/kits/templates/system-fragments/venue.md +16 -0
  468. package/package.json +7 -7
  469. package/scripts/agent-template/index.mjs +7 -1
  470. package/scripts/agent-template/inspect.mjs +99 -39
  471. package/scripts/agent-template/overlay.mjs +126 -2
  472. package/scripts/agent-template/shared/common.mjs +49 -5
  473. package/scripts/agent-template/shared/plan.mjs +4 -2
  474. package/scripts/agent-template/shared/service-packs.mjs +104 -0
  475. package/scripts/agent-template/shared/team-schema.json +468 -39
  476. package/scripts/agent-template/shared/template-contract.mjs +93 -51
  477. package/scripts/agent-template/shared/template-package.mjs +225 -44
  478. package/scripts/agent-template/shared/template-runtime.mjs +137 -15
  479. package/scripts/agent-template/shared/template.mjs +31 -8
  480. package/scripts/agent-template/team-pack.mjs +528 -56
  481. package/scripts/agent-template/team-preview.mjs +102 -9
  482. package/scripts/aid-batch/identity-batch.mjs +1 -1
  483. package/dist/agents/baseagent-availability.js +0 -152
  484. package/dist/agents/baseagent.js +0 -750
  485. package/dist/agents/codex/catalog.js +0 -80
  486. package/dist/agents/ecagent-plugin-lazy.js +0 -41
  487. package/dist/agents/tool-time-context.js +0 -55
  488. package/dist/core/legacy-rename.js +0 -41
  489. package/dist/core/plugin-lifecycle.js +0 -137
  490. package/dist/core/rate-window.js +0 -53
  491. package/dist/core/runner-reload-transaction.js +0 -60
  492. package/dist/core/runtime-lock.js +0 -90
  493. package/dist/core/soul.js +0 -66
  494. package/dist/core/system-session/grants.js +0 -40
  495. package/dist/directory/owner-directory-agentmd-sync.js +0 -89
  496. package/dist/directory/owner-directory-request-operation.js +0 -79
  497. package/dist/directory/owner-directory-text.js +0 -60
  498. package/kits/docs/aun/ABILITY_CALLING.md +0 -280
  499. package/kits/docs/evolcore/ability.md +0 -185
  500. package/kits/skills/ability/references/calling.md +0 -56
  501. package/kits/skills/ability/references/contract-checklist.md +0 -37
  502. package/kits/skills/ability/references/recovery.md +0 -27
  503. /package/dist/{core/capability/providers/gemini-capability-provider.js → agents/gemini/capability-provider.js} +0 -0
  504. /package/dist/core/{system-channels.js → channel/system-channels.js} +0 -0
  505. /package/dist/core/{daemon-file-cache.js → daemon/daemon-file-cache.js} +0 -0
  506. /package/dist/core/{event-bus.js → event/event-bus.js} +0 -0
  507. /package/dist/core/{event-catalog.js → event/event-catalog.js} +0 -0
  508. /package/dist/core/{pack-ledger.js → pack/pack-ledger.js} +0 -0
  509. /package/dist/directory/{owner-directory-identity.js → identity.js} +0 -0
  510. /package/dist/directory/{owner-directory-policy.js → policy.js} +0 -0
  511. /package/dist/directory/{owner-directory-remarks.js → remarks.js} +0 -0
  512. /package/dist/directory/{owner-directory-scope.js → scope.js} +0 -0
  513. /package/dist/{contracts → ecweb/contracts}/ecweb-instance.js +0 -0
  514. /package/kits/templates/{bootstrap-welcome.md → bootstrap-intro.md} +0 -0
@@ -0,0 +1,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
+ }