evolcore 0.0.48 → 0.0.50

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 (302) hide show
  1. package/CHANGELOG.md +97 -0
  2. package/bin/ecmsg.js +9 -4
  3. package/dist/ability/caller/authorization.js +21 -0
  4. package/dist/ability/caller/command.js +164 -0
  5. package/dist/ability/caller/contract.js +102 -0
  6. package/dist/ability/caller/daemon.js +158 -0
  7. package/dist/ability/caller/service.js +380 -0
  8. package/dist/ability/command-contract.js +5 -0
  9. package/dist/ability/daemon.js +5 -1
  10. package/dist/ability/interop-v1.js +10 -3
  11. package/dist/ability/management.js +1 -0
  12. package/dist/agent-template/jobs.js +173 -1
  13. package/dist/agent-template/runtime.js +285 -8
  14. package/dist/agent-template/service.js +1159 -40
  15. package/dist/agent-template/types.js +2 -1
  16. package/dist/agents/baseagent-availability.js +27 -3
  17. package/dist/agents/baseagent-capability-adapter.js +102 -0
  18. package/dist/agents/baseagent-plugin-descriptor.js +274 -0
  19. package/dist/agents/baseagent-plugin-loader.js +145 -0
  20. package/dist/agents/baseagent.js +68 -2
  21. package/dist/agents/claude-gateway/agent-registration.js +389 -0
  22. package/dist/agents/claude-gateway/binding.js +96 -0
  23. package/dist/agents/claude-gateway/inbox.js +138 -0
  24. package/dist/agents/claude-gateway/index.js +125 -0
  25. package/dist/agents/claude-gateway/listing.js +330 -0
  26. package/dist/agents/claude-gateway/router.js +328 -0
  27. package/dist/agents/claude-gateway/sessions.js +128 -0
  28. package/dist/agents/claude-gateway/terminal.js +250 -0
  29. package/dist/agents/claude-gateway/transcript.js +272 -0
  30. package/dist/agents/claude-gateway/types.js +14 -0
  31. package/dist/agents/claude-runner.js +6 -10
  32. package/dist/agents/codex-runner.js +9 -2
  33. package/dist/agents/{gemini-runner.js → gemini/gemini-runner.js} +17 -17
  34. package/dist/{core/session/adapters → agents/gemini}/gemini-session-file-adapter.js +2 -2
  35. package/dist/agents/gemini/index.js +51 -0
  36. package/dist/aun/aid/control-aid.js +52 -32
  37. package/dist/aun/group/invite-service.js +6 -36
  38. package/dist/aun/group/operations.js +6 -0
  39. package/dist/aun/msg/mention-schema.js +1 -1
  40. package/dist/aun/msg/p2p.js +31 -2
  41. package/dist/aun/msg/upload.js +126 -3
  42. package/dist/build-identity.json +1 -1
  43. package/dist/channels/aun.js +1175 -457
  44. package/dist/cli/ability-command.js +42 -0
  45. package/dist/cli/agent-command.js +20 -1
  46. package/dist/cli/agent-create.js +78 -18
  47. package/dist/cli/agent-template.js +5 -3
  48. package/dist/cli/agent.js +91 -0
  49. package/dist/cli/aun-commands.js +92 -34
  50. package/dist/cli/bench.js +5 -2
  51. package/dist/cli/config.js +22 -6
  52. package/dist/cli/daemon-commands.js +245 -101
  53. package/dist/cli/directory.js +6 -1
  54. package/dist/cli/ecmsg-gateway.js +11 -9
  55. package/dist/cli/index.js +30 -5
  56. package/dist/cli/init.js +39 -63
  57. package/dist/cli/managed-command-guard.js +3 -0
  58. package/dist/cli/menu-client.js +32 -7
  59. package/dist/cli/model.js +20 -5
  60. package/dist/cli/pay-command.js +30 -0
  61. package/dist/cli/provider-command.js +6 -2
  62. package/dist/cli/quota.js +89 -0
  63. package/dist/cli/restart-monitor.js +2 -2
  64. package/dist/cli/role.js +1 -0
  65. package/dist/cli/services-command.js +12 -9
  66. package/dist/cli/team-workspace-command.js +56 -2
  67. package/dist/cli/thread-command.js +78 -12
  68. package/dist/config/access-policy.js +16 -3
  69. package/dist/config/config-field-policy.js +88 -9
  70. package/dist/config/config-manager.js +97 -47
  71. package/dist/config/config-operation-service.js +22 -1
  72. package/dist/config/gateway-config.js +9 -8
  73. package/dist/config/owner-config.js +0 -16
  74. package/dist/config/peer-role-resolver.js +1 -7
  75. package/dist/config/providers-config.js +107 -20
  76. package/dist/config/providers-management.js +45 -21
  77. package/dist/config/resolved-config-op.js +4 -44
  78. package/dist/config/schema-migration.js +78 -5
  79. package/dist/config/schema-registry.js +52 -7
  80. package/dist/config-store.js +1309 -17
  81. package/dist/core/agent-application-service.js +220 -1
  82. package/dist/core/agent-ipc-registration.js +19 -2
  83. package/dist/core/agent-reload-coordinator.js +5 -0
  84. package/dist/core/agent-runtime.js +198 -54
  85. package/dist/core/auth/agent-delegation.js +14 -0
  86. package/dist/core/auth/delegation-authorization.js +33 -26
  87. package/dist/core/auth/operation-authorizer.js +16 -1
  88. package/dist/core/auth/operation-catalog.js +59 -7
  89. package/dist/core/baseagent-loader.js +30 -3
  90. package/dist/core/capability/capability-manager.js +16 -7
  91. package/dist/core/channel-runtime.js +4 -2
  92. package/dist/core/command/agent-control.js +20 -2
  93. package/dist/core/command/agent-template-menu.js +4 -3
  94. package/dist/core/command/cli-intent-parser.js +28 -0
  95. package/dist/core/command/command-handler.js +45 -2
  96. package/dist/core/command/menu-catalog.js +20 -4
  97. package/dist/core/command/menu-file-path.js +70 -0
  98. package/dist/core/command/menu-handler.js +97 -73
  99. package/dist/core/command/menu-protocol.js +29 -0
  100. package/dist/core/command/menu-query-batch.js +2 -2
  101. package/dist/core/command/private-mention-menu.js +71 -0
  102. package/dist/core/command/remote-shell.js +565 -0
  103. package/dist/core/command/slash-handler.js +17 -26
  104. package/dist/core/command/team-workspace-bootstrap.js +2 -1
  105. package/dist/core/command/topic-slash.js +7 -1
  106. package/dist/core/daemon-bootstrap.js +0 -4
  107. package/dist/core/daemon-control.js +58 -1
  108. package/dist/core/daemon-lifecycle.js +29 -7
  109. package/dist/core/evolagent-registry.js +18 -9
  110. package/dist/core/handoff/runtime.js +1 -1
  111. package/dist/core/host-snapshot.js +8 -3
  112. package/dist/core/initialization/service.js +3 -0
  113. package/dist/core/interaction-router.js +130 -0
  114. package/dist/core/ipc-registration.js +5 -0
  115. package/dist/core/memory/consolidation-context.js +2 -1
  116. package/dist/core/memory/consolidation.js +35 -64
  117. package/dist/core/message/aun-ipc-sender.js +213 -74
  118. package/dist/core/message/aun-request-registry.js +31 -0
  119. package/dist/core/message/contact-admission.js +91 -6
  120. package/dist/core/message/contact-pending-inbound.js +113 -0
  121. package/dist/core/message/contact-thread-approval.js +212 -0
  122. package/dist/core/message/im-renderer.js +40 -1
  123. package/dist/core/message/message-admission.js +5 -39
  124. package/dist/core/message/message-bridge.js +197 -45
  125. package/dist/core/message/message-log.js +32 -0
  126. package/dist/core/message/message-queue.js +102 -18
  127. package/dist/core/message/peer-mode.js +15 -4
  128. package/dist/core/message/response-engine.js +174 -26
  129. package/dist/core/message/send-options.js +37 -3
  130. package/dist/core/message/send-routing.js +11 -7
  131. package/dist/core/model/config-scope.js +6 -14
  132. package/dist/core/model/model-catalog.js +5 -5
  133. package/dist/core/model/model-diagnostics.js +19 -0
  134. package/dist/core/model/model-fallback.js +13 -2
  135. package/dist/core/ownership/owner-resolver.js +12 -86
  136. package/dist/core/pack-auth.js +7 -0
  137. package/dist/core/pack-install.js +1 -1
  138. package/dist/core/permission/ec-command-parser.js +288 -77
  139. package/dist/core/permission/protected-paths.js +64 -9
  140. package/dist/core/permission/services-path-acl.js +458 -0
  141. package/dist/core/permission/tool-policy.js +26 -10
  142. package/dist/core/relation/peer-identity.js +13 -0
  143. package/dist/core/session/adapters/claude-session-file-adapter.js +6 -2
  144. package/dist/core/session/adapters/codex-session-file-adapter.js +4 -0
  145. package/dist/core/session/session-manager.js +47 -10
  146. package/dist/core/session/session-mapper.js +16 -0
  147. package/dist/core/skill/index-generator.js +2 -3
  148. package/dist/core/skill/switch-resolver.js +3 -0
  149. package/dist/core/task/task-recovery-service.js +1 -0
  150. package/dist/core/thread/command-parser.js +4 -1
  151. package/dist/core/thread/ipc-operation.js +4 -2
  152. package/dist/core/thread/thread-operation.js +25 -10
  153. package/dist/core/thread/thread-service.js +294 -55
  154. package/dist/core/thread/topic-id.js +67 -2
  155. package/dist/core/thread/types.js +15 -1
  156. package/dist/directory/owner-directory-admission.js +11 -8
  157. package/dist/directory/owner-directory-cache.js +19 -0
  158. package/dist/directory/owner-directory-markdown.js +1 -1
  159. package/dist/directory/owner-directory-policy.js +5 -30
  160. package/dist/directory/owner-directory-request-operation.js +5 -2
  161. package/dist/eck/kit-renderer.js +3 -2
  162. package/dist/eck/message-renderer.js +28 -5
  163. package/dist/ecweb/basic-settings-service.js +5 -9
  164. package/dist/ecweb/providers-service.js +4 -2
  165. package/dist/ecweb/runtime/supervisor.js +36 -8
  166. package/dist/event-center/center-config.js +9 -5
  167. package/dist/event-center/dispatcher.js +10 -1
  168. package/dist/event-center/ipc-operation.js +19 -0
  169. package/dist/event-center/registry.js +20 -5
  170. package/dist/event-center/runtime.js +10 -7
  171. package/dist/index.js +120 -41
  172. package/dist/ipc.js +83 -3
  173. package/dist/outputs/authorization.js +16 -0
  174. package/dist/outputs/cards.js +336 -0
  175. package/dist/outputs/events.js +3 -2
  176. package/dist/outputs/protocol.js +1 -0
  177. package/dist/outputs/service.js +2 -15
  178. package/dist/paths.js +48 -1
  179. package/dist/pay/command.js +38 -0
  180. package/dist/pay/protocol.js +136 -0
  181. package/dist/pay/runtime.js +188 -0
  182. package/dist/pay/service.js +384 -0
  183. package/dist/pay/store.js +81 -0
  184. package/dist/response-system/engines/v1/proactive-flow.js +29 -2
  185. package/dist/services/dispatcher.js +23 -5
  186. package/dist/services/host/main.js +388 -0
  187. package/dist/services/host/protocol.js +118 -0
  188. package/dist/services/host/resident.js +310 -0
  189. package/dist/services/host-client.js +386 -0
  190. package/dist/services/host-deploy.js +180 -0
  191. package/dist/services/host-launch.js +117 -0
  192. package/dist/services/host-recycle.js +203 -0
  193. package/dist/services/host-runtime.js +802 -0
  194. package/dist/services/idempotency.js +44 -86
  195. package/dist/services/index-generator.js +4 -3
  196. package/dist/services/index.js +204 -22
  197. package/dist/services/ipc-operation.js +288 -44
  198. package/dist/services/pack-manager.js +1 -0
  199. package/dist/services/script-runner.js +515 -83
  200. package/dist/services/service-payload.js +13 -7
  201. package/dist/services/validation.js +109 -4
  202. package/dist/stats/budget.js +1 -1
  203. package/dist/stats/model-resolver.js +2 -2
  204. package/dist/stats/quota-query.js +95 -0
  205. package/dist/trigger/application-service.js +6 -4
  206. package/dist/trigger/local-files.js +19 -9
  207. package/dist/trigger/scheduler.js +22 -12
  208. package/dist/trigger/script-sandbox.js +51 -8
  209. package/dist/utils/aid-bind.js +3 -0
  210. package/dist/utils/atomic-write.js +22 -8
  211. package/dist/utils/evolcore-version.js +2 -2
  212. package/dist/utils/host-info.js +173 -1
  213. package/dist/utils/logger.js +2 -2
  214. package/dist/utils/media-cache.js +190 -43
  215. package/dist/utils/npm-ops.js +43 -8
  216. package/dist/utils/restart-safety.js +14 -1
  217. package/dist/utils/system-memory.js +113 -25
  218. package/dist/utils/systemd-lifecycle.js +154 -0
  219. package/dist/utils/windows-shell-trust.js +7 -3
  220. package/dist/workbench/service.js +1 -1
  221. package/kits/docs/INDEX.md +3 -2
  222. 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
  223. package/kits/docs/channels/aun.md +1 -1
  224. package/kits/docs/evolcore/INDEX.md +9 -6
  225. package/kits/docs/evolcore/agent.md +36 -1
  226. package/kits/docs/evolcore/aid.md +45 -3
  227. package/kits/docs/evolcore/config.md +5 -2
  228. package/kits/docs/evolcore/directory.md +8 -9
  229. package/kits/docs/evolcore/group.md +2 -1
  230. package/kits/docs/evolcore/memory-tags.md +2 -0
  231. package/kits/docs/evolcore/menu-client.md +3 -3
  232. package/kits/docs/evolcore/menu-protocol.md +7 -0
  233. package/kits/docs/evolcore/model.md +3 -0
  234. package/kits/docs/evolcore/msg.md +77 -10
  235. package/kits/docs/evolcore/pay.md +34 -0
  236. package/kits/docs/evolcore/provider.md +22 -1
  237. package/kits/docs/evolcore/quota.md +54 -0
  238. package/kits/docs/evolcore/role.md +3 -0
  239. package/kits/docs/evolcore/services.md +46 -18
  240. package/kits/docs/evolcore/stats.md +2 -0
  241. package/kits/docs/evolcore/thread-chain.md +2 -0
  242. package/kits/docs/evolcore/tool-authorization.md +10 -0
  243. package/kits/docs/evolcore/trigger.md +2 -0
  244. package/kits/rules/01-overview.md +11 -32
  245. package/kits/rules/02-navigation.md +7 -0
  246. package/kits/rules/06-channel.md +3 -3
  247. package/kits/schemas/_meta.json +38 -5
  248. package/kits/schemas/agent-config.schema.20.json +24 -0
  249. package/kits/schemas/agent-config.schema.21.json +974 -0
  250. package/kits/schemas/agent-config.schema.22.json +977 -0
  251. package/kits/schemas/agent-config.schema.23.json +958 -0
  252. package/kits/schemas/daemon.schema.10.json +373 -0
  253. package/kits/schemas/daemon.schema.9.json +12 -0
  254. package/kits/schemas/defaults.schema.7.json +472 -0
  255. package/kits/schemas/providers.schema.3.json +18 -2
  256. package/kits/schemas/relation-config.schema.13.json +289 -0
  257. package/kits/skills/.switches.json +17 -1
  258. package/kits/skills/ability/SKILL.md +229 -34
  259. package/kits/skills/ability/STRUCTURE.md +333 -0
  260. package/kits/skills/ability/references/cli.md +208 -0
  261. package/kits/skills/ability/references/development.md +107 -37
  262. package/kits/skills/ability/references/management.md +106 -46
  263. package/kits/skills/ability/references/runtime-protocol.md +65 -63
  264. package/kits/skills/agent-output-cards/SKILL.md +64 -0
  265. package/kits/skills/ec-group/SKILL.md +8 -6
  266. package/kits/skills/ec-group/TASK.md +186 -0
  267. package/kits/skills/ec-group/WORKLOG.md +180 -0
  268. package/kits/skills/ec-group-collaboration/SKILL.md +3 -3
  269. package/kits/skills/ec-pay/SKILL.md +101 -0
  270. package/kits/skills/ec-pay/references/pay-cli.md +110 -0
  271. package/kits/skills/ec-provider/SKILL.md +58 -9
  272. package/kits/skills/{ec-service-proxy → ec-proxy}/SKILL.md +8 -5
  273. package/kits/skills/ec-service-call/SKILL.md +135 -0
  274. package/kits/skills/ec-service-pack/SKILL.md +277 -0
  275. package/kits/skills/ec-trigger/SKILL.md +1 -1
  276. package/kits/templates/memory-consolidation/notes.md +2 -2
  277. package/kits/templates/memory-consolidation/workflow.md +46 -0
  278. package/kits/templates/roles/visitor.json +1 -0
  279. package/kits/templates/system-fragments/channel.md +13 -4
  280. package/kits/templates/system-fragments/commands.md +5 -3
  281. package/kits/templates/system-fragments/directory-contacts.md +3 -4
  282. package/kits/templates/system-fragments/reply.md +1 -0
  283. package/kits/templates/system-fragments/session.md +1 -1
  284. package/kits/templates/system-fragments/thread.md +27 -128
  285. package/kits/templates/system-fragments/venue.md +27 -0
  286. package/package.json +4 -5
  287. package/scripts/agent-template/inspect.mjs +79 -29
  288. package/scripts/agent-template/overlay.mjs +20 -2
  289. package/scripts/agent-template/shared/common.mjs +24 -6
  290. package/scripts/agent-template/shared/team-schema.json +23 -5
  291. package/scripts/agent-template/shared/template-contract.mjs +107 -17
  292. package/scripts/agent-template/shared/template-package.mjs +254 -29
  293. package/scripts/agent-template/shared/template-runtime.mjs +145 -2
  294. package/scripts/agent-template/shared/template.mjs +67 -9
  295. package/scripts/agent-template/team-pack.mjs +132 -41
  296. package/scripts/agent-template/team-preview.mjs +249 -5
  297. package/kits/docs/aun/ABILITY_CALLING.md +0 -280
  298. package/kits/docs/evolcore/ability.md +0 -185
  299. package/kits/skills/ability/references/calling.md +0 -56
  300. package/kits/skills/ability/references/contract-checklist.md +0 -37
  301. package/kits/skills/ability/references/recovery.md +0 -27
  302. /package/dist/{core/capability/providers → agents/gemini}/gemini-capability-provider.js +0 -0
@@ -9,7 +9,10 @@ const H_CLASS_RELATIVE_PATTERNS = [
9
9
  /^(?:AIDs|aids)(?:\/|$)/,
10
10
  /^\.snapshots(?:\/|$)/,
11
11
  /^CA(?:\/|$)/,
12
- /^\.device_id$/,
12
+ // The SDK keeps a `.device_id.hmac` guard beside `.device_id` and refuses to
13
+ // resolve a device identity when the pair disagrees, so the suffix belongs to
14
+ // the same secret root. Mirrors the `.seed(?:\.|$)` form below.
15
+ /^\.device_id(?:\.|$)/,
13
16
  /^\.env$/,
14
17
  /^providers\.json(?:_|__|\.lock(?:\..*)?)?$/,
15
18
  /^\.seed(?:\.|$)/,
@@ -18,14 +21,15 @@ const H_CLASS_RELATIVE_PATTERNS = [
18
21
  /^daemon\.pid$/,
19
22
  /^agents\/[^/]+\/data\/codex-tokens(?:\/|$)/,
20
23
  /^agents\/[^/]+\/data\/task-resources(?:\/|$)/,
24
+ /^agents\/[^/]+\/data\/payments(?:\/|$)/,
21
25
  /^agents\/[^/]+\/data\/(?:.*\/)?(?:context-tokens|menu-tokens)\.json(?:_|__|\.tmp-.*)?$/,
22
26
  ];
23
27
  const H_CLASS_REFERENCE_PATTERNS = [
24
28
  /(?:^|[^A-Za-z0-9_.-])providers\.json(?:_|__|\.lock(?:\.[^/\\\s"']*)?)?(?=$|[\s"';&|<>)},])/,
25
29
  /(?:^|[/\\\s"'=<>])data[\\/]/,
26
30
  /(?:^|[/\\\s"'=<>])(?:AIDs|aids)[\\/]/,
27
- /(?:^|[^A-Za-z0-9_.-])(?:\.device_id|\.env|\.seed(?:\.[^/\\\s"']*)?|\.migrated-[^/\\\s"']*|\.lock|daemon\.pid)(?=$|[\s"';&|<>)},])/,
28
- /(?:^|[/\\\s"'=<>])agents[\\/][^/\\\s"']+[\\/]data[\\/](?:codex-tokens|task-resources|(?:.*[\\/])?(?:context-tokens|menu-tokens)\.json)(?:[\\/]|$|[\s"';&|<>)},])/,
31
+ /(?:^|[^A-Za-z0-9_.-])(?:\.device_id(?:\.[^/\\\s"']*)?|\.env|\.seed(?:\.[^/\\\s"']*)?|\.migrated-[^/\\\s"']*|\.lock|daemon\.pid)(?=$|[\s"';&|<>)},])/,
32
+ /(?:^|[/\\\s"'=<>])agents[\\/][^/\\\s"']+[\\/]data[\\/](?:codex-tokens|task-resources|payments|(?:.*[\\/])?(?:context-tokens|menu-tokens)\.json)(?:[\\/]|$|[\s"';&|<>)},])/,
29
33
  ];
30
34
  // H-class directory roots are kept separately from the full path matcher so
31
35
  // an exact metadata query can distinguish a protected directory from a
@@ -38,6 +42,7 @@ const H_CLASS_DIRECTORY_RELATIVE_PATTERNS = [
38
42
  /^CA(?:\/|$)/,
39
43
  /^agents\/[^/]+\/data\/codex-tokens(?:\/|$)/,
40
44
  /^agents\/[^/]+\/data\/task-resources(?:\/|$)/,
45
+ /^agents\/[^/]+\/data\/payments(?:\/|$)/,
41
46
  ];
42
47
  const L_CLASS_RELATIVE_PATTERNS = [
43
48
  /^daemon\.json$/,
@@ -164,7 +169,7 @@ const SELF_AWARE_H_CLASS_RELATIVE_PATTERNS = [
164
169
  /^data(?:\/|$)/,
165
170
  /^(?:AIDs|aids)(?:\/|$)/,
166
171
  /^CA(?:\/|$)/,
167
- /^\.device_id$/,
172
+ /^\.device_id(?:\.|$)/,
168
173
  /^\.env$/,
169
174
  /^\.seed(?:\.|$)/,
170
175
  /^\.lock$/,
@@ -179,7 +184,7 @@ function matchesSelfAwareHClassRelative(relative, selfAid) {
179
184
  if (!own)
180
185
  return false;
181
186
  const escaped = own.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
182
- return new RegExp(`^agents/${escaped}/data/(?:codex-tokens|task-resources)(?:/|$)`).test(relative)
187
+ return new RegExp(`^agents/${escaped}/data/(?:codex-tokens|task-resources|payments)(?:/|$)`).test(relative)
183
188
  || new RegExp(`^agents/${escaped}/data/(?:.*\/)?(?:context-tokens|menu-tokens)\\.json(?:_|__|\\.tmp-.*)?$`).test(relative);
184
189
  }
185
190
  export function isSameOrDescendant(candidate, parent) {
@@ -387,7 +392,7 @@ function getLegacyHClassSandboxPatterns(root) {
387
392
  path.join('aids', '*', 'cert'), path.join('aids', '*', 'cert', '**'),
388
393
  path.join('aids', '*', 'keys'), path.join('aids', '*', 'keys', '**'),
389
394
  path.join('aids', '*', 'private'), path.join('aids', '*', 'private', '**'),
390
- '.device_id', '.env', '.seed', '.seed.*', '.migrated-*',
395
+ '.device_id', '.device_id.*', '.env', '.seed', '.seed.*', '.migrated-*',
391
396
  path.join('**', '*.json_'), path.join('**', '*.json.migrated'),
392
397
  path.join('agents', 'defaults_*.json'), '.lock', 'daemon.pid',
393
398
  path.join('data', 'causation-aun.json*'), path.join('data', 'contact-book-audit.jsonl'),
@@ -401,6 +406,7 @@ function getLegacyHClassSandboxPatterns(root) {
401
406
  path.join('agents', '*', 'data', 'handoff', '**'), path.join('agents', '*', 'data', 'async-questions', '**'),
402
407
  path.join('agents', '*', 'data', 'task-activity', '**'), path.join('agents', '*', 'data', 'aun', '**'),
403
408
  path.join('agents', '*', 'data', 'task-resources', '**'),
409
+ path.join('agents', '*', 'data', 'payments'), path.join('agents', '*', 'data', 'payments', '**'),
404
410
  path.join('agents', '*', 'data', 'outbox.jsonl*'), path.join('agents', '*', 'data', 'activity-outbox.jsonl*'),
405
411
  path.join('agents', '*', 'data', 'contact-audit.jsonl'),
406
412
  ];
@@ -417,11 +423,13 @@ export function getHClassSandboxPatterns(root = resolveRoot(), options = {}) {
417
423
  'aids', path.join('aids', '**'),
418
424
  'CA',
419
425
  path.join('CA', '**'),
420
- '.device_id', '.env', '.seed', '.seed.*', '.lock', 'daemon.pid',
426
+ '.device_id', '.device_id.*', '.env', '.seed', '.seed.*', '.lock', 'daemon.pid',
421
427
  path.join('agents', options.selfAid, 'data', 'codex-tokens'),
422
428
  path.join('agents', options.selfAid, 'data', 'codex-tokens', '**'),
423
429
  path.join('agents', options.selfAid, 'data', 'task-resources'),
424
430
  path.join('agents', options.selfAid, 'data', 'task-resources', '**'),
431
+ path.join('agents', options.selfAid, 'data', 'payments'),
432
+ path.join('agents', options.selfAid, 'data', 'payments', '**'),
425
433
  path.join('agents', options.selfAid, 'data', '**', 'context-tokens.json'),
426
434
  path.join('agents', options.selfAid, 'data', '**', 'menu-tokens.json'),
427
435
  ];
@@ -479,6 +487,15 @@ function getAgentAwareHClassMaskTargets(root, selfAid) {
479
487
  '.device_id', '.env', '.seed', '.lock', 'daemon.pid',
480
488
  ])
481
489
  addExistingTarget(targets, path.join(absoluteRoot, relative));
490
+ // `.device_id` carries a sibling guard (`<name>.<suffix>`), so mirror the
491
+ // `.seed.*` scan below instead of listing one literal name.
492
+ try {
493
+ for (const entry of fs.readdirSync(absoluteRoot)) {
494
+ if (entry.startsWith('.device_id.'))
495
+ addExistingTarget(targets, path.join(absoluteRoot, entry));
496
+ }
497
+ }
498
+ catch { }
482
499
  const agentsDir = path.join(absoluteRoot, 'agents');
483
500
  try {
484
501
  for (const entry of fs.readdirSync(agentsDir, { withFileTypes: true })) {
@@ -491,6 +508,7 @@ function getAgentAwareHClassMaskTargets(root, selfAid) {
491
508
  }
492
509
  addExistingTarget(targets, path.join(agentRoot, 'data', 'codex-tokens'));
493
510
  addExistingTarget(targets, path.join(agentRoot, 'data', 'task-resources'));
511
+ addExistingTarget(targets, path.join(agentRoot, 'data', 'payments'));
494
512
  const walk = (directory, depth = 0) => {
495
513
  if (depth > 8)
496
514
  return;
@@ -536,7 +554,8 @@ export function getExistingHClassMaskTargets(root = resolveRoot(), options = {})
536
554
  }
537
555
  try {
538
556
  for (const entry of fs.readdirSync(absoluteRoot)) {
539
- if (entry.startsWith('.seed.') || entry.startsWith('.migrated-') || entry.endsWith('.json.migrated')) {
557
+ if (entry.startsWith('.seed.') || entry.startsWith('.device_id.')
558
+ || entry.startsWith('.migrated-') || entry.endsWith('.json.migrated')) {
540
559
  addExistingTarget(targets, path.join(absoluteRoot, entry));
541
560
  }
542
561
  }
@@ -578,6 +597,7 @@ export function getExistingHClassMaskTargets(root = resolveRoot(), options = {})
578
597
  addExistingTarget(targets, path.join(agentRoot, 'data', 'channels'));
579
598
  addExistingTarget(targets, path.join(agentRoot, 'data', 'handoff'));
580
599
  addExistingTarget(targets, path.join(agentRoot, 'data', 'async-questions'));
600
+ addExistingTarget(targets, path.join(agentRoot, 'data', 'payments'));
581
601
  addExistingTarget(targets, path.join(agentRoot, 'data', 'task-activity'));
582
602
  addExistingTarget(targets, path.join(agentRoot, 'data', 'task-resources'));
583
603
  addExistingTarget(targets, path.join(agentRoot, 'data', 'aun'));
@@ -670,13 +690,48 @@ export function getExistingRelationAttachmentDirs(root = resolveRoot(), options
670
690
  catch { }
671
691
  return [...targets];
672
692
  }
693
+ /**
694
+ * Agent 级附件目录:`agents/<aid>/attachments`。
695
+ *
696
+ * 收发附件的文件本体都落在这里(按内容去重,与关系无关)。它是普通可读内容——
697
+ * 模型需要 Read 才能看图片和文件——因此只进 denyWrite,不进 denyRead:
698
+ * 防止模型改写附件,但不阻断读取。
699
+ */
700
+ export function getExistingAgentAttachmentDirs(root = resolveRoot(), options = {}) {
701
+ const absoluteRoot = resolveThroughExistingAncestor(root);
702
+ const agentsDir = path.join(absoluteRoot, 'agents');
703
+ const targets = new Set();
704
+ try {
705
+ for (const agent of fs.readdirSync(agentsDir, { withFileTypes: true })) {
706
+ if (!agent.isDirectory())
707
+ continue;
708
+ if (options.selfAid) {
709
+ const isSelf = agent.name.toLowerCase() === options.selfAid.toLowerCase();
710
+ if (options.onlyOtherAgents ? isSelf : !isSelf)
711
+ continue;
712
+ }
713
+ const attachments = path.join(agentsDir, agent.name, 'attachments');
714
+ try {
715
+ if (fs.lstatSync(attachments).isDirectory())
716
+ targets.add(attachments);
717
+ }
718
+ catch { }
719
+ }
720
+ }
721
+ catch { }
722
+ return [...targets];
723
+ }
673
724
  export function buildClaudeProtectedFilesystem(root = resolveRoot(), options = {}) {
674
725
  const hClassPaths = [
675
726
  ...getExistingHClassMaskTargets(root, options).map(target => target.path),
676
727
  ];
677
728
  const relationAttachmentPaths = getExistingRelationAttachmentDirs(root, options);
729
+ const agentAttachmentPaths = getExistingAgentAttachmentDirs(root, options);
678
730
  const lClassPaths = getExistingLClassReadOnlyTargets(root, options).map(target => target.path);
679
- const allPaths = [...new Set([...hClassPaths, ...lClassPaths, ...relationAttachmentPaths])];
731
+ // Agent 级附件只防写:模型要 Read 附件内容,但不应改写原始凭证。
732
+ const allPaths = [...new Set([
733
+ ...hClassPaths, ...lClassPaths, ...relationAttachmentPaths, ...agentAttachmentPaths,
734
+ ])];
680
735
  // Self-Agent relation attachments are ordinary readable content. They stay
681
736
  // in denyWrite so the nested Claude sandbox cannot mutate an uploaded asset;
682
737
  // callers without identity context retain the legacy deny-read behavior.
@@ -0,0 +1,458 @@
1
+ /**
2
+ * 服务包目录(`agents/<aid>/services`)的 NTFS ACL 加固。
3
+ *
4
+ * ## 为什么需要这一层
5
+ *
6
+ * scoped 沙箱的写保护由两层组成:policy(`--sandbox-state-json` 的 entries)与 ACL。
7
+ * `services` 的 policy 侧没有 write 授权,写拒绝由「默认拒绝」承担;ACL 侧则可能因为
8
+ * 历史授权(手工 `icacls /grant`、跨机器拷贝带过来的 ACE、codex setup 重跑)而留下
9
+ * **非继承的写授权**。一旦 policy 放宽,就没有第二层兜底。
10
+ *
11
+ * 本模块只做 ACL 一层,判据是:**服务脚本永远不能改写自己的代码和声明**。
12
+ *
13
+ * ## 两条规则
14
+ *
15
+ * - **A(清理)**:移除「非继承 + Allow + 含写权限 + 主体是沙箱组或外来机器 SID」的 ACE。
16
+ * 显式子级 Allow 的优先级高于父级继承 DENY,所以只靠规则 B 拦不住 `artifact-nav/`
17
+ * 这类目录上的残留授权(ACE 求值顺序:显式 Deny → 显式 Allow → 继承 Deny → 继承 Allow)。
18
+ * - **B(兜底)**:在 `services` 根加一条 `(OI)(CI)` 的 DENY(写相关位)。
19
+ * 这条会继承到全树,且能扛住将来重新出现的 Allow。
20
+ *
21
+ * ## 为什么 DENY 不含读位
22
+ *
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 / 改所有者。
32
+ *
33
+ * 平台:仅 `win32`。其他平台 `hardenServicesAcl` 直接返回 `changed: false`。
34
+ */
35
+ import { execFile, execFileSync } from 'node:child_process';
36
+ import fs from 'node:fs';
37
+ import path from 'node:path';
38
+ /** 沙箱账户所在的本地组。codex setup 创建,`CodexSandboxOffline/Online` 都是它的成员。 */
39
+ export const SERVICES_SANDBOX_GROUP = 'CodexSandboxUsers';
40
+ /**
41
+ * 判定「含写权限」的位掩码:写数据、追加、写扩展属性、写属性、删除、删子项、
42
+ * 改 DACL、改所有者,外加两个泛用位。
43
+ *
44
+ * 实测参照值:`(M)` = 1245631 (0x1301BF) 命中;`(RX)` = 1179817 (0x1200A9) 不命中;
45
+ * `(R)` = 1179785 (0x120089) 不命中;`(F)` = 2032127 (0x1F01FF) 命中。
46
+ */
47
+ export const SERVICES_WRITE_RIGHTS = 0x2 | 0x4 | 0x10 | 0x100
48
+ | 0x40 | 0x10000
49
+ | 0x40000 | 0x80000
50
+ | 0x10000000 | 0x40000000;
51
+ /**
52
+ * 施加 DENY 时只用的具体写位:写数据 / 追加 / 写扩展属性 / 写属性 / 删除 / 删子项 /
53
+ * 改 DACL / 改所有者。
54
+ *
55
+ * **不含** `GENERIC_ALL` / `GENERIC_WRITE`:泛用位的展开涵盖读,会把 `RX` 一起拒掉。
56
+ */
57
+ export const SERVICES_DENY_WRITE_RIGHTS = 0x2 | 0x4 | 0x10 | 0x100
58
+ | 0x40 | 0x10000
59
+ | 0x40000 | 0x80000;
60
+ /** 一条 ACE 是否授予写能力。 */
61
+ export function grantsWrite(ace) {
62
+ return ace.allow && (ace.rights & SERVICES_WRITE_RIGHTS) !== 0;
63
+ }
64
+ /**
65
+ * 外来机器 SID:`S-1-5-21-<machine>-<rid>`,且 machine 部分不等于本机。
66
+ *
67
+ * 本机的 `CodexSandboxUsers` / 宿主用户都以本机 machine SID 为前缀,永远不会被判为外来。
68
+ * `S-1-5-18`(SYSTEM)、`S-1-5-32-*`(内置组)不是 `S-1-5-21` 形态,天然排除。
69
+ */
70
+ export function isForeignMachineSid(sid, localMachineSid) {
71
+ if (!localMachineSid)
72
+ return false;
73
+ if (!/^S-1-5-21-/i.test(sid))
74
+ return false;
75
+ return sid.toLowerCase() !== localMachineSid.toLowerCase()
76
+ && !sid.toLowerCase().startsWith(`${localMachineSid.toLowerCase()}-`);
77
+ }
78
+ /**
79
+ * 纯函数:给定某个目录的 DACL 快照,算出要做什么。不碰文件系统,可任意平台单测。
80
+ */
81
+ export function planServicesAclRepair(aces, options) {
82
+ const removeSids = new Set();
83
+ const violations = [];
84
+ for (const ace of aces) {
85
+ if (!ace.allow || ace.inherited || !grantsWrite(ace))
86
+ continue;
87
+ const sandbox = options.sandboxSid && ace.sid.toLowerCase() === options.sandboxSid.toLowerCase();
88
+ const foreign = isForeignMachineSid(ace.sid, options.localMachineSid);
89
+ if (!sandbox && !foreign)
90
+ continue;
91
+ removeSids.add(ace.sid);
92
+ violations.push(`explicit ${ace.allow ? 'Allow' : 'Deny'} write ACE for ${sandbox ? 'sandbox group' : 'foreign SID'} ${ace.sid} (rights=0x${ace.rights.toString(16)})`);
93
+ }
94
+ // 已有一条覆盖全部写位的 DENY 时不再重复施加。
95
+ //
96
+ // **继承的 DENY 也算覆盖**:根上的 `(OI)(CI)` DENY 会向下继承到整棵树,子目录
97
+ // 看到的正是那条继承 ACE。只认非继承的会把每个子目录都判成"缺 DENY",
98
+ // 于是 `hardenServicesAcl` 每次都觉得有事可做——幂等性就没了。
99
+ const denyCovered = !!options.sandboxSid && aces.some(ace => !ace.allow
100
+ && ace.sid.toLowerCase() === options.sandboxSid.toLowerCase()
101
+ && (ace.rights & SERVICES_DENY_WRITE_RIGHTS) === SERVICES_DENY_WRITE_RIGHTS);
102
+ return {
103
+ removeSids: [...removeSids],
104
+ needsDenyWrite: !!options.sandboxSid && !denyCovered,
105
+ violations,
106
+ };
107
+ }
108
+ /**
109
+ * 读取一棵目录树上的 ACL。
110
+ *
111
+ * 返回 `sandboxSid` / `localMachineSid` 供调用方复用;`sandboxSid` 为 `undefined`
112
+ * 表示本机没有 `CodexSandboxUsers` 组(未安装/未 provisioning codex),此时**没有可加固对象**。
113
+ */
114
+ export function readServicesAcl(dir) {
115
+ if (process.platform !== 'win32')
116
+ return { sandboxSid: undefined, localMachineSid: undefined, entries: [] };
117
+ const output = execFileSync(powershellPath(), [
118
+ '-NoProfile', '-NonInteractive', '-EncodedCommand', encodePowerShell(READ_ACL_SCRIPT),
119
+ ], {
120
+ windowsHide: true,
121
+ timeout: 20_000,
122
+ encoding: 'utf8',
123
+ env: {
124
+ ...process.env,
125
+ EVOLCORE_SERVICES_ACL_ROOT: dir,
126
+ EVOLCORE_SERVICES_SANDBOX_GROUP: SERVICES_SANDBOX_GROUP,
127
+ },
128
+ });
129
+ return parseAclOutput(output);
130
+ }
131
+ /** 已经审计过的目录。进程内去重:每个 services 树只跑一次。 */
132
+ const auditedRoots = new Set();
133
+ /**
134
+ * 后台加固:启动路径上不阻塞,且每个目录只跑一次。
135
+ *
136
+ * 读一次 DACL 需要约 0.5s(PowerShell 子进程 + 递归 Get-Acl),挂在 daemon 启动的
137
+ * 同步路径上会明显拖慢 `ec start`。这里改成 fire-and-forget:不 await、不抛错,
138
+ * 失败只写日志——加固是兜底层,晚几百毫秒生效没有影响。
139
+ *
140
+ * 同步版本 `hardenServicesAcl` 仍保留给 `pack add` 与 `repair-acl` 这类需要
141
+ * 「说完就改完」的场景。
142
+ */
143
+ export function scheduleServicesAclHarden(dir, log) {
144
+ const key = path.resolve(dir).toLowerCase();
145
+ if (auditedRoots.has(key))
146
+ return;
147
+ auditedRoots.add(key);
148
+ // setImmediate:让出当前 tick,启动流程先把包加载完。
149
+ setImmediate(() => {
150
+ void hardenServicesAclAsync(dir).then(result => {
151
+ if (result.errors.length > 0) {
152
+ log(`services ACL hardening failed for ${dir}: ${result.errors.join('; ')}`);
153
+ }
154
+ else if (result.changed) {
155
+ const removed = result.plans.flatMap(item => item.plan.removeSids).length;
156
+ log(`services ACL hardened for ${dir} (removed ${removed} explicit write grant(s))`);
157
+ }
158
+ }).catch(error => {
159
+ log(`services ACL hardening threw for ${dir}: ${errorMessage(error)}`);
160
+ });
161
+ });
162
+ }
163
+ /**
164
+ * 异步版加固:子进程不阻塞事件循环。
165
+ *
166
+ * 与同步版逻辑一致,只是把两次 `execFileSync` 换成 `execFile`。给
167
+ * `scheduleServicesAclHarden` 用——那里在 daemon 事件循环里跑,阻塞 0.5s 会
168
+ * 拖慢同时进行的包执行与 IPC 应答。
169
+ */
170
+ async function hardenServicesAclAsync(dir) {
171
+ if (process.platform !== 'win32')
172
+ return { changed: false, plans: [], errors: [] };
173
+ const root = path.resolve(dir);
174
+ if (!fs.existsSync(root))
175
+ return { changed: false, plans: [], errors: [] };
176
+ let snapshot;
177
+ try {
178
+ snapshot = parseAclOutput(await readAclRaw(root));
179
+ }
180
+ catch (error) {
181
+ return { changed: false, plans: [], errors: [`read ACL failed: ${errorMessage(error)}`] };
182
+ }
183
+ if (!snapshot.sandboxSid)
184
+ return { changed: false, plans: [], errors: [] };
185
+ const { plans, changes } = planServicesAclTree(root, snapshot);
186
+ if (changes.length === 0)
187
+ return { changed: false, plans, errors: [] };
188
+ try {
189
+ await writeAclRaw(snapshot.sandboxSid, changes);
190
+ }
191
+ catch (error) {
192
+ return { changed: false, plans, errors: [`apply ACL failed: ${errorMessage(error)}`] };
193
+ }
194
+ return { changed: true, plans, errors: [] };
195
+ }
196
+ /** 跑读取脚本,返回原始 stdout。异步:不阻塞事件循环。 */
197
+ function readAclRaw(dir) {
198
+ return new Promise((resolve, reject) => {
199
+ execFile(powershellPath(), [
200
+ '-NoProfile', '-NonInteractive', '-EncodedCommand', encodePowerShell(READ_ACL_SCRIPT),
201
+ ], {
202
+ windowsHide: true,
203
+ timeout: 20_000,
204
+ encoding: 'utf8',
205
+ env: {
206
+ ...process.env,
207
+ EVOLCORE_SERVICES_ACL_ROOT: dir,
208
+ EVOLCORE_SERVICES_SANDBOX_GROUP: SERVICES_SANDBOX_GROUP,
209
+ },
210
+ }, (error, stdout) => {
211
+ if (error)
212
+ reject(error);
213
+ else
214
+ resolve(String(stdout));
215
+ });
216
+ });
217
+ }
218
+ /** 施加计划。异步:不阻塞事件循环。 */
219
+ function writeAclRaw(sandboxSid, items) {
220
+ return new Promise((resolve, reject) => {
221
+ execFile(powershellPath(), [
222
+ '-NoProfile', '-NonInteractive', '-EncodedCommand', encodePowerShell(WRITE_ACL_SCRIPT),
223
+ ], {
224
+ windowsHide: true,
225
+ timeout: 20_000,
226
+ encoding: 'utf8',
227
+ env: {
228
+ ...process.env,
229
+ EVOLCORE_SERVICES_ACL_PLAN: encodeAclChanges(sandboxSid, items),
230
+ },
231
+ }, error => {
232
+ if (error)
233
+ reject(error);
234
+ else
235
+ resolve();
236
+ });
237
+ });
238
+ }
239
+ /** 把 PowerShell 的 JSON 解析成结构。 */
240
+ function parseAclOutput(output) {
241
+ const parsed = JSON.parse(extractJson(output));
242
+ const rows = Array.isArray(parsed) ? parsed : [parsed];
243
+ const sandboxSid = rows.find(row => row.kind === 'sandbox')?.sid ?? undefined;
244
+ const localMachineSid = rows.find(row => row.kind === 'machine')?.sid ?? undefined;
245
+ const byPath = new Map();
246
+ for (const row of rows) {
247
+ if (row.kind !== 'ace')
248
+ continue;
249
+ const entryPath = String(row.path);
250
+ const ace = {
251
+ sid: String(row.sid),
252
+ allow: row.allow === true,
253
+ inherited: row.inherited === true,
254
+ inheritOnly: row.inheritOnly === true,
255
+ // PowerShell 的 FileSystemRights 是有符号 int;泛用位会让它变负。
256
+ rights: Number(row.rights) >>> 0,
257
+ };
258
+ const list = byPath.get(entryPath);
259
+ if (list)
260
+ list.push(ace);
261
+ else
262
+ byPath.set(entryPath, [ace]);
263
+ }
264
+ return {
265
+ sandboxSid,
266
+ localMachineSid,
267
+ entries: [...byPath.entries()].map(([entryPath, aces]) => ({ path: entryPath, aces })),
268
+ };
269
+ }
270
+ /**
271
+ * 对一棵 `services` 目录树施加加固(幂等)。
272
+ *
273
+ * 调用点是运维动作,不在热路径上:`pack add` 之后、`ec services repair-acl`、
274
+ * `ec services doctor` 的报告。**失败不抛出**——加固失败不该让装包回滚,
275
+ * 调用方根据返回的 `errors` 记 `warn`。
276
+ */
277
+ export function hardenServicesAcl(dir) {
278
+ if (process.platform !== 'win32')
279
+ return { changed: false, plans: [], errors: [] };
280
+ const root = path.resolve(dir);
281
+ if (!fs.existsSync(root))
282
+ return { changed: false, plans: [], errors: [] };
283
+ let snapshot;
284
+ try {
285
+ snapshot = readServicesAcl(root);
286
+ }
287
+ catch (error) {
288
+ return { changed: false, plans: [], errors: [`read ACL failed: ${errorMessage(error)}`] };
289
+ }
290
+ if (!snapshot.sandboxSid)
291
+ return { changed: false, plans: [], errors: [] };
292
+ const { plans, changes } = planServicesAclTree(root, snapshot);
293
+ if (changes.length === 0)
294
+ return { changed: false, plans, errors: [] };
295
+ try {
296
+ execFileSync(powershellPath(), [
297
+ '-NoProfile', '-NonInteractive', '-EncodedCommand', encodePowerShell(WRITE_ACL_SCRIPT),
298
+ ], {
299
+ windowsHide: true,
300
+ timeout: 20_000,
301
+ encoding: 'utf8',
302
+ env: {
303
+ ...process.env,
304
+ EVOLCORE_SERVICES_ACL_PLAN: encodeAclChanges(snapshot.sandboxSid, changes),
305
+ },
306
+ });
307
+ }
308
+ catch (error) {
309
+ return { changed: false, plans, errors: [`apply ACL failed: ${errorMessage(error)}`] };
310
+ }
311
+ return { changed: true, plans, errors: [] };
312
+ }
313
+ /** Both execution modes apply the same tree policy and only add an inheritable DENY at the root. */
314
+ function planServicesAclTree(root, snapshot) {
315
+ const plans = snapshot.entries.map(entry => ({
316
+ path: entry.path,
317
+ plan: planServicesAclRepair(entry.aces, snapshot),
318
+ }));
319
+ const changes = plans.filter(item => item.plan.removeSids.length > 0 || item.plan.needsDenyWrite)
320
+ .map(item => ({
321
+ path: item.path,
322
+ removeSids: item.plan.removeSids,
323
+ denyWrite: item.plan.needsDenyWrite && samePath(item.path, root),
324
+ }));
325
+ return { plans, changes };
326
+ }
327
+ function encodeAclChanges(sandboxSid, items) {
328
+ return Buffer.from(JSON.stringify({ sandboxSid, denyRights: SERVICES_DENY_WRITE_RIGHTS, items }), 'utf8').toString('base64');
329
+ }
330
+ function powershellPath() {
331
+ return path.join(process.env.SystemRoot || process.env.WINDIR || 'C:\\Windows', 'System32', 'WindowsPowerShell', 'v1.0', 'powershell.exe');
332
+ }
333
+ /**
334
+ * 从 PowerShell 输出里取出 JSON 正文。
335
+ *
336
+ * PowerShell 5.1 在 `-EncodedCommand` 下仍可能把 progress 记录以 CLIXML 形式吐到
337
+ * stdout(LocalAccounts 模块加载时必现)。`$ProgressPreference` 只压得住一部分路径,
338
+ * 所以这里再兜一次:找第一个 `[{` / `{`,从那里截到最后一个配对括号。
339
+ */
340
+ function extractJson(output) {
341
+ const trimmed = output.trim();
342
+ if (trimmed.startsWith('[') || trimmed.startsWith('{'))
343
+ return trimmed || '[]';
344
+ const arrayStart = trimmed.indexOf('[{');
345
+ const objectStart = trimmed.indexOf('{"');
346
+ const candidates = [arrayStart, objectStart].filter(index => index >= 0);
347
+ if (candidates.length === 0)
348
+ return '[]';
349
+ const start = Math.min(...candidates);
350
+ const end = trimmed.lastIndexOf(trimmed[start] === '[' ? ']' : '}');
351
+ if (end < start)
352
+ return '[]';
353
+ return trimmed.slice(start, end + 1);
354
+ }
355
+ /**
356
+ * `-EncodedCommand` 要 UTF-16LE 的 base64。
357
+ *
358
+ * 用 `-Command` 传多行脚本会被 Win32 参数转义咬到(换行折叠、引号配对错乱),
359
+ * 表现为脚本"静默只跑了一部分"——不报错、结果不对,最难查。编码后整段原样送达。
360
+ */
361
+ function encodePowerShell(script) {
362
+ return Buffer.from(script, 'utf16le').toString('base64');
363
+ }
364
+ function samePath(left, right) {
365
+ return path.resolve(left).toLowerCase() === path.resolve(right).toLowerCase();
366
+ }
367
+ function errorMessage(error) {
368
+ return error instanceof Error ? error.message : String(error);
369
+ }
370
+ /**
371
+ * 导出 ACL:沙箱组 SID、本机 machine SID、以及树内每个对象的每条 ACE。
372
+ *
373
+ * 用 `Get-Acl` 而不是 `icacls`:后者的输出随系统语言变化(中文 Windows 上是
374
+ * 「已成功处理」),且把 `(OI)(CI)` 之类折叠成简写,解析不可靠。
375
+ *
376
+ * **脚本本身保持完全静态**(参数全走环境变量),好处是可以脱离 Node 单独做
377
+ * 语法校验:`[Parser]::ParseFile` 一次就能发现括号/引号错误,而不是等到真跑。
378
+ */
379
+ const READ_ACL_SCRIPT = `
380
+ $ErrorActionPreference='Stop'
381
+ # Get-LocalGroup 首次加载 LocalAccounts 模块会写 progress 记录,走 stderr 时被
382
+ # Node 转成 CLIXML 噪声。一律静音,输出只留 JSON。
383
+ $ProgressPreference='SilentlyContinue'
384
+ $root = $env:EVOLCORE_SERVICES_ACL_ROOT
385
+ $group = Get-LocalGroup -Name $env:EVOLCORE_SERVICES_SANDBOX_GROUP -ErrorAction SilentlyContinue
386
+ $sandbox = if ($group) { $group.SID.Value } else { $null }
387
+ $machine = if ($sandbox) { $sandbox -replace '-[0-9]+$','' } else { $null }
388
+ $rows = New-Object System.Collections.ArrayList
389
+ [void]$rows.Add([pscustomobject]@{ kind='sandbox'; sid=$sandbox })
390
+ [void]$rows.Add([pscustomobject]@{ kind='machine'; sid=$machine })
391
+ $targets = @(Get-Item -LiteralPath $root -Force -ErrorAction SilentlyContinue)
392
+ $targets += @(Get-ChildItem -LiteralPath $root -Recurse -Force -ErrorAction SilentlyContinue)
393
+ foreach ($target in $targets) {
394
+ if ($null -eq $target) { continue }
395
+ try { $acl = Get-Acl -LiteralPath $target.FullName } catch { continue }
396
+ foreach ($rule in $acl.GetAccessRules($true, $true, [System.Security.Principal.SecurityIdentifier])) {
397
+ [void]$rows.Add([pscustomobject]@{
398
+ kind = 'ace'
399
+ path = $target.FullName
400
+ sid = $rule.IdentityReference.Value
401
+ allow = ($rule.AccessControlType -eq 'Allow')
402
+ inherited = [bool]$rule.IsInherited
403
+ inheritOnly = (([string]$rule.PropagationFlags) -match 'InheritOnly')
404
+ rights = [int]$rule.FileSystemRights
405
+ })
406
+ }
407
+ }
408
+ ConvertTo-Json -InputObject @($rows) -Compress -Depth 5
409
+ `;
410
+ /**
411
+ * 施加计划:先移除显式 Allow,再按需加 DENY。
412
+ *
413
+ * 计划走 base64 环境变量传进来——直接拼进 `-Command` 会被路径里的引号/空格咬到。
414
+ * 脚本同样是静态的,`denyRights` 也从计划里取。
415
+ */
416
+ const WRITE_ACL_SCRIPT = `
417
+ $ErrorActionPreference='Stop'
418
+ $payload = [Text.Encoding]::UTF8.GetString([Convert]::FromBase64String($env:EVOLCORE_SERVICES_ACL_PLAN)) | ConvertFrom-Json
419
+ $writeBits = [System.Security.AccessControl.FileSystemRights]$payload.denyRights
420
+ $sandboxSid = [System.Security.Principal.SecurityIdentifier]$payload.sandboxSid
421
+ $inherit = [System.Security.AccessControl.InheritanceFlags]'ContainerInherit, ObjectInherit'
422
+ $none = [System.Security.AccessControl.PropagationFlags]'None'
423
+ foreach ($item in $payload.items) {
424
+ $acl = Get-Acl -LiteralPath $item.path
425
+ $changed = $false
426
+ foreach ($sid in @($item.removeSids)) {
427
+ # 显式 Allow ACE(IsInherited=false)逐条摘掉:按身份 + 类型 + 继承标志精确匹配,
428
+ # 用 RemoveAccessRuleSpecific——RemoveAccessRuleAll 只按 identity/type 匹配且
429
+ # 生成的规则不带继承标志,遇到 (OI)(CI) 的 ACE 匹配不上,会静默不动作。
430
+ $explicit = $acl.GetAccessRules($true, $false, [System.Security.Principal.SecurityIdentifier])
431
+ foreach ($rule in @($explicit)) {
432
+ if ($rule.AccessControlType -eq 'Allow' -and $rule.IdentityReference.Value -eq $sid) {
433
+ [void]$acl.RemoveAccessRuleSpecific($rule)
434
+ $changed = $true
435
+ }
436
+ }
437
+ }
438
+ if ($item.denyWrite) {
439
+ # 必须比对**写位**,不能只看"有 DENY 就算"。
440
+ # 实测踩过:目录上本来就继承着 DENY(R)(只读位),只看类型会把写防护误判成
441
+ # 已存在,DENY(写) 永远加不上去——加固"成功"但什么都没生效。
442
+ $writeMask = [int]$writeBits
443
+ $hasDeny = $false
444
+ foreach ($rule in $acl.GetAccessRules($true, $true, [System.Security.Principal.SecurityIdentifier])) {
445
+ if ($rule.AccessControlType -ne 'Deny') { continue }
446
+ if ($rule.IdentityReference.Value -ne $payload.sandboxSid) { continue }
447
+ if ((([int]$rule.FileSystemRights) -band $writeMask) -eq $writeMask) { $hasDeny = $true }
448
+ }
449
+ if (-not $hasDeny) {
450
+ $deny = [System.Security.AccessControl.FileSystemAccessRule]::new(
451
+ $sandboxSid, $writeBits, $inherit, $none, [System.Security.AccessControl.AccessControlType]::Deny)
452
+ [void]$acl.AddAccessRule($deny)
453
+ $changed = $true
454
+ }
455
+ }
456
+ if ($changed) { Set-Acl -LiteralPath $item.path -AclObject $acl }
457
+ }
458
+ `;