evolcore 0.0.49 → 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 (514) hide show
  1. package/CHANGELOG.md +103 -3
  2. package/bin/ec-build.mjs +60 -0
  3. package/bin/ecmsg.js +64 -57
  4. package/dist/ability/caller/authorization.js +21 -0
  5. package/dist/ability/caller/command.js +173 -0
  6. package/dist/ability/caller/contract.js +117 -0
  7. package/dist/ability/caller/credential-files.js +132 -0
  8. package/dist/ability/caller/daemon.js +183 -0
  9. package/dist/ability/caller/schema-view.js +157 -0
  10. package/dist/ability/caller/service.js +519 -0
  11. package/dist/ability/command-contract.js +5 -0
  12. package/dist/ability/daemon.js +5 -1
  13. package/dist/ability/interop-v1.js +156 -106
  14. package/dist/ability/management.js +1 -0
  15. package/dist/agent-template/jobs.js +79 -3
  16. package/dist/agent-template/runtime.js +459 -47
  17. package/dist/agent-template/service.js +1242 -198
  18. package/dist/agent-template/share.js +103 -0
  19. package/dist/agent-template/tool-runner.js +25 -0
  20. package/dist/agent-template/types.js +10 -2
  21. package/dist/agents/claude/availability.js +94 -0
  22. package/dist/agents/claude/capability-provider.js +154 -0
  23. package/dist/agents/claude/index.js +145 -0
  24. package/dist/agents/{claude-runner.js → claude/runner.js} +78 -166
  25. package/dist/agents/claude/session-file-adapter.js +246 -0
  26. package/dist/agents/codex/app-server-client.js +90 -10
  27. package/dist/agents/codex/availability.js +164 -0
  28. package/dist/agents/codex/capability-provider.js +138 -0
  29. package/dist/agents/codex/cli.js +38 -0
  30. package/dist/agents/codex/index.js +345 -0
  31. package/dist/agents/codex/mcp-elicitation.js +135 -0
  32. package/dist/agents/{codex-runner.js → codex/runner.js} +652 -383
  33. package/dist/agents/codex/session-file-adapter.js +834 -0
  34. package/dist/agents/dsh/availability.js +28 -0
  35. package/dist/agents/dsh/capability-provider.js +56 -0
  36. package/dist/agents/dsh/desktop-locations.ps1 +66 -0
  37. package/dist/agents/dsh/desktop-probe.cjs +37 -0
  38. package/dist/agents/dsh/index.js +98 -0
  39. package/dist/agents/dsh/installation.js +400 -0
  40. package/dist/agents/dsh/resources.js +755 -0
  41. package/dist/agents/dsh/runner.js +1183 -0
  42. package/dist/agents/dsh/runtime/README.md +243 -0
  43. package/dist/agents/dsh/runtime/authorization.js +23 -0
  44. package/dist/agents/dsh/runtime/bridge.js +837 -0
  45. package/dist/agents/dsh/runtime/config.js +271 -0
  46. package/dist/agents/dsh/runtime/entry.js +229 -0
  47. package/dist/agents/dsh/runtime/session-inspector.js +340 -0
  48. package/dist/agents/dsh/runtime/tool-policy.js +49 -0
  49. package/dist/agents/dsh/session-file-adapter.js +145 -0
  50. package/dist/agents/ecagent/index.js +215 -0
  51. package/dist/agents/{ecagent-runner.js → ecagent/runner.js} +592 -106
  52. package/dist/agents/ecagent/session-file-adapter.js +134 -0
  53. package/dist/agents/gemini/index.js +96 -0
  54. package/dist/agents/{gemini-runner.js → gemini/runner.js} +18 -23
  55. package/dist/{core/session/adapters/gemini-session-file-adapter.js → agents/gemini/session-file-adapter.js} +2 -2
  56. package/dist/aun/ability-device-routing.js +11 -17
  57. package/dist/aun/aid/agentmd.js +27 -1
  58. package/dist/aun/aid/control-aid.js +52 -32
  59. package/dist/aun/aid/managed-operation.js +6 -4
  60. package/dist/aun/group/invite-service.js +7 -37
  61. package/dist/aun/group/operations.js +6 -0
  62. package/dist/aun/menu/client.js +1 -1
  63. package/dist/aun/msg/history.js +1 -1
  64. package/dist/aun/msg/managed-operation.js +93 -21
  65. package/dist/aun/msg/mention-schema.js +1 -1
  66. package/dist/aun/msg/p2p.js +32 -4
  67. package/dist/aun/msg/upload.js +126 -3
  68. package/dist/aun/service-proxy.js +1 -1
  69. package/dist/aun/storage/index.js +242 -0
  70. package/dist/build-identity.json +1 -1
  71. package/dist/channels/aun.js +698 -213
  72. package/dist/channels/daemon.js +3 -2
  73. package/dist/channels/dingtalk.js +1 -1
  74. package/dist/channels/feishu.js +9 -9
  75. package/dist/channels/qqbot.js +1 -1
  76. package/dist/channels/wechat.js +2 -2
  77. package/dist/channels/wecom.js +1 -1
  78. package/dist/claude-gateway/agent-registration.js +389 -0
  79. package/dist/claude-gateway/binding.js +96 -0
  80. package/dist/claude-gateway/inbox.js +138 -0
  81. package/dist/claude-gateway/index.js +125 -0
  82. package/dist/claude-gateway/listing.js +330 -0
  83. package/dist/claude-gateway/router.js +328 -0
  84. package/dist/claude-gateway/sessions.js +128 -0
  85. package/dist/claude-gateway/terminal.js +250 -0
  86. package/dist/claude-gateway/transcript.js +272 -0
  87. package/dist/claude-gateway/types.js +14 -0
  88. package/dist/cli/ability-command.js +45 -0
  89. package/dist/cli/ability-output.js +182 -0
  90. package/dist/cli/agent-command.js +21 -2
  91. package/dist/cli/agent-create.js +197 -56
  92. package/dist/cli/agent-template.js +400 -27
  93. package/dist/cli/agent.js +105 -11
  94. package/dist/cli/aun-commands.js +237 -123
  95. package/dist/cli/bench.js +5 -2
  96. package/dist/cli/config.js +22 -6
  97. package/dist/cli/daemon-commands.js +283 -109
  98. package/dist/cli/data-command.js +1 -1
  99. package/dist/cli/debug-mode.js +9 -0
  100. package/dist/cli/directory.js +1 -2
  101. package/dist/cli/ecmsg-gateway.js +64 -26
  102. package/dist/cli/fs-command.js +67 -39
  103. package/dist/cli/index.js +45 -12
  104. package/dist/cli/init.js +161 -90
  105. package/dist/cli/managed-command-guard.js +3 -0
  106. package/dist/cli/menu-client.js +32 -7
  107. package/dist/cli/model.js +1 -1
  108. package/dist/cli/pay-command.js +30 -0
  109. package/dist/cli/provider-command.js +6 -2
  110. package/dist/cli/restart-monitor.js +4 -4
  111. package/dist/cli/services-command.js +35 -10
  112. package/dist/cli/skill-command.js +4 -4
  113. package/dist/cli/task-context.js +24 -14
  114. package/dist/cli/team-workspace-command.js +50 -52
  115. package/dist/cli/thread-command.js +81 -14
  116. package/dist/cli/trigger-command.js +47 -12
  117. package/dist/cli/watch-logs.js +2 -1
  118. package/dist/config/access-policy.js +16 -3
  119. package/dist/config/boot-log.js +3 -0
  120. package/dist/config/builtin-role-templates.js +1 -1
  121. package/dist/config/config-field-policy.js +26 -13
  122. package/dist/config/config-manager.js +113 -52
  123. package/dist/config/config-operation-service.js +22 -1
  124. package/dist/config/gateway-config.js +29 -44
  125. package/dist/config/invoke-ipc-service.js +1 -1
  126. package/dist/config/owner-config.js +5 -19
  127. package/dist/config/peer-book-store.js +2 -3
  128. package/dist/config/peer-book.js +2 -2
  129. package/dist/config/peer-role-resolver.js +3 -9
  130. package/dist/config/provider-identity-migration.js +24 -105
  131. package/dist/config/provider-ipc-service.js +13 -3
  132. package/dist/config/provider-local-sync.js +4 -1
  133. package/dist/config/provider-menu-request.js +21 -3
  134. package/dist/config/provider-templates.js +1 -1
  135. package/dist/config/providers-config.js +138 -31
  136. package/dist/config/providers-import.js +3 -3
  137. package/dist/config/providers-management.js +109 -118
  138. package/dist/config/resolved-config-op.js +1 -42
  139. package/dist/config/schema-migration.js +254 -15
  140. package/dist/config/schema-registry.js +53 -8
  141. package/dist/config-store.js +1343 -63
  142. package/dist/core/{agent-application-service.js → agent/agent-application-service.js} +228 -9
  143. package/dist/core/{agent-create-status.js → agent/agent-create-status.js} +112 -4
  144. package/dist/core/{agent-creation-claim.js → agent/agent-creation-claim.js} +3 -3
  145. package/dist/core/{agent-ipc-registration.js → agent/agent-ipc-registration.js} +119 -25
  146. package/dist/core/{agent-reload-coordinator.js → agent/agent-reload-coordinator.js} +65 -0
  147. package/dist/core/{agent-runtime.js → agent/agent-runtime.js} +249 -79
  148. package/dist/core/{evolagent-registry.js → agent/evolagent-registry.js} +23 -18
  149. package/dist/core/{evolagent.js → agent/evolagent.js} +11 -11
  150. package/dist/core/auth/agent-delegation.js +15 -8
  151. package/dist/core/auth/delegation-authorization.js +28 -0
  152. package/dist/core/auth/operation-authorizer.js +20 -2
  153. package/dist/core/auth/operation-catalog.js +80 -8
  154. package/dist/core/baseagent/baseagent-availability.js +197 -0
  155. package/dist/core/baseagent/baseagent-capability-adapter.js +288 -0
  156. package/dist/core/baseagent/baseagent-config-shared.js +56 -0
  157. package/dist/core/baseagent/baseagent-identity.js +68 -0
  158. package/dist/core/{baseagent-loader.js → baseagent/baseagent-loader.js} +89 -6
  159. package/dist/core/baseagent/baseagent-model-defaults.js +26 -0
  160. package/dist/core/baseagent/baseagent-plugin-descriptor.js +357 -0
  161. package/dist/core/baseagent/baseagent-plugin-loader.js +367 -0
  162. package/dist/core/baseagent/baseagent.js +157 -0
  163. package/dist/{agents → core/baseagent}/runner-types.js +36 -4
  164. package/dist/core/capability/capability-manager.js +91 -33
  165. package/dist/core/capability/providers/claude-capability-provider.js +2 -154
  166. package/dist/core/capability/providers/codex-capability-provider.js +2 -136
  167. package/dist/core/{channel-loader.js → channel/channel-loader.js} +226 -38
  168. package/dist/core/{channel-runtime.js → channel/channel-runtime.js} +21 -19
  169. package/dist/core/command/agent-control.js +80 -17
  170. package/dist/core/command/agent-template-menu.js +23 -10
  171. package/dist/core/command/agentmd-menu-request.js +19 -8
  172. package/dist/core/command/agentmd-menu.js +14 -5
  173. package/dist/core/command/cli-intent-parser.js +15 -0
  174. package/dist/core/command/command-handler.js +127 -57
  175. package/dist/core/command/context-policy-menu.js +122 -0
  176. package/dist/core/command/data-root-resolver.js +157 -20
  177. package/dist/core/command/memory-slash.js +6 -6
  178. package/dist/core/command/menu-catalog.js +95 -19
  179. package/dist/core/command/menu-file-path.js +70 -0
  180. package/dist/core/command/menu-handler.js +392 -93
  181. package/dist/core/command/menu-protocol.js +47 -8
  182. package/dist/core/command/menu-query-batch.js +9 -5
  183. package/dist/core/command/private-mention-menu.js +71 -0
  184. package/dist/core/command/provider-menu.js +7 -11
  185. package/dist/core/command/role-menu.js +1 -1
  186. package/dist/core/command/skill-slash.js +17 -5
  187. package/dist/core/command/slash-gate.js +2 -4
  188. package/dist/core/command/slash-handler.js +143 -121
  189. package/dist/core/command/team-workspace-bootstrap.js +2 -1
  190. package/dist/core/command/team-workspace-team.js +3 -3
  191. package/dist/core/command/topic-slash.js +16 -10
  192. package/dist/core/{daemon-bootstrap.js → daemon/daemon-bootstrap.js} +14 -18
  193. package/dist/core/{daemon-control.js → daemon/daemon-control.js} +48 -21
  194. package/dist/core/{daemon-lifecycle.js → daemon/daemon-lifecycle.js} +28 -20
  195. package/dist/core/{host-snapshot.js → daemon/host-snapshot.js} +10 -5
  196. package/dist/core/{ipc-registration.js → daemon/ipc-registration.js} +101 -37
  197. package/dist/core/{lifecycle-notice.js → daemon/lifecycle-notice.js} +4 -5
  198. package/dist/core/file-integrity/store.js +1 -1
  199. package/dist/core/handoff/ipc-registration.js +3 -3
  200. package/dist/core/handoff/runtime.js +2 -2
  201. package/dist/{agents → core/inference}/request-identity.js +2 -2
  202. package/dist/core/inference/text-inference.js +4 -4
  203. package/dist/core/{bootstrap-messages.js → initialization/bootstrap-messages.js} +10 -10
  204. package/dist/core/{bootstrap-service.js → initialization/bootstrap-service.js} +24 -23
  205. package/dist/core/initialization/service.js +57 -9
  206. package/dist/core/invoke/executors/media.js +1 -1
  207. package/dist/core/invoke/executors/text.js +1 -1
  208. package/dist/core/memory/consolidation-context.js +3 -2
  209. package/dist/core/memory/consolidation-trigger.js +9 -3
  210. package/dist/core/memory/consolidation.js +39 -68
  211. package/dist/core/memory/memory-admin.js +6 -6
  212. package/dist/core/memory/memory-writer.js +1 -1
  213. package/dist/core/memory/relation-idle-monitor.js +1 -1
  214. package/dist/core/message/aun-ipc-sender.js +204 -88
  215. package/dist/core/message/aun-request-registry.js +44 -5
  216. package/dist/core/message/auto-mention-gate.js +1 -1
  217. package/dist/core/message/contact-admission.js +1 -1
  218. package/dist/core/message/im-renderer.js +19 -0
  219. package/dist/core/{interaction-router.js → message/interaction-router.js} +131 -1
  220. package/dist/core/message/items-formatter.js +5 -5
  221. package/dist/core/message/message-admission.js +1 -1
  222. package/dist/core/message/message-bridge.js +239 -59
  223. package/dist/core/message/message-log.js +8 -0
  224. package/dist/core/message/message-queue.js +88 -7
  225. package/dist/core/message/message-utils.js +1 -1
  226. package/dist/core/message/peer-mode.js +16 -5
  227. package/dist/core/message/response-engine.js +351 -152
  228. package/dist/core/message/send-options.js +44 -7
  229. package/dist/core/message/send-routing.js +55 -115
  230. package/dist/core/message/stream-idle-monitor.js +1 -1
  231. package/dist/core/{data-migration.js → migration/data-migration.js} +29 -1
  232. package/dist/core/model/catalog-service.js +29 -8
  233. package/dist/core/model/model-capabilities.js +88 -0
  234. package/dist/core/model/model-catalog.js +18 -7
  235. package/dist/core/model/model-diagnostics.js +4 -4
  236. package/dist/core/ownership/owner-resolver.js +107 -101
  237. package/dist/core/{pack-auth.js → pack/pack-auth.js} +34 -3
  238. package/dist/core/{pack-install.js → pack/pack-install.js} +95 -17
  239. package/dist/core/permission/approval-gateway.js +9 -18
  240. package/dist/core/permission/ec-command-parser.js +242 -82
  241. package/dist/core/permission/managed-file.js +234 -0
  242. package/dist/core/permission/protected-paths.js +120 -9
  243. package/dist/core/permission/sandbox-runtime.js +267 -3
  244. package/dist/core/permission/services-path-acl.js +9 -2
  245. package/dist/core/permission/session-path-grants.js +1 -1
  246. package/dist/core/permission/shell-environment.js +15 -1
  247. package/dist/core/permission/tool-policy.js +21 -9
  248. package/dist/core/plugin/plugin-lifecycle.js +442 -0
  249. package/dist/core/session/adapters/claude-session-file-adapter.js +2 -242
  250. package/dist/core/session/adapters/codex-session-file-adapter.js +2 -562
  251. package/dist/core/session/adapters/ecagent-session-file-adapter.js +2 -134
  252. package/dist/core/{background-session → session/background}/session-cleanup.js +2 -2
  253. package/dist/core/{background-session → session/background}/types.js +1 -1
  254. package/dist/core/session/session-file-health.js +2 -272
  255. package/dist/core/session/session-idle-monitor.js +1 -1
  256. package/dist/core/session/session-manager.js +76 -12
  257. package/dist/core/session/session-mapper.js +16 -0
  258. package/dist/core/session/session-terminal.js +185 -0
  259. package/dist/core/session/session-title.js +8 -11
  260. package/dist/core/{system-session → session/system}/memory.js +43 -9
  261. package/dist/core/{system-session → session/system}/registry.js +1 -1
  262. package/dist/core/{system-session → session/system}/types.js +1 -1
  263. package/dist/core/skill/index-generator.js +3 -3
  264. package/dist/core/skill/switch-resolver.js +3 -0
  265. package/dist/core/task/task-activity-store.js +112 -0
  266. package/dist/core/task/task-recovery-service.js +2 -2
  267. package/dist/core/thread/command-parser.js +4 -1
  268. package/dist/core/thread/ipc-operation.js +6 -4
  269. package/dist/core/thread/thread-operation.js +27 -11
  270. package/dist/core/thread/thread-route.js +5 -3
  271. package/dist/core/thread/thread-service.js +307 -58
  272. package/dist/core/thread/topic-id.js +52 -2
  273. package/dist/core/thread/types.js +15 -1
  274. package/dist/directory/{owner-directory-admission.js → admission.js} +3 -3
  275. package/dist/directory/{owner-directory-cache.js → cache.js} +90 -8
  276. package/dist/directory/{owner-directory-markdown.js → markdown.js} +2 -2
  277. package/dist/directory/{owner-directory-query-operation.js → query-operation.js} +83 -9
  278. package/dist/directory/{owner-directory-search.js → search.js} +50 -2
  279. package/dist/directory/{owner-directory-store.js → store.js} +2 -2
  280. package/dist/eck/kit-renderer.js +3 -2
  281. package/dist/eck/manifest-engine.js +64 -2
  282. package/dist/eck/message-renderer.js +35 -0
  283. package/dist/ecweb/basic-settings-service.js +12 -10
  284. package/dist/{contracts → ecweb/contracts}/ecweb-service-protocol.js +2 -1
  285. package/dist/ecweb/dsh-native-service.js +413 -0
  286. package/dist/ecweb/providers-service.js +5 -3
  287. package/dist/ecweb/runtime/lifecycle.js +1 -1
  288. package/dist/ecweb/runtime/supervisor.js +1 -1
  289. package/dist/event-center/center-config.js +2 -2
  290. package/dist/event-center/dispatcher.js +1 -1
  291. package/dist/event-center/ipc-operation.js +12 -3
  292. package/dist/event-center/pack-loader.js +2 -2
  293. package/dist/event-center/registry.js +6 -6
  294. package/dist/event-center/runtime.js +2 -2
  295. package/dist/index.js +181 -77
  296. package/dist/ipc.js +161 -12
  297. package/dist/outputs/authorization.js +27 -0
  298. package/dist/outputs/events.js +10 -1
  299. package/dist/outputs/panel-cards.js +960 -0
  300. package/dist/paths.js +60 -1
  301. package/dist/pay/command.js +38 -0
  302. package/dist/pay/protocol.js +136 -0
  303. package/dist/pay/runtime.js +196 -0
  304. package/dist/pay/service.js +384 -0
  305. package/dist/pay/store.js +81 -0
  306. package/dist/response-system/engines/v1/proactive-flow.js +30 -3
  307. package/dist/services/dispatcher.js +25 -7
  308. package/dist/services/host/main.js +397 -0
  309. package/dist/services/host/protocol.js +125 -0
  310. package/dist/services/host/resident.js +347 -0
  311. package/dist/services/host-client.js +398 -0
  312. package/dist/services/host-deploy.js +180 -0
  313. package/dist/services/host-launch.js +117 -0
  314. package/dist/services/host-recycle.js +208 -0
  315. package/dist/services/host-runtime.js +841 -0
  316. package/dist/services/idempotency.js +44 -86
  317. package/dist/services/index-generator.js +4 -3
  318. package/dist/services/index.js +258 -36
  319. package/dist/services/ipc-operation.js +503 -78
  320. package/dist/services/pack-manager.js +2 -2
  321. package/dist/services/router.js +43 -3
  322. package/dist/services/script-runner.js +541 -100
  323. package/dist/services/service-payload.js +28 -1
  324. package/dist/services/validation.js +136 -5
  325. package/dist/stats/context-usage.js +110 -0
  326. package/dist/stats/model-resolver.js +103 -17
  327. package/dist/stats/query.js +5 -0
  328. package/dist/trigger/application-service.js +9 -6
  329. package/dist/trigger/authorization.js +36 -33
  330. package/dist/trigger/ipc-service.js +4 -4
  331. package/dist/trigger/local-files.js +8 -166
  332. package/dist/trigger/manager.js +2 -2
  333. package/dist/trigger/parser.js +48 -0
  334. package/dist/trigger/scheduler.js +35 -13
  335. package/dist/trigger/script-executor.js +21 -0
  336. package/dist/trigger/script-sandbox.js +77 -232
  337. package/dist/trigger/system-definitions.js +25 -0
  338. package/dist/trigger/validation.js +1 -1
  339. package/dist/utils/aid-bind.js +3 -0
  340. package/dist/utils/atomic-write.js +88 -1
  341. package/dist/utils/cross-platform.js +4 -42
  342. package/dist/utils/error-dict.json +22 -1
  343. package/dist/utils/error-utils.js +193 -6
  344. package/dist/utils/evolcore-version.js +2 -2
  345. package/dist/utils/host-info.js +74 -1
  346. package/dist/utils/logger.js +5 -3
  347. package/dist/utils/media-cache.js +284 -42
  348. package/dist/utils/restart-safety.js +14 -1
  349. package/dist/utils/startup-trace.js +20 -4
  350. package/dist/utils/system-memory.js +113 -25
  351. package/dist/utils/systemd-lifecycle.js +154 -0
  352. package/dist/utils/welcome.js +64 -20
  353. package/dist/utils/windows-shell-trust.js +7 -3
  354. package/ecagent/README.md +35 -0
  355. package/ecagent/dist/agent-loop.js +80 -30
  356. package/ecagent/dist/harness/env/nodejs.d.ts +16 -0
  357. package/ecagent/dist/harness/env/nodejs.js +49 -20
  358. package/ecagent/dist/harness/messages.js +3 -2
  359. package/ecagent/dist/harness/types.d.ts +1 -0
  360. package/ecagent/dist/runtime/types.d.ts +2 -0
  361. package/ecagent/dist/runtime/utils/validation.d.ts +7 -1
  362. package/ecagent/dist/runtime/utils/validation.js +42 -0
  363. package/ecagent/dist/types.d.ts +2 -0
  364. package/kits/docs/INDEX.md +3 -2
  365. package/kits/docs/aun/AUN/346/266/210/346/201/257/347/261/273/345/236/213/344/270/216/345/261/236/346/200/247.md +1 -0
  366. package/kits/docs/channels/aun.md +1 -1
  367. package/kits/docs/channels/feishu.md +1 -1
  368. package/kits/docs/evolcore/INDEX.md +13 -9
  369. package/kits/docs/evolcore/agent-create.md +2 -0
  370. package/kits/docs/evolcore/agent.md +133 -11
  371. package/kits/docs/evolcore/aid.md +39 -6
  372. package/kits/docs/evolcore/config.md +95 -1
  373. package/kits/docs/evolcore/ctl.md +2 -1
  374. package/kits/docs/evolcore/ec-capabilities.md +7 -10
  375. package/kits/docs/evolcore/ecweb-lifecycle.md +5 -1
  376. package/kits/docs/evolcore/event.md +1 -1
  377. package/kits/docs/evolcore/fs.md +49 -3
  378. package/kits/docs/evolcore/group.md +5 -4
  379. package/kits/docs/evolcore/memory-consolidation.md +1 -1
  380. package/kits/docs/evolcore/memory-tags.md +2 -0
  381. package/kits/docs/evolcore/menu-client.md +3 -3
  382. package/kits/docs/evolcore/menu-protocol.md +31 -2
  383. package/kits/docs/evolcore/model.md +12 -1
  384. package/kits/docs/evolcore/msg.md +96 -36
  385. package/kits/docs/evolcore/pay.md +22 -0
  386. package/kits/docs/evolcore/plugin.md +74 -0
  387. package/kits/docs/evolcore/provider.md +29 -2
  388. package/kits/docs/evolcore/rpc.md +2 -2
  389. package/kits/docs/evolcore/services.md +46 -18
  390. package/kits/docs/evolcore/skill.md +17 -1
  391. package/kits/docs/evolcore/stats.md +5 -0
  392. package/kits/docs/evolcore/storage.md +22 -0
  393. package/kits/docs/evolcore/thread-chain.md +20 -9
  394. package/kits/docs/evolcore/tool-authorization.md +14 -0
  395. package/kits/docs/evolcore/trigger.md +89 -13
  396. package/kits/docs/identity/AID_PROFILE_SPEC.md +1 -1
  397. package/kits/docs/venues/feishu-group.md +3 -2
  398. package/kits/docs/venues/feishu-private.md +3 -2
  399. package/kits/rules/01-overview.md +11 -32
  400. package/kits/rules/02-navigation.md +20 -6
  401. package/kits/rules/06-channel.md +20 -4
  402. package/kits/schemas/_meta.json +42 -5
  403. package/kits/schemas/agent-config.schema.21.json +974 -0
  404. package/kits/schemas/agent-config.schema.22.json +977 -0
  405. package/kits/schemas/agent-config.schema.23.json +974 -0
  406. package/kits/schemas/agent-config.schema.24.json +986 -0
  407. package/kits/schemas/agent-config.schema.25.json +986 -0
  408. package/kits/schemas/daemon.schema.10.json +373 -0
  409. package/kits/schemas/daemon.schema.11.json +487 -0
  410. package/kits/schemas/daemon.schema.12.json +505 -0
  411. package/kits/schemas/daemon.schema.9.json +12 -0
  412. package/kits/schemas/defaults.schema.7.json +472 -0
  413. package/kits/schemas/defaults.schema.8.json +484 -0
  414. package/kits/schemas/providers.schema.1.json +1 -1
  415. package/kits/schemas/providers.schema.2.json +1 -1
  416. package/kits/schemas/providers.schema.3.json +26 -4
  417. package/kits/schemas/relation-config.schema.13.json +289 -0
  418. package/kits/skills/.switches.json +17 -1
  419. package/kits/skills/ability/SKILL.md +395 -33
  420. package/kits/skills/ability/STRUCTURE.md +338 -0
  421. package/kits/skills/ability/references/cli.md +208 -0
  422. package/kits/skills/ability/references/development.md +107 -37
  423. package/kits/skills/ability/references/management.md +106 -46
  424. package/kits/skills/ability/references/runtime-protocol.md +65 -63
  425. package/kits/skills/agent-output-cards/SKILL.md +80 -37
  426. package/kits/skills/agent-output-cards/examples/html-surface.json +11 -0
  427. package/kits/skills/agent-output-cards/examples/meeting-followups.json +16 -0
  428. package/kits/skills/agent-output-cards/examples/meeting-latest.json +24 -0
  429. package/kits/skills/agent-output-cards/examples/project-metrics.json +16 -0
  430. package/kits/skills/agent-output-cards/examples/quick-links.json +18 -0
  431. package/kits/skills/agent-output-cards/examples/surface.html +8 -0
  432. package/kits/skills/agent-template-project/SKILL.md +51 -0
  433. package/kits/skills/agent-template-project/references/01-collect-and-pack.md +174 -0
  434. package/kits/skills/agent-template-project/references/02-upload-and-share.md +109 -0
  435. package/kits/skills/agent-template-project/references/03-download-and-install.md +189 -0
  436. package/kits/skills/agent-template-project/references/04-upgrade-and-recovery.md +74 -0
  437. package/kits/skills/agent-template-project/references/05-publish-to-platform.md +62 -0
  438. package/kits/skills/ec-group/SKILL.md +8 -6
  439. package/kits/skills/ec-group/TASK.md +186 -0
  440. package/kits/skills/ec-group/WORKLOG.md +180 -0
  441. package/kits/skills/ec-group-collaboration/SKILL.md +5 -5
  442. package/kits/skills/ec-identity/SKILL.md +9 -6
  443. package/kits/skills/ec-pay/SKILL.md +223 -0
  444. package/kits/skills/ec-provider/SKILL.md +6 -6
  445. package/kits/skills/{ec-service-proxy → ec-proxy}/SKILL.md +8 -5
  446. package/kits/skills/ec-service-call/SKILL.md +138 -0
  447. package/kits/skills/ec-service-pack/SKILL.md +277 -0
  448. package/kits/skills/ec-skill/SKILL.md +25 -9
  449. package/kits/skills/ec-skill/scripts/cli.mjs +7 -7
  450. package/kits/skills/ec-skill/scripts/skill.mjs +55 -41
  451. package/kits/skills/ec-skill/scripts/template/SKILL.md.tmpl +9 -0
  452. package/kits/skills/ec-trigger/SKILL.md +3 -3
  453. package/kits/skills/personal-assistant/SKILL.md +22 -22
  454. package/kits/skills/personal-assistant/references/03-data-flow-and-gaps.md +1 -1
  455. package/kits/skills/scrapling-article-fetch/SKILL.md +5 -5
  456. package/kits/skills/thread-ops/SKILL.md +19 -9
  457. package/kits/skills/wechat-article-media-download/SKILL.md +2 -2
  458. package/kits/skills/wechat-article-reader/SKILL.md +2 -2
  459. package/kits/templates/memory-consolidation/notes.md +2 -2
  460. package/kits/templates/memory-consolidation/workflow.md +46 -0
  461. package/kits/templates/system-fragments/channel.md +13 -4
  462. package/kits/templates/system-fragments/commands.md +5 -4
  463. package/kits/templates/system-fragments/personal-assistant.md +2 -2
  464. package/kits/templates/system-fragments/reply.md +15 -9
  465. package/kits/templates/system-fragments/session.md +2 -2
  466. package/kits/templates/system-fragments/thread.md +30 -127
  467. package/kits/templates/system-fragments/venue.md +16 -0
  468. package/package.json +7 -7
  469. package/scripts/agent-template/index.mjs +7 -1
  470. package/scripts/agent-template/inspect.mjs +99 -39
  471. package/scripts/agent-template/overlay.mjs +126 -2
  472. package/scripts/agent-template/shared/common.mjs +49 -5
  473. package/scripts/agent-template/shared/plan.mjs +4 -2
  474. package/scripts/agent-template/shared/service-packs.mjs +104 -0
  475. package/scripts/agent-template/shared/team-schema.json +468 -39
  476. package/scripts/agent-template/shared/template-contract.mjs +93 -51
  477. package/scripts/agent-template/shared/template-package.mjs +225 -44
  478. package/scripts/agent-template/shared/template-runtime.mjs +137 -15
  479. package/scripts/agent-template/shared/template.mjs +31 -8
  480. package/scripts/agent-template/team-pack.mjs +528 -56
  481. package/scripts/agent-template/team-preview.mjs +102 -9
  482. package/scripts/aid-batch/identity-batch.mjs +1 -1
  483. package/dist/agents/baseagent-availability.js +0 -152
  484. package/dist/agents/baseagent.js +0 -750
  485. package/dist/agents/codex/catalog.js +0 -80
  486. package/dist/agents/ecagent-plugin-lazy.js +0 -41
  487. package/dist/agents/tool-time-context.js +0 -55
  488. package/dist/core/legacy-rename.js +0 -41
  489. package/dist/core/plugin-lifecycle.js +0 -137
  490. package/dist/core/rate-window.js +0 -53
  491. package/dist/core/runner-reload-transaction.js +0 -60
  492. package/dist/core/runtime-lock.js +0 -90
  493. package/dist/core/soul.js +0 -66
  494. package/dist/core/system-session/grants.js +0 -40
  495. package/dist/directory/owner-directory-agentmd-sync.js +0 -89
  496. package/dist/directory/owner-directory-request-operation.js +0 -79
  497. package/dist/directory/owner-directory-text.js +0 -60
  498. package/kits/docs/aun/ABILITY_CALLING.md +0 -280
  499. package/kits/docs/evolcore/ability.md +0 -185
  500. package/kits/skills/ability/references/calling.md +0 -56
  501. package/kits/skills/ability/references/contract-checklist.md +0 -37
  502. package/kits/skills/ability/references/recovery.md +0 -27
  503. /package/dist/{core/capability/providers/gemini-capability-provider.js → agents/gemini/capability-provider.js} +0 -0
  504. /package/dist/core/{system-channels.js → channel/system-channels.js} +0 -0
  505. /package/dist/core/{daemon-file-cache.js → daemon/daemon-file-cache.js} +0 -0
  506. /package/dist/core/{event-bus.js → event/event-bus.js} +0 -0
  507. /package/dist/core/{event-catalog.js → event/event-catalog.js} +0 -0
  508. /package/dist/core/{pack-ledger.js → pack/pack-ledger.js} +0 -0
  509. /package/dist/directory/{owner-directory-identity.js → identity.js} +0 -0
  510. /package/dist/directory/{owner-directory-policy.js → policy.js} +0 -0
  511. /package/dist/directory/{owner-directory-remarks.js → remarks.js} +0 -0
  512. /package/dist/directory/{owner-directory-scope.js → scope.js} +0 -0
  513. /package/dist/{contracts → ecweb/contracts}/ecweb-instance.js +0 -0
  514. /package/kits/templates/{bootstrap-welcome.md → bootstrap-intro.md} +0 -0
@@ -1,16 +1,16 @@
1
- import { initializationSummary, readInitialization } from '../cli/agent-create.js';
1
+ import { initializationSummary, readInitialization } from '../../cli/agent-create.js';
2
2
  import fs from 'node:fs';
3
3
  import path from 'node:path';
4
- import { agentMdPath, resolvePaths, } from '../paths.js';
5
- import { loadAgent, saveAgent, } from '../config-store.js';
6
- import { ConfigTarget, assertAgentAidAvailable, assertAgentModelConfigured, ensureFile as cfgEnsure, initConfigManager, notifyConfigWrite, read as cfgRead, resolveEffective, write as cfgWrite, } from '../config/config-manager.js';
7
- import { executeResolvedConfigCommand, } from '../config/config-operation-service.js';
8
- import { resolveConfigCommand } from '../config/resolved-config-op.js';
4
+ import { agentMdPath, resolvePaths, } from '../../paths.js';
5
+ import { loadAgent, saveAgent, previewAgentProjectChange, agentProjectChangeView, applyAgentProjectChange, assertAgentProjectChangeReady, acknowledgeAgentProjectStart, agentProjectChangeGate, saveAgentProjectChange, registerAgentProjectChange, advanceAgentProjectChange, prepareAgentProjectChange, addAgentProjectIssue, resolveAgentProjectConflict, latestAgentProjectChange, suspendAgentProjectIssue, relatedAgentProjects, } from '../../config-store.js';
6
+ import { ConfigTarget, assertAgentAidAvailable, assertAgentModelConfigured, ensureFile as cfgEnsure, initConfigManager, notifyConfigWrite, read as cfgRead, resolveEffective, write as cfgWrite, } from '../../config/config-manager.js';
7
+ import { executeResolvedConfigCommand, } from '../../config/config-operation-service.js';
8
+ import { resolveConfigCommand } from '../../config/resolved-config-op.js';
9
9
  import { AgentReloadBusyError } from './agent-reload-coordinator.js';
10
- import { assertTemplateInstallationReady } from '../agent-template/jobs.js';
11
- import { logger } from '../utils/logger.js';
10
+ import { assertTemplateInstallationReady } from '../../agent-template/jobs.js';
11
+ import { logger } from '../../utils/logger.js';
12
12
  import { initializationCreateProgress, initializationOwnership, removeAgentFiles } from './agent-create-status.js';
13
- import { resolveRuntimeBaseagentModelSelection } from '../agents/baseagent.js';
13
+ import { resolveRuntimeBaseagentModelSelection } from '../baseagent/baseagent.js';
14
14
  function toPosix(value) {
15
15
  if (!value)
16
16
  return null;
@@ -67,6 +67,212 @@ function assertAgentConfigMissing(aid) {
67
67
  */
68
68
  export class AgentApplicationService {
69
69
  deps;
70
+ projectWork;
71
+ async project(aid, actor, args) {
72
+ let work;
73
+ try {
74
+ const operation = args?.operation;
75
+ const allowed = ['aid', 'operation', ...(['preview', 'move'].includes(operation) ? ['target', 'aids'] : []),
76
+ ...(operation === 'resolve' ? ['conflictId', 'decision'] : [])];
77
+ if (!actor || !['preview', 'move', 'status', 'recover', 'resolve'].includes(operation)
78
+ || Object.keys(args).some(key => !allowed.includes(key)) || args.aid !== undefined && args.aid !== aid
79
+ || ['preview', 'move'].includes(operation) && (typeof args.target !== 'string' || !path.isAbsolute(args.target))
80
+ || args.aids !== undefined && (!Array.isArray(args.aids) || !args.aids.length || args.aids.some((value) => typeof value !== 'string'))
81
+ || operation === 'resolve' && (typeof args.conflictId !== 'string' || !['skip', 'abort'].includes(args.decision))) {
82
+ return { ok: false, code: 'INVALID_ARGUMENT', error: 'Use preview/move with target and optional aids, status/recover, or resolve with conflictId and decision=skip|abort' };
83
+ }
84
+ const runtime = this.deps.registry.get(aid);
85
+ if (!runtime)
86
+ return { ok: false, code: 'NOT_FOUND', error: 'Agent not found' };
87
+ const idle = () => ({ ok: true, aid, source: runtime.projectPath, target: runtime.projectPath, status: 'idle',
88
+ currentStep: 0, totalSteps: 7, relatedAgents: relatedAgentProjects(path.resolve(runtime.projectPath))
89
+ .map(row => ({ ...row, status: this.deps.registry.get(row.aid)?.status ?? 'unknown', selected: row.aid === aid })) });
90
+ if (operation === 'status') {
91
+ const active = this.projectWork;
92
+ if (active?.aid === aid || active?.plan?.affectedAids?.includes(aid))
93
+ return active.plan
94
+ ? { ok: true, ...agentProjectChangeView(active.plan) }
95
+ : { ...idle(), target: active.target, status: 'running', currentStep: 1, currentPhase: 'checking' };
96
+ const recorded = latestAgentProjectChange(aid);
97
+ return recorded ? { ok: true, ...agentProjectChangeView(recorded),
98
+ ...(recorded.status === 'running' ? { status: 'paused', error: 'Daemon interrupted; recover the original bindings' } : {}) } : idle();
99
+ }
100
+ if (operation === 'preview') {
101
+ if (this.projectWork)
102
+ return { ok: false, code: 'AGENT_BUSY', error: 'Another migration is active' };
103
+ const plan = await previewAgentProjectChange({ aid, actor, currentProject: runtime.projectPath, target: args.target, aids: args.aids });
104
+ const relatedAgents = await Promise.all(plan.relatedAgents.map(async (related) => {
105
+ const selected = plan.affectedAids.includes(related.aid);
106
+ const allowed = this.deps.authorizeProjectAgent ? await this.deps.authorizeProjectAgent(related.aid, actor) : true;
107
+ return { ...related, selected, allowed, status: this.deps.registry.get(related.aid)?.status ?? 'unknown',
108
+ ...(!allowed ? { reason: 'Fresh Agent Owner consensus required' } : {}) };
109
+ }));
110
+ return { ok: true, ...agentProjectChangeView(plan), relatedAgents };
111
+ }
112
+ if (this.projectWork?.running)
113
+ return { ok: false, code: 'AGENT_BUSY', error: 'Migration is running; query status' };
114
+ if (operation === 'move') {
115
+ if (this.projectWork)
116
+ return { ok: false, code: 'AGENT_BUSY', error: 'Resolve the pending migration first' };
117
+ if (path.resolve(args.target) === path.resolve(runtime.projectPath)) {
118
+ const previous = latestAgentProjectChange(aid);
119
+ if (previous?.status === 'succeeded' && previous.target === path.resolve(args.target)
120
+ && JSON.stringify([...(args.aids ?? [aid])].sort()) === JSON.stringify(previous.affectedAids ?? [aid]))
121
+ return { ok: true, ...agentProjectChangeView(previous) };
122
+ }
123
+ work = { aid, target: args.target, running: true, releases: new Map() };
124
+ this.projectWork = work;
125
+ work.plan = await previewAgentProjectChange({ aid, actor, currentProject: runtime.projectPath,
126
+ target: args.target, aids: args.aids, deferInventory: true });
127
+ work.plan.protectedAids = [];
128
+ for (const selected of work.plan.affectedAids) {
129
+ const authorized = this.deps.authorizeProjectAgent ? await this.deps.authorizeProjectAgent(selected, actor) : true;
130
+ if (authorized)
131
+ work.plan.protectedAids.push(selected);
132
+ else
133
+ addAgentProjectIssue(work.plan, 'authorization:' + selected, selected, ['agent:' + selected], 'NOT_ALLOWED', '该 Agent 的 Owner 权限不足或已改变,跳过将排除它', 'agent');
134
+ }
135
+ for (const selected of work.plan.affectedAids)
136
+ assertAgentProjectChangeReady(selected, true);
137
+ registerAgentProjectChange(work.plan);
138
+ advanceAgentProjectChange(work.plan, 1);
139
+ }
140
+ else {
141
+ if (this.projectWork && this.projectWork.aid !== aid && !this.projectWork.plan?.affectedAids?.includes(aid)) {
142
+ return { ok: false, code: 'AGENT_BUSY', error: 'Another migration is active' };
143
+ }
144
+ const recorded = this.projectWork?.plan ?? latestAgentProjectChange(aid);
145
+ if (!recorded)
146
+ return idle();
147
+ if (recorded.actor !== actor)
148
+ return { ok: false, code: 'NOT_ALLOWED', error: 'Migration belongs to another actor' };
149
+ if (operation === 'recover' && !['running', 'paused', 'awaiting_decision'].includes(recorded.status))
150
+ return { ok: true, ...agentProjectChangeView(recorded) };
151
+ if (this.projectWork && this.projectWork.aid !== recorded.aid)
152
+ return { ok: false, code: 'AGENT_BUSY', error: 'Another migration is active' };
153
+ work = this.projectWork ?? { aid: recorded.aid, target: recorded.target, plan: recorded, running: true, releases: new Map() };
154
+ this.projectWork = work;
155
+ work.running = true;
156
+ }
157
+ const plan = work.plan;
158
+ const hasCoreWrites = (selected) => plan.resources?.some(row => (row.changed || row.kind === 'file' && row.created)
159
+ && row.groups.some(group => group === 'agent:' + selected || plan.groups?.[group]?.aid === selected));
160
+ if (operation === 'resolve') {
161
+ if (plan.pendingConflict?.id !== args.conflictId || plan.status !== 'awaiting_decision') {
162
+ return { ok: false, code: 'STALE_CONFLICT', error: 'Conflict expired; query status' };
163
+ }
164
+ }
165
+ // Recheck ownership before every mutation or decision, including after a page reconnect.
166
+ for (const selected of plan.affectedAids ?? [plan.aid]) {
167
+ if (plan.skippedAgents?.includes(selected))
168
+ continue;
169
+ const authorized = this.deps.authorizeProjectAgent ? await this.deps.authorizeProjectAgent(selected, actor) : true;
170
+ if (!authorized) {
171
+ if (hasCoreWrites(selected)) {
172
+ plan.status = 'paused';
173
+ plan.error = 'Owner authorization changed after core writes: ' + selected;
174
+ saveAgentProjectChange(plan);
175
+ return { ok: false, code: 'NOT_ALLOWED', error: plan.error };
176
+ }
177
+ if (operation === 'recover' || operation === 'resolve' && args.decision === 'abort') {
178
+ plan.skippedAgents = [...new Set([...(plan.skippedAgents ?? []), selected])];
179
+ continue;
180
+ }
181
+ addAgentProjectIssue(plan, 'authorization:' + selected, selected, ['agent:' + selected], 'NOT_ALLOWED', '该 Agent 的 Owner 权限不足或已改变,跳过将排除它', 'agent');
182
+ }
183
+ }
184
+ if (!this.deps.projectGate)
185
+ return { ok: false, code: 'NOT_CONFIGURED', error: 'Project mutation gate unavailable' };
186
+ if (operation !== 'recover' && !(operation === 'resolve' && args.decision === 'abort'))
187
+ advanceAgentProjectChange(plan, plan.currentStep < 3 ? 2 : plan.currentStep);
188
+ for (const selected of plan.affectedAids ?? [plan.aid]) {
189
+ if (plan.skippedAgents?.includes(selected) || work.releases.has(selected)
190
+ || plan.protectedAids && !plan.protectedAids.includes(selected))
191
+ continue;
192
+ const candidate = this.deps.registry.get(selected);
193
+ if (!candidate || !['stopped', 'disabled', ...(operation === 'recover' || operation === 'resolve' ? ['error'] : [])].includes(candidate.status)) {
194
+ if ((operation === 'recover' || operation === 'resolve') && hasCoreWrites(selected)) {
195
+ throw Object.assign(new Error('Stop this Agent before restoring core resources: ' + selected), { code: 'AGENT_NOT_STOPPED' });
196
+ }
197
+ addAgentProjectIssue(plan, 'freeze:' + selected, selected, ['agent:' + selected], 'AGENT_NOT_STOPPED', 'Agent 尚未停止,跳过将排除该 Agent: ' + selected, 'agent');
198
+ continue;
199
+ }
200
+ try {
201
+ work.releases.set(selected, await this.deps.projectGate(selected, plan.planId));
202
+ }
203
+ catch (error) {
204
+ if (operation === 'recover' || operation === 'resolve' && (args.decision === 'abort' || hasCoreWrites(selected)))
205
+ throw error;
206
+ addAgentProjectIssue(plan, 'freeze:' + selected, selected, ['agent:' + selected], error.code ?? 'AGENT_BUSY', '无法冻结 Agent: ' + selected + ': ' + String(error), 'agent');
207
+ }
208
+ }
209
+ if (operation === 'recover')
210
+ await applyAgentProjectChange(plan, 'rollback');
211
+ else {
212
+ if (operation === 'resolve') {
213
+ await resolveAgentProjectConflict(plan, args.conflictId, args.decision);
214
+ for (const selected of plan.skippedAgents ?? []) {
215
+ const release = work.releases.get(selected);
216
+ if (release) {
217
+ await release();
218
+ work.releases.delete(selected);
219
+ }
220
+ }
221
+ }
222
+ if (plan.status !== 'rolled_back') {
223
+ if (suspendAgentProjectIssue(plan))
224
+ return { ok: true, ...agentProjectChangeView(plan) };
225
+ if (!plan.inventoryReady) {
226
+ advanceAgentProjectChange(plan, 3);
227
+ await prepareAgentProjectChange(plan);
228
+ saveAgentProjectChange(plan);
229
+ }
230
+ await applyAgentProjectChange(plan, 'apply');
231
+ }
232
+ }
233
+ return { ok: true, ...agentProjectChangeView(plan) };
234
+ }
235
+ catch (error) {
236
+ if (work?.plan) {
237
+ work.plan.status = 'paused';
238
+ work.plan.error = String(error);
239
+ try {
240
+ saveAgentProjectChange(work.plan);
241
+ }
242
+ catch (saveError) {
243
+ logger.error('[Agent project] Recovery record could not be saved: ' + String(saveError));
244
+ }
245
+ }
246
+ return errorFrom(error);
247
+ }
248
+ finally {
249
+ if (work) {
250
+ work.running = false;
251
+ for (const selected of work.plan?.affectedAids ?? []) {
252
+ try {
253
+ const runtime = this.deps.registry.get(selected), config = this.readConfig(selected);
254
+ if (runtime && config)
255
+ runtime.swapConfig?.(config, resolveEffective({ self: selected }, { cache: false }));
256
+ }
257
+ catch (error) {
258
+ logger.error('[Agent project] Cannot refresh Agent: ' + String(error));
259
+ }
260
+ }
261
+ if (work.plan?.status !== 'awaiting_decision' && work.plan?.status !== 'paused') {
262
+ for (const release of [...work.releases.values()].reverse()) {
263
+ try {
264
+ await release();
265
+ }
266
+ catch (error) {
267
+ logger.error('[Agent project] Cannot release runtime hold: ' + String(error));
268
+ }
269
+ }
270
+ if (this.projectWork === work)
271
+ this.projectWork = undefined;
272
+ }
273
+ }
274
+ }
275
+ }
70
276
  initialization;
71
277
  setInitializationService(service) { this.initialization = service; }
72
278
  constructor(deps) {
@@ -236,6 +442,16 @@ export class AgentApplicationService {
236
442
  }
237
443
  async start(aid) {
238
444
  try {
445
+ if (this.projectWork?.plan?.affectedAids?.includes(aid) || this.projectWork?.aid === aid)
446
+ return { ok: false, code: 'AGENT_BUSY', error: 'Resolve or recover the pending migration first' };
447
+ if (agentProjectChangeGate(aid)) {
448
+ if (this.readConfig(aid)?.enabled === false)
449
+ return { ok: false, code: 'AGENT_DISABLED', error: 'Enable this Agent explicitly before starting' };
450
+ assertAgentProjectChangeReady(aid, true);
451
+ acknowledgeAgentProjectStart(aid);
452
+ const result = await this.reload(aid);
453
+ return result.ok ? { ok: true, aid } : result;
454
+ }
239
455
  if (!this.deps.registry.startAgent)
240
456
  return { ok: false, error: 'startAgent unavailable', code: 'NOT_CONFIGURED' };
241
457
  await this.deps.registry.startAgent(aid, this.deps.hooks);
@@ -250,6 +466,7 @@ export class AgentApplicationService {
250
466
  if (!this.deps.registry.stopAgent)
251
467
  return { ok: false, error: 'stopAgent unavailable', code: 'NOT_CONFIGURED' };
252
468
  await this.deps.registry.stopAgent(aid, this.deps.hooks);
469
+ this.deps.interruptProjectAgent?.(aid);
253
470
  return { ok: true, aid };
254
471
  }
255
472
  catch (error) {
@@ -294,6 +511,8 @@ export class AgentApplicationService {
294
511
  await this.deps.beforeAgentOperation?.(aid);
295
512
  guard?.();
296
513
  if (enabled) {
514
+ assertAgentProjectChangeReady(aid, true);
515
+ acknowledgeAgentProjectStart(aid);
297
516
  assertAgentAidAvailable(aid);
298
517
  assertTemplateInstallationReady(aid);
299
518
  }
@@ -1,12 +1,13 @@
1
1
  /** Agent 创建状态、初始化进度投影与删除后的磁盘清理。 */
2
2
  import fs from 'fs';
3
- import { templateInstallationGate } from '../agent-template/jobs.js';
3
+ import { templateInstallationGate } from '../../agent-template/jobs.js';
4
4
  import path from 'path';
5
5
  import { randomUUID } from 'node:crypto';
6
- import { creationOwnershipBinding } from './ownership/owner-resolver.js';
6
+ import { creationOwnershipBinding } from '../ownership/owner-resolver.js';
7
7
  import { removeAgentCreationClaim, updateAgentCreationClaim } from './agent-creation-claim.js';
8
- import { resolvePaths } from '../paths.js';
9
- import { removeRegisteredFile } from './file-integrity/store.js';
8
+ import { resolvePaths } from '../../paths.js';
9
+ import { removeRegisteredFile } from '../file-integrity/store.js';
10
+ import { buildEnvelope } from '../message/message-utils.js';
10
11
  const FILE = 'create-status.json';
11
12
  export function readCreateStatus(agentDir) {
12
13
  try {
@@ -17,6 +18,11 @@ export function readCreateStatus(agentDir) {
17
18
  return null;
18
19
  }
19
20
  }
21
+ /** Public progress views must not expose the local session route used for card delivery. */
22
+ export function createStatusView(status) {
23
+ const { origin: _origin, ...safe } = status;
24
+ return safe;
25
+ }
20
26
  /** 删除构建进度文件(agent 删除时清理)。非 purge 删除只移除 config.json,
21
27
  * 故需显式清理本文件,避免目录残留陈旧进度。 */
22
28
  export function removeCreateStatus(agentDir) {
@@ -67,6 +73,14 @@ export class CreateStatusWriter {
67
73
  this.status.ownershipBinding = expected;
68
74
  this.flush();
69
75
  }
76
+ setOwnershipApproval(delivery) {
77
+ if (delivery.operationId !== `agent-owner-bind:${this.creationId}:${this.status.ownershipBinding?.operationId}`
78
+ || !this.status.ownershipBinding) {
79
+ throw new Error('Ownership approval delivery does not match the creation binding');
80
+ }
81
+ this.status.ownershipApproval = delivery;
82
+ this.flush();
83
+ }
70
84
  async finishReady() {
71
85
  this.status.status = 'ready';
72
86
  this.status.currentPhase = null;
@@ -177,6 +191,7 @@ export function initializationCreateProgress(record, lifecycle, configOperationI
177
191
  aid: record.plan.aid, creationId: record.creationId, requesterAid: record.requesterAid,
178
192
  ownerAid: record.plan.ownerAid,
179
193
  ...(record.ownershipBinding ? { ownershipBinding: record.ownershipBinding } : {}),
194
+ ...(record.ownershipApproval ? { ownershipApproval: record.ownershipApproval } : {}),
180
195
  status: ready ? 'ready' : failed ? 'failed' : 'in_progress',
181
196
  currentPhase: ready || failed ? null : phase, initializationPhase: record.phase,
182
197
  steps: progressSteps(record, phase, ready, failed),
@@ -202,3 +217,96 @@ export function initializationOwnership(record) {
202
217
  ...(consensus?.retryable !== undefined ? { retryable: consensus.retryable } : {}),
203
218
  };
204
219
  }
220
+ export function resolveAgentCreationOrigin(input) {
221
+ const creatorAid = input.creatorAid.trim().toLowerCase();
222
+ const ownerAid = input.ownerAid.trim().toLowerCase();
223
+ if (!creatorAid || input.actorAid?.trim().toLowerCase() !== ownerAid
224
+ || input.channelType !== 'aun' || input.chatType !== 'private'
225
+ || input.channelId.trim().toLowerCase() !== ownerAid || !input.sessionId.trim())
226
+ return undefined;
227
+ return {
228
+ creatorAid,
229
+ ownerAid,
230
+ channel: 'aun',
231
+ channelId: ownerAid,
232
+ sessionId: input.sessionId,
233
+ ...(input.threadId ? { threadId: input.threadId } : {}),
234
+ };
235
+ }
236
+ export function buildAgentCreationOwnershipCard(input) {
237
+ const { creationId, binding, origin } = input;
238
+ if (binding.source !== 'agent_create' || binding.operation !== 'bind'
239
+ || binding.subjectAid === binding.ownerAid || binding.ownerAid !== origin.ownerAid
240
+ || !(/^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i.test(creationId)
241
+ || /^init-[a-f0-9]{24}$/.test(creationId))) {
242
+ throw new Error('Agent creation approval context does not match the Ownership binding');
243
+ }
244
+ return {
245
+ type: 'action_card',
246
+ schema_version: 1,
247
+ card_kind: 'ownership_bind_request',
248
+ title: '新 Agent 的所有权绑定待确认',
249
+ text: `Agent ${binding.subjectAid} 已向你提交初始所有权绑定请求。请在 Evol App 的 Ownership 审批中核对并处理。\n\n请求 ID:${binding.operationId}`,
250
+ actions: [{
251
+ label: '打开 Ownership 审批',
252
+ value: 'ownership.open_request',
253
+ behavior: 'reply',
254
+ style: 'primary',
255
+ }],
256
+ ownership_binding: {
257
+ source: binding.source,
258
+ operation: binding.operation,
259
+ operation_id: binding.operationId,
260
+ sub_aid: binding.subjectAid,
261
+ owner_aid: binding.ownerAid,
262
+ base_relation_version: binding.baseRelationVersion,
263
+ target_relation_version: binding.targetRelationVersion,
264
+ },
265
+ creation: {
266
+ creation_id: creationId,
267
+ creator_aid: origin.creatorAid,
268
+ owner_aid: origin.ownerAid,
269
+ },
270
+ expires_at_ms: Date.now() + 7 * 24 * 60 * 60 * 1000,
271
+ };
272
+ }
273
+ /** Deliver a review card to the authenticated Owner conversation that created the Agent. */
274
+ export async function sendAgentCreationOwnershipCard(input) {
275
+ const { adapter, creationId, binding, origin } = input;
276
+ if (origin.channel !== 'aun' || adapter.channelKey && !adapter.channelKey.startsWith('aun#')) {
277
+ throw new Error('Agent creation Ownership cards require the original AUN conversation');
278
+ }
279
+ const operationId = `agent-owner-bind:${creationId}:${binding.operationId}`;
280
+ const replyContext = {
281
+ sessionId: origin.sessionId,
282
+ threadId: origin.threadId,
283
+ localTopicId: origin.threadId,
284
+ delivery: { chatType: 'private' },
285
+ metadata: { source: 'daemon', encrypted: true },
286
+ };
287
+ const envelope = buildEnvelope({
288
+ taskId: operationId,
289
+ operationId,
290
+ sessionId: origin.sessionId,
291
+ channel: adapter.channelName,
292
+ channelId: origin.ownerAid,
293
+ agentName: origin.creatorAid,
294
+ delivery: { chatType: 'private' },
295
+ replyContext,
296
+ });
297
+ const result = await adapter.send(envelope, {
298
+ kind: 'custom',
299
+ channelType: 'aun',
300
+ payload: buildAgentCreationOwnershipCard({ creationId, binding, origin }),
301
+ });
302
+ if (!result)
303
+ return { status: 'sent', operationId };
304
+ if (result.status === 'sent')
305
+ return { status: 'sent', operationId, messageId: result.messageId };
306
+ if (result.status === 'queued')
307
+ return { status: 'queued', operationId, outboxId: result.outboxId,
308
+ ...(result.error ? { error: result.error } : {}), ...(result.code !== undefined ? { code: result.code } : {}) };
309
+ return { status: 'failed', operationId,
310
+ error: result.status === 'failed' ? result.error : `Card delivery suppressed: ${result.reason}`,
311
+ ...(result.status === 'failed' && result.code !== undefined ? { code: result.code } : {}) };
312
+ }
@@ -2,9 +2,9 @@ import fs from 'node:fs';
2
2
  import os from 'node:os';
3
3
  import path from 'node:path';
4
4
  import { createHash, randomUUID } from 'node:crypto';
5
- import { agentConfig, agentDataDir, agentDir, aidLocalDir, resolveRoot } from '../paths.js';
6
- import { atomicReplaceJson, withFileLock } from '../utils/atomic-write.js';
7
- import { isProcessRunning } from '../utils/cross-platform.js';
5
+ import { agentConfig, agentDataDir, agentDir, aidLocalDir, resolveRoot } from '../../paths.js';
6
+ import { atomicReplaceJson, withFileLock } from '../../utils/atomic-write.js';
7
+ import { isProcessRunning } from '../../utils/cross-platform.js';
8
8
  export function agentCreationClaimPath(aid) {
9
9
  return path.join(agentDataDir(aid), 'creation-claim.json');
10
10
  }