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,19 +1,24 @@
1
+ import { isSupportedBaseagent } from '../core/baseagent/baseagent.js';
1
2
  import crypto from 'crypto';
2
3
  import { isDeepStrictEqual } from 'node:util';
3
4
  import fs from 'fs';
4
5
  import path from 'path';
5
6
  import { resolvePaths } from '../paths.js';
6
- import { acquireConfigMutationLock, ConfigError } from './config-manager.js';
7
+ import { acquireConfigMutationLock, normalizeProcessConfigCompat, stripLegacyAunGatewayConfig, ConfigError } from './config-manager.js';
7
8
  import { firstConfiguredOwner } from './owner-config.js';
8
9
  import { currentVersion, loadSchema } from './schema-registry.js';
9
10
  import { planProviderIdentityMigration, validateProviderIdentityMigrationPlan } from './provider-identity-migration.js';
10
11
  import { providerIdentity } from './provider-identity.js';
12
+ import { providerApiKeyEntries } from './providers-config.js';
11
13
  import { snapshot } from './snapshot.js';
12
14
  import { logger } from '../utils/logger.js';
13
15
  import { parseContactAlias } from './peer-alias.js';
14
16
  import { recoverAllPeerBookMutationsSync } from './peer-book-store.js';
17
+ import { normalizeDaemonServices } from './daemon-services.js';
18
+ import { DAEMON_CONFIG_FILENAME } from '../product.js';
15
19
  import { atomicReplaceFile } from '../utils/atomic-write.js';
16
20
  const MIGRATION_KIND = {
21
+ 'baseagent-declarations-v1': 'agent-only-model',
17
22
  'auxiliary-model-v1': 'auxiliary-model',
18
23
  'agent-only-model-v1': 'agent-only-model',
19
24
  'agent-model-provider-v1': 'agent-only-model',
@@ -26,7 +31,158 @@ const MIGRATION_KIND = {
26
31
  'peer-file-v1': 'agent-only-model',
27
32
  'peer-state-v4': 'agent-only-model',
28
33
  };
29
- const SUPPORTED_BASEAGENTS = new Set(['claude', 'codex', 'gemini', 'ecagent']);
34
+ /** Move legacy deployment intent once. No directory discovery and no Agent/session rewrites. */
35
+ export function runBaseagentDeclarationMigration(options = {}) {
36
+ const home = path.resolve(options.home ?? resolvePaths().root);
37
+ const id = 'baseagent-declarations-v1';
38
+ const marker = path.join(home, 'data', id + '-completed.json');
39
+ // Every CLI process reaches this check. Once migration is committed and no
40
+ // recovery journal remains, don't serialize routine commands on a no-op.
41
+ // A journal must still pass through the lock so interrupted writes recover
42
+ // before the completion marker is trusted.
43
+ if (fs.existsSync(marker) && !fs.existsSync(journalPath(home, id))) {
44
+ return { changedFiles: 0, backup: null };
45
+ }
46
+ const release = acquireLock(home, id);
47
+ try {
48
+ recoverJournal(home, id);
49
+ const daemonFile = path.join(home, DAEMON_CONFIG_FILENAME);
50
+ if (fs.existsSync(marker) || !fs.existsSync(daemonFile))
51
+ return { changedFiles: 0, backup: null };
52
+ const daemon = readJson(daemonFile);
53
+ if (!isRecord(daemon.value))
54
+ throw new Error('Daemon configuration must be an object');
55
+ if (Number(daemon.value.$schema_version) > currentVersion('daemon'))
56
+ return { changedFiles: 0, backup: null };
57
+ const changes = [];
58
+ const next = normalizeProcessConfigCompat(normalizeDaemonServices(stripLegacyAunGatewayConfig(structuredClone(daemon.value), daemonFile, message => logger.warn(message))));
59
+ const defaultsFile = path.join(home, 'agents', 'defaults.json');
60
+ const defaults = fs.existsSync(defaultsFile) ? readJson(defaultsFile) : undefined;
61
+ if (defaults && !isRecord(defaults.value))
62
+ throw new Error('Defaults configuration must be an object');
63
+ if (defaults && isRecord(defaults.value) && Number(defaults.value.$schema_version) > currentVersion('defaults')) {
64
+ throw new Error('Defaults configuration was written by a newer version');
65
+ }
66
+ const blocks = defaults && isRecord(defaults.value) && isRecord(defaults.value.baseagents) ? defaults.value.baseagents : {};
67
+ const names = new Set();
68
+ // v12 already uses explicit declarations. Never resurrect a deliberately removed entry.
69
+ if (Number(next.$schema_version ?? 0) < 12) {
70
+ for (const name of ['claude', 'codex', 'ecagent', ...Object.keys(blocks)])
71
+ names.add(name);
72
+ const inspect = (config) => {
73
+ if (typeof config.active_baseagent === 'string')
74
+ names.add(config.active_baseagent);
75
+ if (isRecord(config.baseagents))
76
+ for (const name of Object.keys(config.baseagents))
77
+ names.add(name);
78
+ };
79
+ if (defaults && isRecord(defaults.value))
80
+ inspect(defaults.value);
81
+ const root = path.join(home, 'agents');
82
+ for (const entry of fs.existsSync(root) ? fs.readdirSync(root, { withFileTypes: true }) : []) {
83
+ if (!entry.isDirectory() || !validAid(entry.name))
84
+ continue;
85
+ const file = path.join(root, entry.name, 'config.json');
86
+ if (!fs.existsSync(file))
87
+ continue;
88
+ try {
89
+ const agent = readJson(file).value;
90
+ if (isRecord(agent))
91
+ inspect(agent);
92
+ else
93
+ logger.warn('[BaseagentPlugins] Skipping invalid Agent configuration: ' + file);
94
+ }
95
+ catch (error) {
96
+ // The regular Agent loader reports this file; it must not prevent
97
+ // other Agents or the control plane from upgrading their declarations.
98
+ logger.warn('[BaseagentPlugins] Cannot inspect Agent configuration: ' + file, error);
99
+ }
100
+ }
101
+ }
102
+ if (next.plugins !== undefined && !isRecord(next.plugins))
103
+ throw new Error('Daemon plugins must be an object');
104
+ const plugins = { ...(isRecord(next.plugins) ? next.plugins : {}) };
105
+ for (const rawName of names) {
106
+ const name = BASEAGENT_ALIASES.get(rawName) ?? rawName;
107
+ if (!/^[a-z][a-z0-9-]{0,31}$/.test(name))
108
+ throw new Error('Invalid legacy baseagent name: ' + name);
109
+ if (hasOwn(plugins, 'baseagent:' + name))
110
+ continue;
111
+ const block = blocks[name];
112
+ const enabled = isRecord(block) && hasOwn(block, 'enabled') ? block.enabled : true;
113
+ if (typeof enabled !== 'boolean')
114
+ throw new Error('Invalid legacy enabled flag: ' + name);
115
+ plugins['baseagent:' + name] = { enabled, force: false };
116
+ }
117
+ next.plugins = plugins;
118
+ // Existing process compatibility normalization retires owner/service fields before this migration.
119
+ next.$schema_version = 12;
120
+ const validate = (name, value) => {
121
+ const schema = loadSchema(name, name === 'defaults' && Number(value.$schema_version) < 7 ? Number(value.$schema_version) : undefined);
122
+ const checked = structuredClone(value);
123
+ // An existing AID never consumes this legacy fallback. Match saveDaemonConfig's compatibility rule.
124
+ if (name === 'daemon' && typeof checked.aid === 'string' && checked.aid && isRecord(checked.aun))
125
+ delete checked.aun.defaultAidDomain;
126
+ if (!schema.validate(checked))
127
+ throw new Error(name + ' migration validation failed: ' + JSON.stringify(schema.validate.errors));
128
+ };
129
+ validate('daemon', next);
130
+ if (!isDeepStrictEqual(next, daemon.value))
131
+ changes.push({ file: daemonFile, kind: 'agent-only-model', before: daemon.text, after: jsonText(next) });
132
+ if (defaults && isRecord(defaults.value)) {
133
+ const value = stripLegacyAunGatewayConfig(structuredClone(defaults.value), defaultsFile, message => logger.warn(message));
134
+ if (isRecord(value.baseagents))
135
+ for (const block of Object.values(value.baseagents))
136
+ if (isRecord(block))
137
+ delete block.enabled;
138
+ // Promote compatible old files before validating plugin names. Historical
139
+ // model/provider fields still belong to their existing migrations.
140
+ const previousVersion = Number(value.$schema_version ?? 1);
141
+ const upgraded = { ...value, $schema_version: currentVersion('defaults') };
142
+ value.$schema_version = previousVersion >= 7 || loadSchema('defaults').validate(upgraded)
143
+ ? upgraded.$schema_version : previousVersion;
144
+ validate('defaults', value);
145
+ if (!isDeepStrictEqual(value, defaults.value))
146
+ changes.push({ file: defaultsFile, kind: 'agent-only-model', before: defaults.text, after: jsonText(value) });
147
+ }
148
+ changes.push({ file: marker, kind: 'agent-only-model', before: null, after: jsonText({ schemaVersion: 1 }) });
149
+ const backup = options.apply ? applyMigration({ home, changes, summary: { filesChanged: changes.length } }, id) : null;
150
+ return { changedFiles: changes.length, backup };
151
+ }
152
+ finally {
153
+ release();
154
+ }
155
+ }
156
+ /** Capture legacy deployment intent before any writer stamps the new process schema. */
157
+ export function preserveBaseagentDeclarationsOnWrite(value) {
158
+ if (!isRecord(value))
159
+ return value;
160
+ const file = resolvePaths().daemonConfig;
161
+ if (!fs.existsSync(file))
162
+ return value;
163
+ const previous = readJson(file).value;
164
+ if (!isRecord(previous) || Number(previous.$schema_version ?? 0) >= 12)
165
+ return value;
166
+ const result = runBaseagentDeclarationMigration({ apply: true });
167
+ if (!result.changedFiles || (value.plugins !== undefined && !isRecord(value.plugins)))
168
+ return value;
169
+ const migrated = readJson(file).value;
170
+ return { ...value, plugins: { ...(isRecord(migrated) && isRecord(migrated.plugins) ? migrated.plugins : {}),
171
+ ...(isRecord(value.plugins) ? value.plugins : {}) } };
172
+ }
173
+ /** A caller may still hold the pre-migration Defaults object when saving it. */
174
+ export function migrateBaseagentDefaultsOnWrite(value) {
175
+ const result = runBaseagentDeclarationMigration({ apply: true });
176
+ if (!result.changedFiles || !isRecord(value) || !isRecord(value.baseagents))
177
+ return value;
178
+ const blocks = Object.fromEntries(Object.entries(value.baseagents).map(([name, raw]) => {
179
+ if (!isRecord(raw))
180
+ return [name, raw];
181
+ const { enabled: _enabled, ...settings } = raw;
182
+ return [name, settings];
183
+ }));
184
+ return { ...value, baseagents: blocks };
185
+ }
30
186
  const BASEAGENT_ALIASES = new Map([
31
187
  ['cc', 'claude'],
32
188
  ['claude-code', 'claude'],
@@ -98,7 +254,7 @@ function jsonText(value) {
98
254
  function canonicalBaseagent(value) {
99
255
  const key = String(value || '').trim().toLowerCase().replace(/_/g, '-');
100
256
  const canonical = BASEAGENT_ALIASES.get(key) || key;
101
- return SUPPORTED_BASEAGENTS.has(canonical) ? canonical : undefined;
257
+ return isSupportedBaseagent(canonical) ? canonical : undefined;
102
258
  }
103
259
  function validAid(name) {
104
260
  const labels = name.split('.');
@@ -510,6 +666,24 @@ function assertDaemonStopped(home) {
510
666
  function lockPath(home, id) {
511
667
  return path.join(home, 'data', `${id}-migration.lock`);
512
668
  }
669
+ const LOCK_OWNER_WAIT_MS = 1000;
670
+ const LOCK_OWNER_POLL_INTERVAL_MS = 10;
671
+ function readLockOwner(ownerFile, dir) {
672
+ const deadline = Date.now() + LOCK_OWNER_WAIT_MS;
673
+ const waitCell = new Int32Array(new SharedArrayBuffer(Int32Array.BYTES_PER_ELEMENT));
674
+ while (true) {
675
+ try {
676
+ return JSON.parse(fs.readFileSync(ownerFile, 'utf8'));
677
+ }
678
+ catch {
679
+ if (Date.now() >= deadline)
680
+ throw new Error(`Migration lock is unreadable: ${dir}`);
681
+ // mkdir is the atomic lock acquisition; the owner record is written immediately
682
+ // afterward. Give that initializer a bounded window to publish valid JSON.
683
+ Atomics.wait(waitCell, 0, 0, LOCK_OWNER_POLL_INTERVAL_MS);
684
+ }
685
+ }
686
+ }
513
687
  function acquireLock(home, id) {
514
688
  const dir = lockPath(home, id);
515
689
  const ownerFile = path.join(dir, 'owner.json');
@@ -520,13 +694,7 @@ function acquireLock(home, id) {
520
694
  catch (error) {
521
695
  if (!isRecord(error) || error.code !== 'EEXIST')
522
696
  throw error;
523
- let owner;
524
- try {
525
- owner = JSON.parse(fs.readFileSync(ownerFile, 'utf8'));
526
- }
527
- catch {
528
- throw new Error(`Migration lock is unreadable: ${dir}`);
529
- }
697
+ const owner = readLockOwner(ownerFile, dir);
530
698
  const pid = isRecord(owner) ? Number(owner.pid) : NaN;
531
699
  if (Number.isInteger(pid) && pid > 0 && processIsAlive(pid)) {
532
700
  throw new Error(`Another ${id} migration is already running (pid=${pid})`);
@@ -1108,7 +1276,6 @@ const AGENT_BASEAGENT_REMOVED_FIELDS = [
1108
1276
  const AGENT_TOP_REMOVED_FIELDS = ['model', 'models', 'decision_model', 'response_modes', 'dispatch'];
1109
1277
  /** 剥离后内容与新版本 schema 等价的直接前驱版本。 */
1110
1278
  const AGENT_CONFIG_RESTAMP = { from: 13, to: 16 };
1111
- const DEFAULTS_SCHEMA_TARGET = 5;
1112
1279
  /** 指认 provider 时各 baseagent 使用的服务类型。 */
1113
1280
  const BASEAGENT_SERVICE_TYPES = {
1114
1281
  claude: 'claude',
@@ -1131,8 +1298,9 @@ function findProviderForConnection(providers, connection) {
1131
1298
  catch {
1132
1299
  continue;
1133
1300
  }
1134
- const existingKey = typeof provider.common.apiKey === 'string' ? provider.common.apiKey.trim() : '';
1135
- if (connection.apiKey && existingKey !== connection.apiKey)
1301
+ const existingKeys = providerApiKeyEntries(provider.common.apiKey)
1302
+ .map(key => key.trim()).filter(Boolean);
1303
+ if (connection.apiKey && !existingKeys.includes(connection.apiKey))
1136
1304
  continue;
1137
1305
  if (connection.headers && !isDeepStrictEqual(provider.common.headers, connection.headers))
1138
1306
  continue;
@@ -1385,7 +1553,7 @@ function planAgentModelProviderMigration(home) {
1385
1553
  }
1386
1554
  }
1387
1555
  if (isDefaults) {
1388
- value.$schema_version = DEFAULTS_SCHEMA_TARGET;
1556
+ value.$schema_version = currentVersion('defaults');
1389
1557
  }
1390
1558
  else if (typeof value.$schema_version === 'number' && value.$schema_version < AGENT_CONFIG_RESTAMP.to) {
1391
1559
  // Model/provider migration preserves the v16 admission fields unchanged.
@@ -1723,6 +1891,53 @@ const PUBLISHED_SCHEMA_CONSOLIDATIONS = [
1723
1891
  { logicalName: 'agent-config', from: 20, to: 19 },
1724
1892
  { logicalName: 'relation-config', from: 13, to: 12 },
1725
1893
  ];
1894
+ /**
1895
+ * v22 → v23:Owner 只由 ownership 协议授予。
1896
+ *
1897
+ * 顶层的 `owner` / `owners` 曾经是 Owner 的兼容来源和自动绑定目标,现在两者
1898
+ * 都不存在了,字段只剩误导。清掉字段并重打版本号,让存量文件落进 v23 的
1899
+ * `additionalProperties: false`。
1900
+ */
1901
+ const AGENT_OWNER_FIELD_VERSION = { from: 22, to: 23 };
1902
+ const AGENT_OWNER_RETIRED_FIELDS = ['owner', 'owners'];
1903
+ function stripRetiredOwnerFields(value) {
1904
+ if (value.$schema_version !== AGENT_OWNER_FIELD_VERSION.from)
1905
+ return { value, removed: [] };
1906
+ const next = { ...value };
1907
+ const removed = stripOwnFields(next, AGENT_OWNER_RETIRED_FIELDS);
1908
+ next.$schema_version = AGENT_OWNER_FIELD_VERSION.to;
1909
+ const schema = loadSchema('agent-config', AGENT_OWNER_FIELD_VERSION.to);
1910
+ if (!schema.validate(next)) {
1911
+ const detail = (schema.validate.errors ?? [])
1912
+ .map(error => `${error.instancePath || '/'} ${error.message}`)
1913
+ .join('; ');
1914
+ throw new Error(`agent-config v${AGENT_OWNER_FIELD_VERSION.to} rejected the stripped config: ${detail}`);
1915
+ }
1916
+ return { value: next, removed };
1917
+ }
1918
+ /**
1919
+ * daemon.json v9 → v10:控制 Owner 同样只由 ownership 协议授予。
1920
+ *
1921
+ * 顶层 `owner` / `owners` 曾经决定控制 AID 的绑定邀约目标和名片归属,现在两条
1922
+ * 都改为显式发起绑定后从协议取。字段留在这里只会让人以为它还有授权作用。
1923
+ */
1924
+ const DAEMON_OWNER_FIELD_VERSION = { from: 9, to: 10 };
1925
+ const DAEMON_OWNER_RETIRED_FIELDS = ['owner', 'owners'];
1926
+ function stripRetiredDaemonOwnerFields(value) {
1927
+ if (value.$schema_version !== DAEMON_OWNER_FIELD_VERSION.from)
1928
+ return { value, removed: [] };
1929
+ const next = { ...value };
1930
+ const removed = stripOwnFields(next, DAEMON_OWNER_RETIRED_FIELDS);
1931
+ next.$schema_version = DAEMON_OWNER_FIELD_VERSION.to;
1932
+ const schema = loadSchema('daemon', DAEMON_OWNER_FIELD_VERSION.to);
1933
+ if (!schema.validate(next)) {
1934
+ const detail = (schema.validate.errors ?? [])
1935
+ .map(error => `${error.instancePath || '/'} ${error.message}`)
1936
+ .join('; ');
1937
+ throw new Error(`daemon v${DAEMON_OWNER_FIELD_VERSION.to} rejected the stripped config: ${detail}`);
1938
+ }
1939
+ return { value: next, removed };
1940
+ }
1726
1941
  function restampPublishedSchemaConsolidation(value, file, consolidation) {
1727
1942
  let next = value;
1728
1943
  let chatModeChanged = false;
@@ -1766,7 +1981,26 @@ function planStartupConfigCompatibilityMigration(home) {
1766
1981
  relationsScanned: 0,
1767
1982
  filesChanged: 0,
1768
1983
  filesWithChatModesNormalized: 0,
1984
+ ownerFieldsRemoved: 0,
1769
1985
  };
1986
+ // daemon.json moves to v10 independent of whether any Agent directory exists.
1987
+ const daemonFile = path.join(home, 'daemon.json');
1988
+ if (fs.existsSync(daemonFile)) {
1989
+ try {
1990
+ const parsed = readJson(daemonFile);
1991
+ if (isRecord(parsed.value)) {
1992
+ const stripped = stripRetiredDaemonOwnerFields(parsed.value);
1993
+ summary.ownerFieldsRemoved += stripped.removed.length;
1994
+ if (stripped.removed.length > 0) {
1995
+ changes.push({ file: daemonFile, kind: 'agent-only-model', before: parsed.text, after: jsonText(stripped.value) });
1996
+ summary.filesChanged += 1;
1997
+ }
1998
+ }
1999
+ }
2000
+ catch {
2001
+ // Malformed daemon.json is reported by the regular config loader.
2002
+ }
2003
+ }
1770
2004
  const agentsRoot = path.join(home, 'agents');
1771
2005
  if (!fs.existsSync(agentsRoot))
1772
2006
  return { home, changes, summary };
@@ -1787,7 +2021,12 @@ function planStartupConfigCompatibilityMigration(home) {
1787
2021
  continue;
1788
2022
  }
1789
2023
  if (isRecord(parsed.value)) {
1790
- const next = restampPublishedSchemaConsolidation(parsed.value, agentFile, agentConsolidation);
2024
+ const stripped = stripRetiredOwnerFields(parsed.value);
2025
+ summary.ownerFieldsRemoved += stripped.removed.length;
2026
+ // A stripped config still has to be written even when the consolidation
2027
+ // pass finds nothing to restamp; otherwise the removal is planned but lost.
2028
+ const consolidated = restampPublishedSchemaConsolidation(stripped.value, agentFile, agentConsolidation);
2029
+ const next = consolidated ?? (stripped.removed.length > 0 ? stripped.value : null);
1791
2030
  if (next) {
1792
2031
  changes.push({ file: agentFile, kind: 'agent-only-model', before: parsed.text, after: jsonText(next) });
1793
2032
  summary.filesChanged += 1;
@@ -14,7 +14,7 @@ import fs from 'fs';
14
14
  import path from 'path';
15
15
  import { createRequire } from 'node:module';
16
16
  import { kitsSchemasDir } from '../paths.js';
17
- import { createErrorCapturingReader, fileCache } from '../core/daemon-file-cache.js';
17
+ import { createErrorCapturingReader, fileCache } from '../core/daemon/daemon-file-cache.js';
18
18
  let _ajv = null;
19
19
  const requireSchemaDependency = createRequire(import.meta.url);
20
20
  function ajv() {
@@ -61,15 +61,60 @@ export function isSchemaName(name) {
61
61
  return Object.prototype.hasOwnProperty.call(loadMeta().schemas, name);
62
62
  }
63
63
  /**
64
- * 顶层字段的 schema 声明默认值(`default` 关键字),无则 undefined。
65
- * 仅覆盖顶层标量字段——嵌套路径的默认值不在此解析。
66
- * 用于 `ec config get` 在各存储层都无值时回落展示出厂默认。
64
+ * 字段的 schema 声明默认值(`default` 关键字),无则 undefined。
65
+ *
66
+ * 顶层与嵌套路径统一递归解析——不需要白名单:默认值只允许挂在这条覆盖链上
67
+ * **最低的、声明了该参数的层级**(见 docs/config/11-default-value-levels.md),
68
+ * 高层 schema 里不会出现 default,所以递归不会把"该显式配置"的字段读成一个
69
+ * 看似生效的值。返回 undefined 就是"没配也没默认值",即未配置。
67
70
  */
68
71
  export function fieldSchemaDefault(name, fieldPath) {
69
- if (fieldPath.includes('.'))
70
- return undefined;
71
- const spec = loadSchema(name).fields.get(fieldPath);
72
- return spec && 'default' in spec ? spec.default : undefined;
72
+ const parts = fieldPath.split('.');
73
+ let fields = loadSchema(name).fields;
74
+ let spec;
75
+ for (const part of parts) {
76
+ spec = fields?.get(part);
77
+ if (!spec)
78
+ return undefined;
79
+ fields = spec.children;
80
+ }
81
+ // FieldSpec.default 是无条件赋值的属性,判据必须是 `!== undefined`,不能用 `in`。
82
+ return spec ? spec.default : undefined;
83
+ }
84
+ /**
85
+ * 某层级 schema 的默认值层(按字段树递归展开成对象),供覆盖链合并使用。
86
+ *
87
+ * 语义:**这一层的配置文件里没写这个参数时,这一层仍然以 schema 的 default 参与覆盖。**
88
+ * 因此默认值只能挂在这条链上最低的、声明了该参数的层级;高层挂默认值会永久压掉低层
89
+ * 的用户配置(见 docs/config/11-default-value-levels.md)。
90
+ *
91
+ * 返回的对象是新构造的,调用方可以安全改写;无默认值的字段不出现在结果里。
92
+ */
93
+ export function schemaDefaultsLayer(name) {
94
+ const build = (fields) => {
95
+ const out = {};
96
+ for (const [key, spec] of fields) {
97
+ if (spec.default !== undefined) {
98
+ out[key] = cloneValue(spec.default);
99
+ continue;
100
+ }
101
+ if (spec.children && spec.children.size > 0) {
102
+ const nested = build(spec.children);
103
+ if (Object.keys(nested).length > 0)
104
+ out[key] = nested;
105
+ }
106
+ }
107
+ return out;
108
+ };
109
+ return build(loadSchema(name).fields);
110
+ }
111
+ function cloneValue(value) {
112
+ if (Array.isArray(value))
113
+ return value.map(cloneValue);
114
+ if (value && typeof value === 'object') {
115
+ return Object.fromEntries(Object.entries(value).map(([k, v]) => [k, cloneValue(v)]));
116
+ }
117
+ return value;
73
118
  }
74
119
  /** 某版本的 history 元信息(date/description),无则 undefined。 */
75
120
  export function schemaHistoryEntry(name, version) {