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
@@ -11,7 +11,7 @@ import path from 'path';
11
11
  import fs from 'fs';
12
12
  import crypto from 'crypto';
13
13
  import { logger } from './logger.js';
14
- import { agentRelationDir } from '../paths.js';
14
+ import { agentRelationDir, agentAttachmentsDir, agentAttachmentIndexDir, agentAttachmentsMonthDir, agentAttachmentSha256IndexPath, } from '../paths.js';
15
15
  import { parsePeerKey } from '../core/relation/peer-identity.js';
16
16
  import { isSameOrDescendant } from '../core/permission/protected-paths.js';
17
17
  // ── 常量 ──────────────────────────────────────────────────────────────────────
@@ -112,68 +112,214 @@ export async function validateImage(buffer, opts) {
112
112
  }
113
113
  return { mime: type.mime };
114
114
  }
115
- function relationAttachmentsDir(selfAid, peerKey) {
115
+ /** 旧版附件目录(升级前的落点,仅用于兼容读取)。 */
116
+ function legacyRelationAttachmentsDir(selfAid, peerKey) {
116
117
  parsePeerKey(peerKey);
117
118
  return path.join(agentRelationDir(selfAid, peerKey), 'attachments');
118
119
  }
119
- /** Save one inbound image as a stable, peer-scoped attachment owned by the daemon. */
120
- export function saveRelationAttachment(buffer, selfAid, peerKey, mimeType) {
121
- const extension = RELATION_ATTACHMENT_EXTENSIONS[mimeType];
122
- if (!extension)
123
- throw new Error(`Unsupported relation attachment MIME type: ${mimeType}`);
124
- if (buffer.length < 1 || buffer.length > RELATION_ATTACHMENT_MAX_BYTES) {
125
- throw new Error(`Relation attachment must be between 1 byte and ${RELATION_ATTACHMENT_MAX_BYTES} bytes`);
120
+ /** 关系归属索引文件:`$AGENT_DIR/attachments/index/<peerKey>.jsonl`。 */
121
+ function attachmentIndexPath(selfAid, peerKey) {
122
+ parsePeerKey(peerKey);
123
+ return path.join(agentAttachmentIndexDir(selfAid), `${peerKey}.jsonl`);
124
+ }
125
+ /** 当月目录名。本地月,`YYYY-MM`。 */
126
+ function currentMonth() {
127
+ const now = new Date();
128
+ const month = `${now.getMonth() + 1}`.padStart(2, '0');
129
+ return `${now.getFullYear()}-${month}`;
130
+ }
131
+ /** 在 sha256 反查索引里找这份内容;命中且文件仍在才返回。 */
132
+ function findSha256Record(selfAid, sha256) {
133
+ const indexPath = agentAttachmentSha256IndexPath(selfAid, sha256.slice(0, 2));
134
+ let text;
135
+ try {
136
+ text = fs.readFileSync(indexPath, 'utf8');
137
+ }
138
+ catch {
139
+ return null;
126
140
  }
127
- const directory = relationAttachmentsDir(selfAid, peerKey);
141
+ // 从后往前:同一内容可能有跨月多条记录,最后一条是最新落点。
142
+ const lines = text.split('\n');
143
+ for (let i = lines.length - 1; i >= 0; i--) {
144
+ const line = lines[i].trim();
145
+ if (!line)
146
+ continue;
147
+ let record;
148
+ try {
149
+ record = JSON.parse(line);
150
+ }
151
+ catch {
152
+ continue;
153
+ }
154
+ if (record.sha256 !== sha256)
155
+ continue;
156
+ const candidate = path.join(agentAttachmentsMonthDir(selfAid, record.month), record.storage);
157
+ try {
158
+ const stat = fs.lstatSync(candidate);
159
+ if (stat.isFile() && !stat.isSymbolicLink() && stat.size === record.size) {
160
+ return record;
161
+ }
162
+ }
163
+ catch { /* 文件已不在,继续找更早的记录 */ }
164
+ }
165
+ return null;
166
+ }
167
+ function appendSha256Record(selfAid, record) {
168
+ const indexPath = agentAttachmentSha256IndexPath(selfAid, record.sha256.slice(0, 2));
169
+ ensureDir(path.dirname(indexPath));
170
+ fs.appendFileSync(indexPath, `${JSON.stringify(record)}\n`, { mode: 0o600 });
171
+ }
172
+ function ensureDir(directory) {
128
173
  fs.mkdirSync(directory, { recursive: true, mode: 0o700 });
129
174
  if (process.platform !== 'win32')
130
175
  fs.chmodSync(directory, 0o700);
176
+ }
177
+ /** 读取索引文件的全部记录;文件不存在时返回空数组。 */
178
+ function readIndexRecords(indexPath) {
179
+ let text;
180
+ try {
181
+ text = fs.readFileSync(indexPath, 'utf8');
182
+ }
183
+ catch {
184
+ return [];
185
+ }
186
+ const records = [];
187
+ for (const line of text.split('\n')) {
188
+ if (!line.trim())
189
+ continue;
190
+ try {
191
+ records.push(JSON.parse(line));
192
+ }
193
+ catch { /* skip malformed line */ }
194
+ }
195
+ return records;
196
+ }
197
+ function appendIndexRecord(indexPath, metadata) {
198
+ fs.appendFileSync(indexPath, `${JSON.stringify(metadata)}\n`, { mode: 0o600 });
199
+ }
200
+ /**
201
+ * 在 agent 级附件目录里为 `filename` 找一个落点。
202
+ *
203
+ * 规则(2026-11-16 起):
204
+ * - 同名文件存在且 **大小与 sha256 都相同** → 复用已有文件,不新增副本;
205
+ * - 同名但内容不同 → 依次尝试 `<base>-1<ext>`、`<base>-2<ext>`…,已存在同名候选时
206
+ * 同样先做内容比对,命中即复用;
207
+ * - 全部空闲 → 用原始文件名。
208
+ */
209
+ /** 与附件本体同级的保留名:索引子目录不能用作用户文件名。 */
210
+ const RESERVED_ATTACHMENT_NAMES = new Set(['index']);
211
+ function resolveAttachmentTarget(directory, filename, buffer, sha256) {
212
+ const ext = path.extname(filename);
213
+ const base = ext ? filename.slice(0, -ext.length) : filename;
214
+ for (let index = 0; index < 10_000; index++) {
215
+ const candidate = index === 0 ? filename : `${base}-${index}${ext}`;
216
+ // 保留名(如 index 子目录)不能作为附件本体名,直接跳到下一个编号。
217
+ if (RESERVED_ATTACHMENT_NAMES.has(candidate.toLowerCase()))
218
+ continue;
219
+ const candidatePath = path.join(directory, candidate);
220
+ if (!fs.existsSync(candidatePath)) {
221
+ return { filename: candidate, filePath: candidatePath, reused: false };
222
+ }
223
+ try {
224
+ const stat = fs.lstatSync(candidatePath);
225
+ // 目录(如 index/)不是可复用候选,跳过后继续找编号。
226
+ if (!stat.isFile() || stat.isSymbolicLink() || stat.size !== buffer.length)
227
+ continue;
228
+ const existingSha = crypto.createHash('sha256').update(fs.readFileSync(candidatePath)).digest('hex');
229
+ if (existingSha === sha256)
230
+ return { filename: candidate, filePath: candidatePath, reused: true };
231
+ }
232
+ catch {
233
+ continue;
234
+ }
235
+ }
236
+ throw new Error(`Too many same-name attachments in agent attachment directory: ${filename}`);
237
+ }
238
+ /**
239
+ * Save one attachment (image or arbitrary file).
240
+ *
241
+ * 文件本体进 agent 级目录(按内容去重,同一份文件发给多个对端只占一份磁盘);
242
+ * 归属信息追加到该对端的索引 `$AGENT_DIR/attachments/index/<peerKey>.jsonl`,
243
+ * 保留「这段关系什么时候收发过什么」的痕迹。
244
+ */
245
+ export function saveRelationAttachment(buffer, selfAid, peerKey, mimeType, opts = {}) {
246
+ const originalName = opts.filename ? sanitizeFileName(opts.filename) : '';
247
+ let extension;
248
+ if (opts.allowAnyExtension && originalName) {
249
+ extension = path.extname(originalName);
250
+ }
251
+ else {
252
+ extension = RELATION_ATTACHMENT_EXTENSIONS[mimeType] ?? '';
253
+ if (!extension)
254
+ throw new Error(`Unsupported relation attachment MIME type: ${mimeType}`);
255
+ }
256
+ if (buffer.length < 1 || buffer.length > RELATION_ATTACHMENT_MAX_BYTES) {
257
+ throw new Error(`Relation attachment must be between 1 byte and ${RELATION_ATTACHMENT_MAX_BYTES} bytes`);
258
+ }
259
+ ensureDir(agentAttachmentsDir(selfAid));
260
+ const indexDir = agentAttachmentIndexDir(selfAid);
261
+ ensureDir(indexDir);
131
262
  const attachmentId = crypto.randomBytes(16).toString('hex');
132
- const filename = `${attachmentId}${extension}`;
133
- const filePath = path.join(directory, filename);
134
- const metadataPath = path.join(directory, `${attachmentId}.json`);
263
+ const requestedName = originalName || `${attachmentId}${extension}`;
135
264
  const sha256 = crypto.createHash('sha256').update(buffer).digest('hex');
265
+ const createdAt = Date.now();
266
+ // 1. 先查 sha256 反查索引:同内容(任何名字、任何月份)直接复用,不新增副本。
267
+ const hit = findSha256Record(selfAid, sha256);
268
+ if (hit) {
269
+ const metadata = {
270
+ version: 1, attachmentId, selfAid, peerKey,
271
+ filename: requestedName, storage: hit.storage, mimeType,
272
+ sha256, size: buffer.length, direction: opts.direction ?? 'in', createdAt,
273
+ month: hit.month,
274
+ };
275
+ // 归属索引仍追加一条:这段关系这次确实收发过它,本体复用。
276
+ appendIndexRecord(attachmentIndexPath(selfAid, peerKey), metadata);
277
+ return { ...metadata, filePath: path.join(agentAttachmentsMonthDir(selfAid, hit.month), hit.storage) };
278
+ }
279
+ // 2. 未命中:写当月目录。
280
+ const month = currentMonth();
281
+ const directory = agentAttachmentsMonthDir(selfAid, month);
282
+ ensureDir(directory);
283
+ const target = resolveAttachmentTarget(directory, requestedName, buffer, sha256);
136
284
  const metadata = {
137
- version: 1, attachmentId, selfAid, peerKey, filename, mimeType,
138
- sha256, size: buffer.length, createdAt: Date.now(),
285
+ version: 1, attachmentId, selfAid, peerKey,
286
+ filename: requestedName, storage: target.filename, mimeType,
287
+ sha256, size: buffer.length, direction: opts.direction ?? 'in', createdAt, month,
139
288
  };
140
- fs.writeFileSync(filePath, buffer, { flag: 'wx', mode: 0o600 });
141
- fs.writeFileSync(metadataPath, JSON.stringify(metadata), { flag: 'wx', mode: 0o600 });
142
- return { ...metadata, filePath };
289
+ if (!target.reused) {
290
+ fs.writeFileSync(target.filePath, buffer, { flag: 'wx', mode: 0o600 });
291
+ }
292
+ // 索引一律追加:同一份内容收发 N 次就有 N 条记录,文件本体只落一份。
293
+ appendIndexRecord(attachmentIndexPath(selfAid, peerKey), metadata);
294
+ appendSha256Record(selfAid, { sha256, month, storage: target.filename, size: buffer.length, createdAt });
295
+ return { ...metadata, filePath: target.filePath };
143
296
  }
144
297
  /** Resolve an attachment only inside the authenticated Agent/peer relation. */
145
298
  export function readRelationAttachment(selfAid, peerKey, attachmentSource) {
146
- const attachmentId = RELATION_ATTACHMENT_ID_RE.test(attachmentSource)
299
+ // 兼容三种输入:新版文件名(会话内认知名)、旧版 32 位 hex ID、绝对路径。
300
+ const basename = path.basename(attachmentSource);
301
+ const legacyId = RELATION_ATTACHMENT_ID_RE.test(attachmentSource)
147
302
  ? attachmentSource
148
- : path.basename(attachmentSource, path.extname(attachmentSource));
149
- if (!RELATION_ATTACHMENT_ID_RE.test(attachmentId))
150
- throw new Error('Invalid attachment ID');
151
- const directory = relationAttachmentsDir(selfAid, peerKey);
152
- const metadataPath = path.join(directory, `${attachmentId}.json`);
153
- const metadataStat = fs.lstatSync(metadataPath);
154
- if (!metadataStat.isFile() || metadataStat.isSymbolicLink())
155
- throw new Error('Attachment metadata must be a regular file');
156
- const metadata = JSON.parse(fs.readFileSync(metadataPath, 'utf8'));
157
- if (metadata.version !== 1 || metadata.attachmentId !== attachmentId
158
- || metadata.selfAid !== selfAid || metadata.peerKey !== peerKey
159
- || RELATION_ATTACHMENT_EXTENSIONS[metadata.mimeType] === undefined
160
- || metadata.filename !== `${attachmentId}${RELATION_ATTACHMENT_EXTENSIONS[metadata.mimeType]}`) {
303
+ : (RELATION_ATTACHMENT_ID_RE.test(path.basename(basename, path.extname(basename)))
304
+ ? path.basename(basename, path.extname(basename))
305
+ : '');
306
+ const metadata = resolveIndexedMetadata(selfAid, peerKey, basename)
307
+ ?? (legacyId ? resolveLegacyMetadata(selfAid, peerKey, legacyId, basename) : null);
308
+ if (!metadata)
309
+ throw new Error('Attachment metadata not found');
310
+ if (metadata.version !== 1 || metadata.selfAid !== selfAid || metadata.peerKey !== peerKey) {
161
311
  throw new Error('Attachment ownership metadata mismatch');
162
312
  }
163
- const filePath = path.join(directory, metadata.filename);
164
- const stat = fs.lstatSync(filePath);
313
+ const attachmentId = metadata.attachmentId;
314
+ if (!RELATION_ATTACHMENT_ID_RE.test(attachmentId))
315
+ throw new Error('Invalid attachment ID');
316
+ const realPath = resolveAttachmentFile(selfAid, peerKey, metadata);
317
+ const stat = fs.lstatSync(realPath);
165
318
  if (!stat.isFile() || stat.isSymbolicLink() || stat.size !== metadata.size
166
319
  || stat.size < 1 || stat.size > RELATION_ATTACHMENT_MAX_BYTES) {
167
320
  throw new Error('Attachment file is missing or invalid');
168
321
  }
169
- const realDirectory = fs.realpathSync(directory);
170
- const realPath = fs.realpathSync(filePath);
171
- if (!isSameOrDescendant(realPath, realDirectory))
172
- throw new Error('Attachment path escaped its relation directory');
173
- if (path.isAbsolute(attachmentSource) && fs.realpathSync(attachmentSource) !== realPath) {
174
- throw new Error('Attachment path does not match the current relation');
175
- }
176
- const buffer = fs.readFileSync(filePath);
322
+ const buffer = fs.readFileSync(realPath);
177
323
  const sha256 = crypto.createHash('sha256').update(buffer).digest('hex');
178
324
  if (sha256 !== metadata.sha256)
179
325
  throw new Error('Attachment content hash mismatch');
@@ -181,10 +327,106 @@ export function readRelationAttachment(selfAid, peerKey, attachmentSource) {
181
327
  attachment: {
182
328
  attachmentId, selfAid, peerKey, filePath: realPath,
183
329
  mimeType: metadata.mimeType, sha256, size: buffer.length,
330
+ storage: metadata.storage ?? metadata.filename,
331
+ ...(metadata.month ? { month: metadata.month } : {}),
184
332
  },
185
333
  buffer,
186
334
  };
187
335
  }
336
+ /** 旧版:`<peerKey>/attachments/<id>.json` + `<id><ext>`,仍在关系目录里。 */
337
+ function resolveLegacyMetadata(selfAid, peerKey, legacyId, requestedBasename) {
338
+ const directory = legacyRelationAttachmentsDir(selfAid, peerKey);
339
+ const legacyPath = path.join(directory, `${legacyId}.json`);
340
+ try {
341
+ const stat = fs.lstatSync(legacyPath);
342
+ if (!stat.isFile() || stat.isSymbolicLink())
343
+ return null;
344
+ const raw = JSON.parse(fs.readFileSync(legacyPath, 'utf8'));
345
+ if (!raw || typeof raw !== 'object')
346
+ return null;
347
+ // 旧记录没有 storage/direction 字段,落盘名按旧约定推导。
348
+ const filename = typeof raw.filename === 'string' ? raw.filename : '';
349
+ return {
350
+ ...raw,
351
+ filename: requestedBasename || filename,
352
+ storage: filename,
353
+ direction: 'in',
354
+ };
355
+ }
356
+ catch {
357
+ return null;
358
+ }
359
+ }
360
+ /** 新版:`$AGENT_DIR/attachments/index/<peerKey>.jsonl` 里按 filename 取最后一条。 */
361
+ function resolveIndexedMetadata(selfAid, peerKey, filename) {
362
+ if (!filename || filename.includes('\0') || filename === '.' || filename === '..'
363
+ || path.basename(filename) !== filename) {
364
+ throw new Error('Invalid attachment name');
365
+ }
366
+ const records = readIndexRecords(attachmentIndexPath(selfAid, peerKey));
367
+ for (let index = records.length - 1; index >= 0; index--) {
368
+ const record = records[index];
369
+ if (record.filename === filename || record.storage === filename || record.attachmentId === filename)
370
+ return record;
371
+ }
372
+ return null;
373
+ }
374
+ /** 取文件本体路径:新版在 agent 级目录,旧版回落到关系目录。 */
375
+ function resolveAttachmentFile(selfAid, peerKey, metadata) {
376
+ const storage = typeof metadata.storage === 'string' && metadata.storage
377
+ ? metadata.storage
378
+ : metadata.filename;
379
+ if (!storage || path.basename(storage) !== storage)
380
+ throw new Error('Invalid attachment storage name');
381
+ const agentDirPath = agentAttachmentsDir(selfAid);
382
+ // 新版:记录带 month,本体在 `<attachments>/<YYYY-MM>/<storage>`。
383
+ if (typeof metadata.month === 'string' && metadata.month) {
384
+ const monthDir = agentAttachmentsMonthDir(selfAid, metadata.month);
385
+ const monthCandidate = path.join(monthDir, storage);
386
+ if (fs.existsSync(monthCandidate)) {
387
+ const realRoot = fs.realpathSync(agentDirPath);
388
+ const realPath = fs.realpathSync(monthCandidate);
389
+ if (!isSameOrDescendant(realPath, realRoot))
390
+ throw new Error('Attachment path escaped the agent attachment directory');
391
+ return realPath;
392
+ }
393
+ }
394
+ // 旧记录(无 month 字段):本体平铺在 attachments/ 下。
395
+ const agentCandidate = path.join(agentDirPath, storage);
396
+ if (fs.existsSync(agentCandidate)) {
397
+ const realRoot = fs.realpathSync(agentDirPath);
398
+ const realPath = fs.realpathSync(agentCandidate);
399
+ if (!isSameOrDescendant(realPath, realRoot))
400
+ throw new Error('Attachment path escaped the agent attachment directory');
401
+ return realPath;
402
+ }
403
+ // 旧版附件仍在关系目录里。
404
+ const legacyDir = legacyRelationAttachmentsDir(selfAid, peerKey);
405
+ const legacyCandidate = path.join(legacyDir, storage);
406
+ if (fs.existsSync(legacyCandidate)) {
407
+ const realRoot = fs.realpathSync(legacyDir);
408
+ const realPath = fs.realpathSync(legacyCandidate);
409
+ if (!isSameOrDescendant(realPath, realRoot))
410
+ throw new Error('Attachment path escaped its relation directory');
411
+ return realPath;
412
+ }
413
+ throw new Error('Attachment file is missing or invalid');
414
+ }
415
+ /**
416
+ * 生成消息正文里的附件标记。
417
+ *
418
+ * 格式:`[文件: 对端名 → 路径]`;当「对端名」与「实际落盘名」不一致时追加
419
+ * `(原名 对端名)`,避免模型或用户按显示名去引用文件时对不上号。
420
+ *
421
+ * @param shownPath 展示路径。当轮传绝对路径(模型直接可用);
422
+ * 历史记录传 `$AGENT_DIR/…` 别名(换机器后仍可展开)。
423
+ * @param pathUnavailable 代码侧拿不到 selfAid、别名无法生成时为 true。
424
+ */
425
+ export function formatAttachmentMarker(label, displayName, shownPath, storageName, pathUnavailable = false) {
426
+ const shown = pathUnavailable ? `${shownPath} (路径不可用:selfAid 缺失)` : shownPath;
427
+ const base = `[${label}: ${displayName} → ${shown}]`;
428
+ return storageName && storageName !== displayName ? `${base} (原名 ${displayName})` : base;
429
+ }
188
430
  /**
189
431
  * 把已下载的附件 Buffer 转成入站图片条目(供 baseagent 视觉通道)。
190
432
  *
@@ -5,7 +5,15 @@ const REAL_RESTART_TEST_OVERRIDE = 'EVOLCORE_ALLOW_REAL_RESTART_IN_TEST';
5
5
  export function readRestartRequest(filePath, requestId) {
6
6
  try {
7
7
  const request = JSON.parse(fs.readFileSync(filePath, 'utf8'));
8
- return request?.requestId === requestId ? request : null;
8
+ if (!request?.requestId || (requestId && request.requestId !== requestId))
9
+ return null;
10
+ // A failed unit may never start a replacement process. Readers can still
11
+ // observe a terminal timeout without requiring a surviving supervisor.
12
+ if (request.backend === 'systemd' && ['requested', 'accepted'].includes(request.status)
13
+ && request.deadline && request.deadline <= Date.now()) {
14
+ return { ...request, status: 'timeout', reason: 'Systemd replacement did not confirm ready before the restart deadline' };
15
+ }
16
+ return request;
9
17
  }
10
18
  catch {
11
19
  return null;
@@ -15,6 +23,9 @@ export function createRestartRequest(filePath, request, isProcessAlive) {
15
23
  fs.mkdirSync(path.dirname(filePath), { recursive: true });
16
24
  try {
17
25
  const previous = JSON.parse(fs.readFileSync(filePath, 'utf8'));
26
+ if (previous.backend === 'systemd' && ['requested', 'accepted'].includes(previous.status)
27
+ && Number(previous.deadline) > Date.now())
28
+ return false;
18
29
  if ([previous.launcherPid, previous.monitorPid]
19
30
  .some(pid => typeof pid === 'number' && isProcessAlive(pid))
20
31
  || Date.now() - Number(previous.updatedAt ?? previous.timestamp ?? 0) < 30_000)
@@ -39,6 +50,8 @@ export function updateRestartRequest(filePath, requestId, update) {
39
50
  const request = readRestartRequest(filePath, requestId);
40
51
  if (!request)
41
52
  return false;
53
+ if (['ready', 'failed', 'timeout'].includes(request.status) && update.status && update.status !== request.status)
54
+ return false;
42
55
  atomicWriteJson(filePath, { ...request, ...update, updatedAt: Date.now() });
43
56
  return true;
44
57
  }
@@ -94,6 +94,8 @@ export async function startRequestedStartupCpuProfile(traceId) {
94
94
  }
95
95
  /** 保留的启动/停止次数(按 traceId 去重后) */
96
96
  export const STARTUP_TRACE_KEEP = 50;
97
+ /** 中间快照最多每 250ms 保存一次;就绪和终态仍立即落盘。 */
98
+ const STARTUP_TRACE_SNAPSHOT_INTERVAL_MS = 250;
97
99
  /** CLI 传 traceId 给 daemon 的环境变量,让两侧记录落进同一次启动。 */
98
100
  export const STARTUP_TRACE_ID_ENV = 'EVOLCORE_STARTUP_TRACE_ID';
99
101
  /** traceId 以时间前缀开头,按字典序即按时间序。 */
@@ -126,6 +128,7 @@ export class StartupTracer {
126
128
  readyAtMs;
127
129
  taskReadyAtMs;
128
130
  pendingTasks = new Set();
131
+ persistTimer;
129
132
  constructor(source, opts = {}) {
130
133
  this.source = source;
131
134
  this.kind = opts.kind ?? 'startup';
@@ -200,7 +203,7 @@ export class StartupTracer {
200
203
  if (this.pendingTasks.size === 0)
201
204
  this.finish(true);
202
205
  else
203
- this.persist(true);
206
+ this.schedulePersist();
204
207
  }
205
208
  };
206
209
  return Object.assign(settle, {
@@ -262,6 +265,8 @@ export class StartupTracer {
262
265
  /** 放弃本次记录(未真正发生启动时用,比如 daemon 已在运行)。 */
263
266
  discard() {
264
267
  this.finished = true;
268
+ clearTimeout(this.persistTimer);
269
+ this.persistTimer = undefined;
265
270
  }
266
271
  /** 闭合最后阶段并落盘。重复调用无副作用。 */
267
272
  finish(ok) {
@@ -276,7 +281,16 @@ export class StartupTracer {
276
281
  this.finished = true;
277
282
  this.persist(this.readyAtMs !== undefined || ok, now);
278
283
  }
284
+ schedulePersist() {
285
+ if (this.persistTimer)
286
+ return;
287
+ // 不随每个完成回调重置计时,持续有任务完成时也能定期看到进度。
288
+ this.persistTimer = setTimeout(() => this.persist(true), STARTUP_TRACE_SNAPSHOT_INTERVAL_MS);
289
+ this.persistTimer.unref();
290
+ }
279
291
  persist(ok, now = Date.now()) {
292
+ clearTimeout(this.persistTimer);
293
+ this.persistTimer = undefined;
280
294
  const record = {
281
295
  traceId: this.traceId,
282
296
  kind: this.kind,
@@ -301,7 +315,7 @@ export class StartupTracer {
301
315
  spans: this.spans,
302
316
  };
303
317
  try {
304
- appendStartupTrace(record);
318
+ appendStartupTrace(record, this.finished);
305
319
  }
306
320
  catch {
307
321
  // 埋点失败不能影响启动本身
@@ -339,11 +353,13 @@ export function processStartOfThisProcess() {
339
353
  const uptimeMs = Math.round(process.uptime() * 1000);
340
354
  return Date.now() - uptimeMs;
341
355
  }
342
- function appendStartupTrace(record) {
356
+ function appendStartupTrace(record, compact) {
343
357
  const file = resolvePaths().lifecycleTrace;
344
358
  fs.mkdirSync(path.dirname(file), { recursive: true });
345
359
  fs.appendFileSync(file, `${JSON.stringify(record)}\n`, 'utf-8');
346
- trimStartupTrace(file);
360
+ // 历史读取、拆行和去重只在生命周期结束时做一次,不能阻塞每个启动回调。
361
+ if (compact)
362
+ trimStartupTrace(file);
347
363
  }
348
364
  /** 只保留最近 STARTUP_TRACE_KEEP 个 traceId 的行;行数不多时跳过。 */
349
365
  function trimStartupTrace(file) {
@@ -1,9 +1,11 @@
1
1
  import fs from 'fs';
2
2
  import os from 'os';
3
+ import path from 'node:path';
3
4
  function readNumber(filePath) {
4
5
  try {
5
- const value = Number(fs.readFileSync(filePath, 'utf8').trim());
6
- return Number.isFinite(value) && value >= 0 ? value : null;
6
+ const raw = fs.readFileSync(filePath, 'utf8').trim();
7
+ const value = /^\d+$/u.test(raw) ? Number(raw) : NaN;
8
+ return Number.isSafeInteger(value) && value >= 0 ? value : null;
7
9
  }
8
10
  catch {
9
11
  return null;
@@ -19,39 +21,125 @@ export function parseCgroupV2MemoryStat(input) {
19
21
  }
20
22
  return values;
21
23
  }
24
+ function readText(file) {
25
+ try {
26
+ return fs.readFileSync(file, 'utf8').trim();
27
+ }
28
+ catch {
29
+ return '';
30
+ }
31
+ }
32
+ function memoryHierarchies(cgroupRoot) {
33
+ if (cgroupRoot !== '/sys/fs/cgroup') {
34
+ return [{ directory: cgroupRoot, mountPoint: cgroupRoot, version: 2 }];
35
+ }
36
+ const memberships = readText('/proc/self/cgroup').split('\n')
37
+ .map(line => line.match(/^\d+:([^:]*):(\/.*)$/u))
38
+ .filter((match) => match !== null);
39
+ const hierarchies = [];
40
+ const decode = (value) => value.replace(/\\([0-7]{3})/gu, (_match, octal) => String.fromCharCode(Number.parseInt(octal, 8)));
41
+ for (const line of readText('/proc/self/mountinfo').split('\n')) {
42
+ const [mount, filesystem] = line.split(' - ');
43
+ if (!mount || !filesystem)
44
+ continue;
45
+ const fields = mount.split(' ');
46
+ const [type, , options = ''] = filesystem.split(' ');
47
+ if (type !== 'cgroup2' && !(type === 'cgroup' && options.split(',').includes('memory')))
48
+ continue;
49
+ if (!fields[3] || !fields[4])
50
+ continue;
51
+ const version = type === 'cgroup2' ? 2 : 1;
52
+ const member = memberships.find(match => version === 2
53
+ ? match[1] === '' : match[1].split(',').includes('memory'));
54
+ if (!member)
55
+ continue;
56
+ const mountPoint = decode(fields[4]);
57
+ const relative = path.posix.relative(decode(fields[3]), member[2]);
58
+ const suffix = relative === '..' || relative.startsWith('../') ? member[2] : relative;
59
+ const directory = path.posix.resolve(mountPoint, `./${suffix}`);
60
+ if (directory === mountPoint || directory.startsWith(`${mountPoint}/`)) {
61
+ hierarchies.push({ directory, mountPoint, version });
62
+ }
63
+ }
64
+ if (hierarchies.length === 0) {
65
+ for (const [mountPoint, version] of [['/sys/fs/cgroup', 2], ['/sys/fs/cgroup/memory', 1]]) {
66
+ const member = memberships.find(match => version === 2
67
+ ? match[1] === '' : match[1].split(',').includes('memory'));
68
+ const directory = path.posix.resolve(mountPoint, `.${member?.[2] ?? '/'}`);
69
+ if (directory === mountPoint || directory.startsWith(`${mountPoint}/`)) {
70
+ hierarchies.push({ directory, mountPoint, version });
71
+ }
72
+ }
73
+ }
74
+ return hierarchies;
75
+ }
22
76
  /**
23
77
  * System memory for the current container/host namespace.
24
78
  *
25
- * Linux cgroup v2 uses memory.current - memory.stat:file so the value matches
26
- * common host/container dashboards: anonymous + kernel memory, excluding
27
- * reclaimable filesystem page cache. Other environments fall back to the
28
- * portable total - available calculation exposed by Node.js.
79
+ * Total is bounded by visible cgroup hard limits, including ancestors. Usage
80
+ * excludes filesystem cache when available. Free is hard-limit headroom;
81
+ * available also includes the cache estimate, bounded by parent headroom and
82
+ * host free memory. These are estimates, not guarantees of future allocation.
29
83
  */
30
84
  export function readSystemMemoryUsage(cgroupRoot = '/sys/fs/cgroup') {
31
- const memTotal = os.totalmem();
32
- const memAvailable = os.freemem();
85
+ const hostTotal = os.totalmem();
86
+ const hostAvailable = os.freemem();
87
+ let memTotal = hostTotal;
33
88
  if (process.platform === 'linux') {
34
- const current = readNumber(`${cgroupRoot}/memory.current`);
35
- if (current !== null) {
36
- try {
37
- const stat = parseCgroupV2MemoryStat(fs.readFileSync(`${cgroupRoot}/memory.stat`, 'utf8'));
38
- const fileCache = stat.get('file');
39
- if (fileCache !== undefined) {
40
- const memUsed = Math.max(0, current - fileCache);
41
- return {
42
- memTotal,
43
- memUsed,
44
- memFree: Math.max(0, memTotal - memUsed),
45
- memAvailable,
46
- memorySource: 'cgroup-v2-current-minus-file',
47
- cgroupCurrent: current,
48
- fileCache,
49
- };
89
+ let headroom = hostAvailable;
90
+ let available = hostAvailable;
91
+ let usage;
92
+ for (const hierarchy of memoryHierarchies(cgroupRoot)) {
93
+ let directory = hierarchy.directory;
94
+ while (true) {
95
+ const limit = readNumber(`${directory}/${hierarchy.version === 2 ? 'memory.max' : 'memory.limit_in_bytes'}`);
96
+ const current = readNumber(`${directory}/${hierarchy.version === 2 ? 'memory.current' : 'memory.usage_in_bytes'}`);
97
+ const stat = parseCgroupV2MemoryStat(readText(`${directory}/memory.stat`));
98
+ const cache = hierarchy.version === 2 ? stat.get('file') : stat.get('total_cache') ?? stat.get('cache');
99
+ if (directory === hierarchy.directory && current !== null) {
100
+ usage = { current, cache, version: hierarchy.version };
101
+ }
102
+ // v1's unlimited sentinel exceeds safe integer precision and is ignored.
103
+ if (limit !== null) {
104
+ memTotal = Math.min(memTotal, limit);
105
+ if (current !== null) {
106
+ headroom = Math.min(headroom, Math.max(0, limit - current));
107
+ available = Math.min(available, Math.max(0, limit - Math.max(0, current - (cache ?? 0))));
108
+ }
50
109
  }
110
+ if (directory === hierarchy.mountPoint)
111
+ break;
112
+ directory = path.posix.dirname(directory);
113
+ }
114
+ }
115
+ if (usage) {
116
+ const { current, cache, version } = usage;
117
+ const memUsed = Math.min(memTotal, Math.max(0, current - (cache ?? 0)));
118
+ return {
119
+ memTotal, memUsed,
120
+ memFree: Math.min(headroom, Math.max(0, memTotal - current)),
121
+ memAvailable: Math.min(available, Math.max(0, memTotal - memUsed)),
122
+ memorySource: version === 2
123
+ ? cache === undefined ? 'cgroup-v2-current' : 'cgroup-v2-current-minus-file'
124
+ : cache === undefined ? 'cgroup-v1-usage' : 'cgroup-v1-usage-minus-cache',
125
+ cgroupCurrent: current,
126
+ ...(cache === undefined ? {} : { fileCache: cache }),
127
+ };
128
+ }
129
+ // Even if usage files are unreadable, keep a discovered hard limit and use
130
+ // Node's container-aware availability instead of subtracting host metrics.
131
+ if (memTotal < hostTotal) {
132
+ let memAvailable = 0;
133
+ try {
134
+ memAvailable = process.availableMemory();
51
135
  }
52
- catch { /* fall through to portable OS metrics */ }
136
+ catch { /* conservative fallback */ }
137
+ memAvailable = Number.isFinite(memAvailable) ? Math.max(0, Math.min(memTotal, hostAvailable, memAvailable)) : 0;
138
+ return { memTotal, memUsed: memTotal - memAvailable, memFree: memAvailable,
139
+ memAvailable, memorySource: 'runtime-available' };
53
140
  }
54
141
  }
142
+ const memAvailable = Math.max(0, Math.min(memTotal, hostAvailable));
55
143
  return {
56
144
  memTotal,
57
145
  memUsed: Math.max(0, memTotal - memAvailable),