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
@@ -0,0 +1,134 @@
1
+ import fs from 'fs';
2
+ import path from 'path';
3
+ import { visitSessionHistory } from '../../core/session/session-fs-store.js';
4
+ import { agentSessionsDir } from '../../paths.js';
5
+ function projectDirectory(projectPath, agentAid) {
6
+ if (!agentAid?.trim())
7
+ return null;
8
+ const encoded = path.resolve(projectPath).replace(/^[/\\]/, '').replace(/[/\\:]/g, '-');
9
+ return path.join(agentSessionsDir(agentAid.trim()), `--${encoded}--`);
10
+ }
11
+ function messageText(content) {
12
+ if (typeof content === 'string')
13
+ return content;
14
+ if (!Array.isArray(content))
15
+ return '';
16
+ return content
17
+ .filter((block) => block?.type === 'text' && typeof block.text === 'string')
18
+ .map(block => block.text)
19
+ .join('\n');
20
+ }
21
+ function preview(text) {
22
+ const normalized = text.trim().replace(/\s+/g, ' ');
23
+ if (!normalized)
24
+ return null;
25
+ return normalized.length > 50 ? `${normalized.slice(0, 50)}...` : normalized;
26
+ }
27
+ export class EcagentSessionFileAdapter {
28
+ baseagent = 'ecagent';
29
+ findSessionFile(projectPath, agentSessionId, agentAid) {
30
+ const dir = projectDirectory(projectPath, agentAid);
31
+ if (!dir)
32
+ return null;
33
+ try {
34
+ const file = fs.readdirSync(dir).find(name => name.endsWith(`_${agentSessionId}.jsonl`));
35
+ return file ? path.join(dir, file) : null;
36
+ }
37
+ catch {
38
+ return null;
39
+ }
40
+ }
41
+ readEntries(projectPath, agentSessionId, agentAid) {
42
+ const file = this.findSessionFile(projectPath, agentSessionId, agentAid);
43
+ if (!file)
44
+ return [];
45
+ try {
46
+ return fs.readFileSync(file, 'utf8').split('\n').slice(1).flatMap(line => {
47
+ if (!line.trim())
48
+ return [];
49
+ try {
50
+ return [JSON.parse(line)];
51
+ }
52
+ catch {
53
+ return [];
54
+ }
55
+ });
56
+ }
57
+ catch {
58
+ return [];
59
+ }
60
+ }
61
+ checkExists(projectPath, agentSessionId, agentAid) {
62
+ return this.findSessionFile(projectPath, agentSessionId, agentAid) !== null;
63
+ }
64
+ getFileInfo(projectPath, agentSessionId, agentAid) {
65
+ const entries = this.readEntries(projectPath, agentSessionId, agentAid);
66
+ const userMessages = entries.filter(entry => entry.type === 'message' && entry.message?.role === 'user');
67
+ const names = entries.filter(entry => entry.type === 'session_info' && typeof entry.name === 'string');
68
+ const title = names.at(-1)?.name?.trim() || preview(messageText(userMessages[0]?.message?.content));
69
+ return { turns: userMessages.length, title: title || undefined };
70
+ }
71
+ readFirstMessage(projectPath, agentSessionId, agentAid) {
72
+ const entry = this.readEntries(projectPath, agentSessionId, agentAid)
73
+ .find(item => item.type === 'message' && item.message?.role === 'user');
74
+ return preview(messageText(entry?.message?.content));
75
+ }
76
+ async readMenuSummary(projectPath, agentSessionId, agentAid) {
77
+ let turns = 0;
78
+ let firstMessage = null;
79
+ const dir = projectDirectory(projectPath, agentAid);
80
+ if (!dir)
81
+ return { turns, firstMessage };
82
+ try {
83
+ const name = (await fs.promises.readdir(dir)).find(name => name.endsWith(`_${agentSessionId}.jsonl`));
84
+ if (name)
85
+ await visitSessionHistory(path.join(dir, name), (entry, line) => {
86
+ if (line === 0 || entry?.type !== 'message' || entry.message?.role !== 'user')
87
+ return;
88
+ if (turns++ === 0)
89
+ firstMessage = preview(messageText(entry.message.content));
90
+ });
91
+ return { turns, firstMessage };
92
+ }
93
+ catch {
94
+ return { turns: 0, firstMessage: null };
95
+ }
96
+ }
97
+ readLastUserMessage(projectPath, agentSessionId, agentAid) {
98
+ const entries = this.readEntries(projectPath, agentSessionId, agentAid)
99
+ .filter(item => item.type === 'message' && item.message?.role === 'user');
100
+ return preview(messageText(entries.at(-1)?.message?.content));
101
+ }
102
+ scanCliSessions(projectPath, _limit = 10, agentAid) {
103
+ const dir = projectDirectory(projectPath, agentAid);
104
+ if (!dir)
105
+ return [];
106
+ try {
107
+ return fs.readdirSync(dir)
108
+ .filter(name => name.endsWith('.jsonl'))
109
+ .flatMap(name => {
110
+ const file = path.join(dir, name);
111
+ try {
112
+ const header = JSON.parse(fs.readFileSync(file, 'utf8').split('\n', 1)[0] || '{}');
113
+ if (header.type !== 'session' || typeof header.id !== 'string')
114
+ return [];
115
+ return [{ uuid: header.id, mtime: fs.statSync(file).mtimeMs }];
116
+ }
117
+ catch {
118
+ return [];
119
+ }
120
+ })
121
+ .sort((a, b) => b.mtime - a.mtime)
122
+ .slice(0, _limit);
123
+ }
124
+ catch {
125
+ return [];
126
+ }
127
+ }
128
+ async listSdkSessions(projectPath, agentAid) {
129
+ return this.scanCliSessions(projectPath, 10, agentAid).map(entry => ({
130
+ sessionId: entry.uuid,
131
+ title: this.getFileInfo(projectPath, entry.uuid, agentAid).title,
132
+ }));
133
+ }
134
+ }
@@ -1,12 +1,14 @@
1
+ /** Gemini's package-owned entrypoint; legacy headless limitations remain explicit. */
2
+ import { baseagentCapabilityLevel } from '../../core/baseagent/baseagent-plugin-descriptor.js';
1
3
  import { loadSchema } from '../../config/schema-registry.js';
2
- import { commandExists } from '../../utils/cross-platform.js';
3
- import { GeminiAgentPlugin } from './gemini-runner.js';
4
- import { GeminiSessionFileAdapter } from './gemini-session-file-adapter.js';
5
- import { GeminiCapabilityProvider } from './gemini-capability-provider.js';
4
+ import { commandExists, commandExistsAsync } from '../../utils/cross-platform.js';
5
+ import { resolveProviderService } from '../../config/providers.js';
6
6
  function card(id, implementation, availability, notes) {
7
- return { id, level: id[0], implementation, availability, verification: 'verified', notes };
7
+ return { id, level: baseagentCapabilityLevel(id), implementation, availability, verification: 'verified', notes };
8
8
  }
9
9
  export default {
10
+ kind: 'baseagent', apiVersion: 1, version: '1.0.0', hostApi: '^1.0.0',
11
+ executionContract: 'host-runner-1',
10
12
  name: 'gemini',
11
13
  displayName: 'Gemini CLI',
12
14
  aliases: ['gemini', 'gemini-cli', 'gemini cli', 'geminicli', 'google', 'google-ai'],
@@ -21,8 +23,8 @@ export default {
21
23
  at: '2026-11-16T20:36:31Z',
22
24
  },
23
25
  }],
24
- // These IDs retain the meanings in baseagent-plugin-capabilities.md. A known
25
- // limitation is not a claim of v1 conformance or a reason to loosen Host policy.
26
+ // Retained negative B evidence blocks strict admission; explicit deployment
27
+ // force keeps these gaps visible as warnings without claiming support.
26
28
  declaredCapabilities: [
27
29
  card('B01', 'adapted', 'available', 'Descriptor and configuration boundary regression tests'),
28
30
  card('B02', 'host-only', 'available', 'Side-effect-free executable detection; missing CLI stays unavailable'),
@@ -45,7 +47,50 @@ export default {
45
47
  card('C17', 'unsupported', 'unavailable', 'Native tools are not entirely executed by the Host broker'),
46
48
  card('C26', 'adapted', 'available', 'Images are passed as temporary @file attachments'),
47
49
  ],
48
- createRunner: () => new GeminiAgentPlugin(),
49
- createSessionAdapter: () => new GeminiSessionFileAdapter(),
50
- createCapabilityProvider: () => new GeminiCapabilityProvider(),
50
+ load: async () => {
51
+ const [{ GeminiRunner }, { GeminiSessionFileAdapter }, { GeminiCapabilityProvider }] = await Promise.all([
52
+ import('./runner.js'), import('./session-file-adapter.js'), import('./capability-provider.js'),
53
+ ]);
54
+ return {
55
+ createAgent: context => new GeminiRunner({ agents: { gemini: context.config } }, { onSessionIdUpdate: context.onSessionIdUpdate }, { agentAid: context.aid }),
56
+ createSessionAdapter: () => new GeminiSessionFileAdapter(),
57
+ createCapabilityProvider: () => new GeminiCapabilityProvider(),
58
+ };
59
+ },
51
60
  };
61
+ export const DEFAULT_GEMINI_MODEL = 'gemini-2.5-flash';
62
+ export function isGeminiCliAvailable() {
63
+ return commandExists('gemini');
64
+ }
65
+ export function isGeminiCliAvailableAsync() {
66
+ return commandExistsAsync('gemini');
67
+ }
68
+ export function resolveGoogleConfig(config, override) {
69
+ const googleCfg = config.agents?.gemini;
70
+ const isPlaceholder = (v) => !v || v.includes('your-') || v.includes('placeholder');
71
+ let cliPath = override?.cliPath || googleCfg?.cliPath || '';
72
+ if (!cliPath) {
73
+ cliPath = isGeminiCliAvailable() ? 'gemini' : '';
74
+ }
75
+ const model = override?.model || googleCfg?.model || DEFAULT_GEMINI_MODEL;
76
+ const providerId = override?.provider ?? googleCfg?.provider;
77
+ if (providerId !== undefined) {
78
+ const provider = resolveProviderService(providerId, 'gemini');
79
+ if (!provider.apiKey)
80
+ throw new Error(`Provider ${providerId} has no API key`);
81
+ if (provider.queryParams && Object.keys(provider.queryParams).length > 0) {
82
+ throw new Error(`Provider ${providerId} gemini service queryParams are unsupported by the Gemini CLI runtime`);
83
+ }
84
+ return { cliPath, model, apiKey: provider.apiKey, providerId, baseUrl: provider.baseUrl, headers: provider.headers,
85
+ queryParams: provider.queryParams };
86
+ }
87
+ const overrideApiKey = isPlaceholder(override?.apiKey) ? undefined : override?.apiKey;
88
+ const apiKey = overrideApiKey
89
+ || process.env.GEMINI_API_KEY
90
+ || process.env.GOOGLE_API_KEY
91
+ || undefined;
92
+ return { cliPath, model, apiKey };
93
+ }
94
+ export function resolveGeminiConnectionForRepair(override) {
95
+ return { ...resolveGoogleConfig({ agents: {} }, override), baseUrl: process.env.GOOGLE_GEMINI_BASE_URL };
96
+ }
@@ -18,11 +18,11 @@ import fs from 'fs';
18
18
  import path from 'path';
19
19
  import os from 'os';
20
20
  import crypto from 'crypto';
21
- import { hasTrustedFullAccessContext } from '../runner-types.js';
22
- import { resolveGoogleConfig } from '../baseagent.js';
21
+ import { hasTrustedFullAccessContext } from '../../core/baseagent/runner-types.js';
22
+ import { resolveGoogleConfig } from './index.js';
23
23
  import { resolveEffective } from '../../config/config-manager.js';
24
24
  import { commandExists } from '../../utils/cross-platform.js';
25
- import { GeminiSessionFileAdapter } from './gemini-session-file-adapter.js';
25
+ import { GeminiSessionFileAdapter } from './session-file-adapter.js';
26
26
  import { logger } from '../../utils/logger.js';
27
27
  import { normalizeExecutionPermissionMode, normalizePermissionMode } from '../../core/permission/mode.js';
28
28
  import { resolveRoot } from '../../paths.js';
@@ -320,7 +320,7 @@ export function hasStandardGeminiAdminPolicy() {
320
320
  // ── Gemini Runner ──
321
321
  export class GeminiRunner {
322
322
  name = 'gemini';
323
- capabilities = { fullaccess: true, clear: true, compact: false, fork: false, forkAtTurn: false, askUserQuestion: false, planApproval: false, fileRewind: 'unsupported' };
323
+ capabilities = { fullaccess: true, compact: false, fork: false, forkAtTurn: false, askUserQuestion: false, planApproval: false, fileRewind: 'unsupported' };
324
324
  resolved;
325
325
  config;
326
326
  agentAid;
@@ -945,11 +945,6 @@ export class GeminiRunner {
945
945
  const adapter = new GeminiSessionFileAdapter();
946
946
  return adapter.findSessionFile(projectPath, agentSessionId);
947
947
  }
948
- async clearSession(sessionId, _agentSessionId, _projectPath) {
949
- // Clear = don't pass -r next time → fresh session
950
- this.activeSessions.delete(sessionId);
951
- return true;
952
- }
953
948
  async compactSession(_sessionId, _agentSessionId, _projectPath, _modelOverride) {
954
949
  logger.info('[GeminiRunner] Compact not supported, Gemini CLI handles context internally');
955
950
  return { ok: false, code: 'unsupported', message: 'Gemini CLI handles context internally', durationMs: 0 };
@@ -1,37 +1,31 @@
1
- /** This read-only business query collects responses from every online device. */
2
- export function isAidWideDeviceStatusQuery(payload) {
1
+ /** Only device discovery collects replies for an explicit window. */
2
+ export function isAbilityDiscoveryQuery(payload) {
3
+ return payload?.type === 'ability' && payload.role === 'call'
4
+ && payload.ability_path === 'protocol/discover';
5
+ }
6
+ function isDeviceStatusRead(payload) {
3
7
  const params = payload?.params;
4
8
  return payload?.type === 'ability' && payload.role === 'call'
5
9
  && payload.ability_path === 'device/status'
6
10
  && !!params && typeof params === 'object' && !Array.isArray(params)
7
11
  && params.action === 'read';
8
12
  }
9
- /** Discovery and status reads collect results across the Provider's devices. */
10
- export function isAidWideAbilityQuery(payload) {
11
- return (payload?.type === 'ability' && payload.role === 'call'
12
- && payload.ability_path === 'protocol/discover') || isAidWideDeviceStatusQuery(payload);
13
- }
14
13
  /** Device routing belongs to message.send, never to the Ability payload. */
15
14
  export function resolveAunSendDevice(deviceId, scope, payload) {
16
15
  if (deviceId !== undefined && (scope !== 'msg' || typeof deviceId !== 'string'
17
16
  || !deviceId || deviceId.length > 256 || /[\s\x00-\x1f\x7f]/.test(deviceId))) {
18
17
  throw Object.assign(new Error('--device-id requires a nonempty private target device ID'), { code: 'INVALID_DEVICE_ID' });
19
18
  }
20
- if (payload?.type === 'ability' && payload.role === 'call' && payload.ability_path === 'protocol/discover') {
19
+ if (isAbilityDiscoveryQuery(payload)) {
21
20
  if (scope !== 'msg' || deviceId !== undefined) {
22
21
  throw Object.assign(new Error('protocol/discover collects the Provider AID devices; omit --device-id and use a private AID target'), { code: 'ABILITY_DEVICE_NOT_ALLOWED' });
23
22
  }
24
23
  return undefined;
25
24
  }
26
- if (isAidWideDeviceStatusQuery(payload)) {
27
- if (scope !== 'msg' || deviceId !== undefined) {
28
- throw Object.assign(new Error('device/status queries the AID online devices; omit --device-id and use a private AID target'), { code: 'ABILITY_DEVICE_NOT_ALLOWED' });
29
- }
30
- return undefined;
31
- }
32
- if (payload?.type === 'ability' && payload.role === 'call'
33
- && payload.ability_path !== 'protocol/discover' && !deviceId) {
34
- throw Object.assign(new Error('Select a device from the Provider ability index and pass --device-id; business Ability calls cannot broadcast to every device'), { code: 'ABILITY_DEVICE_REQUIRED' });
25
+ if (scope !== 'msg' && isDeviceStatusRead(payload)) {
26
+ throw Object.assign(new Error('device/status requires a private AID target'), { code: 'ABILITY_DEVICE_NOT_ALLOWED' });
35
27
  }
28
+ // No device_id is a valid request: the Provider routes it to whichever of
29
+ // its devices are online. The first valid terminal reply finishes the call.
36
30
  return deviceId;
37
31
  }
@@ -1,11 +1,20 @@
1
1
  import crypto from 'crypto';
2
2
  import fs from 'fs';
3
3
  import path from 'path';
4
- import { parseDocument } from 'yaml';
4
+ import { isMap, parseDocument } from 'yaml';
5
5
  import { validateAgentMdDocument } from '@agentunion/fastaun';
6
6
  import { getAidStore, loadAid, SLOT } from './store.js';
7
7
  import { isValidAid } from './identity.js';
8
8
  import { agentMdPath, aidLocalDir, resolveRoot } from '../../paths.js';
9
+ export const AGENTMD_EDITABLE_FIELDS = ['name', 'type', 'description', 'version', 'tags', 'exttype', 'visibility'];
10
+ export function isAgentMdEditableField(value) {
11
+ return AGENTMD_EDITABLE_FIELDS.some(field => field === value);
12
+ }
13
+ export const AGENTMD_VISIBILITIES = ['public', 'unlisted', 'private'];
14
+ export const AGENTMD_VISIBILITY_ERROR = `visibility must be one of ${AGENTMD_VISIBILITIES.join(', ')}`;
15
+ export function isAgentMdVisibility(value) {
16
+ return AGENTMD_VISIBILITIES.some(visibility => visibility === value);
17
+ }
9
18
  export const DEFAULT_AGENT_DESCRIPTION = 'EvolCore AI agent.';
10
19
  /**
11
20
  * AUN 主体类型已知预设值列表。`type` 是可扩展字符串,协议允许应用自定义值;
@@ -638,6 +647,23 @@ export function updateAgentMdFrontmatterFieldValue(content, field, value) {
638
647
  }
639
648
  if (typeof value !== 'string')
640
649
  throw new Error(`agent.md ${field} must be a string`);
650
+ if (field === 'visibility') {
651
+ if (!isAgentMdVisibility(value)) {
652
+ throw Object.assign(new Error(AGENTMD_VISIBILITY_ERROR), { code: 'INVALID_ARGUMENT' });
653
+ }
654
+ const payload = stripAgentMdSignature(content);
655
+ const match = payload.match(/^---(\r?\n)([\s\S]*?)\r?\n---(?:\r?\n|$)/);
656
+ if (!match)
657
+ throw new Error('agent.md has no YAML frontmatter');
658
+ const document = parseDocument(match[2]);
659
+ if (document.errors.length || !isMap(document.contents)) {
660
+ throw new Error('agent.md frontmatter must be a valid YAML mapping');
661
+ }
662
+ const eol = match[1];
663
+ document.set(field, document.createNode(value));
664
+ const updated = `---${eol}${document.toString({ lineWidth: 0 }).replace(/\n/g, eol)}---${eol}${payload.slice(match[0].length)}`;
665
+ return { content: updated, changed: updated !== content };
666
+ }
641
667
  const normalized = value.trim();
642
668
  if (field === 'name' && !normalized)
643
669
  throw new Error('agent.md name must be a non-empty string');
@@ -1,7 +1,7 @@
1
1
  import fs from 'fs';
2
2
  import path from 'path';
3
3
  import { resolveRoot } from '../../paths.js';
4
- import { agentmdGet, agentmdPut, agentmdSet, } from './agentmd.js';
4
+ import { agentmdGet, agentmdPut, agentmdSet, AGENTMD_EDITABLE_FIELDS, AGENTMD_VISIBILITY_ERROR, isAgentMdEditableField, isAgentMdVisibility } from './agentmd.js';
5
5
  import { uploadAvatarBuffer, uploadAvatarUrl } from '../../utils/avatar-upload.js';
6
6
  import { aidList, aidListVerified, aidLookup, aidShow } from './identity.js';
7
7
  import { isValidAid } from './validation.js';
@@ -101,14 +101,13 @@ function parseAvatar(args) {
101
101
  },
102
102
  };
103
103
  }
104
- const AGENTMD_EDITABLE_FIELDS = new Set(['name', 'type', 'description', 'version', 'tags', 'exttype']);
105
104
  function parseAgentmdSet(args) {
106
105
  const aidResult = parseAid(args[2]);
107
106
  if (!aidResult.ok)
108
107
  return aidResult;
109
108
  const field = args[3];
110
- if (!field || !AGENTMD_EDITABLE_FIELDS.has(field)) {
111
- return { ok: false, code: 'INVALID_ARGUMENT', reason: `agentmd set field must be one of ${[...AGENTMD_EDITABLE_FIELDS].join(', ')}` };
109
+ if (!isAgentMdEditableField(field)) {
110
+ return { ok: false, code: 'INVALID_ARGUMENT', reason: `agentmd set field must be one of ${AGENTMD_EDITABLE_FIELDS.join(', ')}` };
112
111
  }
113
112
  if (args[4] === undefined)
114
113
  return { ok: false, code: 'INVALID_ARGUMENT', reason: 'agentmd set requires a value' };
@@ -116,6 +115,9 @@ function parseAgentmdSet(args) {
116
115
  return { ok: false, code: 'NOT_ALLOWED', reason: 'agentmd set only supports an optional --format json suffix' };
117
116
  }
118
117
  let value = args[4];
118
+ if (field === 'visibility' && !isAgentMdVisibility(value)) {
119
+ return { ok: false, code: 'INVALID_ARGUMENT', reason: AGENTMD_VISIBILITY_ERROR };
120
+ }
119
121
  if (field === 'tags') {
120
122
  try {
121
123
  const parsed = JSON.parse(args[4]);
@@ -8,7 +8,7 @@ import { read, ConfigTarget } from '../../config/config-manager.js';
8
8
  import { resolveAgentLifecycle } from '../../config/lifecycle.js';
9
9
  import { logger } from '../../utils/logger.js';
10
10
  import { buildEnvelope, sendInteractionPayload, withEnvelopeReplyContext } from '../../core/message/message-utils.js';
11
- import { renderActionAsText } from '../../core/interaction-router.js';
11
+ import { renderActionAsText } from '../../core/message/interaction-router.js';
12
12
  export const OPEN_INVITE_STATES = ['pending', 'processing', 'reconciling'];
13
13
  export function recordValue(value) {
14
14
  return !!value && typeof value === 'object' && !Array.isArray(value);
@@ -95,7 +95,7 @@ export class ManagedMenuClient {
95
95
  throw new MenuClientError('INVALID_ARGUMENT', 'timeout must be between 1s and 120s');
96
96
  const jobRequest = request.type === 'menu.action' && (request.action === 'upgrade' && request.args?.mode === 'update'
97
97
  || (request.name === 'template' || request.cmd === '/template')
98
- && ['inspect', 'build', 'push', 'pull', 'preview', 'deploy', 'resume', 'cancel'].includes(String(request.action)));
98
+ && ['inspect', 'collect', 'pack', 'push', 'pull', 'preview', 'deploy', 'resume', 'cancel'].includes(String(request.action)));
99
99
  if (options.waitForCompletion && !jobRequest) {
100
100
  throw new MenuClientError('INVALID_ARGUMENT', '--wait requires an upgrade or template job action');
101
101
  }
@@ -2,7 +2,7 @@ import path from 'path';
2
2
  import { isValidAid } from '../aid/identity.js';
3
3
  import { isTransientProtocolMessage, messageLogPath } from '../../core/message/message-log.js';
4
4
  import { chatDirPath, readAllJsonlLines, readJsonFile, readLastJsonlLine, scanChatDirs, scanMetaFiles } from '../../core/session/session-fs-store.js';
5
- import { tryParseChannelKey } from '../../core/channel-loader.js';
5
+ import { tryParseChannelKey } from '../../core/channel/channel-loader.js';
6
6
  import { resolvePaths } from '../../paths.js';
7
7
  import { isMainSessionThreadId } from '../../core/thread/topic-id.js';
8
8
  const DEFAULT_LIMIT = 50;
@@ -6,7 +6,8 @@ import { msgOnline } from './p2p.js';
6
6
  import { resolveRoot } from '../../paths.js';
7
7
  import { normalizeGroupAid } from '../group/identity.js';
8
8
  import { isValidAid } from '../aid/validation.js';
9
- import { tryParseChannelKey } from '../../core/channel-loader.js';
9
+ import { executeStorageAcl, parseStorageAcl } from '../storage/index.js';
10
+ import { tryParseChannelKey } from '../../core/channel/channel-loader.js';
10
11
  import { normalizeThreadOptionValue } from '../../core/thread/topic-id.js';
11
12
  import { parseTimeArg, TIME_ARG_FORMATS } from '../../cli/cli-argv.js';
12
13
  import { DEFAULT_FS_CAT_BYTES, MAX_FS_CAT_BYTES, FsReadBudgetError, downloadGroupFsBytes, readPersonalFsBytesWithinBudget, readAuthoritativePersonalFsObject, AuthoritativeFsReadError, } from '../group/fs-download.js';
@@ -803,7 +804,7 @@ export class ManagedFsOperationError extends Error {
803
804
  }
804
805
  const FS_VALUE_FLAGS = new Set([
805
806
  '--as', '--format', '--max-bytes', '--head-bytes', '--name', '--pattern', '--type', '--node-type',
806
- '--size', '--mtime', '--page', '--page-size', '-m', '-x', '--expires',
807
+ '--size', '--mtime', '--page', '--page-size', '-m', '-x', '--expires', '--max-uses',
807
808
  ]);
808
809
  const FS_BOOLEAN_FLAGS = new Set(['-p', '--parents', '-r', '--recursive', '-f', '--force', '--overwrite', '--authoritative']);
809
810
  function failFs(code, reason) {
@@ -865,12 +866,27 @@ function parseRemote(value, allowEmpty) {
865
866
  }
866
867
  return { targetAid, remotePath };
867
868
  }
869
+ /** 托管会话放行的 fs 子命令。 */
870
+ const MANAGED_FS_COMMANDS = ['ls', 'stat', 'lstat', 'cat', 'find', 'df', 'getfacl', 'setfacl', 'mkdir', 'cp', 'mv', 'rm', 'link'];
871
+ /** 只在宿主终端可用;被拒时给出替代路径,否则调用方只能靠猜。 */
872
+ const HOST_ONLY_FS_GUIDANCE = {
873
+ ln: '托管会话不创建软链',
874
+ chmod: '公开文件请在上传时加 --public,或用 ec fs link 生成下载直链;群权限用 setfacl',
875
+ token: '托管会话用 ec fs link 生成带有效期的下载直链',
876
+ mount: '挂载只能在宿主终端执行',
877
+ approve: '挂载审批只能在宿主终端执行',
878
+ reject: '挂载审批只能在宿主终端执行',
879
+ umount: '卸载只能在宿主终端执行',
880
+ unmount: '卸载只能在宿主终端执行',
881
+ };
868
882
  /** Parse the daemon-owned managed filesystem grammar; the daemon resolves the permitted target backend. */
869
883
  export function resolveManagedFsOperation(argv) {
870
884
  const raw = argv[0] === 'fs' ? argv.slice(1) : argv;
871
885
  const rawKind = raw[0];
872
- if (!rawKind || !['ls', 'stat', 'lstat', 'cat', 'find', 'df', 'getfacl', 'setfacl', 'mkdir', 'cp', 'mv', 'rm', 'link'].includes(rawKind)) {
873
- return failFs('NOT_ALLOWED', `unsupported managed fs command: ${rawKind || '<missing>'}`);
886
+ if (!rawKind || !MANAGED_FS_COMMANDS.includes(rawKind)) {
887
+ const guidance = rawKind ? HOST_ONLY_FS_GUIDANCE[rawKind] : undefined;
888
+ return failFs('NOT_ALLOWED', `unsupported managed fs command: ${rawKind || '<missing>'}。托管会话可用: ${MANAGED_FS_COMMANDS.join(' ')}`
889
+ + (guidance ? `;${guidance}` : ''));
874
890
  }
875
891
  const values = new Map();
876
892
  const booleanFlags = new Set();
@@ -922,7 +938,7 @@ export function resolveManagedFsOperation(argv) {
922
938
  find: new Set(['--as', '--format', '--name', '--pattern', '--type', '--node-type', '--size', '--mtime', '--page', '--page-size']),
923
939
  df: new Set(['--as', '--format']), mkdir: new Set(['--as', '--format']), cp: new Set(['--as', '--format']),
924
940
  mv: new Set(['--as', '--format']), rm: new Set(['--as', '--format']),
925
- getfacl: new Set(['--as', '--format']), setfacl: new Set(['--as', '--format', '-m', '-x']),
941
+ getfacl: new Set(['--as', '--format']), setfacl: new Set(['--as', '--format', '-m', '-x', '--expires', '--max-uses']),
926
942
  link: new Set(['--as', '--format', '--expires']),
927
943
  };
928
944
  const allowedBoolean = {
@@ -956,35 +972,67 @@ export function resolveManagedFsOperation(argv) {
956
972
  if (!!modify === !!remove)
957
973
  return failFs('INVALID_ARGUMENT', 'setfacl requires exactly one of -m or -x');
958
974
  const spec = modify ?? remove ?? '';
959
- const parsedAcl = parseManagedGroupAclSpec(spec, modify !== undefined);
960
- if (!('grantee' in parsedAcl))
961
- return parsedAcl;
975
+ let acl;
976
+ let groupAcl;
977
+ if (spec.startsWith('role:')) {
978
+ if (values.has('--expires') || values.has('--max-uses')) {
979
+ return failFs('INVALID_ARGUMENT', 'group ACL does not accept expiry or usage limits');
980
+ }
981
+ const parsedAcl = parseManagedGroupAclSpec(spec, modify !== undefined);
982
+ if (!('grantee' in parsedAcl))
983
+ return parsedAcl;
984
+ groupAcl = parsedAcl;
985
+ }
986
+ else {
987
+ try {
988
+ acl = parseStorageAcl(spec, remove !== undefined, {
989
+ expires: values.get('--expires'), maxUses: values.get('--max-uses'),
990
+ });
991
+ }
992
+ catch (error) {
993
+ return failFs('INVALID_ARGUMENT', error instanceof Error ? error.message : String(error));
994
+ }
995
+ }
962
996
  const remote = remoteOrError(positionals[0]);
963
997
  if (!('targetAid' in remote))
964
998
  return remote;
965
999
  return { ok: true, command: {
966
- kind: 'setfacl', operationId: 'ec.fs.setfacl', canonicalArgv: ['fs', 'setfacl', positionals[0], modify !== undefined ? '-m' : '-x', spec, ...(actorAid ? ['--as', actorAid] : [])],
1000
+ kind: 'setfacl', operationId: 'ec.fs.setfacl', canonicalArgv: ['fs', 'setfacl', positionals[0], modify !== undefined ? '-m' : '-x', acl ? JSON.stringify(acl) : spec, ...(actorAid ? ['--as', actorAid] : [])],
967
1001
  actorAid, targetAid: remote.targetAid, remotePath: remote.remotePath,
968
- aclGrantee: parsedAcl.grantee, ...(parsedAcl.perms ? { aclPerms: parsedAcl.perms } : {}), aclRemove: remove !== undefined,
1002
+ ...(groupAcl ? { aclGrantee: groupAcl.grantee, aclPerms: groupAcl.perms } : { acl }),
1003
+ aclRemove: remove !== undefined,
969
1004
  } };
970
1005
  }
971
1006
  if (rawKind === 'cp') {
972
- const destination = remoteOrError(positionals[1]);
973
- if (!('targetAid' in destination))
974
- return destination;
975
- // Windows absolute paths contain a drive-letter colon, but are local
976
- // upload sources rather than managed group references.
977
- const isWindowsAbsolutePath = /^[A-Za-z]:[\\/]/.test(positionals[0]);
978
- const source = positionals[0].includes(':') && !isWindowsAbsolutePath
979
- ? remoteOrError(positionals[0])
980
- : undefined;
1007
+ // Drive-letter colons belong to local Windows paths on either side.
1008
+ const isRemote = (value) => value.includes(':') && !/^[A-Za-z]:[\\/]/.test(value);
1009
+ const source = isRemote(positionals[0]) ? remoteOrError(positionals[0]) : undefined;
1010
+ const destination = isRemote(positionals[1]) ? remoteOrError(positionals[1]) : undefined;
981
1011
  if (source && !('targetAid' in source))
982
1012
  return source;
1013
+ if (destination && !('targetAid' in destination))
1014
+ return destination;
1015
+ if (!source && !destination)
1016
+ return failFs('INVALID_ARGUMENT', 'managed cp requires at least one remote storage path');
1017
+ const canonicalArgv = ['fs', 'cp', ...positionals,
1018
+ ...(actorAid ? ['--as', actorAid] : []), ...(overwrite ? ['--overwrite'] : []), ...(recursive ? ['--recursive'] : [])];
1019
+ if (source && !destination) {
1020
+ if (source.remotePath === '/')
1021
+ return failFs('INVALID_PATH', 'managed download requires a file path');
1022
+ if (recursive)
1023
+ return failFs('NOT_ALLOWED', 'managed download only supports individual files');
1024
+ return { ok: true, command: {
1025
+ kind: 'download', operationId: 'ec.fs.download', canonicalArgv,
1026
+ actorAid, targetAid: source.targetAid, remotePath: source.remotePath, localPath: positionals[1], overwrite,
1027
+ } };
1028
+ }
1029
+ if (!destination)
1030
+ return failFs('INVALID_ARGUMENT', 'managed cp requires a remote destination');
983
1031
  if (source && source.targetAid !== destination.targetAid)
984
1032
  return failFs('INVALID_ARGUMENT', 'managed cp cannot cross targets');
985
1033
  const kind = source ? 'copy' : 'upload';
986
1034
  return { ok: true, command: {
987
- kind, operationId: `ec.fs.${kind}`, canonicalArgv: ['fs', 'cp', positionals[0], positionals[1], ...(actorAid ? ['--as', actorAid] : [])],
1035
+ kind, operationId: `ec.fs.${kind}`, canonicalArgv,
988
1036
  actorAid, targetAid: destination.targetAid, remotePath: destination.remotePath, destinationPath: destination.remotePath,
989
1037
  ...(source ? { remoteSourcePath: source.remotePath } : { localPath: positionals[0] }), overwrite, recursive,
990
1038
  } };
@@ -1115,6 +1163,9 @@ export async function executeManagedFsOperationWithClient(command, client) {
1115
1163
  if (command.authoritative && (command.kind !== 'cat' || command.storageBackend !== 'personal')) {
1116
1164
  throw new ManagedFsOperationError('NOT_ALLOWED', 'authoritative reads require personal storage cat');
1117
1165
  }
1166
+ if (command.kind === 'setfacl' && (command.storageBackend === 'personal' ? !command.acl : !!command.acl)) {
1167
+ throw new ManagedFsOperationError('INVALID_ARGUMENT', 'Personal ACL selectors and group role ACLs cannot be mixed');
1168
+ }
1118
1169
  try {
1119
1170
  return await (async () => {
1120
1171
  if (command.storageBackend === 'personal') {
@@ -1129,6 +1180,15 @@ export async function executeManagedFsOperationWithClient(command, client) {
1129
1180
  return { ok: true, command: 'upload', path: ref, localPath: command.localPath,
1130
1181
  result: await client.storage.uploadFile(command.localPath, command.remotePath, { owner, overwrite: command.overwrite }) };
1131
1182
  }
1183
+ case 'download': {
1184
+ if (!command.localPath)
1185
+ throw new ManagedFsOperationError('INVALID_DESTINATION', 'managed download destination is required');
1186
+ const result = await client.storage.downloadFile(command.remotePath, command.localPath, {
1187
+ owner, overwrite: command.overwrite, verifyHash: true, noCache: true,
1188
+ });
1189
+ return { ok: true, command: 'download', path: ref, localPath: result.localPath,
1190
+ size: result.size, verified: result.verified, sha256: result.sha256 };
1191
+ }
1132
1192
  case 'copy': {
1133
1193
  if (!command.remoteSourcePath)
1134
1194
  throw new ManagedFsOperationError('INVALID_SOURCE', 'managed copy source is required');
@@ -1184,7 +1244,8 @@ export async function executeManagedFsOperationWithClient(command, client) {
1184
1244
  case 'getfacl':
1185
1245
  return { ok: true, command: 'getfacl', path: ref, result: await client.storage.listAcl(command.remotePath, { owner }) };
1186
1246
  case 'setfacl':
1187
- throw new ManagedFsOperationError('NOT_ALLOWED', 'Managed personal storage ACL changes are not supported');
1247
+ return { ok: true, command: 'setfacl', path: ref, removed: !!command.aclRemove,
1248
+ result: await executeStorageAcl(client, owner, command.remotePath, command.acl, !!command.aclRemove) };
1188
1249
  case 'cat': {
1189
1250
  const bytes = command.authoritative
1190
1251
  ? (await readAuthoritativePersonalFsObject(client, command.remotePath, owner, command.maxBytes ?? DEFAULT_FS_CAT_BYTES)).bytes
@@ -1220,6 +1281,14 @@ export async function executeManagedFsOperationWithClient(command, client) {
1220
1281
  return { ok: true, command: 'upload', path: ref, localPath: command.localPath,
1221
1282
  result: await client.group.fs.cp(command.localPath, ref, { parents: true, overwrite: command.overwrite, force: command.overwrite }) };
1222
1283
  }
1284
+ case 'download': {
1285
+ if (!command.localPath)
1286
+ throw new ManagedFsOperationError('INVALID_DESTINATION', 'managed download destination is required');
1287
+ const result = await client.group.fs.cp(ref, command.localPath, {
1288
+ overwrite: command.overwrite, force: command.overwrite, verifyHash: true, noCache: true,
1289
+ });
1290
+ return { ok: true, command: 'download', path: ref, localPath: command.localPath, result };
1291
+ }
1223
1292
  case 'copy': {
1224
1293
  if (!command.remoteSourcePath)
1225
1294
  throw new ManagedFsOperationError('INVALID_SOURCE', 'managed copy source is required');
@@ -1309,6 +1378,9 @@ export async function executeManagedFsOperationWithClient(command, client) {
1309
1378
  throw new ManagedFsOperationError(error.code, error.message);
1310
1379
  if (error instanceof AuthoritativeFsReadError)
1311
1380
  throw new ManagedFsOperationError(error.code, error.message);
1381
+ if (error?.code === 'ACL_RESULT_UNKNOWN') {
1382
+ throw new ManagedFsOperationError('ACL_RESULT_UNKNOWN', error.message);
1383
+ }
1312
1384
  throw new ManagedFsOperationError('FS_OPERATION_FAILED', error instanceof Error ? error.message : String(error));
1313
1385
  }
1314
1386
  }