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
@@ -7,9 +7,41 @@ import { logger, logOwnershipEvent, ownershipErrorCode } from '../../utils/logge
7
7
  import { hasTrustedPrincipal } from '../auth/authenticated-actor.js';
8
8
  import { registerContent, verifyFile } from '../file-integrity/store.js';
9
9
  import { atomicWrite } from '../../utils/atomic-write.js';
10
+ /**
11
+ * How long an Ownership view stays usable before this process asks again.
12
+ *
13
+ * The ownership protocol already decides how long a relation is valid: the
14
+ * remote archive carries `valid_until` (a certificate/relationship expiry that
15
+ * is months out, not minutes), and the SDK re-verifies the whole proof — both
16
+ * signed originals, relation version, archive revision, expiry — before it
17
+ * serves anything from its local record. A consensus that passed those checks
18
+ * stays true until a party changes the relation or the expiry passes, so this
19
+ * process must not expire it on a short timer of its own.
20
+ *
21
+ * The bound below is not an authority lifetime. It is the point where an
22
+ * earlier *failure* should be retried after a later one stopped caching; it
23
+ * still never shortens a verified relation that has a later `valid_until`.
24
+ */
10
25
  export const OWNERSHIP_CACHE_MAX_AGE_MS = 30 * 60_000;
26
+ /** Authorization re-uses the same relation for as long as the protocol says it holds. */
11
27
  export const OWNERSHIP_AUTHORIZATION_MAX_AGE_MS = OWNERSHIP_CACHE_MAX_AGE_MS;
12
28
  export const OWNERSHIP_RETRY_BASE_MS = 5_000;
29
+ /**
30
+ * Effective window for one consensus result.
31
+ *
32
+ * A consensus that carries a protocol expiry is valid until that expiry: the
33
+ * SDK already proved both signed originals, the relation version and the
34
+ * archive revision, and re-checks them whenever it re-reads. Only a result with
35
+ * no protocol expiry falls back to the process-local bound, which exists so a
36
+ * degraded observation cannot authorize indefinitely.
37
+ */
38
+ export function ownershipValidity(consensus, checkedAt) {
39
+ const protocolUntil = typeof consensus?.valid_until === 'number' && Number.isSafeInteger(consensus.valid_until)
40
+ && consensus.valid_until > 0 ? consensus.valid_until * 1000 : 0;
41
+ return protocolUntil > checkedAt
42
+ ? { validUntil: protocolUntil, source: 'protocol' }
43
+ : { validUntil: checkedAt + OWNERSHIP_CACHE_MAX_AGE_MS, source: 'local' };
44
+ }
13
45
  const CREATION_BIND_OPERATION_ID = /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
14
46
  /** Only use the task returned by this create's bind call. Never select a latest task. */
15
47
  export function creationOwnershipBinding(task, subjectAid, ownerAid) {
@@ -156,8 +188,11 @@ export class OwnerResolver {
156
188
  || !Number.isSafeInteger(view.consensus.relation_version) || view.consensus.relation_version < 1
157
189
  || !/^[a-f0-9]{64}$/.test(view.consensus.agent_md_sha256 ?? '')
158
190
  || !Number.isSafeInteger(view.checkedAt) || view.checkedAt > now
159
- || view.checkedAt > raw.savedAt || now - view.checkedAt >= OWNERSHIP_CACHE_MAX_AGE_MS
160
- || view.validUntil !== view.checkedAt + OWNERSHIP_CACHE_MAX_AGE_MS
191
+ || view.checkedAt > raw.savedAt
192
+ // The snapshot must still be inside the window it recorded. A view the
193
+ // protocol dated keeps that date; one it did not is bounded locally.
194
+ || !Number.isSafeInteger(view.validUntil) || view.validUntil <= now
195
+ || view.validUntil !== ownershipValidity(view.consensus, view.checkedAt).validUntil
161
196
  || (view.profile && (view.profile.sha256 !== view.consensus.agent_md_sha256
162
197
  || typeof view.profile.type !== 'string')))
163
198
  continue;
@@ -425,10 +460,34 @@ export class OwnerResolver {
425
460
  // A transport replacement must not erase a still-valid restart snapshot.
426
461
  this.invalidate(subject, 'AUN client is unavailable', false, false);
427
462
  }
463
+ /**
464
+ * Read the current ownership view, restoring the durable snapshot on first
465
+ * read. A restarted daemon has no in-memory consensus until someone refreshes
466
+ * or restores; without this, every read-only caller (control-plane authority,
467
+ * agent listing, consolidation) would see an unbound subject after a restart
468
+ * even though a verified snapshot is on disk.
469
+ */
470
+ observedView(subjectAid) {
471
+ const subject = this.subjects.get(subjectAid);
472
+ if (!subject) {
473
+ if (!isValidAid(subjectAid))
474
+ return undefined;
475
+ try {
476
+ const created = this.subject(subjectAid);
477
+ this.restoreCache(subjectAid, created);
478
+ return created.view;
479
+ }
480
+ catch {
481
+ return undefined;
482
+ }
483
+ }
484
+ this.restoreCache(subjectAid, subject);
485
+ return subject.view;
486
+ }
428
487
  owner(subjectAid) {
429
488
  if (!subjectAid)
430
489
  return undefined;
431
- const view = this.subjects.get(subjectAid)?.view;
490
+ const view = this.observedView(subjectAid);
432
491
  return view?.consensusStatus === 'consensus'
433
492
  && view.checkedAt !== undefined && view.checkedAt <= this.now()
434
493
  && ((view.validUntil ?? 0) > this.now() || view.refreshFailure?.fallbackUsed === true)
@@ -454,8 +513,7 @@ export class OwnerResolver {
454
513
  hasObservedProtocolConsensus(subjectAid) {
455
514
  if (!subjectAid)
456
515
  return false;
457
- const subject = this.subjects.get(subjectAid);
458
- const relation = subject?.view.relation;
516
+ const relation = this.observedView(subjectAid)?.relation;
459
517
  return !!relation
460
518
  && relation.relationVersion > 0
461
519
  && (relation.consensusStatus === 'consensus' || relation.consensusStatus === 'released');
@@ -470,7 +528,7 @@ export class OwnerResolver {
470
528
  const protocol = this.protocolOwners(subjectAid);
471
529
  if (protocol.length > 0)
472
530
  return protocol;
473
- const relation = this.subjects.get(subjectAid)?.view.relation;
531
+ const relation = this.observedView(subjectAid)?.relation;
474
532
  if (relation?.consensusStatus === 'consensus' && relation.ownerAid)
475
533
  return [relation.ownerAid];
476
534
  return [];
@@ -491,6 +549,11 @@ export class OwnerResolver {
491
549
  }
492
550
  snapshot(subjectAid) {
493
551
  const subject = this.subject(subjectAid);
552
+ // Restore the durable snapshot on first read so a restarted daemon reports
553
+ // the verified relation it already has on disk instead of an empty view.
554
+ // Restoring clears the guard inside restoreCache, so a notifyUpdate-driven
555
+ // re-entry cannot loop: the second pass returns before notifying.
556
+ this.restoreCache(subjectAid, subject);
494
557
  const view = JSON.parse(JSON.stringify(subject.view));
495
558
  view.requests = [...subject.requests.values()].map(request => ({ ...request }));
496
559
  if (view.consensusStatus === 'consensus' && !this.owner(subjectAid)) {
@@ -498,9 +561,10 @@ export class OwnerResolver {
498
561
  view.synchronization = { status: 'unavailable' };
499
562
  }
500
563
  const now = this.now();
564
+ // Authorization follows the relation's own expiry, exactly as `owner()` does.
501
565
  view.authorizationStatus = view.consensusStatus === 'consensus'
502
566
  && view.checkedAt !== undefined && view.checkedAt <= now
503
- ? view.ownerAid && now - view.checkedAt < OWNERSHIP_AUTHORIZATION_MAX_AGE_MS ? 'verified' : 'expired'
567
+ ? view.ownerAid && (view.validUntil ?? 0) > now ? 'verified' : 'expired'
504
568
  : 'unavailable';
505
569
  return view;
506
570
  }
@@ -645,6 +709,7 @@ export class OwnerResolver {
645
709
  const previousStatus = subject.view.consensusStatus;
646
710
  const previousConsensus = subject.view.consensus;
647
711
  const checkedAt = this.now();
712
+ const validity = ownershipValidity(consensus, checkedAt);
648
713
  const pending = subject.view.task?.status === 'pending' || subject.view.requestStatus === 'requesting';
649
714
  subject.view = {
650
715
  ...subject.view,
@@ -655,7 +720,7 @@ export class OwnerResolver {
655
720
  consensus: JSON.parse(JSON.stringify(consensus)),
656
721
  profile: profile ?? (subject.view.profile?.sha256 === consensus.agent_md_sha256 ? subject.view.profile : undefined),
657
722
  checkedAt,
658
- validUntil: checkedAt + (this.options.lifetimeMs ?? OWNERSHIP_CACHE_MAX_AGE_MS),
723
+ validUntil: validity.validUntil,
659
724
  revision: subject.view.revision + (previousOwner !== ownerAid
660
725
  || subject.view.consensusStatus !== consensus.status
661
726
  || subject.view.consensus?.relation_version !== consensus.relation_version
@@ -676,7 +741,9 @@ export class OwnerResolver {
676
741
  this.persistCache(subject);
677
742
  this.clearConfirmedRequest(subject, consensus, ownerAid);
678
743
  this.clearResolvedRequests(subject, consensus);
679
- if (previousOwner !== ownerAid || previousStatus !== consensus.status
744
+ // Compare protocol observations, not the expiring authorization view.
745
+ // Revalidating the same relation after expiry/invalidation is not a change.
746
+ if (previousConsensus?.owner_aid !== consensus.owner_aid || previousConsensus?.status !== consensus.status
680
747
  || previousConsensus?.relation_version !== consensus.relation_version
681
748
  || previousConsensus?.lock !== consensus.lock) {
682
749
  logOwnershipEvent('consensus.changed', { subjectAid, ownerAid, ...diagnostic,
@@ -1085,7 +1152,7 @@ export class OwnerResolver {
1085
1152
  }
1086
1153
  // A fresh snapshot survives transport loss; serve it instead of loading a
1087
1154
  // short-lived client. Only a stale unattached subject needs a live check.
1088
- if (!options.force && this.isCacheFresh(subject, this.options.lifetimeMs ?? OWNERSHIP_CACHE_MAX_AGE_MS)) {
1155
+ if (!options.force && this.isCacheFresh(subject)) {
1089
1156
  return this.snapshot(subjectAid);
1090
1157
  }
1091
1158
  const generation = subject.generation;
@@ -1116,13 +1183,26 @@ export class OwnerResolver {
1116
1183
  }
1117
1184
  }
1118
1185
  }
1186
+ /** True when the view's expiry is the relation expiry the protocol published. */
1187
+ isProtocolDated(view) {
1188
+ const protocolUntil = view.consensus?.valid_until;
1189
+ return typeof protocolUntil === 'number' && Number.isSafeInteger(protocolUntil) && protocolUntil > 0
1190
+ && view.validUntil === protocolUntil * 1000;
1191
+ }
1119
1192
  isCacheFresh(subject, maxAgeMs) {
1120
1193
  const { checkedAt, validUntil, consensusStatus } = subject.view;
1121
1194
  const now = this.now();
1122
1195
  // A transient fallback can authorize callers, but is not a successful fresh check.
1123
- return !subject.view.refreshFailure && consensusStatus !== 'unavailable' && consensusStatus !== 'not_applicable'
1124
- && checkedAt !== undefined && checkedAt <= now && (validUntil ?? 0) > now
1125
- && now - checkedAt < maxAgeMs;
1196
+ if (subject.view.refreshFailure || consensusStatus === 'unavailable' || consensusStatus === 'not_applicable'
1197
+ || checkedAt === undefined || checkedAt > now || (validUntil ?? 0) <= now)
1198
+ return false;
1199
+ // A relation the protocol dated lives until that date: the SDK re-verifies
1200
+ // both signed originals, the relation version and the archive revision
1201
+ // before serving it, and nobody can extend or shorten it locally. Only an
1202
+ // observation the protocol did not date is bounded by the caller's budget.
1203
+ if (this.isProtocolDated(subject.view))
1204
+ return true;
1205
+ return maxAgeMs === undefined || now - checkedAt < maxAgeMs;
1126
1206
  }
1127
1207
  async withSubjectClient(subjectAid, operation) {
1128
1208
  const subject = this.subject(subjectAid);
@@ -1651,7 +1731,7 @@ export class OwnerResolver {
1651
1731
  authorizationStatus: ownerAid ? 'verified' : 'unavailable', consensusStatus: consensus.status,
1652
1732
  consensus: JSON.parse(JSON.stringify(consensus)),
1653
1733
  profile: subject.view.profile?.sha256 === consensus.agent_md_sha256 ? subject.view.profile : undefined,
1654
- checkedAt, validUntil: checkedAt + (this.options.lifetimeMs ?? OWNERSHIP_CACHE_MAX_AGE_MS),
1734
+ checkedAt, validUntil: ownershipValidity(consensus, checkedAt).validUntil,
1655
1735
  revision: subject.view.revision + (previousOwner !== ownerAid || subject.view.consensusStatus !== consensus.status
1656
1736
  || subject.view.consensus?.relation_version !== consensus.relation_version
1657
1737
  || subject.view.consensus?.lock !== consensus.lock ? 1 : 0),
@@ -1671,7 +1751,7 @@ export class OwnerResolver {
1671
1751
  subject.failures = 0;
1672
1752
  this.clearConfirmedRequest(subject, consensus, ownerAid);
1673
1753
  this.clearResolvedRequests(subject, consensus);
1674
- if (previousOwner !== ownerAid || previousStatus !== consensus.status
1754
+ if (previousConsensus?.owner_aid !== consensus.owner_aid || previousConsensus?.status !== consensus.status
1675
1755
  || previousConsensus?.relation_version !== consensus.relation_version
1676
1756
  || previousConsensus?.lock !== consensus.lock) {
1677
1757
  logOwnershipEvent('consensus.changed', { subjectAid, ownerAid,
@@ -25,9 +25,9 @@
25
25
  * 为什么不读 `/public` 或名录里的转发关系:那些都是会被拷贝、会变的展示信息;
26
26
  * 协议 owner 归属(`ownerResolver`)才是唯一可信判据。
27
27
  */
28
- import { getDaemonOwners, getProtocolOwner } from './ownership/owner-resolver.js';
29
- import { getRoleRank } from '../config/roles.js';
30
- import { ROLE_RANKS } from '../config/role-ranks.js';
28
+ import { getDaemonOwners, getProtocolOwner } from '../ownership/owner-resolver.js';
29
+ import { getRoleRank } from '../../config/roles.js';
30
+ import { ROLE_RANKS } from '../../config/role-ranks.js';
31
31
  const MANAGING_ROLES = new Set(['owner', 'admin']);
32
32
  /**
33
33
  * 查看档的角色下限:member(rank 300)及以上。
@@ -186,6 +186,8 @@ const PACK_OPERATIONS = {
186
186
  // publish 只能发 `pack.json` 里 owner 已声明的事件(runtime.publish 校验),
187
187
  // 等于执行已授权动作;跨 AID 的接收方准入另行判定。
188
188
  publish: 'call',
189
+ // 原生输出卡片通知:分支内另有「仅本 AID owner」的硬校验,这里按 manage 登记。
190
+ 'native-publish': 'manage',
189
191
  'rules:show': 'view',
190
192
  'rules:add': 'manage',
191
193
  'rules:remove': 'manage',
@@ -215,6 +217,8 @@ const PACK_OPERATIONS = {
215
217
  'host:disable': 'switch',
216
218
  'pack:list': 'view',
217
219
  'pack:add': 'manage',
220
+ // update 与 add 同档:都是往 services/ 写脚本,只是多了一步替换。
221
+ 'pack:update': 'manage',
218
222
  'pack:remove': 'manage',
219
223
  'pack:enable': 'manage',
220
224
  'pack:disable': 'manage',
@@ -227,6 +231,29 @@ const PACK_OPERATIONS = {
227
231
  export function packOperationKey(command, action) {
228
232
  return command === 'pack' ? `pack:${action ?? ''}` : command;
229
233
  }
234
+ /**
235
+ * 命令是否已登记。执行器必须在授权**之前**用它拦下未知命令:否则未知命令按
236
+ * fail-closed 落到 `manage`,再碰上目标 AID 不是自己,就会报出 FULLACCESS_REQUIRED
237
+ * 之类的权限错误——调用方会以为命令存在、只是权限不够。
238
+ */
239
+ export function isKnownPackCommand(domain, command, action) {
240
+ return Object.prototype.hasOwnProperty.call(PACK_OPERATIONS[domain], packOperationKey(command, action));
241
+ }
242
+ /**
243
+ * 托管会话未写 `--aid` 时的默认目标:会话自己的 AID。
244
+ *
245
+ * 不能回落到 daemon AID——那是另一个主体,托管会话不写 `--aid` 就被当成跨 AID
246
+ * 操作:`pack list` 列出的是主机的包,管理类命令则报 FULLACCESS_REQUIRED。
247
+ * 主机终端(local-control)没有会话身份,返回 undefined,由各执行器按原逻辑选。
248
+ */
249
+ export function callerDefaultAid(caller) {
250
+ if (caller?.kind !== 'managed')
251
+ return undefined;
252
+ const aid = String(caller.selfAid ?? '').trim();
253
+ if (!aid)
254
+ return undefined;
255
+ return aid.startsWith('@') ? aid.slice(1) : aid;
256
+ }
230
257
  /** 查表得出该命令的操作档位;未登记的一律 `manage`(fail-closed)。 */
231
258
  export function packOperation(domain, command, action) {
232
259
  return PACK_OPERATIONS[domain][packOperationKey(command, action)] ?? 'manage';
@@ -6,12 +6,13 @@
6
6
  * EvolCore 受控命令")。所以安装包必须由 daemon 代写——agent 只负责把包目录放在
7
7
  * 普通工作区里,然后调 `ec events pack add` / `ec services pack add`。
8
8
  *
9
- * 这一层只做文件系统搬运:校验仍由各模块的加载器(pack-loader / pack-manager)在
10
- * reload 时完成,安装时不重复实现一套语义,避免两套规则漂移。
9
+ * 这一层只做文件系统搬运:校验仍由各模块的加载器(pack-loader / pack-manager)完成,
10
+ * 安装时不重复实现一套语义,避免两套规则漂移。调用方通过 `validate` 钩子把**自己的**
11
+ * 加载器传进来,在暂存目录上跑——见 `installPack`。
11
12
  */
12
13
  import fs from 'node:fs';
13
14
  import path from 'node:path';
14
- import { atomicWriteJson } from '../utils/atomic-write.js';
15
+ import { atomicWriteJson } from '../../utils/atomic-write.js';
15
16
  /** 包安装期间的运行时产物:不该被拷进新包,也不该被 `pack add` 覆盖。 */
16
17
  export const PACK_RUNTIME_ENTRIES = new Set(['ledger.jsonl', '.idempotency.jsonl', 'logs', '.state.json', '.index.md']);
17
18
  /** 包名:英文短横线/下划线,防止 `..` 或路径分隔符把写入引出目标根。 */
@@ -48,8 +49,11 @@ function collectFiles(root) {
48
49
  return out;
49
50
  }
50
51
  /**
51
- * 安装一个包:先复制到 `.pending-<rand>`,再整体 rename 到位。
52
+ * 安装一个包:先复制到 `.pending-<rand>`,校验通过后再整体 rename 到位。
52
53
  * 中途失败不会留下半个包(对加载器而言"目录存在但缺文件"= invalid,会污染台账)。
54
+ *
55
+ * 两条落地路径(首次安装 / 残留目录原地写回)都先写暂存目录:只有暂存目录能在
56
+ * rename 之前被校验,而"坏包先落进目标根、等 reload 才判 invalid"正是要堵的洞。
53
57
  */
54
58
  export function installPack(request) {
55
59
  const sourceDir = path.resolve(request.sourceDir);
@@ -73,25 +77,17 @@ export function installPack(request) {
73
77
  const targetDir = path.join(targetRoot, name);
74
78
  // 已安装的判定看 manifest,不看目录是否存在:`pack remove` 会留下归档日志目录,
75
79
  // 那是个"残留目录"而不是"已安装的包",应当允许直接装回去。
76
- if (fs.existsSync(path.join(targetDir, request.manifestFile))) {
80
+ const alreadyInstalled = fs.existsSync(path.join(targetDir, request.manifestFile));
81
+ if (alreadyInstalled && !request.replace) {
77
82
  throw Object.assign(new Error(`pack already installed: ${name} (run "pack remove ${name}" first)`), { code: 'PACK_ALREADY_EXISTS' });
78
83
  }
79
84
  const files = collectFiles(sourceDir);
80
85
  fs.mkdirSync(targetRoot, { recursive: true });
81
- // 残留目录(只有 logs/ 等运行时产物):原地写回,不删目录也不动归档日志。
86
+ // 残留目录(只有 logs/ 等运行时产物):保留目录与归档日志,只写回声明与脚本。
82
87
  //
83
88
  // `.archived` 标记必须一并删掉:两个加载器见到它就直接跳过(pack-loader /
84
89
  // pack-manager),留着它会让"文件都装回来了但包永远不加载",表现像包坏了。
85
- if (fs.existsSync(targetDir)) {
86
- for (const relative of files) {
87
- const destination = path.join(targetDir, relative);
88
- fs.mkdirSync(path.dirname(destination), { recursive: true });
89
- fs.copyFileSync(path.join(sourceDir, relative), destination);
90
- }
91
- fs.rmSync(path.join(targetDir, PACK_ARCHIVED_MARKER), { force: true });
92
- return { pack: name, dir: targetDir, files: files.length, intoArchived: true, ...(migratedFrom ? { migratedFrom } : {}) };
93
- }
94
- // 首次安装:写临时目录再整体 rename,避免中途失败留下半个包。
90
+ const hasResidualDir = !alreadyInstalled && fs.existsSync(targetDir);
95
91
  const pending = path.join(targetRoot, `.pending-${name}-${process.pid}-${Date.now()}`);
96
92
  try {
97
93
  for (const relative of files) {
@@ -99,14 +95,96 @@ export function installPack(request) {
99
95
  fs.mkdirSync(path.dirname(destination), { recursive: true });
100
96
  fs.copyFileSync(path.join(sourceDir, relative), destination);
101
97
  }
102
- fs.renameSync(pending, targetDir);
98
+ // 校验的是"最终形态",所以拿暂存目录而不是源目录:源目录可能还在用旧 manifest 名。
99
+ request.validate?.(pending);
100
+ if (alreadyInstalled) {
101
+ // 更新:**原地覆盖**代码文件,不整目录改名。
102
+ //
103
+ // 为什么不能改名:logs/ 与 ledger.jsonl 正被运行中的包写入,Windows 下带着打开的
104
+ // 手柄去 rename 目录会直接 EPERM(实测 2026-11-21 18:46:rename .backup-.../logs
105
+ // -> aidfinder/logs 失败,pack update 退出码 1)。这些是运行期产物,本就不该跟着
106
+ // 包版本走,所以既不能搬、也不进备份。
107
+ //
108
+ // 备份同样是"拷代码文件"而不是"搬目录",回滚时也就不会碰 logs。
109
+ const backupDir = path.join(targetRoot, `.backup-${name}-${archiveStamp()}-${process.pid}`);
110
+ const oldFiles = collectFiles(targetDir);
111
+ const nextFiles = new Set(files);
112
+ for (const relative of oldFiles) {
113
+ const destination = path.join(backupDir, relative);
114
+ fs.mkdirSync(path.dirname(destination), { recursive: true });
115
+ fs.copyFileSync(path.join(targetDir, relative), destination);
116
+ }
117
+ for (const relative of files) {
118
+ const destination = path.join(targetDir, relative);
119
+ fs.mkdirSync(path.dirname(destination), { recursive: true });
120
+ fs.copyFileSync(path.join(pending, relative), destination);
121
+ }
122
+ // 旧包里被删掉的脚本不留在新包目录里:留着的话"删掉的依赖照样能被 import 到",
123
+ // 本地与线上行为当场分叉。
124
+ for (const relative of oldFiles) {
125
+ if (nextFiles.has(relative))
126
+ continue;
127
+ fs.rmSync(path.join(targetDir, relative), { force: true });
128
+ }
129
+ fs.rmSync(pending, { recursive: true, force: true });
130
+ return {
131
+ pack: name, dir: targetDir, files: files.length, replaced: true, backupDir,
132
+ ...(migratedFrom ? { migratedFrom } : {}),
133
+ };
134
+ }
135
+ if (hasResidualDir) {
136
+ for (const relative of files) {
137
+ const destination = path.join(targetDir, relative);
138
+ fs.mkdirSync(path.dirname(destination), { recursive: true });
139
+ fs.copyFileSync(path.join(pending, relative), destination);
140
+ }
141
+ fs.rmSync(path.join(targetDir, PACK_ARCHIVED_MARKER), { force: true });
142
+ }
143
+ else {
144
+ fs.renameSync(pending, targetDir);
145
+ }
103
146
  }
104
147
  catch (error) {
105
148
  fs.rmSync(pending, { recursive: true, force: true });
106
149
  throw error;
107
150
  }
151
+ if (hasResidualDir) {
152
+ fs.rmSync(pending, { recursive: true, force: true });
153
+ return { pack: name, dir: targetDir, files: files.length, intoArchived: true, ...(migratedFrom ? { migratedFrom } : {}) };
154
+ }
108
155
  return { pack: name, dir: targetDir, files: files.length, ...(migratedFrom ? { migratedFrom } : {}) };
109
156
  }
157
+ /** 更新成功:丢掉旧内容备份。 */
158
+ export function discardPackBackup(backupDir) {
159
+ if (!backupDir)
160
+ return;
161
+ fs.rmSync(backupDir, { recursive: true, force: true });
162
+ }
163
+ /**
164
+ * 更新失败:把备份搬回原位,让包回到更新前的状态。
165
+ *
166
+ * 先删新内容再改名,而不是「把备份里的文件覆盖回去」:后者会把新包里多出来的脚本
167
+ * 留在原地,回滚出来的目录既不是旧版也不是新版。
168
+ */
169
+ export function restorePackBackup(targetDir, backupDir) {
170
+ if (!backupDir || !fs.existsSync(backupDir))
171
+ return false;
172
+ // 备份是"代码文件的拷贝",不是目录搬迁(见 tryInstallPack 更新分支的说明),
173
+ // 所以回滚也只能逐文件还原:删掉新版代码、把旧版拷回来。
174
+ // 绝不 rm -rf targetDir——那会连 logs/ 与台账一起抹掉,回滚不该有这种副作用。
175
+ for (const relative of collectFiles(targetDir)) {
176
+ if (fs.existsSync(path.join(backupDir, relative)))
177
+ continue;
178
+ fs.rmSync(path.join(targetDir, relative), { force: true });
179
+ }
180
+ for (const relative of collectFiles(backupDir)) {
181
+ const destination = path.join(targetDir, relative);
182
+ fs.mkdirSync(path.dirname(destination), { recursive: true });
183
+ fs.copyFileSync(path.join(backupDir, relative), destination);
184
+ }
185
+ fs.rmSync(backupDir, { recursive: true, force: true });
186
+ return true;
187
+ }
110
188
  /** 卸载后在包目录留下的标记文件:加载器据此跳过"只有归档历史"的空壳目录。 */
111
189
  export const PACK_ARCHIVED_MARKER = '.archived';
112
190
  function archiveStamp(now = new Date()) {
@@ -1,6 +1,6 @@
1
1
  import { createHash, randomUUID } from 'crypto';
2
2
  import { hasTrustedPrincipal } from '../auth/authenticated-actor.js';
3
- import { renderActionAsText } from '../interaction-router.js';
3
+ import { renderActionAsText } from '../message/interaction-router.js';
4
4
  import { buildEnvelope, isInteractionSendAccepted, sendInteractionPayload } from '../message/message-utils.js';
5
5
  import { logger } from '../../utils/logger.js';
6
6
  import { summarizeToolInput, summarizeToolInputForAudit } from '../../utils/tool-summary.js';
@@ -247,10 +247,10 @@ function structuredApprovalAuditSummary(input) {
247
247
  .slice(0, 16);
248
248
  return fields.length > 0 ? `input_fields=${fields.join(',')}` : 'input_withheld';
249
249
  }
250
- function requiredApproverRole(policy) {
250
+ function requiredApproverRole(policy, routeKind) {
251
251
  if (policy === 'requester')
252
252
  return 'requester';
253
- if (policy === 'agent_owner')
253
+ if (policy === 'agent_owner' || routeKind === 'handoff')
254
254
  return 'owner';
255
255
  return 'manager';
256
256
  }
@@ -370,21 +370,12 @@ export function planApprovalRoute(challenge, context) {
370
370
  };
371
371
  }
372
372
  const preferredOwner = preferredOriginOwner(context ?? {}, routing, owners);
373
- const handoffCandidates = preferredOwner
374
- ? [preferredOwner]
375
- : challenge.approverPolicy === 'agent_manager'
376
- ? Array.from(new Set([...admins, ...owners]))
377
- : owners;
373
+ const handoffCandidates = preferredOwner ? [preferredOwner] : owners;
378
374
  if (handoffCandidates.length === 0) {
379
- return {
380
- kind: 'unavailable',
381
- reason: challenge.approverPolicy === 'agent_manager'
382
- ? 'no_agent_manager_configured'
383
- : 'no_agent_owner_configured',
384
- };
375
+ return { kind: 'unavailable', reason: 'no_agent_owner_configured' };
385
376
  }
386
- // Manager handoffs prefer the configured admin pool for routine approvals;
387
- // owner-only policies remain restricted to owners. Only one card is sent.
377
+ // Cross-session management approvals require a current Agent Owner.
378
+ // Send one card and keep admin approval confined to eligible local routes.
388
379
  const approverId = handoffCandidates[0];
389
380
  if (!approverId) {
390
381
  return { kind: 'unavailable', reason: 'no_aun_owner_available' };
@@ -776,7 +767,7 @@ export class PermissionGateway {
776
767
  offeredDecisions: choices.offeredDecisions,
777
768
  approverPolicy: challenge.approverPolicy,
778
769
  approvalRouteKind: route.kind,
779
- requiredApproverRole: requiredApproverRole(challenge.approverPolicy),
770
+ requiredApproverRole: requiredApproverRole(challenge.approverPolicy, route.kind),
780
771
  approverOperatorId: route.approverOperatorId,
781
772
  approverChannelKey: route.approverChannelKey,
782
773
  approverPrincipalId: route.approverPrincipalId,
@@ -1089,7 +1080,7 @@ export class PermissionGateway {
1089
1080
  offeredDecisions: choices.offeredDecisions,
1090
1081
  approverPolicy: challenge.approverPolicy,
1091
1082
  approvalRouteKind: route.kind,
1092
- requiredApproverRole: requiredApproverRole(challenge.approverPolicy),
1083
+ requiredApproverRole: requiredApproverRole(challenge.approverPolicy, route.kind),
1093
1084
  approverOperatorId: route.approverOperatorId,
1094
1085
  approverChannelKey: route.approverChannelKey,
1095
1086
  approverPrincipalId: route.approverPrincipalId,