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,7 @@
1
1
  import fs from 'fs';
2
2
  import path from 'path';
3
3
  import { resolvePaths, resolveRoot } from '../paths.js';
4
- import { applyDataMigration, finalizeDataMigration, planDataMigration, readDataMigration, verifyDataMigration } from '../core/data-migration.js';
4
+ import { applyDataMigration, finalizeDataMigration, planDataMigration, readDataMigration, verifyDataMigration } from '../core/migration/data-migration.js';
5
5
  import { scanInstances } from '../utils/instance-registry.js';
6
6
  import { isProcessRunning, killProcess } from '../utils/cross-platform.js';
7
7
  import { ipcQuery } from '../ipc.js';
@@ -12,6 +12,12 @@ import { ipcQuery } from '../ipc.js';
12
12
  import { AGENT_DELEGATION_TOKEN_ENV } from '../core/auth/agent-delegation.js';
13
13
  import { buildTaskRuntimeEnv } from './task-context.js';
14
14
  const AS_SESSION_FLAG = '--as-session';
15
+ /**
16
+ * 由 `--as-session` 注入的身份标记。只有本文件会设置它:托管会话里的 agent
17
+ * 无法伪造(子进程环境由 daemon 构造,且 CLI 在托管会话中拒绝 `--as-session`)。
18
+ * 发送命令据此区分「调试身份」与「真实托管会话」。
19
+ */
20
+ export const DEBUG_SESSION_ENV = 'EVOLCORE_DEBUG_SESSION';
15
21
  function formatTimeAgo(ms) {
16
22
  const s = Math.floor(ms / 1000);
17
23
  if (s < 60)
@@ -134,6 +140,9 @@ export async function resolveDebugContext(args) {
134
140
  const ctxWithoutEpoch = { ...runtimeContext, daemonRuntimeEpoch: undefined };
135
141
  Object.assign(process.env, buildTaskRuntimeEnv(ctxWithoutEpoch));
136
142
  process.env[AGENT_DELEGATION_TOKEN_ENV] = token;
143
+ // 标记这是调试注入的身份:`ec msg send` / `ec group send` 在普通托管会话里被禁用,
144
+ // 只在这条调试路径上放行——宿主终端需要一条能代表任意 agent 发消息的通道。
145
+ process.env[DEBUG_SESSION_ENV] = '1';
137
146
  // peer / directory / fs 等命令只读 EVOLCORE_SELF_AID,不走 taskRuntimeContext,单独注入
138
147
  if (runtimeContext.selfAid)
139
148
  process.env.EVOLCORE_SELF_AID = runtimeContext.selfAid;
@@ -1,8 +1,7 @@
1
1
  import { resolvePaths } from '../paths.js';
2
2
  import { daemonUnavailableMessage, getArgValue, isHelpFlag, queryDaemon, wantsHelp } from './help.js';
3
3
  import { AGENT_DELEGATION_TOKEN_ENV, readDelegationCredential } from '../core/auth/agent-delegation.js';
4
- import { DirectoryQueryError, executeDirectoryQueryCommand, resolveDirectoryQueryCommand, } from '../directory/owner-directory-query-operation.js';
5
- import { executeDirectoryRequestCommand, resolveDirectoryRequestCommand, } from '../directory/owner-directory-request-operation.js';
4
+ import { DirectoryQueryError, executeDirectoryQueryCommand, resolveDirectoryQueryCommand, executeDirectoryRequestCommand, resolveDirectoryRequestCommand } from '../directory/query-operation.js';
6
5
  const QUERY_ACTIONS = new Set(['list', 'info', 'refresh', 'blocked', 'block', 'unblock']);
7
6
  /**
8
7
  * `ec directory ...`
@@ -9,18 +9,18 @@
9
9
  * 混在带 IO 的入口脚本里就无法回归验证。
10
10
  */
11
11
  import { isThreadTopicId, parseDurationToMs } from '../core/message/send-routing.js';
12
- import { GATEWAY_FLAG_ALIASES, GATEWAY_ROUTE_VALUE_FLAGS, MANAGED_SEND_BOOLEAN_FLAGS, MANAGED_SEND_VALUE_FLAGS, } from '../core/message/send-options.js';
12
+ import { GATEWAY_FLAG_ALIASES, GATEWAY_ROUTE_VALUE_FLAGS, isValidEncryptMode, MANAGED_SEND_BOOLEAN_FLAGS, MANAGED_SEND_VALUE_FLAGS, } from '../core/message/send-options.js';
13
13
  /**
14
14
  * 选项表来自 `send-options.ts`(唯一事实源),网关**不再维护第二份**。
15
15
  *
16
16
  * 网关消费的:路由选项 + 三态 `--encrypt`;其余一律原样透传给下游通道,
17
17
  * 因此 `--file` / `--link` / `--payload` / `--trigger-prompt` 等能力与
18
- * `ec msg send` 天然一致,不存在"两边各实现一套"的漂移。
18
+ * 下游发送解析(`resolveManagedSendArgv`)天然一致,不存在"两边各实现一套"的漂移。
19
19
  */
20
20
  const ROUTE_VALUE_FLAGS = new Set(GATEWAY_ROUTE_VALUE_FLAGS);
21
21
  /** 原样透传给底层发送通道的选项(取一个值)。 */
22
22
  const PASSTHROUGH_VALUE_FLAGS = new Set(MANAGED_SEND_VALUE_FLAGS.filter(flag => !ROUTE_VALUE_FLAGS.has(flag)));
23
- /** 原样透传的布尔选项(`--encrypt`/`--no-encrypt` 由网关单独处理)。 */
23
+ /** 原样透传的布尔选项(`--encrypt` 由网关按三态单独处理)。 */
24
24
  const PASSTHROUGH_BOOLEAN_FLAGS = new Set(MANAGED_SEND_BOOLEAN_FLAGS.filter(flag => flag === '--mention-all'));
25
25
  /** 正文来源类选项:出现即表示有正文,不再要求位置参数。 */
26
26
  export const BODY_FLAGS = new Set([
@@ -30,7 +30,7 @@ export const BODY_FLAGS = new Set([
30
30
  * 把 argv 切成「路由选项」「正文」「透传选项」三部分。
31
31
  *
32
32
  * 正文与透传选项原样交给底层通道,保证 `--file` / `--link` / `--payload` 等
33
- * 能力与 `ec msg send` 完全一致——网关不重新实现任何正文形态。
33
+ * 能力与下游发送解析完全一致——网关不重新实现任何正文形态。
34
34
  */
35
35
  export function parseGatewayArgs(args) {
36
36
  const route = {};
@@ -51,14 +51,29 @@ export function parseGatewayArgs(args) {
51
51
  route.help = true;
52
52
  continue;
53
53
  }
54
- if (token === '--no-encrypt') {
55
- route.noEncrypt = true;
54
+ if (token === '--selfmode') {
55
+ route.selfMode = true;
56
56
  continue;
57
57
  }
58
58
  if (PASSTHROUGH_BOOLEAN_FLAGS.has(token)) {
59
59
  passthrough.push(token);
60
60
  continue;
61
61
  }
62
+ // `--to` 已废弃:接收方由「话题 + 模式」推出。静默改写会让回执与实际
63
+ // 目标不一致,因此出现即报错,并给出按目标类型的替代写法。
64
+ if (token === '--to' || token.startsWith('--to=')) {
65
+ return {
66
+ ok: false,
67
+ code: 'TO_REMOVED',
68
+ error: '--to 已废弃:接收方由话题和模式推出。'
69
+ + '当前话题直接省略;联系别的对端用 --thread main:<本端AID>:<对方AID>;'
70
+ + '群消息用 --thread main:<本端AID>:<群AID>;跨话题自派用 --thread <话题id> --selfmode',
71
+ };
72
+ }
73
+ // `--selfmode` 无取值:写成 `--selfmode=true` 是参数错误,避免被当成正文。
74
+ if (token.startsWith('--selfmode=')) {
75
+ return { ok: false, error: '--selfmode 不接受取值,只写 --selfmode' };
76
+ }
62
77
  // `--self` 是 `--from` 的别名:托管发送里本端恒为会话本端,两者同义。
63
78
  const flag = GATEWAY_FLAG_ALIASES[token] ?? token;
64
79
  if (ROUTE_VALUE_FLAGS.has(flag)) {
@@ -72,14 +87,16 @@ export function parseGatewayArgs(args) {
72
87
  }
73
88
  else if (flag === '--thread')
74
89
  route.thread = value;
75
- else if (flag === '--to')
76
- route.to = value;
77
90
  else if (flag === '--from')
78
91
  route.from = value;
79
92
  else if (flag === '--check-every')
80
93
  route.checkEvery = value;
81
- else if (flag === '--encrypt')
94
+ else if (flag === '--encrypt') {
95
+ if (!isValidEncryptMode(value)) {
96
+ return { ok: false, error: `--encrypt 只接受 yes|no|auto,收到 ${value}` };
97
+ }
82
98
  route.encrypt = value;
99
+ }
83
100
  continue;
84
101
  }
85
102
  if (PASSTHROUGH_VALUE_FLAGS.has(flag)) {
@@ -99,6 +116,18 @@ export function parseGatewayArgs(args) {
99
116
  }
100
117
  text.push(token);
101
118
  }
119
+ // 位置参数形态已废弃:`ecmsg send <from> <to> '<正文>'` 是照搬旧 CLI 位置参数的写法,
120
+ // 但网关不认位置 from/to,两个 AID 会被静默并入正文,消息实际发到当前会话对端,
121
+ // 回执却仍报 ok。这种「发错地方还报成功」的失败方式必须显式拒绝。
122
+ // 只拦「头部连续两个 AID」这一无歧义形态;正文本身确实以两个 AID 开头时用 `--` 分隔。
123
+ if (!endOfOptions && text.length >= 2 && looksLikeAid(text[0]) && looksLikeAid(text[1])) {
124
+ return {
125
+ ok: false,
126
+ error: 'ecmsg 不接受位置参数形式的发送方/收件人。本端恒为当前会话本端,'
127
+ + '跨话题用 --thread <话题id>(默认委托,加 --selfmode 为自派);'
128
+ + '若正文本身以两个 AID 开头,用 `--` 分隔后再写正文',
129
+ };
130
+ }
102
131
  return { ok: true, route, passthrough, text };
103
132
  }
104
133
  /** 毫秒 → `20m` / `90s` / `2h` / `1d`,供下游 `--check-every` 使用。 */
@@ -122,7 +151,7 @@ export function formatDuration(ms) {
122
151
  * "跨话题参数必须成对"的校验。
123
152
  * - **跨话题必须成对注入**。`--check-every` 由网关按判定结果给出(缺省 20m),
124
153
  * 不依赖调用方是否传了它。
125
- * - **加密显式下发二态**,不依赖 daemon 默认值:`--encrypt` 或 `--no-encrypt`。
154
+ * - **加密显式下发二态**,不依赖 daemon 默认值:`--encrypt yes` 或 `--encrypt no`。
126
155
  */
127
156
  /**
128
157
  * 目标 ID 是否是 AID 形态。
@@ -137,28 +166,37 @@ function looksLikeAid(value) {
137
166
  && labels.every(label => /^[a-zA-Z0-9]([a-zA-Z0-9-]*[a-zA-Z0-9])?$/.test(label));
138
167
  }
139
168
  export function buildDownstreamArgv(route, text, passthrough) {
140
- const scope = route.peer.peerKind === 'group' ? 'group' : 'msg';
141
- // 收件人:私聊跨话题自派时是本端,否则是话题对端。用 route.peer.id 会把跨话题自派消息
142
- // 实际投给话题对端(下游按位置参数认目标,--thread 只决定落点会话)。
143
- // 群发送恒以群 AID 为目标,跨话题自派不适用于群。
144
- const targetId = scope === 'group' ? route.peer.id : route.recipientId;
169
+ // 自派一律走 msg:线上消息发给本端自己,落点由 --thread 决定。
170
+ // 委托的 scope 由话题对端类型决定(群话题 → group)。
171
+ const scope = route.recipient === 'self'
172
+ ? 'msg'
173
+ : (route.peer.peerKind === 'group' ? 'group' : 'msg');
174
+ // 收件人:自派时是本端,否则是话题对端。下游按位置参数认目标,
175
+ // `--thread` 只决定落点会话。
176
+ const targetId = route.recipientId;
145
177
  // 目标为原生 ID 时必须靠 --thread 推导,写成位置参数会变成正文的一部分。
146
178
  const targetAsPositional = looksLikeAid(targetId)
147
179
  || (route.peer.peerKind === 'group' && !route.crossTopic);
148
180
  const argv = targetAsPositional
149
181
  ? [scope, 'send', route.self, targetId, ...passthrough]
150
182
  : [scope, 'send', route.self, ...passthrough];
151
- // 首次联系:主话题还没被创建,带上 --thread 反而会被下游判成"话题不存在",
152
- // 所以按普通私聊发出,会话随这条消息建立,也就不建复查。
183
+ // 首次联系:主话题的会话还没建立,带上 --thread 反而会被下游判成"话题不存在",
184
+ // 所以按普通私聊发出,会话随这条消息建立,也就没有复查可挂。
153
185
  if (route.crossTopic && route.threadId && !route.firstContact) {
154
186
  argv.push('--thread', route.threadId);
155
- // 进入本分支后 `checkEveryMs === undefined` 只可能是显式 `--check-every none`:
156
- // 未指定时 resolveSendRoute 已补默认周期,firstContact 又进不了本分支。
157
- // 必须把 `none` 透传下去——漏传会让下游 `resolveManagedSendArgv` 看到
158
- // 「有 --thread 没 --check-every」,直接报 Cross-thread sends require …。
159
- argv.push('--check-every', route.checkEveryMs ? formatDuration(route.checkEveryMs) : 'none');
187
+ if (route.recipient === 'self') {
188
+ // 自派不建复查:显式标记,下游据此跳过「跨话题必须带 --check-every」的旧校验。
189
+ argv.push('--selfmode');
190
+ }
191
+ else {
192
+ // 委托:`checkEveryMs === undefined` 只可能是显式 `--check-every none`。
193
+ // 漏传会让下游看到「有 --thread 没 --check-every」而报错。
194
+ argv.push('--check-every', route.checkEveryMs ? formatDuration(route.checkEveryMs) : 'none');
195
+ }
160
196
  }
161
- argv.push(route.encryptResolved ? '--encrypt' : '--no-encrypt');
197
+ // 三态原样下发:`auto` 不能在这里塌成二态——它要求下游按「本轮是否被对端
198
+ // 消息触发」决定,网关替它拍板会把会话首条消息锁成明文/密文之一。
199
+ argv.push('--encrypt', route.encrypt);
162
200
  // 保留网关正文的字面量语义,包括经 `--` 传入的 --encrypt 等文本。
163
201
  if (text.length > 0)
164
202
  argv.push('--', ...text);
@@ -167,11 +205,11 @@ export function buildDownstreamArgv(route, text, passthrough) {
167
205
  /**
168
206
  * 群 AID 的 base 简写展开(`g-18127` → `g-18127.agentid.cn`)。
169
207
  *
170
- * 网关必须在构造路由**之前**完成这一步:`--to g-18127` 若不展开,既判不出它是群
171
- * (类型解析拿不到证据),也拼不出主话题 id,会直接 `TOPIC_REQUIRED`。
208
+ * v2 起 `--to` 已废弃,群目标由 `--thread main:<self>:<群AID>` 表达(要求完整 AID);
209
+ * 本函数保留给历史调用方与单测,网关主流程不再使用。
172
210
  *
173
211
  * 只处理裸 base:已含 issuer 的值原样返回,私聊 AID 不受影响。
174
- * issuer 取本端 AID 的域,与 `ec group send` / 托管 group 操作的调用口径一致。
212
+ * issuer 取本端 AID 的域,与托管 group 操作的调用口径一致。
175
213
  * 展开失败(非群 AID 形态)时同样原样返回,交给后续判定按私聊处理。
176
214
  */
177
215
  export function expandGroupBase(selfAid, value, normalizeGroupAid) {
@@ -3,6 +3,7 @@ import path from 'path';
3
3
  import { TextDecoder } from 'util';
4
4
  import { getArgValue, isHelpFlag, wantsHelp } from './help.js';
5
5
  import { agentmdGet, getAidStore, isValidAid, loadClient, SLOT } from '../aun/aid/index.js';
6
+ import { executeStorageAcl, parseStorageAcl } from '../aun/storage/index.js';
6
7
  import { daemonUnavailableMessage, queryDaemon } from './help.js';
7
8
  import { resolvePaths } from '../paths.js';
8
9
  import { AGENT_DELEGATION_TOKEN_ENV, readDelegationCredential } from '../core/auth/agent-delegation.js';
@@ -34,7 +35,7 @@ Commands:
34
35
  mkdir [-p] <AID>:<path> 创建目录
35
36
  ln -s <target> <AID>:<path> 创建软链(personal storage)
36
37
  chmod [mode] <AID>:<path> 切换公开/私有(personal storage)
37
- setfacl <AID>:<path> -m|-x ... 设置/移除 ACL(群路径使用 role:member|role:admin)
38
+ setfacl <AID>:<path> -m|-x ... 设置/移除 ACL(个人空间支持通用 ACL JSON)
38
39
  getfacl <AID>:<path> 查看 ACL
39
40
  token issue|revoke|ls <path> 管理访问 token(personal storage)
40
41
  find <AID>:<path> [filters] 查找节点
@@ -61,11 +62,13 @@ Options:
61
62
  如 --allow-roles 'owner,admin'
62
63
  -m aid:<aid>:<perms> setfacl 新增/更新 ACL
63
64
  -x aid:<aid> setfacl 移除 ACL
65
+ -m '<ACL JSON>' 设置 ACL:subject/grantee_aid/grantee_aids 三选一,另传 perms
66
+ -x '<selector JSON>' 移除相同主体的 ACL;群路径仍使用 role:member|role:admin
64
67
  --source <AID>:<path> mount 虚拟卷来源
65
68
  --volume <id> mount 实体卷 ID
66
69
  --require-approval mount 需要来源 owner 审批
67
70
  --expires <time> mount/token/ACL 过期时间,Unix 秒或 ISO 日期
68
- --max-uses <n> ACL 最大使用次数
71
+ --max-uses <n> ACL 最大使用次数,0 不限;--expires 0 不过期
69
72
  --max-reads <n> token 最大读取次数
70
73
  --readonly, --readwrite mount 只读/读写
71
74
  --name <glob> find 名称过滤
@@ -87,6 +90,7 @@ Options:
87
90
  ec fs ln -s alice.agentid.pub:/private/report.md alice.agentid.pub:/public/report.md --as alice.agentid.pub
88
91
  ec fs chmod +r alice.agentid.pub:/public/report.md --as alice.agentid.pub
89
92
  ec fs setfacl alice.agentid.pub:/private/report.md -m aid:bob.agentid.pub:r --as alice.agentid.pub
93
+ ec fs setfacl alice.agentid.pub:/private/report.md -m '{"subject":{"ownership":{"owner_aid":"bob.agentid.pub"},"card":{"type":["host"]}},"perms":"r","expires_at":0,"max_uses":0}'
90
94
  ec fs token issue alice.agentid.pub:/public/report.md --expires 2026-12-31 --as alice.agentid.pub
91
95
  ec fs find alice.agentid.pub:/private/ --name "*.md" --as alice.agentid.pub
92
96
  ec fs df alice.agentid.pub: --as alice.agentid.pub`;
@@ -273,6 +277,9 @@ async function runManagedFs(args, formatJson) {
273
277
  case 'upload':
274
278
  console.log(`✓ 已上传: ${result.localPath} -> ${result.path}`);
275
279
  return;
280
+ case 'download':
281
+ console.log(`✓ 已下载: ${result.path} -> ${result.localPath}`);
282
+ return;
276
283
  case 'copy':
277
284
  console.log(`✓ 已复制: ${result.src} -> ${result.path}`);
278
285
  return;
@@ -282,16 +289,19 @@ async function runManagedFs(args, formatJson) {
282
289
  case 'remove':
283
290
  console.log(`✓ 已删除: ${result.path}`);
284
291
  return;
285
- case 'link':
292
+ case 'link': {
286
293
  console.log(`🔗 ${String(result.url ?? '')}`);
287
- if (result.expireAt)
288
- console.log(`有效期至: ${new Date(Number(result.expireAt)).toISOString()}`);
294
+ // storage 返回的 expire_at 是 Unix 秒;按毫秒解析会显示成 1970 年。
295
+ const expiry = formatLinkExpiry(result.expireAt);
296
+ if (expiry)
297
+ console.log(expiry);
289
298
  return;
299
+ }
290
300
  case 'getfacl':
291
301
  console.log(JSON.stringify(result.result ?? {}, null, 2));
292
302
  return;
293
303
  case 'setfacl':
294
- console.log(`✓ 已${result.removed ? '移除' : '设置'}群 ACL: ${result.path}`);
304
+ console.log(`✓ 已${result.removed ? '移除' : '设置'} ACL: ${result.path}`);
295
305
  return;
296
306
  }
297
307
  }
@@ -856,8 +866,8 @@ async function fsSetfacl(args, opts) {
856
866
  const target = parseRemoteRequired(positional[0], { command: 'setfacl' });
857
867
  const modify = getArgValue(args, '-m');
858
868
  const remove = getArgValue(args, '-x');
859
- const expiresAt = parseOptionalTimestamp(getArgValue(args, '--expires'), '--expires');
860
- const maxUses = parseOptionalPositiveInt(getArgValue(args, '--max-uses'), '--max-uses');
869
+ const expires = getArgValue(args, '--expires');
870
+ const maxUses = getArgValue(args, '--max-uses');
861
871
  if (!!modify === !!remove) {
862
872
  throw new FsCliError('INVALID_ARGUMENT', 'setfacl 必须且只能指定 -m 或 -x', '用法: ec fs setfacl <AID>:<path> -m aid:bob.aid.pub:r');
863
873
  }
@@ -866,35 +876,41 @@ async function fsSetfacl(args, opts) {
866
876
  if (modify) {
867
877
  if (route.backend === 'group') {
868
878
  const [role, rolePerms] = parseGroupAclSpec(modify, true);
869
- if (expiresAt !== undefined || maxUses !== undefined) {
879
+ if (expires !== undefined || maxUses !== undefined) {
870
880
  throw new FsCliError('INVALID_ARGUMENT', '群空间 ACL 不支持 --expires 或 --max-uses');
871
881
  }
872
882
  const result = await client.group.fs.setAcl(remoteRef(target), { granteeAid: role, perms: rolePerms });
873
883
  outputSuccess(opts, { command: 'setfacl', backend: route.backend, route, path: remoteRef(target), result }, () => console.log(`✓ 已设置群 ACL: ${remoteRef(target)}`));
874
884
  return;
875
885
  }
876
- const [grantee, perms] = parseAclSpec(modify, true);
877
- const result = await client.storage.setAcl(target.path, {
878
- owner: target.aid,
879
- granteeAid: grantee,
880
- perms,
881
- expiresAt,
882
- maxUses,
883
- });
886
+ let acl;
887
+ try {
888
+ acl = parseStorageAcl(modify, false, { expires, maxUses });
889
+ }
890
+ catch (error) {
891
+ throw new FsCliError('INVALID_ARGUMENT', error.message);
892
+ }
893
+ const result = await executeStorageAcl(client, target.aid, target.path, acl, false);
884
894
  outputSuccess(opts, { command: 'setfacl', backend: route.backend, route, path: remoteRef(target), result }, () => console.log(`✓ 已设置 ACL: ${remoteRef(target)}`));
885
895
  return;
886
896
  }
887
897
  if (route.backend === 'group') {
898
+ if (expires !== undefined || maxUses !== undefined) {
899
+ throw new FsCliError('INVALID_ARGUMENT', '群空间 ACL 不支持 --expires 或 --max-uses');
900
+ }
888
901
  const [role] = parseGroupAclSpec(remove || '', false);
889
902
  const result = await client.group.fs.removeAcl(remoteRef(target), { granteeAid: role });
890
903
  outputSuccess(opts, { command: 'setfacl', backend: route.backend, route, path: remoteRef(target), result }, () => console.log(`✓ 已移除群 ACL: ${remoteRef(target)}`));
891
904
  return;
892
905
  }
893
- const [grantee] = parseAclSpec(remove || '', false);
894
- const result = await client.storage.removeAcl(target.path, {
895
- owner: target.aid,
896
- granteeAid: grantee,
897
- });
906
+ let acl;
907
+ try {
908
+ acl = parseStorageAcl(remove || '', true, { expires, maxUses });
909
+ }
910
+ catch (error) {
911
+ throw new FsCliError('INVALID_ARGUMENT', error.message);
912
+ }
913
+ const result = await executeStorageAcl(client, target.aid, target.path, acl, true);
898
914
  outputSuccess(opts, { command: 'setfacl', backend: route.backend, route, path: remoteRef(target), result }, () => console.log(`✓ 已移除 ACL: ${remoteRef(target)}`));
899
915
  });
900
916
  }
@@ -1053,7 +1069,11 @@ async function fsLink(args, opts) {
1053
1069
  url, expireAt: ticket.expire_at ?? null,
1054
1070
  }, () => {
1055
1071
  console.log(`🔗 ${url}`);
1056
- if (expiresSeconds !== undefined) {
1072
+ // 优先用服务端回的绝对过期时间;缺失时才回落请求的时长。
1073
+ const expiry = formatLinkExpiry(ticket.expire_at);
1074
+ if (expiry)
1075
+ console.log(expiry);
1076
+ else if (expiresSeconds !== undefined) {
1057
1077
  console.log(expiresSeconds === 0 ? '有效期: 不过期' : `有效期: ${expiresSeconds} 秒`);
1058
1078
  }
1059
1079
  });
@@ -1366,22 +1386,6 @@ function parseVisibility(value) {
1366
1386
  return 'private';
1367
1387
  throw new FsCliError('INVALID_ARGUMENT', `不支持的 chmod 模式: ${value}`, '当前 ec fs chmod 只支持 +r/o-r,或 --visibility public|private。');
1368
1388
  }
1369
- function parseAclSpec(value, requirePerms) {
1370
- const parts = value.split(':');
1371
- if (parts.length < 2 || parts[0] !== 'aid' || !parts[1]) {
1372
- throw new FsCliError('INVALID_ARGUMENT', 'ACL 条目格式应为 aid:<AID>:<perms> 或 aid:<AID>');
1373
- }
1374
- if (requirePerms) {
1375
- if (parts.length !== 3 || !parts[2]) {
1376
- throw new FsCliError('INVALID_ARGUMENT', 'setfacl -m 格式应为 aid:<AID>:<perms>');
1377
- }
1378
- return [parts[1], parts[2]];
1379
- }
1380
- if (parts.length !== 2) {
1381
- throw new FsCliError('INVALID_ARGUMENT', 'setfacl -x 格式应为 aid:<AID>');
1382
- }
1383
- return [parts[1]];
1384
- }
1385
1389
  function parseGroupAclSpec(value, requirePerms) {
1386
1390
  const parts = value.split(':');
1387
1391
  if (parts[0] !== 'role' || !parts[1] || (parts.length !== (requirePerms ? 3 : 2))) {
@@ -1512,6 +1516,30 @@ function formatBytes(n) {
1512
1516
  return `${(n / 1024).toFixed(1)}KB`;
1513
1517
  return `${n}B`;
1514
1518
  }
1519
+ /** Download expiry accepts Unix seconds, milliseconds, or an ISO date; zero never expires. */
1520
+ function formatLinkExpiry(value) {
1521
+ if (value === undefined || value === null || value === '')
1522
+ return undefined;
1523
+ if (typeof value === 'string') {
1524
+ const text = value.trim();
1525
+ if (!text)
1526
+ return undefined;
1527
+ if (!/^-?\d+$/.test(text)) {
1528
+ const parsed = Date.parse(text);
1529
+ return Number.isFinite(parsed) ? `有效期至: ${new Date(parsed).toISOString()}` : undefined;
1530
+ }
1531
+ }
1532
+ const numeric = Number(value);
1533
+ if (!Number.isFinite(numeric))
1534
+ return undefined;
1535
+ if (numeric === 0)
1536
+ return '有效期: 不过期';
1537
+ if (numeric < 0)
1538
+ return undefined;
1539
+ const millis = numeric > 1e12 ? numeric : numeric * 1000;
1540
+ const date = new Date(millis);
1541
+ return Number.isNaN(date.getTime()) ? undefined : `有效期至: ${date.toISOString()}`;
1542
+ }
1515
1543
  function formatTimestamp(value) {
1516
1544
  const ms = value > 10_000_000_000 ? value : value * 1000;
1517
1545
  const d = new Date(ms);
package/dist/cli/index.js CHANGED
@@ -27,6 +27,7 @@ const MAIN_HELP = `用法: ec <command> [选项]
27
27
  upgrade 检查 EvolCore、EC Web 和 FASTAUN 是否有更新(只查询,不安装)
28
28
  update 受理或复用唯一更新任务并异步执行(update status 查询进度)
29
29
  status 查看运行状态(含 --format json 结构化快照)
30
+ plugin 查询、诊断及启停随包渠道和基座插件(部署变更需宿主重启)
30
31
  logs 持续查看 daemon 日志
31
32
  watch 打开日志、AID、消息或 EC Web 监控
32
33
 
@@ -41,6 +42,7 @@ Agent 与会话:
41
42
  services 服务路由:服务包状态、台账、诊断与对端调用
42
43
  memory 记忆:写 note、整理正式记忆、触发整理会话
43
44
  task 恢复暂停或异常中断的会话任务
45
+ pay 网站付款卡片、二维码、订单核验与状态
44
46
  trigger 管理定时与事件触发器
45
47
  proxy 查询和管理 daemon 服务代理
46
48
  team 管理 Team Workspace、导航和成员
@@ -49,13 +51,13 @@ Agent 与会话:
49
51
 
50
52
  AUN:
51
53
  aid 管理 AID 身份与 agent.md
52
- msg 私聊消息收发、撤回、在线状态与历史
53
- group 群消息与群管理
54
+ msg 私聊消息查询、撤回、在线状态与历史
55
+ group 群管理与本地群历史
54
56
 
55
57
  发送消息请用独立入口 ecmsg(统一入口):
56
- ecmsg send '<正文>' 回复当前会话
57
- ecmsg send '<正文>' --thread <话题id> 指定话题(跨话题)
58
- ecmsg send '<正文>' --to <对端AID> 指定对端
58
+ ecmsg send '<正文>' 回复当前会话
59
+ ecmsg send '<正文>' --thread <话题id> 跨话题委托(发给该话题对端)
60
+ ecmsg send '<正文>' --thread <话题id> --selfmode 跨话题自派(发给自己)
59
61
  详见 ecmsg --help。
60
62
  fs AUN 文件系统
61
63
  storage 底层对象存储命令
@@ -110,7 +112,7 @@ export const KNOWN_TOP_LEVEL_COMMANDS = new Set([
110
112
  'storage', 'fs', 'msg', 'thread', 'events', 'services',
111
113
  'session', 'getmeta', 'group', 'model', 'skill', 'response',
112
114
  'config', 'peer', 'directory', 'role', 'stats', 'quota',
113
- 'provider', 'invoke', 'ability',
115
+ 'provider', 'invoke', 'ability', 'pay', 'plugin',
114
116
  // 版本三个别名在 switch 之前统一处理(含只在早期分支出现的 -V)。
115
117
  'version', '-v', '-V', '--version',
116
118
  'bench', 'link-rules',
@@ -119,7 +121,7 @@ function printLifecycleHelp(command) {
119
121
  const help = {
120
122
  start: `用法: ec start [--foreground] [--diagnose|-d] [--debug] [--as-mode dev|install]\n\n --foreground 前台运行,适合 systemd 或容器直接管理\n --diagnose, -d 以诊断模式启动 daemon\n --debug 调试模式:注册调试 IPC,可在宿主终端以任意 session 身份发命令\n --as-mode 覆盖运行模式判定(仅本次启动生效,不写配置):\n install = 按安装模式(校验随包文件完整性,篡改自动恢复)\n dev = 按开发模式(不校验随包文件)`,
121
123
  stop: '用法: ec stop\n\n停止当前 EVOLCORE_HOME 下运行的 EvolCore 服务。',
122
- restart: `用法: ec restart [--clear] [--diagnose|-d]\n\n --clear 同时清理跨 HOME 残留的 EvolCore 主进程\n --diagnose, -d 以诊断模式启动新 daemon`,
124
+ restart: `用法: ec restart [--clear] [--diagnose|-d] [--skip-package-upgrades|--apply-package-upgrades]\n\n --clear 同时清理跨 HOME 残留的 EvolCore 主进程\n --diagnose, -d 以诊断模式启动新 daemon\n --skip-package-upgrades 仅重启,不应用缓存升级(systemd 首批仅支持纯重启)\n --apply-package-upgrades 应用缓存升级(systemd 暂不支持)`,
123
125
  status: '用法: ec status [--format json]\n\n查看 daemon、Agent、渠道与队列运行状态。JSON 模式输出结构化状态快照。',
124
126
  logs: `用法: ec logs [选项]\n\n --level <trace|debug|info|warn|error|fatal> 最低日志级别\n --module <name> 只显示指定模块\n --raw 原始输出\n --no-color 禁用颜色`,
125
127
  watch: `用法: ec watch [logs|log|aid|msg|diag|web|session]\n\n ec watch 打开监控选择菜单\n ec watch logs 选择日志类型后监控\n ec watch log <类型...> 直接监控指定日志类型\n ec watch aid 监控 AID 连接\n ec watch msg 打开消息 TUI\n ec watch diag 实时诊断消息生命周期(AUN→daemon→任务)\n ec watch web 安装/升级并启动 EC Web\n ec watch session ec watch web 的兼容别名`,
@@ -219,6 +221,18 @@ export async function main(args) {
219
221
  console.log(MAIN_HELP);
220
222
  return;
221
223
  }
224
+ // Managed template operations are delegated to the running daemon, which
225
+ // completed startup migration and plugin discovery before accepting sessions.
226
+ // The sandboxed CLI cannot inspect the protected marker or acquire its lock.
227
+ const delegatedTemplate = !!process.env.EVOLCORE_SESSION_ID && cmd === 'agent' && strippedArgs[1] === 'template';
228
+ if (['agent', 'config', 'model', 'provider', 'role', 'status', 'diagnose', 'plugin'].includes(cmd)
229
+ && !wantsHelp(strippedArgs.slice(1)) && !delegatedTemplate) {
230
+ const { runBaseagentDeclarationMigration } = await import('../config/schema-migration.js');
231
+ runBaseagentDeclarationMigration({ apply: true });
232
+ const { discoverBaseagentPlugins } = await import('../core/baseagent/baseagent-plugin-loader.js');
233
+ await discoverBaseagentPlugins({ quiet: true });
234
+ await (await import('../core/channel/channel-loader.js')).discoverChannelPlugins();
235
+ }
222
236
  switch (cmd) {
223
237
  case 'init': {
224
238
  try {
@@ -229,7 +243,7 @@ export async function main(args) {
229
243
  ec init 交互式(写完 defaults.json 后嵌套 agent new)
230
244
  选择 ecagent 时会继续询问 API Key 和 Base URL
231
245
  ec init --non-interactive [选项]
232
- --baseagent <claude|codex|gemini|ecagent> 默认: PATH 中第一个可用项;ecagent 需显式选择
246
+ --baseagent <name> 默认: PATH 中第一个可用项;ecagent 需显式选择
233
247
  --force 已存在 defaults.json 时覆盖
234
248
 
235
249
  通过 EC Web 完成首次初始化:
@@ -239,7 +253,7 @@ export async function main(args) {
239
253
  云部署非交互式初始化(结构化 JSON 输出):
240
254
  ec init --non-interactive --owner <aid> [--format json] [选项]
241
255
  --owner <aid> 必填。控制 AID 创建后的 Owner 邀约目标,不等待审批
242
- --baseagent <claude|codex|gemini|ecagent> 可选。默认从 PATH 检测,ecagent 需显式选择
256
+ --baseagent <name> 可选。默认从 PATH 检测,ecagent 需显式选择
243
257
  --projectpath <abs-path> 可选。默认项目目录(必须绝对路径,自动创建)
244
258
  --ecweb 兼容选项。检查 EC Web 安装;默认随 ec start 启动
245
259
  --auto-start Windows/macOS 上启用 EvolCore 登录自启动
@@ -282,7 +296,8 @@ export async function main(args) {
282
296
  await (await import('./init-channel.js')).cmdInitWecom();
283
297
  }
284
298
  else if (strippedArgs[1] && !strippedArgs[1].startsWith('-')) {
285
- const supported = ['feishu', 'wechat', 'dingtalk', 'qqbot', 'wecom'];
299
+ const { listChannelPluginDescriptors } = await import('../core/channel/channel-loader.js');
300
+ const supported = listChannelPluginDescriptors().map(item => item.name);
286
301
  console.error(`❌ 不支持的渠道: ${strippedArgs[1]}`);
287
302
  console.error(` 支持的渠道: ${supported.join(', ')}`);
288
303
  process.exit(1);
@@ -376,11 +391,20 @@ export async function main(args) {
376
391
  printLifecycleHelp('restart');
377
392
  break;
378
393
  }
379
- if (!rejectUnknownFlags('restart', strippedArgs.slice(1), ['--clear', '--diagnose', '-d'])) {
394
+ if (!rejectUnknownFlags('restart', strippedArgs.slice(1), ['--clear', '--diagnose', '-d', '--skip-package-upgrades', '--apply-package-upgrades'])) {
395
+ process.exitCode = 1;
396
+ break;
397
+ }
398
+ if (strippedArgs.includes('--skip-package-upgrades') && strippedArgs.includes('--apply-package-upgrades')) {
399
+ console.error('Choose only one package upgrade option');
380
400
  process.exitCode = 1;
381
401
  break;
382
402
  }
383
- await (await import('./daemon-commands.js')).cmdRestart({ clear: strippedArgs.includes('--clear'), diagnose: strippedArgs.includes('--diagnose') || strippedArgs.includes('-d') });
403
+ await (await import('./daemon-commands.js')).cmdRestart({
404
+ clear: strippedArgs.includes('--clear'), diagnose: strippedArgs.includes('--diagnose') || strippedArgs.includes('-d'),
405
+ ...(strippedArgs.includes('--skip-package-upgrades') ? { applyPackageUpgrades: false }
406
+ : strippedArgs.includes('--apply-package-upgrades') ? { applyPackageUpgrades: true } : {}),
407
+ });
384
408
  break;
385
409
  case 'upgrade':
386
410
  case 'update': {
@@ -652,11 +676,20 @@ export async function main(args) {
652
676
  await cmdTeamWorkspace(strippedArgs.slice(1));
653
677
  break;
654
678
  }
679
+ case 'pay': {
680
+ const { cmdPay } = await import('./pay-command.js');
681
+ await cmdPay(strippedArgs.slice(1));
682
+ break;
683
+ }
655
684
  case 'response': {
656
685
  const { cmdResponse } = await import('./response.js');
657
686
  await cmdResponse(strippedArgs.slice(1));
658
687
  break;
659
688
  }
689
+ case 'plugin': {
690
+ await (await import('./daemon-commands.js')).cmdPlugins(strippedArgs.slice(1));
691
+ break;
692
+ }
660
693
  case 'provider': {
661
694
  const { cmdProvider } = await import('./provider-command.js');
662
695
  await cmdProvider(strippedArgs.slice(1));