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,398 @@
1
+ /**
2
+ * 服务常驻宿主的 daemon 侧客户端。
3
+ *
4
+ * 设计稿:`docs/services/resident-mode.md` §三、§5.2。
5
+ *
6
+ * 职责边界(与宿主程序刻意互补):
7
+ *
8
+ * - 本模块负责 **拉起、帧收发、callId 记账、单调用超时、退出处理**;
9
+ * - 宿主负责 **spawn 子进程、按 callId 回结果**;
10
+ * - `stdin` 契约 JSON 与环境变量由调用方(`script-runner`)算好后传进来,
11
+ * 结果里的 stdout/stderr 也原样返回给调用方去解析——**本模块不解析脚本输出语义**。
12
+ *
13
+ * ## 超时分两层,不要混
14
+ *
15
+ * - **宿主侧**(`CallFrame.timeoutMs`):真正的脚本超时,到点杀子进程并回 `timeout`。
16
+ * - **daemon 侧**(`timeoutMs + DAEMON_TIMEOUT_GRACE_MS`):只是保险丝,防宿主卡死导致
17
+ * 调用永不兑现。它必须**晚于**宿主侧到点,否则两边同时动手,日志里会出现
18
+ * 「脚本超时」与「宿主超时」两条互相矛盾的记录,且宿主那条 result 会被当成迟到帧丢弃。
19
+ */
20
+ import { spawn } from 'node:child_process';
21
+ import { randomUUID } from 'node:crypto';
22
+ import { FrameSplitter, decodeFrame, encodeFrame, } from './host/protocol.js';
23
+ import { ServiceError, errorMessage } from './types.js';
24
+ /**
25
+ * daemon 侧比宿主侧多等的余量。
26
+ *
27
+ * 足够覆盖「宿主收帧 → spawn → 到点杀进程 → 写回 result 帧」这段往返。
28
+ */
29
+ export const DAEMON_TIMEOUT_GRACE_MS = 5000;
30
+ /** 宿主启动就绪上限。冷态实测约 1.9 秒(含沙箱入场 + 探针),按 10 秒预算。 */
31
+ export const HOST_STARTUP_TIMEOUT_MS = 10_000;
32
+ /** 连续多少条无法解析的行判定宿主协议破坏。 */
33
+ export const HOST_PROTOCOL_BREAK_THRESHOLD = 20;
34
+ /**
35
+ * 保活参数(设计稿 3.4)。
36
+ *
37
+ * `intervalMs` 3 秒、`timeoutMs` 5 秒、连续 2 次失败才判死。
38
+ * 单次抖动不重启:宿主是事件驱动的,偶发一次 pong 迟到通常来自 GC 或磁盘抖动。
39
+ */
40
+ export const DEFAULT_KEEPALIVE = {
41
+ intervalMs: 3000,
42
+ timeoutMs: 5000,
43
+ failureThreshold: 2,
44
+ };
45
+ /** 调度层错误码。与 `QUEUE_FULL` / `DISPATCHER_CLOSED` 同类:不进幂等缓存。 */
46
+ export const SERVICES_HOST_STARTING = 'SERVICES_HOST_STARTING';
47
+ export const SERVICES_HOST_RESTARTING = 'SERVICES_HOST_RESTARTING';
48
+ export const SERVICES_HOST_UNAVAILABLE = 'SERVICES_HOST_UNAVAILABLE';
49
+ export const SERVICES_HOST_PROTOCOL = 'SERVICES_HOST_PROTOCOL';
50
+ /**
51
+ * 一个宿主进程的句柄。
52
+ *
53
+ * 生命周期:`start()` → 若干 `call()` → `close()`。一个实例对应一个宿主进程;
54
+ * 重启(P2)由上层丢弃旧实例、新建一个完成,本类不做退避。
55
+ */
56
+ export class ServiceHostClient {
57
+ deps;
58
+ child;
59
+ pending = new Map();
60
+ splitter = new FrameSplitter();
61
+ readyResolve;
62
+ readyReject;
63
+ ready = false;
64
+ closed = false;
65
+ badLineStreak = 0;
66
+ droppedUnknownResult = 0;
67
+ droppedBadLine = 0;
68
+ keepaliveTimer;
69
+ keepaliveSeq = 0;
70
+ lastPongAt = 0;
71
+ /** 最近一次宿主自省快照。 */
72
+ lastStats;
73
+ /**
74
+ * 宿主在 `ready` 帧里回报的程序版本。
75
+ *
76
+ * 只记录、不判断——「版本不一致要不要重启」是 daemon 的策略,客户端不该越界。
77
+ * 没有它,部署了新版宿主之后旧进程会一直跑到下次崩溃,运维无从发现。
78
+ */
79
+ programVersionValue;
80
+ /**
81
+ * 宿主进程 pid(`ready` 帧回报)。
82
+ *
83
+ * 运维要靠它做三件本类做不到的事:挂起进程验证保活判死、外部采样内存曲线、
84
+ * 确认「重启后真的是新进程而不是复用了旧对象」。没有这个值,这三件事在托管会话里
85
+ * 都只能猜。只记录、不用于任何判定——判死走保活通道,不靠 pid 存活检测。
86
+ */
87
+ hostPid;
88
+ /** 连续未收到 pong 的次数。收到任何一帧 pong 即清零。 */
89
+ missedPongs = 0;
90
+ keepalive;
91
+ constructor(deps) {
92
+ this.deps = deps;
93
+ this.keepalive = deps.keepalive ?? { ...DEFAULT_KEEPALIVE };
94
+ }
95
+ get isReady() {
96
+ return this.ready;
97
+ }
98
+ get stats() {
99
+ return {
100
+ inFlight: this.pending.size,
101
+ droppedUnknownResult: this.droppedUnknownResult,
102
+ droppedBadLine: this.droppedBadLine,
103
+ ready: this.ready,
104
+ ...(this.hostPid !== undefined ? { pid: this.hostPid } : {}),
105
+ ...(this.lastStats ? { stats: this.lastStats } : {}),
106
+ };
107
+ }
108
+ /** 拉起宿主并等到 `ready` 帧。超时或进程早退都抛 `SERVICES_HOST_STARTING`。 */
109
+ async start() {
110
+ if (this.child)
111
+ throw new ServiceError('HOST_ALREADY_STARTED', 'host client already started');
112
+ const spawnImpl = this.deps.spawnImpl ?? spawn;
113
+ const startupTimeoutMs = this.deps.startupTimeoutMs ?? HOST_STARTUP_TIMEOUT_MS;
114
+ const child = spawnImpl(this.deps.launch.command, this.deps.launch.args, {
115
+ cwd: this.deps.launch.cwd,
116
+ env: this.deps.launch.env,
117
+ stdio: ['pipe', 'pipe', 'pipe'],
118
+ windowsHide: true,
119
+ shell: false,
120
+ });
121
+ this.child = child;
122
+ const readyPromise = new Promise((resolve, reject) => {
123
+ this.readyResolve = resolve;
124
+ this.readyReject = reject;
125
+ });
126
+ const startupTimer = setTimeout(() => {
127
+ if (this.ready)
128
+ return;
129
+ this.readyReject?.(new ServiceError(SERVICES_HOST_STARTING, `host did not become ready within ${startupTimeoutMs}ms`));
130
+ }, startupTimeoutMs);
131
+ startupTimer.unref?.();
132
+ child.stdout?.setEncoding('utf8');
133
+ child.stdout?.on('data', (chunk) => this.onStdout(chunk));
134
+ child.stderr?.setEncoding('utf8');
135
+ child.stderr?.on('data', (chunk) => {
136
+ for (const line of chunk.split('\n')) {
137
+ if (line.trim())
138
+ this.deps.onHostLog?.(line);
139
+ }
140
+ });
141
+ child.on('error', error => this.onHostGone(error));
142
+ child.on('close', (code, signal) => this.onHostGone(new ServiceError(SERVICES_HOST_RESTARTING, `host exited (code=${code} signal=${signal})`)));
143
+ try {
144
+ await readyPromise;
145
+ }
146
+ finally {
147
+ clearTimeout(startupTimer);
148
+ }
149
+ this.startKeepalive();
150
+ }
151
+ /** 最近一次收到 pong 的时间(毫秒);供 status 观测。 */
152
+ get lastPongTimestamp() {
153
+ return this.lastPongAt;
154
+ }
155
+ /** 最近一次宿主自省快照;供泄漏判据与 status 使用。 */
156
+ get hostStats() {
157
+ return this.lastStats;
158
+ }
159
+ /** 宿主回报的程序版本;未就绪时为 undefined。 */
160
+ get programVersion() {
161
+ return this.programVersionValue;
162
+ }
163
+ /**
164
+ * 保活循环。
165
+ *
166
+ * 每 `intervalMs` 发一次 ping,并检查「上一条 ping 是否超时未答」。
167
+ * 连续 `failureThreshold` 次未答 → 判卡死,走 `onHostGone`(在途调用立即失败)。
168
+ *
169
+ * **必须与调用路径并发**:宿主是事件驱动的,一个慢调用不阻塞 pong;如果这里
170
+ * 观察到 pong 迟到,说明宿主事件循环被卡住或进程已经僵死。
171
+ */
172
+ startKeepalive() {
173
+ if (this.keepaliveTimer)
174
+ return;
175
+ const { intervalMs, timeoutMs, failureThreshold } = this.keepalive;
176
+ let awaitingSince = 0;
177
+ const timer = setInterval(() => {
178
+ if (this.closed || !this.ready)
179
+ return;
180
+ const now = Date.now();
181
+ if (awaitingSince !== 0 && now - awaitingSince >= timeoutMs) {
182
+ this.missedPongs += 1;
183
+ awaitingSince = 0;
184
+ if (this.missedPongs >= failureThreshold) {
185
+ this.onHostGone(new ServiceError(SERVICES_HOST_PROTOCOL, `host missed ${this.missedPongs} consecutive keepalive replies`));
186
+ return;
187
+ }
188
+ }
189
+ if (awaitingSince === 0) {
190
+ awaitingSince = now;
191
+ this.sendPing();
192
+ }
193
+ }, intervalMs);
194
+ timer.unref?.();
195
+ this.keepaliveTimer = timer;
196
+ }
197
+ sendPing() {
198
+ const child = this.child;
199
+ if (!child?.stdin?.writable)
200
+ return;
201
+ this.keepaliveSeq += 1;
202
+ try {
203
+ child.stdin.write(encodeFrame({ t: 'ping', seq: this.keepaliveSeq }));
204
+ }
205
+ catch {
206
+ // 写失败说明管道已断:退出事件会兜底。
207
+ }
208
+ }
209
+ /** 停掉保活循环(close / 宿主已失联时调用)。 */
210
+ stopKeepalive() {
211
+ if (this.keepaliveTimer) {
212
+ clearInterval(this.keepaliveTimer);
213
+ this.keepaliveTimer = undefined;
214
+ }
215
+ }
216
+ /**
217
+ * 投递一次调用。
218
+ *
219
+ * `callId` 在这里生成——**只在本段存在**,不进回复 payload、不进脚本可见的 `data`。
220
+ * 绝不复用 `request_id`:两个不同调用方可以撞同一个值。
221
+ */
222
+ async call(input) {
223
+ if (!this.ready)
224
+ throw new ServiceError(SERVICES_HOST_STARTING, 'host is not ready');
225
+ if (this.closed)
226
+ throw new ServiceError(SERVICES_HOST_RESTARTING, 'host client is closed');
227
+ const child = this.child;
228
+ if (!child?.stdin?.writable)
229
+ throw new ServiceError(SERVICES_HOST_RESTARTING, 'host stdin is not writable');
230
+ const callId = `svc-${randomUUID()}`;
231
+ const frame = {
232
+ t: 'call',
233
+ callId,
234
+ mode: input.mode ?? 'spawn',
235
+ runtime: input.runtime,
236
+ scriptPath: input.scriptPath,
237
+ args: input.args,
238
+ stdin: input.stdin,
239
+ env: input.env,
240
+ cwd: input.cwd,
241
+ workDir: input.workDir,
242
+ timeoutMs: input.timeoutMs,
243
+ ...(input.residentKey ? { residentKey: input.residentKey } : {}),
244
+ ...(input.residentLine ? { residentLine: input.residentLine(callId, input.workDir) } : {}),
245
+ ...(input.hardTimeoutAfter !== undefined ? { hardTimeoutAfter: input.hardTimeoutAfter } : {}),
246
+ ...(input.residentStartTimeoutMs !== undefined
247
+ ? { residentStartTimeoutMs: input.residentStartTimeoutMs } : {}),
248
+ };
249
+ return await new Promise((resolve, reject) => {
250
+ const timer = setTimeout(() => {
251
+ // 保险丝跳了:宿主没在预定时间内回帧。该调用作废,迟到帧会被当成未知 callId 丢弃。
252
+ this.pending.delete(callId);
253
+ reject(new ServiceError(SERVICES_HOST_RESTARTING, `host did not answer call within ${input.timeoutMs + DAEMON_TIMEOUT_GRACE_MS}ms`));
254
+ }, input.timeoutMs + DAEMON_TIMEOUT_GRACE_MS);
255
+ timer.unref?.();
256
+ this.pending.set(callId, { resolve, reject, timer, callId });
257
+ try {
258
+ child.stdin.write(encodeFrame(frame));
259
+ }
260
+ catch (error) {
261
+ clearTimeout(timer);
262
+ this.pending.delete(callId);
263
+ reject(new ServiceError(SERVICES_HOST_RESTARTING, `failed to write call frame: ${error.message}`));
264
+ }
265
+ });
266
+ }
267
+ /** 关闭:等当前帧写完再断开 stdin,宿主收到 EOF 会自杀。 */
268
+ async close() {
269
+ if (this.closed)
270
+ return;
271
+ this.closed = true;
272
+ this.stopKeepalive();
273
+ this.failAllPending(new ServiceError(SERVICES_HOST_RESTARTING, 'host client closed'));
274
+ const child = this.child;
275
+ if (!child)
276
+ return;
277
+ const exited = child.exitCode !== null || child.signalCode !== null ? Promise.resolve() : new Promise(resolve => {
278
+ const timer = setTimeout(() => { child.kill('SIGKILL'); }, 5500);
279
+ timer.unref?.();
280
+ child.once('close', () => { clearTimeout(timer); resolve(); });
281
+ });
282
+ try {
283
+ child.stdin?.end();
284
+ }
285
+ catch {
286
+ /* ignore */
287
+ }
288
+ await exited;
289
+ }
290
+ // ── 帧处理 ──────────────────────────────────────────────────────────
291
+ onStdout(chunk) {
292
+ for (const line of this.splitter.push(chunk)) {
293
+ const frame = decodeFrame(line);
294
+ if (!frame) {
295
+ this.droppedBadLine += 1;
296
+ this.badLineStreak += 1;
297
+ // 连续不可解析说明宿主在往 stdout 打非帧内容,属于协议破坏。
298
+ if (this.badLineStreak >= HOST_PROTOCOL_BREAK_THRESHOLD) {
299
+ this.onHostGone(new ServiceError(SERVICES_HOST_PROTOCOL, `host emitted ${this.badLineStreak} consecutive malformed lines`));
300
+ }
301
+ continue;
302
+ }
303
+ this.badLineStreak = 0;
304
+ this.onFrame(frame);
305
+ }
306
+ }
307
+ onFrame(frame) {
308
+ switch (frame.t) {
309
+ case 'ready':
310
+ this.programVersionValue = typeof frame.programVersion === 'string' ? frame.programVersion : undefined;
311
+ // pid 只从 ready 帧来,不从 child.pid 读:沙箱启动时 `spawn` 的可能是外层包装进程,
312
+ // child.pid 与真正跑宿主代码的进程不是同一个。宿主自报的才是准的。
313
+ this.hostPid = typeof frame.pid === 'number' ? frame.pid : undefined;
314
+ this.ready = true;
315
+ this.readyResolve?.();
316
+ this.readyResolve = undefined;
317
+ this.readyReject = undefined;
318
+ return;
319
+ case 'pong':
320
+ this.lastPongAt = Date.now();
321
+ this.missedPongs = 0;
322
+ return;
323
+ case 'log':
324
+ this.deps.onHostLog?.(`[${frame.level}] ${frame.message}`);
325
+ return;
326
+ case 'stats':
327
+ // 只存最新的:泄漏判据看的是当前水位,历史曲线由 daemon 侧的日志/台账负责。
328
+ this.lastStats = frame.stats;
329
+ this.deps.onHostStats?.(frame.stats);
330
+ return;
331
+ case 'result': {
332
+ const pending = this.pending.get(frame.callId);
333
+ if (!pending) {
334
+ // 未知 callId:软超时后迟到的结果、或伪造帧。丢弃并计数,绝不猜归属。
335
+ this.droppedUnknownResult += 1;
336
+ return;
337
+ }
338
+ this.pending.delete(frame.callId);
339
+ clearTimeout(pending.timer);
340
+ pending.resolve({
341
+ outcome: frame.outcome,
342
+ stdout: frame.stdout,
343
+ stderr: frame.stderr,
344
+ exitCode: frame.exitCode,
345
+ durationMs: frame.durationMs,
346
+ timedOut: frame.timedOut,
347
+ truncated: frame.truncated === true,
348
+ ...(frame.hostError ? { hostError: frame.hostError } : {}),
349
+ ...(frame.data !== undefined ? { data: frame.data } : {}),
350
+ ...(frame.scriptError ? { scriptError: frame.scriptError } : {}),
351
+ ...(frame.resident ? { resident: true } : {}),
352
+ });
353
+ return;
354
+ }
355
+ default:
356
+ return;
357
+ }
358
+ }
359
+ onHostGone(error) {
360
+ this.stopKeepalive();
361
+ if (this.closed) {
362
+ this.failAllPending(error);
363
+ return;
364
+ }
365
+ this.closed = true;
366
+ this.ready = false;
367
+ if (error instanceof ServiceError) {
368
+ try {
369
+ this.deps.onHostLost?.(error);
370
+ }
371
+ catch {
372
+ // 上层回调抛错不能影响「在途调用判失败」这件必须完成的事。
373
+ }
374
+ }
375
+ // 启动阶段用原始错误:那时还没有调用方,`SERVICES_HOST_STARTING` 更有信息量。
376
+ if (!this.ready)
377
+ this.readyReject?.(error);
378
+ this.readyReject = undefined;
379
+ /**
380
+ * **在途调用一律看 `SERVICES_HOST_RESTARTING`**,不暴露具体死因。
381
+ *
382
+ * 设计稿 9:`SERVICES_HOST_*` 是调度层状态,调用方只需知道「宿主换了,可以重试」。
383
+ * 把 `PROTOCOL` / `UNAVAILABLE` 这类内部码透给对端,等于把一个运维细节变成协议
384
+ * 的一部分——以后改判据就会破坏对端。具体死因走 `onHostLost` 给 daemon 记日志。
385
+ */
386
+ const callerError = new ServiceError(SERVICES_HOST_RESTARTING, `service host is gone: ${errorMessage(error)}`);
387
+ this.failAllPending(callerError);
388
+ // 残余缓冲里的半帧必须丢弃:不能与将来的帧拼接。
389
+ this.splitter.flush();
390
+ }
391
+ failAllPending(error) {
392
+ for (const [callId, pending] of this.pending) {
393
+ clearTimeout(pending.timer);
394
+ pending.reject(error);
395
+ this.pending.delete(callId);
396
+ }
397
+ }
398
+ }
@@ -0,0 +1,180 @@
1
+ /**
2
+ * 宿主程序的部署:把编译产物复制到**沙箱可读**的带版本目录。
3
+ *
4
+ * 设计稿:`docs/services/resident-mode.md` §七。
5
+ *
6
+ * ## 为什么不能直接就地执行
7
+ *
8
+ * `agents/<aid>` 根上有继承性 `CodexSandboxUsers: DENY(R)`,`services/` 整棵树对沙箱身份
9
+ * 是 EPERM——包脚本之所以能跑,是因为执行前被 `stageScriptSnapshot` 复制到运行目录。
10
+ * 宿主程序同理:**必须先复制到运行目录,再从那里执行**。
11
+ *
12
+ * ## 版本化
13
+ *
14
+ * 目录名带 `HOST_PROGRAM_VERSION`:
15
+ *
16
+ * ```
17
+ * <runtimeRoot>/host/program/<version>/main.js
18
+ * ```
19
+ *
20
+ * 已部署版本与 daemon 期望版本不一致时,daemon 会重启宿主(`ready` 帧回报 `programVersion`)。
21
+ * 旧版本目录保留最近两个,方便回滚,其余由 `doctor` 提示清理——不自动删。
22
+ */
23
+ import fs from 'node:fs';
24
+ import path from 'node:path';
25
+ import { fileURLToPath } from 'node:url';
26
+ import { HOST_PROGRAM_VERSION } from './host/protocol.js';
27
+ /** 保留的历史版本数(含当前)。 */
28
+ export const HOST_PROGRAM_KEEP_VERSIONS = 2;
29
+ /**
30
+ * 候选的宿主程序目录(按优先级)。
31
+ *
32
+ * 编译后本文件位于 `dist/services/host-deploy.js`,产物在同级 `host/` 下;
33
+ * 但直接从源码运行(`tsx src/index.ts`、vitest)时同级只有 `.ts`。
34
+ * 所以给出候选列表并取第一个「含 .js」的目录,而不是硬编码单一路径——
35
+ * 否则开发态下宿主模式会以 `HOST_PROGRAM_MISSING` 失败,而错误信息看起来像「没构建」。
36
+ *
37
+ * 全部用自身位置推导,不依赖 `process.cwd()`:daemon 可能在任意目录启动。
38
+ */
39
+ function hostSourceCandidates() {
40
+ const here = path.dirname(fileURLToPath(import.meta.url));
41
+ return [
42
+ // 编译态:dist/services/host
43
+ path.join(here, 'host'),
44
+ // 源码态:src/services/host-deploy.ts → ../../dist/services/host
45
+ path.join(here, '..', '..', 'dist', 'services', 'host'),
46
+ ];
47
+ }
48
+ /** 取第一个存在且含 `.js` 的候选目录;都没有则返回第一个(用于报错时展示)。 */
49
+ function resolveHostSourceDir() {
50
+ const candidates = hostSourceCandidates();
51
+ for (const candidate of candidates) {
52
+ try {
53
+ if (fs.readdirSync(candidate).some(name => name.endsWith('.js')))
54
+ return candidate;
55
+ }
56
+ catch {
57
+ // 目录不存在:继续看下一个。
58
+ }
59
+ }
60
+ return candidates[0];
61
+ }
62
+ /**
63
+ * 把宿主程序复制到运行目录并返回入口。
64
+ *
65
+ * 幂等:目标已存在且内容一致时直接复用(比较字节,避免每次启动都重写文件)。
66
+ * 不一致(例如同一版本号下代码变了)则覆盖——**版本号才是权威**,
67
+ * 内容变化却没升版本属于开发期情形,覆盖比报错更安全。
68
+ *
69
+ * `sourceDir` 仅供测试注入。生产路径用自身位置推导(见 `hostSourceDir`)。
70
+ */
71
+ export function deployHostProgram(runtimeRoot, sourceDir) {
72
+ const source = sourceDir ?? resolveHostSourceDir();
73
+ const dir = path.join(runtimeRoot, 'host', 'program', HOST_PROGRAM_VERSION);
74
+ const entry = path.join(dir, 'main.js');
75
+ let entries;
76
+ try {
77
+ entries = fs.readdirSync(source).filter(name => name.endsWith('.js'));
78
+ }
79
+ catch (error) {
80
+ throw Object.assign(new Error(`host program sources are unavailable at "${source}": ${error.message}. `
81
+ + 'Run `npm run build` before enabling the resident host.'), { code: 'HOST_PROGRAM_MISSING' });
82
+ }
83
+ if (entries.length === 0) {
84
+ // 两种可能,错误信息要能区分:一是没构建,二是直接从源码运行(例如 vitest / tsx),
85
+ // 此时同级目录只有 .ts 没有 .js。后者不是故障,是调用方用错了入口。
86
+ const hasTs = fs.readdirSync(source).some(name => name.endsWith('.ts'));
87
+ throw Object.assign(new Error(hasTs
88
+ ? `host program at "${source}" contains only TypeScript sources; `
89
+ + 'deploy from the compiled dist/ tree (production) or pass an explicit sourceDir (tests).'
90
+ : `host program sources are empty at "${source}". Run \`npm run build\` first.`), { code: 'HOST_PROGRAM_MISSING' });
91
+ }
92
+ fs.mkdirSync(dir, { recursive: true, mode: 0o700 });
93
+ for (const name of entries) {
94
+ const from = path.join(source, name);
95
+ const to = path.join(dir, name);
96
+ const bytes = fs.readFileSync(from);
97
+ let existing;
98
+ try {
99
+ existing = fs.readFileSync(to);
100
+ }
101
+ catch {
102
+ existing = undefined;
103
+ }
104
+ if (existing && existing.equals(bytes))
105
+ continue;
106
+ // 先写临时文件再 rename:避免 daemon 在复制中途崩溃留下半份程序。
107
+ const temp = `${to}.tmp-${process.pid}`;
108
+ fs.writeFileSync(temp, bytes, { mode: 0o600 });
109
+ fs.renameSync(temp, to);
110
+ }
111
+ // 编译产物是 ESM,但运行目录不在仓库的 package.json 管辖下——没有这个文件,
112
+ // node 会把 .js 当 CommonJS 加载,直接 `SyntaxError: Cannot use import statement`。
113
+ // 内容固定,只在缺失或不同时重写。
114
+ const manifestPath = path.join(dir, 'package.json');
115
+ const manifest = `${JSON.stringify({ type: 'module', private: true }, null, 2)}\n`;
116
+ let existingManifest;
117
+ try {
118
+ existingManifest = fs.readFileSync(manifestPath, 'utf8');
119
+ }
120
+ catch {
121
+ existingManifest = undefined;
122
+ }
123
+ if (existingManifest !== manifest) {
124
+ const temp = `${manifestPath}.tmp-${process.pid}`;
125
+ fs.writeFileSync(temp, manifest, { mode: 0o600 });
126
+ fs.renameSync(temp, manifestPath);
127
+ }
128
+ pruneOldVersions(path.join(runtimeRoot, 'host', 'program'));
129
+ return { entry, dir, version: HOST_PROGRAM_VERSION };
130
+ }
131
+ /**
132
+ * 只保留最近 N 个版本目录。
133
+ *
134
+ * 按目录名排序而不是 mtime:版本名是 `1`、`2`…(必要时会变成语义化版本),排序结果稳定;
135
+ * mtime 会在重新部署同一版本时变化,导致误删本来该留的旧版本。
136
+ *
137
+ * **当前版本永不删除**,无论它排序排在哪。这条不是防御性编程:`HOST_PROGRAM_VERSION`
138
+ * 目前就是 `"1"`,数值上最小,若只按「保留最新的 N 个」裁,会把**正在用的那个**删掉——
139
+ * 于是下一次部署前宿主直接起不来。先钉住当前版本,再从其余里挑最新的 N-1 个。
140
+ */
141
+ function pruneOldVersions(programRoot) {
142
+ let names;
143
+ try {
144
+ names = fs.readdirSync(programRoot).filter(name => {
145
+ try {
146
+ return fs.statSync(path.join(programRoot, name)).isDirectory();
147
+ }
148
+ catch {
149
+ return false;
150
+ }
151
+ });
152
+ }
153
+ catch {
154
+ return;
155
+ }
156
+ if (names.length <= HOST_PROGRAM_KEEP_VERSIONS)
157
+ return;
158
+ const others = names
159
+ .filter(name => name !== HOST_PROGRAM_VERSION)
160
+ .sort(compareVersionNames);
161
+ // 总保留量是 N,其中当前版本占一个名额。
162
+ const keepOthers = Math.max(0, HOST_PROGRAM_KEEP_VERSIONS - 1);
163
+ const doomed = others.slice(0, Math.max(0, others.length - keepOthers));
164
+ for (const name of doomed) {
165
+ try {
166
+ fs.rmSync(path.join(programRoot, name), { recursive: true, force: true });
167
+ }
168
+ catch {
169
+ // 删不掉不致命:下次启动会再试。
170
+ }
171
+ }
172
+ }
173
+ /** 版本名比较:可解析为数字的按数值,否则按字面量(`10` 应排在 `9` 之后)。 */
174
+ function compareVersionNames(left, right) {
175
+ const leftNum = Number(left);
176
+ const rightNum = Number(right);
177
+ if (Number.isFinite(leftNum) && Number.isFinite(rightNum))
178
+ return leftNum - rightNum;
179
+ return left.localeCompare(right);
180
+ }