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
@@ -5,6 +5,7 @@ import { wantsHelp } from './help.js';
5
5
  import { ABILITY_COMMANDS, ABILITY_DEV_COMMANDS, parseAbilityOptions, parseAbilityWait, abilityCommandSchema } from '../ability/command-contract.js';
6
6
  import { abilityFailure } from '../ability/management.js';
7
7
  import { abilityAssert } from '../ability/types.js';
8
+ import { REMOTE_COMMANDS, parseRemoteCommand, durationSeconds, remoteUsage } from '../ability/caller/command.js';
8
9
  export async function queryAbilityWithWait(args, query) {
9
10
  const descriptor = ABILITY_COMMANDS[args[0]];
10
11
  abilityAssert(descriptor, 'ACTION_UNSUPPORTED', 'Unknown ability command');
@@ -35,9 +36,50 @@ export async function queryAbilityWithWait(args, query) {
35
36
  }
36
37
  }
37
38
  export async function cmdAbility(args) {
39
+ if (args[0] === 'remote') {
40
+ if (args.length === 1 || wantsHelp(args)) {
41
+ console.log('用法: ec ability remote <命令> <Provider AID> [能力路径] [选项]\n远端 AUN Caller;调用方来自可信托管会话,不使用 --aid/--self。');
42
+ for (const [name, spec] of Object.entries(REMOTE_COMMANDS))
43
+ console.log(` ${remoteUsage(name)}\n ${spec.description} ${spec.options.map(option => '--' + option).join(' ')}`);
44
+ console.log('路径已知:info <AID> <path> --usage → call;路径未知:list [--search <关键词>]。仅缺设备证据时 discover。\n目录默认精简分页(20项);list --limit 最大100,--discovery 读取固定快照。按 pagination.next_command 翻页,不重发 discover。\n--full 显示完整目录条目;--usage 显式读取远端指南。list/discover/devices 的 path 也兼容 --path <path>,两种写法不能同时使用。');
45
+ console.log(' call --plan <plan-id> 执行原预览计划;其他业务参数不可同时提供\n result <request-id> [--wait 30s] 查询原请求;不重新发送\n默认 JSON 输出。多设备须选择 --device-id;params 文件放当前项目或当前会话 TMPDIR。\n退出码:0 成功,1 失败,2 待结果或待选择。所有 remote 命令要求 AUN 托管会话。');
46
+ return;
47
+ }
48
+ const { remoteFailure, remoteExitCode } = await import('../ability/caller/service.js');
49
+ try {
50
+ const parsed = parseRemoteCommand(['ability', ...args]);
51
+ const wait = parsed.options.plan ? '3600s' : parsed.options.timeout ?? parsed.options.wait ?? parsed.options.window ?? '60s';
52
+ const result = await ipcQuery(resolvePaths().socket, { type: 'ability.remote.op', argv: ['ability', ...args],
53
+ sessionId: process.env.EVOLCORE_SESSION_ID, delegationToken: readDelegationCredential(), delegationCommandHash: hashCurrentDelegatedCommand() }, (durationSeconds(wait) + 180) * 1000) ?? { ok: false, code: 'DAEMON_UNAVAILABLE', error: 'Daemon response unavailable; execution may be unknown' };
54
+ console.log(JSON.stringify(result, null, 2));
55
+ process.exitCode = remoteExitCode(result);
56
+ }
57
+ catch (error) {
58
+ console.log(JSON.stringify(remoteFailure(error), null, 2));
59
+ process.exitCode = 1;
60
+ }
61
+ return;
62
+ }
38
63
  if (!args.length || wantsHelp(args)) {
64
+ if (args[0] === 'list') {
65
+ console.log([
66
+ '用法: ec ability list (--aid <AID> | --self) [--format json]',
67
+ '列出选定 AID 在当前宿主内已安装的插件实例。',
68
+ ' ec ability list --self 查询当前 Agent 的本地实例;宿主终端中为 host',
69
+ ' ec ability list --aid <AID> 查询有权管理的宿主内目标',
70
+ '空列表只说明该目标没有已安装实例,不能判断用户手机有哪些能力。',
71
+ '',
72
+ '使用用户手机或其他对端的能力:先 ec skill load ability,读取 SKILL.md 的“一、调用别人的能力”。',
73
+ 'AUN 私聊中用户的“我/我的手机”对应 peerId;从主体 AID 开始发现:',
74
+ ' ec ability remote list <主体AID>',
75
+ '按需 remote discover,读取 remote info 后用 remote call 调用。',
76
+ ].join('\n'));
77
+ return;
78
+ }
39
79
  const dev = args[0] === 'dev';
40
80
  console.log(dev ? '用法: ec ability dev <命令> [位置参数] [--project <目录>] [--format json]' : '用法: ec ability <命令> [实例或来源] (--aid <AID> | --self) [--file <JSON>] [--format json]');
81
+ if (!dev)
82
+ console.log('本地插件管理与远端 AUN Ability Caller。使用用户手机或对端能力:ec ability remote --help。\nlist 查询已安装实例;remote list 查询远端能力目录。流程见 ec skill load ability。');
41
83
  for (const [name, command] of Object.entries(dev ? ABILITY_DEV_COMMANDS : ABILITY_COMMANDS)) {
42
84
  if (name === 'secret')
43
85
  continue;
@@ -107,6 +107,10 @@ function printAgentNewHelp() {
107
107
  export async function cmdAgent(args) {
108
108
  args = canonicalizeEvolcoreCommandArgv(['ec', 'agent', ...args]).slice(2);
109
109
  const sub = args[0];
110
+ if (sub === 'project')
111
+ return (await import('./agent.js')).cmdAgentProject(args.slice(1));
112
+ if (sub === 'stop' || sub === 'start')
113
+ return (await import('./agent.js')).cmdAgentProject([args[1], sub, ...args.slice(2)], true);
110
114
  if (sub === 'template') {
111
115
  const { cmdAgentTemplate } = await import('./agent-template.js');
112
116
  return cmdAgentTemplate(args.slice(1));
@@ -135,6 +139,8 @@ Commands:
135
139
  show <aid> 查看 agent 详情(身份 + 配置 + 连接 + 会话 + 路径)
136
140
  host <aid> 查看 agent 所在主机信息(位置、daemon、硬件、版本)
137
141
  template <command> 模板清单、打包、上传、预检、安装及任务查询
142
+ project <aid> <action> 项目迁移:preview/move/status/recover/resolve
143
+ stop/start <aid> 显式停止或启动 Agent
138
144
  new <aid> ... 创建并激活(默认 --initialize,隐含非交互)
139
145
  new <aid> --bootstrap ... 创建后进入 Bootstrap(隐含非交互)
140
146
  initialize <aid> --resume 恢复一次性初始化
@@ -971,6 +977,19 @@ function formatDurationMs(ms) {
971
977
  const day = Math.floor(hour / 24);
972
978
  return `${day}d${hour % 24}h${String(m).padStart(2, '0')}m`;
973
979
  }
980
+ /**
981
+ * OS 行。优先用完整产品名——Windows 的 release 只是 "10.0.26200",Win10 和 Win11
982
+ * 主版本号相同,光看 release 会把 Win11 显示成 Win10。产品名读不到(探测未完成、
983
+ * 非 Windows/Linux)才回落到 platformName + release。
984
+ */
985
+ function formatOsLine(osInfo) {
986
+ const productName = typeof osInfo?.productName === 'string' ? osInfo.productName.trim() : '';
987
+ const fallback = `${osInfo?.platformName ?? 'Other'}${osInfo?.release ? ` (${osInfo.release})` : ''}`;
988
+ if (!productName)
989
+ return `${fallback}${osInfo?.version ? ` · ${osInfo.version}` : ''}`;
990
+ // 产品名已含版本("Microsoft Windows 11 专业版"),不再重复追加 release。
991
+ return productName;
992
+ }
974
993
  /** PKI 注册门禁结论的一行说明;`unknown` 必须说清是"没验到"而不是"不存在"。 */
975
994
  function formatAidRegistration(registration) {
976
995
  if (!registration || typeof registration !== 'object')
@@ -1062,7 +1081,7 @@ function printAgentHostHuman(result, durationMs, totalMs) {
1062
1081
  };
1063
1082
  console.log(' Host');
1064
1083
  console.log(` Hostname: ${h.hostname}`);
1065
- console.log(` OS: ${h.os.platformName}${h.os.release ? ` (${h.os.release})` : ''}${h.os.version ? ` · ${h.os.version}` : ''}`);
1084
+ console.log(` OS: ${formatOsLine(h.os)}`);
1066
1085
  if (h.os.distributionId)
1067
1086
  console.log(` Distribution: ${h.os.distributionId}`);
1068
1087
  console.log(` Environment: ${virtMap[h.os.virtualization] || h.os.virtualization}`);
@@ -1,3 +1,4 @@
1
+ import { isSupportedBaseagent, listSupportedBaseagents } from '../agents/baseagent.js';
1
2
  import fs from 'fs';
2
3
  import { randomBytes, randomUUID, createHash } from 'crypto';
3
4
  import path from 'path';
@@ -12,7 +13,7 @@ import { CONFIG_SCHEMA_VERSION } from '../types.js';
12
13
  import { ensureInitialRoleRegistry } from '../config/role-service.js';
13
14
  import { isSoulPlaceholder } from '../core/soul.js';
14
15
  import { getCodexAppServerAvailability } from '../agents/codex-runner.js';
15
- import { AUTO_BASEAGENT_CANDIDATES, BASEAGENT_CANDIDATES, detectAvailableBaseagents, } from '../agents/baseagent-availability.js';
16
+ import { AUTO_BASEAGENT_CANDIDATES, detectAvailableBaseagents, } from '../agents/baseagent-availability.js';
16
17
  import { agentProjectRootFromDefaults, deriveAgentProjectPath } from '../utils/project-path.js';
17
18
  import { isValidAid } from '../aun/aid/validation.js';
18
19
  import { AGENT_DESCRIPTION_MAX_LENGTH, DEFAULT_AGENT_DESCRIPTION, DEFAULT_AGENT_TYPE, normalizeAgentType, validateAgentTags, validateAgentType, buildInitialAgentMd, validateAgentMdFrontmatter, assertAgentIdentityReusable, assertAgentCardReusable, } from '../aun/aid/agentmd.js';
@@ -224,8 +225,8 @@ export function validateAgentCreatePlan(plan) {
224
225
  }
225
226
  if (!plan.baseagent)
226
227
  return 'No usable baseagent detected. Pass --baseagent or configure a baseagent in agents/defaults.json.';
227
- if (!BASEAGENT_CANDIDATES.includes(plan.baseagent)) {
228
- return `Invalid baseagent: ${plan.baseagent} (options: ${BASEAGENT_CANDIDATES.join('/')})`;
228
+ if (!isSupportedBaseagent(plan.baseagent)) {
229
+ return `Invalid baseagent: ${plan.baseagent} (options: ${listSupportedBaseagents().join('/')})`;
229
230
  }
230
231
  if (!detectAvailableBaseagents().includes(plan.baseagent)) {
231
232
  return `${plan.baseagent} is not available in the current environment`;
@@ -348,8 +349,8 @@ export async function agentCreateInteractive(opts = {}) {
348
349
  console.log(' ecagent is optional; enter ecagent to select it explicitly.');
349
350
  continue;
350
351
  }
351
- if (!BASEAGENT_CANDIDATES.includes(input)) {
352
- console.log(` Invalid choice. Options: ${BASEAGENT_CANDIDATES.join('/')}`);
352
+ if (!isSupportedBaseagent(input)) {
353
+ console.log(` Invalid choice. Options: ${listSupportedBaseagents().join('/')}`);
353
354
  continue;
354
355
  }
355
356
  if (!available.includes(input)) {
@@ -550,8 +551,8 @@ export async function agentCreateNonInteractive(opts, runtime = {}) {
550
551
  return failValidating('No usable baseagent detected. Install claude/gemini CLI or codex CLI with app-server, or use bundled ecagent.');
551
552
  let baseagent;
552
553
  if (opts.baseagent) {
553
- if (!BASEAGENT_CANDIDATES.includes(opts.baseagent))
554
- return failValidating(`Invalid baseagent: ${opts.baseagent} (options: ${BASEAGENT_CANDIDATES.join('/')})`);
554
+ if (!isSupportedBaseagent(opts.baseagent))
555
+ return failValidating(`Invalid baseagent: ${opts.baseagent} (options: ${listSupportedBaseagents().join('/')})`);
555
556
  if (!available.includes(opts.baseagent))
556
557
  return failValidating(opts.baseagent === 'codex' ? getCodexAppServerAvailability().reason || `${opts.baseagent} is not available in the current environment` : `${opts.baseagent} is not available in the current environment (available: ${available.join('/')})`);
557
558
  baseagent = opts.baseagent;
@@ -1238,6 +1239,9 @@ export class AgentInitializationService {
1238
1239
  deps;
1239
1240
  running = new Map();
1240
1241
  ownerRechecks = new Map();
1242
+ ownerObservers = new Map();
1243
+ ownerWakeups = new Set();
1244
+ disposed = false;
1241
1245
  /** Keep the shared admission claim in sync with the one-shot journal. */
1242
1246
  async updateOneShotClaim(record, status) {
1243
1247
  if (recordMode(record) !== 'one_shot' || !record.creationId)
@@ -1477,11 +1481,11 @@ export class AgentInitializationService {
1477
1481
  return this.status(aid);
1478
1482
  }
1479
1483
  resumeForOwner(aid, ownerAid) {
1480
- if (!ownerAid)
1484
+ if (!ownerAid || this.disposed)
1481
1485
  return;
1482
1486
  try {
1483
1487
  const record = readInitialization(aid);
1484
- if (!record || this.running.has(aid))
1488
+ if (!record || record.status === 'complete' || record.status === 'cancelled')
1485
1489
  return;
1486
1490
  if (record.teamJobId)
1487
1491
  return; // The durable parent owns all team recovery.
@@ -1494,6 +1498,10 @@ export class AgentInitializationService {
1494
1498
  const unknownBind = record.mode === 'one_shot' && record.bindAttempt?.state === 'unknown';
1495
1499
  if ((!waitingForOwner && !lostConsensusRace) && !unknownBind)
1496
1500
  return;
1501
+ if (this.running.has(aid)) {
1502
+ this.ownerWakeups.add(aid);
1503
+ return;
1504
+ }
1497
1505
  this.resume(aid, record.actor, recordMode(record) === 'one_shot' ? record.clientRequestId : undefined);
1498
1506
  }
1499
1507
  catch (error) {
@@ -1513,13 +1521,40 @@ export class AgentInitializationService {
1513
1521
  return;
1514
1522
  clearTimeout(this.ownerRechecks.get(aid));
1515
1523
  this.ownerRechecks.delete(aid);
1524
+ this.ownerWakeups.delete(aid);
1516
1525
  r.status = 'cancelled';
1517
1526
  r.code = 'INITIALIZE_CANCELLED';
1518
1527
  saveInitialization(r);
1528
+ await this.stopOwnerObservation(aid);
1519
1529
  await this.updateOneShotClaim(r, 'failed');
1520
1530
  await this.running.get(aid);
1521
1531
  }
1522
- async settle(aid) { await this.running.get(aid); }
1532
+ async settle(aid) {
1533
+ while (this.running.has(aid))
1534
+ await this.running.get(aid);
1535
+ }
1536
+ /** Stop transports and timers without cancelling durable work recovered at next startup. */
1537
+ async dispose() {
1538
+ this.disposed = true;
1539
+ for (const timer of this.ownerRechecks.values())
1540
+ clearTimeout(timer);
1541
+ this.ownerRechecks.clear();
1542
+ this.ownerWakeups.clear();
1543
+ await Promise.allSettled([...this.ownerObservers.keys()].map(aid => this.stopOwnerObservation(aid)));
1544
+ await Promise.allSettled([...this.running.values()]);
1545
+ }
1546
+ watchOwner(r) {
1547
+ const aid = r.plan.aid;
1548
+ if (this.disposed || !this.deps.watchOwner || this.ownerObservers.has(aid)
1549
+ || !this.deps.ownershipBeforePublication || recordMode(r) !== 'one_shot' || r.hotLoaded || r.teamJobId)
1550
+ return;
1551
+ this.ownerObservers.set(aid, this.deps.watchOwner(aid, () => this.resumeForOwner(aid, r.plan.ownerAid)));
1552
+ }
1553
+ async stopOwnerObservation(aid) {
1554
+ const stop = this.ownerObservers.get(aid);
1555
+ this.ownerObservers.delete(aid);
1556
+ await stop?.();
1557
+ }
1523
1558
  async wait(aid, seconds) {
1524
1559
  const work = this.running.get(aid);
1525
1560
  if (work && seconds > 0) {
@@ -1535,10 +1570,14 @@ export class AgentInitializationService {
1535
1570
  return this.status(aid);
1536
1571
  }
1537
1572
  launch(r) {
1573
+ if (this.disposed)
1574
+ failure('INITIALIZE_STOPPED');
1538
1575
  const aid = r.plan.aid;
1539
1576
  clearTimeout(this.ownerRechecks.get(aid));
1540
1577
  this.ownerRechecks.delete(aid);
1541
1578
  const work = Promise.resolve().then(() => this.run(r)).catch(async (error) => {
1579
+ if (this.disposed)
1580
+ return;
1542
1581
  // Cancellation wins over a stale worker, including delete while network I/O was pending.
1543
1582
  let current;
1544
1583
  try {
@@ -1564,22 +1603,38 @@ export class AgentInitializationService {
1564
1603
  saveInitialization(r);
1565
1604
  await this.updateOneShotClaim(r, 'failed');
1566
1605
  }).catch(() => { })
1567
- .finally(() => {
1568
- this.running.delete(aid);
1569
- // Before hot-load there is no attached channel to emit an Owner event.
1570
- // Keep observing the durable attempt without another bind or App action.
1571
- if (!this.deps.ownershipBeforePublication || recordMode(r) !== 'one_shot')
1572
- return;
1606
+ .finally(async () => {
1607
+ const wakeup = this.ownerWakeups.delete(aid);
1573
1608
  let current;
1574
1609
  try {
1575
1610
  current = readInitialization(aid);
1576
1611
  }
1577
1612
  catch {
1613
+ current = null;
1614
+ }
1615
+ if (this.disposed || !current || current.status !== 'in_progress' || current.phase !== 'ownerpending'
1616
+ || current.operationId !== r.operationId || current.teamJobId) {
1617
+ await this.stopOwnerObservation(aid);
1618
+ this.running.delete(aid);
1619
+ this.ownerWakeups.delete(aid);
1578
1620
  return;
1579
1621
  }
1580
- if (current?.status !== 'in_progress' || current.phase !== 'ownerpending'
1581
- || current.operationId !== r.operationId || current.hotLoaded)
1622
+ if (!this.deps.ownershipBeforePublication || recordMode(r) !== 'one_shot' || current.hotLoaded) {
1623
+ await this.stopOwnerObservation(aid);
1624
+ this.running.delete(aid);
1625
+ const changedWhileClosing = this.ownerWakeups.delete(aid);
1626
+ if (wakeup || changedWhileClosing)
1627
+ this.resumeForOwner(aid, current.plan.ownerAid);
1582
1628
  return;
1629
+ }
1630
+ this.watchOwner(current);
1631
+ this.running.delete(aid);
1632
+ // An event arriving during checkOwner must survive the running guard.
1633
+ if (wakeup) {
1634
+ this.resumeForOwner(aid, current.plan.ownerAid);
1635
+ return;
1636
+ }
1637
+ // Rebuild a lost/expired observer and recover missed events without rebinding.
1583
1638
  const timer = setTimeout(() => {
1584
1639
  this.ownerRechecks.delete(aid);
1585
1640
  this.resumeForOwner(aid, r.plan.ownerAid);
@@ -1590,6 +1645,8 @@ export class AgentInitializationService {
1590
1645
  this.running.set(aid, work);
1591
1646
  }
1592
1647
  check(r) {
1648
+ if (this.disposed)
1649
+ failure('INITIALIZE_STOPPED');
1593
1650
  assertAgentAidAvailable(r.plan.aid);
1594
1651
  if (r.teamJobId) {
1595
1652
  const gate = templateInstallationGate(r.plan.aid, r.teamJobId);
@@ -1643,6 +1700,7 @@ export class AgentInitializationService {
1643
1700
  }
1644
1701
  async observeOwner(r) {
1645
1702
  this.check(r);
1703
+ this.watchOwner(r);
1646
1704
  if (recordMode(r) === 'one_shot') {
1647
1705
  r.ownerConfirmed = false;
1648
1706
  saveInitialization(r);
@@ -1939,6 +1997,8 @@ export class AgentInitializationService {
1939
1997
  saveAgent(currentConfig);
1940
1998
  }
1941
1999
  this.phase(r, 'hot_loading');
2000
+ await this.stopOwnerObservation(p.aid);
2001
+ this.check(r);
1942
2002
  await this.deps.hotLoad(p.aid);
1943
2003
  this.check(r);
1944
2004
  r.hotLoaded = true;
@@ -12,7 +12,8 @@ export function parseTemplateCommand(argv) {
12
12
  const action = argv[0];
13
13
  if (!TEMPLATE_ACTIONS.includes(action))
14
14
  throw templateError('INVALID_ARGUMENT', 'Unknown template action');
15
- const jsonAction = ['inspect', 'build', 'push', 'pull', 'preview'].includes(action);
15
+ const jsonAction = ['inspect', 'build', 'push', 'pull', 'preview', 'register-team', 'team-members', 'prepare-member-install', 'resume-member-join',
16
+ 'update-status', 'check-update', 'bind-update-source', 'confirm-update-source', 'preview-update', 'read-update-notice'].includes(action);
16
17
  const controls = ['resume', 'cancel'].includes(action);
17
18
  const asynchronous = !['status', 'capabilities'].includes(action);
18
19
  const flags = new Map();
@@ -112,8 +113,9 @@ export async function executeHostTemplateCommand(argv) {
112
113
  }
113
114
  export async function cmdAgentTemplate(args) {
114
115
  if (!args.length || wantsHelp(args)) {
115
- console.log(MAIN_CLI_BIN + ' agent template <inspect|build|push|pull|preview|deploy|status|resume|cancel|capabilities>\n'
116
- + 'inspect/build/push/pull/preview: --input-file FILE\n'
116
+ console.log(MAIN_CLI_BIN + ' agent template <' + TEMPLATE_ACTIONS.join('|') + '>\n'
117
+ + 'inspect/build/push/pull/preview/register-team/team-members/prepare-member-install/resume-member-join: --input-file FILE\n'
118
+ + 'update-status/check-update/bind-update-source/confirm-update-source/preview-update/read-update-notice: --input-file FILE\n'
117
119
  + 'deploy: --preview-id ID --plan-digest DIGEST\n'
118
120
  + 'status JOB_ID | status --request-id ORIGINAL; resume/cancel JOB_ID\n'
119
121
  + 'Asynchronous/control: --request-id ID --wait 0..300 (default 0). --format json');
package/dist/cli/agent.js CHANGED
@@ -1,4 +1,95 @@
1
1
  import fs from 'fs';
2
+ import { MAIN_CLI_BIN } from '../product.js';
3
+ export function parseAgentProjectArgs(argv, lifecycle = false) {
4
+ const [aid, operation, ...tail] = argv;
5
+ const operations = lifecycle ? ['stop', 'start'] : ['preview', 'move', 'status', 'recover', 'resolve'];
6
+ if (!isValidAid(aid ?? '') || !operations.includes(operation))
7
+ throw new Error('Invalid Agent project command');
8
+ const args = { aid, operation };
9
+ const seen = new Set();
10
+ for (let index = 0; index < tail.length; index++) {
11
+ const option = tail[index], value = tail[++index];
12
+ if (seen.has(option) || value === undefined)
13
+ throw new Error('Invalid or duplicate option: ' + option);
14
+ seen.add(option);
15
+ if (option === '--format' && value === 'json')
16
+ continue;
17
+ if (option === '--agents' && ['preview', 'move'].includes(operation)) {
18
+ const aids = value.split(',');
19
+ if (!aids.length || aids.some(aid => !isValidAid(aid)) || new Set(aids).size !== aids.length)
20
+ throw new Error('--agents requires unique AIDs separated by commas');
21
+ args.aids = aids;
22
+ continue;
23
+ }
24
+ if (operation === 'resolve' && option === '--conflict' && value.trim()) {
25
+ args.conflictId = value;
26
+ continue;
27
+ }
28
+ if (operation === 'resolve' && option === '--decision' && ['skip', 'abort'].includes(value)) {
29
+ args.decision = value;
30
+ continue;
31
+ }
32
+ if (option !== '--target' || !['preview', 'move'].includes(operation) || !path.isAbsolute(value)) {
33
+ throw new Error('Only preview/move accepts --target with an absolute path');
34
+ }
35
+ args.target = value;
36
+ }
37
+ if (['preview', 'move'].includes(operation) && !args.target)
38
+ throw new Error('--target is required');
39
+ if (operation === 'resolve' && (!args.conflictId || !args.decision))
40
+ throw new Error('resolve requires --conflict ID --decision skip|abort');
41
+ return args;
42
+ }
43
+ export async function executeAgentProjectOperation(actor, args, service) {
44
+ const { ownerResolver, getDaemonOwners, refreshOwnershipForAuthorization } = await import('../core/ownership/owner-resolver.js');
45
+ if (!args || !isValidAid(args.aid ?? ''))
46
+ return { ok: false, code: 'INVALID_ARGUMENT', error: 'Valid Agent AID required' };
47
+ await refreshOwnershipForAuthorization(undefined, { force: true, allowTransient: false, source: 'agent-project' });
48
+ if (!getDaemonOwners().includes(actor))
49
+ return { ok: false, code: 'NOT_ALLOWED', error: 'DaemonOwner required' };
50
+ const owner = await ownerResolver.refreshForAuthorization(args.aid);
51
+ if (owner.refreshFailure || owner.consensusStatus !== 'consensus' || owner.ownerAid !== actor) {
52
+ return { ok: false, code: 'NOT_ALLOWED', error: 'Fresh Agent Owner consensus required' };
53
+ }
54
+ if (args.operation === 'stop' || args.operation === 'start') {
55
+ if (Object.keys(args).some(key => !['aid', 'operation'].includes(key)))
56
+ return { ok: false, code: 'INVALID_ARGUMENT', error: 'Unexpected lifecycle argument' };
57
+ return args.operation === 'stop' ? service.stop(args.aid) : service.start(args.aid);
58
+ }
59
+ return service.project(args.aid, actor, args);
60
+ }
61
+ export async function cmdAgentProject(argv, lifecycle = false) {
62
+ if (!argv.length || argv.includes('--help') || argv.includes('-h')) {
63
+ console.log(lifecycle ? MAIN_CLI_BIN + ' agent <stop|start> <aid> [--format json]'
64
+ : MAIN_CLI_BIN + ' agent project <aid> <preview|move|status|recover|resolve>\n'
65
+ + 'preview/move: --target ABSOLUTE_PATH [--agents AID1,AID2].\n'
66
+ + 'resolve: --conflict ID --decision skip|abort. All actions: [--format json].\n'
67
+ + 'Copies project files once, retains source, migrates selected bindings; stop/start use existing lifecycle operations.');
68
+ return;
69
+ }
70
+ try {
71
+ const args = parseAgentProjectArgs(argv, lifecycle);
72
+ let result;
73
+ if (process.env[SESSION_ID_ENV]) {
74
+ result = await runManagedAgentOperation(lifecycle
75
+ ? [args.operation, args.aid, ...argv.slice(2)] : ['project', ...argv], 120_000);
76
+ }
77
+ else {
78
+ const controlToken = fs.readFileSync(resolvePaths().controlToken, 'utf8').trim();
79
+ const response = await queryDaemon(resolvePaths().socket, { type: 'agent-project.op', args, controlToken }, 120_000);
80
+ result = response.response ?? { ok: false, code: 'DAEMON_UNAVAILABLE', error: response.transportError };
81
+ }
82
+ console.log(JSON.stringify(result, null, 2));
83
+ if (!result.ok)
84
+ process.exitCode = 1;
85
+ else if (['paused', 'awaiting_decision'].includes(result.status))
86
+ process.exitCode = 3;
87
+ }
88
+ catch (error) {
89
+ console.error(JSON.stringify({ ok: false, code: error.code ?? 'INVALID_ARGUMENT', error: error.message }));
90
+ process.exitCode = 2;
91
+ }
92
+ }
2
93
  import { getOwners } from '../core/ownership/owner-resolver.js';
3
94
  import path from 'path';
4
95
  import { SESSION_ID_ENV } from '../product.js';