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,8 +1,11 @@
1
1
  import fs from 'fs';
2
2
  import path from 'path';
3
- import { execFileSync } from 'node:child_process';
4
- import { resolveCommandPath } from '../../utils/cross-platform.js';
5
- import { getExistingHClassMaskTargets, getExistingRelationAttachmentDirs, getExistingLClassReadOnlyTargets, isSameOrDescendant, } from './protected-paths.js';
3
+ import os from 'node:os';
4
+ import { createRequire } from 'node:module';
5
+ import { pathToFileURL } from 'node:url';
6
+ import { execFileSync, spawn } from 'node:child_process';
7
+ import { killProcess, resolveCommandPath, resolveProbePath } from '../../utils/cross-platform.js';
8
+ import { buildCodexProtectedFilesystemRules, getExistingHClassMaskTargets, getExistingRelationAttachmentDirs, getExistingLClassReadOnlyTargets, isSameOrDescendant, } from './protected-paths.js';
6
9
  import { resolveInstanceSocketPath, resolveRoot } from '../../paths.js';
7
10
  import { MAIN_CLI_BIN } from '../../product.js';
8
11
  let sandboxInitializationCircuit;
@@ -99,12 +102,17 @@ export function shouldLogSandboxCircuitNotice(now = Date.now(), intervalMs = SAN
99
102
  sandboxCircuitNoticeAt = now;
100
103
  return true;
101
104
  }
105
+ export function isWindowsCodexSandboxProvisioningFailure(error) {
106
+ const message = error instanceof Error ? error.message : String(error ?? '');
107
+ return /failed to prepare Windows sandbox:\s*app runtime provisioning service is unavailable; refusing helper fallback/i.test(message);
108
+ }
102
109
  /** Recognize sandbox bootstrap failures independently of localized stderr. */
103
110
  export function isSandboxInitializationFailure(error, stderr = []) {
104
111
  const text = [error instanceof Error ? error.message : String(error ?? ''), ...stderr]
105
112
  .join('\n')
106
113
  .toLowerCase();
107
114
  return text.includes(SANDBOX_INITIALIZATION_FAILED)
115
+ || isWindowsCodexSandboxProvisioningFailure(text)
108
116
  || (text.includes('sandbox required but unavailable') && !isClaudeSandboxDependencyFailure(text))
109
117
  || /fs sandbox helper failed(?: with status)?\b/.test(text)
110
118
  || /(?:apply-seccomp|seccomp)[\s\S]*(?:uid_map|gid_map|operation not permitted)/.test(text)
@@ -798,6 +806,8 @@ export function buildHClassGuardCommand(executable, executableArgs, root = resol
798
806
  ];
799
807
  if (options.protectEvolcoreFilesystem !== false) {
800
808
  appendLClassReadOnlyBinds(args, path.resolve(root), options);
809
+ for (const directory of options.readonlyPaths ?? [])
810
+ pushReadonlyBind(args, directory);
801
811
  appendHClassMasks(args, path.resolve(root), true, options);
802
812
  appendDaemonIpcSocket(args, path.resolve(root));
803
813
  }
@@ -888,3 +898,257 @@ export function _resetSandboxRuntimeCache() {
888
898
  sandboxCircuitNoticeAt = 0;
889
899
  sandboxInitializationFailureCounters = emptySandboxInitializationFailureCounters();
890
900
  }
901
+ const WINDOWS_SANDBOX_SETUP_VERSION = 5;
902
+ /**
903
+ * Discover the provisioned Codex Windows filesystem backend without loading a Runner.
904
+ * Codex supplies the sandbox executable only; no model or agent session is started.
905
+ * Missing installation, native package or provisioning each fail explicitly.
906
+ */
907
+ export function resolveWindowsSandboxBackend() {
908
+ const noSandboxHint = 'Provision the Windows sandbox on the host before retrying; '
909
+ + 'an unavailable sandbox is never bypassed automatically.';
910
+ const codexPath = resolveProbePath('codex');
911
+ if (!codexPath) {
912
+ throw new Error('Codex CLI is required for scoped Windows command isolation, but `codex` was not found on PATH. '
913
+ + 'EvolCore only uses it as the Windows sandbox host — install it with `npm install -g @openai/codex`, '
914
+ + 'then re-run. ' + noSandboxHint);
915
+ }
916
+ let command = codexPath;
917
+ if (path.extname(command).toLowerCase() !== '.exe') {
918
+ const packageFile = path.join(path.dirname(codexPath), 'node_modules', '@openai', 'codex', 'package.json');
919
+ const platformName = `@openai/codex-win32-${process.arch}`;
920
+ let platformFile;
921
+ try {
922
+ platformFile = createRequire(packageFile).resolve(`${platformName}/package.json`);
923
+ }
924
+ catch (error) {
925
+ throw new Error(`Codex is installed but its Windows native package "${platformName}" is missing `
926
+ + `(${error?.message || String(error)}). npm silently drops optional packages on download timeout; `
927
+ + 'reinstall Codex with a longer timeout, e.g. `npm install -g @openai/codex --fetch-timeout=600000`. '
928
+ + noSandboxHint, { cause: error });
929
+ }
930
+ const target = process.arch === 'arm64' ? 'aarch64-pc-windows-msvc' : 'x86_64-pc-windows-msvc';
931
+ command = path.join(path.dirname(platformFile), 'vendor', target, 'bin', 'codex.exe');
932
+ }
933
+ if (!fs.statSync(command).isFile()) {
934
+ throw new Error(`Codex is installed but the native sandbox executable is missing at "${command}". `
935
+ + 'Reinstall Codex (`npm install -g @openai/codex`). ' + noSandboxHint);
936
+ }
937
+ const configuredHome = process.env.CODEX_HOME || path.join(os.homedir(), '.codex');
938
+ if (!path.isAbsolute(configuredHome))
939
+ throw new Error('Codex control home must be absolute');
940
+ const homePath = path.resolve(configuredHome);
941
+ const homeStat = fs.lstatSync(homePath);
942
+ if (!homeStat.isDirectory() || homeStat.isSymbolicLink()) {
943
+ throw new Error('Codex control home must be a real directory without symlinks or junctions');
944
+ }
945
+ const home = fs.realpathSync.native(homePath);
946
+ if (!isSameOrDescendant(home, homePath) || !isSameOrDescendant(homePath, home)) {
947
+ throw new Error('Codex control home must be a real directory without symlinks or junctions');
948
+ }
949
+ let marker;
950
+ try {
951
+ marker = JSON.parse(fs.readFileSync(path.join(home, '.sandbox', 'setup_marker.json'), 'utf8'));
952
+ }
953
+ catch { }
954
+ let users;
955
+ try {
956
+ users = JSON.parse(fs.readFileSync(path.join(home, '.sandbox-secrets', 'sandbox_users.json'), 'utf8'));
957
+ }
958
+ catch { }
959
+ if (!marker || marker.version !== WINDOWS_SANDBOX_SETUP_VERSION || marker.allow_local_binding !== false
960
+ || !Array.isArray(marker.proxy_ports) || marker.proxy_ports.length !== 0
961
+ || !users || users.version !== WINDOWS_SANDBOX_SETUP_VERSION
962
+ || users.offline?.username !== 'CodexSandboxOffline' || typeof users.offline?.password !== 'string' || !users.offline.password
963
+ || users.online?.username !== 'CodexSandboxOnline' || typeof users.online?.password !== 'string' || !users.online.password
964
+ || !fs.existsSync(path.join(home, '.sandbox-bin'))
965
+ || !fs.readdirSync(path.join(home, '.sandbox-bin')).some(name => /^codex-command-runner-.+\.exe$/.test(name))) {
966
+ throw new Error(`Codex's Windows restricted-read sandbox is not provisioned in "${home}" `
967
+ + `(expected setup_marker version ${WINDOWS_SANDBOX_SETUP_VERSION}, sandbox users `
968
+ + 'CodexSandboxOffline/Online, and a codex-command-runner-*.exe in .sandbox-bin). '
969
+ + 'Automatic elevation is disabled by design — run the elevated setup once in a host terminal: '
970
+ + 'Codex Desktop → Windows Sandbox settings → setup/repair (elevated, accept one UAC prompt). '
971
+ + 'Then verify with `codex doctor --json` (backend=elevated, provisioning=complete) and '
972
+ + '`codex sandbox -- cmd /c whoami` (should show CodexSandboxOffline/Online, not your desktop user). '
973
+ + 'Troubleshooting: kits/docs/evolcore/codex-windows-sandbox.md. ' + noSandboxHint);
974
+ }
975
+ return { command: fs.realpathSync.native(command), home };
976
+ }
977
+ /** Reuse the provisioned Codex file guard for agent-owned command trees; network stays enabled. */
978
+ export async function buildWindowsAgentSandboxLaunch(input) {
979
+ const backend = resolveWindowsSandboxBackend();
980
+ const root = resolveRoot();
981
+ const filesystem = buildCodexProtectedFilesystemRules(root, { selfAid: input.selfAid });
982
+ const entries = [
983
+ { path: { type: 'special', value: { kind: 'root' } }, access: 'read' },
984
+ buildWindowsFilesystemEntry(input.projectPath, input.readonly ? 'read' : 'write'),
985
+ buildWindowsFilesystemEntry(input.temporary, 'write'),
986
+ buildWindowsFilesystemEntry(backend.home, 'deny'),
987
+ ...Object.entries(filesystem).flatMap(([value, access]) => typeof access === 'number' ? [] : [{
988
+ path: /[*?[\]]/.test(value) ? { type: 'glob_pattern', pattern: value } : { type: 'path', path: value }, access,
989
+ }]),
990
+ ...getExistingRelationAttachmentDirs(root, { selfAid: input.selfAid, onlyOtherAgents: true })
991
+ .map(value => buildWindowsFilesystemEntry(value, 'deny')),
992
+ ];
993
+ const state = JSON.stringify({ permissionProfile: { type: 'managed',
994
+ file_system: { type: 'restricted', entries, glob_scan_max_depth: filesystem.glob_scan_max_depth },
995
+ network: 'enabled' }, sandboxCwd: pathToFileURL(input.projectPath).href });
996
+ if (state.length > 20_000)
997
+ throw new Error('Windows agent filesystem policy exceeds the command-line budget');
998
+ const sandboxArgs = ['sandbox', '--sandbox-state-json', state, '-c', 'windows.sandbox="elevated"'];
999
+ const launch = { command: backend.command,
1000
+ args: [...sandboxArgs, '--', input.command, ...input.args], cwd: input.projectPath,
1001
+ env: { ...input.env, CODEX_HOME: backend.home } };
1002
+ // Reuse the direct and descendant checks; an unprovisioned or ineffective guard refuses execution.
1003
+ const probeDir = fs.mkdtempSync(path.join(input.temporary, 'agent-sandbox-probe-'));
1004
+ try {
1005
+ await verifyWindowsReadIsolation(launch, sandboxArgs, probeDir, probeDir, input.signal, true);
1006
+ }
1007
+ finally {
1008
+ fs.rmSync(probeDir, { recursive: true, force: true });
1009
+ }
1010
+ return launch;
1011
+ }
1012
+ export function buildWindowsFilesystemEntry(value, access) {
1013
+ return { path: { type: 'path', path: path.resolve(value) }, access };
1014
+ }
1015
+ /**
1016
+ * 证明 Windows 沙箱的文件策略确实被执行。
1017
+ *
1018
+ * 这里验证的是「**显式 deny 生效**」,不是「默认拒绝读」——Codex 的 Windows
1019
+ * 沙箱与 Linux 的 `--ro-bind / /` 同为「默认放行 + 显式 deny」语义:策略里
1020
+ * `{ kind: 'root' }` 给 read,其余 deny 条目在其上做减法。因此拿一个不在
1021
+ * deny 列表里的路径去期望 EACCES 永远不成立,只会把每次脚本执行都判成失败。
1022
+ *
1023
+ * 三步:
1024
+ * 1. 读 canary 且策略里显式给 `read` → 必须成功(证明「能读」,策略未被整体拒绝)
1025
+ * 2. 同一个 canary 在策略里显式给 `deny` → 必须 EACCES/EPERM
1026
+ * (证明 deny 真的被沙箱执行;这一步失败说明沙箱没起效,必须拒跑)
1027
+ * 3. 在 workDir 写文件 → 必须成功(证明 scoped 路径没有把整个文件系统锁死)
1028
+ */
1029
+ export async function verifyWindowsReadIsolation(launch, sandboxArgs, runDir, workDir, signal, verifyGrandchild = false) {
1030
+ signal?.throwIfAborted();
1031
+ const canary = path.join(runDir, 'read-isolation-canary');
1032
+ const writableProbe = path.join(workDir, 'write-isolation-probe');
1033
+ fs.writeFileSync(canary, 'evolcore-read-isolation-canary', { flag: 'wx' });
1034
+ const readProbe = [
1035
+ 'const fs = require("node:fs");',
1036
+ 'if (fs.readFileSync(process.argv[1], "utf8") !== "evolcore-read-isolation-canary") process.exit(91);',
1037
+ 'process.stdout.write("evolcore-trigger-sandbox-ready");',
1038
+ ].join('\n');
1039
+ // 策略里显式 deny 的同一个文件必须读不到;能读到就说明沙箱没执行策略。
1040
+ const denyProbe = [
1041
+ 'const fs = require("node:fs");',
1042
+ 'let denied = false;',
1043
+ 'try { fs.readFileSync(process.argv[1]); } catch (error) {',
1044
+ 'if (error.code === "EACCES" || error.code === "EPERM" || error.code === "ENOENT") denied = true; else throw error;',
1045
+ '}',
1046
+ 'if (!denied) { process.stderr.write("deny enforcement is not applied: denied path was readable"); process.exit(90); }',
1047
+ 'fs.writeFileSync(process.argv[2], "allowed");',
1048
+ 'process.stdout.write("evolcore-trigger-sandbox-ready");',
1049
+ ].join('\n');
1050
+ // 孙进程版:沙箱内的这个 node 再 spawn 一个 node,由**后者**去读 deny 路径。
1051
+ // 服务宿主正是这个形状(宿主 → 脚本次进程),直接子进程被拦不能证明孙进程也被拦。
1052
+ const grandchildDenyProbe = [
1053
+ 'const { spawn } = require("node:child_process");',
1054
+ 'const inner = [',
1055
+ ' "const fs = require(\\"node:fs\\");",',
1056
+ ' "let denied = false;",',
1057
+ ' "try { fs.readFileSync(process.argv[1]); } catch (e) {",',
1058
+ ' "if (e.code === \\"EACCES\\" || e.code === \\"EPERM\\" || e.code === \\"ENOENT\\") denied = true; else throw e;",',
1059
+ ' "}",',
1060
+ ' "process.stdout.write(denied ? \\"denied\\" : \\"readable\\");",',
1061
+ '].join("\\n");',
1062
+ 'const child = spawn(process.execPath, ["-e", inner, process.argv[1]], { stdio: ["ignore", "pipe", "inherit"] });',
1063
+ 'let out = "";',
1064
+ 'child.stdout.on("data", b => { out += b.toString(); });',
1065
+ 'child.on("close", code => {',
1066
+ ' if (code !== 0) { process.stderr.write("grandchild probe exited " + code); process.exit(92); }',
1067
+ ' if (out.trim() !== "denied") {',
1068
+ ' process.stderr.write("grandchild escaped the sandbox: denied path was readable from a grandchild process");',
1069
+ ' process.exit(90);',
1070
+ ' }',
1071
+ ' process.stdout.write("evolcore-trigger-sandbox-ready");',
1072
+ '});',
1073
+ ].join('\n');
1074
+ const withExtraEntry = (extra) => {
1075
+ const args = [...sandboxArgs];
1076
+ const stateIndex = args.indexOf('--sandbox-state-json') + 1;
1077
+ const state = JSON.parse(args[stateIndex]);
1078
+ state.permissionProfile.file_system.entries.push(extra);
1079
+ args[stateIndex] = JSON.stringify(state);
1080
+ if (args[stateIndex].length > 20_000)
1081
+ throw new Error('filesystem probe policy exceeds the command-line budget');
1082
+ return args;
1083
+ };
1084
+ try {
1085
+ await runWindowsIsolationProbe(launch, withExtraEntry(buildWindowsFilesystemEntry(canary, 'read')), readProbe, [canary], signal);
1086
+ await runWindowsIsolationProbe(launch, withExtraEntry(buildWindowsFilesystemEntry(canary, 'deny')), verifyGrandchild ? grandchildDenyProbe : denyProbe, verifyGrandchild ? [canary] : [canary, writableProbe], signal);
1087
+ }
1088
+ catch (error) {
1089
+ throw new Error(`Windows sandbox cannot prove scoped read isolation${verifyGrandchild ? ' (including grandchild processes)' : ''}; `
1090
+ + `scoped execution is refused: ${error?.message || String(error)}`, { cause: error });
1091
+ }
1092
+ finally {
1093
+ try {
1094
+ fs.unlinkSync(canary);
1095
+ }
1096
+ catch { }
1097
+ try {
1098
+ fs.unlinkSync(writableProbe);
1099
+ }
1100
+ catch { }
1101
+ }
1102
+ }
1103
+ function runWindowsIsolationProbe(launch, sandboxArgs, probe, probeArgs, signal) {
1104
+ signal?.throwIfAborted();
1105
+ return new Promise((resolve, reject) => {
1106
+ const child = spawn(launch.command, [...sandboxArgs, '--', process.execPath, '-e', probe, ...probeArgs], {
1107
+ cwd: launch.cwd, env: launch.env, stdio: ['ignore', 'pipe', 'pipe'], windowsHide: true,
1108
+ });
1109
+ let stdout = '';
1110
+ let stderr = '';
1111
+ let settled = false;
1112
+ let terminationError;
1113
+ const terminate = (error) => {
1114
+ if (settled || terminationError)
1115
+ return;
1116
+ terminationError = error;
1117
+ if (!child.pid || !killProcess(child.pid, true)) {
1118
+ try {
1119
+ child.kill('SIGKILL');
1120
+ }
1121
+ catch { }
1122
+ }
1123
+ };
1124
+ const abortHandler = () => terminate(new Error('isolation verification was aborted'));
1125
+ const timer = setTimeout(() => terminate(new Error('isolation verification timed out')), 15_000);
1126
+ timer.unref();
1127
+ const finish = (error) => {
1128
+ if (settled)
1129
+ return;
1130
+ settled = true;
1131
+ clearTimeout(timer);
1132
+ signal?.removeEventListener('abort', abortHandler);
1133
+ if (error)
1134
+ reject(error);
1135
+ else
1136
+ resolve();
1137
+ };
1138
+ child.stdout.on('data', bytes => { stdout = (stdout + bytes.toString()).slice(0, 2048); });
1139
+ child.stderr.on('data', bytes => { stderr = (stderr + bytes.toString()).slice(0, 2048); });
1140
+ child.once('error', error => finish(terminationError ?? error));
1141
+ child.once('close', code => {
1142
+ if (terminationError)
1143
+ finish(terminationError);
1144
+ else if (code === 0 && stdout === 'evolcore-trigger-sandbox-ready')
1145
+ finish();
1146
+ else
1147
+ finish(new Error(stderr.trim() || `isolation verification exited with code ${code}`));
1148
+ });
1149
+ if (signal?.aborted)
1150
+ abortHandler();
1151
+ else
1152
+ signal?.addEventListener('abort', abortHandler, { once: true });
1153
+ });
1154
+ }
@@ -20,8 +20,15 @@
20
20
  *
21
21
  * ## 为什么 DENY 不含读位
22
22
  *
23
- * Codex 的 `access: 'deny'` 连读一起拒。服务脚本要读自己的 `pack.json`、要能被执行,
24
- * 所以只拒写数据 / 追加 / 写属性 / 删除 / 改 DACL / 改所有者这些位,`RX` 位保留。
23
+ * **先澄清实测事实**:沙箱身份本来就读不到 `services/` 树。`agents/<aid>` 根上有
24
+ * `CodexSandboxUsers:(DENY)(R)`(非继承)与 `(OI)(CI)(IO)(DENY)(R,GR)`(只对子对象),
25
+ * 两者继承下来,`services/` 及其下每个文件对沙箱组都是 `EPERM`——读写皆不可。
26
+ * 服务脚本能跑,是因为脚本被 `stageScriptSnapshot` 复制到 `runDir/script` 后执行,
27
+ * 输入全部走 stdin,不依赖读取包目录。
28
+ *
29
+ * 因此这条 DENY 只补写位:读位已经被父目录的 DENY(R) 关掉了,再重复一遍没有意义;
30
+ * 而如果将来有人把父目录的读权限放开,这条写 DENY 仍然留在原地,写保护不会跟着失效。
31
+ * 只拒写数据 / 追加 / 写扩展属性 / 写属性 / 删除 / 删子项 / 改 DACL / 改所有者。
25
32
  *
26
33
  * 平台:仅 `win32`。其他平台 `hardenServicesAcl` 直接返回 `changed: false`。
27
34
  */
@@ -4,7 +4,7 @@
4
4
  * 形状:路径模板 → [{ identities, access }],identities 为角色名(owner/admin/member/visitor)。
5
5
  *
6
6
  * 只服务用户会话。系统会话(记忆整理等)与角色体系无关,路径边界由
7
- * src/core/system-session/ 下的模块在代码里决定,不走本表、不并运行时授予。
7
+ * src/core/session/system/ 下的模块在代码里决定,不走本表、不并运行时授予。
8
8
  *
9
9
  * 判定规则(两条,别加第三条):
10
10
  * 1. 同会话多条命中 → 取最大权限(none 显式覆盖通配)
@@ -1,5 +1,19 @@
1
- import { CODEX_HEADER_ENV_PREFIX, SERVICE_SESSION_ENV_NAMES } from '../../product.js';
1
+ import { CODEX_HEADER_ENV_PREFIX, SERVICE_SESSION_ENV_NAMES, RUNTIME_HOME_ENV } from '../../product.js';
2
2
  const SERVICE_SESSION_ENV = new Set(SERVICE_SESSION_ENV_NAMES);
3
+ /** Minimal executable environment plus authority explicitly supplied for this task. */
4
+ export function buildAgentShellEnvironment(runtime, baseline = process.env) {
5
+ const result = {};
6
+ const system = /^(PATH|PATHEXT|SYSTEMROOT|WINDIR|COMSPEC|PROGRAMFILES|PROGRAMFILES\(X86\)|PROGRAMDATA|USERPROFILE|HOME|HOMEDRIVE|HOMEPATH|APPDATA|LOCALAPPDATA|LANG|LC_[A-Z_]+|TERM|COLORTERM|TZ|TMPDIR|TEMP|TMP|HTTP_PROXY|HTTPS_PROXY|ALL_PROXY|NO_PROXY)$/i;
7
+ for (const [key, value] of Object.entries(baseline)) {
8
+ if (value !== undefined && system.test(key))
9
+ result[key] = value;
10
+ }
11
+ for (const [key, value] of Object.entries(runtime)) {
12
+ if (system.test(key) || SERVICE_SESSION_ENV.has(key) || key === RUNTIME_HOME_ENV)
13
+ result[key] = value;
14
+ }
15
+ return sanitizeShellExecutionEnvironment(result, { lockExecutableResolution: true, baseline });
16
+ }
3
17
  /** Preserve infrastructure and application settings without inheriting task authority. */
4
18
  export function sanitizeServiceEnvironment(input) {
5
19
  return Object.fromEntries(Object.entries(input).filter(([name]) => {
@@ -729,7 +729,7 @@ function queryPathOperands(analysis) {
729
729
  accessKind: command.accessKind ?? (operand.access === 'recursive' ? 'enumerate' : 'content'),
730
730
  }))));
731
731
  }
732
- const PROTECTED_BASENAME_LITERAL_RE = /^(?:daemon\.json|defaults\.json|config\.json|contact\.json|contact-operations\.jsonl|\.device_id|\.env|\.lock|daemon\.pid)$/i;
732
+ const PROTECTED_BASENAME_LITERAL_RE = /^(?:daemon\.json|defaults\.json|config\.json|contact\.json|contact-operations\.jsonl|\.device_id(?:\..+)?|\.env|\.lock|daemon\.pid)$/i;
733
733
  const SHELL_PATH_LITERAL_META_RE = /[\0\r\n$`*?\[\]{}<>|;&(),]/;
734
734
  /**
735
735
  * Extract literal operands immediately following an unquoted shell
@@ -2649,20 +2649,34 @@ export function evaluateToolPreflight(toolName, input, context) {
2649
2649
  policyCode: 'managed_ec_discovery_forbidden',
2650
2650
  };
2651
2651
  }
2652
- const parserOptions = {
2653
- verifyShellExecutable: process.platform === 'win32',
2652
+ const shellDialect = stringShellCarrier?.dialect
2653
+ ?? (hasCodexCmdCarrierEcIntent(input) ? 'cmd' : undefined);
2654
+ const hasPowerShellCarrierAssignment = stringShellCarrier?.dialect === 'powershell'
2655
+ && hasPowerShellCredentialAssignment(stringShellCarrier.command);
2656
+ const syntaxOptions = {
2654
2657
  managedTempDir: context.managedTempDir,
2655
2658
  posixShell: stringShellCarrier?.posixShell,
2659
+ ...(shellDialect ? { dialect: shellDialect } : {}),
2656
2660
  ...(context.sessionCredential
2657
2661
  ? { expectedCredentialToken: context.sessionCredential }
2658
2662
  : {}),
2659
2663
  };
2664
+ // Identify EC intent without granting privileges or probing the shell.
2665
+ // Non-EC commands continue through the ordinary path/approval policy.
2666
+ const ecIntent = hasPowerShellCarrierAssignment
2667
+ || classifyEvolcoreShellCommand(policyCommand, syntaxOptions).kind !== 'none';
2668
+ const parserOptions = {
2669
+ ...syntaxOptions,
2670
+ verifyShellExecutable: process.platform === 'win32' && ecIntent,
2671
+ };
2660
2672
  const parsedCodex = context.sessionId ? parseCodexToolCommand(input, parserOptions) : null;
2661
2673
  if (context.sessionId && parsedCodex && !parsedCodex.ok && parsedCodex.issue === 'untrusted-shell') {
2674
+ logger.warn('[ToolPolicy] EC shell trust validation failed', parsedCodex.shellTrustFailure);
2662
2675
  return {
2663
2676
  behavior: 'deny',
2664
2677
  input,
2665
- message: '🔒 Shell 可执行文件未通过 Windows Authenticode 签名校验,禁止进入 EvolCore EC 特权路径。',
2678
+ message: '🔒 Shell 信任校验失败,禁止进入 EvolCore EC 特权路径。'
2679
+ + (parsedCodex.shellTrustFailure ? ` ${parsedCodex.shellTrustFailure.message}` : ''),
2666
2680
  policyCode: 'ec_shell_untrusted_executable',
2667
2681
  };
2668
2682
  }
@@ -2675,10 +2689,6 @@ export function evaluateToolPreflight(toolName, input, context) {
2675
2689
  policyCode: 'delegation_token_unbound',
2676
2690
  };
2677
2691
  }
2678
- const shellDialect = stringShellCarrier?.dialect
2679
- ?? (hasCodexCmdCarrierEcIntent(input) ? 'cmd' : undefined);
2680
- const hasPowerShellCarrierAssignment = stringShellCarrier?.dialect === 'powershell'
2681
- && hasPowerShellCredentialAssignment(stringShellCarrier.command);
2682
2692
  const ecCommand = hasPowerShellCarrierAssignment && parsedCodex
2683
2693
  ? parsedCodex.ok && parsedCodex.argv[0] === 'ec'
2684
2694
  ? { kind: 'literal' }
@@ -2715,10 +2725,12 @@ export function evaluateToolPreflight(toolName, input, context) {
2715
2725
  }
2716
2726
  if (ecCommand.kind === 'composite') {
2717
2727
  if (ecCommand.issue === 'untrusted-shell') {
2728
+ logger.warn('[ToolPolicy] EC shell trust validation failed', ecCommand.shellTrustFailure);
2718
2729
  return {
2719
2730
  behavior: 'deny',
2720
2731
  input,
2721
- message: '🔒 Shell 可执行文件未通过 Windows Authenticode 签名校验,禁止进入 EvolCore EC 特权路径。',
2732
+ message: '🔒 Shell 信任校验失败,禁止进入 EvolCore EC 特权路径。'
2733
+ + (ecCommand.shellTrustFailure ? ` ${ecCommand.shellTrustFailure.message}` : ''),
2722
2734
  policyCode: 'ec_shell_untrusted_executable',
2723
2735
  };
2724
2736
  }