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
@@ -5,25 +5,28 @@
5
5
  * 应答(*.result)完全不经过这里——那是 AunRequestRegistry 的事,在消息层更早分支。
6
6
  */
7
7
  import path from 'node:path';
8
+ import { agentProjectChangeGate } from '../config-store.js';
8
9
  import { logger } from '../utils/logger.js';
9
10
  import { matchFilter } from '../trigger/event-source.js';
10
11
  import { ServiceDispatcher } from './dispatcher.js';
12
+ import { ServiceHostRuntime } from './host-runtime.js';
11
13
  import { IdempotencyStore } from './idempotency.js';
12
14
  import { readLocalSelfIdentity } from './identity.js';
13
15
  import { writeServicesIndex } from './index-generator.js';
14
- import { servicePackLedger as packLedger, routerLedger, ServiceLedger } from '../core/pack-ledger.js';
16
+ import { servicePackLedger as packLedger, routerLedger, ServiceLedger } from '../core/pack/pack-ledger.js';
15
17
  import { scheduleServicesAclHarden } from '../core/permission/services-path-acl.js';
16
18
  import { ServiceMessageLog } from './message-log.js';
17
19
  import { buildPackState, loadPackDir, loadPacks } from './pack-manager.js';
18
- import { DEFAULT_ROUTER_CONFIG, loadRouterConfig, RateLimiter } from './router.js';
19
- import { RateWindow } from '../core/rate-window.js';
20
+ import { DEFAULT_ROUTER_CONFIG, loadRouterConfig, RateLimiter, RateWindow } from './router.js';
20
21
  import { ServiceScriptRunner } from './script-runner.js';
21
22
  import { buildErrorReply, buildSilentReply, buildSuccessReply, replyFromOutcome, isReservedServiceType, matchesListen, RESERVED_TYPES, } from './service-payload.js';
22
23
  import { errorMessage } from './types.js';
24
+ import { DEFAULT_HANDLER_TIMEOUT_MS } from './validation.js';
23
25
  import { isOutputType } from '../outputs/protocol.js';
24
26
  import { outputRequestSchema, outputResponseSchema } from '../outputs/protocol.js';
25
27
  import { OutputService } from '../outputs/service.js';
26
28
  import { isOutputCardsType, outputCardsRequestSchema, outputCardsResponseSchema, OutputCardsService, OUTPUT_CARDS_TYPES } from '../outputs/cards.js';
29
+ import { isPanelCardsType, panelCardsRequestSchema, panelCardsResponseSchema, PanelCardsService, PANEL_CARDS_TYPES, panelCardsCatalog } from '../outputs/panel-cards.js';
27
30
  import { DataRootError } from '../core/command/team-workspace-store.js';
28
31
  import { isWorkbenchType, WORKBENCH_TYPES, workbenchRequestSchema, workbenchResponseSchema } from '../workbench/protocol.js';
29
32
  import { WorkbenchService } from '../workbench/service.js';
@@ -47,6 +50,28 @@ const UNAUTHORIZED_NOTICE_MAX = 10_000;
47
50
  * 但拿不到包名、服务 type、reply 策略这些内部结构。
48
51
  */
49
52
  const UNAUTHORIZED_MINIMAL_BUILTIN = ['services.ping'];
53
+ /**
54
+ * 调度层拒收码:脚本**一秒都没执行**。
55
+ *
56
+ * 三个后果必须一致处理,漏一个就会把偶发故障放大成持续故障:
57
+ *
58
+ * 1. 不进 `handled` 日志(那是"脚本跑完了"的记录);
59
+ * 2. 进 `service.rejected` 台账(运维要看得出是调度层挡的);
60
+ * 3. **不进包内幂等缓存**——否则调用方 15 秒内重试会拿到缓存下来的失败。
61
+ *
62
+ * `SERVICES_HOST_*` 属于这一类:宿主启动中 / 重启中 / 降级 / 协议破坏,
63
+ * 被调用的脚本根本没被拉起。
64
+ */
65
+ const SCHEDULER_REJECTION_CODES = new Set([
66
+ 'SERVICE_DEADLINE_EXCEEDED',
67
+ 'QUEUE_FULL',
68
+ 'DISPATCHER_CLOSED',
69
+ 'SERVICES_HOST_STARTING',
70
+ 'SERVICES_HOST_RESTARTING',
71
+ 'SERVICES_HOST_UNAVAILABLE',
72
+ 'SERVICES_HOST_PROTOCOL',
73
+ ]);
74
+ const templateMutationHolds = new Map();
50
75
  export class ServiceRouter {
51
76
  servicesDir;
52
77
  deps;
@@ -64,9 +89,25 @@ export class ServiceRouter {
64
89
  /** fromAid → 上次告知未准入的时间;窗口内重复调用静默。 */
65
90
  unauthorizedNotified = new Map();
66
91
  started = false;
92
+ activeRequests = 0;
93
+ mutationHolds = new Set();
94
+ pauseForMutation(token) {
95
+ if (this.activeRequests)
96
+ throw Object.assign(new Error('Agent service requests are active'), { code: 'AGENT_BUSY' });
97
+ this.mutationHolds.add(token);
98
+ return () => { this.mutationHolds.delete(token); };
99
+ }
100
+ assertMutationIdle() {
101
+ if (this.activeRequests || this.hostRuntime?.running) {
102
+ throw Object.assign(new Error('Agent service requests or service host are active'), { code: 'AGENT_BUSY' });
103
+ }
104
+ }
67
105
  outputService;
68
106
  outputCardsService;
107
+ panelCardsService;
69
108
  workbenchService;
109
+ /** 常驻宿主运行时(总闸打开且被调用时才真正启动进程)。 */
110
+ hostRuntime;
70
111
  constructor(servicesDir, deps, limits,
71
112
  /**
72
113
  * 只读快照模式:不写索引、不写台账。
@@ -85,8 +126,43 @@ export class ServiceRouter {
85
126
  this.dispatcher = new ServiceDispatcher(this.scriptRunner, limits);
86
127
  this.outputService = deps.outputService ?? new OutputService(deps.aid);
87
128
  this.outputCardsService = new OutputCardsService(deps.aid);
129
+ this.panelCardsService = deps.panelCardsService ?? new PanelCardsService(deps.aid);
88
130
  this.workbenchService = deps.workbenchService ?? new WorkbenchService(deps.aid, { offline: readonlySnapshot });
89
131
  }
132
+ /**
133
+ * 按总闸决定是否把宿主运行时挂到 runner 上。
134
+ *
135
+ * 挂载语义是「下一次调用走宿主」,本次不启动进程——懒启动由宿主运行时自己保证。
136
+ * 关闸时把引用摘掉即可:已起的宿主由 `close()` 收掉,不在这里杀(可能有在途调用)。
137
+ */
138
+ syncHostRuntime() {
139
+ const enabled = this.config.host?.enabled === true;
140
+ if (!enabled) {
141
+ this.scriptRunner.setHostRuntime(undefined);
142
+ // 摘引用之后宿主进程还活着,要等 1 小时空闲回收。关闸是显式运维动作,
143
+ // 结果应该是「现在就没了」——空闲时立刻收掉;有在途调用时保留进程,
144
+ // 交给调用结束后正常的空闲回收(不强杀在途调用)。
145
+ void this.hostRuntime?.retireIfIdle().catch(error => {
146
+ logger.warn(`[Services] host retire after disable failed: ${errorMessage(error)}`);
147
+ });
148
+ return;
149
+ }
150
+ if (this.hostRuntime) {
151
+ this.hostRuntime.cancelRetirement();
152
+ this.scriptRunner.setHostRuntime(this.hostRuntime);
153
+ return;
154
+ }
155
+ this.hostRuntime = new ServiceHostRuntime({
156
+ aid: this.deps.aid,
157
+ identity: () => this.identity,
158
+ getProjectPath: this.deps.getProjectPath,
159
+ // 缺省时返回 undefined,由宿主运行时在启动阶段明确拒绝(不静默降级)。
160
+ getRuntimeRoot: this.deps.getRuntimeRoot ?? (() => undefined),
161
+ ...(this.deps.permissionMode ? { permissionMode: this.deps.permissionMode } : {}),
162
+ ...(this.deps.onHostLog ? { onHostLog: this.deps.onHostLog } : {}),
163
+ });
164
+ this.scriptRunner.setHostRuntime(this.hostRuntime);
165
+ }
90
166
  /** 首次加载:读 services-config.json + 扫描包。identity 必须已就绪。重复调用只更新 identity。 */
91
167
  ensureStarted(identity) {
92
168
  this.identity = identity;
@@ -109,11 +185,17 @@ export class ServiceRouter {
109
185
  this.config = router.config;
110
186
  this.routerErrors = router.errors;
111
187
  this.limiter.setConfig(router.config);
188
+ // 总闸变化要立刻反映到执行路径上:打开 → 下次调用懒启动宿主;
189
+ // 关闭 → 后续调用退回一次性路径(已起的宿主在 close 时收掉)。
190
+ this.syncHostRuntime();
112
191
  // 顺带清理过期窗口:reload 是低频动作,够用了,不值得为此单开一个定时器。
113
192
  this.limiter.prune();
114
193
  this.unauthorizedWindow.prune();
115
194
  const loaded = loadPacks(this.servicesDir);
116
195
  this.packs = buildPackState(loaded.valid, loaded.invalid.map(item => ({ id: item.packId, errors: item.errors })), this.identity);
196
+ // 热重载:已运行的宿主若与当前代码不一致,请求滚动重启(走空闲窗口,不打断调用)。
197
+ // 必须在包集合更新之后、且用新集合判——否则"改了代码"这个判断拿到的是旧快照。
198
+ this.hostRuntime?.reconcile(this.packs.activePacks.map(pack => ({ id: pack.id, revision: pack.revision })));
117
199
  // 索引与包集合同步重建;空集删除,交给 manifest 的 optional 判缺失。
118
200
  // 只读快照不写:查询命令不该改变磁盘状态。
119
201
  if (!this.readonlySnapshot) {
@@ -216,6 +298,22 @@ export class ServiceRouter {
216
298
  * 调用方必须已判定 `classifyServicePayloadType(type) === 'request'`。
217
299
  */
218
300
  async handleRequest(message, options = {}) {
301
+ if (this.mutationHolds.size || agentProjectChangeGate(this.deps.aid))
302
+ return options.admission === 'blocked' ? buildSilentReply(message.type, message.requestId)
303
+ : buildErrorReply(message.type, message.requestId, 'AGENT_BUSY', 'Agent project migration is in progress');
304
+ if (templateMutationHolds.get(this.deps.aid)?.size) {
305
+ return options.admission === 'blocked' ? buildSilentReply(message.type, message.requestId)
306
+ : buildErrorReply(message.type, message.requestId, 'AGENT_BUSY', 'Agent template collection is in progress');
307
+ }
308
+ this.activeRequests++;
309
+ try {
310
+ return await this.handleUnpausedRequest(message, options);
311
+ }
312
+ finally {
313
+ this.activeRequests--;
314
+ }
315
+ }
316
+ async handleUnpausedRequest(message, options) {
219
317
  const type = message.type;
220
318
  if (!this.config.enabled) {
221
319
  logger.debug(`[Services] router disabled; dropped ${type} mid=${message.messageId}`);
@@ -226,25 +324,37 @@ export class ServiceRouter {
226
324
  this.rejectLedger('BLOCKED', type, message);
227
325
  return buildSilentReply(type, message.requestId);
228
326
  }
229
- if (isOutputType(type) || isOutputCardsType(type) || isWorkbenchType(type)) {
230
- if (options.admission === 'not_authorized')
327
+ const panelCards = isPanelCardsType(type);
328
+ if (isOutputType(type) || isOutputCardsType(type) || panelCards || isWorkbenchType(type)) {
329
+ const lacksContactAdmission = options.admission === 'not_authorized';
330
+ // Panel cards have their own protocol Owner gate. The contacts cache
331
+ // may lag a verified Owner or legitimately omit that relationship.
332
+ if (lacksContactAdmission && !panelCards)
231
333
  return this.unauthorizedReply(type, message, 'business');
232
334
  const rule = this.callRuleFor(type);
233
335
  if (rule?.deny.includes(message.fromAid))
234
336
  return this.unauthorizedReply(type, message, 'business');
235
337
  const limit = this.limiter.consume('service', message.fromAid);
236
338
  if (!limit.allow)
237
- return buildErrorReply(type, message.requestId, 'RATE_LIMITED', 'Output query rate exceeded');
339
+ return lacksContactAdmission
340
+ ? this.unauthorizedReply(type, message, 'business')
341
+ : buildErrorReply(type, message.requestId, 'RATE_LIMITED', 'Output query rate exceeded');
238
342
  try {
239
343
  const data = isWorkbenchType(type)
240
344
  ? await this.workbenchService.handle(message)
241
- : isOutputCardsType(type)
242
- ? await this.outputCardsService.handle(message)
243
- : await this.outputService.handle(message);
345
+ : panelCards
346
+ ? await this.panelCardsService.handle(message)
347
+ : isOutputCardsType(type)
348
+ ? await this.outputCardsService.handle(message)
349
+ : await this.outputService.handle(message);
244
350
  return buildSuccessReply(type, message.requestId, data);
245
351
  }
246
352
  catch (error) {
247
353
  if (error instanceof DataRootError) {
354
+ if (panelCards && lacksContactAdmission &&
355
+ ['OUTPUT_FORBIDDEN', 'PANEL_CARDS_FORBIDDEN'].includes(error.code)) {
356
+ return this.unauthorizedReply(type, message, 'business');
357
+ }
248
358
  return buildErrorReply(type, message.requestId, error.code, error.message, error.data);
249
359
  }
250
360
  return buildErrorReply(type, message.requestId, isWorkbenchType(type) ? 'WORKBENCH_UNAVAILABLE' : 'OUTPUT_UNAVAILABLE', errorMessage(error));
@@ -303,7 +413,7 @@ export class ServiceRouter {
303
413
  return buildErrorReply(type, message.requestId, 'REQUEST_IN_FLIGHT', 'the same request_id is still being processed');
304
414
  }
305
415
  try {
306
- return await this.executeMatched(pack, handler, type, message, store);
416
+ return await this.executeMatched(pack, handler, type, message, store, options);
307
417
  }
308
418
  finally {
309
419
  store.release(message.fromAid, message.requestId);
@@ -350,7 +460,7 @@ export class ServiceRouter {
350
460
  return { services: [], builtin: [...UNAUTHORIZED_MINIMAL_BUILTIN] };
351
461
  }
352
462
  /** 已通过准入与幂等检查之后的主路径。拆出来只是为了给 reserve/release 留一个 finally。 */
353
- async executeMatched(pack, handler, type, message, store) {
463
+ async executeMatched(pack, handler, type, message, store, options = {}) {
354
464
  const limit = this.limiter.consume('service', message.fromAid);
355
465
  if (!limit.allow) {
356
466
  packLedger(pack).append({ action: 'service.rejected', packId: pack.id, type, from: message.fromAid, requestId: message.requestId, code: 'RATE_LIMITED' });
@@ -366,10 +476,14 @@ export class ServiceRouter {
366
476
  return buildSilentReply(type, message.requestId);
367
477
  }
368
478
  packLedger(pack).append({ action: 'service.invoked', packId: pack.id, type, from: message.fromAid, requestId: message.requestId });
369
- const outcome = await this.dispatcher.run(pack, handler.handler, message);
370
- // 没跑起来 ≠ 脚本失败:`QUEUE_FULL` / `DISPATCHER_CLOSED` 是调度层拒收,脚本一秒都没执行。
479
+ const outcome = await this.dispatcher.run(pack, handler.handler, message, options.simulateRole ? { peerRole: options.simulateRole } : undefined);
480
+ // 没跑起来 ≠ 脚本失败:调度层拒收时脚本一秒都没执行。
371
481
  // 混进 `handled` 会让"这个服务为什么老是 error"指向错误的方向。
372
- const notRun = outcome.error?.code === 'QUEUE_FULL' || outcome.error?.code === 'DISPATCHER_CLOSED';
482
+ //
483
+ // `SERVICES_HOST_*` 与 `QUEUE_FULL` 同类:宿主正在启动/重启/降级/协议破坏,
484
+ // **脚本根本没被拉起**。这类失败还不能进幂等缓存(见下方 `record` 的条件)——
485
+ // 记进去的话调用方 15 秒内重试会拿到缓存的失败,把一次偶发重启放大成持续故障。
486
+ const notRun = SCHEDULER_REJECTION_CODES.has(outcome.error?.code ?? '');
373
487
  if (notRun) {
374
488
  log.writeDropped(message, outcome.error.code.toLowerCase());
375
489
  packLedger(pack).append({
@@ -399,9 +513,11 @@ export class ServiceRouter {
399
513
  logger.warn(`[Services] ${pack.id} handler for ${type} ${outcome.outcome}: ${outcome.error?.code ?? ''} ${outcome.error?.message ?? ''}`);
400
514
  }
401
515
  const reply = replyFromOutcome(type, message.requestId, outcome);
402
- // 成功与失败都记:同一 (from, request_id) 重试必须回同一结果,不能重跑脚本。
403
- if (reply.shouldSend) {
404
- store.record(message.fromAid, message.requestId, reply.payload);
516
+ // 成功与**脚本自身**的失败都记:同一 (from, request_id) 重试必须回同一结果,不能重跑脚本。
517
+ // 但调度层拒收不记——脚本没执行过,"上次结果"不存在;记下来会把偶发重启
518
+ // 变成 15 秒内必现的失败(调用方重试时命中缓存)。
519
+ if (reply.shouldSend && !notRun) {
520
+ store.record(message.fromAid, message.requestId, reply.payload, Date.now(), message.deadlineAt);
405
521
  }
406
522
  if (reply.shouldSend) {
407
523
  packLedger(pack).append({ action: 'service.replied', packId: pack.id, type, from: message.fromAid, requestId: message.requestId, ...(reply.payload.ok === false ? { result: 'failed' } : { result: 'ok' }) });
@@ -454,7 +570,13 @@ export class ServiceRouter {
454
570
  outputAuthorized = true;
455
571
  }
456
572
  catch { /* no private capability disclosure */ }
457
- const outputs = outputAuthorized ? this.outputDescriptions() : [];
573
+ let panelCardsAuthorized = false;
574
+ try {
575
+ await this.panelCardsService.authorize(message);
576
+ panelCardsAuthorized = true;
577
+ }
578
+ catch { /* private card capabilities */ }
579
+ const outputs = this.outputDescriptions(outputAuthorized, panelCardsAuthorized);
458
580
  let workbenchAuthorized = false;
459
581
  try {
460
582
  await this.workbenchService.authorize(message);
@@ -466,6 +588,9 @@ export class ServiceRouter {
466
588
  if (requestedService && (isOutputType(requestedService) || isOutputCardsType(requestedService)) && !outputAuthorized) {
467
589
  return buildErrorReply(type, message.requestId, 'OUTPUT_FORBIDDEN', 'Current protocol Owner authorization is required');
468
590
  }
591
+ if (requestedService && isPanelCardsType(requestedService) && !panelCardsAuthorized) {
592
+ return buildErrorReply(type, message.requestId, 'OUTPUT_FORBIDDEN', 'Current protocol Owner authorization is required');
593
+ }
469
594
  if (requestedService && isWorkbenchType(requestedService) && !workbenchAuthorized) {
470
595
  return buildErrorReply(type, message.requestId, 'WORKBENCH_FORBIDDEN', 'Current protocol Owner authorization is required');
471
596
  }
@@ -480,7 +605,8 @@ export class ServiceRouter {
480
605
  // 不带 service 时退化为清单:与 `ec services describe <aid>` 的语义一致。
481
606
  if (!target)
482
607
  return buildSuccessReply(type, message.requestId, { services: [...this.describeAll(), ...native], builtin: [...RESERVED_TYPES] });
483
- const output = native.find(item => Array.isArray(item.types) && item.types.includes(target));
608
+ const output = native.find(item => Array.isArray(item.handlers)
609
+ && item.handlers.some(entry => entry?.type === target));
484
610
  if (output)
485
611
  return buildSuccessReply(type, message.requestId, output);
486
612
  const described = this.describeOne(target);
@@ -500,6 +626,10 @@ export class ServiceRouter {
500
626
  return buildSuccessReply(type, message.requestId, {
501
627
  type: target, schema: outputCardsRequestSchema(target), responseDataSchema: outputCardsResponseSchema(),
502
628
  });
629
+ if (isPanelCardsType(target))
630
+ return buildSuccessReply(type, message.requestId, {
631
+ type: target, schema: panelCardsRequestSchema(target), responseDataSchema: panelCardsResponseSchema(),
632
+ });
503
633
  if (isOutputType(target))
504
634
  return buildSuccessReply(type, message.requestId, {
505
635
  type: target, schema: outputRequestSchema(target), responseDataSchema: outputResponseSchema(),
@@ -519,6 +649,9 @@ export class ServiceRouter {
519
649
  if (isOutputCardsType(target))
520
650
  return buildSuccessReply(type, message.requestId, { type: target,
521
651
  skill: 'Owner-authorized output card projection. Cards are declaration-only metadata linked to real files in this Agent output. Use services.outputs.cards.snapshot/list/detail/changes, follow nextCursor, and reset on INDEX_CHANGED. Never poll. Publish or remove cards with ec team cards after referenced files are complete.' });
652
+ if (isPanelCardsType(target))
653
+ return buildSuccessReply(type, message.requestId, { type: target, catalog: panelCardsCatalog,
654
+ skill: 'Owner-authorized Evol panel cards. Read services.skill for services.panel-cards.snapshot to load the catalog. Design complete HTML/CSS cards with body {type:html,resourceId:surface} and a declared HTML file resource under project .output/<selfAid>/ (max 256 KiB). Inline CSS/SVG/data images are supported; scripts/network/forms/native bridge are unavailable. Native components and read-only actions remain supported. Publish with ec team cards validate then publish; updates reuse the same id and remove only the card descriptor.' });
522
655
  if (isOutputType(target))
523
656
  return buildSuccessReply(type, message.requestId, { type: target,
524
657
  skill: 'Read-only fixed Agent output. Requires encrypted AUN and current verified protocol Owner. Send protocolVersion:1 and the schema-defined data fields. Results are bounded; follow nextCursor and reset on INDEX_CHANGED. No periodic reads.' });
@@ -564,13 +697,45 @@ export class ServiceRouter {
564
697
  return false;
565
698
  }
566
699
  }
700
+ /**
701
+ * 宿主运行时状态(运维观测用)。
702
+ *
703
+ * 未启用时返回 `{ enabled: false }`;启用但未启动时 `running: false`——
704
+ * 这两种要能区分:前者是闸门关着,后者是懒加载还没被调用过。
705
+ */
706
+ hostStatus() {
707
+ const enabled = this.config.host?.enabled === true;
708
+ // 关闸后进程可能还在(有在途调用,等它们跑完再收):必须如实报出来,
709
+ // 否则 `{enabled:false}` 会让人以为进程已经没了。
710
+ if (!enabled) {
711
+ const running = this.hostRuntime?.running === true;
712
+ return running
713
+ ? { enabled: false, running: true, draining: true }
714
+ : { enabled: false };
715
+ }
716
+ return {
717
+ enabled: true,
718
+ ...(this.hostRuntime ? this.hostRuntime.status() : { running: false, started: false }),
719
+ };
720
+ }
567
721
  /** services.list 的正文:每个 active 包及其全部 listen type。 */
568
722
  describeAll() {
569
723
  return this.packs.activePacks.map(pack => ({
570
724
  pack: pack.id,
571
725
  name: pack.name,
572
726
  ...(pack.description ? { description: pack.description } : {}),
573
- types: pack.listen.map(entry => entry.type),
727
+ /**
728
+ * 逐 handler 一条,`type` 与展示信息同属一个记录。
729
+ *
730
+ * 不用「`types: string[]` + 另一个带标注的数组」两个平行数组:同一 type 出现两处
731
+ * 必然漂移,消费方还得自己按下标对齐。`handlers` 与 `pack.json` 的 `listen[].handler`、
732
+ * 以及 `describeOne` 返回的 `handlers` 三处同名同义。
733
+ */
734
+ handlers: pack.listen.map(entry => ({
735
+ type: entry.type,
736
+ ...(entry.handler.name ? { name: entry.handler.name } : {}),
737
+ ...(entry.handler.description ? { description: entry.handler.description } : {}),
738
+ })),
574
739
  /** 精确 type;通配形式保留原样,调用方据此判断可发范围。 */
575
740
  unmatched: pack.unmatched,
576
741
  reply: pack.reply.allowed,
@@ -588,11 +753,17 @@ export class ServiceRouter {
588
753
  type: target,
589
754
  pack: pack.id,
590
755
  name: pack.name,
591
- ...(pack.description ? { description: pack.description } : {}),
756
+ /** handler 的说明优先于包说明:调用方问的是「这个 type」,不是「这个包」。 */
757
+ ...(entry.handler.description
758
+ ? { description: entry.handler.description }
759
+ : pack.description ? { description: pack.description } : {}),
760
+ ...(entry.handler.name ? { handlerName: entry.handler.name } : {}),
761
+ ...(entry.handler.inputSchema ? { inputSchema: entry.handler.inputSchema } : {}),
762
+ ...(entry.handler.outputSchema ? { outputSchema: entry.handler.outputSchema } : {}),
592
763
  listen: entry.type,
593
764
  script: entry.handler.script,
594
765
  ...(entry.handler.runtime ? { runtime: entry.handler.runtime } : {}),
595
- timeoutMs: entry.handler.timeoutMs ?? 30_000,
766
+ timeoutMs: entry.handler.timeoutMs ?? DEFAULT_HANDLER_TIMEOUT_MS,
596
767
  ...(entry.handler.args && entry.handler.args.length > 0 ? { args: entry.handler.args } : {}),
597
768
  ...(entry.filter ? { filter: entry.filter } : {}),
598
769
  reply: pack.reply.allowed,
@@ -614,8 +785,12 @@ export class ServiceRouter {
614
785
  listen: first.type,
615
786
  script: first.handler.script,
616
787
  ...(first.handler.runtime ? { runtime: first.handler.runtime } : {}),
617
- timeoutMs: first.handler.timeoutMs ?? 30_000,
618
- types: pack.listen.map(entry => entry.type),
788
+ timeoutMs: first.handler.timeoutMs ?? DEFAULT_HANDLER_TIMEOUT_MS,
789
+ handlers: pack.listen.map(entry => ({
790
+ type: entry.type,
791
+ ...(entry.handler.name ? { name: entry.handler.name } : {}),
792
+ ...(entry.handler.description ? { description: entry.handler.description } : {}),
793
+ })),
619
794
  reply: pack.reply.allowed,
620
795
  };
621
796
  }
@@ -630,24 +805,42 @@ export class ServiceRouter {
630
805
  */
631
806
  close() {
632
807
  this.dispatcher.close();
808
+ void this.hostRuntime?.close();
633
809
  void this.outputService.close();
634
810
  this.outputCardsService.close();
811
+ this.panelCardsService.close();
635
812
  this.workbenchService.close();
636
813
  }
637
- outputDescriptions() {
814
+ outputDescriptions(outputAuthorized, panelCardsAuthorized) {
815
+ const types = [
816
+ ...(outputAuthorized ? ['services.outputs.snapshot', 'services.outputs.list', 'services.outputs.detail', 'services.outputs.changes', ...OUTPUT_CARDS_TYPES] : []),
817
+ ...(panelCardsAuthorized ? PANEL_CARDS_TYPES : []),
818
+ ];
819
+ if (!types.length)
820
+ return [];
638
821
  return [{
639
822
  pack: 'builtin.outputs', name: 'Agent output projection',
640
823
  description: 'Owner-authorized read-only Agent output snapshots and changes',
641
- types: ['services.outputs.snapshot', 'services.outputs.list', 'services.outputs.detail', 'services.outputs.changes', ...OUTPUT_CARDS_TYPES],
824
+ handlers: toHandlerList(types),
642
825
  unmatched: 'silent', reply: true,
643
826
  }];
644
827
  }
645
828
  workbenchDescriptions() {
646
829
  return [{ pack: 'builtin.workbench', name: 'Team workbench projection',
647
830
  description: 'Owner-authorized current tasks, retained execution history and event-driven changes',
648
- types: WORKBENCH_TYPES, unmatched: 'silent', reply: true }];
831
+ handlers: toHandlerList(WORKBENCH_TYPES), unmatched: 'silent', reply: true }];
649
832
  }
650
833
  }
834
+ /**
835
+ * type 字符串列表 → `handlers` 记录列表(内置服务用)。
836
+ *
837
+ * 内置服务没有可声明的 handler 元信息,所以每个条目只有 `type`。存在的意义是让
838
+ * `services.list` 返回的数组**形状统一**:包条目与内置条目都带 `handlers`,消费方
839
+ * 不需要按来源分支处理。
840
+ */
841
+ function toHandlerList(types) {
842
+ return types.map(type => ({ type }));
843
+ }
651
844
  function readStringField(payload, key) {
652
845
  const data = payload.data;
653
846
  const value = payload[key] ?? (data && typeof data === 'object' && !Array.isArray(data)
@@ -657,9 +850,12 @@ function readStringField(payload, key) {
657
850
  /**
658
851
  * 服务请求 payload 的 JSON Schema。
659
852
  *
660
- * 关键事实:`pack.json` 不声明入参结构——参数完全由脚本自己解释,schema 无从得知。
661
- * 因此这里给的是**信封**schema(type / request_id / data),`data` 保持开放对象,
662
- * 并明确写出这一点,避免调用方以为有字段级约束。
853
+ * 信封层(type / request_id)由框架定义;`data` 有两条来源:
854
+ * - 包作者在 `handler.inputSchema` 里声明了结构 → 原样放进 `data`;
855
+ * - 没声明 → `data` 保持开放对象,并明说"入参由脚本解释",避免调用方误以为有约束。
856
+ *
857
+ * 后者仍是最常见的情况,但至少现在有了一条**机器可读**的声明通道:调用方不必再从
858
+ * 一句中文描述里猜字段名。
663
859
  */
664
860
  export function serviceRequestSchema(requestType, described) {
665
861
  return {
@@ -672,7 +868,7 @@ export function serviceRequestSchema(requestType, described) {
672
868
  type: 'string',
673
869
  description: '调用方生成的关联 ID;缺失时 daemon 用 message_id 补齐',
674
870
  },
675
- data: {
871
+ data: described.inputSchema ?? {
676
872
  type: 'object',
677
873
  description: `入参由服务端脚本解释,无声明式约束(服务包 ${described.pack},脚本 ${described.script})`,
678
874
  },
@@ -686,16 +882,27 @@ export function serviceRequestSchema(requestType, described) {
686
882
  };
687
883
  }
688
884
  /** services.skill 的正文:一段可直接读的用法说明。 */
885
+ /**
886
+ * 压成单行:`skills` 的正文是给对端 Agent 读的 markdown,description 里若带换行会
887
+ * 破坏列表结构(作者可能写多行说明)。折叠连续空白并截断,不做语义处理。
888
+ */
889
+ function singleLine(text, max = 120) {
890
+ const flat = text.replace(/\s+/g, ' ').trim();
891
+ return flat.length > max ? `${flat.slice(0, max - 1)}…` : flat;
892
+ }
689
893
  export function renderServiceSkill(selfAid, described) {
690
894
  const lines = [];
691
- lines.push(`# ${described.name} — ${described.type}`);
895
+ const heading = described.handlerName
896
+ ? `${described.name} / ${described.handlerName} — ${described.type}`
897
+ : `${described.name} — ${described.type}`;
898
+ lines.push(`# ${heading}`);
692
899
  lines.push('');
693
900
  if (described.description) {
694
901
  lines.push(described.description);
695
902
  lines.push('');
696
903
  }
697
904
  lines.push('调用方式:');
698
- lines.push(` ec services call ${selfAid} ${described.type} --data '<json>'`);
905
+ lines.push(` ec services call --aid ${selfAid} --type ${described.type} --data '<json>'`);
699
906
  lines.push('');
700
907
  lines.push('要点:');
701
908
  lines.push(` - 入参放在 data 里;具体字段由服务端脚本解释,无声明式约束。`);
@@ -703,17 +910,32 @@ export function renderServiceSkill(selfAid, described) {
703
910
  lines.push(` - 回复 type 固定为 ${described.type}.result,正文是 {ok, data} 或 {ok, error:{code,message}}。`);
704
911
  if (!described.reply)
705
912
  lines.push(' - 该服务包未开启回复:调用方收不到结果,只会有执行记录。');
706
- if (described.types && described.types.length > 1) {
913
+ if (described.handlers && described.handlers.length > 1) {
707
914
  lines.push('');
708
915
  lines.push('该包的其它 type:');
709
- for (const type of described.types)
710
- lines.push(` ${type}`);
916
+ for (const entry of described.handlers) {
917
+ const title = entry.name ? `${entry.name} ` : '';
918
+ const note = entry.description ? ` — ${singleLine(entry.description)}` : '';
919
+ lines.push(` ${title}${entry.type}${note}`.replace(/\s+$/, ''));
920
+ }
711
921
  }
712
922
  lines.push('');
713
923
  return lines.join('\n');
714
924
  }
715
925
  /** 进程内单例(每个 AID 一个,由 channels/aun.ts 持有)。 */
716
926
  const routers = new Map();
927
+ /** Also fences routers created after collection acquired the source. */
928
+ export function pauseServiceRequests(aid, token) {
929
+ routers.get(aid)?.assertMutationIdle();
930
+ const holds = templateMutationHolds.get(aid) ?? new Set();
931
+ holds.add(token);
932
+ templateMutationHolds.set(aid, holds);
933
+ return () => {
934
+ holds.delete(token);
935
+ if (!holds.size)
936
+ templateMutationHolds.delete(aid);
937
+ };
938
+ }
717
939
  export function getServiceRouter(aid, servicesDir, deps) {
718
940
  let router = routers.get(aid);
719
941
  if (!router) {