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
@@ -1,18 +1,15 @@
1
1
  import fs from 'node:fs';
2
2
  import os from 'node:os';
3
3
  import path from 'node:path';
4
- import { createRequire } from 'node:module';
5
4
  import { pathToFileURL } from 'node:url';
6
- import { spawn } from 'node:child_process';
7
- import { resolveCodexCliPath } from '../agents/baseagent.js';
8
5
  import { ensureSessionRuntimeDirAsync } from '../cli/task-context.js';
9
- import { buildBubblewrapCommand, buildHClassGuardCommand, resolveBubblewrapPath, } from '../core/permission/sandbox-runtime.js';
6
+ import { buildBubblewrapCommand, buildHClassGuardCommand, buildWindowsFilesystemEntry, resolveBubblewrapPath, resolveWindowsSandboxBackend, verifyWindowsReadIsolation, } from '../core/permission/sandbox-runtime.js';
10
7
  import { resolvePhaseOneExecutionSandbox } from '../core/permission/mode.js';
11
8
  import { isCredentialEnvironmentName, sanitizeShellExecutionEnvironment } from '../core/permission/shell-environment.js';
12
9
  import { buildCodexProtectedFilesystemRules, classifyProtectedPath, getExistingRelationAttachmentDirs, isSameOrDescendant, } from '../core/permission/protected-paths.js';
13
10
  import { resolveRoot } from '../paths.js';
14
- import { buildCliLaunchCommand, killProcess, resolveCommandPath } from '../utils/cross-platform.js';
15
- import { TRIGGER_LOCAL_FILE_LIMIT } from './local-files.js';
11
+ import { buildCliLaunchCommand, resolveCommandPath } from '../utils/cross-platform.js';
12
+ import { TRIGGER_LOCAL_FILE_LIMIT } from '../core/permission/managed-file.js';
16
13
  /**
17
14
  * 沙箱探针(`prepare()`)的超时上限。
18
15
  *
@@ -47,7 +44,6 @@ export async function runPrepareWithDeadline(prepare, timeoutMs = SANDBOX_PREPAR
47
44
  clearTimeout(timer);
48
45
  }
49
46
  }
50
- const WINDOWS_SANDBOX_SETUP_VERSION = 5;
51
47
  const SCRIPT_ENVIRONMENT_EXCLUDES = [
52
48
  'CODEX_HOME',
53
49
  'OPENAI_API_KEY',
@@ -134,7 +130,7 @@ export async function buildTriggerScriptLaunch(input) {
134
130
  throw new Error('scoped Trigger runtime path is protected or too broad');
135
131
  }
136
132
  const scriptBytes = readScriptSnapshot(input.scriptPath, triggerDir);
137
- const windowsBackend = process.platform === 'win32' ? resolveWindowsBackend() : undefined;
133
+ const windowsBackend = process.platform === 'win32' ? resolveWindowsSandboxBackend() : undefined;
138
134
  if (windowsBackend && (isSameOrDescendant(windowsBackend.home, projectPath)
139
135
  || isSameOrDescendant(projectPath, windowsBackend.home)
140
136
  || isSameOrDescendant(windowsBackend.home, runtimeDir)
@@ -175,7 +171,9 @@ export async function buildTriggerScriptLaunch(input) {
175
171
  const snapshotDir = path.join(runDir, 'script');
176
172
  fs.mkdirSync(workDir, { mode: 0o700 });
177
173
  fs.mkdirSync(snapshotDir, { mode: 0o700 });
178
- const scriptPath = stageScriptSnapshot(input.scriptPath, triggerDir, scriptBytes, snapshotDir);
174
+ const scriptPath = stageScriptSnapshot(input.scriptPath, triggerDir, scriptBytes, snapshotDir, {
175
+ ...(input.snapshotRoot ? { rootDir: input.snapshotRoot, skipTopEntries: SNAPSHOT_SKIP_TOP_ENTRIES } : {}),
176
+ });
179
177
  preserveNodeModuleType(runtime, input.scriptPath, snapshotDir);
180
178
  const env = buildSandboxEnvironment(workDir);
181
179
  const scriptArgs = [scriptPath, ...input.scriptArgs];
@@ -193,27 +191,26 @@ export async function buildTriggerScriptLaunch(input) {
193
191
  process.execPath,
194
192
  path.dirname(process.execPath),
195
193
  snapshotDir,
194
+ // 服务常驻宿主:包脚本快照根(只读)。不传时这里是空数组,行为不变。
195
+ ...(input.extraReadRoots ?? []),
196
196
  ].filter(value => fs.existsSync(value));
197
197
  const entries = [
198
198
  { path: { type: 'special', value: { kind: 'root' } },
199
199
  access: sandboxDecision.state === 'off' ? 'write' : 'read' },
200
- ...readRoots.map(value => filesystemEntry(value, 'read')),
201
- filesystemEntry(projectPath, readonly ? 'read' : 'write'),
202
- filesystemEntry(snapshotDir, 'read'),
203
- filesystemEntry(workDir, 'write'),
204
- filesystemEntry(windowsBackend.home, 'deny'),
205
- // 服务包:脚本不能改写自己的代码与声明,只能读。
206
- //
207
- // 当前行为本来就是这样(`root: read` + 没有任何条目给 services 授 write),
208
- // 这条的价值是把它从「依赖默认拒绝」变成显式声明:将来若有重构把 services
209
- // 纳入 write 范围(例如为缓存/worker 方案放权),这里仍然读-写不对称。
210
- //
211
- // **不能写 `deny`**:Codex 的 deny 连读一起拒,而服务脚本要读自己的
212
- // pack.json。真需要拦写也拦不住显式子级 Allow——那由 ACL 层负责
213
- // (见 src/core/permission/services-path-acl.ts)。
214
- ...(input.trigger.labels?.kind === 'services'
215
- ? [filesystemEntry(path.join(root, 'agents', input.trigger.agentAid, 'services'), 'read')]
216
- : []),
200
+ ...readRoots.map(value => buildWindowsFilesystemEntry(value, 'read')),
201
+ buildWindowsFilesystemEntry(projectPath, readonly ? 'read' : 'write'),
202
+ buildWindowsFilesystemEntry(snapshotDir, 'read'),
203
+ buildWindowsFilesystemEntry(workDir, 'write'),
204
+ // 额外可写根(服务宿主的工作目录)。不存在时 `buildWindowsFilesystemEntry` 仍是合法条目,
205
+ // 但策略里指向不存在的路径不会生效,所以调用方必须先建好目录。
206
+ ...(input.extraWriteRoots ?? []).map(value => buildWindowsFilesystemEntry(value, 'write')),
207
+ buildWindowsFilesystemEntry(windowsBackend.home, 'deny'),
208
+ // 这里不再为 `services` 单独追加条目。`services` 已由
209
+ // `getExistingLClassReadOnlyTargets` 纳入 L 类只读目标,win32 下写保护由
210
+ // 「没有任何条目授 write」+ ACL 的 DENY(写) 共同承担(见
211
+ // src/core/permission/services-path-acl.ts)。原先那条按
212
+ // `trigger.labels.kind === 'services'` 分流的 read 条目是空操作:实测有它无它,
213
+ // 服务脚本对 services 树的 list / read / write 结果完全相同。
217
214
  ...Object.entries(filesystem).flatMap(([value, access]) => typeof access === 'number' ? [] : [{
218
215
  path: /[*?[\]]/.test(value)
219
216
  ? { type: 'glob_pattern', pattern: value }
@@ -223,7 +220,7 @@ export async function buildTriggerScriptLaunch(input) {
223
220
  ...getExistingRelationAttachmentDirs(root, {
224
221
  selfAid: input.trigger.agentAid,
225
222
  onlyOtherAgents: true,
226
- }).map(value => filesystemEntry(value, 'deny')),
223
+ }).map(value => buildWindowsFilesystemEntry(value, 'deny')),
227
224
  ];
228
225
  const sandboxState = JSON.stringify({
229
226
  permissionProfile: {
@@ -247,8 +244,9 @@ export async function buildTriggerScriptLaunch(input) {
247
244
  cwd: projectPath,
248
245
  env: { ...env, CODEX_HOME: windowsBackend.home },
249
246
  cleanup,
247
+ scriptSnapshotRoot: snapshotDir,
250
248
  };
251
- launch.prepare = signal => verifyWindowsReadIsolation(launch, sandboxArgs, runDir, workDir, signal);
249
+ launch.prepare = signal => verifyWindowsReadIsolation(launch, sandboxArgs, runDir, workDir, signal, input.verifyGrandchild === true);
252
250
  return launch;
253
251
  }
254
252
  const launch = sandboxDecision.state === 'off'
@@ -266,11 +264,18 @@ export async function buildTriggerScriptLaunch(input) {
266
264
  const separator = launch.args.indexOf('--');
267
265
  if (separator < 0)
268
266
  throw new Error('bubblewrap launch is missing its command separator');
269
- const runMountArgs = ['--ro-bind', runDir, runDir, '--bind', workDir, workDir];
267
+ const runMountArgs = [
268
+ '--ro-bind', runDir, runDir,
269
+ '--bind', workDir, workDir,
270
+ ...(input.extraWriteRoots ?? []).flatMap(root => ['--bind', root, root]),
271
+ // 额外只读根(服务宿主的包脚本快照根)。bwrap 里**没有挂载就等于不存在**,
272
+ // 与 Windows 侧的 read 策略条目是同一件事的两平台写法,必须成对出现。
273
+ ...(input.extraReadRoots ?? []).flatMap(root => ['--ro-bind', root, root]),
274
+ ];
270
275
  if (!launch.args.slice(0, separator).includes('--chdir'))
271
276
  runMountArgs.push('--chdir', projectPath);
272
277
  launch.args.splice(separator, 0, ...runMountArgs);
273
- return { ...launch, cwd: projectPath, env, cleanup };
278
+ return { ...launch, cwd: projectPath, env, cleanup, scriptSnapshotRoot: snapshotDir };
274
279
  }
275
280
  catch (error) {
276
281
  cleanup();
@@ -287,79 +292,6 @@ function resolveRuntime(value) {
287
292
  throw new Error(`script runtime is unavailable: ${runtime}`);
288
293
  return fs.realpathSync.native(executable);
289
294
  }
290
- /**
291
- * 解析 Windows scoped 沙箱宿主。
292
- *
293
- * **这里就是「EvolCore 依赖 Codex」的全部来源。** Codex 只作为 Windows 沙箱的
294
- * 执行宿主(`codex.exe sandbox` + `codex-windows-sandbox-setup.exe` 施加的 ACL),
295
- * 与 baseagent 无关,也不涉及模型调用。替代方案(landstrip / srt)尚未接入。
296
- *
297
- * 失败分三类,各自的修复动作不同,报错里会明确区分:
298
- * 1. 没装 Codex → 全局安装
299
- * 2. 装了但缺平台包 → 重装(npm 的 optional 依赖常因超时被静默丢弃)
300
- * 3. 装了但沙箱未 provisioning → 在宿主终端跑一次 elevated setup
301
- *
302
- * 三类都失败时,唯一出路是改用 daemon scope / fullaccess(无沙箱)。
303
- */
304
- function resolveWindowsBackend() {
305
- const noSandboxHint = 'Alternatively, execute the script through daemon scope or fullaccess '
306
- + '(no sandbox is applied) and tell the user explicitly.';
307
- const codexPath = resolveCodexCliPath();
308
- if (!codexPath) {
309
- throw new Error('Codex CLI is required for scoped Windows Trigger script isolation, but `codex` was not found on PATH. '
310
- + 'EvolCore only uses it as the Windows sandbox host — install it with `npm install -g @openai/codex`, '
311
- + 'then re-run. ' + noSandboxHint);
312
- }
313
- let command = codexPath;
314
- if (path.extname(command).toLowerCase() !== '.exe') {
315
- const packageFile = path.join(path.dirname(codexPath), 'node_modules', '@openai', 'codex', 'package.json');
316
- const platformName = `@openai/codex-win32-${process.arch}`;
317
- let platformFile;
318
- try {
319
- platformFile = createRequire(packageFile).resolve(`${platformName}/package.json`);
320
- }
321
- catch (error) {
322
- throw new Error(`Codex is installed but its Windows native package "${platformName}" is missing `
323
- + `(${error?.message || String(error)}). npm silently drops optional packages on download timeout; `
324
- + 'reinstall Codex with a longer timeout, e.g. `npm install -g @openai/codex --fetch-timeout=600000`. '
325
- + noSandboxHint, { cause: error });
326
- }
327
- const target = process.arch === 'arm64' ? 'aarch64-pc-windows-msvc' : 'x86_64-pc-windows-msvc';
328
- command = path.join(path.dirname(platformFile), 'vendor', target, 'bin', 'codex.exe');
329
- }
330
- if (!fs.statSync(command).isFile()) {
331
- throw new Error(`Codex is installed but the native sandbox executable is missing at "${command}". `
332
- + 'Reinstall Codex (`npm install -g @openai/codex`). ' + noSandboxHint);
333
- }
334
- const home = resolveRealDirectory(process.env.CODEX_HOME || path.join(os.homedir(), '.codex'), 'Codex control home');
335
- let marker;
336
- try {
337
- marker = JSON.parse(fs.readFileSync(path.join(home, '.sandbox', 'setup_marker.json'), 'utf8'));
338
- }
339
- catch { }
340
- let users;
341
- try {
342
- users = JSON.parse(fs.readFileSync(path.join(home, '.sandbox-secrets', 'sandbox_users.json'), 'utf8'));
343
- }
344
- catch { }
345
- if (!marker || marker.version !== WINDOWS_SANDBOX_SETUP_VERSION || marker.allow_local_binding !== false
346
- || !Array.isArray(marker.proxy_ports) || marker.proxy_ports.length !== 0
347
- || !users || users.version !== WINDOWS_SANDBOX_SETUP_VERSION
348
- || users.offline?.username !== 'CodexSandboxOffline' || typeof users.offline?.password !== 'string' || !users.offline.password
349
- || users.online?.username !== 'CodexSandboxOnline' || typeof users.online?.password !== 'string' || !users.online.password
350
- || !fs.existsSync(path.join(home, '.sandbox-bin'))
351
- || !fs.readdirSync(path.join(home, '.sandbox-bin')).some(name => /^codex-command-runner-.+\.exe$/.test(name))) {
352
- throw new Error(`Codex's Windows restricted-read sandbox is not provisioned in "${home}" `
353
- + `(expected setup_marker version ${WINDOWS_SANDBOX_SETUP_VERSION}, sandbox users `
354
- + 'CodexSandboxOffline/Online, and a codex-command-runner-*.exe in .sandbox-bin). '
355
- + 'Automatic elevation is disabled by design — run the elevated setup once in a host terminal: '
356
- + 'Codex Desktop → Windows Sandbox settings → setup/repair (elevated, accept one UAC prompt). '
357
- + 'Then verify with `codex doctor --json` (backend=elevated, provisioning=complete) and '
358
- + '`codex sandbox -- cmd /c whoami` (should show CodexSandboxOffline/Online, not your desktop user). '
359
- + 'Troubleshooting: kits/docs/evolcore/codex-windows-sandbox.md. ' + noSandboxHint);
360
- }
361
- return { command: fs.realpathSync.native(command), home };
362
- }
363
295
  function resolveRealDirectory(value, label) {
364
296
  if (!path.isAbsolute(value))
365
297
  throw new Error(`${label} must be absolute`);
@@ -375,7 +307,7 @@ function assertRealDirectory(value, label) {
375
307
  function samePath(left, right) {
376
308
  return isSameOrDescendant(left, right) && isSameOrDescendant(right, left);
377
309
  }
378
- function readScriptSnapshot(value, triggerDir) {
310
+ export function readScriptSnapshot(value, triggerDir) {
379
311
  const scriptPath = path.resolve(value);
380
312
  const validate = () => {
381
313
  if (!isSameOrDescendant(scriptPath, triggerDir))
@@ -431,7 +363,14 @@ const SCRIPT_STAGING_TOTAL_LIMIT = 32 * 1024 * 1024;
431
363
  /** 暂存文件数上限:node_modules/.git 已跳过,剩余仍超此数说明目录不是脚手架。 */
432
364
  const SCRIPT_STAGING_FILE_COUNT = 2_000;
433
365
  /**
434
- * 暂存脚本快照:入口脚本(原 `readScriptSnapshot` 字节)+ 其所在目录的兄弟文件树。
366
+ * 包根里不进入快照的运行时产物。
367
+ *
368
+ * 它们与脚本能不能跑无关,却可能很大(日志归档、台账、幂等记录)。混进去会撞
369
+ * 32 MiB / 2000 文件上限,把一次正常调用降级成无沙箱执行——那比暂存不完整更糟。
370
+ */
371
+ export const SNAPSHOT_SKIP_TOP_ENTRIES = ['logs', 'ledger.jsonl', 'idempotency.json', '.archived'];
372
+ /**
373
+ * 暂存脚本快照:入口脚本(原 `readScriptSnapshot` 字节)+ 暂存根下的其余文件树。
435
374
  *
436
375
  * 原实现只写入口单文件,相对导入(`./lib/*.mjs`)在暂存目录里不存在——沙箱一生效
437
376
  * 就 `ERR_MODULE_NOT_FOUND`,沙箱降级(fallback 跑原路径)时反而能跑,症状时隐时现。
@@ -439,12 +378,27 @@ const SCRIPT_STAGING_FILE_COUNT = 2_000;
439
378
  * `preserveNodeModuleType` 统一合成,避免 `wx` 冲突)。每个文件走与入口相同的
440
379
  * lstat/fd 校验(防 TOCTOU/软链),越界文件直接抛错走沙箱不可用降级。
441
380
  */
442
- function stageScriptSnapshot(scriptSource, triggerDir, scriptBytes, snapshotDir) {
443
- const scriptName = path.basename(scriptSource);
444
- const scriptPath = path.join(snapshotDir, scriptName);
381
+ export function stageScriptSnapshot(scriptSource, triggerDir, scriptBytes, snapshotDir, options = {}) {
382
+ const rootDir = path.resolve(options.rootDir ?? path.dirname(path.resolve(scriptSource)));
383
+ assertRealDirectory(rootDir, 'Trigger script directory');
384
+ // 快照目录落在暂存根里 = 边遍历边往遍历范围内写,每一轮都会把上一轮的产物再读一遍。
385
+ // 结果不是"多点文件",是把磁盘写满。这种配置错误必须在第一个文件落盘前撞墙。
386
+ const snapshotResolved = path.resolve(snapshotDir);
387
+ if (snapshotResolved === rootDir || isSameOrDescendant(snapshotResolved, rootDir)) {
388
+ throw new Error('script snapshot directory must not be inside the snapshot root');
389
+ }
390
+ const entryRelative = path.relative(rootDir, path.resolve(scriptSource));
391
+ if (!entryRelative || entryRelative.startsWith('..') || path.isAbsolute(entryRelative)) {
392
+ throw new Error(`script entry is outside snapshot root: ${scriptSource}`);
393
+ }
394
+ // 入口按相对布局写入,跨目录的 import 才能和本地运行落在同一条路径上。
395
+ const scriptPath = path.join(snapshotDir, entryRelative);
396
+ fs.mkdirSync(path.dirname(scriptPath), { recursive: true, mode: 0o700 });
445
397
  fs.writeFileSync(scriptPath, scriptBytes, { flag: 'wx', mode: 0o400 });
446
- const scriptDir = path.dirname(path.resolve(scriptSource));
447
- assertRealDirectory(scriptDir, 'Trigger script directory');
398
+ // 只有显式给了暂存根(服务包)才跳过点开头条目:那是 `.old-<ts>` / `.pending-*`
399
+ // 这类运行时标记;trigger 的脚本目录保持原行为,不替它猜哪些文件不该带。
400
+ const scopedRoot = options.rootDir !== undefined;
401
+ const skipTop = new Set(['package.json', 'node_modules', '.git', ...(options.skipTopEntries ?? [])]);
448
402
  let total = scriptBytes.length;
449
403
  let count = 1;
450
404
  const stage = (dir, rel) => {
@@ -452,12 +406,21 @@ function stageScriptSnapshot(scriptSource, triggerDir, scriptBytes, snapshotDir)
452
406
  for (const entry of entries) {
453
407
  const name = entry.name;
454
408
  const relPath = rel ? path.join(rel, name) : name;
455
- if (!rel && (name === scriptName || name === 'package.json' || name === 'node_modules' || name === '.git'))
409
+ // 入口已经按字节写过;它可能在任意深度(`scripts/<子目录>/`),不能只看顶层。
410
+ if (relPath === entryRelative)
456
411
  continue;
412
+ if (!rel) {
413
+ // 其余顶层条目按名单或点前缀过滤。
414
+ if (skipTop.has(name))
415
+ continue;
416
+ if (scopedRoot && name.startsWith('.'))
417
+ continue;
418
+ }
457
419
  if (entry.isSymbolicLink())
458
420
  throw new Error(`script snapshot must not contain symlinks: ${relPath}`);
459
421
  if (entry.isDirectory()) {
460
- fs.mkdirSync(path.join(snapshotDir, relPath), { mode: 0o700 });
422
+ // recursive:入口所在的那条目录链在写入口时已经建好了。
423
+ fs.mkdirSync(path.join(snapshotDir, relPath), { recursive: true, mode: 0o700 });
461
424
  stage(path.join(dir, name), relPath);
462
425
  }
463
426
  else if (entry.isFile()) {
@@ -474,10 +437,10 @@ function stageScriptSnapshot(scriptSource, triggerDir, scriptBytes, snapshotDir)
474
437
  }
475
438
  }
476
439
  };
477
- stage(scriptDir, '');
440
+ stage(rootDir, '');
478
441
  return scriptPath;
479
442
  }
480
- function preserveNodeModuleType(runtime, scriptPath, snapshotDir) {
443
+ export function preserveNodeModuleType(runtime, scriptPath, snapshotDir) {
481
444
  if (!/^node(?:\.exe)?$/i.test(path.basename(runtime)) || path.extname(scriptPath) !== '.js')
482
445
  return;
483
446
  let current = path.dirname(scriptPath);
@@ -520,121 +483,3 @@ function getScriptEnvironmentExcludes() {
520
483
  const dynamic = Object.keys(process.env).filter(key => key.toUpperCase().startsWith('EVOLCORE_') || isCredentialEnvironmentName(key));
521
484
  return [...new Set([...SCRIPT_ENVIRONMENT_EXCLUDES, ...dynamic])];
522
485
  }
523
- function filesystemEntry(value, access) {
524
- return { path: { type: 'path', path: path.resolve(value) }, access };
525
- }
526
- /**
527
- * 证明 Windows 沙箱的文件策略确实被执行。
528
- *
529
- * 这里验证的是「**显式 deny 生效**」,不是「默认拒绝读」——Codex 的 Windows
530
- * 沙箱与 Linux 的 `--ro-bind / /` 同为「默认放行 + 显式 deny」语义:策略里
531
- * `{ kind: 'root' }` 给 read,其余 deny 条目在其上做减法。因此拿一个不在
532
- * deny 列表里的路径去期望 EACCES 永远不成立,只会把每次脚本执行都判成失败。
533
- *
534
- * 三步:
535
- * 1. 读 canary 且策略里显式给 `read` → 必须成功(证明「能读」,策略未被整体拒绝)
536
- * 2. 同一个 canary 在策略里显式给 `deny` → 必须 EACCES/EPERM
537
- * (证明 deny 真的被沙箱执行;这一步失败说明沙箱没起效,必须拒跑)
538
- * 3. 在 workDir 写文件 → 必须成功(证明 scoped 路径没有把整个文件系统锁死)
539
- */
540
- async function verifyWindowsReadIsolation(launch, sandboxArgs, runDir, workDir, signal) {
541
- signal?.throwIfAborted();
542
- const canary = path.join(runDir, 'read-isolation-canary');
543
- const writableProbe = path.join(workDir, 'write-isolation-probe');
544
- fs.writeFileSync(canary, 'evolcore-read-isolation-canary', { flag: 'wx' });
545
- const readProbe = [
546
- 'const fs = require("node:fs");',
547
- 'if (fs.readFileSync(process.argv[1], "utf8") !== "evolcore-read-isolation-canary") process.exit(91);',
548
- 'process.stdout.write("evolcore-trigger-sandbox-ready");',
549
- ].join('\n');
550
- // 策略里显式 deny 的同一个文件必须读不到;能读到就说明沙箱没执行策略。
551
- const denyProbe = [
552
- 'const fs = require("node:fs");',
553
- 'let denied = false;',
554
- 'try { fs.readFileSync(process.argv[1]); } catch (error) {',
555
- 'if (error.code === "EACCES" || error.code === "EPERM" || error.code === "ENOENT") denied = true; else throw error;',
556
- '}',
557
- 'if (!denied) { process.stderr.write("deny enforcement is not applied: denied path was readable"); process.exit(90); }',
558
- 'fs.writeFileSync(process.argv[2], "allowed");',
559
- 'process.stdout.write("evolcore-trigger-sandbox-ready");',
560
- ].join('\n');
561
- const withExtraEntry = (extra) => {
562
- const args = [...sandboxArgs];
563
- const stateIndex = args.indexOf('--sandbox-state-json') + 1;
564
- const state = JSON.parse(args[stateIndex]);
565
- state.permissionProfile.file_system.entries.push(extra);
566
- args[stateIndex] = JSON.stringify(state);
567
- if (args[stateIndex].length > 20_000)
568
- throw new Error('filesystem probe policy exceeds the command-line budget');
569
- return args;
570
- };
571
- try {
572
- await runWindowsIsolationProbe(launch, withExtraEntry(filesystemEntry(canary, 'read')), readProbe, [canary], signal);
573
- await runWindowsIsolationProbe(launch, withExtraEntry(filesystemEntry(canary, 'deny')), denyProbe, [canary, writableProbe], signal);
574
- }
575
- catch (error) {
576
- throw new Error(`Windows sandbox cannot prove scoped read isolation; Trigger script execution is refused: ${error?.message || String(error)}`, { cause: error });
577
- }
578
- finally {
579
- try {
580
- fs.unlinkSync(canary);
581
- }
582
- catch { }
583
- try {
584
- fs.unlinkSync(writableProbe);
585
- }
586
- catch { }
587
- }
588
- }
589
- function runWindowsIsolationProbe(launch, sandboxArgs, probe, probeArgs, signal) {
590
- signal?.throwIfAborted();
591
- return new Promise((resolve, reject) => {
592
- const child = spawn(launch.command, [...sandboxArgs, '--', process.execPath, '-e', probe, ...probeArgs], {
593
- cwd: launch.cwd, env: launch.env, stdio: ['ignore', 'pipe', 'pipe'], windowsHide: true,
594
- });
595
- let stdout = '';
596
- let stderr = '';
597
- let settled = false;
598
- let terminationError;
599
- const terminate = (error) => {
600
- if (settled || terminationError)
601
- return;
602
- terminationError = error;
603
- if (!child.pid || !killProcess(child.pid, true)) {
604
- try {
605
- child.kill('SIGKILL');
606
- }
607
- catch { }
608
- }
609
- };
610
- const abortHandler = () => terminate(new Error('isolation verification was aborted'));
611
- const timer = setTimeout(() => terminate(new Error('isolation verification timed out')), 15_000);
612
- timer.unref();
613
- const finish = (error) => {
614
- if (settled)
615
- return;
616
- settled = true;
617
- clearTimeout(timer);
618
- signal?.removeEventListener('abort', abortHandler);
619
- if (error)
620
- reject(error);
621
- else
622
- resolve();
623
- };
624
- child.stdout.on('data', bytes => { stdout = (stdout + bytes.toString()).slice(0, 2048); });
625
- child.stderr.on('data', bytes => { stderr = (stderr + bytes.toString()).slice(0, 2048); });
626
- child.once('error', error => finish(terminationError ?? error));
627
- child.once('close', code => {
628
- if (terminationError)
629
- finish(terminationError);
630
- else if (code === 0 && stdout === 'evolcore-trigger-sandbox-ready')
631
- finish();
632
- else
633
- finish(new Error(stderr.trim() || `isolation verification exited with code ${code}`));
634
- });
635
- if (signal?.aborted)
636
- abortHandler();
637
- else
638
- signal?.addEventListener('abort', abortHandler, { once: true });
639
- });
640
- }
@@ -4,6 +4,31 @@ import { getPackageRoot } from '../paths.js';
4
4
  import { TASK_RECOVERY_PROMPT } from '../core/task/task-recovery-service.js';
5
5
  import { atomicWriteJson } from '../core/session/session-fs-store.js';
6
6
  import { normalizeTriggerDefinition } from './validation.js';
7
+ export const AGENT_TEMPLATE_CHECK_TRIGGER = '__agent-template-upgrade-check';
8
+ export const AGENT_TEMPLATE_CHECK_SCRIPT = 'agent-template-upgrade-check.cjs';
9
+ /** One read-only check per daemon; Owner edits to schedule/enabled survive startup. */
10
+ export function seedAgentTemplateCheckTrigger(manager, owner) {
11
+ if (manager.get(AGENT_TEMPLATE_CHECK_TRIGGER))
12
+ return;
13
+ const now = Date.now();
14
+ const peerId = owner.originPeerId || owner.aid;
15
+ const definition = normalizeTriggerDefinition({
16
+ $schema_version: 3.1, id: AGENT_TEMPLATE_CHECK_TRIGGER, agentAid: owner.aid, enabled: true,
17
+ name: 'Agent 模板升级检查', description: 'Read-only single-Agent template release checks; never installs or calls a model.',
18
+ createdAt: now, updatedAt: now,
19
+ origin: { channelKey: 'daemon', channelType: 'daemon', channelId: peerId, session: 'main', peerId,
20
+ sessionKey: `daemon#${peerId}#${AGENT_TEMPLATE_CHECK_TRIGGER}` },
21
+ source: { type: 'cron', expression: '17 4 * * *', timezone: 'Asia/Shanghai' },
22
+ execution: { type: 'script', script: { path: AGENT_TEMPLATE_CHECK_SCRIPT, runtime: 'node', timeoutMs: 900000 },
23
+ permissionMode: 'bypass', onError: 'fail', noopSentinel: '[[NOOP]]' },
24
+ feedback: { strategy: 'silent' },
25
+ reliability: { concurrency: 'forbid', missedPolicy: 'run_once', retry: { maxAttempts: 1, backoffMs: 30000 } },
26
+ });
27
+ fs.mkdirSync(manager.triggerDir(definition.id), { recursive: true });
28
+ // Actual execution is bound to the in-process runtime after normal Trigger authorization.
29
+ fs.writeFileSync(path.join(manager.triggerDir(definition.id), AGENT_TEMPLATE_CHECK_SCRIPT), 'throw new Error("Agent template check requires its owning daemon runtime");\n', { mode: 0o600 });
30
+ atomicWriteJson(manager.definitionPath(definition.id), definition);
31
+ }
7
32
  export function seedUpgradeCheckTrigger(manager, owner) {
8
33
  const now = Date.now();
9
34
  const scriptName = 'upgrade-check.cjs';
@@ -1,7 +1,7 @@
1
1
  import path from 'path';
2
2
  import crypto from 'crypto';
3
3
  import { normalizePermissionMode as normalizePermissionModeContract } from '../core/permission/mode.js';
4
- import { formatChannelKey } from '../core/channel-loader.js';
4
+ import { formatChannelKey } from '../core/channel/channel-loader.js';
5
5
  import { isTopicThreadId } from '../core/thread/topic-id.js';
6
6
  const MAX_SCRIPT_TIMEOUT_MS = 900_000;
7
7
  const TRIGGER_SESSION_TIMEOUT_MS = 30 * 60_000;
@@ -1,4 +1,5 @@
1
1
  import { randomBytes, randomUUID, timingSafeEqual, createHash } from 'crypto';
2
+ import os from 'node:os';
2
3
  import { loadAgent } from '../config-store.js';
3
4
  import { isValidAid } from '../aun/aid/validation.js';
4
5
  import { ownerResolver } from '../core/ownership/owner-resolver.js';
@@ -42,6 +43,8 @@ export class BindService {
42
43
  return { ok: true, taskId: session.id, expiresAt: session.expiresAt, qrData: {
43
44
  type: 'evolcore.bind', version: readInstalledEvolcoreVersion(),
44
45
  platform: process.platform === 'win32' ? 'windows' : process.platform,
46
+ // 机器名随二维码带给 App:主机列表的默认显示名要用它,而不是 agent 的名字。
47
+ hostName: os.hostname(),
45
48
  bindType: session.bindType, subjectAid, receiverAid: this.options.receiverAid,
46
49
  token: session.token, expiresAt: session.expiresAt,
47
50
  } };
@@ -16,7 +16,7 @@
16
16
  import fs from 'fs';
17
17
  import path from 'path';
18
18
  import os from 'os';
19
- import { randomUUID } from 'crypto';
19
+ import { createHash, randomUUID } from 'crypto';
20
20
  import { isProcessRunning } from './cross-platform.js';
21
21
  const HOT = '_'; // foo.json_ 旧版热备
22
22
  const TMP = '__'; // foo.json__ 写入中
@@ -363,3 +363,90 @@ export function atomicReplaceFile(source, destination, options = {}) {
363
363
  }
364
364
  throw lastError;
365
365
  }
366
+ export const RUNTIME_LOCK_DIR_ENV = 'EVOLCORE_RUNTIME_LOCK_DIR';
367
+ /**
368
+ * Resolve a task-provided lock location without accepting relative or escaped
369
+ * paths. When no managed task context is present, callers retain their legacy
370
+ * on-disk lock path for daemon-side compatibility and migration tooling.
371
+ */
372
+ export function resolveManagedLockPath(namespace, identity, legacyPath) {
373
+ const configured = process.env[RUNTIME_LOCK_DIR_ENV]?.trim();
374
+ if (!configured || !path.isAbsolute(configured) || !namespace || !identity || !isTrustedRuntimeLockDir(configured)) {
375
+ return legacyPath;
376
+ }
377
+ const digest = createHash('sha256').update(identity).digest('hex').slice(0, 24);
378
+ return path.join(path.resolve(configured), namespace, `${digest}.lock`);
379
+ }
380
+ function isTrustedRuntimeLockDir(candidate) {
381
+ const resolved = path.resolve(candidate);
382
+ const tmpRoot = process.env.TMPDIR?.trim();
383
+ if (!tmpRoot || !path.isAbsolute(tmpRoot))
384
+ return false;
385
+ const resolvedTmpRoot = path.resolve(tmpRoot);
386
+ const tmpBase = path.basename(resolvedTmpRoot);
387
+ const isSessionLockDir = /^ec-session-[a-f0-9]{24}$/.test(tmpBase)
388
+ && path.basename(resolved) === 'locks'
389
+ && path.dirname(resolved) === resolvedTmpRoot;
390
+ // The app-server process has no EvolCore session yet and retains its own
391
+ // process-lifetime lock namespace. Both process and session roots use the
392
+ // same `$TMPDIR/locks` layout.
393
+ const isProcessLockDir = /^evolcore-managed-tmp-/.test(tmpBase)
394
+ && path.basename(resolved) === 'locks'
395
+ && path.dirname(resolved) === resolvedTmpRoot;
396
+ if (!isSessionLockDir && !isProcessLockDir)
397
+ return false;
398
+ try {
399
+ // Windows Stats.mode does not describe ACL privacy. The managed runtime
400
+ // roots are protected by Windows ACL inheritance, so apply POSIX
401
+ // ownership and permission-bit checks only where those fields are
402
+ // meaningful.
403
+ const isWindows = process.platform === 'win32';
404
+ const tmpStat = fs.lstatSync(resolvedTmpRoot);
405
+ if (!tmpStat.isDirectory() || tmpStat.isSymbolicLink())
406
+ return false;
407
+ if (!isWindows && typeof process.getuid === 'function' && tmpStat.uid !== process.getuid())
408
+ return false;
409
+ if (!isWindows && (tmpStat.mode & 0o077) !== 0)
410
+ return false;
411
+ const stat = fs.lstatSync(resolved);
412
+ if (!stat.isDirectory() || stat.isSymbolicLink())
413
+ return false;
414
+ if (!isWindows && typeof process.getuid === 'function' && stat.uid !== process.getuid())
415
+ return false;
416
+ return isWindows || (stat.mode & 0o077) === 0;
417
+ }
418
+ catch {
419
+ return false;
420
+ }
421
+ }
422
+ export function ensureManagedLockParent(lockPath) {
423
+ const configured = process.env[RUNTIME_LOCK_DIR_ENV]?.trim();
424
+ if (!configured || !isTrustedRuntimeLockDir(configured)) {
425
+ throw new Error('managed runtime lock directory is not trusted');
426
+ }
427
+ const root = path.resolve(configured);
428
+ const parent = path.resolve(path.dirname(lockPath));
429
+ const relative = path.relative(root, parent);
430
+ if (relative === '..' || relative.startsWith(`..${path.sep}`) || path.isAbsolute(relative)) {
431
+ throw new Error('managed runtime lock parent escapes its runtime directory');
432
+ }
433
+ // Create each component individually. mkdir({recursive:true}) would follow a
434
+ // pre-existing symlink in a namespace component before it can be checked.
435
+ let current = root;
436
+ for (const segment of relative.split(path.sep).filter(Boolean)) {
437
+ current = path.join(current, segment);
438
+ try {
439
+ fs.mkdirSync(current, { mode: 0o700 });
440
+ }
441
+ catch (error) {
442
+ if (error?.code !== 'EEXIST')
443
+ throw error;
444
+ }
445
+ const stat = fs.lstatSync(current);
446
+ if (!stat.isDirectory() || stat.isSymbolicLink()
447
+ || (process.platform !== 'win32' && typeof process.getuid === 'function' && stat.uid !== process.getuid())
448
+ || (process.platform !== 'win32' && (stat.mode & 0o077) !== 0)) {
449
+ throw new Error(`managed runtime lock path is not a private real directory: ${current}`);
450
+ }
451
+ }
452
+ }
@@ -1240,52 +1240,14 @@ function parseDateString(value) {
1240
1240
  return Number.isNaN(parsed) ? null : parsed;
1241
1241
  }
1242
1242
  /**
1243
- * Cross-platform command existence check.
1243
+ * Check current executable paths so installation, removal and PATH changes
1244
+ * are visible without restarting a long-running daemon.
1244
1245
  */
1245
- const _commandExistsCache = new Map();
1246
- const commandExistsPending = new Map();
1247
- /** Daemon inventory probes must not block IPC on where/which. */
1248
1246
  export async function commandExistsAsync(cmd) {
1249
- const cached = _commandExistsCache.get(cmd);
1250
- if (cached !== undefined)
1251
- return cached;
1252
- const existing = commandExistsPending.get(cmd);
1253
- if (existing)
1254
- return existing;
1255
- const pending = execFileAsync(isWindows ? 'where.exe' : 'which', [cmd], {
1256
- encoding: 'utf8', windowsHide: true, timeout: 3_000,
1257
- }).then(() => true, () => false);
1258
- commandExistsPending.set(cmd, pending);
1259
- try {
1260
- const exists = await pending;
1261
- _commandExistsCache.set(cmd, exists);
1262
- return exists;
1263
- }
1264
- finally {
1265
- if (commandExistsPending.get(cmd) === pending)
1266
- commandExistsPending.delete(cmd);
1267
- }
1247
+ return commandExists(cmd);
1268
1248
  }
1269
1249
  export function commandExists(cmd) {
1270
- const cached = _commandExistsCache.get(cmd);
1271
- if (cached !== undefined)
1272
- return cached;
1273
- let exists = false;
1274
- try {
1275
- if (isWindows) {
1276
- const r = spawnSync('where.exe', [cmd], { encoding: 'utf-8', stdio: 'pipe', windowsHide: true });
1277
- exists = r.status === 0;
1278
- }
1279
- else {
1280
- execFileSync('which', [cmd], { encoding: 'utf-8', stdio: 'pipe' });
1281
- exists = true;
1282
- }
1283
- }
1284
- catch {
1285
- exists = false;
1286
- }
1287
- _commandExistsCache.set(cmd, exists);
1288
- return exists;
1250
+ return resolveProbePath(cmd) !== null;
1289
1251
  }
1290
1252
  /**
1291
1253
  * 解析命令的真实可执行文件绝对路径。