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,397 @@
1
+ /**
2
+ * 服务常驻宿主程序。
3
+ *
4
+ * 设计稿:`docs/services/resident-mode.md` §三、§4.1、§五。
5
+ *
6
+ * 由 daemon 以 `node <program>/main.js` 拉起(在沙箱内),之后长期存活。
7
+ * 一个 agent 一个实例,服务该 agent 的全部服务包。
8
+ *
9
+ * ## 只做四件事
10
+ *
11
+ * 1. 从 stdin 读换行分隔的帧;
12
+ * 2. `call` 帧 → 异步 spawn 一个子进程,按 `callId` 记账,**不阻塞**接收下一帧;
13
+ * 3. 子进程结束 / 超时 → 写一条 `result` 帧;
14
+ * 4. `ping` → 立刻回 `pong`;stdin EOF → 终止全部子进程并在 5 秒内退出。
15
+ *
16
+ * ## 刻意不做的事
17
+ *
18
+ * - **不解析脚本 stdout 的语义**。末行 JSON、`[[NOOP]]`、`HANDLER_PROTOCOL` 判定全部留在
19
+ * daemon 侧(`script-runner`),与一次性路径共用一份实现。宿主只搬运原始文本。
20
+ * - **不认识 `EC_*`**。环境变量由 daemon 算好整个传下来。
21
+ * - **不做业务级重试**。失败就是失败,重试是调用方的事。
22
+ *
23
+ * ## 硬约束
24
+ *
25
+ * - **不许有同步阻塞 I/O**:一旦阻塞事件循环,保活 ping 就会排队,daemon 会把一个健康的
26
+ * 宿主判成卡死并重启(连带杀掉在途调用)。所以本文件里没有任何 `*Sync` 调用。
27
+ * - **stdout 只写帧**,任何诊断信息走 stderr。
28
+ */
29
+ import { spawn } from 'node:child_process';
30
+ import fs from 'node:fs';
31
+ import path from 'node:path';
32
+ import { CHILD_OUTPUT_LIMIT_BYTES, FrameSplitter, HOST_PROGRAM_VERSION, encodeFrame, decodeFrame, } from './protocol.js';
33
+ import { ResidentHost, RESIDENT_HARD_TIMEOUT_AFTER } from './resident.js';
34
+ /** 收到 EOF 后的自毁期限。防某个卡住的子进程把宿主拖住不退。 */
35
+ const EOF_SELF_DESTRUCT_MS = 5000;
36
+ /**
37
+ * 自省采样周期。
38
+ *
39
+ * 10 秒足够让 daemon 在「泄漏已经明显」时及时介入,又不会让长跑宿主产生可观测的
40
+ * 额外开销(一次采样是三个同步 API,微秒级)。
41
+ */
42
+ const STATS_INTERVAL_MS = 10_000;
43
+ /**
44
+ * 采样周期的运行时覆盖。
45
+ *
46
+ * 只为两件事存在:运维现场调参与自动化测试(等 10 秒一次的采样在测试里不可接受)。
47
+ * 非法值静默回落到默认——采样周期配错不该让宿主起不来。
48
+ */
49
+ function statsIntervalMs() {
50
+ const raw = Number(process.env.EVOLCORE_HOST_STATS_MS);
51
+ return Number.isFinite(raw) && raw >= 100 ? Math.min(raw, 600_000) : STATS_INTERVAL_MS;
52
+ }
53
+ /** 统计口径。 */
54
+ let callsCompleted = 0;
55
+ const inFlight = new Map();
56
+ let shuttingDown = false;
57
+ /** 形态 B 的常驻子进程池(每个 residentKey 一个进程)。 */
58
+ const resident = new ResidentHost({ log: message => logToStderr(message) });
59
+ /** 写一帧到 stdout。只在这里碰 stdout,别处一律 stderr。 */
60
+ function writeFrame(frame) {
61
+ if (shuttingDown && frame.t !== 'result')
62
+ return;
63
+ try {
64
+ process.stdout.write(encodeFrame(frame));
65
+ }
66
+ catch {
67
+ // stdout 已关闭(daemon 退出了):没什么可做的,自毁定时器会收尾。
68
+ }
69
+ }
70
+ function logToStderr(message) {
71
+ try {
72
+ process.stderr.write(`[host] ${message}\n`);
73
+ }
74
+ catch {
75
+ /* ignore */
76
+ }
77
+ }
78
+ /** 杀掉子进程。Windows 上没有进程组信号,用 kill 逐个尽力而为。 */
79
+ function killChild(child) {
80
+ try {
81
+ if (child.pid) {
82
+ child.kill('SIGKILL');
83
+ }
84
+ }
85
+ catch {
86
+ /* already gone */
87
+ }
88
+ }
89
+ /**
90
+ * 逐块累积输出,超过上限就标记并杀进程。
91
+ *
92
+ * 与 `script-runner` 的口径一致:**超限是失败,不是截断**(截断会让脚本以为成功)。
93
+ */
94
+ function accumulate(state, chunk) {
95
+ if (state.truncated)
96
+ return;
97
+ state.bytes += chunk.length;
98
+ if (state.bytes > CHILD_OUTPUT_LIMIT_BYTES) {
99
+ state.truncated = true;
100
+ killChild(state.child);
101
+ return;
102
+ }
103
+ const text = chunk.toString('utf8');
104
+ // 只保留前 1 MiB:即使超限,也要回传已收集的部分做 preview。
105
+ if (state.stdout.length < CHILD_OUTPUT_LIMIT_BYTES)
106
+ state.stdout += text;
107
+ }
108
+ function settle(callId, exitCode, spawnError) {
109
+ const state = inFlight.get(callId);
110
+ if (!state || state.settled)
111
+ return;
112
+ state.settled = true;
113
+ clearTimeout(state.timer);
114
+ inFlight.delete(callId);
115
+ const durationMs = Date.now() - state.startedAt;
116
+ callsCompleted += 1;
117
+ const frame = {
118
+ t: 'result',
119
+ callId,
120
+ outcome: 'success',
121
+ stdout: state.stdout,
122
+ stderr: state.stderr,
123
+ exitCode,
124
+ durationMs,
125
+ timedOut: state.timedOut,
126
+ };
127
+ if (spawnError) {
128
+ frame.outcome = 'error';
129
+ frame.hostError = { code: 'SCRIPT_SPAWN_ERROR', message: spawnError.message };
130
+ }
131
+ else if (state.timedOut) {
132
+ frame.outcome = 'timeout';
133
+ }
134
+ else if (state.truncated) {
135
+ frame.outcome = 'error';
136
+ frame.truncated = true;
137
+ frame.hostError = { code: 'SCRIPT_OUTPUT_LIMIT', message: `output exceeded ${CHILD_OUTPUT_LIMIT_BYTES} bytes` };
138
+ }
139
+ else if (exitCode !== 0) {
140
+ frame.outcome = 'error';
141
+ }
142
+ writeFrame(frame);
143
+ // 临时目录删除不能阻塞主流程:失败的清理只记日志(下次启动会扫残留)。
144
+ fs.rm(state.workDir, { recursive: true, force: true }, error => {
145
+ if (error)
146
+ logToStderr(`workDir cleanup failed for ${callId}: ${error.message}`);
147
+ });
148
+ }
149
+ function handleCall(frame) {
150
+ if (shuttingDown)
151
+ return;
152
+ if (frame.mode === 'resident') {
153
+ void handleResidentCall(frame);
154
+ return;
155
+ }
156
+ let child;
157
+ try {
158
+ // 每个调用一个独立临时目录,落在 daemon 给的 workDir 下(它是策略里唯一可写的路径)。
159
+ fs.mkdirSync(frame.workDir, { recursive: true });
160
+ }
161
+ catch (error) {
162
+ writeFrame({
163
+ t: 'result', callId: frame.callId, outcome: 'error',
164
+ stdout: '', stderr: '', exitCode: 0, durationMs: 0, timedOut: false,
165
+ hostError: { code: 'WORKDIR_UNAVAILABLE', message: error.message },
166
+ });
167
+ return;
168
+ }
169
+ try {
170
+ child = spawn(frame.runtime, [frame.scriptPath, ...frame.args], {
171
+ cwd: frame.cwd,
172
+ env: {
173
+ ...frame.env,
174
+ // 临时目录三件套指向本次调用自己的目录。
175
+ TMPDIR: frame.workDir, TEMP: frame.workDir, TMP: frame.workDir,
176
+ },
177
+ stdio: ['pipe', 'pipe', 'pipe'],
178
+ windowsHide: true,
179
+ shell: false,
180
+ });
181
+ }
182
+ catch (error) {
183
+ fs.rm(frame.workDir, { recursive: true, force: true }, () => { });
184
+ writeFrame({
185
+ t: 'result', callId: frame.callId, outcome: 'error',
186
+ stdout: '', stderr: '', exitCode: 0, durationMs: 0, timedOut: false,
187
+ hostError: { code: 'SCRIPT_SPAWN_ERROR', message: error.message },
188
+ });
189
+ return;
190
+ }
191
+ const state = {
192
+ child,
193
+ timer: setTimeout(() => {
194
+ state.timedOut = true;
195
+ killChild(child);
196
+ }, frame.timeoutMs),
197
+ startedAt: Date.now(),
198
+ stdout: '',
199
+ stderr: '',
200
+ bytes: 0,
201
+ truncated: false,
202
+ timedOut: false,
203
+ settled: false,
204
+ workDir: frame.workDir,
205
+ };
206
+ state.timer.unref?.();
207
+ inFlight.set(frame.callId, state);
208
+ child.stdout?.on('data', (chunk) => accumulate(state, chunk));
209
+ child.stderr?.on('data', (chunk) => {
210
+ if (state.stderr.length < CHILD_OUTPUT_LIMIT_BYTES / 4)
211
+ state.stderr += chunk.toString('utf8');
212
+ });
213
+ child.on('error', error => settle(frame.callId, -1, error));
214
+ child.on('close', code => settle(frame.callId, typeof code === 'number' ? code : -1));
215
+ // 契约 JSON 已在 daemon 侧序列化好;写失败(进程早退)由 close 兜底。
216
+ try {
217
+ child.stdin?.on('error', () => { });
218
+ child.stdin?.end(frame.stdin);
219
+ }
220
+ catch {
221
+ /* ignore */
222
+ }
223
+ }
224
+ /**
225
+ * 形态 B 的一次调用。
226
+ *
227
+ * 调用行由 daemon 拼好传下来(含 `callId` 与本次 `EC_*` 等价字段),这里只负责投递
228
+ * 与把结果映射成统一的 ResultFrame——与形态 A 共用同一套 daemon 侧判定。
229
+ */
230
+ async function handleResidentCall(frame) {
231
+ const startedAt = Date.now();
232
+ const key = frame.residentKey ?? `${frame.scriptPath}`;
233
+ try {
234
+ const result = await resident.call({
235
+ key,
236
+ runtime: frame.runtime,
237
+ scriptPath: frame.scriptPath,
238
+ args: frame.args,
239
+ env: frame.env,
240
+ cwd: frame.cwd,
241
+ workDir: frame.workDir,
242
+ line: frame.residentLine ?? '',
243
+ callId: frame.callId,
244
+ softTimeoutMs: frame.timeoutMs,
245
+ hardTimeoutAfter: frame.hardTimeoutAfter ?? RESIDENT_HARD_TIMEOUT_AFTER,
246
+ ...(frame.residentStartTimeoutMs ? { startTimeoutMs: frame.residentStartTimeoutMs } : {}),
247
+ });
248
+ const resultFrame = {
249
+ t: 'result',
250
+ callId: frame.callId,
251
+ outcome: result.outcome === 'timeout' ? 'timeout' : result.outcome,
252
+ // 形态 B 不走 stdout 文本:脚本回的就是结构化正文,宿主已经解析过。
253
+ stdout: '',
254
+ stderr: '',
255
+ exitCode: 0,
256
+ durationMs: result.durationMs,
257
+ timedOut: result.timedOut,
258
+ resident: true,
259
+ ...(result.payload !== undefined ? { data: result.payload } : {}),
260
+ // 脚本自己报的业务错误(`outcome:error` + error 字段)不是宿主故障,
261
+ // 不能塞进 `hostError`——那会让 daemon 判成「脚本没起来」。
262
+ ...(result.hostError ? { hostError: result.hostError } : {}),
263
+ ...(!result.hostError && result.error && result.outcome !== 'success'
264
+ ? { scriptError: result.error }
265
+ : {}),
266
+ };
267
+ writeFrame(resultFrame);
268
+ }
269
+ catch (error) {
270
+ writeFrame({
271
+ t: 'result', callId: frame.callId, outcome: 'error',
272
+ stdout: '', stderr: '', exitCode: 0, durationMs: Date.now() - startedAt, timedOut: false,
273
+ resident: true,
274
+ hostError: { code: 'RESIDENT_UNAVAILABLE', message: error.message },
275
+ });
276
+ }
277
+ finally {
278
+ // 与形态 A 的 `settle()` 同口径:不管成败都算完成一次。
279
+ // 漏掉这里的话,常驻路径的调用在自省快照里完全不可见(callsCompleted 恒为 0),
280
+ // 运维看到的是一个"永不接活"的宿主。
281
+ callsCompleted += 1;
282
+ }
283
+ }
284
+ function shutdown(reason) {
285
+ if (shuttingDown)
286
+ return;
287
+ shuttingDown = true;
288
+ logToStderr(`shutting down: ${reason}`);
289
+ resident.killAll('host shutting down');
290
+ for (const [callId, state] of inFlight) {
291
+ killChild(state.child);
292
+ settle(callId, -1);
293
+ }
294
+ // 自毁兜底:即使某个子进程杀不掉也不拖住进程。
295
+ const timer = setTimeout(() => process.exit(0), EOF_SELF_DESTRUCT_MS);
296
+ timer.unref?.();
297
+ process.exit(0);
298
+ }
299
+ function main() {
300
+ // 启动时清理上一次被强杀留下的临时目录(宿主可能整进程被 kill,来不及删)。
301
+ try {
302
+ const parent = process.env.EVOLCORE_HOST_WORKDIR;
303
+ if (parent) {
304
+ const callsRoot = path.join(parent, 'services-call');
305
+ if (fs.existsSync(callsRoot)) {
306
+ for (const entry of fs.readdirSync(callsRoot)) {
307
+ fs.rmSync(path.join(callsRoot, entry), { recursive: true, force: true });
308
+ }
309
+ }
310
+ }
311
+ }
312
+ catch (error) {
313
+ logToStderr(`stale workDir sweep failed: ${error.message}`);
314
+ }
315
+ writeFrame({ t: 'ready', programVersion: HOST_PROGRAM_VERSION, pid: process.pid });
316
+ /**
317
+ * 自省采样。
318
+ *
319
+ * 三项指标各有分工(设计稿 3.8.2):
320
+ * - `rss`:**粗粒度**,GC 会让它来回跳,所以判据要看「超基线 2 倍」而不是绝对值;
321
+ * - `handles`:**最灵敏**的泄漏信号——`getActiveResourcesInfo` 数的是活跃句柄,
322
+ * 没清的定时器/没关的 socket 会立刻反映出来,且不会像 rss 那样抖;
323
+ * - `idleCpuPercent`:空闲时应当接近 0;明显大于 0 说明有空转定时器或轮询。
324
+ *
325
+ * CPU 用「两次采样之间的增量 / 经过时间」,所以第一轮没有基准、跳过。
326
+ */
327
+ /**
328
+ * CPU 度量窗口。
329
+ *
330
+ * **不能拿采样间隔当窗口**:间隔短于 1 秒时,一次 GC 或一次定时器抖动就能让
331
+ * 单次读数虚高到 10%以上,把健康的空闲宿主判成"空转定时器"。
332
+ * 所以固定用不少于 1 秒的窗口,采样间隔再短也不缩窗口。
333
+ */
334
+ const CPU_WINDOW_MS = Math.max(1000, statsIntervalMs());
335
+ let lastCpu = process.cpuUsage();
336
+ let lastSampleAt = Date.now();
337
+ const statsTimer = setInterval(() => {
338
+ if (shuttingDown)
339
+ return;
340
+ const now = Date.now();
341
+ const elapsedMs = now - lastSampleAt;
342
+ // 窗口不足就不出数:宁可少报一次,也不报一个不准的数字。
343
+ if (elapsedMs < CPU_WINDOW_MS)
344
+ return;
345
+ const cpu = process.cpuUsage(lastCpu);
346
+ lastCpu = process.cpuUsage();
347
+ lastSampleAt = now;
348
+ const cpuMs = (cpu.user + cpu.system) / 1000;
349
+ writeFrame({
350
+ t: 'stats',
351
+ stats: {
352
+ uptimeMs: Math.round(process.uptime() * 1000),
353
+ rss: process.memoryUsage().rss,
354
+ handles: process.getActiveResourcesInfo().length,
355
+ idleCpuPercent: Math.round(Math.min(100, (cpuMs / elapsedMs) * 100) * 10) / 10,
356
+ // 在途 = 一次性子进程 + 常驻进程里等结果的调用。只算 `inFlight.size` 会让
357
+ // 纯常驻包在 status 上永远显示 0 在途,泄漏判据也随之失真。
358
+ inFlight: inFlight.size + resident.inFlight,
359
+ callsCompleted,
360
+ resident: { processes: resident.size, ...resident.drops },
361
+ },
362
+ });
363
+ }, Math.min(statsIntervalMs(), 1000));
364
+ statsTimer.unref?.();
365
+ const splitter = new FrameSplitter();
366
+ process.stdin.setEncoding('utf8');
367
+ process.stdin.on('data', (chunk) => {
368
+ for (const line of splitter.push(chunk)) {
369
+ const frame = decodeFrame(line);
370
+ if (!frame) {
371
+ logToStderr('dropped a line that is not a frame');
372
+ continue;
373
+ }
374
+ if (frame.t === 'ping') {
375
+ // 必须同步立刻回:这是保活判据,任何排队都会被 daemon 判成卡死。
376
+ writeFrame({ t: 'pong', seq: frame.seq });
377
+ }
378
+ else if (frame.t === 'call') {
379
+ handleCall(frame);
380
+ }
381
+ else {
382
+ logToStderr(`ignored frame type ${frame.t}`);
383
+ }
384
+ }
385
+ });
386
+ process.stdin.on('end', () => shutdown('stdin EOF'));
387
+ process.stdin.on('error', () => shutdown('stdin error'));
388
+ // 进程级兜底:任何未捕获异常都不能让宿主静默消失——先回报再退,daemon 才好重启。
389
+ process.on('uncaughtException', error => {
390
+ logToStderr(`uncaughtException: ${error.stack ?? error.message}`);
391
+ shutdown('uncaughtException');
392
+ });
393
+ process.on('unhandledRejection', error => {
394
+ logToStderr(`unhandledRejection: ${String(error)}`);
395
+ });
396
+ }
397
+ main();
@@ -0,0 +1,125 @@
1
+ /**
2
+ * 常驻宿主模式的帧协议:daemon ↔ 宿主之间**换行分隔 JSON**(JSON Lines)。
3
+ *
4
+ * 设计稿:`docs/services/resident-mode.md` §五。
5
+ *
6
+ * ## 为什么是 JSON Lines
7
+ *
8
+ * `JSON.stringify` 的出口不会产生裸换行(字符串里的 `\n` 已被转义成 `\\n`),所以
9
+ * 「一行一帧」天然无歧义,不需要长度前缀或分隔符协商。代价是任何**非帧**输出都会破坏
10
+ * 流,因此约定:**宿主 stdout 只写帧,日志一律走 stderr**。
11
+ *
12
+ * ## 分工(重要)
13
+ *
14
+ * 本协议刻意让宿主"哑":
15
+ *
16
+ * - `call` 帧里的 `stdin` 是**已经序列化好的契约 JSON 字符串**,宿主原样写进子进程 stdin,
17
+ * 不解析、不改造。`EC_*` 环境变量同理,由 daemon 算好后整个 `env` 传下来。
18
+ * 这样宿主不认识任何业务语义,宿主升级不会改变调用行为。
19
+ * - `result` 帧回传**原始 stdout/stderr 文本**,末行 JSON 解析、`[[NOOP]]` 判定、
20
+ * 1 MB 截断全部留在 daemon 侧(`script-runner`),与一次性路径共用同一份实现。
21
+ * 如果宿主也解析一遍,两条路径的判定就必然漂移。
22
+ */
23
+ /** 单帧上限。超过即判该帧非法;**不因此杀宿主**(宿主是长跑进程)。 */
24
+ export const HOST_FRAME_LIMIT_BYTES = 2 * 1024 * 1024;
25
+ /** 子进程 stdout/stderr 合计上限,与 `script-runner` 的 1 MiB 同口径。 */
26
+ export const CHILD_OUTPUT_LIMIT_BYTES = 1024 * 1024;
27
+ /** 序列化成一帧(含换行)。 */
28
+ export function encodeFrame(frame) {
29
+ return `${JSON.stringify(frame)}\n`;
30
+ }
31
+ /**
32
+ * 解析一行。
33
+ *
34
+ * 返回 `undefined` 表示**这一行不是合法帧**(空行、非 JSON、非对象、缺 `t`、`t` 不认识)。
35
+ * 调用方必须能容忍这种行:宿主可能写了半行、也可能被打上了第三方库的调试输出,
36
+ * 任何一次都**不该**判死宿主——连续多次才判协议破坏(由调用方计数)。
37
+ */
38
+ export function decodeFrame(line) {
39
+ const text = line.trim();
40
+ if (!text)
41
+ return undefined;
42
+ let value;
43
+ try {
44
+ value = JSON.parse(text);
45
+ }
46
+ catch {
47
+ return undefined;
48
+ }
49
+ if (!value || typeof value !== 'object' || Array.isArray(value))
50
+ return undefined;
51
+ const record = value;
52
+ const type = record.t;
53
+ if (type !== 'ping' && type !== 'pong' && type !== 'call'
54
+ && type !== 'result' && type !== 'ready' && type !== 'log' && type !== 'stats') {
55
+ return undefined;
56
+ }
57
+ return record;
58
+ }
59
+ /**
60
+ * 增量帧切分器。
61
+ *
62
+ * 换行分隔的流式解析不能假设「一次 data 事件正好一行」:管道会任意切块。这个类维护
63
+ * 一个残buffer,只在见到 `\n` 时吐出一行。
64
+ *
65
+ * **超长行的处理**:超过 `HOST_FRAME_LIMIT_BYTES` 仍未见换行,说明对端在写一条非法
66
+ * 巨型帧——直接丢弃到下一个换行,并回一个 `undefined` + 计数,而不是无限堆内存。
67
+ */
68
+ export class FrameSplitter {
69
+ limitBytes;
70
+ buffer = '';
71
+ overflowing = false;
72
+ /** 因超长被丢弃的行数,宿主与 daemon 两侧都可以读它做告警。 */
73
+ droppedForSize = 0;
74
+ constructor(limitBytes = HOST_FRAME_LIMIT_BYTES) {
75
+ this.limitBytes = limitBytes;
76
+ }
77
+ /**
78
+ * 投喂一段文本,返回其中完整的行。
79
+ *
80
+ * 返回的数组里**只包含已确认完整的行**;末尾不完整的一段留在内部 buffer 里等下一次。
81
+ */
82
+ push(chunk) {
83
+ this.buffer += chunk;
84
+ const lines = [];
85
+ let index;
86
+ while ((index = this.buffer.indexOf('\n')) >= 0) {
87
+ const line = this.buffer.slice(0, index);
88
+ this.buffer = this.buffer.slice(index + 1);
89
+ if (this.overflowing) {
90
+ // 这一行的前半段已因超长被丢弃,整行作废。
91
+ this.overflowing = false;
92
+ continue;
93
+ }
94
+ lines.push(line);
95
+ }
96
+ if (!this.overflowing && this.buffer.length > this.limitBytes) {
97
+ this.droppedForSize += 1;
98
+ this.overflowing = true;
99
+ this.buffer = '';
100
+ }
101
+ else if (this.overflowing) {
102
+ this.buffer = '';
103
+ }
104
+ return lines;
105
+ }
106
+ /** 流结束时取出残余(无换行结尾的最后一行)。 */
107
+ flush() {
108
+ const rest = this.buffer;
109
+ this.buffer = '';
110
+ if (this.overflowing) {
111
+ this.overflowing = false;
112
+ return [];
113
+ }
114
+ return rest ? [rest] : [];
115
+ }
116
+ }
117
+ /**
118
+ * 宿主程序版本。部署路径用它做目录名,ready 帧用它让 daemon 判断是否需要重启。
119
+ *
120
+ * **改了宿主程序行为就要升版本**:已部署的旧进程只有在版本不一致时才会被换掉,
121
+ * 不升版本的话新代码要等旧进程自然退出(空闲回收 / 崩溃)才可能生效。
122
+ *
123
+ * 历史:`1` 初版;`2` 补齐常驻侧自省(callsCompleted / inFlight / 丢帧计数)。
124
+ */
125
+ export const HOST_PROGRAM_VERSION = '2';