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
@@ -9,6 +9,7 @@ import path from 'node:path';
9
9
  import { ipcQuery } from '../ipc.js';
10
10
  import { readDelegationCredential, hashCurrentDelegatedCommand } from '../core/auth/agent-delegation.js';
11
11
  import { resolvePaths } from '../paths.js';
12
+ import { SERVICE_CALL_TIMEOUT_MS } from '../services/ipc-operation.js';
12
13
  const HELP = `ec services — 服务路由运维
13
14
 
14
15
  本机:
@@ -20,24 +21,31 @@ const HELP = `ec services — 服务路由运维
20
21
  ec services repair-acl [--aid <aid>] 收紧 services/ 的 NTFS ACL(幂等,仅 Windows)
21
22
  ec services reload [--aid <aid>] 重载(全部包)
22
23
  ec services enable / disable [--aid <aid>] 总闸
24
+ ec services host enable / disable [--aid <aid>] 宿主模式(常驻执行形态)
23
25
  ec services rules show [<type>] [--aid <aid>] 调用准入规则
24
26
  ec services rules add <type> <aid...> [--deny] [--aid <aid>]
25
27
  ec services rules remove <type> <aid...> [--deny] [--aid <aid>]
26
28
 
27
29
  安装与卸载(L 类目录只能由 daemon 代写):
28
30
  ec services pack add <包名> --from <源目录> [--aid <aid>]
31
+ ec services pack update <包名> --from <源目录> [--aid <aid>]
29
32
  ec services pack remove <包名> [--aid <aid>] [--purge]
30
33
  ec services pack enable / disable <包名> [--aid <aid>]
31
34
 
32
- add 遇到已安装的包直接报错,先 remove 再装。
35
+ add 遇到已安装的包直接报错,先 remove 再装;改包用 update(原地替换,失败回滚到旧版)。
36
+ update 保留 logs/ 与台账,只替换声明的脚本与文件。
33
37
  remove 默认把日志与台账归档到 <包>/logs/archive-<时间戳>/;--purge 连归档一起删。
34
38
  ec services pack list [--aid <aid>]
35
39
 
36
- 对端:
37
- ec services describe <aid> [--service <type>] 查对端可用服务
38
- ec services schema <aid> <type> 查某个服务的请求 schema
39
- ec services call <aid> <type> --data '<json>' [--timeout 30] [--encrypted] [--no-wait]
40
- ec services call --request-id <id> --wait 查已发出的调用(--aid 指定本端)
40
+ 对端(--aid 是被调用方;发送身份托管会话自动补齐,宿主终端用 --as):
41
+ ec services describe --aid <对端aid> [--type <type>] 查对端可用服务
42
+ ec services schema --aid <对端aid> --type <type> 查某个服务的请求 schema
43
+ ec services call --aid <对端aid> --type <type> --data '<json>'
44
+ [--as <发送身份>] [--timeout 12] [--encrypted]
45
+
46
+ 本机自测(不经网络,直接走路由 + 权限 + 沙箱 + handler):
47
+ ec services call --local --type <type> [--data '<json>'] [--timeout 12]
48
+ 模拟一个普通成员调用,因此会走沙箱;测不到准入、加密与跨机时延。
41
49
 
42
50
  服务调用是点对点、要结果、不丢的消息:结果由 daemon 落盘,CLI 被杀也不丢。`;
43
51
  /** 这三个子命令的回包是「对端应答」,CLI 只打印正文。 */
@@ -102,6 +110,17 @@ export async function runServicesCommand(argv) {
102
110
  console.log(HELP);
103
111
  return;
104
112
  }
113
+ // 子命令后面跟 --help 也算求助:原来只认 args[0],于是 ec services call --help
114
+ // 会掉进真正的执行分支、被参数校验拒成 INVALID_ARGV("call requires --aid")。
115
+ // 撞到陌生命令时第一反应就是查帮助,帮助本身报错最伤。
116
+ if (args.slice(1).some((token) => token === 'help' || token === '--help' || token === '-h')) {
117
+ const sub = args[0] ?? '';
118
+ const usageLine = HELP.split('\n').find((line) => line.trim().startsWith(`ec services ${sub}`));
119
+ console.log(usageLine ? usageLine.trim() : HELP);
120
+ console.log('');
121
+ console.log('(完整列表:ec services --help)');
122
+ return;
123
+ }
105
124
  // `call` / `describe` / `schema` 都要等对端回包(daemon 侧是同一个 `runCall`,
106
125
  // 默认等 30s):IPC 超时必须覆盖调用预算,否则 CLI 先断而 daemon 还在等,
107
126
  // 空响应被误报成"daemon 不可达",request_id 也一起丢掉。
@@ -123,8 +142,14 @@ export async function runServicesCommand(argv) {
123
142
  process.exitCode = response.code === 'NO_RESULT' ? 2 : 1;
124
143
  return;
125
144
  }
126
- // 对端调用的成功输出是应答正文;--no-wait 时没有 response,回落到 request_id。
145
+ // 对端调用的成功输出是应答正文。
127
146
  const result = response.result;
147
+ // 「成功但可能没按预期生效」:reload / pack add / pack enable|disable 的包状态,
148
+ // 以及 call 里被当传输层字段的 data 键。JSON 里看得见,但人直接看终端时容易被
149
+ // 一屏字段淹没,先单独提一行(stderr,不影响管道里的正文)。
150
+ const warning = result && typeof result === 'object' ? result.warning : undefined;
151
+ if (typeof warning === 'string' && warning)
152
+ console.error(`⚠ ${warning}`);
128
153
  if (RELAY_COMMANDS.has(args[0] ?? '') && result && 'response' in result) {
129
154
  const body = result.response;
130
155
  printResult(body, json);
@@ -138,12 +163,12 @@ export async function runServicesCommand(argv) {
138
163
  }
139
164
  printResult(result, json);
140
165
  }
141
- /** `--timeout` 预算 + 5s 余量,作为 IPC 等待上限。 */
166
+ /** `--timeout` 预算 + 5s 余量,作为 IPC 等待上限。缺省与 daemon 侧同源(12s)。 */
142
167
  function readCallBudget(args) {
143
168
  const index = args.indexOf('--timeout');
144
169
  const raw = index >= 0 ? args[index + 1] : undefined;
145
- const parsed = raw === undefined ? 30_000 : parseTimeoutMs(raw);
146
- return (parsed ?? 30_000) + 5_000;
170
+ const parsed = raw === undefined ? SERVICE_CALL_TIMEOUT_MS : parseTimeoutMs(raw);
171
+ return (parsed ?? SERVICE_CALL_TIMEOUT_MS) + 5_000;
147
172
  }
148
173
  function parseTimeoutMs(value) {
149
174
  const trimmed = value.trim().toLowerCase();
@@ -10,9 +10,8 @@
10
10
  * 也保留了脚本「自定位、不依赖 cwd」的约束。
11
11
  *
12
12
  * 权限门禁同样在脚本层的 skill.mjs `assertPermission()`,本文件不复制一份。
13
- * 两个入口(这里的 spawn 与模型侧直接 node脚本)环境变量一致,
14
- * 脚本自己读 EVOLCORE_TASK_RUNTIME_CONTEXT 即可得到相同判据;
15
- * 若在 CLI 层再判一遍,只是多一处会与脚本漂移的实现。
13
+ * 写操作由脚本通过 daemon IPC 校验当前任务和协议 Owner,
14
+ * 两个入口共用该门禁;此处不提前消费写操作的单次命令授权。
16
15
  *
17
16
  * 例外:`refresh` 不进脚本,直接走 daemon IPC(skill.refresh)——索引由 daemon
18
17
  * 内的 index-generator 生成,鉴权也在 daemon 里做。其余子命令后续逐个迁到 IPC,
@@ -47,7 +46,8 @@ export async function cmdSkill(args) {
47
46
  // 让它能定位 Agent 级 skills/ 与 .switches.json。
48
47
  // selfAid 优先取任务运行时上下文(托管会话的权威来源),其次环境变量。
49
48
  const env = { ...process.env };
50
- const runtime = process.env.EVOLCORE_SESSION_ID ? await authorizeLocalCommand(['skill', ...args]) : undefined;
49
+ const mutation = ['create', 'install', 'remove', 'enable', 'disable'].includes(args[0]);
50
+ const runtime = process.env.EVOLCORE_SESSION_ID && !mutation ? await authorizeLocalCommand(['skill', ...args]) : undefined;
51
51
  const selfAid = runtime?.selfAid ?? readTaskRuntimeContextFromEnv()?.selfAid ?? process.env.EVOLCORE_SELF_AID;
52
52
  if (runtime) {
53
53
  env[TASK_RUNTIME_CONTEXT_ENV] = JSON.stringify(runtime);
@@ -1,5 +1,5 @@
1
1
  import { normalizeCausation } from '../core/causation/context.js';
2
- import { RUNTIME_LOCK_DIR_ENV } from '../core/runtime-lock.js';
2
+ import { RUNTIME_LOCK_DIR_ENV } from '../utils/atomic-write.js';
3
3
  import crypto from 'node:crypto';
4
4
  import { execFile, execFileSync } from 'node:child_process';
5
5
  import fs from 'node:fs';
@@ -239,7 +239,9 @@ function sessionRuntimeName(sessionId) {
239
239
  * Windows Codex sandbox accounts and ordinary runner accounts are members of
240
240
  * BUILTIN\Users. Session isolation is enforced by the distinct path plus the
241
241
  * runner filesystem policy, so the runtime directory only needs a portable
242
- * writable ACL rather than host-user secrecy.
242
+ * writable ACL rather than host-user secrecy. The host user additionally needs
243
+ * inheritable FullControl: DSH applies a mandatory integrity label to its private
244
+ * temporary children, which requires WRITE_OWNER as well as WRITE_DAC.
243
245
  */
244
246
  // Reapplying an inheritable ACE can walk a large existing session tree.
245
247
  // Read only its root DACL first; use the original grant if evidence is absent.
@@ -247,16 +249,29 @@ const WINDOWS_SESSION_ACL_CHECK = `
247
249
  $ErrorActionPreference='Stop'
248
250
  $acl=[System.IO.Directory]::GetAccessControl($env:EVOLCORE_SESSION_RUNTIME_ACL_PATH)
249
251
  $rules=@($acl.GetAccessRules($true,$true,[System.Security.Principal.SecurityIdentifier]))
252
+ $user=[System.Security.Principal.WindowsIdentity]::GetCurrent().User
250
253
  $modify=[System.Security.AccessControl.FileSystemRights]::Modify
254
+ $full=[System.Security.AccessControl.FileSystemRights]::FullControl
251
255
  $inherit=[System.Security.AccessControl.InheritanceFlags]'ContainerInherit,ObjectInherit'
252
256
  $ok=@($rules | Where-Object { $_.IdentityReference.Value -eq 'S-1-5-32-545' -and $_.AccessControlType -eq 'Allow' -and ($_.FileSystemRights -band $modify) -eq $modify -and ($_.InheritanceFlags -band $inherit) -eq $inherit -and $_.PropagationFlags -eq 'None' }).Count -gt 0
253
- if ($ok -and @($rules | Where-Object { $_.AccessControlType -eq 'Deny' }).Count -eq 0) { 'ready' }
257
+ $hostOk=@($rules | Where-Object { $_.IdentityReference.Value -eq $user.Value -and $_.AccessControlType -eq 'Allow' -and ($_.FileSystemRights -band $full) -eq $full -and ($_.InheritanceFlags -band $inherit) -eq $inherit -and $_.PropagationFlags -eq 'None' }).Count -gt 0
258
+ if ($ok -and $hostOk -and @($rules | Where-Object { $_.AccessControlType -eq 'Deny' }).Count -eq 0) { 'ready'; exit }
259
+ if ($env:EVOLCORE_SESSION_RUNTIME_ACL_REPAIR -eq '1') {
260
+ $users=[System.Security.Principal.SecurityIdentifier]::new('S-1-5-32-545')
261
+ $acl.AddAccessRule([System.Security.AccessControl.FileSystemAccessRule]::new($users,$modify,$inherit,'None','Allow'))
262
+ $acl.AddAccessRule([System.Security.AccessControl.FileSystemAccessRule]::new($user,$full,$inherit,'None','Allow'))
263
+ [System.IO.Directory]::SetAccessControl($env:EVOLCORE_SESSION_RUNTIME_ACL_PATH,$acl)
264
+ }
254
265
  `;
255
- function windowsSessionAclQuery(directory) {
266
+ function windowsSessionAclQuery(directory, repair = false) {
256
267
  return {
257
268
  command: path.join(process.env.SystemRoot || process.env.WINDIR || 'C:\\Windows', 'System32', 'WindowsPowerShell', 'v1.0', 'powershell.exe'),
258
269
  args: ['-NoProfile', '-NonInteractive', '-Command', WINDOWS_SESSION_ACL_CHECK],
259
- options: { windowsHide: true, timeout: 2_000, env: { ...process.env, EVOLCORE_SESSION_RUNTIME_ACL_PATH: directory } },
270
+ // Updating an inheritable DACL propagates through existing descendants.
271
+ // Long-lived sessions may contain large worktrees and caches; ten seconds
272
+ // can kill a valid repair before Windows finishes applying it.
273
+ options: { windowsHide: true, timeout: repair ? 60_000 : 2_000,
274
+ env: { ...process.env, EVOLCORE_SESSION_RUNTIME_ACL_PATH: directory, EVOLCORE_SESSION_RUNTIME_ACL_REPAIR: repair ? '1' : '0' } },
260
275
  };
261
276
  }
262
277
  function ensureWindowsSessionRuntimeAccess(directory, existing) {
@@ -272,13 +287,8 @@ function ensureWindowsSessionRuntimeAccess(directory, existing) {
272
287
  }
273
288
  catch { /* Unknown ACL: retain the original grant and failure behavior. */ }
274
289
  }
275
- const icacls = path.join(process.env.SystemRoot || process.env.WINDIR || 'C:\\Windows', 'System32', 'icacls.exe');
276
- execFileSync(icacls, [
277
- directory,
278
- '/grant',
279
- '*S-1-5-32-545:(OI)(CI)M',
280
- '/Q',
281
- ], { windowsHide: true, stdio: 'pipe', timeout: 10_000 });
290
+ const repair = windowsSessionAclQuery(directory, true);
291
+ execFileSync(repair.command, repair.args, { ...repair.options, stdio: 'pipe' });
282
292
  preparedWindowsSessionRuntimeDirs.add(directory);
283
293
  }
284
294
  /** Whether a task-provided runtime directory is a stable EvolCore session root. */
@@ -389,9 +399,9 @@ export async function ensureSessionRuntimeDirAsync(sessionId) {
389
399
  execFile(query.command, query.args, query.options, (error, stdout) => resolve(!error && String(stdout).trim() === 'ready'));
390
400
  });
391
401
  if (!alreadyGranted) {
392
- const icacls = path.join(process.env.SystemRoot || process.env.WINDIR || 'C:\\Windows', 'System32', 'icacls.exe');
402
+ const repair = windowsSessionAclQuery(directory, true);
393
403
  await new Promise((resolve, reject) => {
394
- execFile(icacls, [directory, '/grant', '*S-1-5-32-545:(OI)(CI)M', '/Q'], { windowsHide: true, timeout: 10_000 }, error => error ? reject(error) : resolve());
404
+ execFile(repair.command, repair.args, repair.options, error => error ? reject(error) : resolve());
395
405
  });
396
406
  }
397
407
  preparedWindowsSessionRuntimeDirs.add(directory);
@@ -1,11 +1,9 @@
1
1
  import path from 'node:path';
2
2
  import fs from 'node:fs';
3
- import crypto from 'node:crypto';
4
3
  import { authorizeLocalCommand } from './task-context.js';
5
- import { agentOutputDir, agentWorkspaceDir, resolvePaths } from '../paths.js';
4
+ import { agentWorkspaceDir, resolvePaths } from '../paths.js';
6
5
  import { ipcQuery } from '../ipc.js';
7
- import { readDelegationCredential, hashCurrentDelegatedCommand } from '../core/auth/agent-delegation.js';
8
- import { publishOutputCard, removeOutputCard } from '../outputs/cards.js';
6
+ import { readDelegationCredential } from '../core/auth/agent-delegation.js';
9
7
  import { readTeamWorkspaceNavigation, upsertTeamWorkspaceNavigation, removeTeamWorkspaceNavigation, updateTeamWorkspaceNavigation, } from '../core/command/team-workspace-store.js';
10
8
  import { readTeamMembers, updateTeamMembers } from '../core/command/team-workspace-team.js';
11
9
  import { TeamWorkspaceBootstrapService, TeamWorkspaceInitializer } from '../core/command/team-workspace-bootstrap.js';
@@ -16,10 +14,13 @@ const USAGE = `用法: ec team workspace init [--workspace <绝对路径>]
16
14
  ec team navigation update --replace-json <entries-json> [--expected-revision <n>]
17
15
  ec team members show
18
16
  ec team members update --members-json <aids-json>
19
- ec team cards publish --file <card.json>
20
- ec team cards remove --id <card-id>
17
+ ec team cards publish --file <card.json> [--expected-version <version>]
18
+ ec team cards remove --id <card-id> [--expected-version <version>]
19
+ ec team cards catalog
20
+ ec team cards schema
21
+ ec team cards validate --file <card.json>
21
22
 
22
- 所有命令只输出 JSON;cards 命令只允许当前 Agent Owner 的 AUN 私聊托管会话。`;
23
+ 所有命令只输出 JSON;cards 命令支持当前 Agent Owner 的 AUN 私聊或 Owner 授权的后台任务。`;
23
24
  class TeamWorkspaceCommandError extends Error {
24
25
  code;
25
26
  constructor(code, message) {
@@ -62,22 +63,45 @@ function expectedRevision(args, current) {
62
63
  return revision;
63
64
  }
64
65
  function output(value) { process.stdout.write(`${JSON.stringify(value, null, 2)}\n`); }
65
- async function publishCardChanged(aid, id, revision) {
66
- const sessionId = process.env.EVOLCORE_SESSION_ID;
67
- const delegationToken = sessionId ? readDelegationCredential() : undefined;
68
- if (sessionId && !delegationToken)
69
- return false;
70
- try {
71
- const response = await ipcQuery(resolvePaths().socket, {
72
- type: 'events.op', argv: ['native-publish', 'team.output-cards.changed', '--aid', aid,
73
- '--data', JSON.stringify({ sourceAid: aid, revision, cursor: `${revision}.1`, id })],
74
- ...(sessionId && delegationToken ? { sessionId, delegationToken, delegationCommandHash: hashCurrentDelegatedCommand() } : {}),
75
- }, 5_000, { throwOnError: false });
76
- return response?.ok === true;
77
- }
78
- catch {
79
- return false;
66
+ async function runPanelCards(args) {
67
+ const action = args[1];
68
+ const flags = args.slice(2);
69
+ const allowed = {
70
+ catalog: [], schema: [], validate: ['--file'],
71
+ publish: ['--file', '--expected-version'], remove: ['--id', '--expected-version'],
72
+ };
73
+ if (!Object.hasOwn(allowed, action ?? ''))
74
+ throw new TeamWorkspaceCommandError('INVALID_ARGUMENT', USAGE);
75
+ assertFlags(flags, allowed[action]);
76
+ let draft;
77
+ if (action === 'publish' || action === 'validate') {
78
+ const index = flags.indexOf('--file');
79
+ if (index < 0)
80
+ throw new TeamWorkspaceCommandError('INVALID_ARGUMENT', '--file is required');
81
+ const source = path.resolve(flags[index + 1]);
82
+ try {
83
+ const stat = fs.statSync(source);
84
+ if (!stat.isFile() || stat.size > 32 * 1024)
85
+ throw new Error();
86
+ const bytes = fs.readFileSync(source);
87
+ if (bytes.length > 32 * 1024)
88
+ throw new Error();
89
+ draft = JSON.parse(bytes.toString('utf8'));
90
+ }
91
+ catch {
92
+ throw new TeamWorkspaceCommandError('INVALID_CARD', 'Expected a valid card JSON file up to 32 KiB');
93
+ }
80
94
  }
95
+ const sessionId = process.env.EVOLCORE_SESSION_ID;
96
+ const delegationToken = readDelegationCredential();
97
+ if (!sessionId || !delegationToken)
98
+ throw new TeamWorkspaceCommandError('NOT_ALLOWED', 'An active task delegation is required');
99
+ const response = await ipcQuery(resolvePaths().socket, {
100
+ type: 'local-command-context', argv: ['team', ...args], sessionId, delegationToken, draft,
101
+ }, 20_000, { throwOnError: false });
102
+ if (!response?.ok)
103
+ throw new TeamWorkspaceCommandError(response?.code ?? 'UNAVAILABLE', response?.error ?? 'Panel cards daemon is unavailable');
104
+ output(response.result);
81
105
  }
82
106
  function assertOwnerContext(context) {
83
107
  if (context.channel !== 'aun' || context.chatType !== 'private' || context.peerRole !== 'owner' || !context.selfAid || !context.peerId) {
@@ -96,38 +120,12 @@ export async function cmdTeamWorkspace(rawArgs) {
96
120
  return;
97
121
  }
98
122
  try {
99
- const context = await authorizeLocalCommand(['team', ...rawArgs]);
100
- assertOwnerContext(context);
101
- if (rawArgs[0] === 'cards' && rawArgs[1] === 'publish') {
102
- assertFlags(rawArgs.slice(2), ['--file']);
103
- const fileIndex = rawArgs.indexOf('--file');
104
- if (rawArgs.length !== 4 || fileIndex < 0)
105
- throw new TeamWorkspaceCommandError('INVALID_ARGUMENT', USAGE);
106
- const source = path.resolve(rawArgs[fileIndex + 1]);
107
- let manifest;
108
- try {
109
- manifest = JSON.parse(fs.readFileSync(source, 'utf8'));
110
- }
111
- catch {
112
- throw new TeamWorkspaceCommandError('INVALID_CARD', `Cannot read a valid card JSON file: ${source}`);
113
- }
114
- const card = publishOutputCard(context.selfAid, manifest, agentOutputDir);
115
- const notified = await publishCardChanged(context.selfAid, card.id, card.version);
116
- output({ ok: true, id: card.id, version: card.version, path: path.relative(agentOutputDir(context.selfAid), path.join(agentOutputDir(context.selfAid), '.cards', `${card.id}.json`)).split(path.sep).join('/'), notified });
117
- return;
118
- }
119
- if (rawArgs[0] === 'cards' && rawArgs[1] === 'remove') {
120
- assertFlags(rawArgs.slice(2), ['--id']);
121
- const idIndex = rawArgs.indexOf('--id');
122
- if (rawArgs.length !== 4 || idIndex < 0)
123
- throw new TeamWorkspaceCommandError('INVALID_ARGUMENT', USAGE);
124
- const id = rawArgs[idIndex + 1];
125
- const removed = removeOutputCard(context.selfAid, id, agentOutputDir);
126
- const revision = crypto.createHash('sha256').update(`${context.selfAid}:${id}:${Date.now()}`).digest('hex').slice(0, 24);
127
- const notified = removed && await publishCardChanged(context.selfAid, id, revision);
128
- output({ ok: true, id, removed, notified: notified || false });
123
+ if (rawArgs[0] === 'cards') {
124
+ await runPanelCards(rawArgs);
129
125
  return;
130
126
  }
127
+ const context = await authorizeLocalCommand(['team', ...rawArgs]);
128
+ assertOwnerContext(context);
131
129
  if (rawArgs[0] === 'workspace' && rawArgs[1] === 'init') {
132
130
  const pathIndex = rawArgs.indexOf('--workspace');
133
131
  const workspace = pathIndex >= 0 ? rawArgs[pathIndex + 1] : undefined;
@@ -16,6 +16,7 @@ const HELP_TEXT = `
16
16
  show <ref> 查看单个话题的元数据
17
17
  history <ref> 读取话题历史消息
18
18
  create <peer> --name 新建话题(对端类型按关系证据自动识别,--group/--private 可覆盖)
19
+ 对端不能是本端自己;跨话题自派请先用真实对端建话题
19
20
  rename <ref> <名称> 修改话题名称(仅本端)
20
21
  status <ref> <状态> 更新话题状态(active|closed|archived)
21
22
  delete <ref> 删除话题(session 文件移入 _trash)
@@ -26,6 +27,7 @@ const HELP_TEXT = `
26
27
  rebuild-index 重建话题索引(丢失/损坏时使用)
27
28
  rebuild-index --check 检查索引健康状态(只报告不写盘,区分严重/轻微)
28
29
  check-index 同 rebuild-index --check
30
+ reconcile-status 对账索引与会话文件的状态漂移(默认只报告,--write 写回)
29
31
 
30
32
  典型工作流:
31
33
  1. ec thread peers # 查看有话题记录的所有对端
@@ -43,6 +45,10 @@ list 选项:
43
45
  --page <n> 页码
44
46
  --limit <n> 每页条数
45
47
 
48
+ reconcile-status 选项:
49
+ --write 按版本判定写回索引(仅「会话文件较新」的条目)
50
+ --agent <aid> 指定 Agent(宿主终端)
51
+
46
52
  history 选项:
47
53
  --limit <n> 消息条数上限(默认 50)
48
54
  --before <time> 截止时间
@@ -178,6 +184,21 @@ function printItem(item, opts) {
178
184
  return;
179
185
  }
180
186
  const obj = item;
187
+ // CreateThreadResult — 必须在 ThreadIndexEntry 之前检查:两者都含 threadId + sessionId,
188
+ // 而创建结果没有 lastActiveAt/nameUpdatedAt 这类索引字段。顺序写反会让创建成功
189
+ // 时走成条目渲染,peerUnverified 提示永远不出现。
190
+ if ('createdAt' in obj && 'sessionId' in obj && !('lastActiveAt' in obj)) {
191
+ console.log(`✓ 话题创建成功: ${obj.threadId}`);
192
+ console.log(` 名称: ${obj.name}`);
193
+ console.log(` 对端: ${obj.peer}`);
194
+ // 本地名片缓存缺失不影响创建(建话题不发消息,离线也必须可建),
195
+ // 但要让用户知道"这个对端本端还没见过",并给出补充路径。
196
+ if (obj.peerUnverified === true) {
197
+ console.warn(`⚠ 对端 ${obj.peer} 本地无名片缓存,消息可能无法投递`);
198
+ console.warn(` 先执行 ec aid agentmd get ${obj.peer} 拉取名片,再重试发送`);
199
+ }
200
+ return;
201
+ }
181
202
  // ThreadHistoryResult — 必须在 ThreadIndexEntry 之前检查,两者都含 threadId
182
203
  if ('messages' in obj && Array.isArray(obj.messages)) {
183
204
  const result = obj;
@@ -232,13 +253,6 @@ function printItem(item, opts) {
232
253
  console.log(`[${obj.time}] ${dir} ${obj.from}: ${String(obj.content).slice(0, 120)}`);
233
254
  return;
234
255
  }
235
- // CreateThreadResult
236
- if ('createdAt' in obj && 'sessionId' in obj) {
237
- console.log(`✓ 话题创建成功: ${obj.threadId}`);
238
- console.log(` 名称: ${obj.name}`);
239
- console.log(` 对端: ${obj.peer}`);
240
- return;
241
- }
242
256
  // RenameThreadResult
243
257
  if ('changed' in obj) {
244
258
  console.log(obj.changed ? `✓ 改名成功: ${obj.name}` : '✓ 名称未变更');
@@ -546,11 +560,12 @@ export async function runThreadCommand(args) {
546
560
  }
547
561
  const r = resp.result;
548
562
  if (dryRun) {
549
- // 两个计数都可能缺省(接口只回传有问题的维度),缺省按 0 处理,
563
+ // 三个计数都可能缺省(接口只回传有问题的维度),缺省按 0 处理,
550
564
  // 否则健康状态也会落进「建议 rebuild」分支。
551
565
  const missing = r.missing ?? 0;
552
566
  const stale = r.stale ?? 0;
553
- if (missing === 0 && stale === 0) {
567
+ const selfPeer = r.selfPeer ?? 0;
568
+ if (missing === 0 && stale === 0 && selfPeer === 0) {
554
569
  console.log(`✓ 索引健康:共 ${r.rebuilt ?? r.total} 条话题,session 文件完整`);
555
570
  }
556
571
  else {
@@ -560,7 +575,14 @@ export async function runThreadCommand(args) {
560
575
  if (stale > 0) {
561
576
  console.warn(`⚠ [轻微] ${stale} 条话题属性与 session 文件最后一行不一致(写盘时序),rebuild-index 可修复`);
562
577
  }
563
- console.warn(` 建议执行 ec thread rebuild-index 修复`);
578
+ if (selfPeer > 0) {
579
+ console.warn(`⚠ [严重] ${selfPeer} 条话题的对端是本端自己——结构残缺,rebuild 修不好,需逐条删除:`);
580
+ for (const id of (r.selfPeerIds ?? [])) {
581
+ console.warn(` ec thread delete ${aid}/${id}`);
582
+ }
583
+ }
584
+ if (missing > 0 || stale > 0)
585
+ console.warn(` 建议执行 ec thread rebuild-index 修复`);
564
586
  if (jsonFormat)
565
587
  console.log(JSON.stringify(r, null, 2));
566
588
  }
@@ -572,6 +594,42 @@ export async function runThreadCommand(args) {
572
594
  console.warn(`⚠ ${resp.indexWarning}`);
573
595
  break;
574
596
  }
597
+ case 'reconcile-status': {
598
+ const aid = argValue(args, '--agent') ?? selfAid;
599
+ const apply = hasFlag(args, '--write');
600
+ const resp = await sendOp({ op: 'reconcile-status', selfAid: aid, apply });
601
+ if (!resp.ok) {
602
+ console.error(`✗ ${resp.error}`);
603
+ process.exitCode = 1;
604
+ return;
605
+ }
606
+ const r = resp.result;
607
+ const drift = Array.isArray(r?.drift) ? r.drift : [];
608
+ if (jsonFormat) {
609
+ console.log(JSON.stringify(r, null, 2));
610
+ break;
611
+ }
612
+ if (drift.length === 0) {
613
+ console.log(`✓ 索引与会话文件状态一致,无需对账`);
614
+ break;
615
+ }
616
+ // 逐条列出冲突与判定:只有明确「文件较新」的才可自动修,
617
+ // ambiguous 表示两侧都没有版本号,必须人工确认。
618
+ for (const d of drift) {
619
+ const reason = d.winner === 'file' ? '以会话文件为准'
620
+ : d.winner === 'index' ? '以索引为准' : '无版本依据,需人工确认';
621
+ console.log(`${d.threadId} 索引=${d.indexStatus} 文件=${d.fileStatus} ${reason}`);
622
+ if (d.kind === 'name' || d.kind === 'both')
623
+ console.log(` 名称也有差异,本命令只处理状态`);
624
+ }
625
+ if (apply) {
626
+ console.log(`\n✓ 已按判定写回 ${r.applied ?? 0} 条;其余需人工确认`);
627
+ }
628
+ else {
629
+ console.log(`\n共 ${drift.length} 条可对账;加 --write 按判定写回(仅「文件较新」的条目)`);
630
+ }
631
+ break;
632
+ }
575
633
  case 'check-index': {
576
634
  const aid = argValue(args, '--agent') ?? selfAid;
577
635
  const resp = await sendOp({ op: 'check-index', selfAid: aid });
@@ -583,7 +641,8 @@ export async function runThreadCommand(args) {
583
641
  const r = resp.result;
584
642
  const missing = r.missing ?? 0;
585
643
  const stale = r.stale ?? 0;
586
- if (missing === 0 && stale === 0) {
644
+ const selfPeer = r.selfPeer ?? 0;
645
+ if (missing === 0 && stale === 0 && selfPeer === 0) {
587
646
  console.log(`✓ 索引健康:共 ${r.total} 条话题,session 文件完整`);
588
647
  }
589
648
  else {
@@ -593,7 +652,14 @@ export async function runThreadCommand(args) {
593
652
  if (stale > 0) {
594
653
  console.warn(`⚠ [轻微] ${stale} 条话题属性与 session 文件最后一行不一致(写盘时序),rebuild-index 可修复`);
595
654
  }
596
- console.warn(` 建议执行 ec thread rebuild-index 修复`);
655
+ if (selfPeer > 0) {
656
+ console.warn(`⚠ [严重] ${selfPeer} 条话题的对端是本端自己——结构残缺,rebuild 修不好,需逐条删除:`);
657
+ for (const id of (r.selfPeerIds ?? [])) {
658
+ console.warn(` ec thread delete ${aid}/${id}`);
659
+ }
660
+ }
661
+ if (missing > 0 || stale > 0)
662
+ console.warn(` 建议执行 ec thread rebuild-index 修复`);
597
663
  if (jsonFormat)
598
664
  console.log(JSON.stringify(r, null, 2));
599
665
  }
@@ -705,11 +771,12 @@ export async function runThreadCommand(args) {
705
771
  const cursorNote = setRes?.coveredThroughTs
706
772
  ? ` 覆盖至 ${new Date(setRes.coveredThroughTs).toLocaleString('zh-CN')}`
707
773
  : '';
708
- console.log(`✓ summary 已写入 rev ${setRes?.rev}${cursorNote}`);
774
+ const summaryStatus = setRes?.updated === false ? '未更新(正文和覆盖游标相同)' : '已写入';
775
+ console.log(`✓ summary ${summaryStatus} rev ${setRes?.rev}${cursorNote}`);
709
776
  if (setRes?.renamedTo)
710
777
  console.log(`✓ 话题已改名: ${setRes.renamedTo}`);
711
778
  if (setRes?.renameError)
712
- console.log(`⚠ 改名失败(摘要已写入): ${setRes.renameError}`);
779
+ console.log(`⚠ 改名失败(摘要${summaryStatus}): ${setRes.renameError}`);
713
780
  }
714
781
  else if (subCmd === 'log') {
715
782
  const target = resolveRef(ref);