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
@@ -1,3 +1,4 @@
1
+ import { isSupportedBaseagent } from '../core/baseagent/baseagent.js';
1
2
  import { createHash, randomUUID } from 'node:crypto';
2
3
  import { isDeepStrictEqual } from 'node:util';
3
4
  import fs from 'node:fs';
@@ -6,11 +7,11 @@ import { resolvePaths } from '../paths.js';
6
7
  import { ConfigTarget, mutateConfig, notifyConfigWrite } from './config-manager.js';
7
8
  import { atomicReadJson } from '../utils/atomic-write.js';
8
9
  import { readProvidersFile, validateProvidersFile } from './providers.js';
9
- import { initializationRuntimePlan, providerEnvironmentVariable, providerNameFromBaseUrlIfStatic, resolveProviderId, resolveProviderService, resolveProviderServiceForBaseagent, validateProviderName } from './providers-config.js';
10
+ import { initializationRuntimePlan, isProviderId, providerEnvironmentVariable, providerNameForBaseagentImport, providerNameFromBaseUrlIfStatic, resolveProviderId, resolveProviderService, resolveProviderServiceForBaseagent, validateProviderName } from './providers-config.js';
10
11
  import { providerIdentity as storedProviderIdentity } from './provider-identity.js';
11
12
  import { planProviderIdentityMigration } from './provider-identity-migration.js';
12
13
  import { isInteractionSendAccepted, sendInteractionPayload } from '../core/message/message-utils.js';
13
- import { providerServiceCredentials, providerServiceTypeForBaseagent, resolveProviderBaseUrl } from './providers-config.js';
14
+ import { maskProviderApiKey, providerApiKeyEntries, providerServiceCredentials, providerServiceTypeForBaseagent, resolveProviderBaseUrl, retainProviderApiKey } from './providers-config.js';
14
15
  import { generateProviderTemplate, parseProviderTemplateInput } from './provider-templates.js';
15
16
  /** Derive a missing identity during management without changing the stored URL reference. */
16
17
  function providerIdentity(provider) {
@@ -26,7 +27,7 @@ export function prepareProviderTemplate(templateId, value, file = resolvePaths()
26
27
  const registry = readProvidersFile(file);
27
28
  let generated = generateProviderTemplate(templateId, input);
28
29
  const identity = providerIdentity(generated.provider);
29
- let existing = Object.entries(registry.providers).find(([, provider]) => providerIdentity(provider).domain === identity.domain);
30
+ let existing;
30
31
  if (draft) {
31
32
  const previous = registry.providers[resolveProviderId(draft.providerId, registry)];
32
33
  const provider = resolveDraftProvider(draft.value, previous, draft.imports);
@@ -44,7 +45,7 @@ export function prepareProviderTemplate(templateId, value, file = resolvePaths()
44
45
  // Resolve each service to enforce the same origin and credential constraints before preview/save.
45
46
  for (const type of Object.keys(normalized.services ?? {}))
46
47
  resolveProviderService('draft', type, { providers: { draft: normalized } });
47
- return { ...generated, provider: normalized, incoming: generated.provider, providerId: existing?.[0] ?? identity.providerId,
48
+ return { ...generated, provider: normalized, incoming: generated.provider, providerId: existing?.[0] ?? normalized.name ?? identity.providerId,
48
49
  existing: !!existing, conflicts: selected.filter(type => Object.hasOwn(existing?.[1].services ?? {}, type)),
49
50
  serviceTypes: selected, revision: providersRevision(registry), before: existing?.[1] };
50
51
  }
@@ -52,19 +53,16 @@ export async function applyProviderTemplate(input, file = resolvePaths().provide
52
53
  const config = parseProviderTemplateInput(input.config);
53
54
  if (!config.apiKey)
54
55
  throw new Error('A product API key is required');
55
- const draft = prepareProviderTemplate(input.templateId, config, file);
56
+ const registry = readProvidersFile(file);
57
+ const targetId = input.providerId === undefined ? undefined : resolveProviderId(input.providerId, registry);
58
+ const target = targetId === undefined ? undefined : registry.providers[targetId];
59
+ if (targetId !== undefined && !target)
60
+ throw Object.assign(new Error('Provider not found'), { code: 'NOT_FOUND' });
61
+ const draft = prepareProviderTemplate(input.templateId, config, file, targetId && target ? { providerId: targetId, value: target } : undefined);
56
62
  if (input.providerId !== undefined) {
57
- const targetId = resolveProviderId(input.providerId, readProvidersFile(file));
58
- if (!draft.existing || targetId !== draft.providerId)
59
- throw new Error('Template domain does not match the target Provider');
60
63
  const data = await updateProvider({ providerId: targetId, revision: input.revision ?? draft.revision, value: draft.provider }, file);
61
64
  return { ...data, providerId: targetId };
62
65
  }
63
- if (draft.existing)
64
- throw Object.assign(new Error('Provider domain already exists; explicitly update the existing Provider'), {
65
- code: 'PROVIDER_CONFLICT', statusCode: 409,
66
- data: { kind: 'provider_domain_exists', providerId: draft.providerId, domain: draft.provider.domain },
67
- });
68
66
  return createProvider({ revision: input.revision ?? draft.revision, value: draft.provider }, file);
69
67
  }
70
68
  export function previewProviderTemplate(templateId, config, context) {
@@ -84,7 +82,7 @@ export function previewProviderTemplate(templateId, config, context) {
84
82
  }
85
83
  /** Capture facts before an attempt; never infer a service or protocol from error text. */
86
84
  export function providerConnectionContext(baseagent, providerId, nativeBaseUrl, nativeApiKey, nativeMetadata) {
87
- if (!['claude', 'codex', 'gemini', 'ecagent'].includes(baseagent))
85
+ if (!isSupportedBaseagent(baseagent))
88
86
  return undefined;
89
87
  const registry = readProvidersFile();
90
88
  const id = providerId ? resolveProviderId(providerId, registry) : undefined;
@@ -121,13 +119,20 @@ export function providerConnectionContext(baseagent, providerId, nativeBaseUrl,
121
119
  /** Raw references can stay unchanged while the effective endpoint or key changes. */
122
120
  function providerEnvironmentRevision(provider) {
123
121
  const connections = [provider?.common, ...Object.values(provider?.services ?? {})];
124
- return createHash('sha256').update(JSON.stringify(connections.map(connection => ['baseUrl', 'apiKey'].map(field => {
125
- const raw = connection?.[field];
126
- const variable = raw ? providerEnvironmentVariable(raw) : undefined;
127
- return variable ? process.env[variable] : raw;
128
- })))).digest('hex');
129
- }
130
- /** Known protocol authentication fields must not keep overriding the repaired key. */
122
+ /** A whole-pool change must invalidate the revision, so every key is expanded. */
123
+ const effectiveKey = (raw) => providerApiKeyEntries(raw)
124
+ .map(key => providerEnvironmentVariable(key) ? process.env[providerEnvironmentVariable(key)] : key);
125
+ return createHash('sha256').update(JSON.stringify(connections.map(connection => {
126
+ const scope = connection;
127
+ const rawBaseUrl = scope?.baseUrl;
128
+ const variable = rawBaseUrl ? providerEnvironmentVariable(rawBaseUrl) : undefined;
129
+ return [variable ? process.env[variable] : rawBaseUrl, effectiveKey(scope?.apiKey)];
130
+ }))).digest('hex');
131
+ }
132
+ /**
133
+ * Replacing the connection key rewrites the primary (position 0) and keeps any
134
+ * stored backups, so a repair never discards the rest of the pool.
135
+ */
131
136
  function replaceConnectionKey(provider, apiKey, serviceType) {
132
137
  const target = serviceType ? provider.services?.[serviceType] : provider.common;
133
138
  if (!target)
@@ -139,7 +144,8 @@ function replaceConnectionKey(provider, apiKey, serviceType) {
139
144
  if (effective.queryParams)
140
145
  target.queryParams = { ...effective.queryParams };
141
146
  }
142
- target.apiKey = apiKey;
147
+ const backups = providerApiKeyEntries(target.apiKey).slice(1);
148
+ target.apiKey = backups.length ? [apiKey, ...backups] : apiKey;
143
149
  for (const name of Object.keys(target.headers ?? {})) {
144
150
  const lower = name.toLowerCase();
145
151
  if (lower === 'authorization' && /^Bearer\s/iu.test(target.headers[name])) {
@@ -183,8 +189,10 @@ export class ProviderConnectionQuestions {
183
189
  return true;
184
190
  const fields = new Set(rule.question.fields);
185
191
  const supplied = (field) => {
192
+ // Repair collects the primary key; stored backups are restored by replaceConnectionKey.
186
193
  const raw = field === 'baseUrl' ? context.baseUrl : context.provider
187
- ? providerServiceCredentials(context.provider, context.serviceType).apiKey : context.nativeApiKey;
194
+ ? providerApiKeyEntries(providerServiceCredentials(context.provider, context.serviceType).apiKey)[0]
195
+ : context.nativeApiKey;
188
196
  const variable = raw ? providerEnvironmentVariable(raw) : undefined;
189
197
  return variable ? process.env[variable] : raw;
190
198
  };
@@ -505,8 +513,14 @@ export function providersRevision(value) {
505
513
  export function readProvidersSnapshot(file = resolvePaths().providersConfig) {
506
514
  return providersSnapshot(readProvidersFile(file));
507
515
  }
516
+ export function readProviderDetail(providerId, file = resolvePaths().providersConfig) {
517
+ const registry = readProvidersFile(file);
518
+ providerId = resolveProviderId(providerId, registry);
519
+ const provider = registry.providers[providerId];
520
+ return provider && { providerId, provider: redactProvider(provider, true), revision: providersRevision(registry) };
521
+ }
508
522
  export function readProviderForExport(providerId, serviceType, file = resolvePaths().providersConfig, includeApiKey = false) {
509
- if (!/^[A-Za-z0-9_-]+$/u.test(providerId) || ['__proto__', 'constructor', 'prototype'].includes(providerId))
523
+ if (!isProviderId(providerId))
510
524
  throw new Error('Invalid provider identifier');
511
525
  if (serviceType !== undefined && (!/^[A-Za-z0-9_-]+$/u.test(serviceType) || ['__proto__', 'constructor', 'prototype'].includes(serviceType)))
512
526
  throw new Error('Invalid service type');
@@ -537,20 +551,25 @@ export function readProviderForExport(providerId, serviceType, file = resolvePat
537
551
  }
538
552
  return exported;
539
553
  }
540
- function providersSnapshot(value) {
541
- const providers = structuredClone(value.providers);
542
- for (const provider of Object.values(providers)) {
543
- for (const connection of [provider.common, ...Object.values(provider.services ?? {})]) {
544
- if (connection.apiKey && !providerEnvironmentVariable(connection.apiKey))
545
- connection.apiKey = PROVIDER_SECRET_MASK;
546
- for (const field of ['headers', 'queryParams']) {
547
- const values = connection[field];
548
- if (values)
549
- for (const key of Object.keys(values))
550
- values[key] = PROVIDER_SECRET_MASK;
551
- }
554
+ function redactProvider(value, includeApiKey = false) {
555
+ const provider = structuredClone(value);
556
+ for (const connection of [provider.common, ...Object.values(provider.services ?? {})]) {
557
+ if (!includeApiKey) {
558
+ const masked = maskProviderApiKey(connection.apiKey, PROVIDER_SECRET_MASK);
559
+ if (masked !== undefined)
560
+ connection.apiKey = masked;
561
+ }
562
+ for (const field of ['headers', 'queryParams']) {
563
+ const values = connection[field];
564
+ if (values)
565
+ for (const key of Object.keys(values))
566
+ values[key] = PROVIDER_SECRET_MASK;
552
567
  }
553
568
  }
569
+ return provider;
570
+ }
571
+ function providersSnapshot(value) {
572
+ const providers = Object.fromEntries(Object.entries(value.providers).map(([id, provider]) => [id, redactProvider(provider)]));
554
573
  return {
555
574
  ...(value.$schema_version !== undefined ? { $schema_version: value.$schema_version } : {}),
556
575
  ...(value.nextId !== undefined ? { nextId: value.nextId } : {}),
@@ -559,6 +578,20 @@ function providersSnapshot(value) {
559
578
  revision: providersRevision(value),
560
579
  };
561
580
  }
581
+ /** The internal name is fixed at creation; discard submitted names before validation. */
582
+ function retainProviderName(value, previous) {
583
+ if (!previous || !value || typeof value !== 'object' || Array.isArray(value))
584
+ return value;
585
+ const provider = { ...value };
586
+ delete provider.name;
587
+ if (previous.name !== undefined)
588
+ provider.name = previous.name;
589
+ const common = provider.common;
590
+ if (common && typeof common === 'object' && !Array.isArray(common)
591
+ && common.baseUrl !== previous.common.baseUrl && provider.domain === previous.domain)
592
+ delete provider.domain;
593
+ return provider;
594
+ }
562
595
  function retainSecrets(value, previous) {
563
596
  if (!value || typeof value !== 'object' || Array.isArray(value))
564
597
  return value;
@@ -567,14 +600,16 @@ function retainSecrets(value, previous) {
567
600
  return provider;
568
601
  const connections = [[provider.common, previous?.common],
569
602
  ...Object.entries(provider.services ?? {}).map(([type, service]) => [service, previous?.services?.[type]])];
603
+ /** Masked pool entries are restored position by position; a new position must carry a real key. */
604
+ const retained = (target, field, old) => {
605
+ const restored = retainProviderApiKey(target[field], old, PROVIDER_SECRET_MASK);
606
+ if (restored !== undefined)
607
+ target[field] = restored;
608
+ };
570
609
  for (const [common, old] of connections) {
571
610
  if (!common || typeof common !== 'object')
572
611
  continue;
573
- if (common.apiKey === PROVIDER_SECRET_MASK) {
574
- if (old?.apiKey === undefined)
575
- throw new Error('A replacement API key is required');
576
- common.apiKey = old.apiKey;
577
- }
612
+ retained(common, 'apiKey', old?.apiKey);
578
613
  for (const field of ['headers', 'queryParams']) {
579
614
  if (!common[field] || typeof common[field] !== 'object' || Array.isArray(common[field]))
580
615
  continue;
@@ -591,7 +626,7 @@ function retainSecrets(value, previous) {
591
626
  return provider;
592
627
  }
593
628
  export function resolveProviderDraftService(input, file = resolvePaths().providersConfig) {
594
- if (!/^[A-Za-z0-9_-]+$/u.test(input.providerId) || ['__proto__', 'constructor', 'prototype'].includes(input.providerId)) {
629
+ if (!isProviderId(input.providerId)) {
595
630
  throw new Error('Invalid provider identifier');
596
631
  }
597
632
  const current = readProvidersFile(file);
@@ -608,7 +643,7 @@ export function resolveProviderDraftService(input, file = resolvePaths().provide
608
643
  return resolveProviderService(providerId, input.serviceType, { providers: { [providerId]: provider } });
609
644
  }
610
645
  export async function updateProvider(input, file = resolvePaths().providersConfig) {
611
- if (!/^[A-Za-z0-9_-]+$/u.test(input.providerId) || ['__proto__', 'constructor', 'prototype'].includes(input.providerId)) {
646
+ if (!isProviderId(input.providerId)) {
612
647
  throw new Error('Invalid provider identifier');
613
648
  }
614
649
  const result = mutateConfig(ConfigTarget.Providers, { providerFile: file }, config => {
@@ -627,11 +662,9 @@ export async function updateProvider(input, file = resolvePaths().providersConfi
627
662
  }
628
663
  else {
629
664
  const previous = current.providers[providerId];
630
- const value = retainSecrets(input.value, previous);
665
+ const value = retainProviderName(retainSecrets(input.value, previous), previous);
631
666
  const normalized = validateProvidersFile({ providers: { draft: value } }).providers.draft;
632
667
  assertProviderDomainUnchanged(previous, normalized);
633
- if (normalized.name !== undefined)
634
- normalized.name = validateProviderName(normalized.name);
635
668
  current.providers[providerId] = normalized;
636
669
  }
637
670
  return current;
@@ -641,7 +674,7 @@ export async function updateProvider(input, file = resolvePaths().providersConfi
641
674
  function rejectMaskedImportSecrets(providers) {
642
675
  for (const [providerId, provider] of Object.entries(providers)) {
643
676
  for (const connection of [provider.common, ...Object.values(provider.services ?? {})]) {
644
- if (connection.apiKey === PROVIDER_SECRET_MASK) {
677
+ if (providerApiKeyEntries(connection.apiKey).includes(PROVIDER_SECRET_MASK)) {
645
678
  throw new Error(`Provider ${providerId} has a redacted API key; import a file with the original secret`);
646
679
  }
647
680
  for (const field of ['headers', 'queryParams']) {
@@ -707,26 +740,12 @@ function removeProviderAliases(config, providerId) {
707
740
  delete config.aliases;
708
741
  }
709
742
  function assertProviderDomainUnchanged(previous, next) {
710
- let previousDomain;
711
- try {
712
- previousDomain = providerIdentity(previous).domain;
713
- }
714
- catch (error) {
715
- const code = error?.code;
716
- if (previous.domain === undefined && ['PROVIDER_DOMAIN_REQUIRED', 'PROVIDER_DOMAIN_INVALID', 'PROVIDER_BASE_URL_MISSING'].includes(code ?? '')) {
717
- if (previous.common.baseUrl === next.common.baseUrl) {
718
- if (next.domain !== undefined)
719
- next.domain = providerIdentity(next).domain;
720
- return;
721
- }
722
- }
723
- throw error;
724
- }
725
- const identity = providerIdentity(next);
726
- if (identity.domain !== previousDomain) {
727
- throw Object.assign(new Error('Provider domain is immutable; create a different Provider'), { code: 'PROVIDER_DOMAIN_IMMUTABLE' });
728
- }
729
- next.domain = identity.domain;
743
+ if (previous.name !== next.name)
744
+ throw Object.assign(new Error('Provider name is immutable; change displayName instead'), { code: 'PROVIDER_NAME_IMMUTABLE' });
745
+ if (previous.common.baseUrl !== next.common.baseUrl && next.domain === previous.domain)
746
+ delete next.domain;
747
+ if (next.domain !== undefined)
748
+ next.domain = providerIdentity(next).domain;
730
749
  }
731
750
  function existingProviderDomain(provider) {
732
751
  try {
@@ -739,23 +758,14 @@ function existingProviderDomain(provider) {
739
758
  function availableProviderId(config, provider) {
740
759
  const identity = providerIdentity(provider);
741
760
  provider.domain = identity.domain;
742
- for (const [existingId, existing] of Object.entries(config.providers)) {
743
- const domain = existingProviderDomain(existing);
744
- if (existingId === identity.providerId && domain !== identity.domain) {
745
- throw Object.assign(new Error('Provider ID hash collision; no ID was reassigned'), {
746
- code: 'PROVIDER_ID_COLLISION', statusCode: 409, data: { kind: 'provider_id_collision', providerId: identity.providerId, domain: identity.domain, existingDomain: domain },
747
- });
748
- }
749
- if (domain === identity.domain) {
750
- throw Object.assign(new Error('Provider domain already exists; update or explicitly merge it'), {
751
- code: 'PROVIDER_CONFLICT', statusCode: 409, data: { kind: 'provider_domain_exists', providerId: existingId, domain },
752
- });
753
- }
754
- }
755
- if (Object.hasOwn(config.aliases ?? {}, identity.providerId)) {
756
- throw Object.assign(new Error('Provider ID conflicts with a legacy alias'), { code: 'PROVIDER_ID_COLLISION', statusCode: 409 });
761
+ const name = validateProviderName(provider.name);
762
+ if (Object.hasOwn(config.providers, name) || Object.hasOwn(config.aliases ?? {}, name)
763
+ || Object.values(config.providers).some(existing => existing.name === name)) {
764
+ throw Object.assign(new Error('Provider name already exists; choose a different name'), {
765
+ code: 'PROVIDER_NAME_EXISTS', statusCode: 409, data: { kind: 'provider_name_exists', name },
766
+ });
757
767
  }
758
- return identity.providerId;
768
+ return name;
759
769
  }
760
770
  export async function createProvider(input, file = resolvePaths().providersConfig) {
761
771
  if (!/^[a-f0-9]{64}$/u.test(input.revision))
@@ -763,9 +773,7 @@ export async function createProvider(input, file = resolvePaths().providersConfi
763
773
  const normalized = validateProvidersFile({ providers: { imported: input.value } });
764
774
  rejectMaskedImportSecrets(normalized.providers);
765
775
  const provider = normalized.providers.imported;
766
- provider.name ||= providerNameFromBaseUrlIfStatic(provider.common.baseUrl);
767
- if (provider.name !== undefined)
768
- provider.name = validateProviderName(provider.name);
776
+ provider.name = validateProviderName(provider.name);
769
777
  const result = mutateConfig(ConfigTarget.Providers, { providerFile: file }, config => {
770
778
  const current = config;
771
779
  if (providersRevision(current) !== input.revision) {
@@ -773,9 +781,6 @@ export async function createProvider(input, file = resolvePaths().providersConfi
773
781
  }
774
782
  const identity = providerIdentity(provider);
775
783
  provider.domain = identity.domain;
776
- const existing = current.providers[identity.providerId];
777
- if (existing && isDeepStrictEqual(existing, provider))
778
- return { current, providerId: identity.providerId };
779
784
  const providerId = availableProviderId(current, provider);
780
785
  current.providers[providerId] = provider;
781
786
  delete current.nextId;
@@ -784,27 +789,7 @@ export async function createProvider(input, file = resolvePaths().providersConfi
784
789
  return { ...providersSnapshot(result.value.current), providerId: result.value.providerId };
785
790
  }
786
791
  function upgradeProviderId(current, oldId) {
787
- const provider = current.providers[oldId];
788
- const identity = providerIdentity(provider);
789
- provider.domain = identity.domain;
790
- if (oldId === identity.providerId)
791
- return oldId;
792
- const remaining = { ...current.providers };
793
- delete remaining[oldId];
794
- const aliases = { ...current.aliases };
795
- if (aliases[identity.providerId] === oldId)
796
- delete aliases[identity.providerId];
797
- const providerId = availableProviderId({ providers: remaining, aliases }, provider);
798
- for (const [alias, target] of Object.entries(aliases)) {
799
- if (target === oldId)
800
- aliases[alias] = providerId;
801
- }
802
- aliases[oldId] = providerId;
803
- delete current.providers[oldId];
804
- current.providers[providerId] = provider;
805
- current.aliases = aliases;
806
- delete current.nextId;
807
- return providerId;
792
+ return oldId;
808
793
  }
809
794
  async function mutateProvidersWithIdentityUpgrade(revision, file, mutation) {
810
795
  if (!/^[a-f0-9]{64}$/u.test(revision))
@@ -857,8 +842,10 @@ function providerHostname(baseUrl) {
857
842
  }
858
843
  function mergeImportedProvider(existing, imported, replaceServiceTypes = new Set(), preserveCommon = false) {
859
844
  const services = structuredClone(existing.services || {});
845
+ // An existing pool wins as a whole; importing never partially overwrites stored keys.
846
+ const existingHasKey = providerApiKeyEntries(existing.common.apiKey).some(key => key.trim());
860
847
  const common = { ...existing.common,
861
- ...(!preserveCommon && !existing.common.apiKey?.trim() && imported.common.apiKey ? { apiKey: imported.common.apiKey } : {}),
848
+ ...(!preserveCommon && !existingHasKey && imported.common.apiKey ? { apiKey: imported.common.apiKey } : {}),
862
849
  };
863
850
  const existingVariable = providerEnvironmentVariable(existing.common.baseUrl);
864
851
  const importedVariable = providerEnvironmentVariable(imported.common.baseUrl);
@@ -923,7 +910,7 @@ function resolveDraftProvider(value, previous, imports = []) {
923
910
  }
924
911
  secretSource = secretSource ? mergeImportedProvider(secretSource, imported, source ? new Set(Object.keys(imported.services ?? {})) : undefined, !!source) : imported;
925
912
  }
926
- const provider = validateProvidersFile({ providers: { draft: retainSecrets(value, secretSource) } }).providers.draft;
913
+ const provider = validateProvidersFile({ providers: { draft: retainProviderName(retainSecrets(value, secretSource), previous) } }).providers.draft;
927
914
  if (imports.length && secretSource && providerIdentity(provider).domain !== providerIdentity(secretSource).domain) {
928
915
  throw new Error('Imported Provider domain does not match the draft Provider');
929
916
  }
@@ -934,7 +921,7 @@ export async function saveProviderChanges(input, file = resolvePaths().providers
934
921
  throw new Error('Provider changes are required');
935
922
  const identifiers = new Set();
936
923
  for (const change of input.changes) {
937
- if (!change || typeof change.providerId !== 'string' || !/^[A-Za-z0-9_-]+$/u.test(change.providerId)
924
+ if (!change || typeof change.providerId !== 'string' || !isProviderId(change.providerId)
938
925
  || ['__proto__', 'constructor', 'prototype'].includes(change.providerId) || identifiers.has(change.providerId)) {
939
926
  throw new Error('Invalid or duplicate provider identifier');
940
927
  }
@@ -971,9 +958,11 @@ export async function saveProviderChanges(input, file = resolvePaths().providers
971
958
  const provider = resolveDraftProvider(change.value, previous, change.imports);
972
959
  if (previous)
973
960
  assertProviderDomainUnchanged(previous, provider);
974
- provider.name ||= providerNameFromBaseUrlIfStatic(provider.common.baseUrl);
975
- if (provider.name !== undefined)
976
- provider.name = validateProviderName(provider.name);
961
+ if (change.create) {
962
+ provider.name ||= providerNameFromBaseUrlIfStatic(provider.common.baseUrl);
963
+ if (provider.name !== undefined)
964
+ provider.name = validateProviderName(provider.name);
965
+ }
977
966
  let providerId = change.create ? availableProviderId(current, provider) : targetId;
978
967
  if (change.create)
979
968
  delete current.nextId;
@@ -990,14 +979,16 @@ export function importBaseagentProviderIntoRegistry(current, input) {
990
979
  const normalized = validateProvidersFile({ providers: { imported: input.value } });
991
980
  rejectMaskedImportSecrets(normalized.providers);
992
981
  const imported = normalized.providers.imported;
993
- imported.name ||= providerNameFromBaseUrlIfStatic(imported.common.baseUrl);
982
+ imported.name ||= providerNameForBaseagentImport(imported.common.baseUrl, Object.keys(imported.services ?? {}).find(type => ['claude', 'codex', 'gemini'].includes(type)) ?? '');
994
983
  if (input.name !== undefined)
995
984
  imported.name = validateProviderName(input.name);
996
985
  if (input.resolution === 'cancel')
997
986
  throw Object.assign(new Error('Provider import cancelled'), { code: 'CANCELLED', statusCode: 409 });
998
987
  const identity = providerIdentity(imported);
999
988
  imported.domain = identity.domain;
1000
- const match = Object.entries(current.providers).find(([, provider]) => existingProviderDomain(provider) === identity.domain);
989
+ const match = input.resolution === 'merge'
990
+ ? Object.entries(current.providers).find(([id, provider]) => id === imported.name || provider.name === imported.name)
991
+ : undefined;
1001
992
  if (match && input.requireResolution && input.resolution === undefined) {
1002
993
  const [providerId, existing] = match;
1003
994
  throw Object.assign(new Error('Provider conflict requires an explicit resolution'), {
@@ -3,7 +3,6 @@ import { parseConfigSelector } from '../cli/config-selector.js';
3
3
  import { parseConfigFieldValue, resolveConfigFieldRule, } from './config-field-policy.js';
4
4
  import { isAgentOnlyBaseagentField } from './config-field-policy.js';
5
5
  import { ConfigError, routeFieldPath } from './config-manager.js';
6
- import { isValidAid } from '../aun/aid/validation.js';
7
6
  const SELECTOR_OPTIONS = {
8
7
  '--self': 'value',
9
8
  '--peer': 'value',
@@ -187,19 +186,7 @@ function resolveFieldCommand(argv, subcommand, options = {}) {
187
186
  const rawValue = subcommand === 'set' ? business.values[1] : undefined;
188
187
  let value;
189
188
  if (subcommand === 'set') {
190
- if (field === 'owner') {
191
- const owner = rawValue.trim();
192
- if (!isValidAid(owner))
193
- return { ok: false, code: 'INVALID_CONFIG_VALUE', reason: `Invalid owner AID: ${JSON.stringify(rawValue)}` };
194
- value = owner;
195
- }
196
- else if (field === 'owners') {
197
- const parsedOwners = parseOwnersValue(rawValue);
198
- if (!parsedOwners.ok)
199
- return parsedOwners;
200
- value = parsedOwners.value;
201
- }
202
- else if (isRelationRole) {
189
+ if (isRelationRole) {
203
190
  const raw = rawValue.trim();
204
191
  if (!raw)
205
192
  return { ok: false, code: 'INVALID_CONFIG_VALUE', reason: 'Config field role cannot be empty' };
@@ -553,34 +540,6 @@ function coerceConfigValue(raw, route, field) {
553
540
  return { ok: true, value: Number(raw) };
554
541
  return { ok: true, value: raw };
555
542
  }
556
- function parseOwnersValue(raw) {
557
- let values;
558
- const trimmed = raw.trim();
559
- if (trimmed.startsWith('[')) {
560
- try {
561
- values = JSON.parse(trimmed);
562
- }
563
- catch {
564
- return { ok: false, code: 'INVALID_CONFIG_VALUE', reason: 'owners must be a valid JSON array of AIDs' };
565
- }
566
- if (!Array.isArray(values)) {
567
- return { ok: false, code: 'INVALID_CONFIG_VALUE', reason: 'owners must be a JSON array of AIDs' };
568
- }
569
- }
570
- else {
571
- values = [raw];
572
- }
573
- if (!Array.isArray(values) || values.length === 0) {
574
- return { ok: false, code: 'INVALID_CONFIG_VALUE', reason: 'owners must contain at least one AID' };
575
- }
576
- const owners = [...new Set(values
577
- .filter((value) => typeof value === 'string' && !!value.trim())
578
- .map(value => value.trim()))];
579
- if (owners.length === 0 || owners.some(owner => !isValidAid(owner))) {
580
- return { ok: false, code: 'INVALID_CONFIG_VALUE', reason: `Invalid owner AID: ${JSON.stringify(owners)}` };
581
- }
582
- return { ok: true, value: owners };
583
- }
584
543
  function configErrorResult(error) {
585
544
  if (error instanceof ConfigError)
586
545
  return { ok: false, code: error.code, reason: error.message };