evolcore 0.0.48 → 0.0.50

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 (302) hide show
  1. package/CHANGELOG.md +97 -0
  2. package/bin/ecmsg.js +9 -4
  3. package/dist/ability/caller/authorization.js +21 -0
  4. package/dist/ability/caller/command.js +164 -0
  5. package/dist/ability/caller/contract.js +102 -0
  6. package/dist/ability/caller/daemon.js +158 -0
  7. package/dist/ability/caller/service.js +380 -0
  8. package/dist/ability/command-contract.js +5 -0
  9. package/dist/ability/daemon.js +5 -1
  10. package/dist/ability/interop-v1.js +10 -3
  11. package/dist/ability/management.js +1 -0
  12. package/dist/agent-template/jobs.js +173 -1
  13. package/dist/agent-template/runtime.js +285 -8
  14. package/dist/agent-template/service.js +1159 -40
  15. package/dist/agent-template/types.js +2 -1
  16. package/dist/agents/baseagent-availability.js +27 -3
  17. package/dist/agents/baseagent-capability-adapter.js +102 -0
  18. package/dist/agents/baseagent-plugin-descriptor.js +274 -0
  19. package/dist/agents/baseagent-plugin-loader.js +145 -0
  20. package/dist/agents/baseagent.js +68 -2
  21. package/dist/agents/claude-gateway/agent-registration.js +389 -0
  22. package/dist/agents/claude-gateway/binding.js +96 -0
  23. package/dist/agents/claude-gateway/inbox.js +138 -0
  24. package/dist/agents/claude-gateway/index.js +125 -0
  25. package/dist/agents/claude-gateway/listing.js +330 -0
  26. package/dist/agents/claude-gateway/router.js +328 -0
  27. package/dist/agents/claude-gateway/sessions.js +128 -0
  28. package/dist/agents/claude-gateway/terminal.js +250 -0
  29. package/dist/agents/claude-gateway/transcript.js +272 -0
  30. package/dist/agents/claude-gateway/types.js +14 -0
  31. package/dist/agents/claude-runner.js +6 -10
  32. package/dist/agents/codex-runner.js +9 -2
  33. package/dist/agents/{gemini-runner.js → gemini/gemini-runner.js} +17 -17
  34. package/dist/{core/session/adapters → agents/gemini}/gemini-session-file-adapter.js +2 -2
  35. package/dist/agents/gemini/index.js +51 -0
  36. package/dist/aun/aid/control-aid.js +52 -32
  37. package/dist/aun/group/invite-service.js +6 -36
  38. package/dist/aun/group/operations.js +6 -0
  39. package/dist/aun/msg/mention-schema.js +1 -1
  40. package/dist/aun/msg/p2p.js +31 -2
  41. package/dist/aun/msg/upload.js +126 -3
  42. package/dist/build-identity.json +1 -1
  43. package/dist/channels/aun.js +1175 -457
  44. package/dist/cli/ability-command.js +42 -0
  45. package/dist/cli/agent-command.js +20 -1
  46. package/dist/cli/agent-create.js +78 -18
  47. package/dist/cli/agent-template.js +5 -3
  48. package/dist/cli/agent.js +91 -0
  49. package/dist/cli/aun-commands.js +92 -34
  50. package/dist/cli/bench.js +5 -2
  51. package/dist/cli/config.js +22 -6
  52. package/dist/cli/daemon-commands.js +245 -101
  53. package/dist/cli/directory.js +6 -1
  54. package/dist/cli/ecmsg-gateway.js +11 -9
  55. package/dist/cli/index.js +30 -5
  56. package/dist/cli/init.js +39 -63
  57. package/dist/cli/managed-command-guard.js +3 -0
  58. package/dist/cli/menu-client.js +32 -7
  59. package/dist/cli/model.js +20 -5
  60. package/dist/cli/pay-command.js +30 -0
  61. package/dist/cli/provider-command.js +6 -2
  62. package/dist/cli/quota.js +89 -0
  63. package/dist/cli/restart-monitor.js +2 -2
  64. package/dist/cli/role.js +1 -0
  65. package/dist/cli/services-command.js +12 -9
  66. package/dist/cli/team-workspace-command.js +56 -2
  67. package/dist/cli/thread-command.js +78 -12
  68. package/dist/config/access-policy.js +16 -3
  69. package/dist/config/config-field-policy.js +88 -9
  70. package/dist/config/config-manager.js +97 -47
  71. package/dist/config/config-operation-service.js +22 -1
  72. package/dist/config/gateway-config.js +9 -8
  73. package/dist/config/owner-config.js +0 -16
  74. package/dist/config/peer-role-resolver.js +1 -7
  75. package/dist/config/providers-config.js +107 -20
  76. package/dist/config/providers-management.js +45 -21
  77. package/dist/config/resolved-config-op.js +4 -44
  78. package/dist/config/schema-migration.js +78 -5
  79. package/dist/config/schema-registry.js +52 -7
  80. package/dist/config-store.js +1309 -17
  81. package/dist/core/agent-application-service.js +220 -1
  82. package/dist/core/agent-ipc-registration.js +19 -2
  83. package/dist/core/agent-reload-coordinator.js +5 -0
  84. package/dist/core/agent-runtime.js +198 -54
  85. package/dist/core/auth/agent-delegation.js +14 -0
  86. package/dist/core/auth/delegation-authorization.js +33 -26
  87. package/dist/core/auth/operation-authorizer.js +16 -1
  88. package/dist/core/auth/operation-catalog.js +59 -7
  89. package/dist/core/baseagent-loader.js +30 -3
  90. package/dist/core/capability/capability-manager.js +16 -7
  91. package/dist/core/channel-runtime.js +4 -2
  92. package/dist/core/command/agent-control.js +20 -2
  93. package/dist/core/command/agent-template-menu.js +4 -3
  94. package/dist/core/command/cli-intent-parser.js +28 -0
  95. package/dist/core/command/command-handler.js +45 -2
  96. package/dist/core/command/menu-catalog.js +20 -4
  97. package/dist/core/command/menu-file-path.js +70 -0
  98. package/dist/core/command/menu-handler.js +97 -73
  99. package/dist/core/command/menu-protocol.js +29 -0
  100. package/dist/core/command/menu-query-batch.js +2 -2
  101. package/dist/core/command/private-mention-menu.js +71 -0
  102. package/dist/core/command/remote-shell.js +565 -0
  103. package/dist/core/command/slash-handler.js +17 -26
  104. package/dist/core/command/team-workspace-bootstrap.js +2 -1
  105. package/dist/core/command/topic-slash.js +7 -1
  106. package/dist/core/daemon-bootstrap.js +0 -4
  107. package/dist/core/daemon-control.js +58 -1
  108. package/dist/core/daemon-lifecycle.js +29 -7
  109. package/dist/core/evolagent-registry.js +18 -9
  110. package/dist/core/handoff/runtime.js +1 -1
  111. package/dist/core/host-snapshot.js +8 -3
  112. package/dist/core/initialization/service.js +3 -0
  113. package/dist/core/interaction-router.js +130 -0
  114. package/dist/core/ipc-registration.js +5 -0
  115. package/dist/core/memory/consolidation-context.js +2 -1
  116. package/dist/core/memory/consolidation.js +35 -64
  117. package/dist/core/message/aun-ipc-sender.js +213 -74
  118. package/dist/core/message/aun-request-registry.js +31 -0
  119. package/dist/core/message/contact-admission.js +91 -6
  120. package/dist/core/message/contact-pending-inbound.js +113 -0
  121. package/dist/core/message/contact-thread-approval.js +212 -0
  122. package/dist/core/message/im-renderer.js +40 -1
  123. package/dist/core/message/message-admission.js +5 -39
  124. package/dist/core/message/message-bridge.js +197 -45
  125. package/dist/core/message/message-log.js +32 -0
  126. package/dist/core/message/message-queue.js +102 -18
  127. package/dist/core/message/peer-mode.js +15 -4
  128. package/dist/core/message/response-engine.js +174 -26
  129. package/dist/core/message/send-options.js +37 -3
  130. package/dist/core/message/send-routing.js +11 -7
  131. package/dist/core/model/config-scope.js +6 -14
  132. package/dist/core/model/model-catalog.js +5 -5
  133. package/dist/core/model/model-diagnostics.js +19 -0
  134. package/dist/core/model/model-fallback.js +13 -2
  135. package/dist/core/ownership/owner-resolver.js +12 -86
  136. package/dist/core/pack-auth.js +7 -0
  137. package/dist/core/pack-install.js +1 -1
  138. package/dist/core/permission/ec-command-parser.js +288 -77
  139. package/dist/core/permission/protected-paths.js +64 -9
  140. package/dist/core/permission/services-path-acl.js +458 -0
  141. package/dist/core/permission/tool-policy.js +26 -10
  142. package/dist/core/relation/peer-identity.js +13 -0
  143. package/dist/core/session/adapters/claude-session-file-adapter.js +6 -2
  144. package/dist/core/session/adapters/codex-session-file-adapter.js +4 -0
  145. package/dist/core/session/session-manager.js +47 -10
  146. package/dist/core/session/session-mapper.js +16 -0
  147. package/dist/core/skill/index-generator.js +2 -3
  148. package/dist/core/skill/switch-resolver.js +3 -0
  149. package/dist/core/task/task-recovery-service.js +1 -0
  150. package/dist/core/thread/command-parser.js +4 -1
  151. package/dist/core/thread/ipc-operation.js +4 -2
  152. package/dist/core/thread/thread-operation.js +25 -10
  153. package/dist/core/thread/thread-service.js +294 -55
  154. package/dist/core/thread/topic-id.js +67 -2
  155. package/dist/core/thread/types.js +15 -1
  156. package/dist/directory/owner-directory-admission.js +11 -8
  157. package/dist/directory/owner-directory-cache.js +19 -0
  158. package/dist/directory/owner-directory-markdown.js +1 -1
  159. package/dist/directory/owner-directory-policy.js +5 -30
  160. package/dist/directory/owner-directory-request-operation.js +5 -2
  161. package/dist/eck/kit-renderer.js +3 -2
  162. package/dist/eck/message-renderer.js +28 -5
  163. package/dist/ecweb/basic-settings-service.js +5 -9
  164. package/dist/ecweb/providers-service.js +4 -2
  165. package/dist/ecweb/runtime/supervisor.js +36 -8
  166. package/dist/event-center/center-config.js +9 -5
  167. package/dist/event-center/dispatcher.js +10 -1
  168. package/dist/event-center/ipc-operation.js +19 -0
  169. package/dist/event-center/registry.js +20 -5
  170. package/dist/event-center/runtime.js +10 -7
  171. package/dist/index.js +120 -41
  172. package/dist/ipc.js +83 -3
  173. package/dist/outputs/authorization.js +16 -0
  174. package/dist/outputs/cards.js +336 -0
  175. package/dist/outputs/events.js +3 -2
  176. package/dist/outputs/protocol.js +1 -0
  177. package/dist/outputs/service.js +2 -15
  178. package/dist/paths.js +48 -1
  179. package/dist/pay/command.js +38 -0
  180. package/dist/pay/protocol.js +136 -0
  181. package/dist/pay/runtime.js +188 -0
  182. package/dist/pay/service.js +384 -0
  183. package/dist/pay/store.js +81 -0
  184. package/dist/response-system/engines/v1/proactive-flow.js +29 -2
  185. package/dist/services/dispatcher.js +23 -5
  186. package/dist/services/host/main.js +388 -0
  187. package/dist/services/host/protocol.js +118 -0
  188. package/dist/services/host/resident.js +310 -0
  189. package/dist/services/host-client.js +386 -0
  190. package/dist/services/host-deploy.js +180 -0
  191. package/dist/services/host-launch.js +117 -0
  192. package/dist/services/host-recycle.js +203 -0
  193. package/dist/services/host-runtime.js +802 -0
  194. package/dist/services/idempotency.js +44 -86
  195. package/dist/services/index-generator.js +4 -3
  196. package/dist/services/index.js +204 -22
  197. package/dist/services/ipc-operation.js +288 -44
  198. package/dist/services/pack-manager.js +1 -0
  199. package/dist/services/script-runner.js +515 -83
  200. package/dist/services/service-payload.js +13 -7
  201. package/dist/services/validation.js +109 -4
  202. package/dist/stats/budget.js +1 -1
  203. package/dist/stats/model-resolver.js +2 -2
  204. package/dist/stats/quota-query.js +95 -0
  205. package/dist/trigger/application-service.js +6 -4
  206. package/dist/trigger/local-files.js +19 -9
  207. package/dist/trigger/scheduler.js +22 -12
  208. package/dist/trigger/script-sandbox.js +51 -8
  209. package/dist/utils/aid-bind.js +3 -0
  210. package/dist/utils/atomic-write.js +22 -8
  211. package/dist/utils/evolcore-version.js +2 -2
  212. package/dist/utils/host-info.js +173 -1
  213. package/dist/utils/logger.js +2 -2
  214. package/dist/utils/media-cache.js +190 -43
  215. package/dist/utils/npm-ops.js +43 -8
  216. package/dist/utils/restart-safety.js +14 -1
  217. package/dist/utils/system-memory.js +113 -25
  218. package/dist/utils/systemd-lifecycle.js +154 -0
  219. package/dist/utils/windows-shell-trust.js +7 -3
  220. package/dist/workbench/service.js +1 -1
  221. package/kits/docs/INDEX.md +3 -2
  222. 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
  223. package/kits/docs/channels/aun.md +1 -1
  224. package/kits/docs/evolcore/INDEX.md +9 -6
  225. package/kits/docs/evolcore/agent.md +36 -1
  226. package/kits/docs/evolcore/aid.md +45 -3
  227. package/kits/docs/evolcore/config.md +5 -2
  228. package/kits/docs/evolcore/directory.md +8 -9
  229. package/kits/docs/evolcore/group.md +2 -1
  230. package/kits/docs/evolcore/memory-tags.md +2 -0
  231. package/kits/docs/evolcore/menu-client.md +3 -3
  232. package/kits/docs/evolcore/menu-protocol.md +7 -0
  233. package/kits/docs/evolcore/model.md +3 -0
  234. package/kits/docs/evolcore/msg.md +77 -10
  235. package/kits/docs/evolcore/pay.md +34 -0
  236. package/kits/docs/evolcore/provider.md +22 -1
  237. package/kits/docs/evolcore/quota.md +54 -0
  238. package/kits/docs/evolcore/role.md +3 -0
  239. package/kits/docs/evolcore/services.md +46 -18
  240. package/kits/docs/evolcore/stats.md +2 -0
  241. package/kits/docs/evolcore/thread-chain.md +2 -0
  242. package/kits/docs/evolcore/tool-authorization.md +10 -0
  243. package/kits/docs/evolcore/trigger.md +2 -0
  244. package/kits/rules/01-overview.md +11 -32
  245. package/kits/rules/02-navigation.md +7 -0
  246. package/kits/rules/06-channel.md +3 -3
  247. package/kits/schemas/_meta.json +38 -5
  248. package/kits/schemas/agent-config.schema.20.json +24 -0
  249. package/kits/schemas/agent-config.schema.21.json +974 -0
  250. package/kits/schemas/agent-config.schema.22.json +977 -0
  251. package/kits/schemas/agent-config.schema.23.json +958 -0
  252. package/kits/schemas/daemon.schema.10.json +373 -0
  253. package/kits/schemas/daemon.schema.9.json +12 -0
  254. package/kits/schemas/defaults.schema.7.json +472 -0
  255. package/kits/schemas/providers.schema.3.json +18 -2
  256. package/kits/schemas/relation-config.schema.13.json +289 -0
  257. package/kits/skills/.switches.json +17 -1
  258. package/kits/skills/ability/SKILL.md +229 -34
  259. package/kits/skills/ability/STRUCTURE.md +333 -0
  260. package/kits/skills/ability/references/cli.md +208 -0
  261. package/kits/skills/ability/references/development.md +107 -37
  262. package/kits/skills/ability/references/management.md +106 -46
  263. package/kits/skills/ability/references/runtime-protocol.md +65 -63
  264. package/kits/skills/agent-output-cards/SKILL.md +64 -0
  265. package/kits/skills/ec-group/SKILL.md +8 -6
  266. package/kits/skills/ec-group/TASK.md +186 -0
  267. package/kits/skills/ec-group/WORKLOG.md +180 -0
  268. package/kits/skills/ec-group-collaboration/SKILL.md +3 -3
  269. package/kits/skills/ec-pay/SKILL.md +101 -0
  270. package/kits/skills/ec-pay/references/pay-cli.md +110 -0
  271. package/kits/skills/ec-provider/SKILL.md +58 -9
  272. package/kits/skills/{ec-service-proxy → ec-proxy}/SKILL.md +8 -5
  273. package/kits/skills/ec-service-call/SKILL.md +135 -0
  274. package/kits/skills/ec-service-pack/SKILL.md +277 -0
  275. package/kits/skills/ec-trigger/SKILL.md +1 -1
  276. package/kits/templates/memory-consolidation/notes.md +2 -2
  277. package/kits/templates/memory-consolidation/workflow.md +46 -0
  278. package/kits/templates/roles/visitor.json +1 -0
  279. package/kits/templates/system-fragments/channel.md +13 -4
  280. package/kits/templates/system-fragments/commands.md +5 -3
  281. package/kits/templates/system-fragments/directory-contacts.md +3 -4
  282. package/kits/templates/system-fragments/reply.md +1 -0
  283. package/kits/templates/system-fragments/session.md +1 -1
  284. package/kits/templates/system-fragments/thread.md +27 -128
  285. package/kits/templates/system-fragments/venue.md +27 -0
  286. package/package.json +4 -5
  287. package/scripts/agent-template/inspect.mjs +79 -29
  288. package/scripts/agent-template/overlay.mjs +20 -2
  289. package/scripts/agent-template/shared/common.mjs +24 -6
  290. package/scripts/agent-template/shared/team-schema.json +23 -5
  291. package/scripts/agent-template/shared/template-contract.mjs +107 -17
  292. package/scripts/agent-template/shared/template-package.mjs +254 -29
  293. package/scripts/agent-template/shared/template-runtime.mjs +145 -2
  294. package/scripts/agent-template/shared/template.mjs +67 -9
  295. package/scripts/agent-template/team-pack.mjs +132 -41
  296. package/scripts/agent-template/team-preview.mjs +249 -5
  297. package/kits/docs/aun/ABILITY_CALLING.md +0 -280
  298. package/kits/docs/evolcore/ability.md +0 -185
  299. package/kits/skills/ability/references/calling.md +0 -56
  300. package/kits/skills/ability/references/contract-checklist.md +0 -37
  301. package/kits/skills/ability/references/recovery.md +0 -27
  302. /package/dist/{core/capability/providers → agents/gemini}/gemini-capability-provider.js +0 -0
@@ -2,7 +2,7 @@ import { initializationSummary, readInitialization } from '../cli/agent-create.j
2
2
  import fs from 'node:fs';
3
3
  import path from 'node:path';
4
4
  import { agentMdPath, resolvePaths, } from '../paths.js';
5
- import { loadAgent, saveAgent, } from '../config-store.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
6
  import { ConfigTarget, assertAgentAidAvailable, assertAgentModelConfigured, ensureFile as cfgEnsure, initConfigManager, notifyConfigWrite, read as cfgRead, resolveEffective, write as cfgWrite, } from '../config/config-manager.js';
7
7
  import { executeResolvedConfigCommand, } from '../config/config-operation-service.js';
8
8
  import { resolveConfigCommand } from '../config/resolved-config-op.js';
@@ -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
  }
@@ -40,6 +40,16 @@ export function registerAgentOperationExecutor({ ipcServer, sessionManager, agen
40
40
  return fail('INVALID_DELEGATION', 'delegation does not match the current session');
41
41
  }
42
42
  let templateOperation;
43
+ let projectArgs;
44
+ if (sub === 'project' || sub === 'stop' || sub === 'start') {
45
+ try {
46
+ projectArgs = (await import('../cli/agent.js')).parseAgentProjectArgs(sub === 'project'
47
+ ? argv.slice(2) : [argv[2], sub, ...argv.slice(3)], sub !== 'project');
48
+ }
49
+ catch (error) {
50
+ return fail('INVALID_ARGUMENT', error.message);
51
+ }
52
+ }
43
53
  if (sub === 'template') {
44
54
  try {
45
55
  const { parseTemplateCommand } = await import('../cli/agent-template.js');
@@ -82,7 +92,7 @@ export function registerAgentOperationExecutor({ ipcServer, sessionManager, agen
82
92
  return fail('INVALID_ARGS', error.message);
83
93
  }
84
94
  }
85
- const operation = templateOperation ?? (sub === 'list' ? 'agent.list'
95
+ const operation = projectArgs ? (sub === 'project' ? 'agent.project.' + projectArgs.operation : 'agent.' + sub) : templateOperation ?? (sub === 'list' ? 'agent.list'
86
96
  : sub === 'show' ? 'agent.show'
87
97
  : sub === 'welcome' ? 'agent.welcome'
88
98
  : sub === 'rename' ? 'agent.rename'
@@ -120,7 +130,7 @@ export function registerAgentOperationExecutor({ ipcServer, sessionManager, agen
120
130
  subject,
121
131
  intent: {
122
132
  operation,
123
- scope: templateOperation ? 'process' : operation === 'agent.show' || operation === 'agent.welcome' || operation === 'agent.rename'
133
+ scope: templateOperation || projectArgs ? 'process' : operation === 'agent.show' || operation === 'agent.welcome' || operation === 'agent.rename'
124
134
  ? 'agent'
125
135
  : operation === 'agent.reload' && targetAid
126
136
  ? 'agent'
@@ -150,6 +160,13 @@ export function registerAgentOperationExecutor({ ipcServer, sessionManager, agen
150
160
  return fail(error.code ?? 'INVALID_ARGUMENT', error.message);
151
161
  }
152
162
  }
163
+ if (projectArgs) {
164
+ if (!agentApplicationService)
165
+ return fail('NOT_CONFIGURED', 'Agent service unavailable');
166
+ const { executeAgentProjectOperation } = await import('../cli/agent.js');
167
+ const result = await executeAgentProjectOperation(delegation.grant.actorId, projectArgs, agentApplicationService);
168
+ return result.ok ? { ok: true, result } : fail(result.code, result.error);
169
+ }
153
170
  const { execAgentAction, execAgentOptions, execAgentQuery } = await import('./command/agent-control.js');
154
171
  if (operation === 'agent.list') {
155
172
  const result = await execAgentOptions({ options: 'all' }, agentApplicationService);
@@ -1,3 +1,4 @@
1
+ import { agentProjectChangeGate } from '../config-store.js';
1
2
  export class AgentReloadBusyError extends Error {
2
3
  aid;
3
4
  busyCount;
@@ -21,6 +22,10 @@ export class AgentReloadCoordinator {
21
22
  }
22
23
  /** Reserve immediately, without waiting behind a running mutation or runner load. */
23
24
  async acquireForMutation(aid, token) {
25
+ const project = agentProjectChangeGate(aid);
26
+ if (project?.state === 'recovery' && project.planId !== token) {
27
+ throw Object.assign(new Error('Another project change requires recovery'), { code: 'PROJECT_RECOVERY_REQUIRED' });
28
+ }
24
29
  if (!token || this.held.has(aid) || this.inFlight.has(aid))
25
30
  throw new AgentReloadBusyError(aid, 1);
26
31
  this.held.set(aid, token);