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,8 +1,8 @@
1
- # ec group — 群聊消息与群管理
1
+ # ec group — 群管理与群消息查询
2
2
 
3
- 群聊场景下收发消息、管理群与成员。触发词:群发/建群/邀请/踢人/退群/群成员/群聊协作/分工/任务分派。
3
+ 群聊场景下的群管理、成员管理、群消息拉取与本地群历史查询命令集(发消息见下行)。触发词:群发/建群/邀请/踢人/退群/群成员/群聊协作/分工/任务分派。
4
4
 
5
- **发消息统一用 `ecmsg send`**(本端恒为当前会话本端,群目标用 `--to <群AID>`;宿主终端用 `--from <本端AID>`)。本页其余 `ec group` 命令只用于群管理,不用于发消息。
5
+ **发消息统一用 `ecmsg send`**(本端恒为当前会话本端;当前群会话直接发,跨群用 `--thread main:<本端AID>:<群AID>`)。本页其余 `ec group` 命令用于群管理、群消息拉取与本地历史查询,不用于发消息。
6
6
 
7
7
  本命令覆盖常用消息、基础生命周期、成员操作、角色/群主管理、封禁、屏蔽、成员状态、暂停/恢复和群规则。生产环境 agent 优先使用本页列出的 `ec group` 命令。
8
8
 
@@ -22,6 +22,8 @@ ecmsg send --file <path> [--as <type>] [--text '<说明>']
22
22
 
23
23
  # 自定义 payload
24
24
  ecmsg send --payload '<json>'
25
+ # 注意:--payload-file 只支持私聊发送,群会话里会报「--payload-file is supported for
26
+ # private msg sends only」。群里要发复杂 JSON,用私聊发给对本项目有权限的 agent,或改用 --payload。
25
27
 
26
28
  # 查询本地群历史(只读,不调用 Gateway,不推进 group pull/ack 游标)
27
29
  ec group history <from> <group-id> [--limit <N>] [--thread <main|all|id>] [--format json]
@@ -48,7 +50,6 @@ ecmsg send '通知' --mention 'alice.agentid.pub,bob.agentid.pub'
48
50
 
49
51
  发送选项还包括:
50
52
 
51
- - `--no-encrypt`:强制明文,优先于 `--encrypt`
52
53
  - `--thread <id>`:指定话题 ID
53
54
  - `--content-type <mime>`:覆盖文件 MIME
54
55
  - `--transcript <text>`:语音转写,仅 `--as voice`
@@ -232,7 +232,7 @@ daemon 按整理会话的模式校验 `--scope`:
232
232
 
233
233
  - 逐一读取所有 consolidated 文件查重。先查 `MEMORY.md` 索引,只在发现高度相似的描述时才读那一条确认。
234
234
 
235
- 实现:`src/core/system-session/memory.ts`,由 response-engine 在 `sessionType=memory` 的会话上挂为最终判定(`systemSessionCheck`);同一份声明(`grants()`:可读根 + 唯一可写文件)同时交给 runner 的沙箱 / 工具执行器,Claude / Codex / ecagent 三个 runner 共用,与角色体系无关。整理 trigger 不带 `permissionMode`,不会进入 fullaccess,策略不会被跳过。
235
+ 实现:`src/core/session/system/memory.ts`,由 response-engine 在 `sessionType=memory` 的会话上挂为最终判定(`systemSessionCheck`);同一份声明(`grants()`:可读根 + 唯一可写文件)同时交给 runner 的沙箱 / 工具执行器,Claude / Codex / ecagent 三个 runner 共用,与角色体系无关。整理 trigger 不带 `permissionMode`,不会进入 fullaccess,策略不会被跳过。
236
236
 
237
237
  ---
238
238
 
@@ -2,6 +2,8 @@
2
2
 
3
3
  记忆系统的标签值全集。写入记忆时从本表选值,同一条记忆可以贴多个标签。
4
4
 
5
+ 整理会话读不到本文件——它的可读范围不含 `kits/docs`。整理会话用的精简表在注入的 `$KITS_TEMPLATES/memory-consolidation/workflow.md` 里,增删标签时两处同步。
6
+
5
7
  标签值直接放在 frontmatter 的 `tags` 数组里:
6
8
 
7
9
  ```yaml
@@ -11,21 +11,21 @@
11
11
  ec menu-client request <from-aid> <daemon-aid> \
12
12
  --request-file "$TMPDIR/menu-request.json" \
13
13
  --timeout 15s \
14
- --encrypt \
14
+ --encrypt yes \
15
15
  --format json
16
16
  ```
17
17
 
18
18
  - `--request-file` 与 `--request-json` 二选一,内容是**现有 Menu request**(结构见 `menu-protocol.md §三`);缺少 `id` 时自动生成 UUID。
19
19
  - 请求与响应的 `ttl`、volatile 游标、`to_device_id` 定向回复等传输细节由 CLI 与 daemon 自动处理,调用方无需关心。
20
20
  - 请求声明 `message_class=control`,发送 `client_name=ec-menu-client` 和本机 EvolCore `client_version`;接收端共用 SDK 标准事件,不按类别分设业务处理器。
21
- - `--encrypt` / `--no-encrypt` 显式指定请求加密态;省略时沿用本机 `aun.defaultEncrypt`(未配置为明文)。携带 remote/menu token 或申请 menu token 时默认使用 E2EE;携带凭据时禁止显式明文。响应按远端 Menu 的加密策略处理,客户端均可匹配明文和密文响应。
21
+ - `--encrypt yes|no|auto` 显式指定请求加密态;省略时沿用本机 `aun.defaultEncrypt`(未配置为明文)。必须带取值,裸写是参数错误。携带 remote/menu token 或申请 menu token 时默认使用 E2EE;携带凭据时禁止显式明文。响应按远端 Menu 的加密策略处理,客户端均可匹配明文和密文响应。
22
22
  - 独立终端默认 slot 是 `evolcore-menu-client`;`--app <slot>` 可覆盖,但会切换消费游标,调用方须自行串行化。托管模式使用 daemon 的现有连接和 ACK 路径。
23
23
  - `menu.query` / `menu.options` 等待响应超时时自动重发一次相同 request id;写操作不自动重试。
24
24
  - 默认收到 `menu.response` 即返回,作业受理响应中的 `jobId` 不代表作业完成。升级或模板作业可加 `--wait` 等待终态,`--timeout` 分别限制初始响应和受理后的终态等待。终态字段合并到响应 `data`,保留原响应 `id`;作业失败/取消退出码为 1。超时错误保留 `jobId`,可用已有作业查询接口恢复状态,客户端不重新执行 action。
25
25
 
26
26
  ## 鉴权入口
27
27
 
28
- - 默认授权是远端 `daemon.json.owner` 对发送 AID 的校验。
28
+ - 默认授权是对发送 AID 的 ownership 协议 Owner 校验(控制 AID 的协议共识,不再读 `daemon.json`)。
29
29
  - `--remote-token <token>` 使用 daemon 签发的远程访问 token,权限与 daemon-owner 一致。CLI 审计日志不会记录 token 明文。
30
30
  - `--ecweb-token <token>` 是 `--remote-token` 的兼容别名。
31
31
  - `system/paircode` 例外:仅接受加密的 daemon-owner 请求,已有 remote token 不能换取新配对码。
@@ -26,6 +26,19 @@ Menu Protocol 是 EvolCore 在 AUN `message.send` 之上建立的**应用层协
26
26
 
27
27
  响应 `data.kind="menu.query_batch"`,`data.items` 按输入顺序逐项给出 `itemId/name/ok/data` 或 `itemId/name/ok/error`。`agent` 项可共用其 `fullaccessStatus`、`config.baseagent`、`safeConfig.baseagentSkills`,不必重复请求。Control AID / ECWeb 还需顶层 `agent` 指定目标;members 在这些入口返回该项权限错误。已有 `view="values"` 的 entryId 查询保持不变。
28
28
 
29
+ 私聊提及模式使用专用 `name="private-mention-mode"`,支持 `menu.query/options/update`。
30
+ 查询返回 `mode`(`disabled` 或 `mention-only`)、`override`、`source`、`revision`;缺省为 `disabled`。
31
+ 混合批量查询可加入 `{ "itemId": "privateMentionMode", "name": "private-mention-mode" }`;
32
+ Agent Catalog 的 `privateMentionMode.agent` 同时支持 `view="values"` 批量读取。
33
+ 修改传 `value` 和 `args.expectedRevision`,仅 Agent Owner 可写,版本过期返回 `CONFLICT`。
34
+ 配置仅作用于 Agent 级;不用 CLI,也不复用群聊的 `name="group"`。
35
+
36
+ Agent 渠道开关使用 `menu.action name="agent" action="update"`,
37
+ 参数为 `args={aid,patch:{channelStates:[{type:"feishu",name:"work",enabled:false}]}}`。
38
+ 按 `type/name` 唯一匹配现有非 AUN 渠道,只更新布尔 `enabled`,保留凭据及其它配置。
39
+ 可与 `channelOwners` 一起提交,不可与替换整个数组的 `channels` 同时提交。
40
+ 返回 `data.saved=true`、`data.requiresReload=true`;保存本身不重载 Agent。
41
+
29
42
  ---
30
43
 
31
44
  ## 一、传输层约定
@@ -235,6 +248,22 @@ EvolCore 统一声明 control;能力协商与 normal 降级由 fastaun SDK 处
235
248
 
236
249
  `args.argv`(数组,推荐)优先于 `args.command`(字符串,daemon 侧分词)。
237
250
 
251
+ #### 在本机终端打开 Base Agent 会话
252
+
253
+ `name="session"`、`action="open-terminal"` 接收 Base Agent 自己的 session ID(不是 EvolCore session ID),并在处理请求的 Agent 主机上打开对应 CLI 会话:Claude Code 使用 `claude --resume <sessionId>`,Codex 使用 `codex resume <sessionId>`。后端类型由当前 Agent 配置决定;调用方不能指定 baseagent 或工作目录。工作目录取当前可信 Menu 会话的项目路径,并要求该 session ID 绑定到同一项目且历史文件仍存在。仅限当前 Agent Owner 的 AUN 私聊,不支持 Control AID 或群聊。
254
+
255
+ Codex 使用 EvolCore Provider 注册表时,终端恢复会重建当前 Agent Provider 对应的 `evolcore_registry_…` 配置,携带该连接的 endpoint、headers 和 query 参数;使用 `--no-daemon` 防止复用缺少 Provider 配置的后台进程。凭据通过当前 `$TMPDIR` 内权限受限的临时启动脚本写入子进程环境,不进入终端命令行或 shell history。脚本在执行时删除,启动失败或五分钟未执行时也会清理;不会写入用户的 `~/.codex/config.toml`。
256
+
257
+ ```json
258
+ {
259
+ "type": "menu.action",
260
+ "id": "session-open-1",
261
+ "name": "session",
262
+ "action": "open-terminal",
263
+ "args": { "sessionId": "<base-agent-session-id>" }
264
+ }
265
+ ```
266
+
238
267
  常用 `name` + `action` 组合:
239
268
 
240
269
  | name | action | operation | 说明 |
@@ -257,9 +286,9 @@ EvolCore 统一声明 control;能力协商与 normal 降级由 fastaun SDK 处
257
286
 
258
287
  ### Agent 模板与指定 Provider 模型目录
259
288
 
260
- 主机 Control AID 上支持 `name=agent`、action=`inspect/build/push/pull/deploy`,要求当前操作者同时为 DaemonOwner 和对应 Agent Owner。inspect 即时返回,其他 action 返回 jobId,随后通过 `menu.event template.progress/result` 推送。任务查询为 `menu.query name=agent args={view:'template-job',jobId}`;首次响应丢失时以 requestId 替代 jobId,二者互斥。部署按 pullId 幂等,重启后按持久日志恢复;旧的 upgrade 事件格式保持兼容。
289
+ 主机 Control AID 上使用进程级 `name=template`,制作动作为 `inspect/collect/pack/push`,安装沿用 `pull/preview/deploy`。操作者须为 DaemonOwner,来源采集和覆盖还要求对应 Agent 当前协议 Owner。inspect/collect 必填 module,各自返回独立 jobId;pack 通过 members[key].collections 引用成功的 collect 作业,成功后返回 packageId。build 指整个制作过程,不再是采集动作名。进度事件统一为 `menu.event event=template.job`,携带 jobId/status/phase/seq/error;查询为 `menu.query name=template args={view:'job',jobId}`,也可用原 requestId 查询,二者互斥。collect 默认不冻结,Menu 可直接 collect → pack,不依赖 Agent 修改副本;pack 凭证检测命中直接失败,没有扫描审核接口。Owner Storage 原上传授权与 SDK 分享保持,Agent 自身 Storage 仅是新增路径。
261
290
 
262
- 指定连接的模型查询使用 `menu.query name=model args={scope:'process',view:'catalog',baseagent,providerId,serviceType?,refresh?}`,仅 DaemonOwner Control/受认证管理入口;返回 CatalogSnapshot,不要求先更改 Agent Provider。完整模板输入、分享短码、结果与错误码见仓库 `docs/agent-template/agent-template-app-integration.md`。
291
+ 指定连接的模型查询使用 `menu.query name=model args={scope:'process',view:'catalog',baseagent,providerId,serviceType?,refresh?}`,仅 DaemonOwner Control/受认证管理入口;返回 CatalogSnapshot,不要求先更改 Agent Provider。完整模板输入、分享短码、结果与错误码见仓库 `docs/agent-template/evol-app-template-integration-guide.md` 和 `project-file-selection-integration.md`。
263
292
 
264
293
  ### Agent 初始化参数
265
294
 
@@ -11,8 +11,12 @@ Codex/ecagent 缺少显式模型且目录不可用或无匹配项时,分别返
11
11
 
12
12
  推理强度优先取 Agent、defaults 配置;Claude/Codex 还可分别读取 CLI 的 `effortLevel` / `model_reasoning_effort`,均未配置时使用模型或 SDK 默认值。
13
13
 
14
+ 档位优先采用目录的明确能力声明,并限制在基座可传递的范围内。网关的 `effort.supported_levels: []` 作为空元数据处理,与缺失声明一样回退到已知接口的档位;规范字段 `reasoningLevels: []` 仍表示明确无可选档位。DSH 的缺省档位为 `off / low / high / max`,其中 `off` 会显式关闭 thinking,与使用模型默认值不同。
15
+
14
16
  `ec model` 修改 Agent 级持久化配置,对该 Agent 所有会话的下一条消息生效。
15
17
 
18
+ 目录式基座插件的 C/X 选配能力须声明并实际实现:未开放 C10 时拒绝模型目录查询,未开放 C11 时不提供推理强度选项,执行时也拒绝显式 effort;模型实际支持的 levels 仍是上限。C06(clear)与 `/clear` 已移除,`/new` 只释放旧运行资源并保留旧会话历史。压缩与恢复现归 B 类必需契约,不作为可选开关;必需能力有缺陷则拒绝接入。Host 直接注册的内置基座沿用既有判断。`ec status --format json` 的 `baseagents.items[].capabilities` 只列 C/X 选配声明,接入失败原因看 `plugin.reason`。Gemini 当前的已知 B 类缺口会拒绝注册,原配置保留。
19
+
16
20
  ## 自动压缩
17
21
 
18
22
  任务开始前的主动压缩依据当前有效 Provider 和模型目录接口返回的 `context_window`,
@@ -22,6 +26,9 @@ Codex/ecagent 缺少显式模型且目录不可用或无匹配项时,分别返
22
26
  跳过主动压缩。手动 `/compact` 和基座自身的默认压缩仍可使用。
23
27
  Claude 的 `--autocompact` 参数与返回给界面的压缩刻度使用同一份目录窗口计算;
24
28
  没有接口窗口时不下发 EvolCore 估算的阈值。该逻辑修改需要宿主重新加载源码后生效。
29
+ Claude 所选模型的有效窗口达到 1,000,000 tokens 时,传给 SDK 的裸模型 ID 会补上 `[1m]`,
30
+ 即使 Provider 同时列出了裸 ID 和 `[1m]` 变体;以所选条目的窗口为准。
31
+ 显式选择的 `[1m]`、`[200k]` 后缀保持原样。普通查询与手动压缩共用此处理。
25
32
 
26
33
  ## 命令
27
34
 
@@ -80,7 +87,7 @@ ec model check [--self <aid>]
80
87
  |------------|--------------------|
81
88
  | Claude Code | 使用统一能力解析器读取模型目录与本地参数,设置 SDK 自动压缩阈值;查询与手动压缩使用同一解析路径 |
82
89
  | ecagent | 从本次请求的 Provider 模型目录解析 `contextWindow` 和输出上限 `maxTokens`;查询、手动压缩和上下文统计共用参数 |
83
- | Codex | 优先使用 app-server 实时窗口;缺窗口时仅用参数表补齐统计,不修改 Codex 的执行窗口或压缩配置 |
90
+ | Codex | Provider 的真实模型窗口与自动压缩阈值分开下发;Agent 未配置时压缩阈值为 258400,显式配置只改变压缩阈值 |
84
91
  | Gemini | 执行窗口和压缩仍交给 Gemini CLI 管理,不从参数表注入执行参数 |
85
92
 
86
93
  Claude Code 和 ecagent 的窗口优先级为:显式 `[1m]` / `[200k]` 后缀 → 当前 Provider 模型目录 → 有效参数表记录 → runner 原有保守兜底。输出上限独立按目录 → 本地参数 → 兜底解析。统一解析器支持运行时报告窗口优先校正;没有实际报告时不猜测模型容量。
@@ -89,3 +96,7 @@ ecagent 发给网关的模型 ID 不携带窗口后缀。Codex 没有实时窗
89
96
  ecagent 自动压缩阈值为 `min(650000, contextWindow - max(压缩预留, 输出上限, 安全预留))`,安全预留为窗口的 5%(最多 10000),阈值至少为 1。压缩预留使用 harness 的实际默认设置(16384)。统计中的 `autoCompactTokens` 与 harness 使用同一阈值,`contextWindowSource` 和运行日志区分目录、本地参数、显式后缀及保守兜底;没有参数的未知模型回退到 128k,不代表模型官方上限。
90
97
 
91
98
  模型理论窗口与网关、团队的请求额度是不同限制;查表得到 1M 窗口,不代表可以突破团队的 200K 请求上限。
99
+
100
+ Claude/Codex 每个 Agent 可显式配置 `baseagents.<baseagent>.autoCompactThresholdTokens`,Owner
101
+ 通过原生 `context-policy` Menu 读取代码默认阈值、网关模型窗口、可配置范围和参数来源,并直接更新或恢复默认。配置、
102
+ 兼容规则及协议示例见 [config.md](config.md#agent-自动压缩阈值claude-code--codex)。
@@ -1,8 +1,10 @@
1
- # ec msg — 私聊消息命令
1
+ # ecmsg / ec msg — 私聊消息命令
2
2
 
3
- 私聊场景下收发消息的命令集。触发词:回复/发消息/拉取/撤回/查在线/能力调用/请求等待/结果查询。
3
+ 私聊场景下的消息发送与查询命令集:发送统一用 `ecmsg send`,`ec msg` 负责其余子命令。触发词:回复/发消息/拉取/撤回/查在线/能力调用/请求等待/结果查询/WidgetCard/HTML 表单。
4
4
 
5
- AID 能力的发现、契约校验与调用流程统一加载 `ability` 技能(`ec skill load ability`);协议语义见 `$KITS_DOCS/aun/ABILITY_CALLING.md`。本文维护消息命令参数和请求查询行为。
5
+ AID 能力的发现、契约校验与调用流程统一加载 `ability` 技能(`ec skill load ability`),协议语义在该技能的 `SKILL.md` 里。本文维护消息命令参数和请求查询行为。
6
+
7
+ 常规远端能力任务使用 `ec ability remote list/discover/info/devices/call/result`,命令见该技能的 `references/cli.md`;remote 复用本文的 delegated sender 与请求索引。以下原始消息参数用于通用消息和协议诊断,不作为 remote 权限拒绝后的替代路径。remote 的 call/result 会进一步按原契约核验业务结果,不能把底层 CLI ok 与业务成功混用。
6
8
 
7
9
  ## Agent 会话中的 Shell 调用边界
8
10
 
@@ -11,29 +13,27 @@ AID 能力的发现、契约校验与调用流程统一加载 `ability` 技能
11
13
  和 `ecmsg` 拼在一起。不要做单独的 CLI 探测;直接调用本页的单条命令,读取结构化结果后
12
14
  再决定下一步。工具审批被拒绝时应报告原始错误并停止,不要通过追加命令或提权参数重试。
13
15
 
14
- 发送统一入口是 `ecmsg send`,本端恒为当前会话本端。消息分三种概念:
15
-
16
- | 概念 | 含义 |
17
- |---|---|
18
- | 普通消息 | 当前话题的会话对端发来;回复用 `ecmsg send '<text>'` |
19
- | 跨话题委托 | 本端从另一个话题委托给该话题的对端;对方回复后回流 |
20
- | 跨话题自派 | 本端从另一个话题把任务派给自己 |
21
-
22
- 跨话题**发送**有两个动作:
16
+ 发送统一入口是 `ecmsg send`,本端恒为当前会话本端。接收方由「话题 + 模式」推出,不使用 `--to`:
23
17
 
24
- | 形态 | 写法 | 目标 |
18
+ | 形态 | 写法 | 接收方 |
25
19
  |---|---|---|
20
+ | 当前话题消息 | `ecmsg send '<text>'` | 当前会话的对端/群 |
26
21
  | 跨话题委托 | `ecmsg send '<text>' --thread <话题id>` | 该话题的对端 |
27
- | 跨话题自派 | `ecmsg send '<text>' --thread <话题id> --to <本端AID>` | 该话题下的本端自己 |
22
+ | 跨话题自派 | `ecmsg send '<text>' --thread <话题id> --selfmode` | 本端自己,落在该话题的会话 |
28
23
 
29
- `--thread` 只接受 `thread-…` 与 `main:<aidA>:<aidB>`。
24
+ - `--thread` 只接受 `thread-…` 与 `main:<aidA>:<aidB>`;**不能是当前话题**;话题的本端必须等于当前会话本端。
25
+ - 独立话题必须已存在于本端索引;主话题 id 由两端 AID 直接拼出,首次联系可直接使用,会话随首条消息建立。
26
+ - 群与私聊同构:群主话题同样写成 `main:<本端AID>:<群AID>`(两种顺序等价),群话题也可以自派。
27
+ - `--selfmode` 无取值,必须与 `--thread` 同用;跨话题默认(不带它)就是委托。
30
28
 
31
- **跨话题自派**(`--thread T --to <本端AID>`):本机直接进入该话题的模型队列处理,同一 AID 的其它设备经 AUN 可见但不处理。用于「对端是人、不会自己推进」的分叉场景。话题对端是人类时,派活通知以普通 text 送达对端;是 agent 时以 notice 送达,避免被当成一条要执行的聊天消息。回执会标 `to=<本端AID>(跨话题自派) recipient=self`。
29
+ **跨话题自派**(`--thread T --selfmode`):本机直接进入该话题的模型队列处理,同一 AID 的其它设备经 AUN 可见但不处理。用于「对端是人、不会自己推进」的分叉场景。话题对端是人类时,派活通知以普通 text 送达对端;是 agent 时以 notice 送达,避免被当成一条要执行的聊天消息。回执会标 `to=<本端AID>(跨话题自派) recipient=self topicPeer=<话题对端>`。
32
30
 
33
- 宿主终端没有会话上下文时同样用 `ecmsg send`,本端由 `--from` 显式给出:
31
+ **回执怎么核对**:自派的两个字段 `recipient=self` 与 `topicPeer=<话题对端>` 成对出现,`topicPeer` 一定是真实对端而不是本端。如果回执里只有 `to=<本端AID>(会话|传入)` 而没有 `recipient=self`,说明这个话题的对端被写成了本端自己——结构残缺,消息不会有人接收。这类话题建不出来(创建时即 `SELF_PEER_NOT_ALLOWED`),历史遗留的用 `ec thread delete <本端AID>/<threadId>` 清掉。
32
+
33
+ 宿主终端没有会话上下文时,`ecmsg send` 只支持跨话题自派,本端由 `--from` 显式给出:
34
34
 
35
35
  ```bash
36
- ecmsg send '<text>' --from <本端AID> --thread <话题id> --to <对端或本端AID>
36
+ ecmsg send '<text>' --from <本端AID> --thread <话题id> --selfmode
37
37
  ```
38
38
 
39
39
  `--self` 已不再被接受(本端只由 `--from` 表达)。
@@ -55,9 +55,12 @@ ecmsg send '<text>' --encrypt yes
55
55
  # 强制明文
56
56
  ecmsg send '<text>' --encrypt no
57
57
 
58
- # 文件:--as 可选 image|video|voice|file(默认按扩展名推断)
58
+ # 文件:--as 可选 image|video|voice|file|widget_card(默认按扩展名推断为普通媒体或文件)
59
59
  ecmsg send --file <path> [--as <type>] [--text '<说明>']
60
60
 
61
+ # WidgetCard:HTML 上传为 AUN Storage 附件,App 点击填写,以 widget_card_reply 返回 JSON
62
+ ecmsg send --file ./meeting.html --as widget_card --title '会议安排' --text '请补充会议需求'
63
+
61
64
  # 链接卡片
62
65
  ecmsg send --link <url> [--title '<title>'] [--description '<desc>']
63
66
 
@@ -68,14 +71,14 @@ ecmsg send --payload '<json>'
68
71
  ecmsg send --payload-file <path>
69
72
 
70
73
  # 发送自定义 payload 并等待关联结果
71
- ecmsg send --to <对端AID> --payload '<json>' --return required --timeout 60s --format json
74
+ ecmsg send --thread main:<本端AID>:<接收方AID> --payload '<json>' --return required --timeout 60s --format json
72
75
 
73
76
  # 单向发送,不建立结果关联
74
77
  ecmsg send '<text>' --return none
75
78
  ```
76
79
 
77
80
  `--payload` 优先按 JSON 对象解析;为兼容 Windows 命令包装器,也接受“一层 JSON 字符串包裹 JSON 对象”的形式。`--payload-file` 按 UTF-8 读取文件并执行同样的 JSON 对象校验;两个选项互斥。该选项用于私聊发送(`ecmsg send`),不能同时提供位置文本。
78
- Windows 或包含复杂 JSON 时优先使用 `--payload-file`。临时文件先通过文件工具写入当前会话的 `$TMPDIR`,内容保持原始 JSON,不添加 Shell 转义;发送命令单独执行。托管发送由 daemon 授权后读取文件,校验项目/当前会话临时目录边界和设备路由。PowerShell 路径使用 `"$env:TMPDIR/obs_payload.json"`,Git Bash 使用 `"$TMPDIR/obs_payload.json"`;路径变量不用于 `--payload` 正文。
81
+ Windows 或包含复杂 JSON 时优先使用 `--payload-file`。临时文件先通过文件工具写入当前会话的 `$TMPDIR`,内容保持原始 JSON,不添加 Shell 转义;发送命令单独执行。托管发送由 daemon 授权后读取文件,校验项目/当前会话临时目录边界和设备路由。文件必须是普通文件,上限 1 MiB,符号链接、硬链接和路径穿越一律拒绝。PowerShell 路径使用 `"$env:TMPDIR/obs_payload.json"`,Git Bash 使用 `"$TMPDIR/obs_payload.json"`;路径变量不用于 `--payload` 正文。
79
82
  最多额外解包一层,最终值必须是 JSON 对象;数组、普通字符串、数字、布尔值和 `null` 均会被拒绝。
80
83
  在当前 Windows PowerShell 托管环境中,调用 `ec.cmd` 时使用单引号包裹 JSON,并在 JSON 内每个
81
84
  双引号前加一个反斜杠,例如 `--payload '{\"type\":\"query\"}'`。反斜杠只用于命令行参数传递,
@@ -84,31 +87,43 @@ Windows 或包含复杂 JSON 时优先使用 `--payload-file`。临时文件先
84
87
  每一行都必须单独执行,且是该次 shell 调用中的唯一命令。
85
88
 
86
89
  发送相关选项:
87
- - `--to <对端ID>` — 指定对端(群 AID 或对方 AID,按关系判定类型);省略表示当前会话对端/群
88
- - `--check-every <时长>` — 跨话题复查周期(5m/30m/2h/1d);省略时跨话题补默认 20m,同话题不建复查
90
+ - `--selfmode` — 跨话题自派:必须与 `--thread` 同用,无取值;收件人是本端自己
91
+ - `--from <本端AID>` — 仅宿主终端(非托管)必填;托管会话禁止使用
92
+ - `--check-every <时长|none>` — 跨话题复查周期(5m/30m/2h/1d)。**跨话题且非首次联系时可省略,省略按默认 20m 自动建复查**;`none` 表示不建复查、只写 thread-inbox(收尾场景);同话题忽略该参数,回执里标 `checkEveryIgnored`。注:这是 `ecmsg` 网关口径——直连 `ec msg send` 时带 `--thread` 必填,省略报 `CHECK_EVERY_REQUIRED`
89
93
  - `--mention '<aid1>,<aid2>'` / `--mention-all` — 仅群聊 @成员;私聊带 `--mention` 会被拒绝
90
94
  - `--trigger-prompt <text>` — 跨话题时追加到复查 Trigger 提示词(需与 `--thread` 同用)
91
- - `--text-from-file <path>` — 从文件读取文本(UTF-8),用于超长消息或避免 Shell 转义
95
+ - `--text-from-file <path>` — 从文件读取文本(UTF-8),文件上限 1 MiB
92
96
  - `--handoff-context <text>` — 仅托管私聊跨会话发送可用,1–65536 字符;为本 Agent 的目标会话保存额外交接上下文,处理对端回复时补入。该内容不加入网络 payload,实际发送正文不变;不能用来迁移整个运行中的任务。
93
- - `--encrypt` — 端到端加密
94
- - `--no-encrypt` — 强制明文发送,优先于 `--encrypt`
95
- - `--thread <id>` — 指定话题 ID(多话题路由)
97
+ - `--encrypt yes|no|auto` — 加密三态:`yes` 强制端到端加密,`no` 强制明文,`auto`(默认)被对端消息触发时沿用该消息的加密状态、主动发起时明文;必须带取值,裸写是参数错误,不写该参数才是默认 `auto`
98
+ - `--thread <id>` — 跨话题目标;`thread-…` 或 `main:<aidA>:<aidB>`,不能是当前话题,本端必须一致
96
99
  - `--content-type <mime>` — 显式覆盖 MIME(仅 `--file`)
97
100
  - `--text <说>` — 附件说明文字(仅 `--file`)
98
101
  - `--transcript <text>` — 语音转写(仅 `--as voice`)
99
102
  - `--return none|required` — 是否建立通用请求/响应关联;`required` 会等待结果,默认不要求结果
100
103
  - `--timeout <duration>` — `--return required` 的本地等待时间及 AUN volatile TTL,如 `30s`、`60s`、`2m`;未指定时默认 60 秒,最大 3600 秒
101
- - `--device-id <id>` — 将私聊消息定向到指定 Provider 设备;业务 Ability `role=call` 必须使用从该 Provider 能力索引或 `protocol/discover` 结果中取得的设备 ID
104
+ - `--device-id <id>` — 可选,将私聊消息定向到一台 Provider 设备;指定时必须使用从该 Provider 能力索引或 `protocol/discover` 结果中取得的设备 ID
102
105
  - `--format json` — 输出结构化发送回执和响应
103
106
 
104
- 业务 Ability 调用必须指定能力发布设备,避免 Provider 的多台登录设备同时处理同一调用。设备 ID 是
105
- `message.send` 的传输路由参数,不属于 Ability payload;不要猜测它,也不要把它写入 JSON。
106
- `protocol/discover` 用于发现设备,可以不带 `--device-id`;之后从匹配能力的 `devices` 字段中选择目标设备。
107
- 缺少目标设备的业务调用会以 `ABILITY_DEVICE_REQUIRED` 在发送前失败。`--device-id` 只适用于私聊发送。
107
+ 业务 Ability 调用不带 `--device-id` 时,请求发送给该 AID,由 Provider 路由到在线设备,
108
+ 收到第一个有效最终回包即结束等待,结果携带实际作答设备 ID。成功和失败回包都可结束调用,
109
+ ACK 不结束等待。需要限定某一台时才指定 `--device-id`,它必须来自同一 Provider
110
+ 的发现结果。设备 ID 是 `message.send` 的传输路由参数,不属于 Ability payload;不要猜测它,也不要把它
111
+ 写入 JSON。`--device-id` 只适用于私聊发送。
112
+
113
+ 每次只支持一个设备 ID;要查多台就分别调用。`device/status` 使用相同的首个结果规则。
114
+ `protocol/discover` 按显式发现窗口收集设备证据,不接受 `--device-id`。
108
115
 
109
116
  未指定 `--content-type` 时,附件 MIME 由 SDK 按实际字节识别、后缀回退,附件描述沿用上传后的类型。
110
117
  `--as` 控制消息展示类型,与 MIME 独立。
111
118
 
119
+ `--as widget_card` 是 HTML 表单专用入口,要求托管 daemon 发送、UTF-8 `.html`/`.htm` 文件,原始 HTML 最大 1 MiB;不能与 `--return required`、设备定向或跨话题自派组合。普通 `.html` 文件未显式指定该类型时仍按 `file` 发送。`--title` 设置卡片标题,缺省使用文件名;`--text` 为摘要。`--as action_card` 不存在,简单按钮卡片仍使用现有交互接口或 `--payload`。
120
+
121
+ WidgetCard 复用标准附件上传、持久 outbox 和原卡片关联,上传时注入统一表单运行脚本。基础 HTML 只需一个 `<form>`,多表单页面用唯一的 `form[data-widget-form]` 指定入口;控件使用标准 `name`/`value`。数值输入自动转换,独立复选框转布尔值,多选转数组;可用 `data-widget-type="string|number|boolean|array"`、`data-widget-item-type="string|number"` 明确类型。文件选择暂不支持。`widget_card_reply.values` 为对象,最大 64 KiB,按原话题交给 Agent 继续处理;关闭浏览器不等于取消。
122
+
123
+ 原生 EvolApp 需接入受控浏览器和 `EvolWidgetBridge.postMessage(json)`,返回发送结果的 Promise;Core 代码与 HTML 脚本就绪不代表 App 已完成集成。完整流程和桥接契约见仓库 `docs/widget-card-design.md`。
124
+
125
+ 当 Agent 已经生成了要交付的报告、截图、补丁或其它文件时,应使用上面的 `--file` 发送标准附件消息,并用 `--text` 写简短说明;不要只把本地路径写进普通正文。普通正文里的路径仍表示“请在对端工作区读取”,由接收方按需通过 Menu 查询。
126
+
112
127
  托管会话中的附件源文件必须位于当前项目目录或当前会话 `$TMPDIR` 内;符号链接、硬链接、路径穿越和受保护路径会被拒绝。
113
128
 
114
129
  托管会话主动执行 `ecmsg send` 时,系统会先校验目标关系权限,再将无条目、`pending` 或
@@ -123,9 +138,10 @@ ec peer unblock <target-aid> --self <self-aid>
123
138
  宿主终端(非托管,带 `--from`)不加载 `agents/<aid>/config.json`,且只放行跨话题自派,不经过这条联系人准入链。跨话题自派的收件人是本端自己,在任何环境下都跳过联系人准入。
124
139
 
125
140
  在 EvolCore 会话内,发送会经过当前 session 的 self/peer/role 鉴权。默认目标是当前对端;
126
- 要联系当前对端以外的对象,用 `ecmsg send '<text>' --to <对方AID>`(首次联系直接发出),
141
+ 要联系当前对端以外的对象,用 `ecmsg send '<text>' --thread main:<本端AID>:<对方AID>`
142
+ (主话题可直接发,首次联系也会随消息建立会话),
127
143
  或先 `ec thread list <对方AID>` 选话题(没有就 `ec thread create`),再用
128
- `ecmsg send '<text>' --thread <threadId> --check-every <时长>` 发送(`--check-every` 可省略)。**跨话题会自动创建复查**(缺省 20m),到期后系统向**目标话题**投递一条【跨话题复查】通知(不新建会话),由目标话题侧的 agent 决定结束、调整周期或继续。完整话题路由操作序列见 `[thread]` 段。没有成功回执(含 `message_id`/`status`)不得声称已发送。
144
+ `ecmsg send '<text>' --thread <threadId> --check-every <时长|none>` 发送(`--check-every` 可省略,跨话题默认 20m;`none` = 只写 inbox、不建复查)。**跨话题会自动创建复查**,到期后系统向**目标话题**投递一条【跨话题复查】通知(不新建会话),由目标话题侧的 agent 决定结束、调整周期或继续。完整话题路由操作序列见 `[thread]` 段。没有成功回执(含 `message_id`/`status`)不得声称已发送。
129
145
 
130
146
  成功输出:`✓ 已发送 from=… to=… thread=… chatType=… message_id=<id> seq=<n> status=<status>`
131
147
 
@@ -253,6 +269,50 @@ ec msg history <self-aid> <target-aid> \
253
269
 
254
270
  `sessionId` 是 EvolCore 本地逻辑会话 ID,不是 Claude/Codex 等后端的会话 ID。
255
271
 
272
+ ## 私聊提及模式
273
+
274
+ 私聊的 `@` 处理策略由 Agent 级字段 `privateMentionMode` 控制,与群聊的 `mentionMode` 相互独立。
275
+
276
+ | 值 | 行为 |
277
+ |---|---|
278
+ | `disabled`(默认) | 所有私聊消息都进入模型回合 |
279
+ | `mention-only` | 只有被 `@` 的私聊消息进入模型回合 |
280
+
281
+ 未被 `@` 的消息不会消失:仍然落在本地 `messages.jsonl`,带 `privateAttention: "filtered-mention-only"` 标记。
282
+ 它们没有进入任何会话(无 `sessionId`),因此读取时必须带 `--session all`:
283
+
284
+ ```bash
285
+ ec msg history <self-aid> <peer-aid> --session all
286
+ ```
287
+
288
+ 不带参数等价于 `--session latest`,只返回最近一次会话里的消息,读不到这些被过滤的记录。
289
+ 开启该模式后,被 `@` 时才进入模型,模型需要了解前文就用上面的命令自己读历史。
290
+
291
+ ```bash
292
+ # 开启(仅 Owner 可写)
293
+ ec config set privateMentionMode mention-only
294
+
295
+ # 关闭
296
+ ec config set privateMentionMode disabled
297
+
298
+ # 查看生效值
299
+ ec config get privateMentionMode
300
+ ```
301
+
302
+ 约束:
303
+
304
+ - **只能配置在 Agent 级**。写入关系级会被拒绝(`SCOPE_MISMATCH`),`--default` 同样拒绝。
305
+ - **只有 Owner 可以修改**。其他角色写入会得到 `can only be changed by an owner`。
306
+ - 取值只有 `disabled` 和 `mention-only`,没有 `auto`:私聊下没有「自动判断是否被提及」这回事,
307
+ 未显式 `@` 就是不触发。
308
+ - 切换立即生效,不需要重启或新建会话。
309
+
310
+ 判定只看**结构化 `mentions`**(`payload.mentions` 命中自己的 AID,或 `{scope:"all"}`),不扫正文。
311
+ 客户端不发送结构化 `mentions` 时,`@` 不会被识别为提及。
312
+
313
+ 以下消息不受该模式影响,仍按原路径处理:slash 命令、`menu.*` / `bind.*` / `observer.*` 等控制类 payload、
314
+ echo 探针、联系人待收补投。
315
+
256
316
  ## 共享选项
257
317
 
258
318
  - `--format json` — 对支持结构化结果的子命令输出 JSON
@@ -264,8 +324,8 @@ ec msg history <self-aid> <target-aid> \
264
324
  收到消息 ≠ 必须回复。是否回复、怎么回复、何时回复由 agent 自主决定。
265
325
 
266
326
  加密策略:
267
- - 对端发来密文消息时,回复也应使用 `--encrypt`(保持对话加密一致性)
268
- - 对端发来明文消息时,默认明文回复
327
+ - 对端发来密文消息时,回复也应使用 `--encrypt yes`(保持对话加密一致性)
328
+ - 对端发来明文消息时,用 `--encrypt no` 或省略参数(默认 `auto` 即明文回复)
269
329
  - 主动发起(没有入站消息上下文)默认明文;只有显式 `--encrypt yes`,或 `daemon.json` 设置 `aun.defaultEncrypt: true`,才加密发送
270
330
 
271
331
  `ecmsg send` 默认等价于 `--encrypt auto`:被对端消息触发时沿用该消息的加密状态,主动发起时明文。
@@ -0,0 +1,22 @@
1
+ # ec pay — 网站订单付款
2
+
3
+ 当前 Owner AUN 私聊托管会话中的标准扫码付款,底层复用 AUN 标准附件及可靠消息投递,
4
+ 不建立独立 SDK 连接。
5
+
6
+ **遇到付款先加载 `ec-pay` 技能**(`ec skill load ec-pay`)。命令面、spec 骨架、字段全表、
7
+ 错误码与调用边界全部收在该技能的 `SKILL.md` 里,本文只保留索引作用。
8
+
9
+ ## 命令
10
+
11
+ ```bash
12
+ ec pay request --spec-file <JSON>
13
+ ec pay update <request-id> --spec-file <JSON>
14
+ ec pay complete <request-id> --event-id <event-id>
15
+ ec pay status <request-id> # verify / refresh / cancel 同样
16
+ ```
17
+
18
+ 全部输出 JSON,可显式 `--format json`。托管命令保留当前委托环境,不能指定 self、付款人、
19
+ 另一话题或其它 AID。`request-id` = `pay_` + 32 位十六进制;`event-id` = `payjob_` + 32 位十六进制。
20
+
21
+ App 对接见仓库 `docs/evo-app-pay-integration-v1.md`;Core 已提供对应命令与消息处理,
22
+ App 需另行实现并进行真实平台联调。
@@ -0,0 +1,74 @@
1
+ # 随包插件管理(ec plugin)
2
+
3
+ > 状态:[done]
4
+ > 创建:2026-11-18
5
+
6
+ 用于查询、诊断及设置非 AUN Channel 和所有已声明 Baseagent(包括 Claude/Codex/ecagent/Gemini)的部署状态。核心 AUN 不提供此停用入口。插件代码仍随 EvolCore 构建和发布;此命令不安装、升级或热卸载代码。
7
+
8
+ Baseagent 与 Channel 是宿主基础扩展点,使用各自的加载和执行接口。内置基座继续优先支持及特定适配;共享管理入口不要求它们与外部实现采用相同 Runner、Provider 或初始化策略。
9
+
10
+ ## 命令与返回
11
+
12
+ ```bash
13
+ ec plugin list [--format json]
14
+ ec plugin show <channel|baseagent> <name> [--format json]
15
+ ec plugin doctor <channel|baseagent> <name> [--format json]
16
+ ec plugin enable <channel|baseagent> <name> [--format json]
17
+ ec plugin enable baseagent <name> --force [--format json]
18
+ ec plugin disable <channel|baseagent> <name> [--format json]
19
+ ec plugin --help
20
+ ```
21
+
22
+ name 为库存中的稳定名称,例如 feishu、codex、gemini 或显式声明的自定义基座。新基座需先加入 daemon.plugins 声明并部署对应入口。省略动作等于 list;目前文本和 json 模式都输出结构化 JSON。成功 `ok:true,data`;失败 `ok:false,code,error` 且非零退出码。daemon 不可达时失败,不改本地文件作为回退。
23
+
24
+ list 返回 hostApiVersion 与 items。每项包含 kind/name/displayName/apiVersion/version/hostApi/state,可选 reason,以及配置期望值 enabled、部署差异 restartRequired。state 为 discovered/disabled/unavailable/registered/failed;registered 仅说明轻量工厂已注册,不等于连接或模型已运行。实例状态另看 `ec status --format json`。未知或准入失败入口的版本可能为 0/unknown。
25
+
26
+ show 返回指定项;doctor 额外返回 probe.available/reason,仅检查本地描述及依赖,不导入运行实现、不启动模型或登录外部渠道。禁用/无效描述未导入时,基座诊断会说明描述不可用;历史失败证据保留在 reason 中。本地 probe 成功不代表 B 类行为验收通过。
27
+
28
+ 基座描述符校验失败时,reason.detail 包含实际入口 URL 和校验原文。CLI 安静元数据准备将重复的准入失败及 force 提示写入 DEBUG,状态、完整错误与 warnings 仍可通过 show/doctor 查询;daemon 正常启动发现仍输出 WARN,意外导入失败仍输出 ERROR。claude-gateway 属于宿主网关;当前加载器不扫描未声明目录,不应为该网关增加 baseagent 声明。
29
+
30
+ enable/disable 设置 `daemon.json.plugins['<kind>:<name>'].enabled`,返回新库存及顶层 restartRequired:true。当前实例继续使用已注册代码,宿主重启后部署才改变;操作不会切换 Agent 的基座,也不会删除渠道凭据。
31
+
32
+ 基座默认严格校验必选 B 类能力。`ec plugin enable baseagent gemini --force` 显式保存 `enabled:true,force:true`,允许 B 类能力未支持或未验证的插件及 runner 加载;每项缺口保留日志告警与库存 `warnings`。库存 `force` 是配置期望值,`forced` 是本次启动实际采用值;两者不同时需重启。普通 enable/disable 保留已存 force,避免启停意外改变部署策略;显式 Menu args.force=false 或 ECWeb“恢复严格加载”撤销 force。enabled=false 始终优先于 force。强制模式仍校验描述格式、Host API、操作系统、依赖、runner 身份与最小查询/释放接口,不改变工具权限,也不把缺失能力标成可用。`--force` 仅适用于 `enable baseagent`。
33
+
34
+ ECWeb 基础设置保留已发现插件的基座卡片,即使尚未配置模型或当前不可用。基座快照的 `plugin.force`、
35
+ `plugin.forced`、`plugin.restartRequired` 分别表示强制配置、本次启动采用的策略及部署差异;卡片区分待重启、
36
+ 准入失败、加载失败并展示具体原因。强制模式不代替 CLI/依赖探测,未通过依赖检查时仍不能选为可用默认基座。
37
+
38
+ 基础设置另外显示独立的本机安装扫描:未声明或禁用的已安装运行时显示“已安装,未启用”,版本、Node 或平台不满足时显示“已安装,依赖或平台不兼容”及具体原因。检测点未安装为灰色,已安装但未启用、待重启、准入/依赖失败或保留能力告警为橙色,通过检查且无告警为绿色。扫描本身不修改配置;点击“重新检测”发现未声明或禁用的已安装基座后,确认弹窗才通过进程级插件管理写入 daemon 的 `plugins["baseagent:<name>"].enabled=true`,保留已有 force 策略,待宿主重启后按该策略准入加载。取消不写配置,能力不足不会被误认为已卸载并提示删除。`ec plugin enable baseagent <name>` 同样可为扫描到的包内已安装基座补声明;未加载的声明在库存中标记待重启,不注册运行组件。默认选择仍以原可运行判据为准。此安装清单通过 `baseagent.snapshot.installation` 返回,与 `ec plugin` 的运行库存分别维护,不能用 `Plugin not found` 判断机器上没有安装 CLI。
39
+
40
+ ## 权限与三个层级
41
+
42
+ 宿主终端使用现有本地 control token 通过 daemon IPC 执行。托管 Agent 只能使用绑定当前 session、任务和原命令的 delegated 凭证,操作由统一进程授权器判断:普通路径遵循 DaemonOwner 控制面规则,trusted fullaccess 沿用通用授权。普通 Agent Owner 不因此取得 DaemonOwner 权限。
43
+
44
+ | 层级 | 配置/入口 | 效果 |
45
+ |---|---|---|
46
+ | 进程插件部署 | ec plugin enable/disable | 决定宿主是否注册插件,需重启 |
47
+ | Agent 基座选择 | Agent 的 active_baseagent 与 baseagents.<name>,现有 model/config/Menu | 选择该 Agent 使用的后端与模型,不安装插件 |
48
+ | 渠道实例 | Agent 的 channels[].enabled 与凭据 | 管理某 Agent 的渠道实例,不卸载共享渠道实现 |
49
+
50
+ 基座运行注册只识别 daemon.plugins 中的 baseagent:<name> 声明,不因安装扫描自动加载;源码对应 src/agents/<name>/index.ts,构建对应 dist/agents/<name>/index.js,入口缺失显示失败原因。daemon Schema v12、defaults v8 配套一次性迁移:原基座和已使用基座补入声明,显式 daemon 值优先,旧 defaults.enabled 移入后删除,原 Agent 配置与会话绑定保持;迁移完成后不再自动补声明。首次安装模板提供标准基座清单;已有 daemon 的空清单代表无运行基座,不代表本机未安装 CLI。渠道 Process 开关仍缺省 true。
51
+
52
+ CLI 与 Web 初始化也使用独立安装扫描。CLI 交互模式对未声明或禁用的已安装基座逐项询问,肯定回答才写 daemon 声明;非交互模式仅将显式 `--baseagent <name>` 视为该基座的添加确认,不自动启用其它扫描结果。CLI 当前无 daemon 运行,写入后重新进行轻量准入再供选择,不创建 Runner。Web 初始化及独立创建 Agent 页面在发现配置时弹出确认,经当前主机 Owner 核验后写声明;新声明需宿主重启后可选,不在页面自动重启宿主。取消不写声明,普通启用保留既有 force,不自动强制加载。Web 的 `POST /api/init/configuration/baseagents`(独立创建为 `/api/init/agent-creations/<workflowId>/configuration/baseagents`)接收 `{"baseagent":"dsh","confirmed":true}`,返回 `baseagents` 快照与 `restartRequired:true`;GET 仅返回安装事实,不写声明。
53
+
54
+ ## Menu 与 ECWeb
55
+
56
+ Menu name=plugins 与 CLI 使用同一库存和配置服务,仅接受 scope:'process'。控制请求需要当前有效 DaemonOwner;更新要求加密 Control Menu 或已认证 ECWeb 管理上下文。
57
+
58
+ ```json
59
+ {"type":"menu.query","id":"plugin-list","name":"plugins","args":{"scope":"process"}}
60
+ {"type":"menu.query","id":"plugin-show","name":"plugins","args":{"scope":"process","kind":"channel","name":"feishu"}}
61
+ {"type":"menu.query","id":"plugin-doctor","name":"plugins","args":{"scope":"process","kind":"channel","name":"feishu","view":"doctor"}}
62
+ {"type":"menu.update","id":"plugin-disable","name":"plugins","args":{"scope":"process","kind":"channel","name":"feishu"},"value":false}
63
+ {"type":"menu.update","id":"plugin-force","name":"plugins","args":{"scope":"process","kind":"baseagent","name":"gemini","force":true},"value":true}
64
+ ```
65
+
66
+ query 可按 kind、name 过滤,doctor 必须同时提供 kind/name;update 必须提供 kind/name 和 boolean value,禁止夹带 Agent/relation 选择器。`args.force` 只用于基座更新;省略保留已有值,true 强制、false 严格;停用仍保留该值。显式上下文只允许 context:{kind:'process'}。返回标准 menu.response 的 data/error;查询为库存,doctor 为指定项与 probe,更新为新库存与重启提示。Menu 目录按已发现插件生成带完整参数的更新与诊断条目。
67
+
68
+ ECWeb 进入“基本设置 → 运行时 → 运行时插件”:读取库存及当前失败原因,点击“诊断”执行本地探测,点击“启用/停用”立即保存部署期望值并展示重启提示。修改失败保留原值并展示服务端原因;不会自动重启 daemon。新基座名称和展示标签由 Host 快照提供,专用复杂参数继续通过 ec config 管理。
69
+
70
+ 基座插件另有“强制启用”按钮;保存后显示强制模式与能力告警,可点击“恢复严格加载”撤销 force。两种操作均使用上面的 Menu 参数,重启前展示待应用状态。
71
+
72
+ 接入开发接口见 [Baseagent 接入协议](../../../docs/baseagent-plugin-standard.md),渠道窄接口见同文第 8 节。加载 API 1/Host API 1.0.0 与执行契约 host-runner-1 独立;候选 v2 仍是设计稿。
73
+
74
+ 从接入选型、实现 Runner 到真实验收的开发流程见 [Baseagent 集成开发手册](../../../docs/baseagent-integration-handbook.md),其中分别说明 SDK、单次 CLI、ACP/常驻 RPC/HTTP 与各类进程所有权、中断、重建和沙箱边界。
@@ -99,6 +99,8 @@ Windows 只读配置在替换前临时解除只读,替换完成或失败后恢
99
99
 
100
100
  启动时,在加载 Agent 前恢复未完成的迁移事务,再更新全局默认、Agent、关系配置和 fallback,以及初始化记录和 ECWeb 创建工作流中的运行时 Provider 绑定。初始化原始 plan、fingerprint、创建凭据和请求 ID 保持不变,避免破坏重试与恢复的一致性。统一配置快照已覆盖初始化记录和 ECWeb 创建状态,迁移前版本包含全部受影响文件,而非仅 providers.json。
101
101
 
102
+ 启动和身份迁移即使没有 ID 变化或旧别名,也会扫描基座选择。`baseagents.<name>.provider` 指向不存在的 Provider 时,只清除该失效字段,保留模型、推理强度等独立配置,使 Agent 重新继承 defaults 的同基座 Provider。defaults 的失效引用同样清除;整条链都未填写时,沿用基座现有的本机配置或环境变量凭据,没有可用凭据则连接失败,不自动选择注册表中的其他 Provider。已有 Provider 的服务缺失、凭据错误及 fallback/Services 的失效引用仍按原规则报错。清理沿用同一快照、校验和事务机制,重复启动不重复写入。
103
+
102
104
  Provider 不再创建独立的长期迁移备份,版本查看、恢复和保留清理由现有 ec config 快照机制统一管理;既有历史迁移备份保留不动。短期事务日志仅用于本次操作的失败回滚和中断恢复,成功提交后删除。若 configSnapshots=false,不创建版本备份,在线 sync 返回 CONFIG_SNAPSHOTS_DISABLED 告警,启动迁移也记录告警,但事务日志回滚仍启用;快照开启但写入失败则在修改配置前中止。
103
105
 
104
106
  新快照记录扩展后的文件范围;恢复到尚未收录初始化状态的历史快照时,不因这些文件缺席而删除当前初始化状态。新快照则能够恢复这些文件的内容或原本不存在的状态。
@@ -131,6 +133,20 @@ Provider 不再创建独立的长期迁移备份,版本查看、恢复和保
131
133
 
132
134
  apiKey 可用共享 Provider schema 支持的环境变量引用;真实凭据应只保存在受权限保护的 JSON 文件中,不放入命令行历史。
133
135
 
136
+ 同一服务方的多把 Key 写进同一个 Provider 的 `apiKey` 数组,不必为每把 Key 另建 Provider:
137
+
138
+ ~~~json
139
+ {
140
+ "name": "Example",
141
+ "domain": "api.example.com",
142
+ "common": {
143
+ "baseUrl": "https://api.example.com/v1",
144
+ "apiKey": ["$EXAMPLE_API_KEY", "$EXAMPLE_BACKUP_KEY"]
145
+ },
146
+ "services": { "text": {} }
147
+ }
148
+ ~~~
149
+
134
150
  Provider identity 取完整规范化 hostname:小写、IDN 转 Punycode、去掉末尾点;裸注册域名补为 `www.`,已有子域名保持不变。domain 由程序获取并保存,ECWeb 不提供独立输入或展示字段,JSON 预览也隐藏该内部字段。静态 `baseUrl` 自动提取 hostname;管理入口收到未带 domain 的环境变量地址时,从宿主进程环境解析 URL 并提取,配置中的 baseUrl 仍保留变量引用。变量缺失、为空或解析结果不是有效 HTTP(S) URL 时拒绝新建,已有 domain 的配置读取不依赖变量是否存在。配置文件仍可显式声明 domain,运行时实际地址必须与保存的身份匹配。ID 为完整 SHA-256 摘要转整数后对 100000000 取模并补齐八位。哈希碰撞会拒绝保存,不会改用环境相关的替代 ID。迁移旧 `provider-N` 时会保留 aliases 供旧引用和冻结初始化计划兼容。
135
151
 
136
152
  hostname 同时支持 IPv4、IPv6 和 `localhost`,不补 `www.`。IPv6 统一为 URL hostname 使用的压缩、带方括号形式(如 `[::1]`);显式 domain 也接受不带方括号的 IPv6。端口仍属于连接地址,不参与身份计算;同一主机的不同协议或端口不能合并。DNS 身份与已有固定 ID 的生成规则保持不变。
@@ -139,7 +155,7 @@ hostname 同时支持 IPv4、IPv6 和 `localhost`,不补 `www.`。IPv6 统一
139
155
 
140
156
  文本模式打印脱敏数据;--format json 成功返回 { ok: true, data },失败返回 { ok: false, code, error, data? } 且退出码非零。
141
157
 
142
- 常见错误:INVALID_ARGUMENT(参数/JSON)、NOT_FOUND(未知 ID)、CONFLICT(revision 冲突、仍有引用或引用无法校验)、PROVIDER_CONFLICT(域名已存在)、PROVIDER_ID_COLLISION(八位哈希碰撞)、PROVIDER_DOMAIN_IMMUTABLE(不能修改已有域名)、PROVIDER_DOMAIN_REQUIRED/INVALID/MISMATCH(域名缺失、非法或与地址不符)、FORBIDDEN(身份/入口不具备授权)、INVALID_CONTROL_TOKEN(宿主凭据无效)、DAEMON_UNAVAILABLE(daemon 不在线)。
158
+ 新建 Provider 使用 name 作为稳定 ID;名称重复时返回 CONFLICT(kind 为 provider_name_exists),应更换名称。相同域名或 Base URL 可以创建多个 Provider。已有 Provider 保留原 ID;修改展示名称使用 displayName。常见错误:INVALID_ARGUMENT(参数/JSON)、NOT_FOUND(未知 ID)、CONFLICT(名称或 revision 冲突、仍有引用或引用无法校验)、PROVIDER_DOMAIN_REQUIRED/INVALID/MISMATCH(域名缺失、非法或与地址不符)、FORBIDDEN(身份/入口不具备授权)、INVALID_CONTROL_TOKEN(宿主凭据无效)、DAEMON_UNAVAILABLE(daemon 不在线)。
143
159
 
144
160
  升级时在启动阶段通过统一快照备份并迁移注册表和实际选择引用,冻结初始化计划保留原文并通过局部运行时绑定兼容,成功后清理全局 aliases。旧环境变量地址未声明 domain 时暂保留旧 ID,并报告待处理;localhost 和 IP 地址按规范化主机名生成固定 ID。不同凭据或服务端点冲突须先人工协调,迁移不会静默覆盖。
145
161
 
@@ -154,6 +170,13 @@ Provider schema v3 增加 `services.<type>.catalogPath`、`apiKey`、`headers`
154
170
 
155
171
  服务级 Key 未声明时继承 `common.apiKey`,声明后独立使用,支持整字段环境变量引用。
156
172
  显式空 Key 不回退公共 Key,缺失/空环境变量直接报错。服务级 headers/queryParams 整组覆盖,
173
+ `apiKey` 可写单值或有序数组(Key 池):第 0 位是主力,`apiKeys` 解析结果按原顺序给出整池,
174
+ `apiKey` 仍是主力。第一版只存储不自动切换——备用 Key 存进去后仍由主力承担全部请求,
175
+ 换用备用需要后续版本的故障切换。单元素数组按单值写回,老配置读写后字节不变。
176
+ 池上限 16 把,重复 Key 与逐元素的环境变量语法会被拒绝;主力 Key 的环境变量未设置仍严格报错,
177
+ 备用位的环境变量未设置只丢弃该位并记警告,避免一把过期备用拖垮可用主力。
178
+ `<redacted>` 按位保留,第 i 位的掩码还原旧池第 i 把,新增位置必须带真实 Key。
179
+ 服务级 headers/queryParams 整组覆盖,
157
180
  省略表示继承,`{}` 表示清空。独立 Key 与公共认证头/认证查询参数可能冲突时,要求显式覆盖对应组。
158
181
  旧配置没有覆盖字段时保持原语义。导入导出、脱敏、模型目录与推理均使用目标服务的有效连接。
159
182
  单服务带密钥导出只包含该服务的有效凭据;不带密钥导出移除公共和服务级 Key、headers、queryParams。
@@ -214,7 +237,11 @@ key/api_key/apikey/access_token 参数,避免旧值覆盖新密钥,也不改
214
237
 
215
238
  ## Menu 对应
216
239
 
217
- name=provider,显式 args.scope=process,可选 args.context={kind:process}。query 支持 list/detail/templates,CLI show 对应 detail;普通 update 使用 args.resource=provider 和完整 JSON 字符串 value;action 支持 create/import/delete。全部写入要求 expectedRevision。
240
+ name=provider,显式 args.scope=process,可选 args.context={kind:process}。query 支持 list/detail/templates;普通 update 使用 args.resource=provider 和完整 Provider 对象 `value`(同时兼容 JSON 字符串);action 支持 create/import/delete。全部写入要求 expectedRevision。Provider 的 `displayName`(展示名称)和 `description`(描述)是可选字符串,list/detail 会返回,完整对象 update 可修改。`services.<type>.style`、`path`、服务级凭据和模型策略也可在该对象中配置;Menu catalog 会发布对应对象 schema。
241
+
242
+ App 编辑页通过 Host Control Menu 查询 `detail`。通过现有鉴权后,明文和加密请求均在 `provider.common.apiKey` 和 `provider.services.<type>.apiKey` 返回配置保存值,包括单值、有序 Key 池或环境变量引用原文。`headers`、`queryParams`、列表、保存响应及 CLI `show` 继续脱敏。
243
+
244
+ Menu 客户端可以直接把 Provider 对象放在 `menu.update.value`;创建时也可以把对象放在 `menu.action` 的 `value`,不再必须先把对象序列化成字符串。旧版的 JSON 字符串写法继续兼容。创建请求也仍接受既有的 `args.provider` 形式。
218
245
 
219
246
  App 模板契约(均使用 name=provider、scope=process):
220
247
 
@@ -2,11 +2,11 @@
2
2
 
3
3
  直接调用 AUN 协议方法的逃生通道。触发词:直接调协议方法/批量 RPC。
4
4
 
5
- > 常规消息收发用 `ec msg` / `ec group`,文件用 `ec storage`。`ec rpc` 是这些命令未覆盖到协议方法时的低层入口。
5
+ > 常规消息发送用 `ecmsg`,消息查询用 `ec msg`,群管理用 `ec group`,文件用 `ec storage`。`ec rpc` 是这些命令未覆盖到协议方法时的低层入口。
6
6
 
7
7
  ## 运行边界
8
8
 
9
- 实际 RPC 调用仅供宿主终端使用;EvolCore 托管 Agent 会话只能查看 `ec rpc --help`,不能执行协议调用。此入口会直接使用指定本地 AID 建立 SDK 连接,没有托管会话的 delegated sender 和逐操作 daemon 鉴权,因此不能用于绕过 `ec msg`、`ec group` 或 `ec fs` 的权限限制。
9
+ 实际 RPC 调用仅供宿主终端使用;EvolCore 托管 Agent 会话只能查看 `ec rpc --help`,不能执行协议调用。此入口会直接使用指定本地 AID 建立 SDK 连接,没有托管会话的 delegated sender 和逐操作 daemon 鉴权,因此不能用于绕过 `ecmsg`、`ec msg`、`ec group` 或 `ec fs` 的权限限制。
10
10
 
11
11
  ## 用法
12
12