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,5 +1,13 @@
1
1
  # 服务路由(`ec services`)
2
2
 
3
+ 服务请求携带执行截止时间;排队或宿主准备期间到期的请求不再启动脚本。已经开始的
4
+ 业务副作用不会因调用方超时而自动撤销,超时后仍须核对结果。默认结果去重窗口为 15 秒;
5
+ 显式更长的调用窗口会将结果保留到截止时间后 3 秒,最长按 5 分钟调用窗口约束。
6
+
7
+ 常驻和一次性脚本保持相同的 `noop` 与无沙箱审计语义。宿主按工程、权限模式及
8
+ owner+bypass 例外区分执行策略;切换策略时等待旧调用完成,不复用旧权限的宿主。
9
+ `ec services host enable --aid <aid>` 启用宿主;`host disable` 先排空在途调用再释放进程。
10
+
3
11
  > 完整设计见仓库 `docs/services/`;Schema 见 `docs/services/schema/`。
4
12
 
5
13
  Agent 怎么建服务包、写处理脚本、让对端调到你。
@@ -11,15 +19,15 @@ Agent 怎么建服务包、写处理脚本、让对端调到你。
11
19
  | 到点执行(每天 9 点、每隔 30 分钟) | `ec trigger`,不是服务 |
12
20
  | 对端发消息给我,我跑确定性逻辑并**回结果** | **服务** |
13
21
  | 我要主动通知别人 | 事件中心(`ec events`)或 `ecmsg` |
14
- | 消息绝不能丢、必须有应答 | **服务**(走普通持久消息) |
22
+ | 对端要当场拿到结果、拿不到就算了 | **服务**(走 volatile 消息,超时即失败) |
15
23
  | 广播给很多人 | 事件中心,不是服务 |
16
24
 
17
25
  一句话区分:**服务是点对点调用,事件是广播通知。**
18
26
 
19
27
  | | 服务 `services/` | 事件 `events/` |
20
28
  | --- | --- | --- |
21
- | 传输 | 普通持久消息 | AUN pubsub(volatile) |
22
- | 会丢吗 | 不会 | 会 |
29
+ | 传输 | 点对点 volatile 消息(TTL = 调用窗口) | AUN pubsub(volatile) |
30
+ | 会丢吗 | 会——超时即失败,不补投 | 会 |
23
31
  | 有应答吗 | 有,`.result` | 无 |
24
32
 
25
33
  ## 二、目录
@@ -41,9 +49,14 @@ $AGENT_DIR/services/
41
49
  ```bash
42
50
  ec services pack add <包名> --from <源目录>
43
51
  ec services pack remove <包名> [--purge]
52
+ ec services pack enable <包名>
53
+ ec services pack disable <包名>
44
54
  ec services pack list
45
55
  ```
46
56
 
57
+ `pack enable` / `pack disable` 改的是 `pack.json` 里的 `enabled`(单包开关),
58
+ 与 AID 级总闸 `ec services enable` / `disable` 是两个层级。
59
+
47
60
  `services-config.json` 装好后基本不用改:
48
61
 
49
62
  ```json
@@ -104,11 +117,18 @@ ec aid agentmd set <本AID> exttype order
104
117
  {
105
118
  "v": 1,
106
119
  "name": "订单受理",
120
+ "description": "订单受理相关的全部服务",
107
121
  "requires": { "type": ["services", "agent"], "exttype": "order" },
108
122
  "listen": [
109
123
  {
110
124
  "type": "services.order.create",
111
- "handler": { "script": "scripts/on-create.mjs", "runtime": "node", "timeoutMs": 15000 }
125
+ "handler": {
126
+ "script": "scripts/on-create.mjs",
127
+ "runtime": "node",
128
+ "timeoutMs": 15000,
129
+ "name": "下单",
130
+ "description": "创建订单。data: {sku, qty},返回 order_id"
131
+ }
112
132
  }
113
133
  ],
114
134
  "reply": { "allowed": true }
@@ -121,6 +141,12 @@ ec aid agentmd set <本AID> exttype order
121
141
  - `listen[].type` 必须是 `services[.<段>[.<段>]]`,末段可写 `*`
122
142
  - `handler.script` 必须在 `scripts/` 下,禁止绝对路径、`..`、符号链接
123
143
  - `runtime` ∈ `node` / `python` / `bash` / `powershell`;省略时按扩展名推断
144
+ - `handler.name`(≤24 字)/ `handler.description`(≤120 字)可选,**建议写**:
145
+ 它们是 `data` 契约的唯一说明渠道,对端靠 `services.describe` 读到才知道该往 `data` 塞什么
146
+ - `handler.mode` ∈ `spawn`(默认)/ `resident`:后者是常驻子进程形态,需要按新契约写脚本
147
+ (先发 `{t:'ready'}`、每行带原样 `callId`、上下文从帧里读、日志走 stderr)。
148
+ **默认别用**。`host.enabled` 不是 `true` 时降级为每调用一个进程——结果一样,但没有稳态
149
+ 收益,`ec services doctor` 会提醒。完整契约(帧字段、两个目录、超时参数)见 `usage.md` §八·五
124
150
  - 同包内 `type` 重复 → 整包 invalid;跨包重复 → 两个包都 invalid
125
151
  - 一个包校验失败只废这个包,其余照常
126
152
 
@@ -146,12 +172,12 @@ ec aid agentmd set <本AID> exttype order
146
172
  ## 七、怎么调别人
147
173
 
148
174
  ```bash
149
- ec services describe <aid> # 对方有什么
150
- ec services schema <aid> <type> # 参数结构
151
- ec services call <aid> <type> --data '<json>' # 发起调用
175
+ ec services describe --aid <aid> # 对方有什么
176
+ ec services schema --aid <aid> --type <type> # 参数结构
177
+ ec services call --aid <aid> --type <type> --data '<json>' # 发起调用
152
178
  ```
153
179
 
154
- `call` 默认等结果,30 秒超时:
180
+ `call` 默认等结果,**12 秒**超时:
155
181
 
156
182
  ```json
157
183
  { "ok": true, "data": { "order_id": "O-1" } }
@@ -159,11 +185,10 @@ ec services call <aid> <type> --data '<json>' # 发起调用
159
185
 
160
186
  | 选项 | 作用 |
161
187
  | --- | --- |
162
- | `--timeout 60` | 自定等待时长;超时**不重试**,退出码 2 |
188
+ | `--timeout 5` | 自定等待时长;超时**不重试**,退出码 2 |
163
189
  | `--encrypted` | 加密调用,回复也加密 |
164
- | `--no-wait` | 只发不等 |
165
190
 
166
- **超时后不要直接重发**,先查一次确认是否已执行,否则会重复。
191
+ **超时后不要直接重发**。请求只活一个调用窗口,对端离线时到期即消失、不会补投;同一 `request_id` 默认保留结果 15 秒,显式更长窗口保留至截止后 3 秒。缓存过期后不再提供执行去重。
167
192
 
168
193
  ## 八、脚本契约
169
194
 
@@ -207,7 +232,7 @@ ec services call <aid> <type> --data '<json>' # 发起调用
207
232
 
208
233
  | 项 | 值 |
209
234
  | --- | --- |
210
- | 超时 | 默认 30s,`timeoutMs` ∈ [1s, 300s] |
235
+ | 超时 | 默认 10s,`timeoutMs` ∈ [1s, 300s]。默认值刻意短于调用方的 12 秒等待期 |
211
236
  | 输出上限 | stdout+stderr 合计 1 MiB;**超出即终止进程并返回 `SCRIPT_OUTPUT_LIMIT`**,不是截断 |
212
237
  | 环境变量 | `EC_SELF_AID` / `EC_SELF_TYPE` / `EC_SELF_EXTTYPE` / `EC_PACK_DIR` / `EC_SERVICE` / `EC_REQUEST_ID` / `EC_FROM` / `EC_MESSAGE_ID` / `EC_ENCRYPTED` |
213
238
  | 密钥清理 | 固定名单(各家 base agent 的 API key)+ 按名字识别的凭据变量(`*_API_KEY` / `*_TOKEN` / `*_SECRET` / `*_PASSWORD`,以及 `AWS_` `GITHUB_` `NPM_` 等前缀)+ 全部 `EVOLCORE_*` |
@@ -240,8 +265,8 @@ Codex 只当沙箱宿主,与 baseagent 无关。没装时返回 `SCRIPT_SANDBO
240
265
 
241
266
  - 不带 `request_contact`、不带包名/type/脚本路径——回包不能变成探测手段;
242
267
  - 无论目标 type 是否存在,回包完全一样(否则"有没有回包"就是枚举信道);
243
- - 同一个来源 **24 小时内只回这一次**,之后一律静默;全局另有 30 次/分、200 次/时
244
- 的回复上限,换 AID 也放不大。
268
+ - 同一个来源 **24 小时内只回这一次**(这是拒绝回包的去重窗口,与调用侧 12 秒
269
+ 无关),之后一律静默;全局另有 30 次/分、200 次/时 的回复上限,换 AID 也放不大。
245
270
 
246
271
  **不会自动建联系人申请**,对方需自己 `ec directory request` 找你的 Owner。
247
272
 
@@ -321,6 +346,7 @@ ec services rules remove services.order.create spam.agentid.cn --deny
321
346
  | **查看** | `status` `types` `ledger` `tail` `doctor` `reload` `rules show` `pack list` | member 及以上 | member 及以上 + 同 Owner |
322
347
  | **管理** | `pack add` `pack remove` `pack enable` `pack disable` `rules add` `rules remove` | owner / admin | daemonOwner + fullaccess + 同 Owner |
323
348
  | **总闸** | `enable` `disable` | daemonOwner + fullaccess | daemonOwner + fullaccess + 同 Owner |
349
+ | **宿主** | `host enable` `host disable` | daemonOwner + fullaccess | daemonOwner + fullaccess + 同 Owner |
324
350
  | **调用** | `describe` `schema` `call` | 准入决定(本机不判权) | 准入决定(本机不判权) |
325
351
 
326
352
  ### 概念
@@ -391,10 +417,12 @@ OS 账户权限就是信任边界。托管会话则按上表判定。
391
417
  ## 十二、排查
392
418
 
393
419
  ```
394
- ec services status # 包状态:active / skipped / invalid
395
- ec services doctor <包名> # requires、保留字遮蔽、脚本、路径
420
+ ec services status # 包状态:active / skipped / invalid;含 host 段
421
+ ec services types # 本 AID 现在能接的全部 services.*
422
+ ec services doctor <包名> # requires、保留字遮蔽、脚本、路径、ACL
396
423
  ec services ledger <包名> --tail 20
397
424
  ec services tail <包名>
425
+ ec services repair-acl # 历史包的 NTFS ACL 收口(幂等,仅 Windows)
398
426
  ```
399
427
 
400
428
  | 症状 | 先看 |
@@ -408,8 +436,8 @@ ec services tail <包名>
408
436
 
409
437
  ## 十三、不要做的事
410
438
 
411
- 1. **不要在没有幂等的操作上依赖去重**。daemon 按 `(from, request_id)` 去重 24 小时,
412
- 超出窗口的重试会重新执行。
439
+ 1. **不要在没有幂等的操作上依赖去重**。daemon 按 `(from, request_id)` 默认去重 15 秒,更长请求按截止时间扩展;
440
+ 超出窗口的重试会重新执行;真正的幂等键要由脚本按业务字段自己保证。
413
441
  2. **不要在脚本里自己发回复**。输出 `outcome` 让 daemon 发,否则话题、加密态、
414
442
  `request_id` 都会错。
415
443
  3. **注意保留字只占两段形式**。`exttype` 设成 `list` 时 `services.list` 被内置抢走,
@@ -16,8 +16,24 @@ ec skill load <技能名> --source builtin # 指定来源(builtin|local)
16
16
  ```
17
17
  ---
18
18
  skillDir: <技能目录绝对路径>
19
+ chars: <正文字符数>
19
20
  ```
20
- 脚本路径、references/ 等资源均以此为根。
21
+ `skillDir` 是脚本路径、references/ 等资源的根;`chars` 是正文(不含页脚)的字符数,
22
+ 按 Unicode 码点计数,中文一个字算 1。`--json` 时同为 `chars` 字段。
23
+
24
+ ### 技能目录写成 `{{skillDir}}`
25
+
26
+ SKILL.md 正文里技能目录要引用的地方,一律写成 `{{skillDir}}`,加载时替换成本机技能目录的
27
+ 绝对路径(统一正斜杠):
28
+
29
+ ```bash
30
+ node "{{skillDir}}/scripts/foo.mjs"
31
+ ```
32
+
33
+ 正文因此不含任何本机路径,换机器、换安装位置都不用改。旧写法 `<技能目录>` 同样处理;
34
+ 占位符后面不跟路径分隔符时原样保留。`chars` 统计的是渲染前正文的字符数,不受安装路径
35
+ 长度影响。直接读取 SKILL.md 文件看到的仍是未渲染的占位符——执行脚本用加载输出,或照页脚的
36
+ `skillDir:` 自己替换。
21
37
 
22
38
  ## 查路径
23
39
 
@@ -4,6 +4,11 @@
4
4
 
5
5
  同时查看 Agent 预算和对端角色额度的实际已用、剩余,用 `ec quota status`,见 [quota.md](quota.md)。
6
6
 
7
+ 当前网关没有返回所用模型的官方价格 `pricing` 时,以
8
+ `https://mg-new.evolai.cn/claude-proxy/v1/models` 中该模型的 `pricing` 作为官方参考价。
9
+ 此时网关费用不计价,明细与完成回执保留空值;不使用参考端点的 `effective_pricing`,
10
+ 也不把官方费用当作网关费用。参考价按小时缓存;不可用且无成功缓存或找不到该模型时,费用保留未知。
11
+
7
12
  ## 查看今日概览
8
13
 
9
14
  ```bash
@@ -1,5 +1,27 @@
1
1
  # ec storage — 文件存储
2
2
 
3
+ ## 定向私有分享
4
+
5
+ `ec storage share <aid> --input-file FILE [--format json]` 使用 JSON 的 action 创建、查询或撤销分享。托管调用仅允许当前任务 Agent 自身 AID,并复用其真实连接;不借用 Owner、Host 或其他 Agent 身份。
6
+
7
+ ```json
8
+ {"action":"create","requestId":"share-001","path":"/templates/writer/writer-1.0.0.ectpl","allowedAids":["target-host.agentid.cn"],"expireInSeconds":259200,"maxUses":0}
9
+ ```
10
+
11
+ create 必填 requestId/path/非空 allowedAids;不接受 `*`。expireInSeconds 默认259200(72小时),0为不过期;显式期限优先,已有分享不因默认值变更而延长;maxUses默认0不限。list 输入 `{action:"list",path:"/完整对象路径"}`;revoke 输入 `{action:"revoke",requestId:"撤销请求ID",shareId:"十位短码"}`;status 输入 `{action:"status",requestId:"原请求ID"}`。以上简写在实际 JSON 中须为键加双引号。
12
+
13
+ 返回 state=succeeded 才表示已核实完成,create 的 result 带真实 share_id。通信失败或进程退出后的未知写操作保留原 requestId,不重放创建/撤销;status 查询持久回执,create 结果未知时辅助查询同对象分享候选,不能把候选误报为原请求成功。需要时结合 list 处理。未知结果退出码3,不能继续声称分享已完成。给人分享安装模板时,授权必须覆盖其实际安装 Host。
14
+
15
+ 给接收方及其动态 Host 下载模板时,分为两项独立授权:create 的 allowedAids 填接收方 AID;再通过通用 `ec fs setfacl` 给该接收方的直接 sub 中、可信名片 `type=host` 的 AID 授予文件只读权限。
16
+
17
+ ```bash
18
+ ec fs setfacl sender.agentid.cn:/templates/writer/writer-1.0.0.ectpl -m '{"subject":{"ownership":{"owner_aid":"recipient.agentid.cn","scope":"direct"},"card":{"type":["host"]}},"perms":"r","max_uses":0}' --expires '<与接收方分享对齐的到期Unix秒>' --format json
19
+ ```
20
+
21
+ 通用 ACL 的 JSON 参数、回执及撤销见 [文件系统](fs.md)。Storage 动态检查 Owner 声明及可信名片,不枚举静态主机列表。短码和 ACL 分别核实、分别撤销;同对象同接收方的条件 ACL 由多张卡片共享。托管操作继续使用当前任务 Agent 身份。
22
+
23
+ Host 需要独立的文件读取授权,不能直接使用仅授权接收 Agent 的短码。Host 使用条件 ACL 下载时按 location 读取,不带仅授权接收方的短码;指定 Host 的原 allowedAids 分享方式仍保留。v2 `agent.template.share` 卡片发送流程见内置 agent-template-project 技能。
24
+
3
25
  AUN 网络上的文件存储:上传、下载、列举、删除、查配额。触发词:上传/下载/存文件/配额。
4
26
 
5
27
  以自己的 AID 为操作者(`<aid>`)。
@@ -90,6 +90,8 @@ ec thread create <peer> --name '项目A' --status active
90
90
 
91
91
  创建成功后返回 `threadId`,格式为 `thread-<ms>-<seq4>-<rand4>`(如 `thread-1791028341906-0000-136a`)。创建时会自动向对端发一条系统消息通知。
92
92
 
93
+ `<peer>` 不能是本端自己的 AID(含大小写差异与 `@` 前缀),否则报 `SELF_PEER_NOT_ALLOWED`。话题是两端结构,对端写成本端会得到「我↔我」的残缺话题:消息投得进去,但实际没有接收方。要给自己派活,请先以真实对端建话题,再用 `ecmsg send --thread <该话题> --selfmode`。
94
+
93
95
  ### 修改话题
94
96
 
95
97
  ```bash
@@ -140,39 +142,44 @@ ec thread delete <threadId> # 软删除:session 文件移入 _trash/,索
140
142
  | 跨话题委托 | 本端从另一个话题委托给该话题的对端;对方回复后回流 |
141
143
  | 跨话题自派 | 本端从另一个话题把任务派给自己 |
142
144
 
143
- 跨话题**发送**有两个动作:
145
+ 跨话题**发送**有两个动作(接收方由「话题 + 模式」推出,不使用 `--to`):
144
146
 
145
147
  | 形态 | 写法 | 目标 | 用途 |
146
148
  |---|---|---|---|
147
149
  | 跨话题委托 | `ecmsg send '<text>' --thread <话题id>` | 该话题的对端 | 把任务交给另一个话题里的对端推进 |
148
- | 跨话题自派 | `ecmsg send '<text>' --thread <话题id> --to <本端AID>` | 该话题下的本端自己 | 对端是人、不会自己推进时,由本端自己接手 |
150
+ | 跨话题自派 | `ecmsg send '<text>' --thread <话题id> --selfmode` | 该话题下的本端自己 | 对端是人、不会自己推进时,由本端自己接手 |
149
151
 
150
152
  不带 `--thread` 的 `ecmsg send '<text>'` 是普通回复,只发当前会话对端/群。
151
153
 
152
154
  跨话题自派的派活通知按话题对端类型送达:对端是人类时发普通 text,对端是 agent 时发 notice(`subtype=self_dispatch`),避免被当成一条要执行的聊天消息。
153
155
 
154
156
  ```bash
155
- # 跨话题委托(本端/对端由话题推断)
157
+ # 跨话题委托(本端/对端由话题推断);省略 --check-every 时默认 20m
156
158
  ecmsg send '<消息内容>' --thread <threadId>
157
159
 
158
- # 自定义复查周期(缺省 20m)
160
+ # 自定义复查周期
159
161
  ecmsg send '<消息内容>' --thread <threadId> --check-every 30m
160
162
 
163
+ # 收尾汇报:跨话题但不建复查(只写 thread-inbox)
164
+ ecmsg send '<消息内容>' --thread <threadId> --check-every none
165
+
161
166
  # 跨话题自派(投给该话题下的本端自己)
162
- ecmsg send '<消息内容>' --thread <threadId> --to <本端AID>
167
+ ecmsg send '<消息内容>' --thread <threadId> --selfmode
163
168
  ```
164
169
 
165
170
  注意事项:
166
171
 
167
- - `--thread` 必须是本端已存在的话题:独立话题查索引,主话题(`main:<selfAid>:<peerAid>`)查该关系的 active session。都不存在时返回 `TOPIC_NOT_FOUND`
172
+ - `--thread` 不能是当前话题;当前话题消息直接省略它(否则报 `TOPIC_IS_CURRENT`)
173
+ - 独立话题必须已存在于本端索引;主话题(`main:<selfAid>:<peerAid>`)由两端 AID 直接拼出,目标会话尚未建立时按首次联系处理,会话随首条消息建立
168
174
  - `--thread` 只接受 `thread-…` 与 `main:<aidA>:<aidB>` 两种形态;裸对端 AID 不是话题 id
169
175
  - **主话题可以作为跨话题发送的目标**。例如:
170
176
  ```bash
171
177
  # A 向 B 的主会话发送消息(从 A 的某个话题跨过去)
172
- ecmsg send '请在主会话查看这个报告' --thread 'main:bob.aid:alice.aid'
178
+ ecmsg send '请在主会话查看这个报告' --thread 'main:bob.agentid.cn:alice.agentid.cn'
173
179
  ```
174
- 主话题的 ID 可以从 `ec thread list <peer>` 的输出中获取(第一行就是主话题)
175
- - **跨话题自动创建复查**,缺省 20m;只有要改周期时才写 `--check-every`(`5m` / `30m` / `2h` / `1d`)
180
+ 主话题的 ID 可以从 `ec thread list <peer>` 的输出中获取(第一行就是主话题),
181
+ 也可以按 `main:<本端AID>:<对方AID>` 直接拼出;还没聊过的对象也能用主话题首次联系。
182
+ - **跨话题委托自动创建复查**,缺省 20m;只有要改周期时才写 `--check-every`(`5m` / `30m` / `2h` / `1d`);`none` 表示只写 thread-inbox、不建复查(收尾场景)。首次联系不建复查;自派不建复查,也不能与 `--check-every` 同用
176
183
  - 跨话题发送成功后,系统会在**本端**写一条 thread-inbox 记录。目标话题下次被唤醒时,
177
184
  这条记录会以「‹提醒:跨话题委托 · 话题:xxx …›」的形式注入一次,然后删除
178
185
  - `--check-every` 会创建**跨话题复查**(名称 `check-<目标>-from-<来源>-<唯一后缀>`,
@@ -237,6 +244,10 @@ Trigger:trig_1792369122624_aa1c9068
237
244
  摘要用于跨会话保留话题的核心信息,在下次激活或委托时快速恢复上下文。
238
245
  daemon 不自动总结,需要 agent 主动写入。
239
246
 
247
+ 更新时先合并旧摘要仍有效的目标、关键结果与待办/阻塞,不要只留下最后一轮操作。
248
+ 主动更新的 3 轮冷却和语义判重由提示词约束,不调用 embedding 或额外模型;具体规则见 thread fragment 与 thread-ops 技能。
249
+ 服务端只做精确去重:正文和覆盖游标都相同时返回 `updated: false`,不追加版本、不改变更新时间;任一变化仍写入。`--if-rev` 校验先于去重,改名仍独立执行。
250
+
240
251
  ```bash
241
252
  # 查看当前摘要(同时打印 coveredThroughTs 覆盖游标)
242
253
  ec thread summary show <threadId>
@@ -126,6 +126,10 @@ trusted fullaccess
126
126
 
127
127
  `bypass` 只免去符合策略的交互审批。单独要求管理者审批的操作,仍按该操作的审批范围处理,不能笼统理解成“危险操作全部免审”。
128
128
 
129
+ 管理审批需要跨会话转交时,只向目标 Agent 当前协议 Owner 的 AUN 私聊发送一张审批卡,不选择 admin。
130
+ 没有可用 Owner 或审批渠道时拒绝操作,不回退给 admin。审批响应和临时授权复用都会重新校验
131
+ Owner 资格;原 Owner 降为 admin 后,该审批及其临时授权失效。符合条件的原会话内管理审批仍可由 admin 处理。
132
+
129
133
  临时批准不是给工具发一张永久通行证:
130
134
 
131
135
  ```text
@@ -261,6 +265,16 @@ DaemonOwner 管理请求
261
265
 
262
266
  ## 三、查实现时从哪里开始
263
267
 
268
+ ### Windows Shell 签名校验
269
+
270
+ EC 特权路径先识别实际 EC 调用,再校验其 Windows Shell carrier 的可执行文件。
271
+ 普通 `Get-Content` 等 Shell 命令继续走原有文件路径策略和审批流程,不因 EC 专用签名检查失败而拒绝。
272
+ 命令参数中作为文字出现的 `ec` 不构成 EC 调用;携带托管会话凭据的 PowerShell 前缀仍受校验。
273
+
274
+ EC carrier 校验失败继续拒绝,错误保留具体环节及可执行文件路径,例如文件无法访问、
275
+ 校验程序启动/执行失败、超时、结果无法解析、签名无效或发布者不受信任。
276
+ daemon 日志同时保留原始错误码、退出码、签名状态及探测输出等适用诊断;缓存命中保留原始失败原因。
277
+
264
278
  ### Shell 查询的路径判定
265
279
 
266
280
  `readonly-shell-query` 是共享查询分析器,H/L 类路径预检在 `readonly`、`auto`、`request`、
@@ -48,7 +48,20 @@ ec trigger history [triggerId]
48
48
  ec trigger history [triggerId] --limit 500 --json
49
49
  ```
50
50
 
51
- `list` 默认只显示 enabled trigger。排查历史、禁用项或已达到 limits 的 trigger 时加 `--all`。
51
+ `list` **默认列出全部定义的 trigger:已启用和已关闭都在结果里**,每行以 `on` / `off` 标明状态。
52
+ 只想看真正会触发的,加 `--enabled-only`。
53
+
54
+ 已删除的 trigger 不会出现:`delete` 会把整个运行态目录删掉,`list` 读不到;要追溯只能查 `history`(保留 tombstone)。
55
+
56
+ ```bash
57
+ ec trigger list # 开 + 关,每行带 on/off
58
+ ec trigger list --enabled-only # 只看已启用
59
+ ```
60
+
61
+ 斜杠命令 `/trigger`(无参数)与 `/trigger list` 同样是「开 + 关」的全量视图,`/trigger list --enabled-only` 只看已启用。
62
+ Menu 侧 `trigger list` 默认同义,传 `options: "enabled"` 或 `enabledOnly: true` 时只返回已启用项。
63
+
64
+ > `--all` 已退化为兼容项:行为与默认完全相同,不再出现在 help 与文档中,也没有其它含义。
52
65
 
53
66
  `list --json` 返回列表摘要,不返回完整 definition。每项只包含 `id/name/enabled/description`、精简后的 `source`、`execution.type`、`feedback.strategy/target`、`nextFireAt`、最近运行状态和 `updatedAt`。event source 只返回 `eventPattern`,不返回 `filter`;不会返回 prompt/script 参数、model、effort、permissionMode、反馈分支模板、reliability、limits 或 origin。
54
67
 
@@ -81,9 +94,29 @@ ec trigger create \
81
94
  --target-session main \
82
95
  --model <model> --effort high \
83
96
  --name daily-summary \
84
- --enable
97
+ --enabled true
85
98
  ```
86
99
 
100
+ `--enabled <true|false>` 决定新建 trigger 的初始启停状态,**默认 `true`(建好即启用)**。
101
+ 需要「建好但先不开」时传 `--enabled false`,回执会标为 `[disabled]` 并给出启用命令。
102
+ CLI、斜杠 `/trigger create`、Menu `menu.action trigger create` 三条入口共用同一归一逻辑,
103
+ 默认值与取值校验完全一致。
104
+
105
+ 创建回执始终带当前启停状态:
106
+
107
+ ```text
108
+ $ ec trigger create ... --name daily-summary
109
+ ✓ created trig_1760000000_ab12cd34 (daily-summary) [enabled]
110
+
111
+ $ ec trigger create ... --name wake-up --enabled false
112
+ ✓ created trig_1760000000_ef56ab78 (wake-up) [disabled]
113
+ 启用:ec trigger enable trig_1760000000_ef56ab78
114
+ ```
115
+
116
+ 斜杠命令创建后回执里的「状态」行同义:`状态:已启用`,或 `状态:已关闭(未启用,不会到点触发)` 并附 `/trigger enable <id>`。
117
+
118
+ `--enable` 保留为隐性兼容别名(等价 `--enabled true`),不再列入 help 与本文档,新写法一律使用 `--enabled`。
119
+
87
120
  CLI flag 模式必须显式指定 `--exec`、`--target-channel` 和 `--target-channel-id`,并生成 `feedback.strategy=target`。需要 `origin` 或 `silent` feedback 时,用 `/trigger` 或 `--exec <type> --file <trigger.json|trigger-dir>` 导入 Trigger V3 第二阶段 JSON;CLI 会校验 `--exec` 与 JSON 的 `execution.type` 一致。
88
121
 
89
122
  多行或复杂 prompt 使用 `--prompt-file <path>`,文件内容会原样作为 prompt(UTF-8 BOM 会移除)。内联 `--prompt` 最多 4096 个字符;超限时 CLI 会提示改用 `--prompt-file <path>`:
@@ -93,7 +126,7 @@ ec trigger create --cron '0 9 * * *' \
93
126
  --exec target-session \
94
127
  --prompt-file ./prompts/daily-summary.md \
95
128
  --target-channel <channelKey> --target-channel-id <channelId> \
96
- --name daily-summary --enable
129
+ --name daily-summary --enabled true
97
130
 
98
131
  ec trigger update <triggerId> --prompt-file ./prompts/daily-summary-v2.md
99
132
  ```
@@ -172,7 +205,8 @@ ECWeb 的 Trigger 编辑面板在限制设置中提供「单次执行总时限
172
205
  ```
173
206
 
174
207
  - 通知模板在触发时由 `renderTemplate` 渲染,可用 `{{run.number}}`(第几次)、
175
- `{{run.elapsed}}`(已过多久)、`{{trigger.labels.*}}` 等变量。
208
+ `{{run.elapsed}}`(已过多久)、`{{run.every}}`(当前周期,仅 interval)、`{{trigger.labels.*}}` 等变量。
209
+ `ec trigger update --every` 改周期后,正文里的 `{{run.every}}` 下次触发即按新值渲染。
176
210
  - 这类投递在消息上带 `triggerMeta.reviewKind = 'cross-thread-review'`,执行身份取
177
211
  **目标话题会话自身的对端**,而不是 `originPeerId`(来源话题的对端)。
178
212
  - 设计见 `docs/thread-chain/cross-thread-review-design.md`。
@@ -269,6 +303,48 @@ Agent 切换基座后,旧基座会话保留,新执行使用对应当前基
269
303
  ```
270
304
 
271
305
  owner/admin 通过 `/trigger create` 创建时默认使用 `bypass`;非 admin 默认 `readonly`,不能提权到 `bypass`,也不能跨渠道或跨会话指定 target。历史 `/trigger set` 仍是兼容别名。
306
+ <!-- eck:fullaccess-trigger -->
307
+ ### 提权到 `fullaccess`:临时提权工作流
308
+
309
+ 持久 Trigger 要宿主执行(例如脚本需要读 `$EVOLCORE_HOME` 里的 AID 身份库、或后台发布 Personal Assistant 面板卡片),必须把
310
+ `execution.permissionMode` 设为 `fullaccess`。Agent 直接改会被拒绝:
311
+
312
+ ```text
313
+ persistent fullaccess Trigger requires an explicit user or management-channel action
314
+ ```
315
+
316
+ 能设置 fullaccess 的只有两种来源:
317
+
318
+ 1. **调用方本身处于 fullaccess**:Owner 临时提权后,Agent 在窗口内创建/修改 Trigger。
319
+ 2. **DaemonOwner 从管理通道下发**(「/trigger」菜单、ECWeb 面板等)。
320
+
321
+ 推荐流程(最小暴露):
322
+
323
+ 1. Owner 临时开启 fullaccess(`/fa on` 或 Agent 级 `fullaccess.enabled`)。**权限范围是整个 Agent,不只是这一个 Trigger**,所以窗口要短。
324
+ 2. Agent 立刻把目标 Trigger 设成 fullaccess:`ec trigger update <id> --permission fullaccess`。此时批准人(`authorizedBy`)被记为下发审批的主体。
325
+ 3. Owner 立刻关闭 fullaccess。**Trigger 不会随之降级**:运行期只复核「批准人是否仍是当前 DaemonOwner」,不看我当前权限模式。
326
+ 4. 真要回收,删 Trigger 才算真回收(`ec trigger delete <id>`)。
327
+
328
+ 注意:Agent 级 `fullaccess.enabled` 开关不会自动提权已有 Trigger(那句「Trigger 不会因该开关自动提权」说的是这个意思);它提供的是**创建/修改** fullaccess Trigger 的资格。别把两者混为一谈,否则会误判为「只能等管理通道」。
329
+
330
+ ### 脚本触发器的两个硬约束
331
+
332
+ **契约**:`--exec script` 的 stdout 最后必须是 TriggerReply JSON,否则按 `script_reply_invalid` 失败:
333
+
334
+ ```json
335
+ {"outcome":"success|noop|error|interrupted|timeout","text":"给 Owner 看的摘要","files":[{"path":"绝对路径","name":"可选文件名"}]}
336
+ ```
337
+
338
+ `noop` 走静默分支;`files` 会作为附件随反馈投递。
339
+
340
+ **Windows 权限模式影响沙箱策略**:`--permission bypass` 时 EvolCore 把沙箱根路径判为可写,会尝试给 `C:\` 授予写 ACE,
341
+ 普通权限必然失败,最终 `SCRIPT_SANDBOX_UNAVAILABLE`。用 `--permission auto` 或 `request`(根路径只读)就不会碰到这个失败点。
342
+
343
+ **scoped 沙箱读不到密钥**:非 fullaccess 的脚本在受限沙箱里运行,实测 `$EVOLCORE_HOME/CA`、`$EVOLCORE_HOME/AIDs` 均返回
344
+ `EPERM`(`existsSync` 也为 false)。因此凡是需要 AID 证书+私钥换 token 的脚本(例如 nameservice 快照同步),
345
+ 只能走 fullaccess 宿主执行;不要试图在 scoped 脚本里做认证。
346
+
347
+
272
348
 
273
349
  ## 执行边界
274
350
 
@@ -373,8 +449,8 @@ logs/trigger-runs.log
373
449
  复杂 trigger 使用 Trigger V3 第二阶段 JSON:
374
450
 
375
451
  ```bash
376
- ec trigger create --exec target-session --file ./trigger.json --enable
377
- ec trigger create --exec script --file ./trigger-dir --enable
452
+ ec trigger create --exec target-session --file ./trigger.json --enabled true
453
+ ec trigger create --exec script --file ./trigger-dir --enabled true
378
454
  ```
379
455
 
380
456
  当前产品版本是 Trigger V3 第二阶段;其持久化定义版本为 `$schema_version: 3.1`。旧 `$schema_version: 4` 文件加载时会自动规范化为 `3.1`。
@@ -567,7 +643,7 @@ ec trigger create --event 'message:received' \
567
643
  --prompt '检查收到的消息是否需要自动跟进;无动作输出 [[NOOP]]' \
568
644
  --target-channel <channelKey> --target-channel-id <channelId> \
569
645
  --target-session main \
570
- --name on-message-received --enable
646
+ --name on-message-received --enabled true
571
647
  ```
572
648
 
573
649
  监听某个命名空间下的所有事件:
@@ -578,7 +654,7 @@ ec trigger create --event 'task:*' \
578
654
  --prompt '任务完成或失败后生成简短诊断;无动作输出 [[NOOP]]' \
579
655
  --target-channel <channelKey> --target-channel-id <channelId> \
580
656
  --target-session main \
581
- --name on-task-events --enable
657
+ --name on-task-events --enabled true
582
658
  ```
583
659
 
584
660
  需要根据事件 payload 过滤时,可在上述创建命令中加入 `--event-filter '{"match":{"sessionId":"meta-1"}}'`。过滤条件仅支持创建时配置,`update` 不接受 `--event-filter`。完整的 Trigger V3 第二阶段 JSON 也支持同样的过滤条件:
@@ -639,7 +715,7 @@ ec trigger create --delay 30m \
639
715
  --prompt '提醒用户检查部署状态' \
640
716
  --target-channel <channelKey> --target-channel-id <channelId> \
641
717
  --target-session main \
642
- --name deploy-reminder --enable
718
+ --name deploy-reminder --enabled true
643
719
  ```
644
720
 
645
721
  创建后立即执行一次:
@@ -650,7 +726,7 @@ ec trigger create --once \
650
726
  --prompt '生成一次当前状态摘要' \
651
727
  --target-channel <channelKey> --target-channel-id <channelId> \
652
728
  --target-session main \
653
- --name one-shot-summary --enable
729
+ --name one-shot-summary --enabled true
654
730
  ```
655
731
 
656
732
  每天巡检:
@@ -661,7 +737,7 @@ ec trigger create --cron '30 9 * * *' \
661
737
  --prompt '检查服务状态并汇报异常;无异常输出 [[NOOP]]' \
662
738
  --target-channel <channelKey> --target-channel-id <channelId> \
663
739
  --target-session main \
664
- --name daily-health-check --enable
740
+ --name daily-health-check --enabled true
665
741
  ```
666
742
 
667
743
  复用 trigger 会话做周期跟踪:
@@ -673,7 +749,7 @@ ec trigger create --every 4h \
673
749
  --prompt '继续跟踪升级状态并输出最新结论;无变化输出 [[NOOP]]' \
674
750
  --target-channel <channelKey> --target-channel-id <channelId> \
675
751
  --target-session main \
676
- --name upgrade-watch --enable
752
+ --name upgrade-watch --enabled true
677
753
  ```
678
754
 
679
755
  定时尝试升级,最多 10 次或 3 天:
@@ -687,7 +763,7 @@ ec trigger create --every 4h \
687
763
  --prompt '尝试执行升级检查;成功后调用 ec trigger disable auto-updater;无变化输出 [[NOOP]]' \
688
764
  --target-channel <channelKey> --target-channel-id <channelId> \
689
765
  --target-session main \
690
- --name auto-updater --enable
766
+ --name auto-updater --enabled true
691
767
  ```
692
768
 
693
769
  硬删除:
@@ -45,7 +45,7 @@
45
45
 
46
46
  ## EvolCore 单边约束(与协议无关)
47
47
 
48
- - `ec aid agentmd set` 可修改字段:`name` / `type` / `description` / `version` / `tags` / `exttype`
48
+ - `ec aid agentmd set` 可修改字段:`name` / `type` / `description` / `version` / `tags` / `exttype` / `visibility`。`visibility` 接受 `public`、`unlisted` 或 `private`。
49
49
  - 创建名片时默认值:`type=agent`、`description="EvolCore AI agent."`、`version="1.0.0"`
50
50
  - `human` 禁止 `owner`/`ownership`;`group`/`org` 必须带 `owner` + `entity_cert_fingerprint`
51
51
 
@@ -3,8 +3,9 @@
3
3
  飞书群通过 chat_id 标识,支持话题(thread)回复。
4
4
 
5
5
  ## 工具
6
- - 群消息命令:`ec group`(详见 $KITS_DOCS/evolcore/group.md)
7
- - 取群信息 / 公告 / 成员 / 管理员
6
+ - 群聊固定 proactive:普通输出不会投递到群里,发言一律用 `ecmsg send '<正文>'`(详见 $KITS_DOCS/channels/feishu.md)
7
+ - `ecmsg send` 在飞书群里只支持发往本群的纯文本,不支持 `--file`、`--mention`、`--thread`
8
+ - 没有查询群信息、公告、成员、管理员的命令;`ec group` 只适用于 AUN 群
8
9
 
9
10
  ## 注意
10
11
  - 飞书群默认 dispatch=mention,被 @ 才响应
@@ -3,7 +3,8 @@
3
3
  飞书单聊场景下,对端通过 user_id (open_id) 标识。
4
4
 
5
5
  ## 工具
6
- - 飞书消息命令:`ec msg`(详见 $KITS_DOCS/evolcore/msg.md)
7
- - 文件/图片上传与发送
6
+ - 回复:interactive 下普通输出由 evolcore 自动投递;proactive 下用 `ecmsg send '<正文>'`(详见 $KITS_DOCS/channels/feishu.md)
7
+ - `ecmsg send` 在飞书会话里只支持发给当前对端的纯文本
8
+ - 文件/图片:仅 interactive 下可用,语法见 `[channel]` 段的 `[SEND_FILE:文件路径]`
8
9
 
9
10
  (待补充)
@@ -56,16 +56,9 @@ agent 通过 AID 发现网关:`GET https://{aid}/.well-known/aun-gateway`,
56
56
 
57
57
  ### 核心服务
58
58
 
59
- | 命名空间 | 作用 |
60
- | --- | --- |
61
- | auth.* | AID 注册、认证、token 管理 |
62
- | message.* | 点对点消息、离线队列 |
63
- | group.* | 群组生命周期、群消息 |
64
- | storage.* | 文件上传下载 |
65
- | stream.* | 实时流 |
66
- | meta.* | 健康检查、状态查询 |
67
-
68
- 完整协议文档(含 mail/search/relay/ca/peer/task 等):Read `$AUN_PROTOCOL_DOCS`。
59
+ 网关按命名空间路由:`auth.*`(注册/认证/token)、`message.*`(点对点消息、离线队列)、
60
+ `group.*`(群生命周期)、`storage.*`(文件)、`stream.*`(实时流)、`meta.*`(健康检查)。
61
+ 完整协议(含 mail/search/relay/ca/peer/task 等):Read `$AUN_PROTOCOL_DOCS`。
69
62
 
70
63
  ### 自主模式
71
64
 
@@ -124,32 +117,18 @@ ECK(EvolCore Context Kit)是 EvolCore 的上下文组装系统。你正在
124
117
 
125
118
  ### 上下文组装流程
126
119
 
127
- evolcore 收到每条消息时,由**声明式 manifest** 决定加载哪些上下文段——不是写死的分支。
128
- 每个 section 带 `when` 条件,evolcore 按当前会话构造一组运行时变量(`chatType`、`channel`、
129
- `selfAid`、`peerKey` 等)逐段求值,命中的才按顺序拼进 system prompt(`needsInjection` 的段还会先做模板渲染)。
120
+ evolcore 收到每条消息时,由**声明式 manifest** 决定加载哪些上下文段——不是写死的分支。
121
+ 每个 section 带 `when` 条件,按当前会话构造的运行时变量(`chatType`、`channel`、`selfAid`、`peerKey` 等)
122
+ 逐段求值,命中的才拼进 system prompt。
130
123
 
131
- 按场景,命中的段大致是:
132
-
133
- | 场景 | 命中的层/段 |
134
- | --- | --- |
135
- | coding(无渠道) | active 时为 rules + 会话层 + baseagent(身份/关系/环境/渠道层因无 channel、无身份而落选) |
136
- | private(私聊) | rules + 身份层(含 soul)+ 关系层(对端)+ 环境层 + 渠道层 + 会话层 + baseagent |
137
- | group(群聊) | rules + 身份层(含 soul)+ 关系层(群)+ 环境层 + 渠道层 + 会话层 + baseagent |
138
- | bootstrapping | bootstrap 引导 + 有渠道时的共用回复规则 [reply](含最小身份、目标、chatMode);不加载 rules、完整身份/关系/环境/渠道能力、会话、baseagent 或 commands 段 |
124
+ **你当前看到的 system prompt 就是求值结果**,不需要先推导命中规则再判断自己有什么能力。
125
+ 想知道"某个场景会命中哪些段"、section 字段、when 语义、合并覆盖、模板渲染与 `debug.eckSnapshots`
126
+ 调试输出,Read `$KITS_DOCS/context-assembly.md`(该文档含完整默认 manifest 段清单)。
139
127
 
140
- > 共用 `reply-contract` 在有渠道且 `lifecycle∈{active,bootstrapping}` 时加载;其余常规段(包括 rules、session、baseagent)都要求 `lifecycle=active`。生命周期缺失按 `active` 处理;非法时,
141
- > Manifest 不加载任何常规段;agent-owned turn 也不会直接落入普通 runner。
142
-
143
- 三份 manifest 各管一段:`kits/eck_manifest.json`(system prompt 默认)、
144
- `kits/eck_manifest.auxiliary.json`(备用,可由 `config.sessionManifests` 指定)、
128
+ 三份 manifest 各管一段:`kits/eck_manifest.json`(system prompt 默认)、
129
+ `kits/eck_manifest.auxiliary.json`(备用,可由 `config.sessionManifests` 指定)、
145
130
  `kits/eck_message_manifest.json`(逐条消息渲染)。
146
131
 
147
- manifest schema、when 条件、合并覆盖、模板渲染、运行时变量目录详见 `$KITS_DOCS/context-assembly.md`。
148
-
149
- **实际渲染结果的调试输出**默认**关闭**,要在进程级配置里打开 `debug.eckSnapshots: true` 才会写;
150
- 开启后落 `$EVOLCORE_HOME/data/eck-debug/`,文件名带时间戳:`vars-<ts>.json`、`context-<ts>.md`、
151
- `fragments-<ts>.md`、`manifest-<ts>.md`(逐条消息渲染另有 `msg-render-<ts>.md`),保留 24 小时。
152
-
153
132
  ## 命令行的引号写法
154
133
 
155
134
  `ec` 命令里的自由文本参数(消息正文、`--desc`、`--prompt`、`--name`、`--question`、