evolcore 0.0.50 → 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 (448) hide show
  1. package/CHANGELOG.md +39 -2
  2. package/bin/ec-build.mjs +60 -0
  3. package/bin/ecmsg.js +65 -63
  4. package/dist/ability/caller/command.js +24 -15
  5. package/dist/ability/caller/contract.js +24 -9
  6. package/dist/ability/caller/credential-files.js +132 -0
  7. package/dist/ability/caller/daemon.js +32 -7
  8. package/dist/ability/caller/schema-view.js +157 -0
  9. package/dist/ability/caller/service.js +202 -63
  10. package/dist/ability/interop-v1.js +156 -113
  11. package/dist/agent-template/jobs.js +14 -110
  12. package/dist/agent-template/runtime.js +331 -193
  13. package/dist/agent-template/service.js +1029 -1104
  14. package/dist/agent-template/share.js +103 -0
  15. package/dist/agent-template/tool-runner.js +25 -0
  16. package/dist/agent-template/types.js +10 -3
  17. package/dist/agents/claude/availability.js +94 -0
  18. package/dist/agents/claude/capability-provider.js +154 -0
  19. package/dist/agents/claude/index.js +145 -0
  20. package/dist/agents/{claude-runner.js → claude/runner.js} +74 -158
  21. package/dist/agents/claude/session-file-adapter.js +246 -0
  22. package/dist/agents/codex/app-server-client.js +90 -10
  23. package/dist/agents/codex/availability.js +164 -0
  24. package/dist/agents/codex/capability-provider.js +138 -0
  25. package/dist/agents/codex/cli.js +38 -0
  26. package/dist/agents/codex/index.js +345 -0
  27. package/dist/agents/codex/mcp-elicitation.js +135 -0
  28. package/dist/agents/{codex-runner.js → codex/runner.js} +648 -382
  29. package/dist/agents/codex/session-file-adapter.js +834 -0
  30. package/dist/agents/dsh/availability.js +28 -0
  31. package/dist/agents/dsh/capability-provider.js +56 -0
  32. package/dist/agents/dsh/desktop-locations.ps1 +66 -0
  33. package/dist/agents/dsh/desktop-probe.cjs +37 -0
  34. package/dist/agents/dsh/index.js +98 -0
  35. package/dist/agents/dsh/installation.js +400 -0
  36. package/dist/agents/dsh/resources.js +755 -0
  37. package/dist/agents/dsh/runner.js +1183 -0
  38. package/dist/agents/dsh/runtime/README.md +243 -0
  39. package/dist/agents/dsh/runtime/authorization.js +23 -0
  40. package/dist/agents/dsh/runtime/bridge.js +837 -0
  41. package/dist/agents/dsh/runtime/config.js +271 -0
  42. package/dist/agents/dsh/runtime/entry.js +229 -0
  43. package/dist/agents/dsh/runtime/session-inspector.js +340 -0
  44. package/dist/agents/dsh/runtime/tool-policy.js +49 -0
  45. package/dist/agents/dsh/session-file-adapter.js +145 -0
  46. package/dist/agents/ecagent/index.js +215 -0
  47. package/dist/agents/{ecagent-runner.js → ecagent/runner.js} +592 -106
  48. package/dist/agents/ecagent/session-file-adapter.js +134 -0
  49. package/dist/agents/gemini/index.js +55 -10
  50. package/dist/agents/gemini/{gemini-runner.js → runner.js} +4 -9
  51. package/dist/aun/ability-device-routing.js +11 -17
  52. package/dist/aun/aid/agentmd.js +27 -1
  53. package/dist/aun/aid/managed-operation.js +6 -4
  54. package/dist/aun/group/invite-service.js +1 -1
  55. package/dist/aun/menu/client.js +1 -1
  56. package/dist/aun/msg/history.js +1 -1
  57. package/dist/aun/msg/managed-operation.js +93 -21
  58. package/dist/aun/msg/p2p.js +6 -6
  59. package/dist/aun/service-proxy.js +1 -1
  60. package/dist/aun/storage/index.js +242 -0
  61. package/dist/build-identity.json +1 -1
  62. package/dist/channels/aun.js +180 -43
  63. package/dist/channels/daemon.js +3 -2
  64. package/dist/channels/dingtalk.js +1 -1
  65. package/dist/channels/feishu.js +9 -9
  66. package/dist/channels/qqbot.js +1 -1
  67. package/dist/channels/wechat.js +2 -2
  68. package/dist/channels/wecom.js +1 -1
  69. package/dist/{agents/claude-gateway → claude-gateway}/agent-registration.js +13 -13
  70. package/dist/{agents/claude-gateway → claude-gateway}/binding.js +3 -3
  71. package/dist/{agents/claude-gateway → claude-gateway}/inbox.js +1 -1
  72. package/dist/{agents/claude-gateway → claude-gateway}/index.js +2 -2
  73. package/dist/{agents/claude-gateway → claude-gateway}/listing.js +3 -3
  74. package/dist/{agents/claude-gateway → claude-gateway}/router.js +4 -4
  75. package/dist/{agents/claude-gateway → claude-gateway}/sessions.js +2 -2
  76. package/dist/{agents/claude-gateway → claude-gateway}/terminal.js +1 -1
  77. package/dist/{agents/claude-gateway → claude-gateway}/transcript.js +1 -1
  78. package/dist/cli/ability-command.js +8 -5
  79. package/dist/cli/ability-output.js +182 -0
  80. package/dist/cli/agent-command.js +1 -1
  81. package/dist/cli/agent-create.js +123 -42
  82. package/dist/cli/agent-template.js +400 -29
  83. package/dist/cli/agent.js +14 -11
  84. package/dist/cli/aun-commands.js +167 -111
  85. package/dist/cli/daemon-commands.js +38 -8
  86. package/dist/cli/data-command.js +1 -1
  87. package/dist/cli/debug-mode.js +9 -0
  88. package/dist/cli/directory.js +1 -2
  89. package/dist/cli/ecmsg-gateway.js +55 -19
  90. package/dist/cli/fs-command.js +67 -39
  91. package/dist/cli/index.js +25 -11
  92. package/dist/cli/init.js +124 -29
  93. package/dist/cli/managed-command-guard.js +2 -0
  94. package/dist/cli/model.js +1 -1
  95. package/dist/cli/restart-monitor.js +2 -2
  96. package/dist/cli/services-command.js +24 -1
  97. package/dist/cli/skill-command.js +4 -4
  98. package/dist/cli/task-context.js +24 -14
  99. package/dist/cli/team-workspace-command.js +50 -52
  100. package/dist/cli/thread-command.js +3 -2
  101. package/dist/cli/trigger-command.js +47 -12
  102. package/dist/cli/watch-logs.js +2 -1
  103. package/dist/config/boot-log.js +3 -0
  104. package/dist/config/builtin-role-templates.js +1 -1
  105. package/dist/config/config-field-policy.js +10 -6
  106. package/dist/config/config-manager.js +33 -12
  107. package/dist/config/gateway-config.js +21 -37
  108. package/dist/config/invoke-ipc-service.js +1 -1
  109. package/dist/config/owner-config.js +5 -3
  110. package/dist/config/peer-book-store.js +2 -3
  111. package/dist/config/peer-book.js +2 -2
  112. package/dist/config/peer-role-resolver.js +2 -2
  113. package/dist/config/provider-identity-migration.js +24 -105
  114. package/dist/config/provider-ipc-service.js +13 -3
  115. package/dist/config/provider-local-sync.js +4 -1
  116. package/dist/config/provider-menu-request.js +21 -3
  117. package/dist/config/provider-templates.js +1 -1
  118. package/dist/config/providers-config.js +39 -15
  119. package/dist/config/providers-import.js +3 -3
  120. package/dist/config/providers-management.js +74 -99
  121. package/dist/config/schema-migration.js +177 -11
  122. package/dist/config/schema-registry.js +1 -1
  123. package/dist/config-store.js +38 -50
  124. package/dist/core/{agent-application-service.js → agent/agent-application-service.js} +9 -9
  125. package/dist/core/{agent-create-status.js → agent/agent-create-status.js} +112 -4
  126. package/dist/core/{agent-creation-claim.js → agent/agent-creation-claim.js} +3 -3
  127. package/dist/core/{agent-ipc-registration.js → agent/agent-ipc-registration.js} +102 -25
  128. package/dist/core/{agent-reload-coordinator.js → agent/agent-reload-coordinator.js} +61 -1
  129. package/dist/core/{agent-runtime.js → agent/agent-runtime.js} +53 -27
  130. package/dist/core/{evolagent-registry.js → agent/evolagent-registry.js} +12 -12
  131. package/dist/core/{evolagent.js → agent/evolagent.js} +11 -11
  132. package/dist/core/auth/agent-delegation.js +1 -8
  133. package/dist/core/auth/delegation-authorization.js +28 -0
  134. package/dist/core/auth/operation-authorizer.js +7 -4
  135. package/dist/core/auth/operation-catalog.js +34 -5
  136. package/dist/core/baseagent/baseagent-availability.js +197 -0
  137. package/dist/core/baseagent/baseagent-capability-adapter.js +288 -0
  138. package/dist/core/baseagent/baseagent-config-shared.js +56 -0
  139. package/dist/core/baseagent/baseagent-identity.js +68 -0
  140. package/dist/core/{baseagent-loader.js → baseagent/baseagent-loader.js} +62 -6
  141. package/dist/core/baseagent/baseagent-model-defaults.js +26 -0
  142. package/dist/{agents → core/baseagent}/baseagent-plugin-descriptor.js +107 -24
  143. package/dist/core/baseagent/baseagent-plugin-loader.js +367 -0
  144. package/dist/core/baseagent/baseagent.js +157 -0
  145. package/dist/{agents → core/baseagent}/runner-types.js +36 -4
  146. package/dist/core/capability/capability-manager.js +79 -30
  147. package/dist/core/capability/providers/claude-capability-provider.js +2 -154
  148. package/dist/core/capability/providers/codex-capability-provider.js +2 -136
  149. package/dist/core/{channel-loader.js → channel/channel-loader.js} +226 -38
  150. package/dist/core/{channel-runtime.js → channel/channel-runtime.js} +18 -18
  151. package/dist/core/command/agent-control.js +60 -15
  152. package/dist/core/command/agent-template-menu.js +21 -9
  153. package/dist/core/command/agentmd-menu-request.js +19 -8
  154. package/dist/core/command/agentmd-menu.js +14 -5
  155. package/dist/core/command/command-handler.js +127 -57
  156. package/dist/core/command/context-policy-menu.js +122 -0
  157. package/dist/core/command/data-root-resolver.js +157 -20
  158. package/dist/core/command/memory-slash.js +6 -6
  159. package/dist/core/command/menu-catalog.js +80 -20
  160. package/dist/core/command/menu-handler.js +305 -25
  161. package/dist/core/command/menu-protocol.js +42 -8
  162. package/dist/core/command/menu-query-batch.js +9 -5
  163. package/dist/core/command/provider-menu.js +7 -11
  164. package/dist/core/command/role-menu.js +1 -1
  165. package/dist/core/command/skill-slash.js +17 -5
  166. package/dist/core/command/slash-gate.js +2 -4
  167. package/dist/core/command/slash-handler.js +127 -96
  168. package/dist/core/command/team-workspace-team.js +3 -3
  169. package/dist/core/command/topic-slash.js +10 -10
  170. package/dist/core/{daemon-bootstrap.js → daemon/daemon-bootstrap.js} +14 -14
  171. package/dist/core/{daemon-control.js → daemon/daemon-control.js} +46 -20
  172. package/dist/core/{daemon-lifecycle.js → daemon/daemon-lifecycle.js} +15 -15
  173. package/dist/core/{host-snapshot.js → daemon/host-snapshot.js} +3 -3
  174. package/dist/core/{ipc-registration.js → daemon/ipc-registration.js} +98 -38
  175. package/dist/core/{lifecycle-notice.js → daemon/lifecycle-notice.js} +4 -5
  176. package/dist/core/file-integrity/store.js +1 -1
  177. package/dist/core/handoff/ipc-registration.js +3 -3
  178. package/dist/core/handoff/runtime.js +1 -1
  179. package/dist/{agents → core/inference}/request-identity.js +2 -2
  180. package/dist/core/inference/text-inference.js +4 -4
  181. package/dist/core/{bootstrap-messages.js → initialization/bootstrap-messages.js} +10 -10
  182. package/dist/core/{bootstrap-service.js → initialization/bootstrap-service.js} +24 -23
  183. package/dist/core/initialization/service.js +54 -9
  184. package/dist/core/invoke/executors/media.js +1 -1
  185. package/dist/core/invoke/executors/text.js +1 -1
  186. package/dist/core/memory/consolidation-context.js +1 -1
  187. package/dist/core/memory/consolidation-trigger.js +9 -3
  188. package/dist/core/memory/consolidation.js +4 -4
  189. package/dist/core/memory/memory-admin.js +6 -6
  190. package/dist/core/memory/memory-writer.js +1 -1
  191. package/dist/core/memory/relation-idle-monitor.js +1 -1
  192. package/dist/core/message/aun-ipc-sender.js +114 -75
  193. package/dist/core/message/aun-request-registry.js +13 -5
  194. package/dist/core/message/auto-mention-gate.js +1 -1
  195. package/dist/core/message/contact-admission.js +1 -1
  196. package/dist/core/message/im-renderer.js +19 -0
  197. package/dist/core/{interaction-router.js → message/interaction-router.js} +4 -4
  198. package/dist/core/message/items-formatter.js +5 -5
  199. package/dist/core/message/message-admission.js +1 -1
  200. package/dist/core/message/message-bridge.js +135 -54
  201. package/dist/core/message/message-queue.js +83 -4
  202. package/dist/core/message/message-utils.js +1 -1
  203. package/dist/core/message/peer-mode.js +1 -1
  204. package/dist/core/message/response-engine.js +347 -163
  205. package/dist/core/message/send-options.js +9 -6
  206. package/dist/core/message/send-routing.js +45 -109
  207. package/dist/core/message/stream-idle-monitor.js +1 -1
  208. package/dist/core/{data-migration.js → migration/data-migration.js} +29 -1
  209. package/dist/core/model/catalog-service.js +29 -8
  210. package/dist/core/model/model-capabilities.js +88 -0
  211. package/dist/core/model/model-catalog.js +14 -3
  212. package/dist/core/model/model-diagnostics.js +4 -4
  213. package/dist/core/ownership/owner-resolver.js +95 -15
  214. package/dist/core/{pack-auth.js → pack/pack-auth.js} +30 -3
  215. package/dist/core/{pack-install.js → pack/pack-install.js} +95 -17
  216. package/dist/core/permission/approval-gateway.js +9 -18
  217. package/dist/core/permission/ec-command-parser.js +70 -34
  218. package/dist/core/permission/managed-file.js +234 -0
  219. package/dist/core/permission/protected-paths.js +56 -0
  220. package/dist/core/permission/sandbox-runtime.js +267 -3
  221. package/dist/core/permission/session-path-grants.js +1 -1
  222. package/dist/core/permission/shell-environment.js +15 -1
  223. package/dist/core/plugin/plugin-lifecycle.js +442 -0
  224. package/dist/core/session/adapters/claude-session-file-adapter.js +2 -246
  225. package/dist/core/session/adapters/codex-session-file-adapter.js +2 -566
  226. package/dist/core/session/adapters/ecagent-session-file-adapter.js +2 -134
  227. package/dist/core/{background-session → session/background}/session-cleanup.js +2 -2
  228. package/dist/core/{background-session → session/background}/types.js +1 -1
  229. package/dist/core/session/session-file-health.js +2 -272
  230. package/dist/core/session/session-idle-monitor.js +1 -1
  231. package/dist/core/session/session-manager.js +29 -2
  232. package/dist/core/session/session-terminal.js +185 -0
  233. package/dist/core/session/session-title.js +8 -11
  234. package/dist/core/{system-session → session/system}/memory.js +43 -9
  235. package/dist/core/{system-session → session/system}/registry.js +1 -1
  236. package/dist/core/{system-session → session/system}/types.js +1 -1
  237. package/dist/core/skill/index-generator.js +1 -0
  238. package/dist/core/task/task-activity-store.js +112 -0
  239. package/dist/core/task/task-recovery-service.js +2 -2
  240. package/dist/core/thread/ipc-operation.js +2 -2
  241. package/dist/core/thread/thread-operation.js +2 -1
  242. package/dist/core/thread/thread-route.js +5 -3
  243. package/dist/core/thread/thread-service.js +14 -4
  244. package/dist/directory/{owner-directory-admission.js → admission.js} +3 -3
  245. package/dist/directory/{owner-directory-cache.js → cache.js} +90 -8
  246. package/dist/directory/{owner-directory-markdown.js → markdown.js} +2 -2
  247. package/dist/directory/{owner-directory-query-operation.js → query-operation.js} +83 -9
  248. package/dist/directory/{owner-directory-search.js → search.js} +50 -2
  249. package/dist/directory/{owner-directory-store.js → store.js} +2 -2
  250. package/dist/eck/kit-renderer.js +1 -1
  251. package/dist/eck/manifest-engine.js +64 -2
  252. package/dist/eck/message-renderer.js +35 -0
  253. package/dist/ecweb/basic-settings-service.js +9 -3
  254. package/dist/{contracts → ecweb/contracts}/ecweb-service-protocol.js +2 -1
  255. package/dist/ecweb/dsh-native-service.js +413 -0
  256. package/dist/ecweb/providers-service.js +1 -1
  257. package/dist/ecweb/runtime/lifecycle.js +1 -1
  258. package/dist/ecweb/runtime/supervisor.js +1 -1
  259. package/dist/event-center/center-config.js +2 -2
  260. package/dist/event-center/dispatcher.js +1 -1
  261. package/dist/event-center/ipc-operation.js +12 -3
  262. package/dist/event-center/pack-loader.js +2 -2
  263. package/dist/event-center/registry.js +6 -6
  264. package/dist/event-center/runtime.js +2 -2
  265. package/dist/index.js +71 -42
  266. package/dist/ipc.js +103 -10
  267. package/dist/outputs/authorization.js +27 -0
  268. package/dist/outputs/events.js +10 -1
  269. package/dist/outputs/panel-cards.js +960 -0
  270. package/dist/paths.js +12 -0
  271. package/dist/pay/command.js +1 -1
  272. package/dist/pay/runtime.js +18 -10
  273. package/dist/response-system/engines/v1/proactive-flow.js +1 -1
  274. package/dist/services/dispatcher.js +2 -2
  275. package/dist/services/host/main.js +10 -1
  276. package/dist/services/host/protocol.js +9 -2
  277. package/dist/services/host/resident.js +37 -0
  278. package/dist/services/host-client.js +12 -0
  279. package/dist/services/host-recycle.js +8 -3
  280. package/dist/services/host-runtime.js +54 -15
  281. package/dist/services/index.js +83 -19
  282. package/dist/services/ipc-operation.js +303 -38
  283. package/dist/services/pack-manager.js +2 -2
  284. package/dist/services/router.js +43 -3
  285. package/dist/services/script-runner.js +34 -25
  286. package/dist/services/service-payload.js +28 -1
  287. package/dist/services/validation.js +28 -2
  288. package/dist/stats/context-usage.js +110 -0
  289. package/dist/stats/model-resolver.js +103 -17
  290. package/dist/stats/query.js +5 -0
  291. package/dist/trigger/application-service.js +3 -2
  292. package/dist/trigger/authorization.js +36 -33
  293. package/dist/trigger/ipc-service.js +4 -4
  294. package/dist/trigger/local-files.js +8 -176
  295. package/dist/trigger/manager.js +2 -2
  296. package/dist/trigger/parser.js +48 -0
  297. package/dist/trigger/scheduler.js +14 -2
  298. package/dist/trigger/script-executor.js +21 -0
  299. package/dist/trigger/script-sandbox.js +57 -243
  300. package/dist/trigger/system-definitions.js +25 -0
  301. package/dist/trigger/validation.js +1 -1
  302. package/dist/utils/atomic-write.js +88 -1
  303. package/dist/utils/cross-platform.js +4 -42
  304. package/dist/utils/error-dict.json +22 -1
  305. package/dist/utils/error-utils.js +193 -6
  306. package/dist/utils/evolcore-version.js +2 -2
  307. package/dist/utils/host-info.js +1 -1
  308. package/dist/utils/logger.js +3 -1
  309. package/dist/utils/media-cache.js +99 -4
  310. package/dist/utils/startup-trace.js +20 -4
  311. package/dist/utils/welcome.js +64 -20
  312. package/ecagent/README.md +35 -0
  313. package/ecagent/dist/agent-loop.js +80 -30
  314. package/ecagent/dist/harness/env/nodejs.d.ts +16 -0
  315. package/ecagent/dist/harness/env/nodejs.js +49 -20
  316. package/ecagent/dist/harness/messages.js +3 -2
  317. package/ecagent/dist/harness/types.d.ts +1 -0
  318. package/ecagent/dist/runtime/types.d.ts +2 -0
  319. package/ecagent/dist/runtime/utils/validation.d.ts +7 -1
  320. package/ecagent/dist/runtime/utils/validation.js +42 -0
  321. package/ecagent/dist/types.d.ts +2 -0
  322. package/kits/docs/INDEX.md +1 -1
  323. package/kits/docs/channels/feishu.md +1 -1
  324. package/kits/docs/evolcore/INDEX.md +10 -7
  325. package/kits/docs/evolcore/agent-create.md +2 -0
  326. package/kits/docs/evolcore/agent.md +100 -13
  327. package/kits/docs/evolcore/aid.md +19 -3
  328. package/kits/docs/evolcore/config.md +94 -0
  329. package/kits/docs/evolcore/ctl.md +2 -1
  330. package/kits/docs/evolcore/ec-capabilities.md +7 -10
  331. package/kits/docs/evolcore/ecweb-lifecycle.md +5 -1
  332. package/kits/docs/evolcore/event.md +1 -1
  333. package/kits/docs/evolcore/fs.md +49 -3
  334. package/kits/docs/evolcore/group.md +3 -3
  335. package/kits/docs/evolcore/memory-consolidation.md +1 -1
  336. package/kits/docs/evolcore/menu-protocol.md +24 -2
  337. package/kits/docs/evolcore/model.md +9 -1
  338. package/kits/docs/evolcore/msg.md +30 -28
  339. package/kits/docs/evolcore/pay.md +8 -20
  340. package/kits/docs/evolcore/plugin.md +74 -0
  341. package/kits/docs/evolcore/provider.md +8 -2
  342. package/kits/docs/evolcore/rpc.md +2 -2
  343. package/kits/docs/evolcore/skill.md +17 -1
  344. package/kits/docs/evolcore/stats.md +5 -0
  345. package/kits/docs/evolcore/storage.md +22 -0
  346. package/kits/docs/evolcore/thread-chain.md +19 -10
  347. package/kits/docs/evolcore/tool-authorization.md +4 -0
  348. package/kits/docs/evolcore/trigger.md +89 -13
  349. package/kits/docs/identity/AID_PROFILE_SPEC.md +1 -1
  350. package/kits/docs/venues/feishu-group.md +3 -2
  351. package/kits/docs/venues/feishu-private.md +3 -2
  352. package/kits/rules/02-navigation.md +20 -13
  353. package/kits/rules/06-channel.md +18 -2
  354. package/kits/schemas/_meta.json +8 -4
  355. package/kits/schemas/agent-config.schema.23.json +19 -3
  356. package/kits/schemas/agent-config.schema.24.json +986 -0
  357. package/kits/schemas/agent-config.schema.25.json +986 -0
  358. package/kits/schemas/daemon.schema.11.json +487 -0
  359. package/kits/schemas/daemon.schema.12.json +505 -0
  360. package/kits/schemas/defaults.schema.8.json +484 -0
  361. package/kits/schemas/providers.schema.1.json +1 -1
  362. package/kits/schemas/providers.schema.2.json +1 -1
  363. package/kits/schemas/providers.schema.3.json +8 -2
  364. package/kits/skills/.switches.json +4 -0
  365. package/kits/skills/ability/SKILL.md +194 -27
  366. package/kits/skills/ability/STRUCTURE.md +5 -0
  367. package/kits/skills/agent-output-cards/SKILL.md +90 -54
  368. package/kits/skills/agent-output-cards/examples/html-surface.json +11 -0
  369. package/kits/skills/agent-output-cards/examples/meeting-followups.json +16 -0
  370. package/kits/skills/agent-output-cards/examples/meeting-latest.json +24 -0
  371. package/kits/skills/agent-output-cards/examples/project-metrics.json +16 -0
  372. package/kits/skills/agent-output-cards/examples/quick-links.json +18 -0
  373. package/kits/skills/agent-output-cards/examples/surface.html +8 -0
  374. package/kits/skills/agent-template-project/SKILL.md +51 -0
  375. package/kits/skills/agent-template-project/references/01-collect-and-pack.md +174 -0
  376. package/kits/skills/agent-template-project/references/02-upload-and-share.md +109 -0
  377. package/kits/skills/agent-template-project/references/03-download-and-install.md +189 -0
  378. package/kits/skills/agent-template-project/references/04-upgrade-and-recovery.md +74 -0
  379. package/kits/skills/agent-template-project/references/05-publish-to-platform.md +62 -0
  380. package/kits/skills/ec-group/SKILL.md +3 -3
  381. package/kits/skills/ec-group-collaboration/SKILL.md +4 -4
  382. package/kits/skills/ec-identity/SKILL.md +9 -6
  383. package/kits/skills/ec-pay/SKILL.md +163 -41
  384. package/kits/skills/ec-provider/SKILL.md +5 -5
  385. package/kits/skills/ec-service-call/SKILL.md +3 -0
  386. package/kits/skills/ec-skill/SKILL.md +25 -9
  387. package/kits/skills/ec-skill/scripts/cli.mjs +7 -7
  388. package/kits/skills/ec-skill/scripts/skill.mjs +55 -41
  389. package/kits/skills/ec-skill/scripts/template/SKILL.md.tmpl +9 -0
  390. package/kits/skills/ec-trigger/SKILL.md +2 -2
  391. package/kits/skills/personal-assistant/SKILL.md +22 -22
  392. package/kits/skills/personal-assistant/references/03-data-flow-and-gaps.md +1 -1
  393. package/kits/skills/scrapling-article-fetch/SKILL.md +5 -5
  394. package/kits/skills/thread-ops/SKILL.md +19 -9
  395. package/kits/skills/wechat-article-media-download/SKILL.md +2 -2
  396. package/kits/skills/wechat-article-reader/SKILL.md +2 -2
  397. package/kits/templates/system-fragments/commands.md +1 -1
  398. package/kits/templates/system-fragments/personal-assistant.md +2 -2
  399. package/kits/templates/system-fragments/reply.md +14 -9
  400. package/kits/templates/system-fragments/session.md +1 -1
  401. package/kits/templates/system-fragments/thread.md +10 -5
  402. package/package.json +6 -5
  403. package/scripts/agent-template/index.mjs +7 -1
  404. package/scripts/agent-template/inspect.mjs +81 -35
  405. package/scripts/agent-template/overlay.mjs +110 -4
  406. package/scripts/agent-template/shared/common.mjs +36 -4
  407. package/scripts/agent-template/shared/plan.mjs +4 -2
  408. package/scripts/agent-template/shared/service-packs.mjs +104 -0
  409. package/scripts/agent-template/shared/team-schema.json +467 -54
  410. package/scripts/agent-template/shared/template-contract.mjs +70 -68
  411. package/scripts/agent-template/shared/template-package.mjs +153 -36
  412. package/scripts/agent-template/shared/template-runtime.mjs +76 -64
  413. package/scripts/agent-template/shared/template.mjs +11 -46
  414. package/scripts/agent-template/team-pack.mjs +451 -35
  415. package/scripts/agent-template/team-preview.mjs +75 -226
  416. package/scripts/aid-batch/identity-batch.mjs +1 -1
  417. package/dist/agents/baseagent-availability.js +0 -176
  418. package/dist/agents/baseagent-capability-adapter.js +0 -102
  419. package/dist/agents/baseagent-plugin-loader.js +0 -145
  420. package/dist/agents/baseagent.js +0 -816
  421. package/dist/agents/codex/catalog.js +0 -80
  422. package/dist/agents/ecagent-plugin-lazy.js +0 -41
  423. package/dist/agents/tool-time-context.js +0 -55
  424. package/dist/core/legacy-rename.js +0 -41
  425. package/dist/core/plugin-lifecycle.js +0 -137
  426. package/dist/core/rate-window.js +0 -53
  427. package/dist/core/runner-reload-transaction.js +0 -60
  428. package/dist/core/runtime-lock.js +0 -90
  429. package/dist/core/soul.js +0 -66
  430. package/dist/core/system-session/grants.js +0 -40
  431. package/dist/directory/owner-directory-agentmd-sync.js +0 -89
  432. package/dist/directory/owner-directory-request-operation.js +0 -79
  433. package/dist/directory/owner-directory-text.js +0 -60
  434. package/kits/skills/ec-pay/references/pay-cli.md +0 -110
  435. /package/dist/agents/gemini/{gemini-capability-provider.js → capability-provider.js} +0 -0
  436. /package/dist/agents/gemini/{gemini-session-file-adapter.js → session-file-adapter.js} +0 -0
  437. /package/dist/{agents/claude-gateway → claude-gateway}/types.js +0 -0
  438. /package/dist/core/{system-channels.js → channel/system-channels.js} +0 -0
  439. /package/dist/core/{daemon-file-cache.js → daemon/daemon-file-cache.js} +0 -0
  440. /package/dist/core/{event-bus.js → event/event-bus.js} +0 -0
  441. /package/dist/core/{event-catalog.js → event/event-catalog.js} +0 -0
  442. /package/dist/core/{pack-ledger.js → pack/pack-ledger.js} +0 -0
  443. /package/dist/directory/{owner-directory-identity.js → identity.js} +0 -0
  444. /package/dist/directory/{owner-directory-policy.js → policy.js} +0 -0
  445. /package/dist/directory/{owner-directory-remarks.js → remarks.js} +0 -0
  446. /package/dist/directory/{owner-directory-scope.js → scope.js} +0 -0
  447. /package/dist/{contracts → ecweb/contracts}/ecweb-instance.js +0 -0
  448. /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,17 +12,17 @@ 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
27
  /**
28
28
  * 服务调用的默认等待时长,也是请求消息的 TTL。
@@ -31,6 +31,14 @@ import { hardenServicesAcl, planServicesAclRepair, readServicesAcl } from '../co
31
31
  * 等多久。TTL 更长就意味着"调用方已经放弃、消息还活着",重建了这套设计要去掉
32
32
  * 的补投语义;TTL 更短则调用方还在等、消息已经没了。
33
33
  */
34
+ /**
35
+ * `call --local` 模拟的调用方角色。
36
+ *
37
+ * 不能用自己的身份:本机对自身必然是 owner,owner+bypass 会免掉沙箱,自测就永远
38
+ * 看不到脚本在沙箱里的真实表现。`member` 走 auto 档,沙箱照常生效,与一个普通
39
+ * 外部调用者的路径最接近。
40
+ */
41
+ export const LOCAL_CALL_ROLE = 'member';
34
42
  export const SERVICE_CALL_TIMEOUT_MS = 12_000;
35
43
  export const SERVICE_CALL_TTL_SECONDS = Math.ceil(SERVICE_CALL_TIMEOUT_MS / 1_000);
36
44
  const HELP = `ec services — 服务路由运维
@@ -135,6 +143,13 @@ export function parseServicesArgv(argv) {
135
143
  args.splice(args.indexOf('--encrypted'), 1);
136
144
  }
137
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
+ }
138
153
  if (args.includes('--purge')) {
139
154
  parsed.purge = true;
140
155
  args.splice(args.indexOf('--purge'), 1);
@@ -144,8 +159,9 @@ export function parseServicesArgv(argv) {
144
159
  args.splice(args.indexOf('--deny'), 1);
145
160
  }
146
161
  if (args.includes('--force')) {
147
- // 覆盖安装已取消:重装前必须先 `pack remove`。识别出来是为了给明确提示。
148
- 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"' };
149
165
  }
150
166
  const positional = args.filter(item => !item.startsWith('-'));
151
167
  if (command === 'pack') {
@@ -221,6 +237,12 @@ function resolveAid(deps, parsed) {
221
237
  const live = peekServiceRouter(parsed.aid);
222
238
  return { aid: parsed.aid, router: live ?? deps.create(parsed.aid) };
223
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
+ }
224
246
  const aids = deps.listAids?.() ?? [];
225
247
  if (aids.length === 1) {
226
248
  const live = peekServiceRouter(aids[0]);
@@ -280,18 +302,86 @@ export function createServicesOperationExecutor(deps) {
280
302
  }
281
303
  };
282
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
+ }
283
343
  async function execute(deps, parsed) {
284
344
  const { command } = parsed;
285
345
  if (command === 'help')
286
346
  return { ok: true, result: { help: HELP } };
287
347
  // 对端调用单独走:目标是**远端**,本机不为它解析 router。
288
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
+ }
289
357
  if (command === 'call' || command === 'describe' || command === 'schema') {
290
358
  const targetAid = parsed.aid;
291
359
  if (!targetAid) {
292
360
  return { ok: false, code: 'INVALID_ARGV', error: `${command} requires --aid <target-aid>` };
293
361
  }
294
- const sender = stripAidPrefix(parsed.as ?? parsed.caller?.selfAid ?? deps.defaultAid?.());
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?.());
295
385
  if (!sender) {
296
386
  return {
297
387
  ok: false,
@@ -310,6 +400,12 @@ async function execute(deps, parsed) {
310
400
  return { ok: false, code: auth.code, error: auth.error };
311
401
  return await runCall(deps, sender, callParsed);
312
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
+ }
313
409
  const target = resolveAid(deps, parsed);
314
410
  if (target.error)
315
411
  return target.error;
@@ -446,11 +542,21 @@ async function execute(deps, parsed) {
446
542
  return { ok: false, code: 'INVALID_ARGV', error: `reload does not accept a pack name (reloads all packs): ${parsed.pack}` };
447
543
  }
448
544
  const live = peekServiceRouter(aid);
449
- if (live)
450
- live.reload();
451
- else
452
- router.reload();
453
- 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
+ };
454
560
  }
455
561
  case 'enable':
456
562
  case 'disable':
@@ -465,16 +571,47 @@ async function execute(deps, parsed) {
465
571
  }
466
572
  if (!parsed.pack)
467
573
  return { ok: false, code: 'INVALID_ARGV', error: `pack ${parsed.action ?? ''} requires <包名>` };
468
- if (parsed.action === 'add') {
574
+ if (parsed.action === 'add' || parsed.action === 'update') {
575
+ const isUpdate = parsed.action === 'update';
469
576
  if (!parsed.from)
470
- return { ok: false, code: 'INVALID_ARGV', error: 'pack add requires --from <源目录>' };
471
- const installed = installPack({
472
- sourceDir: parsed.from,
473
- targetRoot: servicesDirForPack,
474
- name: parsed.pack,
475
- manifestFile: PACK_JSON,
476
- legacyManifestFile: 'service.json',
477
- });
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
+ }
478
615
  // 首次装包沿用 Agent 的默认开启策略。已有配置(包括显式关闭)原样保留,
479
616
  // 装包不能顺带修改总闸;请求仍经过准入、权限、限流与沙箱检查。
480
617
  const routerPath = path.join(servicesDirForPack, SERVICES_CONFIG_JSON);
@@ -488,13 +625,47 @@ async function execute(deps, parsed) {
488
625
  createdRouter = true;
489
626
  }
490
627
  const live = peekServiceRouter(aid);
491
- if (live)
492
- live.reload();
493
- else
494
- 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);
495
664
  // 配置存在但坏了:装包成功、总闸却回落到 enabled=false,业务消息全被静默丢弃。
496
665
  // 不替用户改文件,但必须把原因带回去。
497
666
  const configErrors = createdRouter ? [] : loadRouterConfig(servicesDirForPack).errors;
667
+ const issues = packStateIssues(afterReload, beforeReload, parsed.pack);
668
+ const warning = packIssueWarning(issues);
498
669
  // ACL 加固:新包目录与 services 根都要收口。失败不阻断安装——包已经 rename
499
670
  // 到位,加固只是加一层兜底;把原因带回去,`doctor` 也会持续报。
500
671
  const acl = hardenServicesAcl(servicesDirForPack);
@@ -507,6 +678,8 @@ async function execute(deps, parsed) {
507
678
  aid, ...installed,
508
679
  ...(createdRouter ? { createdRouter: true } : {}),
509
680
  ...(configErrors.length > 0 ? { configErrors } : {}),
681
+ ...issues,
682
+ ...(warning ? { warning } : {}),
510
683
  ...(acl.errors.length > 0 ? { aclErrors: acl.errors } : {}),
511
684
  },
512
685
  };
@@ -535,11 +708,12 @@ async function execute(deps, parsed) {
535
708
  packId: parsed.pack,
536
709
  });
537
710
  const live = peekServiceRouter(aid);
538
- if (live)
539
- live.reload();
540
- else
541
- router.reload();
542
- 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 } : {}) } };
543
717
  }
544
718
  return { ok: false, code: 'UNKNOWN_COMMAND', error: `unknown pack action: ${parsed.action ?? '(none)'}
545
719
  ${HELP}` };
@@ -559,13 +733,88 @@ async function runCall(deps, selfAid, parsed) {
559
733
  // `@` 前缀只是展示习惯(名片里那样写),AID 本身不带。不在这里剥掉就会原样
560
734
  // 交给消息层,被 AID 校验拒成 "must be 4-64 characters"。
561
735
  const targetAid = stripAidPrefix(parsed.pack);
562
- if (!targetAid)
736
+ // `--local` 不走网络,--aid 无意义;要求它反而会让人以为在调别人。
737
+ if (!parsed.local && !targetAid) {
563
738
  return { ok: false, code: 'INVALID_ARGV', error: `${parsed.command} requires --aid <target-aid>` };
739
+ }
564
740
  // 调自己:消息会发出去,但入站侧没有任何分支会应答它,只能干等满超时(默认 30s)
565
741
  // 然后报一个看起来像对端故障的 NO_RESULT。前置拒绝,别让人等。
566
- if (normalizeAid(targetAid) === normalizeAid(selfAid)) {
742
+ if (!parsed.local && targetAid && normalizeAid(targetAid) === normalizeAid(selfAid)) {
567
743
  return { ok: false, code: 'INVALID_ARGV', error: 'cannot call self: <aid> is this daemon\'s own AID' };
568
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
+ }
569
818
  const channel = deps.getChannel?.(selfAid);
570
819
  if (!channel?.sendDaemonMsg) {
571
820
  return { ok: false, code: 'NOT_CONFIGURED', error: `no AUN channel is connected for ${selfAid}` };
@@ -585,6 +834,12 @@ async function runCall(deps, selfAid, parsed) {
585
834
  : parsed.type
586
835
  ? { service: parsed.type }
587
836
  : {};
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
+ : [];
588
843
  const timeoutMs = parsed.timeoutMs ?? SERVICE_CALL_TIMEOUT_MS;
589
844
  // TTL 必须由本次等待时长推导:消息在网关活多久,调用方就等多久。多一秒都是
590
845
  // 给"对端稍后上线还能捡到这条请求"留口子,那正是这套设计要去掉的补投语义。
@@ -595,7 +850,8 @@ async function runCall(deps, selfAid, parsed) {
595
850
  prepared = registry.prepare({
596
851
  selfAid,
597
852
  targetAid,
598
- payload: { type: requestType, ...data, service_deadline_at_ms: Date.now() + timeoutMs },
853
+ // 顺序有语义:信封字段展开在 data **之后**,即使将来放开了 data 校验也不会被覆盖。
854
+ payload: { ...data, type: requestType, service_deadline_at_ms: Date.now() + timeoutMs },
599
855
  timeoutMs,
600
856
  });
601
857
  }
@@ -628,13 +884,22 @@ async function runCall(deps, selfAid, parsed) {
628
884
  return { ok: false, code: 'NO_RESULT', error: 'request record disappeared', result: { request_id: prepared.requestId } };
629
885
  }
630
886
  if (record.state === 'completed' && record.responsePayload) {
631
- return { ok: true, result: { ...summarizeRecord(record), 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
+ };
632
897
  }
633
898
  if (record.state === 'failed') {
634
899
  return { ok: false, code: 'REQUEST_FAILED', error: `request ${prepared.requestId} failed`, result: summarizeRecord(record) };
635
900
  }
636
901
  // 等到超时:把记录钉成终态,迟到的应答再也改不动它(resolveIncoming 只接受
637
- // 非终态记录)。`wait()` 自己只会落到 pending —— 那是 `ec msg send` 需要的
902
+ // 非终态记录)。`wait()` 自己只会落到 pending —— 那是 `ecmsg send --return required` 需要的
638
903
  // "稍后还能补上"的语义,服务调用不需要。
639
904
  const expired = registry.markFailed(selfAid, prepared.requestId, 'no response before deadline') ?? record;
640
905
  return {
@@ -11,8 +11,8 @@ import fs from 'node:fs';
11
11
  import path from 'node:path';
12
12
  import { sha256 } from '../trigger/validation.js';
13
13
  import { requiresSatisfied, validateServiceJson } from './validation.js';
14
- import { migrateLegacyFileName } from '../core/legacy-rename.js';
15
- import { PACK_ARCHIVED_MARKER } from '../core/pack-install.js';
14
+ import { migrateLegacyFileName } from '../core/migration/data-migration.js';
15
+ import { PACK_ARCHIVED_MARKER } from '../core/pack/pack-install.js';
16
16
  /**
17
17
  * 服务包声明文件。与事件包统一叫 `pack.json`(不留 `service.json` 别名):
18
18
  * 包主要由 agent 生成,两侧同名能省掉一次"这里该写哪个名"的判断。
@@ -9,8 +9,7 @@ import path from 'node:path';
9
9
  import { ServiceError } from './types.js';
10
10
  import { atomicWriteJson } from '../utils/atomic-write.js';
11
11
  import { validateRouterConfig } from './validation.js';
12
- import { migrateLegacyFileName } from '../core/legacy-rename.js';
13
- import { RateWindow } from '../core/rate-window.js';
12
+ import { migrateLegacyFileName } from '../core/migration/data-migration.js';
14
13
  import { RESERVED_TYPES } from './service-payload.js';
15
14
  export const SERVICES_CONFIG_JSON = 'services-config.json';
16
15
  export const DEFAULT_ROUTER_CONFIG = {
@@ -65,10 +64,51 @@ export function loadRouterConfig(servicesDir) {
65
64
  return { config: defaultConfig(false), exists: true, errors: validated.errors };
66
65
  return { config: validated.value, exists: true, errors: [] };
67
66
  }
67
+ const MINUTE_MS = 60_000;
68
+ const HOUR_MS = 3_600_000;
69
+ export class RateWindow {
70
+ windows = new Map();
71
+ /** 记一次消费;超限时不计数并给出 retryAfter。 */
72
+ consume(key, quota, now = Date.now()) {
73
+ let window = this.windows.get(key);
74
+ if (!window) {
75
+ window = { minuteStart: now, minuteCount: 0, hourStart: now, hourCount: 0 };
76
+ this.windows.set(key, window);
77
+ }
78
+ if (now - window.minuteStart >= MINUTE_MS) {
79
+ window.minuteStart = now;
80
+ window.minuteCount = 0;
81
+ }
82
+ if (now - window.hourStart >= HOUR_MS) {
83
+ window.hourStart = now;
84
+ window.hourCount = 0;
85
+ }
86
+ if (window.minuteCount >= quota.perMinute) {
87
+ return { allow: false, retryAfter: Math.max(1, Math.ceil((window.minuteStart + MINUTE_MS - now) / 1000)) };
88
+ }
89
+ if (window.hourCount >= quota.perHour) {
90
+ return { allow: false, retryAfter: Math.max(1, Math.ceil((window.hourStart + HOUR_MS - now) / 1000)) };
91
+ }
92
+ window.minuteCount++;
93
+ window.hourCount++;
94
+ return { allow: true };
95
+ }
96
+ /** 定期清理空窗口,避免长期运行后按 AID 无限增长。 */
97
+ prune(now = Date.now()) {
98
+ for (const [key, window] of this.windows) {
99
+ if (now - window.hourStart >= HOUR_MS && now - window.minuteStart >= HOUR_MS)
100
+ this.windows.delete(key);
101
+ }
102
+ }
103
+ /** 清空全部窗口(配置切换 / 关闭时)。 */
104
+ reset() {
105
+ this.windows.clear();
106
+ }
107
+ }
68
108
  /**
69
109
  * 服务侧限流:`builtin` / `service` 两套额度,按 (bucket, fromAid) 独立计数。
70
110
  *
71
- * 窗口算法复用 `src/core/rate-window.ts`——事件侧用的是同一份。这里曾经是一份完整
111
+ * 窗口算法由本模块导出,事件侧复用同一份。这里曾经是一份完整
72
112
  * 复制,两份各自漂移的话,限流行为不一致比没有限流更难排查。
73
113
  */
74
114
  export class RateLimiter {