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,7 +1,6 @@
1
1
  import fs from 'node:fs';
2
2
  import path from 'node:path';
3
3
  import { isDeepStrictEqual } from 'node:util';
4
- import { providerIdentity } from './provider-identity.js';
5
4
  import { initializationRuntimePlan, providerEnvironmentVariable, providerServiceTypeForBaseagent, providerServiceTypeForPurpose, resolveProviderId, } from './providers-config.js';
6
5
  import { validateProvidersFile } from './providers-config.js';
7
6
  import { loadSchema } from './schema-registry.js';
@@ -165,113 +164,15 @@ export function planProviderIdentityMigration(home, registry, options = {}) {
165
164
  throw new Error('Provider migration requires object configurations');
166
165
  return { text, value: value };
167
166
  };
168
- if (!fs.existsSync(providerFile) && !registry)
169
- return {
170
- home, changes, summary, pending, expected, registry: { providers: {} },
171
- sourceRegistry: { providers: {} }, providerMapping: {},
172
- };
173
167
  const original = fs.existsSync(providerFile) ? readJson(providerFile) : { text: null, value: { providers: {} } };
174
168
  if (original.text === null)
175
169
  expected.push({ file: providerFile, before: null });
176
170
  const source = validateProvidersFile(registry ?? original.value);
177
171
  const providers = {};
178
172
  const mapping = {};
179
- const sourceIds = new Map();
180
- const mergeServicesFrom = (target, source, providerIds) => {
181
- const targetBase = target.common.baseUrl;
182
- const sourceBase = source.common.baseUrl;
183
- const staticUrls = !providerEnvironmentVariable(targetBase) && !providerEnvironmentVariable(sourceBase);
184
- const conflicts = [];
185
- const targetCommon = { ...target.common, baseUrl: staticUrls ? new URL(targetBase).origin : targetBase };
186
- const sourceCommon = { ...source.common, baseUrl: staticUrls ? new URL(sourceBase).origin : sourceBase };
187
- for (const field of ['baseUrl', 'apiKey', 'headers', 'queryParams']) {
188
- if (!isDeepStrictEqual(targetCommon[field], sourceCommon[field]))
189
- conflicts.push(`common.${field}`);
190
- }
191
- const services = { ...(target.services ?? {}) };
192
- for (const [serviceType, rawService] of Object.entries(source.services ?? {})) {
193
- let service = rawService;
194
- if (staticUrls && targetBase !== sourceBase && new URL(targetBase).origin === new URL(sourceBase).origin) {
195
- const resolved = new URL(rawService.path || '.', sourceBase.endsWith('/') ? sourceBase : `${sourceBase}/`);
196
- service = { ...rawService, path: `${resolved.pathname}${resolved.search}${resolved.hash}` };
197
- if (rawService.catalogPath !== undefined) {
198
- service.catalogPath = new URL(rawService.catalogPath, sourceBase.replace(/\/+$/u, '') + '/').pathname;
199
- }
200
- }
201
- if (Object.hasOwn(services, serviceType)) {
202
- const existing = services[serviceType];
203
- const equivalent = staticUrls
204
- ? new URL(existing.path || '.', targetBase.endsWith('/') ? targetBase : `${targetBase}/`).href.replace(/\/+$/u, '')
205
- === new URL(rawService.path || '.', sourceBase.endsWith('/') ? sourceBase : `${sourceBase}/`).href.replace(/\/+$/u, '')
206
- && isDeepStrictEqual({ ...existing, path: undefined }, { ...rawService, path: undefined })
207
- : isDeepStrictEqual(existing, service);
208
- if (!equivalent) {
209
- const sameEndpoint = staticUrls
210
- ? new URL(existing.path || '.', targetBase.endsWith('/') ? targetBase : `${targetBase}/`).href.replace(/\/+$/u, '')
211
- === new URL(rawService.path || '.', sourceBase.endsWith('/') ? sourceBase : `${sourceBase}/`).href.replace(/\/+$/u, '')
212
- : isDeepStrictEqual(existing.path, service.path);
213
- if (!sameEndpoint)
214
- conflicts.push(`services.${serviceType}.path`);
215
- for (const field of ['style', 'models', 'modelPolicy', 'catalogPath', 'apiKey', 'headers', 'queryParams']) {
216
- if (!isDeepStrictEqual(existing[field], service[field]))
217
- conflicts.push(`services.${serviceType}.${field}`);
218
- }
219
- }
220
- continue;
221
- }
222
- services[serviceType] = service;
223
- }
224
- if (conflicts.length) {
225
- const message = `Provider migration conflict between ${providerIds.join(', ')} (${target.domain}): `
226
- + `${conflicts.join(', ')} differ; no configuration was changed`;
227
- throw Object.assign(new Error(message), {
228
- code: 'PROVIDER_CONFLICT',
229
- data: { kind: 'provider_migration_conflict', providerIds, domain: target.domain, fields: conflicts },
230
- });
231
- }
232
- target.services = services;
233
- };
234
- for (const [oldId, provider] of Object.entries(source.providers).sort(([left], [right]) => left.localeCompare(right))) {
235
- if (options.preserveProviderIds) {
236
- providers[oldId] = provider;
237
- continue;
238
- }
239
- let identity;
240
- try {
241
- identity = providerIdentity(provider);
242
- }
243
- catch (error) {
244
- const errorCode = error?.code;
245
- const legacyUnresolved = provider.domain === undefined && (providerEnvironmentVariable(provider.common.baseUrl)
246
- ? errorCode === 'PROVIDER_DOMAIN_REQUIRED' : errorCode === 'PROVIDER_DOMAIN_INVALID');
247
- if (!legacyUnresolved)
248
- throw error;
249
- if (Object.hasOwn(providers, oldId)) {
250
- throw Object.assign(new Error(`Provider ID collision with a legacy entry: ${oldId}`), { code: 'PROVIDER_ID_COLLISION' });
251
- }
252
- providers[oldId] = provider;
253
- pending.push(oldId);
254
- summary.skippedProviders++;
255
- continue;
256
- }
257
- const normalized = { ...provider, domain: identity.domain };
258
- const existing = providers[identity.providerId];
259
- if (existing) {
260
- if (existing.domain !== identity.domain) {
261
- throw Object.assign(new Error(`Provider ID collision: ${identity.providerId}`), { code: 'PROVIDER_ID_COLLISION' });
262
- }
263
- mergeServicesFrom(existing, normalized, [...sourceIds.get(identity.providerId), oldId]);
264
- sourceIds.get(identity.providerId).push(oldId);
265
- }
266
- else {
267
- providers[identity.providerId] = normalized;
268
- sourceIds.set(identity.providerId, [oldId]);
269
- }
270
- if (oldId !== identity.providerId) {
271
- mapping[oldId] = identity.providerId;
272
- summary.providersMigrated++;
273
- }
274
- }
173
+ // Provider IDs and entries are independent of endpoint domains. Preserve them verbatim.
174
+ for (const [id, provider] of Object.entries(source.providers))
175
+ providers[id] = provider;
275
176
  const aliases = {};
276
177
  for (const [alias, target] of Object.entries(source.aliases ?? {}))
277
178
  aliases[alias] = mapping[target] ?? target;
@@ -289,15 +190,15 @@ export function planProviderIdentityMigration(home, registry, options = {}) {
289
190
  summary.filesChanged++;
290
191
  };
291
192
  const finish = () => {
292
- if (!isDeepStrictEqual(original.value, normalizedRegistry))
193
+ if ((original.text !== null || Object.keys(providers).length > 0)
194
+ && !isDeepStrictEqual(original.value, normalizedRegistry))
293
195
  queue(providerFile, original.text, normalizedRegistry);
294
196
  const plan = { home, changes, summary, pending, expected, registry: normalizedRegistry,
295
197
  sourceRegistry: source, providerMapping: aliases };
296
198
  validateProviderIdentityMigrationPlan(plan);
297
199
  return plan;
298
200
  };
299
- if (!Object.keys(aliases).length)
300
- return finish();
201
+ // Always scan persisted selections: old IDs may already have lost their aliases.
301
202
  const agentsDir = path.join(home, 'agents');
302
203
  if (fs.existsSync(agentsDir) && fs.lstatSync(agentsDir).isSymbolicLink())
303
204
  throw new Error('Provider migration does not follow agent directory symlinks');
@@ -383,6 +284,24 @@ export function planProviderIdentityMigration(home, registry, options = {}) {
383
284
  let count = 0;
384
285
  count += rewriteSelections(parsed.value.baseagents);
385
286
  count += rewriteSelections(parsed.value.agents);
287
+ for (const key of ['baseagents', 'agents']) {
288
+ const blocks = parsed.value[key];
289
+ if (!blocks || typeof blocks !== 'object' || Array.isArray(blocks))
290
+ continue;
291
+ for (const raw of Object.values(blocks)) {
292
+ if (!raw || typeof raw !== 'object' || Array.isArray(raw))
293
+ continue;
294
+ const selection = raw;
295
+ if (typeof selection.provider !== 'string')
296
+ continue;
297
+ const id = resolveProviderId(selection.provider, normalizedRegistry);
298
+ if (Object.hasOwn(providers, id))
299
+ continue;
300
+ // Removing only the stale override restores defaults/native inheritance.
301
+ delete selection.provider;
302
+ count++;
303
+ }
304
+ }
386
305
  count += rewriteSelections(parsed.value.Services);
387
306
  count += rewriteSelections(parsed.value.decision_model);
388
307
  if (path.basename(file) === 'initialization.json') {
@@ -4,15 +4,14 @@ import { TextDecoder } from 'node:util';
4
4
  import { auditCommandAuthorization } from '../core/auth/authorization-audit.js';
5
5
  import { applyProviderTemplate, createProvider, parseProviderImport, readProvidersSnapshot, updateProvider } from './providers-management.js';
6
6
  import { parseProviderTemplateInput, providerTemplateDetail, readProviderTemplates } from './provider-templates.js';
7
- import { resolveProviderId } from './providers-config.js';
7
+ import { isProviderId, resolveProviderId } from './providers-config.js';
8
8
  import { normalizeProviderDomain } from './provider-identity.js';
9
9
  export const PROVIDER_INPUT_LIMIT = 1024 * 1024;
10
10
  export function providerArgumentError(message) {
11
11
  throw Object.assign(new Error(message), { code: 'INVALID_ARGUMENT' });
12
12
  }
13
13
  export function assertProviderId(value) {
14
- if (typeof value !== 'string' || !/^[A-Za-z0-9_-]+$/u.test(value)
15
- || ['__proto__', 'constructor', 'prototype'].includes(value)) {
14
+ if (!isProviderId(value)) {
16
15
  providerArgumentError('A valid Provider ID is required');
17
16
  }
18
17
  }
@@ -79,6 +78,14 @@ export function parseProviderCommand(argv) {
79
78
  return { operation, providerId: needsId ? positional[0] : undefined, file: options.get('--file'), templateId, templateInput, json: options.has('--format') };
80
79
  }
81
80
  export function parseProviderObject(text) {
81
+ if (text && typeof text === 'object' && !Array.isArray(text)) {
82
+ if (Buffer.byteLength(JSON.stringify(text), 'utf8') > PROVIDER_INPUT_LIMIT) {
83
+ providerArgumentError('Provider JSON must be UTF-8 text under 1 MiB');
84
+ }
85
+ if (!Object.hasOwn(text, 'common'))
86
+ providerArgumentError('Expected one complete Provider object');
87
+ return text;
88
+ }
82
89
  if (typeof text !== 'string' || Buffer.byteLength(text, 'utf8') > PROVIDER_INPUT_LIMIT) {
83
90
  providerArgumentError('Provider JSON must be UTF-8 text under 1 MiB');
84
91
  }
@@ -98,6 +105,9 @@ export function providerFailure(error) {
98
105
  const failure = error;
99
106
  if (failure?.code === 'NOT_FOUND')
100
107
  return { ok: false, code: 'NOT_FOUND', error: 'Provider not found' };
108
+ if (failure?.code === 'PROVIDER_NAME_EXISTS') {
109
+ return { ok: false, code: 'CONFLICT', error: 'Provider name already exists; choose a different name', data: failure.data };
110
+ }
101
111
  if (failure?.code === 'PROVIDER_CONFLICT' && failure.data && typeof failure.data === 'object') {
102
112
  const details = failure.data;
103
113
  if (details.kind === 'provider_domain_exists' && typeof details.providerId === 'string'
@@ -57,7 +57,10 @@ export async function syncLocalProviders() {
57
57
  }
58
58
  planProviderIdentityMigration(home, registry);
59
59
  const imports = listBaseagentImportSources().map(source => {
60
- const result = importBaseagentProviderIntoRegistry(registry, { value: materializeBaseUrl(providerFromBaseagent(source.baseagent)) });
60
+ const name = `本地 ${source.baseagent}`;
61
+ if (Object.hasOwn(registry.providers, name))
62
+ return { baseagent: source.baseagent, providerId: name, merged: false };
63
+ const result = importBaseagentProviderIntoRegistry(registry, { value: materializeBaseUrl(providerFromBaseagent(source.baseagent)), name });
61
64
  return { baseagent: source.baseagent, providerId: result.providerId, merged: result.merged };
62
65
  });
63
66
  const plan = planProviderIdentityMigration(home, registry);
@@ -1,5 +1,9 @@
1
1
  import { assertProviderId, parseProviderObject, PROVIDER_INPUT_LIMIT, providerArgumentError } from './provider-ipc-service.js';
2
2
  import { parseProviderTemplateInput } from './provider-templates.js';
3
+ export function isProviderDetailMenuRequest(request) {
4
+ return request.type === 'menu.query' && (request.name === 'provider' || request.cmd === '/provider')
5
+ && request.args?.view === 'detail';
6
+ }
3
7
  export function validateProviderMenuRequest(request) {
4
8
  try {
5
9
  if ((request.name !== undefined && request.name !== 'provider')
@@ -48,8 +52,18 @@ export function validateProviderMenuRequest(request) {
48
52
  }
49
53
  if (request.type !== 'menu.action' && request.action !== undefined)
50
54
  providerArgumentError('Unexpected Provider action');
51
- if (request.type !== 'menu.update' && request.value !== undefined)
55
+ if (request.type !== 'menu.update' && request.value !== undefined
56
+ && !(request.type === 'menu.action' && request.action === 'create' && args.templateId === undefined)) {
52
57
  providerArgumentError('Unexpected Provider value');
58
+ }
59
+ if (request.type === 'menu.action' && request.action === 'create' && args.templateId === undefined) {
60
+ if (args.provider === undefined && request.value === undefined)
61
+ providerArgumentError('Create requires args.provider or value');
62
+ if (args.provider !== undefined && request.value !== undefined)
63
+ providerArgumentError('Create accepts args.provider or value, not both');
64
+ if (request.value !== undefined)
65
+ parseProviderObject(request.value);
66
+ }
53
67
  if (args.templateId !== undefined && (typeof args.templateId !== 'string' || !/^[a-z0-9][a-z0-9-]{0,63}$/u.test(args.templateId)))
54
68
  providerArgumentError('Invalid template ID');
55
69
  if ((request.action === 'preview-template' || args.resource === 'provider-template') && !args.templateId)
@@ -63,8 +77,12 @@ export function validateProviderMenuRequest(request) {
63
77
  else {
64
78
  if (request.type === 'menu.update')
65
79
  parseProviderObject(request.value);
66
- if (request.action === 'create')
67
- parseProviderObject(JSON.stringify(args.provider));
80
+ if (request.action === 'create') {
81
+ if (args.provider !== undefined)
82
+ parseProviderObject(JSON.stringify(args.provider));
83
+ else
84
+ parseProviderObject(request.value);
85
+ }
68
86
  }
69
87
  if (request.action === 'import' && (typeof args.text !== 'string' || !args.text.trim()
70
88
  || Buffer.byteLength(args.text, 'utf8') > PROVIDER_INPUT_LIMIT))
@@ -1,7 +1,7 @@
1
1
  import path from 'node:path';
2
2
  import { createHash } from 'node:crypto';
3
3
  import { kitsDir } from '../paths.js';
4
- import { fileCache } from '../core/daemon-file-cache.js';
4
+ import { fileCache } from '../core/daemon/daemon-file-cache.js';
5
5
  import { providerIdentity } from './provider-identity.js';
6
6
  import { validateProviderName, validateProvidersFile } from './providers-config.js';
7
7
  function invalid(message, code = 'INVALID_ARGUMENT') {
@@ -1,5 +1,6 @@
1
1
  import { isDeepStrictEqual } from 'node:util';
2
2
  import { isIP } from 'node:net';
3
+ import { logger } from '../utils/logger.js';
3
4
  import { normalizeProviderDomain, providerIdentity } from './provider-identity.js';
4
5
  /** Tokenize model patterns without interpreting regex or filesystem glob syntax. */
5
6
  function modelPatternTokens(pattern) {
@@ -81,6 +82,95 @@ function assertProviderEnvironmentSyntax(value, field) {
81
82
  throw new Error(`${field} must use a whole-field environment reference ($VAR or \${VAR})`);
82
83
  }
83
84
  }
85
+ /** Upper bound for one Provider key pool; a longer pool is a misconfiguration, not a failover plan. */
86
+ export const MAX_PROVIDER_API_KEYS = 16;
87
+ /** Ordered pool view of a stored key field; a plain string is a one-key pool. */
88
+ export function providerApiKeyEntries(value) {
89
+ if (value === undefined)
90
+ return [];
91
+ return Array.isArray(value) ? value : [value];
92
+ }
93
+ /** Store a one-key pool as the plain string so legacy files round-trip byte-identically. */
94
+ export function providerApiKeyStoreShape(keys) {
95
+ if (!keys.length)
96
+ return undefined;
97
+ return keys.length === 1 ? keys[0] : keys;
98
+ }
99
+ /** Validate and normalize a key pool on the write path. */
100
+ function providerApiKeyValue(value, field) {
101
+ if (value === undefined)
102
+ return undefined;
103
+ const list = Array.isArray(value) ? value : [value];
104
+ if (!list.length)
105
+ throw new Error(`${field} must contain at least one API key`);
106
+ if (list.length > MAX_PROVIDER_API_KEYS)
107
+ throw new Error(`${field} accepts at most ${MAX_PROVIDER_API_KEYS} API keys`);
108
+ const keys = [];
109
+ for (const entry of list) {
110
+ if (typeof entry !== 'string')
111
+ throw new Error(`${field} must be a string or an array of strings`);
112
+ assertProviderEnvironmentSyntax(entry, field);
113
+ keys.push(entry);
114
+ }
115
+ const seen = new Set();
116
+ for (const key of keys) {
117
+ const normalized = key.trim();
118
+ if (!normalized)
119
+ continue;
120
+ if (seen.has(normalized))
121
+ throw new Error(`${field} contains a duplicate API key`);
122
+ seen.add(normalized);
123
+ }
124
+ return providerApiKeyStoreShape(keys);
125
+ }
126
+ /** Mask every literal key in a pool; environment references stay readable. */
127
+ export function maskProviderApiKey(value, mask) {
128
+ const keys = providerApiKeyEntries(value);
129
+ if (!keys.length)
130
+ return undefined;
131
+ return providerApiKeyStoreShape(keys.map(key => providerEnvironmentVariable(key) ? key : mask));
132
+ }
133
+ /** Restore masked pool entries position by position; a new position must carry a real key. */
134
+ export function retainProviderApiKey(value, previous, mask) {
135
+ if (value === undefined)
136
+ return undefined;
137
+ const old = providerApiKeyEntries(previous);
138
+ const merged = providerApiKeyEntries(value).map((key, index) => {
139
+ if (key !== mask)
140
+ return key;
141
+ const existing = old[index];
142
+ if (existing === undefined)
143
+ throw new Error(`A replacement API key at position ${index + 1} is required`);
144
+ return existing;
145
+ });
146
+ return providerApiKeyStoreShape(merged);
147
+ }
148
+ /**
149
+ * Resolve the ordered pool. The primary stays strict: an unset environment
150
+ * reference there is a broken connection and must fail loudly. A backup that
151
+ * cannot resolve is dropped with a warning so a stale backup never disables a
152
+ * working primary.
153
+ */
154
+ export function resolveProviderApiKeys(providerId, value, scope) {
155
+ const resolved = [];
156
+ const dropped = [];
157
+ for (const [index, key] of providerApiKeyEntries(value).entries()) {
158
+ if (index === 0) {
159
+ resolved.push(resolveProviderEnvironmentValue(providerId, 'apiKey', key, scope));
160
+ continue;
161
+ }
162
+ try {
163
+ resolved.push(resolveProviderEnvironmentValue(providerId, 'apiKey', key, scope));
164
+ }
165
+ catch {
166
+ dropped.push(index + 1);
167
+ }
168
+ }
169
+ if (dropped.length) {
170
+ logger.warn(`[providers] ${providerId} ${scope}.apiKey ignored unresolvable backup key(s) at position ${dropped.join(', ')}`);
171
+ }
172
+ return resolved;
173
+ }
84
174
  function resolveProviderEnvironmentValue(providerId, field, value, scope = 'common') {
85
175
  const variable = providerEnvironmentVariable(value);
86
176
  if (!variable)
@@ -120,12 +210,25 @@ export function providerNameFromBaseUrl(baseUrl) {
120
210
  export function providerNameFromBaseUrlIfStatic(baseUrl) {
121
211
  return providerEnvironmentVariable(baseUrl) ? undefined : providerNameFromBaseUrl(baseUrl);
122
212
  }
213
+ /** IP literals are endpoint metadata, not valid registry names. */
214
+ export function providerNameForBaseagentImport(baseUrl, baseagent) {
215
+ const name = providerNameFromBaseUrlIfStatic(baseUrl);
216
+ if (name && isIP(name.replace(/^\[|\]$/gu, ''))) {
217
+ const labels = { claude: 'Claude', codex: 'Codex', gemini: 'Gemini' };
218
+ const label = labels[baseagent];
219
+ if (label)
220
+ return `${label} API`;
221
+ }
222
+ return name;
223
+ }
123
224
  export function providerServiceTypeForPurpose(purpose) {
124
225
  return purpose === 'auxiliary' ? 'text' : purpose;
125
226
  }
126
227
  export function providerServiceTypesForBaseagent(baseagent) {
127
228
  if (baseagent === 'ecagent')
128
229
  return ['ecagent', 'text'];
230
+ if (baseagent === 'dsh')
231
+ return ['dsh', 'claude'];
129
232
  return ['claude', 'codex', 'gemini'].includes(baseagent)
130
233
  ? [baseagent]
131
234
  : [...new Set(['text', baseagent])];
@@ -135,6 +238,10 @@ export function providerServiceTypeForBaseagent(baseagent, provider) {
135
238
  return provider?.services && !Object.hasOwn(provider.services, 'ecagent') && Object.hasOwn(provider.services, 'text')
136
239
  ? 'text' : 'ecagent';
137
240
  }
241
+ if (baseagent === 'dsh') {
242
+ return provider?.services && !Object.hasOwn(provider.services, 'dsh') && Object.hasOwn(provider.services, 'claude')
243
+ ? 'claude' : 'dsh';
244
+ }
138
245
  return ['openclaw', 'hermes'].includes(baseagent) ? 'text' : baseagent;
139
246
  }
140
247
  function resolveProviderServiceTypeForBaseagent(baseagent, selectedServiceType, provider) {
@@ -157,11 +264,16 @@ export function validateProviderName(value) {
157
264
  if (typeof value !== 'string')
158
265
  throw new Error('Provider name must be a string');
159
266
  const name = value.trim();
160
- if (name.length < 2 || name.length > 20 || !/^[\p{L}\p{N} _-]+$/u.test(name)) {
267
+ if (name.length < 2 || name.length > 20 || !/^[\p{L}\p{N} _-]+$/u.test(name) || PROHIBITED_PATH_SEGMENTS.has(name)) {
161
268
  throw new Error('Provider name must be 2–20 characters and contain only letters, numbers, spaces, hyphens, or underscores');
162
269
  }
163
270
  return name;
164
271
  }
272
+ export function isProviderId(value) {
273
+ return typeof value === 'string' && value.length > 0 && value.length <= 128
274
+ && value === value.trim() && /^[\p{L}\p{N} _-]+$/u.test(value)
275
+ && !PROHIBITED_PATH_SEGMENTS.has(value);
276
+ }
165
277
  function isRecord(value) {
166
278
  return !!value && typeof value === 'object' && !Array.isArray(value);
167
279
  }
@@ -227,12 +339,9 @@ function serviceConfig(value, field, serviceType) {
227
339
  throw new Error(`${field} must be an object`);
228
340
  assertFields(value, ['path', 'catalogPath', 'style', 'models', 'modelPolicy', 'apiKey', 'headers', 'queryParams'], field);
229
341
  const result = {};
230
- if (value.apiKey !== undefined) {
231
- if (typeof value.apiKey !== 'string')
232
- throw new Error(`${field}.apiKey must be a string`);
233
- assertProviderEnvironmentSyntax(value.apiKey, `${field}.apiKey`);
234
- result.apiKey = value.apiKey;
235
- }
342
+ const apiKey = providerApiKeyValue(value.apiKey, `${field}.apiKey`);
343
+ if (apiKey !== undefined)
344
+ result.apiKey = apiKey;
236
345
  for (const name of ['headers', 'queryParams']) {
237
346
  const values = stringMap(value[name], `${field}.${name}`);
238
347
  if (values !== undefined)
@@ -275,7 +384,7 @@ function serviceConfig(value, field, serviceType) {
275
384
  throw new Error(`${field}.models: manual requires exact model IDs`);
276
385
  assertFields(override, ['enabled'], `${field}.models.${modelId}`);
277
386
  }
278
- const supportsImageInput = ['text', 'claude', 'codex'].includes(serviceType);
387
+ const supportsImageInput = ['text', 'claude', 'codex', 'dsh'].includes(serviceType);
279
388
  const imageMembership = !supportsImageInput && normalized.imageIn !== undefined;
280
389
  if (!supportsImageInput)
281
390
  delete normalized.imageIn;
@@ -290,9 +399,11 @@ function serviceConfig(value, field, serviceType) {
290
399
  function providerConfig(value, field) {
291
400
  if (!isRecord(value))
292
401
  throw new Error(`${field} must be an object`);
293
- assertFields(value, ['name', 'domain', 'common', 'services'], field);
294
- if (value.name !== undefined && typeof value.name !== 'string')
295
- throw new Error(`${field}.name must be a string`);
402
+ assertFields(value, ['name', 'displayName', 'description', 'domain', 'common', 'services'], field);
403
+ for (const key of ['name', 'displayName', 'description']) {
404
+ if (value[key] !== undefined && typeof value[key] !== 'string')
405
+ throw new Error(`${field}.${key} must be a string`);
406
+ }
296
407
  if (!isRecord(value.common))
297
408
  throw new Error(`${field}.common must be an object`);
298
409
  const common = value.common;
@@ -304,16 +415,15 @@ function providerConfig(value, field) {
304
415
  }
305
416
  const headers = stringMap(common.headers, `${field}.common.headers`);
306
417
  const queryParams = stringMap(common.queryParams, `${field}.common.queryParams`);
307
- if (common.apiKey !== undefined && typeof common.apiKey !== 'string')
308
- throw new Error(`${field}.common.apiKey must be a string`);
309
- if (typeof common.apiKey === 'string')
310
- assertProviderEnvironmentSyntax(common.apiKey, `${field}.common.apiKey`);
418
+ const apiKey = providerApiKeyValue(common.apiKey, `${field}.common.apiKey`);
311
419
  const result = {
312
420
  ...(value.domain !== undefined ? { domain: normalizeProviderDomain(value.domain) } : {}),
313
421
  ...(typeof value.name === 'string' && value.name.trim() ? { name: value.name.trim() } : {}),
422
+ ...(typeof value.displayName === 'string' && value.displayName.trim() ? { displayName: value.displayName.trim() } : {}),
423
+ ...(typeof value.description === 'string' && value.description.trim() ? { description: value.description.trim() } : {}),
314
424
  common: {
315
425
  baseUrl,
316
- ...(typeof common.apiKey === 'string' ? { apiKey: common.apiKey } : {}),
426
+ ...(apiKey !== undefined ? { apiKey } : {}),
317
427
  ...(headers ? { headers } : {}),
318
428
  ...(queryParams ? { queryParams } : {}),
319
429
  },
@@ -355,19 +465,17 @@ export function validateProvidersFile(value) {
355
465
  for (const [providerId, provider] of Object.entries(value.providers)) {
356
466
  if (!providerId.trim())
357
467
  throw new Error('provider id cannot be empty');
358
- assertSafeRegistrySegment(providerId, 'provider id');
468
+ if (!isProviderId(providerId))
469
+ throw new Error('provider id must be a safe identifier');
359
470
  providers[providerId] = providerConfig(provider, `providers.${providerId}`);
360
- if (providers[providerId].domain !== undefined && /^provider-\d{8}$/u.test(providerId)
361
- && providerIdentity(providers[providerId]).providerId !== providerId) {
362
- throw new Error(`Provider ID does not match its domain: ${providerId}`);
363
- }
364
471
  }
365
472
  const aliases = {};
366
473
  if (value.aliases !== undefined) {
367
474
  if (!isRecord(value.aliases))
368
475
  throw new Error('providers.json.aliases must be an object');
369
476
  for (const [alias, target] of Object.entries(value.aliases)) {
370
- assertSafeRegistrySegment(alias, 'provider alias');
477
+ if (!isProviderId(alias))
478
+ throw new Error('provider alias must be a safe identifier');
371
479
  if (typeof target !== 'string' || !Object.hasOwn(providers, target) || Object.hasOwn(providers, alias)) {
372
480
  throw new Error('Provider aliases must point directly to an existing Provider without shadowing an ID');
373
481
  }
@@ -382,7 +490,8 @@ export function validateProvidersFile(value) {
382
490
  };
383
491
  }
384
492
  export function resolveProviderId(providerId, config) {
385
- assertSafeRegistrySegment(providerId, 'provider id');
493
+ if (!isProviderId(providerId))
494
+ throw new Error('provider id must be a safe identifier');
386
495
  return config.aliases && Object.hasOwn(config.aliases, providerId) ? config.aliases[providerId] : providerId;
387
496
  }
388
497
  /** Raw credential selection shared by resolution, repair and import merging. */
@@ -394,7 +503,7 @@ export function providerServiceCredentials(provider, serviceType) {
394
503
  queryParams: service?.queryParams ?? provider.common.queryParams,
395
504
  };
396
505
  }
397
- export function resolveProviderService(providerId, serviceType, config, defaultStyle = 'systemone') {
506
+ export function resolveProviderService(providerId, serviceType, config, defaultStyle = serviceType === 'text' ? 'openai-compatible' : 'systemone') {
398
507
  providerId = resolveProviderId(providerId, config);
399
508
  assertSafeRegistrySegment(serviceType, 'service type');
400
509
  const providers = config.providers;
@@ -427,7 +536,7 @@ export function resolveProviderService(providerId, serviceType, config, defaultS
427
536
  const catalogBaseUrl = catalogParsed.toString().replace(/\/+$/u, '');
428
537
  const catalogPath = new URL(catalogBaseUrl).pathname.replace(/\/+$/u, '');
429
538
  const credentials = providerServiceCredentials(provider, serviceType);
430
- if (service.apiKey !== undefined && service.apiKey !== provider.common.apiKey) {
539
+ if (service.apiKey !== undefined && !isDeepStrictEqual(providerApiKeyEntries(service.apiKey), providerApiKeyEntries(provider.common.apiKey))) {
431
540
  const hasSharedAuthHeader = Object.keys(provider.common.headers ?? {})
432
541
  .some(name => ['authorization', 'x-api-key', 'x-goog-api-key', 'api-key'].includes(name.toLowerCase()));
433
542
  const hasSharedAuthQuery = Object.keys(provider.common.queryParams ?? {})
@@ -438,9 +547,7 @@ export function resolveProviderService(providerId, serviceType, config, defaultS
438
547
  });
439
548
  }
440
549
  }
441
- const apiKey = credentials.apiKey === undefined
442
- ? undefined
443
- : resolveProviderEnvironmentValue(providerId, 'apiKey', credentials.apiKey, service.apiKey === undefined ? 'common' : `services.${serviceType}`);
550
+ const apiKeys = resolveProviderApiKeys(providerId, credentials.apiKey, service.apiKey === undefined ? 'common' : `services.${serviceType}`);
444
551
  return {
445
552
  providerId,
446
553
  serviceType,
@@ -448,7 +555,8 @@ export function resolveProviderService(providerId, serviceType, config, defaultS
448
555
  baseUrl: finalUrl,
449
556
  catalogPath,
450
557
  catalogBaseUrl,
451
- apiKey,
558
+ ...(apiKeys.length ? { apiKey: apiKeys[0] } : {}),
559
+ apiKeys,
452
560
  headers: credentials.headers,
453
561
  queryParams: credentials.queryParams,
454
562
  modelOverrides: service.models ?? {},
@@ -492,8 +600,7 @@ export function initializationRuntimePlan(record) {
492
600
  if (!migration || typeof migration !== 'object' || Array.isArray(migration))
493
601
  throw new Error('Invalid initialization Provider migration binding');
494
602
  if (typeof migration.from !== 'string' || migration.from !== record.plan.provider || typeof migration.to !== 'string'
495
- || !/^[A-Za-z0-9_-]+$/u.test(migration.to)
496
- || ['__proto__', 'constructor', 'prototype'].includes(migration.to)) {
603
+ || !isProviderId(migration.to)) {
497
604
  throw new Error('Invalid initialization Provider migration binding');
498
605
  }
499
606
  return { ...record.plan, provider: migration.to };
@@ -1,7 +1,7 @@
1
- import { resolveAnthropicConfig, resolveGoogleConfig, resolveOpenaiConfig, } from '../agents/baseagent.js';
1
+ import { resolveAnthropicConfig, resolveGoogleConfig, resolveOpenaiConfig, } from '../core/baseagent/baseagent.js';
2
2
  import { ConfigTarget, read } from './config-manager.js';
3
3
  import { resolveProjectDefaultPath } from '../utils/project-path.js';
4
- import { providerNameFromBaseUrlIfStatic, providerServiceTypeForBaseagent, validateProvidersFile } from './providers-config.js';
4
+ import { providerNameForBaseagentImport, providerServiceTypeForBaseagent, validateProvidersFile } from './providers-config.js';
5
5
  export const IMPORTABLE_BASEAGENTS = ['claude', 'codex', 'gemini'];
6
6
  function resolveConnection(baseagent, config, projectPath) {
7
7
  if (baseagent === 'claude')
@@ -38,7 +38,7 @@ export function providerFromBaseagent(baseagent) {
38
38
  services: { [serviceType]: { path: '' } },
39
39
  };
40
40
  const normalized = validateProvidersFile({ providers: { imported: provider } }).providers.imported;
41
- normalized.name ||= providerNameFromBaseUrlIfStatic(normalized.common.baseUrl);
41
+ normalized.name ||= providerNameForBaseagentImport(normalized.common.baseUrl, selected);
42
42
  return normalized;
43
43
  }
44
44
  export function listBaseagentImportSources() {