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
@@ -2,8 +2,8 @@
2
2
  * `ec services` 的 daemon 侧 IPC 操作(services.op)。
3
3
  * daemon-control 风格(不走 delegation argv 哈希);CLI 透传 argv,daemon 解析执行。
4
4
  *
5
- * 本机运维:status / list / types / ledger / tail / doctor / reload / enable / disable /
6
- * pack add|remove|list;对端调用(describe / schema / call)也在这里(`runCall`),
5
+ * 本机运维:status / types / ledger / tail / doctor / reload / enable / disable /
6
+ * pack add|remove|list|enable|disable(没有顶层 `list`,包清单是 `pack list`);对端调用(describe / schema / call)也在这里(`runCall`),
7
7
  * 请求登记进 AunRequestRegistry,应答由 AUN 入站的 `services.*.result` 分支落盘——
8
8
  * CLI 只等记录终态,中途被杀也不丢结果。
9
9
  */
@@ -12,18 +12,35 @@ import path from 'node:path';
12
12
  import { logger } from '../utils/logger.js';
13
13
  import { agentServicesDir, resolveRoot } from '../paths.js';
14
14
  import { classifyProtectedPath } from '../core/permission/protected-paths.js';
15
- import { ServiceLedger } from '../core/pack-ledger.js';
15
+ import { ServiceLedger } from '../core/pack/pack-ledger.js';
16
16
  import { ServiceMessageLog } from './message-log.js';
17
17
  import { DEFAULT_ROUTER_CONFIG, SERVICES_CONFIG_JSON, loadRouterConfig, ServiceRulesStore } from './router.js';
18
- import { PACK_JSON } from './pack-manager.js';
18
+ import { loadPackDir, PACK_JSON } from './pack-manager.js';
19
19
  import { readLocalSelfIdentity } from './identity.js';
20
20
  import { createOfflineServiceRouter, listServiceRouterAids, peekServiceRouter, } from './index.js';
21
- import { isReservedServiceType, RESERVED_TYPES } from './service-payload.js';
21
+ import { isReservedServiceType, RESERVED_TYPES, SERVICE_ENVELOPE_KEYS, SERVICE_TRANSPORT_FIELDS } from './service-payload.js';
22
22
  import { getAunRequestRegistry } from '../core/message/aun-request-registry.js';
23
23
  import { ServiceError, errorMessage } from './types.js';
24
- import { authorizePackTarget, packOperation } from '../core/pack-auth.js';
25
- import { installPack, listPackDirs, removePack, setPackEnabled } from '../core/pack-install.js';
24
+ import { authorizePackTarget, callerDefaultAid, isKnownPackCommand, packOperation } from '../core/pack/pack-auth.js';
25
+ import { discardPackBackup, installPack, listPackDirs, removePack, restorePackBackup, setPackEnabled, } from '../core/pack/pack-install.js';
26
26
  import { hardenServicesAcl, planServicesAclRepair, readServicesAcl } from '../core/permission/services-path-acl.js';
27
+ /**
28
+ * 服务调用的默认等待时长,也是请求消息的 TTL。
29
+ *
30
+ * 两者必须是同一个数:TTL 决定这条消息在网关存在多久,等待时长决定调用方愿意
31
+ * 等多久。TTL 更长就意味着"调用方已经放弃、消息还活着",重建了这套设计要去掉
32
+ * 的补投语义;TTL 更短则调用方还在等、消息已经没了。
33
+ */
34
+ /**
35
+ * `call --local` 模拟的调用方角色。
36
+ *
37
+ * 不能用自己的身份:本机对自身必然是 owner,owner+bypass 会免掉沙箱,自测就永远
38
+ * 看不到脚本在沙箱里的真实表现。`member` 走 auto 档,沙箱照常生效,与一个普通
39
+ * 外部调用者的路径最接近。
40
+ */
41
+ export const LOCAL_CALL_ROLE = 'member';
42
+ export const SERVICE_CALL_TIMEOUT_MS = 12_000;
43
+ export const SERVICE_CALL_TTL_SECONDS = Math.ceil(SERVICE_CALL_TIMEOUT_MS / 1_000);
27
44
  const HELP = `ec services — 服务路由运维
28
45
 
29
46
  用法:
@@ -35,6 +52,7 @@ const HELP = `ec services — 服务路由运维
35
52
  ec services repair-acl [--aid <aid>] 收紧 services/ 的 NTFS ACL(幂等,仅 Windows)
36
53
  ec services reload [--aid <aid>] 重载(全部包)
37
54
  ec services enable / disable [--aid <aid>] 总闸
55
+ ec services host enable / disable [--aid <aid>] 宿主模式(常驻执行形态)
38
56
  ec services rules show [<type>] [--aid <aid>] 调用准入规则
39
57
  ec services rules add <type> <aid...> [--deny] [--aid <aid>]
40
58
  ec services rules remove <type> <aid...> [--deny] [--aid <aid>]
@@ -48,10 +66,10 @@ const HELP = `ec services — 服务路由运维
48
66
  remove 默认把日志与台账归档到 <包>/logs/archive-<时间戳>/;--purge 连归档一起删。
49
67
  ec services pack list [--aid <aid>]
50
68
 
51
- 对端:
52
- ec services describe <aid>
53
- ec services schema <aid> <type>
54
- ec services call <aid> <type> --data '<json>' [--timeout 30] [--encrypted] [--no-wait]`;
69
+ 对端(--aid 是**被调用方**;发送身份托管会话自动补齐,宿主终端用 --as):
70
+ ec services describe --aid <对端aid> [--type <type>]
71
+ ec services schema --aid <对端aid> --type <type>
72
+ ec services call --aid <对端aid> --type <type> --data '<json>' [--as <发送身份>] [--timeout 12] [--encrypted]`;
55
73
  export function parseServicesArgv(argv) {
56
74
  const args = [...argv];
57
75
  if (args.length === 0 || args[0] === 'help' || args[0] === '--help')
@@ -91,8 +109,8 @@ export function parseServicesArgv(argv) {
91
109
  const timeoutRaw = consumeValue('--timeout');
92
110
  if (timeoutRaw !== undefined) {
93
111
  const timeoutMs = parseTimeoutMs(timeoutRaw);
94
- if (timeoutMs === undefined)
95
- return { error: `--timeout must be a positive duration (seconds or 30s/2m): ${timeoutRaw}` };
112
+ if (timeoutMs === undefined || timeoutMs > 300_000)
113
+ return { error: `--timeout must be a positive duration up to 5m (seconds or 30s/2m): ${timeoutRaw}` };
96
114
  parsed.timeoutMs = timeoutMs;
97
115
  }
98
116
  const dataRaw = consumeValue('--data');
@@ -108,22 +126,30 @@ export function parseServicesArgv(argv) {
108
126
  return { error: `--data is not valid JSON: ${error instanceof Error ? error.message : String(error)}` };
109
127
  }
110
128
  }
111
- const requestId = consumeValue('--request-id');
112
- if (requestId !== undefined)
113
- parsed.requestId = requestId;
114
- // `--service <type|包名>` 等价于 describe/schema 的第二个位置参数。
129
+ // `--type <type>` 是主名字;`--service` 作为历史别名保留(老脚本/文档在用)。
130
+ const typeFlag = consumeValue('--type');
131
+ if (typeFlag !== undefined)
132
+ parsed.type = typeFlag;
115
133
  const serviceFlag = consumeValue('--service');
116
134
  if (serviceFlag !== undefined)
117
135
  parsed.type = serviceFlag;
136
+ // 对端调用的发送身份。与 `--aid`(被调用方)分开:同一个 flag 不能在不同子命令里
137
+ // 换含义,那会让"我到底在指谁"只能靠记忆。
138
+ const asFlag = consumeValue('--as');
139
+ if (asFlag !== undefined)
140
+ parsed.as = asFlag;
118
141
  if (args.includes('--encrypted')) {
119
142
  parsed.encrypted = true;
120
143
  args.splice(args.indexOf('--encrypted'), 1);
121
144
  }
122
- if (args.includes('--no-wait')) {
123
- parsed.noWait = true;
124
- args.splice(args.indexOf('--no-wait'), 1);
125
- }
126
145
  parsed.from = consumeValue('--from');
146
+ if (args.includes('--local')) {
147
+ // 只对 call 有意义;别的子命令带上它属于写错了,宁可直接报错也不要静默忽略。
148
+ if (command !== 'call')
149
+ return { error: `--local is only supported by "call" (got "${command}")` };
150
+ parsed.local = true;
151
+ args.splice(args.indexOf('--local'), 1);
152
+ }
127
153
  if (args.includes('--purge')) {
128
154
  parsed.purge = true;
129
155
  args.splice(args.indexOf('--purge'), 1);
@@ -133,8 +159,9 @@ export function parseServicesArgv(argv) {
133
159
  args.splice(args.indexOf('--deny'), 1);
134
160
  }
135
161
  if (args.includes('--force')) {
136
- // 覆盖安装已取消:重装前必须先 `pack remove`。识别出来是为了给明确提示。
137
- return { error: '--force is no longer supported; run "pack remove <包名>" before reinstalling' };
162
+ // 覆盖安装已取消。要换内容用 `pack update`(原地替换、保留日志台账),
163
+ // 要重来一遍用 `pack remove` 再 `pack add`。识别出来是为了给明确提示。
164
+ return { error: '--force is no longer supported; use "pack update <包名> --from <源目录>" to replace a pack, or "pack remove" then "pack add"' };
138
165
  }
139
166
  const positional = args.filter(item => !item.startsWith('-'));
140
167
  if (command === 'pack') {
@@ -147,16 +174,46 @@ export function parseServicesArgv(argv) {
147
174
  parsed.type = positional[1];
148
175
  parsed.aids = positional.slice(2);
149
176
  }
177
+ else if (command === 'host') {
178
+ // `host enable` / `host disable`。子动作名与总闸同名但作用的是 `host.enabled`,
179
+ // 不在这里分流就会落进下面的默认分支,被当成包名去查。
180
+ const action = positional[0] ?? '';
181
+ if (action !== 'enable' && action !== 'disable') {
182
+ return { error: `host requires an action: enable | disable (got ${action || '(none)'})` };
183
+ }
184
+ parsed.command = `host:${action}`;
185
+ }
186
+ else if (command === 'call' || command === 'describe' || command === 'schema') {
187
+ // 对端调用**只接受显式参数**:被调用方是 `--aid`,type 是 `--type`。
188
+ //
189
+ // 位置参数在这里曾同时承担"目标 AID"和"type",而 `--aid` 又指的是发送身份——
190
+ // 三个身份混在两处,读命令的人无法自证谁是谁。现在统一:`--aid` 永远是
191
+ // 被调用方(与 status / pack / enable 一致),发送身份走 `--as`。
192
+ if (positional.length > 0) {
193
+ return {
194
+ error: `${command} takes no positional arguments; use --aid <target-aid> --type <services.type> `
195
+ + `(and --as <sender-aid> only when no session identity is available). Got: ${positional.join(' ')}`,
196
+ };
197
+ }
198
+ }
150
199
  else {
151
200
  parsed.pack = positional[0];
152
201
  }
153
- // `--service` 已给出时不被位置参数覆盖。
154
- if (parsed.type === undefined)
202
+ // 包名类命令(status / ledger / tail / doctor)仍用位置参数指包。
203
+ if (parsed.type === undefined && !['call', 'describe', 'schema'].includes(command)) {
155
204
  parsed.type = positional[1];
205
+ }
156
206
  return parsed;
157
207
  }
158
208
  /** `--timeout 30` / `30s` / `2m` / `500ms` → 毫秒。 */
159
209
  /** 只用于比较两个 AID 是否同一主体:去 `@` 前缀并忽略大小写。 */
210
+ /** 去掉展示用的 `@` 前缀与首尾空白;AID 本身不带 `@`。 */
211
+ function stripAidPrefix(value) {
212
+ const aid = String(value ?? '').trim();
213
+ if (!aid)
214
+ return undefined;
215
+ return aid.startsWith('@') ? aid.slice(1) : aid;
216
+ }
160
217
  function normalizeAid(value) {
161
218
  const aid = String(value ?? '').trim();
162
219
  return (aid.startsWith('@') ? aid.slice(1) : aid).toLowerCase();
@@ -180,6 +237,12 @@ function resolveAid(deps, parsed) {
180
237
  const live = peekServiceRouter(parsed.aid);
181
238
  return { aid: parsed.aid, router: live ?? deps.create(parsed.aid) };
182
239
  }
240
+ // 托管会话:默认目标就是会话自己,不看"恰好只有一个 router",也不回落 daemon AID。
241
+ const sessionAid = callerDefaultAid(parsed.caller);
242
+ if (sessionAid) {
243
+ const live = peekServiceRouter(sessionAid);
244
+ return { aid: sessionAid, router: live ?? deps.create(sessionAid) };
245
+ }
183
246
  const aids = deps.listAids?.() ?? [];
184
247
  if (aids.length === 1) {
185
248
  const live = peekServiceRouter(aids[0]);
@@ -239,10 +302,110 @@ export function createServicesOperationExecutor(deps) {
239
302
  }
240
303
  };
241
304
  }
305
+ /**
306
+ * 本次重载**新增**的无效/跳过包。
307
+ *
308
+ * 只报增量:一个历史坏包如果每次 reload 都被翻出来,报警很快就变成噪音,
309
+ * 而噪音等于没有信号。历史遗留由 `status` / `doctor` 负责(它们是显式查询)。
310
+ */
311
+ function newlyBrokenPacks(before, after) {
312
+ const prevInvalid = new Set(before.packs.invalidPacks.map(item => item.id));
313
+ const prevSkipped = new Set(before.packs.skippedPacks.map(item => item.id));
314
+ return {
315
+ invalid: after.packs.invalidPacks.filter(item => !prevInvalid.has(item.id)),
316
+ skipped: after.packs.skippedPacks.filter(item => !prevSkipped.has(item.id)),
317
+ };
318
+ }
319
+ /**
320
+ * 装包/启停后要带回去的包状态。
321
+ *
322
+ * 两类合并:**具名包自己的**状态(哪怕它在之前就是坏的——否则「enable 一个坏包」
323
+ * 会静默成功),加上**其它包本次才变坏的**(跨包 type 冲突会把邻居一起拖下水)。
324
+ */
325
+ function packStateIssues(after, before, named) {
326
+ const delta = newlyBrokenPacks(before, after);
327
+ const invalid = after.packs.invalidPacks.filter(item => item.id === named || delta.invalid.some(hit => hit.id === item.id));
328
+ const skipped = after.packs.skippedPacks.filter(item => item.id === named || delta.skipped.some(hit => hit.id === item.id));
329
+ return {
330
+ ...(invalid.length > 0 ? { invalid } : {}),
331
+ ...(skipped.length > 0 ? { skipped } : {}),
332
+ };
333
+ }
334
+ /** 组一句人能直接看懂的警告;没有问题时返回 undefined。 */
335
+ function packIssueWarning(issues) {
336
+ const parts = [];
337
+ for (const item of issues.invalid ?? [])
338
+ parts.push(`${item.id} 未加载(${item.errors.join('; ')})`);
339
+ for (const item of issues.skipped ?? [])
340
+ parts.push(`${item.id} 已跳过(${item.reason})`);
341
+ return parts.length > 0 ? `以下包没有生效:${parts.join(';')}` : undefined;
342
+ }
242
343
  async function execute(deps, parsed) {
243
344
  const { command } = parsed;
244
345
  if (command === 'help')
245
346
  return { ok: true, result: { help: HELP } };
347
+ // 对端调用单独走:目标是**远端**,本机不为它解析 router。
348
+ // 发送身份 = `--as` > 托管会话身份 > 缺省 AID。
349
+ // `--local` 不调对端,不需要也不应该被要求写 `--aid`:那是别人的地址。
350
+ // 目标固定是「本机这个 AID」——托管会话取自己的,主机终端取缺省 AID。
351
+ if (command === 'call' && parsed.local) {
352
+ const localAid = stripAidPrefix((parsed.caller?.kind === 'managed' ? parsed.caller.selfAid : undefined) ?? deps.defaultAid?.());
353
+ if (!localAid)
354
+ return { ok: false, code: 'SENDER_REQUIRED', error: 'call --local needs a local AID; run it from a managed session or the host terminal' };
355
+ return await runCall(deps, localAid, parsed);
356
+ }
357
+ if (command === 'call' || command === 'describe' || command === 'schema') {
358
+ const targetAid = parsed.aid;
359
+ if (!targetAid) {
360
+ return { ok: false, code: 'INVALID_ARGV', error: `${command} requires --aid <target-aid>` };
361
+ }
362
+ /**
363
+ * `--as` 不得越过托管会话自己的身份。
364
+ *
365
+ * 这一行曾经是纯粹的优先级(`--as` 最高),而 `authorizePackTarget` 对 `call`
366
+ * 无条件放行——两条合起来等于「任何托管会话都能以本机任意挂着 channel 的 AID
367
+ * 发出服务调用」,委托链完全不经过,对端看到的发件人是被冒用的那个。
368
+ *
369
+ * 合法用途只有两个,判据取 `caller.kind`:
370
+ * - 主机终端(`local-control`,持有 control.token 的 OS 账户)没有会话身份,
371
+ * 才需要显式 `--as`;
372
+ * - 托管会话的发送身份就是它自己,写 `--as` 只允许重复自己。
373
+ */
374
+ const sessionAid = parsed.caller?.kind === 'managed' ? stripAidPrefix(parsed.caller.selfAid) : undefined;
375
+ const asAid = stripAidPrefix(parsed.as);
376
+ if (sessionAid && asAid && normalizeAid(asAid) !== normalizeAid(sessionAid)) {
377
+ return {
378
+ ok: false,
379
+ code: 'INVALID_ARGV',
380
+ error: `--as is not allowed to impersonate another AID in a managed session (session=${sessionAid}, --as=${asAid}); `
381
+ + 'the sender identity always follows the current task',
382
+ };
383
+ }
384
+ const sender = sessionAid ?? asAid ?? stripAidPrefix(deps.defaultAid?.());
385
+ if (!sender) {
386
+ return {
387
+ ok: false,
388
+ code: 'SENDER_REQUIRED',
389
+ error: `${command} needs a sender identity: pass --as <aid> (a managed session supplies it automatically)`,
390
+ };
391
+ }
392
+ const callParsed = { ...parsed, pack: targetAid };
393
+ const auth = authorizePackTarget({
394
+ caller: parsed.caller ?? { kind: 'local-control' },
395
+ targetAid,
396
+ ...(deps.daemonAid?.() ? { daemonAid: deps.daemonAid() } : {}),
397
+ operation: packOperation('services', command, parsed.action),
398
+ });
399
+ if (!auth.allowed)
400
+ return { ok: false, code: auth.code, error: auth.error };
401
+ return await runCall(deps, sender, callParsed);
402
+ }
403
+ // 未知命令必须在解析目标与授权之前拦下:否则按 fail-closed 落到 manage 档,
404
+ // 报出的是权限错误而不是"没有这个命令"。
405
+ if (!isKnownPackCommand('services', command, parsed.action)) {
406
+ const label = command === 'pack' ? `pack action: ${parsed.action ?? '(none)'}` : `services command: ${command.replace(':', ' ')}`;
407
+ return { ok: false, code: 'UNKNOWN_COMMAND', error: `unknown ${label}\n${HELP}` };
408
+ }
246
409
  const target = resolveAid(deps, parsed);
247
410
  if (target.error)
248
411
  return target.error;
@@ -262,10 +425,6 @@ async function execute(deps, parsed) {
262
425
  const snapshot = router.snapshot();
263
426
  const servicesDir = agentServicesDir(aid);
264
427
  switch (command) {
265
- case 'call':
266
- case 'describe':
267
- case 'schema':
268
- return await runCall(deps, aid, parsed);
269
428
  case 'rules:show': {
270
429
  const config = new ServiceRulesStore(servicesDir).read();
271
430
  const entries = parsed.type
@@ -325,6 +484,8 @@ async function execute(deps, parsed) {
325
484
  enabled: snapshot.enabled,
326
485
  identity: snapshot.identity,
327
486
  routerErrors: snapshot.routerErrors,
487
+ // 宿主运行时:`enabled:false` = 总闸关着;`enabled:true,running:false` = 尚未被调用。
488
+ host: peekServiceRouter(aid)?.hostStatus() ?? { enabled: false },
328
489
  packs: snapshot.packs.activePacks.map(pack => statusForPack(snapshot, pack.id)),
329
490
  skipped: snapshot.packs.skippedPacks,
330
491
  disabled: snapshot.packs.disabledPacks,
@@ -381,15 +542,28 @@ async function execute(deps, parsed) {
381
542
  return { ok: false, code: 'INVALID_ARGV', error: `reload does not accept a pack name (reloads all packs): ${parsed.pack}` };
382
543
  }
383
544
  const live = peekServiceRouter(aid);
384
- if (live)
385
- live.reload();
386
- else
387
- router.reload();
388
- return { ok: true, result: { aid, reloaded: '*', enabled: router.enabled } };
545
+ // `enabled` 是总闸,不是「包都加载成功」:坏包进来时它照样是 true。
546
+ // 所以把本次才变坏的包一并带回去,别让 reload 的回执变成一句谎话。
547
+ const beforeReload = live ? live.snapshot() : router.snapshot();
548
+ const afterReload = live ? live.reload() : router.reload();
549
+ const issues = newlyBrokenPacks(beforeReload, afterReload);
550
+ const warning = packIssueWarning(issues);
551
+ return {
552
+ ok: true,
553
+ result: {
554
+ aid, reloaded: '*', enabled: afterReload.enabled,
555
+ ...(issues.invalid.length > 0 ? { invalid: issues.invalid } : {}),
556
+ ...(issues.skipped.length > 0 ? { skipped: issues.skipped } : {}),
557
+ ...(warning ? { warning } : {}),
558
+ },
559
+ };
389
560
  }
390
561
  case 'enable':
391
562
  case 'disable':
392
563
  return setRouterEnabled(aid, command === 'enable');
564
+ case 'host:enable':
565
+ case 'host:disable':
566
+ return setHostEnabled(aid, command === 'host:enable');
393
567
  case 'pack': {
394
568
  const servicesDirForPack = agentServicesDir(aid);
395
569
  if (parsed.action === 'list') {
@@ -397,16 +571,47 @@ async function execute(deps, parsed) {
397
571
  }
398
572
  if (!parsed.pack)
399
573
  return { ok: false, code: 'INVALID_ARGV', error: `pack ${parsed.action ?? ''} requires <包名>` };
400
- if (parsed.action === 'add') {
574
+ if (parsed.action === 'add' || parsed.action === 'update') {
575
+ const isUpdate = parsed.action === 'update';
401
576
  if (!parsed.from)
402
- return { ok: false, code: 'INVALID_ARGV', error: 'pack add requires --from <源目录>' };
403
- const installed = installPack({
404
- sourceDir: parsed.from,
405
- targetRoot: servicesDirForPack,
406
- name: parsed.pack,
407
- manifestFile: PACK_JSON,
408
- legacyManifestFile: 'service.json',
409
- });
577
+ return { ok: false, code: 'INVALID_ARGV', error: `pack ${parsed.action} requires --from <源目录>` };
578
+ // 先校验再落地:坏包的目录一旦建出来,reload 只会说「重载成功」,
579
+ // 调用方拿到 NOT_SUPPORTED 却查不到原因。在暂存目录上跑加载器,
580
+ // 校验不过就整体丢弃,services/ 下什么都不留。
581
+ //
582
+ // 判据直接复用 `loadPackDir`(pack-manager),不另写一套规则——两边漂移
583
+ // 会让「装的时候过、加载的时候不过」重新出现。
584
+ let installed;
585
+ try {
586
+ installed = installPack({
587
+ sourceDir: parsed.from,
588
+ targetRoot: servicesDirForPack,
589
+ name: parsed.pack,
590
+ manifestFile: PACK_JSON,
591
+ legacyManifestFile: 'service.json',
592
+ replace: isUpdate,
593
+ validate: stagedDir => {
594
+ const errors = [];
595
+ if (!loadPackDir(stagedDir, errors)) {
596
+ throw Object.assign(new Error(`pack ${parsed.pack} is invalid: ${errors.join('; ')}`), {
597
+ code: 'PACK_INVALID',
598
+ packErrors: errors,
599
+ });
600
+ }
601
+ },
602
+ });
603
+ }
604
+ catch (error) {
605
+ const packErrors = error?.packErrors;
606
+ if (!packErrors)
607
+ throw error;
608
+ return {
609
+ ok: false,
610
+ code: 'PACK_INVALID',
611
+ error: `pack ${parsed.pack} 未通过校验,未安装:${packErrors.join('; ')}`,
612
+ result: { aid, pack: parsed.pack, errors: packErrors },
613
+ };
614
+ }
410
615
  // 首次装包沿用 Agent 的默认开启策略。已有配置(包括显式关闭)原样保留,
411
616
  // 装包不能顺带修改总闸;请求仍经过准入、权限、限流与沙箱检查。
412
617
  const routerPath = path.join(servicesDirForPack, SERVICES_CONFIG_JSON);
@@ -420,13 +625,47 @@ async function execute(deps, parsed) {
420
625
  createdRouter = true;
421
626
  }
422
627
  const live = peekServiceRouter(aid);
423
- if (live)
424
- live.reload();
425
- else
426
- router.reload();
628
+ const beforeReload = live ? live.snapshot() : router.snapshot();
629
+ const afterReload = live ? live.reload() : router.reload();
630
+ // 单包预校验查不出跨包同 type 冲突:那种情况下新包**和**原来的同 type 包
631
+ // 会一起变 invalid。装完再判一次,坏的那个整体回滚,别让它把邻居拖下水。
632
+ const landedInvalid = afterReload.packs.invalidPacks.find(item => item.id === parsed.pack);
633
+ if (landedInvalid) {
634
+ // 更新:把旧内容搬回去,包回到更新前的样子——旧版本至少还能跑。
635
+ // 首次安装:没有可回滚的东西,整个目录删掉。
636
+ //
637
+ // 删除路径不能连累归档:重装到残留目录时 `intoArchived`,此时目录里有上一轮的
638
+ // 日志归档,purge 会把它们一起删掉。
639
+ const restored = installed.backupDir
640
+ ? restorePackBackup(installed.dir, installed.backupDir)
641
+ : false;
642
+ if (!restored) {
643
+ removePack({ pack: parsed.pack, targetRoot: servicesDirForPack, purge: !installed.intoArchived });
644
+ }
645
+ if (live)
646
+ live.reload();
647
+ else
648
+ router.reload();
649
+ logger.warn(`[Services] pack ${parsed.action} rolled back ${parsed.pack}: ${landedInvalid.errors.join('; ')}`);
650
+ return {
651
+ ok: false,
652
+ code: 'PACK_INVALID',
653
+ error: `pack ${parsed.pack} 装上后无法加载,已${restored ? '回滚到更新前的版本' : '回滚'}:${landedInvalid.errors.join('; ')}`,
654
+ result: {
655
+ aid, pack: parsed.pack, errors: landedInvalid.errors,
656
+ rolledBack: true, ...(restored ? { restoredFromBackup: true } : {}),
657
+ },
658
+ };
659
+ }
660
+ // 新包确认加载成功 → 旧内容备份可以丢了。失败时不删:
661
+ // 那是下一次排查"上一版到底长什么样"的唯一材料。
662
+ if (installed.backupDir)
663
+ discardPackBackup(installed.backupDir);
427
664
  // 配置存在但坏了:装包成功、总闸却回落到 enabled=false,业务消息全被静默丢弃。
428
665
  // 不替用户改文件,但必须把原因带回去。
429
666
  const configErrors = createdRouter ? [] : loadRouterConfig(servicesDirForPack).errors;
667
+ const issues = packStateIssues(afterReload, beforeReload, parsed.pack);
668
+ const warning = packIssueWarning(issues);
430
669
  // ACL 加固:新包目录与 services 根都要收口。失败不阻断安装——包已经 rename
431
670
  // 到位,加固只是加一层兜底;把原因带回去,`doctor` 也会持续报。
432
671
  const acl = hardenServicesAcl(servicesDirForPack);
@@ -439,6 +678,8 @@ async function execute(deps, parsed) {
439
678
  aid, ...installed,
440
679
  ...(createdRouter ? { createdRouter: true } : {}),
441
680
  ...(configErrors.length > 0 ? { configErrors } : {}),
681
+ ...issues,
682
+ ...(warning ? { warning } : {}),
442
683
  ...(acl.errors.length > 0 ? { aclErrors: acl.errors } : {}),
443
684
  },
444
685
  };
@@ -467,11 +708,12 @@ async function execute(deps, parsed) {
467
708
  packId: parsed.pack,
468
709
  });
469
710
  const live = peekServiceRouter(aid);
470
- if (live)
471
- live.reload();
472
- else
473
- router.reload();
474
- return { ok: true, result: { aid, ...toggled } };
711
+ const beforeReload = live ? live.snapshot() : router.snapshot();
712
+ const afterReload = live ? live.reload() : router.reload();
713
+ // 启停一个本来就坏的包:开关写进去了,包却照样不加载。不报出来就是静默失败。
714
+ const issues = packStateIssues(afterReload, beforeReload, parsed.pack);
715
+ const warning = packIssueWarning(issues);
716
+ return { ok: true, result: { aid, ...toggled, ...issues, ...(warning ? { warning } : {}) } };
475
717
  }
476
718
  return { ok: false, code: 'UNKNOWN_COMMAND', error: `unknown pack action: ${parsed.action ?? '(none)'}
477
719
  ${HELP}` };
@@ -488,21 +730,91 @@ ${HELP}` };
488
730
  * 因此 CLI 中途被杀也不丢结果。
489
731
  */
490
732
  async function runCall(deps, selfAid, parsed) {
491
- // 查询已发出的请求:ec services call <self-aid> --request-id <id>
492
- if (parsed.requestId) {
493
- const record = getAunRequestRegistry().get(selfAid, parsed.requestId);
494
- if (!record)
495
- return { ok: false, code: 'REQUEST_NOT_FOUND', error: `no request ${parsed.requestId}` };
496
- return { ok: true, result: summarizeRecord(record) };
497
- }
498
- const targetAid = parsed.pack;
499
- if (!targetAid)
500
- return { ok: false, code: 'INVALID_ARGV', error: `${parsed.command} requires <aid>` };
733
+ // `@` 前缀只是展示习惯(名片里那样写),AID 本身不带。不在这里剥掉就会原样
734
+ // 交给消息层,被 AID 校验拒成 "must be 4-64 characters"。
735
+ const targetAid = stripAidPrefix(parsed.pack);
736
+ // `--local` 不走网络,--aid 无意义;要求它反而会让人以为在调别人。
737
+ if (!parsed.local && !targetAid) {
738
+ return { ok: false, code: 'INVALID_ARGV', error: `${parsed.command} requires --aid <target-aid>` };
739
+ }
501
740
  // 调自己:消息会发出去,但入站侧没有任何分支会应答它,只能干等满超时(默认 30s)
502
741
  // 然后报一个看起来像对端故障的 NO_RESULT。前置拒绝,别让人等。
503
- if (normalizeAid(targetAid) === normalizeAid(selfAid)) {
742
+ if (!parsed.local && targetAid && normalizeAid(targetAid) === normalizeAid(selfAid)) {
504
743
  return { ok: false, code: 'INVALID_ARGV', error: 'cannot call self: <aid> is this daemon\'s own AID' };
505
744
  }
745
+ // 信封键不得出现在 data 里。以前 data.type 会覆盖信封的请求类型(请求被路由到
746
+ // 另一个服务),其余信封键交给脚本前又被静默剥离——两种都是"调用方以为写的东西
747
+ // 生效了"。这里在发出去之前就撞墙,并把撞到的键回显出来。
748
+ // 放在连接检查之前:参数错了不该依赖通道是否在线才能发现。
749
+ if (parsed.command === 'call' && parsed.data) {
750
+ const envelopeKeys = Object.keys(parsed.data).filter(key => SERVICE_ENVELOPE_KEYS.has(key));
751
+ if (envelopeKeys.length > 0) {
752
+ return {
753
+ ok: false,
754
+ code: 'INVALID_ARGV',
755
+ error: `data must not contain envelope keys: ${envelopeKeys.join(', ')}. `
756
+ + 'The request type is set by --type only; rename business fields that collide with these keys.',
757
+ };
758
+ }
759
+ }
760
+ // 本机自测:不经过 AUN,直接走一遍「路由 → 权限 → 沙箱 → handler」。
761
+ // 测不到准入、加密、跨机时延;能测到装包/加载/路由/handler 这几层,也就是
762
+ // 平时最需要外部 Agent 代跑才能发现的那几类问题。
763
+ if (parsed.local) {
764
+ if (!parsed.type)
765
+ return { ok: false, code: 'INVALID_ARGV', error: 'call --local requires --type <services.type>' };
766
+ const live = peekServiceRouter(selfAid) ?? deps.create(selfAid);
767
+ const now = Date.now();
768
+ const requestId = `local_${now.toString(36)}_${Math.random().toString(36).slice(2, 10)}`;
769
+ const timeoutMs = parsed.timeoutMs ?? SERVICE_CALL_TIMEOUT_MS;
770
+ const message = {
771
+ type: parsed.type,
772
+ requestId,
773
+ requestIdGenerated: true,
774
+ fromAid: selfAid,
775
+ messageId: `local-${requestId}`,
776
+ encrypted: false,
777
+ payload: { ...(parsed.data ?? {}), type: parsed.type },
778
+ receivedAt: now,
779
+ deadlineAt: now + timeoutMs,
780
+ };
781
+ const startedAt = Date.now();
782
+ let reply;
783
+ try {
784
+ reply = await live.handleRequest(message, { admission: 'allow', simulateRole: LOCAL_CALL_ROLE });
785
+ }
786
+ catch (error) {
787
+ return { ok: false, code: 'LOCAL_CALL_FAILED', error: errorMessage(error), result: { request_id: requestId } };
788
+ }
789
+ const durationMs = Date.now() - startedAt;
790
+ if (!reply.shouldSend) {
791
+ // 静默 = 没有回执可看。这里必须说清楚是「包主动不回」,否则和"卡住了"分不开。
792
+ return {
793
+ ok: false,
794
+ code: 'LOCAL_CALL_SILENT',
795
+ error: `${parsed.type} produced no reply (pack reply.allowed is false, or the handler returned noop)`,
796
+ result: { request_id: requestId, durationMs },
797
+ };
798
+ }
799
+ const payload = reply.payload;
800
+ return {
801
+ ok: payload.ok !== false,
802
+ ...(payload.ok === false ? { code: String(payload.error?.code ?? 'HANDLER_FAILED') } : {}),
803
+ ...(payload.ok === false ? { error: String(payload.error?.message ?? 'handler failed') } : {}),
804
+ result: {
805
+ ...payload,
806
+ type: reply.type,
807
+ request_id: requestId,
808
+ durationMs,
809
+ local: true,
810
+ simulatedRole: LOCAL_CALL_ROLE,
811
+ },
812
+ };
813
+ }
814
+ // 走到这里 `--local` 已经返回,必定走网络,--aid 必须有值。
815
+ if (!targetAid) {
816
+ return { ok: false, code: 'INVALID_ARGV', error: `${parsed.command} requires --aid <target-aid>` };
817
+ }
506
818
  const channel = deps.getChannel?.(selfAid);
507
819
  if (!channel?.sendDaemonMsg) {
508
820
  return { ok: false, code: 'NOT_CONFIGURED', error: `no AUN channel is connected for ${selfAid}` };
@@ -522,14 +834,24 @@ async function runCall(deps, selfAid, parsed) {
522
834
  : parsed.type
523
835
  ? { service: parsed.type }
524
836
  : {};
525
- const timeoutMs = parsed.timeoutMs ?? 30_000;
837
+ // 信封键已在上游拒绝;剩下的传输层键(label / task_id / thread_id …)不拒绝,
838
+ // 因为它们可能正是内置服务的业务参数(内置服务直接读 payload,不走剥离)。
839
+ // 但**扩展包**的脚本看不到它们——回执里提示一句,别让作者以为写了就生效了。
840
+ const maybeStripped = parsed.command === 'call'
841
+ ? Object.keys(data).filter(key => SERVICE_TRANSPORT_FIELDS.has(key))
842
+ : [];
843
+ const timeoutMs = parsed.timeoutMs ?? SERVICE_CALL_TIMEOUT_MS;
844
+ // TTL 必须由本次等待时长推导:消息在网关活多久,调用方就等多久。多一秒都是
845
+ // 给"对端稍后上线还能捡到这条请求"留口子,那正是这套设计要去掉的补投语义。
846
+ const ttl = Math.max(1, Math.ceil(timeoutMs / 1_000));
526
847
  const registry = getAunRequestRegistry();
527
848
  let prepared;
528
849
  try {
529
850
  prepared = registry.prepare({
530
851
  selfAid,
531
852
  targetAid,
532
- payload: { type: requestType, ...data },
853
+ // 顺序有语义:信封字段展开在 data **之后**,即使将来放开了 data 校验也不会被覆盖。
854
+ payload: { ...data, type: requestType, service_deadline_at_ms: Date.now() + timeoutMs },
533
855
  timeoutMs,
534
856
  });
535
857
  }
@@ -540,6 +862,9 @@ async function runCall(deps, selfAid, parsed) {
540
862
  const sent = await channel.sendDaemonMsg({
541
863
  to: targetAid,
542
864
  payload: prepared.payload,
865
+ // volatile:只存在消息服务内存里,不落库、不分配持久 seq。对端离线时这条
866
+ // 请求在 TTL 到期后消失,重连也拉不到——服务调用是 RPC,不是离线信箱。
867
+ ttl,
543
868
  ...(parsed.encrypted !== undefined ? { encrypt: parsed.encrypted } : {}),
544
869
  service: { type: requestType, requestId: prepared.requestId },
545
870
  });
@@ -554,25 +879,34 @@ async function runCall(deps, selfAid, parsed) {
554
879
  }
555
880
  if (sent.message_id)
556
881
  registry.markTransportAccepted(selfAid, prepared.requestId, sent.message_id, sent.status);
557
- if (parsed.noWait) {
558
- return { ok: true, result: { request_id: prepared.requestId, message_id: sent.message_id, state: 'pending' } };
559
- }
560
882
  const record = await registry.wait(selfAid, prepared.requestId, timeoutMs);
561
883
  if (!record) {
562
884
  return { ok: false, code: 'NO_RESULT', error: 'request record disappeared', result: { request_id: prepared.requestId } };
563
885
  }
564
- const summary = summarizeRecord(record);
565
886
  if (record.state === 'completed' && record.responsePayload) {
566
- return { ok: true, result: { ...summary, response: record.responsePayload } };
887
+ return {
888
+ ok: true,
889
+ result: {
890
+ ...summarizeRecord(record),
891
+ response: record.responsePayload,
892
+ ...(maybeStripped.length > 0
893
+ ? { warning: `这些键属于传输层字段:${maybeStripped.join(', ')}。对端若由扩展包处理,脚本看不到它们。` }
894
+ : {}),
895
+ },
896
+ };
567
897
  }
568
898
  if (record.state === 'failed') {
569
- return { ok: false, code: 'REQUEST_FAILED', error: `request ${prepared.requestId} failed`, result: summary };
899
+ return { ok: false, code: 'REQUEST_FAILED', error: `request ${prepared.requestId} failed`, result: summarizeRecord(record) };
570
900
  }
901
+ // 等到超时:把记录钉成终态,迟到的应答再也改不动它(resolveIncoming 只接受
902
+ // 非终态记录)。`wait()` 自己只会落到 pending —— 那是 `ecmsg send --return required` 需要的
903
+ // "稍后还能补上"的语义,服务调用不需要。
904
+ const expired = registry.markFailed(selfAid, prepared.requestId, 'no response before deadline') ?? record;
571
905
  return {
572
906
  ok: false,
573
907
  code: 'NO_RESULT',
574
- error: `no result before timeout; request_id=${prepared.requestId} (the service may have executed)`,
575
- result: summary,
908
+ error: `no response within ${Math.round(timeoutMs / 1_000)}s; the request expires with it (request_id=${prepared.requestId})`,
909
+ result: summarizeRecord(expired),
576
910
  };
577
911
  }
578
912
  function summarizeRecord(record) {
@@ -592,6 +926,18 @@ function statusForPack(snapshot, packId) {
592
926
  name: pack.name,
593
927
  status: 'active',
594
928
  listens: pack.listen.map(entry => entry.type),
929
+ /**
930
+ * 每个 type 的执行形态。
931
+ *
932
+ * 单独列出来是因为「声明了 resident」和「实际跑在 resident」是两件事:
933
+ * `host.enabled=false` 时前者为真、后者为假。没有这个字段,运维只能靠
934
+ * 全局 host 段去推,而那是 agent 级、不是 handler 级。
935
+ */
936
+ handlers: pack.listen.map(entry => ({
937
+ type: entry.type,
938
+ mode: entry.handler.mode ?? 'spawn',
939
+ ...(entry.handler.resident ? { resident: entry.handler.resident } : {}),
940
+ })),
595
941
  unmatched: pack.unmatched,
596
942
  replyAllowed: pack.reply.allowed,
597
943
  revision: pack.revision,
@@ -623,6 +969,8 @@ function doctor(aid, router, only) {
623
969
  const packs = only
624
970
  ? snapshot.packs.activePacks.filter(pack => pack.id === only)
625
971
  : snapshot.packs.activePacks;
972
+ // 宿主总闸:`mode:"resident"` 只有它开着才有稳态收益,否则退化成每调用一进程。
973
+ const hostEnabled = snapshot.config.host?.enabled === true;
626
974
  for (const pack of packs) {
627
975
  // 1. requires 与名片不符(对被过滤掉的包在 skipped 里单独报)。
628
976
  findings.push({ level: 'ok', check: `${pack.id}.requires`, detail: `satisfied by ${snapshot.identity.type}/${snapshot.identity.exttype || '-'}` });
@@ -636,6 +984,17 @@ function doctor(aid, router, only) {
636
984
  });
637
985
  }
638
986
  }
987
+ // 3. 常驻形态但宿主没开:**不是错误**(会降级成每调用一进程),但必须让人知道
988
+ // 这条路径付的是每次启动的价钱,拿不到常驻的稳态收益。
989
+ const residentHandlers = pack.listen.filter(entry => entry.handler.mode === 'resident');
990
+ if (residentHandlers.length > 0 && !hostEnabled) {
991
+ findings.push({
992
+ level: 'warn',
993
+ check: `${pack.id}.handler.mode`,
994
+ detail: `${residentHandlers.length} handler(s) declare mode=resident but services-config.json host.enabled is not true; `
995
+ + 'they run one process per call (same cost as mode=spawn)',
996
+ });
997
+ }
639
998
  }
640
999
  // 5. type=services 但无激活包。
641
1000
  //
@@ -741,16 +1100,39 @@ function lClassFinding() {
741
1100
  return { level: 'warn', check: 'l-class', detail: `cannot verify: ${errorMessage(error)}` };
742
1101
  }
743
1102
  }
744
- /** enable / disable 只改 services-config.json 的 enabled 字段;v 与其他字段原样保留。 */
745
- function setRouterEnabled(aid, enabled) {
746
- const servicesDir = agentServicesDir(aid);
1103
+ /**
1104
+ * 读 services-config.json 原始对象作为改写底稿。
1105
+ *
1106
+ * 不能用 `loadRouterConfig().config` 写回:那是校验后的规范形态,会丢掉未知字段、
1107
+ * 把缺省值具体化。用户手写的文件要按原样保留,只动目标字段。
1108
+ */
1109
+ function readConfigForWrite(servicesDir) {
747
1110
  const filePath = path.join(servicesDir, SERVICES_CONFIG_JSON);
748
1111
  const loaded = loadRouterConfig(servicesDir);
749
- const base = loaded.exists
750
- ? JSON.parse(fs.readFileSync(filePath, 'utf8'))
1112
+ let parsed;
1113
+ if (loaded.exists) {
1114
+ try {
1115
+ parsed = JSON.parse(fs.readFileSync(filePath, 'utf8'));
1116
+ }
1117
+ catch (error) {
1118
+ // 文件在但读不懂:拒绝改写。覆盖掉等于替用户销毁他手写的内容。
1119
+ return { failure: { ok: false, code: 'ROUTER_INVALID', error: `cannot rewrite unreadable ${SERVICES_CONFIG_JSON}: ${errorMessage(error)}` } };
1120
+ }
1121
+ }
1122
+ const base = parsed && typeof parsed === 'object' && !Array.isArray(parsed)
1123
+ ? parsed
751
1124
  : { v: 1, rateLimit: { builtin: { perMinute: 20, perHour: 200 }, service: { perMinute: 50, perHour: 1000 } } };
752
1125
  if (base.v !== 1)
753
1126
  base.v = 1;
1127
+ return { base, filePath };
1128
+ }
1129
+ /** enable / disable 只改 services-config.json 的 enabled 字段;v 与其他字段原样保留。 */
1130
+ function setRouterEnabled(aid, enabled) {
1131
+ const servicesDir = agentServicesDir(aid);
1132
+ const read = readConfigForWrite(servicesDir);
1133
+ if ('failure' in read)
1134
+ return read.failure;
1135
+ const { base, filePath } = read;
754
1136
  base.enabled = enabled;
755
1137
  try {
756
1138
  fs.mkdirSync(servicesDir, { recursive: true });
@@ -764,4 +1146,47 @@ function setRouterEnabled(aid, enabled) {
764
1146
  live.reload();
765
1147
  return { ok: true, result: { aid, enabled, path: filePath } };
766
1148
  }
1149
+ /**
1150
+ * `host enable` / `host disable`:改写 `services-config.json` 的 `host.enabled`。
1151
+ *
1152
+ * 与 `setRouterEnabled` 分开是因为两者作用域不同:`enabled` 是整条服务路由的总闸
1153
+ * (关了对外不接活),`host.enabled` 只决定脚本以什么形态执行(常驻宿主 vs 一次性
1154
+ * spawn)。混成一个命令会让"我只想退回一次性路径"变成"我的服务全停"。
1155
+ *
1156
+ * 写入后必须 `reload()`:`ServiceRouter.reload()` 里的 `syncHostRuntime()` 才是
1157
+ * 挂载/摘除宿主的唯一入口,光写文件不重读不会生效。
1158
+ */
1159
+ function setHostEnabled(aid, enabled) {
1160
+ const servicesDir = agentServicesDir(aid);
1161
+ const applied = applyHostEnabled(servicesDir, enabled);
1162
+ if ('failure' in applied)
1163
+ return applied.failure;
1164
+ const live = peekServiceRouter(aid);
1165
+ if (live)
1166
+ live.reload();
1167
+ return { ok: true, result: { aid, host: { enabled }, path: applied.written } };
1168
+ }
1169
+ /**
1170
+ * 只写文件、不 reload。导出是为了让测试直接打靶:`setHostEnabled` 走
1171
+ * `agentServicesDir()`,测试里没法把路径指到临时目录。
1172
+ */
1173
+ export function applyHostEnabled(servicesDir, enabled) {
1174
+ const read = readConfigForWrite(servicesDir);
1175
+ if ('failure' in read)
1176
+ return { failure: read.failure };
1177
+ const { base, filePath } = read;
1178
+ const rawHost = base.host;
1179
+ const current = rawHost && typeof rawHost === 'object' && !Array.isArray(rawHost)
1180
+ ? rawHost
1181
+ : {};
1182
+ base.host = { ...current, enabled };
1183
+ try {
1184
+ fs.mkdirSync(servicesDir, { recursive: true });
1185
+ fs.writeFileSync(filePath, `${JSON.stringify(base, null, 2)}\n`, 'utf8');
1186
+ }
1187
+ catch (error) {
1188
+ return { failure: { ok: false, code: 'ROUTER_WRITE_FAILED', error: errorMessage(error) } };
1189
+ }
1190
+ return { written: filePath };
1191
+ }
767
1192
  export { HELP as SERVICES_HELP };