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
@@ -0,0 +1,117 @@
1
+ /**
2
+ * 宿主进程的沙箱启动配置。
3
+ *
4
+ * 设计稿:`docs/services/resident-mode.md` §3.2、§六。
5
+ *
6
+ * ## 为什么复用 `buildTriggerScriptLaunch` 而不是新写一套策略
7
+ *
8
+ * 宿主程序在沙箱看来**就是一个脚本**:它有一个入口文件、需要被暂存到运行目录、
9
+ * 需要一个可写的 workDir、需要读自己的程序目录。区别只有两点:
10
+ *
11
+ * 1. 它有第二个能力——spawn 子进程(而脚本不 spawn);
12
+ * 2. 它的探针必须验证**孙进程**也在围栏里,而脚本的探针只验直接子进程。
13
+ *
14
+ * 第 1 点不需要任何策略改动:沙箱是加在宿主进程上的,子进程继承(已实测 EPERM)。
15
+ * 第 2 点只需要换探针,不需要换策略。所以本模块只做两件事:构造合成 trigger、指定探针。
16
+ *
17
+ * **绝不能另写一套策略构造**:两份策略必然漂移,而漂移的表现是「某条 deny 悄悄没了」,
18
+ * 这是最难发现、后果最严重的一类缺陷。
19
+ */
20
+ import path from 'node:path';
21
+ import { buildTriggerScriptLaunch, } from '../trigger/script-sandbox.js';
22
+ import { isCredentialEnvironmentName, sanitizeShellExecutionEnvironment } from '../core/permission/shell-environment.js';
23
+ import { resolvePhaseOneExecutionSandbox } from '../core/permission/mode.js';
24
+ /**
25
+ * 合成一个「宿主」trigger。
26
+ *
27
+ * 只用于喂给沙箱构造函数——它不是真实的 trigger,不落盘、不进 trigger 列表。
28
+ * `id` 里带 version,使无沙箱路径的日志能看出在跑哪个宿主版本。
29
+ */
30
+ function syntheticHostTrigger(input, executable) {
31
+ return {
32
+ $schema_version: 3.1,
33
+ id: `services-host:${input.aid}:${path.basename(input.programDir)}`,
34
+ agentAid: input.aid,
35
+ name: '服务常驻宿主',
36
+ enabled: true,
37
+ createdAt: 0,
38
+ updatedAt: 0,
39
+ labels: { kind: 'services-host' },
40
+ source: { type: 'event', eventPattern: '*' },
41
+ execution: {
42
+ type: 'script',
43
+ script: {
44
+ path: path.basename(input.programEntry),
45
+ runtime: executable,
46
+ args: [],
47
+ // 宿主是长跑进程:这里的 timeoutMs 由沙箱构造函数用于探针预算,不用于杀宿主。
48
+ timeoutMs: 300_000,
49
+ },
50
+ onError: 'fail',
51
+ noopSentinel: '[[NOOP]]',
52
+ },
53
+ };
54
+ }
55
+ /**
56
+ * 构造宿主进程的启动配置。
57
+ *
58
+ * 与脚本同样的两条路径:`fullaccess` / `bypass+owner` → 无沙箱;否则 → scoped 沙箱。
59
+ * 无沙箱时 `sandboxAbsent` 会被带上,调用方必须据此写台账——宿主是全生命周期无沙箱,
60
+ * 比一次调用的降级严重得多(设计稿 6.5)。
61
+ */
62
+ /**
63
+ * 无沙箱宿主的环境变量:清洗掉凭据后继承,再叠加调用方给的基础 env。
64
+ *
65
+ * 与一次性路径 `buildUnsandboxedLaunch` 同口径(同为「无文件隔离,但秘密要洗」)。
66
+ * 注意宿主是长跑进程:这里漏掉一个凭据变量,泄漏面是**整个宿主生命周期**而不是一次调用。
67
+ */
68
+ function buildUnsandboxedHostEnv(extra) {
69
+ const env = {};
70
+ for (const [key, value] of Object.entries(sanitizeShellExecutionEnvironment(process.env))) {
71
+ if (typeof value !== 'string')
72
+ continue;
73
+ if (key.toUpperCase().startsWith('EVOLCORE_'))
74
+ continue;
75
+ if (isCredentialEnvironmentName(key))
76
+ continue;
77
+ env[key] = value;
78
+ }
79
+ return { ...env, ...extra };
80
+ }
81
+ export async function buildHostLaunch(input) {
82
+ const authorization = {
83
+ allowed: true,
84
+ scope: 'agent',
85
+ permissionMode: input.permissionMode,
86
+ role: input.role,
87
+ };
88
+ const executable = process.execPath;
89
+ // 无沙箱路径必须先判:`buildTriggerScriptLaunch` 在 fullaccess 下**直接抛错**
90
+ // (它不接受"请求了 scoped 但档位是 fullaccess"),所以不能让它兜底。
91
+ // 语义与一次性路径一致:fullaccess / bypass+owner → 免沙箱并留痕。
92
+ const sandboxDecision = resolvePhaseOneExecutionSandbox(input.permissionMode, input.role);
93
+ if (sandboxDecision.state === 'off') {
94
+ const reason = sandboxDecision.reason === 'fullaccess' ? 'fullaccess' : 'owner-bypass';
95
+ return {
96
+ command: executable,
97
+ args: [input.programEntry],
98
+ cwd: input.programDir,
99
+ env: buildUnsandboxedHostEnv(input.env),
100
+ sandboxAbsent: reason,
101
+ };
102
+ }
103
+ const launch = await buildTriggerScriptLaunch({
104
+ trigger: syntheticHostTrigger(input, executable),
105
+ triggerDir: input.programDir,
106
+ scriptPath: input.programEntry,
107
+ scriptArgs: [],
108
+ projectPath: input.projectPath,
109
+ executionAuthorization: authorization,
110
+ // 宿主会再 spawn 脚本次进程:必须验证孙进程也在围栏里(设计稿 6.2)。
111
+ verifyGrandchild: true,
112
+ ...(input.extraReadRoots ? { extraReadRoots: input.extraReadRoots } : {}),
113
+ ...(input.extraWriteRoots ? { extraWriteRoots: input.extraWriteRoots } : {}),
114
+ ...(input.signal ? { signal: input.signal } : {}),
115
+ });
116
+ return { ...launch, env: { ...launch.env, ...input.env } };
117
+ }
@@ -0,0 +1,208 @@
1
+ /**
2
+ * 计划内自愈重启:**间隔**(该不该换)与**时机**(等到何时换)是两层。
3
+ *
4
+ * 设计稿:`docs/services/resident-mode.md` §3.8.2。
5
+ *
6
+ * ## 为什么必须分两层
7
+ *
8
+ * 宿主是常驻的,长跑必然累积泄漏(句柄未关、定时器未清、Buffer 池涨)。但重启会打断
9
+ * 在途调用,所以不能「到点就换」。正确形态是:
10
+ *
11
+ * 1. **间隔 / 泄漏信号**只负责「置位该换了」(`pendingRestart`);
12
+ * 2. **空闲窗口**负责真正执行——等到连续 5 分钟没有在途调用才换。
13
+ *
14
+ * 混为一谈有两种错误方向,都踩过:
15
+ *
16
+ * - **到点就硬重启**:繁忙宿主上反复打断调用,调用方不断拿到 `SERVICES_HOST_RESTARTING`;
17
+ * - **把空闲当退出用**:稀疏流量(每 6 分钟一次)每次调用都要重新付约 1 秒沙箱税,
18
+ * 常驻模式的收益被完全吃光。1 小时那个是**空闲回收**(进程销毁),不是这里。
19
+ *
20
+ * ## 长跑不停机怎么办
21
+ *
22
+ * 一个包如果持续繁忙、永远凑不出 5 分钟空闲,重启就永远不发生。所以有 `forceAfterMs`
23
+ * 兜底:置位后最多等 2 小时,到期强制排空重启。正常情况下不该触发。
24
+ */
25
+ export const DEFAULT_RECYCLE_POLICY = {
26
+ intervalTiersMs: [8 * 3600_000, 4 * 3600_000, 2 * 3600_000, 3600_000, 1800_000],
27
+ rssGrowthFactor: 2,
28
+ rssAbsoluteBytes: 300 * 1024 * 1024,
29
+ handleGrowth: 100,
30
+ idleCpuPercent: 5,
31
+ cpuStreakRequired: 3,
32
+ idleWindowMs: 5 * 60_000,
33
+ forceAfterMs: 2 * 3600_000,
34
+ tierEscalationWindows: [1, 2, 3, 4],
35
+ tierResetAfterMs: 24 * 3600_000,
36
+ };
37
+ export class HostRecycleController {
38
+ policy;
39
+ tier = 0;
40
+ /** 基线:宿主启动后稳定时的水位。泄漏判据都相对它。 */
41
+ baseline;
42
+ /**
43
+ * 启动时间。
44
+ *
45
+ * **不能用 0 当"未启动"哨兵**:epoch 毫秒里 0 是合法值(测试与某些虚拟时钟会传它),
46
+ * 那样 `onTick` 会永远以为宿主没启动过。用 `undefined` 表达"未启动"。
47
+ */
48
+ startedAt;
49
+ /** 置位时间;0 表示未置位。 */
50
+ pendingSince = 0;
51
+ pendingReason = '';
52
+ /** 历史上触发重启的时间戳,用于等级升降。 */
53
+ recycleStamps = [];
54
+ /**
55
+ * 最后一次**观察到泄漏信号**的时间,用于等级回落。
56
+ *
57
+ * 判据用「多久没见过泄漏」而不是「多久没重启」:间隔到点的**计划内重启不算脏**,
58
+ * 否则每 8 小时一次的例行更换就会把干净期清零,等级永远降不下来。
59
+ */
60
+ lastLeakAt = 0;
61
+ /** 连续多少次空闲采样超过 CPU 阈值(见 `cpuStreakRequired`)。 */
62
+ cpuStreak = 0;
63
+ constructor(policy = {}) {
64
+ this.policy = { ...DEFAULT_RECYCLE_POLICY, ...policy };
65
+ }
66
+ get currentTier() {
67
+ return this.tier;
68
+ }
69
+ get currentIntervalMs() {
70
+ return this.policy.intervalTiersMs[Math.min(this.tier, this.policy.intervalTiersMs.length - 1)];
71
+ }
72
+ get isPending() {
73
+ return this.pendingSince !== 0;
74
+ }
75
+ /** 当前置位的原因(未置位时为空串)。 */
76
+ get pendingRestartReason() {
77
+ return this.pendingReason;
78
+ }
79
+ /**
80
+ * 宿主启动时调用:起点与基线都要重置。
81
+ *
82
+ * **基线无条件覆盖**(没传就清空,由启动后第一份采样重新设定)。以前是「传了才覆盖」,
83
+ * 于是宿主重启后沿用**上一个进程**的 rss/handles 基线:新进程一上来就比旧基线大一截,
84
+ * 泄漏判据立刻置位,把一次正常的重启变成「刚起来就该换」。
85
+ */
86
+ markStarted(nowMs, baseline) {
87
+ this.startedAt = nowMs;
88
+ this.pendingSince = 0;
89
+ this.pendingReason = '';
90
+ this.cpuStreak = 0;
91
+ this.baseline = baseline;
92
+ }
93
+ /** 用启动后第一份稳定采样设定基线(只设一次)。 */
94
+ seedBaseline(snapshot) {
95
+ if (!this.baseline)
96
+ this.baseline = snapshot;
97
+ }
98
+ /**
99
+ * 外部请求重启(例如:宿主程序版本变了、包脚本内容变了)。
100
+ *
101
+ * 只是**置位**,仍然要走空闲窗口才会真正执行——这和间隔到点是同一条路径。
102
+ * 不走这条路的话,热重载会在有调用在飞的时候硬重启,把 `SERVICES_HOST_RESTARTING`
103
+ * 糊到调用方脸上;而热重载本该是运维动作,不该产生用户可见错误。
104
+ */
105
+ requestRecycle(nowMs, reason) {
106
+ if (this.pendingSince !== 0)
107
+ return; // 已置位:保留最早的原因,避免反复覆盖
108
+ this.pendingSince = nowMs;
109
+ this.pendingReason = reason;
110
+ }
111
+ /**
112
+ * 每次调用结束后推进一次。
113
+ *
114
+ * @param idleForMs 当前已连续空闲多久(0 表示刚有调用结束/正在忙)
115
+ */
116
+ onTick(nowMs, snapshot, idleForMs) {
117
+ if (this.startedAt === undefined)
118
+ return { action: 'none' };
119
+ if (!this.baseline)
120
+ this.baseline = snapshot;
121
+ // 等级回落先判:它依赖「距上次泄漏信号多久」,与是否正要重启无关。
122
+ // 放在下面能保证即使宿主繁忙、间隔一直触发,回落也不会被跳过。
123
+ if (this.tier > 0 && this.lastLeakAt > 0
124
+ && nowMs - this.lastLeakAt >= this.policy.tierResetAfterMs) {
125
+ this.tier -= 1;
126
+ // 回落一级后重新计时:连续干净 48 小时才再降一级,不是一次性掉到底。
127
+ this.lastLeakAt = nowMs;
128
+ }
129
+ // 第一层:是否需要换
130
+ if (this.pendingSince === 0) {
131
+ const leak = this.detectLeak(snapshot);
132
+ if (leak) {
133
+ this.pendingSince = nowMs;
134
+ this.pendingReason = leak;
135
+ this.lastLeakAt = nowMs;
136
+ }
137
+ else if (nowMs - this.startedAt >= this.currentIntervalMs) {
138
+ this.pendingSince = nowMs;
139
+ this.pendingReason = `uptime reached tier ${this.tier} interval (${Math.round(this.currentIntervalMs / 60000)}min)`;
140
+ }
141
+ else {
142
+ return { action: 'none' };
143
+ }
144
+ }
145
+ // 第二层:等到空闲才换
146
+ const waitedMs = nowMs - this.pendingSince;
147
+ const forced = waitedMs >= this.policy.forceAfterMs;
148
+ if (idleForMs < this.policy.idleWindowMs && !forced) {
149
+ return { action: 'pending', reason: this.pendingReason, waitedMs };
150
+ }
151
+ const reason = forced
152
+ ? `${this.pendingReason}; forced after ${Math.round(waitedMs / 60000)}min without idle window`
153
+ : this.pendingReason;
154
+ this.recordRecycle(nowMs);
155
+ return { action: 'recycle', reason, tier: this.tier };
156
+ }
157
+ /** 泄漏判定:返回原因字符串,没有泄漏返回 undefined。 */
158
+ detectLeak(snapshot) {
159
+ const base = this.baseline;
160
+ if (!base)
161
+ return undefined;
162
+ if (snapshot.handles - base.handles >= this.policy.handleGrowth) {
163
+ return `handle leak: ${snapshot.handles} vs baseline ${base.handles}`;
164
+ }
165
+ if (snapshot.rss > base.rss * this.policy.rssGrowthFactor
166
+ && snapshot.rss > this.policy.rssAbsoluteBytes) {
167
+ return `memory growth: ${Math.round(snapshot.rss / 1048576)}MB vs baseline ${Math.round(base.rss / 1048576)}MB`;
168
+ }
169
+ // CPU 判据只在**真正空闲**时成立:有调用在跑时 CPU 高是它该有的样子。
170
+ // 早期版本漏了这个前提,结果每个有流量的宿主都会被判成"空转定时器"。
171
+ if (snapshot.inFlight === 0 && snapshot.idleCpuPercent > this.policy.idleCpuPercent) {
172
+ this.cpuStreak += 1;
173
+ // 连续多次才认:单次偏高可能只是 GC、磁盘抖动、机器负载。
174
+ if (this.cpuStreak >= this.policy.cpuStreakRequired) {
175
+ return `idle CPU ${snapshot.idleCpuPercent}% sustained for ${this.cpuStreak} samples suggests a spinning timer or poller`;
176
+ }
177
+ }
178
+ else {
179
+ this.cpuStreak = 0;
180
+ }
181
+ return undefined;
182
+ }
183
+ /** 记录一次计划内重启:推进等级。 */
184
+ recordRecycle(nowMs) {
185
+ this.pendingSince = 0;
186
+ this.pendingReason = '';
187
+ this.recycleStamps.push(nowMs);
188
+ // 只统计最近 24 小时。
189
+ while (this.recycleStamps.length > 0 && nowMs - this.recycleStamps[0] > this.policy.tierResetAfterMs) {
190
+ this.recycleStamps.shift();
191
+ }
192
+ const count = this.recycleStamps.length;
193
+ const nextTier = this.policy.tierEscalationWindows.filter(threshold => count >= threshold).length;
194
+ this.tier = Math.min(nextTier, this.policy.intervalTiersMs.length - 1);
195
+ }
196
+ /** 观测用:24 小时内计划内重启次数。 */
197
+ get recycleCount24h() {
198
+ return this.recycleStamps.length;
199
+ }
200
+ /** 观测用:距离下次因时长而置位还有多久;已置位返回 0。 */
201
+ msUntilInterval(nowMs) {
202
+ if (this.pendingSince !== 0)
203
+ return 0;
204
+ if (this.startedAt === undefined)
205
+ return this.currentIntervalMs;
206
+ return Math.max(0, this.currentIntervalMs - (nowMs - this.startedAt));
207
+ }
208
+ }