evolcore 0.0.50 → 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 (448) hide show
  1. package/CHANGELOG.md +39 -2
  2. package/bin/ec-build.mjs +60 -0
  3. package/bin/ecmsg.js +65 -63
  4. package/dist/ability/caller/command.js +24 -15
  5. package/dist/ability/caller/contract.js +24 -9
  6. package/dist/ability/caller/credential-files.js +132 -0
  7. package/dist/ability/caller/daemon.js +32 -7
  8. package/dist/ability/caller/schema-view.js +157 -0
  9. package/dist/ability/caller/service.js +202 -63
  10. package/dist/ability/interop-v1.js +156 -113
  11. package/dist/agent-template/jobs.js +14 -110
  12. package/dist/agent-template/runtime.js +331 -193
  13. package/dist/agent-template/service.js +1029 -1104
  14. package/dist/agent-template/share.js +103 -0
  15. package/dist/agent-template/tool-runner.js +25 -0
  16. package/dist/agent-template/types.js +10 -3
  17. package/dist/agents/claude/availability.js +94 -0
  18. package/dist/agents/claude/capability-provider.js +154 -0
  19. package/dist/agents/claude/index.js +145 -0
  20. package/dist/agents/{claude-runner.js → claude/runner.js} +74 -158
  21. package/dist/agents/claude/session-file-adapter.js +246 -0
  22. package/dist/agents/codex/app-server-client.js +90 -10
  23. package/dist/agents/codex/availability.js +164 -0
  24. package/dist/agents/codex/capability-provider.js +138 -0
  25. package/dist/agents/codex/cli.js +38 -0
  26. package/dist/agents/codex/index.js +345 -0
  27. package/dist/agents/codex/mcp-elicitation.js +135 -0
  28. package/dist/agents/{codex-runner.js → codex/runner.js} +648 -382
  29. package/dist/agents/codex/session-file-adapter.js +834 -0
  30. package/dist/agents/dsh/availability.js +28 -0
  31. package/dist/agents/dsh/capability-provider.js +56 -0
  32. package/dist/agents/dsh/desktop-locations.ps1 +66 -0
  33. package/dist/agents/dsh/desktop-probe.cjs +37 -0
  34. package/dist/agents/dsh/index.js +98 -0
  35. package/dist/agents/dsh/installation.js +400 -0
  36. package/dist/agents/dsh/resources.js +755 -0
  37. package/dist/agents/dsh/runner.js +1183 -0
  38. package/dist/agents/dsh/runtime/README.md +243 -0
  39. package/dist/agents/dsh/runtime/authorization.js +23 -0
  40. package/dist/agents/dsh/runtime/bridge.js +837 -0
  41. package/dist/agents/dsh/runtime/config.js +271 -0
  42. package/dist/agents/dsh/runtime/entry.js +229 -0
  43. package/dist/agents/dsh/runtime/session-inspector.js +340 -0
  44. package/dist/agents/dsh/runtime/tool-policy.js +49 -0
  45. package/dist/agents/dsh/session-file-adapter.js +145 -0
  46. package/dist/agents/ecagent/index.js +215 -0
  47. package/dist/agents/{ecagent-runner.js → ecagent/runner.js} +592 -106
  48. package/dist/agents/ecagent/session-file-adapter.js +134 -0
  49. package/dist/agents/gemini/index.js +55 -10
  50. package/dist/agents/gemini/{gemini-runner.js → runner.js} +4 -9
  51. package/dist/aun/ability-device-routing.js +11 -17
  52. package/dist/aun/aid/agentmd.js +27 -1
  53. package/dist/aun/aid/managed-operation.js +6 -4
  54. package/dist/aun/group/invite-service.js +1 -1
  55. package/dist/aun/menu/client.js +1 -1
  56. package/dist/aun/msg/history.js +1 -1
  57. package/dist/aun/msg/managed-operation.js +93 -21
  58. package/dist/aun/msg/p2p.js +6 -6
  59. package/dist/aun/service-proxy.js +1 -1
  60. package/dist/aun/storage/index.js +242 -0
  61. package/dist/build-identity.json +1 -1
  62. package/dist/channels/aun.js +180 -43
  63. package/dist/channels/daemon.js +3 -2
  64. package/dist/channels/dingtalk.js +1 -1
  65. package/dist/channels/feishu.js +9 -9
  66. package/dist/channels/qqbot.js +1 -1
  67. package/dist/channels/wechat.js +2 -2
  68. package/dist/channels/wecom.js +1 -1
  69. package/dist/{agents/claude-gateway → claude-gateway}/agent-registration.js +13 -13
  70. package/dist/{agents/claude-gateway → claude-gateway}/binding.js +3 -3
  71. package/dist/{agents/claude-gateway → claude-gateway}/inbox.js +1 -1
  72. package/dist/{agents/claude-gateway → claude-gateway}/index.js +2 -2
  73. package/dist/{agents/claude-gateway → claude-gateway}/listing.js +3 -3
  74. package/dist/{agents/claude-gateway → claude-gateway}/router.js +4 -4
  75. package/dist/{agents/claude-gateway → claude-gateway}/sessions.js +2 -2
  76. package/dist/{agents/claude-gateway → claude-gateway}/terminal.js +1 -1
  77. package/dist/{agents/claude-gateway → claude-gateway}/transcript.js +1 -1
  78. package/dist/cli/ability-command.js +8 -5
  79. package/dist/cli/ability-output.js +182 -0
  80. package/dist/cli/agent-command.js +1 -1
  81. package/dist/cli/agent-create.js +123 -42
  82. package/dist/cli/agent-template.js +400 -29
  83. package/dist/cli/agent.js +14 -11
  84. package/dist/cli/aun-commands.js +167 -111
  85. package/dist/cli/daemon-commands.js +38 -8
  86. package/dist/cli/data-command.js +1 -1
  87. package/dist/cli/debug-mode.js +9 -0
  88. package/dist/cli/directory.js +1 -2
  89. package/dist/cli/ecmsg-gateway.js +55 -19
  90. package/dist/cli/fs-command.js +67 -39
  91. package/dist/cli/index.js +25 -11
  92. package/dist/cli/init.js +124 -29
  93. package/dist/cli/managed-command-guard.js +2 -0
  94. package/dist/cli/model.js +1 -1
  95. package/dist/cli/restart-monitor.js +2 -2
  96. package/dist/cli/services-command.js +24 -1
  97. package/dist/cli/skill-command.js +4 -4
  98. package/dist/cli/task-context.js +24 -14
  99. package/dist/cli/team-workspace-command.js +50 -52
  100. package/dist/cli/thread-command.js +3 -2
  101. package/dist/cli/trigger-command.js +47 -12
  102. package/dist/cli/watch-logs.js +2 -1
  103. package/dist/config/boot-log.js +3 -0
  104. package/dist/config/builtin-role-templates.js +1 -1
  105. package/dist/config/config-field-policy.js +10 -6
  106. package/dist/config/config-manager.js +33 -12
  107. package/dist/config/gateway-config.js +21 -37
  108. package/dist/config/invoke-ipc-service.js +1 -1
  109. package/dist/config/owner-config.js +5 -3
  110. package/dist/config/peer-book-store.js +2 -3
  111. package/dist/config/peer-book.js +2 -2
  112. package/dist/config/peer-role-resolver.js +2 -2
  113. package/dist/config/provider-identity-migration.js +24 -105
  114. package/dist/config/provider-ipc-service.js +13 -3
  115. package/dist/config/provider-local-sync.js +4 -1
  116. package/dist/config/provider-menu-request.js +21 -3
  117. package/dist/config/provider-templates.js +1 -1
  118. package/dist/config/providers-config.js +39 -15
  119. package/dist/config/providers-import.js +3 -3
  120. package/dist/config/providers-management.js +74 -99
  121. package/dist/config/schema-migration.js +177 -11
  122. package/dist/config/schema-registry.js +1 -1
  123. package/dist/config-store.js +38 -50
  124. package/dist/core/{agent-application-service.js → agent/agent-application-service.js} +9 -9
  125. package/dist/core/{agent-create-status.js → agent/agent-create-status.js} +112 -4
  126. package/dist/core/{agent-creation-claim.js → agent/agent-creation-claim.js} +3 -3
  127. package/dist/core/{agent-ipc-registration.js → agent/agent-ipc-registration.js} +102 -25
  128. package/dist/core/{agent-reload-coordinator.js → agent/agent-reload-coordinator.js} +61 -1
  129. package/dist/core/{agent-runtime.js → agent/agent-runtime.js} +53 -27
  130. package/dist/core/{evolagent-registry.js → agent/evolagent-registry.js} +12 -12
  131. package/dist/core/{evolagent.js → agent/evolagent.js} +11 -11
  132. package/dist/core/auth/agent-delegation.js +1 -8
  133. package/dist/core/auth/delegation-authorization.js +28 -0
  134. package/dist/core/auth/operation-authorizer.js +7 -4
  135. package/dist/core/auth/operation-catalog.js +34 -5
  136. package/dist/core/baseagent/baseagent-availability.js +197 -0
  137. package/dist/core/baseagent/baseagent-capability-adapter.js +288 -0
  138. package/dist/core/baseagent/baseagent-config-shared.js +56 -0
  139. package/dist/core/baseagent/baseagent-identity.js +68 -0
  140. package/dist/core/{baseagent-loader.js → baseagent/baseagent-loader.js} +62 -6
  141. package/dist/core/baseagent/baseagent-model-defaults.js +26 -0
  142. package/dist/{agents → core/baseagent}/baseagent-plugin-descriptor.js +107 -24
  143. package/dist/core/baseagent/baseagent-plugin-loader.js +367 -0
  144. package/dist/core/baseagent/baseagent.js +157 -0
  145. package/dist/{agents → core/baseagent}/runner-types.js +36 -4
  146. package/dist/core/capability/capability-manager.js +79 -30
  147. package/dist/core/capability/providers/claude-capability-provider.js +2 -154
  148. package/dist/core/capability/providers/codex-capability-provider.js +2 -136
  149. package/dist/core/{channel-loader.js → channel/channel-loader.js} +226 -38
  150. package/dist/core/{channel-runtime.js → channel/channel-runtime.js} +18 -18
  151. package/dist/core/command/agent-control.js +60 -15
  152. package/dist/core/command/agent-template-menu.js +21 -9
  153. package/dist/core/command/agentmd-menu-request.js +19 -8
  154. package/dist/core/command/agentmd-menu.js +14 -5
  155. package/dist/core/command/command-handler.js +127 -57
  156. package/dist/core/command/context-policy-menu.js +122 -0
  157. package/dist/core/command/data-root-resolver.js +157 -20
  158. package/dist/core/command/memory-slash.js +6 -6
  159. package/dist/core/command/menu-catalog.js +80 -20
  160. package/dist/core/command/menu-handler.js +305 -25
  161. package/dist/core/command/menu-protocol.js +42 -8
  162. package/dist/core/command/menu-query-batch.js +9 -5
  163. package/dist/core/command/provider-menu.js +7 -11
  164. package/dist/core/command/role-menu.js +1 -1
  165. package/dist/core/command/skill-slash.js +17 -5
  166. package/dist/core/command/slash-gate.js +2 -4
  167. package/dist/core/command/slash-handler.js +127 -96
  168. package/dist/core/command/team-workspace-team.js +3 -3
  169. package/dist/core/command/topic-slash.js +10 -10
  170. package/dist/core/{daemon-bootstrap.js → daemon/daemon-bootstrap.js} +14 -14
  171. package/dist/core/{daemon-control.js → daemon/daemon-control.js} +46 -20
  172. package/dist/core/{daemon-lifecycle.js → daemon/daemon-lifecycle.js} +15 -15
  173. package/dist/core/{host-snapshot.js → daemon/host-snapshot.js} +3 -3
  174. package/dist/core/{ipc-registration.js → daemon/ipc-registration.js} +98 -38
  175. package/dist/core/{lifecycle-notice.js → daemon/lifecycle-notice.js} +4 -5
  176. package/dist/core/file-integrity/store.js +1 -1
  177. package/dist/core/handoff/ipc-registration.js +3 -3
  178. package/dist/core/handoff/runtime.js +1 -1
  179. package/dist/{agents → core/inference}/request-identity.js +2 -2
  180. package/dist/core/inference/text-inference.js +4 -4
  181. package/dist/core/{bootstrap-messages.js → initialization/bootstrap-messages.js} +10 -10
  182. package/dist/core/{bootstrap-service.js → initialization/bootstrap-service.js} +24 -23
  183. package/dist/core/initialization/service.js +54 -9
  184. package/dist/core/invoke/executors/media.js +1 -1
  185. package/dist/core/invoke/executors/text.js +1 -1
  186. package/dist/core/memory/consolidation-context.js +1 -1
  187. package/dist/core/memory/consolidation-trigger.js +9 -3
  188. package/dist/core/memory/consolidation.js +4 -4
  189. package/dist/core/memory/memory-admin.js +6 -6
  190. package/dist/core/memory/memory-writer.js +1 -1
  191. package/dist/core/memory/relation-idle-monitor.js +1 -1
  192. package/dist/core/message/aun-ipc-sender.js +114 -75
  193. package/dist/core/message/aun-request-registry.js +13 -5
  194. package/dist/core/message/auto-mention-gate.js +1 -1
  195. package/dist/core/message/contact-admission.js +1 -1
  196. package/dist/core/message/im-renderer.js +19 -0
  197. package/dist/core/{interaction-router.js → message/interaction-router.js} +4 -4
  198. package/dist/core/message/items-formatter.js +5 -5
  199. package/dist/core/message/message-admission.js +1 -1
  200. package/dist/core/message/message-bridge.js +135 -54
  201. package/dist/core/message/message-queue.js +83 -4
  202. package/dist/core/message/message-utils.js +1 -1
  203. package/dist/core/message/peer-mode.js +1 -1
  204. package/dist/core/message/response-engine.js +347 -163
  205. package/dist/core/message/send-options.js +9 -6
  206. package/dist/core/message/send-routing.js +45 -109
  207. package/dist/core/message/stream-idle-monitor.js +1 -1
  208. package/dist/core/{data-migration.js → migration/data-migration.js} +29 -1
  209. package/dist/core/model/catalog-service.js +29 -8
  210. package/dist/core/model/model-capabilities.js +88 -0
  211. package/dist/core/model/model-catalog.js +14 -3
  212. package/dist/core/model/model-diagnostics.js +4 -4
  213. package/dist/core/ownership/owner-resolver.js +95 -15
  214. package/dist/core/{pack-auth.js → pack/pack-auth.js} +30 -3
  215. package/dist/core/{pack-install.js → pack/pack-install.js} +95 -17
  216. package/dist/core/permission/approval-gateway.js +9 -18
  217. package/dist/core/permission/ec-command-parser.js +70 -34
  218. package/dist/core/permission/managed-file.js +234 -0
  219. package/dist/core/permission/protected-paths.js +56 -0
  220. package/dist/core/permission/sandbox-runtime.js +267 -3
  221. package/dist/core/permission/session-path-grants.js +1 -1
  222. package/dist/core/permission/shell-environment.js +15 -1
  223. package/dist/core/plugin/plugin-lifecycle.js +442 -0
  224. package/dist/core/session/adapters/claude-session-file-adapter.js +2 -246
  225. package/dist/core/session/adapters/codex-session-file-adapter.js +2 -566
  226. package/dist/core/session/adapters/ecagent-session-file-adapter.js +2 -134
  227. package/dist/core/{background-session → session/background}/session-cleanup.js +2 -2
  228. package/dist/core/{background-session → session/background}/types.js +1 -1
  229. package/dist/core/session/session-file-health.js +2 -272
  230. package/dist/core/session/session-idle-monitor.js +1 -1
  231. package/dist/core/session/session-manager.js +29 -2
  232. package/dist/core/session/session-terminal.js +185 -0
  233. package/dist/core/session/session-title.js +8 -11
  234. package/dist/core/{system-session → session/system}/memory.js +43 -9
  235. package/dist/core/{system-session → session/system}/registry.js +1 -1
  236. package/dist/core/{system-session → session/system}/types.js +1 -1
  237. package/dist/core/skill/index-generator.js +1 -0
  238. package/dist/core/task/task-activity-store.js +112 -0
  239. package/dist/core/task/task-recovery-service.js +2 -2
  240. package/dist/core/thread/ipc-operation.js +2 -2
  241. package/dist/core/thread/thread-operation.js +2 -1
  242. package/dist/core/thread/thread-route.js +5 -3
  243. package/dist/core/thread/thread-service.js +14 -4
  244. package/dist/directory/{owner-directory-admission.js → admission.js} +3 -3
  245. package/dist/directory/{owner-directory-cache.js → cache.js} +90 -8
  246. package/dist/directory/{owner-directory-markdown.js → markdown.js} +2 -2
  247. package/dist/directory/{owner-directory-query-operation.js → query-operation.js} +83 -9
  248. package/dist/directory/{owner-directory-search.js → search.js} +50 -2
  249. package/dist/directory/{owner-directory-store.js → store.js} +2 -2
  250. package/dist/eck/kit-renderer.js +1 -1
  251. package/dist/eck/manifest-engine.js +64 -2
  252. package/dist/eck/message-renderer.js +35 -0
  253. package/dist/ecweb/basic-settings-service.js +9 -3
  254. package/dist/{contracts → ecweb/contracts}/ecweb-service-protocol.js +2 -1
  255. package/dist/ecweb/dsh-native-service.js +413 -0
  256. package/dist/ecweb/providers-service.js +1 -1
  257. package/dist/ecweb/runtime/lifecycle.js +1 -1
  258. package/dist/ecweb/runtime/supervisor.js +1 -1
  259. package/dist/event-center/center-config.js +2 -2
  260. package/dist/event-center/dispatcher.js +1 -1
  261. package/dist/event-center/ipc-operation.js +12 -3
  262. package/dist/event-center/pack-loader.js +2 -2
  263. package/dist/event-center/registry.js +6 -6
  264. package/dist/event-center/runtime.js +2 -2
  265. package/dist/index.js +71 -42
  266. package/dist/ipc.js +103 -10
  267. package/dist/outputs/authorization.js +27 -0
  268. package/dist/outputs/events.js +10 -1
  269. package/dist/outputs/panel-cards.js +960 -0
  270. package/dist/paths.js +12 -0
  271. package/dist/pay/command.js +1 -1
  272. package/dist/pay/runtime.js +18 -10
  273. package/dist/response-system/engines/v1/proactive-flow.js +1 -1
  274. package/dist/services/dispatcher.js +2 -2
  275. package/dist/services/host/main.js +10 -1
  276. package/dist/services/host/protocol.js +9 -2
  277. package/dist/services/host/resident.js +37 -0
  278. package/dist/services/host-client.js +12 -0
  279. package/dist/services/host-recycle.js +8 -3
  280. package/dist/services/host-runtime.js +54 -15
  281. package/dist/services/index.js +83 -19
  282. package/dist/services/ipc-operation.js +303 -38
  283. package/dist/services/pack-manager.js +2 -2
  284. package/dist/services/router.js +43 -3
  285. package/dist/services/script-runner.js +34 -25
  286. package/dist/services/service-payload.js +28 -1
  287. package/dist/services/validation.js +28 -2
  288. package/dist/stats/context-usage.js +110 -0
  289. package/dist/stats/model-resolver.js +103 -17
  290. package/dist/stats/query.js +5 -0
  291. package/dist/trigger/application-service.js +3 -2
  292. package/dist/trigger/authorization.js +36 -33
  293. package/dist/trigger/ipc-service.js +4 -4
  294. package/dist/trigger/local-files.js +8 -176
  295. package/dist/trigger/manager.js +2 -2
  296. package/dist/trigger/parser.js +48 -0
  297. package/dist/trigger/scheduler.js +14 -2
  298. package/dist/trigger/script-executor.js +21 -0
  299. package/dist/trigger/script-sandbox.js +57 -243
  300. package/dist/trigger/system-definitions.js +25 -0
  301. package/dist/trigger/validation.js +1 -1
  302. package/dist/utils/atomic-write.js +88 -1
  303. package/dist/utils/cross-platform.js +4 -42
  304. package/dist/utils/error-dict.json +22 -1
  305. package/dist/utils/error-utils.js +193 -6
  306. package/dist/utils/evolcore-version.js +2 -2
  307. package/dist/utils/host-info.js +1 -1
  308. package/dist/utils/logger.js +3 -1
  309. package/dist/utils/media-cache.js +99 -4
  310. package/dist/utils/startup-trace.js +20 -4
  311. package/dist/utils/welcome.js +64 -20
  312. package/ecagent/README.md +35 -0
  313. package/ecagent/dist/agent-loop.js +80 -30
  314. package/ecagent/dist/harness/env/nodejs.d.ts +16 -0
  315. package/ecagent/dist/harness/env/nodejs.js +49 -20
  316. package/ecagent/dist/harness/messages.js +3 -2
  317. package/ecagent/dist/harness/types.d.ts +1 -0
  318. package/ecagent/dist/runtime/types.d.ts +2 -0
  319. package/ecagent/dist/runtime/utils/validation.d.ts +7 -1
  320. package/ecagent/dist/runtime/utils/validation.js +42 -0
  321. package/ecagent/dist/types.d.ts +2 -0
  322. package/kits/docs/INDEX.md +1 -1
  323. package/kits/docs/channels/feishu.md +1 -1
  324. package/kits/docs/evolcore/INDEX.md +10 -7
  325. package/kits/docs/evolcore/agent-create.md +2 -0
  326. package/kits/docs/evolcore/agent.md +100 -13
  327. package/kits/docs/evolcore/aid.md +19 -3
  328. package/kits/docs/evolcore/config.md +94 -0
  329. package/kits/docs/evolcore/ctl.md +2 -1
  330. package/kits/docs/evolcore/ec-capabilities.md +7 -10
  331. package/kits/docs/evolcore/ecweb-lifecycle.md +5 -1
  332. package/kits/docs/evolcore/event.md +1 -1
  333. package/kits/docs/evolcore/fs.md +49 -3
  334. package/kits/docs/evolcore/group.md +3 -3
  335. package/kits/docs/evolcore/memory-consolidation.md +1 -1
  336. package/kits/docs/evolcore/menu-protocol.md +24 -2
  337. package/kits/docs/evolcore/model.md +9 -1
  338. package/kits/docs/evolcore/msg.md +30 -28
  339. package/kits/docs/evolcore/pay.md +8 -20
  340. package/kits/docs/evolcore/plugin.md +74 -0
  341. package/kits/docs/evolcore/provider.md +8 -2
  342. package/kits/docs/evolcore/rpc.md +2 -2
  343. package/kits/docs/evolcore/skill.md +17 -1
  344. package/kits/docs/evolcore/stats.md +5 -0
  345. package/kits/docs/evolcore/storage.md +22 -0
  346. package/kits/docs/evolcore/thread-chain.md +19 -10
  347. package/kits/docs/evolcore/tool-authorization.md +4 -0
  348. package/kits/docs/evolcore/trigger.md +89 -13
  349. package/kits/docs/identity/AID_PROFILE_SPEC.md +1 -1
  350. package/kits/docs/venues/feishu-group.md +3 -2
  351. package/kits/docs/venues/feishu-private.md +3 -2
  352. package/kits/rules/02-navigation.md +20 -13
  353. package/kits/rules/06-channel.md +18 -2
  354. package/kits/schemas/_meta.json +8 -4
  355. package/kits/schemas/agent-config.schema.23.json +19 -3
  356. package/kits/schemas/agent-config.schema.24.json +986 -0
  357. package/kits/schemas/agent-config.schema.25.json +986 -0
  358. package/kits/schemas/daemon.schema.11.json +487 -0
  359. package/kits/schemas/daemon.schema.12.json +505 -0
  360. package/kits/schemas/defaults.schema.8.json +484 -0
  361. package/kits/schemas/providers.schema.1.json +1 -1
  362. package/kits/schemas/providers.schema.2.json +1 -1
  363. package/kits/schemas/providers.schema.3.json +8 -2
  364. package/kits/skills/.switches.json +4 -0
  365. package/kits/skills/ability/SKILL.md +194 -27
  366. package/kits/skills/ability/STRUCTURE.md +5 -0
  367. package/kits/skills/agent-output-cards/SKILL.md +90 -54
  368. package/kits/skills/agent-output-cards/examples/html-surface.json +11 -0
  369. package/kits/skills/agent-output-cards/examples/meeting-followups.json +16 -0
  370. package/kits/skills/agent-output-cards/examples/meeting-latest.json +24 -0
  371. package/kits/skills/agent-output-cards/examples/project-metrics.json +16 -0
  372. package/kits/skills/agent-output-cards/examples/quick-links.json +18 -0
  373. package/kits/skills/agent-output-cards/examples/surface.html +8 -0
  374. package/kits/skills/agent-template-project/SKILL.md +51 -0
  375. package/kits/skills/agent-template-project/references/01-collect-and-pack.md +174 -0
  376. package/kits/skills/agent-template-project/references/02-upload-and-share.md +109 -0
  377. package/kits/skills/agent-template-project/references/03-download-and-install.md +189 -0
  378. package/kits/skills/agent-template-project/references/04-upgrade-and-recovery.md +74 -0
  379. package/kits/skills/agent-template-project/references/05-publish-to-platform.md +62 -0
  380. package/kits/skills/ec-group/SKILL.md +3 -3
  381. package/kits/skills/ec-group-collaboration/SKILL.md +4 -4
  382. package/kits/skills/ec-identity/SKILL.md +9 -6
  383. package/kits/skills/ec-pay/SKILL.md +163 -41
  384. package/kits/skills/ec-provider/SKILL.md +5 -5
  385. package/kits/skills/ec-service-call/SKILL.md +3 -0
  386. package/kits/skills/ec-skill/SKILL.md +25 -9
  387. package/kits/skills/ec-skill/scripts/cli.mjs +7 -7
  388. package/kits/skills/ec-skill/scripts/skill.mjs +55 -41
  389. package/kits/skills/ec-skill/scripts/template/SKILL.md.tmpl +9 -0
  390. package/kits/skills/ec-trigger/SKILL.md +2 -2
  391. package/kits/skills/personal-assistant/SKILL.md +22 -22
  392. package/kits/skills/personal-assistant/references/03-data-flow-and-gaps.md +1 -1
  393. package/kits/skills/scrapling-article-fetch/SKILL.md +5 -5
  394. package/kits/skills/thread-ops/SKILL.md +19 -9
  395. package/kits/skills/wechat-article-media-download/SKILL.md +2 -2
  396. package/kits/skills/wechat-article-reader/SKILL.md +2 -2
  397. package/kits/templates/system-fragments/commands.md +1 -1
  398. package/kits/templates/system-fragments/personal-assistant.md +2 -2
  399. package/kits/templates/system-fragments/reply.md +14 -9
  400. package/kits/templates/system-fragments/session.md +1 -1
  401. package/kits/templates/system-fragments/thread.md +10 -5
  402. package/package.json +6 -5
  403. package/scripts/agent-template/index.mjs +7 -1
  404. package/scripts/agent-template/inspect.mjs +81 -35
  405. package/scripts/agent-template/overlay.mjs +110 -4
  406. package/scripts/agent-template/shared/common.mjs +36 -4
  407. package/scripts/agent-template/shared/plan.mjs +4 -2
  408. package/scripts/agent-template/shared/service-packs.mjs +104 -0
  409. package/scripts/agent-template/shared/team-schema.json +467 -54
  410. package/scripts/agent-template/shared/template-contract.mjs +70 -68
  411. package/scripts/agent-template/shared/template-package.mjs +153 -36
  412. package/scripts/agent-template/shared/template-runtime.mjs +76 -64
  413. package/scripts/agent-template/shared/template.mjs +11 -46
  414. package/scripts/agent-template/team-pack.mjs +451 -35
  415. package/scripts/agent-template/team-preview.mjs +75 -226
  416. package/scripts/aid-batch/identity-batch.mjs +1 -1
  417. package/dist/agents/baseagent-availability.js +0 -176
  418. package/dist/agents/baseagent-capability-adapter.js +0 -102
  419. package/dist/agents/baseagent-plugin-loader.js +0 -145
  420. package/dist/agents/baseagent.js +0 -816
  421. package/dist/agents/codex/catalog.js +0 -80
  422. package/dist/agents/ecagent-plugin-lazy.js +0 -41
  423. package/dist/agents/tool-time-context.js +0 -55
  424. package/dist/core/legacy-rename.js +0 -41
  425. package/dist/core/plugin-lifecycle.js +0 -137
  426. package/dist/core/rate-window.js +0 -53
  427. package/dist/core/runner-reload-transaction.js +0 -60
  428. package/dist/core/runtime-lock.js +0 -90
  429. package/dist/core/soul.js +0 -66
  430. package/dist/core/system-session/grants.js +0 -40
  431. package/dist/directory/owner-directory-agentmd-sync.js +0 -89
  432. package/dist/directory/owner-directory-request-operation.js +0 -79
  433. package/dist/directory/owner-directory-text.js +0 -60
  434. package/kits/skills/ec-pay/references/pay-cli.md +0 -110
  435. /package/dist/agents/gemini/{gemini-capability-provider.js → capability-provider.js} +0 -0
  436. /package/dist/agents/gemini/{gemini-session-file-adapter.js → session-file-adapter.js} +0 -0
  437. /package/dist/{agents/claude-gateway → claude-gateway}/types.js +0 -0
  438. /package/dist/core/{system-channels.js → channel/system-channels.js} +0 -0
  439. /package/dist/core/{daemon-file-cache.js → daemon/daemon-file-cache.js} +0 -0
  440. /package/dist/core/{event-bus.js → event/event-bus.js} +0 -0
  441. /package/dist/core/{event-catalog.js → event/event-catalog.js} +0 -0
  442. /package/dist/core/{pack-ledger.js → pack/pack-ledger.js} +0 -0
  443. /package/dist/directory/{owner-directory-identity.js → identity.js} +0 -0
  444. /package/dist/directory/{owner-directory-policy.js → policy.js} +0 -0
  445. /package/dist/directory/{owner-directory-remarks.js → remarks.js} +0 -0
  446. /package/dist/directory/{owner-directory-scope.js → scope.js} +0 -0
  447. /package/dist/{contracts → ecweb/contracts}/ecweb-instance.js +0 -0
  448. /package/kits/templates/{bootstrap-welcome.md → bootstrap-intro.md} +0 -0
@@ -372,7 +372,7 @@ const EVOLCORE_EXECUTABLE_ALIASES = new Set(['ec', 'ec.cmd', 'ec.exe', 'ec.ps1']
372
372
  * 轻量发送入口 `ecmsg` 的前缀映射:`ecmsg <args...>` 等价于 `ec msg <args...>`。
373
373
  *
374
374
  * 必须在这里归一,不能只做一个独立脚本——委托审批是按规范化 argv 的哈希
375
- * arm 的(codex-runner 的 armApprovedDelegationCommand)。若 `ecmsg` 不归一到
375
+ * arm 的(Codex runner 的 armApprovedDelegationCommand)。若 `ecmsg` 不归一到
376
376
  * `['ec','msg',...]`,策略层会把它当普通命令(kind: 'none'),既不 arm 审批,
377
377
  * daemon 侧也算不出匹配的哈希,最终必然 INVALID_DELEGATION;更糟的是它会绕过
378
378
  * ec_shell_composite_command 与会话身份绑定,成为冒充发送的后门。
@@ -392,12 +392,13 @@ const EVOLCORE_SUBCOMMANDS = new Set([
392
392
  'mode', 'model', 'msg', 'mv', 'net', 'queue', 'response', 'restart',
393
393
  'restart-monitor', 'rpc', 'start', 'stats', 'status', 'stop', 'storage', 'task',
394
394
  'trigger', 'proxy', 'version', 'watch', 'session', 'team', 'upgrade', 'update',
395
- 'directory', 'getmeta', 'integrity', 'invoke', 'memory', 'provider', 'role', 'skill', 'thread', 'pay',
395
+ 'directory', 'getmeta', 'integrity', 'invoke', 'memory', 'provider', 'plugin', 'role', 'skill', 'thread', 'pay',
396
396
  ]);
397
397
  // Development/install entrypoints that are part of this repository's CLI.
398
398
  // Only these exact relative paths are canonicalized; arbitrary Node scripts
399
399
  // must never become an EC command merely because their filename is similar.
400
- const EVOLCORE_NODE_WRAPPER_PATHS = new Set(['bin/ec.js', 'dist/cli/index.js']);
400
+ const EVOLCORE_NODE_WRAPPER_PATHS = new Set(['bin/ec.js', 'dist/cli/index.js', 'bin/ecmsg.js']);
401
+ const ECMSG_NODE_PREFIX = /^node(?:\.exe)?[ \t]+(['"]?)(?:\.[\\/])?bin[\\/]ecmsg\.js\1(?=$|\s|[;&|`()<>])/i;
401
402
  const SHELL_UNQUOTED_META = new Set([
402
403
  ';', '&', '|', '`', '<', '>', '$', '(', ')', '*', '?', '[', ']', '{', '}', '#',
403
404
  ]);
@@ -449,15 +450,18 @@ function stripHeredocBodies(command) {
449
450
  // never establish an EC invocation.
450
451
  const POWERSHELL_ASSIGNMENT_PREFIX = /^\$(?:[A-Za-z_][\w:]*|\{[^{}\r\n]+\})\s*=(?!=)/u;
451
452
  function hasEcCommandPrefix(command, dialect = 'posix') {
453
+ const posix = dialect === 'posix';
452
454
  let quote = null;
453
455
  let escaped = false;
454
456
  let boundary = true;
457
+ let wordBoundary = true;
455
458
  const powerShell = dialect === 'powershell';
456
459
  for (let index = 0; index < command.length; index++) {
457
460
  const char = command[index];
458
461
  if (escaped) {
459
462
  escaped = false;
460
463
  boundary = false;
464
+ wordBoundary = false;
461
465
  continue;
462
466
  }
463
467
  if (quote === 'single') {
@@ -478,6 +482,15 @@ function hasEcCommandPrefix(command, dialect = 'posix') {
478
482
  quote = null;
479
483
  continue;
480
484
  }
485
+ if (posix && char === '\\') {
486
+ // A continued line does not end a command or word. Other escaped
487
+ // characters are word data, including whitespace and separators.
488
+ if (command[index + 1] === '\n')
489
+ index++;
490
+ else
491
+ escaped = true;
492
+ continue;
493
+ }
481
494
  if (powerShell && char === '`') {
482
495
  escaped = true;
483
496
  continue;
@@ -489,7 +502,8 @@ function hasEcCommandPrefix(command, dialect = 'posix') {
489
502
  index = end + 1;
490
503
  continue;
491
504
  }
492
- if (powerShell && char === '#' && (index === 0 || /\s/.test(command[index - 1]))) {
505
+ if (char === '#' && (posix && wordBoundary
506
+ || powerShell && (index === 0 || /\s/.test(command[index - 1])))) {
493
507
  const end = command.indexOf('\n', index);
494
508
  if (end < 0)
495
509
  return false;
@@ -508,23 +522,28 @@ function hasEcCommandPrefix(command, dialect = 'posix') {
508
522
  if (powerShell ? isPowerShellSingleQuote(char) : char === "'") {
509
523
  quote = 'single';
510
524
  boundary = false;
525
+ wordBoundary = false;
511
526
  continue;
512
527
  }
513
528
  if (powerShell ? isPowerShellDoubleQuote(char) : char === '"') {
514
529
  quote = 'double';
515
530
  boundary = false;
531
+ wordBoundary = false;
516
532
  continue;
517
533
  }
518
534
  if (powerShell && /[{}\r\n]/.test(char)) {
519
535
  boundary = true;
520
536
  continue;
521
537
  }
522
- if (/[;&|`()<>]/.test(char)) {
538
+ if (posix && char === '\n' || /[;&|`()<>]/.test(char)) {
523
539
  boundary = true;
540
+ wordBoundary = true;
524
541
  continue;
525
542
  }
526
- if (boundary && /\s/.test(char))
543
+ if (/\s/.test(char)) {
544
+ wordBoundary = !posix || char === ' ' || char === '\t';
527
545
  continue;
546
+ }
528
547
  if (boundary && powerShell && char === '$') {
529
548
  const assignment = POWERSHELL_ASSIGNMENT_PREFIX.exec(command.slice(index));
530
549
  if (assignment) {
@@ -538,7 +557,10 @@ function hasEcCommandPrefix(command, dialect = 'posix') {
538
557
  // `ecmsg ... && rm -rf /` 会落成 kind:'none',绕过复合命令拦截。
539
558
  if (boundary && /^ecmsg(?:\.cmd|\.exe|\.ps1)?(?=$|\s|[;&|`()<>])/i.test(command.slice(index)))
540
559
  return true;
560
+ if (boundary && ECMSG_NODE_PREFIX.test(command.slice(index)))
561
+ return true;
541
562
  boundary = false;
563
+ wordBoundary = false;
542
564
  }
543
565
  return false;
544
566
  }
@@ -844,9 +866,12 @@ export function normalizeEvolcoreCommandArgv(argv) {
844
866
  if (entryAlias && EVOLCORE_MSG_ENTRY_ALIASES.has(entryAlias)) {
845
867
  return ['ec', 'msg', ...materialized.slice(1)];
846
868
  }
847
- if (typeof executable === 'string' && isNodeExecutable(executable) && materialized.length >= 2
848
- && typeof materialized[1] === 'string' && normalizeNodeWrapperPath(materialized[1])) {
849
- return ['ec', ...materialized.slice(2)];
869
+ if (typeof executable === 'string' && isNodeExecutable(executable) && typeof materialized[1] === 'string') {
870
+ const wrapper = normalizeNodeWrapperPath(materialized[1]);
871
+ if (wrapper === 'bin/ecmsg.js')
872
+ return ['ec', 'msg', ...materialized.slice(2)];
873
+ if (wrapper)
874
+ return ['ec', ...materialized.slice(2)];
850
875
  }
851
876
  return materialized;
852
877
  }
@@ -1300,7 +1325,8 @@ export function parseCodexCarrierCommand(carrier, options = {}) {
1300
1325
  : parsed;
1301
1326
  }
1302
1327
  export function literalShellParseRemedy(failure) {
1303
- if (failure.issue === 'shell-composition') {
1328
+ if (failure.issue === 'shell-composition'
1329
+ || failure.issue === 'structural-newline' && failure.dialect === 'posix') {
1304
1330
  return '一次调用只执行一条完整命令;查询和操作请拆成独立工具调用,不要拼接管道、重定向、分号或子表达式。';
1305
1331
  }
1306
1332
  if (failure.dialect === 'posix' && failure.issue === 'unsupported-escape') {
@@ -2994,13 +3020,13 @@ export function parseBoundedOutputShellCommand(command, options = {}) {
2994
3020
  // 所以两种情况都切在 operators[0].start,绝不能按 end 切——那会把 `2>&1` 混进 argv。
2995
3021
  const first = operators[0];
2996
3022
  const sourceText = trimShellSpacing(input.slice(0, first.start));
3023
+ // 源命令允许 `$TMPDIR` 作**参数**(`--spec-file $TMPDIR/x.json`):
3024
+ // 它已被换成哨兵串,不会在 spawn 时被再次展开,最终路径由 policy 层
3025
+ // 用本会话 TMPDIR 还原并校验。限制只针对重定向目标——那是替另一条命令
3026
+ // 指定写入位置,不能借 `$TMPDIR` 表达(见下面 redirect 分支)。
2997
3027
  const argv = parseLiteralShellArgv(sourceText, literalOptions);
2998
3028
  if (!argv)
2999
3029
  return null;
3000
- // `$TMPDIR` is a transport-level path reference, never an argument
3001
- // expansion for the privileged command itself.
3002
- if (argv.some(value => value.includes(MANAGED_TMPDIR_TOKEN)))
3003
- return null;
3004
3030
  const filterChain = [];
3005
3031
  let outputPath;
3006
3032
  let discardStdout = false;
@@ -3051,8 +3077,18 @@ export function parseBoundedOutputShellCommand(command, options = {}) {
3051
3077
  prevEnd = segmentEnd;
3052
3078
  cursor++;
3053
3079
  }
3080
+ // 源命令参数里的 `$TMPDIR` 已在 tokenize 阶段换成哨兵串(literalOptions
3081
+ // 关掉了 allowManagedTmpDir,避免它被当成展开放行)。这里必须显式还原成
3082
+ // 本会话的真实 TMPDIR,否则下游 spawn 会拿到字面量哨兵。
3083
+ // 没有 managedTempDir 就无从还原 → 拒绝,不能让 `$TMPDIR` 逃进 argv。
3084
+ const needsRestore = argv.some(value => value.includes(MANAGED_TMPDIR_TOKEN));
3085
+ if (needsRestore && !options.managedTempDir)
3086
+ return null;
3087
+ const restoredArgv = needsRestore
3088
+ ? argv.map(value => restoreManagedTmpDirToken(value, options.managedTempDir))
3089
+ : argv;
3054
3090
  return {
3055
- argv,
3091
+ argv: restoredArgv,
3056
3092
  mergeStderr,
3057
3093
  ...(discardStdout ? { discardStdout } : {}),
3058
3094
  ...(discardStderr ? { discardStderr } : {}),
@@ -3379,7 +3415,9 @@ export function resolveCanonicalEvolcoreToolInput(input, options = {}) {
3379
3415
  ? parseFailure(classification.issue, command, 0, 0, dialect ?? 'posix')
3380
3416
  : parsed,
3381
3417
  };
3382
- if (!parsed.ok && (hasEcCommandPrefix(command, dialect)
3418
+ // Match the classifier's treatment of heredoc data in this fallback too.
3419
+ const prefixCommand = !dialect || dialect === 'posix' ? stripHeredocBodies(command) : command;
3420
+ if (!parsed.ok && (hasEcCommandPrefix(prefixCommand, dialect)
3383
3421
  || carrier?.dialect === 'powershell' && hasPowerShellCredentialAssignment(command))) {
3384
3422
  return { kind: 'invalid', failure: parsed };
3385
3423
  }
@@ -3425,7 +3463,7 @@ const PROACTIVE_SEND_VALUE_FLAGS = new Set([
3425
3463
  '--check-every', '--trigger-prompt', '--return', '--timeout',
3426
3464
  ]);
3427
3465
  const PROACTIVE_SEND_BOOLEAN_FLAGS = new Set([
3428
- '--mention-all',
3466
+ '--mention-all', '--selfmode',
3429
3467
  ]);
3430
3468
  /**
3431
3469
  * 三态取值选项:`--encrypt yes|no|auto`,必须带取值;不写该参数才是默认 `auto`。
@@ -3826,8 +3864,8 @@ export function describeProactiveSendCommandFailure(toolName, input, session) {
3826
3864
  return undefined;
3827
3865
  const commandText = [input.command, input.input, ...(Array.isArray(input.commandArgv) ? input.commandArgv : [])]
3828
3866
  .filter((value) => typeof value === 'string').join(' ');
3829
- // `ecmsg send` 是 `ec msg send` 的同义词,诊断必须同样认得,否则别名写法
3830
- // 被拒时只会掉进"上一轮未包含意图表达"的笼统提示,模型拿不到可操作原因。
3867
+ // 诊断同时认 `ecmsg send` 与它规范化后的内部形态(`ec msg|group send`),否则
3868
+ // ecmsg 写法被拒时只会掉进"上一轮未包含意图表达"的笼统提示,模型拿不到可操作原因。
3831
3869
  if (!/\bec(?:\.cmd|\.exe)?\s+(?:group|msg)\s+send\b|\becmsg(?:\.cmd|\.exe|\.ps1)?\s+send\b/i.test(commandText)) {
3832
3870
  return undefined;
3833
3871
  }
@@ -3838,7 +3876,7 @@ export function describeProactiveSendCommandFailure(toolName, input, session) {
3838
3876
  return `当前汇报命令未通过规范解析(${result.issue},${result.dialect},位置 ${result.offset});`
3839
3877
  + '请检查引号和转义,并将发送作为一条独立命令。';
3840
3878
  }
3841
- // 正文里只是提到 "ec msg send" 的其它命令(如 ec memory note "...")不是发送调用。
3879
+ // 正文里只是提到发送命令的其它命令(如 ec memory note "ecmsg send …")不是发送调用。
3842
3880
  const argv = result.argv;
3843
3881
  if (argv[0] !== 'ec' || (argv[1] !== 'msg' && argv[1] !== 'group') || argv[2] !== 'send')
3844
3882
  return undefined;
@@ -3854,24 +3892,21 @@ export function describeProactiveSendCommandFailure(toolName, input, session) {
3854
3892
  }
3855
3893
  const scope = argv[1];
3856
3894
  const prefix = '发送命令被拒:';
3857
- // 面向模型的推荐写法统一是 `ecmsg send`:本端恒为会话本端,不写 from;
3858
- // 目标在非默认话题时用 --to。位置式 `ec msg send <from> <to>` 仍然可用,
3859
- // 但只在宿主终端和历史脚本里出现,不再作为提示内容教给模型。
3860
- const expectedForm = scope === 'group'
3861
- ? `ecmsg send ${session?.channelId ? `--to ${session.channelId}` : '(群会话内直接省略 --to)'} "<正文>"`
3862
- : `ecmsg send${session?.channelId ? ` --to ${session.channelId}` : ''} "<正文>"`;
3863
- // 带 --thread 的发送走话题路由校验,允许省略 from/to;走到这里说明话题本身没解析通过。
3895
+ // 面向模型的写法统一是 `ecmsg send`:本端恒为会话本端,不写 from;
3896
+ // 接收方由话题和模式推出,不用 --to。
3897
+ const expectedForm = 'ecmsg send "<正文>"';
3898
+ // 带 --thread 的发送走话题路由校验;走到这里说明话题本身没解析通过。
3864
3899
  if (sendOptionValue(argv, '--thread')) {
3865
- return `${prefix}带 --thread 的跨话题发送未通过校验——话题必须已存在于本端:话题写裸 id,`
3866
- + `主话题写 main:<aidA>:<aidB>(两端之一必须是本端)。from(若给出)必须是本人,`
3867
- + `to(若给出)必须是该话题对端,且需携带 --check-every。`
3900
+ return `${prefix}带 --thread 的跨话题发送未通过校验——话题必须已存在于本端,且不能是当前话题:`
3901
+ + `独立话题写 thread-…,主话题写 main:<aidA>:<aidB>(两端之一必须是本端)。`
3902
+ + `跨话题默认是委托(收件人为该话题对端);要发给自己加 --selfmode。`
3868
3903
  + `主话题 id 只在本端之间有效,不要转发给别人使用。可用 ec thread list <对方AID> 取得可用值。`;
3869
3904
  }
3870
3905
  // 私聊/群聊用错了 scope。
3871
3906
  if (session?.chatType && (session.chatType === 'group') !== (scope === 'group')) {
3872
3907
  return session.chatType === 'group'
3873
3908
  ? `${prefix}当前是群聊会话,公开回复直接写 ecmsg send "<正文>"(群会话里即群内公开发送);`
3874
- + `要私下联系本条消息的发送者,用 ecmsg send --to <对方AID> "<正文>"。`
3909
+ + `要私下联系本条消息的发送者,用 --thread <与对方的私聊话题>。`
3875
3910
  : `${prefix}当前是私聊会话,回复用 ${expectedForm};群回复在群会话里同样用 ecmsg send。`;
3876
3911
  }
3877
3912
  const from = argv[3];
@@ -3895,7 +3930,7 @@ export function describeProactiveSendCommandFailure(toolName, input, session) {
3895
3930
  }
3896
3931
  if (session?.channelId && to !== session.channelId) {
3897
3932
  return `${prefix}目标必须是当前会话${scope === 'group' ? '群' : '对端'} ${session.channelId},命令里写的是 ${to};`
3898
- + `要联系其他对象请走 --thread 跨话题发送(ec thread list <对方AID> 选中话题后加 --check-every)。`;
3933
+ + `要联系其他对象请走 --thread 跨话题发送(先用 ec thread list <对方AID> 选话题,或直接写主话题 main:<本端AID>:<对方AID>)。`;
3899
3934
  }
3900
3935
  const payloadDiagnosis = diagnoseProactiveSendPayload(argv, scope, 5, { allowAttachment: true });
3901
3936
  if (payloadDiagnosis.ok)
@@ -3923,8 +3958,9 @@ function sendOptionValue(argv, flag) {
3923
3958
  /**
3924
3959
  * 带 `--thread` 的跨话题发送:目标由话题推断,不受「只能发给当前对端/群」限制。
3925
3960
  *
3926
- * 支持完整形式 `ec msg|group send <self> <target> ... --thread <id>`,以及私聊
3927
- * 简化形式 `ec msg send "<text>" --thread <id>`(目标取话题 peer)。
3961
+ * 入参是规范化后的 argv:`ecmsg send "<text>" --thread <id>` 归一为内部形态
3962
+ * `ec msg send "<text>" --thread <id>`(目标取话题 peer);带显式 self/target 的
3963
+ * 内部完整形式 `ec msg|group send <self> <target> ... --thread <id>` 同样支持。
3928
3964
  * `resolveThread` 必须校验话题存在于本端索引、scope 与话题类型一致,且给出
3929
3965
  * target 时与话题 peer 相同;这里只做语法与发送者校验。
3930
3966
  */
@@ -0,0 +1,234 @@
1
+ /**
2
+ * 托管会话内的受管本地文件:路径边界校验 + 安全读取。
3
+ *
4
+ * 为什么在 core 而不是 trigger:这套逻辑被消息发送、handoff、支付和 Trigger
5
+ * 共用,只有 Trigger 是它的首个使用方。放在 trigger 下会让其它调用方的报错
6
+ * 说成「Trigger input」,误导用户。
7
+ *
8
+ * 不同用途共享路径与句柄校验,只在允许的根目录、报错措辞和大小上限上有差异:
9
+ * - trigger Trigger 脚本/提示词,上限 4 MiB
10
+ * - message 发送链路的 --text-from-file / --payload-file,上限 1 MiB
11
+ * - attachment 附件源文件与支付图片,上限 4 MiB
12
+ * - credential 当前 Agent credentials/ 子树,上限 128 KiB,POSIX 要求私有权限
13
+ */
14
+ import fs from 'node:fs';
15
+ import path from 'node:path';
16
+ import { agentDir, resolveRoot } from '../../paths.js';
17
+ import { classifyProtectedPath, isSameOrDescendant } from './protected-paths.js';
18
+ /** Trigger 脚本与附件源文件的上限。 */
19
+ export const TRIGGER_LOCAL_FILE_LIMIT = 4 * 1024 * 1024;
20
+ /**
21
+ * 发送链路上限。
22
+ *
23
+ * 真正的硬限制在传输层:整条 JSON-RPC 信封超过 1,000,000 字节会被拒绝。
24
+ * 这里提前卡在 1 MiB,让用户在读文件阶段就拿到明确原因,而不是发送时才失败。
25
+ */
26
+ export const MESSAGE_LOCAL_FILE_LIMIT = 1024 * 1024;
27
+ /** 各用途的文件大小上限。 */
28
+ export function managedLocalFileLimit(kind) {
29
+ return kind === 'credential' ? 128 * 1024 : kind === 'message' ? MESSAGE_LOCAL_FILE_LIMIT : TRIGGER_LOCAL_FILE_LIMIT;
30
+ }
31
+ /** 报错时的主语,让用户能对上自己正在做的事。 */
32
+ function managedLocalFileLabel(kind) {
33
+ if (kind === 'trigger')
34
+ return 'Trigger input';
35
+ if (kind === 'message')
36
+ return 'Message file';
37
+ if (kind === 'credential')
38
+ return 'Agent credential file';
39
+ return 'Attachment source';
40
+ }
41
+ function formatMiB(bytes) {
42
+ return `${Math.round(bytes / (1024 * 1024))} MiB`;
43
+ }
44
+ export function resolveManagedLocalPath(input, scope, kind) {
45
+ const messages = managedLocalFileMessages(kind);
46
+ if (!input || /[\0\r\n]/.test(input) || hasUnsafeWindowsPathSyntax(input))
47
+ throw new Error(messages.invalidPath);
48
+ const normalizedInput = input.replace(/\\/g, '/');
49
+ if (normalizedInput.split('/').includes('..'))
50
+ throw new Error(messages.parentTraversal);
51
+ const lexical = path.resolve(scope?.cwd ?? process.cwd(), input);
52
+ if (!scope)
53
+ return fs.realpathSync.native(lexical);
54
+ const project = fs.realpathSync.native(scope.projectPath);
55
+ const runtime = scope.sessionRuntimeDir
56
+ ? fs.realpathSync.native(scope.sessionRuntimeDir)
57
+ : undefined;
58
+ const credentialRoot = kind === 'credential' ? path.join(agentDir(scope.selfAid), 'credentials') : undefined;
59
+ const inCredentialLexically = !!credentialRoot && isSameOrDescendant(lexical, credentialRoot);
60
+ if (credentialRoot) {
61
+ const agentRoot = path.dirname(credentialRoot);
62
+ const agentStat = fs.lstatSync(agentRoot);
63
+ if (!agentStat.isDirectory() || agentStat.isSymbolicLink())
64
+ throw new Error(messages.symbolicLink);
65
+ }
66
+ assertSessionRuntimeScope(lexical, runtime, messages.otherSessionTemp);
67
+ const inProjectLexically = isSameOrDescendant(lexical, project);
68
+ const inSessionTempLexically = !!runtime && isSameOrDescendant(lexical, runtime);
69
+ if (!inProjectLexically && !inSessionTempLexically && !inCredentialLexically) {
70
+ throw new Error(messages.outsideScope);
71
+ }
72
+ let current = lexical;
73
+ while (true) {
74
+ const stat = fs.lstatSync(current);
75
+ if (stat.isSymbolicLink()) {
76
+ throw new Error(messages.symbolicLink);
77
+ }
78
+ if (current === project || current === runtime || current === credentialRoot)
79
+ break;
80
+ const parent = path.dirname(current);
81
+ if (parent === current)
82
+ break;
83
+ current = parent;
84
+ }
85
+ const resolved = fs.realpathSync.native(lexical);
86
+ assertSessionRuntimeScope(resolved, runtime, messages.otherSessionTemp);
87
+ const inProject = isSameOrDescendant(lexical, project) && isSameOrDescendant(resolved, project);
88
+ const inSessionTemp = !!runtime
89
+ && isSameOrDescendant(lexical, runtime)
90
+ && isSameOrDescendant(resolved, runtime);
91
+ const inCredential = !!credentialRoot
92
+ && inCredentialLexically && isSameOrDescendant(resolved, credentialRoot);
93
+ if (!inProject && !inSessionTemp && !inCredential) {
94
+ throw new Error(messages.outsideScope);
95
+ }
96
+ const root = resolveRoot();
97
+ const lexicalClass = classifyProtectedPath(lexical, { root, selfAid: scope.selfAid });
98
+ const resolvedClass = classifyProtectedPath(resolved, { root, selfAid: scope.selfAid });
99
+ if (!inCredential && !scope.allowProtectedPaths
100
+ && (isProtectedManagedInputClass(lexicalClass) || isProtectedManagedInputClass(resolvedClass))) {
101
+ throw new Error(messages.protectedPath);
102
+ }
103
+ return resolved;
104
+ }
105
+ export function resolveTriggerLocalPath(input, scope) {
106
+ return resolveManagedLocalPath(input, scope, 'trigger');
107
+ }
108
+ export function resolveAttachmentLocalPath(input, scope) {
109
+ return resolveManagedLocalPath(input, scope, 'attachment');
110
+ }
111
+ /** 发送链路(--text-from-file / --payload-file)的路径校验。 */
112
+ export function resolveMessageLocalPath(input, scope) {
113
+ return resolveManagedLocalPath(input, scope, 'message');
114
+ }
115
+ function managedLocalFileMessages(kind) {
116
+ const label = managedLocalFileLabel(kind);
117
+ return {
118
+ invalidPath: `Invalid ${label.toLowerCase()} path`,
119
+ parentTraversal: `${label} path cannot traverse parent directories`,
120
+ outsideScope: kind === 'credential'
121
+ ? 'Agent credential file must be inside the current project, session TMPDIR, or current Agent credentials directory'
122
+ : `${label} must be inside the current project or session TMPDIR`,
123
+ symbolicLink: `${label} must not traverse a symbolic link or junction`,
124
+ protectedPath: `${label} references a protected path`,
125
+ otherSessionTemp: `${label} must not reference another session TMPDIR`,
126
+ };
127
+ }
128
+ function isProtectedManagedInputClass(value) {
129
+ return value === 'h-file' || value === 'h-directory' || value === 'l-path' || value === 'unknown';
130
+ }
131
+ function hasUnsafeWindowsPathSyntax(input) {
132
+ if (process.platform !== 'win32')
133
+ return false;
134
+ const normalized = input.replace(/\\/g, '/');
135
+ const withoutDrive = /^[A-Za-z]:\//.test(normalized) ? normalized.slice(2) : normalized;
136
+ return withoutDrive.includes(':') || withoutDrive.split('/').some(segment => (/[. ]$/.test(segment) && segment !== '.' && segment !== '..') || /^(?:con|prn|aux|nul|com[1-9]|lpt[1-9])(?:\.|$)/i.test(segment));
137
+ }
138
+ function assertSessionRuntimeScope(candidate, runtime, errorMessage) {
139
+ if (!runtime)
140
+ return;
141
+ const parent = path.dirname(runtime);
142
+ if (!isSameOrDescendant(candidate, parent))
143
+ return;
144
+ const firstSegment = path.relative(parent, candidate).split(path.sep)[0];
145
+ if (/^ec-session-[a-f0-9]{24}$/i.test(firstSegment)
146
+ && !isSameOrDescendant(candidate, runtime)) {
147
+ throw new Error(errorMessage);
148
+ }
149
+ }
150
+ function sameFileIdentity(left, right) {
151
+ return left.dev === right.dev && left.ino === right.ino;
152
+ }
153
+ function sameFileMetadata(left, right) {
154
+ return left.size === right.size && left.mtimeMs === right.mtimeMs && left.ctimeMs === right.ctimeMs;
155
+ }
156
+ export function readManagedLocalFile(input, scope, kind) {
157
+ const sourceLabel = managedLocalFileLabel(kind);
158
+ const limit = managedLocalFileLimit(kind);
159
+ const resolved = resolveManagedLocalPath(input, scope, kind);
160
+ const expected = fs.lstatSync(resolved);
161
+ if (!expected.isFile())
162
+ throw new Error(`${sourceLabel} must be a regular file`);
163
+ if (scope && expected.nlink !== 1)
164
+ throw new Error(`${sourceLabel} must not be hard-linked`);
165
+ const noFollow = fs.constants.O_NOFOLLOW ?? 0;
166
+ const descriptor = fs.openSync(resolved, fs.constants.O_RDONLY | noFollow);
167
+ try {
168
+ const opened = fs.fstatSync(descriptor);
169
+ const openedPath = fs.lstatSync(resolved);
170
+ // Windows path and handle stats can report different dev/ino values for the
171
+ // same file. Compare identities within each API and metadata across APIs;
172
+ // retain the additional path-to-handle identity check on POSIX.
173
+ if (!opened.isFile() || !openedPath.isFile() || openedPath.isSymbolicLink()
174
+ || !sameFileIdentity(openedPath, expected) || !sameFileMetadata(openedPath, expected)
175
+ || (process.platform !== 'win32' && !sameFileIdentity(opened, expected))
176
+ || !sameFileMetadata(opened, expected)
177
+ || (scope && (opened.nlink !== 1 || openedPath.nlink !== 1))
178
+ || resolveManagedLocalPath(input, scope, kind) !== resolved) {
179
+ throw new Error(`${sourceLabel} changed during validation`);
180
+ }
181
+ if (kind === 'credential' && process.platform !== 'win32' && (opened.mode & 0o077) !== 0) {
182
+ throw new Error('Agent credential file must be private (mode 0600)');
183
+ }
184
+ if (opened.size > limit) {
185
+ throw new Error(`${sourceLabel} exceeds the ${formatMiB(limit)} limit`);
186
+ }
187
+ const buffer = Buffer.alloc(Math.min(opened.size + 1, limit + 1));
188
+ let length = 0;
189
+ while (length < buffer.length) {
190
+ const count = fs.readSync(descriptor, buffer, length, buffer.length - length, length);
191
+ if (!count)
192
+ break;
193
+ length += count;
194
+ }
195
+ const afterRead = fs.fstatSync(descriptor);
196
+ const afterPath = fs.lstatSync(resolved);
197
+ if (length !== opened.size || !afterRead.isFile()
198
+ || !sameFileIdentity(afterRead, opened) || !sameFileMetadata(afterRead, opened)
199
+ || !sameFileIdentity(afterPath, expected)
200
+ || !afterPath.isFile() || afterPath.isSymbolicLink() || !sameFileMetadata(afterPath, opened)
201
+ || (scope && (afterRead.nlink !== 1 || afterPath.nlink !== 1))
202
+ || resolveManagedLocalPath(input, scope, kind) !== resolved) {
203
+ throw new Error(`${sourceLabel} changed during reading`);
204
+ }
205
+ return buffer.subarray(0, length);
206
+ }
207
+ finally {
208
+ fs.closeSync(descriptor);
209
+ }
210
+ }
211
+ export function readTriggerLocalFile(input, scope) {
212
+ return readManagedLocalFile(input, scope, 'trigger');
213
+ }
214
+ /** 发送链路的文件读取:与 trigger 共用实现,但报错主语和上限不同。 */
215
+ export function readMessageLocalFile(input, scope) {
216
+ return readManagedLocalFile(input, scope, 'message');
217
+ }
218
+ /** 校验 base64 直传的 Trigger 脚本内容。 */
219
+ export function decodeManagedBase64File(contentBase64, label, limit) {
220
+ const maxBase64Length = 4 * Math.ceil(limit / 3);
221
+ if (typeof contentBase64 !== 'string'
222
+ || contentBase64.length > maxBase64Length
223
+ || contentBase64.length % 4 !== 0 || !/^[A-Za-z0-9+/]*={0,2}$/.test(contentBase64)) {
224
+ throw new Error(`${label} must be canonical base64 under ${formatMiB(limit)}`);
225
+ }
226
+ const contents = Buffer.from(contentBase64, 'base64');
227
+ if (contents.length > limit || contents.toString('base64') !== contentBase64) {
228
+ throw new Error(`${label} must be canonical base64 under ${formatMiB(limit)}`);
229
+ }
230
+ return contents;
231
+ }
232
+ export function decodeTriggerScriptFile(contentBase64) {
233
+ return decodeManagedBase64File(contentBase64, 'Trigger file content', TRIGGER_LOCAL_FILE_LIMIT);
234
+ }
@@ -457,6 +457,43 @@ export function getLClassWritePatterns(root = resolveRoot()) {
457
457
  path.join(absoluteRoot, 'agents', '*', 'roles') + '/**',
458
458
  ];
459
459
  }
460
+ export function getExistingCodexProjectSkillRoots(projectPath) {
461
+ const project = path.resolve(projectPath);
462
+ let repositoryRoot;
463
+ let cursor = project;
464
+ while (true) {
465
+ if (fs.existsSync(path.join(cursor, '.git'))) {
466
+ repositoryRoot = cursor;
467
+ break;
468
+ }
469
+ const parent = path.dirname(cursor);
470
+ if (parent === cursor)
471
+ break;
472
+ cursor = parent;
473
+ }
474
+ // Codex falls back to cwd when there is no repository marker.
475
+ repositoryRoot ??= project;
476
+ const candidates = new Set([
477
+ path.join(project, '.codex', 'skills'),
478
+ path.join(repositoryRoot, '.codex', 'skills'),
479
+ ]);
480
+ for (cursor = project;; cursor = path.dirname(cursor)) {
481
+ candidates.add(path.join(cursor, '.agents', 'skills'));
482
+ if (cursor === repositoryRoot)
483
+ break;
484
+ }
485
+ const canonicalRoot = resolveThroughExistingAncestor(repositoryRoot);
486
+ return [...candidates].filter(target => {
487
+ try {
488
+ const expected = path.resolve(canonicalRoot, path.relative(repositoryRoot, target));
489
+ return fs.statSync(target).isDirectory()
490
+ && normalizeForComparison(fs.realpathSync(target)) === normalizeForComparison(expected);
491
+ }
492
+ catch {
493
+ return false;
494
+ }
495
+ });
496
+ }
460
497
  const CLAUDE_PROTECTED_TARGET_LIMIT = 8192;
461
498
  const CLAUDE_GLOB_MAGIC = /[*?[\]]/;
462
499
  const CODEX_GLOB_MAGIC = /[*?[\]]/;
@@ -721,6 +758,24 @@ export function getExistingAgentAttachmentDirs(root = resolveRoot(), options = {
721
758
  catch { }
722
759
  return [...targets];
723
760
  }
761
+ export function getExistingSelfAttachmentDirs(root = resolveRoot(), options = {}) {
762
+ const selfAid = normalizeAid(options.selfAid);
763
+ if (!selfAid)
764
+ return [];
765
+ const directories = [
766
+ ...getExistingAgentAttachmentDirs(root, { selfAid }),
767
+ ...getExistingRelationAttachmentDirs(root, { selfAid }),
768
+ ];
769
+ return [...new Set(directories)].filter(directory => {
770
+ try {
771
+ return !fs.lstatSync(directory).isSymbolicLink()
772
+ && normalizeForComparison(fs.realpathSync(directory)) === normalizeForComparison(directory);
773
+ }
774
+ catch {
775
+ return false;
776
+ }
777
+ });
778
+ }
724
779
  export function buildClaudeProtectedFilesystem(root = resolveRoot(), options = {}) {
725
780
  const hClassPaths = [
726
781
  ...getExistingHClassMaskTargets(root, options).map(target => target.path),
@@ -1002,6 +1057,7 @@ export function buildCodexProtectedFilesystemRules(root = resolveRoot(), options
1002
1057
  const filesystem = compactWindowsCodexFilesystemRules({
1003
1058
  ...buildCodexHClassFilesystemRules(root, hClassOptions),
1004
1059
  ...lClassRules,
1060
+ ...Object.fromEntries(getExistingSelfAttachmentDirs(root, options).map(directory => [directory, 'read'])),
1005
1061
  }, platform);
1006
1062
  if (platform === 'linux' && options.outerHClassGuard) {
1007
1063
  const dataDirectory = path.join(resolveThroughExistingAncestor(root), 'data');