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
@@ -5,78 +5,19 @@ import { assert, isRecord, unpack, jsonBytes, atomicBytes, sha256, regularPath,
5
5
  import { inspectTemplatePackage } from './shared/template-package.mjs';
6
6
  import { partitionTeamMembers } from './shared/template-runtime.mjs';
7
7
 
8
- export const UPDATE_DIFF_LIMITS = Object.freeze({ items: 256, bytes: 96 * 1024, valueBytes: 4096,
9
- scanBytes: 64 * 1024, textBytesPerSide: 4096, textLinesPerSide: 60 });
10
- const sensitiveKey = /^(?:api[-_]?key|access[-_]?token|refresh[-_]?token|token|password|secret|credentials?|private[-_]?key|authorization|headers|query[-_]?params|cookies?|seed|mnemonic)$/i;
11
- const sensitiveText = text => /-----BEGIN [A-Z ]*PRIVATE KEY-----|\bBearer\s+\S+|\b(?:sk|ghp|github_pat)[-_][A-Za-z0-9_-]{12,}|\beyJ[A-Za-z0-9_-]+\.[A-Za-z0-9_-]+\.[A-Za-z0-9_-]+|\b[a-z]+:\/\/[^\s/@:]+:[^\s/@]+@/i.test(text)
12
- || /\b(?:api[-_ ]?key|access[-_ ]?token|refresh[-_ ]?token|password|secret|credentials?|authorization|cookie)\b["']?\s*(?::|=|\bis\b)\s*["']?[^\s"',;}]+/i.test(text);
13
- function publicUpdateValue(value, known, label) {
14
- if (!known) return { state: 'unknown' };
15
- if (value === undefined) return { state: 'absent' };
16
- let redacted = false;
17
- const visit = (item, key, depth = 0) => {
18
- if (sensitiveKey.test(key) || typeof item === 'string' && sensitiveText(item)) {
19
- redacted = true; return { hidden: true, reason: 'sensitive' };
20
- }
21
- if (depth > 12) { redacted = true; return { hidden: true, reason: 'depth-limit' }; }
22
- if (Array.isArray(item)) return item.map(entry => visit(entry, '', depth + 1));
23
- if (isRecord(item)) return Object.fromEntries(Object.entries(item).map(([key, entry]) => [key, visit(entry, key, depth + 1)]));
24
- return item;
25
- };
26
- const safe = visit(value, label.split('/').at(-1));
27
- const bytes = Buffer.byteLength(JSON.stringify(safe));
28
- if (bytes > UPDATE_DIFF_LIMITS.valueBytes) return { state: 'present', visibility: 'hidden', reason: 'value-limit', bytes };
29
- return { state: 'present', visibility: redacted ? 'redacted' : 'visible', value: safe };
30
- }
31
- function updateFileText(bytes, file) {
32
- if (bytes === null) return { visibility: 'visible', text: '' };
33
- if (/(?:^|[/\\])(?:\.env(?:\.[^/\\]*)?|credentials?(?:\.[^/\\]*)?|secrets?(?:\.[^/\\]*)?|id_rsa|id_ed25519)(?:$|[/\\])|\.(?:pem|key|p12|pfx)$/i.test(file)) {
34
- return { visibility: 'hidden', reason: 'sensitive-path' };
35
- }
36
- if (bytes.length > UPDATE_DIFF_LIMITS.scanBytes) return { visibility: 'hidden', reason: 'scan-limit' };
37
- let text;
38
- try { text = new TextDecoder('utf-8', { fatal: true }).decode(bytes); }
39
- catch { return { visibility: 'hidden', reason: 'binary' }; }
40
- if (/[\x00-\x08\x0b\x0c\x0e-\x1f\x7f]/.test(text)) return { visibility: 'hidden', reason: 'binary' };
41
- if (sensitiveText(text)) return { visibility: 'hidden', reason: 'sensitive-content' };
42
- return { visibility: 'visible', text };
43
- }
44
- function boundedUpdateTextDiff(current, candidate) {
45
- if (current.visibility !== 'visible' || candidate.visibility !== 'visible') {
46
- return { visibility: 'hidden', reason: [current, candidate].filter(side => side.visibility !== 'visible').map(side => side.reason).join(',') };
47
- }
48
- const left = current.text.split('\n'); const right = candidate.text.split('\n');
49
- let start = 0; let end = 0;
50
- while (start < left.length && start < right.length && left[start] === right[start]) start++;
51
- while (end < left.length - start && end < right.length - start && left[left.length - 1 - end] === right[right.length - 1 - end]) end++;
52
- const take = lines => {
53
- const out = []; let bytes = 0;
54
- for (const [index, text] of lines.entries()) {
55
- if (out.length >= UPDATE_DIFF_LIMITS.textLinesPerSide) break;
56
- const remaining = UPDATE_DIFF_LIMITS.textBytesPerSide - bytes;
57
- if (remaining <= 0) break;
58
- let bounded = text;
59
- if (Buffer.byteLength(text) > remaining) bounded = new TextDecoder().decode(Buffer.from(text).subarray(0, remaining)).replace(/\uFFFD$/, '');
60
- out.push({ line: start + index + 1, text: bounded }); bytes += Buffer.byteLength(bounded);
61
- if (bounded !== text) return { lines: out, truncated: true, totalLines: lines.length };
62
- }
63
- return { lines: out, truncated: out.length < lines.length, totalLines: lines.length };
64
- };
65
- return { visibility: 'visible', format: 'line-replacement', unchangedPrefixLines: start, unchangedSuffixLines: end,
66
- removed: take(left.slice(start, left.length - end)), added: take(right.slice(start, right.length - end)) };
67
- }
68
8
 
69
9
  export function readPackage(options) {
70
10
  const checked = inspectTemplatePackage(fs.readFileSync(options.archivePath), { digest: options.digest });
71
- const { inlineMembers, optionalReferences, externalContacts, assistantKey } = partitionTeamMembers(checked.team);
11
+ const { inlineMembers, externalContacts, assistantKey } = partitionTeamMembers(checked.team);
72
12
  return { metadata: { id: checked.metadata.id, name: checked.metadata.name, version: checked.metadata.version, description: checked.metadata.description, platforms: checked.metadata.compat.platforms }, members: Object.fromEntries(inlineMembers.map(member => [member.key, member])), digest: checked.digest,
73
- memberReferences: { optional: optionalReferences, external: externalContacts }, assistantKey,
13
+ memberReferences: { external: externalContacts }, assistantKey, publisher: checked.metadata.publisher,
74
14
  size: fs.statSync(options.archivePath).size, resources: checked.resources, externalAids: checked.metadata.externalAids ?? [], scan: { findings: [] }, excluded: [] };
75
15
  }
76
16
  export async function previewInstallation(options) {
77
17
  const bytes = fs.readFileSync(options.archivePath);
78
18
  const checked = inspectTemplatePackage(bytes, { digest: options.digest });
79
- assert(checked.team.host.platform.includes(process.platform), 'INCOMPATIBLE', 'Template does not support this platform');
19
+ const warnings = checked.team.host.platform.includes(process.platform) ? [] : [{ code: 'PLATFORM_MISMATCH',
20
+ message: `模板声明支持 ${checked.team.host.platform.join(', ')},当前主机为 ${process.platform};安装后请验证功能。` }];
80
21
  const allKeys = partitionTeamMembers(checked.team).inlineMembers.map(member => member.key);
81
22
  assert(!options.sourceMemberKey || allKeys.includes(options.sourceMemberKey), 'INTEGRITY_FAILED', 'Original source member is absent');
82
23
  const keys = options.sourceMemberKey ? [options.sourceMemberKey] : allKeys;
@@ -94,11 +35,22 @@ export async function previewInstallation(options) {
94
35
  };
95
36
  }
96
37
  const data = await inspectPackage({ packageDir: root, targets, members: options.selections,
97
- memberDefaults: options.memberDefaults, contextMembers: options.contextMembers, sourceMemberKey: options.sourceMemberKey,
38
+ sourceMemberKey: options.sourceMemberKey,
98
39
  affectedAids: options.update?.otherAgents,
99
40
  packageRoot: options.packageRoot, out: options.out, digest: checked.digest,
100
41
  planMode: options.installMode === 'create' ? 'create_on_host' : 'overlay_existing' });
101
42
  const plan = JSON.parse(fs.readFileSync(data.planFile, 'utf8'));
43
+ if (!options.update && plan.members.length === 1 && keys[0].includes('.')
44
+ && (options.installMode === 'create' || !Object.hasOwn(options.targets[keys[0]].targetConfig, 'update'))) {
45
+ const write = plan.writes.find(write => write.path === path.join(options.home, 'agents', plan.members[0].targetAid, 'config.json'));
46
+ const config = JSON.parse(Buffer.from(write.content, 'base64'));
47
+ config.version = checked.metadata.version;
48
+ config.update = { mode: 'manual', ...config.update, key: keys[0] };
49
+ if (options.registryAid) config.update.registryAid = options.registryAid;
50
+ else delete config.update.registryAid;
51
+ write.content = jsonBytes(config).toString('base64');
52
+ atomicBytes(data.planFile, jsonBytes(plan), 0o600);
53
+ }
102
54
  const update = options.update ? planAgentUpdate(plan, options.update) : undefined;
103
55
  if (update) atomicBytes(data.planFile, jsonBytes(plan), 0o600);
104
56
  const configs = {};
@@ -107,183 +59,80 @@ export async function previewInstallation(options) {
107
59
  assert(write, 'CONFLICT', 'Missing member configuration');
108
60
  configs[member.key] = JSON.parse(Buffer.from(write.content, 'base64').toString('utf8'));
109
61
  }
110
- atomicBytes(path.join(options.out, 'source.ectpl'), bytes, 0o600);
111
- return { ...data, configs, profiles: Object.fromEntries(plan.members.map(member => [member.key, member.profile])),
112
- memberReferences: { optional: partitionTeamMembers(checked.team).optionalReferences, external: partitionTeamMembers(checked.team).externalContacts },
62
+ return { ...data, warnings: [...warnings, ...(data.warnings ?? [])], configs, profiles: Object.fromEntries(plan.members.map(member => [member.key, member.profile])),
63
+ memberReferences: { external: partitionTeamMembers(checked.team).externalContacts },
113
64
  assistantKey: partitionTeamMembers(checked.team).assistantKey,
114
65
  metadata: { id: checked.metadata.id, name: checked.metadata.name, version: checked.metadata.version, platforms: checked.metadata.compat.platforms },
115
66
  ...(update ? { update } : {}), digest: checked.digest, ignored: [], sourceDigest: sha256(bytes) };
116
67
  }
117
68
 
118
- /** Three-way planning changes only managed material; unknown legacy baselines require a choice. */
69
+ /** Apply the exact release by default. The old installed MANIFEST only identifies retired files and retained backups. */
119
70
  export function planAgentUpdate(plan, input) {
120
71
  assert(plan.members?.length === 1, 'INVALID_ARGUMENT', 'A single target is required');
121
- const member = plan.members[0]; const aid = member.targetAid;
122
- const agentDir = path.join(plan.home, 'agents', aid); const configFile = path.join(agentDir, 'config.json');
123
- const lockFile = path.join(agentDir, 'template.lock.json');
124
- const switchesFile = path.join(agentDir, 'skills', '.switches.json');
125
- const centerFile = path.join(agentDir, 'events', 'events-config.json');
126
- const prior = input.installation; const baseline = prior.baseline;
127
- const observed = Object.fromEntries(plan.writes.filter(write => write.path !== lockFile).map(write => [write.path, snapshot(write.path)]));
128
- const resolutions = input.resolutions ?? {}; const approvals = new Set(input.approvals ?? []);
129
- const knownChoices = new Set(); const changes = []; const conflicts = []; const requiredApprovals = [];
130
- const diff = { schemaVersion: 1, limits: UPDATE_DIFF_LIMITS, items: [], complete: true, omittedItems: 0 };
131
- let detailBytes = 0;
132
- const eq = (a, b) => JSON.stringify(a) === JSON.stringify(b);
133
- const idFor = label => 'change_' + sha256(Buffer.from(label));
134
- const displayPath = label => {
135
- if (!label.startsWith('file:')) return label;
136
- const file = label.slice(5);
137
- for (const [scope, base] of [['agent', agentDir], ['workspace', member.projectPath], ['host', plan.home]]) {
138
- const relative = path.relative(base, file);
139
- if (relative && !relative.startsWith('..') && !path.isAbsolute(relative)) return scope + '/' + relative.split(path.sep).join('/');
140
- }
141
- return 'file/' + path.basename(file);
142
- };
143
- const addDetail = item => {
144
- const bytes = Buffer.byteLength(JSON.stringify(item));
145
- if (diff.items.length >= UPDATE_DIFF_LIMITS.items || detailBytes + bytes > UPDATE_DIFF_LIMITS.bytes) {
146
- diff.complete = false; diff.omittedItems++; return;
147
- }
148
- diff.items.push(item); detailBytes += bytes;
149
- };
150
- const valueDetail = (id, label, before, current, candidate, known, selected, kind = label.split('/')[0]) => ({
151
- id, kind, path: displayPath(label), baseline: publicUpdateValue(before, known, label),
152
- current: publicUpdateValue(current, true, label), candidate: publicUpdateValue(candidate, true, label), selected,
153
- });
154
- const fileDetail = (id, label, before, current, candidate, known, selected) => {
155
- const file = label.slice(5);
156
- const bytes = current === null ? null : fs.readFileSync(file);
157
- assert(current === null || sha256(bytes) === current.sha256, 'TARGET_CHANGED', 'File changed while capturing preview details');
158
- const write = plan.writes.find(write => write.path === file);
159
- const next = !candidate ? null : Buffer.from(write.content, 'base64');
160
- const currentText = updateFileText(bytes, file); const candidateText = updateFileText(next, file);
161
- const descriptor = (value, size, content) => value === null ? { state: 'absent' } : {
162
- state: 'present', sha256: 'sha256:' + value.sha256, size, mode: value.mode,
163
- modeOctal: value.mode?.toString(8).padStart(4, '0'), content: { visibility: content.visibility, ...(content.reason ? { reason: content.reason } : {}) },
164
- };
165
- return { id, kind: 'file', path: displayPath(label), selected,
166
- baseline: !known ? { state: 'unknown' } : descriptor(before, before?.size ?? (before?.sha256 === current?.sha256 ? bytes?.length ?? null : null),
167
- { visibility: 'hidden', reason: 'baseline-content-unavailable' }),
168
- current: descriptor(current, bytes?.length ?? null, currentText), candidate: descriptor(candidate, next?.length ?? null, candidateText),
169
- textDiff: boundedUpdateTextDiff(currentText, candidateText) };
170
- };
171
- const choose = (label, before, current, candidate, known = baseline.known) => {
172
- const id = idFor(label); knownChoices.add(id);
173
- const changed = !eq(current, candidate);
174
- const local = known ? !eq(current, before) : current !== undefined && current !== null;
175
- const conflict = changed && local && (!known || !eq(candidate, before));
176
- const keep = resolutions[id] === 'keep-local' || known && local && eq(candidate, before) && !resolutions[id];
177
- if (changed) changes.push({ id, detailId: id, path: label, baselineKnown: known, locallyModified: local,
178
- operation: candidate === undefined || candidate === null ? 'remove' : current === undefined || current === null ? 'add' : 'change' });
179
- if (changed) addDetail(label.startsWith('file:')
180
- ? fileDetail(id, label, before, current, candidate, known, keep ? 'current' : 'candidate')
181
- : valueDetail(id, label, before, current, candidate, known, keep ? 'current' : 'candidate'));
182
- if (conflict) conflicts.push({ id, detailId: id, path: label, reason: known ? 'LOCAL_MODIFICATION' : 'BASELINE_UNKNOWN',
183
- resolution: resolutions[id] ?? null });
184
- if (keep) return current;
185
- return candidate;
186
- };
187
- const needApproval = (label, changed, values) => {
188
- if (!changed) return;
189
- const id = idFor('approval:' + label); const detailId = values?.reference ?? id;
190
- requiredApprovals.push({ id, detailId, path: label, confirmed: approvals.has(id) });
191
- if (!values?.reference) addDetail(valueDetail(id, label, values?.before, values?.current, values?.candidate,
192
- values?.known ?? baseline.known, 'candidate', 'permission'));
193
- };
194
- const configWrite = plan.writes.find(write => write.path === configFile);
195
- assert(configWrite, 'INTEGRITY_FAILED', 'Missing target configuration');
72
+ const member = plan.members[0]; const agentDir = path.join(plan.home, 'agents', member.targetAid);
73
+ const configFile = path.join(agentDir, 'config.json'); const lockFile = path.join(agentDir, 'template.lock.json');
196
74
  const original = JSON.parse(fs.readFileSync(configFile, 'utf8'));
197
- const candidate = JSON.parse(Buffer.from(configWrite.content, 'base64').toString('utf8'));
198
- const fields = ['chatmode', 'memory', 'access', 'active_baseagent', 'baseagents', 'version'];
199
- const managedConfig = Object.fromEntries(fields.filter(field => Object.hasOwn(member.managedConfig ?? {}, field))
200
- .map(field => [field, member.managedConfig[field]]));
201
- const merge = (label, before, current, next) => {
202
- if (isRecord(next) && isRecord(current)) {
203
- const out = { ...current };
204
- for (const key of new Set([...Object.keys(before ?? {}), ...Object.keys(next)])) {
205
- const value = merge(label + '/' + key, before?.[key], current[key], next[key]);
206
- if (value === undefined) delete out[key]; else out[key] = value;
207
- }
208
- return out;
209
- }
210
- return choose(label, before, current, next);
211
- };
212
- const result = { ...original };
213
- for (const field of fields.filter(field => Object.hasOwn(managedConfig, field) || Object.hasOwn(baseline.config ?? {}, field))) {
214
- const value = merge('config/' + field, baseline.config?.[field], original[field], managedConfig[field]);
215
- if (value === undefined) delete result[field]; else result[field] = value;
216
- }
217
- // update.mode is local policy, not an author-controlled migration switch. Team and all identity fields stay local.
75
+ const configWrite = plan.writes.find(write => write.path === configFile);
76
+ const config = JSON.parse(Buffer.from(configWrite.content, 'base64'));
77
+ // Policy/source and local credentials remain local. Version is committed only after installation verification.
218
78
  for (const field of ['update', 'team', 'aid', 'owner', 'owners', 'host', 'channels', 'projects', 'enabled', 'lifecycle', 'initialization']) {
219
- if (Object.hasOwn(original, field)) result[field] = original[field]; else delete result[field];
79
+ if (Object.hasOwn(original, field)) config[field] = original[field]; else delete config[field];
220
80
  }
221
- needApproval('config/access', !eq(original.access, result.access), { before: baseline.config?.access, current: original.access, candidate: result.access });
222
- needApproval('config/chatmode', !eq(original.chatmode, result.chatmode), { before: baseline.config?.chatmode, current: original.chatmode, candidate: result.chatmode });
223
- needApproval('config/baseagents', !eq(original.baseagents, result.baseagents) || original.active_baseagent !== result.active_baseagent,
224
- { before: { active_baseagent: baseline.config?.active_baseagent, baseagents: baseline.config?.baseagents },
225
- current: { active_baseagent: original.active_baseagent, baseagents: original.baseagents },
226
- candidate: { active_baseagent: result.active_baseagent, baseagents: result.baseagents } });
227
- configWrite.content = jsonBytes(result).toString('base64');
228
- const profile = {};
229
- const authorProfile = { ...member.profile };
230
- for (const field of PROFILE_FIELDS) {
231
- const value = choose('profile/' + field, baseline.profile?.[field], member.originalProfile?.[field], authorProfile[field]);
232
- if (value !== undefined) profile[field] = value;
233
- }
234
- member.profile = profile;
235
- const managedFiles = {}; const writes = [configWrite];
236
- const managedSkills = member.managedSkills ?? {};
237
- const currentSkills = fs.existsSync(switchesFile) ? JSON.parse(fs.readFileSync(switchesFile, 'utf8')) : {};
238
- const selectedSkills = { ...currentSkills };
239
- for (const name of new Set([...Object.keys(baseline.skills ?? {}), ...Object.keys(managedSkills)])) {
240
- const candidate = managedSkills[name] ?? { enabled: false };
241
- const value = choose('skill/' + name, baseline.skills?.[name], currentSkills[name], candidate,
242
- baseline.known && Object.hasOwn(baseline.skills ?? {}, name));
243
- if (value !== undefined) selectedSkills[name] = value;
81
+ config.version = original.version;
82
+ configWrite.content = jsonBytes(config).toString('base64');
83
+ const location = file => {
84
+ for (const [scope, root] of [['agent', agentDir], ['workspace', member.projectPath], ['shared', path.join(plan.home, 'skills')]]) {
85
+ const relative = path.relative(root, file);
86
+ if (relative && relative !== '..' && !relative.startsWith('..' + path.sep) && !path.isAbsolute(relative)) return scope + '/' + relative.split(path.sep).join('/');
87
+ }
88
+ throw Object.assign(new Error('Unexpected managed file'), { code: 'SHARED_RESOURCE_CONFLICT' });
89
+ };
90
+ const resolve = relative => {
91
+ const [scope, ...parts] = relative.split('/'); const roots = { agent: agentDir, workspace: member.projectPath, shared: path.join(plan.home, 'skills') };
92
+ assert(roots[scope] && parts.length && parts.every(part => part && part !== '.' && part !== '..' && !/[\\:\0]/.test(part)), 'INVALID_ARGUMENT', 'Invalid installed file path');
93
+ return path.join(roots[scope], ...parts);
94
+ };
95
+ let oldFiles = null;
96
+ if (Array.isArray(input.manifest) && input.manifest.every(entry => typeof entry.path === 'string'
97
+ && /^[a-f0-9]{64}$/.test(entry.sha256) && Number.isSafeInteger(entry.size) && entry.size >= 0)
98
+ && new Set(input.manifest.map(entry => entry.path)).size === input.manifest.length) {
99
+ try { input.manifest.forEach(entry => resolve(entry.path)); oldFiles = new Map(input.manifest.map(entry => [entry.path, entry])); } catch { oldFiles = null; }
244
100
  }
245
- if (!eq(currentSkills, selectedSkills)) {
246
- const expected = snapshot(switchesFile); observed[switchesFile] = expected;
247
- writes.push({ path: switchesFile, expected, mode: expected?.mode ?? 0o600, content: jsonBytes(selectedSkills).toString('base64') });
248
- needApproval('skills/switches', true, { before: baseline.skills, current: currentSkills, candidate: selectedSkills });
101
+ const desired = new Map(); const writes = [];
102
+ const switchesFile = path.join(agentDir, 'skills', '.switches.json');
103
+ const oldSkills = oldFiles?.get('agent/skills/.switches.json')?.skills;
104
+ if (Array.isArray(oldSkills) && oldSkills.every(name => typeof name === 'string')) {
105
+ let write = plan.writes.find(write => write.path === switchesFile);
106
+ const switches = write ? JSON.parse(Buffer.from(write.content, 'base64'))
107
+ : fs.existsSync(switchesFile) ? JSON.parse(fs.readFileSync(switchesFile, 'utf8')) : {};
108
+ for (const name of oldSkills) if (!Object.hasOwn(member.managedSkills ?? {}, name)) switches[name] = { enabled: false };
109
+ if (!write) { write = { path: switchesFile, mode: 0o600, expected: snapshot(switchesFile) }; plan.writes.push(write); }
110
+ write.content = jsonBytes(switches).toString('base64');
249
111
  }
250
- const safe = file => file.startsWith(agentDir + path.sep) || file.startsWith(member.projectPath + path.sep);
251
- const sameFile = (a, b) => a === null || b === null ? a === b : a?.sha256 === b?.sha256 && a?.mode === b?.mode;
252
- for (const write of plan.writes.filter(write => ![configFile, lockFile, switchesFile].includes(write.path))) {
253
- regularPath(write.path);
254
- const current = snapshot(write.path);
255
- const desired = write.remove ? null : { sha256: sha256(Buffer.from(write.content, 'base64')), mode: write.mode };
256
- if (!safe(write.path) && !sameFile(current, desired) && input.otherAgents?.length) {
257
- throw Object.assign(new Error('Shared resource would affect other Agents'), { code: 'SHARED_RESOURCE_CONFLICT',
258
- data: { path: write.path, affectedAids: input.otherAgents } });
112
+ for (const write of plan.writes) {
113
+ if (write.path === lockFile) continue;
114
+ const relative = location(write.path);
115
+ if (relative.startsWith('shared/') && input.otherAgents?.length && !write.remove
116
+ && snapshot(write.path)?.sha256 !== sha256(Buffer.from(write.content, 'base64'))) {
117
+ throw Object.assign(new Error('Shared resources are used by other Agents'), { code: 'SHARED_RESOURCE_CONFLICT', data: { path: relative, affectedAids: input.otherAgents } });
259
118
  }
260
- // Runtime control files and unowned event extras never enter the deletion set.
261
- if (write.remove && !Object.hasOwn(baseline.files ?? {}, write.path)) continue;
262
- managedFiles[write.path] = desired;
263
- const selected = choose('file:' + write.path, baseline.files?.[write.path], current, desired,
264
- baseline.known && Object.hasOwn(baseline.files ?? {}, write.path));
265
- if (sameFile(selected ?? null, current)) continue;
266
- if (/[/\\](?:triggers|events)[/\\]/.test(write.path) || /[/\\]skills[/\\]/.test(write.path)
267
- || (write.mode & 0o111)) needApproval('file:' + write.path, true, { reference: idFor('file:' + write.path) });
268
- writes.push(write);
119
+ if (write.remove && !oldFiles?.has(relative)) continue;
120
+ desired.set(relative, write); writes.push(write);
269
121
  }
270
- for (const [file, previous] of Object.entries(baseline.files ?? {})) {
271
- if (Object.hasOwn(managedFiles, file) || !safe(file) || [configFile, lockFile, switchesFile, centerFile].includes(file)) continue;
272
- regularPath(file); const current = snapshot(file);
273
- observed[file] = current;
274
- const selected = choose('file:' + file, previous, current, null);
275
- managedFiles[file] = null;
276
- if (selected === null && current !== null) writes.push({ path: file, remove: true, expected: current });
122
+ const retainedShared = [];
123
+ if (oldFiles) for (const [relative] of oldFiles) {
124
+ if (desired.has(relative) || relative === 'agent/config.json' || relative === 'agent/skills/.switches.json') continue;
125
+ if (relative.startsWith('shared/') && input.otherAgents?.length) { retainedShared.push(relative); continue; }
126
+ // Only portable resource roots can be retired. User data and runtime metadata never enter this set.
127
+ if (!/^(?:workspace\/|shared\/|agent\/(?:personal\/(?:soul\/|welcome\.md$)|triggers\/|events\/|services\/))/.test(relative)) continue;
128
+ const file = resolve(relative); const expected = snapshot(file);
129
+ if (expected) writes.push({ path: file, remove: true, expected });
277
130
  }
278
- for (const id of Object.keys(resolutions)) assert(knownChoices.has(id), 'INVALID_ARGUMENT', 'Unknown conflict resolution');
279
- for (const id of approvals) assert(requiredApprovals.some(item => item.id === id), 'INVALID_ARGUMENT', 'Unknown permission approval');
280
131
  plan.writes = writes;
281
- plan.observed = observed;
282
- plan.updateDiff = diff;
283
- return { changes, conflicts, requiredApprovals, diff, baselineKnown: baseline.known,
284
- unresolved: [...conflicts.filter(item => !item.resolution), ...requiredApprovals.filter(item => !item.confirmed),
285
- ...(!diff.complete ? [{ code: 'DIFF_DETAILS_LIMIT', message: 'Safe preview detail limit exceeded; execution is blocked', omittedItems: diff.omittedItems }] : [])],
286
- baseline: { known: true, config: managedConfig, profile: authorProfile, skills: managedSkills, files: managedFiles } };
132
+ plan.installationManifest = { key: input.key, version: input.version, digest: input.digest,
133
+ previousValid: oldFiles !== null, oldFiles: oldFiles ? [...oldFiles.values()] : null };
134
+ return { manifestValid: oldFiles !== null, removed: writes.filter(write => write.remove).length, retainedShared,
135
+ managedPaths: [...desired.keys()], changes: [], conflicts: [], requiredApprovals: [], unresolved: [] };
287
136
  }
288
137
 
289
138
  export async function applyInstallationPlan(options) {
@@ -314,7 +163,7 @@ export async function applyInstallationPlan(options) {
314
163
  fs.renameSync(options.backupDir, options.backupDir + '-restored-' + Date.now());
315
164
  }
316
165
  for (const write of plan.writes) {
317
- if (!write.path.includes(path.sep + 'agents' + path.sep)) continue;
166
+ if (!write.path.startsWith(path.join(plan.home, 'agents') + path.sep)) continue;
318
167
  const member = plan.members.find(value => write.path.startsWith(path.join(plan.home, 'agents', value.targetAid) + path.sep));
319
168
  assert(member, 'INVALID_ARGUMENT', 'Unexpected Agent write');
320
169
  const expected = options.baselines?.[member.key]?.[write.path];
@@ -55,7 +55,7 @@ export async function prepareAidBatch({ subjects, context, transport, checkpoint
55
55
  for (const method of ['authorize', 'register', 'connect', 'bind', 'consensus', 'close']) if (typeof transport?.[method] !== 'function') fail('INVALID_ARGUMENT', 'Missing identity transport: ' + method);
56
56
  const aids = new Set(), keys = new Set();
57
57
  for (const s of subjects) {
58
- if (!record(s) || !/^[a-z0-9][a-z0-9_-]{0,31}$/.test(s.key ?? '') || !aidPattern.test(s.aid ?? '')
58
+ if (!record(s) || !(/^[a-z0-9][a-z0-9_-]{0,31}$/.test(s.key ?? '') || aidPattern.test(s.key ?? '')) || !aidPattern.test(s.aid ?? '')
59
59
  || s.relationVersion !== undefined && (!Number.isSafeInteger(s.relationVersion) || s.relationVersion < 1)
60
60
  || !['agent', 'host'].includes(s.type) || aids.has(s.aid) || keys.has(s.key) || s.aid === context.ownerAid
61
61
  || context.mode === 'members' && (s.type !== 'agent' || s.aid === context.hostAid)
@@ -1,176 +0,0 @@
1
- import { HARDCODED_BASEAGENT_NAMES, listSupportedBaseagents, normalizeBaseagent } from './baseagent.js';
2
- import { loadDefaults } from '../config-store.js';
3
- import { getBaseagentPluginDescriptor } from './baseagent-plugin-descriptor.js';
4
- import { commandExists, commandExistsAsync } from '../utils/cross-platform.js';
5
- import { getCodexAppServerAvailability, getCodexAppServerAvailabilityAsync } from './codex-runner.js';
6
- import { probeBundledClaudeVersion, probeBundledClaudeVersionAsync, resolveBundledClaudeExecutable } from './claude-runner.js';
7
- /**
8
- * Claude 的检测判据就是执行判据:会话只会在 Windows 上跑内置的、与 SDK 锁定版本
9
- * 配套的 claude.exe。PATH 里的全局 claude 执行层从不使用,因此不能作为可用判据——
10
- * 那个假阳性正是「检测说可用、会话全失败」持续 21 小时没被发现的成因。
11
- */
12
- function claudeExecutable() {
13
- if (process.platform === 'win32')
14
- return resolveBundledClaudeExecutable();
15
- // 非 Windows 平台由 SDK 自己解析平台包,此处沿用命令探测。
16
- return commandExists('claude') ? 'claude' : undefined;
17
- }
18
- export const BASEAGENT_CANDIDATES = ['claude', 'codex', 'gemini', 'ecagent'];
19
- export const AUTO_BASEAGENT_CANDIDATES = ['claude', 'codex', 'gemini'];
20
- /**
21
- * Single source of truth for init and ECWeb base-agent probing.
22
- * Claude/Gemini require an executable; Codex additionally requires a supported
23
- * CLI with app-server; ecagent is bundled with EvolCore.
24
- */
25
- export function detectAvailableBaseagents(codexAvailability = getCodexAppServerAvailability()) {
26
- const flags = loadDefaults()?.baseagents;
27
- return listSupportedBaseagents().filter((baseagent) => {
28
- const enabled = flags?.[baseagent]?.enabled;
29
- if (!HARDCODED_BASEAGENT_NAMES.has(baseagent)
30
- && enabled !== undefined && enabled !== true)
31
- return false;
32
- if (baseagent === 'ecagent')
33
- return true;
34
- if (baseagent === 'codex')
35
- return codexAvailability.available;
36
- if (baseagent === 'claude')
37
- return claudeExecutable() !== undefined;
38
- if (baseagent === 'gemini')
39
- return commandExists(baseagent);
40
- try {
41
- return getBaseagentPluginDescriptor(baseagent)?.probe?.().available === true;
42
- }
43
- catch {
44
- return false;
45
- }
46
- });
47
- }
48
- export function detectBaseagentDetails(codexAvailability = getCodexAppServerAvailability()) {
49
- const claude = claudeExecutable();
50
- const claudeVersion = claude ? probeBundledClaudeVersion() : undefined;
51
- const gemini = commandExists('gemini');
52
- return baseagentDetails(codexAvailability, claude, claudeVersion, gemini);
53
- }
54
- export async function detectBaseagentDetailsAsync() {
55
- const [codex, claude, gemini] = await Promise.all([
56
- getCodexAppServerAvailabilityAsync(),
57
- (process.platform === 'win32'
58
- ? Promise.resolve(resolveBundledClaudeExecutable())
59
- : commandExistsAsync('claude').then(found => found ? 'claude' : undefined))
60
- .then(async (executable) => ({ executable,
61
- version: executable ? await probeBundledClaudeVersionAsync() : undefined })),
62
- commandExistsAsync('gemini'),
63
- ]);
64
- return baseagentDetails(codex, claude.executable, claude.version, gemini);
65
- }
66
- function baseagentDetails(codexAvailability, claude, claudeVersion, gemini) {
67
- return [
68
- {
69
- id: 'claude',
70
- detected: claude !== undefined,
71
- detectionSource: claude ? [process.platform === 'win32' ? 'bundled SDK binary' : 'PATH'] : [],
72
- reason: claude
73
- ? undefined
74
- : process.platform === 'win32'
75
- ? '未找到内置 claude.exe(@anthropic-ai/claude-agent-sdk-win32-x64)。请重新安装 SDK 的平台包。'
76
- : '未检测到 Claude CLI。',
77
- version: claudeVersion,
78
- },
79
- {
80
- id: 'codex',
81
- detected: codexAvailability.available,
82
- detectionSource: codexAvailability.available ? ['Codex CLI app-server'] : [],
83
- reason: codexAvailability.available ? undefined : codexAvailability.reason,
84
- version: codexAvailability.version,
85
- },
86
- {
87
- id: 'gemini',
88
- detected: gemini,
89
- detectionSource: gemini ? ['PATH'] : [],
90
- reason: gemini ? undefined : '未检测到 Gemini CLI。',
91
- },
92
- {
93
- id: 'ecagent',
94
- detected: true,
95
- detectionSource: ['内置'],
96
- },
97
- ...listSupportedBaseagents().filter(id => !BASEAGENT_CANDIDATES.includes(id)).map(id => {
98
- try {
99
- const probe = getBaseagentPluginDescriptor(id)?.probe?.();
100
- return { id, detected: probe?.available === true, detectionSource: probe?.available ? ['plugin probe'] : [],
101
- version: probe?.version, reason: probe?.reason ?? (probe ? undefined : 'Plugin has no dependency probe') };
102
- }
103
- catch (error) {
104
- return { id, detected: false, detectionSource: [], reason: String(error) };
105
- }
106
- }),
107
- ];
108
- }
109
- /** Currently loaded runners only; configured on-demand choices are provided separately. */
110
- export function loadedBaseagentIds(keys, owner) {
111
- const result = new Set();
112
- for (const key of keys) {
113
- if (owner !== undefined && !key.startsWith(`${owner}::`))
114
- continue;
115
- const separator = key.indexOf('::');
116
- result.add(separator < 0 ? key : key.slice(separator + 2));
117
- }
118
- return [...result];
119
- }
120
- function canonical(value) {
121
- if (typeof value !== 'string')
122
- return null;
123
- const id = normalizeBaseagent(value).canonical;
124
- return id === 'unknown' ? null : id;
125
- }
126
- function record(value) {
127
- return value && typeof value === 'object' && !Array.isArray(value) ? value : {};
128
- }
129
- function text(value) {
130
- return typeof value === 'string' && value.trim() ? value : null;
131
- }
132
- /** Safe public projection: credentials and arbitrary backend settings never leave this boundary. */
133
- export function buildBaseagentSnapshot(config, detections, loaded) {
134
- const blocks = new Map();
135
- for (const [name, value] of Object.entries(record(config.baseagents))) {
136
- const id = canonical(name);
137
- if (id)
138
- blocks.set(id, record(value));
139
- }
140
- const active = canonical(config.active_baseagent);
141
- const probes = new Map((detections ?? []).map(item => [String(item.id), item]));
142
- const loadedIds = loaded === undefined ? null : new Set(loaded);
143
- const ids = new Set([
144
- ...blocks.keys(),
145
- ...(detections ?? []).filter(item => item.detected).map(item => item.id),
146
- ...(loaded ?? []),
147
- ...(active ? [active] : []),
148
- ]);
149
- return {
150
- active,
151
- baseagents: [...ids].map(id => ({
152
- id,
153
- label: normalizeBaseagent(id).displayName,
154
- configured: blocks.has(id),
155
- detected: detections === null ? null : probes.get(id)?.detected === true,
156
- loaded: loadedIds?.has(id) ?? null,
157
- active: id === active,
158
- model: text(blocks.get(id)?.model),
159
- effort: text(blocks.get(id)?.effort ?? blocks.get(id)?.reasoning),
160
- version: probes.get(id)?.version ?? null,
161
- detectionSource: probes.get(id)?.detectionSource ?? [],
162
- })),
163
- };
164
- }
165
- /** Shared defaults/Agent inventory for menu, slash and local history readers. */
166
- export async function getBaseagentSnapshot(options = {}) {
167
- let config = options.config;
168
- if (config === undefined) {
169
- const { read, ConfigTarget } = await import('../config/config-manager.js');
170
- config = read(ConfigTarget.Defaults, undefined, { cache: false }) ?? {};
171
- }
172
- const detections = options.probe === false
173
- ? null
174
- : await detectBaseagentDetailsAsync();
175
- return buildBaseagentSnapshot(config ?? {}, detections, options.loaded);
176
- }